use #!/usr/bin/perl instead of #!/usr/bin/env perl

[toddr-bot]

What

Replace #!/usr/bin/env perl with #!/usr/bin/perl in all scripts and tests, and document the convention in CLAUDE.md.

Why

MakeMaker's fixin rewrites shebangs at install time to point to the perl that built the distribution, but it only recognizes the canonical #!/usr/bin/perl form. Scripts using #!/usr/bin/env perl bypass this mechanism, so installed scripts may find the wrong perl.

How

Straightforward sed across 27 files (tests + examples + one .pm in examples/lib). Added a Shebangs bullet to the Conventions section of CLAUDE.md.

Testing

Full test suite passes after the change.

🤖 Generated with Claude Code

---

Quality Report

Changes: 28 files changed, 30 insertions(+), 27 deletions(-)

Code scan: clean

Tests: passed (OK)

Branch hygiene: clean

Generated by Kōan post-mission quality pipeline

[toddr-bot]

Rebase with conflict resolution

Branch koan.toddr.bot/fix-shebang-lines was rebased onto main with automatic conflict resolution.

Stats

27 files changed, 29 insertions(+), 26 deletions(-)

Actions performed

• Already-solved check: negative (confidence=high, reasoning=None of the recent commits on main address shebang line changes from env perl to direct perl paths; )
• Resolved merge conflicts (1 round(s))
• Rebased koan.toddr.bot/fix-shebang-lines onto origin/main
• Pre-push CI check: no CI runs found
• Force-pushed koan.toddr.bot/fix-shebang-lines to origin
• CI check enqueued in ## CI (async)

CI status

CI will be checked asynchronously.

---

Automated by Kōan