BFE EngineeringandClaude Fable 5
5155224594
Preparing the repo to go public (ADR-0007): - CI: kernel-build moves from the self-hosted runner to ubuntu-latest (installs its own cross toolchain + qemu, caches the pristine tarball). On a public repo a registered self-hosted runner is reachable from approved fork-PR workflows — i.e. arbitrary code on private infrastructure — and the build never actually needed the SDK host. ADR-0004 marked superseded-in-part; docs/ci-cd.md rewritten (site specifics now live only in the private deployment log). - Licensing: LICENSE gains the GPL-2.0 carve-out for patches/ and the kernel source excerpts (Linux derivatives; per-driver provenance was already tracked in PROVENANCE.md); patches/README.md states it too. - Scrubbed from the tip: bench-unit dev credentials and its gadget IP (m2-boot notes), the site AP SSID+BSSID and a neighboring AP's BSSID and the device WLAN MAC (wifi bring-up evidence — BSSIDs are geolocatable), the runner mesh IP. NOTE: these remain in git history; decision on a pre-publication history rewrite is separate. - Emoji cleanup across 21 tracked files (kernel port docs, review report, enforce-mcdc.sh) per repo text conventions: status marks became [x]/[wip]/[ ]/OK plain text. - "[maintainer]-gated" process phrasing normalized to "maintainer-gated" (attributions in dated evidence docs kept). Verified: zero emojis tracked; scrub grep clean; patches carry no internal references; ci.yml parses; shellcheck unchanged. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018HUayid7W5w7jBdb9Rrj1K
22 lines
1.0 KiB
Markdown
22 lines
1.0 KiB
Markdown
# ADR 0005 — Hardened drivers live in warden-sdk/drivers/
|
|
|
|
**Status:** Accepted (2026-08-25).
|
|
|
|
## Context
|
|
Our own hardware-facing driver code (relays, modbus master, RGA wrapper, HPMCU
|
|
supervisor, devmem/reset ladder, freshness) is the Tier-1 MC/DC target, but it
|
|
currently lives in flare-edge. The kernel driver source lives in an un-versioned
|
|
scratch tree (`flare-edge/research/linux-6.18.46/`).
|
|
|
|
## Decision
|
|
Bring **hardened copies into `warden-sdk/drivers/`** as the canonical source-of-truth,
|
|
each with its HAL seam and a 100% MC/DC host harness. The RV1106 kernel deltas are
|
|
formalized as a patch series in `patches/`. flare-edge consumes warden-sdk later
|
|
(separate, maintainer-gated step).
|
|
|
|
## Consequences
|
|
- Realizes the seam architecture (ADR-referenced in `docs/architecture.md`).
|
|
- flare-edge is not edited now; a later integration step points flare-edge at these.
|
|
- Risk: temporary duplication of shared constants between the two repos until the
|
|
integration lands — tracked, acceptable for the bring-up window.
|