@lssm/lib.lifecycle 0.1.0

package/README.md

@@ -0,0 +1,50 @@
+# @lssm/lib.lifecycle
+
+Canonical lifecycle vocabulary for ContractSpec. This package exposes stage enums, axis types, signal contracts, milestone/action shapes, and formatting helpers used by the lifecycle modules, bundles, and Studio apps.
+
+## Install
+
+```bash
+npm install @lssm/lib.lifecycle
+```
+
+## Usage
+
+```ts
+import {
+  LifecycleStage,
+  LIFECYCLE_STAGE_META,
+  LifecycleAssessment,
+  formatStageSummary,
+} from '@lssm/lib.lifecycle';
+
+const assessment: LifecycleAssessment = {
+  stage: LifecycleStage.MvpEarlyTraction,
+  confidence: 0.72,
+  axes: {
+    product: 'MVP',
+    company: 'TinyTeam',
+    capital: 'Seed',
+  },
+  signals: [],
+  gaps: ['Retention', 'Onboarding'],
+};
+
+const summary = formatStageSummary(assessment.stage, assessment);
+console.log(summary.title); // "Stage 2 · MVP & Early Traction"
+```
+
+## Contents
+
+- `LifecycleStage` enum and metadata map (`LIFECYCLE_STAGE_META`)
+- 3-axis definitions: `ProductPhase`, `CompanyPhase`, `CapitalPhase`
+- Signal + metric contracts (sources, quality, payloads)
+- Milestone + action data shapes
+- Formatting helpers (`formatStageSummary`, `summarizeAxes`, `rankStageCandidates`)
+
+This library intentionally ships no IO logic so it can run in browsers, Node runtimes, and design tools.*** End Patch
+
+
+
+
+

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { LIFECYCLE_STAGE_META, LIFECYCLE_STAGE_ORDER, LifecycleStage, LifecycleStageMetadata, LifecycleStageSlug, getLifecycleStageBySlug } from "./types/stages.js";
+import { CapitalPhase, CompanyPhase, LifecycleAxes, LifecycleAxis, LifecycleAxisSnapshot, ProductPhase } from "./types/axes.js";
+import { LifecycleAssessmentInput, LifecycleMetricSnapshot, LifecycleScore, LifecycleSignal, LifecycleSignalKind, LifecycleSignalSource } from "./types/signals.js";
+import { LifecycleAction, LifecycleAssessment, LifecycleMilestone, LifecycleMilestoneCategory, LifecycleRecommendation } from "./types/milestones.js";
+import { StageSummary, createRecommendationDigest, formatStageSummary, getStageLabel, getStageOrderIndex, rankStageCandidates, summarizeAxes } from "./utils/formatters.js";
+export { CapitalPhase, CompanyPhase, LIFECYCLE_STAGE_META, LIFECYCLE_STAGE_ORDER, LifecycleAction, LifecycleAssessment, LifecycleAssessmentInput, LifecycleAxes, LifecycleAxis, LifecycleAxisSnapshot, LifecycleMetricSnapshot, LifecycleMilestone, LifecycleMilestoneCategory, LifecycleRecommendation, LifecycleScore, LifecycleSignal, LifecycleSignalKind, LifecycleSignalSource, LifecycleStage, LifecycleStageMetadata, LifecycleStageSlug, ProductPhase, StageSummary, createRecommendationDigest, formatStageSummary, getLifecycleStageBySlug, getStageLabel, getStageOrderIndex, rankStageCandidates, summarizeAxes };

package/dist/index.js

@@ -0,0 +1 @@
+import{LIFECYCLE_STAGE_META as e,LIFECYCLE_STAGE_ORDER as t,LifecycleStage as n,getLifecycleStageBySlug as r}from"./types/stages.js";import{CapitalPhase as i,CompanyPhase as a,ProductPhase as o}from"./types/axes.js";import"./types/signals.js";import"./types/milestones.js";import{createRecommendationDigest as s,formatStageSummary as c,getStageLabel as l,getStageOrderIndex as u,rankStageCandidates as d,summarizeAxes as f}from"./utils/formatters.js";export{i as CapitalPhase,a as CompanyPhase,e as LIFECYCLE_STAGE_META,t as LIFECYCLE_STAGE_ORDER,n as LifecycleStage,o as ProductPhase,s as createRecommendationDigest,c as formatStageSummary,r as getLifecycleStageBySlug,l as getStageLabel,u as getStageOrderIndex,d as rankStageCandidates,f as summarizeAxes};

package/dist/types/axes.d.ts

