@cesarus777/opencode-cgp 0.4.0 → 0.4.1

package/dist/cli.js

@@ -936,6 +936,51 @@ function executionStatus(known, nativeRunning, evidence) {
   return known ? "idle" : "unknown";
 }
 
+// src/historyclient.ts
+function historyFailure(error, signal) {
+  if (signal?.aborted && signal.reason instanceof DOMException && signal.reason.name === "TimeoutError" || error instanceof DOMException && error.name === "TimeoutError")
+    return new HistoryFailure("timeout");
+  if (error instanceof HistoryFailure)
+    return error;
+  const code = typeof error === "object" && error !== null && "type" in error ? error.type : undefined;
+  return new HistoryFailure(code === "rpc.unavailable" || code === "rpc.method_not_found" ? "unsupported" : code === "rpc.invalid_output" ? "incompatible" : code === "rpc.invalid_input" ? "rejected" : "unavailable");
+}
+function checkedHistory(value, sessionId) {
+  if (!isHistoryResult(value) || value.data.series.some((series) => series.sessionId !== sessionId))
+    throw new HistoryFailure("incompatible");
+  return value;
+}
+function historyStatusLines(input) {
+  const messages = {
+    unsupported: "History service is unavailable in this server location. Check that the owning server has a plugin version with chart history. Press r to check again.",
+    timeout: "History request timed out. Press r to retry.",
+    incompatible: "History response is incompatible. Check client/server plugin versions. Press r to retry.",
+    rejected: "History request was rejected. Check client/server plugin versions. Press r to retry.",
+    unavailable: "History could not be loaded. Press r to retry."
+  };
+  return [
+    ...input.status === "loading" ? [
+      input.loadedAt === undefined ? "Loading retained history\u2026" : "Updating history \xB7 showing previous results"
+    ] : input.status === "disabled" ? [
+      "History recording is disabled in this server location. Press r to check again after configuration changes."
+    ] : input.status === "unavailable" ? [messages[input.reason ?? "unavailable"]] : [],
+    ...input.stale && input.loadedAt !== undefined ? [
+      `Showing previous results \xB7 last loaded ${new Date(input.loadedAt).toISOString()}`
+    ] : []
+  ];
+}
+var HistoryFailure;
+var init_historyclient = __esm(() => {
+  init_rpc();
+  HistoryFailure = class HistoryFailure extends Error {
+    reason;
+    constructor(reason) {
+      super(`History ${reason}`);
+      this.reason = reason;
+    }
+  };
+});
+
 // src/tui/transport.ts
 class SnapshotClient {
   transport;
@@ -1628,6 +1673,7 @@ class DashboardController {
   pendingHistory;
   historyAbort;
   historyBusy = false;
+  historyReason;
   historyStatus = "idle";
   refreshTimer;
   ageTimer;
@@ -1919,6 +1965,7 @@ class DashboardController {
   }
   cancelHistory() {
     this.historyGeneration++;
+    this.historyReason = undefined;
     this.pendingHistory = undefined;
     this.historyAbort?.abort();
   }
@@ -1972,10 +2019,10 @@ class DashboardController {
       }, signal);
       if (signal.aborted || task.generation !== this.historyGeneration)
         return;
-      if (!isHistoryResult(result) || result.data.series.some((series) => series.sessionId !== task.sessionId))
-        throw new Error("Invalid history response");
+      checkedHistory(result, task.sessionId);
       this.cache.set(task.key, {
         directory: task.state.port.location.directory,
+        loadedAt: this.now(),
         valid: true,
         result: structuredClone(result),
         from,
@@ -1987,12 +2034,16 @@ class DashboardController {
           this.cache.delete(oldest);
       }
       this.historyStatus = result.enabled ? "ready" : "disabled";
-    } catch {
-      if (task.generation === this.historyGeneration && !task.scope.aborted)
+    } catch (error) {
+      if (task.generation === this.historyGeneration && !task.scope.aborted) {
         this.historyStatus = "unavailable";
+        this.historyReason = historyFailure(error, signal).reason;
+      }
     } finally {
-      if (task.generation === this.historyGeneration && signal.aborted && !task.scope.aborted)
+      if (task.generation === this.historyGeneration && signal.aborted && !task.scope.aborted) {
         this.historyStatus = "unavailable";
+        this.historyReason = historyFailure(undefined, signal).reason;
+      }
       this.historyBusy = false;
       if (this.historyAbort === controller)
         this.historyAbort = undefined;
@@ -2077,12 +2128,13 @@ class DashboardController {
       ...selected ? { selected } : {},
       history: {
         status: this.historyStatus,
+        ...this.historyReason ? { reason: this.historyReason } : {},
         windowMs: this.windowMs,
         maxWindowMs: 604800000,
         maxPoints: 500,
         stale: this.historyStatus === "loading" || this.historyStatus === "unavailable" || !this.running,
         ...state.selected ? { sessionId: state.selected } : {},
-        ...cached ? { from: cached.from, to: cached.to } : {},
+        ...cached ? { from: cached.from, to: cached.to, loadedAt: cached.loadedAt } : {},
         ...projected ? { result: projected.result, summary: projected.summary } : {},
         notices: projected?.notices ?? [
           "bounded-retention",
@@ -2100,7 +2152,7 @@ class DashboardController {
   }
 }
 var init_controller = __esm(() => {
-  init_rpc();
+  init_historyclient();
   init_transport();
   init_inventory();
   init_models();
@@ -2272,13 +2324,12 @@ async function connectDashboard(options, discovery = Service) {
       async history(input, signal) {
         if (!isHistoryRead(input))
           throw new Error("History requires one session, at most seven days and 16\u2013500 points");
+        const requestSignal = deadline(signal);
         try {
-          const result = await client.rpc(historyRpc).read(input, { location, signal: deadline(signal) });
-          if (!isHistoryResult(result))
-            throw new Error;
-          return result;
-        } catch {
-          throw new Error("Context Guard history unavailable or incompatible in this location");
+          const result = await client.rpc(historyRpc).read(input, { location, signal: requestSignal });
+          return checkedHistory(result, input.sessionId);
+        } catch (error) {
+          throw historyFailure(error, requestSignal);
         }
       }
     };
@@ -2295,10 +2346,214 @@ async function connectDashboard(options, discovery = Service) {
   };
 }
 var init_connection = __esm(() => {
+  init_historyclient();
   init_rpc();
   init_port();
 });
 
+// src/tui/quantity.ts
+function tokens(value) {
+  if (value === undefined || !Number.isFinite(value))
+    return "?";
+  const magnitude = Math.abs(value);
+  if (magnitude >= 1e6)
+    return `${+(value / 1e6).toFixed(1)}M`;
+  if (magnitude >= 1000)
+    return `${+(value / 1000).toFixed(1)}K`;
+  return String(value);
+}
+
+// src/tui/statusformat.ts
+function freshnessLabel(row2) {
+  switch (row2?.freshness) {
+    case "fresh":
+      return;
+    case "stale":
+      return "Measurement out of date";
+    case "invalid":
+      return "Usage unavailable";
+    default:
+      return "Usage unknown";
+  }
+}
+function measurementLabel(row2, ageMs) {
+  const m = row2?.snapshot?.measurement;
+  if (!m || row2?.freshness === "missing")
+    return "Usage unknown";
+  if (row2?.freshness === "invalid")
+    return "Usage unavailable";
+  const age = ageMs === undefined ? "" : ` \xB7 measured ${Math.floor(Math.max(0, ageMs) / 1000)}s ago`;
+  return `${m.confidence === "reported" ? "Provider reported" : "Estimated"}${age}${row2?.freshness === "stale" ? " \xB7 out of date" : ""}`;
+}
+function measurementExplanation(row2) {
+  const m = row2.snapshot?.measurement;
+  if (!m || row2.freshness === "missing")
+    return ["No measurement available."];
+  if (row2.freshness === "invalid")
+    return ["Measurement cannot be used for this session."];
+  return [
+    m.scope === "completed-request" ? "Usage from the last completed request; not the next request's size." : "Usage for the prepared request; not a completed request.",
+    m.provenance === "serialized-estimate" ? "Estimate from serialized request content." : "Provider usage includes input and cache tokens."
+  ];
+}
+function compactionLabel(row2, compact = false) {
+  const phase = row2?.snapshot?.compaction.phase;
+  if (!phase || phase === "idle")
+    return;
+  if (compact)
+    return {
+      requesting: "Requesting",
+      accepted: "Waiting",
+      running: "Compacting",
+      "awaiting-measurement": "Checking",
+      blocked: "Retry held",
+      uncertain: "Unconfirmed"
+    }[phase];
+  return {
+    requesting: "Requesting compaction",
+    accepted: "Compaction request accepted \xB7 waiting to start",
+    running: "Compaction running",
+    "awaiting-measurement": "Compaction ended \xB7 checking context reduction",
+    blocked: "Automatic compaction retry suppressed",
+    uncertain: "Completion unconfirmed \xB7 automatic retry suppressed"
+  }[phase];
+}
+function reasonExplanation(reason) {
+  switch (reason) {
+    case "below-threshold":
+      return "Context is below the policy threshold.";
+    case "threshold-crossed":
+      return "Context reached the policy threshold; this does not guarantee compaction.";
+    case "missing-usage":
+      return "No measurement available for the policy decision.";
+    case "model-changed":
+      return "The measurement belongs to a different model.";
+    case "invalid-usage":
+      return "The measurement cannot be used for the policy decision.";
+    case "stale-usage":
+      return "The policy measurement is out of date.";
+    case "missing-model-budget":
+      return "Model capacity is unavailable for this threshold.";
+    case "incompatible-model-budget":
+      return "The threshold is incompatible with model capacity.";
+    case "compaction-failed":
+      return "Compaction failed; automatic retries are limited after repeated failures.";
+    case "reclaim-unverifiable":
+      return "Context reduction could not be verified with comparable provider readings.";
+    case "insufficient-reclaim":
+      return "Measured context reduction was below the required minimum.";
+    case "admission-outcome-unknown":
+      return "Whether the compaction request was accepted is unconfirmed.";
+    case "completion-event-timeout":
+      return "No confirming completion event arrived within the waiting period.";
+    case "restart-needs-lifecycle-evidence":
+      return "The previous request needs confirming lifecycle evidence after restart.";
+    case "event-stream-gap":
+      return "Automatic requests are suspended after an event gap; reload required.";
+    case "persistence-unavailable":
+      return "Safety storage is unavailable; repair storage and reload.";
+    case "capacity-exceeded":
+      return "Monitoring limit reached; some sessions are unavailable.";
+    case "model-metadata-unavailable":
+      return "Some model limits are unavailable.";
+    default:
+      return "See diagnostic codes.";
+  }
+}
+function pressureLabel(row2) {
+  if (row2?.freshness !== "fresh")
+    return "Threshold pressure unknown";
+  switch (row2.pressure) {
+    case "crossed":
+      return "Threshold reached";
+    case "near":
+      return "Near threshold";
+    case "normal":
+      return "Below threshold";
+    default:
+      return "Threshold pressure unknown";
+  }
+}
+function thresholdDistance(row2, compact = false) {
+  const delta = row2?.triggerDeltaTokens;
+  if (row2?.freshness !== "fresh" || row2.pressure === "unknown" || delta === undefined || !Number.isFinite(delta))
+    return "pressure unknown";
+  if (delta === 0)
+    return row2.pressure === "crossed" ? "Threshold reached" : "At threshold \xB7 requires more";
+  if (compact)
+    return `${tokens(Math.abs(delta))} ${delta < 0 ? "over" : "below"}${row2.pressure === "near" ? " \xB7 Near threshold" : delta < 0 ? " \xB7 Threshold reached" : ""}`;
+  return `${tokens(Math.abs(delta))} ${Math.abs(delta) === 1 ? "token" : "tokens"} ${delta < 0 ? "over" : "below"} threshold`;
+}
+function guardStatusLines(health, compact = false) {
+  switch (health?.enforcement) {
+    case "observing":
+      return compact ? ["Observing", "No Guard compact"] : ["Observing \xB7 Guard won't request compaction"];
+    case "available":
+      return compact ? ["Guard requests", "enabled"] : ["Guard automatic requests enabled"];
+    case "disabled":
+      return ["Guard disabled"];
+    case "suspended": {
+      const gap = health.reasons.includes("event-stream-gap");
+      const storage = health.reasons.includes("persistence-unavailable");
+      return compact ? [
+        "Guard suspended",
+        ...storage ? ["Storage: repair"] : [],
+        ...gap ? ["Reload required"] : storage ? ["Then reload"] : ["See Details"]
+      ] : [
+        "Guard suspended" + (storage ? " \xB7 safety storage unavailable; repair storage and reload" : "") + (gap ? " \xB7 reload required" : storage ? "" : " \xB7 see Details")
+      ];
+    }
+    default:
+      return ["Guard status unknown"];
+  }
+}
+function panelStatus(health) {
+  return guardStatusLines(health).join(" \xB7 ");
+}
+function connectionLabel(connection, compact = false) {
+  switch (connection) {
+    case "loading":
+      return "Connecting";
+    case "live":
+      return "Live";
+    case "reconnecting":
+      return "Reconnecting";
+    case "unavailable":
+      return compact ? "Unavailable" : "Connection unavailable";
+    case "incompatible":
+      return compact ? "Unsupported" : "Monitoring unsupported";
+  }
+}
+function connectionNotice(connection, retainedMeasurements, compact = false) {
+  if (connection === "live")
+    return;
+  return retainedMeasurements ? compact ? "Last data shown" : "Showing last received measurements" : compact ? "No measurements" : "No measurements available";
+}
+function monitorStatusLines(connection, health, retainedMeasurements, compact = false) {
+  const notice = connectionNotice(connection, retainedMeasurements, compact);
+  const reasons = health?.reasons ?? [];
+  const limited = reasons.includes("capacity-exceeded");
+  const model = reasons.includes("model-metadata-unavailable");
+  const attention = health?.enforcement !== "suspended" && reasons.length > 0;
+  return [
+    ...health && connection !== "live" ? [compact ? "Last known:" : "Last known Guard:"] : [],
+    ...guardStatusLines(health, compact),
+    ...attention ? compact ? [limited ? "Monitor limit" : model ? "Limits unknown" : "See Details"] : [
+      ...limited ? ["Monitoring limit reached \xB7 some sessions unavailable"] : [],
+      ...model ? ["Some model limits unavailable \xB7 context may be unknown"] : [],
+      ...!limited && !model ? ["Guard needs attention \xB7 see Details"] : []
+    ] : [],
+    ...notice ? [notice] : []
+  ];
+}
+var contextHistoryLegend;
+var init_statusformat = __esm(() => {
+  contextHistoryLegend = [
+    "Recent samples \u2192 now \xB7 \u2504 threshold",
+    "Dim = last known context"
+  ];
+});
+
 // src/tui/format.ts
 function quantity(n) {
   return n === undefined || !Number.isFinite(n) ? "?" : Math.abs(n) >= 1e6 ? `${(n / 1e6).toFixed(1)}m` : Math.abs(n) >= 1000 ? `${(n / 1000).toFixed(1)}k` : String(n);
@@ -2326,22 +2581,6 @@ function clip(value, width) {
   }
   return width < 3 ? ".".repeat(Math.max(0, width)) : result + "...";
 }
-function rowLines(row2, width) {
-  const s = row2.snapshot, m = s?.measurement;
-  const prefix = row2.current ? "* " : row2.depth > 5 ? ".../" : " ".repeat(Math.min(row2.depth, 5)) + "|-";
-  const percent = row2.utilizationPercent === undefined ? "?" : `${row2.utilizationPercent.toFixed(1)}%`;
-  const warning = row2.freshness === "stale" ? " STALE" : row2.pressure === "crossed" ? " !! crossed" : row2.pressure === "near" ? " ! near" : "";
-  const suffix = ` ${statuses[row2.node.status]} ${m?.confidence === "approximate" ? "~" : ""}${percent}${warning}`;
-  const label = clip(`${prefix}${row2.node.agent ?? row2.node.sessionId}`, Math.max(1, width - cells(suffix)));
-  return [
-    clip(`${label}${suffix}`, width),
-    ...performanceLines(row2, width),
-    ...wrap(`${quantity(m?.tokens)}/${quantity(s?.capacityTokens)} input; to ${quantity(row2.triggerDeltaTokens)}`, width),
-    ...s && s.compaction.phase !== "idle" ? wrap(`compact: ${s.compaction.phase}`, width) : [],
-    ...row2.node.interrupted ? [clip("interrupted", width)] : [],
-    ...row2.hidden ? wrap(`+ ${row2.hidden} completed descendants`, width) : []
-  ];
-}
 function detailLines(row2, width, expanded = false, ageMs = 0) {
   const s = row2?.snapshot, m = s?.measurement;
   if (!row2)
@@ -2352,22 +2591,29 @@ function detailLines(row2, width, expanded = false, ageMs = 0) {
       ...wrap("Guard: not monitored / unavailable", width)
     ];
   const threshold = s.policy.configured;
-  const headroom = row2.triggerDeltaTokens;
+  const valid2 = row2.freshness === "fresh" || row2.freshness === "stale";
   const lines = [
     `${s.agent ?? "?"} / ${s.model ?? "?"}`,
+    `${row2.freshness === "stale" ? "Last measured" : "Context"} ${valid2 && m?.confidence === "approximate" ? "~" : ""}${quantity(valid2 ? m?.tokens : undefined)} / ${quantity(s.capacityTokens)} input`,
+    `${valid2 ? row2.utilizationPercent?.toFixed(1) ?? "?" : "?"}% capacity \xB7 ${pressureLabel(row2)}`,
+    `Threshold ${quantity(s.policy.triggerTokens)} \xB7 ${thresholdDistance(row2)}`,
+    measurementLabel(row2, ageMs),
+    ...measurementExplanation(row2),
+    compactionLabel(row2) ?? "No compaction request in progress.",
+    ...s.compaction.blockedReason ? [reasonExplanation(s.compaction.blockedReason)] : [],
+    `Recorded policy decision: ${reasonExplanation(s.policy.reason)}`,
     ...performanceLines(row2, width),
-    `${m?.confidence === "approximate" ? "~" : ""}${quantity(m?.tokens)} / ${quantity(s.capacityTokens)} input`,
-    `${row2.utilizationPercent?.toFixed(1) ?? "?"}% ${row2.pressure === "crossed" ? "!! crossed" : row2.pressure === "near" ? "! near" : row2.freshness.toUpperCase()}`,
-    `Trigger ${threshold.type === "ratio" ? `${threshold.value * 100}%` : `${threshold.value} ${threshold.type}`} (${s.policy.comparison})`,
-    `Resolved trigger ${s.policy.triggerTokens ?? "?"}`,
-    `Until trigger ${quantity(headroom)}`,
-    `Compact: ${s.compaction.phase}`,
-    `${s.compaction.armed ? "armed" : "disarmed"}${s.compaction.blockedReason ? ` / ${s.compaction.blockedReason}` : ""}`,
-    m ? `${m.confidence} ${m.scope}` : "measurement unknown",
-    m ? `${Math.floor(Math.max(0, ageMs) / 1000)}s ago; ${row2.freshness}` : ""
+    ...s.performance ? [
+      "TPS: tokens per second. TTFT: time to first output (text or reasoning); approximate.",
+      "Live TPS is estimated; completed rates use provider output including reasoning and matched timing.",
+      "Model average uses matched request durations; session average includes idle and tool time.",
+      ...s.performance.partial ? [
+        "Incomplete timing coverage for model averages; only matched observed durations are included."
+      ] : []
+    ] : []
   ];
   if (expanded)
-    lines.push(`Policy ${s.policy.id}: ${s.policy.reason}`, `Limits in/context/out ${quantity(s.limits?.input)}/${quantity(s.limits?.context)}/${quantity(s.limits?.output)}`, `Output reserve ${quantity(s.outputReserveTokens)}`, `Provenance ${m?.provenance ?? "?"}`, `Cooldown until ${s.compaction.cooldownUntil ?? "?"}`, `Cumulative (${s.cumulativeScope})`, `Input ${quantity(s.cumulative?.input)} output ${quantity(s.cumulative?.output)}`, `Reasoning ${quantity(s.cumulative?.reasoning)}`, `Cache read ${quantity(s.cumulative?.cache.read)} write ${quantity(s.cumulative?.cache.write)}`);
+    lines.push("Diagnostic codes and accounting:", `Compaction phase: ${s.compaction.phase}`, `Armed: ${s.compaction.armed} (one eligibility condition, not permission to compact)`, `Blocked reason: ${s.compaction.blockedReason ?? "?"}`, `Measurement confidence: ${m?.confidence ?? "?"}`, `Measurement scope: ${m?.scope ?? "?"}`, `Measurement freshness: ${row2.freshness}`, `Trigger ${threshold.type === "ratio" ? `${threshold.value * 100}%` : `${threshold.value} ${threshold.type}`} (${s.policy.comparison})`, `Resolved trigger ${s.policy.triggerTokens ?? "?"}`, `Policy ${s.policy.id}: ${s.policy.reason}`, `Pressure code: ${row2.pressure}`, `Recorded tokens: ${quantity(m?.tokens)}`, `Limits in/context/out ${quantity(s.limits?.input)}/${quantity(s.limits?.context)}/${quantity(s.limits?.output)}`, `Output reserve ${quantity(s.outputReserveTokens)}`, `Provenance ${m?.provenance ?? "?"}`, `Cooldown until ${s.compaction.cooldownUntil ?? "?"}`, `Cumulative (${s.cumulativeScope})`, `Input ${quantity(s.cumulative?.input)} output ${quantity(s.cumulative?.output)}`, `Reasoning ${quantity(s.cumulative?.reasoning)}`, `Cache read ${quantity(s.cumulative?.cache.read)} write ${quantity(s.cumulative?.cache.write)}`);
   return lines.filter(Boolean).flatMap((line) => wrap(line, width));
 }
 function sanitize(value) {
@@ -2404,16 +2650,10 @@ function performanceLines(row2, width) {
     ...wrap(`TTFT ${p.ttftMs === undefined ? "?" : `~${(p.ttftMs / 1000).toFixed(2)}s`}${p.latestRequestTps === undefined ? "" : ` \xB7 Last ${value(p.latestRequestTps)} t/s`}`, width)
   ];
 }
-var segmenter, statuses;
+var segmenter;
 var init_format = __esm(() => {
+  init_statusformat();
   segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
-  statuses = {
-    running: "RUN",
-    idle: "IDLE",
-    completed: "DONE",
-    failed: "FAIL",
-    unknown: "?"
-  };
 });
 
 // src/tui/chartformat.ts
@@ -2627,11 +2867,157 @@ var init_modelview = __esm(() => {
   ];
 });
 
+// src/tui/panelformat.ts
+function panelSummary(row2, width, age, compact = false) {
+  if (!row2)
+    return [clip("No sessions available \xB7 r refresh", width)];
+  const snapshot = row2.snapshot;
+  const valid2 = row2.freshness === "fresh" || row2.freshness === "stale";
+  const prefix = row2.freshness === "stale" ? "Last measured" : "Context";
+  const percent = `${row2.utilizationPercent === undefined ? "?" : Math.round(row2.utilizationPercent)}%`;
+  const estimate = valid2 && snapshot?.measurement?.confidence === "approximate" ? "~" : "";
+  const identity = `${width < 28 ? ">" : "Selected:"} ${row2.node.agent ?? row2.node.sessionId}${row2.current ? width < 28 ? " *" : " (current)" : ""}`;
+  const threshold = `Threshold ${tokens(snapshot?.policy.triggerTokens)} \xB7 ${thresholdDistance(row2)}`;
+  const occupancy = compact ? `${prefix} ${estimate}${percent}` : `${prefix} ${estimate}${tokens(valid2 ? snapshot?.measurement?.tokens : undefined)}/${tokens(snapshot?.capacityTokens)} \xB7 ${percent}`;
+  return [
+    clip(identity, width),
+    clip(occupancy, width),
+    ...!compact ? [
+      clip(cells(threshold) <= width ? threshold : thresholdDistance(row2), width),
+      clip(`${row2.node.model ?? snapshot?.model ?? "Model unknown"} \xB7 ${panelStatuses[row2.node.status]}`, width),
+      ...wrap(measurementLabel(row2, age), width)
+    ] : []
+  ];
+}
+function tableLine(identity, status, context, threshold, width) {
+  const pad = (value, size) => {
+    const text2 = clip(value, size);
+    return text2 + " ".repeat(Math.max(0, size - cells(text2)));
+  };
+  return `${pad(identity, width - 47)} ${pad(status, 8)} ${pad(context, 7)} ${pad(threshold, 29)}`;
+}
+function panelRowHeading(label, width) {
+  return width >= 72 ? tableLine(label, "State", "Context", "Threshold", width) : clip(label, width);
+}
+function panelRowLines(row2, width, selected) {
+  const marker = `${selected ? ">" : " "}${row2.current ? "*" : " "}`;
+  const indent = " ".repeat(Math.min(row2.depth, Math.floor(width / 24))) + (row2.depth ? "\u2514 " : "");
+  const identity = `${marker} ${indent}${row2.node.agent ?? row2.node.sessionId}`;
+  const percent = `${(row2.freshness === "fresh" || row2.freshness === "stale") && row2.snapshot?.measurement?.confidence === "approximate" ? "~" : ""}${row2.utilizationPercent === undefined ? "?" : Math.round(row2.utilizationPercent)}%`;
+  const status = width < 28 ? {
+    running: "RUN",
+    idle: "IDLE",
+    completed: "DONE",
+    failed: "FAIL",
+    unknown: "?"
+  }[row2.node.status] : panelStatuses[row2.node.status];
+  const distance = thresholdDistance(row2, true);
+  const pad = (value, size) => {
+    const text2 = clip(value, size);
+    return text2 + " ".repeat(Math.max(0, size - cells(text2)));
+  };
+  const lines = width >= 72 ? [tableLine(identity, status, percent, distance, width)] : [
+    `${pad(identity, Math.max(1, width - status.length - 1))} ${status}`,
+    clip(`${percent} context \xB7 ${distance}`, width)
+  ];
+  const exception = [
+    freshnessLabel(row2),
+    compactionLabel(row2),
+    row2.node.interrupted ? "interrupted" : "",
+    row2.hidden ? `+${row2.hidden} hidden \xB7 Space expands` : ""
+  ].filter(Boolean).join(" \xB7 ");
+  if (exception)
+    lines.push(...wrap(exception, width));
+  return lines.map((line) => clip(line, width));
+}
+var panelStatuses;
+var init_panelformat = __esm(() => {
+  init_format();
+  init_statusformat();
+  init_statusformat();
+  panelStatuses = {
+    running: "RUNNING",
+    idle: "IDLE",
+    completed: "DONE",
+    failed: "FAILED",
+    unknown: "UNKNOWN"
+  };
+});
+
 // src/dashboard/terminalview.ts
-function overviewRow(row2) {
+function diagnosticRow(row2) {
   const s = row2.snapshot;
   const valid2 = row2.freshness === "fresh" || row2.freshness === "stale";
-  return `${" ".repeat(Math.min(row2.depth, 12))}${row2.depth ? "\u2514 " : ""}${row2.node.agent ?? "unknown agent"} / ${row2.node.model ?? "unknown model"} [${row2.node.sessionId}] ${row2.node.status} | prompt ${quantity(valid2 ? s?.measurement?.tokens : undefined)}/${quantity(s?.capacityTokens)} | occupancy ${row2.utilizationPercent?.toFixed(1) ?? "?"}% | trigger ${quantity(s?.policy.triggerTokens)} headroom ${quantity(row2.triggerDeltaTokens)} | pressure ${row2.pressure} | compact ${s?.compaction.phase ?? "unavailable"} | performance ${s?.performance?.status ?? "unavailable"} | live TPS ${quantity(row2.performanceAvailable && row2.performanceFreshness !== "invalid" ? s?.performance?.liveTps : undefined)} | age ${row2.measurementAgeMs === undefined ? "unknown" : `${Math.floor(row2.measurementAgeMs / 1000)}s`} | inventory ${row2.inventoryStale ? "stale" : "fresh"}, live ${row2.liveStale ? "stale" : "fresh"}, usage ${row2.freshness}, performance ${row2.performanceFreshness}${s?.measurement?.confidence === "approximate" ? " estimated" : ""}${s?.performance?.tokenSource === "estimated" ? " estimated TPS" : ""}${s?.performance?.partial ? " partial" : ""}${row2.hidden ? ` | ${row2.hidden} hidden descendants` : ""}`;
+  return `${" ".repeat(Math.min(row2.depth, 12))}${row2.depth ? "\u2514 " : ""}${row2.node.agent ?? "unknown agent"} / ${row2.node.model ?? "unknown model"} [${row2.node.sessionId}] ${row2.node.status} | ${row2.freshness === "stale" ? "Last measured" : "Context"} ${quantity(valid2 ? s?.measurement?.tokens : undefined)}/${quantity(s?.capacityTokens)} | occupancy ${row2.utilizationPercent?.toFixed(1) ?? "?"}% | threshold ${quantity(s?.policy.triggerTokens)} \xB7 ${thresholdDistance(row2)} | ${pressureLabel(row2)} | compact ${s?.compaction.phase ?? "unavailable"} | performance ${s?.performance?.status ?? "unavailable"} | live TPS ${quantity(row2.performanceAvailable && row2.performanceFreshness !== "invalid" ? s?.performance?.liveTps : undefined)} | age ${row2.measurementAgeMs === undefined ? "unknown" : `${Math.floor(row2.measurementAgeMs / 1000)}s`} | inventory ${row2.inventoryStale ? "stale" : "fresh"}, live ${row2.liveStale ? "stale" : "fresh"}, usage ${row2.freshness}, performance ${row2.performanceFreshness}${s?.measurement?.confidence === "approximate" ? " estimated" : ""}${s?.performance?.tokenSource === "estimated" ? " estimated TPS" : ""}${s?.performance?.partial ? " partial" : ""}${row2.hidden ? ` | ${row2.hidden} hidden descendants` : ""}`;
+}
+function pad(value, width) {
+  const text2 = clip(value, width);
+  return text2 + " ".repeat(Math.max(0, width - cells(text2)));
+}
+function overviewColumns(identity, state, context, threshold, width) {
+  return `${pad(identity, width - 44)} ${pad(state, 7)} ${pad(context, 7)} ${pad(threshold, 27)}`;
+}
+function overviewHeading(width) {
+  return width >= 72 ? [overviewColumns("Agent / model", "State", "Context", "Threshold", width)] : [];
+}
+function overviewLabels(rows) {
+  const segmenter2 = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+  const suffixes = rows.map((row2) => [...segmenter2.segment(clip(row2.node.sessionId, 4096))].slice(-8).map((part) => part.segment).join(""));
+  const counts = new Map;
+  for (const suffix of suffixes)
+    counts.set(suffix, (counts.get(suffix) ?? 0) + 1);
+  return suffixes.map((suffix, index) => counts.get(suffix) === 1 ? suffix : `#${index + 1}`);
+}
+function overviewRowLines(row2, width, selected, label, position, maxLines = 3) {
+  const valid2 = row2.freshness === "fresh" || row2.freshness === "stale";
+  const percent = `${valid2 && row2.snapshot?.measurement?.confidence === "approximate" ? "~" : ""}${valid2 && row2.utilizationPercent !== undefined ? Math.round(row2.utilizationPercent) : "?"}%`;
+  const context = `${row2.freshness === "stale" ? "Last measured " : ""}${percent}`;
+  const distance = thresholdDistance(row2, true);
+  const threshold = (distance === "At threshold \xB7 requires more" ? "At threshold; requires more" : distance).replace(" \xB7 Threshold reached", " \xB7 reached");
+  const state = width < 28 ? {
+    running: "RUN",
+    idle: "IDLE",
+    completed: "DONE",
+    failed: "FAIL",
+    unknown: "?"
+  }[row2.node.status] : panelStatuses[row2.node.status];
+  const identityWidth = width >= 72 ? width - 44 : Math.max(1, width - cells(state) - 1);
+  const marker = selected ? "> " : "  ";
+  const tag = width >= 100 ? ` [${label}]` : ` #${position + 1}`;
+  const indent = row2.depth && identityWidth >= 22 ? `${" ".repeat(Math.min(row2.depth, Math.max(0, Math.floor(identityWidth / 8) - 1)))}\u2514 ` : "";
+  const name = `${row2.node.agent ?? "unknown agent"}${width >= 40 ? ` / ${row2.node.model ?? "unknown model"}` : ""}`;
+  const identity = marker + indent + clip(name, Math.max(1, identityWidth - cells(marker + indent + tag))) + tag;
+  const metric2 = `${context} context \xB7 ${threshold}`;
+  const shortThreshold = threshold.replace("pressure unknown", "?").replace("At threshold; requires more", "At; needs more").replace(" \xB7 Near threshold", " near").replace(" \xB7 reached", " reached").replace("Threshold reached", "Reached");
+  const shortMetric = `${context} \xB7 T ${shortThreshold}`;
+  const pressure = row2.freshness !== "fresh" || row2.pressure === "unknown" ? "Threshold ?" : row2.pressure === "crossed" ? "Reached" : row2.triggerDeltaTokens === 0 ? "At; needs more" : row2.pressure === "near" ? "Near threshold" : "Below threshold";
+  const metrics = [metric2, shortMetric, `${context} \xB7 ${pressure}`];
+  const fittedMetric = metrics.find((line) => cells(line) <= width);
+  const lines = width >= 72 ? [
+    overviewColumns(identity, state, row2.freshness === "stale" ? "Last" : percent, threshold, width)
+  ] : [`${pad(identity, identityWidth)} ${state}`, fittedMetric ?? context];
+  const lifecycle = compactionLabel(row2);
+  const exceptions = [
+    ...width >= 72 && row2.freshness === "stale" ? [context] : [],
+    ...width < 72 && !fittedMetric ? [pressure] : [],
+    ...row2.node.status === "failed" ? ["Agent failed"] : [],
+    ...row2.node.interrupted ? ["Interrupted"] : [],
+    ...lifecycle ? [cells(lifecycle) <= width - 6 ? lifecycle : compactionLabel(row2, true)] : [],
+    ...row2.freshness !== "fresh" ? [freshnessLabel(row2)] : [],
+    ...row2.inventoryStale ? ["Inventory stale"] : [],
+    ...row2.liveStale ? ["Live data stale"] : [],
+    ...row2.hidden ? [`${row2.hidden} hidden descendants`] : []
+  ].filter((value) => value !== undefined);
+  if (exceptions.length) {
+    let shown = 1;
+    let text2 = exceptions[0] ?? "";
+    while (shown < exceptions.length && cells(text2 + " \xB7 " + exceptions[shown]) <= width - 6) {
+      text2 += " \xB7 " + exceptions[shown++];
+    }
+    const more = shown < exceptions.length ? ` +${exceptions.length - shown}` : "";
+    lines.push(clip(text2, Math.max(0, width - cells(more))) + more);
+  }
+  return lines.slice(0, Math.max(1, maxLines)).map((line) => clip(line, width));
 }
 function pathValue(object2, path) {
   let value = object2;
@@ -2646,8 +3032,11 @@ function terminalDetail(row2) {
   if (!row2)
     return ["No selected session; choose one in overview."];
   return [
-    overviewRow(row2),
     `Session ID: ${row2.node.sessionId}`,
+    ...detailLines(row2, 4096, false, row2.measurementAgeMs),
+    ...row2.node.interrupted ? ["Agent execution interrupted"] : [],
+    "Diagnostic codes and accounting:",
+    diagnosticRow(row2),
     `Parent ID: ${row2.node.parentId ?? "unknown/unavailable"}`,
     "All snapshot fields (timestamps are Unix milliseconds):",
     ...snapshotFields.map((path) => `${path}: ${scalar(pathValue(row2.snapshot, path))}`),
@@ -2656,6 +3045,8 @@ function terminalDetail(row2) {
 }
 function historyObservations(view, metricIndex) {
   const metric2 = chartMetrics[metricIndex] ?? chartMetrics[0];
+  if (!view.history.result?.enabled)
+    return [];
   return view.history.result?.data.series.flatMap((series) => metric2.source === "points" ? series.points.map((point) => ({
     time: point.time,
     value: point[metric2.key],
@@ -2684,14 +3075,15 @@ function terminalHistory(view, width, metricIndex, sample) {
   ];
   const selected = observations[Math.min(sample, Math.max(0, observations.length - 1))];
   return [
-    `History: ${h.status}${h.stale ? " \xB7 stale cached results" : ""} \xB7 ${h.windowMs / 60000} minutes \xB7 ${metric2.label} (${metric2.unit})`,
+    `History: ${h.status} \xB7 ${h.windowMs / 60000} minutes \xB7 ${metric2.label} (${metric2.unit})`,
+    ...historyStatusLines(h),
     "Left/Right metric \xB7 w window \xB7 [/] exact sample/request \xB7 Up/Down scroll",
     "Retention bounded to seven days; maximum 500 points and 500 requests per session.",
     ...h.notices,
-    ...h.summary ? [
+    ...h.result?.enabled && h.summary ? [
       `Matched requests ${h.summary.matchedRequests}/${h.summary.observedRequests}; output ${scalar(h.summary.outputTokens)}; duration ms ${scalar(h.summary.durationMs)}; average model TPS ${scalar(h.summary.averageModelTps)}${h.summary.partial ? " \xB7 partial" : ""}`
     ] : [],
-    ...h.from === undefined || h.to === undefined ? [] : [
+    ...!h.result?.enabled || h.from === undefined || h.to === undefined ? [] : [
       `${new Date(h.from).toISOString()} \u2192 ${new Date(h.to).toISOString()}`,
       ...metricPlot(observations.map((p) => ({
         time: p.time,
@@ -2703,9 +3095,9 @@ function terminalHistory(view, width, metricIndex, sample) {
       `Exact ${metric2.source === "points" ? "sample" : "request"} ${Math.min(sample + 1, observations.length)}/${observations.length}:`,
       ...Object.entries(selected.details).map(([key, value]) => `${key}: ${scalar(value)}`),
       `Selected ${metric2.label}: ${scalar(selected.value)} ${metric2.unit}`
-    ] : [
+    ] : h.status === "ready" && h.result?.enabled ? [
       "No retained measurements for this metric; values unknown/unavailable."
-    ]
+    ] : []
   ];
 }
 function wrapped(lines, width) {
@@ -2715,17 +3107,33 @@ function wrapped(lines, width) {
     return cells(clean) <= available ? [clean] : wrap(clean, available);
   });
 }
-function headerLines(view, width) {
+function headerLines(view, width, height = 24) {
+  const compact = width < 28;
+  const small = height < 18;
+  if (width < 16 || height < 8)
+    return [
+      clip(connectionLabel(view.connection, true), width),
+      clip(panelStatus(view.health), width),
+      clip(`Location: ${view.location}`, width)
+    ];
   return [
-    clip(`Context Guard \xB7 ${view.screen} \xB7 ${view.connection} \xB7 enforcement ${view.health?.enforcement ?? "unknown"}`, width),
-    clip(`Known ${view.inventory.total} \xB7 monitored ${view.inventory.monitored} \xB7 active ${view.inventory.active} \xB7 inventory ${view.inventory.stale ? "stale" : "fresh"}${view.inventory.complete ? "" : " / partial"}`, width),
-    clip(`Location: ${view.location}`, width)
+    clip(`${connectionLabel(view.connection, compact)} \xB7 ${compact ? width >= 20 ? "Context Guard" : "Guard" : `Context Guard \xB7 ${view.screen}`}`, width),
+    ...monitorStatusLines(view.connection, view.health, view.rows.some((row2) => row2.snapshot?.measurement !== undefined), compact).flatMap((line) => wrap(line, width)),
+    ...small ? [
+      clip(`Selected: ${view.selected?.node.agent ?? view.selectedSessionId ?? "none"}`, width)
+    ] : [
+      clip(`Known ${view.inventory.total} \xB7 monitored ${view.inventory.monitored} \xB7 active ${view.inventory.active} \xB7 inventory ${view.inventory.stale ? "stale" : "fresh"}${view.inventory.complete ? "" : " / partial"}`, width),
+      clip(`Location: ${view.location}`, width)
+    ]
   ];
 }
 var snapshotFields, scalar = (value) => value === undefined || value === null ? "unknown/unavailable" : typeof value === "number" && !Number.isFinite(value) ? "invalid" : String(value), terminalHelp;
 var init_terminalview = __esm(() => {
+  init_historyclient();
   init_chartformat();
   init_format();
+  init_statusformat();
+  init_panelformat();
   snapshotFields = [
     "sessionId",
     "parentId",
@@ -2798,6 +3206,9 @@ var init_terminalview = __esm(() => {
     "Models charts: Left/Right metric \xB7 w window \xB7 [/] bucket \xB7 d request details",
     "Models list/request details: n/p pages \xB7 f exact agent filter \xB7 r refresh",
     "Up/Down or j/k: select session in overview; scroll other screens",
+    "Overview: compact columns/cards; Enter or 2 for full identity and diagnostics",
+    "Overview PageUp/PageDown selects by visible rows; #N identifies a row in narrow layouts",
+    "Overview T means threshold; +N means more diagnostics in Details",
     "PageUp/PageDown: move by a page \xB7 Home/End: first/last",
     "Left/Right: history metric (six metrics) \xB7 w: cycle 5m/1h/24h/7d",
     "[ / ]: previous/next exact history sample or request",
@@ -2836,6 +3247,8 @@ class TerminalShell {
   input = "";
   notice = "";
   rowOffset = 0;
+  overviewScope = "";
+  overviewPage = 1;
   historyIdentity = "";
   constructor(controller, quit) {
     this.controller = controller;
@@ -3024,7 +3437,7 @@ class TerminalShell {
     const delta = name === "down" || name === "j" ? 1 : name === "up" || name === "k" ? -1 : name === "pagedown" ? page : name === "pageup" ? -page : 0;
     if (view.screen === "overview" && !this.help) {
       const index = view.rows.findIndex((row3) => row3.node.sessionId === view.selectedSessionId);
-      const next = name === "home" ? 0 : name === "end" ? view.rows.length - 1 : Math.max(0, Math.min(view.rows.length - 1, index + delta));
+      const next = name === "home" ? 0 : name === "end" ? view.rows.length - 1 : Math.max(0, Math.min(view.rows.length - 1, index + (name === "pagedown" ? this.overviewPage : name === "pageup" ? -this.overviewPage : delta)));
       const row2 = view.rows[next];
       if (row2 && (delta || name === "home" || name === "end"))
         this.controller.selectSession(row2.node.sessionId);
@@ -3055,18 +3468,24 @@ class TerminalShell {
       this.scroll = 0;
       this.historyIdentity = identity;
     }
-    const footer = this.editor ? `${this.editor}> ${this.input} [Enter apply; Esc cancel${this.editor === "location" ? "; Tab remembered" : ""}]` : "? help q quit \xB7 1 overview 2 detail 3 history 4 models \xB7 / search f filters l location r refresh";
+    const footer = this.editor ? `${this.editor}> ${this.input} [Enter apply; Esc cancel${this.editor === "location" ? "; Tab remembered" : ""}]` : view.screen === "overview" && !this.help ? width < 40 ? width >= 22 ? "2 detail ? help q quit" : "2 detail ? q quit" : width < 72 ? "2 detail \xB7 q quit \xB7 ? help \xB7 \u2191\u2193 select" : "Enter detail \xB7 q quit \xB7 ? help \xB7 \u2191\u2193 select \xB7 3 history 4 models / search f filters l location r refresh" : width < 40 ? "? help q quit" : "? help q quit \xB7 1 overview 2 detail 3 history 4 models \xB7 / search f filters l location r refresh";
     if (height < 5)
       return [
         clip("Context Guard \xB7 ? help \xB7 q quit", width),
         ...wrapped([footer], width)
       ].slice(0, height).join("\n");
-    const header = headerLines(view, width);
-    const available = height - header.length - 1;
+    const header = headerLines(view, width, height);
+    if (view.screen === "overview" && !this.help) {
+      while (header.length > height - 2 && /^(Known |Location: |Selected: )/.test(header.at(-1) ?? ""))
+        header.pop();
+      header.splice(Math.max(0, height - 2));
+    }
+    const available = Math.max(0, height - header.length - 1);
     const notices = [
+      ...view.screen === "overview" && view.selectedSessionId && !view.rows.some((row2) => row2.node.sessionId === view.selectedSessionId) ? ["Selection hidden by filters \xB7 \u2191\u2193 selects a visible session"] : [],
       ...view.notices,
       ...view.inventory.notices,
-      ...view.health?.reasons ?? [],
+      ...view.screen === "detail" ? view.health?.reasons.map((reason) => `Health reason code: ${reason}`) ?? [] : [],
       ...this.notice ? [this.notice] : [],
       ...view.screen !== "models" && Object.values(view.filters).some(Boolean) ? [
         `Filters: search=${view.filters.search} agent=${view.filters.agent} model=${view.filters.model}`
@@ -3076,23 +3495,38 @@ class TerminalShell {
     if (this.help)
       body = wrapped(terminalHelp, width);
     else if (view.screen === "overview") {
-      const rows = view.rows.map((row2) => wrapped([
-        `${row2.node.sessionId === view.selectedSessionId ? "> " : "  "}${overviewRow(row2)}`
-      ], width));
+      const scope = JSON.stringify([view.location, view.filters]);
+      if (scope !== this.overviewScope) {
+        this.rowOffset = 0;
+        this.overviewScope = scope;
+      }
+      const heading = available >= 4 ? overviewHeading(width) : [];
+      const noticeBudget = Math.min(notices.length, Math.floor((available - heading.length) / 4));
+      const status = notices.slice(0, noticeBudget).map((notice, index) => clip(index === noticeBudget - 1 && notices.length > noticeBudget ? `${notices.length} notices \xB7 see Details` : notice, width));
+      const budget = Math.max(1, available - heading.length - status.length);
+      const labels = overviewLabels(view.rows);
+      const rows = view.rows.map((row2, index) => overviewRowLines(row2, width, row2.node.sessionId === view.selectedSessionId, labels[index] ?? `#${index + 1}`, index, budget));
       const selected = view.rows.findIndex((row2) => row2.node.sessionId === view.selectedSessionId);
       const start = rows.slice(0, Math.max(0, selected)).reduce((n, row2) => n + row2.length, 0);
       const end = start + (rows[selected]?.length ?? 0);
-      const status = wrapped(notices, width);
-      const budget = Math.max(1, available - Math.min(status.length, Math.floor(available / 3)));
       if (start < this.rowOffset)
         this.rowOffset = start;
       if (end > this.rowOffset + budget)
         this.rowOffset = Math.max(start, end - budget);
       const flat = rows.flat();
       this.rowOffset = Math.max(0, Math.min(this.rowOffset, Math.max(0, flat.length - budget)));
+      let cursor = 0;
+      this.overviewPage = Math.max(1, rows.filter((row2) => {
+        const start2 = cursor;
+        cursor += row2.length;
+        return start2 >= this.rowOffset && cursor <= this.rowOffset + budget;
+      }).length);
       body = [
-        ...status.slice(0, available - budget),
-        ...flat.length ? flat.slice(this.rowOffset, this.rowOffset + budget) : ["No matching sessions; / search, f filters, r refresh."]
+        ...status,
+        ...heading,
+        ...flat.length ? flat.slice(this.rowOffset, this.rowOffset + budget) : [
+          clip("No matching sessions; / search, f filters, r refresh.", width)
+        ]
       ];
       return [
         ...header,