@thingd/cli 0.55.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":"AA+/EA,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

@@ -69,6 +69,7 @@ let collections = [];
 let streams = [];
 let queues = [];
 let objectsByCollection = new Map();
+const collectionOptions = new Map();
 const expandedSet = new Set(["cat:collections", "cat:streams", "cat:queues"]);
 let cursorIndex = 0;
 let maintenanceCursor = 0;
@@ -91,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;
@@ -244,7 +246,21 @@ async function fetchResourcesFallback() {
     objectsByCollection.clear();
     await Promise.all(collections.map(async (col) => {
         try {
-            const list = await db.listObjects(col);
+            const opts = collectionOptions.get(col);
+            const listOpts = {};
+            if (opts?.sortBy) {
+                listOpts.sortBy = { field: opts.sortBy, direction: opts.sortDir ?? "asc" };
+            }
+            if (opts?.limit) {
+                listOpts.limit = opts.limit;
+            }
+            if (opts?.offset) {
+                listOpts.offset = opts.offset;
+            }
+            if (opts?.filter) {
+                listOpts.filter = opts.filter;
+            }
+            const list = await db.listObjects(col, Object.keys(listOpts).length > 0 ? listOpts : undefined);
             objectsByCollection.set(col, list.map((o) => o.id));
         }
         catch {
@@ -289,7 +305,21 @@ async function fetchResources() {
     objectsByCollection.clear();
     for (const col of collections) {
         try {
-            const list = await db.listObjects(col);
+            const opts = collectionOptions.get(col);
+            const listOpts = {};
+            if (opts?.sortBy) {
+                listOpts.sortBy = { field: opts.sortBy, direction: opts.sortDir ?? "asc" };
+            }
+            if (opts?.limit) {
+                listOpts.limit = opts.limit;
+            }
+            if (opts?.offset) {
+                listOpts.offset = opts.offset;
+            }
+            if (opts?.filter) {
+                listOpts.filter = opts.filter;
+            }
+            const list = await db.listObjects(col, Object.keys(listOpts).length > 0 ? listOpts : undefined);
             objectsByCollection.set(col, list.map((o) => o.id));
         }
         catch {
@@ -758,6 +788,27 @@ async function loadContent(node) {
             const ref = node.ref;
             const objs = objectsByCollection.get(ref.name) ?? [];
             let res = `${pc.bold(ref.name)} ${pc.dim(`(${objs.length} objects)`)}\n\n`;
+            // Schema info
+            try {
+                const schemas = await db.schema(ref.name);
+                if (schemas.length > 0) {
+                    const fields = schemas[0]?.fields ?? [];
+                    if (fields.length > 0) {
+                        res += `${pc.bold("Fields")}\n`;
+                        for (const f of fields) {
+                            const icon = f.nullable ? pc.dim("⊙") : pc.cyan("◎");
+                            const sample = f.sampleValues.length > 0
+                                ? pc.dim(` e.g. ${String(f.sampleValues[0]).slice(0, 20)}`)
+                                : "";
+                            res += ` ${icon} ${f.name}: ${f.type}${sample}\n`;
+                        }
+                        res += "\n";
+                    }
+                }
+            }
+            catch {
+                // Schema not available for this store
+            }
             if (objs.length === 0) {
                 res += pc.dim("No objects in this collection.");
             }
@@ -865,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`;
@@ -948,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`;
@@ -1041,14 +1130,107 @@ 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("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")} 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 `;
     }
     buf += `${pc.dim("─".repeat(W))}\n`;
     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);
@@ -1661,6 +1843,316 @@ async function handleNeighbors(selected) {
         draw();
     });
 }
+async function handleAggregate(selected) {
+    const defaultCol = selected?.type === "collection"
+        ? (selected.ref?.name ?? "")
+        : selected?.type === "object"
+            ? (selected.ref?.collection ?? "")
+            : "";
+    openForm("Aggregate", [
+        {
+            id: "function",
+            label: "Function",
+            value: "count",
+            options: ["count", "sum", "avg", "min", "max"],
+        },
+        {
+            id: "collection",
+            label: "Collection",
+            value: defaultCol,
+            options: collections,
+            allowCustom: true,
+        },
+        { id: "field", label: "Field (for sum/avg/min/max)", placeholder: "field name" },
+        { id: "groupBy", label: "Group By (optional field)", placeholder: "field name" },
+        { id: "filter", label: "Filter (optional JSON)", placeholder: '{"status":"active"}' },
+    ], async (vals) => {
+        const func = vals.function || "count";
+        const collection = (vals.collection || "").trim();
+        if (!collection) {
+            throw new Error("Collection is required.");
+        }
+        const field = (vals.field || "").trim() || undefined;
+        const groupBy = (vals.groupBy || "").trim() || undefined;
+        const filter = vals.filter?.trim() ? JSON.parse(vals.filter.trim()) : undefined;
+        const options = { groupBy, filter };
+        const a = db.aggregate;
+        const result = func === "count"
+            ? await a.count(collection, options)
+            : func === "sum"
+                ? await a.sum(collection, field, options)
+                : func === "avg"
+                    ? await a.avg(collection, field, options)
+                    : func === "min"
+                        ? await a.min(collection, field, options)
+                        : await a.max(collection, field, options);
+        const lines = [
+            ` ${pc.bold("Aggregate")}  ${pc.cyan(func)} ${pc.dim(`on ${collection}`)}`,
+            "",
+            ` ${pc.dim("Total:")} ${pc.bold(String(result.total))}`,
+            "",
+        ];
+        if (result.groups && result.groups.length > 0) {
+            lines.push(` ${pc.bold("Groups")}`);
+            const maxVal = Math.max(...result.groups.map((g) => g.value));
+            for (const g of result.groups) {
+                const barLen = Math.max(1, Math.round((g.value / maxVal) * 20));
+                const bar = pc.cyan("█".repeat(barLen));
+                lines.push(` ${g.key}: ${bar} ${pc.dim(String(g.value))}`);
+            }
+        }
+        viewerLines = lines;
+        loadedItemId = "aggregate_result";
+        draw();
+    });
+}
+async function handleTimeseries(selected) {
+    const defaultCol = selected?.type === "collection"
+        ? (selected.ref?.name ?? "")
+        : selected?.type === "object"
+            ? (selected.ref?.collection ?? "")
+            : "";
+    openForm("Time Series", [
+        {
+            id: "function",
+            label: "Function",
+            value: "count",
+            options: ["count", "sum", "avg", "min", "max"],
+        },
+        {
+            id: "collection",
+            label: "Collection",
+            value: defaultCol,
+            options: collections,
+            allowCustom: true,
+        },
+        { id: "field", label: "Field (optional)", placeholder: "field name" },
+        {
+            id: "bucket",
+            label: "Bucket",
+            value: "day",
+            options: ["hour", "day", "week", "month"],
+        },
+        { id: "from", label: "From (ISO date, optional)", placeholder: "2024-01-01" },
+        { id: "to", label: "To (ISO date, optional)", placeholder: "2024-12-31" },
+        { id: "filter", label: "Filter (optional JSON)", placeholder: '{"status":"active"}' },
+    ], async (vals) => {
+        const func = vals.function || "count";
+        const collection = (vals.collection || "").trim();
+        if (!collection) {
+            throw new Error("Collection is required.");
+        }
+        const field = (vals.field || "").trim() || undefined;
+        const bucket = (vals.bucket || "day");
+        const from = (vals.from || "").trim() || undefined;
+        const to = (vals.to || "").trim() || undefined;
+        const filter = vals.filter?.trim() ? JSON.parse(vals.filter.trim()) : undefined;
+        const result = await db.timeseries(collection, {
+            function: func,
+            field,
+            bucket,
+            from,
+            to,
+            filter,
+        });
+        const lines = [
+            ` ${pc.bold("Time Series")}  ${pc.cyan(func)} ${pc.dim(`on ${collection}, ${bucket}ly`)}`,
+            "",
+        ];
+        if (result.buckets.length === 0) {
+            lines.push(pc.dim("No data for the selected range."));
+        }
+        else {
+            const maxVal = Math.max(...result.buckets.map((b) => b.value));
+            for (const b of result.buckets) {
+                const barLen = Math.max(1, Math.round((b.value / maxVal) * 20));
+                const bar = pc.green("█".repeat(barLen));
+                lines.push(` ${b.label}: ${bar} ${pc.dim(String(b.value))}`);
+            }
+        }
+        viewerLines = lines;
+        loadedItemId = "timeseries_result";
+        draw();
+    });
+}
+async function handleNlq(selected) {
+    const defaultCol = selected?.type === "collection"
+        ? (selected.ref?.name ?? "")
+        : selected?.type === "object"
+            ? (selected.ref?.collection ?? "")
+            : "";
+    openForm("Natural Language Query", [
+        { id: "question", label: "Question", placeholder: "How many active users?" },
+        {
+            id: "collection",
+            label: "Collection (optional)",
+            value: defaultCol,
+            options: collections,
+            allowCustom: true,
+        },
+    ], async (vals) => {
+        const question = (vals.question || "").trim();
+        if (!question) {
+            throw new Error("Question is required.");
+        }
+        const collection = (vals.collection || "").trim() || undefined;
+        const result = await db.nlq.query(question, {
+            collection,
+        });
+        const intent = result.intent;
+        const lines = [
+            ` ${pc.bold("NLQ Result")}`,
+            ` ${pc.dim(`Question: ${question}`)}`,
+            "",
+            ` ${result.answer}`,
+            "",
+        ];
+        if (intent) {
+            lines.push(` ${pc.dim("Interpreted as:")} ${intent.action} ${pc.dim("on")} ${pc.cyan(intent.collection)}`);
+            if (intent.function) {
+                lines.push(` ${pc.dim("Function:")} ${intent.function}`);
+            }
+            if (intent.field) {
+                lines.push(` ${pc.dim("Field:")} ${intent.field}`);
+            }
+            if (intent.query) {
+                lines.push(` ${pc.dim("Query:")} ${intent.query}`);
+            }
+        }
+        if (result.data !== undefined && result.data !== null) {
+            lines.push("", highlightJson(result.data));
+        }
+        viewerLines = lines;
+        loadedItemId = "nlq_result";
+        draw();
+    });
+}
+async function handleCollectionOptions(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 [o] to set listing options.")];
+        loadedItemId = "options_info";
+        draw();
+        return;
+    }
+    const current = collectionOptions.get(colName) ?? {};
+    openForm(`Listing Options: ${colName}`, [
+        {
+            id: "sortBy",
+            label: "Sort By",
+            value: current.sortBy ?? "",
+            options: ["", "id", "created_at", "updated_at", "version"],
+            allowCustom: true,
+        },
+        {
+            id: "sortDir",
+            label: "Sort Direction",
+            value: current.sortDir ?? "asc",
+            options: ["asc", "desc"],
+        },
+        { id: "limit", label: "Limit", value: String(current.limit ?? ""), placeholder: "50" },
+        { id: "offset", label: "Offset", value: String(current.offset ?? ""), placeholder: "0" },
+        {
+            id: "filter",
+            label: "Filter (JSON)",
+            value: current.filter ? JSON.stringify(current.filter) : "",
+            placeholder: '{"status":"active"}',
+        },
+    ], async (vals) => {
+        const opts = {};
+        if (vals.sortBy) {
+            opts.sortBy = vals.sortBy;
+            opts.sortDir = vals.sortDir || "asc";
+        }
+        if (vals.limit) {
+            opts.limit = parseInt(vals.limit, 10) || 50;
+        }
+        if (vals.offset) {
+            opts.offset = parseInt(vals.offset, 10) || 0;
+        }
+        if (vals.filter?.trim()) {
+            opts.filter = JSON.parse(vals.filter.trim());
+        }
+        if (Object.keys(opts).length > 0) {
+            collectionOptions.set(colName, opts);
+        }
+        else {
+            collectionOptions.delete(colName);
+        }
+        await fetchResources();
+        const tree = buildTree();
+        const idx = tree.findIndex((n) => n.id === `col:${colName}`);
+        if (idx !== -1) {
+            cursorIndex = idx;
+        }
+        const n = tree[cursorIndex];
+        if (n) {
+            scheduleLoad(n);
+        }
+    });
+}
+async function handleBatchOps(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 [b] for batch operations.")];
+        loadedItemId = "batch_info";
+        draw();
+        return;
+    }
+    openForm(`Batch Ops: ${colName}`, [
+        {
+            id: "action",
+            label: "Action",
+            value: "put",
+            options: ["put", "delete"],
+        },
+        {
+            id: "input",
+            label: "JSON File Path or IDs (comma-sep for delete)",
+            placeholder: "/path/to/file.json or id1,id2,id3",
+        },
+    ], async (vals) => {
+        const action = vals.action || "";
+        const input = (vals.input || "").trim();
+        if (!input) {
+            throw new Error("Input is required.");
+        }
+        if (action === "put") {
+            const data = JSON.parse(await fs.promises.readFile(input, "utf-8"));
+            const objects = Array.isArray(data) ? data : (data.objects ?? [data]);
+            const result = await db.putBatch(colName, objects);
+            viewerLines = [
+                ` ${pc.bold("Batch Put Complete")}`,
+                ` ${pc.dim(`Collection: ${colName}`)}`,
+                ` ${pc.dim(`Objects: ${result.length}`)}`,
+            ];
+            loadedItemId = "batch_result";
+            draw();
+        }
+        else if (action === "delete") {
+            const ids = input
+                .split(",")
+                .map((s) => s.trim())
+                .filter(Boolean);
+            const count = await db.deleteBatch(colName, ids);
+            viewerLines = [
+                ` ${pc.bold("Batch Delete Complete")}`,
+                ` ${pc.dim(`Collection: ${colName}`)}`,
+                ` ${pc.dim(`Deleted: ${count} objects`)}`,
+            ];
+            loadedItemId = "batch_result";
+            draw();
+        }
+    });
+}
 async function handleMaintenance() {
     // Cycle through maintenance operations with each press of 'm'
     const operations = ["health", "checkpoint", "backup"];
@@ -1745,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") {
@@ -1861,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
@@ -1953,12 +2455,31 @@ 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();
             }
-            else if (str === "n" || str === "N") {
+            else if (str === "n") {
                 await handleNeighbors(tree[cursorIndex]);
             }
+            else if (str === "N") {
+                await handleNlq(tree[cursorIndex]);
+            }
+            else if (str === "a" || str === "A") {
+                await handleAggregate(tree[cursorIndex]);
+            }
+            else if (str === "t" || str === "T") {
+                await handleTimeseries(tree[cursorIndex]);
+            }
+            else if (str === "o" || str === "O") {
+                await handleCollectionOptions(tree[cursorIndex]);
+            }
+            else if (str === "b" || str === "B") {
+                await handleBatchOps(tree[cursorIndex]);
+            }
             else if (str === "m" || str === "M") {
                 await handleMaintenance();
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thingd/cli",
-  "version": "0.55.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.55.0"
+    "@thingd/sdk": "0.57.0"
   },
   "engines": {
     "node": ">=24.0.0"