@contractspec/bundle.workspace 1.45.4 → 1.45.5

package/dist/services/hooks/hooks-service.js

@@ -0,0 +1,126 @@
+import { findWorkspaceRoot } from "../../adapters/workspace.js";
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+
+//#region src/services/hooks/hooks-service.ts
+/**
+* Hooks service.
+*
+* Runs git hook checks configured in .contractsrc.json.
+* This service is platform-agnostic and can be used by CLI, VSCode, or other apps.
+*
+* @module services/hooks
+*/
+const execAsync = promisify(exec);
+/**
+* Run a configured git hook.
+*
+* Note: Uses node:child_process for compatibility with VSCode (Node.js) and CLI (Bun).
+* Although Bun shell ($) is preferred for scripts, this shared bundle must support both runtimes.
+*/
+async function runHook(adapters, options) {
+	const { fs, logger } = adapters;
+	const { hookName, dryRun = false } = options;
+	const workspaceRoot = findWorkspaceRoot(options.workspaceRoot);
+	logger.info(`Running hook: ${hookName}`, {
+		workspaceRoot,
+		dryRun
+	});
+	const hooksConfig = await loadHooksConfig(fs, workspaceRoot);
+	if (!hooksConfig) return {
+		hookName,
+		success: false,
+		commandResults: [],
+		totalCommands: 0,
+		successfulCommands: 0,
+		summary: "No hooks configuration found in .contractsrc.json"
+	};
+	const commands = hooksConfig[hookName];
+	if (!commands || commands.length === 0) return {
+		hookName,
+		success: true,
+		commandResults: [],
+		totalCommands: 0,
+		successfulCommands: 0,
+		summary: `No commands configured for hook: ${hookName}`
+	};
+	logger.info(`Found ${commands.length} command(s) for ${hookName}`);
+	const commandResults = [];
+	let allSuccess = true;
+	for (const command of commands) {
+		if (dryRun) {
+			logger.info(`[DRY RUN] Would execute: ${command}`);
+			commandResults.push({
+				command,
+				success: true,
+				exitCode: 0,
+				stdout: "",
+				stderr: ""
+			});
+			continue;
+		}
+		logger.info(`Executing: ${command}`);
+		try {
+			const { stdout, stderr } = await execAsync(command, {
+				cwd: workspaceRoot,
+				timeout: 3e5
+			});
+			commandResults.push({
+				command,
+				success: true,
+				exitCode: 0,
+				stdout,
+				stderr
+			});
+			logger.info(`✓ ${command}`);
+		} catch (error) {
+			allSuccess = false;
+			const execError = error;
+			commandResults.push({
+				command,
+				success: false,
+				exitCode: execError.code ?? 1,
+				stdout: execError.stdout ?? "",
+				stderr: execError.stderr ?? execError.message ?? String(error)
+			});
+			logger.error(`✗ ${command}`, {
+				exitCode: execError.code,
+				stderr: execError.stderr
+			});
+			break;
+		}
+	}
+	const successfulCommands = commandResults.filter((r) => r.success).length;
+	return {
+		hookName,
+		success: allSuccess,
+		commandResults,
+		totalCommands: commands.length,
+		successfulCommands,
+		summary: allSuccess ? `✓ All ${commands.length} command(s) passed` : `✗ ${successfulCommands}/${commands.length} command(s) passed`
+	};
+}
+/**
+* Get available hooks from configuration.
+*/
+async function getAvailableHooks(adapters, workspaceRoot) {
+	const hooksConfig = await loadHooksConfig(adapters.fs, workspaceRoot);
+	return hooksConfig ? Object.keys(hooksConfig) : [];
+}
+/**
+* Load hooks configuration from .contractsrc.json.
+*/
+async function loadHooksConfig(fs, workspaceRoot) {
+	const configPath = fs.join(workspaceRoot, ".contractsrc.json");
+	if (!await fs.exists(configPath)) return null;
+	try {
+		const content = await fs.readFile(configPath);
+		return JSON.parse(content).hooks ?? null;
+	} catch {
+		return null;
+	}
+}
+
+//#endregion
+export { getAvailableHooks, runHook };
+//# sourceMappingURL=hooks-service.js.map

