docs: publish the canonical launcher quickstart - #12
Merged
Conversation
The org profile told readers to run `pip install openadapt` and then `openadapt flow demo-record`. The base launcher install no longer carries Playwright -- the browser dependency ships only in the `openadapt[browser]` extra -- so the published sequence cannot run as written. Replace it with the supported single-command path, `openadapt quickstart`, which runs the bundled MockMed lifecycle end to end (record, compile, certify, replay, independent effect verification, REPORT.md). Add a validator contract so the profile cannot regress to the broken sequence. This is a stale-fact correction only. It changes no lifecycle label and makes no production-readiness claim. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
abrichr
added a commit
that referenced
this pull request
Aug 19, 2026
HOLD -- do not merge until the acceptance evidence exists. This is the visible maturity-label change for Capture, isolated so it can ship as one action under the one-visible-change-at-the-end rule. The stale-fact half of this branch (the canonical launcher quickstart) merged separately in #12 and is already on main. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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.
What changed
pip install openadapt+ four-commandopenadapt flow ...block inprofile/README.mdwith the supported single-command pathscripts/check_profile.pycontract that pins the canonical quickstart commands and refuses a regression to the superseded manual sequenceWhy
The published sequence cannot run as written. The base launcher install resolves
openadapt-flow[hosted]; Playwright ships only through theopenadapt[browser]extra, soopenadapt flow demo-recordfails on a clean base install.openadapt quickstart(openadapt/cli.py) is the supported single command and runs the same bundled MockMed lifecycle.The prose states only what the tutorial actually does.
openadapt_flow.tutorial.run_tutorialstages are record, compile, certify, run under the standard profile with independent effect verification, and receipt. It does not lint, so lint stays in the follow-on guide sentence rather than in the description of the command.Scope
This is the stale-fact half of draft #10, taken alone and rebased on current
main.Deliberately not included, and still held on
codex/capture-beta-lifecycle:openadapt-captureExperimental-to-Beta relabel (REPOSITORY_LIFECYCLE.md,repository-lifecycle.yml, the profile "Native capture" row, and thecheck_profile.pyexpected lifecycle)## Production Qualificationprofile section and its required-marker contractNo lifecycle label changes here. Capture stays Experimental. Every Production membership and admission list stays empty. No production-readiness claim is published.
Validation
python3 scripts/check_profile.py— canonical product truth and 36 Markdown linkspython3 -m unittest discover -s tests -p 'test_*.py'— 40 passedgit diff --check— clean🤖 Generated with Claude Code