@contractspec/bundle.workspace 1.46.1 → 1.47.0

package/dist/services/fix/fix-service.mjs

@@ -0,0 +1,169 @@
+import { analyzeIntegrity } from "../integrity.mjs";
+import { removeReferenceStrategy } from "./strategies/remove-reference.mjs";
+import { implementSkeletonStrategy } from "./strategies/implement-skeleton.mjs";
+import { implementAiStrategy } from "./strategies/implement-ai.mjs";
+
+//#region src/services/fix/fix-service.ts
+/**
+* Service for fixing integrity issues.
+*/
+var FixService = class {
+	strategies;
+	constructor(adapters) {
+		this.adapters = adapters;
+		this.strategies = /* @__PURE__ */ new Map();
+		this.registerStrategy({
+			type: "remove-reference",
+			fix: (issue, opts) => removeReferenceStrategy(issue, opts, { fs: this.adapters.fs })
+		});
+		this.registerStrategy({
+			type: "implement-skeleton",
+			fix: (issue, opts) => implementSkeletonStrategy(issue, opts, { fs: this.adapters.fs })
+		});
+		this.registerStrategy({
+			type: "implement-ai",
+			fix: (issue, opts) => implementAiStrategy(issue, opts, this.adapters)
+		});
+	}
+	/**
+	* Register a fix strategy.
+	*/
+	registerStrategy(strategy) {
+		this.strategies.set(strategy.type, strategy);
+	}
+	/**
+	* Get available strategies for an issue.
+	*/
+	getStrategiesForIssue(issue) {
+		const strategies = [];
+		if (issue.type === "unresolved-ref") {
+			strategies.push("remove-reference");
+			strategies.push("implement-skeleton");
+			strategies.push("implement-ai");
+		} else if (issue.type === "broken-link") {
+			strategies.push("remove-reference");
+			strategies.push("implement-skeleton");
+		}
+		return strategies;
+	}
+	/**
+	* Parse CI issue into a fixable issue context.
+	*/
+	parseFixableIssue(issue) {
+		if (!issue.ref || !issue.featureKey || !issue.specType) return;
+		return {
+			issue,
+			ref: issue.ref,
+			specType: issue.specType,
+			featureFile: issue.file,
+			featureKey: issue.featureKey
+		};
+	}
+	/**
+	* Fix a single issue.
+	*/
+	async fixIssue(issue, options) {
+		const strategy = this.strategies.get(options.strategy);
+		if (!strategy) return {
+			success: false,
+			strategy: options.strategy,
+			issue,
+			filesChanged: [],
+			error: `Strategy ${options.strategy} not found`
+		};
+		this.adapters.logger.info(`Applying fix ${options.strategy} for ${issue.ref.key}`, { dryRun: options.dryRun });
+		return strategy.fix(issue, options);
+	}
+	/**
+	* Batch fix multiple issues.
+	*/
+	async batchFix(request) {
+		const results = [];
+		let succeeded = 0;
+		let failed = 0;
+		for (const issue of request.issues) try {
+			const result = await this.fixIssue(issue, request.options);
+			results.push(result);
+			if (result.success) succeeded++;
+			else failed++;
+		} catch (error) {
+			failed++;
+			results.push({
+				success: false,
+				strategy: request.options.strategy,
+				issue,
+				filesChanged: [],
+				error: error instanceof Error ? error.message : String(error)
+			});
+		}
+		return {
+			total: request.issues.length,
+			succeeded,
+			failed,
+			results
+		};
+	}
+	/**
+	* Scan for integrity issues and return fixable ones.
+	*/
+	async scanAndGetFixables(options = {}) {
+		return (await analyzeIntegrity(this.adapters, {
+			pattern: options.pattern,
+			cwd: options.cwd
+		})).issues.map((issue) => this.getToFix(issue)).filter((item) => item !== null);
+	}
+	/**
+	* Convert an integrity issue into a FixableIssue with strategies.
+	*/
+	getToFix(issue) {
+		const strategies = this.getStrategiesForIssue(issue);
+		if (strategies.length === 0) return null;
+		const fixable = this.parseFixableIssue(issue);
+		if (!fixable) return null;
+		return {
+			...fixable,
+			availableStrategies: strategies,
+			strategies: []
+		};
+	}
+	/**
+	* Determine the best strategy for an issue.
+	*
+	* Logic moved from CLI to be shared.
+	*/
+	resolveStrategy(issue, options) {
+		const { forceStrategy, preferAi, select } = options;
+		if (forceStrategy) return Promise.resolve(forceStrategy);
+		if (preferAi && issue.availableStrategies.includes("implement-ai")) return Promise.resolve("implement-ai");
+		if (issue.availableStrategies.length === 1) return Promise.resolve(issue.availableStrategies[0]);
+		if (issue.availableStrategies.length > 1) {
+			if (typeof select === "function") return select(issue, issue.availableStrategies);
+			return Promise.resolve(issue.availableStrategies[0]);
+		}
+		return Promise.resolve(void 0);
+	}
+	/**
+	* Determine scan options based on input target.
+	*/
+	async determineScanOptions(target) {
+		try {
+			if ((await this.adapters.fs.stat(target)).isDirectory) return { cwd: target };
+			else return { pattern: target };
+		} catch {
+			return { pattern: target };
+		}
+	}
+	/**
+	* Parse CI output JSON into FixableIssues.
+	*/
+	parseIssuesFromCIResult(ciIssues) {
+		if (!Array.isArray(ciIssues)) return [];
+		return ciIssues.map((issue) => {
+			return this.getToFix(issue);
+		}).filter((item) => item !== null);
+	}
+};
+
+//#endregion
+export { FixService };
+//# sourceMappingURL=fix-service.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fix-service.mjs","names":[],"sources":["../../../src/services/fix/fix-service.ts"],"sourcesContent":["/**\n * Fix Service.\n *\n * Orchestrates the application of fixes for integrity issues.\n */\n\nimport type { FsAdapter } from '../../ports/fs';\nimport type { LoggerAdapter } from '../../ports/logger';\nimport type { IntegrityIssue } from '../integrity';\nimport {\n  type BatchFixRequest,\n  type BatchFixResult,\n  type FixableIssue,\n  type FixResult,\n  type FixStrategy,\n  type FixStrategyType,\n  type FixOptions,\n} from './types';\nimport {\n  removeReferenceStrategy,\n  implementSkeletonStrategy,\n  implementAiStrategy,\n} from './strategies';\nimport { analyzeIntegrity } from '../integrity';\n\n/**\n * Service for fixing integrity issues.\n */\nexport class FixService {\n  private strategies: Map<FixStrategyType, FixStrategy>;\n\n  constructor(\n    private readonly adapters: { fs: FsAdapter; logger: LoggerAdapter }\n  ) {\n    this.strategies = new Map();\n    this.registerStrategy({\n      type: 'remove-reference',\n      fix: (issue, opts) =>\n        removeReferenceStrategy(issue, opts, { fs: this.adapters.fs }),\n    });\n    this.registerStrategy({\n      type: 'implement-skeleton',\n      fix: (issue, opts) =>\n        implementSkeletonStrategy(issue, opts, { fs: this.adapters.fs }),\n    });\n    this.registerStrategy({\n      type: 'implement-ai',\n      fix: (issue, opts) => implementAiStrategy(issue, opts, this.adapters),\n    });\n  }\n\n  /**\n   * Register a fix strategy.\n   */\n  private registerStrategy(strategy: FixStrategy): void {\n    this.strategies.set(strategy.type, strategy);\n  }\n\n  /**\n   * Get available strategies for an issue.\n   */\n  getStrategiesForIssue(issue: IntegrityIssue): FixStrategyType[] {\n    const strategies: FixStrategyType[] = [];\n\n    if (issue.type === 'unresolved-ref') {\n      strategies.push('remove-reference');\n      strategies.push('implement-skeleton');\n      strategies.push('implement-ai');\n    } else if (issue.type === 'broken-link') {\n      // Can usually only remove the link or implement the missng target\n      strategies.push('remove-reference'); // Assuming generic removal works for links too\n      strategies.push('implement-skeleton');\n    }\n\n    return strategies;\n  }\n\n  /**\n   * Parse CI issue into a fixable issue context.\n   */\n  parseFixableIssue(\n    issue: IntegrityIssue\n  ): Omit<FixableIssue, 'availableStrategies' | 'strategies'> | undefined {\n    if (!issue.ref || !issue.featureKey || !issue.specType) {\n      return undefined;\n    }\n\n    return {\n      issue,\n      ref: issue.ref,\n      specType: issue.specType,\n      featureFile: issue.file,\n      featureKey: issue.featureKey,\n    };\n  }\n\n  /**\n   * Fix a single issue.\n   */\n  async fixIssue(issue: FixableIssue, options: FixOptions): Promise<FixResult> {\n    const strategy = this.strategies.get(options.strategy);\n\n    if (!strategy) {\n      return {\n        success: false,\n        strategy: options.strategy,\n        issue,\n        filesChanged: [],\n        error: `Strategy ${options.strategy} not found`,\n      };\n    }\n\n    this.adapters.logger.info(\n      `Applying fix ${options.strategy} for ${issue.ref.key}`,\n      {\n        dryRun: options.dryRun,\n      }\n    );\n\n    return strategy.fix(issue, options);\n  }\n\n  /**\n   * Batch fix multiple issues.\n   */\n  async batchFix(request: BatchFixRequest): Promise<BatchFixResult> {\n    const results: FixResult[] = [];\n    let succeeded = 0;\n    let failed = 0;\n\n    for (const issue of request.issues) {\n      try {\n        const result = await this.fixIssue(issue, request.options);\n        results.push(result);\n        if (result.success) {\n          succeeded++;\n        } else {\n          failed++;\n        }\n      } catch (error) {\n        failed++;\n        results.push({\n          success: false,\n          strategy: request.options.strategy,\n          issue,\n          filesChanged: [],\n          error: error instanceof Error ? error.message : String(error),\n        });\n      }\n    }\n\n    return {\n      total: request.issues.length,\n      succeeded,\n      failed,\n      results,\n    };\n  }\n\n  /**\n   * Scan for integrity issues and return fixable ones.\n   */\n  async scanAndGetFixables(\n    options: { pattern?: string; cwd?: string } = {}\n  ): Promise<FixableIssue[]> {\n    const scanResult = await analyzeIntegrity(this.adapters, {\n      pattern: options.pattern,\n      cwd: options.cwd,\n    });\n\n    return scanResult.issues\n      .map((issue) => this.getToFix(issue))\n      .filter((item): item is FixableIssue => item !== null);\n  }\n\n  /**\n   * Convert an integrity issue into a FixableIssue with strategies.\n   */\n  getToFix(issue: IntegrityIssue): FixableIssue | null {\n    const strategies = this.getStrategiesForIssue(issue);\n    if (strategies.length === 0) {\n      return null;\n    }\n\n    const fixable = this.parseFixableIssue(issue);\n    if (!fixable) {\n      return null;\n    }\n\n    return {\n      ...fixable,\n      availableStrategies: strategies,\n      strategies: [], // Strategies are managed by service, not attached to issue object in this implementation\n    } as FixableIssue;\n  }\n\n  /**\n   * Determine the best strategy for an issue.\n   *\n   * Logic moved from CLI to be shared.\n   */\n  resolveStrategy(\n    issue: FixableIssue,\n    options: {\n      forceStrategy?: FixStrategyType;\n      preferAi?: boolean;\n      interactive?: boolean;\n      // Optional callback for interactive selection if environment supports it\n      select?: (\n        issue: FixableIssue,\n        strategies: FixStrategyType[]\n      ) => Promise<FixStrategyType | undefined>;\n    }\n  ): Promise<FixStrategyType | undefined> {\n    const { forceStrategy, preferAi, select } = options;\n\n    // 1. Forced strategy\n    if (forceStrategy) {\n      // Validate it's available? Or trust caller?\n      // For now, trust caller or checks downstream\n      return Promise.resolve(forceStrategy);\n    }\n\n    // 2. AI Preference\n    if (preferAi && issue.availableStrategies.includes('implement-ai')) {\n      return Promise.resolve('implement-ai');\n    }\n\n    // 3. Single strategy available\n    if (issue.availableStrategies.length === 1) {\n      return Promise.resolve(issue.availableStrategies[0]);\n    }\n\n    // 4. Multiple strategies\n    if (issue.availableStrategies.length > 1) {\n      if (typeof select === 'function') {\n        return select(issue, issue.availableStrategies);\n      }\n      // Default to first if non-interactive or no selector provided\n      // Usually the most standard compliant/safest one is first\n      return Promise.resolve(issue.availableStrategies[0]);\n    }\n\n    return Promise.resolve(undefined);\n  }\n\n  /**\n   * Determine scan options based on input target.\n   */\n  async determineScanOptions(\n    target: string\n  ): Promise<{ pattern?: string; cwd?: string }> {\n    try {\n      const stats = await this.adapters.fs.stat(target);\n      if (stats.isDirectory) {\n        return { cwd: target };\n      } else {\n        return { pattern: target };\n      }\n    } catch {\n      // Likely a glob pattern or non-existent path (treated as pattern)\n      return { pattern: target };\n    }\n  }\n\n  /**\n   * Parse CI output JSON into FixableIssues.\n   */\n  parseIssuesFromCIResult(ciIssues: unknown[]): FixableIssue[] {\n    // Check if input is array\n    if (!Array.isArray(ciIssues)) return [];\n\n    return ciIssues\n      .map((issue) => {\n        // CI issues might be wrapped or have different shape.\n        // Assuming they are serialized IntegrityIssues.\n        return this.getToFix(issue as IntegrityIssue);\n      })\n      .filter((item): item is FixableIssue => item !== null);\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,16 @@
+import { BatchFixRequest, BatchFixResult, CIIssueWithFixLinks, FIX_STRATEGY_LABELS, FIX_STRATEGY_STABILITY, FixAIConfig, FixFileChange, FixLink, FixLinkOptions, FixLinkType, FixOptions, FixResult, FixStrategy, FixStrategyType, FixableIssue, SpecGenerationContext } from "./types.mjs";
+import { FixService } from "./fix-service.mjs";
+import { CiOutput, CiOutputSchema } from "./schemas.mjs";
+import { generateFixLinks } from "./fix-link-formatter.mjs";
+import { removeReferenceStrategy } from "./strategies/remove-reference.mjs";
+import { implementSkeletonStrategy } from "./strategies/implement-skeleton.mjs";
+import { implementAiStrategy } from "./strategies/implement-ai.mjs";
+import "./strategies/index.mjs";
+
+//#region src/services/fix/index.d.ts
+declare namespace index_d_exports {
+  export { BatchFixRequest, BatchFixResult, CIIssueWithFixLinks, CiOutput, CiOutputSchema, FIX_STRATEGY_LABELS, FIX_STRATEGY_STABILITY, FixAIConfig, FixFileChange, FixLink, FixLinkOptions, FixLinkType, FixOptions, FixResult, FixService, FixStrategy, FixStrategyType, FixableIssue, SpecGenerationContext, generateFixLinks, implementAiStrategy, implementSkeletonStrategy, removeReferenceStrategy };
+}
+//#endregion
+export { index_d_exports };
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/services/fix/index.ts"],"sourcesContent":[],"mappings":""}

