# 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.