@contractspec/bundle.workspace 1.44.0

package/dist/services/setup/config-generators.js

@@ -0,0 +1,238 @@
+//#region src/services/setup/config-generators.ts
+/**
+* Generate .contractsrc.json content.
+*
+* Adapts defaults based on monorepo scope.
+*/
+function generateContractsrcConfig(options) {
+	const isPackageLevel = options.isMonorepo && options.scope === "package";
+	return {
+		$schema: "https://api.contractspec.io/schemas/contractsrc.json",
+		aiProvider: "claude",
+		aiModel: "claude-sonnet-4-20250514",
+		agentMode: "claude-code",
+		outputDir: "./src",
+		conventions: {
+			operations: "contracts/operations",
+			events: "contracts/events",
+			presentations: "contracts/presentations",
+			forms: "contracts/forms",
+			features: "contracts/features"
+		},
+		defaultOwners: options.defaultOwners ?? ["@team"],
+		defaultTags: [],
+		...isPackageLevel && options.packageName ? { package: options.packageName } : {}
+	};
+}
+/**
+* Generate .vscode/settings.json ContractSpec settings.
+*/
+function generateVscodeSettings() {
+	return {
+		"contractspec.validation.enabled": true,
+		"contractspec.validation.validateOnSave": true,
+		"contractspec.validation.validateOnOpen": true,
+		"contractspec.codeLens.enabled": true,
+		"contractspec.diagnostics.showWarnings": true,
+		"contractspec.diagnostics.showHints": true,
+		"contractspec.integrity.enabled": true,
+		"contractspec.integrity.checkOnSave": true
+	};
+}
+/**
+* Generate .cursor/mcp.json content.
+*/
+function generateCursorMcpConfig() {
+	return { mcpServers: { "contractspec-local": {
+		command: "bunx",
+		args: ["contractspec-mcp"]
+	} } };
+}
+/**
+* Generate Claude Desktop MCP config.
+* Returns the mcpServers section to merge into claude_desktop_config.json.
+*/
+function generateClaudeMcpConfig() {
+	return { mcpServers: { "contractspec-local": {
+		command: "bunx",
+		args: ["contractspec-mcp"]
+	} } };
+}
+/**
+* Generate .cursor/rules/contractspec.mdc content.
+*
+* Adapts paths based on monorepo scope.
+*/
+function generateCursorRules(options) {
+	const projectName = options.projectName ?? "this project";
+	const basePath = options.isMonorepo && options.scope === "package" && options.packageRoot ? `${options.packageRoot.split("/").slice(-2).join("/")}/src/contracts` : "src/contracts";
+	return `# ContractSpec Development Rules
+
+This project uses ContractSpec for spec-first development. Follow these guidelines when working with AI agents.
+
+## Spec-First Principle
+
+- **Always update contracts first** before changing implementation code.
+- Contracts are the source of truth for operations, events, and presentations.
+- Implementation code should be generated or derived from contracts.
+${options.isMonorepo ? `\n## Monorepo Structure\n\nThis is a monorepo. Contracts may exist at:\n- Package level: \`packages/*/src/contracts/\`\n- Workspace level: \`src/contracts/\`\n\nCheck the appropriate level based on the feature scope.\n` : ""}
+## Contract Locations
+
+Contracts are located in:
+- \`${basePath}/operations/\` - Command and query specs
+- \`${basePath}/events/\` - Event specs
+- \`${basePath}/presentations/\` - UI presentation specs
+- \`${basePath}/features/\` - Feature module specs
+
+## When Making Changes
+
+1. **Before coding**: Check if a contract exists for the feature.
+2. **If contract exists**: Update the contract first, then regenerate code.
+3. **If no contract**: Create a new contract using \`contractspec create\`.
+4. **After changes**: Validate with \`contractspec validate\`.
+
+## Key Commands
+
+- \`contractspec create\` - Scaffold new specs
+- \`contractspec validate\` - Validate specs
+- \`contractspec build\` - Generate implementation code
+- \`contractspec integrity\` - Check contract health
+
+## Contract Structure
+
+Operations follow this pattern:
+\`\`\`typescript
+defineCommand({
+  meta: { name: 'service.action', version: 1, ... },
+  io: { input: InputSchema, output: OutputSchema },
+  policy: { auth: 'user', ... },
+  handler: async (args, ctx) => { ... }
+});
+\`\`\`
+
+## Rules for ${projectName}
+
+- All API endpoints must have a corresponding operation contract.
+- Events must be declared in contracts before being emitted.
+- UI components should reference presentation contracts.
+- Feature flags should be defined in feature modules.
+`;
+}
+/**
+* Generate AGENTS.md content.
+*
+* Adapts paths and instructions based on monorepo scope.
+*/
+function generateAgentsMd(options) {
+	const projectName = options.projectName ?? "This Project";
+	const isPackageLevel = options.isMonorepo && options.scope === "package";
+	const contractPath = "src/contracts/";
+	return `# AI Agent Guide
+
+This repository uses **ContractSpec** for spec-first development. AI agents should follow these guidelines.
+
+## Project: ${projectName}
+
+## ContractSpec Overview
+
+ContractSpec is a deterministic, spec-first compiler that keeps AI-written software coherent, safe, and regenerable.
+
+### Key Principles
+
+1. **Contracts are the source of truth** - Always check/update contracts before modifying implementation.
+2. **Safe regeneration** - Code can be regenerated from specs without breaking invariants.
+3. **Multi-surface consistency** - API, events, and UI stay in sync via shared contracts.
+${options.isMonorepo ? `
+## Monorepo Structure
+
+This is a monorepo. Contracts can exist at multiple levels:
+
+| Level | Location | Use Case |
+|-------|----------|----------|
+| Package | \`packages/*/src/contracts/\` | Package-specific contracts |
+| Workspace | \`src/contracts/\` | Shared cross-package contracts |
+
+When adding a contract, consider:
+- Is this specific to one package? → Add at package level
+- Is this shared across packages? → Add at workspace level
+
+### Current Scope
+
+${isPackageLevel ? `You are working at the **package level**: \`${options.packageName ?? options.packageRoot}\`` : "You are working at the **workspace level**."}
+` : ""}
+## Working in This Repository
+
+### Before Making Changes
+
+1. Check for existing contracts in \`${contractPath}\`
+2. If a contract exists, update it first
+3. Regenerate implementation with \`contractspec build\`
+4. Validate with \`contractspec validate\`
+
+### Creating New Features
+
+1. Create a feature spec: \`contractspec create --type=feature\`
+2. Add operations: \`contractspec create --type=operation\`
+3. Add events if needed: \`contractspec create --type=event\`
+4. Build implementation: \`contractspec build\`
+
+### Contract Locations
+
+| Type | Location |
+|------|----------|
+| Operations | \`${contractPath}operations/\` |
+| Events | \`${contractPath}events/\` |
+| Presentations | \`${contractPath}presentations/\` |
+| Features | \`${contractPath}features/\` |
+
+## MCP Tools Available
+
+The ContractSpec MCP server provides these tools:
+
+- \`integrity.analyze\` - Check contract health
+- \`specs.list\` - List all specs
+- \`specs.validate\` - Validate a spec file
+- \`specs.create\` - Create new specs
+- \`deps.analyze\` - Analyze dependencies
+
+## Common Tasks
+
+### Add a new API endpoint
+
+\`\`\`bash
+contractspec create --type=operation --name=myService.newAction
+\`\`\`
+
+### Add a new event
+
+\`\`\`bash
+contractspec create --type=event --name=entity.changed
+\`\`\`
+
+### Check contract integrity
+
+\`\`\`bash
+contractspec integrity
+\`\`\`
+
+## Nested AGENTS.md
+
+More specific instructions may exist in subdirectories. Check for \`AGENTS.md\` files in the relevant package or module.
+`;
+}
+/**
+* Get the file path for Claude Desktop config based on platform.
+*/
+function getClaudeDesktopConfigPath() {
+	const platform = process.platform;
+	const homeDir = process.env["HOME"] ?? process.env["USERPROFILE"] ?? "";
+	switch (platform) {
+		case "darwin": return `${homeDir}/Library/Application Support/Claude/claude_desktop_config.json`;
+		case "win32": return `${process.env["APPDATA"] ?? homeDir}/Claude/claude_desktop_config.json`;
+		default: return `${homeDir}/.config/claude/claude_desktop_config.json`;
+	}
+}
+
+//#endregion
+export { generateAgentsMd, generateClaudeMcpConfig, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateVscodeSettings, getClaudeDesktopConfigPath };
+//# sourceMappingURL=config-generators.js.map