package/dist/services/hooks/hooks-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-service.js","names":["commandResults: HookCommandResult[]"],"sources":["../../../src/services/hooks/hooks-service.ts"],"sourcesContent":["/**\n * Hooks service.\n *\n * Runs git hook checks configured in .contractsrc.json.\n * This service is platform-agnostic and can be used by CLI, VSCode, or other apps.\n *\n * @module services/hooks\n */\n\nimport { exec } from 'node:child_process';\nimport { promisify } from 'node:util';\nimport type { FsAdapter } from '../../ports/fs';\nimport type { LoggerAdapter } from '../../ports/logger';\nimport { findWorkspaceRoot } from '../../adapters/workspace';\nimport type {\n  HookRunOptions,\n  HookRunResult,\n  HookCommandResult,\n  HooksConfig,\n} from './types';\n\nconst execAsync = promisify(exec);\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Adapters Type\n// ─────────────────────────────────────────────────────────────────────────────\n\ninterface ServiceAdapters {\n  fs: FsAdapter;\n  logger: LoggerAdapter;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Run Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Run a configured git hook.\n *\n * Note: Uses node:child_process for compatibility with VSCode (Node.js) and CLI (Bun).\n * Although Bun shell ($) is preferred for scripts, this shared bundle must support both runtimes.\n */\nexport async function runHook(\n  adapters: ServiceAdapters,\n  options: HookRunOptions\n): Promise<HookRunResult> {\n  const { fs, logger } = adapters;\n  const { hookName, dryRun = false } = options;\n  const workspaceRoot = findWorkspaceRoot(options.workspaceRoot);\n\n  logger.info(`Running hook: ${hookName}`, { workspaceRoot, dryRun });\n\n  // Load hooks config\n  const hooksConfig = await loadHooksConfig(fs, workspaceRoot);\n\n  if (!hooksConfig) {\n    return {\n      hookName,\n      success: false,\n      commandResults: [],\n      totalCommands: 0,\n      successfulCommands: 0,\n      summary: 'No hooks configuration found in .contractsrc.json',\n    };\n  }\n\n  const commands = hooksConfig[hookName];\n\n  if (!commands || commands.length === 0) {\n    return {\n      hookName,\n      success: true,\n      commandResults: [],\n      totalCommands: 0,\n      successfulCommands: 0,\n      summary: `No commands configured for hook: ${hookName}`,\n    };\n  }\n\n  logger.info(`Found ${commands.length} command(s) for ${hookName}`);\n\n  const commandResults: HookCommandResult[] = [];\n  let allSuccess = true;\n\n  for (const command of commands) {\n    if (dryRun) {\n      logger.info(`[DRY RUN] Would execute: ${command}`);\n      commandResults.push({\n        command,\n        success: true,\n        exitCode: 0,\n        stdout: '',\n        stderr: '',\n      });\n      continue;\n    }\n\n    logger.info(`Executing: ${command}`);\n\n    try {\n      const { stdout, stderr } = await execAsync(command, {\n        cwd: workspaceRoot,\n        timeout: 300_000, // 5 minute timeout\n      });\n\n      commandResults.push({\n        command,\n        success: true,\n        exitCode: 0,\n        stdout,\n        stderr,\n      });\n\n      logger.info(`✓ ${command}`);\n    } catch (error) {\n      allSuccess = false;\n\n      const execError = error as {\n        code?: number;\n        stdout?: string;\n        stderr?: string;\n        message?: string;\n      };\n\n      commandResults.push({\n        command,\n        success: false,\n        exitCode: execError.code ?? 1,\n        stdout: execError.stdout ?? '',\n        stderr: execError.stderr ?? execError.message ?? String(error),\n      });\n\n      logger.error(`✗ ${command}`, {\n        exitCode: execError.code,\n        stderr: execError.stderr,\n      });\n\n      // Stop on first failure\n      break;\n    }\n  }\n\n  const successfulCommands = commandResults.filter((r) => r.success).length;\n\n  return {\n    hookName,\n    success: allSuccess,\n    commandResults,\n    totalCommands: commands.length,\n    successfulCommands,\n    summary: allSuccess\n      ? `✓ All ${commands.length} command(s) passed`\n      : `✗ ${successfulCommands}/${commands.length} command(s) passed`,\n  };\n}\n\n/**\n * Get available hooks from configuration.\n */\nexport async function getAvailableHooks(\n  adapters: ServiceAdapters,\n  workspaceRoot: string\n): Promise<string[]> {\n  const hooksConfig = await loadHooksConfig(adapters.fs, workspaceRoot);\n  return hooksConfig ? Object.keys(hooksConfig) : [];\n}\n\n/**\n * Load hooks configuration from .contractsrc.json.\n */\nasync function loadHooksConfig(\n  fs: FsAdapter,\n  workspaceRoot: string\n): Promise<HooksConfig | null> {\n  const configPath = fs.join(workspaceRoot, '.contractsrc.json');\n\n  if (!(await fs.exists(configPath))) {\n    return null;\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    const config = JSON.parse(content) as { hooks?: HooksConfig };\n    return config.hooks ?? null;\n  } catch {\n    return null;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAqBA,MAAM,YAAY,UAAU,KAAK;;;;;;;AAqBjC,eAAsB,QACpB,UACA,SACwB;CACxB,MAAM,EAAE,IAAI,WAAW;CACvB,MAAM,EAAE,UAAU,SAAS,UAAU;CACrC,MAAM,gBAAgB,kBAAkB,QAAQ,cAAc;AAE9D,QAAO,KAAK,iBAAiB,YAAY;EAAE;EAAe;EAAQ,CAAC;CAGnE,MAAM,cAAc,MAAM,gBAAgB,IAAI,cAAc;AAE5D,KAAI,CAAC,YACH,QAAO;EACL;EACA,SAAS;EACT,gBAAgB,EAAE;EAClB,eAAe;EACf,oBAAoB;EACpB,SAAS;EACV;CAGH,MAAM,WAAW,YAAY;AAE7B,KAAI,CAAC,YAAY,SAAS,WAAW,EACnC,QAAO;EACL;EACA,SAAS;EACT,gBAAgB,EAAE;EAClB,eAAe;EACf,oBAAoB;EACpB,SAAS,oCAAoC;EAC9C;AAGH,QAAO,KAAK,SAAS,SAAS,OAAO,kBAAkB,WAAW;CAElE,MAAMA,iBAAsC,EAAE;CAC9C,IAAI,aAAa;AAEjB,MAAK,MAAM,WAAW,UAAU;AAC9B,MAAI,QAAQ;AACV,UAAO,KAAK,4BAA4B,UAAU;AAClD,kBAAe,KAAK;IAClB;IACA,SAAS;IACT,UAAU;IACV,QAAQ;IACR,QAAQ;IACT,CAAC;AACF;;AAGF,SAAO,KAAK,cAAc,UAAU;AAEpC,MAAI;GACF,MAAM,EAAE,QAAQ,WAAW,MAAM,UAAU,SAAS;IAClD,KAAK;IACL,SAAS;IACV,CAAC;AAEF,kBAAe,KAAK;IAClB;IACA,SAAS;IACT,UAAU;IACV;IACA;IACD,CAAC;AAEF,UAAO,KAAK,KAAK,UAAU;WACpB,OAAO;AACd,gBAAa;GAEb,MAAM,YAAY;AAOlB,kBAAe,KAAK;IAClB;IACA,SAAS;IACT,UAAU,UAAU,QAAQ;IAC5B,QAAQ,UAAU,UAAU;IAC5B,QAAQ,UAAU,UAAU,UAAU,WAAW,OAAO,MAAM;IAC/D,CAAC;AAEF,UAAO,MAAM,KAAK,WAAW;IAC3B,UAAU,UAAU;IACpB,QAAQ,UAAU;IACnB,CAAC;AAGF;;;CAIJ,MAAM,qBAAqB,eAAe,QAAQ,MAAM,EAAE,QAAQ,CAAC;AAEnE,QAAO;EACL;EACA,SAAS;EACT;EACA,eAAe,SAAS;EACxB;EACA,SAAS,aACL,SAAS,SAAS,OAAO,sBACzB,KAAK,mBAAmB,GAAG,SAAS,OAAO;EAChD;;;;;AAMH,eAAsB,kBACpB,UACA,eACmB;CACnB,MAAM,cAAc,MAAM,gBAAgB,SAAS,IAAI,cAAc;AACrE,QAAO,cAAc,OAAO,KAAK,YAAY,GAAG,EAAE;;;;;AAMpD,eAAe,gBACb,IACA,eAC6B;CAC7B,MAAM,aAAa,GAAG,KAAK,eAAe,oBAAoB;AAE9D,KAAI,CAAE,MAAM,GAAG,OAAO,WAAW,CAC/B,QAAO;AAGT,KAAI;EACF,MAAM,UAAU,MAAM,GAAG,SAAS,WAAW;AAE7C,SADe,KAAK,MAAM,QAAQ,CACpB,SAAS;SACjB;AACN,SAAO"}

package/dist/services/hooks/index.d.ts

@@ -0,0 +1,10 @@
+import { HookCommandResult, HookRunOptions, HookRunResult, HooksConfig } from "./types.js";
+import { getAvailableHooks, runHook } from "./hooks-service.js";
+
+//#region src/services/hooks/index.d.ts
+declare namespace index_d_exports {
+  export { HookCommandResult, HookRunOptions, HookRunResult, HooksConfig, getAvailableHooks, runHook };
+}
+//#endregion
+export { index_d_exports };
+//# sourceMappingURL=index.d.ts.map

