pcl-mcp 0.2.4 → 0.3.0

package/dist/benchmarks/evaluators/structured-judge.js

@@ -0,0 +1,153 @@
+const JUDGE_MODEL = "claude-sonnet-4-20250514";
+/**
+ * Build structured yes/no questions from task criteria and context.
+ */
+function buildQuestions(task, contextDocs) {
+    const questions = [];
+    for (const criterion of task.evaluationCriteria) {
+        if (criterion.prompt) {
+            questions.push(criterion.prompt);
+        }
+        else if (criterion.pattern) {
+            questions.push(`Does the code contain or implement: ${criterion.criterion}?`);
+        }
+        else {
+            questions.push(`Does the code satisfy: ${criterion.criterion}?`);
+        }
+    }
+    // Add forbidden pattern checks
+    for (const pattern of task.forbiddenPatterns) {
+        questions.push(`Does the code AVOID the forbidden pattern: ${pattern}? (YES means it correctly avoids it)`);
+    }
+    return questions;
+}
+/**
+ * Evaluate an AI-generated output against structured criteria.
+ */
+export async function structuredJudge(client, task, output, contextDocs) {
+    const questions = buildQuestions(task, contextDocs);
+    const questionsBlock = questions
+        .map((q, i) => `Q${i + 1}: ${q}`)
+        .join("\n");
+    const prompt = `You are evaluating an AI coding agent's output against specific product requirements.
+
+TASK DESCRIPTION:
+${task.description}
+
+RELEVANT PRODUCT CONTEXT:
+${contextDocs.slice(0, 8000)}
+
+AI AGENT'S CODE OUTPUT:
+${output.slice(0, 12000)}
+
+EVALUATION QUESTIONS:
+${questionsBlock}
+
+For each question, answer with:
+- "YES" if the code clearly satisfies the criterion
+- "NO" if the code clearly fails the criterion
+- "PARTIAL" if partially satisfied
+
+Return a JSON array with one object per question:
+[{"answer": "YES"|"NO"|"PARTIAL", "reasoning": "brief explanation"}]
+
+Return ONLY the JSON array, no other text.`;
+    const response = await client.messages.create({
+        model: JUDGE_MODEL,
+        max_tokens: 2048,
+        temperature: 0,
+        system: "You are a precise code evaluation judge. Return only valid JSON arrays.",
+        messages: [{ role: "user", content: prompt }],
+    });
+    const text = response.content[0]?.type === "text" ? response.content[0].text : "[]";
+    let answers;
+    try {
+        answers = JSON.parse(text);
+    }
+    catch {
+        // Fallback: try to extract JSON from text
+        const match = text.match(/\[[\s\S]*\]/);
+        if (match) {
+            try {
+                answers = JSON.parse(match[0]);
+            }
+            catch {
+                answers = [];
+            }
+        }
+        else {
+            answers = [];
+        }
+    }
+    const details = questions.map((q, i) => {
+        const a = answers[i];
+        const answer = (a?.answer?.toUpperCase() ?? "NO");
+        return {
+            criterion: q,
+            answer: answer === "YES" || answer === "NO" || answer === "PARTIAL"
+                ? answer
+                : "NO",
+            reasoning: a?.reasoning ?? "No response from judge",
+        };
+    });
+    const yesCount = details.reduce((sum, d) => {
+        if (d.answer === "YES")
+            return sum + 1;
+        if (d.answer === "PARTIAL")
+            return sum + 0.5;
+        return sum;
+    }, 0);
+    const totalQuestions = details.length;
+    const score = totalQuestions > 0 ? (yesCount / totalQuestions) * 10 : 0;
+    return {
+        taskId: task.id,
+        totalQuestions,
+        yesCount,
+        score: Math.round(score * 10) / 10,
+        details,
+    };
+}
+/**
+ * Check if generated code contains valid TypeScript/JSX syntax.
+ * Uses the TypeScript compiler API in syntax-only mode for accurate parsing
+ * of template literals, JSX, and other complex syntax.
+ */
+export function checkTypeScriptSyntax(output) {
+    // Extract fenced code blocks
+    const codeBlockRegex = /```(?:typescript|tsx?|jsx?|js)?\s*\n([\s\S]*?)```/g;
+    const blocks = [];
+    let match;
+    while ((match = codeBlockRegex.exec(output)) !== null) {
+        if (match[1]?.trim())
+            blocks.push(match[1]);
+    }
+    if (blocks.length === 0) {
+        return { valid: true, errorCount: 0, codeBlockCount: 0 };
+    }
+    let totalErrors = 0;
+    // Dynamic import of typescript — may not be available in all environments
+    let ts;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        ts = require("typescript");
+    }
+    catch {
+        // TypeScript not available — fall back to permissive (assume valid)
+        return { valid: true, errorCount: 0, codeBlockCount: blocks.length };
+    }
+    for (const block of blocks) {
+        // Parse as TSX to handle both TypeScript and JSX syntax
+        const sourceFile = ts.createSourceFile("check.tsx", block, ts.ScriptTarget.Latest, false, ts.ScriptKind.TSX);
+        // Count syntax-level diagnostics only (not semantic/type errors)
+        // parseDiagnostics is internal; access via type assertion
+        const syntaxDiags = (sourceFile
+            .parseDiagnostics?.length) ?? 0;
+        totalErrors += syntaxDiags;
+    }
+    return {
+        valid: totalErrors === 0,
+        errorCount: totalErrors,
+        codeBlockCount: blocks.length,
+    };
+}
+//# sourceMappingURL=structured-judge.js.map

package/dist/benchmarks/evaluators/structured-judge.js.map

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

package/dist/benchmarks/evaluators/token-counter.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Count tokens in a string using cl100k_base (Claude/GPT-4 tokenizer).
+ */
+export declare function countTokens(text: string): number;
+/**
+ * Dispose the encoder to free memory.
+ */
+export declare function disposeEncoder(): void;
+//# sourceMappingURL=token-counter.d.ts.map

package/dist/benchmarks/evaluators/token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../../../benchmarks/evaluators/token-counter.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAKrC"}

package/dist/benchmarks/evaluators/token-counter.js

@@ -0,0 +1,24 @@
+import { get_encoding } from "tiktoken";
+let _encoder = null;
+function getEncoder() {
+    if (!_encoder) {
+        _encoder = get_encoding("cl100k_base");
+    }
+    return _encoder;
+}
+/**
+ * Count tokens in a string using cl100k_base (Claude/GPT-4 tokenizer).
+ */
+export function countTokens(text) {
+    return getEncoder().encode(text).length;
+}
+/**
+ * Dispose the encoder to free memory.
+ */
+export function disposeEncoder() {
+    if (_encoder) {
+        _encoder.free();
+        _encoder = null;
+    }
+}
+//# sourceMappingURL=token-counter.js.map

package/dist/benchmarks/evaluators/token-counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.js","sourceRoot":"","sources":["../../../benchmarks/evaluators/token-counter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiB,MAAM,UAAU,CAAC;AAEvD,IAAI,QAAQ,GAAoB,IAAI,CAAC;AAErC,SAAS,UAAU;IACjB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,UAAU,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChB,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/benchmarks/generators/generate-corpus.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generate-corpus.d.ts.map

package/dist/benchmarks/generators/generate-corpus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-corpus.d.ts","sourceRoot":"","sources":["../../../benchmarks/generators/generate-corpus.ts"],"names":[],"mappings":""}

package/dist/benchmarks/generators/generate-corpus.js

@@ -0,0 +1,243 @@
+/**
+ * Corpus generator — expands corpus-small into medium (50), large (100), xlarge (500).
+ * Uses deterministic seeding for reproducibility.
+ */
+import { mkdir, writeFile, cp } from "node:fs/promises";
+import { join } from "node:path";
+const FIXTURES_DIR = join(import.meta.dirname, "..", "fixtures");
+// Simple seeded PRNG (mulberry32)
+function createRNG(seed) {
+    return () => {
+        seed |= 0;
+        seed = (seed + 0x6d2b79f5) | 0;
+        let t = Math.imul(seed ^ (seed >>> 15), 1 | seed);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+const PERSONA_NAMES = [
+    { name: "Maya", role: "UX Researcher", goal: "Validate designs with real users" },
+    { name: "Jordan", role: "DevOps Engineer", goal: "Keep infrastructure reliable" },
+    { name: "Priya", role: "Product Owner", goal: "Maximize business value per sprint" },
+    { name: "Marcus", role: "QA Lead", goal: "Catch bugs before they reach production" },
+    { name: "Elena", role: "Data Analyst", goal: "Turn data into actionable insights" },
+    { name: "Tomás", role: "Frontend Developer", goal: "Build pixel-perfect responsive UIs" },
+    { name: "Kenji", role: "Backend Architect", goal: "Design scalable API systems" },
+    { name: "Fatima", role: "Scrum Master", goal: "Remove blockers for the team" },
+    { name: "Oscar", role: "Security Engineer", goal: "Protect user data and prevent breaches" },
+    { name: "Li Wei", role: "Mobile Developer", goal: "Deliver smooth native app experiences" },
+];
+const SPEC_TOPICS = [
+    "Time Tracking Widget", "Invoice Generator", "Client Portal", "File Attachments",
+    "Task Dependencies", "Gantt Chart View", "Resource Allocation", "Budget Tracker",
+    "Custom Fields", "Recurring Tasks", "Email Integration", "Calendar Sync",
+    "Milestone Tracking", "Approval Workflows", "Template Library", "API Webhooks",
+    "Bulk Operations", "Dark Mode", "Offline Support", "Export to PDF",
+    "Team Chat", "Activity Feed", "Custom Reports", "Sprint Planning",
+    "Workload View", "Time Zone Support", "Multi-language", "Search & Filter",
+];
+const DECISION_TOPICS = [
+    "Use Tailwind CSS for styling",
+    "Adopt Zod for runtime validation",
+    "Choose PostgreSQL over MongoDB",
+    "Use React Server Components",
+    "Implement RBAC with Supabase RLS",
+    "Deploy on Vercel Edge",
+    "Use Resend for transactional emails",
+    "Adopt pnpm over npm",
+    "Use Vitest for testing",
+    "Implement feature flags with PostHog",
+];
+const DOMAIN_RULES = [
+    { title: "Password Policy", critical: false },
+    { title: "File Upload Limits", critical: false },
+    { title: "Workspace Naming Rules", critical: false },
+    { title: "API Versioning Policy", critical: false },
+    { title: "Accessibility Requirements", critical: true },
+    { title: "Internationalization Rules", critical: false },
+    { title: "Error Handling Standards", critical: false },
+    { title: "Logging and Monitoring Policy", critical: true },
+    { title: "Third-Party Integration Rules", critical: false },
+    { title: "Performance Budgets", critical: false },
+];
+function generatePersona(index, rng) {
+    const p = PERSONA_NAMES[index % PERSONA_NAMES.length];
+    const id = p.name.toLowerCase().replace(/\s+/g, "-");
+    const techLevel = ["beginner", "intermediate", "advanced"][Math.floor(rng() * 3)];
+    return `---
+id: "${id}"
+name: "${p.name}"
+role: "${p.role}"
+tech_level: "${techLevel}"
+primary_goal: "${p.goal}"
+jobs_to_be_done:
+  - "Complete daily work efficiently"
+  - "Collaborate with team members"
+  - "Track progress on deliverables"
+anti_patterns:
+  - "Avoids tools that require excessive configuration"
+  - "Ignores features hidden behind multiple clicks"
+channels:
+  - "desktop"
+  - "email"
+---
+
+## Background
+
+${p.name} is a ${p.role} with ${Math.floor(rng() * 10 + 2)} years of experience. Their primary focus is to ${p.goal.toLowerCase()}. They work in a fast-paced environment where context switching is common and tools need to be intuitive and fast.
+
+## Key Behaviors
+
+${p.name} typically starts the day by reviewing their task list and prioritizing based on urgency and impact. They prefer tools that surface the most important information first without requiring manual sorting or filtering. Keyboard shortcuts are appreciated but not required.
+
+## Pain Points
+
+The biggest frustration for ${p.name} is when tools slow down their workflow rather than accelerating it. They have abandoned previous tools that required too much upfront configuration or that cluttered the interface with features they did not use. Simplicity and speed are more important than feature completeness.
+`;
+}
+function generateSpec(index, rng) {
+    const topic = SPEC_TOPICS[index % SPEC_TOPICS.length];
+    const id = topic.toLowerCase().replace(/\s+/g, "-");
+    const statuses = ["draft", "in-progress", "approved", "implemented"];
+    const status = statuses[Math.floor(rng() * statuses.length)];
+    return `---
+id: "${id}"
+title: "${topic}"
+status: "${status}"
+acceptance_criteria:
+  - "Feature must be fully functional on desktop and mobile viewports"
+  - "Loading time must not exceed 2 seconds on a standard connection"
+  - "All user inputs must be validated both client-side and server-side"
+  - "Feature must include proper error states and empty states"
+out_of_scope:
+  - "Offline support for this feature"
+  - "Integration with third-party services"
+---
+
+## Overview
+
+The ${topic} feature enables users to manage their ${topic.toLowerCase()} workflow directly within TaskPilot. This reduces context switching and keeps all project-related information in one place.
+
+## Requirements
+
+The feature must integrate seamlessly with the existing dashboard and project views. Users should be able to access it from the project navigation sidebar. The interface must follow existing design patterns including the card-based layout, consistent button styles, and the standard form validation approach.
+
+## Technical Considerations
+
+Implementation should use Next.js Server Components for initial data loading and Client Components only for interactive elements. Data should be stored in the existing Supabase PostgreSQL database with appropriate RLS policies. All database queries should be optimized with proper indexes to maintain the 2-second loading time requirement.
+
+## User Stories
+
+As a project manager, I want to use ${topic.toLowerCase()} so that I can track progress more effectively. As a developer, I want the ${topic.toLowerCase()} interface to be keyboard-navigable so that I can work efficiently without switching to the mouse.
+`;
+}
+function generateDecision(index, _rng) {
+    const topic = DECISION_TOPICS[index % DECISION_TOPICS.length];
+    const id = `adr-${String(index + 2).padStart(3, "0")}`;
+    return `---
+id: "${id}"
+title: "${topic}"
+status: "accepted"
+date: "2025-0${Math.min(index + 1, 9)}-15"
+context: "The team needed to decide on the approach for ${topic.toLowerCase()} to ensure consistency and maintainability across the codebase."
+decision: "We decided to ${topic.toLowerCase()} based on team expertise, ecosystem maturity, and alignment with our existing architecture."
+consequences:
+  - "All new code must follow this decision"
+  - "Existing code should be migrated incrementally"
+  - "Documentation must be updated to reflect this choice"
+alternatives_rejected:
+  - "The alternative approach was considered but rejected due to higher complexity"
+---
+
+## Context
+
+The team evaluated multiple options for ${topic.toLowerCase()}. The primary factors in the decision were developer experience, performance characteristics, and long-term maintainability.
+
+## Decision Details
+
+After evaluating the options, we chose to ${topic.toLowerCase()}. This aligns with our existing technology choices and reduces the learning curve for new team members. The decision was made based on a proof-of-concept implementation that demonstrated the viability of this approach.
+
+## Migration Plan
+
+Existing code that does not follow this decision will be migrated as part of regular maintenance work. There is no urgent timeline for migration, but all new code must adhere to this decision immediately.
+`;
+}
+function generateDomainRule(index, _rng) {
+    const rule = DOMAIN_RULES[index % DOMAIN_RULES.length];
+    const id = rule.title.toLowerCase().replace(/\s+/g, "-");
+    return `---
+id: "${id}"
+critical: ${rule.critical}
+title: "${rule.title}"
+---
+
+## ${rule.title}
+
+These rules define the standards for ${rule.title.toLowerCase()} in TaskPilot. All engineers must follow these rules when working on related features.
+
+### Requirements
+
+1. All implementations must be reviewed against these standards before merging
+2. Automated checks should be added where feasible to enforce compliance
+3. Exceptions require documented justification and team lead approval
+
+### Rationale
+
+These rules exist to ensure consistency, maintainability, and quality across the product. They were established based on industry best practices and lessons learned from previous projects.
+`;
+}
+async function generateCorpus(targetSize, outputDir) {
+    const rng = createRNG(42); // deterministic seed
+    // Start by copying corpus-small as the base
+    await cp(join(FIXTURES_DIR, "corpus-small"), outputDir, { recursive: true });
+    // Calculate how many of each type to generate
+    // Base: 1 product + 2 personas + 2 journeys + 2 specs + 1 decision + 2 domain = 10
+    const remaining = targetSize - 10;
+    if (remaining <= 0)
+        return;
+    // Distribution: 20% personas, 15% journeys, 30% specs, 20% decisions, 15% domain
+    const personaCount = Math.floor(remaining * 0.2);
+    const specCount = Math.floor(remaining * 0.3);
+    const decisionCount = Math.floor(remaining * 0.2);
+    const domainCount = remaining - personaCount - specCount - decisionCount;
+    // Generate personas
+    for (let i = 0; i < personaCount; i++) {
+        const content = generatePersona(i, rng);
+        const name = PERSONA_NAMES[i % PERSONA_NAMES.length].name.toLowerCase().replace(/\s+/g, "-");
+        await writeFile(join(outputDir, "personas", `${name}.md`), content);
+    }
+    // Generate specs
+    for (let i = 0; i < specCount; i++) {
+        const content = generateSpec(i, rng);
+        const name = SPEC_TOPICS[i % SPEC_TOPICS.length].toLowerCase().replace(/\s+/g, "-");
+        await writeFile(join(outputDir, "specs", `${name}.md`), content);
+    }
+    // Generate decisions
+    for (let i = 0; i < decisionCount; i++) {
+        const content = generateDecision(i, rng);
+        await writeFile(join(outputDir, "decisions", `adr-${String(i + 2).padStart(3, "0")}.md`), content);
+    }
+    // Generate domain rules
+    for (let i = 0; i < domainCount; i++) {
+        const content = generateDomainRule(i, rng);
+        const name = DOMAIN_RULES[i % DOMAIN_RULES.length].title.toLowerCase().replace(/\s+/g, "-");
+        await writeFile(join(outputDir, "domain", `${name}.md`), content);
+    }
+}
+async function main() {
+    const sizes = [
+        { name: "corpus-medium", size: 50 },
+        { name: "corpus-large", size: 100 },
+        { name: "corpus-xlarge", size: 500 },
+    ];
+    for (const { name, size } of sizes) {
+        const outputDir = join(FIXTURES_DIR, name);
+        console.log(`Generating ${name} (${size} files)...`);
+        await mkdir(outputDir, { recursive: true });
+        await generateCorpus(size, outputDir);
+        console.log(`  → ${name} created at ${outputDir}`);
+    }
+    console.log("\nDone! Generated corpora for benchmarking.");
+}
+main().catch(console.error);
+//# sourceMappingURL=generate-corpus.js.map

package/dist/benchmarks/generators/generate-corpus.js.map

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

package/dist/benchmarks/lib/harness.d.ts

@@ -0,0 +1,23 @@
+import type Database from "better-sqlite3";
+declare const FIXTURES_DIR: string;
+export interface BenchHarness {
+    db: Database.Database;
+    productDir: string;
+    cleanup: () => Promise<void>;
+}
+/**
+ * Create a fresh benchmark environment:
+ * 1. Copy corpus to a temp directory
+ * 2. Open a fresh SQLite DB
+ * 3. Run fullIndex to populate it
+ */
+export declare function setup(corpus?: "corpus-small", options?: {
+    skipIndex?: boolean;
+}): Promise<BenchHarness>;
+/**
+ * Warm up the embedding pipeline (first call loads the 23MB model).
+ * Call once before timed benchmarks.
+ */
+export declare function warmupEmbeddings(): Promise<void>;
+export { FIXTURES_DIR };
+//# sourceMappingURL=harness.d.ts.map

package/dist/benchmarks/lib/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../../benchmarks/lib/harness.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,QAAA,MAAM,YAAY,QAA8C,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CACzB,MAAM,GAAE,cAA+B,EACvC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GACpC,OAAO,CAAC,YAAY,CAAC,CAyBvB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAGtD;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/benchmarks/lib/harness.js

@@ -0,0 +1,44 @@
+import { mkdtemp, cp, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { openDB, closeDB } from "../../src/db.js";
+import { fullIndex } from "../../src/indexer.js";
+const FIXTURES_DIR = join(import.meta.dirname, "..", "fixtures");
+/**
+ * Create a fresh benchmark environment:
+ * 1. Copy corpus to a temp directory
+ * 2. Open a fresh SQLite DB
+ * 3. Run fullIndex to populate it
+ */
+export async function setup(corpus = "corpus-small", options = {}) {
+    // Ensure any previous DB singleton is closed
+    closeDB();
+    // Create temp directory and copy corpus
+    const tmpDir = await mkdtemp(join(tmpdir(), "pcl-bench-"));
+    const productDir = join(tmpDir, "product");
+    await cp(join(FIXTURES_DIR, corpus), productDir, { recursive: true });
+    // Open fresh DB
+    const db = openDB(productDir);
+    // Index corpus unless skipped
+    if (!options.skipIndex) {
+        await fullIndex(db, productDir);
+    }
+    return {
+        db,
+        productDir,
+        cleanup: async () => {
+            closeDB();
+            await rm(tmpDir, { recursive: true, force: true });
+        },
+    };
+}
+/**
+ * Warm up the embedding pipeline (first call loads the 23MB model).
+ * Call once before timed benchmarks.
+ */
+export async function warmupEmbeddings() {
+    const { embedText } = await import("../../src/embeddings.js");
+    await embedText("warmup");
+}
+export { FIXTURES_DIR };
+//# sourceMappingURL=harness.js.map

package/dist/benchmarks/lib/harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../../benchmarks/lib/harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AAQjE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,SAAyB,cAAc,EACvC,UAAmC,EAAE;IAErC,6CAA6C;IAC7C,OAAO,EAAE,CAAC;IAEV,wCAAwC;IACxC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3C,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtE,gBAAgB;IAChB,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAE9B,8BAA8B;IAC9B,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,MAAM,SAAS,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAClC,CAAC;IAED,OAAO;QACL,EAAE;QACF,UAAU;QACV,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;IAC9D,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC5B,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/benchmarks/lib/types.d.ts

@@ -0,0 +1,79 @@
+export interface RelevanceJudgment {
+    query: string;
+    queryType: "exact_term" | "conceptual" | "multi_hop";
+    judgments: Array<{
+        docId: string;
+        relevance: 0 | 1 | 2 | 3;
+    }>;
+}
+export interface RelevanceGroundTruth {
+    queries: RelevanceJudgment[];
+}
+export interface EvaluationCriterion {
+    criterion: string;
+    weight: number;
+    type: "regex" | "llm_judge";
+    pattern?: string;
+    prompt?: string;
+}
+export interface CodingTask {
+    id: string;
+    category: "spec_compliance" | "business_rule" | "persona_alignment" | "architecture" | "journey_correctness";
+    description: string;
+    requiredContext: string[];
+    forbiddenPatterns: string[];
+    requiredPatterns: string[];
+    evaluationCriteria: EvaluationCriterion[];
+}
+export interface TaskGroundTruth {
+    tasks: CodingTask[];
+}
+export interface PerformanceResult {
+    name: string;
+    mean: number;
+    median: number;
+    p95: number;
+    iterations: number;
+}
+export interface SearchQualityResult {
+    mode: "hybrid" | "semantic" | "keyword";
+    queryType?: string;
+    precisionAt1: number;
+    precisionAt3: number;
+    precisionAt5: number;
+    recallAt5: number;
+    mrr: number;
+    ndcgAt5: number;
+}
+export interface TokenEfficiencyResult {
+    corpusSize: number;
+    pclSessionStartTokens: number;
+    pasteAllTokens: number;
+    savingsPercent: number;
+    ratio: number;
+}
+export interface AIQualityResult {
+    taskId: string;
+    category: string;
+    noContextScore: number;
+    pasteAllScore: number;
+    pclScore: number;
+    noContextTokens: number;
+    pasteAllTokens: number;
+    pclTokens: number;
+}
+export interface AblationResult {
+    configuration: string;
+    searchQuality: SearchQualityResult;
+}
+export interface BenchmarkReport {
+    timestamp: string;
+    version: string;
+    commit: string;
+    performance?: PerformanceResult[];
+    searchQuality?: SearchQualityResult[];
+    tokenEfficiency?: TokenEfficiencyResult[];
+    aiQuality?: AIQualityResult[];
+    ablation?: AblationResult[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/benchmarks/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../benchmarks/lib/types.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,YAAY,GAAG,YAAY,GAAG,WAAW,CAAC;IACrD,SAAS,EAAE,KAAK,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;KAC1B,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,iBAAiB,GAAG,eAAe,GAAG,mBAAmB,GAAG,cAAc,GAAG,qBAAqB,CAAC;IAC7G,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,EAAE,mBAAmB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAID,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,mBAAmB,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,aAAa,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACtC,eAAe,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC1C,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B"}

package/dist/benchmarks/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/benchmarks/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../benchmarks/lib/types.ts"],"names":[],"mappings":""}

package/dist/benchmarks/reporters/markdown-reporter.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=markdown-reporter.d.ts.map

package/dist/benchmarks/reporters/markdown-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-reporter.d.ts","sourceRoot":"","sources":["../../../benchmarks/reporters/markdown-reporter.ts"],"names":[],"mappings":""}