docs: align Flow claims and limits with current contracts - #409
Merged
Conversation
abrichr
force-pushed
the
codex/flow-target-state-gaps
branch
2 times, most recently
from
August 26, 2026 21:12
6c6a91a to
00038fb
Compare
abrichr
force-pushed
the
codex/flow-target-state-gaps
branch
from
August 27, 2026 22:21
00038fb to
3d966a8
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.
PR #401 moved Flow's lifecycle to admission-derived product state. PR #404 wired the appliance tiers for resume, and PR #408 made the egress posture sticky before execution. Eight useful pieces from #381 still needed a current branch.
Flow's opening now names it as OpenAdapt's demonstration compiler and governed runtime. The safety text records uncertain delivery as
RECONCILIATION_REQUIREDwith no blind retry. The claims registry keeps required-CI evidence tiers separate from release and workflow admissions.The geometry text stays inside the evidence. Browser attach can start an exact epoch after a stable viewport change; native conversion needs valid mapping metadata and a fixed output viewport, while RDP and Citrix can rebaseline only between actions.
Capture ownership now points to
openadapt-capture, while the remaining edits state the identity and operator-authentication requirements, describe current VLM wiring across replay, resume, and attended execution, and refresh the generated claim artifacts. This PR doesn't change release state or publish a package.Checks:
python scripts/check_consistency.pypython scripts/validate_claims.py --check --structure-onlypython scripts/check_release_consistency.pygit diff --checkRetitle
The branch was called
feat(cli): make rejected-write simulation an advanced check, but the diff is ten docs and claims files with no CLI change. Flowsquash-merges, so the title becomes the commit message. It now reads
docs: align Flow claims and limits with current contracts.The one conflict, in
README.mdMain describes the
--break-itdemo as ending with the engineHALTS. Thisbranch rewrote that to say the runtime returns
RECONCILIATION_REQUIRED. Bothare true and they are not the same field, so both are kept.
tests/e2e/test_tutorial_break_it_e2e.pypins the pair directly:It also pins the two follow-on claims this branch adds:
run-broken/REPORT.mdleads with
HALTED, and a halted run writes no receipt. Worth knowing that theunit test
tests/test_cli_tutorial_break_it.pyfakes the report object, so itwould not have caught a wrong outcome here. The e2e test is the one doing real
work, and it is the one backing the new text.
public-artifacts.jsonregenerates byte-identical frompython scripts/check_release_consistency.py --write-public-artifact-inventory,so the pinned hashes hold against this base and the wheel gate is satisfied.
For anyone tracing this branch: #413 carries these same four commits as part of
the 1.34 stack, records a tested release order, and stays unmerged by its own
instruction. This PR is the one that lands the docs half.