@miadi/chronicle-tui 0.6.0 → 0.7.0

package/README.md

@@ -34,6 +34,8 @@ 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 |
 
@@ -95,6 +97,28 @@ miadi-chronicle --url https://miadi.tail3b11eb.ts.net
 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;AAuHD,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,qBAg8ClC"}
+{"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";
@@ -598,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";
@@ -685,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") {
@@ -704,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) => {
@@ -971,6 +1091,8 @@ export function App(props) {
                         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 }) }));
@@ -1023,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));