package/dist/services/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/services/hooks/index.ts"],"sourcesContent":[],"mappings":""}

package/dist/services/hooks/index.js

@@ -0,0 +1,12 @@
+import { __exportAll } from "../../_virtual/rolldown_runtime.js";
+import { getAvailableHooks, runHook } from "./hooks-service.js";
+
+//#region src/services/hooks/index.ts
+var hooks_exports = /* @__PURE__ */ __exportAll({
+	getAvailableHooks: () => getAvailableHooks,
+	runHook: () => runHook
+});
+
+//#endregion
+export { hooks_exports };
+//# sourceMappingURL=index.js.map

package/dist/services/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/services/hooks/index.ts"],"sourcesContent":["/**\n * Hooks service module.\n *\n * Provides hook execution for git hooks configured in .contractsrc.json.\n */\n\nexport * from './types';\nexport { runHook, getAvailableHooks } from './hooks-service';\n"],"mappings":""}

package/dist/services/hooks/types.d.ts

@@ -0,0 +1,56 @@
+//#region src/services/hooks/types.d.ts
+/**
+ * Hooks service types.
+ *
+ * Types for running git hook checks configured in .contractsrc.json.
+ */
+/**
+ * Options for running hooks.
+ */
+interface HookRunOptions {
+  /** Name of the hook to run (e.g., 'pre-commit'). */
+  hookName: string;
+  /** Workspace root directory. */
+  workspaceRoot: string;
+  /** If true, show commands without executing. */
+  dryRun?: boolean;
+}
+/**
+ * Result of a single command execution.
+ */
+interface HookCommandResult {
+  /** The command that was executed. */
+  command: string;
+  /** Whether the command succeeded. */
+  success: boolean;
+  /** Exit code. */
+  exitCode: number;
+  /** stdout output. */
+  stdout: string;
+  /** stderr output. */
+  stderr: string;
+}
+/**
+ * Result of running a hook.
+ */
+interface HookRunResult {
+  /** Hook name that was run. */
+  hookName: string;
+  /** Whether all commands succeeded. */
+  success: boolean;
+  /** Results for each command. */
+  commandResults: HookCommandResult[];
+  /** Total commands executed. */
+  totalCommands: number;
+  /** Number of successful commands. */
+  successfulCommands: number;
+  /** Summary message. */
+  summary: string;
+}
+/**
+ * Hooks configuration from .contractsrc.json.
+ */
+type HooksConfig = Record<string, string[]>;
+//#endregion
+export { HookCommandResult, HookRunOptions, HookRunResult, HooksConfig };
+//# sourceMappingURL=types.d.ts.map

package/dist/services/hooks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/services/hooks/types.ts"],"sourcesContent":[],"mappings":";;AASA;AAYA;AAgBA;AAkBA;;;;UA9CiB,cAAA;;;;;;;;;;;UAYA,iBAAA;;;;;;;;;;;;;;;UAgBA,aAAA;;;;;;kBAMC;;;;;;;;;;;KAYN,WAAA,GAAc"}

package/dist/services/index.d.ts

@@ -84,4 +84,7 @@ import { DocsServiceOptions, DocsServiceResult, generateDocsFromSpecs } from "./
 import "./docs/index.js";
 import { index_d_exports } from "./impact/index.js";
 import { FormatterOptions, formatFiles } from "./formatter.js";
-import { index_d_exports as index_d_exports$1 } from "./versioning/index.js";
+import { SpecVersionAnalysis } from "./versioning/types.js";
+import { index_d_exports as index_d_exports$1 } from "./versioning/index.js";
+import { index_d_exports as index_d_exports$2 } from "./upgrade/index.js";
+import { index_d_exports as index_d_exports$3 } from "./hooks/index.js";

package/dist/services/index.js

@@ -82,3 +82,5 @@ import "./docs/index.js";
 import { impact_exports } from "./impact/index.js";
 import { formatFiles } from "./formatter.js";
 import { versioning_exports } from "./versioning/index.js";
+import { upgrade_exports } from "./upgrade/index.js";
+import { hooks_exports } from "./hooks/index.js";

package/dist/services/setup/config-generators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-generators.d.ts","names":[],"sources":["../../../src/services/setup/config-generators.ts"],"sourcesContent":[],"mappings":";;;;AA0EA;AAgBA;AAwEA;AA4GA;;iBAjQgB,yBAAA,UAAmC;;;;iBA8BnC,sBAAA,CAAA;;;;iBAgBA,uBAAA,CAAA;;;;;iBAeA,uBAAA,CAAA;;;;;;iBAgBA,mBAAA,UAA6B;;;;;;iBAwE7B,gBAAA,UAA0B;;;;iBA4G1B,0BAAA,CAAA"}
+{"version":3,"file":"config-generators.d.ts","names":[],"sources":["../../../src/services/setup/config-generators.ts"],"sourcesContent":[],"mappings":";;;;AA2FA;AAgBA;AAwEA;AA4GA;;iBAlRgB,yBAAA,UAAmC;;;;iBA+CnC,sBAAA,CAAA;;;;iBAgBA,uBAAA,CAAA;;;;;iBAeA,uBAAA,CAAA;;;;;;iBAgBA,mBAAA,UAA6B;;;;;;iBAwE7B,gBAAA,UAA0B;;;;iBA4G1B,0BAAA,CAAA"}

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

@@ -21,6 +21,20 @@ function generateContractsrcConfig(options) {
 		},
 		defaultOwners: options.defaultOwners ?? ["@team"],
 		defaultTags: [],
+		versioning: {
+			autoBump: false,
+			bumpStrategy: "impact",
+			changelogTiers: [
+				"spec",
+				"library",
+				"monorepo"
+			],
+			format: "keep-a-changelog",
+			commitChanges: false,
+			createTags: false,
+			integrateWithChangesets: true
+		},
+		hooks: { "pre-commit": ["contractspec validate **/*.operation.ts", "contractspec integrity check"] },
 		...isPackageLevel && options.packageName ? { package: options.packageName } : {}
 	};
 }

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

