@contractspec/bundle.workspace 1.46.1 → 1.47.0

package/dist/services/create/ai-generator.mjs

@@ -0,0 +1,178 @@
+import { getApiKey } from "../config.mjs";
+import { buildComponentPrompt, buildEventSpecPrompt, buildFormPrompt, buildHandlerPrompt, buildOperationSpecPrompt, buildPresentationSpecPrompt, buildTestPrompt, getCodeGenSystemPrompt, getSystemPrompt } from "@contractspec/module.workspace";
+import { generateObject, generateText, streamText } from "ai";
+import { createProvider } from "@contractspec/lib.ai-providers";
+import * as z$1 from "zod";
+
+//#region src/services/create/ai-generator.ts
+/**
+* AI Generator Service
+*
+* Generates specs and code using AI models.
+*/
+/**
+* AI Generator Service
+*/
+var AIGenerator = class {
+	constructor(config) {
+		this.config = config;
+	}
+	getModel() {
+		const providerName = this.config.aiProvider;
+		const apiKey = this.config.customApiKey || getApiKey(this.config.aiProvider);
+		return createProvider({
+			provider: providerName === "custom" ? "openai" : providerName,
+			model: this.config.aiModel,
+			apiKey,
+			baseUrl: this.config.customEndpoint || void 0
+		}).getModel();
+	}
+	/**
+	* Generate operation spec from natural language description
+	*/
+	async generateOperationSpec(description, kind) {
+		return (await generateObject({
+			model: this.getModel(),
+			schema: z$1.object({
+				name: z$1.string().describe("Dot notation name like \"domain.operation\""),
+				version: z$1.number().int().positive().default(1),
+				description: z$1.string().describe("Clear, concise summary"),
+				goal: z$1.string().describe("Business purpose"),
+				context: z$1.string().describe("Background and constraints"),
+				stability: z$1.enum([
+					"experimental",
+					"beta",
+					"stable",
+					"deprecated"
+				]).default("beta"),
+				owners: z$1.array(z$1.string()).describe("Team/person owners with @ prefix"),
+				tags: z$1.array(z$1.string()).describe("Categorization tags"),
+				auth: z$1.enum([
+					"anonymous",
+					"user",
+					"admin"
+				]).describe("Required auth level"),
+				inputShape: z$1.string().describe("Description of input structure"),
+				outputShape: z$1.string().describe("Description of output structure"),
+				flags: z$1.array(z$1.string()).describe("Feature flags").default([]),
+				possibleEvents: z$1.array(z$1.string()).describe("Events this may emit").default([]),
+				analytics: z$1.array(z$1.string()).describe("Analytics events to track").default([])
+			}),
+			prompt: buildOperationSpecPrompt(description, kind),
+			system: getSystemPrompt()
+		})).object;
+	}
+	/**
+	* Generate event spec from description
+	*/
+	async generateEventSpec(description) {
+		return (await generateObject({
+			model: this.getModel(),
+			schema: z$1.object({
+				name: z$1.string().describe("Dot notation name like \"domain.event_name\""),
+				version: z$1.number().int().positive().default(1),
+				description: z$1.string().describe("When this event is emitted"),
+				stability: z$1.enum([
+					"experimental",
+					"beta",
+					"stable",
+					"deprecated"
+				]).default("beta"),
+				owners: z$1.array(z$1.string()).default([]),
+				tags: z$1.array(z$1.string()).default([]),
+				payloadShape: z$1.string().describe("Description of event payload"),
+				piiFields: z$1.array(z$1.string()).describe("PII field paths").default([])
+			}),
+			prompt: buildEventSpecPrompt(description),
+			system: getSystemPrompt()
+		})).object;
+	}
+	/**
+	* Generate presentation spec from description
+	*/
+	async generatePresentationSpec(description, kind) {
+		return (await generateObject({
+			model: this.getModel(),
+			schema: z$1.object({
+				name: z$1.string(),
+				version: z$1.number().int().positive().default(1),
+				description: z$1.string(),
+				stability: z$1.enum([
+					"experimental",
+					"beta",
+					"stable",
+					"deprecated"
+				]).default("beta"),
+				owners: z$1.array(z$1.string()).default([]),
+				tags: z$1.array(z$1.string()).default([]),
+				componentKey: z$1.string().optional(),
+				propsShape: z$1.string().optional(),
+				content: z$1.string().optional(),
+				mimeType: z$1.string().optional(),
+				dataShape: z$1.string().optional()
+			}),
+			prompt: buildPresentationSpecPrompt(description, kind),
+			system: getSystemPrompt()
+		})).object;
+	}
+	/**
+	* Generate handler implementation from spec
+	*/
+	async generateHandler(specCode) {
+		return (await generateText({
+			model: this.getModel(),
+			prompt: buildHandlerPrompt(specCode),
+			system: getCodeGenSystemPrompt()
+		})).text;
+	}
+	/**
+	* Generate React component from presentation spec
+	*/
+	async generateComponent(specCode) {
+		return (await generateText({
+			model: this.getModel(),
+			prompt: buildComponentPrompt(specCode),
+			system: getCodeGenSystemPrompt()
+		})).text;
+	}
+	/**
+	* Generate form component from form spec
+	*/
+	async generateForm(specCode) {
+		return (await generateText({
+			model: this.getModel(),
+			prompt: buildFormPrompt(specCode),
+			system: getCodeGenSystemPrompt()
+		})).text;
+	}
+	/**
+	* Generate tests for implementation
+	*/
+	async generateTests(specCode, implementationCode, testType) {
+		return (await generateText({
+			model: this.getModel(),
+			prompt: buildTestPrompt(specCode, implementationCode, testType),
+			system: getCodeGenSystemPrompt()
+		})).text;
+	}
+	/**
+	* Stream code generation for better UX
+	*/
+	async streamCodeGeneration(prompt, onChunk) {
+		const result = await streamText({
+			model: this.getModel(),
+			prompt,
+			system: getCodeGenSystemPrompt()
+		});
+		let fullText = "";
+		for await (const chunk of result.textStream) {
+			fullText += chunk;
+			onChunk(chunk);
+		}
+		return fullText;
+	}
+};
+
+//#endregion
+export { AIGenerator };
+//# sourceMappingURL=ai-generator.mjs.map

