shabti 2.7.0 → 2.9.0

package/README.md

@@ -12,13 +12,24 @@ npm install -g shabti
 
 ### Prerequisites
 
-Shabti requires a running Qdrant instance for vector storage:
+Shabti requires a running Qdrant instance for vector storage.
+
+**Option 1: Docker**
 
 ```bash
 docker run -d --name qdrant -p 6333:6333 -p 6334:6334 qdrant/qdrant
 ```
 
-Verify the connection:
+**Option 2: Native binary (no Docker)**
+
+Download the binary for your platform from [Qdrant releases](https://github.com/qdrant/qdrant/releases) and run it directly.
+
+```bash
+# Check for locally installed qdrant
+shabti config setup --detect
+```
+
+**Verify the connection:**
 
 ```bash
 shabti config setup --check
@@ -56,6 +67,7 @@ shabti status
 | `snapshot`        | Manage storage snapshots            |
 | `config`          | Manage configuration                |
 | `gc`              | Garbage collect expired entries     |
+| `health`          | Run health checks on engine         |
 | `a2a`             | Start A2A protocol server           |
 | `chat`            | Interactive chat with OpenAI        |
 | `mcp-config`      | Print MCP server configuration JSON |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shabti",
-  "version": "2.7.0",
+  "version": "2.9.0",
   "description": "Agent Memory OS — semantic memory for AI agents",
   "type": "module",
   "main": "native.cjs",

package/src/commands/config.js

@@ -49,22 +49,66 @@ export function registerConfig(program) {
     .command("setup")
     .description("Show Qdrant setup instructions")
     .option("--check", "Test connection to Qdrant")
+    .option("--detect", "Detect locally installed qdrant binary")
     .action(async (opts) => {
       const config = loadConfig();
       heading("Qdrant Setup");
       console.log();
       console.log("  shabti requires a running Qdrant instance for vector storage.");
       console.log();
-      console.log(chalk.cyan("  Quick start with Docker:"));
+
+      // Option 1: Docker
+      console.log(chalk.cyan("  Option 1: Docker"));
       console.log();
       console.log(`    docker run -d --name qdrant -p 6333:6333 -p 6334:6334 qdrant/qdrant`);
       console.log();
+
+      // Option 2: Native binary
+      console.log(chalk.cyan("  Option 2: Native binary (no Docker required)"));
+      console.log();
+      console.log(
+        `    Download from: ${chalk.underline("https://github.com/qdrant/qdrant/releases")}`,
+      );
+      console.log();
+      const plat = process.platform;
+      if (plat === "linux") {
+        console.log("    Linux:");
+        console.log(
+          "      wget https://github.com/qdrant/qdrant/releases/latest/download/qdrant-x86_64-unknown-linux-gnu.tar.gz",
+        );
+        console.log("      tar xzf qdrant-x86_64-unknown-linux-gnu.tar.gz");
+        console.log("      ./qdrant");
+      } else if (plat === "darwin") {
+        console.log("    macOS:");
+        console.log("      Download the macOS binary from the releases page,");
+        console.log("      or build from source: cargo install qdrant");
+      } else if (plat === "win32") {
+        console.log("    Windows:");
+        console.log("      Download qdrant.exe from the releases page and run it.");
+      }
+      console.log();
+
       console.log(`  Current Qdrant URL: ${chalk.yellow(config.qdrant_url)}`);
       console.log();
       console.log("  To change the URL:");
       console.log(`    shabti config set qdrant_url ${chalk.dim("<url>")}`);
       console.log();
 
+      if (opts.detect) {
+        const { execFileSync } = await import("node:child_process");
+        const cmd = plat === "win32" ? "where" : "which";
+        try {
+          const result = execFileSync(cmd, ["qdrant"], {
+            encoding: "utf8",
+            timeout: 5000,
+          }).trim();
+          success(`Qdrant binary found at: ${result}`);
+        } catch (_) {
+          console.log(chalk.yellow("  Qdrant binary not found in PATH."));
+          console.log("  Download it from https://github.com/qdrant/qdrant/releases");
+        }
+      }
+
       if (opts.check) {
         const restUrl = config.qdrant_url.replace(":6334", ":6333");
         try {

package/src/commands/health.js

@@ -0,0 +1,104 @@
+import chalk from "chalk";
+import { createEngine, loadConfig } from "../core/engine.js";
+import { heading, success, warn } from "../utils/style.js";
+
+export function registerHealth(program) {
+  program
+    .command("health")
+    .description("Run health checks on the shabti engine")
+    .option("-j, --json", "Output as JSON")
+    .action(async (opts) => {
+      const checks = [];
+
+      // 1. Qdrant connectivity
+      const config = loadConfig();
+      const qdrantUrl = config.qdrant_url.replace(/:\d+$/, ":6333");
+      try {
+        const res = await fetch(`${qdrantUrl}/healthz`, {
+          signal: AbortSignal.timeout(3000),
+        });
+        checks.push({
+          name: "qdrant",
+          status: res.ok ? "ok" : "degraded",
+          message: res.ok ? "Reachable" : `HTTP ${res.status}`,
+        });
+      } catch (err) {
+        checks.push({
+          name: "qdrant",
+          status: "error",
+          message: err.message,
+        });
+      }
+
+      // 2. Engine initialization
+      let engine = null;
+      try {
+        engine = createEngine();
+        const status = engine.status();
+        checks.push({
+          name: "engine",
+          status: "ok",
+          message: `${status.entryCount} entries, tier: ${status.tier}`,
+        });
+      } catch (err) {
+        checks.push({
+          name: "engine",
+          status: "error",
+          message: err.message,
+        });
+      }
+
+      // 3. Embedding model
+      if (engine) {
+        try {
+          const modelId = engine.modelId();
+          checks.push({
+            name: "embedding",
+            status: "ok",
+            message: modelId,
+          });
+        } catch (err) {
+          checks.push({
+            name: "embedding",
+            status: "error",
+            message: err.message,
+          });
+        }
+      }
+
+      const allOk = checks.every((c) => c.status === "ok");
+
+      if (opts.json) {
+        console.log(JSON.stringify({ healthy: allOk, checks }, null, 2));
+      } else {
+        heading("Health Check");
+        console.log();
+        for (const check of checks) {
+          const icon =
+            check.status === "ok"
+              ? chalk.green("✓")
+              : check.status === "degraded"
+                ? chalk.yellow("⚠")
+                : chalk.red("✗");
+          console.log(`  ${icon} ${chalk.cyan(check.name.padEnd(12))} ${check.message}`);
+        }
+        console.log();
+        if (allOk) {
+          success("All checks passed");
+        } else {
+          warn("Some checks failed");
+        }
+        console.log();
+      }
+
+      if (engine) {
+        try {
+          await engine.shutdown();
+        } catch (_) {
+          // best-effort
+        }
+      }
+
+      if (!allOk) process.exitCode = 1;
+    });
+}

package/src/index.js

@@ -16,6 +16,7 @@ import { registerExport } from "./commands/export.js";
 import { registerImport } from "./commands/import.js";
 import { registerStore } from "./commands/store.js";
 import { registerDelete } from "./commands/delete.js";
+import { registerHealth } from "./commands/health.js";
 
 const { version } = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
 
@@ -86,6 +87,7 @@ function buildProgram() {
   registerImport(program);
   registerStore(program);
   registerDelete(program);
+  registerHealth(program);
 
   program
     .command("gc")