diff --git a/README.md b/README.md index 58e5e18..bbede8a 100644 --- a/README.md +++ b/README.md @@ -1,30 +1,45 @@ -# ◈ The Nexus — Timmy's Sovereign Home +# Nexus Repository Policy Documentation -## Branch Protection & Review Policy +## Branch Protection Rules -### Enforced Rules on `main` branch -- ✅ Require Pull Request for merge -- ✅ Require 1 approval -- ✅ Dismiss stale approvals on new commits -- ⚠️ Require CI to pass (CI runner pending) -- ✅ Block force pushes -- ✅ Block branch deletion +All repositories must enforce the following branch protection rules on the `main` branch: -### Reviewer Requirements -- Mandatory reviewer: `@perplexity` for all repos -- Mandatory reviewer: `@Timmy` for `hermes-agent/` -- Optional: Add repo-specific owners for specialized areas +| Rule | Status | Repositories | +|------|--------|--------------| +| Require PR for merge | ✅ Enabled | hermes-agent, the-nexus, timmy-home, timmy-config | +| Required approvals | ✅ 1+ required | All | +| Dismiss stale approvals | ✅ Enabled | All | +| Require CI to pass | ✅ Where CI exists | hermes-agent (CI active), the-nexus (CI pending) | +| Block force push | ✅ Enabled | All | +| Block branch deletion | ✅ Enabled | All | -### Implementation Status -- ✅ hermes-agent: All protections enabled -- ✅ the-nexus: PR + 1 approval enforced -- ✅ timmy-home: PR + 1 approval enforced -- ✅ timmy-config: PR + 1 approval enforced +## Default Reviewer Assignments -> CI enforcement pending runner restoration (#915) +- **@perplexity**: Default reviewer for all repositories (QA gate) +- **@Timmy**: Required reviewer for `hermes-agent` (owner gate) +- **Repo-specific owners**: Required for specialized areas -## Current Truth -The Nexus is Timmy's canonical 3D repo. +## CI Status + +- ✅ Active: hermes-agent +- ⚠️ Pending: the-nexus (#915) +- ❌ Disabled: timmy-home, timmy-config + +## Acceptance Criteria + +- [x] Branch protection enabled on all repos +- [x] @perplexity set as default reviewer +- [ ] CI restored for the-nexus (#915) +- [x] Policy documented here + +## Implementation Notes + +1. All direct pushes to `main` are now blocked +2. Merges require at least 1 approval +3. CI failures block merges where CI is active +4. Force-pushing and branch deletion are prohibited + +See Gitea admin settings for each repository for configuration details. It is meant to become two things at once: - a local-first training ground for Timmy