[Pfannkuchensack]

Summary

Nothing checked that metadata recall reads what the graph builders record, so recall gaps were found by hand (#10169, #10140). Every key an image or video graph records now needs an entry in a recall contract, and a key without one fails the frontend tests.

• imageRecallContract.test.ts and videoRecallContract.test.ts compile every Generate base and shape, Canvas modes, Upscale, hosted providers, and every video base, variant and mode. Each recallable setting is tuned off its default. The tests then check:
  • every recorded key has an entry;
  • recall restores what each entry claims, and the check fails if the value matches the panel or the model default anyway;
  • a key marked ignored changes nothing when removed;
  • each recall kind (Recall All, Remix, prompts, seed, size, CLIP skip) applies exactly its own settings;
  • every recall field label is reported by some record;
  • a generation record lacking a key restores that key's default.
• The image contract also has to name every field CoreMetadataInvocation declares. A backend field added without an entry fails tsc. frontend-checks now also runs when invokeai/frontend/api/schema.ts changes, so this check runs on the backend PR that adds the field.
• Gaps the contracts found, fixed here:
  • Image recall now restores PiD mode and steps. A record of the same family without PiD turns it off, so recalling a refiner image onto a panel with PiD on no longer leaves a combination validation refuses.
  • Video recall restores the target resolution of canvases sized by media (first/last frame, source video, picture clip), for Recall All, Remix and Use size. Before, a remix could run at the panel's resolution and come out at another size.
  • The missing videoTitles.size notice title.
• The shared graph fixtures for Canvas, Upscale and video coverage moved into *.testing.ts files, unchanged. The remix and video round-trip tests the contracts replace are removed.

Related Issues / Discussions

• [bug]: Wan 2.2 low-noise guidance setting is not recalled or reset in Generate tab (webv2 image recall) #10169 and the recall part of bug: Ideogram 4 frontend generation saves unused steps/cfgScale in metadata and does not recall sampler preset or overrides #10140 were fixed by Restore Canvas metadata and recall parity #10127; the contracts now pin them.
• Not covered: keys only the backend writes. After feat(nodes): add native metadata input and output across denoise invocations #10083, denoise nodes add their own keys at run time (denoising_start, add_noise, tile_*, ...), which a frontend contract cannot see.

QA Instructions

From invokeai/frontend/webv2:

pnpm lint
pnpm test src/workbench/image-actions src/features/generation/core/graphCoverage.test.ts src/features/generation/core/canvas src/features/video/core src/features/upscale/core src/architecture/architectureWorkflow.test.ts src/platform/i18n

• pnpm lint passes. The focused run passes: 49 files, 2639 tests. The two contract files take under 1 s.
• Each gate was checked by mutation and fails as intended:
  • an extra key in a builder's metadata;
  • a removed entry;
  • a disabled reader;
  • a read key marked ignored;
  • a new recall field label;
  • a removed declared key;
  • reverting the PiD and video size fixes.
• Locally, five tests in the full unit run fail on a de-DE Windows machine with and without this change: number formatting in clusterStats, indexProgress and modelCacheStore, plus the AltGr test in keys.test.ts.
• Not done: a browser check. The mock backend has no video record sized by media.

Review

No blocking findings. Remaining limits:

• A contract only sees keys its fixtures' graphs write. A key a builder writes only under some setting needs that setting tuned in recallTunedSettingsFor; the docs say so.
• Recall restores CFG rescale and seamless tiling even on families whose panel hides them. The contract records this but does not change it.
• Video recall keeps the panel's negative prompt when a Wan record has an empty one. This is deliberate and tested, so it is unchanged.
• Gaps on the recording side, not fixed here:
  • FLUX.2 dev records no component source.
  • SD-3 records no text encoders ([enhancement]: Record SD 3 text encoders in image metadata for recall #9981).
  • Ideogram 4 records steps/cfg_scale it does not use (bug: Ideogram 4 frontend generation saves unused steps/cfgScale in metadata and does not recall sampler preset or overrides #10140).

Checklist

• The PR has a short but descriptive title, suitable for a changelog
• Meaningful regression coverage added / updated where needed; obsolete tests/code removed
• Persisted-state and API changes include required migrations / compatibility validation
• Relevant performance/efficiency opportunities considered; material claims have evidence
• Material review findings resolved and relevant checks rerun
• Documentation added / updated (if applicable)
• Updated What's New copy (if doing a release after this PR)

---

^{Open in [code]smith · Need help on this PR? Tag @codesmith-bot with what you need.}