@litfamily/litopencode 1.0.20 → 1.0.22

package/dist/tui/mission-text.js

@@ -2,7 +2,7 @@
 // (Hangul and emoji take two cells), truncation, the gradient bar, and the coloured segments the TUI
 // renders as spans. Every frame of motion is drawn from a MotionFrame, so all of it is testable here.
 import { ease, mixHex, rowEntryStart, seg, slideIn, motionTiming } from "./mission-motion.js";
-import { missionRowKeys, missionStatus } from "./mission-model.js";
+import { currentStepIndex, missionRowKeys, missionStatus, stepName } from "./mission-model.js";
 /** Panel box width in cells, and the content width inside its border and one cell of padding per side. */
 export const panelWidth = 36;
 export const panelInnerWidth = panelWidth - 4;
@@ -49,6 +49,7 @@ export function paletteFromTheme(theme, mode = "dark") {
     const neutral = mode === "light" ? "#f2f2f2" : "#1c1c1c";
     return {
         primary: pick("primary", "#ff6337"),
+        secondary: pick("secondary", "#ff2d95"),
         accent: pick("accent", "#b48cff"),
         info: pick("info", "#0aa6c2"),
         warning: pick("warning", "#ffaf3c"),
@@ -182,27 +183,34 @@ export function progressBar(ratio, cells, palette, sweep = -1) {
         segments.push({ text: "─".repeat(cells - used), fg: palette.borderSubtle });
     return segments;
 }
-function microBar(ratio, palette) {
-    const filled = Math.max(0, Math.min(5, Math.round(Math.max(0, Math.min(1, ratio)) * 5)));
+/** The stage colour ramp: the theme's primary through secondary to accent, so every theme keeps its own feel. */
+export function stageColor(index, count, palette) {
+    return gradientAt([palette.primary, palette.secondary, palette.accent], count <= 1 ? 0 : index / (count - 1));
+}
+function microBar(ratio, palette, cells = 5) {
+    const filled = Math.max(0, Math.min(cells, Math.round(Math.max(0, Math.min(1, ratio)) * cells)));
     const segments = [];
-    for (let index = 0; index < 5; index += 1) {
-        segments.push(index < filled ? { text: "▰", fg: gradientAt([palette.primary, palette.accent], index / 4) } : { text: "▱", fg: palette.borderSubtle });
+    for (let index = 0; index < cells; index += 1) {
+        segments.push(index < filled ? { text: "▰", fg: gradientAt([palette.primary, palette.secondary, palette.accent], cells <= 1 ? 0 : index / (cells - 1)) } : { text: "▱", fg: palette.borderSubtle });
     }
     return segments;
 }
 function countText(view) {
     return view.progress === undefined ? "" : `${view.progress.done}/${view.progress.total}`;
 }
-/** The step state to draw: during the completion moment WORK and REVIEW flip to done one after the other. */
-function shownState(step, view, frame) {
+/**
+ * The step state to draw. During the completion moment the stage that was running and every stage
+ * after it flip to done one after the other, 60 ms apart.
+ */
+function shownState(step, index, frame) {
     const t = frame.celebrate;
-    if (t === undefined || step.state !== "done" || step.id === "plan")
+    const from = frame.celebrateFrom;
+    if (t === undefined || from === undefined || step.state !== "done" || index < from)
         return { state: step.state, doneMix: step.state === "done" ? 1 : 0 };
-    const at = step.id === "work" ? motionTiming.workDoneAt : motionTiming.reviewDoneAt;
-    const mix = ease.inOutCubic(seg(t, at, motionTiming.crossfade));
+    const at = motionTiming.workDoneAt + (index - from) * (motionTiming.reviewDoneAt - motionTiming.workDoneAt);
     if (t < at)
-        return { state: step.id === "work" ? "now" : "todo", doneMix: 0 };
-    return { state: "done", doneMix: mix };
+        return { state: index === from ? "now" : "todo", doneMix: 0 };
+    return { state: "done", doneMix: ease.inOutCubic(seg(t, at, motionTiming.crossfade)) };
 }
 function pillStyle(state, palette, warn) {
     if (state === "done")
@@ -212,64 +220,120 @@ function pillStyle(state, palette, warn) {
     const level = state === "warn" ? Math.max(warn, 0.5) : warn;
     return { fg: palette.onFill, bg: mixHex(palette.info, palette.warning, level), bold: true };
 }
-function blendStyle(from, to, amount, palette) {
-    if (amount <= 0)
-        return from;
-    if (amount >= 1)
-        return to;
-    const bgFrom = from.bg ?? palette.mixBase;
-    const bgTo = to.bg ?? palette.mixBase;
-    return { fg: mixHex(from.fg, to.fg, amount), bg: mixHex(bgFrom, bgTo, amount), bold: amount < 0.5 ? from.bold : to.bold };
-}
-function stepLabel(step, state, view) {
-    const name = step.id.toUpperCase();
-    const count = step.id === "work" && view.progress !== undefined ? countText(view) : "";
-    if (state === "done")
-        return [name, count, "✓"].filter((part) => part !== "").join(" ");
+/** A light pass over the running stage: once when the map moves forward, and during the completion moment. */
+export function stageFlash(frame) {
+    if (frame.stageFrom !== undefined && frame.t <= motionTiming.shimmer)
+        return -0.2 + 1.4 * seg(frame.t, 0, motionTiming.shimmer);
+    return shimmerAt(frame);
+}
+/**
+ * The colour of the connector into stage `index`. It carries the stage ramp once the stage before it is
+ * behind the map, and fills in turn, 60 ms apart, when the map has just moved forward.
+ */
+export function linkColor(view, index, frame, palette, idle) {
+    const before = view.steps[index - 1];
+    if (before === undefined)
+        return idle;
+    const state = shownState(before, index - 1, frame).state;
+    if (state !== "done" && state !== "skip")
+        return idle;
+    const color = stageColor(index - 0.5, view.steps.length, palette);
+    if (frame.stageFrom === undefined || index <= frame.stageFrom)
+        return color;
+    return mixHex(idle, color, ease.outCubic(seg(frame.t, (index - frame.stageFrom - 1) * motionTiming.stagger, motionTiming.entry)));
+}
+/**
+ * One stage of the breadcrumb. Behind the map a stage is its name in its ramp colour with `✓` (or `–`
+ * when skipped); ahead it is a muted name; the running stage is a filled capital pill followed by an
+ * optional `bar`-cell bar and the count.
+ */
+export function crumb(view, index, frame, palette, bar, flash = -1) {
+    const step = view.steps[index];
+    const { state, doneMix } = shownState(step, index, frame);
+    const name = stepName(step.id, view);
+    const counted = step.id === "work" && view.progress !== undefined;
+    if (state === "done") {
+        const color = stageColor(index, view.steps.length, palette);
+        return [{ text: [name, counted ? countText(view) : "", "✓"].filter((part) => part !== "").join(" "), fg: doneMix >= 1 ? color : mixHex(index === frame.celebrateFrom ? palette.info : palette.muted, color, doneMix) }];
+    }
     if (state === "skip")
-        return `${name} –`;
-    if (state === "warn")
-        return [name, "⚑", count].filter((part) => part !== "").join(" ");
-    return [name, state === "now" ? count : ""].filter((part) => part !== "").join(" ");
+        return [{ text: `${name} –`, fg: palette.muted }];
+    if (state === "todo")
+        return [{ text: name, fg: palette.muted }];
+    const style = pillStyle(state, palette, frame.warn);
+    const label = ` ${name.toUpperCase()}${state === "warn" ? " ⚑" : ""} `;
+    const chars = [...label];
+    const pill = flash < 0
+        ? [{ text: label, fg: style.fg, ...(style.bg === undefined ? {} : { bg: style.bg }), bold: style.bold }]
+        : chars.map((char, position) => ({ text: char, fg: style.fg, bg: shine(style.bg ?? palette.info, palette, position / (chars.length - 1), flash, 0.3), bold: true }));
+    if (!counted)
+        return pill;
+    return [...pill, ...(bar > 0 ? [{ text: " ", fg: palette.muted }, ...microBar(frame.barRatio, palette, bar)] : []), { text: ` ${countText(view)}`, fg: palette.text, bold: true }];
+}
+const spinnerFrames = "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏";
+function clockText(seconds) {
+    const minutes = Math.floor(seconds / 60);
+    const rest = String(seconds % 60).padStart(2, "0");
+    return minutes < 60 ? `${minutes}:${rest}` : `${Math.floor(minutes / 60)}:${String(minutes % 60).padStart(2, "0")}:${rest}`;
 }
-export function stepPill(step, view, frame, palette) {
-    const { state, doneMix } = shownState(step, view, frame);
-    const before = pillStyle(step.id === "work" ? "now" : "todo", palette, frame.warn);
-    const style = state === "done" && doneMix < 1 ? blendStyle(before, pillStyle("done", palette, frame.warn), doneMix, palette) : pillStyle(state, palette, frame.warn);
-    return { text: ` ${stepLabel(step, state, view)} `, fg: style.fg, ...(style.bg === undefined ? {} : { bg: style.bg }), bold: style.bold };
+/**
+ * The live step: the running tool's name and how long it has run, `⠹ bash · 0:48`. The spinner moves
+ * with the elapsed second, so it changes only when the time does. Nothing of the tool's input is shown.
+ */
+export function liveSegments(view, frame, palette, room) {
+    if (view.live === undefined || view.complete || room < 4)
+        return [];
+    const seconds = frame.now === undefined ? undefined : Math.max(0, Math.floor((frame.now - view.live.start) / 1000));
+    const spin = [...spinnerFrames][(seconds ?? 0) % 10];
+    const time = seconds === undefined ? "" : ` · ${clockText(seconds)}`;
+    return [
+        { text: `${spin} `, fg: palette.warning },
+        { text: truncateCells(view.live.tool, Math.max(1, room - 2 - cellWidth(time))), fg: palette.text },
+        { text: time, fg: palette.muted }
+    ];
 }
 function brandPill(palette, sweep) {
     const chars = [" ", "🔥", " ", "L", "I", "T", " "];
     return chars.map((char, index) => ({ text: char, fg: palette.onFill, bg: shine(palette.primary, palette, index / (chars.length - 1), sweep, 0.3), bold: true }));
 }
-/** The chip's pill groups for a tier; the five-segment bar is appended unless `withMicroBar` is false. */
-export function chipGroups(view, frame, palette, tier, withMicroBar = true) {
-    const sweep = shimmerAt(frame);
+/**
+ * The chip's groups for a tier. The full tier is the brand and the breadcrumb around the running stage
+ * (the one before, the running one with a seven-cell bar, the one after); medium keeps the running
+ * stage and the next with a five-cell bar; tight keeps only the count.
+ */
+export function chipGroups(view, frame, palette, tier) {
     const space = { text: " ", fg: palette.muted };
-    const separator = { text: " › ", fg: palette.borderActive };
     const flame = { text: "🔥", fg: palette.text };
+    const count = view.steps.length;
+    const reached = currentStepIndex(view);
+    const current = Math.min(count - 1, Math.max(0, reached));
+    const flash = stageFlash(frame);
     const groups = [];
+    const trail = (from, to, bar) => {
+        for (let index = Math.max(0, from); index <= Math.min(count - 1, to); index += 1) {
+            const lead = index === Math.max(0, from) ? space : { text: " › ", fg: linkColor(view, index, frame, palette, palette.borderActive) };
+            groups.push([lead, ...crumb(view, index, frame, palette, bar, index === current ? flash : -1)]);
+        }
+    };
+    // A finished map keeps its last stages in view, so the completion moment can flip them in turn.
+    const anchor = reached >= count ? count - 2 : current;
     if (tier === "full") {
-        groups.push(brandPill(palette, sweep));
-        view.steps.forEach((step, index) => groups.push([index === 0 ? space : separator, stepPill(step, view, frame, palette)]));
+        groups.push(brandPill(palette, shimmerAt(frame)));
+        trail(anchor - 1, anchor + 1, 7);
     }
     else if (tier === "medium") {
         groups.push([flame]);
-        const current = view.steps.findIndex((step) => step.state === "now" || step.state === "warn");
-        const from = current >= 0 ? current : view.complete ? 1 : 0;
-        view.steps.slice(from, from + 2).forEach((step, index) => groups.push([index === 0 ? space : separator, stepPill(step, view, frame, palette)]));
+        trail(anchor, anchor + 1, 5);
     }
     else {
         groups.push([flame]);
-        const current = view.steps.find((step) => step.state === "now" || step.state === "warn") ?? view.steps[1];
-        const count = countText(view);
-        const done = view.complete && (frame.celebrate === undefined || frame.celebrate >= motionTiming.workDoneAt);
-        const value = done ? `✓ ${count}`.trim() : current.state === "warn" ? `⚑ ${count}`.trim() : count || current.id.toUpperCase();
-        const style = pillStyle(done ? "done" : current.state === "warn" ? "warn" : "now", palette, frame.warn);
+        const step = view.steps[current];
+        const shown = shownState(step, current, frame).state;
+        const done = view.complete && shown === "done";
+        const value = done ? `✓ ${countText(view)}`.trim() : step.state === "warn" ? `⚑ ${countText(view)}`.trim() : countText(view) || stepName(step.id, view).toUpperCase();
+        const style = pillStyle(done ? "done" : step.state === "warn" ? "warn" : "now", palette, frame.warn);
         groups.push([space, { text: ` ${value} `, fg: style.fg, ...(style.bg === undefined ? {} : { bg: style.bg }), bold: style.bold }]);
     }
-    if (withMicroBar && view.progress !== undefined)
-        groups.push([space, ...microBar(frame.barRatio, palette)]);
     return groups;
 }
 export function groupsWidth(groups) {
@@ -314,14 +378,20 @@ export function chipTier(view, frame, palette, budget) {
     return "tight";
 }
 /**
- * The phase chip on the right of the prompt's agent/model row: `🔥 LIT` `PLAN` › `WORK n/m` › `REVIEW`
- * and a five-segment bar, shedding labels before values as `budget` shrinks. Idle sessions render nothing.
+ * The map chip on the right of the prompt's agent/model row: `🔥 LIT  plan ✓ › WORK ▰▰▰▱▱▱▱ 3/7 › review`,
+ * then the live step when the full chip leaves room for it, shedding labels before values as `budget`
+ * shrinks. Idle sessions render nothing.
  */
 export function chipLine(view, frame, palette, budget) {
     if (!view.active)
         return [];
     const tier = chipTier(view, frame, palette, budget);
     const groups = chipGroups(view, frame, palette, tier);
+    if (tier === "full") {
+        const live = liveSegments(view, frame, palette, 24);
+        if (live.length > 0 && groupsWidth(groups) + 2 + lineWidth(live) <= budget)
+            groups.push([{ text: "  ", fg: palette.muted }, ...live]);
+    }
     const out = [];
     if (frame.celebrate !== undefined && groupsWidth(groups) + chipSparkWidth <= budget)
         out.push(...(chipSparkCells(frame.celebrate, palette) ?? []));
@@ -367,20 +437,35 @@ export function statusSegments(view, frame, palette) {
     };
     return { segments: [fade(pill, progress <= 0 ? 0 : ease.outCubic(progress), palette)], offset: Math.max(-1, slideIn(progress)) };
 }
-function stepsRow(view, frame, palette) {
-    const out = [];
-    let previousDone = false;
-    view.steps.forEach((step, index) => {
-        const { state, doneMix } = shownState(step, view, frame);
-        const live = mixHex(palette.info, palette.warning, state === "warn" ? Math.max(frame.warn, 0.5) : frame.warn);
-        const color = state === "done" ? mixHex(step.id === "work" ? palette.info : palette.muted, palette.success, doneMix) : state === "now" || state === "warn" ? live : palette.muted;
-        const glyph = state === "done" ? "✓" : state === "skip" ? "–" : state === "warn" ? "⚑" : state === "now" ? "●" : "○";
-        if (index > 0)
-            out.push({ text: " ── ", fg: previousDone ? palette.success : palette.borderSubtle });
-        out.push({ text: `${glyph} ${step.id.toUpperCase()}`, fg: color, bold: state === "now" || state === "warn" });
-        previousDone = state === "done";
-    });
-    return out;
+/**
+ * One stage of the sidebar's vertical map: `◆` behind, `◉` running in bold, `⚑` flagged, `◇` ahead,
+ * with the plan's task count or the loop's iteration on the right.
+ */
+function stepperRow(view, index, frame, palette, width) {
+    const step = view.steps[index];
+    const { state, doneMix } = shownState(step, index, frame);
+    const counted = step.id === "work" && view.progress !== undefined ? ` ${countText(view)}` : "";
+    const name = `${stepName(step.id, view)}${counted}`;
+    const note = step.id === "plan" && view.planTasks !== undefined ? `${view.planTasks} tasks` : step.id === "work" && view.iteration !== undefined ? `iter ${view.iteration}` : "";
+    const live = mixHex(palette.info, palette.warning, state === "warn" ? Math.max(frame.warn, 0.5) : frame.warn);
+    let head;
+    if (state === "done") {
+        const color = stageColor(index, view.steps.length, palette);
+        head = [{ text: "◆ ", fg: doneMix >= 1 ? color : mixHex(palette.info, color, doneMix) }, { text: name, fg: palette.text }];
+    }
+    else if (state === "now" || state === "warn") {
+        head = [{ text: `${state === "warn" ? "⚑" : "◉"} ${name}`, fg: live, bold: true }];
+    }
+    else {
+        head = [{ text: `◇ ${name}${state === "skip" ? " –" : ""}`, fg: palette.muted }];
+    }
+    if (note === "")
+        return head;
+    const room = width - cellWidth(note) - 1;
+    const used = lineWidth(head);
+    if (used > room)
+        return head;
+    return [...head, { text: " ".repeat(width - used - cellWidth(note)), fg: palette.muted }, { text: note, fg: palette.muted }];
 }
 function criterionSegment(id, status, palette) {
     if (status === "pass")
@@ -510,9 +595,9 @@ function withEmbers(rows, t, palette) {
 }
 /**
  * The sidebar mission panel: a rounded box whose border carries the state (accent while working,
- * warning on a warning, success when complete), a tiny LIT header, the goal title, the phase line,
- * the bar, the next item, criteria, warnings and the evidence timeline. Rows are at most
- * `panelInnerWidth` cells.
+ * warning on a warning, success when complete), a tiny LIT header, the goal title, the vertical stage
+ * map with its connectors, the bar, the detail line, the live step, criteria, warnings and the
+ * evidence timeline. Rows are at most `panelInnerWidth` cells.
  */
 export function missionPanel(view, frame, palette) {
     if (!view.active)
@@ -528,12 +613,22 @@ export function missionPanel(view, frame, palette) {
     rows.set("b1", []);
     if (view.goal !== undefined)
         rows.set("title", [{ text: truncateCells(view.goal.title, width), fg: palette.text, bold: true }]);
-    rows.set("steps", stepsRow(view, frame, palette));
+    view.steps.forEach((step, index) => {
+        if (index > 0) {
+            const color = linkColor(view, index, frame, palette, palette.borderSubtle);
+            rows.set(`link:${index}`, [{ text: color === palette.borderSubtle ? "┆" : "┃", fg: color }]);
+        }
+        rows.set(`step:${step.id}`, stepperRow(view, index, frame, palette, width));
+    });
     if (view.progress !== undefined)
         rows.set("bar", progressBar(frame.barRatio, width, palette, sweep));
     rows.set("b2", []);
-    if (view.next !== undefined)
-        rows.set("next", [{ text: "next ", fg: palette.muted }, { text: truncateCells(`▸ ${view.next}`, width - 5), fg: palette.text }]);
+    // The detail line: `└ task 3 · next ▸ …`, or a research run's claim counts.
+    const lead = view.detail === undefined ? "" : truncateCells(view.detail, width - 2);
+    const gap = lead !== "" && view.next !== undefined ? " · " : "";
+    const next = view.next === undefined ? "" : truncateCells(`next ▸ ${view.next}`, Math.max(0, width - 2 - cellWidth(lead) - cellWidth(gap)));
+    rows.set("detail", [{ text: "└ ", fg: palette.muted }, { text: lead + (next === "" ? "" : gap), fg: palette.muted }, ...(next === "" ? [] : [{ text: next, fg: palette.text }])]);
+    rows.set("live", liveSegments(view, frame, palette, width));
     if (view.goal !== undefined) {
         const criteria = [{ text: "crit", fg: palette.muted }];
         for (const criterion of view.goal.criteria) {
@@ -573,7 +668,7 @@ export function missionPanel(view, frame, palette) {
     const enter = frame.chipEnter ? ease.outCubic(seg(frame.t, 0, motionTiming.entry)) : 1;
     const done = view.complete ? (frame.celebrate === undefined ? 1 : ease.inOutCubic(seg(frame.celebrate, 0, motionTiming.crossfade))) : 0;
     const border = mixHex(palette.mixBase, mixHex(mixHex(palette.accent, palette.warning, frame.warn), palette.success, done), enter);
-    const phase = view.complete ? "COMPLETE" : view.phase.toUpperCase();
+    const phase = view.complete ? "COMPLETE" : stepName(view.phase, view).toUpperCase();
     const flagged = view.warnings.length > 0 && !view.complete ? " ⚑" : "";
     const bottom = view.goal !== undefined
         ? ` ${view.goal.passed}/${view.goal.total} criteria${view.complete ? " ✓" : ""} `

package/dist/tui.js

@@ -4,14 +4,15 @@ import { jsx } from "@opentui/solid/jsx-runtime";
 import { buildMissionView, lastMission, leadingNotice, missionNotices } from "./tui/mission-model.js";
 import { idleMotion, motionTiming, planMotion, sampleMotion } from "./tui/mission-motion.js";
 import { chipBudget, chipLine, homeLine, missionPanel, paletteFromTheme, panelWidth } from "./tui/mission-text.js";
-import { createLedgerReader, missionProjectRoot, readCardInput, readMissionInput } from "./tui/mission-source.js";
+import { createLedgerReader, createWorkReader, missionProjectRoot, readCardInput, readLatestResearchRun, readMissionInput } from "./tui/mission-source.js";
 import { chipShimmer, idleChipMotion, planChipMotion } from "./tui/mission-skills.js";
-import { bandCard, readBandOptions, statusCard } from "./tui/mission-band.js";
+import { bandCard, readBandOptions, readNotifyOptions, statusCard } from "./tui/mission-band.js";
 export const litOpenCodeTuiPluginId = "litopencode";
 const homeLineWidth = 69;
 const refreshDelayMs = 80;
 const ledgerPollMs = 2000;
 const toastMs = 4000;
+const liveTickMs = 1000;
 const trackedSessionLimit = 4;
 const refreshEvents = [
     "message.updated",
@@ -38,7 +39,9 @@ function lineElement(line) {
 const tui = async (api, options) => {
     const motionEnabled = options?.motion !== false;
     const band = readBandOptions(options);
+    const notify = readNotifyOptions(options);
     const readLedger = createLedgerReader();
+    const readWork = createWorkReader();
     const sessions = new Map();
     const tracked = [];
     const [revision, setRevision] = createSignal(0);
@@ -46,6 +49,7 @@ const tui = async (api, options) => {
     let frameTimer;
     let refreshTimer;
     let pollTimer;
+    let liveTimer;
     const state = () => api.state;
     const palette = () => paletteFromTheme(api.theme.current, api.theme.mode());
     // OpenCode keeps the sidebar choice in its KV store under "sidebar" ("auto" or "hide"); a child
@@ -79,20 +83,45 @@ const tui = async (api, options) => {
             }
         }, motionTiming.frameMs);
     }
+    // The live step's elapsed time is the only steady change: one tick a second while a tool runs, and
+    // no timer at all otherwise.
+    function syncLiveTick() {
+        const running = [...sessions.values()].some((entry) => entry.view.live !== undefined);
+        if (running && liveTimer === undefined)
+            liveTimer = setInterval(() => setClock(Date.now()), liveTickMs);
+        if (!running && liveTimer !== undefined) {
+            clearInterval(liveTimer);
+            liveTimer = undefined;
+        }
+    }
+    // The finish alert is off unless tui.json opts in; OpenCode's own attention settings still decide
+    // whether a desktop notification or a sound actually plays.
+    function alertFinish(notice) {
+        if (!notify.enabled)
+            return;
+        void api.attention
+            .notify({ title: "🔥 LIT complete", message: notice.message, notification: notify.desktop, sound: notify.sound ? { name: "done" } : false })
+            .catch(() => undefined);
+    }
     function refresh(sessionID) {
         const now = Date.now();
         const source = state();
-        const ledger = readLedger(missionProjectRoot(source.path));
-        const next = buildMissionView(readMissionInput(source, sessionID, ledger, now));
+        const root = missionProjectRoot(source.path);
+        const ledger = readLedger(root);
+        const next = buildMissionView(readMissionInput(source, sessionID, ledger, now, { work: readWork(root, sessionID), research: readLatestResearchRun(root) }));
         const card = readCardInput(source, sessionID);
         const entry = sessions.get(sessionID);
         const viewChanged = entry === undefined || JSON.stringify(entry.view) !== JSON.stringify(next);
         if (!viewChanged && JSON.stringify(entry.card) === JSON.stringify(card))
             return;
         if (entry !== undefined && viewChanged) {
-            const notice = leadingNotice(missionNotices(entry.view, next));
+            const notices = missionNotices(entry.view, next);
+            const notice = leadingNotice(notices);
             if (notice !== undefined)
                 api.ui.toast({ variant: notice.variant, title: notice.title, message: notice.message, duration: toastMs });
+            const finish = notices.find((candidate) => candidate.celebrate === true);
+            if (finish !== undefined)
+                alertFinish(finish);
         }
         sessions.set(sessionID, {
             view: next,
@@ -103,6 +132,7 @@ const tui = async (api, options) => {
         setClock(now);
         setRevision(revision() + 1);
         ensureFrames();
+        syncLiveTick();
     }
     function refreshTracked() {
         refreshTimer = undefined;
@@ -177,6 +207,8 @@ const tui = async (api, options) => {
             clearTimeout(refreshTimer);
         if (pollTimer !== undefined)
             clearInterval(pollTimer);
+        if (liveTimer !== undefined)
+            clearInterval(liveTimer);
         sessions.clear();
     });
     api.slots.register({
@@ -289,6 +321,7 @@ const tui = async (api, options) => {
                                     view: snapshot.view,
                                     frame: snapshot.frame,
                                     chips: snapshot.card.chips,
+                                    busy: snapshot.card.busy,
                                     ...(shimmer === undefined ? {} : { shimmer }),
                                     figures: { contextPercent: snapshot.card.contextPercent, ...(snapshot.card.branch === undefined ? {} : { branch: snapshot.card.branch }), inLane: snapshot.inLane },
                                     ...(last === undefined ? {} : { last })

package/docs/assets/readme/badge-version.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.20"><title>release: 1.0.20</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="390" transform="scale(.1)">release</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.20</text></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.22"><title>release: 1.0.22</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="390" transform="scale(.1)">release</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.22</text></g></svg>

package/docs/migration.md

@@ -23,7 +23,7 @@ This guide describes the supported migration shape for moving an OpenCode workfl
 - Use `litopencode doctor --root <workspace>` to inspect `litopencode.json` route validity and effective `lit-plan` / `lit-loop` settings without writing files.
 - Use `litopencode install --dry-run --root <workspace>` to preview the `opencode.json` plugin mutation without writing files.
 - Route fields include top-level `permissionMode` (`safe`, `balanced`, or `yolo`) plus per-agent/per-category `provider`, `model`, `variant`, `category`, `reasoningEffort`, `textVerbosity`, `thinking`, `temperature`, `topP`, `maxTokens`, `promptAppend`, `tools`, `permission`, and `providerOptions`; generated route files use `variant` as the primary effort knob while `reasoningEffort` stays available for explicit provider-level overrides. LitOpenCode keeps `topP` as its config spelling and projects it to OpenCode's native `top_p` field; this preserves nonreasoning model sampling while Astra's native Responses capability omits unsupported sampling fields.
-- Global route config loads first, project-local route config merges afterward, and effective per-agent fields override category fields. Fresh/reset lead routes use Astra with native `reasoningEffort`. GPT-6 Astra and Sol accept `low`, `medium`, `high`, `xhigh`, `max`, and `ultra`. GPT-6 Luna accepts `low`, `medium`, `high`, `xhigh`, and `max`, but not `ultra`. Previous-generation GPT-5.6 Luna accepts only `high` and `max`; `xhigh` remains unsupported for that model. Astra has no invented `-fast` alias. No-selection installs preserve user route bytes but fail before success output when a managed route is unsafe. Other model IDs remain user-owned custom routes. Existing host entries named `momus` or `litwork-reviewer` preserve explicit routes and receive Astra/xhigh only when route fields are absent. LitOpenCode does not expose Hermes-specific per-subagent overrides.
+- Global route config loads first, project-local route config merges afterward, and effective per-agent fields override category fields. Fresh/reset lead routes use Astra with native `reasoningEffort`. Each model accepts exactly the efforts OpenCode lists for it: GPT-6 Astra and GPT-6.1 Sol accept `low`, `medium`, `high`, `xhigh`, and `max`; GPT-6 Luna, GPT-6 Sol, and the GPT-5.6 rows accept `none`, `low`, `medium`, `high`, `xhigh`, and `max`. No model accepts `ultra`. A saved route set to `ultra` keeps running as `max`, `litopencode doctor` warns about it, and the next install rewrites it to `max` with a one-line notice after copying the file to `litopencode.json.litopencode-backup`. Astra has no invented `-fast` alias. No-selection installs preserve user route bytes but fail before success output when a managed route is unsafe. Other model IDs remain user-owned custom routes. Existing host entries named `momus` or `litwork-reviewer` preserve explicit routes and receive Astra/xhigh only when route fields are absent. LitOpenCode does not expose Hermes-specific per-subagent overrides.
 - Use `litopencode install --permission-prompt`, `--permission-mode balanced`, or `--yolo` only when you explicitly want LitOpenCode to reduce OpenCode approval prompts. Default installs do not relax permissions. Balanced mode allows routine automation while keeping dangerous bash patterns on ask; YOLO mode writes `permissionMode: "yolo"` and the plugin config hook allows OpenCode `bash`, `edit`, `webfetch`, and `external_directory` globally. In both balanced and YOLO modes, `task` delegation is granted only to execution-capable primary agents; subagents and `lit-plan` stay task-denied so delegation never recurses and the planner cannot select an implementation child. Existing global string/object and per-primary task policies are preserved unless they would weaken those hard deny guards; absent global task policy is not invented, and the runtime lineage guard blocks child task calls even under an explicit global allow. `lit-plan` remains agent-level edit/bash/task `deny`.
 - Restart OpenCode after changing `permissionMode`; OpenCode loads config at startup and running sessions keep the already-loaded permission policy.
 - Planning routes now produce proportionate objective-achievable checklists rather than relying on a later review pass to discover missing execution detail. Each retained item carries action/output/verification, while risky or multi-stage work receives SDD-like gates only when justified. `/review-work` accepts both draft plans (read-only `PASS`/`ITERATE`/`NEEDS-CONTEXT`) and completed work (the existing five-lane review); it never implements a draft plan.