jcwalker3andClaude Opus 4.8
08061b7b8a
Introduce a single nav-config module (webui/nav.py) driving grouped navigation across the epic #631 Phase 1 information architecture: Health, Traffic, Runtime/Sessions, Projects, Inventory, Timeline, Policy (placeholder), and Insights (placeholder). The shell header now carries a read-only environment badge (local/remote from WEBUI_HOST), a mode: read-only badge, and a Docs link. Home summarizes the console purpose, lists the Phase 1 surfaces by group, and links the MVP legacy pages. Not-yet-implemented surfaces (/sessions, /inventory, /timeline, /policy, /insights) resolve to graceful read-only stub pages rather than 404s; their backing views land in later child issues of #631 (inventory surfaces backed by #636). Mutating methods on stub routes still fail closed with read-only-mvp. No privileged action controls are added. Adds tests/test_webui_shell.py covering nav groups, badge presence, environment classification, docs link, stub routes (200 + read-only), and home content. Updates docs/webui-local-dev.md with the new routes and a Phase 1 shell section. Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
255 lines
7.0 KiB
Python
255 lines
7.0 KiB
Python
"""Shared HTML layout for the internal web UI."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import os
|
|
|
|
from webui.nav import NAV_GROUPS
|
|
|
|
MVP_NOTICE = (
|
|
"Read-only MVP — Gitea, MCP tools, and canonical workflows remain the "
|
|
"source of truth. No mutation endpoints."
|
|
)
|
|
|
|
# Canonical docs entry point surfaced from the shell header (#638).
|
|
DOCS_URL = (
|
|
"https://gitea.prgs.cc/Scaled-Tech-Consulting/Gitea-Tools/src/branch/"
|
|
"master/docs/webui-local-dev.md"
|
|
)
|
|
|
|
_LOCAL_HOSTS = frozenset({"", "127.0.0.1", "localhost", "::1"})
|
|
|
|
|
|
def environment_label() -> str:
|
|
"""Classify the serving environment as ``local`` or ``remote`` (#638).
|
|
|
|
Derived from the same ``WEBUI_HOST`` default the app binds to; loopback
|
|
hosts are ``local``, anything else is ``remote``. Read-only signal only.
|
|
"""
|
|
host = (os.environ.get("WEBUI_HOST", "127.0.0.1") or "").strip().lower()
|
|
return "local" if host in _LOCAL_HOSTS else "remote"
|
|
|
|
|
|
def _render_nav() -> str:
|
|
groups_html = []
|
|
for group in NAV_GROUPS:
|
|
links = "".join(
|
|
f'<a href="{item.href}"'
|
|
+ (' class="nav-stub"' if item.status == "stub" else "")
|
|
+ f'>{item.label}</a>'
|
|
for item in group.items
|
|
)
|
|
groups_html.append(
|
|
'<div class="nav-group">'
|
|
f'<span class="nav-group-label">{group.label}</span>'
|
|
f'<span class="nav-group-links">{links}</span>'
|
|
"</div>"
|
|
)
|
|
return "".join(groups_html)
|
|
|
|
|
|
def _render_badges() -> str:
|
|
env = environment_label()
|
|
return (
|
|
'<div class="header-badges">'
|
|
f'<span class="badge env-badge env-{env}">env: {env}</span>'
|
|
'<span class="badge mode-badge">mode: read-only</span>'
|
|
f'<a class="badge docs-link" href="{DOCS_URL}">Docs</a>'
|
|
"</div>"
|
|
)
|
|
|
|
|
|
def render_page(*, title: str, body_html: str, extra_head: str = "") -> str:
|
|
nav_links = _render_nav()
|
|
header_badges = _render_badges()
|
|
return f"""<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
<title>{title} · MCP Control Plane</title>
|
|
<style>
|
|
:root {{
|
|
--bg: #0f1419;
|
|
--surface: #1a2332;
|
|
--text: #e7ecf3;
|
|
--muted: #8b9cb3;
|
|
--accent: #5b9fd4;
|
|
--border: #2a3648;
|
|
}}
|
|
* {{ box-sizing: border-box; }}
|
|
body {{
|
|
margin: 0;
|
|
font-family: system-ui, -apple-system, sans-serif;
|
|
background: var(--bg);
|
|
color: var(--text);
|
|
line-height: 1.5;
|
|
}}
|
|
header {{
|
|
background: var(--surface);
|
|
border-bottom: 1px solid var(--border);
|
|
padding: 0.75rem 1.25rem;
|
|
}}
|
|
header h1 {{
|
|
margin: 0;
|
|
font-size: 1.1rem;
|
|
font-weight: 600;
|
|
}}
|
|
.header-top {{
|
|
display: flex;
|
|
flex-wrap: wrap;
|
|
align-items: center;
|
|
justify-content: space-between;
|
|
gap: 0.5rem 1rem;
|
|
margin-bottom: 0.6rem;
|
|
}}
|
|
.header-badges {{ display: inline-flex; flex-wrap: wrap; gap: 0.4rem; }}
|
|
.env-badge.env-local {{ color: #8fd19e; border-color: #3d6b4a; }}
|
|
.env-badge.env-remote {{ color: #e0c27a; border-color: #6b5730; }}
|
|
.mode-badge {{ color: #9ec8f0; border-color: #3d5f7a; }}
|
|
a.docs-link {{
|
|
color: var(--accent);
|
|
border-color: var(--accent);
|
|
text-decoration: none;
|
|
text-transform: none;
|
|
}}
|
|
a.docs-link:hover {{ filter: brightness(1.12); }}
|
|
nav {{
|
|
display: flex;
|
|
flex-wrap: wrap;
|
|
gap: 0.5rem 1.25rem;
|
|
}}
|
|
.nav-group {{
|
|
display: flex;
|
|
flex-direction: column;
|
|
gap: 0.15rem;
|
|
}}
|
|
.nav-group-label {{
|
|
font-size: 0.68rem;
|
|
text-transform: uppercase;
|
|
letter-spacing: 0.04em;
|
|
color: var(--muted);
|
|
}}
|
|
.nav-group-links {{ display: inline-flex; flex-wrap: wrap; gap: 0.6rem; }}
|
|
nav a {{
|
|
color: var(--accent);
|
|
text-decoration: none;
|
|
font-size: 0.9rem;
|
|
}}
|
|
nav a:hover {{ text-decoration: underline; }}
|
|
nav a.nav-stub {{ color: var(--muted); }}
|
|
nav a.nav-stub::after {{
|
|
content: " ·stub";
|
|
font-size: 0.7rem;
|
|
color: var(--muted);
|
|
}}
|
|
main {{
|
|
max-width: 52rem;
|
|
margin: 0 auto;
|
|
padding: 1.5rem 1.25rem 2.5rem;
|
|
}}
|
|
.notice {{
|
|
color: var(--muted);
|
|
font-size: 0.85rem;
|
|
margin-bottom: 1.25rem;
|
|
padding: 0.65rem 0.85rem;
|
|
border: 1px solid var(--border);
|
|
border-radius: 6px;
|
|
background: var(--surface);
|
|
}}
|
|
h2 {{ margin-top: 0; font-size: 1.35rem; }}
|
|
p {{ color: var(--muted); }}
|
|
.stub {{
|
|
border-left: 3px solid var(--accent);
|
|
padding-left: 0.85rem;
|
|
margin: 1rem 0;
|
|
}}
|
|
.meta {{ font-size: 0.85rem; }}
|
|
table.registry, table.detail {{
|
|
width: 100%;
|
|
border-collapse: collapse;
|
|
margin: 1rem 0;
|
|
font-size: 0.9rem;
|
|
}}
|
|
table.registry th, table.registry td,
|
|
table.detail th, table.detail td {{
|
|
text-align: left;
|
|
padding: 0.45rem 0.6rem;
|
|
border-bottom: 1px solid var(--border);
|
|
}}
|
|
table.registry th, table.detail th {{
|
|
color: var(--muted);
|
|
font-weight: 500;
|
|
}}
|
|
code {{
|
|
font-family: ui-monospace, monospace;
|
|
font-size: 0.85em;
|
|
color: var(--text);
|
|
}}
|
|
ol.checklist {{
|
|
padding-left: 1.25rem;
|
|
margin: 0.5rem 0 1.5rem;
|
|
}}
|
|
ol.checklist li {{ margin-bottom: 0.85rem; }}
|
|
ol.checklist p {{ margin: 0.25rem 0 0; font-size: 0.9rem; }}
|
|
.prompt-card {{
|
|
margin: 1.25rem 0 1.75rem;
|
|
padding: 1rem 1.1rem;
|
|
border: 1px solid var(--border);
|
|
border-radius: 8px;
|
|
background: var(--surface);
|
|
}}
|
|
.prompt-card h3 {{ margin: 0 0 0.5rem; font-size: 1.05rem; }}
|
|
pre.prompt-text {{
|
|
white-space: pre-wrap;
|
|
word-break: break-word;
|
|
margin: 0.75rem 0;
|
|
padding: 0.75rem 0.85rem;
|
|
border-radius: 6px;
|
|
background: var(--bg);
|
|
border: 1px solid var(--border);
|
|
font-size: 0.9rem;
|
|
color: var(--text);
|
|
}}
|
|
.copy-btn {{
|
|
background: var(--accent);
|
|
color: #0b1219;
|
|
border: none;
|
|
border-radius: 6px;
|
|
padding: 0.4rem 0.85rem;
|
|
font-size: 0.85rem;
|
|
cursor: pointer;
|
|
}}
|
|
.copy-btn:hover {{ filter: brightness(1.08); }}
|
|
.muted {{ color: var(--muted); }}
|
|
.badges {{ display: inline-flex; flex-wrap: wrap; gap: 0.35rem; margin-left: 0.5rem; }}
|
|
.badge {{
|
|
font-size: 0.72rem;
|
|
padding: 0.1rem 0.45rem;
|
|
border-radius: 999px;
|
|
border: 1px solid var(--border);
|
|
color: var(--muted);
|
|
text-transform: lowercase;
|
|
}}
|
|
.badge-claimed {{ color: #8fd19e; border-color: #3d6b4a; }}
|
|
.badge-blocked {{ color: #f0a8a8; border-color: #7a3b3b; }}
|
|
.badge-in-review {{ color: #9ec8f0; border-color: #3d5f7a; }}
|
|
.badge-duplicate {{ color: #e0c27a; border-color: #6b5730; }}
|
|
.badge-stale {{ color: #c9b8e8; border-color: #5a4a78; }}
|
|
</style>
|
|
{extra_head}
|
|
</head>
|
|
<body>
|
|
<header>
|
|
<div class="header-top">
|
|
<h1>MCP Control Plane</h1>
|
|
{header_badges}
|
|
</div>
|
|
<nav>{nav_links}</nav>
|
|
</header>
|
|
<main>
|
|
<p class="notice">{MVP_NOTICE}</p>
|
|
{body_html}
|
|
</main>
|
|
</body>
|
|
</html>""" |