@devness/coverit 0.1.0

package/dist/ai/prompts.js

@@ -0,0 +1,259 @@
+/**
+ * Prompt Templates for AI-Powered Test Generation
+ *
+ * These prompts combine AST analysis context with structured LLM
+ * instructions to produce high-quality, runnable test files.
+ * Each prompt is designed to be provider-agnostic — they work
+ * identically whether sent to Claude, GPT, or a local model.
+ */
+/**
+ * Build the message array for generating tests from source code
+ * and AST analysis results. The system message establishes the
+ * persona and hard constraints; the user message provides all
+ * the context needed to write tests.
+ */
+export function buildTestGenerationPrompt(params) {
+    const { sourceCode, scanResult, testType, framework, existingTests, projectContext, } = params;
+    const systemPrompt = buildSystemPrompt(framework);
+    const userPrompt = buildUserPrompt(sourceCode, scanResult, testType, framework, existingTests, projectContext);
+    return [
+        { role: "system", content: systemPrompt },
+        { role: "user", content: userPrompt },
+    ];
+}
+function buildSystemPrompt(framework) {
+    return `You are an expert test engineer specializing in writing thorough, maintainable test suites.
+
+FRAMEWORK: ${framework}
+
+HARD RULES — follow these exactly:
+1. Output ONLY the complete test file content. No markdown fences, no explanations, no commentary.
+2. Write meaningful assertions that verify behavior. Never write trivial assertions like \`toBeDefined()\` or \`toBeTruthy()\` as the sole check for a test case.
+3. Do NOT mock standard library modules (node:crypto, node:fs, node:path, etc.) unless you are specifically testing an error path that requires it.
+4. Test behavior and public contracts, not implementation details. If a refactor would break the test but not the behavior, the test is wrong.
+5. Each test case must have a clear, descriptive name that explains what behavior it verifies.
+6. Group related tests using \`describe\` blocks that mirror the module's structure.
+7. Include setup/teardown where needed, but keep tests isolated from each other.
+8. Use realistic test data, not meaningless strings like "foo" and "bar".
+9. Prefer \`toEqual\` for deep equality, \`toBe\` for primitives and references, \`toThrow\` for errors.
+10. Handle async code correctly — always await promises and use proper async test patterns.`;
+}
+function buildUserPrompt(sourceCode, scanResult, testType, framework, existingTests, projectContext) {
+    const sections = [];
+    // Project context (optional)
+    if (projectContext) {
+        sections.push(`## Project Context\n${projectContext}`);
+    }
+    // Source code
+    sections.push(`## Source Code (${scanResult.file})\n\`\`\`${scanResult.language}\n${sourceCode}\n\`\`\``);
+    // AST analysis — give the LLM structured insight into the code
+    sections.push(`## Code Analysis (AST Scan Result)\n\`\`\`json\n${JSON.stringify(formatScanResult(scanResult), null, 2)}\n\`\`\``);
+    // Test type instructions
+    sections.push(`## Test Type: ${testType}\n${getTestTypeInstructions(testType, framework)}`);
+    // Existing tests to avoid duplication
+    if (existingTests && existingTests.length > 0) {
+        sections.push(`## Existing Test Files (do NOT duplicate these)\nThe following test files already exist for this module. Do not re-test anything they already cover.\n\n${existingTests.map((t) => `- ${t}`).join("\n")}`);
+    }
+    // Import guidance based on framework
+    sections.push(`## Import Instructions\n${getImportInstructions(framework, scanResult)}`);
+    return sections.join("\n\n");
+}
+/**
+ * Format the scan result for prompt inclusion — strip noise and
+ * keep only the fields the LLM needs to reason about test targets.
+ */
+function formatScanResult(scanResult) {
+    return {
+        file: scanResult.file,
+        language: scanResult.language,
+        fileType: scanResult.fileType,
+        exports: scanResult.exports.map((e) => ({
+            name: e.name,
+            kind: e.kind,
+            isDefault: e.isDefault,
+        })),
+        functions: scanResult.functions.map((f) => ({
+            name: f.name,
+            params: f.params.map((p) => ({
+                name: p.name,
+                type: p.type,
+                isOptional: p.isOptional,
+            })),
+            returnType: f.returnType,
+            isAsync: f.isAsync,
+            isExported: f.isExported,
+            complexity: f.complexity,
+        })),
+        classes: scanResult.classes.map((c) => ({
+            name: c.name,
+            methods: c.methods.map((m) => ({
+                name: m.name,
+                params: m.params.length,
+                isAsync: m.isAsync,
+            })),
+            isExported: c.isExported,
+        })),
+        endpoints: scanResult.endpoints.map((e) => ({
+            method: e.method,
+            path: e.path,
+            handler: e.handler,
+            middleware: e.middleware,
+        })),
+        components: scanResult.components.map((c) => ({
+            name: c.name,
+            props: c.props.map((p) => ({
+                name: p.name,
+                type: p.type,
+                isOptional: p.isOptional,
+            })),
+            hooks: c.hooks,
+            isPage: c.isPage,
+        })),
+    };
+}
+function getTestTypeInstructions(testType, framework) {
+    switch (testType) {
+        case "unit":
+            return `Write unit tests for each exported function and class.
+
+For each function/method, cover:
+- Happy path with typical inputs
+- Edge cases (empty strings, zero, null/undefined where applicable, boundary values)
+- Error cases (invalid input, thrown exceptions)
+- Return value correctness
+
+For classes, test:
+- Construction with valid and invalid arguments
+- Each public method independently
+- State transitions and side effects`;
+        case "integration":
+            return `Write integration tests that verify how multiple modules work together.
+
+Focus on:
+- Data flow between functions/services
+- Database or external service interactions (mock at the boundary)
+- Error propagation across module boundaries
+- Real-world usage scenarios that exercise multiple code paths`;
+        case "api":
+            return `Write API endpoint tests for each route.
+
+For each endpoint, test:
+- Successful request with valid payload (2xx response)
+- Validation failures with invalid/missing fields (4xx response)
+- Authentication/authorization errors if middleware is present
+- Correct response shape and status codes
+- Edge cases in request parameters
+
+Use ${framework === "vitest" || framework === "jest" ? "supertest or the framework's test client" : "the appropriate HTTP test client"} to make requests.`;
+        case "e2e-browser":
+            return `Write end-to-end browser tests using ${framework === "playwright" ? "Playwright" : framework === "cypress" ? "Cypress" : "the browser test framework"}.
+
+Test complete user flows:
+- Page navigation and URL verification
+- Form filling, submission, and validation feedback
+- Button clicks, modal interactions, and dynamic content
+- Loading states and error states
+- Responsive behavior if applicable
+
+Use realistic user actions — click, type, navigate — not internal API calls.`;
+        case "e2e-mobile":
+            return `Write mobile end-to-end tests.
+
+Test:
+- Screen rendering and layout
+- Navigation between screens (stack, tab, drawer)
+- Touch gestures (tap, swipe, long press)
+- Form inputs and keyboard interactions
+- Platform-specific behavior where relevant`;
+        case "e2e-desktop":
+            return `Write desktop application end-to-end tests.
+
+Test:
+- Window creation and management
+- Tauri commands and IPC communication
+- Menu interactions and keyboard shortcuts
+- File system operations through the app
+- Native dialog interactions
+- Window state (minimize, maximize, close)`;
+        case "snapshot":
+            return `Write snapshot tests for the component/module output.
+
+- Capture rendered output or serialized state
+- Cover different prop/input combinations
+- Include edge cases that affect rendering
+- Each snapshot should have a descriptive test name`;
+        case "performance":
+            return `Write performance benchmark tests.
+
+- Measure execution time for key operations
+- Set reasonable performance budgets
+- Test with realistic data sizes
+- Compare against baseline expectations
+- Use ${framework}'s timing utilities or performance.now()`;
+    }
+}
+function getImportInstructions(framework, scanResult) {
+    const sourceFile = scanResult.file;
+    // Compute a relative import path assuming the test file is co-located
+    // or in a __tests__ directory adjacent to the source
+    const importPath = `./${sourceFile.split("/").pop()?.replace(/\.(ts|tsx|js|jsx)$/, "")}`;
+    const lines = [];
+    switch (framework) {
+        case "vitest":
+            lines.push(`Import test utilities from "vitest": { describe, it, expect, vi, beforeEach, afterEach }`, `Import the module under test from "${importPath}" using relative path.`);
+            break;
+        case "jest":
+            lines.push(`Use global Jest functions: describe, it, expect, jest, beforeEach, afterEach`, `Import the module under test from "${importPath}" using relative path.`);
+            break;
+        case "playwright":
+            lines.push(`Import from "@playwright/test": { test, expect }`, `Use test.describe for grouping, test() for individual tests.`);
+            break;
+        case "cypress":
+            lines.push(`Use global Cypress functions: describe, it, cy`, `Use cy.visit(), cy.get(), cy.contains() for interactions.`);
+            break;
+        default:
+            lines.push(`Import the module under test from "${importPath}".`, `Use the standard testing imports for ${framework}.`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Build the message array for refining tests that failed.
+ * This is used in the feedback loop: generate -> run -> failures -> refine -> run again.
+ */
+export function buildTestRefinementPrompt(params) {
+    const { testCode, failures, sourceCode } = params;
+    const systemPrompt = `You are an expert test engineer fixing failing tests.
+
+HARD RULES:
+1. Output ONLY the complete, corrected test file. No markdown fences, no explanations.
+2. Fix the failing tests based on the error messages and stack traces provided.
+3. Do NOT remove tests that fail — fix them so they pass against the actual source code behavior.
+4. If a test assumption was wrong (the code behaves differently than expected), update the test to match the actual behavior.
+5. If a test was testing the right thing but had an implementation error (wrong import, typo, incorrect assertion syntax), fix the implementation error.
+6. Preserve all passing tests exactly as they are.
+7. Do NOT add new tests — only fix the failing ones.`;
+    const failureDetails = failures
+        .map((f, i) => {
+        const parts = [`### Failure ${i + 1}: ${f.testName}`, `Message: ${f.message}`];
+        if (f.expected)
+            parts.push(`Expected: ${f.expected}`);
+        if (f.actual)
+            parts.push(`Actual: ${f.actual}`);
+        if (f.stack)
+            parts.push(`Stack:\n${f.stack}`);
+        return parts.join("\n");
+    })
+        .join("\n\n");
+    const userPrompt = `## Failing Test File\n\`\`\`\n${testCode}\n\`\`\`
+
+## Test Failures\n${failureDetails}
+
+## Original Source Code Being Tested\n\`\`\`\n${sourceCode}\n\`\`\`
+
+Fix the failing tests so they pass against the source code above. Output the complete corrected test file.`;
+    return [
+        { role: "system", content: systemPrompt },
+        { role: "user", content: userPrompt },
+    ];
+}
+//# sourceMappingURL=prompts.js.map

package/dist/ai/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/ai/prompts.ts"],"names":[],"mappings":"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"}

package/dist/ai/provider-factory.d.ts

@@ -0,0 +1,26 @@
+/**
+ * AI Provider Factory
+ *
+ * Creates the appropriate AI provider based on explicit config or
+ * auto-detection. Detection order reflects cost/convenience tradeoffs:
+ *
+ *   1. Claude CLI  -- free if user has Pro/Max subscription
+ *   2. Anthropic   -- best quality, requires API key
+ *   3. OpenAI      -- widely available, requires API key
+ *   4. Ollama      -- free & local, but quality varies by model
+ *
+ * The COVERIT_AI_PROVIDER env var can override auto-detection.
+ */
+import type { AIProvider, AIProviderConfig } from "./types.js";
+/**
+ * Create a provider from an explicit configuration.
+ * Throws if the specified provider is not available.
+ */
+export declare function createAIProvider(config?: AIProviderConfig): Promise<AIProvider>;
+/**
+ * Auto-detect the best available AI provider by probing each one
+ * in priority order. Prefers providers that are free or already
+ * configured.
+ */
+export declare function detectBestProvider(): Promise<AIProvider>;
+//# sourceMappingURL=provider-factory.d.ts.map

package/dist/ai/provider-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.d.ts","sourceRoot":"","sources":["../../src/ai/provider-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AAM/E;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAgBrB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,UAAU,CAAC,CA6C9D"}

package/dist/ai/provider-factory.js

@@ -0,0 +1,111 @@
+/**
+ * AI Provider Factory
+ *
+ * Creates the appropriate AI provider based on explicit config or
+ * auto-detection. Detection order reflects cost/convenience tradeoffs:
+ *
+ *   1. Claude CLI  -- free if user has Pro/Max subscription
+ *   2. Anthropic   -- best quality, requires API key
+ *   3. OpenAI      -- widely available, requires API key
+ *   4. Ollama      -- free & local, but quality varies by model
+ *
+ * The COVERIT_AI_PROVIDER env var can override auto-detection.
+ */
+import { ClaudeCliProvider } from "./claude-cli-provider.js";
+import { AnthropicProvider } from "./anthropic-provider.js";
+import { OpenAIProvider } from "./openai-provider.js";
+import { OllamaProvider } from "./ollama-provider.js";
+/**
+ * Create a provider from an explicit configuration.
+ * Throws if the specified provider is not available.
+ */
+export async function createAIProvider(config) {
+    // If no config, fall through to auto-detection
+    if (!config) {
+        return detectBestProvider();
+    }
+    const provider = buildProvider(config.provider, config);
+    const available = await provider.isAvailable();
+    if (!available) {
+        throw new Error(`AI provider "${config.provider}" is not available. ${getProviderHint(config.provider)}`);
+    }
+    return provider;
+}
+/**
+ * Auto-detect the best available AI provider by probing each one
+ * in priority order. Prefers providers that are free or already
+ * configured.
+ */
+export async function detectBestProvider() {
+    // Allow env var to force a specific provider
+    const envProvider = process.env["COVERIT_AI_PROVIDER"];
+    if (envProvider) {
+        const provider = buildProvider(envProvider);
+        const available = await provider.isAvailable();
+        if (available)
+            return provider;
+        throw new Error(`COVERIT_AI_PROVIDER is set to "${envProvider}" but it is not available. ${getProviderHint(envProvider)}`);
+    }
+    // Probe providers in priority order
+    const candidates = [
+        new ClaudeCliProvider(),
+        new AnthropicProvider(),
+        new OpenAIProvider(),
+        new OllamaProvider(),
+    ];
+    for (const candidate of candidates) {
+        const available = await candidate.isAvailable();
+        if (available)
+            return candidate;
+    }
+    throw new Error([
+        "No AI provider available. Configure one of the following:",
+        "",
+        "  1. Install Claude Code CLI (uses your Pro/Max subscription):",
+        "     https://docs.anthropic.com/en/docs/claude-code",
+        "",
+        "  2. Set ANTHROPIC_API_KEY for Anthropic API access",
+        "",
+        "  3. Set OPENAI_API_KEY for OpenAI API access",
+        "",
+        "  4. Run Ollama locally: https://ollama.com",
+        "",
+        "Or set COVERIT_AI_PROVIDER to force a specific provider.",
+    ].join("\n"));
+}
+/** Instantiate a provider by type without checking availability */
+function buildProvider(type, config) {
+    switch (type) {
+        case "claude-cli":
+            return new ClaudeCliProvider(config);
+        case "anthropic":
+            return new AnthropicProvider(config);
+        case "openai":
+            return new OpenAIProvider(config);
+        case "ollama":
+            return new OllamaProvider(config);
+        case "openai-compatible":
+            return new OpenAIProvider({ ...config, provider: "openai-compatible" });
+        default: {
+            const _exhaustive = type;
+            throw new Error(`Unknown AI provider type: ${_exhaustive}`);
+        }
+    }
+}
+/** Return a setup hint for a specific provider */
+function getProviderHint(type) {
+    switch (type) {
+        case "claude-cli":
+            return "Install Claude Code: https://docs.anthropic.com/en/docs/claude-code";
+        case "anthropic":
+            return "Set the ANTHROPIC_API_KEY environment variable.";
+        case "openai":
+        case "openai-compatible":
+            return "Set the OPENAI_API_KEY environment variable.";
+        case "ollama":
+            return "Start Ollama: ollama serve";
+        default:
+            return "";
+    }
+}
+//# sourceMappingURL=provider-factory.js.map

package/dist/ai/provider-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.js","sourceRoot":"","sources":["../../src/ai/provider-factory.ts"],"names":[],"mappings":"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"}

package/dist/ai/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * AI Provider Types
+ *
+ * Defines the contract for all AI providers used in CLI mode.
+ * When running as an MCP server inside Claude Code, Claude IS the AI
+ * and none of these providers are used. This layer exists solely for
+ * standalone CLI usage where we need to call an LLM directly.
+ */
+export type AIProviderType = "claude-cli" | "anthropic" | "openai" | "ollama" | "openai-compatible";
+export interface AIProviderConfig {
+    provider: AIProviderType;
+    model?: string;
+    apiKey?: string;
+    /** Base URL override for ollama or openai-compatible endpoints */
+    baseUrl?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+export interface AIMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+export interface AIResponse {
+    content: string;
+    model: string;
+    tokensUsed?: number;
+}
+export interface AIGenerateOptions {
+    maxTokens?: number;
+    temperature?: number;
+}
+export interface AIProvider {
+    readonly name: string;
+    generate(messages: AIMessage[], options?: AIGenerateOptions): Promise<AIResponse>;
+    isAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ai/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,cAAc,GACtB,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,mBAAmB,CAAC;AAExB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CACN,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC"}

package/dist/ai/types.js

@@ -0,0 +1,10 @@
+/**
+ * AI Provider Types
+ *
+ * Defines the contract for all AI providers used in CLI mode.
+ * When running as an MCP server inside Claude Code, Claude IS the AI
+ * and none of these providers are used. This layer exists solely for
+ * standalone CLI usage where we need to call an LLM directly.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ai/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/analysis/code-scanner.d.ts

@@ -0,0 +1,9 @@
+import type { CodeScanResult } from "../types/index.js";
+/**
+ * Perform AST-level code analysis on a TypeScript/JavaScript file.
+ *
+ * @param filePath - Absolute path to the source file
+ * @param projectRoot - Absolute path to the project root (for relative path computation)
+ */
+export declare function scanCode(filePath: string, projectRoot: string): Promise<CodeScanResult>;
+//# sourceMappingURL=code-scanner.d.ts.map

package/dist/analysis/code-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-scanner.d.ts","sourceRoot":"","sources":["../../src/analysis/code-scanner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EAWf,MAAM,mBAAmB,CAAC;AAmb3B;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC,CA2BzB"}