@lssm/module.lifecycle-core 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217072406

package/dist/collectors/signal-collector.js

@@ -1 +1,65 @@
-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};
+import { CapitalPhase, CompanyPhase, ProductPhase } from "../libs/lifecycle/dist/types/axes.js";
+import "../libs/lifecycle/dist/index.js";
+
+//#region src/collectors/signal-collector.ts
+const DEFAULT_AXES = {
+	product: ProductPhase.Sketch,
+	company: CompanyPhase.Solo,
+	capital: CapitalPhase.Bootstrapped
+};
+var StageSignalCollector = class {
+	options;
+	constructor(options) {
+		this.options = options;
+	}
+	async collect(input = {}) {
+		const axes = {
+			...DEFAULT_AXES,
+			...input.axes ?? {}
+		};
+		const metricsSnapshots = [];
+		const aggregatedSignals = [...input.signals ?? []];
+		const questionnaireAnswers = { ...input.questionnaireAnswers ?? {} };
+		if (input.metrics) metricsSnapshots.push(input.metrics);
+		if (this.options.analyticsAdapter) {
+			const result = await this.options.analyticsAdapter.fetch();
+			if (result.axes) Object.assign(axes, result.axes);
+			if (result.metrics) metricsSnapshots.push(result.metrics);
+			if (result.signals) aggregatedSignals.push(...result.signals);
+		}
+		if (this.options.questionnaireAdapter) {
+			const result = await this.options.questionnaireAdapter.fetch();
+			if (result.axes) Object.assign(axes, result.axes);
+			if (result.signals) aggregatedSignals.push(...result.signals);
+			Object.assign(questionnaireAnswers, result.answers);
+		}
+		if (this.options.intentAdapter) {
+			const result = await this.options.intentAdapter.fetch();
+			if (result.signals) aggregatedSignals.push(...result.signals);
+		}
+		return {
+			axes,
+			metrics: mergeMetricSnapshots(metricsSnapshots),
+			signals: dedupeSignals(aggregatedSignals),
+			questionnaireAnswers: Object.keys(questionnaireAnswers).length ? questionnaireAnswers : void 0
+		};
+	}
+};
+const mergeMetricSnapshots = (snapshots) => snapshots.reduce((acc, snapshot) => {
+	Object.entries(snapshot ?? {}).forEach(([key, value]) => {
+		if (value !== void 0 && value !== null) acc[key] = value;
+	});
+	return acc;
+}, {});
+const dedupeSignals = (signals) => {
+	const seen = /* @__PURE__ */ new Set();
+	return signals.filter((signal) => {
+		if (!signal.id) return true;
+		if (seen.has(signal.id)) return false;
+		seen.add(signal.id);
+		return true;
+	});
+};
+
+//#endregion
+export { StageSignalCollector };

package/dist/data/milestones-catalog.js

@@ -1 +1,73 @@
-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};
+//#region src/data/milestones-catalog.json
+var milestones_catalog_default = [
+	{
+		"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"]
+	}
+];
+
+//#endregion
+export { milestones_catalog_default as default };

package/dist/data/stage-weights.js

@@ -1 +1,169 @@
-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};
+//#region src/data/stage-weights.json
+var stage_weights_default = {
+	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
+		}
+	}
+};
+
+//#endregion
+export { stage_weights_default as default };

package/dist/index.js

@@ -1 +1,6 @@
-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};
+import { StageSignalCollector } from "./collectors/signal-collector.js";
+import { StageScorer } from "./scoring/stage-scorer.js";
+import { LifecycleMilestonePlanner } from "./planning/milestone-planner.js";
+import { LifecycleOrchestrator } from "./orchestrator/lifecycle-orchestrator.js";
+
+export { LifecycleMilestonePlanner, LifecycleOrchestrator, StageScorer, StageSignalCollector };

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

@@ -1 +1,5 @@
-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";
+import { LIFECYCLE_STAGE_META, LifecycleStage } from "./types/stages.js";
+import { CapitalPhase, CompanyPhase, ProductPhase } from "./types/axes.js";
+import "./types/signals.js";
+import "./types/milestones.js";
+import "./utils/formatters.js";

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

@@ -1 +1,28 @@
-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};
+//#region ../../libs/lifecycle/dist/types/axes.js
+let ProductPhase = /* @__PURE__ */ function(ProductPhase$1) {
+	ProductPhase$1["Sketch"] = "Sketch";
+	ProductPhase$1["Prototype"] = "Prototype";
+	ProductPhase$1["Mvp"] = "MVP";
+	ProductPhase$1["V1"] = "V1";
+	ProductPhase$1["Ecosystem"] = "Ecosystem";
+	return ProductPhase$1;
+}({});
+let CompanyPhase = /* @__PURE__ */ function(CompanyPhase$1) {
+	CompanyPhase$1["Solo"] = "Solo";
+	CompanyPhase$1["TinyTeam"] = "TinyTeam";
+	CompanyPhase$1["FunctionalOrg"] = "FunctionalOrg";
+	CompanyPhase$1["MultiTeam"] = "MultiTeam";
+	CompanyPhase$1["Bureaucratic"] = "Bureaucratic";
+	return CompanyPhase$1;
+}({});
+let CapitalPhase = /* @__PURE__ */ function(CapitalPhase$1) {
+	CapitalPhase$1["Bootstrapped"] = "Bootstrapped";
+	CapitalPhase$1["PreSeed"] = "PreSeed";
+	CapitalPhase$1["Seed"] = "Seed";
+	CapitalPhase$1["SeriesAorB"] = "SeriesAorB";
+	CapitalPhase$1["LateStage"] = "LateStage";
+	return CapitalPhase$1;
+}({});
+
+//#endregion
+export { CapitalPhase, CompanyPhase, ProductPhase };

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

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

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

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

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

@@ -1 +1,151 @@
-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};
+//#region ../../libs/lifecycle/dist/types/stages.js
+let LifecycleStage = /* @__PURE__ */ function(LifecycleStage$1) {
+	LifecycleStage$1[LifecycleStage$1["Exploration"] = 0] = "Exploration";
+	LifecycleStage$1[LifecycleStage$1["ProblemSolutionFit"] = 1] = "ProblemSolutionFit";
+	LifecycleStage$1[LifecycleStage$1["MvpEarlyTraction"] = 2] = "MvpEarlyTraction";
+	LifecycleStage$1[LifecycleStage$1["ProductMarketFit"] = 3] = "ProductMarketFit";
+	LifecycleStage$1[LifecycleStage$1["GrowthScaleUp"] = 4] = "GrowthScaleUp";
+	LifecycleStage$1[LifecycleStage$1["ExpansionPlatform"] = 5] = "ExpansionPlatform";
+	LifecycleStage$1[LifecycleStage$1["MaturityRenewal"] = 6] = "MaturityRenewal";
+	return LifecycleStage$1;
+}({});
+const LIFECYCLE_STAGE_ORDER = [
+	LifecycleStage.Exploration,
+	LifecycleStage.ProblemSolutionFit,
+	LifecycleStage.MvpEarlyTraction,
+	LifecycleStage.ProductMarketFit,
+	LifecycleStage.GrowthScaleUp,
+	LifecycleStage.ExpansionPlatform,
+	LifecycleStage.MaturityRenewal
+];
+const LIFECYCLE_STAGE_META = {
+	[LifecycleStage.Exploration]: {
+		id: LifecycleStage.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"
+		]
+	},
+	[LifecycleStage.ProblemSolutionFit]: {
+		id: LifecycleStage.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"
+		]
+	},
+	[LifecycleStage.MvpEarlyTraction]: {
+		id: LifecycleStage.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"
+		]
+	},
+	[LifecycleStage.ProductMarketFit]: {
+		id: LifecycleStage.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"
+		]
+	},
+	[LifecycleStage.GrowthScaleUp]: {
+		id: LifecycleStage.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"
+		]
+	},
+	[LifecycleStage.ExpansionPlatform]: {
+		id: LifecycleStage.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"
+		]
+	},
+	[LifecycleStage.MaturityRenewal]: {
+		id: LifecycleStage.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"
+		]
+	}
+};
+
+//#endregion
+export { LIFECYCLE_STAGE_META, LifecycleStage };

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

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

package/dist/orchestrator/lifecycle-orchestrator.js

@@ -1 +1,53 @@
-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};
+import { LIFECYCLE_STAGE_META, LifecycleStage } from "../libs/lifecycle/dist/types/stages.js";
+import "../libs/lifecycle/dist/index.js";
+import "../collectors/signal-collector.js";
+import "../scoring/stage-scorer.js";
+
+//#region src/orchestrator/lifecycle-orchestrator.ts
+var LifecycleOrchestrator = class {
+	collector;
+	scorer;
+	planner;
+	constructor(options) {
+		this.collector = options.collector;
+		this.scorer = options.scorer;
+		this.planner = options.milestonePlanner;
+	}
+	async run(input) {
+		const collected = await this.collector.collect(input);
+		const scorecard = this.scorer.score({
+			metrics: collected.metrics,
+			signals: collected.signals
+		});
+		const top = scorecard[0] ?? fallbackScore();
+		const meta = LIFECYCLE_STAGE_META[top.stage];
+		return {
+			stage: top.stage,
+			confidence: top.confidence,
+			axes: collected.axes,
+			signals: collected.signals,
+			metrics: toMetricRecord(collected.metrics),
+			gaps: meta.focusAreas.slice(0, 3),
+			focusAreas: meta.focusAreas,
+			scorecard,
+			generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+		};
+	}
+	getUpcomingMilestones(stage, completedMilestoneIds = [], limit = 5) {
+		if (!this.planner) return [];
+		return this.planner.getUpcoming(stage, completedMilestoneIds, limit);
+	}
+};
+const fallbackScore = () => ({
+	stage: LifecycleStage.Exploration,
+	score: .3,
+	confidence: .3,
+	supportingSignals: []
+});
+const toMetricRecord = (snapshot) => Object.entries(snapshot ?? {}).reduce((acc, [key, value]) => {
+	if (typeof value === "number") acc[key] = value;
+	return acc;
+}, {});
+
+//#endregion
+export { LifecycleOrchestrator };

package/dist/planning/milestone-planner.js

@@ -1 +1,16 @@
-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};
+import milestones_catalog_default from "../data/milestones-catalog.js";
+
+//#region src/planning/milestone-planner.ts
+var LifecycleMilestonePlanner = class {
+	milestones;
+	constructor(customCatalog) {
+		this.milestones = customCatalog ?? milestones_catalog_default;
+	}
+	getUpcoming(stage, completedIds = [], limit = 5) {
+		const completedSet = new Set(completedIds);
+		return this.milestones.filter((milestone) => milestone.stage === stage && !completedSet.has(milestone.id)).sort((a, b) => a.priority - b.priority).slice(0, limit);
+	}
+};
+
+//#endregion
+export { LifecycleMilestonePlanner };

package/dist/scoring/stage-scorer.js

@@ -1 +1,64 @@
-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};
+import { LIFECYCLE_STAGE_META, LifecycleStage } from "../libs/lifecycle/dist/types/stages.js";
+import "../libs/lifecycle/dist/index.js";
+import stage_weights_default from "../data/stage-weights.js";
+
+//#region src/scoring/stage-scorer.ts
+const DEFAULT_WEIGHTS = stage_weights_default;
+var StageScorer = class {
+	weights;
+	constructor(weights = DEFAULT_WEIGHTS) {
+		this.weights = weights;
+	}
+	score(input) {
+		const kindStrength = evaluateSignalKinds(input.signals);
+		return Object.values(LifecycleStage).filter(isStageValue).map((stage) => {
+			const stageName = LifecycleStage[stage];
+			const config = this.weights[stageName] ?? { base: .5 };
+			let score = config.base ?? .5;
+			let contributions = 0;
+			const totalPossible = Object.keys(config.metrics ?? {}).length + Object.keys(config.signalKinds ?? {}).length || 1;
+			const supportingSignals = [];
+			if (config.metrics) Object.entries(config.metrics).forEach(([metricKey, metricConfig]) => {
+				const value = input.metrics[metricKey];
+				if (value === void 0 || value === null) return;
+				if (passesThreshold(value, metricConfig)) {
+					score += metricConfig.weight;
+					contributions += 1;
+					supportingSignals.push(`metric:${metricKey}`);
+				} else score += metricConfig.weight * .25;
+			});
+			if (config.signalKinds) Object.entries(config.signalKinds).forEach(([kind, weight]) => {
+				if ((kindStrength[kind] ?? 0) > 0 && typeof weight === "number") {
+					score += weight;
+					contributions += 1;
+					supportingSignals.push(`signal:${kind}`);
+				}
+			});
+			score = clamp(score, 0, 1.25);
+			const confidence = clamp(contributions / totalPossible, .1, 1);
+			return {
+				stage,
+				score,
+				confidence,
+				supportingSignals
+			};
+		}).sort((a, b) => {
+			if (b.score === a.score) return b.confidence - a.confidence;
+			return b.score - a.score;
+		});
+	}
+};
+const passesThreshold = (value, config) => {
+	if ((config.direction ?? "gte") === "gte") return value >= config.threshold;
+	return value <= config.threshold;
+};
+const clamp = (value, min, max) => Math.min(Math.max(value, min), max);
+const evaluateSignalKinds = (signals) => signals.reduce((acc, signal) => {
+	const key = signal.kind ?? "unknown";
+	acc[key] = (acc[key] ?? 0) + (signal.weight ?? 1);
+	return acc;
+}, {});
+const isStageValue = (value) => typeof value === "number" && value in LIFECYCLE_STAGE_META;
+
+//#endregion
+export { StageScorer };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/module.lifecycle-core",
-  "version": "0.0.0-canary-20251217063201",
+  "version": "0.0.0-canary-20251217072406",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -24,11 +24,11 @@
     "test": "bun run"
   },
   "dependencies": {
-    "@lssm/lib.lifecycle": "0.0.0-canary-20251217063201"
+    "@lssm/lib.lifecycle": "0.0.0-canary-20251217072406"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217063201",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217063201",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217072406",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217072406",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },