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

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

@@ -1,59 +0,0 @@
-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,58 +0,0 @@
-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,62 +0,0 @@
-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,26 +0,0 @@
-//#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,62 +0,0 @@
-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,30 +0,0 @@
-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 };

package/dist/services/validate-implementation.js

@@ -1,69 +0,0 @@
-import { scanSpecSource } from "../modules/contractspec-workspace/dist/analysis/spec-scan.js";
-
-//#region src/services/validate-implementation.ts
-/**
-* Implementation validation service (handlers + tests).
-*
-* Deterministic, static checks intended for reuse across CLI/VSCode/web tooling.
-* This does NOT execute spec modules.
-*/
-function toKebabCase(value) {
-	return value.replace(/\./g, "-").replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
-}
-function toPascalCase(value) {
-	return value.split(/[-_.]/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
-}
-async function validateImplementationFiles(specFile, adapters, config, options = {}) {
-	const { fs } = adapters;
-	const errors = [];
-	const warnings = [];
-	if (!await fs.exists(specFile)) return {
-		valid: false,
-		errors: [`Spec file not found: ${specFile}`],
-		warnings: [],
-		expected: {}
-	};
-	const scan = scanSpecSource(await fs.readFile(specFile), specFile);
-	const specName = scan.name ?? fs.basename(specFile).replace(/\.[jt]s$/, "");
-	const outRoot = options.outputDir ?? config.outputDir ?? "./src";
-	const kebab = toKebabCase(specName);
-	const expected = {};
-	if (scan.specType === "operation") {
-		expected.handlerPath = fs.join(outRoot, "handlers", `${kebab}.handler.ts`);
-		expected.handlerTestPath = fs.join(outRoot, "handlers", `${kebab}.handler.test.ts`);
-	}
-	if (scan.specType === "presentation") {
-		expected.componentPath = fs.join(outRoot, "components", `${kebab}.tsx`);
-		expected.componentTestPath = fs.join(outRoot, "components", `${kebab}.test.tsx`);
-	}
-	if (scan.specType === "form") {
-		expected.formPath = fs.join(outRoot, "forms", `${kebab}.form.tsx`);
-		expected.formTestPath = fs.join(outRoot, "forms", `${kebab}.form.test.tsx`);
-	}
-	if (options.checkHandlers && expected.handlerPath) if (!await fs.exists(expected.handlerPath)) errors.push(`Missing handler file: ${expected.handlerPath}`);
-	else {
-		const handlerCode = await fs.readFile(expected.handlerPath);
-		const expectedSpecVar = `${toPascalCase(specName.split(".").pop() ?? specName)}Spec`;
-		const hasContractHandlerType = /ContractHandler<\s*typeof\s+\w+\s*>/.test(handlerCode);
-		const referencesExpectedSpec = (/* @__PURE__ */ new RegExp(`typeof\\s+${expectedSpecVar}\\b`)).test(handlerCode);
-		if (!hasContractHandlerType) warnings.push(`Handler does not appear to type itself as ContractHandler<typeof Spec>: ${expected.handlerPath}`);
-		else if (!referencesExpectedSpec) warnings.push(`Handler ContractHandler typing does not reference expected spec var (${expectedSpecVar}): ${expected.handlerPath}`);
-	}
-	if (options.checkTests) {
-		const candidateTests = [
-			expected.handlerTestPath,
-			expected.componentTestPath,
-			expected.formTestPath
-		].filter((p) => typeof p === "string");
-		for (const testPath of candidateTests) if (!await fs.exists(testPath)) errors.push(`Missing test file: ${testPath}`);
-	}
-	return {
-		valid: errors.length === 0,
-		errors,
-		warnings,
-		expected
-	};
-}
-
-//#endregion
-export { validateImplementationFiles };

package/dist/services/validate.js

@@ -1,47 +0,0 @@
-import { validateSpecStructure } from "../modules/contractspec-workspace/dist/analysis/validate/spec-structure.js";
-
-//#region src/services/validate.ts
-/**
-* Validation service.
-*/
-/**
-* Validate a spec file.
-*/
-async function validateSpec(specFile, adapters, options = {}) {
-	const { fs } = adapters;
-	if (!await fs.exists(specFile)) return {
-		valid: false,
-		errors: [`Spec file not found: ${specFile}`],
-		warnings: []
-	};
-	const specCode = await fs.readFile(specFile);
-	const fileName = fs.basename(specFile);
-	const allErrors = [];
-	const allWarnings = [];
-	let structureResult;
-	if (!options.skipStructure) {
-		structureResult = validateSpecStructure(specCode, fileName);
-		allErrors.push(...structureResult.errors);
-		allWarnings.push(...structureResult.warnings);
-	}
-	return {
-		valid: allErrors.length === 0,
-		structureResult,
-		errors: allErrors,
-		warnings: allWarnings
-	};
-}
-/**
-* Validate multiple spec files.
-*/
-async function validateSpecs(specFiles, adapters, options = {}) {
-	const results = /* @__PURE__ */ new Map();
-	for (const specFile of specFiles) {
-		const result = await validateSpec(specFile, adapters, options);
-		results.set(specFile, result);
-	}
-	return results;
-}
-
-//#endregion
-export { validateSpec, validateSpecs };

package/dist/services/verification-cache/adapters/filesystem.js

@@ -1,121 +0,0 @@
-import { __require } from "../../../_virtual/rolldown_runtime.js";
-import { dirname, join } from "path";
-import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "fs";
-
-//#region src/services/verification-cache/adapters/filesystem.ts
-/**
-* Filesystem cache storage adapter.
-*
-* Stores cache entries in a JSON file for CLI and CI environments.
-* Uses atomic writes to prevent corruption.
-*/
-/**
-* Default cache file location.
-*/
-const DEFAULT_CACHE_FILE = ".contractspec/verification-cache.json";
-const CURRENT_VERSION = 1;
-/**
-* Filesystem storage adapter.
-*/
-var FileSystemCacheStorage = class {
-	filePath;
-	cache;
-	isDirty = false;
-	constructor(filePath, workspaceRoot) {
-		const root = workspaceRoot ?? process.cwd();
-		this.filePath = filePath ?? join(root, DEFAULT_CACHE_FILE);
-		this.cache = /* @__PURE__ */ new Map();
-		this.loadSync();
-	}
-	/**
-	* Load cache from disk synchronously.
-	*/
-	loadSync() {
-		try {
-			if (!existsSync(this.filePath)) return;
-			const content = readFileSync(this.filePath, "utf-8");
-			const data = JSON.parse(content);
-			if (data.version !== CURRENT_VERSION) return;
-			for (const [key, entry] of Object.entries(data.entries)) this.cache.set(key, entry);
-		} catch {}
-	}
-	/**
-	* Save cache to disk.
-	*/
-	saveSync() {
-		if (!this.isDirty) return;
-		try {
-			const dir = dirname(this.filePath);
-			if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-			const data = {
-				version: CURRENT_VERSION,
-				entries: Object.fromEntries(this.cache.entries())
-			};
-			const tempPath = `${this.filePath}.tmp`;
-			writeFileSync(tempPath, JSON.stringify(data, null, 2), "utf-8");
-			const { renameSync } = __require("fs");
-			renameSync(tempPath, this.filePath);
-			this.isDirty = false;
-		} catch {}
-	}
-	async get(key) {
-		return this.cache.get(key) ?? null;
-	}
-	async set(key, entry) {
-		this.cache.set(key, entry);
-		this.isDirty = true;
-		this.saveSync();
-	}
-	async delete(key) {
-		const existed = this.cache.delete(key);
-		if (existed) {
-			this.isDirty = true;
-			this.saveSync();
-		}
-		return existed;
-	}
-	async has(key) {
-		return this.cache.has(key);
-	}
-	async keys() {
-		return Array.from(this.cache.keys());
-	}
-	async clear() {
-		this.cache.clear();
-		this.isDirty = true;
-		this.saveSync();
-	}
-	async stats() {
-		let fileSize = 0;
-		try {
-			if (existsSync(this.filePath)) fileSize = statSync(this.filePath).size;
-		} catch {}
-		return {
-			entryCount: this.cache.size,
-			memoryUsage: fileSize
-		};
-	}
-	/**
-	* Force save any pending changes.
-	*/
-	flush() {
-		this.saveSync();
-	}
-	/**
-	* Reload cache from disk.
-	*/
-	reload() {
-		this.cache.clear();
-		this.loadSync();
-		this.isDirty = false;
-	}
-};
-/**
-* Create a filesystem cache storage adapter.
-*/
-function createFileSystemCacheStorage(filePath, workspaceRoot) {
-	return new FileSystemCacheStorage(filePath, workspaceRoot);
-}
-
-//#endregion
-export { FileSystemCacheStorage, createFileSystemCacheStorage };

package/dist/services/verification-cache/adapters/in-memory.js

@@ -1,45 +0,0 @@
-//#region src/services/verification-cache/adapters/in-memory.ts
-/**
-* In-memory storage adapter using a Map.
-*/
-var InMemoryCacheStorage = class {
-	cache = /* @__PURE__ */ new Map();
-	async get(key) {
-		return this.cache.get(key) ?? null;
-	}
-	async set(key, entry) {
-		this.cache.set(key, entry);
-	}
-	async delete(key) {
-		return this.cache.delete(key);
-	}
-	async has(key) {
-		return this.cache.has(key);
-	}
-	async keys() {
-		return Array.from(this.cache.keys());
-	}
-	async clear() {
-		this.cache.clear();
-	}
-	async stats() {
-		let memoryUsage = 0;
-		for (const [key, value] of this.cache.entries()) {
-			memoryUsage += key.length * 2;
-			memoryUsage += JSON.stringify(value).length * 2;
-		}
-		return {
-			entryCount: this.cache.size,
-			memoryUsage
-		};
-	}
-};
-/**
-* Create an in-memory cache storage adapter.
-*/
-function createInMemoryCacheStorage() {
-	return new InMemoryCacheStorage();
-}
-
-//#endregion
-export { InMemoryCacheStorage, createInMemoryCacheStorage };

package/dist/services/verification-cache/adapters/index.js

@@ -1,3 +0,0 @@
-import { InMemoryCacheStorage, createInMemoryCacheStorage } from "./in-memory.js";
-import { FileSystemCacheStorage, createFileSystemCacheStorage } from "./filesystem.js";
-import { WorkspaceStateCacheStorage, createWorkspaceStateCacheStorage } from "./workspace-state.js";

package/dist/services/verification-cache/adapters/workspace-state.js

@@ -1,90 +0,0 @@
-//#region src/services/verification-cache/adapters/workspace-state.ts
-/**
-* Cache key prefix to avoid collisions.
-*/
-const CACHE_PREFIX = "contractspec.verification-cache.";
-/**
-* Index key for tracking all cache keys.
-*/
-const INDEX_KEY = `${CACHE_PREFIX}__index__`;
-/**
-* Workspace state storage adapter.
-*/
-var WorkspaceStateCacheStorage = class {
-	store;
-	keyIndex;
-	constructor(store) {
-		this.store = store;
-		this.keyIndex = new Set(this.loadKeyIndex());
-	}
-	/**
-	* Load the key index from storage.
-	*/
-	loadKeyIndex() {
-		try {
-			return this.store.get(INDEX_KEY) ?? [];
-		} catch {
-			return [];
-		}
-	}
-	/**
-	* Save the key index to storage.
-	*/
-	async saveKeyIndex() {
-		await this.store.update(INDEX_KEY, Array.from(this.keyIndex));
-	}
-	/**
-	* Get the storage key for a cache key.
-	*/
-	getStorageKey(key) {
-		return `${CACHE_PREFIX}${key}`;
-	}
-	async get(key) {
-		const storageKey = this.getStorageKey(key);
-		return this.store.get(storageKey) ?? null;
-	}
-	async set(key, entry) {
-		const storageKey = this.getStorageKey(key);
-		await this.store.update(storageKey, entry);
-		if (!this.keyIndex.has(key)) {
-			this.keyIndex.add(key);
-			await this.saveKeyIndex();
-		}
-	}
-	async delete(key) {
-		const storageKey = this.getStorageKey(key);
-		const existed = this.keyIndex.has(key);
-		if (existed) {
-			await this.store.update(storageKey, void 0);
-			this.keyIndex.delete(key);
-			await this.saveKeyIndex();
-		}
-		return existed;
-	}
-	async has(key) {
-		return this.keyIndex.has(key);
-	}
-	async keys() {
-		return Array.from(this.keyIndex);
-	}
-	async clear() {
-		for (const key of this.keyIndex) {
-			const storageKey = this.getStorageKey(key);
-			await this.store.update(storageKey, void 0);
-		}
-		this.keyIndex.clear();
-		await this.saveKeyIndex();
-	}
-	async stats() {
-		return { entryCount: this.keyIndex.size };
-	}
-};
-/**
-* Create a workspace state cache storage adapter.
-*/
-function createWorkspaceStateCacheStorage(store) {
-	return new WorkspaceStateCacheStorage(store);
-}
-
-//#endregion
-export { WorkspaceStateCacheStorage, createWorkspaceStateCacheStorage };