railiance-infra/workplans/RAIL-HO-WP-0006-forgejo-registry-ref-cleanup.md
codex 9477319783
All checks were successful
CI Smoke / source-contract (push) Successful in 12s
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 1s
fix(workplans): adopt ADR-007 derived identifiers for unregistered records
These workplans exist only in the retired local hub. Their random pre-ADR-007
identifiers are refused by C-06 as stale references, so they cannot be
registered. Deriving from the canonical record id takes no identity from
anything: central does not hold them and the old ids die with the cache.

Records central already holds were deliberately left untouched.

Refs CUST-WP-0068-T06

Assistant: claude-code
Assistant-Model: opus
Assistant-Process: 2583210@bnt-lap001
Assistant-Session: f2bff2d5-e9b2-4338-92ca-10282a927006
2026-08-25 20:20:13 +02:00

192 lines
No EOL
5 KiB
Markdown

---
id: RAIL-HO-WP-0006
type: workplan
title: "Forgejo Registry Ref Cleanup and WP-0005 Closeout Prep"
domain: financials
repo: railiance-infra
status: finished
owner: codex
topic_slug: railiance
created: "2026-07-09"
updated: "2026-07-09"
state_hub_workstream_id: "c54e5b14-1aa8-5907-b750-e0b531f6389f"
---
# Forgejo Registry Ref Cleanup and WP-0005 Closeout Prep
## Goal
Finish the post-cutover cleanup left after `RAIL-HO-WP-0005`: push pending layer-repo
commits, migrate remaining active OCI/npm/git references from `gitea.coulomb.social`
to `forgejo.coulomb.social`, resolve the stale `railiance-bootstrap` workstation
checkout, and refresh operator docs.
Depends on `RAIL-HO-WP-0005` T11/T12 (cutover + Option A fallback). Does **not**
retire Gitea Helm or close T04/T09 — the 7-day backup gate remains automatic
through **2026-07-12**.
## Scope boundary
| In scope | Out of scope |
| --- | --- |
| Active deploy manifests, Helm values, operator docs | Archived workplans and history |
| `issue-core`, `state-hub`, `whynot-design`, `ops-hub`, `core-hub`, `reuse-surface` | Gitea emergency rollback URLs in ArgoCD |
| Push commits already made in layer repos | Rebuilding/re-pushing container images |
| `~/railiance-bootstrap``railiance-cluster` symlink | WP-0005 T04/T09 7/7 gate (wait) |
## Tasks
### T01 — Push pending layer-repo commits
```task
id: RAIL-HO-WP-0006-T01
status: done
priority: high
state_hub_task_id: "3a93fb56-d7bd-52fd-8425-245e6df5c43c"
```
Push local commits on `railiance-apps`, `railiance-platform`, `activity-core`,
and `secrets-engine` from the prior registry migration session.
**Done (2026-07-09):** all four repos pushed; `main` aligned with `origin/main`.
---
### T02 — Migrate issue-core registry refs
```task
id: RAIL-HO-WP-0006-T02
status: done
priority: high
state_hub_task_id: "5a9194fa-551e-590e-b38c-624164b05047"
```
Update `issue-core` production deploy path and operator docs:
- `k8s/railiance/deployment.yaml` OCI image
- `docs/argocd-gitops.md`, `docs/package-release.md` (OCI + PyPI URLs)
**Done (2026-07-09):** deploy image and active docs use `forgejo.coulomb.social`.
---
### T03 — Migrate state-hub registry refs
```task
id: RAIL-HO-WP-0006-T03
status: done
priority: high
state_hub_task_id: "f0f345d0-4d1f-5c50-97e5-48f550327a01"
```
Update `state-hub` Helm values and operator docs:
- `deploy/railiance/apps/charts/state-hub/values.yaml`
- `docs/container-image.md`, `docs/cluster-operating-model.md`, `docs/onboarding.md`
- `deploy/railiance/README.md`
**Done (2026-07-09):** Helm values and operator docs use Forgejo.
---
### T04 — Migrate whynot-design npm and git refs
```task
id: RAIL-HO-WP-0006-T04
status: done
priority: medium
state_hub_task_id: "714ef254-a495-5898-94e3-7b062f84161e"
```
Update `whynot-design` publish/consume docs and `package.json`:
- npm registry → `forgejo.coulomb.social/api/packages/coulomb/npm/`
- git remote examples → `forgejo.coulomb.social`
**Done (2026-07-09):** `package.json`, README, PUBLISHING, CONSUMING updated.
---
### T05 — Migrate ops-hub OCI inventory refs
```task
id: RAIL-HO-WP-0006-T05
status: done
priority: medium
state_hub_task_id: "a9508dd5-b4f8-5373-a555-dfa2c93c3764"
```
Update `ops-hub` bootstrap seed and operator docs to Forgejo OCI `/v2/`.
**Done (2026-07-09):** `bootstrap.py`, `initial-inventory.md`, `readiness-gates.md`.
---
### T06 — Migrate core-hub deploy refs
```task
id: RAIL-HO-WP-0006-T06
status: done
priority: medium
state_hub_task_id: "a65d889f-a8e6-56e7-a189-7bb62bff49fc"
```
Update `core-hub` k8s manifests and deployment docs to Forgejo OCI paths.
**Done (2026-07-09):** staging + production runtime YAML and deploy READMEs.
---
### T07 — Update reuse-surface federation sources
```task
id: RAIL-HO-WP-0006-T07
status: done
priority: medium
state_hub_task_id: "1996d875-3be3-57f4-ad38-62ecef4999da"
```
Replace remaining `gitea.coulomb.social` raw URLs in
`reuse-surface/registry/federation/sources.yaml` and cached `.meta.yaml` files.
**Done (2026-07-09):** `sources.yaml`, `federated.yaml`, and federation cache meta.
---
### T08 — Symlink stale railiance-bootstrap checkout
```task
id: RAIL-HO-WP-0006-T08
status: done
priority: low
state_hub_task_id: "3cf2b117-b464-5f52-8c4a-cc3785679330"
```
Replace `~/railiance-bootstrap` (stale duplicate of `railiance-cluster`) with a
symlink to `~/railiance-cluster`. Preserve the old tree as
`~/railiance-bootstrap.stale-20260709`.
**Done (2026-07-09):** `~/railiance-bootstrap``railiance-cluster`; stale tree
preserved at `~/railiance-bootstrap.stale-20260709`.
---
### T09 — Refresh railiance-infra closeout docs
```task
id: RAIL-HO-WP-0006-T09
status: done
priority: low
state_hub_task_id: "4a26f82f-ea24-5691-9399-1fc14a60951f"
```
Update `docs/forgejo-gitea-retirement-checklist.md` with WP-0006 completion
notes and cross-repo evidence.
**Done (2026-07-09):** checklist updated with WP-0006 sweep evidence.
## References
- `workplans/RAIL-HO-WP-0005-forgejo-production-migration.md`
- `docs/forgejo-gitea-retirement-checklist.md`
- `railiance-apps/docs/forgejo-package-registry.md`