agent-working-memory 0.15.6 → 0.15.7

package/README.md

@@ -171,10 +171,11 @@ compatible, and the store is the same SQLite file before and after.
 
 ---
 
-## What's new — v0.15.6
+## What's new — v0.15.7
 
 | | |
 |---|---|
+| **0.15.6–7** | **Data-loss fix.** The default store used to sit inside the installed npm package, where `npm install -g` deletes it on upgrade. It is now `~/.awm/memory.db`; re-running `awm setup` copies an affected store to safety and `awm doctor` fails on it. 0.15.7 corrects the docs that still taught the old location |
 | **0.15.x** | Runs as a **Claude Code plugin** and a **Claude Desktop extension**, both sharing one store with the CLI. Installs from npm with no GitHub access — `awm plugin` prints the two lines to paste. Every write now records which client produced it (`client=claude-code`) |
 | **0.14.6** | `awm setup` caught up with four releases of engine changes it had silently fallen behind. Added the release checks that now block on that kind of drift |
 | **0.14.5** | Benchmark instrument corrected: the eval had been querying as the wrong agent, so a product feature scored as a ranking failure. The real identifier baseline is **92.7%**, not 68% |
@@ -283,18 +284,18 @@ local ONNX via `@huggingface/transformers` — bge-small-en-v1.5 embeddings, ms-
 flan-t5-small expansion. Node 22+.
 
 ```bash
-npx vitest run          # 781 tests
+npx vitest run          # 789 tests
 npm run bench           # benchmark suites
 npm run build:plugin    # regenerate the Claude Code plugin from src/
 npm run test:docker     # clean-room install of the packed tarball
-npm run test:linux      # build + full suite on Linux (781/781)
+npm run test:linux      # build + full suite on Linux (789/789)
 ```
 
 ---
 
 ## Status
 
-Active development, v0.15.6. Core retrieval, consolidation, MCP integration, hooks, task
+Active development, v0.15.7. Core retrieval, consolidation, MCP integration, hooks, task
 management, and the HTTP API are stable and in daily production use. PGlite backend stable;
 networked Postgres experimental.
 

package/dist/cli.js

