annapurna library

The ML/analytics engine suite (libs/annapurna/ai/src/engines.ts, "AI and ML engine for forecasting, quality, and recommendations"). It implements real domain algorithms: forecastDemand (baseline covers adjusted by weather/event/holiday/promotion lift with a confidence interval and safety stock), assessPlateQuality, recommendCustomerMenuItems, optimizeDynamicPrice, optimizeKitchenEfficiency, analyzeReviewSentiment (keyword/sentiment lexicons per insight category), optimizeDeliveryRoutes, and predictFoodTrends. Inputs and outputs are fully typed in src/types.ts.

Customer-facing and operations app-state builders (libs/annapurna/apps, "Customer-facing and operations mobile/web app contracts"). The engines assemble view-model state for concrete app surfaces: buildCustomerMobileAppState, buildOrderTrackingState, bookReservationInApp, buildLoyaltyProgramInterface, buildArMenuPreview, buildKdsTabletApp, buildKitchenManagerDashboard, buildPrepManagementApp, buildDeliveryFleetDashboard, buildHumanCourierApp, and buildRobotRemoteOperationInterface. It is the presentation-contract layer over the other domains' engines.

Back-of-house slot — a thin scaffold. libs/annapurna/boh/src/index.ts is only the capability-registry boilerplate (ANNAPURNA_BOH_CAPABILITIES with a single boh:foundation entry whose evidence is the project files), with no engines.ts and no types.ts. The package description ("prep, cooking, plating, cleaning, and inventory") states the intended scope, but no domain logic is implemented here yet.

Multi-unit and franchise management (libs/annapurna/chain/src/engines.ts). Real engines: buildMultiUnitDashboard (aggregates per-location KPI inputs), enforceMenuConsistency, planCentralizedProcurement, manageFranchiseUnits, analyzeNewLocations, and createStoreOpeningPlaybook. It is the package for operating a brand across many physical units.

Central-kitchen / commissary operations (libs/annapurna/commissary/src/engines.ts). Implements planCentralKitchenProduction, scaleBatchRecipe, planCommissaryDistribution, planCookChillProduction, and buildCommissaryHaccpPlan — the production-and-distribution backbone for a hub kitchen that supplies multiple outlets.

The foundation package (libs/annapurna/core) and the only node without an engines.ts. It owns branded ID types and validating constructors (src/ids.ts, prefixes like rest, menu, ord), the domain enum/union vocabulary (src/types.ts — RestaurantConcept, KitchenStationName, DietaryTag, …), Zod schemas (src/schemas.ts), a 6500-line cuisine taxonomy with flavor profiles (src/taxonomy.ts), the Postgres table catalog (src/db-schema.ts) plus a real Drizzle migration enabling postgis / timescaledb / vector, and the REST endpoint list and GraphQL SDL (src/api.ts). Every other Annapurna engine imports its primitives.

Culinary intelligence and recipe/flavor science — one of the largest nodes (~2700 lines, libs/annapurna/culinary/src/engines.ts). It covers recipe lifecycle (scaleRecipe with DEFAULT_SCALING_RULES, standardizeRecipeForCommercialKitchen, createRecipeVersion, compareRecipeVersions), flavor science (predictFlavorPairings scoring shared aroma compounds and complementary taste dimensions, optimizeTasteBalance, optimizeMaillardReaction, planFermentation, planMolecularTechnique, formulateSpiceBlend, deriveSauce over a mother-sauce system), and nutrition (calculateRecipeNutrition, buildAllergenMatrix, optimizeRecipeMacros, suggestIngredientSubstitutions). It draws on @annapurna/core's flavor taxonomy.

Customer intelligence, loyalty, and CRM (libs/annapurna/customer/src/engines.ts). Implements buildCustomerDataPlatform, segmentCustomers, recommendMenuItems, predictChurnAndRetention, and calculateCustomerLifetimeValue — the CDP and retention-analytics layer over guest data.

Delivery operations, autonomous vehicles, and last-mile logistics — a large node (libs/annapurna/delivery/src/engines.ts). It spans robot and drone hardware (specifyDeliveryRobot, createAutonomousNavigationStack, createOyaFoodDroneAdapter, calculateDroneDeliveryZone, manageDroneLandingPads, planDroneGroundHandoff), fleet and routing (planDeliveryRoute, manageRobotFleet, optimizeDeliveryDispatch, batchDeliveryOrders, estimateDeliveryTime), and operational concerns (manageThermalCompartments, planChargingInfrastructure, createDeliveryRobotSafetyPlan, adaptDeliveryForWeather, scoreDeliveryQuality, manageSurgeDeliveryDemand). The Oya adapter is its tie-in to the aerial-delivery domain.

Restaurant financial management and analytics (libs/annapurna/finance/src/engines.ts). Implements buildRestaurantProfitLoss, buildPrimeCostFlashReport, buildBreakEvenAnalysis, manageCashFlow, buildNewRestaurantFinancialModel, and analyzeDeliveryProfitability — the industry-standard prime-cost / break-even / pro-forma toolkit for food-service P&L.

Front-of-house operations (libs/annapurna/foh/src/engines.ts): POS, reservations, and guest experience. It implements createPosCheckSession, routeKitchenDisplayTickets, aggregateOrderChannels, throttleOrdersForKitchenCapacity, createTablesideOrderingSession, createSelfServiceKioskFlow, reservation/waitlist/floor-plan engines (createReservationBookingPlan, buildTableFloorPlan, manageWaitlist, optimizeTableTurns, configureDynamicTables), and guest-relations engines (buildGuestProfileBrief, collectGuestFeedback, calculateLoyaltyAccount, suggestUpsells, manageReviewWorkflow).

