docs(webui): update traffic state vocabulary docs and app nav for #640

webui/app.py

@@ -82,6 +82,7 @@ def _stub_page(title: str, description: str) -> HTMLResponse:
 
 
 _LEGACY_PAGES = (
+    ("/traffic", "Traffic", "workflow traffic-control view (#640)"),
     ("/queue", "Queue", "live PR and issue dashboard (#429)"),
     ("/projects", "Projects", "registry and onboarding (#427)"),
     ("/prompts", "Prompts", "canonical workflow prompt library (#428)"),

webui/traffic_views.py

@@ -36,7 +36,7 @@ def _render_traffic_item_row(item: TrafficItem) -> str:
     title_str = escape(item.title)
     role_str = escape(item.expected_role)
     badges_html = _render_badges(item.badges)
-    
+
     reason_html = ""
     if item.block_reason:
         reason_html = f'<div class="muted" style="font-size:0.82rem; margin-top:0.2rem;"><strong>Blocker:</strong> {escape(item.block_reason)}</div>'
@@ -60,7 +60,7 @@ def _render_traffic_item_row(item: TrafficItem) -> str:
 def _render_traffic_table(items: Sequence[TrafficItem], empty_message: str) -> str:
     if not items:
         return f'<p class="muted">{escape(empty_message)}</p>'
-    
+
     rows = "".join(_render_traffic_item_row(item) for item in items)
     return f"""<table class="registry">
   <thead>
@@ -79,13 +79,13 @@ def _render_traffic_table(items: Sequence[TrafficItem], empty_message: str) -> s
 def _render_next_roles(next_roles: Sequence[dict]) -> str:
     if not next_roles:
         return ""
-    
+
     cards = []
     for r in next_roles:
         role = escape(r.get("role", "unknown"))
         status = r.get("status", "idle")
         prompt = escape(r.get("prompt", ""))
-        
+
         status_cls = "badge-health-ok" if status == "safe" else ("badge-blocked" if "blocked" in status else "badge-health-skipped")
         cards.append(f"""<div class="health-card" style="margin-bottom:0.75rem;">
   <div style="display:flex; justify-content:space-between; align-items:center;">
@@ -94,7 +94,7 @@ def _render_next_roles(next_roles: Sequence[dict]) -> str:
   </div>
   <p class="meta" style="margin:0.35rem 0 0;">{prompt}</p>
 </div>""")
-    
+
     return f"""<div style="margin: 1.5rem 0;">
   <h3>Next Safe Role Actions</h3>
   {"".join(cards)}
@@ -144,7 +144,7 @@ def render_traffic_page(snapshot: TrafficSnapshot) -> str:
 
 <div class="prompt-card">
   <h3>3. Blocked Items (Dependencies / Locks)</h3>
-  <p class="muted">Items blocked by unmet dependency issues, status:blocked, or active terminal review locks. Never presented as safe.</p>
+  <p class="muted">Items blocked by unmet dependency issues, a missing head pin, a merge conflict, or an active terminal review lock. Items labelled status:blocked route to section 4. Never presented as safe.</p>
   {_render_traffic_table(snapshot.blocked, "No blocked items.")}
 </div>