feat(illustration): seed the clip from the deterministic schematic - #26
Merged
Conversation
The illustration clip was seeded by a text-to-image generated still. Even with an explicit geometry sentence in the prompt, a live render on 2026-07-30 rendered a stated rear-end collision as head-on: prompt text alone cannot pin a diffusion model's geometry. The clip is now seeded by a raster of the case's own deterministic schematic (the impact-frame render, unwatermarked so the clip's single burned-in disclosure stays the only on-image text), so geometry is inherited from the factual layer instead of requested from a model. The clip prompt is rewritten to describe animating that top-down diagram, vehicles held static, while keeping its honesty markers and the geometry sentence. The manifest's still_model/still_prompt fields no longer claim a text-to-image model produced the seed; a new still_source field names the schematic explicitly.
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
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
live-forensic-retry-0bb32eeb) proved prompt-level control alone cannot pin a diffusion model's geometry: even with an explicit "the red car is directly behind the blue car, nose to tail" sentence in the prompt, the model rendered a head-on collision for a rear-end fixture.SchematicArtifacts.seed_png, the impact-frame render with all drawn text/watermark omitted viarender_frame's newannotateflag), so the clip's geometry is inherited from the factual layer instead of requested from a generative model.report.illustration_prompt) is rewritten into a top-down-diagram register ("animate this top-down forensic reconstruction diagram... vehicles stay perfectly static... only the camera moves"), matching what the seed image actually looks like, while keeping the honesty markers (computer-generated, not a real recording), the no-on-image-text instruction, and the geometry sentence.illustration.still_model/illustration.still_promptno longer claim a text-to-image model produced the seed (still_modelis honestlynull); a newillustration.still_source: "schematic:impact_frame"field names the seed's real provenance. Existing structural checks (provenance.verify_all,scripts/readiness.py) keep working unmodified against the corrected values.Test plan
pytest --cov=src --cov-fail-under=90 tests/— 454 passed, 1 skipped (live-VLM, no creds), coverage 96.95% (up from 94.84% baseline)ruff check src tests scripts— cleanpython scripts/readiness.py --min 95— PASS, automatable 100.0%illustration_stillbytes exactly (single-caption invariant)tests/integration/test_illustration_watermark_burn.pyto reflect that the still burn no longer depends on the (possibly misbehaving) clip provider