@lssm/module.lifecycle-core 0.0.0-canary-20251206160926

package/README.md

@@ -0,0 +1,63 @@
+# @lssm/module.lifecycle-core
+
+Signal collection + scoring module for ContractSpec lifecycle assessments. It wraps analytics/questionnaire adapters, applies weighting logic, and produces normalized `LifecycleAssessment` objects.
+
+## Features
+
+- Adapter-driven signal collector (analytics, questionnaires, intent logs)
+- Configurable stage scoring weights
+- Milestone planner backed by JSON catalog
+- Lifecycle orchestrator that returns assessments + scorecards
+
+## Usage
+
+```ts
+import {
+  LifecycleOrchestrator,
+  StageSignalCollector,
+  StageScorer,
+  LifecycleMilestonePlanner,
+} from '@lssm/module.lifecycle-core';
+
+const collector = new StageSignalCollector({
+  analyticsAdapter,
+  questionnaireAdapter,
+});
+
+const scorer = new StageScorer();
+const planner = new LifecycleMilestonePlanner();
+
+const orchestrator = new LifecycleOrchestrator({
+  collector,
+  scorer,
+  planner,
+});
+
+const assessment = await orchestrator.run({
+  questionnaireAnswers: answers,
+});
+
+console.log(assessment.stage, assessment.confidence);
+```
+
+Adapters are interfaces—you can implement them inside bundles, Studio services, or examples without touching this module.*** End Patch
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

package/dist/adapters/analytics-adapter.d.ts

@@ -0,0 +1,13 @@
+import { LifecycleAxes, LifecycleMetricSnapshot, LifecycleSignal } from "@lssm/lib.lifecycle";
+
+//#region src/adapters/analytics-adapter.d.ts
+interface AnalyticsAdapterResult {
+  metrics?: LifecycleMetricSnapshot;
+  signals?: LifecycleSignal[];
+  axes?: Partial<LifecycleAxes>;
+}
+interface AnalyticsAdapter {
+  fetch(): Promise<AnalyticsAdapterResult>;
+}
+//#endregion
+export { AnalyticsAdapter, AnalyticsAdapterResult };

package/dist/adapters/intent-adapter.d.ts

@@ -0,0 +1,11 @@
+import { LifecycleSignal } from "@lssm/lib.lifecycle";
+
+//#region src/adapters/intent-adapter.d.ts
+interface IntentAdapterResult {
+  signals?: LifecycleSignal[];
+}
+interface IntentAdapter {
+  fetch(): Promise<IntentAdapterResult>;
+}
+//#endregion
+export { IntentAdapter, IntentAdapterResult };

package/dist/adapters/questionnaire-adapter.d.ts

@@ -0,0 +1,13 @@
+import { LifecycleAxes, LifecycleSignal } from "@lssm/lib.lifecycle";
+
+//#region src/adapters/questionnaire-adapter.d.ts
+interface QuestionnaireAdapterResult {
+  axes?: Partial<LifecycleAxes>;
+  signals?: LifecycleSignal[];
+  answers?: Record<string, unknown>;
+}
+interface QuestionnaireAdapter {
+  fetch(): Promise<QuestionnaireAdapterResult>;
+}
+//#endregion
+export { QuestionnaireAdapter, QuestionnaireAdapterResult };

package/dist/collectors/signal-collector.d.ts

@@ -0,0 +1,24 @@
+import { AnalyticsAdapter } from "../adapters/analytics-adapter.js";
+import { QuestionnaireAdapter } from "../adapters/questionnaire-adapter.js";
+import { IntentAdapter } from "../adapters/intent-adapter.js";
+import { LifecycleAssessmentInput, LifecycleAxes, LifecycleMetricSnapshot, LifecycleSignal } from "@lssm/lib.lifecycle";
+
+//#region src/collectors/signal-collector.d.ts
+interface StageSignalCollectorOptions {
+  analyticsAdapter?: AnalyticsAdapter;
+  questionnaireAdapter?: QuestionnaireAdapter;
+  intentAdapter?: IntentAdapter;
+}
+interface StageSignalCollectorResult {
+  axes: LifecycleAxes;
+  metrics: LifecycleMetricSnapshot;
+  signals: LifecycleSignal[];
+  questionnaireAnswers?: Record<string, unknown>;
+}
+declare class StageSignalCollector {
+  private readonly options;
+  constructor(options: StageSignalCollectorOptions);
+  collect(input?: LifecycleAssessmentInput): Promise<StageSignalCollectorResult>;
+}
+//#endregion
+export { StageSignalCollector, StageSignalCollectorOptions, StageSignalCollectorResult };

