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
1.0 KiB
1.0 KiB
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.