package/dist/services/setup/config-generators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-generators.js","names":[],"sources":["../../../src/services/setup/config-generators.ts"],"sourcesContent":["/**\n * Config generators for setup targets.\n *\n * Each generator returns the default configuration for a target.\n */\n\nimport type { SetupOptions } from './types';\n\n/**\n * Generate .contractsrc.json content.\n *\n * Adapts defaults based on monorepo scope.\n */\nexport function generateContractsrcConfig(options: SetupOptions): object {\n  // For package-level config in monorepo, use simpler relative paths\n  const isPackageLevel = options.isMonorepo && options.scope === 'package';\n\n  return {\n    $schema: 'https://api.contractspec.io/schemas/contractsrc.json',\n    aiProvider: 'claude',\n    aiModel: 'claude-sonnet-4-20250514',\n    agentMode: 'claude-code',\n    // outputDir is relative to the config file location\n    outputDir: './src',\n    conventions: {\n      operations: 'contracts/operations',\n      events: 'contracts/events',\n      presentations: 'contracts/presentations',\n      forms: 'contracts/forms',\n      features: 'contracts/features',\n    },\n    defaultOwners: options.defaultOwners ?? ['@team'],\n    defaultTags: [],\n    // Add monorepo hint if at package level\n    ...(isPackageLevel && options.packageName\n      ? { package: options.packageName }\n      : {}),\n  };\n}\n\n/**\n * Generate .vscode/settings.json ContractSpec settings.\n */\nexport function generateVscodeSettings(): object {\n  return {\n    'contractspec.validation.enabled': true,\n    'contractspec.validation.validateOnSave': true,\n    'contractspec.validation.validateOnOpen': true,\n    'contractspec.codeLens.enabled': true,\n    'contractspec.diagnostics.showWarnings': true,\n    'contractspec.diagnostics.showHints': true,\n    'contractspec.integrity.enabled': true,\n    'contractspec.integrity.checkOnSave': true,\n  };\n}\n\n/**\n * Generate .cursor/mcp.json content.\n */\nexport function generateCursorMcpConfig(): object {\n  return {\n    mcpServers: {\n      'contractspec-local': {\n        command: 'bunx',\n        args: ['contractspec-mcp'],\n      },\n    },\n  };\n}\n\n/**\n * Generate Claude Desktop MCP config.\n * Returns the mcpServers section to merge into claude_desktop_config.json.\n */\nexport function generateClaudeMcpConfig(): object {\n  return {\n    mcpServers: {\n      'contractspec-local': {\n        command: 'bunx',\n        args: ['contractspec-mcp'],\n      },\n    },\n  };\n}\n\n/**\n * Generate .cursor/rules/contractspec.mdc content.\n *\n * Adapts paths based on monorepo scope.\n */\nexport function generateCursorRules(options: SetupOptions): string {\n  const projectName = options.projectName ?? 'this project';\n  const isPackageLevel = options.isMonorepo && options.scope === 'package';\n\n  // Base contract path depends on scope\n  const basePath =\n    isPackageLevel && options.packageRoot\n      ? `${options.packageRoot.split('/').slice(-2).join('/')}/src/contracts`\n      : 'src/contracts';\n\n  const monorepoNote = options.isMonorepo\n    ? `\\n## Monorepo Structure\\n\\nThis is a monorepo. Contracts may exist at:\\n- Package level: \\`packages/*/src/contracts/\\`\\n- Workspace level: \\`src/contracts/\\`\\n\\nCheck the appropriate level based on the feature scope.\\n`\n    : '';\n\n  return `# ContractSpec Development Rules\n\nThis project uses ContractSpec for spec-first development. Follow these guidelines when working with AI agents.\n\n## Spec-First Principle\n\n- **Always update contracts first** before changing implementation code.\n- Contracts are the source of truth for operations, events, and presentations.\n- Implementation code should be generated or derived from contracts.\n${monorepoNote}\n## Contract Locations\n\nContracts are located in:\n- \\`${basePath}/operations/\\` - Command and query specs\n- \\`${basePath}/events/\\` - Event specs\n- \\`${basePath}/presentations/\\` - UI presentation specs\n- \\`${basePath}/features/\\` - Feature module specs\n\n## When Making Changes\n\n1. **Before coding**: Check if a contract exists for the feature.\n2. **If contract exists**: Update the contract first, then regenerate code.\n3. **If no contract**: Create a new contract using \\`contractspec create\\`.\n4. **After changes**: Validate with \\`contractspec validate\\`.\n\n## Key Commands\n\n- \\`contractspec create\\` - Scaffold new specs\n- \\`contractspec validate\\` - Validate specs\n- \\`contractspec build\\` - Generate implementation code\n- \\`contractspec integrity\\` - Check contract health\n\n## Contract Structure\n\nOperations follow this pattern:\n\\`\\`\\`typescript\ndefineCommand({\n  meta: { name: 'service.action', version: 1, ... },\n  io: { input: InputSchema, output: OutputSchema },\n  policy: { auth: 'user', ... },\n  handler: async (args, ctx) => { ... }\n});\n\\`\\`\\`\n\n## Rules for ${projectName}\n\n- All API endpoints must have a corresponding operation contract.\n- Events must be declared in contracts before being emitted.\n- UI components should reference presentation contracts.\n- Feature flags should be defined in feature modules.\n`;\n}\n\n/**\n * Generate AGENTS.md content.\n *\n * Adapts paths and instructions based on monorepo scope.\n */\nexport function generateAgentsMd(options: SetupOptions): string {\n  const projectName = options.projectName ?? 'This Project';\n  const isPackageLevel = options.isMonorepo && options.scope === 'package';\n\n  // Contract path depends on scope\n  const contractPath = 'src/contracts/';\n\n  const monorepoSection = options.isMonorepo\n    ? `\n## Monorepo Structure\n\nThis is a monorepo. Contracts can exist at multiple levels:\n\n| Level | Location | Use Case |\n|-------|----------|----------|\n| Package | \\`packages/*/src/contracts/\\` | Package-specific contracts |\n| Workspace | \\`src/contracts/\\` | Shared cross-package contracts |\n\nWhen adding a contract, consider:\n- Is this specific to one package? → Add at package level\n- Is this shared across packages? → Add at workspace level\n\n### Current Scope\n\n${isPackageLevel ? `You are working at the **package level**: \\`${options.packageName ?? options.packageRoot}\\`` : 'You are working at the **workspace level**.'}\n`\n    : '';\n\n  return `# AI Agent Guide\n\nThis repository uses **ContractSpec** for spec-first development. AI agents should follow these guidelines.\n\n## Project: ${projectName}\n\n## ContractSpec Overview\n\nContractSpec is a deterministic, spec-first compiler that keeps AI-written software coherent, safe, and regenerable.\n\n### Key Principles\n\n1. **Contracts are the source of truth** - Always check/update contracts before modifying implementation.\n2. **Safe regeneration** - Code can be regenerated from specs without breaking invariants.\n3. **Multi-surface consistency** - API, events, and UI stay in sync via shared contracts.\n${monorepoSection}\n## Working in This Repository\n\n### Before Making Changes\n\n1. Check for existing contracts in \\`${contractPath}\\`\n2. If a contract exists, update it first\n3. Regenerate implementation with \\`contractspec build\\`\n4. Validate with \\`contractspec validate\\`\n\n### Creating New Features\n\n1. Create a feature spec: \\`contractspec create --type=feature\\`\n2. Add operations: \\`contractspec create --type=operation\\`\n3. Add events if needed: \\`contractspec create --type=event\\`\n4. Build implementation: \\`contractspec build\\`\n\n### Contract Locations\n\n| Type | Location |\n|------|----------|\n| Operations | \\`${contractPath}operations/\\` |\n| Events | \\`${contractPath}events/\\` |\n| Presentations | \\`${contractPath}presentations/\\` |\n| Features | \\`${contractPath}features/\\` |\n\n## MCP Tools Available\n\nThe ContractSpec MCP server provides these tools:\n\n- \\`integrity.analyze\\` - Check contract health\n- \\`specs.list\\` - List all specs\n- \\`specs.validate\\` - Validate a spec file\n- \\`specs.create\\` - Create new specs\n- \\`deps.analyze\\` - Analyze dependencies\n\n## Common Tasks\n\n### Add a new API endpoint\n\n\\`\\`\\`bash\ncontractspec create --type=operation --name=myService.newAction\n\\`\\`\\`\n\n### Add a new event\n\n\\`\\`\\`bash\ncontractspec create --type=event --name=entity.changed\n\\`\\`\\`\n\n### Check contract integrity\n\n\\`\\`\\`bash\ncontractspec integrity\n\\`\\`\\`\n\n## Nested AGENTS.md\n\nMore specific instructions may exist in subdirectories. Check for \\`AGENTS.md\\` files in the relevant package or module.\n`;\n}\n\n/**\n * Get the file path for Claude Desktop config based on platform.\n */\nexport function getClaudeDesktopConfigPath(): string {\n  const platform = process.platform;\n  const homeDir = process.env['HOME'] ?? process.env['USERPROFILE'] ?? '';\n\n  switch (platform) {\n    case 'darwin':\n      return `${homeDir}/Library/Application Support/Claude/claude_desktop_config.json`;\n    case 'win32':\n      return `${process.env['APPDATA'] ?? homeDir}/Claude/claude_desktop_config.json`;\n    default:\n      // Linux and others\n      return `${homeDir}/.config/claude/claude_desktop_config.json`;\n  }\n}\n"],"mappings":";;;;;;AAaA,SAAgB,0BAA0B,SAA+B;CAEvE,MAAM,iBAAiB,QAAQ,cAAc,QAAQ,UAAU;AAE/D,QAAO;EACL,SAAS;EACT,YAAY;EACZ,SAAS;EACT,WAAW;EAEX,WAAW;EACX,aAAa;GACX,YAAY;GACZ,QAAQ;GACR,eAAe;GACf,OAAO;GACP,UAAU;GACX;EACD,eAAe,QAAQ,iBAAiB,CAAC,QAAQ;EACjD,aAAa,EAAE;EAEf,GAAI,kBAAkB,QAAQ,cAC1B,EAAE,SAAS,QAAQ,aAAa,GAChC,EAAE;EACP;;;;;AAMH,SAAgB,yBAAiC;AAC/C,QAAO;EACL,mCAAmC;EACnC,0CAA0C;EAC1C,0CAA0C;EAC1C,iCAAiC;EACjC,yCAAyC;EACzC,sCAAsC;EACtC,kCAAkC;EAClC,sCAAsC;EACvC;;;;;AAMH,SAAgB,0BAAkC;AAChD,QAAO,EACL,YAAY,EACV,sBAAsB;EACpB,SAAS;EACT,MAAM,CAAC,mBAAmB;EAC3B,EACF,EACF;;;;;;AAOH,SAAgB,0BAAkC;AAChD,QAAO,EACL,YAAY,EACV,sBAAsB;EACpB,SAAS;EACT,MAAM,CAAC,mBAAmB;EAC3B,EACF,EACF;;;;;;;AAQH,SAAgB,oBAAoB,SAA+B;CACjE,MAAM,cAAc,QAAQ,eAAe;CAI3C,MAAM,WAHiB,QAAQ,cAAc,QAAQ,UAAU,aAI3C,QAAQ,cACtB,GAAG,QAAQ,YAAY,MAAM,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,IAAI,CAAC,kBACtD;AAMN,QAAO;;;;;;;;;EAJc,QAAQ,aACzB,+NACA,GAWS;;;;MAIT,SAAS;MACT,SAAS;MACT,SAAS;MACT,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA4BA,YAAY;;;;;;;;;;;;;AAc3B,SAAgB,iBAAiB,SAA+B;CAC9D,MAAM,cAAc,QAAQ,eAAe;CAC3C,MAAM,iBAAiB,QAAQ,cAAc,QAAQ,UAAU;CAG/D,MAAM,eAAe;AAuBrB,QAAO;;;;cAIK,YAAY;;;;;;;;;;;EAzBA,QAAQ,aAC5B;;;;;;;;;;;;;;;;EAgBJ,iBAAiB,+CAA+C,QAAQ,eAAe,QAAQ,YAAY,MAAM,8CAA8C;IAE3J,GAiBY;;;;;uCAKqB,aAAa;;;;;;;;;;;;;;;;mBAgBjC,aAAa;eACjB,aAAa;sBACN,aAAa;iBAClB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyC9B,SAAgB,6BAAqC;CACnD,MAAM,WAAW,QAAQ;CACzB,MAAM,UAAU,QAAQ,IAAI,WAAW,QAAQ,IAAI,kBAAkB;AAErE,SAAQ,UAAR;EACE,KAAK,SACH,QAAO,GAAG,QAAQ;EACpB,KAAK,QACH,QAAO,GAAG,QAAQ,IAAI,cAAc,QAAQ;EAC9C,QAEE,QAAO,GAAG,QAAQ"}

package/dist/services/setup/file-merger.d.ts

@@ -0,0 +1,27 @@
+//#region src/services/setup/file-merger.d.ts
+/**
+ * File merger utilities.
+ *
+ * Deep-merges JSON files without losing user settings.
+ */
+/**
+ * Deep merge two objects, preserving existing user values.
+ * New keys are added, but existing keys are NOT overwritten.
+ */
+declare function deepMergePreserve<T extends Record<string, unknown>>(existing: T, defaults: T): T;
+/**
+ * Deep merge two objects, with new values taking precedence.
+ * Used when we want to update existing configs.
+ */
+declare function deepMergeOverwrite<T extends Record<string, unknown>>(existing: T, updates: Partial<T>): T;
+/**
+ * Parse JSON safely, returning null on failure.
+ */
+declare function safeParseJson<T>(content: string): T | null;
+/**
+ * Format JSON with consistent indentation.
+ */
+declare function formatJson(obj: unknown): string;
+//#endregion
+export { deepMergeOverwrite, deepMergePreserve, formatJson, safeParseJson };
+//# sourceMappingURL=file-merger.d.ts.map

package/dist/services/setup/file-merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-merger.d.ts","names":[],"sources":["../../../src/services/setup/file-merger.ts"],"sourcesContent":[],"mappings":";;AAUA;;;;;;AA8BA;;AACY,iBA/BI,iBA+BJ,CAAA,UA/BgC,MA+BhC,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,CAAA,QAAA,EA9BA,CA8BA,EAAA,QAAA,EA7BA,CA6BA,CAAA,EA5BT,CA4BS;;;;;AAyCI,iBA1CA,kBA0CoC,CAAA,UA1CP,MA0CO,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,CAAA,QAAA,EAzCxC,CAyCwC,EAAA,OAAA,EAxCzC,OAwCyC,CAxCjC,CAwCiC,CAAA,CAAA,EAvCjD,CAuCiD;AAWpD;;;iBAXgB,mCAAmC;;;;iBAWnC,UAAA"}

package/dist/services/setup/file-merger.js

@@ -0,0 +1,61 @@
+//#region src/services/setup/file-merger.ts
+/**
+* File merger utilities.
+*
+* Deep-merges JSON files without losing user settings.
+*/
+/**
+* Deep merge two objects, preserving existing user values.
+* New keys are added, but existing keys are NOT overwritten.
+*/
+function deepMergePreserve(existing, defaults) {
+	const result = { ...existing };
+	for (const key of Object.keys(defaults)) {
+		const existingValue = existing[key];
+		const defaultValue = defaults[key];
+		if (existingValue === void 0) result[key] = defaultValue;
+		else if (isPlainObject(existingValue) && isPlainObject(defaultValue)) result[key] = deepMergePreserve(existingValue, defaultValue);
+	}
+	return result;
+}
+/**
+* Deep merge two objects, with new values taking precedence.
+* Used when we want to update existing configs.
+*/
+function deepMergeOverwrite(existing, updates) {
+	const result = { ...existing };
+	for (const key of Object.keys(updates)) {
+		const existingValue = existing[key];
+		const updateValue = updates[key];
+		if (updateValue === void 0) continue;
+		if (isPlainObject(existingValue) && isPlainObject(updateValue)) result[key] = deepMergeOverwrite(existingValue, updateValue);
+		else result[key] = updateValue;
+	}
+	return result;
+}
+/**
+* Check if a value is a plain object (not array, null, or other).
+*/
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) && Object.getPrototypeOf(value) === Object.prototype;
+}
+/**
+* Parse JSON safely, returning null on failure.
+*/
+function safeParseJson(content) {
+	try {
+		return JSON.parse(content);
+	} catch {
+		return null;
+	}
+}
+/**
+* Format JSON with consistent indentation.
+*/
+function formatJson(obj) {
+	return JSON.stringify(obj, null, 2) + "\n";
+}
+
+//#endregion
+export { deepMergeOverwrite, deepMergePreserve, formatJson, safeParseJson };
+//# sourceMappingURL=file-merger.js.map

