@gr8ful/spf 0.15.0 → 0.17.0

package/dist/ui/server/db.js

@@ -1,9 +1,19 @@
 /**
- * SQLite reader over a target repo's spf.db.
+ * Trace-db reader over a target repo's observability.db (local sqlite, or a
+ * remote Cloudflare D1 database — see `core/trace_db.ts`).
  *
- * The read connection is opened readonly and every query on it is a SELECT —
- * the writers are the tracers of running ADW processes, and WAL lets us read
- * straight through their inserts.
+ * The read connection is opened readonly (local backend) and every query on
+ * it is a SELECT — the writers are the tracers of running ADW processes,
+ * and (for the LOCAL backend) WAL lets us read straight through their
+ * inserts. See `core/trace_db.ts`'s `D1TraceDb` header for why that same
+ * live-read guarantee does NOT hold for a D1-backed repo — a deliberate,
+ * documented trade-off (SPF #66), not something this class works around.
+ *
+ * Every method here is now async — even for the local backend, which pays
+ * nothing for it (`LocalTraceDb` resolves immediately) — because the D1
+ * backend's only way to reach a database from this plain Node CLI is a real
+ * HTTP call. See `core/tracer.ts`'s header for the fuller version of this
+ * same rationale on the write side.
  *
  * ONE exception, opened lazily on its own connection: `setArchived`. Archiving
  * is review triage — "I have looked at this run" — which has to outlive a
@@ -13,45 +23,140 @@
  */
 import { existsSync } from "node:fs";
 import { dirname, resolve } from "node:path";
