@contractspec/bundle.workspace 1.45.3 → 1.45.5

package/dist/adapters/fs.d.ts

@@ -2,10 +2,11 @@ import { FsAdapter } from "../ports/fs.js";
 
 //#region src/adapters/fs.d.ts
 
+declare const DEFAULT_SPEC_PATTERNS: string[];
 /**
  * Create a Node.js filesystem adapter.
  */
 declare function createNodeFsAdapter(cwd?: string): FsAdapter;
 //#endregion
-export { createNodeFsAdapter };
+export { DEFAULT_SPEC_PATTERNS, createNodeFsAdapter };
 //# sourceMappingURL=fs.d.ts.map

package/dist/adapters/fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","names":[],"sources":["../../src/adapters/fs.ts"],"sourcesContent":[],"mappings":";;;;;;;iBA2EgB,mBAAA,gBAAmC"}
+{"version":3,"file":"fs.d.ts","names":[],"sources":["../../src/adapters/fs.ts"],"sourcesContent":[],"mappings":";;;;AA2EgB,cApDH,qBAoDsC,EAAA,MAAS,EAAA;;;;iBAA5C,mBAAA,gBAAmC"}

package/dist/adapters/fs.js

@@ -127,5 +127,5 @@ function createNodeFsAdapter(cwd) {
 }
 
 //#endregion
-export { createNodeFsAdapter };
+export { DEFAULT_SPEC_PATTERNS, createNodeFsAdapter };
 //# sourceMappingURL=fs.js.map

