memory-forge 0.3.13 → 0.4.0

package/dist/scenario-test.js

@@ -0,0 +1,177 @@
+/**
+ * Real-world scenario tests — simulates actual user workflows.
+ */
+import { MemoryStore, contentOverlap } from "./store.js";
+import { loadAllMemories } from "./storage/local.js";
+import { autoName, generateContextSummary } from "./auto/index.js";
+import { randomUUID } from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+let ok = 0;
+let ng = 0;
+function t(name, fn) { try {
+    fn();
+    ok++;
+}
+catch (e) {
+    ng++;
+    console.log("FAIL:", name, "—", e.message);
+} }
+const now = new Date().toISOString();
+// ═══ SCENARIO 1: Corrupted memory file ═══
+console.log("=== Scenario 1: Corrupted memory file ===");
+const corruptId = randomUUID();
+const memDir = path.join(process.env.HOME ?? process.env.USERPROFILE ?? "/tmp", ".memory-forge", "memories");
+const corruptPath = path.join(memDir, corruptId + ".md");
+fs.mkdirSync(memDir, { recursive: true });
+fs.writeFileSync(corruptPath, "NOT VALID MEMORY FILE\njust garbage\nno frontmatter");
+t("corrupted file does not crash loader", () => { loadAllMemories(); });
+t("corrupted file loads as memory with id-based name", () => {
+    const all = loadAllMemories();
+    const recovered = all.find(m => m.id === corruptId);
+    if (!recovered)
+        throw new Error("should load file content as memory");
+    // Without frontmatter, name defaults to id, content is full file text
+    if (recovered.category !== "general")
+        throw new Error("default category missing");
+});
+fs.unlinkSync(corruptPath);
+// ═══ SCENARIO 2: Duplicate import resilience ═══
+console.log("\n=== Scenario 2: Duplicate import resilience ===");
+const s2 = new MemoryStore();
+const dup1 = { id: randomUUID(), name: "Pref", content: "Always use React 19 with TypeScript strict mode", category: "user-preference", tags: ["react"], priority: 8, vector: [], created_at: now, access_count: 0, last_accessed: null };
+const dup2 = { id: randomUUID(), name: "Pref", content: "Always use React 19 with TypeScript strict mode", category: "user-preference", tags: ["react"], priority: 8, vector: [], created_at: now, access_count: 0, last_accessed: null };
+s2.add(dup1);
+s2.add(dup2);
+t("both stored (different IDs)", () => { if (s2.size() !== 2)
+    throw new Error("size=" + s2.size()); });
+const overlap = contentOverlap(dup1.content, dup2.content);
+t("100% overlap detected", () => { if (overlap < 0.99)
+    throw new Error("overlap=" + overlap); });
+// ═══ SCENARIO 3: Memory lifecycle ═══
+console.log("\n=== Scenario 3: Full memory lifecycle ===");
+const s3 = new MemoryStore();
+const lifeId = randomUUID();
+s3.add({ id: lifeId, name: "Lifecycle Test", content: "Original content v1", category: "general", tags: ["test"], priority: 5, vector: [], created_at: now, access_count: 0, last_accessed: null });
+t("create", () => { if (!s3.get(lifeId))
+    throw new Error("not found"); });
+const m = s3.get(lifeId);
+m.content = "Updated content v2";
+m.name = autoName(m.content);
+m.category = "decision-log";
+m.tags = ["updated", "v2"];
+m.priority = 9;
+t("update content", () => { if (s3.get(lifeId).content !== "Updated content v2")
+    throw new Error("content"); });
+t("update category", () => { if (s3.get(lifeId).category !== "decision-log")
+    throw new Error("category"); });
+t("update tags", () => { if (s3.get(lifeId).tags.length !== 2)
+    throw new Error("tags"); });
+t("update priority", () => { if (s3.get(lifeId).priority !== 9)
+    throw new Error("priority"); });
+t("update name", () => { if (s3.get(lifeId).name !== "Updated content v2")
+    throw new Error("name"); });
+const found = s3.keywordSearch("updated", { limit: 5 });
+t("search finds updated", () => { if (found.length === 0)
+    throw new Error("not found"); });
+t("search score reasonable", () => { if (found[0]._score < 5)
+    throw new Error("score=" + found[0]._score); });
+s3.remove(lifeId);
+t("forget removes", () => { if (s3.get(lifeId) !== null)
+    throw new Error("still exists"); });
+// ═══ SCENARIO 4: Context summary ranking ═══
+console.log("\n=== Scenario 4: Context summary ranking ===");
+const s4 = new MemoryStore();
+s4.add({ id: "high", name: "High Priority", content: "Critical security config", category: "decision-log", tags: [], priority: 10, vector: [], created_at: now, access_count: 100, last_accessed: now });
+s4.add({ id: "low", name: "Low Priority", content: "Casual note", category: "general", tags: [], priority: 1, vector: [], created_at: "2020-01-01T00:00:00Z", access_count: 0, last_accessed: null });
+const summary = generateContextSummary(s4, 1);
+t("high priority wins", () => { if (!summary.includes("High Priority"))
+    throw new Error("low won"); });
+t("low priority excluded", () => { if (summary.includes("Low Priority"))
+    throw new Error("low included"); });
+// ═══ SCENARIO 5: Concurrent write safety ═══
+console.log("\n=== Scenario 5: Concurrent write safety ===");
+const s5 = new MemoryStore();
+const cid = randomUUID();
+s5.add({ id: cid, name: "First", content: "First write", category: "general", tags: [], priority: 5, vector: [], created_at: now, access_count: 0, last_accessed: null });
+s5.add({ id: cid, name: "Second", content: "Second write", category: "general", tags: [], priority: 5, vector: [], created_at: now, access_count: 0, last_accessed: null });
+t("last write wins", () => { if (s5.get(cid).content !== "Second write")
+    throw new Error(s5.get(cid).content); });
+// ═══ SCENARIO 6: Export/import round-trip ═══
+console.log("\n=== Scenario 6: Export/import round-trip ===");
+const s6 = new MemoryStore();
+s6.add({ id: "e1", name: "Export Test", content: "Data for export", category: "general", tags: ["export"], priority: 5, vector: [], created_at: now, access_count: 0, last_accessed: null });
+const exported = s6.list({ limit: 100, offset: 0 });
+const imported = new MemoryStore();
+for (const em of exported)
+    imported.add({ ...em });
+t("round-trip content", () => { if (imported.get("e1").content !== "Data for export")
+    throw new Error("lost"); });
+t("round-trip tags", () => { if (imported.get("e1").tags[0] !== "export")
+    throw new Error("tags lost"); });
+// ═══ SCENARIO 7: Multi-tag filtering ═══
+console.log("\n=== Scenario 7: Multi-tag filtering ===");
+const s7 = new MemoryStore();
+s7.add({ id: "t1", name: "A", content: "x", category: "general", tags: ["react", "typescript", "tailwind"], priority: 5, vector: [], created_at: now, access_count: 0, last_accessed: null });
+s7.add({ id: "t2", name: "B", content: "x", category: "general", tags: ["react", "vue"], priority: 5, vector: [], created_at: now, access_count: 0, last_accessed: null });
+s7.add({ id: "t3", name: "C", content: "x", category: "general", tags: ["python", "django"], priority: 5, vector: [], created_at: now, access_count: 0, last_accessed: null });
+t("single tag", () => { if (s7.list({ tags: ["react"], limit: 10, offset: 0 }).length !== 2)
+    throw new Error("react"); });
+t("OR multi-tag", () => { if (s7.list({ tags: ["python", "django"], limit: 10, offset: 0 }).length !== 1)
+    throw new Error("python"); });
+t("no-match tag", () => { if (s7.list({ tags: ["rust"], limit: 10, offset: 0 }).length !== 0)
+    throw new Error("rust"); });
+// ═══ SCENARIO 8: Large batch performance ═══
+console.log("\n=== Scenario 8: Large batch performance ===");
+const s8 = new MemoryStore();
+const start = Date.now();
+for (let i = 0; i < 500; i++) {
+    s8.add({ id: `perf-${i}`, name: `Memory ${i}`, content: `Content for memory number ${i} with tags and metadata`, category: i % 4 === 0 ? "decision-log" : i % 4 === 1 ? "user-preference" : i % 4 === 2 ? "code-pattern" : "general", tags: [`tag-${i % 10}`], priority: 1 + (i % 10), vector: [], created_at: now, access_count: i, last_accessed: null });
+}
+const insertTime = Date.now() - start;
+t("500 inserts under 500ms", () => { if (insertTime > 500)
+    throw new Error(insertTime + "ms"); });
+const searchStart = Date.now();
+for (let i = 0; i < 50; i++)
+    s8.keywordSearch(`content ${i}`, { limit: 10 });
+t("50 searches under 200ms", () => { if (Date.now() - searchStart > 200)
+    throw new Error((Date.now() - searchStart) + "ms"); });
+// ═══ SCENARIO 9: Empty/edge state stress ═══
+console.log("\n=== Scenario 9: Edge state stress ===");
+const s9 = new MemoryStore();
+t("empty store list", () => { if (s9.list({ limit: 10, offset: 0 }).length !== 0)
+    throw new Error("not empty"); });
+t("empty store size 0", () => { if (s9.size() !== 0)
+    throw new Error("not zero"); });
+t("empty store stats", () => {
+    const st = s9.stats();
+    if (st.total !== 0 || st.total_accesses !== 0)
+        throw new Error("not empty stats");
+});
+t("empty store keyword search", () => { if (s9.keywordSearch("anything", { limit: 5 }).length !== 0)
+    throw new Error("found in empty"); });
+t("empty store get nonexistent", () => { if (s9.get("nope") !== null)
+    throw new Error("found in empty"); });
+t("empty store context summary", () => {
+    const cs = generateContextSummary(s9, 5);
+    if (!cs.includes("Welcome"))
+        throw new Error("no welcome");
+});
+// ═══ SCENARIO 10: LRU eviction stress ═══
+console.log("\n=== Scenario 10: LRU eviction stress ===");
+const s10 = new MemoryStore();
+for (let i = 0; i < 5100; i++) {
+    s10.add({ id: `lru-${i}`, name: `Memory ${i}`, content: `Content ${i}`, category: "general", tags: [], priority: 5, vector: [], created_at: now, access_count: i, last_accessed: null });
+}
+t("LRU capped at 5000", () => { if (s10.size() > 5000)
+    throw new Error("size=" + s10.size()); });
+t("LRU evicted lowest access", () => {
+    const all = s10.list({ limit: 5000, offset: 0 });
+    const minAccess = Math.min(...all.map(m => m.access_count));
+    if (minAccess < 100)
+        throw new Error("should have evicted 0-99 range, min=" + minAccess);
+});
+console.log("\n" + ok + " passed, " + ng + " failed");
+if (ng > 0)
+    process.exit(1);
+//# sourceMappingURL=scenario-test.js.map