-import { Database } from "../../core/sqlite.js";
+import { createTraceDb } from "../../core/trace_db.js";
 const MAX_LIMIT = 1000;
 const DEFAULT_LIMIT = 500;
 export class SfDb {
+    /** Absolute local sqlite path — `null` for a `kind:"d1"` config. */
     path;
+    /** Human label for API/console display: the sqlite path, or `d1:<database_id>`. */
+    label;
     /**
      * Where the ADW session dirs live: `{data_dir}/sessions/{adw_id}/{agent}/`.
-     * The db sits in the same data_dir (config's `observability.db` defaults to
-     * `adws/adw_data/spf.db`), so deriving it as a sibling of the db file keeps
-     * working when the whole data_dir is relocated.
+     * Passed in explicitly (from `paths.resolveDataPaths(...).sessions_dir`)
+     * rather than derived from the db path — session JSONL/envelope artifact
+     * files always live on the local filesystem regardless of where the
+     * queryable trace mirror (`db` below) lives; see `paths.ts`'s `DataPaths`.
      */
     sessionsDir;
+    /** `"n/a (d1)"` for a remote backend — journal mode is a local-file concept. */
     journalMode;
     db;
-    /** Opened on first archive and kept; null until then. */
+    dbConfig;
+    /** D1-only; carried from `open()`'s `options.fetchImpl` so a lazily-opened writer (`setArchived`) uses the same injected fetch a test gave the reader. */
+    fetchImpl;
+    /** Opened on first archive and kept; `null` until then. */
     writer = null;
     /** Cache for optionalColumn(), keyed "table.column". Only ever false → true. */
     columnCache = new Map();
-    /** `path` is always absolute — resolved upstream by the ui command via paths.resolveAnchor/resolveDataPaths. */
-    constructor(path) {
-        if (!existsSync(path)) {
-            throw new Error(`spf.db not found at ${path}\n` +
+    constructor(db, dbConfig, sessionsDir, journalMode, fetchImpl) {
+        this.db = db;
+        this.dbConfig = dbConfig;
+        this.path = dbConfig.kind === "sqlite" ? dbConfig.path : null;
+        this.label = dbConfig.kind === "sqlite" ? dbConfig.path : `d1:${dbConfig.database_id}`;
+        this.sessionsDir = sessionsDir;
+        this.journalMode = journalMode;
+        this.fetchImpl = fetchImpl;
+    }
+    /**
+     * Open a trace db for reading. `dbConfig` accepts either a bare local
+     * sqlite path (sugar for `{kind:"sqlite",path}` — `--db <path>`/`SF_DB`
+     * CLI overrides, and every test's shorthand) or a normalized
+     * `observability.db` descriptor (`paths.resolveDataPaths(...).db`).
+     *
+     * `sessionsDir` should be `paths.resolveDataPaths(...).sessions_dir`
+     * whenever the caller has a `DataPaths` in hand; omitted, it falls back to
+     * the historical "sibling of the sqlite file" derivation — only valid for
+     * the LOCAL backend (a bare-path caller has no other sessions dir to
+     * offer), so it is required when `dbConfig` names a `kind:"d1"` config.
+     *
+     * `options.fetchImpl` is D1-only and exists purely so tests can drive this
+     * end-to-end against a mocked D1 HTTP response shape — every real caller
+     * omits it and gets the global `fetch`, same as `createTraceDb` itself.
+     */
+    static async open(dbConfig, sessionsDir, options) {
+        const normalized = typeof dbConfig === "string" ? { kind: "sqlite", path: dbConfig } : dbConfig;
+        if (normalized.kind === "sqlite" && !existsSync(normalized.path)) {
+            throw new Error(`spf.db not found at ${normalized.path}\n` +
                 `Point spf ui at a target repo: --db <path>, SF_DB=<path>, --cwd <repo>, or run it from inside one.`);
         }
-        this.path = path;
-        this.sessionsDir = resolve(dirname(path), "sessions");
-        this.db = new Database(path, { readonly: true });
+        const resolvedSessionsDir = sessionsDir ??
+            (normalized.kind === "sqlite"
+                ? resolve(dirname(normalized.path), "sessions")
+                : (() => {
+                    throw new Error("SfDb.open: sessionsDir is required for a d1-backed repo — pass paths.resolveDataPaths(...).sessions_dir");
+                })());
+        const db = createTraceDb(normalized, { readonly: true, fetchImpl: options?.fetchImpl });
         // WAL is set by the tracer when it creates the db; a readonly connection
         // cannot change it, so we assert rather than set, and always take the
         // busy_timeout so a concurrent writer never turns into a failed request.
-        this.db.exec("PRAGMA busy_timeout = 5000");
-        this.db.exec("PRAGMA synchronous = NORMAL");
-        const mode = this.db
-            .query("PRAGMA journal_mode")
-            .get();
-        this.journalMode = mode?.journal_mode ?? "unknown";
-        if (this.journalMode.toLowerCase() !== "wal") {
-            console.warn(`[db] journal_mode is "${this.journalMode}", expected "wal" — ` +
-                `live reads during agent writes may block`);
+        // None of this has a D1 equivalent — journal_mode/busy_timeout are local
+        // sqlite-file concepts (see the class header for what D1 offers instead).
+        let journalMode = "n/a (d1)";
+        if (normalized.kind === "sqlite") {
+            await db.exec("PRAGMA busy_timeout = 5000");
+            await db.exec("PRAGMA synchronous = NORMAL");
+            const mode = await db.query("PRAGMA journal_mode").get();
+            journalMode = mode?.journal_mode ?? "unknown";
+            if (journalMode.toLowerCase() !== "wal") {
+                console.warn(`[db] journal_mode is "${journalMode}", expected "wal" — ` +
+                    `live reads during agent writes may block`);
+            }
+        }
+        else {
+            // The sqlite branch above gets a friendly "spf.db not found" check
+            // before ever issuing a query; a D1 database has no file to check for
+            // existence, so an empty/never-written one instead surfaces as a raw
+            // "no such table: sessions" the first time any API route queries it.
+            // A cheap sqlite_master probe here gets the same friendly failure the
+            // local backend already has, at open time, in one place.
+            const table = await db
+                .query("SELECT name FROM sqlite_master WHERE name='sessions'")
+                .get();
+            if (!table) {
+                throw new Error(`D1 database ${JSON.stringify(normalized.database_id)} has no "sessions" table — ` +
+                    `point spf ui at a target repo whose D1 database has been written to at least once ` +
+                    `(run any ADW against it first), or check observability.db in spf.config.yaml.`);
+            }
+        }
+        return new SfDb(db, normalized, resolvedSessionsDir, journalMode, options?.fetchImpl);
+    }
+    /**
+     * Cheap "is there anything to read yet" check — the async equivalent of
+     * the `existsSync(dataPaths.db_path)` fast path every sqlite-only caller
+     * used before D1 existed, extended to cover the d1 case those callers
+     * never accounted for.
+     *
+     * `open()` deliberately THROWS a friendly, actionable error on a
+     * never-written db (see above) — the right behavior for `spf ui`, where
+     * "nothing here yet" is a misconfiguration to surface loudly. Callers that
+     * instead want to treat a never-written db as "empty, skip this check" —
+     * `spf fanout`'s collision preflight and lazy metrics reader, `spf loop`'s
+     * per-iteration readback, `spf estimate`'s cold-start path, `spf watch`'s
+     * salt-collision short-circuit — use this instead, so they behave
+     * identically whether the backend is local sqlite or a fresh D1 database
+     * that has never been written to.
+     *
+     * For a `kind:"sqlite"` db: `existsSync(dataPaths.db_path)`, unchanged.
+     * For a `kind:"d1"` db: the same `sqlite_master` probe `open()`'s
+     * friendly-error path already runs, but returning `false` instead of
+     * throwing when the `sessions` table isn't there yet. Any OTHER failure
+     * (network, auth, a malformed database_id) still throws — only "nothing
+     * written yet" collapses to `false`.
+     */
+    static async exists(dataPaths, options) {
+        if (dataPaths.db.kind === "sqlite") {
+            return dataPaths.db_path !== null && existsSync(dataPaths.db_path);
+        }
+        const db = createTraceDb(dataPaths.db, { readonly: true, fetchImpl: options?.fetchImpl });
+        try {
+            const table = await db
+                .query("SELECT name FROM sqlite_master WHERE name='sessions'")
+                .get();
+            return table !== undefined && table !== null;
+        }
+        finally {
+            await db.close();
         }
     }
     /**
@@ -68,22 +173,43 @@ export class SfDb {
      * NULL for the rest of the process even after the data arrived. Once seen,
      * a column never goes away, so it latches.
      */
-    hasColumn(table, column) {
+    async hasColumn(table, column) {
         const key = `${table}.${column}`;
         if (!this.columnCache.get(key)) {
-            const cols = this.db
+            const cols = await this.db
                 .query(`PRAGMA table_info(${table})`)
                 .all();
             this.columnCache.set(key, cols.some((c) => c.name === column));
         }
         return this.columnCache.get(key) ?? false;
     }
-    optionalColumn(table, column) {
-        return this.hasColumn(table, column) ? column : `NULL AS ${column}`;
+    async optionalColumn(table, column) {
+        return (await this.hasColumn(table, column)) ? column : `NULL AS ${column}`;
+    }
+    /**
+     * D1 caps bound parameters at 100 per statement; local sqlite allows tens
+     * of thousands. Any query that binds a whole id list into an `IN (...)`
+     * clause must go through this instead of a single unbounded bind, or it
+     * throws past ~100 ids on the D1 backend. Chunking is harmless on the
+     * local backend too (just slightly less efficient), so this is used
+     * unconditionally rather than special-cased per backend.
+     *
+     * Each id belongs to exactly one chunk, so per-id ordering from `fn`'s own
+     * ORDER BY is preserved — only the relative order of rows belonging to
+     * *different* chunks can interleave, which none of this class's callers
+     * depend on (they always regroup by id afterward).
+     */
+    async chunked(ids, fn, size = 90) {
+        const out = [];
+        for (let i = 0; i < ids.length; i += size) {
+            out.push(...(await fn(ids.slice(i, i + size))));
+        }
+        return out;
     }
-    close() {
-        this.writer?.close();
-        this.db.close();
+    async close() {
+        if (this.writer)
+            await this.writer.close();
+        await this.db.close();
     }
     /**
      * Archive or restore a session — the only write in this process.
@@ -92,28 +218,29 @@ export class SfDb {
      * click should wait its turn rather than fail. Returns false when the id
      * does not exist, so the route can 404 instead of silently succeeding.
      */
-    setArchived(adwId, archived) {
-        if (!this.hasColumn("sessions", "archived")) {
+    async setArchived(adwId, archived) {
+        if (!(await this.hasColumn("sessions", "archived"))) {
             throw new Error("this db predates the archived column — run any ADW once to migrate it");
         }
         if (!this.writer) {
-            this.writer = new Database(this.path);
-            this.writer.exec("PRAGMA busy_timeout=5000;");
+            this.writer = createTraceDb(this.dbConfig, { fetchImpl: this.fetchImpl });
+            if (this.dbConfig.kind === "sqlite")
+                await this.writer.exec("PRAGMA busy_timeout=5000;");
         }
-        this.writer
+        await this.writer
             .query("UPDATE sessions SET archived = ? WHERE adw_id = ?")
             .run(archived ? 1 : 0, adwId);
-        return this.session(adwId) !== null;
+        return (await this.session(adwId)) !== null;
     }
     /** Sessions, most recent first, each with its phase statuses for the progress dots. */
-    sessions(limit = 200) {
-        const rows = this.db
-            .query(`SELECT adw_id, ${this.optionalColumn("sessions", "adw_name")}, request,
+    async sessions(limit = 200) {
+        const rows = await this.db
+            .query(`SELECT adw_id, ${await this.optionalColumn("sessions", "adw_name")}, request,
                 status, engineer, started_at, ended_at,
                 total_tokens, total_cost,
-                ${this.optionalColumn("sessions", "archived")}
+                ${await this.optionalColumn("sessions", "archived")}
            FROM sessions
-          WHERE COALESCE(${this.hasColumn("sessions", "archived") ? "archived" : "0"}, 0) = 0
+          WHERE COALESCE(${(await this.hasColumn("sessions", "archived")) ? "archived" : "0"}, 0) = 0
           ORDER BY started_at DESC, rowid DESC
           LIMIT ?`)
             .all(clamp(limit, 1, MAX_LIMIT));
@@ -121,12 +248,14 @@ export class SfDb {
             return [];
         // Embed each session's phases so the L1 progress dots cost no extra request.
         const ids = rows.map((row) => row.adw_id);
-        const placeholders = ids.map(() => "?").join(", ");
-        const phaseRows = this.db
-            .query(`SELECT phase_id, adw_id, seq, name, kind, owner, description, status,
-                attempt, retries, error, started_at, ended_at
-           FROM phases WHERE adw_id IN (${placeholders}) ORDER BY seq, rowid`)
-            .all(...ids);
+        const phaseRows = await this.chunked(ids, (chunk) => {
+            const placeholders = chunk.map(() => "?").join(", ");
+            return this.db
+                .query(`SELECT phase_id, adw_id, seq, name, kind, owner, description, status,
+                  attempt, retries, error, started_at, ended_at
+             FROM phases WHERE adw_id IN (${placeholders}) ORDER BY seq, rowid`)
+                .all(...chunk);
+        });
         const byAdw = new Map();
         for (const phase of phaseRows) {
             const list = byAdw.get(phase.adw_id);
@@ -137,7 +266,7 @@ export class SfDb {
         }
         // Agents come along too: an L1 card draws a per-agent dot timeline, and its
         // dots are colored per agent — without this it would be one request per card.
-        const agentsByAdw = this.agentsFor(ids);
+        const agentsByAdw = await this.agentsFor(ids);
         const summaries = [];
         for (const session of rows) {
             const phases = byAdw.get(session.adw_id) ?? [];
@@ -149,23 +278,23 @@ export class SfDb {
         }
         return summaries;
     }
-    session(adwId) {
-        return (this.db
-            .query(`SELECT adw_id, ${this.optionalColumn("sessions", "adw_name")}, request,
+    async session(adwId) {
+        return ((await this.db
+            .query(`SELECT adw_id, ${await this.optionalColumn("sessions", "adw_name")}, request,
                   status, engineer, started_at, ended_at,
                   total_tokens, total_cost
              FROM sessions WHERE adw_id = ?`)
-            .get(adwId) ?? null);
+            .get(adwId)) ?? null);
     }
-    phases(adwId) {
+    async phases(adwId) {
         return this.db
             .query(`SELECT phase_id, adw_id, seq, name, kind, owner, description, status,
                 attempt, retries, error, started_at, ended_at
            FROM phases WHERE adw_id = ? ORDER BY seq, rowid`)
             .all(adwId);
     }
-    agentSessions(adwId) {
-        return this.agentsFor([adwId]).get(adwId) ?? [];
+    async agentSessions(adwId) {
+        return (await this.agentsFor([adwId])).get(adwId) ?? [];
     }
     /**
      * Agents per session, for a set of ids at once: the agent_sessions rows plus
@@ -176,11 +305,10 @@ export class SfDb {
      * for. Its model, color and session_id are already on the agent_start event,
      * so a lane is labelled and colored from the moment the agent spawns.
      */
-    agentsFor(adwIds) {
+    async agentsFor(adwIds) {
         const byAdw = new Map();
         if (adwIds.length === 0)
             return byAdw;
-        const placeholders = adwIds.map(() => "?").join(", ");
         const append = (adwId, agent) => {
             const list = byAdw.get(adwId);
             if (list)
@@ -188,23 +316,29 @@ export class SfDb {
             else
                 byAdw.set(adwId, [agent]);
         };
-        const color = this.optionalColumn("agent_sessions", "color");
-        const ctxUsed = this.optionalColumn("agent_sessions", "context_tokens");
-        const ctxWindow = this.optionalColumn("agent_sessions", "context_window");
-        const completed = this.db
-            .query(`SELECT adw_id, agent, coding_agent, model, session_id, ${color},
-                ${ctxUsed}, ${ctxWindow}, created_at, last_used_at
-           FROM agent_sessions WHERE adw_id IN (${placeholders})
-          ORDER BY created_at, agent`)
-            .all(...adwIds);
+        const color = await this.optionalColumn("agent_sessions", "color");
+        const ctxUsed = await this.optionalColumn("agent_sessions", "context_tokens");
+        const ctxWindow = await this.optionalColumn("agent_sessions", "context_window");
+        const completed = await this.chunked(adwIds, (chunk) => {
+            const placeholders = chunk.map(() => "?").join(", ");
+            return this.db
+                .query(`SELECT adw_id, agent, coding_agent, model, session_id, ${color},
+                  ${ctxUsed}, ${ctxWindow}, created_at, last_used_at
+             FROM agent_sessions WHERE adw_id IN (${placeholders})
+            ORDER BY created_at, agent`)
+                .all(...chunk);
+        });
         for (const row of completed)
             append(row.adw_id, row);
-        const started = this.db
-            .query(`SELECT e.adw_id, p.owner AS agent, e.payload_json, e.started_at
-           FROM events e JOIN phases p ON p.phase_id = e.phase_id
-          WHERE e.adw_id IN (${placeholders}) AND e.type = 'agent_start'
-          ORDER BY e.rowid`)
-            .all(...adwIds);
+        const started = await this.chunked(adwIds, (chunk) => {
+            const placeholders = chunk.map(() => "?").join(", ");
+            return this.db
+                .query(`SELECT e.adw_id, p.owner AS agent, e.payload_json, e.started_at
+             FROM events e JOIN phases p ON p.phase_id = e.phase_id
+            WHERE e.adw_id IN (${placeholders}) AND e.type = 'agent_start'
+            ORDER BY e.rowid`)
+                .all(...chunk);
+        });
         for (const row of started) {
             if (!row.agent)
                 continue;
@@ -235,15 +369,15 @@ export class SfDb {
         return byAdw;
     }
     /** Session + phases + agents in one shot — L2 needs all three to draw lanes. */
-    sessionDetail(adwId) {
-        const session = this.session(adwId);
+    async sessionDetail(adwId) {
+        const session = await this.session(adwId);
         if (!session)
             return null;
         return {
             session,
-            usage: this.usage(adwId),
-            phases: this.phases(adwId),
-            agents: this.agentSessions(adwId),
+            usage: await this.usage(adwId),
+            phases: await this.phases(adwId),
+            agents: await this.agentSessions(adwId),
         };
     }
     /**
@@ -258,8 +392,8 @@ export class SfDb {
      * material generated. The gap between them and the headline is cached
      * re-reads, which is usually most of it.
      */
-    usage(adwId) {
-        const rows = this.db
+    async usage(adwId) {
+        const rows = await this.db
             .query("SELECT payload_json FROM events WHERE adw_id = ? AND type = 'agent_end'")
             .all(adwId);
         let read = 0;
@@ -288,9 +422,9 @@ export class SfDb {
      * The polling query. Rowid cursor, insertion order, bounded page — the same
      * mechanism serves the live tail and lazy-paged history.
      */
-    events(adwId, after = 0, limit = DEFAULT_LIMIT) {
+    async events(adwId, after = 0, limit = DEFAULT_LIMIT) {
         const cappedLimit = clamp(limit, 1, MAX_LIMIT);
-        const events = this.db
+        const events = await this.db
             .query(`SELECT rowid, event_id, adw_id, phase_id, parent_id, type, name,
                 payload_json, tokens, started_at, ended_at
            FROM events
@@ -304,23 +438,23 @@ export class SfDb {
             has_more: events.length === cappedLimit,
         };
     }
-    envelopes(adwId) {
+    async envelopes(adwId) {
         return this.db
             .query(`SELECT envelope_id, adw_id, phase_id, agent, output_type, payload_json,
                 valid, attempt, created_at
            FROM envelopes WHERE adw_id = ? ORDER BY created_at, rowid`)
             .all(adwId);
     }
-    gates(adwId) {
-        const checks = this.optionalColumn("gate_results", "checks_json");
+    async gates(adwId) {
+        const checks = await this.optionalColumn("gate_results", "checks_json");
         return this.db
             .query(`SELECT id, adw_id, phase_id, attempt, gate, passed, violations_json,
                 ${checks}, created_at
            FROM gate_results WHERE adw_id = ? ORDER BY id`)
             .all(adwId);
     }
-    sessionCount() {
-        const row = this.db
+    async sessionCount() {
+        const row = await this.db
             .query("SELECT COUNT(*) AS n FROM sessions")
             .get();
         return row?.n ?? 0;
@@ -346,27 +480,29 @@ export class SfDb {
      * first (`spf estimate`'s own sample-selection order), which is a decision
      * `estimate.ts` makes, not this method.
      */
-    chainPhaseHistory(chainName) {
-        if (!this.hasColumn("sessions", "adw_name"))
+    async chainPhaseHistory(chainName) {
+        if (!(await this.hasColumn("sessions", "adw_name")))
             return { sessions: [], joinedExcluded: 0 };
-        const joinedRow = this.db
+        const joinedRow = await this.db
             .query(`SELECT COUNT(*) AS n FROM sessions
           WHERE adw_name != ? AND (adw_name LIKE ? OR adw_name LIKE ? OR adw_name LIKE ?)`)
             .get(chainName, `${chainName} + %`, `% + ${chainName}`, `% + ${chainName} + %`);
-        const sessionRows = this.db
+        const sessionRows = await this.db
             .query(`SELECT adw_id, status, started_at, total_tokens, total_cost
            FROM sessions WHERE adw_name = ? ORDER BY started_at DESC, rowid DESC`)
             .all(chainName);
         if (sessionRows.length === 0)
             return { sessions: [], joinedExcluded: joinedRow?.n ?? 0 };
         const ids = sessionRows.map((r) => r.adw_id);
-        const placeholders = ids.map(() => "?").join(", ");
-        const phaseRows = this.db
-            .query(`SELECT p.adw_id, p.name, p.seq, e.tokens
-           FROM phases p LEFT JOIN events e ON e.phase_id = p.phase_id AND e.type = 'agent_end'
-          WHERE p.adw_id IN (${placeholders})
-          ORDER BY p.seq ASC`)
-            .all(...ids);
+        const phaseRows = await this.chunked(ids, (chunk) => {
+            const placeholders = chunk.map(() => "?").join(", ");
+            return this.db
+                .query(`SELECT p.adw_id, p.name, p.seq, e.tokens
+             FROM phases p LEFT JOIN events e ON e.phase_id = p.phase_id AND e.type = 'agent_end'
+            WHERE p.adw_id IN (${placeholders})
+            ORDER BY p.seq ASC`)
+                .all(...chunk);
+        });
         const phasesByAdw = new Map();
         for (const row of phaseRows) {
             const list = phasesByAdw.get(row.adw_id);

package/dist/ui/server/serve.d.ts

@@ -1,5 +1,9 @@
+import type { NormalizedObservabilityDb } from "../../core/data_types.ts";
 export interface UiOptions {
-    dbPath: string;
+    /** Bare local sqlite path (sugar for `{kind:"sqlite",path}`), or a normalized `observability.db` descriptor. */
+    db: NormalizedObservabilityDb | string;
+    /** `paths.resolveDataPaths(...).sessions_dir` — required whenever `db` is `kind:"d1"`; see `SfDb.open`'s doc comment. */
+    sessionsDir?: string;
     webDir: string;
     /** Explicit port. Omit to try the default and probe upward on collision. */
     port?: number;

package/dist/ui/server/serve.js

@@ -35,7 +35,7 @@ function openUrl(url) {
     }
 }
 export async function runUi(options) {
-    const db = new SfDb(options.dbPath);
+    const db = await SfDb.open(options.db, options.sessionsDir);
     const app = createApp(db, options.webDir);
     const explicit = options.port !== undefined;
     const startPort = options.port ?? DEFAULT_PORT;
@@ -52,7 +52,7 @@ export async function runUi(options) {
             if (!isAddrInUse(error))
                 throw error;
             if (i === attempts - 1) {
-                db.close();
+                await db.close();
                 throw new Error(explicit
                     ? `port ${port} is already in use — pick another with --port`
                     : `ports ${startPort}-${port} are all in use — pick one explicitly with --port`);
@@ -65,10 +65,9 @@ export async function runUi(options) {
     const shouldOpen = options.open !== false && process.stdout.isTTY && !process.env.CI && !process.env.SSH_CONNECTION;
     if (shouldOpen)
         openUrl(url);
-    const close = () => new Promise((resolvePromise) => {
+    const close = () => new Promise((resolvePromise, reject) => {
         server.close(() => {
-            db.close();
-            resolvePromise();
+            db.close().then(resolvePromise, reject);
         });
     });
     const shutdown = () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gr8ful/spf",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "Super Portable Factory — a global CLI for repeatable agents-plus-code workflows (ADWs)",
   "type": "module",
   "license": "MIT",

package/web/assets/index-CQ3k1Y1-.css

@@ -0,0 +1 @@
+@font-face{font-family:Overpass;font-style:normal;font-weight:400;font-display:swap;src:url(./overpass-latin-400-normal-BpeLJ0bs.woff2) format("woff2")}@font-face{font-family:Overpass;font-style:normal;font-weight:600;font-display:swap;src:url(./overpass-latin-600-normal-25RhTNCi.woff2) format("woff2")}@font-face{font-family:Overpass;font-style:normal;font-weight:700;font-display:swap;src:url(./overpass-latin-700-normal-CQX2QTgM.woff2) format("woff2")}@font-face{font-family:Overpass Mono;font-style:normal;font-weight:400;font-display:swap;src:url(./overpass-mono-latin-400-normal-VINZG6Js.woff2) format("woff2")}@font-face{font-family:Overpass Mono;font-style:normal;font-weight:700;font-display:swap;src:url(./overpass-mono-latin-700-normal-D6nRBrbd.woff2) format("woff2")}.dots[data-v-466cf629]{display:inline-flex;align-items:center;gap:5px;font-size:16px;letter-spacing:0}.d-more[data-v-466cf629]{color:var(--faint);font-size:16px}.d.success[data-v-466cf629]{color:var(--pass)}.d.fail[data-v-466cf629]{color:var(--fail)}.d.running[data-v-466cf629]{color:var(--live)}body.board .d.running[data-v-466cf629]{animation:pulse 1.2s ease-in-out infinite}.d.queued[data-v-466cf629]{color:var(--faint)}.row[data-v-4c0606e6]{display:grid;grid-template-columns:var(--tt-columns);align-items:baseline;column-gap:18px;padding:9px 0;border-bottom:1px solid var(--rule-soft);color:var(--fg);text-decoration:none;font-size:16px}.row[data-v-4c0606e6]:hover{background:var(--face)}.run[data-v-4c0606e6]{font-weight:700}.service[data-v-4c0606e6],.request[data-v-4c0606e6]{color:var(--dim);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.phases[data-v-4c0606e6]{display:inline-flex;align-items:center;gap:10px;overflow:hidden;white-space:nowrap}.status[data-v-4c0606e6]{font-weight:600;white-space:nowrap}.num[data-v-4c0606e6]{text-align:right;white-space:nowrap}.mono[data-v-4c0606e6]{font-family:var(--mono);font-variant-numeric:tabular-nums}.status.success[data-v-4c0606e6]{color:var(--pass)}.status.fail[data-v-4c0606e6]{color:var(--fail)}.status.running[data-v-4c0606e6]{color:var(--live);font-style:italic}.status.queued[data-v-4c0606e6]{color:var(--faint);font-style:italic}.row.running[data-v-4c0606e6]{background:var(--face)}.act[data-v-4c0606e6]{justify-self:end;display:inline-flex;align-items:center;justify-content:center;padding:4px;border:1px solid transparent;border-radius:var(--radius);background:none;color:var(--faint);cursor:pointer}.act[data-v-4c0606e6]:hover,.act[data-v-4c0606e6]:focus-visible{border-color:var(--rule);color:var(--accent)}.meta[data-v-4c0606e6]{display:none}@media(max-width:980px){.row[data-v-4c0606e6]{grid-template-columns:1fr auto auto;row-gap:3px;padding:12px 0}.departed[data-v-4c0606e6],.service[data-v-4c0606e6],.phases[data-v-4c0606e6],.num[data-v-4c0606e6]{display:none}.request[data-v-4c0606e6]{grid-column:1 / -1}.meta[data-v-4c0606e6]{display:block;grid-column:1 / -1;font-size:16px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}}.sessions[data-v-cd655e0c]{display:flex;flex-direction:column}.search-bar[data-v-cd655e0c]{display:flex;align-items:baseline;gap:12px;margin:18px 28px 0}.search-input[data-v-cd655e0c]{flex:1;max-width:420px;padding:7px 10px;border:1px solid var(--rule);border-radius:var(--radius);background:var(--face);color:var(--fg);font-family:var(--mono);font-size:16px}.search-input[data-v-cd655e0c]::placeholder{color:var(--faint)}.search-note[data-v-cd655e0c]{font-size:16px;white-space:nowrap}.tt[data-v-cd655e0c]{--tt-columns: 84px 160px minmax(90px, 140px) minmax(0, 1fr) 168px 100px 90px 90px 90px 70px;margin:8px 28px 40px}.tt-caption[data-v-cd655e0c]{display:flex;align-items:baseline;justify-content:space-between;padding:18px 0 8px}.tt-title[data-v-cd655e0c]{font-size:20px;font-weight:700;letter-spacing:.02em}.tt-head[data-v-cd655e0c]{display:grid;grid-template-columns:var(--tt-columns);column-gap:18px;padding:0 0 6px;border-bottom:1px solid var(--rule)}.h[data-v-cd655e0c]{font-size:16px;font-weight:600;letter-spacing:.06em;text-transform:lowercase;color:var(--faint);white-space:nowrap}.h-num[data-v-cd655e0c]{text-align:right}@media(max-width:980px){.search-bar[data-v-cd655e0c]{margin:12px 16px 0}.search-input[data-v-cd655e0c]{max-width:none}.tt[data-v-cd655e0c]{margin:8px 16px 40px}.tt-head[data-v-cd655e0c]{display:none}}.chip[data-v-fb81e248]{display:inline-flex;align-items:center;gap:7px;padding:2px 10px;border:1px solid var(--rule);border-radius:var(--radius);background:transparent;font-size:16px;font-weight:600;color:var(--dim);white-space:nowrap}.chip-icon[data-v-fb81e248]{flex:none}.chip-label[data-v-fb81e248]{display:inline-block;transform-origin:50% 65%}body.board .chip-label[data-v-fb81e248]{animation:flap-in .26s cubic-bezier(.2,.7,.3,1)}.chip.success[data-v-fb81e248]{color:var(--pass);border-color:var(--pass)}.chip.fail[data-v-fb81e248]{color:var(--fail);border-color:var(--fail)}.chip.running[data-v-fb81e248]{color:var(--live);border-color:var(--live)}body.board .chip.running .chip-icon[data-v-fb81e248]{animation:spin-fb81e248 1.1s linear infinite}@keyframes spin-fb81e248{to{transform:rotate(360deg)}}.chip.queued[data-v-fb81e248]{color:var(--faint);border-style:dashed}.stat[data-v-d11de936]{display:inline-flex;align-items:center;gap:7px;padding:2px 10px;border:1px solid var(--rule-soft);border-radius:var(--radius);font-size:16px;white-space:nowrap}.stat-icon[data-v-d11de936]{color:var(--faint);flex:none}.stat-value[data-v-d11de936]{color:var(--fg);font-family:var(--mono);font-variant-numeric:tabular-nums}.stat.compact[data-v-d11de936]{padding:0;border:none}.stat.compact .stat-value[data-v-d11de936]{color:var(--dim)}.dsec[data-v-5b638432]{margin-bottom:16px}.dsec-head[data-v-5b638432]{display:flex;align-items:center;gap:9px;width:100%;padding:7px 6px;background:none;border:none;border-bottom:1px solid var(--rule);border-radius:0;color:var(--dim);font-size:16px;font-weight:600;letter-spacing:.07em;text-transform:uppercase;cursor:pointer;text-align:left}.dsec-icon[data-v-5b638432]{flex:none;color:var(--faint)}.dsec-head[data-v-5b638432]:hover{background:var(--face);color:var(--fg)}.chev[data-v-5b638432]{color:var(--faint);flex:none;font-family:var(--mono)}.dsec-count[data-v-5b638432]{font-weight:400;text-transform:none;letter-spacing:0}.dsec-body[data-v-5b638432]{padding-top:12px}.detail[data-v-b072286b]{margin:0 28px 28px;border:1px solid var(--rule);border-radius:var(--radius);background:var(--face)}.d-head[data-v-b072286b]{display:flex;align-items:center;gap:20px;flex-wrap:wrap;padding:14px 18px;border-bottom:1px solid var(--rule);background:var(--inset)}.d-main[data-v-b072286b]{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.d-name[data-v-b072286b]{font-size:20px;font-weight:700}.d-tags[data-v-b072286b]{display:flex;align-items:center;gap:10px;flex-wrap:wrap;margin-left:auto}.tag[data-v-b072286b]{display:inline-flex;align-items:baseline;gap:7px;padding:2px 10px;border:1px solid var(--rule-soft);border-radius:var(--radius);background:var(--inset);font-size:16px;white-space:nowrap}.tag-k[data-v-b072286b]{color:var(--faint)}.tag-v[data-v-b072286b]{color:var(--fg)}.close[data-v-b072286b]{background:none;border:1px solid var(--rule);border-radius:var(--radius);color:var(--dim);font-family:var(--mono);font-size:16px;cursor:pointer;padding:3px 10px}.close[data-v-b072286b]:hover{color:var(--fg);border-color:var(--dim)}.d-desc[data-v-b072286b]{margin:0;color:var(--dim)}.d-request[data-v-b072286b]{margin:0;color:var(--fg);white-space:pre-wrap;overflow-wrap:anywhere}.cfg[data-v-b072286b]{display:flex;flex-direction:column;gap:7px}.cfg-row[data-v-b072286b]{display:flex;align-items:baseline;gap:12px}.cfg-k[data-v-b072286b]{flex:none;width:118px;color:var(--faint)}.cfg-v[data-v-b072286b]{color:var(--fg);min-width:0;overflow-wrap:anywhere}.cfg-model-icon[data-v-b072286b]{width:17px;height:17px;flex:none;object-fit:contain}.cfg-chips[data-v-b072286b]{display:inline-flex;flex-wrap:wrap;gap:6px}.cfg-chip[data-v-b072286b]{display:inline-flex;align-items:center;gap:8px;padding:2px 10px;border:1px solid var(--rule-soft);border-radius:var(--radius);background:var(--inset);font-family:var(--mono);font-size:16px;overflow-wrap:anywhere}.cfg-icon[data-v-b072286b]{flex:none;color:var(--faint)}.d-error[data-v-b072286b]{margin:14px 18px 0}.d-grid[data-v-b072286b]{display:grid;grid-template-columns:minmax(0,2fr) minmax(0,3fr);gap:28px;padding:16px 18px 20px}@media(max-width:1100px){.d-grid[data-v-b072286b]{grid-template-columns:1fr}}h3[data-v-b072286b]{display:flex;align-items:center;gap:9px;margin:18px 0 10px;padding-bottom:6px;border-bottom:1px solid var(--rule-soft);font-size:16px;font-weight:700;color:var(--dim);text-transform:lowercase;letter-spacing:.05em}.h3-icon[data-v-b072286b]{flex:none;color:var(--faint)}h3[data-v-b072286b]:first-child{margin-top:0}.prompt-panel[data-v-b072286b]{margin-bottom:10px;border:1px solid var(--rule-soft);border-radius:var(--radius);background:var(--inset);overflow:hidden}.prompt-head[data-v-b072286b]{display:flex;align-items:baseline;gap:12px;width:100%;padding:9px 14px;background:none;border:none;color:var(--fg);font-size:16px;cursor:pointer;text-align:left}.prompt-head[data-v-b072286b]:hover{background:var(--face)}.chev[data-v-b072286b]{color:var(--faint);flex:none;font-family:var(--mono)}.prompt-title[data-v-b072286b]{font-weight:700}.prompt-head .dim[data-v-b072286b]{margin-left:auto}.prompt-body[data-v-b072286b]{padding:12px 14px 14px;border-top:1px solid var(--rule-soft);max-height:60vh;overflow:auto}.prompt-tools[data-v-b072286b]{display:flex;gap:8px;margin-bottom:12px}.prompt-tools button[data-v-b072286b]{padding:2px 12px;border:1px solid var(--rule-soft);border-radius:var(--radius);background:none;color:var(--dim);font-family:var(--mono);font-size:16px;cursor:pointer}.prompt-tools button.active[data-v-b072286b]{color:var(--fg);border-color:var(--rule);background:var(--face)}.prompt-raw[data-v-b072286b]{border:none;padding:0;background:transparent;max-height:none}.gate[data-v-b072286b]{margin-bottom:10px;padding:10px 14px;border:1px solid var(--rule-soft);border-radius:var(--radius);background:var(--inset)}.gate.pass[data-v-b072286b]{border-color:var(--rule)}.gate.fail[data-v-b072286b]{border-color:var(--fail)}.gate-line[data-v-b072286b]{display:flex;gap:12px;align-items:baseline;flex-wrap:wrap}.gate-toggle[data-v-b072286b]{width:100%;padding:0;background:none;border:none;color:var(--fg);font-size:16px;cursor:pointer;text-align:left}.gate-checks .check-item[data-v-b072286b]{font-family:var(--mono)}.gate-toggle .chev[data-v-b072286b]{color:var(--faint);flex:none}.gate-checks[data-v-b072286b]{margin-top:10px;padding-top:8px;border-top:1px solid var(--rule-soft)}.gate-check[data-v-b072286b]{display:flex;gap:10px;align-items:baseline;flex-wrap:wrap;padding:3px 0}.gate-check.pass .check-mark[data-v-b072286b]{color:var(--pass)}.gate-check.fail .check-mark[data-v-b072286b]{color:var(--fail)}.check-item[data-v-b072286b]{overflow-wrap:anywhere;min-width:0}.check-note[data-v-b072286b]{white-space:pre-wrap;overflow-wrap:anywhere}.check-note-block[data-v-b072286b]{flex-basis:100%;margin:4px 0 6px 26px;max-height:30vh;overflow:auto}.tag-fail[data-v-b072286b]{border-color:var(--fail)}.tag-fail .tag-v[data-v-b072286b]{color:var(--fail)}.gate.pass .gate-mark[data-v-b072286b]{color:var(--pass)}.gate.fail .gate-mark[data-v-b072286b]{color:var(--fail)}.gate-name[data-v-b072286b]{color:var(--fg);font-weight:700}.gate-time[data-v-b072286b]{margin-left:auto}.violations[data-v-b072286b]{margin:8px 0 2px;padding-left:24px;color:var(--fail)}.usage[data-v-b072286b]{width:100%;max-width:420px;border-collapse:collapse;font-size:16px}.usage th[data-v-b072286b]{padding:0 0 6px;font-size:16px;font-weight:400;letter-spacing:.06em;text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--rule-soft)}.usage td[data-v-b072286b]{padding:5px 0}.usage .u-k[data-v-b072286b]{text-align:left;color:var(--dim)}.usage .u-n[data-v-b072286b],.usage .u-c[data-v-b072286b]{text-align:right;font-family:var(--mono);color:var(--fg)}.u-nested .u-k[data-v-b072286b]{padding-left:18px;color:var(--faint)}.u-nested .u-n[data-v-b072286b],.u-nested .u-c[data-v-b072286b]{color:var(--faint)}.u-total td[data-v-b072286b]{padding-top:8px;border-top:1px solid var(--rule-soft);font-weight:700}.u-total .u-k[data-v-b072286b]{color:var(--fg)}.u-note[data-v-b072286b]{margin:10px 0 0;font-size:16px}.output[data-v-b072286b]{margin-bottom:14px}.output-line[data-v-b072286b]{display:flex;gap:12px;align-items:baseline;flex-wrap:wrap;margin-bottom:8px}.output-type[data-v-b072286b]{color:var(--fg);font-weight:700}.output-valid.pass[data-v-b072286b]{color:var(--pass)}.output-valid.fail[data-v-b072286b]{color:var(--fail)}.output pre[data-v-b072286b]{max-height:40vh;overflow:auto}.event[data-v-b072286b]{border-bottom:1px solid var(--rule-soft)}.event-row[data-v-b072286b]{display:flex;gap:14px;align-items:baseline;width:100%;padding:7px 6px;background:none;border:none;border-radius:0;color:var(--fg);font-family:var(--mono);font-size:16px;cursor:pointer;text-align:left}.event-row[data-v-b072286b]:hover,.event-row.open[data-v-b072286b]{background:var(--inset)}.e-time[data-v-b072286b]{flex:none;font-variant-numeric:tabular-nums}.e-type[data-v-b072286b]{flex:none;width:130px;color:var(--dim)}.e-name[data-v-b072286b]{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.e-extra[data-v-b072286b]{margin-left:auto;flex:none;display:inline-flex;gap:14px}.payload-panel[data-v-b072286b]{margin:6px 0 14px;padding:14px 16px;border:1px solid var(--rule);border-radius:var(--radius);background:var(--inset)}.p-meta[data-v-b072286b]{display:flex;gap:16px;align-items:baseline;margin-bottom:10px}.p-tool[data-v-b072286b]{color:var(--fg);font-weight:700;font-size:17px}.payload-panel h4[data-v-b072286b]{margin:14px 0 6px;font-size:16px;font-weight:700;color:var(--dim);text-transform:lowercase;letter-spacing:.06em}.payload-panel h4[data-v-b072286b]:first-of-type{margin-top:0}.p-pre[data-v-b072286b]{border:1px solid var(--rule-soft);border-radius:var(--radius);padding:10px 12px;background:var(--board);max-height:42vh;overflow:auto}.t-red[data-v-b072286b]{color:var(--fail)}.t-green[data-v-b072286b]{color:var(--pass)}@media(max-width:980px){.detail[data-v-b072286b]{margin:0 16px 24px}}.summary-card[data-v-c841437b]{margin:20px 28px 0;border:1px solid var(--rule);border-radius:var(--radius);background:var(--face);overflow:hidden}.summary-card[data-v-c841437b] .dsec{margin-bottom:0}.summary-card[data-v-c841437b] .dsec-head{padding:10px 16px;background:var(--inset)}.summary-card[data-v-c841437b] .dsec-head:hover{background:var(--inset)}.summary-card[data-v-c841437b] .dsec-body{padding:14px 16px}.sum-row[data-v-c841437b]{display:flex;align-items:center;gap:12px;flex-wrap:wrap;font-size:16px}.sum-btn[data-v-c841437b]{padding:5px 14px;border:1px solid var(--rule);border-radius:var(--radius);background:none;color:var(--dim);font-family:var(--mono);font-size:16px;cursor:pointer}.sum-btn[data-v-c841437b]:hover,.sum-btn[data-v-c841437b]:focus-visible{color:var(--fg);border-color:var(--accent)}.md[data-v-c841437b]{margin-bottom:12px}.qa-card[data-v-f39b4ea7]{margin:20px 28px 0;border:1px solid var(--rule);border-radius:var(--radius);background:var(--face);overflow:hidden}.qa-card[data-v-f39b4ea7] .dsec{margin-bottom:0}.qa-card[data-v-f39b4ea7] .dsec-head{padding:10px 16px;background:var(--inset)}.qa-card[data-v-f39b4ea7] .dsec-head:hover{background:var(--inset)}.qa-card[data-v-f39b4ea7] .dsec-body{padding:14px 16px}.qa-note[data-v-f39b4ea7]{margin-bottom:10px;font-size:16px;color:var(--dim)}.qa-note-warn[data-v-f39b4ea7]{color:var(--amber)}.qa-thread[data-v-f39b4ea7]{display:flex;flex-direction:column;gap:10px;max-height:360px;overflow-y:auto;margin-bottom:12px}.qa-empty[data-v-f39b4ea7]{font-size:16px}.qa-msg[data-v-f39b4ea7]{display:flex;flex-direction:column;gap:2px;padding:8px 10px;border:1px solid var(--rule-soft);border-radius:var(--radius);background:var(--inset)}.qa-role-user[data-v-f39b4ea7]{align-self:flex-end;max-width:85%;background:none}.qa-role-assistant[data-v-f39b4ea7]{max-width:85%}.qa-role-error[data-v-f39b4ea7]{border-color:var(--fail)}.qa-role[data-v-f39b4ea7]{font-size:16px;letter-spacing:.07em;text-transform:uppercase}.qa-text[data-v-f39b4ea7]{font-size:17px;color:var(--fg);white-space:pre-wrap}.qa-role-error .qa-text[data-v-f39b4ea7]{color:var(--fail)}.qa-input-row[data-v-f39b4ea7]{display:flex;gap:8px}.qa-input[data-v-f39b4ea7]{flex:1 1 auto;padding:7px 12px;border:1px solid var(--rule);border-radius:var(--radius);background:var(--ground);color:var(--fg);font-family:var(--mono);font-size:16px}.qa-input[data-v-f39b4ea7]:focus-visible{outline:none;border-color:var(--accent)}.qa-btn[data-v-f39b4ea7]{padding:5px 14px;border:1px solid var(--rule);border-radius:var(--radius);background:none;color:var(--dim);font-family:var(--mono);font-size:16px;cursor:pointer}.qa-btn[data-v-f39b4ea7]:hover:not(:disabled),.qa-btn[data-v-f39b4ea7]:focus-visible:not(:disabled){color:var(--fg);border-color:var(--accent)}.qa-btn[data-v-f39b4ea7]:disabled{opacity:.5;cursor:default}.trace[data-v-73d913f1]{padding:0 0 40px}.run-strip[data-v-73d913f1]{display:flex;align-items:center;gap:18px;padding:12px 24px;border-bottom:1px solid var(--rule);flex-wrap:wrap}.run-strip .request[data-v-73d913f1]{font-size:17px;font-weight:600;color:var(--fg);max-width:52ch;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.run-stats[data-v-73d913f1]{display:inline-flex;gap:10px;flex-wrap:wrap}.waterfall[data-v-73d913f1]{margin:20px 28px;border:1px solid var(--rule);border-radius:var(--radius);background:var(--face);overflow:hidden}.row[data-v-73d913f1]{display:grid;grid-template-columns:250px 1fr}.axis-row[data-v-73d913f1]{border-bottom:1px solid var(--rule);background:var(--inset)}.axis-row .track[data-v-73d913f1]{height:38px;overflow:hidden}.zone-head[data-v-73d913f1]{position:absolute;top:0;bottom:0;left:0;display:inline-flex;align-items:center;justify-content:center;font-size:16px;font-weight:600;letter-spacing:.08em;text-transform:uppercase;color:var(--amber);border-right:1px solid var(--rule)}.axis-label[data-v-73d913f1]{position:absolute;bottom:6px;transform:translate(-50%);font-family:var(--mono);font-size:16px;font-variant-numeric:tabular-nums;color:var(--dim);white-space:nowrap}.label[data-v-73d913f1]{padding:12px 16px;display:flex;flex-direction:column;justify-content:center;gap:3px;border-right:1px solid var(--rule);overflow:hidden;white-space:nowrap}.lane-name[data-v-73d913f1]{display:inline-flex;align-items:center;gap:8px;font-size:17px;font-weight:700;color:var(--fg);overflow:hidden;text-overflow:ellipsis}.tno[data-v-73d913f1]{flex:none;width:26px;color:var(--faint);font-size:16px}.lane-icon[data-v-73d913f1]{flex:none;color:var(--dim)}.lane-meta[data-v-73d913f1]{font-family:var(--mono);font-size:16px;color:var(--dim);overflow:hidden;text-overflow:ellipsis}.lane-model[data-v-73d913f1]{display:inline-flex;align-items:center;gap:7px}.model-icon[data-v-73d913f1]{width:16px;height:16px;flex:none;object-fit:contain}.lane-ctx[data-v-73d913f1]{display:flex;flex-direction:column;gap:4px;margin-top:2px;max-width:190px}.ctx-head[data-v-73d913f1]{display:flex;align-items:baseline;justify-content:space-between;gap:8px}.ctx-label[data-v-73d913f1]{font-size:16px;letter-spacing:.07em;text-transform:uppercase;color:var(--faint)}.ctx-pct[data-v-73d913f1]{font-family:var(--mono);font-size:16px;font-variant-numeric:tabular-nums;color:var(--dim)}.ctx-bar[data-v-73d913f1]{height:6px;background:var(--inset);border:1px solid var(--rule-soft);overflow:hidden}.ctx-fill[data-v-73d913f1]{display:block;width:100%;height:100%;background:var(--faint);transform-origin:left center;transition:transform .3s ease}.ctx-fill.live[data-v-73d913f1]{background:var(--amber)}.lane[data-v-73d913f1]{border-bottom:1px solid var(--rule-soft)}.lane[data-v-73d913f1]:last-child{border-bottom:none}.track[data-v-73d913f1]{position:relative;height:118px;overflow:hidden}.zone-divider[data-v-73d913f1]{position:absolute;top:0;bottom:0;border-left:1px solid var(--rule)}.gridline[data-v-73d913f1]{position:absolute;top:0;bottom:0;border-left:1px dashed rgba(239,232,212,.08)}.block[data-v-73d913f1]{position:absolute;top:13px;height:92px;display:flex;flex-direction:column;justify-content:flex-start;gap:4px;padding:10px 12px 16px;border-radius:var(--radius);border:1px solid var(--rule);background:var(--face);font-size:16px;color:var(--fg);cursor:pointer;overflow:hidden;white-space:nowrap;text-align:left;transition:border-color .12s ease,background .12s ease}.block[data-v-73d913f1]:hover{border-color:var(--dim);background:#242119}.b-top[data-v-73d913f1]{display:flex;align-items:baseline;gap:10px;min-width:0}.flap[data-v-73d913f1]{display:inline-block;transform-origin:50% 65%;animation:flap-in .28s cubic-bezier(.2,.7,.3,1),}.b-status[data-v-73d913f1]{flex:none;font-size:16px;padding-right:8px}.b-status.success[data-v-73d913f1]{color:var(--pass)}.b-status.fail[data-v-73d913f1]{color:var(--fail)}.b-status.running[data-v-73d913f1]{color:var(--amber);animation:flap-in .28s cubic-bezier(.2,.7,.3,1),pulse 1.6s ease-in-out .34s infinite}.b-status.queued[data-v-73d913f1]{color:var(--faint)}.block .b-name[data-v-73d913f1]{font-size:17px;font-weight:700;overflow:hidden;text-overflow:ellipsis}.block .b-dur[data-v-73d913f1]{margin-left:auto;flex:none}.block .b-desc[data-v-73d913f1]{color:var(--dim);font-size:16px;overflow:hidden;text-overflow:ellipsis;min-width:0}.block.running[data-v-73d913f1]{border-color:var(--amber)}.block.running .b-name[data-v-73d913f1]{color:var(--amber)}.block.fail[data-v-73d913f1]{border-color:var(--fail)}.block.queued[data-v-73d913f1]{background:transparent;border-style:dashed;color:var(--dim)}.block.selected[data-v-73d913f1]{outline:2px solid var(--accent);outline-offset:1px}.tool-tick[data-v-73d913f1]{position:absolute;bottom:4px;width:3px;height:9px;background:var(--faint);border-radius:0}.tool-tick.err[data-v-73d913f1]{background:var(--fail)}@media(max-width:980px){.run-strip[data-v-73d913f1]{padding:12px 16px}.waterfall[data-v-73d913f1]{margin:16px;overflow-x:auto}.waterfall .row[data-v-73d913f1]{min-width:700px}}.webmcp-confirm[data-v-397aa307]{position:fixed;right:20px;bottom:20px;z-index:1000;width:min(360px,calc(100vw - 40px));padding:14px 16px;border:1px solid var(--accent);border-radius:var(--radius);background:var(--face)}.wc-label[data-v-397aa307]{display:block;margin-bottom:8px;font-family:var(--mono);font-size:16px;font-weight:600;letter-spacing:.07em;text-transform:uppercase;color:var(--accent)}.wc-message[data-v-397aa307]{margin:0 0 14px;color:var(--fg);font-size:16px;overflow-wrap:anywhere}.wc-actions[data-v-397aa307]{display:flex;justify-content:flex-end;gap:10px}.wc-btn[data-v-397aa307]{padding:5px 14px;border:1px solid var(--rule);border-radius:var(--radius);background:none;color:var(--dim);font-family:var(--mono);font-size:16px;cursor:pointer}.wc-btn[data-v-397aa307]:hover,.wc-btn[data-v-397aa307]:focus-visible{color:var(--fg);border-color:var(--dim)}.wc-confirm[data-v-397aa307]{color:var(--fg);border-color:var(--accent)}.wc-confirm[data-v-397aa307]:hover,.wc-confirm[data-v-397aa307]:focus-visible{color:var(--accent);border-color:var(--accent)}@media(max-width:980px){.webmcp-confirm[data-v-397aa307]{right:12px;bottom:12px;left:12px;width:auto}}.masthead[data-v-cef4df00]{display:flex;align-items:center;justify-content:space-between;gap:16px;padding:16px 28px 14px;position:sticky;top:0;z-index:10;background:var(--ground)}.masthead[data-v-cef4df00]:after{content:"";position:absolute;left:0;right:0;bottom:0;border-bottom:4px double var(--ink)}body.board .masthead[data-v-cef4df00]:after{border-bottom:1px solid var(--rule)}.crumbs[data-v-cef4df00]{display:flex;align-items:center;gap:10px;font-size:17px;flex:1 1 0;min-width:0}.logo[data-v-cef4df00]{width:26px;height:26px;flex:none}.logo-plate[data-v-cef4df00]{fill:var(--face);stroke:var(--fg);stroke-width:1.5}.logo-strip[data-v-cef4df00]{fill:var(--fg)}.logo-accent[data-v-cef4df00]{fill:var(--accent)}.brand[data-v-cef4df00]{color:var(--fg);font-weight:700;letter-spacing:.02em;white-space:nowrap;text-decoration:none;min-width:0;overflow:hidden;text-overflow:ellipsis}.sep[data-v-cef4df00]{color:var(--faint);flex:none}.crumbs a[data-v-cef4df00]{color:var(--dim)}.crumbs a[data-v-cef4df00]:hover{color:var(--fg)}.crumb-id[data-v-cef4df00]{font-family:var(--mono);font-size:16px;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.crumbs .current[data-v-cef4df00]{color:var(--fg)}.live-hint[data-v-cef4df00]{flex:none;display:inline-flex;align-items:center;gap:8px;font-family:var(--mono);font-size:16px;color:var(--live);white-space:nowrap}.live-marker[data-v-cef4df00]{width:9px;height:9px;background:var(--live)}body.board .live-marker[data-v-cef4df00]{border-radius:50%;animation:pulse 1.8s ease-in-out infinite}@media(max-width:980px){.masthead[data-v-cef4df00]{padding:14px 16px 12px}}:root{--sans: "Overpass", system-ui, "Helvetica Neue", Arial, sans-serif;--mono: "Overpass Mono", ui-monospace, "SF Mono", SFMono-Regular, Menlo, Monaco, "Cascadia Mono", "Roboto Mono", monospace;--paper: #f6f3ec;--paper-raised: #fcfaf4;--paper-sunk: #ede8db;--ink: #211e14;--ink-dim: #5f5948;--ink-faint: #76705e;--paper-rule: #d8d2c0;--paper-rule-soft: #e6e1d0;--board: #141311;--board-raised: #1e1c17;--board-sunk: #0c0b09;--bone: #efe8d4;--bone-dim: #96907c;--bone-faint: #857f6a;--board-rule: #37342b;--board-rule-soft: #2a2820;--rail-red: #da291c;--ballpoint: #2545a8;--amber: #e8b64a;--pass-paper: #1e7a3c;--fail-paper: #b3261e;--pass-board: #4ade80;--fail-board: #ff6f67;--radius: 2px}body{--ground: var(--paper);--face: var(--paper-raised);--inset: var(--paper-sunk);--fg: var(--ink);--dim: var(--ink-dim);--faint: var(--ink-faint);--rule: var(--paper-rule);--rule-soft: var(--paper-rule-soft);--accent: var(--rail-red);--live: var(--ballpoint);--pass: var(--pass-paper);--fail: var(--fail-paper)}body.board{--ground: var(--board);--face: var(--board-raised);--inset: var(--board-sunk);--fg: var(--bone);--dim: var(--bone-dim);--faint: var(--bone-faint);--rule: var(--board-rule);--rule-soft: var(--board-rule-soft);--accent: var(--amber);--live: var(--amber);--pass: var(--pass-board);--fail: var(--fail-board)}*{box-sizing:border-box}html,body{margin:0;padding:0}body{background:var(--paper);color:var(--ink);font-family:var(--sans);font-size:16px;line-height:1.5;scrollbar-width:thin;scrollbar-color:var(--rule) transparent}body.board{background:var(--board);color:var(--bone)}#app{min-height:100vh}::selection{background:#f3d8d4;color:var(--ink)}body.board ::selection{background:var(--amber);color:var(--board)}:focus-visible{outline:2px solid var(--accent);outline-offset:2px}::-webkit-scrollbar{width:10px;height:10px}::-webkit-scrollbar-thumb{background:var(--rule);border:3px solid var(--ground);border-radius:6px}::-webkit-scrollbar-track{background:transparent}a{color:var(--ballpoint);text-decoration:none}body.board a{color:var(--amber)}pre{margin:0;padding:12px 14px;background:var(--inset);border:1px solid var(--rule-soft);border-radius:var(--radius);overflow-x:auto;font-family:var(--mono);font-size:16px;line-height:1.55;color:var(--fg);white-space:pre-wrap;word-break:break-word}body.board .j-key{color:var(--bone-dim)}body.board .j-str{color:var(--bone)}body.board .j-bool{color:#d6cdae;font-style:italic}body.board .j-null{color:var(--fail)}.j-key,.j-str{color:var(--ink-dim)}.j-num{color:var(--ballpoint)}body.board .j-num{color:var(--amber)}.j-bool{color:var(--ink-dim);font-style:italic}.j-null{color:var(--fail)}.dim{color:var(--dim)}.faint{color:var(--faint)}.error-bar{margin:12px 24px;padding:10px 14px;border:1px solid var(--fail);background:var(--face);color:var(--fail);border-radius:var(--radius);font-size:16px}.empty-state{padding:72px 24px;text-align:center;color:var(--dim);font-size:16px}.md{font-size:16px;line-height:1.6;color:var(--fg)}.md h1{font-size:20px;margin:14px 0 8px}.md h2{font-size:18px;margin:14px 0 8px}.md h3,.md h4{font-size:17px;margin:12px 0 6px}.md h1:first-child,.md h2:first-child,.md h3:first-child{margin-top:0}.md p{margin:8px 0;white-space:pre-wrap}.md code{background:var(--inset);border:1px solid var(--rule-soft);border-radius:var(--radius);padding:1px 7px;font-family:var(--mono);font-size:16px}.md pre.md-code{margin:10px 0;white-space:pre}.md pre.md-code code{background:transparent;border:none;padding:0;font-size:16px}.md ul,.md ol{margin:8px 0;padding-left:28px}.md li{margin:3px 0}.md blockquote{margin:10px 0;padding:2px 0 2px 14px;border-left:1px solid var(--rule);color:var(--dim);white-space:pre-wrap}.md hr{border:none;border-top:1px solid var(--rule);margin:14px 0}@keyframes flap-in{0%{transform:rotateX(86deg)}to{transform:rotateX(0)}}@keyframes pulse{0%,to{opacity:1}50%{opacity:.35}}@media(prefers-reduced-motion:reduce){*,*:before,*:after{animation-duration:.01ms!important;animation-iteration-count:1!important;transition-duration:.01ms!important}}