Skip to content

feat(tutorial): print next steps after a verified run - #354

Open
abrichr wants to merge 1 commit into
mainfrom
feat/tutorial-next-steps
Open

feat(tutorial): print next steps after a verified run#354
abrichr wants to merge 1 commit into
mainfrom
feat/tutorial-next-steps

Conversation

@abrichr

@abrichr abrichr commented Aug 11, 2026

Copy link
Copy Markdown
Member

Why

openadapt quickstart (flagship repo) delegates to this repo's tutorial. Roughly 52 people a day install openadapt, and today the tutorial ends in silence right after printing the VERIFIED receipt: zero links, zero next step, at the moment of peak intent.

What

After the receipt paths, on the plain VERIFIED path only, the CLI now prints:

That run made no model call and sent nothing off this computer.
  What it proves        https://openadapt.ai/execute
  Run it on your work   https://openadapt.ai/qualify
  Community             https://discord.gg/yF527cQbDG
  • The three URLs are exactly the ones the flagship OpenAdapt README already uses, so every surface points at the same destinations.
  • _next_steps_block() is a small pure function in openadapt_flow/tutorial.py; _cmd_tutorial prints it with the same plain-print mechanism as the surrounding summary.
  • Verified-path only: --break-it runs end on their own narrative, and non-VERIFIED runs keep ending on their evidence -- the block belongs to the success rail, mirroring the receipt rule.

Tests

tests/test_cli_tutorial_next_steps.py mirrors the browser-free pattern of tests/test_cli_tutorial_break_it.py (fake run_tutorial, assert on captured CLI output): the block carries the three URLs, is printed after the receipt on the VERIFIED path, and is absent on --break-it and non-VERIFIED paths. ci.yml untouched.

🤖 Generated with Claude Code

The tutorial previously ended in silence right after printing the
VERIFIED receipt -- the moment of peak intent had zero links and zero
next step. Close it with a small block pointing at what the run proves,
how to qualify a real workflow, and the community.

* _next_steps_block() is a pure, unit-testable function in tutorial.py;
  the CLI prints it in _cmd_tutorial on the plain VERIFIED path only.
* The three URLs match the flagship OpenAdapt README exactly
  (openadapt.ai/execute, openadapt.ai/qualify, discord.gg/yF527cQbDG).
* Not printed on --break-it or non-VERIFIED paths: the block belongs to
  the success rail, mirroring the receipt rule.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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