cortex

The records of branes-ai/cortex.

Decisions

Architecture Decision Records

Decision	Status	Date
ADR 0001 — Third-party license compatibility	Accepted (amended 2026-11-01: third-party data and published facts)	2026-05-21
ADR 0002 — No GPL code; clean-room implementation from papers	Accepted (amended 2026-10-31: scope, the structure allowance, weak copyleft rejected; amended 2026-11-06: black-box benchmarking)	2026-05-21
ADR 0003 — Hybrid SDK: header-only templated operators, compiled glue	Accepted	2026-05-21
ADR 0004 — The Resource Manager allocates; the DFA compiler schedules	Accepted	2026-05-21
ADR 0005 — Managed lifecycle; no dynamic reconfiguration	Accepted	2026-05-20
ADR 0006 — Clean-room CV stack with an OpenCV-shaped API; no OpenCV	Accepted	2026-05-21
ADR 0007 — Dual delivery: OCI containers and Yocto recipes	Accepted	2026-05-20
ADR 0008 — Host Broker + Thin Client runtime topology	Accepted	2026-05-20
ADR 0009 — Crash-only Resource Manager recovery by client replay	Accepted	2026-05-20
ADR 0010 — repr(C) tensor metadata across the Rust/C++ boundary (not Arrow)	Accepted	2026-05-20
ADR 0011 — C++ dependencies via CMake FetchContent; no package manager	Accepted (amended 2026-10-07: CMake 4.0 minimum; Stillwater header-only fetch pattern)	2026-05-20
ADR 0012 — MSCKF first, behind a pluggable VIO backend interface	Accepted	2026-05-21
ADR 0013 — Analytical Jacobians only (no automatic differentiation, for now)	Accepted	2026-05-21
ADR 0014 — Middleware-agnostic core; Zenoh daemons as the black-box surface	Accepted	2026-05-20
ADR 0015 — Arithmetic type is a first-class template parameter	Accepted	2026-05-20
ADR 0016 — SITL vs. KPU is one build flag, confined to the Rust HAL	Accepted	2026-05-21

Plans

Complete

Plan	Issue	Updated
Plan: generate the site from docs/, and publish what docs/ already holds	branes-ai/cortex#528	2026-10-31
branes-ai/cortex Bootstrap Plan		2026-10-29