@contractspec/module.lifecycle-advisor 3.7.5 → 3.7.7

package/dist/index.js

@@ -1,9 +1,4 @@
 // @bun
-// src/recommendations/recommendation-engine.ts
-import {
-  LIFECYCLE_STAGE_META
-} from "@contractspec/lib.lifecycle";
-
 // src/data/stage-playbooks.ts
 import { LifecycleStage } from "@contractspec/lib.lifecycle";
 
@@ -347,670 +342,670 @@ var enMessages = defineTranslation({
   }
 });
 
-// src/i18n/catalogs/fr.ts
+// src/i18n/catalogs/es.ts
 import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations";
-var frMessages = defineTranslation2({
+var esMessages = defineTranslation2({
   meta: {
     key: "lifecycle-advisor.messages",
     version: "1.0.0",
     domain: "lifecycle-advisor",
-    description: "Playbook, ceremony, library, and engine strings (French)",
+    description: "Playbook, ceremony, library, and engine strings (Spanish)",
     owners: ["platform"],
     stability: "experimental"
   },
-  locale: "fr",
+  locale: "es",
   fallback: "en",
   messages: {
     "playbook.stage0.focus.0": {
-      value: "D\xE9couverte",
-      description: "Stage 0 focus area: Discovery"
+      value: "Descubrimiento",
+      description: "Stage 0 focus area: discovery research"
     },
     "playbook.stage0.focus.1": {
-      value: "Clart\xE9 du probl\xE8me",
-      description: "Stage 0 focus area: Problem clarity"
+      value: "Claridad del problema",
+      description: "Stage 0 focus area: sharpening the problem definition"
     },
     "playbook.stage0.focus.2": {
       value: "Persona",
-      description: "Stage 0 focus area: Persona"
+      description: "Stage 0 focus area: identifying the target persona"
     },
     "playbook.stage1.focus.0": {
-      value: "Prototype",
-      description: "Stage 1 focus area: Prototype"
+      value: "Prototipo",
+      description: "Stage 1 focus area: building a prototype"
     },
     "playbook.stage1.focus.1": {
-      value: "Retours",
-      description: "Stage 1 focus area: Feedback"
+      value: "Retroalimentaci\xF3n",
+      description: "Stage 1 focus area: gathering user feedback"
     },
     "playbook.stage1.focus.2": {
-      value: "Preuve de valeur",
-      description: "Stage 1 focus area: Value proof"
+      value: "Prueba de valor",
+      description: "Stage 1 focus area: proving the value proposition"
     },
     "playbook.stage2.focus.0": {
-      value: "Activation",
-      description: "Stage 2 focus area: Activation"
+      value: "Activaci\xF3n",
+      description: "Stage 2 focus area: user activation"
     },
     "playbook.stage2.focus.1": {
-      value: "T\xE9l\xE9m\xE9trie",
-      description: "Stage 2 focus area: Telemetry"
+      value: "Telemetr\xEDa",
+      description: "Stage 2 focus area: usage telemetry"
     },
     "playbook.stage2.focus.2": {
-      value: "Retours",
-      description: "Stage 2 focus area: Feedback"
+      value: "Retroalimentaci\xF3n",
+      description: "Stage 2 focus area: continuous user feedback"
     },
     "playbook.stage3.focus.0": {
-      value: "R\xE9tention",
-      description: "Stage 3 focus area: Retention"
+      value: "Retenci\xF3n",
+      description: "Stage 3 focus area: user retention"
     },
     "playbook.stage3.focus.1": {
-      value: "Fiabilit\xE9",
-      description: "Stage 3 focus area: Reliability"
+      value: "Fiabilidad",
+      description: "Stage 3 focus area: product reliability"
     },
     "playbook.stage3.focus.2": {
-      value: "R\xE9cit",
-      description: "Stage 3 focus area: Story"
+      value: "Historia",
+      description: "Stage 3 focus area: building the narrative"
     },
     "playbook.stage4.focus.0": {
-      value: "Syst\xE8mes",
-      description: "Stage 4 focus area: Systems"
+      value: "Sistemas",
+      description: "Stage 4 focus area: scalable systems"
     },
     "playbook.stage4.focus.1": {
-      value: "Boucles de croissance",
-      description: "Stage 4 focus area: Growth loops"
+      value: "Bucles de crecimiento",
+      description: "Stage 4 focus area: repeatable growth loops"
     },
     "playbook.stage4.focus.2": {
-      value: "Sp\xE9cialisation",
-      description: "Stage 4 focus area: Specialization"
+      value: "Especializaci\xF3n",
+      description: "Stage 4 focus area: team specialization"
     },
     "playbook.stage5.focus.0": {
-      value: "Partenaires",
-      description: "Stage 5 focus area: Partners"
+      value: "Socios",
+      description: "Stage 5 focus area: partner ecosystem"
     },
     "playbook.stage5.focus.1": {
       value: "APIs",
-      description: "Stage 5 focus area: APIs"
+      description: "Stage 5 focus area: platform APIs"
     },
     "playbook.stage5.focus.2": {
-      value: "Paris d'expansion",
-      description: "Stage 5 focus area: Expansion bets"
+      value: "Apuestas de expansi\xF3n",
+      description: "Stage 5 focus area: expansion experiments"
     },
     "playbook.stage6.focus.0": {
-      value: "Optimisation",
-      description: "Stage 6 focus area: Optimization"
+      value: "Optimizaci\xF3n",
+      description: "Stage 6 focus area: operational optimization"
     },
     "playbook.stage6.focus.1": {
-      value: "Renouvellement",
-      description: "Stage 6 focus area: Renewal"
+      value: "Renovaci\xF3n",
+      description: "Stage 6 focus area: product renewal"
     },
     "playbook.stage6.focus.2": {
-      value: "Portefeuille",
-      description: "Stage 6 focus area: Portfolio"
+      value: "Portafolio",
+      description: "Stage 6 focus area: portfolio management"
     },
     "playbook.stage0.action0.title": {
-      value: "Mener un sprint d'entretiens de 5 jours",
-      description: "Stage 0 action 0 title"
+      value: "Realizar un sprint de entrevistas de 5 d\xEDas",
+      description: "Action title for stage 0 interview sprint"
     },
     "playbook.stage0.action0.description": {
-      value: "Planifier au moins 5 entretiens cons\xE9cutifs et capturer les citations brutes.",
-      description: "Stage 0 action 0 description"
+      value: "Programar al menos 5 entrevistas consecutivas y capturar citas sin editar.",
+      description: "Action description for stage 0 interview sprint"
     },
     "playbook.stage0.action1.title": {
-      value: "R\xE9diger l'histoire du probl\xE8me",
-      description: "Stage 0 action 1 title"
+      value: "Redactar la historia del problema",
+      description: "Action title for stage 0 problem narrative"
     },
     "playbook.stage0.action1.description": {
-      value: "R\xE9sumer la douleur en un paragraphe que vous pouvez r\xE9p\xE9ter aux partenaires.",
-      description: "Stage 0 action 1 description"
+      value: "Resumir el dolor en un p\xE1rrafo que puedas repetir a los socios.",
+      description: "Action description for stage 0 problem narrative"
     },
     "playbook.stage1.action0.title": {
-      value: "Boucle de retours sur le prototype",
-      description: "Stage 1 action 0 title"
+      value: "Ciclo de retroalimentaci\xF3n del prototipo",
+      description: "Action title for stage 1 prototype iteration"
     },
     "playbook.stage1.action0.description": {
-      value: "Livrer un prototype basse fid\xE9lit\xE9 et recueillir 3 tours de r\xE9actions.",
-      description: "Stage 1 action 0 description"
+      value: "Entregar un prototipo de baja fidelidad y recopilar 3 rondas de reacciones.",
+      description: "Action description for stage 1 prototype iteration"
     },
     "playbook.stage1.action1.title": {
-      value: "Capturer les signaux de recommandation",
-      description: "Stage 1 action 1 title"
+      value: "Capturar se\xF1ales de recomendaci\xF3n",
+      description: "Action title for stage 1 referral tracking"
     },
     "playbook.stage1.action1.description": {
-      value: "Demander \xE0 chaque testeur qui d'autre devrait voir la d\xE9mo.",
-      description: "Stage 1 action 1 description"
+      value: "Preguntar a cada tester qui\xE9n m\xE1s deber\xEDa ver la demo.",
+      description: "Action description for stage 1 referral tracking"
     },
     "playbook.stage2.action0.title": {
-      value: "D\xE9finir la checklist d'activation",
-      description: "Stage 2 action 0 title"
+      value: "Definir lista de verificaci\xF3n de activaci\xF3n",
+      description: "Action title for stage 2 activation definition"
     },
     "playbook.stage2.action0.description": {
-      value: "Documenter les 3 \xE9tapes que les utilisateurs doivent terminer pour obtenir de la valeur.",
-      description: "Stage 2 action 0 description"
+      value: "Documentar los 3 pasos que los usuarios deben completar para obtener valor.",
+      description: "Action description for stage 2 activation definition"
     },
     "playbook.stage2.action1.title": {
-      value: "Synchronisation hebdomadaire avec les utilisateurs",
-      description: "Stage 2 action 1 title"
+      value: "Sincronizaci\xF3n semanal con usuarios",
+      description: "Action title for stage 2 user communication"
     },
     "playbook.stage2.action1.description": {
-      value: "Organiser un appel r\xE9current avec vos 5 testeurs les plus actifs.",
-      description: "Stage 2 action 1 description"
+      value: "Organizar una llamada recurrente con tus 5 testers m\xE1s activos.",
+      description: "Action description for stage 2 user communication"
     },
     "playbook.stage3.action0.title": {
-      value: "Mener une \xE9tude de r\xE9tention",
-      description: "Stage 3 action 0 title"
+      value: "Realizar un estudio de retenci\xF3n",
+      description: "Action title for stage 3 retention analysis"
     },
     "playbook.stage3.action0.description": {
-      value: "Interviewer 3 utilisateurs retenus et publier leurs m\xE9triques avant/apr\xE8s.",
-      description: "Stage 3 action 0 description"
+      value: "Entrevistar a 3 usuarios retenidos y publicar sus m\xE9tricas antes/despu\xE9s.",
+      description: "Action description for stage 3 retention analysis"
     },
     "playbook.stage3.action1.title": {
-      value: "Revue l\xE9g\xE8re d'incidents",
-      description: "Stage 3 action 1 title"
+      value: "Revisi\xF3n ligera de incidentes",
+      description: "Action title for stage 3 reliability review"
     },
     "playbook.stage3.action1.description": {
-      value: "Examiner les 2 derniers incidents de fiabilit\xE9 et capturer les correctifs.",
-      description: "Stage 3 action 1 description"
+      value: "Revisar los \xFAltimos 2 problemas de fiabilidad y capturar las correcciones.",
+      description: "Action description for stage 3 reliability review"
     },
     "playbook.stage4.action0.title": {
-      value: "Codifier une boucle de croissance",
-      description: "Stage 4 action 0 title"
+      value: "Codificar un bucle de crecimiento",
+      description: "Action title for stage 4 growth loop setup"
     },
     "playbook.stage4.action0.description": {
-      value: "Choisir une boucle (SEO, recommandations, outbound) et documenter les responsables + entr\xE9es.",
-      description: "Stage 4 action 0 description"
+      value: "Elegir un bucle (SEO, referencias, outbound) y documentar responsables + entradas.",
+      description: "Action description for stage 4 growth loop setup"
     },
     "playbook.stage4.action1.title": {
-      value: "Cr\xE9er la carte de recrutement",
-      description: "Stage 4 action 1 title"
+      value: "Crear mapa de contrataci\xF3n",
+      description: "Action title for stage 4 hiring plan"
     },
     "playbook.stage4.action1.description": {
-      value: "Lister les r\xF4les sp\xE9cialis\xE9s n\xE9cessaires pour les 2 prochains trimestres.",
-      description: "Stage 4 action 1 description"
+      value: "Listar los roles especializados necesarios para los pr\xF3ximos 2 trimestres.",
+      description: "Action description for stage 4 hiring plan"
     },
     "playbook.stage5.action0.title": {
-      value: "Brief de pr\xE9paration partenaire",
-      description: "Stage 5 action 0 title"
+      value: "Brief de preparaci\xF3n para socios",
+      description: "Action title for stage 5 partner preparation"
     },
     "playbook.stage5.action0.description": {
-      value: "Documenter les types de partenaires, propositions de valeur et \xE9tapes d'int\xE9gration.",
-      description: "Stage 5 action 0 description"
+      value: "Documentar tipos de socios, propuestas de valor y pasos de incorporaci\xF3n.",
+      description: "Action description for stage 5 partner preparation"
     },
     "playbook.stage5.action1.title": {
-      value: "Portefeuille d'exp\xE9riences d'expansion",
-      description: "Stage 5 action 1 title"
+      value: "Portafolio de experimentos de expansi\xF3n",
+      description: "Action title for stage 5 expansion planning"
     },
     "playbook.stage5.action1.description": {
-      value: "Lister les 3 principaux march\xE9s ou lignes de produits avec les responsables.",
-      description: "Stage 5 action 1 description"
+      value: "Listar los 3 principales mercados o l\xEDneas de producto con responsables.",
+      description: "Action description for stage 5 expansion planning"
     },
     "playbook.stage6.action0.title": {
-      value: "Mener une revue co\xFBt-valeur",
-      description: "Stage 6 action 0 title"
+      value: "Realizar una revisi\xF3n costo-valor",
+      description: "Action title for stage 6 margin audit"
     },
     "playbook.stage6.action0.description": {
-      value: "Auditer chaque surface majeure pour l\u2019impact sur les marges.",
-      description: "Stage 6 action 0 description"
+      value: "Auditar cada superficie principal por impacto en m\xE1rgenes.",
+      description: "Action description for stage 6 margin audit"
     },
     "playbook.stage6.action1.title": {
-      value: "D\xE9finir le pari de renouvellement",
-      description: "Stage 6 action 1 title"
+      value: "Definir la apuesta de renovaci\xF3n",
+      description: "Action title for stage 6 reinvention track"
     },
     "playbook.stage6.action1.description": {
-      value: "Choisir une piste de r\xE9invention ou d'arr\xEAt et d\xE9finir des points de contr\xF4le.",
-      description: "Stage 6 action 1 description"
+      value: "Elegir una pista de reinvenci\xF3n o descontinuaci\xF3n y establecer puntos de control.",
+      description: "Action description for stage 6 reinvention track"
     },
     "ceremony.stage0.title": {
-      value: "\xC9tincelle de d\xE9couverte",
-      description: "Stage 0 ceremony title"
+      value: "Chispa de descubrimiento",
+      description: "Ceremony title for stage 0"
     },
     "ceremony.stage0.copy": {
-      value: "Partagez la citation la plus percutante avec votre \xE9quipe. Encadrez-la, c\xE9l\xE9brez le focus.",
-      description: "Stage 0 ceremony copy"
+      value: "Comparte la cita de dolor m\xE1s impactante con tu equipo. Enm\xE1rcala, celebra el enfoque.",
+      description: "Ceremony copy for stage 0"
     },
     "ceremony.stage1.title": {
-      value: "R\xE9sonance de la solution",
-      description: "Stage 1 ceremony title"
+      value: "Resonancia de la soluci\xF3n",
+      description: "Ceremony title for stage 1"
     },
     "ceremony.stage1.copy": {
-      value: "Enregistrez un court partage d'\xE9cran racontant l'histoire avant/apr\xE8s \xE0 votre futur vous.",
-      description: "Stage 1 ceremony copy"
+      value: "Graba un breve screencast contando la historia antes/despu\xE9s a tu futuro yo.",
+      description: "Ceremony copy for stage 1"
     },
     "ceremony.stage2.title": {
-      value: "Toast \xE0 la traction",
-      description: "Stage 2 ceremony title"
+      value: "Brindis por la tracci\xF3n",
+      description: "Ceremony title for stage 2"
     },
     "ceremony.stage2.copy": {
-      value: "Portez un toast \xE0 vos 20 premiers vrais utilisateurs \u2014 dites leurs noms, dites-leur pourquoi ils comptent.",
-      description: "Stage 2 ceremony copy"
+      value: "Brinda por tus primeros 20 usuarios reales\u2014di sus nombres, diles por qu\xE9 importan.",
+      description: "Ceremony copy for stage 2"
     },
     "ceremony.stage3.title": {
-      value: "Signal PMF",
-      description: "Stage 3 ceremony title"
+      value: "Se\xF1al de fuego PMF",
+      description: "Ceremony title for stage 3"
     },
     "ceremony.stage3.copy": {
-      value: "\xC9crivez une lettre \xE0 votre futur vous de la S\xE9rie A d\xE9crivant l'attraction que vous ressentez aujourd'hui.",
-      description: "Stage 3 ceremony copy"
+      value: "Escribe una carta a tu futuro yo de la Serie A describiendo la atracci\xF3n que sientes hoy.",
+      description: "Ceremony copy for stage 3"
     },
     "ceremony.stage4.title": {
-      value: "Syst\xE8mes d'\xE9chelle",
-      description: "Stage 4 ceremony title"
+      value: "Sistemas de escala",
+      description: "Ceremony title for stage 4"
     },
     "ceremony.stage4.copy": {
-      value: "Invitez l'\xE9quipe \xE0 cartographier le parcours du premier utilisateur \xE0 la machine r\xE9p\xE9table.",
-      description: "Stage 4 ceremony copy"
+      value: "Invita al equipo a mapear el viaje desde el primer usuario hasta la m\xE1quina repetible.",
+      description: "Ceremony copy for stage 4"
     },
     "ceremony.stage5.title": {
-      value: "Seuil de la plateforme",
-      description: "Stage 5 ceremony title"
+      value: "Umbral de la plataforma",
+      description: "Ceremony title for stage 5"
     },
     "ceremony.stage5.copy": {
-      value: "Organisez un cercle de partenaires \u2014 invitez les alli\xE9s \xE0 partager ce dont ils ont besoin de votre plateforme.",
-      description: "Stage 5 ceremony copy"
+      value: "Organiza un c\xEDrculo de socios\u2014invita a los aliados a compartir lo que necesitan de tu plataforma.",
+      description: "Ceremony copy for stage 5"
     },
     "ceremony.stage6.title": {
-      value: "Sommet du renouvellement",
-      description: "Stage 6 ceremony title"
+      value: "Cumbre de renovaci\xF3n",
+      description: "Ceremony title for stage 6"
     },
     "ceremony.stage6.copy": {
-      value: "Faites une pause pour honorer ce qui vous a amen\xE9 ici, puis engagez-vous publiquement pour la prochaine r\xE9invention.",
-      description: "Stage 6 ceremony copy"
+      value: "Haz una pausa para honrar lo que te trajo aqu\xED, luego compr\xF3metete p\xFAblicamente con la pr\xF3xima reinvenci\xF3n.",
+      description: "Ceremony copy for stage 6"
     },
     "library.stage0.item0": {
-      value: "R\xE9sumer les entretiens et synth\xE9tiser les insights IC.",
-      description: "Stage 0 library item 0"
+      value: "Resumir entrevistas y sintetizar insights de IC.",
+      description: "Library tool description for stage 0 item 0"
     },
     "library.stage0.item1": {
-      value: "Cr\xE9er des storyboards basse fid\xE9lit\xE9 sans code personnalis\xE9.",
-      description: "Stage 0 library item 1"
+      value: "Crear storyboards de baja fidelidad sin c\xF3digo personalizado.",
+      description: "Library tool description for stage 0 item 1"
     },
     "library.stage1.item0": {
-      value: "Contr\xF4ler les fonctionnalit\xE9s prototype derri\xE8re des flags l\xE9gers.",
-      description: "Stage 1 library item 0"
+      value: "Controlar funcionalidades del prototipo detr\xE1s de flags ligeros.",
+      description: "Library tool description for stage 1 item 0"
     },
     "library.stage1.item1": {
-      value: "Capturer les signaux de questionnaire pour un scoring pr\xE9coce.",
-      description: "Stage 1 library item 1"
+      value: "Capturar se\xF1ales de cuestionario para scoring temprano.",
+      description: "Library tool description for stage 1 item 1"
     },
     "library.stage2.item0": {
-      value: "Instrumenter les parcours d'activation + cohortes.",
-      description: "Stage 2 library item 0"
+      value: "Instrumentar rutas de activaci\xF3n + cohortes.",
+      description: "Library tool description for stage 2 item 0"
     },
     "library.stage2.item1": {
-      value: "Collecter les traces et m\xE9triques minimales viables.",
-      description: "Stage 2 library item 1"
+      value: "Recopilar trazas y m\xE9tricas m\xEDnimas viables.",
+      description: "Library tool description for stage 2 item 1"
     },
     "library.stage3.item0": {
-      value: "D\xE9tecter automatiquement les lacunes de contrat et am\xE9liorations de spec.",
-      description: "Stage 3 library item 0"
+      value: "Detectar autom\xE1ticamente brechas de contrato y mejoras de spec.",
+      description: "Library tool description for stage 3 item 0"
     },
     "library.stage3.item1": {
-      value: "G\xE9n\xE9rer des conseils ax\xE9s sur la r\xE9tention \xE0 grande \xE9chelle.",
-      description: "Stage 3 library item 1"
+      value: "Generar orientaci\xF3n enfocada en retenci\xF3n a escala.",
+      description: "Library tool description for stage 3 item 1"
     },
     "library.stage4.item0": {
-      value: "Orchestration d'exp\xE9riences avec garde-fous.",
-      description: "Stage 4 library item 0"
+      value: "Orquestaci\xF3n de experimentos con barandillas.",
+      description: "Library tool description for stage 4 item 0"
     },
     "library.stage4.item1": {
-      value: "Stabiliser l\u2019infra et les SLOs au fur et \xE0 mesure que les \xE9quipes se divisent.",
-      description: "Stage 4 library item 1"
+      value: "Estabilizar infraestructura y SLOs a medida que los equipos se dividen.",
+      description: "Library tool description for stage 4 item 1"
     },
     "library.stage5.item0": {
-      value: "Automatiser les workflows partenaires et int\xE9grations.",
-      description: "Stage 5 library item 0"
+      value: "Automatizar flujos de trabajo de socios e integraciones.",
+      description: "Library tool description for stage 5 item 0"
     },
     "library.stage5.item1": {
-      value: "Exposer l'int\xE9gration partenaire g\xE9r\xE9e via Studio.",
-      description: "Stage 5 library item 1"
+      value: "Exponer incorporaci\xF3n de socios gestionada v\xEDa Studio.",
+      description: "Library tool description for stage 5 item 1"
     },
     "library.stage6.item0": {
-      value: "Mod\xE9liser les sc\xE9narios de marge et paris de r\xE9investissement.",
-      description: "Stage 6 library item 0"
+      value: "Modelar escenarios de margen y apuestas de reinversi\xF3n.",
+      description: "Library tool description for stage 6 item 0"
     },
     "library.stage6.item1": {
-      value: "Standardiser les rituels de renouvellement et l'automatisation.",
-      description: "Stage 6 library item 1"
+      value: "Estandarizar rituales de renovaci\xF3n y automatizaci\xF3n.",
+      description: "Library tool description for stage 6 item 1"
     },
     "engine.fallbackAction.title": {
-      value: "Avancer sur {focus}",
-      description: "Fallback action title with focus placeholder"
+      value: "Avanzar en {focus}",
+      description: "Fallback action title when no specific action exists",
+      placeholders: [{ name: "focus", type: "string" }]
     },
     "engine.fallbackAction.description": {
-      value: "Identifier une t\xE2che qui am\xE9liorera \xAB\u202F{focus}\u202F\xBB cette semaine.",
-      description: "Fallback action description with focus placeholder"
+      value: 'Identificar una tarea que mejore "{focus}" esta semana.',
+      description: "Fallback action description when no specific action exists",
+      placeholders: [{ name: "focus", type: "string" }]
     }
   }
 });
 
-// src/i18n/catalogs/es.ts
+// src/i18n/catalogs/fr.ts
 import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations";
-var esMessages = defineTranslation3({
+var frMessages = defineTranslation3({
   meta: {
     key: "lifecycle-advisor.messages",
     version: "1.0.0",
     domain: "lifecycle-advisor",
-    description: "Playbook, ceremony, library, and engine strings (Spanish)",
+    description: "Playbook, ceremony, library, and engine strings (French)",
     owners: ["platform"],
     stability: "experimental"
   },
-  locale: "es",
+  locale: "fr",
   fallback: "en",
   messages: {
     "playbook.stage0.focus.0": {
-      value: "Descubrimiento",
-      description: "Stage 0 focus area: discovery research"
+      value: "D\xE9couverte",
+      description: "Stage 0 focus area: Discovery"
     },
     "playbook.stage0.focus.1": {
-      value: "Claridad del problema",
-      description: "Stage 0 focus area: sharpening the problem definition"
+      value: "Clart\xE9 du probl\xE8me",
+      description: "Stage 0 focus area: Problem clarity"
     },
     "playbook.stage0.focus.2": {
       value: "Persona",
-      description: "Stage 0 focus area: identifying the target persona"
+      description: "Stage 0 focus area: Persona"
     },
     "playbook.stage1.focus.0": {
-      value: "Prototipo",
-      description: "Stage 1 focus area: building a prototype"
+      value: "Prototype",
+      description: "Stage 1 focus area: Prototype"
     },
     "playbook.stage1.focus.1": {
-      value: "Retroalimentaci\xF3n",
-      description: "Stage 1 focus area: gathering user feedback"
+      value: "Retours",
+      description: "Stage 1 focus area: Feedback"
     },
     "playbook.stage1.focus.2": {
-      value: "Prueba de valor",
-      description: "Stage 1 focus area: proving the value proposition"
+      value: "Preuve de valeur",
+      description: "Stage 1 focus area: Value proof"
     },
     "playbook.stage2.focus.0": {
-      value: "Activaci\xF3n",
-      description: "Stage 2 focus area: user activation"
+      value: "Activation",
+      description: "Stage 2 focus area: Activation"
     },
     "playbook.stage2.focus.1": {
-      value: "Telemetr\xEDa",
-      description: "Stage 2 focus area: usage telemetry"
+      value: "T\xE9l\xE9m\xE9trie",
+      description: "Stage 2 focus area: Telemetry"
     },
     "playbook.stage2.focus.2": {
-      value: "Retroalimentaci\xF3n",
-      description: "Stage 2 focus area: continuous user feedback"
+      value: "Retours",
+      description: "Stage 2 focus area: Feedback"
     },
     "playbook.stage3.focus.0": {
-      value: "Retenci\xF3n",
-      description: "Stage 3 focus area: user retention"
+      value: "R\xE9tention",
+      description: "Stage 3 focus area: Retention"
     },
     "playbook.stage3.focus.1": {
-      value: "Fiabilidad",
-      description: "Stage 3 focus area: product reliability"
+      value: "Fiabilit\xE9",
+      description: "Stage 3 focus area: Reliability"
     },
     "playbook.stage3.focus.2": {
-      value: "Historia",
-      description: "Stage 3 focus area: building the narrative"
+      value: "R\xE9cit",
+      description: "Stage 3 focus area: Story"
     },
     "playbook.stage4.focus.0": {
-      value: "Sistemas",
-      description: "Stage 4 focus area: scalable systems"
+      value: "Syst\xE8mes",
+      description: "Stage 4 focus area: Systems"
     },
     "playbook.stage4.focus.1": {
-      value: "Bucles de crecimiento",
-      description: "Stage 4 focus area: repeatable growth loops"
+      value: "Boucles de croissance",
+      description: "Stage 4 focus area: Growth loops"
     },
     "playbook.stage4.focus.2": {
-      value: "Especializaci\xF3n",
-      description: "Stage 4 focus area: team specialization"
+      value: "Sp\xE9cialisation",
+      description: "Stage 4 focus area: Specialization"
     },
     "playbook.stage5.focus.0": {
-      value: "Socios",
-      description: "Stage 5 focus area: partner ecosystem"
+      value: "Partenaires",
+      description: "Stage 5 focus area: Partners"
     },
     "playbook.stage5.focus.1": {
       value: "APIs",
-      description: "Stage 5 focus area: platform APIs"
+      description: "Stage 5 focus area: APIs"
     },
     "playbook.stage5.focus.2": {
-      value: "Apuestas de expansi\xF3n",
-      description: "Stage 5 focus area: expansion experiments"
+      value: "Paris d'expansion",
+      description: "Stage 5 focus area: Expansion bets"
     },
     "playbook.stage6.focus.0": {
-      value: "Optimizaci\xF3n",
-      description: "Stage 6 focus area: operational optimization"
+      value: "Optimisation",
+      description: "Stage 6 focus area: Optimization"
     },
     "playbook.stage6.focus.1": {
-      value: "Renovaci\xF3n",
-      description: "Stage 6 focus area: product renewal"
+      value: "Renouvellement",
+      description: "Stage 6 focus area: Renewal"
     },
     "playbook.stage6.focus.2": {
-      value: "Portafolio",
-      description: "Stage 6 focus area: portfolio management"
+      value: "Portefeuille",
+      description: "Stage 6 focus area: Portfolio"
     },
     "playbook.stage0.action0.title": {
-      value: "Realizar un sprint de entrevistas de 5 d\xEDas",
-      description: "Action title for stage 0 interview sprint"
+      value: "Mener un sprint d'entretiens de 5 jours",
+      description: "Stage 0 action 0 title"
     },
     "playbook.stage0.action0.description": {
-      value: "Programar al menos 5 entrevistas consecutivas y capturar citas sin editar.",
-      description: "Action description for stage 0 interview sprint"
+      value: "Planifier au moins 5 entretiens cons\xE9cutifs et capturer les citations brutes.",
+      description: "Stage 0 action 0 description"
     },
     "playbook.stage0.action1.title": {
-      value: "Redactar la historia del problema",
-      description: "Action title for stage 0 problem narrative"
+      value: "R\xE9diger l'histoire du probl\xE8me",
+      description: "Stage 0 action 1 title"
     },
     "playbook.stage0.action1.description": {
-      value: "Resumir el dolor en un p\xE1rrafo que puedas repetir a los socios.",
-      description: "Action description for stage 0 problem narrative"
+      value: "R\xE9sumer la douleur en un paragraphe que vous pouvez r\xE9p\xE9ter aux partenaires.",
+      description: "Stage 0 action 1 description"
     },
     "playbook.stage1.action0.title": {
-      value: "Ciclo de retroalimentaci\xF3n del prototipo",
-      description: "Action title for stage 1 prototype iteration"
+      value: "Boucle de retours sur le prototype",
+      description: "Stage 1 action 0 title"
     },
     "playbook.stage1.action0.description": {
-      value: "Entregar un prototipo de baja fidelidad y recopilar 3 rondas de reacciones.",
-      description: "Action description for stage 1 prototype iteration"
+      value: "Livrer un prototype basse fid\xE9lit\xE9 et recueillir 3 tours de r\xE9actions.",
+      description: "Stage 1 action 0 description"
     },
     "playbook.stage1.action1.title": {
-      value: "Capturar se\xF1ales de recomendaci\xF3n",
-      description: "Action title for stage 1 referral tracking"
+      value: "Capturer les signaux de recommandation",
+      description: "Stage 1 action 1 title"
     },
     "playbook.stage1.action1.description": {
-      value: "Preguntar a cada tester qui\xE9n m\xE1s deber\xEDa ver la demo.",
-      description: "Action description for stage 1 referral tracking"
+      value: "Demander \xE0 chaque testeur qui d'autre devrait voir la d\xE9mo.",
+      description: "Stage 1 action 1 description"
     },
     "playbook.stage2.action0.title": {
-      value: "Definir lista de verificaci\xF3n de activaci\xF3n",
-      description: "Action title for stage 2 activation definition"
+      value: "D\xE9finir la checklist d'activation",
+      description: "Stage 2 action 0 title"
     },
     "playbook.stage2.action0.description": {
-      value: "Documentar los 3 pasos que los usuarios deben completar para obtener valor.",
-      description: "Action description for stage 2 activation definition"
+      value: "Documenter les 3 \xE9tapes que les utilisateurs doivent terminer pour obtenir de la valeur.",
+      description: "Stage 2 action 0 description"
     },
     "playbook.stage2.action1.title": {
-      value: "Sincronizaci\xF3n semanal con usuarios",
-      description: "Action title for stage 2 user communication"
+      value: "Synchronisation hebdomadaire avec les utilisateurs",
+      description: "Stage 2 action 1 title"
     },
     "playbook.stage2.action1.description": {
-      value: "Organizar una llamada recurrente con tus 5 testers m\xE1s activos.",
-      description: "Action description for stage 2 user communication"
+      value: "Organiser un appel r\xE9current avec vos 5 testeurs les plus actifs.",
+      description: "Stage 2 action 1 description"
     },
     "playbook.stage3.action0.title": {
-      value: "Realizar un estudio de retenci\xF3n",
-      description: "Action title for stage 3 retention analysis"
+      value: "Mener une \xE9tude de r\xE9tention",
+      description: "Stage 3 action 0 title"
     },
     "playbook.stage3.action0.description": {
-      value: "Entrevistar a 3 usuarios retenidos y publicar sus m\xE9tricas antes/despu\xE9s.",
-      description: "Action description for stage 3 retention analysis"
+      value: "Interviewer 3 utilisateurs retenus et publier leurs m\xE9triques avant/apr\xE8s.",
+      description: "Stage 3 action 0 description"
     },
     "playbook.stage3.action1.title": {
-      value: "Revisi\xF3n ligera de incidentes",
-      description: "Action title for stage 3 reliability review"
+      value: "Revue l\xE9g\xE8re d'incidents",
+      description: "Stage 3 action 1 title"
     },
     "playbook.stage3.action1.description": {
-      value: "Revisar los \xFAltimos 2 problemas de fiabilidad y capturar las correcciones.",
-      description: "Action description for stage 3 reliability review"
+      value: "Examiner les 2 derniers incidents de fiabilit\xE9 et capturer les correctifs.",
+      description: "Stage 3 action 1 description"
     },
     "playbook.stage4.action0.title": {
-      value: "Codificar un bucle de crecimiento",
-      description: "Action title for stage 4 growth loop setup"
+      value: "Codifier une boucle de croissance",
+      description: "Stage 4 action 0 title"
     },
     "playbook.stage4.action0.description": {
-      value: "Elegir un bucle (SEO, referencias, outbound) y documentar responsables + entradas.",
-      description: "Action description for stage 4 growth loop setup"
+      value: "Choisir une boucle (SEO, recommandations, outbound) et documenter les responsables + entr\xE9es.",
+      description: "Stage 4 action 0 description"
     },
     "playbook.stage4.action1.title": {
-      value: "Crear mapa de contrataci\xF3n",
-      description: "Action title for stage 4 hiring plan"
+      value: "Cr\xE9er la carte de recrutement",
+      description: "Stage 4 action 1 title"
     },
     "playbook.stage4.action1.description": {
-      value: "Listar los roles especializados necesarios para los pr\xF3ximos 2 trimestres.",
-      description: "Action description for stage 4 hiring plan"
+      value: "Lister les r\xF4les sp\xE9cialis\xE9s n\xE9cessaires pour les 2 prochains trimestres.",
+      description: "Stage 4 action 1 description"
     },
     "playbook.stage5.action0.title": {
-      value: "Brief de preparaci\xF3n para socios",
-      description: "Action title for stage 5 partner preparation"
+      value: "Brief de pr\xE9paration partenaire",
+      description: "Stage 5 action 0 title"
     },
     "playbook.stage5.action0.description": {
-      value: "Documentar tipos de socios, propuestas de valor y pasos de incorporaci\xF3n.",
-      description: "Action description for stage 5 partner preparation"
+      value: "Documenter les types de partenaires, propositions de valeur et \xE9tapes d'int\xE9gration.",
+      description: "Stage 5 action 0 description"
     },
     "playbook.stage5.action1.title": {
-      value: "Portafolio de experimentos de expansi\xF3n",
-      description: "Action title for stage 5 expansion planning"
+      value: "Portefeuille d'exp\xE9riences d'expansion",
+      description: "Stage 5 action 1 title"
     },
     "playbook.stage5.action1.description": {
-      value: "Listar los 3 principales mercados o l\xEDneas de producto con responsables.",
-      description: "Action description for stage 5 expansion planning"
+      value: "Lister les 3 principaux march\xE9s ou lignes de produits avec les responsables.",
+      description: "Stage 5 action 1 description"
     },
     "playbook.stage6.action0.title": {
-      value: "Realizar una revisi\xF3n costo-valor",
-      description: "Action title for stage 6 margin audit"
+      value: "Mener une revue co\xFBt-valeur",
+      description: "Stage 6 action 0 title"
     },
     "playbook.stage6.action0.description": {
-      value: "Auditar cada superficie principal por impacto en m\xE1rgenes.",
-      description: "Action description for stage 6 margin audit"
+      value: "Auditer chaque surface majeure pour l\u2019impact sur les marges.",
+      description: "Stage 6 action 0 description"
     },
     "playbook.stage6.action1.title": {
-      value: "Definir la apuesta de renovaci\xF3n",
-      description: "Action title for stage 6 reinvention track"
+      value: "D\xE9finir le pari de renouvellement",
+      description: "Stage 6 action 1 title"
     },
     "playbook.stage6.action1.description": {
-      value: "Elegir una pista de reinvenci\xF3n o descontinuaci\xF3n y establecer puntos de control.",
-      description: "Action description for stage 6 reinvention track"
+      value: "Choisir une piste de r\xE9invention ou d'arr\xEAt et d\xE9finir des points de contr\xF4le.",
+      description: "Stage 6 action 1 description"
     },
     "ceremony.stage0.title": {
-      value: "Chispa de descubrimiento",
-      description: "Ceremony title for stage 0"
+      value: "\xC9tincelle de d\xE9couverte",
+      description: "Stage 0 ceremony title"
     },
     "ceremony.stage0.copy": {
-      value: "Comparte la cita de dolor m\xE1s impactante con tu equipo. Enm\xE1rcala, celebra el enfoque.",
-      description: "Ceremony copy for stage 0"
+      value: "Partagez la citation la plus percutante avec votre \xE9quipe. Encadrez-la, c\xE9l\xE9brez le focus.",
+      description: "Stage 0 ceremony copy"
     },
     "ceremony.stage1.title": {
-      value: "Resonancia de la soluci\xF3n",
-      description: "Ceremony title for stage 1"
+      value: "R\xE9sonance de la solution",
+      description: "Stage 1 ceremony title"
     },
     "ceremony.stage1.copy": {
-      value: "Graba un breve screencast contando la historia antes/despu\xE9s a tu futuro yo.",
-      description: "Ceremony copy for stage 1"
+      value: "Enregistrez un court partage d'\xE9cran racontant l'histoire avant/apr\xE8s \xE0 votre futur vous.",
+      description: "Stage 1 ceremony copy"
     },
     "ceremony.stage2.title": {
-      value: "Brindis por la tracci\xF3n",
-      description: "Ceremony title for stage 2"
+      value: "Toast \xE0 la traction",
+      description: "Stage 2 ceremony title"
     },
     "ceremony.stage2.copy": {
-      value: "Brinda por tus primeros 20 usuarios reales\u2014di sus nombres, diles por qu\xE9 importan.",
-      description: "Ceremony copy for stage 2"
+      value: "Portez un toast \xE0 vos 20 premiers vrais utilisateurs \u2014 dites leurs noms, dites-leur pourquoi ils comptent.",
+      description: "Stage 2 ceremony copy"
     },
     "ceremony.stage3.title": {
-      value: "Se\xF1al de fuego PMF",
-      description: "Ceremony title for stage 3"
+      value: "Signal PMF",
+      description: "Stage 3 ceremony title"
     },
     "ceremony.stage3.copy": {
-      value: "Escribe una carta a tu futuro yo de la Serie A describiendo la atracci\xF3n que sientes hoy.",
-      description: "Ceremony copy for stage 3"
+      value: "\xC9crivez une lettre \xE0 votre futur vous de la S\xE9rie A d\xE9crivant l'attraction que vous ressentez aujourd'hui.",
+      description: "Stage 3 ceremony copy"
     },
     "ceremony.stage4.title": {
-      value: "Sistemas de escala",
-      description: "Ceremony title for stage 4"
+      value: "Syst\xE8mes d'\xE9chelle",
+      description: "Stage 4 ceremony title"
     },
     "ceremony.stage4.copy": {
-      value: "Invita al equipo a mapear el viaje desde el primer usuario hasta la m\xE1quina repetible.",
-      description: "Ceremony copy for stage 4"
+      value: "Invitez l'\xE9quipe \xE0 cartographier le parcours du premier utilisateur \xE0 la machine r\xE9p\xE9table.",
+      description: "Stage 4 ceremony copy"
     },
     "ceremony.stage5.title": {
-      value: "Umbral de la plataforma",
-      description: "Ceremony title for stage 5"
+      value: "Seuil de la plateforme",
+      description: "Stage 5 ceremony title"
     },
     "ceremony.stage5.copy": {
-      value: "Organiza un c\xEDrculo de socios\u2014invita a los aliados a compartir lo que necesitan de tu plataforma.",
-      description: "Ceremony copy for stage 5"
+      value: "Organisez un cercle de partenaires \u2014 invitez les alli\xE9s \xE0 partager ce dont ils ont besoin de votre plateforme.",
+      description: "Stage 5 ceremony copy"
     },
     "ceremony.stage6.title": {
-      value: "Cumbre de renovaci\xF3n",
-      description: "Ceremony title for stage 6"
+      value: "Sommet du renouvellement",
+      description: "Stage 6 ceremony title"
     },
     "ceremony.stage6.copy": {
-      value: "Haz una pausa para honrar lo que te trajo aqu\xED, luego compr\xF3metete p\xFAblicamente con la pr\xF3xima reinvenci\xF3n.",
-      description: "Ceremony copy for stage 6"
+      value: "Faites une pause pour honorer ce qui vous a amen\xE9 ici, puis engagez-vous publiquement pour la prochaine r\xE9invention.",
+      description: "Stage 6 ceremony copy"
     },
     "library.stage0.item0": {
-      value: "Resumir entrevistas y sintetizar insights de IC.",
-      description: "Library tool description for stage 0 item 0"
+      value: "R\xE9sumer les entretiens et synth\xE9tiser les insights IC.",
+      description: "Stage 0 library item 0"
     },
     "library.stage0.item1": {
-      value: "Crear storyboards de baja fidelidad sin c\xF3digo personalizado.",
-      description: "Library tool description for stage 0 item 1"
+      value: "Cr\xE9er des storyboards basse fid\xE9lit\xE9 sans code personnalis\xE9.",
+      description: "Stage 0 library item 1"
     },
     "library.stage1.item0": {
-      value: "Controlar funcionalidades del prototipo detr\xE1s de flags ligeros.",
-      description: "Library tool description for stage 1 item 0"
+      value: "Contr\xF4ler les fonctionnalit\xE9s prototype derri\xE8re des flags l\xE9gers.",
+      description: "Stage 1 library item 0"
     },
     "library.stage1.item1": {
-      value: "Capturar se\xF1ales de cuestionario para scoring temprano.",
-      description: "Library tool description for stage 1 item 1"
+      value: "Capturer les signaux de questionnaire pour un scoring pr\xE9coce.",
+      description: "Stage 1 library item 1"
     },
     "library.stage2.item0": {
-      value: "Instrumentar rutas de activaci\xF3n + cohortes.",
-      description: "Library tool description for stage 2 item 0"
+      value: "Instrumenter les parcours d'activation + cohortes.",
+      description: "Stage 2 library item 0"
     },
     "library.stage2.item1": {
-      value: "Recopilar trazas y m\xE9tricas m\xEDnimas viables.",
-      description: "Library tool description for stage 2 item 1"
+      value: "Collecter les traces et m\xE9triques minimales viables.",
+      description: "Stage 2 library item 1"
     },
     "library.stage3.item0": {
-      value: "Detectar autom\xE1ticamente brechas de contrato y mejoras de spec.",
-      description: "Library tool description for stage 3 item 0"
+      value: "D\xE9tecter automatiquement les lacunes de contrat et am\xE9liorations de spec.",
+      description: "Stage 3 library item 0"
     },
     "library.stage3.item1": {
-      value: "Generar orientaci\xF3n enfocada en retenci\xF3n a escala.",
-      description: "Library tool description for stage 3 item 1"
+      value: "G\xE9n\xE9rer des conseils ax\xE9s sur la r\xE9tention \xE0 grande \xE9chelle.",
+      description: "Stage 3 library item 1"
     },
     "library.stage4.item0": {
-      value: "Orquestaci\xF3n de experimentos con barandillas.",
-      description: "Library tool description for stage 4 item 0"
+      value: "Orchestration d'exp\xE9riences avec garde-fous.",
+      description: "Stage 4 library item 0"
     },
     "library.stage4.item1": {
-      value: "Estabilizar infraestructura y SLOs a medida que los equipos se dividen.",
-      description: "Library tool description for stage 4 item 1"
+      value: "Stabiliser l\u2019infra et les SLOs au fur et \xE0 mesure que les \xE9quipes se divisent.",
+      description: "Stage 4 library item 1"
     },
     "library.stage5.item0": {
-      value: "Automatizar flujos de trabajo de socios e integraciones.",
-      description: "Library tool description for stage 5 item 0"
+      value: "Automatiser les workflows partenaires et int\xE9grations.",
+      description: "Stage 5 library item 0"
     },
     "library.stage5.item1": {
-      value: "Exponer incorporaci\xF3n de socios gestionada v\xEDa Studio.",
-      description: "Library tool description for stage 5 item 1"
+      value: "Exposer l'int\xE9gration partenaire g\xE9r\xE9e via Studio.",
+      description: "Stage 5 library item 1"
     },
     "library.stage6.item0": {
-      value: "Modelar escenarios de margen y apuestas de reinversi\xF3n.",
-      description: "Library tool description for stage 6 item 0"
+      value: "Mod\xE9liser les sc\xE9narios de marge et paris de r\xE9investissement.",
+      description: "Stage 6 library item 0"
     },
     "library.stage6.item1": {
-      value: "Estandarizar rituales de renovaci\xF3n y automatizaci\xF3n.",
-      description: "Library tool description for stage 6 item 1"
+      value: "Standardiser les rituels de renouvellement et l'automatisation.",
+      description: "Stage 6 library item 1"
     },
     "engine.fallbackAction.title": {
-      value: "Avanzar en {focus}",
-      description: "Fallback action title when no specific action exists",
-      placeholders: [{ name: "focus", type: "string" }]
+      value: "Avancer sur {focus}",
+      description: "Fallback action title with focus placeholder"
     },
     "engine.fallbackAction.description": {
-      value: 'Identificar una tarea que mejore "{focus}" esta semana.',
-      description: "Fallback action description when no specific action exists",
-      placeholders: [{ name: "focus", type: "string" }]
+      value: "Identifier une t\xE2che qui am\xE9liorera \xAB\u202F{focus}\u202F\xBB cette semaine.",
+      description: "Fallback action description with focus placeholder"
     }
   }
 });
@@ -1277,57 +1272,26 @@ var staticPlaybooks = [
 var stagePlaybooks = staticPlaybooks;
 var stage_playbooks_default = stagePlaybooks;
 
-// src/recommendations/recommendation-engine.ts
-var PLAYBOOK_MAP = new Map(stage_playbooks_default.map((entry) => [
+// src/ceremony/ceremony-designer.ts
+var CEREMONY_MAP = new Map(stage_playbooks_default.map((entry) => [
   entry.stage,
-  {
-    ...entry,
-    stage: entry.stage
-  }
+  entry.ceremony
 ]));
 
-class LifecycleRecommendationEngine {
-  playbooks;
+class LifecycleCeremonyDesigner {
+  ceremonies;
   constructor(overrides) {
-    this.playbooks = overrides?.length ? new Map(overrides.map((entry) => [entry.stage, entry])) : PLAYBOOK_MAP;
+    this.ceremonies = overrides?.length ? new Map(overrides.map((entry) => [entry.stage, entry.ceremony])) : CEREMONY_MAP;
   }
-  generate(assessment, options = {}) {
-    const { locale, limit: rawLimit, upcomingMilestones } = options;
-    const limit = rawLimit ?? 3;
-    const entry = locale ? resolveLocalizedPlaybook(assessment.stage, locale) : this.playbooks.get(assessment.stage) ?? createFallbackPlaybook(assessment.stage);
-    const actions = (entry.actions ?? []).slice(0, limit);
-    const finalActions = actions.length > 0 ? actions : fallbackActions(assessment, limit, locale);
-    return {
-      assessmentId: assessment.generatedAt,
-      stage: assessment.stage,
-      actions: finalActions,
-      upcomingMilestones: upcomingMilestones ?? [],
-      ceremony: entry.ceremony
-    };
+  design(stage, locale) {
+    if (locale) {
+      const localized = getLocalizedStagePlaybooks(locale);
+      const entry = localized.find((p) => p.stage === stage);
+      return entry?.ceremony;
+    }
+    return this.ceremonies.get(stage);
   }
 }
-function resolveLocalizedPlaybook(stage, locale) {
-  const localized = getLocalizedStagePlaybooks(locale);
-  return localized.find((p) => p.stage === stage) ?? createFallbackPlaybook(stage, locale);
-}
-var createFallbackPlaybook = (stage, locale) => ({
-  stage,
-  actions: [],
-  focusAreas: locale ? getLocalizedStagePlaybooks(locale).find((p) => p.stage === stage)?.focusAreas ?? LIFECYCLE_STAGE_META[stage].focusAreas : LIFECYCLE_STAGE_META[stage].focusAreas
-});
-var fallbackActions = (assessment, limit, locale) => {
-  const i18n = locale ? createLifecycleAdvisorI18n(locale) : undefined;
-  return (assessment.focusAreas ?? LIFECYCLE_STAGE_META[assessment.stage].focusAreas).slice(0, limit).map((focus, index) => ({
-    id: `fallback-${assessment.stage}-${index}`,
-    stage: assessment.stage,
-    title: i18n ? i18n.t("engine.fallbackAction.title", { focus }) : `Advance ${focus}`,
-    description: i18n ? i18n.t("engine.fallbackAction.description", { focus }) : `Identify one task that will improve "${focus}" this week.`,
-    priority: index + 1,
-    estimatedImpact: "low",
-    effortLevel: "s",
-    category: "product"
-  }));
-};
 // src/data/library-stage-map.ts
 function getLocalizedLibraryStageMap(locale) {
   const i18n = createLifecycleAdvisorI18n(locale);
@@ -1448,7 +1412,6 @@ var staticLibraryStageMap = [
 ];
 var libraryStageMap = staticLibraryStageMap;
 var library_stage_map_default = libraryStageMap;
-
 // src/recommendations/library-recommender.ts
 var LIBRARY_MAP = new Map(library_stage_map_default.map((entry) => [entry.stage, entry.items]));
 
@@ -1469,26 +1432,60 @@ class ContractSpecLibraryRecommender {
     return items.slice(0, limit);
   }
 }
-// src/ceremony/ceremony-designer.ts
-var CEREMONY_MAP = new Map(stage_playbooks_default.map((entry) => [
+// src/recommendations/recommendation-engine.ts
+import {
+  LIFECYCLE_STAGE_META
+} from "@contractspec/lib.lifecycle";
+var PLAYBOOK_MAP = new Map(stage_playbooks_default.map((entry) => [
   entry.stage,
-  entry.ceremony
+  {
+    ...entry,
+    stage: entry.stage
+  }
 ]));
 
-class LifecycleCeremonyDesigner {
-  ceremonies;
+class LifecycleRecommendationEngine {
+  playbooks;
   constructor(overrides) {
-    this.ceremonies = overrides?.length ? new Map(overrides.map((entry) => [entry.stage, entry.ceremony])) : CEREMONY_MAP;
+    this.playbooks = overrides?.length ? new Map(overrides.map((entry) => [entry.stage, entry])) : PLAYBOOK_MAP;
   }
-  design(stage, locale) {
-    if (locale) {
-      const localized = getLocalizedStagePlaybooks(locale);
-      const entry = localized.find((p) => p.stage === stage);
-      return entry?.ceremony;
-    }
-    return this.ceremonies.get(stage);
+  generate(assessment, options = {}) {
+    const { locale, limit: rawLimit, upcomingMilestones } = options;
+    const limit = rawLimit ?? 3;
+    const entry = locale ? resolveLocalizedPlaybook(assessment.stage, locale) : this.playbooks.get(assessment.stage) ?? createFallbackPlaybook(assessment.stage);
+    const actions = (entry.actions ?? []).slice(0, limit);
+    const finalActions = actions.length > 0 ? actions : fallbackActions(assessment, limit, locale);
+    return {
+      assessmentId: assessment.generatedAt,
+      stage: assessment.stage,
+      actions: finalActions,
+      upcomingMilestones: upcomingMilestones ?? [],
+      ceremony: entry.ceremony
+    };
   }
 }
+function resolveLocalizedPlaybook(stage, locale) {
+  const localized = getLocalizedStagePlaybooks(locale);
+  return localized.find((p) => p.stage === stage) ?? createFallbackPlaybook(stage, locale);
+}
+var createFallbackPlaybook = (stage, locale) => ({
+  stage,
+  actions: [],
+  focusAreas: locale ? getLocalizedStagePlaybooks(locale).find((p) => p.stage === stage)?.focusAreas ?? LIFECYCLE_STAGE_META[stage].focusAreas : LIFECYCLE_STAGE_META[stage].focusAreas
+});
+var fallbackActions = (assessment, limit, locale) => {
+  const i18n = locale ? createLifecycleAdvisorI18n(locale) : undefined;
+  return (assessment.focusAreas ?? LIFECYCLE_STAGE_META[assessment.stage].focusAreas).slice(0, limit).map((focus, index) => ({
+    id: `fallback-${assessment.stage}-${index}`,
+    stage: assessment.stage,
+    title: i18n ? i18n.t("engine.fallbackAction.title", { focus }) : `Advance ${focus}`,
+    description: i18n ? i18n.t("engine.fallbackAction.description", { focus }) : `Identify one task that will improve "${focus}" this week.`,
+    priority: index + 1,
+    estimatedImpact: "low",
+    effortLevel: "s",
+    category: "product"
+  }));
+};
 export {
   getLocalizedStagePlaybooks,
   getLocalizedLibraryStageMap,