musememory 3.0.2 → 3.2.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

@@ -93,9 +93,12 @@ 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
+  scan-secrets [dir] [--json]   Native Vibeguard secret scanner (zero external dependencies)
+  terrain [--out file.md]       Collect machine hardware, toolchain & agent ecosystem map
   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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musememory",
-  "version": "3.0.2",
+  "version": "3.2.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",