@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/ci-watch.js.map

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

package/dist/claude-trust.d.ts

@@ -0,0 +1,16 @@
+/** What is known about a root's trust. `known: false` means the file could not say. */
+export interface ClaudeTrust {
+    known: boolean;
+    trusted: boolean;
+}
+/** Whether the CLI trusts `root`. Unknown when the config is missing or not understood. */
+export declare function readClaudeTrust(root: string, path?: string): Promise<ClaudeTrust>;
+/**
+ * Record that the CLI can trust `root` (#1493): the exact record the CLI itself writes
+ * when the user accepts its dialog, so the dialog never fires. Everything else in the
+ * config — other projects, top-level settings, the entry's own sibling fields — is
+ * preserved. A missing file is created; an existing file that does not parse is refused
+ * with a throw rather than overwritten, since the file is the CLI's, not ours.
+ */
+export declare function writeClaudeTrust(root: string, path?: string): Promise<void>;
+//# sourceMappingURL=claude-trust.d.ts.map

package/dist/claude-trust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-trust.d.ts","sourceRoot":"","sources":["../src/claude-trust.ts"],"names":[],"mappings":"AA2BA,uFAAuF;AACvF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,2FAA2F;AAC3F,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAA2B,GAAG,OAAO,CAAC,WAAW,CAAC,CAc3G;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBrG"}

package/dist/claude-trust.js

