docs: define post-ASAP physical compilation boundary - #583
Merged
Merged
Conversation
zzylol
force-pushed
the
docs/post-asap-physical-boundary
branch
from
September 3, 2026 02:56
123bc76 to
87684f4
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
The existing planner-integration and physical-planning pages describe parts of the boundary, but do not give one canonical, executable contract for turning a deployment-independent Post-ASAP DAG into coordinated runtime plans.
Before this PR
Ownership of sampling, GOS, delta/checkpoint policy, stage partitioning, and error-budget allocation had to be inferred across several documents. The prior draft also treated all plan views like public APIs and did not fully specify in-flight drift, restart replay, SDK activation, or durable frame acknowledgement.
After this PR
One architecture page defines this boundary:
TransmissionPlanis a shared typed section; backend precompute and query routing are BackendPlan sections. ASAPPlanner remains deployment-independent, while the backend control plane owns placement, sampling, GOS, delta/full transmission, and runtime adaptation.The document now also defines:
Validation
git diff --checkoperatorname/environment macros are absentScope
Documentation only. No runtime types, planner adapter, wire schema, or deployment behavior changes in this PR.