@contractspec/bundle.workspace 0.0.0-canary-20260113162409

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

@@ -0,0 +1,130 @@
+import { parseOpenApi } from "@contractspec/lib.contracts-transformers/openapi";
+
+//#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: _ignoreDescriptions, ignoreTags: _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 };
+//# sourceMappingURL=validate-service.mjs.map

package/dist/services/openapi/validate-service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-service.mjs","names":["valid"],"sources":["../../../src/services/openapi/validate-service.ts"],"sourcesContent":["/**\n * OpenAPI validation service - validates specs against OpenAPI sources.\n */\n\nimport {\n  parseOpenApi,\n  type ParsedOperation,\n} from '@contractspec/lib.contracts-transformers/openapi';\nimport type { FsAdapter } from '../../ports/fs';\nimport type { LoggerAdapter } from '../../ports/logger';\nimport type {\n  OpenApiValidateServiceOptions,\n  OpenApiValidateServiceResult,\n} from './types';\n\n/**\n * Validate ContractSpec specs against an OpenAPI source.\n */\nexport async function validateAgainstOpenApiService(\n  options: OpenApiValidateServiceOptions,\n  adapters: { fs: FsAdapter; logger: LoggerAdapter }\n): Promise<OpenApiValidateServiceResult> {\n  const { fs, logger } = adapters;\n  const {\n    specPath,\n    openApiSource,\n    ignoreDescriptions: _ignoreDescriptions,\n    ignoreTags: _ignoreTags,\n    ignoreTransport,\n  } = options;\n\n  logger.info(`Validating specs against OpenAPI: ${openApiSource}`);\n\n  // Parse the OpenAPI document\n  const parseResult = await parseOpenApi(openApiSource, {\n    fetch: globalThis.fetch,\n    readFile: (path) => fs.readFile(path),\n  });\n\n  logger.info(\n    `Parsed ${parseResult.operations.length} operations from ${parseResult.info.title}`\n  );\n\n  // Build a map of operations by operationId\n  const operationsMap = new Map<string, ParsedOperation>();\n  for (const op of parseResult.operations) {\n    operationsMap.set(op.operationId, op);\n  }\n\n  const results: OpenApiValidateServiceResult['results'] = [];\n  let specsValidated = 0;\n  let specsWithDiffs = 0;\n\n  // Check if specPath is a directory or file\n  const stat = await fs.stat(specPath);\n  const specFiles: string[] = [];\n\n  if (stat.isDirectory) {\n    // Find all spec files in directory\n    const files = await fs.glob({\n      pattern: '**/*.ts',\n      cwd: specPath,\n      ignore: ['node_modules/**', 'dist/**', '*.test.ts', '*.spec.ts'],\n      absolute: true,\n    });\n    specFiles.push(...files);\n  } else {\n    specFiles.push(specPath);\n  }\n\n  logger.info(`Found ${specFiles.length} spec files to validate`);\n\n  for (const file of specFiles) {\n    try {\n      // Read the spec file\n      const content = await fs.readFile(file);\n\n      // Try to extract operationId from the spec file\n      // Look for x-contractspec metadata or transport.rest.path\n      const operationIdMatch =\n        content.match(/operationId:\\s*['\"]([^'\"]+)['\"]/) ||\n        content.match(/name:\\s*['\"]([^'\"]+)['\"]/) ||\n        content.match(/export\\s+const\\s+(\\w+)Spec\\s*=/);\n\n      if (!operationIdMatch || !operationIdMatch[1]) {\n        logger.debug(`Could not extract operationId from ${file}`);\n        continue;\n      }\n\n      const specName: string = operationIdMatch[1];\n      specsValidated++;\n\n      // Try to find matching OpenAPI operation\n      // Match by operationId or by similar naming\n      let matchingOp: ParsedOperation | undefined;\n\n      // Direct match\n      matchingOp = operationsMap.get(specName);\n\n      // Try variations if no direct match\n      if (!matchingOp) {\n        // Try camelCase to snake_case\n        const snakeName = specName.replace(/([A-Z])/g, '_$1').toLowerCase();\n        matchingOp = operationsMap.get(snakeName);\n      }\n\n      if (!matchingOp) {\n        // Try matching by partial name\n        for (const [opId, op] of operationsMap) {\n          if (\n            opId.toLowerCase().includes(specName.toLowerCase()) ||\n            specName.toLowerCase().includes(opId.toLowerCase())\n          ) {\n            matchingOp = op;\n            break;\n          }\n        }\n      }\n\n      if (!matchingOp) {\n        results.push({\n          specPath: file,\n          valid: false,\n          diffs: [\n            {\n              path: '',\n              type: 'removed',\n              description: `No matching operation found in OpenAPI for spec: ${specName}`,\n            },\n          ],\n        });\n        specsWithDiffs++;\n        continue;\n      }\n\n      // For now, we'll do a basic validation\n      // In a full implementation, we would load the actual spec and compare\n      const diffs: OpenApiValidateServiceResult['results'][0]['diffs'] = [];\n\n      // Check if spec mentions deprecated when OpenAPI says deprecated\n      if (matchingOp.deprecated && !content.includes('deprecated')) {\n        diffs.push({\n          path: 'meta.stability',\n          type: 'modified',\n          description:\n            'OpenAPI operation is deprecated but spec does not indicate deprecation',\n        });\n      }\n\n      // Check path match\n      if (!ignoreTransport) {\n        const pathMatch = content.match(/path:\\s*['\"]([^'\"]+)['\"]/);\n        if (pathMatch && pathMatch[1] !== matchingOp.path) {\n          diffs.push({\n            path: 'transport.rest.path',\n            type: 'modified',\n            description: `Path mismatch: spec has \"${pathMatch[1]}\", OpenAPI has \"${matchingOp.path}\"`,\n          });\n        }\n      }\n\n      // Check method match\n      if (!ignoreTransport) {\n        const methodMatch = content.match(/method:\\s*['\"]([^'\"]+)['\"]/);\n        if (\n          methodMatch?.[1] &&\n          methodMatch[1].toLowerCase() !== matchingOp.method.toLowerCase()\n        ) {\n          diffs.push({\n            path: 'transport.rest.method',\n            type: 'modified',\n            description: `Method mismatch: spec has \"${methodMatch[1]}\", OpenAPI has \"${matchingOp.method.toUpperCase()}\"`,\n          });\n        }\n      }\n\n      const valid = diffs.length === 0;\n      if (!valid) {\n        specsWithDiffs++;\n      }\n\n      results.push({\n        specPath: file,\n        operationId: matchingOp.operationId,\n        valid,\n        diffs,\n      });\n    } catch (error) {\n      logger.error(`Error validating ${file}: ${error}`);\n      results.push({\n        specPath: file,\n        valid: false,\n        diffs: [\n          {\n            path: '',\n            type: 'modified',\n            description: `Error: ${error instanceof Error ? error.message : String(error)}`,\n          },\n        ],\n      });\n      specsWithDiffs++;\n    }\n  }\n\n  const valid = specsWithDiffs === 0;\n\n  logger.info(\n    `Validation ${valid ? 'passed' : 'failed'}: ${specsValidated} specs checked, ${specsWithDiffs} with differences`\n  );\n\n  return {\n    valid,\n    specsValidated,\n    specsWithDiffs,\n    results,\n  };\n}\n"],"mappings":"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"}

package/dist/services/quickstart/dependencies.d.mts

@@ -0,0 +1,31 @@
+import { QuickstartDependency } from "./types.mjs";
+
+//#region src/services/quickstart/dependencies.d.ts
+
+/**
+ * Minimal dependencies required for ContractSpec to work.
+ *
+ * This is the absolute minimum needed to define and use contracts.
+ */
+declare const MINIMAL_DEPENDENCIES: QuickstartDependency[];
+/**
+ * Full dependencies for a complete ContractSpec setup.
+ *
+ * Includes development tools and extended libraries.
+ */
+declare const FULL_DEPENDENCIES: QuickstartDependency[];
+/**
+ * Get dependencies for the specified mode.
+ */
+declare function getDependencies(mode: 'minimal' | 'full'): QuickstartDependency[];
+/**
+ * Get production dependencies (non-dev).
+ */
+declare function getProductionDependencies(dependencies: QuickstartDependency[]): QuickstartDependency[];
+/**
+ * Get development dependencies.
+ */
+declare function getDevDependencies(dependencies: QuickstartDependency[]): QuickstartDependency[];
+//#endregion
+export { FULL_DEPENDENCIES, MINIMAL_DEPENDENCIES, getDependencies, getDevDependencies, getProductionDependencies };
+//# sourceMappingURL=dependencies.d.mts.map

package/dist/services/quickstart/dependencies.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.mts","names":[],"sources":["../../../src/services/quickstart/dependencies.ts"],"sourcesContent":[],"mappings":";;;;AA0EA;;;;;cA5Da,sBAAsB;;;;;;cAiBtB,mBAAmB;;;;iBAyBhB,eAAA,4BAEb;;;;iBAOa,yBAAA,eACA,yBACb;;;;iBAOa,kBAAA,eACA,yBACb"}

package/dist/services/quickstart/dependencies.mjs

@@ -0,0 +1,57 @@
+//#region src/services/quickstart/dependencies.ts
+/**
+* Minimal dependencies required for ContractSpec to work.
+*
+* This is the absolute minimum needed to define and use contracts.
+*/
+const MINIMAL_DEPENDENCIES = [{
+	name: "@contractspec/lib.contracts",
+	description: "Core ContractSpec library for defining commands, queries, and events"
+}, {
+	name: "zod",
+	description: "Schema validation library (peer dependency)"
+}];
+/**
+* Full dependencies for a complete ContractSpec setup.
+*
+* Includes development tools and extended libraries.
+*/
+const FULL_DEPENDENCIES = [
+	...MINIMAL_DEPENDENCIES,
+	{
+		name: "@contractspec/lib.schema",
+		description: "Extended schema utilities and common types"
+	},
+	{
+		name: "@contractspec/app.cli-contractspec",
+		dev: true,
+		description: "ContractSpec CLI for validation, scaffolding, and code generation"
+	},
+	{
+		name: "typescript",
+		dev: true,
+		description: "TypeScript compiler for type checking"
+	}
+];
+/**
+* Get dependencies for the specified mode.
+*/
+function getDependencies(mode) {
+	return mode === "minimal" ? MINIMAL_DEPENDENCIES : FULL_DEPENDENCIES;
+}
+/**
+* Get production dependencies (non-dev).
+*/
+function getProductionDependencies(dependencies) {
+	return dependencies.filter((dep) => !dep.dev);
+}
+/**
+* Get development dependencies.
+*/
+function getDevDependencies(dependencies) {
+	return dependencies.filter((dep) => dep.dev);
+}
+
+//#endregion
+export { FULL_DEPENDENCIES, MINIMAL_DEPENDENCIES, getDependencies, getDevDependencies, getProductionDependencies };
+//# sourceMappingURL=dependencies.mjs.map

package/dist/services/quickstart/dependencies.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.mjs","names":[],"sources":["../../../src/services/quickstart/dependencies.ts"],"sourcesContent":["/**\n * Quickstart dependencies configuration.\n *\n * Defines the minimal and full sets of packages needed\n * for ContractSpec to work.\n */\n\nimport type { QuickstartDependency } from './types';\n\n/**\n * Minimal dependencies required for ContractSpec to work.\n *\n * This is the absolute minimum needed to define and use contracts.\n */\nexport const MINIMAL_DEPENDENCIES: QuickstartDependency[] = [\n  {\n    name: '@contractspec/lib.contracts',\n    description:\n      'Core ContractSpec library for defining commands, queries, and events',\n  },\n  {\n    name: 'zod',\n    description: 'Schema validation library (peer dependency)',\n  },\n];\n\n/**\n * Full dependencies for a complete ContractSpec setup.\n *\n * Includes development tools and extended libraries.\n */\nexport const FULL_DEPENDENCIES: QuickstartDependency[] = [\n  // Core dependencies (from minimal)\n  ...MINIMAL_DEPENDENCIES,\n  // Extended schema utilities\n  {\n    name: '@contractspec/lib.schema',\n    description: 'Extended schema utilities and common types',\n  },\n  // Development tools\n  {\n    name: '@contractspec/app.cli-contractspec',\n    dev: true,\n    description:\n      'ContractSpec CLI for validation, scaffolding, and code generation',\n  },\n  {\n    name: 'typescript',\n    dev: true,\n    description: 'TypeScript compiler for type checking',\n  },\n];\n\n/**\n * Get dependencies for the specified mode.\n */\nexport function getDependencies(\n  mode: 'minimal' | 'full'\n): QuickstartDependency[] {\n  return mode === 'minimal' ? MINIMAL_DEPENDENCIES : FULL_DEPENDENCIES;\n}\n\n/**\n * Get production dependencies (non-dev).\n */\nexport function getProductionDependencies(\n  dependencies: QuickstartDependency[]\n): QuickstartDependency[] {\n  return dependencies.filter((dep) => !dep.dev);\n}\n\n/**\n * Get development dependencies.\n */\nexport function getDevDependencies(\n  dependencies: QuickstartDependency[]\n): QuickstartDependency[] {\n  return dependencies.filter((dep) => dep.dev);\n}\n"],"mappings":";;;;;;AAcA,MAAa,uBAA+C,CAC1D;CACE,MAAM;CACN,aACE;CACH,EACD;CACE,MAAM;CACN,aAAa;CACd,CACF;;;;;;AAOD,MAAa,oBAA4C;CAEvD,GAAG;CAEH;EACE,MAAM;EACN,aAAa;EACd;CAED;EACE,MAAM;EACN,KAAK;EACL,aACE;EACH;CACD;EACE,MAAM;EACN,KAAK;EACL,aAAa;EACd;CACF;;;;AAKD,SAAgB,gBACd,MACwB;AACxB,QAAO,SAAS,YAAY,uBAAuB;;;;;AAMrD,SAAgB,0BACd,cACwB;AACxB,QAAO,aAAa,QAAQ,QAAQ,CAAC,IAAI,IAAI;;;;;AAM/C,SAAgB,mBACd,cACwB;AACxB,QAAO,aAAa,QAAQ,QAAQ,IAAI,IAAI"}

package/dist/services/quickstart/index.mjs

@@ -0,0 +1,4 @@
+import { FULL_DEPENDENCIES, MINIMAL_DEPENDENCIES, getDependencies, getDevDependencies, getProductionDependencies } from "./dependencies.mjs";
+import { formatQuickstartPreview, isContractSpecInstalled, runQuickstart } from "./quickstart-service.mjs";
+
+export {  };

package/dist/services/quickstart/quickstart-service.d.mts

@@ -0,0 +1,20 @@
+import { FsAdapter } from "../../ports/fs.mjs";
+import { QuickstartOptions, QuickstartPromptCallbacks, QuickstartResult } from "./types.mjs";
+
+//#region src/services/quickstart/quickstart-service.d.ts
+
+/**
+ * Run the ContractSpec quickstart installation.
+ */
+declare function runQuickstart(fs: FsAdapter, options: QuickstartOptions, prompts?: QuickstartPromptCallbacks): Promise<QuickstartResult>;
+/**
+ * Check if ContractSpec is already set up in the workspace.
+ */
+declare function isContractSpecInstalled(fs: FsAdapter, workspaceRoot: string): Promise<boolean>;
+/**
+ * Get a summary of what would be installed.
+ */
+declare function formatQuickstartPreview(mode: 'minimal' | 'full'): string;
+//#endregion
+export { formatQuickstartPreview, isContractSpecInstalled, runQuickstart };
+//# sourceMappingURL=quickstart-service.d.mts.map

package/dist/services/quickstart/quickstart-service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart-service.d.mts","names":[],"sources":["../../../src/services/quickstart/quickstart-service.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAwQsB,iBA/NA,aAAA,CA+NuB,EAAA,EA9NvC,SA+NA,EAAA,OAEH,EAhOQ,iBAgOD,EAAA,OAAA,CAAA,EA/NC,yBA+ND,CAAA,EA9NP,OA8NO,CA9NC,gBA8ND,CAAA;AAwBV;;;iBA3BsB,uBAAA,KAChB,mCAEH;;;;iBAwBa,uBAAA"}

package/dist/services/quickstart/quickstart-service.mjs

@@ -0,0 +1,196 @@
+import { detectPackageManager, getInstallCommand } from "../../adapters/workspace.mjs";
+import { getDependencies, getDevDependencies, getProductionDependencies } from "./dependencies.mjs";
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+
+//#region src/services/quickstart/quickstart-service.ts
+/**
+* Quickstart service.
+*
+* Orchestrates the installation of minimal necessary packages
+* for ContractSpec to work across CLI, VS Code, and JetBrains.
+*/
+const execAsync = promisify(exec);
+/**
+* Default prompt callbacks that accept all defaults.
+*/
+const defaultPrompts = {
+	confirm: async () => true,
+	select: async (_msg, options) => options[0]?.value ?? ""
+};
+/**
+* Run the ContractSpec quickstart installation.
+*/
+async function runQuickstart(fs, options, prompts = defaultPrompts) {
+	const dependencies = getDependencies(options.mode);
+	const prodDeps = getProductionDependencies(dependencies);
+	const devDeps = getDevDependencies(dependencies);
+	const installed = [];
+	const skipped = [];
+	const errors = [];
+	const packageJsonPath = fs.join(options.workspaceRoot, "package.json");
+	if (!await fs.exists(packageJsonPath)) return {
+		success: false,
+		installed: [],
+		skipped: [],
+		errors: [{
+			name: "package.json",
+			action: "error",
+			message: "No package.json found. Run `npm init` first."
+		}],
+		summary: "No package.json found in workspace root."
+	};
+	const packageJsonContent = await fs.readFile(packageJsonPath);
+	const packageJson = JSON.parse(packageJsonContent);
+	const existingDeps = new Set([...Object.keys(packageJson.dependencies ?? {}), ...Object.keys(packageJson.devDependencies ?? {})]);
+	const packageManager = detectPackageManager(options.workspaceRoot);
+	const toInstallProd = prodDeps.filter((dep) => {
+		if (existingDeps.has(dep.name) && !options.force) {
+			skipped.push({
+				name: dep.name,
+				action: "skipped",
+				message: "Already installed",
+				dev: false
+			});
+			return false;
+		}
+		return true;
+	});
+	const toInstallDev = devDeps.filter((dep) => {
+		if (existingDeps.has(dep.name) && !options.force) {
+			skipped.push({
+				name: dep.name,
+				action: "skipped",
+				message: "Already installed",
+				dev: true
+			});
+			return false;
+		}
+		return true;
+	});
+	if (options.dryRun) {
+		const wouldInstall = [...toInstallProd, ...toInstallDev];
+		return {
+			success: true,
+			installed: wouldInstall.map((dep) => ({
+				name: dep.name,
+				action: "installed",
+				message: `Would install: ${dep.description}`,
+				dev: dep.dev
+			})),
+			skipped,
+			errors: [],
+			summary: `Dry run: would install ${wouldInstall.length} package(s), skip ${skipped.length}.`
+		};
+	}
+	if (!options.skipPrompts && (toInstallProd.length > 0 || toInstallDev.length > 0)) {
+		const total = toInstallProd.length + toInstallDev.length;
+		if (!await prompts.confirm(`Install ${total} package(s) using ${packageManager}?`)) return {
+			success: true,
+			installed: [],
+			skipped: [
+				...skipped,
+				...toInstallProd.map((d) => ({
+					name: d.name,
+					action: "skipped",
+					message: "User cancelled"
+				})),
+				...toInstallDev.map((d) => ({
+					name: d.name,
+					action: "skipped",
+					message: "User cancelled",
+					dev: true
+				}))
+			],
+			errors: [],
+			summary: "Installation cancelled by user."
+		};
+	}
+	if (toInstallProd.length > 0) {
+		const results = await installPackages(toInstallProd, packageManager, options.workspaceRoot, false);
+		for (const result of results) if (result.action === "installed") installed.push(result);
+		else errors.push(result);
+	}
+	if (toInstallDev.length > 0) {
+		const results = await installPackages(toInstallDev, packageManager, options.workspaceRoot, true);
+		for (const result of results) if (result.action === "installed") installed.push(result);
+		else errors.push(result);
+	}
+	const success = errors.length === 0;
+	return {
+		success,
+		installed,
+		skipped,
+		errors,
+		summary: success ? `Successfully installed ${installed.length} package(s), skipped ${skipped.length}.` : `Installed ${installed.length}, skipped ${skipped.length}, failed ${errors.length}.`
+	};
+}
+/**
+* Install a set of packages using the detected package manager.
+*/
+async function installPackages(dependencies, packageManager, cwd, isDev) {
+	const results = [];
+	const packageNames = dependencies.map((dep) => dep.version ? `${dep.name}@${dep.version}` : dep.name);
+	try {
+		await execAsync(`${getInstallCommand(packageManager, isDev)} ${packageNames.join(" ")}`, {
+			cwd,
+			timeout: 12e4
+		});
+		for (const dep of dependencies) results.push({
+			name: dep.name,
+			action: "installed",
+			message: dep.description,
+			dev: isDev
+		});
+	} catch (error) {
+		const msg = error instanceof Error ? error.message : String(error);
+		for (const dep of dependencies) results.push({
+			name: dep.name,
+			action: "error",
+			message: `Failed to install: ${msg}`,
+			dev: isDev
+		});
+	}
+	return results;
+}
+/**
+* Check if ContractSpec is already set up in the workspace.
+*/
+async function isContractSpecInstalled(fs, workspaceRoot) {
+	const packageJsonPath = fs.join(workspaceRoot, "package.json");
+	try {
+		const content = await fs.readFile(packageJsonPath);
+		const packageJson = JSON.parse(content);
+		return "@contractspec/lib.contracts" in {
+			...packageJson.dependencies,
+			...packageJson.devDependencies
+		};
+	} catch {
+		return false;
+	}
+}
+/**
+* Get a summary of what would be installed.
+*/
+function formatQuickstartPreview(mode) {
+	const deps = getDependencies(mode);
+	const lines = [];
+	lines.push(`ContractSpec ${mode} installation:`);
+	lines.push("");
+	const prodDeps = getProductionDependencies(deps);
+	if (prodDeps.length > 0) {
+		lines.push("Dependencies:");
+		for (const dep of prodDeps) lines.push(`  • ${dep.name} - ${dep.description}`);
+	}
+	const devDeps = getDevDependencies(deps);
+	if (devDeps.length > 0) {
+		lines.push("");
+		lines.push("Dev Dependencies:");
+		for (const dep of devDeps) lines.push(`  • ${dep.name} - ${dep.description}`);
+	}
+	return lines.join("\n");
+}
+
+//#endregion
+export { formatQuickstartPreview, isContractSpecInstalled, runQuickstart };
+//# sourceMappingURL=quickstart-service.mjs.map

package/dist/services/quickstart/quickstart-service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart-service.mjs","names":[],"sources":["../../../src/services/quickstart/quickstart-service.ts"],"sourcesContent":["/**\n * Quickstart service.\n *\n * Orchestrates the installation of minimal necessary packages\n * for ContractSpec to work across CLI, VS Code, and JetBrains.\n */\n\nimport { exec } from 'node:child_process';\nimport { promisify } from 'node:util';\nimport type { FsAdapter } from '../../ports/fs';\nimport type {\n  QuickstartOptions,\n  QuickstartResult,\n  QuickstartPromptCallbacks,\n  PackageInstallResult,\n  QuickstartDependency,\n} from './types';\nimport {\n  getDependencies,\n  getProductionDependencies,\n  getDevDependencies,\n} from './dependencies';\nimport {\n  detectPackageManager,\n  getInstallCommand,\n  type PackageManager,\n} from '../../adapters/workspace';\n\nconst execAsync = promisify(exec);\n\n/**\n * Default prompt callbacks that accept all defaults.\n */\nconst defaultPrompts: QuickstartPromptCallbacks = {\n  confirm: async () => true,\n  select: async (_msg, options) => options[0]?.value ?? ('' as never),\n};\n\n/**\n * Run the ContractSpec quickstart installation.\n */\nexport async function runQuickstart(\n  fs: FsAdapter,\n  options: QuickstartOptions,\n  prompts: QuickstartPromptCallbacks = defaultPrompts\n): Promise<QuickstartResult> {\n  const dependencies = getDependencies(options.mode);\n  const prodDeps = getProductionDependencies(dependencies);\n  const devDeps = getDevDependencies(dependencies);\n\n  const installed: PackageInstallResult[] = [];\n  const skipped: PackageInstallResult[] = [];\n  const errors: PackageInstallResult[] = [];\n\n  // Check if package.json exists\n  const packageJsonPath = fs.join(options.workspaceRoot, 'package.json');\n  const hasPackageJson = await fs.exists(packageJsonPath);\n\n  if (!hasPackageJson) {\n    return {\n      success: false,\n      installed: [],\n      skipped: [],\n      errors: [\n        {\n          name: 'package.json',\n          action: 'error',\n          message: 'No package.json found. Run `npm init` first.',\n        },\n      ],\n      summary: 'No package.json found in workspace root.',\n    };\n  }\n\n  // Read current package.json to check existing dependencies\n  const packageJsonContent = await fs.readFile(packageJsonPath);\n  const packageJson = JSON.parse(packageJsonContent) as {\n    dependencies?: Record<string, string>;\n    devDependencies?: Record<string, string>;\n  };\n\n  const existingDeps = new Set([\n    ...Object.keys(packageJson.dependencies ?? {}),\n    ...Object.keys(packageJson.devDependencies ?? {}),\n  ]);\n\n  // Detect package manager\n  const packageManager = detectPackageManager(options.workspaceRoot);\n\n  // Filter dependencies based on what's already installed\n  const toInstallProd = prodDeps.filter((dep) => {\n    if (existingDeps.has(dep.name) && !options.force) {\n      skipped.push({\n        name: dep.name,\n        action: 'skipped',\n        message: 'Already installed',\n        dev: false,\n      });\n      return false;\n    }\n    return true;\n  });\n\n  const toInstallDev = devDeps.filter((dep) => {\n    if (existingDeps.has(dep.name) && !options.force) {\n      skipped.push({\n        name: dep.name,\n        action: 'skipped',\n        message: 'Already installed',\n        dev: true,\n      });\n      return false;\n    }\n    return true;\n  });\n\n  // Dry run - just report what would be installed\n  if (options.dryRun) {\n    const wouldInstall = [...toInstallProd, ...toInstallDev];\n    return {\n      success: true,\n      installed: wouldInstall.map((dep) => ({\n        name: dep.name,\n        action: 'installed',\n        message: `Would install: ${dep.description}`,\n        dev: dep.dev,\n      })),\n      skipped,\n      errors: [],\n      summary: `Dry run: would install ${wouldInstall.length} package(s), skip ${skipped.length}.`,\n    };\n  }\n\n  // Confirm installation if interactive\n  if (\n    !options.skipPrompts &&\n    (toInstallProd.length > 0 || toInstallDev.length > 0)\n  ) {\n    const total = toInstallProd.length + toInstallDev.length;\n    const confirmed = await prompts.confirm(\n      `Install ${total} package(s) using ${packageManager}?`\n    );\n    if (!confirmed) {\n      return {\n        success: true,\n        installed: [],\n        skipped: [\n          ...skipped,\n          ...toInstallProd.map((d) => ({\n            name: d.name,\n            action: 'skipped' as const,\n            message: 'User cancelled',\n          })),\n          ...toInstallDev.map((d) => ({\n            name: d.name,\n            action: 'skipped' as const,\n            message: 'User cancelled',\n            dev: true,\n          })),\n        ],\n        errors: [],\n        summary: 'Installation cancelled by user.',\n      };\n    }\n  }\n\n  // Install production dependencies\n  if (toInstallProd.length > 0) {\n    const results = await installPackages(\n      toInstallProd,\n      packageManager,\n      options.workspaceRoot,\n      false\n    );\n    for (const result of results) {\n      if (result.action === 'installed') {\n        installed.push(result);\n      } else {\n        errors.push(result);\n      }\n    }\n  }\n\n  // Install dev dependencies\n  if (toInstallDev.length > 0) {\n    const results = await installPackages(\n      toInstallDev,\n      packageManager,\n      options.workspaceRoot,\n      true\n    );\n    for (const result of results) {\n      if (result.action === 'installed') {\n        installed.push(result);\n      } else {\n        errors.push(result);\n      }\n    }\n  }\n\n  const success = errors.length === 0;\n  const summary = success\n    ? `Successfully installed ${installed.length} package(s), skipped ${skipped.length}.`\n    : `Installed ${installed.length}, skipped ${skipped.length}, failed ${errors.length}.`;\n\n  return {\n    success,\n    installed,\n    skipped,\n    errors,\n    summary,\n  };\n}\n\n/**\n * Install a set of packages using the detected package manager.\n */\nasync function installPackages(\n  dependencies: QuickstartDependency[],\n  packageManager: PackageManager,\n  cwd: string,\n  isDev: boolean\n): Promise<PackageInstallResult[]> {\n  const results: PackageInstallResult[] = [];\n  const packageNames = dependencies.map((dep) =>\n    dep.version ? `${dep.name}@${dep.version}` : dep.name\n  );\n\n  try {\n    const baseCommand = getInstallCommand(packageManager, isDev);\n    const command = `${baseCommand} ${packageNames.join(' ')}`;\n\n    await execAsync(command, {\n      cwd,\n      timeout: 120000, // 2 minutes timeout\n    });\n\n    // All packages installed successfully\n    for (const dep of dependencies) {\n      results.push({\n        name: dep.name,\n        action: 'installed',\n        message: dep.description,\n        dev: isDev,\n      });\n    }\n  } catch (error) {\n    const msg = error instanceof Error ? error.message : String(error);\n    for (const dep of dependencies) {\n      results.push({\n        name: dep.name,\n        action: 'error',\n        message: `Failed to install: ${msg}`,\n        dev: isDev,\n      });\n    }\n  }\n\n  return results;\n}\n\n/**\n * Check if ContractSpec is already set up in the workspace.\n */\nexport async function isContractSpecInstalled(\n  fs: FsAdapter,\n  workspaceRoot: string\n): Promise<boolean> {\n  const packageJsonPath = fs.join(workspaceRoot, 'package.json');\n\n  try {\n    const content = await fs.readFile(packageJsonPath);\n    const packageJson = JSON.parse(content) as {\n      dependencies?: Record<string, string>;\n      devDependencies?: Record<string, string>;\n    };\n\n    const allDeps = {\n      ...packageJson.dependencies,\n      ...packageJson.devDependencies,\n    };\n\n    return '@contractspec/lib.contracts' in allDeps;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Get a summary of what would be installed.\n */\nexport function formatQuickstartPreview(mode: 'minimal' | 'full'): string {\n  const deps = getDependencies(mode);\n  const lines: string[] = [];\n\n  lines.push(`ContractSpec ${mode} installation:`);\n  lines.push('');\n\n  const prodDeps = getProductionDependencies(deps);\n  if (prodDeps.length > 0) {\n    lines.push('Dependencies:');\n    for (const dep of prodDeps) {\n      lines.push(`  • ${dep.name} - ${dep.description}`);\n    }\n  }\n\n  const devDeps = getDevDependencies(deps);\n  if (devDeps.length > 0) {\n    lines.push('');\n    lines.push('Dev Dependencies:');\n    for (const dep of devDeps) {\n      lines.push(`  • ${dep.name} - ${dep.description}`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n"],"mappings":"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"}

package/dist/services/quickstart/types.d.mts

@@ -0,0 +1,81 @@
+//#region src/services/quickstart/types.d.ts
+/**
+ * Quickstart service types.
+ *
+ * Type definitions for the ContractSpec quickstart installation feature.
+ */
+/**
+ * Installation mode for quickstart.
+ */
+type QuickstartMode = 'minimal' | 'full';
+/**
+ * A dependency to install during quickstart.
+ */
+interface QuickstartDependency {
+  /** Package name (e.g., '@contractspec/lib.contracts') */
+  name: string;
+  /** Specific version or latest if not specified */
+  version?: string;
+  /** Whether this is a dev dependency */
+  dev?: boolean;
+  /** Whether this dependency is optional */
+  optional?: boolean;
+  /** Human-readable description */
+  description: string;
+}
+/**
+ * Options for running quickstart.
+ */
+interface QuickstartOptions {
+  /** Workspace root directory */
+  workspaceRoot: string;
+  /** Installation mode */
+  mode: QuickstartMode;
+  /** Dry run - show what would be installed without installing */
+  dryRun?: boolean;
+  /** Skip interactive prompts */
+  skipPrompts?: boolean;
+  /** Force reinstall even if packages exist */
+  force?: boolean;
+  /** Verbose output */
+  verbose?: boolean;
+}
+/**
+ * Result of a single package installation.
+ */
+interface PackageInstallResult {
+  name: string;
+  action: 'installed' | 'skipped' | 'error';
+  message: string;
+  dev?: boolean;
+}
+/**
+ * Result of the quickstart operation.
+ */
+interface QuickstartResult {
+  /** Whether the operation was successful overall */
+  success: boolean;
+  /** Packages that were installed */
+  installed: PackageInstallResult[];
+  /** Packages that were skipped (already installed) */
+  skipped: PackageInstallResult[];
+  /** Packages that failed to install */
+  errors: PackageInstallResult[];
+  /** Summary message */
+  summary: string;
+}
+/**
+ * Prompt callbacks for interactive quickstart.
+ */
+interface QuickstartPromptCallbacks {
+  /** Confirm a yes/no question */
+  confirm: (message: string) => Promise<boolean>;
+  /** Select from a list of options */
+  select: <T extends string>(message: string, options: {
+    value: T;
+    label: string;
+  }[]) => Promise<T>;
+}
+//#endregion
+export { PackageInstallResult, QuickstartDependency, QuickstartMode, QuickstartOptions, QuickstartPromptCallbacks, QuickstartResult };
+//# sourceMappingURL=types.d.mts.map

package/dist/services/quickstart/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/services/quickstart/types.ts"],"sourcesContent":[],"mappings":";;AASA;AAKA;AAgBA;AAkBA;AAUA;;;AAQU,KAzDE,cAAA,GAyDF,SAAA,GAAA,MAAA;;AAQV;;AAMsB,UAlEL,oBAAA,CAkEK;EACP;EAAR,IAAA,EAAA,MAAA;EAAO;;;;;;;;;;;;UAnDG,iBAAA;;;;QAIT;;;;;;;;;;;;;UAcS,oBAAA;;;;;;;;;UAUA,gBAAA;;;;aAIJ;;WAEF;;UAED;;;;;;;UAQO,yBAAA;;gCAEe;;;WAIV;;UACf,QAAQ"}

package/dist/services/regenerator.d.mts

@@ -0,0 +1,18 @@
+import { RegeneratorService } from "@contractspec/lib.contracts/regenerator";
+import { ProposalSink, RegenerationContext, RegenerationRule } from "@contractspec/lib.contracts/regenerator/types";
+import { SignalAdapters } from "@contractspec/lib.contracts/regenerator/adapters";
+
+//#region src/services/regenerator.d.ts
+
+interface CreateRegeneratorOptions {
+  contexts: RegenerationContext[];
+  rules: RegenerationRule[];
+  sink: ProposalSink;
+  adapters?: SignalAdapters;
+  pollIntervalMs?: number;
+  batchDurationMs?: number;
+}
+declare function createRegeneratorService(options: CreateRegeneratorOptions): RegeneratorService;
+//#endregion
+export { CreateRegeneratorOptions, createRegeneratorService };
+//# sourceMappingURL=regenerator.d.mts.map

package/dist/services/regenerator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regenerator.d.mts","names":[],"sources":["../../src/services/regenerator.ts"],"sourcesContent":[],"mappings":";;;;;;AAmBa,UAJI,wBAAA,CAIJ;EAAc,QAAA,EAHf,mBAGe,EAAA;EAKX,KAAA,EAPP,gBAOO,EAAA;QANR;aACK;;;;iBAKG,wBAAA,UACL,2BACR"}

package/dist/services/regenerator.mjs

@@ -0,0 +1,23 @@
+import { RegeneratorService } from "@contractspec/lib.contracts/regenerator";
+
+//#region src/services/regenerator.ts
+/**
+* Regenerator service.
+*
+* Thin wrapper around `@contractspec/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 };
+//# sourceMappingURL=regenerator.mjs.map

package/dist/services/regenerator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"regenerator.mjs","names":[],"sources":["../../src/services/regenerator.ts"],"sourcesContent":["/**\n * Regenerator service.\n *\n * Thin wrapper around `@contractspec/lib.contracts/regenerator` for reuse across CLI/VSCode/web.\n * This service does not perform module loading; callers provide resolved contexts/rules/sink.\n */\n\nimport { RegeneratorService } from '@contractspec/lib.contracts/regenerator';\nimport type {\n  ProposalSink,\n  RegenerationContext,\n  RegenerationRule,\n} from '@contractspec/lib.contracts/regenerator/types';\nimport type { SignalAdapters } from '@contractspec/lib.contracts/regenerator/adapters';\n\nexport interface CreateRegeneratorOptions {\n  contexts: RegenerationContext[];\n  rules: RegenerationRule[];\n  sink: ProposalSink;\n  adapters?: SignalAdapters;\n  pollIntervalMs?: number;\n  batchDurationMs?: number;\n}\n\nexport function createRegeneratorService(\n  options: CreateRegeneratorOptions\n): RegeneratorService {\n  return new RegeneratorService({\n    contexts: options.contexts,\n    adapters: options.adapters ?? {},\n    rules: options.rules,\n    sink: options.sink,\n    pollIntervalMs: options.pollIntervalMs,\n    batchDurationMs: options.batchDurationMs,\n  });\n}\n"],"mappings":";;;;;;;;;AAwBA,SAAgB,yBACd,SACoB;AACpB,QAAO,IAAI,mBAAmB;EAC5B,UAAU,QAAQ;EAClB,UAAU,QAAQ,YAAY,EAAE;EAChC,OAAO,QAAQ;EACf,MAAM,QAAQ;EACd,gBAAgB,QAAQ;EACxB,iBAAiB,QAAQ;EAC1B,CAAC"}