musememory 1.7.1 โ†’ 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 +128 -24
  2. package/dist/index.js +1198 -472
  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-304%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)
@@ -24,6 +24,22 @@
24
24
 
25
25
  ---
26
26
 
27
+ ## ๐Ÿ“‘ Table of Contents
28
+
29
+ - [๐Ÿ’ก What is Muse Memory? (TL;DR)](#-what-is-muse-memory-tldr)
30
+ - [โœจ Key Feature Highlights](#-key-feature-highlights)
31
+ - [โšก Quick Start & Installation](#-quick-start--installation)
32
+ - [๐Ÿ”„ Upgrading & Self-Healing Maintenance](#-upgrading--self-healing-maintenance)
33
+ - [๐Ÿง  Shipped Agent Skills (`.agents/skills/`)](#-shipped-agent-skills-agentsskills)
34
+ - [๐Ÿ‘ค 5 Role Archetypes (`USER.md`)](#-5-zero-fingerprint-role-archetypes-usermd)
35
+ - [๐Ÿ”Œ Full CLI Command Matrix](#-full-cli-command-matrix)
36
+ - [๐Ÿ›ก๏ธ Vibeguard Zero-Leakage Protocol](#๏ธ-vibeguard-zero-leakage-protocol)
37
+ - [๐Ÿงช Testing & Verification](#-testing--verification)
38
+ - [๐Ÿ”ฎ Sprint & Roadmap Board](#-sprint--roadmap-board)
39
+ - [๐Ÿ“œ License](#-license)
40
+
41
+ ---
42
+
27
43
  ## ๐Ÿ’ก What is Muse Memory? (TL;DR)
28
44
 
29
45
  Most AI chatbots and coding assistants have **"goldfish memory"**: every time you close a session, switch tasks, or start a new prompt, they forget your project invariants, coding habits, and the hard-fought bug workarounds you solved yesterday.
@@ -122,7 +138,61 @@ docker build -t musememory .
122
138
 
123
139
  > [!NOTE]
124
140
  > ### ๐Ÿ“Š How does Muse Memory compare to other solutions?
125
- > 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
+ ```
126
196
 
127
197
  ---
128
198
 
@@ -428,14 +498,65 @@ memory user set "- Prefers TypeScript, Bun, and ultra terse responses"
428
498
 
429
499
  </details>
430
500
 
501
+ ---
502
+
503
+ ## ๐Ÿงช Testing & Verification
504
+
505
+ ```bash
506
+ bun install
507
+ bun test # 319 passed across 57 test files (1294 assertions)
508
+ bun run typecheck # 0 static type errors
509
+ bun run build # Clean bundled distribution build (dist/index.js)
510
+ ```
511
+
512
+ ---
513
+
514
+ ## ๐Ÿ”ฎ Sprint & Roadmap Board
515
+
431
516
  <details>
432
- <summary><b>๐Ÿ”ฎ SOW & Roadmap Issue Tracker</b> โ€” <i>Click to expand</i></summary>
517
+ <summary><b>๐Ÿ”ฎ Sprint & Roadmap Lifecycle (Requested โž” Planned โž” In Progress โž” Done)</b> โ€” <i>Click to expand</i></summary>
433
518
 
434
- Every Scope-of-Work item is tracked as a GitHub issue and delivered via pull request. Live status: [issue tracker](https://github.com/harshsinghmp/musememory/issues).
519
+ Muse Memory features are developed in structured sprints moving across 4 deterministic lifecycle phases. Every sprint is delivered via PR from `dev` to `main` with associated GitHub milestones. Live tracking: [GitHub Issues & Milestones](https://github.com/harshsinghmp/musememory/issues).
435
520
 
436
- | Status | Item | Tracker |
521
+ ```
522
+ [ ๐Ÿ“‹ Requested ] โ”€โ”€โ–บ [ ๐Ÿ“… Planned ] โ”€โ”€โ–บ [ โšก In Progress ] โ”€โ”€โ–บ [ โœ… Done ]
523
+ (Issues / PRs) (Sprint Backlog) (Active PR / Milestone) (Shipped to Main)
524
+ ```
525
+
526
+ ### ๐Ÿ“‹ Phase 1: Requested (Backlog)
527
+ *Incoming community proposals, agent adapters, and feature requests pending sprint triage:*
528
+ - [ ] Multi-Agent Consensus Verification Protocol (cross-agent memory agreement)
529
+ - [ ] Continuous Background Memory Compaction & Pruning Cron
530
+ - [ ] Export to Local Vector GGUF Embedding Index
531
+
532
+ ### ๐Ÿ“… Phase 2: Planned
533
+ *Confirmed high-leverage features scheduled for upcoming sprints:*
534
+ - [ ] Multi-Agent Consensus Verification Protocol (cross-agent memory agreement)
535
+ - [ ] Continuous Background Memory Compaction & Pruning Cron
536
+ - [ ] Export to Local Vector GGUF Embedding Index
537
+
538
+ ### โšก Phase 3: In Progress (Active Sprint / PR)
539
+ *Currently under active development on dedicated feature branches:*
540
+ - *(None โ€” Sprint SOW-200 completed and shipped)*
541
+
542
+ ### โœ… Phase 4: Done (Shipped to Production)
543
+ *All completed, tested, and released milestones:*
544
+ | Status | Milestone / Feature | Shipped Release / Tracker |
437
545
  | :--- | :--- | :--- |
438
- | โœ… | Dynamic Prompt Token Budgeter (`--token-budget N`) โ€” knapsack packing under hard token ceilings | shipped v1.1.0 |
546
+ | โœ… | **SOW-201**: Live Runtime File & Symbol Verification Gate (`STRONG`/`WEAK`/`STALE`) | shipped v1.8.0 |
547
+ | โœ… | **SOW-202**: Deterministic Relevance Cutoff Gate (hard score threshold $\ge 0.45$) | shipped v1.8.0 |
548
+ | โœ… | **SOW-203**: Git Code-Drift Scanner CLI (`memory drift` / `memory check`) | shipped v1.8.0 |
549
+ | โœ… | **SOW-204**: Gradient-Free Hebbian Co-Activation Plasticity (synaptic link reinforcement) | shipped v1.8.0 |
550
+ | โœ… | **SOW-205**: Semantic Memory Prompt Compression (`memory compress` lossless prompt packer) | shipped v1.8.0 |
551
+ | โœ… | Turnkey Agent Skills Suite (`muse-ground`, `muse-capture`, etc.) | shipped v1.7.0 |
552
+ | โœ… | AST Symbol Graph Integration (CodeGraph / Graphify) | [#35](https://github.com/harshsinghmp/musememory/issues/35) / v1.7.0 |
553
+ | โœ… | Zero-Friction Installation Lifecycle Fix | shipped v1.7.1 |
554
+ | โœ… | Proactive Nudges & Check-ins (`memory nudge`) โ€” SOW-101 | [#28](https://github.com/harshsinghmp/musememory/issues/28) |
555
+ | โœ… | Daily Briefing & Routines Scheduler (cron-invoked, no daemon) โ€” SOW-102 | [#29](https://github.com/harshsinghmp/musememory/issues/29) |
556
+ | โœ… | Open-Loop / Task Extraction from Transcripts โ€” SOW-103 | [#30](https://github.com/harshsinghmp/musememory/issues/30) |
557
+ | โœ… | Calendar / Time-Aware Follow-ups (`due_at` / `expires_at`) โ€” SOW-104 | [#31](https://github.com/harshsinghmp/musememory/issues/31) |
558
+ | โœ… | muse-agents โ†” musememory Integration Contract (`--for-agent`) โ€” SOW-106 | [#33](https://github.com/harshsinghmp/musememory/issues/33) |
559
+ | โœ… | Dynamic Prompt Token Budgeter (`--token-budget N`) | shipped v1.1.0 |
439
560
  | โœ… | Scene-Based Hierarchical Consolidation (`memory consolidate`) | [#1](https://github.com/harshsinghmp/musememory/issues/1) |
440
561
  | โœ… | Autonomous Verification Oracle (`memory verify <id>`) | [#2](https://github.com/harshsinghmp/musememory/issues/2) |
441
562
  | โœ… | Multi-Hop Causality Graph Tracer (`memory trace <id>`) | [#3](https://github.com/harshsinghmp/musememory/issues/3) |
@@ -443,34 +564,17 @@ Every Scope-of-Work item is tracked as a GitHub issue and delivered via pull req
443
564
  | โœ… | Automated Post-Turn Transcript Harvester Hook | [#5](https://github.com/harshsinghmp/musememory/issues/5) |
444
565
  | โœ… | Real-Time Agency WebSocket Hub (`memory daemon`) | [#6](https://github.com/harshsinghmp/musememory/issues/6) |
445
566
  | โœ… | Local Offline Hybrid Vector Engine | [#7](https://github.com/harshsinghmp/musememory/issues/7) |
446
- | โœ… | Delete Deprecated `MemoryStore` Shim *(shipped v1.5.0)* | [#8](https://github.com/harshsinghmp/musememory/issues/8) |
567
+ | โœ… | Delete Deprecated `MemoryStore` Shim | [#8](https://github.com/harshsinghmp/musememory/issues/8) / v1.5.0 |
447
568
  | โœ… | Self-Evolving Skill Distillation | [#9](https://github.com/harshsinghmp/musememory/issues/9) |
448
569
  | โœ… | 3-Layer Progressive Disclosure | [#10](https://github.com/harshsinghmp/musememory/issues/10) |
449
570
  | โœ… | Bi-Temporal Reinforcement Feedback | [#11](https://github.com/harshsinghmp/musememory/issues/11) |
450
571
  | โœ… | Ambient Open-Loop Tracker | [#12](https://github.com/harshsinghmp/musememory/issues/12) |
451
572
  | โœ… | Knowledge Graph UI v2 | [#13](https://github.com/harshsinghmp/musememory/issues/13) |
452
- | โœ… | Proactive Nudges & Check-ins (`memory nudge`) โ€” SOW-101 | [#28](https://github.com/harshsinghmp/musememory/issues/28) |
453
- | โœ… | Daily Briefing & Routines Scheduler (cron-invoked, no daemon) โ€” SOW-102 | [#29](https://github.com/harshsinghmp/musememory/issues/29) |
454
- | โœ… | Open-Loop / Task Extraction from Transcripts โ€” SOW-103 | [#30](https://github.com/harshsinghmp/musememory/issues/30) |
455
- | โœ… | Calendar / Time-Aware Follow-ups (`due_at` / `expires_at`) โ€” SOW-104 | [#31](https://github.com/harshsinghmp/musememory/issues/31) |
456
- | โœ… | muse-agents โ†” musememory Integration Contract (`--for-agent`) โ€” SOW-106 | [#33](https://github.com/harshsinghmp/musememory/issues/33) |
457
- | โœ… | AST Symbol Graph Integration (CodeGraph / Graphify provider) โ€” SOW-107 | [#35](https://github.com/harshsinghmp/musememory/issues/35) |
458
573
 
459
574
  </details>
460
575
 
461
576
  ---
462
577
 
463
- ## ๐Ÿงช Testing & Verification
464
-
465
- ```bash
466
- bun install
467
- bun test # 304 passed across 55 test files (1248 assertions)
468
- bun run typecheck # 0 static type errors
469
- bun run build # Clean bundled distribution build (dist/index.js)
470
- ```
471
-
472
- ---
473
-
474
578
  ## ๐Ÿ“œ License
475
579
 
476
580
  MIT License. Built for the AI Developer Ecosystem.