phase 3.3: docs — point README.md at patch-preservation governance
Two additions: 1. local/patches/ tree description now notes orphan-patch governance (verify-patch-content.sh + decision tree in AGENTS.md). Operators looking at the patches tree get the pointer to the audit doc. 2. Documentation list in README.md adds two new doc pointers: - PATCH-PRESERVATION-AUDIT-2026-07-12.md - COLLISION-DETECTION-STATUS.md Operator visibility only — no functional change to governance.
This commit is contained in:
@@ -203,6 +203,8 @@ Red Bear OS operates under strict discipline. Full policies: [`local/AGENTS.md`]
|
||||
- [Greeter & Login](local/docs/GREETER-LOGIN-IMPLEMENTATION-PLAN.md) — Native greeter, auth daemon, session launch
|
||||
- [DRM Modernization](local/docs/DRM-MODERNIZATION-EXECUTION-PLAN.md) — DRM/KMS display and render maturity
|
||||
- [USB Plan](local/docs/USB-IMPLEMENTATION-PLAN.md) — USB stack design and implementation
|
||||
- [Patch Preservation Audit](local/docs/PATCH-PRESERVATION-AUDIT-2026-07-12.md) — orphan-patch governance, Round 1-3 audit results, SUPERSEDED.md log
|
||||
- [Collision Detection Status](local/docs/COLLISION-DETECTION-STATUS.md) — runtime collision-detection current state
|
||||
- [Wi‑Fi Plan](local/docs/WIFI-IMPLEMENTATION-PLAN.md) — Wireless architecture and driver plan
|
||||
- [Bluetooth Plan](local/docs/BLUETOOTH-IMPLEMENTATION-PLAN.md) — Bluetooth stack design
|
||||
- [Build Cache](local/docs/BUILD-CACHE-PLAN.md) — Content-hash (BLAKE3) build cache system
|
||||
@@ -222,6 +224,12 @@ local/
|
||||
├── sources/ # Local forks of core components (kernel, relibc, base, bootloader, …)
|
||||
├── recipes/ # Custom packages — drivers, GPU stack, system daemons, branding
|
||||
├── patches/ # Durable changes to upstream source trees
|
||||
│ └── (orphan-patch governance: every patch must correspond to work
|
||||
│ present in the matching fork source tree. `verify-patch-content.sh`
|
||||
│ enforces this on every build preflight. See
|
||||
│ `local/docs/PATCH-PRESERVATION-AUDIT-2026-07-12.md` for the audit
|
||||
│ and AGENTS.md § "Orphan-Patch Supersession Decision Tree" for the
|
||||
│ decision flow when an orphan is detected.)
|
||||
├── docs/ # Integration and planning documentation
|
||||
└── scripts/ # Build, test, validation, and release tooling
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user