tegwick
f509da5606
Add is_identifier_registrar so only the production instance may mint hub UUIDs into repository files. Workstation hubs stay read/project caches until deterministic derivation lands. Also close RMGR-WP-0004-T05: register cutover is STATE-WP-0080-T02.
56 lines
2.1 KiB
Markdown
56 lines
2.1 KiB
Markdown
# Repository standards v0.1
|
|
|
|
Repo Manager **implements** Custodian canon. It does not author a second
|
|
definition. This note is an index.
|
|
|
|
| Concern | Canon |
|
|
| --- | --- |
|
|
| Categories and `.repo-classification.yaml` | `the-custodian/canon/standards/repo-classification-standard_v1.0.md` |
|
|
| `prj-` layout, `GOAL.md`, anti-pattern both purpose docs | `the-custodian/canon/standards/project-repository-flavor_v0.1.md` |
|
|
| One workplan prefix per repository | `the-custodian/canon/architecture/adr-007-workplan-identity-and-repo-worker-topology.md` |
|
|
|
|
## Flavor resolution
|
|
|
|
Precedence, then warn on disagreement (do not silently pick a winner for
|
|
operators — the first match is used only to choose the required-file set):
|
|
|
|
1. `.repo-classification.yaml` `category`
|
|
2. `GOAL.md` `repo_flavor`
|
|
3. slug prefix `prj-`
|
|
|
|
`prj-` layout (`GOAL.md`, no `INTENT.md`) applies when the slug starts
|
|
with `prj-` or `GOAL.md` declares `repo_flavor: project`. Not every
|
|
`category: project` repo is a `prj-` repo.
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
rmgr conform --path .
|
|
rmgr prefix-uniqueness --root ..
|
|
```
|
|
|
|
`prefix-uniqueness` is detection only. It does not rename files.
|
|
Registry: [`config/workplan-prefix-registry.yaml`](../config/workplan-prefix-registry.yaml).
|
|
|
|
Work: `RMGR-WP-0004-T01`, `RMGR-WP-0004-T08`.
|
|
|
|
## Identifier registrar (interim)
|
|
|
|
Until UUIDv5 derivation lands (`RMGR-WP-0005-T03`), only the registrar
|
|
instance may mint `state_hub_workstream_id` / `state_hub_task_id` into
|
|
files (`ADR-007` decision 2). Other hubs may read and project; they must
|
|
not write new hub primary keys into git.
|
|
|
|
| Signal | Registrar? |
|
|
| --- | --- |
|
|
| `STATEHUB_REGISTRAR=1` / `true` / `yes` / `on` | yes |
|
|
| `STATEHUB_REGISTRAR=0` / `false` / `no` / `off` | no |
|
|
| env unset, hostname starts with `railiance` | yes |
|
|
| env unset, any other hostname | no |
|
|
|
|
Accepted cost: new workplan/task registration requires connectivity to
|
|
the registrar. Disconnected work cannot register until T03. Implementation:
|
|
`repo_manager.registrar.is_identifier_registrar`; consumed by
|
|
`statehub fix-consistency` C-06 / C-11 / C-32.
|
|
|
|
Work: `RMGR-WP-0005-T01`.
|