musememory 1.8.0 โ†’ 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +58 -3
  2. package/dist/index.js +539 -179
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -13,7 +13,7 @@
13
13
  ![AST Graph](https://img.shields.io/badge/AST-CodeGraph_%26_Graphify-orange?style=for-the-badge&logo=diagram-project&logoColor=white)
14
14
  ![Architecture](https://img.shields.io/badge/Storage-Zero--Daemon_%2F_Local--First-0D9488?style=for-the-badge)
15
15
 
16
- ![CI Tests](https://img.shields.io/badge/Tests-315%20Passed-brightgreen?style=for-the-badge&logo=checkmarx)
16
+ ![CI Tests](https://img.shields.io/badge/Tests-319%20Passed-brightgreen?style=for-the-badge&logo=checkmarx)
17
17
  ![Security](https://img.shields.io/badge/Security-Vibeguard_Zero--Leak-DC2626?style=for-the-badge&logo=shield)
18
18
  ![Agent Coverage](https://img.shields.io/badge/Agents-80+_Supported-4F46E5?style=for-the-badge&logo=openai)
19
19
  ![License](https://img.shields.io/badge/License-MIT-9333EA?style=for-the-badge)
@@ -29,6 +29,7 @@
29
29
  - [๐Ÿ’ก What is Muse Memory? (TL;DR)](#-what-is-muse-memory-tldr)
30
30
  - [โœจ Key Feature Highlights](#-key-feature-highlights)
31
31
  - [โšก Quick Start & Installation](#-quick-start--installation)
32
+ - [๐Ÿ”„ Upgrading & Self-Healing Maintenance](#-upgrading--self-healing-maintenance)
32
33
  - [๐Ÿง  Shipped Agent Skills (`.agents/skills/`)](#-shipped-agent-skills-agentsskills)
33
34
  - [๐Ÿ‘ค 5 Role Archetypes (`USER.md`)](#-5-zero-fingerprint-role-archetypes-usermd)
34
35
  - [๐Ÿ”Œ Full CLI Command Matrix](#-full-cli-command-matrix)
@@ -137,7 +138,61 @@ docker build -t musememory .
137
138
 
138
139
  > [!NOTE]
139
140
  > ### ๐Ÿ“Š How does Muse Memory compare to other solutions?
140
- > Explore our interactive, table-free **[30-System Architectural Comparison Dossier](musememory-comparison.html)** (`musememory-comparison.html`) to inspect concrete architectural differentials and one-click migration recipes against 29 external memory engines (Letta, Mem0, Supermemory, Cognee, Beads, Mnemosyne, GBrain, etc.).
141
+ ---
142
+
143
+ ## ๐Ÿ”„ Upgrading & Self-Healing Maintenance
144
+
145
+ Keep Muse Memory and all your connected AI coding agents at peak cognitive performance with automated updates and self-healing environment repairs.
146
+
147
+ ### โšก 1-Command Autonomous Upgrade (`memory upgrade`)
148
+
149
+ Run `memory upgrade` (or `npx musememory upgrade`) to trigger the **Gamified Level-Up Matrix**:
150
+
151
+ ```bash
152
+ memory upgrade
153
+ # or with NPX zero-install:
154
+ npx musememory upgrade
155
+ ```
156
+
157
+ ```
158
+ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
159
+ โ”‚ ๐Ÿง  MUSE MEMORY ยท SYSTEM LEVEL-UP & RECOVERY MATRIX โ”‚
160
+ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
161
+
162
+ [โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ] 100% โœ“ LEVEL 1: Vibeguard Security & Credential Audit [OK]
163
+ [โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ] 100% โœ“ LEVEL 2: Package Manager Sync (bun/npm) [OK]
164
+ [โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ] 100% โœ“ LEVEL 3: Synaptic Storage & Schema Alignment [OK]
165
+ [โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ] 100% โœ“ LEVEL 4: 80+ Agent Platforms & Skills Auto-Wiring [OK]
166
+ [โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ] 100% โœ“ LEVEL 5: Cognitive Ascendance Complete [OK]
167
+
168
+ ๐Ÿ† [LEVEL-UP COMPLETE] Muse Memory is now fully armed and up to date!
169
+ ```
170
+
171
+ #### What `memory upgrade` automatically handles:
172
+ 1. **Package Manager Auto-Detection**: Detects whether your workstation runs `bun`, `npm`, `pnpm`, or `yarn` and pulls the latest published binary.
173
+ 2. **Self-Healing Storage Repair**: Recovers missing `.memory/`, `CURRENT.md` constraints, or `USER.md` persona files if corrupted or deleted.
174
+ 3. **80+ Agent Platform Re-Discovery**: Scans for newly installed coding agents (Cursor, Claude Code, Windsurf, OpenCode, Codex, Gemini CLI, Hermes, etc.) and auto-wires them with zero permissions.
175
+ 4. **AST Symbol Graph Re-Indexing**: Re-synchronizes CodeGraph/Graphify symbol caches under `.memory/graph-symbols.json`.
176
+
177
+ ---
178
+
179
+ ### ๐Ÿ“ฆ Manual Package Manager Upgrades
180
+
181
+ | Toolchain / Runtime | Upgrade Command | Verification |
182
+ | :--- | :--- | :--- |
183
+ | **Bun** (Ultra-Fast) | `bun add -g musememory@latest` | `memory doctor` |
184
+ | **NPM** (Standard Node) | `npm install -g musememory@latest` | `memory doctor` |
185
+ | **PNPM** | `pnpm add -g musememory@latest` | `memory doctor` |
186
+ | **Yarn** | `yarn global add musememory@latest` | `memory doctor` |
187
+ | **NPX** (Zero-Install) | `npx musememory@latest upgrade` | `npx musememory doctor` |
188
+
189
+ ```bash
190
+ # Check if updates are available without applying
191
+ memory upgrade --check
192
+
193
+ # Force re-installation and complete platform re-wiring
194
+ memory upgrade --force
195
+ ```
141
196
 
142
197
  ---
143
198
 
@@ -449,7 +504,7 @@ memory user set "- Prefers TypeScript, Bun, and ultra terse responses"
449
504
 
450
505
  ```bash
451
506
  bun install
452
- bun test # 315 passed across 56 test files (1282 assertions)
507
+ bun test # 319 passed across 57 test files (1294 assertions)
453
508
  bun run typecheck # 0 static type errors
454
509
  bun run build # Clean bundled distribution build (dist/index.js)
455
510
  ```