@lssm/module.lifecycle-core 1.42.0 → 1.42.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,8 @@
 # @lssm/module.lifecycle-core
 
+Website: https://contractspec.lssm.tech/
+
+
 Signal collection + scoring module for ContractSpec lifecycle assessments. It wraps analytics/questionnaire adapters, applies weighting logic, and produces normalized `LifecycleAssessment` objects.
 
 ## Features
@@ -52,6 +55,16 @@ Adapters are interfaces—you can implement them inside bundles, Studio services
 
 
 
+
+
+
+
+
+
+
+
+
+
 
 
 

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

@@ -0,0 +1,14 @@
+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 };
+//# sourceMappingURL=analytics-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-adapter.d.ts","names":[],"sources":["../../src/adapters/analytics-adapter.ts"],"sourcesContent":[],"mappings":";;;UAMiB,sBAAA;YACL;EADK,OAAA,CAAA,EAEL,eAF2B,EAAA;EAC3B,IAAA,CAAA,EAEH,OAFG,CAEK,aAFL,CAAA;;AAEK,UAGA,gBAAA,CAHA;EAAR,KAAA,EAAA,EAIE,OAJF,CAIU,sBAJV,CAAA"}

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

@@ -0,0 +1,12 @@
+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 };
+//# sourceMappingURL=intent-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intent-adapter.d.ts","names":[],"sources":["../../src/adapters/intent-adapter.ts"],"sourcesContent":[],"mappings":";;;UAEiB,mBAAA;YACL;AADZ;AAIiB,UAAA,aAAA,CACE;WAAR,QAAQ"}

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

@@ -0,0 +1,14 @@
+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 };
+//# sourceMappingURL=questionnaire-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"questionnaire-adapter.d.ts","names":[],"sources":["../../src/adapters/questionnaire-adapter.ts"],"sourcesContent":[],"mappings":";;;UAEiB,0BAAA;SACR,QAAQ;EADA,OAAA,CAAA,EAEL,eAFK,EAAA;EACA,OAAA,CAAA,EAEL,MAFK,CAAA,MAAA,EAAA,OAAA,CAAA;;AACL,UAIK,oBAAA,CAJL;EACA,KAAA,EAAA,EAID,OAJC,CAIO,0BAJP,CAAA"}

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

@@ -0,0 +1,25 @@
+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 };
+//# sourceMappingURL=signal-collector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signal-collector.d.ts","names":[],"sources":["../../src/collectors/signal-collector.ts"],"sourcesContent":[],"mappings":";;;;;;UAiBiB,2BAAA;qBACI;EADJ,oBAAA,CAAA,EAEQ,oBAFmB;EACvB,aAAA,CAAA,EAEH,aAFG;;AAEH,UAGD,0BAAA,CAHC;EAAa,IAAA,EAIvB,aAJuB;EAGd,OAAA,EAEN,uBAFgC;EACnC,OAAA,EAEG,eAFH,EAAA;EACG,oBAAA,CAAA,EAEc,MAFd,CAAA,MAAA,EAAA,OAAA,CAAA;;AAEc,cAGZ,oBAAA,CAHY;EAAM,iBAAA,OAAA;EAGlB,WAAA,CAAA,OAAA,EAGU,2BAHU;EAGV,OAAA,CAAA,KAAA,CAAA,EAKZ,wBALY,CAAA,EAMlB,OANkB,CAMV,0BANU,CAAA"}

package/dist/collectors/signal-collector.js

