@thingd/cli 0.56.0 → 0.57.0

package/dist/interactive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../src/interactive.ts"],"names":[],"mappings":"AAu8FA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CA0FvD"}
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../src/interactive.ts"],"names":[],"mappings":"AA8lGA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CA0FvD"}

package/dist/interactive.js

@@ -92,6 +92,7 @@ let objectWriteRateHistory = [];
 let eventAppendRateHistory = [];
 let viewerLines = ["Select an item to view details."];
 let viewerScroll = 0;
+let showHelp = false;
 let lastNeighborsRef = "";
 let loadedItemId = "";
 let loadTimer = null;
@@ -915,6 +916,38 @@ async function loadContent(node) {
             content += ` ${pc.dim("Links".padEnd(14))} ${pc.blue(String(totalLinksCount).padEnd(6))} ${pc.dim("total")}\n`;
             content += ` ${pc.dim("Active Jobs".padEnd(14))} ${pc.yellow(String(totalActiveJobsCount).padEnd(6))} ${pc.dim("in flight")}\n`;
             content += ` ${pc.dim("Dead Jobs".padEnd(14))} ${pc.red(String(totalDeadJobsCount).padEnd(6))} ${pc.dim("failed")}\n\n`;
+            // Collection breakdown bar chart
+            if (collections.length > 0) {
+                content += ` ${pc.bold("Collections")}\n`;
+                const maxCount = Math.max(1, ...collections.map((c) => (objectsByCollection.get(c) ?? []).length));
+                const barMax = Math.max(5, viewW - 30);
+                for (const col of collections) {
+                    const count = (objectsByCollection.get(col) ?? []).length;
+                    const barLen = Math.max(1, Math.round((count / maxCount) * barMax));
+                    const bar = barLen > 0 ? pc.cyan("█".repeat(barLen)) : "";
+                    content += ` ${pc.dim(col.slice(0, 12).padEnd(12))} ${bar} ${pc.dim(String(count))}\n`;
+                }
+                content += "\n";
+            }
+            // Capacity gauge bar
+            const totalHistorical = totalObjects +
+                totalEventsCount +
+                totalLinksCount +
+                totalActiveJobsCount +
+                totalDeadJobsCount;
+            if (totalHistorical > 0) {
+                const capBarW = Math.max(5, viewW - 20);
+                const objFrac = totalObjects / totalHistorical;
+                const evtFrac = totalEventsCount / totalHistorical;
+                const linkFrac = totalLinksCount / totalHistorical;
+                const objChars = Math.round(objFrac * capBarW);
+                const evtChars = Math.round(evtFrac * capBarW);
+                const linkChars = Math.round(linkFrac * capBarW);
+                const jobChars = capBarW - objChars - evtChars - linkChars;
+                content += ` ${pc.bold("Distribution")}\n`;
+                content += ` ${pc.dim(" ")}${pc.cyan("█".repeat(Math.max(0, objChars)))}${pc.green("█".repeat(Math.max(0, evtChars)))}${pc.blue("█".repeat(Math.max(0, linkChars)))}${pc.yellow("█".repeat(Math.max(0, jobChars)))}\n`;
+                content += ` ${pc.cyan("■")} objs ${pc.green("■")} evts ${pc.blue("■")} links ${pc.yellow("■")} jobs\n\n`;
+            }
             content += ` ${pc.bold("Connection")}\n`;
             content += ` ${pc.dim("Driver".padEnd(14))} ${driverName}\n`;
             content += ` ${pc.dim("Path".padEnd(14))} ${dbPath || ":memory:"}\n`;
@@ -998,14 +1031,20 @@ function draw() {
     scrollOffset = Math.max(0, Math.min(scrollOffset, Math.max(0, tree.length - bodyH)));
     let buf = "\u001B[H"; // Move to top-left
     // Header — opencode style: clean, no inverse bar
-    if (!connected) {
-        buf += ` ${pc.cyan("◈")} ${pc.bold("thingd")}  ${pc.dim("Select Environment")}\n`;
+    if (showHelp) {
+        buf += ` ${pc.cyan("◈")} ${pc.bold("thingd")}  ${pc.dim("Help (press any key)")}\n`;
+    }
+    else if (!connected) {
+        buf += ` ${pc.cyan("◈")} ${pc.bold("thingd")}  ${pc.dim("Select Environment")} ${pc.dim("[?] help")}\n`;
     }
     else if (formState?.active) {
-        buf += ` ${pc.cyan("◈")} ${pc.bold("thingd")}  ${pc.cyan(driver.toUpperCase())}  ${pc.dim("Input Mode")}\n`;
+        buf += ` ${pc.cyan("◈")} ${pc.bold("thingd")}  ${pc.cyan(driver.toUpperCase())}  ${pc.dim("Input Mode")} ${pc.dim("[?] help")}\n`;
     }
     else {
-        const label = ` ${pc.cyan("◈")} ${pc.bold("thingd")}  ${pc.cyan(driver.toUpperCase())} ${pc.dim(dbPath)}`;
+        const breadcrumb = computeBreadcrumbs();
+        const base = ` ${pc.cyan("◈")} ${pc.bold("thingd")}  ${pc.cyan(driver.toUpperCase())}`;
+        const dash = breadcrumb ? ` ${pc.dim("▸")} ` : "";
+        const label = `${base}${dash}${breadcrumb} ${pc.dim("[?] help")}`;
         buf += `${padToWidth(label, W)}\n`;
     }
     buf += `${pc.dim("─".repeat(W))}\n`;
@@ -1097,8 +1136,101 @@ function draw() {
     buf += padToWidth(help, W);
     // Clear to end
     buf += "\u001B[J";
+    if (showHelp) {
+        buf += computeHelpOverlay(W, H);
+    }
     process.stdout.write(buf);
 }
+function computeBreadcrumbs() {
+    if (!connected) {
+        return "";
+    }
+    const tree = buildTree();
+    const node = tree[cursorIndex];
+    if (!node) {
+        return "";
+    }
+    const labels = [];
+    const climb = (id) => {
+        if (!id) {
+            return;
+        }
+        const n = tree.find((t) => t.id === id);
+        if (!n) {
+            return;
+        }
+        if (n.parentId) {
+            climb(n.parentId);
+        }
+        const clean = n.label
+            .replace(/[▾▸●○·◇◈◉⬡]/g, "")
+            .trim()
+            .replace(/^\S+\s+/, "")
+            .trim();
+        if (clean && !clean.startsWith("(")) {
+            labels.push(clean);
+        }
+    };
+    climb(node.id);
+    return labels.length > 0 ? pc.dim(labels.join(" > ")) : "";
+}
+function computeHelpOverlay(W, H) {
+    const lines = [
+        `${pc.bold("  thingd TUI Help")}`,
+        "",
+        `  ${pc.bold("Navigation")}`,
+        `  ${pc.dim("↑↓/j/k")}    Move cursor`,
+        `  ${pc.dim("←→/h/l")}   Expand/collapse tree`,
+        `  ${pc.dim("Enter")}      Toggle expand`,
+        "",
+        `  ${pc.bold("Operations")}`,
+        `  ${pc.dim("c")}         Create resource`,
+        `  ${pc.dim("e")}         Edit object/job`,
+        `  ${pc.dim("d")}         Delete object/link/job`,
+        `  ${pc.dim("r")}         Refresh data`,
+        `  ${pc.dim("i")}         Connection info`,
+        "",
+        `  ${pc.bold("Data Views")}`,
+        `  ${pc.dim("n")}         Object neighbors (links)`,
+        `  ${pc.dim("a")}         Aggregate (count/sum/avg/min/max)`,
+        `  ${pc.dim("t")}         Time-series query`,
+        `  ${pc.dim("N")}         Natural language query`,
+        `  ${pc.dim("/f")}        Search objects`,
+        `  ${pc.dim("o")}         Object listing options`,
+        `  ${pc.dim("b")}         Batch put/delete`,
+        "",
+        `  ${pc.bold("System")}`,
+        `  ${pc.dim("s")}         Switch driver`,
+        `  ${pc.dim("m")}         Maintenance`,
+        `  ${pc.dim("l")}         Logout`,
+        `  ${pc.dim("q")}         Quit`,
+        `  ${pc.dim("?")}         Toggle this help`,
+        "",
+        `  ${pc.dim("Press any key to close help.")}`,
+    ];
+    const helpW = 44;
+    const helpH = lines.length + 2;
+    const col = Math.max(0, Math.floor((W - helpW) / 2));
+    const row = Math.max(0, Math.floor((H - helpH) / 2));
+    let out = "";
+    for (let r = 0; r < H; r++) {
+        if (r >= row && r < row + helpH) {
+            const lineIdx = r - row;
+            if (lineIdx === 0 || lineIdx === helpH - 1) {
+                out += `${" ".repeat(col) + pc.dim(`┌${"─".repeat(helpW - 2)}┐`)}\n`;
+            }
+            else {
+                const text = lines[lineIdx - 1] ?? "";
+                const padded = text + " ".repeat(Math.max(0, helpW - visibleWidth(text) - 2));
+                out += `${" ".repeat(col) + pc.dim("│")} ${padded} ${pc.dim("│")}\n`;
+            }
+        }
+        else {
+            out += "\n";
+        }
+    }
+    return out;
+}
 /** Pad/truncate `text` to exactly `width` visible characters. */
 function fitToWidth(text, width, highlight) {
     const vw = visibleWidth(text);
@@ -2105,6 +2237,12 @@ function setupKeypress() {
         if (!key) {
             return;
         }
+        // Help overlay dismisses on any keypress
+        if (showHelp) {
+            showHelp = false;
+            draw();
+            return;
+        }
         // Quit
         if ((key.ctrl && key.name === "c") || key.name === "q") {
             if (formState?.active && key.name !== "q") {
@@ -2221,13 +2359,17 @@ function setupKeypress() {
             }
         }
         else if (!connected) {
-            // Driver selection mode — only Enter works
+            // Driver selection mode — only Enter and ? work
             if (key.name === "return") {
                 const node = tree[cursorIndex];
                 if (node) {
                     await handleConnect(node);
                 }
             }
+            else if (str === "?") {
+                showHelp = !showHelp;
+                draw();
+            }
         }
         else {
             // Connected mode — full set of shortcuts
@@ -2313,6 +2455,10 @@ function setupKeypress() {
             else if (str === "/" || str === "f" || str === "F") {
                 await handleSearch();
             }
+            else if (str === "?") {
+                showHelp = !showHelp;
+                draw();
+            }
             else if (str === "i" || str === "I") {
                 await handleInfo();
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thingd/cli",
-  "version": "0.56.0",
+  "version": "0.57.0",
   "description": "CLI, Interactive TUI Dashboard, and MCP server for thingd — a fast object-first data engine for applications and AI agents.",
   "type": "module",
   "homepage": "https://engine.thingd.cloud",
@@ -45,7 +45,7 @@
     "cli-table3": "^0.6.5",
     "picocolors": "^1.1.1",
     "zod": "^4.4.3",
-    "@thingd/sdk": "0.56.0"
+    "@thingd/sdk": "0.57.0"
   },
   "engines": {
     "node": ">=24.0.0"