@contractspec/bundle.workspace 1.45.4 → 1.45.6

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"}

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

@@ -0,0 +1,201 @@
+import { detectPackageManager, findWorkspaceRoot } from "../../adapters/workspace.js";
+
+//#region src/services/upgrade/upgrade-service.ts
+const LATEST_SCHEMA_URL = `https://${process.env["CONTRACTSPEC_API_HOST"] ?? "api.contractspec.io"}/schemas/contractsrc.json`;
+/**
+* Analyze what upgrades are available.
+*/
+async function analyzeUpgrades(adapters, options) {
+	const { fs, logger } = adapters;
+	const workspaceRoot = findWorkspaceRoot(options.workspaceRoot);
+	const packageManager = detectPackageManager(workspaceRoot);
+	logger.info("Analyzing available upgrades...", {
+		workspaceRoot,
+		packageManager
+	});
+	const packages = await analyzePackages(fs, workspaceRoot);
+	const configUpgrades = await analyzeConfig(fs, workspaceRoot);
+	return {
+		packageManager,
+		packages,
+		configUpgrades,
+		hasUpgrades: packages.length > 0 || configUpgrades.length > 0
+	};
+}
+/**
+* Analyze installed packages for potential updates.
+* Checks for all packages in the workspace that match ContractSpec patterns.
+*/
+async function analyzePackages(fs, workspaceRoot) {
+	const packageJsonPath = fs.join(workspaceRoot, "package.json");
+	if (!await fs.exists(packageJsonPath)) return [];
+	try {
+		const content = await fs.readFile(packageJsonPath);
+		const packageJson = JSON.parse(content);
+		const deps = packageJson.dependencies ?? {};
+		const devDeps = packageJson.devDependencies ?? {};
+		const packages = [];
+		const allDeps = {
+			...deps,
+			...devDeps
+		};
+		for (const [name, version] of Object.entries(allDeps)) if (name.startsWith("@contractspec/") || name === "contractspec" || name.startsWith("@lssm/")) packages.push({
+			name,
+			currentVersion: version,
+			isDevDependency: !!devDeps[name]
+		});
+		return packages;
+	} catch {
+		return [];
+	}
+}
+/**
+* Analyze configuration for upgrade opportunities.
+*/
+async function analyzeConfig(fs, workspaceRoot) {
+	const configPath = fs.join(workspaceRoot, ".contractsrc.json");
+	if (!await fs.exists(configPath)) return [];
+	try {
+		const content = await fs.readFile(configPath);
+		const config = JSON.parse(content);
+		const upgrades = [];
+		const currentSchema = config["$schema"];
+		if (!currentSchema || currentSchema !== LATEST_SCHEMA_URL) upgrades.push({
+			key: "$schema",
+			currentValue: currentSchema,
+			suggestedValue: LATEST_SCHEMA_URL,
+			isNew: !currentSchema
+		});
+		if (!config["versioning"]) upgrades.push({
+			key: "versioning",
+			currentValue: void 0,
+			suggestedValue: getDefaultVersioningConfig(),
+			isNew: true
+		});
+		else if (config["versioning"]["integrateWithChangesets"] === void 0) upgrades.push({
+			key: "versioning.integrateWithChangesets",
+			currentValue: void 0,
+			suggestedValue: false,
+			isNew: true
+		});
+		if (!config["hooks"]) upgrades.push({
+			key: "hooks",
+			currentValue: void 0,
+			suggestedValue: getDefaultHooksConfig(),
+			isNew: true
+		});
+		return upgrades;
+	} catch {
+		return [];
+	}
+}
+/**
+* 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.
+*/
+async function applyConfigUpgrades(adapters, options) {
+	const { fs, logger } = adapters;
+	const workspaceRoot = findWorkspaceRoot(options.workspaceRoot);
+	if (options.dryRun) logger.info("Dry run - no changes will be made");
+	const configPath = fs.join(workspaceRoot, ".contractsrc.json");
+	if (!await fs.exists(configPath)) return {
+		success: false,
+		packagesUpgraded: 0,
+		configSectionsUpgraded: 0,
+		error: "No .contractsrc.json found",
+		summary: "No configuration file to upgrade"
+	};
+	try {
+		const content = await fs.readFile(configPath);
+		const config = JSON.parse(content);
+		let sectionsUpgraded = 0;
+		const currentSchema = config["$schema"];
+		if (!currentSchema || currentSchema !== LATEST_SCHEMA_URL) {
+			config["$schema"] = LATEST_SCHEMA_URL;
+			sectionsUpgraded++;
+		}
+		if (!config["versioning"]) {
+			config["versioning"] = getDefaultVersioningConfig();
+			sectionsUpgraded++;
+		} else {
+			const versioning = config["versioning"];
+			if (versioning["integrateWithChangesets"] === void 0) {
+				versioning["integrateWithChangesets"] = false;
+				sectionsUpgraded++;
+			}
+		}
+		if (!config["hooks"]) {
+			config["hooks"] = getDefaultHooksConfig();
+			sectionsUpgraded++;
+		}
+		if (sectionsUpgraded === 0) return {
+			success: true,
+			packagesUpgraded: 0,
+			configSectionsUpgraded: 0,
+			summary: "Configuration is already up to date"
+		};
+		if (!options.dryRun) {
+			await fs.writeFile(configPath, JSON.stringify(config, null, 2) + "\n");
+			logger.info("Configuration upgraded", { sectionsUpgraded });
+		}
+		return {
+			success: true,
+			packagesUpgraded: 0,
+			configSectionsUpgraded: sectionsUpgraded,
+			summary: options.dryRun ? `Would upgrade ${sectionsUpgraded} config section(s)` : `Upgraded ${sectionsUpgraded} config section(s)`
+		};
+	} catch (error) {
+		const msg = error instanceof Error ? error.message : String(error);
+		return {
+			success: false,
+			packagesUpgraded: 0,
+			configSectionsUpgraded: 0,
+			error: msg,
+			summary: `Failed to upgrade config: ${msg}`
+		};
+	}
+}
+/**
+* Get the command to upgrade packages.
+*
+* Returns the shell command string that the app layer should execute.
+*/
+function getPackageUpgradeCommand(packageManager, packages, useLatest) {
+	const pkgList = useLatest ? packages.map((p) => `${p.name}@latest`).join(" ") : packages.map((p) => p.name).join(" ");
+	switch (packageManager) {
+		case "bun": return `bun add ${pkgList}`;
+		case "pnpm": return `pnpm add ${pkgList}`;
+		case "yarn": return `yarn add ${pkgList}`;
+		default: return `npm install ${pkgList}`;
+	}
+}
+/**
+* Get default versioning configuration.
+*/
+function getDefaultVersioningConfig() {
+	return {
+		autoBump: false,
+		bumpStrategy: "impact",
+		changelogTiers: [
+			"spec",
+			"library",
+			"monorepo"
+		],
+		format: "keep-a-changelog",
+		commitChanges: false,
+		createTags: false,
+		integrateWithChangesets: true
+	};
+}
+/**
+* Get default hooks configuration.
+*/
+function getDefaultHooksConfig() {
+	return { "pre-commit": ["contractspec validate", "contractspec integrity check"] };
+}
+
+//#endregion
+export { analyzeUpgrades, applyConfigUpgrades, getDefaultHooksConfig, getDefaultVersioningConfig, getPackageUpgradeCommand };
+//# sourceMappingURL=upgrade-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-service.js","names":["packages: PackageUpgradeInfo[]","upgrades: ConfigUpgradeInfo[]"],"sources":["../../../src/services/upgrade/upgrade-service.ts"],"sourcesContent":["/**\n * Upgrade service.\n *\n * Analyzes and applies upgrades to ContractSpec SDK packages and configuration.\n * This service is platform-agnostic and can be used by CLI, VSCode, or other apps.\n *\n * @module services/upgrade\n */\n\nimport type { FsAdapter } from '../../ports/fs';\nimport type { LoggerAdapter } from '../../ports/logger';\nimport {\n  detectPackageManager,\n  findWorkspaceRoot,\n} from '../../adapters/workspace';\nimport type {\n  UpgradeOptions,\n  UpgradeAnalysisResult,\n  UpgradeApplyResult,\n  PackageUpgradeInfo,\n  ConfigUpgradeInfo,\n} from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Constants\n// ─────────────────────────────────────────────────────────────────────────────\n\n/** Latest schema URL. */\nconst API_HOST = process.env['CONTRACTSPEC_API_HOST'] ?? 'api.contractspec.io';\nconst LATEST_SCHEMA_URL = `https://${API_HOST}/schemas/contractsrc.json`;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Adapters Type\n// ─────────────────────────────────────────────────────────────────────────────\n\ninterface ServiceAdapters {\n  fs: FsAdapter;\n  logger: LoggerAdapter;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Analysis\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Analyze what upgrades are available.\n */\nexport async function analyzeUpgrades(\n  adapters: ServiceAdapters,\n  options: UpgradeOptions\n): Promise<UpgradeAnalysisResult> {\n  const { fs, logger } = adapters;\n  const workspaceRoot = findWorkspaceRoot(options.workspaceRoot);\n  const packageManager = detectPackageManager(workspaceRoot);\n\n  logger.info('Analyzing available upgrades...', {\n    workspaceRoot,\n    packageManager,\n  });\n\n  const packages = await analyzePackages(fs, workspaceRoot);\n  const configUpgrades = await analyzeConfig(fs, workspaceRoot);\n\n  const hasUpgrades = packages.length > 0 || configUpgrades.length > 0;\n\n  return {\n    packageManager,\n    packages,\n    configUpgrades,\n    hasUpgrades,\n  };\n}\n\n/**\n * Analyze installed packages for potential updates.\n * Checks for all packages in the workspace that match ContractSpec patterns.\n */\nasync function analyzePackages(\n  fs: FsAdapter,\n  workspaceRoot: string\n): Promise<PackageUpgradeInfo[]> {\n  const packageJsonPath = fs.join(workspaceRoot, 'package.json');\n\n  if (!(await fs.exists(packageJsonPath))) {\n    return [];\n  }\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 deps = packageJson.dependencies ?? {};\n    const devDeps = packageJson.devDependencies ?? {};\n\n    const packages: PackageUpgradeInfo[] = [];\n    const allDeps = { ...deps, ...devDeps };\n\n    for (const [name, version] of Object.entries(allDeps)) {\n      // Check for ContractSpec related packages\n      // Matches @contractspec/*, contractspec, @lssm/* (if internal)\n      if (\n        name.startsWith('@contractspec/') ||\n        name === 'contractspec' ||\n        name.startsWith('@lssm/')\n      ) {\n        packages.push({\n          name,\n          currentVersion: version,\n          isDevDependency: !!devDeps[name],\n        });\n      }\n    }\n\n    return packages;\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Analyze configuration for upgrade opportunities.\n */\nasync function analyzeConfig(\n  fs: FsAdapter,\n  workspaceRoot: string\n): Promise<ConfigUpgradeInfo[]> {\n  const configPath = fs.join(workspaceRoot, '.contractsrc.json');\n\n  if (!(await fs.exists(configPath))) {\n    return [];\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    const config = JSON.parse(content) as Record<string, unknown>;\n\n    const upgrades: ConfigUpgradeInfo[] = [];\n\n    // Check $schema\n    const currentSchema = config['$schema'] as string | undefined;\n    if (!currentSchema || currentSchema !== LATEST_SCHEMA_URL) {\n      upgrades.push({\n        key: '$schema',\n        currentValue: currentSchema,\n        suggestedValue: LATEST_SCHEMA_URL,\n        isNew: !currentSchema,\n      });\n    }\n\n    // Check versioning\n    if (!config['versioning']) {\n      upgrades.push({\n        key: 'versioning',\n        currentValue: undefined,\n        suggestedValue: getDefaultVersioningConfig(),\n        isNew: true,\n      });\n    } else {\n      const versioning = config['versioning'] as Record<string, unknown>;\n      if (versioning['integrateWithChangesets'] === undefined) {\n        upgrades.push({\n          key: 'versioning.integrateWithChangesets',\n          currentValue: undefined,\n          suggestedValue: false,\n          isNew: true,\n        });\n      }\n    }\n\n    // Check hooks\n    if (!config['hooks']) {\n      upgrades.push({\n        key: 'hooks',\n        currentValue: undefined,\n        suggestedValue: getDefaultHooksConfig(),\n        isNew: true,\n      });\n    }\n\n    return upgrades;\n  } catch {\n    return [];\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Apply Upgrades\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Apply configuration upgrades.\n *\n * Note: Package upgrades must be applied by the app layer (CLI, VSCode)\n * since they require running npm/bun/yarn commands which is platform-specific.\n */\nexport async function applyConfigUpgrades(\n  adapters: ServiceAdapters,\n  options: UpgradeOptions\n): Promise<UpgradeApplyResult> {\n  const { fs, logger } = adapters;\n  const workspaceRoot = findWorkspaceRoot(options.workspaceRoot);\n\n  if (options.dryRun) {\n    logger.info('Dry run - no changes will be made');\n  }\n\n  const configPath = fs.join(workspaceRoot, '.contractsrc.json');\n\n  if (!(await fs.exists(configPath))) {\n    return {\n      success: false,\n      packagesUpgraded: 0,\n      configSectionsUpgraded: 0,\n      error: 'No .contractsrc.json found',\n      summary: 'No configuration file to upgrade',\n    };\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    const config = JSON.parse(content) as Record<string, unknown>;\n\n    let sectionsUpgraded = 0;\n\n    // Update $schema\n    const currentSchema = config['$schema'] as string | undefined;\n    if (!currentSchema || currentSchema !== LATEST_SCHEMA_URL) {\n      config['$schema'] = LATEST_SCHEMA_URL;\n      sectionsUpgraded++;\n    }\n\n    // Add versioning if missing\n    if (!config['versioning']) {\n      config['versioning'] = getDefaultVersioningConfig();\n      sectionsUpgraded++;\n    } else {\n      const versioning = config['versioning'] as Record<string, unknown>;\n      if (versioning['integrateWithChangesets'] === undefined) {\n        versioning['integrateWithChangesets'] = false;\n        sectionsUpgraded++;\n      }\n    }\n\n    // Add hooks if missing\n    if (!config['hooks']) {\n      config['hooks'] = getDefaultHooksConfig();\n      sectionsUpgraded++;\n    }\n\n    if (sectionsUpgraded === 0) {\n      return {\n        success: true,\n        packagesUpgraded: 0,\n        configSectionsUpgraded: 0,\n        summary: 'Configuration is already up to date',\n      };\n    }\n\n    if (!options.dryRun) {\n      await fs.writeFile(configPath, JSON.stringify(config, null, 2) + '\\n');\n      logger.info('Configuration upgraded', { sectionsUpgraded });\n    }\n\n    return {\n      success: true,\n      packagesUpgraded: 0,\n      configSectionsUpgraded: sectionsUpgraded,\n      summary: options.dryRun\n        ? `Would upgrade ${sectionsUpgraded} config section(s)`\n        : `Upgraded ${sectionsUpgraded} config section(s)`,\n    };\n  } catch (error) {\n    const msg = error instanceof Error ? error.message : String(error);\n    return {\n      success: false,\n      packagesUpgraded: 0,\n      configSectionsUpgraded: 0,\n      error: msg,\n      summary: `Failed to upgrade config: ${msg}`,\n    };\n  }\n}\n\n/**\n * Get the command to upgrade packages.\n *\n * Returns the shell command string that the app layer should execute.\n */\nexport function getPackageUpgradeCommand(\n  packageManager: string,\n  packages: PackageUpgradeInfo[],\n  useLatest: boolean\n): string {\n  const pkgList = useLatest\n    ? packages.map((p) => `${p.name}@latest`).join(' ')\n    : packages.map((p) => p.name).join(' ');\n\n  switch (packageManager) {\n    case 'bun':\n      return `bun add ${pkgList}`;\n    case 'pnpm':\n      return `pnpm add ${pkgList}`;\n    case 'yarn':\n      return `yarn add ${pkgList}`;\n    default:\n      return `npm install ${pkgList}`;\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Default Configs\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Get default versioning configuration.\n */\nexport function getDefaultVersioningConfig(): Record<string, unknown> {\n  return {\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,\n  };\n}\n\n/**\n * Get default hooks configuration.\n */\nexport function getDefaultHooksConfig(): Record<string, string[]> {\n  return {\n    'pre-commit': ['contractspec validate', 'contractspec integrity check'],\n  };\n}\n"],"mappings":"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"}

