@contractspec/bundle.lifecycle-managed 1.44.0

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

@@ -0,0 +1,65 @@
+# @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
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

package/dist/agents/lifecycle-advisor-agent.d.ts

@@ -0,0 +1,8 @@
+import { AgentSpec } from "../libs/ai-agent/src/spec/spec.js";
+import "../libs/ai-agent/src/index.js";
+
+//#region src/agents/lifecycle-advisor-agent.d.ts
+declare const LifecycleAdvisorAgent: AgentSpec;
+//#endregion
+export { LifecycleAdvisorAgent };
+//# sourceMappingURL=lifecycle-advisor-agent.d.ts.map

package/dist/agents/lifecycle-advisor-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-advisor-agent.d.ts","names":[],"sources":["../../src/agents/lifecycle-advisor-agent.ts"],"sourcesContent":[],"mappings":";;;;cAEa,uBAgEX"}

package/dist/agents/lifecycle-advisor-agent.js

@@ -0,0 +1,71 @@
+import { defineAgent } from "@contractspec/lib.ai-agent";
+
+//#region src/agents/lifecycle-advisor-agent.ts
+const LifecycleAdvisorAgent = defineAgent({
+	meta: {
+		key: "lifecycle.advisor",
+		version: 1,
+		title: "Lifecycle Advisor Agent",
+		description: "Guides artisans through lifecycle detection, focus areas, and ceremonies.",
+		owners: ["team-lifecycle"],
+		domain: "operations",
+		tags: [
+			"guide",
+			"lifecycle",
+			"ops"
+		],
+		stability: "experimental"
+	},
+	description: "Guides users through lifecycle assessments, highlights gaps, and recommends actions tied to ContractSpec libraries.",
+	instructions: `You are the Lifecycle Advisor. Always clarify the user's current stage, confidence, and blockers before suggesting actions.
+- Prioritize simple, mobile-friendly instructions.
+- When in early stages, focus on learning loops, not heavy infra.
+- When in later stages, emphasize repeatability, telemetry, and managed ceremonies.
+- Suggest at most 3 actions at a time. Reference ContractSpec libraries or modules when relevant.`,
+	tools: [{
+		name: "run_assessment",
+		description: "Trigger a lifecycle assessment for a tenant.",
+		schema: {
+			type: "object",
+			properties: {
+				tenantId: { type: "string" },
+				questionnaire: {
+					type: "object",
+					additionalProperties: true
+				}
+			},
+			required: ["tenantId"]
+		},
+		automationSafe: true
+	}, {
+		name: "fetch_playbook",
+		description: "Retrieve stage-specific playbook (actions, ceremonies, libraries).",
+		schema: {
+			type: "object",
+			properties: { stage: {
+				type: "integer",
+				minimum: 0,
+				maximum: 6,
+				description: "Lifecycle stage number (0-6)"
+			} },
+			required: ["stage"]
+		},
+		automationSafe: true
+	}],
+	memory: {
+		maxEntries: 25,
+		ttlMinutes: 120
+	},
+	policy: {
+		confidence: { min: .7 },
+		escalation: {
+			confidenceThreshold: .5,
+			approvalWorkflow: "ops.lifecycle.escalation"
+		},
+		flags: ["lifecycle_advisor"]
+	}
+});
+
+//#endregion
+export { LifecycleAdvisorAgent };
+//# sourceMappingURL=lifecycle-advisor-agent.js.map

package/dist/agents/lifecycle-advisor-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-advisor-agent.js","names":[],"sources":["../../src/agents/lifecycle-advisor-agent.ts"],"sourcesContent":["import { defineAgent } from '@contractspec/lib.ai-agent';\n\nexport const LifecycleAdvisorAgent = defineAgent({\n  meta: {\n    key: 'lifecycle.advisor',\n    version: 1,\n    title: 'Lifecycle Advisor Agent',\n    description:\n      'Guides artisans through lifecycle detection, focus areas, and ceremonies.',\n    owners: ['team-lifecycle'],\n    domain: 'operations',\n    tags: ['guide', 'lifecycle', 'ops'],\n    stability: 'experimental',\n  },\n  description:\n    'Guides users through lifecycle assessments, highlights gaps, and recommends actions tied to ContractSpec libraries.',\n  instructions: `You are the Lifecycle Advisor. Always clarify the user's current stage, confidence, and blockers before suggesting actions.\n- Prioritize simple, mobile-friendly instructions.\n- When in early stages, focus on learning loops, not heavy infra.\n- When in later stages, emphasize repeatability, telemetry, and managed ceremonies.\n- Suggest at most 3 actions at a time. Reference ContractSpec libraries or modules when relevant.`,\n  tools: [\n    {\n      name: 'run_assessment',\n      description: 'Trigger a lifecycle assessment for a tenant.',\n      schema: {\n        type: 'object',\n        properties: {\n          tenantId: { type: 'string' },\n          questionnaire: { type: 'object', additionalProperties: true },\n        },\n        required: ['tenantId'],\n      },\n      automationSafe: true,\n    },\n    {\n      name: 'fetch_playbook',\n      description:\n        'Retrieve stage-specific playbook (actions, ceremonies, libraries).',\n      schema: {\n        type: 'object',\n        properties: {\n          stage: {\n            type: 'integer',\n            minimum: 0,\n            maximum: 6,\n            description: 'Lifecycle stage number (0-6)',\n          },\n        },\n        required: ['stage'],\n      },\n      automationSafe: true,\n    },\n  ],\n  memory: {\n    maxEntries: 25,\n    ttlMinutes: 120,\n  },\n  policy: {\n    confidence: { min: 0.7 },\n    escalation: {\n      confidenceThreshold: 0.5,\n      approvalWorkflow: 'ops.lifecycle.escalation',\n    },\n    flags: ['lifecycle_advisor'],\n  },\n});\n"],"mappings":";;;AAEA,MAAa,wBAAwB,YAAY;CAC/C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ,CAAC,iBAAiB;EAC1B,QAAQ;EACR,MAAM;GAAC;GAAS;GAAa;GAAM;EACnC,WAAW;EACZ;CACD,aACE;CACF,cAAc;;;;;CAKd,OAAO,CACL;EACE,MAAM;EACN,aAAa;EACb,QAAQ;GACN,MAAM;GACN,YAAY;IACV,UAAU,EAAE,MAAM,UAAU;IAC5B,eAAe;KAAE,MAAM;KAAU,sBAAsB;KAAM;IAC9D;GACD,UAAU,CAAC,WAAW;GACvB;EACD,gBAAgB;EACjB,EACD;EACE,MAAM;EACN,aACE;EACF,QAAQ;GACN,MAAM;GACN,YAAY,EACV,OAAO;IACL,MAAM;IACN,SAAS;IACT,SAAS;IACT,aAAa;IACd,EACF;GACD,UAAU,CAAC,QAAQ;GACpB;EACD,gBAAgB;EACjB,CACF;CACD,QAAQ;EACN,YAAY;EACZ,YAAY;EACb;CACD,QAAQ;EACN,YAAY,EAAE,KAAK,IAAK;EACxB,YAAY;GACV,qBAAqB;GACrB,kBAAkB;GACnB;EACD,OAAO,CAAC,oBAAoB;EAC7B;CACF,CAAC"}

