catherd-cli 1.0.0 → 1.1.1

package/src/entry/tui/state.ts

@@ -120,8 +120,12 @@ export interface AppState {
   drafts: Record<string, Draft>;
   /** the open dialogs; only the top one is drawn and takes keys */
   dialogs: Dialog[];
-  /** the run the Runs tab has open; null shows the list */
-  run: string | null;
+  /** spec §4: the session the Runs tab has open (`key` null: "earlier runs"); null shows the sessions */
+  session: { key: string | null } | null;
+  /** the role the open session shows, by its dispatch */
+  role: { run: string; dispatchId: string } | null;
+  /** spec 1.1 §10: the milestone the open session shows, its digest */
+  milestone: { run: string; name: string } | null;
   paused: boolean;
   armed: Armed | null;
 }
@@ -145,7 +149,14 @@ export type Action =
   | { type: "saving"; name: string; on: boolean }
   | { type: "input"; value: string }
   | { type: "invalid"; error: string | null }
-  | { type: "run"; id: string | null }
+  /** opens a session of the Runs tab (`key` null: "earlier runs") */
+  | { type: "session"; key: string | null }
+  /** opens one role of the open session */
+  | { type: "role"; run: string; dispatchId: string }
+  /** opens one milestone of the open session, on its digest */
+  | { type: "milestone"; run: string; name: string }
+  /** the Runs tab goes back one level: a milestone or a role to its session, a session to the list */
+  | { type: "up" }
   | { type: "pause" }
   | { type: "arm"; what: Armed["what"]; target: string; at: number }
   | { type: "disarm" };
@@ -155,7 +166,9 @@ export const initialState = (tab: Tab = "status"): AppState => ({
   profile: null,
   drafts: {},
   dialogs: [],
-  run: null,
+  session: null,
+  role: null,
+  milestone: null,
   paused: false,
   armed: null,
 });
@@ -324,8 +337,15 @@ export function reduce(s: AppState, a: Action): AppState {
       else if (top.kind === "save" && a.type === "invalid") next = { ...top, error: a.error };
       return next === top ? s : { ...s, dialogs: [...s.dialogs.slice(0, -1), next] };
     }
-    case "run":
-      return { ...s, run: a.id, armed: null };
+    case "session":
+      return { ...s, session: { key: a.key }, role: null, milestone: null, armed: null };
+    case "role":
+      return { ...s, role: { run: a.run, dispatchId: a.dispatchId }, milestone: null, armed: null };
+    case "milestone":
+      return { ...s, milestone: { run: a.run, name: a.name }, role: null, armed: null };
+    case "up":
+      if (s.milestone) return { ...s, milestone: null, armed: null };
+      return s.role ? { ...s, role: null, armed: null } : { ...s, session: null, armed: null };
     case "pause":
       return { ...s, paused: !s.paused };
     case "arm":

package/src/entry/tui/stories.ts

@@ -1,5 +1,6 @@
 import type { ProfilePatch } from "../../domain/profile.ts";
 import type { CommandId } from "./commands.ts";
+import type { FixtureOptions } from "./fixtures.ts";
 import type { AppApi } from "./providers/app.tsx";
 import type { AppKeymap } from "./providers/keymap.tsx";
 import type { Action } from "./state.ts";
@@ -11,6 +12,8 @@ export interface Story {
   name: string;
   title: string;
   steps: Step[];
+  /** the fixtures the frame snapshots render it on (the storybook shows it on its one set) */
+  fixtures?: FixtureOptions;
 }
 
 const SHOWN: Step[] = [{ show: "default" }];
@@ -45,11 +48,40 @@ export const STORIES: Story[] = [
     steps: [{ command: "tab.status" }, { command: "app.palette" }],
   },
   { name: "help", title: "Keyboard shortcuts", steps: [{ command: "tab.status" }, { command: "app.help" }] },
-  { name: "runs", title: "Runs: the list", steps: [{ command: "tab.runs" }] },
   {
-    name: "run",
-    title: "Runs: one live run",
-    steps: [{ command: "tab.runs" }, { action: { type: "run", id: "20260926-114800-jobs-screen" } }],
+    name: "runs-empty",
+    title: "Runs: no runs yet",
+    steps: [{ command: "tab.runs" }],
+    fixtures: { runs: [], sessions: [] },
+  },
+  { name: "runs", title: "Runs: the sessions", steps: [{ command: "tab.runs" }] },
+  {
+    name: "session",
+    title: "Runs: one session with two runs, one continued elsewhere",
+    steps: [{ command: "tab.runs" }, { action: { type: "session", key: "s-auth" } }],
+  },
+  {
+    name: "session-live",
+    title: "Runs: a live session with three live roles",
+    steps: [{ command: "tab.runs" }, { action: { type: "session", key: "s-jobs" } }],
+  },
+  {
+    name: "role",
+    title: "Runs: a role opened",
+    steps: [
+      { command: "tab.runs" },
+      { action: { type: "session", key: "s-jobs" } },
+      { action: { type: "role", run: "20260926-114800-jobs-screen", dispatchId: "d1" } },
+    ],
+  },
+  {
+    name: "milestone",
+    title: "Runs: a milestone opened on its digest",
+    steps: [
+      { command: "tab.runs" },
+      { action: { type: "session", key: "s-jobs" } },
+      { action: { type: "milestone", run: "20260926-114800-jobs-screen", name: "M0" } },
+    ],
   },
 ];
 

package/src/entry/tui/text.ts

@@ -57,6 +57,18 @@ export function wrap(s: string, max: number): string[] {
   return lines;
 }
 
+/**
+ * `wrap` with a hanging indent: a line's leading spaces and list marker (`- `, `* `, `1. `) are kept on its first
+ * line, and its continuation lines are indented to match, so a wrapped bullet does not read as a new line.
+ */
+export function wrapHanging(s: string, max: number): string[] {
+  const lead = /^\s*(?:[-*+] |\d+[.)] )?/.exec(s)?.[0] ?? "";
+  const hang = width(lead);
+  if (!lead || max - hang < 1) return wrap(s, max);
+  const pad = " ".repeat(hang);
+  return wrap(s.slice(lead.length), max - hang).map((l, i) => (i === 0 ? lead : pad) + l);
+}
+
 /** `04:12`, or `1:02:03` past an hour. */
 export function clock(secs: number): string {
   const s = Math.max(0, Math.floor(secs));

package/src/entry/tui/theme.ts

@@ -109,6 +109,7 @@ export const STATE_TOKEN: Record<State, Token> = {
   warn: "warning",
   fail: "error",
   skip: "muted",
+  info: "info",
 };
 
 export type Mood = "good" | "working" | "waiting" | "failed";