main
John Lauer 0.1.29: pin complete canonical library viewer and preserve unowned zones eef56c4 18d ago

Component library overview in the final video

Keep the full component tour as a separate library-tour artifact. Register only its roughly five-second moving overview as library-overview. Compose includes that overview in ledger order and reserves time for it within the final cut. Review selected variants in the native EDA first: an MPN-marked tour is not evidence that the board uses those same models.

adom-aiflow --ai-thread <thread> --run <run> artifact --kind library-overview --file overview.mp4 --review review.json --caption "The selected component library, including the marked models used on this board."

The review JSON is explicit human/AI review evidence, not an automatic visual-quality certificate:

{
  "boardSha256": "SHA256 of the run's current saved PCB",
  "clipSha256": "SHA256 of overview.mp4",
  "visualReview": "passed",
  "nativeLibraryReview": "passed",
  "selection": {"file": "selection.json", "sha256": "SHA256"},
  "nativeReadback": {"file": "native-model-readback.json", "sha256": "SHA256"},
  "nativeScreenshot": {"file": "native-board.png", "sha256": "SHA256"}
}

Use the same selection manifest accepted by tools/library-tour.py build: target eda, mpnMarking on/off, and each component's selectedModel with variant, STEP and GLB paths and hashes. Paths are relative to the containing manifest or absolute. All model hashes are checked. Registration and composition both recheck the board, clip, selection, and native evidence. A pending render review or an old screenshot must not be marked passed. Review the visible native bodies, pin-one indicators, orientation, selected marking/light variants and the tour contact sheet/playback before attesting. If anything changes, redo the affected review and use --replaces <old clip> to retain the history without repeating the old overview.

The full tour does not enter the final cut automatically. No static wiki/title cards are added. This does not validate electrical function, footprint dimensions or redistribution rights; those reviews and provenance remain on the reusable global component pages.

Tours use the complete pinned canonical viewer release, served locally with the tour. On a viewer load error, rebuild with tools/library-tour.py build --manifest <selection.json> --out <tour-dir> and inspect the explicit error before recording. Native variants and tour selection must agree, including pin-one markers and the chosen LED/MPN state.