---
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"
---

# 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
```

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
```

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
```

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
```

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
```

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
```

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
```

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
```

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
```

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`