[abrichr]

openadapt quickstart --app openemr runs the redesigned quickstart's three acts on OpenEMR 8.0.0.3, a real open-source EHR, in Docker, instead of the bundled MockMed. The default stays MockMed: no Docker, about 22 s, and its output is byte-identical (the existing snapshot passes unchanged).

What it does

• Setup. It uses the repository's pinned OpenEMR fixture (packages/flow/benchmark/openemr_local/: pinned image digests, verified source files, a hashed SQL baseline) under its own Compose project (openadapt-quickstart-openemr, loopback ports 9741/9740). State stays in ~/.cache/openadapt/quickstart-openemr. A running copy is reused and reset to its baseline. A stopped copy is restarted. On first run it downloads the images if missing, shows progress per layer with elapsed time, installs OpenEMR, and adds synthetic API clients.
• Act 1, show it once. The referral as it was demonstrated once in OpenEMR. This is the recorded demonstration of the certified referral bundle (qual10, clinical-write, digest ec096afa…), the same program behind the site's OpenEMR Seals (scoreboard: OpenEMR referrals r3–r6 on the certified bundle, reports redacted and under an offline Seal #1409). It was compiled with the shared duplicate rule (apply_referral_rules). The bundle and a URL-free copy of its action log are now committed under benchmark/openemr_local/referral_program/.
• Act 2, run it. Five synthetic referrals (r3, r4, r5, r7, r8) at once, each on its own clerk account and browser process. Every run goes through the certified run path (qualify.campaign._run: the Standard run gate under clinical-write, a governed authorization, durable, settled, verify.yaml's REST record check). Each is then read back with SQL, 12 of 12 fields: "✓ checked in OpenEMR's record".
• Act 3, break it. It adds an existing chart (Rosa Delgado, born 1958-03-27), then runs the r6 referral (Rosa Delgado, born 1958-03-22). OpenEMR's duplicate check lists the match, and the program stops before saving: "Stopped before saving: possible duplicate", HALTED_BEFORE_EFFECT. SQL counts 0 new charts. The terminal shows the dialog's screenshot on terminals that draw images.
• Finale. The same receipt card and Seal, plus Published Seals: https://openadapt.ai/seals.
• No Docker, or not run from a clone: one line on stderr saying what's missing and how to fix it, exit 2. It never falls back to MockMed.

Why the certified bundle and not a fresh recording

A fresh record-and-compile on this fixture took 66 s plus 68 s, and the result fails the clinical-write policy: 9 violations, which only qualification's reviewed overrides clear. Run without certification, a fresh bundle runs under the demo profile and can't report VERIFIED. The honest options were to qualify on every run (about 10 min) or to run the certified program, so Act 1 replays that program's own recording.

Changes

• openadapt/quickstart/openemr.py: the engine, the Docker/clone checks, the worker main.
• openadapt/quickstart/scene.py: per-app words; MockMed's are unchanged.
• story.py, view.py, workers.py, cli.py: changes to pass the scene through, plus --app.
• packages/flow/benchmark/openemr_local/quickstart.py: the fixture subclass, bring-up, clerk sessions, the certified run.
• referral_program/: the committed bundle and demonstration (gitleaks clean; the recording's meta.json and URLs held a sign-in token and are not committed).
• Docs: docs/quickstart/README.md.

One finding on the way: OpenEMR's tab shell posts execute_background_services.php 10 s after sign-in, then every minute. A run that starts right after sign-in meets that request at its first step, and under load the readiness gate halts. Each clerk session now waits for that first poll before its first run. That wait is part of sign-in and counts in Act 2's time.

Tests

• tests/test_quickstart_openemr.py: the Docker-missing, not-running and no-compose paths; the clone check; CLI exit 2 with exactly one stderr line and no MockMed fallback; the plain-output snapshot (tests/snapshots/quickstart_openemr_plain.snapshot); Act 3 wording; and test_real_openemr_quickstart, opt in with OPENADAPT_REAL_QUICKSTART_OPENEMR=1 on a machine with Docker (CI skips it).
• packages/flow/tests/test_openemr_quickstart_driver.py: the committed program's digest, recording ID and duplicate rule; a tampered file is refused; no tokens or URLs; the bring-up paths (reused, restarted, created) with a fake runner; layer progress; checked() needs the engine and SQL to agree.

Measured wall time

To be filled in. The shared Mac hit a load average above 900 from another session's runaway openadapt --version recursion (reported to the coordinator), so no timing yet.

Not done here

• The site copy changes only once this ships.
• The mode runs from a clone only: the fixture is repository-only and isn't in the wheel.

🤖 Generated with Claude Code