@contractspec/module.lifecycle-core 2.4.0 → 2.5.0

package/dist/browser/index.js

@@ -269,17 +269,20 @@ var isStageValue = (value) => typeof value === "number" && (value in LIFECYCLE_S
 // src/orchestrator/lifecycle-orchestrator.ts
 import {
   LIFECYCLE_STAGE_META as LIFECYCLE_STAGE_META2,
-  LifecycleStage as LifecycleStage2
+  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);
@@ -288,7 +291,8 @@ class LifecycleOrchestrator {
       signals: collected.signals
     });
     const top = scorecard[0] ?? fallbackScore();
-    const meta = LIFECYCLE_STAGE_META2[top.stage];
+    const stageMeta = this.locale ? getLocalizedStageMeta(this.locale) : LIFECYCLE_STAGE_META2;
+    const meta = stageMeta[top.stage];
     return {
       stage: top.stage,
       confidence: top.confidence,

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

@@ -0,0 +1,6 @@
+/**
+ * English (en) translation catalog for @contractspec/module.lifecycle-core.
+ *
+ * @module i18n/catalogs/en
+ */
+export declare const enMessages: import("@contractspec/lib.contracts-spec/translations").TranslationSpec;

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

@@ -0,0 +1,6 @@
+/**
+ * Spanish (es) translation catalog for @contractspec/module.lifecycle-core.
+ *
+ * @module i18n/catalogs/es
+ */
+export declare const esMessages: import("@contractspec/lib.contracts-spec/translations").TranslationSpec;

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

@@ -0,0 +1,6 @@
+/**
+ * French (fr) translation catalog for @contractspec/module.lifecycle-core.
+ *
+ * @module i18n/catalogs/fr
+ */
+export declare const frMessages: import("@contractspec/lib.contracts-spec/translations").TranslationSpec;

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

@@ -0,0 +1,8 @@
+/**
+ * Translation catalog barrel exports.
+ *
+ * @module i18n/catalogs
+ */
+export { enMessages } from './en';
+export { frMessages } from './fr';
+export { esMessages } from './es';

package/dist/i18n/i18n.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/i18n/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Internationalization (i18n) module for @contractspec/module.lifecycle-core.
+ *
+ * @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';

package/dist/i18n/keys.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Typed message keys for the lifecycle-core i18n system.
+ *
+ * All translatable strings in the module are referenced by these keys.
+ * Organized by domain: milestone (titles, descriptions, action items).
+ *
+ * @module i18n/keys
+ */
+export declare const MILESTONE_KEYS: {
+    readonly 'milestone.stage0ProblemStatement.title': "milestone.stage0ProblemStatement.title";
+    readonly 'milestone.stage0ProblemStatement.description': "milestone.stage0ProblemStatement.description";
+    readonly 'milestone.stage0ProblemStatement.action.0': "milestone.stage0ProblemStatement.action.0";
+    readonly 'milestone.stage0ProblemStatement.action.1': "milestone.stage0ProblemStatement.action.1";
+    readonly 'milestone.stage1PrototypeLoop.title': "milestone.stage1PrototypeLoop.title";
+    readonly 'milestone.stage1PrototypeLoop.description': "milestone.stage1PrototypeLoop.description";
+    readonly 'milestone.stage1PrototypeLoop.action.0': "milestone.stage1PrototypeLoop.action.0";
+    readonly 'milestone.stage1PrototypeLoop.action.1': "milestone.stage1PrototypeLoop.action.1";
+    readonly 'milestone.stage2Activation.title': "milestone.stage2Activation.title";
+    readonly 'milestone.stage2Activation.description': "milestone.stage2Activation.description";
+    readonly 'milestone.stage2Activation.action.0': "milestone.stage2Activation.action.0";
+    readonly 'milestone.stage2Activation.action.1': "milestone.stage2Activation.action.1";
+    readonly 'milestone.stage3RetentionNarrative.title': "milestone.stage3RetentionNarrative.title";
+    readonly 'milestone.stage3RetentionNarrative.description': "milestone.stage3RetentionNarrative.description";
+    readonly 'milestone.stage3RetentionNarrative.action.0': "milestone.stage3RetentionNarrative.action.0";
+    readonly 'milestone.stage3RetentionNarrative.action.1': "milestone.stage3RetentionNarrative.action.1";
+    readonly 'milestone.stage4GrowthLoop.title': "milestone.stage4GrowthLoop.title";
+    readonly 'milestone.stage4GrowthLoop.description': "milestone.stage4GrowthLoop.description";
+    readonly 'milestone.stage4GrowthLoop.action.0': "milestone.stage4GrowthLoop.action.0";
+    readonly 'milestone.stage4GrowthLoop.action.1': "milestone.stage4GrowthLoop.action.1";
+    readonly 'milestone.stage4GrowthLoop.action.2': "milestone.stage4GrowthLoop.action.2";
+    readonly 'milestone.stage5PlatformBlueprint.title': "milestone.stage5PlatformBlueprint.title";
+    readonly 'milestone.stage5PlatformBlueprint.description': "milestone.stage5PlatformBlueprint.description";
+    readonly 'milestone.stage5PlatformBlueprint.action.0': "milestone.stage5PlatformBlueprint.action.0";
+    readonly 'milestone.stage5PlatformBlueprint.action.1': "milestone.stage5PlatformBlueprint.action.1";
+    readonly 'milestone.stage6RenewalOps.title': "milestone.stage6RenewalOps.title";
+    readonly 'milestone.stage6RenewalOps.description': "milestone.stage6RenewalOps.description";
+    readonly 'milestone.stage6RenewalOps.action.0': "milestone.stage6RenewalOps.action.0";
+    readonly 'milestone.stage6RenewalOps.action.1': "milestone.stage6RenewalOps.action.1";
+};
+export declare const I18N_KEYS: {
+    readonly 'milestone.stage0ProblemStatement.title': "milestone.stage0ProblemStatement.title";
+    readonly 'milestone.stage0ProblemStatement.description': "milestone.stage0ProblemStatement.description";
+    readonly 'milestone.stage0ProblemStatement.action.0': "milestone.stage0ProblemStatement.action.0";
+    readonly 'milestone.stage0ProblemStatement.action.1': "milestone.stage0ProblemStatement.action.1";
+    readonly 'milestone.stage1PrototypeLoop.title': "milestone.stage1PrototypeLoop.title";
+    readonly 'milestone.stage1PrototypeLoop.description': "milestone.stage1PrototypeLoop.description";
+    readonly 'milestone.stage1PrototypeLoop.action.0': "milestone.stage1PrototypeLoop.action.0";
+    readonly 'milestone.stage1PrototypeLoop.action.1': "milestone.stage1PrototypeLoop.action.1";
+    readonly 'milestone.stage2Activation.title': "milestone.stage2Activation.title";
+    readonly 'milestone.stage2Activation.description': "milestone.stage2Activation.description";
+    readonly 'milestone.stage2Activation.action.0': "milestone.stage2Activation.action.0";
+    readonly 'milestone.stage2Activation.action.1': "milestone.stage2Activation.action.1";
+    readonly 'milestone.stage3RetentionNarrative.title': "milestone.stage3RetentionNarrative.title";
+    readonly 'milestone.stage3RetentionNarrative.description': "milestone.stage3RetentionNarrative.description";
+    readonly 'milestone.stage3RetentionNarrative.action.0': "milestone.stage3RetentionNarrative.action.0";
+    readonly 'milestone.stage3RetentionNarrative.action.1': "milestone.stage3RetentionNarrative.action.1";
+    readonly 'milestone.stage4GrowthLoop.title': "milestone.stage4GrowthLoop.title";
+    readonly 'milestone.stage4GrowthLoop.description': "milestone.stage4GrowthLoop.description";
+    readonly 'milestone.stage4GrowthLoop.action.0': "milestone.stage4GrowthLoop.action.0";
+    readonly 'milestone.stage4GrowthLoop.action.1': "milestone.stage4GrowthLoop.action.1";
+    readonly 'milestone.stage4GrowthLoop.action.2': "milestone.stage4GrowthLoop.action.2";
+    readonly 'milestone.stage5PlatformBlueprint.title': "milestone.stage5PlatformBlueprint.title";
+    readonly 'milestone.stage5PlatformBlueprint.description': "milestone.stage5PlatformBlueprint.description";
+    readonly 'milestone.stage5PlatformBlueprint.action.0': "milestone.stage5PlatformBlueprint.action.0";
+    readonly 'milestone.stage5PlatformBlueprint.action.1': "milestone.stage5PlatformBlueprint.action.1";
+    readonly 'milestone.stage6RenewalOps.title': "milestone.stage6RenewalOps.title";
+    readonly 'milestone.stage6RenewalOps.description': "milestone.stage6RenewalOps.description";
+    readonly 'milestone.stage6RenewalOps.action.0': "milestone.stage6RenewalOps.action.0";
+    readonly 'milestone.stage6RenewalOps.action.1': "milestone.stage6RenewalOps.action.1";
+};
+/** Union type of all valid lifecycle-core i18n keys */
+export type LifecycleCoreMessageKey = keyof typeof I18N_KEYS;

package/dist/i18n/locale.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Locale utilities for the lifecycle-core package.
+ *
+ * Re-exported from the shared i18n factory in contracts-spec.
+ *
+ * @module i18n/locale
+ */
+export { DEFAULT_LOCALE, SUPPORTED_LOCALES, resolveLocale, isSupportedLocale, type SupportedLocale, } from '@contractspec/lib.contracts-spec/translations';

package/dist/i18n/messages.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Translation helper for the lifecycle-core package.
+ * @module i18n/messages
+ */
+import { type I18nInstance } from '@contractspec/lib.contracts-spec/translations';
+import type { LifecycleCoreMessageKey } from './keys';
+/** I18n instance type for the lifecycle-core package. */
+export type LifecycleCoreI18n = I18nInstance<LifecycleCoreMessageKey>;
+/** Create an i18n instance for a given locale. */
+export declare const createLifecycleCoreI18n: (optionsLocale?: string, runtimeLocale?: string) => I18nInstance<"milestone.stage0ProblemStatement.title" | "milestone.stage0ProblemStatement.description" | "milestone.stage0ProblemStatement.action.0" | "milestone.stage0ProblemStatement.action.1" | "milestone.stage1PrototypeLoop.title" | "milestone.stage1PrototypeLoop.description" | "milestone.stage1PrototypeLoop.action.0" | "milestone.stage1PrototypeLoop.action.1" | "milestone.stage2Activation.title" | "milestone.stage2Activation.description" | "milestone.stage2Activation.action.0" | "milestone.stage2Activation.action.1" | "milestone.stage3RetentionNarrative.title" | "milestone.stage3RetentionNarrative.description" | "milestone.stage3RetentionNarrative.action.0" | "milestone.stage3RetentionNarrative.action.1" | "milestone.stage4GrowthLoop.title" | "milestone.stage4GrowthLoop.description" | "milestone.stage4GrowthLoop.action.0" | "milestone.stage4GrowthLoop.action.1" | "milestone.stage4GrowthLoop.action.2" | "milestone.stage5PlatformBlueprint.title" | "milestone.stage5PlatformBlueprint.description" | "milestone.stage5PlatformBlueprint.action.0" | "milestone.stage5PlatformBlueprint.action.1" | "milestone.stage6RenewalOps.title" | "milestone.stage6RenewalOps.description" | "milestone.stage6RenewalOps.action.0" | "milestone.stage6RenewalOps.action.1">;
+/** Create a default (English) i18n instance. */
+export declare const getDefaultI18n: () => I18nInstance<"milestone.stage0ProblemStatement.title" | "milestone.stage0ProblemStatement.description" | "milestone.stage0ProblemStatement.action.0" | "milestone.stage0ProblemStatement.action.1" | "milestone.stage1PrototypeLoop.title" | "milestone.stage1PrototypeLoop.description" | "milestone.stage1PrototypeLoop.action.0" | "milestone.stage1PrototypeLoop.action.1" | "milestone.stage2Activation.title" | "milestone.stage2Activation.description" | "milestone.stage2Activation.action.0" | "milestone.stage2Activation.action.1" | "milestone.stage3RetentionNarrative.title" | "milestone.stage3RetentionNarrative.description" | "milestone.stage3RetentionNarrative.action.0" | "milestone.stage3RetentionNarrative.action.1" | "milestone.stage4GrowthLoop.title" | "milestone.stage4GrowthLoop.description" | "milestone.stage4GrowthLoop.action.0" | "milestone.stage4GrowthLoop.action.1" | "milestone.stage4GrowthLoop.action.2" | "milestone.stage5PlatformBlueprint.title" | "milestone.stage5PlatformBlueprint.description" | "milestone.stage5PlatformBlueprint.action.0" | "milestone.stage5PlatformBlueprint.action.1" | "milestone.stage6RenewalOps.title" | "milestone.stage6RenewalOps.description" | "milestone.stage6RenewalOps.action.0" | "milestone.stage6RenewalOps.action.1">;
+/** Reset the shared registry (useful for testing). @internal */
+export declare const resetI18nRegistry: () => void;

package/dist/index.js

@@ -270,17 +270,20 @@ var isStageValue = (value) => typeof value === "number" && (value in LIFECYCLE_S
 // src/orchestrator/lifecycle-orchestrator.ts
 import {
   LIFECYCLE_STAGE_META as LIFECYCLE_STAGE_META2,
-  LifecycleStage as LifecycleStage2
+  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);
@@ -289,7 +292,8 @@ class LifecycleOrchestrator {
       signals: collected.signals
     });
     const top = scorecard[0] ?? fallbackScore();
-    const meta = LIFECYCLE_STAGE_META2[top.stage];
+    const stageMeta = this.locale ? getLocalizedStageMeta(this.locale) : LIFECYCLE_STAGE_META2;
+    const meta = stageMeta[top.stage];
     return {
       stage: top.stage,
       confidence: top.confidence,

package/dist/node/index.js

@@ -269,17 +269,20 @@ var isStageValue = (value) => typeof value === "number" && (value in LIFECYCLE_S
 // src/orchestrator/lifecycle-orchestrator.ts
 import {
   LIFECYCLE_STAGE_META as LIFECYCLE_STAGE_META2,
-  LifecycleStage as LifecycleStage2
+  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);
@@ -288,7 +291,8 @@ class LifecycleOrchestrator {
       signals: collected.signals
     });
     const top = scorecard[0] ?? fallbackScore();
-    const meta = LIFECYCLE_STAGE_META2[top.stage];
+    const stageMeta = this.locale ? getLocalizedStageMeta(this.locale) : LIFECYCLE_STAGE_META2;
+    const meta = stageMeta[top.stage];
     return {
       stage: top.stage,
       confidence: top.confidence,

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

@@ -7,11 +7,14 @@ export interface LifecycleOrchestratorOptions {
     collector: StageSignalCollector;
     scorer: StageScorer;
     milestonePlanner?: LifecycleMilestonePlanner;
+    /** Locale for localized stage metadata */
+    locale?: string;
 }
 export declare class LifecycleOrchestrator {
     private readonly collector;
     private readonly scorer;
     private readonly planner?;
+    private readonly locale?;
     constructor(options: LifecycleOrchestratorOptions);
     run(input?: LifecycleAssessmentInput): Promise<LifecycleAssessment>;
     getUpcomingMilestones(stage: LifecycleStage, completedMilestoneIds?: string[], limit?: number): LifecycleMilestone[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/module.lifecycle-core",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Core lifecycle stage definitions and transitions",
   "keywords": [
     "contractspec",
@@ -33,12 +33,13 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.lifecycle": "2.4.0"
+    "@contractspec/lib.lifecycle": "2.5.0",
+    "@contractspec/lib.contracts-spec": "2.5.0"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "2.4.0",
+    "@contractspec/tool.typescript": "2.5.0",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "2.4.0"
+    "@contractspec/tool.bun": "2.5.0"
   },
   "exports": {
     ".": {