labgate 0.5.31 → 0.5.33

package/dist/lib/explorer-claude.js

@@ -0,0 +1,361 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildClaudeActivityLog = buildClaudeActivityLog;
+exports.runClaudeHeadlessInWorktree = runClaudeHeadlessInWorktree;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+const child_process_1 = require("child_process");
+const config_js_1 = require("./config.js");
+const container_js_1 = require("./container.js");
+const runtime_js_1 = require("./runtime.js");
+const CLAUDE_PREP_TIMEOUT_SEC = 30 * 60;
+const CLAUDE_PULL_TIMEOUT_SEC = 60 * 60;
+const CLAUDE_RUN_TIMEOUT_SEC_FALLBACK = 30 * 60;
+function compactText(value, max = 240) {
+    const compact = String(value || '').replace(/\s+/g, ' ').trim();
+    if (!compact)
+        return '';
+    if (compact.length <= max)
+        return compact;
+    return `${compact.slice(0, max - 3)}...`;
+}
+function parseJsonObjectLine(line) {
+    try {
+        const parsed = JSON.parse(line);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function readRecordString(record, key) {
+    const value = record[key];
+    return typeof value === 'string' ? value : '';
+}
+function collectClaudeTextFromContent(content) {
+    if (!Array.isArray(content))
+        return '';
+    let text = '';
+    for (const part of content) {
+        if (!part || typeof part !== 'object' || Array.isArray(part))
+            continue;
+        const node = part;
+        if (node.type === 'text' && typeof node.text === 'string') {
+            text += node.text;
+        }
+    }
+    return text;
+}
+function extractClaudeStreamSessionId(event) {
+    const direct = readRecordString(event, 'session_id').trim();
+    if (direct)
+        return direct;
+    const message = event.message;
+    if (!message || typeof message !== 'object' || Array.isArray(message))
+        return '';
+    const nested = readRecordString(message, 'session_id').trim();
+    return nested || '';
+}
+function extractClaudeAssistantSnapshot(event) {
+    const type = readRecordString(event, 'type').trim().toLowerCase();
+    if (type === 'assistant') {
+        const message = event.message;
+        if (message && typeof message === 'object' && !Array.isArray(message)) {
+            const content = message.content;
+            const contentText = collectClaudeTextFromContent(content);
+            if (contentText)
+                return contentText;
+        }
+    }
+    if (type === 'result') {
+        const resultText = readRecordString(event, 'result');
+        if (resultText)
+            return resultText;
+    }
+    return '';
+}
+function parseClaudeStream(stdout, resumeSessionId = '') {
+    const lines = String(stdout || '').split(/\r?\n/);
+    let latestSessionId = String(resumeSessionId || '').trim();
+    let assistantSnapshot = '';
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (!line)
+            continue;
+        const event = parseJsonObjectLine(line);
+        if (!event)
+            continue;
+        const sessionId = extractClaudeStreamSessionId(event);
+        if (sessionId)
+            latestSessionId = sessionId;
+        const snapshot = extractClaudeAssistantSnapshot(event);
+        if (snapshot) {
+            assistantSnapshot = snapshot;
+        }
+    }
+    return {
+        session_id: latestSessionId,
+        assistant_text: assistantSnapshot,
+    };
+}
+function extractToolNames(event) {
+    const names = [];
+    const message = event.message;
+    if (!message || typeof message !== 'object' || Array.isArray(message))
+        return names;
+    const content = message.content;
+    if (!Array.isArray(content))
+        return names;
+    for (const part of content) {
+        if (!part || typeof part !== 'object' || Array.isArray(part))
+            continue;
+        const node = part;
+        if (String(node.type || '').trim() !== 'tool_use')
+            continue;
+        const name = readRecordString(node, 'name').trim();
+        if (name)
+            names.push(name);
+    }
+    return names;
+}
+function buildClaudeActivityLog(stdout) {
+    const lines = String(stdout || '').split(/\r?\n/);
+    const activity = [];
+    let latestSessionId = '';
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (!line)
+            continue;
+        const event = parseJsonObjectLine(line);
+        if (!event)
+            continue;
+        const sessionId = extractClaudeStreamSessionId(event);
+        if (sessionId && sessionId !== latestSessionId) {
+            latestSessionId = sessionId;
+            activity.push(`[session] ${latestSessionId}`);
+        }
+        const type = readRecordString(event, 'type').trim().toLowerCase();
+        if (type === 'assistant') {
+            const snapshot = extractClaudeAssistantSnapshot(event);
+            const text = compactText(snapshot);
+            if (text)
+                activity.push(`[assistant] ${text}`);
+        }
+        else if (type === 'result') {
+            const resultText = compactText(readRecordString(event, 'result'));
+            if (resultText)
+                activity.push(`[result] ${resultText}`);
+        }
+        else if (type === 'error') {
+            const err = compactText(readRecordString(event, 'error') || readRecordString(event, 'message'));
+            if (err)
+                activity.push(`[error] ${err}`);
+        }
+        const tools = extractToolNames(event);
+        for (const tool of tools) {
+            activity.push(`[tool] ${tool}`);
+        }
+    }
+    if (activity.length === 0) {
+        return 'No structured Claude activity events were parsed from stream output.\n';
+    }
+    const maxLines = 600;
+    const truncated = activity.length > maxLines;
+    const body = truncated ? activity.slice(0, maxLines) : activity;
+    if (truncated)
+        body.push(`[truncated] kept first ${maxLines} lines`);
+    return `${body.join('\n')}\n`;
+}
+function runApptainer(args, cwd, timeoutSec) {
+    const result = (0, child_process_1.spawnSync)('apptainer', args, {
+        cwd,
+        encoding: 'utf-8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+        timeout: Math.max(1, Math.floor(timeoutSec)) * 1000,
+        maxBuffer: 64 * 1024 * 1024,
+        env: process.env,
+    });
+    const errCode = result.error?.code;
+    return {
+        status: result.status,
+        signal: result.signal ? String(result.signal) : null,
+        stdout: String(result.stdout || ''),
+        stderr: String(result.stderr || ''),
+        timeout: errCode === 'ETIMEDOUT' || result.signal === 'SIGTERM',
+    };
+}
+function ensureDisplayDbFile() {
+    const displayDbPath = (0, config_js_1.getDisplayDbPath)();
+    if ((0, fs_1.existsSync)(displayDbPath))
+        return;
+    (0, config_js_1.ensurePrivateDir)((0, path_1.dirname)(displayDbPath));
+    (0, fs_1.writeFileSync)(displayDbPath, JSON.stringify({ version: 1, events: [] }, null, 2) + '\n', {
+        encoding: 'utf-8',
+        mode: config_js_1.PRIVATE_FILE_MODE,
+    });
+}
+function buildContainerPrefixArgs(config, worktreePath, sifPath) {
+    const sandboxHome = (0, config_js_1.getSandboxHome)();
+    const args = [
+        'exec',
+        '--containall',
+        '--cleanenv',
+        '--home', `${sandboxHome}:/home/sandbox`,
+        '--bind', `${worktreePath}:/work`,
+        '--pwd', '/work',
+    ];
+    for (const mount of config.filesystem.extra_paths || []) {
+        if (!mount || typeof mount.path !== 'string')
+            continue;
+        const resolved = mount.path.replace(/^~/, (0, os_1.homedir)());
+        const target = `/mnt/${(0, path_1.basename)(resolved)}`;
+        const bindSpec = mount.mode === 'ro' ? `${resolved}:${target}:ro` : `${resolved}:${target}`;
+        args.push('--bind', bindSpec);
+    }
+    for (const ds of config.datasets || []) {
+        if (!ds || typeof ds.path !== 'string' || typeof ds.name !== 'string')
+            continue;
+        const resolved = ds.path.replace(/^~/, (0, os_1.homedir)());
+        const bindSpec = ds.mode === 'ro'
+            ? `${resolved}:/datasets/${ds.name}:ro`
+            : `${resolved}:/datasets/${ds.name}`;
+        args.push('--bind', bindSpec);
+    }
+    if ((0, fs_1.existsSync)((0, config_js_1.getConfigPath)())) {
+        args.push('--bind', `${(0, config_js_1.getConfigPath)()}:/labgate-config/config.json`);
+    }
+    args.push('--bind', `${(0, config_js_1.getDisplayDbPath)()}:/labgate-config/display.json`);
+    args.push('--env', 'HOME=/home/sandbox');
+    args.push('--env', 'ANTHROPIC_API_KEY=');
+    args.push(sifPath);
+    return args;
+}
+function ensureApptainerRuntime() {
+    const runtime = (0, runtime_js_1.checkRuntime)('apptainer');
+    if (!runtime.ok || runtime.runtime !== 'apptainer') {
+        return {
+            ok: false,
+            error: runtime.error || 'Apptainer runtime unavailable.',
+        };
+    }
+    return { ok: true };
+}
+function ensureSifImage(config, worktreePath) {
+    const imagesDir = (0, config_js_1.getImagesDir)();
+    (0, fs_1.mkdirSync)(imagesDir, { recursive: true, mode: 0o700 });
+    const sifPath = (0, path_1.join)(imagesDir, (0, container_js_1.imageToSifName)(config.image));
+    if ((0, fs_1.existsSync)(sifPath)) {
+        return { ok: true, sif_path: sifPath };
+    }
+    const pulled = runApptainer(['pull', sifPath, `docker://${config.image}`], worktreePath, CLAUDE_PULL_TIMEOUT_SEC);
+    if (pulled.status !== 0) {
+        const detail = `${pulled.stderr}\n${pulled.stdout}`.trim();
+        return {
+            ok: false,
+            error: detail || `Failed to pull Apptainer image: ${config.image}`,
+        };
+    }
+    return { ok: true, sif_path: sifPath };
+}
+function ensureClaudeBinaryReady(config, worktreePath, sifPath) {
+    const script = [
+        'set -euo pipefail',
+        'export HOME=/home/sandbox',
+        'mkdir -p "$HOME/.npm-global"',
+        'npm config set prefix "$HOME/.npm-global" 2>/dev/null || true',
+        'export PATH="$HOME/.npm-global/bin:$PATH"',
+        'if ! command -v claude >/dev/null 2>&1; then npm i -g @anthropic-ai/claude-code; fi',
+    ].join('\n');
+    const args = [
+        ...buildContainerPrefixArgs(config, worktreePath, sifPath),
+        'bash',
+        '-lc',
+        script,
+    ];
+    const result = runApptainer(args, worktreePath, CLAUDE_PREP_TIMEOUT_SEC);
+    if (result.status !== 0) {
+        const detail = `${result.stderr}\n${result.stdout}`.trim();
+        return {
+            ok: false,
+            error: detail || 'Failed to prepare Claude CLI inside Apptainer sandbox.',
+        };
+    }
+    return { ok: true };
+}
+function normalizeTimeout(raw) {
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed))
+        return CLAUDE_RUN_TIMEOUT_SEC_FALLBACK;
+    return Math.max(30, Math.min(4 * 60 * 60, Math.floor(parsed)));
+}
+function runClaudeHeadlessInWorktree(input) {
+    const worktreePath = (0, path_1.resolve)(String(input.worktree_path || '').trim());
+    const prompt = String(input.prompt || '').trim();
+    const resumeSessionId = String(input.resume_session_id || '').trim();
+    const timeoutSec = normalizeTimeout(input.timeout_sec);
+    if (!worktreePath) {
+        return { ok: false, error: 'worktree_path is required' };
+    }
+    if (!prompt) {
+        return { ok: false, error: 'prompt is required' };
+    }
+    if (!(0, fs_1.existsSync)(worktreePath)) {
+        return { ok: false, error: `worktree not found: ${worktreePath}` };
+    }
+    const runtime = ensureApptainerRuntime();
+    if (!runtime.ok)
+        return runtime;
+    const config = (0, config_js_1.loadConfig)();
+    ensureDisplayDbFile();
+    const image = ensureSifImage(config, worktreePath);
+    if (!image.ok)
+        return image;
+    const ready = ensureClaudeBinaryReady(config, worktreePath, image.sif_path);
+    if (!ready.ok)
+        return ready;
+    const args = [
+        ...buildContainerPrefixArgs(config, worktreePath, image.sif_path),
+        '/home/sandbox/.npm-global/bin/claude',
+        '-p',
+        '--verbose',
+        '--output-format',
+        'stream-json',
+        '--include-partial-messages',
+        ...(resumeSessionId ? ['--resume', resumeSessionId] : []),
+        prompt,
+    ];
+    const result = runApptainer(args, worktreePath, timeoutSec);
+    const parsed = parseClaudeStream(result.stdout, resumeSessionId);
+    if (result.timeout) {
+        return {
+            ok: false,
+            session_id: parsed.session_id || undefined,
+            assistant_text: parsed.assistant_text || undefined,
+            stdout: result.stdout,
+            stderr: result.stderr,
+            error: `Claude headless run timed out after ${timeoutSec}s`,
+        };
+    }
+    if (result.status !== 0) {
+        const detail = `${result.stderr}\n${result.stdout}`.trim();
+        return {
+            ok: false,
+            session_id: parsed.session_id || undefined,
+            assistant_text: parsed.assistant_text || undefined,
+            stdout: result.stdout,
+            stderr: result.stderr,
+            error: detail || `Claude headless run failed with status ${result.status}`,
+        };
+    }
+    return {
+        ok: true,
+        session_id: parsed.session_id || undefined,
+        assistant_text: parsed.assistant_text || undefined,
+        stdout: result.stdout,
+        stderr: result.stderr,
+    };
+}
+//# sourceMappingURL=explorer-claude.js.map

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

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

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

@@ -0,0 +1,9 @@
+import { ExplorerStore } from './explorer-store.js';
+import type { RunCompareResult } from './explorer-types.js';
+export interface RunCompareInput {
+    experiment_id: string;
+    run_id: string;
+    compare_to?: 'best' | 'parent' | string;
+    include_patch?: boolean;
+}
+export declare function runCompare(input: RunCompareInput, store: ExplorerStore): RunCompareResult;

package/dist/lib/explorer-compare.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCompare = runCompare;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const config_js_1 = require("./config.js");
+function runGit(repoPath, args) {
+    return String((0, child_process_1.execFileSync)('git', ['-C', repoPath, ...args], {
+        encoding: 'utf-8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    }));
+}
+function parseMetrics(metricsJson) {
+    if (!metricsJson)
+        return {};
+    try {
+        const parsed = JSON.parse(metricsJson);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            return {};
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+function flattenNumericMetrics(value, prefix = '', out = {}) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        if (prefix)
+            out[prefix] = value;
+        return out;
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return out;
+    for (const [key, child] of Object.entries(value)) {
+        const nextPrefix = prefix ? `${prefix}.${key}` : key;
+        flattenNumericMetrics(child, nextPrefix, out);
+    }
+    return out;
+}
+function parseNameStatus(raw) {
+    const files = [];
+    for (const line of raw.split(/\r?\n/)) {
+        if (!line)
+            continue;
+        const fields = line.split('\t');
+        if (fields.length < 2)
+            continue;
+        const statusRaw = String(fields[0] || 'M').trim();
+        const statusLead = statusRaw[0];
+        const status = statusRaw.startsWith('R')
+            ? 'R'
+            : (statusLead === 'A' || statusLead === 'M' || statusLead === 'D' ? statusLead : 'M');
+        const path = statusRaw.startsWith('R')
+            ? String(fields[2] || fields[1] || '')
+            : String(fields[1] || '');
+        if (!path)
+            continue;
+        files.push({ path, status });
+    }
+    return files;
+}
+function parseShortStat(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return {};
+    const insMatch = trimmed.match(/(\d+)\s+insertions?\(\+\)/i);
+    const delMatch = trimmed.match(/(\d+)\s+deletions?\(-\)/i);
+    const insertions = insMatch ? Number(insMatch[1]) : undefined;
+    const deletions = delMatch ? Number(delMatch[1]) : undefined;
+    return {
+        insertions: Number.isFinite(insertions) ? insertions : undefined,
+        deletions: Number.isFinite(deletions) ? deletions : undefined,
+    };
+}
+function runCompare(input, store) {
+    const experimentId = String(input.experiment_id || '').trim();
+    const runId = String(input.run_id || '').trim();
+    const compareTo = String(input.compare_to || 'best').trim();
+    if (!experimentId)
+        throw new Error('experiment_id is required');
+    if (!runId)
+        throw new Error('run_id is required');
+    const experiment = store.getExperiment(experimentId);
+    if (!experiment)
+        throw new Error(`Experiment not found: ${experimentId}`);
+    const aRun = store.getRun(runId);
+    if (!aRun || aRun.experiment_id !== experimentId) {
+        throw new Error(`Run not found in experiment: ${runId}`);
+    }
+    if (!aRun.commit_sha) {
+        throw new Error(`Run ${runId} has no commit_sha`);
+    }
+    let bRunId = null;
+    let bCommitSha = '';
+    let bScore;
+    let bMetrics;
+    if (compareTo === 'best') {
+        const best = store.getBestRun(experimentId);
+        if (!best || !best.commit_sha) {
+            throw new Error(`No best run with commit found for experiment: ${experimentId}`);
+        }
+        bRunId = best.id;
+        bCommitSha = best.commit_sha;
+        if (best.score != null)
+            bScore = best.score;
+        bMetrics = parseMetrics(best.metrics_json);
+    }
+    else if (compareTo === 'parent') {
+        if (aRun.parent_run_id) {
+            const parent = store.getRun(aRun.parent_run_id);
+            if (!parent || !parent.commit_sha) {
+                throw new Error(`Parent run missing or has no commit: ${aRun.parent_run_id}`);
+            }
+            bRunId = parent.id;
+            bCommitSha = parent.commit_sha;
+            if (parent.score != null)
+                bScore = parent.score;
+            bMetrics = parseMetrics(parent.metrics_json);
+        }
+        else {
+            bRunId = null;
+            bCommitSha = aRun.parent_commit_sha;
+            bScore = undefined;
+            bMetrics = {};
+        }
+    }
+    else {
+        const other = store.getRun(compareTo);
+        if (!other || other.experiment_id !== experimentId || !other.commit_sha) {
+            throw new Error(`Comparison run missing or has no commit: ${compareTo}`);
+        }
+        bRunId = other.id;
+        bCommitSha = other.commit_sha;
+        if (other.score != null)
+            bScore = other.score;
+        bMetrics = parseMetrics(other.metrics_json);
+    }
+    if (!bCommitSha) {
+        throw new Error('comparison commit sha is missing');
+    }
+    const nameStatusRaw = runGit(experiment.repo_path, ['diff', '--name-status', `${bCommitSha}..${aRun.commit_sha}`]);
+    const shortStatRaw = runGit(experiment.repo_path, ['diff', '--shortstat', `${bCommitSha}..${aRun.commit_sha}`]);
+    const filesChanged = parseNameStatus(nameStatusRaw);
+    const short = parseShortStat(shortStatRaw);
+    let patchPath;
+    if (input.include_patch) {
+        const compareDir = (0, config_js_1.getExplorerCompareArtifactDir)(experimentId);
+        (0, fs_1.mkdirSync)(compareDir, { recursive: true, mode: 0o700 });
+        const safeB = (bRunId || 'base').replace(/[^a-zA-Z0-9._-]+/g, '_');
+        const target = (0, path_1.join)(compareDir, `${aRun.id}_vs_${safeB}.patch`);
+        const patchText = runGit(experiment.repo_path, ['diff', '--binary', `${bCommitSha}..${aRun.commit_sha}`]);
+        (0, fs_1.writeFileSync)(target, patchText, 'utf-8');
+        patchPath = target;
+    }
+    const aMetrics = parseMetrics(aRun.metrics_json);
+    const aFlat = flattenNumericMetrics(aMetrics);
+    const bFlat = flattenNumericMetrics(bMetrics || {});
+    const metricDeltas = {};
+    for (const [key, aValue] of Object.entries(aFlat)) {
+        const bValue = bFlat[key];
+        if (!Number.isFinite(bValue))
+            continue;
+        metricDeltas[key] = aValue - bValue;
+    }
+    const result = {
+        a_run_id: aRun.id,
+        b_run_id: bRunId,
+        a_commit_sha: aRun.commit_sha,
+        b_commit_sha: bCommitSha,
+        diff: {
+            files_changed: filesChanged,
+            insertions: short.insertions,
+            deletions: short.deletions,
+            patch_path: patchPath,
+        },
+    };
+    if (aRun.score != null)
+        result.a_score = aRun.score;
+    if (bScore != null)
+        result.b_score = bScore;
+    if (aRun.score != null && bScore != null) {
+        result.score_delta = aRun.score - bScore;
+    }
+    result.a_metrics = aMetrics;
+    result.b_metrics = bMetrics || {};
+    result.metric_deltas = metricDeltas;
+    return result;
+}
+//# sourceMappingURL=explorer-compare.js.map

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

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

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

@@ -0,0 +1,23 @@
+import type { RunStatus } from './explorer-types.js';
+export interface EvalRunResult {
+    status: Extract<RunStatus, 'eval_ok' | 'failed_eval' | 'timeout' | 'invalid_output'>;
+    score?: number;
+    metrics?: Record<string, unknown>;
+    stdout_path: string;
+    stderr_path: string;
+    eval_command: string;
+    exit_code: number | null;
+    signal: string | null;
+    started_at: string;
+    finished_at: string;
+    runtime_ms: number;
+    error?: string;
+}
+export interface EvalRunOptions {
+    worktree_path: string;
+    eval_command: string;
+    timeout_sec: number;
+    artifact_dir: string;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function runEvaluation(opts: EvalRunOptions): EvalRunResult;