@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217073102

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

@@ -1,2 +1,60 @@
-function e(t,r){let i={...t};for(let a of Object.keys(r)){let o=t[a],s=r[a];o===void 0?i[a]=s:n(o)&&n(s)&&(i[a]=e(o,s))}return i}function t(e,r){let i={...e};for(let a of Object.keys(r)){let o=e[a],s=r[a];s!==void 0&&(n(o)&&n(s)?i[a]=t(o,s):i[a]=s)}return i}function n(e){return typeof e==`object`&&!!e&&!Array.isArray(e)&&Object.getPrototypeOf(e)===Object.prototype}function r(e){try{return JSON.parse(e)}catch{return null}}function i(e){return JSON.stringify(e,null,2)+`
-`}export{t as deepMergeOverwrite,e as deepMergePreserve,i as formatJson,r as safeParseJson};
+//#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 };

package/dist/services/setup/index.js

@@ -1 +1,4 @@
-import{ALL_SETUP_TARGETS as e,SETUP_TARGET_LABELS as t}from"./types.js";import{generateAgentsMd as n,generateClaudeMcpConfig as r,generateContractsrcConfig as i,generateCursorMcpConfig as a,generateCursorRules as o,generateVscodeSettings as s,getClaudeDesktopConfigPath as c}from"./config-generators.js";import{deepMergeOverwrite as l,deepMergePreserve as u,formatJson as d,safeParseJson as f}from"./file-merger.js";import{runSetup as p}from"./setup-service.js";
+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.js

@@ -1 +1,95 @@
-import{findPackageRoot as e,findWorkspaceRoot as t,getPackageName as n,isMonorepo as r}from"../../adapters/workspace.js";import{ALL_SETUP_TARGETS as i,SETUP_TARGET_LABELS as a}from"./types.js";import{setupCliConfig as o}from"./targets/cli-config.js";import{setupVscodeSettings as s}from"./targets/vscode-settings.js";import{setupMcpCursor as c}from"./targets/mcp-cursor.js";import{setupMcpClaude as l}from"./targets/mcp-claude.js";import{setupCursorRules as u}from"./targets/cursor-rules.js";import{setupAgentsMd as d}from"./targets/agents-md.js";const f={confirm:async()=>!0,multiSelect:async(e,t)=>t.filter(e=>e.selected!==!1).map(e=>e.value),input:async(e,t)=>t??``};async function p(o,s,c=f){let l=[],u=s.targets.length>0?s.targets:i,d=s.workspaceRoot,p=t(d),h=s.packageRoot??e(d),g=s.isMonorepo??r(p),_=s.packageName??(g?n(h):void 0),v=s.scope??`workspace`,y=h!==p;g&&s.interactive&&y&&(v=(await c.multiSelect(`Monorepo detected. Configure at which level?`,[{value:`package`,label:`Package level (${_??h})`,selected:!0},{value:`workspace`,label:`Workspace level (${p})`}]))[0]??`package`);let b=u;s.interactive&&(b=await c.multiSelect(`Select components to configure:`,i.map(e=>({value:e,label:a[e],selected:u.includes(e)}))));let x=s.projectName;if(s.interactive&&!x){let e=v===`package`&&_?_:d.split(`/`).pop()??`my-project`;x=await c.input(`Project name:`,e)}let S={...s,workspaceRoot:p,packageRoot:h,isMonorepo:g,scope:v,packageName:_,projectName:x,targets:b};for(let e of b){let t=await m(o,e,S,c);l.push(t)}let C=l.filter(e=>e.action!==`error`).length,w=l.filter(e=>e.action===`error`).length,T=g?` (${v} level)`:``;return{success:w===0,files:l,summary:`Setup complete${T}: ${C} configured, ${w} failed.`}}async function m(e,t,n,r){switch(t){case`cli-config`:return o(e,n,r);case`vscode-settings`:return s(e,n,r);case`mcp-cursor`:return c(e,n,r);case`mcp-claude`:return l(e,n,r);case`cursor-rules`:return u(e,n,r);case`agents-md`:return d(e,n,r);default:return{target:t,filePath:``,action:`error`,message:`Unknown target: ${t}`}}}export{p as runSetup};
+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 };

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