package/dist/api/rest-handlers.d.ts

@@ -0,0 +1,21 @@
+import { LifecycleAssessmentRequest, LifecycleAssessmentResponse, LifecycleAssessmentService } from "../services/assessment-service.js";
+
+//#region src/api/rest-handlers.d.ts
+interface HttpRequest<TBody = unknown, TParams = Record<string, string>> {
+  body?: TBody;
+  params?: TParams;
+  query?: Record<string, string | undefined>;
+}
+interface HttpResponse<T = Record<string, unknown>> {
+  status: number;
+  body: T;
+}
+declare const createLifecycleHandlers: (service: LifecycleAssessmentService) => {
+  runAssessment: (req: HttpRequest<LifecycleAssessmentRequest>) => Promise<HttpResponse<LifecycleAssessmentResponse>>;
+  getPlaybook: (req: HttpRequest<unknown, {
+    stage: string;
+  }>) => Promise<HttpResponse>;
+};
+//#endregion
+export { HttpRequest, HttpResponse, createLifecycleHandlers };
+//# sourceMappingURL=rest-handlers.d.ts.map

package/dist/api/rest-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-handlers.d.ts","names":[],"sources":["../../src/api/rest-handlers.ts"],"sourcesContent":[],"mappings":";;;UAOiB,uCAEL;EAFK,IAAA,CAAA,EAIR,KAJQ;EAEL,MAAA,CAAA,EAGD,OAHC;EAEH,KAAA,CAAA,EAEC,MAFD,CAAA,MAAA,EAAA,MAAA,GAAA,SAAA,CAAA;;AAEC,UAGO,YAHP,CAAA,IAGwB,MAHxB,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,CAAA;EAAM,MAAA,EAAA,MAAA;EAGC,IAAA,EAET,CAFS;AAKjB;AACW,cADE,uBACF,EAAA,CAAA,OAAA,EAAA,0BAAA,EAAA,GAAA;EAGU,aAAA,EAAA,CAAA,GAAA,EAAZ,WAAY,CAAA,0BAAA,CAAA,EAAA,GAChB,OADgB,CACR,YADQ,CACK,2BADL,CAAA,CAAA;EAAZ,WAAA,EAAA,CAAA,GAAA,EAOA,WAPA,CAAA,OAAA,EAAA;IACiB,KAAA,EAAA,MAAA;EAAb,CAAA,CAAA,EAAA,GAOR,OAPQ,CAOA,YAPA,CAAA;CAAR"}

package/dist/api/rest-handlers.js

@@ -0,0 +1,23 @@
+import "../services/assessment-service.js";
+
+//#region src/api/rest-handlers.ts
+const createLifecycleHandlers = (service) => ({
+	runAssessment: async (req) => {
+		const payload = req.body ?? {};
+		return {
+			status: 200,
+			body: await service.runAssessment(payload)
+		};
+	},
+	getPlaybook: async (req) => {
+		const stage = Number(req.params?.stage ?? 0);
+		return {
+			status: 200,
+			body: service.getStagePlaybook(stage)
+		};
+	}
+});
+
+//#endregion
+export { createLifecycleHandlers };
+//# sourceMappingURL=rest-handlers.js.map

package/dist/api/rest-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-handlers.js","names":[],"sources":["../../src/api/rest-handlers.ts"],"sourcesContent":["import type { LifecycleStage } from '@contractspec/lib.lifecycle';\nimport type {\n  LifecycleAssessmentRequest,\n  LifecycleAssessmentResponse,\n} from '../services/assessment-service';\nimport { LifecycleAssessmentService } from '../services/assessment-service';\n\nexport interface HttpRequest<\n  TBody = unknown,\n  TParams = Record<string, string>,\n> {\n  body?: TBody;\n  params?: TParams;\n  query?: Record<string, string | undefined>;\n}\n\nexport interface HttpResponse<T = Record<string, unknown>> {\n  status: number;\n  body: T;\n}\n\nexport const createLifecycleHandlers = (\n  service: LifecycleAssessmentService\n) => ({\n  runAssessment: async (\n    req: HttpRequest<LifecycleAssessmentRequest>\n  ): Promise<HttpResponse<LifecycleAssessmentResponse>> => {\n    const payload = req.body ?? {};\n    const result = await service.runAssessment(payload);\n    return { status: 200, body: result };\n  },\n  getPlaybook: async (\n    req: HttpRequest<unknown, { stage: string }>\n  ): Promise<HttpResponse> => {\n    const stage = Number(req.params?.stage ?? 0) as LifecycleStage;\n    const result = service.getStagePlaybook(stage);\n    return { status: 200, body: result };\n  },\n});\n"],"mappings":";;;AAqBA,MAAa,2BACX,aACI;CACJ,eAAe,OACb,QACuD;EACvD,MAAM,UAAU,IAAI,QAAQ,EAAE;AAE9B,SAAO;GAAE,QAAQ;GAAK,MADP,MAAM,QAAQ,cAAc,QAAQ;GACf;;CAEtC,aAAa,OACX,QAC0B;EAC1B,MAAM,QAAQ,OAAO,IAAI,QAAQ,SAAS,EAAE;AAE5C,SAAO;GAAE,QAAQ;GAAK,MADP,QAAQ,iBAAiB,MAAM;GACV;;CAEvC"}

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

@@ -0,0 +1,16 @@
+import { LifecyclePipelineEvent } from "@contractspec/lib.observability";
+
+//#region src/events/lifecycle-events.d.ts
+interface ManagedLifecycleEvent {
+  name: string;
+  properties: Record<string, unknown>;
+}
+type LifecycleEventPublisher = (event: ManagedLifecycleEvent) => Promise<void> | void;
+declare class LifecycleEventBridge {
+  private readonly publisher?;
+  constructor(publisher?: LifecycleEventPublisher | undefined);
+  forward(event: LifecyclePipelineEvent): void;
+}
+//#endregion
+export { LifecycleEventBridge, LifecycleEventPublisher, ManagedLifecycleEvent };
+//# sourceMappingURL=lifecycle-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-events.d.ts","names":[],"sources":["../../src/events/lifecycle-events.ts"],"sourcesContent":[],"mappings":";;;UAGiB,qBAAA;;EAAA,UAAA,EAEH,MAFG,CAAA,MAAqB,EAAA,OAAA,CAExB;AAGd;AAIa,KAJD,uBAAA,GAK+B,CAAA,KAAA,EAJlC,qBAMQ,EAAA,GALZ,OAKY,CAAA,IAAA,CAAA,GAAsB,IAAA;cAH1B,oBAAA;;0BAC8B;iBAE1B"}

