236 lines
7.4 KiB
Markdown
236 lines
7.4 KiB
Markdown
---
|
|
id: RAILIANCE-WP-0018
|
|
type: workplan
|
|
title: "First-Wave Repo Family Materialization"
|
|
domain: financials
|
|
repo: railiance-master
|
|
status: active
|
|
owner: codex
|
|
topic_slug: railiance
|
|
planning_priority: high
|
|
planning_order: 18
|
|
created: "2026-07-25"
|
|
updated: "2026-07-25"
|
|
related_repos:
|
|
- railiance-master
|
|
- railiance-cluster
|
|
- railiance-platform
|
|
- railiance-infra
|
|
- railiance-fabric
|
|
state_hub_workstream_id: "054a494c-e430-4164-b2c3-e32e759cc3e0"
|
|
---
|
|
|
|
# RAILIANCE-WP-0018 - First-Wave Repo Family Materialization
|
|
|
|
## Goal
|
|
|
|
Turn the completed separation architecture into the first concrete
|
|
`rail-*`, `rapp-*`, and `reef-*` repo materialization wave.
|
|
|
|
This workplan governs the first implementation wave that makes the new repo
|
|
families real rather than only defined. It stays in `railiance-master` because
|
|
the sequencing still spans multiple ownership repos and Fabric integration.
|
|
|
|
## Why This Exists
|
|
|
|
`RAILIANCE-WP-0017` completed the architecture baseline and launched the first
|
|
repo-local follow-up workplans.
|
|
|
|
What is still missing is the shared control plane for:
|
|
|
|
- creating the first concrete repo-family baselines
|
|
- keeping their boundaries consistent across repos
|
|
- aligning repo-local declarations with Fabric and State Hub ingestion
|
|
- preventing the first repo creations from drifting into ad hoc local patterns
|
|
|
|
## Current Starting Point
|
|
|
|
The architecture baseline already exists in `railiance-master`:
|
|
|
|
- `docs/repository-axes.md`
|
|
- `docs/rail-kubernetes-boundary.md`
|
|
- `docs/rapp-first-wave-candidates.md`
|
|
- `docs/reef-first-wave-rollout.md`
|
|
- `docs/fabric-state-hub-adaptation.md`
|
|
|
|
The first implementation follow-up work also already exists:
|
|
|
|
- `railiance-cluster/workplans/RAIL-BS-WP-0012-rail-kubernetes-extraction.md`
|
|
- `railiance-platform/workplans/RAILIANCE-WP-0012-rapp-openbao-extraction-boundary.md`
|
|
- `railiance-infra/workplans/RAIL-HO-WP-0007-first-reef-rollout-and-s1-canonicalization.md`
|
|
- `railiance-fabric/workplans/RAIL-FAB-WP-0025-rail-rapp-reef-fabric-adaptation.md`
|
|
|
|
Fabric now has first repo-family-aware repository metadata, but the ecosystem
|
|
still lacks:
|
|
|
|
- the first actual `rail-*` repo
|
|
- the first actual `rapp-*` repo
|
|
- the first actual `reef-*` repo
|
|
- relation projection for rail/rapp/reef topology
|
|
|
|
## Target Outcome
|
|
|
|
When this workplan is complete:
|
|
|
|
1. Railiance has a repeatable bootstrap contract for first-wave `rail-*`,
|
|
`rapp-*`, and `reef-*` repos.
|
|
2. The first concrete `rail-kubernetes` repo exists and is registered.
|
|
3. The first concrete `rapp-openbao` repo exists and is registered.
|
|
4. The first concrete `reef-railiance01` repo exists and is registered.
|
|
5. Fabric can project the minimum rail/rapp/reef relation topology needed to
|
|
answer placement questions.
|
|
|
|
## Boundaries
|
|
|
|
This workplan may coordinate repo creation, repo-family bootstrap, and graph
|
|
integration across Railiance repos.
|
|
|
|
It must not weaken the existing ownership boundaries:
|
|
|
|
- `railiance-cluster` remains the S2 ownership home
|
|
- `railiance-platform` remains the S3 ownership home for OpenBao
|
|
- `railiance-infra` remains the canonical S1 ownership home for first-wave reefs
|
|
- `railiance-fabric` remains the implementation home for graph ingestion and
|
|
projection
|
|
|
|
## Tasks
|
|
|
|
## T01 - Publish the first-wave repo bootstrap contract
|
|
|
|
```task
|
|
id: RAILIANCE-WP-0018-T01
|
|
status: done
|
|
priority: high
|
|
state_hub_task_id: "d6ba9286-222d-49d2-83e9-fd251c534dde"
|
|
```
|
|
|
|
Record the minimum bootstrap contract future `rail-*`, `rapp-*`, and
|
|
`reef-*` repos should follow so the first materialization wave does not invent
|
|
three incompatible patterns.
|
|
|
|
Acceptance:
|
|
|
|
- one framework document defines the minimum file baseline
|
|
- one framework document defines the first declaration path per repo family
|
|
- the metadata projection rule into Fabric and State Hub is named
|
|
|
|
2026-07-25: Added `docs/repo-family-bootstrap-contract.md`.
|
|
|
|
## T02 - Launch the first `rail-kubernetes` repo materialization
|
|
|
|
```task
|
|
id: RAILIANCE-WP-0018-T02
|
|
status: progress
|
|
priority: high
|
|
state_hub_task_id: "726a0c5c-2fa5-4bb9-a730-3200abc40ac8"
|
|
```
|
|
|
|
Create the concrete repo bootstrap and extraction path for `rail-kubernetes`
|
|
using the boundary already defined in `railiance-master` and the repo-local
|
|
follow-up work already opened in `railiance-cluster`.
|
|
|
|
Acceptance:
|
|
|
|
- the new repo has the required baseline files
|
|
- the repo declares the Kubernetes rail contract in source-controlled form
|
|
- the compatibility path from `railiance-cluster` is preserved
|
|
- the repo is ready for Fabric and State Hub registration
|
|
|
|
## T03 - Launch the first `rapp-openbao` repo materialization
|
|
|
|
```task
|
|
id: RAILIANCE-WP-0018-T03
|
|
status: wait
|
|
priority: high
|
|
state_hub_task_id: "3e46e1bd-c730-4e41-a00a-6aa7a4645023"
|
|
```
|
|
|
|
Create the concrete repo bootstrap and workload-package declaration for
|
|
`rapp-openbao` without letting the package repo absorb platform ownership.
|
|
|
|
Acceptance:
|
|
|
|
- the new repo has the required baseline files
|
|
- the repo declares OpenBao as a managed workload package
|
|
- the repo declares supported rails and rollout/smoke/rollback contract
|
|
- the remaining ownership boundary with `railiance-platform` stays explicit
|
|
|
|
## T04 - Launch the first `reef-railiance01` repo materialization
|
|
|
|
```task
|
|
id: RAILIANCE-WP-0018-T04
|
|
status: wait
|
|
priority: medium
|
|
state_hub_task_id: "f6f2ea73-0ff3-4cfa-b7a7-7b71db3afb4a"
|
|
```
|
|
|
|
Create the concrete repo bootstrap and substrate declaration for
|
|
`reef-railiance01` as the first durable reef repo.
|
|
|
|
Acceptance:
|
|
|
|
- the new repo has the required baseline files
|
|
- the repo declares substrate kind, lifecycle, criticality, hosted rails, and
|
|
primary rail
|
|
- the repo stays compatible with the canonical S1 ownership role of
|
|
`railiance-infra`
|
|
|
|
## T05 - Add relation projection for rails, `rapp`s, and reefs in Fabric
|
|
|
|
```task
|
|
id: RAILIANCE-WP-0018-T05
|
|
status: wait
|
|
priority: medium
|
|
state_hub_task_id: "ef999db5-e75e-467a-a72a-d45fda2b6fa7"
|
|
```
|
|
|
|
Extend Fabric beyond repo-family-aware metadata so it can project the minimum
|
|
rail/rapp/reef relation topology.
|
|
|
|
Acceptance:
|
|
|
|
- Fabric can project `supports_rail`
|
|
- Fabric can project `hosts_rail`
|
|
- Fabric can project `binds_rapp`
|
|
- Fabric can project `governed_by`
|
|
- the projection path is grounded in repo-local declarations rather than
|
|
registry-only guesses
|
|
|
|
## T06 - Verify first-wave registration and coordination end to end
|
|
|
|
```task
|
|
id: RAILIANCE-WP-0018-T06
|
|
status: wait
|
|
priority: medium
|
|
state_hub_task_id: "5834f122-b9e9-41c1-93e9-d5525cd720bf"
|
|
```
|
|
|
|
Verify that the first concrete repos participate cleanly in:
|
|
|
|
- State Hub registration and indexing
|
|
- Fabric registration and graph projection
|
|
- workplan tracking across ownership repo and repo-family repo boundaries
|
|
|
|
Acceptance:
|
|
|
|
- the first concrete repos are visible to State Hub
|
|
- the first concrete repos are visible to Fabric
|
|
- cross-repo ownership and runtime relations are queryable
|
|
- the wave can continue to second candidates without redefining the bootstrap model
|
|
|
|
## Exit Criteria
|
|
|
|
- [x] The first-wave bootstrap contract is published
|
|
- [ ] `rail-kubernetes` exists as a first-class repo baseline
|
|
- [ ] `rapp-openbao` exists as a first-class repo baseline
|
|
- [ ] `reef-railiance01` exists as a first-class repo baseline
|
|
- [ ] Fabric projects the minimum rail/rapp/reef relation topology
|
|
- [ ] State Hub and Fabric can coordinate the first concrete repo-family wave end to end
|
|
|
|
## Notes
|
|
|
|
This workplan should stay focused on the first concrete repo-family wave.
|
|
|
|
Second-wave candidates such as `rapp-vergabe-teilnahme`, `reef-coulombcore`,
|
|
or a future `rail-knative` should be launched only after the first wave proves
|
|
the bootstrap contract, registration path, and relation model.
|