@@ -1 +1,65 @@
-import{CapitalPhase as e,CompanyPhase as t,ProductPhase as n}from"@lssm/lib.lifecycle";const r={product:n.Sketch,company:t.Solo,capital:e.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 "@lssm/lib.lifecycle";
+
+//#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 };
+//# sourceMappingURL=signal-collector.js.map

package/dist/collectors/signal-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-collector.js","names":["DEFAULT_AXES: LifecycleAxes","axes: LifecycleAxes","metricsSnapshots: LifecycleMetricSnapshot[]","aggregatedSignals: LifecycleSignal[]","questionnaireAnswers: Record<string, unknown>"],"sources":["../../src/collectors/signal-collector.ts"],"sourcesContent":["import type {\n  LifecycleAssessmentInput,\n  LifecycleAxes,\n  LifecycleMetricSnapshot,\n  LifecycleSignal,\n} from '@lssm/lib.lifecycle';\nimport { CapitalPhase, CompanyPhase, ProductPhase } from '@lssm/lib.lifecycle';\nimport type { AnalyticsAdapter } from '../adapters/analytics-adapter';\nimport type { QuestionnaireAdapter } from '../adapters/questionnaire-adapter';\nimport type { IntentAdapter } from '../adapters/intent-adapter';\n\nconst DEFAULT_AXES: LifecycleAxes = {\n  product: ProductPhase.Sketch,\n  company: CompanyPhase.Solo,\n  capital: CapitalPhase.Bootstrapped,\n};\n\nexport interface StageSignalCollectorOptions {\n  analyticsAdapter?: AnalyticsAdapter;\n  questionnaireAdapter?: QuestionnaireAdapter;\n  intentAdapter?: IntentAdapter;\n}\n\nexport interface StageSignalCollectorResult {\n  axes: LifecycleAxes;\n  metrics: LifecycleMetricSnapshot;\n  signals: LifecycleSignal[];\n  questionnaireAnswers?: Record<string, unknown>;\n}\n\nexport class StageSignalCollector {\n  private readonly options: StageSignalCollectorOptions;\n\n  constructor(options: StageSignalCollectorOptions) {\n    this.options = options;\n  }\n\n  async collect(\n    input: LifecycleAssessmentInput = {}\n  ): Promise<StageSignalCollectorResult> {\n    const axes: LifecycleAxes = {\n      ...DEFAULT_AXES,\n      ...(input.axes ?? {}),\n    };\n    const metricsSnapshots: LifecycleMetricSnapshot[] = [];\n    const aggregatedSignals: LifecycleSignal[] = [...(input.signals ?? [])];\n    const questionnaireAnswers: Record<string, unknown> = {\n      ...(input.questionnaireAnswers ?? {}),\n    };\n\n    if (input.metrics) {\n      metricsSnapshots.push(input.metrics);\n    }\n\n    if (this.options.analyticsAdapter) {\n      const result = await this.options.analyticsAdapter.fetch();\n      if (result.axes) Object.assign(axes, result.axes);\n      if (result.metrics) metricsSnapshots.push(result.metrics);\n      if (result.signals) aggregatedSignals.push(...result.signals);\n    }\n\n    if (this.options.questionnaireAdapter) {\n      const result = await this.options.questionnaireAdapter.fetch();\n      if (result.axes) Object.assign(axes, result.axes);\n      if (result.signals) aggregatedSignals.push(...result.signals);\n      Object.assign(questionnaireAnswers, result.answers);\n    }\n\n    if (this.options.intentAdapter) {\n      const result = await this.options.intentAdapter.fetch();\n      if (result.signals) aggregatedSignals.push(...result.signals);\n    }\n\n    const metrics = mergeMetricSnapshots(metricsSnapshots);\n\n    return {\n      axes,\n      metrics,\n      signals: dedupeSignals(aggregatedSignals),\n      questionnaireAnswers: Object.keys(questionnaireAnswers).length\n        ? questionnaireAnswers\n        : undefined,\n    };\n  }\n}\n\nconst mergeMetricSnapshots = (\n  snapshots: LifecycleMetricSnapshot[]\n): LifecycleMetricSnapshot =>\n  snapshots.reduce<LifecycleMetricSnapshot>((acc, snapshot) => {\n    Object.entries(snapshot ?? {}).forEach(([key, value]) => {\n      if (value !== undefined && value !== null) {\n        acc[key as keyof LifecycleMetricSnapshot] = value as never;\n      }\n    });\n    return acc;\n  }, {});\n\nconst dedupeSignals = (signals: LifecycleSignal[]): LifecycleSignal[] => {\n  const seen = new Set<string>();\n  return signals.filter((signal) => {\n    if (!signal.id) return true;\n    if (seen.has(signal.id)) return false;\n    seen.add(signal.id);\n    return true;\n  });\n};\n"],"mappings":";;;AAWA,MAAMA,eAA8B;CAClC,SAAS,aAAa;CACtB,SAAS,aAAa;CACtB,SAAS,aAAa;CACvB;AAeD,IAAa,uBAAb,MAAkC;CAChC,AAAiB;CAEjB,YAAY,SAAsC;AAChD,OAAK,UAAU;;CAGjB,MAAM,QACJ,QAAkC,EAAE,EACC;EACrC,MAAMC,OAAsB;GAC1B,GAAG;GACH,GAAI,MAAM,QAAQ,EAAE;GACrB;EACD,MAAMC,mBAA8C,EAAE;EACtD,MAAMC,oBAAuC,CAAC,GAAI,MAAM,WAAW,EAAE,CAAE;EACvE,MAAMC,uBAAgD,EACpD,GAAI,MAAM,wBAAwB,EAAE,EACrC;AAED,MAAI,MAAM,QACR,kBAAiB,KAAK,MAAM,QAAQ;AAGtC,MAAI,KAAK,QAAQ,kBAAkB;GACjC,MAAM,SAAS,MAAM,KAAK,QAAQ,iBAAiB,OAAO;AAC1D,OAAI,OAAO,KAAM,QAAO,OAAO,MAAM,OAAO,KAAK;AACjD,OAAI,OAAO,QAAS,kBAAiB,KAAK,OAAO,QAAQ;AACzD,OAAI,OAAO,QAAS,mBAAkB,KAAK,GAAG,OAAO,QAAQ;;AAG/D,MAAI,KAAK,QAAQ,sBAAsB;GACrC,MAAM,SAAS,MAAM,KAAK,QAAQ,qBAAqB,OAAO;AAC9D,OAAI,OAAO,KAAM,QAAO,OAAO,MAAM,OAAO,KAAK;AACjD,OAAI,OAAO,QAAS,mBAAkB,KAAK,GAAG,OAAO,QAAQ;AAC7D,UAAO,OAAO,sBAAsB,OAAO,QAAQ;;AAGrD,MAAI,KAAK,QAAQ,eAAe;GAC9B,MAAM,SAAS,MAAM,KAAK,QAAQ,cAAc,OAAO;AACvD,OAAI,OAAO,QAAS,mBAAkB,KAAK,GAAG,OAAO,QAAQ;;AAK/D,SAAO;GACL;GACA,SAJc,qBAAqB,iBAAiB;GAKpD,SAAS,cAAc,kBAAkB;GACzC,sBAAsB,OAAO,KAAK,qBAAqB,CAAC,SACpD,uBACA;GACL;;;AAIL,MAAM,wBACJ,cAEA,UAAU,QAAiC,KAAK,aAAa;AAC3D,QAAO,QAAQ,YAAY,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,WAAW;AACvD,MAAI,UAAU,UAAa,UAAU,KACnC,KAAI,OAAwC;GAE9C;AACF,QAAO;GACN,EAAE,CAAC;AAER,MAAM,iBAAiB,YAAkD;CACvE,MAAM,uBAAO,IAAI,KAAa;AAC9B,QAAO,QAAQ,QAAQ,WAAW;AAChC,MAAI,CAAC,OAAO,GAAI,QAAO;AACvB,MAAI,KAAK,IAAI,OAAO,GAAG,CAAE,QAAO;AAChC,OAAK,IAAI,OAAO,GAAG;AACnB,SAAO;GACP"}

package/dist/data/milestones-catalog.js

@@ -1 +1,74 @@
-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 };
+//# sourceMappingURL=milestones-catalog.js.map

package/dist/data/milestones-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestones-catalog.js","names":[],"sources":["../../src/data/milestones-catalog.json"],"sourcesContent":[""],"mappings":""}

package/dist/data/stage-weights.js

@@ -1 +1,170 @@
-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 };
+//# sourceMappingURL=stage-weights.js.map

package/dist/data/stage-weights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-weights.js","names":[],"sources":["../../src/data/stage-weights.json"],"sourcesContent":[""],"mappings":""}

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

@@ -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/orchestrator/lifecycle-orchestrator.d.ts

@@ -0,0 +1,22 @@
+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 };
+//# sourceMappingURL=lifecycle-orchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-orchestrator.d.ts","names":[],"sources":["../../src/orchestrator/lifecycle-orchestrator.ts"],"sourcesContent":[],"mappings":";;;;;;UAWiB,4BAAA;EAAA,SAAA,EACJ,oBADgC;EAChC,MAAA,EACH,WADG;EACH,gBAAA,CAAA,EACW,yBADX;;AACoC,cAGjC,qBAAA,CAHiC;EAGjC,iBAAA,SAAqB;EAKX,iBAAA,MAAA;EAMH,iBAAA,OAAA;EAAmC,WAAA,CAAA,OAAA,EANhC,4BAMgC;EAAR,GAAA,CAAA,KAAA,CAAA,EAA3B,wBAA2B,CAAA,EAAA,OAAA,CAAQ,mBAAR,CAAA;EAuBpC,qBAAA,CAAA,KAAA,EAAA,cAAA,EAAA,qBAAA,CAAA,EAAA,MAAA,EAAA,EAAA,KAAA,CAAA,EAAA,MAAA,CAAA,EAGN,kBAHM,EAAA"}