package/dist/events/lifecycle-events.js

@@ -0,0 +1,45 @@
+import { lifecycleEventNames } from "@contractspec/lib.analytics";
+
+//#region src/events/lifecycle-events.ts
+var LifecycleEventBridge = class {
+	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;
+		}
+	}
+};
+
+//#endregion
+export { LifecycleEventBridge };
+//# sourceMappingURL=lifecycle-events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-events.js","names":["publisher?: LifecycleEventPublisher"],"sources":["../../src/events/lifecycle-events.ts"],"sourcesContent":["import type { LifecyclePipelineEvent } from '@contractspec/lib.observability';\nimport { lifecycleEventNames } from '@contractspec/lib.analytics';\n\nexport interface ManagedLifecycleEvent {\n  name: string;\n  properties: Record<string, unknown>;\n}\n\nexport type LifecycleEventPublisher = (\n  event: ManagedLifecycleEvent\n) => Promise<void> | void;\n\nexport class LifecycleEventBridge {\n  constructor(private readonly publisher?: LifecycleEventPublisher) {}\n\n  forward(event: LifecyclePipelineEvent) {\n    if (!this.publisher) return;\n    switch (event.type) {\n      case 'assessment.recorded':\n        this.publisher({\n          name: lifecycleEventNames.assessmentRun,\n          properties: {\n            tenantId: event.payload.tenantId,\n            stage: event.payload.stage,\n          },\n        });\n        break;\n      case 'stage.changed':\n        this.publisher({\n          name: lifecycleEventNames.stageChanged,\n          properties: {\n            tenantId: event.payload.tenantId,\n            previousStage: event.payload.previousStage,\n            nextStage: event.payload.nextStage,\n          },\n        });\n        break;\n      case 'confidence.low':\n        this.publisher({\n          name: `${lifecycleEventNames.assessmentRun}.low_confidence`,\n          properties: {\n            tenantId: event.payload.tenantId,\n            confidence: event.payload.confidence,\n          },\n        });\n        break;\n    }\n  }\n}\n"],"mappings":";;;AAYA,IAAa,uBAAb,MAAkC;CAChC,YAAY,AAAiBA,WAAqC;EAArC;;CAE7B,QAAQ,OAA+B;AACrC,MAAI,CAAC,KAAK,UAAW;AACrB,UAAQ,MAAM,MAAd;GACE,KAAK;AACH,SAAK,UAAU;KACb,MAAM,oBAAoB;KAC1B,YAAY;MACV,UAAU,MAAM,QAAQ;MACxB,OAAO,MAAM,QAAQ;MACtB;KACF,CAAC;AACF;GACF,KAAK;AACH,SAAK,UAAU;KACb,MAAM,oBAAoB;KAC1B,YAAY;MACV,UAAU,MAAM,QAAQ;MACxB,eAAe,MAAM,QAAQ;MAC7B,WAAW,MAAM,QAAQ;MAC1B;KACF,CAAC;AACF;GACF,KAAK;AACH,SAAK,UAAU;KACb,MAAM,GAAG,oBAAoB,cAAc;KAC3C,YAAY;MACV,UAAU,MAAM,QAAQ;MACxB,YAAY,MAAM,QAAQ;MAC3B;KACF,CAAC;AACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { LifecycleEventBridge, LifecycleEventPublisher, ManagedLifecycleEvent } from "./events/lifecycle-events.js";
+import { LifecycleAssessmentRequest, LifecycleAssessmentResponse, LifecycleAssessmentService, LifecycleAssessmentServiceOptions } from "./services/assessment-service.js";
+import { LifecycleAdvisorAgent } from "./agents/lifecycle-advisor-agent.js";
+import { HttpRequest, HttpResponse, createLifecycleHandlers } from "./api/rest-handlers.js";
+export { HttpRequest, HttpResponse, LifecycleAdvisorAgent, LifecycleAssessmentRequest, LifecycleAssessmentResponse, LifecycleAssessmentService, LifecycleAssessmentServiceOptions, LifecycleEventBridge, LifecycleEventPublisher, ManagedLifecycleEvent, createLifecycleHandlers };

package/dist/index.js

@@ -0,0 +1,6 @@
+import { LifecycleEventBridge } from "./events/lifecycle-events.js";
+import { LifecycleAssessmentService } from "./services/assessment-service.js";
+import { LifecycleAdvisorAgent } from "./agents/lifecycle-advisor-agent.js";
+import { createLifecycleHandlers } from "./api/rest-handlers.js";
+
+export { LifecycleAdvisorAgent, LifecycleAssessmentService, LifecycleEventBridge, createLifecycleHandlers };

package/dist/libs/ai-agent/src/agent/agent-factory.d.ts

@@ -0,0 +1,7 @@
+import "../spec/spec.js";
+import "../types.js";
+import "../session/store.js";
+import "../telemetry/adapter.js";
+import "./contract-spec-agent.js";
+import "../spec/registry.js";
+import "ai";

package/dist/libs/ai-agent/src/agent/contract-spec-agent.d.ts

@@ -0,0 +1,5 @@
+import "../spec/spec.js";
+import "../types.js";
+import "../session/store.js";
+import "../telemetry/adapter.js";
+import "ai";

package/dist/libs/ai-agent/src/agent/index.d.ts

@@ -0,0 +1,2 @@
+import "./contract-spec-agent.js";
+import "./agent-factory.js";

package/dist/libs/ai-agent/src/approval/index.d.ts

@@ -0,0 +1 @@
+import "./workflow.js";

package/dist/libs/ai-agent/src/approval/workflow.d.ts

@@ -0,0 +1 @@
+import "../types.js";

package/dist/libs/ai-agent/src/index.d.ts

@@ -0,0 +1,11 @@
+import { AgentConfidencePolicy, AgentEscalationPolicy, AgentKnowledgeRef, AgentMemoryConfig, AgentMeta, AgentPolicy, AgentSpec, AgentToolConfig } from "./spec/spec.js";
+import "./types.js";
+import "./agent/index.js";
+import "./spec/index.js";
+import "./tools/index.js";
+import "./schema/index.js";
+import "./knowledge/index.js";
+import "./session/index.js";
+import "./telemetry/index.js";
+import "./approval/index.js";
+import "ai";

package/dist/libs/ai-agent/src/knowledge/index.d.ts

@@ -0,0 +1 @@
+import "./injector.js";

package/dist/libs/ai-agent/src/knowledge/injector.d.ts

@@ -0,0 +1 @@
+import "../spec/spec.js";

package/dist/libs/ai-agent/src/schema/index.d.ts

@@ -0,0 +1,2 @@
+import "./json-schema-to-zod.js";
+import "./schema-output.js";