package/dist/services/create/ai-generator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-generator.mjs","names":["z"],"sources":["../../../src/services/create/ai-generator.ts"],"sourcesContent":["/**\n * AI Generator Service\n *\n * Generates specs and code using AI models.\n */\n\nimport { generateObject, generateText, streamText } from 'ai';\nimport * as z from 'zod';\nimport {\n  createProvider,\n  type ProviderConfig,\n  type ProviderName,\n} from '@contractspec/lib.ai-providers';\nimport {\n  type WorkspaceConfig,\n  type PresentationKind,\n} from '@contractspec/module.workspace';\nimport type { OpKind } from '@contractspec/lib.contracts';\nimport {\n  buildOperationSpecPrompt,\n  buildEventSpecPrompt,\n  buildPresentationSpecPrompt,\n  getSystemPrompt,\n  buildHandlerPrompt,\n  buildComponentPrompt,\n  buildFormPrompt,\n  buildTestPrompt,\n  getCodeGenSystemPrompt,\n} from '@contractspec/module.workspace';\nimport { getApiKey } from '../config';\n\n/**\n * AI Generator Service\n */\nexport class AIGenerator {\n  constructor(private config: WorkspaceConfig) {}\n\n  private getModel() {\n    const providerName = this.config.aiProvider as ProviderName;\n    const apiKey =\n      this.config.customApiKey || getApiKey(this.config.aiProvider);\n\n    // Map WorkspaceConfig to ProviderConfig\n    const providerConfig: ProviderConfig = {\n      provider: (providerName as string) === 'custom' ? 'openai' : providerName, // Fallback custom to openai compatible\n\n      model: this.config.aiModel,\n      apiKey: apiKey,\n      baseUrl: this.config.customEndpoint || undefined,\n    };\n\n    const provider = createProvider(providerConfig);\n    return provider.getModel();\n  }\n\n  /**\n   * Generate operation spec from natural language description\n   */\n  async generateOperationSpec(description: string, kind: OpKind) {\n    const model = this.getModel();\n\n    const schema = z.object({\n      name: z.string().describe('Dot notation name like \"domain.operation\"'),\n      version: z.number().int().positive().default(1),\n      description: z.string().describe('Clear, concise summary'),\n      goal: z.string().describe('Business purpose'),\n      context: z.string().describe('Background and constraints'),\n      stability: z\n        .enum(['experimental', 'beta', 'stable', 'deprecated'])\n        .default('beta'),\n      owners: z.array(z.string()).describe('Team/person owners with @ prefix'),\n      tags: z.array(z.string()).describe('Categorization tags'),\n      auth: z\n        .enum(['anonymous', 'user', 'admin'])\n        .describe('Required auth level'),\n      inputShape: z.string().describe('Description of input structure'),\n      outputShape: z.string().describe('Description of output structure'),\n      flags: z.array(z.string()).describe('Feature flags').default([]),\n      possibleEvents: z\n        .array(z.string())\n        .describe('Events this may emit')\n        .default([]),\n      analytics: z\n        .array(z.string())\n        .describe('Analytics events to track')\n        .default([]),\n    });\n\n    const prompt = buildOperationSpecPrompt(description, kind);\n\n    const result = await generateObject({\n      model,\n      schema,\n      prompt,\n      system: getSystemPrompt(),\n    });\n\n    return result.object;\n  }\n\n  /**\n   * Generate event spec from description\n   */\n  async generateEventSpec(description: string) {\n    const model = this.getModel();\n\n    const schema = z.object({\n      name: z.string().describe('Dot notation name like \"domain.event_name\"'),\n      version: z.number().int().positive().default(1),\n      description: z.string().describe('When this event is emitted'),\n      stability: z\n        .enum(['experimental', 'beta', 'stable', 'deprecated'])\n        .default('beta'),\n      owners: z.array(z.string()).default([]),\n      tags: z.array(z.string()).default([]),\n      payloadShape: z.string().describe('Description of event payload'),\n      piiFields: z.array(z.string()).describe('PII field paths').default([]),\n    });\n\n    const prompt = buildEventSpecPrompt(description);\n\n    const result = await generateObject({\n      model,\n      schema,\n      prompt,\n      system: getSystemPrompt(),\n    });\n\n    return result.object;\n  }\n\n  /**\n   * Generate presentation spec from description\n   */\n  async generatePresentationSpec(description: string, kind: PresentationKind) {\n    const model = this.getModel();\n\n    const schema = z.object({\n      name: z.string(),\n      version: z.number().int().positive().default(1),\n      description: z.string(),\n      stability: z\n        .enum(['experimental', 'beta', 'stable', 'deprecated'])\n        .default('beta'),\n      owners: z.array(z.string()).default([]),\n      tags: z.array(z.string()).default([]),\n      componentKey: z.string().optional(),\n      propsShape: z.string().optional(),\n      content: z.string().optional(),\n      mimeType: z.string().optional(),\n      dataShape: z.string().optional(),\n    });\n\n    const prompt = buildPresentationSpecPrompt(description, kind);\n\n    const result = await generateObject({\n      model,\n      schema,\n      prompt,\n      system: getSystemPrompt(),\n    });\n\n    return result.object;\n  }\n\n  /**\n   * Generate handler implementation from spec\n   */\n  async generateHandler(specCode: string): Promise<string> {\n    const model = this.getModel();\n\n    const result = await generateText({\n      model,\n      prompt: buildHandlerPrompt(specCode),\n      system: getCodeGenSystemPrompt(),\n    });\n\n    return result.text;\n  }\n\n  /**\n   * Generate React component from presentation spec\n   */\n  async generateComponent(specCode: string): Promise<string> {\n    const model = this.getModel();\n\n    const result = await generateText({\n      model,\n      prompt: buildComponentPrompt(specCode),\n      system: getCodeGenSystemPrompt(),\n    });\n\n    return result.text;\n  }\n\n  /**\n   * Generate form component from form spec\n   */\n  async generateForm(specCode: string): Promise<string> {\n    const model = this.getModel();\n\n    const result = await generateText({\n      model,\n      prompt: buildFormPrompt(specCode),\n      system: getCodeGenSystemPrompt(),\n    });\n\n    return result.text;\n  }\n\n  /**\n   * Generate tests for implementation\n   */\n  async generateTests(\n    specCode: string,\n    implementationCode: string,\n    testType: 'handler' | 'component'\n  ): Promise<string> {\n    const model = this.getModel();\n\n    const result = await generateText({\n      model,\n      prompt: buildTestPrompt(specCode, implementationCode, testType),\n      system: getCodeGenSystemPrompt(),\n    });\n\n    return result.text;\n  }\n\n  /**\n   * Stream code generation for better UX\n   */\n  async streamCodeGeneration(\n    prompt: string,\n    onChunk: (text: string) => void\n  ): Promise<string> {\n    const model = this.getModel();\n\n    const result = await streamText({\n      model,\n      prompt,\n      system: getCodeGenSystemPrompt(),\n    });\n\n    let fullText = '';\n\n    for await (const chunk of result.textStream) {\n      fullText += chunk;\n      onChunk(chunk);\n    }\n\n    return fullText;\n  }\n}\n"],"mappings":"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"}

package/dist/services/create/index.d.mts

@@ -0,0 +1,28 @@
+import { AIGenerator } from "./ai-generator.mjs";
+import { generateOperationSpec } from "../../templates/operation.template.mjs";
+import { generateEventSpec } from "../../templates/event.template.mjs";
+import { generatePresentationSpec } from "../../templates/presentation.template.mjs";
+import { generateWorkflowSpec } from "../../templates/workflow.template.mjs";
+import { generateMigrationSpec } from "../../templates/migration.template.mjs";
+import { generateTelemetrySpec } from "../../templates/telemetry.template.mjs";
+import { generateExperimentSpec } from "../../templates/experiment.template.mjs";
+import { generateAppBlueprintSpec } from "../../templates/app-config.template.mjs";
+import { generateDataViewSpec } from "../../templates/data-view.template.mjs";
+import { generateIntegrationSpec } from "../../templates/integration.template.mjs";
+import { generateKnowledgeSpaceSpec } from "../../templates/knowledge.template.mjs";
+import { generateComponentTemplate as generateComponentTemplate$1, generateHandlerTemplate as generateHandlerTemplate$1, generateTestTemplate as generateTestTemplate$1 } from "../../templates/handler.template.mjs";
+import { generateWorkflowRunnerTemplate } from "../../templates/workflow-runner.template.mjs";
+import { FeatureSpecParams, generateFeatureSpec } from "../../templates/feature.template.mjs";
+import { templates_d_exports } from "./templates.mjs";
+import { WorkspaceConfig } from "@contractspec/module.workspace";
+
+//#region src/services/create/index.d.ts
+declare class SpecCreatorService {
+  readonly ai: AIGenerator;
+  readonly templates: typeof templates_d_exports;
+  constructor(config: WorkspaceConfig);
+}
+declare function createSpecCreator(config: WorkspaceConfig): SpecCreatorService;
+//#endregion
+export { SpecCreatorService, createSpecCreator };
+//# sourceMappingURL=index.d.mts.map

package/dist/services/create/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/services/create/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;cAUa,kBAAA;eACS;6BACK;sBAEL;;iBAQN,iBAAA,SAA0B,kBAAkB"}

package/dist/services/create/index.mjs

@@ -0,0 +1,37 @@
+import { AIGenerator } from "./ai-generator.mjs";
+import { generateOperationSpec } from "../../templates/operation.template.mjs";
+import { generateEventSpec } from "../../templates/event.template.mjs";
+import { generatePresentationSpec } from "../../templates/presentation.template.mjs";
+import { generateWorkflowSpec } from "../../templates/workflow.template.mjs";
+import { generateMigrationSpec } from "../../templates/migration.template.mjs";
+import { generateTelemetrySpec } from "../../templates/telemetry.template.mjs";
+import { generateExperimentSpec } from "../../templates/experiment.template.mjs";
+import { generateAppBlueprintSpec } from "../../templates/app-config.template.mjs";
+import { generateDataViewSpec } from "../../templates/data-view.template.mjs";
+import { generateIntegrationSpec } from "../../templates/integration.template.mjs";
+import { generateKnowledgeSpaceSpec } from "../../templates/knowledge.template.mjs";
+import { generateComponentTemplate, generateHandlerTemplate, generateTestTemplate } from "../../templates/handler.template.mjs";
+import { generateWorkflowRunnerTemplate } from "../../templates/workflow-runner.template.mjs";
+import { generateFeatureSpec } from "../../templates/feature.template.mjs";
+import { templates_exports } from "./templates.mjs";
+
+//#region src/services/create/index.ts
+/**
+* Spec Creation Service
+*
+* Unifies manual and AI-assisted spec creation.
+*/
+var SpecCreatorService = class {
+	ai;
+	templates = templates_exports;
+	constructor(config) {
+		this.ai = new AIGenerator(config);
+	}
+};
+function createSpecCreator(config) {
+	return new SpecCreatorService(config);
+}
+
+//#endregion
+export { SpecCreatorService, createSpecCreator };
+//# sourceMappingURL=index.mjs.map

package/dist/services/create/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["templates"],"sources":["../../../src/services/create/index.ts"],"sourcesContent":["/**\n * Spec Creation Service\n *\n * Unifies manual and AI-assisted spec creation.\n */\n\nimport { AIGenerator } from './ai-generator';\nimport * as templates from './templates';\nimport type { WorkspaceConfig } from '@contractspec/module.workspace';\n\nexport class SpecCreatorService {\n  public readonly ai: AIGenerator;\n  public readonly templates = templates;\n\n  constructor(config: WorkspaceConfig) {\n    this.ai = new AIGenerator(config);\n  }\n}\n\nexport * from './ai-generator';\nexport * from './templates';\n\nexport function createSpecCreator(config: WorkspaceConfig): SpecCreatorService {\n  return new SpecCreatorService(config);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAUA,IAAa,qBAAb,MAAgC;CAC9B,AAAgB;CAChB,AAAgB,YAAYA;CAE5B,YAAY,QAAyB;AACnC,OAAK,KAAK,IAAI,YAAY,OAAO;;;AAOrC,SAAgB,kBAAkB,QAA6C;AAC7E,QAAO,IAAI,mBAAmB,OAAO"}

package/dist/services/create/templates.d.mts

@@ -0,0 +1,22 @@
+import { generateOperationSpec } from "../../templates/operation.template.mjs";
+import { generateEventSpec } from "../../templates/event.template.mjs";
+import { generatePresentationSpec } from "../../templates/presentation.template.mjs";
+import { generateWorkflowSpec } from "../../templates/workflow.template.mjs";
+import { generateMigrationSpec } from "../../templates/migration.template.mjs";
+import { generateTelemetrySpec } from "../../templates/telemetry.template.mjs";
+import { generateExperimentSpec } from "../../templates/experiment.template.mjs";
+import { generateAppBlueprintSpec } from "../../templates/app-config.template.mjs";
+import { generateDataViewSpec } from "../../templates/data-view.template.mjs";
+import { generateIntegrationSpec } from "../../templates/integration.template.mjs";
+import { generateKnowledgeSpaceSpec } from "../../templates/knowledge.template.mjs";
+import { generateComponentTemplate, generateHandlerTemplate, generateTestTemplate } from "../../templates/handler.template.mjs";
+import { generateWorkflowRunnerTemplate } from "../../templates/workflow-runner.template.mjs";
+import { FeatureSpecParams, generateFeatureSpec } from "../../templates/feature.template.mjs";
+
+//#region src/services/create/templates.d.ts
+declare namespace templates_d_exports {
+  export { FeatureSpecParams, generateAppBlueprintSpec, generateComponentTemplate, generateDataViewSpec, generateEventSpec, generateExperimentSpec, generateFeatureSpec, generateHandlerTemplate, generateIntegrationSpec, generateKnowledgeSpaceSpec, generateMigrationSpec, generateOperationSpec, generatePresentationSpec, generateTelemetrySpec, generateTestTemplate, generateWorkflowRunnerTemplate, generateWorkflowSpec };
+}
+//#endregion
+export { templates_d_exports };
+//# sourceMappingURL=templates.d.mts.map

package/dist/services/create/templates.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.mts","names":[],"sources":["../../../src/services/create/templates.ts"],"sourcesContent":[],"mappings":""}

package/dist/services/create/templates.mjs

@@ -0,0 +1,39 @@
+import { __exportAll } from "../../_virtual/rolldown_runtime.mjs";
+import { generateOperationSpec } from "../../templates/operation.template.mjs";
+import { generateEventSpec } from "../../templates/event.template.mjs";
+import { generatePresentationSpec } from "../../templates/presentation.template.mjs";
+import { generateWorkflowSpec } from "../../templates/workflow.template.mjs";
+import { generateMigrationSpec } from "../../templates/migration.template.mjs";
+import { generateTelemetrySpec } from "../../templates/telemetry.template.mjs";
+import { generateExperimentSpec } from "../../templates/experiment.template.mjs";
+import { generateAppBlueprintSpec } from "../../templates/app-config.template.mjs";
+import { generateDataViewSpec } from "../../templates/data-view.template.mjs";
+import { generateIntegrationSpec } from "../../templates/integration.template.mjs";
+import { generateKnowledgeSpaceSpec } from "../../templates/knowledge.template.mjs";
+import { generateComponentTemplate, generateHandlerTemplate, generateTestTemplate } from "../../templates/handler.template.mjs";
+import { generateWorkflowRunnerTemplate } from "../../templates/workflow-runner.template.mjs";
+import { generateFeatureSpec } from "../../templates/feature.template.mjs";
+
+//#region src/services/create/templates.ts
+var templates_exports = /* @__PURE__ */ __exportAll({
+	generateAppBlueprintSpec: () => generateAppBlueprintSpec,
+	generateComponentTemplate: () => generateComponentTemplate,
+	generateDataViewSpec: () => generateDataViewSpec,
+	generateEventSpec: () => generateEventSpec,
+	generateExperimentSpec: () => generateExperimentSpec,
+	generateFeatureSpec: () => generateFeatureSpec,
+	generateHandlerTemplate: () => generateHandlerTemplate,
+	generateIntegrationSpec: () => generateIntegrationSpec,
+	generateKnowledgeSpaceSpec: () => generateKnowledgeSpaceSpec,
+	generateMigrationSpec: () => generateMigrationSpec,
+	generateOperationSpec: () => generateOperationSpec,
+	generatePresentationSpec: () => generatePresentationSpec,
+	generateTelemetrySpec: () => generateTelemetrySpec,
+	generateTestTemplate: () => generateTestTemplate,
+	generateWorkflowRunnerTemplate: () => generateWorkflowRunnerTemplate,
+	generateWorkflowSpec: () => generateWorkflowSpec
+});
+
+//#endregion
+export { templates_exports };
+//# sourceMappingURL=templates.mjs.map

package/dist/services/create/templates.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.mjs","names":[],"sources":["../../../src/services/create/templates.ts"],"sourcesContent":["/**\n * Template Service\n *\n * Provides various spec templates.\n */\n\n// Re-export templates from the templates directory in bundle\n// Currently they are just exported functions\nexport * from '../../templates';\n"],"mappings":""}

package/dist/services/deps.d.mts

@@ -0,0 +1,53 @@
+import { FsAdapter } from "../ports/fs.mjs";
+import { ContractGraph, ContractNode } from "@contractspec/module.workspace";
+
+//#region src/services/deps.d.ts
+
+/**
+ * Options for dependency analysis.
+ */
+interface AnalyzeDepsOptions {
+  /**
+   * File pattern to search.
+   */
+  pattern?: string;
+}
+/**
+ * Result of dependency analysis.
+ */
+interface AnalyzeDepsResult {
+  graph: ContractGraph;
+  total: number;
+  cycles: string[][];
+  missing: {
+    contract: string;
+    missing: string[];
+  }[];
+}
+/**
+ * Analyze contract dependencies.
+ */
+declare function analyzeDeps(adapters: {
+  fs: FsAdapter;
+}, options?: AnalyzeDepsOptions): Promise<AnalyzeDepsResult>;
+/**
+ * Get contract node by name.
+ */
+declare function getContractNode(graph: ContractGraph, name: string): ContractNode | undefined;
+/**
+ * Export graph as DOT format.
+ */
+declare function exportGraphAsDot(graph: ContractGraph): string;
+/**
+ * Get graph statistics.
+ */
+declare function getGraphStats(graph: ContractGraph): {
+  total: number;
+  withDeps: number;
+  withoutDeps: number;
+  used: number;
+  unused: number;
+};
+//#endregion
+export { AnalyzeDepsOptions, AnalyzeDepsResult, analyzeDeps, exportGraphAsDot, getContractNode, getGraphStats };
+//# sourceMappingURL=deps.d.mts.map

package/dist/services/deps.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.mts","names":[],"sources":["../../src/services/deps.ts"],"sourcesContent":[],"mappings":";;;;;AA8BA;AAUA;;AAEW,UAtBM,kBAAA,CAsBN;EACA;;;EA4CK,OAAA,CAAA,EAAA,MAAA;AAUhB;AAOA;;;UA1EiB,iBAAA;SACR;;;;;;;;;;;iBASa,WAAA;MACJ;aACP,qBACR,QAAQ;;;;iBA4CK,eAAA,QACP,8BAEN;;;;iBAOa,gBAAA,QAAwB;;;;iBAOxB,aAAA,QAAqB"}

package/dist/services/deps.mjs

@@ -0,0 +1,62 @@
+import { addContractNode, buildReverseEdges, createContractGraph, detectCycles, findMissingDependencies, parseImportedSpecNames, toDot } from "@contractspec/module.workspace";
+
+//#region src/services/deps.ts
+/**
+* Dependency analysis service.
+*/
+/**
+* Analyze contract dependencies.
+*/
+async function analyzeDeps(adapters, options = {}) {
+	const { fs } = adapters;
+	const files = await fs.glob({ pattern: options.pattern });
+	const graph = createContractGraph();
+	for (const file of files) {
+		const content = await fs.readFile(file);
+		const relativePath = fs.relative(".", file);
+		const nameMatch = content.match(/name:\s*['"]([^'"]+)['"]/);
+		addContractNode(graph, (nameMatch?.[1] ? nameMatch[1] : fs.basename(file).replace(/\.[jt]s$/, "").replace(/\.(contracts|contract|operation|operations|event|presentation|workflow|data-view|migration|telemetry|experiment|app-config|integration|knowledge)$/, "")) || "unknown", relativePath, parseImportedSpecNames(content, file));
+	}
+	buildReverseEdges(graph);
+	const cycles = detectCycles(graph);
+	const missing = findMissingDependencies(graph);
+	return {
+		graph,
+		total: graph.size,
+		cycles,
+		missing
+	};
+}
+/**
+* Get contract node by name.
+*/
+function getContractNode(graph, name) {
+	return graph.get(name);
+}
+/**
+* Export graph as DOT format.
+*/
+function exportGraphAsDot(graph) {
+	return toDot(graph);
+}
+/**
+* Get graph statistics.
+*/
+function getGraphStats(graph) {
+	const all = Array.from(graph.values());
+	const withDeps = all.filter((c) => c.dependencies.length > 0);
+	const withoutDeps = all.filter((c) => c.dependencies.length === 0);
+	const used = all.filter((c) => c.dependents.length > 0);
+	const unused = all.filter((c) => c.dependents.length === 0);
+	return {
+		total: graph.size,
+		withDeps: withDeps.length,
+		withoutDeps: withoutDeps.length,
+		used: used.length,
+		unused: unused.length
+	};
+}
+
+//#endregion
+export { analyzeDeps, exportGraphAsDot, getContractNode, getGraphStats };
+//# sourceMappingURL=deps.mjs.map

package/dist/services/deps.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.mjs","names":[],"sources":["../../src/services/deps.ts"],"sourcesContent":["/**\n * Dependency analysis service.\n */\n\nimport {\n  addContractNode,\n  buildReverseEdges,\n  type ContractGraph,\n  type ContractNode,\n  createContractGraph,\n  detectCycles,\n  findMissingDependencies,\n  parseImportedSpecNames,\n  toDot,\n} from '@contractspec/module.workspace';\nimport type { FsAdapter } from '../ports/fs';\n\n/**\n * Options for dependency analysis.\n */\nexport interface AnalyzeDepsOptions {\n  /**\n   * File pattern to search.\n   */\n  pattern?: string;\n}\n\n/**\n * Result of dependency analysis.\n */\nexport interface AnalyzeDepsResult {\n  graph: ContractGraph;\n  total: number;\n  cycles: string[][];\n  missing: { contract: string; missing: string[] }[];\n}\n\n/**\n * Analyze contract dependencies.\n */\nexport async function analyzeDeps(\n  adapters: { fs: FsAdapter },\n  options: AnalyzeDepsOptions = {}\n): Promise<AnalyzeDepsResult> {\n  const { fs } = adapters;\n\n  const files = await fs.glob({ pattern: options.pattern });\n  const graph = createContractGraph();\n\n  for (const file of files) {\n    const content = await fs.readFile(file);\n    const relativePath = fs.relative('.', file);\n\n    // Prefer explicit meta.name if present; otherwise fall back to filename stem\n    const nameMatch = content.match(/name:\\s*['\"]([^'\"]+)['\"]/);\n    const inferredName = nameMatch?.[1]\n      ? nameMatch[1]\n      : fs\n          .basename(file)\n          .replace(/\\.[jt]s$/, '')\n          .replace(\n            /\\.(contracts|contract|operation|operations|event|presentation|workflow|data-view|migration|telemetry|experiment|app-config|integration|knowledge)$/,\n            ''\n          );\n\n    const finalName = inferredName || 'unknown';\n    const dependencies = parseImportedSpecNames(content, file);\n\n    addContractNode(graph, finalName, relativePath, dependencies);\n  }\n\n  buildReverseEdges(graph);\n\n  const cycles = detectCycles(graph);\n  const missing = findMissingDependencies(graph);\n\n  return {\n    graph,\n    total: graph.size,\n    cycles,\n    missing,\n  };\n}\n\n/**\n * Get contract node by name.\n */\nexport function getContractNode(\n  graph: ContractGraph,\n  name: string\n): ContractNode | undefined {\n  return graph.get(name);\n}\n\n/**\n * Export graph as DOT format.\n */\nexport function exportGraphAsDot(graph: ContractGraph): string {\n  return toDot(graph);\n}\n\n/**\n * Get graph statistics.\n */\nexport function getGraphStats(graph: ContractGraph): {\n  total: number;\n  withDeps: number;\n  withoutDeps: number;\n  used: number;\n  unused: number;\n} {\n  const all = Array.from(graph.values());\n  const withDeps = all.filter((c) => c.dependencies.length > 0);\n  const withoutDeps = all.filter((c) => c.dependencies.length === 0);\n  const used = all.filter((c) => c.dependents.length > 0);\n  const unused = all.filter((c) => c.dependents.length === 0);\n\n  return {\n    total: graph.size,\n    withDeps: withDeps.length,\n    withoutDeps: withoutDeps.length,\n    used: used.length,\n    unused: unused.length,\n  };\n}\n"],"mappings":";;;;;;;;;AAwCA,eAAsB,YACpB,UACA,UAA8B,EAAE,EACJ;CAC5B,MAAM,EAAE,OAAO;CAEf,MAAM,QAAQ,MAAM,GAAG,KAAK,EAAE,SAAS,QAAQ,SAAS,CAAC;CACzD,MAAM,QAAQ,qBAAqB;AAEnC,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,UAAU,MAAM,GAAG,SAAS,KAAK;EACvC,MAAM,eAAe,GAAG,SAAS,KAAK,KAAK;EAG3C,MAAM,YAAY,QAAQ,MAAM,2BAA2B;AAc3D,kBAAgB,QAbK,YAAY,KAC7B,UAAU,KACV,GACG,SAAS,KAAK,CACd,QAAQ,YAAY,GAAG,CACvB,QACC,sJACA,GACD,KAE2B,WAGA,cAFb,uBAAuB,SAAS,KAAK,CAEG;;AAG/D,mBAAkB,MAAM;CAExB,MAAM,SAAS,aAAa,MAAM;CAClC,MAAM,UAAU,wBAAwB,MAAM;AAE9C,QAAO;EACL;EACA,OAAO,MAAM;EACb;EACA;EACD;;;;;AAMH,SAAgB,gBACd,OACA,MAC0B;AAC1B,QAAO,MAAM,IAAI,KAAK;;;;;AAMxB,SAAgB,iBAAiB,OAA8B;AAC7D,QAAO,MAAM,MAAM;;;;;AAMrB,SAAgB,cAAc,OAM5B;CACA,MAAM,MAAM,MAAM,KAAK,MAAM,QAAQ,CAAC;CACtC,MAAM,WAAW,IAAI,QAAQ,MAAM,EAAE,aAAa,SAAS,EAAE;CAC7D,MAAM,cAAc,IAAI,QAAQ,MAAM,EAAE,aAAa,WAAW,EAAE;CAClE,MAAM,OAAO,IAAI,QAAQ,MAAM,EAAE,WAAW,SAAS,EAAE;CACvD,MAAM,SAAS,IAAI,QAAQ,MAAM,EAAE,WAAW,WAAW,EAAE;AAE3D,QAAO;EACL,OAAO,MAAM;EACb,UAAU,SAAS;EACnB,aAAa,YAAY;EACzB,MAAM,KAAK;EACX,QAAQ,OAAO;EAChB"}

package/dist/services/diff.d.mts

@@ -0,0 +1,34 @@
+import { FsAdapter } from "../ports/fs.mjs";
+import { GitAdapter } from "../ports/git.mjs";
+import { SemanticDiffItem, SemanticDiffOptions } from "@contractspec/module.workspace";
+
+//#region src/services/diff.d.ts
+
+/**
+ * Options for comparing specs.
+ */
+interface CompareSpecsOptions extends SemanticDiffOptions {
+  /**
+   * Git ref to compare against (branch, tag, commit).
+   * If provided, spec2 is loaded from this ref instead of filesystem.
+   */
+  baseline?: string;
+}
+/**
+ * Result of spec comparison.
+ */
+interface CompareSpecsResult {
+  spec1: string;
+  spec2: string;
+  differences: SemanticDiffItem[];
+}
+/**
+ * Compare two spec files semantically.
+ */
+declare function compareSpecs(spec1Path: string, spec2Path: string, adapters: {
+  fs: FsAdapter;
+  git: GitAdapter;
+}, options?: CompareSpecsOptions): Promise<CompareSpecsResult>;
+//#endregion
+export { CompareSpecsOptions, CompareSpecsResult, compareSpecs };
+//# sourceMappingURL=diff.d.mts.map

package/dist/services/diff.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.mts","names":[],"sources":["../../src/services/diff.ts"],"sourcesContent":[],"mappings":";;;;;;AA0BA;AASA;;AAGkC,UAvBjB,mBAAA,SAA4B,mBAuBX,CAAA;EACvB;;;;;;;;;UAbM,kBAAA;;;eAGF;;;;;iBAMO,YAAA;MAGJ;OAAgB;aACvB,sBACR,QAAQ"}

package/dist/services/diff.mjs

@@ -0,0 +1,34 @@
+import { computeSemanticDiff } from "@contractspec/module.workspace";
+
+//#region src/services/diff.ts
+/**
+* Diff service.
+*/
+/**
+* Compare two spec files semantically.
+*/
+async function compareSpecs(spec1Path, spec2Path, adapters, options = {}) {
+	const { fs, git } = adapters;
+	if (!await fs.exists(spec1Path)) throw new Error(`Spec file not found: ${spec1Path}`);
+	const spec1Code = await fs.readFile(spec1Path);
+	let spec2Code;
+	let spec2Label;
+	if (options.baseline) {
+		spec2Code = await git.showFile(options.baseline, spec1Path);
+		spec2Label = `${options.baseline}:${spec1Path}`;
+	} else {
+		if (!await fs.exists(spec2Path)) throw new Error(`Spec file not found: ${spec2Path}`);
+		spec2Code = await fs.readFile(spec2Path);
+		spec2Label = spec2Path;
+	}
+	const differences = computeSemanticDiff(spec1Code, spec1Path, spec2Code, spec2Label, { breakingOnly: options.breakingOnly });
+	return {
+		spec1: spec1Path,
+		spec2: spec2Label,
+		differences
+	};
+}
+
+//#endregion
+export { compareSpecs };
+//# sourceMappingURL=diff.mjs.map

package/dist/services/diff.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.mjs","names":[],"sources":["../../src/services/diff.ts"],"sourcesContent":["/**\n * Diff service.\n */\n\nimport {\n  computeSemanticDiff,\n  type SemanticDiffItem,\n  type SemanticDiffOptions,\n} from '@contractspec/module.workspace';\nimport type { FsAdapter } from '../ports/fs';\nimport type { GitAdapter } from '../ports/git';\n\n/**\n * Options for comparing specs.\n */\nexport interface CompareSpecsOptions extends SemanticDiffOptions {\n  /**\n   * Git ref to compare against (branch, tag, commit).\n   * If provided, spec2 is loaded from this ref instead of filesystem.\n   */\n  baseline?: string;\n}\n\n/**\n * Result of spec comparison.\n */\nexport interface CompareSpecsResult {\n  spec1: string;\n  spec2: string;\n  differences: SemanticDiffItem[];\n}\n\n/**\n * Compare two spec files semantically.\n */\nexport async function compareSpecs(\n  spec1Path: string,\n  spec2Path: string,\n  adapters: { fs: FsAdapter; git: GitAdapter },\n  options: CompareSpecsOptions = {}\n): Promise<CompareSpecsResult> {\n  const { fs, git } = adapters;\n\n  // Load first spec from filesystem\n  const exists1 = await fs.exists(spec1Path);\n  if (!exists1) {\n    throw new Error(`Spec file not found: ${spec1Path}`);\n  }\n  const spec1Code = await fs.readFile(spec1Path);\n\n  // Load second spec either from git baseline or filesystem\n  let spec2Code: string;\n  let spec2Label: string;\n\n  if (options.baseline) {\n    spec2Code = await git.showFile(options.baseline, spec1Path);\n    spec2Label = `${options.baseline}:${spec1Path}`;\n  } else {\n    const exists2 = await fs.exists(spec2Path);\n    if (!exists2) {\n      throw new Error(`Spec file not found: ${spec2Path}`);\n    }\n    spec2Code = await fs.readFile(spec2Path);\n    spec2Label = spec2Path;\n  }\n\n  // Compute semantic diff\n  const differences = computeSemanticDiff(\n    spec1Code,\n    spec1Path,\n    spec2Code,\n    spec2Label,\n    { breakingOnly: options.breakingOnly }\n  );\n\n  return {\n    spec1: spec1Path,\n    spec2: spec2Label,\n    differences,\n  };\n}\n"],"mappings":";;;;;;;;;AAmCA,eAAsB,aACpB,WACA,WACA,UACA,UAA+B,EAAE,EACJ;CAC7B,MAAM,EAAE,IAAI,QAAQ;AAIpB,KAAI,CADY,MAAM,GAAG,OAAO,UAAU,CAExC,OAAM,IAAI,MAAM,wBAAwB,YAAY;CAEtD,MAAM,YAAY,MAAM,GAAG,SAAS,UAAU;CAG9C,IAAI;CACJ,IAAI;AAEJ,KAAI,QAAQ,UAAU;AACpB,cAAY,MAAM,IAAI,SAAS,QAAQ,UAAU,UAAU;AAC3D,eAAa,GAAG,QAAQ,SAAS,GAAG;QAC/B;AAEL,MAAI,CADY,MAAM,GAAG,OAAO,UAAU,CAExC,OAAM,IAAI,MAAM,wBAAwB,YAAY;AAEtD,cAAY,MAAM,GAAG,SAAS,UAAU;AACxC,eAAa;;CAIf,MAAM,cAAc,oBAClB,WACA,WACA,WACA,YACA,EAAE,cAAc,QAAQ,cAAc,CACvC;AAED,QAAO;EACL,OAAO;EACP,OAAO;EACP;EACD"}

package/dist/services/docs/docs-service.d.mts

@@ -0,0 +1,20 @@
+import { WorkspaceAdapters } from "../../ports/logger.mjs";
+import { DocBlock } from "@contractspec/lib.contracts/docs";
+
+//#region src/services/docs/docs-service.d.ts
+interface DocsServiceOptions {
+  outputDir?: string;
+  format?: 'markdown' | 'html' | 'json';
+  rootPath?: string;
+}
+interface DocsServiceResult {
+  blocks: DocBlock[];
+  count: number;
+}
+/**
+ * Generate documentation from spec files.
+ */
+declare function generateDocsFromSpecs(specFiles: string[], options: DocsServiceOptions, adapters: WorkspaceAdapters): Promise<DocsServiceResult>;
+//#endregion
+export { DocsServiceOptions, DocsServiceResult, generateDocsFromSpecs };
+//# sourceMappingURL=docs-service.d.mts.map

package/dist/services/docs/docs-service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-service.d.mts","names":[],"sources":["../../../src/services/docs/docs-service.ts"],"sourcesContent":[],"mappings":";;;;UAeiB,kBAAA;;EAAA,MAAA,CAAA,EAAA,UAAA,GAAkB,MAAA,GAAA,MAAA;EAMlB,QAAA,CAAA,EAAA,MAAA;AAQjB;AAEW,UAVM,iBAAA,CAUN;EACC,MAAA,EAVF,QAUE,EAAA;EACD,KAAA,EAAA,MAAA;;;;;iBAJW,qBAAA,+BAEX,8BACC,oBACT,QAAQ"}

package/dist/services/docs/docs-service.mjs

@@ -0,0 +1,59 @@
+import { ModuleResolver } from "../modules/module-resolver.mjs";
+import { convertSpecToDocBlock, loadSpecFromSource, scanAllSpecsFromSource, scanSpecSource } from "@contractspec/module.workspace";
+import path from "path";
+import { defaultDocRegistry } from "@contractspec/lib.contracts/docs";
+
+//#region src/services/docs/docs-service.ts
+/**
+* Generate documentation from spec files.
+*/
+async function generateDocsFromSpecs(specFiles, options, adapters) {
+	const { fs, logger } = adapters;
+	const blocks = [];
+	logger.info(`Generating docs for ${specFiles.length} files...`);
+	if (options.outputDir) await fs.mkdir(options.outputDir);
+	const resolver = new ModuleResolver(adapters);
+	const scanResults = [];
+	for (const file of specFiles) try {
+		const content = await fs.readFile(file);
+		const results = scanAllSpecsFromSource(content, file);
+		if (results.length > 0) scanResults.push(...results);
+		else {
+			const single = scanSpecSource(content, file);
+			if (single.specType !== "unknown") scanResults.push(single);
+		}
+	} catch (_err) {}
+	resolver.initialize(scanResults);
+	for (const file of specFiles) try {
+		const parsedList = await loadSpecFromSource(file);
+		if (parsedList && parsedList.length > 0) for (const parsed of parsedList) {
+			const block = convertSpecToDocBlock(parsed, { rootPath: options.rootPath });
+			defaultDocRegistry.register(block);
+			blocks.push(block);
+			logger.debug(`Generated doc for ${block.id}`);
+			if (options.outputDir) {
+				const moduleDef = resolver.resolve(file);
+				let targetDir = options.outputDir;
+				if (moduleDef) targetDir = path.join(options.outputDir, moduleDef.key);
+				else targetDir = path.join(options.outputDir, "_common");
+				await fs.mkdir(targetDir);
+				const filename = `${block.id}.md`;
+				const filePath = path.join(targetDir, filename);
+				const generatedContent = `<!-- @generated - This file was generated by ContractSpec. Do not edit manually. -->\n\n${block.body}`;
+				await fs.writeFile(filePath, generatedContent);
+			}
+		}
+		else logger.warn(`Could not parse spec from ${file}`);
+	} catch (error) {
+		logger.error(`Error processing ${file}: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	if (options.outputDir) logger.info(`Wrote ${blocks.length} doc files to ${options.outputDir}`);
+	return {
+		blocks,
+		count: blocks.length
+	};
+}
+
+//#endregion
+export { generateDocsFromSpecs };
+//# sourceMappingURL=docs-service.mjs.map