package/dist/collectors/signal-collector.js

@@ -0,0 +1 @@
+import{e,n as t,t as n}from"../libs/lifecycle/dist/types/axes.js";import"../libs/lifecycle/dist/index.js";const r={product:e.Sketch,company:n.Solo,capital:t.Bootstrapped};var i=class{options;constructor(e){this.options=e}async collect(e={}){let t={...r,...e.axes??{}},n=[],i=[...e.signals??[]],s={...e.questionnaireAnswers??{}};if(e.metrics&&n.push(e.metrics),this.options.analyticsAdapter){let e=await this.options.analyticsAdapter.fetch();e.axes&&Object.assign(t,e.axes),e.metrics&&n.push(e.metrics),e.signals&&i.push(...e.signals)}if(this.options.questionnaireAdapter){let e=await this.options.questionnaireAdapter.fetch();e.axes&&Object.assign(t,e.axes),e.signals&&i.push(...e.signals),Object.assign(s,e.answers)}if(this.options.intentAdapter){let e=await this.options.intentAdapter.fetch();e.signals&&i.push(...e.signals)}return{axes:t,metrics:a(n),signals:o(i),questionnaireAnswers:Object.keys(s).length?s:void 0}}};const a=e=>e.reduce((e,t)=>(Object.entries(t??{}).forEach(([t,n])=>{n!=null&&(e[t]=n)}),e),{}),o=e=>{let t=new Set;return e.filter(e=>e.id?t.has(e.id)?!1:(t.add(e.id),!0):!0)};export{i as StageSignalCollector};

package/dist/data/milestones-catalog.js

@@ -0,0 +1 @@
+var e=[{id:`stage0-problem-statement`,stage:0,category:`product`,title:`Write the pain statement`,description:`Capture the clearest description of the top problem in the customer’s own words.`,priority:1,actionItems:[`Interview at least 5 ideal customers`,`Synthesize quotes into a one-page brief`]},{id:`stage1-prototype-loop`,stage:1,category:`product`,title:`Prototype feedback loop`,description:`Ship a clickable prototype and gather 3 rounds of feedback.`,priority:2,actionItems:[`Create a low-fidelity prototype`,`Schedule standing feedback calls`]},{id:`stage2-activation`,stage:2,category:`operations`,title:`Activation checklist`,description:`Define the minimum steps required for a new user to succeed.`,priority:1,actionItems:[`Document onboarding flow`,`Instrument activation analytics`]},{id:`stage3-retention-narrative`,stage:3,category:`product`,title:`Retention narrative`,description:`Create the before/after story that proves why users stay.`,priority:2,actionItems:[`Interview 3 retained users`,`Publish a one-pager with concrete metrics`]},{id:`stage4-growth-loop`,stage:4,category:`growth`,title:`Install a growth loop`,description:`Stand up a repeatable acquisition → activation → referral motion.`,priority:1,actionItems:[`Define loop metrics`,`Assign owners for each stage`,`Review weekly`]},{id:`stage5-platform-blueprint`,stage:5,category:`product`,title:`Platform blueprint`,description:`Align on APIs, integrations, and governance for partners.`,priority:2,actionItems:[`Create integration scoring rubric`,`Publish partner onboarding checklist`]},{id:`stage6-renewal-ops`,stage:6,category:`operations`,title:`Renewal operating rhythm`,description:`Decide whether to optimize, reinvest, or sunset each major surface.`,priority:1,actionItems:[`Hold quarterly renewal review`,`Document reinvestment bets`]}];export{e as default};

package/dist/data/stage-weights.js

