memroot 0.1.0-alpha.0 → 0.1.0-alpha.3

package/dist/plugins/claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "memroot",
-  "version": "0.1.0-alpha.0",
-  "description": "Memroot installation status and capability discovery.",
+  "version": "0.1.0-alpha.3",
+  "description": "Memroot status, memory usage guidance and opt-in session capture.",
   "author": {
     "name": "Memroot"
   },

package/dist/plugins/claude/README.md

@@ -1,14 +1,18 @@
 # Memroot for Claude Code
 
-This is the complete, self-contained Memroot plugin root, version `0.1.0-alpha.0`. The setup utility copies this folder into a durable installation before native registration. Node.js is the only runtime requirement. No script refers to the npm cache or files outside this bundle.
+This is the complete, self-contained Memroot plugin root, version `0.1.0-alpha.3`. The setup utility copies this folder into a durable installation before native registration. Node.js is the only runtime requirement. Every script in `scripts/` is generated from the Memroot CLI source and bundled with its dependencies; no script refers to `npx`, the npm cache or files outside this bundle.
 
-The status skill and `node scripts/status.mjs` explain this release's capabilities. Installation status is available. Browser sign-in, cloud memory retrieval, session capture, extraction, and graph building are unavailable. The scripts do not read repository files, transcripts, credentials, or configuration, make network requests, or write data.
+The memroot-status skill and `node scripts/status.mjs` explain this release's capabilities. Setup registers the production MCP server with Claude Code (authorize it with `/mcp`); its tools provide explicit save and retrieval.
 
-The SessionStart hook supplies a short, static capability notice. It accepts at most 64 KiB of event JSON and waits at most 500 ms for stdin. Malformed inputs and unrelated events exit quietly. It never includes event fields in output. There is no Stop or SessionEnd handler because this release cannot capture or upload sessions.
+Hooks only read the stdin envelope (at most 64 KiB, waiting at most 500 ms) and never echo event fields. They print nothing on SessionEnd, never open a transcript and make no network request. When the user has opted in with `memroot capture on`, the SessionEnd hook writes one small job file (identifiers and paths only; 0600 under `$XDG_STATE_HOME/memroot/capture`) and starts the bundled `scripts/capture-worker.mjs` fully detached, resolved next to the hook script itself. Without consent it does nothing.
+
+The bundled worker reads only the referenced session transcript, keeps user and assistant text plus tool names and file paths (never tool output), redacts secrets, personal email addresses and home paths locally and fails closed, runs your own agent CLI headless with no tools to propose memories, validates them, and sends only typed memories labeled session-extracted (not user-attested) to `https://api.memroot.dev/mcp` with the separate Memroot CLI capture connection. Each memory includes up to 3 short evidence quotes (at most 200 characters) from the redacted transcript, repo-relative paths and symbols, the normalized repository remote, and salted hashes of the session id and quoted segments; one retrieval query per session contains only the repository name. Raw transcripts are never uploaded. At most 3 memories per session and 10 per 24 hours. `memroot capture off` stops capture and deletes queued work.
+
+The SessionStart hook supplies a short static context about memory retrieval. The SessionEnd hook stays within Claude Code's fixed 1.5 s SessionEnd budget (plugin timeouts cannot raise it); it typically returns in about 25 ms. Grok also loads this plugin from `~/.claude`; under Grok the scripts act for the Grok host and the SessionStart context stays silent.
 
 Inspect the installed plugin through the agent's native plugin interface.
 
-Official references verified September 13, 2026:
+Official references verified October 2, 2026:
 
 - [Plugin packaging and native installation](https://code.claude.com/docs/en/plugins-reference)
 - [Hook event and output contracts](https://code.claude.com/docs/en/hooks)

package/dist/plugins/claude/hooks/hooks.json

@@ -11,6 +11,16 @@
           }
         ]
       }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/session-end.mjs\""
+          }
+        ]
+      }
     ]
   }
 }