Skip to content

v2.0.0 — Autonomous Cognitive Engine Major Overhaul

Choose a tag to compare

View all tags
@harshsinghmp harshsinghmp released this 02 Sep 22:06
· 413 commits to main since this release
v2.0.0
77400ae

🧠 Muse Memory v2.0.0 — Autonomous Cognitive Engine Major Overhaul

Release Version: v2.0.0
Milestones: R1 through R13 complete
Test Status: 480/480 passing tests across 79 test suites
Tool Surface: 61 MCP Tools across 6 task-focused profiles

🌟 Highlights

Muse Memory v2.0.0 is a major architectural leap evolving Muse Memory from a passive episodic memory store into a complete, self-correcting, evidence-aware autonomous cognitive engine with zero external resident daemon dependencies.

1. 🏥 Unified 5-Pillar Project Health Gate (memory health / muse_health)

  • Single-call comprehensive quality gate evaluating:
    1. Memory Store Integrity: Contradictions, expired entries, timeless rules.
    2. Native Code Anchor Validity: Live AST structural verification, drift detection.
    3. Documentation ↔ Code Alignment: Bi-directional drift, undocumented exports.
    4. Negative Lessons & Anti-Pattern Sentry: Saliency and defense against known traps.
    5. Technical Debt & Friction: TODO/FIXME markers, as any type bypasses, recurring bug clusters.
  • Generates composite grades (A–F), gate status (PASS/WARN/FAIL), prioritized remediation checklist, and an ANSI terminal dashboard.

2. 🧠 Autonomous Engineering Cognition & "Why" Reasoner (muse_why)

  • Traces code evolution backwards through past bug fixes, ADRs, accepted trade-offs, and timeless rules to explain why code was built the way it is before an agent refactors it.
  • Bug & Friction Clustering (muse_bug_clusters): Categorizes failure patterns across 5 root causes (race_condition, type_drift, missing_guard, resource_leak, architecture_flaw) and computes subsystem fragility scores.
  • Technical Debt Registry (muse_tech_debt): Scans code and memory for workarounds and dangerous type bypasses.

3. 🏛️ First-Class Architecture Decision Records & Drift Engine (memory_adr_*, memory_drift_audit)

  • ADRs as living, queryable, scored memory entities (proposed, accepted, superseded, rejected) linked directly to affected symbols and tests.
  • 6-state bi-directional drift classifier (DOCUMENTED, IMPLEMENTED, PARTIAL, CONFLICTING, STALE, MISSING).

4. ⚓ Native Structural Code Anchors (src/anchors/)

  • Line-independent structural fingerprints normalized across whitespace and comment edits.
  • Live verification detects whether symbols are valid, drifted, or orphaned without requiring external dependencies.

5. 🎯 Flagship Context Orchestrator & Task-Focused Profiles (muse_context)

  • Fuses active constraints, code anchors, ranked memories, and negative lessons under token budget limits using knapsack packing.
  • 6 role-tailored MCP profiles (core, coding, debugging, review, architecture, maintenance) that eliminate tool-surface bloat for coding agents.

6. 🪜 Scoped Promotion Ladder & Extended Archival Lifecycle (src/promotion/)

  • Strict 3-tier promotion: local → project → global.
  • 5× repeated success policy gate with automatic structural generalization.
  • active → cold → dormant → archived lifecycle with zero-friction query rehydration.

7. ⚡ Core Speed & Multi-Factor Retrieval

  • Sub-50 microsecond in-process L0 hot cache and L1 context cache with SQLite WAL tuning.
  • 11-dimension retrieval scoring combining AST symbol matches, path proximity, FTS5 BM25, graph overlap, recency decay, and utility ROI.

📦 Installation & Upgrade

# Global Install
npm install -g musememory
# or with Bun:
bun add -g musememory

# One-line autonomous upgrade
memory upgrade
Assets 2
Loading