@@ -0,0 +1,37 @@
+//#region src/types/axes.d.ts
+declare enum ProductPhase {
+  Sketch = "Sketch",
+  Prototype = "Prototype",
+  Mvp = "MVP",
+  V1 = "V1",
+  Ecosystem = "Ecosystem",
+}
+declare enum CompanyPhase {
+  Solo = "Solo",
+  TinyTeam = "TinyTeam",
+  FunctionalOrg = "FunctionalOrg",
+  MultiTeam = "MultiTeam",
+  Bureaucratic = "Bureaucratic",
+}
+declare enum CapitalPhase {
+  Bootstrapped = "Bootstrapped",
+  PreSeed = "PreSeed",
+  Seed = "Seed",
+  SeriesAorB = "SeriesAorB",
+  LateStage = "LateStage",
+}
+type LifecycleAxis = 'product' | 'company' | 'capital';
+interface LifecycleAxes {
+  product: ProductPhase;
+  company: CompanyPhase;
+  capital: CapitalPhase;
+}
+interface LifecycleAxisSnapshot {
+  axis: LifecycleAxis;
+  phase: ProductPhase | CompanyPhase | CapitalPhase;
+  rationale?: string;
+  confidence: number;
+}
+//#endregion
+export { CapitalPhase, CompanyPhase, LifecycleAxes, LifecycleAxis, LifecycleAxisSnapshot, ProductPhase };
+//# sourceMappingURL=axes.d.ts.map

package/dist/types/axes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axes.d.ts","names":[],"sources":["../../src/types/axes.ts"],"sourcesContent":[],"mappings":";aAAY,YAAA;EAAA,MAAA,GAAA,QAAY;EAQZ,SAAA,GAAA,WAAY;EAQZ,GAAA,GAAA,KAAA;EAQA,EAAA,GAAA,IAAA;EAEK,SAAA,GAAA,WAAa;;AAEnB,aApBC,YAAA;EAqBD,IAAA,GAAA,MAAA;EAAY,QAAA,GAAA,UAAA;EAGN,aAAA,GAAA,eAAqB;EAC9B,SAAA,GAAA,WAAA;EACC,YAAA,GAAA,cAAA;;AAA8B,aAlB3B,YAAA;EAkBuC,YAAA,GAAA,cAAA;;;;;;KAVvC,aAAA;UAEK,aAAA;WACN;WACA;WACA;;UAGM,qBAAA;QACT;SACC,eAAe,eAAe"}

package/dist/types/axes.js

@@ -0,0 +1,2 @@
+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{n as CapitalPhase,t as CompanyPhase,e as ProductPhase};
+//# sourceMappingURL=axes.js.map

package/dist/types/axes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"axes.js","names":[],"sources":["../../src/types/axes.ts"],"sourcesContent":["export enum ProductPhase {\n  Sketch = 'Sketch',\n  Prototype = 'Prototype',\n  Mvp = 'MVP',\n  V1 = 'V1',\n  Ecosystem = 'Ecosystem',\n}\n\nexport enum CompanyPhase {\n  Solo = 'Solo',\n  TinyTeam = 'TinyTeam',\n  FunctionalOrg = 'FunctionalOrg',\n  MultiTeam = 'MultiTeam',\n  Bureaucratic = 'Bureaucratic',\n}\n\nexport enum CapitalPhase {\n  Bootstrapped = 'Bootstrapped',\n  PreSeed = 'PreSeed',\n  Seed = 'Seed',\n  SeriesAorB = 'SeriesAorB',\n  LateStage = 'LateStage',\n}\n\nexport type LifecycleAxis = 'product' | 'company' | 'capital';\n\nexport interface LifecycleAxes {\n  product: ProductPhase;\n  company: CompanyPhase;\n  capital: CapitalPhase;\n}\n\nexport interface LifecycleAxisSnapshot {\n  axis: LifecycleAxis;\n  phase: ProductPhase | CompanyPhase | CapitalPhase;\n  rationale?: string;\n  confidence: number; // 0-1\n}\n"],"mappings":"AAAA,IAAY,EAAA,SAAA,EAAL,OACL,GAAA,OAAA,SACA,EAAA,UAAA,YACA,EAAA,IAAA,MACA,EAAA,GAAA,KACA,EAAA,UAAA,mBAGU,EAAA,SAAA,EAAL,OACL,GAAA,KAAA,OACA,EAAA,SAAA,WACA,EAAA,cAAA,gBACA,EAAA,UAAA,YACA,EAAA,aAAA,sBAGU,EAAA,SAAA,EAAL,OACL,GAAA,aAAA,eACA,EAAA,QAAA,UACA,EAAA,KAAA,OACA,EAAA,WAAA,aACA,EAAA,UAAA"}

package/dist/types/milestones.d.ts

