Prepare agent-neutral hardening release

docs/integrations/codex-intelligent-memory.md

@@ -0,0 +1,72 @@
+# Codex Intelligent Memory Protocol
+
+Codex can connect to Vestige through MCP, but MCP registration alone only makes
+the tools available. It does not make Codex automatically reason with memory.
+
+Use this protocol when configuring a Codex workspace that should behave like it
+has long-term cognitive memory.
+
+## 1. Register Vestige MCP
+
+```toml
+[mcp_servers.vestige]
+command = "/absolute/path/to/vestige-mcp"
+```
+
+Restart Codex after changing MCP configuration.
+
+## 2. Add An `AGENTS.md` Trigger
+
+Codex reads `AGENTS.md` files as workspace instructions. Put a file at the repo
+root, or a higher workspace root, with a rule like:
+
+```markdown
+Before answering substantive prompts, consult Vestige using the current prompt
+plus project and user context. Use `session_context` for broad context, `search`
+for quick memory checks, and `deep_reference` for decisions, contradictions, or
+accuracy-sensitive questions. Compose memories into actions; do not summarize
+retrievals.
+```
+
+This is the Codex equivalent of the lightweight top-bread memory trigger.
+
+## 3. Use A Query Router
+
+Use the smallest call that can change the answer:
+
+- `session_context`: start of a topic or project switch.
+- `search`: identity, preference, exact memory, or quick project context.
+- `deep_reference` / `cross_reference`: decision history, contradictions,
+  timelines, or root-cause analysis.
+- `memory(get_batch)`: expand specific load-bearing memories.
+- `smart_ingest`: save durable corrections, decisions, or new preferences.
+
+## 4. Compose, Do Not Summarize
+
+Retrieved memory is evidence, not the final answer.
+
+Use this mental transform:
+
+```text
+memory fact -> implication -> action
+```
+
+If memory does not change the action, do not mention it. If it does, make the
+changed recommendation clear.
+
+## 5. Know The Limit
+
+Claude Code's Cognitive Sandwich can use `UserPromptSubmit` and `Stop` hooks to
+wrap every response. Codex may expose different hook events depending on version.
+Do not assume Claude's hook chain is active in Codex just because Vestige MCP is
+registered.
+
+For Codex, the reliable portable layer is:
+
+1. MCP server configured.
+2. `AGENTS.md` instruction trigger.
+3. Local Codex rule docs.
+4. Explicit agent discipline: call Vestige before substantive answers.
+
+If a future Codex version supports a stable pre-prompt hook, wire that hook to
+inject a short Vestige reminder or context packet before the model answers.

docs/integrations/codex.md

@@ -89,6 +89,27 @@ args = ["--data-dir", "/Users/you/projects/my-app/.vestige"]
 
 ---
 
+## Intelligent Memory Protocol
+
+MCP registration makes Vestige tools available to Codex. It does not, by itself,
+force Codex to call those tools before answering.
+
+For workspaces where Codex should behave like it has persistent cognitive
+memory, add an `AGENTS.md` file at the workspace or repo root:
+
+```markdown
+Before answering substantive prompts, consult Vestige using the current prompt
+plus project and user context. Use `session_context` for broad context, `search`
+for quick memory checks, and `deep_reference` for decisions, contradictions, or
+accuracy-sensitive questions. Compose memories into actions; do not summarize
+retrievals.
+```
+
+Then use the full protocol in
+[`codex-intelligent-memory.md`](./codex-intelligent-memory.md).
+
+---
+
 ## Troubleshooting
 
 <details>

docs/integrations/xcode.md

@@ -165,7 +165,7 @@ See [CLAUDE.md templates](../CLAUDE-SETUP.md) for a full setup.
 The first time Vestige runs, it downloads the embedding model (~130MB). In Xcode's sandboxed environment, the cache location is:
 
 ```
-~/Library/Caches/com.vestige.core/fastembed
+~/Library/Caches/vestige/fastembed
 ```
 
 If the download fails behind a corporate proxy, pre-download by running `vestige-mcp` once from your terminal.
@@ -230,7 +230,7 @@ Xcode 26.3 has a feature gate (`claudeai-mcp`) that may block custom MCP servers
 The first run downloads ~130MB. If Xcode's sandbox blocks the download:
 
 1. Run `vestige-mcp` once from your terminal to cache the model
-2. The cache at `~/Library/Caches/com.vestige.core/fastembed` will be available to the sandboxed instance
+2. The cache at `~/Library/Caches/vestige/fastembed` will be available to the sandboxed instance
 
 Behind a proxy:
 ```bash