@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217083314 → 0.0.0-canary-20251220002821

package/dist/services/regenerator.js

@@ -1,23 +0,0 @@
-import { RegeneratorService } from "../libs/contracts/dist/regenerator/service.js";
-import "../libs/contracts/dist/regenerator/index.js";
-
-//#region src/services/regenerator.ts
-/**
-* Regenerator service.
-*
-* Thin wrapper around `@lssm/lib.contracts/regenerator` for reuse across CLI/VSCode/web.
-* This service does not perform module loading; callers provide resolved contexts/rules/sink.
-*/
-function createRegeneratorService(options) {
-	return new RegeneratorService({
-		contexts: options.contexts,
-		adapters: options.adapters ?? {},
-		rules: options.rules,
-		sink: options.sink,
-		pollIntervalMs: options.pollIntervalMs,
-		batchDurationMs: options.batchDurationMs
-	});
-}
-
-//#endregion
-export { createRegeneratorService };

package/dist/services/registry.js

@@ -1,73 +0,0 @@
-//#region src/services/registry.ts
-/**
-* Registry client for interacting with ContractSpec registry.
-*/
-var RegistryClient = class {
-	registryUrl;
-	constructor(opts) {
-		this.registryUrl = opts.registryUrl.replace(/\/+$/, "");
-	}
-	/**
-	* Make GET request to registry.
-	*/
-	async getJson(path) {
-		const url = `${this.registryUrl}${path.startsWith("/") ? "" : "/"}${path}`;
-		let res;
-		try {
-			res = await fetch(url, {
-				method: "GET",
-				headers: { Accept: "application/json" }
-			});
-		} catch (error) {
-			throw new Error(`Registry request failed: ${url} (${error instanceof Error ? error.message : String(error)})`);
-		}
-		if (!res.ok) {
-			const text = await res.text().catch(() => "");
-			throw new Error(`Registry request failed: ${res.status} ${res.statusText} ${text}`);
-		}
-		return await res.json();
-	}
-};
-/**
-* Resolve registry URL from options or environment.
-*/
-function resolveRegistryUrl(cliRegistryUrl) {
-	return cliRegistryUrl || process.env.CONTRACTSPEC_REGISTRY_URL || "http://localhost:8090";
-}
-/**
-* Add spec to registry.
-*/
-async function addToRegistry(specPath, options, adapters) {
-	const { logger } = adapters;
-	const registryUrl = resolveRegistryUrl(options.registryUrl);
-	logger.info(`Adding spec to registry: ${specPath}`, { registryUrl });
-	await new RegistryClient({ registryUrl }).getJson(`/specs/add?path=${encodeURIComponent(specPath)}`);
-	logger.info("Spec added to registry successfully");
-}
-/**
-* List specs from registry.
-*/
-async function listFromRegistry(options, adapters) {
-	const { logger } = adapters;
-	const registryUrl = resolveRegistryUrl(options.registryUrl);
-	logger.info("Listing specs from registry", { registryUrl });
-	const client = new RegistryClient({ registryUrl });
-	const filter = options.filter ? `?filter=${encodeURIComponent(options.filter)}` : "";
-	const specs = await client.getJson(`/specs${filter}`);
-	logger.info(`Found ${specs.length} specs`);
-	return specs;
-}
-/**
-* Search registry for specs.
-*/
-async function searchRegistry(query, options, adapters) {
-	const { logger } = adapters;
-	const registryUrl = resolveRegistryUrl(options.registryUrl);
-	logger.info(`Searching registry: ${query}`, { registryUrl });
-	const results = await new RegistryClient({ registryUrl }).getJson(`/specs/search?q=${encodeURIComponent(query)}`);
-	logger.info(`Found ${results.length} results`);
-	return results;
-}
-
-//#endregion
-export { RegistryClient, addToRegistry, listFromRegistry, resolveRegistryUrl, searchRegistry };

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

@@ -1,237 +0,0 @@
-//#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://contractspec.dev/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 };

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

@@ -1,60 +0,0 @@
-//#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,4 +0,0 @@
-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,95 +0,0 @@
-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,46 +0,0 @@
-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,59 +0,0 @@
-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,47 +0,0 @@
-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 };