@miadi/chronicle-tui 0.5.0 → 0.7.0

package/README.md

@@ -34,6 +34,9 @@ On Termux, install with `--ignore-scripts`. Node 22 or later.
 | `!` | the chronicle's attention board: every open item, newest asked first, filtered by `/`. `e` on an item opens its episode |
 | `c` | talking circles: the ceremonies held in the episode in focus, the circles gathered for it, yours, the others |
 | `v` | hold a Miadi review in the episode (writer token) |
+| `i` | the episode's inquiries and, when you may write, the shelf: Enter attaches one, a dry run first, `y` confirms |
+| `t` | the episode's companion seat (Mia) through tide: the plan first, `y` runs it only when it would act, `A` asks again archiving the running session |
+| `L` | relate episodes: `L` marks the one in focus, move to the other, `L` again, say why (relates to or continues from, one way or both). Esc forgets the mark |
 | `?` | all keys · `q` quits |
 
 Under 90 columns (a phone, a narrow split) one pane shows at a time: the list
@@ -84,10 +87,38 @@ miadi-chronicle --url https://miadi.tail3b11eb.ts.net
   `POST /api/chronicle/attention`, and the wheel is reported, never assumed.
 - **A review** (`v`) posts to `POST /api/chronicle/episodes/{ref}/reviews`;
   with your person token its talking circle opens in your name.
+- **Lineage** (`L`) is the room's lineage form
+  (`POST /api/chronicle/episodes/{ref}/lineage`): the door writes
+  `episode.yaml`, puts the edge and its words on the wheel, and lands the
+  commit. Offered when the episode door says it would take the write
+  (`capabilities.mint`). The episode card shows what each episode continues
+  from and relates to.
 
 Write actions declare `effect: "write"` and are offered only when the app said
 it would record them.
 
