/** * runbookHints.ts — 1:1-Portierung von /sandbox/fleet-change-orders/ * tower-notfall-runbook/runbook_hints.py (Karte tower-notfall-runbook, devops). * * Zweck: Kurzschritte + Eskalationskontakt fuer den Owner direkt an den * Alarm-Ampeln des Towers (10.0.30.213, tcp/8099) als kontextueller * Inline-Hint mit Deep-Link auf das Notfall-Runbook (/runbook#). * * Rein statisch — KEINE Datenquelle, KEIN Polling, KEIN Egress, KEINE * Secrets. LAMP_HINTS + buildView() + renderHintHtml() entsprechen * LAMP_HINTS + build_view() + render_hint_html() der Referenz 1:1. */ export const RUNBOOK_URL = "/runbook" export type LampHint = { key: "deadman" | "spool" | "health" | "deadletter" component: string badge_id: string | null anchor: string scenario: string title: string core: boolean kurzschritte: string[] eskalation: string } // Reihenfolge = Anzeige-Reihenfolge im Tower-Header/Panel. // core=true -> Pflicht-Ampel laut Karte (Deadman-Blockade, Spool-Stau, Panel-Ausfall). export const LAMP_HINTS: LampHint[] = [ { key: "deadman", component: "Deadman-Status", badge_id: "dm-badge", anchor: "#deadman", scenario: "A", title: "Deadman-Blockade", core: true, kurzschritte: [ "Owner-Queue oeffnen: blockierenden Task (ID, Typ, Alter) an der Deadman-Ampel ablesen.", "Task in der Queue entscheiden (Abnahme/Review/NAR) oder mit reply_to + Kommentar zurueckgeben.", "Deadman-Ampel auf 'progress' pruefen (Auto-Refresh 30 s).", ], eskalation: "Bleibt 'blocked' > 5400 s oder ist der Task unklar: Owner ueber die Owner-Queue informieren (Grund + Task-ID nennen).", }, { key: "spool", component: "Spool-Aging (Reife)", badge_id: "sp-badge", anchor: "#spool", scenario: "B", title: "Spool-Stau", core: true, kurzschritte: [ "Spool-Aging: aeltesten roten Envelope (> 5400 s) + Empfaenger ablesen.", "Empfaenger gruen: Task an denselben Empfaenger erneut submitten (reply_to setzen).", "Empfaenger rot: zuerst Szenario A/C loesen; Failed-Tasks ueber die Dead-Letter-Ansicht (#deadletter) pruefen.", ], eskalation: "Envelope > 5400 s ohne roten Empfaenger (Ursache unklar): an tower-owner ueber den CISO-Kanal melden (Envelope-IDs); ab 2 betroffenen Agents zusaetzlich Owner informieren.", }, { key: "health", component: "Health-Ampel / Panel", badge_id: null, anchor: "#health", scenario: "C", title: "Panel-Ausfall", core: true, kurzschritte: [ "/healthz pruefen: 200 = Server lebt, Problem liegt bei Datenquelle/UI.", "/api/status + Degraded-Banner: Quelle down = Degraded (60 s-Cache laeuft weiter), KEIN Totalausfall.", "Kein 200 / Verbindung abgelehnt = Totalausfall: Neustart/Deploy nur ueber Aenderungsauftrag, nicht selbst am Host.", ], eskalation: "healthz-Ausfall oder Deploy-Bedarf: sofort P1 an tower-owner ueber den CISO-Kanal; parallel Owner informieren (ohne Panel ist die Lage nur ueber die Agenten-Boards sichtbar).", }, { key: "deadletter", component: "Dead-Letter-Ansicht", badge_id: null, anchor: "#deadletter", scenario: "B3", title: "Verlorene Tasks", core: false, kurzschritte: [ "Dead-Letter: failed-Tasks (7 Tage) mit from->to + Alter pruefen.", "Wiederholbar: erneut submitten (reply_to); unloesbar: Task mit Grund neu aufsetzen, nicht still verwerfen.", ], eskalation: "Gehaeufte Failed-Tasks eines Empfaengers: Empfaenger-Health pruefen (#health), dann wie Szenario B eskalieren.", }, ] /** Hint per key (statisch, wirft bei unbekanntem key). */ export function hintByKey(key: LampHint["key"]): LampHint { const h = LAMP_HINTS.find((x) => x.key === key) if (!h) throw new Error(`unknown runbook hint: ${key}`) return h } export type HintView = { key: string component: string badge_id: string | null scenario: string title: string core: boolean anchor: string url: string kurzschritte: string[] eskalation: string html: string } /** Statische Hint-Ansicht (JSON-faehig) — entspricht build_view(). */ export function buildView(now: string | null = null, source = "static") { const hints: HintView[] = LAMP_HINTS.map((h) => ({ key: h.key, component: h.component, badge_id: h.badge_id, scenario: h.scenario, title: h.title, core: h.core, anchor: h.anchor, url: RUNBOOK_URL + h.anchor, kurzschritte: [...h.kurzschritte], eskalation: h.eskalation, html: renderHintHtml(h), })) return { generated_at: now, source, runbook_url: RUNBOOK_URL, refresh_seconds: 0, // statisch hint_count: hints.length, core_count: hints.filter((h) => h.core).length, hints, } } function escapeHtml(s: string): string { return s .replace(/&/g, "&") .replace(//g, ">") .replace(/"/g, """) } /** Kompakter Inline-Hint als HTML-String (rein Text + interner Link). */ export function renderHintHtml(h: LampHint): string { const esc = escapeHtml const stepLis = h.kurzschritte.map((s) => `
  • ${esc(s)}
  • `).join("") return `
    ` + `Notfall ${esc(h.scenario)} — ${esc(h.title)}` + `
      ${stepLis}
    ` + `
    Eskalation: ${esc(h.eskalation)}
    ` + `Vollstaendiges Runbook →` + `
    ` }