Add Forgejo namespace workflow stack
This commit is contained in:
parent
482fd5d085
commit
865b676c99
68 changed files with 9709 additions and 11 deletions
|
|
@ -0,0 +1,61 @@
|
|||
# `BEP-0001` - Sovereign Forge and Governance Bootstrap
|
||||
|
||||
```text
|
||||
Status: Draft
|
||||
Proposal: BEP-0001
|
||||
Authors: gpt-5.4
|
||||
Coordinator: gpt-5.4
|
||||
Reviewers: Pending
|
||||
Constitution Sections: II, III, V
|
||||
Implementation PRs: Pending
|
||||
Decision Date: Pending
|
||||
```
|
||||
|
||||
## Summary
|
||||
|
||||
Burrow should own its forge, deployment logic, and operational context under `burrow.net`. This proposal establishes the repository-local governance and forge bootstrap required to move build, release, and infrastructure control out of GitHub-centric assumptions and into a self-hosted operating model.
|
||||
|
||||
## Motivation
|
||||
|
||||
- The repository currently keeps CI definitions under `.github/workflows/` but has no first-class self-hosted forge layout.
|
||||
- Infrastructure changes and protocol work are already entangled; without a design record, the project risks landing irreversible operations without enough context.
|
||||
- A self-hosted forge is a prerequisite for durable autonomy over source, runners, and release pipelines.
|
||||
|
||||
## Detailed Design
|
||||
|
||||
- Add a project constitution and BEP process under `evolution/`.
|
||||
- Introduce a Nix flake and NixOS host/module layout for `burrow-forge`.
|
||||
- Add Forgejo-native workflows under `.forgejo/workflows/` for repository-local CI.
|
||||
- Bootstrap the initial forge identity around `contact@burrow.net` and an agent-owned SSH workflow.
|
||||
|
||||
## Security and Operational Considerations
|
||||
|
||||
- Initial bootstrap may read credentials from local intake, but production must converge on encrypted secret handling.
|
||||
- The first forge host replacement must preserve rollback information before deleting any existing VM.
|
||||
- DNS for `burrow.net` is currently pending activation; the forge rollout must not assume public reachability until nameserver cutover completes.
|
||||
|
||||
## Contributor Playbook
|
||||
|
||||
- Keep destructive host operations behind explicit verification of the current Hetzner state.
|
||||
- Build and test repository-local workflows before using them for deployment.
|
||||
- Record the active server id, image, IPs, and SSH path before replacement.
|
||||
|
||||
## Alternatives Considered
|
||||
|
||||
- Continue relying on GitHub Actions while separately hosting services. Rejected because it leaves source authority and CI policy split across systems.
|
||||
- Stand up Forgejo without a repository-local operating model. Rejected because the repo would still be missing deployment truth.
|
||||
|
||||
## Impact on Other Work
|
||||
|
||||
- Blocks long-term migration of workflows away from GitHub.
|
||||
- Provides the governance anchor for protocol and control-plane proposals.
|
||||
|
||||
## Decision
|
||||
|
||||
Pending.
|
||||
|
||||
## References
|
||||
|
||||
- `CONSTITUTION.md`
|
||||
- `.github/workflows/`
|
||||
- `.forgejo/workflows/`
|
||||
Loading…
Add table
Add a link
Reference in a new issue