@@ -1 +1,46 @@
-import{generateAgentsMd as e}from"../config-generators.js";async function t(t,n,r){let i=n.isMonorepo&&n.scope===`package`?n.packageRoot??n.workspaceRoot:n.workspaceRoot,a=t.join(i,`AGENTS.md`);try{let i=await t.exists(a),o=e(n);if(i)if(n.interactive){if(!await r.confirm(`${a} exists. Overwrite?`))return{target:`agents-md`,filePath:a,action:`skipped`,message:`User kept existing AGENTS.md`}}else return{target:`agents-md`,filePath:a,action:`skipped`,message:`File already exists`};return await t.writeFile(a,o),{target:`agents-md`,filePath:a,action:i?`merged`:`created`,message:i?`Updated AGENTS.md`:`Created AGENTS.md`}}catch(e){return{target:`agents-md`,filePath:a,action:`error`,message:e instanceof Error?e.message:`Unknown error`}}}export{t as setupAgentsMd};
+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 };

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

@@ -1 +1,59 @@
-import{generateContractsrcConfig as e}from"../config-generators.js";import{deepMergePreserve as t,formatJson as n,safeParseJson as r}from"../file-merger.js";async function i(i,a,o){let s=a.isMonorepo&&a.scope===`package`?a.packageRoot??a.workspaceRoot:a.workspaceRoot,c=i.join(s,`.contractsrc.json`);try{let s=await i.exists(c),l=e(a);if(s){let e=r(await i.readFile(c));if(!e)return{target:`cli-config`,filePath:c,action:`error`,message:`Existing file is not valid JSON`};if(a.interactive&&!await o.confirm(`${c} exists. Merge ContractSpec defaults?`))return{target:`cli-config`,filePath:c,action:`skipped`,message:`User skipped merge`};let s=t(e,l);return await i.writeFile(c,n(s)),{target:`cli-config`,filePath:c,action:`merged`,message:`Merged with existing configuration`}}return await i.writeFile(c,n(l)),{target:`cli-config`,filePath:c,action:`created`,message:`Created CLI configuration`}}catch(e){return{target:`cli-config`,filePath:c,action:`error`,message:e instanceof Error?e.message:`Unknown error`}}}export{i as setupCliConfig};
+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 };

package/dist/services/setup/targets/cursor-rules.js

@@ -1 +1,47 @@
-import{generateCursorRules as e}from"../config-generators.js";async function t(t,n,r){let i=t.join(n.workspaceRoot,`.cursor`,`rules`),a=t.join(i,`contractspec.mdc`);try{let o=t.join(n.workspaceRoot,`.cursor`);await t.exists(o)||await t.mkdir(o),await t.exists(i)||await t.mkdir(i);let s=await t.exists(a),c=e(n);if(s)if(n.interactive){if(!await r.confirm(`${a} exists. Overwrite with latest rules?`))return{target:`cursor-rules`,filePath:a,action:`skipped`,message:`User kept existing rules`}}else return{target:`cursor-rules`,filePath:a,action:`skipped`,message:`File already exists`};return await t.writeFile(a,c),{target:`cursor-rules`,filePath:a,action:s?`merged`:`created`,message:s?`Updated Cursor rules`:`Created Cursor rules`}}catch(e){return{target:`cursor-rules`,filePath:a,action:`error`,message:e instanceof Error?e.message:`Unknown error`}}}export{t as setupCursorRules};
+import { generateCursorRules } from "../config-generators.js";
+
+//#region src/services/setup/targets/cursor-rules.ts
+/**
+* Setup .cursor/rules/contractspec.mdc
+*/
+async function setupCursorRules(fs, options, prompts) {
+	const rulesDir = fs.join(options.workspaceRoot, ".cursor", "rules");
+	const filePath = fs.join(rulesDir, "contractspec.mdc");
+	try {
+		const cursorDir = fs.join(options.workspaceRoot, ".cursor");
+		if (!await fs.exists(cursorDir)) await fs.mkdir(cursorDir);
+		if (!await fs.exists(rulesDir)) await fs.mkdir(rulesDir);
+		const exists = await fs.exists(filePath);
+		const content = generateCursorRules(options);
+		if (exists) if (options.interactive) {
+			if (!await prompts.confirm(`${filePath} exists. Overwrite with latest rules?`)) return {
+				target: "cursor-rules",
+				filePath,
+				action: "skipped",
+				message: "User kept existing rules"
+			};
+		} else return {
+			target: "cursor-rules",
+			filePath,
+			action: "skipped",
+			message: "File already exists"
+		};
+		await fs.writeFile(filePath, content);
+		return {
+			target: "cursor-rules",
+			filePath,
+			action: exists ? "merged" : "created",
+			message: exists ? "Updated Cursor rules" : "Created Cursor rules"
+		};
+	} catch (error) {
+		return {
+			target: "cursor-rules",
+			filePath,
+			action: "error",
+			message: error instanceof Error ? error.message : "Unknown error"
+		};
+	}
+}
+
+//#endregion
+export { setupCursorRules };

