musememory 3.2.0 → 3.3.0

package/docs/cli-reference.md

@@ -59,6 +59,8 @@ Context & Retrieval Commands:
   reindex                       Rebuild the local vector index (.memory/index.json) for hybrid search
   embed [status|build|reindex]  Manage semantic embeddings (llama.cpp / OpenAI-compatible endpoint; opt-in)
   recall [query]                Search active/confirmed memories with filters
+  preflight [files...]           Speculative context for the files being edited
+  project [name]                 Show or set the configured project identity
   search-transcript <query> [file.jsonl] [--window N] Full-text transcript search with bookends
 
 Wiki & Entity Knowledge Compounding:
@@ -97,8 +99,9 @@ Ecosystem, Migration & Connectivity:
   conflicts [--dry-run]        Inspect recorded contradictions; --dry-run previews what would be flagged
   reconcile [--prune] [--stale] Reconcile orphaned & drifted code anchors across memories
   benchmark [--iterations N]    Run microsecond speed, quality & token economy benchmark suite
+  playbook [--list|--tag T|<id>] [--success|--fail] Procedural playbooks: list, inspect or record an outcome
   scan-secrets [dir] [--json]   Native Vibeguard secret scanner (zero external dependencies)
-  terrain [--out file.md]       Collect machine hardware, toolchain & agent ecosystem map
+  terrain [--workspace] [--out]  Machine terrain, or --workspace for the six workspace maps
   code-impact <file> [--symbol] Synthesize code callers, ADRs, negative warnings & risk score
   pr-context [--base B] [--out] Generate memory-verified PR description from git diff
   mcp                           Run stdio MCP server for agent platforms
@@ -112,7 +115,7 @@ Version Control (R23):
 
 ## MCP tools
 
-**115 tools** are registered, exposed through **7 task-focused profiles** (`core`, `coding`, `debugging`, `review`, `architecture`, `maintenance`, `full`). The authoritative machine-readable list is [`mcp-tool-matrix.json`](./mcp-tool-matrix.json).
+**119 tools** are registered, exposed through **7 task-focused profiles** (`core`, `coding`, `debugging`, `review`, `architecture`, `maintenance`, `full`). The authoritative machine-readable list is [`mcp-tool-matrix.json`](./mcp-tool-matrix.json).
 
 Select a profile with the `MUSE_MCP_PROFILE` environment variable. Call `muse_profile_list` for the live mapping.
 
@@ -223,9 +226,9 @@ Select a profile with the `MUSE_MCP_PROFILE` environment variable. Call `muse_pr
 | `memory_adr_list` | `target` | List all Architecture Decision Records (ADRs) recorded in the memory store, optionally filtered by status |
 | `memory_drift_audit` | `target` | Run bidirectional documentation <-> code drift audit: verifies if documented decisions are implemented in code and flags missing/stale/conflicting code or docs |
 | `muse_why` | `target` | Autonomous Engineering Cognition: Explain WHY code was designed or modified the way it is by tracing historical bug fixes, ADRs, trade-offs, and invariants |
-| `muse_bug_clusters` | `packet` | Analyze and cluster recurring bug fixes, negative lessons, and failures into architectural fragility hotspots with root-cause hypotheses |
-| `muse_tech_debt` | `packet` | Scan repository and memory store for technical debt indicators (TODO/FIXME/HACK, unsafe 'as any' casts, drifted code anchors) and generate refactoring priorities |
-| `muse_health` | `packet` | Unified 5-Pillar Project Health Gate: audit memory store integrity, code anchor validity, documentation drift, anti-pattern sentry, and technical debt with overall grade (A-F) and pass/fail gate status |
+| `muse_bug_clusters` | — | Analyze and cluster recurring bug fixes, negative lessons, and failures into architectural fragility hotspots with root-cause hypotheses |
+| `muse_tech_debt` | — | Scan repository and memory store for technical debt indicators (TODO/FIXME/HACK, unsafe 'as any' casts, drifted code anchors) and generate refactoring priorities |
+| `muse_health` | — | Unified 5-Pillar Project Health Gate: audit memory store integrity, code anchor validity, documentation drift, anti-pattern sentry, and technical debt with overall grade (A-F) and pass/fail gate status |
 | `muse_code_impact` | `file_path` | Evaluates comprehensive code and memory impact before editing: callers, test suites, ADRs, negative warnings, active constraints, and composite risk level |
 | `muse_pr_context` | — | Generates rich GitHub PR descriptions from git diff linking touched code anchors, respected ADRs, tested invariants, and composite risk assessment |
 | `muse_reconcile_anchors` | — | Interactively audits, prunes, or updates drifted and orphaned code anchors across memories when code is refactored or deleted |
@@ -261,6 +264,15 @@ Select a profile with the `MUSE_MCP_PROFILE` environment variable. Call `muse_pr
 | `graph_index` | `query` | Index AST symbols from the project's CodeGraph/Graphify provider and cache in .memory/ |
 | `muse_profile_list` | `title`, `context_and_drivers`, `decision`, `consequences` | List all available task-focused MCP profiles (core, coding, debugging, review, architecture, maintenance, full) and their exposed tools |
 
+### Other
+
+| Tool | Required parameters | Description |
+| --- | --- | --- |
+| `muse_preflight` | — | Read-only pre-flight: anchored invariants, blast-radius risk and a token-budgeted context pack for the files about to be edited |
+| `muse_episodes` | `packet` | Recall recent episodic narratives (goal → hypothesis → trajectory → verification → retrospective) built from observations |
+| `muse_playbook_recall` | `packet` | Recall procedural playbooks: list by tag, or fetch one by id/title |
+| `muse_playbook_record` | `packet` | Save a playbook trajectory, or record success/failure for an existing playbook |
+
 ---
 
-Counts in this file are generated from the same source as [`claims.json`](../claims.json): 115 tools, 7 profiles, 30 import formats, 8 credential rule families.
+Counts in this file are generated from the same source as [`claims.json`](../claims.json): 119 tools, 7 profiles, 30 import formats, 8 credential rule families.

package/docs/mcp-tool-matrix.json

@@ -1,6 +1,6 @@
 {
   "$comment": "Generated by scripts/generate-claims.ts — the authoritative MCP tool list.",
-  "count": 115,
+  "count": 119,
   "tools": [
     "confirm_fix",
     "get_context",
@@ -100,13 +100,17 @@
     "muse_code_for_memory",
     "muse_code_impact",
     "muse_context",
+    "muse_episodes",
     "muse_health",
     "muse_memory_for_code",
     "muse_mesh_audit",
     "muse_mesh_link",
     "muse_mesh_query",
     "muse_mesh_status",
+    "muse_playbook_recall",
+    "muse_playbook_record",
     "muse_pr_context",
+    "muse_preflight",
     "muse_profile_list",
     "muse_reconcile_anchors",
     "muse_sync_broadcast",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musememory",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "Autonomous, self-organizing cognitive memory system for AI agents and agency networks",
   "main": "dist/index.js",
   "type": "module",

package/schema.json

@@ -15,6 +15,7 @@
     "salience": { "type": "number", "minimum": 0, "maximum": 1 },
     "created_at": { "type": "string", "format": "date-time" },
     "updated_at": { "type": "string", "format": "date-time" },
+    "asserted_at": { "type": "string", "format": "date-time" },
     "valid_from": { "type": "string", "format": "date-time" },
     "valid_to": { "type": "string", "format": "date-time" },
     "valid_to_exact": { "type": "boolean" },