coulomb/repo-manager
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: add Railiance app wrapper best-practice guide

Browse source 
Record how rapp-* repos wrap first-party apps for Railiance, using
user-engine as the pilot. Opens RMGR-WP-0006 (T01 done) and includes
fix-consistency ID writeback for WP-0004/0005/0006.
This commit is contained in:
tegwick 2026-08-18 12:18:45 +02:00
parent c7fbd57800
commit 5197aa7425
6 changed files with 1002 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

11
workplans/RMGR-WP-0005-registrar-consolidation-deterministic-ids.md
View file

@ -16,6 +16,7 @@ related:
- STATE-WP-0080
- STATE-WP-0068
- CFED-WP-0001
state_hub_workstream_id: "7ddb5421-d960-4a3c-94b1-40b6c96abfab"
---
# Registrar consolidation and deterministic hub identifiers
@ -51,6 +52,7 @@ model; a file carrying a hub's private key is the file holding hub state.
id: RMGR-WP-0005-T01
status: todo
priority: high
state_hub_task_id: "b57a6882-280d-4f0a-9c73-899843dfc3d3"
```
Until derivation ships, exactly one instance may write hub identifiers into
@ -73,6 +75,7 @@ removes the need for the trade.
id: RMGR-WP-0005-T02
status: wait
priority: medium
state_hub_task_id: "8e679ddb-9845-457f-8672-1fd4b7455e7b"
```
Records minted by non-registrar instances before T01 need reconciliation. Known
@ -94,6 +97,7 @@ before then.
id: RMGR-WP-0005-T03
status: wait
priority: high
state_hub_task_id: "28067729-498d-4f47-89bd-5b9718e999c7"
```
Replace minted UUIDs with UUIDv5 derived from the globally unique
@ -116,6 +120,7 @@ same UUID for different workplans. Uniqueness must be enforced first.
id: RMGR-WP-0005-T04
status: wait
priority: high
state_hub_task_id: "503a23a9-ede1-4cf1-bd32-e9669b84ce58"
```
One-time pass over the 758 files carrying hub identifiers: compute the derived
@ -135,6 +140,7 @@ value, update the database to match, and write the file.
id: RMGR-WP-0005-T05
status: wait
priority: low
state_hub_task_id: "3946d1fc-2137-4d7b-a400-29b447ca83de"
```
Once derivation is live fleet-wide, remove the single-writer restriction from
@ -150,6 +156,7 @@ byte-identical writeback, and neither creates a duplicate record.
id: RMGR-WP-0005-T07
status: wait
priority: high
state_hub_task_id: "70f83359-0b61-4dc0-83b0-33f289b64e83"
```
Implement `ADR-010` decisions 1–3: the central hub on railiance is authoritative
@ -171,6 +178,7 @@ portion of the divergence is redundant and needs no merge — only a rebuild.
id: RMGR-WP-0005-T08
status: wait
priority: high
state_hub_task_id: "241cf058-2f3e-4d49-8cc9-5c714be4a1cf"
```
Implement `ADR-010` decision 4. The two kinds need opposite handling:
@ -197,6 +205,7 @@ reduces its scope.
id: RMGR-WP-0005-T09
status: wait
priority: high
state_hub_task_id: "d40cc4a8-4280-4940-ac1d-dc1049f1b678"
```
28 records exist in the local instance with no backing file. They are the only
@ -227,6 +236,7 @@ register collision)` in `repo-manager`, independent corroboration of the
id: RMGR-WP-0005-T10
status: wait
priority: medium
state_hub_task_id: "15f0f167-a8d0-4d5c-8576-3e93b1e8792f"
```
Implement `ADR-010` decision 7. The retirement splits one hub into several, which
@ -245,6 +255,7 @@ Coordinate with the hub-extension architecture in
id: RMGR-WP-0005-T06
status: wait
priority: medium
state_hub_task_id: "d440d59c-f78e-4752-84c7-f3d5fdf7d3c3"
```
Implement `ADR-007` decision 3: an automated normalization pass may report