Skip to content

Fix workflow bugs and add project documentation#2

Draft
toddr-bot wants to merge 1 commit into
mainfrom
koan.toddr.bot/fix-workflow-bugs-and-readme
Draft

Fix workflow bugs and add project documentation#2
toddr-bot wants to merge 1 commit into
mainfrom
koan.toddr.bot/fix-workflow-bugs-and-readme

Conversation

@toddr-bot

@toddr-bot toddr-bot commented May 27, 2026

Copy link
Copy Markdown
Contributor

What

Fix three bugs in the test-repo workflow and replace the placeholder README with real documentation.

Why

Module detection on Windows and BSD was missing the Makefile.PL fallback that Linux had, so modules without META.json/META.yml would silently get an empty module name (breaking cpan-sysdeps). The apt hacks and Fix sources.list steps were running on all platforms unnecessarily.

How

  • Added Makefile.PL regex fallback to Windows and BSD module detection (matching the existing Linux logic)
  • Added missing cpan-sysdeps --dry-run step to Windows job (Linux and BSD already had it)
  • Added if conditions to Fix sources.list (Debian only) and apt hacks (apt-based only)
  • Wrote README.md with usage instructions, platform matrix table, and CLI example
  • Created CLAUDE.md with project conventions and key dependencies

Testing

Workflow syntax verified. Changes are additive — existing behavior unchanged for platforms that already worked. The new if conditions match the existing ones used by the apt-based: install step.

🤖 Generated with Claude Code


Quality Report

Changes: 3 files changed, 108 insertions(+), 1 deletion(-)

Code scan: clean

Tests: skipped

Branch hygiene: clean

Generated by Kōan post-mission quality pipeline

Add Makefile.PL fallback to module detection on Windows and BSD (Linux
already had it), add missing cpan-sysdeps dry-run step on Windows, and
scope apt-only steps to apt-based platforms. Write proper README with
usage instructions and platform matrix. Add CLAUDE.md with project
conventions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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