From 05f0110b4f1033267629c23e43c9ae639b130f6e Mon Sep 17 00:00:00 2001 From: abrichr Date: Mon, 20 Jul 2026 16:00:59 -0400 Subject: [PATCH] docs(readme): mention for-each loops and visualize in the launcher quickstart MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add a short paragraph and two commands after the record-your-own-app block: - `openadapt flow for-each` — run a compiled bundle once per record of a worklist as a governed loop (bounded, identity-checked and effect-verified per record, halt-on-ambiguity). - `openadapt flow visualize` — render a bundle's program graph before it runs (steps, resolution ladder, identity gates, effect checks, halt points) as HTML, Mermaid, or JSON. Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_01NyCHrzA1psrKMFfroYbzaM --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index eb04bc7c0..c2fb9ff28 100644 --- a/README.md +++ b/README.md @@ -159,6 +159,19 @@ openadapt flow replay bundle --url https://your.app > `openadapt flow ` is the recommended path. The standalone > `openadapt-flow ` command keeps working and behaves identically. +One recording does more than replay a single path. `openadapt flow for-each` +wraps a compiled bundle's body in a governed loop that runs once per record of +a worklist (CSV or JSON), bounded, identity-checked and effect-verified per +record, and halting on ambiguity instead of skipping a record. And before a +bundle ever runs, `openadapt flow visualize` renders its program graph: the +ordered steps, the resolution ladder, the armed identity gates, the effect +checks, and every point the run can halt, as offline HTML, Mermaid, or JSON. + +```bash +openadapt flow for-each bundle --records worklist.csv --out queue-bundle +openadapt flow visualize bundle -o graph.html +``` + --- ## How the compiler works