labgate 0.5.31 → 0.5.33

package/dist/lib/explorer-retention.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultRetentionPolicy = defaultRetentionPolicy;
+exports.normalizeRetentionPolicy = normalizeRetentionPolicy;
+exports.mergeRetentionPolicy = mergeRetentionPolicy;
+const DEFAULT_RETENTION_POLICY = {
+    keep_worktrees: false,
+    artifacts: 'minimal',
+    keep_last_n: 50,
+    keep_best: true,
+    keep_failed_last_n: 20,
+    max_delete_runs: 200,
+};
+function clampInt(value, fallback, min, max) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed))
+        return fallback;
+    return Math.max(min, Math.min(max, Math.floor(parsed)));
+}
+function normalizeArtifactMode(value) {
+    const mode = String(value || '').trim().toLowerCase();
+    if (mode === 'all' || mode === 'minimal' || mode === 'none') {
+        return mode;
+    }
+    return DEFAULT_RETENTION_POLICY.artifacts;
+}
+function defaultRetentionPolicy() {
+    return { ...DEFAULT_RETENTION_POLICY };
+}
+function normalizeRetentionPolicy(input) {
+    const obj = input && typeof input === 'object' && !Array.isArray(input)
+        ? input
+        : {};
+    const pruneAfterRaw = obj.prune_artifacts_after_days;
+    const pruneAfterParsed = Number(pruneAfterRaw);
+    const pruneAfter = Number.isFinite(pruneAfterParsed)
+        ? Math.max(1, Math.min(3650, Math.floor(pruneAfterParsed)))
+        : undefined;
+    return {
+        keep_worktrees: obj.keep_worktrees === true,
+        artifacts: normalizeArtifactMode(obj.artifacts),
+        keep_last_n: clampInt(obj.keep_last_n, DEFAULT_RETENTION_POLICY.keep_last_n, 0, 100_000),
+        keep_best: obj.keep_best !== false,
+        keep_failed_last_n: clampInt(obj.keep_failed_last_n, DEFAULT_RETENTION_POLICY.keep_failed_last_n, 0, 100_000),
+        prune_artifacts_after_days: pruneAfter,
+        max_delete_runs: clampInt(obj.max_delete_runs, DEFAULT_RETENTION_POLICY.max_delete_runs || 200, 1, 10_000),
+    };
+}
+function mergeRetentionPolicy(base, override) {
+    if (!override)
+        return { ...base };
+    const merged = {
+        ...base,
+        ...override,
+    };
+    return normalizeRetentionPolicy(merged);
+}
+//# sourceMappingURL=explorer-retention.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explorer-retention.js","sourceRoot":"","sources":["../../src/lib/explorer-retention.ts"],"names":[],"mappings":";;AAyBA,wDAEC;AAED,4DAoBC;AAED,oDAOC;AAxDD,MAAM,wBAAwB,GAAoB;IAChD,cAAc,EAAE,KAAK;IACrB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,EAAE;IACf,SAAS,EAAE,IAAI;IACf,kBAAkB,EAAE,EAAE;IACtB,eAAe,EAAE,GAAG;CACrB,CAAC;AAEF,SAAS,QAAQ,CAAC,KAAc,EAAE,QAAgB,EAAE,GAAW,EAAE,GAAW;IAC1E,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtD,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,wBAAwB,CAAC,SAAS,CAAC;AAC5C,CAAC;AAED,SAAgB,sBAAsB;IACpC,OAAO,EAAE,GAAG,wBAAwB,EAAE,CAAC;AACzC,CAAC;AAED,SAAgB,wBAAwB,CAAC,KAAc;IACrD,MAAM,GAAG,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrE,CAAC,CAAC,KAAgC;QAClC,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,aAAa,GAAG,GAAG,CAAC,0BAA0B,CAAC;IACrD,MAAM,gBAAgB,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAClD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,cAAc,EAAE,GAAG,CAAC,cAAc,KAAK,IAAI;QAC3C,SAAS,EAAE,qBAAqB,CAAC,GAAG,CAAC,SAAS,CAAC;QAC/C,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,wBAAwB,CAAC,WAAW,EAAE,CAAC,EAAE,OAAO,CAAC;QACxF,SAAS,EAAE,GAAG,CAAC,SAAS,KAAK,KAAK;QAClC,kBAAkB,EAAE,QAAQ,CAAC,GAAG,CAAC,kBAAkB,EAAE,wBAAwB,CAAC,kBAAkB,EAAE,CAAC,EAAE,OAAO,CAAC;QAC7G,0BAA0B,EAAE,UAAU;QACtC,eAAe,EAAE,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,wBAAwB,CAAC,eAAe,IAAI,GAAG,EAAE,CAAC,EAAE,MAAM,CAAC;KAC3G,CAAC;AACJ,CAAC;AAED,SAAgB,oBAAoB,CAAC,IAAqB,EAAE,QAA0C;IACpG,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IAClC,MAAM,MAAM,GAA4B;QACtC,GAAG,IAAI;QACP,GAAG,QAAQ;KACZ,CAAC;IACF,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC"}

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

@@ -0,0 +1,77 @@
+import type { ArtifactRetentionMode, EventType, ExperimentStatus, ExplorerEvent, ExplorerExperiment, ExplorerRun, ExperimentOverview, LeaderboardRow, RunStatus, TreeView } from './explorer-types.js';
+export interface CreateExperimentInput {
+    id?: string;
+    name: string;
+    repo_path: string;
+    base_ref: string;
+    eval_command: string;
+    eval_timeout_sec?: number;
+    policy_json?: string;
+    constraints_json?: string;
+    prompt_preamble?: string;
+}
+export interface CreateRunInput {
+    id?: string;
+    experiment_id: string;
+    parent_run_id?: string | null;
+    parent_commit_sha: string;
+    branch_name: string;
+    worktree_path: string;
+    model?: string;
+    artifact_dir: string;
+}
+export interface RecordRunResultInput {
+    status: RunStatus;
+    score?: number | null;
+    metrics_json?: string | null;
+    summary_md?: string;
+}
+export interface ListRunsOptions {
+    limit?: number;
+    offset?: number;
+}
+export interface ListEventsOptions {
+    limit?: number;
+    offset?: number;
+}
+export declare function makeExplorerExperimentId(): string;
+export declare function makeExplorerRunId(): string;
+export declare class ExplorerStore {
+    private readonly dbPath;
+    private db;
+    private useJsonFallback;
+    private jsonPath;
+    private jsonStore;
+    constructor(dbPath?: string);
+    getPath(): string;
+    createExperiment(input: CreateExperimentInput): ExplorerExperiment;
+    listExperiments(limit?: number, offset?: number): ExplorerExperiment[];
+    getExperiment(experimentId: string): ExplorerExperiment | null;
+    setExperimentStatus(experimentId: string, status: ExperimentStatus): boolean;
+    createRun(input: CreateRunInput): ExplorerRun;
+    markRunStarted(runId: string): boolean;
+    recordRunCommit(runId: string, commitSha: string): boolean;
+    recordRunResult(runId: string, result: RecordRunResultInput): boolean;
+    getRun(runId: string): ExplorerRun | null;
+    listRuns(experimentId: string, opts?: ListRunsOptions): ExplorerRun[];
+    getBestRun(experimentId: string): ExplorerRun | null;
+    hasActiveRun(experimentId: string): boolean;
+    listActiveRuns(experimentId: string): ExplorerRun[];
+    getRunCount(experimentId: string): number;
+    getRunStatusCounts(experimentId: string): Record<RunStatus, number>;
+    getLatestRun(experimentId: string): ExplorerRun | null;
+    getExperimentOverview(experimentId: string): ExperimentOverview | null;
+    getRetentionPolicy(experimentId: string): import("./explorer-types.js").RetentionPolicy;
+    setRetentionPolicy(experimentId: string, retention: unknown): boolean;
+    setRunWorktreePruned(runId: string, prunedAt?: string): boolean;
+    setRunArtifactsPruned(runId: string, modeKept: ArtifactRetentionMode, prunedAt?: string): boolean;
+    listFinishedRuns(experimentId: string): ExplorerRun[];
+    createEvent(experimentId: string, type: EventType, payload: Record<string, unknown>, runId?: string | null): ExplorerEvent;
+    listEvents(experimentId: string, opts?: ListEventsOptions): ExplorerEvent[];
+    getLeaderboard(experimentId: string, topK?: number): LeaderboardRow[];
+    getTree(experimentId: string, mode?: 'best_path' | 'full'): TreeView;
+    close(): void;
+    private getAllRunsForTree;
+    private loadJson;
+    private flushJson;
+}