Skip to content

release: 2.3.0 - #25

Merged
dennishavermans merged 2 commits into
mainfrom
release/2.3.0
Sep 3, 2026
Merged

release: 2.3.0#25
dennishavermans merged 2 commits into
mainfrom
release/2.3.0

Conversation

@dennishavermans

Copy link
Copy Markdown
Owner

A rule that opens with * has nothing before its wildcard, and what precedes the wildcard is what limits a rule. So it approves a shape, and any program can wear it.

The case that found it: rodekruis/qualitative-feedback-analysis, a public Netherlands Red Cross repository, carries Bash(* --version) and Bash(* --help *). Both read as courtesies for version banners. agentfile 2.2.0 said nothing about either.

Measured, not inferred

Claude Code 2.1.238, with a file-creating command as the probe so the read-only classifier could not approve it on its own, and the marker file as proof of execution:

case result
bash -c 'touch M' --version under Bash(* --version) ran, marker appeared
same command, no rules present did not run
same command without the flag did not run
... --version extra did not run
bash -c 'touch M' --help extra under Bash(* --help *) ran
bash -c 'touch M' under Bash(*) ran
same, with a matching deny rule beside it blocked

The tail still has to match, which is exactly what makes the shape read narrower than it is. An earlier pass of this measurement used echo and produced a contradictory row: Claude Code's read-only classifier can approve such a command by itself, so the probe was rebuilt around a write.

What it reports

Bash(* --version) is reported as an arbitrary-command grant. Bash(*) is the honest spelling of the same reach and is reported plainly, since the reader's remaining guards are deny rules, hooks and the sandbox. Where the tail names a program, as in Bash(*vitest*), the suggestion is the rule the author meant: Bash(vitest *).

Scope, from the corpus

Deny rules keep their leading stars without comment. In a 344-file sample most leading-star rules were denies such as Bash(*xmrig*) and Bash(* | sh), and breadth in a deny runs in the safe direction. Across 12,556 rules the new check fires 33 times: 4 tail-constrained rules in 2 repositories, and 29 spellings of Bash(*).

Also in this release

The word-boundary check printed a false sentence on those same deny rules: Bash(*xmrig*) drew "also matches every program whose name starts with *xmrig", and no program is named *xmrig. It now stands down where a rule opens with a wildcard, which removes 29 such sentences across the sample. A doc comment orphaned from its function in 2.2.0 sits with it again.

1042 tests pass, lint and typecheck are clean, and the built CLI on the rodekruis clone reports 4 warnings: the two git * main|master rules and the two new ones.

A rule that opens with `*` has nothing before its wildcard, and what
precedes the wildcard is what limits a rule. So it approves a shape, and
any program can wear it. rodekruis/qualitative-feedback-analysis, a
public Netherlands Red Cross repository, carries `Bash(* --version)` and
`Bash(* --help *)`, and both read as courtesies for version banners.

Measured on Claude Code 2.1.238 with a file-creating probe, chosen so the
read-only classifier could not approve it on its own: under
`Bash(* --version)`, `bash -c "touch <marker>" --version` ran and the
marker appeared. With no rules present it did not run, so the grant is
the rule and not the environment. Without the flag it did not run, and
neither did the same command with a word after it.

`Bash(*)` is the honest spelling of the same reach and is reported
plainly. Deny rules keep their leading stars without comment: in a
344-file sample most leading-star rules were denies such as
`Bash(*xmrig*)`, and breadth in a deny runs in the safe direction. Across
12,556 rules the check fires 33 times.

Also fixes a false sentence the word-boundary check printed on those same
deny rules ("every program whose name starts with `*xmrig`"), and returns
a doc comment orphaned in 2.2.0 to its function.
The version bump rewrote every @agentfile/* range in the workspace,
including the CLI dependency on @agentfile/ui. That package is published
separately at 0.1.0-beta.0, so ^2.3.0 resolves to nothing and every CI
job failed at npm install with ETARGET.
@dennishavermans
dennishavermans merged commit c97671a into main Sep 3, 2026
12 checks passed
@dennishavermans
dennishavermans deleted the release/2.3.0 branch September 3, 2026 09:42
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.

2 participants