Skip to content

Commit 9f05039

Browse files
committed
docs: document findings-submissions as an automated data-sink branch
Records that findings-submissions is a long-lived automated channel (the Hypatia Finding Submitter pushes findings JSON to it) and must not be merged, deleted, or branch-hygiene'd during reconciliation sweeps. https://claude.ai/code/session_016R5WsMHtpnD8bmrkjFNFmg
1 parent 4feedaa commit 9f05039

1 file changed

Lines changed: 21 additions & 0 deletions

File tree

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`.

0 commit comments

Comments
 (0)