Skip to content

List images without header channel names in a described run - #226

Merged
guijacquemet merged 2 commits into
mainfrom
claude/list-unnamed-header-images
Nov 8, 2026
Merged

guijacquemet merged 2 commits into
mainfrom
claude/list-unnamed-header-images

Conversation

@guijacquemet

Copy link
Copy Markdown
Contributor

Fixes #225

What

In a run with a published description, an image whose header names no channel (or not every one) still passes the per-unit header checks (#218; Spec §4.3, fixture v12), with no warning. It is now listed:

  • manifest: a unit record of experiment_description.units gets images_without_header_channel_names, a list sorted by path of {image, header_names: "none"|"partial", channel_positions: [zero-based C positions without a name]}. The key is omitted for a unit whose images are all named (documented in docs/contract.md); RGB units list nothing (§4.4b).
  • read_manifest validates the field strictly (ManifestFormatError on a wrong shape, order, type or value).
  • RunInputs.images_without_header_channel_names() returns it read-only ({path: positions}; empty when all named; None without a description).
  • report: the text lists the images under "Images without header channel names"; the JSON report has the key images_without_header_channel_names (empty list when none), only for described runs.
  • Undescribed runs: no new manifest or report key.
    New code is in the new module description_unnamed.py (layer pure), so manifest.py stays at 598 lines; no baseline grew.

Why

Owner decision 2026-11-08: keep these images passing but make visible which ones stand on the user's confirmed layout alone; no warning.

Regression evidence

tests/test_unnamed_header_images.py (13 tests): 13 failed on main (source stashed), 13 pass here. They cover a described run with one unnamed and one partially named image (exactly those two recorded, manifest round-trip via read_manifest, RunInputs, report text and JSON, no issues), a fully named run (key omitted, report list empty), an undescribed run (no new key), 8 malformed manifest lists refused, and the physical report.

Checks

python tools/check.py: ruff check and format clean, 4582 passed, 4 skipped (case-insensitive file system and file-mode permission skips, unrelated), code rules clean (v0.4.0 parity suite included and passing).

Expect CHANGELOG conflicts with #217 and #224; keep both sides.


Generated by Claude Code

An image whose header names no channel, or not every one, still passes the per-unit
header checks (Spec 4.3, fixture v12), with no warning. It is now listed: the unit record
of the manifest's experiment_description entry gets images_without_header_channel_names
(read back strictly), RunInputs exposes it read-only, and the report text and JSON list
the images. Undescribed runs are unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Scma6W3LC11s3qjXHZuGDm
@guijacquemet
guijacquemet merged commit b6341f7 into main Nov 8, 2026
7 checks passed
@guijacquemet
guijacquemet deleted the claude/list-unnamed-header-images branch November 8, 2026 08:14
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.

List images without header channel names in a described run (follow-up of #218)

2 participants