@contractspec/bundle.workspace 1.57.0 → 1.58.0

package/dist/services/agent-guide/adapters/claude-code.mjs

@@ -1,144 +0,0 @@
-import { AGENT_SYSTEM_PROMPTS } from "@contractspec/lib.contracts/llm";
-
-//#region src/services/agent-guide/adapters/claude-code.ts
-/**
-* Claude Code adapter implementation.
-* Optimized for Claude's extended thinking and code generation capabilities.
-*/
-var ClaudeCodeAdapter = class {
-	agentType = "claude-code";
-	/**
-	* Format an implementation plan for Claude Code.
-	* Uses structured markdown with clear sections and checklists.
-	*/
-	formatPlan(plan) {
-		const lines = [];
-		lines.push(`# Implement: ${plan.target.key}.v${plan.target.version}`);
-		lines.push("");
-		lines.push("## Context");
-		lines.push("");
-		lines.push(`**Goal:** ${plan.context.goal}`);
-		lines.push("");
-		lines.push(`**Description:** ${plan.context.description}`);
-		lines.push("");
-		if (plan.context.background) {
-			lines.push(`**Background:**`);
-			lines.push(plan.context.background);
-			lines.push("");
-		}
-		lines.push("## Specification");
-		lines.push("");
-		lines.push(plan.specMarkdown);
-		lines.push("");
-		if (plan.fileStructure.length > 0) {
-			lines.push("## Files to Create/Modify");
-			lines.push("");
-			for (const file of plan.fileStructure) {
-				const icon = file.type === "create" ? "📝" : "✏️";
-				lines.push(`${icon} \`${file.path}\``);
-				lines.push(`   ${file.purpose}`);
-				lines.push("");
-			}
-		}
-		lines.push("## Implementation Steps");
-		lines.push("");
-		for (const step of plan.steps) {
-			lines.push(`### ${step.order}. ${step.title}`);
-			lines.push("");
-			lines.push(step.description);
-			lines.push("");
-			lines.push("**Acceptance Criteria:**");
-			for (const criteria of step.acceptanceCriteria) lines.push(`- [ ] ${criteria}`);
-			lines.push("");
-		}
-		if (plan.constraints.policy.length > 0 || plan.constraints.security.length > 0 || plan.constraints.pii.length > 0) {
-			lines.push("## Constraints");
-			lines.push("");
-			if (plan.constraints.policy.length > 0) {
-				lines.push("### Policy");
-				for (const p of plan.constraints.policy) lines.push(`- ${p}`);
-				lines.push("");
-			}
-			if (plan.constraints.security.length > 0) {
-				lines.push("### Security");
-				for (const s of plan.constraints.security) lines.push(`- ⚠️ ${s}`);
-				lines.push("");
-			}
-			if (plan.constraints.pii.length > 0) {
-				lines.push("### PII Handling");
-				lines.push("The following fields contain personally identifiable information:");
-				for (const pii of plan.constraints.pii) lines.push(`- \`${pii}\``);
-				lines.push("");
-			}
-		}
-		lines.push("## Verification Checklist");
-		lines.push("");
-		lines.push("Before submitting, verify:");
-		for (const check of plan.verificationChecklist) lines.push(`- [ ] ${check}`);
-		lines.push("");
-		lines.push("## Instructions");
-		lines.push("");
-		lines.push("1. Implement each step in order");
-		lines.push("2. Use TypeScript with strict typing (no `any`)");
-		lines.push("3. Include JSDoc comments for public APIs");
-		lines.push("4. Handle all error cases defined in the spec");
-		lines.push("5. Emit events as specified");
-		lines.push("6. Mark checklist items as you complete them");
-		lines.push("");
-		return {
-			agent: "claude-code",
-			systemPrompt: AGENT_SYSTEM_PROMPTS["claude-code"],
-			taskPrompt: lines.join("\n")
-		};
-	}
-	/**
-	* Generate agent-specific configuration.
-	* For Claude Code, this generates a prompt that can be used as context.
-	*/
-	generateConfig(spec) {
-		const lines = [];
-		lines.push("# ContractSpec Implementation Context");
-		lines.push("");
-		lines.push("This codebase uses ContractSpec for spec-first development.");
-		lines.push("");
-		lines.push("## Spec Details");
-		lines.push("");
-		lines.push(`- **Name:** ${spec.meta.key}`);
-		lines.push(`- **Version:** ${spec.meta.version}`);
-		lines.push(`- **Kind:** ${spec.meta.kind}`);
-		lines.push(`- **Stability:** ${spec.meta.stability}`);
-		lines.push("");
-		lines.push("## Implementation Requirements");
-		lines.push("");
-		lines.push("1. Match input/output types exactly");
-		lines.push("2. Handle all defined error cases");
-		lines.push("3. Emit events as specified");
-		lines.push("4. Respect policy constraints");
-		lines.push("");
-		return lines.join("\n");
-	}
-	/**
-	* Parse Claude Code output to extract generated code.
-	*/
-	parseOutput(output) {
-		const codeBlockMatch = output.match(/```(?:typescript|ts|tsx)?\n([\s\S]*?)\n```/);
-		if (codeBlockMatch?.[1]) return { code: codeBlockMatch[1] };
-		const errors = [];
-		for (const pattern of [
-			/error:\s*(.+)/gi,
-			/failed:\s*(.+)/gi,
-			/cannot\s+(.+)/gi
-		]) {
-			const matches = output.matchAll(pattern);
-			for (const match of matches) if (match[1]) errors.push(match[1]);
-		}
-		if (errors.length > 0) return { errors };
-		return { code: output };
-	}
-};
-/** Singleton instance */
-const claudeCodeAdapter = new ClaudeCodeAdapter();
-
-//#endregion
-export { ClaudeCodeAdapter, claudeCodeAdapter };
-//# sourceMappingURL=claude-code.mjs.map