@@ -0,0 +1,53 @@
+import { LifecycleStage } from "./stages.js";
+import { LifecycleAxes } from "./axes.js";
+import { LifecycleScore, LifecycleSignal } from "./signals.js";
+
+//#region src/types/milestones.d.ts
+type LifecycleMilestoneCategory = 'product' | 'company' | 'capital' | 'operations';
+interface LifecycleMilestone {
+  id: string;
+  stage: LifecycleStage;
+  category: LifecycleMilestoneCategory;
+  title: string;
+  description: string;
+  priority: number;
+  detectionCriteria?: Record<string, unknown>;
+  guideContent?: string;
+  actionItems?: string[];
+}
+interface LifecycleAction {
+  id: string;
+  stage: LifecycleStage;
+  title: string;
+  description: string;
+  priority: number;
+  estimatedImpact: 'low' | 'medium' | 'high';
+  effortLevel: 'xs' | 's' | 'm' | 'l';
+  category: LifecycleMilestoneCategory | 'growth' | 'ops';
+  recommendedLibraries?: string[];
+}
+interface LifecycleAssessment {
+  stage: LifecycleStage;
+  confidence: number;
+  axes: LifecycleAxes;
+  signals: LifecycleSignal[];
+  metrics?: Record<string, number | undefined>;
+  gaps: string[];
+  focusAreas: string[];
+  scorecard: LifecycleScore[];
+  generatedAt: string;
+}
+interface LifecycleRecommendation {
+  assessmentId: string;
+  stage: LifecycleStage;
+  actions: LifecycleAction[];
+  upcomingMilestones: LifecycleMilestone[];
+  ceremony?: {
+    title: string;
+    copy: string;
+    cues: string[];
+  };
+}
+//#endregion
+export { LifecycleAction, LifecycleAssessment, LifecycleMilestone, LifecycleMilestoneCategory, LifecycleRecommendation };
+//# sourceMappingURL=milestones.d.ts.map

package/dist/types/milestones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestones.d.ts","names":[],"sources":["../../src/types/milestones.ts"],"sourcesContent":[],"mappings":";;;;;KAIY,0BAAA;UAMK,kBAAA;EANL,EAAA,EAAA,MAAA;EAMK,KAAA,EAER,cAF0B;EAE1B,QAAA,EACG,0BADH;EACG,KAAA,EAAA,MAAA;EAIU,WAAA,EAAA,MAAA;EAAM,QAAA,EAAA,MAAA;EAKX,iBAAA,CAAe,EALV,MAKU,CAAA,MAEvB,EAAA,OAAA,CAAA;EAUQ,YAAA,CAAA,EAAA,MAAA;EACR,WAAA,CAAA,EAAA,MAAA,EAAA;;AAGE,UAhBM,eAAA,CAgBN;EACC,EAAA,EAAA,MAAA;EAGC,KAAA,EAlBJ,cAkBI;EAAc,KAAA,EAAA,MAAA;EAIV,WAAA,EAAA,MAAA;EAER,QAAA,EAAA,MAAA;EACE,eAAA,EAAA,KAAA,GAAA,QAAA,GAAA,MAAA;EACW,WAAA,EAAA,IAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA;EAAkB,QAAA,EApB5B,0BAoB4B,GAAA,QAAA,GAAA,KAAA;;;UAhBvB,mBAAA;SACR;;QAED;WACG;YACC;;;aAGC;;;UAII,uBAAA;;SAER;WACE;sBACW"}

package/dist/types/milestones.js

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

package/dist/types/signals.d.ts

@@ -0,0 +1,44 @@
+import { LifecycleStage } from "./stages.js";
+import { LifecycleAxes, LifecycleAxis } from "./axes.js";
+
+//#region src/types/signals.d.ts
+type LifecycleSignalSource = 'analytics' | 'questionnaire' | 'intent' | 'manual' | 'simulation';
+type LifecycleSignalKind = 'metric' | 'qualitative' | 'event' | 'milestone' | 'heuristic';
+interface LifecycleSignal {
+  id: string;
+  stageHint?: LifecycleStage;
+  axis?: LifecycleAxis;
+  kind: LifecycleSignalKind;
+  source: LifecycleSignalSource;
+  name: string;
+  value: number | string | boolean;
+  weight: number;
+  confidence: number;
+  details?: Record<string, unknown>;
+  capturedAt: string;
+}
+interface LifecycleMetricSnapshot {
+  activeUsers?: number;
+  weeklyActiveUsers?: number;
+  retentionRate?: number;
+  monthlyRecurringRevenue?: number;
+  customerCount?: number;
+  teamSize?: number;
+  burnMultiple?: number;
+  qualitativeSupport?: string[];
+}
+interface LifecycleScore {
+  stage: LifecycleStage;
+  score: number;
+  confidence: number;
+  supportingSignals: string[];
+}
+interface LifecycleAssessmentInput {
+  axes?: Partial<LifecycleAxes>;
+  metrics?: LifecycleMetricSnapshot;
+  signals?: LifecycleSignal[];
+  questionnaireAnswers?: Record<string, unknown>;
+}
+//#endregion
+export { LifecycleAssessmentInput, LifecycleMetricSnapshot, LifecycleScore, LifecycleSignal, LifecycleSignalKind, LifecycleSignalSource };
+//# sourceMappingURL=signals.d.ts.map

