@contractspec/bundle.workspace 1.46.2 → 1.48.0

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

@@ -0,0 +1,139 @@
+import { discoverLayers } from "../../layer-discovery.mjs";
+
+//#region src/services/doctor/checks/layers.ts
+/**
+* Run all layer health checks.
+*/
+async function runLayerChecks(fs, _ctx) {
+	const results = [];
+	const discovery = await discoverLayers({
+		fs,
+		logger: {
+			info: () => {},
+			warn: () => {},
+			error: () => {},
+			debug: () => {},
+			createProgress: () => ({
+				start: () => {},
+				update: () => {},
+				succeed: () => {},
+				fail: () => {},
+				warn: () => {},
+				stop: () => {},
+				finish: () => {}
+			})
+		}
+	}, {});
+	results.push(checkHasFeatures(discovery.stats.features));
+	results.push(checkHasExamples(discovery.stats.examples));
+	results.push(checkFeatureOwners(discovery.inventory.features));
+	results.push(checkExampleEntrypoints(discovery.inventory.examples));
+	results.push(checkWorkspaceConfigs(discovery.inventory.workspaceConfigs));
+	return results;
+}
+/**
+* Check if workspace has features defined.
+*/
+function checkHasFeatures(count) {
+	if (count > 0) return {
+		category: "layers",
+		name: "Features Defined",
+		status: "pass",
+		message: `Found ${count} feature module(s)`
+	};
+	return {
+		category: "layers",
+		name: "Features Defined",
+		status: "warn",
+		message: "No feature modules found",
+		details: "Create a .feature.ts file to organize your specs into features"
+	};
+}
+/**
+* Check if workspace has examples defined.
+*/
+function checkHasExamples(count) {
+	if (count > 0) return {
+		category: "layers",
+		name: "Examples Defined",
+		status: "pass",
+		message: `Found ${count} example(s)`
+	};
+	return {
+		category: "layers",
+		name: "Examples Defined",
+		status: "skip",
+		message: "No examples found (optional)",
+		details: "Create an example.ts file to package reusable templates"
+	};
+}
+/**
+* Check if features have owners defined.
+*/
+function checkFeatureOwners(features) {
+	const missingOwners = [];
+	for (const [key, feature] of features) if (!feature.owners?.length) missingOwners.push(key);
+	if (missingOwners.length === 0) return {
+		category: "layers",
+		name: "Feature Owners",
+		status: features.size > 0 ? "pass" : "skip",
+		message: features.size > 0 ? "All features have owners defined" : "No features to check"
+	};
+	return {
+		category: "layers",
+		name: "Feature Owners",
+		status: "warn",
+		message: `${missingOwners.length} feature(s) missing owners`,
+		details: `Features: ${missingOwners.slice(0, 3).join(", ")}${missingOwners.length > 3 ? "..." : ""}`
+	};
+}
+/**
+* Check if examples have valid entrypoints.
+*/
+function checkExampleEntrypoints(examples) {
+	const missingPackage = [];
+	for (const [key, example] of examples) if (!example.entrypoints.packageName) missingPackage.push(key);
+	if (missingPackage.length === 0) return {
+		category: "layers",
+		name: "Example Entrypoints",
+		status: examples.size > 0 ? "pass" : "skip",
+		message: examples.size > 0 ? "All examples have valid entrypoints" : "No examples to check"
+	};
+	return {
+		category: "layers",
+		name: "Example Entrypoints",
+		status: "fail",
+		message: `${missingPackage.length} example(s) missing packageName`,
+		details: `Examples: ${missingPackage.join(", ")}`
+	};
+}
+/**
+* Check if workspace configs are valid.
+*/
+function checkWorkspaceConfigs(configs) {
+	const invalid = [];
+	for (const [, config] of configs) if (!config.valid) invalid.push(config.file);
+	if (configs.size === 0) return {
+		category: "layers",
+		name: "Workspace Configs",
+		status: "skip",
+		message: "No .contractsrc.json files found"
+	};
+	if (invalid.length === 0) return {
+		category: "layers",
+		name: "Workspace Configs",
+		status: "pass",
+		message: `All ${configs.size} workspace config(s) are valid`
+	};
+	return {
+		category: "layers",
+		name: "Workspace Configs",
+		status: "fail",
+		message: `${invalid.length} workspace config(s) invalid`,
+		details: `Files: ${invalid.join(", ")}`
+	};
+}
+
+//#endregion
+export { runLayerChecks };
+//# sourceMappingURL=layers.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layers.mjs","names":[],"sources":["../../../../src/services/doctor/checks/layers.ts"],"sourcesContent":["/**\n * Layer health checks.\n *\n * Validates contract layers (features, examples, app-configs, workspace-configs).\n */\n\nimport type { FsAdapter } from '../../../ports/fs';\nimport type { CheckContext, CheckResult } from '../types';\nimport { discoverLayers } from '../../layer-discovery';\n\n/**\n * Run all layer health checks.\n */\nexport async function runLayerChecks(\n  fs: FsAdapter,\n  _ctx: CheckContext\n): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  // Discover layers\n  const discovery = await discoverLayers(\n    {\n      fs,\n      logger: {\n        // eslint-disable-next-line @typescript-eslint/no-empty-function\n        info: () => {},\n        // eslint-disable-next-line @typescript-eslint/no-empty-function\n        warn: () => {},\n        // eslint-disable-next-line @typescript-eslint/no-empty-function\n        error: () => {},\n        // eslint-disable-next-line @typescript-eslint/no-empty-function\n        debug: () => {},\n        createProgress: () => ({\n          // eslint-disable-next-line @typescript-eslint/no-empty-function\n          start: () => {},\n          // eslint-disable-next-line @typescript-eslint/no-empty-function\n          update: () => {},\n          // eslint-disable-next-line @typescript-eslint/no-empty-function\n          succeed: () => {},\n          // eslint-disable-next-line @typescript-eslint/no-empty-function\n          fail: () => {},\n          // eslint-disable-next-line @typescript-eslint/no-empty-function\n          warn: () => {},\n          // eslint-disable-next-line @typescript-eslint/no-empty-function\n          stop: () => {},\n          // eslint-disable-next-line @typescript-eslint/no-empty-function\n          finish: () => {},\n        }),\n      },\n    },\n    {}\n  );\n\n  // Check: Has features\n  results.push(checkHasFeatures(discovery.stats.features));\n\n  // Check: Has examples\n  results.push(checkHasExamples(discovery.stats.examples));\n\n  // Check: Features have owners\n  results.push(checkFeatureOwners(discovery.inventory.features));\n\n  // Check: Examples have valid entrypoints\n  results.push(checkExampleEntrypoints(discovery.inventory.examples));\n\n  // Check: Workspace configs are valid\n  results.push(checkWorkspaceConfigs(discovery.inventory.workspaceConfigs));\n\n  return results;\n}\n\n/**\n * Check if workspace has features defined.\n */\nfunction checkHasFeatures(count: number): CheckResult {\n  if (count > 0) {\n    return {\n      category: 'layers',\n      name: 'Features Defined',\n      status: 'pass',\n      message: `Found ${count} feature module(s)`,\n    };\n  }\n\n  return {\n    category: 'layers',\n    name: 'Features Defined',\n    status: 'warn',\n    message: 'No feature modules found',\n    details: 'Create a .feature.ts file to organize your specs into features',\n  };\n}\n\n/**\n * Check if workspace has examples defined.\n */\nfunction checkHasExamples(count: number): CheckResult {\n  if (count > 0) {\n    return {\n      category: 'layers',\n      name: 'Examples Defined',\n      status: 'pass',\n      message: `Found ${count} example(s)`,\n    };\n  }\n\n  return {\n    category: 'layers',\n    name: 'Examples Defined',\n    status: 'skip',\n    message: 'No examples found (optional)',\n    details: 'Create an example.ts file to package reusable templates',\n  };\n}\n\n/**\n * Check if features have owners defined.\n */\nfunction checkFeatureOwners(\n  features: Map<string, { owners?: string[]; filePath: string }>\n): CheckResult {\n  const missingOwners: string[] = [];\n\n  for (const [key, feature] of features) {\n    if (!feature.owners?.length) {\n      missingOwners.push(key);\n    }\n  }\n\n  if (missingOwners.length === 0) {\n    return {\n      category: 'layers',\n      name: 'Feature Owners',\n      status: features.size > 0 ? 'pass' : 'skip',\n      message:\n        features.size > 0\n          ? 'All features have owners defined'\n          : 'No features to check',\n    };\n  }\n\n  return {\n    category: 'layers',\n    name: 'Feature Owners',\n    status: 'warn',\n    message: `${missingOwners.length} feature(s) missing owners`,\n    details: `Features: ${missingOwners.slice(0, 3).join(', ')}${missingOwners.length > 3 ? '...' : ''}`,\n  };\n}\n\n/**\n * Check if examples have valid entrypoints.\n */\nfunction checkExampleEntrypoints(\n  examples: Map<\n    string,\n    { entrypoints: { packageName: string }; filePath: string }\n  >\n): CheckResult {\n  const missingPackage: string[] = [];\n\n  for (const [key, example] of examples) {\n    if (!example.entrypoints.packageName) {\n      missingPackage.push(key);\n    }\n  }\n\n  if (missingPackage.length === 0) {\n    return {\n      category: 'layers',\n      name: 'Example Entrypoints',\n      status: examples.size > 0 ? 'pass' : 'skip',\n      message:\n        examples.size > 0\n          ? 'All examples have valid entrypoints'\n          : 'No examples to check',\n    };\n  }\n\n  return {\n    category: 'layers',\n    name: 'Example Entrypoints',\n    status: 'fail',\n    message: `${missingPackage.length} example(s) missing packageName`,\n    details: `Examples: ${missingPackage.join(', ')}`,\n  };\n}\n\n/**\n * Check if workspace configs are valid.\n */\nfunction checkWorkspaceConfigs(\n  configs: Map<string, { valid: boolean; errors: string[]; file: string }>\n): CheckResult {\n  const invalid: string[] = [];\n\n  for (const [, config] of configs) {\n    if (!config.valid) {\n      invalid.push(config.file);\n    }\n  }\n\n  if (configs.size === 0) {\n    return {\n      category: 'layers',\n      name: 'Workspace Configs',\n      status: 'skip',\n      message: 'No .contractsrc.json files found',\n    };\n  }\n\n  if (invalid.length === 0) {\n    return {\n      category: 'layers',\n      name: 'Workspace Configs',\n      status: 'pass',\n      message: `All ${configs.size} workspace config(s) are valid`,\n    };\n  }\n\n  return {\n    category: 'layers',\n    name: 'Workspace Configs',\n    status: 'fail',\n    message: `${invalid.length} workspace config(s) invalid`,\n    details: `Files: ${invalid.join(', ')}`,\n  };\n}\n"],"mappings":";;;;;;AAaA,eAAsB,eACpB,IACA,MACwB;CACxB,MAAM,UAAyB,EAAE;CAGjC,MAAM,YAAY,MAAM,eACtB;EACE;EACA,QAAQ;GAEN,YAAY;GAEZ,YAAY;GAEZ,aAAa;GAEb,aAAa;GACb,uBAAuB;IAErB,aAAa;IAEb,cAAc;IAEd,eAAe;IAEf,YAAY;IAEZ,YAAY;IAEZ,YAAY;IAEZ,cAAc;IACf;GACF;EACF,EACD,EAAE,CACH;AAGD,SAAQ,KAAK,iBAAiB,UAAU,MAAM,SAAS,CAAC;AAGxD,SAAQ,KAAK,iBAAiB,UAAU,MAAM,SAAS,CAAC;AAGxD,SAAQ,KAAK,mBAAmB,UAAU,UAAU,SAAS,CAAC;AAG9D,SAAQ,KAAK,wBAAwB,UAAU,UAAU,SAAS,CAAC;AAGnE,SAAQ,KAAK,sBAAsB,UAAU,UAAU,iBAAiB,CAAC;AAEzE,QAAO;;;;;AAMT,SAAS,iBAAiB,OAA4B;AACpD,KAAI,QAAQ,EACV,QAAO;EACL,UAAU;EACV,MAAM;EACN,QAAQ;EACR,SAAS,SAAS,MAAM;EACzB;AAGH,QAAO;EACL,UAAU;EACV,MAAM;EACN,QAAQ;EACR,SAAS;EACT,SAAS;EACV;;;;;AAMH,SAAS,iBAAiB,OAA4B;AACpD,KAAI,QAAQ,EACV,QAAO;EACL,UAAU;EACV,MAAM;EACN,QAAQ;EACR,SAAS,SAAS,MAAM;EACzB;AAGH,QAAO;EACL,UAAU;EACV,MAAM;EACN,QAAQ;EACR,SAAS;EACT,SAAS;EACV;;;;;AAMH,SAAS,mBACP,UACa;CACb,MAAM,gBAA0B,EAAE;AAElC,MAAK,MAAM,CAAC,KAAK,YAAY,SAC3B,KAAI,CAAC,QAAQ,QAAQ,OACnB,eAAc,KAAK,IAAI;AAI3B,KAAI,cAAc,WAAW,EAC3B,QAAO;EACL,UAAU;EACV,MAAM;EACN,QAAQ,SAAS,OAAO,IAAI,SAAS;EACrC,SACE,SAAS,OAAO,IACZ,qCACA;EACP;AAGH,QAAO;EACL,UAAU;EACV,MAAM;EACN,QAAQ;EACR,SAAS,GAAG,cAAc,OAAO;EACjC,SAAS,aAAa,cAAc,MAAM,GAAG,EAAE,CAAC,KAAK,KAAK,GAAG,cAAc,SAAS,IAAI,QAAQ;EACjG;;;;;AAMH,SAAS,wBACP,UAIa;CACb,MAAM,iBAA2B,EAAE;AAEnC,MAAK,MAAM,CAAC,KAAK,YAAY,SAC3B,KAAI,CAAC,QAAQ,YAAY,YACvB,gBAAe,KAAK,IAAI;AAI5B,KAAI,eAAe,WAAW,EAC5B,QAAO;EACL,UAAU;EACV,MAAM;EACN,QAAQ,SAAS,OAAO,IAAI,SAAS;EACrC,SACE,SAAS,OAAO,IACZ,wCACA;EACP;AAGH,QAAO;EACL,UAAU;EACV,MAAM;EACN,QAAQ;EACR,SAAS,GAAG,eAAe,OAAO;EAClC,SAAS,aAAa,eAAe,KAAK,KAAK;EAChD;;;;;AAMH,SAAS,sBACP,SACa;CACb,MAAM,UAAoB,EAAE;AAE5B,MAAK,MAAM,GAAG,WAAW,QACvB,KAAI,CAAC,OAAO,MACV,SAAQ,KAAK,OAAO,KAAK;AAI7B,KAAI,QAAQ,SAAS,EACnB,QAAO;EACL,UAAU;EACV,MAAM;EACN,QAAQ;EACR,SAAS;EACV;AAGH,KAAI,QAAQ,WAAW,EACrB,QAAO;EACL,UAAU;EACV,MAAM;EACN,QAAQ;EACR,SAAS,OAAO,QAAQ,KAAK;EAC9B;AAGH,QAAO;EACL,UAAU;EACV,MAAM;EACN,QAAQ;EACR,SAAS,GAAG,QAAQ,OAAO;EAC3B,SAAS,UAAU,QAAQ,KAAK,KAAK;EACtC"}

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

