@contractspec/bundle.lifecycle-managed 3.7.6 → 3.7.7

package/README.md

@@ -1,65 +1,66 @@
 # @contractspec/bundle.lifecycle-managed
 
-Website: https://contractspec.io/
-
-
-Lifecycle assessment + guidance managed service for ContractSpec Studio. This bundle wires the lifecycle modules, analytics bridges, and AI advisor agent into a deployable service surface (REST, events, Studio integrations).
-
-## Modules
-
-- `LifecycleAssessmentService` – orchestrates detection, scoring, guidance, metrics, and managed events.
-- `LifecycleAdvisorAgent` – AI spec definition for conversational lifecycle coaching.
-- `LifecycleEventBridge` – helper to broadcast stage changes + assessment telemetry.
-- REST handlers – HTTP-friendly adapters for serving assessments + playbooks.
-
-## Usage
-
-```ts
-import { LifecycleAssessmentService, createLifecycleHandlers } from '@contractspec/bundle.lifecycle-managed';
-
-const service = new LifecycleAssessmentService({
-  tenantId: 'tenant_123',
-  collectorOptions: {
-    analyticsAdapter,
-    questionnaireAdapter,
-  },
-});
-
-const handlers = createLifecycleHandlers(service);
-
-app.post('/lifecycle/assessments', handlers.runAssessment);
-app.get('/lifecycle/playbooks/:stage', handlers.getPlaybook);
-```
-
-The bundle stays framework-agnostic: you can mount the handlers on Elysia, Express, Next.js routes, or background jobs.*** End Patch
-
-
-
-
-
-
-
-
-
-
-
-
+Website: https://contractspec.io
 
+**Lifecycle management bundle with analytics and AI advisor.**
 
+## What It Provides
 
+- **Layer**: bundle.
+- **Consumers**: `examples/lifecycle-cli`.
+- `src/services/` contains business logic services and workflows.
+- Related ContractSpec packages include `@contractspec/lib.ai-agent`, `@contractspec/lib.analytics`, `@contractspec/lib.lifecycle`, `@contractspec/lib.observability`, `@contractspec/module.lifecycle-advisor`, `@contractspec/module.lifecycle-core`, ...
+- `src/services/` contains business logic services and workflows.
 
+## Installation
 
+`npm install @contractspec/bundle.lifecycle-managed`
 
+or
 
+`bun add @contractspec/bundle.lifecycle-managed`
 
+## Usage
 
+Import the root entrypoint from `@contractspec/bundle.lifecycle-managed`, or choose a documented subpath when you only need one part of the package surface.
 
+## Architecture
 
+- `src/services/` -- assessment service (lifecycle evaluation logic).
+- `src/agents/` -- AI lifecycle advisor agent.
+- `src/events/` -- lifecycle domain events.
+- `src/api/` -- REST handler adapters.
+- `src/__tests__/` -- unit tests.
+- `src/index.ts` is the root public barrel and package entrypoint.
 
+## 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, build, and type errors across nine packages.
+- Add first-class transport, auth, versioning, and BYOK support across all integrations.
 
+## Notes
 
+- Depends on six workspace packages (`lib.ai-agent`, `lib.analytics`, `lib.lifecycle`, `lib.observability`, `module.lifecycle-advisor`, `module.lifecycle-core`); changes to those APIs propagate here.
+- Events must remain serializable for cross-service consumption.
+- Keep REST handlers thin; domain logic belongs in services.

package/dist/browser/index.js