@@ -1 +1 @@
-{"version":3,"file":"config-generators.js","names":[],"sources":["../../../src/services/setup/config-generators.ts"],"sourcesContent":["/**\n * Config generators for setup targets.\n *\n * Each generator returns the default configuration for a target.\n */\n\nimport type { SetupOptions } from './types';\n\n/**\n * Generate .contractsrc.json content.\n *\n * Adapts defaults based on monorepo scope.\n */\nexport function generateContractsrcConfig(options: SetupOptions): object {\n  // For package-level config in monorepo, use simpler relative paths\n  const isPackageLevel = options.isMonorepo && options.scope === 'package';\n\n  return {\n    $schema: 'https://api.contractspec.io/schemas/contractsrc.json',\n    aiProvider: 'claude',\n    aiModel: 'claude-sonnet-4-20250514',\n    agentMode: 'claude-code',\n    // outputDir is relative to the config file location\n    outputDir: './src',\n    conventions: {\n      operations: 'contracts/operations',\n      events: 'contracts/events',\n      presentations: 'contracts/presentations',\n      forms: 'contracts/forms',\n      features: 'contracts/features',\n    },\n    defaultOwners: options.defaultOwners ?? ['@team'],\n    defaultTags: [],\n    // Add monorepo hint if at package level\n    ...(isPackageLevel && options.packageName\n      ? { package: options.packageName }\n      : {}),\n  };\n}\n\n/**\n * Generate .vscode/settings.json ContractSpec settings.\n */\nexport function generateVscodeSettings(): object {\n  return {\n    'contractspec.validation.enabled': true,\n    'contractspec.validation.validateOnSave': true,\n    'contractspec.validation.validateOnOpen': true,\n    'contractspec.codeLens.enabled': true,\n    'contractspec.diagnostics.showWarnings': true,\n    'contractspec.diagnostics.showHints': true,\n    'contractspec.integrity.enabled': true,\n    'contractspec.integrity.checkOnSave': true,\n  };\n}\n\n/**\n * Generate .cursor/mcp.json content.\n */\nexport function generateCursorMcpConfig(): object {\n  return {\n    mcpServers: {\n      'contractspec-local': {\n        command: 'bunx',\n        args: ['contractspec-mcp'],\n      },\n    },\n  };\n}\n\n/**\n * Generate Claude Desktop MCP config.\n * Returns the mcpServers section to merge into claude_desktop_config.json.\n */\nexport function generateClaudeMcpConfig(): object {\n  return {\n    mcpServers: {\n      'contractspec-local': {\n        command: 'bunx',\n        args: ['contractspec-mcp'],\n      },\n    },\n  };\n}\n\n/**\n * Generate .cursor/rules/contractspec.mdc content.\n *\n * Adapts paths based on monorepo scope.\n */\nexport function generateCursorRules(options: SetupOptions): string {\n  const projectName = options.projectName ?? 'this project';\n  const isPackageLevel = options.isMonorepo && options.scope === 'package';\n\n  // Base contract path depends on scope\n  const basePath =\n    isPackageLevel && options.packageRoot\n      ? `${options.packageRoot.split('/').slice(-2).join('/')}/src/contracts`\n      : 'src/contracts';\n\n  const monorepoNote = options.isMonorepo\n    ? `\\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`\n    : '';\n\n  return `# ContractSpec Development Rules\n\nThis project uses ContractSpec for spec-first development. Follow these guidelines when working with AI agents.\n\n## Spec-First Principle\n\n- **Always update contracts first** before changing implementation code.\n- Contracts are the source of truth for operations, events, and presentations.\n- Implementation code should be generated or derived from contracts.\n${monorepoNote}\n## Contract Locations\n\nContracts are located in:\n- \\`${basePath}/operations/\\` - Command and query specs\n- \\`${basePath}/events/\\` - Event specs\n- \\`${basePath}/presentations/\\` - UI presentation specs\n- \\`${basePath}/features/\\` - Feature module specs\n\n## When Making Changes\n\n1. **Before coding**: Check if a contract exists for the feature.\n2. **If contract exists**: Update the contract first, then regenerate code.\n3. **If no contract**: Create a new contract using \\`contractspec create\\`.\n4. **After changes**: Validate with \\`contractspec validate\\`.\n\n## Key Commands\n\n- \\`contractspec create\\` - Scaffold new specs\n- \\`contractspec validate\\` - Validate specs\n- \\`contractspec build\\` - Generate implementation code\n- \\`contractspec integrity\\` - Check contract health\n\n## Contract Structure\n\nOperations follow this pattern:\n\\`\\`\\`typescript\ndefineCommand({\n  meta: { name: 'service.action', version: '1.0.0', ... },\n  io: { input: InputSchema, output: OutputSchema },\n  policy: { auth: 'user', ... },\n  handler: async (args, ctx) => { ... }\n});\n\\`\\`\\`\n\n## Rules for ${projectName}\n\n- All API endpoints must have a corresponding operation contract.\n- Events must be declared in contracts before being emitted.\n- UI components should reference presentation contracts.\n- Feature flags should be defined in feature modules.\n`;\n}\n\n/**\n * Generate AGENTS.md content.\n *\n * Adapts paths and instructions based on monorepo scope.\n */\nexport function generateAgentsMd(options: SetupOptions): string {\n  const projectName = options.projectName ?? 'This Project';\n  const isPackageLevel = options.isMonorepo && options.scope === 'package';\n\n  // Contract path depends on scope\n  const contractPath = 'src/contracts/';\n\n  const monorepoSection = options.isMonorepo\n    ? `\n## Monorepo Structure\n\nThis is a monorepo. Contracts can exist at multiple levels:\n\n| Level | Location | Use Case |\n|-------|----------|----------|\n| Package | \\`packages/*/src/contracts/\\` | Package-specific contracts |\n| Workspace | \\`src/contracts/\\` | Shared cross-package contracts |\n\nWhen adding a contract, consider:\n- Is this specific to one package? → Add at package level\n- Is this shared across packages? → Add at workspace level\n\n### Current Scope\n\n${isPackageLevel ? `You are working at the **package level**: \\`${options.packageName ?? options.packageRoot}\\`` : 'You are working at the **workspace level**.'}\n`\n    : '';\n\n  return `# AI Agent Guide\n\nThis repository uses **ContractSpec** for spec-first development. AI agents should follow these guidelines.\n\n## Project: ${projectName}\n\n## ContractSpec Overview\n\nContractSpec is a deterministic, spec-first compiler that keeps AI-written software coherent, safe, and regenerable.\n\n### Key Principles\n\n1. **Contracts are the source of truth** - Always check/update contracts before modifying implementation.\n2. **Safe regeneration** - Code can be regenerated from specs without breaking invariants.\n3. **Multi-surface consistency** - API, events, and UI stay in sync via shared contracts.\n${monorepoSection}\n## Working in This Repository\n\n### Before Making Changes\n\n1. Check for existing contracts in \\`${contractPath}\\`\n2. If a contract exists, update it first\n3. Regenerate implementation with \\`contractspec build\\`\n4. Validate with \\`contractspec validate\\`\n\n### Creating New Features\n\n1. Create a feature spec: \\`contractspec create --type=feature\\`\n2. Add operations: \\`contractspec create --type=operation\\`\n3. Add events if needed: \\`contractspec create --type=event\\`\n4. Build implementation: \\`contractspec build\\`\n\n### Contract Locations\n\n| Type | Location |\n|------|----------|\n| Operations | \\`${contractPath}operations/\\` |\n| Events | \\`${contractPath}events/\\` |\n| Presentations | \\`${contractPath}presentations/\\` |\n| Features | \\`${contractPath}features/\\` |\n\n## MCP Tools Available\n\nThe ContractSpec MCP server provides these tools:\n\n- \\`integrity.analyze\\` - Check contract health\n- \\`specs.list\\` - List all specs\n- \\`specs.validate\\` - Validate a spec file\n- \\`specs.create\\` - Create new specs\n- \\`deps.analyze\\` - Analyze dependencies\n\n## Common Tasks\n\n### Add a new API endpoint\n\n\\`\\`\\`bash\ncontractspec create --type=operation --name=myService.newAction\n\\`\\`\\`\n\n### Add a new event\n\n\\`\\`\\`bash\ncontractspec create --type=event --name=entity.changed\n\\`\\`\\`\n\n### Check contract integrity\n\n\\`\\`\\`bash\ncontractspec integrity\n\\`\\`\\`\n\n## Nested AGENTS.md\n\nMore specific instructions may exist in subdirectories. Check for \\`AGENTS.md\\` files in the relevant package or module.\n`;\n}\n\n/**\n * Get the file path for Claude Desktop config based on platform.\n */\nexport function getClaudeDesktopConfigPath(): string {\n  const platform = process.platform;\n  const homeDir = process.env['HOME'] ?? process.env['USERPROFILE'] ?? '';\n\n  switch (platform) {\n    case 'darwin':\n      return `${homeDir}/Library/Application Support/Claude/claude_desktop_config.json`;\n    case 'win32':\n      return `${process.env['APPDATA'] ?? homeDir}/Claude/claude_desktop_config.json`;\n    default:\n      // Linux and others\n      return `${homeDir}/.config/claude/claude_desktop_config.json`;\n  }\n}\n"],"mappings":";;;;;;AAaA,SAAgB,0BAA0B,SAA+B;CAEvE,MAAM,iBAAiB,QAAQ,cAAc,QAAQ,UAAU;AAE/D,QAAO;EACL,SAAS;EACT,YAAY;EACZ,SAAS;EACT,WAAW;EAEX,WAAW;EACX,aAAa;GACX,YAAY;GACZ,QAAQ;GACR,eAAe;GACf,OAAO;GACP,UAAU;GACX;EACD,eAAe,QAAQ,iBAAiB,CAAC,QAAQ;EACjD,aAAa,EAAE;EAEf,GAAI,kBAAkB,QAAQ,cAC1B,EAAE,SAAS,QAAQ,aAAa,GAChC,EAAE;EACP;;;;;AAMH,SAAgB,yBAAiC;AAC/C,QAAO;EACL,mCAAmC;EACnC,0CAA0C;EAC1C,0CAA0C;EAC1C,iCAAiC;EACjC,yCAAyC;EACzC,sCAAsC;EACtC,kCAAkC;EAClC,sCAAsC;EACvC;;;;;AAMH,SAAgB,0BAAkC;AAChD,QAAO,EACL,YAAY,EACV,sBAAsB;EACpB,SAAS;EACT,MAAM,CAAC,mBAAmB;EAC3B,EACF,EACF;;;;;;AAOH,SAAgB,0BAAkC;AAChD,QAAO,EACL,YAAY,EACV,sBAAsB;EACpB,SAAS;EACT,MAAM,CAAC,mBAAmB;EAC3B,EACF,EACF;;;;;;;AAQH,SAAgB,oBAAoB,SAA+B;CACjE,MAAM,cAAc,QAAQ,eAAe;CAI3C,MAAM,WAHiB,QAAQ,cAAc,QAAQ,UAAU,aAI3C,QAAQ,cACtB,GAAG,QAAQ,YAAY,MAAM,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,IAAI,CAAC,kBACtD;AAMN,QAAO;;;;;;;;;EAJc,QAAQ,aACzB,+NACA,GAWS;;;;MAIT,SAAS;MACT,SAAS;MACT,SAAS;MACT,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA4BA,YAAY;;;;;;;;;;;;;AAc3B,SAAgB,iBAAiB,SAA+B;CAC9D,MAAM,cAAc,QAAQ,eAAe;CAC3C,MAAM,iBAAiB,QAAQ,cAAc,QAAQ,UAAU;CAG/D,MAAM,eAAe;AAuBrB,QAAO;;;;cAIK,YAAY;;;;;;;;;;;EAzBA,QAAQ,aAC5B;;;;;;;;;;;;;;;;EAgBJ,iBAAiB,+CAA+C,QAAQ,eAAe,QAAQ,YAAY,MAAM,8CAA8C;IAE3J,GAiBY;;;;;uCAKqB,aAAa;;;;;;;;;;;;;;;;mBAgBjC,aAAa;eACjB,aAAa;sBACN,aAAa;iBAClB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyC9B,SAAgB,6BAAqC;CACnD,MAAM,WAAW,QAAQ;CACzB,MAAM,UAAU,QAAQ,IAAI,WAAW,QAAQ,IAAI,kBAAkB;AAErE,SAAQ,UAAR;EACE,KAAK,SACH,QAAO,GAAG,QAAQ;EACpB,KAAK,QACH,QAAO,GAAG,QAAQ,IAAI,cAAc,QAAQ;EAC9C,QAEE,QAAO,GAAG,QAAQ"}
+{"version":3,"file":"config-generators.js","names":[],"sources":["../../../src/services/setup/config-generators.ts"],"sourcesContent":["/**\n * Config generators for setup targets.\n *\n * Each generator returns the default configuration for a target.\n */\n\nimport type { SetupOptions } from './types';\n\n/**\n * Generate .contractsrc.json content.\n *\n * Adapts defaults based on monorepo scope.\n */\nexport function generateContractsrcConfig(options: SetupOptions): object {\n  // For package-level config in monorepo, use simpler relative paths\n  const isPackageLevel = options.isMonorepo && options.scope === 'package';\n\n  return {\n    $schema: 'https://api.contractspec.io/schemas/contractsrc.json',\n    aiProvider: 'claude',\n    aiModel: 'claude-sonnet-4-20250514',\n    agentMode: 'claude-code',\n    // outputDir is relative to the config file location\n    outputDir: './src',\n    conventions: {\n      operations: 'contracts/operations',\n      events: 'contracts/events',\n      presentations: 'contracts/presentations',\n      forms: 'contracts/forms',\n      features: 'contracts/features',\n    },\n    defaultOwners: options.defaultOwners ?? ['@team'],\n    defaultTags: [],\n    // Versioning configuration\n    versioning: {\n      autoBump: false,\n      bumpStrategy: 'impact',\n      changelogTiers: ['spec', 'library', 'monorepo'],\n      format: 'keep-a-changelog',\n      commitChanges: false,\n      createTags: false,\n      integrateWithChangesets: true, // Enable changesets integration by default\n    },\n    // Git hooks configuration (Husky compatible)\n    hooks: {\n      'pre-commit': [\n        'contractspec validate **/*.operation.ts',\n        'contractspec integrity check',\n      ],\n    },\n    // Add monorepo hint if at package level\n    ...(isPackageLevel && options.packageName\n      ? { package: options.packageName }\n      : {}),\n  };\n}\n\n/**\n * Generate .vscode/settings.json ContractSpec settings.\n */\nexport function generateVscodeSettings(): object {\n  return {\n    'contractspec.validation.enabled': true,\n    'contractspec.validation.validateOnSave': true,\n    'contractspec.validation.validateOnOpen': true,\n    'contractspec.codeLens.enabled': true,\n    'contractspec.diagnostics.showWarnings': true,\n    'contractspec.diagnostics.showHints': true,\n    'contractspec.integrity.enabled': true,\n    'contractspec.integrity.checkOnSave': true,\n  };\n}\n\n/**\n * Generate .cursor/mcp.json content.\n */\nexport function generateCursorMcpConfig(): object {\n  return {\n    mcpServers: {\n      'contractspec-local': {\n        command: 'bunx',\n        args: ['contractspec-mcp'],\n      },\n    },\n  };\n}\n\n/**\n * Generate Claude Desktop MCP config.\n * Returns the mcpServers section to merge into claude_desktop_config.json.\n */\nexport function generateClaudeMcpConfig(): object {\n  return {\n    mcpServers: {\n      'contractspec-local': {\n        command: 'bunx',\n        args: ['contractspec-mcp'],\n      },\n    },\n  };\n}\n\n/**\n * Generate .cursor/rules/contractspec.mdc content.\n *\n * Adapts paths based on monorepo scope.\n */\nexport function generateCursorRules(options: SetupOptions): string {\n  const projectName = options.projectName ?? 'this project';\n  const isPackageLevel = options.isMonorepo && options.scope === 'package';\n\n  // Base contract path depends on scope\n  const basePath =\n    isPackageLevel && options.packageRoot\n      ? `${options.packageRoot.split('/').slice(-2).join('/')}/src/contracts`\n      : 'src/contracts';\n\n  const monorepoNote = options.isMonorepo\n    ? `\\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`\n    : '';\n\n  return `# ContractSpec Development Rules\n\nThis project uses ContractSpec for spec-first development. Follow these guidelines when working with AI agents.\n\n## Spec-First Principle\n\n- **Always update contracts first** before changing implementation code.\n- Contracts are the source of truth for operations, events, and presentations.\n- Implementation code should be generated or derived from contracts.\n${monorepoNote}\n## Contract Locations\n\nContracts are located in:\n- \\`${basePath}/operations/\\` - Command and query specs\n- \\`${basePath}/events/\\` - Event specs\n- \\`${basePath}/presentations/\\` - UI presentation specs\n- \\`${basePath}/features/\\` - Feature module specs\n\n## When Making Changes\n\n1. **Before coding**: Check if a contract exists for the feature.\n2. **If contract exists**: Update the contract first, then regenerate code.\n3. **If no contract**: Create a new contract using \\`contractspec create\\`.\n4. **After changes**: Validate with \\`contractspec validate\\`.\n\n## Key Commands\n\n- \\`contractspec create\\` - Scaffold new specs\n- \\`contractspec validate\\` - Validate specs\n- \\`contractspec build\\` - Generate implementation code\n- \\`contractspec integrity\\` - Check contract health\n\n## Contract Structure\n\nOperations follow this pattern:\n\\`\\`\\`typescript\ndefineCommand({\n  meta: { name: 'service.action', version: '1.0.0', ... },\n  io: { input: InputSchema, output: OutputSchema },\n  policy: { auth: 'user', ... },\n  handler: async (args, ctx) => { ... }\n});\n\\`\\`\\`\n\n## Rules for ${projectName}\n\n- All API endpoints must have a corresponding operation contract.\n- Events must be declared in contracts before being emitted.\n- UI components should reference presentation contracts.\n- Feature flags should be defined in feature modules.\n`;\n}\n\n/**\n * Generate AGENTS.md content.\n *\n * Adapts paths and instructions based on monorepo scope.\n */\nexport function generateAgentsMd(options: SetupOptions): string {\n  const projectName = options.projectName ?? 'This Project';\n  const isPackageLevel = options.isMonorepo && options.scope === 'package';\n\n  // Contract path depends on scope\n  const contractPath = 'src/contracts/';\n\n  const monorepoSection = options.isMonorepo\n    ? `\n## Monorepo Structure\n\nThis is a monorepo. Contracts can exist at multiple levels:\n\n| Level | Location | Use Case |\n|-------|----------|----------|\n| Package | \\`packages/*/src/contracts/\\` | Package-specific contracts |\n| Workspace | \\`src/contracts/\\` | Shared cross-package contracts |\n\nWhen adding a contract, consider:\n- Is this specific to one package? → Add at package level\n- Is this shared across packages? → Add at workspace level\n\n### Current Scope\n\n${isPackageLevel ? `You are working at the **package level**: \\`${options.packageName ?? options.packageRoot}\\`` : 'You are working at the **workspace level**.'}\n`\n    : '';\n\n  return `# AI Agent Guide\n\nThis repository uses **ContractSpec** for spec-first development. AI agents should follow these guidelines.\n\n## Project: ${projectName}\n\n## ContractSpec Overview\n\nContractSpec is a deterministic, spec-first compiler that keeps AI-written software coherent, safe, and regenerable.\n\n### Key Principles\n\n1. **Contracts are the source of truth** - Always check/update contracts before modifying implementation.\n2. **Safe regeneration** - Code can be regenerated from specs without breaking invariants.\n3. **Multi-surface consistency** - API, events, and UI stay in sync via shared contracts.\n${monorepoSection}\n## Working in This Repository\n\n### Before Making Changes\n\n1. Check for existing contracts in \\`${contractPath}\\`\n2. If a contract exists, update it first\n3. Regenerate implementation with \\`contractspec build\\`\n4. Validate with \\`contractspec validate\\`\n\n### Creating New Features\n\n1. Create a feature spec: \\`contractspec create --type=feature\\`\n2. Add operations: \\`contractspec create --type=operation\\`\n3. Add events if needed: \\`contractspec create --type=event\\`\n4. Build implementation: \\`contractspec build\\`\n\n### Contract Locations\n\n| Type | Location |\n|------|----------|\n| Operations | \\`${contractPath}operations/\\` |\n| Events | \\`${contractPath}events/\\` |\n| Presentations | \\`${contractPath}presentations/\\` |\n| Features | \\`${contractPath}features/\\` |\n\n## MCP Tools Available\n\nThe ContractSpec MCP server provides these tools:\n\n- \\`integrity.analyze\\` - Check contract health\n- \\`specs.list\\` - List all specs\n- \\`specs.validate\\` - Validate a spec file\n- \\`specs.create\\` - Create new specs\n- \\`deps.analyze\\` - Analyze dependencies\n\n## Common Tasks\n\n### Add a new API endpoint\n\n\\`\\`\\`bash\ncontractspec create --type=operation --name=myService.newAction\n\\`\\`\\`\n\n### Add a new event\n\n\\`\\`\\`bash\ncontractspec create --type=event --name=entity.changed\n\\`\\`\\`\n\n### Check contract integrity\n\n\\`\\`\\`bash\ncontractspec integrity\n\\`\\`\\`\n\n## Nested AGENTS.md\n\nMore specific instructions may exist in subdirectories. Check for \\`AGENTS.md\\` files in the relevant package or module.\n`;\n}\n\n/**\n * Get the file path for Claude Desktop config based on platform.\n */\nexport function getClaudeDesktopConfigPath(): string {\n  const platform = process.platform;\n  const homeDir = process.env['HOME'] ?? process.env['USERPROFILE'] ?? '';\n\n  switch (platform) {\n    case 'darwin':\n      return `${homeDir}/Library/Application Support/Claude/claude_desktop_config.json`;\n    case 'win32':\n      return `${process.env['APPDATA'] ?? homeDir}/Claude/claude_desktop_config.json`;\n    default:\n      // Linux and others\n      return `${homeDir}/.config/claude/claude_desktop_config.json`;\n  }\n}\n"],"mappings":";;;;;;AAaA,SAAgB,0BAA0B,SAA+B;CAEvE,MAAM,iBAAiB,QAAQ,cAAc,QAAQ,UAAU;AAE/D,QAAO;EACL,SAAS;EACT,YAAY;EACZ,SAAS;EACT,WAAW;EAEX,WAAW;EACX,aAAa;GACX,YAAY;GACZ,QAAQ;GACR,eAAe;GACf,OAAO;GACP,UAAU;GACX;EACD,eAAe,QAAQ,iBAAiB,CAAC,QAAQ;EACjD,aAAa,EAAE;EAEf,YAAY;GACV,UAAU;GACV,cAAc;GACd,gBAAgB;IAAC;IAAQ;IAAW;IAAW;GAC/C,QAAQ;GACR,eAAe;GACf,YAAY;GACZ,yBAAyB;GAC1B;EAED,OAAO,EACL,cAAc,CACZ,2CACA,+BACD,EACF;EAED,GAAI,kBAAkB,QAAQ,cAC1B,EAAE,SAAS,QAAQ,aAAa,GAChC,EAAE;EACP;;;;;AAMH,SAAgB,yBAAiC;AAC/C,QAAO;EACL,mCAAmC;EACnC,0CAA0C;EAC1C,0CAA0C;EAC1C,iCAAiC;EACjC,yCAAyC;EACzC,sCAAsC;EACtC,kCAAkC;EAClC,sCAAsC;EACvC;;;;;AAMH,SAAgB,0BAAkC;AAChD,QAAO,EACL,YAAY,EACV,sBAAsB;EACpB,SAAS;EACT,MAAM,CAAC,mBAAmB;EAC3B,EACF,EACF;;;;;;AAOH,SAAgB,0BAAkC;AAChD,QAAO,EACL,YAAY,EACV,sBAAsB;EACpB,SAAS;EACT,MAAM,CAAC,mBAAmB;EAC3B,EACF,EACF;;;;;;;AAQH,SAAgB,oBAAoB,SAA+B;CACjE,MAAM,cAAc,QAAQ,eAAe;CAI3C,MAAM,WAHiB,QAAQ,cAAc,QAAQ,UAAU,aAI3C,QAAQ,cACtB,GAAG,QAAQ,YAAY,MAAM,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,IAAI,CAAC,kBACtD;AAMN,QAAO;;;;;;;;;EAJc,QAAQ,aACzB,+NACA,GAWS;;;;MAIT,SAAS;MACT,SAAS;MACT,SAAS;MACT,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA4BA,YAAY;;;;;;;;;;;;;AAc3B,SAAgB,iBAAiB,SAA+B;CAC9D,MAAM,cAAc,QAAQ,eAAe;CAC3C,MAAM,iBAAiB,QAAQ,cAAc,QAAQ,UAAU;CAG/D,MAAM,eAAe;AAuBrB,QAAO;;;;cAIK,YAAY;;;;;;;;;;;EAzBA,QAAQ,aAC5B;;;;;;;;;;;;;;;;EAgBJ,iBAAiB,+CAA+C,QAAQ,eAAe,QAAQ,YAAY,MAAM,8CAA8C;IAE3J,GAiBY;;;;;uCAKqB,aAAa;;;;;;;;;;;;;;;;mBAgBjC,aAAa;eACjB,aAAa;sBACN,aAAa;iBAClB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyC9B,SAAgB,6BAAqC;CACnD,MAAM,WAAW,QAAQ;CACzB,MAAM,UAAU,QAAQ,IAAI,WAAW,QAAQ,IAAI,kBAAkB;AAErE,SAAQ,UAAR;EACE,KAAK,SACH,QAAO,GAAG,QAAQ;EACpB,KAAK,QACH,QAAO,GAAG,QAAQ,IAAI,cAAc,QAAQ;EAC9C,QAEE,QAAO,GAAG,QAAQ"}