@@ -0,0 +1 @@
+var e={Exploration:{base:.35,metrics:{activeUsers:{weight:-.3,direction:`lte`,threshold:5},customerCount:{weight:-.2,direction:`lte`,threshold:3},teamSize:{weight:-.1,direction:`lte`,threshold:3}},signalKinds:{qualitative:.4,metric:.1}},ProblemSolutionFit:{base:.4,metrics:{activeUsers:{weight:.2,direction:`gte`,threshold:5},customerCount:{weight:.2,direction:`gte`,threshold:3}},signalKinds:{qualitative:.3,event:.1}},MvpEarlyTraction:{base:.45,metrics:{activeUsers:{weight:.25,direction:`gte`,threshold:25},weeklyActiveUsers:{weight:.25,direction:`gte`,threshold:20},retentionRate:{weight:.2,direction:`gte`,threshold:.25}},signalKinds:{metric:.15,event:.1}},ProductMarketFit:{base:.5,metrics:{retentionRate:{weight:.35,direction:`gte`,threshold:.45},monthlyRecurringRevenue:{weight:.25,direction:`gte`,threshold:1e4},customerCount:{weight:.2,direction:`gte`,threshold:30}},signalKinds:{metric:.15,event:.1}},GrowthScaleUp:{base:.55,metrics:{retentionRate:{weight:.2,direction:`gte`,threshold:.55},monthlyRecurringRevenue:{weight:.3,direction:`gte`,threshold:5e4},teamSize:{weight:.15,direction:`gte`,threshold:15}},signalKinds:{event:.2,metric:.15}},ExpansionPlatform:{base:.6,metrics:{monthlyRecurringRevenue:{weight:.35,direction:`gte`,threshold:15e4},customerCount:{weight:.2,direction:`gte`,threshold:100},teamSize:{weight:.15,direction:`gte`,threshold:40}},signalKinds:{event:.2,milestone:.1}},MaturityRenewal:{base:.6,metrics:{monthlyRecurringRevenue:{weight:.25,direction:`gte`,threshold:25e4},teamSize:{weight:.15,direction:`gte`,threshold:80},burnMultiple:{weight:.2,direction:`lte`,threshold:1.5}},signalKinds:{event:.2,milestone:.15}}};export{e as default};

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { AnalyticsAdapter, AnalyticsAdapterResult } from "./adapters/analytics-adapter.js";
+import { QuestionnaireAdapter, QuestionnaireAdapterResult } from "./adapters/questionnaire-adapter.js";
+import { IntentAdapter, IntentAdapterResult } from "./adapters/intent-adapter.js";
+import { StageSignalCollector, StageSignalCollectorOptions, StageSignalCollectorResult } from "./collectors/signal-collector.js";
+import { StageScoreInput, StageScorer } from "./scoring/stage-scorer.js";
+import { LifecycleMilestonePlanner } from "./planning/milestone-planner.js";
+import { LifecycleOrchestrator, LifecycleOrchestratorOptions } from "./orchestrator/lifecycle-orchestrator.js";
+export { AnalyticsAdapter, AnalyticsAdapterResult, IntentAdapter, IntentAdapterResult, LifecycleMilestonePlanner, LifecycleOrchestrator, LifecycleOrchestratorOptions, QuestionnaireAdapter, QuestionnaireAdapterResult, StageScoreInput, StageScorer, StageSignalCollector, StageSignalCollectorOptions, StageSignalCollectorResult };

package/dist/index.js

@@ -0,0 +1 @@
+import{StageSignalCollector as e}from"./collectors/signal-collector.js";import{StageScorer as t}from"./scoring/stage-scorer.js";import{LifecycleMilestonePlanner as n}from"./planning/milestone-planner.js";import{LifecycleOrchestrator as r}from"./orchestrator/lifecycle-orchestrator.js";export{n as LifecycleMilestonePlanner,r as LifecycleOrchestrator,t as StageScorer,e as StageSignalCollector};

package/dist/libs/lifecycle/dist/index.js

@@ -0,0 +1 @@
+import{e,n as t}from"./types/stages.js";import{e as n,n as r,t as i}from"./types/axes.js";import"./types/signals.js";import"./types/milestones.js";import"./utils/formatters.js";

package/dist/libs/lifecycle/dist/types/axes.js

@@ -0,0 +1 @@
+let e=function(e){return e.Sketch=`Sketch`,e.Prototype=`Prototype`,e.Mvp=`MVP`,e.V1=`V1`,e.Ecosystem=`Ecosystem`,e}({}),t=function(e){return e.Solo=`Solo`,e.TinyTeam=`TinyTeam`,e.FunctionalOrg=`FunctionalOrg`,e.MultiTeam=`MultiTeam`,e.Bureaucratic=`Bureaucratic`,e}({}),n=function(e){return e.Bootstrapped=`Bootstrapped`,e.PreSeed=`PreSeed`,e.Seed=`Seed`,e.SeriesAorB=`SeriesAorB`,e.LateStage=`LateStage`,e}({});export{e,n,t};

package/dist/libs/lifecycle/dist/types/milestones.js

@@ -0,0 +1 @@
+import"./stages.js";

package/dist/libs/lifecycle/dist/types/signals.js

@@ -0,0 +1 @@
+import"./stages.js";

package/dist/libs/lifecycle/dist/types/stages.js

@@ -0,0 +1 @@
+let e=function(e){return e[e.Exploration=0]=`Exploration`,e[e.ProblemSolutionFit=1]=`ProblemSolutionFit`,e[e.MvpEarlyTraction=2]=`MvpEarlyTraction`,e[e.ProductMarketFit=3]=`ProductMarketFit`,e[e.GrowthScaleUp=4]=`GrowthScaleUp`,e[e.ExpansionPlatform=5]=`ExpansionPlatform`,e[e.MaturityRenewal=6]=`MaturityRenewal`,e}({});e.Exploration,e.ProblemSolutionFit,e.MvpEarlyTraction,e.ProductMarketFit,e.GrowthScaleUp,e.ExpansionPlatform,e.MaturityRenewal;const t={[e.Exploration]:{id:e.Exploration,order:0,slug:`exploration`,name:`Exploration / Ideation`,question:`Is there a problem worth my time?`,signals:[`20+ discovery interviews`,`Clear problem statement`,`Named ICP`],traps:[`Branding before discovery`,`Premature tooling decisions`],focusAreas:[`Customer discovery`,`Problem definition`,`Segment clarity`]},[e.ProblemSolutionFit]:{id:e.ProblemSolutionFit,order:1,slug:`problem-solution-fit`,name:`Problem–Solution Fit`,question:`Do people care enough about this solution?`,signals:[`Prototype reuse`,`Referral energy`,`Pre-pay interest`],traps:[`“Market is huge” without users`,`Skipping qualitative loops`],focusAreas:[`Solution hypothesis`,`Value messaging`,`Feedback capture`]},[e.MvpEarlyTraction]:{id:e.MvpEarlyTraction,order:2,slug:`mvp-early-traction`,name:`MVP & Early Traction`,question:`Can we get real usage and learn fast?`,signals:[`20–50 named active users`,`Weekly releases`,`Noisy feedback`],traps:[`Overbuilt infra for 10 users`,`Undefined retention metric`],focusAreas:[`Activation`,`Cohort tracking`,`Feedback rituals`]},[e.ProductMarketFit]:{id:e.ProductMarketFit,order:3,slug:`product-market-fit`,name:`Product–Market Fit`,question:`Is this pulling us forward?`,signals:[`Retention without heroics`,`Organic word-of-mouth`,`Value stories`],traps:[`Hero growth that does not scale`,`Ignoring churn signals`],focusAreas:[`Retention`,`Reliability`,`ICP clarity`]},[e.GrowthScaleUp]:{id:e.GrowthScaleUp,order:4,slug:`growth-scale-up`,name:`Growth / Scale-up`,question:`Can we grow this repeatably?`,signals:[`Predictable channels`,`Specialized hires`,`Unit economics on track`],traps:[`Paid spend masking retention gaps`,`Infra debt blocking launches`],focusAreas:[`Ops systems`,`Growth loops`,`Reliability engineering`]},[e.ExpansionPlatform]:{id:e.ExpansionPlatform,order:5,slug:`expansion-platform`,name:`Expansion / Platform`,question:`What is the next growth curve?`,signals:[`Stable core metrics`,`Partner/API demand`,`Ecosystem pull`],traps:[`Platform theater before wedge is solid`],focusAreas:[`Partnerships`,`APIs`,`New market validation`]},[e.MaturityRenewal]:{id:e.MaturityRenewal,order:6,slug:`maturity-renewal`,name:`Maturity / Renewal`,question:`Optimize, reinvent, or sunset?`,signals:[`Margin focus`,`Portfolio bets`,`Narrative refresh`],traps:[`Assuming past success is enough`],focusAreas:[`Cost optimization`,`Reinvention bets`,`Sunset planning`]}};export{e,t as n};

package/dist/libs/lifecycle/dist/utils/formatters.js

@@ -0,0 +1 @@
+import"../types/stages.js";

package/dist/orchestrator/lifecycle-orchestrator.d.ts

