docs(prior-work-retrieval): document the redirection trap on retrieve (v3.26.3) (#538)

The write gate trips on a file redirection even trailing a read-only
route command (2026-08-27 design, regression-locked). A redirected
retrieve gets blocked and the run JSON never lands where aimed. State
the trap where the command is documented and point to the durable
state_dir copy instead.

Co-authored-by: Claude Code <noreply@anthropic.com>
This commit is contained in:
daymade
2026-09-13 23:42:34 +08:00
committed by GitHub
parent 6f78f9eb39
commit bed61bac68
2 changed files with 9 additions and 1 deletions
+1 -1
View File
@@ -126,7 +126,7 @@
"description": "Claude Code operations suite that bundles cross-project prior-work retrieval across code, docs, Skills, meetings, WeChat archives, and conversation history; provider-separated Claude Code and Codex history readers; identity- and lineage-gated continuation workflows; plugin/skill troubleshooting; CLAUDE.md progressive disclosure optimization; version-synced Lark CLI routing; statusline configuration; exported .txt repair; full claude.ai conversation extraction with tool-call rendering and file download; plugin marketplace development and suite consolidation; writing/testing/debugging Claude Code hooks; multi-provider profile isolation; personal-memory migration into tool-agnostic AGENTS.md reference docs; one-shot local timers that ping Claude right after subscription quota reset to start a fresh 5-hour usage window; and terminal-output-to-PNG rendering for visual CLI verification under one shared namespace. Install once to get the full Claude Code power-user toolkit.",
"source": "./daymade-claude-code",
"strict": false,
"version": "3.26.2",
"version": "3.26.3",
"category": "suite",
"keywords": [
"suite",
@@ -87,6 +87,14 @@ uv run --no-project python scripts/prior_work.py retrieve \
--session-id "$CODEX_SESSION_ID"
```
Do NOT redirect the output (`> /tmp/run.txt`) to save it: by design
(2026-08-27, regression-locked in `test_unquoted_redirection_even_after_
route_stays_gated`) a file redirection trips the write gate even on a
read-only route command, so a redirected retrieve is blocked and the run
JSON never lands where you aimed. Let the output print and read it from the
transcript; the durable copy is the run JSON under the manifest's `state_dir`
(its `run_path` is printed on the last line).
`--session-id`: use it only with `retrieve`, `complete`, and `check`; `validate-manifest`
does not accept it. On Codex use `$CODEX_SESSION_ID`. Claude Code has no such env
var, so take the exact id carried verbatim in prior-work hook messages