@@ -0,0 +1,145 @@
+import { generateCursorMcpConfig, getClaudeDesktopConfigPath } from "../../setup/config-generators.mjs";
+import { deepMergePreserve, formatJson } from "../../setup/file-merger.mjs";
+
+//#region src/services/doctor/checks/mcp.ts
+/**
+* Run MCP-related health checks.
+*/
+async function runMcpChecks(fs, ctx) {
+	const results = [];
+	results.push(await checkCursorMcpConfig(fs, ctx));
+	results.push(await checkCursorMcpServer(fs, ctx));
+	results.push(await checkClaudeMcpConfig(fs, ctx));
+	return results;
+}
+/**
+* Check if .cursor/mcp.json exists.
+*/
+async function checkCursorMcpConfig(fs, ctx) {
+	const configPath = fs.join(ctx.workspaceRoot, ".cursor", "mcp.json");
+	if (await fs.exists(configPath)) return {
+		category: "mcp",
+		name: "Cursor MCP Config",
+		status: "pass",
+		message: ".cursor/mcp.json found"
+	};
+	return {
+		category: "mcp",
+		name: "Cursor MCP Config",
+		status: "warn",
+		message: ".cursor/mcp.json not found",
+		details: "MCP integration with Cursor will not work",
+		fix: {
+			description: "Create .cursor/mcp.json",
+			apply: async () => {
+				try {
+					const cursorDir = fs.join(ctx.workspaceRoot, ".cursor");
+					if (!await fs.exists(cursorDir)) await fs.mkdir(cursorDir);
+					const defaults = generateCursorMcpConfig();
+					await fs.writeFile(configPath, formatJson(defaults));
+					return {
+						success: true,
+						message: "Created .cursor/mcp.json"
+					};
+				} catch (error) {
+					return {
+						success: false,
+						message: `Failed: ${error instanceof Error ? error.message : String(error)}`
+					};
+				}
+			}
+		}
+	};
+}
+/**
+* Check if ContractSpec MCP server is registered in Cursor config.
+*/
+async function checkCursorMcpServer(fs, ctx) {
+	const configPath = fs.join(ctx.workspaceRoot, ".cursor", "mcp.json");
+	if (!await fs.exists(configPath)) return {
+		category: "mcp",
+		name: "MCP Server Registered",
+		status: "skip",
+		message: "Cursor MCP config does not exist"
+	};
+	try {
+		const content = await fs.readFile(configPath);
+		const config = JSON.parse(content);
+		if (config.mcpServers?.["contractspec-local"] !== void 0) return {
+			category: "mcp",
+			name: "MCP Server Registered",
+			status: "pass",
+			message: "ContractSpec MCP server is registered"
+		};
+		return {
+			category: "mcp",
+			name: "MCP Server Registered",
+			status: "fail",
+			message: "ContractSpec MCP server not registered",
+			fix: {
+				description: "Register ContractSpec MCP server",
+				apply: async () => {
+					try {
+						const merged = deepMergePreserve(config, generateCursorMcpConfig());
+						await fs.writeFile(configPath, formatJson(merged));
+						return {
+							success: true,
+							message: "Registered MCP server"
+						};
+					} catch (error) {
+						return {
+							success: false,
+							message: `Failed: ${error instanceof Error ? error.message : String(error)}`
+						};
+					}
+				}
+			}
+		};
+	} catch {
+		return {
+			category: "mcp",
+			name: "MCP Server Registered",
+			status: "skip",
+			message: "Could not parse Cursor MCP config"
+		};
+	}
+}
+/**
+* Check Claude Desktop MCP config (optional).
+*/
+async function checkClaudeMcpConfig(fs, _ctx) {
+	const configPath = getClaudeDesktopConfigPath();
+	try {
+		if (!await fs.exists(configPath)) return {
+			category: "mcp",
+			name: "Claude Desktop MCP",
+			status: "skip",
+			message: "Claude Desktop config not found (optional)"
+		};
+		const content = await fs.readFile(configPath);
+		if (JSON.parse(content).mcpServers?.["contractspec-local"] !== void 0) return {
+			category: "mcp",
+			name: "Claude Desktop MCP",
+			status: "pass",
+			message: "ContractSpec registered in Claude Desktop"
+		};
+		return {
+			category: "mcp",
+			name: "Claude Desktop MCP",
+			status: "warn",
+			message: "ContractSpec not registered in Claude Desktop",
+			details: "Optional: Run setup to configure Claude Desktop"
+		};
+	} catch {
+		return {
+			category: "mcp",
+			name: "Claude Desktop MCP",
+			status: "skip",
+			message: "Could not check Claude Desktop config"
+		};
+	}
+}
+
+//#endregion
+export { runMcpChecks };
+//# sourceMappingURL=mcp.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.mjs","names":[],"sources":["../../../../src/services/doctor/checks/mcp.ts"],"sourcesContent":["/**\n * MCP server health checks.\n */\n\nimport type { FsAdapter } from '../../../ports/fs';\nimport type { CheckResult, CheckContext, FixResult } from '../types';\nimport {\n  generateCursorMcpConfig,\n  getClaudeDesktopConfigPath,\n} from '../../setup/config-generators';\nimport { deepMergePreserve, formatJson } from '../../setup/file-merger';\n\n/**\n * Run MCP-related health checks.\n */\nexport async function runMcpChecks(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  // Check Cursor MCP config\n  results.push(await checkCursorMcpConfig(fs, ctx));\n\n  // Check Cursor MCP server registration\n  results.push(await checkCursorMcpServer(fs, ctx));\n\n  // Check Claude Desktop config (optional)\n  results.push(await checkClaudeMcpConfig(fs, ctx));\n\n  return results;\n}\n\n/**\n * Check if .cursor/mcp.json exists.\n */\nasync function checkCursorMcpConfig(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const configPath = fs.join(ctx.workspaceRoot, '.cursor', 'mcp.json');\n\n  const exists = await fs.exists(configPath);\n  if (exists) {\n    return {\n      category: 'mcp',\n      name: 'Cursor MCP Config',\n      status: 'pass',\n      message: '.cursor/mcp.json found',\n    };\n  }\n\n  return {\n    category: 'mcp',\n    name: 'Cursor MCP Config',\n    status: 'warn',\n    message: '.cursor/mcp.json not found',\n    details: 'MCP integration with Cursor will not work',\n    fix: {\n      description: 'Create .cursor/mcp.json',\n      apply: async (): Promise<FixResult> => {\n        try {\n          const cursorDir = fs.join(ctx.workspaceRoot, '.cursor');\n          if (!(await fs.exists(cursorDir))) {\n            await fs.mkdir(cursorDir);\n          }\n\n          const defaults = generateCursorMcpConfig();\n          await fs.writeFile(configPath, formatJson(defaults));\n          return { success: true, message: 'Created .cursor/mcp.json' };\n        } catch (error) {\n          const msg = error instanceof Error ? error.message : String(error);\n          return { success: false, message: `Failed: ${msg}` };\n        }\n      },\n    },\n  };\n}\n\n/**\n * Check if ContractSpec MCP server is registered in Cursor config.\n */\nasync function checkCursorMcpServer(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const configPath = fs.join(ctx.workspaceRoot, '.cursor', 'mcp.json');\n\n  const exists = await fs.exists(configPath);\n  if (!exists) {\n    return {\n      category: 'mcp',\n      name: 'MCP Server Registered',\n      status: 'skip',\n      message: 'Cursor MCP config does not exist',\n    };\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    const config = JSON.parse(content) as {\n      mcpServers?: Record<string, unknown>;\n    };\n\n    const hasServer = config.mcpServers?.['contractspec-local'] !== undefined;\n\n    if (hasServer) {\n      return {\n        category: 'mcp',\n        name: 'MCP Server Registered',\n        status: 'pass',\n        message: 'ContractSpec MCP server is registered',\n      };\n    }\n\n    return {\n      category: 'mcp',\n      name: 'MCP Server Registered',\n      status: 'fail',\n      message: 'ContractSpec MCP server not registered',\n      fix: {\n        description: 'Register ContractSpec MCP server',\n        apply: async (): Promise<FixResult> => {\n          try {\n            const defaults = generateCursorMcpConfig() as Record<\n              string,\n              unknown\n            >;\n            const merged = deepMergePreserve(\n              config as Record<string, unknown>,\n              defaults\n            );\n            await fs.writeFile(configPath, formatJson(merged));\n            return { success: true, message: 'Registered MCP server' };\n          } catch (error) {\n            const msg = error instanceof Error ? error.message : String(error);\n            return { success: false, message: `Failed: ${msg}` };\n          }\n        },\n      },\n    };\n  } catch {\n    return {\n      category: 'mcp',\n      name: 'MCP Server Registered',\n      status: 'skip',\n      message: 'Could not parse Cursor MCP config',\n    };\n  }\n}\n\n/**\n * Check Claude Desktop MCP config (optional).\n */\nasync function checkClaudeMcpConfig(\n  fs: FsAdapter,\n  _ctx: CheckContext\n): Promise<CheckResult> {\n  const configPath = getClaudeDesktopConfigPath();\n\n  try {\n    const exists = await fs.exists(configPath);\n    if (!exists) {\n      return {\n        category: 'mcp',\n        name: 'Claude Desktop MCP',\n        status: 'skip',\n        message: 'Claude Desktop config not found (optional)',\n      };\n    }\n\n    const content = await fs.readFile(configPath);\n    const config = JSON.parse(content) as {\n      mcpServers?: Record<string, unknown>;\n    };\n\n    const hasServer = config.mcpServers?.['contractspec-local'] !== undefined;\n\n    if (hasServer) {\n      return {\n        category: 'mcp',\n        name: 'Claude Desktop MCP',\n        status: 'pass',\n        message: 'ContractSpec registered in Claude Desktop',\n      };\n    }\n\n    return {\n      category: 'mcp',\n      name: 'Claude Desktop MCP',\n      status: 'warn',\n      message: 'ContractSpec not registered in Claude Desktop',\n      details: 'Optional: Run setup to configure Claude Desktop',\n    };\n  } catch {\n    return {\n      category: 'mcp',\n      name: 'Claude Desktop MCP',\n      status: 'skip',\n      message: 'Could not check Claude Desktop config',\n    };\n  }\n}\n"],"mappings":";;;;;;;AAeA,eAAsB,aACpB,IACA,KACwB;CACxB,MAAM,UAAyB,EAAE;AAGjC,SAAQ,KAAK,MAAM,qBAAqB,IAAI,IAAI,CAAC;AAGjD,SAAQ,KAAK,MAAM,qBAAqB,IAAI,IAAI,CAAC;AAGjD,SAAQ,KAAK,MAAM,qBAAqB,IAAI,IAAI,CAAC;AAEjD,QAAO;;;;;AAMT,eAAe,qBACb,IACA,KACsB;CACtB,MAAM,aAAa,GAAG,KAAK,IAAI,eAAe,WAAW,WAAW;AAGpE,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,SAAS;EACT,KAAK;GACH,aAAa;GACb,OAAO,YAAgC;AACrC,QAAI;KACF,MAAM,YAAY,GAAG,KAAK,IAAI,eAAe,UAAU;AACvD,SAAI,CAAE,MAAM,GAAG,OAAO,UAAU,CAC9B,OAAM,GAAG,MAAM,UAAU;KAG3B,MAAM,WAAW,yBAAyB;AAC1C,WAAM,GAAG,UAAU,YAAY,WAAW,SAAS,CAAC;AACpD,YAAO;MAAE,SAAS;MAAM,SAAS;MAA4B;aACtD,OAAO;AAEd,YAAO;MAAE,SAAS;MAAO,SAAS,WADtB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;MACd;;;GAGzD;EACF;;;;;AAMH,eAAe,qBACb,IACA,KACsB;CACtB,MAAM,aAAa,GAAG,KAAK,IAAI,eAAe,WAAW,WAAW;AAGpE,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;AAMlC,MAFkB,OAAO,aAAa,0BAA0B,OAG9D,QAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;AAGH,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACT,KAAK;IACH,aAAa;IACb,OAAO,YAAgC;AACrC,SAAI;MAKF,MAAM,SAAS,kBACb,QALe,yBAAyB,CAOzC;AACD,YAAM,GAAG,UAAU,YAAY,WAAW,OAAO,CAAC;AAClD,aAAO;OAAE,SAAS;OAAM,SAAS;OAAyB;cACnD,OAAO;AAEd,aAAO;OAAE,SAAS;OAAO,SAAS,WADtB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;OACd;;;IAGzD;GACF;SACK;AACN,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;;;;;;AAOL,eAAe,qBACb,IACA,MACsB;CACtB,MAAM,aAAa,4BAA4B;AAE/C,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;AAO7C,MANe,KAAK,MAAM,QAAQ,CAIT,aAAa,0BAA0B,OAG9D,QAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV;AAGH,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACT,SAAS;GACV;SACK;AACN,SAAO;GACL,UAAU;GACV,MAAM;GACN,QAAQ;GACR,SAAS;GACV"}

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

