backlot 0.4.0

package/dist/cli/index.js

@@ -0,0 +1,308 @@
+#!/usr/bin/env node
+/**
+ * backlot CLI. Contract: every verb accepts --json (stdout = data, stderr =
+ * human); exit codes are contractual — 0 ok, 1 work-error, 2 env-error,
+ * 3 infra-error, 64 usage. See docs/architecture.md §11.
+ */
+import { ensureDaemon, rpc } from './client.js';
+const USAGE = `backlot — puts a working instance of a web application in front of you.
+
+Usage:
+  backlot up [--watch] [--reset-data|--pristine] [--ttl <minutes>]
+                          session lease: sync, upkeep, start services, print context
+  backlot run <check> [--pristine] [--pull] [--detach]
+                          run lease: bind -> execute the check -> verdict -> release
+                          --detach: submit-and-poll — returns a jobId immediately
+  backlot job <jobId>     poll a detached run (pending|running|done + verdict)
+  backlot ctx             the consumer context blob (URLs, logins, conn strings)
+  backlot sync            project the worktree state into the current lease
+  backlot exec <cmd...>   run a command inside the leased environment
+  backlot logs <service> [--lines N]
+  backlot reset-data      restore the data template on the current lease
+  backlot token --role <r>  mint an auth token via the stack's auth.token hook
+  backlot pull            copy declared outputs back into the worktree
+  backlot release         release the current lease (environment stays warm)
+  backlot status          daemon, pool, and lease overview
+  backlot pool ls|recycle [--all]
+  backlot daemon stop     stop the daemon (environments are recovered on next use)
+
+Every verb accepts --json. Long verbs (up/run/sync/bind/reset-data) show live progress
+on a terminal (stderr); force with --progress, silence with --quiet. stdout stays clean.
+Exit codes: 0 ok · 1 work-error · 2 env-error · 3 infra-error · 64 usage.`;
+const rawArgv = process.argv.slice(2);
+const verb = rawArgv[0];
+// Known flags and whether each takes a value. A proper single-pass parser so a
+// flag's value is never mis-bound as a positional (and an inner command's own
+// flags survive) — the F1 class of argv bugs. Everything after a lone `--`, and
+// EVERYTHING for `exec`, is treated as a raw passthrough command.
+const VALUE_FLAGS = new Set(['--holder', '--ttl', '--role', '--lines', '--ref', '--spec', '--preset']);
+const BOOL_FLAGS = new Set(['--json', '--watch', '--reset-data', '--pristine', '--pull', '--detach', '--all', '--raw', '--progress', '--quiet']);
+const flagVals = new Map();
+const flags = new Set();
+const positional = [];
+let passthrough = null; // for `exec` / after `--`
+{
+    const body = rawArgv.slice(1);
+    for (let i = 0; i < body.length; i++) {
+        const a = body[i];
+        // `exec` consumes the entire remainder verbatim (its own flags included),
+        // except a leading `--json` which is ours; `--` also opens passthrough.
+        if (verb === 'exec' && passthrough === null && a !== '--json' && !a.startsWith('--')) {
+            passthrough = body.slice(i);
+            break;
+        }
+        if (a === '--') {
+            passthrough = body.slice(i + 1);
+            break;
+        }
+        if (VALUE_FLAGS.has(a)) {
+            const v = body[i + 1];
+            if (v === undefined) {
+                console.error(`backlot: ${a} needs a value`);
+                process.exit(64);
+            }
+            flagVals.set(a, v);
+            i++;
+        }
+        else if (BOOL_FLAGS.has(a)) {
+            flags.add(a);
+        }
+        else if (a.startsWith('--')) {
+            console.error(`backlot: unknown flag '${a}'`);
+            process.exit(64);
+        }
+        else {
+            positional.push(a);
+        }
+    }
+}
+const json = flags.has('--json');
+const flagValue = (name) => flagVals.get(name);
+const out = (data) => console.log(json ? JSON.stringify(data, null, json ? 0 : 2) : humanize(data));
+const errExit = (e) => {
+    const code = e.class === 'work-error' ? 1 : e.class === 'infra-error' ? 3 : 2;
+    if (json)
+        console.log(JSON.stringify({ ok: false, error: e }));
+    else {
+        console.error(`backlot: [${e.class ?? e.code ?? 'error'}] ${e.message}${e.source ? ` (${e.source})` : ''}`);
+        if (e.logExcerpt)
+            console.error(`--- log excerpt ---\n${e.logExcerpt}`);
+    }
+    process.exit(code);
+};
+function humanize(data) {
+    return JSON.stringify(data, null, 2);
+}
+// Progress -> stderr, shown for humans (a TTY) or on --progress; --quiet forces
+// off. Never touches stdout, so the --json payload stays clean for agents.
+const showProgress = flags.has('--progress') || (process.stderr.isTTY === true && !flags.has('--quiet') && !flags.has('--json'));
+let lastProgressLen = 0;
+const progress = showProgress
+    ? (phase) => {
+        const line = `  ⋯ ${phase}`;
+        // Redraw in place on a TTY so the phase log stays a single moving line.
+        if (process.stderr.isTTY) {
+            process.stderr.write(`\r${line}${' '.repeat(Math.max(0, lastProgressLen - line.length))}`);
+            lastProgressLen = line.length;
+        }
+        else {
+            process.stderr.write(line + '\n');
+        }
+    }
+    : undefined;
+const endProgress = () => {
+    if (showProgress && process.stderr.isTTY && lastProgressLen)
+        process.stderr.write('\r' + ' '.repeat(lastProgressLen) + '\r');
+};
+/** --ttl is in MINUTES; accepts a bare number or an explicit `<n>m`. Returns ms or undefined if invalid. */
+function parseTtlMinutes(v) {
+    const m = /^(\d+(?:\.\d+)?)m?$/.exec(v.trim());
+    if (!m)
+        return undefined;
+    const mins = Number(m[1]);
+    if (!Number.isFinite(mins) || mins <= 0)
+        return undefined;
+    return mins * 60_000;
+}
+function hygiene() {
+    if (flags.has('--pristine'))
+        return 'pristine';
+    if (flags.has('--reset-data'))
+        return 'reset-data';
+    return undefined;
+}
+async function main() {
+    if (!verb || verb === 'help' || verb === '--help' || verb === '-h') {
+        console.log(USAGE);
+        return;
+    }
+    const known = ['up', 'run', 'job', 'ctx', 'sync', 'bind', 'exec', 'logs', 'token', 'reset-data', 'pull', 'release', 'status', 'doctor', 'pool', 'daemon'];
+    if (!known.includes(verb)) {
+        console.error(`backlot: unknown verb '${verb}'\n\n${USAGE}`);
+        process.exit(64);
+    }
+    await ensureDaemon();
+    const cwd = process.cwd();
+    const holder = flagValue('--holder');
+    let res;
+    switch (verb) {
+        case 'up': {
+            const ttl = flagValue('--ttl');
+            let ttlMs;
+            if (ttl !== undefined) {
+                ttlMs = parseTtlMinutes(ttl);
+                if (ttlMs === undefined) {
+                    console.error(`backlot: --ttl expects minutes (a positive number), got '${ttl}'`);
+                    process.exit(64);
+                }
+            }
+            res = await rpc('up', { cwd, holder, hygiene: hygiene(), watch: flags.has('--watch'), ttlMs }, progress);
+            endProgress();
+            break;
+        }
+        case 'run': {
+            const check = positional[0];
+            if (!check) {
+                console.error(`backlot run: which check? (usage: backlot run <check>)`);
+                process.exit(64);
+            }
+            if (flags.has('--detach')) {
+                res = await rpc('run-detach', { cwd, holder, check, hygiene: hygiene() });
+                if (res.ok) {
+                    out(res.data);
+                    return;
+                }
+            }
+            else {
+                res = await rpc('run', { cwd, holder, check, hygiene: hygiene() }, progress);
+                endProgress();
+                if (res.ok && flags.has('--pull'))
+                    await rpc('pull', { cwd, holder });
+            }
+            break;
+        }
+        case 'job': {
+            const jobId = positional[0];
+            if (!jobId) {
+                console.error('backlot job: which job? (usage: backlot job <jobId> | backlot job ls)');
+                process.exit(64);
+            }
+            res = jobId === 'ls' ? await rpc('job-ls', {}) : await rpc('job', { jobId });
+            break;
+        }
+        case 'ctx':
+            res = await rpc('ctx', { cwd, holder });
+            break;
+        case 'sync':
+            res = await rpc('sync', { cwd, holder }, progress);
+            endProgress();
+            break;
+        case 'bind': {
+            const ref = flagValue('--ref');
+            res = ref ? await rpc('bind-ref', { cwd, holder, ref }, progress) : await rpc('sync', { cwd, holder }, progress);
+            endProgress();
+            break;
+        }
+        case 'exec': {
+            // The whole passthrough is the command, verbatim — its own --flags intact.
+            const cmd = (passthrough ?? positional).join(' ');
+            if (!cmd) {
+                console.error('backlot exec: no command given');
+                process.exit(64);
+            }
+            res = await rpc('exec', { cwd, holder, cmd });
+            if (res.ok) {
+                const d = res.data;
+                if (json)
+                    console.log(JSON.stringify({ ok: d.exitCode === 0, ...d }));
+                else {
+                    if (d.stdout)
+                        process.stdout.write(d.stdout);
+                    if (d.stderr)
+                        process.stderr.write(d.stderr);
+                }
+                process.exit(d.exitCode === 0 ? 0 : 1);
+            }
+            break;
+        }
+        case 'logs': {
+            const service = positional[0];
+            if (!service) {
+                console.error('backlot logs: which service?');
+                process.exit(64);
+            }
+            res = await rpc('logs', { cwd, holder, service, lines: Number(flagValue('--lines') ?? 40) });
+            if (res.ok && !json) {
+                console.log(res.data.lines);
+                return;
+            }
+            break;
+        }
+        case 'reset-data':
+            res = await rpc('reset-data', { cwd, holder }, progress);
+            endProgress();
+            break;
+        case 'token':
+            res = await rpc('token', { cwd, holder, role: flagValue('--role') ?? 'admin' });
+            break;
+        case 'pull':
+            res = await rpc('pull', { cwd, holder });
+            break;
+        case 'release':
+            res = await rpc('release', { cwd, holder });
+            break;
+        case 'status':
+            res = await rpc('status', {});
+            break;
+        case 'doctor':
+            res = await rpc('doctor', {});
+            break;
+        case 'pool': {
+            const sub = positional[0] ?? 'ls';
+            if (sub === 'ls')
+                res = await rpc('status', {});
+            else if (sub === 'recycle')
+                res = await rpc('pool-recycle', { all: flags.has('--all') });
+            else if (sub === 'reconcile')
+                res = await rpc('pool-reconcile', {});
+            else if (sub === 'doctor')
+                res = await rpc('doctor', {});
+            else {
+                console.error(`backlot pool: unknown subcommand '${sub}' (ls | recycle | reconcile | doctor)`);
+                process.exit(64);
+            }
+            break;
+        }
+        case 'daemon': {
+            if (positional[0] !== 'stop') {
+                console.error('backlot daemon: only `stop` is supported');
+                process.exit(64);
+            }
+            res = await rpc('shutdown', {});
+            break;
+        }
+        default:
+            process.exit(64);
+    }
+    if (!res)
+        process.exit(0);
+    if (!res.ok) {
+        errExit(res.error);
+        return;
+    }
+    if (verb === 'run') {
+        const v = res.data;
+        out(res.data);
+        process.exit(v.ok ? 0 : 1);
+    }
+    out(res.data);
+}
+main().catch((err) => {
+    const msg = String(err.message ?? err);
+    if (json)
+        console.log(JSON.stringify({ ok: false, error: { class: 'env-error', message: msg } }));
+    else
+        console.error(`backlot: ${msg}`);
+    process.exit(2);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/core/events.d.ts

@@ -0,0 +1,10 @@
+export type EventLevel = 'info' | 'warn' | 'error';
+export interface DaemonEvent {
+    at: number;
+    level: EventLevel;
+    kind: string;
+    envId?: string;
+    detail?: string;
+}
+export declare function logEvent(e: Omit<DaemonEvent, 'at'>): void;
+export declare function recentEvents(limit?: number): DaemonEvent[];

package/dist/core/events.js

@@ -0,0 +1,42 @@
+/**
+ * Structured daemon event log (task: observability). Failures used to vanish
+ * into swallowed catches; this makes them visible. Append-only JSONL under the
+ * state dir, size-capped in place, read back by `status`/`doctor`.
+ */
+import { appendFileSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { stateRoot } from './paths.js';
+const logPath = () => join(stateRoot(), 'events.jsonl');
+const CAP = 512 * 1024;
+export function logEvent(e) {
+    const line = JSON.stringify({ at: Date.now(), ...e }) + '\n';
+    try {
+        const p = logPath();
+        try {
+            if (statSync(p).size > CAP) {
+                const kept = readFileSync(p, 'utf8').split('\n').slice(-500).join('\n');
+                writeFileSync(p, kept);
+            }
+        }
+        catch {
+            /* no file yet */
+        }
+        appendFileSync(p, line);
+    }
+    catch {
+        /* logging must never throw into a caller */
+    }
+}
+export function recentEvents(limit = 30) {
+    try {
+        return readFileSync(logPath(), 'utf8')
+            .split('\n')
+            .filter(Boolean)
+            .slice(-limit)
+            .map((l) => JSON.parse(l));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/core/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/core/events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAWvC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,cAAc,CAAC,CAAC;AACxD,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;AAEvB,MAAM,UAAU,QAAQ,CAAC,CAA0B;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxE,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;QACD,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,4CAA4C;IAC9C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAK,GAAG,EAAE;IACrC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC;aACnC,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,OAAO,CAAC;aACf,KAAK,CAAC,CAAC,KAAK,CAAC;aACb,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAgB,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/core/journal.d.ts

@@ -0,0 +1,80 @@
+import type { EnvState, Hygiene, LeaseKind } from './types.js';
+export interface EnvRow {
+    id: string;
+    stack: string;
+    stackRoot: string;
+    state: EnvState;
+    root: string;
+    ports: Record<string, number>;
+    datastoreNs: Record<string, string>;
+    fingerprints: Record<string, string>;
+    presets: Record<string, string>;
+    bindCount: number;
+    createdAt: number;
+    lastUsedAt: number;
+    servicePids: Record<string, number>;
+    /** Consecutive bind failures — >= 2 auto-escalates the next bind to pristine (decision 0007). */
+    failStreak: number;
+}
+export interface LeaseRow {
+    id: string;
+    envId: string;
+    kind: LeaseKind;
+    holder: string;
+    hygiene: Hygiene;
+    expiresAt: number;
+}
+export declare class Journal {
+    private db;
+    constructor(path?: string);
+    private rowToEnv;
+    saveEnv(e: EnvRow): void;
+    getEnv(id: string): EnvRow | undefined;
+    envsForStack(stack: string): EnvRow[];
+    allEnvs(): EnvRow[];
+    deleteEnv(id: string): void;
+    /**
+     * A per-stack env sequence that NEVER reuses a number, even after envs are
+     * reaped — so a recycled env's id can't collide with a live one. Monotonic
+     * in the journal, survives daemon restarts.
+     */
+    nextEnvSeq(stack: string): number;
+    /** Update just the recorded service pids (auto-restart keeps recovery honest). */
+    updateServicePids(id: string, pids: Record<string, number>): void;
+    saveLease(l: LeaseRow): void;
+    private rowToLease;
+    leaseForHolder(holder: string, stack: string): LeaseRow | undefined;
+    leaseForEnv(envId: string): LeaseRow | undefined;
+    allLeases(): LeaseRow[];
+    deleteLease(id: string): void;
+    saveJob(job: {
+        id: string;
+        stackCwd: string;
+        check: string;
+        state: string;
+        verdict?: unknown;
+        finishedAt?: number;
+    }): void;
+    getJob(id: string): {
+        id: string;
+        check: string;
+        state: string;
+        verdict: unknown;
+        createdAt: number;
+        finishedAt: number | null;
+    } | undefined;
+    listJobs(limit?: number): Array<{
+        id: string;
+        check: string;
+        state: string;
+        ok: boolean | null;
+        createdAt: number;
+        finishedAt: number | null;
+    }>;
+    /** Recovery: a job left 'running'/'pending' by a dead daemon can never finish. */
+    failStaleJobs(): number;
+    /** Retention: done jobs finished before the cutoff leave the journal. */
+    pruneJobs(cutoffMs: number): number;
+    /** Shift every deadline by `ms` — the sleep pardon (decision 0009). */
+    pardon(ms: number): void;
+}

package/dist/core/journal.js

@@ -0,0 +1,186 @@
+/**
+ * The per-machine journal: disk is truth, daemon memory is a cache
+ * (decision 0009). node:sqlite — zero native deps.
+ */
+import { DatabaseSync } from 'node:sqlite';
+import { journalPath } from './paths.js';
+export class Journal {
+    db;
+    constructor(path = journalPath()) {
+        this.db = new DatabaseSync(path);
+        this.db.exec('PRAGMA journal_mode = WAL');
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS envs (
+        id TEXT PRIMARY KEY, stack TEXT NOT NULL, stack_root TEXT NOT NULL,
+        state TEXT NOT NULL, root TEXT NOT NULL,
+        ports TEXT NOT NULL DEFAULT '{}', datastore_ns TEXT NOT NULL DEFAULT '{}',
+        fingerprints TEXT NOT NULL DEFAULT '{}', presets TEXT NOT NULL DEFAULT '{}',
+        bind_count INTEGER NOT NULL DEFAULT 0,
+        created_at INTEGER NOT NULL, last_used_at INTEGER NOT NULL,
+        service_pids TEXT NOT NULL DEFAULT '{}',
+        fail_streak INTEGER NOT NULL DEFAULT 0
+      );
+      CREATE TABLE IF NOT EXISTS leases (
+        id TEXT PRIMARY KEY, env_id TEXT NOT NULL, kind TEXT NOT NULL,
+        holder TEXT NOT NULL, hygiene TEXT NOT NULL, expires_at INTEGER NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS jobs (
+        id TEXT PRIMARY KEY, stack_cwd TEXT NOT NULL, check_name TEXT NOT NULL,
+        state TEXT NOT NULL, verdict TEXT, created_at INTEGER NOT NULL, finished_at INTEGER
+      );
+      CREATE TABLE IF NOT EXISTS counters (
+        stack TEXT PRIMARY KEY, next_env INTEGER NOT NULL DEFAULT 1
+      );
+    `);
+        // Migration for journals created before fail_streak existed.
+        try {
+            this.db.exec("ALTER TABLE envs ADD COLUMN fail_streak INTEGER NOT NULL DEFAULT 0");
+        }
+        catch {
+            /* column already exists */
+        }
+    }
+    rowToEnv(r) {
+        return {
+            id: r.id,
+            stack: r.stack,
+            stackRoot: r.stack_root,
+            state: r.state,
+            root: r.root,
+            ports: JSON.parse(r.ports),
+            datastoreNs: JSON.parse(r.datastore_ns),
+            fingerprints: JSON.parse(r.fingerprints),
+            presets: JSON.parse(r.presets),
+            bindCount: r.bind_count,
+            createdAt: r.created_at,
+            lastUsedAt: r.last_used_at,
+            servicePids: JSON.parse(r.service_pids),
+            failStreak: r.fail_streak ?? 0,
+        };
+    }
+    saveEnv(e) {
+        this.db
+            .prepare(`INSERT INTO envs (id, stack, stack_root, state, root, ports, datastore_ns, fingerprints, presets, bind_count, created_at, last_used_at, service_pids, fail_streak)
+         VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?)
+         ON CONFLICT(id) DO UPDATE SET state=excluded.state, ports=excluded.ports,
+           datastore_ns=excluded.datastore_ns, fingerprints=excluded.fingerprints,
+           presets=excluded.presets, bind_count=excluded.bind_count,
+           last_used_at=excluded.last_used_at, service_pids=excluded.service_pids,
+           fail_streak=excluded.fail_streak`)
+            .run(e.id, e.stack, e.stackRoot, e.state, e.root, JSON.stringify(e.ports), JSON.stringify(e.datastoreNs), JSON.stringify(e.fingerprints), JSON.stringify(e.presets), e.bindCount, e.createdAt, e.lastUsedAt, JSON.stringify(e.servicePids), e.failStreak);
+    }
+    getEnv(id) {
+        const r = this.db.prepare('SELECT * FROM envs WHERE id = ?').get(id);
+        return r ? this.rowToEnv(r) : undefined;
+    }
+    envsForStack(stack) {
+        return this.db.prepare('SELECT * FROM envs WHERE stack = ? ORDER BY id').all(stack).map((r) => this.rowToEnv(r));
+    }
+    allEnvs() {
+        return this.db.prepare('SELECT * FROM envs ORDER BY id').all().map((r) => this.rowToEnv(r));
+    }
+    deleteEnv(id) {
+        this.db.prepare('DELETE FROM envs WHERE id = ?').run(id);
+        this.db.prepare('DELETE FROM leases WHERE env_id = ?').run(id);
+    }
+    /**
+     * A per-stack env sequence that NEVER reuses a number, even after envs are
+     * reaped — so a recycled env's id can't collide with a live one. Monotonic
+     * in the journal, survives daemon restarts.
+     */
+    nextEnvSeq(stack) {
+        this.db.prepare('INSERT INTO counters (stack, next_env) VALUES (?, 1) ON CONFLICT(stack) DO NOTHING').run(stack);
+        const row = this.db.prepare('SELECT next_env FROM counters WHERE stack = ?').get(stack);
+        const seq = row.next_env;
+        this.db.prepare('UPDATE counters SET next_env = next_env + 1 WHERE stack = ?').run(stack);
+        return seq;
+    }
+    /** Update just the recorded service pids (auto-restart keeps recovery honest). */
+    updateServicePids(id, pids) {
+        this.db.prepare('UPDATE envs SET service_pids = ? WHERE id = ?').run(JSON.stringify(pids), id);
+    }
+    saveLease(l) {
+        this.db
+            .prepare(`INSERT INTO leases (id, env_id, kind, holder, hygiene, expires_at) VALUES (?,?,?,?,?,?)
+         ON CONFLICT(id) DO UPDATE SET expires_at=excluded.expires_at, hygiene=excluded.hygiene`)
+            .run(l.id, l.envId, l.kind, l.holder, l.hygiene, l.expiresAt);
+    }
+    rowToLease(r) {
+        return {
+            id: r.id,
+            envId: r.env_id,
+            kind: r.kind,
+            holder: r.holder,
+            hygiene: r.hygiene,
+            expiresAt: r.expires_at,
+        };
+    }
+    leaseForHolder(holder, stack) {
+        const r = this.db
+            .prepare(`SELECT l.* FROM leases l JOIN envs e ON e.id = l.env_id WHERE l.holder = ? AND e.stack = ?`)
+            .get(holder, stack);
+        return r ? this.rowToLease(r) : undefined;
+    }
+    leaseForEnv(envId) {
+        const r = this.db.prepare('SELECT * FROM leases WHERE env_id = ?').get(envId);
+        return r ? this.rowToLease(r) : undefined;
+    }
+    allLeases() {
+        return this.db.prepare('SELECT * FROM leases').all().map((r) => this.rowToLease(r));
+    }
+    deleteLease(id) {
+        this.db.prepare('DELETE FROM leases WHERE id = ?').run(id);
+    }
+    saveJob(job) {
+        this.db
+            .prepare(`INSERT INTO jobs (id, stack_cwd, check_name, state, verdict, created_at, finished_at) VALUES (?,?,?,?,?,?,?)
+         ON CONFLICT(id) DO UPDATE SET state=excluded.state, verdict=excluded.verdict, finished_at=excluded.finished_at`)
+            .run(job.id, job.stackCwd, job.check, job.state, job.verdict ? JSON.stringify(job.verdict) : null, Date.now(), job.finishedAt ?? null);
+    }
+    getJob(id) {
+        const r = this.db.prepare('SELECT * FROM jobs WHERE id = ?').get(id);
+        if (!r)
+            return undefined;
+        return {
+            id: r.id,
+            check: r.check_name,
+            state: r.state,
+            verdict: r.verdict ? JSON.parse(r.verdict) : null,
+            createdAt: r.created_at,
+            finishedAt: r.finished_at ?? null,
+        };
+    }
+    listJobs(limit = 20) {
+        return this.db.prepare('SELECT * FROM jobs ORDER BY created_at DESC LIMIT ?').all(limit).map((r) => ({
+            id: r.id,
+            check: r.check_name,
+            state: r.state,
+            ok: r.verdict ? Boolean(JSON.parse(r.verdict).ok) : null,
+            createdAt: r.created_at,
+            finishedAt: r.finished_at ?? null,
+        }));
+    }
+    /** Recovery: a job left 'running'/'pending' by a dead daemon can never finish. */
+    failStaleJobs() {
+        const stale = this.db.prepare("SELECT id, check_name, stack_cwd FROM jobs WHERE state != 'done'").all();
+        for (const j of stale) {
+            this.saveJob({
+                id: j.id, stackCwd: j.stack_cwd, check: j.check_name, state: 'done',
+                verdict: { check: j.check_name, ok: false, exitCode: -1, failure: { class: 'env-error', message: 'daemon restarted while this run was in flight — result lost' } },
+                finishedAt: Date.now(),
+            });
+        }
+        return stale.length;
+    }
+    /** Retention: done jobs finished before the cutoff leave the journal. */
+    pruneJobs(cutoffMs) {
+        const res = this.db.prepare("DELETE FROM jobs WHERE state = 'done' AND finished_at IS NOT NULL AND finished_at < ?").run(cutoffMs);
+        return Number(res.changes ?? 0);
+    }
+    /** Shift every deadline by `ms` — the sleep pardon (decision 0009). */
+    pardon(ms) {
+        this.db.prepare('UPDATE leases SET expires_at = expires_at + ?').run(ms);
+        this.db.prepare('UPDATE envs SET last_used_at = last_used_at + ?').run(ms);
+    }
+}
+//# sourceMappingURL=journal.js.map

package/dist/core/journal.js.map

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