@contractspec/bundle.workspace 1.57.0 → 1.58.0

package/dist/services/agent-guide/adapters/index.mjs

@@ -1,31 +0,0 @@
-import { ClaudeCodeAdapter, claudeCodeAdapter } from "./claude-code.mjs";
-import { CursorCLIAdapter, cursorCLIAdapter } from "./cursor-cli.mjs";
-import { GenericMCPAdapter, genericMCPAdapter } from "./generic-mcp.mjs";
-
-//#region src/services/agent-guide/adapters/index.ts
-/**
-* Registry of all available agent adapters.
-*/
-const agentAdapters = {
-	"claude-code": claudeCodeAdapter,
-	"cursor-cli": cursorCLIAdapter,
-	"generic-mcp": genericMCPAdapter
-};
-/**
-* Get an adapter for a specific agent type.
-*/
-function getAgentAdapter(agent) {
-	const adapter = agentAdapters[agent];
-	if (!adapter) throw new Error(`Unknown agent type: ${agent}`);
-	return adapter;
-}
-/**
-* List all available agent types.
-*/
-function listAgentTypes() {
-	return Object.keys(agentAdapters);
-}
-
-//#endregion
-export { agentAdapters, getAgentAdapter, listAgentTypes };
-//# sourceMappingURL=index.mjs.map

package/dist/services/agent-guide/adapters/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/agent-guide/adapters/index.ts"],"sourcesContent":["/**\n * Agent Adapters\n *\n * Exports all agent-specific adapters for formatting implementation\n * plans and prompts.\n */\n\nexport { ClaudeCodeAdapter, claudeCodeAdapter } from './claude-code';\nexport { CursorCLIAdapter, cursorCLIAdapter } from './cursor-cli';\nexport { GenericMCPAdapter, genericMCPAdapter } from './generic-mcp';\n\nimport type { AgentType } from '@contractspec/lib.contracts/llm';\nimport type { AgentAdapter } from '../types';\nimport { claudeCodeAdapter } from './claude-code';\nimport { cursorCLIAdapter } from './cursor-cli';\nimport { genericMCPAdapter } from './generic-mcp';\n\n/**\n * Registry of all available agent adapters.\n */\nexport const agentAdapters: Record<AgentType, AgentAdapter> = {\n  'claude-code': claudeCodeAdapter,\n  'cursor-cli': cursorCLIAdapter,\n  'generic-mcp': genericMCPAdapter,\n};\n\n/**\n * Get an adapter for a specific agent type.\n */\nexport function getAgentAdapter(agent: AgentType): AgentAdapter {\n  const adapter = agentAdapters[agent];\n  if (!adapter) {\n    throw new Error(`Unknown agent type: ${agent}`);\n  }\n  return adapter;\n}\n\n/**\n * List all available agent types.\n */\nexport function listAgentTypes(): AgentType[] {\n  return Object.keys(agentAdapters) as AgentType[];\n}\n"],"mappings":";;;;;;;;AAoBA,MAAa,gBAAiD;CAC5D,eAAe;CACf,cAAc;CACd,eAAe;CAChB;;;;AAKD,SAAgB,gBAAgB,OAAgC;CAC9D,MAAM,UAAU,cAAc;AAC9B,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,uBAAuB,QAAQ;AAEjD,QAAO;;;;;AAMT,SAAgB,iBAA8B;AAC5C,QAAO,OAAO,KAAK,cAAc"}

package/dist/services/agent-guide/agent-guide-service.d.mts

@@ -1,55 +0,0 @@
-import { AgentGuideConfig, GuideOptions, GuideResult } from "./types.mjs";
-import { AnyOperationSpec, OperationSpecRegistry, PresentationRegistry } from "@contractspec/lib.contracts";
-import { AgentType } from "@contractspec/lib.contracts/llm";
-import { FeatureModuleSpec } from "@contractspec/lib.contracts/features";
-
-//#region src/services/agent-guide/agent-guide-service.d.ts
-/**
- * Agent Guide Service
- *
- * Main service for generating implementation guidance for AI coding agents.
- */
-declare class AgentGuideService {
-  private config;
-  constructor(config?: Partial<AgentGuideConfig>);
-  /**
-   * Generate an implementation guide for a spec.
-   */
-  generateGuide(spec: AnyOperationSpec, options?: GuideOptions): GuideResult;
-  /**
-   * Generate a guide for a feature (includes all related specs).
-   */
-  generateFeatureGuide(feature: FeatureModuleSpec, deps: {
-    specs?: OperationSpecRegistry;
-    presentations?: PresentationRegistry;
-  }, options?: GuideOptions): GuideResult;
-  /**
-   * Generate agent-specific configuration (e.g., cursor rules).
-   */
-  generateAgentConfig(spec: AnyOperationSpec, agent?: AgentType): string | undefined;
-  /**
-   * Export a spec in a specific format for an agent.
-   */
-  exportForAgent(spec: AnyOperationSpec, _agent: AgentType, taskType?: 'implement' | 'test' | 'refactor' | 'review', existingCode?: string): string;
-  /**
-   * List available agent types.
-   */
-  listAgentTypes(): AgentType[];
-  /**
-   * Get the default agent type.
-   */
-  getDefaultAgent(): AgentType;
-  /**
-   * Update configuration.
-   */
-  configure(config: Partial<AgentGuideConfig>): void;
-}
-/**
- * Create a new AgentGuideService instance.
- */
-declare function createAgentGuideService(config?: Partial<AgentGuideConfig>): AgentGuideService;
-/** Default singleton instance */
-declare const agentGuideService: AgentGuideService;
-//#endregion
-export { AgentGuideService, agentGuideService, createAgentGuideService };
-//# sourceMappingURL=agent-guide-service.d.mts.map

package/dist/services/agent-guide/agent-guide-service.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-guide-service.d.mts","names":[],"sources":["../../../src/services/agent-guide/agent-guide-service.ts"],"mappings":";;;;;;;;;;;cAoCa,iBAAA;EAAA,QACH,MAAA;cAEI,MAAA,GAAQ,OAAA,CAAQ,gBAAA;EA2CzB;;;EApCH,aAAA,CACE,IAAA,EAAM,gBAAA,EACN,OAAA,GAAS,YAAA,GACR,WAAA;EAiIO;;;EAvGV,oBAAA,CACE,OAAA,EAAS,iBAAA,EACT,IAAA;IACE,KAAA,GAAQ,qBAAA;IACR,aAAA,GAAgB,oBAAA;EAAA,GAElB,OAAA,GAAS,YAAA,GACR,WAAA;EA7CK;;;EAgIR,mBAAA,CACE,IAAA,EAAM,gBAAA,EACN,KAAA,GAAQ,SAAA;EAhIE;;;EAyIZ,cAAA,CACE,IAAA,EAAM,gBAAA,EACN,MAAA,EAAQ,SAAA,EACR,QAAA,iDACA,YAAA;EApIS;;;EA4IX,cAAA,CAAA,GAAkB,SAAA;EAhHP;;;EAuHX,eAAA,CAAA,GAAmB,SAAA;EApHf;;;EA2HJ,SAAA,CAAU,MAAA,EAAQ,OAAA,CAAQ,gBAAA;AAAA;;;;iBAQZ,uBAAA,CACd,MAAA,GAAS,OAAA,CAAQ,gBAAA,IAChB,iBAAA;;cAKU,iBAAA,EAAiB,iBAAA"}

