@contractspec/bundle.workspace 1.46.1 → 1.47.0

package/dist/services/fix/strategies/implement-skeleton.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"implement-skeleton.mjs","names":[],"sources":["../../../../src/services/fix/strategies/implement-skeleton.ts"],"sourcesContent":["/**\n * Implement skeleton strategy.\n *\n * Creates a minimal spec stub with in_creation stability.\n */\n\nimport type {\n  FixableIssue,\n  FixOptions,\n  FixResult,\n  FixFileChange,\n  SpecGenerationContext,\n} from '../types';\nimport type { FsAdapter } from '../../../ports/fs';\nimport {\n  generateSkeletonOperation,\n  generateSkeletonEvent,\n  generateSkeletonPresentation,\n  generateSkeletonCapability,\n} from '../../../templates/fix';\nimport { resolveOutputPath } from '../path-resolver';\nimport { FIX_STRATEGY_STABILITY } from '../types';\nimport path from 'node:path';\n\n/**\n * Create a skeleton spec for a missing reference.\n */\nexport async function implementSkeletonStrategy(\n  issue: FixableIssue,\n  options: FixOptions,\n  adapters: { fs: FsAdapter }\n): Promise<FixResult> {\n  const { fs } = adapters;\n  const { ref, specType, featureKey } = issue;\n\n  try {\n    // Build generation context\n    const ctx: SpecGenerationContext = {\n      key: ref.key,\n      version: ref.version,\n      specType,\n      stability: FIX_STRATEGY_STABILITY['implement-skeleton'],\n      description: `Skeleton spec for ${ref.key}`,\n      featureKey,\n    };\n\n    // Generate the spec code\n    const code = generateSpecCode(ctx);\n    if (!code) {\n      return {\n        success: false,\n        strategy: 'implement-skeleton',\n        issue,\n        filesChanged: [],\n        error: `Unsupported spec type: ${specType}`,\n      };\n    }\n\n    // Determine output path\n    const filePath = resolveOutputPath(issue, options);\n\n    const filesChanged: FixFileChange[] = [];\n\n    // Write the file (unless dry run)\n    if (!options.dryRun) {\n      // Ensure directory exists\n      const dir = path.dirname(filePath);\n      await fs.mkdir(dir);\n\n      // Write the spec file\n      await fs.writeFile(filePath, code);\n\n      filesChanged.push({\n        path: filePath,\n        action: 'created',\n      });\n    } else {\n      // For dry run, report what would be created\n      filesChanged.push({\n        path: filePath,\n        action: 'created',\n      });\n    }\n\n    return {\n      success: true,\n      strategy: 'implement-skeleton',\n      issue,\n      filesChanged,\n    };\n  } catch (error) {\n    return {\n      success: false,\n      strategy: 'implement-skeleton',\n      issue,\n      filesChanged: [],\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\n/**\n * Generate spec code based on type.\n */\nfunction generateSpecCode(ctx: SpecGenerationContext): string | undefined {\n  switch (ctx.specType) {\n    case 'operation':\n      return generateSkeletonOperation(ctx);\n    case 'event':\n      return generateSkeletonEvent(ctx);\n    case 'presentation':\n      return generateSkeletonPresentation(ctx);\n    case 'capability':\n      return generateSkeletonCapability(ctx);\n    default:\n      return undefined;\n  }\n}\n"],"mappings":";;;;;;;;;;;;AA2BA,eAAsB,0BACpB,OACA,SACA,UACoB;CACpB,MAAM,EAAE,OAAO;CACf,MAAM,EAAE,KAAK,UAAU,eAAe;AAEtC,KAAI;EAYF,MAAM,OAAO,iBAVsB;GACjC,KAAK,IAAI;GACT,SAAS,IAAI;GACb;GACA,WAAW,uBAAuB;GAClC,aAAa,qBAAqB,IAAI;GACtC;GACD,CAGiC;AAClC,MAAI,CAAC,KACH,QAAO;GACL,SAAS;GACT,UAAU;GACV;GACA,cAAc,EAAE;GAChB,OAAO,0BAA0B;GAClC;EAIH,MAAM,WAAW,kBAAkB,OAAO,QAAQ;EAElD,MAAM,eAAgC,EAAE;AAGxC,MAAI,CAAC,QAAQ,QAAQ;GAEnB,MAAM,MAAM,KAAK,QAAQ,SAAS;AAClC,SAAM,GAAG,MAAM,IAAI;AAGnB,SAAM,GAAG,UAAU,UAAU,KAAK;AAElC,gBAAa,KAAK;IAChB,MAAM;IACN,QAAQ;IACT,CAAC;QAGF,cAAa,KAAK;GAChB,MAAM;GACN,QAAQ;GACT,CAAC;AAGJ,SAAO;GACL,SAAS;GACT,UAAU;GACV;GACA;GACD;UACM,OAAO;AACd,SAAO;GACL,SAAS;GACT,UAAU;GACV;GACA,cAAc,EAAE;GAChB,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC9D;;;;;;AAOL,SAAS,iBAAiB,KAAgD;AACxE,SAAQ,IAAI,UAAZ;EACE,KAAK,YACH,QAAO,0BAA0B,IAAI;EACvC,KAAK,QACH,QAAO,sBAAsB,IAAI;EACnC,KAAK,eACH,QAAO,6BAA6B,IAAI;EAC1C,KAAK,aACH,QAAO,2BAA2B,IAAI;EACxC,QACE"}

package/dist/services/fix/strategies/index.d.mts

@@ -0,0 +1,3 @@
+import { removeReferenceStrategy } from "./remove-reference.mjs";
+import { implementSkeletonStrategy } from "./implement-skeleton.mjs";
+import { implementAiStrategy } from "./implement-ai.mjs";

package/dist/services/fix/strategies/remove-reference.d.mts

@@ -0,0 +1,17 @@
+import { FsAdapter } from "../../../ports/fs.mjs";
+import { FixOptions, FixResult, FixableIssue } from "../types.mjs";
+
+//#region src/services/fix/strategies/remove-reference.d.ts
+
+/**
+ * Remove a specific reference from a feature file.
+ *
+ * Parses the feature file content and removes the matching reference
+ * from the appropriate array (operations, events, presentations, etc.).
+ */
+declare function removeReferenceStrategy(issue: FixableIssue, options: FixOptions, adapters: {
+  fs: FsAdapter;
+}): Promise<FixResult>;
+//#endregion
+export { removeReferenceStrategy };
+//# sourceMappingURL=remove-reference.d.mts.map

package/dist/services/fix/strategies/remove-reference.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-reference.d.mts","names":[],"sources":["../../../../src/services/fix/strategies/remove-reference.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;iBAoBsB,uBAAA,QACb,uBACE;MACO;IACf,QAAQ"}

package/dist/services/fix/strategies/remove-reference.mjs

@@ -0,0 +1,98 @@
+//#region src/services/fix/strategies/remove-reference.ts
+/**
+* Remove a specific reference from a feature file.
+*
+* Parses the feature file content and removes the matching reference
+* from the appropriate array (operations, events, presentations, etc.).
+*/
+async function removeReferenceStrategy(issue, options, adapters) {
+	const { fs } = adapters;
+	const { ref, featureFile, specType } = issue;
+	try {
+		const content = await fs.readFile(featureFile);
+		const previousContent = content;
+		const updatedContent = removeRefFromContent(content, ref, specType);
+		if (updatedContent === content) return {
+			success: false,
+			strategy: "remove-reference",
+			issue,
+			filesChanged: [],
+			error: `Could not find reference ${ref.key}.v${ref.version} in ${featureFile}`
+		};
+		const filesChanged = [];
+		if (!options.dryRun) {
+			await fs.writeFile(featureFile, updatedContent);
+			filesChanged.push({
+				path: featureFile,
+				action: "modified",
+				previousContent
+			});
+		} else filesChanged.push({
+			path: featureFile,
+			action: "modified"
+		});
+		return {
+			success: true,
+			strategy: "remove-reference",
+			issue,
+			filesChanged
+		};
+	} catch (error) {
+		return {
+			success: false,
+			strategy: "remove-reference",
+			issue,
+			filesChanged: [],
+			error: error instanceof Error ? error.message : String(error)
+		};
+	}
+}
+/**
+* Remove a reference from feature file content.
+*
+* Handles different array formats:
+* - operations: [{ key: 'x', version: 'y' }]
+* - events: [{ key: 'x', version: 'y' }]
+* - presentations: [{ key: 'x', version: 'y' }]
+*/
+function removeRefFromContent(content, ref, specType) {
+	if (!getArrayName(specType)) return content;
+	const keyEscaped = escapeRegex(ref.key);
+	const versionEscaped = escapeRegex(ref.version);
+	const patterns = [new RegExp(`\\{\\s*key:\\s*['"]${keyEscaped}['"],\\s*version:\\s*['"]${versionEscaped}['"]\\s*\\},?\\s*`, "g"), new RegExp(`\\{\\s*version:\\s*['"]${versionEscaped}['"],\\s*key:\\s*['"]${keyEscaped}['"]\\s*\\},?\\s*`, "g")];
+	let result = content;
+	for (const pattern of patterns) result = result.replace(pattern, "");
+	result = cleanupTrailingCommas(result);
+	return result;
+}
+/**
+* Get the array name in a feature file for a spec type.
+*/
+function getArrayName(specType) {
+	return {
+		operation: "operations",
+		event: "events",
+		presentation: "presentations",
+		experiment: "experiments",
+		capability: "capabilities",
+		workflow: "workflows",
+		"data-view": "dataViews",
+		form: "forms"
+	}[specType];
+}
+/**
+* Escape special regex characters in a string.
+*/
+function escapeRegex(str) {
+	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+* Clean up trailing commas that may be left after removing elements.
+*/
+function cleanupTrailingCommas(content) {
+	return content.replace(/,(\s*)\]/g, "$1]");
+}
+
+//#endregion
+export { removeReferenceStrategy };
+//# sourceMappingURL=remove-reference.mjs.map

