@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/data-branch.js

@@ -0,0 +1,319 @@
+import { dirname, join } from 'node:path';
+import { BRANCHES_DIR, nodeGitRunner, excludeFromGit } from '@gemstack/skill-branches';
+import { DATA_BRANCH, DATA_CHECKOUT_DIR } from './framework-dir.js';
+import { TICKETS_DIR, FLAT_TODO_FILE } from './tickets.js';
+import { errorMessage } from './error-message.js';
+export { DATA_BRANCH };
+// The `agents-data` branch (#1582): every file The Framework itself writes — the tickets,
+// the queue, the session archives — lives on one branch of the project repo, the way `gh-pages`
+// holds a site's data. Main is 100% code, 0% framework data.
+//
+// What this buys, structurally: the branch is safe to push and pull *eagerly*, because nothing on
+// it is anyone's working tree. That closes #1577 (an agent's stale queue copy clobbering the
+// freshly-merged one — there is one queue, on one branch, with one local writer) and #1397 (run
+// bookkeeping stranded on local main — data commits land on a branch whose whole job is to be
+// pushed), and it gives every machine and cloud session the same view: fetch the branch, read the
+// files, commit onto it, push.
+//
+// The daemon is the single LOCAL committer. Every local write funnels through
+// {@link withDataBranch}, which serializes per project and runs the whole cycle — sync, apply,
+// commit, push — so two ticks can never interleave half-written queue states. A data-writing
+// *session* (triage, sync) is a remote writer like another machine: it commits onto this branch in
+// its own checkout and pushes, and the race is settled by the push itself — whoever loses re-syncs
+// and re-applies.
+//
+// The checkout is a plain git worktree at {@link DATA_CHECKOUT_DIR}, under `.branches/` beside
+// the agent checkouts. The repo root keeps a `tickets` symlink into it so the roadmap stays one
+// `ls` away for humans.
+/** The data branch's checkout under a project. */
+export function dataWorktreePath(cwd) {
+    return join(cwd, DATA_CHECKOUT_DIR);
+}
+/**
+ * git's well-known empty tree, present in every repository without being written first. Committing
+ * it is how the branch is born parentless with no working-tree gymnastics: `git commit-tree` +
+ * `git branch` never touches any checkout, and no code commit is ever an ancestor of the data
+ * history.
+ */
+const EMPTY_TREE = '4b825dc642cb6eb9a060e54bf8d69288fbee4904';
+function resolveDeps(deps) {
+    const fs = () => import('node:fs/promises');
+    return {
+        git: deps.git ?? nodeGitRunner(),
+        write: deps.write ??
+            (async (path, content) => {
+                const f = await fs();
+                await f.mkdir(dirname(path), { recursive: true });
+                await f.writeFile(path, content, 'utf8');
+            }),
+        lexists: deps.lexists ?? (path => fs().then(f => f.lstat(path)).then(() => true, () => false)),
+        symlink: deps.symlink ?? ((target, path) => fs().then(f => f.symlink(target, path))),
+        log: deps.log ?? (() => { }),
+    };
+}
+/** Whether the repo has any remote to sync the branch with. No remote is a local-only project, fine. */
+async function hasRemote(cwd, git) {
+    try {
+        return (await git(['remote'], cwd)).trim().length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/** Whether a ref exists locally. */
+async function refExists(cwd, ref, git) {
+    return git(['rev-parse', '--verify', '--quiet', ref], cwd).then(() => true, () => false);
+}
+/**
+ * One serialized cycle per project, so a writer and the eager pull can never interleave: the
+ * promise chain is the lock, and every public entry point below joins it.
+ */
+const chains = new Map();
+function serialize(cwd, task) {
+    const next = (chains.get(cwd) ?? Promise.resolve()).then(task, task);
+    chains.set(cwd, next.catch(() => { }));
+    return next;
+}
+/**
+ * The unserialized ensure: branch, checkout, seed, symlink. Split from {@link ensureDataWorktree}
+ * so the writer and the pull can run it inside the cycle they already hold the chain for.
+ */
+async function ensureCore(cwd, r) {
+    const path = dataWorktreePath(cwd);
+    // Already checked out on the right branch: done. The common case, taken on every tick.
+    const onBranch = await r.git(['rev-parse', '--abbrev-ref', 'HEAD'], path).then(out => out.trim() === DATA_BRANCH, () => false);
+    if (!onBranch) {
+        if (!(await refExists(cwd, `refs/heads/${DATA_BRANCH}`, r.git))) {
+            // Take origin's branch when there is one (the every-other-machine case); otherwise the
+            // branch is born here, parentless.
+            if (await hasRemote(cwd, r.git))
+                await r.git(['fetch', 'origin', DATA_BRANCH], cwd).catch(() => { });
+            if (await refExists(cwd, `refs/remotes/origin/${DATA_BRANCH}`, r.git)) {
+                await r.git(['branch', DATA_BRANCH, `origin/${DATA_BRANCH}`], cwd);
+            }
+            else {
+                const commit = (await r.git(['commit-tree', EMPTY_TREE, '-m', `[The Framework] ${DATA_BRANCH}`], cwd)).trim();
+                await r.git(['branch', DATA_BRANCH, commit], cwd);
+            }
+        }
+        // A stale registration at this path (the dir was deleted by hand) blocks the add.
+        await r.git(['worktree', 'prune'], cwd).catch(() => { });
+        await r.git(['worktree', 'add', path, DATA_BRANCH], cwd);
+        // The checkout sits under `.branches/` like the agent checkouts, and is hidden the same way
+        // (git's own exclude, no tracked file) — this may be the first checkout the project gets.
+        await excludeFromGit(cwd, '/' + BRANCHES_DIR, undefined, r.git).catch(() => { });
+    }
+    // Seed the queue on a branch born empty, so readers and humans find the file, not a mystery.
+    // Committed here, so the checkout is clean between cycles and no later write's message lies
+    // about carrying the seed; the push is owed like any local commit and rides the next cycle.
+    if (!(await r.lexists(join(path, FLAT_TODO_FILE)))) {
+        await r.write(join(path, FLAT_TODO_FILE), '');
+        await r.git(['add', '-A'], path);
+        await r.git(['commit', '-m', '[The Framework] seed the queue'], path);
+    }
+    // The roadmap stays one `ls` away: `<repo>/tickets` links into the data checkout. Created only
+    // over nothing — a real `tickets/` dir (pre-migration) or a user's own file is theirs. The link
+    // is framework state, so it is hidden from git the moment it is made: uncommitted at the root,
+    // it would ride any sweeping `git add -A` onto a code branch. The exclude is a pair because the
+    // repo-level exclude speaks for every worktree at once — this checkout included, whose root
+    // holds the real `tickets/` the branch exists to carry: `/tickets` hides root entries of that
+    // name, and `!/tickets/` re-includes directories (a trailing slash never matches a symlink), so
+    // the link stays hidden while the data checkout's own directory keeps committing.
+    const rootLink = join(cwd, TICKETS_DIR);
+    if (!(await r.lexists(rootLink))) {
+        await r.symlink(join(DATA_CHECKOUT_DIR, TICKETS_DIR), rootLink).catch(() => { });
+        await excludeFromGit(cwd, '/' + TICKETS_DIR, undefined, r.git).catch(() => { });
+        await excludeFromGit(cwd, '!/' + TICKETS_DIR + '/', undefined, r.git).catch(() => { });
+    }
+}
+/**
+ * Bring the checkout up to date with origin: fetch, then rebase whatever local commits exist (a
+ * push that could not land earlier) onto origin's tip. A conflict resolves toward origin — the
+ * writer re-applies the local intent afterwards, which is the "re-run on conflict" rule the whole
+ * cycle is built on.
+ */
+async function syncCore(cwd, r) {
+    if (!(await hasRemote(cwd, r.git)))
+        return;
+    const path = dataWorktreePath(cwd);
+    await r.git(['fetch', 'origin', DATA_BRANCH], cwd).catch(() => { });
+    if (!(await refExists(cwd, `refs/remotes/origin/${DATA_BRANCH}`, r.git)))
+        return;
+    try {
+        await r.git(['rebase', `origin/${DATA_BRANCH}`], path);
+    }
+    catch {
+        await r.git(['rebase', '--abort'], path).catch(() => { });
+        await r.git(['reset', '--hard', `origin/${DATA_BRANCH}`], path);
+    }
+}
+/**
+ * Make sure the data branch and its checkout exist, the queue file is seeded, and the root
+ * `tickets` symlink points into the checkout. Idempotent and cheap when everything is in place
+ * (one `git rev-parse` against the checkout); never throws — a project this cannot be set up in
+ * reports why and is left alone.
+ */
+export async function ensureDataWorktree(cwd, deps = {}) {
+    const r = resolveDeps(deps);
+    return serialize(cwd, async () => {
+        try {
+            await ensureCore(cwd, r);
+            return { ok: true };
+        }
+        catch (err) {
+            return { ok: false, error: errorMessage(err) };
+        }
+    });
+}
+/**
+ * Apply one change to the data branch: sync with origin, run `op` against the checkout, commit
+ * whatever it changed, push. The single funnel every local data write goes through (#1582).
+ *
+ * `op` must be re-runnable: when the push loses a race with another machine, the cycle re-syncs
+ * and runs it again against the fresher state rather than force-fitting a stale commit — the op
+ * *is* the intent, the commit is just its serialization. Two attempts; a push that still fails
+ * (the network, most likely) keeps the commit local and reports the error — the next cycle's sync
+ * rebases it onto whatever origin has by then, and the next push carries it.
+ *
+ * Never throws: callers run on background ticks with nothing to catch it.
+ */
+export async function withDataBranch(cwd, message, op, deps = {}) {
+    const r = resolveDeps(deps);
+    const path = dataWorktreePath(cwd);
+    return serialize(cwd, async () => {
+        try {
+            await ensureCore(cwd, r);
+            const remote = await hasRemote(cwd, r.git);
+            for (let attempt = 0;; attempt++) {
+                await syncCore(cwd, r);
+                await op(path);
+                await r.git(['add', '-A'], path);
+                const staged = (await r.git(['status', '--porcelain'], path)).trim();
+                // The message is resolved after the op ran: a batch write only knows what it did then.
+                if (staged)
+                    await r.git(['commit', '-m', typeof message === 'function' ? message() : message], path);
+                if (!remote)
+                    return { ok: true, changed: Boolean(staged), pushed: false };
+                // Unpushed commits — this cycle's, or an earlier cycle's that the sync just rebased. The
+                // push is owed whenever any exist, even when this op itself wrote nothing new.
+                const ahead = (await refExists(cwd, `refs/remotes/origin/${DATA_BRANCH}`, r.git))
+                    ? (await r.git(['rev-list', '--count', `origin/${DATA_BRANCH}..${DATA_BRANCH}`], cwd)).trim() !== '0'
+                    : true;
+                if (!ahead)
+                    return { ok: true, changed: false, pushed: false };
+                try {
+                    await r.git(['push', 'origin', `${DATA_BRANCH}:${DATA_BRANCH}`], path);
+                    return { ok: true, changed: Boolean(staged), pushed: true };
+                }
+                catch (err) {
+                    if (attempt >= 1)
+                        return { ok: false, committed: true, error: `the data branch could not be pushed: ${errorMessage(err)}` };
+                }
+            }
+        }
+        catch (err) {
+            // The op's half-written files must not ride a later, unrelated commit: put the checkout
+            // back to its committed state before reporting.
+            await r.git(['reset', '--hard'], path).catch(() => { });
+            await r.git(['clean', '-fd'], path).catch(() => { });
+            return { ok: false, committed: false, error: errorMessage(err) };
+        }
+    });
+}
+/**
+ * Fill in whatever a caller left out, so an operation reads the same way in tests and out. Parents
+ * are created on write because the directory itself is not a given: retiring the last file removes
+ * it (git keeps no empty dirs), and the branch is born without it.
+ */
+export function resolveDataFileDeps(deps) {
+    const fs = () => import('node:fs/promises');
+    return {
+        read: deps.read ?? (path => fs().then(f => f.readFile(path, 'utf8'))),
+        write: deps.write ??
+            (async (path, content) => {
+                const f = await fs();
+                await f.mkdir(dirname(path), { recursive: true });
+                await f.writeFile(path, content, 'utf8');
+            }),
+        remove: deps.remove ?? (path => fs().then(f => f.rm(path))),
+        list: deps.list ?? (dir => fs().then(f => f.readdir(dir)).catch(() => [])),
+        funnel: deps.funnel ?? withDataBranch,
+        log: deps.log ?? (() => { }),
+    };
+}
+/**
+ * The eager pull (#1582): sync the checkout with origin so this machine reads what other machines
+ * and cloud sessions committed, without waiting for the next local write — and push anything a
+ * failed cycle left stranded locally, via the same owed-push rule as the writer. Ensures the
+ * checkout exists, so a fresh clone converges on its first tick. Never throws.
+ *
+ * Reports why it could not converge (#1599): a push origin rejects, or no origin to converge with
+ * at all. The writer treats a remote-less repo as fine — the commit is safe locally — but a sync's
+ * whole job is to meet the other machines, and a repo nothing can reach is an error state the user
+ * has to fix, not a mode the framework supports (#1595). The daemon records the answer as the
+ * project's error state, so it reaches the dashboard rather than only the daemon's stdout.
+ */
+export async function pullDataBranch(cwd, deps = {}) {
+    const r = resolveDeps(deps);
+    const result = await withDataBranch(cwd, '[The Framework] data sync', async () => { }, deps);
+    const outcome = !result.ok
+        ? { ok: false, error: result.error }
+        : (await hasRemote(cwd, r.git))
+            ? { ok: true }
+            : { ok: false, error: 'the repository has no remote, so the data branch cannot be shared with other machines' };
+    if (!outcome.ok)
+        r.log(`[framework] data branch sync: ${outcome.error}`);
+    return outcome;
+}
+/**
+ * The project root `cwd` belongs to: the directory holding the repo's real `.git`. From the main
+ * checkout that is `cwd` itself; from an agent's worktree it is the repo the worktree was made
+ * from — where the data checkout lives, and the address every data write funnels to. `undefined`
+ * outside any repo.
+ */
+export async function dataProjectRoot(cwd, git = nodeGitRunner()) {
+    try {
+        const gitDir = (await git(['rev-parse', '--path-format=absolute', '--git-common-dir'], cwd)).trim();
+        return gitDir ? dirname(gitDir) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Read one file off the data branch, from anywhere in the repo: the checkout when this `cwd` has
+ * one, else `git show` against the local branch (worktrees share the repo's refs, so an agent's
+ * checkout reads the same data without holding any of it), else against `origin/…` (a fresh
+ * clone that fetched but never branched — the cloud case). `undefined` when the file exists in
+ * none of them. Never throws.
+ *
+ * `fresh: true` fetches first and prefers origin's copy — for a reader about to act on the queue
+ * from a long-lived agent process, where the local ref may trail what other writers pushed.
+ */
+export async function readDataFile(cwd, rel, opts = {}, deps = {}) {
+    const r = resolveDeps(deps);
+    const remote = opts.fresh && (await hasRemote(cwd, r.git));
+    if (remote)
+        await r.git(['fetch', 'origin', DATA_BRANCH], cwd).catch(() => { });
+    const sources = [
+        ...(remote ? [`origin/${DATA_BRANCH}`] : []),
+        DATA_BRANCH,
+        ...(remote ? [] : [`origin/${DATA_BRANCH}`]),
+    ];
+    if (!opts.fresh) {
+        const fromCheckout = await r.git(['rev-parse', '--abbrev-ref', 'HEAD'], dataWorktreePath(cwd)).then(out => out.trim() === DATA_BRANCH, () => false);
+        if (fromCheckout) {
+            const { readFile } = await import('node:fs/promises');
+            const md = await readFile(join(dataWorktreePath(cwd), rel), 'utf8').catch(() => undefined);
+            if (md !== undefined)
+                return md;
+        }
+    }
+    for (const ref of sources) {
+        const md = await r.git(['show', `${ref}:${rel}`], cwd).catch(() => undefined);
+        if (md !== undefined)
+            return md;
+    }
+    return undefined;
+}
+//# sourceMappingURL=data-branch.js.map

package/dist/data-branch.js.map

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

package/dist/discord/bot.d.ts

@@ -0,0 +1,61 @@
+import { type DiscordMessage, type GatewayDeps } from './gateway.js';
+import { type ProjectTarget, type RunSnapshot } from './routing.js';
+/**
+ * The Discord chatbot (#680): chat to The Framework from Discord instead of the dashboard.
+ *
+ * Every effect is an injected function, so the whole bot is testable by handing it a fake
+ * message — the routing decisions live in `routing.ts` and are pure, and this module is only
+ * the wiring. Same seam-and-`stop()` shape as the intervention/activity watchers.
+ *
+ * Chat history is not written here: a message routed into a run reaches that run's conversation
+ * through the control channel, and the run commits it to `.the-framework/conversations/` (#908).
+ * That is the answer to the question #680 asked — the Git repo, via the run that received it.
+ */
+/**
+ * How a turn that arrived here is attributed in the committed conversation (#917). Named once,
+ * here, so the surface owns its own name rather than the daemon spelling it inline twice.
+ */
+export declare const DISCORD_VIA = "discord";
+/** Everything the bot needs from the daemon. */
+export interface DiscordBotOptions {
+    /** The bot token. Distinct from the notification webhook (#627), which cannot read replies. */
+    token: string;
+    /** The project a message belongs to when no run is live. */
+    target: () => Promise<ProjectTarget | undefined>;
+    /** That project's live run, if it has one. */
+    liveRun: (projectId: string) => Promise<RunSnapshot | undefined>;
+    /** Start a new run; resolves the run id, or `undefined` when it could not start. */
+    start: (projectId: string, text: string) => Promise<string | undefined>;
+    sendMessage: (projectId: string, text: string, runId: string) => Promise<void>;
+    sendChoice: (projectId: string, gateId: string, pick: string | string[], runId: string) => Promise<void>;
+    sendStop: (projectId: string, runId: string) => Promise<void>;
+    /**
+     * Bind a run to the channel this message came from (#932), so the session's answers are posted
+     * back where it was asked. Awaited *before* the run is handed the message: binding first is what
+     * makes the reply reliably count as new rather than being baselined away.
+     */
+    onRunBound?: (runId: string, channelId: string) => Promise<void>;
+    /**
+     * Whether the bot should act, read per message rather than at start, so turning it off takes
+     * effect without restarting the daemon — the same contract the notification watchers follow.
+     */
+    enabled?: () => Promise<boolean>;
+    /** Restrict the bot to one channel. Unset means it answers wherever it is addressed. */
+    channelId?: string | undefined;
+    fetchImpl?: typeof fetch;
+    onLog?: (message: string) => void;
+    /** Gateway seams, for tests. */
+    gateway?: GatewayDeps;
+}
+/** A running bot. `stop()` is what takes it offline on `Ctrl+C`. */
+export interface DiscordBot {
+    stop(): void;
+    /** Handle one message. Exposed so tests drive a cycle without a socket, like the watchers' `poll()`. */
+    handleMessage(message: DiscordMessage): Promise<void>;
+}
+/**
+ * Connect the bot and route messages. Never throws: a chat integration that can take the daemon
+ * down is worse than one that is quiet.
+ */
+export declare function startDiscordBot(opts: DiscordBotOptions): DiscordBot;
+//# sourceMappingURL=bot.d.ts.map

package/dist/discord/bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../src/discord/bot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAEpF,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAGjF;;;;;;;;;;GAUG;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW,YAAY,CAAA;AAEpC,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,+FAA+F;IAC/F,KAAK,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,MAAM,EAAE,MAAM,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAA;IAChD,8CAA8C;IAC9C,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAA;IAChE,oFAAoF;IACpF,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACvE,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9E,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxG,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7D;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAChC,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,gCAAgC;IAChC,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB;AAED,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,IAAI,IAAI,IAAI,CAAA;IACZ,wGAAwG;IACxG,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACtD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU,CA0EnE"}

package/dist/discord/bot.js

@@ -0,0 +1,94 @@
+import { DiscordGateway } from './gateway.js';
+import { postMessage } from './rest.js';
+import { decideAction } from './routing.js';
+import { errorMessage } from '../error-message.js';
+/**
+ * The Discord chatbot (#680): chat to The Framework from Discord instead of the dashboard.
+ *
+ * Every effect is an injected function, so the whole bot is testable by handing it a fake
+ * message — the routing decisions live in `routing.ts` and are pure, and this module is only
+ * the wiring. Same seam-and-`stop()` shape as the intervention/activity watchers.
+ *
+ * Chat history is not written here: a message routed into a run reaches that run's conversation
+ * through the control channel, and the run commits it to `.the-framework/conversations/` (#908).
+ * That is the answer to the question #680 asked — the Git repo, via the run that received it.
+ */
+/**
+ * How a turn that arrived here is attributed in the committed conversation (#917). Named once,
+ * here, so the surface owns its own name rather than the daemon spelling it inline twice.
+ */
+export const DISCORD_VIA = 'discord';
+/**
+ * Connect the bot and route messages. Never throws: a chat integration that can take the daemon
+ * down is worse than one that is quiet.
+ */
+export function startDiscordBot(opts) {
+    const log = (message) => opts.onLog?.(message);
+    const handleMessage = async (message) => {
+        try {
+            if (opts.channelId && message.channelId !== opts.channelId)
+                return;
+            if (opts.enabled && !(await opts.enabled()))
+                return;
+            const target = await opts.target();
+            if (!target) {
+                await reply(message, 'No project is registered with The Framework yet.');
+                return;
+            }
+            const live = await opts.liveRun(target.id).catch(() => undefined);
+            const action = decideAction(message.content, { live, target });
+            switch (action.kind) {
+                case 'choice':
+                    await opts.sendChoice(action.projectId, action.gateId, action.pick, action.runId);
+                    break;
+                case 'message':
+                    // Bind before sending (#932): the answer to this message must land after the baseline.
+                    await opts.onRunBound?.(action.runId, message.channelId).catch(() => { });
+                    await opts.sendMessage(action.projectId, action.text, action.runId);
+                    break;
+                case 'stop':
+                    await opts.sendStop(action.projectId, action.runId);
+                    break;
+                case 'start': {
+                    const runId = await opts.start(action.projectId, action.text);
+                    if (!runId) {
+                        await reply(message, 'Could not start a session. It may already be busy.');
+                        return;
+                    }
+                    // A run that did not exist a moment ago has nothing to adopt, so binding after the start
+                    // is still a clean baseline, and it is the first point its id is known.
+                    await opts.onRunBound?.(runId, message.channelId).catch(() => { });
+                    break;
+                }
+                case 'reply':
+                    break;
+            }
+            await reply(message, action.reply);
+        }
+        catch (err) {
+            log(`Discord bot could not handle a message: ${errorMessage(err)}`);
+        }
+    };
+    const reply = async (to, content) => {
+        const sent = await postMessage(opts.token, to.channelId, content, {
+            replyToId: to.id,
+            ...(opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}),
+        });
+        if (!sent)
+            log('Discord bot could not post a reply');
+    };
+    const gateway = new DiscordGateway(opts.token, {
+        onMessage: message => void handleMessage(message),
+        onReady: id => log(`Discord bot online (${id})`),
+        onLog: log,
+    }, opts.gateway ?? {});
+    gateway.connect();
+    return {
+        stop: () => {
+            gateway.stop();
+            log('Discord bot offline');
+        },
+        handleMessage,
+    };
+}
+//# sourceMappingURL=bot.js.map

package/dist/discord/bot.js.map

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

package/dist/discord/gateway.d.ts

@@ -0,0 +1,137 @@
+/**
+ * A minimal Discord gateway client (#680): the inbound half of the Discord integration, which
+ * until now was outbound-only — a webhook `POST` can notify, but it cannot read a reply (#627).
+ *
+ * Deliberately hand-rolled over the global `WebSocket` rather than pulling in `discord.js`. The
+ * package has three runtime dependencies and builds everything else on node builtins behind
+ * injectable seams; a client library for the handful of opcodes below would be the largest
+ * dependency in the package by an order of magnitude.
+ *
+ * Implements only what a chat bot needs: identify, heartbeat, resume, and message events.
+ */
+/** Gateway opcodes we act on. */
+export declare const OP: {
+    readonly dispatch: 0;
+    readonly heartbeat: 1;
+    readonly identify: 2;
+    readonly resume: 6;
+    readonly reconnect: 7;
+    readonly invalidSession: 9;
+    readonly hello: 10;
+    readonly heartbeatAck: 11;
+};
+/**
+ * Gateway intents. `MESSAGE_CONTENT` is privileged: it must be enabled on the application in
+ * Discord's developer portal, or the gateway connects and every message arrives with an empty
+ * `content`. That failure is silent, which is why {@link DiscordGateway} logs it explicitly.
+ */
+export declare const INTENTS: {
+    readonly guildMessages: number;
+    readonly directMessages: number;
+    readonly messageContent: number;
+};
+/** The intents a chat bot needs: messages in channels and DMs, plus their text. */
+export declare const CHAT_INTENTS: number;
+/**
+ * The socket seam. Mirrors the slice of `WebSocket` this uses, so a test drives the protocol
+ * with a fake and no network — the same shape the watchers use for `fetch`.
+ */
+export interface GatewaySocket {
+    send(data: string): void;
+    close(): void;
+    onMessage(handler: (data: string) => void): void;
+    onClose(handler: () => void): void;
+    onError(handler: (err: unknown) => void): void;
+}
+/** Opens a {@link GatewaySocket} for a url. */
+export type SocketFactory = (url: string) => GatewaySocket;
+/** A cancellable timer, so heartbeats are deterministic under test. */
+export interface Timer {
+    stop(): void;
+}
+/** Schedules `fn` every `ms`. Default wraps `setInterval` and unrefs it. */
+export type IntervalFactory = (fn: () => void, ms: number) => Timer;
+/** Schedules `fn` once after `ms`. Default wraps `setTimeout` and unrefs it. */
+export type DelayFactory = (fn: () => void, ms: number) => Timer;
+/** One inbound chat message, narrowed to what routing needs. */
+export interface DiscordMessage {
+    id: string;
+    channelId: string;
+    /** Message text. Empty when the privileged MESSAGE_CONTENT intent is not enabled. */
+    content: string;
+    authorId: string;
+    authorName: string;
+    /** Whether the author is a bot (including us): never act on these, or two bots loop forever. */
+    fromBot: boolean;
+    /** Set when the message replies to another, used to thread an answer back to its gate. */
+    replyToId?: string;
+}
+/** What {@link DiscordGateway} reports to its owner. */
+export interface GatewayHandlers {
+    onMessage(message: DiscordMessage): void;
+    /** Connected and identified; carries our own user id so we can ignore our own messages. */
+    onReady?(selfId: string): void;
+    /** Non-fatal diagnostics (a failed resume, a missing intent). */
+    onLog?(message: string): void;
+}
+/** Injectable seams for {@link DiscordGateway}. */
+export interface GatewayDeps {
+    socket?: SocketFactory;
+    interval?: IntervalFactory;
+    delay?: DelayFactory;
+    url?: string;
+}
+/**
+ * A connected Discord bot session. Owns the socket, the heartbeat, and the resume state; hands
+ * every chat message to its {@link GatewayHandlers}.
+ *
+ * Errors are swallowed into `onLog` rather than thrown: a notifier must never take the daemon
+ * down, which is the same contract the intervention/activity watchers follow.
+ */
+export declare class DiscordGateway {
+    private readonly token;
+    private readonly handlers;
+    private readonly deps;
+    private socket;
+    private heartbeat;
+    private sequence;
+    private sessionId;
+    private resumeUrl;
+    private acked;
+    private selfId;
+    /** Set by {@link stop}, so a socket closing on our own terms never reconnects. */
+    private stopped;
+    /** Consecutive reconnects, for the backoff. Reset once a connection actually works. */
+    private attempts;
+    private pendingReconnect;
+    constructor(token: string, handlers: GatewayHandlers, deps?: GatewayDeps);
+    /** Open the connection and identify. Safe to call once; use {@link stop} to end it. */
+    connect(): void;
+    /**
+     * Close the connection for good. This is what takes the bot offline on `Ctrl+C` (#680): the
+     * daemon calls it from its shutdown block, and no reconnect follows.
+     */
+    stop(): void;
+    /** Our own user id once READY has landed. */
+    get userId(): string | undefined;
+    private open;
+    /**
+     * A closed socket we did not close ourselves: resume if we can, else identify fresh.
+     *
+     * Backed off, and that is not a nicety: a connection that fails immediately (offline, a bad
+     * token) closes as fast as it opens, so reconnecting inline is a tight loop that pins a core
+     * and gets the bot rate-limited. Doubles to a cap, and resets once a connection works.
+     */
+    private reopen;
+    private receive;
+    private onHello;
+    private identify;
+    private resume;
+    private sendHeartbeat;
+    private onDispatch;
+    private send;
+    private log;
+}
+/** Narrow a MESSAGE_CREATE payload; `undefined` when it is not a shape we can use. */
+export declare function parseMessage(data: unknown): DiscordMessage | undefined;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/discord/gateway.d.ts.map

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