musememory 2.0.0 → 2.2.0

package/README.md

@@ -13,7 +13,7 @@
 ![AST Graph](https://img.shields.io/badge/AST-CodeGraph_%26_Graphify-orange?style=for-the-badge&logo=diagram-project&logoColor=white)
 ![Architecture](https://img.shields.io/badge/Storage-Zero--Daemon_%2F_Local--First-0D9488?style=for-the-badge)
 
-![CI Tests](https://img.shields.io/badge/Tests-480%20Passed-brightgreen?style=for-the-badge&logo=checkmarx)
+![CI Tests](https://img.shields.io/badge/Tests-497%20Passed-brightgreen?style=for-the-badge&logo=checkmarx)
 ![Security](https://img.shields.io/badge/Security-Vibeguard_Zero--Leak-DC2626?style=for-the-badge&logo=shield)
 ![Agent Coverage](https://img.shields.io/badge/Agents-80+_Supported-4F46E5?style=for-the-badge&logo=openai)
 ![License](https://img.shields.io/badge/License-MIT-9333EA?style=for-the-badge)
@@ -24,23 +24,60 @@
 
 ---
 
-## 🚀 What's New in v2.0.0 (Autonomous Cognitive Engine Major Overhaul)
-
-- **🏥 Unified 5-Pillar Project Health Gate (`memory health` / `muse_health`)**: Comprehensive single-call architectural and memory health audit scoring Store Integrity, Code Anchor Validity, Doc $\leftrightarrow$ Code Alignment, Negative Sentry, and Technical Debt with letter grades (A-F), PASS/WARN/FAIL status, and automated remediation checklists.
-- **🧠 Autonomous Engineering Cognition & "Why" Reasoner (`muse_why`)**: Traces code evolution backwards through past bug fixes, ADRs, accepted trade-offs, and invariants to explain *why* code was built the way it is before refactoring.
-- **🏛️ First-Class Architecture Decision Records (`memory_adr_record` / `memory_adr_list`)**: ADRs as queryable, scored, living memory units with options considered, consequences, native code anchors, and supersession lineage.
-- **🔄 Bidirectional Documentation $\leftrightarrow$ Code Drift Engine (`memory_drift_audit`)**: Continuously verifies that documented architectural invariants match live implementation and flags missing, stale, or conflicting code.
-- **🎯 Flagship Unified Context Orchestrator (`muse_context`)**: Single-call fused entry point combining search, active file, symbol, error messages, and task intent under strict knapsack token budgets.
-- **⚙️ Task-Focused MCP Profiles**: Solves agent tool bloat with role-tailored tool filtering profiles (`core`, `coding`, `debugging`, `review`, `architecture`, `maintenance`).
-- **⚓ Native Structural Code Anchors (`src/anchors/`)**: Line-independent structural hashing invariant to comment/spacing edits while strictly sensitive to AST/logic modifications.
-- **🪜 Scoped Promotion & Extended Archival Lifecycle (`src/promotion/`)**: 3-tier promotion ladder (`local` $\rightarrow$ `project` $\rightarrow$ `global`), 5× repeated success policy, universal generalization, and `active` $\rightarrow$ `cold` $\rightarrow$ `dormant` $\rightarrow$ `archived` lifecycle with dynamic query rehydration.
-- **⚡ Hot Query Cache & Multi-Factor Retrieval**: Microsecond caching, SQLite WAL optimization, and 11-dimension retrieval scoring.
+## 🚀 What's New in v2.2.0, v2.1.0 & v2.0.0 (Impact Analysis, PR Context, Reconciler & Telemetry)
+
+### 💥 v2.2.0 Flagship Additions: Code Impact, PR Context & Cognitive Governance
+- **💥 Unified Code & Memory Impact Analysis (`memory code-impact`)**:
+  - Synthesizes AST code callers, affected test suites, linked memories, living ADRs, negative anti-patterns, and active constraints.
+  - Computes a composite Risk Score (0–100) and Risk Level (`LOW`, `MEDIUM`, `HIGH`, `CRITICAL`) with pre-flight actionable recommendations before modifying code.
+  - Available via CLI `memory code-impact <file> [--symbol <name>]` and MCP tool `muse_code_impact`.
+- **📋 PR & Change Context Generator (`memory pr-context`)**:
+  - Automatically analyzes git diff against base branch, linking touched code anchors, respected ADRs, active project constraints, and blast radius.
+  - Generates rich GitHub-ready Markdown pull request descriptions with verification checklists and merge promotion proposals.
+  - Available via CLI `memory pr-context [--base main] [--out <file>]` and MCP tool `muse_pr_context`.
+- **⚓ Interactive Code Anchor Reconciler (`memory reconcile`)**:
+  - Audits code anchors across memories, pruning dead anchors, refreshing structural hashes for drifted code, and marking abandoned memories stale.
+  - Supports `--dry-run`, `--prune`, `--mark-stale`, `--update-hashes`, and MCP tool `muse_reconcile_anchors`.
+- **⚡ Repeatable Speed, Quality & ROI Benchmark Suite (`memory benchmark`)**:
+  - Measures microsecond in-process cache reads (P50 < 4µs), SQLite FTS5 BM25 search, knapsack token packing, contradiction rates, and compression ratios in a clean ASCII scoreboard.
+- **🧠 Complete Agent Skills Roster for v2.0–v2.2**:
+  - Added `.agents/skills/muse-health`, `muse-drift`, `muse-why`, `muse-sync`, and `muse-mesh`.
+
+### 🌟 v2.1.0 Flagship Additions: Multi-Agent & Mesh Orchestration
+- **🤝 Cross-Agent Knowledge Sync & P2P Gossip Protocol (R14)**:
+  - Cryptographically sealed, portable `SyncPacket` engine with whole-packet SHA-256 integrity verification and vector clock causal ordering.
+  - Zero-daemon shared filesystem gossip pool (`.memory/sync_pool/`) allowing autonomous subagent teams (frontend, backend, test) to exchange insights asynchronously.
+  - Ingestion deduplication, inline Vibeguard secret scrubbing, and semantic contradiction tagging with mutual `conflict_ids`.
+  - CLI `memory sync` command suite & 4 MCP tools (`muse_sync_broadcast`, `muse_sync_ingest`, `muse_sync_status`, `muse_sync_pool`).
+- **🌐 Full Web Observability Studio (`memory studio`) (R15)**:
+  - Embedded zero-dependency visual web dashboard (`memory studio` or `memory ui`) with interactive control plane.
+  - Live 5-pillar health scorecard (A–F letter grade, PASS/WARN/FAIL gate status, and prioritized remediation checklist).
+  - Interactive ADR registry and bidirectional documentation $\longleftrightarrow$ code drift inspector.
+  - Historical "Why" reasoner query interface, recurring bug friction heatmap, and debt scanner.
+  - Real-time P2P gossip mesh status and interactive broadcast/shared pool sync controls.
+- **🕸️ Multi-Repo & Monorepo Cross-Project Mesh (R16)**:
+  - Passive automatic monorepo discovery across `pnpm`, `npm`, `bun`, `lerna`, and multi-repo sibling directories.
+  - Cross-project memory query resolver (`resolveMeshMemories`) with origin package provenance tags (`[mesh:@scope/package]`).
+  - Shared invariant and working constraint propagation (`propagateConstraintToMesh`) broadcasting critical security rules across all packages.
+  - Cross-package dependency contract and entrypoint export auditor (`auditMeshContracts`) validating cross-package imports and cross-repo code anchors.
+  - CLI `memory mesh` suite & 4 MCP tools (`muse_mesh_status`, `muse_mesh_query`, `muse_mesh_audit`, `muse_mesh_link`).
+
+### 🧠 v2.0.0 Major Cognitive Overhaul:
+- **🏥 Unified 5-Pillar Project Health Gate (`memory health` / `muse_health`)**: Single-call architectural audit across Store Integrity, Code Anchors, Doc-Code Alignment, Negative Sentry, and Technical Debt.
+- **🤔 Autonomous Engineering Cognition & "Why" Reasoner (`muse_why`)**: Reconstructs historical code evolution through past bug workarounds, accepted trade-offs, and timeless rules before refactoring.
+- **🏛️ First-Class Architecture Decision Records (`memory adr` / `memory_adr_record`)**: Living, queryable ADR entities with options considered, consequences, native code anchors, and supersession lineage.
+- **🔄 Bidirectional Documentation $\longleftrightarrow$ Code Drift Engine (`memory_drift_audit`)**: Continuously verifies alignment across 6 states (`DOCUMENTED`, `IMPLEMENTED`, `PARTIAL`, `CONFLICTING`, `STALE`, `MISSING`).
+- **🎯 Flagship Unified Context Orchestrator (`muse_context`)**: Single-call fused context injection with knapsack token budget packing.
+- **⚙️ Task-Focused MCP Profiles**: Dynamic role-based tool filtering (`core`, `coding`, `debugging`, `review`, `architecture`, `maintenance`).
+- **⚓ Native Structural Code Anchors (`src/anchors/`)**: Line-independent structural SHA-256 hashing insensitive to spacing/comments.
+- **🪜 Scoped Promotion & Extended Archival Lifecycle (`src/promotion/`)**: 3-tier promotion ladder (`local` $\rightarrow$ `project` $\rightarrow$ `global`), 5× repeated success policy, universal generalization, and `active` $\rightarrow$ `cold` $\rightarrow$ `dormant` $\rightarrow$ `archived` lifecycle with query rehydration.
+- **⚡ Hot Query Cache & SQLite WAL Optimization**: Microsecond memory lookups and high-throughput concurrent I/O.
 
 ---
 
 ## 📑 Table of Contents
 
-- [🚀 What's New in v2.0.0](#-whats-new-in-v200-autonomous-cognitive-engine-major-overhaul)
+- [🚀 What's New in v2.1.0 & v2.0.0](#-whats-new-in-v210--v200-autonomous-cognitive-engine-p2p-sync--monorepo-mesh)
 - [💡 What is Muse Memory? (TL;DR)](#-what-is-muse-memory-tldr)
 - [✨ Key Feature Highlights](#-key-feature-highlights)
 - [⚡ Quick Start & Installation](#-quick-start--installation)
@@ -62,36 +99,43 @@ Most AI chatbots and coding assistants have **"goldfish memory"**: every time yo
 **Muse Memory gives your AI assistants a persistent, self-organizing cognitive notebook directly on your machine.**
 
 ```
-┌─────────────────────────────────────────────────────────────┐
-│                    AI Agents & IDE Platforms                │
-│  (Claude Code, Cursor, Antigravity, Windsurf, Codex, CLI)   │
-└──────────────────────────────┬──────────────────────────────┘
-                               │ MCP stdio / Terminal CLI
-┌──────────────────────────────▼──────────────────────────────┐
-│                    Muse Memory Core Engine                  │
-│                                                             │
-│ ┌───────────────────┐ ┌──────────────────┐ ┌──────────────┐ │
-│ │  Retrieval Engine │ │ Vibeguard Secret │ │ Auto-Migrate │ │
-│ │ (Token Knapsack)  │ │ Defense Scanner  │ │  (29 Engines)│ │
-│ └───────────────────┘ └──────────────────┘ └──────────────┘ │
-│ ┌───────────────────┐ ┌──────────────────┐ ┌──────────────┐ │
-│ │ LifeCycle Machine │ │ Knowledge Wiki   │ │ Audit Ledger │ │
-│ │(State Transitions)│ │ (Obsidian/Entities│ │(audit.jsonl) │ │
-│ └───────────────────┘ └──────────────────┘ └──────────────┘ │
-└──────────────────────────────┬──────────────────────────────┘
-                               │ Atomic I/O
-┌──────────────────────────────▼──────────────────────────────┐
-│              Dual-Scope Storage Engine (.memory/)           │
-│                                                             │
-│  .memory/                                                   │
-│  ├── memory.db          # Primary SQLite cognitive database │
-│  ├── CURRENT.md         # Active hard constraints & handoff │
-│  ├── USER.md            # Persona & developer preferences   │
-│  ├── audit.jsonl        # Append-only operational audit trail│
-│  └── memories/          # Dual-persisted YAML export mirror │
-│      ├── m_1700000001000_auth.yaml                          │
-│      └── m_1700000002000_arch.yaml                          │
-└─────────────────────────────────────────────────────────────┘
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                 AI Agents, Subagent Pods & Autonomous Swarms                 │
+│        (Claude Code, Cursor, Antigravity, Windsurf, Codex, CLI)             │
+└───────────────────────┬─────────────────────────────────────┬───────────────┘
+                        │ MCP stdio / Terminal CLI            │ Local HTTP
+┌───────────────────────▼─────────────────────────────────────▼───────────────┐
+│                           Muse Memory Core Engine                           │
+│                                                                             │
+│ ┌──────────────────────┐ ┌──────────────────────┐ ┌───────────────────────┐ │
+│ │  Unified Context &   │ │ 5-Pillar Health Gate │ │ Autonomous Cognition  │ │
+│ │  Knapsack Retrieval  │ │  & ADR Drift Sentry  │ │   & "Why" Reasoner    │ │
+│ └──────────────────────┘ └──────────────────────┘ └───────────────────────┘ │
+│ ┌──────────────────────┐ ┌──────────────────────┐ ┌───────────────────────┐ │
+│ │   P2P Gossip Sync    │ │  Monorepo Workspace  │ │   Web Observability   │ │
+│ │  (Vector Clock Mesh) │ │  Cross-Project Mesh  │ │ Studio (memory studio)│ │
+│ └──────────────────────┘ └──────────────────────┘ └───────────────────────┘ │
+│ ┌──────────────────────┐ ┌──────────────────────┐ ┌───────────────────────┐ │
+│ │ Vibeguard Credential │ │ Dynamic Code Anchors │ │ Universal Migrator    │ │
+│ │    Secret Defense    │ │ & Structural Hashes  │ │     (29 Engines)      │ │
+│ └──────────────────────┘ └──────────────────────┘ └───────────────────────┘ │
+└──────────────────────────────────────┬──────────────────────────────────────┘
+                                       │ Atomic SQLite & File I/O
+┌──────────────────────────────────────▼──────────────────────────────────────┐
+│                     Dual-Scope Storage Engine (.memory/)                    │
+│                                                                             │
+│  .memory/                                                                   │
+│  ├── memory.db          # Primary SQLite database (WAL + FTS5 BM25)         │
+│  ├── CURRENT.md         # Real-time working constraints & session handoffs  │
+│  ├── USER.md            # Persona archetypes & working style preferences    │
+│  ├── sync_pool/         # Zero-daemon shared P2P gossip pool drop folder    │
+│  ├── mesh_links.json    # Explicit multi-repo cross-project mesh links      │
+│  ├── sync_peers.json    # Peer agent vector clock causal tracking ledger    │
+│  ├── audit.jsonl        # Append-only operational audit & compliance trail  │
+│  └── memories/          # Dual-persisted human-readable YAML mirror         │
+│      ├── m_1700000001000_auth.yaml                                          │
+│      └── m_1700000002000_mesh.yaml                                          │
+└─────────────────────────────────────────────────────────────────────────────┘
 ```
 
 ---
@@ -169,20 +213,6 @@ memory upgrade
 npx musememory upgrade
 ```
 
-```
-┌──────────────────────────────────────────────────────────────────┐
-│  🧠 MUSE MEMORY · SYSTEM LEVEL-UP & RECOVERY MATRIX              │
-└──────────────────────────────────────────────────────────────────┘
-
-  [████████████████████] 100% ✓ LEVEL 1: Vibeguard Security & Credential Audit [OK]
-  [████████████████████] 100% ✓ LEVEL 2: Package Manager Sync (bun/npm) [OK]
-  [████████████████████] 100% ✓ LEVEL 3: Synaptic Storage & Schema Alignment [OK]
-  [████████████████████] 100% ✓ LEVEL 4: 80+ Agent Platforms & Skills Auto-Wiring [OK]
-  [████████████████████] 100% ✓ LEVEL 5: Cognitive Ascendance Complete [OK]
-
-🏆 [LEVEL-UP COMPLETE] Muse Memory is now fully armed and up to date!
-```
-
 #### What `memory upgrade` automatically handles:
 1. **Package Manager Auto-Detection**: Detects whether your workstation runs `bun`, `npm`, `pnpm`, or `yarn` and pulls the latest published binary.
 2. **Self-Healing Storage Repair**: Recovers missing `.memory/`, `CURRENT.md` constraints, or `USER.md` persona files if corrupted or deleted.
@@ -360,18 +390,23 @@ memory migrate --all
 
 ---
 
-## 🌐 Cognitive Studio Dashboard (`memory ui`)
+## 🌐 Cognitive Studio Dashboard (`memory ui` / `memory studio`)
 
-Muse Memory includes an embedded, zero-dependency visual graph studio:
+Muse Memory includes an embedded, zero-dependency visual graph studio and observability dashboard:
 
 ```bash
-memory ui
-# or specify a custom port (default: 2222)
+memory studio
+# or alias:
 memory ui --port 2222
 ```
 
 Navigate to `http://localhost:2222` to access:
 - 🌐 **3D Force-Directed Knowledge Graph**: Orbital canvas physics, degree-scaled node radii, and link relationship viewer.
+- 🏥 **5-Pillar Project Health Gate**: Live architectural scorecard (Store Integrity, Native Anchors, Doc-Code Alignment, Anti-Pattern Sentry, Technical Debt) with A-F grading and PASS/WARN/FAIL status.
+- 🏛️ **ADR Registry & Drift Inspector**: First-class Architecture Decision Records and bi-directional code ↔ documentation drift auditor.
+- 🤔 **Autonomous "Why" Reasoner**: Traces historical evolution of symbols/files backwards through past bug fixes and trade-offs to explain architectural rationale before refactoring.
+- 🤝 **P2P Gossip Mesh Topology**: Real-time peer vector clocks, local agent identity, and one-click broadcast/shared pool sync.
+- 🕸️ **Monorepo & Cross-Project Mesh**: Workspace monorepo topology (pnpm, npm, bun, lerna), discovered package nodes, cross-project memory query, and contract drift audit.
 - ⚡ **Active Invariants & Real-Time Handoff**: Live `CURRENT.md` monitor tracking in-flight session status and agent checkpoints.
 - 📚 **Obsidian Wiki Browser**: Concept and entity page reader with full Markdown rendering.
 - 👤 **Persona Studio (`USER.md`)**: 5 archetype picker (`developer`, `designer`, `marketer`, `casual`, `custom`) and live editor.
@@ -403,6 +438,12 @@ When registered as an MCP server, `musememory` exposes the following native tool
 | `memory_archive` / `rehydrate` | **Archival Lifecycle** | Evaluates and manages `active` $\rightarrow$ `cold` $\rightarrow$ `dormant` $\rightarrow$ `archived` lifecycle with query rehydration. |
 | `memory_lifecycle_stats` / `sweep` | **Lifecycle Sweeper** | Reports store-wide lifecycle statistics and executes sweep transitions for aging memories. |
 | `anchor_create` / `verify` / `audit` | **Code Identity** | Creates, verifies, and audits line-independent structural code anchors. |
+| `muse_sync_broadcast` / `ingest` | **P2P Gossip Mesh** | Broadcasts and ingests portable sealed SyncPackets with deduplication and contradiction flagging. |
+| `muse_sync_status` / `pool` | **Sync Coordination** | Tracks peer vector clocks and synchronizes memories bidirectionally via shared drop-directory pool. |
+| `muse_mesh_status` | **Monorepo Topology** | Discovers monorepo workspaces and multi-repo sibling groups with package dependencies and stores. |
+| `muse_mesh_query` | **Cross-Project Query** | Queries memories across the entire workspace mesh with origin package provenance tags. |
+| `muse_mesh_audit` | **Contract Verification** | Audits cross-package dependency contracts, entrypoint exports, and cross-repo code anchors. |
+| `muse_mesh_link` | **Mesh Linking** | Explicitly links or unlinks external repository paths into the workspace mesh registry. |
 | `profile_list` / `profile_switch` | **Tool Management** | Lists and switches task-focused MCP profiles (`core`, `coding`, `debugging`, `review`, `architecture`, `maintenance`). |
 | `get_context` | **Session Start** | Fetches Top-$K$ ranked memories, `USER.md` profile, active `CURRENT.md` constraints, and supports `--tier 0|1|2`. |
 | `search` | **Investigation** | Searches memory units with query, token budget, project, type, and verification filters. |
@@ -447,7 +488,7 @@ When registered as an MCP server, `musememory` exposes the following native tool
 </details>
 
 <details>
-<summary><b>💻 Full CLI Command Matrix (42 Commands)</b> — <i>Click to expand</i></summary>
+<summary><b>💻 Full CLI Command Matrix (47 Commands)</b> — <i>Click to expand</i></summary>
 
 ```bash
 memory <command> [arguments] [flags]  # alias: musememory
@@ -456,6 +497,11 @@ memory <command> [arguments] [flags]  # alias: musememory
 | Command | Arguments / Flags | Description |
 | :--- | :--- | :--- |
 | `health` | `[--json] [--global]` | **Unified 5-Pillar Project Health Gate**: audits Store Integrity, Code Anchors, Drift, Sentry, and Tech Debt with A-F grading and pass/fail gate. |
+| `studio` / `ui` | `[--port N] [--global]` | **Web Observability Studio**: visual dashboard with 5-pillar health, ADR drift, why reasoner, and live mesh (default port: `2222`). |
+| `sync` | `[status\|broadcast\|ingest\|pool] [flags]` | **P2P Gossip Mesh**: peer vector clock status, packet export, ingestion, and shared pool gossip sync. |
+| `mesh` | `[overview\|query\|check\|link\|unlink\|propagate] [flags]` | **Monorepo & Multi-Repo Mesh**: workspace discovery, cross-project memory query, and contract drift audit. |
+| `adr` | `[record\|list\|supersede] [args]` | **Architecture Decision Records**: record, list, and supersede living architecture decisions. |
+| `anchor` | `[create\|verify\|audit] [args]` | **Code Anchors**: create, verify, and audit line-independent structural code anchors. |
 | `install` | `[path] [--global]` | **One-line complete setup**: initializes `.memory/`, `USER.md`, and auto-wires coding agents. |
 | `doctor` | `[path] [--global]` | **System diagnostic**: checks SQLite primary, schemas, secrets, and MCP connections. |
 | `uninstall` | `[agent] [--purge] [--dry-run]` | **Clean uninstaller**: unwires MCP configs (and optionally purges `.memory/`). |
@@ -465,7 +511,6 @@ memory <command> [arguments] [flags]  # alias: musememory
 | `agents` | *(none)* | Scan workstation for 80+ coding agents (Cursor, Claude Code, Antigravity, etc.). |
 | `detect` | *(none)* | Scan workstation and local workspace for 29 external memory systems. |
 | `migrate` | `[--provider P] [--all] [--dry-run] [--overwrite]` | Migrate memories into Muse Memory preserving active/archived state. |
-| `ui` | `[--port N] [--global]` | Launch 6-view Cognitive Studio dashboard (default port: `2222`). |
 | `context` | `[query] [--token-budget N] [--limit N] [--tier 0\|1\|2]` | Retrieve Top-$K$ ranked active context for prompt injection. |
 | `search` | `<query> [--limit N] [--token-budget N] [--type T]` | Ranked multi-factor token search with score breakdown. |
 | `search-transcript` | `<query> [file.jsonl] [--window N]` | Full-text search past transcripts with dialogue context windows. |
@@ -506,13 +551,18 @@ memory <command> [arguments] [flags]  # alias: musememory
 <details>
 <summary><b>🧠 Shipped Agent Skills (<code>.agents/skills/</code>)</b> — <i>Click to expand</i></summary>
 
-Muse Memory ships with 6 turnkey Agent Skills designed for coding agents (Claude Code, Cursor, Antigravity, OpenCode, Codex, Gemini CLI, etc.) under `.agents/skills/`:
+Muse Memory ships with 11 turnkey Agent Skills designed for coding agents (Claude Code, Cursor, Antigravity, OpenCode, Codex, Gemini CLI, etc.) under `.agents/skills/`:
 
 | Skill | Trigger Phase | Core Agent Responsibility |
 | :--- | :--- | :--- |
 | [`muse-ground`](.agents/skills/muse-ground/SKILL.md) | **Session Start** | Retrieves Top-$K$ relevant memories, active `USER.md` persona profile, and `CURRENT.md` constraints before writing code. |
 | [`muse-capture`](.agents/skills/muse-capture/SKILL.md) | **During Fixes & Refactors** | Captures atomic fix/architecture memories, validates evidence, runs Vibeguard secret scan, and supersedes obsolete knowledge. |
 | [`muse-current`](.agents/skills/muse-current/SKILL.md) | **Invariants & Handoffs** | Synchronizes hard constraints into `.memory/CURRENT.md` and persists structured handoffs across context resets. |
+| [`muse-health`](.agents/skills/muse-health/SKILL.md) | **Hardening Gates & PRs** | Evaluates 5-pillar architectural health (store, anchors, doc/code alignment, negative sentry, debt) and outputs remediation checklists. |
+| [`muse-drift`](.agents/skills/muse-drift/SKILL.md) | **System Architecture & ADRs** | Audits documentation $\longleftrightarrow$ code drift across 6 states, records living ADRs, and supersedes legacy architectural decisions. |
+| [`muse-why`](.agents/skills/muse-why/SKILL.md) | **Refactoring & Historical Context** | Reconstructs historical rationale, synthesizes past bug fixes and accepted trade-offs, and audits recurring bug friction clusters. |
+| [`muse-sync`](.agents/skills/muse-sync/SKILL.md) | **Multi-Agent & Swarm Gossip** | Coordinates cross-agent knowledge sync with whole-packet SHA-256 integrity, vector clocks, and P2P gossip mesh pool. |
+| [`muse-mesh`](.agents/skills/muse-mesh/SKILL.md) | **Monorepo & Multi-Repo Mesh** | Discovers monorepo workspaces, resolves cross-package memories with badges, and propagates shared security constraints. |
 | [`muse-graph`](.agents/skills/muse-graph/SKILL.md) | **AST Code Investigation** | Indexes `.codegraph`/`.graphify` symbols and queries symbol-matching decisions with `+0.2` graph overlap bonus. |
 | [`muse-wiki`](.agents/skills/muse-wiki/SKILL.md) | **Knowledge Compounding** | Compiles confirmed memories into Obsidian-compatible Markdown pages (`[[wikilinks]]`) and entity co-occurrence graphs. |
 | [`muse-brief`](.agents/skills/muse-brief/SKILL.md) | **Daily Hygiene & Loops** | Generates morning briefings, tracks 90/180-day staleness decay, and surfaces unresolved transcript commitments. |
@@ -550,7 +600,7 @@ memory user set "- Prefers TypeScript, Bun, and ultra terse responses"
 
 ```bash
 bun install
-bun test          # 322 passed across 58 test files (1305 assertions)
+bun test          # 497 passed across 84 test files (2190 assertions)
 bun run typecheck # 0 static type errors
 bun run build     # Clean bundled distribution build (dist/index.js)
 ```