feat(maestro): web client (Vite + TS + xterm.js)

NAP-218. Browser UI for the prototype: catalog tree derived from
`metadata.label`, live updates over `WS /api/events`, search across
session name+label, spawn modal (with optional git worktree), and an
attach view that opens the daemon's per-session WS for xterm.js.

Framework choice: vanilla TypeScript. The interactivity surface is
small enough that pulling in a framework wouldn't pay back; xterm.js
does the heavy lifting. Easy to swap later without protocol impact.

Hash-based routing (`#/`, `#/attach/<id>`) keeps the registry's
static surface dumb — no SPA fallback needed; concurrent attaches
work by opening the same hash URL in another tab.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-05-25 09:57:11 +00:00
co-authored by Claude Opus 4.7
parent b68e39a9e5
commit e68c9b6d73
16 changed files with 2188 additions and 0 deletions
+535
View File
@@ -0,0 +1,535 @@
:root {
--bg: #0c0d10;
--surface: #14161b;
--surface-2: #1c1f26;
--border: #2a2e38;
--fg: #e6e6e6;
--muted: #98a2b3;
--accent: #6c8eef;
--accent-fg: #0c0d10;
--danger: #e5484d;
--ok: #30a46c;
--row-h: 44px;
--font-sans:
-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue",
Arial, "Noto Sans", sans-serif;
--font-mono:
ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono",
monospace;
}
* {
box-sizing: border-box;
}
html,
body {
height: 100%;
margin: 0;
background: var(--bg);
color: var(--fg);
font-family: var(--font-sans);
font-size: 15px;
line-height: 1.4;
-webkit-text-size-adjust: 100%;
}
#app {
height: 100%;
display: flex;
flex-direction: column;
overflow: hidden;
}
a {
color: inherit;
text-decoration: none;
}
code {
font-family: var(--font-mono);
font-size: 0.92em;
padding: 1px 4px;
background: var(--surface-2);
border-radius: 3px;
}
button,
input,
select,
textarea {
font-family: inherit;
font-size: inherit;
color: inherit;
}
.btn {
border: 1px solid var(--border);
background: var(--surface);
color: var(--fg);
padding: 0 14px;
height: 36px;
border-radius: 8px;
cursor: pointer;
font-weight: 500;
min-height: 36px;
display: inline-flex;
align-items: center;
justify-content: center;
}
.btn:hover {
background: var(--surface-2);
}
.btn-primary {
background: var(--accent);
border-color: var(--accent);
color: var(--accent-fg);
}
.btn-primary:hover {
filter: brightness(1.08);
}
.btn-ghost {
background: transparent;
}
.btn-icon {
width: 36px;
padding: 0;
}
/* ---------- catalog ---------- */
.catalog {
display: flex;
flex-direction: column;
height: 100%;
min-height: 0;
}
.catalog-header {
display: flex;
flex-wrap: wrap;
align-items: center;
justify-content: space-between;
gap: 12px;
padding: 12px 16px;
border-bottom: 1px solid var(--border);
background: var(--surface);
position: sticky;
top: 0;
z-index: 1;
}
.catalog-header h1 {
margin: 0;
font-size: 18px;
letter-spacing: 0.02em;
}
.catalog-actions {
display: flex;
flex: 1 1 280px;
gap: 8px;
align-items: center;
justify-content: flex-end;
}
.search {
flex: 1 1 220px;
max-width: 360px;
height: 36px;
padding: 0 12px;
background: var(--surface-2);
border: 1px solid var(--border);
border-radius: 8px;
outline: none;
}
.search:focus {
border-color: var(--accent);
}
.daemon-bar {
padding: 8px 16px;
display: flex;
flex-wrap: wrap;
gap: 6px;
border-bottom: 1px solid var(--border);
background: var(--surface);
}
.daemon-chip {
background: var(--surface-2);
border: 1px solid var(--border);
border-radius: 999px;
padding: 2px 10px;
font-size: 12px;
color: var(--muted);
}
.daemon-empty {
font-size: 12px;
color: var(--muted);
}
.tree {
flex: 1 1 auto;
overflow: auto;
padding: 8px 0 24px;
}
.empty {
padding: 24px 16px;
color: var(--muted);
text-align: center;
}
.tree-folder {
display: flex;
flex-direction: column;
}
.tree-folder-header {
display: flex;
align-items: center;
gap: 8px;
background: transparent;
border: 0;
width: 100%;
text-align: left;
height: var(--row-h);
padding-right: 16px;
color: var(--muted);
cursor: pointer;
font-size: 13px;
letter-spacing: 0.02em;
text-transform: uppercase;
}
.tree-folder-header:hover {
background: var(--surface);
}
.tree-folder-header .chevron {
width: 14px;
text-align: center;
color: var(--muted);
}
.folder-name {
flex: 1 1 auto;
color: var(--fg);
text-transform: none;
font-size: 14px;
letter-spacing: 0;
}
.folder-count {
font-size: 12px;
color: var(--muted);
padding: 1px 8px;
border-radius: 999px;
background: var(--surface-2);
}
.tree-leaf {
display: flex;
align-items: center;
gap: 10px;
min-height: var(--row-h);
padding: 8px 16px 8px 8px;
border-bottom: 1px solid transparent;
color: var(--fg);
}
.tree-leaf:hover {
background: var(--surface);
}
.tree-leaf:focus-visible {
outline: 2px solid var(--accent);
outline-offset: -2px;
}
.status {
width: 8px;
height: 8px;
border-radius: 50%;
flex: 0 0 8px;
background: var(--muted);
}
.status-running {
background: var(--ok);
}
.status-dead {
background: var(--danger);
opacity: 0.7;
}
.leaf-main {
display: flex;
flex-direction: column;
flex: 1 1 auto;
min-width: 0;
}
.leaf-name {
font-weight: 500;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.leaf-meta {
font-size: 12px;
color: var(--muted);
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.leaf-kill {
background: transparent;
color: var(--muted);
border: 1px solid transparent;
border-radius: 8px;
width: 36px;
height: 36px;
cursor: pointer;
flex: 0 0 36px;
}
.leaf-kill:hover {
color: var(--danger);
background: var(--surface-2);
border-color: var(--border);
}
/* ---------- attach view ---------- */
.attach {
display: flex;
flex-direction: column;
height: 100%;
background: var(--bg);
}
.attach-header {
display: flex;
align-items: center;
gap: 12px;
padding: 8px 12px;
border-bottom: 1px solid var(--border);
background: var(--surface);
}
.attach-header .back {
font-size: 18px;
width: 40px;
height: 36px;
}
.attach-title {
font-family: var(--font-mono);
font-size: 13px;
color: var(--muted);
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
flex: 1 1 auto;
}
.attach-state {
font-size: 12px;
padding: 2px 8px;
border-radius: 999px;
background: var(--surface-2);
color: var(--muted);
border: 1px solid var(--border);
}
.attach-state[data-state="open"] {
color: var(--ok);
}
.attach-state[data-state="closed"],
.attach-state[data-state="error"] {
color: var(--danger);
}
.attach-body {
flex: 1 1 auto;
min-height: 0;
padding: 6px;
display: flex;
background: #101115;
}
.attach-body .xterm {
width: 100%;
height: 100%;
}
.attach-status {
margin: 16px;
padding: 12px 14px;
border-radius: 8px;
background: var(--surface);
border: 1px solid var(--border);
font-size: 14px;
}
.attach-status.status-error {
border-color: var(--danger);
color: var(--danger);
}
/* ---------- modal ---------- */
.modal-backdrop {
position: fixed;
inset: 0;
background: rgba(0, 0, 0, 0.55);
display: flex;
align-items: flex-end;
justify-content: center;
padding: 0;
z-index: 50;
}
@media (min-width: 600px) {
.modal-backdrop {
align-items: center;
padding: 24px;
}
}
.modal {
background: var(--surface);
border-radius: 16px 16px 0 0;
border: 1px solid var(--border);
width: 100%;
max-width: 560px;
max-height: 90vh;
display: flex;
flex-direction: column;
}
@media (min-width: 600px) {
.modal {
border-radius: 12px;
}
}
.modal-header {
display: flex;
align-items: center;
justify-content: space-between;
padding: 14px 16px;
border-bottom: 1px solid var(--border);
}
.modal-header h2 {
margin: 0;
font-size: 16px;
}
.modal-body {
padding: 16px;
overflow: auto;
display: flex;
flex-direction: column;
gap: 12px;
}
.modal-body label {
display: flex;
flex-direction: column;
gap: 4px;
font-size: 13px;
color: var(--muted);
}
.modal-body label.row-inline {
flex-direction: row;
align-items: center;
gap: 8px;
color: var(--fg);
font-size: 14px;
}
.modal-body input[type="text"],
.modal-body select {
background: var(--surface-2);
border: 1px solid var(--border);
border-radius: 8px;
padding: 10px 12px;
color: var(--fg);
font-size: 15px;
width: 100%;
}
.modal-body input[type="text"]:focus,
.modal-body select:focus {
outline: none;
border-color: var(--accent);
}
.worktree {
border: 1px solid var(--border);
border-radius: 8px;
padding: 12px;
display: flex;
flex-direction: column;
gap: 10px;
}
.worktree legend {
padding: 0 6px;
color: var(--fg);
}
.modal-actions {
display: flex;
gap: 8px;
justify-content: flex-end;
margin-top: 8px;
}
.form-error {
color: var(--danger);
margin: 0;
font-size: 13px;
min-height: 1.2em;
}
/* ---------- not-found ---------- */
.not-found {
padding: 24px;
display: flex;
flex-direction: column;
gap: 12px;
align-items: flex-start;
}
/* ---------- responsive tweaks ---------- */
@media (max-width: 480px) {
.catalog-header h1 {
font-size: 16px;
}
.catalog-actions {
flex: 1 1 100%;
justify-content: stretch;
}
.search {
max-width: none;
}
}