Skip to content

docs: show compose and process parent graphs - #180

Merged
abrichr merged 1 commit into
mainfrom
docs/parent-program-graphs
Aug 29, 2026
Merged

docs: show compose and process parent graphs#180
abrichr merged 1 commit into
mainfrom
docs/parent-program-graphs

Conversation

@abrichr

@abrichr abrichr commented Aug 29, 2026

Copy link
Copy Markdown
Member

The live visualizer page already said a compose parent and a process parent stay parents. A buyer still couldn't see the picture. This adds the graphs visualize writes for those directories, plus the get-started links that send someone there after quickstart.

The Mermaid is the exact emission from Flow's visualize on a two-child compose directory and a two-child process contract. The PNGs are headless Chrome captures of the self-contained HTML from the same emission (openadapt-flow 3d085d2, the process-contract visualize branch, which includes compose-parent rendering). They are representative synthetic fixtures, not a live tenant.

Process CLI flags are unchanged: --child NAME=BUNDLE plus --admission NAME=ENVELOPE.

Opened by an agent session, not the founder.

What a reviewer must check

  • The compose screenshot shows child bundles intake and posting, a patient_id handoff, and terminal End of declared steps.
  • The process screenshot shows admitted children. It does not inline intake's steps.
  • Get-started links to the visualizer after graph.html.
  • docs/assets/visual-palette.json records the new PNGs. Dominant colour is #ffffff on both.
  • No process flag was rewritten.

Test plan

  • uv run python scripts/validate_docs.py
  • uv run mkdocs build --strict
  • uv run pytest tests/test_design_tokens.py tests/test_validate_docs.py

Buyers can now see the compiled program map, the two-child compose
parent, and the process parent. Mermaid and HTML captures come from
the Flow visualize emission. Process CLI flags are unchanged.
@abrichr
abrichr merged commit 98bb5ef into main Aug 29, 2026
6 checks passed
@abrichr
abrichr deleted the docs/parent-program-graphs branch August 29, 2026 16:24
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