thingd-cli 0.11.0 → 0.12.0

package/README.md

@@ -132,14 +132,22 @@ thingd mcp-http --path ./thingd.db --driver native --port 8757 --auth-token chan
 
 ### Command Reference
 
-**Metrics & Discovery**
+**System & Diagnostics**
 ```bash
-thingd metrics                # Get total counts (objects, events, activeJobs, deadJobs)
+thingd doctor                 # Run Node, native binding, and remote connectivity diagnostics
+thingd metrics                # Get total database counts (objects, events, activeJobs, deadJobs)
 thingd status                 # Check cluster health (requires --url)
 thingd tools                  # List available MCP tools (requires --url)
-thingd collections list       # List all collection names
-thingd streams list           # List all stream names
-thingd queues list-all        # List all queue names
+thingd bench rust --smoke     # Run Rust SQLite engine smoke benchmarks
+thingd bench rust --count 500 # Run Rust SQLite engine benchmarks with specific run count
+```
+
+**Discovery & Collections**
+```bash
+thingd collections list       # List all active collections
+thingd streams list           # List all active stream names (alias for events streams)
+thingd events streams         # List all active event streams
+thingd queues list-all        # List all active queue names
 ```
 
 **Search**
@@ -149,10 +157,11 @@ thingd search "my query" [--collection <name>] [--limit <n>]
 
 **Objects**
 ```bash
-thingd objects put decisions rust-core --text "Use Rust for the core engine."
-thingd objects put decisions rust-core --data '{"status":"active"}'
-thingd objects get decisions rust-core
-thingd objects delete decisions rust-core
+thingd objects list decisions                  # List all objects inside a collection
+thingd objects put decisions core --text "msg" # Put object with plain text content
+thingd objects put decisions core --data '{"a":1}' # Put object with arbitrary JSON data
+thingd objects get decisions core              # Fetch a specific object by ID
+thingd objects delete decisions core           # Delete an object by ID
 ```
 
 **Events**
@@ -163,6 +172,7 @@ thingd events list project:thingd
 
 **Queues**
 ```bash
+thingd queues stats embed                      # View queue statistics (ready, leased, dead jobs)
 thingd queues push embed --payload '{"object":"docs/readme"}'
 thingd queues claim embed
 thingd queues ack embed <jobId>
@@ -172,3 +182,4 @@ thingd queues dead embed
 ```
 
 
+

package/dist/doctor.d.ts

@@ -0,0 +1,3 @@
+import { type CliContext } from "./index.js";
+export declare function runDoctor(context: CliContext): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,UAAU,EAAqB,MAAM,YAAY,CAAC;AAEhE,wBAAsB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAsMlE"}

package/dist/doctor.js

