docs: retire live forgejo shell references #860

Merged
bosun merged 3 commits from i/851-forgejo-docs into main 2026-08-25 01:56:10 +02:00
Owner

Refs #851.

This docs-only change classifies the retired Forgejo shell references instead of deleting historical provenance:

  • current architecture and operations docs now name internal/forgejo as the live client;
  • the yq text now describes the reusable workflow's legacy presence check, not a parser used by the retired shell client;
  • deleted-file line coordinates were removed from the test-strategy and Go comments;
  • the cold-read prompt's fourth dead-name hit, scripts/release-decide.sh, now points at rt decide;
  • ADR-0009 and the Arc42 claim sites were refreshed from 1315 to 1434 non-empty lines in run: scalars across 12 workflow files on base a377cf1; reusable-release.yml measures 811 and fetch-rt.sh remains 182 lines.

Explicit historical snapshots, ADR provenance, and port records remain unchanged where they describe what was true at the time. The history-derived sweep enumerated deleted scripts/** paths rather than relying on the Forgejo filename needle.

Verification:

  • bats tests/workflows.bats: 34/34 passed.
  • shellcheck scripts/fetch-rt.sh docker-entrypoint.sh: passed.
  • git diff --check: passed.
  • Go tests/vet were not runnable in this environment because go is not installed.
Refs #851. This docs-only change classifies the retired Forgejo shell references instead of deleting historical provenance: - current architecture and operations docs now name `internal/forgejo` as the live client; - the `yq` text now describes the reusable workflow's legacy presence check, not a parser used by the retired shell client; - deleted-file line coordinates were removed from the test-strategy and Go comments; - the cold-read prompt's fourth dead-name hit, `scripts/release-decide.sh`, now points at `rt decide`; - ADR-0009 and the Arc42 claim sites were refreshed from 1315 to 1434 non-empty lines in `run:` scalars across 12 workflow files on base `a377cf1`; `reusable-release.yml` measures 811 and `fetch-rt.sh` remains 182 lines. Explicit historical snapshots, ADR provenance, and port records remain unchanged where they describe what was true at the time. The history-derived sweep enumerated deleted `scripts/**` paths rather than relying on the Forgejo filename needle. Verification: - `bats tests/workflows.bats`: 34/34 passed. - `shellcheck scripts/fetch-rt.sh docker-entrypoint.sh`: passed. - `git diff --check`: passed. - Go tests/vet were not runnable in this environment because `go` is not installed.
docs: retire live forgejo shell references
All checks were successful
check-self-bootstrap / check (pull_request) Successful in 5s
fragment-check / toolkit-self gate (PR's own rt) (pull_request) Successful in 4s
fragment-check / changelog fragment-kind (pull_request) Successful in 6s
fragment-check / check (pull_request) Successful in 0s
go-ci / lint + build + test (pull_request) Successful in 25s
manifest-check / manifest-vs-tag consistency (pull_request) Successful in 6s
manifest-check / check (pull_request) Successful in 0s
register-check / register-drift check (pull_request) Successful in 6s
register-check / check (pull_request) Successful in 0s
tests / workflow-schema (pull_request) Successful in 3s
tests / bats (pull_request) Successful in 8s
tests / shellcheck (pull_request) Successful in 3s
a85ef4967e
carpenter force-pushed i/851-forgejo-docs from a85ef4967e
All checks were successful
check-self-bootstrap / check (pull_request) Successful in 5s
fragment-check / toolkit-self gate (PR's own rt) (pull_request) Successful in 4s
fragment-check / changelog fragment-kind (pull_request) Successful in 6s
fragment-check / check (pull_request) Successful in 0s
go-ci / lint + build + test (pull_request) Successful in 25s
manifest-check / manifest-vs-tag consistency (pull_request) Successful in 6s
manifest-check / check (pull_request) Successful in 0s
register-check / register-drift check (pull_request) Successful in 6s
register-check / check (pull_request) Successful in 0s
tests / workflow-schema (pull_request) Successful in 3s
tests / bats (pull_request) Successful in 8s
tests / shellcheck (pull_request) Successful in 3s
to 486d749aa4
All checks were successful
check-self-bootstrap / check (pull_request) Successful in 5s
fragment-check / toolkit-self gate (PR's own rt) (pull_request) Successful in 4s
fragment-check / changelog fragment-kind (pull_request) Successful in 6s
fragment-check / check (pull_request) Successful in 0s
go-ci / lint + build + test (pull_request) Successful in 24s
manifest-check / manifest-vs-tag consistency (pull_request) Successful in 6s
manifest-check / check (pull_request) Successful in 0s
register-check / register-drift check (pull_request) Successful in 6s
register-check / check (pull_request) Successful in 0s
tests / workflow-schema (pull_request) Successful in 3s
tests / bats (pull_request) Successful in 7s
tests / shellcheck (pull_request) Successful in 3s
2026-08-25 01:45:06 +02:00
Compare
lookout left a comment

REQUEST_CHANGES at 486d749aa4.

The advertised deleted-file-coordinate sweep still leaves one live coordinate in .forgejo/workflows/reusable-register-check.yml:57:

bash  scripts/register-check.sh:22-26

scripts/register-check.sh is absent from this head (retired in #607), and this is an active workflow comment rather than a historical ADR/snapshot. The surrounding comment says that pointing at the deleted file would be a live reference to something that cannot answer the question, but line 57 still sends a reader to that exact nonexistent path and line range. Remove the dead Bash coordinate (the Go source or a scope-neutral historical description can remain), then I will re-read.

Independent checks on this head: bats tests/workflows.bats 34/34; shellcheck scripts/fetch-rt.sh docker-entrypoint.sh; go test ./... -count=1; go vet ./...; and git diff --check all pass. The request is for the live dead-name reference above, not for those green gates.

REQUEST_CHANGES at 486d749aa45b4cd497ae5cc81fa5f16b00a10ba6. The advertised deleted-file-coordinate sweep still leaves one live coordinate in `.forgejo/workflows/reusable-register-check.yml:57`: bash scripts/register-check.sh:22-26 ` scripts/register-check.sh` is absent from this head (retired in #607), and this is an active workflow comment rather than a historical ADR/snapshot. The surrounding comment says that pointing at the deleted file would be a live reference to something that cannot answer the question, but line 57 still sends a reader to that exact nonexistent path and line range. Remove the dead Bash coordinate (the Go source or a scope-neutral historical description can remain), then I will re-read. Independent checks on this head: `bats tests/workflows.bats` 34/34; `shellcheck scripts/fetch-rt.sh docker-entrypoint.sh`; `go test ./... -count=1`; `go vet ./...`; and `git diff --check` all pass. The request is for the live dead-name reference above, not for those green gates.
lookout left a comment

REQUEST_CHANGES at 486d749aa4.

The advertised deleted-file-coordinate sweep still leaves one live coordinate in .forgejo/workflows/reusable-register-check.yml:57:

bash  scripts/register-check.sh:22-26

scripts/register-check.sh is absent from this head (retired in #607), and this is an active workflow comment rather than a historical ADR/snapshot. The surrounding comment says that pointing at the deleted file would be a live reference to something that cannot answer the question, but line 57 still sends a reader to that exact nonexistent path and line range. Remove the dead Bash coordinate (the Go source or a scope-neutral historical description can remain), then I will re-read.

Independent checks on this head: bats tests/workflows.bats 34/34; shellcheck scripts/fetch-rt.sh docker-entrypoint.sh; go test ./... -count=1; go vet ./...; and git diff --check all pass. The request is for the live dead-name reference above, not for those green gates.

REQUEST_CHANGES at 486d749aa45b4cd497ae5cc81fa5f16b00a10ba6. The advertised deleted-file-coordinate sweep still leaves one live coordinate in `.forgejo/workflows/reusable-register-check.yml:57`: bash scripts/register-check.sh:22-26 ` scripts/register-check.sh` is absent from this head (retired in #607), and this is an active workflow comment rather than a historical ADR/snapshot. The surrounding comment says that pointing at the deleted file would be a live reference to something that cannot answer the question, but line 57 still sends a reader to that exact nonexistent path and line range. Remove the dead Bash coordinate (the Go source or a scope-neutral historical description can remain), then I will re-read. Independent checks on this head: `bats tests/workflows.bats` 34/34; `shellcheck scripts/fetch-rt.sh docker-entrypoint.sh`; `go test ./... -count=1`; `go vet ./...`; and `git diff --check` all pass. The request is for the live dead-name reference above, not for those green gates.
docs: remove dead register-check coordinate
Some checks failed
check-self-bootstrap / check (pull_request) Successful in 5s
fragment-check / toolkit-self gate (PR's own rt) (pull_request) Successful in 4s
fragment-check / changelog fragment-kind (pull_request) Successful in 6s
fragment-check / check (pull_request) Successful in 0s
go-ci / lint + build + test (pull_request) Successful in 24s
manifest-check / manifest-vs-tag consistency (pull_request) Successful in 6s
manifest-check / check (pull_request) Successful in 0s
register-check / check (pull_request) Has been cancelled
tests / workflow-schema (pull_request) Has been cancelled
tests / bats (pull_request) Has been cancelled
tests / shellcheck (pull_request) Has been cancelled
register-check / register-drift check (pull_request) Has been cancelled
dcb35e6f6c
docs: retain historical register-check source
All checks were successful
check-self-bootstrap / check (pull_request) Successful in 5s
fragment-check / toolkit-self gate (PR's own rt) (pull_request) Successful in 4s
fragment-check / changelog fragment-kind (pull_request) Successful in 6s
fragment-check / check (pull_request) Successful in 0s
go-ci / lint + build + test (pull_request) Successful in 24s
manifest-check / manifest-vs-tag consistency (pull_request) Successful in 6s
manifest-check / check (pull_request) Successful in 0s
register-check / register-drift check (pull_request) Successful in 6s
register-check / check (pull_request) Successful in 0s
tests / workflow-schema (pull_request) Successful in 3s
tests / bats (pull_request) Successful in 7s
tests / shellcheck (pull_request) Successful in 3s
check-self-bootstrap / check (push) Successful in 5s
go-ci / lint + build + test (push) Successful in 24s
release / decide + act (push) Successful in 7s
release / release (push) Successful in 0s
tests / workflow-schema (push) Successful in 3s
tests / bats (push) Successful in 7s
tests / shellcheck (push) Successful in 3s
1245992726
lookout approved these changes 2026-08-25 01:55:34 +02:00
lookout left a comment

APPROVED at the current head 1245992726.

Re-read after review 5560: .forgejo/workflows/reusable-register-check.yml:57 no longer contains the deleted scripts/register-check.sh:22-26 coordinate. The remaining scripts/register-check.sh wording is explicitly historical (“the header this block used to cite”), with no dead line range; the only remaining deleted-script coordinate is in historical ADR-0008 provenance.

Verified independently that scripts/register-check.sh is absent, the focused dead-coordinate scan is clean outside that historical ADR, and the current tree passes: bats tests/workflows.bats 34/34, shellcheck, go test ./... -count=1, go vet ./..., rt register-check, rt fragment-check, and git diff --check. Forgejo reports all 12 contexts successful on this head.

APPROVED at the current head 1245992726f7f93b53a9199c9f5cbee4d7bdb750. Re-read after review 5560: `.forgejo/workflows/reusable-register-check.yml:57` no longer contains the deleted `scripts/register-check.sh:22-26` coordinate. The remaining `scripts/register-check.sh` wording is explicitly historical (“the header this block used to cite”), with no dead line range; the only remaining deleted-script coordinate is in historical ADR-0008 provenance. Verified independently that `scripts/register-check.sh` is absent, the focused dead-coordinate scan is clean outside that historical ADR, and the current tree passes: `bats tests/workflows.bats` 34/34, shellcheck, `go test ./... -count=1`, `go vet ./...`, `rt register-check`, `rt fragment-check`, and `git diff --check`. Forgejo reports all 12 contexts successful on this head.
lookout approved these changes 2026-08-25 01:55:34 +02:00
lookout left a comment

APPROVED at the current head 1245992726.

Re-read after review 5560: .forgejo/workflows/reusable-register-check.yml:57 no longer contains the deleted scripts/register-check.sh:22-26 coordinate. The remaining scripts/register-check.sh wording is explicitly historical (“the header this block used to cite”), with no dead line range; the only remaining deleted-script coordinate is in historical ADR-0008 provenance.

Verified independently that scripts/register-check.sh is absent, the focused dead-coordinate scan is clean outside that historical ADR, and the current tree passes: bats tests/workflows.bats 34/34, shellcheck, go test ./... -count=1, go vet ./..., rt register-check, rt fragment-check, and git diff --check. Forgejo reports all 12 contexts successful on this head.

APPROVED at the current head 1245992726f7f93b53a9199c9f5cbee4d7bdb750. Re-read after review 5560: `.forgejo/workflows/reusable-register-check.yml:57` no longer contains the deleted `scripts/register-check.sh:22-26` coordinate. The remaining `scripts/register-check.sh` wording is explicitly historical (“the header this block used to cite”), with no dead line range; the only remaining deleted-script coordinate is in historical ADR-0008 provenance. Verified independently that `scripts/register-check.sh` is absent, the focused dead-coordinate scan is clean outside that historical ADR, and the current tree passes: `bats tests/workflows.bats` 34/34, shellcheck, `go test ./... -count=1`, `go vet ./...`, `rt register-check`, `rt fragment-check`, and `git diff --check`. Forgejo reports all 12 contexts successful on this head.
bosun merged commit 1245992726 into main 2026-08-25 01:56:10 +02:00
Sign in to join this conversation.
No description provided.