package/dist/services/upgrade/index.d.ts

@@ -0,0 +1,10 @@
+import { ConfigUpgradeInfo, PackageUpgradeInfo, UpgradeAnalysisResult, UpgradeApplyResult, UpgradeOptions } from "./types.js";
+import { analyzeUpgrades, applyConfigUpgrades, getDefaultHooksConfig, getDefaultVersioningConfig, getPackageUpgradeCommand } from "./upgrade-service.js";
+
+//#region src/services/upgrade/index.d.ts
+declare namespace index_d_exports {
+  export { ConfigUpgradeInfo, PackageUpgradeInfo, UpgradeAnalysisResult, UpgradeApplyResult, UpgradeOptions, analyzeUpgrades, applyConfigUpgrades, getDefaultHooksConfig, getDefaultVersioningConfig, getPackageUpgradeCommand };
+}
+//#endregion
+export { index_d_exports };
+//# sourceMappingURL=index.d.ts.map

package/dist/services/upgrade/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/services/upgrade/index.ts"],"sourcesContent":[],"mappings":""}

package/dist/services/upgrade/index.js

@@ -0,0 +1,15 @@
+import { __exportAll } from "../../_virtual/rolldown_runtime.js";
+import { analyzeUpgrades, applyConfigUpgrades, getDefaultHooksConfig, getDefaultVersioningConfig, getPackageUpgradeCommand } from "./upgrade-service.js";
+
+//#region src/services/upgrade/index.ts
+var upgrade_exports = /* @__PURE__ */ __exportAll({
+	analyzeUpgrades: () => analyzeUpgrades,
+	applyConfigUpgrades: () => applyConfigUpgrades,
+	getDefaultHooksConfig: () => getDefaultHooksConfig,
+	getDefaultVersioningConfig: () => getDefaultVersioningConfig,
+	getPackageUpgradeCommand: () => getPackageUpgradeCommand
+});
+
+//#endregion
+export { upgrade_exports };
+//# sourceMappingURL=index.js.map

