@karmaniverous/jeeves-server 3.5.1 → 3.6.0

package/CHANGELOG.md

@@ -2,11 +2,42 @@
 
 All notable changes to this project will be documented in this file. Dates are displayed in UTC.
 
-#### [3.5.1](https://github.com/karmaniverous/jeeves-server/compare/service/3.5.0...3.5.1)
+#### [3.6.0](https://github.com/karmaniverous/jeeves-server/compare/service/3.5.2...3.6.0)
+
+- feat: v3.6.0 core v0.5.1 adoption + core service alignment + UX improvements [`#146`](https://github.com/karmaniverous/jeeves-server/pull/146)
+- [360] feat: Phase 3 — UX improvements (CSV tables, directory item counts, collapsible frontmatter, collapsible TOC) [`#48`](https://github.com/karmaniverous/jeeves-server/issues/48)
+- [360] feat: Phase 1 — core service adoption (getServiceUrl, getBindAddress, Node 22 fast-fail) [`#135`](https://github.com/karmaniverous/jeeves-server/issues/135)
+- [360] test: add missing test coverage for v3.6.0 features [`c23f7a1`](https://github.com/karmaniverous/jeeves-server/commit/c23f7a1dfa03517d2ed8a28eb0ef06da05379e38)
+- [360] refactor: address code review — async directory reads, CSV row normalization, extract mapDirectoryEntry [`3a1a389`](https://github.com/karmaniverous/jeeves-server/commit/3a1a389ee5f3a4ce1d8e28db204784ea9fefd1d5)
+- npm audit fix [`0be936a`](https://github.com/karmaniverous/jeeves-server/commit/0be936a6dbbfb07b1f7d62e334d307a0fb0db3f8)
+- [360] refactor: split TocSection.tsx — move utilities to tocUtils.ts (fixes react-refresh lint) [`d8e8d57`](https://github.com/karmaniverous/jeeves-server/commit/d8e8d57df8eefc419bdcafed08f0a60ccd4e481d)
+- [360] chore: remove TASK.md build artifact, DRY up Node version check and fix minor issues [`3e569db`](https://github.com/karmaniverous/jeeves-server/commit/3e569dbca069ea659ee5b1ca9030caa43ae4fea5)
+- [360] docs: Phase 4 — documentation updates for v3.6.0 [`8e0be64`](https://github.com/karmaniverous/jeeves-server/commit/8e0be6472e300c6117dc0c917b76686015931a85)
+- [360] feat: Phase 2 — core v0.5.1 wiring (cleanup escalation, getPackageVersion, substituteEnvVars TODO) [`2b97c20`](https://github.com/karmaniverous/jeeves-server/commit/2b97c209c0caaf99d27f36a6dff397ddbb4e168d)
+- chore: release @karmaniverous/jeeves-server-openclaw v0.6.2 [`f120979`](https://github.com/karmaniverous/jeeves-server/commit/f1209795471958090f3fb18b4eda4bb62415da36)
+- [360] chore: Phase 5 — quality gates clean (knip fixes, remove package-directory dep) [`a436c46`](https://github.com/karmaniverous/jeeves-server/commit/a436c462311b07bf5975e6ba8b0d75c2e216e637)
+- [360] ci: drop Node 20 from Linux compatibility matrix (engine floor is now 22) [`5b690e6`](https://github.com/karmaniverous/jeeves-server/commit/5b690e6644e1e4dd2c7f66e089cf4d190daeeb32)
+- [360] docs: fix Node version in deployment guide (20 → 22) [`dde5cd2`](https://github.com/karmaniverous/jeeves-server/commit/dde5cd2f3d876a8227be823de78ccbda003e9f62)
+
+#### [service/3.5.2](https://github.com/karmaniverous/jeeves-server/compare/service/3.5.1...service/3.5.2)
+
+> 31 March 2026
+
+- [53] Fix pre-existing lint + knip errors (Commander type resolution) [`#140`](https://github.com/karmaniverous/jeeves-server/pull/140)
+- [53] Integrate core v0.4.6: init() before descriptor.run() + knip fixes [`#139`](https://github.com/karmaniverous/jeeves-server/pull/139)
+- [53] chore: bump core to v0.4.6 (init before run) + fix knip issues [`e5f466a`](https://github.com/karmaniverous/jeeves-server/commit/e5f466a0df574e1052601fc99b0110aaf2136666)
+- [53] chore: bump core to v0.4.6 (init before run) + fix knip issues [`cc2adb6`](https://github.com/karmaniverous/jeeves-server/commit/cc2adb6c4d2a540a145bdcb04a712b2f6b77fa9e)
+- chore: release @karmaniverous/jeeves-server-openclaw v0.6.1 [`b0a4bec`](https://github.com/karmaniverous/jeeves-server/commit/b0a4bec47f5141d13e59070683f7d459e82a9faa)
+- chore: release @karmaniverous/jeeves-server v3.5.2 [`08f6a37`](https://github.com/karmaniverous/jeeves-server/commit/08f6a37a4bc2802b9c1e65a2ed38482fffa2678b)
+
+#### [service/3.5.1](https://github.com/karmaniverous/jeeves-server/compare/service/3.5.0...service/3.5.1)
+
+> 31 March 2026
 
 - [51] Integrate descriptor.run from core v0.4.5 [`#137`](https://github.com/karmaniverous/jeeves-server/pull/137)
 - chore: release @karmaniverous/jeeves-server-openclaw v0.6.0 [`bfa7501`](https://github.com/karmaniverous/jeeves-server/commit/bfa7501f80fb1c2c8a29f7e548b4092f1bc44395)
 - [51] feat: integrate descriptor.run from core v0.4.5 [`74bebef`](https://github.com/karmaniverous/jeeves-server/commit/74bebef9adfe433621c1f4dd1b4877634ee65f6f)
+- chore: release @karmaniverous/jeeves-server v3.5.1 [`fd56acc`](https://github.com/karmaniverous/jeeves-server/commit/fd56accdacacc97bf47f18e489df6d87b8d6be35)
 
 #### [service/3.5.0](https://github.com/karmaniverous/jeeves-server/compare/service/3.4.2...service/3.5.0)
 

package/client/package.json

@@ -28,7 +28,6 @@
     "@codemirror/state": "^6.6.0",
     "@codemirror/theme-one-dark": "^6.1.3",
     "@codemirror/view": "^6.40.0",
-    "@karmaniverous/jeeves": "^0.4.5",
     "@panzoom/panzoom": "^4.6.1",
     "@radix-ui/react-alert-dialog": "^1.1.15",
     "@radix-ui/react-dropdown-menu": "^2.1.16",

package/client/src/components/DirectoryRow.tsx

@@ -55,7 +55,11 @@ export function DirectoryRow({ entry, basePath, isInsider, shareSettings, onShar
         </div>
       </td>
       <td className="px-4 py-2.5 text-muted-foreground text-sm">{typeLabel}</td>
-      <td className="px-4 py-2.5 text-muted-foreground text-sm">{formatSize(entry.size)}</td>
+      <td className="px-4 py-2.5 text-muted-foreground text-sm">
+        {isDir
+          ? (entry.itemCount != null ? `${entry.itemCount} ${entry.itemCount === 1 ? 'item' : 'items'}` : '-')
+          : formatSize(entry.size)}
+      </td>
       <td className="px-4 py-2.5 text-muted-foreground text-sm">{entry.mtime ?? '-'}</td>
     </tr>
   );

package/client/src/components/FileContentView.tsx

@@ -115,6 +115,13 @@ export function FileContentView({
         />
       )}
 
+      {/* CSV */}
+      {fileRendered?.type === 'csv' && fileRendered.html && activeTab === 'rendered' && (
+        <div className={`prose prose-sm dark:prose-invert max-w-none ${proseWidth === 'narrow' ? 'max-w-prose mx-auto' : proseWidth === 'medium' ? 'max-w-4xl mx-auto' : ''}`}>
+          <div className="overflow-x-auto" dangerouslySetInnerHTML={{ __html: fileRendered.html }} />
+        </div>
+      )}
+
       {/* SVG */}
       {fileRendered?.type === 'svg' && fileRendered.content && activeTab === 'rendered' && (
         <SvgViewer content={fileRendered.content} />

package/client/src/components/MarkdownView.tsx

@@ -1,10 +1,14 @@
 /**
- * Markdown rendered view with TOC sidebar.
+ * Markdown rendered view with collapsible TOC sidebar.
  */
-import type { FileContent } from '@/lib/api';
+import { useCallback, useMemo, useState } from 'react';
+
 import { initEmbeddedDiagramPanzoom } from '@/components/EmbeddedDiagramPanzoom';
 import { initLazyDiagrams } from '@/components/LazyDiagram';
 import { initInlineSvgPanzoom } from '@/components/InlineSvgPanzoom';
+import { TocSection } from '@/components/TocSection';
+import { buildTocTree, findAncestorSlugs } from '@/components/tocUtils';
+import type { FileContent } from '@/lib/api';
 import { initCodeBlockCm6 } from '@/lib/codeBlockCm6';
 import { injectCopyButtons } from '@/lib/codeBlockCopy';
 import { useTheme } from '@/lib/theme';
@@ -27,6 +31,47 @@ export function MarkdownView({
   const plainCode = new URLSearchParams(window.location.search).has('plain_code');
   const hasHeadings = fileRendered.headings && fileRendered.headings.length > 2;
 
+  // Build TOC tree and collapse state
+  const tocTree = useMemo(
+    () => (hasHeadings ? buildTocTree(fileRendered.headings!) : []),
+    [fileRendered.headings, hasHeadings],
+  );
+
+  const [collapsed, setCollapsed] = useState<Set<string>>(() => new Set());
+
+  const toggleCollapse = useCallback((slug: string) => {
+    setCollapsed((prev) => {
+      const next = new Set(prev);
+      if (next.has(slug)) next.delete(slug);
+      else next.add(slug);
+      return next;
+    });
+  }, []);
+
+  const scrollToHeading = useCallback(
+    (slug: string) => {
+      // Auto-expand ancestors if collapsed
+      const ancestors = findAncestorSlugs(tocTree, slug);
+      if (ancestors.some((a) => collapsed.has(a))) {
+        setCollapsed((prev) => {
+          const next = new Set(prev);
+          for (const a of ancestors) next.delete(a);
+          return next;
+        });
+      }
+      scrollToIdInContainer(mainRef.current, slug);
+    },
+    [tocTree, collapsed, mainRef],
+  );
+
+  const mobileScrollTo = useCallback(
+    (slug: string) => {
+      scrollToHeading(slug);
+      setMobileTocOpen(false);
+    },
+    [scrollToHeading, setMobileTocOpen],
+  );
+
   return (
     <>
       {/* Mobile TOC overlay */}
@@ -38,16 +83,14 @@ export function MarkdownView({
             style={{ top: `${topBarHeight + 4}px` }}
           >
             <nav>
-              {fileRendered.headings!.map((h) => (
-                <button
-                  key={h.slug}
-                  type="button"
-                  onClick={() => { scrollToIdInContainer(mainRef.current, h.slug); setMobileTocOpen(false); }}
-                  className="block text-left text-sm text-muted-foreground hover:text-foreground cursor-pointer py-1 transition-colors w-full"
-                  style={{ paddingLeft: `${(h.level - 1) * 0.75}rem` }}
-                >
-                  {h.text}
-                </button>
+              {tocTree.map((node) => (
+                <TocSection
+                  key={node.heading.slug}
+                  node={node}
+                  collapsed={collapsed}
+                  toggleCollapse={toggleCollapse}
+                  scrollTo={mobileScrollTo}
+                />
               ))}
             </nav>
           </div>
@@ -63,16 +106,14 @@ export function MarkdownView({
           >
             <div className="text-xs font-semibold text-muted-foreground uppercase tracking-wider mb-2">Contents</div>
             <nav className="border-l border-border pl-3">
-              {fileRendered.headings!.map((h) => (
-                <button
-                  key={h.slug}
-                  type="button"
-                  onClick={() => scrollToIdInContainer(mainRef.current, h.slug)}
-                  className="block text-left text-sm text-muted-foreground hover:text-foreground cursor-pointer py-0.5 transition-colors"
-                  style={{ paddingLeft: `${(h.level - 1) * 0.75}rem` }}
-                >
-                  {h.text}
-                </button>
+              {tocTree.map((node) => (
+                <TocSection
+                  key={node.heading.slug}
+                  node={node}
+                  collapsed={collapsed}
+                  toggleCollapse={toggleCollapse}
+                  scrollTo={scrollToHeading}
+                />
               ))}
             </nav>
           </aside>

package/client/src/components/TocSection.tsx

@@ -0,0 +1,74 @@
+/**
+ * Recursive collapsible TOC section component.
+ *
+ * @packageDocumentation
+ */
+import { ChevronRight } from 'lucide-react';
+
+import type { TocNode } from './tocUtils.js';
+
+interface TocSectionProps {
+  node: TocNode;
+  collapsed: Set<string>;
+  toggleCollapse: (slug: string) => void;
+  activeSlug?: string;
+  scrollTo: (slug: string) => void;
+}
+
+export function TocSection({
+  node,
+  collapsed,
+  toggleCollapse,
+  activeSlug,
+  scrollTo,
+}: TocSectionProps) {
+  const hasChildren = node.children.length > 0;
+  const isCollapsed = collapsed.has(node.heading.slug);
+  const isActive = activeSlug === node.heading.slug;
+
+  return (
+    <div>
+      <div className="flex items-center">
+        {hasChildren ? (
+          <button
+            type="button"
+            onClick={() => toggleCollapse(node.heading.slug)}
+            className="w-4 h-4 flex items-center justify-center text-muted-foreground shrink-0"
+          >
+            <ChevronRight
+              className={`h-3 w-3 transition-transform ${isCollapsed ? '' : 'rotate-90'}`}
+            />
+          </button>
+        ) : (
+          <span className="w-4 shrink-0" />
+        )}
+        <button
+          type="button"
+          onClick={() => scrollTo(node.heading.slug)}
+          className={`text-left text-sm py-0.5 transition-colors truncate ${
+            isActive
+              ? 'text-foreground font-medium'
+              : 'text-muted-foreground hover:text-foreground'
+          }`}
+          style={{ paddingLeft: `${(node.heading.level - 1) * 0.75}rem` }}
+        >
+          {node.heading.text}
+        </button>
+      </div>
+      {hasChildren && !isCollapsed && (
+        <div>
+          {node.children.map((child) => (
+            <TocSection
+              key={child.heading.slug}
+              node={child}
+              collapsed={collapsed}
+              toggleCollapse={toggleCollapse}
+              activeSlug={activeSlug}
+              scrollTo={scrollTo}
+            />
+          ))}
+        </div>
+      )}
+    </div>
+  );
+}

package/client/src/components/renderableUtils.ts

@@ -3,10 +3,10 @@
  */
 import type { FileContent } from '@/lib/api';
 
-const RENDERABLE_EXTENSIONS = new Set(['.md', '.svg', '.mmd', '.puml', '.plantuml', '.pu']);
+const RENDERABLE_EXTENSIONS = new Set(['.md', '.csv', '.svg', '.mmd', '.puml', '.plantuml', '.pu']);
 
 export function isRenderable(file: FileContent): boolean {
-  return file.type === 'markdown' || file.type === 'svg' || file.type === 'mermaid' || file.type === 'plantuml' || !!file.html;
+  return file.type === 'markdown' || file.type === 'csv' || file.type === 'svg' || file.type === 'mermaid' || file.type === 'plantuml' || !!file.html;
 }
 
 export function isRenderableExt(reqPath: string): boolean {

package/client/src/components/tocUtils.ts

@@ -0,0 +1,65 @@
+/**
+ * TOC tree utilities for building and navigating heading hierarchies.
+ *
+ * @packageDocumentation
+ */
+
+export interface TocNode {
+  heading: { level: number; text: string; slug: string };
+  children: TocNode[];
+}
+
+/**
+ * Build a tree of TocNodes from a flat heading list.
+ */
+export function buildTocTree(
+  headings: { level: number; text: string; slug: string }[],
+): TocNode[] {
+  const root: TocNode[] = [];
+  const stack: TocNode[] = [];
+
+  for (const heading of headings) {
+    const node: TocNode = { heading, children: [] };
+
+    // Pop stack until we find a parent with a lower level
+    while (
+      stack.length > 0 &&
+      stack[stack.length - 1]!.heading.level >= heading.level
+    ) {
+      stack.pop();
+    }
+
+    if (stack.length === 0) {
+      root.push(node);
+    } else {
+      stack[stack.length - 1]!.children.push(node);
+    }
+
+    stack.push(node);
+  }
+
+  return root;
+}
+
+/**
+ * Find all ancestor slugs for a given slug in the tree.
+ */
+export function findAncestorSlugs(
+  nodes: TocNode[],
+  targetSlug: string,
+): string[] {
+  const path: string[] = [];
+
+  function walk(list: TocNode[]): boolean {
+    for (const node of list) {
+      if (node.heading.slug === targetSlug) return true;
+      path.push(node.heading.slug);
+      if (walk(node.children)) return true;
+      path.pop();
+    }
+    return false;
+  }
+
+  walk(nodes);
+  return path;
+}

package/client/src/index.css

@@ -279,3 +279,39 @@ pre:hover .code-copy-btn {
 .diagram-retry-btn:hover {
   background: var(--color-accent);
 }
+
+/* CSV table styles */
+.csv-table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 0.875rem;
+  line-height: 1.5;
+}
+.csv-table th,
+.csv-table td {
+  border: 1px solid var(--color-border);
+  padding: 0.5rem 0.75rem;
+  text-align: left;
+}
+.csv-table th {
+  font-weight: 600;
+  background: var(--color-muted);
+}
+.csv-table tbody tr:nth-child(even) {
+  background: color-mix(in srgb, var(--color-muted) 40%, transparent);
+}
+
+/* Collapsible frontmatter */
+.frontmatter-collapsible .frontmatter-full { display: none; }
+.frontmatter-collapsible .frontmatter-preview { display: block; }
+.frontmatter-collapsible.frontmatter-expanded .frontmatter-full { display: block; }
+.frontmatter-collapsible.frontmatter-expanded .frontmatter-preview { display: none; }
+.frontmatter-toggle {
+  font-size: 0.75rem;
+  color: var(--color-muted-foreground);
+  cursor: pointer;
+  padding: 0.25rem 0;
+  border: none;
+  background: none;
+}
+.frontmatter-toggle:hover { text-decoration: underline; }

package/client/src/lib/api.ts

@@ -37,6 +37,7 @@ export interface DirectoryEntry {
   ext: string;
   size: number | null;
   mtime: string | null;
+  itemCount?: number | null;
 }
 
 export interface DirectoryListing {
@@ -59,7 +60,7 @@ export interface DriveEntry {
 }
 
 export interface FileContent {
-  type: 'markdown' | 'text' | 'svg' | 'mermaid' | 'plantuml' | 'image' | 'binary';
+  type: 'markdown' | 'text' | 'csv' | 'svg' | 'mermaid' | 'plantuml' | 'image' | 'binary';
   content?: string;
   html?: string;
   headings?: { level: number; text: string; slug: string }[];

package/dist/client/assets/{CodeViewer-Cegj3cEn.js → CodeViewer-D5fJ1Z6_.js}

@@ -1 +1 @@
-import{i as e,l as t,n,o as r,r as i,t as a}from"./theme-CPpIxvB0.js";import{n as o,t as s}from"./index-DrBXupPz.js";var c=o(`copy`,[[`rect`,{width:`14`,height:`14`,x:`8`,y:`8`,rx:`2`,ry:`2`,key:`17jyea`}],[`path`,{d:`M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2`,key:`zix9uf`}]]),l=t(r(),1),u=e();function d({content:e,fileName:t}){let r=(0,l.useRef)(null),o=(0,l.useRef)(null),[d,f]=(0,l.useState)(!0),[p,m]=(0,l.useState)(!1),[h]=a(),g=async()=>{await navigator.clipboard.writeText(e),m(!0),setTimeout(()=>m(!1),1500)};return(0,l.useEffect)(()=>{if(!r.current)return;let a=!1;return(async()=>{let{EditorView:s,EditorState:c,basicSetup:l,oneDark:u}=await i();if(a)return;let d=await n(t.split(`.`).pop()??``);if(a)return;let p=[l,c.readOnly.of(!0),s.editable.of(!1),s.theme({"&":{fontSize:`14px`},".cm-scroller":{overflow:`auto`},".cm-content":{fontFamily:`'JetBrains Mono', 'Fira Code', 'Consolas', monospace`},".cm-gutters":{fontFamily:`'JetBrains Mono', 'Fira Code', 'Consolas', monospace`},".cm-cursor":{display:`none`}})];h===`dark`&&p.push(u),d&&p.push(d),o.current=new s({state:c.create({doc:e,extensions:p}),parent:r.current}),f(!1)})(),()=>{a=!0,o.current&&=(o.current.destroy(),null)}},[e,t,h]),(0,u.jsxs)(`div`,{className:`relative group rounded-lg border border-border overflow-hidden`,children:[(0,u.jsx)(`div`,{className:`absolute top-2 right-2 z-10`,children:(0,u.jsx)(`button`,{onClick:()=>void g(),className:`p-1.5 rounded bg-accent hover:bg-accent/80 text-muted-foreground hover:text-foreground opacity-0 group-hover:opacity-100 transition-all`,title:`Copy to clipboard`,children:p?(0,u.jsx)(s,{className:`h-3.5 w-3.5 text-green-400`}):(0,u.jsx)(c,{className:`h-3.5 w-3.5`})})}),(0,u.jsx)(`div`,{ref:r,children:d&&(0,u.jsx)(`pre`,{className:`p-4 text-sm text-muted-foreground bg-muted`,children:(0,u.jsxs)(`code`,{children:[e.slice(0,200),`…`]})})})]})}export{d as CodeViewer};
+import{i as e,l as t,n,o as r,r as i,t as a}from"./theme-CPpIxvB0.js";import{n as o,t as s}from"./index-BXy6kgl7.js";var c=o(`copy`,[[`rect`,{width:`14`,height:`14`,x:`8`,y:`8`,rx:`2`,ry:`2`,key:`17jyea`}],[`path`,{d:`M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2`,key:`zix9uf`}]]),l=t(r(),1),u=e();function d({content:e,fileName:t}){let r=(0,l.useRef)(null),o=(0,l.useRef)(null),[d,f]=(0,l.useState)(!0),[p,m]=(0,l.useState)(!1),[h]=a(),g=async()=>{await navigator.clipboard.writeText(e),m(!0),setTimeout(()=>m(!1),1500)};return(0,l.useEffect)(()=>{if(!r.current)return;let a=!1;return(async()=>{let{EditorView:s,EditorState:c,basicSetup:l,oneDark:u}=await i();if(a)return;let d=await n(t.split(`.`).pop()??``);if(a)return;let p=[l,c.readOnly.of(!0),s.editable.of(!1),s.theme({"&":{fontSize:`14px`},".cm-scroller":{overflow:`auto`},".cm-content":{fontFamily:`'JetBrains Mono', 'Fira Code', 'Consolas', monospace`},".cm-gutters":{fontFamily:`'JetBrains Mono', 'Fira Code', 'Consolas', monospace`},".cm-cursor":{display:`none`}})];h===`dark`&&p.push(u),d&&p.push(d),o.current=new s({state:c.create({doc:e,extensions:p}),parent:r.current}),f(!1)})(),()=>{a=!0,o.current&&=(o.current.destroy(),null)}},[e,t,h]),(0,u.jsxs)(`div`,{className:`relative group rounded-lg border border-border overflow-hidden`,children:[(0,u.jsx)(`div`,{className:`absolute top-2 right-2 z-10`,children:(0,u.jsx)(`button`,{onClick:()=>void g(),className:`p-1.5 rounded bg-accent hover:bg-accent/80 text-muted-foreground hover:text-foreground opacity-0 group-hover:opacity-100 transition-all`,title:`Copy to clipboard`,children:p?(0,u.jsx)(s,{className:`h-3.5 w-3.5 text-green-400`}):(0,u.jsx)(c,{className:`h-3.5 w-3.5`})})}),(0,u.jsx)(`div`,{ref:r,children:d&&(0,u.jsx)(`pre`,{className:`p-4 text-sm text-muted-foreground bg-muted`,children:(0,u.jsxs)(`code`,{children:[e.slice(0,200),`…`]})})})]})}export{d as CodeViewer};