labgate 0.5.31 → 0.5.32

package/dist/lib/explorer-eval.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runEvaluation = runEvaluation;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const child_process_1 = require("child_process");
+function parseLastNonEmptyLine(text) {
+    const lines = text.split(/\r?\n/);
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = String(lines[i] || '').trim();
+        if (line)
+            return line;
+    }
+    return null;
+}
+function shellForCurrentPlatform() {
+    if (process.platform === 'win32') {
+        return process.env.COMSPEC || 'cmd.exe';
+    }
+    return process.env.SHELL || '/bin/sh';
+}
+function shellArgsForCommand(command) {
+    if (process.platform === 'win32') {
+        return ['/d', '/s', '/c', command];
+    }
+    return ['-lc', command];
+}
+function runEvaluation(opts) {
+    const worktreePath = (0, path_1.resolve)(opts.worktree_path);
+    const artifactDir = (0, path_1.resolve)(opts.artifact_dir);
+    const timeoutSec = Number.isFinite(opts.timeout_sec)
+        ? Math.min(86_400, Math.max(1, Math.floor(opts.timeout_sec)))
+        : 120;
+    (0, fs_1.mkdirSync)(artifactDir, { recursive: true, mode: 0o700 });
+    const stdoutPath = (0, path_1.join)(artifactDir, 'stdout.log');
+    const stderrPath = (0, path_1.join)(artifactDir, 'stderr.log');
+    const shell = shellForCurrentPlatform();
+    const started = Date.now();
+    const startedAt = new Date(started).toISOString();
+    const result = (0, child_process_1.spawnSync)(shell, shellArgsForCommand(opts.eval_command), {
+        cwd: worktreePath,
+        encoding: 'utf-8',
+        timeout: timeoutSec * 1000,
+        maxBuffer: 20 * 1024 * 1024,
+        env: { ...process.env, ...(opts.env || {}) },
+    });
+    const runtimeMs = Date.now() - started;
+    const finishedAt = new Date(started + runtimeMs).toISOString();
+    const stdout = String(result.stdout || '');
+    const stderr = String(result.stderr || '');
+    (0, fs_1.writeFileSync)(stdoutPath, stdout, 'utf-8');
+    (0, fs_1.writeFileSync)(stderrPath, stderr, 'utf-8');
+    if (result.error && (result.error.code === 'ETIMEDOUT' || result.signal === 'SIGTERM')) {
+        return {
+            status: 'timeout',
+            stdout_path: stdoutPath,
+            stderr_path: stderrPath,
+            eval_command: opts.eval_command,
+            exit_code: result.status == null ? null : result.status,
+            signal: result.signal ? String(result.signal) : null,
+            started_at: startedAt,
+            finished_at: finishedAt,
+            runtime_ms: runtimeMs,
+            error: `Evaluation timed out after ${timeoutSec}s`,
+        };
+    }
+    if (result.error) {
+        const errText = `${result.error.message || String(result.error)}`;
+        return {
+            status: 'failed_eval',
+            stdout_path: stdoutPath,
+            stderr_path: stderrPath,
+            eval_command: opts.eval_command,
+            exit_code: result.status == null ? null : result.status,
+            signal: result.signal ? String(result.signal) : null,
+            started_at: startedAt,
+            finished_at: finishedAt,
+            runtime_ms: runtimeMs,
+            error: errText,
+        };
+    }
+    if (result.status !== 0) {
+        return {
+            status: 'failed_eval',
+            stdout_path: stdoutPath,
+            stderr_path: stderrPath,
+            eval_command: opts.eval_command,
+            exit_code: result.status == null ? null : result.status,
+            signal: result.signal ? String(result.signal) : null,
+            started_at: startedAt,
+            finished_at: finishedAt,
+            runtime_ms: runtimeMs,
+            error: `Evaluation command exited with status ${result.status}`,
+        };
+    }
+    const lastLine = parseLastNonEmptyLine(stdout);
+    if (!lastLine) {
+        return {
+            status: 'invalid_output',
+            stdout_path: stdoutPath,
+            stderr_path: stderrPath,
+            eval_command: opts.eval_command,
+            exit_code: result.status == null ? null : result.status,
+            signal: result.signal ? String(result.signal) : null,
+            started_at: startedAt,
+            finished_at: finishedAt,
+            runtime_ms: runtimeMs,
+            error: 'No non-empty stdout line found for JSON score payload',
+        };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(lastLine);
+    }
+    catch {
+        return {
+            status: 'invalid_output',
+            stdout_path: stdoutPath,
+            stderr_path: stderrPath,
+            eval_command: opts.eval_command,
+            exit_code: result.status == null ? null : result.status,
+            signal: result.signal ? String(result.signal) : null,
+            started_at: startedAt,
+            finished_at: finishedAt,
+            runtime_ms: runtimeMs,
+            error: 'Final stdout line is not valid JSON',
+        };
+    }
+    const score = Number(parsed?.score);
+    if (!Number.isFinite(score)) {
+        return {
+            status: 'invalid_output',
+            stdout_path: stdoutPath,
+            stderr_path: stderrPath,
+            eval_command: opts.eval_command,
+            exit_code: result.status == null ? null : result.status,
+            signal: result.signal ? String(result.signal) : null,
+            started_at: startedAt,
+            finished_at: finishedAt,
+            runtime_ms: runtimeMs,
+            error: 'JSON score is missing or non-numeric',
+        };
+    }
+    const metrics = parsed?.metrics && typeof parsed.metrics === 'object' && !Array.isArray(parsed.metrics)
+        ? parsed.metrics
+        : {};
+    return {
+        status: 'eval_ok',
+        score,
+        metrics,
+        stdout_path: stdoutPath,
+        stderr_path: stderrPath,
+        eval_command: opts.eval_command,
+        exit_code: result.status == null ? null : result.status,
+        signal: result.signal ? String(result.signal) : null,
+        started_at: startedAt,
+        finished_at: finishedAt,
+        runtime_ms: runtimeMs,
+    };
+}
+//# sourceMappingURL=explorer-eval.js.map

package/dist/lib/explorer-eval.js.map

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

package/dist/lib/explorer-gc.d.ts

@@ -0,0 +1,11 @@
+import { ExplorerStore } from './explorer-store.js';
+import type { ExplorerGcPlan, RetentionPolicy } from './explorer-types.js';
+export interface ExplorerGcOptions {
+    dry_run?: boolean;
+    prune_worktrees?: boolean;
+    prune_artifacts?: boolean;
+    retention?: Partial<RetentionPolicy>;
+}
+export declare function planExperimentGc(experimentId: string, store: ExplorerStore, options?: ExplorerGcOptions): ExplorerGcPlan;
+export declare function applyExperimentGc(experimentId: string, store: ExplorerStore, options?: ExplorerGcOptions): ExplorerGcPlan;
+export declare function experimentGc(experimentId: string, store: ExplorerStore, options?: ExplorerGcOptions): ExplorerGcPlan;

package/dist/lib/explorer-gc.js

@@ -0,0 +1,304 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planExperimentGc = planExperimentGc;
+exports.applyExperimentGc = applyExperimentGc;
+exports.experimentGc = experimentGc;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const explorer_lock_js_1 = require("./explorer-lock.js");
+const explorer_git_js_1 = require("./explorer-git.js");
+const explorer_retention_js_1 = require("./explorer-retention.js");
+const FAILED_STATUSES = new Set([
+    'failed_build',
+    'failed_eval',
+    'timeout',
+    'invalid_output',
+]);
+function parseIsoMs(value) {
+    if (!value)
+        return 0;
+    const ms = Date.parse(value);
+    return Number.isFinite(ms) ? ms : 0;
+}
+function listFilesRecursive(root) {
+    if (!(0, fs_1.existsSync)(root))
+        return [];
+    const st = (0, fs_1.statSync)(root);
+    if (!st.isDirectory())
+        return [root];
+    const out = [];
+    const stack = [root];
+    while (stack.length > 0) {
+        const dir = stack.pop();
+        let entries = [];
+        try {
+            entries = (0, fs_1.readdirSync)(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const full = (0, path_1.join)(dir, entry);
+            try {
+                const est = (0, fs_1.statSync)(full);
+                if (est.isDirectory()) {
+                    stack.push(full);
+                }
+                else {
+                    out.push(full);
+                }
+            }
+            catch {
+                // Ignore transient FS races.
+            }
+        }
+    }
+    return out;
+}
+function safeSize(path) {
+    try {
+        const st = (0, fs_1.statSync)(path);
+        return st.isFile() ? st.size : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function computeArtifactPlan(run, mode) {
+    const artifactDir = (0, path_1.resolve)(run.artifact_dir);
+    const files = listFilesRecursive(artifactDir);
+    const keepBasenames = mode === 'minimal'
+        ? new Set(['eval.json', 'summary.md', 'diff.patch', 'agent.log'])
+        : mode === 'none'
+            ? new Set(['eval.json', 'summary.md'])
+            : new Set();
+    const keepPaths = [];
+    const deletePaths = [];
+    let estimatedBytes = 0;
+    for (const file of files) {
+        const base = file.slice(file.lastIndexOf('/') + 1);
+        if (mode !== 'all' && keepBasenames.has(base)) {
+            keepPaths.push(file);
+            continue;
+        }
+        if (mode === 'all') {
+            keepPaths.push(file);
+            continue;
+        }
+        deletePaths.push(file);
+        estimatedBytes += safeSize(file);
+    }
+    return {
+        deletePaths,
+        keepPaths,
+        estimatedBytes,
+    };
+}
+function resolveRetention(store, experimentId, overrides) {
+    const current = store.getRetentionPolicy(experimentId) || (0, explorer_retention_js_1.defaultRetentionPolicy)();
+    return (0, explorer_retention_js_1.mergeRetentionPolicy)(current, overrides || null);
+}
+function keepSetForExperiment(store, experimentId, retention) {
+    const keep = new Set();
+    const activeRuns = store.listActiveRuns(experimentId);
+    for (const run of activeRuns)
+        keep.add(run.id);
+    const finishedRuns = store.listFinishedRuns(experimentId);
+    for (const run of finishedRuns.slice(0, Math.max(0, retention.keep_last_n))) {
+        keep.add(run.id);
+    }
+    const recentFailed = finishedRuns
+        .filter((run) => FAILED_STATUSES.has(run.status))
+        .slice(0, Math.max(0, retention.keep_failed_last_n));
+    for (const run of recentFailed)
+        keep.add(run.id);
+    if (retention.keep_best) {
+        const best = store.getBestRun(experimentId);
+        if (best)
+            keep.add(best.id);
+    }
+    return keep;
+}
+function shouldPruneArtifactsByAge(run, retention) {
+    const days = retention.prune_artifacts_after_days;
+    if (days === undefined)
+        return true;
+    const finishedMs = parseIsoMs(run.finished_at || run.created_at);
+    if (!finishedMs)
+        return false;
+    const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
+    return finishedMs <= cutoff;
+}
+function planExperimentGc(experimentId, store, options) {
+    const experiment = store.getExperiment(experimentId);
+    if (!experiment) {
+        throw new Error(`Experiment not found: ${experimentId}`);
+    }
+    const retention = resolveRetention(store, experimentId, options?.retention);
+    const pruneWorktreesEnabled = (options?.prune_worktrees ?? true) && !retention.keep_worktrees;
+    const pruneArtifactsEnabled = (options?.prune_artifacts ?? true) && retention.artifacts !== 'all';
+    const keepSet = keepSetForExperiment(store, experimentId, retention);
+    const finished = store.listFinishedRuns(experimentId)
+        .filter((run) => !keepSet.has(run.id))
+        .sort((a, b) => parseIsoMs(a.finished_at || a.created_at) - parseIsoMs(b.finished_at || b.created_at));
+    const maxDelete = Math.max(1, retention.max_delete_runs || 200);
+    const items = [];
+    for (const run of finished) {
+        if (items.length >= maxDelete)
+            break;
+        const artifactPlan = computeArtifactPlan(run, retention.artifacts);
+        const pruneArtifacts = pruneArtifactsEnabled &&
+            shouldPruneArtifactsByAge(run, retention) &&
+            artifactPlan.deletePaths.length > 0;
+        const pruneWorktree = pruneWorktreesEnabled && !run.worktree_pruned_at && !!run.worktree_path;
+        if (!pruneArtifacts && !pruneWorktree)
+            continue;
+        items.push({
+            run_id: run.id,
+            worktree_path: run.worktree_path,
+            artifact_dir: run.artifact_dir,
+            prune_worktree: pruneWorktree,
+            prune_artifacts: pruneArtifacts,
+            artifact_delete_paths: artifactPlan.deletePaths,
+            artifact_keep_paths: artifactPlan.keepPaths,
+            estimated_bytes: artifactPlan.estimatedBytes,
+        });
+    }
+    return {
+        experiment_id: experimentId,
+        dry_run: options?.dry_run !== false,
+        retention,
+        candidate_count: finished.length,
+        to_prune_count: items.length,
+        pruned_worktrees: items.filter((item) => item.prune_worktree).length,
+        pruned_artifact_sets: items.filter((item) => item.prune_artifacts).length,
+        estimated_bytes: items.reduce((sum, item) => sum + item.estimated_bytes, 0),
+        items,
+    };
+}
+function deleteFileBestEffort(path) {
+    try {
+        if (!(0, fs_1.existsSync)(path))
+            return;
+        const st = (0, fs_1.statSync)(path);
+        if (st.isDirectory()) {
+            (0, fs_1.rmSync)(path, { recursive: true, force: true });
+            return;
+        }
+        (0, fs_1.unlinkSync)(path);
+    }
+    catch {
+        // Best effort.
+    }
+}
+function cleanupEmptyDirectories(root) {
+    if (!(0, fs_1.existsSync)(root))
+        return;
+    const walk = (dir) => {
+        let entries = [];
+        try {
+            entries = (0, fs_1.readdirSync)(dir);
+        }
+        catch {
+            return false;
+        }
+        let hasFiles = false;
+        for (const entry of entries) {
+            const full = (0, path_1.join)(dir, entry);
+            let st;
+            try {
+                st = (0, fs_1.statSync)(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                const childHasFiles = walk(full);
+                if (!childHasFiles) {
+                    try {
+                        (0, fs_1.rmSync)(full, { recursive: false, force: true });
+                    }
+                    catch { /* best effort */ }
+                }
+                else {
+                    hasFiles = true;
+                }
+            }
+            else {
+                hasFiles = true;
+            }
+        }
+        return hasFiles;
+    };
+    walk(root);
+}
+function pruneRunWorktree(repoPath, run) {
+    if (!run.prune_worktree)
+        return;
+    try {
+        (0, explorer_git_js_1.cleanupWorkspace)(repoPath, run.worktree_path);
+    }
+    catch {
+        // If git worktree metadata is already gone, force-remove the directory.
+        try {
+            (0, fs_1.rmSync)(run.worktree_path, { recursive: true, force: true });
+        }
+        catch { /* best effort */ }
+    }
+}
+function pruneRunArtifacts(run) {
+    if (!run.prune_artifacts)
+        return;
+    for (const filePath of run.artifact_delete_paths) {
+        deleteFileBestEffort(filePath);
+    }
+    cleanupEmptyDirectories(run.artifact_dir);
+}
+function applyExperimentGc(experimentId, store, options) {
+    const lock = (0, explorer_lock_js_1.acquireExperimentLock)(experimentId, 'autopilot.lock');
+    if (!lock) {
+        throw new Error('autopilot/gc lock is held for this experiment');
+    }
+    try {
+        const plan = planExperimentGc(experimentId, store, {
+            ...options,
+            dry_run: false,
+        });
+        const experiment = store.getExperiment(experimentId);
+        if (!experiment) {
+            throw new Error(`Experiment not found: ${experimentId}`);
+        }
+        for (const item of plan.items) {
+            if (item.prune_worktree) {
+                pruneRunWorktree(experiment.repo_path, item);
+                store.setRunWorktreePruned(item.run_id);
+            }
+            if (item.prune_artifacts) {
+                pruneRunArtifacts(item);
+                store.setRunArtifactsPruned(item.run_id, plan.retention.artifacts);
+            }
+        }
+        store.createEvent(experimentId, 'note', {
+            message: 'explorer gc applied',
+            pruned_runs: plan.to_prune_count,
+            pruned_worktrees: plan.pruned_worktrees,
+            pruned_artifact_sets: plan.pruned_artifact_sets,
+            estimated_bytes: plan.estimated_bytes,
+            retention: plan.retention,
+        });
+        return {
+            ...plan,
+            dry_run: false,
+        };
+    }
+    finally {
+        lock.release();
+    }
+}
+function experimentGc(experimentId, store, options) {
+    if (options?.dry_run === false) {
+        return applyExperimentGc(experimentId, store, options);
+    }
+    return planExperimentGc(experimentId, store, options);
+}
+//# sourceMappingURL=explorer-gc.js.map

package/dist/lib/explorer-gc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorer-gc.js","sourceRoot":"","sources":["../../src/lib/explorer-gc.ts"],"names":[],"mappings":";;AAuKA,4CA0DC;AAwED,8CAiDC;AAED,oCASC;AArWD,2BAA2E;AAC3E,+BAAwD;AAExD,yDAA2D;AAC3D,uDAAqD;AACrD,mEAGiC;AAUjC,MAAM,eAAe,GAA2B,IAAI,GAAG,CAAC;IACtD,cAAc;IACd,aAAa;IACb,SAAS;IACT,gBAAgB;CACjB,CAAC,CAAC;AAeH,SAAS,UAAU,CAAC,KAAoB;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IACrB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,EAAE,GAAG,IAAA,aAAQ,EAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAY,CAAC;QAClC,IAAI,OAAO,GAAa,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,GAAG,IAAA,gBAAW,EAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAA,WAAI,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAA,aAAQ,EAAC,IAAI,CAAC,CAAC;gBAC3B,IAAI,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;oBACtB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnB,CAAC;qBAAM,CAAC;oBACN,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,6BAA6B;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,IAAA,aAAQ,EAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAgB,EAAE,IAA2B;IACxE,MAAM,WAAW,GAAG,IAAA,cAAO,EAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAI,KAAK,SAAS;QACtC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;QACjE,CAAC,CAAC,IAAI,KAAK,MAAM;YACf,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;YACtC,CAAC,CAAC,IAAI,GAAG,EAAU,CAAC;IAExB,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACnD,IAAI,IAAI,KAAK,KAAK,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,cAAc,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,OAAO;QACL,WAAW;QACX,SAAS;QACT,cAAc;KACf,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAoB,EACpB,YAAoB,EACpB,SAAoC;IAEpC,MAAM,OAAO,GAAG,KAAK,CAAC,kBAAkB,CAAC,YAAY,CAAC,IAAI,IAAA,8CAAsB,GAAE,CAAC;IACnF,OAAO,IAAA,4CAAoB,EAAC,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAAoB,EACpB,YAAoB,EACpB,SAA0B;IAE1B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,UAAU,GAAG,KAAK,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IACtD,KAAK,MAAM,GAAG,IAAI,UAAU;QAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAE/C,MAAM,YAAY,GAAG,KAAK,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAE1D,KAAK,MAAM,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAG,YAAY;SAC9B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;SAChD,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACvD,KAAK,MAAM,GAAG,IAAI,YAAY;QAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEjD,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QAC5C,IAAI,IAAI;YAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,yBAAyB,CAAC,GAAgB,EAAE,SAA0B;IAC7E,MAAM,IAAI,GAAG,SAAS,CAAC,0BAA0B,CAAC;IAClD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACjE,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACvD,OAAO,UAAU,IAAI,MAAM,CAAC;AAC9B,CAAC;AAED,SAAgB,gBAAgB,CAC9B,YAAoB,EACpB,KAAoB,EACpB,OAA2B;IAE3B,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,yBAAyB,YAAY,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAC5E,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,eAAe,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC;IAC9F,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,eAAe,IAAI,IAAI,CAAC,IAAI,SAAS,CAAC,SAAS,KAAK,KAAK,CAAC;IAElG,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,KAAK,CAAC,gBAAgB,CAAC,YAAY,CAAC;SAClD,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SACrC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAEzG,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,eAAe,IAAI,GAAG,CAAC,CAAC;IAChE,MAAM,KAAK,GAAyB,EAAE,CAAC;IAEvC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS;YAAE,MAAM;QAErC,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;QACnE,MAAM,cAAc,GAClB,qBAAqB;YACrB,yBAAyB,CAAC,GAAG,EAAE,SAAS,CAAC;YACzC,YAAY,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;QAEtC,MAAM,aAAa,GAAG,qBAAqB,IAAI,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC;QAE9F,IAAI,CAAC,cAAc,IAAI,CAAC,aAAa;YAAE,SAAS;QAEhD,KAAK,CAAC,IAAI,CAAC;YACT,MAAM,EAAE,GAAG,CAAC,EAAE;YACd,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,cAAc,EAAE,aAAa;YAC7B,eAAe,EAAE,cAAc;YAC/B,qBAAqB,EAAE,YAAY,CAAC,WAAW;YAC/C,mBAAmB,EAAE,YAAY,CAAC,SAAS;YAC3C,eAAe,EAAE,YAAY,CAAC,cAAc;SAC7C,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,aAAa,EAAE,YAAY;QAC3B,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,KAAK;QACnC,SAAS;QACT,eAAe,EAAE,QAAQ,CAAC,MAAM;QAChC,cAAc,EAAE,KAAK,CAAC,MAAM;QAC5B,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM;QACpE,oBAAoB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM;QACzE,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;QAC3E,KAAK;KACN,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,IAAI,CAAC;QACH,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC;YAAE,OAAO;QAC9B,MAAM,EAAE,GAAG,IAAA,aAAQ,EAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;YACrB,IAAA,WAAM,EAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QACD,IAAA,eAAU,EAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAY;IAC3C,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC;QAAE,OAAO;IAE9B,MAAM,IAAI,GAAG,CAAC,GAAW,EAAW,EAAE;QACpC,IAAI,OAAO,GAAa,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,GAAG,IAAA,gBAAW,EAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAA,WAAI,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9B,IAAI,EAAE,CAAC;YACP,IAAI,CAAC;gBACH,EAAE,GAAG,IAAA,aAAQ,EAAC,IAAI,CAAC,CAAC;YACtB,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;gBACrB,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjC,IAAI,CAAC,aAAa,EAAE,CAAC;oBACnB,IAAI,CAAC;wBAAC,IAAA,WAAM,EAAC,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;oBAAC,CAAC;oBAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;gBACtF,CAAC;qBAAM,CAAC;oBACN,QAAQ,GAAG,IAAI,CAAC;gBAClB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,CAAC;AACb,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB,EAAE,GAAuB;IACjE,IAAI,CAAC,GAAG,CAAC,cAAc;QAAE,OAAO;IAChC,IAAI,CAAC;QACH,IAAA,kCAAgB,EAAC,QAAQ,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;QACxE,IAAI,CAAC;YAAC,IAAA,WAAM,EAAC,GAAG,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAClG,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAuB;IAChD,IAAI,CAAC,GAAG,CAAC,eAAe;QAAE,OAAO;IACjC,KAAK,MAAM,QAAQ,IAAI,GAAG,CAAC,qBAAqB,EAAE,CAAC;QACjD,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IACD,uBAAuB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAC5C,CAAC;AAED,SAAgB,iBAAiB,CAC/B,YAAoB,EACpB,KAAoB,EACpB,OAA2B;IAE3B,MAAM,IAAI,GAAG,IAAA,wCAAqB,EAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IACnE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,gBAAgB,CAAC,YAAY,EAAE,KAAK,EAAE;YACjD,GAAG,OAAO;YACV,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;QACrD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,yBAAyB,YAAY,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxB,gBAAgB,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;gBAC7C,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1C,CAAC;YAED,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACzB,iBAAiB,CAAC,IAAI,CAAC,CAAC;gBACxB,KAAK,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE;YACtC,OAAO,EAAE,qBAAqB;YAC9B,WAAW,EAAE,IAAI,CAAC,cAAc;YAChC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,OAAO;YACL,GAAG,IAAI;YACP,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;AACH,CAAC;AAED,SAAgB,YAAY,CAC1B,YAAoB,EACpB,KAAoB,EACpB,OAA2B;IAE3B,IAAI,OAAO,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;QAC/B,OAAO,iBAAiB,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,gBAAgB,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC"}

package/dist/lib/explorer-git.d.ts

@@ -0,0 +1,14 @@
+export interface RunWorkspace {
+    branch_name: string;
+    worktree_path: string;
+}
+export interface CommitAllOptions {
+    allow_empty?: boolean;
+}
+export declare function ensureGitRepository(repoPath: string): void;
+export declare function resolveGitSha(repoPath: string, ref?: string): string;
+export declare function cloneRepository(sourceRepoPath: string, targetRepoPath: string): void;
+export declare function createRunWorkspace(repoPath: string, worktreePath: string, parentSha: string, experimentId: string, runId: string): RunWorkspace;
+export declare function commitAll(worktreePath: string, message: string, opts?: CommitAllOptions): string;
+export declare function getDiff(repoPath: string, parentSha: string, commitSha: string): string;
+export declare function cleanupWorkspace(repoPath: string, worktreePath: string, branchName?: string): void;

package/dist/lib/explorer-git.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureGitRepository = ensureGitRepository;
+exports.resolveGitSha = resolveGitSha;
+exports.cloneRepository = cloneRepository;
+exports.createRunWorkspace = createRunWorkspace;
+exports.commitAll = commitAll;
+exports.getDiff = getDiff;
+exports.cleanupWorkspace = cleanupWorkspace;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const child_process_1 = require("child_process");
+function runGit(args, cwd) {
+    return (0, child_process_1.execFileSync)('git', args, {
+        cwd,
+        encoding: 'utf-8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    }).trim();
+}
+function runGitRaw(args, cwd) {
+    return String((0, child_process_1.execFileSync)('git', args, {
+        cwd,
+        encoding: 'utf-8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    }));
+}
+function runGitStatus(args, cwd) {
+    const result = (0, child_process_1.spawnSync)('git', args, {
+        cwd,
+        encoding: 'utf-8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    return {
+        status: result.status,
+        stdout: String(result.stdout || ''),
+        stderr: String(result.stderr || ''),
+    };
+}
+function sanitizeBranchPart(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9._/-]+/g, '-')
+        .replace(/--+/g, '-')
+        .replace(/^-+/, '')
+        .replace(/-+$/, '')
+        .slice(0, 100);
+}
+function ensureGitRepository(repoPath) {
+    const full = (0, path_1.resolve)(repoPath);
+    const check = runGitStatus(['-C', full, 'rev-parse', '--git-dir']);
+    if (check.status !== 0) {
+        throw new Error(`Not a git repository: ${full}`);
+    }
+}
+function resolveGitSha(repoPath, ref = 'HEAD') {
+    ensureGitRepository(repoPath);
+    return runGit(['-C', (0, path_1.resolve)(repoPath), 'rev-parse', ref]);
+}
+function cloneRepository(sourceRepoPath, targetRepoPath) {
+    const source = (0, path_1.resolve)(sourceRepoPath);
+    const target = (0, path_1.resolve)(targetRepoPath);
+    const targetParent = (0, path_1.dirname)(target);
+    if (!(0, fs_1.existsSync)(targetParent)) {
+        (0, fs_1.mkdirSync)(targetParent, { recursive: true, mode: 0o700 });
+    }
+    runGit(['clone', '--quiet', source, target]);
+}
+function createRunWorkspace(repoPath, worktreePath, parentSha, experimentId, runId) {
+    const fullRepo = (0, path_1.resolve)(repoPath);
+    const fullWorktree = (0, path_1.resolve)(worktreePath);
+    const parent = sanitizeBranchPart(parentSha);
+    if (!parent) {
+        throw new Error('parentSha is required');
+    }
+    const expPart = sanitizeBranchPart(experimentId) || 'exp';
+    const runPart = sanitizeBranchPart(runId) || 'run';
+    const branchName = `explorer/${expPart}/${runPart}`;
+    const parentDir = (0, path_1.dirname)(fullWorktree);
+    if (!(0, fs_1.existsSync)(parentDir)) {
+        (0, fs_1.mkdirSync)(parentDir, { recursive: true, mode: 0o700 });
+    }
+    runGit(['-C', fullRepo, 'worktree', 'add', '-b', branchName, fullWorktree, parent]);
+    return {
+        branch_name: branchName,
+        worktree_path: fullWorktree,
+    };
+}
+function commitAll(worktreePath, message, opts) {
+    const fullWorktree = (0, path_1.resolve)(worktreePath);
+    const commitMessage = message.trim() || 'explorer run';
+    const allowEmpty = opts?.allow_empty === true;
+    runGit(['-C', fullWorktree, 'add', '-A']);
+    const hasChanges = runGitStatus(['-C', fullWorktree, 'diff', '--cached', '--quiet']);
+    if (hasChanges.status === 0) {
+        if (!allowEmpty) {
+            throw new Error('No staged changes to commit');
+        }
+    }
+    else if (hasChanges.status !== 1) {
+        const detail = `${hasChanges.stderr}\n${hasChanges.stdout}`.trim();
+        throw new Error(detail || 'Failed to inspect staged changes');
+    }
+    const commitResult = (0, child_process_1.spawnSync)('git', [
+        '-C', fullWorktree,
+        '-c', 'user.name=LabGate Explorer',
+        '-c', 'user.email=labgate-explorer@local',
+        'commit',
+        ...(allowEmpty ? ['--allow-empty'] : []),
+        '-m', commitMessage,
+    ], {
+        encoding: 'utf-8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    if (commitResult.status !== 0) {
+        const detail = `${commitResult.stderr || ''}\n${commitResult.stdout || ''}`.trim();
+        throw new Error(detail || 'git commit failed');
+    }
+    return runGit(['-C', fullWorktree, 'rev-parse', 'HEAD']);
+}
+function getDiff(repoPath, parentSha, commitSha) {
+    const fullRepo = (0, path_1.resolve)(repoPath);
+    return runGitRaw(['-C', fullRepo, 'diff', '--binary', `${parentSha}..${commitSha}`]);
+}
+function cleanupWorkspace(repoPath, worktreePath, branchName) {
+    const fullRepo = (0, path_1.resolve)(repoPath);
+    const fullWorktree = (0, path_1.resolve)(worktreePath);
+    runGit(['-C', fullRepo, 'worktree', 'remove', '--force', fullWorktree]);
+    if (branchName && branchName.trim()) {
+        const branch = branchName.trim();
+        const result = runGitStatus(['-C', fullRepo, 'branch', '-D', branch]);
+        if (result.status !== 0) {
+            throw new Error(result.stderr.trim() || `Failed to delete branch ${branch}`);
+        }
+    }
+}
+//# sourceMappingURL=explorer-git.js.map

package/dist/lib/explorer-git.js.map

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