package/dist/services/agent-guide/adapters/claude-code.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"claude-code.mjs","names":[],"sources":["../../../../src/services/agent-guide/adapters/claude-code.ts"],"sourcesContent":["/**\n * Claude Code Agent Adapter\n *\n * Formats implementation plans and prompts for Claude Code (Anthropic's\n * advanced coding agent mode).\n */\n\nimport type { AnyOperationSpec } from '@contractspec/lib.contracts';\nimport type {\n  AgentPrompt,\n  ImplementationPlan,\n} from '@contractspec/lib.contracts/llm';\nimport { AGENT_SYSTEM_PROMPTS } from '@contractspec/lib.contracts/llm';\nimport type { AgentAdapter } from '../types';\n\n/**\n * Claude Code adapter implementation.\n * Optimized for Claude's extended thinking and code generation capabilities.\n */\nexport class ClaudeCodeAdapter implements AgentAdapter {\n  agentType = 'claude-code' as const;\n\n  /**\n   * Format an implementation plan for Claude Code.\n   * Uses structured markdown with clear sections and checklists.\n   */\n  formatPlan(plan: ImplementationPlan): AgentPrompt {\n    const lines: string[] = [];\n\n    // Header\n    lines.push(`# Implement: ${plan.target.key}.v${plan.target.version}`);\n    lines.push('');\n\n    // Context section\n    lines.push('## Context');\n    lines.push('');\n    lines.push(`**Goal:** ${plan.context.goal}`);\n    lines.push('');\n    lines.push(`**Description:** ${plan.context.description}`);\n    lines.push('');\n    if (plan.context.background) {\n      lines.push(`**Background:**`);\n      lines.push(plan.context.background);\n      lines.push('');\n    }\n\n    // Full specification\n    lines.push('## Specification');\n    lines.push('');\n    lines.push(plan.specMarkdown);\n    lines.push('');\n\n    // File structure\n    if (plan.fileStructure.length > 0) {\n      lines.push('## Files to Create/Modify');\n      lines.push('');\n      for (const file of plan.fileStructure) {\n        const icon = file.type === 'create' ? '📝' : '✏️';\n        lines.push(`${icon} \\`${file.path}\\``);\n        lines.push(`   ${file.purpose}`);\n        lines.push('');\n      }\n    }\n\n    // Implementation steps\n    lines.push('## Implementation Steps');\n    lines.push('');\n    for (const step of plan.steps) {\n      lines.push(`### ${step.order}. ${step.title}`);\n      lines.push('');\n      lines.push(step.description);\n      lines.push('');\n      lines.push('**Acceptance Criteria:**');\n      for (const criteria of step.acceptanceCriteria) {\n        lines.push(`- [ ] ${criteria}`);\n      }\n      lines.push('');\n    }\n\n    // Constraints\n    if (\n      plan.constraints.policy.length > 0 ||\n      plan.constraints.security.length > 0 ||\n      plan.constraints.pii.length > 0\n    ) {\n      lines.push('## Constraints');\n      lines.push('');\n\n      if (plan.constraints.policy.length > 0) {\n        lines.push('### Policy');\n        for (const p of plan.constraints.policy) {\n          lines.push(`- ${p}`);\n        }\n        lines.push('');\n      }\n\n      if (plan.constraints.security.length > 0) {\n        lines.push('### Security');\n        for (const s of plan.constraints.security) {\n          lines.push(`- ⚠️ ${s}`);\n        }\n        lines.push('');\n      }\n\n      if (plan.constraints.pii.length > 0) {\n        lines.push('### PII Handling');\n        lines.push(\n          'The following fields contain personally identifiable information:'\n        );\n        for (const pii of plan.constraints.pii) {\n          lines.push(`- \\`${pii}\\``);\n        }\n        lines.push('');\n      }\n    }\n\n    // Verification checklist\n    lines.push('## Verification Checklist');\n    lines.push('');\n    lines.push('Before submitting, verify:');\n    for (const check of plan.verificationChecklist) {\n      lines.push(`- [ ] ${check}`);\n    }\n    lines.push('');\n\n    // Instructions\n    lines.push('## Instructions');\n    lines.push('');\n    lines.push('1. Implement each step in order');\n    lines.push('2. Use TypeScript with strict typing (no `any`)');\n    lines.push('3. Include JSDoc comments for public APIs');\n    lines.push('4. Handle all error cases defined in the spec');\n    lines.push('5. Emit events as specified');\n    lines.push('6. Mark checklist items as you complete them');\n    lines.push('');\n\n    return {\n      agent: 'claude-code',\n      systemPrompt: AGENT_SYSTEM_PROMPTS['claude-code'],\n      taskPrompt: lines.join('\\n'),\n    };\n  }\n\n  /**\n   * Generate agent-specific configuration.\n   * For Claude Code, this generates a prompt that can be used as context.\n   */\n  generateConfig(spec: AnyOperationSpec): string {\n    const lines: string[] = [];\n\n    lines.push('# ContractSpec Implementation Context');\n    lines.push('');\n    lines.push('This codebase uses ContractSpec for spec-first development.');\n    lines.push('');\n    lines.push('## Spec Details');\n    lines.push('');\n    lines.push(`- **Name:** ${spec.meta.key}`);\n    lines.push(`- **Version:** ${spec.meta.version}`);\n    lines.push(`- **Kind:** ${spec.meta.kind}`);\n    lines.push(`- **Stability:** ${spec.meta.stability}`);\n    lines.push('');\n    lines.push('## Implementation Requirements');\n    lines.push('');\n    lines.push('1. Match input/output types exactly');\n    lines.push('2. Handle all defined error cases');\n    lines.push('3. Emit events as specified');\n    lines.push('4. Respect policy constraints');\n    lines.push('');\n\n    return lines.join('\\n');\n  }\n\n  /**\n   * Parse Claude Code output to extract generated code.\n   */\n  parseOutput(output: string): { code?: string; errors?: string[] } {\n    // Extract code from markdown code blocks\n    const codeBlockMatch = output.match(\n      /```(?:typescript|ts|tsx)?\\n([\\s\\S]*?)\\n```/\n    );\n\n    if (codeBlockMatch?.[1]) {\n      return { code: codeBlockMatch[1] };\n    }\n\n    // Check for error indicators\n    const errors: string[] = [];\n    const errorPatterns = [\n      /error:\\s*(.+)/gi,\n      /failed:\\s*(.+)/gi,\n      /cannot\\s+(.+)/gi,\n    ];\n\n    for (const pattern of errorPatterns) {\n      const matches = output.matchAll(pattern);\n      for (const match of matches) {\n        if (match[1]) {\n          errors.push(match[1]);\n        }\n      }\n    }\n\n    if (errors.length > 0) {\n      return { errors };\n    }\n\n    // Return raw output if no code block found\n    return { code: output };\n  }\n}\n\n/** Singleton instance */\nexport const claudeCodeAdapter = new ClaudeCodeAdapter();\n"],"mappings":"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"}

