ModelForge/docs/architecture/POKEVAULT_VISION_INTEGRATION.md

ExampleVision vision integration

ExampleVision retains its production recognizer. The M11 shadow path is:

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.