package/dist/libs/ai-agent/src/schema/json-schema-to-zod.d.ts

@@ -0,0 +1 @@
+import "zod";

package/dist/libs/ai-agent/src/schema/schema-output.d.ts

@@ -0,0 +1,2 @@
+import "ai";
+import "zod";

package/dist/libs/ai-agent/src/session/index.d.ts

@@ -0,0 +1 @@
+import "./store.js";

package/dist/libs/ai-agent/src/session/store.d.ts

@@ -0,0 +1,2 @@
+import "../types.js";
+import "ai";

package/dist/libs/ai-agent/src/spec/index.d.ts

@@ -0,0 +1,2 @@
+import { AgentConfidencePolicy, AgentEscalationPolicy, AgentKnowledgeRef, AgentMemoryConfig, AgentMeta, AgentPolicy, AgentSpec, AgentToolConfig } from "./spec.js";
+import "./registry.js";

package/dist/libs/ai-agent/src/spec/registry.d.ts

@@ -0,0 +1 @@
+import "./spec.js";

package/dist/libs/ai-agent/src/spec/spec.d.ts

@@ -0,0 +1,115 @@
+import { OwnerShipMeta } from "../../../contracts/src/ownership.js";
+import { PolicyRef } from "../../../contracts/src/policy/spec.js";
+import { KnowledgeCategory } from "../../../contracts/src/knowledge/spec.js";
+
+//#region ../../libs/ai-agent/src/spec/spec.d.ts
+
+/**
+ * Metadata for an agent specification.
+ */
+type AgentMeta = OwnerShipMeta;
+/**
+ * Configuration for a tool that an agent can use.
+ */
+interface AgentToolConfig {
+  /** Tool name (unique within the agent) */
+  name: string;
+  /** Human-readable description for the LLM */
+  description?: string;
+  /** JSON Schema fragment for tool parameters */
+  schema?: Record<string, unknown>;
+  /** Optional cooldown in milliseconds between invocations */
+  cooldownMs?: number;
+  /** Maximum execution time before timeout */
+  timeoutMs?: number;
+  /** Whether the tool can be executed without human approval (AI SDK needsApproval = !automationSafe) */
+  automationSafe?: boolean;
+  /** Explicit approval requirement (overrides automationSafe) */
+  requiresApproval?: boolean;
+  /** Optional policy guard that must evaluate to allow the tool call */
+  policy?: PolicyRef;
+}
+/**
+ * Reference to a knowledge space that the agent can access.
+ */
+interface AgentKnowledgeRef {
+  /** Knowledge space key */
+  key: string;
+  /** Optional specific version */
+  version?: number;
+  /** Filter by knowledge category */
+  category?: KnowledgeCategory;
+  /** Whether the knowledge is required (static injection) or optional (dynamic RAG) */
+  required?: boolean;
+  /** Additional instructions appended when the space is available */
+  instructions?: string;
+}
+/**
+ * Memory configuration for agent session persistence.
+ */
+interface AgentMemoryConfig {
+  /** Maximum entries to keep in memory */
+  maxEntries?: number;
+  /** Time-to-live in minutes */
+  ttlMinutes?: number;
+  /** Number of messages before triggering summarization */
+  summaryTrigger?: number;
+  /** Whether to persist to long-term storage */
+  persistLongTerm?: boolean;
+}
+/**
+ * Confidence policy for agent responses.
+ */
+interface AgentConfidencePolicy {
+  /** Minimum acceptable confidence before escalation. Defaults to 0.7 */
+  min?: number;
+  /** Default value used when provider does not report confidence */
+  default?: number;
+}
+/**
+ * Escalation policy for handling uncertain or failed agent responses.
+ */
+interface AgentEscalationPolicy {
+  /** Auto escalate when confidence < threshold */
+  confidenceThreshold?: number;
+  /** Escalate when a tool throws irrecoverable errors */
+  onToolFailure?: boolean;
+  /** Escalate when iteration budget exceeded */
+  onTimeout?: boolean;
+  /** Optional human approval workflow ID */
+  approvalWorkflow?: string;
+}
+/**
+ * Combined policy configuration for an agent.
+ */
+interface AgentPolicy {
+  confidence?: AgentConfidencePolicy;
+  escalation?: AgentEscalationPolicy;
+  /** Feature flags to apply to this agent */
+  flags?: string[];
+}
+/**
+ * Complete specification for a ContractSpec agent.
+ */
+interface AgentSpec {
+  meta: AgentMeta;
+  /** System instructions for the agent */
+  instructions: string;
+  /** Human-readable description */
+  description?: string;
+  /** Tags for categorization */
+  tags?: string[];
+  /** Tools the agent can use */
+  tools: AgentToolConfig[];
+  /** Memory/session configuration */
+  memory?: AgentMemoryConfig;
+  /** Knowledge spaces the agent can access */
+  knowledge?: AgentKnowledgeRef[];
+  /** Policy configuration */
+  policy?: AgentPolicy;
+  /** Maximum steps per generation (defaults to 10) */
+  maxSteps?: number;
+}
+//#endregion
+export { AgentConfidencePolicy, AgentEscalationPolicy, AgentKnowledgeRef, AgentMemoryConfig, AgentMeta, AgentPolicy, AgentSpec, AgentToolConfig };
+//# sourceMappingURL=spec.d.ts.map

package/dist/libs/ai-agent/src/spec/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../../../libs/ai-agent/src/spec/spec.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAOA;AAKiB,KALL,SAAA,GAAY,aAWb;AAgBX;AAgBA;AAcA;AAUiB,UA9DA,eAAA,CA8DqB;EAcrB;EAUA,IAAA,EAAA,MAAS;EAClB;EAQC,WAAA,CAAA,EAAA,MAAA;EAEE;EAEG,MAAA,CAAA,EA7FH,MA6FG,CAAA,MAAA,EAAA,OAAA,CAAA;EAEH;EAAW,UAAA,CAAA,EAAA,MAAA;;;;;;;;WArFX;;;;;UAMM,iBAAA;;;;;;aAMJ;;;;;;;;;UAUI,iBAAA;;;;;;;;;;;;;UAcA,qBAAA;;;;;;;;;UAUA,qBAAA;;;;;;;;;;;;;UAcA,WAAA;eACF;eACA;;;;;;;UAQE,SAAA;QACT;;;;;;;;SAQC;;WAEE;;cAEG;;WAEH"}

package/dist/libs/ai-agent/src/telemetry/adapter.d.ts

@@ -0,0 +1 @@
+import "ai";

package/dist/libs/ai-agent/src/telemetry/index.d.ts

@@ -0,0 +1 @@
+import "./adapter.js";

package/dist/libs/ai-agent/src/tools/index.d.ts

@@ -0,0 +1,4 @@
+import "./tool-adapter.js";
+import "./knowledge-tool.js";
+import "./mcp-client.js";
+import "./mcp-server.js";