package/dist/services/setup/targets/mcp-claude.js

@@ -1 +1,59 @@
-import{generateClaudeMcpConfig as e,getClaudeDesktopConfigPath as t}from"../config-generators.js";import{deepMergePreserve as n,formatJson as r,safeParseJson as i}from"../file-merger.js";async function a(a,o,s){let c=t();try{let t=await a.exists(c),l=e();if(o.interactive&&!await s.confirm(`Configure Claude Desktop at ${c}?`))return{target:`mcp-claude`,filePath:c,action:`skipped`,message:`User skipped Claude Desktop configuration`};if(t){let e=i(await a.readFile(c));if(!e)return{target:`mcp-claude`,filePath:c,action:`error`,message:`Existing file is not valid JSON`};let t=n(e,l);return await a.writeFile(c,r(t)),{target:`mcp-claude`,filePath:c,action:`merged`,message:`Added ContractSpec to Claude Desktop`}}let u=c.substring(0,c.lastIndexOf(`/`));return await a.exists(u)||await a.mkdir(u),await a.writeFile(c,r(l)),{target:`mcp-claude`,filePath:c,action:`created`,message:`Created Claude Desktop configuration`}}catch(e){return{target:`mcp-claude`,filePath:c,action:`error`,message:e instanceof Error?e.message:`Unknown error`}}}export{a as setupMcpClaude};
+import { generateClaudeMcpConfig, getClaudeDesktopConfigPath } from "../config-generators.js";
+import { deepMergePreserve, formatJson, safeParseJson } from "../file-merger.js";
+
+//#region src/services/setup/targets/mcp-claude.ts
+/**
+* Setup Claude Desktop MCP config.
+* This modifies the user's global Claude config, so we're extra careful.
+*/
+async function setupMcpClaude(fs, options, prompts) {
+	const filePath = getClaudeDesktopConfigPath();
+	try {
+		const exists = await fs.exists(filePath);
+		const defaults = generateClaudeMcpConfig();
+		if (options.interactive) {
+			if (!await prompts.confirm(`Configure Claude Desktop at ${filePath}?`)) return {
+				target: "mcp-claude",
+				filePath,
+				action: "skipped",
+				message: "User skipped Claude Desktop configuration"
+			};
+		}
+		if (exists) {
+			const existing = safeParseJson(await fs.readFile(filePath));
+			if (!existing) return {
+				target: "mcp-claude",
+				filePath,
+				action: "error",
+				message: "Existing file is not valid JSON"
+			};
+			const merged = deepMergePreserve(existing, defaults);
+			await fs.writeFile(filePath, formatJson(merged));
+			return {
+				target: "mcp-claude",
+				filePath,
+				action: "merged",
+				message: "Added ContractSpec to Claude Desktop"
+			};
+		}
+		const parentDir = filePath.substring(0, filePath.lastIndexOf("/"));
+		if (!await fs.exists(parentDir)) await fs.mkdir(parentDir);
+		await fs.writeFile(filePath, formatJson(defaults));
+		return {
+			target: "mcp-claude",
+			filePath,
+			action: "created",
+			message: "Created Claude Desktop configuration"
+		};
+	} catch (error) {
+		return {
+			target: "mcp-claude",
+			filePath,
+			action: "error",
+			message: error instanceof Error ? error.message : "Unknown error"
+		};
+	}
+}
+
+//#endregion
+export { setupMcpClaude };

