@spences10/pi-context 0.0.14 → 0.0.16

package/dist/context-format.d.ts

@@ -1,5 +1,6 @@
-import { type ContextListResult, type ContextPurgeDetails, type ContextSearchResult, type ContextStats } from './store.js';
+import { type ContextChunk, type ContextChunkSummary, type ContextListResult, type ContextPurgeDetails, type ContextSearchResult, type ContextStats } from './store.js';
 export declare function format_search_results(results: ContextSearchResult[]): string;
+export declare function format_get_result(source_id: string, chunk_id: string | undefined, chunks: ContextChunk[], summary: ContextChunkSummary | null): string;
 export declare function format_list_results(results: ContextListResult[]): string;
 export declare function format_purge_details(details: ContextPurgeDetails): string;
 export declare function format_stats(stats: ContextStats): string;

package/dist/context-format.js

@@ -12,6 +12,40 @@ export function format_search_results(results) {
     ].join('\n'))
         .join('\n\n---\n\n');
 }
+export function format_get_result(source_id, chunk_id, chunks, summary) {
+    if (chunks.length > 0) {
+        return chunks
+            .map((chunk) => [
+            `## ${chunk.id}`,
+            `Source: ${chunk.source_id} • Chunk ${chunk.ordinal}`,
+            '',
+            chunk.content,
+        ].join('\n'))
+            .join('\n\n---\n\n');
+    }
+    if (!summary) {
+        return [
+            `Source ${source_id} was not found in the context sidecar.`,
+            'It may have expired, been purged, or belonged to a different local context database.',
+            'Try context_list to inspect available sources, or rerun the original tool if the content is still needed.',
+        ].join('\n');
+    }
+    if (!chunk_id)
+        return 'No chunks found.';
+    const range = summary.first_chunk_id === summary.last_chunk_id
+        ? summary.first_chunk_id
+        : `${summary.first_chunk_id} … ${summary.last_chunk_id}`;
+    return [
+        `No chunk found for chunk_id "${chunk_id}".`,
+        `Source ${source_id} has ${summary.chunk_count} chunk(s): ${range}.`,
+        `Valid ordinals: ${summary.first_ordinal} … ${summary.last_ordinal}.`,
+        summary.first_chunk_id
+            ? `Try chunk_id:"${summary.first_chunk_id}" or chunk_id:"1".`
+            : undefined,
+    ]
+        .filter((line) => line !== undefined)
+        .join('\n');
+}
 export function format_list_results(results) {
     if (results.length === 0)
         return 'No indexed context sources found.';

package/dist/context-format.js.map

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

package/dist/eval/checks.d.ts

@@ -0,0 +1,9 @@
+import { ContextStore } from '../store.js';
+import type { EvalCaseResult, SeededSource } from './types.js';
+export declare function run_search_evals(store: ContextStore, seeded: Map<string, SeededSource>, results: EvalCaseResult[]): void;
+export declare function run_retrieval_evals(store: ContextStore, seeded: Map<string, SeededSource>, results: EvalCaseResult[]): void;
+export declare function run_lifecycle_evals(store: ContextStore, seeded: Map<string, SeededSource>, results: EvalCaseResult[]): void;
+export declare function run_capture_evals(results: EvalCaseResult[]): void;
+export declare function run_retention_evals(store: ContextStore, results: EvalCaseResult[]): void;
+export declare function run_cost_evals(store: ContextStore, seeded: Map<string, SeededSource>, results: EvalCaseResult[]): void;
+export declare function run_dedupe_evals(results: EvalCaseResult[]): void;

package/dist/eval/checks.js

@@ -0,0 +1,212 @@
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { format_get_result } from '../context-format.js';
+import { ContextStore, should_index_text } from '../store.js';
+import { PROJECT, SESSION, make_noise_lines, result_bytes, } from './fixtures.js';
+import { get_scenarios, search_scenarios } from './scenarios.js';
+export function run_search_evals(store, seeded, results) {
+    for (const scenario of search_scenarios) {
+        const source = seeded.get(scenario.source);
+        if (!source)
+            throw new Error(`Missing source ${scenario.source}`);
+        const search = store.search(scenario.query, {
+            source_id: source.source_id,
+            limit: scenario.limit,
+        });
+        const passed = search.some((result) => result.content.includes(scenario.expect));
+        results.push({
+            name: scenario.name,
+            category: 'search',
+            passed,
+            description: scenario.description,
+            detail: passed
+                ? `matched ${search[0]?.chunk_id ?? 'unknown chunk'}`
+                : `no expected match for query ${JSON.stringify(scenario.query)} (${search.length} result(s))`,
+            returned_bytes: result_bytes(search),
+            result_count: search.length,
+        });
+    }
+}
+export function run_retrieval_evals(store, seeded, results) {
+    for (const scenario of get_scenarios) {
+        const source = seeded.get(scenario.source);
+        if (!source)
+            throw new Error(`Missing source ${scenario.source}`);
+        const chunks = store.get(source.source_id, scenario.chunk_id);
+        const passed = chunks.some((chunk) => chunk.content.includes(scenario.expect));
+        results.push({
+            name: scenario.name,
+            category: 'retrieval',
+            passed,
+            description: scenario.description,
+            detail: passed
+                ? `retrieved ${chunks[0]?.id ?? scenario.chunk_id}`
+                : `missing expected content via chunk_id ${scenario.chunk_id}`,
+            returned_bytes: result_bytes(chunks),
+            result_count: chunks.length,
+        });
+    }
+}
+export function run_lifecycle_evals(store, seeded, results) {
+    const source = seeded.get('staging-help');
+    if (!source)
+        throw new Error('Missing source staging-help');
+    store.purge({ source_id: source.source_id, global: true });
+    const chunks = store.get(source.source_id, undefined, {
+        global: true,
+    });
+    const summary = store.chunk_summary(source.source_id, {
+        global: true,
+    });
+    const text = format_get_result(source.source_id, undefined, chunks, summary);
+    const passed = chunks.length === 0 &&
+        text.includes('was not found') &&
+        text.includes('expired');
+    results.push({
+        name: 'missing-source-guidance',
+        category: 'lifecycle',
+        passed,
+        description: 'Expired receipt retrieval should distinguish a missing backing source from an empty result and give guidance.',
+        detail: passed
+            ? 'missing source reports expiry/purge guidance'
+            : 'missing source is currently indistinguishable from no data',
+        returned_bytes: Buffer.byteLength(text, 'utf8'),
+        result_count: chunks.length,
+    });
+}
+export function run_capture_evals(results) {
+    const large_text = 'x'.repeat(24 * 1024 + 1);
+    const many_lines = Array.from({ length: 301 }, (_, index) => String(index)).join('\n');
+    const small_text = 'small output';
+    const passed = should_index_text(large_text) &&
+        should_index_text(many_lines) &&
+        !should_index_text(small_text);
+    results.push({
+        name: 'capture-thresholds',
+        category: 'capture',
+        passed,
+        description: 'Oversized byte and line-count outputs should be captured while small outputs stay inline.',
+        detail: passed
+            ? 'byte, line, and small-output thresholds behaved as expected'
+            : 'capture threshold mismatch',
+        returned_bytes: 0,
+        result_count: 3,
+    });
+}
+function store_db(store) {
+    return Reflect.get(store, 'db');
+}
+export function run_retention_evals(store, results) {
+    const old = store.store({
+        text: `old-retention-token\n${'o '.repeat(500)}`,
+        tool_name: 'bash',
+        force: true,
+    });
+    const fresh = store.store({
+        text: `fresh-retention-token\n${'f '.repeat(500)}`,
+        tool_name: 'bash',
+        force: true,
+    });
+    if (!old || !fresh)
+        throw new Error('Failed to seed retention eval');
+    store_db(store)
+        .prepare('UPDATE context_sources SET created_at = ? WHERE id = ?')
+        .run(Date.now() - 10 * 24 * 60 * 60 * 1000, old.source_id);
+    const cleanup = store.cleanup({
+        retention_days: 7,
+        purge_on_shutdown: false,
+        max_mb: null,
+        max_bytes: null,
+    });
+    const old_results = store.search('old-retention-token', {
+        source_id: old.source_id,
+        global: true,
+    });
+    const fresh_results = store.search('fresh-retention-token', {
+        source_id: fresh.source_id,
+        global: true,
+    });
+    const passed = cleanup.age_deleted >= 1 &&
+        old_results.length === 0 &&
+        fresh_results.length > 0;
+    results.push({
+        name: 'age-retention-cleanup',
+        category: 'retention',
+        passed,
+        description: 'Age cleanup should delete expired sources without deleting fresh sources.',
+        detail: `age_deleted=${cleanup.age_deleted}; old=${old_results.length}; fresh=${fresh_results.length}`,
+        returned_bytes: result_bytes([...old_results, ...fresh_results]),
+        result_count: old_results.length + fresh_results.length,
+    });
+}
+export function run_cost_evals(store, seeded, results) {
+    const source = seeded.get('chunk-boundary');
+    if (!source)
+        throw new Error('Missing source chunk-boundary');
+    const search = store.search('alpha-token omega-token', {
+        source_id: source.source_id,
+        limit: 25,
+    });
+    const bytes = result_bytes(search);
+    const passed = search.length > 0 && bytes <= 24 * 1024;
+    results.push({
+        name: 'bounded-relaxed-search-cost',
+        category: 'cost',
+        passed,
+        description: 'Relaxed search should recover useful chunks without dumping excessive context back inline.',
+        detail: `results=${search.length}; returned_bytes=${bytes}; budget=24576`,
+        returned_bytes: bytes,
+        result_count: search.length,
+    });
+}
+export function run_dedupe_evals(results) {
+    const dir = mkdtempSync(join(tmpdir(), 'pi-context-dedupe-eval-'));
+    const store = new ContextStore({
+        db_path: join(dir, 'context.db'),
+        project_path: PROJECT,
+        session_id: `${SESSION}:a`,
+    });
+    try {
+        const text = `shared-dedupe-token\n${make_noise_lines(40, 'dedupe')}`;
+        const first = store.store({
+            text,
+            tool_name: 'read',
+            session_id: `${SESSION}:a`,
+            project_path: PROJECT,
+            force: true,
+        });
+        const second = store.store({
+            text,
+            tool_name: 'read',
+            session_id: `${SESSION}:b`,
+            project_path: PROJECT,
+            force: true,
+        });
+        if (!first || !second)
+            throw new Error('Failed to seed dedupe eval');
+        const retrieved = store.get(second.source_id, undefined, {
+            session_id: `${SESSION}:b`,
+            project_path: PROJECT,
+        });
+        const stats = store.stats({ global: true });
+        const passed = first.source_id === second.source_id &&
+            second.deduped === true &&
+            stats.sources === 1 &&
+            retrieved.length === first.chunk_count;
+        results.push({
+            name: 'cross-session-dedupe',
+            category: 'dedupe',
+            passed,
+            description: 'Identical content across sessions should be content-address reused instead of stored twice.',
+            detail: `first=${first.source_id}; second=${second.source_id}; sources=${stats.sources}; retrieved=${retrieved.length}`,
+            returned_bytes: result_bytes(retrieved),
+            result_count: stats.sources,
+        });
+    }
+    finally {
+        store.close();
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=checks.js.map

package/dist/eval/checks.js.map

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

package/dist/eval/fixtures.d.ts

@@ -0,0 +1,13 @@
+import type { ContextStore } from '../store.js';
+import type { SeededSource } from './types.js';
+export declare const PROJECT = "/tmp/pi-context-eval-project";
+export declare const SESSION = "/tmp/pi-context-eval-session.jsonl";
+export declare function make_noise_lines(count: number, prefix: string): string;
+export declare function source_texts(): Record<string, {
+    tool_name: string;
+    text: string;
+}>;
+export declare function seed(store: ContextStore): Map<string, SeededSource>;
+export declare function result_bytes(values: Array<{
+    content: string;
+}>): number;

package/dist/eval/fixtures.js

@@ -0,0 +1,79 @@
+export const PROJECT = '/tmp/pi-context-eval-project';
+export const SESSION = '/tmp/pi-context-eval-session.jsonl';
+export function make_noise_lines(count, prefix) {
+    return Array.from({ length: count }, (_, index) => `${prefix} noise line ${index} ${'x'.repeat(48)}`).join('\n');
+}
+export function source_texts() {
+    return {
+        'needle-log': {
+            tool_name: 'bash',
+            text: [
+                make_noise_lines(80, 'before'),
+                'TARGET_VALUE appears on line 855 with surrounding diagnostic text',
+                make_noise_lines(80, 'after'),
+            ].join('\n'),
+        },
+        'staging-help': {
+            tool_name: 'bash',
+            text: [
+                'Interactive git UI help',
+                'Press space to stage this hunk.',
+                'Press enter to open the selected file.',
+                'Use a to amend after review.',
+                make_noise_lines(40, 'staging'),
+            ].join('\n'),
+        },
+        'skill-script': {
+            tool_name: 'read',
+            text: [
+                'case "$command" in',
+                '  update) run_gh_skill_update "$repo" ;;',
+                '  install) run_gh_skill_install "$repo" ;;',
+                'esac',
+                make_noise_lines(40, 'script'),
+            ].join('\n'),
+        },
+        'code-symbols': {
+            tool_name: 'read',
+            text: [
+                "pi.registerCommand('context-stats', {",
+                "  description: 'Show context sidecar byte accounting',",
+                '});',
+                make_noise_lines(40, 'code'),
+            ].join('\n'),
+        },
+        'chunk-boundary': {
+            tool_name: 'mcp__mcp-omnisearch__web_extract',
+            text: [
+                `alpha-token ${'a'.repeat(5000)}`,
+                '',
+                `omega-token ${'b'.repeat(5000)}`,
+            ].join('\n'),
+        },
+    };
+}
+export function seed(store) {
+    const seeded = new Map();
+    for (const [name, source] of Object.entries(source_texts())) {
+        const stored = store.store({
+            text: source.text,
+            tool_name: source.tool_name,
+            input_summary: name,
+            project_path: PROJECT,
+            session_id: SESSION,
+            force: true,
+        });
+        if (!stored)
+            throw new Error(`Failed to seed ${name}`);
+        seeded.set(name, {
+            name,
+            source_id: stored.source_id,
+            first_chunk_id: stored.first_chunk_id,
+        });
+    }
+    return seeded;
+}
+export function result_bytes(values) {
+    return values.reduce((total, value) => total + Buffer.byteLength(value.content, 'utf8'), 0);
+}
+//# sourceMappingURL=fixtures.js.map

package/dist/eval/fixtures.js.map

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

package/dist/eval/index.d.ts

@@ -0,0 +1,4 @@
+import type { EvalReport } from './types.js';
+export declare function run_context_eval(): EvalReport;
+export declare function run_context_eval_cli(args?: string[]): Promise<void>;
+export type { EvalCaseResult, EvalCategory, EvalReport, } from './types.js';

package/dist/eval/index.js

@@ -0,0 +1,56 @@
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { ContextStore } from '../store.js';
+import { run_capture_evals, run_cost_evals, run_dedupe_evals, run_lifecycle_evals, run_retention_evals, run_retrieval_evals, run_search_evals, } from './checks.js';
+import { PROJECT, SESSION, seed } from './fixtures.js';
+import { build_sections, format_report } from './report.js';
+export function run_context_eval() {
+    const dir = mkdtempSync(join(tmpdir(), 'pi-context-eval-'));
+    const db_path = join(dir, 'context.db');
+    const store = new ContextStore({
+        db_path,
+        project_path: PROJECT,
+        session_id: SESSION,
+    });
+    try {
+        const seeded = seed(store);
+        const results = [];
+        run_search_evals(store, seeded, results);
+        run_retrieval_evals(store, seeded, results);
+        run_lifecycle_evals(store, seeded, results);
+        run_capture_evals(results);
+        run_retention_evals(store, results);
+        run_cost_evals(store, seeded, results);
+        run_dedupe_evals(results);
+        const passed = results.filter((result) => result.passed).length;
+        const total = results.length;
+        const returned_bytes = results.reduce((sum, result) => sum + result.returned_bytes, 0);
+        return {
+            version: 1,
+            summary: {
+                passed,
+                failed: total - passed,
+                total,
+                score_pct: Math.round((passed / total) * 1000) / 10,
+                returned_bytes,
+            },
+            sections: build_sections(results),
+            results,
+        };
+    }
+    finally {
+        store.close();
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+export async function run_context_eval_cli(args = process.argv.slice(2)) {
+    const json = args.includes('--json');
+    const report = run_context_eval();
+    process.stdout.write(json
+        ? `${JSON.stringify(report, null, 2)}\n`
+        : `${format_report(report)}\n`);
+    if (report.summary.failed > 0)
+        process.exitCode = 1;
+}
+//# sourceMappingURL=index.js.map

package/dist/eval/index.js.map

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

package/dist/eval/report.d.ts

@@ -0,0 +1,3 @@
+import type { EvalCaseResult, EvalReport } from './types.js';
+export declare function build_sections(results: EvalCaseResult[]): EvalReport['sections'];
+export declare function format_report(report: EvalReport): string;

package/dist/eval/report.js

@@ -0,0 +1,43 @@
+export function build_sections(results) {
+    const categories = [
+        'search',
+        'retrieval',
+        'lifecycle',
+        'capture',
+        'retention',
+        'cost',
+        'dedupe',
+    ];
+    return categories
+        .map((category) => {
+        const section = results.filter((result) => result.category === category);
+        const passed = section.filter((result) => result.passed).length;
+        const total = section.length;
+        return {
+            category,
+            passed,
+            failed: total - passed,
+            total,
+            score_pct: total === 0 ? 0 : Math.round((passed / total) * 1000) / 10,
+        };
+    })
+        .filter((section) => section.total > 0);
+}
+export function format_report(report) {
+    return [
+        '# pi-context eval',
+        '',
+        `Score: ${report.summary.passed}/${report.summary.total} (${report.summary.score_pct}%)`,
+        `Returned bytes: ${report.summary.returned_bytes}`,
+        '',
+        'Sections:',
+        ...report.sections.map((section) => `- ${section.category}: ${section.passed}/${section.total} (${section.score_pct}%)`),
+        '',
+        ...report.results.map((result) => [
+            `${result.passed ? '✅' : '❌'} ${result.name} (${result.category})`,
+            `   ${result.description}`,
+            `   ${result.detail}; results=${result.result_count}; bytes=${result.returned_bytes}`,
+        ].join('\n')),
+    ].join('\n');
+}
+//# sourceMappingURL=report.js.map

package/dist/eval/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/eval/report.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,cAAc,CAC7B,OAAyB;IAEzB,MAAM,UAAU,GAAmB;QAClC,QAAQ;QACR,WAAW;QACX,WAAW;QACX,SAAS;QACT,WAAW;QACX,MAAM;QACN,QAAQ;KACR,CAAC;IACF,OAAO,UAAU;SACf,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QACjB,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAC7B,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,CACxC,CAAC;QACF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;QAChE,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,OAAO;YACN,QAAQ;YACR,MAAM;YACN,MAAM,EAAE,KAAK,GAAG,MAAM;YACtB,KAAK;YACL,SAAS,EACR,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE;SAC3D,CAAC;IACH,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAkB;IAC/C,OAAO;QACN,mBAAmB;QACnB,EAAE;QACF,UAAU,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI;QACxF,mBAAmB,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE;QAClD,EAAE;QACF,WAAW;QACX,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CACrB,CAAC,OAAO,EAAE,EAAE,CACX,KAAK,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,SAAS,IAAI,CACpF;QACD,EAAE;QACF,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAChC;YACC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,GAAG;YAClE,MAAM,MAAM,CAAC,WAAW,EAAE;YAC1B,MAAM,MAAM,CAAC,MAAM,aAAa,MAAM,CAAC,YAAY,WAAW,MAAM,CAAC,cAAc,EAAE;SACrF,CAAC,IAAI,CAAC,IAAI,CAAC,CACZ;KACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/eval/scenarios.d.ts

@@ -0,0 +1,3 @@
+import type { GetScenario, SearchScenario } from './types.js';
+export declare const search_scenarios: SearchScenario[];
+export declare const get_scenarios: GetScenario[];

package/dist/eval/scenarios.js

@@ -0,0 +1,52 @@
+export const search_scenarios = [
+    {
+        name: 'exact-token-baseline',
+        source: 'needle-log',
+        query: 'TARGET_VALUE',
+        expect: 'TARGET_VALUE appears on line 855',
+        limit: 5,
+        description: 'Basic exact-token lookup should work before and after.',
+    },
+    {
+        name: 'over-specific-human-query',
+        source: 'staging-help',
+        query: 'stage specific chunk line commit checks amend author sign-off',
+        expect: 'Press space to stage this hunk',
+        limit: 5,
+        description: 'Human/agent query contains useful words plus absent words; strict AND search used to miss.',
+    },
+    {
+        name: 'literal-or-query',
+        source: 'skill-script',
+        query: 'run_gh_skill_update OR run_gh_skill_install OR case update',
+        expect: 'run_gh_skill_update',
+        limit: 5,
+        description: 'Queries copied from agent reasoning often include OR; search should treat this as alternatives.',
+    },
+    {
+        name: 'punctuation-symbol-query',
+        source: 'code-symbols',
+        query: 'registerCommand context-stats',
+        expect: "registerCommand('context-stats'",
+        limit: 5,
+        description: 'Code and command names include punctuation that should not make retrieval brittle.',
+    },
+    {
+        name: 'chunk-boundary-query',
+        source: 'chunk-boundary',
+        query: 'alpha-token omega-token',
+        expect: 'alpha-token',
+        limit: 5,
+        description: 'Useful terms may be split across chunks; relaxed fallback should still recover likely chunks.',
+    },
+];
+export const get_scenarios = [
+    {
+        name: 'get-first-ordinal-alias',
+        source: 'needle-log',
+        chunk_id: '1',
+        expect: 'before noise line 0',
+        description: 'Receipt-led chunk retrieval via ordinal alias should stay reliable.',
+    },
+];
+//# sourceMappingURL=scenarios.js.map

package/dist/eval/scenarios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenarios.js","sourceRoot":"","sources":["../../src/eval/scenarios.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAqB;IACjD;QACC,IAAI,EAAE,sBAAsB;QAC5B,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,cAAc;QACrB,MAAM,EAAE,kCAAkC;QAC1C,KAAK,EAAE,CAAC;QACR,WAAW,EACV,wDAAwD;KACzD;IACD;QACC,IAAI,EAAE,2BAA2B;QACjC,MAAM,EAAE,cAAc;QACtB,KAAK,EACJ,+DAA+D;QAChE,MAAM,EAAE,gCAAgC;QACxC,KAAK,EAAE,CAAC;QACR,WAAW,EACV,4FAA4F;KAC7F;IACD;QACC,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,cAAc;QACtB,KAAK,EACJ,4DAA4D;QAC7D,MAAM,EAAE,qBAAqB;QAC7B,KAAK,EAAE,CAAC;QACR,WAAW,EACV,iGAAiG;KAClG;IACD;QACC,IAAI,EAAE,0BAA0B;QAChC,MAAM,EAAE,cAAc;QACtB,KAAK,EAAE,+BAA+B;QACtC,MAAM,EAAE,iCAAiC;QACzC,KAAK,EAAE,CAAC;QACR,WAAW,EACV,oFAAoF;KACrF;IACD;QACC,IAAI,EAAE,sBAAsB;QAC5B,MAAM,EAAE,gBAAgB;QACxB,KAAK,EAAE,yBAAyB;QAChC,MAAM,EAAE,aAAa;QACrB,KAAK,EAAE,CAAC;QACR,WAAW,EACV,+FAA+F;KAChG;CACD,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC3C;QACC,IAAI,EAAE,yBAAyB;QAC/B,MAAM,EAAE,YAAY;QACpB,QAAQ,EAAE,GAAG;QACb,MAAM,EAAE,qBAAqB;QAC7B,WAAW,EACV,qEAAqE;KACtE;CACD,CAAC"}

package/dist/eval/types.d.ts

@@ -0,0 +1,48 @@
+export interface SeededSource {
+    name: string;
+    source_id: string;
+    first_chunk_id: string | null;
+}
+export interface SearchScenario {
+    name: string;
+    query: string;
+    source: string;
+    expect: string;
+    limit?: number;
+    description: string;
+}
+export interface GetScenario {
+    name: string;
+    source: string;
+    chunk_id: string;
+    expect: string;
+    description: string;
+}
+export type EvalCategory = 'search' | 'retrieval' | 'lifecycle' | 'capture' | 'retention' | 'cost' | 'dedupe';
+export interface EvalCaseResult {
+    name: string;
+    category: EvalCategory;
+    passed: boolean;
+    description: string;
+    detail: string;
+    returned_bytes: number;
+    result_count: number;
+}
+export interface EvalReport {
+    version: 1;
+    summary: {
+        passed: number;
+        failed: number;
+        total: number;
+        score_pct: number;
+        returned_bytes: number;
+    };
+    sections: Array<{
+        category: EvalCategory;
+        passed: number;
+        failed: number;
+        total: number;
+        score_pct: number;
+    }>;
+    results: EvalCaseResult[];
+}

package/dist/eval/types.js

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