Skip to content

docs(readme): document Bash 4 requirement, drop sudo from dry-run example - #24

Merged
twistedmelonman merged 2 commits into
mainfrom
claude/validate-v1.0.193-review
Aug 17, 2026
Merged

twistedmelonman merged 2 commits into
mainfrom
claude/validate-v1.0.193-review

Conversation

@twistedmelonman

Copy link
Copy Markdown
Member

Summary

Two README corrections found by reading install.sh against the documentation:

  1. Bash 4 requirement was undocumented. install.sh uses the mapfile builtin (lines 251, 259, 502, 573, 585), which requires Bash 4.0+. macOS ships Bash 3.2 at /bin/bash, so the script fails on a stock system unless a newer Bash is earlier on PATH. The Requirements section previously listed only "macOS 10.6+" plus tools that "ship with macOS", implying nothing extra was needed.

  2. --dry-run does not need root. The Examples section showed sudo ./install.sh --dry-run, but check_root() short-circuits when DRY_RUN is true, so sudo is unnecessary. Removed it and noted why.

Docs only; no behavior change.

Secondary purpose: end-to-end review-workflow validation

This PR also serves as an end-to-end check that the Claude blocking review actually renders a verdict.

main now pins the reusable workflow at claude-blocking-review.yml@v3.1.1, which bumps anthropics/claude-code-action from v1.0.70 to v1.0.193 — a security bump clearing GHSA-8q5r-mmjf-575q. That bump has not yet been confirmed to run a review successfully: prior validation attempts all touched .github/workflows/*.yml, which trips the reusable workflow's workflow-self-modification guard and skips the review entirely.

This PR deliberately touches only README.md — nothing under .github/ — so the reviewer should actually execute rather than skip, letting us confirm v1.0.193 renders a BLOCK/PASS verdict.

Claude Code Bot and others added 2 commits August 16, 2026 18:48
…mple

Two corrections found while reading install.sh against the README:

1. install.sh uses the `mapfile` builtin (lines 251, 259, 502, 573, 585),
   which is Bash 4.0+. macOS ships Bash 3.2 at /bin/bash, so the script
   fails on a stock system unless a newer Bash is earlier on PATH. The
   Requirements section listed only "macOS 10.6+" and tools that "ship
   with macOS", which implies no extra install is needed. Added the
   Bash 4 requirement with the brew install line.

2. The Examples section showed `sudo ./install.sh --dry-run`, but
   check_root() short-circuits when DRY_RUN is true, so --dry-run never
   needs root. Removed the sudo and noted why.

Docs only; no behavior change.
@twistedmelonman
twistedmelonman merged commit c47814b into main Aug 17, 2026
4 checks passed
@twistedmelonman
twistedmelonman deleted the claude/validate-v1.0.193-review branch August 17, 2026 19:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant