docs: operator path for compose and ProcessContract - #177
Merged
Conversation
Record one program per surface, sequence compiled recordings with compose, then after admission author a process parent. Visualize keeps the parent as children plus handoff edges, ending at End of declared steps.
The live Flow authoring flags are NAME=BUNDLE plus a per-child envelope file. An admission UUID is not a --child value. Opened and committed by an agent session, not the founder.
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
1 participant
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.
An operator who already recorded one app needs the next step when the task crosses a second surface. Flow
origin/mainalready hasopenadapt-flow compose. This change is the operator documentation for that sequencer and for the ProcessContract parent that sits on top of admitted capabilities.docs/guides/compose-multi-application.mdis the one path: record one program per surface,composethe compiled recordings, qualify and admit each child, thenprocessfor a ProcessContract parent (openadapt.process-contract/v0).docs/concepts/process-contract.mdis the short receipt and handoff note. The CLI verbs table,visualize, get-started, and Execute pick up the matching cross-links.Compose sequences compiled recordings into
composition.json. Process points at independently admitted capabilities. It doesn't copy recordings and it doesn't become a ProgramGraph. Pointing it atcomposition.jsonis refused. Each process child runs through Execute with that child's envelope. Replay of either parent is refused.visualizeon a process parent shows admitted children, handoff edges, and a terminal labeled End of declared steps. A compiled bundle still has its own program graph. Don't merge those pictures.No Production, SLA, or Citrix claim.
Opened by an agent session, not the founder.
What a reviewer must check
origin/main:--child NAME=PATH,--handoff FROM.source=TO.target,--after,--allow-halt,--out.admission_ids, not bundle paths.Test plan
uv run python scripts/validate_docs.pyuv run mkdocs build --strict