package/dist/types/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","names":[],"sources":["../../src/types/signals.ts"],"sourcesContent":[],"mappings":";;;;KAGY,qBAAA;KAOA,mBAAA;AAPA,UAcK,eAAA,CAdgB;EAOrB,EAAA,EAAA,MAAA;EAOK,SAAA,CAAA,EAEH,cAFkB;EAElB,IAAA,CAAA,EACL,aADK;EACL,IAAA,EACD,mBADC;EACD,MAAA,EACE,qBADF;EACE,IAAA,EAAA,MAAA;EAKE,KAAA,EAAA,MAAA,GAAA,MAAA,GAAA,OAAA;EAAM,MAAA,EAAA,MAAA;EAID,UAAA,EAAA,MAAA;EAWA,OAAA,CAAA,EAfL,MAeK,CAAc,MAAA,EAAA,OACtB,CAAA;EAMQ,UAAA,EAAA,MAAA;;AACR,UAnBQ,uBAAA,CAmBR;EACG,WAAA,CAAA,EAAA,MAAA;EACA,iBAAA,CAAA,EAAA,MAAA;EACa,aAAA,CAAA,EAAA,MAAA;EAAM,uBAAA,CAAA,EAAA,MAAA;;;;;;UAXd,cAAA;SACR;;;;;UAMQ,wBAAA;SACR,QAAQ;YACL;YACA;yBACa"}

package/dist/types/signals.js

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

package/dist/types/stages.d.ts

@@ -0,0 +1,27 @@
+//#region src/types/stages.d.ts
+declare enum LifecycleStage {
+  Exploration = 0,
+  ProblemSolutionFit = 1,
+  MvpEarlyTraction = 2,
+  ProductMarketFit = 3,
+  GrowthScaleUp = 4,
+  ExpansionPlatform = 5,
+  MaturityRenewal = 6,
+}
+type LifecycleStageSlug = 'exploration' | 'problem-solution-fit' | 'mvp-early-traction' | 'product-market-fit' | 'growth-scale-up' | 'expansion-platform' | 'maturity-renewal';
+interface LifecycleStageMetadata {
+  id: LifecycleStage;
+  order: number;
+  slug: LifecycleStageSlug;
+  name: string;
+  question: string;
+  signals: string[];
+  traps: string[];
+  focusAreas: string[];
+}
+declare const LIFECYCLE_STAGE_ORDER: LifecycleStage[];
+declare const LIFECYCLE_STAGE_META: Record<LifecycleStage, LifecycleStageMetadata>;
+declare const getLifecycleStageBySlug: (slug: LifecycleStageSlug) => LifecycleStage;
+//#endregion
+export { LIFECYCLE_STAGE_META, LIFECYCLE_STAGE_ORDER, LifecycleStage, LifecycleStageMetadata, LifecycleStageSlug, getLifecycleStageBySlug };
+//# sourceMappingURL=stages.d.ts.map

package/dist/types/stages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stages.d.ts","names":[],"sources":["../../src/types/stages.ts"],"sourcesContent":[],"mappings":";aAAY,cAAA;EAAA,WAAA,GAAA,CAAA;EAUA,kBAAA,GAAkB,CAAA;EASb,gBAAA,GAAA,CAAA;EAWJ,gBAAA,GAAA,CAAA;EAUA,aAAA,GAAA,CAAA;EACX,iBAAA,GAAA,CAAA;EACA,eAAA,GAAA,CAAA;;AAFuC,KA9B7B,kBAAA,GA8B6B,aAAA,GAAA,sBAAA,GAAA,oBAAA,GAAA,oBAAA,GAAA,iBAAA,GAAA,oBAAA,GAAA,kBAAA;AA2F5B,UAhHI,sBAAA,CA0HhB;MAzHK;;QAEE;;;;;;;cAQK,uBAAuB;cAUvB,sBAAsB,OACjC,gBACA;cAyFW,gCACL,uBACL"}

package/dist/types/stages.js

