@contractspec/bundle.workspace 1.44.0

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

@@ -0,0 +1,247 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+
+//#region src/services/doctor/checks/deps.ts
+/**
+* Dependencies health checks.
+*/
+const execAsync = promisify(exec);
+/**
+* Run dependency-related health checks.
+*/
+async function runDepsChecks(fs, ctx) {
+	const results = [];
+	results.push(await checkNodeJs(ctx));
+	results.push(await checkBun(ctx));
+	results.push(await checkPackageManager(fs, ctx));
+	results.push(await checkNodeModules(fs, ctx));
+	results.push(await checkContractsLibrary(fs, ctx));
+	return results;
+}
+/**
+* Check if Node.js is available.
+*/
+async function checkNodeJs(ctx) {
+	try {
+		const { stdout } = await execAsync("node --version", {
+			cwd: ctx.workspaceRoot,
+			timeout: 5e3
+		});
+		return {
+			category: "deps",
+			name: "Node.js",
+			status: "pass",
+			message: `Node.js ${stdout.trim()} available`
+		};
+	} catch {
+		return {
+			category: "deps",
+			name: "Node.js",
+			status: "fail",
+			message: "Node.js not found",
+			details: "Install Node.js from https://nodejs.org"
+		};
+	}
+}
+/**
+* Check if Bun is available.
+*/
+async function checkBun(ctx) {
+	try {
+		const { stdout } = await execAsync("bun --version", {
+			cwd: ctx.workspaceRoot,
+			timeout: 5e3
+		});
+		return {
+			category: "deps",
+			name: "Bun Runtime",
+			status: "pass",
+			message: `Bun ${stdout.trim()} available`
+		};
+	} catch {
+		return {
+			category: "deps",
+			name: "Bun Runtime",
+			status: "warn",
+			message: "Bun not found (optional but recommended)",
+			details: "Install Bun from https://bun.sh for faster execution"
+		};
+	}
+}
+/**
+* Detect and check the package manager.
+*/
+async function checkPackageManager(fs, ctx) {
+	const lockFiles = [
+		{
+			file: "bun.lockb",
+			name: "bun"
+		},
+		{
+			file: "pnpm-lock.yaml",
+			name: "pnpm"
+		},
+		{
+			file: "yarn.lock",
+			name: "yarn"
+		},
+		{
+			file: "package-lock.json",
+			name: "npm"
+		}
+	];
+	let detectedManager = null;
+	for (const { file, name } of lockFiles) {
+		const lockPath = fs.join(ctx.workspaceRoot, file);
+		if (await fs.exists(lockPath)) {
+			detectedManager = name;
+			break;
+		}
+	}
+	if (!detectedManager) return {
+		category: "deps",
+		name: "Package Manager",
+		status: "warn",
+		message: "No lock file found",
+		details: "Run npm install, yarn, pnpm install, or bun install"
+	};
+	try {
+		await execAsync(`${detectedManager} --version`, {
+			cwd: ctx.workspaceRoot,
+			timeout: 5e3
+		});
+		return {
+			category: "deps",
+			name: "Package Manager",
+			status: "pass",
+			message: `Using ${detectedManager}`
+		};
+	} catch {
+		return {
+			category: "deps",
+			name: "Package Manager",
+			status: "fail",
+			message: `${detectedManager} detected but not available`,
+			details: `Install ${detectedManager} or use a different package manager`
+		};
+	}
+}
+/**
+* Check if node_modules exists.
+*/
+async function checkNodeModules(fs, ctx) {
+	const nodeModulesPath = fs.join(ctx.workspaceRoot, "node_modules");
+	if (await fs.exists(nodeModulesPath)) return {
+		category: "deps",
+		name: "Dependencies Installed",
+		status: "pass",
+		message: "node_modules directory exists"
+	};
+	return {
+		category: "deps",
+		name: "Dependencies Installed",
+		status: "fail",
+		message: "node_modules not found",
+		details: "Run your package manager install command",
+		fix: {
+			description: "Install dependencies",
+			apply: async () => {
+				try {
+					try {
+						await execAsync("bun install", {
+							cwd: ctx.workspaceRoot,
+							timeout: 12e4
+						});
+						return {
+							success: true,
+							message: "Installed with bun"
+						};
+					} catch {
+						await execAsync("npm install", {
+							cwd: ctx.workspaceRoot,
+							timeout: 12e4
+						});
+						return {
+							success: true,
+							message: "Installed with npm"
+						};
+					}
+				} catch (error) {
+					return {
+						success: false,
+						message: `Failed: ${error instanceof Error ? error.message : String(error)}`
+					};
+				}
+			}
+		}
+	};
+}
+/**
+* Check if @contractspec/lib.contracts is installed.
+*/
+async function checkContractsLibrary(fs, ctx) {
+	const packageJsonPath = fs.join(ctx.workspaceRoot, "package.json");
+	try {
+		const content = await fs.readFile(packageJsonPath);
+		const packageJson = JSON.parse(content);
+		const allDeps = {
+			...packageJson.dependencies,
+			...packageJson.devDependencies
+		};
+		if ("@contractspec/lib.contracts" in allDeps) return {
+			category: "deps",
+			name: "ContractSpec Library",
+			status: "pass",
+			message: `@contractspec/lib.contracts installed (${allDeps["@contractspec/lib.contracts"]})`
+		};
+		return {
+			category: "deps",
+			name: "ContractSpec Library",
+			status: "fail",
+			message: "@contractspec/lib.contracts not installed",
+			details: "Run \"contractspec quickstart\" to install required packages",
+			fix: {
+				description: "Install @contractspec/lib.contracts and dependencies",
+				apply: async () => {
+					try {
+						try {
+							await execAsync("bun add @contractspec/lib.contracts zod", {
+								cwd: ctx.workspaceRoot,
+								timeout: 12e4
+							});
+							return {
+								success: true,
+								message: "Installed with bun"
+							};
+						} catch {
+							await execAsync("npm install @contractspec/lib.contracts zod", {
+								cwd: ctx.workspaceRoot,
+								timeout: 12e4
+							});
+							return {
+								success: true,
+								message: "Installed with npm"
+							};
+						}
+					} catch (error) {
+						return {
+							success: false,
+							message: `Failed: ${error instanceof Error ? error.message : String(error)}`
+						};
+					}
+				}
+			}
+		};
+	} catch {
+		return {
+			category: "deps",
+			name: "ContractSpec Library",
+			status: "skip",
+			message: "Could not read package.json"
+		};
+	}
+}
+
+//#endregion
+export { runDepsChecks };
+//# sourceMappingURL=deps.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deps.js","names":["results: CheckResult[]","detectedManager: string | null"],"sources":["../../../../src/services/doctor/checks/deps.ts"],"sourcesContent":["/**\n * Dependencies 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 } from '../types';\n\nconst execAsync = promisify(exec);\n\n/**\n * Run dependency-related health checks.\n */\nexport async function runDepsChecks(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  // Check Node.js availability\n  results.push(await checkNodeJs(ctx));\n\n  // Check Bun availability\n  results.push(await checkBun(ctx));\n\n  // Check package manager\n  results.push(await checkPackageManager(fs, ctx));\n\n  // Check if node_modules exists\n  results.push(await checkNodeModules(fs, ctx));\n\n  // Check if @contractspec/lib.contracts is installed\n  results.push(await checkContractsLibrary(fs, ctx));\n\n  return results;\n}\n\n/**\n * Check if Node.js is available.\n */\nasync function checkNodeJs(ctx: CheckContext): Promise<CheckResult> {\n  try {\n    const { stdout } = await execAsync('node --version', {\n      cwd: ctx.workspaceRoot,\n      timeout: 5000,\n    });\n\n    const version = stdout.trim();\n\n    return {\n      category: 'deps',\n      name: 'Node.js',\n      status: 'pass',\n      message: `Node.js ${version} available`,\n    };\n  } catch {\n    return {\n      category: 'deps',\n      name: 'Node.js',\n      status: 'fail',\n      message: 'Node.js not found',\n      details: 'Install Node.js from https://nodejs.org',\n    };\n  }\n}\n\n/**\n * Check if Bun is available.\n */\nasync function checkBun(ctx: CheckContext): Promise<CheckResult> {\n  try {\n    const { stdout } = await execAsync('bun --version', {\n      cwd: ctx.workspaceRoot,\n      timeout: 5000,\n    });\n\n    const version = stdout.trim();\n\n    return {\n      category: 'deps',\n      name: 'Bun Runtime',\n      status: 'pass',\n      message: `Bun ${version} available`,\n    };\n  } catch {\n    return {\n      category: 'deps',\n      name: 'Bun Runtime',\n      status: 'warn',\n      message: 'Bun not found (optional but recommended)',\n      details: 'Install Bun from https://bun.sh for faster execution',\n    };\n  }\n}\n\n/**\n * Detect and check the package manager.\n */\nasync function checkPackageManager(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  // Check for lock files to determine package manager\n  const lockFiles = [\n    { file: 'bun.lockb', name: 'bun' },\n    { file: 'pnpm-lock.yaml', name: 'pnpm' },\n    { file: 'yarn.lock', name: 'yarn' },\n    { file: 'package-lock.json', name: 'npm' },\n  ];\n\n  let detectedManager: string | null = null;\n\n  for (const { file, name } of lockFiles) {\n    const lockPath = fs.join(ctx.workspaceRoot, file);\n    if (await fs.exists(lockPath)) {\n      detectedManager = name;\n      break;\n    }\n  }\n\n  if (!detectedManager) {\n    return {\n      category: 'deps',\n      name: 'Package Manager',\n      status: 'warn',\n      message: 'No lock file found',\n      details: 'Run npm install, yarn, pnpm install, or bun install',\n    };\n  }\n\n  // Verify the package manager is available\n  try {\n    await execAsync(`${detectedManager} --version`, {\n      cwd: ctx.workspaceRoot,\n      timeout: 5000,\n    });\n\n    return {\n      category: 'deps',\n      name: 'Package Manager',\n      status: 'pass',\n      message: `Using ${detectedManager}`,\n    };\n  } catch {\n    return {\n      category: 'deps',\n      name: 'Package Manager',\n      status: 'fail',\n      message: `${detectedManager} detected but not available`,\n      details: `Install ${detectedManager} or use a different package manager`,\n    };\n  }\n}\n\n/**\n * Check if node_modules exists.\n */\nasync function checkNodeModules(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const nodeModulesPath = fs.join(ctx.workspaceRoot, 'node_modules');\n\n  const exists = await fs.exists(nodeModulesPath);\n  if (exists) {\n    return {\n      category: 'deps',\n      name: 'Dependencies Installed',\n      status: 'pass',\n      message: 'node_modules directory exists',\n    };\n  }\n\n  return {\n    category: 'deps',\n    name: 'Dependencies Installed',\n    status: 'fail',\n    message: 'node_modules not found',\n    details: 'Run your package manager install command',\n    fix: {\n      description: 'Install dependencies',\n      apply: async () => {\n        try {\n          // Try bun first, then npm\n          try {\n            await execAsync('bun install', {\n              cwd: ctx.workspaceRoot,\n              timeout: 120000,\n            });\n            return { success: true, message: 'Installed with bun' };\n          } catch {\n            await execAsync('npm install', {\n              cwd: ctx.workspaceRoot,\n              timeout: 120000,\n            });\n            return { success: true, message: 'Installed with npm' };\n          }\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/lib.contracts is installed.\n */\nasync function checkContractsLibrary(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const packageJsonPath = fs.join(ctx.workspaceRoot, 'package.json');\n\n  try {\n    const content = await fs.readFile(packageJsonPath);\n    const packageJson = JSON.parse(content) as {\n      dependencies?: Record<string, string>;\n      devDependencies?: Record<string, string>;\n    };\n\n    const allDeps = {\n      ...packageJson.dependencies,\n      ...packageJson.devDependencies,\n    };\n\n    if ('@contractspec/lib.contracts' in allDeps) {\n      return {\n        category: 'deps',\n        name: 'ContractSpec Library',\n        status: 'pass',\n        message: `@contractspec/lib.contracts installed (${allDeps['@contractspec/lib.contracts']})`,\n      };\n    }\n\n    return {\n      category: 'deps',\n      name: 'ContractSpec Library',\n      status: 'fail',\n      message: '@contractspec/lib.contracts not installed',\n      details: 'Run \"contractspec quickstart\" to install required packages',\n      fix: {\n        description: 'Install @contractspec/lib.contracts and dependencies',\n        apply: async () => {\n          try {\n            // Try bun first, then npm\n            try {\n              await execAsync('bun add @contractspec/lib.contracts zod', {\n                cwd: ctx.workspaceRoot,\n                timeout: 120000,\n              });\n              return { success: true, message: 'Installed with bun' };\n            } catch {\n              await execAsync('npm install @contractspec/lib.contracts zod', {\n                cwd: ctx.workspaceRoot,\n                timeout: 120000,\n              });\n              return { success: true, message: 'Installed with npm' };\n            }\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: 'deps',\n      name: 'ContractSpec Library',\n      status: 'skip',\n      message: 'Could not read package.json',\n    };\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,6 @@
+import { runCliChecks } from "./cli.js";
+import { runConfigChecks } from "./config.js";
+import { runMcpChecks } from "./mcp.js";
+import { runDepsChecks } from "./deps.js";
+import { runWorkspaceChecks } from "./workspace.js";
+import { runAiChecks } from "./ai.js";

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

@@ -0,0 +1,145 @@
+import { generateCursorMcpConfig, getClaudeDesktopConfigPath } from "../../setup/config-generators.js";
+import { deepMergePreserve, formatJson } from "../../setup/file-merger.js";
+
+//#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.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","names":["results: CheckResult[]"],"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,MAAMA,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.js

@@ -0,0 +1,244 @@
+//#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
+			};
+		}
+	}
+	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
+			};
+		}
+		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 outputDir = JSON.parse(content).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
+		};
+		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.js.map