vasilito
5851974b20
Release fork infrastructure: - REDBEAR_RELEASE=0.1.1 with offline enforcement (fetch/distclean/unfetch blocked) - 195 BLAKE3-verified source archives in standard format - Atomic provisioning via provision-release.sh (staging + .complete sentry) - 5-phase improvement plan: restore format auto-detection, source tree validation (validate-source-trees.py), archive-map.json, REPO_BINARY fallback Archive normalization: - Removed 87 duplicate/unversioned archives from shared pool - Regenerated all archives in consistent format with source/ + recipe.toml - BLAKE3SUMS and manifest.json generated from stable tarball set Patch management: - verify-patches.sh: pre-sync dry-run report (OK/REVERSED/CONFLICT) - 121 upstream-absorbed patches moved to absorbed/ directories - 43 active patches verified clean against rebased sources - Stress test: base updated to upstream HEAD, relibc reset and patched Compilation fixes: - relibc: Vec imports in redox-rt (proc.rs, lib.rs, sys.rs) - relibc: unsafe from_raw_parts in mod.rs (2024 edition) - fetch.rs: rev comparison handles short/full hash prefixes - kibi recipe: corrected rev mismatch New scripts: restore-sources.sh, provision-release.sh, verify-sources-archived.sh, check-upstream-releases.sh, validate-source-trees.py, verify-patches.sh, repair-archive-format.sh, generate-manifest.py Documentation: AGENTS.md, README.md, local/AGENTS.md updated for release fork model
100 lines
3.3 KiB
Markdown
100 lines
3.3 KiB
Markdown
# Red Bear OS Repository Governance
|
|
|
|
## Purpose
|
|
|
|
This document defines the repository-discipline rules for Red Bear OS so profile work stays
|
|
reproducible, reviewable, and upstream-friendly.
|
|
|
|
## Core Rules
|
|
|
|
### 1. Keep Red Bear work isolated
|
|
|
|
- Put Red Bear-specific source, recipes, scripts, and docs under `local/` whenever possible.
|
|
- Prefer patch files and symlinks over direct edits to upstream-managed source trees.
|
|
- Treat mainline Redox areas as upstream surfaces first, not as the default place for Red Bear
|
|
customization.
|
|
|
|
### 2. Profiles are the support surface
|
|
|
|
Tracked Red Bear profiles are:
|
|
|
|
- `redbear-mini`
|
|
- `redbear-full`
|
|
- `redbear-grub`
|
|
- `redbear-bluetooth-experimental`
|
|
- `redbear-wifi-experimental`
|
|
|
|
Every user-visible feature should name which profile(s) it belongs to.
|
|
|
|
### 3. Validation claims must be explicit
|
|
|
|
- `builds` means the package or profile compiles.
|
|
- `boots` means the image reaches a real bootable system state.
|
|
- `validated` means behavior has been tested on the claimed profile.
|
|
- `experimental` means present for bring-up but not support-promised.
|
|
|
|
Do not describe compile-only work as supported hardware or a working desktop path.
|
|
|
|
### 4. Prefer shared fragments over duplicated profile logic
|
|
|
|
- Shared profile file wiring belongs in reusable `config/redbear-*.toml` fragments.
|
|
- Avoid copy-pasting identical service definitions or file payloads across multiple Red Bear
|
|
profiles.
|
|
- Keep profile-specific behavior in the profile file only when the runtime behavior is actually
|
|
different.
|
|
|
|
### 5. Build helpers must match tracked profiles
|
|
|
|
If a profile is tracked in git, helper scripts and docs should either support it directly or state
|
|
why it is intentionally excluded.
|
|
|
|
### 6. Resilience policy: local-first package sources
|
|
|
|
- Red Bear builds must remain resilient when access to upstream Redox infrastructure is degraded or
|
|
unavailable.
|
|
- Local package/source copies are the default operational source of truth for builds.
|
|
- Upstream fetch/immutable archived is opt-in and must be explicitly requested by the operator (for example via
|
|
an explicit `--upstream` workflow).
|
|
- After an explicit upstream immutable archived, local durable release fork (`local/patches`, `local/recipes`) stay
|
|
authoritative until a conscious reevaluation/promotion decision is made.
|
|
|
|
## Profile Intent
|
|
|
|
### `redbear-mini`
|
|
|
|
Primary validation baseline: console, storage, package flow, and wired networking.
|
|
|
|
### `redbear-bluetooth-experimental`
|
|
|
|
First bounded Bluetooth validation profile: explicit-startup, USB-attached, BLE-first, and
|
|
experimental only.
|
|
|
|
### `redbear-full`
|
|
|
|
Desktop-capable tracked target for the current Red Bear session/network/runtime plumbing surface,
|
|
including graphics-path bring-up beneath the tracked KWin direction.
|
|
|
|
### `redbear-grub`
|
|
|
|
Text-only console/recovery target with GRUB boot manager for bare-metal multi-boot workflows.
|
|
|
|
### `redbear-wifi-experimental`
|
|
|
|
Bounded Intel Wi-Fi validation profile layered on the mini baseline.
|
|
|
|
## Change Checklist
|
|
|
|
For any substantial Red Bear change, record:
|
|
|
|
- objective
|
|
- profile impact
|
|
- files touched
|
|
- validation level (`builds`, `boots`, `validated`, `experimental`)
|
|
- known limitations
|
|
|
|
## Upstream Sync Discipline
|
|
|
|
- Rebase/sync through `local/scripts/provision-release.sh`.
|
|
- Keep Red Bear-specific diffs easy to audit.
|
|
- Update profile docs when config inheritance or package composition changes.
|