Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion crates/squabble-core/data/first-line-rules.tsv
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ SQ-GEN-01 FIX estate-rules reports the committed REPOSITORY-MAP.adoc is stale Ru
SQ-GEN-02 FIX a deed or k9 line is over 998 octets (K9-E006) Wrap the string or description, layout only deed_lint.js and k9-validate --strict pass A wrap would change a value (identifier, hash, URL)
SQ-GEN-03 FIX a job with if: always() and needs: that downloads an artifact (actions/download-artifact without run-id) runs after a cancelled run and fails on the missing artifact (Hypatia WF029) Change the job condition to ${{ !cancelled() }} The workflow is valid YAML, the job still runs after failed or skipped needs, and it does not run in a cancelled run The job must run after cancellation on purpose, or the workflow is vendored or third-party
SQ-GEN-04 FIX kyaml-format: <file> is not KYAML (quintessence run 43156792336: build/container/compose.yaml) Run scripts/kyaml-format.sh <file> and commit the layout change. The generator is named here and is never taken from the log; it needs mikefarah Go yq (Python yq corrupts the file) The output is KYAML and the repository kyaml check passes; a missing yq means the check did not run, never a pass The output is not KYAML, the formatter changes a value, or yq is not the mikefarah Go build
SQ-GEN-05 FIX a gitleaks job on a pull_request run scans the full history (fetch-depth: 0, no range) and fails on a finding that is not in the PR's own commits (Hypatia WF031; gitbot-fleet run 43430810006: 551 commits scanned, 1 leak, verdict 1; the next run on the branch, 43438916211, passed) Scan base..head on pull_request and keep a full-history scan on schedule, workflow_dispatch and push to the default branch; never remove the full-history scan; report a finding that predates the PR to the owner gitleaks over base..head passes on the PR, the full-history scan is still triggered on schedule, dispatch or the default branch, and the older finding is reported, not hidden The finding is inside base..head (a real secret the PR adds), no full-history scan would remain, or the workflow is vendored or third-party
SQ-GEN-05 FIX a gitleaks job on a pull_request run scans the full history (fetch-depth: 0, no range) and fails on a finding that is not in the PR's own commits (Hypatia WF031; gitbot-fleet run 43430810006: 551 commits scanned, 1 leak, verdict 1; the next run on the branch, 43438916211, passed) Scan base..head on pull_request and keep the full-history scan on every non-PR trigger it already has (schedule, workflow_dispatch, push to the default branch); never remove it; report a finding that predates the PR to the owner gitleaks over base..head passes on the PR, the full-history scan still runs on each non-PR trigger it had before and at least one remains, and the older finding is reported, not hidden The finding is inside base..head (a real secret the PR adds), no full-history scan would remain, or the workflow is vendored or third-party
SQ-CANON-01 FIX an instance's canon-lockstep job is an old inline copy and goes red on a canon release Run rsr-template-repo scripts/adopt-canon-lockstep.sh The canon-lockstep job passes with the lag notice The script refuses (lock coverage), or the pin itself must change (A2ML is never edited automatically)
SQ-PERM-01 FIX Resource not accessible by integration at get-a-workflow-run in a job that uploads SARIF on a private repository Add actions: read to that job's permissions, with a comment that names the reason The upload step passes on a re-run The permission is already present, or the repository is public
SQ-RUN-01 ACT a setup or download step fails with API rate limit exceeded and the same workflow passes on an adjacent commit Re-run the failed jobs once after the rate-limit reset, only if that commit is still the head The re-run passes It fails twice on the same commit, the log has no rate-limit text, or the step is not a setup or download step
Expand Down
4 changes: 2 additions & 2 deletions docs/decisions/0004-first-line-rule-catalogue.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -150,8 +150,8 @@ holds, or when its check does not pass on the PR head.

| SQ-GEN-05 | FIX
| A gitleaks job on a `pull_request` run scans the full history (`fetch-depth: 0` and no range) and fails on a finding that is not in the PR's own commits. Seen in gitbot-fleet run 43430810006 (`scan / gitleaks`: 551 commits scanned, 1 leak, verdict 1); the next run on the same branch, 43438916211, passed. Detection is Hypatia WF031, a static workflow rule; this row only fixes it.
| Scan `base..head` on `pull_request`, and keep a full-history scan on `schedule`, `workflow_dispatch` and push to the default branch. Never remove the full-history scan. Report a finding that predates the PR to the owner; it is not hidden by the narrower range.
| `gitleaks` over `base..head` passes on the PR, the full-history scan is still triggered on schedule, dispatch or the default branch, and the older finding is reported.
| Scan `base..head` on `pull_request`, and keep the full-history scan on every non-PR trigger it already has (`schedule`, `workflow_dispatch`, push to the default branch). Never remove it. Report a finding that predates the PR to the owner; it is not hidden by the narrower range.
| `gitleaks` over `base..head` passes on the PR, the full-history scan still runs on each non-PR trigger it had before and at least one remains, and the older finding is reported.
| The finding is inside `base..head` (a real secret that the PR adds), no full-history scan would remain, or the workflow is vendored or third-party.

| SQ-CANON-01 | FIX
Expand Down
Loading