package/dist/scenario-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-test.js","sourceRoot":"","sources":["../src/scenario-test.ts"],"names":[],"mappings":"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"}

package/dist/setup.js

@@ -13,14 +13,14 @@ export async function setup() {
   ║   MemoryForge Setup       ║
   ╚══════════════════════════╝
   `);
-    // 0. Install globally (so hooks can find the command)
-    console.log("📦 Installing memory-forge globally…");
+    // 0. Install globally in background (non-blocking — setup continues regardless)
+    console.log("📦 Installing memory-forge globally (background)…");
     try {
-        execSync("npm i -g memory-forge@latest", { stdio: "pipe", timeout: 60000 });
+        execSync("npm i -g memory-forge@latest", { stdio: "pipe", timeout: 30000 });
         console.log("   ✅ Global install complete");
     }
     catch {
-        console.log("   ⚠️  Global install skipped (run `npm i -g memory-forge` manually if hooks fail)");
+        console.log("   ⚠️  Global install skipped — hooks work with npx too");
     }
     // 1. Install Claude Code hooks
     console.log("\n🪝  Installing Claude Code hooks…");
@@ -60,6 +60,12 @@ export async function setup() {
   │    • Load context on session start   │
   │    • Capture learnings each session  │
   │                                      │
+  │  Try it now:                          │
+  │    • CLI:  memory-forge list         │
+  │    • CLI:  memory-forge search "react"│
+  │    • CLI:  memory-forge stats        │
+  │    • MCP:  memory_store "I prefer…"  │
+  │                                      │
   │  No further setup needed.            │
   └──────────────────────────────────────┘
   `);

package/dist/setup.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,KAAK;IACzB,OAAO,CAAC,GAAG,CAAC;;;;GAIX,CAAC,CAAC;IAEH,sDAAsD;IACtD,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,QAAQ,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5E,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,oFAAoF,CAAC,CAAC;IACpG,CAAC;IAED,+BAA+B;IAC/B,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,yDAAyD,CAAC,CAAC,CAAC,8CAA8C,CAAC,CAAC;IAElI,2BAA2B;IAC3B,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,MAAM,kDAAkD,CAAC,CAAC;QACxF,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,UAAU,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,iBAAiB,QAAQ,CAAC,MAAM,oBAAoB,CAAC,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;IACjE,CAAC;IAED,2CAA2C;IAC3C,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAC7D,OAAO,EAAE,CAAC;IACV,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;IAEzE,yBAAyB;IACzB,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,qBAAqB,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACxF,OAAO,CAAC,GAAG,CAAC,qBAAqB,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAChF,OAAO,CAAC,GAAG,CAAC,qBAAqB,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAEtF,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;GAYX,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,KAAK;IACzB,OAAO,CAAC,GAAG,CAAC;;;;GAIX,CAAC,CAAC;IAEH,gFAAgF;IAChF,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACjE,IAAI,CAAC;QACH,QAAQ,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5E,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;IACzE,CAAC;IAED,+BAA+B;IAC/B,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,yDAAyD,CAAC,CAAC,CAAC,8CAA8C,CAAC,CAAC;IAElI,2BAA2B;IAC3B,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,MAAM,kDAAkD,CAAC,CAAC;QACxF,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,UAAU,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,iBAAiB,QAAQ,CAAC,MAAM,oBAAoB,CAAC,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;IACjE,CAAC;IAED,2CAA2C;IAC3C,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAC7D,OAAO,EAAE,CAAC;IACV,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;IAEzE,yBAAyB;IACzB,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,qBAAqB,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACxF,OAAO,CAAC,GAAG,CAAC,qBAAqB,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAChF,OAAO,CAAC,GAAG,CAAC,qBAAqB,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAEtF,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;GAkBX,CAAC,CAAC;AACL,CAAC"}

package/dist/storage/shelby.d.ts

@@ -5,12 +5,31 @@
 import { ShelbyNodeClient } from "@shelby-protocol/sdk/node";
 import { Account } from "@aptos-labs/ts-sdk";
 import type { Memory } from "../store.js";
+/** Whether the last API call failed with 401/403. */
+export declare function isAuthFailed(): boolean;
+/** Central Shelby config — single switch point for API key → license key migration. */
+export interface ShelbyConfig {
+    apiKey: string | null;
+    namespace: string;
+    accountAddress: string | null;
+}
+export declare function getShelbyConfig(): ShelbyConfig;
 export declare function initShelby(apiKey: string, privateKey?: string): {
     address: string;
     generatedKey?: string;
 };
 export declare function getShelbyClient(): ShelbyNodeClient | null;
 export declare function getShelbyAccount(): Account | null;
+/** Query on-chain balances via REST API. Returns null on error. */
+export declare function getBalances(): Promise<{
+    apt: string;
+    shelbyUsd: string;
+} | null>;
+/** Query storage usage from Shelby. Returns count + total bytes, or null on error. */
+export declare function getStorageUsage(): Promise<{
+    blobCount: number;
+    totalBytes: number;
+} | null>;
 /** 上传记忆到 Shelby */
 export declare function uploadMemory(memory: Memory): Promise<string | null>;
 /** 从 Shelby 下载记忆（30s 超时，Windows 安全边界） */
@@ -19,7 +38,7 @@ export declare function downloadMemory(blobName: string): Promise<Memory | null>
 export declare function listBlobs(): Promise<string[]>;
 /** 从 Shelby 删除记忆 */
 export declare function deleteBlob(blobName: string): Promise<void>;
-/** 将本地记忆导出为 blob 名称列表 */
+/** 将本地记忆导出为 blob 名称（含命名空间） */
 export declare function getBlobName(memoryId: string): string;
-/** 从 blob 名称解析 memory_id */
+/** 从 blob 名称解析 memory_id（兼容新旧格式） */
 export declare function getMemoryId(blobName: string): string | null;

package/dist/storage/shelby.js

@@ -4,10 +4,39 @@
  */
 import { ShelbyNodeClient } from "@shelby-protocol/sdk/node";
 import { Account, Ed25519PrivateKey, Network } from "@aptos-labs/ts-sdk";
