@bragi-gmbh/codebus 1.2.0

package/dist/commands/ask.js

@@ -0,0 +1,189 @@
+import { CodebusError } from "../errors.js";
+import { rankByRelevance, formatNodeCitation, formatEdgeCitation, checkStaleness, isUsingFallbackSnapshot, isProseNode } from "../graph.js";
+import { resolveGraphSource } from "../graph-remote.js";
+/**
+ * Core ask logic shared by CLI and MCP.
+ * Returns a budgeted, cited answer over the graph.
+ *
+ * A6: routes through resolveGraphSource (local current wins unless an
+ * explicit `repo` names a different one -> remote -> last-good -> none).
+ * When no `repo` is given and a local graphify-out/ snapshot exists, this is
+ * BIT-IDENTICAL to the pre-A6 behavior and touches no network at all.
+ */
+export async function askGraph(question, options = {}) {
+    const budgetTokens = options.budget ?? 500;
+    const repoRoot = options.repoRoot || process.cwd();
+    const resolved = await resolveGraphSource(question, { repo: options.repo, repoRoot });
+    const snapshot = resolved.snapshot;
+    if (!snapshot) {
+        return {
+            answer: "",
+            citations: [],
+            error: options.repo
+                ? `No local graphify-out/graph.json found, and no remote graph reachable for repo '${options.repo}'.`
+                : "No graphify-out/graph.json found. Run `graphify` or check the repo root.",
+            source: resolved.source,
+        };
+    }
+    const isRemote = resolved.source === "remote";
+    // Check if we're using a fallback (last-good) snapshot due to a failed build
+    const usingFallback = isRemote ? false : resolved.source === "last-good" || isUsingFallbackSnapshot(repoRoot);
+    // Check staleness: local checkStaleness for local/last-good sources; the
+    // remote leg already computed its own 3-state verdict via graph_status.
+    const staleness = isRemote
+        ? (resolved.staleness ?? { isStale: false, isDirty: false, unknown: true })
+        : await checkStaleness(snapshot, repoRoot, "dirty-only");
+    // Rank by relevance
+    const { nodes: rankedNodes, edges, matchCount: rankedMatchCount } = rankByRelevance(snapshot, question, 15);
+    // Remote-only: rankByRelevance drops score-0 matches (graph.ts), which would
+    // silently vanish a trigram-only graph_search hit that shares no literal
+    // substring with the query. Append any search hit missing from the ranked
+    // result rather than dropping it (Round-3 review finding 7's sibling
+    // concern for graph_search, same "never silently drop a real hit" rule).
+    let nodes = rankedNodes;
+    let matchCount = rankedMatchCount;
+    if (isRemote && resolved.searchHits && resolved.searchHits.length > 0) {
+        const present = new Set(rankedNodes.map((n) => n.id));
+        const missing = resolved.searchHits.filter((h) => !present.has(h.id));
+        if (missing.length > 0) {
+            nodes = [...rankedNodes, ...missing];
+            matchCount = rankedMatchCount + missing.length;
+        }
+    }
+    // [remote@sha7] citation markers: applied to every citation pushed below
+    // when the answer was built from a remote slice, so a reader can tell a
+    // remote-sourced citation apart from a local one at a glance.
+    const remoteMarker = isRemote && resolved.remoteSha7 ? ` [remote@${resolved.remoteSha7}]` : "";
+    const cite = (c) => c + remoteMarker;
+    // Build answer with budget tracking
+    let answer = "";
+    const citations = [];
+    let tokens = 0;
+    if (matchCount === 0) {
+        answer = `No results found for "${question}".`;
+        tokens += 10;
+    }
+    else {
+        // Add summary
+        const summary = `Found ${matchCount} relevant items in the graph:`;
+        answer = summary + "\n";
+        tokens += 5;
+        // Partition nodes into prose (docs/decisions) and code for distinct sections
+        const proseNodes = nodes.filter(isProseNode);
+        const codeNodes = nodes.filter((n) => !isProseNode(n));
+        // Add prose/doc nodes first under a dedicated section header
+        if (proseNodes.length > 0) {
+            answer += "\n## Docs & Decisions:\n";
+            tokens += 3;
+            for (const node of proseNodes) {
+                if (tokens >= budgetTokens * 0.85)
+                    break;
+                const citation = cite(formatNodeCitation(node));
+                const line = `- ${node.label} (${citation})\n`;
+                answer += line;
+                citations.push(citation);
+                tokens += Math.ceil(line.split(/\s+/).length);
+            }
+        }
+        // Add code nodes
+        if (codeNodes.length > 0) {
+            answer += "\n## Files & Symbols:\n";
+            tokens += 3;
+            for (const node of codeNodes) {
+                if (tokens >= budgetTokens * 0.85)
+                    break; // Leave 15% headroom
+                const citation = cite(formatNodeCitation(node));
+                const line = `- ${node.label} (${citation})\n`;
+                answer += line;
+                citations.push(citation);
+                tokens += Math.ceil(line.split(/\s+/).length);
+            }
+        }
+        // Add edges
+        if (edges.length > 0) {
+            answer += "\n## Contexts & Relationships:\n";
+            tokens += 3;
+            for (const edge of edges) {
+                if (tokens >= budgetTokens * 0.85)
+                    break;
+                const citation = cite(formatEdgeCitation(edge));
+                const nodesList = edge.nodes.slice(0, 3).join(", ") + (edge.nodes.length > 3 ? "…" : "");
+                const line = `- ${edge.label}: ${nodesList} (${citation})\n`;
+                answer += line;
+                citations.push(citation);
+                tokens += Math.ceil(line.split(/\s+/).length);
+            }
+        }
+        // Truncate if over budget
+        if (tokens > budgetTokens) {
+            const lines = answer.split("\n");
+            answer = "";
+            tokens = 0;
+            for (const line of lines) {
+                const lineTokens = Math.ceil(line.split(/\s+/).length);
+                if (tokens + lineTokens <= budgetTokens) {
+                    answer += line + "\n";
+                    tokens += lineTokens;
+                }
+            }
+            answer += `\n[…truncated at ~${budgetTokens} tokens]`;
+        }
+    }
+    // Add staleness note if applicable.
+    // When git is unavailable, staleness is unknown — surface that explicitly rather than
+    // silently claiming the snapshot is fresh.
+    let stalenessNote;
+    if (usingFallback) {
+        stalenessNote = "(using last-good snapshot; build may have failed)";
+    }
+    else if (staleness.unknown) {
+        stalenessNote = isRemote ? "(staleness unknown: remote)" : "(staleness unknown: git unavailable)";
+    }
+    else if (staleness.note) {
+        stalenessNote = staleness.note;
+    }
+    // Round-3 review finding 7: graph_subgraph's `truncated` flag means the
+    // returned slice may be missing reachable nodes within the requested depth
+    // — surface it rather than silently trusting an incomplete traversal.
+    if (isRemote && resolved.truncated) {
+        const truncNote = "remote slice truncated — some reachable nodes may be missing";
+        stalenessNote = stalenessNote ? `${stalenessNote}; ${truncNote}` : `(${truncNote})`;
+    }
+    return { answer, citations, stalenessNote, source: resolved.source };
+}
+/**
+ * CLI command: codebus ask <question>
+ */
+export async function askCmd(question, options) {
+    try {
+        const budget = options.budget ? parseInt(options.budget, 10) : 500;
+        const result = await askGraph(question, { budget, repoRoot: options.repoRoot, repo: options.repo });
+        if (result.error) {
+            throw new CodebusError(result.error, 1);
+        }
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log(result.answer);
+            if (result.stalenessNote) {
+                console.log(`\n[${result.stalenessNote}]`);
+            }
+        }
+    }
+    catch (err) {
+        if (err instanceof CodebusError)
+            throw err;
+        throw new CodebusError(`Failed to query graph: ${err instanceof Error ? err.message : String(err)}`, 1);
+    }
+}
+/**
+ * Register the ask command.
+ */
+export function registerAsk(program, g) {
+    g(program.command("ask").argument("<question>", "question to ask the graph"))
+        .option("--budget <tokens>", "max output tokens (default 500)")
+        .option("--repo <slug>", "query a connected repo's remote graph instead of the local checkout")
+        .action((question, opts) => askCmd(question, opts));
+}
+//# sourceMappingURL=ask.js.map

package/dist/commands/ask.js.map

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

package/dist/commands/auth.js

@@ -0,0 +1,33 @@
+import { readdir, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { CACHE_DIR } from "../session.js";
+import { DIGEST_FILE } from "./digest.js";
+// Cache hygiene: cached session JWTs embed agent uuids, which die on any
+// `supabase db reset` — the CLI then fails with "not a member" until the
+// stale cache is cleared. `codebus auth reset` removes session caches;
+// --all also drops the digest snapshot.
+async function resetCmd(o) {
+    let removed = 0;
+    try {
+        for (const f of await readdir(CACHE_DIR)) {
+            if (/^session-[0-9a-f]{16}\.json$/.test(f)) {
+                await rm(join(CACHE_DIR, f), { force: true });
+                removed++;
+            }
+        }
+    }
+    catch {
+        // no cache dir yet — nothing to do
+    }
+    if (o.all) {
+        await rm(DIGEST_FILE, { force: true });
+        console.log(`cleared ${removed} session cache(s) + digest snapshot`);
+        return;
+    }
+    console.log(`cleared ${removed} session cache(s)`);
+}
+export function registerAuth(program, g) {
+    const auth = program.command("auth").description("session/auth utilities");
+    g(auth.command("reset")).option("--all", "also remove the digest snapshot").action(resetCmd);
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,yEAAyE;AACzE,yEAAyE;AACzE,uEAAuE;AACvE,wCAAwC;AACxC,KAAK,UAAU,QAAQ,CAAC,CAAoB;IAC1C,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,CAAC;QACH,KAAK,MAAM,CAAC,IAAI,MAAM,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,IAAI,8BAA8B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC9C,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IACD,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;QACV,MAAM,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,qCAAqC,CAAC,CAAC;QACrE,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,mBAAmB,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,CAA0B;IACvE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC;IAC3E,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,iCAAiC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC/F,CAAC"}

package/dist/commands/checkin.js

@@ -0,0 +1,235 @@
+import { resolveConfig } from "../config.js";
+import { makeCtx } from "../client.js";
+import { CodebusError } from "../errors.js";
+import { loadRoles, saveRoles, rolesFile } from "./as.js";
+import { startCmd } from "./session.js";
+import { watchCmd } from "./watch.js";
+import { recordSessionRole } from "../sessionstore.js";
+import { stopHookInstalled, inClaudeCodeSession, codexHooksInstalled, inCodexSession, watchRecentlyArmed, MAIL_LATENCY_WARNING } from "../mail-latency.js";
+// `codebus checkin <name>` — the one-line onboarding. Design brief:
+// docs/checkin-design-brief.md. The author types this into any already-running
+// agent session; from that moment the agent is addressable at <name> on the bus.
+//
+// What it does, in order:
+//   1. authenticates as the AUTHOR using the machine's existing credential
+//      (config.json / env — the person-linked agent from `codebus login --github`),
+//   2. calls checkin_role(<name>) — mints or rebinds a durable, author-owned
+//      principal named exactly what the author said (idempotent by name),
+//   3. persists the returned token into the role store (~/.codebus/roles.json)
+//      and binds THIS SESSION (sessionstore.ts) to it,
+//   4. re-runs session-start orientation AS the new identity, printing output
+//      written for the agent to read: who it is, its inbox, what's next, and
+//      how to participate.
+//
+// checkin does NOT bind the directory (owner decision §6.1, docs/plans/
+// codebus-v2-reliability.md — reversed from the earlier design). A directory
+// binding is now created ONLY by a deliberate `codebus as --bind`: checkin
+// used to also claim the cwd's basename as an ambient default, which is
+// exactly how a generic-but-real name ('CodeBus') or a decommissioned
+// automation's leftover binding ends up silently handing an unrelated session
+// somebody else's identity (FM-1/FM-7). Session-scoped identity plus an
+// explicit opt-in for anything more durable is the whole fix.
+//
+// Failures surface loudly and verbatim — the competitor's worst failure class
+// is agents that die silently (block/buzz issues #2265/#5500/#5495).
+const PARTICIPATION = (slug) => [
+    "── How to participate (for the agent reading this) ─────────────────────────",
+    `You are '${slug}' on CodeBus, this workspace's coordination bus. Habits:`,
+    "  • DURABLE AUTO-CHECK — Claude Code gets this for free via its Stop hook",
+    "    (codebus install claude). Codex has its own native Stop hook too: run",
+    "    `codebus install codex` ONCE to wire `codebus tick --hook` into",
+    "    ~/.codex/hooks.json — after that, new mail surfaces automatically at",
+    "    every Codex turn boundary (Codex feeds it back as your next prompt),",
+    "    exactly like Claude Code. Without that install, fall back to:",
+    "  • STANDING LOOP — whenever you are idle, run:",
+    "      codebus watch --mine --first --timeout 280000",
+    "    It blocks and exits the moment mail/work for you arrives (or quietly on",
+    "    timeout). What it prints is a WORK ORDER, not a notification: read the",
+    "    message, do what it asks in this session, and reply with the outcome —",
+    "    never a bare acknowledgement. Then re-arm the loop.",
+    "  • Between tasks and at natural pauses, check for work/mail:",
+    "      codebus inbox            (or MCP tool: codebus_inbox)",
+    "      codebus next             (or MCP tool: codebus_next)",
+    "  • Read and reply (add --thread to walk a whole chain; --all to CC every",
+    "    original recipient of a group send):",
+    "      codebus read <id> [--thread]   ·   codebus reply <id> --body \"...\" [--all]",
+    "  • Mail that needed no reply but was actually handled: codebus ack <id>",
+    "  • Check whether recipients read/handled what you sent: codebus sent",
+    "  • Send to another agent or person:",
+    "      codebus send --to <slug> --type note --body \"...\"",
+    "      (add --headline/--required-action for a structured handover)",
+    "  • Claim/finish work:",
+    "      codebus task claim <id>  ·  codebus task done <id> --evidence <ref>",
+    "  • Record decisions / ask questions: codebus decision add · codebus question ask",
+    "  • End your session with a handoff: codebus session end --summary \"...\"",
+    `Anyone on the bus can now reach you at '${slug}'.`,
+    "────────────────────────────────────────────────────────────────────────────",
+].join("\n");
+async function checkinCmd(name, o) {
+    const cfg = resolveConfig({ ...o, noRoleBinding: true });
+    const ctx = await makeCtx(cfg);
+    // p_function_role only when given — the RPC validates against the 0043
+    // vocabulary and its error names the allowed values, so pass user input
+    // through verbatim rather than pre-validating a second list here.
+    const args = { p_name: name, p_adopt: !!o.adopt };
+    if (o.role)
+        args.p_function_role = o.role;
+    const { data, error } = await ctx.supabase.rpc("checkin_role", args);
+    if (error) {
+        // Server messages are written to be actionable; pass them through verbatim
+        // and add the one hint the server can't know (the CLI flag spelling).
+        const hint = error.message.includes("unowned legacy role")
+            ? `\n  hint: re-run as: codebus checkin ${name} --adopt`
+            : error.message.includes("has no person_id")
+                ? `\n  hint: this machine's credential is not person-linked — run: codebus login --github`
+                : "";
+        throw new CodebusError(`checkin failed: ${error.message}${hint}`);
+    }
+    const r = data;
+    // Persist into the same store `codebus as` uses — checkin and as are one system.
+    const store = loadRoles();
+    store.roles[r.agent_slug] = { token: r.token, agent: r.agent_slug, added_at: new Date().toISOString() };
+    saveRoles(store);
+    // THIS SESSION (durable env id when the host has one, else process
+    // ancestry — sessionstore.ts): multiple agents must share one repository
+    // (researcher/planner/coder/verifier on the same checkout), so identity
+    // binds to the running session, never to the directory. checkin does NOT
+    // touch ~/.codebus/roles.json's `bindings` — that's `codebus as --bind`'s
+    // job alone, deliberately, so a checkin can never silently displace (or be
+    // displaced by) another agent's directory default (observed live:
+    // codex-host-ingress silently stole legacy-android-host-app from
+    // claude-master-planner's open session; and separately, a checkin from
+    // /tmp once bound the literal pattern 'tmp' machine-wide).
+    const sessionKey = recordSessionRole(r.agent_slug);
+    const verb = r.created ? "created" : r.adopted ? "adopted" : "rebound (token rotated)";
+    console.log(`✓ ${r.agent_slug} ${verb} — you own this name; the token is stored in ${rolesFile()}`);
+    if (sessionKey) {
+        console.log(`✓ THIS session now acts as ${r.agent_slug} (other sessions, including other dirs' bindings, are unaffected)`);
+    }
+    else {
+        console.log(`⚠ could not read a durable session id or this session's process ancestry — identity did not bind. Re-run this checkin once that's fixed (doctor may help diagnose why).`);
+    }
+    console.log(`  (to also make this directory's default identity ${r.agent_slug} for future sessions here: codebus as --bind ${r.agent_slug})`);
+    if (r.rotated && !r.adopted)
+        console.log(`  note: any other session using the previous token for '${r.agent_slug}' must re-checkin.`);
+    if (o.json) {
+        console.log(JSON.stringify({ agent: r.agent_slug, created: r.created, adopted: r.adopted, rotated: r.rotated, session_bound: !!sessionKey }, null, 2));
+        return;
+    }
+    // Orient AS the new identity: same output as `codebus session start`, which
+    // includes the first-ever-session welcome. The token override unpins the
+    // author's file identity for this call only.
+    console.log("");
+    await startCmd({ url: cfg.url, anonKey: cfg.anonKey, workspace: cfg.workspace, token: r.token });
+    console.log(PARTICIPATION(r.agent_slug));
+    // Auto-arm the listener (owner ruling: checkin should start the monitor).
+    // Skipped whenever THIS session is live inside an actual agentic-tool turn
+    // (Claude Code or, as of RC3, Codex) — blocking for a watch window would
+    // stall that turn for nothing regardless of whether a Stop hook is wired
+    // up, since a blocked turn gets no chance to run ANY hook, real-time
+    // listener or otherwise, until it unblocks. Everywhere else (a plain
+    // shell, or a tool session neither of these two detectors recognizes),
+    // one watch window opens right here: the checkin line makes the agent
+    // live.
+    //
+    // Bug fix (found while investigating PR #54 CI failures on
+    // checkin-command-coverage.test.ts's watch-window branch-selection
+    // suite — confirmed via a bisect against 65a448a/origin/main that this
+    // predates both that PR and #53, so it is not a regression either
+    // introduced): this gating condition used to be `!hookAppliesHere`
+    // (`hookAppliesHere = (underClaudeCode && claudeHookOk) || (underCodex &&
+    // codexHookOk)`), which — despite the comment two paragraphs below
+    // ("Review MAJOR finding #5") already documenting that "a hook being
+    // INSTALLED is not the same as it being able to fire for THIS process" as
+    // a genuinely separate case from "not under the tool at all" — still
+    // routed BOTH cases into this same blocking branch: `hookAppliesHere` is
+    // false whenever the hook isn't installed, `!hookAppliesHere` is
+    // therefore true, and the code blocked exactly as if no tool were
+    // running at all. That contradicts the finding's own stated intent
+    // (never block inside a live tool turn, hook or not — the two cases
+    // differ only in WHICH message to print, not whether to block) and the
+    // dedicated non-blocking "mail latency unbounded" warning path in the
+    // `else` branch below existed but was UNREACHABLE for exactly the
+    // scenario it was written for. Fixed by gating on tool presence alone
+    // (`!underClaudeCode && !underCodex`); `hookAppliesHere` is still used
+    // below, but now purely to pick which message the non-blocking branch
+    // prints, never whether to enter it.
+    const underClaudeCode = inClaudeCodeSession();
+    const underCodex = inCodexSession();
+    const claudeHookOk = stopHookInstalled();
+    const codexHookOk = codexHooksInstalled();
+    const hookAppliesHere = (underClaudeCode && claudeHookOk) || (underCodex && codexHookOk);
+    const windowMs = parseInt(process.env.CODEBUS_WATCH_WINDOW_MS ?? "280000", 10);
+    if (o.watch !== false && !underClaudeCode && !underCodex) {
+        console.log("");
+        console.log(`listening for your mail now (${Math.round(windowMs / 1000)}s window; exits on first event — handle it, then re-arm with the standing loop):`);
+        // Review fix (Luna, PR #54 comment 3826518135): this branch requires
+        // `!underCodex` to even be entered (see the condition above), so a
+        // check for `underCodex && !codexHookOk` HERE can never be true — this
+        // used to be exactly that dead check, orphaned by the branch-selection
+        // fix earlier in this same PR (the fix moved the "never block inside a
+        // live Codex turn" decision out from under `hookAppliesHere`, but left
+        // this Codex-specific tip sitting in the branch it can no longer reach,
+        // silently dropping it for everyone rather than firing it for anyone).
+        // The genuine "under Codex, no hook" case now correctly lands in the
+        // `else` branch below instead (it never blocks) — the equivalent tip
+        // is given there.
+        await watchCmd({ url: cfg.url, anonKey: cfg.anonKey, workspace: cfg.workspace, token: r.token, mine: true, first: true, timeout: String(windowMs) });
+    }
+    else {
+        // Either a session already covered by a real turn-boundary hook (auto-arm
+        // skipped) or an explicit --no-watch. Review MAJOR finding #5: a hook
+        // being INSTALLED (machine-wide config) is not the same as it being able
+        // to fire for THIS process — Claude's only ever fires inside an actual
+        // Claude Code session, and Codex's only ever fires inside an actual Codex
+        // session (CODEX_THREAD_ID). A hook installed while this checkin runs
+        // under the OTHER tool, or a plain shell (--no-watch, say), cannot help
+        // this agent at all; require a recently-armed watch (scoped to this
+        // workspace) instead, and warn loudly if neither applies (delivery gap #8).
+        console.log("");
+        if (underClaudeCode && claudeHookOk) {
+            console.log("(Claude Code session: new mail is surfaced automatically at turn boundaries by the Stop hook — no listener needed.)");
+        }
+        else if (underCodex && codexHookOk) {
+            console.log("(Codex session: new mail is surfaced automatically at turn boundaries by Codex's own Stop hook (wired via `codebus install codex` into ~/.codex/hooks.json) — no listener needed. Like Claude Code's Stop hook, it feeds the reported mail back as your next prompt.)");
+        }
+        else {
+            const armed = await watchRecentlyArmed({
+                supabase: ctx.supabase, agentSlug: r.agent_slug, workspaceSlug: cfg.workspace, identitySource: ctx.identitySource,
+            });
+            if (armed) {
+                console.log("(--no-watch, and a watch window was recently armed for this workspace — mail latency stays bounded.)");
+            }
+            else if (underCodex && !codexHookOk) {
+                // Review fix (Luna, PR #54 comment 3826518135): the genuine "live
+                // Codex session, hook not installed" case — this branch is where it
+                // ACTUALLY lands now (it never blocks per the fix above), so the
+                // actionable, Codex-specific tip belongs here, not in the blocking
+                // branch it can no longer reach. Checked ahead of the two
+                // hook-installed-elsewhere cases below since underCodex is true
+                // here, making `codexHookOk && !underCodex` structurally impossible
+                // to also match for this same call.
+                console.log(`⚠ ${MAIL_LATENCY_WARNING} Run \`codebus install codex\` once to wire Codex's own Stop hook for durable auto-checking; otherwise keep re-arming \`codebus watch --mine --first\` by hand.`);
+            }
+            else if (claudeHookOk && !underClaudeCode) {
+                console.log(`⚠ a Claude Stop hook is installed, but this session is not running inside Claude Code, so it cannot fire for it. ${MAIL_LATENCY_WARNING}`);
+            }
+            else if (codexHookOk && !underCodex) {
+                console.log(`⚠ a Codex Stop hook is installed, but this session is not running inside Codex, so it cannot fire for it. ${MAIL_LATENCY_WARNING}`);
+            }
+            else {
+                console.log(`⚠ ${MAIL_LATENCY_WARNING}`);
+            }
+        }
+    }
+}
+export function registerCheckin(program, g) {
+    g(program.command("checkin"))
+        .description("one-line onboarding: mint/rebind an author-owned agent named <name> and orient it")
+        .argument("<name>", "the name this agent will be addressable at (you own it; idempotent)")
+        .option("--adopt", "take ownership of an existing unowned legacy role (rotates its token)")
+        .option("--role <function_role>", "functional role for routing (planner|builder|reviewer|consultant|researcher|router|monitor — docs/role-vocabulary.md)")
+        .option("--no-watch", "do not auto-arm the watch listener after checkin")
+        .action(checkinCmd);
+}
+//# sourceMappingURL=checkin.js.map

package/dist/commands/checkin.js.map

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

package/dist/commands/decision.js

@@ -0,0 +1,52 @@
+import { resolveConfig } from "../config.js";
+import { makeCtx, workspaceId } from "../client.js";
+import { render } from "../output.js";
+import { CodebusError } from "../errors.js";
+/**
+ * Shared core: create a decision.
+ * Exported for reuse in MCP tool.
+ */
+export async function createDecisionCore(ctx, opts) {
+    const ws = await workspaceId(ctx);
+    const slug = opts.slug ?? opts.title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 60);
+    const { data, error } = await ctx.supabase.from("decisions")
+        .insert({ workspace_id: ws, slug, title: opts.title, body: opts.body ?? null }).select().single();
+    if (error)
+        throw new CodebusError(error.message);
+    return { display_id: data.display_id, slug: data.slug, status: data.status, id: data.id };
+}
+/**
+ * Shared core: accept a decision.
+ * Exported for reuse in MCP tool.
+ */
+export async function acceptDecisionCore(ctx, idOrDisplay) {
+    const isDisplay = /^CB-DEC-/i.test(idOrDisplay);
+    const sel = isDisplay ? "display_id" : "id";
+    const val = isDisplay ? idOrDisplay.toUpperCase() : idOrDisplay;
+    // display ids are only unique per workspace (bus_counters, 0004) — scope
+    // the display_id lookup, or a multi-workspace agent could accept the WRONG
+    // workspace's decision when two workspaces happen to share a display_id.
+    let q = ctx.supabase.from("decisions").update({ status: "accepted" }).eq(sel, val);
+    if (isDisplay)
+        q = q.eq("workspace_id", await workspaceId(ctx));
+    const { data, error } = await q.select().single();
+    if (error)
+        throw new CodebusError(`accept failed (owner-only): ${error.message}`);
+    return { display_id: data.display_id, status: data.status, id: data.id };
+}
+async function addDecision(o) {
+    const ctx = await makeCtx(resolveConfig(o));
+    const result = await createDecisionCore(ctx, { title: o.title, slug: o.slug, body: o.body });
+    console.log(render([{ display_id: result.display_id, slug: result.slug, status: result.status }], { json: !!o.json }));
+}
+async function acceptDecision(idOrDisplay, o) {
+    const ctx = await makeCtx(resolveConfig(o));
+    const result = await acceptDecisionCore(ctx, idOrDisplay);
+    console.log(render([{ display_id: result.display_id, status: result.status }], { json: !!o.json }));
+}
+export function registerDecision(program, g) {
+    const dec = program.command("decision").description("decision operations");
+    g(dec.command("add")).requiredOption("--title <t>").option("--slug <s>").option("--body <b>").action(addDecision);
+    g(dec.command("accept").argument("<id>")).action((id, o) => acceptDecision(id, o));
+}
+//# sourceMappingURL=decision.js.map

package/dist/commands/decision.js.map

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