@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217072406

package/dist/services/openapi/import-service.js

@@ -1 +1,75 @@
-import{importFromOpenApi as e,parseOpenApi as t}from"@lssm/lib.contracts-transformers/openapi";import{dirname as n,join as r}from"path";async function i(i,a){let{fs:o,logger:s}=a,{source:c,outputDir:l,prefix:u,tags:d,exclude:f,defaultStability:p,defaultOwners:m,defaultAuth:h,dryRun:g=!1}=i;s.info(`Importing from OpenAPI: ${c}`);let _=await t(c,{fetch:globalThis.fetch,readFile:e=>o.readFile(e)});if(_.warnings.length>0)for(let e of _.warnings)s.warn(`Parse warning: ${e}`);s.info(`Parsed ${_.operations.length} operations from ${_.info.title} v${_.info.version}`);let v=e(_,{prefix:u,tags:d,exclude:f,defaultStability:p,defaultOwners:m,defaultAuth:h});s.info(`Import result: ${v.summary.imported} imported, ${v.summary.skipped} skipped, ${v.summary.errors} errors`);let y=[],b=[],x=[];for(let e of v.specs){let t=r(l,e.fileName);if(g)s.info(`[DRY RUN] Would create: ${t}`);else{let r=n(t);await o.mkdir(r),await o.writeFile(t,e.code),s.info(`Created: ${t}`)}y.push({path:t,operationId:e.source.sourceId,specName:e.fileName.replace(`.ts`,``)})}for(let e of v.skipped)b.push({operationId:e.sourceId,reason:e.reason}),s.debug(`Skipped: ${e.sourceId} - ${e.reason}`);for(let e of v.errors)x.push({operationId:e.sourceId,error:e.error}),s.error(`Error: ${e.sourceId} - ${e.error}`);return{imported:v.summary.imported,skipped:v.summary.skipped,errors:v.summary.errors,files:y,skippedOperations:b,errorMessages:x}}export{i as importFromOpenApiService};
+import { parseOpenApi } from "../../libs/contracts-transformers/dist/openapi/parser.js";
+import { importFromOpenApi } from "../../libs/contracts-transformers/dist/openapi/importer.js";
+import "../../libs/contracts-transformers/dist/openapi/index.js";
+import { dirname, join } from "path";
+
+//#region src/services/openapi/import-service.ts
+/**
+* OpenAPI import service - imports specs from OpenAPI documents.
+*/
+/**
+* Import ContractSpec specs from an OpenAPI document.
+*/
+async function importFromOpenApiService(options, adapters) {
+	const { fs, logger } = adapters;
+	const { source, outputDir, prefix, tags, exclude, defaultStability, defaultOwners, defaultAuth, dryRun = false } = options;
+	logger.info(`Importing from OpenAPI: ${source}`);
+	const parseResult = await parseOpenApi(source, {
+		fetch: globalThis.fetch,
+		readFile: (path) => fs.readFile(path)
+	});
+	if (parseResult.warnings.length > 0) for (const warning of parseResult.warnings) logger.warn(`Parse warning: ${warning}`);
+	logger.info(`Parsed ${parseResult.operations.length} operations from ${parseResult.info.title} v${parseResult.info.version}`);
+	const importResult = importFromOpenApi(parseResult, {
+		prefix,
+		tags,
+		exclude,
+		defaultStability,
+		defaultOwners,
+		defaultAuth
+	});
+	logger.info(`Import result: ${importResult.summary.imported} imported, ${importResult.summary.skipped} skipped, ${importResult.summary.errors} errors`);
+	const files = [];
+	const skippedOperations = [];
+	const errorMessages = [];
+	for (const spec of importResult.specs) {
+		const filePath = join(outputDir, spec.fileName);
+		if (dryRun) logger.info(`[DRY RUN] Would create: ${filePath}`);
+		else {
+			const dir = dirname(filePath);
+			await fs.mkdir(dir);
+			await fs.writeFile(filePath, spec.code);
+			logger.info(`Created: ${filePath}`);
+		}
+		files.push({
+			path: filePath,
+			operationId: spec.source.sourceId,
+			specName: spec.fileName.replace(".ts", "")
+		});
+	}
+	for (const skipped of importResult.skipped) {
+		skippedOperations.push({
+			operationId: skipped.sourceId,
+			reason: skipped.reason
+		});
+		logger.debug(`Skipped: ${skipped.sourceId} - ${skipped.reason}`);
+	}
+	for (const error of importResult.errors) {
+		errorMessages.push({
+			operationId: error.sourceId,
+			error: error.error
+		});
+		logger.error(`Error: ${error.sourceId} - ${error.error}`);
+	}
+	return {
+		imported: importResult.summary.imported,
+		skipped: importResult.summary.skipped,
+		errors: importResult.summary.errors,
+		files,
+		skippedOperations,
+		errorMessages
+	};
+}
+
+//#endregion
+export { importFromOpenApiService };

