@contractspec/module.lifecycle-advisor 2.3.0 → 2.5.0

package/dist/index.js

@@ -6,7 +6,1043 @@ import {
 
 // src/data/stage-playbooks.ts
 import { LifecycleStage } from "@contractspec/lib.lifecycle";
-var stagePlaybooks = [
+
+// src/i18n/messages.ts
+import {
+  createI18nFactory
+} from "@contractspec/lib.contracts-spec/translations";
+
+// src/i18n/catalogs/en.ts
+import { defineTranslation } from "@contractspec/lib.contracts-spec/translations";
+var enMessages = defineTranslation({
+  meta: {
+    key: "lifecycle-advisor.messages",
+    version: "1.0.0",
+    domain: "lifecycle-advisor",
+    description: "Playbook, ceremony, library, and engine strings for the lifecycle-advisor module",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "en",
+  fallback: "en",
+  messages: {
+    "playbook.stage0.focus.0": {
+      value: "Discovery",
+      description: "Stage 0 focus area: discovery research"
+    },
+    "playbook.stage0.focus.1": {
+      value: "Problem clarity",
+      description: "Stage 0 focus area: sharpening the problem definition"
+    },
+    "playbook.stage0.focus.2": {
+      value: "Persona",
+      description: "Stage 0 focus area: identifying the target persona"
+    },
+    "playbook.stage1.focus.0": {
+      value: "Prototype",
+      description: "Stage 1 focus area: building a prototype"
+    },
+    "playbook.stage1.focus.1": {
+      value: "Feedback",
+      description: "Stage 1 focus area: gathering user feedback"
+    },
+    "playbook.stage1.focus.2": {
+      value: "Value proof",
+      description: "Stage 1 focus area: proving the value proposition"
+    },
+    "playbook.stage2.focus.0": {
+      value: "Activation",
+      description: "Stage 2 focus area: user activation"
+    },
+    "playbook.stage2.focus.1": {
+      value: "Telemetry",
+      description: "Stage 2 focus area: usage telemetry"
+    },
+    "playbook.stage2.focus.2": {
+      value: "Feedback",
+      description: "Stage 2 focus area: continuous user feedback"
+    },
+    "playbook.stage3.focus.0": {
+      value: "Retention",
+      description: "Stage 3 focus area: user retention"
+    },
+    "playbook.stage3.focus.1": {
+      value: "Reliability",
+      description: "Stage 3 focus area: product reliability"
+    },
+    "playbook.stage3.focus.2": {
+      value: "Story",
+      description: "Stage 3 focus area: building the narrative"
+    },
+    "playbook.stage4.focus.0": {
+      value: "Systems",
+      description: "Stage 4 focus area: scalable systems"
+    },
+    "playbook.stage4.focus.1": {
+      value: "Growth loops",
+      description: "Stage 4 focus area: repeatable growth loops"
+    },
+    "playbook.stage4.focus.2": {
+      value: "Specialization",
+      description: "Stage 4 focus area: team specialization"
+    },
+    "playbook.stage5.focus.0": {
+      value: "Partners",
+      description: "Stage 5 focus area: partner ecosystem"
+    },
+    "playbook.stage5.focus.1": {
+      value: "APIs",
+      description: "Stage 5 focus area: platform APIs"
+    },
+    "playbook.stage5.focus.2": {
+      value: "Expansion bets",
+      description: "Stage 5 focus area: expansion experiments"
+    },
+    "playbook.stage6.focus.0": {
+      value: "Optimization",
+      description: "Stage 6 focus area: operational optimization"
+    },
+    "playbook.stage6.focus.1": {
+      value: "Renewal",
+      description: "Stage 6 focus area: product renewal"
+    },
+    "playbook.stage6.focus.2": {
+      value: "Portfolio",
+      description: "Stage 6 focus area: portfolio management"
+    },
+    "playbook.stage0.action0.title": {
+      value: "Run a 5-day interview burst",
+      description: "Action title for stage 0 interview sprint"
+    },
+    "playbook.stage0.action0.description": {
+      value: "Schedule at least 5 back-to-back interviews and capture raw quotes.",
+      description: "Action description for stage 0 interview sprint"
+    },
+    "playbook.stage0.action1.title": {
+      value: "Write the problem story",
+      description: "Action title for stage 0 problem narrative"
+    },
+    "playbook.stage0.action1.description": {
+      value: "Summarize the pain in one paragraph you can repeat to partners.",
+      description: "Action description for stage 0 problem narrative"
+    },
+    "playbook.stage1.action0.title": {
+      value: "Prototype feedback loop",
+      description: "Action title for stage 1 prototype iteration"
+    },
+    "playbook.stage1.action0.description": {
+      value: "Ship a low-fidelity prototype and collect 3 rounds of reactions.",
+      description: "Action description for stage 1 prototype iteration"
+    },
+    "playbook.stage1.action1.title": {
+      value: "Capture referral signals",
+      description: "Action title for stage 1 referral tracking"
+    },
+    "playbook.stage1.action1.description": {
+      value: "Ask each tester who else should see the demo.",
+      description: "Action description for stage 1 referral tracking"
+    },
+    "playbook.stage2.action0.title": {
+      value: "Define activation checklist",
+      description: "Action title for stage 2 activation definition"
+    },
+    "playbook.stage2.action0.description": {
+      value: "Document the 3 steps users must finish to get value.",
+      description: "Action description for stage 2 activation definition"
+    },
+    "playbook.stage2.action1.title": {
+      value: "Weekly user sync",
+      description: "Action title for stage 2 user communication"
+    },
+    "playbook.stage2.action1.description": {
+      value: "Host a standing call with your 5 most active testers.",
+      description: "Action description for stage 2 user communication"
+    },
+    "playbook.stage3.action0.title": {
+      value: "Run a retention study",
+      description: "Action title for stage 3 retention analysis"
+    },
+    "playbook.stage3.action0.description": {
+      value: "Interview 3 retained users and publish their before/after metrics.",
+      description: "Action description for stage 3 retention analysis"
+    },
+    "playbook.stage3.action1.title": {
+      value: "Lightweight incident review",
+      description: "Action title for stage 3 reliability review"
+    },
+    "playbook.stage3.action1.description": {
+      value: "Review the last 2 reliability hiccups and capture fixes.",
+      description: "Action description for stage 3 reliability review"
+    },
+    "playbook.stage4.action0.title": {
+      value: "Codify a growth loop",
+      description: "Action title for stage 4 growth loop setup"
+    },
+    "playbook.stage4.action0.description": {
+      value: "Choose one loop (SEO, referrals, outbound) and document owners + inputs.",
+      description: "Action description for stage 4 growth loop setup"
+    },
+    "playbook.stage4.action1.title": {
+      value: "Create hiring map",
+      description: "Action title for stage 4 hiring plan"
+    },
+    "playbook.stage4.action1.description": {
+      value: "List specialized roles you need in the next 2 quarters.",
+      description: "Action description for stage 4 hiring plan"
+    },
+    "playbook.stage5.action0.title": {
+      value: "Partner readiness brief",
+      description: "Action title for stage 5 partner preparation"
+    },
+    "playbook.stage5.action0.description": {
+      value: "Document partner types, value props, and onboarding steps.",
+      description: "Action description for stage 5 partner preparation"
+    },
+    "playbook.stage5.action1.title": {
+      value: "Expansion experiment portfolio",
+      description: "Action title for stage 5 expansion planning"
+    },
+    "playbook.stage5.action1.description": {
+      value: "List the top 3 markets or product lines with owners.",
+      description: "Action description for stage 5 expansion planning"
+    },
+    "playbook.stage6.action0.title": {
+      value: "Run a cost-to-value review",
+      description: "Action title for stage 6 margin audit"
+    },
+    "playbook.stage6.action0.description": {
+      value: "Audit each major surface for margin impact.",
+      description: "Action description for stage 6 margin audit"
+    },
+    "playbook.stage6.action1.title": {
+      value: "Define the renewal bet",
+      description: "Action title for stage 6 reinvention track"
+    },
+    "playbook.stage6.action1.description": {
+      value: "Choose one reinvention or sunset track and set checkpoints.",
+      description: "Action description for stage 6 reinvention track"
+    },
+    "ceremony.stage0.title": {
+      value: "Discovery Spark",
+      description: "Ceremony title for stage 0"
+    },
+    "ceremony.stage0.copy": {
+      value: "Share the sharpest pain quote with your crew. Frame it, celebrate focus.",
+      description: "Ceremony copy for stage 0"
+    },
+    "ceremony.stage1.title": {
+      value: "Solution Resonance",
+      description: "Ceremony title for stage 1"
+    },
+    "ceremony.stage1.copy": {
+      value: "Record a short screen share telling the before/after story to your future self.",
+      description: "Ceremony copy for stage 1"
+    },
+    "ceremony.stage2.title": {
+      value: "Traction Toast",
+      description: "Ceremony title for stage 2"
+    },
+    "ceremony.stage2.copy": {
+      value: "Toast your first 20 real users\u2014say their names, tell them why they matter.",
+      description: "Ceremony copy for stage 2"
+    },
+    "ceremony.stage3.title": {
+      value: "PMF Signal Fire",
+      description: "Ceremony title for stage 3"
+    },
+    "ceremony.stage3.copy": {
+      value: "Write a letter to your future Series A self describing the pull you feel today.",
+      description: "Ceremony copy for stage 3"
+    },
+    "ceremony.stage4.title": {
+      value: "Scale Systems",
+      description: "Ceremony title for stage 4"
+    },
+    "ceremony.stage4.copy": {
+      value: "Invite the team to map the journey from first user to repeatable machine.",
+      description: "Ceremony copy for stage 4"
+    },
+    "ceremony.stage5.title": {
+      value: "Platform Threshold",
+      description: "Ceremony title for stage 5"
+    },
+    "ceremony.stage5.copy": {
+      value: "Host a partner circle\u2014invite allies to share what they need from your platform.",
+      description: "Ceremony copy for stage 5"
+    },
+    "ceremony.stage6.title": {
+      value: "Renewal Summit",
+      description: "Ceremony title for stage 6"
+    },
+    "ceremony.stage6.copy": {
+      value: "Pause to honor what got you here, then commit publicly to the next reinvention.",
+      description: "Ceremony copy for stage 6"
+    },
+    "library.stage0.item0": {
+      value: "Summarize interviews and synthesize IC insights.",
+      description: "Library tool description for stage 0 item 0"
+    },
+    "library.stage0.item1": {
+      value: "Craft low-fi storyboards without custom code.",
+      description: "Library tool description for stage 0 item 1"
+    },
+    "library.stage1.item0": {
+      value: "Gate prototype features behind lightweight flags.",
+      description: "Library tool description for stage 1 item 0"
+    },
+    "library.stage1.item1": {
+      value: "Capture questionnaire signals for early scoring.",
+      description: "Library tool description for stage 1 item 1"
+    },
+    "library.stage2.item0": {
+      value: "Instrument activation paths + cohorts.",
+      description: "Library tool description for stage 2 item 0"
+    },
+    "library.stage2.item1": {
+      value: "Collect minimum viable traces and metrics.",
+      description: "Library tool description for stage 2 item 1"
+    },
+    "library.stage3.item0": {
+      value: "Auto-detect contract gaps and spec improvements.",
+      description: "Library tool description for stage 3 item 0"
+    },
+    "library.stage3.item1": {
+      value: "Generate retention-focused guidance at scale.",
+      description: "Library tool description for stage 3 item 1"
+    },
+    "library.stage4.item0": {
+      value: "Experiment orchestration with guardrails.",
+      description: "Library tool description for stage 4 item 0"
+    },
+    "library.stage4.item1": {
+      value: "Stabilize infra and SLOs as teams split.",
+      description: "Library tool description for stage 4 item 1"
+    },
+    "library.stage5.item0": {
+      value: "Automate partner workflows and integrations.",
+      description: "Library tool description for stage 5 item 0"
+    },
+    "library.stage5.item1": {
+      value: "Expose managed partner onboarding via Studio.",
+      description: "Library tool description for stage 5 item 1"
+    },
+    "library.stage6.item0": {
+      value: "Model margin scenarios and reinvestment bets.",
+      description: "Library tool description for stage 6 item 0"
+    },
+    "library.stage6.item1": {
+      value: "Standardize renewal rituals and automation.",
+      description: "Library tool description for stage 6 item 1"
+    },
+    "engine.fallbackAction.title": {
+      value: "Advance {focus}",
+      description: "Fallback action title when no specific action exists",
+      placeholders: [{ name: "focus", type: "string" }]
+    },
+    "engine.fallbackAction.description": {
+      value: 'Identify one task that will improve "{focus}" this week.',
+      description: "Fallback action description when no specific action exists",
+      placeholders: [{ name: "focus", type: "string" }]
+    }
+  }
+});
+
+// src/i18n/catalogs/fr.ts
+import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations";
+var frMessages = defineTranslation2({
+  meta: {
+    key: "lifecycle-advisor.messages",
+    version: "1.0.0",
+    domain: "lifecycle-advisor",
+    description: "Playbook, ceremony, library, and engine strings (French)",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "fr",
+  fallback: "en",
+  messages: {
+    "playbook.stage0.focus.0": {
+      value: "D\xE9couverte",
+      description: "Stage 0 focus area: Discovery"
+    },
+    "playbook.stage0.focus.1": {
+      value: "Clart\xE9 du probl\xE8me",
+      description: "Stage 0 focus area: Problem clarity"
+    },
+    "playbook.stage0.focus.2": {
+      value: "Persona",
+      description: "Stage 0 focus area: Persona"
+    },
+    "playbook.stage1.focus.0": {
+      value: "Prototype",
+      description: "Stage 1 focus area: Prototype"
+    },
+    "playbook.stage1.focus.1": {
+      value: "Retours",
+      description: "Stage 1 focus area: Feedback"
+    },
+    "playbook.stage1.focus.2": {
+      value: "Preuve de valeur",
+      description: "Stage 1 focus area: Value proof"
+    },
+    "playbook.stage2.focus.0": {
+      value: "Activation",
+      description: "Stage 2 focus area: Activation"
+    },
+    "playbook.stage2.focus.1": {
+      value: "T\xE9l\xE9m\xE9trie",
+      description: "Stage 2 focus area: Telemetry"
+    },
+    "playbook.stage2.focus.2": {
+      value: "Retours",
+      description: "Stage 2 focus area: Feedback"
+    },
+    "playbook.stage3.focus.0": {
+      value: "R\xE9tention",
+      description: "Stage 3 focus area: Retention"
+    },
+    "playbook.stage3.focus.1": {
+      value: "Fiabilit\xE9",
+      description: "Stage 3 focus area: Reliability"
+    },
+    "playbook.stage3.focus.2": {
+      value: "R\xE9cit",
+      description: "Stage 3 focus area: Story"
+    },
+    "playbook.stage4.focus.0": {
+      value: "Syst\xE8mes",
+      description: "Stage 4 focus area: Systems"
+    },
+    "playbook.stage4.focus.1": {
+      value: "Boucles de croissance",
+      description: "Stage 4 focus area: Growth loops"
+    },
+    "playbook.stage4.focus.2": {
+      value: "Sp\xE9cialisation",
+      description: "Stage 4 focus area: Specialization"
+    },
+    "playbook.stage5.focus.0": {
+      value: "Partenaires",
+      description: "Stage 5 focus area: Partners"
+    },
+    "playbook.stage5.focus.1": {
+      value: "APIs",
+      description: "Stage 5 focus area: APIs"
+    },
+    "playbook.stage5.focus.2": {
+      value: "Paris d'expansion",
+      description: "Stage 5 focus area: Expansion bets"
+    },
+    "playbook.stage6.focus.0": {
+      value: "Optimisation",
+      description: "Stage 6 focus area: Optimization"
+    },
+    "playbook.stage6.focus.1": {
+      value: "Renouvellement",
+      description: "Stage 6 focus area: Renewal"
+    },
+    "playbook.stage6.focus.2": {
+      value: "Portefeuille",
+      description: "Stage 6 focus area: Portfolio"
+    },
+    "playbook.stage0.action0.title": {
+      value: "Mener un sprint d'entretiens de 5 jours",
+      description: "Stage 0 action 0 title"
+    },
+    "playbook.stage0.action0.description": {
+      value: "Planifier au moins 5 entretiens cons\xE9cutifs et capturer les citations brutes.",
+      description: "Stage 0 action 0 description"
+    },
+    "playbook.stage0.action1.title": {
+      value: "R\xE9diger l'histoire du probl\xE8me",
+      description: "Stage 0 action 1 title"
+    },
+    "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"
+    },
+    "playbook.stage1.action0.title": {
+      value: "Boucle de retours sur le prototype",
+      description: "Stage 1 action 0 title"
+    },
+    "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"
+    },
+    "playbook.stage1.action1.title": {
+      value: "Capturer les signaux de recommandation",
+      description: "Stage 1 action 1 title"
+    },
+    "playbook.stage1.action1.description": {
+      value: "Demander \xE0 chaque testeur qui d'autre devrait voir la d\xE9mo.",
+      description: "Stage 1 action 1 description"
+    },
+    "playbook.stage2.action0.title": {
+      value: "D\xE9finir la checklist d'activation",
+      description: "Stage 2 action 0 title"
+    },
+    "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"
+    },
+    "playbook.stage2.action1.title": {
+      value: "Synchronisation hebdomadaire avec les utilisateurs",
+      description: "Stage 2 action 1 title"
+    },
+    "playbook.stage2.action1.description": {
+      value: "Organiser un appel r\xE9current avec vos 5 testeurs les plus actifs.",
+      description: "Stage 2 action 1 description"
+    },
+    "playbook.stage3.action0.title": {
+      value: "Mener une \xE9tude de r\xE9tention",
+      description: "Stage 3 action 0 title"
+    },
+    "playbook.stage3.action0.description": {
+      value: "Interviewer 3 utilisateurs retenus et publier leurs m\xE9triques avant/apr\xE8s.",
+      description: "Stage 3 action 0 description"
+    },
+    "playbook.stage3.action1.title": {
+      value: "Revue l\xE9g\xE8re d'incidents",
+      description: "Stage 3 action 1 title"
+    },
+    "playbook.stage3.action1.description": {
+      value: "Examiner les 2 derniers incidents de fiabilit\xE9 et capturer les correctifs.",
+      description: "Stage 3 action 1 description"
+    },
+    "playbook.stage4.action0.title": {
+      value: "Codifier une boucle de croissance",
+      description: "Stage 4 action 0 title"
+    },
+    "playbook.stage4.action0.description": {
+      value: "Choisir une boucle (SEO, recommandations, outbound) et documenter les responsables + entr\xE9es.",
+      description: "Stage 4 action 0 description"
+    },
+    "playbook.stage4.action1.title": {
+      value: "Cr\xE9er la carte de recrutement",
+      description: "Stage 4 action 1 title"
+    },
+    "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"
+    },
+    "playbook.stage5.action0.title": {
+      value: "Brief de pr\xE9paration partenaire",
+      description: "Stage 5 action 0 title"
+    },
+    "playbook.stage5.action0.description": {
+      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: "Portefeuille d'exp\xE9riences d'expansion",
+      description: "Stage 5 action 1 title"
+    },
+    "playbook.stage5.action1.description": {
+      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: "Mener une revue co\xFBt-valeur",
+      description: "Stage 6 action 0 title"
+    },
+    "playbook.stage6.action0.description": {
+      value: "Auditer chaque surface majeure pour l\u2019impact sur les marges.",
+      description: "Stage 6 action 0 description"
+    },
+    "playbook.stage6.action1.title": {
+      value: "D\xE9finir le pari de renouvellement",
+      description: "Stage 6 action 1 title"
+    },
+    "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"
+    },
+    "ceremony.stage0.title": {
+      value: "\xC9tincelle de d\xE9couverte",
+      description: "Stage 0 ceremony title"
+    },
+    "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"
+    },
+    "ceremony.stage1.title": {
+      value: "R\xE9sonance de la solution",
+      description: "Stage 1 ceremony title"
+    },
+    "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"
+    },
+    "ceremony.stage2.title": {
+      value: "Toast \xE0 la traction",
+      description: "Stage 2 ceremony title"
+    },
+    "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"
+    },
+    "ceremony.stage3.title": {
+      value: "Signal PMF",
+      description: "Stage 3 ceremony title"
+    },
+    "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"
+    },
+    "ceremony.stage4.title": {
+      value: "Syst\xE8mes d'\xE9chelle",
+      description: "Stage 4 ceremony title"
+    },
+    "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"
+    },
+    "ceremony.stage5.title": {
+      value: "Seuil de la plateforme",
+      description: "Stage 5 ceremony title"
+    },
+    "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"
+    },
+    "ceremony.stage6.title": {
+      value: "Sommet du renouvellement",
+      description: "Stage 6 ceremony title"
+    },
+    "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"
+    },
+    "library.stage0.item0": {
+      value: "R\xE9sumer les entretiens et synth\xE9tiser les insights IC.",
+      description: "Stage 0 library item 0"
+    },
+    "library.stage0.item1": {
+      value: "Cr\xE9er des storyboards basse fid\xE9lit\xE9 sans code personnalis\xE9.",
+      description: "Stage 0 library item 1"
+    },
+    "library.stage1.item0": {
+      value: "Contr\xF4ler les fonctionnalit\xE9s prototype derri\xE8re des flags l\xE9gers.",
+      description: "Stage 1 library item 0"
+    },
+    "library.stage1.item1": {
+      value: "Capturer les signaux de questionnaire pour un scoring pr\xE9coce.",
+      description: "Stage 1 library item 1"
+    },
+    "library.stage2.item0": {
+      value: "Instrumenter les parcours d'activation + cohortes.",
+      description: "Stage 2 library item 0"
+    },
+    "library.stage2.item1": {
+      value: "Collecter les traces et m\xE9triques minimales viables.",
+      description: "Stage 2 library item 1"
+    },
+    "library.stage3.item0": {
+      value: "D\xE9tecter automatiquement les lacunes de contrat et am\xE9liorations de spec.",
+      description: "Stage 3 library 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"
+    },
+    "library.stage4.item0": {
+      value: "Orchestration d'exp\xE9riences avec garde-fous.",
+      description: "Stage 4 library 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"
+    },
+    "library.stage5.item0": {
+      value: "Automatiser les workflows partenaires et int\xE9grations.",
+      description: "Stage 5 library item 0"
+    },
+    "library.stage5.item1": {
+      value: "Exposer l'int\xE9gration partenaire g\xE9r\xE9e via Studio.",
+      description: "Stage 5 library item 1"
+    },
+    "library.stage6.item0": {
+      value: "Mod\xE9liser les sc\xE9narios de marge et paris de r\xE9investissement.",
+      description: "Stage 6 library item 0"
+    },
+    "library.stage6.item1": {
+      value: "Standardiser les rituels de renouvellement et l'automatisation.",
+      description: "Stage 6 library item 1"
+    },
+    "engine.fallbackAction.title": {
+      value: "Avancer sur {focus}",
+      description: "Fallback action title with focus placeholder"
+    },
+    "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"
+    }
+  }
+});
+
+// src/i18n/catalogs/es.ts
+import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations";
+var esMessages = defineTranslation3({
+  meta: {
+    key: "lifecycle-advisor.messages",
+    version: "1.0.0",
+    domain: "lifecycle-advisor",
+    description: "Playbook, ceremony, library, and engine strings (Spanish)",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "es",
+  fallback: "en",
+  messages: {
+    "playbook.stage0.focus.0": {
+      value: "Descubrimiento",
+      description: "Stage 0 focus area: discovery research"
+    },
+    "playbook.stage0.focus.1": {
+      value: "Claridad del problema",
+      description: "Stage 0 focus area: sharpening the problem definition"
+    },
+    "playbook.stage0.focus.2": {
+      value: "Persona",
+      description: "Stage 0 focus area: identifying the target persona"
+    },
+    "playbook.stage1.focus.0": {
+      value: "Prototipo",
+      description: "Stage 1 focus area: building a prototype"
+    },
+    "playbook.stage1.focus.1": {
+      value: "Retroalimentaci\xF3n",
+      description: "Stage 1 focus area: gathering user feedback"
+    },
+    "playbook.stage1.focus.2": {
+      value: "Prueba de valor",
+      description: "Stage 1 focus area: proving the value proposition"
+    },
+    "playbook.stage2.focus.0": {
+      value: "Activaci\xF3n",
+      description: "Stage 2 focus area: user activation"
+    },
+    "playbook.stage2.focus.1": {
+      value: "Telemetr\xEDa",
+      description: "Stage 2 focus area: usage telemetry"
+    },
+    "playbook.stage2.focus.2": {
+      value: "Retroalimentaci\xF3n",
+      description: "Stage 2 focus area: continuous user feedback"
+    },
+    "playbook.stage3.focus.0": {
+      value: "Retenci\xF3n",
+      description: "Stage 3 focus area: user retention"
+    },
+    "playbook.stage3.focus.1": {
+      value: "Fiabilidad",
+      description: "Stage 3 focus area: product reliability"
+    },
+    "playbook.stage3.focus.2": {
+      value: "Historia",
+      description: "Stage 3 focus area: building the narrative"
+    },
+    "playbook.stage4.focus.0": {
+      value: "Sistemas",
+      description: "Stage 4 focus area: scalable systems"
+    },
+    "playbook.stage4.focus.1": {
+      value: "Bucles de crecimiento",
+      description: "Stage 4 focus area: repeatable growth loops"
+    },
+    "playbook.stage4.focus.2": {
+      value: "Especializaci\xF3n",
+      description: "Stage 4 focus area: team specialization"
+    },
+    "playbook.stage5.focus.0": {
+      value: "Socios",
+      description: "Stage 5 focus area: partner ecosystem"
+    },
+    "playbook.stage5.focus.1": {
+      value: "APIs",
+      description: "Stage 5 focus area: platform APIs"
+    },
+    "playbook.stage5.focus.2": {
+      value: "Apuestas de expansi\xF3n",
+      description: "Stage 5 focus area: expansion experiments"
+    },
+    "playbook.stage6.focus.0": {
+      value: "Optimizaci\xF3n",
+      description: "Stage 6 focus area: operational optimization"
+    },
+    "playbook.stage6.focus.1": {
+      value: "Renovaci\xF3n",
+      description: "Stage 6 focus area: product renewal"
+    },
+    "playbook.stage6.focus.2": {
+      value: "Portafolio",
+      description: "Stage 6 focus area: portfolio management"
+    },
+    "playbook.stage0.action0.title": {
+      value: "Realizar un sprint de entrevistas de 5 d\xEDas",
+      description: "Action title for stage 0 interview sprint"
+    },
+    "playbook.stage0.action0.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: "Redactar la historia del problema",
+      description: "Action title for stage 0 problem narrative"
+    },
+    "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"
+    },
+    "playbook.stage1.action0.title": {
+      value: "Ciclo de retroalimentaci\xF3n del prototipo",
+      description: "Action title for stage 1 prototype iteration"
+    },
+    "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"
+    },
+    "playbook.stage1.action1.title": {
+      value: "Capturar se\xF1ales de recomendaci\xF3n",
+      description: "Action title for stage 1 referral tracking"
+    },
+    "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"
+    },
+    "playbook.stage2.action0.title": {
+      value: "Definir lista de verificaci\xF3n de activaci\xF3n",
+      description: "Action title for stage 2 activation definition"
+    },
+    "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"
+    },
+    "playbook.stage2.action1.title": {
+      value: "Sincronizaci\xF3n semanal con usuarios",
+      description: "Action title for stage 2 user communication"
+    },
+    "playbook.stage2.action1.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: "Realizar un estudio de retenci\xF3n",
+      description: "Action title for stage 3 retention analysis"
+    },
+    "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"
+    },
+    "playbook.stage3.action1.title": {
+      value: "Revisi\xF3n ligera de incidentes",
+      description: "Action title for stage 3 reliability review"
+    },
+    "playbook.stage3.action1.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: "Codificar un bucle de crecimiento",
+      description: "Action title for stage 4 growth loop setup"
+    },
+    "playbook.stage4.action0.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: "Crear mapa de contrataci\xF3n",
+      description: "Action title for stage 4 hiring plan"
+    },
+    "playbook.stage4.action1.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 preparaci\xF3n para socios",
+      description: "Action title for stage 5 partner preparation"
+    },
+    "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"
+    },
+    "playbook.stage5.action1.title": {
+      value: "Portafolio de experimentos de expansi\xF3n",
+      description: "Action title for stage 5 expansion planning"
+    },
+    "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"
+    },
+    "playbook.stage6.action0.title": {
+      value: "Realizar una revisi\xF3n costo-valor",
+      description: "Action title for stage 6 margin audit"
+    },
+    "playbook.stage6.action0.description": {
+      value: "Auditar cada superficie principal por impacto en m\xE1rgenes.",
+      description: "Action description for stage 6 margin audit"
+    },
+    "playbook.stage6.action1.title": {
+      value: "Definir la apuesta de renovaci\xF3n",
+      description: "Action title for stage 6 reinvention track"
+    },
+    "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"
+    },
+    "ceremony.stage0.title": {
+      value: "Chispa de descubrimiento",
+      description: "Ceremony title for stage 0"
+    },
+    "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"
+    },
+    "ceremony.stage1.title": {
+      value: "Resonancia de la soluci\xF3n",
+      description: "Ceremony title for stage 1"
+    },
+    "ceremony.stage1.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: "Brindis por la tracci\xF3n",
+      description: "Ceremony title for stage 2"
+    },
+    "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"
+    },
+    "ceremony.stage3.title": {
+      value: "Se\xF1al de fuego PMF",
+      description: "Ceremony title for stage 3"
+    },
+    "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"
+    },
+    "ceremony.stage4.title": {
+      value: "Sistemas de escala",
+      description: "Ceremony title for stage 4"
+    },
+    "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"
+    },
+    "ceremony.stage5.title": {
+      value: "Umbral de la plataforma",
+      description: "Ceremony title for stage 5"
+    },
+    "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"
+    },
+    "ceremony.stage6.title": {
+      value: "Cumbre de renovaci\xF3n",
+      description: "Ceremony title for stage 6"
+    },
+    "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"
+    },
+    "library.stage0.item0": {
+      value: "Resumir entrevistas y sintetizar insights de IC.",
+      description: "Library tool description for stage 0 item 0"
+    },
+    "library.stage0.item1": {
+      value: "Crear storyboards de baja fidelidad sin c\xF3digo personalizado.",
+      description: "Library tool description for stage 0 item 1"
+    },
+    "library.stage1.item0": {
+      value: "Controlar funcionalidades del prototipo detr\xE1s de flags ligeros.",
+      description: "Library tool description for stage 1 item 0"
+    },
+    "library.stage1.item1": {
+      value: "Capturar se\xF1ales de cuestionario para scoring temprano.",
+      description: "Library tool description for stage 1 item 1"
+    },
+    "library.stage2.item0": {
+      value: "Instrumentar rutas de activaci\xF3n + cohortes.",
+      description: "Library tool description for stage 2 item 0"
+    },
+    "library.stage2.item1": {
+      value: "Recopilar trazas y m\xE9tricas m\xEDnimas viables.",
+      description: "Library tool description for stage 2 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"
+    },
+    "library.stage3.item1": {
+      value: "Generar orientaci\xF3n enfocada en retenci\xF3n a escala.",
+      description: "Library tool description for stage 3 item 1"
+    },
+    "library.stage4.item0": {
+      value: "Orquestaci\xF3n de experimentos con barandillas.",
+      description: "Library tool description for stage 4 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"
+    },
+    "library.stage5.item0": {
+      value: "Automatizar flujos de trabajo de socios e integraciones.",
+      description: "Library tool description for stage 5 item 0"
+    },
+    "library.stage5.item1": {
+      value: "Exponer incorporaci\xF3n de socios gestionada v\xEDa Studio.",
+      description: "Library tool description for stage 5 item 1"
+    },
+    "library.stage6.item0": {
+      value: "Modelar escenarios de margen y apuestas de reinversi\xF3n.",
+      description: "Library tool description for stage 6 item 0"
+    },
+    "library.stage6.item1": {
+      value: "Estandarizar rituales de renovaci\xF3n y automatizaci\xF3n.",
+      description: "Library tool description for stage 6 item 1"
+    },
+    "engine.fallbackAction.title": {
+      value: "Avanzar en {focus}",
+      description: "Fallback action title when no specific action exists",
+      placeholders: [{ name: "focus", type: "string" }]
+    },
+    "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" }]
+    }
+  }
+});
+
+// src/i18n/messages.ts
+var factory = createI18nFactory({
+  specKey: "lifecycle-advisor.messages",
+  catalogs: [enMessages, frMessages, esMessages]
+});
+var createLifecycleAdvisorI18n = factory.create;
+var getDefaultI18n = factory.getDefault;
+var resetI18nRegistry = factory.resetRegistry;
+
+// src/data/stage-playbooks.ts
+function getLocalizedStagePlaybooks(locale) {
+  const i18n = createLifecycleAdvisorI18n(locale);
+  return staticPlaybooks.map((playbook, stageIdx) => ({
+    ...playbook,
+    focusAreas: playbook.focusAreas.map((_, focusIdx) => i18n.t(`playbook.stage${stageIdx}.focus.${focusIdx}`)),
+    actions: playbook.actions.map((action, actionIdx) => ({
+      ...action,
+      title: i18n.t(`playbook.stage${stageIdx}.action${actionIdx}.title`),
+      description: i18n.t(`playbook.stage${stageIdx}.action${actionIdx}.description`)
+    })),
+    ceremony: playbook.ceremony ? {
+      ...playbook.ceremony,
+      title: i18n.t(`ceremony.stage${stageIdx}.title`),
+      copy: i18n.t(`ceremony.stage${stageIdx}.copy`)
+    } : undefined
+  }));
+}
+var staticPlaybooks = [
   {
     stage: LifecycleStage.Exploration,
     focusAreas: ["Discovery", "Problem clarity", "Persona"],
@@ -238,6 +1274,7 @@ var stagePlaybooks = [
     }
   }
 ];