@@ -0,0 +1,72 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Claude Code's folder trust: read it, and grant it for a web run (#1493).
+ *
+ * The CLI asks its one-time "do you trust this folder?" question interactively, which a
+ * `--cloud` start under the daemon's pty can never answer (#1314) — a web agent on an
+ * untrusted project was doomed before it started. Trust was read-only here at first
+ * (#1318: warn in the dashboard, name the one-time manual step), but any manual setup
+ * step breaks the "click and it works" story for web runs, so #1493 reversed that
+ * decision: the framework now writes the CLI's own trust record before the hand-off.
+ * Starting a web agent on a project is itself a trust decision by the user — the write
+ * automates consent already given, it does not invent it.
+ *
+ * Reading stays fail-quiet: a missing, unreadable or reshaped `~/.claude.json` answers
+ * "unknown". Writing is the opposite — an existing file that does not parse is left
+ * alone (throw, never destroy the CLI's config), and the caller falls back to the
+ * interactive-advice path.
+ */
+/** Where the Claude Code CLI records per-directory trust. */
+function claudeConfigPath(home = homedir()) {
+    return join(home, '.claude.json');
+}
+/** Whether the CLI trusts `root`. Unknown when the config is missing or not understood. */
+export async function readClaudeTrust(root, path = claudeConfigPath()) {
+    let config;
+    try {
+        config = JSON.parse(await readFile(path, 'utf8'));
+    }
+    catch {
+        return { known: false, trusted: false };
+    }
+    if (typeof config !== 'object' || config === null)
+        return { known: false, trusted: false };
+    const projects = config.projects;
+    if (typeof projects !== 'object' || projects === null || Array.isArray(projects))
+        return { known: false, trusted: false };
+    const entry = projects[root];
+    const trusted = typeof entry === 'object' && entry !== null && entry.hasTrustDialogAccepted === true;
+    return { known: true, trusted };
+}
+/**
+ * Record that the CLI can trust `root` (#1493): the exact record the CLI itself writes
+ * when the user accepts its dialog, so the dialog never fires. Everything else in the
+ * config — other projects, top-level settings, the entry's own sibling fields — is
+ * preserved. A missing file is created; an existing file that does not parse is refused
+ * with a throw rather than overwritten, since the file is the CLI's, not ours.
+ */
+export async function writeClaudeTrust(root, path = claudeConfigPath()) {
+    let raw;
+    try {
+        raw = await readFile(path, 'utf8');
+    }
+    catch {
+        // No file yet: create one carrying only the trust record; the CLI accepts and extends it.
+    }
+    let config = {};
+    if (raw !== undefined) {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+            throw new Error(`[framework] ${path} exists but is not a JSON object`);
+        config = parsed;
+    }
+    const projects = typeof config.projects === 'object' && config.projects !== null && !Array.isArray(config.projects)
+        ? config.projects
+        : {};
+    const entry = typeof projects[root] === 'object' && projects[root] !== null ? projects[root] : {};
+    config.projects = { ...projects, [root]: { ...entry, hasTrustDialogAccepted: true } };
+    await writeFile(path, JSON.stringify(config, null, 2), 'utf8');
+}
+//# sourceMappingURL=claude-trust.js.map

package/dist/claude-trust.js.map

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

package/dist/cli-exec.d.ts

@@ -0,0 +1,36 @@
+/**
+ * One `execFile`-backed CLI runner, configured per binary — `gh`'s reads and writes. Git runs
+ * through the `skill-branches` package's own runner, which budgets per subcommand.
+ */
+/** Runs a CLI binary in `cwd`, resolving its stdout. Rejects on a non-zero exit. */
+export type CliRunner = (args: string[], cwd: string) => Promise<string>;
+/**
+ * A CLI killed for outrunning its timeout, as opposed to one the tool itself rejected (#997).
+ *
+ * `execFile` SIGTERMs on timeout, and a killed `git push` usually writes nothing to stderr, so
+ * without this the failure surfaces as a bare "Command failed: git push ..." that reads like a
+ * rejected push.
+ */
+export declare class CliTimeoutError extends Error {
+    readonly bin: string;
+    readonly args: string[];
+    readonly timeoutMs: number;
+    /** Brand, so a value that crossed a module boundary is still recognisable. */
+    readonly timedOut = true;
+    constructor(bin: string, args: string[], timeoutMs: number);
+}
+/** How to invoke one binary. */
+export interface CliRunnerOptions {
+    bin: string;
+    /** Kill the process after this long, so a hung CLI cannot hang the caller. */
+    timeoutMs: number;
+    /**
+     * Reject with the CLI's own stderr rather than the generic exec message. `gh` puts the
+     * useful part there ("not logged in", "no default remote"), and that is exactly what the
+     * dashboard should show instead of a generic failure.
+     */
+    preferStderr?: boolean;
+}
+/** Build a {@link CliRunner} for one binary. */
+export declare function cliRunner(opts: CliRunnerOptions): CliRunner;
+//# sourceMappingURL=cli-exec.d.ts.map

package/dist/cli-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-exec.d.ts","sourceRoot":"","sources":["../src/cli-exec.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oFAAoF;AACpF,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAExE;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAItC,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAL5B,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,QAAO;IACxB,YACW,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,MAAM,EAI3B;CACF;AAED,gCAAgC;AAChC,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,gDAAgD;AAChD,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,CAe3D"}

package/dist/cli-exec.js

@@ -0,0 +1,44 @@
+/**
+ * One `execFile`-backed CLI runner, configured per binary — `gh`'s reads and writes. Git runs
+ * through the `skill-branches` package's own runner, which budgets per subcommand.
+ */
+/**
+ * A CLI killed for outrunning its timeout, as opposed to one the tool itself rejected (#997).
+ *
+ * `execFile` SIGTERMs on timeout, and a killed `git push` usually writes nothing to stderr, so
+ * without this the failure surfaces as a bare "Command failed: git push ..." that reads like a
+ * rejected push.
+ */
+export class CliTimeoutError extends Error {
+    bin;
+    args;
+    timeoutMs;
+    /** Brand, so a value that crossed a module boundary is still recognisable. */
+    timedOut = true;
+    constructor(bin, args, timeoutMs) {
+        super(`${bin} ${args.join(' ')} timed out after ${timeoutMs}ms`);
+        this.bin = bin;
+        this.args = args;
+        this.timeoutMs = timeoutMs;
+        this.name = 'CliTimeoutError';
+    }
+}
+/** Build a {@link CliRunner} for one binary. */
+export function cliRunner(opts) {
+    return async (args, cwd) => {
+        const { execFile } = await import('node:child_process');
+        return new Promise((resolvePromise, rejectPromise) => {
+            execFile(opts.bin, args, { cwd, timeout: opts.timeoutMs }, (err, stdout, stderr) => {
+                if (!err)
+                    return resolvePromise(String(stdout));
+                // execFile kills on both timeout and a maxBuffer overrun; only the latter carries ENOBUFS.
+                const killed = err.killed === true;
+                if (killed && err.code !== 'ENOBUFS') {
+                    return rejectPromise(new CliTimeoutError(opts.bin, args, opts.timeoutMs));
+                }
+                rejectPromise(opts.preferStderr ? new Error(String(stderr).trim() || err.message) : err);
+            });
+        });
+    };
+}
+//# sourceMappingURL=cli-exec.js.map

package/dist/cli-exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-exec.js","sourceRoot":"","sources":["../src/cli-exec.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;;;GAMG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAI7B,GAAG;IACH,IAAI;IACJ,SAAS;IALpB,8EAA8E;IACrE,QAAQ,GAAG,IAAI,CAAA;IACxB,YACW,GAAW,EACX,IAAc,EACd,SAAiB;QAE1B,KAAK,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,SAAS,IAAI,CAAC,CAAA;mBAJvD,GAAG;oBACH,IAAI;yBACJ,SAAS;QAGlB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF;AAeD,gDAAgD;AAChD,MAAM,UAAU,SAAS,CAAC,IAAsB;IAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QACzB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAA;QACvD,OAAO,IAAI,OAAO,CAAS,CAAC,cAAc,EAAE,aAAa,EAAE,EAAE;YAC3D,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;gBACjF,IAAI,CAAC,GAAG;oBAAE,OAAO,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;gBAC/C,2FAA2F;gBAC3F,MAAM,MAAM,GAAI,GAA4B,CAAC,MAAM,KAAK,IAAI,CAAA;gBAC5D,IAAI,MAAM,IAAK,GAA0B,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBAC7D,OAAO,aAAa,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;gBAC3E,CAAC;gBACD,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;YAC1F,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,43 @@
+import { type VersionFetcher } from './update-check.js';
+/** Where the CLI writes. Injectable so tests capture output. */
+export interface CliIO {
+    out: (line: string) => void;
+    err: (line: string) => void;
+}
+export declare function frameworkVersion(): string;
+/** What the CLI itself accepts: four options, no verbs (D4). */
+export interface CliArgs {
+    help: boolean;
+    version: boolean;
+    /** `--port <n>`: the port the dashboard binds. Default {@link DEFAULT_DAEMON_PORT}; `0` is ephemeral. */
+    port?: number;
+    /**
+     * `--host <addr>` (#1051): the dashboard's bind address. Default loopback; a non-loopback
+     * address exposes it to the network and gates every route behind the generated shared token.
+     */
+    host?: string;
+    error?: string;
+}
+/**
+ * Parse argv (without the node/script prefix). Pure and testable.
+ *
+ * Four options and nothing else: `--host` and `--port` because they are the two things a browser
+ * cannot be asked and a dashboard cannot serve about itself; `--help` and `--version` because a
+ * command with options owes the user both. The command runs no agent (#1774): a run is started
+ * from the dashboard, by the project's own start hook.
+ */
+export declare function parseArgs(argv: string[]): CliArgs;
+export declare function runCli(argv: string[], io?: CliIO): Promise<number>;
+/**
+ * The startup footer every dashboard path prints (#312): where prompts come from, the version,
+ * and then — once npm answers — whether that version is the latest.
+ *
+ * The update line is deliberately not awaited before the static lines. #312 asks for the static
+ * info first, and the foreground path (bare `openagent`) blocks on the server forever, so a line
+ * printed after the await would never appear there at all. `checkForUpdate` is already forgiving:
+ * offline or slow (2.5s cap) resolves to 'unknown', which prints nothing.
+ */
+export declare function printStartupFooter(io: CliIO, opts?: {
+    fetchLatest?: VersionFetcher;
+}): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAGA,OAAO,EAA0D,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAK/G,gEAAgE;AAChE,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC5B;AAcD,wBAAgB,gBAAgB,IAAI,MAAM,CAYzC;AAqBD,gEAAgE;AAChE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,yGAAyG;IACzG,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CA8BjD;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,KAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBnF;AAmDD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,cAAc,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAaxG"}

package/dist/cli.js

@@ -0,0 +1,186 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { checkForUpdate, formatUpdateStatus, nodeVersionFetcher } from './update-check.js';
+import { isLoopbackHost, runDaemon, DEFAULT_DAEMON_HOST, DEFAULT_DAEMON_PORT } from './daemon.js';
+import { ensureDaemonToken } from './registry.js';
+import { errorMessage } from './error-message.js';
+const defaultIO = {
+    out: line => process.stdout.write(line + '\n'),
+    err: line => process.stderr.write(line + '\n'),
+};
+/**
+ * The CLI version, read from the package's own `package.json` at runtime (#312).
+ * The compiled entry lives one level under the package root (`dist/` or
+ * `dist-test/`), so its `package.json` is always `../package.json`. Cached after
+ * the first read; falls back to `unknown` if the file is somehow unreadable.
+ */
+let cachedVersion;
+export function frameworkVersion() {
+    if (cachedVersion !== undefined)
+        return cachedVersion;
+    try {
+        const pkgPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json');
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        // `unknown`, not `0.0.0`: the packages are unreleased and legitimately versioned `0.0.0`, so a
+        // numeric fallback would make a failed read indistinguishable from a correct one (#312).
+        cachedVersion = pkg.version ?? 'unknown';
+    }
+    catch {
+        cachedVersion = 'unknown';
+    }
+    return cachedVersion;
+}
+const HELP = `The Framework — turnkey AI orchestration that wraps a coding agent (Claude Code or Codex).
+
+Usage:
+  openagent              Serve the dashboard in the foreground. Ctrl+C closes it; the server
+                         logs stream to this terminal.
+
+Options:
+  --port <n>             Dashboard port (default: 4200).
+  --host <addr>          Bind address (default: 127.0.0.1, localhost only). A non-loopback
+                         address (e.g. 0.0.0.0) exposes the dashboard to your network and
+                         generates a shared token; the printed URL carries it, and any request
+                         without it gets 401. Exposing a process spawner to the network is a
+                         security decision (#806).
+  -h, --help             Show this help.
+  -v, --version          Print the version.
+
+Everything else is the dashboard: it shows a project's runs from their files, and starts one
+through the project's own start hook (.the-framework/hooks.yml), which names the tool that runs it.`;
+/**
+ * Parse argv (without the node/script prefix). Pure and testable.
+ *
+ * Four options and nothing else: `--host` and `--port` because they are the two things a browser
+ * cannot be asked and a dashboard cannot serve about itself; `--help` and `--version` because a
+ * command with options owes the user both. The command runs no agent (#1774): a run is started
+ * from the dashboard, by the project's own start hook.
+ */
+export function parseArgs(argv) {
+    const opts = { help: false, version: false };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        switch (arg) {
+            case '--help':
+            case '-h':
+                opts.help = true;
+                break;
+            case '--version':
+            case '-v':
+                opts.version = true;
+                break;
+            case '--port': {
+                const n = Number(argv[++i]);
+                if (Number.isInteger(n) && n >= 0)
+                    opts.port = n;
+                else
+                    opts.error = 'invalid --port: must be a non-negative integer';
+                break;
+            }
+            case '--host': {
+                const value = argv[++i];
+                if (value === undefined)
+                    opts.error = 'invalid --host: missing address';
+                else
+                    opts.host = value;
+                break;
+            }
+            default:
+                opts.error = arg.startsWith('-') ? `unknown option: ${arg}` : `unknown command: ${arg}`;
+        }
+    }
+    return opts;
+}
+export async function runCli(argv, io = defaultIO) {
+    const args = parseArgs(argv);
+    if (args.error) {
+        io.err(args.error);
+        io.err('Run `openagent --help` for usage.');
+        return 2;
+    }
+    if (args.help) {
+        io.out(HELP);
+        return 0;
+    }
+    if (args.version) {
+        io.out(frameworkVersion());
+        return 0;
+    }
+    // Everything else is bare `openagent`: serve the dashboard in the foreground until Ctrl-C.
+    return runForegroundDaemonCmd(args, io);
+}
+/**
+ * Bare `framework`: run the dashboard server in the foreground (#456), so its logs and any
+ * server-thrown errors are visible and Ctrl+C stops it. Blocks until the server is signalled
+ * (SIGINT/SIGTERM).
+ */
+async function runForegroundDaemonCmd(args, io) {
+    const cwd = process.cwd();
+    const port = args.port ?? DEFAULT_DAEMON_PORT;
+    const host = args.host;
+    // #1051: pre-generate the shared token for a non-loopback bind so onListening (sync) can print
+    // the reachable URL; runDaemon reuses the same persisted token.
+    const token = host !== undefined && !isLoopbackHost(host) ? await ensureDaemonToken() : undefined;
+    try {
+        await runDaemon(cwd, {
+            port,
+            ...(host !== undefined ? { host } : {}),
+            onListening: state => {
+                io.out(`◆ dashboard running: ${state.url}`);
+                if (!isLoopbackHost(state.host ?? DEFAULT_DAEMON_HOST)) {
+                    printNonLoopbackAccess(io, state.host ?? DEFAULT_DAEMON_HOST, state.url, token);
+                }
+                io.out('  Ctrl+C to stop the dashboard. Server logs stream below.');
+                // #312 asks bare `openagent` to print the commands + version too. onListening is sync and
+                // runDaemon then blocks until signalled, so this is fire-and-forget by necessity: the
+                // update line lands a moment later, above the server logs.
+                void printStartupFooter(io);
+            },
+        });
+    }
+    catch (err) {
+        io.err(`could not start the dashboard (${errorMessage(err)}).`);
+        return 1;
+    }
+    return 0;
+}
+/**
+ * The loud one-line warning and the token-bearing URL printed on any non-loopback daemon bind
+ * (#1051). A daemon that spawns processes is code execution for anyone who reaches the port, and
+ * the shared token is the only guard, so this says so before the daemon is left running. The bound
+ * host is a bind-all like `0.0.0.0`, so the user swaps it for the machine's actual reachable
+ * address (a Tailscale/LAN hostname); the token rides the URL for the first hop, then the cookie.
+ */
+function printNonLoopbackAccess(io, host, url, token) {
+    io.err(`⚠ SECURITY: bound to ${host} (non-loopback). This exposes code execution to your network; the shared token is the only guard (#1051).`);
+    if (!token)
+        return;
+    io.out(`  Open with the token (swap ${host} for this machine's reachable address, e.g. a Tailscale hostname):`);
+    io.out(`    ${url}/?token=${token}`);
+}
+/**
+ * The startup footer every dashboard path prints (#312): where prompts come from, the version,
+ * and then — once npm answers — whether that version is the latest.
+ *
+ * The update line is deliberately not awaited before the static lines. #312 asks for the static
+ * info first, and the foreground path (bare `openagent`) blocks on the server forever, so a line
+ * printed after the await would never appear there at all. `checkForUpdate` is already forgiving:
+ * offline or slow (2.5s cap) resolves to 'unknown', which prints nothing.
+ */
+export function printStartupFooter(io, opts = {}) {
+    const version = frameworkVersion();
+    io.out('');
+    io.out('Type a prompt on the dashboard to start an agent, or use:');
+    io.out('  openagent --help              All options');
+    io.out('');
+    io.out(`The Framework v${version}`);
+    return checkForUpdate(version, opts.fetchLatest ?? nodeVersionFetcher())
+        .then(status => {
+        const line = formatUpdateStatus(status);
+        if (line)
+            io.out(line);
+    })
+        .catch(() => { });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,16 @@
+export { DRIVERS, DRIVER_LABELS, isDriverName, driverFromImpl, type DriverName } from './driver-names.js';
+export { PUBLISH_LABELS, isPublishPick, offeredPublishPicks, publishPickIn, type PublishPick } from './publish-levels.js';
+export { formatFrameworkEvent } from './terminal.js';
+export { formatBytes } from './format-bytes.js';
+export { errorMessage } from './error-message.js';
+export { pickedIds } from './events.js';
+export { sessionInfo, agentErrors, type SessionInfo, type AgentError, } from './agent-view.js';
+export { pendingChoices } from './open-choices.js';
+export { interventionKey, activityKey } from './dashboard/keys.js';
+export { SeenTracker } from './dashboard/keyed-watcher.js';
+export type { ProjectionRead } from './dashboard/projects.js';
+export { NOTIFICATION_DEFAULTS, MAX_SPEND_OFFSET, notifies, browserNotifyEnabled, notifyCategoryEnabled, type NotifyCategory } from './preference-defaults.js';
+export { isLoopbackHost } from './loopback-host.js';
+export { bridgeChoiceRequest } from './dashboard/bridge-question.js';
+export { cloudRunState, cloudRunActive, CLOUD_SESSION_WINDOW_MS, type CloudRunState } from './cloud-run-state.js';
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACzG,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACzH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EACL,WAAW,EACX,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGlD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAIlE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC1D,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAI9J,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AAEpE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,uBAAuB,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/client.js

@@ -0,0 +1,30 @@
+// Browser-safe entry for the dashboard client (#431). Only pure event projections live
+// here — `formatFrameworkEvent` and the run-view derivations — with no Node imports, so
+// the client can import these at runtime without dragging the server barrel (relay,
+// sandbox, node:fs/http, …) into the browser bundle. Types come from the root entry.
+export { DRIVERS, DRIVER_LABELS, isDriverName, driverFromImpl } from './driver-names.js';
+export { PUBLISH_LABELS, isPublishPick, offeredPublishPicks, publishPickIn } from './publish-levels.js';
+export { formatFrameworkEvent } from './terminal.js';
+export { formatBytes } from './format-bytes.js';
+export { errorMessage } from './error-message.js';
+export { pickedIds } from './events.js';
+export { sessionInfo, agentErrors, } from './agent-view.js';
+// Which questions a run still waits on: one rule for the run page and the daemon's own reads.
+export { pendingChoices } from './open-choices.js';
+// The identity of a notification feed's item (#627). Pure, so the dashboard shares it with the
+// item types rather than keeping a copy that drifts silently.
+export { interventionKey, activityKey } from './dashboard/keys.js';
+// The baseline half of the same engine (#1625): what counts as "already there" when a feed is first
+// seen. The dashboard used to decide that by counting observations, which made a page loaded with no
+// git host reach take an empty backlog for a real one. Pure, and its only import is a type.
+export { SeenTracker } from './dashboard/keyed-watcher.js';
+export { NOTIFICATION_DEFAULTS, MAX_SPEND_OFFSET, notifies, browserNotifyEnabled, notifyCategoryEnabled } from './preference-defaults.js';
+// Whether an address is truly local (#1051). The daemon decides the token gate with it and the
+// dashboard labels the connection with it, so they must agree on what "local" means — the browser
+// kept its own looser copy, which answered `false` for every 127.0.0.0/8 address but the first.
+export { isLoopbackHost } from './loopback-host.js';
+// A bridged question as the gate panel renders it (#1554): pure, so the client projects it itself.
+export { bridgeChoiceRequest } from './dashboard/bridge-question.js';
+// What a web run's cloud side is doing, from its record (#1668): pure, so every surface derives the same word.
+export { cloudRunState, cloudRunActive, CLOUD_SESSION_WINDOW_MS } from './cloud-run-state.js';
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,wFAAwF;AACxF,oFAAoF;AACpF,qFAAqF;AACrF,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAmB,MAAM,mBAAmB,CAAA;AACzG,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,aAAa,EAAoB,MAAM,qBAAqB,CAAA;AACzH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EACL,WAAW,EACX,WAAW,GAGZ,MAAM,iBAAiB,CAAA;AACxB,8FAA8F;AAC9F,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,+FAA+F;AAC/F,8DAA8D;AAC9D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAClE,oGAAoG;AACpG,qGAAqG;AACrG,4FAA4F;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAE1D,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,qBAAqB,EAAuB,MAAM,0BAA0B,CAAA;AAC9J,+FAA+F;AAC/F,kGAAkG;AAClG,gGAAgG;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,mGAAmG;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AACpE,+GAA+G;AAC/G,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,uBAAuB,EAAsB,MAAM,sBAAsB,CAAA"}

package/dist/closing-keywords.d.ts

@@ -0,0 +1,28 @@
+/**
+ * GitHub's issue-closing grammar, and how to defuse it (#1567).
+ *
+ * A pull request whose body says `close #1164` closes that issue the moment the PR merges.
+ * That is the wanted behaviour when the PR completes the issue — the handoff puts `(fix #42)`
+ * on the title of an implementing agent's PR for exactly that reason (#1334). It is the wrong
+ * behaviour when the PR delivers something short of the work: a plan agent's PR lands a plan
+ * whose own text says the implementation is still to come, and a sentence like "…then close
+ * #1164" reads perfectly sensibly to the human reviewing it while quietly closing the ticket.
+ *
+ * That happened (#1560 closed #1164, and the next tickets sync then deleted the ticket and its
+ * fresh plan). The cure is not to forbid the phrase — the agent is describing its plan, and the
+ * sentence is true — but to break the adjacency GitHub's parser needs. The keyword only counts
+ * when the reference follows it directly, so two words in between end its authority while the
+ * sentence keeps saying what it said.
+ */
+/**
+ * Rewrite every closing phrase in `text` so GitHub stops reading it as a command, leaving the
+ * issue reference itself untouched: `close #1164` becomes `close the ticket #1164`.
+ *
+ * The reference stays live — clickable, and still cross-referenced onto the issue's own timeline,
+ * so the ticket is told a pull request mentioned it. Only the closing authority is removed.
+ *
+ * Idempotent by construction: after the rewrite the keyword is followed by the filler rather than
+ * by a reference, so a second pass finds nothing to change.
+ */
+export declare function defuseClosingKeywords(text: string): string;
+//# sourceMappingURL=closing-keywords.d.ts.map

package/dist/closing-keywords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"closing-keywords.d.ts","sourceRoot":"","sources":["../src/closing-keywords.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA2BH;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK1D"}

package/dist/closing-keywords.js

@@ -0,0 +1,49 @@
+/**
+ * GitHub's issue-closing grammar, and how to defuse it (#1567).
+ *
+ * A pull request whose body says `close #1164` closes that issue the moment the PR merges.
+ * That is the wanted behaviour when the PR completes the issue — the handoff puts `(fix #42)`
+ * on the title of an implementing agent's PR for exactly that reason (#1334). It is the wrong
+ * behaviour when the PR delivers something short of the work: a plan agent's PR lands a plan
+ * whose own text says the implementation is still to come, and a sentence like "…then close
+ * #1164" reads perfectly sensibly to the human reviewing it while quietly closing the ticket.
+ *
+ * That happened (#1560 closed #1164, and the next tickets sync then deleted the ticket and its
+ * fresh plan). The cure is not to forbid the phrase — the agent is describing its plan, and the
+ * sentence is true — but to break the adjacency GitHub's parser needs. The keyword only counts
+ * when the reference follows it directly, so two words in between end its authority while the
+ * sentence keeps saying what it said.
+ */
+/**
+ * The keywords GitHub accepts before an issue reference, per its "linking a pull request to an
+ * issue" documentation. Matched case-insensitively; every listed form (and its plural/past
+ * tense) is a live trigger.
+ */
+const CLOSING_KEYWORDS = ['close', 'closes', 'closed', 'fix', 'fixes', 'fixed', 'resolve', 'resolves', 'resolved'];
+/**
+ * What goes between the keyword and the reference. Chosen to read as the sentence's own words
+ * rather than as an escape: "…then close the ticket #1164" is what the agent meant anyway.
+ */
+const FILLER = 'the ticket';
+/**
+ * A closing keyword, the gap GitHub allows after it, then an issue reference — `#123`, or the
+ * cross-repo `owner/repo#123` form, which closes just as well. The gap is whitespace or a colon
+ * ("The keywords can be followed by colons... `Closes: #10`", per the same documentation), and it
+ * is re-emitted verbatim so the sentence keeps its own punctuation. A reference already inside
+ * backticks is left alone: GitHub does not act on one, and rewriting it would corrupt a code sample.
+ */
+const CLOSING_PHRASE = new RegExp(String.raw `(^|[^\`\w])(${CLOSING_KEYWORDS.join('|')})(\s*:\s*|\s+)((?:[\w.-]+\/[\w.-]+)?#\d+)(?!\`)`, 'gi');
+/**
+ * Rewrite every closing phrase in `text` so GitHub stops reading it as a command, leaving the
+ * issue reference itself untouched: `close #1164` becomes `close the ticket #1164`.
+ *
+ * The reference stays live — clickable, and still cross-referenced onto the issue's own timeline,
+ * so the ticket is told a pull request mentioned it. Only the closing authority is removed.
+ *
+ * Idempotent by construction: after the rewrite the keyword is followed by the filler rather than
+ * by a reference, so a second pass finds nothing to change.
+ */
+export function defuseClosingKeywords(text) {
+    return text.replace(CLOSING_PHRASE, (_all, before, keyword, gap, ref) => `${before}${keyword}${gap}${FILLER} ${ref}`);
+}
+//# sourceMappingURL=closing-keywords.js.map

package/dist/closing-keywords.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"closing-keywords.js","sourceRoot":"","sources":["../src/closing-keywords.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAA;AAElH;;;GAGG;AACH,MAAM,MAAM,GAAG,YAAY,CAAA;AAE3B;;;;;;GAMG;AACH,MAAM,cAAc,GAAG,IAAI,MAAM,CAC/B,MAAM,CAAC,GAAG,CAAA,eAAe,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,iDAAiD,EACpG,IAAI,CACL,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,IAAI,CAAC,OAAO,CACjB,cAAc,EACd,CAAC,IAAI,EAAE,MAAc,EAAE,OAAe,EAAE,GAAW,EAAE,GAAW,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,OAAO,GAAG,GAAG,GAAG,MAAM,IAAI,GAAG,EAAE,CACjH,CAAA;AACH,CAAC"}

package/dist/cloud-run-state.d.ts

@@ -0,0 +1,27 @@
+import type { AgentMeta } from './store/agent-store.js';
+/**
+ * How long after its start a run's cloud session is still assumed to be alive. The same window
+ * the browser bridge watches a session for (`bridge-sessions`): past it nothing could learn the
+ * session is parked, so "in cloud" would be a guess nobody can correct — hence "done".
+ */
+export declare const CLOUD_SESSION_WINDOW_MS: number;
+/**
+ * What the cloud side of a web run is doing.
+ *
+ * - `waiting`: the browser bridge holds a question the session is parked on
+ * - `merged`: the session's work was adopted (#1601) and its pull request merged by the framework
+ * - `in-cloud`: no pull request yet and the run is inside the session window, so it may still be working
+ * - `done`: its pull request exists — the work landed, and the PR badge carries its live state — or the
+ *   window passed with nothing adopted: the session finished or never pushed
+ */
+export type CloudRunState = 'waiting' | 'merged' | 'in-cloud' | 'done';
+/** The fields of a run's record the projection reads. */
+export type CloudRunFacts = Pick<AgentMeta, 'target' | 'status' | 'startedAt' | 'pr' | 'mergeOutcome' | 'cloudWaiting'>;
+/**
+ * The cloud state of a web run whose local half is over, or undefined for any other run — a
+ * local run, or a web run still handing off, stopped or failed — whose stored status is the word.
+ */
+export declare function cloudRunState(meta: CloudRunFacts, now: number): CloudRunState | undefined;
+/** Whether the cloud side still counts as an agent at work: in its session, or waiting on a human. */
+export declare function cloudRunActive(state: CloudRunState | undefined): boolean;
+//# sourceMappingURL=cloud-run-state.d.ts.map