package/dist/services/fix/index.mjs

@@ -0,0 +1,24 @@
+import { __exportAll } from "../../_virtual/rolldown_runtime.mjs";
+import { FIX_STRATEGY_LABELS, FIX_STRATEGY_STABILITY } from "./types.mjs";
+import { removeReferenceStrategy } from "./strategies/remove-reference.mjs";
+import { implementSkeletonStrategy } from "./strategies/implement-skeleton.mjs";
+import { implementAiStrategy } from "./strategies/implement-ai.mjs";
+import { FixService } from "./fix-service.mjs";
+import { CiOutputSchema } from "./schemas.mjs";
+import { generateFixLinks } from "./fix-link-formatter.mjs";
+
+//#region src/services/fix/index.ts
+var fix_exports = /* @__PURE__ */ __exportAll({
+	CiOutputSchema: () => CiOutputSchema,
+	FIX_STRATEGY_LABELS: () => FIX_STRATEGY_LABELS,
+	FIX_STRATEGY_STABILITY: () => FIX_STRATEGY_STABILITY,
+	FixService: () => FixService,
+	generateFixLinks: () => generateFixLinks,
+	implementAiStrategy: () => implementAiStrategy,
+	implementSkeletonStrategy: () => implementSkeletonStrategy,
+	removeReferenceStrategy: () => removeReferenceStrategy
+});
+
+//#endregion
+export { fix_exports };
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/services/fix/index.ts"],"sourcesContent":["/**\n * Fix service exports.\n */\n\nexport * from './types';\nexport * from './fix-service';\nexport * from './schemas';\nexport * from './fix-link-formatter';\nexport * from './strategies';\n"],"mappings":""}

