Repository navigation
Conversation
…nents, adding a summary family)
40 tasks
Problem Definition (motivation, numbered requirements), ASAPPlanner Design (intuition, Assumptions 9-12, deployment/planner overview with an input-to-stage table), Detailed Design per input with rules, outputs and handoff contract (Algorithms 1-2), missing components, adding a summary family (Algorithm 3) and workload/capability matching, two end-to-end examples, scenarios and open questions. Factual content and status markings unchanged.
zzylol
force-pushed
the
docs/asapplanner-e2e-use-case
branch
from
October 14, 2026 23:44
d8c9213 to
d6dc11c
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
planner-layering.md designs the planning stages, but there is no guide for bringing a new use case onto ASAPPlanner: how to describe its workloads, which ASAP Primitives fit, what to add when a primitive is missing, and how a deployment runtime integrates with the planner so the use case shows an end-to-end benefit.
What
Adds one file,
docs/design_docs/proposals/asapplanner-e2e-use-case.md(111 lines). No other doc or code changes. It is an outline: each section holds key points marked "to be expanded".PlanningWorkload: per query (text and language, accuracy target, latency, recurrence and predictability, time selection) and per source (schema, arrival and retention, cardinality and value distribution). It also covers the overlap analysis that makes ASAP worthwhile and declaring unmeasurable statistics as unknown.e2e_plan,PlanningModels, capabilities,PhysicalASAPDAGDocument, the selection report, feedback).How
Written as a design proposal next to planner-layering.md. It links that doc and
asap-primitive-schema.mdand keeps stage names and terms aligned with them.Key code interfaces added / modified
None (documentation only)
Before this PR
The stage design existed, but no doc said how to go from a use case to a planned, deployed workload, or how to add a missing primitive end to end.
After this PR
There is one outline that covers that path, section by section, ready to be filled in.
Verification
planner-layering.md, its "Adding a new summary family" section, andasap-primitive-schema.mdexist onmain.Limitations and follow-ups
[TODO: just fill], and every section says "to be expanded".Human review — do not complete with an agent