@contractspec/bundle.workspace 1.46.2 → 1.47.0

package/dist/ai/agents/claude-code-agent.mjs

@@ -0,0 +1,182 @@
+import { anthropic } from "@ai-sdk/anthropic";
+import { generateText } from "ai";
+
+//#region src/ai/agents/claude-code-agent.ts
+/**
+* Claude Code Agent - Uses Anthropic's advanced code capabilities
+* with extended context and agentic workflows
+*/
+var ClaudeCodeAgent = class {
+	name = "claude-code";
+	apiKey;
+	constructor() {
+		this.apiKey = process.env.ANTHROPIC_API_KEY;
+	}
+	canHandle(_task) {
+		return !!this.apiKey;
+	}
+	async generate(task) {
+		if (!this.apiKey) return {
+			success: false,
+			errors: ["ANTHROPIC_API_KEY not set. Claude Code agent requires API access."]
+		};
+		try {
+			const model = anthropic("claude-3-7-sonnet-20250219");
+			const systemPrompt = this.buildSystemPrompt(task);
+			const result = await generateText({
+				model,
+				prompt: this.buildUserPrompt(task),
+				system: systemPrompt,
+				temperature: .2
+			});
+			return {
+				success: true,
+				code: this.extractCode(result.text),
+				metadata: {
+					model: "claude-3-7-sonnet",
+					agentMode: "claude-code",
+					usage: result.usage
+				}
+			};
+		} catch (error) {
+			return {
+				success: false,
+				errors: [error instanceof Error ? error.message : String(error)]
+			};
+		}
+	}
+	async validate(task) {
+		if (!this.apiKey) return {
+			success: false,
+			errors: ["ANTHROPIC_API_KEY not set"]
+		};
+		try {
+			const result = await generateText({
+				model: anthropic("claude-3-7-sonnet-20250219"),
+				prompt: `
+You are an expert code reviewer. Carefully analyze this implementation against its specification.
+
+SPECIFICATION:
+\`\`\`typescript
+${task.specCode}
+\`\`\`
+
+IMPLEMENTATION:
+\`\`\`typescript
+${task.existingCode || "// No implementation provided"}
+\`\`\`
+
+Provide a structured validation report:
+
+## Compliance
+- Does the implementation fulfill all requirements in the spec?
+- Are all inputs/outputs correctly typed?
+
+## Code Quality
+- Are there any bugs or potential issues?
+- Is error handling adequate?
+- Are best practices followed?
+
+## Suggestions
+- What improvements would you recommend?
+- Are there any missing edge cases?
+
+Be thorough and precise. Use a critical but constructive tone.
+`,
+				system: "You are a senior software engineer performing a critical code review.",
+				temperature: .3
+			});
+			const hasErrors = this.detectIssues(result.text);
+			return {
+				success: !hasErrors,
+				code: result.text,
+				errors: hasErrors ? this.extractErrors(result.text) : [],
+				warnings: this.extractWarnings(result.text),
+				suggestions: this.extractSuggestions(result.text),
+				metadata: {
+					agentMode: "claude-code",
+					validationType: "comprehensive"
+				}
+			};
+		} catch (error) {
+			return {
+				success: false,
+				errors: [error instanceof Error ? error.message : String(error)]
+			};
+		}
+	}
+	buildSystemPrompt(task) {
+		const basePrompt = `You are an expert TypeScript developer specializing in contract-driven development.
+
+Your code is:
+- Type-safe with comprehensive TypeScript types
+- Well-documented with JSDoc comments
+- Production-ready with proper error handling
+- Following SOLID principles and best practices
+- Modular and testable
+
+Generate clean, idiomatic TypeScript code that exactly matches the specification.`;
+		if (task.type === "test") return basePrompt + "\n\nYou are also an expert in testing. Write comprehensive tests using Vitest.";
+		return basePrompt;
+	}
+	buildUserPrompt(task) {
+		const prompts = {
+			generate: `Generate a complete, production-ready implementation for this specification:\n\n${task.specCode}\n\nProvide ONLY the TypeScript code, no explanations.`,
+			test: `Generate comprehensive tests for this code:\n\nSpec:\n${task.specCode}\n\nImplementation:\n${task.existingCode}\n\nProvide complete Vitest test suite.`,
+			refactor: `Refactor this code while preserving functionality:\n\n${task.existingCode}\n\nSpec:\n${task.specCode}`,
+			validate: `Validate this implementation:\n\nSpec:\n${task.specCode}\n\nCode:\n${task.existingCode}`
+		};
+		return prompts[task.type] || prompts.generate;
+	}
+	extractCode(text) {
+		const codeBlockMatch = text.match(/```(?:typescript|ts|tsx)?\n([\s\S]*?)\n```/);
+		if (codeBlockMatch && codeBlockMatch[1]) return codeBlockMatch[1];
+		return text;
+	}
+	detectIssues(reviewText) {
+		const errorIndicators = [
+			"missing",
+			"incorrect",
+			"bug",
+			"error",
+			"violation",
+			"does not",
+			"fails to",
+			"not implemented",
+			"critical"
+		];
+		const lowerText = reviewText.toLowerCase();
+		return errorIndicators.some((indicator) => lowerText.includes(indicator));
+	}
+	extractErrors(text) {
+		const errors = [];
+		const lines = text.split("\n");
+		for (const line of lines) {
+			const lower = line.toLowerCase();
+			if (lower.includes("error") || lower.includes("bug") || lower.includes("incorrect") || lower.includes("missing")) errors.push(line.trim());
+		}
+		return errors.length > 0 ? errors : ["Code review identified issues"];
+	}
+	extractWarnings(text) {
+		const warnings = [];
+		const lines = text.split("\n");
+		for (const line of lines) {
+			const lower = line.toLowerCase();
+			if (lower.includes("warning") || lower.includes("should") || lower.includes("consider")) warnings.push(line.trim());
+		}
+		return warnings;
+	}
+	extractSuggestions(text) {
+		const suggestions = [];
+		const lines = text.split("\n");
+		for (const line of lines) {
+			const lower = line.toLowerCase();
+			if (lower.includes("suggest") || lower.includes("recommend") || lower.includes("could") || lower.includes("improvement")) suggestions.push(line.trim());
+		}
+		return suggestions;
+	}
+};
+
+//#endregion
+export { ClaudeCodeAgent };
+//# sourceMappingURL=claude-code-agent.mjs.map

package/dist/ai/agents/claude-code-agent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-agent.mjs","names":[],"sources":["../../../src/ai/agents/claude-code-agent.ts"],"sourcesContent":["/**\n * Claude Code Agent - Uses Anthropic's advanced code capabilities\n * with extended context and agentic workflows\n */\n\nimport { anthropic } from '@ai-sdk/anthropic';\nimport { generateText } from 'ai';\nimport type { AgentProvider, AgentResult, AgentTask } from './types';\n\nexport class ClaudeCodeAgent implements AgentProvider {\n  name = 'claude-code' as const;\n  private apiKey: string | undefined;\n\n  constructor() {\n    this.apiKey = process.env.ANTHROPIC_API_KEY;\n  }\n\n  canHandle(_task: AgentTask): boolean {\n    return !!this.apiKey;\n  }\n\n  async generate(task: AgentTask): Promise<AgentResult> {\n    if (!this.apiKey) {\n      return {\n        success: false,\n        errors: [\n          'ANTHROPIC_API_KEY not set. Claude Code agent requires API access.',\n        ],\n      };\n    }\n\n    try {\n      // Use Claude with extended thinking and code-optimized prompts\n      const model = anthropic('claude-3-7-sonnet-20250219');\n\n      const systemPrompt = this.buildSystemPrompt(task);\n      const userPrompt = this.buildUserPrompt(task);\n\n      const result = await generateText({\n        model,\n        prompt: userPrompt,\n        system: systemPrompt,\n        temperature: 0.2, // Lower temperature for more deterministic code\n      });\n\n      // Extract code from response (Claude may wrap in markdown)\n      const code = this.extractCode(result.text);\n\n      return {\n        success: true,\n        code,\n        metadata: {\n          model: 'claude-3-7-sonnet',\n          agentMode: 'claude-code',\n          usage: result.usage,\n        },\n      };\n    } catch (error) {\n      return {\n        success: false,\n        errors: [error instanceof Error ? error.message : String(error)],\n      };\n    }\n  }\n\n  async validate(task: AgentTask): Promise<AgentResult> {\n    if (!this.apiKey) {\n      return {\n        success: false,\n        errors: ['ANTHROPIC_API_KEY not set'],\n      };\n    }\n\n    try {\n      const model = anthropic('claude-3-7-sonnet-20250219');\n\n      const prompt = `\nYou are an expert code reviewer. Carefully analyze this implementation against its specification.\n\nSPECIFICATION:\n\\`\\`\\`typescript\n${task.specCode}\n\\`\\`\\`\n\nIMPLEMENTATION:\n\\`\\`\\`typescript\n${task.existingCode || '// No implementation provided'}\n\\`\\`\\`\n\nProvide a structured validation report:\n\n## Compliance\n- Does the implementation fulfill all requirements in the spec?\n- Are all inputs/outputs correctly typed?\n\n## Code Quality\n- Are there any bugs or potential issues?\n- Is error handling adequate?\n- Are best practices followed?\n\n## Suggestions\n- What improvements would you recommend?\n- Are there any missing edge cases?\n\nBe thorough and precise. Use a critical but constructive tone.\n`;\n\n      const result = await generateText({\n        model,\n        prompt,\n        system:\n          'You are a senior software engineer performing a critical code review.',\n        temperature: 0.3,\n      });\n\n      // Analyze the review for issues\n      const hasErrors = this.detectIssues(result.text);\n\n      return {\n        success: !hasErrors,\n        code: result.text,\n        errors: hasErrors ? this.extractErrors(result.text) : [],\n        warnings: this.extractWarnings(result.text),\n        suggestions: this.extractSuggestions(result.text),\n        metadata: {\n          agentMode: 'claude-code',\n          validationType: 'comprehensive',\n        },\n      };\n    } catch (error) {\n      return {\n        success: false,\n        errors: [error instanceof Error ? error.message : String(error)],\n      };\n    }\n  }\n\n  private buildSystemPrompt(task: AgentTask): string {\n    const basePrompt = `You are an expert TypeScript developer specializing in contract-driven development.\n\nYour code is:\n- Type-safe with comprehensive TypeScript types\n- Well-documented with JSDoc comments\n- Production-ready with proper error handling\n- Following SOLID principles and best practices\n- Modular and testable\n\nGenerate clean, idiomatic TypeScript code that exactly matches the specification.`;\n\n    if (task.type === 'test') {\n      return (\n        basePrompt +\n        '\\n\\nYou are also an expert in testing. Write comprehensive tests using Vitest.'\n      );\n    }\n\n    return basePrompt;\n  }\n\n  private buildUserPrompt(task: AgentTask): string {\n    const prompts = {\n      generate: `Generate a complete, production-ready implementation for this specification:\\n\\n${task.specCode}\\n\\nProvide ONLY the TypeScript code, no explanations.`,\n      test: `Generate comprehensive tests for this code:\\n\\nSpec:\\n${task.specCode}\\n\\nImplementation:\\n${task.existingCode}\\n\\nProvide complete Vitest test suite.`,\n      refactor: `Refactor this code while preserving functionality:\\n\\n${task.existingCode}\\n\\nSpec:\\n${task.specCode}`,\n      validate: `Validate this implementation:\\n\\nSpec:\\n${task.specCode}\\n\\nCode:\\n${task.existingCode}`,\n    };\n\n    return prompts[task.type] || prompts.generate;\n  }\n\n  private extractCode(text: string): string {\n    // Extract code from markdown code blocks\n    const codeBlockMatch = text.match(\n      /```(?:typescript|ts|tsx)?\\n([\\s\\S]*?)\\n```/\n    );\n    if (codeBlockMatch && codeBlockMatch[1]) {\n      return codeBlockMatch[1];\n    }\n    return text;\n  }\n\n  private detectIssues(reviewText: string): boolean {\n    const errorIndicators = [\n      'missing',\n      'incorrect',\n      'bug',\n      'error',\n      'violation',\n      'does not',\n      'fails to',\n      'not implemented',\n      'critical',\n    ];\n\n    const lowerText = reviewText.toLowerCase();\n    return errorIndicators.some((indicator) => lowerText.includes(indicator));\n  }\n\n  private extractErrors(text: string): string[] {\n    const errors: string[] = [];\n    const lines = text.split('\\n');\n\n    for (const line of lines) {\n      const lower = line.toLowerCase();\n      if (\n        lower.includes('error') ||\n        lower.includes('bug') ||\n        lower.includes('incorrect') ||\n        lower.includes('missing')\n      ) {\n        errors.push(line.trim());\n      }\n    }\n\n    return errors.length > 0 ? errors : ['Code review identified issues'];\n  }\n\n  private extractWarnings(text: string): string[] {\n    const warnings: string[] = [];\n    const lines = text.split('\\n');\n\n    for (const line of lines) {\n      const lower = line.toLowerCase();\n      if (\n        lower.includes('warning') ||\n        lower.includes('should') ||\n        lower.includes('consider')\n      ) {\n        warnings.push(line.trim());\n      }\n    }\n\n    return warnings;\n  }\n\n  private extractSuggestions(text: string): string[] {\n    const suggestions: string[] = [];\n    const lines = text.split('\\n');\n\n    for (const line of lines) {\n      const lower = line.toLowerCase();\n      if (\n        lower.includes('suggest') ||\n        lower.includes('recommend') ||\n        lower.includes('could') ||\n        lower.includes('improvement')\n      ) {\n        suggestions.push(line.trim());\n      }\n    }\n\n    return suggestions;\n  }\n}\n"],"mappings":"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"}

package/dist/ai/agents/cursor-agent.d.mts

@@ -0,0 +1,68 @@
+import { AgentProvider, AgentResult, AgentTask } from "./types.mjs";
+
+//#region src/ai/agents/cursor-agent.d.ts
+
+declare class CursorAgent implements AgentProvider {
+  name: "cursor";
+  private cursorPath;
+  private isWindsurf;
+  private composerPort;
+  constructor();
+  canHandle(_task: AgentTask): boolean;
+  generate(task: AgentTask): Promise<AgentResult>;
+  validate(task: AgentTask): Promise<AgentResult>;
+  /**
+   * Detect if running in Cursor/Windsurf environment
+   */
+  private detectEnvironment;
+  /**
+   * Execute task using the best available method
+   */
+  private executeWithBestMethod;
+  /**
+   * Use Windsurf's native API
+   */
+  /**
+   * Use Cursor Composer API
+   */
+  /**
+   * Use Cursor CLI directly
+   */
+  private useCursorCLI;
+  /**
+   * File-based approach - create workspace and instructions for manual completion
+   */
+  private useFileBasedApproach;
+  /**
+   * Setup workspace for validation
+   */
+  private setupValidationWorkspace;
+  /**
+   * Prepare files for API submission
+   */
+  private prepareFilesForAPI;
+  /**
+   * Build detailed prompt for cursor
+   */
+  private buildDetailedPrompt;
+  /**
+   * Build validation-specific prompt
+   */
+  private buildValidationPrompt;
+  /**
+   * Generate basic template for task
+   */
+  private generateTemplate;
+  /**
+   * Cleanup temporary work directory
+   */
+  private cleanupWorkDir;
+  private isCursorAvailable;
+  /**
+   * Check if Cursor Composer API might be available
+   */
+  private hasComposerAPI;
+}
+//#endregion
+export { CursorAgent };
+//# sourceMappingURL=cursor-agent.d.mts.map

package/dist/ai/agents/cursor-agent.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-agent.d.mts","names":[],"sources":["../../../src/ai/agents/cursor-agent.ts"],"sourcesContent":[],"mappings":";;;;AA2BuB,cAfV,WAAA,YAAuB,aAeb,CAAA;EAAoB,IAAA,EAAA,QAAA;EAAR,QAAA,UAAA;EAmBZ,QAAA,UAAA;EAAoB,QAAA,YAAA;EAAR,WAAA,CAAA;EAlCC,SAAA,CAAA,KAAA,EAWjB,SAXiB,CAAA,EAAA,OAAA;EAAa,QAAA,CAAA,IAAA,EAe1B,SAf0B,CAAA,EAed,OAfc,CAeN,WAfM,CAAA;iBAkC1B,YAAY,QAAQ"}