@contractspec/bundle.workspace 1.46.2 → 1.48.0

package/dist/services/fix/strategies/implement-ai.mjs

@@ -0,0 +1,139 @@
+import { FIX_STRATEGY_STABILITY } from "../types.mjs";
+import { generateSkeletonOperation } from "../../../templates/fix/skeleton-operation.mjs";
+import { generateSkeletonEvent } from "../../../templates/fix/skeleton-event.mjs";
+import { generateSkeletonPresentation } from "../../../templates/fix/skeleton-presentation.mjs";
+import { generateSkeletonCapability } from "../../../templates/fix/skeleton-capability.mjs";
+import { resolveOutputPath } from "../path-resolver.mjs";
+import path from "node:path";
+
+//#region src/services/fix/strategies/implement-ai.ts
+/**
+* Create a spec with AI-generated content.
+*
+* Falls back to skeleton if AI is not available or fails.
+*/
+async function implementAiStrategy(issue, options, adapters) {
+	const { fs, logger } = adapters;
+	const { ref, specType, featureKey } = issue;
+	try {
+		const ctx = {
+			key: ref.key,
+			version: ref.version,
+			specType,
+			stability: FIX_STRATEGY_STABILITY["implement-ai"],
+			featureKey
+		};
+		let enrichedCtx = ctx;
+		if (options.aiConfig) try {
+			enrichedCtx = await enrichWithAI(ctx, options, logger);
+		} catch (aiError) {
+			logger.warn("AI enrichment failed, falling back to skeleton", { error: aiError instanceof Error ? aiError.message : String(aiError) });
+		}
+		else logger.info("No AI config provided, using skeleton with experimental stability");
+		const code = generateSpecCode(enrichedCtx);
+		if (!code) return {
+			success: false,
+			strategy: "implement-ai",
+			issue,
+			filesChanged: [],
+			error: `Unsupported spec type: ${specType}`
+		};
+		const filePath = resolveOutputPath(issue, options);
+		const filesChanged = [];
+		if (!options.dryRun) {
+			const dir = path.dirname(filePath);
+			await fs.mkdir(dir);
+			await fs.writeFile(filePath, code);
+			filesChanged.push({
+				path: filePath,
+				action: "created"
+			});
+		} else filesChanged.push({
+			path: filePath,
+			action: "created"
+		});
+		return {
+			success: true,
+			strategy: "implement-ai",
+			issue,
+			filesChanged
+		};
+	} catch (error) {
+		return {
+			success: false,
+			strategy: "implement-ai",
+			issue,
+			filesChanged: [],
+			error: error instanceof Error ? error.message : String(error)
+		};
+	}
+}
+/**
+* Enrich the generation context with AI-generated content.
+*/
+async function enrichWithAI(ctx, _options, logger) {
+	logger.info("Generating AI content for spec", {
+		key: ctx.key,
+		type: ctx.specType
+	});
+	const enrichment = inferEnrichmentFromKey(ctx.key, ctx.specType);
+	return {
+		...ctx,
+		description: enrichment.description,
+		enrichment: {
+			goal: enrichment.goal,
+			context: enrichment.context,
+			owners: ["@team"],
+			tags: enrichment.tags
+		}
+	};
+}
+/**
+* Infer enrichment content from the spec key.
+*/
+function inferEnrichmentFromKey(key, specType) {
+	const parts = key.split(".");
+	const domain = parts[0] || "unknown";
+	const action = parts.slice(1).join(" ").replace(/_/g, " ");
+	const domainTags = [domain];
+	const actionKeywords = action.toLowerCase().split(" ");
+	const matchedTags = [
+		"auth",
+		"user",
+		"admin",
+		"api",
+		"data",
+		"search",
+		"create",
+		"update",
+		"delete"
+	].filter((tag) => actionKeywords.some((kw) => kw.includes(tag)));
+	return {
+		description: `${capitalize(specType)} for ${domain} ${action}`,
+		goal: `Enable ${action} functionality in the ${domain} domain`,
+		context: `Part of the ${domain} feature set. Generated by ContractSpec AI fix.`,
+		tags: [...domainTags, ...matchedTags]
+	};
+}
+/**
+* Generate spec code based on type.
+*/
+function generateSpecCode(ctx) {
+	switch (ctx.specType) {
+		case "operation": return generateSkeletonOperation(ctx);
+		case "event": return generateSkeletonEvent(ctx);
+		case "presentation": return generateSkeletonPresentation(ctx);
+		case "capability": return generateSkeletonCapability(ctx);
+		default: return;
+	}
+}
+/**
+* Capitalize the first letter of a string.
+*/
+function capitalize(str) {
+	return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+//#endregion
+export { implementAiStrategy };
+//# sourceMappingURL=implement-ai.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"implement-ai.mjs","names":[],"sources":["../../../../src/services/fix/strategies/implement-ai.ts"],"sourcesContent":["/**\n * Implement AI strategy.\n *\n * Creates a spec with AI-generated content using experimental 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 type { LoggerAdapter } from '../../../ports/logger';\nimport { FIX_STRATEGY_STABILITY } from '../types';\nimport {\n  generateSkeletonOperation,\n  generateSkeletonEvent,\n  generateSkeletonPresentation,\n  generateSkeletonCapability,\n} from '../../../templates/fix';\nimport { resolveOutputPath } from '../path-resolver';\nimport path from 'node:path';\n\n/**\n * Create a spec with AI-generated content.\n *\n * Falls back to skeleton if AI is not available or fails.\n */\nexport async function implementAiStrategy(\n  issue: FixableIssue,\n  options: FixOptions,\n  adapters: { fs: FsAdapter; logger: LoggerAdapter }\n): Promise<FixResult> {\n  const { fs, logger } = adapters;\n  const { ref, specType, featureKey } = issue;\n\n  try {\n    // Build generation context with AI enrichment\n    const ctx: SpecGenerationContext = {\n      key: ref.key,\n      version: ref.version,\n      specType,\n      stability: FIX_STRATEGY_STABILITY['implement-ai'],\n      featureKey,\n    };\n\n    // Try to get AI-generated content\n    let enrichedCtx = ctx;\n    if (options.aiConfig) {\n      try {\n        enrichedCtx = await enrichWithAI(ctx, options, logger);\n      } catch (aiError) {\n        logger.warn('AI enrichment failed, falling back to skeleton', {\n          error: aiError instanceof Error ? aiError.message : String(aiError),\n        });\n        // Continue with unenriched context\n      }\n    } else {\n      logger.info(\n        'No AI config provided, using skeleton with experimental stability'\n      );\n    }\n\n    // Generate the spec code\n    const code = generateSpecCode(enrichedCtx);\n    if (!code) {\n      return {\n        success: false,\n        strategy: 'implement-ai',\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-ai',\n      issue,\n      filesChanged,\n    };\n  } catch (error) {\n    return {\n      success: false,\n      strategy: 'implement-ai',\n      issue,\n      filesChanged: [],\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\n/**\n * Enrich the generation context with AI-generated content.\n */\nasync function enrichWithAI(\n  ctx: SpecGenerationContext,\n  _options: FixOptions,\n  logger: LoggerAdapter\n): Promise<SpecGenerationContext> {\n  // TODO: Integrate with existing AIGenerator from services/create/ai-generator.ts\n  // For now, generate reasonable defaults based on the key\n\n  logger.info('Generating AI content for spec', {\n    key: ctx.key,\n    type: ctx.specType,\n  });\n\n  const enrichment = inferEnrichmentFromKey(ctx.key, ctx.specType);\n\n  return {\n    ...ctx,\n    description: enrichment.description,\n    enrichment: {\n      goal: enrichment.goal,\n      context: enrichment.context,\n      owners: ['@team'],\n      tags: enrichment.tags,\n    },\n  };\n}\n\n/**\n * Infer enrichment content from the spec key.\n */\nfunction inferEnrichmentFromKey(\n  key: string,\n  specType: string\n): {\n  description: string;\n  goal: string;\n  context: string;\n  tags: string[];\n} {\n  const parts = key.split('.');\n  const domain = parts[0] || 'unknown';\n  const action = parts.slice(1).join(' ').replace(/_/g, ' ');\n\n  const domainTags = [domain];\n  const actionKeywords = action.toLowerCase().split(' ');\n\n  // Add relevant tags based on action keywords\n  const tagKeywords = [\n    'auth',\n    'user',\n    'admin',\n    'api',\n    'data',\n    'search',\n    'create',\n    'update',\n    'delete',\n  ];\n  const matchedTags = tagKeywords.filter((tag) =>\n    actionKeywords.some((kw) => kw.includes(tag))\n  );\n\n  return {\n    description: `${capitalize(specType)} for ${domain} ${action}`,\n    goal: `Enable ${action} functionality in the ${domain} domain`,\n    context: `Part of the ${domain} feature set. Generated by ContractSpec AI fix.`,\n    tags: [...domainTags, ...matchedTags],\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\n/**\n * Capitalize the first letter of a string.\n */\nfunction capitalize(str: string): string {\n  return str.charAt(0).toUpperCase() + str.slice(1);\n}\n"],"mappings":";;;;;;;;;;;;;;AA8BA,eAAsB,oBACpB,OACA,SACA,UACoB;CACpB,MAAM,EAAE,IAAI,WAAW;CACvB,MAAM,EAAE,KAAK,UAAU,eAAe;AAEtC,KAAI;EAEF,MAAM,MAA6B;GACjC,KAAK,IAAI;GACT,SAAS,IAAI;GACb;GACA,WAAW,uBAAuB;GAClC;GACD;EAGD,IAAI,cAAc;AAClB,MAAI,QAAQ,SACV,KAAI;AACF,iBAAc,MAAM,aAAa,KAAK,SAAS,OAAO;WAC/C,SAAS;AAChB,UAAO,KAAK,kDAAkD,EAC5D,OAAO,mBAAmB,QAAQ,QAAQ,UAAU,OAAO,QAAQ,EACpE,CAAC;;MAIJ,QAAO,KACL,oEACD;EAIH,MAAM,OAAO,iBAAiB,YAAY;AAC1C,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,eAAe,aACb,KACA,UACA,QACgC;AAIhC,QAAO,KAAK,kCAAkC;EAC5C,KAAK,IAAI;EACT,MAAM,IAAI;EACX,CAAC;CAEF,MAAM,aAAa,uBAAuB,IAAI,KAAK,IAAI,SAAS;AAEhE,QAAO;EACL,GAAG;EACH,aAAa,WAAW;EACxB,YAAY;GACV,MAAM,WAAW;GACjB,SAAS,WAAW;GACpB,QAAQ,CAAC,QAAQ;GACjB,MAAM,WAAW;GAClB;EACF;;;;;AAMH,SAAS,uBACP,KACA,UAMA;CACA,MAAM,QAAQ,IAAI,MAAM,IAAI;CAC5B,MAAM,SAAS,MAAM,MAAM;CAC3B,MAAM,SAAS,MAAM,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC,QAAQ,MAAM,IAAI;CAE1D,MAAM,aAAa,CAAC,OAAO;CAC3B,MAAM,iBAAiB,OAAO,aAAa,CAAC,MAAM,IAAI;CActD,MAAM,cAXc;EAClB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAC+B,QAAQ,QACtC,eAAe,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,CAC9C;AAED,QAAO;EACL,aAAa,GAAG,WAAW,SAAS,CAAC,OAAO,OAAO,GAAG;EACtD,MAAM,UAAU,OAAO,wBAAwB,OAAO;EACtD,SAAS,eAAe,OAAO;EAC/B,MAAM,CAAC,GAAG,YAAY,GAAG,YAAY;EACtC;;;;;AAMH,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;;;;;;AAON,SAAS,WAAW,KAAqB;AACvC,QAAO,IAAI,OAAO,EAAE,CAAC,aAAa,GAAG,IAAI,MAAM,EAAE"}

package/dist/services/fix/strategies/implement-skeleton.d.mts

@@ -0,0 +1,14 @@
+import { FsAdapter } from "../../../ports/fs.mjs";
+import { FixOptions, FixResult, FixableIssue } from "../types.mjs";
+
+//#region src/services/fix/strategies/implement-skeleton.d.ts
+
+/**
+ * Create a skeleton spec for a missing reference.
+ */
+declare function implementSkeletonStrategy(issue: FixableIssue, options: FixOptions, adapters: {
+  fs: FsAdapter;
+}): Promise<FixResult>;
+//#endregion
+export { implementSkeletonStrategy };
+//# sourceMappingURL=implement-skeleton.d.mts.map

package/dist/services/fix/strategies/implement-skeleton.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implement-skeleton.d.mts","names":[],"sources":["../../../../src/services/fix/strategies/implement-skeleton.ts"],"sourcesContent":[],"mappings":";;;;;;;;AA+BU,iBAJY,yBAAA,CAIZ,KAAA,EAHD,YAGC,EAAA,OAAA,EAFC,UAED,EAAA,QAAA,EAAA;MADQ;IACf,QAAQ"}

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

@@ -0,0 +1,77 @@
+import { FIX_STRATEGY_STABILITY } from "../types.mjs";
+import { generateSkeletonOperation } from "../../../templates/fix/skeleton-operation.mjs";
+import { generateSkeletonEvent } from "../../../templates/fix/skeleton-event.mjs";
+import { generateSkeletonPresentation } from "../../../templates/fix/skeleton-presentation.mjs";
+import { generateSkeletonCapability } from "../../../templates/fix/skeleton-capability.mjs";
+import { resolveOutputPath } from "../path-resolver.mjs";
+import path from "node:path";
+
+//#region src/services/fix/strategies/implement-skeleton.ts
+/**
+* Create a skeleton spec for a missing reference.
+*/
+async function implementSkeletonStrategy(issue, options, adapters) {
+	const { fs } = adapters;
+	const { ref, specType, featureKey } = issue;
+	try {
+		const code = generateSpecCode({
+			key: ref.key,
+			version: ref.version,
+			specType,
+			stability: FIX_STRATEGY_STABILITY["implement-skeleton"],
+			description: `Skeleton spec for ${ref.key}`,
+			featureKey
+		});
+		if (!code) return {
+			success: false,
+			strategy: "implement-skeleton",
+			issue,
+			filesChanged: [],
+			error: `Unsupported spec type: ${specType}`
+		};
+		const filePath = resolveOutputPath(issue, options);
+		const filesChanged = [];
+		if (!options.dryRun) {
+			const dir = path.dirname(filePath);
+			await fs.mkdir(dir);
+			await fs.writeFile(filePath, code);
+			filesChanged.push({
+				path: filePath,
+				action: "created"
+			});
+		} else filesChanged.push({
+			path: filePath,
+			action: "created"
+		});
+		return {
+			success: true,
+			strategy: "implement-skeleton",
+			issue,
+			filesChanged
+		};
+	} catch (error) {
+		return {
+			success: false,
+			strategy: "implement-skeleton",
+			issue,
+			filesChanged: [],
+			error: error instanceof Error ? error.message : String(error)
+		};
+	}
+}
+/**
+* Generate spec code based on type.
+*/
+function generateSpecCode(ctx) {
+	switch (ctx.specType) {
+		case "operation": return generateSkeletonOperation(ctx);
+		case "event": return generateSkeletonEvent(ctx);
+		case "presentation": return generateSkeletonPresentation(ctx);
+		case "capability": return generateSkeletonCapability(ctx);
+		default: return;
+	}
+}
+
+//#endregion
+export { implementSkeletonStrategy };
+//# sourceMappingURL=implement-skeleton.mjs.map

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