+## Inquiries and the companion seat
+
+Both show what would happen before anything does, and act only on `y`:
+Enter never confirms, so a double press cannot start a seat or land a commit.
+
+- **Inquiries** (`i`) are the room's Inquiries card
+  (`GET /api/chronicle/episodes/{ref}/inquiry`): what the episode holds, and
+  for a writer the shelf, newest first, `/` to filter (`?q=`). Enter on a
+  shelf item asks for its thread (`owner/repo#number`, optional), posts a dry
+  run and shows it in the card's words, with the copy's size and what the door
+  noticed. `y` attaches: the door relates, copies, registers on the wheel and
+  commits. A refused dry run offers nothing to confirm.
+- **The companion seat** (`t`) is the cockpit's "Open Mia for this episode"
+  (`POST /api/tide/companion`, jgwill/Miadi#714). The plan comes first: the
+  session, tide's state, the listener, the commands and the starter prompt.
+  `y` runs that plan, only when it would act (`create`, a re-arm that starts a
+  listener or relaunches, `archive then create`); a seat already listening, a
+  refusal or a pane running something else offer nothing. Archiving the
+  running session is the person's word, so `A` asks for a new plan with it.
+  The run takes up to a few minutes and ends with `tmux attach -t <session>`.
+  The browser never types into the seat's pane; tide does, once it is idle.
+
 ## Talking circles
 
 `c` opens the circles, from the episode in focus: the ceremonies held in it

package/dist/App.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../src/App.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAiD,MAAM,OAAO,CAAA;AAIrE,OAAO,EAML,KAAK,eAAe,EAIrB,MAAM,cAAc,CAAA;AAmErB,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;IACpC,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC7B;AAoHD,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,qBAi6ClC"}
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../src/App.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAiD,MAAM,OAAO,CAAA;AAIrE,OAAO,EAML,KAAK,eAAe,EAIrB,MAAM,cAAc,CAAA;AAqErB,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;IACpC,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC7B;AAuHD,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,qBAirDlC"}

package/dist/App.js

@@ -19,6 +19,8 @@ import { DEFAULT_ACTIONS, actionFor, enterCeremony, enterCircle, } from "./actio
 import { TOKEN_ENV, answerAttention, connectApi } from "./api.js";
 import { BOARD_LABELS, ROOM_LABELS, answeredMessage, checkAnswer, filterBoard, loadBoard, loadEpisodePanel, panelView, readOnlyLabel, } from "./attention.js";
 import { CEREMONY_TYPES, DIARY_PHASES, DIRECTIONS, ENTRY_TYPES, PHASE_LABELS, ceremonyHeadline, ceremonyLines, circleEntries, closeCeremony, mayWitness, openCeremony, readCeremony, readCircle, scrollTo, speak, splitLearnings, typeLabel, whenOf, witness, writeDiary, } from "./circles.js";
+import { THREAD, attachInquiry, attachedMessage, previewLines, readInquiries } from "./inquiries.js";
+import { companionLines, companionPlan, planActs, ranMessage, runCompanion } from "./tide.js";
 import { VISITOR, wheelDoors, loadChronicle, loadDetail, loadText, openUrl, qrLines, search, visibleRows, } from "./data.js";
 import { ageOf, clamp, fileView, filterRows, formatDate, screenLineOf, windowOf, wrapSegments, } from "./model.js";
 import { clean, cleanLine, link } from "./text.js";
@@ -108,6 +110,7 @@ export function App(props) {
         reader: null,
         access: VISITOR,
         mayAnswer: false,
+        mayMint: false,
         board: null,
         boardSel: 0,
         history: [],
@@ -203,7 +206,7 @@ export function App(props) {
                 return;
             try {
                 const reader = await api.me();
-                const mayAnswer = await api.mayAnswer();
+                const [mayAnswer, mayMint] = await Promise.all([api.mayAnswer(), api.mayMint()]);
                 if (!live)
                     return;
                 // Signing in can show more episodes (community ones), so the selection is kept by name, not by row.
@@ -211,7 +214,7 @@ export function App(props) {
                 const keep = before.s.view === "attention" ? undefined : before.currentRow?.name;
                 const keepItem = before.boardItem;
                 details.current.clear();
-                set({ reader, mayAnswer, access: { signedIn: Boolean(reader), mayWrite: mayAnswer } });
+                set({ reader, mayAnswer, mayMint, access: { signedIn: Boolean(reader), mayWrite: mayAnswer } });
                 const after = derive();
                 const listSel = keep ? after.filtered.findIndex((row) => row.name === keep) : -1;
                 const boardSel = keepItem ? after.board.findIndex((item) => item.episode === keepItem.episode && item.id === keepItem.id) : -1;
@@ -329,8 +332,22 @@ export function App(props) {
             api: s.api,
             reader: s.reader,
             mayAnswer: s.mayAnswer,
+            mayMint: s.mayMint,
+            relateFrom: s.relateFrom,
+            setRelateFrom: (name) => set({ relateFrom: name }),
+            reload: reloadChronicle,
         };
     };
+    /** Read the chronicle again after a write landed in it, keeping the episode in focus. */
+    async function reloadChronicle() {
+        const keep = derive().currentRow?.name;
+        const chronicle = await loadChronicle(root);
+        details.current.clear();
+        set({ chronicle, status: ui.current.status });
+        const index = keep ? derive().filtered.findIndex((row) => row.name === keep) : -1;
+        if (index !== -1)
+            set({ listSel: index, status: ui.current.status });
+    }
     const openFile = (name, file, from, line) => {
         const s = ui.current;
         const text = loadText(s.chronicle.root, name, file, s.access);
@@ -583,6 +600,76 @@ export function App(props) {
             await reloadCeremony(handle);
         }, (error) => set({ status: cleanLine(error.message) }));
     };
+    // ── inquiries and the companion seat: a plan or a dry run, then `y` ───────
+    const reloadInquiries = async (handle) => {
+        const entry = ui.current.overlays.find((candidate) => candidate.id === handle);
+        if (!entry || entry.overlay.type !== "inquiries" || !ui.current.api)
+            return;
+        const view = await readInquiries(ui.current.api, entry.overlay.episode, entry.overlay.query);
+        updateById(handle, (o) => (o.type === "inquiries" ? { ...o, view, error: undefined, selected: clamp(o.selected, view.shelf?.items.length ?? 0) } : o));
+    };
+    const filterInput = (handle, episode, query) => ({
+        type: "input",
+        title: "Filter the shelf by name",
+        hint: "Enter filters; an empty filter shows the newest.",
+        value: query,
+        allowEmpty: true,
+        submit: async (value) => {
+            const q = value.trim();
+            const view = await readInquiries(ui.current.api, episode, q);
+            updateById(handle, (o) => (o.type === "inquiries" ? { ...o, view, query: q, selected: 0 } : o));
+            return `${view.shelf?.items.length ?? 0} of ${view.shelf?.total ?? 0} on the shelf${q ? ` for “${cleanLine(q)}”` : ""}, newest first.`;
+        },
+    });
+    const attachInput = (handle, episode, label, item) => ({
+        type: "input",
+        title: `Attach ${cleanLine(item.artefact)} to ${label}`,
+        hint: "Its thread (optional, owner/repo#number). Enter shows what attaching does; nothing is written yet.",
+        value: item.issue ?? "",
+        allowEmpty: true,
+        submit: async (value) => {
+            const issue = value.trim();
+            if (issue && !THREAD.test(issue))
+                throw new Error("A thread is owner/repo#number, or nothing.");
+            const api = ui.current.api;
+            const preview = await attachInquiry(api, episode, { artefact: item.artefact, issue, dryRun: true });
+            return {
+                next: {
+                    type: "confirm",
+                    title: `Attach ${cleanLine(item.artefact)} to ${label}?${issue ? ` · ${issue}` : ""}`,
+                    lines: previewLines(preview, item.artefact),
+                    ...(preview.ok === false ? {} : { yes: "attach" }),
+                    run: async () => attachedMessage(await attachInquiry(api, episode, { artefact: item.artefact, issue, dryRun: false }), item.artefact),
+                    after: () => reloadInquiries(handle),
+                },
+            };
+        },
+    });
+    const askCompanion = (handle, archive) => {
+        const entry = ui.current.overlays.find((candidate) => candidate.id === handle);
+        if (!entry || entry.overlay.type !== "companion" || !ui.current.api)
+            return;
+        const episode = entry.overlay.episode;
+        updateById(handle, (o) => (o.type === "companion" ? { ...o, archive, busy: "plan", answer: undefined, error: undefined } : o));
+        companionPlan(ui.current.api, episode, { archive }).then((answer) => updateById(handle, (o) => (o.type === "companion" ? { ...o, busy: undefined, answer } : o)), (error) => updateById(handle, (o) => (o.type === "companion" ? { ...o, busy: undefined, error: cleanLine(error.message) } : o)));
+    };
+    const runPlan = (handle) => {
+        const entry = ui.current.overlays.find((candidate) => candidate.id === handle);
+        if (!entry || entry.overlay.type !== "companion" || !ui.current.api)
+            return;
+        const { episode, archive, answer } = entry.overlay;
+        if (!planActs(answer))
+            return set({ status: `Nothing to run: ${cleanLine(answer?.plan?.state ?? "no plan on screen")}.` });
+        updateById(handle, (o) => (o.type === "companion" ? { ...o, busy: "run", error: undefined } : o));
+        set({ status: "Opening the seat: up to a few minutes. Esc leaves this open; the outcome comes here." });
+        runCompanion(ui.current.api, episode, { archive }).then((ran) => {
+            updateById(handle, (o) => (o.type === "companion" ? { ...o, busy: undefined, ran } : o));
+            set({ status: ranMessage(ran) });
+        }, (error) => {
+            updateById(handle, (o) => (o.type === "companion" ? { ...o, busy: undefined, error: cleanLine(error.message) } : o));
+            set({ status: cleanLine(`The seat did not open: ${error.message}`) });
+        });
+    };
     // ── keys ─────────────────────────────────────────────────────────────────
     // A paste into an input arrives whole, line breaks kept (bracketed paste).
     const pasteActive = ui.current.overlays[ui.current.overlays.length - 1]?.overlay.type === "input";
@@ -645,7 +732,11 @@ export function App(props) {
                 if (!value.trim() && !top.allowEmpty)
                     return updateTop({ ...top, error: "Nothing to send yet." });
                 updateTop({ ...top, busy: true, error: undefined });
-                top.submit(value, choices.map((c) => c.values[c.index])).then(async (message) => {
+                top.submit(value, choices.map((c) => c.values[c.index])).then(async (result) => {
+                    // A two-part form: the next input takes this one's place.
+                    if (typeof result !== "string")
+                        return updateTop(result.next);
+                    const message = result;
                     set({ status: cleanLine(message), overlays: ui.current.overlays.slice(0, -1) });
                     try {
                         await top.after?.();
@@ -666,6 +757,9 @@ export function App(props) {
         if (top) {
             if (top.type === "help")
                 return closeTop();
+            // An act under way is not left half-seen.
+            if (top.type === "confirm" && top.busy)
+                return;
             if (key.escape || input === "q" || input === "h" || key.backspace || key.leftArrow)
                 return closeTop();
             if (top.type === "doors") {
@@ -685,6 +779,51 @@ export function App(props) {
             }
             if (top.type === "qr" && input === "i")
                 return updateTop({ ...top, invert: !top.invert });
+            if (top.type === "confirm") {
+                // Only an act the dry run allowed: a refusal offers nothing to confirm.
+                if (input !== "y" || !top.run || !top.yes)
+                    return;
+                const handle = topHandle();
+                const run = top.run;
+                updateTop({ ...top, busy: true, error: undefined });
+                run().then(async (message) => {
+                    set({ status: cleanLine(message), overlays: ui.current.overlays.filter((entry) => entry.id !== handle) });
+                    try {
+                        await top.after?.();
+                    }
+                    catch (error) {
+                        set({ status: cleanLine(`Done, but the refresh failed: ${error.message}`) });
+                    }
+                }, (error) => updateById(handle, (o) => (o.type === "confirm" ? { ...o, busy: false, error: cleanLine(error.message) } : o)));
+                return;
+            }
+            if (top.type === "inquiries") {
+                const handle = topHandle();
+                const items = top.view?.shelf?.items ?? [];
+                if (key.downArrow || input === "j")
+                    return updateTop({ ...top, selected: clamp(top.selected + 1, items.length) });
+                if (key.upArrow || input === "k")
+                    return updateTop({ ...top, selected: clamp(top.selected - 1, items.length) });
+                if (input === "/" && top.view?.attach)
+                    return void openOverlay(filterInput(handle, top.episode, top.query));
+                const item = items[clamp(top.selected, items.length)];
+                if (item && (key.return || input === "l" || key.rightArrow)) {
+                    if (item.wovenHere)
+                        return set({ status: `${cleanLine(item.artefact)} is already woven into this episode.` });
+                    return void openOverlay(attachInput(handle, top.episode, top.label, item));
+                }
+                return;
+            }
+            if (top.type === "companion") {
+                const handle = topHandle();
+                if (top.busy || top.ran)
+                    return;
+                if (input === "A")
+                    return askCompanion(handle, !top.archive);
+                if (input === "y")
+                    return runPlan(handle);
+                return;
+            }
             if (top.type === "circles" && top.index) {
                 const entries = circleEntries(top.index);
                 const step = (from, by) => {
@@ -877,6 +1016,8 @@ export function App(props) {
             return move(1_000_000, PLAIN_KEY);
         if (key.return || key.rightArrow || input === "l")
             return forward();
+        if (key.escape && s.relateFrom)
+            return set({ relateFrom: undefined, status: "No longer relating." });
         if (key.escape || key.leftArrow || input === "h" || key.backspace)
             return back();
         if (input === "?")
@@ -933,13 +1074,25 @@ export function App(props) {
     const linesOf = (text, cap) => Math.min(cap, Math.max(1, wrapSegments([{ text, style: "text" }], textWidth).length));
     const titleLines = d.currentRow ? linesOf(`${d.currentRow.number ?? "·"} ${d.currentRow.title}`, 3) : 0;
     const goalLines = goal ? linesOf(goal, compact ? 6 : 8) : 0;
-    const fixedLines = titleLines + 2 + (openHere ? 1 : 0) + goalLines + (d.detail?.error ? 1 : 0) + 1;
+    // The episodes this one continues from or relates to, by number where it has one.
+    const lineage = d.currentRow?.lineage.length
+        ? ["continues from", "relates to", "branch of"]
+            .map((kind) => {
+            const targets = d.currentRow.lineage.filter((link) => link.kind === kind).map((link) => (link.number !== undefined ? String(link.number) : link.target));
+            return targets.length ? `${kind} ${targets.join(", ")}` : "";
+        })
+            .filter(Boolean)
+            .join(" · ")
+        : "";
+    const fixedLines = titleLines + 2 + (openHere ? 1 : 0) + (lineage ? 1 : 0) + goalLines + (d.detail?.error ? 1 : 0) + 1;
     const fileWindow = windowOf(d.files, clamp(s.fileSel, d.files.length), Math.max(1, bodyHeight - fixedLines));
-    const detailPane = (_jsx(Box, { flexDirection: "column", width: rightWidth, height: bodyHeight, overflow: "hidden", paddingLeft: compact ? 0 : 1, children: _jsx(Box, { flexDirection: "column", flexShrink: 0, children: s.view === "attention" ? (d.boardItem ? itemBody(d.boardItem, rightWidth - 1) : _jsx(Text, { color: "gray", children: "Nothing selected." })) : d.currentRow ? (_jsxs(_Fragment, { children: [_jsx(Box, { height: titleLines, overflow: "hidden", flexShrink: 0, children: _jsxs(Text, { bold: true, wrap: "wrap", children: [_jsx(Text, { color: "yellow", children: d.currentRow.number ?? "·" }), " ", d.currentRow.title] }) }), _jsxs(Text, { color: "gray", wrap: "truncate-end", children: [[formatDate(d.currentRow.date), d.currentRow.status, d.currentRow.type].filter(Boolean).join(" · "), d.currentRow.structured ? "" : " · no episode.yaml", d.currentRow.audience === "community" ? " · community" : ""] }), _jsxs(Text, { color: "green", wrap: "truncate-end", children: ["reading: ", d.currentRow.readings.direction, " \u00B7 ", d.currentRow.readings.theme, " \u00B7 ", d.currentRow.readings.arc] }), openHere ? _jsxs(Text, { color: "yellow", children: ["? ", openHere, " open question", openHere === 1 ? "" : "s", " \u00B7 a"] }) : null, goal ? (_jsx(Box, { height: goalLines, overflow: "hidden", flexShrink: 0, children: _jsx(Text, { wrap: "wrap", children: goal }) })) : null, d.detail?.error ? _jsx(Text, { color: "red", children: cleanLine(d.detail.error) }) : null, _jsxs(Text, { color: "gray", wrap: "truncate-end", children: ["── ", d.files.length, d.files.length >= MAX_FILES ? "+" : "", " file", d.files.length === 1 ? "" : "s", s.view === "files" ? "" : " · Enter", " ──"] }), fileWindow.items.map((file, index) => {
+    const detailPane = (_jsx(Box, { flexDirection: "column", width: rightWidth, height: bodyHeight, overflow: "hidden", paddingLeft: compact ? 0 : 1, children: _jsx(Box, { flexDirection: "column", flexShrink: 0, children: s.view === "attention" ? (d.boardItem ? itemBody(d.boardItem, rightWidth - 1) : _jsx(Text, { color: "gray", children: "Nothing selected." })) : d.currentRow ? (_jsxs(_Fragment, { children: [_jsx(Box, { height: titleLines, overflow: "hidden", flexShrink: 0, children: _jsxs(Text, { bold: true, wrap: "wrap", children: [_jsx(Text, { color: "yellow", children: d.currentRow.number ?? "·" }), " ", d.currentRow.title] }) }), _jsxs(Text, { color: "gray", wrap: "truncate-end", children: [[formatDate(d.currentRow.date), d.currentRow.status, d.currentRow.type].filter(Boolean).join(" · "), d.currentRow.structured ? "" : " · no episode.yaml", d.currentRow.audience === "community" ? " · community" : ""] }), _jsxs(Text, { color: "green", wrap: "truncate-end", children: ["reading: ", d.currentRow.readings.direction, " \u00B7 ", d.currentRow.readings.theme, " \u00B7 ", d.currentRow.readings.arc] }), openHere ? _jsxs(Text, { color: "yellow", children: ["? ", openHere, " open question", openHere === 1 ? "" : "s", " \u00B7 a"] }) : null, lineage ? _jsxs(Text, { color: "cyan", wrap: "truncate-end", children: ["\u2197 ", lineage] }) : null, goal ? (_jsx(Box, { height: goalLines, overflow: "hidden", flexShrink: 0, children: _jsx(Text, { wrap: "wrap", children: goal }) })) : null, d.detail?.error ? _jsx(Text, { color: "red", children: cleanLine(d.detail.error) }) : null, _jsxs(Text, { color: "gray", wrap: "truncate-end", children: ["── ", d.files.length, d.files.length >= MAX_FILES ? "+" : "", " file", d.files.length === 1 ? "" : "s", s.view === "files" ? "" : " · Enter", " ──"] }), fileWindow.items.map((file, index) => {
                         const isSelected = s.view === "files" && fileWindow.start + index === clamp(s.fileSel, d.files.length);
                         return (_jsxs(Text, { wrap: "truncate-start", inverse: isSelected, color: file.kind === "text" ? "blue" : "gray", children: [cleanLine(file.relativePath), file.kind === "text" ? "" : ` · ${file.kind}`] }, file.relativePath));
                     })] })) : (_jsx(Text, { color: "gray", children: "Nothing selected." })) }) }));
     const fileBody = s.open ? (_jsxs(Box, { flexDirection: "column", height: bodyHeight, overflow: "hidden", children: [s.open.empty ? _jsx(Text, { color: "gray", children: "(empty file)" }) : null, s.open.view.lines.slice(s.open.scroll, s.open.scroll + bodyHeight).map((line, index) => (_jsx(Segments, { segments: line.segments, selectedRef: s.open.refSel }, s.open.scroll + index)))] })) : null;
+    /** How many screen rows these lines take inside an overlay. */
+    const rowsOf = (texts) => Math.max(1, texts.reduce((sum, text) => sum + wrapSegments([{ text, style: "text" }], Math.max(10, columns - 4)).length, 0));
     // Children never shrink: a fixed-height box clips what does not fit instead
     // of squeezing rows to zero height, where Ink draws them over each other.
     const box = (color, children) => (_jsx(Box, { flexDirection: "column", borderStyle: "round", borderColor: color, paddingLeft: 1, paddingRight: 1, flexGrow: 1, height: bodyHeight, overflow: "hidden", children: _jsx(Box, { flexDirection: "column", flexShrink: 0, children: children }) }));
@@ -992,6 +1145,32 @@ export function App(props) {
         if (top.type === "item") {
             return box("yellow", _jsxs(_Fragment, { children: [itemBody(top.item, columns - 4), _jsxs(Text, { color: "gray", wrap: "wrap", children: [top.item.state === "open" ? (s.mayAnswer ? "Enter answers · " : `${readOnlyLabel(TOKEN_ENV)} · `) : "", "e opens its episode \u00B7 Esc"] })] }));
         }
+        if (top.type === "confirm") {
+            const room = Math.max(1, bodyHeight - 2 - (2 + (top.busy ? 1 : 0) + (top.error ? 1 : 0)));
+            return box("red", _jsxs(_Fragment, { children: [_jsx(Text, { bold: true, wrap: "truncate-end", children: cleanLine(top.title) }), _jsx(Box, { flexDirection: "column", height: Math.min(room, rowsOf(top.lines.map((line) => cleanLine(line.text)))), overflow: "hidden", flexShrink: 0, children: _jsx(Box, { flexDirection: "column", flexShrink: 0, children: top.lines.map((line, index) => (_jsx(Text, { wrap: "wrap", color: line.tone === "warn" ? "yellow" : line.tone === "meta" ? "gray" : undefined, children: cleanLine(line.text) }, index))) }) }), top.busy ? _jsx(Text, { color: "gray", children: "Working\u2026" }) : null, top.error ? _jsx(Text, { color: "red", wrap: "wrap", children: cleanLine(top.error) }) : null, _jsxs(Text, { wrap: "truncate-end", children: [top.yes && !top.busy ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: "red", bold: true, children: "y" }), " ", top.yes, " \u00B7", " "] })) : null, _jsx(Text, { color: "gray", children: top.busy ? "" : "Esc cancels" })] })] }));
+        }
+        if (top.type === "inquiries") {
+            const view = top.view;
+            const items = view?.shelf?.items ?? [];
+            const wovenRows = view ? Math.max(1, view.woven.length) : 0;
+            const room = Math.max(1, bodyHeight - 2 - (1 + Math.min(wovenRows, 6) + (view?.attach ? 1 : 0) + 1));
+            const shelfWindow = windowOf(items, clamp(top.selected, items.length), room);
+            return box("blue", _jsxs(_Fragment, { children: [_jsxs(Text, { bold: true, wrap: "truncate-end", children: ["Inquiries \u00B7 ", top.label] }), !view && !top.error ? _jsx(Text, { color: "gray", children: "Asking the episode's inquiry door\u2026" }) : null, top.error ? _jsx(Text, { color: "red", wrap: "wrap", children: cleanLine(top.error) }) : null, view && view.woven.length === 0 ? _jsx(Text, { color: "gray", italic: true, children: "No inquiry is woven into this episode." }) : null, view?.woven.slice(0, 6).map((w) => (_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: "blue", children: "\u25C7" }), " ", w.artefact, _jsxs(Text, { color: "gray", children: [w.issue ? ` · ${w.issue}` : "", w.freshness ? ` · ${w.freshness}` : "", w.exists ? "" : " · missing from the shelf"] })] }, w.artefact))), view?.attach ? (_jsxs(Text, { color: "gray", wrap: "truncate-end", children: ["\u2500\u2500 the shelf \u00B7 ", items.length, " of ", view.shelf?.total ?? 0, ", newest first", top.query ? ` · “${cleanLine(top.query)}”` : "", view.shelf?.unavailable ? " · unavailable on the app's host" : "", " \u2500\u2500"] })) : null, shelfWindow.items.map((item, index) => {
+                        const isSelected = shelfWindow.start + index === clamp(top.selected, items.length);
+                        return (_jsxs(Text, { wrap: "truncate-end", inverse: isSelected, color: item.wovenHere ? "gray" : undefined, children: [cleanLine(item.artefact), _jsxs(Text, { color: "gray", children: [" · ", item.modified.slice(0, 10), item.issue ? ` · ${item.issue}` : "", item.episodes.length ? ` · in episode ${item.episodes.join(", ")}` : "", item.wovenHere ? " · already here" : ""] })] }, item.artefact));
+                    }), _jsx(Text, { color: "gray", wrap: "truncate-end", children: view?.attach ? "↑↓ · ⏎ attach · / filter · Esc" : view ? "Attaching needs a writer the app accepts · Esc" : "Esc" })] }));
+        }
+        if (top.type === "companion") {
+            const shown = top.ran ?? top.answer;
+            const lines = shown ? companionLines(shown) : [];
+            const acts = !top.ran && planActs(top.answer);
+            const toneColor = { state: "yellow", meta: "gray", warn: "yellow", error: "red", step: "green" };
+            const nothing = !acts && !top.busy && !top.ran && Boolean(shown?.plan?.state);
+            // The plan is clipped above the keys, so `y` and Esc stay on screen however long the starter prompt is.
+            const room = Math.max(1, bodyHeight - 2 - (2 + (top.busy ? 1 : 0) + (top.error ? 1 : 0) + (nothing ? 1 : 0)));
+            const planRows = Math.min(room, rowsOf(lines.map((line) => line.text)));
+            return box("red", _jsxs(_Fragment, { children: [_jsxs(Text, { bold: true, wrap: "truncate-end", children: ["Companion \u00B7 ", top.label, " \u00B7 mia ", _jsxs(Text, { color: "gray", children: ["\u00B7 archive the running session: ", top.archive ? "yes" : "no"] })] }), top.busy === "plan" ? _jsx(Text, { color: "gray", children: "Asking tide for the plan\u2026" }) : null, top.busy === "run" ? _jsx(Text, { color: "yellow", children: "Opening the seat\u2026 (up to a few minutes)" }) : null, top.error ? _jsx(Text, { color: "red", wrap: "wrap", children: cleanLine(top.error) }) : null, _jsx(Box, { flexDirection: "column", height: planRows, overflow: "hidden", flexShrink: 0, children: _jsx(Box, { flexDirection: "column", flexShrink: 0, children: lines.map((line, index) => (_jsx(Text, { wrap: "wrap", color: line.tone ? toneColor[line.tone] : undefined, children: line.text }, index))) }) }), _jsxs(Text, { wrap: "truncate-end", children: [acts && !top.busy ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: "red", bold: true, children: "y" }), " runs this plan \u00B7", " "] })) : null, !top.ran && !top.busy ? _jsxs(Text, { color: "gray", children: ["A ", top.archive ? "keeps" : "archives", " the running session and asks again \u00B7 "] }) : null, _jsx(Text, { color: "gray", children: "Esc" })] }), nothing ? _jsx(Text, { color: "gray", children: "Nothing to run for this plan." }) : null] }));
+        }
         if (top.type === "circles") {
             const entries = top.index ? circleEntries(top.index) : [];
             const listWindow = windowOf(entries, clamp(top.selected, entries.length), Math.max(1, bodyHeight - 4));
@@ -1102,6 +1281,6 @@ export function App(props) {
                     ? "…"
                     : "read-only"
         : "";
-    return (_jsxs(Box, { flexDirection: "column", height: rows, width: columns, children: [_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { bold: true, color: "yellow", children: "miadi-chronicle" }), " ", _jsx(Text, { color: "gray", children: where }), readerLabel ? _jsx(Text, { color: s.reader ? "green" : "gray", children: ` · ${readerLabel}` }) : null] }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: s.inputMode ? "yellow" : "gray", children: "/ " }), cleanLine(s.query), s.inputMode ? _jsx(Text, { inverse: true, children: " " }) : null, " ", s.view === "attention" ? (_jsx(Text, { color: "gray", children: "attention" })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: s.searchMode === "title" ? "yellow" : "gray", children: "title" }), _jsx(Text, { color: "gray", children: compact ? "|" : " | " }), _jsx(Text, { color: s.searchMode === "full" ? "yellow" : "gray", children: compact ? "full" : "full text" })] })), s.view === "list" ? _jsxs(Text, { color: "gray", children: [" \u00B7 ", d.filtered.length] }) : null, s.view === "attention" ? _jsxs(Text, { color: "gray", children: [" \u00B7 ", d.board.length] }) : null] }), _jsx(Box, { flexDirection: "row", height: bodyHeight, overflow: "hidden", children: body }), _jsx(Text, { color: "gray", wrap: "truncate-end", children: s.status }), _jsxs(Text, { wrap: "truncate-end", children: [(s.overlays.length ? [] : available).map((action) => (_jsxs(Text, { children: [_jsx(Text, { color: action.effect === "write" ? "red" : "yellow", children: action.key === "Enter" ? "⏎" : action.key }), " ", action.label, "  "] }, action.id))), _jsx(Text, { color: "gray", children: hints })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", height: rows, width: columns, children: [_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { bold: true, color: "yellow", children: "miadi-chronicle" }), " ", _jsx(Text, { color: "gray", children: where }), readerLabel ? _jsx(Text, { color: s.reader ? "green" : "gray", children: ` · ${readerLabel}` }) : null] }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: s.inputMode ? "yellow" : "gray", children: "/ " }), cleanLine(s.query), s.inputMode ? _jsx(Text, { inverse: true, children: " " }) : null, " ", s.view === "attention" ? (_jsx(Text, { color: "gray", children: "attention" })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: s.searchMode === "title" ? "yellow" : "gray", children: "title" }), _jsx(Text, { color: "gray", children: compact ? "|" : " | " }), _jsx(Text, { color: s.searchMode === "full" ? "yellow" : "gray", children: compact ? "full" : "full text" })] })), s.view === "list" ? _jsxs(Text, { color: "gray", children: [" \u00B7 ", d.filtered.length] }) : null, s.relateFrom ? _jsxs(Text, { color: "red", children: [" \u00B7 relating ", episodeLabel(s.relateFrom), " \u2192 L"] }) : null, s.view === "attention" ? _jsxs(Text, { color: "gray", children: [" \u00B7 ", d.board.length] }) : null] }), _jsx(Box, { flexDirection: "row", height: bodyHeight, overflow: "hidden", children: body }), _jsx(Text, { color: "gray", wrap: "truncate-end", children: s.status }), _jsxs(Text, { wrap: "truncate-end", children: [(s.overlays.length ? [] : available).map((action) => (_jsxs(Text, { children: [_jsx(Text, { color: action.effect === "write" ? "red" : "yellow", children: action.key === "Enter" ? "⏎" : action.key }), " ", action.label, "  "] }, action.id))), _jsx(Text, { color: "gray", children: hints })] })] }));
 }
 //# sourceMappingURL=App.js.map