musememory 3.0.2 → 3.3.0

package/docs/agent-reference.md

@@ -58,6 +58,25 @@ An agent integrating Muse must follow this order.
 constraints, ranked memories, negative lessons and code anchors, and is what
 task-shaped profiles (`coding`, `debugging`, `review`, `architecture`) expose.
 
+### The delivery contract
+
+**A commit is not a delivery.** Work is *landed* only when it is reachable from
+the integration branch **on the remote**. Until then it is *local* — and it
+must be described as local, in every artifact and every report.
+
+Before describing work as landed, shipped, merged or released, run the gate:
+
+```bash
+bun run check:landed
+```
+
+It exits non-zero when the work cannot be proven delivered, and prints the
+exact commands and SHAs to quote. The words *landed / shipped / merged /
+released / "verified on `dev`"* are only earned after it exits 0.
+
+The same contract applies to this repository's own agent standards — see
+[`.agents/standards/landing-gate.md`](../.agents/standards/landing-gate.md).
+
 ## 4. CLI
 
 ```
@@ -79,8 +98,12 @@ Full matrix: [`cli-reference.md`](./cli-reference.md).
 | `memory current get` / `memory current set "<text>" --project P` | Read/write active constraints. |
 | `memory link <id> --related <id1,id2>` | Bidirectional relation between entries. |
 | `memory audit [--operation OP] [--entry-id ID]` | Query the append-only audit ledger. |
+| `memory conflicts [--dry-run]` | List recorded contradictions; `--dry-run` previews what would be flagged. |
 | `memory doctor` | Full ecosystem health diagnostic. |
 | `memory harvest "<text>" --project P` | Distil a turn into a fix/decision unit. |
+| `memory user [get|init|set]` | Manage `USER.md` persona archetypes & working style preferences. |
+| `memory scan-secrets [dir]` | Native Vibeguard secret scanner (zero external dependencies). |
+| `memory terrain [--out file.md]` | Collect host hardware, toolchain & agent ecosystem terrain map. |
 | `memory verify <id> --strict` | Run an entry's verification command, or the full integrity gate. |
 
 ### Global flags that change behaviour
@@ -191,9 +214,22 @@ propose → candidate → confirmed → superseded
 ```bash
 memory doctor            # storage, schemas, secrets, agent wiring
 memory health            # 5-pillar health gate, letter grade
+memory health --project P  # ...scoped to one memory project
 memory stats             # counts by status and type
 memory context --query "how does auth work" --budget 2000
 ```
 
 A healthy install reports: SQLite reachable, schema version current, no
 secrets in the store, and the expected agents wired.
+
+The health report states its own scope in `scope`: `filter` (the requested
+project, or `null` for the whole store), `projects` (every project whose
+memories were considered) and `entry_count`. Read it before comparing two
+numbers — an unscoped report covers every project in the store.
+
+The same `project` filter is available on every audit surface: the
+`muse_health`, `muse_tech_debt`, `muse_bug_clusters`, `memory_anchor_audit` and
+`memory_drift_audit` MCP tools, and the studio's `/api/health`, `/api/drift`,
+`/api/cognition/clusters` and `/api/cognition/debt` endpoints
+(`?project=P`). Code-side metrics stay workspace-wide by design — source code
+is shared between projects — so `scope.code_scope` always reads `workspace`.

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:
@@ -93,9 +95,13 @@ Ecosystem, Migration & Connectivity:
   daemon [--port N]             Real-time agency hub (SSE event stream + publish API, default port 7878)
   sync [status|broadcast|ingest|pool] Cross-agent knowledge sync & P2P gossip mesh
   mesh [query|check|link|unlink|propagate] Multi-repo & monorepo cross-project mesh
-  health                        Run unified 5-pillar architectural health evaluation
+  health [--project P]         Run unified 5-pillar architectural health evaluation; --project scopes it to one memory project
+  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 [--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
@@ -109,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.
 
@@ -220,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 |
@@ -258,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.0.2",
+  "version": "3.3.0",
   "description": "Autonomous, self-organizing cognitive memory system for AI agents and agency networks",
   "main": "dist/index.js",
   "type": "module",
@@ -21,13 +21,17 @@
     "build:gif": "bun run --cwd apps/website scripts/build-readme-gif.ts",
     "claims:generate": "bun scripts/generate-claims.ts && bun scripts/generate-cli-reference.ts",
     "claims:check": "bun scripts/generate-claims.ts --check",
+    "check:landed": "bun run scripts/check-landed.ts",
+    "check:landed:pr": "bun run scripts/check-landed.ts --pr",
     "docs:check": "bun scripts/check-doc-links.ts",
     "test": "bun test",
     "typecheck": "tsc --noEmit",
     "validate": "bun run dist/index.js validate --dry-run",
     "start": "bun run dist/index.js mcp",
     "prepublishOnly": "bun run build && bun test",
-    "site:qa": "bun run --cwd apps/website scripts/qa-gate.ts"
+    "site:qa": "bun run --cwd apps/website scripts/qa-gate.ts",
+    "showreel:hash": "bun scripts/showreel-hash.ts",
+    "showreel:hash:write": "bun scripts/showreel-hash.ts --write"
   },
   "bin": {
     "memory": "dist/index.js",
@@ -63,6 +67,9 @@
     "url": "git+ssh://git@github.com/harshsinghmp/musememory.git"
   },
   "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "ajv": "^8.17.1",

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" },