package/dist/libs/ai-agent/src/tools/knowledge-tool.d.ts

@@ -0,0 +1,2 @@
+import "../spec/spec.js";
+import "ai";

package/dist/libs/ai-agent/src/tools/mcp-client.d.ts

@@ -0,0 +1 @@
+import "ai";

package/dist/libs/ai-agent/src/tools/mcp-server.d.ts

@@ -0,0 +1,3 @@
+import "../spec/spec.js";
+import "../agent/contract-spec-agent.js";
+import "@modelcontextprotocol/sdk/server/mcp.js";

package/dist/libs/ai-agent/src/tools/tool-adapter.d.ts

@@ -0,0 +1,3 @@
+import "../spec/spec.js";
+import "../types.js";
+import "ai";

package/dist/libs/ai-agent/src/types.d.ts

@@ -0,0 +1 @@
+import "ai";

package/dist/libs/contracts/src/docs/accessibility_wcag_compliance_specs.docblock.d.ts

@@ -0,0 +1 @@
+import "./index.js";

package/dist/libs/contracts/src/docs/index.d.ts

@@ -0,0 +1,25 @@
+import "./presentations.js";
+import { DocId } from "./registry.js";
+import "./accessibility_wcag_compliance_specs.docblock.js";
+import "./tech/lifecycle-stage-system.docblock.js";
+import "./tech/presentation-runtime.docblock.js";
+import "./tech/auth/better-auth-nextjs.docblock.js";
+import "./tech/schema/README.docblock.js";
+import "./tech/templates/runtime.docblock.js";
+import "../workflow/overview.docblock.js";
+import "./tech/mcp-endpoints.docblock.js";
+import "./tech/vscode-extension.docblock.js";
+import "./tech/telemetry-ingest.docblock.js";
+import "./tech/contracts/openapi-export.docblock.js";
+import "./tech/contracts/openapi-import.docblock.js";
+import "../workspace-config/workspace-config.docblock.js";
+import "./tech/studio/workspaces.docblock.js";
+import "./tech/studio/sandbox-unlogged.docblock.js";
+import "./tech/studio/workspace-ops.docblock.js";
+import "./tech/studio/project-routing.docblock.js";
+import "./tech/studio/platform-admin-panel.docblock.js";
+import "./tech/studio/learning-events.docblock.js";
+import "./tech/studio/learning-journeys.docblock.js";
+import "./tech/studio/project-access-teams.docblock.js";
+import "./tech/studio/team-invitations.docblock.js";
+import "./tech/llm/llm-integration.docblock.js";

package/dist/libs/contracts/src/docs/presentations.d.ts

@@ -0,0 +1,2 @@
+import "../presentations/presentations.js";
+import "../ownership.js";

package/dist/libs/contracts/src/docs/registry.d.ts

@@ -0,0 +1,10 @@
+import "../presentations/presentations.js";
+import "./presentations.js";
+
+//#region ../../libs/contracts/src/docs/registry.d.ts
+type DocId = string & {
+  __docId: true;
+};
+//#endregion
+export { DocId };
+//# sourceMappingURL=registry.d.ts.map

package/dist/libs/contracts/src/docs/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/docs/registry.ts"],"sourcesContent":[],"mappings":";;;;KASY,KAAA;EAAA,OAAA,EAAK,IAAA"}

package/dist/libs/contracts/src/docs/tech/auth/better-auth-nextjs.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/contracts/openapi-export.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/contracts/openapi-import.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/lifecycle-stage-system.docblock.d.ts

@@ -0,0 +1 @@
+import "../index.js";

package/dist/libs/contracts/src/docs/tech/llm/llm-integration.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/mcp-endpoints.docblock.d.ts

@@ -0,0 +1 @@
+import "../index.js";

package/dist/libs/contracts/src/docs/tech/presentation-runtime.docblock.d.ts

@@ -0,0 +1 @@
+import "../index.js";

package/dist/libs/contracts/src/docs/tech/schema/README.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/learning-events.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/learning-journeys.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/platform-admin-panel.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/project-access-teams.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/project-routing.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/sandbox-unlogged.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/team-invitations.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/workspace-ops.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/workspaces.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/telemetry-ingest.docblock.d.ts

@@ -0,0 +1 @@
+import "../index.js";

package/dist/libs/contracts/src/docs/tech/templates/runtime.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/vscode-extension.docblock.d.ts

@@ -0,0 +1 @@
+import "../index.js";

package/dist/libs/contracts/src/knowledge/spec.d.ts

@@ -0,0 +1,8 @@
+import "../ownership.js";
+import "../policy/spec.js";
+
+//#region ../../libs/contracts/src/knowledge/spec.d.ts
+type KnowledgeCategory = 'canonical' | 'operational' | 'external' | 'ephemeral';
+//#endregion
+export { KnowledgeCategory };
+//# sourceMappingURL=spec.d.ts.map

package/dist/libs/contracts/src/knowledge/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/knowledge/spec.ts"],"sourcesContent":[],"mappings":";;;;KAGY,iBAAA"}

package/dist/libs/contracts/src/ownership.d.ts

@@ -0,0 +1,61 @@
+import { DocId } from "./docs/registry.js";
+import "./docs/index.js";
+
+//#region ../../libs/contracts/src/ownership.d.ts
+declare const StabilityEnum: {
+  readonly Idea: "idea";
+  readonly InCreation: "in_creation";
+  readonly Experimental: "experimental";
+  readonly Beta: "beta";
+  readonly Stable: "stable";
+  readonly Deprecated: "deprecated";
+};
+type Stability = (typeof StabilityEnum)[keyof typeof StabilityEnum];
+declare const OwnersEnum: {
+  readonly PlatformCore: "platform.core";
+  readonly PlatformSigil: "platform.sigil";
+  readonly PlatformMarketplace: "platform.marketplace";
+  readonly PlatformMessaging: "platform.messaging";
+  readonly PlatformContent: "platform.content";
+  readonly PlatformFeatureFlags: "platform.featureflags";
+  readonly PlatformFinance: "platform.finance";
+};
+type Owner = (typeof OwnersEnum)[keyof typeof OwnersEnum] | (string & {});
+declare const TagsEnum: {
+  readonly Spots: "spots";
+  readonly Collectivity: "collectivity";
+  readonly Marketplace: "marketplace";
+  readonly Sellers: "sellers";
+  readonly Auth: "auth";
+  readonly Login: "login";
+  readonly Signup: "signup";
+  readonly Guide: "guide";
+  readonly Docs: "docs";
+  readonly I18n: "i18n";
+  readonly Incident: "incident";
+  readonly Automation: "automation";
+  readonly Hygiene: "hygiene";
+};
+type Tag = (typeof TagsEnum)[keyof typeof TagsEnum] | (string & {});
+interface OwnerShipMeta {
+  /** Breaking changes => bump version */
+  version: number;
+  /** Fully-qualified spec key (e.g., "sigil.beginSignup") */
+  key: string;
+  /** Human-friendly spec title (e.g., "Signup begin") */
+  title?: string;
+  /** Short human-friendly summary */
+  description: string;
+  domain?: string;
+  /** Lifecycle marker for comms & tooling */
+  stability: Stability;
+  /** Owners for CODEOWNERS / on-call / approvals */
+  owners: Owner[];
+  /** Search tags, grouping, docs navigation */
+  tags: Tag[];
+  /** Doc block(s) for this operation. */
+  docId?: DocId[];
+}
+//#endregion
+export { OwnerShipMeta };
+//# sourceMappingURL=ownership.d.ts.map

