Analysis results never reach the board page: no hint after current, thermal or fields, and the run report says Finished with open items

Overview Files Skills Discover Packages Releases Dependencies Issues10 Breadcrumbs Pull Requests Activity

Closed feature request

noah · 9d ago ·closed by John Lauer

Found on a hands-on run (Noah's Flow) of AM32 ESC v1 (adom/am32-esc-v1, private), 0.2.51; the hints read the same in 0.2.54.

What happened. The run solved current and heat on the human's new layout (current, thermal, fields, a separate six-step Adom Fields screen) and finished with 16 open items. AI Flow pushed its own run report and clips to aiflow/docs/runs/<id>/ on the page after every step. The board page's README, where the design review lives, kept the results of a layout from three days earlier. Noah asked why the wiki was not updated with the simulation results.

Why the AI missed it. No hint from analyze current, analyze thermal, tour fields or finish names the board's project page. The project-page skill only covers "before final delivery". artifact --kind analysis-image puts a drawing on the run report, not on the page people read. Meanwhile the run report's header says Finished (board design checks) although finish listed 16 open items and "Not cleared for fabrication", which a reader takes as done.

Ask.

When a run has a page (run.json page), analyze current|thermal and tour fields should end with a hint: "the board page's design review still shows <date/board hash>; put these results there (numbers, figures, what changed), or project-page --results". Better: a project-page --results that writes or updates a "Design review" section from the run's Fields outcome (limits, peak rise, worst necks, figures) and links the run report.
The run report's header should say what finish said: "finish ran with N open items; not cleared for fabrication" instead of "Finished".

1 Reply

John Lauer · 8d ago

Thanks Noah, both halves of this were real.

What was wrong. No hint from analyze current, analyze thermal, tour fields or finish mentioned the board's page, and no command put the results there. artifact --kind analysis-image only fed the run report. The run report's header said "Finished (board design checks)" whenever finish had run, even with 16 open items and "Not cleared for fabrication".

What changed (in adom-aiflow 0.2.56).

adom-aiflow project-page --results writes a design review for the current board as design-review/README.md: the Fields current and heat numbers, the screens' verdicts, your analysis figures, the parts table, and a link to the run report. It records which board (sha256) it describes and prints the adom-wiki repo push to put it on the page. Link it from the README as a sub-README card. For a molecule, --out <package folder> puts it in the molecule-publish package (#164).
analyze current|thermal (pass or not), tour fields and finish now end with a hint whenever the run has a page (the board's project page, or the run's own page) and its design review is missing, was written for an earlier board, or predates the latest analysis. For example: "Board page: noah/am32-esc-v1 still shows the design review of , written for an earlier board. Put these results where people read them ...". When the review is current, the hint stays quiet.
The run report's header now says what finish said: "finish ran with N open item(s); not cleared for fabrication". Only a finish with no open items reads "Finished", and even that adds that a human review comes before fabrication.

How it was verified. Unit tests cover the hint's states (no review, earlier board, newer analysis, up to date, molecule with no page yet, no page). A new workflow suite (tests/page-results-workflow.py) runs project-page --results end to end and checks the report header with two open items. The full unit and workflow suites pass.

Upgrade: tell your AI "give me the latest adom-aiflow" (or adom-wiki pkg install adom/adom-aiflow); adom-aiflow --version says 0.2.56.

John Lauer closed this · 8d ago