package/dist/services/upgrade/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/services/upgrade/index.ts"],"sourcesContent":["/**\n * Upgrade service module.\n *\n * Provides upgrade analysis and application for ContractSpec SDK and config.\n */\n\nexport * from './types';\nexport {\n  analyzeUpgrades,\n  applyConfigUpgrades,\n  getPackageUpgradeCommand,\n  getDefaultVersioningConfig,\n  getDefaultHooksConfig,\n} from './upgrade-service';\n"],"mappings":""}

package/dist/services/upgrade/types.d.ts

@@ -0,0 +1,78 @@
+//#region src/services/upgrade/types.d.ts
+/**
+ * Upgrade service types.
+ *
+ * Types for upgrading ContractSpec SDK and configuration.
+ */
+/**
+ * Options for running an upgrade.
+ */
+interface UpgradeOptions {
+  /** Root directory of the workspace. */
+  workspaceRoot: string;
+  /** Upgrade SDK packages. */
+  upgradePackages?: boolean;
+  /** Upgrade configuration. */
+  upgradeConfig?: boolean;
+  /** Preview changes without applying. */
+  dryRun?: boolean;
+  /** Use @latest tag instead of caret range. */
+  useLatest?: boolean;
+}
+/**
+ * Result of a package upgrade check.
+ */
+interface PackageUpgradeInfo {
+  /** Package name. */
+  name: string;
+  /** Current version. */
+  currentVersion: string;
+  /** Latest available version (if known). */
+  latestVersion?: string;
+  /** Whether this is a dev dependency. */
+  isDevDependency: boolean;
+}
+/**
+ * Result of a config upgrade check.
+ */
+interface ConfigUpgradeInfo {
+  /** Config key that needs upgrading. */
+  key: string;
+  /** Current value (if any). */
+  currentValue?: unknown;
+  /** Suggested new value. */
+  suggestedValue: unknown;
+  /** Whether this is a new key. */
+  isNew: boolean;
+}
+/**
+ * Result of the upgrade analysis.
+ */
+interface UpgradeAnalysisResult {
+  /** Detected package manager. */
+  packageManager: string;
+  /** Packages that can be upgraded. */
+  packages: PackageUpgradeInfo[];
+  /** Config sections that need upgrading. */
+  configUpgrades: ConfigUpgradeInfo[];
+  /** Whether any upgrades are available. */
+  hasUpgrades: boolean;
+}
+/**
+ * Result of applying an upgrade.
+ */
+interface UpgradeApplyResult {
+  /** Whether the upgrade was successful. */
+  success: boolean;
+  /** Number of packages upgraded. */
+  packagesUpgraded: number;
+  /** Number of config sections upgraded. */
+  configSectionsUpgraded: number;
+  /** Error message if failed. */
+  error?: string;
+  /** Summary message. */
+  summary: string;
+}
+//#endregion
+export { ConfigUpgradeInfo, PackageUpgradeInfo, UpgradeAnalysisResult, UpgradeApplyResult, UpgradeOptions };
+//# sourceMappingURL=types.d.ts.map