package/dist/services/setup/targets/mcp-cursor.js

@@ -1 +1,58 @@
-import{generateCursorMcpConfig as e}from"../config-generators.js";import{deepMergePreserve as t,formatJson as n,safeParseJson as r}from"../file-merger.js";async function i(i,a,o){let s=i.join(a.workspaceRoot,`.cursor`),c=i.join(s,`mcp.json`);try{await i.exists(s)||await i.mkdir(s);let l=await i.exists(c),u=e();if(l){let e=r(await i.readFile(c));if(!e)return{target:`mcp-cursor`,filePath:c,action:`error`,message:`Existing file is not valid JSON`};if(a.interactive&&!await o.confirm(`${c} exists. Add ContractSpec MCP server?`))return{target:`mcp-cursor`,filePath:c,action:`skipped`,message:`User skipped merge`};let s=t(e,u);return await i.writeFile(c,n(s)),{target:`mcp-cursor`,filePath:c,action:`merged`,message:`Added ContractSpec MCP server`}}return await i.writeFile(c,n(u)),{target:`mcp-cursor`,filePath:c,action:`created`,message:`Created Cursor MCP configuration`}}catch(e){return{target:`mcp-cursor`,filePath:c,action:`error`,message:e instanceof Error?e.message:`Unknown error`}}}export{i as setupMcpCursor};
+import { generateCursorMcpConfig } from "../config-generators.js";
+import { deepMergePreserve, formatJson, safeParseJson } from "../file-merger.js";
+
+//#region src/services/setup/targets/mcp-cursor.ts
+/**
+* Setup .cursor/mcp.json
+*/
+async function setupMcpCursor(fs, options, prompts) {
+	const dirPath = fs.join(options.workspaceRoot, ".cursor");
+	const filePath = fs.join(dirPath, "mcp.json");
+	try {
+		if (!await fs.exists(dirPath)) await fs.mkdir(dirPath);
+		const exists = await fs.exists(filePath);
+		const defaults = generateCursorMcpConfig();
+		if (exists) {
+			const existing = safeParseJson(await fs.readFile(filePath));
+			if (!existing) return {
+				target: "mcp-cursor",
+				filePath,
+				action: "error",
+				message: "Existing file is not valid JSON"
+			};
+			if (options.interactive) {
+				if (!await prompts.confirm(`${filePath} exists. Add ContractSpec MCP server?`)) return {
+					target: "mcp-cursor",
+					filePath,
+					action: "skipped",
+					message: "User skipped merge"
+				};
+			}
+			const merged = deepMergePreserve(existing, defaults);
+			await fs.writeFile(filePath, formatJson(merged));
+			return {
+				target: "mcp-cursor",
+				filePath,
+				action: "merged",
+				message: "Added ContractSpec MCP server"
+			};
+		}
+		await fs.writeFile(filePath, formatJson(defaults));
+		return {
+			target: "mcp-cursor",
+			filePath,
+			action: "created",
+			message: "Created Cursor MCP configuration"
+		};
+	} catch (error) {
+		return {
+			target: "mcp-cursor",
+			filePath,
+			action: "error",
+			message: error instanceof Error ? error.message : "Unknown error"
+		};
+	}
+}
+
+//#endregion
+export { setupMcpCursor };

package/dist/services/setup/targets/vscode-settings.js