package/dist/libs/contracts/src/ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.d.ts","names":[],"sources":["../../../../../../libs/contracts/src/ownership.ts"],"sourcesContent":[],"mappings":";;;;cAIa;;;EAAA,SAAA,YAOH,EAAA,cAAA;EACE,SAAA,IAAS,EAAA,MAAA;EAGR,SAAA,MAQH,EAAA,QAAA;EACE,SAAK,UAAA,EACL,YAAyB;AAMrC,CAAA;AAeY,KAlCA,SAAA,GAkCc,CAAA,OAlCM,aAkCyB,CAAA,CAAA,MAAA,OAlCG,aAkCH,CAAA;AAIxC,cAnCJ,UAmCiB,EAAA;EAWjB,SAAA,YAAA,EAAA,eAAA;EAEH,SAAA,aAAA,EAAA,gBAAA;EAEF,SAAA,mBAAA,EAAA,sBAAA;EAGE,SAAA,iBAAA,EAAA,oBAAA;EAAK,SAAA,eAAA,EAAA,kBAAA;;;;KA5CH,KAAA,WACA,yBAAyB;cAMxB;;;;;;;;;;;;;;;KAeD,GAAA,WAAc,uBAAuB;UAIhC,aAAA;;;;;;;;;;;aAWJ;;UAEH;;QAEF;;UAGE"}

package/dist/libs/contracts/src/policy/spec.d.ts

@@ -0,0 +1,11 @@
+import "../ownership.js";
+
+//#region ../../libs/contracts/src/policy/spec.d.ts
+
+interface PolicyRef {
+  key: string;
+  version: number;
+}
+//#endregion
+export { PolicyRef };
+//# sourceMappingURL=spec.d.ts.map

package/dist/libs/contracts/src/policy/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/policy/spec.ts"],"sourcesContent":[],"mappings":";;;;UAmHiB,SAAA"}

package/dist/libs/contracts/src/presentations/presentations.d.ts

@@ -0,0 +1,2 @@
+import "../../../schema/src/index.js";
+import "../ownership.js";

package/dist/libs/contracts/src/workflow/overview.docblock.d.ts

@@ -0,0 +1 @@
+import "../docs/index.js";

package/dist/libs/contracts/src/workspace-config/workspace-config.docblock.d.ts

@@ -0,0 +1 @@
+import "../docs/index.js";

package/dist/libs/schema/src/EnumType.d.ts

@@ -0,0 +1,2 @@
+import "zod";
+import "graphql";

package/dist/libs/schema/src/FieldType.d.ts

@@ -0,0 +1,2 @@
+import "zod";
+import "graphql";

package/dist/libs/schema/src/GraphQLSchemaType.d.ts

@@ -0,0 +1,2 @@
+import "./SchemaModelType.js";
+import "zod";

package/dist/libs/schema/src/JsonSchemaType.d.ts

@@ -0,0 +1,2 @@
+import "./SchemaModelType.js";
+import "zod";

package/dist/libs/schema/src/ScalarTypeEnum.d.ts

@@ -0,0 +1 @@
+import "./FieldType.js";

package/dist/libs/schema/src/SchemaModel.d.ts

@@ -0,0 +1,4 @@
+import "./FieldType.js";
+import "./EnumType.js";
+import "./SchemaModelType.js";
+import "zod";

package/dist/libs/schema/src/SchemaModelType.d.ts

@@ -0,0 +1 @@
+import "zod";

package/dist/libs/schema/src/ZodSchemaType.d.ts

@@ -0,0 +1,2 @@
+import "./SchemaModelType.js";
+import "zod";

package/dist/libs/schema/src/entity/defineEntity.d.ts

@@ -0,0 +1 @@
+import "./types.js";

package/dist/libs/schema/src/entity/generator.d.ts

@@ -0,0 +1 @@
+import "./types.js";

package/dist/libs/schema/src/entity/index.d.ts

@@ -0,0 +1,3 @@
+import "./types.js";
+import "./defineEntity.js";
+import "./generator.js";

package/dist/libs/schema/src/entity/types.d.ts

@@ -0,0 +1 @@
+import "zod";

package/dist/libs/schema/src/index.d.ts

@@ -0,0 +1,9 @@
+import "./FieldType.js";
+import "./ScalarTypeEnum.js";
+import "./EnumType.js";
+import "./SchemaModelType.js";
+import "./SchemaModel.js";
+import "./entity/index.js";
+import "./ZodSchemaType.js";
+import "./JsonSchemaType.js";
+import "./GraphQLSchemaType.js";

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