package/dist/services/fix/path-resolver.mjs

@@ -0,0 +1,83 @@
+import path from "node:path";
+
+//#region src/services/fix/path-resolver.ts
+/**
+* Fix path resolution utilities.
+*/
+/**
+* Resolve the output file path for a new spec.
+*
+* Strategies:
+* 1. If outputDir is provided in options, use it.
+* 2. If featureFile is present, try to find the 'src' directory relative to it.
+* 3. Fallback to workspaceRoot/specs/[type]/...
+*/
+function resolveOutputPath(issue, options) {
+	if (options.outputDir) return buildPath(options.outputDir, issue.ref.key, issue.specType);
+	if (issue.featureFile) {
+		const srcDir = findSrcDir(issue.featureFile);
+		if (srcDir) return buildPath(srcDir, issue.ref.key, issue.specType);
+	}
+	return buildPath(path.join(options.workspaceRoot, "specs"), issue.ref.key, issue.specType);
+}
+/**
+* Find the 'src' directory by walking up from the file path.
+*/
+function findSrcDir(filePath) {
+	let current = path.dirname(filePath);
+	const root = path.parse(filePath).root;
+	let iterations = 0;
+	while (current !== root && iterations < 50) {
+		if (path.basename(current) === "src") return current;
+		current = path.dirname(current);
+		iterations++;
+	}
+	current = path.dirname(filePath);
+	iterations = 0;
+	while (current !== root && iterations < 50) {
+		current = path.dirname(current);
+		iterations++;
+	}
+	const srcIndex = filePath.lastIndexOf(`${path.sep}src${path.sep}`);
+	if (srcIndex !== -1) return filePath.substring(0, srcIndex + 5);
+	return null;
+}
+/**
+* Build the full file path.
+*/
+function buildPath(baseDir, key, specType) {
+	const fileName = key.replace(/\./g, "-").toLowerCase();
+	const extension = getFileExtension(specType);
+	const subDir = getSubDirectory(specType);
+	return path.join(baseDir, subDir, `${fileName}${extension}`);
+}
+function getFileExtension(specType) {
+	return {
+		operation: ".operation.ts",
+		event: ".event.ts",
+		presentation: ".presentation.ts",
+		workflow: ".workflow.ts",
+		"data-view": ".data-view.ts",
+		form: ".form.ts",
+		migration: ".migration.ts",
+		experiment: ".experiment.ts",
+		capability: ".capability.ts"
+	}[specType] || ".ts";
+}
+function getSubDirectory(specType) {
+	return {
+		operation: "operations",
+		event: "events",
+		presentation: "presentations",
+		workflow: "workflows",
+		"data-view": "data-views",
+		form: "forms",
+		migration: "migrations",
+		experiment: "experiments",
+		capability: "capabilities"
+	}[specType] || "specs";
+}
+
+//#endregion
+export { resolveOutputPath };
+//# sourceMappingURL=path-resolver.mjs.map

