Record forge placement: workload to rapp-forgejo, layer to S4
This repo described itself as 'the forge layer' while the OAS Stack dimension defines five levels and forge is not one, leaving it unplaced. Placement decided 2026-08-11 (d151d817): the Forgejo workload becomes rapp-forgejo; the layer responsibility - runner placement, registry retention, artifact lifecycle, package credentials - folds into S4 railiance-enablement, which already declares the handoff contract. Notes that the retirement hypothesis was tested and rejected: this repo and helix-forge are different lineages, operational versus methodological. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
parent
88e24630c2
commit
59389f52eb
3 changed files with 118 additions and 1 deletions
27
INTENT.md
27
INTENT.md
|
|
@ -9,7 +9,7 @@
|
|||
|
||||
## One-liner
|
||||
|
||||
**The forge layer - turning source hosting, registries, and automation runners into dependable Railiance release infrastructure.**
|
||||
**The forge capability - turning source hosting, registries, and automation runners into dependable Railiance release infrastructure.**
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -113,6 +113,31 @@ build, publish, automate, and consume releases.
|
|||
|
||||
---
|
||||
|
||||
## Placement
|
||||
|
||||
This repository previously described itself as "the forge layer". The OAS Stack
|
||||
dimension defines five levels (S1-S5) and forge is not one of them, so that
|
||||
description left it unplaced - which is how layer boundaries erode.
|
||||
|
||||
Placement was decided 2026-08-11 (hub decision `d151d817`):
|
||||
|
||||
* the **Forgejo workload** becomes `rapp-forgejo`, a managed workload package
|
||||
* the **layer responsibility** - runner placement and labels, registry
|
||||
retention, artifact lifecycle, package credentials - folds into **S4
|
||||
`railiance-enablement`**, which already declares a handoff contract for
|
||||
exactly these concerns
|
||||
|
||||
A retirement hypothesis was tested and rejected: this repo and `helix-forge` are
|
||||
different lineages, not one maturing into the other. `helix-forge` is
|
||||
methodological (capability-first ecosystem, OAS dimensions, VSM vocabulary);
|
||||
this repo is operational. Retiring it would orphan responsibilities nothing
|
||||
else owns.
|
||||
|
||||
Until the migration completes, this repo remains the operating home for forge
|
||||
concerns. See `railiance-platform/ArchitectureBlueprint.md` section 5.2.
|
||||
|
||||
---
|
||||
|
||||
## Direction of Evolution
|
||||
|
||||
This layer is expected to evolve toward:
|
||||
|
|
|
|||
14
WORK-RECORDS.md
Normal file
14
WORK-RECORDS.md
Normal file
|
|
@ -0,0 +1,14 @@
|
|||
# Work Records — railiance-forge
|
||||
|
||||
> Generated by `statehub fix-consistency` (CUST-WP-0061-T04, work-record
|
||||
> stage 3). Do not edit by hand — edit the source file/block listed for
|
||||
> each record and re-run fix-consistency to refresh this index. Archived
|
||||
> workplans are omitted; closed decisions/intakes/engagements stay listed
|
||||
> so recently-resolved work is still visible. [auto]
|
||||
|
||||
| Kind | ID | Status | Lane | Source |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| workplan | RAILIANCE-WP-0002 | ready | — | workplans/RAILIANCE-WP-0002-forge-resource-economics-evidence.md |
|
||||
| task | RAILIANCE-WP-0002-T01 | todo | — | workplans/RAILIANCE-WP-0002-forge-resource-economics-evidence.md |
|
||||
| task | RAILIANCE-WP-0002-T02 | todo | — | workplans/RAILIANCE-WP-0002-forge-resource-economics-evidence.md |
|
||||
| task | RAILIANCE-WP-0002-T03 | todo | — | workplans/RAILIANCE-WP-0002-forge-resource-economics-evidence.md |
|
||||
|
|
@ -0,0 +1,78 @@
|
|||
---
|
||||
id: RAILIANCE-WP-0002
|
||||
type: workplan
|
||||
title: "Publish Forgejo resource economics evidence"
|
||||
domain: financials
|
||||
repo: railiance-forge
|
||||
status: ready
|
||||
owner: codex
|
||||
topic_slug: railiance
|
||||
created: "2026-08-11"
|
||||
updated: "2026-08-11"
|
||||
related:
|
||||
- RESOURCE-WP-0003
|
||||
state_hub_workstream_id: "72f935a5-d921-48a4-96e4-2365556c7374"
|
||||
---
|
||||
|
||||
# RAILIANCE-WP-0002 — Forgejo resource economics evidence
|
||||
|
||||
## Goal
|
||||
|
||||
Provide the workload-owned demand, utilization, operations, and allocation
|
||||
evidence for `resource:railiance:forgejo`, which supplies source and package
|
||||
infrastructure to Helix Forge and the wider federation. Origin:
|
||||
`RESOURCE-WP-0003-T04` delegated evidence gap.
|
||||
|
||||
## T01 — Measure Forgejo demand and utilization
|
||||
|
||||
```task
|
||||
id: RAILIANCE-WP-0002-T01
|
||||
status: todo
|
||||
priority: high
|
||||
state_hub_task_id: "7048e354-0844-4f6c-aeaa-acf188b04ce2"
|
||||
```
|
||||
|
||||
Record resource requests/limits and observed CPU/memory, repository and package
|
||||
storage use/growth, database storage, runner capacity/activity, backup volume,
|
||||
and material network traffic using stable units and timestamps.
|
||||
|
||||
Done when resource-control can forecast capacity and identify saturation or
|
||||
idle capacity without accessing repository content or credentials.
|
||||
|
||||
## T02 — Declare service objectives and operations labor
|
||||
|
||||
```task
|
||||
id: RAILIANCE-WP-0002-T02
|
||||
status: todo
|
||||
priority: high
|
||||
state_hub_task_id: "643c2393-2ee5-4264-972c-04c3b358dc86"
|
||||
```
|
||||
|
||||
Record availability, recovery, retention, and performance requirements plus
|
||||
setup and recurring operator activities. Separate forge, registry, runner,
|
||||
database, backup, upgrade, and incident labor where evidence permits.
|
||||
|
||||
Done when total-cost and optimization cases can preserve the forge's service
|
||||
constraints and labor assumptions.
|
||||
|
||||
## T03 — Publish shared-consumer allocation evidence
|
||||
|
||||
```task
|
||||
id: RAILIANCE-WP-0002-T03
|
||||
status: todo
|
||||
priority: medium
|
||||
state_hub_task_id: "498cc0c7-ba07-4e7f-a0ef-2e6b34bef04c"
|
||||
```
|
||||
|
||||
Define explainable candidate drivers for source, package, and runner use across
|
||||
Helix Forge, Coulomb, Railiance, and future tenants. Preserve shared overhead
|
||||
and unattributed residuals; do not implement customer billing.
|
||||
|
||||
Done when a versioned driver report can feed resource-control allocation
|
||||
without making the forge repository authoritative for booked cost.
|
||||
|
||||
## Acceptance
|
||||
|
||||
- [ ] Demand and utilization include storage, compute, runner, and backup axes.
|
||||
- [ ] Service objectives and labor assumptions are explicit.
|
||||
- [ ] Shared allocation evidence exposes residuals and provenance.
|
||||
Loading…
Add table
Add a link
Reference in a new issue