@contractspec/module.lifecycle-advisor 1.56.1 → 1.58.0

package/dist/__tests__/recommendation-engine.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=recommendation-engine.test.d.ts.map

package/dist/__tests__/recommendation-engine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendation-engine.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/recommendation-engine.test.ts"],"names":[],"mappings":""}

package/dist/browser/index.js

@@ -0,0 +1,429 @@
+// src/recommendations/recommendation-engine.ts
+import {
+  LIFECYCLE_STAGE_META
+} from "@contractspec/lib.lifecycle";
+
+// src/data/stage-playbooks.ts
+import { LifecycleStage } from "@contractspec/lib.lifecycle";
+var stagePlaybooks = [
+  {
+    stage: LifecycleStage.Exploration,
+    focusAreas: ["Discovery", "Problem clarity", "Persona"],
+    actions: [
+      {
+        id: "stage0-interview-burst",
+        stage: LifecycleStage.Exploration,
+        title: "Run a 5-day interview burst",
+        description: "Schedule at least 5 back-to-back interviews and capture raw quotes.",
+        priority: 1,
+        estimatedImpact: "medium",
+        effortLevel: "m",
+        category: "product",
+        recommendedLibraries: ["@contractspec/lib.content-gen"]
+      },
+      {
+        id: "stage0-problem-story",
+        stage: LifecycleStage.Exploration,
+        title: "Write the problem story",
+        description: "Summarize the pain in one paragraph you can repeat to partners.",
+        priority: 2,
+        estimatedImpact: "low",
+        effortLevel: "s",
+        category: "product"
+      }
+    ],
+    ceremony: {
+      title: "Discovery Spark",
+      copy: "Share the sharpest pain quote with your crew. Frame it, celebrate focus.",
+      cues: ["\uD83D\uDD0E", "\uD83D\uDDD2️"]
+    }
+  },
+  {
+    stage: LifecycleStage.ProblemSolutionFit,
+    focusAreas: ["Prototype", "Feedback", "Value proof"],
+    actions: [
+      {
+        id: "stage1-demo-loop",
+        stage: LifecycleStage.ProblemSolutionFit,
+        title: "Prototype feedback loop",
+        description: "Ship a low-fidelity prototype and collect 3 rounds of reactions.",
+        priority: 1,
+        estimatedImpact: "medium",
+        effortLevel: "m",
+        category: "product",
+        recommendedLibraries: ["@contractspec/lib.progressive-delivery"]
+      },
+      {
+        id: "stage1-referrals",
+        stage: LifecycleStage.ProblemSolutionFit,
+        title: "Capture referral signals",
+        description: "Ask each tester who else should see the demo.",
+        priority: 2,
+        estimatedImpact: "low",
+        effortLevel: "s",
+        category: "growth"
+      }
+    ],
+    ceremony: {
+      title: "Solution Resonance",
+      copy: "Record a short screen share telling the before/after story to your future self.",
+      cues: ["\uD83C\uDFA4", "✨"]
+    }
+  },
+  {
+    stage: LifecycleStage.MvpEarlyTraction,
+    focusAreas: ["Activation", "Telemetry", "Feedback"],
+    actions: [
+      {
+        id: "stage2-activation",
+        stage: LifecycleStage.MvpEarlyTraction,
+        title: "Define activation checklist",
+        description: "Document the 3 steps users must finish to get value.",
+        priority: 1,
+        estimatedImpact: "high",
+        effortLevel: "m",
+        category: "operations",
+        recommendedLibraries: [
+          "@contractspec/lib.analytics",
+          "@contractspec/lib.observability"
+        ]
+      },
+      {
+        id: "stage2-weekly-sync",
+        stage: LifecycleStage.MvpEarlyTraction,
+        title: "Weekly user sync",
+        description: "Host a standing call with your 5 most active testers.",
+        priority: 2,
+        estimatedImpact: "medium",
+        effortLevel: "m",
+        category: "company"
+      }
+    ],
+    ceremony: {
+      title: "Traction Toast",
+      copy: "Toast your first 20 real users—say their names, tell them why they matter.",
+      cues: ["\uD83E\uDD42", "\uD83D\uDCE3"]
+    }
+  },
+  {
+    stage: LifecycleStage.ProductMarketFit,
+    focusAreas: ["Retention", "Reliability", "Story"],
+    actions: [
+      {
+        id: "stage3-retention-study",
+        stage: LifecycleStage.ProductMarketFit,
+        title: "Run a retention study",
+        description: "Interview 3 retained users and publish their before/after metrics.",
+        priority: 1,
+        estimatedImpact: "high",
+        effortLevel: "m",
+        category: "product",
+        recommendedLibraries: ["@contractspec/lib.evolution"]
+      },
+      {
+        id: "stage3-incident-review",
+        stage: LifecycleStage.ProductMarketFit,
+        title: "Lightweight incident review",
+        description: "Review the last 2 reliability hiccups and capture fixes.",
+        priority: 2,
+        estimatedImpact: "medium",
+        effortLevel: "s",
+        category: "operations"
+      }
+    ],
+    ceremony: {
+      title: "PMF Signal Fire",
+      copy: "Write a letter to your future Series A self describing the pull you feel today.",
+      cues: ["\uD83D\uDD25", "\uD83D\uDCEC"]
+    }
+  },
+  {
+    stage: LifecycleStage.GrowthScaleUp,
+    focusAreas: ["Systems", "Growth loops", "Specialization"],
+    actions: [
+      {
+        id: "stage4-growth-loop",
+        stage: LifecycleStage.GrowthScaleUp,
+        title: "Codify a growth loop",
+        description: "Choose one loop (SEO, referrals, outbound) and document owners + inputs.",
+        priority: 1,
+        estimatedImpact: "high",
+        effortLevel: "l",
+        category: "growth",
+        recommendedLibraries: [
+          "@contractspec/lib.growth",
+          "@contractspec/lib.resilience"
+        ]
+      },
+      {
+        id: "stage4-hiring-map",
+        stage: LifecycleStage.GrowthScaleUp,
+        title: "Create hiring map",
+        description: "List specialized roles you need in the next 2 quarters.",
+        priority: 2,
+        estimatedImpact: "medium",
+        effortLevel: "m",
+        category: "company"
+      }
+    ],
+    ceremony: {
+      title: "Scale Systems",
+      copy: "Invite the team to map the journey from first user to repeatable machine.",
+      cues: ["\uD83D\uDDFA️", "⚙️"]
+    }
+  },
+  {
+    stage: LifecycleStage.ExpansionPlatform,
+    focusAreas: ["Partners", "APIs", "Expansion bets"],
+    actions: [
+      {
+        id: "stage5-partner-brief",
+        stage: LifecycleStage.ExpansionPlatform,
+        title: "Partner readiness brief",
+        description: "Document partner types, value props, and onboarding steps.",
+        priority: 1,
+        estimatedImpact: "high",
+        effortLevel: "m",
+        category: "product",
+        recommendedLibraries: ["@contractspec/lib.workflow-composer"]
+      },
+      {
+        id: "stage5-experiment-portfolio",
+        stage: LifecycleStage.ExpansionPlatform,
+        title: "Expansion experiment portfolio",
+        description: "List the top 3 markets or product lines with owners.",
+        priority: 2,
+        estimatedImpact: "medium",
+        effortLevel: "m",
+        category: "growth"
+      }
+    ],
+    ceremony: {
+      title: "Platform Threshold",
+      copy: "Host a partner circle—invite allies to share what they need from your platform.",
+      cues: ["\uD83E\uDD1D", "\uD83C\uDF10"]
+    }
+  },
+  {
+    stage: LifecycleStage.MaturityRenewal,
+    focusAreas: ["Optimization", "Renewal", "Portfolio"],
+    actions: [
+      {
+        id: "stage6-cost-review",
+        stage: LifecycleStage.MaturityRenewal,
+        title: "Run a cost-to-value review",
+        description: "Audit each major surface for margin impact.",
+        priority: 1,
+        estimatedImpact: "high",
+        effortLevel: "m",
+        category: "operations",
+        recommendedLibraries: ["@contractspec/lib.cost-tracking"]
+      },
+      {
+        id: "stage6-renewal-bet",
+        stage: LifecycleStage.MaturityRenewal,
+        title: "Define the renewal bet",
+        description: "Choose one reinvention or sunset track and set checkpoints.",
+        priority: 2,
+        estimatedImpact: "medium",
+        effortLevel: "m",
+        category: "product"
+      }
+    ],
+    ceremony: {
+      title: "Renewal Summit",
+      copy: "Pause to honor what got you here, then commit publicly to the next reinvention.",
+      cues: ["\uD83C\uDFD4️", "\uD83D\uDD01"]
+    }
+  }
+];
+var stage_playbooks_default = stagePlaybooks;
+
+// src/recommendations/recommendation-engine.ts
+var PLAYBOOK_MAP = new Map(stage_playbooks_default.map((entry) => [
+  entry.stage,
+  {
+    ...entry,
+    stage: entry.stage
+  }
+]));
+
+class LifecycleRecommendationEngine {
+  playbooks;
+  constructor(overrides) {
+    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 actions = (entry.actions ?? []).slice(0, limit);
+    const finalActions = actions.length > 0 ? actions : fallbackActions(assessment, limit);
+    return {
+      assessmentId: assessment.generatedAt,
+      stage: assessment.stage,
+      actions: finalActions,
+      upcomingMilestones: options.upcomingMilestones ?? [],
+      ceremony: entry.ceremony
+    };
+  }
+}
+var createFallbackPlaybook = (stage) => ({
+  stage,
+  actions: [],
+  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"
+}));
+// src/data/library-stage-map.ts
+var libraryStageMap = [
+  {
+    stage: 0,
+    items: [
+      {
+        id: "@contractspec/lib.content-gen",
+        type: "library",
+        description: "Summarize interviews and synthesize IC insights."
+      },
+      {
+        id: "@contractspec/lib.presentation-runtime",
+        type: "library",
+        description: "Craft low-fi storyboards without custom code."
+      }
+    ]
+  },
+  {
+    stage: 1,
+    items: [
+      {
+        id: "@contractspec/lib.progressive-delivery",
+        type: "library",
+        description: "Gate prototype features behind lightweight flags."
+      },
+      {
+        id: "@contractspec/module.lifecycle-core",
+        type: "module",
+        description: "Capture questionnaire signals for early scoring."
+      }
+    ]
+  },
+  {
+    stage: 2,
+    items: [
+      {
+        id: "@contractspec/lib.analytics",
+        type: "library",
+        description: "Instrument activation paths + cohorts."
+      },
+      {
+        id: "@contractspec/lib.observability",
+        type: "library",
+        description: "Collect minimum viable traces and metrics."
+      }
+    ]
+  },
+  {
+    stage: 3,
+    items: [
+      {
+        id: "@contractspec/lib.evolution",
+        type: "library",
+        description: "Auto-detect contract gaps and spec improvements."
+      },
+      {
+        id: "@contractspec/module.lifecycle-advisor",
+        type: "module",
+        description: "Generate retention-focused guidance at scale."
+      }
+    ]
+  },
+  {
+    stage: 4,
+    items: [
+      {
+        id: "@contractspec/lib.growth",
+        type: "library",
+        description: "Experiment orchestration with guardrails."
+      },
+      {
+        id: "@contractspec/lib.resilience",
+        type: "library",
+        description: "Stabilize infra and SLOs as teams split."
+      }
+    ]
+  },
+  {
+    stage: 5,
+    items: [
+      {
+        id: "@contractspec/lib.workflow-composer",
+        type: "library",
+        description: "Automate partner workflows and integrations."
+      },
+      {
+        id: "@contractspec/bundle.studio",
+        type: "bundle",
+        description: "Expose managed partner onboarding via Studio."
+      }
+    ]
+  },
+  {
+    stage: 6,
+    items: [
+      {
+        id: "@contractspec/lib.cost-tracking",
+        type: "library",
+        description: "Model margin scenarios and reinvestment bets."
+      },
+      {
+        id: "@contractspec/lib.workflow-composer",
+        type: "library",
+        description: "Standardize renewal rituals and automation."
+      }
+    ]
+  }
+];
+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]));
+
+class ContractSpecLibraryRecommender {
+  mapping;
+  constructor(overrides) {
+    this.mapping = overrides?.length ? new Map(overrides.map((entry) => [entry.stage, entry.items])) : LIBRARY_MAP;
+  }
+  recommend(stage, limit = 4) {
+    const items = this.mapping.get(stage);
+    if (!items?.length)
+      return [];
+    return items.slice(0, limit);
+  }
+}
+// src/ceremony/ceremony-designer.ts
+var CEREMONY_MAP = new Map(stage_playbooks_default.map((entry) => [
+  entry.stage,
+  entry.ceremony
+]));
+
+class LifecycleCeremonyDesigner {
+  ceremonies;
+  constructor(overrides) {
+    this.ceremonies = overrides?.length ? new Map(overrides.map((entry) => [entry.stage, entry.ceremony])) : CEREMONY_MAP;
+  }
+  design(stage) {
+    return this.ceremonies.get(stage);
+  }
+}
+export {
+  LifecycleRecommendationEngine,
+  LifecycleCeremonyDesigner,
+  ContractSpecLibraryRecommender
+};

