@openagt/dashboard 0.8.0 → 0.10.0

package/dist/queue-promote.d.ts

@@ -1,70 +0,0 @@
-import type { GitRunner } from './project.js';
-/**
- * Promoting the agent queue out of a finished agent's branch and into the project checkout (#852).
- *
- * Runs happen in their own git worktree (#736), which is right for code and wrong for the queue:
- * `TODO_AGENTS.md` is shared mutable state, and a worktree forks it. So a quick-wins agent (#773)
- * wrote a perfectly good queue onto a branch nobody reads, auto PM kept seeing an empty checkout,
- * and it re-derived the same entries every cooldown, forever, spending real quota each time.
- *
- * Rom settled the destination on #624: the queue is a durable global `TODO_AGENTS.md` the session
- * writes directly, unlike a *proposal* (a ticket), which is a PR for a human to accept. So the
- * queue belongs in the checkout, and nothing should have to be merged by hand for the loop to turn.
- *
- * The daemon does this, not the agent. The agent stays sandboxed in its worktree with no write
- * access to the project checkout; the daemon copies one known file across, and commits only that
- * pathspec. Narrow enough to audit in a single log line.
- *
- * Conservative everywhere it is not certain: anything unexpected skips with a reason and leaves the
- * checkout untouched. A skipped promotion costs one idle cycle; a wrong one touches a repo a human
- * is working in.
- */
-/** Why a promotion did not happen, or that it did. */
-export type QueuePromotion = {
-    promoted: true;
-    branch: string;
-} | {
-    promoted: false;
-    reason: string;
-    /**
-     * Worth trying again next tick: the queue file is mid-edit in the checkout, and the human's
-     * work outranks an unattended tidy-up only until they commit it. Every other skip is final
-     * for this agent. The callee owns this call — the daemon used to decide it by string-matching
-     * the prose `reason`, where a one-word copyedit would have silently turned "retry next
-     * tick" into "settled forever".
-     */
-    retry?: true;
-};
-/**
- * Copy `TODO_AGENTS.md` from a finished agent's branch into the project checkout and commit it.
- *
- * Skips, rather than forcing, when:
- * - the agent recorded no branch (nothing to read from)
- * - the branch has no queue file, or it matches the checkout already (nothing to do)
- * - the checkout has uncommitted changes to the queue file — a human is mid-edit, and their work
- *   outranks an unattended tidy-up
- *
- * Never throws: this runs on a background tick with nothing to catch it.
- */
-export declare function promoteQueue(projectCwd: string, agent: {
-    id: string;
-    branch?: string | undefined;
-    entry?: string | undefined;
-}, git?: GitRunner, write?: (path: string, content: string) => Promise<void>): Promise<QueuePromotion>;
-/**
- * Land what a drain agent pinned to one entry actually did (#1204): retire that entry, and keep any
- * follow-ups it queued.
- *
- * Additive by construction, which is what makes it safe to run concurrently: it only ever checks a
- * box or appends a line. It never unchecks, never removes, and never reorders, so two drains
- * landing in either order compose, and the worst a wrong guess can do is leave a duplicate line
- * for a human to delete rather than silently send an agent to redo finished work.
- *
- * A follow-up is an entry the agent's branch has that `atBase` did not: written during the agent. The
- * fork point is what tells that from an entry somebody *removed* meanwhile, which looks identical
- * from the branch alone and which `todo_format.md` makes the ordinary way to retire an entry. With
- * no fork point to compare against, nothing is added -- resurrecting struck-off work is worse than
- * leaving a follow-up on the branch, and the check-off still lands either way.
- */
-export declare function landPinnedEntry(inCheckout: string, fromBranch: string, entry: string, atBase: string | undefined): string;
-//# sourceMappingURL=queue-promote.d.ts.map