package/dist/services/agent-guide/agent-guide-service.mjs

@@ -1,147 +0,0 @@
-import { getAgentAdapter, listAgentTypes } from "./adapters/index.mjs";
-import { featureToMarkdown, generateImplementationPlan, operationSpecToAgentPrompt, operationSpecToFullMarkdown } from "@contractspec/lib.contracts/llm";
-
-//#region src/services/agent-guide/agent-guide-service.ts
-const DEFAULT_CONFIG = {
-	defaultAgent: "generic-mcp",
-	verbose: false
-};
-/**
-* Agent Guide Service
-*
-* Main service for generating implementation guidance for AI coding agents.
-*/
-var AgentGuideService = class {
-	config;
-	constructor(config = {}) {
-		this.config = {
-			...DEFAULT_CONFIG,
-			...config
-		};
-	}
-	/**
-	* Generate an implementation guide for a spec.
-	*/
-	generateGuide(spec, options = {}) {
-		const adapter = getAgentAdapter(options.agent ?? this.config.defaultAgent);
-		const plan = generateImplementationPlan(spec, {
-			projectRoot: this.config.projectRoot,
-			existingFiles: options.targetPath ? [options.targetPath] : void 0
-		});
-		return {
-			plan,
-			prompt: adapter.formatPlan(plan),
-			markdown: operationSpecToFullMarkdown(spec)
-		};
-	}
-	/**
-	* Generate a guide for a feature (includes all related specs).
-	*/
-	generateFeatureGuide(feature, deps, options = {}) {
-		const adapter = getAgentAdapter(options.agent ?? this.config.defaultAgent);
-		const firstOp = feature.operations?.[0];
-		const spec = firstOp ? deps.specs?.get(firstOp.key, firstOp.version) : void 0;
-		let plan;
-		if (spec) {
-			plan = generateImplementationPlan(spec, { projectRoot: this.config.projectRoot });
-			plan.target = {
-				type: "feature",
-				key: feature.meta.key,
-				version: "1.0.0"
-			};
-			plan.context.goal = feature.meta.description ?? plan.context.goal;
-		} else plan = {
-			target: {
-				type: "feature",
-				key: feature.meta.key,
-				version: "1.0.0"
-			},
-			context: {
-				goal: feature.meta.description ?? `Implement feature ${feature.meta.key}`,
-				description: feature.meta.title ?? feature.meta.key,
-				background: ""
-			},
-			specMarkdown: featureToMarkdown(feature, deps),
-			fileStructure: [],
-			steps: [{
-				order: 1,
-				title: "Implement Feature",
-				description: `Implement the ${feature.meta.key} feature`,
-				acceptanceCriteria: []
-			}],
-			constraints: {
-				policy: [],
-				security: [],
-				pii: []
-			},
-			verificationChecklist: []
-		};
-		plan.specMarkdown = featureToMarkdown(feature, deps, {
-			format: "full",
-			includeRelatedSpecs: true,
-			includeRelatedEvents: true,
-			includeRelatedPresentations: true
-		});
-		if (feature.operations?.length) plan.steps = feature.operations.map((op, idx) => ({
-			order: idx + 1,
-			title: `Implement ${op.key}`,
-			description: `Implement operation ${op.key}.v${op.version}`,
-			acceptanceCriteria: [`Operation ${op.key} works as specified`]
-		}));
-		const prompt = adapter.formatPlan(plan);
-		const markdown = featureToMarkdown(feature, deps);
-		return {
-			plan,
-			prompt,
-			markdown
-		};
-	}
-	/**
-	* Generate agent-specific configuration (e.g., cursor rules).
-	*/
-	generateAgentConfig(spec, agent) {
-		return getAgentAdapter(agent ?? this.config.defaultAgent).generateConfig?.(spec);
-	}
-	/**
-	* Export a spec in a specific format for an agent.
-	*/
-	exportForAgent(spec, _agent, taskType = "implement", existingCode) {
-		return operationSpecToAgentPrompt(spec, {
-			taskType,
-			existingCode
-		});
-	}
-	/**
-	* List available agent types.
-	*/
-	listAgentTypes() {
-		return listAgentTypes();
-	}
-	/**
-	* Get the default agent type.
-	*/
-	getDefaultAgent() {
-		return this.config.defaultAgent;
-	}
-	/**
-	* Update configuration.
-	*/
-	configure(config) {
-		this.config = {
-			...this.config,
-			...config
-		};
-	}
-};
-/**
-* Create a new AgentGuideService instance.
-*/
-function createAgentGuideService(config) {
-	return new AgentGuideService(config);
-}
-/** Default singleton instance */
-const agentGuideService = new AgentGuideService();
-
-//#endregion
-export { AgentGuideService, agentGuideService, createAgentGuideService };
-//# sourceMappingURL=agent-guide-service.mjs.map