@@ -1 +1,62 @@
-import{generateVscodeSettings as e}from"../config-generators.js";import{deepMergePreserve as t,formatJson as n,safeParseJson as r}from"../file-merger.js";async function i(i,a,o){let s=a.isMonorepo&&a.scope===`package`?a.packageRoot??a.workspaceRoot:a.workspaceRoot,c=i.join(s,`.vscode`),l=i.join(c,`settings.json`);try{await i.exists(c)||await i.mkdir(c);let s=await i.exists(l),u=e();if(s){let e=r(await i.readFile(l));if(!e)return{target:`vscode-settings`,filePath:l,action:`error`,message:`Existing file is not valid JSON`};if(a.interactive&&!await o.confirm(`${l} exists. Add ContractSpec settings?`))return{target:`vscode-settings`,filePath:l,action:`skipped`,message:`User skipped merge`};let s=t(e,u);return await i.writeFile(l,n(s)),{target:`vscode-settings`,filePath:l,action:`merged`,message:`Added ContractSpec settings`}}return await i.writeFile(l,n(u)),{target:`vscode-settings`,filePath:l,action:`created`,message:`Created VS Code settings`}}catch(e){return{target:`vscode-settings`,filePath:l,action:`error`,message:e instanceof Error?e.message:`Unknown error`}}}export{i as setupVscodeSettings};
+import { generateVscodeSettings } from "../config-generators.js";
+import { deepMergePreserve, formatJson, safeParseJson } from "../file-merger.js";
+
+//#region src/services/setup/targets/vscode-settings.ts
+/**
+* Setup .vscode/settings.json
+*
+* VS Code settings are typically at workspace root, but in monorepo
+* with package scope, can be at package root.
+*/
+async function setupVscodeSettings(fs, options, prompts) {
+	const targetRoot = options.isMonorepo && options.scope === "package" ? options.packageRoot ?? options.workspaceRoot : options.workspaceRoot;
+	const dirPath = fs.join(targetRoot, ".vscode");
+	const filePath = fs.join(dirPath, "settings.json");
+	try {
+		if (!await fs.exists(dirPath)) await fs.mkdir(dirPath);
+		const exists = await fs.exists(filePath);
+		const defaults = generateVscodeSettings();
+		if (exists) {
+			const existing = safeParseJson(await fs.readFile(filePath));
+			if (!existing) return {
+				target: "vscode-settings",
+				filePath,
+				action: "error",
+				message: "Existing file is not valid JSON"
+			};
+			if (options.interactive) {
+				if (!await prompts.confirm(`${filePath} exists. Add ContractSpec settings?`)) return {
+					target: "vscode-settings",
+					filePath,
+					action: "skipped",
+					message: "User skipped merge"
+				};
+			}
+			const merged = deepMergePreserve(existing, defaults);
+			await fs.writeFile(filePath, formatJson(merged));
+			return {
+				target: "vscode-settings",
+				filePath,
+				action: "merged",
+				message: "Added ContractSpec settings"
+			};
+		}
+		await fs.writeFile(filePath, formatJson(defaults));
+		return {
+			target: "vscode-settings",
+			filePath,
+			action: "created",
+			message: "Created VS Code settings"
+		};
+	} catch (error) {
+		return {
+			target: "vscode-settings",
+			filePath,
+			action: "error",
+			message: error instanceof Error ? error.message : "Unknown error"
+		};
+	}
+}
+
+//#endregion
+export { setupVscodeSettings };

package/dist/services/setup/types.js

@@ -1 +1,26 @@
-const e=[`cli-config`,`vscode-settings`,`mcp-cursor`,`mcp-claude`,`cursor-rules`,`agents-md`],t={"cli-config":`CLI Configuration (.contractsrc.json)`,"vscode-settings":`VS Code Settings (.vscode/settings.json)`,"mcp-cursor":`MCP for Cursor (.cursor/mcp.json)`,"mcp-claude":`MCP for Claude Desktop`,"cursor-rules":`Cursor AI Rules (.cursor/rules/)`,"agents-md":`Project AI Guide (AGENTS.md)`};export{e as ALL_SETUP_TARGETS,t as SETUP_TARGET_LABELS};
+//#region src/services/setup/types.ts
+/**
+* All available setup targets.
+*/
+const ALL_SETUP_TARGETS = [
+	"cli-config",
+	"vscode-settings",
+	"mcp-cursor",
+	"mcp-claude",
+	"cursor-rules",
+	"agents-md"
+];
+/**
+* Human-readable labels for setup targets.
+*/
+const SETUP_TARGET_LABELS = {
+	"cli-config": "CLI Configuration (.contractsrc.json)",
+	"vscode-settings": "VS Code Settings (.vscode/settings.json)",
+	"mcp-cursor": "MCP for Cursor (.cursor/mcp.json)",
+	"mcp-claude": "MCP for Claude Desktop",
+	"cursor-rules": "Cursor AI Rules (.cursor/rules/)",
+	"agents-md": "Project AI Guide (AGENTS.md)"
+};
+
+//#endregion
+export { ALL_SETUP_TARGETS, SETUP_TARGET_LABELS };

