docs: evidence-first README and export gate clarity

.gitattributes

@@ -9,3 +9,9 @@
 *.jpeg binary
 *.webp binary
 
+assets/readme/blackwell-runtime.png filter=lfs diff=lfs merge=lfs -text
+assets/readme/governance-workflow.png filter=lfs diff=lfs merge=lfs -text
+assets/readme/live-command-surface.png filter=lfs diff=lfs merge=lfs -text
+assets/readme/model-catalog.png filter=lfs diff=lfs merge=lfs -text
+assets/readme/real-flux-artifact.png filter=lfs diff=lfs merge=lfs -text
+assets/readme/wardrobe-controls.png filter=lfs diff=lfs merge=lfs -text

README.md

@@ -30,76 +30,134 @@ tags:
 
 # NEXUS Visual Weaver
 
-Dark creative-operations command center for the Hugging Face Build Small Hackathon.
+**Raven Chronicle** is a governed high-fashion visual creation command center.
 
-NEXUS Visual Weaver is a Gradio Space prototype for governed image and video creation. It combines a couture-oriented workflow dashboard, outfit and lore planning, model-lane governance, and an always-on defensive export gate.
+> Real generation. Visible governance. Auditable output.
 
-The current Space path is intentionally direct for judges: enter a creative brief, run the active weave, inspect the generated FLUX.2 artifact, review ST3GG evidence, approve the human checkpoint, and prepare a governed export packet.
+**Live Space:** [build-small-hackathon/NEXUS_Visual_Weaver](https://huggingface.co/spaces/build-small-hackathon/NEXUS_Visual_Weaver)
 
-## Direction
+NEXUS Visual Weaver is built for creative work where the image is only part of the deliverable. A weave run carries the prompt, wardrobe controls, model route, ST3GG scan, checkpoint state, and export evidence together so the operator can prove what happened.
 
-The interface is built around a command-center surface:
+## Live Command Surface
 
-- workflow graph for `Seed Prompt -> Refine -> Judge -> Locate -> Generate -> Video Path -> Human Checkpoint`
-- contextual inspector with taste rings, material checks, model stack, relay status, and ST3GG evidence
-- wardrobe drawer for garments, materials, footwear, accessories, locks, and reference-region intent
-- lore-to-video timeline for compact cinematic beats
-- provider handoff cards for dry-run visibility before any paid, gated, or quota-limited call
+![Live command surface](assets/readme/live-command-surface.png)
+
+The first screen is the working surface: creative brief, outfit controls, reference metadata, ST3GG input, model route, checkpoint controls, and the **Run Active Weave** action stay together.
+
+## Real Usage & Evidence
+
+![Real FLUX.2 Klein artifact](assets/readme/real-flux-artifact.png)
+
+| Evidence | Current status |
+| --- | --- |
+| Real FLUX.2 Klein 9B artifact | Verified in the live Space screenshot |
+| Creator controls | Visible in the command surface and persisted into run evidence |
+| ST3GG scan | Active before export |
+| Human checkpoint | Required before release |
+| Export gate | Blocks release until review or audit override |
+| Tests | 288 passing locally |
+| Secret scan | Clean |
+| Runtime | ZeroGPU / RTX Pro 6000 Blackwell |
+| Deployment evidence | Space SHA `621cf5d992e74c0d756ff0e5042a43f1fcab346d`; GitHub main `06114ab` |
+
+No sponsor or video lane is claimed as successful unless the export packet proves it. Missing-secret and gated states stay visible by design.
+
+## How a Governed Weave Works
+
+```mermaid
+flowchart LR
+    A["Creator controls"] --> B["Prompt refinement"]
+    B --> C["FLUX.2 Klein 9B generation"]
+    C --> D["ST3GG review"]
+    D --> E{"Human checkpoint"}
+    E -->|approved + clear| F["Governed export packet"]
+    E -->|reviewed + reason| G["Audit override packet"]
+    E -->|not reviewed| H["Export gate remains active"]
+```
+
+![Governance workflow](assets/readme/governance-workflow.png)
+
+The graph and inspector make the state visible: generation can succeed while export remains gated. That is intentional.
+
+## Governance Model
+
+**Generation is not export.**
+
+Every artifact must pass defensive review and human checkpoint before release. Adult Mode is opt-in and partitioned; it never disables safety, consent, provenance, dataset, or export gates.
+
+The export packet is the source of truth. It records:
+
+- creator controls and wardrobe slots
+- model and LoRA status
+- reference metadata and hashes
+- generated artifact basename
+- ST3GG verdict and override reason when used
+- checkpoint and provider states
+
+## Runtime Proof
+
+![Runtime telemetry](assets/readme/runtime-telemetry.png)
+
+![ZeroGPU Blackwell runtime](assets/readme/blackwell-runtime.png)
+
+The public Space is running on ZeroGPU with RTX Pro 6000 Blackwell visible in the live runtime panel. The footer telemetry is operational evidence, not a marketing mockup. When the status says the export gate is active, the app is protecting release rather than failing generation.
 
 ## Model Governance
 
 Pinned lanes do not rotate:
 
-- `image_generation`: Raven Quality FLUX.2 Klein 9B image lane, with FLUX.2 Klein 4B as Tiny Titan sidecar/fallback
-- `grounding`: NVIDIA LocateAnything-3B grounding anchor
-- `security`: ST3GG defensive scanner/export gate
+| Lane | Model | Role |
+| --- | --- | --- |
+| Image generation | `black-forest-labs/FLUX.2-klein-9B` | Raven Quality primary image lane |
+| Sidecar / Tiny Titan evidence | `black-forest-labs/FLUX.2-klein-4B` | Fallback and 4B sidecar |
+| Grounding | `nvidia/LocateAnything-3B` | Region and visual grounding anchor |
+| Security / export review | ST3GG adapter | Defensive scan, purification, export gate |
+
+Optional lanes are first-class but gated:
+
+| Lane | Status rule |
+| --- | --- |
+| OpenBMB MiniCPM-V | Claimed only when a configured provider returns success in an export packet |
+| NVIDIA Nemotron | Claimed only when a configured provider returns success in an export packet |
+| LTX-2.3 video path | Gated behind checkpoint and review in this sprint |
+| Modal / external jobs | Deferred unless configured and proven by runtime evidence |
+
+## Current Scope: Gated, Not Claimed
 
-Sponsor/evidence lanes are optional but first-class when secrets are configured:
+This sprint focuses on governed image creation and export evidence. Video rendering and external sponsor judges remain gated behind human review and secrets. The interface shows those states openly instead of pretending that missing-secret or deferred lanes succeeded.
 
-- `openbmb/MiniCPM-V-4.6` (1.30B): visual judge for wardrobe, footwear, material drift, lore continuity, and export notes.
-- `nvidia/NVIDIA-Nemotron-Parse-v1.2` (0.94B): structured evidence/parser lane for NVIDIA/Nemotron claim support.
+## Verification
+
+```powershell
+python -m compileall app.py src tests
+$env:PYTEST_DISABLE_PLUGIN_AUTOLOAD='1'
+python -m pytest -q tests -p no:cacheprovider --basetemp=C:\tmp\pytest-nvw-full
+git grep -n -I -E "hf_[A-Za-z0-9]{20,}|Bearer [A-Za-z0-9._-]+|sk-[A-Za-z0-9_-]{20,}|api[_-]?key\s*=" -- .
+```
 
-Helper lanes may rotate with quota, license, health, and parameter-budget checks:
+Latest local verification: **288 tests passing**, compile clean, tracked-file secret scan clean. The live Space root and `/gradio_api/info` returned HTTP 200 after deployment.
 
-- prompt routing
-- taste judging
-- audio lore TTS
-- video repair
-- HF catalog research
-- Modal job runner
+## Wardrobe, Catalog, And Evidence Surfaces
 
-Public demo mode uses the Raven Quality FLUX.2 Klein 9B lane when Space access is configured, while preserving the 4B sidecar for fallback/Tiny Titan evidence. Private research mode can add OFFELLIA/Gemma routes, but it never disables consent, provenance, ST3GG, export, or dataset-partition gates.
+![Wardrobe controls](assets/readme/wardrobe-controls.png)
 
-## Current Features
+![Model catalog evidence](assets/readme/model-catalog.png)
 
-- Gradio Blocks dashboard with split update regions.
-- Real FLUX.2 Klein 9B-first image generation on Hugging Face ZeroGPU when runtime access is configured, with honest 4B sidecar fallback.
-- Above-fold ST3GG trust strip with safe-vs-blocked fixture evidence.
-- Generated artifact ST3GG scan and checkpoint/export state.
-- Optional MiniCPM-V and Nemotron provider evidence lanes with explicit configured/missing-secret status.
-- Active workflow graph and checkpointed run record.
-- Taste profile scoring from `assets/taste_profile.json`.
-- Wardrobe slot planning for couture, gothic, fantasy, footwear, accessories, and material control.
-- HF model and LoRA catalog with Adult Mode hidden by default.
-- GMR/ModelRelay-inspired helper model selection.
-- ST3GG-inspired scan adapter with magic detection, mismatch review, purification actions, and export-gate state.
-- Focused regression tests for catalog scope, workflow planning, ModelRelay behavior, and scanner evidence.
+The wardrobe and catalog surfaces are included as evidence of the real operating model: couture slots, material locks, model roles, adapter shelf, and parameter-budget visibility.
 
 ## Build Small Prize Mapping
 
 | Target | Evidence status |
 | --- | --- |
-| Gradio Space | App runs as a public Hugging Face Gradio Space with `mcp_server=True`. |
-| <=32B models | Raven Quality stack is 16.42B: FLUX.2 Klein 9B + LocateAnything 3.83B + MiniCPM-V 1.30B + Nemotron Parse 0.94B + MiniCPM5 1.08B + FunctionGemma 0.27B. |
-| Off Brand | Custom command-center UI, dense inspector, workflow graph, wardrobe/lore drawer, and provider cards. |
-| Best Agent | Multi-step prompt, generation, scan, judge, checkpoint, export workflow. |
-| OpenBMB | Claimed only when MiniCPM-V returns success status in an export packet. |
-| NVIDIA | Claimed only when Nemotron returns success status in an export packet. LocateAnything remains visible but is not the Nemotron claim by itself. |
-| OpenAI Codex | Development branch and PR include Codex-authored implementation commits. |
+| Gradio Space | Public Hugging Face Gradio Space with `mcp_server=True`. |
+| <=32B models | Active stack remains under the 32B ceiling and is visible in the UI. |
+| Off Brand | Gothic couture command center with workflow graph, wardrobe drawer, ST3GG trust strip, and live artifact evidence. |
+| Best Agent | Multi-step weave: prompt refinement, generation, scan, optional judges, checkpoint, and governed export. |
+| OpenBMB | Conditional; claimed only when MiniCPM-V returns `success` in an export packet. |
+| NVIDIA | Conditional; claimed only when Nemotron returns `success`; LocateAnything remains grounding evidence. |
+| OpenAI Codex | Development and review work performed through Codex-authored implementation commits. |
 | Demo / social | Add final links here before submission: `DEMO_VIDEO_URL` and `SOCIAL_POST_URL`. |
 
-Tiny Titan can be claimed only from a successful sidecar export packet using the 4B mode. It must not weaken the main Raven Quality stack.
-
 ## Merit Badges
 
 | Badge | Bonus Quest | Status | Evidence |
@@ -120,30 +178,9 @@ python app.py
 
 The app reads `NEXUS_PORT` or `PORT` when present, otherwise it launches on `7860`.
 
-## Verification
-
-```powershell
-python -m compileall app.py src tests
-$env:NEXUS_DISABLE_REAL_HF='1'
-$env:PYTEST_DISABLE_PLUGIN_AUTOLOAD='1'
-python -m pytest -q tests -p no:cacheprovider --basetemp=C:\tmp\pytest-nvw-full
-```
-
 ## Secret Policy
 
-Do not commit provider credentials. Use Hugging Face Space secrets or local `.env` files for:
-
-- `HF_TOKEN`
-- `MINICPM_BASE_URL`
-- `MINICPM_API_KEY`
-- `MINICPM_MODEL`
-- `NEMOTRON_BASE_URL`
-- `NEMOTRON_API_KEY` or `NVIDIA_API_KEY`
-- `NEMOTRON_MODEL`
-- `MODAL_TOKEN_ID`
-- `MODAL_TOKEN_SECRET`
-- `OPENAI_API_KEY`
-- provider-specific API keys or bearer tokens
+Do not commit provider credentials. Use Hugging Face Space secrets or local `.env` files for provider keys.
 
 Generated outputs, local moodboards, logs, caches, auth folders, and preview artifacts are intentionally ignored.
 

app.py

@@ -670,13 +670,13 @@ def export_packet(
     scan = _authoritative_generated_scan(state)
     override_reason = (override_reason or "").strip()
     if run is None:
-        next_state = {**state, "provider_state": "blocked", "export": "blocked", "message": "Export blocked: no active run packet exists."}
+        next_state = {**state, "provider_state": "blocked", "export": "blocked", "message": "Export gate active: run an active weave before preparing an export packet."}
     elif state.get("checkpoint") != "approved":
-        next_state = {**state, "provider_state": "blocked", "export": "blocked", "message": "Export blocked: human checkpoint has not been approved."}
+        next_state = {**state, "provider_state": "blocked", "export": "blocked", "message": "Export gate active: approve the human checkpoint before release."}
     elif not _generated_output_path(state):
-        next_state = {**state, "provider_state": "blocked", "export": "blocked", "message": "Export blocked: no generated artifact exists."}
+        next_state = {**state, "provider_state": "blocked", "export": "blocked", "message": "Export gate active: generate an artifact before preparing evidence."}
     elif scan.get("export_gate") != "clear" and not override_reason:
-        next_state = {**state, "provider_state": "blocked", "export": scan.get("export_gate", "blocked"), "message": "Export blocked: ST3GG gate is not clear. Add an explicit override reason to write an audit packet."}
+        next_state = {**state, "provider_state": "blocked", "export": scan.get("export_gate", "blocked"), "message": "Export gate active: ST3GG is not clear. Add an explicit override reason to write an audit packet."}
     else:
         export_state = "clear" if scan.get("export_gate") == "clear" else "override"
         override_applies = scan.get("export_gate") != "clear" and bool(override_reason)

src/nexus_visual_weaver/render.py

@@ -54,6 +54,31 @@ def _metric(label: str, value: str, tone: str = "neutral") -> str:
     return f'<div class="nw-metric nw-metric-{tone}"><small>{escape(label)}</small><strong>{escape(value)}</strong></div>'
 
 
+def _display_state(value: str) -> str:
+    """Return user-facing state labels without changing machine state values."""
+    normalized = str(value or "").replace("_", " ").strip().lower()
+    labels = {
+        "blocked": "Export Gate Active",
+        "missing secret": "Optional - Secret Required",
+        "missing_secret": "Optional - Secret Required",
+        "export_ready": "Export Ready",
+        "configured": "CONFIGURED",
+        "dry-run": "Dry Run",
+        "dry run": "Dry Run",
+        "success": "SUCCESS",
+    }
+    return labels.get(normalized, normalized.title() if normalized else "Pending")
+
+
+def _gate_label(export_gate: str) -> str:
+    normalized = str(export_gate or "pending").upper()
+    if normalized == "BLOCKED":
+        return "Export Blocked - Override Available"
+    if normalized == "CLEAR":
+        return "EXPORT CLEAR"
+    return f"EXPORT {normalized}"
+
+
 def _env_configured(*names: str) -> bool:
     """
     Determine whether any of the provided environment variables are set and truthy.
@@ -211,7 +236,7 @@ def render_trust_strip(scan: dict | None = None, operator_state: dict | None = N
         <span>Every artifact must pass ST3GG scan, purification, and human checkpoint before release.</span>
       </div>
       <div class="nw-trust-card">{badge(f"ST3GG {status}", tone)}<span>{escape(str(findings[0]))}</span></div>
-      <div class="nw-trust-card">{badge(f"EXPORT {export_gate}", "pass" if export_gate == "CLEAR" else "warn" if export_gate == "BLOCKED" else "muted")}<span>{escape(str(actions[0]))}</span></div>
+      <div class="nw-trust-card">{badge(_gate_label(export_gate), "pass" if export_gate == "CLEAR" else "warn" if export_gate == "BLOCKED" else "muted")}<span>{escape(str(actions[0]))}</span></div>
       <div class="nw-trust-card">{badge(f"CHECKPOINT {checkpoint.upper()}", "pass" if checkpoint == "Approved" else "muted")}<span>Adult Mode never bypasses safety, consent, provenance, or dataset gates.</span></div>
       <div class="nw-trust-card nw-trust-examples">{badge("FIXTURE EVIDENCE", "cyan")}<span>Clean PNG -> pass. PNG trailing bytes -> blocked.</span></div>
     </section>
@@ -386,12 +411,26 @@ def render_workflow(run: GenerationRun | None = None, operator_state: dict | Non
             </g>
             """
         )
+    generation = operator_state.get("generation") or {}
+    generated = isinstance(generation, dict) and generation.get("status") == "success"
+    output_summary = "Real FLUX.2 Klein 9B artifact generated" if generated else "Awaiting generated artifact"
+    checkpoint_summary = _display_state(checkpoint_status)
+    export_summary = _display_state(str(operator_state.get("export", provider_state)))
+    next_summary = "Add override reason or complete review" if provider_state == "blocked" else action_label
     return f"""
     <section class="nw-panel nw-canvas">
       <div class="nw-panel-head nw-canvas-head">
         <div><strong>Active Weave</strong><small><span class="nw-live-dot"></span> Live / Weave ID: 4f7c9e2b</small></div>
         <div class="nw-tools nw-static-tools"><span>Layout Auto</span><span>{icon("zoom")}</span><span>{icon("frame")}</span></div>
       </div>
+      <div class="nw-run-summary">
+        <strong>Current Run Summary</strong>
+        <span><b>Output</b>{escape(output_summary)}</span>
+        <span><b>Security</b>ST3GG review active</span>
+        <span><b>Checkpoint</b>{escape(checkpoint_summary)}</span>
+        <span><b>Export</b>{escape(export_summary)}</span>
+        <span><b>Next</b>{escape(next_summary)}</span>
+      </div>
       <svg class="nw-graph" viewBox="0 0 1110 530" role="img" aria-label="NEXUS workflow graph">
         <defs>
           <pattern id="nw-grid" width="12" height="12" patternUnits="userSpaceOnUse">
@@ -404,7 +443,7 @@ def render_workflow(run: GenerationRun | None = None, operator_state: dict | Non
         {"".join(cards)}
       </svg>
       <div class="nw-legend">
-        {badge("Text Flow", "accent")} {badge("Refine Loop", "violet")} {badge("Policy Gate", "blue")} {badge("Media Flow", "cyan")} {badge("Human Gate", "warn")} {badge(provider_state.replace("_", " ").upper(), "pass" if provider_state == "exported" else "warn" if provider_state in {"blocked", "stopped"} else "muted")}
+        {badge("Text Flow", "accent")} {badge("Refine Loop", "violet")} {badge("Policy Gate", "blue")} {badge("Media Flow", "cyan")} {badge("Human Gate", "warn")} {badge(_display_state(provider_state), "pass" if provider_state == "exported" else "warn" if provider_state in {"blocked", "stopped"} else "muted")}
       </div>
       <div class="nw-weave-console">
         <div class="nw-console-card nw-console-primary">
@@ -457,7 +496,7 @@ def render_artifact_lane(run: GenerationRun | None = None, scan: dict | None = N
     outfit_label = "Outfit map"
     locate_label = "Grounding overlay"
     video_label = run.video.preset if run else "Video path"
-    active_prompt = run.refined_prompt.refined[:150] if run else "Awaiting first weave. The preview stage shows dry-run handoff packets until provider output exists."
+    active_prompt = run.refined_prompt.refined[:150] if run else "Awaiting first weave. Real output and export evidence appear here after generation."
     checkpoint = operator_state.get("checkpoint", getattr(run.checkpoint, "recommendation", "pending") if run else "pending")
     provider_state = str(operator_state.get("provider_state", "dry-run" if run else "idle"))
     generation = operator_state.get("generation") or {}
@@ -470,7 +509,7 @@ def render_artifact_lane(run: GenerationRun | None = None, scan: dict | None = N
         "checkpointed": "Checkpointed",
         "export_ready": "Export Ready",
         "exported": "Exported",
-        "blocked": "Blocked",
+        "blocked": "Export Gate Active",
         "stopped": "Stopped",
     }.get(provider_state, provider_state.replace("_", " ").title())
     demo_seed = (run.checkpoint.checkpoint_id[-4:] if run else "0000").upper()
@@ -478,7 +517,7 @@ def render_artifact_lane(run: GenerationRun | None = None, scan: dict | None = N
         (prompt_label, "Taste-refined brief", "dry-run", "material-0", "01"),
         (outfit_label, "Wardrobe slots and locks", "checkpointed", "material-1", "02"),
         (locate_label, "LocateAnything region plan", "configured", "material-4", "03"),
-        (video_label, "Checkpointed storyboard", "blocked" if scan.get("export_gate") == "blocked" or provider_state == "blocked" else "ready", "story-2", "04"),
+        (video_label, "Checkpointed storyboard", "deferred" if scan.get("export_gate") == "blocked" or provider_state == "blocked" else "ready", "story-2", "04"),
     ]
     cards = "".join(
         f"""
@@ -487,7 +526,7 @@ def render_artifact_lane(run: GenerationRun | None = None, scan: dict | None = N
           <i class="nw-{texture}"></i>
           <strong>{escape(title)}</strong>
           <span>{escape(body)}</span>
-          {badge(status.upper(), "warn" if status == "blocked" else "muted")}
+          {badge("Gated" if status == "deferred" else status.upper(), "warn" if status in {"blocked", "deferred"} else "muted")}
         </div>
         """
         for title, body, status, texture, index in artifacts
@@ -497,8 +536,8 @@ def render_artifact_lane(run: GenerationRun | None = None, scan: dict | None = N
     return f"""
     <section class="nw-panel nw-artifacts">
       <div class="nw-panel-head">
-        <div><strong>Artifact Preview Lane</strong><small>Honest handoff packets until a provider call succeeds</small></div>
-        {badge(f"Export {export_gate}", "warn" if export_gate == "BLOCKED" else "pass" if export_gate == "CLEAR" else "muted")}
+        <div><strong>Artifact Preview Lane</strong><small>Real output and export evidence appear here</small></div>
+        {badge(_gate_label(export_gate), "warn" if export_gate == "BLOCKED" else "pass" if export_gate == "CLEAR" else "muted")}
       </div>
       <div class="nw-preview-stage">
         <div class="nw-preview-frame">
@@ -518,7 +557,7 @@ def render_artifact_lane(run: GenerationRun | None = None, scan: dict | None = N
       <div class="nw-preview-ribbon">
         <span>{icon("security")} ST3GG before export</span>
         <span>{icon("wardrobe")} continuity: {escape(continuity)}</span>
-        <span>{icon("models")} provider call remains checkpointed; state: dry-run / configured / blocked / failed / exported; current: {escape(provider_state)}</span>
+        <span>{icon("models")} provider call remains checkpointed; state: dry-run / configured / gated / failed / exported; current: {escape(_display_state(provider_state))}</span>
       </div>
       <div class="nw-artifact-grid">{cards}</div>
     </section>
@@ -706,9 +745,9 @@ def render_provider_cards(relay_status: dict | None = None, adult_mode: bool = F
     optional_statuses = {
         "openbmb": "configured" if _provider_configured("MINICPM_BASE_URL", "MINICPM_API_KEY", "OPENBMB_API_KEY") else "missing secret",
         "nvidia": "configured" if _provider_configured("NEMOTRON_BASE_URL", "NEMOTRON_API_KEY", "NVIDIA_API_KEY") else "missing secret",
-        "fal": "configured" if _env_configured("FAL_KEY") else "blocked",
-        "netlify": "configured" if _env_configured("NETLIFY_AUTH_TOKEN", "NETLIFY_SITE_ID", "OPENAI_BASE_URL") else "blocked",
-        "cloudflare": "configured" if _env_configured("CLOUDFLARE_API_TOKEN", "CF_ACCOUNT_ID") else "blocked",
+        "fal": "configured" if _env_configured("FAL_KEY") else "deferred",
+        "netlify": "configured" if _env_configured("NETLIFY_AUTH_TOKEN", "NETLIFY_SITE_ID", "OPENAI_BASE_URL") else "deferred",
+        "cloudflare": "configured" if _env_configured("CLOUDFLARE_API_TOKEN", "CF_ACCOUNT_ID") else "deferred",
     }
     cards = []
     for decision in decisions[:5]:
@@ -721,7 +760,7 @@ def render_provider_cards(relay_status: dict | None = None, adult_mode: bool = F
         provider_state = "dry-run" if status == "ready" else "blocked" if status == "blocked" else "limited"
         if provider in optional_statuses:
             provider_state = optional_statuses[provider]
-        tone = "pass" if provider_state == "configured" else "warn" if provider_state in {"limited", "blocked", "failed"} else "muted"
+        tone = "pass" if provider_state == "configured" else "warn" if provider_state in {"limited", "failed"} else "muted"
         gate = primary.get("license_gate", "unknown")
         cards.append(
             f"""
@@ -730,7 +769,7 @@ def render_provider_cards(relay_status: dict | None = None, adult_mode: bool = F
               <strong>{escape(repo)}</strong>
               <span>{escape(str(provider))} / {escape(str(gate))}</span>
               <i class="nw-provider-meter" style="--health:{'86' if provider_state in {'configured', 'dry-run'} else '52' if provider_state == 'limited' else '22'}"></i>
-              <div>{badge(provider_state.upper(), tone)}{badge("CHECKPOINTED", "muted")}</div>
+              <div>{badge(_display_state(provider_state), tone)}{badge("CHECKPOINTED", "muted")}</div>
             </div>
             """
         )
@@ -742,9 +781,9 @@ def render_provider_cards(relay_status: dict | None = None, adult_mode: bool = F
             <div class="nw-provider-card nw-provider-optional">
               <small>optional gateway</small>
               <strong>{escape(provider.title())}</strong>
-              <span>off by default / secrets required</span>
+              <span>optional lane / secrets required</span>
               <i class="nw-provider-meter" style="--health:{'74' if state == 'configured' else '18'}"></i>
-              <div>{badge(state.upper(), "pass" if state == "configured" else "warn")}{badge("SPONSOR LANE" if provider in {"openbmb", "nvidia", "hf_nvidia"} else "NOT MVP DEFAULT", "muted")}</div>
+              <div>{badge(_display_state(state), "pass" if state == "configured" else "muted")}{badge("SPONSOR LANE" if provider in {"openbmb", "nvidia", "hf_nvidia"} else "DEFERRED", "muted")}</div>
             </div>
             """
         )
@@ -752,7 +791,7 @@ def render_provider_cards(relay_status: dict | None = None, adult_mode: bool = F
     return f"""
     <section class="nw-panel nw-providers">
       <div class="nw-panel-head">
-        <div><strong>Provider Handoff Cards</strong><small>Configured as visible packets before any paid or gated call</small></div>
+        <div><strong>Optional Provider Lanes</strong><small>Visible capability cards; success is claimed only after configured calls</small></div>
         {badge(mode_label.upper(), "warn" if adult_mode else "pass")}
       </div>
       <div class="nw-provider-grid">{"".join(cards)}</div>
@@ -811,7 +850,7 @@ def render_inspector(
     minicpm = operator_state.get("minicpm_judge") or {}
     nemotron = operator_state.get("nemotron_evidence") or {}
     sponsor_rows = "".join(
-        f"<li><span>{escape(label)}</span><strong>{escape(str(result.get('status', 'pending')).upper())}</strong><em>{escape(str(result.get('repo_id', repo)))}</em></li>"
+        f"<li><span>{escape(label)}</span><strong>{escape(_display_state(str(result.get('status', 'pending'))))}</strong><em>{escape(str(result.get('repo_id', repo)))}</em></li>"
         for label, repo, result in [
             ("OpenBMB MiniCPM", "openbmb/MiniCPM-V-4.6", minicpm),
             ("NVIDIA Nemotron", "nvidia/NVIDIA-Nemotron-Parse-v1.2", nemotron),
@@ -906,7 +945,8 @@ def render_drawer(run: GenerationRun | None = None) -> str:
 def render_status_bar(operator_state: dict | None = None) -> str:
     space = _space_runtime_status()
     operator_state = operator_state or {}
-    provider_state = str(operator_state.get("provider_state", "idle")).replace("_", " ").title()
+    raw_provider_state = str(operator_state.get("provider_state", "idle"))
+    provider_state = _display_state(raw_provider_state)
     stop_class = "nw-stop-idle" if provider_state == "Idle" else "nw-stop-active"
     return f"""
     <footer class="nw-statusbar">

src/nexus_visual_weaver/styles.py

@@ -281,8 +281,41 @@ footer { display: none !important; }
   white-space: nowrap;
 }
 .nw-mini-chip { width: fit-content; min-height: 22px; padding: 2px 7px; }
-.nw-canvas { overflow: hidden; height: 570px; }
-.nw-graph { width: 100%; min-height: 548px; display: block; background: #070b0f; }
+.nw-canvas { overflow: hidden; height: auto; min-height: 570px; }
+.nw-run-summary {
+  margin: 10px 12px 0;
+  display: grid;
+  grid-template-columns: 1.1fr repeat(5, minmax(120px, 1fr));
+  gap: 8px;
+  align-items: stretch;
+}
+.nw-run-summary > strong,
+.nw-run-summary > span {
+  min-height: 48px;
+  border: 1px solid var(--nw-line);
+  border-radius: 6px;
+  background:
+    linear-gradient(135deg, rgba(38,215,130,.08), transparent 46%),
+    rgba(255,255,255,.018);
+  padding: 8px 9px;
+  display: grid;
+  align-content: center;
+  gap: 2px;
+  color: var(--nw-text);
+  font-size: 11px;
+  line-height: 1.25;
+}
+.nw-run-summary > strong {
+  border-color: rgba(38,215,130,.34);
+  color: var(--nw-green);
+  font-size: 12px;
+}
+.nw-run-summary b {
+  color: var(--nw-muted);
+  font-size: 10px;
+  text-transform: uppercase;
+}
+.nw-graph { width: 100%; min-height: 470px; display: block; background: #070b0f; }
 .nw-edges path {
   fill: none;
   stroke: var(--nw-cyan);

tests/test_command_center.py

@@ -158,20 +158,21 @@ def test_dashboard_regions_expose_artifacts_and_provider_cards() -> None:
     assert "nw-preview-ribbon" in regions["artifacts"]
     assert "PRIMARY OUTPUT STAGE" in regions["artifacts"]
     assert "JUDGE-SAFE DEMO OUTPUT" in regions["artifacts"]
-    assert "state: dry-run / configured / blocked / failed" in regions["artifacts"]
+    assert "state: dry-run / configured / gated / failed" in regions["artifacts"]
     assert "Forge Operations" in regions["operations"]
-    assert "Provider Handoff Cards" in regions["providers"]
+    assert "Optional Provider Lanes" in regions["providers"]
     assert "nw-provider-meter" in regions["providers"]
     assert "optional gateway" in regions["providers"]
     assert "CHECKPOINTED" in regions["providers"]
     assert "Forge Operations" in regions["operations"]
-    assert "Provider Handoff Cards" in regions["providers"]
+    assert "Optional Provider Lanes" in regions["providers"]
     assert "nw-provider-meter" in regions["providers"]
     assert "Selected: Forge" in regions["command_rail"]
     assert "TRUST MODEL" in regions["topbar"]
     assert "Clean PNG -> pass" in regions["topbar"]
     assert "ST3GG Scan" in regions["inspector"]
     assert "nw-weave-console" in regions["workflow"]
+    assert "Current Run Summary" in regions["workflow"]
     assert "Hackathon Signal" in regions["workflow"]
     assert "Boots / heels" in regions["drawer"]
     assert "checkpointed" in regions["drawer"]
@@ -284,7 +285,7 @@ def test_render_trust_strip_review_scan_shows_blocked_export() -> None:
     html = render_trust_strip(scan=scan)
 
     assert "ST3GG REVIEW" in html
-    assert "EXPORT BLOCKED" in html
+    assert "Export Blocked - Override Available" in html
     assert "trailing data after IEND" in html
 
 
@@ -364,7 +365,7 @@ def test_render_inspector_with_missing_secret_shows_pending() -> None:
     }
     html = render_inspector(operator_state=operator_state)
 
-    assert "MISSING_SECRET" in html
+    assert "Optional - Secret Required" in html
 
 
 def test_render_inspector_with_success_judge_shows_success_status() -> None:
@@ -407,7 +408,7 @@ def test_render_provider_cards_shows_missing_secret_for_unconfigured_sponsor(mon
     monkeypatch.delenv("NVIDIA_API_KEY", raising=False)
     html = render_provider_cards()
 
-    assert "MISSING SECRET" in html
+    assert "Optional - Secret Required" in html
 
 
 def test_render_provider_cards_configured_openbmb_shows_configured(monkeypatch) -> None:
@@ -423,7 +424,7 @@ def test_render_provider_cards_configured_openbmb_shows_configured(monkeypatch)
     html = render_provider_cards()
 
     assert "CONFIGURED" not in html
-    assert "MISSING SECRET" in html
+    assert "Optional - Secret Required" in html
 
 
 def test_render_provider_cards_configured_openbmb_requires_key_and_base_url(monkeypatch) -> None: