@theford/runly 0.0.0-stage → 0.20.0

package/dist/core/journal.js

@@ -0,0 +1,395 @@
+/**
+ * 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';
+import { BrokerError } from './util.js';
+/**
+ * The journal schema this build understands, stamped into `PRAGMA user_version`.
+ *
+ * Bump it when a change makes an OLDER daemon misread this journal — not for
+ * every additive column: a bump is unnecessary when an old daemon selecting
+ * a known subset of columns still reads the journal correctly.
+ *
+ * Schemas 1-3 belong to runly before 0.16 and are refused: their migrations
+ * were retired in 0.19 (upgrade through 0.18 first).
+ *
+ * Schema 4 (decision 0034): `active_services = '[]'` means "no services are
+ * wanted" (an older daemon reads an empty list as the whole app and would boot
+ * it), the `db_copies` table holds database copies an older daemon would never
+ * reap, and data-only environments are gone (0.18 migrated them away).
+ *
+ * What this exists to stop is the DOWNGRADE, which has already cost once. The
+ * sha256 env-id migration stranded pre-upgrade rows that then counted against
+ * POOL_MAX_TOTAL and held their ports forever (BACKLOG.md), because nothing on
+ * disk said which build wrote them. A running example of the same shape:
+ * `data_only` defaults to 0, so a 0.7.0 daemon re-binding a 0.8.0 data-only
+ * environment reads "not data-only" and boots the whole application into a
+ * test lane's database. Disk is truth (decision 0009), so the truth has to say
+ * what wrote it.
+ */
+export const JOURNAL_SCHEMA_VERSION = 4;
+/**
+ * service_pids was once `{"web": 1234}` and is now
+ * `{"web": {"pid":1234,"startTime":99}}`. Journals outlive releases, so read
+ * both shapes; a bare number simply has no identity pin (see ServicePid).
+ */
+function parseJson(raw) {
+    if (typeof raw !== 'string' || raw === '')
+        return undefined;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+function parseServicePids(raw) {
+    const out = {};
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return out;
+    }
+    if (!parsed || typeof parsed !== 'object')
+        return out;
+    for (const [name, v] of Object.entries(parsed)) {
+        if (typeof v === 'number')
+            out[name] = { pid: v };
+        else if (v && typeof v === 'object' && typeof v.pid === 'number') {
+            out[name] = { pid: v.pid, startTime: v.startTime,
+                ...(typeof v.pgid === 'number' ? { pgid: v.pgid } : {}),
+                ...(Array.isArray(v.pgids) ? { pgids: v.pgids.filter(g => Number.isSafeInteger(g) && g > 0) } : {}) };
+        }
+    }
+    return out;
+}
+function parseChild(raw) {
+    if (typeof raw !== 'string')
+        return undefined;
+    try {
+        const c = JSON.parse(raw);
+        if (typeof c.pid !== 'number')
+            return undefined;
+        return { pid: c.pid, ...(typeof c.start === 'number' ? { start: c.start } : {}), ...(typeof c.pgid === 'number' ? { pgid: c.pgid } : {}) };
+    }
+    catch {
+        return undefined;
+    }
+}
+export class Journal {
+    db;
+    constructor(path = journalPath()) {
+        this.db = new DatabaseSync(path);
+        // Concurrent readers exist (tests and tools open the journal directly while
+        // the daemon runs), and without a busy timeout any overlap is an immediate
+        // SQLITE_BUSY rather than a short wait. Set before the first read below.
+        this.db.exec('PRAGMA busy_timeout = 5000');
+        // Refuse a journal from the FUTURE before touching it. A newer runly may
+        // have written rows whose semantics this build does not know, and the
+        // failure mode is silent: we would read a default where the newer build
+        // stored meaning, then write that misreading back as truth. Checked before
+        // any DDL so a journal we do not understand is never modified at all.
+        const stamped = Number(this.db.prepare('PRAGMA user_version').get()?.user_version ?? 0);
+        if (stamped > JOURNAL_SCHEMA_VERSION) {
+            throw new BrokerError('infra-error', `journal at ${path} was written by a newer runly (schema ${stamped}; this build understands ${JOURNAL_SCHEMA_VERSION}) — ` +
+                `run the newer runly, upgrade this one, or point BACKLOT_STATE_DIR at a different state root`, 'journal');
+        }
+        // Journals older than schema 4 (runly before 0.16) carried data-only
+        // environments, path-spelled stack identities and the projected worktree
+        // copies whose migrations lived here until 0.18. They are gone: such a
+        // journal is refused untouched rather than half-read.
+        const hasTables = this.db.prepare("SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'envs'").get() !== undefined;
+        if (hasTables && stamped < JOURNAL_SCHEMA_VERSION) {
+            throw new BrokerError('infra-error', `journal at ${path} has schema ${stamped}, older than this build reads (${JOURNAL_SCHEMA_VERSION}) — ` +
+                `upgrade through runly 0.18 first (it migrates the journal), or point BACKLOT_STATE_DIR at a fresh state root`, 'journal');
+        }
+        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,
+        active_services TEXT, activity TEXT, drop_recipes TEXT, templates TEXT
+      );
+      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,
+        holder_pid INTEGER, holder_start INTEGER,
+        preview_service TEXT, preview_url TEXT, preview_pid INTEGER, preview_start INTEGER, preview_port INTEGER,
+        preview_restore TEXT
+      );
+      CREATE TABLE IF NOT EXISTS counters (
+        stack TEXT PRIMARY KEY, next_env INTEGER NOT NULL DEFAULT 1
+      );
+      CREATE TABLE IF NOT EXISTS db_copies (
+        name TEXT PRIMARY KEY, stack TEXT NOT NULL, stack_root TEXT NOT NULL,
+        datastore TEXT NOT NULL, preset TEXT NOT NULL, ns TEXT NOT NULL, url TEXT NOT NULL,
+        state TEXT NOT NULL, holder TEXT NOT NULL, holder_pid INTEGER, holder_start INTEGER,
+        drop_cmd TEXT, drop_cwd TEXT, drop_path TEXT,
+        created_at INTEGER NOT NULL, drop_attempts INTEGER NOT NULL DEFAULT 0,
+        next_drop_at INTEGER NOT NULL DEFAULT 0, template TEXT, child TEXT
+      );
+    `);
+        // A schema-4 journal written by 0.16 or 0.17 lacks the columns added since
+        // (additive: no schema bump). Only the duplicate-column case is benign.
+        for (const [table, col] of [['envs', 'activity TEXT'], ['envs', 'drop_recipes TEXT'], ['envs', 'templates TEXT'], ['db_copies', 'template TEXT'], ['db_copies', 'child TEXT'], ['leases', 'preview_restore TEXT']]) {
+            try {
+                this.db.exec(`ALTER TABLE ${table} ADD COLUMN ${col}`);
+            }
+            catch (err) {
+                if (!/duplicate column name/i.test(String(err.message ?? err)))
+                    throw err;
+            }
+        }
+        if (stamped < JOURNAL_SCHEMA_VERSION)
+            this.db.exec(`PRAGMA user_version = ${JOURNAL_SCHEMA_VERSION}`);
+    }
+    /**
+     * One real sqlite transaction around a multi-statement write. Each of these
+     * sequences used to be N independent writes, so a daemon SIGKILLed between
+     * them left a half-state on disk — deleteEnv's env-gone-lease-left was the
+     * reviewed case. The sweeper tolerates those half-states (journals outlive
+     * releases); this stops new ones being minted. BEGIN IMMEDIATE takes the
+     * write lock up front, so the sequence can't interleave with the concurrent
+     * writers that busy_timeout exists for either.
+     */
+    withTx(fn) {
+        this.db.exec('BEGIN IMMEDIATE');
+        try {
+            const out = fn();
+            this.db.exec('COMMIT');
+            return out;
+        }
+        catch (err) {
+            try {
+                this.db.exec('ROLLBACK');
+            }
+            catch {
+                /* sqlite may already have rolled back on error */
+            }
+            throw err;
+        }
+    }
+    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: parseServicePids(r.service_pids),
+            failStreak: r.fail_streak ?? 0,
+            activeServices: r.active_services ? JSON.parse(r.active_services) : undefined,
+            activity: parseJson(r.activity),
+            dropRecipes: parseJson(r.drop_recipes),
+            templates: parseJson(r.templates),
+        };
+    }
+    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, active_services, drop_recipes, templates)
+         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, active_services=excluded.active_services,
+           drop_recipes=COALESCE(excluded.drop_recipes, envs.drop_recipes),
+           templates=COALESCE(excluded.templates, envs.templates)`)
+            .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, e.activeServices ? JSON.stringify(e.activeServices) : null, e.dropRecipes ? JSON.stringify(e.dropRecipes) : null, e.templates ? JSON.stringify(e.templates) : null);
+    }
+    /**
+     * Record the proxy's activity clocks (decision 0035). Its own statement, so
+     * a snapshot saved by a verb can never roll them back, and merged so a
+     * clock only moves forward.
+     */
+    saveActivity(id, activity) {
+        const row = this.db.prepare('SELECT activity FROM envs WHERE id = ?').get(id);
+        if (!row)
+            return;
+        const merged = { ...(parseJson(row.activity) ?? {}) };
+        for (const [k, v] of Object.entries(activity))
+            merged[k] = Math.max(merged[k] ?? 0, v);
+        this.db.prepare('UPDATE envs SET activity = ? WHERE id = ?').run(JSON.stringify(merged), id);
+    }
+    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));
+    }
+    rowToDbCopy(r) {
+        return {
+            name: r.name,
+            stack: r.stack,
+            stackRoot: r.stack_root,
+            datastore: r.datastore,
+            preset: r.preset,
+            ns: r.ns,
+            url: r.url,
+            state: r.state,
+            holder: r.holder,
+            holderPid: r.holder_pid ?? undefined,
+            holderStart: r.holder_start ?? undefined,
+            dropCmd: r.drop_cmd ?? undefined,
+            dropCwd: r.drop_cwd ?? undefined,
+            dropPath: r.drop_path ?? undefined,
+            createdAt: r.created_at,
+            dropAttempts: r.drop_attempts ?? 0,
+            nextDropAt: r.next_drop_at ?? 0,
+            template: r.template ?? undefined,
+            child: parseChild(r.child),
+        };
+    }
+    saveDbCopy(c) {
+        this.db
+            .prepare(`INSERT INTO db_copies (name, stack, stack_root, datastore, preset, ns, url, state, holder, holder_pid, holder_start,
+           drop_cmd, drop_cwd, drop_path, created_at, drop_attempts, next_drop_at, template, child)
+         VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)
+         ON CONFLICT(name) DO UPDATE SET state=excluded.state, drop_attempts=excluded.drop_attempts,
+           next_drop_at=excluded.next_drop_at, template=COALESCE(excluded.template, db_copies.template),
+           child=COALESCE(excluded.child, db_copies.child)`)
+            .run(c.name, c.stack, c.stackRoot, c.datastore, c.preset, c.ns, c.url, c.state, c.holder, c.holderPid ?? null, c.holderStart ?? null, c.dropCmd ?? null, c.dropCwd ?? null, c.dropPath ?? null, c.createdAt, c.dropAttempts, c.nextDropAt, c.template ?? null, c.child ? JSON.stringify(c.child) : null);
+    }
+    getDbCopy(name) {
+        const r = this.db.prepare('SELECT * FROM db_copies WHERE name = ?').get(name);
+        return r ? this.rowToDbCopy(r) : undefined;
+    }
+    allDbCopies() {
+        return this.db.prepare('SELECT * FROM db_copies ORDER BY created_at, name').all().map((r) => this.rowToDbCopy(r));
+    }
+    deleteDbCopy(name) {
+        this.db.prepare('DELETE FROM db_copies WHERE name = ?').run(name);
+    }
+    deleteEnv(id) {
+        // Atomic: a kill between these two deletes left a lease naming an env row
+        // that no longer existed (the sweeper prunes that half-state as backstop).
+        this.withTx(() => {
+            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) {
+        // Atomic read-modify-write: a foreign writer landing between the SELECT
+        // and the UPDATE would hand the same "never reused" number out twice.
+        return this.withTx(() => {
+            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;
+        });
+    }
+    /** Activity, NOT lease renewal: keeps idle reclamation honest without extending ownership. */
+    touchEnv(id) {
+        this.db.prepare('UPDATE envs SET last_used_at = ? WHERE id = ?').run(Date.now(), id);
+    }
+    /** 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, holder_pid, holder_start,
+           preview_service, preview_url, preview_pid, preview_start, preview_port)
+         VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?)
+         ON CONFLICT(id) DO UPDATE SET expires_at=excluded.expires_at, hygiene=excluded.hygiene,
+           holder_pid=excluded.holder_pid, holder_start=excluded.holder_start,
+           preview_service=excluded.preview_service, preview_url=excluded.preview_url,
+           preview_pid=excluded.preview_pid, preview_start=excluded.preview_start,
+           preview_port=excluded.preview_port`)
+            .run(l.id, l.envId, l.kind, l.holder, l.hygiene, l.expiresAt, l.holderPid ?? null, l.holderStart ?? null, l.previewService ?? null, l.previewUrl ?? null, l.previewPid ?? null, l.previewStart ?? null, l.previewPort ?? null);
+    }
+    /**
+     * Forget a lease's preview tunnel — compare-and-swap on the pid.
+     *
+     * Every caller reached here holding a lease SNAPSHOT, so an unconditional
+     * clear let a slow one wipe the record of a tunnel someone else had already
+     * published in its place. That pid is then unnameable, and an unnameable
+     * preview pid is a public, unauthenticated URL that serves forever. Passing
+     * the pid that was actually stopped makes a stale caller a no-op; the
+     * pid-less form is only for a row that is being deleted outright.
+     */
+    clearLeasePreview(id, stoppedPid) {
+        const cols = 'preview_service=NULL, preview_url=NULL, preview_pid=NULL, preview_start=NULL, preview_port=NULL';
+        if (stoppedPid === undefined) {
+            this.db.prepare(`UPDATE leases SET ${cols} WHERE id=?`).run(id);
+            return;
+        }
+        this.db.prepare(`UPDATE leases SET ${cols} WHERE id=? AND preview_pid=?`).run(id, stoppedPid);
+    }
+    /** Record (or, with null, forget) what a restart re-publishes for this lease (decision 0045). */
+    setLeasePreviewRestore(id, restore) {
+        this.db.prepare('UPDATE leases SET preview_restore = ? WHERE id = ?').run(restore ? JSON.stringify(restore) : null, id);
+    }
+    rowToLease(r) {
+        return {
+            id: r.id,
+            envId: r.env_id,
+            kind: 'session',
+            holder: r.holder,
+            hygiene: r.hygiene,
+            expiresAt: r.expires_at,
+            holderPid: r.holder_pid ?? undefined,
+            holderStart: r.holder_start ?? undefined,
+            previewService: r.preview_service ?? undefined,
+            previewUrl: r.preview_url ?? undefined,
+            previewPid: r.preview_pid ?? undefined,
+            previewStart: r.preview_start ?? undefined,
+            previewPort: r.preview_port ?? undefined,
+            previewRestore: parseJson(r.preview_restore),
+        };
+    }
+    leaseForHolder(holder, stack) {
+        const rows = this.db.prepare(`SELECT l.* FROM leases l JOIN envs e ON e.id = l.env_id WHERE l.holder = ? AND e.stack = ?`).all(holder, stack);
+        if (rows.length > 1) {
+            throw new BrokerError('env-error', `ambiguous leases for holder '${holder}': ${rows.map((r) => r.env_id).join(', ')}; inspect 'runly status', then retire one with 'runly pool recycle <envId> --force' — that destroys the selected environment and its data and ends its lease`, 'lease');
+        }
+        return rows[0] ? this.rowToLease(rows[0]) : 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);
+    }
+    /** Shift every deadline by `ms` — the sleep pardon (decision 0009). */
+    pardon(ms) {
+        // Atomic: a kill between these left leases pardoned but idle clocks not,
+        // so a machine that slept woke to premature quiesces.
+        this.withTx(() => {
+            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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"}

package/dist/core/logs.d.ts

@@ -0,0 +1,56 @@
+export declare const START_MARKER = "-- runly:";
+export declare const logFileOf: (dir: string, service: string) => string;
+export declare const buildLogOf: (dir: string, service: string) => string;
+export declare const UPKEEP_LOG = "upkeep";
+/** The marker written when a service process starts; `--since up` reads from the last one. */
+export declare function startMarker(service: string, pid: number | undefined, reason: string): string;
+/**
+ * Appends time-stamped lines to one service's log. Output arrives in chunks
+ * from two streams; each stream keeps its own partial line, so a line is
+ * stamped once, when it completes, and stdout and stderr never splice into
+ * one line.
+ */
+export declare class LogWriter {
+    readonly file: string;
+    private readonly cap;
+    private size;
+    private partial;
+    constructor(file: string, cap?: number);
+    /** A whole line from runly itself (a start marker). */
+    line(text: string): void;
+    /** A chunk of output from `stream` ('out'/'err'). */
+    write(stream: string, chunk: string): void;
+    /** The stream ended: whatever is left of its last line is written. */
+    end(stream: string): void;
+    private flushAll;
+    private append;
+}
+/** Rotate a log past the cap (the retention sweep's backstop for a writer that never rotated). */
+export declare function rotateIfOver(file: string, cap: number): boolean;
+export interface LogLine {
+    service: string;
+    /** Epoch ms; NaN for a line written before stamping existed (kept in place). */
+    at: number;
+    text: string;
+    /** A start marker. */
+    marker: boolean;
+    /** Written by an earlier process than the last start marker's (`--until` never matches it). */
+    prior?: boolean;
+}
+/** Parse one log (its rotation first, then the live file up to `end`) into lines. */
+export declare function readLog(file: string, service: string, maxBytes?: number, end?: number): LogLine[];
+/**
+ * The last lines of one log — at least `want` that are not start markers, or
+ * all there are — read BACKWARDS from `end` in growing chunks, into the
+ * rotation only when the live file runs out. `logs --lines 40` on a 20 MB log
+ * used to parse both whole files to print 40 lines.
+ */
+export declare function readLastLines(file: string, service: string, want: number, end?: number): LogLine[];
+/** Mark every line before the last start marker as `prior` (an earlier process's). */
+export declare function markPrior(lines: LogLine[]): LogLine[];
+/** Only the lines of the CURRENT process: from the last start marker on. */
+export declare function sinceLastStart(lines: LogLine[]): LogLine[];
+/** Interleave several services' lines by time (stable within one service). */
+export declare function interleave(groups: LogLine[][]): LogLine[];
+/** Start a build log afresh for this build. */
+export declare function beginBuildLog(file: string, header: string): void;