musememory 1.11.0 → 2.1.0

package/.agents/standards/system-design.md

@@ -0,0 +1,67 @@
+# 📐 System, Domain & Resilience Design Standards
+
+> Synthesized from: Eric Evans' *Domain-Driven Design*, Michael Nygard's *Release It!*, and High-Reliability Distributed Systems Engineering.
+
+---
+
+## 1. Domain-Driven Design Principles (Eric Evans)
+
+### Ubiquitous Language & Bounded Contexts
+- **Ubiquitous Language**: Code entities, method names, and test descriptions must use the exact business terminology of the domain expert within that bounded context.
+- **Explicit Context Boundaries**: A domain model is valid only inside its own bounded context. Never create a company-wide "god" model. Translate across context boundaries using explicit Anti-Corruption Layers (ACL) or Published Languages.
+- **Core Domain Distillation**: Focus rich modeling on the core strategic domain; keep supporting and generic subdomains lightweight.
+
+### Building Blocks
+- **Entities**: Objects with persistent identity over time. Entities must protect their own valid state transitions (no public setters for arbitrary mutations).
+- **Value Objects**: Immutable objects defined strictly by their attributes. Construction must guarantee validity; equality is determined by value.
+- **Aggregates & Consistency Boundaries**: Aggregates are strict consistency boundaries. Keep them as small as possible. All modifications must route through the aggregate root; reference other aggregates by identity only.
+- **Repositories**: Repositories exist for aggregate roots, not individual database tables. Return domain objects, not raw database rows or ORM records.
+- **Domain Services**: Use domain services only for business logic that naturally spans multiple entities or value objects.
+
+---
+
+## 2. Production Stability & Resilience (Michael Nygard)
+
+### Stability Mindset
+Assume production is hostile and fragile: every dependency can be slow, every queue can fill, every cache can miss or stampede.
+
+### Dependency Protection
+- **Mandatory Timeouts**: Every outbound network call, database query, or inter-service request MUST have an explicit, intentional timeout. Infinite waits are strictly forbidden.
+- **Disciplined Retries**: Retry only idempotent operations. Always apply exponential backoff with random jitter to prevent retry storms. Never retry permanent 4xx or validation failures.
+- **Circuit Breakers**: Protect unstable downstreams by tripping to fast-fail mode when error rates spike.
+- **Bulkheads & Isolation**: Isolate slow or failure-prone dependencies in dedicated resource pools so one failing third-party does not exhaust the entire system's thread or connection pool.
+
+### Overload & Capacity Control
+- **Back Pressure**: Implement explicit back pressure when producers outpace consumers.
+- **Load Shedding**: Gracefully reject low-priority requests under extreme load to preserve core system availability.
+- **Dead-Letter Queues**: Every asynchronous queue must define poison-message handling and a dead-letter queue.
+
+---
+
+## 3. Explicit Persistence & Data Mapping Boundaries
+
+- **Named Mapping Methods**: Persistence-layer ↔ domain-model conversions (Payload CMS, Neon, Supabase, SQLite, ORMs) MUST use explicit named methods (e.g., `fromRecord()`, `toRecord()`, `toDTO()`).
+- **Prohibited**: Implicit casting, unchecked `as unknown as Type`, or field-by-field object spreading (`{ ...dbRow }`) across architectural boundaries.
+- **Data Protection**: Prevent internal database columns, metadata, or sensitive properties from leaking to client components or public API responses.
+
+---
+
+## 4. Database Safety & Migration Rehearsal Protocol
+
+- **Rehearsal Before Proposal**: Before proposing or applying database migrations (Drizzle, Prisma, SQL), rehearse the full migration history against a fresh throwaway database (`npx create-db@latest --json` or local isolated container) and verify test passes.
+- **Destructive Operation Gate**: Never run destructive operations (`DROP TABLE`, `TRUNCATE`, `db push --accept-data-loss`, `migrate reset`) on staging or production without explicit authorization.
+- **Zero Inlined Credentials**: Store connection strings strictly in `.env.local` or environment secrets. Never commit connection URIs to version control.
+
+---
+
+## 5. Mathematical & Algorithmic Exactness
+
+- **Concrete Scoring Formulas**: Algorithms for ranking, cache invalidation, or relevance must use explicit mathematical weights and decay constants ($Score = \sum W_i \cdot S_i \times e^{-\lambda \Delta t}$).
+- **Determinism & Fallback Parity**: Accelerators (e.g., SQLite FTS5 or vector indices) must maintain output parity with zero-dependency fallbacks.
+
+---
+
+## 6. API & Library Fidelity (Zero Hallucinated Options)
+
+- **Exact Constructor Signatures**: Verify configuration keys against installed `.d.ts` definitions or local package documentation before use.
+- **Dual-Layer Specifications**: Pair human-readable YAML/JSON examples with formal machine-checkable schemas (Zod, JSON Schema, Pydantic) validated via automated tests.

package/.agents/standards/tech-stacks.md

@@ -0,0 +1,52 @@
+# 🚀 Agency Tech Stack Directions & Architectural Standards
+
+All digital products and client builds follow one of three designated architectural directions. All tooling is kept at the latest stable version.
+
+---
+
+## 🧭 Direction 1: Modern Web & High-Performance Astro
+
+> **Best For**: High-speed marketing platforms, content ecosystems, portals, and interactive agency web applications.
+
+### Core Toolchain & Stack
+- **Framework**: **Astro v7.2.x** (Server-first, content collections, hybrid rendering)
+- **Styling**: **UnoCSS v66.x** + Custom Semantic BEM CSS tokens
+- **Animations**: **Motion.dev** (Framer Motion engine for high-end web interactions)
+- **UI & Accessibility**: **Aria Builder `@latest`** (WCAG 2.2 AA compliant accessible components)
+- **Testing**: **Vitest** (Unit, component, and utility tests)
+- **Runtime & Deployment**: **`@astrojs/cloudflare`** on **Cloudflare Free Tier** or **GitHub Pages**
+- **Persistence & Analytics**: SQLite DB (when local storage/edge persistence is needed) + Cloudflare Web Analytics
+
+---
+
+## ⚡ Direction 2: Instatic (Pure HTML / Brochure & Static Sites)
+
+> **Best For**: Pure HTML brochure sites, lightweight marketing landing pages, and zero-JS static client deliverables.
+
+### Core Toolchain & Stack
+- **Engine**: **[Instatic](https://github.com/corebunch/instatic)** — Pure HTML-based static site generator
+- **Delivery**: Semantic HTML5, CSS3, minimal vanilla JS
+- **Hosting**: Cloudflare Pages / GitHub Pages (Zero compute overhead, sub-millisecond TTFB)
+- **Principle**: Zero runtime dependencies, 100/100 Lighthouse performance score by default.
+
+---
+
+## 🛍️ Direction 3: Headless E-Commerce & Dynamic CMS
+
+> **Best For**: Direct-to-Consumer (D2C) e-commerce brands, high-scale digital stores, and content-managed portals.
+
+### Core Toolchain & Stack
+- **CMS & Backend**: **Payload CMS** with official E-Commerce Module
+- **Frontend Framework**: **Next.js** (App Router, Server Components by default)
+- **Styling & Motion**: **UnoCSS** + **Motion.dev**
+- **Type Safety & Validation**: **Zod** (strict schema validation at all API boundaries)
+- **Testing**: **Vitest** (Unit, integration, and API tests)
+- **Database**: **Neon** (Serverless PostgreSQL) or **Supabase**
+- **Hosting & Infrastructure**: **Cloudflare Free / Low-Cost Tier** + edge caching for zero-to-low operational cost
+
+---
+
+## 🔒 Tech Stack Invariants
+1. **No Speculative Dependencies**: Do not introduce unlisted frameworks or heavy third-party runtime libraries without explicit human authorization.
+2. **Edge-First Hosting**: Default to Cloudflare edge deployment across all three directions to maintain zero-to-low infrastructure costs.
+3. **Accessibility Baseline**: WCAG 2.2 AA compliance is mandatory across all user-facing components.

package/.agents/standards/workflows.md

@@ -0,0 +1,54 @@
+# 🔄 Agent Development Workflows & Phase Gates
+
+> **Lifecycle Doctrine**: Every engineering task moves through deterministic phases scaled to its classification tier. Bypassing quality gates is strictly prohibited.
+
+---
+
+## 1. Scaled Task Classification Tiers
+
+To balance velocity with rigor, overhead is strictly proportional to task risk:
+
+| Classification | Scope & Criteria | Required Phases & Gates |
+| :--- | :--- | :--- |
+| **`tiny-fix`** | < 3 files, typo, CSS token tweak, no semantic/logic change | Direct edit + 1-line verification check. Skips heavy planning. |
+| **`quick-win`** | < 1 module, localized bug fix, small feature enhancement | Scoping → Implement → Targeted Test & Review. |
+| **`feature`** | Multi-file additions, new endpoints, stateful UI flows | Full 5-Phase Pipeline (Scoping → Plan → Implement → Review → Ship). |
+| **`architecture-change`** | Core schemas, database migrations, auth, global router/build refactors | Full 5-Phase Pipeline + Architecture Decision Record (ADR) + Nexus Gate. |
+
+---
+
+## 2. The 5-Phase Execution Pipeline
+
+```
+[ 📋 1. Scoping & Intake ] ──► [ 📐 2. Plan ] ──► [ ⚡ 3. Implement ] ──► [ 🛡️ 4. Review & Hardening ] ──► [ 🚢 5. Ship & Archive ]
+```
+
+### Phase 1: 📋 Scoping & Intake (Muse)
+- **Decomposition Gate**: For multi-feature requests, decompose the input into a structured Feature Inventory before writing individual specifications.
+- **Classification Freeze**: Lock task classification (`tiny-fix`, `quick-win`, `feature`, `architecture-change`). Silent scope expansion mid-implementation is prohibited. If scope grows, pause and notify the user.
+- Identify the target tech direction (Astro / Instatic / Payload + Next.js).
+- Load active constraints from `./.agents/context/` and `./.memory`.
+
+### Phase 2: 📐 Plan & Design
+- For `feature` and `architecture-change` tasks, generate an implementation plan inside `.agents/artifacts/`.
+- Satisfy the **Task Start Gate**:
+  1. **Goal**: What exact outcome is required?
+  2. **Mechanism**: What is the root cause / structural design?
+  3. **Proof**: What exact automated or visual observation proves success?
+
+### Phase 3: ⚡ Implement (Sol / Jasper)
+- Apply **The Confidence Gate** (<80% Stop, 80-90% State Assumption, >90% Proceed).
+- Apply **Read-Before-Write**: Inspect target files, imported types, and callers before modifying code.
+- Apply **Preparatory Refactoring**: Restructure cleanly before introducing functional changes.
+- Respect code limits (pure UI components < 200 lines, custom hooks `use<Feature><Action>`).
+
+### Phase 4: 🛡️ Review & Hardening (Nexus Quality Gate)
+- Run targeted automated tests (`bun test` / `vitest`).
+- Run the Vibeguard SecretScan (`bun ~/.config/LIFEOS/runtime/TOOLS/SecretScan.ts .`).
+- Verify WCAG 2.2 AA accessibility and responsive mobile breakpoints.
+
+### Phase 5: 🚢 Ship & Archive (Crew)
+- Create structured Conventional Commits following the Git standard.
+- **Archive Work Artifacts**: Move completed plans or temporary scratchpads into `.agents/archive/` using the timestamped format `[title]-[YYYYMMDD-HHMMSS].md`.
+- **DOX Pass**: Update `./.agents/context/current.md` and the nearest owning `AGENTS.md`.
+- **Memory Update**: Persist newly confirmed invariants or architectural decisions into `./.memory`.

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-368%20Passed-brightgreen?style=for-the-badge&logo=checkmarx)
+![CI Tests](https://img.shields.io/badge/Tests-480%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,22 +24,23 @@
 
 ---
 
-## 🚀 What's New in v1.11.0 (Cognitive Engine Evolution & Hardening)
+## 🚀 What's New in v2.0.0 (Autonomous Cognitive Engine Major Overhaul)
 
-- **📜 Provenance & Source Ledger (`.memory/sources.json` / `memory source`)**: Records all external documentation, research papers, RFCs, and authoritative URLs with retrieval timestamps, authors, and classification tags.
-- **🔍 Evidence-Grounded Claim Ledger (`.memory/claims.json` / `memory claim`)**: Connects atomic memories to verifiable claims tagged with strict confidence ratings: `[RAW]` (locally verified), `[FETCH]` (authoritative URL), `[SEARCH]` (search-synthesized), and `[INFER]` (agent deduction).
-- **⚡ Deterministic Tiered Retrieval Engine (`--tier 0|1|2`)**: Bounded 3-tier retrieval prevents context stuffing: **Tier 0 (Manifest)** index (~50 tokens), **Tier 1 (Routing Set)** (~300 tokens), and **Tier 2 (Bounded Bodies)** fitted greedily into the knapsack token budget.
-- **🧊 Frozen Execution Snapshots (`memory freeze`)**: Captures immutable run state (`.memory/runs/<run-id>/snapshot.json`) combining task specs, workspace file inventory, git SHA, active constraints, and SHA-256 memory hashes for deterministic regression replay.
-- **📝 Native Structured Prompt Registry (`memory prompt`)**: Reusable structured prompt templates with live memory context injection (includes built-in `morning-standup`, `drift-audit`, `pre-publish-audit`, `sprint-compounding`).
-- **⏳ Multi-Scale Temporal Compounding (`memory rollup`)**: Aggregates atomic session memories into weekly (`YYYY-Www.md`), monthly (`YYYY-MM.md`), and quarterly (`YYYY-QN.md`) synthesis wiki pages, and compiles the `.memory/HOT.md` instant working memory cache.
-- **🔄 Gauntlet Iteration Ledger & Plateau Detector (`memory loop`)**: Multi-agent improvement loop ledger (`.memory/iterations.jsonl`) that detects plateaus and regression signals to halt runaway token consumption.
-- **🛡️ Strict Integrity & Health Gate (`memory verify --strict`)**: Zero-tolerance audit verifying zero secret credentials, referential link integrity, wikilink resolution, orphaned candidate retention, and claim-to-source completeness.
+- **🏥 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.
 
 ---
 
 ## 📑 Table of Contents
 
-- [🚀 What's New in v1.11.0](#-whats-new-in-v1110-cognitive-engine-evolution--hardening)
+- [🚀 What's New in v2.0.0](#-whats-new-in-v200-autonomous-cognitive-engine-major-overhaul)
 - [💡 What is Muse Memory? (TL;DR)](#-what-is-muse-memory-tldr)
 - [✨ Key Feature Highlights](#-key-feature-highlights)
 - [⚡ Quick Start & Installation](#-quick-start--installation)
@@ -359,18 +360,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.
@@ -382,12 +388,33 @@ Navigate to `http://localhost:2222` to access:
 ## 📖 Deep Technical References & Documentation
 
 <details>
-<summary><b>🔌 Complete MCP Tool Reference (40 Tools)</b> — <i>Click to expand</i></summary>
+<summary><b>🔌 Complete MCP Tool Reference (61 Tools across 6 Profiles)</b> — <i>Click to expand</i></summary>
 
-When registered as an MCP server, `musememory` exposes the following native tools:
+When registered as an MCP server, `musememory` exposes the following native tools (filtered dynamically into role-tailored profiles to eliminate tool bloat):
 
 | MCP Tool | Execution Phase | Description |
 | :--- | :--- | :--- |
+| `muse_context` | **Flagship Fusion** | Single-call fused orchestrator combining search, active file, symbol, error messages, and task intent under strict knapsack token budgets. |
+| `muse_health` | **Quality Gate** | 5-Pillar Project Health Gate: audits store integrity, code anchors, doc/code alignment, anti-pattern sentry, and technical debt with A-F grading and pass/fail status. |
+| `muse_why` | **Cognition / "Why"** | Explains *why* code was designed the way it is by reconstructing past ADRs, bug fixes, trade-offs, and timeless rules. |
+| `muse_bug_clusters` | **Fragility Hotspots** | Categorizes recurring bugs into 5 root causes with subsystem fragility scoring. |
+| `muse_tech_debt` | **Technical Debt** | Scans code and memory for TODO/FIXME markers, unsafe `as any` casts, and drifted anchors. |
+| `muse_memory_for_code`| **Code-to-Memory** | Queries all memories, ADRs, constraints, and bugs associated with a code file and symbol. |
+| `muse_code_for_memory`| **Memory-to-Code** | Resolves all native code anchors and affected source files for a given memory entry. |
+| `memory_adr_record` / `list` | **Architecture Decisions** | Records and queries first-class Architecture Decision Records with native code anchors and options considered. |
+| `memory_drift_audit` | **Drift Engine** | Audits bi-directional documentation $\longleftrightarrow$ code drift across 6 alignment states (`DOCUMENTED`, `IMPLEMENTED`, `PARTIAL`, `CONFLICTING`, `STALE`, `MISSING`). |
+| `memory_capture_negative` | **Negative Sentry** | Records failed approaches, anti-patterns, and reproduction commands to prevent repeating mistakes. |
+| `memory_promote_scope` | **Scoped Promotion** | Promotes memory along 3-tier ladder (`local` $\rightarrow$ `project` $\rightarrow$ `global`) with 5× repeated success policy and universal generalization. |
+| `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. |
 | `memory_current` | **Constraints** | Reads or appends active project working constraints (`CURRENT.md`). |
@@ -431,7 +458,7 @@ When registered as an MCP server, `musememory` exposes the following native tool
 </details>
 
 <details>
-<summary><b>💻 Full CLI Command Matrix (41 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
@@ -439,6 +466,12 @@ 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/`). |
@@ -448,7 +481,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. |