rfcs README

The project's README from github.com/astrid-runtime/rfcs. As one markdown file: README.md.

Astrid RFCs

License: MIT OR Apache-2.0

Design proposals for changes to Astrid's kernel-to-user-space contract.

RFCs govern any substantial change to the contract surface between the kernel and user-space: the host ABI, IPC protocol, capability model, manifest schema, VFS semantics, capsule interface standards, and SDK public API. They are the authoritative specification - implementations conform to them, not the other way around.

When you need an RFC

Process

  1. Fork this repo and copy 0000-template.md to text/0000-my-feature.md.
  2. Fill in the RFC. Focus on motivation and the reference-level spec.
  3. Open a pull request. Use the filename 0000-my-feature.md in the PR.
  4. Discussion happens on the PR. Revise as needed.
  5. When consensus is reached, a maintainer assigns the next sequential RFC number, renames the file to text/NNNN-my-feature.md, and merges.
  6. Implementation proceeds in astrid-sdk (types behind feature flags) and reference capsules.

Lifecycle

SDK integration

Each RFC maps to an astrid-sdk feature flag:

# Individual RFC types
astrid-sdk = { version = "0.2", features = ["rfc-1"] }

# All RFC types
astrid-sdk = { version = "0.2", features = ["all-rfcs"] }

Index

RFC Title Status
0001 RFC Process Active

License

Dual-licensed under MIT and Apache 2.0.

Copyright (c) 2025-2026 Joshua J. Bouw and Unicity Labs.

rfcs (astrid-runtime/rfcs)

Searching Database…

4.2K ·GitHub
Что это такое?Этот репозиторий хранит RFC (проектные предложения), определяющие любые существенные изменения контракта между ядром Astrid и user-space: host ABI, протокол IPC, модель возможностей, схему манифеста, семантику VFS, стандарты интерфейсов капсул и публичный API SDK.
Это настоящая программная библиотека или просто набор проектных документов?Это чисто набор markdown-спецификаций и процесс управления, а не исполняемый код — в README сказано, что реализации должны соответствовать RFC, а не наоборот.
Как предложить изменение через RFC?Сделайте форк репозитория, скопируйте 0000-template.md в text/0000-my-feature.md, заполните мотивацию и спецификацию уровня reference и откройте pull request с этим именем файла для обсуждения.
Какие изменения реально требуют написания RFC?Всё, что затрагивает таблицу сисколлов в astrid-sys, схемы topic/payload для IPC, формат capability-токенов, схему манифеста Capsule.toml, разрешение путей VFS, новые стандарты интерфейсов капсул или ломающие изменения публичного API astrid-sdk.
Означает ли смерженный RFC, что функция готова к использованию?Нет — смерженный RFC лишь в статусе „Active“; его типы ещё нужно реализовать за feature flags в astrid-sdk и в reference-капсулах, прежде чем он станет „Final“ и стабильным.
Сколько RFC сейчас существует?Всего один — RFC 0001 „RFC Process“, сейчас помечен как Active.
Что означают стадии жизненного цикла RFC?Draft — PR открыт для обсуждения; Active — смержен и реализуется в astrid-sdk; Final — реализован и стабилен; Withdrawn — закрыт без слияния; Superseded — заменён более новым RFC.
Что такое „капсула“ в Astrid?Судя по упомянутым схемам, капсула — единица user-space кода в Astrid, описываемая манифестом Capsule.toml и соответствующая определённым стандартам интерфейсов капсул вроде схем инструментов и контрактов между капсулами.
Как принятый RFC реально попадает в SDK?Когда достигнут консенсус и RFC смержен, мейнтейнер присваивает ему порядковый номер, после чего реализация идёт в astrid-sdk за feature flags, а также в reference-капсулах.
What are similar projects?book, EIPs, spec, design, bips, spec, api-guidelines, swift-evolution
Size
0.4 MB
Stars
4.2K
Updated
CommitJul 13
Age
7mo
Commits · 90 Days