@contractspec/module.lifecycle-core 3.7.5 → 3.7.7

package/README.md

@@ -1,77 +1,67 @@
 # @contractspec/module.lifecycle-core
 
-Website: https://contractspec.io/
-
-
-Signal collection + scoring module for ContractSpec lifecycle assessments. It wraps analytics/questionnaire adapters, applies weighting logic, and produces normalized `LifecycleAssessment` objects.
-
-## Features
-
-- Adapter-driven signal collector (analytics, questionnaires, intent logs)
-- Configurable stage scoring weights
-- Milestone planner backed by JSON catalog
-- Lifecycle orchestrator that returns assessments + scorecards
-
-## Usage
-
-```ts
-import {
-  LifecycleOrchestrator,
-  StageSignalCollector,
-  StageScorer,
-  LifecycleMilestonePlanner,
-} from '@contractspec/module.lifecycle-core';
-
-const collector = new StageSignalCollector({
-  analyticsAdapter,
-  questionnaireAdapter,
-});
-
-const scorer = new StageScorer();
-const planner = new LifecycleMilestonePlanner();
-
-const orchestrator = new LifecycleOrchestrator({
-  collector,
-  scorer,
-  planner,
-});
-
-const assessment = await orchestrator.run({
-  questionnaireAnswers: answers,
-});
-
-console.log(assessment.stage, assessment.confidence);
-```
-
-Adapters are interfaces—you can implement them inside bundles, Studio services, or examples without touching this module.*** End Patch
-
-
-
-
-
-
-
-
-
-
-
-
+Website: https://contractspec.io
 
+**Core lifecycle stage definitions and transitions.**
 
+## What It Provides
 
+- **Layer**: module.
+- **Consumers**: modules (lifecycle-advisor), bundles (library, contractspec-studio), apps (web-landing, cli).
+- `src/adapters/` contains runtime, provider, or environment-specific adapters.
+- Related ContractSpec packages include `@contractspec/lib.contracts-spec`, `@contractspec/lib.lifecycle`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+- `src/adapters/` contains runtime, provider, or environment-specific adapters.
 
+## Installation
 
+`npm install @contractspec/module.lifecycle-core`
 
+or
 
+`bun add @contractspec/module.lifecycle-core`
 
+## Usage
 
+Import the root entrypoint from `@contractspec/module.lifecycle-core`, or choose a documented subpath when you only need one part of the package surface.
 
+## Architecture
 
+- `src/adapters/` contains runtime, provider, or environment-specific adapters.
+- `src/collectors` is part of the package's public or composition surface.
+- `src/data/` contains static content, registries, and package-local datasets.
+- `src/i18n` is part of the package's public or composition surface.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/orchestrator` is part of the package's public or composition surface.
+- `src/planning` is part of the package's public or composition surface.
 
+## Public Entry Points
 
+- Export `.` resolves through `./src/index.ts`.
 
+## Local Commands
 
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
 
+## Recent Updates
 
+- Replace eslint+prettier by biomejs to optimize speed.
+- Resolve lint/test regressions after voice capability updates.
+- Add full i18n support across all 10 packages (en/fr/es, 460 keys).
 
+## Notes
 
+- Depends on `lib.lifecycle` for foundational types -- this module adds orchestration on top.
+- Stage transition rules are the source of truth; changes here cascade to lifecycle-advisor and all consuming bundles.
+- Stage data in `src/data/` must remain backward-compatible to avoid breaking persisted project states.

package/dist/browser/index.js

@@ -78,11 +78,168 @@ var dedupeSignals = (signals) => {
     return true;
   });
 };
-// src/scoring/stage-scorer.ts
+// src/orchestrator/lifecycle-orchestrator.ts
 import {
+  getLocalizedStageMeta,
   LIFECYCLE_STAGE_META,
   LifecycleStage
 } from "@contractspec/lib.lifecycle";
