fix(hook): add output transparency section to RTK instructions#2718
Open
guyoron1 wants to merge 1 commit into
Open
fix(hook): add output transparency section to RTK instructions#2718guyoron1 wants to merge 1 commit into
guyoron1 wants to merge 1 commit into
Conversation
When RTK is installed as a silent PreToolUse hook, filtered output can trigger LLM tamper heuristics because the output shape differs from the raw command. Add an "Output Transparency" section to RTK_INSTRUCTIONS explaining that RTK intentionally compresses output and pointing to `rtk proxy` for unfiltered output. Fixes rtk-ai#2445
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
When RTK is installed as a silent PreToolUse auto-rewrite hook, safety-tuned LLMs can flag RTK's filtered output as tampered because the output shape differs from what the original command produces (e.g., grep results grouped by file, diffs compacted, lists truncated with
+N more).This PR adds an "Output Transparency" section to the
RTK_INSTRUCTIONSconstant (injected into CLAUDE.md byrtk init). The section explicitly tells the LLM that:rtk proxy <cmd>is available for exact unfiltered outputThis converts "unexplained output mismatch" into "expected behavior from a known tool," addressing the most common trigger for tamper heuristics.
Changes
src/hooks/init.rs: Add 4-line "Output Transparency" section toRTK_INSTRUCTIONSTest plan
cargo fmt --all && cargo clippy --all-targets && cargo test --allpassestest_init_contains_key_commandsandtest_init_has_version_markertests passFixes #2445