@staix/agent-hub 0.30.0 → 0.32.0

package/src/cli/console-state.ts

@@ -9,6 +9,7 @@ import { sanitize } from "../hub/envelope.ts";
 import { DOING_STUB } from "../hub/peer-doing.ts";
 import type { SettingRow, SettingValue } from "../hub/settings.ts";
 import { symbolFields, overlapFields } from "./console-symbols.ts";
+import { flowBody, flowPrompt, startFlow, stepFlow, type QuestionFlow, type QuestionView } from "./console-question.ts";
 import { choicePrompt, reviewChoiceFor, reviewHint, reviewRefusal, verdictGuide, verdictInput, type ReviewChoice, type Verdict } from "./console-review.ts";
 import { configFormPrompt, reduceConfigForm, type ConfigEditBody, type ConfigForm } from "./console-config.ts";
 import { windowKind } from "../hub/window-kind.ts";
@@ -38,9 +39,13 @@ export interface ConsoleState {
   pendingRestart?: { key: string; reason: string }[];
   retainedConfig?: { key: string; reason: string }[];
   features?: readonly string[];
+  /** #1053 T4: the open questions the hub reported (the person's text, shown here only) and the answer being built; `A` starts it. */
+  questions?: QuestionView[]; questionFlow?: QuestionFlow; questionsSeen?: string[];
   /** Older embedding callers omit choices and retain the original STAI/off toggle. */
   petChoices?: readonly CharacterId[]; petCharacter?: CharacterId; petSize?: PetSize; petGlyphs?: "ascii" | "blocks";
   attentionFacts?: { kind: "review" | "offline" | "stall" | "offer"; id: number; peer?: string }[];
+  /** #1054: unread results from the hub, and the ids the stream has already told the person about. */
+  results?: readonly { id: string; peer?: string; since?: number }[]; resultsSeen?: string[];
   attentionFingerprint?: string;
   petEnabled?: boolean; petBlink?: boolean; attentionMessages?: { id?: string; peer?: string; important: boolean; since?: number }[]; storageBlocked?: boolean; recoveryNeed?: { id?: string; running: boolean; since?: number }; attentionSelection?: number;
   mode: "stream" | "panels"; panel: number; selection: number;
@@ -76,7 +81,7 @@ export interface ConsoleState {
 const roomsVisible = (s: Pick<ConsoleState, "rooms">) => s.rooms === null || Array.isArray(s.rooms) && s.rooms.length > 0;
 /** A detail view: text as the stream shows it, or labeled fields. */
 export type Detail = string | Record<string, unknown>;
-export type ConsoleEffect = { type: "exit" } | { type: "permit"; id: string; option?: string } |
+export type ConsoleEffect = { type: "exit" } | { type: "permit"; id: string; option?: string } | { type: "answer"; set: string; answers: { questionId: string; optionIds: string[]; other?: string }[] } | { type: "peer_takeover"; peer: string; standbyId: string } |
   { type: "settings_preview"; token: number; key?: string; value?: SettingValue; undo: boolean } |
   { type: "config_preview"; token: number; edit: ConfigEditBody } | { type: "config_write"; edit: ConfigEditBody; reason: string; confirm?: string } |
   { type: "settings_write"; key?: string; value?: SettingValue; undo: boolean; reason: string; confirm?: string; undoDigest?: string } |
@@ -107,7 +112,7 @@ export function syncPermissionDefaults(s: ConsoleState, rows: unknown): boolean
   s.permissionDefaultsHandled = s.permissionDefaultsHandled.filter(fingerprint => current.has(fingerprint));
   const pending = s.confirm;
   if (pending?.type === "permission_default" && !s.permissionDefaults.some(row => row.peer === pending.peer && row.source === pending.source)) s.confirm = undefined;
-  if (s.settingsEdit || s.confirm || s.editing || s.input || s.modeChoice || s.reviewChoice || s.optionChoice || s.help) return false;
+  if (s.settingsEdit || s.confirm || s.editing || s.input || s.modeChoice || s.reviewChoice || s.optionChoice || s.questionFlow || s.help) return false;
   const next = s.permissionDefaults.find(row => !s.permissionDefaultsHandled.includes(permissionDefaultFingerprint(s, row)));
   if (!next) return false;
   s.confirm = { type: "permission_default", peer: next.peer, source: next.source };
@@ -359,11 +364,14 @@ export function budgetFields(budget: any, now: number): [string, unknown][] {
   return [["quota", lines.length ? lines : typeof budget.note === "string" ? budget.note : "no reading"], ...(lines.length && typeof budget.note === "string" ? [["quota note", budget.note] as [string, unknown]] : [])];
 }
 /** #784 AC3: the Peers detail carries the planner WIP split as one line (`1 of 2: active 1, review-wait 0, reserved 0`); a hub that sends none adds nothing. */
-function peerDetailRow(s: ConsoleState, row: any): Record<string, unknown> {
+function peerDetailRow(s: ConsoleState, row: any, now: number): Record<string, unknown> {
   const wip = s.taskWip?.[row.id];
   const split = wip && [wip.active, wip.reviewWait, wip.reserved].every(n => Number.isSafeInteger(n)) ? `${wip.wip} of ${wip.wipLimit}: active ${wip.active}, review-wait ${wip.reviewWait}, reserved ${wip.reserved}` : undefined;
   const isolation = ownerIsolationText(row.ownerIsolation, row.ownerIsolationNote);
-  return { ...row, ...(isolation ? { ownerIsolation: isolation } : {}), ...(split ? { "planner WIP": split } : {}) };
+  const { standbySessions, ...fields } = row;
+  const standby = Array.isArray(standbySessions) ? standbySessions.filter((session: any) => session && typeof session.id === "string").map((session: any) =>
+    `${typeof session.pid === "number" ? `pid ${session.pid}` : "pid unknown"}; session ${session.id}${typeof session.since === "number" ? `; waiting since ${relative(session.since, now)}` : ""}`) : [];
+  return { ...fields, ...(standby.length ? { "standing by": standby } : {}), ...(isolation ? { ownerIsolation: isolation } : {}), ...(split ? { "planner WIP": split } : {}) };
 }
 const detailLines = (detail: Detail, columns: number, now: number, task = false): Span[][] => {
   if (typeof detail === "string") return wrap(detail, columns).map(text => [span(text)]);
@@ -397,9 +405,9 @@ export const LAST_KEYS = [">", "\x1b[F", "\x1bOF", "\x1b[4~", "\x1b[8~"];
 const KEYS: [string, string[]][] = [
   ["Everywhere", ["Tab stream/panels", ": command", "? keys", "Esc back", "q quit"]],
   ["Command", ["Enter run", "Esc cancel", "Up/Down history", "Ctrl-U clear"]],
-  ["Panels", ["1-5 panel", "Left/Right panel", "j/k or Up/Down move", "Home/< first, End/> last", "Enter view", "j/k scroll a view", "w web UI (outside Peers)", "o pet window"]],
-  ["Approvals", ["a allow (then y)", "d deny", "v view", "[ ] select"]],
-  ["Peers", ["p pause", "r resume", "m permission mode", "w WIP limit", "l make planner (then y)", "t rename Pi/local session"]],
+  ["Panels", ["1-5 panel", "Left/Right panel", "j/k or Up/Down move", "Home/< first, End/> last", "Enter view", "j/k scroll a view", "w web UI (outside Peers)"]],
+  ["Approvals", ["a allow (then y)", "d deny", "v view", "[ ] select", "A answer an agent's question"]],
+  ["Peers", ["p pause", "r resume", "o takeover standby session", "m permission mode", "w WIP limit", "l make planner (then y)", "t rename Pi/local session"]],
   ["Tasks", ["b backlog/open", "n add backlog", "a assign/reserve (then y)", "u unassign (then y)", "r approve or request changes (in review; a or c, then a note)", "p pull, e plan (backlog)", "R return to backlog", "c cancel (then y)"]],
   ["Queue", ["r resolve (reason, then y)", "queued=discard, needs_review=retry", "D discard the peer's whole queued backlog (reason, then y)"]],
   ["Events", ["f peer filter", "g kind filter"]],
@@ -429,13 +437,22 @@ export function pruneApprovals(s: ConsoleState, now: number): ConsoleState {
  * dropped, and an open detail follows the selection from its top (it closes when nothing is selected). Every reducer
  * exit and every prune passes through here, so no key can act on a request other than the one shown.
  */
+/**
+ * #1053: in stream mode there is no body to draw the question in, and the footer holds only the keys, so the question and every numbered option are printed into the
+ * stream when a flow opens and at each new part. In panels mode the body shows them (renderConsoleLines), so nothing is printed.
+ */
+function showQuestion(s: ConsoleState, row: QuestionView, effects: ConsoleEffect[]): void {
+  if (s.mode !== "stream" || !s.questionFlow) return;
+  const body = flowBody(s.questionFlow, row, flat);
+  if (body) effects.push({ type: "print", text: [`${body.head}: ${body.prompt}`, ...body.options.map(line => `  ${line}`)].join("\n"), kind: "attention", tone: "attention" });
+}
 function bound(s: ConsoleState): ConsoleState {
   if (s.optionChoice && s.optionChoice !== s.approvalId) s.optionChoice = undefined;
   if (s.confirm?.type === "permission" && s.confirm.id !== s.approvalId) s.confirm = undefined;
   if (s.requestDetail && s.requestDetail !== s.approvalId) { s.requestDetail = s.approvalId; s.detailOffset = 0; }
   return s;
 }
-const COMMANDS = new Set(["status", "board", "task", "backlog", "review", "say", "pause", "resume", "budget", "queue", "permit", "permission", "ask", "remember", "route", "sdlc", "turns", "undo", "check-path", "report", "ui", "pet"]);
+const COMMANDS = new Set(["status", "board", "task", "backlog", "review", "say", "pause", "resume", "budget", "queue", "permit", "permission", "ask", "remember", "route", "sdlc", "turns", "undo", "check-path", "report", "ui", "pet", "peer"]);
 /** A tiny argv parser, never a shell. Quotes group arguments; backslash escapes one character. */
 export function parseConsoleCommand(input: string): string[] {
   const words: string[] = []; let word = ""; let quote = ""; let escaped = false; let started = false;
@@ -532,6 +549,22 @@ export function reduceConsole(state: ConsoleState, key: string, now = Date.now()
   const done = () => ({ state: bound(s), effects });
   const answered = (id: string) => { s.approvals = s.approvals.filter(a => a.id !== id); if (s.approvalId === id) s.approvalId = undefined; };
   if (key === "\x03") { effects.push({ type: "exit" }); return done(); }
+  // #1053 T4: a question being answered takes every key until it is sent or left; the hub validates the answers against the stored row.
+  if (s.questionFlow) {
+    const row = s.questions?.find(item => item.set === s.questionFlow!.set);
+    if (!row) { s.questionFlow = undefined; notify(s, "that question is no longer open", now, "attention"); return done(); }
+    const step = stepFlow(s.questionFlow, row, key);
+    if (step.answers) { effects.push({ type: "answer", set: row.set, answers: step.answers }); s.questionFlow = undefined; }
+    else if (step.flow) { const moved = step.flow.index !== s.questionFlow.index; s.questionFlow = step.flow; if (moved) showQuestion(s, row, effects); }
+    else { s.questionFlow = undefined; if (step.notice) notify(s, step.notice, now, "attention"); }
+    return done();
+  }
+  if (key === "A" && !s.settingsEdit && !s.confirm && !s.editing && !s.input && !s.modeChoice && !s.reviewChoice && !s.optionChoice && !s.help && !s.configForm) {
+    const row = s.questions?.[0];
+    if (!row) { notify(s, "no open question; agents ask with hub_ask", now, "attention"); return done(); }
+    s.questionFlow = startFlow(row); s.detail = undefined; s.requestDetail = undefined; showQuestion(s, row, effects);
+    return done();
+  }
   if (s.configForm) {
     const step = reduceConfigForm(s.configForm, key, s.configRevisions ?? {});
     s.configForm = step.form;
@@ -698,6 +731,9 @@ export function reduceConsole(state: ConsoleState, key: string, now = Date.now()
       s.approvalId = String(item.id);
       if (s.mode === "panels") { s.panel = 2; s.selection = s.approvals.findIndex(row => row.id === item.id); }
       navigated = true;
+    } else if (item.kind === "question") {
+      const row = s.questions?.find(question => question.set === item.id);
+      if (row) { s.questionFlow = startFlow(row); s.detail = undefined; s.requestDetail = undefined; navigated = true; showQuestion(s, row, effects); }
     } else if (item.kind === "delivery" && s.mode === "panels") {
       const rows = s.queue.filter(row => row.state === "needs_review" || row.state === "queued");
       const selected = item.id === undefined ? -1 : rows.findIndex(row => row.id === item.id);
@@ -764,9 +800,9 @@ export function reduceConsole(state: ConsoleState, key: string, now = Date.now()
     return done();
   }
   if (key === "\x1b") { s.detail = undefined; s.requestDetail = undefined; s.help = false; s.optionChoice = undefined; return done(); }
-  // #452: open the project dashboard or the pet window as a person's console command; both return at once.
-  if (s.mode === "panels" && (key === "w" || key === "o") && !s.optionChoice) {
-    effects.push({ type: "command", args: key === "w" ? ["ui"] : ["pet", "--window"] });
+  // #1012: the project dashboard stays on w; the floating pet window belongs to acon Mini.
+  if (s.mode === "panels" && key === "w" && !s.optionChoice) {
+    effects.push({ type: "command", args: ["ui"] });
     return done();
   }
   if (s.mode === "panels" && (FIRST_KEYS.includes(key) || LAST_KEYS.includes(key))) {
@@ -821,7 +857,7 @@ export function reduceConsole(state: ConsoleState, key: string, now = Date.now()
     else if (s.panel === 2) { s.requestDetail = row.id; s.detailOffset = 0; } // the row is the selected request
     else if (s.panel === 7) { s.detail = { usagePeer: row.id }; s.detailOffset = 0; } // rendered live from s.usage, so a refresh updates it
     else if (s.panel === 8) { s.roomSelection = row.name; s.detail = { roomName: row.name }; s.detailOffset = 0; }
-    else { s.detail = s.panel === 5 ? String(row.text) : s.panel === 1 ? peerDetailRow(s, row) : { ...row }; s.detailOffset = 0; }
+    else { s.detail = s.panel === 5 ? String(row.text) : s.panel === 1 ? peerDetailRow(s, row, now) : { ...row }; s.detailOffset = 0; }
     return done();
   }
   if (s.mode === "panels" && item !== undefined && item !== null) {
@@ -861,6 +897,15 @@ export function reduceConsole(state: ConsoleState, key: string, now = Date.now()
       if (definitionOf(String(item))?.title !== "hub") { notify(s, "Rename this session in its native UI", now); return done(); }
       s.input = `title ${item} `; s.editing = true; return done();
     }
+    if (s.panel === 1 && key === "o") {
+      const standby = Array.isArray(selected.standbySessions) ? selected.standbySessions[0] : undefined;
+      if (!s.features?.includes("peer_takeover")) { notify(s, "peer takeover requires a newer hub", now); return done(); }
+      if (!standby || typeof standby.id !== "string" || !/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(standby.id)) {
+        notify(s, "no current standby session is available; refresh ahub status", now); return done();
+      }
+      effects.push({ type: "peer_takeover", peer: String(item), standbyId: standby.id });
+      return done();
+    }
     const prefill = s.panel === 1 && key === "p" ? `pause ${item}` : s.panel === 1 && key === "r" ? `resume ${item}` : undefined;
     if (prefill) { s.input = prefill; s.editing = true; return done(); }
     if (s.panel === 3 && key === "c") {
@@ -941,7 +986,7 @@ export function cells(s: ConsoleState, row: any, selected: boolean, now: number,
     const paused = b?.paused ? `budget ${relative(b.paused.resetsAt, now)}` : row.paused && typeof row.paused === "object"
       ? `${row.paused.by ?? "paused"}${typeof row.paused.at === "number" ? ` ${duration(now - row.paused.at)}` : ""}`
       : row.paused === "manual" ? "user" : row.paused ? String(row.paused).split(":")[0] : "-";
-    return [id(row.planner ? `${row.id} (planner)` : row.id, row.state === "offline" ? undefined : "info"), span(row.rostered === false ? `${row.state} off roster` : row.state, stateTone(row.state)),
+    return [id(row.planner ? `${row.id} (planner)` : row.id, row.state === "offline" ? undefined : "info"), span(`${row.rostered === false ? `${row.state} off roster` : row.state}${Array.isArray(row.standbySessions) && row.standbySessions.length ? ` +standby:${row.standbySessions.length}` : ""}`, stateTone(row.state)),
       ...(showPermissionModes(s) ? [span(row.permissionMode && row.permissionMode !== "ask" ? row.permissionMode : "-", row.permissionMode === "never-ask" ? "attention" : undefined)] : []),
       span(row.pullOnly && definitionOf(row.id)?.attach?.pullOnlyForms?.includes("tui") ? "pull-only" : row.toolsOnly ? "tools-only" : row.attached === false ? "detached" : "attached", row.toolsOnly ? "attention" : undefined),
       span(count(row.queued)), span(count(row.queuedImportant), row.queuedImportant ? "attention" : undefined),
@@ -986,7 +1031,7 @@ function roomDetail(row: RoomStatusView): Record<string, unknown> {
   return {
     room: row.name, "room id": row.room, "link state": row.link ?? "unknown", owner: row.owner, "local member": row.member,
     "member count": count(row.memberCount),
-    "remote peers": row.remotePeers === null ? "unknown" : row.remotePeers.length ? row.remotePeers.map(peer => `${peer.id} (${peer.state})`) : "0",
+    "remote peers": row.remotePeers === null ? "unknown" : row.remotePeers.length ? row.remotePeers.map(peer => `${peer.id} (${peer.presence ?? peer.state})${peer.liveness === "untracked" ? "; liveness not tracked (broker without ephemeral); upgrade the broker to track liveness" : ""}`) : "0",
     "counter scope": `since daemon start: ${since}`,
     "out handoff": count(relays?.outbound), "in admitted": count(relays?.inbound), withheld: count(relays?.withheld),
   };
@@ -1054,13 +1099,17 @@ function panelContext(s: ConsoleState, row: any): string[] {
   // The structural config form and the restart prefill need no selected row (#689).
   if (s.panel === 6) return [...(row ? ["e edit"] : []), "c config", ...(s.settingsUndo ? ["u undo"] : []), ...(s.pendingRestart?.length ? ["R restart"] : [])];
   if (!row) return [];
-  if (s.panel === 1) return ["p pause", "r resume", "m permission mode", "w WIP limit"];
+  if (s.panel === 1) return ["p pause", "r resume", ...(s.features?.includes("peer_takeover") && Array.isArray(row.standbySessions) && row.standbySessions.length ? ["o takeover"] : []), "m permission mode", "w WIP limit"];
   if (s.panel === 4) return [row.state === "queued" ? "r discard" : "r resolve"];       // D (the peer's whole backlog) is in the ? key table: it must not push j/k off an 80-column footer
   return [];
 }
 /** The footer's key hint: only keys that act in this mode, panel and state. */
 function hint(s: ConsoleState, columns: number): string {
-  const pending = selectedApproval(s) ? ["a allow", "d deny"] : [];
+  if (s.questionFlow) {
+    const asking = s.questions?.find(row => row.set === s.questionFlow!.set)?.questions[s.questionFlow.index];
+    return `${s.questionFlow.typing !== undefined ? "Enter keeps  Esc back" : `number picks${asking?.allowOther === true ? "  o other" : ""}${asking?.multi === true ? "  Enter done" : ""}  Esc cancel`}`;
+  }
+  const pending = [...(selectedApproval(s) ? ["a allow", "d deny"] : []), ...(s.questions?.length ? ["A answer"] : [])];
   if (s.mode === "stream") return [...pending, ...(pending.length ? ["v view"] : []), ...(s.approvals.length > (pending.length ? 1 : 0) ? ["[ ] select"] : []), "Tab panels", ": command", "? keys", "q quit"].join("  ");
   if (s.help) return "? or Esc close  q quit";
   const approvals = s.panel === 2 ? pending : [];
@@ -1143,6 +1192,8 @@ export function renderConsoleLines(s: ConsoleState, columns: number, rows = 24,
   if (s.modeChoice) prompt = `permission ${s.modeChoice}: 1 ask  2 ask-when-needed  3 never-ask  Esc cancel`;
   if (s.reviewChoice) prompt = choicePrompt(s.reviewChoice);
   const choice = s.optionChoice ? s.approvals.find(a => a.id === s.optionChoice) : undefined;
+  const asking = s.questionFlow ? s.questions?.find(row => row.set === s.questionFlow!.set) : undefined;
+  if (s.questionFlow && asking) prompt = flowPrompt(s.questionFlow, asking, flat, columns);
   if (choice) prompt = `allow request ${choice.id} (${choice.peer}) with: ${allowOptions(choice).map((o, i) => `${i + 1} ${quoted(o.name)}`).join("  ")}  Esc cancel`;
   const summary: Span[] = [];
   for (const [id, p] of Object.entries(s.peers)) {
@@ -1169,7 +1220,7 @@ export function renderConsoleLines(s: ConsoleState, columns: number, rows = 24,
   if (s.confirm?.type === "permission_default") prompt = `enable never-ask default for ${s.confirm.peer}? y/n Esc defer`;
   const footer = [fitLine(neverPeer ? [span(permissionBoundary(neverPeer, undefined, createProjectAdapterCatalog()), "attention")] : summary, columns),
     fitLine(defaultSource !== undefined ? [span(`source ${quoted(defaultSource.split(/[\\/]/).at(-1))}; stays ask until y`, "attention")] : s.editing && s.reviewGuide ? [span(s.reviewGuide, "info")] : approvals, columns),
-    fitLine([span(prompt, s.confirm || s.optionChoice ? "attention" : undefined)], columns)];
+    fitLine([span(prompt, s.confirm || s.optionChoice || asking ? "attention" : undefined)], columns)];
   const rule = [span("-".repeat(Math.max(0, columns)), "muted")];
   if (s.mode === "stream") {
     const counts = s.taskCounts;
@@ -1198,6 +1249,16 @@ export function renderConsoleLines(s: ConsoleState, columns: number, rows = 24,
     const definition: [string, unknown][] = row ? [["type", row.type], ...(row.min !== undefined || row.max !== undefined ? [["range", `${row.min ?? "-"}..${row.max ?? "-"}`] as [string, unknown]] : []), ["risk", row.risk], ["applies", row.applies]] : [];
     lines.push(...fieldLines([["setting", edit.key ?? s.settingsUndo ?? "last write"], ...definition, ["preview", (edit.lines ?? []).join("\n")], ["decision", "Esc cancels; saving needs a reason and explicit y"]], columns, now).flat());
   }
+  else if (s.questionFlow && asking && flowBody(s.questionFlow, asking, flat)) {
+    // #1053: the question and every option in the body, wrapped, never the one-line footer that clips. The options come first and are never cut; the prompt gives way (marked) when the terminal is short.
+    const body = flowBody(s.questionFlow, asking, flat)!;
+    const optionLines = body.options.flatMap(option => wrap(option, columns, 3).map(text => [span(text, "info")]));
+    const room = Math.max(1, height - 1 - optionLines.length);
+    const promptLines = wrap(body.prompt, columns);
+    const shown = promptLines.length > room ? [...promptLines.slice(0, Math.max(1, room) - 1), "..."] : promptLines;
+    // Options that do not fit even wrapped are shown one per line (clipped to the width, but a label is at most 80 characters) rather than dropped: no option is ever off screen.
+    lines.push([span(body.head, "attention")], ...shown.map(text => [span(text)]), ...(optionLines.length <= height - 1 ? optionLines : body.options.map(option => fitLine([span(option, "info")], columns))));
+  }
   else if (s.help) lines.push(...keyTable(columns, !!s.petEnabled || !!s.petChoices?.length, !!s.petChoices?.length, roomsVisible(s)));
   else if (s.detail !== undefined || (s.requestDetail && permission)) {
     const usagePeer = s.panel === 7 && s.detail && typeof s.detail === "object" ? (s.detail as { usagePeer?: unknown }).usagePeer : undefined;

package/src/cli/console.ts

@@ -9,12 +9,14 @@ import { reviewResult } from "./console-review.ts";
 import { syncPermissionDefaults, permissionDefaultText, approvalFrom, initialConsoleState, keyTable, notify, paint, permissionText, plural, pruneApprovals, reduceConsole, renderConsoleLines, resolveColor, stateTone, streamTokens, wrapStreamTokens, terminalText, wrap, captureConsoleSelection, selectedPanelRow, appendEvent, FIRST_KEYS, LAST_KEYS } from "./console-state.ts";
 import type { ConsoleEffect, ConsoleEvent, Detail, Tone } from "./console-state.ts";
 import type { BusEvent } from "../hub/bus.ts";
-import { consoleNeeds, attentionFacts } from "./attention.ts";
+import { consoleNeeds, attentionFacts, attentionResults } from "./attention.ts";
 import { loadPetConfig } from "./pet-config.ts";
 import { CHARACTER_IDS, petGlyphs, petSize } from "../pet/frame.ts";
 import { activeNotice, consoleFooterRows } from "./console-state.ts";
+import { pasteFlow, questionRows } from "./console-question.ts";
 import { characterAttentionLine } from "./attention.ts";
 import { projectRoomStatus } from "../rooms/status.ts";
+import { LIVE_TEST_PERSON_REFUSAL } from "./identity.ts";
 
 export interface ConsoleTerminal {
   columns: number; rows: number; isTTY: boolean; isRaw?: boolean;
@@ -208,6 +210,10 @@ export async function runConsole(options: ConsoleOptions): Promise<void> {
           ...(usageTask !== undefined ? [client.request({ t: "usage", by: "peer", task: usageTask }, 5000)] : [])]);
       })() : undefined;
       if (!active) return;
+      // #1053 T4: the person's own read of the open questions, asked only of a hub whose status lists the `questions` feature: an older hub is never sent a request it does not know.
+      const hasQuestions = Array.isArray(replies[0]?.status?.features) && replies[0].status.features.includes("questions");
+      const questionReply = hasQuestions ? await client.request({ t: "questions" }, 3000) : undefined;
+      if (!active) return;
       const [status, budget, tasks, queue, ready, settings] = replies;
       captureConsoleSelection(state);
       try {
@@ -219,6 +225,15 @@ export async function runConsole(options: ConsoleOptions): Promise<void> {
           state.petCharacter = pet.character ?? "stai"; state.petSize = pet.size; state.petGlyphs = petGlyphs(pet.glyphs);
         }
       } catch { /* retain running console presentation while a config file is unreadable */ }
+      if (questionReply?.ok === true) {
+        const rows = questionRows(questionReply.questions);
+        // A set the person has not been told about gets one stream line with no question text: A answers it, or ahub answer.
+        const seen = new Set(state.questionsSeen ?? []);
+        for (const row of rows) if (!seen.has(row.set) && state.questionsSeen !== undefined) stream({ text: `  ? ${row.peer} asks ${plural(row.questions.length, "question")}: A answers it here, or ahub answer ${row.set}`, peer: row.peer, kind: "question", tone: "attention" });
+        state.questionsSeen = rows.map(row => row.set);
+        state.questions = rows;
+        if (state.questionFlow && !rows.some(row => row.set === state.questionFlow!.set)) { state.questionFlow = undefined; notice("that question is no longer open"); }
+      } else if (questionReply?.ok === false) state.questions = [];
       if (status.status?.tasks && status.ok !== false) state.taskCounts = status.status.tasks;
       if (status.status && status.ok !== false) state.pendingRestart = Array.isArray(status.status.pendingRestart) ? status.status.pendingRestart : [];
       if (status.status && status.ok !== false) state.retainedConfig = Array.isArray(status.status.retainedConfig) ? status.status.retainedConfig : [];
@@ -241,6 +256,12 @@ export async function runConsole(options: ConsoleOptions): Promise<void> {
       if (status.status && status.ok !== false) {
         state.taskWip = status.status.taskWip ?? {};
         state.attentionFacts = attentionFacts(status.status.attentionItems);
+        // #1054: unread results (a run a person started that settled), ids and peers only. A result the person has not been told about gets one stream line with no text.
+        const unread = attentionResults(status.status.attentionItems);
+        const seenResults = new Set(state.resultsSeen ?? []);
+        for (const result of unread) if (!seenResults.has(result.id) && state.resultsSeen !== undefined) stream({ text: `  ✓ ${result.peer ?? "a peer"} finished a run you started: ahub results --read ${result.id}`, ...(result.peer ? { peer: result.peer } : {}), kind: "result", tone: "info" });
+        state.resultsSeen = unread.map(result => result.id);
+        state.results = unread;
         state.storageBlocked = !!status.status.deliveryError;
         state.recoveryNeed = status.status.recovery ? { id: status.status.recovery.operationId, running: true } : undefined;
       }
@@ -344,6 +365,36 @@ export async function runConsole(options: ConsoleOptions): Promise<void> {
       } else stream({ text: `  ${action.peer} never-ask default ${action.confirmed ? "enabled" : "cancelled for this hub"}`, kind: "permission_default", peer: action.peer, tone: "attention" });
       await refresh(); draw(); return;
     }
+    if (action.type === "answer") {
+      const result = await client.request({ t: "answer", surface: "console", questionSet: action.set, answers: action.answers }, 5000);
+      if (!active) return;
+      if (result.ok === false) notice(String(result.error ?? "the answer was refused"));
+      else notify(state, `answered ${action.set}`, Date.now(), "success");
+      await refresh(); draw(); return;
+    }
+    if (action.type === "peer_takeover") {
+      if (options.liveTest) { notice(LIVE_TEST_PERSON_REFUSAL); draw(); return; }
+      let result: any;
+      try { result = await client.request({ t: "peer_takeover", peer: action.peer, standbyId: action.standbyId }, 5000); }
+      catch {
+        notice("peer takeover result is unconfirmed; inspect ahub status before retrying; takeover may already have started");
+        await refresh(); draw(); return;
+      }
+      if (!active) return;
+      const transportError = String(result.error ?? "");
+      if (result.ok === false && (transportError === "hub connection closed" || transportError === "hub request could not be sent" || /^no answer from the hub within \d+ s$/.test(transportError))) {
+        notice("peer takeover result is unconfirmed; inspect ahub status before retrying; takeover may already have started");
+        await refresh(); draw(); return;
+      }
+      if (result.ok !== true) notice(String(result.error ?? "peer takeover was refused"));
+      else if (result.outcome !== "requested" || result.standbyId !== action.standbyId) notice("peer takeover result was not confirmed; refresh ahub status");
+      else {
+        const message = `${action.peer}: old session detached; standby attachment requested`;
+        stream({ text: message, peer: action.peer, kind: "peer_takeover", tone: "attention" });
+        notify(state, message, Date.now(), "attention");
+      }
+      await refresh(); draw(); return;
+    }
     if (action.type === "permit") {
       client.send({ t: "permit", surface: "console", id: action.id, ...(action.option ? { option: action.option } : {}) });
       if (!action.option) stream({ text: `  ! denial requested for permission ${action.id}`, kind: "permission", tone: "failure" });
@@ -434,6 +485,8 @@ export async function runConsole(options: ConsoleOptions): Promise<void> {
             state.attentionMessages = []; state.attentionSelection = undefined;
             if (state.help && state.mode === "panels") { draw(); return; }
             if (state.confirm?.type === "permission_default") { draw(); return; }
+            // #1053: while the person types an `o` answer a paste is that answer's text, never the command line's; pasteFlow keeps only printable characters, so a pasted Enter, Esc or digit cannot send, leave or pick.
+            if (state.questionFlow) { state.questionFlow = pasteFlow(state.questionFlow, text.replace(/\x1b\[20[01]~/g, "")); draw(); return; }
             if (state.settingsEdit) {
               const edit = state.settingsEdit;
               if (edit.phase === "value" || edit.phase === "reason") state.settingsEdit = { ...edit, text: (edit.text + terminalText(text.replace(/\x1b\[20[01]~/g, "")).replace(/[\r\n]/g, " ")).slice(0, 1000) };

package/src/cli/handoff-args.ts

@@ -1,16 +1,25 @@
 // Argument parsing for `ahub task handoff` (#604, agent-hub#1030). Pure: argv in, one request or a usage line out, so main.ts stays a thin dispatcher and every form is testable without a daemon.
 import { CLASSES } from "../hub/board.ts";
+import { HANDOFF_KEY } from "../hub/handoff.ts";
 
-export const HANDOFF_USAGE = "usage: ahub task handoff --project <root|id> [<class>] <title...> [--path <p>]... [--issue <n>] [--task <n>] [--detail <text>] [--json] [--color=auto|always|never]";
+export const HANDOFF_USAGE = "usage: ahub task handoff --list | --sync | --project <root|id> [<class>] <title...> [--path <p>]... [--issue <n>] [--task <n>] [--detail <text>] [--duplicate-ok <reason>] [--key <uuid>] [--json] [--color=auto|always|never]";
 
-export interface HandoffCliRequest { project: string; title: string; class?: string; detail?: string; paths?: string[]; issue?: number; task?: number }
+/** `--list` and `--sync` are the person's views of the handoffs this project made (#734): the list shows each one's age and whether its target is reachable, the sync asks the targets now. */
+export type HandoffCliView = { view: "list" | "sync" };
+export interface HandoffCliRequest { project: string; title: string; class?: string; detail?: string; paths?: string[]; issue?: number; task?: number; duplicate_ok?: string; handoffKey?: string }
 
 /** `operands` is argv after `task handoff`, presentation flags already removed. A first word that is a class name is the class, said out loud by the caller (the documented short form). */
-export function parseHandoffArgs(operands: readonly string[]): HandoffCliRequest | { usage: string } {
+export function parseHandoffArgs(operands: readonly string[]): HandoffCliRequest | HandoffCliView | { usage: string } {
+  if (operands.includes("--list") || operands.includes("--sync")) {
+    // A view takes no other operand: `--list --project x` would read as filing a handoff and listing at once, which is neither.
+    const views = operands.filter(arg => arg === "--list" || arg === "--sync");
+    if (operands.length !== views.length || new Set(views).size !== 1) return { usage: HANDOFF_USAGE };
+    return { view: views[0] === "--list" ? "list" : "sync" };
+  }
   const one: Record<string, string> = {}, paths: string[] = [], rest: string[] = [];
   for (let i = 0; i < operands.length; i++) {
     const arg = operands[i]!;
-    if (arg === "--project" || arg === "--detail" || arg === "--issue" || arg === "--task" || arg === "--path") {
+    if (arg === "--project" || arg === "--detail" || arg === "--issue" || arg === "--task" || arg === "--path" || arg === "--duplicate-ok" || arg === "--key") {
       const value = operands[++i];
       if (value === undefined || value.startsWith("--")) return { usage: HANDOFF_USAGE };
       if (arg === "--path") paths.push(value); else { if (Object.hasOwn(one, arg)) return { usage: HANDOFF_USAGE }; one[arg] = value; }
@@ -23,5 +32,6 @@ export function parseHandoffArgs(operands: readonly string[]): HandoffCliRequest
   if (!project || !title) return { usage: HANDOFF_USAGE };
   if (one["--issue"] !== undefined && !/^[1-9]\d{0,9}$/.test(one["--issue"])) return { usage: `${HANDOFF_USAGE}\n--issue is the target repository's issue number` };
   if (one["--task"] !== undefined && !/^[1-9]\d{0,9}$/.test(one["--task"])) return { usage: `${HANDOFF_USAGE}\n--task is this project's own task id` };
-  return { project, title, ...(classed ? { class: rest[0]! } : {}), ...(one["--detail"] !== undefined ? { detail: one["--detail"] } : {}), ...(paths.length ? { paths } : {}), ...(one["--issue"] !== undefined ? { issue: Number(one["--issue"]) } : {}), ...(one["--task"] !== undefined ? { task: Number(one["--task"]) } : {}) };
+  if (one["--key"] !== undefined && !HANDOFF_KEY.test(one["--key"])) return { usage: `${HANDOFF_USAGE}\n--key is the key a handoff that was not confirmed named (a lowercase UUID v4): the same request with it is filed once` };
+  return { project, title, ...(classed ? { class: rest[0]! } : {}), ...(one["--detail"] !== undefined ? { detail: one["--detail"] } : {}), ...(paths.length ? { paths } : {}), ...(one["--issue"] !== undefined ? { issue: Number(one["--issue"]) } : {}), ...(one["--task"] !== undefined ? { task: Number(one["--task"]) } : {}), ...(one["--duplicate-ok"] !== undefined ? { duplicate_ok: one["--duplicate-ok"] } : {}), ...(one["--key"] !== undefined ? { handoffKey: one["--key"] } : {}) };
 }

package/src/cli/handoff-output.ts

@@ -19,7 +19,20 @@ export function renderHandoffReceipt(receipt: unknown, columns?: number): Span[]
 export function renderHandoffs(data: unknown, columns?: number): Span[][] {
   const rows: any[] = Array.isArray((data as any)?.handoffs) ? (data as any).handoffs : [];
   if (!rows.length) return [[s("no handoffs: hand work that belongs to another project with `ahub task handoff --project <root|id> <title...>`", "muted")]];
-  return [...heading(`Handoffs (${rows.length})`, columns), ...grid(["PROJECT", "TASK", "STATE", "PR", "BY", "TITLE"], rows.map(row => [
+  // #734: a row from a hub that has no age or reach (an older daemon) shows "-" for both, never a guess.
+  const reach = (row: any): Span => {
+    const word = row.reach === "reachable" || row.reach === "unreachable" || row.reach === "moved" ? row.reach : undefined;
+    if (word === undefined) return s("-", "muted");
+    return s(word === "reachable" ? "reachable" : word === "moved" ? "moved" : "unreachable", word === "reachable" ? "success" : "attention");
+  };
+  const down = rows.filter(row => row.reach === "unreachable" || row.reach === "moved" ? typeof row.cause === "string" : false);
+  return [...heading(`Handoffs (${rows.length})`, columns), ...grid(["PROJECT", "TASK", "STATE", "AGE", "REACH", "PR", "BY", "TITLE"], rows.map(row => [
     s(String(row.remoteProject ?? "?").slice(0, 24), "issueRef"), s(`#${num(row.remoteTask)}`, "taskRef"), s(String(row.state ?? "?"), STATE_TONE[row.state]),
-    s(typeof row.pr === "number" ? `#${row.pr}` : "-"), s(String(row.originPeer ?? "?")), s(String(row.title ?? ""))]), columns)];
+    s(typeof row.age === "string" ? row.age : "-", "muted"), reach(row),
+    s(typeof row.pr === "number" ? `#${row.pr}` : "-"), s(String(row.originPeer ?? "?")), s(String(row.title ?? ""))]), columns),
+    // The cause of each unreachable or moved target, once per target and with its next step, so the column stays narrow and the person still learns what to run.
+    ...[...new Map(down.map(row => [String(row.remoteProject), String(row.cause)])).entries()].map(([project, cause]) => [s(`${String(project).slice(0, 24)}: ${cause.slice(0, 200)}`, "attention")]),
+    // A sync that did not finish in time: the pass keeps running, so the list above is the state so far and the person is told what to run to read the rest.
+    ...(typeof (data as any)?.cause === "string" && (data as any)?.synced === false ? [[s(String((data as any).cause), "attention")]] : []),
+    ...((data as any)?.syncing === true ? [[s(`catch-up still running for ${num((data as any).pending)} target${(data as any).pending === 1 ? "" : "s"}: run \`ahub task handoff --list\` in a minute`, "attention")]] : [])];
 }

package/src/cli/help.ts

@@ -23,9 +23,8 @@ const SECTIONS: [string, [usage: string, description: string][]][] = [
     ["ahub up [--unattended] [--no-console] [--no-agents]", "start the daemon, then ask it to start this project's default agents (start.agents, claude and codex unless chosen at setup; one line each, a refusal names the manual command; --no-agents skips them), then enter console in an interactive terminal"],
     ["ahub console [--panels] [--color=auto|always|never]", "enter the human console; P cycles built-in pet characters/off; exiting leaves the daemon running"],
     ["ahub console --no-pet", "turn off attention for this session; combines with --panels and --color"],
-    ["ahub pet --window [--close]", "start or close the macOS floating window, from a person's terminal"],
     ["ahub pet [--short]", "read attention without connecting; --short prints ahub!N only when action is needed"],
-    ["ahub pet --palette <blue|teal|violet|ochre>", "save the floating window's base color to pet.palette in .agenthub/config.local.json"],
+    ["ahub pet --palette <blue|teal|violet|ochre>", "retired floating-window option: run acon ui and open Mini"],
     ["ahub sdlc status [task] | explain <task> [--json] [--color=auto|always|never] | export <task> | record <task> <receipt-json>", "read head-bound lifecycle gates and the next actor/action; status and explain are open to any agent as a public view (private tasks stay stubs), export and record are person only; export stays JSON"],
     ["ahub sdlc queue <owner/repo> | release <owner/repo> [live-issue...] [--json] [--color=auto|always|never]", "read-only merge and release evidence; open to any agent as public readback of the checkout's repositories, never an authorization"],
     ["ahub sdlc merge <task> [--dry-run] [--json] [--color=auto|always|never]", "guarded squash merge of an approved task at its approved head after every gate is re-read; follows sdlc.toml auto_merge (off, dry-run, on); --dry-run only reports (person or conductor)"],
@@ -39,7 +38,7 @@ const SECTIONS: [string, [usage: string, description: string][]][] = [
     ["ahub sdlc release-assign <task> <revision> <release-id|none> <reason...>", "assign approved/in-flight work without changing execution"],
     ["ahub sdlc costs [owner/repo] [--json] [--color=auto|always|never]", "read bounded planner cost metrics for linked merged PRs"],
     ["ahub sdlc metrics [--since <YYYY-MM-DD|ISO time>] [--json] [--color=auto|always|never]", "read SDLC metrics and control band tiers from board history (planner or person; read-only)"],
-    ["ahub backlog groom | return <task> <revision> <reason...> [--json] [--color=auto|always|never]", "read grooming findings or return accepted untouched work to backlog (planner/person)"],
+    ["ahub backlog groom | return <task> <revision> <reason...> [--reserved <peer> | --unreserve] [--json] [--color=auto|always|never]", "read grooming findings or return accepted untouched work to backlog (planner/person); --reserved names the peer the card is reserved for as it goes back, --unreserve clears the reservation (a person's reservation needs the person)"],
     ["ahub status [--json] [--full] [--color=auto|always|never]", "the hub, its peers, model backends and task counts, plus a specs line (errors and stale documents) when the project has design specs"],
     ["ahub status --all [--json] [--color=auto|always|never]", "show every registered project"],
     ["ahub logs [-f]", "person: last 100 hub.log lines (-f starts at 10); conductor: bounded public lines and follow while authority remains"],
@@ -65,6 +64,7 @@ const SECTIONS: [string, [usage: string, description: string][]][] = [
     ["ahub role list [--group <group>] | show <id>", "read bounded catalog guidance with layer and content hash"],
     ["ahub role assign <peer> <id> | clear <peer> [<id>]", "person only: add or clear catalog guidance, applied at the next peer start"],
     ["ahub stop <peer>", "person or configured conductor: stop a hub-owned headless peer; end TUI agents in their terminals"],
+    ["ahub peer takeover <peer> [standby-id] [--json] [--color=auto|always|never]", "person only: detach the attached session without stopping its process and request that the selected standby session attach; ahub status shows standby identities"],
     ["ahub models status [--json] [--color=auto|always|never]", "inspect local model state as labelled fields"],
     ["ahub models setup|start [--json] [--color=auto|always|never] | stop", "prepare or inspect local Ollama MLX; setup and start print the model state like status (legacy stop is explicit)"],
   ]],
@@ -74,6 +74,8 @@ const SECTIONS: [string, [usage: string, description: string][]][] = [
     ["ahub tail", "live stream of messages, states and permission requests"],
     ["ahub permission [<peer> [ask|ask-when-needed|never-ask]] [--yes]", "human only: inspect or set a running peer mode; never-ask requires --yes; config never-ask waits for console y"],
     ["ahub permit <id> <option>", "answer a permission request shown by tail (\"deny\" cancels)"],
+    ["ahub answer [<set> <question>=<option>[,<option>]... [--other [<question>=]<text>]] [--json] [--color=auto|always|never]", "person only: without operands list the questions agents asked with hub_ask; with them answer one set (every question once, known options only, other text only where offered)"],
+    ["ahub results [--unread] [--read <id> | --read-all | --unread-last] [--json] [--color=auto|always|never]", "person only: list what the runs you started left behind (unread ones marked *); --read marks one read, --read-all every one, --unread-last lights the most recent read one again; listing never marks anything"],
     ["ahub roster [--json] [--color=auto|always|never]", "every known peer, participation, start mode and retained work"],
     ["ahub roster add <peer> | remove <peer> [--yes] [--now]", "person or configured conductor: change live participation through settings; removal previews retained messages and task handoff; remove also deletes the roster key of an instance no longer declared"],
     ["ahub autonomy on [--all-projects] [--yes] | off [--all-projects] | status [--json]", "person only: apply the autonomy preset and machine default with one confirmation, optionally to every registered project; off removes fixed preset keys (manual edits included); status reports modes, floor enforcement and Claude homes; settings undo restores a live-hub project write"],
@@ -91,8 +93,8 @@ const SECTIONS: [string, [usage: string, description: string][]][] = [
     ["ahub board import github --label <label> [--milestone <milestone>] [--repo <owner/repo>]", "person or configured conductor: read bounded open issues into deduplicated Backlog; never writes GitHub"],
     ["ahub board [state | --ready] [--columns] [--release <name> | --release-id <id>] [--handoffs] [--json] [--full] [--color=auto|always|never]", "the task board, one line per task at a terminal width; --full: whole titles and SDLC advice; --ready: proposed tasks with nothing left to wait for; --handoffs: what this project handed to other projects and the last state each reported"],
     ["ahub task propose [--class <c> | <class>] <title...> [--owner <peer>] [--path <p>]... [--after <id>]... [--urgent] [--needs-network] [--needs-worktree] [--backlog] [--detail <text>]", "put a task on the board; --needs-network keeps it away from a peer whose shell has none; --needs-worktree keeps it away from a sandboxed peer unless the hub can make the task worktree for it (it makes it, commits and pushes at done); a first word that names a class is taken as the class; while a task named by --after is not approved yet, --owner reserves the task for that peer, offered to it first once it is ready; otherwise --owner assigns it now"],
-    ["ahub task handoff --project <root|id> [<class>] <title...> [--path <p>]... [--issue <n>] [--task <n>] [--detail <text>] [--json] [--color=auto|always|never]", "person only: register work that belongs to ANOTHER project that runs agent-hub on that project's board (an ownerless proposal its own roles take from there); the target must be registered and running, nothing is queued; a feature or behavior change first needs a spec issue there (--issue); its state changes show in ahub board --handoffs (an agent that hands off gets them as task messages)"],
-    ["ahub backlog list [--json] [--full] [--color=auto|always|never] | add <class> <title...> | plan <id> <revision> <fields-json> <reason...> | pin <id> <revision> true|false <reason...> | undo <id> <revision> [--json] [--color=auto|always|never]", "person only: plan work with a reason; {} records a note-only revision, fields.sdlc sets backlog repo/issue identity and clears old spec acceptance; preserve pins/frozen scope and refuse stale edits; list is by rank (--json: raw listing)"],
+    ["ahub task handoff --list | --sync | --project <root|id> [<class>] <title...> [--path <p>]... [--issue <n>] [--task <n>] [--detail <text>] [--duplicate-ok <reason>] [--key <uuid>] [--json] [--color=auto|always|never]", "person only: register work that belongs to ANOTHER project that runs agent-hub on that project's board (an ownerless proposal its own roles take from there); the target must be registered and running, nothing is queued; a feature or behavior change first needs a spec issue there (--issue), and an issue that already has an open task there is refused with those ids unless --duplicate-ok <reason>; a handoff the target did not confirm is reported as outcome_unknown with a key, and --key <uuid> files the same request once; --list shows each handoff with its age and whether its target is reachable (reachable, unreachable with the cause, or moved), and --sync asks every target now instead of at the next 5-minute pass; its state changes show in ahub board --handoffs (an agent that hands off gets them as task messages)"],
+    ["ahub backlog list [--json] [--full] [--color=auto|always|never] | add <class> <title...> | plan <id> <revision> <fields-json> <reason...> | pin <id> <revision> true|false <reason...> | person <id> <revision> true|false <reason...> | undo <id> <revision> [--json] [--color=auto|always|never]", "person only: plan work with a reason; {} records a note-only revision, fields.sdlc sets backlog repo/issue identity and clears old spec acceptance; preserve pins/frozen scope and refuse stale edits; person marks a leg only the person can run (live receipts, their accounts or approvals): no agent is offered it, auto pull and the idle sweep skip it, and it counts toward no planner WIP; list is by rank and shows it as waiting on the person (--json: raw listing)"],
     ["ahub release new <name> <goal> <order> | list | show <name> | plan <name> <revision> <dates-json> | activate|freeze|ship|drop <name> <revision> [--json] [--color=auto|always|never]", "person only, except show (any agent, public metadata): planned UTC millisecond dates and phased scope; ship records a time after approval, never tags or publishes"],
     ["ahub backlog split <id> <revision> <parts-json> <reason...> [--json] [--color=auto|always|never]", "person only: stage2..8 child prerequisites; original task retains integration, undo refuses used or changed children"],
     ["ahub backlog pull-ready <id> <revision> <reason...> [--json] [--color=auto|always|never]", "person only: reserve an eligible WIP slot before routing; pending unowned work can be undone"],
@@ -159,6 +161,7 @@ const SECTIONS: [string, [usage: string, description: string][]][] = [
     ["ahub memory sync [--remote <private git url>] | machine [--label <name>]", "sync hub memory with your other machines through a private git remote (a person's), or show or name this machine"],
     ["ahub memory import claude-mem [--db <path>] [--limit N] [--restart] | dedupe [--apply] | suggestions | confirm|reject <id>", "copy the hub's notes from claude-mem into hub memory (a person's); review the model's suggested edges"],
     ["ahub memory decay [--days N] [--json]", "person only: list long-term entries older than N days (default 90) that no open goal links; review only, nothing is changed"],
+    ["ahub memory declined [--json]", "person only: list declined physical outbound row ids and safe rule labels; never shows row text; reports incomplete scans explicitly"],
     ["ahub memory profile-check [--json]", "read-only check of the running hubs' memory bindings against their memory profiles; exits 1 when one is not ready"],
     ["ahub goal [list] [--all] | show <id> [--json]", "long-term tasks: state, which machine holds each and until when, linked board tasks"],
     ["ahub goal new <title> [--milestone <text>]... [--depends <id>]... [--shared] | link <id> <task> | state <id> <state> | done <id> | take <id> [--force]", "a person's changes to long-term tasks (link also the configured conductor's); take --force voids other machines' claims"],

package/src/cli/identity.ts

@@ -17,6 +17,7 @@ export const LIVE_TEST_PERSON_REFUSAL = "live-test cannot write person-attribute
 export function liveTestRefusal(command: string, args: readonly string[], context: { repairedFresh?: boolean } = {}): boolean {
   if (command === "sdlc" && (args[0] === "authorize-release" || args[0] === "plan-review" || args[0] === "release-assign" || args[0] === "merge" || args[0] === "train" && args[1] !== "report")) return true;
   if (args.some(arg => arg === "--as-user" || arg.startsWith("--as-user="))) return true;
+  if (command === "pet" && (args.includes("--window") || args.includes("--palette"))) return false;
   const sub = command === "recovery" ? recoveryAction(args) : args.find(arg => arg !== "--json");
   return ["task", "role", "goal", "deliverables", "source", "broker", "schedule", "intake"].includes(command)
     || (command === "room" && !["list", "status"].includes(sub ?? ""))
@@ -33,7 +34,13 @@ export function liveTestRefusal(command: string, args: readonly string[], contex
     || (command === "specs" && args[0] === "stamp")
     // #1057: removing a worktree and its branch is the person's own act, in their own terminal; no delegation, live-test or otherwise, may confirm a tidy.
     || (command === "worktrees" && args.some(arg => arg === "--confirm" || arg.startsWith("--confirm=")))
-    || (command === "agents" && !args.every(arg => arg === "--json"));
+    || (command === "agents" && !args.every(arg => arg === "--json"))
+    // #1053: an answer is the person's choice, recorded as the person's; an agent that could run it through `--live-test` would answer its own hub_ask as the person. Any operand answers (the set, a pick, --other); a bare listing stays allowed.
+    || (command === "answer" && args.some(arg => arg !== "--json" && arg !== "--full" && !arg.startsWith("--color=")))
+    // #1054: a receipt is the person's record that they read a result and clears their unread need; no delegation, live-test or otherwise, may write one. A plain listing stays allowed.
+    || (command === "results" && args.some(arg => arg === "--read" || arg.startsWith("--read=") || arg === "--read-all" || arg === "--unread-last"))
+    // A takeover is a person-authored lifecycle decision; never let an agent delegate it through --live-test.
+    || command === "peer";
 }
 
 export type CliIdentity =
@@ -139,9 +146,9 @@ export function classifyPeerCommand(command: string, args: readonly string[], ca
   if (command === "recovery" && recoveryAction(args) === "reattach") return "console";
   const native = catalog?.definitionOf(command) ?? definitionOf(command);
   if (native?.cli.personOnlyFlags?.some(flag => args.includes(flag))) return "console";
-  if (command === "pet" && args.includes("--window")) return "console";
   if (command === "permission" || command === "watch") return "console";
   if (args.some((arg) => arg === "--as-user" || arg.startsWith("--as-user="))) return "console";
+  if (command === "pet" && (args.includes("--window") || args.includes("--palette"))) return "allowed";
   if (conductorOperation(command,args)) return "conductor";
   if (command === "stop") return "console";
   if (command === "sdlc" && ["release-guard", "release-guard-hook"].includes(args[0] ?? "")) return "allowed";
@@ -187,6 +194,7 @@ export function classifyPeerCommand(command: string, args: readonly string[], ca
 
 /** No argument text is included: notices and refusal logs must not copy task text or credentials. */
 export function cliCommandLabel(command: string, args: readonly string[], catalog?: ProjectAdapterCatalog): string {
+  if (command === "peer") return args[0] === "takeover" ? "peer takeover" : "peer";
   if (command === "backlog") return ["list", "add", "pull", "pull-ready", "split", "return", "plan", "pin", "undo"].includes(args[0] ?? "") ? `backlog ${args[0]}` : "backlog";
   if (command === "board" && args[0] === "import") return "board import";
   // #508: the registry's two forms are named in the audit and in a refusal, never their operands (a path or a URL can carry a secret).
@@ -210,10 +218,12 @@ export function cliCommandLabel(command: string, args: readonly string[], catalo
   if (command === "usage") return args[0] === "limits" || args[0] === "total" ? `usage ${args[0]}` : "usage";
   if (command === "deliverables") return "deliverables";
   if (command === "title") return "title";
+  // #1054: a result id is the hub's, but the audit names the action only, never the id.
+  if (command === "results") return ["--read-all", "--unread-last"].find(flag => args.includes(flag))?.slice(2) ? `results ${["--read-all", "--unread-last"].find(flag => args.includes(flag))!.slice(2)}` : args.includes("--read") || args.some(arg => arg.startsWith("--read=")) ? "results read" : "results";
   if (command === "specs") return ["list", "check", "covers", "stamp"].includes(args[0] ?? "") ? `specs ${args[0]}` : "specs";
   // #1057: the audit names the subcommand and whether it confirms, never a path, a branch or a fingerprint.
   if (command === "worktrees") return args[0] === "tidy" ? (args.some(arg => arg === "--confirm" || arg.startsWith("--confirm=")) ? "worktrees tidy confirm" : "worktrees tidy") : "worktrees";
-  if (!(catalog?.definitionOf(command) ?? definitionOf(command)) && !["upgrade", "restart", "recovery", "recovery-run", "help", "--help", "--version", "version", "completion", "projects", "ui", "manager", "setup", "init", "daemon", "up", "console", "stop", "models", "say", "queue", "tail", "watch", "budget", "board", "task", "review", "remember", "ask", "route", "pause", "resume", "permit", "permission", "settings", "roster", "status", "pet", "logs", "export", "report", "research", "memory", "goal", "bench", "sdlc", "role", "facts", "check-path", "turns", "undo", "kill", "down", "reset", "doctor", "agents", "source", "broker", "schedule", "intake", "learn", "study"].includes(command)) return "unknown";
+  if (!(catalog?.definitionOf(command) ?? definitionOf(command)) && !["upgrade", "restart", "recovery", "recovery-run", "help", "--help", "--version", "version", "completion", "projects", "ui", "manager", "setup", "init", "daemon", "up", "console", "stop", "models", "say", "queue", "tail", "watch", "budget", "board", "task", "review", "remember", "ask", "route", "pause", "resume", "permit", "answer", "permission", "results", "settings", "roster", "status", "pet", "logs", "export", "report", "research", "memory", "goal", "bench", "sdlc", "role", "facts", "check-path", "turns", "undo", "kill", "down", "reset", "doctor", "agents", "source", "broker", "schedule", "intake", "learn", "study"].includes(command)) return "unknown";
   if (["task", "queue", "budget", "route", "recovery", "models", "projects", "research", "memory", "goal", "bench", "agents", "roster", "settings"].includes(command)) {
     const sub = command === "bench" || command === "memory" || command === "goal" ? args.find((arg) => arg !== "--json") : args[0];
     if (sub && ["propose", "show", "assign", "unassign", "escalate", "cancel", "claim", "label", "list", "add", "resolve", "resume", "set", "execution", "explain", "status", "abort", "dispose", "reattach", "setup", "start", "stop", "remove", "discard", "export", "backfill", "addons", "run", "report", "compare", "search", "graph", "promote", "demote", "forget", "supersede", "dedupe", "decay", "rebuild", "sync", "machine", "import", "suggestions", "confirm", "reject", "new", "link", "state", "done", "take", "trust"].includes(sub)) return `${command} ${sub}`;