@contractspec/bundle.workspace 1.44.1 → 1.45.1

package/dist/services/config.d.ts

@@ -7,20 +7,10 @@ import { WorkspaceConfig } from "@contractspec/module.workspace";
  * Load workspace configuration from .contractsrc.json.
  */
 declare function loadWorkspaceConfig(fs: FsAdapter, cwd?: string): Promise<WorkspaceConfig>;
-/**
- * Merge config with CLI options and environment variables.
- */
-declare function mergeWorkspaceConfig(config: WorkspaceConfig, options: {
-  provider?: string;
-  model?: string;
-  agentMode?: string;
-  endpoint?: string;
-  outputDir?: string;
-}): WorkspaceConfig;
 /**
  * Get API key for the configured provider.
  */
 declare function getApiKey(provider: WorkspaceConfig['aiProvider']): string | undefined;
 //#endregion
-export { getApiKey, loadWorkspaceConfig, mergeWorkspaceConfig };
+export { getApiKey, loadWorkspaceConfig };
 //# sourceMappingURL=config.d.ts.map

package/dist/services/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","names":[],"sources":["../../src/services/config.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAoCU,iBAHY,mBAAA,CAGZ,EAAA,EAFJ,SAEI,EAAA,GAAA,CAAA,EAAA,MAAA,CAAA,EAAP,OAAO,CAAC,eAAD,CAAA;AAoBV;AA0CA;;iBA1CgB,oBAAA,SACN;;;;;;IAQP;;;;iBAiCa,SAAA,WACJ"}
+{"version":3,"file":"config.d.ts","names":[],"sources":["../../src/services/config.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAoCU,iBAHY,mBAAA,CAGZ,EAAA,EAFJ,SAEI,EAAA,GAAA,CAAA,EAAA,MAAA,CAAA,EAAP,OAAO,CAAC,eAAD,CAAA;AAoBV;;;iBAAgB,SAAA,WACJ"}

package/dist/services/config.js

@@ -19,7 +19,7 @@ const ConfigSchema = z.object({
 		"claude-code",
 		"openai-codex"
 	]).default("simple"),
-	customEndpoint: z.string().url().nullable().optional(),
+	customEndpoint: z.url().nullable().optional(),
 	customApiKey: z.string().nullable().optional(),
 	outputDir: z.string().default("./src"),
 	conventions: z.object({
@@ -46,20 +46,6 @@ async function loadWorkspaceConfig(fs, cwd) {
 	}
 }
 /**
-* Merge config with CLI options and environment variables.
-*/
-function mergeWorkspaceConfig(config, options) {
-	return {
-		...config,
-		aiProvider: options.provider ?? process.env["CONTRACTSPEC_AI_PROVIDER"] ?? config.aiProvider,
-		aiModel: options.model ?? process.env["CONTRACTSPEC_AI_MODEL"] ?? config.aiModel,
-		agentMode: options.agentMode ?? process.env["CONTRACTSPEC_AGENT_MODE"] ?? config.agentMode,
-		customEndpoint: options.endpoint ?? process.env["CONTRACTSPEC_LLM_ENDPOINT"] ?? config.customEndpoint ?? void 0,
-		customApiKey: process.env["CONTRACTSPEC_LLM_API_KEY"] ?? config.customApiKey ?? void 0,
-		outputDir: options.outputDir ?? config.outputDir
-	};
-}
-/**
 * Get API key for the configured provider.
 */
 function getApiKey(provider) {
@@ -73,5 +59,5 @@ function getApiKey(provider) {
 }
 
 //#endregion
-export { getApiKey, loadWorkspaceConfig, mergeWorkspaceConfig };
+export { getApiKey, loadWorkspaceConfig };
 //# sourceMappingURL=config.js.map

package/dist/services/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":[],"sources":["../../src/services/config.ts"],"sourcesContent":["/**\n * Workspace configuration service.\n */\n\nimport * as z from 'zod';\nimport type { WorkspaceConfig } from '@contractspec/module.workspace';\nimport { DEFAULT_WORKSPACE_CONFIG } from '@contractspec/module.workspace';\nimport type { FsAdapter } from '../ports/fs';\n\nconst ConfigSchema = z.object({\n  aiProvider: z\n    .enum(['claude', 'openai', 'ollama', 'custom'])\n    .default('claude'),\n  aiModel: z.string().optional(),\n  agentMode: z\n    .enum(['simple', 'cursor', 'claude-code', 'openai-codex'])\n    .default('simple'),\n  customEndpoint: z.string().url().nullable().optional(),\n  customApiKey: z.string().nullable().optional(),\n  outputDir: z.string().default('./src'),\n  conventions: z.object({\n    operations: z.string().default('interactions/commands|queries'),\n    events: z.string().default('events'),\n    presentations: z.string().default('presentations'),\n    forms: z.string().default('forms'),\n  }),\n  defaultOwners: z.array(z.string()).default([]),\n  defaultTags: z.array(z.string()).default([]),\n});\n\n/**\n * Load workspace configuration from .contractsrc.json.\n */\nexport async function loadWorkspaceConfig(\n  fs: FsAdapter,\n  cwd?: string\n): Promise<WorkspaceConfig> {\n  const configPath = fs.join(cwd ?? '.', '.contractsrc.json');\n\n  const exists = await fs.exists(configPath);\n  if (!exists) {\n    return DEFAULT_WORKSPACE_CONFIG;\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    const parsed = JSON.parse(content);\n    return ConfigSchema.parse(parsed) as WorkspaceConfig;\n  } catch {\n    return DEFAULT_WORKSPACE_CONFIG;\n  }\n}\n\n/**\n * Merge config with CLI options and environment variables.\n */\nexport function mergeWorkspaceConfig(\n  config: WorkspaceConfig,\n  options: {\n    provider?: string;\n    model?: string;\n    agentMode?: string;\n    endpoint?: string;\n    outputDir?: string;\n  }\n): WorkspaceConfig {\n  return {\n    ...config,\n    aiProvider:\n      (options.provider as WorkspaceConfig['aiProvider']) ??\n      (process.env[\n        'CONTRACTSPEC_AI_PROVIDER'\n      ] as WorkspaceConfig['aiProvider']) ??\n      config.aiProvider,\n    aiModel:\n      options.model ?? process.env['CONTRACTSPEC_AI_MODEL'] ?? config.aiModel,\n    agentMode:\n      (options.agentMode as WorkspaceConfig['agentMode']) ??\n      (process.env[\n        'CONTRACTSPEC_AGENT_MODE'\n      ] as WorkspaceConfig['agentMode']) ??\n      config.agentMode,\n    customEndpoint:\n      options.endpoint ??\n      process.env['CONTRACTSPEC_LLM_ENDPOINT'] ??\n      config.customEndpoint ??\n      undefined,\n    customApiKey:\n      process.env['CONTRACTSPEC_LLM_API_KEY'] ??\n      config.customApiKey ??\n      undefined,\n    outputDir: options.outputDir ?? config.outputDir,\n  };\n}\n\n/**\n * Get API key for the configured provider.\n */\nexport function getApiKey(\n  provider: WorkspaceConfig['aiProvider']\n): string | undefined {\n  switch (provider) {\n    case 'claude':\n      return process.env['ANTHROPIC_API_KEY'];\n    case 'openai':\n      return process.env['OPENAI_API_KEY'];\n    case 'custom':\n      return process.env['CONTRACTSPEC_LLM_API_KEY'];\n    case 'ollama':\n      return undefined; // Ollama doesn't need API key for local\n    default:\n      return undefined;\n  }\n}\n"],"mappings":";;;;;;;AASA,MAAM,eAAe,EAAE,OAAO;CAC5B,YAAY,EACT,KAAK;EAAC;EAAU;EAAU;EAAU;EAAS,CAAC,CAC9C,QAAQ,SAAS;CACpB,SAAS,EAAE,QAAQ,CAAC,UAAU;CAC9B,WAAW,EACR,KAAK;EAAC;EAAU;EAAU;EAAe;EAAe,CAAC,CACzD,QAAQ,SAAS;CACpB,gBAAgB,EAAE,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU;CACtD,cAAc,EAAE,QAAQ,CAAC,UAAU,CAAC,UAAU;CAC9C,WAAW,EAAE,QAAQ,CAAC,QAAQ,QAAQ;CACtC,aAAa,EAAE,OAAO;EACpB,YAAY,EAAE,QAAQ,CAAC,QAAQ,gCAAgC;EAC/D,QAAQ,EAAE,QAAQ,CAAC,QAAQ,SAAS;EACpC,eAAe,EAAE,QAAQ,CAAC,QAAQ,gBAAgB;EAClD,OAAO,EAAE,QAAQ,CAAC,QAAQ,QAAQ;EACnC,CAAC;CACF,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;CAC9C,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;CAC7C,CAAC;;;;AAKF,eAAsB,oBACpB,IACA,KAC0B;CAC1B,MAAM,aAAa,GAAG,KAAK,OAAO,KAAK,oBAAoB;AAG3D,KAAI,CADW,MAAM,GAAG,OAAO,WAAW,CAExC,QAAO;AAGT,KAAI;EACF,MAAM,UAAU,MAAM,GAAG,SAAS,WAAW;EAC7C,MAAM,SAAS,KAAK,MAAM,QAAQ;AAClC,SAAO,aAAa,MAAM,OAAO;SAC3B;AACN,SAAO;;;;;;AAOX,SAAgB,qBACd,QACA,SAOiB;AACjB,QAAO;EACL,GAAG;EACH,YACG,QAAQ,YACR,QAAQ,IACP,+BAEF,OAAO;EACT,SACE,QAAQ,SAAS,QAAQ,IAAI,4BAA4B,OAAO;EAClE,WACG,QAAQ,aACR,QAAQ,IACP,8BAEF,OAAO;EACT,gBACE,QAAQ,YACR,QAAQ,IAAI,gCACZ,OAAO,kBACP;EACF,cACE,QAAQ,IAAI,+BACZ,OAAO,gBACP;EACF,WAAW,QAAQ,aAAa,OAAO;EACxC;;;;;AAMH,SAAgB,UACd,UACoB;AACpB,SAAQ,UAAR;EACE,KAAK,SACH,QAAO,QAAQ,IAAI;EACrB,KAAK,SACH,QAAO,QAAQ,IAAI;EACrB,KAAK,SACH,QAAO,QAAQ,IAAI;EACrB,KAAK,SACH;EACF,QACE"}
+{"version":3,"file":"config.js","names":[],"sources":["../../src/services/config.ts"],"sourcesContent":["/**\n * Workspace configuration service.\n */\n\nimport * as z from 'zod';\nimport type { WorkspaceConfig } from '@contractspec/module.workspace';\nimport { DEFAULT_WORKSPACE_CONFIG } from '@contractspec/module.workspace';\nimport type { FsAdapter } from '../ports/fs';\n\nconst ConfigSchema = z.object({\n  aiProvider: z\n    .enum(['claude', 'openai', 'ollama', 'custom'])\n    .default('claude'),\n  aiModel: z.string().optional(),\n  agentMode: z\n    .enum(['simple', 'cursor', 'claude-code', 'openai-codex'])\n    .default('simple'),\n  customEndpoint: z.url().nullable().optional(),\n  customApiKey: z.string().nullable().optional(),\n  outputDir: z.string().default('./src'),\n  conventions: z.object({\n    operations: z.string().default('interactions/commands|queries'),\n    events: z.string().default('events'),\n    presentations: z.string().default('presentations'),\n    forms: z.string().default('forms'),\n  }),\n  defaultOwners: z.array(z.string()).default([]),\n  defaultTags: z.array(z.string()).default([]),\n});\n\n/**\n * Load workspace configuration from .contractsrc.json.\n */\nexport async function loadWorkspaceConfig(\n  fs: FsAdapter,\n  cwd?: string\n): Promise<WorkspaceConfig> {\n  const configPath = fs.join(cwd ?? '.', '.contractsrc.json');\n\n  const exists = await fs.exists(configPath);\n  if (!exists) {\n    return DEFAULT_WORKSPACE_CONFIG;\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    const parsed = JSON.parse(content);\n    return ConfigSchema.parse(parsed) as WorkspaceConfig;\n  } catch {\n    return DEFAULT_WORKSPACE_CONFIG;\n  }\n}\n\n/**\n * Get API key for the configured provider.\n */\nexport function getApiKey(\n  provider: WorkspaceConfig['aiProvider']\n): string | undefined {\n  switch (provider) {\n    case 'claude':\n      return process.env['ANTHROPIC_API_KEY'];\n    case 'openai':\n      return process.env['OPENAI_API_KEY'];\n    case 'custom':\n      return process.env['CONTRACTSPEC_LLM_API_KEY'];\n    case 'ollama':\n      return undefined; // Ollama doesn't need API key for local\n    default:\n      return undefined;\n  }\n}\n"],"mappings":";;;;;;;AASA,MAAM,eAAe,EAAE,OAAO;CAC5B,YAAY,EACT,KAAK;EAAC;EAAU;EAAU;EAAU;EAAS,CAAC,CAC9C,QAAQ,SAAS;CACpB,SAAS,EAAE,QAAQ,CAAC,UAAU;CAC9B,WAAW,EACR,KAAK;EAAC;EAAU;EAAU;EAAe;EAAe,CAAC,CACzD,QAAQ,SAAS;CACpB,gBAAgB,EAAE,KAAK,CAAC,UAAU,CAAC,UAAU;CAC7C,cAAc,EAAE,QAAQ,CAAC,UAAU,CAAC,UAAU;CAC9C,WAAW,EAAE,QAAQ,CAAC,QAAQ,QAAQ;CACtC,aAAa,EAAE,OAAO;EACpB,YAAY,EAAE,QAAQ,CAAC,QAAQ,gCAAgC;EAC/D,QAAQ,EAAE,QAAQ,CAAC,QAAQ,SAAS;EACpC,eAAe,EAAE,QAAQ,CAAC,QAAQ,gBAAgB;EAClD,OAAO,EAAE,QAAQ,CAAC,QAAQ,QAAQ;EACnC,CAAC;CACF,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;CAC9C,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;CAC7C,CAAC;;;;AAKF,eAAsB,oBACpB,IACA,KAC0B;CAC1B,MAAM,aAAa,GAAG,KAAK,OAAO,KAAK,oBAAoB;AAG3D,KAAI,CADW,MAAM,GAAG,OAAO,WAAW,CAExC,QAAO;AAGT,KAAI;EACF,MAAM,UAAU,MAAM,GAAG,SAAS,WAAW;EAC7C,MAAM,SAAS,KAAK,MAAM,QAAQ;AAClC,SAAO,aAAa,MAAM,OAAO;SAC3B;AACN,SAAO;;;;;;AAOX,SAAgB,UACd,UACoB;AACpB,SAAQ,UAAR;EACE,KAAK,SACH,QAAO,QAAQ,IAAI;EACrB,KAAK,SACH,QAAO,QAAQ,IAAI;EACrB,KAAK,SACH,QAAO,QAAQ,IAAI;EACrB,KAAK,SACH;EACF,QACE"}

package/dist/services/create/ai-generator.d.ts

@@ -0,0 +1,84 @@
+import { PresentationKind, WorkspaceConfig } from "@contractspec/module.workspace";
+import { OpKind } from "@contractspec/lib.contracts";
+
+//#region src/services/create/ai-generator.d.ts
+
+/**
+ * AI Generator Service
+ */
+declare class AIGenerator {
+  private config;
+  constructor(config: WorkspaceConfig);
+  private getModel;
+  /**
+   * Generate operation spec from natural language description
+   */
+  generateOperationSpec(description: string, kind: OpKind): Promise<{
+    name: string;
+    version: number;
+    description: string;
+    goal: string;
+    context: string;
+    stability: "experimental" | "beta" | "stable" | "deprecated";
+    owners: string[];
+    tags: string[];
+    auth: "anonymous" | "user" | "admin";
+    inputShape: string;
+    outputShape: string;
+    flags: string[];
+    possibleEvents: string[];
+    analytics: string[];
+  }>;
+  /**
+   * Generate event spec from description
+   */
+  generateEventSpec(description: string): Promise<{
+    name: string;
+    version: number;
+    description: string;
+    stability: "experimental" | "beta" | "stable" | "deprecated";
+    owners: string[];
+    tags: string[];
+    payloadShape: string;
+    piiFields: string[];
+  }>;
+  /**
+   * Generate presentation spec from description
+   */
+  generatePresentationSpec(description: string, kind: PresentationKind): Promise<{
+    name: string;
+    version: number;
+    description: string;
+    stability: "experimental" | "beta" | "stable" | "deprecated";
+    owners: string[];
+    tags: string[];
+    componentKey?: string | undefined;
+    propsShape?: string | undefined;
+    content?: string | undefined;
+    mimeType?: string | undefined;
+    dataShape?: string | undefined;
+  }>;
+  /**
+   * Generate handler implementation from spec
+   */
+  generateHandler(specCode: string): Promise<string>;
+  /**
+   * Generate React component from presentation spec
+   */
+  generateComponent(specCode: string): Promise<string>;
+  /**
+   * Generate form component from form spec
+   */
+  generateForm(specCode: string): Promise<string>;
+  /**
+   * Generate tests for implementation
+   */
+  generateTests(specCode: string, implementationCode: string, testType: 'handler' | 'component'): Promise<string>;
+  /**
+   * Stream code generation for better UX
+   */
+  streamCodeGeneration(prompt: string, onChunk: (text: string) => void): Promise<string>;
+}
+//#endregion
+export { AIGenerator };
+//# sourceMappingURL=ai-generator.d.ts.map

package/dist/services/create/ai-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-generator.d.ts","names":[],"sources":["../../../src/services/create/ai-generator.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAsI4E,cApG/D,WAAA,CAoG+D;EAkCjC,QAAA,MAAA;EAeE,WAAA,CAAA,MAAA,EApJf,eAoJe;EAeL,QAAA,QAAA;EAmBnC;;;mDA/JoD,SAAM;;;;;;;;;;;;;;;;;;;0CA6ClB;;;;;;;;;;;;;sDA+Be,mBAAgB;;;;;;;;;;;;;;;;qCAkCjC;;;;uCAeE;;;;kCAeL;;;;kGAmBnC;;;;yEAkBA"}

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

@@ -0,0 +1,178 @@
+import { getApiKey } from "../config.js";
+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 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.object({
+				name: z.string().describe("Dot notation name like \"domain.operation\""),
+				version: z.number().int().positive().default(1),
+				description: z.string().describe("Clear, concise summary"),
+				goal: z.string().describe("Business purpose"),
+				context: z.string().describe("Background and constraints"),
+				stability: z.enum([
+					"experimental",
+					"beta",
+					"stable",
+					"deprecated"
+				]).default("beta"),
+				owners: z.array(z.string()).describe("Team/person owners with @ prefix"),
+				tags: z.array(z.string()).describe("Categorization tags"),
+				auth: z.enum([
+					"anonymous",
+					"user",
+					"admin"
+				]).describe("Required auth level"),
+				inputShape: z.string().describe("Description of input structure"),
+				outputShape: z.string().describe("Description of output structure"),
+				flags: z.array(z.string()).describe("Feature flags").default([]),
+				possibleEvents: z.array(z.string()).describe("Events this may emit").default([]),
+				analytics: z.array(z.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.object({
+				name: z.string().describe("Dot notation name like \"domain.event_name\""),
+				version: z.number().int().positive().default(1),
+				description: z.string().describe("When this event is emitted"),
+				stability: z.enum([
+					"experimental",
+					"beta",
+					"stable",
+					"deprecated"
+				]).default("beta"),
+				owners: z.array(z.string()).default([]),
+				tags: z.array(z.string()).default([]),
+				payloadShape: z.string().describe("Description of event payload"),
+				piiFields: z.array(z.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.object({
+				name: z.string(),
+				version: z.number().int().positive().default(1),
+				description: z.string(),
+				stability: z.enum([
+					"experimental",
+					"beta",
+					"stable",
+					"deprecated"
+				]).default("beta"),
+				owners: z.array(z.string()).default([]),
+				tags: z.array(z.string()).default([]),
+				componentKey: z.string().optional(),
+				propsShape: z.string().optional(),
+				content: z.string().optional(),
+				mimeType: z.string().optional(),
+				dataShape: z.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.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-generator.js","names":["config: WorkspaceConfig"],"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.ts

@@ -0,0 +1,27 @@
+import { AIGenerator } from "./ai-generator.js";
+import { generateOperationSpec } from "../../templates/operation.template.js";
+import { generateEventSpec } from "../../templates/event.template.js";
+import { generatePresentationSpec } from "../../templates/presentation.template.js";
+import { generateWorkflowSpec } from "../../templates/workflow.template.js";
+import { generateMigrationSpec } from "../../templates/migration.template.js";
+import { generateTelemetrySpec } from "../../templates/telemetry.template.js";
+import { generateExperimentSpec } from "../../templates/experiment.template.js";
+import { generateAppBlueprintSpec } from "../../templates/app-config.template.js";
+import { generateDataViewSpec } from "../../templates/data-view.template.js";
+import { generateIntegrationSpec } from "../../templates/integration.template.js";
+import { generateKnowledgeSpaceSpec } from "../../templates/knowledge.template.js";
+import { generateComponentTemplate as generateComponentTemplate$1, generateHandlerTemplate as generateHandlerTemplate$1, generateTestTemplate as generateTestTemplate$1 } from "../../templates/handler.template.js";
+import { generateWorkflowRunnerTemplate } from "../../templates/workflow-runner.template.js";
+import { templates_d_exports } from "./templates.js";
+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.ts.map

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

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

package/dist/services/create/index.js

@@ -0,0 +1,36 @@
+import { AIGenerator } from "./ai-generator.js";
+import { generateOperationSpec } from "../../templates/operation.template.js";
+import { generateEventSpec } from "../../templates/event.template.js";
+import { generatePresentationSpec } from "../../templates/presentation.template.js";
+import { generateWorkflowSpec } from "../../templates/workflow.template.js";
+import { generateMigrationSpec } from "../../templates/migration.template.js";
+import { generateTelemetrySpec } from "../../templates/telemetry.template.js";
+import { generateExperimentSpec } from "../../templates/experiment.template.js";
+import { generateAppBlueprintSpec } from "../../templates/app-config.template.js";
+import { generateDataViewSpec } from "../../templates/data-view.template.js";
+import { generateIntegrationSpec } from "../../templates/integration.template.js";
+import { generateKnowledgeSpaceSpec } from "../../templates/knowledge.template.js";
+import { generateComponentTemplate, generateHandlerTemplate, generateTestTemplate } from "../../templates/handler.template.js";
+import { generateWorkflowRunnerTemplate } from "../../templates/workflow-runner.template.js";
+import { templates_exports } from "./templates.js";
+
+//#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.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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.ts

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

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

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

package/dist/services/create/templates.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","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/docs/docs-service.d.ts

@@ -0,0 +1,19 @@
+import { WorkspaceAdapters } from "../../ports/logger.js";
+import { DocBlock } from "@contractspec/lib.contracts/docs";
+
+//#region src/services/docs/docs-service.d.ts
+interface DocsServiceOptions {
+  outputDir?: string;
+  format?: 'markdown' | 'html' | 'json';
+}
+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.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs-service.d.ts","names":[],"sources":["../../../src/services/docs/docs-service.ts"],"sourcesContent":[],"mappings":";;;;UAUiB,kBAAA;;EAAA,MAAA,CAAA,EAAA,UAAA,GAAkB,MAAA,GAAA,MAAA;AAKnC;AAQsB,UARL,iBAAA,CAQ0B;EAEhC,MAAA,EATD,QASC,EAAA;EACC,KAAA,EAAA,MAAA;;;;;iBAHU,qBAAA,+BAEX,8BACC,oBACT,QAAQ"}

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

@@ -0,0 +1,41 @@
+import { convertSpecToDocBlock, loadSpecFromSource } from "@contractspec/module.workspace";
+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...`);
+	for (const file of specFiles) try {
+		const parsedList = await loadSpecFromSource(await fs.readFile(file));
+		if (parsedList && parsedList.length > 0) for (const parsed of parsedList) {
+			const block = convertSpecToDocBlock(parsed);
+			defaultDocRegistry.register(block);
+			blocks.push(block);
+			logger.debug(`Generated doc for ${block.id}`);
+		}
+		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) {
+		await fs.mkdir(options.outputDir);
+		for (const block of blocks) {
+			const filename = `${block.id}.md`;
+			const path = adapters.fs.join(options.outputDir, filename);
+			await fs.writeFile(path, block.body);
+		}
+		logger.info(`Wrote ${blocks.length} doc files to ${options.outputDir}`);
+	}
+	return {
+		blocks,
+		count: blocks.length
+	};
+}
+
+//#endregion
+export { generateDocsFromSpecs };
+//# sourceMappingURL=docs-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs-service.js","names":["blocks: DocBlock[]"],"sources":["../../../src/services/docs/docs-service.ts"],"sourcesContent":["import {\n  type DocBlock,\n  defaultDocRegistry,\n} from '@contractspec/lib.contracts/docs';\nimport {\n  loadSpecFromSource,\n  convertSpecToDocBlock,\n} from '@contractspec/module.workspace';\nimport type { WorkspaceAdapters } from '../../ports/logger';\n\nexport interface DocsServiceOptions {\n  outputDir?: string;\n  format?: 'markdown' | 'html' | 'json';\n}\n\nexport interface DocsServiceResult {\n  blocks: DocBlock[];\n  count: number;\n}\n\n/**\n * Generate documentation from spec files.\n */\nexport async function generateDocsFromSpecs(\n  specFiles: string[],\n  options: DocsServiceOptions,\n  adapters: WorkspaceAdapters\n): Promise<DocsServiceResult> {\n  const { fs, logger } = adapters;\n  const blocks: DocBlock[] = [];\n\n  logger.info(`Generating docs for ${specFiles.length} files...`);\n\n  for (const file of specFiles) {\n    try {\n      const content = await fs.readFile(file);\n      const parsedList = await loadSpecFromSource(content);\n\n      if (parsedList && parsedList.length > 0) {\n        for (const parsed of parsedList) {\n          const block = convertSpecToDocBlock(parsed);\n          // Register globally? Or locally?\n          // DocRegistry instance\n          defaultDocRegistry.register(block);\n          blocks.push(block);\n          logger.debug(`Generated doc for ${block.id}`);\n        }\n      } else {\n        logger.warn(`Could not parse spec from ${file}`);\n      }\n    } catch (error) {\n      logger.error(\n        `Error processing ${file}: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  if (options.outputDir) {\n    // Simple output for now: write each block as MD file\n    await fs.mkdir(options.outputDir);\n    for (const block of blocks) {\n      const filename = `${block.id}.md`; // Or sanitize\n      const path = adapters.fs.join(options.outputDir, filename);\n      await fs.writeFile(path, block.body);\n    }\n    logger.info(`Wrote ${blocks.length} doc files to ${options.outputDir}`);\n  }\n\n  return { blocks, count: blocks.length };\n}\n"],"mappings":";;;;;;;AAuBA,eAAsB,sBACpB,WACA,SACA,UAC4B;CAC5B,MAAM,EAAE,IAAI,WAAW;CACvB,MAAMA,SAAqB,EAAE;AAE7B,QAAO,KAAK,uBAAuB,UAAU,OAAO,WAAW;AAE/D,MAAK,MAAM,QAAQ,UACjB,KAAI;EAEF,MAAM,aAAa,MAAM,mBADT,MAAM,GAAG,SAAS,KAAK,CACa;AAEpD,MAAI,cAAc,WAAW,SAAS,EACpC,MAAK,MAAM,UAAU,YAAY;GAC/B,MAAM,QAAQ,sBAAsB,OAAO;AAG3C,sBAAmB,SAAS,MAAM;AAClC,UAAO,KAAK,MAAM;AAClB,UAAO,MAAM,qBAAqB,MAAM,KAAK;;MAG/C,QAAO,KAAK,6BAA6B,OAAO;UAE3C,OAAO;AACd,SAAO,MACL,oBAAoB,KAAK,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GACpF;;AAIL,KAAI,QAAQ,WAAW;AAErB,QAAM,GAAG,MAAM,QAAQ,UAAU;AACjC,OAAK,MAAM,SAAS,QAAQ;GAC1B,MAAM,WAAW,GAAG,MAAM,GAAG;GAC7B,MAAM,OAAO,SAAS,GAAG,KAAK,QAAQ,WAAW,SAAS;AAC1D,SAAM,GAAG,UAAU,MAAM,MAAM,KAAK;;AAEtC,SAAO,KAAK,SAAS,OAAO,OAAO,gBAAgB,QAAQ,YAAY;;AAGzE,QAAO;EAAE;EAAQ,OAAO,OAAO;EAAQ"}

package/dist/services/docs/index.d.ts

@@ -0,0 +1 @@
+import { DocsServiceOptions, DocsServiceResult, generateDocsFromSpecs } from "./docs-service.js";

package/dist/services/docs/index.js

@@ -0,0 +1 @@
+import { generateDocsFromSpecs } from "./docs-service.js";

package/dist/services/doctor/checks/cli.js

@@ -21,7 +21,7 @@ async function runCliChecks(fs, ctx) {
 */
 async function checkCliAccessible(ctx) {
 	try {
-		await execAsync("npx contractspec --version", {
+		await execAsync("bunx contractspec --version", {
 			cwd: ctx.workspaceRoot,
 			timeout: 1e4
 		});
@@ -37,7 +37,7 @@ async function checkCliAccessible(ctx) {
 			name: "CLI Accessible",
 			status: "fail",
 			message: "ContractSpec CLI is not accessible",
-			details: "Could not run \"npx contractspec --version\"",
+			details: "Could not run \"bunx contractspec --version\"",
 			fix: {
 				description: "Install ContractSpec CLI globally",
 				apply: async () => {
@@ -66,7 +66,7 @@ async function checkCliAccessible(ctx) {
 */
 async function checkCliVersion(ctx) {
 	try {
-		const { stdout } = await execAsync("npx contractspec --version", {
+		const { stdout } = await execAsync("bunx contractspec --version", {
 			cwd: ctx.workspaceRoot,
 			timeout: 1e4
 		});