@@ -0,0 +1,21 @@
+import { StageSignalCollector } from "../collectors/signal-collector.js";
+import { StageScorer } from "../scoring/stage-scorer.js";
+import { LifecycleMilestonePlanner } from "../planning/milestone-planner.js";
+import { LifecycleAssessment, LifecycleAssessmentInput, LifecycleMilestone, LifecycleStage } from "@lssm/lib.lifecycle";
+
+//#region src/orchestrator/lifecycle-orchestrator.d.ts
+interface LifecycleOrchestratorOptions {
+  collector: StageSignalCollector;
+  scorer: StageScorer;
+  milestonePlanner?: LifecycleMilestonePlanner;
+}
+declare class LifecycleOrchestrator {
+  private readonly collector;
+  private readonly scorer;
+  private readonly planner?;
+  constructor(options: LifecycleOrchestratorOptions);
+  run(input?: LifecycleAssessmentInput): Promise<LifecycleAssessment>;
+  getUpcomingMilestones(stage: LifecycleStage, completedMilestoneIds?: string[], limit?: number): LifecycleMilestone[];
+}
+//#endregion
+export { LifecycleOrchestrator, LifecycleOrchestratorOptions };

package/dist/orchestrator/lifecycle-orchestrator.js

@@ -0,0 +1 @@
+import{e,n as t}from"../libs/lifecycle/dist/types/stages.js";import"../libs/lifecycle/dist/index.js";import"../collectors/signal-collector.js";import"../scoring/stage-scorer.js";var n=class{collector;scorer;planner;constructor(e){this.collector=e.collector,this.scorer=e.scorer,this.planner=e.milestonePlanner}async run(e){let n=await this.collector.collect(e),a=this.scorer.score({metrics:n.metrics,signals:n.signals}),o=a[0]??r(),s=t[o.stage];return{stage:o.stage,confidence:o.confidence,axes:n.axes,signals:n.signals,metrics:i(n.metrics),gaps:s.focusAreas.slice(0,3),focusAreas:s.focusAreas,scorecard:a,generatedAt:new Date().toISOString()}}getUpcomingMilestones(e,t=[],n=5){return this.planner?this.planner.getUpcoming(e,t,n):[]}};const r=()=>({stage:e.Exploration,score:.3,confidence:.3,supportingSignals:[]}),i=e=>Object.entries(e??{}).reduce((e,[t,n])=>(typeof n==`number`&&(e[t]=n),e),{});export{n as LifecycleOrchestrator};

package/dist/planning/milestone-planner.d.ts

@@ -0,0 +1,10 @@
+import { LifecycleMilestone, LifecycleStage } from "@lssm/lib.lifecycle";
+
+//#region src/planning/milestone-planner.d.ts
+declare class LifecycleMilestonePlanner {
+  private readonly milestones;
+  constructor(customCatalog?: LifecycleMilestone[]);
+  getUpcoming(stage: LifecycleStage, completedIds?: string[], limit?: number): LifecycleMilestone[];
+}
+//#endregion
+export { LifecycleMilestonePlanner };

package/dist/planning/milestone-planner.js

@@ -0,0 +1 @@
+import e from"../data/milestones-catalog.js";var t=class{milestones;constructor(t){this.milestones=t??e}getUpcoming(e,t=[],n=5){let r=new Set(t);return this.milestones.filter(t=>t.stage===e&&!r.has(t.id)).sort((e,t)=>e.priority-t.priority).slice(0,n)}};export{t as LifecycleMilestonePlanner};

package/dist/scoring/stage-scorer.d.ts

@@ -0,0 +1,26 @@
+import { LifecycleMetricSnapshot, LifecycleScore, LifecycleSignal } from "@lssm/lib.lifecycle";
+
+//#region src/scoring/stage-scorer.d.ts
+type NumericMetricKey = Extract<{ [Key in keyof LifecycleMetricSnapshot]: LifecycleMetricSnapshot[Key] extends number | undefined ? Key : never }[keyof LifecycleMetricSnapshot], string>;
+interface MetricWeightConfig {
+  weight: number;
+  threshold: number;
+  direction?: 'gte' | 'lte';
+}
+interface StageWeightConfig {
+  base: number;
+  metrics?: Partial<Record<NumericMetricKey, MetricWeightConfig>>;
+  signalKinds?: Partial<Record<string, number>>;
+}
+type StageWeights = Record<string, StageWeightConfig>;
+interface StageScoreInput {
+  metrics: LifecycleMetricSnapshot;
+  signals: LifecycleSignal[];
+}
+declare class StageScorer {
+  private readonly weights;
+  constructor(weights?: StageWeights);
+  score(input: StageScoreInput): LifecycleScore[];
+}
+//#endregion
+export { StageScoreInput, StageScorer };

