rfcs

Astrid RFCs is a specification repository holding design proposals for changes to the contract surface between the Astrid kernel and user-space. According to the README, RFCs are the authoritative specification for these interfaces, and implementations are expected to conform to them rather than the reverse. Scope of the contract surface includes the host ABI, IPC protocol, capability model, manifest schema, VFS semantics, capsule interface standards, and the public SDK API. The README lists situations that require an RFC: adding or changing a host function in the syscall table (astrid-sys), changing IPC topic conventions or payload schemas, modifying capability token format or validation semantics, changing the Capsule.toml manifest schema or dependency resolution, changing VFS path resolution rules or overlay behavior, defining a new capsule interface standard such as tool schemas or cross-capsule contracts, and breaking changes to the astrid-sdk public API. The documented process is: fork the repository and copy 0000-template.md to text/0000-my-feature.md; fill in the RFC with emphasis on motivation and a reference-level spec; open a pull request using that filename; discuss and revise on the PR; once consensus is reached, a maintainer assigns the next sequential number, renames the file to text/NNNN-my-feature.md, and merges; implementation then proceeds in astrid-sdk behind feature flags and in reference capsules. RFC lifecycle states are Draft (PR open, under discussion), Active (merged, types being implemented in astrid-sdk), Final (implemented and stable, with breaking changes requiring a new RFC), Withdrawn (closed without merge), and Superseded (replaced by a newer RFC, noted in the header). SDK integration is described as one feature flag per RFC, with examples for enabling an individual RFC type or all RFC types via the astrid-sdk dependency. The index currently lists RFC 0001, the RFC Process, as Active. The repository is dual-licensed under MIT and Apache 2.0, with copyright attributed to Joshua J. Bouw and Unicity Labs for 2025-2026.