@contractspec/bundle.workspace 1.52.0 → 1.53.0

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

@@ -1 +1 @@
-{"version":3,"file":"docs-service.mjs","names":[],"sources":["../../../src/services/docs/docs-service.ts"],"sourcesContent":["import path from 'path';\nimport {\n  type DocBlock,\n  defaultDocRegistry,\n} from '@contractspec/lib.contracts/docs';\nimport {\n  loadSpecFromSource,\n  convertSpecToDocBlock,\n  scanAllSpecsFromSource,\n  scanSpecSource,\n  type SpecScanResult,\n} from '@contractspec/module.workspace';\nimport type { WorkspaceAdapters } from '../../ports/logger';\nimport { ModuleResolver } from '../modules/module-resolver';\n\nexport interface DocsServiceOptions {\n  outputDir?: string;\n  format?: 'markdown' | 'html' | 'json';\n  rootPath?: string;\n}\n\nexport interface DocsServiceResult {\n  blocks: DocBlock[];\n  count: number;\n}\n\n/**\n * Generate documentation from spec files.\n */\nexport async function generateDocsFromSpecs(\n  specFiles: string[],\n  options: DocsServiceOptions,\n  adapters: WorkspaceAdapters\n): Promise<DocsServiceResult> {\n  const { fs, logger } = adapters;\n  const blocks: DocBlock[] = [];\n\n  logger.info(`Generating docs for ${specFiles.length} files...`);\n\n  if (options.outputDir) {\n    await fs.mkdir(options.outputDir);\n  }\n\n  // Initialize ModuleResolver\n  const resolver = new ModuleResolver(adapters);\n  // 1. Scan all specs to build the module index\n  const scanResults: SpecScanResult[] = [];\n  for (const file of specFiles) {\n    try {\n      const content = await fs.readFile(file);\n      const results = scanAllSpecsFromSource(content, file);\n      if (results.length > 0) {\n        scanResults.push(...results);\n      } else {\n        // Fallback if no multi-specs found, try single scan logic\n        const single = scanSpecSource(content, file);\n        if (single.specType !== 'unknown') {\n          scanResults.push(single);\n        }\n      }\n    } catch (_err) {\n      // ignore read errors\n    }\n  }\n\n  resolver.initialize(scanResults);\n\n  for (const file of specFiles) {\n    try {\n      const parsedList = await loadSpecFromSource(file);\n\n      if (parsedList && parsedList.length > 0) {\n        for (const parsed of parsedList) {\n          const block = convertSpecToDocBlock(parsed, {\n            rootPath: options.rootPath,\n          });\n          // Register in global registry\n          defaultDocRegistry.register(block);\n          blocks.push(block);\n          logger.debug(`Generated doc for ${block.id}`);\n\n          if (options.outputDir) {\n            // Determine grouping based on module resolution\n            const moduleDef = resolver.resolve(file);\n            let targetDir = options.outputDir;\n\n            if (moduleDef) {\n              targetDir = path.join(options.outputDir, moduleDef.key);\n            } else {\n              targetDir = path.join(options.outputDir, '_common'); // Fallback for root-level specs\n            }\n\n            // Ensure subdirectory exists\n            await fs.mkdir(targetDir);\n\n            // Flattened structure: [module]/[docId].md\n            const filename = `${block.id}.md`;\n            const filePath = path.join(targetDir, filename);\n            const generatedContent = `<!-- @generated - This file was generated by ContractSpec. Do not edit manually. -->\\n\\n${block.body}`;\n            await fs.writeFile(filePath, generatedContent);\n          }\n        }\n      } else {\n        logger.warn(`Could not parse spec from ${file}`);\n      }\n    } catch (error) {\n      logger.error(\n        `Error processing ${file}: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  if (options.outputDir) {\n    logger.info(`Wrote ${blocks.length} doc files to ${options.outputDir}`);\n  }\n\n  return { blocks, count: blocks.length };\n}\n"],"mappings":";;;;;;;;;AA6BA,eAAsB,sBACpB,WACA,SACA,UAC4B;CAC5B,MAAM,EAAE,IAAI,WAAW;CACvB,MAAM,SAAqB,EAAE;AAE7B,QAAO,KAAK,uBAAuB,UAAU,OAAO,WAAW;AAE/D,KAAI,QAAQ,UACV,OAAM,GAAG,MAAM,QAAQ,UAAU;CAInC,MAAM,WAAW,IAAI,eAAe,SAAS;CAE7C,MAAM,cAAgC,EAAE;AACxC,MAAK,MAAM,QAAQ,UACjB,KAAI;EACF,MAAM,UAAU,MAAM,GAAG,SAAS,KAAK;EACvC,MAAM,UAAU,uBAAuB,SAAS,KAAK;AACrD,MAAI,QAAQ,SAAS,EACnB,aAAY,KAAK,GAAG,QAAQ;OACvB;GAEL,MAAM,SAAS,eAAe,SAAS,KAAK;AAC5C,OAAI,OAAO,aAAa,UACtB,aAAY,KAAK,OAAO;;UAGrB,MAAM;AAKjB,UAAS,WAAW,YAAY;AAEhC,MAAK,MAAM,QAAQ,UACjB,KAAI;EACF,MAAM,aAAa,MAAM,mBAAmB,KAAK;AAEjD,MAAI,cAAc,WAAW,SAAS,EACpC,MAAK,MAAM,UAAU,YAAY;GAC/B,MAAM,QAAQ,sBAAsB,QAAQ,EAC1C,UAAU,QAAQ,UACnB,CAAC;AAEF,sBAAmB,SAAS,MAAM;AAClC,UAAO,KAAK,MAAM;AAClB,UAAO,MAAM,qBAAqB,MAAM,KAAK;AAE7C,OAAI,QAAQ,WAAW;IAErB,MAAM,YAAY,SAAS,QAAQ,KAAK;IACxC,IAAI,YAAY,QAAQ;AAExB,QAAI,UACF,aAAY,KAAK,KAAK,QAAQ,WAAW,UAAU,IAAI;QAEvD,aAAY,KAAK,KAAK,QAAQ,WAAW,UAAU;AAIrD,UAAM,GAAG,MAAM,UAAU;IAGzB,MAAM,WAAW,GAAG,MAAM,GAAG;IAC7B,MAAM,WAAW,KAAK,KAAK,WAAW,SAAS;IAC/C,MAAM,mBAAmB,2FAA2F,MAAM;AAC1H,UAAM,GAAG,UAAU,UAAU,iBAAiB;;;MAIlD,QAAO,KAAK,6BAA6B,OAAO;UAE3C,OAAO;AACd,SAAO,MACL,oBAAoB,KAAK,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GACpF;;AAIL,KAAI,QAAQ,UACV,QAAO,KAAK,SAAS,OAAO,OAAO,gBAAgB,QAAQ,YAAY;AAGzE,QAAO;EAAE;EAAQ,OAAO,OAAO;EAAQ"}
+{"version":3,"file":"docs-service.mjs","names":[],"sources":["../../../src/services/docs/docs-service.ts"],"sourcesContent":["import path from 'path';\nimport {\n  defaultDocRegistry,\n  type DocBlock,\n} from '@contractspec/lib.contracts/docs';\nimport {\n  convertSpecToDocBlock,\n  loadSpecFromSource,\n  scanAllSpecsFromSource,\n  scanSpecSource,\n  type SpecScanResult,\n} from '@contractspec/module.workspace';\nimport type { WorkspaceAdapters } from '../../ports/logger';\nimport { ModuleResolver } from '../modules/module-resolver';\n\nexport interface DocsServiceOptions {\n  outputDir?: string;\n  format?: 'markdown' | 'html' | 'json';\n  rootPath?: string;\n}\n\nexport interface DocsServiceResult {\n  blocks: DocBlock[];\n  count: number;\n}\n\n/**\n * Generate documentation from spec files.\n */\nexport async function generateDocsFromSpecs(\n  specFiles: string[],\n  options: DocsServiceOptions,\n  adapters: WorkspaceAdapters\n): Promise<DocsServiceResult> {\n  const { fs, logger } = adapters;\n  const blocks: DocBlock[] = [];\n\n  logger.info(`Generating docs for ${specFiles.length} files...`);\n\n  if (options.outputDir) {\n    await fs.mkdir(options.outputDir);\n  }\n\n  // Initialize ModuleResolver\n  const resolver = new ModuleResolver(adapters);\n  // 1. Scan all specs to build the module index\n  const scanResults: SpecScanResult[] = [];\n  for (const file of specFiles) {\n    try {\n      const content = await fs.readFile(file);\n      if (file.endsWith('packages/libs/contracts/src/app-config/spec.ts')) {\n        console.log('coupable', file);\n      }\n      const results = scanAllSpecsFromSource(content, file);\n      if (results.length > 0) {\n        scanResults.push(...results);\n      } else {\n        // Fallback if no multi-specs found, try single scan logic\n        const single = scanSpecSource(content, file);\n        if (single.specType !== 'unknown') {\n          scanResults.push(single);\n        }\n      }\n    } catch (_err) {\n      // ignore read errors\n    }\n  }\n\n  resolver.initialize(scanResults);\n\n  for (const file of specFiles) {\n    try {\n      const parsedList = await loadSpecFromSource(file);\n\n      if (!parsedList?.length) {\n        logger.warn(`Could not parse spec from ${file}`);\n        continue;\n      }\n\n      for (const parsed of parsedList) {\n        const block = convertSpecToDocBlock(parsed, {\n          rootPath: options.rootPath,\n        });\n        // Register in global registry\n        defaultDocRegistry.register(block);\n        blocks.push(block);\n        logger.debug(`Generated doc for ${block.id}`);\n\n        if (!options.outputDir) {\n          continue;\n        }\n\n        // Determine grouping based on module resolution\n        const moduleDef = resolver.resolve(file);\n        let targetDir = options.outputDir;\n\n        if (moduleDef) {\n          targetDir = path.join(options.outputDir, moduleDef.key);\n        } else {\n          targetDir = path.join(options.outputDir, '_common'); // Fallback for root-level specs\n        }\n\n        // Ensure subdirectory exists\n        await fs.mkdir(targetDir);\n\n        // Flattened structure: [module]/[docId].md\n        const filename = `${block.id}.md`;\n        const filePath = path.join(targetDir, filename);\n        const generatedContent = `<!-- @generated - This file was generated by ContractSpec. Do not edit manually. -->\\n\\n${block.body}`;\n        await fs.writeFile(filePath, generatedContent);\n      }\n    } catch (error) {\n      logger.error(\n        `Error processing ${file}: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  if (options.outputDir) {\n    logger.info(`Wrote ${blocks.length} doc files to ${options.outputDir}`);\n  }\n\n  return { blocks, count: blocks.length };\n}\n"],"mappings":";;;;;;;;;AA6BA,eAAsB,sBACpB,WACA,SACA,UAC4B;CAC5B,MAAM,EAAE,IAAI,WAAW;CACvB,MAAM,SAAqB,EAAE;AAE7B,QAAO,KAAK,uBAAuB,UAAU,OAAO,WAAW;AAE/D,KAAI,QAAQ,UACV,OAAM,GAAG,MAAM,QAAQ,UAAU;CAInC,MAAM,WAAW,IAAI,eAAe,SAAS;CAE7C,MAAM,cAAgC,EAAE;AACxC,MAAK,MAAM,QAAQ,UACjB,KAAI;EACF,MAAM,UAAU,MAAM,GAAG,SAAS,KAAK;AACvC,MAAI,KAAK,SAAS,iDAAiD,CACjE,SAAQ,IAAI,YAAY,KAAK;EAE/B,MAAM,UAAU,uBAAuB,SAAS,KAAK;AACrD,MAAI,QAAQ,SAAS,EACnB,aAAY,KAAK,GAAG,QAAQ;OACvB;GAEL,MAAM,SAAS,eAAe,SAAS,KAAK;AAC5C,OAAI,OAAO,aAAa,UACtB,aAAY,KAAK,OAAO;;UAGrB,MAAM;AAKjB,UAAS,WAAW,YAAY;AAEhC,MAAK,MAAM,QAAQ,UACjB,KAAI;EACF,MAAM,aAAa,MAAM,mBAAmB,KAAK;AAEjD,MAAI,CAAC,YAAY,QAAQ;AACvB,UAAO,KAAK,6BAA6B,OAAO;AAChD;;AAGF,OAAK,MAAM,UAAU,YAAY;GAC/B,MAAM,QAAQ,sBAAsB,QAAQ,EAC1C,UAAU,QAAQ,UACnB,CAAC;AAEF,sBAAmB,SAAS,MAAM;AAClC,UAAO,KAAK,MAAM;AAClB,UAAO,MAAM,qBAAqB,MAAM,KAAK;AAE7C,OAAI,CAAC,QAAQ,UACX;GAIF,MAAM,YAAY,SAAS,QAAQ,KAAK;GACxC,IAAI,YAAY,QAAQ;AAExB,OAAI,UACF,aAAY,KAAK,KAAK,QAAQ,WAAW,UAAU,IAAI;OAEvD,aAAY,KAAK,KAAK,QAAQ,WAAW,UAAU;AAIrD,SAAM,GAAG,MAAM,UAAU;GAGzB,MAAM,WAAW,GAAG,MAAM,GAAG;GAC7B,MAAM,WAAW,KAAK,KAAK,WAAW,SAAS;GAC/C,MAAM,mBAAmB,2FAA2F,MAAM;AAC1H,SAAM,GAAG,UAAU,UAAU,iBAAiB;;UAEzC,OAAO;AACd,SAAO,MACL,oBAAoB,KAAK,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GACpF;;AAIL,KAAI,QAAQ,UACV,QAAO,KAAK,SAAS,OAAO,OAAO,gBAAgB,QAAQ,YAAY;AAGzE,QAAO;EAAE;EAAQ,OAAO,OAAO;EAAQ"}