@@ -1,133 +1,3 @@
-// src/services/assessment-service.ts
-import {
-  ProductPhase,
-  CompanyPhase,
-  CapitalPhase
-} from "@contractspec/lib.lifecycle";
-import {
-  LifecycleOrchestrator,
-  StageSignalCollector,
-  StageScorer,
-  LifecycleMilestonePlanner
-} from "@contractspec/module.lifecycle-core";
-import {
-  LifecycleRecommendationEngine,
-  ContractSpecLibraryRecommender,
-  LifecycleCeremonyDesigner
-} from "@contractspec/module.lifecycle-advisor";
-import {
-  LifecycleKpiPipeline
-} from "@contractspec/lib.observability";
-
-class LifecycleAssessmentService {
-  orchestrator;
-  recommendationEngine;
-  libraryRecommender;
-  ceremonyDesigner;
-  pipeline;
-  eventBridge;
-  constructor(options) {
-    const collector = new StageSignalCollector(options.collector);
-    const scorer = new StageScorer;
-    const milestonePlanner = new LifecycleMilestonePlanner;
-    this.orchestrator = new LifecycleOrchestrator({
-      collector,
-      scorer,
-      milestonePlanner
-    });
-    this.recommendationEngine = options.recommendationEngine ?? new LifecycleRecommendationEngine;
-    this.libraryRecommender = options.libraryRecommender ?? new ContractSpecLibraryRecommender;
-    this.ceremonyDesigner = options.ceremonyDesigner ?? new LifecycleCeremonyDesigner;
-    this.pipeline = options.pipeline ?? new LifecycleKpiPipeline;
-    this.eventBridge = options.eventBridge;
-    if (options.onPipelineEvent) {
-      this.pipeline.on(options.onPipelineEvent);
-    }
-    if (this.eventBridge) {
-      this.pipeline.on((event) => this.eventBridge?.forward(event));
-    }
-  }
-  async runAssessment(request) {
-    const assessment = await this.orchestrator.run(request);
-    const upcoming = this.orchestrator.getUpcomingMilestones(assessment.stage, request.completedMilestones);
-    this.pipeline.recordAssessment(assessment, request.tenantId);
-    const recommendation = this.recommendationEngine.generate(assessment, {
-      upcomingMilestones: upcoming
-    });
-    const libraries = this.libraryRecommender.recommend(assessment.stage);
-    const ceremony = this.ceremonyDesigner.design(assessment.stage);
-    return {
-      assessment,
-      recommendation,
-      libraries,
-      ceremony
-    };
-  }
-  getStagePlaybook(stage) {
-    const recommendation = this.recommendationEngine.generate({
-      stage,
-      confidence: 1,
-      axes: {
-        product: ProductPhase.Mvp,
-        company: CompanyPhase.TinyTeam,
-        capital: CapitalPhase.Seed
-      },
-      signals: [],
-      gaps: [],
-      focusAreas: [],
-      scorecard: [],
-      generatedAt: new Date().toISOString()
-    }, { upcomingMilestones: this.orchestrator.getUpcomingMilestones(stage) });
-    return {
-      recommendation,
-      libraries: this.libraryRecommender.recommend(stage),
-      ceremony: this.ceremonyDesigner.design(stage)
-    };
-  }
-}
-// src/events/lifecycle-events.ts
-import { lifecycleEventNames } from "@contractspec/lib.analytics";
-
-class LifecycleEventBridge {
-  publisher;
-  constructor(publisher) {
-    this.publisher = publisher;
-  }
-  forward(event) {
-    if (!this.publisher)
-      return;
-    switch (event.type) {
-      case "assessment.recorded":
-        this.publisher({
-          name: lifecycleEventNames.assessmentRun,
-          properties: {
-            tenantId: event.payload.tenantId,
-            stage: event.payload.stage
-          }
-        });
-        break;
-      case "stage.changed":
-        this.publisher({
-          name: lifecycleEventNames.stageChanged,
-          properties: {
-            tenantId: event.payload.tenantId,
-            previousStage: event.payload.previousStage,
-            nextStage: event.payload.nextStage
-          }
-        });
-        break;
-      case "confidence.low":
-        this.publisher({
-          name: `${lifecycleEventNames.assessmentRun}.low_confidence`,
-          properties: {
-            tenantId: event.payload.tenantId,
-            confidence: event.payload.confidence
-          }
-        });
-        break;
-    }
-  }
-}
 // src/agents/lifecycle-advisor-agent.ts
 import { defineAgent } from "@contractspec/lib.ai-agent/spec";
 var LifecycleAdvisorAgent = defineAgent({
@@ -209,6 +79,136 @@ var createLifecycleHandlers = (service) => ({
     return { status: 200, body: result };
   }
 });
+// src/events/lifecycle-events.ts
+import { lifecycleEventNames } from "@contractspec/lib.analytics";
+
+class LifecycleEventBridge {
+  publisher;
+  constructor(publisher) {
+    this.publisher = publisher;
+  }
+  forward(event) {
+    if (!this.publisher)
+      return;
+    switch (event.type) {
+      case "assessment.recorded":
+        this.publisher({
+          name: lifecycleEventNames.assessmentRun,
+          properties: {
+            tenantId: event.payload.tenantId,
+            stage: event.payload.stage
+          }
+        });
+        break;
+      case "stage.changed":
+        this.publisher({
+          name: lifecycleEventNames.stageChanged,
+          properties: {
+            tenantId: event.payload.tenantId,
+            previousStage: event.payload.previousStage,
+            nextStage: event.payload.nextStage
+          }
+        });
+        break;
+      case "confidence.low":
+        this.publisher({
+          name: `${lifecycleEventNames.assessmentRun}.low_confidence`,
+          properties: {
+            tenantId: event.payload.tenantId,
+            confidence: event.payload.confidence
+          }
+        });
+        break;
+    }
+  }
+}
+// src/services/assessment-service.ts
+import {
+  CapitalPhase,
+  CompanyPhase,
+  ProductPhase
+} from "@contractspec/lib.lifecycle";
+import {
+  LifecycleKpiPipeline
+} from "@contractspec/lib.observability";
+import {
+  ContractSpecLibraryRecommender,
+  LifecycleCeremonyDesigner,
+  LifecycleRecommendationEngine
+} from "@contractspec/module.lifecycle-advisor";
+import {
+  LifecycleMilestonePlanner,
+  LifecycleOrchestrator,
+  StageScorer,
+  StageSignalCollector
+} from "@contractspec/module.lifecycle-core";
+
+class LifecycleAssessmentService {
+  orchestrator;
+  recommendationEngine;
+  libraryRecommender;
+  ceremonyDesigner;
+  pipeline;
+  eventBridge;
+  constructor(options) {
+    const collector = new StageSignalCollector(options.collector);
+    const scorer = new StageScorer;
+    const milestonePlanner = new LifecycleMilestonePlanner;
+    this.orchestrator = new LifecycleOrchestrator({
+      collector,
+      scorer,
+      milestonePlanner
+    });
+    this.recommendationEngine = options.recommendationEngine ?? new LifecycleRecommendationEngine;
+    this.libraryRecommender = options.libraryRecommender ?? new ContractSpecLibraryRecommender;
+    this.ceremonyDesigner = options.ceremonyDesigner ?? new LifecycleCeremonyDesigner;
+    this.pipeline = options.pipeline ?? new LifecycleKpiPipeline;
+    this.eventBridge = options.eventBridge;
+    if (options.onPipelineEvent) {
+      this.pipeline.on(options.onPipelineEvent);
+    }
+    if (this.eventBridge) {
+      this.pipeline.on((event) => this.eventBridge?.forward(event));
+    }
+  }
+  async runAssessment(request) {
+    const assessment = await this.orchestrator.run(request);
+    const upcoming = this.orchestrator.getUpcomingMilestones(assessment.stage, request.completedMilestones);
+    this.pipeline.recordAssessment(assessment, request.tenantId);
+    const recommendation = this.recommendationEngine.generate(assessment, {
+      upcomingMilestones: upcoming
+    });
+    const libraries = this.libraryRecommender.recommend(assessment.stage);
+    const ceremony = this.ceremonyDesigner.design(assessment.stage);
+    return {
+      assessment,
+      recommendation,
+      libraries,
+      ceremony
+    };
+  }
+  getStagePlaybook(stage) {
+    const recommendation = this.recommendationEngine.generate({
+      stage,
+      confidence: 1,
+      axes: {
+        product: ProductPhase.Mvp,
+        company: CompanyPhase.TinyTeam,
+        capital: CapitalPhase.Seed
+      },
+      signals: [],
+      gaps: [],
+      focusAreas: [],
+      scorecard: [],
+      generatedAt: new Date().toISOString()
+    }, { upcomingMilestones: this.orchestrator.getUpcomingMilestones(stage) });
+    return {
+      recommendation,
+      libraries: this.libraryRecommender.recommend(stage),
+      ceremony: this.ceremonyDesigner.design(stage)
+    };
+  }
+}
 export {
   createLifecycleHandlers,
   LifecycleEventBridge,

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export * from './services/assessment-service';
-export * from './events/lifecycle-events';
 export * from './agents/lifecycle-advisor-agent';
 export * from './api/rest-handlers';
+export * from './events/lifecycle-events';
+export * from './services/assessment-service';

package/dist/index.js

@@ -1,134 +1,4 @@
 // @bun
-// src/services/assessment-service.ts
-import {
-  ProductPhase,
-  CompanyPhase,
-  CapitalPhase
-} from "@contractspec/lib.lifecycle";
-import {
-  LifecycleOrchestrator,
-  StageSignalCollector,
-  StageScorer,
-  LifecycleMilestonePlanner
-} from "@contractspec/module.lifecycle-core";
-import {
-  LifecycleRecommendationEngine,
-  ContractSpecLibraryRecommender,
-  LifecycleCeremonyDesigner
-} from "@contractspec/module.lifecycle-advisor";
-import {
-  LifecycleKpiPipeline
-} from "@contractspec/lib.observability";
-
-class LifecycleAssessmentService {
-  orchestrator;
-  recommendationEngine;
-  libraryRecommender;
-  ceremonyDesigner;
-  pipeline;
-  eventBridge;
-  constructor(options) {
-    const collector = new StageSignalCollector(options.collector);
-    const scorer = new StageScorer;
-    const milestonePlanner = new LifecycleMilestonePlanner;
-    this.orchestrator = new LifecycleOrchestrator({
-      collector,
-      scorer,
-      milestonePlanner
-    });
-    this.recommendationEngine = options.recommendationEngine ?? new LifecycleRecommendationEngine;
-    this.libraryRecommender = options.libraryRecommender ?? new ContractSpecLibraryRecommender;
-    this.ceremonyDesigner = options.ceremonyDesigner ?? new LifecycleCeremonyDesigner;
-    this.pipeline = options.pipeline ?? new LifecycleKpiPipeline;
-    this.eventBridge = options.eventBridge;
-    if (options.onPipelineEvent) {
-      this.pipeline.on(options.onPipelineEvent);
-    }
-    if (this.eventBridge) {
-      this.pipeline.on((event) => this.eventBridge?.forward(event));
-    }
-  }
-  async runAssessment(request) {
-    const assessment = await this.orchestrator.run(request);
-    const upcoming = this.orchestrator.getUpcomingMilestones(assessment.stage, request.completedMilestones);
-    this.pipeline.recordAssessment(assessment, request.tenantId);
-    const recommendation = this.recommendationEngine.generate(assessment, {
-      upcomingMilestones: upcoming
-    });
-    const libraries = this.libraryRecommender.recommend(assessment.stage);
-    const ceremony = this.ceremonyDesigner.design(assessment.stage);
-    return {
-      assessment,
-      recommendation,
-      libraries,
-      ceremony
-    };
-  }
-  getStagePlaybook(stage) {
-    const recommendation = this.recommendationEngine.generate({
-      stage,
-      confidence: 1,
-      axes: {
-        product: ProductPhase.Mvp,
-        company: CompanyPhase.TinyTeam,
-        capital: CapitalPhase.Seed
-      },
-      signals: [],
-      gaps: [],
-      focusAreas: [],
-      scorecard: [],
-      generatedAt: new Date().toISOString()
-    }, { upcomingMilestones: this.orchestrator.getUpcomingMilestones(stage) });
-    return {
-      recommendation,
-      libraries: this.libraryRecommender.recommend(stage),
-      ceremony: this.ceremonyDesigner.design(stage)
-    };
-  }
-}
-// src/events/lifecycle-events.ts
-import { lifecycleEventNames } from "@contractspec/lib.analytics";
-
-class LifecycleEventBridge {
-  publisher;
-  constructor(publisher) {
-    this.publisher = publisher;
-  }
-  forward(event) {
-    if (!this.publisher)
-      return;
-    switch (event.type) {
-      case "assessment.recorded":
-        this.publisher({
-          name: lifecycleEventNames.assessmentRun,
-          properties: {
-            tenantId: event.payload.tenantId,
-            stage: event.payload.stage
-          }
-        });
-        break;
-      case "stage.changed":
-        this.publisher({
-          name: lifecycleEventNames.stageChanged,
-          properties: {
-            tenantId: event.payload.tenantId,
-            previousStage: event.payload.previousStage,
-            nextStage: event.payload.nextStage
-          }
-        });
-        break;
-      case "confidence.low":
-        this.publisher({
-          name: `${lifecycleEventNames.assessmentRun}.low_confidence`,
-          properties: {
-            tenantId: event.payload.tenantId,
-            confidence: event.payload.confidence
-          }
-        });
-        break;
-    }
-  }
-}
 // src/agents/lifecycle-advisor-agent.ts
 import { defineAgent } from "@contractspec/lib.ai-agent/spec";
 var LifecycleAdvisorAgent = defineAgent({
@@ -210,6 +80,136 @@ var createLifecycleHandlers = (service) => ({
     return { status: 200, body: result };
   }
 });
+// src/events/lifecycle-events.ts
+import { lifecycleEventNames } from "@contractspec/lib.analytics";
+
+class LifecycleEventBridge {
+  publisher;
+  constructor(publisher) {
+    this.publisher = publisher;
+  }
+  forward(event) {
+    if (!this.publisher)
+      return;
+    switch (event.type) {
+      case "assessment.recorded":
+        this.publisher({
+          name: lifecycleEventNames.assessmentRun,
+          properties: {
+            tenantId: event.payload.tenantId,
+            stage: event.payload.stage
+          }
+        });
+        break;
+      case "stage.changed":
+        this.publisher({
+          name: lifecycleEventNames.stageChanged,
+          properties: {
+            tenantId: event.payload.tenantId,
+            previousStage: event.payload.previousStage,
+            nextStage: event.payload.nextStage
+          }
+        });
+        break;
+      case "confidence.low":
+        this.publisher({
+          name: `${lifecycleEventNames.assessmentRun}.low_confidence`,
+          properties: {
+            tenantId: event.payload.tenantId,
+            confidence: event.payload.confidence
+          }
+        });
+        break;
+    }
+  }
+}
+// src/services/assessment-service.ts
+import {
+  CapitalPhase,
+  CompanyPhase,
+  ProductPhase
+} from "@contractspec/lib.lifecycle";
+import {
+  LifecycleKpiPipeline
+} from "@contractspec/lib.observability";
+import {
+  ContractSpecLibraryRecommender,
+  LifecycleCeremonyDesigner,
+  LifecycleRecommendationEngine
+} from "@contractspec/module.lifecycle-advisor";
+import {
+  LifecycleMilestonePlanner,
+  LifecycleOrchestrator,
+  StageScorer,
+  StageSignalCollector
+} from "@contractspec/module.lifecycle-core";
+
+class LifecycleAssessmentService {
+  orchestrator;
+  recommendationEngine;
+  libraryRecommender;
+  ceremonyDesigner;
+  pipeline;
+  eventBridge;
+  constructor(options) {
+    const collector = new StageSignalCollector(options.collector);
+    const scorer = new StageScorer;
+    const milestonePlanner = new LifecycleMilestonePlanner;
+    this.orchestrator = new LifecycleOrchestrator({
+      collector,
+      scorer,
+      milestonePlanner
+    });
+    this.recommendationEngine = options.recommendationEngine ?? new LifecycleRecommendationEngine;
+    this.libraryRecommender = options.libraryRecommender ?? new ContractSpecLibraryRecommender;
+    this.ceremonyDesigner = options.ceremonyDesigner ?? new LifecycleCeremonyDesigner;
+    this.pipeline = options.pipeline ?? new LifecycleKpiPipeline;
+    this.eventBridge = options.eventBridge;
+    if (options.onPipelineEvent) {
+      this.pipeline.on(options.onPipelineEvent);
+    }
+    if (this.eventBridge) {
+      this.pipeline.on((event) => this.eventBridge?.forward(event));
+    }
+  }
+  async runAssessment(request) {
+    const assessment = await this.orchestrator.run(request);
+    const upcoming = this.orchestrator.getUpcomingMilestones(assessment.stage, request.completedMilestones);
+    this.pipeline.recordAssessment(assessment, request.tenantId);
+    const recommendation = this.recommendationEngine.generate(assessment, {
+      upcomingMilestones: upcoming
+    });
+    const libraries = this.libraryRecommender.recommend(assessment.stage);
+    const ceremony = this.ceremonyDesigner.design(assessment.stage);
+    return {
+      assessment,
+      recommendation,
+      libraries,
+      ceremony
+    };
+  }
+  getStagePlaybook(stage) {
+    const recommendation = this.recommendationEngine.generate({
+      stage,
+      confidence: 1,
+      axes: {
+        product: ProductPhase.Mvp,
+        company: CompanyPhase.TinyTeam,
+        capital: CapitalPhase.Seed
+      },
+      signals: [],
+      gaps: [],
+      focusAreas: [],
+      scorecard: [],
+      generatedAt: new Date().toISOString()
+    }, { upcomingMilestones: this.orchestrator.getUpcomingMilestones(stage) });
+    return {
+      recommendation,
+      libraries: this.libraryRecommender.recommend(stage),
+      ceremony: this.ceremonyDesigner.design(stage)
+    };
+  }
+}
 export {
   createLifecycleHandlers,
   LifecycleEventBridge,

package/dist/node/index.js

@@ -1,133 +1,3 @@
-// src/services/assessment-service.ts
-import {
-  ProductPhase,
-  CompanyPhase,
-  CapitalPhase
-} from "@contractspec/lib.lifecycle";
-import {
-  LifecycleOrchestrator,
-  StageSignalCollector,
-  StageScorer,
-  LifecycleMilestonePlanner
-} from "@contractspec/module.lifecycle-core";
-import {
-  LifecycleRecommendationEngine,
-  ContractSpecLibraryRecommender,
-  LifecycleCeremonyDesigner
-} from "@contractspec/module.lifecycle-advisor";
-import {
-  LifecycleKpiPipeline
-} from "@contractspec/lib.observability";
-
-class LifecycleAssessmentService {
-  orchestrator;
-  recommendationEngine;
-  libraryRecommender;
-  ceremonyDesigner;
-  pipeline;
-  eventBridge;
-  constructor(options) {
-    const collector = new StageSignalCollector(options.collector);
-    const scorer = new StageScorer;
-    const milestonePlanner = new LifecycleMilestonePlanner;
-    this.orchestrator = new LifecycleOrchestrator({
-      collector,
-      scorer,
-      milestonePlanner
-    });
-    this.recommendationEngine = options.recommendationEngine ?? new LifecycleRecommendationEngine;
-    this.libraryRecommender = options.libraryRecommender ?? new ContractSpecLibraryRecommender;
-    this.ceremonyDesigner = options.ceremonyDesigner ?? new LifecycleCeremonyDesigner;
-    this.pipeline = options.pipeline ?? new LifecycleKpiPipeline;
-    this.eventBridge = options.eventBridge;
-    if (options.onPipelineEvent) {
-      this.pipeline.on(options.onPipelineEvent);
-    }
-    if (this.eventBridge) {
-      this.pipeline.on((event) => this.eventBridge?.forward(event));
-    }
-  }
-  async runAssessment(request) {
-    const assessment = await this.orchestrator.run(request);
-    const upcoming = this.orchestrator.getUpcomingMilestones(assessment.stage, request.completedMilestones);
-    this.pipeline.recordAssessment(assessment, request.tenantId);
-    const recommendation = this.recommendationEngine.generate(assessment, {
-      upcomingMilestones: upcoming
-    });
-    const libraries = this.libraryRecommender.recommend(assessment.stage);
-    const ceremony = this.ceremonyDesigner.design(assessment.stage);
-    return {
-      assessment,
-      recommendation,
-      libraries,
-      ceremony
-    };
-  }
-  getStagePlaybook(stage) {
-    const recommendation = this.recommendationEngine.generate({
-      stage,
-      confidence: 1,
-      axes: {
-        product: ProductPhase.Mvp,
-        company: CompanyPhase.TinyTeam,
-        capital: CapitalPhase.Seed
-      },
-      signals: [],
-      gaps: [],
-      focusAreas: [],
-      scorecard: [],
-      generatedAt: new Date().toISOString()
-    }, { upcomingMilestones: this.orchestrator.getUpcomingMilestones(stage) });
-    return {
-      recommendation,
-      libraries: this.libraryRecommender.recommend(stage),
-      ceremony: this.ceremonyDesigner.design(stage)
-    };
-  }
-}
-// src/events/lifecycle-events.ts
-import { lifecycleEventNames } from "@contractspec/lib.analytics";
-
-class LifecycleEventBridge {
-  publisher;
-  constructor(publisher) {
-    this.publisher = publisher;
-  }
-  forward(event) {
-    if (!this.publisher)
-      return;
-    switch (event.type) {
-      case "assessment.recorded":
-        this.publisher({
-          name: lifecycleEventNames.assessmentRun,
-          properties: {
-            tenantId: event.payload.tenantId,
-            stage: event.payload.stage
-          }
-        });
-        break;
-      case "stage.changed":
-        this.publisher({
-          name: lifecycleEventNames.stageChanged,
-          properties: {
-            tenantId: event.payload.tenantId,
-            previousStage: event.payload.previousStage,
-            nextStage: event.payload.nextStage
-          }
-        });
-        break;
-      case "confidence.low":
-        this.publisher({
-          name: `${lifecycleEventNames.assessmentRun}.low_confidence`,
-          properties: {
-            tenantId: event.payload.tenantId,
-            confidence: event.payload.confidence
-          }
-        });
-        break;
-    }
-  }
-}
 // src/agents/lifecycle-advisor-agent.ts
 import { defineAgent } from "@contractspec/lib.ai-agent/spec";
 var LifecycleAdvisorAgent = defineAgent({
@@ -209,6 +79,136 @@ var createLifecycleHandlers = (service) => ({
     return { status: 200, body: result };
   }
 });
+// src/events/lifecycle-events.ts
+import { lifecycleEventNames } from "@contractspec/lib.analytics";
+
+class LifecycleEventBridge {
+  publisher;
+  constructor(publisher) {
+    this.publisher = publisher;
+  }
+  forward(event) {
+    if (!this.publisher)
+      return;
+    switch (event.type) {
+      case "assessment.recorded":
+        this.publisher({
+          name: lifecycleEventNames.assessmentRun,
+          properties: {
+            tenantId: event.payload.tenantId,
+            stage: event.payload.stage
+          }
+        });
+        break;
+      case "stage.changed":
+        this.publisher({
+          name: lifecycleEventNames.stageChanged,
+          properties: {
+            tenantId: event.payload.tenantId,
+            previousStage: event.payload.previousStage,
+            nextStage: event.payload.nextStage
+          }
+        });
+        break;
+      case "confidence.low":
+        this.publisher({
+          name: `${lifecycleEventNames.assessmentRun}.low_confidence`,
+          properties: {
+            tenantId: event.payload.tenantId,
+            confidence: event.payload.confidence
+          }
+        });
+        break;
+    }
+  }
+}
+// src/services/assessment-service.ts
+import {
+  CapitalPhase,
+  CompanyPhase,
+  ProductPhase
+} from "@contractspec/lib.lifecycle";
+import {
+  LifecycleKpiPipeline
+} from "@contractspec/lib.observability";
+import {
+  ContractSpecLibraryRecommender,
+  LifecycleCeremonyDesigner,
+  LifecycleRecommendationEngine
+} from "@contractspec/module.lifecycle-advisor";
+import {
+  LifecycleMilestonePlanner,
+  LifecycleOrchestrator,
+  StageScorer,
+  StageSignalCollector
+} from "@contractspec/module.lifecycle-core";
+
+class LifecycleAssessmentService {
+  orchestrator;
+  recommendationEngine;
+  libraryRecommender;
+  ceremonyDesigner;
+  pipeline;
+  eventBridge;
+  constructor(options) {
+    const collector = new StageSignalCollector(options.collector);
+    const scorer = new StageScorer;
+    const milestonePlanner = new LifecycleMilestonePlanner;
+    this.orchestrator = new LifecycleOrchestrator({
+      collector,
+      scorer,
+      milestonePlanner
+    });
+    this.recommendationEngine = options.recommendationEngine ?? new LifecycleRecommendationEngine;
+    this.libraryRecommender = options.libraryRecommender ?? new ContractSpecLibraryRecommender;
+    this.ceremonyDesigner = options.ceremonyDesigner ?? new LifecycleCeremonyDesigner;
+    this.pipeline = options.pipeline ?? new LifecycleKpiPipeline;
+    this.eventBridge = options.eventBridge;
+    if (options.onPipelineEvent) {
+      this.pipeline.on(options.onPipelineEvent);
+    }
+    if (this.eventBridge) {
+      this.pipeline.on((event) => this.eventBridge?.forward(event));
+    }
+  }
+  async runAssessment(request) {
+    const assessment = await this.orchestrator.run(request);
+    const upcoming = this.orchestrator.getUpcomingMilestones(assessment.stage, request.completedMilestones);
+    this.pipeline.recordAssessment(assessment, request.tenantId);
+    const recommendation = this.recommendationEngine.generate(assessment, {
+      upcomingMilestones: upcoming
+    });
+    const libraries = this.libraryRecommender.recommend(assessment.stage);
+    const ceremony = this.ceremonyDesigner.design(assessment.stage);
+    return {
+      assessment,
+      recommendation,
+      libraries,
+      ceremony
+    };
+  }
+  getStagePlaybook(stage) {
+    const recommendation = this.recommendationEngine.generate({
+      stage,
+      confidence: 1,
+      axes: {
+        product: ProductPhase.Mvp,
+        company: CompanyPhase.TinyTeam,
+        capital: CapitalPhase.Seed
+      },
+      signals: [],
+      gaps: [],
+      focusAreas: [],
+      scorecard: [],
+      generatedAt: new Date().toISOString()
+    }, { upcomingMilestones: this.orchestrator.getUpcomingMilestones(stage) });
+    return {
+      recommendation,
+      libraries: this.libraryRecommender.recommend(stage),
+      ceremony: this.ceremonyDesigner.design(stage)
+    };
+  }
+}
 export {
   createLifecycleHandlers,
   LifecycleEventBridge,

package/dist/services/assessment-service.d.ts

@@ -1,7 +1,7 @@
 import type { LifecycleAssessment, LifecycleAssessmentInput, LifecycleRecommendation, LifecycleStage } from '@contractspec/lib.lifecycle';
-import { type StageSignalCollectorOptions } from '@contractspec/module.lifecycle-core';
-import { LifecycleRecommendationEngine, ContractSpecLibraryRecommender, LifecycleCeremonyDesigner } from '@contractspec/module.lifecycle-advisor';
 import { LifecycleKpiPipeline, type LifecyclePipelineEvent } from '@contractspec/lib.observability';
+import { ContractSpecLibraryRecommender, LifecycleCeremonyDesigner, LifecycleRecommendationEngine } from '@contractspec/module.lifecycle-advisor';
+import { type StageSignalCollectorOptions } from '@contractspec/module.lifecycle-core';
 import { LifecycleEventBridge } from '../events/lifecycle-events';
 export interface LifecycleAssessmentRequest extends LifecycleAssessmentInput {
     tenantId?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/bundle.lifecycle-managed",
-  "version": "3.7.6",
+  "version": "3.7.7",
   "description": "Lifecycle management bundle with analytics and AI advisor",
   "keywords": [
     "contractspec",
@@ -25,19 +25,19 @@
     "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
-    "lint:fix": "eslint src --fix",
-    "lint:check": "eslint src",
+    "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
+    "lint:check": "biome check .",
     "test": "bun test",
     "prebuild": "contractspec-bun-build prebuild",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.ai-agent": "7.0.6",
-    "@contractspec/lib.analytics": "3.7.6",
-    "@contractspec/lib.lifecycle": "3.7.6",
-    "@contractspec/lib.observability": "3.7.6",
-    "@contractspec/module.lifecycle-advisor": "3.7.6",
-    "@contractspec/module.lifecycle-core": "3.7.6"
+    "@contractspec/lib.ai-agent": "7.0.7",
+    "@contractspec/lib.analytics": "3.7.7",
+    "@contractspec/lib.lifecycle": "3.7.7",
+    "@contractspec/lib.observability": "3.7.7",
+    "@contractspec/module.lifecycle-advisor": "3.7.7",
+    "@contractspec/module.lifecycle-core": "3.7.7"
   },
   "devDependencies": {
     "@contractspec/tool.typescript": "3.7.6",