Initial public ModelForge release

2026-09-01 21:30:16 +02:00
commit 7082ab955a
490 changed files with 104252 additions and 0 deletions
@@ -0,0 +1,36 @@
+# 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.