@mrciphersmith/keryx 0.2.35 → 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
@@ -44796,6 +44796,906 @@ class LiveMarkdownBlock {
 
 // src/tui/tui-shell.ts
 import { spawnSync as spawnSync2 } from "child_process";
+// package.json
+var package_default = {
+  name: "@mrciphersmith/keryx",
+  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: {
+    access: "public"
+  },
+  license: "MIT",
+  type: "module",
+  repository: {
+    type: "git",
+    url: "git+ssh://git@github.com/MrCipherSmith/keryx.git"
+  },
+  keywords: [
+    "ai-agents",
+    "coding-agents",
+    "agent-harness",
+    "agent-context",
+    "repository-context",
+    "code-graph",
+    "project-memory",
+    "test-impact-analysis",
+    "developer-tools",
+    "model-context-protocol",
+    "mcp",
+    "claude-code",
+    "cursor",
+    "codex",
+    "cli",
+    "bun"
+  ],
+  bin: {
+    keryx: "./dist/cli.js"
+  },
+  scripts: {
+    keryx: "bun ./src/cli.ts",
+    build: "bun build ./src/cli.ts --outdir ./dist --target bun --external @modelcontextprotocol/sdk --external web-tree-sitter --external @opentui/core && bun build ./src/harness/process/sandbox/proxy-worker.ts --outdir ./dist --target bun --external @modelcontextprotocol/sdk --external web-tree-sitter --external @opentui/core",
+    prepare: "bun run build",
+    typecheck: "tsc --noEmit",
+    test: "bun test",
+    check: "tsc --noEmit && bun test",
+    "check:doc-links": "bun scripts/check-doc-links.ts",
+    "test:guards": "bun test src/lib/config-dir.ast.test.ts src/lib/config-dir.readers.test.ts src/lib/production-graph.test.ts src/harness/policy/profiles.test.ts src/lib/serve-server.test.ts"
+  },
+  files: [
+    "dist",
+    "docs/requirements/shared-agent-context/schemas",
+    "src/gdgraph",
+    "src/gdskills/bundled",
+    "src/gdskills/contracts",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
+  dependencies: {},
+  optionalDependencies: {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@opentui/core": "^0.4.5",
+    "web-tree-sitter": "^0.22.0"
+  },
+  devDependencies: {
+    "@types/bun": "latest",
+    "@xenova/transformers": "^2.17.2",
+    "bun-types": "latest",
+    typescript: "^5"
+  },
+  engines: {
+    bun: ">=1.1.0"
+  },
+  trustedDependencies: [
+    "protobufjs",
+    "sharp"
+  ]
+};
+
+// src/tui/modal-host.ts
+function onKeypress(r, handler) {
+  r._internalKeyInput.onInternal("keypress", handler);
+  return () => r._internalKeyInput.offInternal("keypress", 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()]) {
+    box.remove(child);
+  }
+}
+function containsNode(root, node) {
+  if (root === node) {
+    return true;
+  }
+  for (const child of root.getChildren()) {
+    if (containsNode(child, node)) {
+      return true;
+    }
+  }
+  return false;
+}
+function resolveInitialTab(tabs, initialTab) {
+  const first = tabs[0];
+  if (first === undefined) {
+    return "";
+  }
+  if (initialTab !== undefined && tabs.some((tab) => tab.id === initialTab)) {
+    return initialTab;
+  }
+  return first.id;
+}
+function paintTabs(state) {
+  clearChildren(state.tabStrip);
+  const labels = state.tabs.map((tab) => tab.id === state.active ? `[${tab.label}]` : ` ${tab.label} `).join(" ");
+  state.tabStrip.add(new state.otui.TextRenderable(state.chrome.renderer, {
+    id: "modal-tabs",
+    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;
+  if (cleanup !== undefined) {
+    cleanup();
+  }
+  clearChildren(state.body);
+}
+function mountTab(state, input2, tabId) {
+  unmountActiveTab(state);
+  state.active = tabId;
+  paintTabs(state);
+  const cleanup = input2.renderTab(tabId, state.body);
+  state.tabCleanup = typeof cleanup === "function" ? cleanup : undefined;
+}
+function closeHost(state, opts) {
+  if (!state.open) {
+    return;
+  }
+  unmountActiveTab(state);
+  state.open = false;
+  state.input = undefined;
+  state.backdrop.visible = false;
+  const onClose = state.onClose;
+  state.onClose = undefined;
+  if (opts.restoreFocus) {
+    const scroll = state.chrome.scroll;
+    if (state.savedScrollTop !== undefined && scroll !== undefined) {
+      scroll.scrollTop = state.savedScrollTop;
+    }
+    state.chrome.focusComposer();
+  }
+  if (opts.runOnClose && onClose !== undefined) {
+    onClose();
+  }
+}
+function ensureHost(otui, chrome) {
+  const existing = hosts.get(chrome.renderer);
+  if (existing !== undefined) {
+    return existing;
+  }
+  const r = chrome.renderer;
+  const backdrop = new otui.BoxRenderable(r, {
+    id: BACKDROP_ID,
+    position: "absolute",
+    top: 0,
+    left: 0,
+    width: "100%",
+    height: "100%",
+    backgroundColor: "#000000",
+    opacity: BACKDROP_OPACITY,
+    zIndex: 100,
+    flexDirection: "column",
+    justifyContent: "center",
+    alignItems: "center",
+    visible: false
+  });
+  const panel = new otui.BoxRenderable(r, {
+    id: PANEL_ID,
+    width: MODAL_PANEL_WIDTH,
+    height: MODAL_PANEL_HEIGHT,
+    flexShrink: 0,
+    flexGrow: 0,
+    flexDirection: "column",
+    borderStyle: "rounded",
+    border: true,
+    borderColor: "#3a4a4a",
+    backgroundColor: "#0f1b1b",
+    paddingLeft: 1,
+    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: "",
+    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"
+  });
+  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 = {
+    otui,
+    chrome,
+    backdrop,
+    panel,
+    header: header3,
+    titleText,
+    closeText,
+    tabStrip,
+    body,
+    footer,
+    footerText,
+    open: false,
+    generation: 0,
+    tabs: [],
+    active: "",
+    tabCleanup: undefined,
+    onClose: undefined,
+    input: undefined,
+    releaseOverlay: undefined,
+    unsubKeys: undefined,
+    savedScrollTop: undefined
+  };
+  state.releaseOverlay = chrome.addOverlaySource(() => state.open);
+  state.unsubKeys = onKeypress(r, (key) => {
+    if (!state.open || state.input === undefined) {
+      return;
+    }
+    if (key.name === "escape" || key.name === "x" || key.sequence === "x") {
+      closeHost(state, { restoreFocus: true, runOnClose: true });
+      key.preventDefault();
+      key.stopPropagation();
+      return;
+    }
+    const idx = state.tabs.findIndex((tab) => tab.id === state.active);
+    const focused = r.currentFocusedRenderable;
+    const onStrip = focused !== null && containsNode(state.tabStrip, focused);
+    if (key.name === "left" || onStrip && key.name === "tab" && key.shift === true) {
+      const prev = idx > 0 ? state.tabs[idx - 1] : undefined;
+      if (prev !== undefined) {
+        mountTab(state, state.input, prev.id);
+      }
+      key.preventDefault();
+      key.stopPropagation();
+      return;
+    }
+    if (key.name === "right" || onStrip && key.name === "tab") {
+      const next = state.tabs[idx + 1];
+      if (next !== undefined) {
+        mountTab(state, state.input, next.id);
+      }
+      key.preventDefault();
+      key.stopPropagation();
+      return;
+    }
+    if (focused !== null && containsNode(state.body, focused)) {
+      return;
+    }
+    const digit = key.sequence.length === 1 ? key.sequence : key.name;
+    if (digit.length === 1 && digit >= "1" && digit <= "9") {
+      const jump = state.tabs[Number(digit) - 1];
+      if (jump !== undefined) {
+        mountTab(state, state.input, jump.id);
+        key.preventDefault();
+        key.stopPropagation();
+      }
+    }
+  });
+  hosts.set(r, state);
+  return state;
+}
+function makeHandle(state, generation) {
+  return {
+    close() {
+      if (state.generation !== generation) {
+        return;
+      }
+      closeHost(state, { restoreFocus: true, runOnClose: true });
+    },
+    setTab(id) {
+      if (state.generation !== generation || !state.open || state.input === undefined) {
+        return;
+      }
+      if (!state.tabs.some((tab) => tab.id === id) || id === state.active) {
+        return;
+      }
+      mountTab(state, state.input, id);
+    },
+    activeTab() {
+      return state.active;
+    }
+  };
+}
+function openModal(otui, chrome, input2) {
+  if (otui === undefined || chrome === undefined || input2.tabs.length < 1) {
+    return;
+  }
+  const state = ensureHost(otui, chrome);
+  if (state.open) {
+    unmountActiveTab(state);
+    const previousClose = state.onClose;
+    state.onClose = undefined;
+    previousClose?.();
+  } else {
+    state.savedScrollTop = chrome.scroll.scrollTop;
+    chrome.hideMenu();
+    chrome.blurComposer();
+    state.backdrop.visible = true;
+    state.open = true;
+  }
+  state.generation += 1;
+  const generation = state.generation;
+  state.input = input2;
+  state.tabs = input2.tabs;
+  state.onClose = input2.onClose;
+  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 = ["/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);
+}
+function displayOrMissing(value) {
+  return value !== undefined && value.length > 0 ? value : MISSING;
+}
+function formatUtc(iso) {
+  if (iso === undefined || iso.length === 0) {
+    return MISSING;
+  }
+  const date = new Date(iso);
+  if (Number.isNaN(date.getTime())) {
+    return MISSING;
+  }
+  return `${date.toISOString()} UTC`;
+}
+function formatCount(value) {
+  return value === undefined ? MISSING : String(value);
+}
+function usageUsed(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 contextRow(source) {
+  const used = usageUsed(source.usage);
+  if (used !== undefined) {
+    return `${used} tokens`;
+  }
+  if (source.estimateTokens !== undefined) {
+    return `${source.estimateTokens} tokens (estimate)`;
+  }
+  return MISSING;
+}
+function buildSessionInfoSnapshot(source) {
+  const id = source.summary?.id ?? "";
+  const provider = source.selection?.provider ?? source.summary?.provider;
+  const model = source.selection?.model ?? source.summary?.model;
+  const sessionRows = [
+    { label: "Title", value: displayOrMissing(source.summary?.title) },
+    { label: "Version", value: displayOrMissing(source.version) },
+    { label: "Session id", value: displayOrMissing(source.summary?.id) },
+    { label: "Project", value: displayOrMissing(source.summary?.projectPath) },
+    { label: "Provider", value: displayOrMissing(provider) },
+    { label: "Model", value: displayOrMissing(model) }
+  ];
+  if (source.summary?.parentSessionId !== undefined && source.summary.parentSessionId.length > 0) {
+    sessionRows.push({ label: "Parent", value: source.summary.parentSessionId });
+  }
+  const messages = source.summary?.messageCount === undefined && source.summary?.archiveMessageCount === undefined ? MISSING : `${formatCount(source.summary.messageCount)} / ${formatCount(source.summary.archiveMessageCount)}`;
+  sessionRows.push({ label: "Created", value: formatUtc(source.summary?.createdAt) }, { label: "Updated", value: formatUtc(source.summary?.updatedAt) }, { label: "Messages", value: messages }, { label: "Compactions", value: formatCount(source.summary?.compactCount) }, { label: "Context", value: contextRow(source) });
+  const estimate = source.estimateTokens === undefined ? MISSING : `${source.estimateTokens} tokens (estimate)`;
+  const usageRows = [
+    {
+      label: "Last turn input",
+      value: source.usage?.inputTokens === undefined ? MISSING : String(source.usage.inputTokens)
+    },
+    {
+      label: "Last turn output",
+      value: source.usage?.outputTokens === undefined ? MISSING : String(source.usage.outputTokens)
+    },
+    { label: "Context estimate", value: estimate }
+  ];
+  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);
+  return [title, ...rows.map((row) => `  ${row.label.padEnd(width)}  ${row.value}`)].join(`
+`);
+}
+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 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 paintContent(otui, renderer, body, content) {
+  if (otui === undefined || otui === null || body === undefined || body === null) {
+    return;
+  }
+  const parent = body;
+  const ctor = otui.TextRenderable;
+  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);
+  paintContent(otui, renderer, body, rows.map((row) => `${row.label.padEnd(width)}  ${row.value}`).join(`
+`));
+}
+function presentSessionInfo(openModal2, otui, chrome, options) {
+  const { snapshot, toast } = options;
+  const copy = (text) => {
+    if (text.length === 0) {
+      return;
+    }
+    try {
+      options.copyText(text);
+      toast("Copied to clipboard");
+    } catch {}
+  };
+  let unsubscribeKey;
+  const handle = openModal2(otui, chrome, {
+    title: "/status",
+    tabs: statusModalTabs(snapshot),
+    initialTab: "status",
+    footer: SESSION_INFO_FOOTER,
+    renderTab: (tabId, body) => {
+      const renderer = options.renderer ?? chrome?.renderer;
+      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?.();
+    }
+  });
+  if (handle === undefined) {
+    return;
+  }
+  if (options.onKeypress !== undefined) {
+    unsubscribeKey = options.onKeypress((key) => {
+      const token = key.name || key.sequence;
+      if (token === "c") {
+        copy(sessionIdCopyText(snapshot));
+      }
+    });
+  }
+  return handle;
+}
+function openSessionInfo(otui, chrome, options) {
+  return presentSessionInfo((hostOtui, hostChrome, input2) => openModal(hostOtui, hostChrome, input2), otui, chrome, options);
+}
 
 // src/commands/agent-commands.ts
 var CHAT_ONLY = ["chat"];
@@ -44854,6 +45754,12 @@ var AGENT_SLASH_COMMANDS = [
   { name: "/new", description: "Start a new session (old kept on disk)", modes: BOTH },
   { 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: "/status",
+    description: "Show session identity, context, workspaces, and flows",
+    modes: BOTH
+  },
+  { name: "/flows", description: "Browse project flows and inspect one", modes: BOTH },
   {
     name: "/compact",
     description: "Compact model context \u2014 /compact [focus] (archive kept)",
@@ -45334,7 +46240,7 @@ function selectBoxHeight(count, withDescription) {
   const per = withDescription ? 2 : 1;
   return Math.min(Math.max(count * per, per), 16);
 }
-function onKeypress(r, handler) {
+function onKeypress2(r, handler) {
   r._internalKeyInput.onInternal("keypress", handler);
   return () => r._internalKeyInput.offInternal("keypress", handler);
 }
@@ -45435,7 +46341,7 @@ function showComposerChoice(otui, r, dock, request) {
         key.stopPropagation();
       }
     };
-    const unsub = onKeypress(r, onKey);
+    const unsub = onKeypress2(r, onKey);
     sel.on(otui.SelectRenderableEvents.ITEM_SELECTED, () => {
       const chosen = sel.getSelectedOption();
       const value = chosen?.value;
@@ -45723,7 +46629,7 @@ async function checkVersion(options) {
 }
 
 // src/tui/shell-chrome.ts
-function onKeypress2(r, handler) {
+function onKeypress3(r, handler) {
   r._internalKeyInput.onInternal("keypress", handler);
   return () => r._internalKeyInput.offInternal("keypress", handler);
 }
@@ -46153,7 +47059,7 @@ async function createShellChrome(otui, renderer, opts) {
     syncComposerHeight();
     emitSubmit(line);
   };
-  const unsubscribeMenuKeys = onKeypress2(r, (key) => {
+  const unsubscribeMenuKeys = onKeypress3(r, (key) => {
     if (!menu.visible || !menuNav || overlayActive()) {
       return;
     }
@@ -46958,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,
@@ -47019,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;
@@ -47601,7 +48507,7 @@ function overlayBox(otui, r, id) {
     padding: 1
   });
 }
-function onKeypress3(r, handler) {
+function onKeypress4(r, handler) {
   r._internalKeyInput.onInternal("keypress", handler);
   return () => r._internalKeyInput.offInternal("keypress", handler);
 }
@@ -47646,7 +48552,7 @@ function promptBaseUrlStep(otui, r, label, baseUrl2) {
       unsub();
       r.root.remove(box);
     };
-    const unsub = onKeypress3(r, (key) => {
+    const unsub = onKeypress4(r, (key) => {
       if (key.name === "escape") {
         cleanup();
         resolve3(undefined);
@@ -47682,7 +48588,7 @@ function promptApiKeyStep(otui, r, opts) {
         key.stopPropagation();
       }
     };
-    const unsub = onKeypress3(r, onKey);
+    const unsub = onKeypress4(r, onKey);
     const cleanup = () => {
       unsub();
       r.root.remove(box);
@@ -47722,7 +48628,7 @@ function pickProviderStep(otui, r, detected) {
         key.stopPropagation();
       }
     };
-    const unsub = onKeypress3(r, onKey);
+    const unsub = onKeypress4(r, onKey);
     const cleanup = () => {
       unsub();
       r.root.remove(box);
@@ -47840,7 +48746,7 @@ function pickModelInTui(otui, r, models) {
         key.stopPropagation();
       }
     };
-    const unsub = onKeypress3(r, onKey);
+    const unsub = onKeypress4(r, onKey);
     const cleanup = () => {
       unsub();
       r.root.remove(box);
@@ -47932,7 +48838,7 @@ function pickSessionInTui(otui, r, sessions) {
         key.stopPropagation();
       }
     };
-    const unsub = onKeypress3(r, onKey);
+    const unsub = onKeypress4(r, onKey);
     const cleanup = () => {
       unsub();
       r.root.remove(box);
@@ -48117,6 +49023,12 @@ async function launchTuiAgentShell(opts) {
         hasExactUsage = true;
       }
     });
+    let lastUsage;
+    const recordedUsage = io.onUsage?.bind(io);
+    io.onUsage = (usage) => {
+      lastUsage = usage;
+      recordedUsage?.(usage);
+    };
     attachBlockIo(io, addBlock, {
       onReasoning: () => {
         setBusyPhase("thinking");
@@ -48513,6 +49425,42 @@ 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 = () => {
+      (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();
       const label = `${currentSel.provider}/${currentSel.model}`;
@@ -48718,6 +49666,14 @@ Staying in the current session.
 `);
           return;
         }
+        if (command2 !== undefined && isSessionInfoCommand(command2.name)) {
+          showSessionInfo();
+          return;
+        }
+        if (command2 !== undefined && isFlowsCommand(command2.name)) {
+          showFlows();
+          return;
+        }
         if (command2 !== undefined || line.startsWith("/")) {
           transcript.add(new otui.TextRenderable(r, {
             id: `c${uid++}`,
@@ -48859,6 +49815,14 @@ Staying in the current session.
           }
           return;
         }
+        if (isSessionInfoCommand(command.name)) {
+          showSessionInfo();
+          return;
+        }
+        if (isFlowsCommand(command.name)) {
+          showFlows();
+          return;
+        }
         if (command.name === "/copy") {
           const target = newestBlock();
           if (target === undefined || !copyBlock(target.id)) {
@@ -49078,7 +50042,7 @@ Staying in the current session.
         focusComposer();
       });
     };
-    onKeypress3(r, (key) => {
+    onKeypress4(r, (key) => {
       nav.handleKey(key);
     });
     chrome.onSubmit((line) => {
@@ -49204,6 +50168,9 @@ function createChatBridge(hooks = {}) {
         close();
         return "exit";
       }
+      if (isSessionInfoCommand(value) || isFlowsCommand(value)) {
+        return "local";
+      }
       if ((turn || queue.length > 0) && value.startsWith("/")) {
         return "deferred";
       }
@@ -49327,6 +50294,36 @@ async function mountChatShell(otui, renderer, opts) {
       opts.onExit?.();
       return;
     }
+    if (result === "local") {
+      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") {
       append(otui.t`${otui.yellow("\u25C7 a reply is still streaming \u2014 command deferred. Wait for it to finish.")}`);
     }
@@ -49413,82 +50410,6 @@ async function launchTuiChatShell(opts) {
 
 // src/commands/shell.ts
 init_shell_config();
-// package.json
-var package_default = {
-  name: "@mrciphersmith/keryx",
-  version: "0.2.35",
-  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: {
-    access: "public"
-  },
-  license: "MIT",
-  type: "module",
-  repository: {
-    type: "git",
-    url: "git+ssh://git@github.com/MrCipherSmith/keryx.git"
-  },
-  keywords: [
-    "ai-agents",
-    "coding-agents",
-    "agent-harness",
-    "agent-context",
-    "repository-context",
-    "code-graph",
-    "project-memory",
-    "test-impact-analysis",
-    "developer-tools",
-    "model-context-protocol",
-    "mcp",
-    "claude-code",
-    "cursor",
-    "codex",
-    "cli",
-    "bun"
-  ],
-  bin: {
-    keryx: "./dist/cli.js"
-  },
-  scripts: {
-    keryx: "bun ./src/cli.ts",
-    build: "bun build ./src/cli.ts --outdir ./dist --target bun --external @modelcontextprotocol/sdk --external web-tree-sitter --external @opentui/core && bun build ./src/harness/process/sandbox/proxy-worker.ts --outdir ./dist --target bun --external @modelcontextprotocol/sdk --external web-tree-sitter --external @opentui/core",
-    prepare: "bun run build",
-    typecheck: "tsc --noEmit",
-    test: "bun test",
-    check: "tsc --noEmit && bun test",
-    "check:doc-links": "bun scripts/check-doc-links.ts",
-    "test:guards": "bun test src/lib/config-dir.ast.test.ts src/lib/config-dir.readers.test.ts src/lib/production-graph.test.ts src/harness/policy/profiles.test.ts src/lib/serve-server.test.ts"
-  },
-  files: [
-    "dist",
-    "docs/requirements/shared-agent-context/schemas",
-    "src/gdgraph",
-    "src/gdskills/bundled",
-    "src/gdskills/contracts",
-    "LICENSE",
-    "README.md",
-    "package.json"
-  ],
-  dependencies: {},
-  optionalDependencies: {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "@opentui/core": "^0.4.5",
-    "web-tree-sitter": "^0.22.0"
-  },
-  devDependencies: {
-    "@types/bun": "latest",
-    "@xenova/transformers": "^2.17.2",
-    "bun-types": "latest",
-    typescript: "^5"
-  },
-  engines: {
-    bun: ">=1.1.0"
-  },
-  trustedDependencies: [
-    "protobufjs",
-    "sharp"
-  ]
-};
 
 // src/commands/select.ts
 init_guard2();
@@ -49727,6 +50648,8 @@ var READLINE_AGENT_COMMANDS = [
   "/new",
   "/clear",
   "/compact",
+  "/status",
+  "/flows",
   "/exit"
 ];
 function readlineAgentHelpText() {
@@ -49815,6 +50738,34 @@ Starting a new session.
         system(HELP_TEXT);
         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),
+          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 });
@@ -50462,6 +51413,32 @@ 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),
+          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) {
@@ -50748,7 +51725,7 @@ async function shellCommand(args2, runtime = {}) {
           modelId: sel.model
         }),
         maxToolCalls: resolveAgentMaxToolCalls(),
-        idSeq: () => randomUUID17()
+        idSeq: () => randomUUID18()
       };
     };
     const redetect = () => detectProviders({
@@ -50779,7 +51756,7 @@ async function shellCommand(args2, runtime = {}) {
         makeShellDeps: (sel) => ({
           makeProvider: chatFactory,
           clock: () => new Date().toISOString(),
-          idSeq: () => randomUUID17(),
+          idSeq: () => randomUUID18(),
           initial: sel,
           session: {
             cwd,
@@ -50849,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)
     };
@@ -50897,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) {
@@ -51229,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();
@@ -51556,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,
@@ -51640,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);
@@ -51680,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) {
@@ -51994,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";
@@ -52113,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();
@@ -52256,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" };
@@ -52943,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,
@@ -56642,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
@@ -56710,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") {
@@ -56724,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") {
@@ -56735,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") {
@@ -56747,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"))
@@ -56764,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"))
@@ -56787,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));
@@ -56804,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;
     }
@@ -56816,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") {