@@ -0,0 +1,263 @@
+//#region src/services/doctor/checks/workspace.ts
+/**
+* Common contract directory paths to check.
+*/
+const CONTRACT_PATHS = [
+	"src/contracts",
+	"contracts",
+	"src/specs",
+	"specs"
+];
+/**
+* Run workspace-related health checks.
+*/
+async function runWorkspaceChecks(fs, ctx) {
+	const results = [];
+	results.push(checkMonorepoStatus(ctx));
+	results.push(await checkValidWorkspace(fs, ctx));
+	results.push(await checkContractsDirectory(fs, ctx));
+	results.push(await checkContractFiles(fs, ctx));
+	results.push(await checkOutputDirectory(fs, ctx));
+	return results;
+}
+/**
+* Report monorepo detection status.
+*/
+function checkMonorepoStatus(ctx) {
+	if (ctx.isMonorepo) {
+		const pkgInfo = ctx.packageName ? ` in package "${ctx.packageName}"` : "";
+		const locationInfo = ctx.packageRoot !== ctx.workspaceRoot ? ` (package root: ${ctx.packageRoot})` : "";
+		return {
+			category: "workspace",
+			name: "Monorepo Detection",
+			status: "pass",
+			message: `Monorepo detected${pkgInfo}`,
+			details: ctx.verbose ? `Workspace root: ${ctx.workspaceRoot}${locationInfo}` : void 0
+		};
+	}
+	return {
+		category: "workspace",
+		name: "Monorepo Detection",
+		status: "pass",
+		message: "Single project (not a monorepo)"
+	};
+}
+/**
+* Check if this is a valid workspace.
+*/
+async function checkValidWorkspace(fs, ctx) {
+	const pathsToCheck = ctx.isMonorepo ? [ctx.packageRoot, ctx.workspaceRoot] : [ctx.workspaceRoot];
+	for (const root of pathsToCheck) {
+		const packageJsonPath = fs.join(root, "package.json");
+		if (await fs.exists(packageJsonPath)) return {
+			category: "workspace",
+			name: "Valid Workspace",
+			status: "pass",
+			message: "package.json found",
+			details: ctx.verbose && ctx.isMonorepo ? `Found at: ${root}` : void 0
+		};
+	}
+	return {
+		category: "workspace",
+		name: "Valid Workspace",
+		status: "fail",
+		message: "No package.json found",
+		details: "This does not appear to be a Node.js/TypeScript project"
+	};
+}
+/**
+* Check if contracts directory exists.
+*
+* In monorepo: checks current package first, then workspace root.
+*/
+async function checkContractsDirectory(fs, ctx) {
+	const searchRoots = ctx.isMonorepo ? [ctx.packageRoot, ctx.workspaceRoot] : [ctx.workspaceRoot];
+	const targetRoot = ctx.isMonorepo ? ctx.packageRoot : ctx.workspaceRoot;
+	for (const root of searchRoots) for (const path of CONTRACT_PATHS) {
+		const fullPath = fs.join(root, path);
+		if (await fs.exists(fullPath)) {
+			const relativeTo = root === ctx.packageRoot ? "package" : "workspace";
+			return {
+				category: "workspace",
+				name: "Contracts Directory",
+				status: "pass",
+				message: `Contracts directory found: ${path}`,
+				details: ctx.isMonorepo ? `Found at ${relativeTo} level` : void 0
+			};
+		}
+	}
+	if (ctx.isMonorepo && ctx.packageRoot === ctx.workspaceRoot) return {
+		category: "workspace",
+		name: "Contracts Directory",
+		status: "pass",
+		message: "Monorepo root detected (contracts expected in packages)"
+	};
+	const createPath = ctx.isMonorepo ? "src/contracts" : "src/contracts";
+	const locationHint = ctx.isMonorepo ? ` in package "${ctx.packageName ?? ctx.packageRoot}"` : "";
+	return {
+		category: "workspace",
+		name: "Contracts Directory",
+		status: "warn",
+		message: "No contracts directory found",
+		details: `Create ${createPath}/${locationHint} to organize your specs`,
+		fix: {
+			description: `Create ${createPath}/ directory${locationHint}`,
+			apply: async () => {
+				try {
+					const contractsDir = fs.join(targetRoot, "src", "contracts");
+					await fs.mkdir(contractsDir);
+					return {
+						success: true,
+						message: `Created ${createPath}/`
+					};
+				} catch (error) {
+					return {
+						success: false,
+						message: `Failed: ${error instanceof Error ? error.message : String(error)}`
+					};
+				}
+			}
+		}
+	};
+}
+/**
+* Check if any contract files exist.
+*
+* In monorepo: searches from current package root.
+*/
+async function checkContractFiles(fs, ctx) {
+	try {
+		const patterns = [
+			"**/*.operation.ts",
+			"**/*.event.ts",
+			"**/*.presentation.ts",
+			"**/*.feature.ts"
+		];
+		const searchRoot = ctx.isMonorepo ? ctx.packageRoot : ctx.workspaceRoot;
+		const files = await fs.glob({
+			patterns,
+			ignore: ["node_modules/**", "dist/**"],
+			cwd: searchRoot
+		});
+		if (files.length > 0) {
+			const locationInfo = ctx.isMonorepo ? " (in current package)" : "";
+			return {
+				category: "workspace",
+				name: "Contract Files",
+				status: "pass",
+				message: `Found ${files.length} contract file(s)${locationInfo}`,
+				details: ctx.verbose ? files.slice(0, 5).join(", ") : void 0
+			};
+		}
+		if (ctx.isMonorepo && ctx.packageRoot === ctx.workspaceRoot) return {
+			category: "workspace",
+			name: "Contract Files",
+			status: "pass",
+			message: "No contract files in root (expected in packages)"
+		};
+		return {
+			category: "workspace",
+			name: "Contract Files",
+			status: "warn",
+			message: ctx.isMonorepo ? `No contract files found in package "${ctx.packageName ?? "current"}"` : "No contract files found",
+			details: "Create specs using \"contractspec create\" or VS Code command"
+		};
+	} catch {
+		return {
+			category: "workspace",
+			name: "Contract Files",
+			status: "skip",
+			message: "Could not search for contract files"
+		};
+	}
+}
+/**
+* Find the config file, checking package level first in monorepos.
+*/
+async function findConfigFile(fs, ctx) {
+	if (ctx.isMonorepo && ctx.packageRoot !== ctx.workspaceRoot) {
+		const pkgConfigPath = fs.join(ctx.packageRoot, ".contractsrc.json");
+		if (await fs.exists(pkgConfigPath)) return {
+			path: pkgConfigPath,
+			root: ctx.packageRoot,
+			level: "package"
+		};
+	}
+	const wsConfigPath = fs.join(ctx.workspaceRoot, ".contractsrc.json");
+	if (await fs.exists(wsConfigPath)) return {
+		path: wsConfigPath,
+		root: ctx.workspaceRoot,
+		level: "workspace"
+	};
+	return null;
+}
+/**
+* Check if output directory is configured and exists.
+*
+* In monorepo: checks package-level config first, then workspace-level.
+* Resolves outputDir relative to the config file location.
+*/
+async function checkOutputDirectory(fs, ctx) {
+	try {
+		const configInfo = await findConfigFile(fs, ctx);
+		if (!configInfo) return {
+			category: "workspace",
+			name: "Output Directory",
+			status: "skip",
+			message: ctx.isMonorepo ? "No config file found at package or workspace level" : "No config file to check output directory"
+		};
+		const content = await fs.readFile(configInfo.path);
+		const config = JSON.parse(content);
+		const outputDir = config.outputDir ?? "./src";
+		const outputPath = fs.join(configInfo.root, outputDir);
+		const levelInfo = ctx.isMonorepo ? ` (${configInfo.level} level)` : "";
+		if (await fs.exists(outputPath)) return {
+			category: "workspace",
+			name: "Output Directory",
+			status: "pass",
+			message: `Output directory exists: ${outputDir}${levelInfo}`,
+			details: ctx.verbose ? `Resolved to: ${outputPath}` : void 0
+		};
+		if (ctx.isMonorepo && ctx.packageRoot === ctx.workspaceRoot && !config.outputDir) return {
+			category: "workspace",
+			name: "Output Directory",
+			status: "pass",
+			message: "Monorepo root detected (using package directories)"
+		};
+		return {
+			category: "workspace",
+			name: "Output Directory",
+			status: "warn",
+			message: `Output directory not found: ${outputDir}${levelInfo}`,
+			details: ctx.verbose ? `Expected at: ${outputPath}` : void 0,
+			fix: {
+				description: `Create ${outputDir} directory`,
+				apply: async () => {
+					try {
+						await fs.mkdir(outputPath);
+						return {
+							success: true,
+							message: `Created ${outputDir}`
+						};
+					} catch (error) {
+						return {
+							success: false,
+							message: `Failed: ${error instanceof Error ? error.message : String(error)}`
+						};
+					}
+				}
+			}
+		};
+	} catch {
+		return {
+			category: "workspace",
+			name: "Output Directory",
+			status: "skip",
+			message: "Could not check output directory"
+		};
+	}
+}
+
+//#endregion
+export { runWorkspaceChecks };
+//# sourceMappingURL=workspace.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.mjs","names":[],"sources":["../../../../src/services/doctor/checks/workspace.ts"],"sourcesContent":["/**\n * Workspace structure health checks.\n *\n * Monorepo-aware checks for contracts and output directories.\n */\n\nimport type { FsAdapter } from '../../../ports/fs';\nimport type { CheckContext, CheckResult, FixResult } from '../types';\n\n/**\n * Common contract directory paths to check.\n */\nconst CONTRACT_PATHS = ['src/contracts', 'contracts', 'src/specs', 'specs'];\n\n/**\n * Run workspace-related health checks.\n */\nexport async function runWorkspaceChecks(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  // Check monorepo status first (informational)\n  results.push(checkMonorepoStatus(ctx));\n\n  // Check if this is a valid workspace (has package.json)\n  results.push(await checkValidWorkspace(fs, ctx));\n\n  // Check if contracts directory exists (monorepo-aware)\n  results.push(await checkContractsDirectory(fs, ctx));\n\n  // Check if any contract files exist\n  results.push(await checkContractFiles(fs, ctx));\n\n  // Check output directory (monorepo-aware)\n  results.push(await checkOutputDirectory(fs, ctx));\n\n  return results;\n}\n\n/**\n * Report monorepo detection status.\n */\nfunction checkMonorepoStatus(ctx: CheckContext): CheckResult {\n  if (ctx.isMonorepo) {\n    const pkgInfo = ctx.packageName ? ` in package \"${ctx.packageName}\"` : '';\n    const locationInfo =\n      ctx.packageRoot !== ctx.workspaceRoot\n        ? ` (package root: ${ctx.packageRoot})`\n        : '';\n    return {\n      category: 'workspace',\n      name: 'Monorepo Detection',\n      status: 'pass',\n      message: `Monorepo detected${pkgInfo}`,\n      details: ctx.verbose\n        ? `Workspace root: ${ctx.workspaceRoot}${locationInfo}`\n        : undefined,\n    };\n  }\n\n  return {\n    category: 'workspace',\n    name: 'Monorepo Detection',\n    status: 'pass',\n    message: 'Single project (not a monorepo)',\n  };\n}\n\n/**\n * Check if this is a valid workspace.\n */\nasync function checkValidWorkspace(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  // In monorepo, check both workspace root and package root\n  const pathsToCheck = ctx.isMonorepo\n    ? [ctx.packageRoot, ctx.workspaceRoot]\n    : [ctx.workspaceRoot];\n\n  for (const root of pathsToCheck) {\n    const packageJsonPath = fs.join(root, 'package.json');\n    if (await fs.exists(packageJsonPath)) {\n      return {\n        category: 'workspace',\n        name: 'Valid Workspace',\n        status: 'pass',\n        message: 'package.json found',\n        details:\n          ctx.verbose && ctx.isMonorepo ? `Found at: ${root}` : undefined,\n      };\n    }\n  }\n\n  return {\n    category: 'workspace',\n    name: 'Valid Workspace',\n    status: 'fail',\n    message: 'No package.json found',\n    details: 'This does not appear to be a Node.js/TypeScript project',\n  };\n}\n\n/**\n * Check if contracts directory exists.\n *\n * In monorepo: checks current package first, then workspace root.\n */\nasync function checkContractsDirectory(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  // Determine where to look and where to create\n  const searchRoots = ctx.isMonorepo\n    ? [ctx.packageRoot, ctx.workspaceRoot]\n    : [ctx.workspaceRoot];\n\n  // Prefer creating in package root for monorepos\n  const targetRoot = ctx.isMonorepo ? ctx.packageRoot : ctx.workspaceRoot;\n\n  // Check each possible location\n  for (const root of searchRoots) {\n    for (const path of CONTRACT_PATHS) {\n      const fullPath = fs.join(root, path);\n      if (await fs.exists(fullPath)) {\n        const relativeTo = root === ctx.packageRoot ? 'package' : 'workspace';\n        return {\n          category: 'workspace',\n          name: 'Contracts Directory',\n          status: 'pass',\n          message: `Contracts directory found: ${path}`,\n          details: ctx.isMonorepo ? `Found at ${relativeTo} level` : undefined,\n        };\n      }\n    }\n  }\n\n  // Not found - check if we are at monorepo root\n  if (ctx.isMonorepo && ctx.packageRoot === ctx.workspaceRoot) {\n    return {\n      category: 'workspace',\n      name: 'Contracts Directory',\n      status: 'pass',\n      message: 'Monorepo root detected (contracts expected in packages)',\n    };\n  }\n\n  // Not found - suggest creating in appropriate location\n  const createPath = ctx.isMonorepo ? 'src/contracts' : 'src/contracts';\n  const locationHint = ctx.isMonorepo\n    ? ` in package \"${ctx.packageName ?? ctx.packageRoot}\"`\n    : '';\n\n  return {\n    category: 'workspace',\n    name: 'Contracts Directory',\n    status: 'warn',\n    message: 'No contracts directory found',\n    details: `Create ${createPath}/${locationHint} to organize your specs`,\n    fix: {\n      description: `Create ${createPath}/ directory${locationHint}`,\n      apply: async (): Promise<FixResult> => {\n        try {\n          const contractsDir = fs.join(targetRoot, 'src', 'contracts');\n          await fs.mkdir(contractsDir);\n          return { success: true, message: `Created ${createPath}/` };\n        } catch (error) {\n          const msg = error instanceof Error ? error.message : String(error);\n          return { success: false, message: `Failed: ${msg}` };\n        }\n      },\n    },\n  };\n}\n\n/**\n * Check if any contract files exist.\n *\n * In monorepo: searches from current package root.\n */\nasync function checkContractFiles(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  try {\n    const patterns = [\n      '**/*.operation.ts',\n      '**/*.event.ts',\n      '**/*.presentation.ts',\n      '**/*.feature.ts',\n    ];\n\n    // In monorepo, search from package root; otherwise workspace root\n    const searchRoot = ctx.isMonorepo ? ctx.packageRoot : ctx.workspaceRoot;\n\n    const files = await fs.glob({\n      patterns,\n      ignore: ['node_modules/**', 'dist/**'],\n      cwd: searchRoot,\n    });\n\n    if (files.length > 0) {\n      const locationInfo = ctx.isMonorepo ? ' (in current package)' : '';\n      return {\n        category: 'workspace',\n        name: 'Contract Files',\n        status: 'pass',\n        message: `Found ${files.length} contract file(s)${locationInfo}`,\n        details: ctx.verbose ? files.slice(0, 5).join(', ') : undefined,\n      };\n    }\n\n    // Pass if monorepo root and no files (likely empty root)\n    if (ctx.isMonorepo && ctx.packageRoot === ctx.workspaceRoot) {\n      return {\n        category: 'workspace',\n        name: 'Contract Files',\n        status: 'pass',\n        message: 'No contract files in root (expected in packages)',\n      };\n    }\n\n    const hint = ctx.isMonorepo\n      ? `No contract files found in package \"${ctx.packageName ?? 'current'}\"`\n      : 'No contract files found';\n\n    return {\n      category: 'workspace',\n      name: 'Contract Files',\n      status: 'warn',\n      message: hint,\n      details: 'Create specs using \"contractspec create\" or VS Code command',\n    };\n  } catch {\n    return {\n      category: 'workspace',\n      name: 'Contract Files',\n      status: 'skip',\n      message: 'Could not search for contract files',\n    };\n  }\n}\n\n/**\n * Find the config file, checking package level first in monorepos.\n */\nasync function findConfigFile(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<{\n  path: string;\n  root: string;\n  level: 'package' | 'workspace';\n} | null> {\n  // In monorepo, check package level first\n  if (ctx.isMonorepo && ctx.packageRoot !== ctx.workspaceRoot) {\n    const pkgConfigPath = fs.join(ctx.packageRoot, '.contractsrc.json');\n    if (await fs.exists(pkgConfigPath)) {\n      return { path: pkgConfigPath, root: ctx.packageRoot, level: 'package' };\n    }\n  }\n\n  // Check workspace level\n  const wsConfigPath = fs.join(ctx.workspaceRoot, '.contractsrc.json');\n  if (await fs.exists(wsConfigPath)) {\n    return { path: wsConfigPath, root: ctx.workspaceRoot, level: 'workspace' };\n  }\n\n  return null;\n}\n\n/**\n * Check if output directory is configured and exists.\n *\n * In monorepo: checks package-level config first, then workspace-level.\n * Resolves outputDir relative to the config file location.\n */\nasync function checkOutputDirectory(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  try {\n    const configInfo = await findConfigFile(fs, ctx);\n\n    if (!configInfo) {\n      const hint = ctx.isMonorepo\n        ? 'No config file found at package or workspace level'\n        : 'No config file to check output directory';\n      return {\n        category: 'workspace',\n        name: 'Output Directory',\n        status: 'skip',\n        message: hint,\n      };\n    }\n\n    const content = await fs.readFile(configInfo.path);\n    const config = JSON.parse(content) as { outputDir?: string };\n\n    const outputDir = config.outputDir ?? './src';\n    // Resolve outputDir relative to the config file's directory\n    const outputPath = fs.join(configInfo.root, outputDir);\n\n    const levelInfo = ctx.isMonorepo ? ` (${configInfo.level} level)` : '';\n\n    const exists = await fs.exists(outputPath);\n    if (exists) {\n      return {\n        category: 'workspace',\n        name: 'Output Directory',\n        status: 'pass',\n        message: `Output directory exists: ${outputDir}${levelInfo}`,\n        details: ctx.verbose ? `Resolved to: ${outputPath}` : undefined,\n      };\n    }\n\n    // If default output directory is missing in monorepo root, it's fine\n    if (\n      ctx.isMonorepo &&\n      ctx.packageRoot === ctx.workspaceRoot &&\n      !config.outputDir\n    ) {\n      return {\n        category: 'workspace',\n        name: 'Output Directory',\n        status: 'pass',\n        message: 'Monorepo root detected (using package directories)',\n      };\n    }\n\n    return {\n      category: 'workspace',\n      name: 'Output Directory',\n      status: 'warn',\n      message: `Output directory not found: ${outputDir}${levelInfo}`,\n      details: ctx.verbose ? `Expected at: ${outputPath}` : undefined,\n      fix: {\n        description: `Create ${outputDir} directory`,\n        apply: async (): Promise<FixResult> => {\n          try {\n            await fs.mkdir(outputPath);\n            return { success: true, message: `Created ${outputDir}` };\n          } catch (error) {\n            const msg = error instanceof Error ? error.message : String(error);\n            return { success: false, message: `Failed: ${msg}` };\n          }\n        },\n      },\n    };\n  } catch {\n    return {\n      category: 'workspace',\n      name: 'Output Directory',\n      status: 'skip',\n      message: 'Could not check output directory',\n    };\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,24 @@
+import { FsAdapter } from "../../ports/fs.mjs";
+import { LoggerAdapter } from "../../ports/logger.mjs";
+import { CheckResult, DoctorOptions, DoctorPromptCallbacks, DoctorResult } from "./types.mjs";
+
+//#region src/services/doctor/doctor-service.d.ts
+
+/**
+ * Run all health checks and optionally apply fixes.
+ */
+declare function runDoctor(adapters: {
+  fs: FsAdapter;
+  logger: LoggerAdapter;
+}, options: DoctorOptions, prompts?: DoctorPromptCallbacks): Promise<DoctorResult>;
+/**
+ * Get a summary string for the doctor result.
+ */
+declare function formatDoctorSummary(result: DoctorResult): string;
+/**
+ * Format a single check result for display.
+ */
+declare function formatCheckResult(result: CheckResult): string;
+//#endregion
+export { formatCheckResult, formatDoctorSummary, runDoctor };
+//# sourceMappingURL=doctor-service.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-service.d.mts","names":[],"sources":["../../../src/services/doctor/doctor-service.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAgDG,iBAJmB,SAAA,CAInB,QAAA,EAAA;EAAO,EAAA,EAHQ,SAGR;EAoHM,MAAA,EAvHqB,aAuHrB;AAyBhB,CAAA,EAAA,OAAgB,EA/IL,aA+IsB,EAAA,OAAoB,CAApB,EA9ItB,qBA8I0C,CAAA,EA7IlD,OA6IkD,CA7I1C,YA6I0C,CAAA;;;;iBAzBrC,mBAAA,SAA4B;;;;iBAyB5B,iBAAA,SAA0B"}