specmem-hardwicksoftware 3.7.33 → 3.7.35

package/CHANGELOG.md

@@ -4,6 +4,38 @@ All notable changes to SpecMem - we keep it real with semantic versioning. Deada
 
 ---
 
+## [3.7.34] - 2026-02-26
+
+### Fixed
+- System reminder dedup bug — `String.replace(string, '')` only removes first occurrence; duplicate identical reminders in same message block now fully nuked via `while(includes)` loop
+- Edit tool stripping bug — `smartStripEdit(block)` was passing the whole tool_use block instead of `block.input`, causing null return and no stripping of Edit payloads in old messages
+
+---
+
+## [3.7.33] - 2026-02-26
+
+### Fixed
+- Token compaction proxy reliability — resolved connection drops and socket failures under sustained load
+- Multi-project registry for translation socket resolution — daemon now iterates registered projects to find active socket instead of hardcoded path
+- System reminder stripping — strips redundant `<system-reminder>` blocks (keeps first occurrence), reduces token overhead per request
+- Compaction proxy minimum translate length removed — all content now eligible for compression regardless of size
+
+### Improved
+- Token usage efficiency — advanced stenographic compression now applied to all tool results and system prompts, measurably lower token consumption per session
+- Agent behavior modification hooks — agents now properly communicate via team messaging tools and use SpecMem tool calls as expected
+- Tool call enforcement — bash call enforcer upgraded with better debouncing and team comms validation
+- Team communications enforcer — improved reliability of inter-agent message routing
+- Multi-project resource sharing — compaction daemon tracks project registry with cache invalidation on changes
+- README updated with new "How to Install on Linux Systems" SVG featuring Debian, Ubuntu, Ubuntu LTS, Mint, and Kali Linux
+
+### Added
+- Project registry system in compaction proxy — tracks all registered projects for shared translation memory and synonym caches
+- Dynamic translate socket resolution across registered projects (sorted by last-seen)
+- `SYSTEM_REMINDER_STRIPPING` live config toggle
+- New skill commands for agent orchestration and autoclaude workflows
+
+---
+
 ## [3.7.32] - 2026-02-24
 
 ### Fixed

package/README.md

@@ -1,3 +1,5 @@
+## Token compression currently broken - please run specmem proxy off before running specmem init - until this is fixed!
+
 <!-- Debian/Ubuntu/Mint/Kali notice -->
 <div align="center">
 <table><tr><td align="center" style="background:#0d1117;border:1px solid #30363d;border-radius:8px;padding:12px 20px">
@@ -12,8 +14,8 @@
 
 <div align="center">
 
-<!-- Demo GIF -->
-<img src="./IMG_4365.gif" alt="SpecMem Demo" width="400">
+<!-- How to Install SVG -->
+<img src="./svg-sections/readme-how-to-install.svg" alt="How to Install SpecMem on Linux" width="800">
 
 <br/>
 <br/>

package/dist/mcp/compactionProxy.js

@@ -652,7 +652,7 @@ function stripOldToolResults(messages) {
         if (!input) return block;
 
         // Smart Edit stripping — keep only - / + diff lines
-        const editDiff = smartStripEdit(block);
+        const editDiff = smartStripEdit(input);
         if (editDiff) {
           const origLen = JSON.stringify(input).length;
           const newLen = JSON.stringify(editDiff.input).length;
@@ -750,9 +750,13 @@ function stripSystemReminders(messages) {
           firstSeen = true; // keep the very first one
           continue;
         }
-        newText = newText.replace(match, '');
-        charsRemoved += match.length;
-        remindersStripped++;
+        // replaceAll to nuke ALL occurrences of this exact match in the string
+        // .replace(string, '') only kills the first occurrence — duplicates slip through
+        while (newText.includes(match)) {
+          newText = newText.replace(match, '');
+          charsRemoved += match.length;
+          remindersStripped++;
+        }
       }
       return { ...msg, content: newText.replace(/\n{3,}/g, '\n\n').trim() };
     }
@@ -772,9 +776,12 @@ function stripSystemReminders(messages) {
           firstSeen = true; // keep the very first one
           continue;
         }
-        newText = newText.replace(match, '');
-        charsRemoved += match.length;
-        remindersStripped++;
+        // replaceAll to nuke ALL occurrences of this exact match in the block
+        while (newText.includes(match)) {
+          newText = newText.replace(match, '');
+          charsRemoved += match.length;
+          remindersStripped++;
+        }
       }
       const cleaned = newText.replace(/\n{3,}/g, '\n\n').trim();
 

package/dist/watcher/index.js

@@ -31,6 +31,12 @@ export class WatcherManager {
     syncTimeout = null;
     lastLowScoreResyncAt = 0;
     lastLowScoreResyncScore = null; // track score at last resync to detect drops
+    // Drift-resync plateau detection: stop resyncing if score isn't improving
+    lastDriftResyncAt = 0;
+    lastDriftResyncScore = null;
+    driftResyncNoImprovementCount = 0; // consecutive resyncs that didn't improve score
+    static DRIFT_RESYNC_MAX_NO_IMPROVEMENT = 2; // after 2 consecutive no-improvement resyncs, accept plateau
+    static DRIFT_RESYNC_COOLDOWN_MS = 15 * 60 * 1000; // 15 min cooldown between drift resyncs
     constructor(config) {
         // Create handler first - it's the core component
         this.handler = new AutoUpdateTheMemories(config.handler);
@@ -126,7 +132,7 @@ export class WatcherManager {
             const LOW_SCORE_THRESHOLD = parseFloat(process.env['SPECMEM_LOW_SCORE_THRESHOLD'] || '0.85');
             const LOW_SCORE_DROP_THRESHOLD = parseFloat(process.env['SPECMEM_LOW_SCORE_DROP_THRESHOLD'] || '0.10');
             const LOW_SCORE_DEBOUNCE_MS = parseInt(process.env['SPECMEM_LOW_SCORE_DEBOUNCE_MS'] || String(15 * 60 * 1000), 10);
-            if (report.syncScore < LOW_SCORE_THRESHOLD) {
+            if (report.syncScore <= LOW_SCORE_THRESHOLD) {
                 // First time seeing low score — always resync
                 // After that, only resync if score dropped by >=10% from the post-resync score
                 const scoreDrop = this.lastLowScoreResyncScore !== null
@@ -163,8 +169,21 @@ export class WatcherManager {
                     missingFromMcp: report.missingFromMcp.length,
                     contentMismatch: report.contentMismatch.length
                 }, 'drift detected during periodic check');
-                // Auto-resync when drift is detected
+                // Auto-resync when drift is detected — with plateau detection + cooldown
                 if (report.missingFromMcp.length > 0 || report.contentMismatch.length > 0) {
+                    // Plateau guard: if we've resynced N times without improvement, accept the score
+                    if (this.driftResyncNoImprovementCount >= WatcherManager.DRIFT_RESYNC_MAX_NO_IMPROVEMENT) {
+                        logger.info({ syncScore: report.syncScore, noImprovementCount: this.driftResyncNoImprovementCount }, 'drift-resync plateau reached — score is stable, accepting current sync level');
+                        return;
+                    }
+                    // Cooldown guard: don't resync more than once per 15 min via drift path
+                    const now = Date.now();
+                    const driftCooldownRemaining = WatcherManager.DRIFT_RESYNC_COOLDOWN_MS - (now - this.lastDriftResyncAt);
+                    if (driftCooldownRemaining > 0) {
+                        logger.debug({ syncScore: report.syncScore, cooldownRemainingSec: Math.round(driftCooldownRemaining / 1000) }, 'drift-resync on cooldown — skipping');
+                        return;
+                    }
+                    this.lastDriftResyncAt = now;
                     logger.info('periodic check triggering auto-resync...');
                     const resyncResult = await this.syncChecker.resyncEverythingFrFr();
                     logger.info({
@@ -175,6 +194,16 @@ export class WatcherManager {
                     // Update score after resync
                     const postReport = await this.syncChecker.checkSync();
                     await this.writeSyncScore(postReport.syncScore);
+                    // Plateau detection: did this resync actually improve the score?
+                    const improvement = postReport.syncScore - (this.lastDriftResyncScore ?? 0);
+                    if (improvement < 0.01) { // less than 1% improvement = no meaningful change
+                        this.driftResyncNoImprovementCount++;
+                        logger.warn({ syncScore: postReport.syncScore, previousScore: this.lastDriftResyncScore, noImprovementCount: this.driftResyncNoImprovementCount, maxAllowed: WatcherManager.DRIFT_RESYNC_MAX_NO_IMPROVEMENT }, 'drift-resync did not improve score — tracking plateau');
+                    } else {
+                        // Score improved — reset plateau counter
+                        this.driftResyncNoImprovementCount = 0;
+                    }
+                    this.lastDriftResyncScore = postReport.syncScore;
                 }
             }
         }
@@ -307,6 +336,12 @@ export class WatcherManager {
      * resync - manually trigger full resync
      */
     async resync() {
+        // Manual resync resets all plateau/cooldown state so it always runs fresh
+        this.driftResyncNoImprovementCount = 0;
+        this.lastDriftResyncAt = 0;
+        this.lastDriftResyncScore = null;
+        this.lastLowScoreResyncScore = null;
+        this.lastLowScoreResyncAt = 0;
         return await this.syncChecker.resyncEverythingFrFr();
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specmem-hardwicksoftware",
-  "version": "3.7.33",
+  "version": "3.7.35",
   "type": "module",
   "description": "Your Claude Code sessions don't have to start from scratch anymore — SpecMem gives your AI real memory. It won't forget your conversations, your code, or your architecture decisions between sessions. That's the whole point. Semantic code indexing that actually works: TypeScript, JavaScript, Python, Go, Rust, Java, Kotlin, C, C++, HTML and more. It doesn't just track functions — it gets classes, methods, fields, constants, enums, macros, imports, structs, the whole codebase graph. There's chat memory too, powered by pgvector embeddings. You've also got token compression, team coordination, multi-agent comms, and file watching built in. 74+ MCP tools. Runs on PostgreSQL + Docker. It's kind of a big deal. justcalljon.pro",
   "main": "dist/index.js",

package/specmem/supervisord.conf

@@ -1,6 +1,6 @@
 ; ============================================
 ; SPECMEM BRAIN CONTAINER - DYNAMIC SUPERVISORD CONFIG
-; Generated by specmem-init at 2026-02-26T14:42:59.603Z
+; Generated by specmem-init at 2026-02-26T20:34:50.062Z
 ; Thread counts from model-config.json resourcePool
 ; ============================================
 

package/svg-sections/readme-how-to-install.svg

@@ -0,0 +1,145 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 480" width="800" height="480">
+  <defs>
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#0d1117"/>
+      <stop offset="100%" style="stop-color:#161b22"/>
+    </linearGradient>
+    <linearGradient id="cardGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#1c2128;stop-opacity:0.9"/>
+      <stop offset="100%" style="stop-color:#21262d;stop-opacity:0.85"/>
+    </linearGradient>
+    <linearGradient id="titleGrad" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#00bfff"/>
+      <stop offset="50%" style="stop-color:#a855f7"/>
+      <stop offset="100%" style="stop-color:#00bfff"/>
+    </linearGradient>
+    <linearGradient id="cyanPurple" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#00bfff"/>
+      <stop offset="100%" style="stop-color:#a855f7"/>
+    </linearGradient>
+    <linearGradient id="termGrad" x1="0%" y1="0%" x2="0%" y2="100%">
+      <stop offset="0%" style="stop-color:#161b22"/>
+      <stop offset="100%" style="stop-color:#0d1117"/>
+    </linearGradient>
+  </defs>
+
+  <!-- Background -->
+  <rect width="800" height="480" rx="16" ry="16" fill="url(#bgGrad)"/>
+  <rect width="800" height="480" rx="16" ry="16" fill="none" stroke="url(#cyanPurple)" stroke-width="1" stroke-opacity="0.2"/>
+
+  <!-- Title -->
+  <text x="400" y="38" text-anchor="middle" font-family="system-ui, sans-serif" font-size="22" font-weight="700" fill="url(#titleGrad)">How to Install on Linux Systems</text>
+  <text x="400" y="58" text-anchor="middle" font-family="system-ui, sans-serif" font-size="11" fill="#6e7681">Supported on all major Debian-based distributions</text>
+
+  <!-- ═══ DISTRO LOGOS ROW ═══ -->
+
+  <!-- Debian -->
+  <g transform="translate(45, 78)">
+    <rect width="130" height="80" rx="10" fill="url(#cardGrad)" stroke="#A80030" stroke-width="1.2"/>
+    <rect width="130" height="3" rx="1.5" fill="#A80030"/>
+    <g transform="translate(22, 12)">
+      <circle cx="20" cy="20" r="16" fill="none" stroke="#A80030" stroke-width="2"/>
+      <path d="M20 6 C30 6 34 16 28 24 C22 32 14 30 10 24" fill="none" stroke="#D70751" stroke-width="2.5" stroke-linecap="round"/>
+      <circle cx="20" cy="20" r="4" fill="#D70751"/>
+    </g>
+    <text x="93" y="30" text-anchor="middle" font-family="system-ui, sans-serif" font-size="14" font-weight="600" fill="#D70751">Debian</text>
+    <text x="93" y="46" text-anchor="middle" font-family="system-ui, sans-serif" font-size="10" fill="#6e7681">11+ / 12</text>
+  </g>
+
+  <!-- Ubuntu -->
+  <g transform="translate(190, 78)">
+    <rect width="130" height="80" rx="10" fill="url(#cardGrad)" stroke="#E95420" stroke-width="1.2"/>
+    <rect width="130" height="3" rx="1.5" fill="#E95420"/>
+    <g transform="translate(22, 12)">
+      <circle cx="20" cy="20" r="16" fill="none" stroke="#E95420" stroke-width="2"/>
+      <circle cx="20" cy="20" r="4" fill="#E95420"/>
+      <circle cx="20" cy="4" r="3" fill="#E95420"/>
+      <circle cx="6" cy="28" r="3" fill="#E95420"/>
+      <circle cx="34" cy="28" r="3" fill="#E95420"/>
+    </g>
+    <text x="93" y="30" text-anchor="middle" font-family="system-ui, sans-serif" font-size="14" font-weight="600" fill="#E95420">Ubuntu</text>
+    <text x="93" y="46" text-anchor="middle" font-family="system-ui, sans-serif" font-size="10" fill="#6e7681">22.04 / 24.04</text>
+  </g>
+
+  <!-- Ubuntu LTS -->
+  <g transform="translate(335, 78)">
+    <rect width="130" height="80" rx="10" fill="url(#cardGrad)" stroke="#E95420" stroke-width="1.2"/>
+    <rect width="130" height="3" rx="1.5" fill="#E95420"/>
+    <g transform="translate(18, 12)">
+      <circle cx="20" cy="20" r="16" fill="none" stroke="#E95420" stroke-width="2"/>
+      <circle cx="20" cy="20" r="4" fill="#E95420"/>
+      <circle cx="20" cy="4" r="3" fill="#77216F"/>
+      <circle cx="6" cy="28" r="3" fill="#77216F"/>
+      <circle cx="34" cy="28" r="3" fill="#77216F"/>
+    </g>
+    <text x="88" y="26" text-anchor="middle" font-family="system-ui, sans-serif" font-size="12" font-weight="600" fill="#E95420">Ubuntu LTS</text>
+    <text x="88" y="40" text-anchor="middle" font-family="system-ui, sans-serif" font-size="10" fill="#6e7681">Yes, unironically.</text>
+    <text x="88" y="52" text-anchor="middle" font-family="system-ui, sans-serif" font-size="10" fill="#6e7681">20.04+</text>
+  </g>
+
+  <!-- Linux Mint -->
+  <g transform="translate(480, 78)">
+    <rect width="130" height="80" rx="10" fill="url(#cardGrad)" stroke="#87CF3E" stroke-width="1.2"/>
+    <rect width="130" height="3" rx="1.5" fill="#87CF3E"/>
+    <g transform="translate(22, 14)">
+      <rect x="4" y="4" width="32" height="32" rx="8" fill="none" stroke="#87CF3E" stroke-width="2"/>
+      <text x="20" y="28" text-anchor="middle" font-family="system-ui, sans-serif" font-size="16" font-weight="700" fill="#87CF3E">LM</text>
+    </g>
+    <text x="93" y="30" text-anchor="middle" font-family="system-ui, sans-serif" font-size="14" font-weight="600" fill="#87CF3E">Mint</text>
+    <text x="93" y="46" text-anchor="middle" font-family="system-ui, sans-serif" font-size="10" fill="#6e7681">20+</text>
+  </g>
+
+  <!-- Kali Linux -->
+  <g transform="translate(625, 78)">
+    <rect width="130" height="80" rx="10" fill="url(#cardGrad)" stroke="#557C94" stroke-width="1.2"/>
+    <rect width="130" height="3" rx="1.5" fill="#557C94"/>
+    <g transform="translate(22, 12)">
+      <path d="M16 0 L28 12 L24 20 L32 32 L16 24 L0 32 L8 20 L4 12 Z" fill="none" stroke="#557C94" stroke-width="2" stroke-linejoin="round"/>
+    </g>
+    <text x="93" y="30" text-anchor="middle" font-family="system-ui, sans-serif" font-size="14" font-weight="600" fill="#557C94">Kali</text>
+    <text x="93" y="46" text-anchor="middle" font-family="system-ui, sans-serif" font-size="10" fill="#6e7681">Debian-based</text>
+  </g>
+
+  <!-- ═══ TERMINAL INSTALL BLOCK ═══ -->
+
+  <!-- Terminal window -->
+  <rect x="50" y="180" width="700" height="200" rx="12" fill="url(#termGrad)" stroke="#30363d" stroke-width="1.5"/>
+
+  <!-- Terminal title bar -->
+  <rect x="50" y="180" width="700" height="32" rx="12" fill="#21262d"/>
+  <rect x="50" y="200" width="700" height="12" fill="#21262d"/>
+  <circle cx="72" cy="196" r="6" fill="#ff5f57"/>
+  <circle cx="92" cy="196" r="6" fill="#febc2e"/>
+  <circle cx="112" cy="196" r="6" fill="#28c840"/>
+  <text x="400" y="200" text-anchor="middle" font-family="monospace" font-size="12" fill="#6e7681">bash — Install SpecMem</text>
+
+  <!-- Step 1 -->
+  <text x="80" y="240" font-family="monospace" font-size="14" fill="#4ade80">$</text>
+  <text x="96" y="240" font-family="monospace" font-size="14" fill="#e6edf3">npm install -g specmem-hardwicksoftware</text>
+  <text x="670" y="240" text-anchor="end" font-family="system-ui, sans-serif" font-size="11" font-weight="600" fill="#00bfff">Step 1</text>
+
+  <!-- Divider -->
+  <line x1="80" y1="254" x2="720" y2="254" stroke="#30363d" stroke-width="0.5"/>
+
+  <!-- Step 2 -->
+  <text x="80" y="280" font-family="monospace" font-size="14" fill="#4ade80">$</text>
+  <text x="96" y="280" font-family="monospace" font-size="14" fill="#e6edf3">cd /your/project/directory/</text>
+  <text x="670" y="280" text-anchor="end" font-family="system-ui, sans-serif" font-size="11" font-weight="600" fill="#a855f7">Step 2</text>
+
+  <!-- Divider -->
+  <line x1="80" y1="294" x2="720" y2="294" stroke="#30363d" stroke-width="0.5"/>
+
+  <!-- Step 3 -->
+  <text x="80" y="320" font-family="monospace" font-size="14" fill="#4ade80">$</text>
+  <text x="96" y="320" font-family="monospace" font-size="14" fill="#e6edf3">specmem init</text>
+  <text x="670" y="320" text-anchor="end" font-family="system-ui, sans-serif" font-size="11" font-weight="600" fill="#22c55e">Step 3</text>
+
+  <!-- Output line -->
+  <text x="96" y="350" font-family="monospace" font-size="12" fill="#4ade80">✔ SpecMem initialized. You're done.</text>
+  <text x="96" y="368" font-family="monospace" font-size="11" fill="#6e7681">Embedding server, PostgreSQL, pgvector — all handled for you.</text>
+
+  <!-- ═══ FOOTER BANNER ═══ -->
+  <rect x="50" y="400" width="700" height="60" rx="12" fill="#22c55e" fill-opacity="0.08" stroke="#22c55e" stroke-width="1" stroke-opacity="0.3"/>
+  <text x="400" y="426" text-anchor="middle" font-family="system-ui, sans-serif" font-size="16" font-weight="700" fill="#4ade80">It's literally 3 steps, you can't fuck this up!</text>
+  <text x="400" y="448" text-anchor="middle" font-family="system-ui, sans-serif" font-size="11" fill="#6e7681">specmem init auto-installs everything. Including Claude Code itself.</text>
+</svg>