@mrciphersmith/keryx 0.2.35 → 0.2.36

package/dist/cli.js

@@ -44796,6 +44796,492 @@ 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.36",
+  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 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 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: "80%",
+    maxWidth: 72,
+    maxHeight: "80%",
+    flexShrink: 0,
+    flexDirection: "column",
+    borderStyle: "rounded",
+    border: true,
+    borderColor: "#3a4a4a",
+    backgroundColor: "#0f1b1b",
+    paddingLeft: 1,
+    paddingRight: 1,
+    zIndex: 101
+  });
+  const titleText = new otui.TextRenderable(r, {
+    id: "modal-title",
+    content: ""
+  });
+  const tabStrip = new otui.BoxRenderable(r, {
+    id: "modal-tab-strip",
+    flexShrink: 0,
+    width: "100%",
+    flexDirection: "row",
+    focusable: true
+  });
+  const body = new otui.BoxRenderable(r, {
+    id: "modal-body",
+    width: "100%",
+    minHeight: 1,
+    flexDirection: "column"
+  });
+  panel.add(titleText);
+  panel.add(tabStrip);
+  panel.add(body);
+  backdrop.add(panel);
+  r.root.add(backdrop);
+  const state = {
+    otui,
+    chrome,
+    backdrop,
+    panel,
+    titleText,
+    tabStrip,
+    body,
+    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") {
+      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;
+  state.titleText.content = otui.t`${otui.bold(input2.title)}`;
+  mountTab(state, input2, resolveInitialTab(input2.tabs, input2.initialTab));
+  state.tabStrip.focus();
+  return makeHandle(state, generation);
+}
+
+// src/tui/session-info.ts
+var SESSION_INFO_COMMANDS = ["/session-info", "/status", "/info"];
+var MISSING = "\u2014";
+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 }
+  ];
+  return { sessionId: id, sessionRows, usageRows };
+}
+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) {
+  return `${formatSection("Session", snapshot.sessionRows)}
+
+${formatSection("Usage", snapshot.usageRows)}
+`;
+}
+function sessionIdCopyText(snapshot) {
+  return snapshot.sessionId;
+}
+function sessionBlockCopyText(snapshot) {
+  return formatSessionInfoText(snapshot);
+}
+function paintRows(otui, renderer, body, rows) {
+  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 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(`
+`)
+  }));
+}
+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: "Session",
+    tabs: [
+      { id: "session", label: "Session" },
+      { id: "usage", label: "Usage" }
+    ],
+    initialTab: "session",
+    renderTab: (tabId, body) => {
+      const rows = tabId === "usage" ? snapshot.usageRows : snapshot.sessionRows;
+      const renderer = options.renderer ?? chrome?.renderer;
+      paintRows(otui, renderer, body, rows);
+    },
+    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));
+      } else if (token === "y") {
+        copy(sessionBlockCopyText(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 +45340,13 @@ 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: "/session-info",
+    description: "Show session identity and context usage",
+    modes: BOTH
+  },
+  { name: "/status", description: "Alias of /session-info", modes: BOTH },
+  { name: "/info", description: "Alias of /session-info", modes: BOTH },
   {
     name: "/compact",
     description: "Compact model context \u2014 /compact [focus] (archive kept)",
@@ -45334,7 +45827,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 +45928,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 +46216,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 +46646,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;
     }
@@ -47601,7 +48094,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 +48139,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 +48175,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 +48215,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 +48333,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 +48425,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 +48610,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 +49012,22 @@ Staying in the current session.
 `);
     };
     paintSessionHeader();
+    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))
+      });
+    };
     const updateModelLabels = () => {
       paintSessionHeader();
       const label = `${currentSel.provider}/${currentSel.model}`;
@@ -48718,6 +49233,10 @@ Staying in the current session.
 `);
           return;
         }
+        if (command2 !== undefined && isSessionInfoCommand(command2.name)) {
+          showSessionInfo();
+          return;
+        }
         if (command2 !== undefined || line.startsWith("/")) {
           transcript.add(new otui.TextRenderable(r, {
             id: `c${uid++}`,
@@ -48859,6 +49378,10 @@ Staying in the current session.
           }
           return;
         }
+        if (isSessionInfoCommand(command.name)) {
+          showSessionInfo();
+          return;
+        }
         if (command.name === "/copy") {
           const target = newestBlock();
           if (target === undefined || !copyBlock(target.id)) {
@@ -49078,7 +49601,7 @@ Staying in the current session.
         focusComposer();
       });
     };
-    onKeypress3(r, (key) => {
+    onKeypress4(r, (key) => {
       nav.handleKey(key);
     });
     chrome.onSubmit((line) => {
@@ -49204,6 +49727,9 @@ function createChatBridge(hooks = {}) {
         close();
         return "exit";
       }
+      if (isSessionInfoCommand(value)) {
+        return "local";
+      }
       if ((turn || queue.length > 0) && value.startsWith("/")) {
         return "deferred";
       }
@@ -49327,6 +49853,22 @@ async function mountChatShell(otui, renderer, opts) {
       opts.onExit?.();
       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))
+      });
+      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 +49955,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 +50193,9 @@ var READLINE_AGENT_COMMANDS = [
   "/new",
   "/clear",
   "/compact",
+  "/session-info",
+  "/status",
+  "/info",
   "/exit"
 ];
 function readlineAgentHelpText() {
@@ -49815,6 +50284,15 @@ Starting a new session.
         system(HELP_TEXT);
         continue;
       }
+      if (isSessionInfoCommand(command)) {
+        system(formatSessionInfoText(buildSessionInfoSnapshot({
+          summary: live?.summary,
+          selection: { provider: providerName, model: modelName },
+          version: package_default.version,
+          estimateTokens: estimateContextTokens(history)
+        })));
+        continue;
+      }
       if (command === "/clear" || command === "/new") {
         if (sessionsOn) {
           live = createSession({ cwd: sessionCwd, provider: providerName, model: modelName });
@@ -50462,6 +50940,14 @@ New session ${shortSessionId(live.summary.id)}.
       }
       if (command === "/help") {
         agentIo.onSystem?.(readlineAgentHelpText());
+      } else if (isSessionInfoCommand(command)) {
+        agentIo.onSystem?.(formatSessionInfoText(buildSessionInfoSnapshot({
+          summary: live?.summary,
+          selection: { provider: deps.providerId, model: deps.modelId },
+          version: package_default.version,
+          usage: lastUsage,
+          estimateTokens: estimateContextTokens(history)
+        })));
       } else if (command === "/expand") {
         const expanded = expandedToolOutput(lastToolName, lastToolOutput);
         if (expanded !== undefined) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrciphersmith/keryx",
-  "version": "0.2.35",
+  "version": "0.2.36",
   "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": {