fleet(tower): 0.18 — Tasks-View (Spool/Dead-Letter/Alarm) + Task-Detail-Modal + /healthz + /api/status; Fleet-Views 0.13-0.18 erstmals versioniert

This commit is contained in:
Hermes CEO
2026-10-30 04:55:35 +00:00
parent fa3d5d0a8f
commit 9e94512214
33 changed files with 3498 additions and 3 deletions
+396
View File
@@ -0,0 +1,396 @@
"use client"
/**
* TaskBrowser — Task-Detail-Ansicht im Tower (Karte tower-task-detail).
*
* Drei Listen aus /api/fleet/tasks:
* - Spool-Reifegrad (offene submitted/working, Alter)
* - Dead-Letter (failed der letzten 7 Tage)
* - Alarm-Feed (Stoerungsereignisse aus dem Journal)
* Klick auf eine Zeile -> /api/fleet/task-detail?id=... -> Modal mit vollem
* Envelope (from/to/type/status/priority/created/Alter/topic/thread/karte/body).
* Body unredigiert (Change-Order Abnahme 3; React escaped beim Rendern).
* Polt 30 s; degradierte Quelle -> Banner statt Leeranzeige.
*/
import { useCallback, useEffect, useRef, useState } from "react"
type TaskEnvelope = {
task_id: string
from: string
to: string
type: string
status: string
priority: string
created: number | null
created_iso: string
age_seconds: number | null
age_human: string
topic: string
body: string
thread_id: string
karte_id: string
reply_to: string
vs: string
claimed_at: string
status_label: string
file: string
}
type AlarmRow = {
time_epoch: number | null
time_iso: string
age_human: string
event: string
ref: string
from: string
to: string
task_id: string
note: string
}
type TaskOverview = {
generated_at: string
spool: TaskEnvelope[]
dead_letter: TaskEnvelope[]
alarm: AlarmRow[]
counts: { spool: number; dead_letter: number; alarm: number }
degraded: boolean
degraded_reason: string
}
type TaskDetail = {
generated_at: string
found: boolean
query_task_id: string
entry_kind: string
task: Record<string, string | number | null>
missing_fields: string[]
raw_keys: string[]
body_note: string
degraded: boolean
degraded_reason: string
error: string
}
type Tab = "spool" | "dead-letter" | "alarm"
const REFRESH_MS = 30000
const AGING_ALERT_S = 5400
const DETAIL_FIELDS: Array<[string, string]> = [
["task_id", "Task-ID"],
["status_label", "Status"],
["from", "Von"],
["to", "An"],
["type", "Typ"],
["priority", "Prio"],
["created_iso", "Erstellt (ISO)"],
["age_human", "Alter"],
["topic", "Thema"],
["thread_id", "Thread-ID"],
["karte_id", "Karte"],
["reply_to", "Antwort an"],
["vs", "Value-Stream"],
["claimed_at", "Geclaimt"],
]
function ageClass(seconds: number | null): string {
if (seconds === null) return "text-[var(--foreground-dim)]"
if (seconds > AGING_ALERT_S) return "text-[var(--status-stopped)] font-semibold"
if (seconds > 900) return "text-amber-400"
return "text-[var(--foreground-dim)]"
}
function prioClass(p: string): string {
switch (p) {
case "P1": return "text-[var(--status-stopped)] font-semibold"
case "P2": return "text-amber-400"
default: return "text-[var(--foreground-dim)]"
}
}
export default function TaskBrowser() {
const [data, setData] = useState<TaskOverview | null>(null)
const [loadError, setLoadError] = useState("")
const [tab, setTab] = useState<Tab>("spool")
const [detail, setDetail] = useState<TaskDetail | null>(null)
const [detailLoading, setDetailLoading] = useState(false)
const [detailError, setDetailError] = useState("")
const modalRef = useRef<HTMLDivElement | null>(null)
const load = useCallback(async () => {
try {
const res = await fetch("/api/fleet/tasks", { cache: "no-store" })
const body = (await res.json()) as TaskOverview & { error?: string }
if (!res.ok || body.error) {
setLoadError(body.error || `HTTP ${res.status}`)
return
}
setData(body)
setLoadError("")
} catch (e) {
setLoadError(e instanceof Error ? e.message : String(e))
}
}, [])
useEffect(() => {
void load()
const t = setInterval(() => void load(), REFRESH_MS)
return () => clearInterval(t)
}, [load])
const openDetail = useCallback(async (id: string, kind: string) => {
setDetailLoading(true)
setDetailError("")
setDetail(null)
try {
const res = await fetch(
`/api/fleet/task-detail?id=${encodeURIComponent(id)}&kind=${encodeURIComponent(kind)}`,
{ cache: "no-store" }
)
const body = (await res.json()) as TaskDetail & { error?: string }
if (!res.ok || body.error) {
setDetailError(body.error || `HTTP ${res.status}`)
} else {
setDetail(body)
}
} catch (e) {
setDetailError(e instanceof Error ? e.message : String(e))
} finally {
setDetailLoading(false)
}
}, [])
useEffect(() => {
const onKey = (e: KeyboardEvent) => {
if (e.key === "Escape") setDetail(null)
}
document.addEventListener("keydown", onKey)
return () => document.removeEventListener("keydown", onKey)
}, [])
const counts = data?.counts
const tabBtn = (id: Tab, label: string, n: number | undefined) => (
<button
onClick={() => setTab(id)}
data-testid={`task-tab-${id}`}
className={`px-3 py-1.5 text-[11px] font-mono uppercase tracking-wider border ${
tab === id
? "border-[var(--nvidia-green)] text-[var(--nvidia-green)] bg-[var(--background-tertiary)]"
: "border-[var(--border)] text-[var(--foreground-dim)] hover:text-[var(--foreground)]"
}`}
>
{label} <span className="ml-1 opacity-70">{n ?? 0}</span>
</button>
)
return (
<div className="space-y-4" data-testid="fleet-task-browser">
<div className="panel p-6">
<div className="flex flex-wrap items-center justify-between gap-3">
<div>
<h1 className="text-lg font-semibold text-[var(--nvidia-green)] uppercase tracking-wider">
Tasks
</h1>
<p className="mt-1 text-xs text-[var(--foreground-dim)]">
Spool-Reifegrad, Dead-Letter und Alarm-Feed — Klick auf eine Zeile zeigt den vollen
Task-Envelope (Body unveraendert). Refresh alle 30 s
{data ? ` · Stand ${new Date(data.generated_at).toLocaleTimeString()}` : ""}
</p>
</div>
<div className="flex gap-2" data-testid="task-tabs">
{tabBtn("spool", "Spool-Reife", counts?.spool)}
{tabBtn("dead-letter", "Dead-Letter", counts?.dead_letter)}
{tabBtn("alarm", "Alarm-Feed", counts?.alarm)}
</div>
</div>
{loadError && (
<div className="mt-4 border border-[var(--status-stopped)] bg-[var(--background-tertiary)] p-3 text-xs text-[var(--status-stopped)]">
Tasks nicht ladbar: {loadError}
</div>
)}
{data?.degraded && (
<div className="mt-4 border border-amber-500 bg-[var(--background-tertiary)] p-3 text-xs text-amber-400">
DEGRADED: {data.degraded_reason || "Quelle gestoert"} — Anzeige evtl. unvollstaendig.
</div>
)}
<div className="mt-4 overflow-x-auto">
{tab === "alarm" ? (
<table className="w-full text-left text-xs" data-testid="task-table-alarm">
<thead className="text-[10px] uppercase tracking-wider text-[var(--foreground-dim)]">
<tr>
<th className="py-2 pr-3">Alter</th>
<th className="py-2 pr-3">Event</th>
<th className="py-2 pr-3">Ref</th>
<th className="py-2 pr-3">Von</th>
<th className="py-2 pr-3">An</th>
<th className="py-2">Notiz</th>
</tr>
</thead>
<tbody className="font-mono">
{(data?.alarm || []).map((row, i) => (
<tr
key={`${row.event}-${row.ref}-${i}`}
data-tid={row.ref}
data-kind="alarm"
onClick={() => void openDetail(row.ref, "alarm")}
className="cursor-pointer border-t border-[var(--border)] hover:bg-[var(--background-tertiary)]"
>
<td className={`py-1.5 pr-3 whitespace-nowrap ${ageClass(null)}`}>{row.age_human}</td>
<td className="py-1.5 pr-3">{row.event}</td>
<td className="py-1.5 pr-3">{row.ref}</td>
<td className="py-1.5 pr-3">{row.from}</td>
<td className="py-1.5 pr-3">{row.to}</td>
<td className="py-1.5 max-w-[28rem] truncate" title={row.note}>
{row.note || "-"}
</td>
</tr>
))}
{data && data.alarm.length === 0 && (
<tr>
<td colSpan={6} className="py-4 text-[var(--foreground-dim)]">
Keine Stoerungsereignisse in den letzten 24 h.
</td>
</tr>
)}
</tbody>
</table>
) : (
<table className="w-full text-left text-xs" data-testid={`task-table-${tab}`}>
<thead className="text-[10px] uppercase tracking-wider text-[var(--foreground-dim)]">
<tr>
<th className="py-2 pr-3">Alter</th>
<th className="py-2 pr-3">Task-ID</th>
<th className="py-2 pr-3">Von -&gt; An</th>
<th className="py-2 pr-3">Typ</th>
<th className="py-2 pr-3">Prio</th>
<th className="py-2 pr-3">Status</th>
<th className="py-2">Thema</th>
</tr>
</thead>
<tbody className="font-mono">
{(tab === "spool" ? data?.spool : data?.dead_letter)?.map((t) => (
<tr
key={t.task_id}
data-tid={t.task_id}
data-kind={tab}
onClick={() => void openDetail(t.task_id, tab)}
className="cursor-pointer border-t border-[var(--border)] hover:bg-[var(--background-tertiary)]"
>
<td className={`py-1.5 pr-3 whitespace-nowrap ${ageClass(t.age_seconds)}`}>
{t.age_human}
</td>
<td className="py-1.5 pr-3 whitespace-nowrap">{t.task_id.slice(0, 8)}</td>
<td className="py-1.5 pr-3 whitespace-nowrap">
{t.from} -&gt; {t.to}
</td>
<td className="py-1.5 pr-3">{t.type}</td>
<td className={`py-1.5 pr-3 ${prioClass(t.priority)}`}>{t.priority}</td>
<td className="py-1.5 pr-3">{t.status_label}</td>
<td className="py-1.5 max-w-[26rem] truncate" title={t.topic}>
{t.topic}
</td>
</tr>
))}
{data && ((tab === "spool" ? data.spool : data.dead_letter).length === 0) && (
<tr>
<td colSpan={7} className="py-4 text-[var(--foreground-dim)]">
{tab === "spool"
? "Keine offenen Tasks — Spool leer."
: "Keine fehlgeschlagenen Tasks in den letzten 7 Tagen."}
</td>
</tr>
)}
</tbody>
</table>
)}
</div>
</div>
{(detail || detailLoading || detailError) && (
<div
ref={modalRef}
className="fixed inset-0 z-50 flex items-start justify-center bg-black/70 p-4 overflow-y-auto"
onClick={(e) => {
if (e.target === modalRef.current) setDetail(null)
}}
data-testid="task-detail-modal"
>
<div className="panel w-full max-w-3xl p-6 my-8">
<div className="flex items-start justify-between gap-4">
<div>
<h2 className="text-sm font-semibold text-[var(--nvidia-green)] uppercase tracking-wider">
Task-Detail
</h2>
<p className="mt-1 text-[11px] text-[var(--foreground-dim)] font-mono">
{(detail?.task.task_id as string) || "…"}
{detail?.entry_kind ? ` · Quelle: ${detail.entry_kind}` : ""}
{detail && !detail.found ? " · kein Envelope gefunden (synthetisches Ereignis)" : ""}
</p>
</div>
<button
onClick={() => setDetail(null)}
className="px-3 py-1 text-xs font-mono border border-[var(--border)] text-[var(--foreground-dim)] hover:text-[var(--foreground)]"
data-testid="task-detail-close"
>
Schliessen (Esc)
</button>
</div>
{detailLoading && <p className="mt-4 text-xs text-[var(--foreground-dim)]">Lade Envelope…</p>}
{detailError && (
<p className="mt-4 text-xs text-[var(--status-stopped)]">Detail nicht ladbar: {detailError}</p>
)}
{detail?.degraded && (
<p className="mt-4 text-xs text-amber-400">
DEGRADED: {detail.degraded_reason || "Quelle gestoert"}
{detail.error ? ` — ${detail.error}` : ""}
</p>
)}
{detail && (
<>
<dl className="mt-4 grid grid-cols-2 gap-x-4 gap-y-2 text-xs" data-testid="task-detail-grid">
{DETAIL_FIELDS.map(([key, label]) => (
<div key={key} className="contents">
<dt className="text-[10px] uppercase tracking-wider text-[var(--foreground-dim)]">
{label}
</dt>
<dd className="font-mono break-all">{String(detail.task[key] ?? "-")}</dd>
</div>
))}
</dl>
{detail.missing_fields.length > 0 && (
<p className="mt-3 text-[10px] text-[var(--foreground-dim)]">
Fehlende Felder: {detail.missing_fields.join(", ")}
</p>
)}
<div className="mt-4">
<p className="text-[10px] uppercase tracking-wider text-[var(--foreground-dim)]">
Body (unveraendert aus dem Spool)
</p>
<pre
className="mt-1 max-h-72 overflow-auto whitespace-pre-wrap break-words border border-[var(--border)] bg-[var(--background-tertiary)] p-3 text-[11px] font-mono"
data-testid="task-detail-body"
>
{String(detail.task.body ?? "-")}
</pre>
</div>
{detail.raw_keys.length > 0 && (
<p className="mt-3 text-[10px] text-[var(--foreground-dim)]">
Envelope-Keys: {detail.raw_keys.join(", ")}
</p>
)}
{Object.keys(detail.task).length === 0 && (
<p className="mt-3 text-xs text-[var(--foreground-dim)]">Keine Daten.</p>
)}
</>
)}
</div>
</div>
)}
</div>
)
}