+var stagePlaybooks = staticPlaybooks;
 var stage_playbooks_default = stagePlaybooks;
 
 // src/recommendations/recommendation-engine.ts
@@ -255,36 +1292,54 @@ class LifecycleRecommendationEngine {
     this.playbooks = overrides?.length ? new Map(overrides.map((entry) => [entry.stage, entry])) : PLAYBOOK_MAP;
   }
   generate(assessment, options = {}) {
-    const entry = this.playbooks.get(assessment.stage) ?? createFallbackPlaybook(assessment.stage);
-    const limit = options.limit ?? 3;
+    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);
+    const finalActions = actions.length > 0 ? actions : fallbackActions(assessment, limit, locale);
     return {
       assessmentId: assessment.generatedAt,
       stage: assessment.stage,
       actions: finalActions,
-      upcomingMilestones: options.upcomingMilestones ?? [],
+      upcomingMilestones: upcomingMilestones ?? [],
       ceremony: entry.ceremony
     };
   }
 }
-var createFallbackPlaybook = (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: LIFECYCLE_STAGE_META[stage].focusAreas
+  focusAreas: locale ? getLocalizedStagePlaybooks(locale).find((p) => p.stage === stage)?.focusAreas ?? LIFECYCLE_STAGE_META[stage].focusAreas : LIFECYCLE_STAGE_META[stage].focusAreas
 });
