v1.0.1: fix -u flag claims and #1282 citation found by independent audit#4
Merged
Merged
Conversation
Ran an exhaustive multi-agent audit against live upstream rtk-ai/rtk sources (commits, issues, current README via direct GitHub API calls, not just search summaries) to double-check everything shipped in v1.0.0. Several findings were themselves wrong (e.g. a claim that `rtk tree`/`gain --failures`/ `json --keys-only` are real — they are not; confirmed against the live README) and were rejected after independent primary-source re-verification. Two findings held up: - `-u` is not a working short form of `--ultra-compact`. RTK's own README still documents it, but it was removed from the CLI upstream (it collided with `git push -u`) and was never restored — invoking it fails outright (RTK issue #2369, open). Replaced every `-u` reference with the working long form across AGENTS.md, SKILL.md, README.md, references/commands.md, and added a one-line callout explaining why RTK's own docs are stale here. - RTK issue #1282 was mischaracterized as an ANSI/decoration issue; it is actually a correctness bug (RTK can silently substitute a compressed summary for real content on a non-TTY pipe, e.g. wrong line counts). Corrected the description and cited the right issue (#1409, fixed) for the ANSI-on-pipe claim. - Synced SKILL.md's Compatibility & limitations section with README.md's — it was missing the Native tools and Hooks on Windows bullets. Bumped to 1.0.1 with a CHANGELOG entry; SKILL.md version updated to match. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VvpBXNCbbg4eibmZQZAbb6
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
2 participants
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
Ran an exhaustive multi-dimensional audit (5 independent dimensions × 3-way adversarial verification, 59 sub-agents total) against live upstream rtk-ai/rtk sources to double-check everything shipped in v1.0.0. Several of the audit's own "confirmed" findings turned out to be wrong on independent re-verification — most notably a claim that
rtk tree/gain --failures/json --keys-onlyare real commands (they are not; reconfirmed directly against the current upstream README via raw GitHub API calls). I did not act on those.Two findings held up under my own independent, primary-source re-verification (direct GitHub REST API calls — unsummarized JSON, not WebFetch prose — for the relevant commit, issues, and current README):
-uis not a working short form of--ultra-compact. RTK's own README still documents it, but it was removed from the CLI upstream (commit6b76fdb, because it collided withgit push -u) and was never restored — invoking it fails outright (RTK issue #2369, currently open). This repo presented-uas a real-but-discouraged flag in 7 places acrossAGENTS.md,SKILL.md,README.md, andreferences/commands.md. All replaced with the working long form--ultra-compact, plus a one-line callout explaining the upstream doc/code mismatch so it's not a silent change.grepwrites a line-count summary instead of the matching lines). Corrected the description in 4 files and cited the right issue for the ANSI/NO_COLORclaim instead: #1409 (fixed).Bumped to 1.0.1 with a CHANGELOG entry;
SKILL.mdversion updated to match.Type of change
references/commands.md)install.sh/install.ps1)README.md/SKILL.md/AGENTS.md)Checklist
*.ps1)SKILL.mdstill has valid frontmatter (name:,description:)SKILL.md/AGENTS.mdvalidation — verified locally)🤖 Generated with Claude Code
https://claude.ai/code/session_01VvpBXNCbbg4eibmZQZAbb6
Generated by Claude Code