@lssm/bundle.contractspec-workspace 1.41.0 → 1.42.1

package/dist/services/clean.d.ts

@@ -0,0 +1,41 @@
+import { FsAdapter } from "../ports/fs.js";
+import { LoggerAdapter } from "../ports/logger.js";
+
+//#region src/services/clean.d.ts
+
+interface CleanOptions {
+  /**
+   * When true, only remove known build artifact directories and known generated
+   * suffixes (safe-by-default).
+   */
+  generatedOnly?: boolean;
+  /**
+   * Skip deletions; just report.
+   */
+  dryRun?: boolean;
+  /**
+   * Only delete files older than this many days.
+   */
+  olderThanDays?: number;
+  /**
+   * Output directory used for generated artifacts (handlers/components/forms).
+   */
+  outputDir?: string;
+}
+interface CleanResult {
+  removed: {
+    path: string;
+    size: number;
+  }[];
+  skipped: {
+    path: string;
+    reason: string;
+  }[];
+}
+declare function cleanArtifacts(adapters: {
+  fs: FsAdapter;
+  logger: LoggerAdapter;
+}, options?: CleanOptions): Promise<CleanResult>;
+//#endregion
+export { CleanOptions, CleanResult, cleanArtifacts };
+//# sourceMappingURL=clean.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","names":[],"sources":["../../src/services/clean.ts"],"sourcesContent":[],"mappings":";;;;;AAmCkB,UA1BD,YAAA,CA0BC;EAAmB;;;;EAE3B,aAAA,CAAA,EAAA,OAAA;;;;;;;;;;;;;;UARO,WAAA;;;;;;;;;;iBAKK,cAAA;MACJ;UAAmB;aAC1B,eACR,QAAQ"}

package/dist/services/clean.js

@@ -1 +1,72 @@
-async function e(e,t={}){let{fs:n,logger:r}=e,i=(t.outputDir??`./src`).replace(/\\/g,`/`),a=[`generated/**`,`dist/**`,`.turbo/**`],o=[`${i}/handlers/**/*.handler.ts`,`${i}/handlers/**/*.handler.test.ts`,`${i}/components/**/*.tsx`,`${i}/components/**/*.test.tsx`,`${i}/forms/**/*.form.tsx`,`${i}/forms/**/*.form.test.tsx`,`${i}/**/*.runner.ts`,`${i}/**/*.renderer.tsx`],s=t.generatedOnly?[...a,...o]:[...a,`**/*.generated.ts`,`**/*.generated.js`,`**/*.generated.d.ts`,...o],c=await n.glob({patterns:s,ignore:[`node_modules/**`]}),l=[],u=[];for(let e of c)try{let i=await n.stat(e),a=(Date.now()-i.mtime.getTime())/(1e3*60*60*24);if(typeof t.olderThanDays==`number`&&a<t.olderThanDays){u.push({path:e,reason:`younger_than_${t.olderThanDays}_days`});continue}t.dryRun?r.info(`[dry-run] clean would remove`,{path:e,size:i.size}):(await n.remove(e),r.info(`clean.removed`,{path:e,size:i.size})),l.push({path:e,size:i.size})}catch(t){u.push({path:e,reason:t instanceof Error?t.message:String(t)})}return{removed:l,skipped:u}}export{e as cleanArtifacts};
+//#region src/services/clean.ts
+async function cleanArtifacts(adapters, options = {}) {
+	const { fs, logger } = adapters;
+	const outputDir = (options.outputDir ?? "./src").replace(/\\/g, "/");
+	const basePatterns = [
+		"generated/**",
+		"dist/**",
+		".turbo/**"
+	];
+	const outputDirPatterns = [
+		`${outputDir}/handlers/**/*.handler.ts`,
+		`${outputDir}/handlers/**/*.handler.test.ts`,
+		`${outputDir}/components/**/*.tsx`,
+		`${outputDir}/components/**/*.test.tsx`,
+		`${outputDir}/forms/**/*.form.tsx`,
+		`${outputDir}/forms/**/*.form.test.tsx`,
+		`${outputDir}/**/*.runner.ts`,
+		`${outputDir}/**/*.renderer.tsx`
+	];
+	const patterns = options.generatedOnly ? [...basePatterns, ...outputDirPatterns] : [
+		...basePatterns,
+		"**/*.generated.ts",
+		"**/*.generated.js",
+		"**/*.generated.d.ts",
+		...outputDirPatterns
+	];
+	const candidates = await fs.glob({
+		patterns,
+		ignore: ["node_modules/**"]
+	});
+	const removed = [];
+	const skipped = [];
+	for (const p of candidates) try {
+		const st = await fs.stat(p);
+		const ageDays = (Date.now() - st.mtime.getTime()) / (1e3 * 60 * 60 * 24);
+		if (typeof options.olderThanDays === "number" && ageDays < options.olderThanDays) {
+			skipped.push({
+				path: p,
+				reason: `younger_than_${options.olderThanDays}_days`
+			});
+			continue;
+		}
+		if (options.dryRun) logger.info("[dry-run] clean would remove", {
+			path: p,
+			size: st.size
+		});
+		else {
+			await fs.remove(p);
+			logger.info("clean.removed", {
+				path: p,
+				size: st.size
+			});
+		}
+		removed.push({
+			path: p,
+			size: st.size
+		});
+	} catch (error) {
+		skipped.push({
+			path: p,
+			reason: error instanceof Error ? error.message : String(error)
+		});
+	}
+	return {
+		removed,
+		skipped
+	};
+}
+
+//#endregion
+export { cleanArtifacts };
+//# sourceMappingURL=clean.js.map

package/dist/services/clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.js","names":["removed: { path: string; size: number }[]","skipped: { path: string; reason: string }[]"],"sources":["../../src/services/clean.ts"],"sourcesContent":["/**\n * Clean service.\n *\n * Safe-by-default cleanup of generated artifacts.\n */\n\nimport type { FsAdapter } from '../ports/fs';\nimport type { LoggerAdapter } from '../ports/logger';\n\nexport interface CleanOptions {\n  /**\n   * When true, only remove known build artifact directories and known generated\n   * suffixes (safe-by-default).\n   */\n  generatedOnly?: boolean;\n  /**\n   * Skip deletions; just report.\n   */\n  dryRun?: boolean;\n  /**\n   * Only delete files older than this many days.\n   */\n  olderThanDays?: number;\n  /**\n   * Output directory used for generated artifacts (handlers/components/forms).\n   */\n  outputDir?: string;\n}\n\nexport interface CleanResult {\n  removed: { path: string; size: number }[];\n  skipped: { path: string; reason: string }[];\n}\n\nexport async function cleanArtifacts(\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  options: CleanOptions = {}\n): Promise<CleanResult> {\n  const { fs, logger } = adapters;\n  const outputDir = (options.outputDir ?? './src').replace(/\\\\/g, '/');\n\n  const basePatterns = ['generated/**', 'dist/**', '.turbo/**'];\n\n  const outputDirPatterns = [\n    `${outputDir}/handlers/**/*.handler.ts`,\n    `${outputDir}/handlers/**/*.handler.test.ts`,\n    `${outputDir}/components/**/*.tsx`,\n    `${outputDir}/components/**/*.test.tsx`,\n    `${outputDir}/forms/**/*.form.tsx`,\n    `${outputDir}/forms/**/*.form.test.tsx`,\n    `${outputDir}/**/*.runner.ts`,\n    `${outputDir}/**/*.renderer.tsx`,\n  ];\n\n  const patterns = options.generatedOnly\n    ? [...basePatterns, ...outputDirPatterns]\n    : [\n        ...basePatterns,\n        '**/*.generated.ts',\n        '**/*.generated.js',\n        '**/*.generated.d.ts',\n        ...outputDirPatterns,\n      ];\n\n  const candidates = await fs.glob({\n    patterns,\n    ignore: ['node_modules/**'],\n  });\n\n  const removed: { path: string; size: number }[] = [];\n  const skipped: { path: string; reason: string }[] = [];\n\n  for (const p of candidates) {\n    try {\n      const st = await fs.stat(p);\n      const ageDays = (Date.now() - st.mtime.getTime()) / (1000 * 60 * 60 * 24);\n      if (\n        typeof options.olderThanDays === 'number' &&\n        ageDays < options.olderThanDays\n      ) {\n        skipped.push({\n          path: p,\n          reason: `younger_than_${options.olderThanDays}_days`,\n        });\n        continue;\n      }\n\n      if (options.dryRun) {\n        logger.info('[dry-run] clean would remove', { path: p, size: st.size });\n      } else {\n        await fs.remove(p);\n        logger.info('clean.removed', { path: p, size: st.size });\n      }\n      removed.push({ path: p, size: st.size });\n    } catch (error) {\n      skipped.push({\n        path: p,\n        reason: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  return { removed, skipped };\n}\n"],"mappings":";AAkCA,eAAsB,eACpB,UACA,UAAwB,EAAE,EACJ;CACtB,MAAM,EAAE,IAAI,WAAW;CACvB,MAAM,aAAa,QAAQ,aAAa,SAAS,QAAQ,OAAO,IAAI;CAEpE,MAAM,eAAe;EAAC;EAAgB;EAAW;EAAY;CAE7D,MAAM,oBAAoB;EACxB,GAAG,UAAU;EACb,GAAG,UAAU;EACb,GAAG,UAAU;EACb,GAAG,UAAU;EACb,GAAG,UAAU;EACb,GAAG,UAAU;EACb,GAAG,UAAU;EACb,GAAG,UAAU;EACd;CAED,MAAM,WAAW,QAAQ,gBACrB,CAAC,GAAG,cAAc,GAAG,kBAAkB,GACvC;EACE,GAAG;EACH;EACA;EACA;EACA,GAAG;EACJ;CAEL,MAAM,aAAa,MAAM,GAAG,KAAK;EAC/B;EACA,QAAQ,CAAC,kBAAkB;EAC5B,CAAC;CAEF,MAAMA,UAA4C,EAAE;CACpD,MAAMC,UAA8C,EAAE;AAEtD,MAAK,MAAM,KAAK,WACd,KAAI;EACF,MAAM,KAAK,MAAM,GAAG,KAAK,EAAE;EAC3B,MAAM,WAAW,KAAK,KAAK,GAAG,GAAG,MAAM,SAAS,KAAK,MAAO,KAAK,KAAK;AACtE,MACE,OAAO,QAAQ,kBAAkB,YACjC,UAAU,QAAQ,eAClB;AACA,WAAQ,KAAK;IACX,MAAM;IACN,QAAQ,gBAAgB,QAAQ,cAAc;IAC/C,CAAC;AACF;;AAGF,MAAI,QAAQ,OACV,QAAO,KAAK,gCAAgC;GAAE,MAAM;GAAG,MAAM,GAAG;GAAM,CAAC;OAClE;AACL,SAAM,GAAG,OAAO,EAAE;AAClB,UAAO,KAAK,iBAAiB;IAAE,MAAM;IAAG,MAAM,GAAG;IAAM,CAAC;;AAE1D,UAAQ,KAAK;GAAE,MAAM;GAAG,MAAM,GAAG;GAAM,CAAC;UACjC,OAAO;AACd,UAAQ,KAAK;GACX,MAAM;GACN,QAAQ,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC/D,CAAC;;AAIN,QAAO;EAAE;EAAS;EAAS"}

package/dist/services/config.d.ts

@@ -0,0 +1,26 @@
+import { FsAdapter } from "../ports/fs.js";
+import { WorkspaceConfig } from "@lssm/module.contractspec-workspace";
+
+//#region src/services/config.d.ts
+
+/**
+ * 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 };
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +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"}

package/dist/services/config.js

@@ -1 +1,77 @@
-import{DEFAULT_WORKSPACE_CONFIG as e}from"@lssm/module.contractspec-workspace";import*as t from"zod";const n=t.object({aiProvider:t.enum([`claude`,`openai`,`ollama`,`custom`]).default(`claude`),aiModel:t.string().optional(),agentMode:t.enum([`simple`,`cursor`,`claude-code`,`openai-codex`]).default(`simple`),customEndpoint:t.string().url().nullable().optional(),customApiKey:t.string().nullable().optional(),outputDir:t.string().default(`./src`),conventions:t.object({operations:t.string().default(`interactions/commands|queries`),events:t.string().default(`events`),presentations:t.string().default(`presentations`),forms:t.string().default(`forms`)}),defaultOwners:t.array(t.string()).default([]),defaultTags:t.array(t.string()).default([])});async function r(t,r){let i=t.join(r??`.`,`.contractsrc.json`);if(!await t.exists(i))return e;try{let e=await t.readFile(i),r=JSON.parse(e);return n.parse(r)}catch{return e}}function i(e,t){return{...e,aiProvider:t.provider??process.env.CONTRACTSPEC_AI_PROVIDER??e.aiProvider,aiModel:t.model??process.env.CONTRACTSPEC_AI_MODEL??e.aiModel,agentMode:t.agentMode??process.env.CONTRACTSPEC_AGENT_MODE??e.agentMode,customEndpoint:t.endpoint??process.env.CONTRACTSPEC_LLM_ENDPOINT??e.customEndpoint??void 0,customApiKey:process.env.CONTRACTSPEC_LLM_API_KEY??e.customApiKey??void 0,outputDir:t.outputDir??e.outputDir}}function a(e){switch(e){case`claude`:return process.env.ANTHROPIC_API_KEY;case`openai`:return process.env.OPENAI_API_KEY;case`custom`:return process.env.CONTRACTSPEC_LLM_API_KEY;case`ollama`:return;default:return}}export{a as getApiKey,r as loadWorkspaceConfig,i as mergeWorkspaceConfig};
+import { DEFAULT_WORKSPACE_CONFIG } from "@lssm/module.contractspec-workspace";
+import * as z from "zod";
+
+//#region src/services/config.ts
+/**
+* Workspace configuration service.
+*/
+const ConfigSchema = z.object({
+	aiProvider: z.enum([
+		"claude",
+		"openai",
+		"ollama",
+		"custom"
+	]).default("claude"),
+	aiModel: z.string().optional(),
+	agentMode: z.enum([
+		"simple",
+		"cursor",
+		"claude-code",
+		"openai-codex"
+	]).default("simple"),
+	customEndpoint: z.string().url().nullable().optional(),
+	customApiKey: z.string().nullable().optional(),
+	outputDir: z.string().default("./src"),
+	conventions: z.object({
+		operations: z.string().default("interactions/commands|queries"),
+		events: z.string().default("events"),
+		presentations: z.string().default("presentations"),
+		forms: z.string().default("forms")
+	}),
+	defaultOwners: z.array(z.string()).default([]),
+	defaultTags: z.array(z.string()).default([])
+});
+/**
+* Load workspace configuration from .contractsrc.json.
+*/
+async function loadWorkspaceConfig(fs, cwd) {
+	const configPath = fs.join(cwd ?? ".", ".contractsrc.json");
+	if (!await fs.exists(configPath)) return DEFAULT_WORKSPACE_CONFIG;
+	try {
+		const content = await fs.readFile(configPath);
+		const parsed = JSON.parse(content);
+		return ConfigSchema.parse(parsed);
+	} catch {
+		return DEFAULT_WORKSPACE_CONFIG;
+	}
+}
+/**
+* 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) {
+	switch (provider) {
+		case "claude": return process.env["ANTHROPIC_API_KEY"];
+		case "openai": return process.env["OPENAI_API_KEY"];
+		case "custom": return process.env["CONTRACTSPEC_LLM_API_KEY"];
+		case "ollama": return;
+		default: return;
+	}
+}
+
+//#endregion
+export { getApiKey, loadWorkspaceConfig, mergeWorkspaceConfig };
+//# sourceMappingURL=config.js.map

package/dist/services/config.js.map

@@ -0,0 +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 '@lssm/module.contractspec-workspace';\nimport { DEFAULT_WORKSPACE_CONFIG } from '@lssm/module.contractspec-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"}

package/dist/services/deps.d.ts

@@ -0,0 +1,53 @@
+import { FsAdapter } from "../ports/fs.js";
+import { ContractGraph, ContractNode } from "@lssm/module.contractspec-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.ts.map

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

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

@@ -1 +1,62 @@
-import{addContractNode as e,buildReverseEdges as t,createContractGraph as n,detectCycles as r,findMissingDependencies as i,parseImportedSpecNames as a,toDot as o}from"@lssm/module.contractspec-workspace";async function s(o,s={}){let{fs:c}=o,l=await c.glob({pattern:s.pattern}),u=n();for(let t of l){let n=await c.readFile(t),r=c.relative(`.`,t),i=n.match(/name:\s*['"]([^'"]+)['"]/);e(u,(i?.[1]?i[1]:c.basename(t).replace(/\.[jt]s$/,``).replace(/\.(contracts|event|presentation|workflow|data-view|migration|telemetry|experiment|app-config|integration|knowledge)$/,``))||`unknown`,r,a(n,t))}t(u);let d=r(u),f=i(u);return{graph:u,total:u.size,cycles:d,missing:f}}function c(e,t){return e.get(t)}function l(e){return o(e)}function u(e){let t=Array.from(e.values()),n=t.filter(e=>e.dependencies.length>0),r=t.filter(e=>e.dependencies.length===0),i=t.filter(e=>e.dependents.length>0),a=t.filter(e=>e.dependents.length===0);return{total:e.size,withDeps:n.length,withoutDeps:r.length,used:i.length,unused:a.length}}export{s as analyzeDeps,l as exportGraphAsDot,c as getContractNode,u as getGraphStats};
+import { addContractNode, buildReverseEdges, createContractGraph, detectCycles, findMissingDependencies, parseImportedSpecNames, toDot } from "@lssm/module.contractspec-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.js.map

package/dist/services/deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.js","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 '@lssm/module.contractspec-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.ts

@@ -0,0 +1,34 @@
+import { FsAdapter } from "../ports/fs.js";
+import { GitAdapter } from "../ports/git.js";
+import { SemanticDiffItem, SemanticDiffOptions } from "@lssm/module.contractspec-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.ts.map

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

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

@@ -1 +1,34 @@
-import{computeSemanticDiff as e}from"@lssm/module.contractspec-workspace";async function t(t,n,r,i={}){let{fs:a,git:o}=r;if(!await a.exists(t))throw Error(`Spec file not found: ${t}`);let s=await a.readFile(t),c,l;if(i.baseline)c=await o.showFile(i.baseline,t),l=`${i.baseline}:${t}`;else{if(!await a.exists(n))throw Error(`Spec file not found: ${n}`);c=await a.readFile(n),l=n}let u=e(s,t,c,l,{breakingOnly:i.breakingOnly});return{spec1:t,spec2:l,differences:u}}export{t as compareSpecs};
+import { computeSemanticDiff } from "@lssm/module.contractspec-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.js.map

package/dist/services/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","names":["spec2Code: string","spec2Label: string"],"sources":["../../src/services/diff.ts"],"sourcesContent":["/**\n * Diff service.\n */\n\nimport {\n  computeSemanticDiff,\n  type SemanticDiffItem,\n  type SemanticDiffOptions,\n} from '@lssm/module.contractspec-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,IAAIA;CACJ,IAAIC;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/doctor/checks/ai.js

@@ -1,2 +1,119 @@
-async function e(e,r,i){let a=[],o=await t(e,r);return a.push(o),o.status===`pass`&&a.push(await n(e,r,i)),a}async function t(e,t){let n=e.join(t.workspaceRoot,`.contractsrc.json`);try{if(!await e.exists(n))return{category:`ai`,name:`AI Provider`,status:`skip`,message:`No config file found`};let t=await e.readFile(n),r=JSON.parse(t);return{category:`ai`,name:`AI Provider`,status:`pass`,message:`Provider: ${r.aiProvider??`claude`}, Model: ${r.aiModel??`default`}`}}catch{return{category:`ai`,name:`AI Provider`,status:`skip`,message:`Could not read AI config`}}}async function n(e,t,n){let r=e.join(t.workspaceRoot,`.contractsrc.json`);try{let i=await e.readFile(r),a=JSON.parse(i).aiProvider??`claude`,o={claude:`ANTHROPIC_API_KEY`,openai:`OPENAI_API_KEY`,ollama:``,custom:`CONTRACTSPEC_LLM_API_KEY`}[a];return o?process.env[o]?{category:`ai`,name:`API Key`,status:`pass`,message:`${o} is set`}:{category:`ai`,name:`API Key`,status:`warn`,message:`${o} not set`,details:`Set ${o} in your environment to use AI features`,fix:n?{description:`Set ${o} environment variable`,apply:async()=>{let r=await n.input(`Enter your ${a} API key:`,{password:!0});if(!r)return{success:!1,message:`No API key provided`};let i=e.join(t.workspaceRoot,`.env`);try{let t=``;if(await e.exists(i)){if(t=await e.readFile(i),t.includes(`${o}=`))return{success:!1,message:`${o} already in .env, update manually`};t+=`
-`}return t+=`${o}=${r}\n`,await e.writeFile(i,t),{success:!0,message:`Added ${o} to .env (restart required)`}}catch(e){return{success:!1,message:`Failed: ${e instanceof Error?e.message:String(e)}`}}}}:void 0}:{category:`ai`,name:`API Key`,status:`pass`,message:`${a} does not require an API key`}}catch{return{category:`ai`,name:`API Key`,status:`skip`,message:`Could not check API key`}}}export{e as runAiChecks};
+//#region src/services/doctor/checks/ai.ts
+/**
+* Run AI provider-related health checks.
+*/
+async function runAiChecks(fs, ctx, prompts) {
+	const results = [];
+	const providerResult = await checkAiProvider(fs, ctx);
+	results.push(providerResult);
+	if (providerResult.status === "pass") results.push(await checkApiKey(fs, ctx, prompts));
+	return results;
+}
+/**
+* Check which AI provider is configured.
+*/
+async function checkAiProvider(fs, ctx) {
+	const configPath = fs.join(ctx.workspaceRoot, ".contractsrc.json");
+	try {
+		if (!await fs.exists(configPath)) return {
+			category: "ai",
+			name: "AI Provider",
+			status: "skip",
+			message: "No config file found"
+		};
+		const content = await fs.readFile(configPath);
+		const config = JSON.parse(content);
+		return {
+			category: "ai",
+			name: "AI Provider",
+			status: "pass",
+			message: `Provider: ${config.aiProvider ?? "claude"}, Model: ${config.aiModel ?? "default"}`
+		};
+	} catch {
+		return {
+			category: "ai",
+			name: "AI Provider",
+			status: "skip",
+			message: "Could not read AI config"
+		};
+	}
+}
+/**
+* Check if API key is set for the configured provider.
+*/
+async function checkApiKey(fs, ctx, prompts) {
+	const configPath = fs.join(ctx.workspaceRoot, ".contractsrc.json");
+	try {
+		const content = await fs.readFile(configPath);
+		const provider = JSON.parse(content).aiProvider ?? "claude";
+		const envVar = {
+			claude: "ANTHROPIC_API_KEY",
+			openai: "OPENAI_API_KEY",
+			ollama: "",
+			custom: "CONTRACTSPEC_LLM_API_KEY"
+		}[provider];
+		if (!envVar) return {
+			category: "ai",
+			name: "API Key",
+			status: "pass",
+			message: `${provider} does not require an API key`
+		};
+		if (!!process.env[envVar]) return {
+			category: "ai",
+			name: "API Key",
+			status: "pass",
+			message: `${envVar} is set`
+		};
+		return {
+			category: "ai",
+			name: "API Key",
+			status: "warn",
+			message: `${envVar} not set`,
+			details: `Set ${envVar} in your environment to use AI features`,
+			fix: prompts ? {
+				description: `Set ${envVar} environment variable`,
+				apply: async () => {
+					const key = await prompts.input(`Enter your ${provider} API key:`, { password: true });
+					if (!key) return {
+						success: false,
+						message: "No API key provided"
+					};
+					const envPath = fs.join(ctx.workspaceRoot, ".env");
+					try {
+						let envContent = "";
+						if (await fs.exists(envPath)) {
+							envContent = await fs.readFile(envPath);
+							if (envContent.includes(`${envVar}=`)) return {
+								success: false,
+								message: `${envVar} already in .env, update manually`
+							};
+							envContent += "\n";
+						}
+						envContent += `${envVar}=${key}\n`;
+						await fs.writeFile(envPath, envContent);
+						return {
+							success: true,
+							message: `Added ${envVar} to .env (restart required)`
+						};
+					} catch (error) {
+						return {
+							success: false,
+							message: `Failed: ${error instanceof Error ? error.message : String(error)}`
+						};
+					}
+				}
+			} : void 0
+		};
+	} catch {
+		return {
+			category: "ai",
+			name: "API Key",
+			status: "skip",
+			message: "Could not check API key"
+		};
+	}
+}
+
+//#endregion
+export { runAiChecks };
+//# sourceMappingURL=ai.js.map

package/dist/services/doctor/checks/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","names":["results: CheckResult[]"],"sources":["../../../../src/services/doctor/checks/ai.ts"],"sourcesContent":["/**\n * AI provider health checks.\n */\n\nimport type { FsAdapter } from '../../../ports/fs';\nimport type {\n  CheckResult,\n  CheckContext,\n  DoctorPromptCallbacks,\n  FixResult,\n} from '../types';\n\n/**\n * Run AI provider-related health checks.\n */\nexport async function runAiChecks(\n  fs: FsAdapter,\n  ctx: CheckContext,\n  prompts?: DoctorPromptCallbacks\n): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  // Check configured AI provider\n  const providerResult = await checkAiProvider(fs, ctx);\n  results.push(providerResult);\n\n  // Check API key based on provider\n  if (providerResult.status === 'pass') {\n    results.push(await checkApiKey(fs, ctx, prompts));\n  }\n\n  return results;\n}\n\n/**\n * Check which AI provider is configured.\n */\nasync function checkAiProvider(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const configPath = fs.join(ctx.workspaceRoot, '.contractsrc.json');\n\n  try {\n    const exists = await fs.exists(configPath);\n    if (!exists) {\n      return {\n        category: 'ai',\n        name: 'AI Provider',\n        status: 'skip',\n        message: 'No config file found',\n      };\n    }\n\n    const content = await fs.readFile(configPath);\n    const config = JSON.parse(content) as {\n      aiProvider?: string;\n      aiModel?: string;\n    };\n\n    const provider = config.aiProvider ?? 'claude';\n    const model = config.aiModel ?? 'default';\n\n    return {\n      category: 'ai',\n      name: 'AI Provider',\n      status: 'pass',\n      message: `Provider: ${provider}, Model: ${model}`,\n    };\n  } catch {\n    return {\n      category: 'ai',\n      name: 'AI Provider',\n      status: 'skip',\n      message: 'Could not read AI config',\n    };\n  }\n}\n\n/**\n * Check if API key is set for the configured provider.\n */\nasync function checkApiKey(\n  fs: FsAdapter,\n  ctx: CheckContext,\n  prompts?: DoctorPromptCallbacks\n): Promise<CheckResult> {\n  const configPath = fs.join(ctx.workspaceRoot, '.contractsrc.json');\n\n  try {\n    const content = await fs.readFile(configPath);\n    const config = JSON.parse(content) as { aiProvider?: string };\n\n    const provider = config.aiProvider ?? 'claude';\n\n    // Map provider to env var\n    const envVarMap: Record<string, string> = {\n      claude: 'ANTHROPIC_API_KEY',\n      openai: 'OPENAI_API_KEY',\n      ollama: '', // Ollama doesn't need API key\n      custom: 'CONTRACTSPEC_LLM_API_KEY',\n    };\n\n    const envVar = envVarMap[provider];\n\n    // Ollama doesn't need an API key\n    if (!envVar) {\n      return {\n        category: 'ai',\n        name: 'API Key',\n        status: 'pass',\n        message: `${provider} does not require an API key`,\n      };\n    }\n\n    const hasKey = !!process.env[envVar];\n\n    if (hasKey) {\n      return {\n        category: 'ai',\n        name: 'API Key',\n        status: 'pass',\n        message: `${envVar} is set`,\n      };\n    }\n\n    return {\n      category: 'ai',\n      name: 'API Key',\n      status: 'warn',\n      message: `${envVar} not set`,\n      details: `Set ${envVar} in your environment to use AI features`,\n      fix: prompts\n        ? {\n            description: `Set ${envVar} environment variable`,\n            apply: async (): Promise<FixResult> => {\n              const key = await prompts.input(\n                `Enter your ${provider} API key:`,\n                { password: true }\n              );\n\n              if (!key) {\n                return { success: false, message: 'No API key provided' };\n              }\n\n              // We can't actually set env vars permanently, but we can create a .env file\n              const envPath = fs.join(ctx.workspaceRoot, '.env');\n              try {\n                let envContent = '';\n                if (await fs.exists(envPath)) {\n                  envContent = await fs.readFile(envPath);\n                  // Check if var already exists\n                  if (envContent.includes(`${envVar}=`)) {\n                    return {\n                      success: false,\n                      message: `${envVar} already in .env, update manually`,\n                    };\n                  }\n                  envContent += '\\n';\n                }\n\n                envContent += `${envVar}=${key}\\n`;\n                await fs.writeFile(envPath, envContent);\n\n                return {\n                  success: true,\n                  message: `Added ${envVar} to .env (restart required)`,\n                };\n              } catch (error) {\n                const msg =\n                  error instanceof Error ? error.message : String(error);\n                return { success: false, message: `Failed: ${msg}` };\n              }\n            },\n          }\n        : undefined,\n    };\n  } catch {\n    return {\n      category: 'ai',\n      name: 'API Key',\n      status: 'skip',\n      message: 'Could not check API key',\n    };\n  }\n}\n"],"mappings":";;;;AAeA,eAAsB,YACpB,IACA,KACA,SACwB;CACxB,MAAMA,UAAyB,EAAE;CAGjC,MAAM,iBAAiB,MAAM,gBAAgB,IAAI,IAAI;AACrD,SAAQ,KAAK,eAAe;AAG5B,KAAI,eAAe,WAAW,OAC5B,SAAQ,KAAK,MAAM,YAAY,IAAI,KAAK,QAAQ,CAAC;AAGnD,QAAO;;;;;AAMT,eAAe,gBACb,IACA,KACsB;CACtB,MAAM,aAAa,GAAG,KAAK,IAAI,eAAe,oBAAoB;AAElE,KAAI;AAEF,MAAI,CADW,MAAM,GAAG,OAAO,WAAW,CAExC,QAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;EAGH,MAAM,UAAU,MAAM,GAAG,SAAS,WAAW;EAC7C,MAAM,SAAS,KAAK,MAAM,QAAQ;AAQlC,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS,aAPM,OAAO,cAAc,SAOL,WANnB,OAAO,WAAW;GAO/B;SACK;AACN,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;;;;;;AAOL,eAAe,YACb,IACA,KACA,SACsB;CACtB,MAAM,aAAa,GAAG,KAAK,IAAI,eAAe,oBAAoB;AAElE,KAAI;EACF,MAAM,UAAU,MAAM,GAAG,SAAS,WAAW;EAG7C,MAAM,WAFS,KAAK,MAAM,QAAQ,CAEV,cAAc;EAUtC,MAAM,SAPoC;GACxC,QAAQ;GACR,QAAQ;GACR,QAAQ;GACR,QAAQ;GACT,CAEwB;AAGzB,MAAI,CAAC,OACH,QAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS,GAAG,SAAS;GACtB;AAKH,MAFe,CAAC,CAAC,QAAQ,IAAI,QAG3B,QAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS,GAAG,OAAO;GACpB;AAGH,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS,GAAG,OAAO;GACnB,SAAS,OAAO,OAAO;GACvB,KAAK,UACD;IACE,aAAa,OAAO,OAAO;IAC3B,OAAO,YAAgC;KACrC,MAAM,MAAM,MAAM,QAAQ,MACxB,cAAc,SAAS,YACvB,EAAE,UAAU,MAAM,CACnB;AAED,SAAI,CAAC,IACH,QAAO;MAAE,SAAS;MAAO,SAAS;MAAuB;KAI3D,MAAM,UAAU,GAAG,KAAK,IAAI,eAAe,OAAO;AAClD,SAAI;MACF,IAAI,aAAa;AACjB,UAAI,MAAM,GAAG,OAAO,QAAQ,EAAE;AAC5B,oBAAa,MAAM,GAAG,SAAS,QAAQ;AAEvC,WAAI,WAAW,SAAS,GAAG,OAAO,GAAG,CACnC,QAAO;QACL,SAAS;QACT,SAAS,GAAG,OAAO;QACpB;AAEH,qBAAc;;AAGhB,oBAAc,GAAG,OAAO,GAAG,IAAI;AAC/B,YAAM,GAAG,UAAU,SAAS,WAAW;AAEvC,aAAO;OACL,SAAS;OACT,SAAS,SAAS,OAAO;OAC1B;cACM,OAAO;AAGd,aAAO;OAAE,SAAS;OAAO,SAAS,WADhC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;OACJ;;;IAGzD,GACD;GACL;SACK;AACN,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV"}