Files
ModelForge/docs/architecture/POKEVAULT_VISION_INTEGRATION.md

37 lines
2.3 KiB
Markdown

# ExampleVision vision integration
ExampleVision retains its production recognizer. The M11 shadow path is:
```text
normalized card image -> vision.embedding@1 -> Gateway -> scheduler -> GPU Node
-> exact 768-dimensional visual space -> pgvector nearest neighbours
-> existing metadata/fusion boundary -> AMBIGUOUS | NO_MATCH | UNAVAILABLE
```
The consumer adapter contains no SigLIP, revision, runtime, worker, GPU Node or artifact identity. It
validates bounded images and the exact visual space/dimension returned by the capability contract.
Images are transient and absent from audit, gateway telemetry and ordinary logs.
References and queries use `examplevision-card-rgb-pad-224-v1`: orientation/geometry normalization is
reused from ExampleVision, then the full RGB card is aspect-preserving padded to 224 x 224. Reference
rows retain canonical printing ID, source-image content hash and visual-space identity. A separate
768-dimensional pgvector schema prevents reuse of ExampleVision's existing 1000-dimensional MobileNet
vectors. Index runs are cursor-based, idempotent, bounded to batches of one through four and may be
resumed or activated only with one consistent space.
Live M11 indexing processed 80 real catalog reference images in two resumable 40-image invocations,
20 successful background Gateway requests and zero failures. The first ten batches took about 4.6
seconds. Ten concurrent interactive technical queries completed while background indexing was active.
These queries used a catalog-artwork derivative, not an owner photograph, so they prove routing,
retrieval and QoS but do not constitute the required real-photo project-fit evaluation.
No confidence threshold was fabricated. Until reviewed owner-photo ground truth exists, the shadow
recognizer cannot emit `CONFIDENT`; the recorded recommendation is `REQUIRES_MORE_EVIDENCE`.
ADR-0031 separates this production-fit limitation from engineering closure. The capability-first
integration and complete reference index may pass M11 while owner-photo validation remains
`DEFERRED_EXTERNAL_VALIDATION`. Future production cutover is guarded by
`POKEVAULT_VISION_PRODUCTION_VALIDATION`; only independently reviewed `OWNER_PHOTO` evidence can
satisfy it. `PUBLIC_PHYSICAL_CAPTURE` and `CATALOG_REFERENCE` evidence remain explicitly weaker and
cannot enable auto-accept.