musememory 1.7.1 โ†’ 1.8.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 +72 -23
  2. package/dist/index.js +653 -287
  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-315%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,21 @@
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
+ - [๐Ÿง  Shipped Agent Skills (`.agents/skills/`)](#-shipped-agent-skills-agentsskills)
33
+ - [๐Ÿ‘ค 5 Role Archetypes (`USER.md`)](#-5-zero-fingerprint-role-archetypes-usermd)
34
+ - [๐Ÿ”Œ Full CLI Command Matrix](#-full-cli-command-matrix)
35
+ - [๐Ÿ›ก๏ธ Vibeguard Zero-Leakage Protocol](#๏ธ-vibeguard-zero-leakage-protocol)
36
+ - [๐Ÿงช Testing & Verification](#-testing--verification)
37
+ - [๐Ÿ”ฎ Sprint & Roadmap Board](#-sprint--roadmap-board)
38
+ - [๐Ÿ“œ License](#-license)
39
+
40
+ ---
41
+
27
42
  ## ๐Ÿ’ก What is Muse Memory? (TL;DR)
28
43
 
29
44
  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.
@@ -428,14 +443,65 @@ memory user set "- Prefers TypeScript, Bun, and ultra terse responses"
428
443
 
429
444
  </details>
430
445
 
446
+ ---
447
+
448
+ ## ๐Ÿงช Testing & Verification
449
+
450
+ ```bash
451
+ bun install
452
+ bun test # 315 passed across 56 test files (1282 assertions)
453
+ bun run typecheck # 0 static type errors
454
+ bun run build # Clean bundled distribution build (dist/index.js)
455
+ ```
456
+
457
+ ---
458
+
459
+ ## ๐Ÿ”ฎ Sprint & Roadmap Board
460
+
431
461
  <details>
432
- <summary><b>๐Ÿ”ฎ SOW & Roadmap Issue Tracker</b> โ€” <i>Click to expand</i></summary>
462
+ <summary><b>๐Ÿ”ฎ Sprint & Roadmap Lifecycle (Requested โž” Planned โž” In Progress โž” Done)</b> โ€” <i>Click to expand</i></summary>
463
+
464
+ 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).
433
465
 
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).
466
+ ```
467
+ [ ๐Ÿ“‹ Requested ] โ”€โ”€โ–บ [ ๐Ÿ“… Planned ] โ”€โ”€โ–บ [ โšก In Progress ] โ”€โ”€โ–บ [ โœ… Done ]
468
+ (Issues / PRs) (Sprint Backlog) (Active PR / Milestone) (Shipped to Main)
469
+ ```
435
470
 
436
- | Status | Item | Tracker |
471
+ ### ๐Ÿ“‹ Phase 1: Requested (Backlog)
472
+ *Incoming community proposals, agent adapters, and feature requests pending sprint triage:*
473
+ - [ ] Multi-Agent Consensus Verification Protocol (cross-agent memory agreement)
474
+ - [ ] Continuous Background Memory Compaction & Pruning Cron
475
+ - [ ] Export to Local Vector GGUF Embedding Index
476
+
477
+ ### ๐Ÿ“… Phase 2: Planned
478
+ *Confirmed high-leverage features scheduled for upcoming sprints:*
479
+ - [ ] Multi-Agent Consensus Verification Protocol (cross-agent memory agreement)
480
+ - [ ] Continuous Background Memory Compaction & Pruning Cron
481
+ - [ ] Export to Local Vector GGUF Embedding Index
482
+
483
+ ### โšก Phase 3: In Progress (Active Sprint / PR)
484
+ *Currently under active development on dedicated feature branches:*
485
+ - *(None โ€” Sprint SOW-200 completed and shipped)*
486
+
487
+ ### โœ… Phase 4: Done (Shipped to Production)
488
+ *All completed, tested, and released milestones:*
489
+ | Status | Milestone / Feature | Shipped Release / Tracker |
437
490
  | :--- | :--- | :--- |
438
- | โœ… | Dynamic Prompt Token Budgeter (`--token-budget N`) โ€” knapsack packing under hard token ceilings | shipped v1.1.0 |
491
+ | โœ… | **SOW-201**: Live Runtime File & Symbol Verification Gate (`STRONG`/`WEAK`/`STALE`) | shipped v1.8.0 |
492
+ | โœ… | **SOW-202**: Deterministic Relevance Cutoff Gate (hard score threshold $\ge 0.45$) | shipped v1.8.0 |
493
+ | โœ… | **SOW-203**: Git Code-Drift Scanner CLI (`memory drift` / `memory check`) | shipped v1.8.0 |
494
+ | โœ… | **SOW-204**: Gradient-Free Hebbian Co-Activation Plasticity (synaptic link reinforcement) | shipped v1.8.0 |
495
+ | โœ… | **SOW-205**: Semantic Memory Prompt Compression (`memory compress` lossless prompt packer) | shipped v1.8.0 |
496
+ | โœ… | Turnkey Agent Skills Suite (`muse-ground`, `muse-capture`, etc.) | shipped v1.7.0 |
497
+ | โœ… | AST Symbol Graph Integration (CodeGraph / Graphify) | [#35](https://github.com/harshsinghmp/musememory/issues/35) / v1.7.0 |
498
+ | โœ… | Zero-Friction Installation Lifecycle Fix | shipped v1.7.1 |
499
+ | โœ… | Proactive Nudges & Check-ins (`memory nudge`) โ€” SOW-101 | [#28](https://github.com/harshsinghmp/musememory/issues/28) |
500
+ | โœ… | Daily Briefing & Routines Scheduler (cron-invoked, no daemon) โ€” SOW-102 | [#29](https://github.com/harshsinghmp/musememory/issues/29) |
501
+ | โœ… | Open-Loop / Task Extraction from Transcripts โ€” SOW-103 | [#30](https://github.com/harshsinghmp/musememory/issues/30) |
502
+ | โœ… | Calendar / Time-Aware Follow-ups (`due_at` / `expires_at`) โ€” SOW-104 | [#31](https://github.com/harshsinghmp/musememory/issues/31) |
503
+ | โœ… | muse-agents โ†” musememory Integration Contract (`--for-agent`) โ€” SOW-106 | [#33](https://github.com/harshsinghmp/musememory/issues/33) |
504
+ | โœ… | Dynamic Prompt Token Budgeter (`--token-budget N`) | shipped v1.1.0 |
439
505
  | โœ… | Scene-Based Hierarchical Consolidation (`memory consolidate`) | [#1](https://github.com/harshsinghmp/musememory/issues/1) |
440
506
  | โœ… | Autonomous Verification Oracle (`memory verify <id>`) | [#2](https://github.com/harshsinghmp/musememory/issues/2) |
441
507
  | โœ… | Multi-Hop Causality Graph Tracer (`memory trace <id>`) | [#3](https://github.com/harshsinghmp/musememory/issues/3) |
@@ -443,34 +509,17 @@ Every Scope-of-Work item is tracked as a GitHub issue and delivered via pull req
443
509
  | โœ… | Automated Post-Turn Transcript Harvester Hook | [#5](https://github.com/harshsinghmp/musememory/issues/5) |
444
510
  | โœ… | Real-Time Agency WebSocket Hub (`memory daemon`) | [#6](https://github.com/harshsinghmp/musememory/issues/6) |
445
511
  | โœ… | 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) |
512
+ | โœ… | Delete Deprecated `MemoryStore` Shim | [#8](https://github.com/harshsinghmp/musememory/issues/8) / v1.5.0 |
447
513
  | โœ… | Self-Evolving Skill Distillation | [#9](https://github.com/harshsinghmp/musememory/issues/9) |
448
514
  | โœ… | 3-Layer Progressive Disclosure | [#10](https://github.com/harshsinghmp/musememory/issues/10) |
449
515
  | โœ… | Bi-Temporal Reinforcement Feedback | [#11](https://github.com/harshsinghmp/musememory/issues/11) |
450
516
  | โœ… | Ambient Open-Loop Tracker | [#12](https://github.com/harshsinghmp/musememory/issues/12) |
451
517
  | โœ… | 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
518
 
459
519
  </details>
460
520
 
461
521
  ---
462
522
 
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
523
  ## ๐Ÿ“œ License
475
524
 
476
525
  MIT License. Built for the AI Developer Ecosystem.