fix: retain partial visual regions

[seonghobae]

Buyer-visible gap

A VISION locator that returned valid salient panels but not full-image coverage
was replaced by one full-image region. Panel coordinates, panel-level OCR, and
panel search attribution were therefore lost.

Change

• Retain every valid bounded partial region.
• Analyze the parent image once when locator coverage is partial, preserving
  evidence outside the panels.
• Keep parent-image evidence for empty, invalid, or single full-image locator
  output without inventing a region coordinate.
• Record the contract in ADR 0104 and add regressions asserting panel
  retention, parent analysis, and no fabricated full-image region.

Verification

• Current parent fix: keep visual whitespace out of authoritative structure #319:
  e84994e9145d3f7a1a7849e94c91de02cccf62fc.
• Current head:
  0f8bc28f116dc4c6e3a04c01d042de53c51e9173 after an ordinary parent
  restack.
• uv run --locked --extra dev --extra backend python -m pytest -q —
  734 passed, 16 skipped, 4 warnings.
• Focused image/normalization tests — 13 passed.
• Frontend lint, TypeScript build, 136 tests, production build, Storybook,
  actionlint, and git diff --check passed.

No real records, identifiers, or provider credentials are included. This PR
is stacked on #319, which is stacked on #317.

[seonghobae]

@opencode-agent review exact current HEAD 34a0c98. Inspect partial visual-region retention, parent-image fallback, region status persistence, and current required Checks. Report actionable findings only; do not approve, bypass, or use stale parent evidence.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 1765230d-eb16-41c3-a118-e1b33b149f5d

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[seonghobae]

@opencode-agent review exact current HEAD 799671a. Re-check partial visual-region retention, parent-image fallback, region status persistence, and current required Checks. Prior-head evidence is stale; report actionable findings only and do not approve or bypass.

[seonghobae]

@opencode-agent review exact current HEAD 41d164c5c0c312b66982f8cf8c4c14f16ab7f80f. Re-check the partial visual-region and parent-failure paths plus current required Checks; prior-head evidence is stale. Report findings only; do not approve or bypass.

[seonghobae]

@opencode-agent review exact current HEAD 41d164c. Re-check the partial visual-region and parent-failure paths plus current required Checks; prior-head evidence is stale. Report findings only; do not approve or bypass.

[seonghobae]

Review exact current HEAD 41d164c. This is the dependency base for the visual-region validation stack; its required Full test suite and Frontend lint, test, build checks are green. Please publish a formal independent review for this exact SHA and confirm the base-chain relationship before merge.

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

[seonghobae]

Review exact current HEAD 0f8bc28f116dc4c6e3a04c01d042de53c51e9173. Re-check partial visual-region retention, parent-image fallback, region status persistence, and the current required Checks; prior-head evidence is stale. Please publish a formal independent review for this exact SHA and report actionable findings only.

[seonghobae]

Reviewed and repaired against exact current head 91a95a976c406a6e9d96c943b74d68e6a1b5cdc7 (including concurrent upstream synchronization commits):

• Partial locator regions remain independently described and the original parent image is still described for uncovered content.
• A malformed non-iterable locator result now falls back to parent-image evidence instead of incorrectly failing the entire image.
• Added a regression test for that provider-boundary case.
• Focused verification: uv run --locked --extra dev --extra backend python -m pytest -q tests/test_post_content_normalization.py tests/test_image_content.py tests/test_post_content_persistence_edges.py → 51 passed.
• git diff --check passes.

PR #324 remains the stacked follow-up for finite/in-bounds region validation. This PR remains blocked pending independent formal review and terminal Checks; no bypass used.