package/dist/services/openapi/index.js

@@ -1 +1,4 @@
-import{importFromOpenApiService as e}from"./import-service.js";import{syncWithOpenApiService as t}from"./sync-service.js";import{validateAgainstOpenApiService as n}from"./validate-service.js";import{exportOpenApi as r}from"./export-service.js";
+import { importFromOpenApiService } from "./import-service.js";
+import { syncWithOpenApiService } from "./sync-service.js";
+import { validateAgainstOpenApiService } from "./validate-service.js";
+import { exportOpenApi } from "./export-service.js";

package/dist/services/openapi/sync-service.js

@@ -1 +1,121 @@
-import{importFromOpenApi as e,parseOpenApi as t}from"@lssm/lib.contracts-transformers/openapi";import{dirname as n,join as r}from"path";async function i(i,a,o){let{fs:s,logger:c}=o,{sources:l,sourceName:u,interactive:d,force:f,dryRun:p}=i,{sources:m,outputDir:h}=a,g=l??m??[];if(u&&(g=g.filter(e=>e.name===u),g.length===0))throw Error(`Source not found: ${u}`);if(g.length===0)return c.warn(`No OpenAPI sources configured. Add sources to .contractsrc.json`),{added:0,updated:0,unchanged:0,conflicts:0,changes:[]};let _={added:0,updated:0,unchanged:0,conflicts:0,changes:[]};for(let i of g){c.info(`Syncing with source: ${i.name}`);let a=i.url??i.file;if(!a){c.warn(`Source ${i.name} has no url or file configured`);continue}let o=await t(a,{fetch:globalThis.fetch,readFile:e=>s.readFile(e)});c.info(`Parsed ${o.operations.length} operations from ${i.name}`);let l=e(o,{prefix:i.prefix,tags:i.tags,exclude:i.exclude,defaultStability:i.defaultStability,defaultAuth:i.defaultAuth});for(let e of l.specs){let t=r(h,e.fileName);if(await s.exists(t))await s.readFile(t)===e.code?(_.unchanged++,_.changes.push({operationId:e.source.sourceId,action:`unchanged`,path:t})):f===`openapi`?(p||await s.writeFile(t,e.code),_.updated++,_.changes.push({operationId:e.source.sourceId,action:`updated`,path:t}),c.info(`Updated: ${e.source.sourceId}`)):f===`contractspec`?(_.unchanged++,_.changes.push({operationId:e.source.sourceId,action:`unchanged`,path:t}),c.info(`Kept: ${e.source.sourceId}`)):d?(_.conflicts++,_.changes.push({operationId:e.source.sourceId,action:`conflict`,path:t}),c.warn(`Conflict: ${e.source.sourceId} - needs resolution`)):(_.conflicts++,_.changes.push({operationId:e.source.sourceId,action:`conflict`,path:t}),c.warn(`Conflict: ${e.source.sourceId}`));else{if(!p){let r=n(t);await s.mkdir(r),await s.writeFile(t,e.code)}_.added++,_.changes.push({operationId:e.source.sourceId,action:`added`,path:t}),c.info(`Added: ${e.source.sourceId}`)}}}return c.info(`Sync complete: ${_.added} added, ${_.updated} updated, ${_.unchanged} unchanged, ${_.conflicts} conflicts`),_}export{i as syncWithOpenApiService};
+import { parseOpenApi } from "../../libs/contracts-transformers/dist/openapi/parser.js";
+import { importFromOpenApi } from "../../libs/contracts-transformers/dist/openapi/importer.js";
+import "../../libs/contracts-transformers/dist/openapi/index.js";
+import { dirname, join } from "path";
+
+//#region src/services/openapi/sync-service.ts
+/**
+* OpenAPI sync service - syncs specs with OpenAPI sources.
+*/
+/**
+* Sync ContractSpec specs with OpenAPI sources.
+*/
+async function syncWithOpenApiService(options, config, adapters) {
+	const { fs, logger } = adapters;
+	const { sources: optSources, sourceName, interactive, force, dryRun } = options;
+	const { sources: configSources, outputDir } = config;
+	let sourcesToSync = optSources ?? configSources ?? [];
+	if (sourceName) {
+		sourcesToSync = sourcesToSync.filter((s) => s.name === sourceName);
+		if (sourcesToSync.length === 0) throw new Error(`Source not found: ${sourceName}`);
+	}
+	if (sourcesToSync.length === 0) {
+		logger.warn("No OpenAPI sources configured. Add sources to .contractsrc.json");
+		return {
+			added: 0,
+			updated: 0,
+			unchanged: 0,
+			conflicts: 0,
+			changes: []
+		};
+	}
+	const result = {
+		added: 0,
+		updated: 0,
+		unchanged: 0,
+		conflicts: 0,
+		changes: []
+	};
+	for (const source of sourcesToSync) {
+		logger.info(`Syncing with source: ${source.name}`);
+		const sourceLocation = source.url ?? source.file;
+		if (!sourceLocation) {
+			logger.warn(`Source ${source.name} has no url or file configured`);
+			continue;
+		}
+		const parseResult = await parseOpenApi(sourceLocation, {
+			fetch: globalThis.fetch,
+			readFile: (path) => fs.readFile(path)
+		});
+		logger.info(`Parsed ${parseResult.operations.length} operations from ${source.name}`);
+		const importResult = importFromOpenApi(parseResult, {
+			prefix: source.prefix,
+			tags: source.tags,
+			exclude: source.exclude,
+			defaultStability: source.defaultStability,
+			defaultAuth: source.defaultAuth
+		});
+		for (const imported of importResult.specs) {
+			const filePath = join(outputDir, imported.fileName);
+			if (!await fs.exists(filePath)) {
+				if (!dryRun) {
+					const dir = dirname(filePath);
+					await fs.mkdir(dir);
+					await fs.writeFile(filePath, imported.code);
+				}
+				result.added++;
+				result.changes.push({
+					operationId: imported.source.sourceId,
+					action: "added",
+					path: filePath
+				});
+				logger.info(`Added: ${imported.source.sourceId}`);
+			} else if (await fs.readFile(filePath) === imported.code) {
+				result.unchanged++;
+				result.changes.push({
+					operationId: imported.source.sourceId,
+					action: "unchanged",
+					path: filePath
+				});
+			} else if (force === "openapi") {
+				if (!dryRun) await fs.writeFile(filePath, imported.code);
+				result.updated++;
+				result.changes.push({
+					operationId: imported.source.sourceId,
+					action: "updated",
+					path: filePath
+				});
+				logger.info(`Updated: ${imported.source.sourceId}`);
+			} else if (force === "contractspec") {
+				result.unchanged++;
+				result.changes.push({
+					operationId: imported.source.sourceId,
+					action: "unchanged",
+					path: filePath
+				});
+				logger.info(`Kept: ${imported.source.sourceId}`);
+			} else if (interactive) {
+				result.conflicts++;
+				result.changes.push({
+					operationId: imported.source.sourceId,
+					action: "conflict",
+					path: filePath
+				});
+				logger.warn(`Conflict: ${imported.source.sourceId} - needs resolution`);
+			} else {
+				result.conflicts++;
+				result.changes.push({
+					operationId: imported.source.sourceId,
+					action: "conflict",
+					path: filePath
+				});
+				logger.warn(`Conflict: ${imported.source.sourceId}`);
+			}
+		}
+	}
+	logger.info(`Sync complete: ${result.added} added, ${result.updated} updated, ${result.unchanged} unchanged, ${result.conflicts} conflicts`);
+	return result;
+}
+
+//#endregion
+export { syncWithOpenApiService };