package/dist/queue-promote.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue-promote.d.ts","sourceRoot":"","sources":["../src/queue-promote.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAK7C;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,sDAAsD;AACtD,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IACE,QAAQ,EAAE,KAAK,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,IAAI,CAAA;CACb,CAAA;AAOL;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAC9E,GAAG,GAAE,SAA2B,EAChC,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAuD,GAC5G,OAAO,CAAC,cAAc,CAAC,CA+CzB;AAeD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,CAmBR"}

package/dist/queue-promote.js

@@ -1,118 +0,0 @@
-import { writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { nodeGitRunner } from './project.js';
-import { FLAT_TODO_FILE } from './tickets.js';
-import { errorMessage } from './error-message.js';
-/** The commit message a promotion writes. Names the agent so the history says where it came from. */
-function promotionMessage(agentId) {
-    return `[The Framework] queue updates from ${agentId}`;
-}
-/**
- * Copy `TODO_AGENTS.md` from a finished agent's branch into the project checkout and commit it.
- *
- * Skips, rather than forcing, when:
- * - the agent recorded no branch (nothing to read from)
- * - the branch has no queue file, or it matches the checkout already (nothing to do)
- * - the checkout has uncommitted changes to the queue file — a human is mid-edit, and their work
- *   outranks an unattended tidy-up
- *
- * Never throws: this runs on a background tick with nothing to catch it.
- */
-export async function promoteQueue(projectCwd, agent, git = nodeGitRunner(), write = (path, content) => writeFile(path, content, 'utf8')) {
-    const branch = agent.branch;
-    if (!branch)
-        return { promoted: false, reason: 'the run recorded no branch' };
-    try {
-        // The queue as the agent left it. An agent that never touched it has no such path on the branch.
-        const fromBranch = await git(['show', `${branch}:${FLAT_TODO_FILE}`], projectCwd).catch(() => undefined);
-        if (fromBranch === undefined)
-            return { promoted: false, reason: 'the run left no queue file on its branch' };
-        const inCheckout = await git(['show', `HEAD:${FLAT_TODO_FILE}`], projectCwd).catch(() => '');
-        if (fromBranch === inCheckout)
-            return { promoted: false, reason: 'the queue is already up to date' };
-        // A dirty queue file means someone is editing it by hand right now. Leave it alone; the next
-        // tick will try again, and until then auto PM simply does not start more work.
-        const dirty = (await git(['status', '--porcelain', '--', FLAT_TODO_FILE], projectCwd)).trim();
-        if (dirty)
-            return { promoted: false, reason: 'the checkout has uncommitted queue changes', retry: true };
-        // An agent pinned to one entry (#1204) lands that entry, not its whole file: with several drains
-        // in flight the wholesale copy below would carry each agent's stale view of every *other* entry,
-        // and the last promotion of the tick would un-check whatever the earlier ones had just retired.
-        if (agent.entry !== undefined) {
-            // The queue where the agent forked, so an entry it *added* can be told from one somebody
-            // *removed* while it worked. Both look alike from the branch alone — present there, absent
-            // here — and `todo_format.md` makes removal the way to retire an entry, so guessing wrong
-            // resurrects work a human deliberately struck off. No merge base (a rewritten history, say)
-            // means no additions land: the check-off is the part that must not be lost.
-            const mergeBase = (await git(['merge-base', branch, 'HEAD'], projectCwd).catch(() => '')).trim();
-            const atBase = mergeBase
-                ? await git(['show', `${mergeBase}:${FLAT_TODO_FILE}`], projectCwd).catch(() => undefined)
-                : undefined;
-            const landed = landPinnedEntry(inCheckout, fromBranch, agent.entry, atBase);
-            if (landed === inCheckout)
-                return { promoted: false, reason: 'the run left nothing to land on the queue' };
-            await write(join(projectCwd, FLAT_TODO_FILE), landed);
-            await git(['add', '--', FLAT_TODO_FILE], projectCwd);
-            await git(['commit', '-m', promotionMessage(agent.id), '--', FLAT_TODO_FILE], projectCwd);
-            return { promoted: true, branch };
-        }
-        // `checkout <branch> -- <path>` writes the file and stages it in one step, touching nothing
-        // else in the tree. The commit is pathspec-scoped for the same reason: whatever else is
-        // staged in the user's checkout is theirs and must not ride along.
-        await git(['checkout', branch, '--', FLAT_TODO_FILE], projectCwd);
-        await git(['commit', '-m', promotionMessage(agent.id), '--', FLAT_TODO_FILE], projectCwd);
-        return { promoted: true, branch };
-    }
-    catch (err) {
-        return { promoted: false, reason: errorMessage(err) };
-    }
-}
-/** One markdown list item, by the grammar `parseTodoEntries` reads. */
-const ENTRY_LINE = /^(\s*(?:[-*]|\d+\.)\s+)(?:\[([ xX])\]\s*)?(.*)$/;
-/** Every entry the document names, checked or not, so a re-add can tell "new" from "already there". */
-function entryTexts(md) {
-    const texts = new Set();
-    for (const line of md.split('\n')) {
-        const text = ENTRY_LINE.exec(line)?.[3]?.trim();
-        if (text)
-            texts.add(text);
-    }
-    return texts;
-}
-/**
- * Land what a drain agent pinned to one entry actually did (#1204): retire that entry, and keep any
- * follow-ups it queued.
- *
- * Additive by construction, which is what makes it safe to run concurrently: it only ever checks a
- * box or appends a line. It never unchecks, never removes, and never reorders, so two drains
- * landing in either order compose, and the worst a wrong guess can do is leave a duplicate line
- * for a human to delete rather than silently send an agent to redo finished work.
- *
- * A follow-up is an entry the agent's branch has that `atBase` did not: written during the agent. The
- * fork point is what tells that from an entry somebody *removed* meanwhile, which looks identical
- * from the branch alone and which `todo_format.md` makes the ordinary way to retire an entry. With
- * no fork point to compare against, nothing is added -- resurrecting struck-off work is worse than
- * leaving a follow-up on the branch, and the check-off still lands either way.
- */
-export function landPinnedEntry(inCheckout, fromBranch, entry, atBase) {
-    const lines = inCheckout.split('\n').map(line => {
-        const item = ENTRY_LINE.exec(line);
-        // Retire any *open* entry that matches — an empty `[ ]` box or a no-checkbox bullet alike,
-        // the same "open" grammar `parseTodoEntries` uses (#1164/#1297).
-        // Skipping the no-checkbox form left it open, so the sweep re-drained it after the PR closed.
-        if (!item || item[3]?.trim() !== entry || item[2] === 'x' || item[2] === 'X')
-            return line;
-        return `${item[1]}[x] ${item[3].trim()}`;
-    });
-    if (atBase === undefined)
-        return lines.join('\n');
-    const known = entryTexts(inCheckout);
-    const base = entryTexts(atBase);
-    const added = [...entryTexts(fromBranch)].filter(text => !known.has(text) && !base.has(text));
-    if (!added.length)
-        return lines.join('\n');
-    const body = lines.join('\n');
-    const separator = body === '' || body.endsWith('\n') ? '' : '\n';
-    return `${body}${separator}${added.map(text => `- [ ] ${text}`).join('\n')}\n`;
-}
-//# sourceMappingURL=queue-promote.js.map

package/dist/queue-promote.js.map

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

package/dist/relay.d.ts

@@ -1,84 +0,0 @@
-import type { FrameworkEvent } from './events.js';
-/**
- * The hosted run relay (#230): the first slice toward shared team sessions. It
- * ingests a run's {@link FrameworkEvent} stream over HTTP and re-serves the same new
- * dashboard (#405) to N remote browsers, keyed by run id. So two people on different
- * machines open one run URL and both watch it live.
- *
- * It serves the prerendered dashboard SPA and streams events over Telefunc, exactly
- * like the daemon — except the run comes from the relay's own in-memory stream (fed by
- * publishers over HTTP), not a file. The dashboard opens in a read-only, single-run
- * "watch" mode (no Projects/Runs/Docs rails, no Stop/Start), and only the live event
- * stream is exposed: an empty projects provider (#426) makes the file/registry-backed
- * RPCs return nothing on this public host.
- *
- * Deliberately unauthenticated: anyone with a run's URL can watch it. Accounts, teams,
- * RBAC, and authorized steering layer on later (via vike-auth/-rbac). The relay only
- * projects the stream — it never runs an agent.
- *
- * Endpoints:
- * - `POST /r/:id/publish` — ingest one event (JSON object) or a batch (JSON array)
- * - `GET  /?run=:id`      — the dashboard SPA in read-only watch mode for that run
- * - `GET  /r/:id[/]`      — redirects to `/?run=:id` (the viewer URL)
- * - `POST /_telefunc`     — the dashboard's Telefunc surface (only `onEvents` is live)
- * - `GET  /assets/…`      — the SPA's static assets
- * - `GET  /healthz`       — liveness probe for the host
- */
-export interface RelayOptions {
-    /** Port to bind. Default `4488`; pass `0` for an ephemeral port. */
-    port?: number;
-    /**
-     * Host to bind. Default `0.0.0.0` — the relay exists to be reached from other
-     * machines. Bind `127.0.0.1` to keep it local (e.g. tests).
-     */
-    host?: string;
-    /** Page title. Default `"The Framework"`. */
-    title?: string;
-    /** Max bytes accepted per publish request body. Default 256 KiB. */
-    maxBodyBytes?: number;
-    /**
-     * Max concurrent runs kept in memory. The relay is unauthenticated, so any
-     * request to `/r/<id>/…` would otherwise create a run that never frees — an
-     * anonymous caller could exhaust memory. On overflow the least-recently-touched
-     * run is evicted (its stream closed, its viewers dropped). Default 200.
-     */
-    maxRuns?: number;
-    /**
-     * The prerendered dashboard bundle to serve (the SPA `index.html` + `assets/**`).
-     * Defaults to {@link resolveDashboardBundle}; pass a directory to override (tests).
-     * When no bundle is found, the SPA routes 404 while publish/telefunc/healthz still work.
-     */
-    clientBundleDir?: string;
-}
-/** A running relay. Ingest events programmatically or over HTTP; browsers watch by run id. */
-export interface Relay {
-    /** The base URL of the relay (e.g. `http://0.0.0.0:4488`). */
-    readonly url: string;
-    /** The viewer URL for a run id (`<url>/?run=<id>`). */
-    viewerUrl(runId: string): string;
-    /** Push one event into a run's stream, creating the run on first use. */
-    ingest(runId: string, event: FrameworkEvent): void;
-    /** The run ids seen so far. */
-    runIds(): string[];
-    /** Close every stream and stop the server. Idempotent. */
-    close(): Promise<void>;
-}
-/** Start the hosted run relay. See {@link Relay}. */
-export declare function startRelay(opts?: RelayOptions): Promise<Relay>;
-/** A publisher that forwards a run's events to a relay. Best-effort and ordered. */
-export interface RelayPublisher {
-    /** The viewer URL to share (`<base>/?run=<id>`). */
-    readonly url: string;
-    /** Queue one event to POST to the relay (serialized, so the relay replays in order). */
-    publish(event: FrameworkEvent): void;
-    /** Resolve once every queued POST has been sent (or failed), for a clean shutdown. */
-    flush(): Promise<void>;
-}
-/**
- * Forward a live run's {@link FrameworkEvent}s to a {@link startRelay} relay so
- * remote browsers can watch it. POSTs are serialized (chained) so the relay's
- * replay order matches the run, and best-effort: a failed POST is reported via
- * `onError` but never interrupts the run.
- */
-export declare function relayPublisher(base: string, runId: string, onError?: (err: unknown) => void, timeoutMs?: number): RelayPublisher;
-//# sourceMappingURL=relay.d.ts.map

package/dist/relay.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAOjD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,8FAA8F;AAC9F,MAAM,WAAW,KAAK;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,uDAAuD;IACvD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,yEAAyE;IACzE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;IAClD,+BAA+B;IAC/B,MAAM,IAAI,MAAM,EAAE,CAAA;IAClB,0DAA0D;IAC1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAQD,qDAAqD;AACrD,wBAAsB,UAAU,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,KAAK,CAAC,CAmDxE;AA0GD,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,wFAAwF;IACxF,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;IACpC,sFAAsF;IACtF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,EAChC,SAAS,SAAS,GACjB,cAAc,CA8BhB"}

package/dist/relay.js

@@ -1,199 +0,0 @@
-import { createServer } from 'node:http';
-import { EventStream } from '@gemstack/ai-autopilot';
-import { resolveDashboardBundle } from './dashboard/bundle.js';
-import { serveClientBundle } from './dashboard/static.js';
-import { makeTelefuncMount } from './dashboard/telefunc-serve.js';
-import { requestPathname } from './request-path.js';
-import { emptyProjectsProvider } from './dashboard/projects.js';
-const RUN_PATH = /^\/r\/([^/]+)(\/[^?]*)?/;
-/** Start the hosted run relay. See {@link Relay}. */
-export async function startRelay(opts = {}) {
-    const host = opts.host ?? '0.0.0.0';
-    const port = opts.port ?? 4488;
-    const maxBody = opts.maxBodyBytes ?? 256 * 1024;
-    const maxRuns = opts.maxRuns ?? 200;
-    const clientBundleDir = opts.clientBundleDir ?? (await resolveDashboardBundle());
-    // Insertion-ordered as an LRU: touching a run re-inserts it at the end, so the
-    // first entry is always the least-recently-used and the eviction victim.
-    const runs = new Map();
-    const run = (id) => {
-        const existing = runs.get(id);
-        if (existing) {
-            runs.delete(id);
-            runs.set(id, existing); // touch: move to most-recently-used
-            return existing;
-        }
-        // Bound memory: evict the least-recently-used run before creating a new one.
-        while (runs.size >= maxRuns) {
-            const oldest = runs.keys().next().value;
-            if (oldest === undefined)
-                break;
-            runs.get(oldest).stream.close(); // closing drains every viewer's Channel follower
-            runs.delete(oldest);
-        }
-        const r = { stream: new EventStream() };
-        runs.set(id, r);
-        return r;
-    };
-    // The dashboard's Telefunc surface, mounted like the daemon's — but `onEvents` streams
-    // the relay's own in-memory run (create-on-access, so a viewer can connect before the
-    // publisher), and an empty projects provider neutralizes every file/registry RPC on
-    // this public host. No `startRun`, so a start is never enabled here.
-    const telefunc = makeTelefuncMount({ projects: emptyProjectsProvider(), eventsSource: id => run(id).stream });
-    const server = createServer((req, res) => handle(req, res, { run, maxBody, clientBundleDir, telefunc }));
-    return new Promise((resolvePromise, rejectPromise) => {
-        server.once('error', rejectPromise);
-        server.listen(port, host, () => {
-            server.removeListener('error', rejectPromise);
-            const address = server.address();
-            const url = `http://${host}:${address.port}`;
-            resolvePromise({
-                url,
-                viewerUrl: id => `${url}/?run=${encodeURIComponent(id)}`,
-                ingest: (id, event) => run(id).stream.push(event),
-                runIds: () => [...runs.keys()],
-                close: () => closeRelay(server, runs),
-            });
-        });
-    });
-}
-function handle(req, res, ctx) {
-    // A public server: a request no URL parser accepts must get a 400, not crash the relay (#938).
-    const pathname = requestPathname(req);
-    if (pathname === undefined) {
-        res.writeHead(400, { 'content-type': 'text/plain' });
-        res.end('bad request');
-        return;
-    }
-    if (pathname === '/healthz') {
-        res.writeHead(200, { 'content-type': 'text/plain' });
-        res.end('ok');
-        return;
-    }
-    // The dashboard's live event stream (and the rest of its RPC surface, neutralized).
-    if (pathname === '/_telefunc' || pathname.startsWith('/_telefunc/')) {
-        void ctx.telefunc(req, res);
-        return;
-    }
-    const m = RUN_PATH.exec(pathname);
-    if (m) {
-        // A malformed escape in the id segment (`/r/%zz/`) must not throw out of the handler (#938).
-        let id;
-        try {
-            id = decodeURIComponent(m[1]);
-        }
-        catch {
-            res.writeHead(400, { 'content-type': 'text/plain' });
-            res.end('bad request');
-            return;
-        }
-        const rest = m[2] ?? '';
-        // Ingest is the one thing still under /r/:id/ — the publisher POSTs a run's events here.
-        if (rest === '/publish') {
-            if (req.method !== 'POST') {
-                res.writeHead(405, { 'content-type': 'text/plain', allow: 'POST' });
-                res.end('method not allowed');
-                return;
-            }
-            ingestBody(req, res, ctx.run(id), ctx.maxBody);
-            return;
-        }
-        // Any viewer GET of a run moved to the SPA at `/?run=:id`; redirect old links there.
-        res.writeHead(302, { location: `/?run=${encodeURIComponent(id)}` });
-        res.end();
-        return;
-    }
-    // Everything else is the dashboard SPA (`/`, `/?run=:id`, `/assets/**`, SPA fallback).
-    if (ctx.clientBundleDir) {
-        void serveClientBundle(req, res, ctx.clientBundleDir);
-        return;
-    }
-    res.writeHead(404, { 'content-type': 'text/plain' });
-    res.end('dashboard bundle not built');
-}
-/** Read a JSON body (one event or an array) and push each event into the run's stream. */
-function ingestBody(req, res, r, maxBody) {
-    // Collect raw bytes and decode once at the end: a per-chunk `String(chunk)` corrupts a
-    // multibyte UTF-8 codepoint split across two chunks, and the cap is in bytes, not the
-    // UTF-16 code units a string length would count.
-    const chunks = [];
-    let bytes = 0;
-    let tooBig = false;
-    req.on('data', (chunk) => {
-        if (tooBig)
-            return;
-        bytes += chunk.length;
-        if (bytes > maxBody) {
-            tooBig = true;
-            res.writeHead(413, { 'content-type': 'text/plain' });
-            res.end('payload too large');
-            req.destroy();
-            return;
-        }
-        chunks.push(chunk);
-    });
-    req.on('end', () => {
-        if (tooBig)
-            return;
-        let parsed;
-        try {
-            parsed = JSON.parse(Buffer.concat(chunks).toString('utf8'));
-        }
-        catch {
-            res.writeHead(400, { 'content-type': 'text/plain' });
-            res.end('invalid json');
-            return;
-        }
-        const events = (Array.isArray(parsed) ? parsed : [parsed]);
-        for (const event of events)
-            r.stream.push(event);
-        res.writeHead(202, { 'content-type': 'application/json' });
-        res.end(`{"ok":true,"received":${events.length}}`);
-    });
-}
-function closeRelay(server, runs) {
-    for (const { stream } of runs.values())
-        stream.close(); // closing drains each Channel follower
-    runs.clear();
-    return new Promise(resolvePromise => server.close(() => resolvePromise()));
-}
-/**
- * Forward a live run's {@link FrameworkEvent}s to a {@link startRelay} relay so
- * remote browsers can watch it. POSTs are serialized (chained) so the relay's
- * replay order matches the run, and best-effort: a failed POST is reported via
- * `onError` but never interrupts the run.
- */
-export function relayPublisher(base, runId, onError, timeoutMs = 10_000) {
-    const origin = base.replace(/\/+$/, '');
-    const root = `${origin}/r/${encodeURIComponent(runId)}`;
-    let chain = Promise.resolve();
-    return {
-        // Share the SPA viewer URL; events still POST to the ingest route under /r/:id/.
-        url: `${origin}/?run=${encodeURIComponent(runId)}`,
-        publish(event) {
-            chain = chain.then(async () => {
-                try {
-                    // Timeout so a relay that accepts but never responds can't wedge flush()
-                    // (awaited on shutdown) and hang the whole CLI on exit.
-                    const res = await fetch(`${root}/publish`, {
-                        method: 'POST',
-                        headers: { 'content-type': 'application/json' },
-                        body: JSON.stringify(event),
-                        signal: AbortSignal.timeout(timeoutMs),
-                    });
-                    // fetch only throws on a transport failure, so a rejected event (413 over
-                    // the body cap, 400, or a URL that isn't a relay) would otherwise be silent.
-                    if (!res.ok)
-                        throw new Error(`relay answered ${res.status} ${res.statusText}`.trimEnd());
-                }
-                catch (err) {
-                    onError?.(err);
-                }
-            });
-        },
-        flush() {
-            return chain;
-        },
-    };
-}
-//# sourceMappingURL=relay.js.map

package/dist/relay.js.map

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

package/dist/repos-directory.d.ts

@@ -1,19 +0,0 @@
-import { type NodeFs } from './node-fs.js';
-/**
- * The repos-directory helper (#1123): find the git repos directly inside a directory the user
- * pointed The Framework at, so the daemon can auto-register them when the opt-in is on.
- *
- * The fs is a seam so this is unit-testable without touching disk, matching the rest of the package.
- */
-/** The narrow fs the scan needs: list a directory and test its entries. {@link nodeFs} satisfies it. */
-export type ReposDirectoryFs = Pick<NodeFs, 'readdir' | 'isDirectory' | 'exists'>;
-/**
- * The immediate subdirectories of `dir` that are git repos: a child directory holding a `.git`
- * (a directory in a normal clone, a file in a worktree or submodule). Returns absolute paths, sorted.
- *
- * Only one level deep on purpose (#1123): the auto-grant's blast radius is "this directory of repos",
- * not the whole tree beneath it. A missing `dir` yields `[]` (readdir already swallows that), so it
- * never throws on boot.
- */
-export declare function listReposInDirectory(dir: string, fs?: ReposDirectoryFs): Promise<string[]>;
-//# sourceMappingURL=repos-directory.d.ts.map

package/dist/repos-directory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"repos-directory.d.ts","sourceRoot":"","sources":["../src/repos-directory.ts"],"names":[],"mappings":"AACA,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AAElD;;;;;GAKG;AAEH,wGAAwG;AACxG,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,QAAQ,CAAC,CAAA;AAEjF;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,GAAE,gBAA2B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAS1G"}