package/dist/services/sync.js

@@ -1 +1,62 @@
-import{validateSpec as e}from"./validate.js";import{buildSpec as t}from"./build.js";async function n(n,r,i={},a){let{fs:o,logger:s}=n,c=await o.glob({pattern:i.pattern}),l=i.outputDirs?.length?i.outputDirs:[void 0],u=[],d=a?.validate??(t=>e(t,{fs:o,logger:s})),f=a?.build??((e,n)=>t(e,{fs:o,logger:s},n?{...r,outputDir:n}:r,{...i.buildOptions??{},outputDir:n}));for(let e of c)for(let t of l){let n={specPath:e,outputDir:t};if(i.validate)try{n.validation=await d(e)}catch(e){n.error={phase:`validate`,message:e instanceof Error?e.message:String(e)},u.push(n);continue}if(i.dryRun)s.info(`[dry-run] syncSpecs skipped build`,{specPath:e,outputDir:t});else try{n.build=await f(e,t)}catch(e){n.error={phase:`build`,message:e instanceof Error?e.message:String(e)},u.push(n);continue}u.push(n)}return{specs:c,runs:u}}export{n as syncSpecs};
+import { validateSpec } from "./validate.js";
+import { buildSpec } from "./build.js";
+
+//#region src/services/sync.ts
+async function syncSpecs(adapters, config, options = {}, overrides) {
+	const { fs, logger } = adapters;
+	const specs = await fs.glob({ pattern: options.pattern });
+	const outputDirs = options.outputDirs?.length ? options.outputDirs : [void 0];
+	const runs = [];
+	const validateFn = overrides?.validate ?? ((specPath) => validateSpec(specPath, {
+		fs,
+		logger
+	}));
+	const buildFn = overrides?.build ?? ((specPath, outputDir) => buildSpec(specPath, {
+		fs,
+		logger
+	}, outputDir ? {
+		...config,
+		outputDir
+	} : config, {
+		...options.buildOptions ?? {},
+		outputDir
+	}));
+	for (const specPath of specs) for (const outputDir of outputDirs) {
+		const run = {
+			specPath,
+			outputDir
+		};
+		if (options.validate) try {
+			run.validation = await validateFn(specPath);
+		} catch (error) {
+			run.error = {
+				phase: "validate",
+				message: error instanceof Error ? error.message : String(error)
+			};
+			runs.push(run);
+			continue;
+		}
+		if (!options.dryRun) try {
+			run.build = await buildFn(specPath, outputDir);
+		} catch (error) {
+			run.error = {
+				phase: "build",
+				message: error instanceof Error ? error.message : String(error)
+			};
+			runs.push(run);
+			continue;
+		}
+		else logger.info("[dry-run] syncSpecs skipped build", {
+			specPath,
+			outputDir
+		});
+		runs.push(run);
+	}
+	return {
+		specs,
+		runs
+	};
+}
+
+//#endregion
+export { syncSpecs };

package/dist/services/test.js

@@ -1 +1,30 @@
-import{t as e}from"../libs/contracts/dist/tests/runner.js";import"../libs/contracts/dist/tests/index.js";async function t(t,n){let r=new e({registry:n}),i=[],a=0,o=0;for(let e of t){let t=await r.run(e);i.push(t),a+=t.passed,o+=t.failed}return{results:i,passed:a,failed:o}}export{t as runTests};
+import { TestRunner } from "../libs/contracts/dist/tests/runner.js";
+import "../libs/contracts/dist/tests/index.js";
+
+//#region src/services/test.ts
+/**
+* Test service.
+*
+* Pure runner wrapper that executes TestSpec scenarios against a SpecRegistry.
+* Loading/compiling spec modules (TS/ESM) is intentionally left to the caller.
+*/
+async function runTests(specs, registry) {
+	const runner = new TestRunner({ registry });
+	const results = [];
+	let passed = 0;
+	let failed = 0;
+	for (const spec of specs) {
+		const result = await runner.run(spec);
+		results.push(result);
+		passed += result.passed;
+		failed += result.failed;
+	}
+	return {
+		results,
+		passed,
+		failed
+	};
+}
+
+//#endregion
+export { runTests };