@mrciphersmith/keryx 0.2.159 → 0.2.160

package/dist/cli.js

@@ -53009,7 +53009,7 @@ import path47 from "path";
 // package.json
 var package_default = {
   name: "@mrciphersmith/keryx",
-  version: "0.2.159",
+  version: "0.2.160",
   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: {
@@ -74308,15 +74308,15 @@ function extractCapabilities(manifest) {
 
 // src/standard/help-groups.ts
 var HELP_GROUP_ORDER = [
-  { name: "Start here", slug: "start-here" },
-  { name: "Connect a model provider", slug: "connect" },
-  { name: "Look and feel", slug: "look-and-feel" },
-  { name: "Working in keryx shell", slug: "shell-work" },
-  { name: "Project knowledge", slug: "project-knowledge" },
-  { name: "Managed work", slug: "managed-work" },
-  { name: "Automation", slug: "automation" },
-  { name: "External agents, ACP and MCP", slug: "external-agents" },
-  { name: "Maintenance and diagnostics", slug: "maintenance" }
+  { name: "Start here", slug: "start-here", tab: "Start", tabShort: "Start" },
+  { name: "Connect a model provider", slug: "connect", tab: "Connect", tabShort: "Conn" },
+  { name: "Look and feel", slug: "look-and-feel", tab: "Look", tabShort: "Look" },
+  { name: "Working in keryx shell", slug: "shell-work", tab: "Shell", tabShort: "Shell" },
+  { name: "Project knowledge", slug: "project-knowledge", tab: "Knowledge", tabShort: "Know" },
+  { name: "Managed work", slug: "managed-work", tab: "Work", tabShort: "Work" },
+  { name: "Automation", slug: "automation", tab: "Automate", tabShort: "Auto" },
+  { name: "External agents, ACP and MCP", slug: "external-agents", tab: "Agents", tabShort: "Agents" },
+  { name: "Maintenance and diagnostics", slug: "maintenance", tab: "Maintain", tabShort: "Maint" }
 ];
 var HELP_GROUPS = [
   { kind: "cli", name: "init", group: "Start here", summary: "Initialize .metaproject in the current project." },
@@ -74762,15 +74762,29 @@ function renderEntryRows(entries, maxColumns) {
   }
   return rows;
 }
+var SHELL_SUBHEADING = "  in keryx shell:";
+function renderGroupLines(group, maxColumns) {
+  const cliEntries = entriesInGroup(group.name, "cli");
+  const slashEntries = entriesInGroup(group.name, "slash");
+  if (cliEntries.length === 0 && slashEntries.length === 0) {
+    return [];
+  }
+  const lines = [`${group.name}:`];
+  lines.push(...renderEntryRows(cliEntries, maxColumns));
+  if (slashEntries.length > 0) {
+    lines.push(SHELL_SUBHEADING);
+    lines.push(...renderEntryRows(slashEntries, maxColumns));
+  }
+  return lines;
+}
 function renderGroupedCliHelp(maxColumns = HELP_DEFAULT_COLUMNS) {
   const lines = [];
   for (const group of HELP_GROUP_ORDER) {
-    const entries = entriesInGroup(group.name, "cli");
-    if (entries.length === 0) {
+    const groupLines = renderGroupLines(group, maxColumns);
+    if (groupLines.length === 0) {
       continue;
     }
-    lines.push(`${group.name}:`);
-    lines.push(...renderEntryRows(entries, maxColumns));
+    lines.push(...groupLines);
     lines.push("");
   }
   return lines.join(`
@@ -74778,8 +74792,7 @@ function renderGroupedCliHelp(maxColumns = HELP_DEFAULT_COLUMNS) {
 `);
 }
 function renderCliGroupHelp(group, maxColumns = HELP_DEFAULT_COLUMNS) {
-  const entries = entriesInGroup(group.name, "cli");
-  const lines = [`${group.name}:`, ...renderEntryRows(entries, maxColumns)];
+  const lines = renderGroupLines(group, maxColumns);
   return lines.join(`
 `) + `
 `;
@@ -74798,12 +74811,12 @@ function renderGroupedNamedHelp(options, maxColumns) {
 `) + `
 `;
 }
-function renderEntryDetail(entry) {
-  const lines = [`${entry.name}`, "", entry.summary, ""];
+function renderEntryDetail(entry, maxColumns = HELP_DEFAULT_COLUMNS) {
+  const lines = [`${entry.name}`, "", ...wrapWords(entry.summary, maxColumns), ""];
   if (entry.kind === "slash") {
-    lines.push("This is a keryx shell command \u2014 type it inside `keryx shell` (readline chat/agent mode, or the", "TUI's `/`-menu). It has no standalone CLI form.");
+    lines.push(...wrapWords("This is a keryx shell command \u2014 type it inside `keryx shell` (readline chat/agent mode, or " + "the TUI's `/`-menu). It has no standalone CLI form.", maxColumns));
   } else {
-    lines.push(`Run \`keryx ${entry.name} --help\` (or \`keryx help ${entry.name}\`) for its full usage.`);
+    lines.push(...wrapWords(`Run \`keryx ${entry.name} --help\` (or \`keryx help ${entry.name}\`) for its full usage.`, maxColumns));
   }
   return lines.join(`
 `) + `
@@ -109997,7 +110010,32 @@ function openSessionInfo(otui, chrome, options) {
 // src/tui/help-modal.ts
 var HELP_MODAL_TITLE = "/help";
 var HELP_MODAL_KEYS = "keys: \u2191/\u2193 select \xB7 enter details \xB7 \u2190/\u2192 tabs \xB7 esc close";
-var HELP_MODAL_TABS = HELP_GROUP_ORDER.map((g) => ({ id: g.slug, label: g.name }));
+var HELP_MODAL_TABS = HELP_GROUP_ORDER.map((g) => ({ id: g.slug, label: g.tab }));
+var HELP_MODAL_TABS_SHORT = HELP_GROUP_ORDER.map((g) => ({ id: g.slug, label: g.tabShort }));
+function tabStripWidth(labels) {
+  return labels.reduce((total, label, i) => total + label.length + 2 + (i === 0 ? 0 : 1), 0);
+}
+var READABLE_TAB_STRIP_WIDTH = tabStripWidth(HELP_MODAL_TABS.map((t) => t.label));
+function pickTabs(chrome, options) {
+  let cols;
+  let rows;
+  if (options.renderer !== undefined) {
+    cols = options.renderer.width;
+    rows = options.renderer.height;
+  } else {
+    const c = chrome;
+    if (c?.renderer !== undefined) {
+      cols = resolveModalAvailableWidth(c);
+      rows = c.renderer.height;
+    }
+  }
+  if (typeof cols !== "number" || typeof rows !== "number") {
+    return HELP_MODAL_TABS_SHORT;
+  }
+  const panelWidth = Math.min(cols, resolveModalPanelSize(cols, rows).width);
+  const innerWidth = panelWidth - MODAL_PANEL_CHROME_X;
+  return READABLE_TAB_STRIP_WIDTH <= innerWidth ? HELP_MODAL_TABS : HELP_MODAL_TABS_SHORT;
+}
 function entriesForGroup(group) {
   return [...entriesInGroup(group.name, "cli"), ...entriesInGroup(group.name, "slash")];
 }
@@ -110010,9 +110048,10 @@ function openHelpModal(otui, chrome, options) {
   const core = otui;
   const r = chrome?.renderer;
   const bodyRows = bodyRowsFor2(chrome, options);
+  const tabs = pickTabs(chrome, options);
   const states = new Map(HELP_GROUP_ORDER.map((group) => [
     group.slug,
-    { entries: entriesForGroup(group), selected: 0, detail: false, scroll: 0 }
+    { groupName: group.name, entries: entriesForGroup(group), selected: 0, detail: false, scroll: 0 }
   ]));
   let width;
   let bodyNode;
@@ -110020,23 +110059,29 @@ function openHelpModal(otui, chrome, options) {
   const keys = {};
   const host = {};
   const activeState = () => {
-    const id = host.handle?.activeTab() ?? (HELP_MODAL_TABS[0]?.id ?? "");
+    const id = host.handle?.activeTab() ?? (tabs[0]?.id ?? "");
     const existing = states.get(id);
     if (existing !== undefined) {
       return existing;
     }
-    const fallback = { entries: [], selected: 0, detail: false, scroll: 0 };
+    const fallback = { groupName: "", entries: [], selected: 0, detail: false, scroll: 0 };
     states.set(id, fallback);
     return fallback;
   };
   const tabLines = (state) => {
+    const heading = `${state.groupName}:`;
     if (state.entries.length === 0) {
-      return [HELP_MODAL_KEYS, "", "(no commands in this group)"];
+      return [heading, HELP_MODAL_KEYS, "", "(no commands in this group)"];
     }
     if (state.detail) {
       const entry = state.entries[state.selected];
-      return [HELP_MODAL_KEYS, "", ...entry === undefined ? ["(nothing selected)"] : wrapLines(renderEntryDetail(entry), width).split(`
-`)];
+      return [
+        heading,
+        HELP_MODAL_KEYS,
+        "",
+        ...entry === undefined ? ["(nothing selected)"] : wrapLines(renderEntryDetail(entry), width).split(`
+`)
+      ];
     }
     const rows = state.entries.map((entry, i) => {
       const marker = i === state.selected ? ">" : " ";
@@ -110045,7 +110090,7 @@ function openHelpModal(otui, chrome, options) {
 `).join(`
 `);
     });
-    return [HELP_MODAL_KEYS, "", ...rows];
+    return [heading, HELP_MODAL_KEYS, "", ...rows];
   };
   const paint = () => {
     if (closed) {
@@ -110054,7 +110099,7 @@ function openHelpModal(otui, chrome, options) {
     const state = activeState();
     const lines = tabLines(state);
     if (!state.detail) {
-      state.scroll = scrollToReveal(state.selected + 2, state.scroll, bodyRows);
+      state.scroll = scrollToReveal(state.selected + 3, state.scroll, bodyRows);
     }
     state.scroll = clampScroll(state.scroll, lines.length, bodyRows);
     if (bodyNode !== undefined) {
@@ -110065,7 +110110,7 @@ function openHelpModal(otui, chrome, options) {
   const initialTab = options.initialGroupSlug !== undefined && groupBySlug(options.initialGroupSlug) !== undefined ? options.initialGroupSlug : undefined;
   const handle = openModal(core, chrome, {
     title: HELP_MODAL_TITLE,
-    tabs: HELP_MODAL_TABS,
+    tabs,
     ...initialTab !== undefined ? { initialTab } : {},
     footer: [
       { key: "\u2191/\u2193", label: "select" },

package/dist/core.js

@@ -26937,15 +26937,15 @@ function extractCapabilities(manifest) {
 
 // src/standard/help-groups.ts
 var HELP_GROUP_ORDER = [
-  { name: "Start here", slug: "start-here" },
-  { name: "Connect a model provider", slug: "connect" },
-  { name: "Look and feel", slug: "look-and-feel" },
-  { name: "Working in keryx shell", slug: "shell-work" },
-  { name: "Project knowledge", slug: "project-knowledge" },
-  { name: "Managed work", slug: "managed-work" },
-  { name: "Automation", slug: "automation" },
-  { name: "External agents, ACP and MCP", slug: "external-agents" },
-  { name: "Maintenance and diagnostics", slug: "maintenance" }
+  { name: "Start here", slug: "start-here", tab: "Start", tabShort: "Start" },
+  { name: "Connect a model provider", slug: "connect", tab: "Connect", tabShort: "Conn" },
+  { name: "Look and feel", slug: "look-and-feel", tab: "Look", tabShort: "Look" },
+  { name: "Working in keryx shell", slug: "shell-work", tab: "Shell", tabShort: "Shell" },
+  { name: "Project knowledge", slug: "project-knowledge", tab: "Knowledge", tabShort: "Know" },
+  { name: "Managed work", slug: "managed-work", tab: "Work", tabShort: "Work" },
+  { name: "Automation", slug: "automation", tab: "Automate", tabShort: "Auto" },
+  { name: "External agents, ACP and MCP", slug: "external-agents", tab: "Agents", tabShort: "Agents" },
+  { name: "Maintenance and diagnostics", slug: "maintenance", tab: "Maintain", tabShort: "Maint" }
 ];
 var HELP_GROUPS = [
   { kind: "cli", name: "init", group: "Start here", summary: "Initialize .metaproject in the current project." },
@@ -27408,15 +27408,29 @@ function renderEntryRows(entries, maxColumns) {
   }
   return rows;
 }
+var SHELL_SUBHEADING = "  in keryx shell:";
+function renderGroupLines(group, maxColumns) {
+  const cliEntries = entriesInGroup(group.name, "cli");
+  const slashEntries = entriesInGroup(group.name, "slash");
+  if (cliEntries.length === 0 && slashEntries.length === 0) {
+    return [];
+  }
+  const lines = [`${group.name}:`];
+  lines.push(...renderEntryRows(cliEntries, maxColumns));
+  if (slashEntries.length > 0) {
+    lines.push(SHELL_SUBHEADING);
+    lines.push(...renderEntryRows(slashEntries, maxColumns));
+  }
+  return lines;
+}
 function renderGroupedCliHelp(maxColumns = HELP_DEFAULT_COLUMNS) {
   const lines = [];
   for (const group of HELP_GROUP_ORDER) {
-    const entries = entriesInGroup(group.name, "cli");
-    if (entries.length === 0) {
+    const groupLines = renderGroupLines(group, maxColumns);
+    if (groupLines.length === 0) {
       continue;
     }
-    lines.push(`${group.name}:`);
-    lines.push(...renderEntryRows(entries, maxColumns));
+    lines.push(...groupLines);
     lines.push("");
   }
   return lines.join(`
@@ -27424,8 +27438,7 @@ function renderGroupedCliHelp(maxColumns = HELP_DEFAULT_COLUMNS) {
 `);
 }
 function renderCliGroupHelp(group, maxColumns = HELP_DEFAULT_COLUMNS) {
-  const entries = entriesInGroup(group.name, "cli");
-  const lines = [`${group.name}:`, ...renderEntryRows(entries, maxColumns)];
+  const lines = renderGroupLines(group, maxColumns);
   return lines.join(`
 `) + `
 `;
@@ -27459,12 +27472,12 @@ function renderGroupedNamedHelp(options, maxColumns) {
 `) + `
 `;
 }
-function renderEntryDetail(entry) {
-  const lines = [`${entry.name}`, "", entry.summary, ""];
+function renderEntryDetail(entry, maxColumns = HELP_DEFAULT_COLUMNS) {
+  const lines = [`${entry.name}`, "", ...wrapWords(entry.summary, maxColumns), ""];
   if (entry.kind === "slash") {
-    lines.push("This is a keryx shell command \u2014 type it inside `keryx shell` (readline chat/agent mode, or the", "TUI's `/`-menu). It has no standalone CLI form.");
+    lines.push(...wrapWords("This is a keryx shell command \u2014 type it inside `keryx shell` (readline chat/agent mode, or " + "the TUI's `/`-menu). It has no standalone CLI form.", maxColumns));
   } else {
-    lines.push(`Run \`keryx ${entry.name} --help\` (or \`keryx help ${entry.name}\`) for its full usage.`);
+    lines.push(...wrapWords(`Run \`keryx ${entry.name} --help\` (or \`keryx help ${entry.name}\`) for its full usage.`, maxColumns));
   }
   return lines.join(`
 `) + `

package/package.json

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