package/dist/adapters/fs.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs.js","names":["fsStat","all: string[]","globFn"],"sources":["../../src/adapters/fs.ts"],"sourcesContent":["/**\n * Node.js filesystem adapter implementation.\n */\n\nimport {\n  access,\n  mkdir,\n  readFile,\n  rm,\n  stat as fsStat,\n  writeFile,\n} from 'node:fs/promises';\nimport {\n  basename,\n  dirname,\n  isAbsolute,\n  join,\n  relative,\n  resolve,\n} from 'node:path';\nimport { glob as globFn } from 'glob';\nimport type { DiscoverOptions, FileStat, FsAdapter } from '../ports/fs';\n\nconst DEFAULT_SPEC_PATTERNS = [\n  // Standard dot-prefixed naming convention\n  '**/*.operation.ts',\n  '**/*.operations.ts',\n  '**/*.event.ts',\n  '**/*.presentation.ts',\n  '**/*.feature.ts',\n  '**/*.capability.ts',\n  '**/*.workflow.ts',\n  '**/*.data-view.ts',\n  '**/*.form.ts',\n  '**/*.migration.ts',\n  '**/*.telemetry.ts',\n  '**/*.experiment.ts',\n  '**/*.app-config.ts',\n  '**/*.integration.ts',\n  '**/*.knowledge.ts',\n  '**/*.policy.ts',\n  '**/*.test-spec.ts',\n  // Directory-based patterns (contracts/ and operations/ directories)\n  '**/contracts/*.ts',\n  '**/contracts/index.ts',\n  '**/operations/*.ts',\n  '**/operations/index.ts',\n  // Standalone file patterns (events.ts, presentations.ts)\n  '**/operations.ts',\n  '**/events.ts',\n  '**/presentations.ts',\n  // Directory index patterns (/events/index.ts, /presentations/index.ts)\n  '**/events/index.ts',\n  '**/presentations/index.ts',\n];\n\nconst DEFAULT_IGNORES = [\n  '**/node_modules/**',\n  '**/dist/**',\n  '**/.turbo/**',\n  '**/.next/**',\n  '**/build/**',\n  '**/coverage/**',\n  '**/*.d.ts',\n  // Code generators and transformers (not actual specs)\n  '**/importer/**',\n  '**/exporter/**',\n  // Documentation blocks (treated separately)\n  '**/docs/**/*.docblock.ts',\n  '**/docs/presentations.ts',\n];\n\n/**\n * Create a Node.js filesystem adapter.\n */\nexport function createNodeFsAdapter(cwd?: string): FsAdapter {\n  const baseCwd = cwd ?? process.cwd();\n\n  return {\n    async exists(path: string): Promise<boolean> {\n      try {\n        await access(resolvePath(path));\n        return true;\n      } catch {\n        return false;\n      }\n    },\n\n    async readFile(path: string): Promise<string> {\n      return readFile(resolvePath(path), 'utf-8');\n    },\n\n    async writeFile(path: string, content: string): Promise<void> {\n      const fullPath = resolvePath(path);\n      const dir = dirname(fullPath);\n      await mkdir(dir, { recursive: true });\n      await writeFile(fullPath, content, 'utf-8');\n    },\n\n    async remove(path: string): Promise<void> {\n      await rm(resolvePath(path), { recursive: true, force: true });\n    },\n\n    async stat(path: string): Promise<FileStat> {\n      const stats = await fsStat(resolvePath(path));\n      return {\n        size: stats.size,\n        isFile: stats.isFile(),\n        isDirectory: stats.isDirectory(),\n        mtime: stats.mtime,\n      };\n    },\n\n    async mkdir(path: string): Promise<void> {\n      await mkdir(resolvePath(path), { recursive: true });\n    },\n\n    async glob(options: DiscoverOptions): Promise<string[]> {\n      const patterns =\n        options.patterns ??\n        (options.pattern ? [options.pattern] : DEFAULT_SPEC_PATTERNS);\n      const ignore = options.ignore ?? DEFAULT_IGNORES;\n      // Use provided cwd or fall back to adapter's baseCwd\n      const globCwd = options.cwd ?? baseCwd;\n      // Default to absolute paths for safer file operations\n      const absolute = options.absolute ?? true;\n\n      const all: string[] = [];\n      for (const pattern of patterns) {\n        const matches = await globFn(pattern, {\n          cwd: globCwd,\n          ignore,\n          absolute,\n        });\n        all.push(...matches);\n      }\n\n      return Array.from(new Set(all)).sort((a, b) => a.localeCompare(b));\n    },\n\n    resolve(...paths: string[]): string {\n      const [first, ...rest] = paths;\n      if (!first) return baseCwd;\n      return resolve(baseCwd, first, ...rest);\n    },\n\n    dirname(path: string): string {\n      return dirname(path);\n    },\n\n    basename(path: string): string {\n      return basename(path);\n    },\n\n    join(...paths: string[]): string {\n      return join(...paths);\n    },\n\n    relative(from: string, to: string): string {\n      return relative(from, to);\n    },\n  };\n\n  function resolvePath(path: string): string {\n    return isAbsolute(path) ? path : resolve(baseCwd, path);\n  }\n}\n"],"mappings":";;;;;;;;AAuBA,MAAM,wBAAwB;CAE5B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CAEA;CACA;CACA;CAEA;CACA;CACD;AAED,MAAM,kBAAkB;CACtB;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CAEA;CACA;CACD;;;;AAKD,SAAgB,oBAAoB,KAAyB;CAC3D,MAAM,UAAU,OAAO,QAAQ,KAAK;AAEpC,QAAO;EACL,MAAM,OAAO,MAAgC;AAC3C,OAAI;AACF,UAAM,OAAO,YAAY,KAAK,CAAC;AAC/B,WAAO;WACD;AACN,WAAO;;;EAIX,MAAM,SAAS,MAA+B;AAC5C,UAAO,SAAS,YAAY,KAAK,EAAE,QAAQ;;EAG7C,MAAM,UAAU,MAAc,SAAgC;GAC5D,MAAM,WAAW,YAAY,KAAK;AAElC,SAAM,MADM,QAAQ,SAAS,EACZ,EAAE,WAAW,MAAM,CAAC;AACrC,SAAM,UAAU,UAAU,SAAS,QAAQ;;EAG7C,MAAM,OAAO,MAA6B;AACxC,SAAM,GAAG,YAAY,KAAK,EAAE;IAAE,WAAW;IAAM,OAAO;IAAM,CAAC;;EAG/D,MAAM,KAAK,MAAiC;GAC1C,MAAM,QAAQ,MAAMA,KAAO,YAAY,KAAK,CAAC;AAC7C,UAAO;IACL,MAAM,MAAM;IACZ,QAAQ,MAAM,QAAQ;IACtB,aAAa,MAAM,aAAa;IAChC,OAAO,MAAM;IACd;;EAGH,MAAM,MAAM,MAA6B;AACvC,SAAM,MAAM,YAAY,KAAK,EAAE,EAAE,WAAW,MAAM,CAAC;;EAGrD,MAAM,KAAK,SAA6C;GACtD,MAAM,WACJ,QAAQ,aACP,QAAQ,UAAU,CAAC,QAAQ,QAAQ,GAAG;GACzC,MAAM,SAAS,QAAQ,UAAU;GAEjC,MAAM,UAAU,QAAQ,OAAO;GAE/B,MAAM,WAAW,QAAQ,YAAY;GAErC,MAAMC,MAAgB,EAAE;AACxB,QAAK,MAAM,WAAW,UAAU;IAC9B,MAAM,UAAU,MAAMC,KAAO,SAAS;KACpC,KAAK;KACL;KACA;KACD,CAAC;AACF,QAAI,KAAK,GAAG,QAAQ;;AAGtB,UAAO,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,cAAc,EAAE,CAAC;;EAGpE,QAAQ,GAAG,OAAyB;GAClC,MAAM,CAAC,OAAO,GAAG,QAAQ;AACzB,OAAI,CAAC,MAAO,QAAO;AACnB,UAAO,QAAQ,SAAS,OAAO,GAAG,KAAK;;EAGzC,QAAQ,MAAsB;AAC5B,UAAO,QAAQ,KAAK;;EAGtB,SAAS,MAAsB;AAC7B,UAAO,SAAS,KAAK;;EAGvB,KAAK,GAAG,OAAyB;AAC/B,UAAO,KAAK,GAAG,MAAM;;EAGvB,SAAS,MAAc,IAAoB;AACzC,UAAO,SAAS,MAAM,GAAG;;EAE5B;CAED,SAAS,YAAY,MAAsB;AACzC,SAAO,WAAW,KAAK,GAAG,OAAO,QAAQ,SAAS,KAAK"}
+{"version":3,"file":"fs.js","names":["fsStat","all: string[]","globFn"],"sources":["../../src/adapters/fs.ts"],"sourcesContent":["/**\n * Node.js filesystem adapter implementation.\n */\n\nimport {\n  access,\n  mkdir,\n  readFile,\n  rm,\n  stat as fsStat,\n  writeFile,\n} from 'node:fs/promises';\nimport {\n  basename,\n  dirname,\n  isAbsolute,\n  join,\n  relative,\n  resolve,\n} from 'node:path';\nimport { glob as globFn } from 'glob';\nimport type { DiscoverOptions, FileStat, FsAdapter } from '../ports/fs';\n\nexport const DEFAULT_SPEC_PATTERNS = [\n  // Standard dot-prefixed naming convention\n  '**/*.operation.ts',\n  '**/*.operations.ts',\n  '**/*.event.ts',\n  '**/*.presentation.ts',\n  '**/*.feature.ts',\n  '**/*.capability.ts',\n  '**/*.workflow.ts',\n  '**/*.data-view.ts',\n  '**/*.form.ts',\n  '**/*.migration.ts',\n  '**/*.telemetry.ts',\n  '**/*.experiment.ts',\n  '**/*.app-config.ts',\n  '**/*.integration.ts',\n  '**/*.knowledge.ts',\n  '**/*.policy.ts',\n  '**/*.test-spec.ts',\n  // Directory-based patterns (contracts/ and operations/ directories)\n  '**/contracts/*.ts',\n  '**/contracts/index.ts',\n  '**/operations/*.ts',\n  '**/operations/index.ts',\n  // Standalone file patterns (events.ts, presentations.ts)\n  '**/operations.ts',\n  '**/events.ts',\n  '**/presentations.ts',\n  // Directory index patterns (/events/index.ts, /presentations/index.ts)\n  '**/events/index.ts',\n  '**/presentations/index.ts',\n];\n\nconst DEFAULT_IGNORES = [\n  '**/node_modules/**',\n  '**/dist/**',\n  '**/.turbo/**',\n  '**/.next/**',\n  '**/build/**',\n  '**/coverage/**',\n  '**/*.d.ts',\n  // Code generators and transformers (not actual specs)\n  '**/importer/**',\n  '**/exporter/**',\n  // Documentation blocks (treated separately)\n  '**/docs/**/*.docblock.ts',\n  '**/docs/presentations.ts',\n];\n\n/**\n * Create a Node.js filesystem adapter.\n */\nexport function createNodeFsAdapter(cwd?: string): FsAdapter {\n  const baseCwd = cwd ?? process.cwd();\n\n  return {\n    async exists(path: string): Promise<boolean> {\n      try {\n        await access(resolvePath(path));\n        return true;\n      } catch {\n        return false;\n      }\n    },\n\n    async readFile(path: string): Promise<string> {\n      return readFile(resolvePath(path), 'utf-8');\n    },\n\n    async writeFile(path: string, content: string): Promise<void> {\n      const fullPath = resolvePath(path);\n      const dir = dirname(fullPath);\n      await mkdir(dir, { recursive: true });\n      await writeFile(fullPath, content, 'utf-8');\n    },\n\n    async remove(path: string): Promise<void> {\n      await rm(resolvePath(path), { recursive: true, force: true });\n    },\n\n    async stat(path: string): Promise<FileStat> {\n      const stats = await fsStat(resolvePath(path));\n      return {\n        size: stats.size,\n        isFile: stats.isFile(),\n        isDirectory: stats.isDirectory(),\n        mtime: stats.mtime,\n      };\n    },\n\n    async mkdir(path: string): Promise<void> {\n      await mkdir(resolvePath(path), { recursive: true });\n    },\n\n    async glob(options: DiscoverOptions): Promise<string[]> {\n      const patterns =\n        options.patterns ??\n        (options.pattern ? [options.pattern] : DEFAULT_SPEC_PATTERNS);\n      const ignore = options.ignore ?? DEFAULT_IGNORES;\n      // Use provided cwd or fall back to adapter's baseCwd\n      const globCwd = options.cwd ?? baseCwd;\n      // Default to absolute paths for safer file operations\n      const absolute = options.absolute ?? true;\n\n      const all: string[] = [];\n      for (const pattern of patterns) {\n        const matches = await globFn(pattern, {\n          cwd: globCwd,\n          ignore,\n          absolute,\n        });\n        all.push(...matches);\n      }\n\n      return Array.from(new Set(all)).sort((a, b) => a.localeCompare(b));\n    },\n\n    resolve(...paths: string[]): string {\n      const [first, ...rest] = paths;\n      if (!first) return baseCwd;\n      return resolve(baseCwd, first, ...rest);\n    },\n\n    dirname(path: string): string {\n      return dirname(path);\n    },\n\n    basename(path: string): string {\n      return basename(path);\n    },\n\n    join(...paths: string[]): string {\n      return join(...paths);\n    },\n\n    relative(from: string, to: string): string {\n      return relative(from, to);\n    },\n  };\n\n  function resolvePath(path: string): string {\n    return isAbsolute(path) ? path : resolve(baseCwd, path);\n  }\n}\n"],"mappings":";;;;;;;;AAuBA,MAAa,wBAAwB;CAEnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CAEA;CACA;CACA;CAEA;CACA;CACD;AAED,MAAM,kBAAkB;CACtB;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CAEA;CACA;CACD;;;;AAKD,SAAgB,oBAAoB,KAAyB;CAC3D,MAAM,UAAU,OAAO,QAAQ,KAAK;AAEpC,QAAO;EACL,MAAM,OAAO,MAAgC;AAC3C,OAAI;AACF,UAAM,OAAO,YAAY,KAAK,CAAC;AAC/B,WAAO;WACD;AACN,WAAO;;;EAIX,MAAM,SAAS,MAA+B;AAC5C,UAAO,SAAS,YAAY,KAAK,EAAE,QAAQ;;EAG7C,MAAM,UAAU,MAAc,SAAgC;GAC5D,MAAM,WAAW,YAAY,KAAK;AAElC,SAAM,MADM,QAAQ,SAAS,EACZ,EAAE,WAAW,MAAM,CAAC;AACrC,SAAM,UAAU,UAAU,SAAS,QAAQ;;EAG7C,MAAM,OAAO,MAA6B;AACxC,SAAM,GAAG,YAAY,KAAK,EAAE;IAAE,WAAW;IAAM,OAAO;IAAM,CAAC;;EAG/D,MAAM,KAAK,MAAiC;GAC1C,MAAM,QAAQ,MAAMA,KAAO,YAAY,KAAK,CAAC;AAC7C,UAAO;IACL,MAAM,MAAM;IACZ,QAAQ,MAAM,QAAQ;IACtB,aAAa,MAAM,aAAa;IAChC,OAAO,MAAM;IACd;;EAGH,MAAM,MAAM,MAA6B;AACvC,SAAM,MAAM,YAAY,KAAK,EAAE,EAAE,WAAW,MAAM,CAAC;;EAGrD,MAAM,KAAK,SAA6C;GACtD,MAAM,WACJ,QAAQ,aACP,QAAQ,UAAU,CAAC,QAAQ,QAAQ,GAAG;GACzC,MAAM,SAAS,QAAQ,UAAU;GAEjC,MAAM,UAAU,QAAQ,OAAO;GAE/B,MAAM,WAAW,QAAQ,YAAY;GAErC,MAAMC,MAAgB,EAAE;AACxB,QAAK,MAAM,WAAW,UAAU;IAC9B,MAAM,UAAU,MAAMC,KAAO,SAAS;KACpC,KAAK;KACL;KACA;KACD,CAAC;AACF,QAAI,KAAK,GAAG,QAAQ;;AAGtB,UAAO,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,cAAc,EAAE,CAAC;;EAGpE,QAAQ,GAAG,OAAyB;GAClC,MAAM,CAAC,OAAO,GAAG,QAAQ;AACzB,OAAI,CAAC,MAAO,QAAO;AACnB,UAAO,QAAQ,SAAS,OAAO,GAAG,KAAK;;EAGzC,QAAQ,MAAsB;AAC5B,UAAO,QAAQ,KAAK;;EAGtB,SAAS,MAAsB;AAC7B,UAAO,SAAS,KAAK;;EAGvB,KAAK,GAAG,OAAyB;AAC/B,UAAO,KAAK,GAAG,MAAM;;EAGvB,SAAS,MAAc,IAAoB;AACzC,UAAO,SAAS,MAAM,GAAG;;EAE5B;CAED,SAAS,YAAY,MAAsB;AACzC,SAAO,WAAW,KAAK,GAAG,OAAO,QAAQ,SAAS,KAAK"}

package/dist/adapters/git.js

@@ -46,6 +46,35 @@ function createNodeGitAdapter(cwd) {
 			} catch {
 				return false;
 			}
+		},
+		async log(baseline) {
+			const ref = baseline ?? "HEAD~10";
+			const format = "--format=%H|||%s|||%an|||%aI";
+			try {
+				const output = execSync(`git log ${ref}..HEAD ${format}`, {
+					cwd: baseCwd,
+					encoding: "utf-8",
+					stdio: [
+						"ignore",
+						"pipe",
+						"pipe"
+					]
+				});
+				const entries = [];
+				for (const line of output.trim().split("\n")) {
+					if (!line) continue;
+					const [hash, message, author, date] = line.split("|||");
+					if (hash && message) entries.push({
+						hash,
+						message,
+						author,
+						date
+					});
+				}
+				return entries;
+			} catch {
+				return [];
+			}
 		}
 	};
 }

package/dist/adapters/git.js.map

