@thingd/cli 0.56.0 → 0.58.0

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAQA,OAAO,EAUL,MAAM,EACN,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AASrB,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjD,KAAK,YAAY,GAAG;IAClB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,KAAK,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC;AAE1C,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAsCF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAwFF,wBAAsB,MAAM,CAC1B,IAAI,WAAwB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA8EjB;AAk6BD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAef;AA4BD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,iBAAiB,CAqDxE;AAiDD,wBAAgB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAGlF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrF;AAyFD,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAEpF;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAElE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAQA,OAAO,EAUL,MAAM,EACN,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AASrB,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjD,KAAK,YAAY,GAAG;IAClB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,KAAK,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC;AAE1C,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAsCF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAwFF,wBAAsB,MAAM,CAC1B,IAAI,WAAwB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA8EjB;AA08BD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAef;AA4BD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,iBAAiB,CAqDxE;AAiDD,wBAAgB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAGlF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrF;AAyFD,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAEpF;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAElE"}

package/dist/index.js

@@ -290,6 +290,10 @@ async function runCommand(context) {
         await runBackup(context);
         return;
     }
+    if (command === "completions") {
+        await runCompletions(context);
+        return;
+    }
     if (command === "db") {
         const sub = context.parsed.tokens[1];
         if (!sub) {
@@ -381,6 +385,39 @@ async function runDbIntegrity(context) {
         }
     });
 }