package/dist/services/agent-guide/adapters/cursor-cli.d.mts

@@ -1,38 +0,0 @@
-import { AgentAdapter } from "../types.mjs";
-import { AnyOperationSpec } from "@contractspec/lib.contracts";
-import { AgentPrompt, ImplementationPlan } from "@contractspec/lib.contracts/llm";
-
-//#region src/services/agent-guide/adapters/cursor-cli.d.ts
-/**
- * Cursor CLI adapter implementation.
- * Optimized for Cursor's background/composer mode.
- */
-declare class CursorCLIAdapter implements AgentAdapter {
-  agentType: "cursor-cli";
-  /**
-   * Format an implementation plan for Cursor CLI.
-   * Uses concise format optimized for Cursor's context window.
-   */
-  formatPlan(plan: ImplementationPlan): AgentPrompt;
-  /**
-   * Generate Cursor rules (.mdc format) for a spec.
-   * Can be saved to .cursor/rules/ to provide persistent context.
-   */
-  generateConfig(spec: AnyOperationSpec): string;
-  /**
-   * Generate a cursor rules file path for a spec.
-   */
-  getCursorRulesPath(spec: AnyOperationSpec): string;
-  /**
-   * Parse Cursor output to extract generated code.
-   */
-  parseOutput(output: string): {
-    code?: string;
-    errors?: string[];
-  };
-}
-/** Singleton instance */
-declare const cursorCLIAdapter: CursorCLIAdapter;
-//#endregion
-export { CursorCLIAdapter, cursorCLIAdapter };
-//# sourceMappingURL=cursor-cli.d.mts.map

package/dist/services/agent-guide/adapters/cursor-cli.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cursor-cli.d.mts","names":[],"sources":["../../../../src/services/agent-guide/adapters/cursor-cli.ts"],"mappings":";;;;;;;;;cAmBa,gBAAA,YAA4B,YAAA;EACvC,SAAA;EADuC;;;;EAOvC,UAAA,CAAW,IAAA,EAAM,kBAAA,GAAqB,WAAA;EAAA;;;;EAoEtC,cAAA,CAAe,IAAA,EAAM,gBAAA;EA+FI;;;EAAzB,kBAAA,CAAmB,IAAA,EAAM,gBAAA;EAQM;;;EAA/B,WAAA,CAAY,MAAA;IAAmB,IAAA;IAAe,MAAA;EAAA;AAAA;;cAgBnC,gBAAA,EAAgB,gBAAA"}

package/dist/services/agent-guide/adapters/cursor-cli.mjs

@@ -1,135 +0,0 @@
-import { AGENT_SYSTEM_PROMPTS } from "@contractspec/lib.contracts/llm";
-
-//#region src/services/agent-guide/adapters/cursor-cli.ts
-/**
-* Cursor CLI adapter implementation.
-* Optimized for Cursor's background/composer mode.
-*/
-var CursorCLIAdapter = class {
-	agentType = "cursor-cli";
-	/**
-	* Format an implementation plan for Cursor CLI.
-	* Uses concise format optimized for Cursor's context window.
-	*/
-	formatPlan(plan) {
-		const lines = [];
-		lines.push(`# ${plan.target.key}.v${plan.target.version}`);
-		lines.push("");
-		lines.push(`> ${plan.context.goal}`);
-		lines.push("");
-		if (plan.fileStructure.length > 0) {
-			lines.push("## Files");
-			lines.push("");
-			for (const file of plan.fileStructure) lines.push(`- ${file.type}: \`${file.path}\` - ${file.purpose}`);
-			lines.push("");
-		}
-		lines.push("## Spec");
-		lines.push("");
-		lines.push(plan.specMarkdown);
-		lines.push("");
-		lines.push("## Steps");
-		lines.push("");
-		for (const step of plan.steps) lines.push(`${step.order}. **${step.title}**: ${step.description}`);
-		lines.push("");
-		const constraints = [...plan.constraints.policy, ...plan.constraints.security.map((s) => `⚠️ ${s}`)];
-		if (constraints.length > 0) {
-			lines.push("## Constraints");
-			lines.push("");
-			for (const c of constraints) lines.push(`- ${c}`);
-			lines.push("");
-		}
-		if (plan.constraints.pii.length > 0) {
-			lines.push("## PII Fields");
-			lines.push("");
-			lines.push(`Handle carefully: ${plan.constraints.pii.map((p) => `\`${p}\``).join(", ")}`);
-			lines.push("");
-		}
-		return {
-			agent: "cursor-cli",
-			systemPrompt: AGENT_SYSTEM_PROMPTS["cursor-cli"],
-			taskPrompt: lines.join("\n")
-		};
-	}
-	/**
-	* Generate Cursor rules (.mdc format) for a spec.
-	* Can be saved to .cursor/rules/ to provide persistent context.
-	*/
-	generateConfig(spec) {
-		const m = spec.meta;
-		const lines = [];
-		lines.push("---");
-		lines.push(`description: Implementation rules for ${m.key}.v${m.version}`);
-		lines.push(`globs: ["**/${m.key.replace(/\./g, "/")}/**"]`);
-		lines.push("alwaysApply: false");
-		lines.push("---");
-		lines.push("");
-		lines.push(`# ${m.key} Implementation Rules`);
-		lines.push("");
-		lines.push(`This ${m.kind} operation must follow the ContractSpec specification.`);
-		lines.push("");
-		lines.push("## Goal");
-		lines.push("");
-		lines.push(m.goal);
-		lines.push("");
-		lines.push("## Requirements");
-		lines.push("");
-		lines.push("1. Input/output types MUST match the spec schema exactly");
-		lines.push("2. All error cases MUST be handled");
-		if (spec.sideEffects?.emits?.length) lines.push("3. Events MUST be emitted as specified");
-		lines.push(`4. Auth level: ${spec.policy.auth}`);
-		if (spec.policy.idempotent !== void 0) lines.push(`5. Idempotency: ${spec.policy.idempotent}`);
-		lines.push("");
-		if (spec.io.errors && Object.keys(spec.io.errors).length > 0) {
-			lines.push("## Error Cases");
-			lines.push("");
-			for (const [code, err] of Object.entries(spec.io.errors)) lines.push(`- \`${code}\` (HTTP ${err.http ?? 400}): ${err.when}`);
-			lines.push("");
-		}
-		if (spec.sideEffects?.emits?.length) {
-			lines.push("## Events to Emit");
-			lines.push("");
-			for (const e of spec.sideEffects.emits) if ("ref" in e) lines.push(`- \`${e.ref.key}.v${e.ref.version}\`: ${e.when}`);
-			else lines.push(`- \`${e.key}.v${e.version}\`: ${e.when}`);
-			lines.push("");
-		}
-		if (spec.policy.pii?.length) {
-			lines.push("## PII Handling");
-			lines.push("");
-			lines.push("These fields contain PII and must be handled with care:");
-			for (const field of spec.policy.pii) lines.push(`- \`${field}\``);
-			lines.push("");
-		}
-		if (spec.acceptance?.scenarios?.length) {
-			lines.push("## Acceptance Scenarios");
-			lines.push("");
-			for (const s of spec.acceptance.scenarios) {
-				lines.push(`### ${s.key}`);
-				lines.push(`- Given: ${s.given.join("; ")}`);
-				lines.push(`- When: ${s.when.join("; ")}`);
-				lines.push(`- Then: ${s.then.join("; ")}`);
-				lines.push("");
-			}
-		}
-		return lines.join("\n");
-	}
-	/**
-	* Generate a cursor rules file path for a spec.
-	*/
-	getCursorRulesPath(spec) {
-		return `.cursor/rules/${spec.meta.key.replace(/\./g, "-")}.mdc`;
-	}
-	/**
-	* Parse Cursor output to extract generated code.
-	*/
-	parseOutput(output) {
-		const codeBlockMatch = output.match(/```(?:typescript|ts|tsx|javascript|js)?\n([\s\S]*?)\n```/);
-		if (codeBlockMatch?.[1]) return { code: codeBlockMatch[1] };
-		return { code: output };
-	}
-};
-/** Singleton instance */
-const cursorCLIAdapter = new CursorCLIAdapter();
-
-//#endregion
-export { CursorCLIAdapter, cursorCLIAdapter };
-//# sourceMappingURL=cursor-cli.mjs.map

package/dist/services/agent-guide/adapters/cursor-cli.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"cursor-cli.mjs","names":[],"sources":["../../../../src/services/agent-guide/adapters/cursor-cli.ts"],"sourcesContent":["/**\n * Cursor CLI Agent Adapter\n *\n * Formats implementation plans and prompts for Cursor's CLI/background mode.\n * Can also generate .mdc cursor rules files.\n */\n\nimport type { AnyOperationSpec } from '@contractspec/lib.contracts';\nimport type {\n  AgentPrompt,\n  ImplementationPlan,\n} from '@contractspec/lib.contracts/llm';\nimport { AGENT_SYSTEM_PROMPTS } from '@contractspec/lib.contracts/llm';\nimport type { AgentAdapter } from '../types';\n\n/**\n * Cursor CLI adapter implementation.\n * Optimized for Cursor's background/composer mode.\n */\nexport class CursorCLIAdapter implements AgentAdapter {\n  agentType = 'cursor-cli' as const;\n\n  /**\n   * Format an implementation plan for Cursor CLI.\n   * Uses concise format optimized for Cursor's context window.\n   */\n  formatPlan(plan: ImplementationPlan): AgentPrompt {\n    const lines: string[] = [];\n\n    // Compact header\n    lines.push(`# ${plan.target.key}.v${plan.target.version}`);\n    lines.push('');\n    lines.push(`> ${plan.context.goal}`);\n    lines.push('');\n\n    // Files to work on\n    if (plan.fileStructure.length > 0) {\n      lines.push('## Files');\n      lines.push('');\n      for (const file of plan.fileStructure) {\n        lines.push(`- ${file.type}: \\`${file.path}\\` - ${file.purpose}`);\n      }\n      lines.push('');\n    }\n\n    // Compact spec (key sections only)\n    lines.push('## Spec');\n    lines.push('');\n    lines.push(plan.specMarkdown);\n    lines.push('');\n\n    // Steps as simple list\n    lines.push('## Steps');\n    lines.push('');\n    for (const step of plan.steps) {\n      lines.push(`${step.order}. **${step.title}**: ${step.description}`);\n    }\n    lines.push('');\n\n    // Key constraints (compact)\n    const constraints = [\n      ...plan.constraints.policy,\n      ...plan.constraints.security.map((s) => `⚠️ ${s}`),\n    ];\n    if (constraints.length > 0) {\n      lines.push('## Constraints');\n      lines.push('');\n      for (const c of constraints) {\n        lines.push(`- ${c}`);\n      }\n      lines.push('');\n    }\n\n    // PII warning\n    if (plan.constraints.pii.length > 0) {\n      lines.push('## PII Fields');\n      lines.push('');\n      lines.push(\n        `Handle carefully: ${plan.constraints.pii.map((p) => `\\`${p}\\``).join(', ')}`\n      );\n      lines.push('');\n    }\n\n    return {\n      agent: 'cursor-cli',\n      systemPrompt: AGENT_SYSTEM_PROMPTS['cursor-cli'],\n      taskPrompt: lines.join('\\n'),\n    };\n  }\n\n  /**\n   * Generate Cursor rules (.mdc format) for a spec.\n   * Can be saved to .cursor/rules/ to provide persistent context.\n   */\n  generateConfig(spec: AnyOperationSpec): string {\n    const m = spec.meta;\n    const lines: string[] = [];\n\n    // MDC frontmatter\n    lines.push('---');\n    lines.push(`description: Implementation rules for ${m.key}.v${m.version}`);\n    lines.push(`globs: [\"**/${m.key.replace(/\\./g, '/')}/**\"]`);\n    lines.push('alwaysApply: false');\n    lines.push('---');\n    lines.push('');\n\n    // Rule content\n    lines.push(`# ${m.key} Implementation Rules`);\n    lines.push('');\n    lines.push(\n      `This ${m.kind} operation must follow the ContractSpec specification.`\n    );\n    lines.push('');\n\n    lines.push('## Goal');\n    lines.push('');\n    lines.push(m.goal);\n    lines.push('');\n\n    lines.push('## Requirements');\n    lines.push('');\n    lines.push('1. Input/output types MUST match the spec schema exactly');\n    lines.push('2. All error cases MUST be handled');\n\n    if (spec.sideEffects?.emits?.length) {\n      lines.push('3. Events MUST be emitted as specified');\n    }\n\n    lines.push(`4. Auth level: ${spec.policy.auth}`);\n\n    if (spec.policy.idempotent !== undefined) {\n      lines.push(`5. Idempotency: ${spec.policy.idempotent}`);\n    }\n    lines.push('');\n\n    // Error handling\n    if (spec.io.errors && Object.keys(spec.io.errors).length > 0) {\n      lines.push('## Error Cases');\n      lines.push('');\n      for (const [code, err] of Object.entries(spec.io.errors)) {\n        lines.push(`- \\`${code}\\` (HTTP ${err.http ?? 400}): ${err.when}`);\n      }\n      lines.push('');\n    }\n\n    // Events\n    if (spec.sideEffects?.emits?.length) {\n      lines.push('## Events to Emit');\n      lines.push('');\n      for (const e of spec.sideEffects.emits) {\n        if ('ref' in e) {\n          lines.push(`- \\`${e.ref.key}.v${e.ref.version}\\`: ${e.when}`);\n        } else {\n          lines.push(`- \\`${e.key}.v${e.version}\\`: ${e.when}`);\n        }\n      }\n      lines.push('');\n    }\n\n    // PII\n    if (spec.policy.pii?.length) {\n      lines.push('## PII Handling');\n      lines.push('');\n      lines.push('These fields contain PII and must be handled with care:');\n      for (const field of spec.policy.pii) {\n        lines.push(`- \\`${field}\\``);\n      }\n      lines.push('');\n    }\n\n    // Acceptance scenarios\n    if (spec.acceptance?.scenarios?.length) {\n      lines.push('## Acceptance Scenarios');\n      lines.push('');\n      for (const s of spec.acceptance.scenarios) {\n        lines.push(`### ${s.key}`);\n        lines.push(`- Given: ${s.given.join('; ')}`);\n        lines.push(`- When: ${s.when.join('; ')}`);\n        lines.push(`- Then: ${s.then.join('; ')}`);\n        lines.push('');\n      }\n    }\n\n    return lines.join('\\n');\n  }\n\n  /**\n   * Generate a cursor rules file path for a spec.\n   */\n  getCursorRulesPath(spec: AnyOperationSpec): string {\n    const safeName = spec.meta.key.replace(/\\./g, '-');\n    return `.cursor/rules/${safeName}.mdc`;\n  }\n\n  /**\n   * Parse Cursor output to extract generated code.\n   */\n  parseOutput(output: string): { code?: string; errors?: string[] } {\n    // Cursor typically returns code in markdown blocks\n    const codeBlockMatch = output.match(\n      /```(?:typescript|ts|tsx|javascript|js)?\\n([\\s\\S]*?)\\n```/\n    );\n\n    if (codeBlockMatch?.[1]) {\n      return { code: codeBlockMatch[1] };\n    }\n\n    // Return raw output if no code block\n    return { code: output };\n  }\n}\n\n/** Singleton instance */\nexport const cursorCLIAdapter = new CursorCLIAdapter();\n"],"mappings":"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"}

package/dist/services/agent-guide/adapters/generic-mcp.d.mts

@@ -1,52 +0,0 @@
-import { AgentAdapter } from "../types.mjs";
-import { AnyOperationSpec } from "@contractspec/lib.contracts";
-import { AgentPrompt, ImplementationPlan } from "@contractspec/lib.contracts/llm";
-
-//#region src/services/agent-guide/adapters/generic-mcp.d.ts
-/**
- * Generic MCP adapter implementation.
- * Works with any MCP-compatible agent (Cline, Aider, etc.).
- */
-declare class GenericMCPAdapter implements AgentAdapter {
-  agentType: "generic-mcp";
-  /**
-   * Format an implementation plan for generic MCP agents.
-   * Uses a standard markdown format that works across different agents.
-   */
-  formatPlan(plan: ImplementationPlan): AgentPrompt;
-  /**
-   * Format the plan as an MCP resource.
-   * Returns JSON that can be served as an MCP resource.
-   */
-  formatAsResource(plan: ImplementationPlan): {
-    uri: string;
-    mimeType: string;
-    data: string;
-  };
-  /**
-   * Format the plan as an MCP prompt message.
-   */
-  formatAsPromptMessage(plan: ImplementationPlan): {
-    role: 'user' | 'assistant';
-    content: {
-      type: 'text';
-      text: string;
-    };
-  };
-  /**
-   * Generate configuration (generic markdown for any agent).
-   */
-  generateConfig(spec: AnyOperationSpec): string;
-  /**
-   * Parse agent output - generic implementation.
-   */
-  parseOutput(output: string): {
-    code?: string;
-    errors?: string[];
-  };
-}
-/** Singleton instance */
-declare const genericMCPAdapter: GenericMCPAdapter;
-//#endregion
-export { GenericMCPAdapter, genericMCPAdapter };
-//# sourceMappingURL=generic-mcp.d.mts.map

package/dist/services/agent-guide/adapters/generic-mcp.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"generic-mcp.d.mts","names":[],"sources":["../../../../src/services/agent-guide/adapters/generic-mcp.ts"],"mappings":";;;;;;;;;cAmBa,iBAAA,YAA6B,YAAA;EACxC,SAAA;EADoD;;;;EAOpD,UAAA,CAAW,IAAA,EAAM,kBAAA,GAAqB,WAAA;EAA3B;;;;EAoHX,gBAAA,CAAiB,IAAA,EAAM,kBAAA;IACrB,GAAA;IACA,QAAA;IACA,IAAA;EAAA;EAuB0B;;;EAA5B,qBAAA,CAAsB,IAAA,EAAM,kBAAA;IAC1B,IAAA;IACA,OAAA;MAAW,IAAA;MAAc,IAAA;IAAA;EAAA;EAuCf;;;EAxBZ,cAAA,CAAe,IAAA,EAAM,gBAAA;EAwB+B;AAgCtD;;EAhCE,WAAA,CAAY,MAAA;IAAmB,IAAA;IAAe,MAAA;EAAA;AAAA;;cAgCnC,iBAAA,EAAiB,iBAAA"}

package/dist/services/agent-guide/adapters/generic-mcp.mjs

@@ -1,159 +0,0 @@
-import { AGENT_SYSTEM_PROMPTS } from "@contractspec/lib.contracts/llm";
-
-//#region src/services/agent-guide/adapters/generic-mcp.ts
-/**
-* Generic MCP adapter implementation.
-* Works with any MCP-compatible agent (Cline, Aider, etc.).
-*/
-var GenericMCPAdapter = class {
-	agentType = "generic-mcp";
-	/**
-	* Format an implementation plan for generic MCP agents.
-	* Uses a standard markdown format that works across different agents.
-	*/
-	formatPlan(plan) {
-		const lines = [];
-		lines.push(`# Implementation Task: ${plan.target.key}.v${plan.target.version}`);
-		lines.push("");
-		lines.push("## Task");
-		lines.push("");
-		lines.push(`Implement the ${plan.target.type} \`${plan.target.key}\` version ${plan.target.version}.`);
-		lines.push("");
-		lines.push("## Context");
-		lines.push("");
-		lines.push(`**Goal:** ${plan.context.goal}`);
-		lines.push("");
-		lines.push(`**Description:** ${plan.context.description}`);
-		lines.push("");
-		if (plan.context.background) {
-			lines.push("**Background:**");
-			lines.push("");
-			lines.push(plan.context.background);
-			lines.push("");
-		}
-		lines.push("## Specification");
-		lines.push("");
-		lines.push(plan.specMarkdown);
-		lines.push("");
-		if (plan.fileStructure.length > 0) {
-			lines.push("## Files");
-			lines.push("");
-			lines.push("| Path | Action | Purpose |");
-			lines.push("|------|--------|---------|");
-			for (const file of plan.fileStructure) lines.push(`| \`${file.path}\` | ${file.type} | ${file.purpose} |`);
-			lines.push("");
-		}
-		lines.push("## Implementation Steps");
-		lines.push("");
-		for (const step of plan.steps) {
-			lines.push(`### Step ${step.order}: ${step.title}`);
-			lines.push("");
-			lines.push(step.description);
-			lines.push("");
-			if (step.acceptanceCriteria.length > 0) {
-				lines.push("**Acceptance Criteria:**");
-				lines.push("");
-				for (const criteria of step.acceptanceCriteria) lines.push(`- ${criteria}`);
-				lines.push("");
-			}
-		}
-		lines.push("## Constraints");
-		lines.push("");
-		if (plan.constraints.policy.length > 0) {
-			lines.push("**Policy:**");
-			for (const p of plan.constraints.policy) lines.push(`- ${p}`);
-			lines.push("");
-		}
-		if (plan.constraints.security.length > 0) {
-			lines.push("**Security:**");
-			for (const s of plan.constraints.security) lines.push(`- ${s}`);
-			lines.push("");
-		}
-		if (plan.constraints.pii.length > 0) {
-			lines.push("**PII Fields (handle with care):**");
-			for (const pii of plan.constraints.pii) lines.push(`- \`${pii}\``);
-			lines.push("");
-		}
-		lines.push("## Verification");
-		lines.push("");
-		lines.push("After implementation, verify:");
-		lines.push("");
-		for (const check of plan.verificationChecklist) lines.push(`- [ ] ${check}`);
-		lines.push("");
-		return {
-			agent: "generic-mcp",
-			systemPrompt: AGENT_SYSTEM_PROMPTS["generic-mcp"],
-			taskPrompt: lines.join("\n")
-		};
-	}
-	/**
-	* Format the plan as an MCP resource.
-	* Returns JSON that can be served as an MCP resource.
-	*/
-	formatAsResource(plan) {
-		return {
-			uri: `spec://${plan.target.key}/v${plan.target.version}/plan`,
-			mimeType: "application/json",
-			data: JSON.stringify({
-				target: plan.target,
-				context: plan.context,
-				fileStructure: plan.fileStructure,
-				steps: plan.steps,
-				constraints: plan.constraints,
-				verificationChecklist: plan.verificationChecklist
-			}, null, 2)
-		};
-	}
-	/**
-	* Format the plan as an MCP prompt message.
-	*/
-	formatAsPromptMessage(plan) {
-		return {
-			role: "user",
-			content: {
-				type: "text",
-				text: this.formatPlan(plan).taskPrompt
-			}
-		};
-	}
-	/**
-	* Generate configuration (generic markdown for any agent).
-	*/
-	generateConfig(spec) {
-		const m = spec.meta;
-		const lines = [];
-		lines.push(`# ${m.key} v${m.version}`);
-		lines.push("");
-		lines.push(`**Type:** ${m.kind}`);
-		lines.push(`**Stability:** ${m.stability}`);
-		lines.push("");
-		lines.push("## Goal");
-		lines.push("");
-		lines.push(m.goal);
-		lines.push("");
-		lines.push("## Description");
-		lines.push("");
-		lines.push(m.description);
-		lines.push("");
-		return lines.join("\n");
-	}
-	/**
-	* Parse agent output - generic implementation.
-	*/
-	parseOutput(output) {
-		const codeBlockMatch = output.match(/```(?:typescript|ts|tsx|javascript|js|python|go|rust)?\n([\s\S]*?)\n```/);
-		if (codeBlockMatch?.[1]) return { code: codeBlockMatch[1] };
-		try {
-			const parsed = JSON.parse(output);
-			if (typeof parsed.code === "string") return { code: parsed.code };
-			if (typeof parsed.errors === "object") return { errors: Array.isArray(parsed.errors) ? parsed.errors : [String(parsed.errors)] };
-		} catch {}
-		return { code: output };
-	}
-};
-/** Singleton instance */
-const genericMCPAdapter = new GenericMCPAdapter();
-
-//#endregion
-export { GenericMCPAdapter, genericMCPAdapter };
-//# sourceMappingURL=generic-mcp.mjs.map

package/dist/services/agent-guide/adapters/generic-mcp.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"generic-mcp.mjs","names":[],"sources":["../../../../src/services/agent-guide/adapters/generic-mcp.ts"],"sourcesContent":["/**\n * Generic MCP Agent Adapter\n *\n * Formats implementation plans and prompts for any MCP-compatible agent.\n * Uses standard MCP resource/prompt/tool patterns.\n */\n\nimport type { AnyOperationSpec } from '@contractspec/lib.contracts';\nimport type {\n  AgentPrompt,\n  ImplementationPlan,\n} from '@contractspec/lib.contracts/llm';\nimport { AGENT_SYSTEM_PROMPTS } from '@contractspec/lib.contracts/llm';\nimport type { AgentAdapter } from '../types';\n\n/**\n * Generic MCP adapter implementation.\n * Works with any MCP-compatible agent (Cline, Aider, etc.).\n */\nexport class GenericMCPAdapter implements AgentAdapter {\n  agentType = 'generic-mcp' as const;\n\n  /**\n   * Format an implementation plan for generic MCP agents.\n   * Uses a standard markdown format that works across different agents.\n   */\n  formatPlan(plan: ImplementationPlan): AgentPrompt {\n    const lines: string[] = [];\n\n    // Standard header\n    lines.push(\n      `# Implementation Task: ${plan.target.key}.v${plan.target.version}`\n    );\n    lines.push('');\n\n    // Task description\n    lines.push('## Task');\n    lines.push('');\n    lines.push(\n      `Implement the ${plan.target.type} \\`${plan.target.key}\\` version ${plan.target.version}.`\n    );\n    lines.push('');\n\n    // Context\n    lines.push('## Context');\n    lines.push('');\n    lines.push(`**Goal:** ${plan.context.goal}`);\n    lines.push('');\n    lines.push(`**Description:** ${plan.context.description}`);\n    lines.push('');\n    if (plan.context.background) {\n      lines.push('**Background:**');\n      lines.push('');\n      lines.push(plan.context.background);\n      lines.push('');\n    }\n\n    // Specification\n    lines.push('## Specification');\n    lines.push('');\n    lines.push(plan.specMarkdown);\n    lines.push('');\n\n    // Files\n    if (plan.fileStructure.length > 0) {\n      lines.push('## Files');\n      lines.push('');\n      lines.push('| Path | Action | Purpose |');\n      lines.push('|------|--------|---------|');\n      for (const file of plan.fileStructure) {\n        lines.push(`| \\`${file.path}\\` | ${file.type} | ${file.purpose} |`);\n      }\n      lines.push('');\n    }\n\n    // Steps\n    lines.push('## Implementation Steps');\n    lines.push('');\n    for (const step of plan.steps) {\n      lines.push(`### Step ${step.order}: ${step.title}`);\n      lines.push('');\n      lines.push(step.description);\n      lines.push('');\n      if (step.acceptanceCriteria.length > 0) {\n        lines.push('**Acceptance Criteria:**');\n        lines.push('');\n        for (const criteria of step.acceptanceCriteria) {\n          lines.push(`- ${criteria}`);\n        }\n        lines.push('');\n      }\n    }\n\n    // Constraints\n    lines.push('## Constraints');\n    lines.push('');\n\n    if (plan.constraints.policy.length > 0) {\n      lines.push('**Policy:**');\n      for (const p of plan.constraints.policy) {\n        lines.push(`- ${p}`);\n      }\n      lines.push('');\n    }\n\n    if (plan.constraints.security.length > 0) {\n      lines.push('**Security:**');\n      for (const s of plan.constraints.security) {\n        lines.push(`- ${s}`);\n      }\n      lines.push('');\n    }\n\n    if (plan.constraints.pii.length > 0) {\n      lines.push('**PII Fields (handle with care):**');\n      for (const pii of plan.constraints.pii) {\n        lines.push(`- \\`${pii}\\``);\n      }\n      lines.push('');\n    }\n\n    // Verification\n    lines.push('## Verification');\n    lines.push('');\n    lines.push('After implementation, verify:');\n    lines.push('');\n    for (const check of plan.verificationChecklist) {\n      lines.push(`- [ ] ${check}`);\n    }\n    lines.push('');\n\n    return {\n      agent: 'generic-mcp',\n      systemPrompt: AGENT_SYSTEM_PROMPTS['generic-mcp'],\n      taskPrompt: lines.join('\\n'),\n    };\n  }\n\n  /**\n   * Format the plan as an MCP resource.\n   * Returns JSON that can be served as an MCP resource.\n   */\n  formatAsResource(plan: ImplementationPlan): {\n    uri: string;\n    mimeType: string;\n    data: string;\n  } {\n    return {\n      uri: `spec://${plan.target.key}/v${plan.target.version}/plan`,\n      mimeType: 'application/json',\n      data: JSON.stringify(\n        {\n          target: plan.target,\n          context: plan.context,\n          fileStructure: plan.fileStructure,\n          steps: plan.steps,\n          constraints: plan.constraints,\n          verificationChecklist: plan.verificationChecklist,\n        },\n        null,\n        2\n      ),\n    };\n  }\n\n  /**\n   * Format the plan as an MCP prompt message.\n   */\n  formatAsPromptMessage(plan: ImplementationPlan): {\n    role: 'user' | 'assistant';\n    content: { type: 'text'; text: string };\n  } {\n    const prompt = this.formatPlan(plan);\n    return {\n      role: 'user',\n      content: {\n        type: 'text',\n        text: prompt.taskPrompt,\n      },\n    };\n  }\n\n  /**\n   * Generate configuration (generic markdown for any agent).\n   */\n  generateConfig(spec: AnyOperationSpec): string {\n    const m = spec.meta;\n    const lines: string[] = [];\n\n    lines.push(`# ${m.key} v${m.version}`);\n    lines.push('');\n    lines.push(`**Type:** ${m.kind}`);\n    lines.push(`**Stability:** ${m.stability}`);\n    lines.push('');\n    lines.push('## Goal');\n    lines.push('');\n    lines.push(m.goal);\n    lines.push('');\n    lines.push('## Description');\n    lines.push('');\n    lines.push(m.description);\n    lines.push('');\n\n    return lines.join('\\n');\n  }\n\n  /**\n   * Parse agent output - generic implementation.\n   */\n  parseOutput(output: string): { code?: string; errors?: string[] } {\n    // Try to extract code from markdown code blocks\n    const codeBlockMatch = output.match(\n      /```(?:typescript|ts|tsx|javascript|js|python|go|rust)?\\n([\\s\\S]*?)\\n```/\n    );\n\n    if (codeBlockMatch?.[1]) {\n      return { code: codeBlockMatch[1] };\n    }\n\n    // Check for JSON output\n    try {\n      const parsed = JSON.parse(output);\n      if (typeof parsed.code === 'string') {\n        return { code: parsed.code };\n      }\n      if (typeof parsed.errors === 'object') {\n        return {\n          errors: Array.isArray(parsed.errors)\n            ? parsed.errors\n            : [String(parsed.errors)],\n        };\n      }\n    } catch {\n      // Not JSON, return as-is\n    }\n\n    return { code: output };\n  }\n}\n\n/** Singleton instance */\nexport const genericMCPAdapter = new GenericMCPAdapter();\n"],"mappings":"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"}

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

@@ -1,22 +0,0 @@
-import { AgentAdapter } from "../types.mjs";
-import { ClaudeCodeAdapter, claudeCodeAdapter } from "./claude-code.mjs";
-import { CursorCLIAdapter, cursorCLIAdapter } from "./cursor-cli.mjs";
-import { GenericMCPAdapter, genericMCPAdapter } from "./generic-mcp.mjs";
-import { AgentType } from "@contractspec/lib.contracts/llm";
-
-//#region src/services/agent-guide/adapters/index.d.ts
-/**
- * Registry of all available agent adapters.
- */
-declare const agentAdapters: Record<AgentType, AgentAdapter>;
-/**
- * Get an adapter for a specific agent type.
- */
-declare function getAgentAdapter(agent: AgentType): AgentAdapter;
-/**
- * List all available agent types.
- */
-declare function listAgentTypes(): AgentType[];
-//#endregion
-export { agentAdapters, getAgentAdapter, listAgentTypes };
-//# sourceMappingURL=index.d.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/agent-guide/adapters/index.ts"],"mappings":";;;;;;;;;;cAoBa,aAAA,EAAe,MAAA,CAAO,SAAA,EAAW,YAAA;;;;iBAS9B,eAAA,CAAgB,KAAA,EAAO,SAAA,GAAY,YAAA;;AAAnD;;iBAWgB,cAAA,CAAA,GAAkB,SAAA"}