package/dist/services/extract.mjs

@@ -8,17 +8,9 @@ async function extractContracts(adapters, options, cwd) {
 	const { source, outputDir } = options;
 	const sourcePath = fs.resolve(cwd ?? process.cwd(), source);
 	if (!await fs.exists(sourcePath)) throw new Error(`Source file not found: ${sourcePath}`);
-	const config = await loadWorkspaceConfig(fs, cwd);
-	const conventions = {
-		models: "models",
-		groupByFeature: false,
-		...config.conventions
-	};
 	const runConfig = {
-		...config,
-		outputDir,
-		schemaFormat: config.schemaFormat ?? "zod",
-		conventions
+		...await loadWorkspaceConfig(fs, cwd),
+		outputDir
 	};
 	logger.info(`Extracting contracts from ${sourcePath} to ${outputDir}`);
 	return importFromOpenApiService(runConfig, {

package/dist/services/extract.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"extract.mjs","names":[],"sources":["../../src/services/extract.ts"],"sourcesContent":["import type { WorkspaceAdapters } from '../ports/logger';\nimport { loadWorkspaceConfig } from './config';\nimport { importFromOpenApiService } from './openapi/index';\nimport type { OpenApiImportServiceResult } from './openapi/types';\n\nexport interface ExtractOptions {\n  source: string;\n  outputDir: string;\n}\n\nexport async function extractContracts(\n  adapters: WorkspaceAdapters,\n  options: ExtractOptions,\n  cwd?: string\n): Promise<OpenApiImportServiceResult> {\n  const { fs, logger } = adapters;\n  const { source, outputDir } = options;\n\n  // Verify source existence\n  // We resolve source relative to CWD if checking locally, or absolute\n  const sourcePath = fs.resolve(cwd ?? process.cwd(), source);\n  if (!(await fs.exists(sourcePath))) {\n    throw new Error(`Source file not found: ${sourcePath}`);\n  }\n\n  // Load Base Config\n  const config = await loadWorkspaceConfig(fs, cwd);\n\n  // Override config if needed or pass as options to import service\n  // importFromOpenApiService takes (contractsrcConfig, importOptions, adapters)\n  // We need to merge outputDir override if present.\n  const conventions = {\n    models: 'models',\n    groupByFeature: false,\n    ...config.conventions,\n  };\n\n  const runConfig = {\n    ...config,\n    outputDir: outputDir, // CLI/Option override\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    schemaFormat: (config as any).schemaFormat ?? 'zod',\n    conventions,\n  };\n\n  logger.info(`Extracting contracts from ${sourcePath} to ${outputDir}`);\n\n  return importFromOpenApiService(\n    runConfig,\n    {\n      source: sourcePath,\n      outputDir: outputDir,\n      dryRun: false,\n    },\n    adapters\n  );\n}\n"],"mappings":";;;;;AAUA,eAAsB,iBACpB,UACA,SACA,KACqC;CACrC,MAAM,EAAE,IAAI,WAAW;CACvB,MAAM,EAAE,QAAQ,cAAc;CAI9B,MAAM,aAAa,GAAG,QAAQ,OAAO,QAAQ,KAAK,EAAE,OAAO;AAC3D,KAAI,CAAE,MAAM,GAAG,OAAO,WAAW,CAC/B,OAAM,IAAI,MAAM,0BAA0B,aAAa;CAIzD,MAAM,SAAS,MAAM,oBAAoB,IAAI,IAAI;CAKjD,MAAM,cAAc;EAClB,QAAQ;EACR,gBAAgB;EAChB,GAAG,OAAO;EACX;CAED,MAAM,YAAY;EAChB,GAAG;EACQ;EAEX,cAAe,OAAe,gBAAgB;EAC9C;EACD;AAED,QAAO,KAAK,6BAA6B,WAAW,MAAM,YAAY;AAEtE,QAAO,yBACL,WACA;EACE,QAAQ;EACG;EACX,QAAQ;EACT,EACD,SACD"}
+{"version":3,"file":"extract.mjs","names":[],"sources":["../../src/services/extract.ts"],"sourcesContent":["import type { WorkspaceAdapters } from '../ports/logger';\nimport { loadWorkspaceConfig } from './config';\nimport { importFromOpenApiService } from './openapi/index';\nimport type { OpenApiImportServiceResult } from './openapi/types';\n\nexport interface ExtractOptions {\n  source: string;\n  outputDir: string;\n}\n\nexport async function extractContracts(\n  adapters: WorkspaceAdapters,\n  options: ExtractOptions,\n  cwd?: string\n): Promise<OpenApiImportServiceResult> {\n  const { fs, logger } = adapters;\n  const { source, outputDir } = options;\n\n  // Verify source existence\n  // We resolve source relative to CWD if checking locally, or absolute\n  const sourcePath = fs.resolve(cwd ?? process.cwd(), source);\n  if (!(await fs.exists(sourcePath))) {\n    throw new Error(`Source file not found: ${sourcePath}`);\n  }\n\n  // Load Base Config\n  const config = await loadWorkspaceConfig(fs, cwd);\n\n  // Override config if needed or pass as options to import service\n  // importFromOpenApiService takes (contractsrcConfig, importOptions, adapters)\n  // We need to merge outputDir override if present.\n\n  const runConfig = {\n    ...config,\n    outputDir: outputDir, // CLI/Option override\n  };\n\n  logger.info(`Extracting contracts from ${sourcePath} to ${outputDir}`);\n\n  return importFromOpenApiService(\n    runConfig,\n    {\n      source: sourcePath,\n      outputDir: outputDir,\n      dryRun: false,\n    },\n    adapters\n  );\n}\n"],"mappings":";;;;;AAUA,eAAsB,iBACpB,UACA,SACA,KACqC;CACrC,MAAM,EAAE,IAAI,WAAW;CACvB,MAAM,EAAE,QAAQ,cAAc;CAI9B,MAAM,aAAa,GAAG,QAAQ,OAAO,QAAQ,KAAK,EAAE,OAAO;AAC3D,KAAI,CAAE,MAAM,GAAG,OAAO,WAAW,CAC/B,OAAM,IAAI,MAAM,0BAA0B,aAAa;CAUzD,MAAM,YAAY;EAChB,GAPa,MAAM,oBAAoB,IAAI,IAAI;EAQpC;EACZ;AAED,QAAO,KAAK,6BAA6B,WAAW,MAAM,YAAY;AAEtE,QAAO,yBACL,WACA;EACE,QAAQ;EACG;EACX,QAAQ;EACT,EACD,SACD"}

package/dist/services/implementation/discovery.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.mts","names":[],"sources":["../../../src/services/implementation/discovery.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAsLU,iBAnIM,uBAAA,CAmIN,QAAA,EAAA,MAAA,CAAA,EAnIiD,kBAmIjD;AAkCV;;;AAGuB,iBAhJP,qBAAA,CAgJO,IAAA,EAAA,MAAA,EAAA,QAAA,EAAA,MAAA,CAAA,EA7IpB,kBA6IoB,EAAA;;;;iBAzCD,8BAAA;MAEJ;aACP,mBACR,QAAQ;;;;;iBAkCW,0BAAA;MACJ;aACP,mBACR,QAAQ,YAAY"}
+{"version":3,"file":"discovery.d.mts","names":[],"sources":["../../../src/services/implementation/discovery.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AA2KU,iBAvHM,uBAAA,CAuHN,QAAA,EAAA,MAAA,CAAA,EAvHiD,kBAuHjD;AAoCV;;;AAGuB,iBAtIP,qBAAA,CAsIO,IAAA,EAAA,MAAA,EAAA,QAAA,EAAA,MAAA,CAAA,EAnIpB,kBAmIoB,EAAA;;;;iBA3CD,8BAAA;MAEJ;aACP,mBACR,QAAQ;;;;;iBAoCW,0BAAA;MACJ;aACP,mBACR,QAAQ,YAAY"}

package/dist/services/implementation/discovery.mjs

@@ -1,3 +1,6 @@
+import { DEFAULT_FS_IGNORES, DEFAULT_SPEC_PATTERNS } from "../../adapters/fs.mjs";
+import "../../adapters/index.mjs";
+
 //#region src/services/implementation/discovery.ts
 /**
 * Patterns for detecting spec references in source code.
@@ -81,25 +84,14 @@ function extractSpecReferences(code, filePath) {
 /**
 * Default glob patterns for implementation files.
 */
-const DEFAULT_INCLUDE_PATTERNS = ["**/*.ts", "**/*.tsx"];
-const DEFAULT_EXCLUDE_PATTERNS = [
-	"**/node_modules/**",
-	"**/dist/**",
-	"**/.git/**",
-	"**/*.d.ts",
-	"**/*.operation.ts",
-	"**/*.spec.ts",
-	"**/*.feature.ts",
-	"**/*.event.ts",
-	"**/*.presentation.ts"
-];
+const DEFAULT_INCLUDE_PATTERNS = ["**/*.ts(x)"];
 /**
 * Discover implementations that reference a specific spec.
 */
 async function discoverImplementationsForSpec(specKey, adapters, options = {}) {
 	const { fs } = adapters;
 	const includePatterns = options.includePatterns ?? DEFAULT_INCLUDE_PATTERNS;
-	const excludePatterns = options.excludePatterns ?? DEFAULT_EXCLUDE_PATTERNS;
+	const excludePatterns = options.excludePatterns ?? [...new Set([...DEFAULT_FS_IGNORES, ...DEFAULT_SPEC_PATTERNS])];
 	const allMatches = [];
 	for (const pattern of includePatterns) {
 		const files = await fs.glob({
@@ -120,7 +112,7 @@ async function discoverImplementationsForSpec(specKey, adapters, options = {}) {
 async function discoverAllImplementations(adapters, options = {}) {
 	const { fs } = adapters;
 	const includePatterns = options.includePatterns ?? DEFAULT_INCLUDE_PATTERNS;
-	const excludePatterns = options.excludePatterns ?? DEFAULT_EXCLUDE_PATTERNS;
+	const excludePatterns = options.excludePatterns ?? [...new Set([...DEFAULT_FS_IGNORES, ...DEFAULT_SPEC_PATTERNS])];
 	const specToImplementations = /* @__PURE__ */ new Map();
 	for (const pattern of includePatterns) {
 		const files = await fs.glob({

package/dist/services/implementation/discovery.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.mjs","names":[],"sources":["../../../src/services/implementation/discovery.ts"],"sourcesContent":["/**\n * Implementation auto-discovery service.\n *\n * Scans workspace files to find implementations that reference specs.\n * Uses regex-based pattern matching for performance (avoids full AST parsing).\n */\n\nimport type { FsAdapter } from '../../ports/fs';\nimport type { ImplementationType } from '@contractspec/lib.contracts';\nimport type { DiscoveryOptions, SpecReferenceMatch } from './types';\n\n/**\n * Patterns for detecting spec references in source code.\n */\nconst SPEC_REFERENCE_PATTERNS = {\n  // import { SpecName } from './path'\n  namedImport:\n    /import\\s*\\{[^}]*\\b(\\w+(?:Spec|Contract|Command|Query))\\b[^}]*\\}\\s*from/g,\n  // import SpecName from './path'\n  defaultImport: /import\\s+(\\w+(?:Spec|Contract|Command|Query))\\s+from/g,\n  // ContractHandler<typeof SpecName>\n  contractHandler: /ContractHandler\\s*<\\s*typeof\\s+(\\w+)\\s*>/g,\n  // typeof SpecName (generic usage)\n  typeofSpec: /typeof\\s+(\\w+(?:Spec|Contract|Command|Query))\\b/g,\n  // spec: SpecKey or spec = SpecKey\n  specAssignment:\n    /(?:spec|contract)\\s*[:=]\\s*(\\w+(?:Spec|Contract|Command|Query))\\b/gi,\n};\n\n/**\n * File patterns that indicate implementation types.\n */\nconst IMPLEMENTATION_TYPE_PATTERNS: Record<string, ImplementationType> = {\n  '.handler.ts': 'handler',\n  '.handler.tsx': 'handler',\n  '.service.ts': 'service',\n  '.service.tsx': 'service',\n  '.test.ts': 'test',\n  '.test.tsx': 'test',\n  '.spec.ts': 'test',\n  '.spec.tsx': 'test',\n  '.component.tsx': 'component',\n  '.tsx': 'component', // Default for TSX files\n  '.form.tsx': 'form',\n  '.hook.ts': 'hook',\n  '.hook.tsx': 'hook',\n};\n\n/**\n * Infer implementation type from file path.\n */\nexport function inferImplementationType(filePath: string): ImplementationType {\n  const lowerPath = filePath.toLowerCase();\n\n  // Check specific patterns first (order matters)\n  for (const [pattern, type] of Object.entries(IMPLEMENTATION_TYPE_PATTERNS)) {\n    if (lowerPath.endsWith(pattern)) {\n      return type;\n    }\n  }\n\n  // Check directory patterns\n  if (lowerPath.includes('/handlers/')) return 'handler';\n  if (lowerPath.includes('/services/')) return 'service';\n  if (lowerPath.includes('/components/')) return 'component';\n  if (lowerPath.includes('/forms/')) return 'form';\n  if (lowerPath.includes('/hooks/')) return 'hook';\n  if (lowerPath.includes('/__tests__/')) return 'test';\n\n  return 'other';\n}\n\n/**\n * Extract spec references from source code.\n */\nexport function extractSpecReferences(\n  code: string,\n  filePath: string\n): SpecReferenceMatch[] {\n  const matches: SpecReferenceMatch[] = [];\n  const seenSpecs = new Set<string>();\n\n  // Helper to add unique matches\n  const addMatch = (\n    specKey: string,\n    referenceType: SpecReferenceMatch['referenceType'],\n    lineNumber?: number\n  ) => {\n    const key = `${specKey}:${referenceType}`;\n    if (seenSpecs.has(key)) return;\n    seenSpecs.add(key);\n\n    matches.push({\n      filePath,\n      specKey,\n      referenceType,\n      lineNumber,\n      inferredType: inferImplementationType(filePath),\n    });\n  };\n\n  // Find line number for a match position\n  const getLineNumber = (position: number): number => {\n    const lines = code.substring(0, position).split('\\n');\n    return lines.length;\n  };\n\n  // Check ContractHandler pattern (most specific)\n  let match: RegExpExecArray | null;\n  const handlerPattern = new RegExp(SPEC_REFERENCE_PATTERNS.contractHandler);\n  while ((match = handlerPattern.exec(code)) !== null) {\n    if (match[1]) {\n      addMatch(match[1], 'handler', getLineNumber(match.index));\n    }\n  }\n\n  // Check typeof pattern\n  const typeofPattern = new RegExp(SPEC_REFERENCE_PATTERNS.typeofSpec);\n  while ((match = typeofPattern.exec(code)) !== null) {\n    if (match[1]) {\n      addMatch(match[1], 'typeof', getLineNumber(match.index));\n    }\n  }\n\n  // Check named imports\n  const namedPattern = new RegExp(SPEC_REFERENCE_PATTERNS.namedImport);\n  while ((match = namedPattern.exec(code)) !== null) {\n    // Extract all spec names from the import statement\n    const importBlock = match[0];\n    const specNames = importBlock.match(\n      /\\b(\\w+(?:Spec|Contract|Command|Query))\\b/g\n    );\n    if (specNames) {\n      for (const name of specNames) {\n        addMatch(name, 'import', getLineNumber(match.index));\n      }\n    }\n  }\n\n  // Check default imports\n  const defaultPattern = new RegExp(SPEC_REFERENCE_PATTERNS.defaultImport);\n  while ((match = defaultPattern.exec(code)) !== null) {\n    if (match[1]) {\n      addMatch(match[1], 'import', getLineNumber(match.index));\n    }\n  }\n\n  // Check spec assignments\n  const assignPattern = new RegExp(SPEC_REFERENCE_PATTERNS.specAssignment);\n  while ((match = assignPattern.exec(code)) !== null) {\n    if (match[1]) {\n      addMatch(match[1], 'unknown', getLineNumber(match.index));\n    }\n  }\n\n  return matches;\n}\n\n/**\n * Default glob patterns for implementation files.\n */\nconst DEFAULT_INCLUDE_PATTERNS = ['**/*.ts', '**/*.tsx'];\n\nconst DEFAULT_EXCLUDE_PATTERNS = [\n  '**/node_modules/**',\n  '**/dist/**',\n  '**/.git/**',\n  '**/*.d.ts',\n  '**/*.operation.ts', // Skip spec files themselves\n  '**/*.spec.ts', // Skip test spec files\n  '**/*.feature.ts', // Skip feature files\n  '**/*.event.ts', // Skip event spec files\n  '**/*.presentation.ts', // Skip presentation files\n];\n\n/**\n * Discover implementations that reference a specific spec.\n */\nexport async function discoverImplementationsForSpec(\n  specKey: string,\n  adapters: { fs: FsAdapter },\n  options: DiscoveryOptions = {}\n): Promise<SpecReferenceMatch[]> {\n  const { fs } = adapters;\n  const includePatterns = options.includePatterns ?? DEFAULT_INCLUDE_PATTERNS;\n  const excludePatterns = options.excludePatterns ?? DEFAULT_EXCLUDE_PATTERNS;\n\n  const allMatches: SpecReferenceMatch[] = [];\n\n  // Scan each include pattern\n  for (const pattern of includePatterns) {\n    const files = await fs.glob({ pattern, ignore: excludePatterns });\n\n    for (const filePath of files) {\n      try {\n        const content = await fs.readFile(filePath);\n        const references = extractSpecReferences(content, filePath);\n\n        // Filter to only references for the target spec\n        const matchingRefs = references.filter(\n          (ref) => ref.specKey === specKey\n        );\n        allMatches.push(...matchingRefs);\n      } catch {\n        // Skip files that can't be read\n      }\n    }\n  }\n\n  return allMatches;\n}\n\n/**\n * Discover all spec references in the workspace.\n * Returns a map of spec key to implementation references.\n */\nexport async function discoverAllImplementations(\n  adapters: { fs: FsAdapter },\n  options: DiscoveryOptions = {}\n): Promise<Map<string, SpecReferenceMatch[]>> {\n  const { fs } = adapters;\n  const includePatterns = options.includePatterns ?? DEFAULT_INCLUDE_PATTERNS;\n  const excludePatterns = options.excludePatterns ?? DEFAULT_EXCLUDE_PATTERNS;\n\n  const specToImplementations = new Map<string, SpecReferenceMatch[]>();\n\n  // Scan each include pattern\n  for (const pattern of includePatterns) {\n    const files = await fs.glob({ pattern, ignore: excludePatterns });\n\n    for (const filePath of files) {\n      try {\n        const content = await fs.readFile(filePath);\n        const references = extractSpecReferences(content, filePath);\n\n        // Group by spec key\n        for (const ref of references) {\n          const existing = specToImplementations.get(ref.specKey) ?? [];\n          existing.push(ref);\n          specToImplementations.set(ref.specKey, existing);\n        }\n      } catch {\n        // Skip files that can't be read\n      }\n    }\n  }\n\n  return specToImplementations;\n}\n"],"mappings":"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"}
+{"version":3,"file":"discovery.mjs","names":[],"sources":["../../../src/services/implementation/discovery.ts"],"sourcesContent":["/**\n * Implementation auto-discovery service.\n *\n * Scans workspace files to find implementations that reference specs.\n * Uses regex-based pattern matching for performance (avoids full AST parsing).\n */\n\nimport type { FsAdapter } from '../../ports/fs';\nimport type { ImplementationType } from '@contractspec/lib.contracts';\nimport type { DiscoveryOptions, SpecReferenceMatch } from './types';\nimport { DEFAULT_FS_IGNORES, DEFAULT_SPEC_PATTERNS } from '../../adapters';\n\n/**\n * Patterns for detecting spec references in source code.\n */\nconst SPEC_REFERENCE_PATTERNS = {\n  // import { SpecName } from './path'\n  namedImport:\n    /import\\s*\\{[^}]*\\b(\\w+(?:Spec|Contract|Command|Query))\\b[^}]*\\}\\s*from/g,\n  // import SpecName from './path'\n  defaultImport: /import\\s+(\\w+(?:Spec|Contract|Command|Query))\\s+from/g,\n  // ContractHandler<typeof SpecName>\n  contractHandler: /ContractHandler\\s*<\\s*typeof\\s+(\\w+)\\s*>/g,\n  // typeof SpecName (generic usage)\n  typeofSpec: /typeof\\s+(\\w+(?:Spec|Contract|Command|Query))\\b/g,\n  // spec: SpecKey or spec = SpecKey\n  specAssignment:\n    /(?:spec|contract)\\s*[:=]\\s*(\\w+(?:Spec|Contract|Command|Query))\\b/gi,\n};\n\n/**\n * File patterns that indicate implementation types.\n */\nconst IMPLEMENTATION_TYPE_PATTERNS: Record<string, ImplementationType> = {\n  '.handler.ts': 'handler',\n  '.handler.tsx': 'handler',\n  '.service.ts': 'service',\n  '.service.tsx': 'service',\n  '.test.ts': 'test',\n  '.test.tsx': 'test',\n  '.spec.ts': 'test',\n  '.spec.tsx': 'test',\n  '.component.tsx': 'component',\n  '.tsx': 'component', // Default for TSX files\n  '.form.tsx': 'form',\n  '.hook.ts': 'hook',\n  '.hook.tsx': 'hook',\n};\n\n/**\n * Infer implementation type from file path.\n */\nexport function inferImplementationType(filePath: string): ImplementationType {\n  const lowerPath = filePath.toLowerCase();\n\n  // Check specific patterns first (order matters)\n  for (const [pattern, type] of Object.entries(IMPLEMENTATION_TYPE_PATTERNS)) {\n    if (lowerPath.endsWith(pattern)) {\n      return type;\n    }\n  }\n\n  // Check directory patterns\n  if (lowerPath.includes('/handlers/')) return 'handler';\n  if (lowerPath.includes('/services/')) return 'service';\n  if (lowerPath.includes('/components/')) return 'component';\n  if (lowerPath.includes('/forms/')) return 'form';\n  if (lowerPath.includes('/hooks/')) return 'hook';\n  if (lowerPath.includes('/__tests__/')) return 'test';\n\n  return 'other';\n}\n\n/**\n * Extract spec references from source code.\n */\nexport function extractSpecReferences(\n  code: string,\n  filePath: string\n): SpecReferenceMatch[] {\n  const matches: SpecReferenceMatch[] = [];\n  const seenSpecs = new Set<string>();\n\n  // Helper to add unique matches\n  const addMatch = (\n    specKey: string,\n    referenceType: SpecReferenceMatch['referenceType'],\n    lineNumber?: number\n  ) => {\n    const key = `${specKey}:${referenceType}`;\n    if (seenSpecs.has(key)) return;\n    seenSpecs.add(key);\n\n    matches.push({\n      filePath,\n      specKey,\n      referenceType,\n      lineNumber,\n      inferredType: inferImplementationType(filePath),\n    });\n  };\n\n  // Find line number for a match position\n  const getLineNumber = (position: number): number => {\n    const lines = code.substring(0, position).split('\\n');\n    return lines.length;\n  };\n\n  // Check ContractHandler pattern (most specific)\n  let match: RegExpExecArray | null;\n  const handlerPattern = new RegExp(SPEC_REFERENCE_PATTERNS.contractHandler);\n  while ((match = handlerPattern.exec(code)) !== null) {\n    if (match[1]) {\n      addMatch(match[1], 'handler', getLineNumber(match.index));\n    }\n  }\n\n  // Check typeof pattern\n  const typeofPattern = new RegExp(SPEC_REFERENCE_PATTERNS.typeofSpec);\n  while ((match = typeofPattern.exec(code)) !== null) {\n    if (match[1]) {\n      addMatch(match[1], 'typeof', getLineNumber(match.index));\n    }\n  }\n\n  // Check named imports\n  const namedPattern = new RegExp(SPEC_REFERENCE_PATTERNS.namedImport);\n  while ((match = namedPattern.exec(code)) !== null) {\n    // Extract all spec names from the import statement\n    const importBlock = match[0];\n    const specNames = importBlock.match(\n      /\\b(\\w+(?:Spec|Contract|Command|Query))\\b/g\n    );\n    if (specNames) {\n      for (const name of specNames) {\n        addMatch(name, 'import', getLineNumber(match.index));\n      }\n    }\n  }\n\n  // Check default imports\n  const defaultPattern = new RegExp(SPEC_REFERENCE_PATTERNS.defaultImport);\n  while ((match = defaultPattern.exec(code)) !== null) {\n    if (match[1]) {\n      addMatch(match[1], 'import', getLineNumber(match.index));\n    }\n  }\n\n  // Check spec assignments\n  const assignPattern = new RegExp(SPEC_REFERENCE_PATTERNS.specAssignment);\n  while ((match = assignPattern.exec(code)) !== null) {\n    if (match[1]) {\n      addMatch(match[1], 'unknown', getLineNumber(match.index));\n    }\n  }\n\n  return matches;\n}\n\n/**\n * Default glob patterns for implementation files.\n */\nconst DEFAULT_INCLUDE_PATTERNS = ['**/*.ts(x)'];\n\n/**\n * Discover implementations that reference a specific spec.\n */\nexport async function discoverImplementationsForSpec(\n  specKey: string,\n  adapters: { fs: FsAdapter },\n  options: DiscoveryOptions = {}\n): Promise<SpecReferenceMatch[]> {\n  const { fs } = adapters;\n  const includePatterns = options.includePatterns ?? DEFAULT_INCLUDE_PATTERNS;\n  const excludePatterns = options.excludePatterns ?? [\n    ...new Set([...DEFAULT_FS_IGNORES, ...DEFAULT_SPEC_PATTERNS]),\n  ];\n\n  const allMatches: SpecReferenceMatch[] = [];\n\n  // Scan each include pattern\n  for (const pattern of includePatterns) {\n    const files = await fs.glob({ pattern, ignore: excludePatterns });\n\n    for (const filePath of files) {\n      try {\n        const content = await fs.readFile(filePath);\n        const references = extractSpecReferences(content, filePath);\n\n        // Filter to only references for the target spec\n        const matchingRefs = references.filter(\n          (ref) => ref.specKey === specKey\n        );\n        allMatches.push(...matchingRefs);\n      } catch {\n        // Skip files that can't be read\n      }\n    }\n  }\n\n  return allMatches;\n}\n\n/**\n * Discover all spec references in the workspace.\n * Returns a map of spec key to implementation references.\n */\nexport async function discoverAllImplementations(\n  adapters: { fs: FsAdapter },\n  options: DiscoveryOptions = {}\n): Promise<Map<string, SpecReferenceMatch[]>> {\n  const { fs } = adapters;\n  const includePatterns = options.includePatterns ?? DEFAULT_INCLUDE_PATTERNS;\n  const excludePatterns = options.excludePatterns ?? [\n    ...new Set([...DEFAULT_FS_IGNORES, ...DEFAULT_SPEC_PATTERNS]),\n  ];\n\n  const specToImplementations = new Map<string, SpecReferenceMatch[]>();\n\n  // Scan each include pattern\n  for (const pattern of includePatterns) {\n    const files = await fs.glob({ pattern, ignore: excludePatterns });\n\n    for (const filePath of files) {\n      try {\n        const content = await fs.readFile(filePath);\n        const references = extractSpecReferences(content, filePath);\n\n        // Group by spec key\n        for (const ref of references) {\n          const existing = specToImplementations.get(ref.specKey) ?? [];\n          existing.push(ref);\n          specToImplementations.set(ref.specKey, existing);\n        }\n      } catch {\n        // Skip files that can't be read\n      }\n    }\n  }\n\n  return specToImplementations;\n}\n"],"mappings":"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"}

package/dist/services/implementation/index.d.mts

@@ -1,6 +1,6 @@
 import { DiscoveryOptions, ImplementationSource, ImplementationStatus, ResolvedImplementation, ResolverOptions, SpecImplementationResult, SpecReferenceMatch } from "./types.mjs";
 import { discoverAllImplementations, discoverImplementationsForSpec, extractSpecReferences, inferImplementationType } from "./discovery.mjs";
-import { getSpecKeyVariants, parseExplicitImplementations } from "./resolver/parsers.mjs";
+import { parseExplicitImplementations } from "./resolver/parsers.mjs";
 import { getConventionPaths, toKebabCase } from "./resolver/conventions.mjs";
 import { determineStatus, getImplementationSummary } from "./resolver/status.mjs";
 import { resolveAllImplementations, resolveImplementations } from "./resolver/index.mjs";

package/dist/services/implementation/index.mjs

@@ -1,6 +1,6 @@
 import { discoverAllImplementations, discoverImplementationsForSpec, extractSpecReferences, inferImplementationType } from "./discovery.mjs";
 import { getConventionPaths, toKebabCase } from "./resolver/conventions.mjs";
-import { getSpecKeyVariants, parseExplicitImplementations } from "./resolver/parsers.mjs";
+import { parseExplicitImplementations } from "./resolver/parsers.mjs";
 import { determineStatus, getImplementationSummary } from "./resolver/status.mjs";
 import { resolveAllImplementations, resolveImplementations } from "./resolver/index.mjs";
 

package/dist/services/implementation/resolver/index.d.mts

@@ -1,24 +1,26 @@
 import { FsAdapter } from "../../../ports/fs.mjs";
 import { ResolverOptions, SpecImplementationResult } from "../types.mjs";
-import { getSpecKeyVariants, parseExplicitImplementations } from "./parsers.mjs";
+import { parseExplicitImplementations } from "./parsers.mjs";
 import { getConventionPaths, toKebabCase } from "./conventions.mjs";
 import { determineStatus, getImplementationSummary } from "./status.mjs";
-import { WorkspaceConfig } from "@contractspec/module.workspace";
+import { SpecScanResult } from "@contractspec/module.workspace";
+import { ResolvedContractsrcConfig } from "@contractspec/lib.contracts";
+import { Ora } from "ora";
 
 //#region src/services/implementation/resolver/index.d.ts
 
 /**
  * Resolve all implementations for a spec file.
  */
-declare function resolveImplementations(specFile: string, adapters: {
+declare function resolveImplementations(specFile: SpecScanResult, adapters: {
   fs: FsAdapter;
-}, config: WorkspaceConfig, options?: ResolverOptions): Promise<SpecImplementationResult>;
+}, config: ResolvedContractsrcConfig, options?: ResolverOptions, spinner?: Ora): Promise<SpecImplementationResult>;
 /**
  * Resolve implementations for multiple spec files.
  */
-declare function resolveAllImplementations(specFiles: string[], adapters: {
+declare function resolveAllImplementations(specFiles: SpecScanResult[], adapters: {
   fs: FsAdapter;
-}, config: WorkspaceConfig, options?: ResolverOptions): Promise<SpecImplementationResult[]>;
+}, config: ResolvedContractsrcConfig, options?: ResolverOptions, spinner?: Ora): Promise<SpecImplementationResult[]>;
 //#endregion
 export { resolveAllImplementations, resolveImplementations };
 //# sourceMappingURL=index.d.mts.map

package/dist/services/implementation/resolver/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/implementation/resolver/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAyKA;;AAGU,iBA5HY,sBAAA,CA4HZ,QAAA,EAAA,MAAA,EAAA,QAAA,EAAA;EACC,EAAA,EA3HO,SA2HP;CACA,EAAA,MAAA,EA3HD,eA2HC,EAAA,OAAA,CAAA,EA1HA,eA0HA,CAAA,EAzHR,OAyHQ,CAzHA,wBAyHA,CAAA;;;;iBALW,yBAAA;MAEJ;WACR,2BACC,kBACR,QAAQ"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/implementation/resolver/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;AA0KsB,iBAvHA,sBAAA,CAuHyB,QAAA,EAtHnC,cAsHmC,EAAA,QAAA,EAAA;EAClC,EAAA,EAtHK,SAsHL;CACK,EAAA,MAAA,EAtHR,yBAsHQ,EAAA,OAAA,CAAA,EArHP,eAqHO,EAAA,OAAA,CAAA,EApHN,GAoHM,CAAA,EAnHf,OAmHe,CAnHP,wBAmHO,CAAA;;;;AAIP,iBANW,yBAAA,CAMX,SAAA,EALE,cAKF,EAAA,EAAA,QAAA,EAAA;EAAR,EAAA,EAJe,SAIf;CAAO,EAAA,MAAA,EAHA,yBAGA,EAAA,OAAA,CAAA,EAFC,eAED,EAAA,OAAA,CAAA,EADE,GACF,CAAA,EAAP,OAAO,CAAC,wBAAD,EAAA,CAAA"}

package/dist/services/implementation/resolver/index.mjs

@@ -1,8 +1,7 @@
 import { discoverImplementationsForSpec } from "../discovery.mjs";
 import { getConventionPaths, toKebabCase } from "./conventions.mjs";
-import { getSpecKeyVariants, parseExplicitImplementations } from "./parsers.mjs";
+import { parseExplicitImplementations } from "./parsers.mjs";
 import { determineStatus, getImplementationSummary } from "./status.mjs";
-import { scanSpecSource } from "@contractspec/module.workspace";
 import path from "path";
 import { createHash } from "crypto";
 
@@ -30,78 +29,81 @@ function computeHash(content) {
 /**
 * Resolve all implementations for a spec file.
 */
-async function resolveImplementations(specFile, adapters, config, options = {}) {
+async function resolveImplementations(specFile, adapters, config, options = {}, spinner) {
 	const opts = {
 		...DEFAULT_OPTIONS,
 		...options
 	};
+	const specHash = opts.computeHashes ? computeHash(specFile.sourceBlock || "") : void 0;
+	const specKey = specFile.key ?? path.basename(specFile.filePath).replace(/\.[jt]s$/, "");
+	const specVersion = specFile.version ?? "1.0.0";
 	const { fs } = adapters;
-	if (!await fs.exists(specFile)) throw new Error(`Spec file not found: ${specFile}`);
-	const specContent = await fs.readFile(specFile);
-	const specHash = opts.computeHashes ? computeHash(specContent) : void 0;
-	const scan = scanSpecSource(specContent, specFile);
-	const specKey = scan.key ?? path.basename(specFile).replace(/\.[jt]s$/, "");
-	const specVersion = scan.version ?? "1.0.0";
-	const specType = scan.specType ?? "operation";
 	const implementations = [];
 	const seenPaths = /* @__PURE__ */ new Set();
 	const addImpl = async (path$1, type, source, description) => {
 		if (seenPaths.has(path$1)) return;
 		seenPaths.add(path$1);
 		const exists = await fs.exists(path$1);
-		let contentHash;
+		let implementationSourceContent = void 0;
+		let implementationSourceHash = void 0;
 		if (exists && opts.computeHashes) try {
-			contentHash = computeHash(await fs.readFile(path$1));
+			implementationSourceContent = await fs.readFile(path$1);
+			implementationSourceHash = computeHash(implementationSourceContent);
 		} catch {}
 		implementations.push({
 			path: path$1,
 			type,
 			source,
 			exists,
-			contentHash,
+			implementationSourceContent,
+			implementationSourceHash,
 			description
 		});
 	};
-	if (opts.includeExplicit) {
-		const explicitImpls = parseExplicitImplementations(specContent);
+	if (opts.includeExplicit && specFile.sourceBlock) {
+		if (spinner) spinner.suffixText = `Discover explicit implementations`;
+		const explicitImpls = parseExplicitImplementations(specFile.sourceBlock);
 		for (const impl of explicitImpls) await addImpl(impl.path, impl.type, "explicit", impl.description);
 	}
 	if (opts.includeDiscovered) {
+		if (spinner) spinner.suffixText = `Discover implementations`;
 		const discovered = await discoverImplementationsForSpec(specKey, adapters, opts);
-		const specKeyVariants = getSpecKeyVariants(specKey);
-		for (const variant of specKeyVariants) {
-			const variantDiscovered = await discoverImplementationsForSpec(variant, adapters, opts);
-			discovered.push(...variantDiscovered);
-		}
 		for (const ref of discovered) {
-			if (ref.filePath === specFile) continue;
+			if (ref.filePath === specFile.filePath) continue;
 			await addImpl(ref.filePath, ref.inferredType, "discovered");
 		}
 	}
 	if (opts.includeConvention) {
-		const conventionPaths = getConventionPaths(specType, specKey, opts.outputDir ?? config.outputDir ?? "./src");
+		if (spinner) spinner.suffixText = `Discover implementations based on conventions`;
+		const outputDir = opts.outputDir ?? config.outputDir ?? "./src";
+		const conventionPaths = getConventionPaths(specFile.specType, specKey, outputDir);
 		for (const { path: path$1, type } of conventionPaths) await addImpl(path$1, type, "convention");
 	}
+	if (spinner) spinner.suffixText = `Determine implementation status`;
+	const status = determineStatus(implementations);
 	return {
 		specKey,
 		specVersion,
-		specPath: specFile,
-		specType,
+		specPath: specFile.filePath,
+		specType: specFile.specType,
 		implementations,
-		status: determineStatus(implementations),
+		status,
 		specHash
 	};
 }
 /**
 * Resolve implementations for multiple spec files.
 */
-async function resolveAllImplementations(specFiles, adapters, config, options = {}) {
+async function resolveAllImplementations(specFiles, adapters, config, options = {}, spinner) {
 	const results = [];
-	for (const specFile of specFiles) try {
-		const result = await resolveImplementations(specFile, adapters, config, options);
-		results.push(result);
-	} catch (error) {
-		console.error(`Failed to resolve implementations for ${specFile}:`, error);
+	for (const specFile of specFiles) {
+		if (spinner) spinner.text = `Resolving implementation... (${results.length}/${specFiles.length})`;
+		try {
+			const result = await resolveImplementations(specFile, adapters, config, options, spinner);
+			results.push(result);
+		} catch (error) {
+			console.error(`Failed to resolve implementations for ${specFile}:`, error);
+		}
 	}
 	return results;
 }

package/dist/services/implementation/resolver/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["path"],"sources":["../../../../src/services/implementation/resolver/index.ts"],"sourcesContent":["/**\n * Implementation resolver service.\n *\n * Resolves all implementations for a spec by merging:\n * 1. Explicit mappings from spec.implementations\n * 2. Auto-discovered references from workspace scanning\n * 3. Convention-based paths (naming conventions)\n */\n\nimport { createHash } from 'crypto';\nimport path from 'path';\n\nimport type { WorkspaceConfig } from '@contractspec/module.workspace';\nimport { scanSpecSource } from '@contractspec/module.workspace';\nimport type { ImplementationType } from '@contractspec/lib.contracts';\nimport type { FsAdapter } from '../../../ports/fs';\nimport type {\n  ResolverOptions,\n  ResolvedImplementation,\n  SpecImplementationResult,\n} from '../types';\nimport { discoverImplementationsForSpec } from '../discovery';\n\nimport { getConventionPaths } from './conventions';\nimport { getSpecKeyVariants, parseExplicitImplementations } from './parsers';\nimport { determineStatus } from './status';\n\nexport * from './parsers';\nexport * from './conventions';\nexport * from './status';\n\nconst DEFAULT_OPTIONS: ResolverOptions = {\n  includeExplicit: true,\n  includeDiscovered: true,\n  includeConvention: true,\n  computeHashes: true,\n};\n\n/**\n * Compute SHA256 hash of content.\n */\nfunction computeHash(content: string): string {\n  return createHash('sha256').update(content).digest('hex');\n}\n\n/**\n * Resolve all implementations for a spec file.\n */\nexport async function resolveImplementations(\n  specFile: string,\n  adapters: { fs: FsAdapter },\n  config: WorkspaceConfig,\n  options: ResolverOptions = {}\n): Promise<SpecImplementationResult> {\n  const opts = { ...DEFAULT_OPTIONS, ...options };\n  const { fs } = adapters;\n\n  // Read and parse spec file\n  const specExists = await fs.exists(specFile);\n  if (!specExists) {\n    throw new Error(`Spec file not found: ${specFile}`);\n  }\n\n  const specContent = await fs.readFile(specFile);\n  const specHash = opts.computeHashes ? computeHash(specContent) : undefined;\n  const scan = scanSpecSource(specContent, specFile);\n\n  const specKey = scan.key ?? path.basename(specFile).replace(/\\.[jt]s$/, '');\n  const specVersion = scan.version ?? '1.0.0';\n  const specType = scan.specType ?? 'operation';\n\n  const implementations: ResolvedImplementation[] = [];\n  const seenPaths = new Set<string>();\n\n  // Helper to add unique implementations\n  const addImpl = async (\n    path: string,\n    type: ImplementationType,\n    source: ResolvedImplementation['source'],\n    description?: string\n  ) => {\n    if (seenPaths.has(path)) return;\n    seenPaths.add(path);\n\n    const exists = await fs.exists(path);\n    let contentHash: string | undefined;\n\n    if (exists && opts.computeHashes) {\n      try {\n        const content = await fs.readFile(path);\n        contentHash = computeHash(content);\n      } catch {\n        // Ignore hash computation errors\n      }\n    }\n\n    implementations.push({\n      path,\n      type,\n      source,\n      exists,\n      contentHash,\n      description,\n    });\n  };\n\n  // 1. Add explicit implementations from spec\n  if (opts.includeExplicit) {\n    // Parse explicit implementations from spec source\n    const explicitImpls = parseExplicitImplementations(specContent);\n    for (const impl of explicitImpls) {\n      await addImpl(impl.path, impl.type, 'explicit', impl.description);\n    }\n  }\n\n  // 2. Add auto-discovered implementations\n  if (opts.includeDiscovered) {\n    const discovered = await discoverImplementationsForSpec(\n      specKey,\n      adapters,\n      opts\n    );\n\n    // Also search for spec key variants\n    const specKeyVariants = getSpecKeyVariants(specKey);\n    for (const variant of specKeyVariants) {\n      const variantDiscovered = await discoverImplementationsForSpec(\n        variant,\n        adapters,\n        opts\n      );\n      discovered.push(...variantDiscovered);\n    }\n\n    for (const ref of discovered) {\n      // Skip the spec file itself\n      if (ref.filePath === specFile) continue;\n\n      await addImpl(ref.filePath, ref.inferredType, 'discovered');\n    }\n  }\n\n  // 3. Add convention-based implementations\n  if (opts.includeConvention) {\n    const outputDir = opts.outputDir ?? config.outputDir ?? './src';\n    const conventionPaths = getConventionPaths(specType, specKey, outputDir);\n\n    for (const { path, type } of conventionPaths) {\n      await addImpl(path, type, 'convention');\n    }\n  }\n\n  // Determine overall status\n  const status = determineStatus(implementations);\n\n  return {\n    specKey,\n    specVersion,\n    specPath: specFile,\n    specType,\n    implementations,\n    status,\n    specHash,\n  };\n}\n\n/**\n * Resolve implementations for multiple spec files.\n */\nexport async function resolveAllImplementations(\n  specFiles: string[],\n  adapters: { fs: FsAdapter },\n  config: WorkspaceConfig,\n  options: ResolverOptions = {}\n): Promise<SpecImplementationResult[]> {\n  const results: SpecImplementationResult[] = [];\n\n  for (const specFile of specFiles) {\n    try {\n      const result = await resolveImplementations(\n        specFile,\n        adapters,\n        config,\n        options\n      );\n      results.push(result);\n    } catch (error) {\n      // Log error but continue with other specs\n      console.error(\n        `Failed to resolve implementations for ${specFile}:`,\n        error\n      );\n    }\n  }\n\n  return results;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA+BA,MAAM,kBAAmC;CACvC,iBAAiB;CACjB,mBAAmB;CACnB,mBAAmB;CACnB,eAAe;CAChB;;;;AAKD,SAAS,YAAY,SAAyB;AAC5C,QAAO,WAAW,SAAS,CAAC,OAAO,QAAQ,CAAC,OAAO,MAAM;;;;;AAM3D,eAAsB,uBACpB,UACA,UACA,QACA,UAA2B,EAAE,EACM;CACnC,MAAM,OAAO;EAAE,GAAG;EAAiB,GAAG;EAAS;CAC/C,MAAM,EAAE,OAAO;AAIf,KAAI,CADe,MAAM,GAAG,OAAO,SAAS,CAE1C,OAAM,IAAI,MAAM,wBAAwB,WAAW;CAGrD,MAAM,cAAc,MAAM,GAAG,SAAS,SAAS;CAC/C,MAAM,WAAW,KAAK,gBAAgB,YAAY,YAAY,GAAG;CACjE,MAAM,OAAO,eAAe,aAAa,SAAS;CAElD,MAAM,UAAU,KAAK,OAAO,KAAK,SAAS,SAAS,CAAC,QAAQ,YAAY,GAAG;CAC3E,MAAM,cAAc,KAAK,WAAW;CACpC,MAAM,WAAW,KAAK,YAAY;CAElC,MAAM,kBAA4C,EAAE;CACpD,MAAM,4BAAY,IAAI,KAAa;CAGnC,MAAM,UAAU,OACd,QACA,MACA,QACA,gBACG;AACH,MAAI,UAAU,IAAIA,OAAK,CAAE;AACzB,YAAU,IAAIA,OAAK;EAEnB,MAAM,SAAS,MAAM,GAAG,OAAOA,OAAK;EACpC,IAAI;AAEJ,MAAI,UAAU,KAAK,cACjB,KAAI;AAEF,iBAAc,YADE,MAAM,GAAG,SAASA,OAAK,CACL;UAC5B;AAKV,kBAAgB,KAAK;GACnB;GACA;GACA;GACA;GACA;GACA;GACD,CAAC;;AAIJ,KAAI,KAAK,iBAAiB;EAExB,MAAM,gBAAgB,6BAA6B,YAAY;AAC/D,OAAK,MAAM,QAAQ,cACjB,OAAM,QAAQ,KAAK,MAAM,KAAK,MAAM,YAAY,KAAK,YAAY;;AAKrE,KAAI,KAAK,mBAAmB;EAC1B,MAAM,aAAa,MAAM,+BACvB,SACA,UACA,KACD;EAGD,MAAM,kBAAkB,mBAAmB,QAAQ;AACnD,OAAK,MAAM,WAAW,iBAAiB;GACrC,MAAM,oBAAoB,MAAM,+BAC9B,SACA,UACA,KACD;AACD,cAAW,KAAK,GAAG,kBAAkB;;AAGvC,OAAK,MAAM,OAAO,YAAY;AAE5B,OAAI,IAAI,aAAa,SAAU;AAE/B,SAAM,QAAQ,IAAI,UAAU,IAAI,cAAc,aAAa;;;AAK/D,KAAI,KAAK,mBAAmB;EAE1B,MAAM,kBAAkB,mBAAmB,UAAU,SADnC,KAAK,aAAa,OAAO,aAAa,QACgB;AAExE,OAAK,MAAM,EAAE,cAAM,UAAU,gBAC3B,OAAM,QAAQA,QAAM,MAAM,aAAa;;AAO3C,QAAO;EACL;EACA;EACA,UAAU;EACV;EACA;EACA,QARa,gBAAgB,gBAAgB;EAS7C;EACD;;;;;AAMH,eAAsB,0BACpB,WACA,UACA,QACA,UAA2B,EAAE,EACQ;CACrC,MAAM,UAAsC,EAAE;AAE9C,MAAK,MAAM,YAAY,UACrB,KAAI;EACF,MAAM,SAAS,MAAM,uBACnB,UACA,UACA,QACA,QACD;AACD,UAAQ,KAAK,OAAO;UACb,OAAO;AAEd,UAAQ,MACN,yCAAyC,SAAS,IAClD,MACD;;AAIL,QAAO"}
+{"version":3,"file":"index.mjs","names":["path"],"sources":["../../../../src/services/implementation/resolver/index.ts"],"sourcesContent":["/**\n * Implementation resolver service.\n *\n * Resolves all implementations for a spec by merging:\n * 1. Explicit mappings from spec.implementations\n * 2. Auto-discovered references from workspace scanning\n * 3. Convention-based paths (naming conventions)\n */\n\nimport { createHash } from 'crypto';\n\nimport type { SpecScanResult } from '@contractspec/module.workspace';\nimport type {\n  ImplementationType,\n  ResolvedContractsrcConfig,\n} from '@contractspec/lib.contracts';\nimport type { FsAdapter } from '../../../ports/fs';\nimport type {\n  ResolvedImplementation,\n  ResolverOptions,\n  SpecImplementationResult,\n} from '../types';\nimport { discoverImplementationsForSpec } from '../discovery';\n\nimport { getConventionPaths } from './conventions';\nimport { parseExplicitImplementations } from './parsers';\nimport { determineStatus } from './status';\nimport path from 'path';\nimport type { Ora } from 'ora';\n\nexport * from './parsers';\nexport * from './conventions';\nexport * from './status';\n\nconst DEFAULT_OPTIONS: ResolverOptions = {\n  includeExplicit: true,\n  includeDiscovered: true,\n  includeConvention: true,\n  computeHashes: true,\n};\n\n/**\n * Compute SHA256 hash of content.\n */\nfunction computeHash(content: string): string {\n  return createHash('sha256').update(content).digest('hex');\n}\n\n/**\n * Resolve all implementations for a spec file.\n */\nexport async function resolveImplementations(\n  specFile: SpecScanResult,\n  adapters: { fs: FsAdapter },\n  config: ResolvedContractsrcConfig,\n  options: ResolverOptions = {},\n  spinner?: Ora\n): Promise<SpecImplementationResult> {\n  const opts = { ...DEFAULT_OPTIONS, ...options };\n  const specHash = opts.computeHashes\n    ? computeHash(specFile.sourceBlock || '')\n    : undefined;\n\n  const specKey =\n    specFile.key ?? path.basename(specFile.filePath).replace(/\\.[jt]s$/, '');\n  const specVersion = specFile.version ?? '1.0.0';\n\n  const { fs } = adapters;\n\n  const implementations: ResolvedImplementation[] = [];\n  const seenPaths = new Set<string>();\n\n  // Helper to add unique implementations\n  const addImpl = async (\n    path: string,\n    type: ImplementationType,\n    source: ResolvedImplementation['source'],\n    description?: string\n  ) => {\n    if (seenPaths.has(path)) return;\n    seenPaths.add(path);\n\n    const exists = await fs.exists(path);\n    let implementationSourceContent: string | undefined = undefined;\n    let implementationSourceHash: string | undefined = undefined;\n\n    if (exists && opts.computeHashes) {\n      try {\n        implementationSourceContent = await fs.readFile(path);\n        implementationSourceHash = computeHash(implementationSourceContent);\n      } catch {\n        // Ignore hash computation errors\n      }\n    }\n\n    implementations.push({\n      path,\n      type,\n      source,\n      exists,\n      implementationSourceContent,\n      implementationSourceHash,\n      description,\n    });\n  };\n\n  // 1. Add explicit implementations from spec\n  if (opts.includeExplicit && specFile.sourceBlock) {\n    if (spinner) spinner.suffixText = `Discover explicit implementations`;\n\n    // Parse explicit implementations from spec source\n    const explicitImpls = parseExplicitImplementations(specFile.sourceBlock);\n    for (const impl of explicitImpls) {\n      await addImpl(impl.path, impl.type, 'explicit', impl.description);\n    }\n  }\n\n  // 2. Add auto-discovered implementations\n  if (opts.includeDiscovered) {\n    if (spinner) spinner.suffixText = `Discover implementations`;\n\n    const discovered = await discoverImplementationsForSpec(\n      specKey,\n      adapters,\n      opts\n    );\n\n    for (const ref of discovered) {\n      // Skip the spec file itself\n      if (ref.filePath === specFile.filePath) continue;\n\n      await addImpl(ref.filePath, ref.inferredType, 'discovered');\n    }\n  }\n\n  // 3. Add convention-based implementations\n  if (opts.includeConvention) {\n    if (spinner)\n      spinner.suffixText = `Discover implementations based on conventions`;\n\n    const outputDir = opts.outputDir ?? config.outputDir ?? './src';\n    const conventionPaths = getConventionPaths(\n      specFile.specType,\n      specKey,\n      outputDir\n    );\n\n    for (const { path, type } of conventionPaths) {\n      await addImpl(path, type, 'convention');\n    }\n  }\n\n  if (spinner) spinner.suffixText = `Determine implementation status`;\n  // Determine overall status\n  const status = determineStatus(implementations);\n\n  return {\n    specKey,\n    specVersion,\n    specPath: specFile.filePath,\n    specType: specFile.specType,\n    implementations,\n    status,\n    specHash,\n  };\n}\n\n/**\n * Resolve implementations for multiple spec files.\n */\nexport async function resolveAllImplementations(\n  specFiles: SpecScanResult[],\n  adapters: { fs: FsAdapter },\n  config: ResolvedContractsrcConfig,\n  options: ResolverOptions = {},\n  spinner?: Ora\n): Promise<SpecImplementationResult[]> {\n  const results: SpecImplementationResult[] = [];\n\n  for (const specFile of specFiles) {\n    if (spinner)\n      spinner.text = `Resolving implementation... (${results.length}/${specFiles.length})`;\n\n    try {\n      const result = await resolveImplementations(\n        specFile,\n        adapters,\n        config,\n        options,\n        spinner\n      );\n      results.push(result);\n    } catch (error) {\n      // Log error but continue with other specs\n      console.error(\n        `Failed to resolve implementations for ${specFile}:`,\n        error\n      );\n    }\n  }\n\n  return results;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAkCA,MAAM,kBAAmC;CACvC,iBAAiB;CACjB,mBAAmB;CACnB,mBAAmB;CACnB,eAAe;CAChB;;;;AAKD,SAAS,YAAY,SAAyB;AAC5C,QAAO,WAAW,SAAS,CAAC,OAAO,QAAQ,CAAC,OAAO,MAAM;;;;;AAM3D,eAAsB,uBACpB,UACA,UACA,QACA,UAA2B,EAAE,EAC7B,SACmC;CACnC,MAAM,OAAO;EAAE,GAAG;EAAiB,GAAG;EAAS;CAC/C,MAAM,WAAW,KAAK,gBAClB,YAAY,SAAS,eAAe,GAAG,GACvC;CAEJ,MAAM,UACJ,SAAS,OAAO,KAAK,SAAS,SAAS,SAAS,CAAC,QAAQ,YAAY,GAAG;CAC1E,MAAM,cAAc,SAAS,WAAW;CAExC,MAAM,EAAE,OAAO;CAEf,MAAM,kBAA4C,EAAE;CACpD,MAAM,4BAAY,IAAI,KAAa;CAGnC,MAAM,UAAU,OACd,QACA,MACA,QACA,gBACG;AACH,MAAI,UAAU,IAAIA,OAAK,CAAE;AACzB,YAAU,IAAIA,OAAK;EAEnB,MAAM,SAAS,MAAM,GAAG,OAAOA,OAAK;EACpC,IAAI,8BAAkD;EACtD,IAAI,2BAA+C;AAEnD,MAAI,UAAU,KAAK,cACjB,KAAI;AACF,iCAA8B,MAAM,GAAG,SAASA,OAAK;AACrD,8BAA2B,YAAY,4BAA4B;UAC7D;AAKV,kBAAgB,KAAK;GACnB;GACA;GACA;GACA;GACA;GACA;GACA;GACD,CAAC;;AAIJ,KAAI,KAAK,mBAAmB,SAAS,aAAa;AAChD,MAAI,QAAS,SAAQ,aAAa;EAGlC,MAAM,gBAAgB,6BAA6B,SAAS,YAAY;AACxE,OAAK,MAAM,QAAQ,cACjB,OAAM,QAAQ,KAAK,MAAM,KAAK,MAAM,YAAY,KAAK,YAAY;;AAKrE,KAAI,KAAK,mBAAmB;AAC1B,MAAI,QAAS,SAAQ,aAAa;EAElC,MAAM,aAAa,MAAM,+BACvB,SACA,UACA,KACD;AAED,OAAK,MAAM,OAAO,YAAY;AAE5B,OAAI,IAAI,aAAa,SAAS,SAAU;AAExC,SAAM,QAAQ,IAAI,UAAU,IAAI,cAAc,aAAa;;;AAK/D,KAAI,KAAK,mBAAmB;AAC1B,MAAI,QACF,SAAQ,aAAa;EAEvB,MAAM,YAAY,KAAK,aAAa,OAAO,aAAa;EACxD,MAAM,kBAAkB,mBACtB,SAAS,UACT,SACA,UACD;AAED,OAAK,MAAM,EAAE,cAAM,UAAU,gBAC3B,OAAM,QAAQA,QAAM,MAAM,aAAa;;AAI3C,KAAI,QAAS,SAAQ,aAAa;CAElC,MAAM,SAAS,gBAAgB,gBAAgB;AAE/C,QAAO;EACL;EACA;EACA,UAAU,SAAS;EACnB,UAAU,SAAS;EACnB;EACA;EACA;EACD;;;;;AAMH,eAAsB,0BACpB,WACA,UACA,QACA,UAA2B,EAAE,EAC7B,SACqC;CACrC,MAAM,UAAsC,EAAE;AAE9C,MAAK,MAAM,YAAY,WAAW;AAChC,MAAI,QACF,SAAQ,OAAO,gCAAgC,QAAQ,OAAO,GAAG,UAAU,OAAO;AAEpF,MAAI;GACF,MAAM,SAAS,MAAM,uBACnB,UACA,UACA,QACA,SACA,QACD;AACD,WAAQ,KAAK,OAAO;WACb,OAAO;AAEd,WAAQ,MACN,yCAAyC,SAAS,IAClD,MACD;;;AAIL,QAAO"}

package/dist/services/implementation/resolver/parsers.d.mts

@@ -7,10 +7,6 @@ import { ImplementationRef } from "@contractspec/lib.contracts";
  * Looks for: implementations: [{ path: '...', type: '...' }] inside the main spec object.
  */
 declare function parseExplicitImplementations(code: string): ImplementationRef[];
-/**
- * Get common variants of a spec key for discovery.
- */
-declare function getSpecKeyVariants(specKey: string): string[];
 //#endregion
-export { getSpecKeyVariants, parseExplicitImplementations };
+export { parseExplicitImplementations };
 //# sourceMappingURL=parsers.d.mts.map

package/dist/services/implementation/resolver/parsers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"parsers.d.mts","names":[],"sources":["../../../../src/services/implementation/resolver/parsers.ts"],"sourcesContent":[],"mappings":";;;;AAqIA;;;;iBAvHgB,4BAAA,gBAEb;;;;iBAqHa,kBAAA"}
+{"version":3,"file":"parsers.d.mts","names":[],"sources":["../../../../src/services/implementation/resolver/parsers.ts"],"sourcesContent":[],"mappings":";;;;;;;;iBAcgB,4BAAA,gBAEb"}

package/dist/services/implementation/resolver/parsers.mjs

@@ -76,25 +76,7 @@ function parseExplicitImplementations(code) {
 	}
 	return implementations;
 }
-/**
-* Get common variants of a spec key for discovery.
-*/
-function getSpecKeyVariants(specKey) {
-	const variants = [];
-	const base = specKey.replace(/Spec$/, "").replace(/Contract$/, "").replace(/Command$/, "").replace(/Query$/, "");
-	if (base !== specKey) {
-		variants.push(base);
-		variants.push(`${base}Spec`);
-		variants.push(`${base}Contract`);
-	}
-	const parts = specKey.split(".");
-	if (parts.length > 1) {
-		const pascalName = parts.map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join("");
-		variants.push(pascalName);
-	}
-	return variants;
-}
 
 //#endregion
-export { getSpecKeyVariants, parseExplicitImplementations };
+export { parseExplicitImplementations };
 //# sourceMappingURL=parsers.mjs.map

package/dist/services/implementation/resolver/parsers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"parsers.mjs","names":["init"],"sources":["../../../../src/services/implementation/resolver/parsers.ts"],"sourcesContent":["/**\n * Parser utilities for extracting implementation references from source code.\n */\n\nimport type {\n  ImplementationRef,\n  ImplementationType,\n} from '@contractspec/lib.contracts';\nimport { Node, Project, SyntaxKind } from 'ts-morph';\n\n/**\n * Parse explicit implementations from spec source code using ts-morph.\n * Looks for: implementations: [{ path: '...', type: '...' }] inside the main spec object.\n */\nexport function parseExplicitImplementations(\n  code: string\n): ImplementationRef[] {\n  const implementations: ImplementationRef[] = [];\n  const project = new Project({ useInMemoryFileSystem: true });\n  // Create a SourceFile\n  const sourceFile = project.createSourceFile('spec.ts', code);\n\n  // Helper to extract fields from an object literal\n  const extractImpls = (obj: Node) => {\n    if (!Node.isObjectLiteralExpression(obj)) return;\n    const prop = obj.getProperty('implementations');\n    if (prop && Node.isPropertyAssignment(prop)) {\n      const init = prop.getInitializer();\n      if (init && Node.isArrayLiteralExpression(init)) {\n        for (const elem of init.getElements()) {\n          if (Node.isObjectLiteralExpression(elem)) {\n            let pathVal: string | undefined;\n            let typeVal: ImplementationType | undefined;\n            let descVal: string | undefined;\n\n            const pathProp = elem.getProperty('path');\n            if (pathProp && Node.isPropertyAssignment(pathProp)) {\n              const init = pathProp.getInitializer();\n              if (Node.isStringLiteral(init)) {\n                pathVal = init.getLiteralText();\n              }\n            }\n\n            const typeProp = elem.getProperty('type');\n            if (typeProp && Node.isPropertyAssignment(typeProp)) {\n              const init = typeProp.getInitializer();\n              if (Node.isStringLiteral(init)) {\n                typeVal = init.getLiteralText() as ImplementationType;\n              }\n            }\n\n            const descProp = elem.getProperty('description');\n            if (descProp && Node.isPropertyAssignment(descProp)) {\n              const init = descProp.getInitializer();\n              if (Node.isStringLiteral(init)) {\n                descVal = init.getLiteralText();\n              }\n            }\n\n            if (pathVal && typeVal) {\n              implementations.push({\n                path: pathVal,\n                type: typeVal,\n                description: descVal,\n              });\n            }\n          }\n        }\n      }\n    }\n  };\n\n  // Find the spec object\n  // 1. defineCommand/Event/etc CallExpression\n  // 2. Exported object literal or variable\n\n  const callExpressions = sourceFile.getDescendantsOfKind(\n    SyntaxKind.CallExpression\n  );\n  for (const call of callExpressions) {\n    const expr = call.getExpression().getText();\n    if (\n      ['defineCommand', 'defineQuery', 'defineEvent', 'defineFeature'].includes(\n        expr\n      )\n    ) {\n      const args = call.getArguments();\n      if (args.length > 0 && Node.isObjectLiteralExpression(args[0])) {\n        extractImpls(args[0]);\n        return implementations; // Assume only one main definition per file\n      }\n    }\n  }\n\n  // Fallback: search exported variables\n  const varStmts = sourceFile.getVariableStatements();\n  for (const stmt of varStmts) {\n    if (stmt.isExported()) {\n      for (const decl of stmt.getDeclarations()) {\n        const init = decl.getInitializer();\n        if (init && Node.isObjectLiteralExpression(init)) {\n          // Check if it has 'implementations'\n          if (init.getProperty('implementations')) {\n            extractImpls(init);\n            return implementations;\n          }\n        }\n      }\n    }\n  }\n\n  // Fallback: default export\n  const exportAssign = sourceFile.getExportAssignment(\n    (d) => !d.isExportEquals()\n  );\n  if (exportAssign) {\n    const expr = exportAssign.getExpression();\n    if (Node.isObjectLiteralExpression(expr)) {\n      extractImpls(expr);\n    } else if (\n      Node.isAsExpression(expr) &&\n      Node.isObjectLiteralExpression(expr.getExpression())\n    ) {\n      extractImpls(expr.getExpression());\n    }\n  }\n\n  return implementations;\n}\n\n/**\n * Get common variants of a spec key for discovery.\n */\nexport function getSpecKeyVariants(specKey: string): string[] {\n  const variants: string[] = [];\n\n  // Remove common suffixes\n  const base = specKey\n    .replace(/Spec$/, '')\n    .replace(/Contract$/, '')\n    .replace(/Command$/, '')\n    .replace(/Query$/, '');\n\n  if (base !== specKey) {\n    variants.push(base);\n    variants.push(`${base}Spec`);\n    variants.push(`${base}Contract`);\n  }\n\n  // Add PascalCase variant\n  const parts = specKey.split('.');\n  if (parts.length > 1) {\n    const pascalName = parts\n      .map((p) => p.charAt(0).toUpperCase() + p.slice(1))\n      .join('');\n    variants.push(pascalName);\n  }\n\n  return variants;\n}\n"],"mappings":"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"}
+{"version":3,"file":"parsers.mjs","names":["init"],"sources":["../../../../src/services/implementation/resolver/parsers.ts"],"sourcesContent":["/**\n * Parser utilities for extracting implementation references from source code.\n */\n\nimport type {\n  ImplementationRef,\n  ImplementationType,\n} from '@contractspec/lib.contracts';\nimport { Node, Project, SyntaxKind } from 'ts-morph';\n\n/**\n * Parse explicit implementations from spec source code using ts-morph.\n * Looks for: implementations: [{ path: '...', type: '...' }] inside the main spec object.\n */\nexport function parseExplicitImplementations(\n  code: string\n): ImplementationRef[] {\n  const implementations: ImplementationRef[] = [];\n  const project = new Project({ useInMemoryFileSystem: true });\n  // Create a SourceFile\n  const sourceFile = project.createSourceFile('spec.ts', code);\n\n  // Helper to extract fields from an object literal\n  const extractImpls = (obj: Node) => {\n    if (!Node.isObjectLiteralExpression(obj)) return;\n    const prop = obj.getProperty('implementations');\n    if (prop && Node.isPropertyAssignment(prop)) {\n      const init = prop.getInitializer();\n      if (init && Node.isArrayLiteralExpression(init)) {\n        for (const elem of init.getElements()) {\n          if (Node.isObjectLiteralExpression(elem)) {\n            let pathVal: string | undefined;\n            let typeVal: ImplementationType | undefined;\n            let descVal: string | undefined;\n\n            const pathProp = elem.getProperty('path');\n            if (pathProp && Node.isPropertyAssignment(pathProp)) {\n              const init = pathProp.getInitializer();\n              if (Node.isStringLiteral(init)) {\n                pathVal = init.getLiteralText();\n              }\n            }\n\n            const typeProp = elem.getProperty('type');\n            if (typeProp && Node.isPropertyAssignment(typeProp)) {\n              const init = typeProp.getInitializer();\n              if (Node.isStringLiteral(init)) {\n                typeVal = init.getLiteralText() as ImplementationType;\n              }\n            }\n\n            const descProp = elem.getProperty('description');\n            if (descProp && Node.isPropertyAssignment(descProp)) {\n              const init = descProp.getInitializer();\n              if (Node.isStringLiteral(init)) {\n                descVal = init.getLiteralText();\n              }\n            }\n\n            if (pathVal && typeVal) {\n              implementations.push({\n                path: pathVal,\n                type: typeVal,\n                description: descVal,\n              });\n            }\n          }\n        }\n      }\n    }\n  };\n\n  // Find the spec object\n  // 1. defineCommand/Event/etc CallExpression\n  // 2. Exported object literal or variable\n\n  const callExpressions = sourceFile.getDescendantsOfKind(\n    SyntaxKind.CallExpression\n  );\n  for (const call of callExpressions) {\n    const expr = call.getExpression().getText();\n    if (\n      ['defineCommand', 'defineQuery', 'defineEvent', 'defineFeature'].includes(\n        expr\n      )\n    ) {\n      const args = call.getArguments();\n      if (args.length > 0 && Node.isObjectLiteralExpression(args[0])) {\n        extractImpls(args[0]);\n        return implementations; // Assume only one main definition per file\n      }\n    }\n  }\n\n  // Fallback: search exported variables\n  const varStmts = sourceFile.getVariableStatements();\n  for (const stmt of varStmts) {\n    if (stmt.isExported()) {\n      for (const decl of stmt.getDeclarations()) {\n        const init = decl.getInitializer();\n        if (init && Node.isObjectLiteralExpression(init)) {\n          // Check if it has 'implementations'\n          if (init.getProperty('implementations')) {\n            extractImpls(init);\n            return implementations;\n          }\n        }\n      }\n    }\n  }\n\n  // Fallback: default export\n  const exportAssign = sourceFile.getExportAssignment(\n    (d) => !d.isExportEquals()\n  );\n  if (exportAssign) {\n    const expr = exportAssign.getExpression();\n    if (Node.isObjectLiteralExpression(expr)) {\n      extractImpls(expr);\n    } else if (\n      Node.isAsExpression(expr) &&\n      Node.isObjectLiteralExpression(expr.getExpression())\n    ) {\n      extractImpls(expr.getExpression());\n    }\n  }\n\n  return implementations;\n}\n"],"mappings":";;;;;;;AAcA,SAAgB,6BACd,MACqB;CACrB,MAAM,kBAAuC,EAAE;CAG/C,MAAM,aAFU,IAAI,QAAQ,EAAE,uBAAuB,MAAM,CAAC,CAEjC,iBAAiB,WAAW,KAAK;CAG5D,MAAM,gBAAgB,QAAc;AAClC,MAAI,CAAC,KAAK,0BAA0B,IAAI,CAAE;EAC1C,MAAM,OAAO,IAAI,YAAY,kBAAkB;AAC/C,MAAI,QAAQ,KAAK,qBAAqB,KAAK,EAAE;GAC3C,MAAM,OAAO,KAAK,gBAAgB;AAClC,OAAI,QAAQ,KAAK,yBAAyB,KAAK,EAC7C;SAAK,MAAM,QAAQ,KAAK,aAAa,CACnC,KAAI,KAAK,0BAA0B,KAAK,EAAE;KACxC,IAAI;KACJ,IAAI;KACJ,IAAI;KAEJ,MAAM,WAAW,KAAK,YAAY,OAAO;AACzC,SAAI,YAAY,KAAK,qBAAqB,SAAS,EAAE;MACnD,MAAMA,SAAO,SAAS,gBAAgB;AACtC,UAAI,KAAK,gBAAgBA,OAAK,CAC5B,WAAUA,OAAK,gBAAgB;;KAInC,MAAM,WAAW,KAAK,YAAY,OAAO;AACzC,SAAI,YAAY,KAAK,qBAAqB,SAAS,EAAE;MACnD,MAAMA,SAAO,SAAS,gBAAgB;AACtC,UAAI,KAAK,gBAAgBA,OAAK,CAC5B,WAAUA,OAAK,gBAAgB;;KAInC,MAAM,WAAW,KAAK,YAAY,cAAc;AAChD,SAAI,YAAY,KAAK,qBAAqB,SAAS,EAAE;MACnD,MAAMA,SAAO,SAAS,gBAAgB;AACtC,UAAI,KAAK,gBAAgBA,OAAK,CAC5B,WAAUA,OAAK,gBAAgB;;AAInC,SAAI,WAAW,QACb,iBAAgB,KAAK;MACnB,MAAM;MACN,MAAM;MACN,aAAa;MACd,CAAC;;;;;CAYd,MAAM,kBAAkB,WAAW,qBACjC,WAAW,eACZ;AACD,MAAK,MAAM,QAAQ,iBAAiB;EAClC,MAAM,OAAO,KAAK,eAAe,CAAC,SAAS;AAC3C,MACE;GAAC;GAAiB;GAAe;GAAe;GAAgB,CAAC,SAC/D,KACD,EACD;GACA,MAAM,OAAO,KAAK,cAAc;AAChC,OAAI,KAAK,SAAS,KAAK,KAAK,0BAA0B,KAAK,GAAG,EAAE;AAC9D,iBAAa,KAAK,GAAG;AACrB,WAAO;;;;CAMb,MAAM,WAAW,WAAW,uBAAuB;AACnD,MAAK,MAAM,QAAQ,SACjB,KAAI,KAAK,YAAY,CACnB,MAAK,MAAM,QAAQ,KAAK,iBAAiB,EAAE;EACzC,MAAM,OAAO,KAAK,gBAAgB;AAClC,MAAI,QAAQ,KAAK,0BAA0B,KAAK,EAE9C;OAAI,KAAK,YAAY,kBAAkB,EAAE;AACvC,iBAAa,KAAK;AAClB,WAAO;;;;CAQjB,MAAM,eAAe,WAAW,qBAC7B,MAAM,CAAC,EAAE,gBAAgB,CAC3B;AACD,KAAI,cAAc;EAChB,MAAM,OAAO,aAAa,eAAe;AACzC,MAAI,KAAK,0BAA0B,KAAK,CACtC,cAAa,KAAK;WAElB,KAAK,eAAe,KAAK,IACzB,KAAK,0BAA0B,KAAK,eAAe,CAAC,CAEpD,cAAa,KAAK,eAAe,CAAC;;AAItC,QAAO"}

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

@@ -22,8 +22,10 @@ interface ResolvedImplementation {
   source: ImplementationSource;
   /** Whether the file exists on disk */
   exists: boolean;
+  /** Content */
+  implementationSourceContent?: string;
   /** Content hash for cache invalidation (SHA256) */
-  contentHash?: string;
+  implementationSourceHash?: string;
   /** Optional description */
   description?: string;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/services/implementation/types.ts"],"sourcesContent":[],"mappings":";;;;AAcA;AAKA;AAkBA;AAoBiB,KAhDL,oBAAA,GAgDqB,UAAA,GAAA,YAAA,GAAA,YAAA;AAcjC;AAWA;;KApEY,oBAAA;;;;UAKK,sBAAA;;;;QAIT;;UAEE;;;;;;;;;;;UAYO,wBAAA;;;;;;;;;;mBAUE;;UAET;;;;;;;UAQO,gBAAA;;;;;;;;;;;;;UAcA,eAAA;;;;;;;;;;UAWA,kBAAA;;;;;;;;;;gBAUD"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/services/implementation/types.ts"],"sourcesContent":[],"mappings":";;;;AAcA;AAKA;AAoBA;AAoBiB,KAlDL,oBAAA,GAkDqB,UAAA,GAAA,YAAA,GAAA,YAAA;AAcjC;AAWA;;KAtEY,oBAAA;;;;UAKK,sBAAA;;;;QAIT;;UAEE;;;;;;;;;;;;;UAcO,wBAAA;;;;;;;;;;mBAUE;;UAET;;;;;;;UAQO,gBAAA;;;;;;;;;;;;;UAcA,eAAA;;;;;;;;;;UAWA,kBAAA;;;;;;;;;;gBAUD"}

package/dist/services/index.d.mts

@@ -36,6 +36,8 @@ import { deepMergeOverwrite, deepMergePreserve, formatJson, safeParseJson } from
 import { ALL_CHECK_CATEGORIES, CHECK_CATEGORY_LABELS, CheckCategory, CheckContext, CheckResult, CheckStatus, DoctorOptions, DoctorPromptCallbacks, DoctorResult, FixAction, FixResult } from "./doctor/types.mjs";
 import { formatCheckResult, formatDoctorSummary, runDoctor } from "./doctor/doctor-service.mjs";
 import "./doctor/index.mjs";
+import { ContractVerificationStatus, DriftData, FinalizeResult, ImpactJson, PrActionOptions, ReportData, ReportInputs, RiskData, ValidationData, WhatChangedData } from "./action-pr/types.mjs";
+import { PrActionService } from "./action-pr/service.mjs";
 import { ALL_CI_CHECK_CATEGORIES, CICheckCategory, CICheckCategorySummary, CICheckOptions, CICheckResult, CIFormatOptions, CIIssue, CIIssueSeverity, CIOutputFormat, CI_CHECK_CATEGORY_LABELS } from "./ci-check/types.mjs";
 import { runCIChecks } from "./ci-check/ci-check-service.mjs";
 import "./ci-check/index.mjs";
@@ -72,7 +74,7 @@ import { createQuickAIReview, verifySemanticFields, verifyWithAI, verifyWithAIEn
 import "./verify/index.mjs";
 import { DiscoveryOptions, ImplementationSource, ImplementationStatus, ResolvedImplementation, ResolverOptions, SpecImplementationResult, SpecReferenceMatch } from "./implementation/types.mjs";
 import { discoverAllImplementations, discoverImplementationsForSpec, extractSpecReferences, inferImplementationType } from "./implementation/discovery.mjs";
-import { getSpecKeyVariants, parseExplicitImplementations } from "./implementation/resolver/parsers.mjs";
+import { parseExplicitImplementations } from "./implementation/resolver/parsers.mjs";
 import { getConventionPaths, toKebabCase } from "./implementation/resolver/conventions.mjs";
 import { determineStatus, getImplementationSummary } from "./implementation/resolver/status.mjs";
 import { resolveAllImplementations, resolveImplementations } from "./implementation/resolver/index.mjs";
@@ -90,6 +92,8 @@ import { DocsServiceOptions, DocsServiceResult, generateDocsFromSpecs } from "./
 import "./docs/index.mjs";
 import { index_d_exports as index_d_exports$1 } from "./impact/index.mjs";
 import { FormatterOptions, formatFiles } from "./formatter.mjs";
+import { DriftActionOptions, DriftReportInputs, FinalizeDriftResult } from "./action-drift/types.mjs";
+import { DriftActionService } from "./action-drift/service.mjs";
 import { SpecVersionAnalysis } from "./versioning/types.mjs";
 import { index_d_exports as index_d_exports$2 } from "./versioning/index.mjs";
 import { index_d_exports as index_d_exports$3 } from "./upgrade/index.mjs";

package/dist/services/index.mjs

@@ -1,4 +1,5 @@
 import { detectPackageManager, findPackageRoot, findWorkspaceRoot, getWorkspaceInfo } from "../adapters/workspace.mjs";
+import { groupSpecsByType, listSpecs } from "./list.mjs";
 import { validateSpec, validateSpecs } from "./validate/spec-validator.mjs";
 import { validateImplementationFiles } from "./validate/implementation-validator.mjs";
 import { validateBlueprint } from "./validate/blueprint-validator.mjs";
@@ -8,7 +9,6 @@ import "./validate/index.mjs";
 import { features_exports } from "./features/index.mjs";
 import { compareSpecs } from "./diff.mjs";
 import { analyzeDeps, exportGraphAsDot, getContractNode, getGraphStats } from "./deps.mjs";
-import { groupSpecsByType, listSpecs } from "./list.mjs";
 import { getApiKey, loadWorkspaceConfig } from "./config.mjs";
 import { buildSpec } from "./build.mjs";
 import { importFromOpenApiService } from "./openapi/import-service.mjs";
@@ -35,10 +35,11 @@ import { runSetup } from "./setup/setup-service.mjs";
 import { ALL_CHECK_CATEGORIES, CHECK_CATEGORY_LABELS } from "./doctor/types.mjs";
 import { formatCheckResult, formatDoctorSummary, runDoctor } from "./doctor/doctor-service.mjs";
 import "./doctor/index.mjs";
+import { PrActionService } from "./action-pr/service.mjs";
 import { ALL_CI_CHECK_CATEGORIES, CI_CHECK_CATEGORY_LABELS } from "./ci-check/types.mjs";
 import { discoverAllImplementations, discoverImplementationsForSpec, extractSpecReferences, inferImplementationType } from "./implementation/discovery.mjs";
 import { getConventionPaths, toKebabCase } from "./implementation/resolver/conventions.mjs";
-import { getSpecKeyVariants, parseExplicitImplementations } from "./implementation/resolver/parsers.mjs";
+import { parseExplicitImplementations } from "./implementation/resolver/parsers.mjs";
 import { determineStatus, getImplementationSummary } from "./implementation/resolver/status.mjs";
 import { resolveAllImplementations, resolveImplementations } from "./implementation/resolver/index.mjs";
 import { generateDocsFromSpecs } from "./docs/docs-service.mjs";
@@ -87,6 +88,7 @@ import { formatQuickstartPreview, isContractSpecInstalled, runQuickstart } from
 import "./quickstart/index.mjs";
 import { impact_exports } from "./impact/index.mjs";
 import { formatFiles } from "./formatter.mjs";
+import { DriftActionService } from "./action-drift/service.mjs";
 import { versioning_exports } from "./versioning/index.mjs";
 import { upgrade_exports } from "./upgrade/index.mjs";
 import { hooks_exports } from "./hooks/index.mjs";

package/dist/services/list.d.mts

@@ -1,6 +1,7 @@
 import { FsAdapter } from "../ports/fs.mjs";
 import { SpecScanResult, scanSpecSource } from "@contractspec/module.workspace";
-import { ContractsrcConfig } from "@contractspec/lib.contracts/workspace-config";
+import { ResolvedContractsrcConfig } from "@contractspec/lib.contracts";
+import { MaybeArray } from "@contractspec/lib.utils-typescript";
 
 //#region src/services/list.d.ts
 
@@ -15,11 +16,11 @@ interface ListSpecsOptions {
   /**
    * Filter by spec type.
    */
-  type?: string;
+  type?: MaybeArray<string>;
   /**
    * Workspace configuration
    */
-  config?: ContractsrcConfig;
+  config?: ResolvedContractsrcConfig;
 }
 /**
  * List all spec files in the workspace.

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

@@ -1 +1 @@
-{"version":3,"file":"list.d.mts","names":[],"sources":["../../src/services/list.ts"],"sourcesContent":[],"mappings":";;;;;;AAoCA;;;AAEW,UAtBM,gBAAA,CAsBN;EACA;;;EAsDK,OAAA,CAAA,EAAA,MAAA;EACP;;;EACH,IAAA,CAAA,EAAA,MAAA;;;;WAjEK;;;;;iBAMW,SAAA;MACJ;gBAAyB;aAChC,mBACR,QAAQ;;;;iBAsDK,gBAAA,QACP,mBACN,YAAY"}
+{"version":3,"file":"list.d.mts","names":[],"sources":["../../src/services/list.ts"],"sourcesContent":[],"mappings":";;;;;;;AAqCA;;;AAEW,UAtBM,gBAAA,CAsBN;EACA;;;EA8DK,OAAA,CAAA,EAAA,MAAA;EACP;;;EACH,IAAA,CAAA,EA9EG,UA8EH,CAAA,MAAA,CAAA;;;;WAzEK;;;;;iBAMW,SAAA;MACJ;gBAAyB;aAChC,mBACR,QAAQ;;;;iBA8DK,gBAAA,QACP,mBACN,YAAY"}