-var fallbackActions = (assessment, limit) => (assessment.focusAreas ?? LIFECYCLE_STAGE_META[assessment.stage].focusAreas).slice(0, limit).map((focus, index) => ({
-  id: `fallback-${assessment.stage}-${index}`,
-  stage: assessment.stage,
-  title: `Advance ${focus}`,
-  description: `Identify one task that will improve "${focus}" this week.`,
-  priority: index + 1,
-  estimatedImpact: "low",
-  effortLevel: "s",
-  category: "product"
-}));
+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
-var libraryStageMap = [
+function getLocalizedLibraryStageMap(locale) {
+  const i18n = createLifecycleAdvisorI18n(locale);
+  return staticLibraryStageMap.map((entry, stageIdx) => ({
+    ...entry,
+    items: entry.items.map((item, itemIdx) => ({
+      ...item,
+      description: i18n.t(`library.stage${stageIdx}.item${itemIdx}`)
+    }))
+  }));
+}
+var staticLibraryStageMap = [
   {
     stage: 0,
     items: [
@@ -391,6 +1446,7 @@ var libraryStageMap = [
     ]
   }
 ];
+var libraryStageMap = staticLibraryStageMap;
 var library_stage_map_default = libraryStageMap;
 
 // src/recommendations/library-recommender.ts
@@ -401,7 +1457,12 @@ class ContractSpecLibraryRecommender {
   constructor(overrides) {
     this.mapping = overrides?.length ? new Map(overrides.map((entry) => [entry.stage, entry.items])) : LIBRARY_MAP;
   }
-  recommend(stage, limit = 4) {
+  recommend(stage, limit = 4, locale) {
+    if (locale) {
+      const localized = getLocalizedLibraryStageMap(locale);
+      const entry = localized.find((e) => e.stage === stage);
+      return entry?.items.slice(0, limit) ?? [];
+    }
     const items = this.mapping.get(stage);
     if (!items?.length)
       return [];
@@ -419,11 +1480,18 @@ class LifecycleCeremonyDesigner {
   constructor(overrides) {
     this.ceremonies = overrides?.length ? new Map(overrides.map((entry) => [entry.stage, entry.ceremony])) : CEREMONY_MAP;
   }
-  design(stage) {
+  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);
   }
 }
 export {
+  getLocalizedStagePlaybooks,
+  getLocalizedLibraryStageMap,
   LifecycleRecommendationEngine,
   LifecycleCeremonyDesigner,
   ContractSpecLibraryRecommender