@@ -1 +1 @@
-{"version":3,"file":"git.js","names":["flags: string[]"],"sources":["../../src/adapters/git.ts"],"sourcesContent":["/**\n * Node.js git adapter implementation.\n */\n\nimport { execSync } from 'node:child_process';\nimport { access } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport type { GitAdapter, GitCleanOptions } from '../ports/git';\n\n/**\n * Create a Node.js git adapter.\n */\nexport function createNodeGitAdapter(cwd?: string): GitAdapter {\n  const baseCwd = cwd ?? process.cwd();\n\n  return {\n    async showFile(ref: string, filePath: string): Promise<string> {\n      try {\n        return execSync(`git show ${ref}:${filePath}`, {\n          cwd: baseCwd,\n          encoding: 'utf-8',\n          stdio: ['ignore', 'pipe', 'pipe'],\n        });\n      } catch (error) {\n        throw new Error(\n          `Could not load ${filePath} at ref ${ref}: ${\n            error instanceof Error ? error.message : String(error)\n          }`\n        );\n      }\n    },\n\n    async clean(options?: GitCleanOptions): Promise<void> {\n      const flags: string[] = [];\n      if (options?.force) flags.push('-f');\n      if (options?.directories) flags.push('-d');\n      if (options?.ignored) flags.push('-x');\n      if (options?.dryRun) flags.push('--dry-run');\n\n      execSync(`git clean ${flags.join(' ')}`, {\n        cwd: baseCwd,\n        stdio: 'inherit',\n      });\n    },\n\n    async isGitRepo(path?: string): Promise<boolean> {\n      const targetPath = path ? resolve(baseCwd, path) : baseCwd;\n      try {\n        await access(resolve(targetPath, '.git'));\n        return true;\n      } catch {\n        return false;\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,qBAAqB,KAA0B;CAC7D,MAAM,UAAU,OAAO,QAAQ,KAAK;AAEpC,QAAO;EACL,MAAM,SAAS,KAAa,UAAmC;AAC7D,OAAI;AACF,WAAO,SAAS,YAAY,IAAI,GAAG,YAAY;KAC7C,KAAK;KACL,UAAU;KACV,OAAO;MAAC;MAAU;MAAQ;MAAO;KAClC,CAAC;YACK,OAAO;AACd,UAAM,IAAI,MACR,kBAAkB,SAAS,UAAU,IAAI,IACvC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GAEzD;;;EAIL,MAAM,MAAM,SAA0C;GACpD,MAAMA,QAAkB,EAAE;AAC1B,OAAI,SAAS,MAAO,OAAM,KAAK,KAAK;AACpC,OAAI,SAAS,YAAa,OAAM,KAAK,KAAK;AAC1C,OAAI,SAAS,QAAS,OAAM,KAAK,KAAK;AACtC,OAAI,SAAS,OAAQ,OAAM,KAAK,YAAY;AAE5C,YAAS,aAAa,MAAM,KAAK,IAAI,IAAI;IACvC,KAAK;IACL,OAAO;IACR,CAAC;;EAGJ,MAAM,UAAU,MAAiC;GAC/C,MAAM,aAAa,OAAO,QAAQ,SAAS,KAAK,GAAG;AACnD,OAAI;AACF,UAAM,OAAO,QAAQ,YAAY,OAAO,CAAC;AACzC,WAAO;WACD;AACN,WAAO;;;EAGZ"}
+{"version":3,"file":"git.js","names":["flags: string[]","entries: GitLogEntry[]"],"sources":["../../src/adapters/git.ts"],"sourcesContent":["/**\n * Node.js git adapter implementation.\n */\n\nimport { execSync } from 'node:child_process';\nimport { access } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport type { GitAdapter, GitCleanOptions, GitLogEntry } from '../ports/git';\n\n/**\n * Create a Node.js git adapter.\n */\nexport function createNodeGitAdapter(cwd?: string): GitAdapter {\n  const baseCwd = cwd ?? process.cwd();\n\n  return {\n    async showFile(ref: string, filePath: string): Promise<string> {\n      try {\n        return execSync(`git show ${ref}:${filePath}`, {\n          cwd: baseCwd,\n          encoding: 'utf-8',\n          stdio: ['ignore', 'pipe', 'pipe'],\n        });\n      } catch (error) {\n        throw new Error(\n          `Could not load ${filePath} at ref ${ref}: ${\n            error instanceof Error ? error.message : String(error)\n          }`\n        );\n      }\n    },\n\n    async clean(options?: GitCleanOptions): Promise<void> {\n      const flags: string[] = [];\n      if (options?.force) flags.push('-f');\n      if (options?.directories) flags.push('-d');\n      if (options?.ignored) flags.push('-x');\n      if (options?.dryRun) flags.push('--dry-run');\n\n      execSync(`git clean ${flags.join(' ')}`, {\n        cwd: baseCwd,\n        stdio: 'inherit',\n      });\n    },\n\n    async isGitRepo(path?: string): Promise<boolean> {\n      const targetPath = path ? resolve(baseCwd, path) : baseCwd;\n      try {\n        await access(resolve(targetPath, '.git'));\n        return true;\n      } catch {\n        return false;\n      }\n    },\n\n    async log(baseline?: string): Promise<GitLogEntry[]> {\n      const ref = baseline ?? 'HEAD~10';\n      const format = '--format=%H|||%s|||%an|||%aI';\n\n      try {\n        const output = execSync(`git log ${ref}..HEAD ${format}`, {\n          cwd: baseCwd,\n          encoding: 'utf-8',\n          stdio: ['ignore', 'pipe', 'pipe'],\n        });\n\n        const entries: GitLogEntry[] = [];\n\n        for (const line of output.trim().split('\\n')) {\n          if (!line) continue;\n          const [hash, message, author, date] = line.split('|||');\n          if (hash && message) {\n            entries.push({ hash, message, author, date });\n          }\n        }\n\n        return entries;\n      } catch {\n        // Return empty if git log fails (e.g., not enough commits)\n        return [];\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,qBAAqB,KAA0B;CAC7D,MAAM,UAAU,OAAO,QAAQ,KAAK;AAEpC,QAAO;EACL,MAAM,SAAS,KAAa,UAAmC;AAC7D,OAAI;AACF,WAAO,SAAS,YAAY,IAAI,GAAG,YAAY;KAC7C,KAAK;KACL,UAAU;KACV,OAAO;MAAC;MAAU;MAAQ;MAAO;KAClC,CAAC;YACK,OAAO;AACd,UAAM,IAAI,MACR,kBAAkB,SAAS,UAAU,IAAI,IACvC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GAEzD;;;EAIL,MAAM,MAAM,SAA0C;GACpD,MAAMA,QAAkB,EAAE;AAC1B,OAAI,SAAS,MAAO,OAAM,KAAK,KAAK;AACpC,OAAI,SAAS,YAAa,OAAM,KAAK,KAAK;AAC1C,OAAI,SAAS,QAAS,OAAM,KAAK,KAAK;AACtC,OAAI,SAAS,OAAQ,OAAM,KAAK,YAAY;AAE5C,YAAS,aAAa,MAAM,KAAK,IAAI,IAAI;IACvC,KAAK;IACL,OAAO;IACR,CAAC;;EAGJ,MAAM,UAAU,MAAiC;GAC/C,MAAM,aAAa,OAAO,QAAQ,SAAS,KAAK,GAAG;AACnD,OAAI;AACF,UAAM,OAAO,QAAQ,YAAY,OAAO,CAAC;AACzC,WAAO;WACD;AACN,WAAO;;;EAIX,MAAM,IAAI,UAA2C;GACnD,MAAM,MAAM,YAAY;GACxB,MAAM,SAAS;AAEf,OAAI;IACF,MAAM,SAAS,SAAS,WAAW,IAAI,SAAS,UAAU;KACxD,KAAK;KACL,UAAU;KACV,OAAO;MAAC;MAAU;MAAQ;MAAO;KAClC,CAAC;IAEF,MAAMC,UAAyB,EAAE;AAEjC,SAAK,MAAM,QAAQ,OAAO,MAAM,CAAC,MAAM,KAAK,EAAE;AAC5C,SAAI,CAAC,KAAM;KACX,MAAM,CAAC,MAAM,SAAS,QAAQ,QAAQ,KAAK,MAAM,MAAM;AACvD,SAAI,QAAQ,QACV,SAAQ,KAAK;MAAE;MAAM;MAAS;MAAQ;MAAM,CAAC;;AAIjD,WAAO;WACD;AAEN,WAAO,EAAE;;;EAGd"}

package/dist/adapters/index.d.ts

@@ -1,4 +1,4 @@
-import { createNodeFsAdapter } from "./fs.js";
+import { DEFAULT_SPEC_PATTERNS, createNodeFsAdapter } from "./fs.js";
 import { createNodeGitAdapter } from "./git.js";
 import { createNodeWatcherAdapter } from "./watcher.js";
 import { createNodeAiAdapter } from "./ai.js";

package/dist/adapters/index.js

@@ -1,4 +1,4 @@
-import { createNodeFsAdapter } from "./fs.js";
+import { DEFAULT_SPEC_PATTERNS, createNodeFsAdapter } from "./fs.js";
 import { createNodeGitAdapter } from "./git.js";
 import { createNodeWatcherAdapter } from "./watcher.js";
 import { createNodeAiAdapter } from "./ai.js";

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 import { DiscoverOptions, FileStat, FsAdapter } from "./ports/fs.js";
-import { GitAdapter, GitCleanOptions } from "./ports/git.js";
+import { GitAdapter, GitCleanOptions, GitLogEntry } from "./ports/git.js";
 import { WatchEvent, WatchEventHandler, WatchEventType, WatchOptions, Watcher, WatcherAdapter } from "./ports/watcher.js";
 import { AiAdapter, AiGenerateOptions, AiGenerateResult, AiGenerateStructuredOptions, AiValidationResult } from "./ports/ai.js";
 import { LogLevel, LoggerAdapter, ProgressReporter, ProgressUpdate, WorkspaceAdapters } from "./ports/logger.js";
 import "./ports/index.js";
-import { createNodeFsAdapter } from "./adapters/fs.js";
+import { DEFAULT_SPEC_PATTERNS, createNodeFsAdapter } from "./adapters/fs.js";
 import { createNodeGitAdapter } from "./adapters/git.js";
 import { createNodeWatcherAdapter } from "./adapters/watcher.js";
 import { createNodeAiAdapter } from "./adapters/ai.js";
@@ -68,7 +68,7 @@ import { generateIntegrationSpec } from "./templates/integration.template.js";
 import { generateKnowledgeSpaceSpec } from "./templates/knowledge.template.js";
 import { generateComponentTemplate, generateHandlerTemplate, generateTestTemplate } from "./templates/handler.template.js";
 import { generateWorkflowRunnerTemplate } from "./templates/workflow-runner.template.js";
-import { index_d_exports as index_d_exports$3 } from "./templates/index.js";
+import { index_d_exports as index_d_exports$4 } from "./templates/index.js";
 import { SpecCreatorService, createSpecCreator } from "./services/create/index.js";
 import { AIReviewResult, BehaviorCheck, FieldMapping, FieldMatchType, IntentAlignment, SemanticVerificationResult, StructureCheck, VerifyConfig, VerifyInput, VerifyOptions, VerifyResult } from "./services/verify/types.js";
 import { VerifyService, createVerifyService, verifyService } from "./services/verify/verify-service.js";
@@ -87,9 +87,12 @@ import { PackageInstallResult, QuickstartDependency, QuickstartMode, QuickstartO
 import { FULL_DEPENDENCIES, MINIMAL_DEPENDENCIES, getDependencies, getDevDependencies, getProductionDependencies } from "./services/quickstart/dependencies.js";
 import { formatQuickstartPreview, isContractSpecInstalled, runQuickstart } from "./services/quickstart/quickstart-service.js";
 import { DocsServiceOptions, DocsServiceResult, generateDocsFromSpecs } from "./services/docs/docs-service.js";
-import { index_d_exports as index_d_exports$1 } from "./services/impact/index.js";
+import { index_d_exports as index_d_exports$2 } from "./services/impact/index.js";
 import { FormatterOptions, formatFiles } from "./services/formatter.js";
-import { index_d_exports as index_d_exports$4 } from "./services/versioning/index.js";
+import { SpecVersionAnalysis } from "./services/versioning/types.js";
+import { index_d_exports as index_d_exports$6 } from "./services/versioning/index.js";
+import { index_d_exports as index_d_exports$5 } from "./services/upgrade/index.js";
+import { index_d_exports as index_d_exports$1 } from "./services/hooks/index.js";
 import "./services/index.js";
 import { index_d_exports } from "./formatters/index.js";
 import { AIClient } from "./ai/client.js";
@@ -100,7 +103,7 @@ import { SimpleAgent } from "./ai/agents/simple-agent.js";
 import { CursorAgent } from "./ai/agents/cursor-agent.js";
 import { ClaudeCodeAgent } from "./ai/agents/claude-code-agent.js";
 import { OpenAICodexAgent } from "./ai/agents/openai-codex-agent.js";
-import { index_d_exports as index_d_exports$2 } from "./ai/prompts/index.js";
+import { index_d_exports as index_d_exports$3 } from "./ai/prompts/index.js";
 import "./ai/index.js";
 import * as module from "@contractspec/module.workspace";
-export { AIClient, AIGenerator, AIReviewResult, ALL_CHECK_CATEGORIES, ALL_CI_CHECK_CATEGORIES, ALL_SETUP_TARGETS, AgentAdapter, AgentConfig, AgentGuideConfig, AgentGuideService, type AgentMode, AgentOrchestrator, AgentProvider, AgentResult, AgentTask, AiAdapter, AiGenerateOptions, AiGenerateResult, AiGenerateStructuredOptions, type AiProvider, AiValidationResult, AnalyzeDepsOptions, AnalyzeDepsResult, BehaviorCheck, BlueprintValidationResult, BuildSpecOptions, BuildSpecResult, BuildTarget, BuildTargetResult, CHECK_CATEGORY_LABELS, CICheckCategory, CICheckCategorySummary, CICheckOptions, CICheckResult, CIFormatOptions, CIIssue, CIIssueSeverity, CIOutputFormat, CI_CHECK_CATEGORY_LABELS, CacheEntryMeta, CacheKeyString, CacheLookupResult, CacheMissReason, CacheStats, CacheStorageAdapter, CheckCategory, CheckContext, CheckResult, CheckStatus, ClaudeCodeAdapter, ClaudeCodeAgent, CleanOptions, CleanResult, CompareSpecsOptions, CompareSpecsResult, type Config, CoverageByType, CreateAdaptersOptions, CreateRegeneratorOptions, CursorAgent, CursorCLIAdapter, DEFAULT_CACHE_CONFIG, DiagramOptions, DiagramType, DiscoverOptions, DiscoveryOptions, DocsServiceOptions, DocsServiceResult, DoctorOptions, DoctorPromptCallbacks, DoctorResult, ExtendedWorkspaceInfo, FULL_DEPENDENCIES, FieldMapping, FieldMatchType, FileStat, FileSystemCacheStorage, FixAction, FixResult, FormatOptions, FormatterOptions, FsAdapter, GenericMCPAdapter, GitAdapter, GitCleanOptions, GuideOptions, GuideResult, ImplementationSource, ImplementationStatus, ImplementationValidationResult, ImplementationValidatorOptions, InMemoryCacheStorage, IntegrityAnalysisOptions, IntegrityAnalysisResult, IntegrityIssue, IntentAlignment, KeyValueStore, LayerDiscoveryOptions, LayerDiscoveryResult, LayerInventory, LayerLocation, OpenApiExportOptions as LegacyOpenApiExportOptions, OpenApiExportResult as LegacyOpenApiExportResult, ListSpecsOptions, LogLevel, LoggerAdapter, MINIMAL_DEPENDENCIES, MetaRepoInfo, MonorepoConfig, OpenAICodexAgent, OpenApiExportServiceOptions, OpenApiExportServiceResult, OpenApiImportServiceOptions, OpenApiImportServiceResult, OpenApiSyncServiceOptions, OpenApiSyncServiceResult, OpenApiValidateServiceOptions, OpenApiValidateServiceResult, PackageInstallResult, PackageManager, ProgressReporter, ProgressUpdate, QuickstartDependency, QuickstartMode, QuickstartOptions, QuickstartPromptCallbacks, QuickstartResult, RegistryClient, RegistryClientOptions, RepositoryType, ResolvedImplementation, ResolverOptions, RunTestsResult, SETUP_TARGET_LABELS, SemanticVerificationResult, SetupFileResult, SetupOptions, SetupPromptCallbacks, SetupResult, SetupScope, SetupTarget, SimpleAgent, SpecCreatorService, SpecImplementationResult, SpecInventory, SpecLocation, SpecReferenceMatch, StructureCheck, SubmoduleInfo, SyncBuildFn, SyncSpecsOptions, SyncSpecsResult, SyncSpecsRunResult, SyncValidateFn, TenantValidationContext, TenantValidationResult, TestServiceOptions, TestServiceResult, ValidateImplementationOptions, ValidateImplementationResult, ValidateSpecOptions, ValidateSpecResult, VerificationCacheConfig, VerificationCacheEntry, VerificationCacheKey, VerificationCacheService, VerificationIssue, VerifyConfig, VerifyInput, VerifyOptions, VerifyResult, VerifyService, WatchBuildFn, WatchEvent, WatchEventHandler, WatchEventType, WatchOptions, WatchSpecsOptions, WatchValidateFn, Watcher, WatcherAdapter, WorkspaceAdapters, WorkspaceConfigInfo, WorkspaceInfo, WorkspaceStateCacheStorage, addToRegistry, agentAdapters, agentGuideService, analyzeDeps, analyzeIntegrity, buildSpec, cacheKeyToString, claudeCodeAdapter, cleanArtifacts, compareSpecs, computeContentHash, createAgentGuideService, createConsoleLoggerAdapter, createEmptyLayerInventory, createFileSystemCacheStorage, createInMemoryCacheStorage, createNodeAdapters, createNodeAiAdapter, createNodeFsAdapter, createNodeGitAdapter, createNodeWatcherAdapter, createNoopLoggerAdapter, createQuickAIReview, createRegeneratorService, createSpecCreator, createVerificationCacheService, createVerifyService, createWorkspaceStateCacheStorage, cursorCLIAdapter, deepMergeOverwrite, deepMergePreserve, detectPackageManager, detectRepositoryType, discoverAllImplementations, discoverImplementationsForSpec, discoverLayers, exportGraphAsDot, exportOpenApi, exportSpecForLLM, extractSpecReferences, filterIssuesBySeverity, filterIssuesByType, findAllConfigFiles, findMetaRepoRoot, findPackageRoot, findWorkspaceRoot, formatCheckResult, formatDoctorSummary, formatFiles, formatJson, formatQuickstartPreview, formatVerificationReport, formatWorkspaceInfo, index_d_exports as formatters, generateAgentsMd, generateAppBlueprintSpec, generateClaudeMcpConfig, generateComponentTemplate, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateCursorRulesFromParsedSpec, generateDataViewSpec, generateDocsFromSpecs, generateEventSpec, generateExperimentSpec, generateFeatureContextMarkdown, generateGuideFromParsedSpec, generateHandlerTemplate, generateIntegrationSpec, generateKnowledgeSpaceSpec, generateMermaidDiagram, generateMigrationSpec, generateOperationSpec, generatePresentationSpec, generateTelemetrySpec, generateTestTemplate, generateVscodeSettings, generateWorkflowRunnerTemplate, generateWorkflowSpec, genericMCPAdapter, getAIProvider, getAgentAdapter, getAllLayerLocations, getAllSpecs, getApiKey, getClaudeDesktopConfigPath, getContractNode, getDependencies, getDevDependencies, getExecCommand, getExtendedWorkspaceInfo, getGraphStats, getImplementationSummary, getInstallCommand, getMetaRepoInfo, getPackageName, getProductionDependencies, getRecommendedModels, getRunCommand, getWorkspaceInfo, getWorkspacePackages, groupSpecsByType, index_d_exports$1 as impact, importFromOpenApiService, inferImplementationType, isContractSpecInstalled, isMonorepo, listAgentTypes, listFromRegistry, listSpecs, loadWorkspaceConfig, mergeMonorepoConfigs, module, parseGitModules, index_d_exports$2 as prompts, resolveAllImplementations, resolveImplementations, resolveRegistryUrl, runCIChecks, runDoctor, runQuickstart, runSetup, runTestSpecs, runTests, safeParseJson, searchRegistry, stringToCacheKey, syncSpecs, syncWithOpenApiService, index_d_exports$3 as templates, validateAgainstOpenApiService, validateBlueprint, validateImplementationFiles, validateImplementationWithAgent, validateProvider, validateSpec, validateSpecs, validateTenantConfig, verifyBehavior, verifyImplementationAgainstParsedSpec, verifySemanticFields, verifyService, verifyStructure, verifyWithAI, verifyWithAIEnhanced, index_d_exports$4 as versioning, watchSpecs };
+export { AIClient, AIGenerator, AIReviewResult, ALL_CHECK_CATEGORIES, ALL_CI_CHECK_CATEGORIES, ALL_SETUP_TARGETS, AgentAdapter, AgentConfig, AgentGuideConfig, AgentGuideService, type AgentMode, AgentOrchestrator, AgentProvider, AgentResult, AgentTask, AiAdapter, AiGenerateOptions, AiGenerateResult, AiGenerateStructuredOptions, type AiProvider, AiValidationResult, AnalyzeDepsOptions, AnalyzeDepsResult, BehaviorCheck, BlueprintValidationResult, BuildSpecOptions, BuildSpecResult, BuildTarget, BuildTargetResult, CHECK_CATEGORY_LABELS, CICheckCategory, CICheckCategorySummary, CICheckOptions, CICheckResult, CIFormatOptions, CIIssue, CIIssueSeverity, CIOutputFormat, CI_CHECK_CATEGORY_LABELS, CacheEntryMeta, CacheKeyString, CacheLookupResult, CacheMissReason, CacheStats, CacheStorageAdapter, CheckCategory, CheckContext, CheckResult, CheckStatus, ClaudeCodeAdapter, ClaudeCodeAgent, CleanOptions, CleanResult, CompareSpecsOptions, CompareSpecsResult, type Config, CoverageByType, CreateAdaptersOptions, CreateRegeneratorOptions, CursorAgent, CursorCLIAdapter, DEFAULT_CACHE_CONFIG, DEFAULT_SPEC_PATTERNS, DiagramOptions, DiagramType, DiscoverOptions, DiscoveryOptions, DocsServiceOptions, DocsServiceResult, DoctorOptions, DoctorPromptCallbacks, DoctorResult, ExtendedWorkspaceInfo, FULL_DEPENDENCIES, FieldMapping, FieldMatchType, FileStat, FileSystemCacheStorage, FixAction, FixResult, FormatOptions, FormatterOptions, FsAdapter, GenericMCPAdapter, GitAdapter, GitCleanOptions, GitLogEntry, GuideOptions, GuideResult, ImplementationSource, ImplementationStatus, ImplementationValidationResult, ImplementationValidatorOptions, InMemoryCacheStorage, IntegrityAnalysisOptions, IntegrityAnalysisResult, IntegrityIssue, IntentAlignment, KeyValueStore, LayerDiscoveryOptions, LayerDiscoveryResult, LayerInventory, LayerLocation, OpenApiExportOptions as LegacyOpenApiExportOptions, OpenApiExportResult as LegacyOpenApiExportResult, ListSpecsOptions, LogLevel, LoggerAdapter, MINIMAL_DEPENDENCIES, MetaRepoInfo, MonorepoConfig, OpenAICodexAgent, OpenApiExportServiceOptions, OpenApiExportServiceResult, OpenApiImportServiceOptions, OpenApiImportServiceResult, OpenApiSyncServiceOptions, OpenApiSyncServiceResult, OpenApiValidateServiceOptions, OpenApiValidateServiceResult, PackageInstallResult, PackageManager, ProgressReporter, ProgressUpdate, QuickstartDependency, QuickstartMode, QuickstartOptions, QuickstartPromptCallbacks, QuickstartResult, RegistryClient, RegistryClientOptions, RepositoryType, ResolvedImplementation, ResolverOptions, RunTestsResult, SETUP_TARGET_LABELS, SemanticVerificationResult, SetupFileResult, SetupOptions, SetupPromptCallbacks, SetupResult, SetupScope, SetupTarget, SimpleAgent, SpecCreatorService, SpecImplementationResult, SpecInventory, SpecLocation, SpecReferenceMatch, SpecVersionAnalysis, StructureCheck, SubmoduleInfo, SyncBuildFn, SyncSpecsOptions, SyncSpecsResult, SyncSpecsRunResult, SyncValidateFn, TenantValidationContext, TenantValidationResult, TestServiceOptions, TestServiceResult, ValidateImplementationOptions, ValidateImplementationResult, ValidateSpecOptions, ValidateSpecResult, VerificationCacheConfig, VerificationCacheEntry, VerificationCacheKey, VerificationCacheService, VerificationIssue, VerifyConfig, VerifyInput, VerifyOptions, VerifyResult, VerifyService, WatchBuildFn, WatchEvent, WatchEventHandler, WatchEventType, WatchOptions, WatchSpecsOptions, WatchValidateFn, Watcher, WatcherAdapter, WorkspaceAdapters, WorkspaceConfigInfo, WorkspaceInfo, WorkspaceStateCacheStorage, addToRegistry, agentAdapters, agentGuideService, analyzeDeps, analyzeIntegrity, buildSpec, cacheKeyToString, claudeCodeAdapter, cleanArtifacts, compareSpecs, computeContentHash, createAgentGuideService, createConsoleLoggerAdapter, createEmptyLayerInventory, createFileSystemCacheStorage, createInMemoryCacheStorage, createNodeAdapters, createNodeAiAdapter, createNodeFsAdapter, createNodeGitAdapter, createNodeWatcherAdapter, createNoopLoggerAdapter, createQuickAIReview, createRegeneratorService, createSpecCreator, createVerificationCacheService, createVerifyService, createWorkspaceStateCacheStorage, cursorCLIAdapter, deepMergeOverwrite, deepMergePreserve, detectPackageManager, detectRepositoryType, discoverAllImplementations, discoverImplementationsForSpec, discoverLayers, exportGraphAsDot, exportOpenApi, exportSpecForLLM, extractSpecReferences, filterIssuesBySeverity, filterIssuesByType, findAllConfigFiles, findMetaRepoRoot, findPackageRoot, findWorkspaceRoot, formatCheckResult, formatDoctorSummary, formatFiles, formatJson, formatQuickstartPreview, formatVerificationReport, formatWorkspaceInfo, index_d_exports as formatters, generateAgentsMd, generateAppBlueprintSpec, generateClaudeMcpConfig, generateComponentTemplate, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateCursorRulesFromParsedSpec, generateDataViewSpec, generateDocsFromSpecs, generateEventSpec, generateExperimentSpec, generateFeatureContextMarkdown, generateGuideFromParsedSpec, generateHandlerTemplate, generateIntegrationSpec, generateKnowledgeSpaceSpec, generateMermaidDiagram, generateMigrationSpec, generateOperationSpec, generatePresentationSpec, generateTelemetrySpec, generateTestTemplate, generateVscodeSettings, generateWorkflowRunnerTemplate, generateWorkflowSpec, genericMCPAdapter, getAIProvider, getAgentAdapter, getAllLayerLocations, getAllSpecs, getApiKey, getClaudeDesktopConfigPath, getContractNode, getDependencies, getDevDependencies, getExecCommand, getExtendedWorkspaceInfo, getGraphStats, getImplementationSummary, getInstallCommand, getMetaRepoInfo, getPackageName, getProductionDependencies, getRecommendedModels, getRunCommand, getWorkspaceInfo, getWorkspacePackages, groupSpecsByType, index_d_exports$1 as hooks, index_d_exports$2 as impact, importFromOpenApiService, inferImplementationType, isContractSpecInstalled, isMonorepo, listAgentTypes, listFromRegistry, listSpecs, loadWorkspaceConfig, mergeMonorepoConfigs, module, parseGitModules, index_d_exports$3 as prompts, resolveAllImplementations, resolveImplementations, resolveRegistryUrl, runCIChecks, runDoctor, runQuickstart, runSetup, runTestSpecs, runTests, safeParseJson, searchRegistry, stringToCacheKey, syncSpecs, syncWithOpenApiService, index_d_exports$4 as templates, index_d_exports$5 as upgrade, validateAgainstOpenApiService, validateBlueprint, validateImplementationFiles, validateImplementationWithAgent, validateProvider, validateSpec, validateSpecs, validateTenantConfig, verifyBehavior, verifyImplementationAgainstParsedSpec, verifySemanticFields, verifyService, verifyStructure, verifyWithAI, verifyWithAIEnhanced, index_d_exports$6 as versioning, watchSpecs };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { createNodeFsAdapter } from "./adapters/fs.js";
+import { DEFAULT_SPEC_PATTERNS, createNodeFsAdapter } from "./adapters/fs.js";
 import { createNodeGitAdapter } from "./adapters/git.js";
 import { createNodeWatcherAdapter } from "./adapters/watcher.js";
 import { createNodeAiAdapter } from "./adapters/ai.js";
@@ -84,6 +84,8 @@ import { generateDocsFromSpecs } from "./services/docs/docs-service.js";
 import { impact_exports } from "./services/impact/index.js";
 import { formatFiles } from "./services/formatter.js";
 import { versioning_exports } from "./services/versioning/index.js";
+import { upgrade_exports } from "./services/upgrade/index.js";
+import { hooks_exports } from "./services/hooks/index.js";
 import "./services/index.js";
 import { formatters_exports } from "./formatters/index.js";
 import { AIClient } from "./ai/client.js";
@@ -91,4 +93,4 @@ import { prompts_exports } from "./ai/prompts/index.js";
 import "./ai/index.js";
 import * as module from "@contractspec/module.workspace";
 
-export { AIClient, AIGenerator, ALL_CHECK_CATEGORIES, ALL_CI_CHECK_CATEGORIES, ALL_SETUP_TARGETS, AgentGuideService, AgentOrchestrator, CHECK_CATEGORY_LABELS, CI_CHECK_CATEGORY_LABELS, ClaudeCodeAdapter, ClaudeCodeAgent, CursorAgent, CursorCLIAdapter, DEFAULT_CACHE_CONFIG, FULL_DEPENDENCIES, FileSystemCacheStorage, GenericMCPAdapter, InMemoryCacheStorage, MINIMAL_DEPENDENCIES, OpenAICodexAgent, RegistryClient, SETUP_TARGET_LABELS, SimpleAgent, SpecCreatorService, VerificationCacheService, VerifyService, WorkspaceStateCacheStorage, addToRegistry, agentAdapters, agentGuideService, analyzeDeps, analyzeIntegrity, buildSpec, cacheKeyToString, claudeCodeAdapter, cleanArtifacts, compareSpecs, computeContentHash, createAgentGuideService, createConsoleLoggerAdapter, createEmptyLayerInventory, createFileSystemCacheStorage, createInMemoryCacheStorage, createNodeAdapters, createNodeAiAdapter, createNodeFsAdapter, createNodeGitAdapter, createNodeWatcherAdapter, createNoopLoggerAdapter, createQuickAIReview, createRegeneratorService, createSpecCreator, createVerificationCacheService, createVerifyService, createWorkspaceStateCacheStorage, cursorCLIAdapter, deepMergeOverwrite, deepMergePreserve, detectPackageManager, detectRepositoryType, discoverAllImplementations, discoverImplementationsForSpec, discoverLayers, exportGraphAsDot, exportOpenApi, exportSpecForLLM, extractSpecReferences, filterIssuesBySeverity, filterIssuesByType, findAllConfigFiles, findMetaRepoRoot, findPackageRoot, findWorkspaceRoot, formatCheckResult, formatDoctorSummary, formatFiles, formatJson, formatQuickstartPreview, formatVerificationReport, formatWorkspaceInfo, formatters_exports as formatters, generateAgentsMd, generateAppBlueprintSpec, generateClaudeMcpConfig, generateComponentTemplate, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateCursorRulesFromParsedSpec, generateDataViewSpec, generateDocsFromSpecs, generateEventSpec, generateExperimentSpec, generateFeatureContextMarkdown, generateGuideFromParsedSpec, generateHandlerTemplate, generateIntegrationSpec, generateKnowledgeSpaceSpec, generateMermaidDiagram, generateMigrationSpec, generateOperationSpec, generatePresentationSpec, generateTelemetrySpec, generateTestTemplate, generateVscodeSettings, generateWorkflowRunnerTemplate, generateWorkflowSpec, genericMCPAdapter, getAIProvider, getAgentAdapter, getAllLayerLocations, getAllSpecs, getApiKey, getClaudeDesktopConfigPath, getContractNode, getDependencies, getDevDependencies, getExecCommand, getExtendedWorkspaceInfo, getGraphStats, getImplementationSummary, getInstallCommand, getMetaRepoInfo, getPackageName, getProductionDependencies, getRecommendedModels, getRunCommand, getWorkspaceInfo, getWorkspacePackages, groupSpecsByType, impact_exports as impact, importFromOpenApiService, inferImplementationType, isContractSpecInstalled, isMonorepo, listAgentTypes, listFromRegistry, listSpecs, loadWorkspaceConfig, mergeMonorepoConfigs, module, parseGitModules, prompts_exports as prompts, resolveAllImplementations, resolveImplementations, resolveRegistryUrl, runCIChecks, runDoctor, runQuickstart, runSetup, runTestSpecs, runTests, safeParseJson, searchRegistry, stringToCacheKey, syncSpecs, syncWithOpenApiService, templates_exports as templates, validateAgainstOpenApiService, validateBlueprint, validateImplementationFiles, validateImplementationWithAgent, validateProvider, validateSpec, validateSpecs, validateTenantConfig, verifyBehavior, verifyImplementationAgainstParsedSpec, verifySemanticFields, verifyService, verifyStructure, verifyWithAI, verifyWithAIEnhanced, versioning_exports as versioning, watchSpecs };
+export { AIClient, AIGenerator, ALL_CHECK_CATEGORIES, ALL_CI_CHECK_CATEGORIES, ALL_SETUP_TARGETS, AgentGuideService, AgentOrchestrator, CHECK_CATEGORY_LABELS, CI_CHECK_CATEGORY_LABELS, ClaudeCodeAdapter, ClaudeCodeAgent, CursorAgent, CursorCLIAdapter, DEFAULT_CACHE_CONFIG, DEFAULT_SPEC_PATTERNS, FULL_DEPENDENCIES, FileSystemCacheStorage, GenericMCPAdapter, InMemoryCacheStorage, MINIMAL_DEPENDENCIES, OpenAICodexAgent, RegistryClient, SETUP_TARGET_LABELS, SimpleAgent, SpecCreatorService, VerificationCacheService, VerifyService, WorkspaceStateCacheStorage, addToRegistry, agentAdapters, agentGuideService, analyzeDeps, analyzeIntegrity, buildSpec, cacheKeyToString, claudeCodeAdapter, cleanArtifacts, compareSpecs, computeContentHash, createAgentGuideService, createConsoleLoggerAdapter, createEmptyLayerInventory, createFileSystemCacheStorage, createInMemoryCacheStorage, createNodeAdapters, createNodeAiAdapter, createNodeFsAdapter, createNodeGitAdapter, createNodeWatcherAdapter, createNoopLoggerAdapter, createQuickAIReview, createRegeneratorService, createSpecCreator, createVerificationCacheService, createVerifyService, createWorkspaceStateCacheStorage, cursorCLIAdapter, deepMergeOverwrite, deepMergePreserve, detectPackageManager, detectRepositoryType, discoverAllImplementations, discoverImplementationsForSpec, discoverLayers, exportGraphAsDot, exportOpenApi, exportSpecForLLM, extractSpecReferences, filterIssuesBySeverity, filterIssuesByType, findAllConfigFiles, findMetaRepoRoot, findPackageRoot, findWorkspaceRoot, formatCheckResult, formatDoctorSummary, formatFiles, formatJson, formatQuickstartPreview, formatVerificationReport, formatWorkspaceInfo, formatters_exports as formatters, generateAgentsMd, generateAppBlueprintSpec, generateClaudeMcpConfig, generateComponentTemplate, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateCursorRulesFromParsedSpec, generateDataViewSpec, generateDocsFromSpecs, generateEventSpec, generateExperimentSpec, generateFeatureContextMarkdown, generateGuideFromParsedSpec, generateHandlerTemplate, generateIntegrationSpec, generateKnowledgeSpaceSpec, generateMermaidDiagram, generateMigrationSpec, generateOperationSpec, generatePresentationSpec, generateTelemetrySpec, generateTestTemplate, generateVscodeSettings, generateWorkflowRunnerTemplate, generateWorkflowSpec, genericMCPAdapter, getAIProvider, getAgentAdapter, getAllLayerLocations, getAllSpecs, getApiKey, getClaudeDesktopConfigPath, getContractNode, getDependencies, getDevDependencies, getExecCommand, getExtendedWorkspaceInfo, getGraphStats, getImplementationSummary, getInstallCommand, getMetaRepoInfo, getPackageName, getProductionDependencies, getRecommendedModels, getRunCommand, getWorkspaceInfo, getWorkspacePackages, groupSpecsByType, hooks_exports as hooks, impact_exports as impact, importFromOpenApiService, inferImplementationType, isContractSpecInstalled, isMonorepo, listAgentTypes, listFromRegistry, listSpecs, loadWorkspaceConfig, mergeMonorepoConfigs, module, parseGitModules, prompts_exports as prompts, resolveAllImplementations, resolveImplementations, resolveRegistryUrl, runCIChecks, runDoctor, runQuickstart, runSetup, runTestSpecs, runTests, safeParseJson, searchRegistry, stringToCacheKey, syncSpecs, syncWithOpenApiService, templates_exports as templates, upgrade_exports as upgrade, validateAgainstOpenApiService, validateBlueprint, validateImplementationFiles, validateImplementationWithAgent, validateProvider, validateSpec, validateSpecs, validateTenantConfig, verifyBehavior, verifyImplementationAgainstParsedSpec, verifySemanticFields, verifyService, verifyStructure, verifyWithAI, verifyWithAIEnhanced, versioning_exports as versioning, watchSpecs };

package/dist/ports/git.d.ts

@@ -18,6 +18,19 @@ interface GitAdapter {
    * Check if path is inside a git repository.
    */
   isGitRepo(path?: string): Promise<boolean>;
+  /**
+   * Get commit log since a baseline ref.
+   */
+  log(baseline?: string): Promise<GitLogEntry[]>;
+}
+/**
+ * Entry from git log.
+ */
+interface GitLogEntry {
+  hash: string;
+  message: string;
+  author?: string;
+  date?: string;
 }
 /**
  * Options for git clean.
@@ -29,5 +42,5 @@ interface GitCleanOptions {
   ignored?: boolean;
 }
 //#endregion
-export { GitAdapter, GitCleanOptions };
+export { GitAdapter, GitCleanOptions, GitLogEntry };
 //# sourceMappingURL=git.d.ts.map

package/dist/ports/git.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","names":[],"sources":["../../src/ports/git.ts"],"sourcesContent":[],"mappings":";;AAOA;;;;;AAcmC,UAdlB,UAAA,CAckB;EAMlB;;;2CAhB0B;;;;kBAKzB,kBAAkB;;;;4BAKR;;;;;UAMX,eAAA"}
+{"version":3,"file":"git.d.ts","names":[],"sources":["../../src/ports/git.ts"],"sourcesContent":[],"mappings":";;AAOA;;;;;AAmBkC,UAnBjB,UAAA,CAmBiB;EAAR;;AAM1B;EAUiB,QAAA,CAAA,GAAA,EAAA,MAAe,EAAA,QAAA,EAAA,MAAA,CAAA,EA/BW,OA+BX,CAAA,MAAA,CAAA;;;;kBA1Bd,kBAAkB;;;;4BAKR;;;;0BAKF,QAAQ;;;;;UAMjB,WAAA;;;;;;;;;UAUA,eAAA"}

package/dist/ports/index.d.ts

@@ -1,5 +1,5 @@
 import { DiscoverOptions, FileStat, FsAdapter } from "./fs.js";
-import { GitAdapter, GitCleanOptions } from "./git.js";
+import { GitAdapter, GitCleanOptions, GitLogEntry } from "./git.js";
 import { WatchEvent, WatchEventHandler, WatchEventType, WatchOptions, Watcher, WatcherAdapter } from "./watcher.js";
 import { AiAdapter, AiGenerateOptions, AiGenerateResult, AiGenerateStructuredOptions, AiValidationResult } from "./ai.js";
 import { LogLevel, LoggerAdapter, ProgressReporter, ProgressUpdate, WorkspaceAdapters } from "./logger.js";

package/dist/services/doctor/checks/config.js

@@ -10,6 +10,8 @@ async function runConfigChecks(fs, ctx) {
 	results.push(await checkContractsrcExists(fs, ctx));
 	results.push(await checkContractsrcValid(fs, ctx));
 	results.push(await checkContractsrcFields(fs, ctx));
+	results.push(await checkVersioningConfig(fs, ctx));
+	results.push(await checkHooksConfig(fs, ctx));
 	return results;
 }
 /**
@@ -165,6 +167,136 @@ async function checkContractsrcFields(fs, ctx) {
 		};
 	}
 }
+/**
+* Check if versioning configuration is present.
+*/
+async function checkVersioningConfig(fs, ctx) {
+	const configPath = fs.join(ctx.workspaceRoot, ".contractsrc.json");
+	if (!await fs.exists(configPath)) return {
+		category: "config",
+		name: "Versioning Config",
+		status: "skip",
+		message: "Config file does not exist"
+	};
+	try {
+		const content = await fs.readFile(configPath);
+		const config = JSON.parse(content);
+		if (config["versioning"]) return {
+			category: "config",
+			name: "Versioning Config",
+			status: "pass",
+			message: config["versioning"]["integrateWithChangesets"] === true ? "Versioning configured with Changesets integration" : "Versioning configured"
+		};
+		return {
+			category: "config",
+			name: "Versioning Config",
+			status: "warn",
+			message: "Versioning configuration not found",
+			details: "Consider adding versioning config for automated version bumps and changelog generation",
+			fix: {
+				description: "Add versioning configuration with defaults",
+				apply: async () => {
+					try {
+						config["versioning"] = {
+							autoBump: false,
+							bumpStrategy: "impact",
+							changelogTiers: [
+								"spec",
+								"library",
+								"monorepo"
+							],
+							format: "keep-a-changelog",
+							commitChanges: false,
+							createTags: false,
+							integrateWithChangesets: true
+						};
+						await fs.writeFile(configPath, formatJson(config));
+						return {
+							success: true,
+							message: "Added versioning configuration"
+						};
+					} catch (err) {
+						return {
+							success: false,
+							message: `Failed: ${err instanceof Error ? err.message : String(err)}`
+						};
+					}
+				}
+			}
+		};
+	} catch {
+		return {
+			category: "config",
+			name: "Versioning Config",
+			status: "skip",
+			message: "Could not parse config"
+		};
+	}
+}
+/**
+* Check if hooks configuration is present.
+*/
+async function checkHooksConfig(fs, ctx) {
+	const configPath = fs.join(ctx.workspaceRoot, ".contractsrc.json");
+	if (!await fs.exists(configPath)) return {
+		category: "config",
+		name: "Hooks Config",
+		status: "skip",
+		message: "Config file does not exist"
+	};
+	try {
+		const content = await fs.readFile(configPath);
+		const config = JSON.parse(content);
+		if (config["hooks"]) {
+			const hooks = config["hooks"];
+			return {
+				category: "config",
+				name: "Hooks Config",
+				status: "pass",
+				message: `${Object.keys(hooks).length} git hook(s) configured`
+			};
+		}
+		const huskyPath = fs.join(ctx.workspaceRoot, ".husky");
+		if (await fs.exists(huskyPath)) return {
+			category: "config",
+			name: "Hooks Config",
+			status: "warn",
+			message: "Husky detected but no hooks configured in .contractsrc.json",
+			details: "Add hooks config to run contractspec checks from git hooks",
+			fix: {
+				description: "Add pre-commit hooks configuration",
+				apply: async () => {
+					try {
+						config["hooks"] = { "pre-commit": ["contractspec validate **/*.operation.ts", "contractspec integrity check"] };
+						await fs.writeFile(configPath, formatJson(config));
+						return {
+							success: true,
+							message: "Added hooks configuration"
+						};
+					} catch (err) {
+						return {
+							success: false,
+							message: `Failed: ${err instanceof Error ? err.message : String(err)}`
+						};
+					}
+				}
+			}
+		};
+		return {
+			category: "config",
+			name: "Hooks Config",
+			status: "pass",
+			message: "No hooks configured (optional)"
+		};
+	} catch {
+		return {
+			category: "config",
+			name: "Hooks Config",
+			status: "skip",
+			message: "Could not parse config"
+		};
+	}
+}
 
 //#endregion
 export { runConfigChecks };

package/dist/services/doctor/checks/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":["results: CheckResult[]","missingFields: string[]"],"sources":["../../../../src/services/doctor/checks/config.ts"],"sourcesContent":["/**\n * Configuration file health checks.\n */\n\nimport type { FsAdapter } from '../../../ports/fs';\nimport type { CheckResult, CheckContext, FixResult } from '../types';\nimport { generateContractsrcConfig } from '../../setup/config-generators';\nimport { formatJson } from '../../setup/file-merger';\n\n/**\n * Run configuration-related health checks.\n */\nexport async function runConfigChecks(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  // Check if .contractsrc.json exists\n  results.push(await checkContractsrcExists(fs, ctx));\n\n  // Check if .contractsrc.json is valid\n  results.push(await checkContractsrcValid(fs, ctx));\n\n  // Check required fields in config\n  results.push(await checkContractsrcFields(fs, ctx));\n\n  return results;\n}\n\n/**\n * Check if .contractsrc.json exists.\n */\nasync function checkContractsrcExists(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const configPath = fs.join(ctx.workspaceRoot, '.contractsrc.json');\n\n  const exists = await fs.exists(configPath);\n  if (exists) {\n    return {\n      category: 'config',\n      name: 'Config File Exists',\n      status: 'pass',\n      message: '.contractsrc.json found',\n    };\n  }\n\n  return {\n    category: 'config',\n    name: 'Config File Exists',\n    status: 'fail',\n    message: '.contractsrc.json not found',\n    fix: {\n      description: 'Create .contractsrc.json with defaults',\n      apply: async (): Promise<FixResult> => {\n        try {\n          const defaults = generateContractsrcConfig({\n            workspaceRoot: ctx.workspaceRoot,\n            interactive: false,\n            targets: [],\n          });\n          await fs.writeFile(configPath, formatJson(defaults));\n          return { success: true, message: 'Created .contractsrc.json' };\n        } catch (error) {\n          const msg = error instanceof Error ? error.message : String(error);\n          return { success: false, message: `Failed to create: ${msg}` };\n        }\n      },\n    },\n  };\n}\n\n/**\n * Check if .contractsrc.json is valid JSON.\n */\nasync function checkContractsrcValid(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const configPath = fs.join(ctx.workspaceRoot, '.contractsrc.json');\n\n  const exists = await fs.exists(configPath);\n  if (!exists) {\n    return {\n      category: 'config',\n      name: 'Config Valid JSON',\n      status: 'skip',\n      message: 'Config file does not exist',\n    };\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    JSON.parse(content);\n\n    return {\n      category: 'config',\n      name: 'Config Valid JSON',\n      status: 'pass',\n      message: '.contractsrc.json is valid JSON',\n    };\n  } catch (error) {\n    const msg = error instanceof Error ? error.message : String(error);\n\n    return {\n      category: 'config',\n      name: 'Config Valid JSON',\n      status: 'fail',\n      message: '.contractsrc.json is not valid JSON',\n      details: msg,\n      fix: {\n        description: 'Replace with valid default config',\n        apply: async (): Promise<FixResult> => {\n          try {\n            const defaults = generateContractsrcConfig({\n              workspaceRoot: ctx.workspaceRoot,\n              interactive: false,\n              targets: [],\n            });\n            await fs.writeFile(configPath, formatJson(defaults));\n            return { success: true, message: 'Replaced with valid config' };\n          } catch (err) {\n            const m = err instanceof Error ? err.message : String(err);\n            return { success: false, message: `Failed: ${m}` };\n          }\n        },\n      },\n    };\n  }\n}\n\n/**\n * Check required fields in .contractsrc.json.\n */\nasync function checkContractsrcFields(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const configPath = fs.join(ctx.workspaceRoot, '.contractsrc.json');\n\n  const exists = await fs.exists(configPath);\n  if (!exists) {\n    return {\n      category: 'config',\n      name: 'Config Fields',\n      status: 'skip',\n      message: 'Config file does not exist',\n    };\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    const config = JSON.parse(content) as Record<string, unknown>;\n\n    const missingFields: string[] = [];\n\n    // Check for recommended fields\n    if (!config['outputDir']) {\n      missingFields.push('outputDir');\n    }\n    if (!config['conventions']) {\n      missingFields.push('conventions');\n    }\n\n    if (missingFields.length === 0) {\n      return {\n        category: 'config',\n        name: 'Config Fields',\n        status: 'pass',\n        message: 'All recommended fields present',\n      };\n    }\n\n    return {\n      category: 'config',\n      name: 'Config Fields',\n      status: 'warn',\n      message: `Missing recommended fields: ${missingFields.join(', ')}`,\n      fix: {\n        description: 'Add missing fields with defaults',\n        apply: async (): Promise<FixResult> => {\n          try {\n            const defaults = generateContractsrcConfig({\n              workspaceRoot: ctx.workspaceRoot,\n              interactive: false,\n              targets: [],\n            }) as Record<string, unknown>;\n\n            // Merge missing fields\n            for (const field of missingFields) {\n              if (defaults[field] !== undefined) {\n                config[field] = defaults[field];\n              }\n            }\n\n            await fs.writeFile(configPath, formatJson(config));\n            return { success: true, message: 'Added missing fields' };\n          } catch (err) {\n            const m = err instanceof Error ? err.message : String(err);\n            return { success: false, message: `Failed: ${m}` };\n          }\n        },\n      },\n    };\n  } catch {\n    return {\n      category: 'config',\n      name: 'Config Fields',\n      status: 'skip',\n      message: 'Could not parse config',\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"config.js","names":["results: CheckResult[]","missingFields: string[]"],"sources":["../../../../src/services/doctor/checks/config.ts"],"sourcesContent":["/**\n * Configuration file health checks.\n */\n\nimport type { FsAdapter } from '../../../ports/fs';\nimport type { CheckResult, CheckContext, FixResult } from '../types';\nimport { generateContractsrcConfig } from '../../setup/config-generators';\nimport { formatJson } from '../../setup/file-merger';\n\n/**\n * Run configuration-related health checks.\n */\nexport async function runConfigChecks(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  // Check if .contractsrc.json exists\n  results.push(await checkContractsrcExists(fs, ctx));\n\n  // Check if .contractsrc.json is valid\n  results.push(await checkContractsrcValid(fs, ctx));\n\n  // Check required fields in config\n  results.push(await checkContractsrcFields(fs, ctx));\n\n  // Check versioning configuration\n  results.push(await checkVersioningConfig(fs, ctx));\n\n  // Check hooks configuration\n  results.push(await checkHooksConfig(fs, ctx));\n\n  return results;\n}\n\n/**\n * Check if .contractsrc.json exists.\n */\nasync function checkContractsrcExists(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const configPath = fs.join(ctx.workspaceRoot, '.contractsrc.json');\n\n  const exists = await fs.exists(configPath);\n  if (exists) {\n    return {\n      category: 'config',\n      name: 'Config File Exists',\n      status: 'pass',\n      message: '.contractsrc.json found',\n    };\n  }\n\n  return {\n    category: 'config',\n    name: 'Config File Exists',\n    status: 'fail',\n    message: '.contractsrc.json not found',\n    fix: {\n      description: 'Create .contractsrc.json with defaults',\n      apply: async (): Promise<FixResult> => {\n        try {\n          const defaults = generateContractsrcConfig({\n            workspaceRoot: ctx.workspaceRoot,\n            interactive: false,\n            targets: [],\n          });\n          await fs.writeFile(configPath, formatJson(defaults));\n          return { success: true, message: 'Created .contractsrc.json' };\n        } catch (error) {\n          const msg = error instanceof Error ? error.message : String(error);\n          return { success: false, message: `Failed to create: ${msg}` };\n        }\n      },\n    },\n  };\n}\n\n/**\n * Check if .contractsrc.json is valid JSON.\n */\nasync function checkContractsrcValid(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const configPath = fs.join(ctx.workspaceRoot, '.contractsrc.json');\n\n  const exists = await fs.exists(configPath);\n  if (!exists) {\n    return {\n      category: 'config',\n      name: 'Config Valid JSON',\n      status: 'skip',\n      message: 'Config file does not exist',\n    };\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    JSON.parse(content);\n\n    return {\n      category: 'config',\n      name: 'Config Valid JSON',\n      status: 'pass',\n      message: '.contractsrc.json is valid JSON',\n    };\n  } catch (error) {\n    const msg = error instanceof Error ? error.message : String(error);\n\n    return {\n      category: 'config',\n      name: 'Config Valid JSON',\n      status: 'fail',\n      message: '.contractsrc.json is not valid JSON',\n      details: msg,\n      fix: {\n        description: 'Replace with valid default config',\n        apply: async (): Promise<FixResult> => {\n          try {\n            const defaults = generateContractsrcConfig({\n              workspaceRoot: ctx.workspaceRoot,\n              interactive: false,\n              targets: [],\n            });\n            await fs.writeFile(configPath, formatJson(defaults));\n            return { success: true, message: 'Replaced with valid config' };\n          } catch (err) {\n            const m = err instanceof Error ? err.message : String(err);\n            return { success: false, message: `Failed: ${m}` };\n          }\n        },\n      },\n    };\n  }\n}\n\n/**\n * Check required fields in .contractsrc.json.\n */\nasync function checkContractsrcFields(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const configPath = fs.join(ctx.workspaceRoot, '.contractsrc.json');\n\n  const exists = await fs.exists(configPath);\n  if (!exists) {\n    return {\n      category: 'config',\n      name: 'Config Fields',\n      status: 'skip',\n      message: 'Config file does not exist',\n    };\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    const config = JSON.parse(content) as Record<string, unknown>;\n\n    const missingFields: string[] = [];\n\n    // Check for recommended fields\n    if (!config['outputDir']) {\n      missingFields.push('outputDir');\n    }\n    if (!config['conventions']) {\n      missingFields.push('conventions');\n    }\n\n    if (missingFields.length === 0) {\n      return {\n        category: 'config',\n        name: 'Config Fields',\n        status: 'pass',\n        message: 'All recommended fields present',\n      };\n    }\n\n    return {\n      category: 'config',\n      name: 'Config Fields',\n      status: 'warn',\n      message: `Missing recommended fields: ${missingFields.join(', ')}`,\n      fix: {\n        description: 'Add missing fields with defaults',\n        apply: async (): Promise<FixResult> => {\n          try {\n            const defaults = generateContractsrcConfig({\n              workspaceRoot: ctx.workspaceRoot,\n              interactive: false,\n              targets: [],\n            }) as Record<string, unknown>;\n\n            // Merge missing fields\n            for (const field of missingFields) {\n              if (defaults[field] !== undefined) {\n                config[field] = defaults[field];\n              }\n            }\n\n            await fs.writeFile(configPath, formatJson(config));\n            return { success: true, message: 'Added missing fields' };\n          } catch (err) {\n            const m = err instanceof Error ? err.message : String(err);\n            return { success: false, message: `Failed: ${m}` };\n          }\n        },\n      },\n    };\n  } catch {\n    return {\n      category: 'config',\n      name: 'Config Fields',\n      status: 'skip',\n      message: 'Could not parse config',\n    };\n  }\n}\n\n/**\n * Check if versioning configuration is present.\n */\nasync function checkVersioningConfig(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const configPath = fs.join(ctx.workspaceRoot, '.contractsrc.json');\n\n  const exists = await fs.exists(configPath);\n  if (!exists) {\n    return {\n      category: 'config',\n      name: 'Versioning Config',\n      status: 'skip',\n      message: 'Config file does not exist',\n    };\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    const config = JSON.parse(content) as Record<string, unknown>;\n\n    if (config['versioning']) {\n      const versioning = config['versioning'] as Record<string, unknown>;\n      const hasChangesets = versioning['integrateWithChangesets'] === true;\n\n      return {\n        category: 'config',\n        name: 'Versioning Config',\n        status: 'pass',\n        message: hasChangesets\n          ? 'Versioning configured with Changesets integration'\n          : 'Versioning configured',\n      };\n    }\n\n    return {\n      category: 'config',\n      name: 'Versioning Config',\n      status: 'warn',\n      message: 'Versioning configuration not found',\n      details:\n        'Consider adding versioning config for automated version bumps and changelog generation',\n      fix: {\n        description: 'Add versioning configuration with defaults',\n        apply: async (): Promise<FixResult> => {\n          try {\n            config['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,\n            };\n            await fs.writeFile(configPath, formatJson(config));\n            return { success: true, message: 'Added versioning configuration' };\n          } catch (err) {\n            const m = err instanceof Error ? err.message : String(err);\n            return { success: false, message: `Failed: ${m}` };\n          }\n        },\n      },\n    };\n  } catch {\n    return {\n      category: 'config',\n      name: 'Versioning Config',\n      status: 'skip',\n      message: 'Could not parse config',\n    };\n  }\n}\n\n/**\n * Check if hooks configuration is present.\n */\nasync function checkHooksConfig(\n  fs: FsAdapter,\n  ctx: CheckContext\n): Promise<CheckResult> {\n  const configPath = fs.join(ctx.workspaceRoot, '.contractsrc.json');\n\n  const exists = await fs.exists(configPath);\n  if (!exists) {\n    return {\n      category: 'config',\n      name: 'Hooks Config',\n      status: 'skip',\n      message: 'Config file does not exist',\n    };\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    const config = JSON.parse(content) as Record<string, unknown>;\n\n    if (config['hooks']) {\n      const hooks = config['hooks'] as Record<string, unknown>;\n      const hookCount = Object.keys(hooks).length;\n\n      return {\n        category: 'config',\n        name: 'Hooks Config',\n        status: 'pass',\n        message: `${hookCount} git hook(s) configured`,\n      };\n    }\n\n    // Check if husky is installed\n    const huskyPath = fs.join(ctx.workspaceRoot, '.husky');\n    const hasHusky = await fs.exists(huskyPath);\n\n    if (hasHusky) {\n      return {\n        category: 'config',\n        name: 'Hooks Config',\n        status: 'warn',\n        message: 'Husky detected but no hooks configured in .contractsrc.json',\n        details: 'Add hooks config to run contractspec checks from git hooks',\n        fix: {\n          description: 'Add pre-commit hooks configuration',\n          apply: async (): Promise<FixResult> => {\n            try {\n              config['hooks'] = {\n                'pre-commit': [\n                  'contractspec validate **/*.operation.ts',\n                  'contractspec integrity check',\n                ],\n              };\n              await fs.writeFile(configPath, formatJson(config));\n              return { success: true, message: 'Added hooks configuration' };\n            } catch (err) {\n              const m = err instanceof Error ? err.message : String(err);\n              return { success: false, message: `Failed: ${m}` };\n            }\n          },\n        },\n      };\n    }\n\n    return {\n      category: 'config',\n      name: 'Hooks Config',\n      status: 'pass',\n      message: 'No hooks configured (optional)',\n    };\n  } catch {\n    return {\n      category: 'config',\n      name: 'Hooks Config',\n      status: 'skip',\n      message: 'Could not parse config',\n    };\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,24 @@
+import { FsAdapter } from "../../ports/fs.js";
+import { LoggerAdapter } from "../../ports/logger.js";
+import { HookRunOptions, HookRunResult } from "./types.js";
+
+//#region src/services/hooks/hooks-service.d.ts
+
+interface ServiceAdapters {
+  fs: FsAdapter;
+  logger: LoggerAdapter;
+}
+/**
+ * Run a configured git hook.
+ *
+ * Note: Uses node:child_process for compatibility with VSCode (Node.js) and CLI (Bun).
+ * Although Bun shell ($) is preferred for scripts, this shared bundle must support both runtimes.
+ */
+declare function runHook(adapters: ServiceAdapters, options: HookRunOptions): Promise<HookRunResult>;
+/**
+ * Get available hooks from configuration.
+ */
+declare function getAvailableHooks(adapters: ServiceAdapters, workspaceRoot: string): Promise<string[]>;
+//#endregion
+export { getAvailableHooks, runHook };
+//# sourceMappingURL=hooks-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-service.d.ts","names":[],"sources":["../../../src/services/hooks/hooks-service.ts"],"sourcesContent":[],"mappings":";;;;;;UA2BU,eAAA,CAkBA;EAkHY,EAAA,EAnIhB,SAmIgB;UAlIZ;;;;;;;;iBAaY,OAAA,WACV,0BACD,iBACR,QAAQ;;;;iBAkHW,iBAAA,WACV,yCAET"}