Skip to content

Commit c513fff

Browse files
chore: gitbot-fleet hygiene — Bustfile, findings-submissions doc, Fallback:Nix reconcile (#261)
Adds the missing Bustfile (completing the Dust/Bust pair), documents findings-submissions as an automated data-sink branch, and reconciles the robot-repo-automaton "Fallback: Nix" note to Guix-only (consistent with #260). https://claude.ai/code/session_016R5WsMHtpnD8bmrkjFNFmg
1 parent 713ce9e commit c513fff

3 files changed

Lines changed: 48 additions & 1 deletion

File tree

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
# SPDX-License-Identifier: MPL-2.0
2+
# Bustfile — Breakage and Rollback Contract
3+
name = "bustfile"
4+
5+
6+
[bustfile]
7+
version = "1.0.0"
8+
format = "a2ml"
9+
10+
[scenarios]
11+
bad-fix-script = "git revert the fix commit; fix scripts are idempotent, so a re-run after the fix is safe"
12+
dispatch-runner-failure = "halt dispatch-runner; inspect the JSONL manifest; a failed dispatch leaves the target repo untouched (no partial writes)"
13+
bot-repeated-failure = "auto-quarantine engages at 5+ failures or >30% false-positive rate; clear only after a root-cause fix"
14+
bad-bot-pr = "close the bot PR; revert any merged commit; confidence reverts via batch-rollback"
15+
16+
[escalation]
17+
level-1 = "revert the offending commit (reversible, low blast radius)"
18+
level-2 = "quarantine the misbehaving bot (rate-limiter / quarantine subsystem)"
19+
level-3 = "batch-rollback the dispatch batch with confidence revert"
20+
level-4 = "force-push to main — PROHIBITED without explicit user confirmation"
21+
level-5 = "registry-level (delete/archive a repo) — human-only, never by AI"
22+
23+
[reversibility]
24+
backup-before-destructive = true
25+
rollback-mechanism = "git-revert"
26+
batch-rollback-available = true
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
<!-- SPDX-License-Identifier: MPL-2.0 -->
2+
<!-- SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell (hyperpolymath) -->
3+
4+
# The `findings-submissions` branch
5+
6+
`findings-submissions` is an **automated data-sink branch**, not a feature
7+
branch. The *Hypatia Finding Submitter* pushes scan-finding JSON to it on a
8+
schedule (commits titled `findings: <repo> @ <date>`), accumulating the raw
9+
findings stream that feeds the fleet's review queue.
10+
11+
## Do not reconcile it
12+
13+
- **Do not merge it into `main`.** It carries tens of thousands of lines of
14+
findings JSON; merging would pollute `main` with transient data.
15+
- **Do not delete it.** It is an active channel — the submitter pushes to it
16+
continuously and downstream tooling reads from it.
17+
- **Do not rebase/squash/branch-hygiene it.** Its divergence from `main` is
18+
intentional and expected.
19+
20+
Treat it like a queue, not a contribution. It is deliberately long-lived and
21+
divergent from `main`.

robot-repo-automaton/.claude/CLAUDE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ Both are FOSS with independent governance (no Big Tech).
5757
### Package Management
5858

5959
- **Primary**: Guix (guix.scm)
60-
- **Fallback**: Nix (flake.nix)
60+
- **Fallback**: none — Guix-only (Nix retired 2026-06-05)
6161
- **JS deps**: Deno (deno.json imports)
6262

6363
### Security Requirements

0 commit comments

Comments
 (0)