@@ -0,0 +1,164 @@
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import pc from "picocolors";
+import { resolveConnection } from "./index.js";
+export async function runDoctor(context) {
+    context.stderr.write(`\n${pc.bold("thingd doctor")}\n`);
+    context.stderr.write(`${pc.dim("Running system diagnostics and connectivity tests...")}\n\n`);
+    let healthy = true;
+    // 1. Check Node version
+    const nodeVersion = process.version;
+    const majorVersion = Number.parseInt(nodeVersion.slice(1).split(".")[0] ?? "0", 10);
+    if (majorVersion >= 20) {
+        context.stderr.write(`  ${pc.green("✓")} Node version:   ${pc.cyan(nodeVersion)} (OK)\n`);
+    }
+    else {
+        healthy = false;
+        context.stderr.write(`  ${pc.red("×")} Node version:   ${pc.yellow(nodeVersion)} (Requires >= v20.x)\n`);
+    }
+    // 2. Resolve connection options
+    const connection = resolveConnection(context);
+    // 3. Native Driver Checks
+    if (connection.driver === "native") {
+        const customPath = process.env.THINGD_NATIVE_PATH;
+        if (customPath) {
+            if (existsSync(customPath)) {
+                try {
+                    const require = createRequire(import.meta.url);
+                    const binding = require(customPath);
+                    if (binding?.NativeThingStore) {
+                        context.stderr.write(`  ${pc.green("✓")} Native Binding: ${pc.cyan("Loaded via THINGD_NATIVE_PATH")} (${pc.dim(customPath)})\n`);
+                    }
+                    else {
+                        healthy = false;
+                        context.stderr.write(`  ${pc.red("×")} Native Binding: ${pc.yellow("Loaded but missing NativeThingStore export")} (${pc.dim(customPath)})\n`);
+                    }
+                }
+                catch (error) {
+                    healthy = false;
+                    context.stderr.write(`  ${pc.red("×")} Native Binding: ${pc.yellow(`Failed to load: ${error instanceof Error ? error.message : String(error)}`)} (${pc.dim(customPath)})\n`);
+                }
+            }
+            else {
+                healthy = false;
+                context.stderr.write(`  ${pc.red("×")} Native Binding: ${pc.yellow("File does not exist")} at THINGD_NATIVE_PATH="${pc.dim(customPath)}"\n`);
+            }
+        }
+        else {
+            // Auto-detect sibling binary
+            let detectedPath = null;
+            try {
+                const scriptPath = process.argv[1];
+                if (scriptPath) {
+                    const cliDir = join(resolve(scriptPath), "..", "..");
+                    const candidates = [
+                        join(cliDir, "node_modules", "thingd-native", "dist", "thingd_native.node"),
+                        join(cliDir, "..", "thingd-native", "dist", "thingd_native.node"),
+                        join(homedir(), "Space/Programming/personal/thingd/packages/thingd-native/dist/thingd_native.node"),
+                        join(homedir(), "Space/Programming/personal/thingd-cloud/packages/thingd-native/dist/thingd_native.node"),
+                    ];
+                    for (const candidate of candidates) {
+                        if (existsSync(candidate)) {
+                            detectedPath = candidate;
+                            break;
+                        }
+                    }
+                }
+            }
+            catch {
+                // Ignore
+            }
+            if (detectedPath) {
+                try {
+                    const require = createRequire(import.meta.url);
+                    const binding = require(detectedPath);
+                    if (binding?.NativeThingStore) {
+                        context.stderr.write(`  ${pc.green("✓")} Native Binding: ${pc.cyan("Auto-detected and loaded successfully")} (${pc.dim(detectedPath)})\n`);
+                    }
+                    else {
+                        healthy = false;
+                        context.stderr.write(`  ${pc.red("×")} Native Binding: ${pc.yellow("Auto-detected but missing NativeThingStore export")} (${pc.dim(detectedPath)})\n`);
+                    }
+                }
+                catch (error) {
+                    healthy = false;
+                    context.stderr.write(`  ${pc.red("×")} Native Binding: ${pc.yellow(`Failed to load auto-detected binding: ${error instanceof Error ? error.message : String(error)}`)} (${pc.dim(detectedPath)})\n`);
+                }
+            }
+            else {
+                healthy = false;
+                context.stderr.write(`  ${pc.red("×")} Native Binding: ${pc.yellow('Not found. Run "pnpm --filter thingd-native build" or configure THINGD_NATIVE_PATH.')}\n`);
+            }
+        }
+    }
+    else {
+        context.stderr.write(`  ${pc.dim("○")} Native Binding: Skipped (Using driver: "${connection.driver ?? "memory"}")\n`);
+    }
+    // 4. Remote Sidecar Reachability & Auth Checks
+    if (connection.cloud) {
+        const rawUrl = connection.path;
+        const isLocal = rawUrl.includes("localhost") || rawUrl.includes("127.0.0.1");
+        if (!connection.authToken && !isLocal) {
+            context.stderr.write(`  ${pc.yellow("⚠")} Auth Token:     ${pc.yellow("Missing THINGD_AUTH_TOKEN for remote server (might fail)")}\n`);
+        }
+        else if (connection.authToken) {
+            context.stderr.write(`  ${pc.green("✓")} Auth Token:     ${pc.cyan("Configured")}\n`);
+        }
+        else {
+            context.stderr.write(`  ${pc.green("✓")} Auth Token:     ${pc.dim("Not required for local sidecar")}\n`);
+        }
+        try {
+            const normalizeUrl = (val) => val.startsWith("thingd://") ? `http://${val.slice("thingd://".length)}` : val;
+            const targetUrl = new URL(normalizeUrl(rawUrl));
+            if (targetUrl.pathname === "/mcp" || targetUrl.pathname === "") {
+                targetUrl.pathname = "/healthz";
+            }
+            else {
+                targetUrl.pathname = `${targetUrl.pathname.replace(/\/mcp$/, "")}/healthz`;
+            }
+            context.stderr.write(`  ${pc.dim("○")} Connectivity:   Checking reachability to ${pc.cyan(targetUrl.toString())}...\n`);
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 3000);
+            const headers = {};
+            if (connection.authToken) {
+                headers.Authorization = `Bearer ${connection.authToken}`;
+            }
+            try {
+                const response = await fetch(targetUrl, {
+                    signal: controller.signal,
+                    headers,
+                });
+                clearTimeout(timeoutId);
+                if (response.ok) {
+                    context.stderr.write(`  ${pc.green("✓")} Connectivity:   ${pc.cyan("Connected successfully!")} (${pc.dim(`HTTP ${response.status}`)})\n`);
+                }
+                else {
+                    healthy = false;
+                    context.stderr.write(`  ${pc.red("×")} Connectivity:   ${pc.yellow(`Server responded with non-2xx status`)} (${pc.dim(`HTTP ${response.status}`)})\n`);
+                }
+            }
+            catch (fetchError) {
+                clearTimeout(timeoutId);
+                healthy = false;
+                context.stderr.write(`  ${pc.red("×")} Connectivity:   ${pc.yellow(`Failed to connect. Connection refused or timed out.`)} (${pc.dim(fetchError instanceof Error ? fetchError.message : String(fetchError))})\n`);
+            }
+        }
+        catch (urlError) {
+            healthy = false;
+            context.stderr.write(`  ${pc.red("×")} Connectivity:   ${pc.yellow(`Invalid URL structure: ${urlError instanceof Error ? urlError.message : String(urlError)}`)}\n`);
+        }
+    }
+    else {
+        context.stderr.write(`  ${pc.green("✓")} Connectivity:   ${pc.cyan("Local SQLite Store")} (${pc.dim(connection.path)})\n`);
+    }
+    // Final Summary Report
+    context.stderr.write("\n");
+    if (healthy) {
+        context.stderr.write(`  ${pc.bold(pc.green("Diagnosis: Everything looks healthy!"))}\n\n`);
+    }
+    else {
+        context.stderr.write(`  ${pc.bold(pc.yellow("Diagnosis: Some items require attention (see errors above)."))}\n\n`);
+    }
+}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAOA,OAAO,EAOL,MAAM,EACN,KAAK,YAAY,EAClB,MAAM,QAAQ,CAAC;AAKhB,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,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,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,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,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;CAChB,CAAC;AAmDF,wBAAsB,MAAM,CAC1B,IAAI,WAAwB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAiEjB;AA+UD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAcf;AA4BD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,iBAAiB,CA2BxE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AASA,OAAO,EAOL,MAAM,EACN,KAAK,YAAY,EAClB,MAAM,QAAQ,CAAC;AAKhB,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,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,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,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,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;CAChB,CAAC;AA0DF,wBAAsB,MAAM,CAC1B,IAAI,WAAwB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAiEjB;AA8jBD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAcf;AA4BD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,iBAAiB,CA2BxE"}