package/dist/services/upgrade/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/services/upgrade/types.ts"],"sourcesContent":[],"mappings":";;AAaA;AAgBA;AAcA;AAcA;AAcA;;;UA1DiB,cAAA;;;;;;;;;;;;;;;UAgBA,kBAAA;;;;;;;;;;;;;UAcA,iBAAA;;;;;;;;;;;;;UAcA,qBAAA;;;;YAIL;;kBAEM;;;;;;;UAQD,kBAAA"}

package/dist/services/upgrade/upgrade-service.d.ts

@@ -0,0 +1,38 @@
+import { FsAdapter } from "../../ports/fs.js";
+import { LoggerAdapter } from "../../ports/logger.js";
+import { PackageUpgradeInfo, UpgradeAnalysisResult, UpgradeApplyResult, UpgradeOptions } from "./types.js";
+
+//#region src/services/upgrade/upgrade-service.d.ts
+
+interface ServiceAdapters {
+  fs: FsAdapter;
+  logger: LoggerAdapter;
+}
+/**
+ * Analyze what upgrades are available.
+ */
+declare function analyzeUpgrades(adapters: ServiceAdapters, options: UpgradeOptions): Promise<UpgradeAnalysisResult>;
+/**
+ * Apply configuration upgrades.
+ *
+ * Note: Package upgrades must be applied by the app layer (CLI, VSCode)
+ * since they require running npm/bun/yarn commands which is platform-specific.
+ */
+declare function applyConfigUpgrades(adapters: ServiceAdapters, options: UpgradeOptions): Promise<UpgradeApplyResult>;
+/**
+ * Get the command to upgrade packages.
+ *
+ * Returns the shell command string that the app layer should execute.
+ */
+declare function getPackageUpgradeCommand(packageManager: string, packages: PackageUpgradeInfo[], useLatest: boolean): string;
+/**
+ * Get default versioning configuration.
+ */
+declare function getDefaultVersioningConfig(): Record<string, unknown>;
+/**
+ * Get default hooks configuration.
+ */
+declare function getDefaultHooksConfig(): Record<string, string[]>;
+//#endregion
+export { analyzeUpgrades, applyConfigUpgrades, getDefaultHooksConfig, getDefaultVersioningConfig, getPackageUpgradeCommand };
+//# sourceMappingURL=upgrade-service.d.ts.map

package/dist/services/upgrade/upgrade-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-service.d.ts","names":[],"sources":["../../../src/services/upgrade/upgrade-service.ts"],"sourcesContent":[],"mappings":";;;;;;UAmCU,eAAA,CAeA;EAoJY,EAAA,EAlKhB,SAkKgB;EACV,MAAA,EAlKF,aAkKE;;;;;AA4FI,iBApPM,eAAA,CAoPkB,QAE5B,EArPA,eAqPkB,EAAA,OAAA,EApPnB,cAoPmB,CAAA,EAnP3B,OAmP2B,CAnPnB,qBAmPmB,CAAA;AA0B9B;AAeA;;;;;iBAxIsB,mBAAA,WACV,0BACD,iBACR,QAAQ;;;;;;iBA0FK,wBAAA,mCAEJ;;;;iBA0BI,0BAAA,CAAA,GAA8B;;;;iBAe9B,qBAAA,CAAA,GAAyB"}