package/dist/services/agent-guide/agent-guide-service.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-guide-service.mjs","names":[],"sources":["../../../src/services/agent-guide/agent-guide-service.ts"],"sourcesContent":["/**\n * Agent Guide Service\n *\n * Generates implementation plans and prompts for AI coding agents.\n * Bridges ContractSpec specifications with agent-specific formats.\n */\n\nimport type {\n  AnyOperationSpec,\n  OperationSpecRegistry,\n  PresentationRegistry,\n} from '@contractspec/lib.contracts';\nimport type { FeatureModuleSpec } from '@contractspec/lib.contracts/features';\nimport type {\n  AgentType,\n  ImplementationPlan,\n} from '@contractspec/lib.contracts/llm';\nimport {\n  featureToMarkdown,\n  generateImplementationPlan,\n  operationSpecToAgentPrompt,\n  operationSpecToFullMarkdown,\n} from '@contractspec/lib.contracts/llm';\nimport { getAgentAdapter, listAgentTypes } from './adapters';\nimport type { AgentGuideConfig, GuideOptions, GuideResult } from './types';\n\nconst DEFAULT_CONFIG: AgentGuideConfig = {\n  defaultAgent: 'generic-mcp',\n  verbose: false,\n};\n\n/**\n * Agent Guide Service\n *\n * Main service for generating implementation guidance for AI coding agents.\n */\nexport class AgentGuideService {\n  private config: AgentGuideConfig;\n\n  constructor(config: Partial<AgentGuideConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  /**\n   * Generate an implementation guide for a spec.\n   */\n  generateGuide(\n    spec: AnyOperationSpec,\n    options: GuideOptions = {}\n  ): GuideResult {\n    const agent = options.agent ?? this.config.defaultAgent;\n    const adapter = getAgentAdapter(agent);\n\n    // Generate the implementation plan\n    const plan = generateImplementationPlan(spec, {\n      projectRoot: this.config.projectRoot,\n      existingFiles: options.targetPath ? [options.targetPath] : undefined,\n    });\n\n    // Format for the target agent\n    const prompt = adapter.formatPlan(plan);\n\n    // Generate raw markdown for clipboard/export\n    const markdown = operationSpecToFullMarkdown(spec);\n\n    return {\n      plan,\n      prompt,\n      markdown,\n    };\n  }\n\n  /**\n   * Generate a guide for a feature (includes all related specs).\n   */\n  generateFeatureGuide(\n    feature: FeatureModuleSpec,\n    deps: {\n      specs?: OperationSpecRegistry;\n      presentations?: PresentationRegistry;\n    },\n    options: GuideOptions = {}\n  ): GuideResult {\n    const agent = options.agent ?? this.config.defaultAgent;\n    const adapter = getAgentAdapter(agent);\n\n    // Create a composite plan for the feature\n    const firstOp = feature.operations?.[0];\n    const spec = firstOp\n      ? deps.specs?.get(firstOp.key, firstOp.version)\n      : undefined;\n\n    // Generate base plan from first spec or create feature-level plan\n    let plan: ImplementationPlan;\n    if (spec) {\n      plan = generateImplementationPlan(spec, {\n        projectRoot: this.config.projectRoot,\n      });\n      // Override target to indicate it's a feature\n      plan.target = {\n        type: 'feature',\n        key: feature.meta.key,\n        version: '1.0.0',\n      };\n      plan.context.goal = feature.meta.description ?? plan.context.goal;\n    } else {\n      // Create a minimal plan for features without specs\n      plan = {\n        target: {\n          type: 'feature',\n          key: feature.meta.key,\n          version: '1.0.0',\n        },\n        context: {\n          goal:\n            feature.meta.description ?? `Implement feature ${feature.meta.key}`,\n          description: feature.meta.title ?? feature.meta.key,\n          background: '',\n        },\n        specMarkdown: featureToMarkdown(feature, deps),\n        fileStructure: [],\n        steps: [\n          {\n            order: 1,\n            title: 'Implement Feature',\n            description: `Implement the ${feature.meta.key} feature`,\n            acceptanceCriteria: [],\n          },\n        ],\n        constraints: { policy: [], security: [], pii: [] },\n        verificationChecklist: [],\n      };\n    }\n\n    // Enhance spec markdown with full feature context\n    plan.specMarkdown = featureToMarkdown(feature, deps, {\n      format: 'full',\n      includeRelatedSpecs: true,\n      includeRelatedEvents: true,\n      includeRelatedPresentations: true,\n    });\n\n    // Add steps for each operation\n    if (feature.operations?.length) {\n      plan.steps = feature.operations.map((op, idx) => ({\n        order: idx + 1,\n        title: `Implement ${op.key}`,\n        description: `Implement operation ${op.key}.v${op.version}`,\n        acceptanceCriteria: [`Operation ${op.key} works as specified`],\n      }));\n    }\n\n    const prompt = adapter.formatPlan(plan);\n    const markdown = featureToMarkdown(feature, deps);\n\n    return {\n      plan,\n      prompt,\n      markdown,\n    };\n  }\n\n  /**\n   * Generate agent-specific configuration (e.g., cursor rules).\n   */\n  generateAgentConfig(\n    spec: AnyOperationSpec,\n    agent?: AgentType\n  ): string | undefined {\n    const adapter = getAgentAdapter(agent ?? this.config.defaultAgent);\n    return adapter.generateConfig?.(spec);\n  }\n\n  /**\n   * Export a spec in a specific format for an agent.\n   */\n  exportForAgent(\n    spec: AnyOperationSpec,\n    _agent: AgentType,\n    taskType: 'implement' | 'test' | 'refactor' | 'review' = 'implement',\n    existingCode?: string\n  ): string {\n    return operationSpecToAgentPrompt(spec, { taskType, existingCode });\n  }\n\n  /**\n   * List available agent types.\n   */\n  listAgentTypes(): AgentType[] {\n    return listAgentTypes();\n  }\n\n  /**\n   * Get the default agent type.\n   */\n  getDefaultAgent(): AgentType {\n    return this.config.defaultAgent;\n  }\n\n  /**\n   * Update configuration.\n   */\n  configure(config: Partial<AgentGuideConfig>): void {\n    this.config = { ...this.config, ...config };\n  }\n}\n\n/**\n * Create a new AgentGuideService instance.\n */\nexport function createAgentGuideService(\n  config?: Partial<AgentGuideConfig>\n): AgentGuideService {\n  return new AgentGuideService(config);\n}\n\n/** Default singleton instance */\nexport const agentGuideService = new AgentGuideService();\n"],"mappings":";;;;AA0BA,MAAM,iBAAmC;CACvC,cAAc;CACd,SAAS;CACV;;;;;;AAOD,IAAa,oBAAb,MAA+B;CAC7B,AAAQ;CAER,YAAY,SAAoC,EAAE,EAAE;AAClD,OAAK,SAAS;GAAE,GAAG;GAAgB,GAAG;GAAQ;;;;;CAMhD,cACE,MACA,UAAwB,EAAE,EACb;EAEb,MAAM,UAAU,gBADF,QAAQ,SAAS,KAAK,OAAO,aACL;EAGtC,MAAM,OAAO,2BAA2B,MAAM;GAC5C,aAAa,KAAK,OAAO;GACzB,eAAe,QAAQ,aAAa,CAAC,QAAQ,WAAW,GAAG;GAC5D,CAAC;AAQF,SAAO;GACL;GACA,QAPa,QAAQ,WAAW,KAAK;GAQrC,UALe,4BAA4B,KAAK;GAMjD;;;;;CAMH,qBACE,SACA,MAIA,UAAwB,EAAE,EACb;EAEb,MAAM,UAAU,gBADF,QAAQ,SAAS,KAAK,OAAO,aACL;EAGtC,MAAM,UAAU,QAAQ,aAAa;EACrC,MAAM,OAAO,UACT,KAAK,OAAO,IAAI,QAAQ,KAAK,QAAQ,QAAQ,GAC7C;EAGJ,IAAI;AACJ,MAAI,MAAM;AACR,UAAO,2BAA2B,MAAM,EACtC,aAAa,KAAK,OAAO,aAC1B,CAAC;AAEF,QAAK,SAAS;IACZ,MAAM;IACN,KAAK,QAAQ,KAAK;IAClB,SAAS;IACV;AACD,QAAK,QAAQ,OAAO,QAAQ,KAAK,eAAe,KAAK,QAAQ;QAG7D,QAAO;GACL,QAAQ;IACN,MAAM;IACN,KAAK,QAAQ,KAAK;IAClB,SAAS;IACV;GACD,SAAS;IACP,MACE,QAAQ,KAAK,eAAe,qBAAqB,QAAQ,KAAK;IAChE,aAAa,QAAQ,KAAK,SAAS,QAAQ,KAAK;IAChD,YAAY;IACb;GACD,cAAc,kBAAkB,SAAS,KAAK;GAC9C,eAAe,EAAE;GACjB,OAAO,CACL;IACE,OAAO;IACP,OAAO;IACP,aAAa,iBAAiB,QAAQ,KAAK,IAAI;IAC/C,oBAAoB,EAAE;IACvB,CACF;GACD,aAAa;IAAE,QAAQ,EAAE;IAAE,UAAU,EAAE;IAAE,KAAK,EAAE;IAAE;GAClD,uBAAuB,EAAE;GAC1B;AAIH,OAAK,eAAe,kBAAkB,SAAS,MAAM;GACnD,QAAQ;GACR,qBAAqB;GACrB,sBAAsB;GACtB,6BAA6B;GAC9B,CAAC;AAGF,MAAI,QAAQ,YAAY,OACtB,MAAK,QAAQ,QAAQ,WAAW,KAAK,IAAI,SAAS;GAChD,OAAO,MAAM;GACb,OAAO,aAAa,GAAG;GACvB,aAAa,uBAAuB,GAAG,IAAI,IAAI,GAAG;GAClD,oBAAoB,CAAC,aAAa,GAAG,IAAI,qBAAqB;GAC/D,EAAE;EAGL,MAAM,SAAS,QAAQ,WAAW,KAAK;EACvC,MAAM,WAAW,kBAAkB,SAAS,KAAK;AAEjD,SAAO;GACL;GACA;GACA;GACD;;;;;CAMH,oBACE,MACA,OACoB;AAEpB,SADgB,gBAAgB,SAAS,KAAK,OAAO,aAAa,CACnD,iBAAiB,KAAK;;;;;CAMvC,eACE,MACA,QACA,WAAyD,aACzD,cACQ;AACR,SAAO,2BAA2B,MAAM;GAAE;GAAU;GAAc,CAAC;;;;;CAMrE,iBAA8B;AAC5B,SAAO,gBAAgB;;;;;CAMzB,kBAA6B;AAC3B,SAAO,KAAK,OAAO;;;;;CAMrB,UAAU,QAAyC;AACjD,OAAK,SAAS;GAAE,GAAG,KAAK;GAAQ,GAAG;GAAQ;;;;;;AAO/C,SAAgB,wBACd,QACmB;AACnB,QAAO,IAAI,kBAAkB,OAAO;;;AAItC,MAAa,oBAAoB,IAAI,mBAAmB"}

package/dist/services/agent-guide/index.d.mts

@@ -1,6 +0,0 @@
-import { AgentAdapter, AgentGuideConfig, FormatOptions, GuideOptions, GuideResult } from "./types.mjs";
-import { AgentGuideService, agentGuideService, createAgentGuideService } from "./agent-guide-service.mjs";
-import { ClaudeCodeAdapter, claudeCodeAdapter } from "./adapters/claude-code.mjs";
-import { CursorCLIAdapter, cursorCLIAdapter } from "./adapters/cursor-cli.mjs";
-import { GenericMCPAdapter, genericMCPAdapter } from "./adapters/generic-mcp.mjs";
-import { agentAdapters, getAgentAdapter, listAgentTypes } from "./adapters/index.mjs";

package/dist/services/agent-guide/index.mjs

@@ -1,7 +0,0 @@
-import { ClaudeCodeAdapter, claudeCodeAdapter } from "./adapters/claude-code.mjs";
-import { CursorCLIAdapter, cursorCLIAdapter } from "./adapters/cursor-cli.mjs";
-import { GenericMCPAdapter, genericMCPAdapter } from "./adapters/generic-mcp.mjs";
-import { agentAdapters, getAgentAdapter, listAgentTypes } from "./adapters/index.mjs";
-import { AgentGuideService, agentGuideService, createAgentGuideService } from "./agent-guide-service.mjs";
-
-export {  };

package/dist/services/agent-guide/types.d.mts

@@ -1,57 +0,0 @@
-import { AnyOperationSpec } from "@contractspec/lib.contracts";
-import { AgentPrompt, AgentType, ImplementationPlan } from "@contractspec/lib.contracts/llm";
-
-//#region src/services/agent-guide/types.d.ts
-/** Configuration for the agent guide service */
-interface AgentGuideConfig {
-  /** Default agent to use if not specified */
-  defaultAgent: AgentType;
-  /** Project root path */
-  projectRoot?: string;
-  /** Enable verbose logging */
-  verbose?: boolean;
-}
-/** Options for generating an implementation guide */
-interface GuideOptions {
-  /** Target agent type */
-  agent?: AgentType;
-  /** Existing code to consider */
-  existingCode?: string;
-  /** Target file path for implementation */
-  targetPath?: string;
-  /** Include related specs */
-  includeRelated?: boolean;
-}
-/** Options for formatting output */
-interface FormatOptions {
-  /** Output format */
-  format: 'markdown' | 'json' | 'cursor-rules';
-  /** Include system prompt */
-  includeSystemPrompt?: boolean;
-}
-/** Result of generating a guide */
-interface GuideResult {
-  /** The generated plan */
-  plan: ImplementationPlan;
-  /** Formatted prompt for the target agent */
-  prompt: AgentPrompt;
-  /** Raw markdown for clipboard/export */
-  markdown: string;
-}
-/** Adapter interface for specific agent types */
-interface AgentAdapter {
-  /** Agent type this adapter handles */
-  agentType: AgentType;
-  /** Format a plan for this agent */
-  formatPlan(plan: ImplementationPlan): AgentPrompt;
-  /** Generate agent-specific configuration (e.g., cursor rules) */
-  generateConfig?(spec: AnyOperationSpec): string;
-  /** Parse agent output to extract code */
-  parseOutput?(output: string): {
-    code?: string;
-    errors?: string[];
-  };
-}
-//#endregion
-export { AgentAdapter, AgentGuideConfig, FormatOptions, GuideOptions, GuideResult };
-//# sourceMappingURL=types.d.mts.map

package/dist/services/agent-guide/types.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/services/agent-guide/types.ts"],"mappings":";;;;;UAYiB,gBAAA;EAEQ;EAAvB,YAAA,EAAc,SAAA;EAAA;EAEd,WAAA;EAEA;EAAA,OAAA;AAAA;AAIF;AAAA,UAAiB,YAAA;;EAEf,KAAA,GAAQ,SAAA;EAAR;EAEA,YAAA;EAAA;EAEA,UAAA;EAEA;EAAA,cAAA;AAAA;AAIF;AAAA,UAAiB,aAAA;;EAEf,MAAA;EAEmB;EAAnB,mBAAA;AAAA;;UAIe,WAAA;EAEf;EAAA,IAAA,EAAM,kBAAA;EAEN;EAAA,MAAA,EAAQ,WAAA;EAER;EAAA,QAAA;AAAA;AAIF;AAAA,UAAiB,YAAA;;EAEf,SAAA,EAAW,SAAA;EAGM;EAAjB,UAAA,CAAW,IAAA,EAAM,kBAAA,GAAqB,WAAA;EAGhB;EAAtB,cAAA,EAAgB,IAAA,EAAM,gBAAA;EAAgB;EAGtC,WAAA,EAAa,MAAA;IAAmB,IAAA;IAAe,MAAA;EAAA;AAAA"}

package/dist/services/build.d.mts

@@ -1,61 +0,0 @@
-import { FsAdapter } from "../ports/fs.mjs";
-import { LoggerAdapter } from "../ports/logger.mjs";
-import * as _contractspec_module_workspace0 from "@contractspec/module.workspace";
-import { SpecScanResult } from "@contractspec/module.workspace";
-import { ResolvedContractsrcConfig } from "@contractspec/lib.contracts";
-
-//#region src/services/build.d.ts
-/**
- * Build target types.
- */
-type BuildTarget = 'handler' | 'component' | 'test';
-/**
- * Options for building from a spec.
- */
-interface BuildSpecOptions {
-  /**
-   * Which artifacts to generate.
-   */
-  targets?: BuildTarget[];
-  /**
-   * Override output directory.
-   */
-  outputDir?: string;
-  /**
-   * Whether to overwrite existing files.
-   */
-  overwrite?: boolean;
-  /**
-   * Skip writing files (dry run).
-   */
-  dryRun?: boolean;
-}
-/**
- * Result of a single build target.
- */
-interface BuildTargetResult {
-  target: BuildTarget;
-  outputPath: string;
-  success: boolean;
-  skipped?: boolean;
-  error?: string;
-}
-/**
- * Result of building from a spec.
- */
-interface BuildSpecResult {
-  specPath: string;
-  specInfo: SpecScanResult;
-  results: BuildTargetResult[];
-}
-/**
- * Build implementation files from a spec.
- */
-declare function buildSpec(specPath: string, adapters: {
-  fs: FsAdapter;
-  logger: LoggerAdapter;
-  workspace?: typeof _contractspec_module_workspace0;
-}, config: ResolvedContractsrcConfig, options?: BuildSpecOptions): Promise<BuildSpecResult>;
-//#endregion
-export { BuildSpecOptions, BuildSpecResult, BuildTarget, BuildTargetResult, buildSpec };
-//# sourceMappingURL=build.d.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"build.d.mts","names":[],"sources":["../../src/services/build.ts"],"mappings":";;;;;;;;;AA2BA;KALY,WAAA;;;;UAKK,gBAAA;EASf;;;EALA,OAAA,GAAU,WAAA;EAeJ;AAMR;;EAhBE,SAAA;EAiBmB;;;EAZnB,SAAA;EAcA;;;EATA,MAAA;AAAA;AAiBF;;;AAAA,UAXiB,iBAAA;EACf,MAAA,EAAQ,WAAA;EACR,UAAA;EACA,OAAA;EACA,OAAA;EACA,KAAA;AAAA;;AAeF;;UATiB,eAAA;EACf,QAAA;EACA,QAAA,EAAU,cAAA;EACV,OAAA,EAAS,iBAAA;AAAA;;;;iBAMW,SAAA,CACpB,QAAA,UACA,QAAA;EACE,EAAA,EAAI,SAAA;EACJ,MAAA,EAAQ,aAAA;EACR,SAAA,UADqB,+BAAA;AAAA,GAGvB,MAAA,EAAQ,yBAAA,EACR,OAAA,GAAS,gBAAA,GACR,OAAA,CAAQ,eAAA"}

package/dist/services/build.mjs

@@ -1,151 +0,0 @@
-import { generateComponentTemplate, generateHandlerTemplate, generateTestTemplate, inferSpecTypeFromFilePath, scanSpecSource } from "@contractspec/module.workspace";
-
-//#region src/services/build.ts
-/**
-* Build/scaffold service for generating implementation files from specs.
-*
-* Uses templates from @contractspec/module.workspace to generate
-* handler, component, and test skeletons without requiring AI.
-*/
-/**
-* Build implementation files from a spec.
-*/
-async function buildSpec(specPath, adapters, config, options = {}) {
-	const { fs, logger, workspace } = adapters;
-	const scan = workspace?.scanSpecSource ?? scanSpecSource;
-	const inferType = workspace?.inferSpecTypeFromFilePath ?? inferSpecTypeFromFilePath;
-	const genHandler = workspace?.generateHandlerTemplate ?? generateHandlerTemplate;
-	const genComponent = workspace?.generateComponentTemplate ?? generateComponentTemplate;
-	const genTest = workspace?.generateTestTemplate ?? generateTestTemplate;
-	const { targets = detectDefaultTargets(specPath, inferType), outputDir = config.outputDir, overwrite = false, dryRun = false } = options;
-	const specCode = await fs.readFile(specPath);
-	const specInfo = scan(specCode, specPath);
-	const specType = inferType(specPath);
-	logger.info(`Building from spec: ${specPath}`, { specType });
-	const results = [];
-	for (const target of targets) try {
-		const result = await buildTarget(target, specPath, specCode, specInfo, specType, {
-			fs,
-			logger
-		}, outputDir, overwrite, dryRun, {
-			genHandler,
-			genComponent,
-			genTest
-		});
-		results.push(result);
-	} catch (error) {
-		results.push({
-			target,
-			outputPath: "",
-			success: false,
-			error: error instanceof Error ? error.message : String(error),
-			skipped: false
-		});
-	}
-	return {
-		specPath,
-		specInfo,
-		results
-	};
-}
-/**
-* Build a single target from a spec.
-*/
-async function buildTarget(target, specPath, _specCode, specInfo, specType, adapters, outputDir, overwrite, dryRun, generators) {
-	const { fs, logger } = adapters;
-	const { genHandler, genComponent, genTest } = generators;
-	let code;
-	let outputPath;
-	switch (target) {
-		case "handler": {
-			if (specType !== "operation") return {
-				target,
-				outputPath: "",
-				success: false,
-				skipped: true,
-				error: `Handler generation only supported for operation specs (got ${specType})`
-			};
-			const kind = specInfo.kind === "command" || specInfo.kind === "query" ? specInfo.kind : "command";
-			code = genHandler(specInfo.key ?? "unknown", kind);
-			outputPath = resolveOutputPath(specPath, outputDir, "handlers", specInfo.key ?? "unknown", ".handler.ts", adapters.fs);
-			break;
-		}
-		case "component":
-			if (specType !== "presentation") return {
-				target,
-				outputPath: "",
-				success: false,
-				skipped: true,
-				error: `Component generation only supported for presentation specs (got ${specType})`
-			};
-			code = genComponent(specInfo.key ?? "unknown", specInfo.description ?? "");
-			outputPath = resolveOutputPath(specPath, outputDir, "components", specInfo.key ?? "unknown", ".tsx", adapters.fs);
-			break;
-		case "test": {
-			const testType = specType === "operation" ? "handler" : "component";
-			code = genTest(specInfo.key ?? "unknown", testType);
-			outputPath = resolveOutputPath(specPath, outputDir, "__tests__", specInfo.key ?? "unknown", ".test.ts", adapters.fs);
-			break;
-		}
-		default: return {
-			target,
-			outputPath: "",
-			success: false,
-			error: `Unknown target: ${target}`
-		};
-	}
-	if (await fs.exists(outputPath) && !overwrite) return {
-		target,
-		outputPath,
-		success: false,
-		skipped: true,
-		error: "File already exists (use overwrite option)"
-	};
-	if (dryRun) {
-		logger.info(`[dry-run] Would write: ${outputPath}`);
-		return {
-			target,
-			outputPath,
-			success: true
-		};
-	}
-	const dirPath = fs.dirname(outputPath);
-	await fs.mkdir(dirPath);
-	await fs.writeFile(outputPath, code);
-	logger.info(`Generated: ${outputPath}`);
-	return {
-		target,
-		outputPath,
-		success: true
-	};
-}
-/**
-* Detect default targets based on spec type.
-*/
-function detectDefaultTargets(specPath, inferType) {
-	switch (inferType(specPath)) {
-		case "operation": return ["handler"];
-		case "presentation": return ["component"];
-		default: return [];
-	}
-}
-/**
-* Resolve output path for generated file.
-*/
-function resolveOutputPath(specPath, outputDir, subdir, specName, extension, fs) {
-	const sanitizedName = toKebabCase(specName.split(".").pop() ?? "unknown");
-	let baseDir;
-	if (outputDir.startsWith(".")) baseDir = fs.resolve(fs.dirname(specPath), "..", outputDir, subdir);
-	else baseDir = fs.resolve(outputDir, subdir);
-	return fs.join(baseDir, `${sanitizedName}${extension}`);
-}
-/**
-* Convert string to kebab-case.
-*/
-function toKebabCase(str) {
-	return str.replace(/\./g, "-").replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
-}
-
-//#endregion
-export { buildSpec };
-//# sourceMappingURL=build.mjs.map

package/dist/services/build.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"build.mjs","names":[],"sources":["../../src/services/build.ts"],"sourcesContent":["/**\n * Build/scaffold service for generating implementation files from specs.\n *\n * Uses templates from @contractspec/module.workspace to generate\n * handler, component, and test skeletons without requiring AI.\n */\n\nimport {\n  generateComponentTemplate,\n  generateHandlerTemplate,\n  generateTestTemplate,\n  inferSpecTypeFromFilePath,\n  scanSpecSource,\n  type SpecScanResult,\n} from '@contractspec/module.workspace';\nimport type { FsAdapter } from '../ports/fs';\nimport type { LoggerAdapter } from '../ports/logger';\nimport type { ResolvedContractsrcConfig } from '@contractspec/lib.contracts';\n\n/**\n * Build target types.\n */\nexport type BuildTarget = 'handler' | 'component' | 'test';\n\n/**\n * Options for building from a spec.\n */\nexport interface BuildSpecOptions {\n  /**\n   * Which artifacts to generate.\n   */\n  targets?: BuildTarget[];\n\n  /**\n   * Override output directory.\n   */\n  outputDir?: string;\n\n  /**\n   * Whether to overwrite existing files.\n   */\n  overwrite?: boolean;\n\n  /**\n   * Skip writing files (dry run).\n   */\n  dryRun?: boolean;\n}\n\n/**\n * Result of a single build target.\n */\nexport interface BuildTargetResult {\n  target: BuildTarget;\n  outputPath: string;\n  success: boolean;\n  skipped?: boolean;\n  error?: string;\n}\n\n/**\n * Result of building from a spec.\n */\nexport interface BuildSpecResult {\n  specPath: string;\n  specInfo: SpecScanResult;\n  results: BuildTargetResult[];\n}\n\n/**\n * Build implementation files from a spec.\n */\nexport async function buildSpec(\n  specPath: string,\n  adapters: {\n    fs: FsAdapter;\n    logger: LoggerAdapter;\n    workspace?: typeof import('@contractspec/module.workspace');\n  },\n  config: ResolvedContractsrcConfig,\n  options: BuildSpecOptions = {}\n): Promise<BuildSpecResult> {\n  const { fs, logger, workspace } = adapters;\n\n  // Use injected modules or defaults\n  const scan = workspace?.scanSpecSource ?? scanSpecSource;\n  const inferType =\n    workspace?.inferSpecTypeFromFilePath ?? inferSpecTypeFromFilePath;\n  const genHandler =\n    workspace?.generateHandlerTemplate ?? generateHandlerTemplate;\n  const genComponent =\n    workspace?.generateComponentTemplate ?? generateComponentTemplate;\n  const genTest = workspace?.generateTestTemplate ?? generateTestTemplate;\n\n  const {\n    targets = detectDefaultTargets(specPath, inferType),\n    outputDir = config.outputDir,\n    overwrite = false,\n    dryRun = false,\n  } = options;\n\n  // Read and scan spec\n  const specCode = await fs.readFile(specPath);\n  const specInfo = scan(specCode, specPath);\n  const specType = inferType(specPath);\n\n  logger.info(`Building from spec: ${specPath}`, { specType });\n\n  const results: BuildTargetResult[] = [];\n\n  for (const target of targets) {\n    try {\n      const result = await buildTarget(\n        target,\n        specPath,\n        specCode,\n        specInfo,\n        specType,\n        { fs, logger },\n        outputDir,\n        overwrite,\n        dryRun,\n        { genHandler, genComponent, genTest }\n      );\n      results.push(result);\n    } catch (error) {\n      results.push({\n        target,\n        outputPath: '',\n        success: false,\n        error: error instanceof Error ? error.message : String(error),\n        skipped: false, // Default to false unless overridden\n      });\n    }\n  }\n\n  return {\n    specPath,\n    specInfo,\n    results,\n  };\n}\n\n/**\n * Build a single target from a spec.\n */\nasync function buildTarget(\n  target: BuildTarget,\n  specPath: string,\n  _specCode: string,\n  specInfo: SpecScanResult,\n  specType: string,\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  outputDir: string,\n  overwrite: boolean,\n  dryRun: boolean,\n  generators: {\n    genHandler: typeof generateHandlerTemplate;\n    genComponent: typeof generateComponentTemplate;\n    genTest: typeof generateTestTemplate;\n  }\n): Promise<BuildTargetResult> {\n  const { fs, logger } = adapters;\n  const { genHandler, genComponent, genTest } = generators;\n\n  let code: string;\n  let outputPath: string;\n\n  switch (target) {\n    case 'handler': {\n      if (specType !== 'operation') {\n        return {\n          target,\n          outputPath: '',\n          success: false,\n          skipped: true,\n          error: `Handler generation only supported for operation specs (got ${specType})`,\n        };\n      }\n\n      const kind =\n        specInfo.kind === 'command' || specInfo.kind === 'query'\n          ? specInfo.kind\n          : 'command';\n\n      code = genHandler(specInfo.key ?? 'unknown', kind);\n      outputPath = resolveOutputPath(\n        specPath,\n        outputDir,\n        'handlers',\n        specInfo.key ?? 'unknown',\n        '.handler.ts',\n        adapters.fs\n      );\n      break;\n    }\n\n    case 'component': {\n      if (specType !== 'presentation') {\n        return {\n          target,\n          outputPath: '',\n          success: false,\n          skipped: true,\n          error: `Component generation only supported for presentation specs (got ${specType})`,\n        };\n      }\n\n      code = genComponent(\n        specInfo.key ?? 'unknown',\n        specInfo.description ?? ''\n      );\n      outputPath = resolveOutputPath(\n        specPath,\n        outputDir,\n        'components',\n        specInfo.key ?? 'unknown',\n        '.tsx',\n        adapters.fs\n      );\n      break;\n    }\n\n    case 'test': {\n      const testType = specType === 'operation' ? 'handler' : 'component';\n      code = genTest(specInfo.key ?? 'unknown', testType);\n      outputPath = resolveOutputPath(\n        specPath,\n        outputDir,\n        '__tests__',\n        specInfo.key ?? 'unknown',\n        '.test.ts',\n        adapters.fs\n      );\n      break;\n    }\n\n    default:\n      return {\n        target,\n        outputPath: '',\n        success: false,\n        error: `Unknown target: ${target}`,\n      };\n  }\n\n  // Check if file exists\n  const exists = await fs.exists(outputPath);\n  if (exists && !overwrite) {\n    return {\n      target,\n      outputPath,\n      success: false,\n      skipped: true,\n      error: 'File already exists (use overwrite option)',\n    };\n  }\n\n  if (dryRun) {\n    logger.info(`[dry-run] Would write: ${outputPath}`);\n    return {\n      target,\n      outputPath,\n      success: true,\n    };\n  }\n\n  // Ensure directory exists\n  const dirPath = fs.dirname(outputPath);\n  await fs.mkdir(dirPath);\n\n  // Write file\n  await fs.writeFile(outputPath, code);\n  logger.info(`Generated: ${outputPath}`);\n\n  return {\n    target,\n    outputPath,\n    success: true,\n  };\n}\n\n/**\n * Detect default targets based on spec type.\n */\nfunction detectDefaultTargets(\n  specPath: string,\n  inferType: typeof inferSpecTypeFromFilePath\n): BuildTarget[] {\n  const specType = inferType(specPath);\n\n  switch (specType) {\n    case 'operation':\n      return ['handler'];\n    case 'presentation':\n      return ['component'];\n    default:\n      return [];\n  }\n}\n\n/**\n * Resolve output path for generated file.\n */\nfunction resolveOutputPath(\n  specPath: string,\n  outputDir: string,\n  subdir: string,\n  specName: string,\n  extension: string,\n  fs: FsAdapter\n): string {\n  const sanitizedName = toKebabCase(specName.split('.').pop() ?? 'unknown');\n\n  let baseDir: string;\n  if (outputDir.startsWith('.')) {\n    // Relative to spec file location\n    baseDir = fs.resolve(fs.dirname(specPath), '..', outputDir, subdir);\n  } else {\n    // Absolute or relative to cwd\n    baseDir = fs.resolve(outputDir, subdir);\n  }\n\n  return fs.join(baseDir, `${sanitizedName}${extension}`);\n}\n\n/**\n * Convert string to kebab-case.\n */\nfunction toKebabCase(str: string): string {\n  return str\n    .replace(/\\./g, '-')\n    .replace(/([a-z])([A-Z])/g, '$1-$2')\n    .toLowerCase();\n}\n"],"mappings":"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"}

package/dist/services/ci-check/checks/coverage.mjs

@@ -1,66 +0,0 @@
-import { createParser, detectFormat } from "../../coverage/parsers/index.mjs";
-import { validateCoverage } from "../../coverage/validator.mjs";
-import "@contractspec/module.workspace";
-
-//#region src/services/ci-check/checks/coverage.ts
-/**
-* Run coverage goal enforcement checks.
-*/
-async function runCoverageChecks(adapters, specFiles, options) {
-	const { fs, logger } = adapters;
-	const issues = [];
-	const coverageDir = options.workspaceRoot ? `${options.workspaceRoot}/coverage` : "./coverage";
-	const possiblePaths = [
-		`${coverageDir}/coverage-final.json`,
-		`${coverageDir}/coverage.json`,
-		`${coverageDir}/coverage-summary.json`
-	];
-	let coverageContent;
-	let coveragePath;
-	for (const path of possiblePaths) if (await fs.exists(path)) {
-		coverageContent = await fs.readFile(path);
-		coveragePath = path;
-		break;
-	}
-	if (!coverageContent) {
-		logger.info("No coverage report found, skipping coverage checks");
-		return issues;
-	}
-	const coverageReport = createParser(detectFormat(coveragePath ?? "coverage.json")).parse(coverageContent);
-	for (const specFile of specFiles) {
-		if (specFile.specType !== "test-spec" || !specFile.key || !specFile.version || !specFile.sourceBlock) continue;
-		const coverageMatch = specFile.sourceBlock.match(/coverage\s*:\s*\{([^}]+)\}/);
-		if (!coverageMatch || !coverageMatch[1]) continue;
-		const coverageBlock = coverageMatch[1];
-		const requirements = {};
-		const statementsMatch = coverageBlock.match(/statements\s*:\s*(\d+)/);
-		if (statementsMatch && statementsMatch[1]) requirements.statements = parseInt(statementsMatch[1], 10);
-		const branchesMatch = coverageBlock.match(/branches\s*:\s*(\d+)/);
-		if (branchesMatch && branchesMatch[1]) requirements.branches = parseInt(branchesMatch[1], 10);
-		const functionsMatch = coverageBlock.match(/functions\s*:\s*(\d+)/);
-		if (functionsMatch && functionsMatch[1]) requirements.functions = parseInt(functionsMatch[1], 10);
-		const linesMatch = coverageBlock.match(/lines\s*:\s*(\d+)/);
-		if (linesMatch && linesMatch[1]) requirements.lines = parseInt(linesMatch[1], 10);
-		if (Object.keys(requirements).length === 0) continue;
-		const result = validateCoverage(specFile.key, specFile.version, requirements, coverageReport.total);
-		for (const failure of result.failures) issues.push({
-			ruleId: "coverage-below-threshold",
-			severity: "error",
-			message: failure.message,
-			category: "coverage",
-			file: specFile.filePath,
-			context: {
-				specKey: specFile.key,
-				specVersion: specFile.version,
-				metric: failure.metric,
-				required: failure.required,
-				actual: failure.actual
-			}
-		});
-	}
-	return issues;
-}
-
-//#endregion
-export { runCoverageChecks };
-//# sourceMappingURL=coverage.mjs.map

package/dist/services/ci-check/checks/coverage.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"coverage.mjs","names":[],"sources":["../../../../src/services/ci-check/checks/coverage.ts"],"sourcesContent":["/**\n * Coverage goal enforcement checks.\n *\n * Validates that TestSpec.coverage requirements are met by actual coverage data.\n * Requires a coverage report file to exist (from a previous test run).\n */\n\nimport { type SpecScanResult } from '@contractspec/module.workspace';\nimport type { FsAdapter } from '../../../ports/fs';\nimport type { LoggerAdapter } from '../../../ports/logger';\nimport { createParser, detectFormat, validateCoverage } from '../../coverage';\nimport type { CICheckOptions, CIIssue } from '../types';\n\n/**\n * Run coverage goal enforcement checks.\n */\nexport async function runCoverageChecks(\n  adapters: { fs: FsAdapter; logger: LoggerAdapter },\n  specFiles: SpecScanResult[],\n  options: CICheckOptions\n): Promise<CIIssue[]> {\n  const { fs, logger } = adapters;\n  const issues: CIIssue[] = [];\n\n  // Try to find coverage report\n  const coverageDir = options.workspaceRoot\n    ? `${options.workspaceRoot}/coverage`\n    : './coverage';\n\n  const possiblePaths = [\n    `${coverageDir}/coverage-final.json`,\n    `${coverageDir}/coverage.json`,\n    `${coverageDir}/coverage-summary.json`,\n  ];\n\n  let coverageContent: string | undefined;\n  let coveragePath: string | undefined;\n\n  for (const path of possiblePaths) {\n    const exists = await fs.exists(path);\n    if (exists) {\n      coverageContent = await fs.readFile(path);\n      coveragePath = path;\n      break;\n    }\n  }\n\n  if (!coverageContent) {\n    logger.info('No coverage report found, skipping coverage checks');\n    return issues;\n  }\n\n  // Parse coverage report\n  const format = detectFormat(coveragePath ?? 'coverage.json');\n  const parser = createParser(format);\n  const coverageReport = parser.parse(coverageContent);\n\n  // Scan for test specs with coverage requirements\n  for (const specFile of specFiles) {\n    if (\n      specFile.specType !== 'test-spec' ||\n      !specFile.key ||\n      !specFile.version ||\n      !specFile.sourceBlock\n    )\n      continue;\n\n    // Extract coverage requirements (simplified - actual extraction would need more parsing)\n    const coverageMatch = specFile.sourceBlock.match(\n      /coverage\\s*:\\s*\\{([^}]+)\\}/\n    );\n    if (!coverageMatch || !coverageMatch[1]) continue;\n\n    // Parse coverage requirements\n    const coverageBlock = coverageMatch[1];\n    const requirements: Record<string, number> = {};\n\n    const statementsMatch = coverageBlock.match(/statements\\s*:\\s*(\\d+)/);\n    if (statementsMatch && statementsMatch[1])\n      requirements.statements = parseInt(statementsMatch[1], 10);\n\n    const branchesMatch = coverageBlock.match(/branches\\s*:\\s*(\\d+)/);\n    if (branchesMatch && branchesMatch[1])\n      requirements.branches = parseInt(branchesMatch[1], 10);\n\n    const functionsMatch = coverageBlock.match(/functions\\s*:\\s*(\\d+)/);\n    if (functionsMatch && functionsMatch[1])\n      requirements.functions = parseInt(functionsMatch[1], 10);\n\n    const linesMatch = coverageBlock.match(/lines\\s*:\\s*(\\d+)/);\n    if (linesMatch && linesMatch[1])\n      requirements.lines = parseInt(linesMatch[1], 10);\n\n    if (Object.keys(requirements).length === 0) continue;\n\n    // Validate coverage against requirements\n    const result = validateCoverage(\n      specFile.key,\n      specFile.version,\n      requirements,\n      coverageReport.total\n    );\n\n    // Report failures as errors\n    for (const failure of result.failures) {\n      issues.push({\n        ruleId: 'coverage-below-threshold',\n        severity: 'error',\n        message: failure.message,\n        category: 'coverage',\n        file: specFile.filePath,\n        context: {\n          specKey: specFile.key,\n          specVersion: specFile.version,\n          metric: failure.metric,\n          required: failure.required,\n          actual: failure.actual,\n        },\n      });\n    }\n  }\n\n  return issues;\n}\n"],"mappings":";;;;;;;;AAgBA,eAAsB,kBACpB,UACA,WACA,SACoB;CACpB,MAAM,EAAE,IAAI,WAAW;CACvB,MAAM,SAAoB,EAAE;CAG5B,MAAM,cAAc,QAAQ,gBACxB,GAAG,QAAQ,cAAc,aACzB;CAEJ,MAAM,gBAAgB;EACpB,GAAG,YAAY;EACf,GAAG,YAAY;EACf,GAAG,YAAY;EAChB;CAED,IAAI;CACJ,IAAI;AAEJ,MAAK,MAAM,QAAQ,cAEjB,KADe,MAAM,GAAG,OAAO,KAAK,EACxB;AACV,oBAAkB,MAAM,GAAG,SAAS,KAAK;AACzC,iBAAe;AACf;;AAIJ,KAAI,CAAC,iBAAiB;AACpB,SAAO,KAAK,qDAAqD;AACjE,SAAO;;CAMT,MAAM,iBADS,aADA,aAAa,gBAAgB,gBAAgB,CACzB,CACL,MAAM,gBAAgB;AAGpD,MAAK,MAAM,YAAY,WAAW;AAChC,MACE,SAAS,aAAa,eACtB,CAAC,SAAS,OACV,CAAC,SAAS,WACV,CAAC,SAAS,YAEV;EAGF,MAAM,gBAAgB,SAAS,YAAY,MACzC,6BACD;AACD,MAAI,CAAC,iBAAiB,CAAC,cAAc,GAAI;EAGzC,MAAM,gBAAgB,cAAc;EACpC,MAAM,eAAuC,EAAE;EAE/C,MAAM,kBAAkB,cAAc,MAAM,yBAAyB;AACrE,MAAI,mBAAmB,gBAAgB,GACrC,cAAa,aAAa,SAAS,gBAAgB,IAAI,GAAG;EAE5D,MAAM,gBAAgB,cAAc,MAAM,uBAAuB;AACjE,MAAI,iBAAiB,cAAc,GACjC,cAAa,WAAW,SAAS,cAAc,IAAI,GAAG;EAExD,MAAM,iBAAiB,cAAc,MAAM,wBAAwB;AACnE,MAAI,kBAAkB,eAAe,GACnC,cAAa,YAAY,SAAS,eAAe,IAAI,GAAG;EAE1D,MAAM,aAAa,cAAc,MAAM,oBAAoB;AAC3D,MAAI,cAAc,WAAW,GAC3B,cAAa,QAAQ,SAAS,WAAW,IAAI,GAAG;AAElD,MAAI,OAAO,KAAK,aAAa,CAAC,WAAW,EAAG;EAG5C,MAAM,SAAS,iBACb,SAAS,KACT,SAAS,SACT,cACA,eAAe,MAChB;AAGD,OAAK,MAAM,WAAW,OAAO,SAC3B,QAAO,KAAK;GACV,QAAQ;GACR,UAAU;GACV,SAAS,QAAQ;GACjB,UAAU;GACV,MAAM,SAAS;GACf,SAAS;IACP,SAAS,SAAS;IAClB,aAAa,SAAS;IACtB,QAAQ,QAAQ;IAChB,UAAU,QAAQ;IAClB,QAAQ,QAAQ;IACjB;GACF,CAAC;;AAIN,QAAO"}