package/dist/index.js

@@ -4,6 +4,8 @@ import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import Table from "cli-table3";
+import pc from "picocolors";
 import { ThingD, } from "thingd";
 import { runInteractiveCli } from "./interactive.js";
 import { runMcp } from "./mcp.js";
@@ -16,24 +18,30 @@ Usage:
   thingd status [--url <url>]
   thingd tools --url <url>
   thingd install [--raw] [--claude] [--cursor]
+  thingd doctor
   thingd mcp [--path <path>] [--driver <driver>]
   thingd mcp-http [--path <path>] [--driver <driver>] [--host <host>] [--port <port>] [--auth-token <tok>] [--allow-unauthenticated]
   thingd search <query> [--collection <name>] [--limit <n>]
+  thingd objects list <collection>
   thingd objects get <collection> <id>
   thingd objects put <collection> <id> --text <text>
   thingd objects put <collection> <id> --data '{"field":"value"}'
   thingd objects delete <collection> <id>
+  thingd events streams
   thingd events append <stream> <type> [--text <text>] [--data '{"field":"value"}']
   thingd events list [stream] [--limit <n>]
   thingd collections list
   thingd streams list
   thingd queues list-all
+  thingd queues stats <queue>
   thingd queues push <queue> --payload '{"key":"value"}'
   thingd queues claim <queue> [--lease-ms <ms>]
   thingd queues ack <queue> <jobId>
   thingd queues nack <queue> <jobId> [--error <message>] [--delay-ms <ms>]
   thingd queues list <queue> [--limit <n>]
   thingd queues dead <queue> [--limit <n>]
