docs: separate native kernel work from Linux Realm by joshuajbouw · Pull Request #1808 · astrid-runtime/astrid · GitHub
Skip to content

docs: separate native kernel work from Linux Realm - #1808

Open
joshuajbouw wants to merge 1 commit into
mainfrom
codex/docs-track-separation
Open

docs: separate native kernel work from Linux Realm#1808
joshuajbouw wants to merge 1 commit into
mainfrom
codex/docs-track-separation

Conversation

@joshuajbouw

@joshuajbouw joshuajbouw commented Sep 1, 2026

Copy link
Copy Markdown
Member

Linked Issue

Tracking #1564. Related: #1803 and #1805.

Summary

Corrects documentation that conflated the native kernel track with Linux Realm work.

The documentation now describes hosted, native-kernel, and Linux Realm evidence without presenting unlanded work as shipped behavior.

Changes

  • Separates native kernel and Linux Realm responsibilities.
  • Removes stale or overbroad implementation claims.
  • Narrows FSKit and runtime-layout language to verified behavior.

Verification

  • Documentation was checked against current source and the active architecture records.
  • This PR changes no runtime behavior or release artifact.

AI / Tool Assistance

Assisted-by: Codex

AI assistance was used to audit and edit documentation. The maintainer owns the final wording and publication decision.

Checklist

  • Scope is documentation-only
  • Related implementation work identified
  • Required repository checks complete

Retract the claim that aos-ce main already ships a Realm workbench. Keep
Linux Realm an optional confined consumer, not the next native-kernel
artifact. Record that the current FSKit app is still a visible developer
surface, not a hidden CLI-only product container.

Signed-off-by: Joshua J. Bouw <jjb@unicity-labs.com>
Copilot AI balanced review requested due to automatic review settings September 1, 2026 16:18
@joshuajbouw joshuajbouw added the skip-changelog Skip changelog enforcement for this PR label Sep 1, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates architecture documentation to separate native-kernel work from the unimplemented Linux Realm track.

Changes:

  • Retracts shipped Linux Realm claims.
  • Reorders native-kernel priorities.
  • Clarifies FSKit’s current developer-facing status.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.

File Description
native/macos/AstridFSKit/README.md Documents CLI contract and current UI limitations.
docs/astrid-native-kernel.md Separates kernel and Realm roadmaps.
docs/astrid-fleet-computer.md Marks Realm as unimplemented.
docs/astrid-ai-native-os-workplan.md Revises Realm status and execution order.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

- [Astrid Tensor Logic Composition](astrid-tensor-logic-composition.md)
- [Astrid Driver Domain Contract](astrid-driver-domain-contract.md)
- [AOS Principal Linux Realm](https://github.com/unicity-aos/aos-ce/blob/main/docs/principal-linux-realm.md)
- [AOS Principal Linux Realm](https://github.com/unicity-aos/aos-ce/blob/main/docs/principal-linux-realm.md) (accepted consumer contract; not implemented on current aos-ce `main`)
- [Astrid Hosted Volume Format 1](../crates/astrid-storage/formats/astrid-volume-v1.txt)
- [Astrid Native Component Kernel](astrid-native-kernel.md)
- [AOS Principal Linux Realm](https://github.com/unicity-aos/aos-ce/blob/main/docs/principal-linux-realm.md), an optional Linux capsule consumer
- [AOS Principal Linux Realm](https://github.com/unicity-aos/aos-ce/blob/main/docs/principal-linux-realm.md), an optional Linux capsule consumer (accepted contract; not implemented on current aos-ce `main`)
- [Astrid Hosted Volume Format 1](../crates/astrid-storage/formats/astrid-volume-v1.txt)
- [Astrid Native Component Kernel](astrid-native-kernel.md)
- [AOS Principal Linux Realm](https://github.com/unicity-aos/aos-ce/blob/main/docs/principal-linux-realm.md), an optional Linux capsule consumer
- [AOS Principal Linux Realm](https://github.com/unicity-aos/aos-ce/blob/main/docs/principal-linux-realm.md), an optional Linux capsule consumer (accepted contract; not implemented on current aos-ce `main`)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

skip-changelog Skip changelog enforcement for this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants