@codeledger/harness 0.1.1

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2025 Intelligent Context AI, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Note: This license applies to the CLI wrapper, types, repository scanning,
+instrumentation, harness, and report packages (the "Plugin"). The scoring
+engine (packages/core-engine/bin/) is licensed separately under LICENSE-CORE.

package/dist/adapters/generic.d.ts

@@ -0,0 +1,7 @@
+import type { AgentRunOptions, GenericAgentRunResult } from '@codeledger/types';
+import type { AgentAdapter } from './types.js';
+export declare class GenericAdapter implements AgentAdapter {
+    name: string;
+    run(opts: AgentRunOptions): Promise<GenericAgentRunResult>;
+}
+//# sourceMappingURL=generic.d.ts.map

package/dist/adapters/generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../src/adapters/generic.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAEhF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS/C,qBAAa,cAAe,YAAW,YAAY;IACjD,IAAI,SAAa;IAEX,GAAG,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAiEjE"}

package/dist/adapters/generic.js

@@ -0,0 +1,70 @@
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { execCommandAsync } from '@codeledger/instrument';
+import { injectIntoPrompt, renderBundleMarkdown, writeFileDropBundle } from '../injection.js';
+/** Shell-escape a string for safe interpolation into sh -c commands */
+function shellEscape(s) {
+    // Wrap in single quotes; escape embedded single quotes
+    return "'" + s.replace(/'/g, "'\\''") + "'";
+}
+export class GenericAdapter {
+    name = 'generic';
+    async run(opts) {
+        if (!opts.agent_cmd) {
+            throw new Error('Generic adapter requires --agentCmd');
+        }
+        const logsDir = join(opts.worktree_path, '.codeledger', 'logs');
+        mkdirSync(logsDir, { recursive: true });
+        // Build the prompt file
+        const promptDir = join(opts.worktree_path, '.codeledger', 'prompts');
+        mkdirSync(promptDir, { recursive: true });
+        const promptFile = join(promptDir, 'task-prompt.md');
+        let promptContent;
+        let bundlePath = null;
+        if (opts.mode.context_injection === 'on' && opts.bundle) {
+            const md = opts.bundle_markdown ?? renderBundleMarkdown(opts.bundle);
+            const injectionMode = opts.mode.injection_mode ?? 'prompt_prepend';
+            if (injectionMode === 'prompt_prepend') {
+                promptContent = injectIntoPrompt(opts.scenario.task.prompt, md);
+            }
+            else if (injectionMode === 'file_drop') {
+                promptContent = opts.scenario.task.prompt;
+                const dropPath = '.codeledger/active-bundle.md';
+                bundlePath = writeFileDropBundle(opts.worktree_path, md, dropPath);
+            }
+            else {
+                promptContent = opts.scenario.task.prompt;
+            }
+            // Also write bundle markdown separately for reference
+            const bundleMdPath = join(promptDir, 'bundle.md');
+            writeFileSync(bundleMdPath, md);
+            if (!bundlePath)
+                bundlePath = bundleMdPath;
+        }
+        else {
+            // without_codeledger: prompt only — NO bundle
+            promptContent = opts.scenario.task.prompt;
+        }
+        writeFileSync(promptFile, promptContent);
+        // Substitute placeholders in agent command (shell-escape paths)
+        let cmd = opts.agent_cmd;
+        cmd = cmd.replace(/\{promptFile\}/g, shellEscape(promptFile));
+        cmd = cmd.replace(/\{repoRoot\}/g, shellEscape(opts.worktree_path));
+        cmd = cmd.replace(/\{bundlePath\}/g, shellEscape(bundlePath ?? ''));
+        const stdoutLog = join(logsDir, 'agent-stdout.log');
+        const stderrLog = join(logsDir, 'agent-stderr.log');
+        const result = await execCommandAsync(cmd, {
+            cwd: opts.worktree_path,
+            timeout: (opts.guided_timeout_sec ?? 1800) * 1000,
+            stdoutLog,
+            stderrLog,
+        });
+        return {
+            exit_code: result.exit_code,
+            duration_ms: result.duration_ms,
+            stdout_path: stdoutLog,
+            stderr_path: stderrLog,
+        };
+    }
+}
+//# sourceMappingURL=generic.js.map

package/dist/adapters/generic.js.map

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

package/dist/adapters/guided.d.ts

@@ -0,0 +1,7 @@
+import type { AgentRunOptions, GenericAgentRunResult } from '@codeledger/types';
+import type { AgentAdapter } from './types.js';
+export declare class GuidedAdapter implements AgentAdapter {
+    name: string;
+    run(opts: AgentRunOptions): Promise<GenericAgentRunResult>;
+}
+//# sourceMappingURL=guided.d.ts.map

package/dist/adapters/guided.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guided.d.ts","sourceRoot":"","sources":["../../src/adapters/guided.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,qBAAa,aAAc,YAAW,YAAY;IAChD,IAAI,SAAY;IAEV,GAAG,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAuCjE"}

package/dist/adapters/guided.js

@@ -0,0 +1,60 @@
+import { createInterface } from 'node:readline';
+import { renderBundleMarkdown } from '../injection.js';
+export class GuidedAdapter {
+    name = 'guided';
+    async run(opts) {
+        const start = Date.now();
+        console.log('\n' + '='.repeat(60));
+        console.log('GUIDED MODE — Follow the instructions below');
+        console.log('='.repeat(60));
+        if (opts.mode.context_injection === 'on' && opts.bundle) {
+            const md = opts.bundle_markdown ?? renderBundleMarkdown(opts.bundle);
+            console.log('\n📦 CONTEXT BUNDLE (paste this into your agent):');
+            console.log('-'.repeat(40));
+            console.log(md);
+            console.log('-'.repeat(40));
+        }
+        console.log('\n📝 TASK PROMPT:');
+        console.log('-'.repeat(40));
+        console.log(opts.scenario.task.prompt);
+        console.log('-'.repeat(40));
+        console.log(`\n📁 Open this directory in your agent: ${opts.worktree_path}`);
+        console.log('\nPaste the above prompt into your agent and complete the task.');
+        const timeoutSec = opts.guided_timeout_sec ?? 600;
+        console.log(`\nPress Enter when done (timeout: ${timeoutSec}s)...`);
+        await waitForEnterOrTimeout(timeoutSec);
+        const durationMs = Date.now() - start;
+        console.log('\n✅ Guided session complete. Running acceptance commands...');
+        return {
+            exit_code: 0,
+            duration_ms: durationMs,
+            stdout_path: null,
+            stderr_path: null,
+        };
+    }
+}
+function waitForEnterOrTimeout(timeoutSec) {
+    return new Promise((resolve) => {
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        let settled = false;
+        const settle = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            rl.close();
+            resolve();
+        };
+        const timer = setTimeout(() => {
+            console.log('\n⏰ Timeout reached.');
+            settle();
+        }, timeoutSec * 1000);
+        rl.once('line', () => settle());
+        // Resolve if stdin closes unexpectedly (piped input ends, terminal disconnects)
+        rl.once('close', () => settle());
+    });
+}
+//# sourceMappingURL=guided.js.map

package/dist/adapters/guided.js.map

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

package/dist/adapters/types.d.ts

@@ -0,0 +1,6 @@
+import type { AgentRunOptions, GenericAgentRunResult } from '@codeledger/types';
+export interface AgentAdapter {
+    name: string;
+    run(opts: AgentRunOptions): Promise<GenericAgentRunResult>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAEhF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC5D"}

package/dist/adapters/types.js

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

package/dist/adapters/types.js.map

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

package/dist/comparator.d.ts

@@ -0,0 +1,7 @@
+import type { BenchmarkReport } from '@codeledger/types';
+import { type RunOptions } from './scenario-runner.js';
+export interface CompareOptions extends RunOptions {
+    repeats: number;
+}
+export declare function compareScenario(opts: CompareOptions): Promise<BenchmarkReport>;
+//# sourceMappingURL=comparator.d.ts.map

package/dist/comparator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparator.d.ts","sourceRoot":"","sources":["../src/comparator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKpE,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,eAAe,CAAC,CA8C1B"}

package/dist/comparator.js

@@ -0,0 +1,135 @@
+import { getShortRef, isRepoDirty } from '@codeledger/instrument';
+import { runScenario } from './scenario-runner.js';
+import { readFileSync } from 'node:fs';
+import { basename } from 'node:path';
+export async function compareScenario(opts) {
+    const allRuns = [];
+    for (let repeat = 1; repeat <= opts.repeats; repeat++) {
+        console.log(`\n${'═'.repeat(60)}`);
+        console.log(`REPEAT ${repeat} of ${opts.repeats}`);
+        console.log('═'.repeat(60));
+        const { repeats: _repeats, ...runOpts } = opts;
+        const runs = await runScenario(runOpts);
+        for (const run of runs) {
+            allRuns.push({
+                ...run,
+                repeat,
+                metrics: {
+                    ...run.metrics,
+                    attempt_number: repeat,
+                },
+            });
+        }
+    }
+    // Load scenario for metadata
+    let scenario;
+    try {
+        scenario = JSON.parse(readFileSync(opts.scenarioPath, 'utf-8'));
+    }
+    catch {
+        throw new Error(`Failed to parse scenario at ${opts.scenarioPath}. Ensure it contains valid JSON.`);
+    }
+    const gitRef = getShortRef(opts.cwd);
+    const dirty = isRepoDirty(opts.cwd);
+    const aggregate = computeAggregate(allRuns);
+    return {
+        scenario_id: scenario.id,
+        repo: {
+            name: basename(opts.cwd),
+            git_ref: gitRef,
+            dirty,
+        },
+        runs: allRuns,
+        aggregate,
+    };
+}
+function computeAggregate(runs) {
+    const withoutRuns = runs.filter((r) => r.mode === 'without_codeledger');
+    const withRuns = runs.filter((r) => r.mode === 'with_codeledger');
+    const avgDurationWithout = avg(withoutRuns.map((r) => r.metrics.duration_sec));
+    const avgDurationWith = avg(withRuns.map((r) => r.metrics.duration_sec));
+    const avgFilesWithout = avg(withoutRuns.map((r) => r.metrics.files_read_count));
+    const avgFilesWith = avg(withRuns.map((r) => r.metrics.files_read_count));
+    const avgIterWithout = avg(withoutRuns.map((r) => r.metrics.iterations));
+    const avgIterWith = avg(withRuns.map((r) => r.metrics.iterations));
+    const avgTokensWithout = avg(withoutRuns.map((r) => r.metrics.token_estimate));
+    const avgTokensWith = avg(withRuns.map((r) => r.metrics.token_estimate));
+    const successRateWithout = successRate(withoutRuns);
+    const successRateWith = successRate(withRuns);
+    const acceptedDurationWithout = withoutRuns
+        .filter((r) => r.metrics.accepted)
+        .map((r) => r.metrics.duration_ms_total);
+    const acceptedDurationWith = withRuns
+        .filter((r) => r.metrics.accepted)
+        .map((r) => r.metrics.duration_ms_total);
+    const medianWithout = median(acceptedDurationWithout);
+    const medianWith = median(acceptedDurationWith);
+    const attemptsWithout = attemptsUntilSuccess(withoutRuns);
+    const attemptsWith = attemptsUntilSuccess(withRuns);
+    return {
+        delta: {
+            duration_sec_pct: pctChange(avgDurationWithout, avgDurationWith),
+            files_read_pct: pctChange(avgFilesWithout, avgFilesWith),
+            iterations_pct: pctChange(avgIterWithout, avgIterWith),
+            token_estimate_pct: pctChange(avgTokensWithout, avgTokensWith),
+            success_rate_delta: round(successRateWith - successRateWithout),
+        },
+        outcomes: {
+            acceptance_rate_without: round(successRateWithout * 100),
+            acceptance_rate_with: round(successRateWith * 100),
+            acceptance_rate_uplift_pct: round((successRateWith - successRateWithout) * 100),
+            median_time_to_acceptance_ms_without: medianWithout,
+            median_time_to_acceptance_ms_with: medianWith,
+            time_to_acceptance_reduction_pct: pctReductionNullable(medianWithout, medianWith),
+            attempts_until_success_without: attemptsWithout,
+            attempts_until_success_with: attemptsWith,
+            attempts_reduction_pct: pctReductionNullable(attemptsWithout, attemptsWith),
+        },
+    };
+}
+function avg(values) {
+    if (values.length === 0)
+        return 0;
+    return values.reduce((a, b) => a + b, 0) / values.length;
+}
+function median(values) {
+    if (values.length === 0)
+        return null;
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 === 0) {
+        return Math.round((sorted[mid - 1] + sorted[mid]) / 2);
+    }
+    return sorted[mid];
+}
+function pctChange(baseline, compare) {
+    if (baseline === 0) {
+        // Both zero means no change; otherwise the change is undefined — use
+        // null-coalesced sentinel so consumers can detect the edge case.
+        return compare === 0 ? 0 : Infinity;
+    }
+    return round(((compare - baseline) / baseline) * 100);
+}
+function pctReductionNullable(baseline, compare) {
+    if (baseline === null || compare === null || baseline === 0)
+        return null;
+    return round(((baseline - compare) / baseline) * 100);
+}
+function attemptsUntilSuccess(runs) {
+    const sorted = [...runs].sort((a, b) => a.repeat - b.repeat);
+    for (const run of sorted) {
+        if (run.metrics.accepted)
+            return run.repeat;
+    }
+    return null;
+}
+function successRate(runs) {
+    if (runs.length === 0)
+        return 0;
+    const passed = runs.filter((r) => r.metrics.accepted).length;
+    return passed / runs.length;
+}
+function round(n) {
+    return Math.round(n * 10) / 10;
+}
+//# sourceMappingURL=comparator.js.map

package/dist/comparator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparator.js","sourceRoot":"","sources":["../src/comparator.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAmB,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAOrC,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAoB;IAEpB,MAAM,OAAO,GAAgB,EAAE,CAAC;IAEhC,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAE5B,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;QAExC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC;gBACX,GAAG,GAAG;gBACN,MAAM;gBACN,OAAO,EAAE;oBACP,GAAG,GAAG,CAAC,OAAO;oBACd,cAAc,EAAE,MAAM;iBACvB;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAa,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,CAAC,YAAY,kCAAkC,CAAC,CAAC;IACtG,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEpC,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE5C,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,EAAE;QACxB,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;YACxB,OAAO,EAAE,MAAM;YACf,KAAK;SACN;QACD,IAAI,EAAE,OAAO;QACb,SAAS;KACV,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAiB;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC;IAElE,MAAM,kBAAkB,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAC/E,MAAM,eAAe,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAEzE,MAAM,eAAe,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAChF,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAE1E,MAAM,cAAc,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAEnE,MAAM,gBAAgB,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IAC/E,MAAM,aAAa,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IAEzE,MAAM,kBAAkB,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,eAAe,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAE9C,MAAM,uBAAuB,GAAG,WAAW;SACxC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC3C,MAAM,oBAAoB,GAAG,QAAQ;SAClC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE3C,MAAM,aAAa,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAEhD,MAAM,eAAe,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAEpD,OAAO;QACL,KAAK,EAAE;YACL,gBAAgB,EAAE,SAAS,CAAC,kBAAkB,EAAE,eAAe,CAAC;YAChE,cAAc,EAAE,SAAS,CAAC,eAAe,EAAE,YAAY,CAAC;YACxD,cAAc,EAAE,SAAS,CAAC,cAAc,EAAE,WAAW,CAAC;YACtD,kBAAkB,EAAE,SAAS,CAAC,gBAAgB,EAAE,aAAa,CAAC;YAC9D,kBAAkB,EAAE,KAAK,CAAC,eAAe,GAAG,kBAAkB,CAAC;SAChE;QACD,QAAQ,EAAE;YACR,uBAAuB,EAAE,KAAK,CAAC,kBAAkB,GAAG,GAAG,CAAC;YACxD,oBAAoB,EAAE,KAAK,CAAC,eAAe,GAAG,GAAG,CAAC;YAClD,0BAA0B,EAAE,KAAK,CAAC,CAAC,eAAe,GAAG,kBAAkB,CAAC,GAAG,GAAG,CAAC;YAC/E,oCAAoC,EAAE,aAAa;YACnD,iCAAiC,EAAE,UAAU;YAC7C,gCAAgC,EAAE,oBAAoB,CAAC,aAAa,EAAE,UAAU,CAAC;YACjF,8BAA8B,EAAE,eAAe;YAC/C,2BAA2B,EAAE,YAAY;YACzC,sBAAsB,EAAE,oBAAoB,CAAC,eAAe,EAAE,YAAY,CAAC;SAC5E;KACF,CAAC;AACJ,CAAC;AAED,SAAS,GAAG,CAAC,MAAgB;IAC3B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;AAC3D,CAAC;AAED,SAAS,MAAM,CAAC,MAAgB;IAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAE,GAAG,MAAM,CAAC,GAAG,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAE,CAAC;AACtB,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB,EAAE,OAAe;IAClD,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,qEAAqE;QACrE,iEAAiE;QACjE,OAAO,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,oBAAoB,CAC3B,QAAuB,EACvB,OAAsB;IAEtB,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAiB;IAC7C,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IAC7D,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,IAAiB;IACpC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IAC7D,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;AAC9B,CAAC;AAED,SAAS,KAAK,CAAC,CAAS;IACtB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;AACjC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { renderBundleMarkdown, injectIntoPrompt, writeFileDropBundle } from './injection.js';
+export { GenericAdapter } from './adapters/generic.js';
+export { GuidedAdapter } from './adapters/guided.js';
+export type { AgentAdapter } from './adapters/types.js';
+export { createWorktree, cleanupAllWorktrees } from './worktree.js';
+export { runScenario } from './scenario-runner.js';
+export type { RunOptions, SingleRunResult } from './scenario-runner.js';
+export { compareScenario } from './comparator.js';
+export type { CompareOptions } from './comparator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { renderBundleMarkdown, injectIntoPrompt, writeFileDropBundle } from './injection.js';
+export { GenericAdapter } from './adapters/generic.js';
+export { GuidedAdapter } from './adapters/guided.js';
+export { createWorktree, cleanupAllWorktrees } from './worktree.js';
+export { runScenario } from './scenario-runner.js';
+export { compareScenario } from './comparator.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/injection.d.ts

@@ -0,0 +1,5 @@
+import type { ContextBundle } from '@codeledger/types';
+export declare function renderBundleMarkdown(bundle: ContextBundle): string;
+export declare function injectIntoPrompt(taskText: string, bundleMarkdown: string): string;
+export declare function writeFileDropBundle(worktreePath: string, bundleMarkdown: string, dropPath: string): string;
+//# sourceMappingURL=injection.d.ts.map

package/dist/injection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection.d.ts","sourceRoot":"","sources":["../src/injection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAoGlE;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,MAAM,CAER;AAED,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,MAAM,CAgBR"}

package/dist/injection.js

@@ -0,0 +1,107 @@
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { dirname, resolve, relative } from 'node:path';
+export function renderBundleMarkdown(bundle) {
+    const lines = [];
+    lines.push('# Context Bundle (generated by CodeLedger)');
+    lines.push('');
+    lines.push(`**Task:** ${bundle.task}`);
+    lines.push(`**Files:** ${bundle.files.length} | **Tokens:** ~${bundle.total_tokens}`);
+    // Confidence assessment
+    if (bundle.confidence) {
+        const c = bundle.confidence;
+        const icon = c.level === 'high' ? 'HIGH' : c.level === 'medium' ? 'MEDIUM' : 'LOW';
+        lines.push(`**Confidence:** ${icon} (${c.score})`);
+        if (c.level !== 'high' && c.reasons.length > 0) {
+            for (const reason of c.reasons) {
+                lines.push(`  - ${reason}`);
+            }
+        }
+    }
+    lines.push('');
+    // Separate full files, stubs, and their sections
+    const fullFiles = bundle.files.filter((f) => !f.is_stub);
+    const stubs = bundle.files.filter((f) => f.is_stub);
+    lines.push('## Relevant Files (ranked by score)');
+    lines.push('');
+    for (let i = 0; i < fullFiles.length; i++) {
+        const f = fullFiles[i];
+        const reasons = f.reasons.join(', ');
+        lines.push(`${i + 1}. \`${f.path}\` — ${reasons} (score: ${f.score.toFixed(3)})`);
+    }
+    lines.push('');
+    lines.push('## Excerpts');
+    lines.push('');
+    for (const f of fullFiles) {
+        if (!f.content)
+            continue;
+        lines.push(`### ${f.path}`);
+        if (f.excerpt_spans) {
+            const spanDesc = f.excerpt_spans
+                .map((s) => `L${s.start_line}–${s.end_line}`)
+                .join(', ');
+            lines.push(`*Excerpts: ${spanDesc}*`);
+        }
+        // Deprecation warnings inline
+        if (f.deprecation_warnings && f.deprecation_warnings.length > 0) {
+            lines.push('');
+            lines.push('> **Deprecation warnings:**');
+            for (const w of f.deprecation_warnings) {
+                lines.push(`> - L${w.line}: \`${w.matched}\` — ${w.message}`);
+            }
+        }
+        lines.push('');
+        lines.push('```');
+        lines.push(f.content);
+        lines.push('```');
+        lines.push('');
+    }
+    // Interface stubs section
+    if (stubs.length > 0) {
+        lines.push('## Interface Stubs (adjacent dependencies)');
+        lines.push('');
+        lines.push('*These files are imported by bundle files but were not selected. Only exported type signatures are shown.*');
+        lines.push('');
+        for (const s of stubs) {
+            if (!s.content)
+                continue;
+            lines.push(`### ${s.path} *(stub)*`);
+            lines.push('');
+            lines.push('```');
+            lines.push(s.content);
+            lines.push('```');
+            lines.push('');
+        }
+    }
+    // Explain section (per-file scoring breakdown)
+    if (bundle.explain) {
+        lines.push('## Scoring Breakdown (--explain)');
+        lines.push('');
+        lines.push('| File | keyword | centrality | churn | recent | test | size_pen | success | fail | err_infra | total |');
+        lines.push('|------|---------|------------|-------|--------|------|----------|---------|------|-----------|-------|');
+        for (const f of fullFiles) {
+            const feat = bundle.explain[f.path];
+            if (!feat)
+                continue;
+            lines.push(`| \`${f.path}\` | ${feat.keyword.toFixed(2)} | ${feat.centrality.toFixed(2)} | ${feat.churn.toFixed(2)} | ${feat.recent_touch.toFixed(2)} | ${feat.test_relevance.toFixed(2)} | ${feat.size_penalty.toFixed(2)} | ${feat.success_prior.toFixed(2)} | ${feat.fail_prior.toFixed(2)} | ${feat.error_infrastructure.toFixed(2)} | ${f.score.toFixed(3)} |`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function injectIntoPrompt(taskText, bundleMarkdown) {
+    return `${bundleMarkdown}\n---\n# Task\n${taskText}\n`;
+}
+export function writeFileDropBundle(worktreePath, bundleMarkdown, dropPath) {
+    const fullPath = resolve(worktreePath, dropPath);
+    const resolvedRoot = resolve(worktreePath);
+    // Prevent path traversal — resolved path must stay within the worktree
+    const rel = relative(resolvedRoot, fullPath);
+    if (rel.startsWith('..') || resolve(resolvedRoot, rel) !== fullPath) {
+        throw new Error(`Refusing to write bundle: dropPath "${dropPath}" resolves outside the worktree.`);
+    }
+    const dir = dirname(fullPath);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(fullPath, bundleMarkdown);
+    return fullPath;
+}
+//# sourceMappingURL=injection.js.map

package/dist/injection.js.map

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

package/dist/scenario-runner.d.ts

@@ -0,0 +1,26 @@
+import type { ScenarioMode, ContextBundle, GenericAgentRunResult, Metrics, CommandResult, ReportRun, InjectionProof, InjectionMode } from '@codeledger/types';
+export interface RunOptions {
+    scenarioPath: string;
+    cwd: string;
+    agentCmd?: string;
+    agentCmdWithout?: string;
+    agentCmdWith?: string;
+    guided?: boolean;
+    force?: boolean;
+    useWorktree?: boolean;
+    keepWorktree?: boolean;
+    worktreeRoot?: string;
+    injectionOverride?: InjectionMode;
+    guidedTimeoutSec?: number;
+}
+export interface SingleRunResult {
+    mode: ScenarioMode;
+    agentResult: GenericAgentRunResult;
+    acceptanceResults: CommandResult[];
+    metrics: Metrics;
+    bundle: ContextBundle | null;
+    injectionProof: InjectionProof | null;
+}
+export declare function runScenario(opts: RunOptions): Promise<ReportRun[]>;
+export declare function selectAgentCmdForMode(modeName: string, opts: Pick<RunOptions, 'agentCmd' | 'agentCmdWithout' | 'agentCmdWith'>): string | undefined;
+//# sourceMappingURL=scenario-runner.d.ts.map

package/dist/scenario-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-runner.d.ts","sourceRoot":"","sources":["../src/scenario-runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,YAAY,EAGZ,aAAa,EACb,qBAAqB,EACrB,OAAO,EACP,aAAa,EAEb,SAAS,EACT,cAAc,EACd,aAAa,EACd,MAAM,mBAAmB,CAAC;AAgB3B,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,qBAAqB,CAAC;IACnC,iBAAiB,EAAE,aAAa,EAAE,CAAC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;CACvC;AAsCD,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAwSxE;AAYD,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,iBAAiB,GAAG,cAAc,CAAC,GACtE,MAAM,GAAG,SAAS,CAUpB"}