package/dist/services/fix/path-resolver.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolver.mjs","names":[],"sources":["../../../src/services/fix/path-resolver.ts"],"sourcesContent":["/**\n * Fix path resolution utilities.\n */\n\nimport path from 'node:path';\nimport type { FixableIssue, FixOptions } from './types';\n\n/**\n * Resolve the output file path for a new spec.\n *\n * Strategies:\n * 1. If outputDir is provided in options, use it.\n * 2. If featureFile is present, try to find the 'src' directory relative to it.\n * 3. Fallback to workspaceRoot/specs/[type]/...\n */\nexport function resolveOutputPath(\n  issue: FixableIssue,\n  options: FixOptions\n): string {\n  if (options.outputDir) {\n    return buildPath(options.outputDir, issue.ref.key, issue.specType);\n  }\n\n  // Try to locate src directory from feature file\n  if (issue.featureFile) {\n    const srcDir = findSrcDir(issue.featureFile);\n    if (srcDir) {\n      return buildPath(srcDir, issue.ref.key, issue.specType);\n    }\n  }\n\n  // Fallback to workspace root\n  return buildPath(\n    path.join(options.workspaceRoot, 'specs'),\n    issue.ref.key,\n    issue.specType\n  );\n}\n\n/**\n * Find the 'src' directory by walking up from the file path.\n */\nfunction findSrcDir(filePath: string): string | null {\n  let current = path.dirname(filePath);\n  const root = path.parse(filePath).root;\n\n  // Safety break to prevent infinite loops\n  let iterations = 0;\n  while (current !== root && iterations < 50) {\n    if (path.basename(current) === 'src') {\n      return current;\n    }\n    // If we hit a package.json, we might assume src is inside (or we are at root)\n    // But checking for 'src' explicit is safer for monorepo structures\n    current = path.dirname(current);\n    iterations++;\n  }\n\n  // Second pass: look for package.json and append /src\n  current = path.dirname(filePath);\n  iterations = 0;\n  while (current !== root && iterations < 50) {\n    // We can't synchronously check for file existence easily here without FS adapter access\n    // passing FS adapter everywhere is annoying.\n    // relying on 'src' convention in URL path string is often enough for now.\n    // Let's rely on the first pass for \"src\" segment presence.\n    current = path.dirname(current);\n    iterations++;\n  }\n\n  // If the file path itself contains '/src/', extract it\n  const srcIndex = filePath.lastIndexOf(`${path.sep}src${path.sep}`);\n  if (srcIndex !== -1) {\n    return filePath.substring(0, srcIndex + 5); // include /src/\n  }\n\n  return null;\n}\n\n/**\n * Build the full file path.\n */\nfunction buildPath(baseDir: string, key: string, specType: string): string {\n  // Convert key to file name\n  // Logic:\n  // - If key matches spec type (e.g. \"billing\" for a billing op), keep it simple\n  // - Replace dots with dashes? Or keep dots? User mentioned \"docs.search\" -> \"search.ts\" or \"search.operation.ts\"\n  // Let's try to be smart: if key namespace matches package/domain, simplify.\n\n  // Simple for now: normalized key\n  // \"docs.search\" -> \"docs-search\"\n  // \"search\" -> \"search\"\n  const fileName = key.replace(/\\./g, '-').toLowerCase();\n\n  // Optimization: if the key has multiple parts (domain.name), and we are placing it inside a domain folder?\n  // Current requirement: just place in src/[type]s/\n\n  const extension = getFileExtension(specType);\n  const subDir = getSubDirectory(specType);\n\n  return path.join(baseDir, subDir, `${fileName}${extension}`);\n}\n\nfunction getFileExtension(specType: string): string {\n  const extensions: Record<string, string> = {\n    operation: '.operation.ts', // Explicit .operation.ts preferred by user guidelines\n    event: '.event.ts',\n    presentation: '.presentation.ts',\n    workflow: '.workflow.ts',\n    'data-view': '.data-view.ts',\n    form: '.form.ts',\n    migration: '.migration.ts',\n    experiment: '.experiment.ts',\n    capability: '.capability.ts',\n  };\n\n  return extensions[specType] || '.ts';\n}\n\nfunction getSubDirectory(specType: string): string {\n  const dirs: Record<string, string> = {\n    operation: 'operations',\n    event: 'events',\n    presentation: 'presentations',\n    workflow: 'workflows',\n    'data-view': 'data-views',\n    form: 'forms',\n    migration: 'migrations',\n    experiment: 'experiments',\n    capability: 'capabilities',\n  };\n\n  return dirs[specType] || 'specs';\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,kBACd,OACA,SACQ;AACR,KAAI,QAAQ,UACV,QAAO,UAAU,QAAQ,WAAW,MAAM,IAAI,KAAK,MAAM,SAAS;AAIpE,KAAI,MAAM,aAAa;EACrB,MAAM,SAAS,WAAW,MAAM,YAAY;AAC5C,MAAI,OACF,QAAO,UAAU,QAAQ,MAAM,IAAI,KAAK,MAAM,SAAS;;AAK3D,QAAO,UACL,KAAK,KAAK,QAAQ,eAAe,QAAQ,EACzC,MAAM,IAAI,KACV,MAAM,SACP;;;;;AAMH,SAAS,WAAW,UAAiC;CACnD,IAAI,UAAU,KAAK,QAAQ,SAAS;CACpC,MAAM,OAAO,KAAK,MAAM,SAAS,CAAC;CAGlC,IAAI,aAAa;AACjB,QAAO,YAAY,QAAQ,aAAa,IAAI;AAC1C,MAAI,KAAK,SAAS,QAAQ,KAAK,MAC7B,QAAO;AAIT,YAAU,KAAK,QAAQ,QAAQ;AAC/B;;AAIF,WAAU,KAAK,QAAQ,SAAS;AAChC,cAAa;AACb,QAAO,YAAY,QAAQ,aAAa,IAAI;AAK1C,YAAU,KAAK,QAAQ,QAAQ;AAC/B;;CAIF,MAAM,WAAW,SAAS,YAAY,GAAG,KAAK,IAAI,KAAK,KAAK,MAAM;AAClE,KAAI,aAAa,GACf,QAAO,SAAS,UAAU,GAAG,WAAW,EAAE;AAG5C,QAAO;;;;;AAMT,SAAS,UAAU,SAAiB,KAAa,UAA0B;CAUzE,MAAM,WAAW,IAAI,QAAQ,OAAO,IAAI,CAAC,aAAa;CAKtD,MAAM,YAAY,iBAAiB,SAAS;CAC5C,MAAM,SAAS,gBAAgB,SAAS;AAExC,QAAO,KAAK,KAAK,SAAS,QAAQ,GAAG,WAAW,YAAY;;AAG9D,SAAS,iBAAiB,UAA0B;AAalD,QAZ2C;EACzC,WAAW;EACX,OAAO;EACP,cAAc;EACd,UAAU;EACV,aAAa;EACb,MAAM;EACN,WAAW;EACX,YAAY;EACZ,YAAY;EACb,CAEiB,aAAa;;AAGjC,SAAS,gBAAgB,UAA0B;AAajD,QAZqC;EACnC,WAAW;EACX,OAAO;EACP,cAAc;EACd,UAAU;EACV,aAAa;EACb,MAAM;EACN,WAAW;EACX,YAAY;EACZ,YAAY;EACb,CAEW,aAAa"}

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

@@ -0,0 +1,17 @@
+import { z } from "zod";
+
+//#region src/services/fix/schemas.d.ts
+
+/**
+ * Schema for parsing CI output JSON file.
+ * Handles both direct array and nested { issues: [...] } formats.
+ */
+declare const CiOutputSchema: z.ZodUnion<readonly [z.ZodArray<z.ZodUnknown>, z.ZodPipe<z.ZodObject<{
+  issues: z.ZodArray<z.ZodUnknown>;
+}, z.core.$strip>, z.ZodTransform<unknown[], {
+  issues: unknown[];
+}>>]>;
+type CiOutput = z.infer<typeof CiOutputSchema>;
+//#endregion
+export { CiOutput, CiOutputSchema };
+//# sourceMappingURL=schemas.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.mts","names":[],"sources":["../../../src/services/fix/schemas.ts"],"sourcesContent":[],"mappings":";;;;;;AAMA;;AAA2B,cAAd,cAAc,EAAA,CAAA,CAAA,QAAA,CAAA,SAAA,CAAA,CAAA,CAAA,QAAA,CAAA,CAAA,CAAA,UAAA,CAAA,EAAA,CAAA,CAAA,OAAA,CAAA,CAAA,CAAA,SAAA,CAAA;;;;CAAA,CAAA,CAAA,CAAA,CAAA;KAKf,QAAA,GAAW,CAAA,CAAE,aAAa"}

package/dist/services/fix/schemas.mjs

@@ -0,0 +1,12 @@
+import { z } from "zod";
+
+//#region src/services/fix/schemas.ts
+/**
+* Schema for parsing CI output JSON file.
+* Handles both direct array and nested { issues: [...] } formats.
+*/
+const CiOutputSchema = z.union([z.array(z.unknown()), z.object({ issues: z.array(z.unknown()) }).transform((data) => data.issues)]);
+
+//#endregion
+export { CiOutputSchema };
+//# sourceMappingURL=schemas.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.mjs","names":[],"sources":["../../../src/services/fix/schemas.ts"],"sourcesContent":["import { z } from 'zod';\n\n/**\n * Schema for parsing CI output JSON file.\n * Handles both direct array and nested { issues: [...] } formats.\n */\nexport const CiOutputSchema = z.union([\n  z.array(z.unknown()),\n  z.object({ issues: z.array(z.unknown()) }).transform((data) => data.issues),\n]);\n\nexport type CiOutput = z.infer<typeof CiOutputSchema>;\n"],"mappings":";;;;;;;AAMA,MAAa,iBAAiB,EAAE,MAAM,CACpC,EAAE,MAAM,EAAE,SAAS,CAAC,EACpB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,WAAW,SAAS,KAAK,OAAO,CAC5E,CAAC"}

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

@@ -0,0 +1,18 @@
+import { FsAdapter } from "../../../ports/fs.mjs";
+import { LoggerAdapter } from "../../../ports/logger.mjs";
+import { FixOptions, FixResult, FixableIssue } from "../types.mjs";
+
+//#region src/services/fix/strategies/implement-ai.d.ts
+
+/**
+ * Create a spec with AI-generated content.
+ *
+ * Falls back to skeleton if AI is not available or fails.
+ */
+declare function implementAiStrategy(issue: FixableIssue, options: FixOptions, adapters: {
+  fs: FsAdapter;
+  logger: LoggerAdapter;
+}): Promise<FixResult>;
+//#endregion
+export { implementAiStrategy };
+//# sourceMappingURL=implement-ai.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"implement-ai.d.mts","names":[],"sources":["../../../../src/services/fix/strategies/implement-ai.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;iBA8BsB,mBAAA,QACb,uBACE;MACO;UAAmB;IAClC,QAAQ"}

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