feat: serve the synthetic tutorial and report HALTED honestly - #40
Merged
Conversation
Give assistants a three-line Claude Code / Cursor install that generates the public MockMed bundle at serve time. Skill frontmatter, server.json, and llms.txt share one identity sentence. A HALTED result means the record did not change.
MCPB may ship skills/*/SKILL.md. The skill and README now say a local unsigned replay may complete, and production success without a Seal is failure. --break-it remains the halt demo.
MCP server.json description maxLength is 100. The shared identity sentence now fits that bound and still names the program.
Write tools set MCP _meta.requires_seal. A production-eligible VERIFIED report without a Seal is error. Local unsigned replay stays free.
The Day-1 partner kit is `openadapt-agent serve --allow-run` with no --bundles. That generates the public synthetic tutorial, keeps MockMed up, and returns a receipt with frames_included false. --tutorial remains the read-only generator. One test invokes the installed Flow CLI. Opened by an agent session, not the founder.
CI's 3.10 floor job pins openadapt-flow==1.26.0. That release has the tutorial verb serve --allow-run needs; --break-it arrived in 1.29.0. The halt demo on this package is `openadapt quickstart --break-it`. Current Flow still asserts --break-it. Opened 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.
Summary
OpenAdapt is a compiled program for repeating GUI writes that have no API, and this package is the local MCP and Agent Skill adapter that invokes that program.
Day-1 for a solutions engineer is now:
serve --allow-runwith no--bundlesgenerates the public MockMed tutorial at serve time and keeps the app up.--tutorialis still the read-only generator. Registry-launched installs still require--bundlesand stay read-only until--allow-run.A client calls
run_local_quickstart. The public result is a receipt: status,requires_seal: true,frames_included: false. No screenshots leave the box. Ifexecution_outcomeisHALTED, the public message says the record did not change. Production-eligibleVERIFIEDwithout a Seal is unsigned success and fails.A reviewer who will merge this can check:
serve --allow-runcannot be combined with--bundles,--url, or--configwhen it implies--tutorial.runverb. It does not pass--approve-unverified-writes.requires_seal: trueon MCP_meta. If the tool returns unsigned success, treat it as failure.tests/test_partner_kit.pyinvokespython -m openadapt_flow tutorial --helpand the MockMed optimistic oracle. Floor CI pinsopenadapt-flow==1.26.0, which has the tutorial verbserve --allow-runneeds but not--break-it(that flag arrived in 1.29.0). Current Flow still asserts--break-it. The halt demo on this package isopenadapt quickstart --break-it. The rest of the suite still stubsopenadapt-flow run. PlaywrightVERIFIEDstays in Flow's weekly tutorial e2e.The halt demo in the README is
openadapt quickstart --break-it. That independent system-of-record check rejects a fake success banner.Opened by an agent session, not the founder.