svrnty-vision/AGENTS.md

Svrnty Vision Endgoal

Route: svrnty-vision at /home/svrnty/workspaces/cortex-os/svrnty-vision. Authority: child-local vision gateway and package-candidate workspace; Core authority lives in /home/svrnty/workspaces/cortex-os/core. Endgoal: keep svrnty-vision as the child-local sovereign vision HTTP gateway and Visual Perception Package Candidate for VLM analysis, FLUX rendering, palette extraction, and cutout work without Core authority, Seed installation authority, Runtime startup authority, Profile Exposure authority, provider admission, wildcard tool access, or product-readiness claims. Stage: CLEAN after python3 tools/validate_svrnty_vision_child.py passes. Clean score: 100. Authority boundary: child-local vision gateway and package-candidate workspace only; not Core authority, Runtime authority, Host Runtime authority, Profile Exposure authority, provider authority, Docker/runtime lifecycle authority, or readiness authority. Validator: python3 tools/validate_svrnty_vision_child.py. Legacy-work 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, or implementation mass because it exists.

Universal Cortex OS Agent Contract

• Treat this file as route-local instruction after parent AGENTS.md files and before chat memory.
• Start broad or ambiguous work with cortex graph context; use it only as Derived State, then read this repo's local files.
• Before edits, read AGENTS.md, README.md, and WORKBOARD.yaml; keep writes route-local unless a governed Core route explicitly authorizes promotion.
• Run this repo's named validator before handoff or done claims; use stronger proof only for runtime, provider, secret, memory, profile exposure, branch, release, or readiness effects.
• Record proof and handoffs as refs-only artifacts. Do not write Hindsight memory, Core SOT, sibling repos, live runtime state, provider state, external systems, or organization payloads unless explicitly authorized by the owning route.

Repo-Custom Agent Contract

Svrnty Vision is a child-local sovereign vision HTTP gateway and Visual Perception Package Candidate workspace. It owns VLM/FLUX/palette/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. It is not Cortex OS 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.

Do not start Runtime, start Docker, build or run containers, install packages, start the FastAPI/Uvicorn server, call VLM/FLUX/palette/rembg endpoints, call Spark/ComfyUI/vLLM services, call cloud vision/image providers, read credentials or env values, mutate BTE/Core/Seed/sibling/OpenDesign repos, grant wildcard tools, grant Profile Exposure, write durable Hindsight memory, or claim readiness from this workspace without explicit governed approval.

Svrnty Vision Child Workspace Rules

This workspace is child-local under the Cortex OS umbrella.

It is not Cortex OS Core authority. Promotion into Core requires a governed Core route.

Authority Order

1. /home/svrnty/workspaces/cortex-os/core active SOT.
2. /home/svrnty/workspaces/cortex-os/core/AGENTS.md.
3. This file.
4. README.md, WORKBOARD.yaml, and local tools.

Editing Rule

Keep work inside this workspace unless Core explicitly routes promotion.

After editing, run:

python3 tools/validate_svrnty_vision_child.py

Protected Boundaries

• Do not mutate ../core/ from this workspace.
• Do not mutate sibling repositories.
• Do not import this workspace into Core source.