Ghost / cloud-kitchen operations (libs/annapurna/ghost/src/engines.ts). Implements designGhostKitchenFacility, createVirtualBrand, analyzeVirtualBrandPerformance, optimizeSharedKitchenResources, optimizeGhostKitchenLocation, and createKitchenAsAServiceModel — the delivery-only, multi-brand-per-kitchen business model.

The cross-domain integration hub (libs/annapurna/integration). Beyond the standard capability registry it ships a full engines.ts of adapters that bridge sibling Oshun domains into Annapurna's restaurant model: Hestia recipe intelligence and meal planning, Asase farm-to-restaurant supply chain, Brigid kitchen automation / refrigeration / energy, Oya aerial and ground delivery, Seshat restaurant design, Athena furniture, Freya textiles, Maat business operations, and Psyche customer interaction. It is the seam that keeps the other domain packages from depending on each other directly.

Kitchen design/equipment slot — a thin scaffold, mirroring @annapurna/boh. libs/annapurna/kitchen/src/index.ts is only the capability-registry boilerplate (ANNAPURNA_KITCHEN_CAPABILITIES with a single kitchen:foundation entry), with no engines.ts and no types.ts. The description ("kitchen design, equipment, and workflow management") reserves the scope, but no logic is implemented here yet. (Note: physical kitchen-layout and equipment engines actually live today in @annapurna/restaurant.)

Menu engineering, pricing, and innovation (libs/annapurna/menu/src/engines.ts). Implements the classic menu-engineering matrix (classifyMenuEngineering → stars/plowhorses/etc., analyzeMenuMix), pricing (recommendMenuPrice, calculateDynamicPrice, costRecipePortion, analyzeMenuItemProfitability, trackFoodCostVariance), layout and copy (optimizeMenuLayout, generateMenuDescriptions), and lifecycle engines (planSeasonalRotation, engineerKidsMenuItem, engineerBeverageMenu, createPortionControlSpec, summarizeWaste).

Restaurant design, ambiance, and physical-space management (libs/annapurna/restaurant/src/engines.ts) — a broad node. It covers front-of-house design (designRestaurantConcept, optimizeDiningRoomLayout, designBiophilicRestaurant, designRestaurantLighting, designRestaurantAcoustics, designOpenKitchen, designBarLounge, designOutdoorDining, designRestaurantRestrooms, designFoodTruckOrPopup) and, notably, the commercial-kitchen engineering (planCommercialKitchenLayout, specifyKitchenEquipment, designKitchenVentilation, specifyRefrigeration, specifyPlumbing, planElectricalLoad, specifyKitchenFlooring, scheduleEquipmentMaintenance) that the @annapurna/kitchen scaffold does not.

Kitchen automation and robotic cooking (libs/annapurna/robotics/src/engines.ts) — the largest engine surface by function count. It plans station controllers (createWokControllerPlan, createGrillPlanchaControllerPlan, createFryerControllerPlan, createPizzaAssemblyLinePlan, createSushiAssemblyPlan, createSaladBowlAssemblyPlan, createBeveragePreparationPlan, createPastryDessertAssemblyPlan), orchestrates multi-robot kitchens and prep (orchestrateMultiRobotKitchen, createRobotSanitizationCycle, createIngredientDispensingPlan, generatePrepListFromForecast), and provides computer-vision/IoT monitoring (inspectPlateQuality, monitorFoodSafetyVision, detectCookingCompletion, monitorKitchenEquipmentIot, monitorKitchenEnergy, monitorKitchenAirQuality, senseAutomatedInventory).

Food safety, HACCP, and health compliance (libs/annapurna/safety/src/engines.ts). Implements buildHaccpPlan, evaluateTemperatureMonitoring, buildInspectionReadinessReport, trackEmployeeHealthCompliance, buildAllergenManagementProtocol, scheduleCleaningAndSanitization, managePestControlProgram, and buildRecallResponsePlan — the regulatory and food-safety compliance toolkit.

Workforce management, scheduling, and training (libs/annapurna/staff/src/engines.ts). Implements planStaffSchedule, distributeTips, assignKitchenBrigade, manageTrainingProgram, calculateLaborCostAnalytics, and buildKitchenSkillsMatrix — labor scheduling, tip pooling, brigade assignment, and labor-cost analytics.

Food-service procurement and inventory (libs/annapurna/supply/src/engines.ts). Implements supplier management (buildFoodServiceSupplierDatabase, compareSupplierPrices, inspectReceivingDelivery, planFarmToTableSourcing), purchasing (generateParLevelPurchaseOrders), and real inventory algorithms (computePerpetualInventory, enforceFefo — first-expiry-first-out lot picking sorted by expiry with menu-special/staff-meal disposition, buildShelfLifeManagementPlan, buildWeeklyWasteReport, calculateFoodCostAccounting).

Food-waste reduction and sustainability tracking (libs/annapurna/sustainability/src/engines.ts). Implements trackFoodWasteReduction, calculateMenuItemCarbonFootprint, buildSustainableSourcingScorecard, trackEnergyEfficiency, planPackagingReduction, and trackWaterConservation — the environmental metrics layer over the operational domains.