@contractspec/module.lifecycle-advisor 2.4.0 → 2.5.0

package/dist/recommendations/library-recommender.d.ts

@@ -8,5 +8,9 @@ export interface LibraryRecommendation {
 export declare class ContractSpecLibraryRecommender {
     private readonly mapping;
     constructor(overrides?: LibraryStageEntry[]);
-    recommend(stage: LifecycleStage, limit?: number): LibraryRecommendation[];
+    /**
+     * Recommend libraries for a lifecycle stage.
+     * When `locale` is provided, library descriptions are translated.
+     */
+    recommend(stage: LifecycleStage, limit?: number, locale?: string): LibraryRecommendation[];
 }

package/dist/recommendations/recommendation-engine.d.ts

@@ -4,6 +4,8 @@ type StagePlaybook = StagePlaybookData;
 export interface RecommendationOptions {
     limit?: number;
     upcomingMilestones?: LifecycleMilestone[];
+    /** Locale for translated action titles, descriptions, and ceremony copy. */
+    locale?: string;
 }
 export declare class LifecycleRecommendationEngine {
     private readonly playbooks;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/module.lifecycle-advisor",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "AI-powered lifecycle recommendations and guidance",
   "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": {
     ".": {

package/src/data/library-stage-map.ts

@@ -1,12 +1,30 @@
 import type { LifecycleStage } from '@contractspec/lib.lifecycle';
 import type { LibraryRecommendation } from '../recommendations/library-recommender';
+import { createLifecycleAdvisorI18n } from '../i18n/messages';
 
 export interface LibraryStageEntry {
   stage: LifecycleStage;
   items: LibraryRecommendation[];
 }
 
-const libraryStageMap: LibraryStageEntry[] = [
+/**
+ * Return the library-stage map with translated descriptions for the given locale.
+ * Falls back to English when locale is omitted or unsupported.
+ */
+export function getLocalizedLibraryStageMap(
+  locale?: string
+): LibraryStageEntry[] {
+  const i18n = createLifecycleAdvisorI18n(locale);
+  return staticLibraryStageMap.map((entry, stageIdx) => ({
+    ...entry,
+    items: entry.items.map((item, itemIdx) => ({
+      ...item,
+      description: i18n.t(`library.stage${stageIdx}.item${itemIdx}`),
+    })),
+  }));
+}
+
+const staticLibraryStageMap: LibraryStageEntry[] = [
   {
     stage: 0 as LifecycleStage,
     items: [
@@ -114,4 +132,6 @@ const libraryStageMap: LibraryStageEntry[] = [
   },
 ];
 
+/** Backward-compatible static export (English defaults). */
+const libraryStageMap: LibraryStageEntry[] = staticLibraryStageMap;
 export default libraryStageMap;

package/src/data/stage-playbooks.ts

@@ -3,6 +3,7 @@ import type {
   LifecycleRecommendation,
 } from '@contractspec/lib.lifecycle';
 import { LifecycleStage } from '@contractspec/lib.lifecycle';
+import { createLifecycleAdvisorI18n } from '../i18n/messages';
 
 export interface StagePlaybookData {
   stage: LifecycleStage;
@@ -11,7 +12,37 @@ export interface StagePlaybookData {
   ceremony?: LifecycleRecommendation['ceremony'];
 }
 
-const stagePlaybooks: StagePlaybookData[] = [
+/**
+ * Return stage playbooks with translated strings for the given locale.
+ * Falls back to English when locale is omitted or unsupported.
+ */
+export function getLocalizedStagePlaybooks(
+  locale?: string
+): StagePlaybookData[] {
+  const i18n = createLifecycleAdvisorI18n(locale);
+  return staticPlaybooks.map((playbook, stageIdx) => ({
+    ...playbook,
+    focusAreas: playbook.focusAreas.map((_, focusIdx) =>
+      i18n.t(`playbook.stage${stageIdx}.focus.${focusIdx}`)
+    ),
+    actions: playbook.actions.map((action, actionIdx) => ({
+      ...action,
+      title: i18n.t(`playbook.stage${stageIdx}.action${actionIdx}.title`),
+      description: i18n.t(
+        `playbook.stage${stageIdx}.action${actionIdx}.description`
+      ),
+    })),
+    ceremony: playbook.ceremony
+      ? {
+          ...playbook.ceremony,
+          title: i18n.t(`ceremony.stage${stageIdx}.title`),
+          copy: i18n.t(`ceremony.stage${stageIdx}.copy`),
+        }
+      : undefined,
+  }));
+}
+
+const staticPlaybooks: StagePlaybookData[] = [
   {
     stage: LifecycleStage.Exploration,
     focusAreas: ['Discovery', 'Problem clarity', 'Persona'],
@@ -251,4 +282,6 @@ const stagePlaybooks: StagePlaybookData[] = [
   },
 ];
 
+/** Backward-compatible static export (English defaults). */
+const stagePlaybooks: StagePlaybookData[] = staticPlaybooks;
 export default stagePlaybooks;