File tree Expand file tree Collapse file tree
.machine_readable/contractiles/bust
robot-repo-automaton/.claude Expand file tree Collapse file tree Original file line number Diff line number Diff line change 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
Original file line number Diff line number Diff line change 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 ` .
Original file line number Diff line number Diff 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
You can’t perform that action at this time.
0 commit comments