@@ -0,0 +1,49 @@
+import { LifecycleEventBridge } from "../events/lifecycle-events.js";
+import { LifecycleAssessment, LifecycleAssessmentInput, LifecycleRecommendation, LifecycleStage } from "@contractspec/lib.lifecycle";
+import { StageSignalCollectorOptions } from "@contractspec/module.lifecycle-core";
+import * as _contractspec_module_lifecycle_advisor0 from "@contractspec/module.lifecycle-advisor";
+import { ContractSpecLibraryRecommender, LifecycleCeremonyDesigner, LifecycleRecommendationEngine } from "@contractspec/module.lifecycle-advisor";
+import { LifecycleKpiPipeline, LifecyclePipelineEvent } from "@contractspec/lib.observability";
+
+//#region src/services/assessment-service.d.ts
+interface LifecycleAssessmentRequest extends LifecycleAssessmentInput {
+  tenantId?: string;
+  completedMilestones?: string[];
+}
+interface LifecycleAssessmentResponse {
+  assessment: LifecycleAssessment;
+  recommendation: LifecycleRecommendation;
+  libraries: ReturnType<ContractSpecLibraryRecommender['recommend']>;
+  ceremony?: ReturnType<LifecycleCeremonyDesigner['design']>;
+}
+interface LifecycleAssessmentServiceOptions {
+  collector: StageSignalCollectorOptions;
+  pipeline?: LifecycleKpiPipeline;
+  recommendationEngine?: LifecycleRecommendationEngine;
+  libraryRecommender?: ContractSpecLibraryRecommender;
+  ceremonyDesigner?: LifecycleCeremonyDesigner;
+  eventBridge?: LifecycleEventBridge;
+  onPipelineEvent?: (event: LifecyclePipelineEvent) => void;
+}
+declare class LifecycleAssessmentService {
+  private readonly orchestrator;
+  private readonly recommendationEngine;
+  private readonly libraryRecommender;
+  private readonly ceremonyDesigner;
+  private readonly pipeline;
+  private readonly eventBridge?;
+  constructor(options: LifecycleAssessmentServiceOptions);
+  runAssessment(request: LifecycleAssessmentRequest): Promise<LifecycleAssessmentResponse>;
+  getStagePlaybook(stage: LifecycleStage): {
+    recommendation: LifecycleRecommendation;
+    libraries: _contractspec_module_lifecycle_advisor0.LibraryRecommendation[];
+    ceremony: {
+      title: string;
+      copy: string;
+      cues: string[];
+    } | undefined;
+  };
+}
+//#endregion
+export { LifecycleAssessmentRequest, LifecycleAssessmentResponse, LifecycleAssessmentService, LifecycleAssessmentServiceOptions };
+//# sourceMappingURL=assessment-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assessment-service.d.ts","names":[],"sources":["../../src/services/assessment-service.ts"],"sourcesContent":[],"mappings":";;;;;;;;UA6BiB,0BAAA,SAAmC;;;AAApD;AAKiB,UAAA,2BAAA,CAA2B;EAC9B,UAAA,EAAA,mBAAA;EACI,cAAA,EAAA,uBAAA;EACM,SAAA,EAAX,UAAW,CAAA,8BAAA,CAAA,WAAA,CAAA,CAAA;EAAX,QAAA,CAAA,EACA,UADA,CACW,yBADX,CAAA,QAAA,CAAA,CAAA;;AACA,UAGI,iCAAA,CAHJ;EAAU,SAAA,EAIV,2BAJU;EAGN,QAAA,CAAA,EAEJ,oBAFI;EACJ,oBAAA,CAAA,EAEY,6BAFZ;EACA,kBAAA,CAAA,EAEU,8BAFV;EACY,gBAAA,CAAA,EAEJ,yBAFI;EACF,WAAA,CAAA,EAEP,oBAFO;EACF,eAAA,CAAA,EAAA,CAAA,KAAA,EAEO,sBAFP,EAAA,GAAA,IAAA;;AAEO,cAGf,0BAAA,CAHe;EAAsB,iBAAA,YAAA;EAGrC,iBAAA,oBAA0B;EAQhB,iBAAA,kBAAA;EA0BV,iBAAA,gBAAA;EACA,iBAAA,QAAA;EAAR,iBAAA,WAAA;EAuBqB,WAAA,CAAA,OAAA,EAlDH,iCAkDG;yBAxBb,6BACR,QAAQ;0BAuBa"}

package/dist/services/assessment-service.js

@@ -0,0 +1,64 @@
+import "../events/lifecycle-events.js";
+import { CapitalPhase, CompanyPhase, ProductPhase } from "@contractspec/lib.lifecycle";
+import { LifecycleMilestonePlanner, LifecycleOrchestrator, StageScorer, StageSignalCollector } from "@contractspec/module.lifecycle-core";
+import { ContractSpecLibraryRecommender, LifecycleCeremonyDesigner, LifecycleRecommendationEngine } from "@contractspec/module.lifecycle-advisor";
+import { LifecycleKpiPipeline } from "@contractspec/lib.observability";
+
+//#region src/services/assessment-service.ts
+var LifecycleAssessmentService = class {
+	orchestrator;
+	recommendationEngine;
+	libraryRecommender;
+	ceremonyDesigner;
+	pipeline;
+	eventBridge;
+	constructor(options) {
+		this.orchestrator = new LifecycleOrchestrator({
+			collector: new StageSignalCollector(options.collector),
+			scorer: new StageScorer(),
+			milestonePlanner: new LifecycleMilestonePlanner()
+		});
+		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);
+		return {
+			assessment,
+			recommendation: this.recommendationEngine.generate(assessment, { upcomingMilestones: upcoming }),
+			libraries: this.libraryRecommender.recommend(assessment.stage),
+			ceremony: this.ceremonyDesigner.design(assessment.stage)
+		};
+	}
+	getStagePlaybook(stage) {
+		return {
+			recommendation: this.recommendationEngine.generate({
+				stage,
+				confidence: 1,
+				axes: {
+					product: ProductPhase.Mvp,
+					company: CompanyPhase.TinyTeam,
+					capital: CapitalPhase.Seed
+				},
+				signals: [],
+				gaps: [],
+				focusAreas: [],
+				scorecard: [],
+				generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+			}, { upcomingMilestones: this.orchestrator.getUpcomingMilestones(stage) }),
+			libraries: this.libraryRecommender.recommend(stage),
+			ceremony: this.ceremonyDesigner.design(stage)
+		};
+	}
+};
+
+//#endregion
+export { LifecycleAssessmentService };
+//# sourceMappingURL=assessment-service.js.map