package/dist/repos-directory.js

@@ -1,23 +0,0 @@
-import { join } from 'node:path';
-import { nodeFs } from './node-fs.js';
-/**
- * The immediate subdirectories of `dir` that are git repos: a child directory holding a `.git`
- * (a directory in a normal clone, a file in a worktree or submodule). Returns absolute paths, sorted.
- *
- * Only one level deep on purpose (#1123): the auto-grant's blast radius is "this directory of repos",
- * not the whole tree beneath it. A missing `dir` yields `[]` (readdir already swallows that), so it
- * never throws on boot.
- */
-export async function listReposInDirectory(dir, fs = nodeFs()) {
-    const repos = [];
-    for (const name of (await fs.readdir(dir)).sort()) {
-        const child = join(dir, name);
-        if (!(await fs.isDirectory(child)))
-            continue;
-        const git = join(child, '.git');
-        if ((await fs.exists(git)) || (await fs.isDirectory(git)))
-            repos.push(child);
-    }
-    return repos;
-}
-//# sourceMappingURL=repos-directory.js.map

package/dist/repos-directory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"repos-directory.js","sourceRoot":"","sources":["../src/repos-directory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,MAAM,EAAe,MAAM,cAAc,CAAA;AAYlD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAW,EAAE,KAAuB,MAAM,EAAE;IACrF,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QAC7B,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAAE,SAAQ;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAC/B,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC9E,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/retired-project-settings.d.ts

@@ -1,43 +0,0 @@
-import { type HandoffLevel } from './handoff-level.js';
-import { type RegistryFs } from './registry.js';
-/** One project that had a block, as the notice needs to talk about it. */
-export interface RetiredProjectSettings {
-    /** The repo the block was about. Its path, because a project id names nothing to a reader. */
-    path: string;
-    /** The keys the block held, in file order — so the notice can say what stopped applying. */
-    keys: string[];
-    /** Whether the block set how far this repo publishes, in any spelling. See {@link PUBLISH_KEYS}. */
-    publishes: boolean;
-    /**
-     * The publish rung the block set, when it set one this can name. Absent for a block written
-     * before the ladder, which the reader restates by hand — `publishes` is what says to.
-     */
-    handoff?: HandoffLevel;
-}
-/**
- * The retired blocks in the registry file, or `[]` when there are none (which is everyone who
- * never used the tier, and everyone whose file has been written once since).
- *
- * Reads the raw file rather than going through `readRegistry`, which drops the block on the way in
- * — that is the point of the removal, and it is what leaves this the only reader.
- */
-export declare function readRetiredProjectSettings(fs?: RegistryFs, env?: NodeJS.ProcessEnv): Promise<RetiredProjectSettings[]>;
-/** Read the blocks and hold them for this process. Called once, first thing, by the daemon. */
-export declare function captureRetiredProjectSettings(fs?: RegistryFs, env?: NodeJS.ProcessEnv): Promise<readonly RetiredProjectSettings[]>;
-/** What the boot read found. Empty until {@link captureRetiredProjectSettings} has run. */
-export declare function retiredProjectSettings(): readonly RetiredProjectSettings[];
-/**
- * What a repo's row has to say, as both surfaces say it.
- *
- * A block that set publishing gets the line to write and what happens without it, because that is
- * the direction that acts outward on its own. Everything else is told what applies instead, which
- * is true only for a block that did *not* set publishing — hence the flag rather than the rung.
- */
-export declare function retiredProjectAdvice(project: RetiredProjectSettings): string;
-/**
- * The notice as the daemon's log prints it: one line naming the tier, then one per project.
- *
- * Empty for an empty list, so the caller prints nothing rather than a heading over nothing.
- */
-export declare function retiredProjectSettingsNotice(retired: readonly RetiredProjectSettings[]): string[];
-//# sourceMappingURL=retired-project-settings.d.ts.map

package/dist/retired-project-settings.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"retired-project-settings.d.ts","sourceRoot":"","sources":["../src/retired-project-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,eAAe,CAAA;AA+B7E,0EAA0E;AAC1E,MAAM,WAAW,sBAAsB;IACrC,8FAA8F;IAC9F,IAAI,EAAE,MAAM,CAAA;IACZ,4FAA4F;IAC5F,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,oGAAoG;IACpG,SAAS,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,EAAE,GAAE,UAA6B,EACjC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAmCnC;AAYD,+FAA+F;AAC/F,wBAAsB,6BAA6B,CACjD,EAAE,CAAC,EAAE,UAAU,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,SAAS,sBAAsB,EAAE,CAAC,CAG5C;AAED,2FAA2F;AAC3F,wBAAgB,sBAAsB,IAAI,SAAS,sBAAsB,EAAE,CAE1E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAI5E;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,GAAG,MAAM,EAAE,CASjG"}