package/dist/scoring/stage-scorer.js

@@ -0,0 +1 @@
+import{e,n as t}from"../libs/lifecycle/dist/types/stages.js";import"../libs/lifecycle/dist/index.js";import n from"../data/stage-weights.js";const r=n;var i=class{weights;constructor(e=r){this.weights=e}score(t){let n=s(t.signals);return Object.values(e).filter(c).map(r=>{let i=e[r],s=this.weights[i]??{base:.5},c=s.base??.5,l=0,u=Object.keys(s.metrics??{}).length+Object.keys(s.signalKinds??{}).length||1,d=[];s.metrics&&Object.entries(s.metrics).forEach(([e,n])=>{let r=t.metrics[e];r!=null&&(a(r,n)?(c+=n.weight,l+=1,d.push(`metric:${e}`)):c+=n.weight*.25)}),s.signalKinds&&Object.entries(s.signalKinds).forEach(([e,t])=>{(n[e]??0)>0&&typeof t==`number`&&(c+=t,l+=1,d.push(`signal:${e}`))}),c=o(c,0,1.25);let f=o(l/u,.1,1);return{stage:r,score:c,confidence:f,supportingSignals:d}}).sort((e,t)=>t.score===e.score?t.confidence-e.confidence:t.score-e.score)}};const a=(e,t)=>(t.direction??`gte`)===`gte`?e>=t.threshold:e<=t.threshold,o=(e,t,n)=>Math.min(Math.max(e,t),n),s=e=>e.reduce((e,t)=>{let n=t.kind??`unknown`;return e[n]=(e[n]??0)+(t.weight??1),e},{}),c=e=>typeof e==`number`&&e in t;export{i as StageScorer};

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@lssm/module.lifecycle-core",
+  "version": "0.0.0-canary-20251206160926",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "src/data"
+  ],
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "build": "bun build:bundle && bun build:types",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun run"
+  },
+  "dependencies": {
+    "@lssm/lib.lifecycle": "workspace:*"
+  },
+  "devDependencies": {
+    "@lssm/tool.tsdown": "workspace:*",
+    "@lssm/tool.typescript": "workspace:*",
+    "tsdown": "^0.17.0",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./*": "./*"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/data/milestones-catalog.json

@@ -0,0 +1,87 @@
+[
+  {
+    "id": "stage0-problem-statement",
+    "stage": 0,
+    "category": "product",
+    "title": "Write the pain statement",
+    "description": "Capture the clearest description of the top problem in the customer’s own words.",
+    "priority": 1,
+    "actionItems": [
+      "Interview at least 5 ideal customers",
+      "Synthesize quotes into a one-page brief"
+    ]
+  },
+  {
+    "id": "stage1-prototype-loop",
+    "stage": 1,
+    "category": "product",
+    "title": "Prototype feedback loop",
+    "description": "Ship a clickable prototype and gather 3 rounds of feedback.",
+    "priority": 2,
+    "actionItems": [
+      "Create a low-fidelity prototype",
+      "Schedule standing feedback calls"
+    ]
+  },
+  {
+    "id": "stage2-activation",
+    "stage": 2,
+    "category": "operations",
+    "title": "Activation checklist",
+    "description": "Define the minimum steps required for a new user to succeed.",
+    "priority": 1,
+    "actionItems": [
+      "Document onboarding flow",
+      "Instrument activation analytics"
+    ]
+  },
+  {
+    "id": "stage3-retention-narrative",
+    "stage": 3,
+    "category": "product",
+    "title": "Retention narrative",
+    "description": "Create the before/after story that proves why users stay.",
+    "priority": 2,
+    "actionItems": [
+      "Interview 3 retained users",
+      "Publish a one-pager with concrete metrics"
+    ]
+  },
+  {
+    "id": "stage4-growth-loop",
+    "stage": 4,
+    "category": "growth",
+    "title": "Install a growth loop",
+    "description": "Stand up a repeatable acquisition → activation → referral motion.",
+    "priority": 1,
+    "actionItems": [
+      "Define loop metrics",
+      "Assign owners for each stage",
+      "Review weekly"
+    ]
+  },
+  {
+    "id": "stage5-platform-blueprint",
+    "stage": 5,
+    "category": "product",
+    "title": "Platform blueprint",
+    "description": "Align on APIs, integrations, and governance for partners.",
+    "priority": 2,
+    "actionItems": [
+      "Create integration scoring rubric",
+      "Publish partner onboarding checklist"
+    ]
+  },
+  {
+    "id": "stage6-renewal-ops",
+    "stage": 6,
+    "category": "operations",
+    "title": "Renewal operating rhythm",
+    "description": "Decide whether to optimize, reinvest, or sunset each major surface.",
+    "priority": 1,
+    "actionItems": [
+      "Hold quarterly renewal review",
+      "Document reinvestment bets"
+    ]
+  }
+]

package/src/data/stage-weights.json

@@ -0,0 +1,109 @@
+{
+  "Exploration": {
+    "base": 0.35,
+    "metrics": {
+      "activeUsers": { "weight": -0.3, "direction": "lte", "threshold": 5 },
+      "customerCount": { "weight": -0.2, "direction": "lte", "threshold": 3 },
+      "teamSize": { "weight": -0.1, "direction": "lte", "threshold": 3 }
+    },
+    "signalKinds": {
+      "qualitative": 0.4,
+      "metric": 0.1
+    }
+  },
+  "ProblemSolutionFit": {
+    "base": 0.4,
+    "metrics": {
+      "activeUsers": { "weight": 0.2, "direction": "gte", "threshold": 5 },
+      "customerCount": { "weight": 0.2, "direction": "gte", "threshold": 3 }
+    },
+    "signalKinds": {
+      "qualitative": 0.3,
+      "event": 0.1
+    }
+  },
+  "MvpEarlyTraction": {
+    "base": 0.45,
+    "metrics": {
+      "activeUsers": { "weight": 0.25, "direction": "gte", "threshold": 25 },
+      "weeklyActiveUsers": {
+        "weight": 0.25,
+        "direction": "gte",
+        "threshold": 20
+      },
+      "retentionRate": { "weight": 0.2, "direction": "gte", "threshold": 0.25 }
+    },
+    "signalKinds": {
+      "metric": 0.15,
+      "event": 0.1
+    }
+  },
+  "ProductMarketFit": {
+    "base": 0.5,
+    "metrics": {
+      "retentionRate": {
+        "weight": 0.35,
+        "direction": "gte",
+        "threshold": 0.45
+      },
+      "monthlyRecurringRevenue": {
+        "weight": 0.25,
+        "direction": "gte",
+        "threshold": 10000
+      },
+      "customerCount": { "weight": 0.2, "direction": "gte", "threshold": 30 }
+    },
+    "signalKinds": {
+      "metric": 0.15,
+      "event": 0.1
+    }
+  },
+  "GrowthScaleUp": {
+    "base": 0.55,
+    "metrics": {
+      "retentionRate": { "weight": 0.2, "direction": "gte", "threshold": 0.55 },
+      "monthlyRecurringRevenue": {
+        "weight": 0.3,
+        "direction": "gte",
+        "threshold": 50000
+      },
+      "teamSize": { "weight": 0.15, "direction": "gte", "threshold": 15 }
+    },
+    "signalKinds": {
+      "event": 0.2,
+      "metric": 0.15
+    }
+  },
+  "ExpansionPlatform": {
+    "base": 0.6,
+    "metrics": {
+      "monthlyRecurringRevenue": {
+        "weight": 0.35,
+        "direction": "gte",
+        "threshold": 150000
+      },
+      "customerCount": { "weight": 0.2, "direction": "gte", "threshold": 100 },
+      "teamSize": { "weight": 0.15, "direction": "gte", "threshold": 40 }
+    },
+    "signalKinds": {
+      "event": 0.2,
+      "milestone": 0.1
+    }
+  },
+  "MaturityRenewal": {
+    "base": 0.6,
+    "metrics": {
+      "monthlyRecurringRevenue": {
+        "weight": 0.25,
+        "direction": "gte",
+        "threshold": 250000
+      },
+      "teamSize": { "weight": 0.15, "direction": "gte", "threshold": 80 },
+      "burnMultiple": { "weight": 0.2, "direction": "lte", "threshold": 1.5 }
+    },
+    "signalKinds": {
+      "event": 0.2,
+      "milestone": 0.15
+    }
+  }
+}