+
+class LifecycleOrchestrator {
+  collector;
+  scorer;
+  planner;
+  locale;
+  constructor(options) {
+    this.collector = options.collector;
+    this.scorer = options.scorer;
+    this.planner = options.milestonePlanner;
+    this.locale = options.locale;
+  }
+  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 stageMeta = this.locale ? getLocalizedStageMeta(this.locale) : LIFECYCLE_STAGE_META;
+    const meta = stageMeta[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: new Date().toISOString()
+    };
+  }
+  getUpcomingMilestones(stage, completedMilestoneIds = [], limit = 5) {
+    if (!this.planner)
+      return [];
+    return this.planner.getUpcoming(stage, completedMilestoneIds, limit);
+  }
+}
+var fallbackScore = () => ({
+  stage: LifecycleStage.Exploration,
+  score: 0.3,
+  confidence: 0.3,
+  supportingSignals: []
+});
+var toMetricRecord = (snapshot) => Object.entries(snapshot ?? {}).reduce((acc, [key, value]) => {
+  if (typeof value === "number") {
+    acc[key] = value;
+  }
+  return acc;
+}, {});
+// 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"
+    ]
+  }
+];
+
+// src/planning/milestone-planner.ts
+class LifecycleMilestonePlanner {
+  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);
+  }
+}
+// src/scoring/stage-scorer.ts
+import {
+  LIFECYCLE_STAGE_META as LIFECYCLE_STAGE_META2,
+  LifecycleStage as LifecycleStage2
+} from "@contractspec/lib.lifecycle";
 // src/data/stage-weights.json
 var stage_weights_default = {
   Exploration: {
@@ -204,8 +361,8 @@ class StageScorer {
   }
   score(input) {
     const kindStrength = evaluateSignalKinds(input.signals);
-    const scores = Object.values(LifecycleStage).filter(isStageValue).map((stage) => {
-      const stageName = LifecycleStage[stage];
+    const scores = Object.values(LifecycleStage2).filter(isStageValue).map((stage) => {
+      const stageName = LifecycleStage2[stage];
       const config = this.weights[stageName] ?? { base: 0.5 };
       let score = config.base ?? 0.5;
       let contributions = 0;
@@ -265,164 +422,7 @@ var evaluateSignalKinds = (signals) => signals.reduce((acc, signal) => {
   acc[key] = (acc[key] ?? 0) + (signal.weight ?? 1);
   return acc;
 }, {});
-var isStageValue = (value) => typeof value === "number" && (value in LIFECYCLE_STAGE_META);
-// src/orchestrator/lifecycle-orchestrator.ts
-import {
-  LIFECYCLE_STAGE_META as LIFECYCLE_STAGE_META2,
-  LifecycleStage as LifecycleStage2,
-  getLocalizedStageMeta
-} from "@contractspec/lib.lifecycle";
-
-class LifecycleOrchestrator {
-  collector;
-  scorer;
-  planner;
-  locale;
-  constructor(options) {
-    this.collector = options.collector;
-    this.scorer = options.scorer;
-    this.planner = options.milestonePlanner;
-    this.locale = options.locale;
-  }
-  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 stageMeta = this.locale ? getLocalizedStageMeta(this.locale) : LIFECYCLE_STAGE_META2;
-    const meta = stageMeta[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: new Date().toISOString()
-    };
-  }
-  getUpcomingMilestones(stage, completedMilestoneIds = [], limit = 5) {
-    if (!this.planner)
-      return [];
-    return this.planner.getUpcoming(stage, completedMilestoneIds, limit);
-  }
-}
-var fallbackScore = () => ({
-  stage: LifecycleStage2.Exploration,
-  score: 0.3,
-  confidence: 0.3,
-  supportingSignals: []
-});
-var toMetricRecord = (snapshot) => Object.entries(snapshot ?? {}).reduce((acc, [key, value]) => {
-  if (typeof value === "number") {
-    acc[key] = value;
-  }
-  return acc;
-}, {});
-// 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"
-    ]
-  }
-];
-
-// src/planning/milestone-planner.ts
-class LifecycleMilestonePlanner {
-  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);
-  }
-}
+var isStageValue = (value) => typeof value === "number" && (value in LIFECYCLE_STAGE_META2);
 export {
   StageSignalCollector,
   StageScorer,

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

@@ -1,7 +1,7 @@
 import type { LifecycleAssessmentInput, LifecycleAxes, LifecycleMetricSnapshot, LifecycleSignal } from '@contractspec/lib.lifecycle';
 import type { AnalyticsAdapter } from '../adapters/analytics-adapter';
-import type { QuestionnaireAdapter } from '../adapters/questionnaire-adapter';
 import type { IntentAdapter } from '../adapters/intent-adapter';
+import type { QuestionnaireAdapter } from '../adapters/questionnaire-adapter';
 export interface StageSignalCollectorOptions {
     analyticsAdapter?: AnalyticsAdapter;
     questionnaireAdapter?: QuestionnaireAdapter;

package/dist/i18n/catalogs/index.d.ts

@@ -4,5 +4,5 @@
  * @module i18n/catalogs
  */
 export { enMessages } from './en';
-export { frMessages } from './fr';
 export { esMessages } from './es';
+export { frMessages } from './fr';

package/dist/i18n/index.d.ts

@@ -3,12 +3,12 @@
  *
  * @module i18n
  */
-export { createLifecycleCoreI18n, getDefaultI18n, resetI18nRegistry, } from './messages';
-export type { LifecycleCoreI18n } from './messages';
-export { resolveLocale, isSupportedLocale, DEFAULT_LOCALE, SUPPORTED_LOCALES, } from './locale';
-export type { SupportedLocale } from './locale';
-export { I18N_KEYS, MILESTONE_KEYS } from './keys';
-export type { LifecycleCoreMessageKey } from './keys';
 export { enMessages } from './catalogs/en';
-export { frMessages } from './catalogs/fr';
 export { esMessages } from './catalogs/es';
+export { frMessages } from './catalogs/fr';
+export type { LifecycleCoreMessageKey } from './keys';
+export { I18N_KEYS, MILESTONE_KEYS } from './keys';
+export type { SupportedLocale } from './locale';
+export { DEFAULT_LOCALE, isSupportedLocale, resolveLocale, SUPPORTED_LOCALES, } from './locale';
+export type { LifecycleCoreI18n } from './messages';
+export { createLifecycleCoreI18n, getDefaultI18n, resetI18nRegistry, } from './messages';

package/dist/i18n/locale.d.ts

@@ -5,4 +5,4 @@
  *
  * @module i18n/locale
  */
-export { DEFAULT_LOCALE, SUPPORTED_LOCALES, resolveLocale, isSupportedLocale, type SupportedLocale, } from '@contractspec/lib.contracts-spec/translations';
+export { DEFAULT_LOCALE, isSupportedLocale, resolveLocale, SUPPORTED_LOCALES, type SupportedLocale, } from '@contractspec/lib.contracts-spec/translations';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-export * from './collectors/signal-collector';
 export * from './adapters/analytics-adapter';
-export * from './adapters/questionnaire-adapter';
 export * from './adapters/intent-adapter';
-export * from './scoring/stage-scorer';
+export * from './adapters/questionnaire-adapter';
+export * from './collectors/signal-collector';
 export * from './orchestrator/lifecycle-orchestrator';
 export * from './planning/milestone-planner';
+export * from './scoring/stage-scorer';