@contractspec/bundle.workspace 1.44.0

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 "@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.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

@@ -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.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 '@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,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

@@ -0,0 +1,119 @@
+//#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"}

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

@@ -0,0 +1,147 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+
+//#region src/services/doctor/checks/cli.ts
+/**
+* CLI installation health checks.
+*/
+const execAsync = promisify(exec);
+/**
+* Run CLI-related health checks.
+*/
+async function runCliChecks(fs, ctx) {
+	const results = [];
+	results.push(await checkCliAccessible(ctx));
+	results.push(await checkCliVersion(ctx));
+	results.push(await checkCliInstallLocation(fs, ctx));
+	return results;
+}
+/**
+* Check if the CLI is accessible.
+*/
+async function checkCliAccessible(ctx) {
+	try {
+		await execAsync("npx contractspec --version", {
+			cwd: ctx.workspaceRoot,
+			timeout: 1e4
+		});
+		return {
+			category: "cli",
+			name: "CLI Accessible",
+			status: "pass",
+			message: "ContractSpec CLI is accessible"
+		};
+	} catch {
+		return {
+			category: "cli",
+			name: "CLI Accessible",
+			status: "fail",
+			message: "ContractSpec CLI is not accessible",
+			details: "Could not run \"npx contractspec --version\"",
+			fix: {
+				description: "Install ContractSpec CLI globally",
+				apply: async () => {
+					try {
+						await execAsync("npm install -g @contractspec/app.cli-contractspec", {
+							cwd: ctx.workspaceRoot,
+							timeout: 6e4
+						});
+						return {
+							success: true,
+							message: "CLI installed globally"
+						};
+					} catch (error) {
+						return {
+							success: false,
+							message: `Failed to install: ${error instanceof Error ? error.message : String(error)}`
+						};
+					}
+				}
+			}
+		};
+	}
+}
+/**
+* Check CLI version.
+*/
+async function checkCliVersion(ctx) {
+	try {
+		const { stdout } = await execAsync("npx contractspec --version", {
+			cwd: ctx.workspaceRoot,
+			timeout: 1e4
+		});
+		return {
+			category: "cli",
+			name: "CLI Version",
+			status: "pass",
+			message: `CLI version: ${stdout.trim()}`
+		};
+	} catch {
+		return {
+			category: "cli",
+			name: "CLI Version",
+			status: "skip",
+			message: "Could not determine CLI version"
+		};
+	}
+}
+/**
+* Check if CLI is installed locally in the project.
+*/
+async function checkCliInstallLocation(fs, ctx) {
+	const packageJsonPath = fs.join(ctx.workspaceRoot, "package.json");
+	try {
+		if (!await fs.exists(packageJsonPath)) return {
+			category: "cli",
+			name: "Local Installation",
+			status: "skip",
+			message: "No package.json found"
+		};
+		const content = await fs.readFile(packageJsonPath);
+		const pkg = JSON.parse(content);
+		if (pkg.dependencies?.["@contractspec/app.cli-contractspec"] !== void 0 || pkg.devDependencies?.["@contractspec/app.cli-contractspec"] !== void 0) return {
+			category: "cli",
+			name: "Local Installation",
+			status: "pass",
+			message: "CLI is installed as a project dependency"
+		};
+		return {
+			category: "cli",
+			name: "Local Installation",
+			status: "warn",
+			message: "CLI is not installed as a project dependency",
+			details: "Consider adding @contractspec/app.cli-contractspec to devDependencies",
+			fix: {
+				description: "Add CLI as a dev dependency",
+				apply: async () => {
+					try {
+						await execAsync("npm install -D @contractspec/app.cli-contractspec", {
+							cwd: ctx.workspaceRoot,
+							timeout: 6e4
+						});
+						return {
+							success: true,
+							message: "CLI added as dev dependency"
+						};
+					} catch (error) {
+						return {
+							success: false,
+							message: `Failed to install: ${error instanceof Error ? error.message : String(error)}`
+						};
+					}
+				}
+			}
+		};
+	} catch {
+		return {
+			category: "cli",
+			name: "Local Installation",
+			status: "skip",
+			message: "Could not check local installation"
+		};
+	}
+}
+
+//#endregion
+export { runCliChecks };
+//# sourceMappingURL=cli.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","names":["results: CheckResult[]"],"sources":["../../../../src/services/doctor/checks/cli.ts"],"sourcesContent":["/**\n * CLI installation health checks.\n */\n\nimport { exec } from 'node:child_process';\nimport { promisify } from 'node:util';\nimport type { FsAdapter } from '../../../ports/fs';\nimport type { CheckResult, CheckContext, FixResult } from '../types';\n\nconst execAsync = promisify(exec);\n\n/**\n * Run CLI-related health checks.\n */\nexport async function runCliChecks(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  // Check if CLI is accessible\n  results.push(await checkCliAccessible(ctx));\n\n  // Check CLI version\n  results.push(await checkCliVersion(ctx));\n\n  // Check if CLI is installed globally or locally\n  results.push(await checkCliInstallLocation(fs, ctx));\n\n  return results;\n}\n\n/**\n * Check if the CLI is accessible.\n */\nasync function checkCliAccessible(ctx: CheckContext): Promise<CheckResult> {\n  try {\n    await execAsync('npx contractspec --version', {\n      cwd: ctx.workspaceRoot,\n      timeout: 10000,\n    });\n\n    return {\n      category: 'cli',\n      name: 'CLI Accessible',\n      status: 'pass',\n      message: 'ContractSpec CLI is accessible',\n    };\n  } catch {\n    return {\n      category: 'cli',\n      name: 'CLI Accessible',\n      status: 'fail',\n      message: 'ContractSpec CLI is not accessible',\n      details: 'Could not run \"npx contractspec --version\"',\n      fix: {\n        description: 'Install ContractSpec CLI globally',\n        apply: async (): Promise<FixResult> => {\n          try {\n            await execAsync(\n              'npm install -g @contractspec/app.cli-contractspec',\n              {\n                cwd: ctx.workspaceRoot,\n                timeout: 60000,\n              }\n            );\n            return { success: true, message: 'CLI installed globally' };\n          } catch (error) {\n            const msg = error instanceof Error ? error.message : String(error);\n            return { success: false, message: `Failed to install: ${msg}` };\n          }\n        },\n      },\n    };\n  }\n}\n\n/**\n * Check CLI version.\n */\nasync function checkCliVersion(ctx: CheckContext): Promise<CheckResult> {\n  try {\n    const { stdout } = await execAsync('npx contractspec --version', {\n      cwd: ctx.workspaceRoot,\n      timeout: 10000,\n    });\n\n    const version = stdout.trim();\n\n    return {\n      category: 'cli',\n      name: 'CLI Version',\n      status: 'pass',\n      message: `CLI version: ${version}`,\n    };\n  } catch {\n    return {\n      category: 'cli',\n      name: 'CLI Version',\n      status: 'skip',\n      message: 'Could not determine CLI version',\n    };\n  }\n}\n\n/**\n * Check if CLI is installed locally in the project.\n */\nasync function checkCliInstallLocation(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const packageJsonPath = fs.join(ctx.workspaceRoot, 'package.json');\n\n  try {\n    const exists = await fs.exists(packageJsonPath);\n    if (!exists) {\n      return {\n        category: 'cli',\n        name: 'Local Installation',\n        status: 'skip',\n        message: 'No package.json found',\n      };\n    }\n\n    const content = await fs.readFile(packageJsonPath);\n    const pkg = JSON.parse(content) as {\n      dependencies?: Record<string, string>;\n      devDependencies?: Record<string, string>;\n    };\n\n    const hasDep =\n      pkg.dependencies?.['@contractspec/app.cli-contractspec'] !== undefined ||\n      pkg.devDependencies?.['@contractspec/app.cli-contractspec'] !== undefined;\n\n    if (hasDep) {\n      return {\n        category: 'cli',\n        name: 'Local Installation',\n        status: 'pass',\n        message: 'CLI is installed as a project dependency',\n      };\n    }\n\n    return {\n      category: 'cli',\n      name: 'Local Installation',\n      status: 'warn',\n      message: 'CLI is not installed as a project dependency',\n      details:\n        'Consider adding @contractspec/app.cli-contractspec to devDependencies',\n      fix: {\n        description: 'Add CLI as a dev dependency',\n        apply: async (): Promise<FixResult> => {\n          try {\n            await execAsync(\n              'npm install -D @contractspec/app.cli-contractspec',\n              {\n                cwd: ctx.workspaceRoot,\n                timeout: 60000,\n              }\n            );\n            return { success: true, message: 'CLI added as dev dependency' };\n          } catch (error) {\n            const msg = error instanceof Error ? error.message : String(error);\n            return { success: false, message: `Failed to install: ${msg}` };\n          }\n        },\n      },\n    };\n  } catch {\n    return {\n      category: 'cli',\n      name: 'Local Installation',\n      status: 'skip',\n      message: 'Could not check local installation',\n    };\n  }\n}\n"],"mappings":";;;;;;;AASA,MAAM,YAAY,UAAU,KAAK;;;;AAKjC,eAAsB,aACpB,IACA,KACwB;CACxB,MAAMA,UAAyB,EAAE;AAGjC,SAAQ,KAAK,MAAM,mBAAmB,IAAI,CAAC;AAG3C,SAAQ,KAAK,MAAM,gBAAgB,IAAI,CAAC;AAGxC,SAAQ,KAAK,MAAM,wBAAwB,IAAI,IAAI,CAAC;AAEpD,QAAO;;;;;AAMT,eAAe,mBAAmB,KAAyC;AACzE,KAAI;AACF,QAAM,UAAU,8BAA8B;GAC5C,KAAK,IAAI;GACT,SAAS;GACV,CAAC;AAEF,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;SACK;AACN,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACT,SAAS;GACT,KAAK;IACH,aAAa;IACb,OAAO,YAAgC;AACrC,SAAI;AACF,YAAM,UACJ,qDACA;OACE,KAAK,IAAI;OACT,SAAS;OACV,CACF;AACD,aAAO;OAAE,SAAS;OAAM,SAAS;OAA0B;cACpD,OAAO;AAEd,aAAO;OAAE,SAAS;OAAO,SAAS,sBADtB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;OACH;;;IAGpE;GACF;;;;;;AAOL,eAAe,gBAAgB,KAAyC;AACtE,KAAI;EACF,MAAM,EAAE,WAAW,MAAM,UAAU,8BAA8B;GAC/D,KAAK,IAAI;GACT,SAAS;GACV,CAAC;AAIF,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS,gBANK,OAAO,MAAM;GAO5B;SACK;AACN,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;;;;;;AAOL,eAAe,wBACb,IACA,KACsB;CACtB,MAAM,kBAAkB,GAAG,KAAK,IAAI,eAAe,eAAe;AAElE,KAAI;AAEF,MAAI,CADW,MAAM,GAAG,OAAO,gBAAgB,CAE7C,QAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;EAGH,MAAM,UAAU,MAAM,GAAG,SAAS,gBAAgB;EAClD,MAAM,MAAM,KAAK,MAAM,QAAQ;AAS/B,MAHE,IAAI,eAAe,0CAA0C,UAC7D,IAAI,kBAAkB,0CAA0C,OAGhE,QAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;AAGH,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACT,SACE;GACF,KAAK;IACH,aAAa;IACb,OAAO,YAAgC;AACrC,SAAI;AACF,YAAM,UACJ,qDACA;OACE,KAAK,IAAI;OACT,SAAS;OACV,CACF;AACD,aAAO;OAAE,SAAS;OAAM,SAAS;OAA+B;cACzD,OAAO;AAEd,aAAO;OAAE,SAAS;OAAO,SAAS,sBADtB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;OACH;;;IAGpE;GACF;SACK;AACN,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV"}

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

@@ -0,0 +1,171 @@
+import { generateContractsrcConfig } from "../../setup/config-generators.js";
+import { formatJson } from "../../setup/file-merger.js";
+
+//#region src/services/doctor/checks/config.ts
+/**
+* Run configuration-related health checks.
+*/
+async function runConfigChecks(fs, ctx) {
+	const results = [];
+	results.push(await checkContractsrcExists(fs, ctx));
+	results.push(await checkContractsrcValid(fs, ctx));
+	results.push(await checkContractsrcFields(fs, ctx));
+	return results;
+}
+/**
+* Check if .contractsrc.json exists.
+*/
+async function checkContractsrcExists(fs, ctx) {
+	const configPath = fs.join(ctx.workspaceRoot, ".contractsrc.json");
+	if (await fs.exists(configPath)) return {
+		category: "config",
+		name: "Config File Exists",
+		status: "pass",
+		message: ".contractsrc.json found"
+	};
+	return {
+		category: "config",
+		name: "Config File Exists",
+		status: "fail",
+		message: ".contractsrc.json not found",
+		fix: {
+			description: "Create .contractsrc.json with defaults",
+			apply: async () => {
+				try {
+					const defaults = generateContractsrcConfig({
+						workspaceRoot: ctx.workspaceRoot,
+						interactive: false,
+						targets: []
+					});
+					await fs.writeFile(configPath, formatJson(defaults));
+					return {
+						success: true,
+						message: "Created .contractsrc.json"
+					};
+				} catch (error) {
+					return {
+						success: false,
+						message: `Failed to create: ${error instanceof Error ? error.message : String(error)}`
+					};
+				}
+			}
+		}
+	};
+}
+/**
+* Check if .contractsrc.json is valid JSON.
+*/
+async function checkContractsrcValid(fs, ctx) {
+	const configPath = fs.join(ctx.workspaceRoot, ".contractsrc.json");
+	if (!await fs.exists(configPath)) return {
+		category: "config",
+		name: "Config Valid JSON",
+		status: "skip",
+		message: "Config file does not exist"
+	};
+	try {
+		const content = await fs.readFile(configPath);
+		JSON.parse(content);
+		return {
+			category: "config",
+			name: "Config Valid JSON",
+			status: "pass",
+			message: ".contractsrc.json is valid JSON"
+		};
+	} catch (error) {
+		return {
+			category: "config",
+			name: "Config Valid JSON",
+			status: "fail",
+			message: ".contractsrc.json is not valid JSON",
+			details: error instanceof Error ? error.message : String(error),
+			fix: {
+				description: "Replace with valid default config",
+				apply: async () => {
+					try {
+						const defaults = generateContractsrcConfig({
+							workspaceRoot: ctx.workspaceRoot,
+							interactive: false,
+							targets: []
+						});
+						await fs.writeFile(configPath, formatJson(defaults));
+						return {
+							success: true,
+							message: "Replaced with valid config"
+						};
+					} catch (err) {
+						return {
+							success: false,
+							message: `Failed: ${err instanceof Error ? err.message : String(err)}`
+						};
+					}
+				}
+			}
+		};
+	}
+}
+/**
+* Check required fields in .contractsrc.json.
+*/
+async function checkContractsrcFields(fs, ctx) {
+	const configPath = fs.join(ctx.workspaceRoot, ".contractsrc.json");
+	if (!await fs.exists(configPath)) return {
+		category: "config",
+		name: "Config Fields",
+		status: "skip",
+		message: "Config file does not exist"
+	};
+	try {
+		const content = await fs.readFile(configPath);
+		const config = JSON.parse(content);
+		const missingFields = [];
+		if (!config["outputDir"]) missingFields.push("outputDir");
+		if (!config["conventions"]) missingFields.push("conventions");
+		if (missingFields.length === 0) return {
+			category: "config",
+			name: "Config Fields",
+			status: "pass",
+			message: "All recommended fields present"
+		};
+		return {
+			category: "config",
+			name: "Config Fields",
+			status: "warn",
+			message: `Missing recommended fields: ${missingFields.join(", ")}`,
+			fix: {
+				description: "Add missing fields with defaults",
+				apply: async () => {
+					try {
+						const defaults = generateContractsrcConfig({
+							workspaceRoot: ctx.workspaceRoot,
+							interactive: false,
+							targets: []
+						});
+						for (const field of missingFields) if (defaults[field] !== void 0) config[field] = defaults[field];
+						await fs.writeFile(configPath, formatJson(config));
+						return {
+							success: true,
+							message: "Added missing fields"
+						};
+					} catch (err) {
+						return {
+							success: false,
+							message: `Failed: ${err instanceof Error ? err.message : String(err)}`
+						};
+					}
+				}
+			}
+		};
+	} catch {
+		return {
+			category: "config",
+			name: "Config Fields",
+			status: "skip",
+			message: "Could not parse config"
+		};
+	}
+}
+
+//#endregion
+export { runConfigChecks };
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":["results: CheckResult[]","missingFields: string[]"],"sources":["../../../../src/services/doctor/checks/config.ts"],"sourcesContent":["/**\n * Configuration file health checks.\n */\n\nimport type { FsAdapter } from '../../../ports/fs';\nimport type { CheckResult, CheckContext, FixResult } from '../types';\nimport { generateContractsrcConfig } from '../../setup/config-generators';\nimport { formatJson } from '../../setup/file-merger';\n\n/**\n * Run configuration-related health checks.\n */\nexport async function runConfigChecks(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  // Check if .contractsrc.json exists\n  results.push(await checkContractsrcExists(fs, ctx));\n\n  // Check if .contractsrc.json is valid\n  results.push(await checkContractsrcValid(fs, ctx));\n\n  // Check required fields in config\n  results.push(await checkContractsrcFields(fs, ctx));\n\n  return results;\n}\n\n/**\n * Check if .contractsrc.json exists.\n */\nasync function checkContractsrcExists(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const configPath = fs.join(ctx.workspaceRoot, '.contractsrc.json');\n\n  const exists = await fs.exists(configPath);\n  if (exists) {\n    return {\n      category: 'config',\n      name: 'Config File Exists',\n      status: 'pass',\n      message: '.contractsrc.json found',\n    };\n  }\n\n  return {\n    category: 'config',\n    name: 'Config File Exists',\n    status: 'fail',\n    message: '.contractsrc.json not found',\n    fix: {\n      description: 'Create .contractsrc.json with defaults',\n      apply: async (): Promise<FixResult> => {\n        try {\n          const defaults = generateContractsrcConfig({\n            workspaceRoot: ctx.workspaceRoot,\n            interactive: false,\n            targets: [],\n          });\n          await fs.writeFile(configPath, formatJson(defaults));\n          return { success: true, message: 'Created .contractsrc.json' };\n        } catch (error) {\n          const msg = error instanceof Error ? error.message : String(error);\n          return { success: false, message: `Failed to create: ${msg}` };\n        }\n      },\n    },\n  };\n}\n\n/**\n * Check if .contractsrc.json is valid JSON.\n */\nasync function checkContractsrcValid(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const configPath = fs.join(ctx.workspaceRoot, '.contractsrc.json');\n\n  const exists = await fs.exists(configPath);\n  if (!exists) {\n    return {\n      category: 'config',\n      name: 'Config Valid JSON',\n      status: 'skip',\n      message: 'Config file does not exist',\n    };\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    JSON.parse(content);\n\n    return {\n      category: 'config',\n      name: 'Config Valid JSON',\n      status: 'pass',\n      message: '.contractsrc.json is valid JSON',\n    };\n  } catch (error) {\n    const msg = error instanceof Error ? error.message : String(error);\n\n    return {\n      category: 'config',\n      name: 'Config Valid JSON',\n      status: 'fail',\n      message: '.contractsrc.json is not valid JSON',\n      details: msg,\n      fix: {\n        description: 'Replace with valid default config',\n        apply: async (): Promise<FixResult> => {\n          try {\n            const defaults = generateContractsrcConfig({\n              workspaceRoot: ctx.workspaceRoot,\n              interactive: false,\n              targets: [],\n            });\n            await fs.writeFile(configPath, formatJson(defaults));\n            return { success: true, message: 'Replaced with valid config' };\n          } catch (err) {\n            const m = err instanceof Error ? err.message : String(err);\n            return { success: false, message: `Failed: ${m}` };\n          }\n        },\n      },\n    };\n  }\n}\n\n/**\n * Check required fields in .contractsrc.json.\n */\nasync function checkContractsrcFields(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const configPath = fs.join(ctx.workspaceRoot, '.contractsrc.json');\n\n  const exists = await fs.exists(configPath);\n  if (!exists) {\n    return {\n      category: 'config',\n      name: 'Config Fields',\n      status: 'skip',\n      message: 'Config file does not exist',\n    };\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    const config = JSON.parse(content) as Record<string, unknown>;\n\n    const missingFields: string[] = [];\n\n    // Check for recommended fields\n    if (!config['outputDir']) {\n      missingFields.push('outputDir');\n    }\n    if (!config['conventions']) {\n      missingFields.push('conventions');\n    }\n\n    if (missingFields.length === 0) {\n      return {\n        category: 'config',\n        name: 'Config Fields',\n        status: 'pass',\n        message: 'All recommended fields present',\n      };\n    }\n\n    return {\n      category: 'config',\n      name: 'Config Fields',\n      status: 'warn',\n      message: `Missing recommended fields: ${missingFields.join(', ')}`,\n      fix: {\n        description: 'Add missing fields with defaults',\n        apply: async (): Promise<FixResult> => {\n          try {\n            const defaults = generateContractsrcConfig({\n              workspaceRoot: ctx.workspaceRoot,\n              interactive: false,\n              targets: [],\n            }) as Record<string, unknown>;\n\n            // Merge missing fields\n            for (const field of missingFields) {\n              if (defaults[field] !== undefined) {\n                config[field] = defaults[field];\n              }\n            }\n\n            await fs.writeFile(configPath, formatJson(config));\n            return { success: true, message: 'Added missing fields' };\n          } catch (err) {\n            const m = err instanceof Error ? err.message : String(err);\n            return { success: false, message: `Failed: ${m}` };\n          }\n        },\n      },\n    };\n  } catch {\n    return {\n      category: 'config',\n      name: 'Config Fields',\n      status: 'skip',\n      message: 'Could not parse config',\n    };\n  }\n}\n"],"mappings":";;;;;;;AAYA,eAAsB,gBACpB,IACA,KACwB;CACxB,MAAMA,UAAyB,EAAE;AAGjC,SAAQ,KAAK,MAAM,uBAAuB,IAAI,IAAI,CAAC;AAGnD,SAAQ,KAAK,MAAM,sBAAsB,IAAI,IAAI,CAAC;AAGlD,SAAQ,KAAK,MAAM,uBAAuB,IAAI,IAAI,CAAC;AAEnD,QAAO;;;;;AAMT,eAAe,uBACb,IACA,KACsB;CACtB,MAAM,aAAa,GAAG,KAAK,IAAI,eAAe,oBAAoB;AAGlE,KADe,MAAM,GAAG,OAAO,WAAW,CAExC,QAAO;EACL,UAAU;EACV,MAAM;EACN,QAAQ;EACR,SAAS;EACV;AAGH,QAAO;EACL,UAAU;EACV,MAAM;EACN,QAAQ;EACR,SAAS;EACT,KAAK;GACH,aAAa;GACb,OAAO,YAAgC;AACrC,QAAI;KACF,MAAM,WAAW,0BAA0B;MACzC,eAAe,IAAI;MACnB,aAAa;MACb,SAAS,EAAE;MACZ,CAAC;AACF,WAAM,GAAG,UAAU,YAAY,WAAW,SAAS,CAAC;AACpD,YAAO;MAAE,SAAS;MAAM,SAAS;MAA6B;aACvD,OAAO;AAEd,YAAO;MAAE,SAAS;MAAO,SAAS,qBADtB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;MACJ;;;GAGnE;EACF;;;;;AAMH,eAAe,sBACb,IACA,KACsB;CACtB,MAAM,aAAa,GAAG,KAAK,IAAI,eAAe,oBAAoB;AAGlE,KAAI,CADW,MAAM,GAAG,OAAO,WAAW,CAExC,QAAO;EACL,UAAU;EACV,MAAM;EACN,QAAQ;EACR,SAAS;EACV;AAGH,KAAI;EACF,MAAM,UAAU,MAAM,GAAG,SAAS,WAAW;AAC7C,OAAK,MAAM,QAAQ;AAEnB,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;UACM,OAAO;AAGd,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACT,SAPU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAQhE,KAAK;IACH,aAAa;IACb,OAAO,YAAgC;AACrC,SAAI;MACF,MAAM,WAAW,0BAA0B;OACzC,eAAe,IAAI;OACnB,aAAa;OACb,SAAS,EAAE;OACZ,CAAC;AACF,YAAM,GAAG,UAAU,YAAY,WAAW,SAAS,CAAC;AACpD,aAAO;OAAE,SAAS;OAAM,SAAS;OAA8B;cACxD,KAAK;AAEZ,aAAO;OAAE,SAAS;OAAO,SAAS,WADxB,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;OACR;;;IAGvD;GACF;;;;;;AAOL,eAAe,uBACb,IACA,KACsB;CACtB,MAAM,aAAa,GAAG,KAAK,IAAI,eAAe,oBAAoB;AAGlE,KAAI,CADW,MAAM,GAAG,OAAO,WAAW,CAExC,QAAO;EACL,UAAU;EACV,MAAM;EACN,QAAQ;EACR,SAAS;EACV;AAGH,KAAI;EACF,MAAM,UAAU,MAAM,GAAG,SAAS,WAAW;EAC7C,MAAM,SAAS,KAAK,MAAM,QAAQ;EAElC,MAAMC,gBAA0B,EAAE;AAGlC,MAAI,CAAC,OAAO,aACV,eAAc,KAAK,YAAY;AAEjC,MAAI,CAAC,OAAO,eACV,eAAc,KAAK,cAAc;AAGnC,MAAI,cAAc,WAAW,EAC3B,QAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;AAGH,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS,+BAA+B,cAAc,KAAK,KAAK;GAChE,KAAK;IACH,aAAa;IACb,OAAO,YAAgC;AACrC,SAAI;MACF,MAAM,WAAW,0BAA0B;OACzC,eAAe,IAAI;OACnB,aAAa;OACb,SAAS,EAAE;OACZ,CAAC;AAGF,WAAK,MAAM,SAAS,cAClB,KAAI,SAAS,WAAW,OACtB,QAAO,SAAS,SAAS;AAI7B,YAAM,GAAG,UAAU,YAAY,WAAW,OAAO,CAAC;AAClD,aAAO;OAAE,SAAS;OAAM,SAAS;OAAwB;cAClD,KAAK;AAEZ,aAAO;OAAE,SAAS;OAAO,SAAS,WADxB,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;OACR;;;IAGvD;GACF;SACK;AACN,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV"}