feat: squabble board (estate needs-me board) and squabble inbox-sweep

[hyperpolymath]

What

Two new subcommands, so the owner sees only what needs them: no paging through hundreds of merged-PR notifications, and no hunting for the few PRs that are really blocked.

squabble board

• Enumerates every non-archived repo of each owner. Defaults are hyperpolymath and metadatastician.
• Reads the merge gate of each repo with open PRs, taking the union of rulesets and classic branch protection, since Ref.rules omits classic protection. It also reads every open PR.
• Places each PR in exactly one bucket: Needs you · Agent work · Landing by itself · Stale — close? (pure classifier in squabble-core::board).
• Renders Markdown under the 65536-byte issue-body limit. --publish owner/repo#N rewrites that issue's body: it never comments, so it sends no notifications. It then checks that the stored body equals the one sent, because rc=0 is not evidence.
• Recovers from batch failures: a whole-batch failure (HTTP 502, or "no data") is split in half recursively, down to one repo with one retry. Listing pages retry transport failures. Anything still unreadable is named at the top of the board, and the command exits 6.

squabble inbox-sweep

• Lists every thread still in the inbox (GET /notifications?all=true, paginated). It resolves PR and issue state in GraphQL batches.
• Clears only threads whose subject is merged or closed: it unsubscribes, then marks the thread done. Unknown state, unread state and non-PR/issue subjects are kept.
• Dry run by default. --apply writes, stops at a REST --reserve read from the response header, and names every due thread it left (as a set, not a count). Exits 6 if any were left.
• Needs a user token with the notifications scope; an App token cannot read notifications.

Evidence

• just quality: exit 0, 302 tests passed, 0 failed (fmt-check, clippy -D warnings, test).
• New tests:
  • Generated GraphQL is schema-validated against the vendored schema, with a negative control for each query.
  • Planted CLEAN, armed and no-gate PRs each land in the right bucket.
  • A heavy repo no longer sinks its batch. Mutant check: disabling the split makes one_heavy_repo_does_not_sink_its_batch fail.
  • The sweep unsubscribes before marking done, a failed unsubscribe keeps the thread, and the reserve stop names the tail.
• Live board, 2026-10-01T14:2xZ:
  • Coverage: 398 + 50 repos, 458 + 54 open PRs, all placed, 0 unreadable (the run before the split/retry fix had 20 unreadable).
  • Buckets: Needs you 139 (126 of them "no required check on the default branch") · Agent work 371 · Landing 2 · Stale 0.
  • Counts reconcile with gh search prs: 458 = 458, and 55 = 54 + 1 PR in an archived repo, which the board excludes by design.

Not in this PR

• The hourly systemd user timer that runs inbox-sweep --apply, then board --publish. It lives in the owner's developer/scripts, outside this repo.
• Auto-merge arming and the layered ruleset canon, which come in later increments. Repos with no required check are listed on the board, not armed: arming there would merge at once.

🤖 Generated with Claude Code

https://claude.ai/code/session_0196aKTfvS6vPQVp2LPoXbjP

[coderabbitai]

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 75119691-9698-4447-af6d-9d382ba6ae5e

📥 Commits

Reviewing files that changed from the base of the PR and between bf00c8e and e1caeaf.

📒 Files selected for processing (11)

• crates/squabble-cli/src/board.rs
• crates/squabble-cli/src/inbox.rs
• crates/squabble-cli/src/main.rs
• crates/squabble-core/src/board.rs
• crates/squabble-core/src/inbox.rs
• crates/squabble-core/src/lib.rs
• crates/squabble-forge/graphql/board_repo.graphql
• crates/squabble-forge/graphql/estate_repos.graphql
• crates/squabble-forge/src/board.rs
• crates/squabble-forge/src/inbox.rs
• crates/squabble-forge/src/lib.rs

 ________________________________________________________
< Code review is a dish best served cold. Like a carrot. >
 --------------------------------------------------------
  \
   \   \
        \ /\
        ( )
      .( o ).

✨ Finishing Touches

📝 Generate docstrings

• Commit to this branch
• Create a new PR

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Autopilot is currently an internal CodeRabbit preview.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}