package/dist/orchestrator/lifecycle-orchestrator.js

@@ -1 +1,53 @@
-import"../collectors/signal-collector.js";import"../scoring/stage-scorer.js";import{LIFECYCLE_STAGE_META as e,LifecycleStage as t}from"@lssm/lib.lifecycle";var n=class{collector;scorer;planner;constructor(e){this.collector=e.collector,this.scorer=e.scorer,this.planner=e.milestonePlanner}async run(t){let n=await this.collector.collect(t),a=this.scorer.score({metrics:n.metrics,signals:n.signals}),o=a[0]??r(),s=e[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:t.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 "../collectors/signal-collector.js";
+import "../scoring/stage-scorer.js";
+import { LIFECYCLE_STAGE_META, LifecycleStage } from "@lssm/lib.lifecycle";
+
+//#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 };
+//# sourceMappingURL=lifecycle-orchestrator.js.map

package/dist/orchestrator/lifecycle-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-orchestrator.js","names":[],"sources":["../../src/orchestrator/lifecycle-orchestrator.ts"],"sourcesContent":["import type {\n  LifecycleAssessment,\n  LifecycleAssessmentInput,\n  LifecycleMilestone,\n  LifecycleMetricSnapshot,\n} from '@lssm/lib.lifecycle';\nimport { LIFECYCLE_STAGE_META, LifecycleStage } from '@lssm/lib.lifecycle';\nimport { StageSignalCollector } from '../collectors/signal-collector';\nimport { StageScorer } from '../scoring/stage-scorer';\nimport { LifecycleMilestonePlanner } from '../planning/milestone-planner';\n\nexport interface LifecycleOrchestratorOptions {\n  collector: StageSignalCollector;\n  scorer: StageScorer;\n  milestonePlanner?: LifecycleMilestonePlanner;\n}\n\nexport class LifecycleOrchestrator {\n  private readonly collector: StageSignalCollector;\n  private readonly scorer: StageScorer;\n  private readonly planner?: LifecycleMilestonePlanner;\n\n  constructor(options: LifecycleOrchestratorOptions) {\n    this.collector = options.collector;\n    this.scorer = options.scorer;\n    this.planner = options.milestonePlanner;\n  }\n\n  async run(input?: LifecycleAssessmentInput): Promise<LifecycleAssessment> {\n    const collected = await this.collector.collect(input);\n    const scorecard = this.scorer.score({\n      metrics: collected.metrics,\n      signals: collected.signals,\n    });\n    const top = scorecard[0] ?? fallbackScore();\n    const meta = LIFECYCLE_STAGE_META[top.stage];\n\n    return {\n      stage: top.stage,\n      confidence: top.confidence,\n      axes: collected.axes,\n      signals: collected.signals,\n      metrics: toMetricRecord(collected.metrics),\n      gaps: meta.focusAreas.slice(0, 3),\n      focusAreas: meta.focusAreas,\n      scorecard,\n      generatedAt: new Date().toISOString(),\n    };\n  }\n\n  getUpcomingMilestones(\n    stage: LifecycleStage,\n    completedMilestoneIds: string[] = [],\n    limit = 5\n  ): LifecycleMilestone[] {\n    if (!this.planner) return [];\n    return this.planner.getUpcoming(stage, completedMilestoneIds, limit);\n  }\n}\n\nconst fallbackScore = () => ({\n  stage: LifecycleStage.Exploration,\n  score: 0.3,\n  confidence: 0.3,\n  supportingSignals: [],\n});\n\nconst toMetricRecord = (\n  snapshot: LifecycleMetricSnapshot\n): Record<string, number | undefined> =>\n  Object.entries(snapshot ?? {}).reduce<Record<string, number | undefined>>(\n    (acc, [key, value]) => {\n      if (typeof value === 'number') {\n        acc[key] = value;\n      }\n      return acc;\n    },\n    {}\n  );\n"],"mappings":";;;;;AAiBA,IAAa,wBAAb,MAAmC;CACjC,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,SAAuC;AACjD,OAAK,YAAY,QAAQ;AACzB,OAAK,SAAS,QAAQ;AACtB,OAAK,UAAU,QAAQ;;CAGzB,MAAM,IAAI,OAAgE;EACxE,MAAM,YAAY,MAAM,KAAK,UAAU,QAAQ,MAAM;EACrD,MAAM,YAAY,KAAK,OAAO,MAAM;GAClC,SAAS,UAAU;GACnB,SAAS,UAAU;GACpB,CAAC;EACF,MAAM,MAAM,UAAU,MAAM,eAAe;EAC3C,MAAM,OAAO,qBAAqB,IAAI;AAEtC,SAAO;GACL,OAAO,IAAI;GACX,YAAY,IAAI;GAChB,MAAM,UAAU;GAChB,SAAS,UAAU;GACnB,SAAS,eAAe,UAAU,QAAQ;GAC1C,MAAM,KAAK,WAAW,MAAM,GAAG,EAAE;GACjC,YAAY,KAAK;GACjB;GACA,8BAAa,IAAI,MAAM,EAAC,aAAa;GACtC;;CAGH,sBACE,OACA,wBAAkC,EAAE,EACpC,QAAQ,GACc;AACtB,MAAI,CAAC,KAAK,QAAS,QAAO,EAAE;AAC5B,SAAO,KAAK,QAAQ,YAAY,OAAO,uBAAuB,MAAM;;;AAIxE,MAAM,uBAAuB;CAC3B,OAAO,eAAe;CACtB,OAAO;CACP,YAAY;CACZ,mBAAmB,EAAE;CACtB;AAED,MAAM,kBACJ,aAEA,OAAO,QAAQ,YAAY,EAAE,CAAC,CAAC,QAC5B,KAAK,CAAC,KAAK,WAAW;AACrB,KAAI,OAAO,UAAU,SACnB,KAAI,OAAO;AAEb,QAAO;GAET,EAAE,CACH"}

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

@@ -0,0 +1,11 @@
+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 };
+//# sourceMappingURL=milestone-planner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"milestone-planner.d.ts","names":[],"sources":["../../src/planning/milestone-planner.ts"],"sourcesContent":[],"mappings":";;;cAGa,yBAAA;;EAAA,WAAA,CAAA,aAAyB,CAAzB,EAGiB,kBAHQ,EAAA;EAGR,WAAA,CAAA,KAAA,EAKnB,cALmB,EAAA,YAAA,CAAA,EAAA,MAAA,EAAA,EAAA,KAAA,CAAA,EAAA,MAAA,CAAA,EAQzB,kBARyB,EAAA"}

package/dist/planning/milestone-planner.js

@@ -1 +1,17 @@
-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 };
+//# sourceMappingURL=milestone-planner.js.map

package/dist/planning/milestone-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestone-planner.js","names":["catalog"],"sources":["../../src/planning/milestone-planner.ts"],"sourcesContent":["import type { LifecycleMilestone, LifecycleStage } from '@lssm/lib.lifecycle';\nimport catalog from '../data/milestones-catalog.json' assert { type: 'json' };\n\nexport class LifecycleMilestonePlanner {\n  private readonly milestones: LifecycleMilestone[];\n\n  constructor(customCatalog?: LifecycleMilestone[]) {\n    this.milestones = customCatalog ?? (catalog as LifecycleMilestone[]);\n  }\n\n  getUpcoming(\n    stage: LifecycleStage,\n    completedIds: string[] = [],\n    limit = 5\n  ): LifecycleMilestone[] {\n    const completedSet = new Set(completedIds);\n    return this.milestones\n      .filter(\n        (milestone) =>\n          milestone.stage === stage && !completedSet.has(milestone.id)\n      )\n      .sort((a, b) => a.priority - b.priority)\n      .slice(0, limit);\n  }\n}\n"],"mappings":";;;AAGA,IAAa,4BAAb,MAAuC;CACrC,AAAiB;CAEjB,YAAY,eAAsC;AAChD,OAAK,aAAa,iBAAkBA;;CAGtC,YACE,OACA,eAAyB,EAAE,EAC3B,QAAQ,GACc;EACtB,MAAM,eAAe,IAAI,IAAI,aAAa;AAC1C,SAAO,KAAK,WACT,QACE,cACC,UAAU,UAAU,SAAS,CAAC,aAAa,IAAI,UAAU,GAAG,CAC/D,CACA,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,SAAS,CACvC,MAAM,GAAG,MAAM"}

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

@@ -0,0 +1,27 @@
+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 };
+//# sourceMappingURL=stage-scorer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stage-scorer.d.ts","names":[],"sources":["../../src/scoring/stage-scorer.ts"],"sourcesContent":[],"mappings":";;;KAQK,gBAAA,GAAmB,wBAEN,0BAA0B,wBAAwB,kCAG5D,aATqB,CAAA,MAWnB,uBAPW,CAAA,EAAA,MAAA,CAAA;UAWX,kBAAA,CATQ;EAA0B,MAAA,EAAA,MAAA;EAAwB,SAAA,EAAA,MAAA;EAG5D,SAAA,CAAA,EAAA,KAAA,GAAA,KAAA;;UAYE,iBAAA,CAjBc;EAAO,IAAA,EAAA,MAAA;EAWrB,OAAA,CAAA,EAQE,OARF,CAQU,MARQ,CAQD,gBARC,EAQiB,kBARjB,CAAA,CAAA;EAMlB,WAAA,CAAA,EAGM,OAHW,CAGH,MAHG,CAAA,MAAA,EAAA,MAAA,CAAA,CAAA;;KAMtB,YAAA,GAAe,MAJyB,CAAA,MAAA,EAIV,iBAJU,CAAA;AAAzB,UAQH,eAAA,CARG;EAAR,OAAA,EASD,uBATC;EACY,OAAA,EASb,eATa,EAAA;;AAAD,cAYV,WAAA,CAZU;EAGlB,iBAAY,OAAA;EAIA,WAAA,CAAA,OACN,CADqB,EAQT,YAPZ;EAIE,KAAA,CAAA,KAAA,EAOE,eAPS,CAAA,EAOS,cAPT,EAAA"}

package/dist/scoring/stage-scorer.js

@@ -1 +1,64 @@
-import e from"../data/stage-weights.js";import{LIFECYCLE_STAGE_META as t,LifecycleStage as n}from"@lssm/lib.lifecycle";const r=e;var i=class{weights;constructor(e=r){this.weights=e}score(e){let t=s(e.signals);return Object.values(n).filter(c).map(r=>{let i=n[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(([t,n])=>{let r=e.metrics[t];r!=null&&(a(r,n)?(c+=n.weight,l+=1,d.push(`metric:${t}`)):c+=n.weight*.25)}),s.signalKinds&&Object.entries(s.signalKinds).forEach(([e,n])=>{(t[e]??0)>0&&typeof n==`number`&&(c+=n,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 stage_weights_default from "../data/stage-weights.js";
+import { LIFECYCLE_STAGE_META, LifecycleStage } from "@lssm/lib.lifecycle";
+
+//#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 };
+//# sourceMappingURL=stage-scorer.js.map

package/dist/scoring/stage-scorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-scorer.js","names":["stageWeights","supportingSignals: string[]"],"sources":["../../src/scoring/stage-scorer.ts"],"sourcesContent":["import type {\n  LifecycleMetricSnapshot,\n  LifecycleScore,\n  LifecycleSignal,\n} from '@lssm/lib.lifecycle';\nimport { LIFECYCLE_STAGE_META, LifecycleStage } from '@lssm/lib.lifecycle';\nimport stageWeights from '../data/stage-weights.json' assert { type: 'json' };\n\ntype NumericMetricKey = Extract<\n  {\n    [Key in keyof LifecycleMetricSnapshot]: LifecycleMetricSnapshot[Key] extends\n      | number\n      | undefined\n      ? Key\n      : never;\n  }[keyof LifecycleMetricSnapshot],\n  string\n>;\n\ninterface MetricWeightConfig {\n  weight: number;\n  threshold: number;\n  direction?: 'gte' | 'lte';\n}\n\ninterface StageWeightConfig {\n  base: number;\n  metrics?: Partial<Record<NumericMetricKey, MetricWeightConfig>>;\n  signalKinds?: Partial<Record<string, number>>;\n}\n\ntype StageWeights = Record<string, StageWeightConfig>;\n\nconst DEFAULT_WEIGHTS = stageWeights as StageWeights;\n\nexport interface StageScoreInput {\n  metrics: LifecycleMetricSnapshot;\n  signals: LifecycleSignal[];\n}\n\nexport class StageScorer {\n  private readonly weights: StageWeights;\n\n  constructor(weights: StageWeights = DEFAULT_WEIGHTS) {\n    this.weights = weights;\n  }\n\n  score(input: StageScoreInput): LifecycleScore[] {\n    const kindStrength = evaluateSignalKinds(input.signals);\n\n    const scores = Object.values(LifecycleStage)\n      .filter(isStageValue)\n      .map((stage) => {\n        const stageName = LifecycleStage[stage];\n        const config = this.weights[stageName] ?? { base: 0.5 };\n        let score = config.base ?? 0.5;\n        let contributions = 0;\n        const totalPossible =\n          Object.keys(config.metrics ?? {}).length +\n            Object.keys(config.signalKinds ?? {}).length || 1;\n        const supportingSignals: string[] = [];\n\n        if (config.metrics) {\n          Object.entries(config.metrics).forEach(\n            ([metricKey, metricConfig]) => {\n              const value = input.metrics[metricKey as NumericMetricKey];\n              if (value === undefined || value === null) return;\n              if (passesThreshold(value, metricConfig)) {\n                score += metricConfig.weight;\n                contributions += 1;\n                supportingSignals.push(`metric:${metricKey}`);\n              } else {\n                score += metricConfig.weight * 0.25;\n              }\n            }\n          );\n        }\n\n        if (config.signalKinds) {\n          Object.entries(config.signalKinds).forEach(([kind, weight]) => {\n            const strength = kindStrength[kind] ?? 0;\n            if (strength > 0 && typeof weight === 'number') {\n              score += weight;\n              contributions += 1;\n              supportingSignals.push(`signal:${kind}`);\n            }\n          });\n        }\n\n        score = clamp(score, 0, 1.25); // allow slight overage before clamp\n        const confidence = clamp(contributions / totalPossible, 0.1, 1);\n\n        return {\n          stage,\n          score,\n          confidence,\n          supportingSignals,\n        };\n      });\n\n    return 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  }\n}\n\nconst passesThreshold = (\n  value: number,\n  config: MetricWeightConfig\n): boolean => {\n  const direction = config.direction ?? 'gte';\n  if (direction === 'gte') {\n    return value >= config.threshold;\n  }\n  return value <= config.threshold;\n};\n\nconst clamp = (value: number, min: number, max: number): number =>\n  Math.min(Math.max(value, min), max);\n\nconst evaluateSignalKinds = (\n  signals: LifecycleSignal[]\n): Record<string, number> =>\n  signals.reduce<Record<string, number>>((acc, signal) => {\n    const key = signal.kind ?? 'unknown';\n    acc[key] = (acc[key] ?? 0) + (signal.weight ?? 1);\n    return acc;\n  }, {});\n\nconst isStageValue = (\n  value: string | LifecycleStage\n): value is LifecycleStage =>\n  typeof value === 'number' && value in LIFECYCLE_STAGE_META;\n"],"mappings":";;;;AAiCA,MAAM,kBAAkBA;AAOxB,IAAa,cAAb,MAAyB;CACvB,AAAiB;CAEjB,YAAY,UAAwB,iBAAiB;AACnD,OAAK,UAAU;;CAGjB,MAAM,OAA0C;EAC9C,MAAM,eAAe,oBAAoB,MAAM,QAAQ;AAoDvD,SAlDe,OAAO,OAAO,eAAe,CACzC,OAAO,aAAa,CACpB,KAAK,UAAU;GACd,MAAM,YAAY,eAAe;GACjC,MAAM,SAAS,KAAK,QAAQ,cAAc,EAAE,MAAM,IAAK;GACvD,IAAI,QAAQ,OAAO,QAAQ;GAC3B,IAAI,gBAAgB;GACpB,MAAM,gBACJ,OAAO,KAAK,OAAO,WAAW,EAAE,CAAC,CAAC,SAChC,OAAO,KAAK,OAAO,eAAe,EAAE,CAAC,CAAC,UAAU;GACpD,MAAMC,oBAA8B,EAAE;AAEtC,OAAI,OAAO,QACT,QAAO,QAAQ,OAAO,QAAQ,CAAC,SAC5B,CAAC,WAAW,kBAAkB;IAC7B,MAAM,QAAQ,MAAM,QAAQ;AAC5B,QAAI,UAAU,UAAa,UAAU,KAAM;AAC3C,QAAI,gBAAgB,OAAO,aAAa,EAAE;AACxC,cAAS,aAAa;AACtB,sBAAiB;AACjB,uBAAkB,KAAK,UAAU,YAAY;UAE7C,UAAS,aAAa,SAAS;KAGpC;AAGH,OAAI,OAAO,YACT,QAAO,QAAQ,OAAO,YAAY,CAAC,SAAS,CAAC,MAAM,YAAY;AAE7D,SADiB,aAAa,SAAS,KACxB,KAAK,OAAO,WAAW,UAAU;AAC9C,cAAS;AACT,sBAAiB;AACjB,uBAAkB,KAAK,UAAU,OAAO;;KAE1C;AAGJ,WAAQ,MAAM,OAAO,GAAG,KAAK;GAC7B,MAAM,aAAa,MAAM,gBAAgB,eAAe,IAAK,EAAE;AAE/D,UAAO;IACL;IACA;IACA;IACA;IACD;IACD,CAEU,MAAM,GAAG,MAAM;AAC3B,OAAI,EAAE,UAAU,EAAE,MAChB,QAAO,EAAE,aAAa,EAAE;AAE1B,UAAO,EAAE,QAAQ,EAAE;IACnB;;;AAIN,MAAM,mBACJ,OACA,WACY;AAEZ,MADkB,OAAO,aAAa,WACpB,MAChB,QAAO,SAAS,OAAO;AAEzB,QAAO,SAAS,OAAO;;AAGzB,MAAM,SAAS,OAAe,KAAa,QACzC,KAAK,IAAI,KAAK,IAAI,OAAO,IAAI,EAAE,IAAI;AAErC,MAAM,uBACJ,YAEA,QAAQ,QAAgC,KAAK,WAAW;CACtD,MAAM,MAAM,OAAO,QAAQ;AAC3B,KAAI,QAAQ,IAAI,QAAQ,MAAM,OAAO,UAAU;AAC/C,QAAO;GACN,EAAE,CAAC;AAER,MAAM,gBACJ,UAEA,OAAO,UAAU,YAAY,SAAS"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/module.lifecycle-core",
-  "version": "1.42.0",
+  "version": "1.42.1",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -13,7 +13,7 @@
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
-    "build": "bun build:bundle && bun build:types",
+    "build": "bun build:types && bun build:bundle",
     "build:bundle": "tsdown",
     "build:types": "tsc --noEmit",
     "dev": "bun build:bundle --watch",
@@ -24,16 +24,16 @@
     "test": "bun run"
   },
   "dependencies": {
-    "@lssm/lib.lifecycle": "1.42.0"
+    "@lssm/lib.lifecycle": "1.42.1"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "1.42.0",
-    "@lssm/tool.typescript": "1.42.0",
-    "tsdown": "^0.17.4",
+    "@lssm/tool.tsdown": "1.42.1",
+    "@lssm/tool.typescript": "1.42.1",
+    "tsdown": "^0.18.3",
     "typescript": "^5.9.3"
   },
   "exports": {
-    ".": "./src/index.ts",
+    ".": "./dist/index.js",
     "./*": "./*"
   },
   "publishConfig": {
@@ -41,6 +41,13 @@
     "exports": {
       ".": "./dist/index.js",
       "./*": "./*"
-    }
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/modules/lifecycle-core"
   }
 }