@hasna/mementos 0.17.2 → 0.17.3

package/README.md

@@ -402,3 +402,33 @@ Development entry points are `bun run dev:cli`, `bun run dev:mcp`, and
 ## License
 
 Apache-2.0 — see [LICENSE](LICENSE).
+
+## Claude Code Stop hook
+
+Preview the installed CLI's managed hook configuration:
+
+```sh
+mementos session setup-hook --claude
+```
+
+Apply that exact preview with `--apply --expect-settings-sha256 <digest>`
+(or `absent` for a new settings file). A recognized legacy hook also requires
+`--expect-hook-sha256 <digest>`. The installer preserves unrelated settings,
+retains the original settings as a private backup, and refuses custom or changed
+hook files. A symlinked `.claude` directory is preserved and requires the preview's
+`--expect-directory-sha256 <digest>`; retargeting the alias invalidates the preview
+even when its settings have identical bytes. `mementos init` uses the same installer and does not start a local
+server when a hosted API is configured.
+
+The portable command is `mementos session stop-hook --claude`; the installed CLI
+must be on Claude's PATH. It reads the native `transcript_path` and final assistant
+text, excludes tool payloads, redacts known secret patterns, and submits through
+the normal hosted credential resolver. It never ingests the hook envelope as a
+conversation, falls back to a local store, or automatically retries an ambiguous
+submission. HTTP failures and invalid receipts emit a fixed, private-data-free
+error and exit 1. This reports failure without blocking Claude's Stop; see the
+[Claude hook exit-code contract](https://code.claude.com/docs/en/hooks#exit-code-output).
+The hook reads at most 8 MiB of transcript and 64 KiB of input context.
+When `MEMENTOS_AGENT` is configured, the hook preserves that agent attribution.
+The installer also recognizes the historical CLI-ingest migration shim by its
+exact digest; modified copies remain protected as custom hooks.

package/dist/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqR1D"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8L1D"}

package/dist/cli/commands/system-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-session.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/system-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmI7D"}
+{"version":3,"file":"system-session.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/system-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwI7D"}