first usable curator UI

This commit is contained in:
2026-04-25 23:04:15 +02:00
parent 8f94c38309
commit aa18dfc8f2
10 changed files with 677 additions and 10 deletions

View File

@@ -0,0 +1,403 @@
from __future__ import annotations
from dataclasses import asdict
from html import escape
from fastapi import APIRouter, Depends, Form
from fastapi.responses import HTMLResponse, RedirectResponse
from repo_registry.core.service import RegistryService
from repo_registry.web_api.app import get_service
router = APIRouter(include_in_schema=False)
def page(title: str, body: str) -> HTMLResponse:
return HTMLResponse(
f"""
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>{escape(title)} · Repository Ability Registry</title>
<style>
:root {{
color-scheme: light;
--bg: #f7f8fa;
--panel: #ffffff;
--text: #1f2933;
--muted: #637381;
--line: #d9dee7;
--accent: #0f766e;
--accent-dark: #115e59;
--warn: #9a3412;
}}
* {{ box-sizing: border-box; }}
body {{
margin: 0;
background: var(--bg);
color: var(--text);
font: 14px/1.45 system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
}}
header {{
background: #17212b;
color: #fff;
padding: 14px 28px;
display: flex;
align-items: center;
justify-content: space-between;
}}
header a {{ color: #e6fffb; text-decoration: none; }}
main {{ max-width: 1180px; margin: 0 auto; padding: 24px; }}
h1 {{ font-size: 24px; margin: 0 0 18px; }}
h2 {{ font-size: 18px; margin: 28px 0 10px; }}
h3 {{ font-size: 15px; margin: 16px 0 6px; }}
p {{ margin: 0 0 10px; }}
a {{ color: var(--accent-dark); }}
.grid {{ display: grid; grid-template-columns: 1fr 1fr; gap: 18px; align-items: start; }}
.panel {{
background: var(--panel);
border: 1px solid var(--line);
border-radius: 8px;
padding: 16px;
}}
.stack {{ display: grid; gap: 12px; }}
.muted {{ color: var(--muted); }}
.pill {{
display: inline-flex;
align-items: center;
min-height: 24px;
padding: 2px 8px;
border: 1px solid var(--line);
border-radius: 999px;
color: var(--muted);
background: #fbfcfd;
font-size: 12px;
}}
table {{ width: 100%; border-collapse: collapse; background: var(--panel); }}
th, td {{ text-align: left; border-bottom: 1px solid var(--line); padding: 10px 8px; vertical-align: top; }}
th {{ color: var(--muted); font-weight: 600; font-size: 12px; text-transform: uppercase; }}
input, textarea {{
width: 100%;
border: 1px solid var(--line);
border-radius: 6px;
padding: 9px 10px;
font: inherit;
}}
label {{ display: grid; gap: 5px; color: var(--muted); font-size: 12px; font-weight: 600; }}
button, .button {{
display: inline-flex;
align-items: center;
justify-content: center;
min-height: 34px;
padding: 7px 12px;
border: 1px solid var(--accent);
border-radius: 6px;
background: var(--accent);
color: white;
font: inherit;
font-weight: 650;
text-decoration: none;
cursor: pointer;
}}
.button.secondary, button.secondary {{
color: var(--accent-dark);
background: white;
}}
.tree ul {{ margin: 8px 0 0 20px; padding: 0; }}
.tree li {{ margin: 6px 0; }}
.source {{ color: var(--muted); font-family: ui-monospace, SFMono-Regular, Consolas, monospace; font-size: 12px; }}
.actions {{ display: flex; gap: 8px; flex-wrap: wrap; align-items: center; }}
@media (max-width: 780px) {{
header {{ padding: 12px 16px; }}
main {{ padding: 16px; }}
.grid {{ grid-template-columns: 1fr; }}
table, tbody, tr, td {{ display: block; width: 100%; }}
thead {{ display: none; }}
td {{ border-bottom: 0; padding: 6px 0; }}
tr {{ border-bottom: 1px solid var(--line); padding: 10px 0; display: block; }}
}}
</style>
</head>
<body>
<header>
<a href="/ui"><strong>Repository Ability Registry</strong></a>
<a href="/docs">API Docs</a>
</header>
<main>{body}</main>
</body>
</html>
"""
)
@router.get("/ui")
def repository_index(service: RegistryService = Depends(get_service)) -> HTMLResponse:
repositories = service.list_repositories()
rows = "\n".join(
f"""
<tr>
<td><a href="/ui/repos/{repo.id}">{escape(repo.name)}</a></td>
<td><span class="pill">{escape(repo.status)}</span></td>
<td class="source">{escape(repo.branch)}</td>
<td class="source">{escape(repo.url)}</td>
</tr>
"""
for repo in repositories
)
body = f"""
<h1>Repositories</h1>
<div class="grid">
<section class="panel">
<h2>Register Repository</h2>
<form class="stack" method="post" action="/ui/repos">
<label>Git URL or local path <input name="url" required></label>
<label>Branch <input name="branch" value="main"></label>
<button type="submit">Register</button>
</form>
</section>
<section class="panel">
<h2>Registry</h2>
<table>
<thead><tr><th>Name</th><th>Status</th><th>Branch</th><th>Source</th></tr></thead>
<tbody>{rows or '<tr><td colspan="4" class="muted">No repositories yet.</td></tr>'}</tbody>
</table>
</section>
</div>
"""
return page("Repositories", body)
@router.post("/ui/repos")
def create_repository_from_form(
url: str = Form(...),
branch: str = Form("main"),
service: RegistryService = Depends(get_service),
) -> RedirectResponse:
repository = service.register_repository(
url=url,
branch=branch or "main",
)
return RedirectResponse(f"/ui/repos/{repository.id}", status_code=303)
@router.get("/ui/repos/{repository_id}")
def repository_detail(
repository_id: int,
service: RegistryService = Depends(get_service),
) -> HTMLResponse:
repository = service.get_repository(repository_id)
runs = service.list_analysis_runs(repository_id)
ability_map = service.ability_map(repository_id)
run_rows = "\n".join(
f"""
<tr>
<td><a href="/ui/repos/{repository_id}/analysis-runs/{run.id}">#{run.id}</a></td>
<td><span class="pill">{escape(run.status)}</span></td>
<td class="source">{escape(run.started_at)}</td>
<td>{escape(run.error_message or '')}</td>
</tr>
"""
for run in runs
)
body = f"""
<div class="actions">
<h1 style="margin-right:auto">{escape(repository.name)}</h1>
<a class="button secondary" href="/ui">Back</a>
</div>
<p class="muted">{escape(repository.description or '')}</p>
<p><span class="pill">{escape(repository.status)}</span> <span class="source">{escape(repository.url)}</span></p>
<div class="grid">
<section class="panel">
<h2>Run Analysis</h2>
<form class="stack" method="post" action="/ui/repos/{repository_id}/analysis-runs">
<label>Override source path <input name="source_path" placeholder="Optional local path"></label>
<button type="submit">Analyze</button>
</form>
<h2>Analysis Runs</h2>
<table>
<thead><tr><th>Run</th><th>Status</th><th>Started</th><th>Error</th></tr></thead>
<tbody>{run_rows or '<tr><td colspan="4" class="muted">No runs yet.</td></tr>'}</tbody>
</table>
</section>
<section class="panel">
<h2>Approved Ability Map</h2>
{render_ability_map(asdict(ability_map))}
</section>
</div>
"""
return page(repository.name, body)
@router.post("/ui/repos/{repository_id}/analysis-runs")
def create_analysis_run_from_form(
repository_id: int,
source_path: str = Form(""),
service: RegistryService = Depends(get_service),
) -> RedirectResponse:
summary = service.analyze_repository(
repository_id,
source_path=source_path or None,
)
return RedirectResponse(
f"/ui/repos/{repository_id}/analysis-runs/{summary.analysis_run.id}",
status_code=303,
)
@router.get("/ui/repos/{repository_id}/analysis-runs/{analysis_run_id}")
def analysis_run_detail(
repository_id: int,
analysis_run_id: int,
service: RegistryService = Depends(get_service),
) -> HTMLResponse:
repository = service.get_repository(repository_id)
candidate_graph = service.candidate_graph(repository_id, analysis_run_id)
facts = service.list_observed_facts(repository_id, analysis_run_id)
fact_rows = "\n".join(
f"""
<tr>
<td>{escape(fact.kind)}</td>
<td>{escape(fact.name)}</td>
<td class="source">{escape(fact.path)}</td>
<td class="source">{escape(fact.value)}</td>
</tr>
"""
for fact in facts
)
body = f"""
<div class="actions">
<h1 style="margin-right:auto">{escape(repository.name)} · Run #{analysis_run_id}</h1>
<a class="button secondary" href="/ui/repos/{repository_id}">Repository</a>
</div>
<div class="grid">
<section class="panel">
<div class="actions">
<h2 style="margin-right:auto">Candidate Graph</h2>
<form method="post" action="/ui/repos/{repository_id}/analysis-runs/{analysis_run_id}/candidate-graph/approve">
<button type="submit">Approve</button>
</form>
</div>
{render_candidate_graph(asdict(candidate_graph))}
</section>
<section class="panel">
<h2>Observed Facts</h2>
<table>
<thead><tr><th>Kind</th><th>Name</th><th>Path</th><th>Value</th></tr></thead>
<tbody>{fact_rows or '<tr><td colspan="4" class="muted">No observed facts.</td></tr>'}</tbody>
</table>
</section>
</div>
"""
return page(f"{repository.name} Run {analysis_run_id}", body)
@router.post("/ui/repos/{repository_id}/analysis-runs/{analysis_run_id}/candidate-graph/approve")
def approve_candidate_graph_from_form(
repository_id: int,
analysis_run_id: int,
service: RegistryService = Depends(get_service),
) -> RedirectResponse:
service.approve_candidate_graph(
repository_id,
analysis_run_id,
notes="Approved from web UI",
)
return RedirectResponse(f"/ui/repos/{repository_id}", status_code=303)
def render_candidate_graph(graph: dict) -> str:
abilities = graph.get("abilities", [])
if not abilities:
return '<p class="muted">No candidates generated.</p>'
items = []
for ability in abilities:
capabilities = "".join(render_candidate_capability(capability) for capability in ability["capabilities"])
items.append(
f"""
<li>
<strong>{escape(ability['name'])}</strong>
<span class="pill">{escape(ability['status'])}</span>
<span class="pill">{ability['confidence']:.2f}</span>
<p class="muted">{escape(ability['description'])}</p>
{render_sources(ability['source_refs'])}
<ul>{capabilities}</ul>
</li>
"""
)
return f'<div class="tree"><ul>{"".join(items)}</ul></div>'
def render_candidate_capability(capability: dict) -> str:
features = "".join(
f'<li>{escape(feature["name"])} <span class="pill">{escape(feature["type"])}</span> <span class="source">{escape(feature["location"])}</span></li>'
for feature in capability["features"]
)
evidence = "".join(
f'<li>{escape(item["type"])} <span class="pill">{escape(item["strength"])}</span> <span class="source">{escape(item["reference"])}</span></li>'
for item in capability["evidence"]
)
return f"""
<li>
<strong>{escape(capability['name'])}</strong>
<span class="pill">{escape(capability['status'])}</span>
<span class="pill">{capability['confidence']:.2f}</span>
<p class="muted">{escape(capability['description'])}</p>
{render_sources(capability['source_refs'])}
<h3>Features</h3>
<ul>{features or '<li class="muted">No feature candidates.</li>'}</ul>
<h3>Evidence</h3>
<ul>{evidence or '<li class="muted">No evidence candidates.</li>'}</ul>
</li>
"""
def render_ability_map(ability_map: dict) -> str:
abilities = ability_map.get("abilities", [])
if not abilities:
return '<p class="muted">No approved entries yet.</p>'
items = []
for ability in abilities:
capabilities = []
for capability in ability["capabilities"]:
features = "".join(
f'<li>{escape(feature["name"])} <span class="pill">{escape(feature["type"])}</span> <span class="source">{escape(feature["location"])}</span></li>'
for feature in capability["features"]
)
evidence = "".join(
f'<li>{escape(item["type"])} <span class="pill">{escape(item["strength"])}</span> <span class="source">{escape(item["reference"])}</span></li>'
for item in capability["evidence"]
)
capabilities.append(
f"""
<li>
<strong>{escape(capability['name'])}</strong>
<p class="muted">{escape(capability['description'])}</p>
<ul>{features}{evidence}</ul>
</li>
"""
)
items.append(
f"""
<li>
<strong>{escape(ability['name'])}</strong>
<p class="muted">{escape(ability['description'])}</p>
<ul>{''.join(capabilities)}</ul>
</li>
"""
)
return f'<div class="tree"><ul>{"".join(items)}</ul></div>'
def render_sources(source_refs: list[dict]) -> str:
if not source_refs:
return ""
sources = ", ".join(
f'<span class="source">{escape(ref["kind"])}:{escape(ref["path"] or ref["name"])}</span>'
for ref in source_refs[:5]
)
if len(source_refs) > 5:
sources += f' <span class="muted">+{len(source_refs) - 5} more</span>'
return f"<p>{sources}</p>"