Skip to content

Fix launcher quickstart and align public product docs - #1096

Draft
abrichr wants to merge 3 commits into
mainfrom
codex/quickstart-lifecycle
Draft

Fix launcher quickstart and align public product docs#1096
abrichr wants to merge 3 commits into
mainfrom
codex/quickstart-lifecycle

Conversation

@abrichr

@abrichr abrichr commented Aug 18, 2026

Copy link
Copy Markdown
Member

Summary

  • delegate every openadapt flow ... argument to the installed Flow parser so current and future commands, options, help, and exit codes cannot drift behind the engine
  • make RDP deploy/doctor checks fail when the transport extra is absent
  • replace the false-success openadapt capture stop no-op with an explicit non-success result
  • raise the Capture compatibility floor to 1.2.0 and let Flow own the browser dependency contract
  • add a bounded weekly clean-wheel lifecycle for the public openadapt quickstart command
  • replace stale training-era package, architecture, installation, CLI, Capture, and permissions pages with the current governed-compiler product contract
  • state the supported Beta role of openadapt-capture in the package docstring, README, and package map

Root cause

The launcher duplicated selected Flow commands as Click wrappers. Those wrappers rejected valid current Flow options and hid new commands until the launcher changed. Several historical pages and the package docstring still described Capture as experimental. The raw Capture stop command also printed a success-shaped message without any cross-process control mechanism.

Capture currently exposes only in-process Recorder.stop() and internal stop events. It has no authenticated cross-process control channel. OpenAdaptAI/openadapt-capture#77 records the target owner-only IPC contract and acceptance tests. The launcher failure is the truthful interim behavior, not completion of that target feature.

Validation

  • 150 launcher tests passed; 6 platform-specific tests skipped
  • Ruff lint and format passed
  • source-availability boundary passed
  • wheel and source archive built and passed the release-artifact verifier
  • clean installed launcher + Flow lifecycle passed: Standard VERIFIED, 2/2 independent effects, 0 model calls, lint passed, and uninstall was verified

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant