Skip to content

review: trim the sub-agent tool surface to Read/Grep/Bash, and window Read - #325

Merged
jwbron merged 1 commit into
jwies/review-pi-harness-seamfrom
jwies/review-pi-tool-surface
Aug 4, 2026
Merged

review: trim the sub-agent tool surface to Read/Grep/Bash, and window Read#325
jwbron merged 1 commit into
jwies/review-pi-harness-seamfrom
jwies/review-pi-tool-surface

Conversation

@jwbron

@jwbron jwbron commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Stacked on #305 (base is its branch). Follows from mojadem's review question there (#305 (review)): with every tool subprocess sandboxed identically by srt, named tools earn their place on model ergonomics, not containment.

What changes

  • LS is gone. It wrapped ls -la verbatim; Bash does that.
  • Glob is gone. Its find -path emulation was wrong, not just limited: * matched across /, so src/*.ts silently returned nested files and reviewers got a wider file list than they asked for. Finding files goes through Bash, where the model owns the semantics of its own command.
  • Read gains offset/limit windowing. Previously a large file was truncated at the 30k output cap with the tail unreachable, a silent recall defect. Windows keep cat -n line numbers so findings anchor on real lines, and partial views say which lines of how many they show.
  • Grep stays: structured params avoid the shell-quoting failure class of regexes composed into bash -lc.
  • The eval now measures the production surface. The measured arms drop their allowedTools: ["Read", "Grep", "Glob"] pin (a surface production never ran) and take createReviewTools unrestricted, so the 3-vs-5 tool mismatch class is gone by construction.

Exit criterion: a green re-anchor A/B at this branch head on the new surface, since the surface is a measured variable. Dispatching it on this PR; numbers to follow.

1679 tests pass. The harness probe keeps a restricted surface (now Read/Grep) since its job is reproducing a historical configuration; its question was settled as noise on #305.

…Grep/Bash, window Read, and align the eval to it

LS added nothing over sandboxed Bash; Glob's find -path emulation was
wrong, not just limited (* matched across /). Read gains offset/limit
windowing so large files stop being silently truncated at the output cap
with an unreachable tail. The eval's measured arms drop their
Read/Grep/Glob restriction and run the production surface unrestricted,
so the A/B measures what production ships by construction. Raised by
mojadem on #305; re-anchor A/B run to follow on this PR.
@changeset-bot

changeset-bot Bot commented Aug 4, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 3393ae2

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
review Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@khan-actions-bot
khan-actions-bot requested review from a team, jaredly and kevinb-khan and removed request for a team August 4, 2026 18:10
@github-actions

github-actions Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Review live A/B

No reviewable delta: review.md is byte-identical in both arms (baseline origin/jwies/review-pi-harness-seam, sha 0b55c672f514), so the extracted prompts and the orchestrator body match and no arms were run. Pass --force-arms for a deliberate wobble control.

@github-actions

github-actions Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Review Guidance

Common patterns

4 files: "Glob" (and "LS") removed from ALLOWED_TOOLS / tool-name arrays throughout the codebase as those tools are deleted from createReviewTools

- const ALLOWED_TOOLS = ["Read", "Grep", "Glob"];
+ const ALLOWED_TOOLS = ["Read", "Grep"];

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved — no blocking issues found.
Note: correctness-reviewer not assessed this run (correctness-reviewer output unavailable).
Note: test-adequacy not assessed this run (test-adequacy output unavailable).
Note: completeness not assessed this run (completeness output unavailable).
Note: holistic not assessed this run (holistic output unavailable).
Note: first-principles not assessed this run (first-principles output unavailable).
Note: conventions not assessed this run (conventions output unavailable).

@jwbron
jwbron merged commit 3393ae2 into jwies/review-pi-harness-seam Aug 4, 2026
16 of 17 checks passed
@jwbron
jwbron deleted the jwies/review-pi-tool-surface branch August 4, 2026 18:31
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