musememory 1.8.0 โ†’ 1.10.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 +59 -3
  2. package/dist/index.js +867 -187
  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
 
@@ -376,6 +431,7 @@ memory <command> [arguments] [flags] # alias: musememory
376
431
  | `context` | `[query] [--token-budget N] [--limit N]` | Retrieve Top-$K$ ranked active context for prompt injection. |
377
432
  | `search` | `<query> [--limit N] [--token-budget N] [--type T]` | Ranked multi-factor token search with score breakdown. |
378
433
  | `search-transcript` | `<query> [file.jsonl] [--window N]` | Full-text search past transcripts with dialogue context windows. |
434
+ | `learn` / `sync-chats` | `[--confirm] [--force] [--max N]` | **Universal auto-learner**: auto-discovers and distills memories from all agent chats across host machine. |
379
435
  | `harvest` | `<text\|file> --project P [--confirmed]` | Distill conversation turns into structured fix/decision memory units. |
380
436
  | `import-transcript` | `<file.jsonl> [--project P] [--confirmed]` | Ingest raw `.jsonl` session transcripts from coding agents. |
381
437
  | `capture` / `propose` | `<text> --project P [--title T] [--type T]` | Propose a memory entry with inline Vibeguard secret inspection. |
@@ -449,7 +505,7 @@ memory user set "- Prefers TypeScript, Bun, and ultra terse responses"
449
505
 
450
506
  ```bash
451
507
  bun install
452
- bun test # 315 passed across 56 test files (1282 assertions)
508
+ bun test # 319 passed across 57 test files (1294 assertions)
453
509
  bun run typecheck # 0 static type errors
454
510
  bun run build # Clean bundled distribution build (dist/index.js)
455
511
  ```