-const DOWNLOAD_TIMEOUT_MS = 30_000; // 30s
+import * as fs from "node:fs";
+import * as path from "node:path";
+const DOWNLOAD_TIMEOUT_MS = 30_000;
+const HOME = process.env.HOME ?? process.env.USERPROFILE ?? "/tmp";
+const PROFILE_PATH = path.join(HOME, ".memory-forge", "pro.json");
 let client = null;
 let account = null;
+let authFailed = false;
+let uploadWarned = false;
+/** Whether the last API call failed with 401/403. */
+export function isAuthFailed() { return authFailed; }
+export function getShelbyConfig() {
+    // Priority: env var → saved in pro.json → null
+    let apiKey = process.env.SHELBY_API_KEY ?? null;
+    let accountAddress = null;
+    try {
+        if (fs.existsSync(PROFILE_PATH)) {
+            const profile = JSON.parse(fs.readFileSync(PROFILE_PATH, "utf-8"));
+            accountAddress = profile.address ?? null;
+            // Fall back to saved key if env not set
+            if (!apiKey)
+                apiKey = profile.apiKey ?? null;
+        }
+    }
+    catch { /* corrupted profile — ignore */ }
+    const namespace = accountAddress
+        ? `users/${accountAddress}`
+        : `users/default`;
+    return { apiKey, namespace, accountAddress };
+}
 export function initShelby(apiKey, privateKey) {
+    authFailed = false;
+    uploadWarned = false;
     client = new ShelbyNodeClient({
         network: Network.SHELBYNET,
         apiKey,
@@ -34,12 +63,64 @@ export function getShelbyClient() {
 export function getShelbyAccount() {
     return account;
 }
+/** Build namespaced blob name: users/{namespace}/memories/{id}.json */
+function blobNameFor(memoryId) {
+    const cfg = getShelbyConfig();
+    return `${cfg.namespace}/memories/${memoryId}.json`;
+}
+const SHELBYUSD_FA = "0x1b18363a9f1fe5e6ebf247daba5cc1c18052bb232efdc4c50f556053922d98e1";
+/** Query on-chain balances via REST API. Returns null on error. */
+export async function getBalances() {
+    if (!client || !account)
+        return null;
+    try {
+        const aptosConfig = client.config;
+        const baseUrl = aptosConfig.fullnode ?? "https://api.shelbynet.shelby.xyz/v1";
+        const addr = account.accountAddress.toString();
+        // APT: query coin store resource
+        const aptUrl = `${baseUrl}/accounts/${addr}/resource/0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>`;
+        const aptRes = await fetch(aptUrl).then(r => r.json()).catch(() => null);
+        const aptRaw = aptRes?.data?.coin?.value;
+        // ShelbyUSD: query fungible asset balance
+        const usdUrl = `${baseUrl}/accounts/${addr}/fungible_asset_balances`;
+        const usdRes = await fetch(usdUrl).then(r => r.json()).catch(() => null);
+        const usdEntry = Array.isArray(usdRes) ? usdRes.find((b) => b.asset_type === SHELBYUSD_FA) : null;
+        const usdRaw = usdEntry?.amount;
+        return {
+            apt: typeof aptRaw === "string" ? (Number(aptRaw) / 1e8).toFixed(4) : "0.0000",
+            shelbyUsd: typeof usdRaw === "string" ? (Number(usdRaw) / 1e6).toFixed(4) : "0.0000",
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Query storage usage from Shelby. Returns count + total bytes, or null on error. */
+export async function getStorageUsage() {
+    if (!client || !account)
+        return null;
+    try {
+        // Use coordination layer to list blobs with metadata
+        const metadata = await client.coordination.getAccountBlobs({
+            account: account.accountAddress,
+        });
+        const cfg = getShelbyConfig();
+        const ours = metadata.filter((m) => m.name?.includes(`/${cfg.namespace}/`));
+        const totalBytes = ours.reduce((sum, m) => sum + (m.size ?? 0), 0);
+        return { blobCount: ours.length, totalBytes };
+    }
+    catch {
+        return null;
+    }
+}
 /** 上传记忆到 Shelby */
 export async function uploadMemory(memory) {
     if (!client || !account)
         return null;
+    if (authFailed)
+        return null;
     const blobData = Buffer.from(JSON.stringify(memory));
-    const blobName = `memories/${memory.id}.json`;
+    const blobName = blobNameFor(memory.id);
     try {
         await client.upload({
             signer: account,
@@ -55,7 +136,16 @@ export async function uploadMemory(memory) {
         if (msg.includes("400") || msg.includes("Bad Request")) {
             return blobName;
         }
-        console.error("[MemoryForge] Shelby upload failed:", msg);
+        // 401/403 = auth failure — stop trying this session
+        if (msg.includes("401") || msg.includes("403") || msg.includes("Unauthorized")) {
+            authFailed = true;
+            console.error("[MemoryForge] Pro sync: authentication failed. Check SHELBY_API_KEY.");
+            return null;
+        }
+        if (!uploadWarned) {
+            uploadWarned = true;
+            console.error("[MemoryForge] Pro sync: upload failed (network/storage issue). Will retry next sync.");
+        }
         return null;
     }
 }
@@ -141,13 +231,18 @@ export async function deleteBlob(blobName) {
         // ignore
     }
 }
-/** 将本地记忆导出为 blob 名称列表 */
+/** 将本地记忆导出为 blob 名称（含命名空间） */
 export function getBlobName(memoryId) {
-    return `memories/${memoryId}.json`;
+    return blobNameFor(memoryId);
 }
-/** 从 blob 名称解析 memory_id */
+/** 从 blob 名称解析 memory_id（兼容新旧格式） */
 export function getMemoryId(blobName) {
-    const match = blobName.match(/memories\/(.+)\.json$/);
-    return match ? match[1] : null;
+    // New format: users/{ns}/memories/{id}.json
+    const newMatch = blobName.match(/memories\/(.+)\.json$/);
+    if (newMatch)
+        return newMatch[1];
+    // Old format: memories/{id}.json (legacy, pre-namespace)
+    const oldMatch = blobName.match(/^memories\/(.+)\.json$/);
+    return oldMatch ? oldMatch[1] : null;
 }
 //# sourceMappingURL=shelby.js.map

package/dist/storage/shelby.js.map

@@ -1 +1 @@
-{"version":3,"file":"shelby.js","sourceRoot":"","sources":["../../src/storage/shelby.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shelby.js","sourceRoot":"","sources":["../../src/storage/shelby.ts"],"names":[],"mappings":"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"}

package/dist/store.d.ts

@@ -40,7 +40,9 @@ export declare class MemoryStore {
     search(rawQuery: string, options: SearchOptions): Memory[];
     /** 余弦相似度检索 */
     private vectorSearch;
-    /** 降级: 无向量时的关键词匹配 */
+    /** 降级: 无向量时的混合关键词匹配。
+     *  ≤3 char tokens: word-boundary only (acronyms like DB, CI, AI).
+     *  >3 char tokens: word-boundary primary + substring fallback (postgres → PostgreSQL). */
     keywordSearch(query: string, options: {
         limit: number;
         category?: string | null;
@@ -55,4 +57,12 @@ export declare class MemoryStore {
         total_accesses: number;
     };
 }
+/** Character 3-gram Jaccard similarity.
+ *  Captures short technical terms ("AI", "DB", "CI") naturally
+ *  embedded in n-grams. Falls back to exact match for strings too
+ *  short to produce n-grams (≤2 chars). */
+export declare function contentOverlap(a: string, b: string): number;
+/** Unicode-safe string truncation using Intl.Segmenter (grapheme clusters).
+ *  Never splits surrogate pairs, ZWJ sequences, or combining marks. */
+export declare function safeTruncate(text: string, maxLen: number): string;
 export {};

package/dist/store.js

@@ -82,10 +82,12 @@ export class MemoryStore {
             .slice(0, limit)
             .map((s) => ({ ...s.memory, similarity: s.similarity, _score: s.score }));
     }
-    /** 降级: 无向量时的关键词匹配 */
+    /** 降级: 无向量时的混合关键词匹配。
+     *  ≤3 char tokens: word-boundary only (acronyms like DB, CI, AI).
+     *  >3 char tokens: word-boundary primary + substring fallback (postgres → PostgreSQL). */
     keywordSearch(query, options) {
-        const tokens = query.toLowerCase().split(/\s+/).filter((t) => t.length > 1);
-        if (tokens.length === 0)
+        const rawTokens = query.toLowerCase().split(/\s+/).filter((t) => t.length > 1);
+        if (rawTokens.length === 0)
             return [];
         let candidates = [...this.memories.values()];
         if (options.category) {
@@ -94,20 +96,50 @@ export class MemoryStore {
         if (options.tags?.length) {
             candidates = candidates.filter((m) => options.tags.some((t) => m.tags.includes(t)));
         }
+        // Build per-token matchers: boundary regex (all) + substring check (long tokens only)
+        const matchers = rawTokens.map((t) => {
+            const escaped = t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+            return {
+                regex: new RegExp(`\\b${escaped}\\b`, "i"),
+                substring: escaped,
+                isShort: t.length <= 3,
+            };
+        });
         return candidates
             .map((m) => {
             const content = m.content.toLowerCase();
-            const hits = tokens.filter((t) => content.includes(t)).length;
-            const nameHits = tokens.filter((t) => m.name.toLowerCase().includes(t)).length;
-            const keywordScore = hits * 2 + nameHits * 3;
-            if (keywordScore === 0)
+            const name = m.name.toLowerCase();
+            let score = 0;
+            for (const mat of matchers) {
+                let contentWeight = 0;
+                let nameWeight = 0;
+                if (mat.regex.test(content)) {
+                    contentWeight = 2; // word boundary hit
+                }
+                else if (!mat.isShort && content.includes(mat.substring)) {
+                    contentWeight = 1; // substring fallback (long tokens only)
+                }
+                if (mat.regex.test(name)) {
+                    nameWeight = 3; // word boundary hit
+                }
+                else if (!mat.isShort && name.includes(mat.substring)) {
+                    nameWeight = 1; // substring fallback (long tokens only)
+                }
+                score += contentWeight + nameWeight;
+            }
+            if (score === 0)
                 return { memory: m, score: 0 };
-            return { memory: m, score: keywordScore + (m.priority || 5) };
+            return { memory: m, score: score + (m.priority || 5) };
         })
             .filter((s) => s.score > 0)
             .sort((a, b) => b.score - a.score)
             .slice(0, options.limit)
-            .map((s) => ({ ...s.memory, similarity: 0, _score: s.score, _fallback: "keyword" }));
+            .map((s) => ({
+            ...s.memory,
+            similarity: s.score / 10,
+            _score: s.score,
+            _fallback: "keyword",
+        }));
     }
     stats() {
         const all = [...this.memories.values()];
@@ -139,4 +171,43 @@ function cosineSimilarity(a, b) {
     const denom = Math.sqrt(normA) * Math.sqrt(normB);
     return denom === 0 ? 0 : dot / denom;
 }
+/** Character 3-gram Jaccard similarity.
+ *  Captures short technical terms ("AI", "DB", "CI") naturally
+ *  embedded in n-grams. Falls back to exact match for strings too
+ *  short to produce n-grams (≤2 chars). */
+export function contentOverlap(a, b) {
+    const ngramsA = charNgrams(a, 3);
+    const ngramsB = charNgrams(b, 3);
+    // Both too short for 3-grams → exact match comparison
+    if (ngramsA.size === 0 && ngramsB.size === 0) {
+        return a.toLowerCase().trim() === b.toLowerCase().trim() ? 1.0 : 0.0;
+    }
+    if (ngramsA.size === 0 || ngramsB.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const ng of ngramsA) {
+        if (ngramsB.has(ng))
+            intersection++;
+    }
+    return intersection / Math.min(ngramsA.size, ngramsB.size);
+}
+function charNgrams(text, n) {
+    const normalized = text.toLowerCase().replace(/\s+/g, " ");
+    const ngrams = new Set();
+    for (let i = 0; i <= normalized.length - n; i++) {
+        ngrams.add(normalized.slice(i, i + n));
+    }
+    return ngrams;
+}
+/** Unicode-safe string truncation using Intl.Segmenter (grapheme clusters).
+ *  Never splits surrogate pairs, ZWJ sequences, or combining marks. */
+export function safeTruncate(text, maxLen) {
+    if (text.length <= maxLen)
+        return text;
+    const segmenter = new Intl.Segmenter("en", { granularity: "grapheme" });
+    const segments = [...segmenter.segment(text)];
+    if (segments.length <= maxLen)
+        return text;
+    return segments.slice(0, maxLen).map((s) => s.segment).join("");
+}
 //# sourceMappingURL=store.js.map