package/dist/services/openapi/validate-service.js

@@ -1 +1,130 @@
-import{parseOpenApi as e}from"@lssm/lib.contracts-transformers/openapi";async function t(t,n){let{fs:r,logger:i}=n,{specPath:a,openApiSource:o,ignoreDescriptions:s,ignoreTags:c,ignoreTransport:l}=t;i.info(`Validating specs against OpenAPI: ${o}`);let u=await e(o,{fetch:globalThis.fetch,readFile:e=>r.readFile(e)});i.info(`Parsed ${u.operations.length} operations from ${u.info.title}`);let d=new Map;for(let e of u.operations)d.set(e.operationId,e);let f=[],p=0,m=0,h=await r.stat(a),g=[];if(h.isDirectory){let e=await r.glob({pattern:`**/*.ts`,cwd:a,ignore:[`node_modules/**`,`dist/**`,`*.test.ts`,`*.spec.ts`],absolute:!0});g.push(...e)}else g.push(a);i.info(`Found ${g.length} spec files to validate`);for(let e of g)try{let t=await r.readFile(e),n=t.match(/operationId:\s*['"]([^'"]+)['"]/)||t.match(/name:\s*['"]([^'"]+)['"]/)||t.match(/export\s+const\s+(\w+)Spec\s*=/);if(!n||!n[1]){i.debug(`Could not extract operationId from ${e}`);continue}let a=n[1];p++;let o;if(o=d.get(a),!o){let e=a.replace(/([A-Z])/g,`_$1`).toLowerCase();o=d.get(e)}if(!o){for(let[e,t]of d)if(e.toLowerCase().includes(a.toLowerCase())||a.toLowerCase().includes(e.toLowerCase())){o=t;break}}if(!o){f.push({specPath:e,valid:!1,diffs:[{path:``,type:`removed`,description:`No matching operation found in OpenAPI for spec: ${a}`}]}),m++;continue}let s=[];if(o.deprecated&&!t.includes(`deprecated`)&&s.push({path:`meta.stability`,type:`modified`,description:`OpenAPI operation is deprecated but spec does not indicate deprecation`}),!l){let e=t.match(/path:\s*['"]([^'"]+)['"]/);e&&e[1]!==o.path&&s.push({path:`transport.rest.path`,type:`modified`,description:`Path mismatch: spec has "${e[1]}", OpenAPI has "${o.path}"`})}if(!l){let e=t.match(/method:\s*['"]([^'"]+)['"]/);e?.[1]&&e[1].toLowerCase()!==o.method.toLowerCase()&&s.push({path:`transport.rest.method`,type:`modified`,description:`Method mismatch: spec has "${e[1]}", OpenAPI has "${o.method.toUpperCase()}"`})}let c=s.length===0;c||m++,f.push({specPath:e,operationId:o.operationId,valid:c,diffs:s})}catch(t){i.error(`Error validating ${e}: ${t}`),f.push({specPath:e,valid:!1,diffs:[{path:``,type:`modified`,description:`Error: ${t instanceof Error?t.message:String(t)}`}]}),m++}let _=m===0;return i.info(`Validation ${_?`passed`:`failed`}: ${p} specs checked, ${m} with differences`),{valid:_,specsValidated:p,specsWithDiffs:m,results:f}}export{t as validateAgainstOpenApiService};
+import { parseOpenApi } from "../../libs/contracts-transformers/dist/openapi/parser.js";
+import "../../libs/contracts-transformers/dist/openapi/index.js";
+
+//#region src/services/openapi/validate-service.ts
+/**
+* OpenAPI validation service - validates specs against OpenAPI sources.
+*/
+/**
+* Validate ContractSpec specs against an OpenAPI source.
+*/
+async function validateAgainstOpenApiService(options, adapters) {
+	const { fs, logger } = adapters;
+	const { specPath, openApiSource, ignoreDescriptions, ignoreTags, ignoreTransport } = options;
+	logger.info(`Validating specs against OpenAPI: ${openApiSource}`);
+	const parseResult = await parseOpenApi(openApiSource, {
+		fetch: globalThis.fetch,
+		readFile: (path) => fs.readFile(path)
+	});
+	logger.info(`Parsed ${parseResult.operations.length} operations from ${parseResult.info.title}`);
+	const operationsMap = /* @__PURE__ */ new Map();
+	for (const op of parseResult.operations) operationsMap.set(op.operationId, op);
+	const results = [];
+	let specsValidated = 0;
+	let specsWithDiffs = 0;
+	const stat = await fs.stat(specPath);
+	const specFiles = [];
+	if (stat.isDirectory) {
+		const files = await fs.glob({
+			pattern: "**/*.ts",
+			cwd: specPath,
+			ignore: [
+				"node_modules/**",
+				"dist/**",
+				"*.test.ts",
+				"*.spec.ts"
+			],
+			absolute: true
+		});
+		specFiles.push(...files);
+	} else specFiles.push(specPath);
+	logger.info(`Found ${specFiles.length} spec files to validate`);
+	for (const file of specFiles) try {
+		const content = await fs.readFile(file);
+		const operationIdMatch = content.match(/operationId:\s*['"]([^'"]+)['"]/) || content.match(/name:\s*['"]([^'"]+)['"]/) || content.match(/export\s+const\s+(\w+)Spec\s*=/);
+		if (!operationIdMatch || !operationIdMatch[1]) {
+			logger.debug(`Could not extract operationId from ${file}`);
+			continue;
+		}
+		const specName = operationIdMatch[1];
+		specsValidated++;
+		let matchingOp;
+		matchingOp = operationsMap.get(specName);
+		if (!matchingOp) {
+			const snakeName = specName.replace(/([A-Z])/g, "_$1").toLowerCase();
+			matchingOp = operationsMap.get(snakeName);
+		}
+		if (!matchingOp) {
+			for (const [opId, op] of operationsMap) if (opId.toLowerCase().includes(specName.toLowerCase()) || specName.toLowerCase().includes(opId.toLowerCase())) {
+				matchingOp = op;
+				break;
+			}
+		}
+		if (!matchingOp) {
+			results.push({
+				specPath: file,
+				valid: false,
+				diffs: [{
+					path: "",
+					type: "removed",
+					description: `No matching operation found in OpenAPI for spec: ${specName}`
+				}]
+			});
+			specsWithDiffs++;
+			continue;
+		}
+		const diffs = [];
+		if (matchingOp.deprecated && !content.includes("deprecated")) diffs.push({
+			path: "meta.stability",
+			type: "modified",
+			description: "OpenAPI operation is deprecated but spec does not indicate deprecation"
+		});
+		if (!ignoreTransport) {
+			const pathMatch = content.match(/path:\s*['"]([^'"]+)['"]/);
+			if (pathMatch && pathMatch[1] !== matchingOp.path) diffs.push({
+				path: "transport.rest.path",
+				type: "modified",
+				description: `Path mismatch: spec has "${pathMatch[1]}", OpenAPI has "${matchingOp.path}"`
+			});
+		}
+		if (!ignoreTransport) {
+			const methodMatch = content.match(/method:\s*['"]([^'"]+)['"]/);
+			if (methodMatch?.[1] && methodMatch[1].toLowerCase() !== matchingOp.method.toLowerCase()) diffs.push({
+				path: "transport.rest.method",
+				type: "modified",
+				description: `Method mismatch: spec has "${methodMatch[1]}", OpenAPI has "${matchingOp.method.toUpperCase()}"`
+			});
+		}
+		const valid$1 = diffs.length === 0;
+		if (!valid$1) specsWithDiffs++;
+		results.push({
+			specPath: file,
+			operationId: matchingOp.operationId,
+			valid: valid$1,
+			diffs
+		});
+	} catch (error) {
+		logger.error(`Error validating ${file}: ${error}`);
+		results.push({
+			specPath: file,
+			valid: false,
+			diffs: [{
+				path: "",
+				type: "modified",
+				description: `Error: ${error instanceof Error ? error.message : String(error)}`
+			}]
+		});
+		specsWithDiffs++;
+	}
+	const valid = specsWithDiffs === 0;
+	logger.info(`Validation ${valid ? "passed" : "failed"}: ${specsValidated} specs checked, ${specsWithDiffs} with differences`);
+	return {
+		valid,
+		specsValidated,
+		specsWithDiffs,
+		results
+	};
+}
+
+//#endregion
+export { validateAgainstOpenApiService };

