hygiene: support stale worktree audit root option

[AceHack]

Summary

• add --root PATH to audit-stale-worktrees so callers can inspect a control clone without changing cwd
• route list/prune through git -C <root> and cover argument parsing
• handle spawnSync launch errors explicitly in audit() + runPrune() (per Copilot review on this PR)
• tighten hasFlagValue to reject any dash-prefixed token (catches typos like --report --verbose)
• expand exit-128 header comment to cover --root failure modes
• claim was released per AGENT-CLAIM-PROTOCOL.md §TL;DR step 5 (no claim file shipped with this PR; coordination artifact deleted on landing)

Checks

• bun test tools/hygiene/audit-stale-worktrees.test.ts (12 pass)
• bun tools/hygiene/audit-stale-worktrees.ts --root /Users/acehack/.local/share/zeta-codex-loop/Zeta
• bun tools/hygiene/audit-stale-worktrees.ts --root /tmp/__nonexistent → exit 128 with clean error
• bun tools/hygiene/audit-stale-worktrees.ts --report --verbose → "--report requires a path"
• node_modules/.bin/prettier --check tools/hygiene/audit-stale-worktrees.ts tools/hygiene/audit-stale-worktrees.test.ts
• node_modules/.bin/tsc --noEmit -p tsconfig.json
• git diff --check

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

[Copilot]

Pull request overview

Adds a --root PATH option to the stale worktree audit tool so callers can audit a specific repo without changing the current working directory, routing list/prune through git -C <root> and adding argument-parsing tests.

Changes:

• Add --root PATH CLI flag and thread it through git worktree list/prune via git -C.
• Export and test parseArgs to cover the new flag and combinations with --report/--prune.
• Add a new claim file for the work.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File	Description
tools/hygiene/audit-stale-worktrees.ts	Adds --root parsing + git -C routing and exports parseArgs.
tools/hygiene/audit-stale-worktrees.test.ts	Adds unit tests covering --root argument parsing.
docs/claims/codex-loop-stale-worktree-root-option-20260527.md	Adds a live claim file documenting scope/acceptance checks for this slice.

Comments suppressed due to low confidence (1)

tools/hygiene/audit-stale-worktrees.ts:84

• P1: --root/--report consume the next token as a path even when the next token is another flag (e.g. --root --prune), which silently mis-parses the CLI and can cause git -C --prune ... failures. Treat known flags as missing-value errors to keep behavior predictable.

    if (a === "--root") {
      const next = argv[i + 1];
      if (!next) return { kind: "error", message: "--root requires a path" };
      root = next;
      i += 2;
    } else if (a === "--report") {
      const next = argv[i + 1];
      if (!next) return { kind: "error", message: "--report requires a path" };
      report = next;
      i += 2;

[AceHack]

Vera coordination update, 2026-05-27T00:31Z: commit fc0a657 addresses the Copilot flag-token parser finding; the submit-nuget transient failure was inspected, rerun, and is now passing. All visible and required checks are green. Auto-merge remains armed, but GitHub still reports mergeStateStatus=BLOCKED and the PR remains open; no further CI rerun or code patch is warranted from Vera unless fresh state changes.

[Copilot]

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 5 comments.

[Copilot]

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.