package/dist/services/assessment-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assessment-service.js","names":[],"sources":["../../src/services/assessment-service.ts"],"sourcesContent":["import type {\n  LifecycleAssessment,\n  LifecycleAssessmentInput,\n  LifecycleRecommendation,\n  LifecycleStage,\n} from '@contractspec/lib.lifecycle';\nimport {\n  ProductPhase,\n  CompanyPhase,\n  CapitalPhase,\n} from '@contractspec/lib.lifecycle';\nimport {\n  LifecycleOrchestrator,\n  StageSignalCollector,\n  StageScorer,\n  LifecycleMilestonePlanner,\n  type StageSignalCollectorOptions,\n} from '@contractspec/module.lifecycle-core';\nimport {\n  LifecycleRecommendationEngine,\n  ContractSpecLibraryRecommender,\n  LifecycleCeremonyDesigner,\n} from '@contractspec/module.lifecycle-advisor';\nimport {\n  LifecycleKpiPipeline,\n  type LifecyclePipelineEvent,\n} from '@contractspec/lib.observability';\nimport { LifecycleEventBridge } from '../events/lifecycle-events';\n\nexport interface LifecycleAssessmentRequest extends LifecycleAssessmentInput {\n  tenantId?: string;\n  completedMilestones?: string[];\n}\n\nexport interface LifecycleAssessmentResponse {\n  assessment: LifecycleAssessment;\n  recommendation: LifecycleRecommendation;\n  libraries: ReturnType<ContractSpecLibraryRecommender['recommend']>;\n  ceremony?: ReturnType<LifecycleCeremonyDesigner['design']>;\n}\n\nexport interface LifecycleAssessmentServiceOptions {\n  collector: StageSignalCollectorOptions;\n  pipeline?: LifecycleKpiPipeline;\n  recommendationEngine?: LifecycleRecommendationEngine;\n  libraryRecommender?: ContractSpecLibraryRecommender;\n  ceremonyDesigner?: LifecycleCeremonyDesigner;\n  eventBridge?: LifecycleEventBridge;\n  onPipelineEvent?: (event: LifecyclePipelineEvent) => void;\n}\n\nexport class LifecycleAssessmentService {\n  private readonly orchestrator: LifecycleOrchestrator;\n  private readonly recommendationEngine: LifecycleRecommendationEngine;\n  private readonly libraryRecommender: ContractSpecLibraryRecommender;\n  private readonly ceremonyDesigner: LifecycleCeremonyDesigner;\n  private readonly pipeline: LifecycleKpiPipeline;\n  private readonly eventBridge?: LifecycleEventBridge;\n\n  constructor(options: LifecycleAssessmentServiceOptions) {\n    const collector = new StageSignalCollector(options.collector);\n    const scorer = new StageScorer();\n    const milestonePlanner = new LifecycleMilestonePlanner();\n    this.orchestrator = new LifecycleOrchestrator({\n      collector,\n      scorer,\n      milestonePlanner,\n    });\n    this.recommendationEngine =\n      options.recommendationEngine ?? new LifecycleRecommendationEngine();\n    this.libraryRecommender =\n      options.libraryRecommender ?? new ContractSpecLibraryRecommender();\n    this.ceremonyDesigner =\n      options.ceremonyDesigner ?? new LifecycleCeremonyDesigner();\n    this.pipeline = options.pipeline ?? new LifecycleKpiPipeline();\n    this.eventBridge = options.eventBridge;\n    if (options.onPipelineEvent) {\n      this.pipeline.on(options.onPipelineEvent);\n    }\n    if (this.eventBridge) {\n      this.pipeline.on((event) => this.eventBridge?.forward(event));\n    }\n  }\n\n  async runAssessment(\n    request: LifecycleAssessmentRequest\n  ): Promise<LifecycleAssessmentResponse> {\n    const assessment = await this.orchestrator.run(request);\n    const upcoming = this.orchestrator.getUpcomingMilestones(\n      assessment.stage,\n      request.completedMilestones\n    );\n    this.pipeline.recordAssessment(assessment, request.tenantId);\n\n    const recommendation = this.recommendationEngine.generate(assessment, {\n      upcomingMilestones: upcoming,\n    });\n\n    const libraries = this.libraryRecommender.recommend(assessment.stage);\n    const ceremony = this.ceremonyDesigner.design(assessment.stage);\n\n    return {\n      assessment,\n      recommendation,\n      libraries,\n      ceremony,\n    };\n  }\n\n  getStagePlaybook(stage: LifecycleStage) {\n    const recommendation = this.recommendationEngine.generate(\n      {\n        stage,\n        confidence: 1,\n        axes: {\n          product: ProductPhase.Mvp,\n          company: CompanyPhase.TinyTeam,\n          capital: CapitalPhase.Seed,\n        },\n        signals: [],\n        gaps: [],\n        focusAreas: [],\n        scorecard: [],\n        generatedAt: new Date().toISOString(),\n      },\n      { upcomingMilestones: this.orchestrator.getUpcomingMilestones(stage) }\n    );\n\n    return {\n      recommendation,\n      libraries: this.libraryRecommender.recommend(stage),\n      ceremony: this.ceremonyDesigner.design(stage),\n    };\n  }\n}\n"],"mappings":";;;;;;;AAmDA,IAAa,6BAAb,MAAwC;CACtC,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,SAA4C;AAItD,OAAK,eAAe,IAAI,sBAAsB;GAC5C,WAJgB,IAAI,qBAAqB,QAAQ,UAAU;GAK3D,QAJa,IAAI,aAAa;GAK9B,kBAJuB,IAAI,2BAA2B;GAKvD,CAAC;AACF,OAAK,uBACH,QAAQ,wBAAwB,IAAI,+BAA+B;AACrE,OAAK,qBACH,QAAQ,sBAAsB,IAAI,gCAAgC;AACpE,OAAK,mBACH,QAAQ,oBAAoB,IAAI,2BAA2B;AAC7D,OAAK,WAAW,QAAQ,YAAY,IAAI,sBAAsB;AAC9D,OAAK,cAAc,QAAQ;AAC3B,MAAI,QAAQ,gBACV,MAAK,SAAS,GAAG,QAAQ,gBAAgB;AAE3C,MAAI,KAAK,YACP,MAAK,SAAS,IAAI,UAAU,KAAK,aAAa,QAAQ,MAAM,CAAC;;CAIjE,MAAM,cACJ,SACsC;EACtC,MAAM,aAAa,MAAM,KAAK,aAAa,IAAI,QAAQ;EACvD,MAAM,WAAW,KAAK,aAAa,sBACjC,WAAW,OACX,QAAQ,oBACT;AACD,OAAK,SAAS,iBAAiB,YAAY,QAAQ,SAAS;AAS5D,SAAO;GACL;GACA,gBATqB,KAAK,qBAAqB,SAAS,YAAY,EACpE,oBAAoB,UACrB,CAAC;GAQA,WANgB,KAAK,mBAAmB,UAAU,WAAW,MAAM;GAOnE,UANe,KAAK,iBAAiB,OAAO,WAAW,MAAM;GAO9D;;CAGH,iBAAiB,OAAuB;AAmBtC,SAAO;GACL,gBAnBqB,KAAK,qBAAqB,SAC/C;IACE;IACA,YAAY;IACZ,MAAM;KACJ,SAAS,aAAa;KACtB,SAAS,aAAa;KACtB,SAAS,aAAa;KACvB;IACD,SAAS,EAAE;IACX,MAAM,EAAE;IACR,YAAY,EAAE;IACd,WAAW,EAAE;IACb,8BAAa,IAAI,MAAM,EAAC,aAAa;IACtC,EACD,EAAE,oBAAoB,KAAK,aAAa,sBAAsB,MAAM,EAAE,CACvE;GAIC,WAAW,KAAK,mBAAmB,UAAU,MAAM;GACnD,UAAU,KAAK,iBAAiB,OAAO,MAAM;GAC9C"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@contractspec/bundle.lifecycle-managed",
+  "version": "1.44.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun run"
+  },
+  "dependencies": {
+    "@contractspec/lib.ai-agent": "1.44.0",
+    "@contractspec/lib.analytics": "1.44.0",
+    "@contractspec/lib.lifecycle": "1.44.0",
+    "@contractspec/lib.observability": "1.44.0",
+    "@contractspec/module.lifecycle-advisor": "1.44.0",
+    "@contractspec/module.lifecycle-core": "1.44.0"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "1.44.0",
+    "@contractspec/tool.typescript": "1.44.0",
+    "tsdown": "^0.18.3",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./*": "./*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/bundles/lifecycle-managed"
+  },
+  "homepage": "https://contractspec.io"
+}