feat: headless --clean mode for AI tool post-session hooks

[kunjee17]

Closes #15.

What

irona --clean <path> scans, deletes every artifact directory it finds, prints one summary line, and never enters raw mode or the alternate screen — so it works from a Claude Code Stop hook or any non-interactive context.

irona --clean ~/Workspace                   # scan, delete, report
irona --clean --dry-run ~/Workspace         # report only, delete nothing
irona --clean --include-gitignored ~/W      # also sweep gitignore-only matches

Decisions

Answering the issue's open questions:

• Flag, not subcommand. Keeps the existing irona <path> positional working with no clap restructuring.
• --dry-run included. The safety valve before wiring a destructive command into a hook.
• Exit 0 on nothing-found, 1 only when a delete failed. A clean workspace must not fail a hook noisily.
• --only rust,node deferred. Needs a name parser for all fifteen Language variants and nothing depends on it yet.

One decision not in the issue: gitignore-detected directories are excluded by default in headless mode. In the TUI a person reads the list before selecting; unattended, a gitignored data/, logs/, or secrets/ would be deleted with nobody watching. --include-gitignored restores the full sweep. TUI behaviour is unchanged.

Structure

New src/headless.rs drives the existing scanner::scan and deleter::delete_all, which were already TUI-independent. format_bytes moves from render.rs to a new src/format.rs so headless output does not depend on the rendering module.

Verification

• cargo nextest run — 68 tests pass (51 before, 17 new)
• cargo clippy --all-targets -- -D warnings — clean
• pre-commit hook passed: fmt, clippy, build
• smoke-tested end to end: dry run leaves target/ in place, real run deletes it and exits 0, second run reports nothing-to-clean and exits 0, --dry-run without --clean exits 2 with a clap error, and --include-gitignored deletes a gitignored dist/ that the default run leaves alone

Note

PR #17 also edits the Args struct in main.rs to add --mcp. Whichever merges second needs a small conflict resolution there; nothing structural overlaps.

🤖 Generated with Claude Code