agent-working-memory 0.15.7 → 0.15.9

package/src/adapters/cursor.ts

@@ -54,7 +54,7 @@ const adapter: CLIAdapter = {
 
     if (skip) return '.cursorrules: skipped (--no-instructions)';
 
-    return upsertAwmSection(rulesPath, AWM_INSTRUCTION_CONTENT, { titleIfNew: '# Agent Working Memory' });
+    return upsertAwmSection(rulesPath, AWM_INSTRUCTION_CONTENT, { titleIfNew: '# Agent Working Memory', force: ctx.forceInstructions });
   },
 
   writeHooks(_ctx: SetupContext, _skip: boolean): string {

package/src/adapters/http.ts

@@ -56,6 +56,7 @@ const adapter: CLIAdapter = {
     return upsertAwmSection(instrPath, AWM_INSTRUCTION_CONTENT, {
       titleIfNew: '# Agent Working Memory',
       suffix: HTTP_ADDENDUM,
+      force: ctx.forceInstructions,
     });
   },
 

package/src/adapters/types.ts

@@ -9,8 +9,8 @@
  * the selected adapter.
  */
 
-export interface SetupContext {
-  /** Set when setup moved a store out of the installed package. The old file is left in place. */
+export interface SetupContext {
+  /** Set when setup moved a store out of the installed package. The old file is left in place. */
   rescuedDbFrom?: string | null;
   /** Current working directory */
   cwd: string;
@@ -36,6 +36,12 @@ export interface SetupContext {
   hookPortRange: string;
   /** Install the UserPromptSubmit prime hook (0.14.6; `--no-prime` turns it off) */
   installPrime: boolean;
+  /**
+   * Replace a legacy, unmarked AWM instruction section instead of backing it up and
+   * refusing (`--force`). Off by default: an unmarked section cannot be told apart from
+   * the user's own notes, and replacing one measured 169 of 381 lines lost on a real install.
+   */
+  forceInstructions: boolean;
   /** Whether to use global scope */
   isGlobal: boolean;
   /** Windows platform */

package/src/cli.ts

@@ -76,6 +76,9 @@ Setup options:
   --no-claude-md      Alias for --no-instructions
   --no-hooks          Skip hook installation
   --no-prime          Skip the UserPromptSubmit prime hook (auto-inject memories per prompt)
+  --force             Replace a legacy instruction section that has no generated markers.
+                      Without it setup backs the file up and refuses, because your own
+                      notes inside that section cannot be told apart from generated text.
   --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.
@@ -100,6 +103,7 @@ async function setup() {
   let isGlobal = false;
   let skipHooks = false;
   let installPrime = true;
+  let forceInstructions = false;
   let hookPort: string | undefined;
   let hookPortRange: string | undefined;
 
@@ -114,6 +118,8 @@ async function setup() {
       skipHooks = true;
     } else if (args[i] === '--no-prime') {
       installPrime = false;
+    } else if (args[i] === '--force') {
+      forceInstructions = true;
     } else if (args[i] === '--hook-port' && args[i + 1]) {
       hookPort = args[++i];
     } else if (args[i] === '--hook-port-range' && args[i + 1]) {
@@ -147,7 +153,7 @@ async function setup() {
   // (0.14.6) — an upgrade must never repoint the database or rename the agent.
   const existingEnv = adapter.readExistingEnv?.(isGlobal, process.cwd()) ?? null;
   // `awm setup claude-code` -> client=claude-code, cursor -> client=cursor, and so on.
-  const ctx = buildSetupContext({ agentId, dbPath, isGlobal, hookPort, hookPortRange, installPrime, existingEnv, client: target });
+  const ctx = buildSetupContext({ agentId, dbPath, isGlobal, hookPort, hookPortRange, installPrime, forceInstructions, existingEnv, client: target });
 
   // Run adapter
   const configAction = adapter.writeMcpConfig(ctx);

package/src/core/write-pipeline.ts

@@ -288,6 +288,24 @@ export async function performWrite(
                 && superseder.supersededBy == null) {
               result = await reinforceMatched(store, superseder, noveltyResult, salience, input.content, input.concept);
             }
+          } else if (matched.stage === 'archived' && matched.supersededBy == null && !matched.retracted) {
+            // R1b (2026-09-22 fix, evidence in tests/core/reinforcement-floor-bug.test.ts
+            // and real production data from the /freshdesk-support hourly sweep "family of
+            // stubs" incident): a same-concept match that consolidation's Phase 6.5
+            // redundancy-prune archived (it archives a "loser" near-duplicate WITHOUT
+            // merging its confidence into a survivor — see engine/consolidation.ts) is
+            // still the same fact being restated. A fresh matching write is exactly the
+            // "repeat" signal R1 exists to act on. Without this branch an archived match
+            // is a permanent dead end: isHealthy above requires stage==='active', so it can
+            // never be reinforced again, and it isn't superseded either — every later
+            // matching write fell through to create() forever, producing an
+            // ever-growing, never-consolidating family of near-duplicate archived stubs
+            // that still rank in recall (archived != excluded from search) and crowd out
+            // the genuinely current one. REVIVE it: reinforce as usual, then flip it back
+            // to active so it behaves like any other reinforced engram going forward.
+            result = await reinforceMatched(store, matched, noveltyResult, salience, input.content, input.concept);
+            await store.updateStage(matched.id, 'active');
+            result.engram.stage = 'active';
           }
         }
       }
@@ -491,24 +509,24 @@ async function createNewEngram(
 
   const tags = [...(input.tags ?? [])];
   if (isLowSalience && !tags.includes('low-salience')) tags.push('low-salience');
-
-  // Which CLIENT wrote this: `client=claude-code`, `client=claude-desktop`, `client=cursor`.
-  //
-  // Deliberately not called `surface`: memory_whoami already reports a `surface` field
-  // meaning the TRANSPORT (mcp | http), and one word for two concepts is how you lose an
-  // hour six months from now. Transport is how the request arrived; client is which
-  // application it arrived from.
-  // AWM_CLIENT is set by the thing that launches the server (the Claude Code plugin, the
-  // Desktop extension, `awm setup`), never by the caller, so it records where a memory came
-  // from rather than what the writer claims.
-  //
-  // Captured by default rather than behind a flag, because provenance is one-way: a tag can
-  // be ignored or stripped later, but the origin of a memory written without one is gone for
-  // good. An explicit `client=` in the caller's tags always wins.
-  const client = (process.env.AWM_CLIENT ?? '').trim();
-  if (client && !tags.some(t => t.toLowerCase().startsWith('client='))) {
-    tags.push(`client=${client}`);
-  }
+
+  // Which CLIENT wrote this: `client=claude-code`, `client=claude-desktop`, `client=cursor`.
+  //
+  // Deliberately not called `surface`: memory_whoami already reports a `surface` field
+  // meaning the TRANSPORT (mcp | http), and one word for two concepts is how you lose an
+  // hour six months from now. Transport is how the request arrived; client is which
+  // application it arrived from.
+  // AWM_CLIENT is set by the thing that launches the server (the Claude Code plugin, the
+  // Desktop extension, `awm setup`), never by the caller, so it records where a memory came
+  // from rather than what the writer claims.
+  //
+  // Captured by default rather than behind a flag, because provenance is one-way: a tag can
+  // be ignored or stripped later, but the origin of a memory written without one is gone for
+  // good. An explicit `client=` in the caller's tags always wins.
+  const client = (process.env.AWM_CLIENT ?? '').trim();
+  if (client && !tags.some(t => t.toLowerCase().startsWith('client='))) {
+    tags.push(`client=${client}`);
+  }
 
   // Auto-tag meta-tags (default-OFF, AWM_AUTOTAG=1). extractMetaTags emits
   // `entity:<ProperNoun>` and `cat:<category>` tags from concept+content. These