package/dist/services/setup/file-merger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-merger.js","names":[],"sources":["../../../src/services/setup/file-merger.ts"],"sourcesContent":["/**\n * File merger utilities.\n *\n * Deep-merges JSON files without losing user settings.\n */\n\n/**\n * Deep merge two objects, preserving existing user values.\n * New keys are added, but existing keys are NOT overwritten.\n */\nexport function deepMergePreserve<T extends Record<string, unknown>>(\n  existing: T,\n  defaults: T\n): T {\n  const result = { ...existing };\n\n  for (const key of Object.keys(defaults)) {\n    const existingValue = existing[key];\n    const defaultValue = defaults[key];\n\n    if (existingValue === undefined) {\n      // Key doesn't exist in user config, add it\n      (result as Record<string, unknown>)[key] = defaultValue;\n    } else if (isPlainObject(existingValue) && isPlainObject(defaultValue)) {\n      // Both are objects, recurse\n      (result as Record<string, unknown>)[key] = deepMergePreserve(\n        existingValue as Record<string, unknown>,\n        defaultValue as Record<string, unknown>\n      );\n    }\n    // If key exists and is not an object, keep user's value\n  }\n\n  return result;\n}\n\n/**\n * Deep merge two objects, with new values taking precedence.\n * Used when we want to update existing configs.\n */\nexport function deepMergeOverwrite<T extends Record<string, unknown>>(\n  existing: T,\n  updates: Partial<T>\n): T {\n  const result = { ...existing };\n\n  for (const key of Object.keys(updates)) {\n    const existingValue = existing[key];\n    const updateValue = updates[key];\n\n    if (updateValue === undefined) {\n      continue;\n    }\n\n    if (isPlainObject(existingValue) && isPlainObject(updateValue)) {\n      (result as Record<string, unknown>)[key] = deepMergeOverwrite(\n        existingValue as Record<string, unknown>,\n        updateValue as Record<string, unknown>\n      );\n    } else {\n      (result as Record<string, unknown>)[key] = updateValue;\n    }\n  }\n\n  return result;\n}\n\n/**\n * Check if a value is a plain object (not array, null, or other).\n */\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    !Array.isArray(value) &&\n    Object.getPrototypeOf(value) === Object.prototype\n  );\n}\n\n/**\n * Parse JSON safely, returning null on failure.\n */\nexport function safeParseJson<T>(content: string): T | null {\n  try {\n    return JSON.parse(content) as T;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Format JSON with consistent indentation.\n */\nexport function formatJson(obj: unknown): string {\n  return JSON.stringify(obj, null, 2) + '\\n';\n}\n"],"mappings":";;;;;;;;;;AAUA,SAAgB,kBACd,UACA,UACG;CACH,MAAM,SAAS,EAAE,GAAG,UAAU;AAE9B,MAAK,MAAM,OAAO,OAAO,KAAK,SAAS,EAAE;EACvC,MAAM,gBAAgB,SAAS;EAC/B,MAAM,eAAe,SAAS;AAE9B,MAAI,kBAAkB,OAEpB,CAAC,OAAmC,OAAO;WAClC,cAAc,cAAc,IAAI,cAAc,aAAa,CAEpE,CAAC,OAAmC,OAAO,kBACzC,eACA,aACD;;AAKL,QAAO;;;;;;AAOT,SAAgB,mBACd,UACA,SACG;CACH,MAAM,SAAS,EAAE,GAAG,UAAU;AAE9B,MAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,EAAE;EACtC,MAAM,gBAAgB,SAAS;EAC/B,MAAM,cAAc,QAAQ;AAE5B,MAAI,gBAAgB,OAClB;AAGF,MAAI,cAAc,cAAc,IAAI,cAAc,YAAY,CAC5D,CAAC,OAAmC,OAAO,mBACzC,eACA,YACD;MAED,CAAC,OAAmC,OAAO;;AAI/C,QAAO;;;;;AAMT,SAAS,cAAc,OAAkD;AACvE,QACE,OAAO,UAAU,YACjB,UAAU,QACV,CAAC,MAAM,QAAQ,MAAM,IACrB,OAAO,eAAe,MAAM,KAAK,OAAO;;;;;AAO5C,SAAgB,cAAiB,SAA2B;AAC1D,KAAI;AACF,SAAO,KAAK,MAAM,QAAQ;SACpB;AACN,SAAO;;;;;;AAOX,SAAgB,WAAW,KAAsB;AAC/C,QAAO,KAAK,UAAU,KAAK,MAAM,EAAE,GAAG"}

package/dist/services/setup/index.js

@@ -0,0 +1,4 @@
+import { ALL_SETUP_TARGETS, SETUP_TARGET_LABELS } from "./types.js";
+import { generateAgentsMd, generateClaudeMcpConfig, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateVscodeSettings, getClaudeDesktopConfigPath } from "./config-generators.js";
+import { deepMergeOverwrite, deepMergePreserve, formatJson, safeParseJson } from "./file-merger.js";
+import { runSetup } from "./setup-service.js";

package/dist/services/setup/setup-service.d.ts

@@ -0,0 +1,12 @@
+import { FsAdapter } from "../../ports/fs.js";
+import { SetupOptions, SetupPromptCallbacks, SetupResult } from "./types.js";
+
+//#region src/services/setup/setup-service.d.ts
+
+/**
+ * Run the ContractSpec setup.
+ */
+declare function runSetup(fs: FsAdapter, options: SetupOptions, prompts?: SetupPromptCallbacks): Promise<SetupResult>;
+//#endregion
+export { runSetup };
+//# sourceMappingURL=setup-service.d.ts.map

package/dist/services/setup/setup-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-service.d.ts","names":[],"sources":["../../../src/services/setup/setup-service.ts"],"sourcesContent":[],"mappings":";;;;;;;;iBA6CsB,QAAA,KAChB,oBACK,wBACA,uBACR,QAAQ"}

package/dist/services/setup/setup-service.js

@@ -0,0 +1,96 @@
+import { findPackageRoot, findWorkspaceRoot, getPackageName, isMonorepo } from "../../adapters/workspace.js";
+import { ALL_SETUP_TARGETS, SETUP_TARGET_LABELS } from "./types.js";
+import { setupCliConfig } from "./targets/cli-config.js";
+import { setupVscodeSettings } from "./targets/vscode-settings.js";
+import { setupMcpCursor } from "./targets/mcp-cursor.js";
+import { setupMcpClaude } from "./targets/mcp-claude.js";
+import { setupCursorRules } from "./targets/cursor-rules.js";
+import { setupAgentsMd } from "./targets/agents-md.js";
+
+//#region src/services/setup/setup-service.ts
+/**
+* Default prompt callbacks that always accept defaults.
+*/
+const defaultPrompts = {
+	confirm: async () => true,
+	multiSelect: async (_msg, options) => options.filter((o) => o.selected !== false).map((o) => o.value),
+	input: async (_msg, defaultValue) => defaultValue ?? ""
+};
+/**
+* Run the ContractSpec setup.
+*/
+async function runSetup(fs, options, prompts = defaultPrompts) {
+	const results = [];
+	const targets = options.targets.length > 0 ? options.targets : ALL_SETUP_TARGETS;
+	const workspaceRoot = options.workspaceRoot;
+	const detectedWorkspaceRoot = findWorkspaceRoot(workspaceRoot);
+	const packageRoot = options.packageRoot ?? findPackageRoot(workspaceRoot);
+	const monorepo = options.isMonorepo ?? isMonorepo(detectedWorkspaceRoot);
+	const packageName = options.packageName ?? (monorepo ? getPackageName(packageRoot) : void 0);
+	let scope = options.scope ?? "workspace";
+	const isDifferentRoots = packageRoot !== detectedWorkspaceRoot;
+	if (monorepo && options.interactive && isDifferentRoots) scope = (await prompts.multiSelect(`Monorepo detected. Configure at which level?`, [{
+		value: "package",
+		label: `Package level (${packageName ?? packageRoot})`,
+		selected: true
+	}, {
+		value: "workspace",
+		label: `Workspace level (${detectedWorkspaceRoot})`
+	}]))[0] ?? "package";
+	let selectedTargets = targets;
+	if (options.interactive) selectedTargets = await prompts.multiSelect("Select components to configure:", ALL_SETUP_TARGETS.map((t) => ({
+		value: t,
+		label: SETUP_TARGET_LABELS[t],
+		selected: targets.includes(t)
+	})));
+	let projectName = options.projectName;
+	if (options.interactive && !projectName) {
+		const defaultName = scope === "package" && packageName ? packageName : workspaceRoot.split("/").pop() ?? "my-project";
+		projectName = await prompts.input("Project name:", defaultName);
+	}
+	const setupOptions = {
+		...options,
+		workspaceRoot: detectedWorkspaceRoot,
+		packageRoot,
+		isMonorepo: monorepo,
+		scope,
+		packageName,
+		projectName,
+		targets: selectedTargets
+	};
+	for (const target of selectedTargets) {
+		const result = await setupTarget(fs, target, setupOptions, prompts);
+		results.push(result);
+	}
+	const succeeded = results.filter((r) => r.action !== "error").length;
+	const failed = results.filter((r) => r.action === "error").length;
+	const scopeInfo = monorepo ? ` (${scope} level)` : "";
+	return {
+		success: failed === 0,
+		files: results,
+		summary: `Setup complete${scopeInfo}: ${succeeded} configured, ${failed} failed.`
+	};
+}
+/**
+* Setup a single target.
+*/
+async function setupTarget(fs, target, options, prompts) {
+	switch (target) {
+		case "cli-config": return setupCliConfig(fs, options, prompts);
+		case "vscode-settings": return setupVscodeSettings(fs, options, prompts);
+		case "mcp-cursor": return setupMcpCursor(fs, options, prompts);
+		case "mcp-claude": return setupMcpClaude(fs, options, prompts);
+		case "cursor-rules": return setupCursorRules(fs, options, prompts);
+		case "agents-md": return setupAgentsMd(fs, options, prompts);
+		default: return {
+			target,
+			filePath: "",
+			action: "error",
+			message: `Unknown target: ${target}`
+		};
+	}
+}
+
+//#endregion
+export { runSetup };
+//# sourceMappingURL=setup-service.js.map

package/dist/services/setup/setup-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-service.js","names":["defaultPrompts: SetupPromptCallbacks","results: SetupFileResult[]","scope: SetupScope","setupOptions: SetupOptions"],"sources":["../../../src/services/setup/setup-service.ts"],"sourcesContent":["/**\n * Setup service.\n *\n * Orchestrates the full ContractSpec setup flow.\n * Supports both single projects and monorepos.\n */\n\nimport type { FsAdapter } from '../../ports/fs';\nimport type {\n  SetupOptions,\n  SetupResult,\n  SetupFileResult,\n  SetupTarget,\n  SetupPromptCallbacks,\n  SetupScope,\n} from './types';\nimport { ALL_SETUP_TARGETS, SETUP_TARGET_LABELS } from './types';\nimport {\n  setupCliConfig,\n  setupVscodeSettings,\n  setupMcpCursor,\n  setupMcpClaude,\n  setupCursorRules,\n  setupAgentsMd,\n} from './targets/index';\nimport {\n  findPackageRoot,\n  findWorkspaceRoot,\n  isMonorepo,\n  getPackageName,\n} from '../../adapters/workspace';\n\n/**\n * Default prompt callbacks that always accept defaults.\n */\nconst defaultPrompts: SetupPromptCallbacks = {\n  confirm: async () => true,\n  multiSelect: async (_msg, options) =>\n    options.filter((o) => o.selected !== false).map((o) => o.value),\n  input: async (_msg, defaultValue) => defaultValue ?? '',\n};\n\n/**\n * Run the ContractSpec setup.\n */\nexport async function runSetup(\n  fs: FsAdapter,\n  options: SetupOptions,\n  prompts: SetupPromptCallbacks = defaultPrompts\n): Promise<SetupResult> {\n  const results: SetupFileResult[] = [];\n  const targets =\n    options.targets.length > 0 ? options.targets : ALL_SETUP_TARGETS;\n\n  // Detect monorepo context if not already provided\n  const workspaceRoot = options.workspaceRoot;\n  const detectedWorkspaceRoot = findWorkspaceRoot(workspaceRoot);\n  const packageRoot = options.packageRoot ?? findPackageRoot(workspaceRoot);\n  const monorepo = options.isMonorepo ?? isMonorepo(detectedWorkspaceRoot);\n  const packageName =\n    options.packageName ?? (monorepo ? getPackageName(packageRoot) : undefined);\n\n  // Determine scope\n  let scope: SetupScope = options.scope ?? 'workspace';\n  const isDifferentRoots = packageRoot !== detectedWorkspaceRoot;\n\n  // If in a monorepo and interactive, prompt for scope\n  if (monorepo && options.interactive && isDifferentRoots) {\n    const scopeChoice = await prompts.multiSelect<SetupScope>(\n      `Monorepo detected. Configure at which level?`,\n      [\n        {\n          value: 'package',\n          label: `Package level (${packageName ?? packageRoot})`,\n          selected: true,\n        },\n        {\n          value: 'workspace',\n          label: `Workspace level (${detectedWorkspaceRoot})`,\n        },\n      ]\n    );\n    scope = scopeChoice[0] ?? 'package';\n  }\n\n  // If interactive, prompt for target selection\n  let selectedTargets = targets;\n  if (options.interactive) {\n    selectedTargets = await prompts.multiSelect(\n      'Select components to configure:',\n      ALL_SETUP_TARGETS.map((t) => ({\n        value: t,\n        label: SETUP_TARGET_LABELS[t],\n        selected: targets.includes(t),\n      }))\n    );\n  }\n\n  // Get project name if interactive\n  let projectName = options.projectName;\n  if (options.interactive && !projectName) {\n    const defaultName =\n      scope === 'package' && packageName\n        ? packageName\n        : (workspaceRoot.split('/').pop() ?? 'my-project');\n    projectName = await prompts.input('Project name:', defaultName);\n  }\n\n  const setupOptions: SetupOptions = {\n    ...options,\n    workspaceRoot: detectedWorkspaceRoot,\n    packageRoot,\n    isMonorepo: monorepo,\n    scope,\n    packageName,\n    projectName,\n    targets: selectedTargets,\n  };\n\n  // Run each target setup\n  for (const target of selectedTargets) {\n    const result = await setupTarget(fs, target, setupOptions, prompts);\n    results.push(result);\n  }\n\n  const succeeded = results.filter((r) => r.action !== 'error').length;\n  const failed = results.filter((r) => r.action === 'error').length;\n\n  const scopeInfo = monorepo ? ` (${scope} level)` : '';\n  return {\n    success: failed === 0,\n    files: results,\n    summary: `Setup complete${scopeInfo}: ${succeeded} configured, ${failed} failed.`,\n  };\n}\n\n/**\n * Setup a single target.\n */\nasync function setupTarget(\n  fs: FsAdapter,\n  target: SetupTarget,\n  options: SetupOptions,\n  prompts: SetupPromptCallbacks\n): Promise<SetupFileResult> {\n  switch (target) {\n    case 'cli-config':\n      return setupCliConfig(fs, options, prompts);\n    case 'vscode-settings':\n      return setupVscodeSettings(fs, options, prompts);\n    case 'mcp-cursor':\n      return setupMcpCursor(fs, options, prompts);\n    case 'mcp-claude':\n      return setupMcpClaude(fs, options, prompts);\n    case 'cursor-rules':\n      return setupCursorRules(fs, options, prompts);\n    case 'agents-md':\n      return setupAgentsMd(fs, options, prompts);\n    default:\n      return {\n        target,\n        filePath: '',\n        action: 'error',\n        message: `Unknown target: ${target}`,\n      };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAmCA,MAAMA,iBAAuC;CAC3C,SAAS,YAAY;CACrB,aAAa,OAAO,MAAM,YACxB,QAAQ,QAAQ,MAAM,EAAE,aAAa,MAAM,CAAC,KAAK,MAAM,EAAE,MAAM;CACjE,OAAO,OAAO,MAAM,iBAAiB,gBAAgB;CACtD;;;;AAKD,eAAsB,SACpB,IACA,SACA,UAAgC,gBACV;CACtB,MAAMC,UAA6B,EAAE;CACrC,MAAM,UACJ,QAAQ,QAAQ,SAAS,IAAI,QAAQ,UAAU;CAGjD,MAAM,gBAAgB,QAAQ;CAC9B,MAAM,wBAAwB,kBAAkB,cAAc;CAC9D,MAAM,cAAc,QAAQ,eAAe,gBAAgB,cAAc;CACzE,MAAM,WAAW,QAAQ,cAAc,WAAW,sBAAsB;CACxE,MAAM,cACJ,QAAQ,gBAAgB,WAAW,eAAe,YAAY,GAAG;CAGnE,IAAIC,QAAoB,QAAQ,SAAS;CACzC,MAAM,mBAAmB,gBAAgB;AAGzC,KAAI,YAAY,QAAQ,eAAe,iBAerC,UAdoB,MAAM,QAAQ,YAChC,gDACA,CACE;EACE,OAAO;EACP,OAAO,kBAAkB,eAAe,YAAY;EACpD,UAAU;EACX,EACD;EACE,OAAO;EACP,OAAO,oBAAoB,sBAAsB;EAClD,CACF,CACF,EACmB,MAAM;CAI5B,IAAI,kBAAkB;AACtB,KAAI,QAAQ,YACV,mBAAkB,MAAM,QAAQ,YAC9B,mCACA,kBAAkB,KAAK,OAAO;EAC5B,OAAO;EACP,OAAO,oBAAoB;EAC3B,UAAU,QAAQ,SAAS,EAAE;EAC9B,EAAE,CACJ;CAIH,IAAI,cAAc,QAAQ;AAC1B,KAAI,QAAQ,eAAe,CAAC,aAAa;EACvC,MAAM,cACJ,UAAU,aAAa,cACnB,cACC,cAAc,MAAM,IAAI,CAAC,KAAK,IAAI;AACzC,gBAAc,MAAM,QAAQ,MAAM,iBAAiB,YAAY;;CAGjE,MAAMC,eAA6B;EACjC,GAAG;EACH,eAAe;EACf;EACA,YAAY;EACZ;EACA;EACA;EACA,SAAS;EACV;AAGD,MAAK,MAAM,UAAU,iBAAiB;EACpC,MAAM,SAAS,MAAM,YAAY,IAAI,QAAQ,cAAc,QAAQ;AACnE,UAAQ,KAAK,OAAO;;CAGtB,MAAM,YAAY,QAAQ,QAAQ,MAAM,EAAE,WAAW,QAAQ,CAAC;CAC9D,MAAM,SAAS,QAAQ,QAAQ,MAAM,EAAE,WAAW,QAAQ,CAAC;CAE3D,MAAM,YAAY,WAAW,KAAK,MAAM,WAAW;AACnD,QAAO;EACL,SAAS,WAAW;EACpB,OAAO;EACP,SAAS,iBAAiB,UAAU,IAAI,UAAU,eAAe,OAAO;EACzE;;;;;AAMH,eAAe,YACb,IACA,QACA,SACA,SAC0B;AAC1B,SAAQ,QAAR;EACE,KAAK,aACH,QAAO,eAAe,IAAI,SAAS,QAAQ;EAC7C,KAAK,kBACH,QAAO,oBAAoB,IAAI,SAAS,QAAQ;EAClD,KAAK,aACH,QAAO,eAAe,IAAI,SAAS,QAAQ;EAC7C,KAAK,aACH,QAAO,eAAe,IAAI,SAAS,QAAQ;EAC7C,KAAK,eACH,QAAO,iBAAiB,IAAI,SAAS,QAAQ;EAC/C,KAAK,YACH,QAAO,cAAc,IAAI,SAAS,QAAQ;EAC5C,QACE,QAAO;GACL;GACA,UAAU;GACV,QAAQ;GACR,SAAS,mBAAmB;GAC7B"}

package/dist/services/setup/targets/agents-md.js

@@ -0,0 +1,47 @@
+import { generateAgentsMd } from "../config-generators.js";
+
+//#region src/services/setup/targets/agents-md.ts
+/**
+* Setup AGENTS.md
+*
+* In monorepo with package scope, creates AGENTS.md at package root.
+*/
+async function setupAgentsMd(fs, options, prompts) {
+	const targetRoot = options.isMonorepo && options.scope === "package" ? options.packageRoot ?? options.workspaceRoot : options.workspaceRoot;
+	const filePath = fs.join(targetRoot, "AGENTS.md");
+	try {
+		const exists = await fs.exists(filePath);
+		const content = generateAgentsMd(options);
+		if (exists) if (options.interactive) {
+			if (!await prompts.confirm(`${filePath} exists. Overwrite?`)) return {
+				target: "agents-md",
+				filePath,
+				action: "skipped",
+				message: "User kept existing AGENTS.md"
+			};
+		} else return {
+			target: "agents-md",
+			filePath,
+			action: "skipped",
+			message: "File already exists"
+		};
+		await fs.writeFile(filePath, content);
+		return {
+			target: "agents-md",
+			filePath,
+			action: exists ? "merged" : "created",
+			message: exists ? "Updated AGENTS.md" : "Created AGENTS.md"
+		};
+	} catch (error) {
+		return {
+			target: "agents-md",
+			filePath,
+			action: "error",
+			message: error instanceof Error ? error.message : "Unknown error"
+		};
+	}
+}
+
+//#endregion
+export { setupAgentsMd };
+//# sourceMappingURL=agents-md.js.map

package/dist/services/setup/targets/agents-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.js","names":[],"sources":["../../../../src/services/setup/targets/agents-md.ts"],"sourcesContent":["/**\n * AGENTS.md setup target.\n */\n\nimport type { FsAdapter } from '../../../ports/fs';\nimport type {\n  SetupOptions,\n  SetupFileResult,\n  SetupPromptCallbacks,\n} from '../types';\nimport { generateAgentsMd } from '../config-generators';\n\n/**\n * Setup AGENTS.md\n *\n * In monorepo with package scope, creates AGENTS.md at package root.\n */\nexport async function setupAgentsMd(\n  fs: FsAdapter,\n  options: SetupOptions,\n  prompts: SetupPromptCallbacks\n): Promise<SetupFileResult> {\n  // Determine target root based on scope\n  const targetRoot =\n    options.isMonorepo && options.scope === 'package'\n      ? (options.packageRoot ?? options.workspaceRoot)\n      : options.workspaceRoot;\n\n  const filePath = fs.join(targetRoot, 'AGENTS.md');\n\n  try {\n    const exists = await fs.exists(filePath);\n    const content = generateAgentsMd(options);\n\n    if (exists) {\n      if (options.interactive) {\n        const proceed = await prompts.confirm(`${filePath} exists. Overwrite?`);\n        if (!proceed) {\n          return {\n            target: 'agents-md',\n            filePath,\n            action: 'skipped',\n            message: 'User kept existing AGENTS.md',\n          };\n        }\n      } else {\n        // Non-interactive: skip existing file\n        return {\n          target: 'agents-md',\n          filePath,\n          action: 'skipped',\n          message: 'File already exists',\n        };\n      }\n    }\n\n    await fs.writeFile(filePath, content);\n    return {\n      target: 'agents-md',\n      filePath,\n      action: exists ? 'merged' : 'created',\n      message: exists ? 'Updated AGENTS.md' : 'Created AGENTS.md',\n    };\n  } catch (error) {\n    return {\n      target: 'agents-md',\n      filePath,\n      action: 'error',\n      message: error instanceof Error ? error.message : 'Unknown error',\n    };\n  }\n}\n"],"mappings":";;;;;;;;AAiBA,eAAsB,cACpB,IACA,SACA,SAC0B;CAE1B,MAAM,aACJ,QAAQ,cAAc,QAAQ,UAAU,YACnC,QAAQ,eAAe,QAAQ,gBAChC,QAAQ;CAEd,MAAM,WAAW,GAAG,KAAK,YAAY,YAAY;AAEjD,KAAI;EACF,MAAM,SAAS,MAAM,GAAG,OAAO,SAAS;EACxC,MAAM,UAAU,iBAAiB,QAAQ;AAEzC,MAAI,OACF,KAAI,QAAQ,aAEV;OAAI,CADY,MAAM,QAAQ,QAAQ,GAAG,SAAS,qBAAqB,CAErE,QAAO;IACL,QAAQ;IACR;IACA,QAAQ;IACR,SAAS;IACV;QAIH,QAAO;GACL,QAAQ;GACR;GACA,QAAQ;GACR,SAAS;GACV;AAIL,QAAM,GAAG,UAAU,UAAU,QAAQ;AACrC,SAAO;GACL,QAAQ;GACR;GACA,QAAQ,SAAS,WAAW;GAC5B,SAAS,SAAS,sBAAsB;GACzC;UACM,OAAO;AACd,SAAO;GACL,QAAQ;GACR;GACA,QAAQ;GACR,SAAS,iBAAiB,QAAQ,MAAM,UAAU;GACnD"}

package/dist/services/setup/targets/cli-config.js

@@ -0,0 +1,60 @@
+import { generateContractsrcConfig } from "../config-generators.js";
+import { deepMergePreserve, formatJson, safeParseJson } from "../file-merger.js";
+
+//#region src/services/setup/targets/cli-config.ts
+/**
+* Setup .contractsrc.json
+*
+* In monorepo with package scope, creates config at package root.
+*/
+async function setupCliConfig(fs, options, prompts) {
+	const targetRoot = options.isMonorepo && options.scope === "package" ? options.packageRoot ?? options.workspaceRoot : options.workspaceRoot;
+	const filePath = fs.join(targetRoot, ".contractsrc.json");
+	try {
+		const exists = await fs.exists(filePath);
+		const defaults = generateContractsrcConfig(options);
+		if (exists) {
+			const existing = safeParseJson(await fs.readFile(filePath));
+			if (!existing) return {
+				target: "cli-config",
+				filePath,
+				action: "error",
+				message: "Existing file is not valid JSON"
+			};
+			if (options.interactive) {
+				if (!await prompts.confirm(`${filePath} exists. Merge ContractSpec defaults?`)) return {
+					target: "cli-config",
+					filePath,
+					action: "skipped",
+					message: "User skipped merge"
+				};
+			}
+			const merged = deepMergePreserve(existing, defaults);
+			await fs.writeFile(filePath, formatJson(merged));
+			return {
+				target: "cli-config",
+				filePath,
+				action: "merged",
+				message: "Merged with existing configuration"
+			};
+		}
+		await fs.writeFile(filePath, formatJson(defaults));
+		return {
+			target: "cli-config",
+			filePath,
+			action: "created",
+			message: "Created CLI configuration"
+		};
+	} catch (error) {
+		return {
+			target: "cli-config",
+			filePath,
+			action: "error",
+			message: error instanceof Error ? error.message : "Unknown error"
+		};
+	}
+}
+
+//#endregion
+export { setupCliConfig };
+//# sourceMappingURL=cli-config.js.map

package/dist/services/setup/targets/cli-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-config.js","names":[],"sources":["../../../../src/services/setup/targets/cli-config.ts"],"sourcesContent":["/**\n * CLI config setup target.\n */\n\nimport type { FsAdapter } from '../../../ports/fs';\nimport type {\n  SetupOptions,\n  SetupFileResult,\n  SetupPromptCallbacks,\n} from '../types';\nimport { generateContractsrcConfig } from '../config-generators';\nimport { deepMergePreserve, safeParseJson, formatJson } from '../file-merger';\n\n/**\n * Setup .contractsrc.json\n *\n * In monorepo with package scope, creates config at package root.\n */\nexport async function setupCliConfig(\n  fs: FsAdapter,\n  options: SetupOptions,\n  prompts: SetupPromptCallbacks\n): Promise<SetupFileResult> {\n  // Determine target root based on scope\n  const targetRoot =\n    options.isMonorepo && options.scope === 'package'\n      ? (options.packageRoot ?? options.workspaceRoot)\n      : options.workspaceRoot;\n\n  const filePath = fs.join(targetRoot, '.contractsrc.json');\n\n  try {\n    const exists = await fs.exists(filePath);\n    const defaults = generateContractsrcConfig(options);\n\n    if (exists) {\n      const content = await fs.readFile(filePath);\n      const existing = safeParseJson<Record<string, unknown>>(content);\n\n      if (!existing) {\n        return {\n          target: 'cli-config',\n          filePath,\n          action: 'error',\n          message: 'Existing file is not valid JSON',\n        };\n      }\n\n      if (options.interactive) {\n        const proceed = await prompts.confirm(\n          `${filePath} exists. Merge ContractSpec defaults?`\n        );\n        if (!proceed) {\n          return {\n            target: 'cli-config',\n            filePath,\n            action: 'skipped',\n            message: 'User skipped merge',\n          };\n        }\n      }\n\n      const merged = deepMergePreserve(\n        existing,\n        defaults as Record<string, unknown>\n      );\n      await fs.writeFile(filePath, formatJson(merged));\n\n      return {\n        target: 'cli-config',\n        filePath,\n        action: 'merged',\n        message: 'Merged with existing configuration',\n      };\n    }\n\n    await fs.writeFile(filePath, formatJson(defaults));\n    return {\n      target: 'cli-config',\n      filePath,\n      action: 'created',\n      message: 'Created CLI configuration',\n    };\n  } catch (error) {\n    return {\n      target: 'cli-config',\n      filePath,\n      action: 'error',\n      message: error instanceof Error ? error.message : 'Unknown error',\n    };\n  }\n}\n"],"mappings":";;;;;;;;;AAkBA,eAAsB,eACpB,IACA,SACA,SAC0B;CAE1B,MAAM,aACJ,QAAQ,cAAc,QAAQ,UAAU,YACnC,QAAQ,eAAe,QAAQ,gBAChC,QAAQ;CAEd,MAAM,WAAW,GAAG,KAAK,YAAY,oBAAoB;AAEzD,KAAI;EACF,MAAM,SAAS,MAAM,GAAG,OAAO,SAAS;EACxC,MAAM,WAAW,0BAA0B,QAAQ;AAEnD,MAAI,QAAQ;GAEV,MAAM,WAAW,cADD,MAAM,GAAG,SAAS,SAAS,CACqB;AAEhE,OAAI,CAAC,SACH,QAAO;IACL,QAAQ;IACR;IACA,QAAQ;IACR,SAAS;IACV;AAGH,OAAI,QAAQ,aAIV;QAAI,CAHY,MAAM,QAAQ,QAC5B,GAAG,SAAS,uCACb,CAEC,QAAO;KACL,QAAQ;KACR;KACA,QAAQ;KACR,SAAS;KACV;;GAIL,MAAM,SAAS,kBACb,UACA,SACD;AACD,SAAM,GAAG,UAAU,UAAU,WAAW,OAAO,CAAC;AAEhD,UAAO;IACL,QAAQ;IACR;IACA,QAAQ;IACR,SAAS;IACV;;AAGH,QAAM,GAAG,UAAU,UAAU,WAAW,SAAS,CAAC;AAClD,SAAO;GACL,QAAQ;GACR;GACA,QAAQ;GACR,SAAS;GACV;UACM,OAAO;AACd,SAAO;GACL,QAAQ;GACR;GACA,QAAQ;GACR,SAAS,iBAAiB,QAAQ,MAAM,UAAU;GACnD"}