@mrciphersmith/keryx 0.2.36 → 0.2.37

package/dist/cli.js

@@ -41726,7 +41726,7 @@ function harnessWave(args, deps) {
 // src/commands/shell.ts
 init_make_provider();
 init_orient();
-import { randomUUID as randomUUID17 } from "crypto";
+import { randomUUID as randomUUID18 } from "crypto";
 import * as readline2 from "readline";
 
 // src/harness/tool/builtin/ask-user-tool.ts
@@ -44799,7 +44799,7 @@ import { spawnSync as spawnSync2 } from "child_process";
 // package.json
 var package_default = {
   name: "@mrciphersmith/keryx",
-  version: "0.2.36",
+  version: "0.2.37",
   description: "Version-controlled project context for AI coding agents: code graph, architecture wiki, project memory, relevant tests, quality signals, and task flows.",
   private: false,
   publishConfig: {
@@ -44881,6 +44881,17 @@ function onKeypress(r, handler) {
 var BACKDROP_ID = "modal-backdrop";
 var PANEL_ID = "modal-panel";
 var BACKDROP_OPACITY = 0.45;
+var MODAL_PANEL_WIDTH = 72;
+var MODAL_PANEL_HEIGHT = 18;
+var MODAL_PANEL_INNER_WIDTH = MODAL_PANEL_WIDTH - 4;
+var CLOSE_HINT = "[x] esc";
+var DEFAULT_FOOTER = [
+  { key: "\u2190/\u2192", label: "tabs" },
+  { key: "esc", label: "close" }
+];
+function formatModalFooter(actions) {
+  return actions.map((action) => `${action.key} ${action.label}`).join(" \xB7 ");
+}
 var hosts = new WeakMap;
 function clearChildren(box) {
   for (const child of [...box.getChildren()]) {
@@ -44916,6 +44927,14 @@ function paintTabs(state) {
     content: state.otui.t`${state.otui.dim(labels)}`
   }));
 }
+function paintHeader(state, title) {
+  state.titleText.content = state.otui.t`${state.otui.bold(title)}`;
+  state.closeText.content = state.otui.t`${state.otui.dim(CLOSE_HINT)}`;
+}
+function paintFooter(state, actions) {
+  const items = actions !== undefined && actions.length > 0 ? actions : DEFAULT_FOOTER;
+  state.footerText.content = state.otui.t`${state.otui.dim(formatModalFooter(items))}`;
+}
 function unmountActiveTab(state) {
   const cleanup = state.tabCleanup;
   state.tabCleanup = undefined;
@@ -44975,10 +44994,10 @@ function ensureHost(otui, chrome) {
   });
   const panel = new otui.BoxRenderable(r, {
     id: PANEL_ID,
-    width: "80%",
-    maxWidth: 72,
-    maxHeight: "80%",
+    width: MODAL_PANEL_WIDTH,
+    height: MODAL_PANEL_HEIGHT,
     flexShrink: 0,
+    flexGrow: 0,
     flexDirection: "column",
     borderStyle: "rounded",
     border: true,
@@ -44988,26 +45007,57 @@ function ensureHost(otui, chrome) {
     paddingRight: 1,
     zIndex: 101
   });
+  const header3 = new otui.BoxRenderable(r, {
+    id: "modal-header",
+    width: "100%",
+    height: 1,
+    flexShrink: 0,
+    flexDirection: "row",
+    justifyContent: "space-between"
+  });
   const titleText = new otui.TextRenderable(r, {
     id: "modal-title",
-    content: ""
+    content: "",
+    flexGrow: 1
   });
+  const closeText = new otui.TextRenderable(r, {
+    id: "modal-close",
+    content: "",
+    flexShrink: 0
+  });
+  header3.add(titleText);
+  header3.add(closeText);
   const tabStrip = new otui.BoxRenderable(r, {
     id: "modal-tab-strip",
     flexShrink: 0,
     width: "100%",
+    height: 1,
     flexDirection: "row",
     focusable: true
   });
   const body = new otui.BoxRenderable(r, {
     id: "modal-body",
     width: "100%",
+    flexGrow: 1,
     minHeight: 1,
     flexDirection: "column"
   });
-  panel.add(titleText);
+  const footer = new otui.BoxRenderable(r, {
+    id: "modal-footer",
+    width: "100%",
+    height: 1,
+    flexShrink: 0,
+    flexDirection: "row"
+  });
+  const footerText = new otui.TextRenderable(r, {
+    id: "modal-footer-text",
+    content: ""
+  });
+  footer.add(footerText);
+  panel.add(header3);
   panel.add(tabStrip);
   panel.add(body);
+  panel.add(footer);
   backdrop.add(panel);
   r.root.add(backdrop);
   const state = {
@@ -45015,9 +45065,13 @@ function ensureHost(otui, chrome) {
     chrome,
     backdrop,
     panel,
+    header: header3,
     titleText,
+    closeText,
     tabStrip,
     body,
+    footer,
+    footerText,
     open: false,
     generation: 0,
     tabs: [],
@@ -45034,7 +45088,7 @@ function ensureHost(otui, chrome) {
     if (!state.open || state.input === undefined) {
       return;
     }
-    if (key.name === "escape") {
+    if (key.name === "escape" || key.name === "x" || key.sequence === "x") {
       closeHost(state, { restoreFocus: true, runOnClose: true });
       key.preventDefault();
       key.stopPropagation();
@@ -45121,15 +45175,323 @@ function openModal(otui, chrome, input2) {
   state.input = input2;
   state.tabs = input2.tabs;
   state.onClose = input2.onClose;
-  state.titleText.content = otui.t`${otui.bold(input2.title)}`;
+  paintHeader(state, input2.title);
+  paintFooter(state, input2.footer);
   mountTab(state, input2, resolveInitialTab(input2.tabs, input2.initialTab));
   state.tabStrip.focus();
   return makeHandle(state, generation);
 }
 
+// src/tui/flow-inspector.ts
+var FLOWS_COMMAND = "/flows";
+var FLOWS_FOOTER = [
+  { key: "\u2191/\u2193", label: "select" },
+  { key: "\u2190/\u2192", label: "tabs" },
+  { key: "esc", label: "close" }
+];
+function isFlowsCommand(line) {
+  const token = line.trim().split(/\s+/)[0] ?? "";
+  return token === FLOWS_COMMAND;
+}
+function findFlowItem(items, query) {
+  const needle = query.trim();
+  if (needle.length === 0) {
+    return;
+  }
+  const padded = /^\d+$/.test(needle) ? needle.padStart(3, "0") : needle;
+  return items.find((item) => item.id === needle || item.id === padded || item.dir === needle || item.dir.endsWith(`/${needle}`)) ?? items.find((item) => item.slug === needle);
+}
+function formatFlowListLines(items, selected) {
+  if (items.length === 0) {
+    return ["No flows in this project."];
+  }
+  return items.map((item, index) => {
+    const mark = index === selected ? ">" : " ";
+    return `${mark} ${item.id}  ${item.status}  ${item.tasksDone}/${item.tasksTotal}  ${item.title}`;
+  });
+}
+function formatFlowDetailLines(item) {
+  const taskLines = item.tasks.length === 0 ? ["  (no tasks)"] : item.tasks.map((task) => `  ${task.id}  ${task.status}  ${task.title}`);
+  return [
+    `${item.id}  ${item.title}`,
+    `Status   ${item.status}`,
+    `Dir      ${item.dir}`,
+    `Tasks    ${item.tasksDone}/${item.tasksTotal}`,
+    `PR       ${item.prUrl ?? "\u2014"}`,
+    `Source   ${item.source}`,
+    `Created  ${item.createdAt}`,
+    `Updated  ${item.updatedAt}`,
+    "",
+    "Tasks",
+    ...taskLines
+  ];
+}
+function formatFlowListText(items) {
+  if (items.length === 0) {
+    return `Flows
+  No flows in this project.
+`;
+  }
+  return [
+    "Flows",
+    ...items.map((item) => `  ${item.id}  ${item.status}  ${item.tasksDone}/${item.tasksTotal}  ${item.title}`),
+    ""
+  ].join(`
+`);
+}
+function formatFlowDetailText(item) {
+  return `${formatFlowDetailLines(item).join(`
+`)}
+`;
+}
+function paintLines(otui, renderer, body, lines) {
+  if (otui === undefined || otui === null || body === undefined || body === null) {
+    return;
+  }
+  const parent = body;
+  const ctor = otui.TextRenderable;
+  if (parent.add === undefined || ctor === undefined) {
+    return;
+  }
+  const node = new ctor(renderer, { id: "flows-body", content: lines.join(`
+`) });
+  parent.add(node);
+  return node;
+}
+function presentFlows(openModal2, otui, chrome, options) {
+  const items = options.items;
+  let selected = 0;
+  let listNode;
+  let detailNode;
+  let unsubscribeKey;
+  const paintSelection = () => {
+    if (listNode !== undefined) {
+      listNode.content = formatFlowListLines(items, selected).join(`
+`);
+    }
+    if (detailNode !== undefined) {
+      const item = items[selected];
+      detailNode.content = item !== undefined ? formatFlowDetailLines(item).join(`
+`) : "No flow selected.";
+    }
+  };
+  const handle = openModal2(otui, chrome, {
+    title: "/flows",
+    tabs: [
+      { id: "list", label: "Flows" },
+      { id: "detail", label: "Detail" }
+    ],
+    initialTab: "list",
+    footer: FLOWS_FOOTER,
+    renderTab: (tabId, body) => {
+      const renderer = options.renderer ?? chrome?.renderer;
+      if (tabId === "list") {
+        listNode = paintLines(otui, renderer, body, formatFlowListLines(items, selected));
+        return;
+      }
+      const item = items[selected];
+      detailNode = paintLines(otui, renderer, body, item !== undefined ? formatFlowDetailLines(item) : ["No flow selected."]);
+    },
+    onClose: () => {
+      unsubscribeKey?.();
+    }
+  });
+  if (handle === undefined) {
+    return;
+  }
+  if (options.onKeypress !== undefined) {
+    unsubscribeKey = options.onKeypress((key) => {
+      const token = key.name || key.sequence;
+      if (items.length === 0) {
+        return;
+      }
+      if (token === "up" || token === "k") {
+        selected = selected > 0 ? selected - 1 : 0;
+        paintSelection();
+      } else if (token === "down" || token === "j") {
+        selected = selected < items.length - 1 ? selected + 1 : selected;
+        paintSelection();
+      } else if (token === "return" || token === "enter") {
+        handle.setTab("detail");
+      }
+    });
+  }
+  return handle;
+}
+function openFlows(otui, chrome, options) {
+  return presentFlows((hostOtui, hostChrome, input2) => openModal(hostOtui, hostChrome, input2), otui, chrome, options);
+}
+
+// src/tui/inspector-sources.ts
+init_store2();
+import { randomUUID as randomUUID17 } from "crypto";
+function workspaceFromManifest(manifest) {
+  return {
+    id: manifest.id,
+    title: manifest.title,
+    status: manifest.status,
+    resources: manifest.resources.map((resource) => ({ kind: resource.kind, uri: resource.uri }))
+  };
+}
+function workspacesInSession(workspaces, opts) {
+  const text = opts.sessionText ?? "";
+  const sessionId = opts.sessionId ?? "";
+  return workspaces.filter((workspace) => {
+    if (text.includes(workspace.id)) {
+      return true;
+    }
+    return workspace.resources.some((resource) => resource.kind === "session" && sessionId.length > 0 && resource.uri.includes(sessionId));
+  });
+}
+function explicitFlowMention(item, text) {
+  if (text.length === 0) {
+    return false;
+  }
+  const id = item.id.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const slug2 = item.slug.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const pattern = new RegExp(`(?:flow\\s+#?|/flows\\s+|\\.metaproject/flows/)${id}\\b` + (slug2.length > 0 ? `|(?:flow\\s+)${slug2}\\b` : ""), "i");
+  return pattern.test(text);
+}
+function flowsInSession(flows, opts) {
+  const sessionId = opts.sessionId ?? "";
+  const text = opts.sessionText ?? "";
+  return flows.filter((flow) => {
+    if (sessionId.length > 0 && flow.sessionIds.includes(sessionId)) {
+      return true;
+    }
+    return explicitFlowMention(flow, text);
+  });
+}
+function flowItemFromState(flow, dir) {
+  const sessionIds = [
+    ...new Set(flow.tasks.map((task) => task.runLink?.sessionId).filter((id) => typeof id === "string" && id.length > 0))
+  ];
+  return {
+    id: flow.id,
+    slug: flow.slug,
+    title: flow.title,
+    status: flow.status,
+    dir: `.metaproject/flows/${dir}`,
+    tasksDone: flow.tasks.filter((task) => task.status === "done").length,
+    tasksTotal: flow.tasks.length,
+    sessionIds,
+    prUrl: flow.pr.url,
+    createdAt: flow.createdAt,
+    updatedAt: flow.updatedAt,
+    source: flow.source.ref ?? flow.source.type,
+    tasks: flow.tasks.map((task) => ({ id: task.id, title: task.title, status: task.status }))
+  };
+}
+async function loadInspectorWorkspaces(cwd) {
+  try {
+    const service4 = new WorkspaceService({
+      workspaceRoot: cwd,
+      authorizationServer: localWorkspaceAuthorizationServer(),
+      strictGuard: {
+        mode: "strict",
+        availability: "available",
+        decision: "pass",
+        policyRevision: "local-offline-v1"
+      }
+    });
+    const listed = await service4.list({ request: undefined, requestCorrelationId: randomUUID17() });
+    return listed.map(workspaceFromManifest);
+  } catch {
+    return [];
+  }
+}
+async function loadInspectorFlows(cwd) {
+  try {
+    const dirs = await listFlowDirs(cwd);
+    const items = [];
+    for (const dir of dirs) {
+      try {
+        items.push(flowItemFromState(await readFlow(cwd, dir), dir));
+      } catch {}
+    }
+    return items;
+  } catch {
+    return [];
+  }
+}
+function formatWorkspaceLines(workspaces) {
+  if (workspaces.length === 0) {
+    return ["No workspaces recorded in this session."];
+  }
+  const width = workspaces.reduce((max, workspace) => Math.max(max, workspace.id.length), 0);
+  return workspaces.map((workspace) => `${workspace.id.padEnd(width)}  ${workspace.status}  ${workspace.title}`);
+}
+function formatSessionFlowLines(flows) {
+  if (flows.length === 0) {
+    return ["No flows recorded in this session."];
+  }
+  return flows.map((flow) => `${flow.id}  ${flow.status}  ${flow.tasksDone}/${flow.tasksTotal}  ${flow.title}`);
+}
+
+// src/tui/context-usage.ts
+var CONTEXT_BAR_WIDTH = 28;
+function lastTurnUsed(usage) {
+  if (usage === undefined) {
+    return;
+  }
+  if (usage.totalTokens !== undefined) {
+    return usage.totalTokens;
+  }
+  if (usage.inputTokens === undefined && usage.outputTokens === undefined) {
+    return;
+  }
+  return (usage.inputTokens ?? 0) + (usage.outputTokens ?? 0);
+}
+function renderUsageBar(filled, width = CONTEXT_BAR_WIDTH) {
+  const n = Math.max(0, Math.min(width, filled > 0 ? width : 0));
+  return `[${"\u2588".repeat(n)}${"\u2591".repeat(width - n)}]`;
+}
+function buildContextUsage(source) {
+  const lastIn = source.usage?.inputTokens;
+  const lastOut = source.usage?.outputTokens;
+  const last = lastTurnUsed(source.usage);
+  const hasEstimate = source.estimateTokens !== undefined;
+  const total = hasEstimate ? source.estimateTokens ?? 0 : last ?? 0;
+  const estimated = hasEstimate || last === undefined;
+  const segments2 = [];
+  if (hasEstimate) {
+    segments2.push({ id: "history", label: "history (est.)", tokens: source.estimateTokens ?? 0 });
+  }
+  if (lastIn !== undefined) {
+    segments2.push({ id: "last-in", label: "last in", tokens: lastIn });
+  }
+  if (lastOut !== undefined) {
+    segments2.push({ id: "last-out", label: "last out", tokens: lastOut });
+  }
+  return {
+    total,
+    estimated,
+    segments: segments2,
+    bar: renderUsageBar(total),
+    note: total === 0 ? "No context usage yet." : "No model context window is known. The bar is relative to used tokens, not a billed limit."
+  };
+}
+function formatContextUsageText(view) {
+  if (view.total === 0 && view.segments.every((segment) => segment.tokens === 0)) {
+    return `Context
+  ${view.note}
+`;
+  }
+  const kind = view.estimated ? "tokens (estimate)" : "tokens";
+  const width = view.segments.reduce((max, segment) => Math.max(max, segment.label.length), 0);
+  const rows = view.segments.map((segment) => `  ${segment.label.padEnd(width)}  ${segment.tokens}`);
+  return [`Context`, `  Used  ${view.total} ${kind}`, `  ${view.bar}`, ...rows, "", `  ${view.note}`, ""].join(`
+`);
+}
+
 // src/tui/session-info.ts
-var SESSION_INFO_COMMANDS = ["/session-info", "/status", "/info"];
+var SESSION_INFO_COMMANDS = ["/status"];
 var MISSING = "\u2014";
+var SESSION_INFO_FOOTER = [
+  { key: "c", label: "copy id" },
+  { key: "\u2190/\u2192", label: "tabs" },
+  { key: "esc", label: "close" }
+];
 function isSessionInfoCommand(line) {
   const token = line.trim().split(/\s+/)[0] ?? "";
   return SESSION_INFO_COMMANDS.includes(token);
@@ -45201,7 +45563,28 @@ function buildSessionInfoSnapshot(source) {
     },
     { label: "Context estimate", value: estimate }
   ];
-  return { sessionId: id, sessionRows, usageRows };
+  const context = buildContextUsage({
+    estimateTokens: source.estimateTokens,
+    usage: source.usage
+  });
+  const sessionWorkspaces = workspacesInSession(source.workspaces ?? [], {
+    sessionId: id,
+    ...source.sessionText !== undefined ? { sessionText: source.sessionText } : {}
+  });
+  const sessionFlows = flowsInSession(source.flows ?? [], {
+    sessionId: id,
+    ...source.sessionText !== undefined ? { sessionText: source.sessionText } : {}
+  });
+  return {
+    sessionId: id,
+    sessionRows,
+    usageRows,
+    context,
+    workspaceLines: formatWorkspaceLines(sessionWorkspaces),
+    flowLines: formatSessionFlowLines(sessionFlows),
+    hasWorkspaces: sessionWorkspaces.length > 0,
+    hasFlows: sessionFlows.length > 0
+  };
 }
 function formatSection(title, rows) {
   const width = rows.reduce((max, row) => Math.max(max, row.label.length), 0);
@@ -45209,18 +45592,40 @@ function formatSection(title, rows) {
 `);
 }
 function formatSessionInfoText(snapshot) {
+  const extra = [];
+  extra.push(formatContextUsageText(snapshot.context));
+  if (snapshot.hasWorkspaces) {
+    extra.push(["Workspaces", ...snapshot.workspaceLines.map((line) => `  ${line}`), ""].join(`
+`));
+  }
+  if (snapshot.hasFlows) {
+    extra.push(["Flow", ...snapshot.flowLines.map((line) => `  ${line}`), ""].join(`
+`));
+  }
   return `${formatSection("Session", snapshot.sessionRows)}
 
 ${formatSection("Usage", snapshot.usageRows)}
-`;
+
+${extra.join(`
+`)}`;
 }
 function sessionIdCopyText(snapshot) {
   return snapshot.sessionId;
 }
-function sessionBlockCopyText(snapshot) {
-  return formatSessionInfoText(snapshot);
+function statusModalTabs(snapshot) {
+  const tabs = [
+    { id: "status", label: "Status" },
+    { id: "context", label: "Context" }
+  ];
+  if (snapshot.hasWorkspaces) {
+    tabs.push({ id: "workspaces", label: "Workspaces" });
+  }
+  if (snapshot.hasFlows) {
+    tabs.push({ id: "flow", label: "Flow" });
+  }
+  return tabs;
 }
-function paintRows(otui, renderer, body, rows) {
+function paintContent(otui, renderer, body, content) {
   if (otui === undefined || otui === null || body === undefined || body === null) {
     return;
   }
@@ -45229,12 +45634,12 @@ function paintRows(otui, renderer, body, rows) {
   if (parent.add === undefined || ctor === undefined) {
     return;
   }
+  parent.add(new ctor(renderer, { id: "session-info-body", content }));
+}
+function paintRows(otui, renderer, body, rows) {
   const width = rows.reduce((max, row) => Math.max(max, row.label.length), 0);
-  parent.add(new ctor(renderer, {
-    id: "session-info-body",
-    content: rows.map((row) => `${row.label.padEnd(width)}  ${row.value}`).join(`
-`)
-  }));
+  paintContent(otui, renderer, body, rows.map((row) => `${row.label.padEnd(width)}  ${row.value}`).join(`
+`));
 }
 function presentSessionInfo(openModal2, otui, chrome, options) {
   const { snapshot, toast } = options;
@@ -45249,16 +45654,27 @@ function presentSessionInfo(openModal2, otui, chrome, options) {
   };
   let unsubscribeKey;
   const handle = openModal2(otui, chrome, {
-    title: "Session",
-    tabs: [
-      { id: "session", label: "Session" },
-      { id: "usage", label: "Usage" }
-    ],
-    initialTab: "session",
+    title: "/status",
+    tabs: statusModalTabs(snapshot),
+    initialTab: "status",
+    footer: SESSION_INFO_FOOTER,
     renderTab: (tabId, body) => {
-      const rows = tabId === "usage" ? snapshot.usageRows : snapshot.sessionRows;
       const renderer = options.renderer ?? chrome?.renderer;
-      paintRows(otui, renderer, body, rows);
+      if (tabId === "context") {
+        paintContent(otui, renderer, body, formatContextUsageText(snapshot.context).trimEnd());
+        return;
+      }
+      if (tabId === "workspaces") {
+        paintContent(otui, renderer, body, snapshot.workspaceLines.join(`
+`));
+        return;
+      }
+      if (tabId === "flow") {
+        paintContent(otui, renderer, body, snapshot.flowLines.join(`
+`));
+        return;
+      }
+      paintRows(otui, renderer, body, snapshot.sessionRows);
     },
     onClose: () => {
       unsubscribeKey?.();
@@ -45272,8 +45688,6 @@ function presentSessionInfo(openModal2, otui, chrome, options) {
       const token = key.name || key.sequence;
       if (token === "c") {
         copy(sessionIdCopyText(snapshot));
-      } else if (token === "y") {
-        copy(sessionBlockCopyText(snapshot));
       }
     });
   }
@@ -45341,12 +45755,11 @@ var AGENT_SLASH_COMMANDS = [
   { name: "/resume", description: "Resume a prior session in this project", modes: AGENT_ONLY },
   { name: "/sessions", description: "Open the session list and switch to one", modes: AGENT_ONLY },
   {
-    name: "/session-info",
-    description: "Show session identity and context usage",
+    name: "/status",
+    description: "Show session identity, context, workspaces, and flows",
     modes: BOTH
   },
-  { name: "/status", description: "Alias of /session-info", modes: BOTH },
-  { name: "/info", description: "Alias of /session-info", modes: BOTH },
+  { name: "/flows", description: "Browse project flows and inspect one", modes: BOTH },
   {
     name: "/compact",
     description: "Compact model context \u2014 /compact [focus] (archive kept)",
@@ -47451,7 +47864,7 @@ function createBlockView(otui, renderer, parent, block, options = {}) {
   let body;
   let bodyText;
   let painted;
-  const paintHeader = (state, focused) => {
+  const paintHeader2 = (state, focused) => {
     const hint = state.collapsed ? options.hint : options.expandedHint ?? options.hint;
     const label = blockLabel({
       kind: state.kind,
@@ -47512,7 +47925,7 @@ function createBlockView(otui, renderer, parent, block, options = {}) {
   return {
     id: block.id,
     render: (state, opts = {}) => {
-      paintHeader(state, opts.focused === true);
+      paintHeader2(state, opts.focused === true);
       if (state.collapsed) {
         dropBody();
         return;
@@ -49012,21 +49425,41 @@ Staying in the current session.
 `);
     };
     paintSessionHeader();
+    const inspectorKeys = { onKeypress: (handler) => onKeypress4(r, (key) => handler(key)) };
+    const inspectorCwd = () => opts.session?.cwd ?? liveSession.summary.projectPath;
     const showSessionInfo = () => {
-      const snapshot = buildSessionInfoSnapshot({
-        summary: liveSession.summary,
-        selection: currentSel,
-        version: package_default.version,
-        usage: lastUsage,
-        estimateTokens: estimateContextTokens(history)
-      });
-      openSessionInfo(otui, chrome, {
-        snapshot,
-        copyText: (text) => r.copyToClipboardOSC52(text),
-        toast: (message2) => chrome.showToast(message2),
-        renderer: r,
-        onKeypress: (handler) => onKeypress4(r, (key) => handler(key))
-      });
+      (async () => {
+        const cwd = inspectorCwd();
+        const [workspaces, flows] = await Promise.all([loadInspectorWorkspaces(cwd), loadInspectorFlows(cwd)]);
+        const snapshot = buildSessionInfoSnapshot({
+          summary: liveSession.summary,
+          selection: currentSel,
+          version: package_default.version,
+          usage: lastUsage,
+          estimateTokens: estimateContextTokens(history),
+          sessionText: history.map((message2) => message2.content).join(`
+`),
+          workspaces,
+          flows
+        });
+        openSessionInfo(otui, chrome, {
+          snapshot,
+          copyText: (text) => r.copyToClipboardOSC52(text),
+          toast: (message2) => chrome.showToast(message2),
+          renderer: r,
+          ...inspectorKeys
+        });
+      })();
+    };
+    const showFlows = () => {
+      (async () => {
+        const items = await loadInspectorFlows(inspectorCwd());
+        openFlows(otui, chrome, {
+          items,
+          renderer: r,
+          ...inspectorKeys
+        });
+      })();
     };
     const updateModelLabels = () => {
       paintSessionHeader();
@@ -49237,6 +49670,10 @@ Staying in the current session.
           showSessionInfo();
           return;
         }
+        if (command2 !== undefined && isFlowsCommand(command2.name)) {
+          showFlows();
+          return;
+        }
         if (command2 !== undefined || line.startsWith("/")) {
           transcript.add(new otui.TextRenderable(r, {
             id: `c${uid++}`,
@@ -49382,6 +49819,10 @@ Staying in the current session.
           showSessionInfo();
           return;
         }
+        if (isFlowsCommand(command.name)) {
+          showFlows();
+          return;
+        }
         if (command.name === "/copy") {
           const target = newestBlock();
           if (target === undefined || !copyBlock(target.id)) {
@@ -49727,7 +50168,7 @@ function createChatBridge(hooks = {}) {
         close();
         return "exit";
       }
-      if (isSessionInfoCommand(value)) {
+      if (isSessionInfoCommand(value) || isFlowsCommand(value)) {
         return "local";
       }
       if ((turn || queue.length > 0) && value.startsWith("/")) {
@@ -49854,19 +50295,33 @@ async function mountChatShell(otui, renderer, opts) {
       return;
     }
     if (result === "local") {
-      const snapshot = buildSessionInfoSnapshot({
-        summary: opts.deps.session !== undefined ? latestSession(opts.deps.session.cwd) : undefined,
-        selection,
-        version: package_default.version,
-        estimateTokens: estimateContextTokens(seen)
-      });
-      openSessionInfo(otui, chrome, {
-        snapshot,
-        copyText: (text) => r.copyToClipboardOSC52(text),
-        toast: (message2) => chrome.showToast(message2),
-        renderer: r,
-        onKeypress: (handler) => onKeypress4(r, (key) => handler(key))
-      });
+      const cwd = opts.deps.session?.cwd;
+      const keys = { onKeypress: (handler) => onKeypress4(r, (key) => handler(key)) };
+      (async () => {
+        const [workspaces, flows] = cwd === undefined ? [[], []] : await Promise.all([loadInspectorWorkspaces(cwd), loadInspectorFlows(cwd)]);
+        if (isFlowsCommand(line)) {
+          openFlows(otui, chrome, { items: flows, renderer: r, ...keys });
+          return;
+        }
+        const summary = cwd !== undefined ? latestSession(cwd) : undefined;
+        const snapshot = buildSessionInfoSnapshot({
+          summary,
+          selection,
+          version: package_default.version,
+          estimateTokens: estimateContextTokens(seen),
+          sessionText: seen.map((message2) => message2.content).join(`
+`),
+          workspaces,
+          flows
+        });
+        openSessionInfo(otui, chrome, {
+          snapshot,
+          copyText: (text) => r.copyToClipboardOSC52(text),
+          toast: (message2) => chrome.showToast(message2),
+          renderer: r,
+          ...keys
+        });
+      })();
       return;
     }
     if (result === "deferred") {
@@ -50193,9 +50648,8 @@ var READLINE_AGENT_COMMANDS = [
   "/new",
   "/clear",
   "/compact",
-  "/session-info",
   "/status",
-  "/info",
+  "/flows",
   "/exit"
 ];
 function readlineAgentHelpText() {
@@ -50285,14 +50739,33 @@ Starting a new session.
         continue;
       }
       if (isSessionInfoCommand(command)) {
+        const cwd = deps.session?.cwd;
+        const [workspaces, flows] = cwd === undefined ? [[], []] : await Promise.all([loadInspectorWorkspaces(cwd), loadInspectorFlows(cwd)]);
         system(formatSessionInfoText(buildSessionInfoSnapshot({
           summary: live?.summary,
           selection: { provider: providerName, model: modelName },
           version: package_default.version,
-          estimateTokens: estimateContextTokens(history)
+          estimateTokens: estimateContextTokens(history),
+          sessionText: history.map((message2) => message2.content).join(`
+`),
+          workspaces,
+          flows
         })));
         continue;
       }
+      if (isFlowsCommand(command)) {
+        const cwd = deps.session?.cwd;
+        const items = cwd === undefined ? [] : await loadInspectorFlows(cwd);
+        const query = argument.trim();
+        if (query.length > 0) {
+          const found = findFlowItem(items, query);
+          system(found !== undefined ? formatFlowDetailText(found) : `No flow matching '${query}'.
+`);
+          continue;
+        }
+        system(formatFlowListText(items));
+        continue;
+      }
       if (command === "/clear" || command === "/new") {
         if (sessionsOn) {
           live = createSession({ cwd: sessionCwd, provider: providerName, model: modelName });
@@ -50941,13 +51414,31 @@ New session ${shortSessionId(live.summary.id)}.
       if (command === "/help") {
         agentIo.onSystem?.(readlineAgentHelpText());
       } else if (isSessionInfoCommand(command)) {
+        const cwd = sessionCwd;
+        const [workspaces, flows] = await Promise.all([
+          loadInspectorWorkspaces(cwd),
+          loadInspectorFlows(cwd)
+        ]);
         agentIo.onSystem?.(formatSessionInfoText(buildSessionInfoSnapshot({
           summary: live?.summary,
           selection: { provider: deps.providerId, model: deps.modelId },
           version: package_default.version,
           usage: lastUsage,
-          estimateTokens: estimateContextTokens(history)
+          estimateTokens: estimateContextTokens(history),
+          sessionText: history.map((message2) => message2.content).join(`
+`),
+          workspaces,
+          flows
         })));
+      } else if (isFlowsCommand(command)) {
+        const items = await loadInspectorFlows(sessionCwd);
+        if (rest.length > 0) {
+          const found = findFlowItem(items, rest);
+          agentIo.onSystem?.(found !== undefined ? formatFlowDetailText(found) : `No flow matching '${rest}'.
+`);
+        } else {
+          agentIo.onSystem?.(formatFlowListText(items));
+        }
       } else if (command === "/expand") {
         const expanded = expandedToolOutput(lastToolName, lastToolOutput);
         if (expanded !== undefined) {
@@ -51234,7 +51725,7 @@ async function shellCommand(args2, runtime = {}) {
           modelId: sel.model
         }),
         maxToolCalls: resolveAgentMaxToolCalls(),
-        idSeq: () => randomUUID17()
+        idSeq: () => randomUUID18()
       };
     };
     const redetect = () => detectProviders({
@@ -51265,7 +51756,7 @@ async function shellCommand(args2, runtime = {}) {
         makeShellDeps: (sel) => ({
           makeProvider: chatFactory,
           clock: () => new Date().toISOString(),
-          idSeq: () => randomUUID17(),
+          idSeq: () => randomUUID18(),
           initial: sel,
           session: {
             cwd,
@@ -51335,7 +51826,7 @@ async function shellCommand(args2, runtime = {}) {
     const deps = {
       makeProvider: baseFactory,
       clock: () => new Date().toISOString(),
-      idSeq: () => randomUUID17(),
+      idSeq: () => randomUUID18(),
       initial: baseUrl2 === undefined ? { provider, model } : { provider, model, baseUrl: baseUrl2 },
       selectProviderModel: realSelectProviderModel(baseUrl2)
     };
@@ -51383,7 +51874,7 @@ async function shellCommand(args2, runtime = {}) {
           modelId: model
         }),
         maxToolCalls: resolveAgentMaxToolCalls(),
-        idSeq: () => randomUUID17()
+        idSeq: () => randomUUID18()
       };
       let resumeId = flags.resumeId;
       if (flags.resumePick === true && resumeId === undefined) {
@@ -51715,7 +52206,7 @@ function printHelp16() {
 }
 
 // src/commands/serve.ts
-import { randomUUID as randomUUID20 } from "crypto";
+import { randomUUID as randomUUID21 } from "crypto";
 
 // src/lib/serve-config.ts
 init_config_dir();
@@ -52042,7 +52533,7 @@ function saveServeConfig(config, dir, onWarn) {
 
 // src/lib/serve-credential.ts
 init_config_dir();
-import { createHash as createHash29, randomBytes as randomBytes2, randomUUID as randomUUID18 } from "crypto";
+import { createHash as createHash29, randomBytes as randomBytes2, randomUUID as randomUUID19 } from "crypto";
 import {
   chmodSync as chmodSync4,
   closeSync as closeSync3,
@@ -52126,7 +52617,7 @@ function readServeCredential(dir) {
 }
 function writeStore(store, dir) {
   const file = serveCredentialPath(dir);
-  const temp = `${file}.${randomUUID18()}.tmp`;
+  const temp = `${file}.${randomUUID19()}.tmp`;
   try {
     ensureKeryxConfigDir(dir);
     const handle = openSync3(temp, "wx", 384);
@@ -52166,7 +52657,7 @@ function mintRecord(now) {
   const salt = randomBytes2(32).toString("hex");
   return {
     token,
-    record: { id: randomUUID18(), algorithm: "sha256", salt, hash: hashToken(salt, token), createdAt: now }
+    record: { id: randomUUID19(), algorithm: "sha256", salt, hash: hashToken(salt, token), createdAt: now }
   };
 }
 function issueServeToken(dir, now = () => new Date().toISOString(), onWaiting) {
@@ -52480,7 +52971,7 @@ function releaseIdempotencyKey(project, idempotencyKey, turnId, dir) {
 }
 
 // src/lib/serve-turn.ts
-import { randomUUID as randomUUID19 } from "crypto";
+import { randomUUID as randomUUID20 } from "crypto";
 import path140 from "path";
 init_service();
 var REMOTE_ORIGIN = "remote:http";
@@ -52599,7 +53090,7 @@ async function redactOut(security, text) {
 async function runRemoteTurn(input2) {
   const scanRoot = input2.scanRoot;
   const security = createSecurityService(scanRoot);
-  const newId = input2.newId ?? (() => randomUUID19());
+  const newId = input2.newId ?? (() => randomUUID20());
   const clock = input2.clock ?? (() => new Date().toISOString());
   const turnId = input2.turnId ?? newId();
   const sessionId = input2.request.sessionId ?? newId();
@@ -52742,7 +53233,7 @@ function outcomeOf(status, gate, unresolvedBlockerIds) {
 }
 function createSubmitTurn(deps) {
   return async (request, project) => {
-    const turnId = (deps.newId ?? (() => randomUUID19()))();
+    const turnId = (deps.newId ?? (() => randomUUID20()))();
     const scanned = await scanPrompt(deps.dir, request.prompt);
     if (scanned.rejected) {
       return { kind: "rejected" };
@@ -53429,7 +53920,7 @@ function runConfig(args2) {
       return;
     }
     const credential2 = readServeCredential();
-    const credentialId = credential2.status === "ok" ? credential2.record.id : randomUUID20();
+    const credentialId = credential2.status === "ok" ? credential2.record.id : randomUUID21();
     const config = defaultServeConfig(credentialId, {
       address: parsed.parsed.values.get("--bind") ?? DEFAULT_SERVE_BIND_ADDRESS,
       port: port ?? DEFAULT_SERVE_PORT,
@@ -57128,7 +57619,7 @@ async function versionCommand(args2, deps = {}) {
 
 // src/commands/workspace.ts
 init_args();
-import { randomUUID as randomUUID21 } from "crypto";
+import { randomUUID as randomUUID22 } from "crypto";
 import { writeFile as writeFile50 } from "fs/promises";
 
 // src/sac/fwk-explain.ts
@@ -57196,13 +57687,13 @@ async function workspaceCommand(args2) {
       const component = optionValue(args2, "--component");
       if (!title)
         throw new Error("Usage: keryx workspace create --title <title> [--component <workspace-relative-ref>]");
-      const workspace = await service4().create({ request: undefined, requestCorrelationId: randomUUID21(), id: newWorkspaceId(), title, ...component ? { component: { kind: "component", uri: component } } : {} });
+      const workspace = await service4().create({ request: undefined, requestCorrelationId: randomUUID22(), id: newWorkspaceId(), title, ...component ? { component: { kind: "component", uri: component } } : {} });
       console.log(JSON.stringify(workspace, null, 2));
       return;
     }
     if (subcommand === "list") {
       rejectUnknownOptions(args2.slice(1), new Set);
-      console.log(JSON.stringify(await service4().list({ request: undefined, requestCorrelationId: randomUUID21() }), null, 2));
+      console.log(JSON.stringify(await service4().list({ request: undefined, requestCorrelationId: randomUUID22() }), null, 2));
       return;
     }
     if (subcommand === "show") {
@@ -57210,7 +57701,7 @@ async function workspaceCommand(args2) {
       const id = args2[1];
       if (!id)
         throw new Error("Usage: keryx workspace show <workspace-id>");
-      console.log(JSON.stringify(await service4().show({ request: undefined, requestCorrelationId: randomUUID21(), workspaceId: id }), null, 2));
+      console.log(JSON.stringify(await service4().show({ request: undefined, requestCorrelationId: randomUUID22(), workspaceId: id }), null, 2));
       return;
     }
     if (subcommand === "add-resource") {
@@ -57221,7 +57712,7 @@ async function workspaceCommand(args2) {
       const revision = optionValue(args2, "--revision");
       if (!workspaceId || !kind || !uri)
         throw new Error("Usage: keryx workspace add-resource <workspace-id> --kind <kind> --uri <workspace-relative-ref> [--revision <revision>]");
-      console.log(JSON.stringify(await service4().addResource({ request: undefined, requestCorrelationId: randomUUID21(), workspaceId, resource: { kind, uri, ...revision ? { revision } : {} } }), null, 2));
+      console.log(JSON.stringify(await service4().addResource({ request: undefined, requestCorrelationId: randomUUID22(), workspaceId, resource: { kind, uri, ...revision ? { revision } : {} } }), null, 2));
       return;
     }
     if (subcommand === "overview") {
@@ -57233,7 +57724,7 @@ async function workspaceCommand(args2) {
       const maxTokens = Number(optionValue(args2, "--max-tokens") ?? "4096");
       if (!Number.isInteger(maxItems) || !Number.isInteger(maxTokens) || maxItems < 0 || maxTokens < 0)
         throw new Error("--max-items and --max-tokens must be non-negative integers");
-      const result = await createLocalFwkReadService(process.cwd()).overview({ workspaceId, request: undefined, requestCorrelationId: randomUUID21(), budget: { maxItems, maxTokens } });
+      const result = await createLocalFwkReadService(process.cwd()).overview({ workspaceId, request: undefined, requestCorrelationId: randomUUID22(), budget: { maxItems, maxTokens } });
       const normalized = normalizeFwkResult(result);
       console.log(JSON.stringify(normalized, null, 2));
       if (args2.includes("--explain"))
@@ -57250,7 +57741,7 @@ async function workspaceCommand(args2) {
       const maxTokens = Number(optionValue(args2, "--max-tokens") ?? "4096");
       if (!Number.isInteger(maxItems) || !Number.isInteger(maxTokens) || maxItems < 0 || maxTokens < 0)
         throw new Error("--max-items and --max-tokens must be non-negative integers");
-      const result = await createLocalFwkReadService(process.cwd()).read({ workspaceId, itemId, request: undefined, requestCorrelationId: randomUUID21(), budget: { maxItems, maxTokens } });
+      const result = await createLocalFwkReadService(process.cwd()).read({ workspaceId, itemId, request: undefined, requestCorrelationId: randomUUID22(), budget: { maxItems, maxTokens } });
       const normalized = normalizeFwkResult(result);
       console.log(JSON.stringify(normalized, null, 2));
       if (args2.includes("--explain"))
@@ -57273,12 +57764,12 @@ async function workspaceCommand(args2) {
       if (!session)
         throw new Error(`no session matching "${sessionRef}" in this project \u2014 use \`keryx sessions list\``);
       const { service: service5, wrapUpAuthority, authorizationServer } = createHarnessProposalLifecycleService(cwd, { workspaceId, ...note2 ? { note: note2 } : {} });
-      const requestCorrelationId = randomUUID21();
+      const requestCorrelationId = randomUUID22();
       const actor = await authorizationServer.actorContextFor(undefined, requestCorrelationId);
       if (!actor)
         throw new Error("trusted ActorContext is required");
       const wrapUp = await wrapUpAuthority.issue({ actor, source: "session", sourceRef: sessionEvidenceRef(workspaceId, session.id) });
-      const proposal = await service5.create({ request: undefined, requestCorrelationId, workspaceId, id: `proposal-${randomUUID21().replace(/-/g, "").slice(0, 16)}`, proposalRevision, kind, wrapUp });
+      const proposal = await service5.create({ request: undefined, requestCorrelationId, workspaceId, id: `proposal-${randomUUID22().replace(/-/g, "").slice(0, 16)}`, proposalRevision, kind, wrapUp });
       if (note2)
         await writeFile50(proposalNotePath(cwd, workspaceId, proposal.id), note2, "utf8");
       console.log(JSON.stringify(normalizeProposalLifecycleResult(proposal), null, 2));
@@ -57290,10 +57781,10 @@ async function workspaceCommand(args2) {
       const proposalId = args2[2];
       const decision = optionValue(args2, "--decision");
       const reason = optionValue(args2, "--reason");
-      const idempotencyKey = optionValue(args2, "--idempotency-key") ?? randomUUID21();
+      const idempotencyKey = optionValue(args2, "--idempotency-key") ?? randomUUID22();
       if (!workspaceId || !proposalId || !decision)
         throw new Error("Usage: keryx workspace review <workspace-id> <proposal-id> --decision <accepted|rejected|dismissed> [--reason <reason>] [--idempotency-key <key>]");
-      const result = await createHarnessProposalLifecycleService(process.cwd(), { workspaceId }).service.review({ request: undefined, requestCorrelationId: randomUUID21(), workspaceId, proposalId, decision, idempotencyKey, ...reason ? { reason } : {} });
+      const result = await createHarnessProposalLifecycleService(process.cwd(), { workspaceId }).service.review({ request: undefined, requestCorrelationId: randomUUID22(), workspaceId, proposalId, decision, idempotencyKey, ...reason ? { reason } : {} });
       console.log(JSON.stringify(normalizeProposalLifecycleResult(result), null, 2));
       return;
     }
@@ -57302,7 +57793,7 @@ async function workspaceCommand(args2) {
       const workspaceId = args2[1];
       if (!workspaceId)
         throw new Error("Usage: keryx workspace collaboration <workspace-id>");
-      console.log(JSON.stringify(await createLocalCollaborationService(process.cwd()).overview({ workspaceId, request: undefined, requestCorrelationId: randomUUID21() }), null, 2));
+      console.log(JSON.stringify(await createLocalCollaborationService(process.cwd()).overview({ workspaceId, request: undefined, requestCorrelationId: randomUUID22() }), null, 2));
       return;
     }
     if (subcommand === "policy-readiness") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrciphersmith/keryx",
-  "version": "0.2.36",
+  "version": "0.2.37",
   "description": "Version-controlled project context for AI coding agents: code graph, architecture wiki, project memory, relevant tests, quality signals, and task flows.",
   "private": false,
   "publishConfig": {