+  thingd bench rust --smoke
+  thingd bench rust --count <n>
   thingd metrics
 
 Options:
@@ -54,6 +62,7 @@ const BOOLEAN_FLAGS = new Set([
     "raw",
     "claude",
     "cursor",
+    "smoke",
 ]);
 export async function runCli(args = process.argv.slice(2), options = {}) {
     // Auto-detect and set THINGD_NATIVE_PATH if not already set, to allow global execution
@@ -136,6 +145,15 @@ async function runCommand(context) {
         await runInstall(context);
         return;
     }
+    if (command === "doctor") {
+        const { runDoctor } = await import("./doctor.js");
+        await runDoctor(context);
+        return;
+    }
+    if (command === "bench") {
+        await runBench(context);
+        return;
+    }
     if (command === "objects") {
         await runObjects(context);
         return;
@@ -162,6 +180,63 @@ async function runCommand(context) {
     }
     throw new Error(`Unknown command: ${command}`);
 }
+async function runBench(context) {
+    const target = requiredToken(context.parsed, 1, "benchmark target (rust)");
+    if (target !== "rust") {
+        throw new Error(`Unsupported benchmark target: ${target}`);
+    }
+    const isSmoke = hasFlag(context.parsed, "smoke");
+    const countStr = stringFlag(context.parsed, "count");
+    const count = countStr ? Number.parseInt(countStr, 10) : isSmoke ? 100 : undefined;
+    if (count === undefined) {
+        throw new Error("bench rust requires --smoke or --count <n>");
+    }
+    if (Number.isNaN(count) || count <= 0) {
+        throw new Error("--count must be a positive integer");
+    }
+    try {
+        const { execSync } = await import("node:child_process");
+        try {
+            execSync("cargo --version", { stdio: "ignore" });
+        }
+        catch {
+            throw new Error("Rust toolchain (cargo) is not installed or not in the PATH. Cannot run Rust benchmarks.");
+        }
+        context.stderr.write(`\n${pc.bold("Running Rust storage benchmark")} (Count: ${pc.cyan(count)})...\n\n`);
+        const { spawn } = await import("node:child_process");
+        const child = spawn("cargo", [
+            "run",
+            "--release",
+            "-p",
+            "thingd-core",
+            "--example",
+            "storage_bench",
+            "--features",
+            "sqlite",
+            "--",
+            String(count),
+        ], {
+            stdio: "inherit",
+            cwd: resolve(resolveCliPath(), "../../../.."),
+        });
+        return new Promise((resolvePromise, rejectPromise) => {
+            child.on("close", (code) => {
+                if (code === 0) {
+                    resolvePromise();
+                }
+                else {
+                    rejectPromise(new Error(`Benchmark failed with exit code: ${code}`));
+                }
+            });
+            child.on("error", (error) => {
+                rejectPromise(error);
+            });
+        });
+    }
+    catch (err) {
+        throw new Error(`Failed to run benchmark: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
 async function runStatus(context) {
     const connection = resolveConnection(context);
     if (!connection.cloud) {
@@ -233,8 +308,32 @@ async function runSearch(context) {
 async function runObjects(context) {
     const action = requiredToken(context.parsed, 1, "objects action");
     const collection = requiredToken(context.parsed, 2, "collection");
-    const id = requiredToken(context.parsed, 3, "object id");
     await withDb(context, async (db) => {
+        if (action === "list") {
+            const objects = await db.listObjects(collection);
+            if (context.pretty) {
+                const table = new Table({
+                    head: ["ID", "Version", "Created At", "Updated At", "Data"],
+                    style: { head: ["green"] },
+                });
+                for (const obj of objects) {
+                    const { id, collection: _, createdAt, updatedAt, version, ...data } = obj;
+                    table.push([
+                        id,
+                        String(version),
+                        createdAt ? new Date(createdAt).toLocaleString() : "",
+                        updatedAt ? new Date(updatedAt).toLocaleString() : "",
+                        JSON.stringify(data),
+                    ]);
+                }
+                context.stdout.write(`${table.toString()}\n`);
+            }
+            else {
+                writeJson(context.stdout, objects, false);
+            }
+            return;
+        }
+        const id = requiredToken(context.parsed, 3, "object id");
         if (action === "get") {
             writeJson(context.stdout, await db.get(collection, id), context.pretty);
             return;
@@ -254,10 +353,47 @@ async function runObjects(context) {
 async function runEvents(context) {
     const action = requiredToken(context.parsed, 1, "events action");
     await withDb(context, async (db) => {
+        if (action === "streams") {
+            const streams = await db.listStreams();
+            if (context.pretty) {
+                const table = new Table({
+                    head: ["Stream Name"],
+                    style: { head: ["green"] },
+                });
+                for (const str of streams) {
+                    table.push([str]);
+                }
+                context.stdout.write(`${table.toString()}\n`);
+            }
+            else {
+                writeJson(context.stdout, streams, false);
+            }
+            return;
+        }
         if (action === "list") {
             const stream = optionalToken(context.parsed, 2);
-            const events = await db.events.list(stream);
-            writeJson(context.stdout, limitItems(events, optionalInt(context.parsed, "limit")), context.pretty);
+            const events = limitItems(await db.events.list(stream), optionalInt(context.parsed, "limit"));
+            if (context.pretty) {
+                const table = new Table({
+                    head: ["Event ID", "Stream", "Event Type", "Created At", "Text", "Data"],
+                    style: { head: ["green"] },
+                });
+                for (const ev of events) {
+                    const { id, stream: evStream, type, createdAt, text, ...data } = ev;
+                    table.push([
+                        id,
+                        evStream,
+                        type,
+                        createdAt ? new Date(createdAt).toLocaleString() : "",
+                        text ?? "",
+                        JSON.stringify(data),
+                    ]);
+                }
+                context.stdout.write(`${table.toString()}\n`);
+            }
+            else {
+                writeJson(context.stdout, events, false);
+            }
             return;
         }
         if (action === "append") {
@@ -274,7 +410,20 @@ async function runCollections(context) {
     const action = requiredToken(context.parsed, 1, "collections action");
     await withDb(context, async (db) => {
         if (action === "list") {
-            writeJson(context.stdout, await db.listCollections(), context.pretty);
+            const collections = await db.listCollections();
+            if (context.pretty) {
+                const table = new Table({
+                    head: ["Collection Name"],
+                    style: { head: ["green"] },
+                });
+                for (const col of collections) {
+                    table.push([col]);
+                }
+                context.stdout.write(`${table.toString()}\n`);
+            }
+            else {
+                writeJson(context.stdout, collections, false);
+            }
             return;
         }
         throw new Error(`Unknown collections action: ${action}`);
@@ -284,7 +433,20 @@ async function runStreams(context) {
     const action = requiredToken(context.parsed, 1, "streams action");
     await withDb(context, async (db) => {
         if (action === "list") {
-            writeJson(context.stdout, await db.listStreams(), context.pretty);
+            const streams = await db.listStreams();
+            if (context.pretty) {
+                const table = new Table({
+                    head: ["Stream Name"],
+                    style: { head: ["green"] },
+                });
+                for (const str of streams) {
+                    table.push([str]);
+                }
+                context.stdout.write(`${table.toString()}\n`);
+            }
+            else {
+                writeJson(context.stdout, streams, false);
+            }
             return;
         }
         throw new Error(`Unknown streams action: ${action}`);
@@ -310,11 +472,50 @@ async function runQueues(context) {
     const action = requiredToken(context.parsed, 1, "queues action");
     await withDb(context, async (db) => {
         if (action === "list-all") {
-            writeJson(context.stdout, await db.listQueues(), context.pretty);
+            const queues = await db.listQueues();
+            if (context.pretty) {
+                const table = new Table({
+                    head: ["Queue Name"],
+                    style: { head: ["green"] },
+                });
+                for (const q of queues) {
+                    table.push([q]);
+                }
+                context.stdout.write(`${table.toString()}\n`);
+            }
+            else {
+                writeJson(context.stdout, queues, false);
+            }
             return;
         }
         const queueName = requiredToken(context.parsed, 2, "queue");
         const queue = db.queue(queueName);
+        if (action === "stats") {
+            const [activeJobs, deadJobs] = await Promise.all([queue.list(), queue.dead()]);
+            const totalActive = activeJobs.length;
+            const totalDead = deadJobs.length;
+            const leasedJobs = activeJobs.filter((job) => job.status === "leased");
+            const readyJobs = activeJobs.filter((job) => job.status === "ready");
+            const stats = {
+                queue: queueName,
+                totalActive,
+                ready: readyJobs.length,
+                leased: leasedJobs.length,
+                dead: totalDead,
+            };
+            if (context.pretty) {
+                const table = new Table({
+                    head: ["Stat Metric", "Value"],
+                    style: { head: ["green"] },
+                });
+                table.push(["Queue Name", queueName], ["Ready Jobs", String(readyJobs.length)], ["Leased Jobs", String(leasedJobs.length)], ["Dead Jobs", String(totalDead)], ["Total Active", String(totalActive)]);
+                context.stdout.write(`${table.toString()}\n`);
+            }
+            else {
+                writeJson(context.stdout, stats, false);
+            }
+            return;
+        }
         if (action === "push") {
             const payload = parseJsonRecord(requiredFlag(context.parsed, "payload"));
             const options = {
@@ -345,11 +546,51 @@ async function runQueues(context) {
             return;
         }
         if (action === "list") {
-            writeJson(context.stdout, limitItems(await queue.list(), optionalInt(context.parsed, "limit")), context.pretty);
+            const jobs = limitItems(await queue.list(), optionalInt(context.parsed, "limit"));
+            if (context.pretty) {
+                const table = new Table({
+                    head: ["Job ID", "Status", "Attempts", "Max Attempts", "Available At", "Payload"],
+                    style: { head: ["green"] },
+                });
+                for (const job of jobs) {
+                    table.push([
+                        job.id,
+                        job.status,
+                        String(job.attempts),
+                        String(job.maxAttempts),
+                        job.availableAt ? new Date(job.availableAt).toLocaleString() : "",
+                        JSON.stringify(job.payload),
+                    ]);
+                }
+                context.stdout.write(`${table.toString()}\n`);
+            }
+            else {
+                writeJson(context.stdout, jobs, false);
+            }
             return;
         }
         if (action === "dead") {
-            writeJson(context.stdout, limitItems(await queue.dead(), optionalInt(context.parsed, "limit")), context.pretty);
+            const jobs = limitItems(await queue.dead(), optionalInt(context.parsed, "limit"));
+            if (context.pretty) {
+                const table = new Table({
+                    head: ["Job ID", "Attempts", "Max Attempts", "Dead At", "Last Error", "Payload"],
+                    style: { head: ["green"] },
+                });
+                for (const job of jobs) {
+                    table.push([
+                        job.id,
+                        String(job.attempts),
+                        String(job.maxAttempts),
+                        job.deadAt ? new Date(job.deadAt).toLocaleString() : "",
+                        job.lastError ?? "",
+                        JSON.stringify(job.payload),
+                    ]);
+                }
+                context.stdout.write(`${table.toString()}\n`);
+            }
+            else {
+                writeJson(context.stdout, jobs, false);
+            }
             return;
         }
         throw new Error(`Unknown queues action: ${action}`);

package/dist/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAwB7C,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAqInE"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAwB7C,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAyInE"}

package/dist/install.js

@@ -127,9 +127,15 @@ export async function runInstall(context) {
         };
         context.stdout.write(`${JSON.stringify(fullConfig, null, 2)}\n`);
     }
-    if (showClaude || showCursor) {
+    if (choice === "1") {
         context.stderr.write(`\n  Restart Claude Desktop to activate. Cursor activates immediately after pasting.\n\n`);
     }
+    else if (choice === "2") {
+        context.stderr.write(`\n  Restart Claude Desktop to activate.\n\n`);
+    }
+    else if (choice === "3") {
+        context.stderr.write(`\n  Cursor activates immediately after pasting.\n\n`);
+    }
 }
 function findGlobalBinPath() {
     try {

package/dist/interactive.d.ts.map

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

package/dist/interactive.js

@@ -229,11 +229,12 @@ async function fetchResources() {
                 db.listStreams(),
                 db.listQueues?.() ?? Promise.resolve([]),
             ]);
-            totalObjects = isNaN(objCount) || objCount === 0 ? totalObjects : objCount;
-            totalEventsCount = isNaN(evtCount) || evtCount === 0 ? totalEventsCount : evtCount;
+            totalObjects = Number.isNaN(objCount) || objCount === 0 ? totalObjects : objCount;
+            totalEventsCount = Number.isNaN(evtCount) || evtCount === 0 ? totalEventsCount : evtCount;
             totalActiveJobsCount =
-                isNaN(activeCount) || activeCount === 0 ? totalActiveJobsCount : activeCount;
-            totalDeadJobsCount = isNaN(deadCount) || deadCount === 0 ? totalDeadJobsCount : deadCount;
+                Number.isNaN(activeCount) || activeCount === 0 ? totalActiveJobsCount : activeCount;
+            totalDeadJobsCount =
+                Number.isNaN(deadCount) || deadCount === 0 ? totalDeadJobsCount : deadCount;
             collections = nativeCollections.length > 0 ? nativeCollections : ["decisions", "load-test"];
             streams =
                 nativeStreams.length > 0
@@ -712,9 +713,9 @@ function draw() {
     else {
         titleStr = ` thingd  ${pc.dim("|")} ${driver.toUpperCase()} ${pc.dim("|")} ${dbPath} `;
     }
-    buf += pc.inverse(padToWidth(titleStr, W)) + "\n";
+    buf += `${pc.inverse(padToWidth(titleStr, W))}\n`;
     // Separator
-    buf += pc.dim("─".repeat(sideW) + "─┬─" + "─".repeat(viewW)) + "\n";
+    buf += `${pc.dim(`${"─".repeat(sideW)}─┬─${"─".repeat(viewW)}`)}\n`;
     // Build Form Lines if active
     if (formState?.active) {
         viewerLines = [`${pc.bgCyan(pc.black(` ${formState.title} `))}`, ""];
@@ -783,15 +784,15 @@ function draw() {
         // Viewer
         const vLine = viewerLines[r + viewerScroll] ?? "";
         const right = fitToWidth(vLine, viewW, false);
-        buf += left + pc.dim(" │ ") + right + "\n";
+        buf += `${left + pc.dim(" │ ") + right}\n`;
     }
     // Separator
-    buf += pc.dim("─".repeat(sideW) + "─┴─" + "─".repeat(viewW)) + "\n";
+    buf += `${pc.dim(`${"─".repeat(sideW)}─┴─${"─".repeat(viewW)}`)}\n`;
     // Footer
     let help;
     if (formState?.active) {
         const hasOptions = formState.fields[formState.activeIndex]?.options;
-        help = ` ${pc.dim("↑↓")} focus  ${hasOptions ? pc.dim("←→") + " select  " : ""}${pc.dim("enter")} submit  ${pc.dim("ctrl+e")} editor  ${pc.dim("esc")} cancel `;
+        help = ` ${pc.dim("↑↓")} focus  ${hasOptions ? `${pc.dim("←→")} select  ` : ""}${pc.dim("enter")} submit  ${pc.dim("ctrl+e")} editor  ${pc.dim("esc")} cancel `;
     }
     else if (!connected) {
         help = ` ${pc.dim("↑↓")} nav  ${pc.dim("enter")} connect  ${pc.dim("q")} quit `;
@@ -897,7 +898,7 @@ async function launchEditor(f) {
         const newContent = fs.readFileSync(tmpFile, "utf-8");
         f.value = newContent.trim();
     }
-    catch (e) { }
+    catch (_e) { }
     if (process.stdin.isTTY)
         process.stdin.setRawMode(true);
     process.stdin.on("keypress", keypressHandler);
@@ -928,7 +929,7 @@ function parsePayload(str) {
                 v = true;
             else if (v === "false")
                 v = false;
-            else if (!isNaN(Number(v)))
+            else if (!Number.isNaN(Number(v)))
                 v = Number(v);
         }
         obj[k] = v;
@@ -985,8 +986,8 @@ async function handleCreate(selected) {
                 try {
                     id = crypto.randomUUID();
                 }
-                catch (e) {
-                    id = "obj_" + Date.now().toString(36) + Math.random().toString(36).substring(2);
+                catch (_e) {
+                    id = `obj_${Date.now().toString(36)}${Math.random().toString(36).substring(2)}`;
                 }
             }
             const data = parsePayload(vals.payload || "");
@@ -1109,7 +1110,7 @@ async function handleSearch() {
         const options = {};
         if (limitStr) {
             const limit = parseInt(limitStr, 10);
-            if (!isNaN(limit))
+            if (!Number.isNaN(limit))
                 options.limit = limit;
         }
         const results = await db.search(query, options);
@@ -1147,7 +1148,7 @@ async function handleInfo() {
                 const u = new URL(p, urlObj.toString());
                 const headers = {};
                 if (authToken)
-                    headers["Authorization"] = `Bearer ${authToken}`;
+                    headers.Authorization = `Bearer ${authToken}`;
                 const res = await fetch(u, { headers });
                 if (!res.ok)
                     throw new Error(`HTTP ${res.status}`);
@@ -1232,7 +1233,7 @@ function setupKeypress() {
             }
             else if (key.name === "left" || key.name === "right") {
                 const f = formState.fields[formState.activeIndex];
-                if (f && f.options && f.options.length > 0) {
+                if (f?.options && f.options.length > 0) {
                     const currentIndex = f.options.indexOf(f.value);
                     let nextIndex = key.name === "right" ? currentIndex + 1 : currentIndex - 1;
                     if (nextIndex < 0)

package/dist/mcp/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,YAAY,CAAC;AAWpB,MAAM,MAAM,0BAA0B,GAAG;IACvC,KAAK,CAAC,EAAE,qBAAqB,GAAG,KAAK,CAAC;CACvC,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,0BAA+B,GACvC,IAAI,CA6WN"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,YAAY,CAAC;AAWpB,MAAM,MAAM,0BAA0B,GAAG;IACvC,KAAK,CAAC,EAAE,qBAAqB,GAAG,KAAK,CAAC;CACvC,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,0BAA+B,GACvC,IAAI,CA+XN"}

package/dist/mcp/tools.js

@@ -305,6 +305,19 @@ export function registerThingdTools(server, db, options = {}) {
             openWorldHint: false,
         },
     }, async ({ queue }) => jsonResult(await db.queue(queue).dead()));
+    server.registerTool("thing_objects_list", {
+        title: "List Objects",
+        description: "List all thingd objects in a collection.",
+        inputSchema: {
+            collection: z.string().min(1),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ collection }) => jsonResult(await db.listObjects(collection)));
 }
 function auditMetadata(actor, source) {
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thingd-cli",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Command-line interface, Interactive TUI Dashboard, and MCP server for thingd.",
   "type": "module",
   "author": "Sayan Mohsin",
@@ -33,7 +33,7 @@
     "cli-table3": "^0.6.5",
     "picocolors": "^1.1.1",
     "zod": "^4.4.3",
-    "thingd": "0.11.0"
+    "thingd": "0.12.0"
   },
   "engines": {
     "node": ">=20"