@@ -0,0 +1,2 @@
+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}({});const t=[e.Exploration,e.ProblemSolutionFit,e.MvpEarlyTraction,e.ProductMarketFit,e.GrowthScaleUp,e.ExpansionPlatform,e.MaturityRenewal],n={[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`]}},r=e=>{let t=Object.values(n).find(t=>t.slug===e);if(!t)throw Error(`Unknown lifecycle stage slug: ${e}`);return t.id};export{n as LIFECYCLE_STAGE_META,t as LIFECYCLE_STAGE_ORDER,e as LifecycleStage,r as getLifecycleStageBySlug};
+//# sourceMappingURL=stages.js.map

package/dist/types/stages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stages.js","names":["LIFECYCLE_STAGE_ORDER: LifecycleStage[]","LIFECYCLE_STAGE_META: Record<\n  LifecycleStage,\n  LifecycleStageMetadata\n>"],"sources":["../../src/types/stages.ts"],"sourcesContent":["export enum LifecycleStage {\n  Exploration = 0,\n  ProblemSolutionFit = 1,\n  MvpEarlyTraction = 2,\n  ProductMarketFit = 3,\n  GrowthScaleUp = 4,\n  ExpansionPlatform = 5,\n  MaturityRenewal = 6,\n}\n\nexport type LifecycleStageSlug =\n  | 'exploration'\n  | 'problem-solution-fit'\n  | 'mvp-early-traction'\n  | 'product-market-fit'\n  | 'growth-scale-up'\n  | 'expansion-platform'\n  | 'maturity-renewal';\n\nexport interface LifecycleStageMetadata {\n  id: LifecycleStage;\n  order: number;\n  slug: LifecycleStageSlug;\n  name: string;\n  question: string;\n  signals: string[];\n  traps: string[];\n  focusAreas: string[];\n}\n\nexport const LIFECYCLE_STAGE_ORDER: LifecycleStage[] = [\n  LifecycleStage.Exploration,\n  LifecycleStage.ProblemSolutionFit,\n  LifecycleStage.MvpEarlyTraction,\n  LifecycleStage.ProductMarketFit,\n  LifecycleStage.GrowthScaleUp,\n  LifecycleStage.ExpansionPlatform,\n  LifecycleStage.MaturityRenewal,\n];\n\nexport const LIFECYCLE_STAGE_META: Record<\n  LifecycleStage,\n  LifecycleStageMetadata\n> = {\n  [LifecycleStage.Exploration]: {\n    id: LifecycleStage.Exploration,\n    order: 0,\n    slug: 'exploration',\n    name: 'Exploration / Ideation',\n    question: 'Is there a problem worth my time?',\n    signals: [\n      '20+ discovery interviews',\n      'Clear problem statement',\n      'Named ICP',\n    ],\n    traps: ['Branding before discovery', 'Premature tooling decisions'],\n    focusAreas: ['Customer discovery', 'Problem definition', 'Segment clarity'],\n  },\n  [LifecycleStage.ProblemSolutionFit]: {\n    id: LifecycleStage.ProblemSolutionFit,\n    order: 1,\n    slug: 'problem-solution-fit',\n    name: 'Problem–Solution Fit',\n    question: 'Do people care enough about this solution?',\n    signals: ['Prototype reuse', 'Referral energy', 'Pre-pay interest'],\n    traps: ['“Market is huge” without users', 'Skipping qualitative loops'],\n    focusAreas: ['Solution hypothesis', 'Value messaging', 'Feedback capture'],\n  },\n  [LifecycleStage.MvpEarlyTraction]: {\n    id: LifecycleStage.MvpEarlyTraction,\n    order: 2,\n    slug: 'mvp-early-traction',\n    name: 'MVP & Early Traction',\n    question: 'Can we get real usage and learn fast?',\n    signals: ['20–50 named active users', 'Weekly releases', 'Noisy feedback'],\n    traps: ['Overbuilt infra for 10 users', 'Undefined retention metric'],\n    focusAreas: ['Activation', 'Cohort tracking', 'Feedback rituals'],\n  },\n  [LifecycleStage.ProductMarketFit]: {\n    id: LifecycleStage.ProductMarketFit,\n    order: 3,\n    slug: 'product-market-fit',\n    name: 'Product–Market Fit',\n    question: 'Is this pulling us forward?',\n    signals: [\n      'Retention without heroics',\n      'Organic word-of-mouth',\n      'Value stories',\n    ],\n    traps: ['Hero growth that does not scale', 'Ignoring churn signals'],\n    focusAreas: ['Retention', 'Reliability', 'ICP clarity'],\n  },\n  [LifecycleStage.GrowthScaleUp]: {\n    id: LifecycleStage.GrowthScaleUp,\n    order: 4,\n    slug: 'growth-scale-up',\n    name: 'Growth / Scale-up',\n    question: 'Can we grow this repeatably?',\n    signals: [\n      'Predictable channels',\n      'Specialized hires',\n      'Unit economics on track',\n    ],\n    traps: [\n      'Paid spend masking retention gaps',\n      'Infra debt blocking launches',\n    ],\n    focusAreas: ['Ops systems', 'Growth loops', 'Reliability engineering'],\n  },\n  [LifecycleStage.ExpansionPlatform]: {\n    id: LifecycleStage.ExpansionPlatform,\n    order: 5,\n    slug: 'expansion-platform',\n    name: 'Expansion / Platform',\n    question: 'What is the next growth curve?',\n    signals: ['Stable core metrics', 'Partner/API demand', 'Ecosystem pull'],\n    traps: ['Platform theater before wedge is solid'],\n    focusAreas: ['Partnerships', 'APIs', 'New market validation'],\n  },\n  [LifecycleStage.MaturityRenewal]: {\n    id: LifecycleStage.MaturityRenewal,\n    order: 6,\n    slug: 'maturity-renewal',\n    name: 'Maturity / Renewal',\n    question: 'Optimize, reinvent, or sunset?',\n    signals: ['Margin focus', 'Portfolio bets', 'Narrative refresh'],\n    traps: ['Assuming past success is enough'],\n    focusAreas: ['Cost optimization', 'Reinvention bets', 'Sunset planning'],\n  },\n};\n\nexport const getLifecycleStageBySlug = (\n  slug: LifecycleStageSlug\n): LifecycleStage => {\n  const entry = Object.values(LIFECYCLE_STAGE_META).find(\n    (meta) => meta.slug === slug\n  );\n  if (!entry) {\n    throw new Error(`Unknown lifecycle stage slug: ${slug}`);\n  }\n  return entry.id;\n};\n"],"mappings":"AAAA,IAAY,EAAA,SAAA,EAAL,OACL,GAAA,EAAA,YAAA,GAAA,cACA,EAAA,EAAA,mBAAA,GAAA,qBACA,EAAA,EAAA,iBAAA,GAAA,mBACA,EAAA,EAAA,iBAAA,GAAA,mBACA,EAAA,EAAA,cAAA,GAAA,gBACA,EAAA,EAAA,kBAAA,GAAA,oBACA,EAAA,EAAA,gBAAA,GAAA,yBAuBF,MAAaA,EAA0C,CACrD,EAAe,YACf,EAAe,mBACf,EAAe,iBACf,EAAe,iBACf,EAAe,cACf,EAAe,kBACf,EAAe,gBAChB,CAEYC,EAGT,EACD,EAAe,aAAc,CAC5B,GAAI,EAAe,YACnB,MAAO,EACP,KAAM,cACN,KAAM,yBACN,SAAU,oCACV,QAAS,CACP,2BACA,0BACA,YACD,CACD,MAAO,CAAC,4BAA6B,8BAA8B,CACnE,WAAY,CAAC,qBAAsB,qBAAsB,kBAAkB,CAC5E,EACA,EAAe,oBAAqB,CACnC,GAAI,EAAe,mBACnB,MAAO,EACP,KAAM,uBACN,KAAM,uBACN,SAAU,6CACV,QAAS,CAAC,kBAAmB,kBAAmB,mBAAmB,CACnE,MAAO,CAAC,iCAAkC,6BAA6B,CACvE,WAAY,CAAC,sBAAuB,kBAAmB,mBAAmB,CAC3E,EACA,EAAe,kBAAmB,CACjC,GAAI,EAAe,iBACnB,MAAO,EACP,KAAM,qBACN,KAAM,uBACN,SAAU,wCACV,QAAS,CAAC,2BAA4B,kBAAmB,iBAAiB,CAC1E,MAAO,CAAC,+BAAgC,6BAA6B,CACrE,WAAY,CAAC,aAAc,kBAAmB,mBAAmB,CAClE,EACA,EAAe,kBAAmB,CACjC,GAAI,EAAe,iBACnB,MAAO,EACP,KAAM,qBACN,KAAM,qBACN,SAAU,8BACV,QAAS,CACP,4BACA,wBACA,gBACD,CACD,MAAO,CAAC,kCAAmC,yBAAyB,CACpE,WAAY,CAAC,YAAa,cAAe,cAAc,CACxD,EACA,EAAe,eAAgB,CAC9B,GAAI,EAAe,cACnB,MAAO,EACP,KAAM,kBACN,KAAM,oBACN,SAAU,+BACV,QAAS,CACP,uBACA,oBACA,0BACD,CACD,MAAO,CACL,oCACA,+BACD,CACD,WAAY,CAAC,cAAe,eAAgB,0BAA0B,CACvE,EACA,EAAe,mBAAoB,CAClC,GAAI,EAAe,kBACnB,MAAO,EACP,KAAM,qBACN,KAAM,uBACN,SAAU,iCACV,QAAS,CAAC,sBAAuB,qBAAsB,iBAAiB,CACxE,MAAO,CAAC,yCAAyC,CACjD,WAAY,CAAC,eAAgB,OAAQ,wBAAwB,CAC9D,EACA,EAAe,iBAAkB,CAChC,GAAI,EAAe,gBACnB,MAAO,EACP,KAAM,mBACN,KAAM,qBACN,SAAU,iCACV,QAAS,CAAC,eAAgB,iBAAkB,oBAAoB,CAChE,MAAO,CAAC,kCAAkC,CAC1C,WAAY,CAAC,oBAAqB,mBAAoB,kBAAkB,CACzE,CACF,CAEY,EACX,GACmB,CACnB,IAAM,EAAQ,OAAO,OAAO,EAAqB,CAAC,KAC/C,GAAS,EAAK,OAAS,EACzB,CACD,GAAI,CAAC,EACH,MAAU,MAAM,iCAAiC,IAAO,CAE1D,OAAO,EAAM"}

package/dist/utils/formatters.d.ts

@@ -0,0 +1,23 @@
+import { LifecycleStage } from "../types/stages.js";
+import { LifecycleAxes } from "../types/axes.js";
+import { LifecycleScore } from "../types/signals.js";
+import { LifecycleAssessment, LifecycleRecommendation } from "../types/milestones.js";
+
+//#region src/utils/formatters.d.ts
+interface StageSummary {
+  title: string;
+  question: string;
+  highlights: string[];
+  traps: string[];
+  focusAreas: string[];
+  axesSummary: string[];
+}
+declare const formatStageSummary: (stage: LifecycleStage, assessment?: Pick<LifecycleAssessment, "axes" | "gaps">) => StageSummary;
+declare const summarizeAxes: (axes: LifecycleAxes) => string[];
+declare const rankStageCandidates: (scores: LifecycleScore[]) => LifecycleScore[];
+declare const createRecommendationDigest: (recommendation: LifecycleRecommendation) => string;
+declare const getStageLabel: (stage: LifecycleStage) => string;
+declare const getStageOrderIndex: (stage: LifecycleStage) => number;
+//#endregion
+export { StageSummary, createRecommendationDigest, formatStageSummary, getStageLabel, getStageOrderIndex, rankStageCandidates, summarizeAxes };
+//# sourceMappingURL=formatters.d.ts.map

package/dist/utils/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","names":[],"sources":["../../src/utils/formatters.ts"],"sourcesContent":[],"mappings":";;;;;;UAYiB,YAAA;;EAAA,QAAA,EAAA,MAAY;EAShB,UAAA,EAAA,MAAA,EAAA;EACJ,KAAA,EAAA,MAAA,EAAA;EACW,UAAA,EAAA,MAAA,EAAA;EAAL,WAAA,EAAA,MAAA,EAAA;;AAcd,cAhBY,kBAgBZ,EAAA,CAAA,KAAA,EAfQ,cAeR,EAAA,UAAA,CAAA,EAdc,IAcd,CAdmB,mBAcnB,EAAA,MAAA,GAAA,MAAA,CAAA,EAAA,GAbE,YAaF;AAEY,cAAA,aAAuB,EAAA,CAAA,IAAA,EAAA,aAAa,EAAA,GAAA,MAAA,EAAA;AAMpC,cAAA,mBACH,EAAA,CAAA,MAAA,EAAA,cACP,EAAA,EAAc,GAAd,cAAc,EAAA;AAQJ,cAAA,0BACK,EAAA,CAAA,cAAA,EAAA,uBAAuB,EAAA,GAAA,MAAA;AAW5B,cAAA,aAAwB,EAAA,CAAA,KAAA,EAAA,cAAc,EAAA,GAAA,MAAA;AAGtC,cAAA,kBAA6B,EAAA,CAAA,KAAA,EAAA,cAAc,EAAA,GAAA,MAAA"}

package/dist/utils/formatters.js

@@ -0,0 +1,2 @@
+import{LIFECYCLE_STAGE_META as e,LIFECYCLE_STAGE_ORDER as t}from"../types/stages.js";const n=(t,n)=>{let i=e[t],a=`Stage ${i.order} · ${i.name}`,o=n?r(n.axes):[];return{title:a,question:i.question,highlights:i.signals,traps:i.traps,focusAreas:n?.gaps?.length?n.gaps:i.focusAreas,axesSummary:o}},r=e=>[`Product: ${e.product}`,`Company: ${e.company}`,`Capital: ${e.capital}`],i=e=>[...e].sort((e,t)=>t.score===e.score?t.confidence-e.confidence:t.score-e.score),a=t=>{let n=e[t.stage],r=t.actions[0],i=r?`${r.title} (${r.estimatedImpact} impact)`:`Focus on upcoming milestones.`;return`Next up for ${n.name}: ${i}`},o=t=>e[t].name,s=e=>t.indexOf(e);export{a as createRecommendationDigest,n as formatStageSummary,o as getStageLabel,s as getStageOrderIndex,i as rankStageCandidates,r as summarizeAxes};
+//# sourceMappingURL=formatters.js.map

package/dist/utils/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","names":[],"sources":["../../src/utils/formatters.ts"],"sourcesContent":["import type {\n  LifecycleAssessment,\n  LifecycleRecommendation,\n} from '../types/milestones';\nimport type { LifecycleAxes } from '../types/axes';\nimport {\n  LIFECYCLE_STAGE_META,\n  LIFECYCLE_STAGE_ORDER,\n  LifecycleStage,\n} from '../types/stages';\nimport type { LifecycleScore } from '../types/signals';\n\nexport interface StageSummary {\n  title: string;\n  question: string;\n  highlights: string[];\n  traps: string[];\n  focusAreas: string[];\n  axesSummary: string[];\n}\n\nexport const formatStageSummary = (\n  stage: LifecycleStage,\n  assessment?: Pick<LifecycleAssessment, 'axes' | 'gaps'>\n): StageSummary => {\n  const meta = LIFECYCLE_STAGE_META[stage];\n  const title = `Stage ${meta.order} · ${meta.name}`;\n  const axesSummary = assessment ? summarizeAxes(assessment.axes) : [];\n\n  return {\n    title,\n    question: meta.question,\n    highlights: meta.signals,\n    traps: meta.traps,\n    focusAreas: assessment?.gaps?.length ? assessment.gaps : meta.focusAreas,\n    axesSummary,\n  };\n};\n\nexport const summarizeAxes = (axes: LifecycleAxes): string[] => [\n  `Product: ${axes.product}`,\n  `Company: ${axes.company}`,\n  `Capital: ${axes.capital}`,\n];\n\nexport const rankStageCandidates = (\n  scores: LifecycleScore[]\n): LifecycleScore[] =>\n  [...scores].sort((a, b) => {\n    if (b.score === a.score) {\n      return b.confidence - a.confidence;\n    }\n    return b.score - a.score;\n  });\n\nexport const createRecommendationDigest = (\n  recommendation: LifecycleRecommendation\n): string => {\n  const meta = LIFECYCLE_STAGE_META[recommendation.stage];\n  const topAction = recommendation.actions[0];\n  const actionCopy = topAction\n    ? `${topAction.title} (${topAction.estimatedImpact} impact)`\n    : 'Focus on upcoming milestones.';\n\n  return `Next up for ${meta.name}: ${actionCopy}`;\n};\n\nexport const getStageLabel = (stage: LifecycleStage): string =>\n  LIFECYCLE_STAGE_META[stage].name;\n\nexport const getStageOrderIndex = (stage: LifecycleStage): number =>\n  LIFECYCLE_STAGE_ORDER.indexOf(stage);\n"],"mappings":"qFAqBA,MAAa,GACX,EACA,IACiB,CACjB,IAAM,EAAO,EAAqB,GAC5B,EAAQ,SAAS,EAAK,MAAM,KAAK,EAAK,OACtC,EAAc,EAAa,EAAc,EAAW,KAAK,CAAG,EAAE,CAEpE,MAAO,CACL,QACA,SAAU,EAAK,SACf,WAAY,EAAK,QACjB,MAAO,EAAK,MACZ,WAAY,GAAY,MAAM,OAAS,EAAW,KAAO,EAAK,WAC9D,cACD,EAGU,EAAiB,GAAkC,CAC9D,YAAY,EAAK,UACjB,YAAY,EAAK,UACjB,YAAY,EAAK,UAClB,CAEY,EACX,GAEA,CAAC,GAAG,EAAO,CAAC,MAAM,EAAG,IACf,EAAE,QAAU,EAAE,MACT,EAAE,WAAa,EAAE,WAEnB,EAAE,MAAQ,EAAE,MACnB,CAES,EACX,GACW,CACX,IAAM,EAAO,EAAqB,EAAe,OAC3C,EAAY,EAAe,QAAQ,GACnC,EAAa,EACf,GAAG,EAAU,MAAM,IAAI,EAAU,gBAAgB,UACjD,gCAEJ,MAAO,eAAe,EAAK,KAAK,IAAI,KAGzB,EAAiB,GAC5B,EAAqB,GAAO,KAEjB,EAAsB,GACjC,EAAsB,QAAQ,EAAM"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@lssm/lib.lifecycle",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "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": "vitest run"
+  },
+  "peerDependencies": {},
+  "devDependencies": {
+    "@lssm/tool.tsdown": "workspace:*",
+    "@lssm/tool.typescript": "workspace:*",
+    "tsdown": "^0.16.6",
+    "typescript": "^5.9.3",
+    "vitest": "^1.6.0"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./*": "./*"
+  }
+}