Skip to content

Orchestrator Platform - #391

Merged
leongross merged 5 commits into
OpenPRoT:mainfrom
9elements:fwmanager-docs
Aug 17, 2026
Merged

Orchestrator Platform #391
leongross merged 5 commits into
OpenPRoT:mainfrom
9elements:fwmanager-docs

Conversation

@chrysh

@chrysh chrysh commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

First draft of the fwmanager responsibilities and block diagram.

@chrysh chrysh mentioned this pull request Aug 4, 2026
@chrysh
chrysh marked this pull request as ready for review August 5, 2026 08:28
@rusty1968
rusty1968 requested a review from CourtneyDrant August 5, 2026 21:34
Comment thread docs/src/design/orchestrator/orchestrator-platform.md
Comment thread docs/src/design/orchestrator/orchestrator-platform.md Outdated
Comment thread docs/src/design/orchestrator/orchestrator-platform.md Outdated
Comment thread docs/src/design/orchestrator/orchestrator-platform.md Outdated
@chrysh
chrysh force-pushed the fwmanager-docs branch 2 times, most recently from 7f41c9f to 1d12620 Compare August 6, 2026 20:17
@rusty1968 rusty1968 changed the title Fwmanager docs Orchestrator Platform Aug 6, 2026
@rusty1968

Copy link
Copy Markdown
Collaborator

Overall, it tries to describe the entire orchestrator mission instead of focusing on the platform side of things.

@chrysh
chrysh force-pushed the fwmanager-docs branch 2 times, most recently from 8e05b19 to 349494b Compare August 7, 2026 09:52
@chrysh

chrysh commented Aug 8, 2026

Copy link
Copy Markdown
Contributor Author

Overall, it tries to describe the entire orchestrator mission instead of focusing on the platform side of things.

Should be fixed now.

Comment thread docs/src/design/orchestrator/orchestrator-platform.md Outdated
Comment thread docs/src/design/orchestrator/orchestrator-platform.md Outdated
Comment thread docs/src/design/orchestrator/orchestrator-platform.md
Comment thread docs/src/design/orchestrator/orchestrator-platform.md Outdated
chrysh added 5 commits August 17, 2026 11:56
The platform half around the state-machine core: surrounding services,
capability contracts, the board device table, and the fail-safe rules
at the responsibility boundary.
Per review: services are reached syscall-like — the orchestrator issues
an IPC call, the service does the hardware I/O on its behalf, and the
data returns via IPC. Name the existing service crates in the diagram
and add a legend showing the client / client-ipc / server round trip.

Assisted-by: Claude (claude-fable-5)
Per review: decisions and the chain walk live in the state machine and
are documented there. Drop the Responsibilities section that restated
the mission; open with the sensors/actuators framing. Keep the SPI
write-filter TOCTOU fact in the boundary section.

Assisted-by: Claude:claude-fable-5
Per review: services provide facts, the state machine judges them.
Relabel the SPI edge and add the facts-not-verdicts rule.

Assisted-by: Claude:claude-fable-5
Rename the scope heading, access-not-touch wording, and link the
services/i2c and services/mctp crates the layering paragraph cites.

Signed-off-by: Christina Quast <christina.quast@9elements.com>
@leongross
leongross self-requested a review August 17, 2026 12:16

@leongross leongross left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Lgtm, let's get this merged.

@leongross
leongross merged commit 56233e7 into OpenPRoT:main Aug 17, 2026
5 checks passed
@chrysh
chrysh deleted the fwmanager-docs branch August 17, 2026 17:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants