@lssm/lib.lifecycle 0.0.0-canary-20251206160926

package/README.md

@@ -0,0 +1,65 @@
+# @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,36 @@
+//#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 };

package/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{n as CapitalPhase,t as CompanyPhase,e as ProductPhase};

package/dist/types/milestones.d.ts

@@ -0,0 +1,52 @@
+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 };

package/dist/types/milestones.js

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

package/dist/types/signals.d.ts

@@ -0,0 +1,43 @@
+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 };

package/dist/types/signals.js

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

package/dist/types/stages.d.ts

@@ -0,0 +1,26 @@
+//#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 };

package/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}({});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};

package/dist/utils/formatters.d.ts

@@ -0,0 +1,22 @@
+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 };

package/dist/utils/formatters.js

@@ -0,0 +1 @@
+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};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@lssm/lib.lifecycle",
+  "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"
+  ],
+  "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"
+  },
+  "peerDependencies": {},
+  "devDependencies": {
+    "@lssm/tool.tsdown": "workspace:*",
+    "@lssm/tool.typescript": "workspace:*",
+    "tsdown": "^0.17.0",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./*": "./*"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}