From 2611f79e6788133769e8f0affa528a12d5906f96 Mon Sep 17 00:00:00 2001
From: Svrnty <info@svrnty.io>
Date: Wed, 17 Jun 2026 23:38:20 -0400
Subject: [PATCH] Add Svrnty Vision navigation index

---
 INDEX.md                              | 30 +++++++++++++++++++++++++++
 WORKBOARD.yaml                        |  5 +++++
 tools/validate_svrnty_vision_child.py | 21 ++++++++++++++++++-
 3 files changed, 55 insertions(+), 1 deletion(-)
 create mode 100644 INDEX.md

diff --git a/INDEX.md b/INDEX.md
new file mode 100644
index 0000000..20367c9
--- /dev/null
+++ b/INDEX.md
@@ -0,0 +1,30 @@
+# Svrnty Vision Index
+
+Route: `svrnty-vision`.
+Path: `/home/svrnty/workspaces/cortex-os/svrnty-vision`.
+Category: child-local sovereign vision HTTP gateway and Visual Perception Package Candidate workspace.
+Validator: `python3 tools/validate_svrnty_vision_child.py`.
+
+## Read Order
+
+1. `AGENTS.md` for route-local authority, forbidden effects, and validator rules.
+2. `README.md` for gateway posture, operator/developer examples, and cleanup-route boundary.
+3. `docs/VISION-PACKAGE-CANDIDATE.md`, `docs/VISUAL-EVIDENCE-CONTRACT.md`, and `docs/VISION-HOST-ADAPTER-CANDIDATES.md` for package-candidate work.
+4. `candidate-manifests/` for tool grants and manifest contracts.
+5. `WORKBOARD.yaml` for child-local work state.
+
+## Local Authority
+
+Svrnty Vision owns child-local VLM, FLUX, palette, and cutout gateway source; BTE-shaped HTTP route adapters; package-candidate docs; visual-evidence contracts; host-adapter candidates; tool-grant manifests; Docker package context; validators; fixtures; and proof packets.
+
+Svrnty Vision is not Core authority, Seed installation authority, Runtime startup authority, Host Runtime authority, Docker lifecycle authority, Profile Exposure authority, provider admission authority, wildcard tool authority, product-readiness authority, release authority, or production authority.
+
+## Legacy Relation
+
+Older BTE-embedded vision, cloud-provider SDK, VLM, FLUX, palette, rembg, Visual Evidence, and package-candidate work is distilled into this standalone gateway only when current docs and validators admit the intention. Do not import provider credentials, backend state, runtime behavior, cloud-provider coupling, wildcard tool access, or implementation mass because it exists.
+
+## Completion State
+
+Stage: CLEAN.
+Clean score: 100.
+Current next pass: keep this route static unless a governed route authorizes Docker, FastAPI/Uvicorn, endpoint calls, Spark/ComfyUI/vLLM calls, provider calls, package installation, Profile Exposure, Seed installation, Runtime startup, or readiness claims.
diff --git a/WORKBOARD.yaml b/WORKBOARD.yaml
index 3a47c16..b2d560c 100644
--- a/WORKBOARD.yaml
+++ b/WORKBOARD.yaml
@@ -24,3 +24,8 @@ items:
     status: complete
     source: AGENTS.md
     owner: ""
+  - id: SVRNTY-VISION-WORK-006
+    title: Svrnty Vision Navigation Index
+    status: complete
+    source: INDEX.md
+    owner: ""
diff --git a/tools/validate_svrnty_vision_child.py b/tools/validate_svrnty_vision_child.py
index a4a96ae..778f7a8 100755
--- a/tools/validate_svrnty_vision_child.py
+++ b/tools/validate_svrnty_vision_child.py
@@ -10,6 +10,7 @@ from pathlib import Path
 ROOT = Path(__file__).resolve().parents[1]
 REQUIRED = [
     "AGENTS.md",
+    "INDEX.md",
     "README.md",
     "WORKBOARD.yaml",
     "CONTEXT.md",
@@ -59,7 +60,25 @@ def main() -> int:
             "write durable Hindsight memory",
             "operator/developer docs, not cleanup-route authorization",
         ],
-        "WORKBOARD.yaml": ["SVRNTY-VISION-WORK-001", "SVRNTY-VISION-WORK-003", "SVRNTY-VISION-WORK-005", "status: complete", 'owner: ""'],
+        "INDEX.md": [
+            "Route: `svrnty-vision`.",
+            "Category: child-local sovereign vision HTTP gateway and Visual Perception Package Candidate workspace.",
+            "Svrnty Vision owns child-local VLM, FLUX, palette, and cutout gateway source",
+            "Svrnty Vision is not Core authority, Seed installation authority, Runtime startup authority",
+            "Stage: CLEAN.",
+            "Clean score: 100.",
+            "Docker, FastAPI/Uvicorn, endpoint calls",
+        ],
+        "WORKBOARD.yaml": [
+            "SVRNTY-VISION-WORK-001",
+            "SVRNTY-VISION-WORK-003",
+            "SVRNTY-VISION-WORK-005",
+            "SVRNTY-VISION-WORK-006",
+            "Svrnty Vision Navigation Index",
+            "source: INDEX.md",
+            "status: complete",
+            'owner: ""',
+        ],
         "CONTEXT.md": ["Visual Perception Package Candidate", "Research Handoff"],
         "docs/VISION-PACKAGE-CANDIDATE.md": ["Research reads sources; Vision sees media", "wildcard grant"],
         "outputs/2026-06-12-svrnty-vision-workboard-readiness-reconciliation.md": [