+async function runCompletions(context) {
+    const shell = optionalToken(context.parsed, 1) ?? "bash";
+    const cmds = [
+        "status",
+        "search",
+        "mcp",
+        "cloud",
+        "objects",
+        "events",
+        "collections",
+        "streams",
+        "queues",
+        "links",
+        "schema",
+        "nlq",
+        "aggregate",
+        "timeseries",
+        "metrics",
+        "dashboard",
+        "export",
+        "import",
+        "snapshot",
+        "backup",
+        "db",
+        "completions",
+    ];
+    const script = shell === "zsh"
+        ? `#compdef thingd\ncompdef _thingd thingd\n_thingd() {\n  _describe 'thingd commands' ${JSON.stringify(cmds.map((c) => `${c}:thingd ${c}`))}\n}\n`
+        : shell === "fish"
+            ? `complete -c thingd -f\n${cmds.map((c) => `complete -c thingd -n '__fish_use_subcommand' -a ${c}`).join("\n")}\n`
+            : `_thingd() {\n  local cur=${"${COMP_WORDS[COMP_CWORD]}"}\n  if [ $COMP_CWORD -eq 1 ]; then\n    COMPREPLY=($(compgen -W "${cmds.join(" ")}" -- "$cur"))\n  fi\n}\ncomplete -F _thingd thingd\n`;
+    writeText(context.stdout, script);
+}
 async function runStatus(context) {
     const connection = resolveConnection(context);
     if (!connection.cloud) {

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":"AAitGA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CA0FvD"}

package/dist/interactive.js

@@ -92,6 +92,22 @@ let objectWriteRateHistory = [];
 let eventAppendRateHistory = [];
 let viewerLines = ["Select an item to view details."];
 let viewerScroll = 0;
+let showHelp = false;
+const loading = false;
+const toasts = [];
+function addToast(msg) {
+    toasts.push(msg);
+    if (toasts.length > 3) {
+        toasts.shift();
+    }
+    setTimeout(() => {
+        const idx = toasts.indexOf(msg);
+        if (idx !== -1) {
+            toasts.splice(idx, 1);
+            draw();
+        }
+    }, 3000);
+}
 let lastNeighborsRef = "";
 let loadedItemId = "";
 let loadTimer = null;
@@ -915,6 +931,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 +1046,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`;
@@ -1091,14 +1145,115 @@ function draw() {
         help = ` ${pc.dim("↑↓")} nav  ${pc.dim("enter")} connect  ${pc.dim("q")} quit `;
     }
     else {
-        help = ` ${pc.dim("↑↓")} nav  ${pc.dim("←→")} toggle  ${pc.dim("c")} create  ${pc.dim("e")} edit  ${pc.dim("d")} delete  ${pc.dim("/")} search  ${pc.dim("n")} neighbors  ${pc.dim("N")} nlq  ${pc.dim("a")} agg  ${pc.dim("t")} ts  ${pc.dim("o")} options  ${pc.dim("b")} batch  ${pc.dim("i")} info  ${pc.dim("r")} refresh  ${pc.dim("s")} switch  ${pc.dim("l")} logout  ${pc.dim("q")} quit `;
+        help = ` ${pc.dim("↑↓")} nav  ${pc.dim("←→")} toggle  ${pc.dim("c")} create  ${pc.dim("e")} edit  ${pc.dim("d")} delete  ${pc.dim("/")} search  ${pc.dim("n")} neighbors  ${pc.dim("N")} nlq  ${pc.dim("a")} agg  ${pc.dim("t")} ts  ${pc.dim("o")} opts  ${pc.dim("b")} batch  ${pc.dim("x")} export  ${pc.dim("p")} import  ${pc.dim("w")} web  ${pc.dim("i")} info  ${pc.dim("r")} refresh  ${pc.dim("s")} switch  ${pc.dim("l")} logout  ${pc.dim("q")} quit `;
     }
     buf += `${pc.dim("─".repeat(W))}\n`;
     buf += padToWidth(help, W);
+    if (loading) {
+        buf += `\n${pc.cyan("◇")} ${pc.dim("Working...")}`;
+    }
+    if (toasts.length > 0) {
+        for (const t of toasts) {
+            buf += `\n ${pc.green("●")} ${pc.dim(t)}`;
+        }
+    }
     // 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);
@@ -1315,6 +1470,7 @@ async function handleCreate(selected) {
             await db.put(target, { id, ...data });
             expandedSet.add("cat:collections");
             expandedSet.add(`col:${target}`);
+            addToast(`Created object ${id} in ${target}`);
         }
         else if (kind === "event") {
             if (!vals.payload?.trim()) {
@@ -1322,6 +1478,7 @@ async function handleCreate(selected) {
             }
             await db.events.append(target, { type: vals.payload.trim() });
             expandedSet.add("cat:streams");
+            addToast(`Appended event to ${target}`);
         }
         else if (kind === "queue") {
             if (!vals.payload?.trim()) {
@@ -1330,6 +1487,7 @@ async function handleCreate(selected) {
             const data = parsePayload(vals.payload);
             await db.queue(target).push(data);
             expandedSet.add("cat:queues");
+            addToast(`Pushed job to queue ${target}`);
         }
         else if (kind === "link") {
             const toRef = (vals.objId || "").trim();
@@ -1356,6 +1514,7 @@ async function handleCreate(selected) {
                 linkType = (vals.payload || "").trim() || "related";
             }
             await db.links.create(target, linkType, toRef, weight, metadataJson);
+            addToast(`Created link: ${target} ${linkType} ${toRef}`);
         }
         else {
             throw new Error("Kind must be 'object', 'event', 'queue', or 'link'.");
@@ -1461,6 +1620,7 @@ async function handleDelete(selected) {
             if (result && !result.deleted) {
                 throw new Error(`Object '${ref.id}' not found in collection '${ref.collection}'`);
             }
+            addToast(`Deleted object ${ref.id}`);
         });
     }
     else if (selected.type === "queue" && selected.ref) {
@@ -1505,6 +1665,7 @@ async function handleDelete(selected) {
             if (!ok) {
                 throw new Error(`Link '${linkId}' not found.`);
             }
+            addToast(`Deleted link ${linkId}`);
         });
     }
     else if (selected.type === "job" && selected.ref) {
@@ -2021,6 +2182,71 @@ async function handleBatchOps(selected) {
         }
     });
 }
+async function handleExport(selected) {
+    const colName = selected?.type === "collection"
+        ? (selected.ref?.name ?? "")
+        : selected?.type === "object"
+            ? (selected.ref?.collection ?? "")
+            : "";
+    if (!colName) {
+        viewerLines = [pc.yellow("Select a collection first, then press [x] to export.")];
+        loadedItemId = "export_info";
+        draw();
+        return;
+    }
+    openForm(`Export: ${colName}`, [{ id: "path", label: "Output File Path", placeholder: "/tmp/export.jsonl" }], async (vals) => {
+        const filePath = (vals.path || "").trim();
+        if (!filePath) {
+            throw new Error("File path is required.");
+        }
+        const objs = await db.listObjects(colName);
+        const lines = objs.map((o) => JSON.stringify(o)).join("\n");
+        await fs.promises.writeFile(filePath, lines, "utf-8");
+        addToast(`Exported ${objs.length} objects to ${filePath}`);
+    });
+}
+async function handleImport(selected) {
+    const colName = selected?.type === "collection"
+        ? (selected.ref?.name ?? "")
+        : selected?.type === "object"
+            ? (selected.ref?.collection ?? "")
+            : "";
+    if (!colName) {
+        viewerLines = [pc.yellow("Select a collection first, then press [p] to import.")];
+        loadedItemId = "import_info";
+        draw();
+        return;
+    }
+    openForm(`Import: ${colName}`, [{ id: "path", label: "Input File Path (JSONL)", placeholder: "/tmp/export.jsonl" }], async (vals) => {
+        const filePath = (vals.path || "").trim();
+        if (!filePath) {
+            throw new Error("File path is required.");
+        }
+        const text = await fs.promises.readFile(filePath, "utf-8");
+        const objects = text
+            .split("\n")
+            .filter(Boolean)
+            .map((line) => JSON.parse(line));
+        const result = await db.putBatch(colName, objects);
+        addToast(`Imported ${result.length} objects into ${colName}`);
+    });
+}
+async function handleDashboard() {
+    const bin = process.argv[1] || "thingd";
+    const args = ["dashboard", "--driver", driver];
+    if (dbPath) {
+        args.push("--path", dbPath);
+    }
+    if (authToken) {
+        args.push("--auth-token", authToken);
+    }
+    const child = spawn(bin, args, {
+        stdio: "inherit",
+        detached: true,
+    });
+    child.unref();
+    addToast(`Launching dashboard: ${bin} dashboard`);
+}
 async function handleMaintenance() {
     // Cycle through maintenance operations with each press of 'm'
     const operations = ["health", "checkpoint", "backup"];
@@ -2105,6 +2331,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 +2453,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 +2549,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();
             }
@@ -2334,6 +2574,15 @@ function setupKeypress() {
             else if (str === "b" || str === "B") {
                 await handleBatchOps(tree[cursorIndex]);
             }
+            else if (str === "x" || str === "X") {
+                await handleExport(tree[cursorIndex]);
+            }
+            else if (str === "p" || str === "P") {
+                await handleImport(tree[cursorIndex]);
+            }
+            else if (str === "w" || str === "W") {
+                await handleDashboard();
+            }
             else if (str === "m" || str === "M") {
                 await handleMaintenance();
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thingd/cli",
-  "version": "0.56.0",
+  "version": "0.58.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.58.0"
   },
   "engines": {
     "node": ">=24.0.0"