svrnty-vision/docs/VISUAL-EVIDENCE-CONTRACT.md

Visual Evidence Contract

Status: candidate contract. This is route-only evidence for Cortex OS and Seed review. It does not grant tools or promote the package.

Required Fields

Every Visual Evidence record must include:

• producing_package_id
• producing_tool_id
• capability_surface
• source_reference
• provider_mode
• retention_disclosure
• observed_content_summary
• extracted_claims
• confidence
• caveats
• timestamp
• validation_status

First Vertical Proof

The first proof adapts a raw-mode POST /vlm/analyze response into Visual Evidence through a pure Python adapter. It does not call a live provider.

Proof module: src/svrnty_vision/visual_evidence.py

Proof test: tests/test_visual_evidence.py

Research Handoff Rule

Research may cite Visual Evidence as an input source if the record includes the required fields and validation status. Research owns synthesis and capsule writing. Vision owns the visual observation record only.

Provider And Retention Disclosure

Provider mode and retention are mandatory because host agents must be able to disclose how the visual observation was produced. Missing disclosure invalidates the evidence record.