Skip to content

fix(readme): restore the two Troubleshooting rows #585's merge silently dropped - #598

Merged
ZacxDev merged 1 commit into
mainfrom
fix/restore-591-troubleshooting-rows
Sep 14, 2026
Merged

ZacxDev merged 1 commit into
mainfrom
fix/restore-591-troubleshooting-rows

Conversation

@ZacxDev

@ZacxDev ZacxDev commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

A regression I introduced on main an hour ago, and nearly deleted the evidence of.

What broke

main's Troubleshooting index reads:

| `rate limited (429)` | Throttled; exit `6`. For deep paging use `--cursor` rather than `--page`. |

That is the exact 🔴 #591 round 1 fixed — it now contradicts the generated ### Exit code 6 section thirty lines above, which correctly states the message reaches 2 or 6 and never 5. And the Civitai returned HTTP row — the only landing place for the exit-5 case — was gone entirely.

A user who hits the deep-paging cap greps the message they saw, lands on that row, reads "exit 6", and writes if rc == 6: backoff; retry — the loop #591 exists to prevent.

How

#591 squash-merged at 02:51. At 03:50 I merged main into #585's branch, resolved the two real conflicts, took #585's README as the base, and re-applied the main-side rows I could think of. #591's Troubleshooting rows sat in a region that never conflicted, so git had nothing to say and my spot-check did not think of them.

Third time this trap fired today, every time in a no-conflict region: twice caught mid-merge, once shipped. On the second merge I did run a systematic diff main-README vs result and it caught a drop my spot-check had missed — I had not run it on the first.

🔴 And I nearly destroyed the evidence

After merging both PRs I deleted the orphan branch saying "nothing unique" — while the git diff --stat I had just printed showed README differing by five lines. I read past my own output. The object survived locally, and those five lines were exactly this fix.

Both rows here are restored verbatim from that commit rather than retyped.

Verified

  • The restored left column Civitai returned HTTP is a genuine fragment of a printed string (pkg/civitai/retry.go:174), per the index's own stated rule.
  • make ci rc=0, 0 FAIL, golangci-lint 0 issues.

…ly dropped

`main`'s Troubleshooting index went back to

    | `rate limited (429)` | Throttled; exit `6`. For deep paging use `--cursor`…

which is the exact 🔴 that #591 round 1 fixed, and it now contradicts the
generated section thirty lines above it — which still correctly says the message
reaches 2 or 6 and never 5. The `Civitai returned HTTP` row, the landing place
for the exit-5 case, was gone entirely.

HOW. #591 squash-merged at 02:51. At 03:50 I merged `main` into #585's branch,
resolved the two real conflicts, and took #585's README as the base — then
re-applied the main-side rows I could think of. #591's Troubleshooting rows were
in a region that never conflicted, so git had nothing to say about them and my
spot-check did not think of them.

This is the third time this exact trap has fired today, each time in a region
with no conflict: twice caught during a merge, once shipped to `main`. The
lesson stuck only partly — on the second merge I did run the systematic diff and
it found a drop my spot-check had missed. I did not run it on the first.

🔴 AND I NEARLY DESTROYED THE EVIDENCE. Having merged both PRs I deleted the
orphan branch, saying "nothing unique" — while the `git diff --stat` I had just
printed showed README differing by five lines. The object survived locally, and
those five lines were exactly this fix. Both rows below are restored VERBATIM
from that commit rather than retyped.

Verified: the restored left column `Civitai returned HTTP` is a real fragment of
a string the CLI prints (`pkg/civitai/retry.go:174`), per the index's own stated
rule, and make ci + golangci-lint are clean on the result.
@ZacxDev
ZacxDev merged commit 7467c62 into main Sep 14, 2026
13 checks passed
@ZacxDev
ZacxDev deleted the fix/restore-591-troubleshooting-rows branch September 14, 2026 04:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant