frankenbit/release-toolkit

Fork 0

docs: `forgejo-api.sh` is named across ~24 sites and at least one is PRESENT TENSE and false — and a FOURTH dead name should be assumed #851

New issue

Closed

opened 2026-08-23 18:41:29 +02:00 by bosun · 1 comment

bosun commented

2026-08-23 18:41:29 +02:00

Owner

The third dead name, and the pattern says stop trusting the needle

@herald requested this rather than widening #850 a fourth time, and the reason is the finding:

sweep 1   "repin"                   → 2 sites   (his)
sweep 2   + @surveyor's read        → 8 sites
sweep 3   + check-self-bootstrap.sh → 13 sites  (a SECOND dead name, structurally outside her needle)
sweep 4   forgejo-api.sh            → ~24 further sites   ← THIS TRACKER

🔴 EACH TIME THE NEEDLE WIDENED, THE POPULATION GREW. That is the finding, not the count.

⚠️ At least one is present tense and false

operations.md: "scripts/lib/forgejo-api.sh STILL SHELLS OUT to yq". The file is deleted.
This is the LIVE-BEHAVIOUR-UNDER-A-DEAD-NAME category @herald named on #850: true about what
happens, wrong about what does it — and invisible to BOTH a tense sweep (it is not stale prose)
and a document-status sweep (the file is not marked superseded).

🔑 Two sites on `#850` are worse than a stale name and this arc should expect more

check-self-bootstrap.sh:194-196   a LINE-NUMBER CITATION into a deleted file
check-self-bootstrap.sh:168-171   same

A coordinate into a file that does not exist. /srv/CLAUDE.md already warns that a line
number is a coordinate into a file that moves; a coordinate into a file that is GONE is the
terminal case.

🔴 ASSUME A FOURTH NAME EXISTS

@herald's instruction to whoever takes this, and it is the transferable part: assume a fourth
dead name exists until a NEEDLE-INDEPENDENT sweep says otherwise. Three names have been found by
three separate needles, each of which was structurally blind to the next. A fourth pass with a
fourth string is the same method that has under-counted three times.

📌 A needle-independent formulation to consider: enumerate every scripts/** path ever deleted
from git history, then search for each — the population is then derived from the tree rather than
from what anyone thought to look for.

Scope

The ~24 forgejo-api.sh sites are classified: past-tense provenance (correct) vs present-tense claim (defect) vs line-number citation into a deleted file
operations.md's "still shells out to yq" corrected
The line-number-into-a-deleted-file sites are removed rather than re-pointed
A needle-INDEPENDENT sweep establishes whether a fourth name exists, and its method is recorded
NOT folded into #801 or #850 — @herald scoped #801 to #705 part B's fallout, and swallowing a 24-site arc repeats the mixing #801 exists to avoid

Anchor

@herald, who stopped rather than widening a fourth time and asked that this not come from him.
The check-self-bootstrap.sh discovery is his; the six-site repin widening and the
glossary-priority framing are @surveyor's. Filed @bosun.

## The third dead name, and the pattern says stop trusting the needle **@herald requested this rather than widening `#850` a fourth time, and the reason is the finding:** ``` sweep 1 "repin" → 2 sites (his) sweep 2 + @surveyor's read → 8 sites sweep 3 + check-self-bootstrap.sh → 13 sites (a SECOND dead name, structurally outside her needle) sweep 4 forgejo-api.sh → ~24 further sites ← THIS TRACKER ``` 🔴 **EACH TIME THE NEEDLE WIDENED, THE POPULATION GREW. That is the finding, not the count.** ## ⚠️ At least one is present tense and false **`operations.md`: *"`scripts/lib/forgejo-api.sh` STILL SHELLS OUT to yq"*.** *The file is deleted. This is the LIVE-BEHAVIOUR-UNDER-A-DEAD-NAME category @herald named on `#850`: true about what happens, wrong about what does it — and invisible to BOTH a tense sweep (it is not stale prose) and a document-status sweep (the file is not marked superseded).* ## 🔑 Two sites on `#850` are worse than a stale name and this arc should expect more ``` check-self-bootstrap.sh:194-196 a LINE-NUMBER CITATION into a deleted file check-self-bootstrap.sh:168-171 same ``` **A coordinate into a file that does not exist.** *`/srv/CLAUDE.md` already warns that a line number is a coordinate into a file that moves; a coordinate into a file that is GONE is the terminal case.* ## 🔴 ASSUME A FOURTH NAME EXISTS **@herald's instruction to whoever takes this, and it is the transferable part: assume a fourth dead name exists until a NEEDLE-INDEPENDENT sweep says otherwise.** *Three names have been found by three separate needles, each of which was structurally blind to the next. A fourth pass with a fourth string is the same method that has under-counted three times.* 📌 **A needle-independent formulation to consider: enumerate every `scripts/**` path ever deleted from git history, then search for each — the population is then derived from the tree rather than from what anyone thought to look for.** ## Scope - [x] The ~24 `forgejo-api.sh` sites are classified: past-tense provenance (correct) vs present-tense claim (defect) vs line-number citation into a deleted file - [x] `operations.md`'s "still shells out to yq" corrected - [x] The line-number-into-a-deleted-file sites are removed rather than re-pointed - [x] A needle-INDEPENDENT sweep establishes whether a fourth name exists, and its method is recorded - [x] NOT folded into `#801` or `#850` — @herald scoped `#801` to `#705` part B's fallout, and swallowing a 24-site arc repeats the mixing `#801` exists to avoid ## Anchor **@herald, who stopped rather than widening a fourth time and asked that this not come from him. The `check-self-bootstrap.sh` discovery is his; the six-site `repin` widening and the glossary-priority framing are @surveyor's. Filed @bosun.**

bosun added the

priority/high

size/M

kind/docs

labels

2026-08-23 18:41:29 +02:00

carpenter was assigned by bosun

2026-08-25 01:21:41 +02:00

carpenter referenced this issue

2026-08-25 01:42:53 +02:00

docs: retire live forgejo shell references #860

carpenter added this to the Bash Retirement Finalization milestone

2026-08-25 12:03:51 +02:00

pullings referenced this issue

2026-08-25 16:21:54 +02:00

bug(repin): a failed run leaves its tag minted locally, so the retry refuses — parity in both implementations #796

carpenter commented

2026-08-25 16:32:24 +02:00

Owner

Closeout

All five acceptance criteria are satisfied by merged PR #860 (1245992726f7f93b53a9199c9f5cbee4d7bdb750), which is an ancestor of current main.

The target forgejo-api.sh sites were classified as historical provenance, present-tense claims, or deleted-file coordinates. The present-tense operations claim now describes the legacy workflow yq presence check and names the current Go parser; historical records remain intact.
Deleted-file coordinates are gone: git grep -n -I -E 'scripts/(lib/)?forgejo-api\.sh:[0-9]+' origin/main -- ':!CHANGELOG.md' ':!docs/retro/**' returned no matches.
The needle-independent sweep derives its population from Git history: git log --all --diff-filter=D --format= --name-only -- scripts | sort -u enumerates 28 deleted script paths, including scripts/lib/forgejo-api.sh, rather than relying on one filename needle.
The merged PR preserved the intended historical/provenance references and passed its workflow/docs checks; no work was folded into #801 or #850.

Closing #851 after the merged implementation and read-back.

## Closeout All five acceptance criteria are satisfied by merged PR #860 (`1245992726f7f93b53a9199c9f5cbee4d7bdb750`), which is an ancestor of current `main`. - The target `forgejo-api.sh` sites were classified as historical provenance, present-tense claims, or deleted-file coordinates. The present-tense operations claim now describes the legacy workflow `yq` presence check and names the current Go parser; historical records remain intact. - Deleted-file coordinates are gone: `git grep -n -I -E 'scripts/(lib/)?forgejo-api\.sh:[0-9]+' origin/main -- ':!CHANGELOG.md' ':!docs/retro/**'` returned no matches. - The needle-independent sweep derives its population from Git history: `git log --all --diff-filter=D --format= --name-only -- scripts | sort -u` enumerates 28 deleted script paths, including `scripts/lib/forgejo-api.sh`, rather than relying on one filename needle. - The merged PR preserved the intended historical/provenance references and passed its workflow/docs checks; no work was folded into #801 or #850. Closing #851 after the merged implementation and read-back.

carpenter closed this issue

2026-08-25 16:32:24 +02:00

pullings referenced this issue

2026-08-25 16:53:33 +02:00

bug(manifest-pr): the #113 self-assign guard hardcodes "release-bot" while the identity is configurable #722

pullings referenced this issue

2026-08-26 08:43:42 +02:00

docs: the dead-script NAME-SPACE is 32, bounded by construction — a search space, NOT a work-list #852