@contractspec/bundle.workspace 1.46.1 → 1.47.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs-service.mjs","names":[],"sources":["../../../src/services/docs/docs-service.ts"],"sourcesContent":["import path from 'path';\nimport {\n  type DocBlock,\n  defaultDocRegistry,\n} from '@contractspec/lib.contracts/docs';\nimport {\n  loadSpecFromSource,\n  convertSpecToDocBlock,\n  scanAllSpecsFromSource,\n  scanSpecSource,\n  type SpecScanResult,\n} from '@contractspec/module.workspace';\nimport type { WorkspaceAdapters } from '../../ports/logger';\nimport { ModuleResolver } from '../modules/module-resolver';\n\nexport interface DocsServiceOptions {\n  outputDir?: string;\n  format?: 'markdown' | 'html' | 'json';\n  rootPath?: string;\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  if (options.outputDir) {\n    await fs.mkdir(options.outputDir);\n  }\n\n  // Initialize ModuleResolver\n  const resolver = new ModuleResolver(adapters);\n  // 1. Scan all specs to build the module index\n  const scanResults: SpecScanResult[] = [];\n  for (const file of specFiles) {\n    try {\n      const content = await fs.readFile(file);\n      const results = scanAllSpecsFromSource(content, file);\n      if (results.length > 0) {\n        scanResults.push(...results);\n      } else {\n        // Fallback if no multi-specs found, try single scan logic\n        const single = scanSpecSource(content, file);\n        if (single.specType !== 'unknown') {\n          scanResults.push(single);\n        }\n      }\n    } catch (_err) {\n      // ignore read errors\n    }\n  }\n\n  resolver.initialize(scanResults);\n\n  for (const file of specFiles) {\n    try {\n      const parsedList = await loadSpecFromSource(file);\n\n      if (parsedList && parsedList.length > 0) {\n        for (const parsed of parsedList) {\n          const block = convertSpecToDocBlock(parsed, {\n            rootPath: options.rootPath,\n          });\n          // Register in global registry\n          defaultDocRegistry.register(block);\n          blocks.push(block);\n          logger.debug(`Generated doc for ${block.id}`);\n\n          if (options.outputDir) {\n            // Determine grouping based on module resolution\n            const moduleDef = resolver.resolve(file);\n            let targetDir = options.outputDir;\n\n            if (moduleDef) {\n              targetDir = path.join(options.outputDir, moduleDef.key);\n            } else {\n              targetDir = path.join(options.outputDir, '_common'); // Fallback for root-level specs\n            }\n\n            // Ensure subdirectory exists\n            await fs.mkdir(targetDir);\n\n            // Flattened structure: [module]/[docId].md\n            const filename = `${block.id}.md`;\n            const filePath = path.join(targetDir, filename);\n            const generatedContent = `<!-- @generated - This file was generated by ContractSpec. Do not edit manually. -->\\n\\n${block.body}`;\n            await fs.writeFile(filePath, generatedContent);\n          }\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    logger.info(`Wrote ${blocks.length} doc files to ${options.outputDir}`);\n  }\n\n  return { blocks, count: blocks.length };\n}\n"],"mappings":";;;;;;;;;AA6BA,eAAsB,sBACpB,WACA,SACA,UAC4B;CAC5B,MAAM,EAAE,IAAI,WAAW;CACvB,MAAM,SAAqB,EAAE;AAE7B,QAAO,KAAK,uBAAuB,UAAU,OAAO,WAAW;AAE/D,KAAI,QAAQ,UACV,OAAM,GAAG,MAAM,QAAQ,UAAU;CAInC,MAAM,WAAW,IAAI,eAAe,SAAS;CAE7C,MAAM,cAAgC,EAAE;AACxC,MAAK,MAAM,QAAQ,UACjB,KAAI;EACF,MAAM,UAAU,MAAM,GAAG,SAAS,KAAK;EACvC,MAAM,UAAU,uBAAuB,SAAS,KAAK;AACrD,MAAI,QAAQ,SAAS,EACnB,aAAY,KAAK,GAAG,QAAQ;OACvB;GAEL,MAAM,SAAS,eAAe,SAAS,KAAK;AAC5C,OAAI,OAAO,aAAa,UACtB,aAAY,KAAK,OAAO;;UAGrB,MAAM;AAKjB,UAAS,WAAW,YAAY;AAEhC,MAAK,MAAM,QAAQ,UACjB,KAAI;EACF,MAAM,aAAa,MAAM,mBAAmB,KAAK;AAEjD,MAAI,cAAc,WAAW,SAAS,EACpC,MAAK,MAAM,UAAU,YAAY;GAC/B,MAAM,QAAQ,sBAAsB,QAAQ,EAC1C,UAAU,QAAQ,UACnB,CAAC;AAEF,sBAAmB,SAAS,MAAM;AAClC,UAAO,KAAK,MAAM;AAClB,UAAO,MAAM,qBAAqB,MAAM,KAAK;AAE7C,OAAI,QAAQ,WAAW;IAErB,MAAM,YAAY,SAAS,QAAQ,KAAK;IACxC,IAAI,YAAY,QAAQ;AAExB,QAAI,UACF,aAAY,KAAK,KAAK,QAAQ,WAAW,UAAU,IAAI;QAEvD,aAAY,KAAK,KAAK,QAAQ,WAAW,UAAU;AAIrD,UAAM,GAAG,MAAM,UAAU;IAGzB,MAAM,WAAW,GAAG,MAAM,GAAG;IAC7B,MAAM,WAAW,KAAK,KAAK,WAAW,SAAS;IAC/C,MAAM,mBAAmB,2FAA2F,MAAM;AAC1H,UAAM,GAAG,UAAU,UAAU,iBAAiB;;;MAIlD,QAAO,KAAK,6BAA6B,OAAO;UAE3C,OAAO;AACd,SAAO,MACL,oBAAoB,KAAK,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GACpF;;AAIL,KAAI,QAAQ,UACV,QAAO,KAAK,SAAS,OAAO,OAAO,gBAAgB,QAAQ,YAAY;AAGzE,QAAO;EAAE;EAAQ,OAAO,OAAO;EAAQ"}

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

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

package/dist/services/docs/index.mjs

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

package/dist/services/doctor/checks/ai.mjs

@@ -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.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai.mjs","names":[],"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,MAAM,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.mjs

@@ -0,0 +1,156 @@
+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("bunx 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 \"bunx 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("bunx 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"
+		};
+		if (ctx.isMonorepo && ctx.packageRoot === ctx.workspaceRoot) {
+			const cliPath = fs.join(ctx.workspaceRoot, "packages/apps/cli-contractspec");
+			if (await fs.exists(cliPath)) return {
+				category: "cli",
+				name: "Local Installation",
+				status: "pass",
+				message: "CLI is part of the workspace (source)"
+			};
+		}
+		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.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"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 { CheckContext, CheckResult, 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('bunx 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 \"bunx 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('bunx 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    // Check if CLI exists in workspace (monorepo source)\n    if (ctx.isMonorepo && ctx.packageRoot === ctx.workspaceRoot) {\n      const cliPath = fs.join(\n        ctx.workspaceRoot,\n        'packages/apps/cli-contractspec'\n      );\n      if (await fs.exists(cliPath)) {\n        return {\n          category: 'cli',\n          name: 'Local Installation',\n          status: 'pass',\n          message: 'CLI is part of the workspace (source)',\n        };\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,MAAM,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,+BAA+B;GAC7C,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,+BAA+B;GAChE,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;AAIH,MAAI,IAAI,cAAc,IAAI,gBAAgB,IAAI,eAAe;GAC3D,MAAM,UAAU,GAAG,KACjB,IAAI,eACJ,iCACD;AACD,OAAI,MAAM,GAAG,OAAO,QAAQ,CAC1B,QAAO;IACL,UAAU;IACV,MAAM;IACN,QAAQ;IACR,SAAS;IACV;;EAIL,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.mjs

@@ -0,0 +1,303 @@
+import { generateContractsrcConfig } from "../../setup/config-generators.mjs";
+import { formatJson } from "../../setup/file-merger.mjs";
+
+//#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));
+	results.push(await checkVersioningConfig(fs, ctx));
+	results.push(await checkHooksConfig(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"
+		};
+	}
+}
+/**
+* Check if versioning configuration is present.
+*/
+async function checkVersioningConfig(fs, ctx) {
+	const configPath = fs.join(ctx.workspaceRoot, ".contractsrc.json");
+	if (!await fs.exists(configPath)) return {
+		category: "config",
+		name: "Versioning Config",
+		status: "skip",
+		message: "Config file does not exist"
+	};
+	try {
+		const content = await fs.readFile(configPath);
+		const config = JSON.parse(content);
+		if (config["versioning"]) return {
+			category: "config",
+			name: "Versioning Config",
+			status: "pass",
+			message: config["versioning"]["integrateWithChangesets"] === true ? "Versioning configured with Changesets integration" : "Versioning configured"
+		};
+		return {
+			category: "config",
+			name: "Versioning Config",
+			status: "warn",
+			message: "Versioning configuration not found",
+			details: "Consider adding versioning config for automated version bumps and changelog generation",
+			fix: {
+				description: "Add versioning configuration with defaults",
+				apply: async () => {
+					try {
+						config["versioning"] = {
+							autoBump: false,
+							bumpStrategy: "impact",
+							changelogTiers: [
+								"spec",
+								"library",
+								"monorepo"
+							],
+							format: "keep-a-changelog",
+							commitChanges: false,
+							createTags: false,
+							integrateWithChangesets: true
+						};
+						await fs.writeFile(configPath, formatJson(config));
+						return {
+							success: true,
+							message: "Added versioning configuration"
+						};
+					} catch (err) {
+						return {
+							success: false,
+							message: `Failed: ${err instanceof Error ? err.message : String(err)}`
+						};
+					}
+				}
+			}
+		};
+	} catch {
+		return {
+			category: "config",
+			name: "Versioning Config",
+			status: "skip",
+			message: "Could not parse config"
+		};
+	}
+}
+/**
+* Check if hooks configuration is present.
+*/
+async function checkHooksConfig(fs, ctx) {
+	const configPath = fs.join(ctx.workspaceRoot, ".contractsrc.json");
+	if (!await fs.exists(configPath)) return {
+		category: "config",
+		name: "Hooks Config",
+		status: "skip",
+		message: "Config file does not exist"
+	};
+	try {
+		const content = await fs.readFile(configPath);
+		const config = JSON.parse(content);
+		if (config["hooks"]) {
+			const hooks = config["hooks"];
+			return {
+				category: "config",
+				name: "Hooks Config",
+				status: "pass",
+				message: `${Object.keys(hooks).length} git hook(s) configured`
+			};
+		}
+		const huskyPath = fs.join(ctx.workspaceRoot, ".husky");
+		if (await fs.exists(huskyPath)) return {
+			category: "config",
+			name: "Hooks Config",
+			status: "warn",
+			message: "Husky detected but no hooks configured in .contractsrc.json",
+			details: "Add hooks config to run contractspec checks from git hooks",
+			fix: {
+				description: "Add pre-commit hooks configuration",
+				apply: async () => {
+					try {
+						config["hooks"] = { "pre-commit": ["contractspec validate **/*.operation.ts", "contractspec integrity check"] };
+						await fs.writeFile(configPath, formatJson(config));
+						return {
+							success: true,
+							message: "Added hooks configuration"
+						};
+					} catch (err) {
+						return {
+							success: false,
+							message: `Failed: ${err instanceof Error ? err.message : String(err)}`
+						};
+					}
+				}
+			}
+		};
+		return {
+			category: "config",
+			name: "Hooks Config",
+			status: "pass",
+			message: "No hooks configured (optional)"
+		};
+	} catch {
+		return {
+			category: "config",
+			name: "Hooks Config",
+			status: "skip",
+			message: "Could not parse config"
+		};
+	}
+}
+
+//#endregion
+export { runConfigChecks };
+//# sourceMappingURL=config.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","names":[],"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  // Check versioning configuration\n  results.push(await checkVersioningConfig(fs, ctx));\n\n  // Check hooks configuration\n  results.push(await checkHooksConfig(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\n/**\n * Check if versioning configuration is present.\n */\nasync function checkVersioningConfig(\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: 'Versioning Config',\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    if (config['versioning']) {\n      const versioning = config['versioning'] as Record<string, unknown>;\n      const hasChangesets = versioning['integrateWithChangesets'] === true;\n\n      return {\n        category: 'config',\n        name: 'Versioning Config',\n        status: 'pass',\n        message: hasChangesets\n          ? 'Versioning configured with Changesets integration'\n          : 'Versioning configured',\n      };\n    }\n\n    return {\n      category: 'config',\n      name: 'Versioning Config',\n      status: 'warn',\n      message: 'Versioning configuration not found',\n      details:\n        'Consider adding versioning config for automated version bumps and changelog generation',\n      fix: {\n        description: 'Add versioning configuration with defaults',\n        apply: async (): Promise<FixResult> => {\n          try {\n            config['versioning'] = {\n              autoBump: false,\n              bumpStrategy: 'impact',\n              changelogTiers: ['spec', 'library', 'monorepo'],\n              format: 'keep-a-changelog',\n              commitChanges: false,\n              createTags: false,\n              integrateWithChangesets: true,\n            };\n            await fs.writeFile(configPath, formatJson(config));\n            return { success: true, message: 'Added versioning configuration' };\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: 'Versioning Config',\n      status: 'skip',\n      message: 'Could not parse config',\n    };\n  }\n}\n\n/**\n * Check if hooks configuration is present.\n */\nasync function checkHooksConfig(\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: 'Hooks Config',\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    if (config['hooks']) {\n      const hooks = config['hooks'] as Record<string, unknown>;\n      const hookCount = Object.keys(hooks).length;\n\n      return {\n        category: 'config',\n        name: 'Hooks Config',\n        status: 'pass',\n        message: `${hookCount} git hook(s) configured`,\n      };\n    }\n\n    // Check if husky is installed\n    const huskyPath = fs.join(ctx.workspaceRoot, '.husky');\n    const hasHusky = await fs.exists(huskyPath);\n\n    if (hasHusky) {\n      return {\n        category: 'config',\n        name: 'Hooks Config',\n        status: 'warn',\n        message: 'Husky detected but no hooks configured in .contractsrc.json',\n        details: 'Add hooks config to run contractspec checks from git hooks',\n        fix: {\n          description: 'Add pre-commit hooks configuration',\n          apply: async (): Promise<FixResult> => {\n            try {\n              config['hooks'] = {\n                'pre-commit': [\n                  'contractspec validate **/*.operation.ts',\n                  'contractspec integrity check',\n                ],\n              };\n              await fs.writeFile(configPath, formatJson(config));\n              return { success: true, message: 'Added hooks configuration' };\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    return {\n      category: 'config',\n      name: 'Hooks Config',\n      status: 'pass',\n      message: 'No hooks configured (optional)',\n    };\n  } catch {\n    return {\n      category: 'config',\n      name: 'Hooks Config',\n      status: 'skip',\n      message: 'Could not parse config',\n    };\n  }\n}\n"],"mappings":"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"}