package/dist/services/fix/strategies/remove-reference.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-reference.mjs","names":[],"sources":["../../../../src/services/fix/strategies/remove-reference.ts"],"sourcesContent":["/**\n * Remove reference strategy.\n *\n * Removes a broken reference from a feature file.\n */\n\nimport type {\n  FixableIssue,\n  FixOptions,\n  FixResult,\n  FixFileChange,\n} from '../types';\nimport type { FsAdapter } from '../../../ports/fs';\n\n/**\n * Remove a specific reference from a feature file.\n *\n * Parses the feature file content and removes the matching reference\n * from the appropriate array (operations, events, presentations, etc.).\n */\nexport async function removeReferenceStrategy(\n  issue: FixableIssue,\n  options: FixOptions,\n  adapters: { fs: FsAdapter }\n): Promise<FixResult> {\n  const { fs } = adapters;\n  const { ref, featureFile, specType } = issue;\n\n  try {\n    // Read the feature file\n    const content = await fs.readFile(featureFile);\n    const previousContent = content;\n\n    // Find and remove the reference\n    const updatedContent = removeRefFromContent(content, ref, specType);\n\n    if (updatedContent === content) {\n      return {\n        success: false,\n        strategy: 'remove-reference',\n        issue,\n        filesChanged: [],\n        error: `Could not find reference ${ref.key}.v${ref.version} in ${featureFile}`,\n      };\n    }\n\n    const filesChanged: FixFileChange[] = [];\n\n    // Apply the change (unless dry run)\n    if (!options.dryRun) {\n      await fs.writeFile(featureFile, updatedContent);\n      filesChanged.push({\n        path: featureFile,\n        action: 'modified',\n        previousContent,\n      });\n    } else {\n      // For dry run, still report what would change\n      filesChanged.push({\n        path: featureFile,\n        action: 'modified',\n      });\n    }\n\n    return {\n      success: true,\n      strategy: 'remove-reference',\n      issue,\n      filesChanged,\n    };\n  } catch (error) {\n    return {\n      success: false,\n      strategy: 'remove-reference',\n      issue,\n      filesChanged: [],\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\n/**\n * Remove a reference from feature file content.\n *\n * Handles different array formats:\n * - operations: [{ key: 'x', version: 'y' }]\n * - events: [{ key: 'x', version: 'y' }]\n * - presentations: [{ key: 'x', version: 'y' }]\n */\nfunction removeRefFromContent(\n  content: string,\n  ref: { key: string; version: string },\n  specType: string\n): string {\n  // Map spec type to array name in feature file\n  const arrayName = getArrayName(specType);\n  if (!arrayName) {\n    return content;\n  }\n\n  // Create regex pattern to match the reference object\n  // Matches: { key: 'key', version: 'version' } with optional trailing comma\n  const keyEscaped = escapeRegex(ref.key);\n  const versionEscaped = escapeRegex(ref.version);\n\n  // Pattern matches the object with key and version in any order\n  // and handles both single and double quotes\n  const patterns = [\n    // key first, then version\n    new RegExp(\n      `\\\\{\\\\s*key:\\\\s*['\"]${keyEscaped}['\"],\\\\s*version:\\\\s*['\"]${versionEscaped}['\"]\\\\s*\\\\},?\\\\s*`,\n      'g'\n    ),\n    // version first, then key\n    new RegExp(\n      `\\\\{\\\\s*version:\\\\s*['\"]${versionEscaped}['\"],\\\\s*key:\\\\s*['\"]${keyEscaped}['\"]\\\\s*\\\\},?\\\\s*`,\n      'g'\n    ),\n  ];\n\n  let result = content;\n  for (const pattern of patterns) {\n    result = result.replace(pattern, '');\n  }\n\n  // Clean up any trailing commas left after removal\n  result = cleanupTrailingCommas(result);\n\n  return result;\n}\n\n/**\n * Get the array name in a feature file for a spec type.\n */\nfunction getArrayName(specType: string): string | undefined {\n  const mapping: Record<string, string> = {\n    operation: 'operations',\n    event: 'events',\n    presentation: 'presentations',\n    experiment: 'experiments',\n    capability: 'capabilities',\n    workflow: 'workflows',\n    'data-view': 'dataViews',\n    form: 'forms',\n  };\n\n  return mapping[specType];\n}\n\n/**\n * Escape special regex characters in a string.\n */\nfunction escapeRegex(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/**\n * Clean up trailing commas that may be left after removing elements.\n */\nfunction cleanupTrailingCommas(content: string): string {\n  // Remove trailing comma before closing bracket\n  return content.replace(/,(\\s*)\\]/g, '$1]');\n}\n"],"mappings":";;;;;;;AAoBA,eAAsB,wBACpB,OACA,SACA,UACoB;CACpB,MAAM,EAAE,OAAO;CACf,MAAM,EAAE,KAAK,aAAa,aAAa;AAEvC,KAAI;EAEF,MAAM,UAAU,MAAM,GAAG,SAAS,YAAY;EAC9C,MAAM,kBAAkB;EAGxB,MAAM,iBAAiB,qBAAqB,SAAS,KAAK,SAAS;AAEnE,MAAI,mBAAmB,QACrB,QAAO;GACL,SAAS;GACT,UAAU;GACV;GACA,cAAc,EAAE;GAChB,OAAO,4BAA4B,IAAI,IAAI,IAAI,IAAI,QAAQ,MAAM;GAClE;EAGH,MAAM,eAAgC,EAAE;AAGxC,MAAI,CAAC,QAAQ,QAAQ;AACnB,SAAM,GAAG,UAAU,aAAa,eAAe;AAC/C,gBAAa,KAAK;IAChB,MAAM;IACN,QAAQ;IACR;IACD,CAAC;QAGF,cAAa,KAAK;GAChB,MAAM;GACN,QAAQ;GACT,CAAC;AAGJ,SAAO;GACL,SAAS;GACT,UAAU;GACV;GACA;GACD;UACM,OAAO;AACd,SAAO;GACL,SAAS;GACT,UAAU;GACV;GACA,cAAc,EAAE;GAChB,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC9D;;;;;;;;;;;AAYL,SAAS,qBACP,SACA,KACA,UACQ;AAGR,KAAI,CADc,aAAa,SAAS,CAEtC,QAAO;CAKT,MAAM,aAAa,YAAY,IAAI,IAAI;CACvC,MAAM,iBAAiB,YAAY,IAAI,QAAQ;CAI/C,MAAM,WAAW,CAEf,IAAI,OACF,sBAAsB,WAAW,2BAA2B,eAAe,oBAC3E,IACD,EAED,IAAI,OACF,0BAA0B,eAAe,uBAAuB,WAAW,oBAC3E,IACD,CACF;CAED,IAAI,SAAS;AACb,MAAK,MAAM,WAAW,SACpB,UAAS,OAAO,QAAQ,SAAS,GAAG;AAItC,UAAS,sBAAsB,OAAO;AAEtC,QAAO;;;;;AAMT,SAAS,aAAa,UAAsC;AAY1D,QAXwC;EACtC,WAAW;EACX,OAAO;EACP,cAAc;EACd,YAAY;EACZ,YAAY;EACZ,UAAU;EACV,aAAa;EACb,MAAM;EACP,CAEc;;;;;AAMjB,SAAS,YAAY,KAAqB;AACxC,QAAO,IAAI,QAAQ,uBAAuB,OAAO;;;;;AAMnD,SAAS,sBAAsB,SAAyB;AAEtD,QAAO,QAAQ,QAAQ,aAAa,MAAM"}

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

@@ -0,0 +1,207 @@
+import { IntegrityIssue } from "../integrity.mjs";
+import { AnalyzedSpecType, RefInfo } from "@contractspec/module.workspace";
+import { Stability } from "@contractspec/lib.contracts";
+
+//#region src/services/fix/types.d.ts
+
+/**
+ * Available fix strategies.
+ */
+type FixStrategyType = 'remove-reference' | 'implement-skeleton' | 'implement-ai';
+/**
+ * Human-readable labels for fix strategies.
+ */
+declare const FIX_STRATEGY_LABELS: Record<FixStrategyType, string>;
+/**
+ * Stability level for each fix strategy when creating specs.
+ */
+declare const FIX_STRATEGY_STABILITY: Record<Exclude<FixStrategyType, 'remove-reference'>, Stability>;
+/**
+ * A fixable issue with context for fix generation.
+ */
+interface FixableIssue {
+  /** Original integrity issue. */
+  issue: IntegrityIssue;
+  /** Reference info (key, version). */
+  ref: RefInfo;
+  /** Spec type to create. */
+  specType: AnalyzedSpecType;
+  /** Feature file containing the broken reference. */
+  featureFile: string;
+  /** Feature key that has the broken reference. */
+  featureKey: string;
+  /** Available strategies for this issue. */
+  availableStrategies: FixStrategyType[];
+  /** Deprecated: kept for compatibility if needed, or remove if unused */
+  strategies: unknown[];
+}
+/**
+ * File change result from applying a fix.
+ */
+interface FixFileChange {
+  /** File path. */
+  path: string;
+  /** Action taken. */
+  action: 'created' | 'modified' | 'deleted';
+  /** Previous content (for undo). */
+  previousContent?: string;
+}
+/**
+ * Result of applying a single fix.
+ */
+interface FixResult {
+  /** Whether the fix succeeded. */
+  success: boolean;
+  /** Strategy used. */
+  strategy: FixStrategyType;
+  /** Original issue that was fixed. */
+  issue: FixableIssue;
+  /** Files that were changed. */
+  filesChanged: FixFileChange[];
+  /** Message describing the outcome. */
+  message?: string;
+  /** Error message if fix failed. */
+  error?: string;
+}
+/**
+ * Result of applying multiple fixes.
+ */
+interface BatchFixResult {
+  /** Total number of issues processed. */
+  total: number;
+  /** Number of successful fixes. */
+  succeeded: number;
+  /** Number of failed fixes. */
+  failed: number;
+  /** Individual fix results. */
+  results: FixResult[];
+}
+/**
+ * AI configuration for implement-ai strategy.
+ */
+interface FixAIConfig {
+  /** AI provider to use. */
+  provider: 'claude' | 'openai' | 'ollama' | 'custom';
+  /** Model to use. */
+  model?: string;
+  /** Custom endpoint. */
+  endpoint?: string;
+  /** API key (if not using env var). */
+  apiKey?: string;
+}
+/**
+ * Options for the fix service.
+ */
+interface FixOptions {
+  /** Working directory. */
+  workspaceRoot: string;
+  /** Fix strategy to use. */
+  strategy: FixStrategyType;
+  /** Dry run mode (preview changes without applying). */
+  dryRun?: boolean;
+  /** Interactive mode for confirmations. */
+  interactive?: boolean;
+  /** AI config for implement-ai strategy. */
+  aiConfig?: FixAIConfig;
+  /** Output directory for new specs (optional, uses config default). */
+  outputDir?: string;
+  /** Format files after creation. */
+  format?: boolean;
+}
+/**
+ * Request to fix multiple issues.
+ */
+interface BatchFixRequest {
+  /** Issues to fix. */
+  issues: FixableIssue[];
+  /** Options for fixing. */
+  options: FixOptions;
+}
+/**
+ * Context for spec generation.
+ */
+interface SpecGenerationContext {
+  /** Spec key (e.g., "docs.search"). */
+  key: string;
+  /** Spec version (e.g., "1.0.0"). */
+  version: string;
+  /** Spec type. */
+  specType: AnalyzedSpecType;
+  /** Stability level. */
+  stability: Stability;
+  /** Description (may be inferred from key). */
+  description?: string;
+  /** Feature key that references this spec. */
+  featureKey?: string;
+  /** Additional enrichment from AI or user. */
+  enrichment?: {
+    goal?: string;
+    context?: string;
+    owners?: string[];
+    tags?: string[];
+  };
+}
+/**
+ * Types of fix links for external surfaces.
+ */
+type FixLinkType = 'cli' | 'vscode' | 'github-issue';
+/**
+ * A fix link for external surfaces (PR comments, etc.).
+ */
+interface FixLink {
+  /** Type of link. */
+  type: FixLinkType;
+  /** Display label. */
+  label: string;
+  /** Link value (command or URL). */
+  value: string;
+}
+/**
+ * Options for generating fix links.
+ */
+interface FixLinkOptions {
+  /** GitHub repository (owner/repo). */
+  repository?: string;
+  /** Base branch for issues. */
+  baseBranch?: string;
+  /** Include CLI commands. */
+  includeCli?: boolean;
+  /** Include VSCode deep links. */
+  includeVscode?: boolean;
+  /** Include GitHub issue links. */
+  includeGithubIssue?: boolean;
+}
+/**
+ * Extended CI issue with fix links.
+ */
+interface CIIssueWithFixLinks {
+  /** Original issue properties. */
+  ruleId: string;
+  severity: 'error' | 'warning' | 'note';
+  message: string;
+  category: string;
+  file?: string;
+  line?: number;
+  column?: number;
+  endLine?: number;
+  endColumn?: number;
+  context?: Record<string, unknown>;
+  /** Fix links for this issue. */
+  fixLinks?: FixLink[];
+}
+/**
+ * Interface for a fix strategy implementation.
+ */
+interface FixStrategy {
+  /**
+   * type of the strategy
+   */
+  readonly type: FixStrategyType;
+  /**
+   * Apply the fix.
+   */
+  fix(issue: FixableIssue, options: FixOptions): Promise<FixResult>;
+}
+//#endregion
+export { BatchFixRequest, BatchFixResult, CIIssueWithFixLinks, FIX_STRATEGY_LABELS, FIX_STRATEGY_STABILITY, FixAIConfig, FixFileChange, FixLink, FixLinkOptions, FixLinkType, FixOptions, FixResult, FixStrategy, FixStrategyType, FixableIssue, SpecGenerationContext };
+//# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/services/fix/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AA8BqC,KAjBzB,eAAA,GAiByB,kBAAA,GAAA,oBAAA,GAAA,cAAA;;AAWrC;;AAIO,cAxBM,mBAwBN,EAxB2B,MAwB3B,CAxBkC,eAwBlC,EAAA,MAAA,CAAA;;;;AAgBU,cA/BJ,sBA+BiB,EA/BO,MA+BP,CA9B5B,OA8B4B,CA9BpB,eA8BoB,EAAA,kBAAA,CAAA,EA7B5B,SA6B4B,CAAA;AAY9B;;;AAQgB,UAxCC,YAAA,CAwCD;EAAa;EAUZ,KAAA,EAhDR,cAgDsB;EAcd;EAcA,GAAA,EA1EV,OA0EU;EAoBA;EAUA,QAAA,EAtGL,gBAsG0B;EAyB1B;EAKK,WAAO,EAAA,MAAA;EAYP;EAgBA,UAAA,EAAA,MAAA;EAmBA;EAIA,mBAAA,EAjLM,eAiLN,EAAA;EAKJ;EAAuB,UAAA,EAAA,OAAA,EAAA;;;;;UA9KnB,aAAA;;;;;;;;;;;UAYA,SAAA;;;;YAIL;;SAEH;;gBAEO;;;;;;;;;UAUC,cAAA;;;;;;;;WAQN;;;;;UAMM,WAAA;;;;;;;;;;;;;UAcA,UAAA;;;;YAIL;;;;;;aAMC;;;;;;;;;UAUI,eAAA;;UAEP;;WAEC;;;;;UAMM,qBAAA;;;;;;YAML;;aAEC;;;;;;;;;;;;;;;;KAiBD,WAAA;;;;UAKK,OAAA;;QAET;;;;;;;;;UAUS,cAAA;;;;;;;;;;;;;;;UAgBA,mBAAA;;;;;;;;;;;YAWL;;aAEC;;;;;UAMI,WAAA;;;;iBAIA;;;;aAKJ,uBAAuB,aAAa,QAAQ"}

package/dist/services/fix/types.mjs

@@ -0,0 +1,20 @@
+//#region src/services/fix/types.ts
+/**
+* Human-readable labels for fix strategies.
+*/
+const FIX_STRATEGY_LABELS = {
+	"remove-reference": "Remove broken reference from feature",
+	"implement-skeleton": "Create skeleton spec (in_creation)",
+	"implement-ai": "Create spec with AI assistance (experimental)"
+};
+/**
+* Stability level for each fix strategy when creating specs.
+*/
+const FIX_STRATEGY_STABILITY = {
+	"implement-skeleton": "in_creation",
+	"implement-ai": "experimental"
+};
+
+//#endregion
+export { FIX_STRATEGY_LABELS, FIX_STRATEGY_STABILITY };
+//# sourceMappingURL=types.mjs.map

package/dist/services/fix/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../../../src/services/fix/types.ts"],"sourcesContent":["/**\n * Fix service types.\n *\n * Types for fixing integrity issues found by CI checks.\n */\n\nimport type { AnalyzedSpecType, RefInfo } from '@contractspec/module.workspace';\nimport type { Stability } from '@contractspec/lib.contracts';\nimport type { IntegrityIssue } from '../integrity';\n\n/**\n * Available fix strategies.\n */\nexport type FixStrategyType =\n  | 'remove-reference'\n  | 'implement-skeleton'\n  | 'implement-ai';\n\n/**\n * Human-readable labels for fix strategies.\n */\nexport const FIX_STRATEGY_LABELS: Record<FixStrategyType, string> = {\n  'remove-reference': 'Remove broken reference from feature',\n  'implement-skeleton': 'Create skeleton spec (in_creation)',\n  'implement-ai': 'Create spec with AI assistance (experimental)',\n};\n\n/**\n * Stability level for each fix strategy when creating specs.\n */\nexport const FIX_STRATEGY_STABILITY: Record<\n  Exclude<FixStrategyType, 'remove-reference'>,\n  Stability\n> = {\n  'implement-skeleton': 'in_creation',\n  'implement-ai': 'experimental',\n};\n\n/**\n * A fixable issue with context for fix generation.\n */\nexport interface FixableIssue {\n  /** Original integrity issue. */\n  issue: IntegrityIssue;\n  /** Reference info (key, version). */\n  ref: RefInfo;\n  /** Spec type to create. */\n  specType: AnalyzedSpecType;\n  /** Feature file containing the broken reference. */\n  featureFile: string;\n  /** Feature key that has the broken reference. */\n  featureKey: string;\n  /** Available strategies for this issue. */\n  availableStrategies: FixStrategyType[];\n  /** Deprecated: kept for compatibility if needed, or remove if unused */\n  strategies: unknown[];\n}\n\n/**\n * File change result from applying a fix.\n */\nexport interface FixFileChange {\n  /** File path. */\n  path: string;\n  /** Action taken. */\n  action: 'created' | 'modified' | 'deleted';\n  /** Previous content (for undo). */\n  previousContent?: string;\n}\n\n/**\n * Result of applying a single fix.\n */\nexport interface FixResult {\n  /** Whether the fix succeeded. */\n  success: boolean;\n  /** Strategy used. */\n  strategy: FixStrategyType;\n  /** Original issue that was fixed. */\n  issue: FixableIssue;\n  /** Files that were changed. */\n  filesChanged: FixFileChange[];\n  /** Message describing the outcome. */\n  message?: string;\n  /** Error message if fix failed. */\n  error?: string;\n}\n\n/**\n * Result of applying multiple fixes.\n */\nexport interface BatchFixResult {\n  /** Total number of issues processed. */\n  total: number;\n  /** Number of successful fixes. */\n  succeeded: number;\n  /** Number of failed fixes. */\n  failed: number;\n  /** Individual fix results. */\n  results: FixResult[];\n}\n\n/**\n * AI configuration for implement-ai strategy.\n */\nexport interface FixAIConfig {\n  /** AI provider to use. */\n  provider: 'claude' | 'openai' | 'ollama' | 'custom';\n  /** Model to use. */\n  model?: string;\n  /** Custom endpoint. */\n  endpoint?: string;\n  /** API key (if not using env var). */\n  apiKey?: string;\n}\n\n/**\n * Options for the fix service.\n */\nexport interface FixOptions {\n  /** Working directory. */\n  workspaceRoot: string;\n  /** Fix strategy to use. */\n  strategy: FixStrategyType;\n  /** Dry run mode (preview changes without applying). */\n  dryRun?: boolean;\n  /** Interactive mode for confirmations. */\n  interactive?: boolean;\n  /** AI config for implement-ai strategy. */\n  aiConfig?: FixAIConfig;\n  /** Output directory for new specs (optional, uses config default). */\n  outputDir?: string;\n  /** Format files after creation. */\n  format?: boolean;\n}\n\n/**\n * Request to fix multiple issues.\n */\nexport interface BatchFixRequest {\n  /** Issues to fix. */\n  issues: FixableIssue[];\n  /** Options for fixing. */\n  options: FixOptions;\n}\n\n/**\n * Context for spec generation.\n */\nexport interface SpecGenerationContext {\n  /** Spec key (e.g., \"docs.search\"). */\n  key: string;\n  /** Spec version (e.g., \"1.0.0\"). */\n  version: string;\n  /** Spec type. */\n  specType: AnalyzedSpecType;\n  /** Stability level. */\n  stability: Stability;\n  /** Description (may be inferred from key). */\n  description?: string;\n  /** Feature key that references this spec. */\n  featureKey?: string;\n  /** Additional enrichment from AI or user. */\n  enrichment?: {\n    goal?: string;\n    context?: string;\n    owners?: string[];\n    tags?: string[];\n  };\n}\n\n/**\n * Types of fix links for external surfaces.\n */\nexport type FixLinkType = 'cli' | 'vscode' | 'github-issue';\n\n/**\n * A fix link for external surfaces (PR comments, etc.).\n */\nexport interface FixLink {\n  /** Type of link. */\n  type: FixLinkType;\n  /** Display label. */\n  label: string;\n  /** Link value (command or URL). */\n  value: string;\n}\n\n/**\n * Options for generating fix links.\n */\nexport interface FixLinkOptions {\n  /** GitHub repository (owner/repo). */\n  repository?: string;\n  /** Base branch for issues. */\n  baseBranch?: string;\n  /** Include CLI commands. */\n  includeCli?: boolean;\n  /** Include VSCode deep links. */\n  includeVscode?: boolean;\n  /** Include GitHub issue links. */\n  includeGithubIssue?: boolean;\n}\n\n/**\n * Extended CI issue with fix links.\n */\nexport interface CIIssueWithFixLinks {\n  /** Original issue properties. */\n  ruleId: string;\n  severity: 'error' | 'warning' | 'note';\n  message: string;\n  category: string;\n  file?: string;\n  line?: number;\n  column?: number;\n  endLine?: number;\n  endColumn?: number;\n  context?: Record<string, unknown>;\n  /** Fix links for this issue. */\n  fixLinks?: FixLink[];\n}\n\n/**\n * Interface for a fix strategy implementation.\n */\nexport interface FixStrategy {\n  /**\n   * type of the strategy\n   */\n  readonly type: FixStrategyType;\n\n  /**\n   * Apply the fix.\n   */\n  fix(issue: FixableIssue, options: FixOptions): Promise<FixResult>;\n}\n"],"mappings":";;;;AAqBA,MAAa,sBAAuD;CAClE,oBAAoB;CACpB,sBAAsB;CACtB,gBAAgB;CACjB;;;;AAKD,MAAa,yBAGT;CACF,sBAAsB;CACtB,gBAAgB;CACjB"}

package/dist/services/formatter.d.mts

@@ -0,0 +1,15 @@
+//#region src/services/formatter.d.ts
+/**
+ * Formatter service.
+ */
+interface FormatterOptions {
+  type?: string;
+  cwd?: string;
+}
+/**
+ * Format files using the configured formatter (defaulting to prettier).
+ */
+declare function formatFiles(files: string[], _configResolver?: unknown, options?: FormatterOptions): Promise<void>;
+//#endregion
+export { FormatterOptions, formatFiles };
+//# sourceMappingURL=formatter.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.mts","names":[],"sources":["../../src/services/formatter.ts"],"sourcesContent":[],"mappings":";;AASA;AAQA;UARiB,gBAAA;;;;;;;iBAQK,WAAA,uDAGX,mBACR"}

package/dist/services/formatter.mjs

@@ -0,0 +1,26 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+
+//#region src/services/formatter.ts
+/**
+* Formatter service.
+*/
+const execAsync = promisify(exec);
+/**
+* Format files using the configured formatter (defaulting to prettier).
+*/
+async function formatFiles(files, _configResolver, options = {}) {
+	if (files.length === 0) return;
+	const cwd = options.cwd ?? process.cwd();
+	const FILE_CHUNK_SIZE = 50;
+	for (let i = 0; i < files.length; i += FILE_CHUNK_SIZE) {
+		const fileArgs = files.slice(i, i + FILE_CHUNK_SIZE).map((f) => `"${f}"`).join(" ");
+		try {
+			await execAsync(`npx prettier --write ${fileArgs}`, { cwd });
+		} catch (_error) {}
+	}
+}
+
+//#endregion
+export { formatFiles };
+//# sourceMappingURL=formatter.mjs.map

package/dist/services/formatter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.mjs","names":[],"sources":["../../src/services/formatter.ts"],"sourcesContent":["/**\n * Formatter service.\n */\n\nimport { exec } from 'node:child_process';\nimport { promisify } from 'node:util';\n\nconst execAsync = promisify(exec);\n\nexport interface FormatterOptions {\n  type?: string;\n  cwd?: string;\n}\n\n/**\n * Format files using the configured formatter (defaulting to prettier).\n */\nexport async function formatFiles(\n  files: string[],\n  _configResolver?: unknown,\n  options: FormatterOptions = {}\n): Promise<void> {\n  if (files.length === 0) return;\n\n  const cwd = options.cwd ?? process.cwd();\n\n  // Basic implementation: run prettier on the files\n  // We assume prettier is available in the project\n\n  // Group files by chunks to avoid command line length limits\n  const FILE_CHUNK_SIZE = 50;\n\n  for (let i = 0; i < files.length; i += FILE_CHUNK_SIZE) {\n    const chunk = files.slice(i, i + FILE_CHUNK_SIZE);\n    // Quote paths\n    const fileArgs = chunk.map((f) => `\"${f}\"`).join(' ');\n\n    try {\n      // Try npx prettier first\n      await execAsync(`npx prettier --write ${fileArgs}`, { cwd });\n    } catch (_error) {\n      // Fallback or ignore\n      // console.warn('Prettier formatting failed:', error);\n    }\n  }\n}\n"],"mappings":";;;;;;;AAOA,MAAM,YAAY,UAAU,KAAK;;;;AAUjC,eAAsB,YACpB,OACA,iBACA,UAA4B,EAAE,EACf;AACf,KAAI,MAAM,WAAW,EAAG;CAExB,MAAM,MAAM,QAAQ,OAAO,QAAQ,KAAK;CAMxC,MAAM,kBAAkB;AAExB,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,iBAAiB;EAGtD,MAAM,WAFQ,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAE1B,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,IAAI;AAErD,MAAI;AAEF,SAAM,UAAU,wBAAwB,YAAY,EAAE,KAAK,CAAC;WACrD,QAAQ"}

package/dist/services/gap.d.mts

@@ -0,0 +1,18 @@
+import { FsAdapter } from "../ports/fs.mjs";
+
+//#region src/services/gap.d.ts
+interface GapAnalysisResult {
+  hasContracts: boolean;
+  hasGenerated: boolean;
+  missingDocs: string[];
+  missingIndex: boolean;
+  missingRegistry: boolean;
+  totalSpecs: number;
+}
+declare function analyzeGap(adapters: {
+  fs: FsAdapter;
+  scan?: any;
+}, cwd: string): Promise<GapAnalysisResult>;
+//#endregion
+export { GapAnalysisResult, analyzeGap };
+//# sourceMappingURL=gap.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gap.d.mts","names":[],"sources":["../../src/services/gap.ts"],"sourcesContent":[],"mappings":";;;UAIiB,iBAAA;;EAAA,YAAA,EAAA,OAAiB;EASZ,WAAA,EAAU,MAAA,EAAA;EAEd,YAAA,EAAA,OAAA;EAEP,eAAA,EAAA,OAAA;EAAR,UAAA,EAAA,MAAA;;iBAJmB,UAAA;MAEJ;;iBAEf,QAAQ"}

package/dist/services/gap.mjs

@@ -0,0 +1,44 @@
+import { listSpecs } from "./list.mjs";
+import path from "path";
+
+//#region src/services/gap.ts
+async function analyzeGap(adapters, cwd) {
+	const contractsDir = path.join(cwd, "contracts");
+	const generatedDir = path.join(cwd, "generated");
+	const docsDir = path.join(generatedDir, "docs");
+	const hasContracts = await adapters.fs.exists(contractsDir);
+	const hasGenerated = await adapters.fs.exists(generatedDir);
+	if (!hasContracts) return {
+		hasContracts: false,
+		hasGenerated,
+		missingDocs: [],
+		missingIndex: false,
+		missingRegistry: false,
+		totalSpecs: 0
+	};
+	const specs = await listSpecs(adapters, { pattern: "contracts/**/*.ts" });
+	const missingDocs = [];
+	if (hasGenerated) for (const spec of specs) {
+		const id = spec.key || path.basename(spec.filePath, ".ts");
+		const docFile = path.join(docsDir, `${id}.md`);
+		if (!await adapters.fs.exists(docFile)) missingDocs.push(id);
+	}
+	else if (specs.length > 0) for (const spec of specs) {
+		const id = spec.key || path.basename(spec.filePath, ".ts");
+		missingDocs.push(id);
+	}
+	const indexFile = path.join(contractsDir, "index.ts");
+	const registryFile = path.join(contractsDir, "registry.ts");
+	return {
+		hasContracts: true,
+		hasGenerated,
+		missingDocs,
+		missingIndex: specs.length > 0 && !await adapters.fs.exists(indexFile),
+		missingRegistry: specs.length > 0 && !await adapters.fs.exists(registryFile),
+		totalSpecs: specs.length
+	};
+}
+
+//#endregion
+export { analyzeGap };
+//# sourceMappingURL=gap.mjs.map

package/dist/services/gap.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gap.mjs","names":[],"sources":["../../src/services/gap.ts"],"sourcesContent":["import path from 'path';\nimport type { FsAdapter } from '../ports/fs';\nimport { listSpecs } from './list';\n\nexport interface GapAnalysisResult {\n  hasContracts: boolean;\n  hasGenerated: boolean;\n  missingDocs: string[];\n  missingIndex: boolean;\n  missingRegistry: boolean;\n  totalSpecs: number;\n}\n\nexport async function analyzeGap(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  adapters: { fs: FsAdapter; scan?: any },\n  cwd: string\n): Promise<GapAnalysisResult> {\n  const contractsDir = path.join(cwd, 'contracts');\n  const generatedDir = path.join(cwd, 'generated');\n  const docsDir = path.join(generatedDir, 'docs');\n\n  const hasContracts = await adapters.fs.exists(contractsDir);\n  const hasGenerated = await adapters.fs.exists(generatedDir);\n\n  if (!hasContracts) {\n    return {\n      hasContracts: false,\n      hasGenerated,\n      missingDocs: [],\n      missingIndex: false,\n      missingRegistry: false,\n      totalSpecs: 0,\n    };\n  }\n\n  const specs = await listSpecs(adapters, { pattern: 'contracts/**/*.ts' });\n  const missingDocs: string[] = [];\n\n  if (hasGenerated) {\n    for (const spec of specs) {\n      // Logic from CLI: ID is usually file name relative or spec key.\n      const id = spec.key || path.basename(spec.filePath, '.ts');\n      const docFile = path.join(docsDir, `${id}.md`);\n\n      if (!(await adapters.fs.exists(docFile))) {\n        missingDocs.push(id);\n      }\n    }\n  } else if (specs.length > 0) {\n    // If generated dir missing, all docs are missing\n    for (const spec of specs) {\n      const id = spec.key || path.basename(spec.filePath, '.ts');\n      missingDocs.push(id);\n    }\n  }\n\n  const indexFile = path.join(contractsDir, 'index.ts');\n  const registryFile = path.join(contractsDir, 'registry.ts');\n\n  const missingIndex =\n    specs.length > 0 && !(await adapters.fs.exists(indexFile));\n  const missingRegistry =\n    specs.length > 0 && !(await adapters.fs.exists(registryFile));\n\n  return {\n    hasContracts: true,\n    hasGenerated,\n    missingDocs,\n    missingIndex,\n    missingRegistry,\n    totalSpecs: specs.length,\n  };\n}\n"],"mappings":";;;;AAaA,eAAsB,WAEpB,UACA,KAC4B;CAC5B,MAAM,eAAe,KAAK,KAAK,KAAK,YAAY;CAChD,MAAM,eAAe,KAAK,KAAK,KAAK,YAAY;CAChD,MAAM,UAAU,KAAK,KAAK,cAAc,OAAO;CAE/C,MAAM,eAAe,MAAM,SAAS,GAAG,OAAO,aAAa;CAC3D,MAAM,eAAe,MAAM,SAAS,GAAG,OAAO,aAAa;AAE3D,KAAI,CAAC,aACH,QAAO;EACL,cAAc;EACd;EACA,aAAa,EAAE;EACf,cAAc;EACd,iBAAiB;EACjB,YAAY;EACb;CAGH,MAAM,QAAQ,MAAM,UAAU,UAAU,EAAE,SAAS,qBAAqB,CAAC;CACzE,MAAM,cAAwB,EAAE;AAEhC,KAAI,aACF,MAAK,MAAM,QAAQ,OAAO;EAExB,MAAM,KAAK,KAAK,OAAO,KAAK,SAAS,KAAK,UAAU,MAAM;EAC1D,MAAM,UAAU,KAAK,KAAK,SAAS,GAAG,GAAG,KAAK;AAE9C,MAAI,CAAE,MAAM,SAAS,GAAG,OAAO,QAAQ,CACrC,aAAY,KAAK,GAAG;;UAGf,MAAM,SAAS,EAExB,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,KAAK,KAAK,OAAO,KAAK,SAAS,KAAK,UAAU,MAAM;AAC1D,cAAY,KAAK,GAAG;;CAIxB,MAAM,YAAY,KAAK,KAAK,cAAc,WAAW;CACrD,MAAM,eAAe,KAAK,KAAK,cAAc,cAAc;AAO3D,QAAO;EACL,cAAc;EACd;EACA;EACA,cARA,MAAM,SAAS,KAAK,CAAE,MAAM,SAAS,GAAG,OAAO,UAAU;EASzD,iBAPA,MAAM,SAAS,KAAK,CAAE,MAAM,SAAS,GAAG,OAAO,aAAa;EAQ5D,YAAY,MAAM;EACnB"}

package/dist/services/generate-artifacts.d.mts

@@ -0,0 +1,11 @@
+import { WorkspaceAdapters } from "../ports/logger.mjs";
+
+//#region src/services/generate-artifacts.d.ts
+interface GenerateArtifactsResult {
+  specsCount: number;
+  docsCount: number;
+}
+declare function generateArtifacts(adapters: WorkspaceAdapters, contractsDir: string, generatedDir: string, rootPath?: string): Promise<GenerateArtifactsResult>;
+//#endregion
+export { GenerateArtifactsResult, generateArtifacts };
+//# sourceMappingURL=generate-artifacts.d.mts.map

package/dist/services/generate-artifacts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-artifacts.d.mts","names":[],"sources":["../../src/services/generate-artifacts.ts"],"sourcesContent":[],"mappings":";;;UAKiB,uBAAA;;EAAA,SAAA,EAAA,MAAA;AAKjB;AACY,iBADU,iBAAA,CACV,QAAA,EAAA,iBAAA,EAAA,YAAA,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,EAAA,QAAA,CAAA,EAAA,MAAA,CAAA,EAIT,OAJS,CAID,uBAJC,CAAA"}

package/dist/services/generate-artifacts.mjs

@@ -0,0 +1,27 @@
+import { listSpecs } from "./list.mjs";
+import { generateDocsFromSpecs } from "./docs/docs-service.mjs";
+import "./docs/index.mjs";
+import path from "path";
+
+//#region src/services/generate-artifacts.ts
+async function generateArtifacts(adapters, contractsDir, generatedDir, rootPath) {
+	if (!await adapters.fs.exists(contractsDir)) {}
+	const specs = await listSpecs(adapters, { pattern: await adapters.fs.exists(contractsDir) ? "contracts/**/*.ts" : "**/*.ts" });
+	if (specs.length === 0) return {
+		specsCount: 0,
+		docsCount: 0
+	};
+	const docsResult = await generateDocsFromSpecs(specs.map((s) => s.filePath), {
+		outputDir: path.join(generatedDir, "docs"),
+		format: "markdown",
+		rootPath
+	}, adapters);
+	return {
+		specsCount: specs.length,
+		docsCount: docsResult.count
+	};
+}
+
+//#endregion
+export { generateArtifacts };
+//# sourceMappingURL=generate-artifacts.mjs.map

package/dist/services/generate-artifacts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-artifacts.mjs","names":[],"sources":["../../src/services/generate-artifacts.ts"],"sourcesContent":["import path from 'path';\nimport type { WorkspaceAdapters } from '../ports/logger';\nimport { listSpecs } from './list';\nimport { generateDocsFromSpecs } from './docs/index';\n\nexport interface GenerateArtifactsResult {\n  specsCount: number;\n  docsCount: number;\n}\n\nexport async function generateArtifacts(\n  adapters: WorkspaceAdapters,\n  contractsDir: string,\n  generatedDir: string,\n  rootPath?: string\n): Promise<GenerateArtifactsResult> {\n  // Check if contracts directory exists\n  if (!(await adapters.fs.exists(contractsDir))) {\n    // Fallback logic\n  }\n\n  const searchPattern = (await adapters.fs.exists(contractsDir))\n    ? 'contracts/**/*.ts'\n    : '**/*.ts';\n\n  const specs = await listSpecs(adapters, { pattern: searchPattern });\n\n  if (specs.length === 0) {\n    return { specsCount: 0, docsCount: 0 };\n  }\n\n  const specFiles = specs.map((s) => s.filePath);\n  const docsDir = path.join(generatedDir, 'docs');\n\n  // We assume adapters passed are compatible with what gen docs needs\n  const docsResult = await generateDocsFromSpecs(\n    specFiles,\n    { outputDir: docsDir, format: 'markdown', rootPath },\n    adapters\n  );\n\n  return {\n    specsCount: specs.length,\n    docsCount: docsResult.count,\n  };\n}\n"],"mappings":";;;;;;AAUA,eAAsB,kBACpB,UACA,cACA,cACA,UACkC;AAElC,KAAI,CAAE,MAAM,SAAS,GAAG,OAAO,aAAa,EAAG;CAQ/C,MAAM,QAAQ,MAAM,UAAU,UAAU,EAAE,SAJnB,MAAM,SAAS,GAAG,OAAO,aAAa,GACzD,sBACA,WAE8D,CAAC;AAEnE,KAAI,MAAM,WAAW,EACnB,QAAO;EAAE,YAAY;EAAG,WAAW;EAAG;CAOxC,MAAM,aAAa,MAAM,sBAJP,MAAM,KAAK,MAAM,EAAE,SAAS,EAM5C;EAAE,WALY,KAAK,KAAK,cAAc,OAAO;EAKvB,QAAQ;EAAY;EAAU,EACpD,SACD;AAED,QAAO;EACL,YAAY,MAAM;EAClB,WAAW,WAAW;EACvB"}

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

@@ -0,0 +1,24 @@
+import { FsAdapter } from "../../ports/fs.mjs";
+import { LoggerAdapter } from "../../ports/logger.mjs";
+import { HookRunOptions, HookRunResult } from "./types.mjs";
+
+//#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.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-service.d.mts","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"}