@@ -39,50 +39,50 @@ catch { /* No .env file */ }
 const args = process.argv.slice(2);
 const command = args[0];
 function printUsage() {
-    console.log(`
-AgentWorkingMemory — Cognitive memory for AI agents
-
-Usage:
-  awm setup [target] [options]                      Configure AWM for an AI CLI
+    console.log(`
+AgentWorkingMemory — Cognitive memory for AI agents
+
+Usage:
+  awm setup [target] [options]                      Configure AWM for an AI CLI
   awm plugin                                        Install as a Claude Code plugin (local, no GitHub)
-  awm doctor [target|--all]                         Validate AWM integrations
-  awm mcp                                           Start MCP server (stdio)
-  awm serve [--port <port>]                         Start HTTP API server
-  awm health [--port <port>]                        Check server health
-  awm export --db <path> [--agent <id>] [--output <file>] [--active-only]
-                                                    Export memories to JSON
-  awm import <file> --db <path> [--remap-agent <id>] [--dedupe] [--dry-run]
-                                                    Import memories from JSON
-  awm merge --target <db> --source <db> [--source ...]
-            [--remap uuid=name] [--remap-all-uuids <name>]
-            [--dedupe] [--dry-run]                  Merge multiple memory DBs
-  awm migrate --from <sqlite.db> --to <pglite-dir> [--dry-run] [--verbose]
-                                                    Migrate SQLite DB to PGlite
-
-Setup targets:
-  claude-code (default)   .mcp.json + CLAUDE.md + hooks
-  codex                   ~/.codex/config.toml + AGENTS.md
-  cursor                  .cursor/mcp.json + .cursorrules
-  http                    Connection info for HTTP API
-
-Setup options:
-  --global            Use global scope (recommended for claude-code)
-  --agent-id <id>     Agent identifier (default: project name)
-  --db-path <path>    Database path (default: <awm>/data/memory.db)
-  --no-instructions   Skip instruction file (CLAUDE.md, AGENTS.md, etc.)
-  --no-claude-md      Alias for --no-instructions
-  --no-hooks          Skip hook installation
-  --no-prime          Skip the UserPromptSubmit prime hook (auto-inject memories per prompt)
-  --hook-port PORT    Preferred sidecar port (default: 8401; each session walks upward when busy)
-  --hook-port-range N Ports to try upward from --hook-port (default: 10)
-  Re-running setup keeps your existing agent id, db path, port and any env you added.
-
-Examples:
-  awm setup --global              Claude Code, global (recommended)
-  awm setup codex                 Codex CLI
-  awm setup cursor                Cursor IDE
-  awm setup http                  Generic HTTP integration
-  awm doctor --all                Check all configured targets
+  awm doctor [target|--all]                         Validate AWM integrations
+  awm mcp                                           Start MCP server (stdio)
+  awm serve [--port <port>]                         Start HTTP API server
+  awm health [--port <port>]                        Check server health
+  awm export --db <path> [--agent <id>] [--output <file>] [--active-only]
+                                                    Export memories to JSON
+  awm import <file> --db <path> [--remap-agent <id>] [--dedupe] [--dry-run]
+                                                    Import memories from JSON
+  awm merge --target <db> --source <db> [--source ...]
+            [--remap uuid=name] [--remap-all-uuids <name>]
+            [--dedupe] [--dry-run]                  Merge multiple memory DBs
+  awm migrate --from <sqlite.db> --to <pglite-dir> [--dry-run] [--verbose]
+                                                    Migrate SQLite DB to PGlite
+
+Setup targets:
+  claude-code (default)   .mcp.json + CLAUDE.md + hooks
+  codex                   ~/.codex/config.toml + AGENTS.md
+  cursor                  .cursor/mcp.json + .cursorrules
+  http                    Connection info for HTTP API
+
+Setup options:
+  --global            Use global scope (recommended for claude-code)
+  --agent-id <id>     Agent identifier (default: project name)
+  --db-path <path>    Database path (default: ~/.awm/memory.db)
+  --no-instructions   Skip instruction file (CLAUDE.md, AGENTS.md, etc.)
+  --no-claude-md      Alias for --no-instructions
+  --no-hooks          Skip hook installation
+  --no-prime          Skip the UserPromptSubmit prime hook (auto-inject memories per prompt)
+  --hook-port PORT    Preferred sidecar port (default: 8401; each session walks upward when busy)
+  --hook-port-range N Ports to try upward from --hook-port (default: 10)
+  Re-running setup keeps your existing agent id, db path, port and any env you added.
+
+Examples:
+  awm setup --global              Claude Code, global (recommended)
+  awm setup codex                 Codex CLI
+  awm setup cursor                Cursor IDE
+  awm setup http                  Generic HTTP integration
+  awm doctor --all                Check all configured targets
 `.trim());
 }
 // ─── SETUP ──────────────────────────────────────
@@ -169,20 +169,20 @@ async function setup() {
      The file was COPIED, not moved: the original is still there if you want to check it.
      Once you are satisfied, the old copy can be deleted.`);
     }
-    console.log(`
-AWM configured for ${adapter.name}${isGlobal ? ' (global)' : ''}
-
-  Agent ID:    ${ctx.agentId}
-  DB path:     ${ctx.dbPath}
-  ${configAction}
-  ${instructionsAction}
-  ${hooksAction}
-  ${skillAction}
-
-Next steps:
-  1. Restart ${adapter.name} to pick up the MCP server
-  2. Memory tools will appear automatically${adapter.id === 'codex' ? ' (verify with /mcp)' : ''}
-  3. \`awm doctor\` checks the install and lists the live sidecars
+    console.log(`
+AWM configured for ${adapter.name}${isGlobal ? ' (global)' : ''}
+
+  Agent ID:    ${ctx.agentId}
+  DB path:     ${ctx.dbPath}
+  ${configAction}
+  ${instructionsAction}
+  ${hooksAction}
+  ${skillAction}
+
+Next steps:
+  1. Restart ${adapter.name} to pick up the MCP server
+  2. Memory tools will appear automatically${adapter.id === 'codex' ? ' (verify with /mcp)' : ''}
+  3. \`awm doctor\` checks the install and lists the live sidecars
 `.trim());
 }
 // ─── PLUGIN ──────────────────────────────────────
@@ -683,10 +683,10 @@ async function mergeMemories() {
             existingHashes.add(contentHash(row.concept, row.content));
         console.log(`Target has ${existingHashes.size} unique memories (for dedupe)\n`);
     }
-    const insertAssoc = targetDb.prepare(`
-    INSERT OR IGNORE INTO associations (id, from_engram_id, to_engram_id, weight, confidence, type,
-      activation_count, created_at, last_activated)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+    const insertAssoc = targetDb.prepare(`
+    INSERT OR IGNORE INTO associations (id, from_engram_id, to_engram_id, weight, confidence, type,
+      activation_count, created_at, last_activated)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
   `);
     let totalMemories = 0, totalAssociations = 0, totalSkipped = 0;
     try {
@@ -899,19 +899,19 @@ function onboardCmd() {
     if (!agentId)
         agentId = project;
     const { packPath, reviewPath, count } = runOnboard({ docs, repo, project, agentId, purpose, outDir });
-    console.log(`
-AWM onboard — warm-start pack for "${project}"
-
-  Scanned:   ${docs.join(', ')}${repo ? `  (+repo ${repo})` : ''}
-  Extracted: ${count} candidate memories (agent: ${agentId})
-
-  Review:    ${reviewPath}
-  Pack:      ${packPath}
-
-Next:
-  1. Edit the review file / pack as needed (delete noise, answer the interview questions).
-  2. Load it:  awm import ${packPath} --db <path> --dedupe
-     (embeddings backfill on the first consolidation — recall is warm immediately after)
+    console.log(`
+AWM onboard — warm-start pack for "${project}"
+
+  Scanned:   ${docs.join(', ')}${repo ? `  (+repo ${repo})` : ''}
+  Extracted: ${count} candidate memories (agent: ${agentId})
+
+  Review:    ${reviewPath}
+  Pack:      ${packPath}
+
+Next:
+  1. Edit the review file / pack as needed (delete noise, answer the interview questions).
+  2. Load it:  awm import ${packPath} --db <path> --dedupe
+     (embeddings backfill on the first consolidation — recall is warm immediately after)
 `.trimEnd());
 }
 // ─── Dispatch ──────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-working-memory",
-  "version": "0.15.6",
+  "version": "0.15.7",
   "description": "Persistent, local-first memory for AI agents. Selective by design: filters what's worth keeping, links what's related, and says nothing when it doesn't know. SQLite + ONNX, no cloud, no API keys.",
   "keywords": [
     "ai-agents",

package/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "awm",
   "displayName": "Agent Working Memory",
-  "version": "0.15.6",
+  "version": "0.15.7",
   "description": "Persistent, local-first memory for AI agents. Selective by design: filters what's worth keeping, links what's related, and says nothing when it doesn't know. SQLite + ONNX, no cloud, no API keys.",
   "author": {
     "name": "Robert Winter"

package/plugin/README.md

@@ -22,7 +22,7 @@ The launcher defaults `AWM_DB_PATH` to `~/.awm/memory.db` — **the same file
 than quietly starting an empty one. Set `AWM_DB_PATH` yourself to override.
 
 It prefers an installed copy of the package (global, or a local `node_modules`) and falls
-back to `npx -p agent-working-memory@0.15.6`. The npx path rebuilds
+back to `npx -p agent-working-memory@0.15.7`. The npx path rebuilds
 `better-sqlite3` on a cold cache, which is slow enough to look like a hang, so a real
 install is worth having:
 

package/plugin/bin/awm-mcp-launcher.cjs

@@ -6,7 +6,7 @@
 //
 // This is a REAL source file, not a string inside the generator, because it is real code:
 // it gets syntax-checked, linted and tested like everything else. `npm run build:plugin`
-// copies it to plugin/bin/ and substitutes 0.15.6.
+// copies it to plugin/bin/ and substitutes 0.15.7.
 //
 // Two jobs a bare `mcpServers` entry in plugin.json cannot do:
 //
@@ -95,7 +95,7 @@ if (found) {
   const isWin = process.platform === 'win32';
   const child = spawn(
     isWin ? 'npx.cmd' : 'npx',
-    ['-y', '-p', 'agent-working-memory@0.15.6', 'awm', 'mcp'],
+    ['-y', '-p', 'agent-working-memory@0.15.7', 'awm', 'mcp'],
     { stdio: 'inherit', env: process.env, shell: isWin }
   );
   child.on('error', (e) => {

package/plugin/skills/awm-memory/SKILL.md

@@ -10,7 +10,7 @@ description: >-
 
 # Agent Working Memory
 
-Generated from `src/adapters/common.ts` (AWM v0.15.6) — the same guidance
+Generated from `src/adapters/common.ts` (AWM v0.15.7) — the same guidance
 `awm setup` writes into CLAUDE.md. Do not edit here; edit the source and re-run
 `npm run build:plugin`.