package/dist/services/regenerator.js

@@ -1 +1,23 @@
-import{RegeneratorService as e}from"@lssm/lib.contracts/regenerator";function t(t){return new e({contexts:t.contexts,adapters:t.adapters??{},rules:t.rules,sink:t.sink,pollIntervalMs:t.pollIntervalMs,batchDurationMs:t.batchDurationMs})}export{t as createRegeneratorService};
+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 +1,73 @@
-var e=class{registryUrl;constructor(e){this.registryUrl=e.registryUrl.replace(/\/+$/,``)}async getJson(e){let t=`${this.registryUrl}${e.startsWith(`/`)?``:`/`}${e}`,n;try{n=await fetch(t,{method:`GET`,headers:{Accept:`application/json`}})}catch(e){throw Error(`Registry request failed: ${t} (${e instanceof Error?e.message:String(e)})`)}if(!n.ok){let e=await n.text().catch(()=>``);throw Error(`Registry request failed: ${n.status} ${n.statusText} ${e}`)}return await n.json()}};function t(e){return e||process.env.CONTRACTSPEC_REGISTRY_URL||`http://localhost:8090`}async function n(n,r,i){let{logger:a}=i,o=t(r.registryUrl);a.info(`Adding spec to registry: ${n}`,{registryUrl:o}),await new e({registryUrl:o}).getJson(`/specs/add?path=${encodeURIComponent(n)}`),a.info(`Spec added to registry successfully`)}async function r(n,r){let{logger:i}=r,a=t(n.registryUrl);i.info(`Listing specs from registry`,{registryUrl:a});let o=new e({registryUrl:a}),s=n.filter?`?filter=${encodeURIComponent(n.filter)}`:``,c=await o.getJson(`/specs${s}`);return i.info(`Found ${c.length} specs`),c}async function i(n,r,i){let{logger:a}=i,o=t(r.registryUrl);a.info(`Searching registry: ${n}`,{registryUrl:o});let s=await new e({registryUrl:o}).getJson(`/specs/search?q=${encodeURIComponent(n)}`);return a.info(`Found ${s.length} results`),s}export{e as RegistryClient,n as addToRegistry,r as listFromRegistry,t as resolveRegistryUrl,i as searchRegistry};
+//#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,4 +1,72 @@
-function e(e){let t=e.isMonorepo&&e.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:e.defaultOwners??[`@team`],defaultTags:[],...t&&e.packageName?{package:e.packageName}:{}}}function t(){return{"contractspec.validation.enabled":!0,"contractspec.validation.validateOnSave":!0,"contractspec.validation.validateOnOpen":!0,"contractspec.codeLens.enabled":!0,"contractspec.diagnostics.showWarnings":!0,"contractspec.diagnostics.showHints":!0,"contractspec.integrity.enabled":!0,"contractspec.integrity.checkOnSave":!0}}function n(){return{mcpServers:{"contractspec-local":{command:`bunx`,args:[`contractspec-mcp`]}}}}function r(){return{mcpServers:{"contractspec-local":{command:`bunx`,args:[`contractspec-mcp`]}}}}function i(e){let t=e.projectName??`this project`,n=e.isMonorepo&&e.scope===`package`&&e.packageRoot?`${e.packageRoot.split(`/`).slice(-2).join(`/`)}/src/contracts`:`src/contracts`;return`# ContractSpec Development Rules
+//#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.
 
@@ -7,22 +75,14 @@ This project uses ContractSpec for spec-first development. Follow these guidelin
 - **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.
-${e.isMonorepo?`
-## Monorepo Structure
-
-This is a monorepo. Contracts may exist at:
-- Package level: \`packages/*/src/contracts/\`
-- Workspace level: \`src/contracts/\`
-
-Check the appropriate level based on the feature scope.
-`:``}
+${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:
-- \`${n}/operations/\` - Command and query specs
-- \`${n}/events/\` - Event specs
-- \`${n}/presentations/\` - UI presentation specs
-- \`${n}/features/\` - Feature module specs
+- \`${basePath}/operations/\` - Command and query specs
+- \`${basePath}/events/\` - Event specs
+- \`${basePath}/presentations/\` - UI presentation specs
+- \`${basePath}/features/\` - Feature module specs
 
 ## When Making Changes
 
@@ -50,17 +110,28 @@ defineCommand({
 });
 \`\`\`
 
-## Rules for ${t}
+## 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.
-`}function a(e){let t=e.projectName??`This Project`,n=e.isMonorepo&&e.scope===`package`,r=`src/contracts/`;return`# AI Agent Guide
+`;
+}
+/**
+* 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: ${t}
+## Project: ${projectName}
 
 ## ContractSpec Overview
 
@@ -71,7 +142,7 @@ ContractSpec is a deterministic, spec-first compiler that keeps AI-written softw
 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.
-${e.isMonorepo?`
+${options.isMonorepo ? `
 ## Monorepo Structure
 
 This is a monorepo. Contracts can exist at multiple levels:
@@ -87,13 +158,13 @@ When adding a contract, consider:
 
 ### Current Scope
 
-${n?`You are working at the **package level**: \`${e.packageName??e.packageRoot}\``:`You are working at the **workspace level**.`}
-`:``}
+${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 \`${r}\`
+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\`
@@ -109,10 +180,10 @@ ${n?`You are working at the **package level**: \`${e.packageName??e.packageRoot}
 
 | Type | Location |
 |------|----------|
-| Operations | \`${r}operations/\` |
-| Events | \`${r}events/\` |
-| Presentations | \`${r}presentations/\` |
-| Features | \`${r}features/\` |
+| Operations | \`${contractPath}operations/\` |
+| Events | \`${contractPath}events/\` |
+| Presentations | \`${contractPath}presentations/\` |
+| Features | \`${contractPath}features/\` |
 
 ## MCP Tools Available
 
@@ -147,4 +218,20 @@ contractspec integrity
 ## Nested AGENTS.md
 
 More specific instructions may exist in subdirectories. Check for \`AGENTS.md\` files in the relevant package or module.
-`}function o(){let e=process.platform,t=process.env.HOME??process.env.USERPROFILE??``;switch(e){case`darwin`:return`${t}/Library/Application Support/Claude/claude_desktop_config.json`;case`win32`:return`${process.env.APPDATA??t}/Claude/claude_desktop_config.json`;default:return`${t}/.config/claude/claude_desktop_config.json`}}export{a as generateAgentsMd,r as generateClaudeMcpConfig,e as generateContractsrcConfig,n as generateCursorMcpConfig,i as generateCursorRules,t as generateVscodeSettings,o as getClaudeDesktopConfigPath};
+`;
+}
+/**
+* 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 };