shabti 2.8.0 → 2.10.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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shabti",
-  "version": "2.8.0",
+  "version": "2.10.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/search.js

@@ -3,6 +3,7 @@ import Table from "cli-table3";
 import { createEngine } from "../core/engine.js";
 import { error, heading } from "../utils/style.js";
 import { parsePositiveInt, parseScore } from "../utils/validate.js";
+import { normalizeText } from "../utils/normalize.js";
 
 export function registerSearch(program) {
   program
@@ -23,7 +24,7 @@ export function registerSearch(program) {
       try {
         const engine = createEngine();
 
-        const query = { text: queryText };
+        const query = { text: normalizeText(queryText) };
         query.limit = parsePositiveInt(opts.limit, "--limit");
         if (opts.namespace) query.namespace = opts.namespace;
         if (opts.timeStart) query.timeStart = parsePositiveInt(opts.timeStart, "--time-start");

package/src/commands/store.js

@@ -1,6 +1,7 @@
 import { createEngine, loadConfig, saveConfig } from "../core/engine.js";
 import { success, error, info, warn } from "../utils/style.js";
 import { parsePositiveInt } from "../utils/validate.js";
+import { normalizeText } from "../utils/normalize.js";
 
 export function registerStore(program) {
   program
@@ -31,7 +32,7 @@ export function registerStore(program) {
           }
         }
 
-        const result = await engine.store(content, options);
+        const result = await engine.store(normalizeText(content), options);
 
         if (result.status === "stored") {
           success(`Stored: ${result.id}`);

package/src/mcp/server.js

@@ -3,6 +3,7 @@ import { createInterface } from "readline";
 import { createEngine, loadConfig } from "../core/engine.js";
 import { createEngineWithRetry } from "../core/retry.js";
 import { logger } from "../utils/logger.js";
+import { normalizeText } from "../utils/normalize.js";
 
 const SERVER_INFO = {
   name: "shabti-memory",
@@ -228,7 +229,7 @@ async function handleToolsCall(id, params) {
       if (args.namespace) opts.namespace = args.namespace;
       if (args.tags) opts.tags = args.tags;
       if (args.ttl) opts.ttlSeconds = args.ttl;
-      const result = await eng.store(content, opts);
+      const result = await eng.store(normalizeText(content), opts);
       return respond(id, {
         content: [
           {
@@ -256,7 +257,7 @@ async function handleToolsCall(id, params) {
     }
     try {
       const limit = args.limit || 10;
-      const queryObj = { text: query, limit };
+      const queryObj = { text: normalizeText(query), limit };
       if (args.namespace) queryObj.namespace = args.namespace;
       const results = await eng.executeQuery(queryObj);
       const formatted = results.map((r) => ({

package/src/repl/slashCommands.js

@@ -1,5 +1,6 @@
 import chalk from "chalk";
 import { success, info, warn, error } from "../utils/style.js";
+import { normalizeText } from "../utils/normalize.js";
 
 const COMMANDS = {
   "/help": "Show this help message",
@@ -98,7 +99,7 @@ async function handleRemember(text, engine) {
     return true;
   }
   try {
-    const result = await engine.store(text, {});
+    const result = await engine.store(normalizeText(text), {});
     if (result.status === "stored") {
       success(`Remembered: ${result.id}`);
     } else {
@@ -125,7 +126,7 @@ async function handleRecall(query, engine) {
     return true;
   }
   try {
-    const results = await engine.executeQuery({ text: query, limit: 5 });
+    const results = await engine.executeQuery({ text: normalizeText(query), limit: 5 });
     console.log();
     if (results.length === 0) {
       console.log(chalk.dim("  No memories found."));

package/src/utils/normalize.js

@@ -0,0 +1,13 @@
+/**
+ * Normalize text for consistent storage and search.
+ * Applies NFKC Unicode normalization, trims, and collapses whitespace.
+ *
+ * NFKC normalizes:
+ *  - Full-width ASCII → half-width (Ａ → A, ０ → 0)
+ *  - Half-width katakana → full-width (ｶ → カ)
+ *  - Compatibility characters (① → 1, ㍻ → 平成)
+ */
+export function normalizeText(text) {
+  if (!text) return "";
+  return text.normalize("NFKC").replace(/\s+/g, " ").trim();
+}