package/dist/services/versioning/conventional-commits.d.ts

@@ -0,0 +1,95 @@
+import { ChangeEntry, VersionBumpType } from "@contractspec/lib.contracts";
+
+//#region src/services/versioning/conventional-commits.d.ts
+
+/**
+ * Parsed conventional commit message.
+ */
+interface ConventionalCommit {
+  /** Commit type (feat, fix, chore, etc.) */
+  type: string;
+  /** Optional scope (e.g., auth, api) */
+  scope?: string;
+  /** Whether this is a breaking change */
+  breaking: boolean;
+  /** Commit description */
+  description: string;
+  /** Commit body (optional) */
+  body?: string;
+  /** Breaking change description (if any) */
+  breakingDescription?: string;
+  /** Full original message */
+  raw: string;
+}
+/**
+ * Commit type to bump type mapping.
+ */
+type CommitTypeBumpMap = Record<string, VersionBumpType | null>;
+/**
+ * Default mapping of commit types to version bump types.
+ *
+ * - `feat` → minor (new feature)
+ * - `fix` → patch (bug fix)
+ * - `perf` → patch (performance improvement)
+ * - `refactor` → patch (code refactoring)
+ * - `docs` → null (no version bump)
+ * - `style` → null (no version bump)
+ * - `test` → null (no version bump)
+ * - `chore` → null (no version bump)
+ * - `ci` → null (no version bump)
+ * - `build` → null (no version bump)
+ */
+declare const DEFAULT_COMMIT_TYPE_MAP: CommitTypeBumpMap;
+/**
+ * Parse a conventional commit message.
+ *
+ * @param message - Full commit message (may include body)
+ * @returns Parsed commit or null if not a valid conventional commit
+ */
+declare function parseConventionalCommit(message: string): ConventionalCommit | null;
+/**
+ * Check if a commit message follows conventional commit format.
+ */
+declare function isConventionalCommit(message: string): boolean;
+/**
+ * Determine the version bump type from a conventional commit.
+ *
+ * @param commit - Parsed conventional commit
+ * @param typeMap - Optional custom type-to-bump mapping
+ * @returns Version bump type or null if no bump needed
+ */
+declare function getBumpTypeFromCommit(commit: ConventionalCommit, typeMap?: CommitTypeBumpMap): VersionBumpType | null;
+/**
+ * Determine the highest bump type from multiple commits.
+ *
+ * @param commits - Array of parsed conventional commits
+ * @param typeMap - Optional custom type-to-bump mapping
+ * @returns Highest version bump type or null if no bump needed
+ */
+declare function getHighestBumpType(commits: ConventionalCommit[], typeMap?: CommitTypeBumpMap): VersionBumpType | null;
+/**
+ * Convert a conventional commit to a changelog ChangeEntry.
+ *
+ * @param commit - Parsed conventional commit
+ * @returns ChangeEntry for changelog
+ */
+declare function commitToChangeEntry(commit: ConventionalCommit): ChangeEntry;
+/**
+ * Convert multiple commits to an array of ChangeEntries.
+ */
+declare function commitsToChangeEntries(commits: ConventionalCommit[]): ChangeEntry[];
+/**
+ * Filter commits by scope (for spec-level changes).
+ *
+ * @param commits - Array of parsed conventional commits
+ * @param scope - Scope to filter by (e.g., "auth", "api")
+ * @returns Commits matching the scope
+ */
+declare function filterCommitsByScope(commits: ConventionalCommit[], scope: string): ConventionalCommit[];
+/**
+ * Filter commits that trigger version bumps.
+ */
+declare function filterBumpableCommits(commits: ConventionalCommit[], typeMap?: CommitTypeBumpMap): ConventionalCommit[];
+//#endregion
+export { CommitTypeBumpMap, ConventionalCommit, DEFAULT_COMMIT_TYPE_MAP, commitToChangeEntry, commitsToChangeEntries, filterBumpableCommits, filterCommitsByScope, getBumpTypeFromCommit, getHighestBumpType, isConventionalCommit, parseConventionalCommit };
+//# sourceMappingURL=conventional-commits.d.ts.map

package/dist/services/versioning/conventional-commits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventional-commits.d.ts","names":[],"sources":["../../../src/services/versioning/conventional-commits.ts"],"sourcesContent":[],"mappings":";;;;;;;AAwLkB,UAjKD,kBAAA,CAiKC;EAqCF;EAoDA,IAAA,EAAA,MAAA;EAiBA;EAUA,KAAA,CAAA,EAAA,MAAA;EACL;EACA,QAAA,EAAA,OAAA;EACR;EAAkB,WAAA,EAAA,MAAA;;;;;;;;;;;KApQT,iBAAA,GAAoB,eAAe;;;;;;;;;;;;;;;cAoBlC,yBAAyB;;;;;;;iBAyCtB,uBAAA,mBAEb;;;;iBAwCa,oBAAA;;;;;;;;iBAeA,qBAAA,SACN,8BACC,oBACR;;;;;;;;iBAiBa,kBAAA,UACL,gCACA,oBACR;;;;;;;iBAqCa,mBAAA,SAA4B,qBAAqB;;;;iBAoDjD,sBAAA,UACL,uBACR;;;;;;;;iBAea,oBAAA,UACL,sCAER;;;;iBAOa,qBAAA,UACL,gCACA,oBACR"}