@hasna/mementos 0.17.1 → 0.17.3

package/README.md

@@ -92,6 +92,14 @@ mementos decisions evaluate --input pair.json --json
 mementos decisions disable
 ```
 
+For prompt hooks, `mementos prompt-context --enabled --input -` accepts JSON
+containing `prompt`, `project` and optional explicit scope filters. It returns a
+bounded, read-only context receipt. Without `--enabled` it performs no retrieval;
+provider decisions still require their separate opt-in. The Hooks app registers
+the native event with `hooks install mementos-context --target codex` (also
+`claude` or `codewith`). See the [prompt hook setup](../hooks/hooks/hook-mementos-context/README.md)
+for environment enablement, project scope, provider disclosure and native trust.
+
 `configure` always leaves assistance disabled. `enable` permits only the selected
 features and explicitly permits sending their text to the configured provider.
 The key is read from `OPENROUTER_API_KEY`; it is never saved in decision settings.
@@ -394,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/prompt-context.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerPromptContextCommand(program: Command): void;
+//# sourceMappingURL=prompt-context.d.ts.map

package/dist/cli/commands/prompt-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-context.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/prompt-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsCzC,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyBnE"}

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