package/dist/ceremony/ceremony-designer.d.ts

@@ -1,16 +1,14 @@
-import { LifecycleRecommendation, LifecycleStage } from "@contractspec/lib.lifecycle";
-
-//#region src/ceremony/ceremony-designer.d.ts
+import type { LifecycleRecommendation } from '@contractspec/lib.lifecycle';
+import { LifecycleStage } from '@contractspec/lib.lifecycle';
 type CeremonyConfig = NonNullable<LifecycleRecommendation['ceremony']>;
 interface PlaybookCeremonyEntry {
-  stage: LifecycleStage;
-  ceremony?: CeremonyConfig;
+    stage: LifecycleStage;
+    ceremony?: CeremonyConfig;
 }
-declare class LifecycleCeremonyDesigner {
-  private readonly ceremonies;
-  constructor(overrides?: PlaybookCeremonyEntry[]);
-  design(stage: LifecycleStage): CeremonyConfig | undefined;
+export declare class LifecycleCeremonyDesigner {
+    private readonly ceremonies;
+    constructor(overrides?: PlaybookCeremonyEntry[]);
+    design(stage: LifecycleStage): CeremonyConfig | undefined;
 }
-//#endregion
-export { LifecycleCeremonyDesigner };
+export {};
 //# sourceMappingURL=ceremony-designer.d.ts.map

package/dist/ceremony/ceremony-designer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ceremony-designer.d.ts","names":[],"sources":["../../src/ceremony/ceremony-designer.ts"],"sourcesContent":[],"mappings":";;;KAIK,cAAA,GAAiB,YAAY;AAH2B,UAKnD,qBAAA,CAFwB;EAExB,KAAA,EACD,cADC;EAYG,QAAA,CAAA,EAVA,cAUA;;AASG,cATH,yBAAA,CASG;EAAiB,iBAAA,UAAA;EAAc,WAAA,CAAA,SAAA,CAAA,EANrB,qBAMqB,EAAA;gBAA/B,iBAAiB"}
+{"version":3,"file":"ceremony-designer.d.ts","sourceRoot":"","sources":["../../src/ceremony/ceremony-designer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D,KAAK,cAAc,GAAG,WAAW,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,CAAC;AAEvE,UAAU,qBAAqB;IAC7B,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AASD,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkD;gBAEjE,SAAS,CAAC,EAAE,qBAAqB,EAAE;IAM/C,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,GAAG,SAAS;CAG1D"}

package/dist/data/library-stage-map.d.ts

@@ -1,11 +1,9 @@
-import { LibraryRecommendation } from "../recommendations/library-recommender.js";
-import { LifecycleStage } from "@contractspec/lib.lifecycle";
-
-//#region src/data/library-stage-map.d.ts
-interface LibraryStageEntry {
-  stage: LifecycleStage;
-  items: LibraryRecommendation[];
+import type { LifecycleStage } from '@contractspec/lib.lifecycle';
+import type { LibraryRecommendation } from '../recommendations/library-recommender';
+export interface LibraryStageEntry {
+    stage: LifecycleStage;
+    items: LibraryRecommendation[];
 }
-//#endregion
-export { LibraryStageEntry };
+declare const libraryStageMap: LibraryStageEntry[];
+export default libraryStageMap;
 //# sourceMappingURL=library-stage-map.d.ts.map

package/dist/data/library-stage-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library-stage-map.d.ts","names":[],"sources":["../../src/data/library-stage-map.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,iBAAA;SACR;EADQ,KAAA,EAER,qBAFyB,EAAA"}
+{"version":3,"file":"library-stage-map.d.ts","sourceRoot":"","sources":["../../src/data/library-stage-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAEpF,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,qBAAqB,EAAE,CAAC;CAChC;AAED,QAAA,MAAM,eAAe,EAAE,iBAAiB,EA0GvC,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/data/stage-playbooks.d.ts

@@ -1,12 +1,11 @@
-import { LifecycleAction, LifecycleRecommendation, LifecycleStage } from "@contractspec/lib.lifecycle";
-
-//#region src/data/stage-playbooks.d.ts
-interface StagePlaybookData {
-  stage: LifecycleStage;
-  focusAreas: string[];
-  actions: LifecycleAction[];
-  ceremony?: LifecycleRecommendation['ceremony'];
+import type { LifecycleAction, LifecycleRecommendation } from '@contractspec/lib.lifecycle';
+import { LifecycleStage } from '@contractspec/lib.lifecycle';
+export interface StagePlaybookData {
+    stage: LifecycleStage;
+    focusAreas: string[];
+    actions: LifecycleAction[];
+    ceremony?: LifecycleRecommendation['ceremony'];
 }
-//#endregion
-export { StagePlaybookData };
+declare const stagePlaybooks: StagePlaybookData[];
+export default stagePlaybooks;
 //# sourceMappingURL=stage-playbooks.d.ts.map

package/dist/data/stage-playbooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stage-playbooks.d.ts","names":[],"sources":["../../src/data/stage-playbooks.ts"],"sourcesContent":[],"mappings":";;;UAMiB,iBAAA;EAAA,KAAA,EACR,cADyB;EACzB,UAAA,EAAA,MAAA,EAAA;EAEE,OAAA,EAAA,eAAA,EAAA;EACE,QAAA,CAAA,EAAA,uBAAA,CAAA,UAAA,CAAA"}
+{"version":3,"file":"stage-playbooks.d.ts","sourceRoot":"","sources":["../../src/data/stage-playbooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,cAAc,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,uBAAuB,CAAC,UAAU,CAAC,CAAC;CAChD;AAED,QAAA,MAAM,cAAc,EAAE,iBAAiB,EA8OtC,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { LifecycleRecommendationEngine, RecommendationOptions } from "./recommendations/recommendation-engine.js";
-import { ContractSpecLibraryRecommender, LibraryRecommendation } from "./recommendations/library-recommender.js";
-import { LifecycleCeremonyDesigner } from "./ceremony/ceremony-designer.js";
-export { ContractSpecLibraryRecommender, LibraryRecommendation, LifecycleCeremonyDesigner, LifecycleRecommendationEngine, RecommendationOptions };
+export * from './recommendations/recommendation-engine';
+export * from './recommendations/library-recommender';
+export * from './ceremony/ceremony-designer';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC"}