aidevops 3.29.39 → 3.29.40

package/README.md

@@ -58,7 +58,7 @@ The result: an AI operations platform that manages projects across every busines
 [![Copyright](https://img.shields.io/badge/Copyright-Marcus%20Quinn%202025--2026-blue.svg)](https://github.com/marcusquinn)
 
 <!-- Release & Version Info -->
-[![Version](https://img.shields.io/badge/Version-3.29.39-blue.svg)](https://github.com/marcusquinn/aidevops/releases)
+[![Version](https://img.shields.io/badge/Version-3.29.40-blue.svg)](https://github.com/marcusquinn/aidevops/releases)
 [![npm version](https://img.shields.io/npm/v/aidevops)](https://www.npmjs.com/package/aidevops)
 [![Homebrew](https://img.shields.io/badge/homebrew-marcusquinn%2Ftap-orange)](https://github.com/marcusquinn/homebrew-tap)
 [![GitHub repository](https://img.shields.io/badge/github-repository-181717.svg?logo=github)](https://github.com/marcusquinn/aidevops)

package/VERSION

@@ -1 +1 @@
-3.29.39
+3.29.40

package/aidevops.sh

@@ -5,7 +5,7 @@
 # AI DevOps Framework CLI
 # Usage: aidevops <command> [options]
 #
-# Version: 3.29.39
+# Version: 3.29.40
 
 set -euo pipefail
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aidevops",
-  "version": "3.29.39",
+  "version": "3.29.40",
   "description": "AI DevOps Framework - AI-assisted development workflows, code quality, and deployment automation",
   "type": "module",
   "workspaces": [

package/packages/gui-api/src/status-adapter.ts

@@ -41,6 +41,7 @@ import {
 } from "./status-adapter-utils";
 import { readLocalReposSetupSummary } from "./status-local-repos";
 import { readManagedApps } from "./status-managed-apps";
+import { readPulseWorkersSummary } from "./status-pulse-workers";
 import { readVaultSummary } from "./status-vault";
 
 export { readVaultSummary } from "./status-vault";
@@ -48,6 +49,7 @@ export { readVaultSummary } from "./status-vault";
 export interface StatusAdapterOptions {
   repoRoot?: string;
   observedAt?: string;
+  pulseWorkers?: Parameters<typeof readPulseWorkersSummary>[0];
 }
 
 export const STATUS_ADAPTER_COMMAND = ["aidevops", "status"] as const;
@@ -80,6 +82,7 @@ export function readStatus(
   const opencodeSessions = readOpenCodeSessions(opencodeDbPath, opencodeDbPathRef, localRepos.repos);
   const oauthPool = readOAuthPoolSummary(oauthPoolPath, oauthPoolPathRef);
   const vault = readVaultSummary(repoRoot);
+  const pulseWorkers = readPulseWorkersSummary({ observedAt: options.observedAt, oauthPoolPath, ...options.pulseWorkers });
   const notifications = buildStatusNotifications({
     aiApps,
     greetingOutput: readOptionalText(expandHome(greetingCachePathRef)) ?? "",
@@ -99,6 +102,7 @@ export function readStatus(
     ...setupTargets.map((target) => target.path_ref),
     ...aiApps.flatMap((app) => [app.app_path_ref, app.binary_path_ref, app.config_path_ref, app.aidevops_target_path_ref]),
     ...managedApps.map((app) => app.install_path_ref),
+    ...pulseWorkers.source_path_refs,
   ].filter(isSourcePathRef);
 
   const data: GuiStatusData = {
@@ -148,6 +152,7 @@ export function readStatus(
     managed_apps: managedApps,
     notifications,
     vault,
+    pulse_workers: pulseWorkers.summary,
   };
 
   const envelope = createEnvelope({

package/packages/gui-api/src/status-pulse-workers.ts

@@ -0,0 +1,376 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import {
+  type GuiPulseAuthorAssociation,
+  type GuiPulseIssueOrigin,
+  type GuiPulseProviderId,
+  type GuiPulseResourceKind,
+  type GuiPulseResourceSnapshot,
+  type GuiPulseWorkerActivityEvent,
+  type GuiPulseWorkerChartSeries,
+  type GuiPulseWorkerKpiCard,
+  type GuiPulseWorkerOutcome,
+  type GuiPulseWorkerSeverity,
+  type GuiPulseWorkerStatus,
+  type GuiPulseWorkerSummary,
+  type GuiPulseWorkerUsageSnapshot,
+  type GuiPulsePeriodBucket,
+  pulseWorkersFixture,
+} from "../../gui-shared/src";
+import { collapseHome, expandHome, formatEpochField, isRecord, readJsonObject, stringField } from "./status-adapter-utils";
+
+export interface PulseWorkersAdapterOptions {
+  metricsPath?: string;
+  pulseStatsPath?: string;
+  resourceMetricsPath?: string;
+  tokenReportsRoot?: string;
+  oauthPoolPath?: string;
+  observedAt?: string;
+  nowMs?: number;
+}
+
+interface SourceState {
+  path_ref: string;
+  health: "present" | "missing" | "invalid";
+  observed_at: string;
+}
+
+type MetricRecord = Record<string, unknown>;
+
+const DAY_MS = 86_400_000;
+const WEEK_MS = 7 * DAY_MS;
+const DEFAULT_SCOPE = "local aidevops telemetry";
+const DEFAULT_METRICS_PATH_REF = "~/.aidevops/logs/headless-runtime-metrics.jsonl";
+const DEFAULT_PULSE_STATS_PATH_REF = "~/.aidevops/logs/pulse-stats.json";
+const DEFAULT_RESOURCE_METRICS_PATH_REF = "~/.aidevops/logs/resource-metrics.jsonl";
+const DEFAULT_TOKEN_REPORTS_ROOT_REF = "~/.aidevops/_reports/token-use";
+const DIRECT_WORKER_OUTCOMES = new Set<string>(["merged", "closed", "in_progress", "needs_maintainer_review", "blocked", "failed", "deferred", "created_followup"]);
+const WORKER_OUTCOME_KEYWORDS: Array<[string, GuiPulseWorkerOutcome]> = [["success", "merged"], ["complete", "merged"], ["follow", "created_followup"], ["defer", "deferred"], ["block", "blocked"], ["fail", "failed"], ["kill", "failed"]];
+const DIRECT_ISSUE_ORIGINS = new Set<string>(["aidevops_created", "maintainer_created", "origin_interactive", "third_party", "unknown"]);
+const ISSUE_ORIGIN_KEYWORDS: Array<[string, GuiPulseIssueOrigin]> = [["interactive", "origin_interactive"], ["third", "third_party"], ["community", "third_party"], ["maintainer", "maintainer_created"], ["aidevops", "aidevops_created"]];
+const KNOWN_PROVIDER_IDS: readonly GuiPulseProviderId[] = ["anthropic", "openai", "cursor", "google", "local"];
+
+export function readPulseWorkersSummary(options: PulseWorkersAdapterOptions = {}): { summary: GuiPulseWorkerSummary; source_path_refs: string[] } {
+  const nowMs = options.nowMs ?? Date.parse(options.observedAt ?? new Date().toISOString());
+  const observedAt = new Date(Number.isFinite(nowMs) ? nowMs : Date.now()).toISOString();
+  const metricsPath = options.metricsPath ?? expandHome(DEFAULT_METRICS_PATH_REF);
+  const pulseStatsPath = options.pulseStatsPath ?? expandHome(DEFAULT_PULSE_STATS_PATH_REF);
+  const resourceMetricsPath = options.resourceMetricsPath ?? expandHome(DEFAULT_RESOURCE_METRICS_PATH_REF);
+  const tokenReportsRoot = options.tokenReportsRoot ?? expandHome(DEFAULT_TOKEN_REPORTS_ROOT_REF);
+  const oauthPoolPath = options.oauthPoolPath ?? expandHome("~/.aidevops/oauth-pool.json");
+
+  const metrics = readJsonLines(metricsPath);
+  const resources = readJsonLines(resourceMetricsPath);
+  const tokenReports = readTokenReports(tokenReportsRoot);
+  const pulseStats = readJsonObject(pulseStatsPath);
+  const oauthPool = readJsonObject(oauthPoolPath);
+  const sourceStates: SourceState[] = [
+    stateFor(metricsPath, metrics.health, observedAt),
+    stateFor(pulseStatsPath, pulseStats.health, observedAt),
+    stateFor(resourceMetricsPath, resources.health, observedAt),
+    stateFor(tokenReportsRoot, tokenReports.health, observedAt),
+    stateFor(oauthPoolPath, oauthPool.health, observedAt),
+  ];
+
+  const dayMetrics = filterWindow(metrics.records, nowMs, DAY_MS);
+  const weekMetrics = filterWindow(metrics.records, nowMs, WEEK_MS);
+  const pulseCounters = extractPulseCounters(pulseStats.value, nowMs);
+  const resourceSnapshots = resourceMetricsToSnapshots(resources.records, observedAt);
+  const usageSamples = collectUsageSamples([...dayMetrics, ...tokenReports.records]);
+  const events = buildEvents(dayMetrics, resourceSnapshots, usageSamples, observedAt);
+  const warnings = buildAttention(sourceStates, pulseCounters, resourceSnapshots, oauthPool.value);
+
+  const summary: GuiPulseWorkerSummary = {
+    value_policy: "metadata_only_no_prompt_payloads_no_secrets",
+    selected_period: "day",
+    period_label: "Last 24h",
+    scope_label: DEFAULT_SCOPE,
+    comparison_label: "Prior local telemetry window",
+    updated_at: observedAt,
+    kpis: buildKpis(dayMetrics, weekMetrics, pulseCounters, usageSamples, resourceSnapshots),
+    attention: warnings,
+    filters: buildFilters(events),
+    charts: buildCharts(metrics.records, pulseCounters, nowMs),
+    events,
+  };
+
+  return { summary, source_path_refs: sourceStates.map((source) => source.path_ref) };
+}
+
+function readJsonLines(pathName: string): { health: "present" | "missing" | "invalid"; records: MetricRecord[] } {
+  if (!existsSync(pathName)) {
+    return { health: "missing", records: [] };
+  }
+  try {
+    const records = readFileSync(pathName, "utf8")
+      .split(/\r?\n/)
+      .map((line) => line.trim())
+      .filter(Boolean)
+      .map((line) => JSON.parse(line))
+      .filter(isRecord);
+    return { health: "present", records };
+  } catch {
+    return { health: "invalid", records: [] };
+  }
+}
+
+function readTokenReports(root: string): { health: "present" | "missing" | "invalid"; records: MetricRecord[] } {
+  if (!existsSync(root)) {
+    return { health: "missing", records: [] };
+  }
+  try {
+    const records = readdirSync(root, { withFileTypes: true })
+      .filter((entry) => entry.isDirectory())
+      .map((entry) => join(root, entry.name, "report.json"))
+      .filter((pathName) => existsSync(pathName))
+      .slice(-25)
+      .map((pathName) => JSON.parse(readFileSync(pathName, "utf8")))
+      .filter(isRecord);
+    return { health: "present", records };
+  } catch {
+    return { health: "invalid", records: [] };
+  }
+}
+
+function stateFor(pathName: string, health: SourceState["health"], observedAt: string): SourceState {
+  return { path_ref: collapseHome(pathName), health, observed_at: observedAt };
+}
+
+function filterWindow(records: MetricRecord[], nowMs: number, windowMs: number): MetricRecord[] {
+  const cutoff = nowMs - windowMs;
+  return records.filter((record) => {
+    const time = recordTimeMs(record);
+    return time !== null && time >= cutoff && time <= nowMs;
+  });
+}
+
+function recordTimeMs(record: MetricRecord): number | null {
+  for (const key of ["ts", "timestamp", "started_at", "finished_at", "created_at", "updated_at"]) {
+    const value = record[key];
+    if (typeof value === "number" && Number.isFinite(value)) {
+      return value > 9_999_999_999 ? value : value * 1000;
+    }
+    if (typeof value === "string" && value.length > 0) {
+      const parsed = Date.parse(value);
+      if (Number.isFinite(parsed)) {
+        return parsed;
+      }
+    }
+  }
+  return null;
+}
+
+function extractPulseCounters(value: Record<string, unknown>, nowMs: number): Record<string, number> {
+  const counters = isRecord(value.counters) ? value.counters : {};
+  return Object.fromEntries(Object.entries(counters).map(([name, entries]) => [name, countRecentTimestamps(entries, nowMs, DAY_MS)]));
+}
+
+function countRecentTimestamps(value: unknown, nowMs: number, windowMs: number): number {
+  if (!Array.isArray(value)) {
+    return 0;
+  }
+  const cutoff = nowMs - windowMs;
+  return value.filter((entry) => {
+    const ms = typeof entry === "number" ? (entry > 9_999_999_999 ? entry : entry * 1000) : Date.parse(String(entry));
+    return Number.isFinite(ms) && ms >= cutoff && ms <= nowMs;
+  }).length;
+}
+
+function buildKpis(dayMetrics: MetricRecord[], weekMetrics: MetricRecord[], counters: Record<string, number>, usage: GuiPulseWorkerUsageSnapshot[], resources: GuiPulseResourceSnapshot[]): GuiPulseWorkerKpiCard[] {
+  const total = dayMetrics.length;
+  const healthy = dayMetrics.filter((record) => isHealthyOutcome(outcomeFromRecord(record))).length;
+  const rate = total === 0 ? 0 : Math.round((healthy / total) * 100);
+  const totalTokens = usage.reduce((sum, item) => sum + item.total_tokens, 0);
+  const costRefs = usage.map((item) => item.estimated_cost_ref).filter((item): item is string => item !== null);
+  const attentionCount = Object.values(counters).reduce((sum, count) => sum + count, 0) + resources.filter((resource) => resource.pressure !== "low" && resource.pressure !== "unknown").length;
+
+  return [
+    { id: "worker-outcomes-24h", label: "Healthy worker outcomes", value: total === 0 ? "unknown" : `${rate}%`, period_label: "Last 24h", scope_label: DEFAULT_SCOPE, comparison_label: "computed from local worker metrics", sample_size: total, status: total === 0 ? "attention" : rate >= 80 ? "healthy" : "attention", detail: total === 0 ? "No local worker outcome records were available for the last 24h." : `${healthy} of ${total} local worker sessions ended merged, closed, completed, or deferred.` },
+    { id: "attention-signals", label: "Attention signals", value: String(attentionCount), period_label: "Last 24h", scope_label: DEFAULT_SCOPE, comparison_label: "pulse counters plus resource pressure", sample_size: Object.keys(counters).length + resources.length, status: attentionCount > 0 ? "attention" : "healthy", detail: "Counts canonical Pulse counters and observed resource pressure without treating missing telemetry as failure." },
+    { id: "token-cost", label: "Token and cost sample", value: totalTokens > 0 ? `${totalTokens.toLocaleString()} tokens` : "unknown", period_label: "Last 24h", scope_label: "provider/model metadata", comparison_label: costRefs.length > 0 ? "cost refs observed" : "cost unavailable", sample_size: usage.length, status: usage.length > 0 ? "healthy" : "attention", detail: "Token usage is derived from metadata fields only; prompts, command output, credential paths, and message payloads are excluded." },
+    { id: "systemic-fixes", label: "Systemic fixes observed", value: String(weekMetrics.filter((record) => outcomeFromRecord(record) === "created_followup").length), period_label: "Trailing 7d", scope_label: DEFAULT_SCOPE, comparison_label: "worker outcome metadata", sample_size: weekMetrics.length, status: "completed", detail: "Follow-up/systemic-fix outcomes are counted only when canonical local metrics record them." },
+  ];
+}
+
+function buildAttention(sources: SourceState[], counters: Record<string, number>, resources: GuiPulseResourceSnapshot[], oauthPool: Record<string, unknown>): GuiPulseWorkerSummary["attention"] {
+  const missing = sources.filter((source) => source.health !== "present");
+  const attention: GuiPulseWorkerSummary["attention"] = missing.map((source) => ({ id: `source-${source.health}-${slug(source.path_ref)}`, severity: source.health === "invalid" ? "warning" : "info", title: `Telemetry source ${source.health}`, detail: `${source.path_ref} was ${source.health}; the GUI used safe empty summaries for that source.`, event_ref: null }));
+  for (const [name, count] of Object.entries(counters).filter(([, count]) => count > 0)) {
+    attention.push({ id: `pulse-counter-${slug(name)}`, severity: "warning", title: `Pulse counter active: ${name}`, detail: `${count} events observed in the selected local period.`, event_ref: null });
+  }
+  for (const resource of resources.filter((item) => item.pressure === "medium" || item.pressure === "high")) {
+    attention.push({ id: `resource-${slug(resource.kind)}-${slug(resource.label)}`, severity: resource.pressure === "high" ? "critical" : "warning", title: `${resource.label} pressure ${resource.pressure}`, detail: resource.available_label, event_ref: null });
+  }
+  if (!hasAvailableProvider(oauthPool)) {
+    attention.push({ id: "provider-availability-unknown", severity: "info", title: "Provider availability unknown", detail: "OAuth pool metadata did not expose an available provider account count; the GUI marks provider capacity as unknown.", event_ref: null });
+  }
+  return attention.slice(0, 12);
+}
+
+function buildEvents(records: MetricRecord[], resources: GuiPulseResourceSnapshot[], usage: GuiPulseWorkerUsageSnapshot[], observedAt: string): GuiPulseWorkerActivityEvent[] {
+  return records.slice(-25).sort((left, right) => (recordTimeMs(right) ?? 0) - (recordTimeMs(left) ?? 0)).map((record, index) => {
+    const outcome = outcomeFromRecord(record);
+    const status = statusFromOutcome(outcome);
+    const issue = stringOrNumber(record.issue ?? record.issue_number);
+    const pr = stringOrNumber(record.pr ?? record.pr_number ?? record.pull_request);
+    const repo = stringField(record, "repo") ?? null;
+    return {
+      id: `event:worker:${issue ?? index}:${recordTimeMs(record) ?? index}`,
+      type: "worker_session",
+      status,
+      outcome,
+      severity: severityFromStatus(status),
+      occurred_at: recordTimeMs(record) === null ? observedAt : new Date(recordTimeMs(record) as number).toISOString(),
+      title: "Worker session",
+      summary: summaryFromRecord(record, outcome),
+      pulse_run_ref: stringField(record, "pulse_run_ref") ?? null,
+      worker_session_ref: stringField(record, "session_key") ?? stringField(record, "worker_session_ref") ?? null,
+      issue_ref: issue === null ? null : `#${issue.replace(/^#/, "")}`,
+      pull_request_ref: pr === null ? null : `#${pr.replace(/^#/, "")}`,
+      command_job_ref: stringField(record, "command_job_ref") ?? null,
+      repo_ref: repo,
+      actor_ref: stringField(record, "actor") ?? "worker:auto-dispatch",
+      issue_origin: issueOriginFromRecord(record),
+      author_association: authorAssociationFromRecord(record),
+      duration_ms: durationMsFromRecord(record),
+      usage: usageFromRecord(record) ?? usage[index] ?? null,
+      resources,
+      drilldown_sections: [
+        { label: "Evidence", body: "Derived from local worker outcome/resource metadata; prompt text and command payloads are not exposed." },
+        { label: "Outcome", body: outcome },
+      ],
+    };
+  });
+}
+
+function buildFilters(events: GuiPulseWorkerActivityEvent[]): GuiPulseWorkerSummary["filters"] {
+  return {
+    repos: countOptions(events.map((event) => event.repo_ref).filter(Boolean) as string[], "repo:"),
+    event_types: countOptions(events.map((event) => event.type)),
+    outcomes: countOptions(events.map((event) => event.outcome)),
+    resources: countOptions(events.flatMap((event) => event.resources.map((resource) => resource.kind))),
+    providers: countOptions(events.map((event) => event.usage === null ? null : `${event.usage.provider}:${event.usage.model_ref ?? "unknown"}`).filter(Boolean) as string[]),
+    issue_origins: countOptions(events.map((event) => event.issue_origin)),
+    authors: countOptions(events.map((event) => event.actor_ref).filter(Boolean) as string[], "actor:"),
+    author_associations: countOptions(events.map((event) => event.author_association)),
+  };
+}
+
+function buildCharts(records: MetricRecord[], counters: Record<string, number>, nowMs: number): GuiPulseWorkerChartSeries[] {
+  const specs: Array<[GuiPulsePeriodBucket, number, string]> = [["day", DAY_MS, "Last 24h"], ["week", WEEK_MS, "Trailing 7d"], ["month", 30 * DAY_MS, "Trailing 30d"], ["year", 365 * DAY_MS, "Trailing 365d"]];
+  const counterTotal = Object.values(counters).reduce((sum, count) => sum + count, 0);
+  return [{ id: "worker-events", label: "Worker events", unit: "count", points: specs.map(([period, windowMs, label]) => ({ period, period_label: label, scope_label: DEFAULT_SCOPE, bucket_start: new Date(nowMs - windowMs).toISOString(), bucket_end: new Date(nowMs).toISOString(), value: filterWindow(records, nowMs, windowMs).length + (period === "day" ? counterTotal : 0) })) }];
+}
+
+function resourceMetricsToSnapshots(records: MetricRecord[], observedAt: string): GuiPulseResourceSnapshot[] {
+  return records.slice(-5).map((record) => {
+    const rssKb = numberValue(record.rss_kb ?? record.peak_rss_kb);
+    return { kind: "memory" as GuiPulseResourceKind, label: stringField(record, "role") ?? "Process memory", available_label: rssKb === null ? "unknown" : `${Math.round(rssKb / 1024)} MB RSS`, pressure: rssKb === null ? "unknown" : rssKb > 2_000_000 ? "high" : rssKb > 750_000 ? "medium" : "low", observed_at: recordTimeMs(record) === null ? observedAt : new Date(recordTimeMs(record) as number).toISOString(), reset_at: null };
+  });
+}
+
+function collectUsageSamples(records: MetricRecord[]): GuiPulseWorkerUsageSnapshot[] {
+  return records.map(usageFromRecord).filter((usage): usage is GuiPulseWorkerUsageSnapshot => usage !== null);
+}
+
+function usageFromRecord(record: MetricRecord): GuiPulseWorkerUsageSnapshot | null {
+  const input = numberValue(record.input_tokens ?? record.prompt_tokens);
+  const output = numberValue(record.output_tokens ?? record.completion_tokens);
+  const total = numberValue(record.total_tokens) ?? (input ?? 0) + (output ?? 0);
+  if (total <= 0 && input === null && output === null) {
+    return null;
+  }
+  const provider = providerFromString(stringField(record, "provider") ?? stringField(record, "provider_id"));
+  const model = stringField(record, "model") ?? stringField(record, "model_ref") ?? null;
+  return { provider, provider_ref: `provider:${provider}`, model_ref: model, input_tokens: input ?? 0, output_tokens: output ?? 0, cached_tokens: numberValue(record.cached_tokens) ?? 0, total_tokens: total, cost_ref: costRef(record), estimated_cost_ref: costRef(record), wall_time_ms: numberValue(record.wall_time_ms ?? record.duration_ms) ?? 0 };
+}
+
+function outcomeFromRecord(record: MetricRecord): GuiPulseWorkerOutcome {
+  const raw = String(record.outcome ?? record.result ?? record.status ?? "in_progress").toLowerCase();
+  if (DIRECT_WORKER_OUTCOMES.has(raw)) {
+    return raw as GuiPulseWorkerOutcome;
+  }
+  const match = WORKER_OUTCOME_KEYWORDS.find(([keyword]) => raw.includes(keyword));
+  return match?.[1] ?? "in_progress";
+}
+
+function statusFromOutcome(outcome: GuiPulseWorkerOutcome): GuiPulseWorkerStatus {
+  if (outcome === "failed") return "failed";
+  if (outcome === "blocked" || outcome === "needs_maintainer_review") return "blocked";
+  if (outcome === "in_progress") return "running";
+  if (outcome === "deferred") return "deferred";
+  return "completed";
+}
+
+function severityFromStatus(status: GuiPulseWorkerStatus): GuiPulseWorkerSeverity {
+  if (status === "failed" || status === "blocked") return "critical";
+  if (status === "attention" || status === "deferred") return "warning";
+  if (status === "completed" || status === "healthy") return "success";
+  return "info";
+}
+
+function isHealthyOutcome(outcome: GuiPulseWorkerOutcome): boolean {
+  return ["merged", "closed", "deferred", "created_followup"].includes(outcome);
+}
+
+function issueOriginFromRecord(record: MetricRecord): GuiPulseIssueOrigin {
+  const raw = String(record.issue_origin ?? record.origin ?? "unknown").toLowerCase();
+  if (DIRECT_ISSUE_ORIGINS.has(raw)) return raw as GuiPulseIssueOrigin;
+  const match = ISSUE_ORIGIN_KEYWORDS.find(([keyword]) => raw.includes(keyword));
+  return match?.[1] ?? "unknown";
+}
+
+function authorAssociationFromRecord(record: MetricRecord): GuiPulseAuthorAssociation {
+  const raw = String(record.author_association ?? "UNKNOWN").toUpperCase();
+  if (["OWNER", "MEMBER", "COLLABORATOR", "CONTRIBUTOR", "FIRST_TIME_CONTRIBUTOR", "NONE", "UNKNOWN"].includes(raw)) return raw as GuiPulseAuthorAssociation;
+  return "UNKNOWN";
+}
+
+function durationMsFromRecord(record: MetricRecord): number | null {
+  const duration = numberValue(record.duration_ms ?? record.wall_time_ms);
+  if (duration !== null) return duration;
+  const elapsed = numberValue(record.elapsed_s);
+  return elapsed === null ? null : elapsed * 1000;
+}
+
+function summaryFromRecord(record: MetricRecord, outcome: GuiPulseWorkerOutcome): string {
+  const issue = stringOrNumber(record.issue ?? record.issue_number);
+  return issue === null ? `Worker outcome: ${outcome}.` : `Worker outcome for #${issue.replace(/^#/, "")}: ${outcome}.`;
+}
+
+function countOptions(values: string[], prefix = ""): Array<{ id: string; label: string; count: number }> {
+  const counts = new Map<string, number>();
+  for (const value of values) counts.set(value, (counts.get(value) ?? 0) + 1);
+  return [...counts.entries()].map(([label, count]) => ({ id: `${prefix}${slug(label)}`, label, count })).sort((a, b) => b.count - a.count || a.label.localeCompare(b.label));
+}
+
+function hasAvailableProvider(value: Record<string, unknown>): boolean {
+  const providers = Array.isArray(value.providers) ? value.providers : [];
+  return providers.some((provider) => isRecord(provider) && (numberValue(provider.available) ?? 0) > 0);
+}
+
+function costRef(record: MetricRecord): string | null {
+  const cost = record.estimated_cost_ref ?? record.cost_ref;
+  if (typeof cost === "string" && cost.length > 0 && !cost.includes("/")) return cost;
+  const amount = numberValue(record.estimated_cost_usd ?? record.cost_usd);
+  return amount === null ? null : `$${amount.toFixed(2)} estimated`;
+}
+
+function providerFromString(value: string | undefined): GuiPulseProviderId {
+  if (KNOWN_PROVIDER_IDS.includes(value as GuiPulseProviderId)) return value as GuiPulseProviderId;
+  return "unknown";
+}
+
+function stringOrNumber(value: unknown): string | null {
+  if (typeof value === "string" && value.length > 0) return value;
+  if (typeof value === "number" && Number.isFinite(value)) return String(value);
+  return null;
+}
+
+function numberValue(value: unknown): number | null {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+
+function slug(value: string): string {
+  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "unknown";
+}

package/packages/gui-shared/src/tambo.ts

@@ -160,7 +160,7 @@ export const TAMBO_PROVIDER_CONFIG: GuiTamboProviderConfig = {
 
 export function validateTamboComponentPayload(payload: unknown, scope: GuiConversationScope): GuiTamboValidationResult {
   const envelope = validateTamboPayloadEnvelope(payload, scope);
-  if (!envelope.ok) {
+  if (envelope.ok === false) {
     return envelope.result;
   }
 

package/packages/gui-web/src/AppWorkspace.tsx

@@ -10,6 +10,7 @@ import { CommsConversationSurface } from "./CommsConversationSurface";
 import { FileExplorerSurface } from "./FileExplorerSurface";
 import { TamboConversationPart } from "./GenUiCards";
 import { AppsSurface, EditableInventorySurface, InstallationSurface } from "./InventorySurfaces";
+import { PulseWorkersSurface } from "./PulseWorkersSurface";
 import { AiProvidersSurface, LocalReposSurface, LockedVaultGate, OverviewSurface, PlannedSurface, ProjectsSurface, SecuritySurface, VaultSurface } from "./StatusSurfaces";
 import { isVaultSurfaceLocked, vaultCollectionForSurface } from "./VaultBadges";
 import { applyCommandPaletteSelection, useHeaderMenuState } from "./workspace-header-state";
@@ -292,7 +293,7 @@ function AiSessionsSurface({ selectedRepoIndex, selectedSessionId, status }: { s
           <ToolStatusCard />
           <TamboConversationPart
             part={{ id: "ai-session-tambo-preview", message_id: "ai-session-preview", kind: "tambo_component", ordinal: 1, text: null, payload_json: { component: "RepoHealthCard", tenant_ref: "local", session_ref: selectedSession?.id_ref ?? "ai-session-preview", read_only: true, props: { repo: selectedRepo?.name ?? "local workspace", status: "ready for Tambo cards", open_prs: 0, failing_checks: 0, notes: ["Server-proxied provider metadata", "Read-only schemas first"] } }, file_ref: null, source_ref: "tambo:ai-session-preview" }}
-            scope={{ tenant_ref: "local", workspace_ref: "aidevops", repo_ref: selectedRepo?.slug ?? null }}
+            scope={{ tenant_ref: "local", workspace_ref: "aidevops", repo_ref: selectedRepo?.path_ref ?? null }}
           />
         </div>
         <form className="chat-composer ai-composer" aria-label="AI prompt composer" data-tour="ai-composer">
@@ -437,114 +438,6 @@ function SurfaceContent({ activeItem, activeSurface, fileRoot, openSurface, stat
   return staticSurfaces[activeSurface] ?? null;
 }
 
-const pulseFilters = ["Repo", "Event type", "Outcome", "Resource", "Provider / model", "Issue origin", "Author", "Author association"] as const;
-
-function PulseWorkersSurface({ status }: { status: GuiStatusData }): ReactElement {
-  const pulse = status.pulse_workers;
-
-  return (
-    <section className="pulse-workers-surface" aria-label={text.workers}>
-      <div className="planned-card pulse-hero">
-        <p className="eyebrow">Observability shell · fixture-backed · read-only</p>
-        <h2>{text.workers}</h2>
-        <p>{text.workersIntro}</p>
-        <section className="pulse-scope-strip" aria-label="Pulse scope and time range">
-          <span><strong>Period</strong> {pulse.period_label} · {pulse.scope_label}</span>
-          <span><strong>Comparison</strong> {pulse.comparison_label}</span>
-          <span><strong>Sample</strong> {pulse.events.length} canonical events · {pulse.kpis.reduce((total, kpi) => total + (kpi.sample_size ?? 0), 0)} samples</span>
-          <span><strong>Trust boundary</strong> Metadata/status only; protected payloads excluded</span>
-        </section>
-      </div>
-      <section className="pulse-kpi-grid" aria-label="Pulse health summary">
-        {pulse.kpis.map((kpi) => (
-          <article className="metric-card pulse-kpi-card" key={kpi.id}>
-            <span>{kpi.label} · {kpi.period_label} · {kpi.scope_label}</span>
-            <strong>{kpi.value}</strong>
-            <p>{kpi.detail} {kpi.comparison_label}</p>
-          </article>
-        ))}
-      </section>
-      <section className="pulse-layout" aria-label="Pulse observability hierarchy">
-        <article className="planned-card pulse-attention-panel">
-          <div className="split-heading">
-            <div>
-              <p className="eyebrow">Exceptions first</p>
-              <h3>Needs attention</h3>
-            </div>
-            <span className="count-pill">planned actions disabled</span>
-          </div>
-          <ul>
-            {pulse.attention.map((item) => <li key={item.id}>{item.title}: {item.detail}</li>)}
-          </ul>
-          <button disabled title="Action routes need audited worker control APIs" type="button">Create systemic fix (planned)</button>
-        </article>
-        <article className="planned-card pulse-chart-panel">
-          <p className="eyebrow">Trends</p>
-          <h3>Health trend placeholder</h3>
-          <div className="pulse-chart-placeholder" aria-label="Chart placeholder showing health, queue, token, cost, API, and CI capacity trends" role="img">
-            <span>health</span><span>queue</span><span>tokens</span><span>cost</span><span>api</span><span>ci</span>
-          </div>
-          <p>Charts derive from {pulse.charts.map((chart) => chart.points[0]?.period).filter(Boolean).join("/")} fixture buckets across the canonical event stream: Pulse, workers, commands, CI, issues, PRs, reviews, and outcomes.</p>
-        </article>
-      </section>
-      <section className="planned-card pulse-activity-panel" aria-label="Unified activity stream">
-        <div className="split-heading">
-          <div>
-            <p className="eyebrow">Canonical stream</p>
-            <h3>Unified activity</h3>
-          </div>
-          <section className="pulse-filter-row" aria-label="Quick filters">
-            {pulseFilters.map((filter) => <button disabled key={filter} title={`${filter} filter is planned`} type="button">{filter}</button>)}
-          </section>
-        </div>
-        <table className="pulse-activity-table" aria-label="Pulse and worker events">
-          <thead>
-            <tr className="pulse-activity-row pulse-activity-header">
-              <th scope="col">When</th><th scope="col">Event</th><th scope="col">Scope</th><th scope="col">Outcome</th><th scope="col">Resource</th><th scope="col">Origin / actor</th>
-            </tr>
-          </thead>
-          <tbody>
-            {pulse.events.map((row) => (
-              <tr className="pulse-activity-row" key={row.id}>
-                <td data-label="When">{row.occurred_at.slice(11, 16)}</td>
-                <td data-label="Event">{row.title}</td>
-                <td data-label="Scope">{[row.repo_ref, row.issue_ref ?? row.pull_request_ref].filter(Boolean).join(" ")}</td>
-                <td data-label="Outcome">{row.outcome.replaceAll("_", " ")}</td>
-                <td data-label="Resource">{resourceSummary(row)}</td>
-                <td data-label="Origin / actor">{row.issue_origin.replaceAll("_", "-")} · {row.author_association}</td>
-              </tr>
-            ))}
-          </tbody>
-        </table>
-        <p className="notice compact-notice">Mobile activity cards replace the dense table on small screens. Detail drawer becomes a full-screen sheet on small screens, and terminal panel becomes full-screen later.</p>
-      </section>
-      <section className="pulse-layout" aria-label="Drilldown and planned actions">
-        <article className="planned-card pulse-drilldown-panel">
-          <p className="eyebrow">Drilldown placeholder</p>
-          <h3>What happened, when, why, how, who acted, and what resources were available</h3>
-          <p>Selected event details will connect timeline evidence, issue/PR/review context, provider/model/tokens/time/cost metadata, GitHub/API allowance, queue/concurrency, CI capacity, and local resource snapshots without exposing secrets.</p>
-        </article>
-        <article className="planned-card pulse-actions-panel">
-          <p className="eyebrow">Planned controls</p>
-          <h3>Actions stay disabled until audited routes land</h3>
-          <button disabled title="Terminal output needs a read-only command-output adapter" type="button">Open terminal output (planned)</button>
-          <button disabled title="Dispatch needs worker control and trust-boundary APIs" type="button">Redispatch worker (planned)</button>
-          <button disabled title="Persistence needs a write-action manifest and audit trail" type="button">Save systemic fix (planned)</button>
-        </article>
-      </section>
-    </section>
-  );
-}
-
-function resourceSummary(row: GuiStatusData["pulse_workers"]["events"][number]): string {
-  const model = row.usage?.model_ref?.replace("model:", "");
-  const providerLabel = row.usage?.provider === "openai" ? "OpenAI" : row.usage?.provider === "anthropic" ? "Anthropic" : row.usage?.provider;
-  const provider = row.usage === null ? row.resources[0]?.available_label ?? "metadata only" : `${providerLabel ?? "Provider"} · ${model ?? "model metadata pending"}`;
-  const tokens = row.usage === null ? "" : ` · ${row.usage.total_tokens.toLocaleString()} tokens`;
-
-  return `${provider}${tokens}`;
-}
-
 function HelpSurface(): ReactElement {
   const shortcuts = [
     ["#", "Channels"],

package/packages/gui-web/src/PulseWorkersSurface.tsx

@@ -0,0 +1,262 @@
+import { type CSSProperties, type ReactElement, useState } from "react";
+import type { GuiPulseWorkerActivityEvent, GuiPulseWorkerChartSeries, GuiStatusData } from "../../gui-shared/src";
+import { text } from "./app-model";
+
+type PulseEvent = GuiPulseWorkerActivityEvent;
+type PulseFilterGroup = { label: string; values: string[] };
+
+const quickFilters = ["Needs attention", "Stalled workers", "Failed terminal checks", "Expensive runs", "Third-party issues", "No verification"];
+
+export function PulseWorkersSurface({ status }: { status: GuiStatusData }): ReactElement {
+  const pulse = status.pulse_workers;
+  const [selectedEventId, setSelectedEventId] = useState(pulse.events[0]?.id ?? "");
+  const selectedEvent = pulse.events.find((event) => event.id === selectedEventId) ?? pulse.events[0];
+  const filterGroups = buildFilterGroups(pulse);
+  const chartSeries = pulse.charts.slice(0, 4);
+  const sampleSize = pulse.kpis.reduce((total, kpi) => total + (kpi.sample_size ?? 0), 0);
+
+  return (
+    <section className="pulse-workers-surface" aria-label={text.workers}>
+      <div className="planned-card pulse-hero">
+        <p className="eyebrow">Data-driven observability · shared pulse_workers status · read-only</p>
+        <h2>{text.workers}</h2>
+        <p>{text.workersIntro}</p>
+        <section className="pulse-scope-strip" aria-label="Pulse scope and time range">
+          <span><strong>Period</strong> {pulse.period_label} · {periodChoices(pulse.selected_period)}</span>
+          <span><strong>Repo scope</strong> {pulse.scope_label}</span>
+          <span><strong>Issue origin</strong> {filterSummary(pulse.filters.issue_origins)}</span>
+          <span><strong>Provider/model scope</strong> {filterSummary(pulse.filters.providers)}</span>
+          <span><strong>Comparison</strong> {pulse.comparison_label}</span>
+          <span><strong>Sample</strong> {pulse.events.length} canonical events · {sampleSize} samples</span>
+          <span><strong>Trust boundary</strong> Metadata/status only; protected payloads excluded</span>
+        </section>
+      </div>
+
+      <section className="pulse-kpi-grid" aria-label="Pulse health summary">
+        {pulse.kpis.map((kpi) => (
+          <article className={`metric-card pulse-kpi-card pulse-status-${kpi.status}`} key={kpi.id}>
+            <span>{kpi.label} · {kpi.period_label} · {kpi.scope_label}</span>
+            <strong>{kpi.value}</strong>
+            <p>{kpi.detail} {kpi.comparison_label}{kpi.sample_size === undefined ? "" : ` · n=${kpi.sample_size}`}</p>
+          </article>
+        ))}
+      </section>
+
+      <section className="pulse-layout pulse-overview-layout" aria-label="Pulse observability hierarchy">
+        <article className="planned-card pulse-attention-panel">
+          <div className="split-heading">
+            <div>
+              <p className="eyebrow">Exceptions first</p>
+              <h3>Needs attention</h3>
+            </div>
+            <span className="count-pill">{pulse.attention.length} findings · planned actions disabled</span>
+          </div>
+          <ul>
+            {pulse.attention.map((item) => <li className={`pulse-attention-${item.severity}`} key={item.id}><strong>{item.title}</strong>: {item.detail}</li>)}
+          </ul>
+          <button disabled title="Action routes need audited worker control APIs" type="button">Create systemic fix (planned)</button>
+        </article>
+
+        <section className="pulse-chart-grid" aria-label="Pulse trend charts">
+          {chartSeries.map((chart) => <PulseChartPanel chart={chart} key={chart.id} />)}
+        </section>
+      </section>
+
+      <section className="planned-card pulse-filter-panel" aria-label="Pulse filters">
+        <div className="split-heading">
+          <div>
+            <p className="eyebrow">Filter controls</p>
+            <h3>Scope the canonical event stream</h3>
+          </div>
+          <span className="count-pill">disabled preview controls</span>
+        </div>
+        <div className="pulse-filter-groups">
+          {filterGroups.map((group) => (
+            <fieldset className="pulse-filter-group" key={group.label}>
+              <legend>{group.label}</legend>
+              <div className="pulse-filter-row">
+                {group.values.map((value) => <button disabled key={`${group.label}-${value}`} title={`${group.label}: ${value} filter is planned`} type="button">{value}</button>)}
+              </div>
+            </fieldset>
+          ))}
+        </div>
+      </section>
+
+      <section className="planned-card pulse-activity-panel" aria-label="Unified activity stream">
+        <div className="split-heading">
+          <div>
+            <p className="eyebrow">Canonical stream</p>
+            <h3>Unified activity</h3>
+          </div>
+          <section className="pulse-filter-row pulse-quick-filter-row" aria-label="Quick filters">
+            {quickFilters.map((filter) => <button disabled key={filter} title={`${filter} quick filter is planned`} type="button">{filter}</button>)}
+          </section>
+        </div>
+        <table className="pulse-activity-table" aria-label="Pulse and worker events">
+          <thead>
+            <tr className="pulse-activity-row pulse-activity-header">
+              <th scope="col">When</th><th scope="col">Event</th><th scope="col">Scope</th><th scope="col">Outcome</th><th scope="col">Resource</th><th scope="col">Origin / actor</th>
+            </tr>
+          </thead>
+          <tbody>
+            {pulse.events.map((row) => (
+              <tr className={row.id === selectedEvent?.id ? "pulse-activity-row selected" : "pulse-activity-row"} key={row.id}>
+                <td data-label="When"><button className="pulse-row-select" onClick={() => setSelectedEventId(row.id)} type="button">{row.occurred_at.slice(11, 16)}</button></td>
+                <td data-label="Event"><strong>{row.title}</strong><span>{row.summary}</span></td>
+                <td data-label="Scope">{[row.repo_ref, row.issue_ref ?? row.pull_request_ref, row.worker_session_ref].filter(Boolean).join(" · ")}</td>
+                <td data-label="Outcome">{humanize(row.outcome)} · {humanize(row.status)}</td>
+                <td data-label="Resource">{resourceSummary(row)}</td>
+                <td data-label="Origin / actor">{humanize(row.issue_origin, "-")} · {row.author_association} · {row.actor_ref ?? "actor pending"}</td>
+              </tr>
+            ))}
+          </tbody>
+        </table>
+        <div className="pulse-card-stream" aria-label="Mobile activity cards">
+          {pulse.events.map((row) => (
+            <button className={row.id === selectedEvent?.id ? "pulse-event-card selected" : "pulse-event-card"} key={row.id} onClick={() => setSelectedEventId(row.id)} type="button">
+              <span>{row.occurred_at.slice(11, 16)} · {humanize(row.severity)}</span>
+              <strong>{row.title}</strong>
+              <small>{humanize(row.outcome)} · {resourceSummary(row)}</small>
+            </button>
+          ))}
+        </div>
+        <p className="notice compact-notice">Mobile activity cards replace the dense table on small screens. Detail drawer becomes a full-screen sheet on small screens, and terminal panel becomes full-screen later.</p>
+      </section>
+
+      <section className="pulse-layout" aria-label="Drilldown and planned actions">
+        <PulseDrilldownPanel event={selectedEvent} />
+        <article className="planned-card pulse-actions-panel">
+          <p className="eyebrow">Planned controls</p>
+          <h3>Actions stay disabled until audited routes land</h3>
+          <button disabled title="Terminal output needs a read-only command-output adapter" type="button">Open terminal output (planned)</button>
+          <button disabled title="Dispatch needs worker control and trust-boundary APIs" type="button">Redispatch worker (planned)</button>
+          <button disabled title="Persistence needs a write-action manifest and audit trail" type="button">Save systemic fix (planned)</button>
+        </article>
+      </section>
+    </section>
+  );
+}
+
+function PulseChartPanel({ chart }: { chart: GuiPulseWorkerChartSeries }): ReactElement {
+  const maxValue = Math.max(...chart.points.map((point) => point.value), 1);
+
+  return (
+    <article className="planned-card pulse-chart-panel">
+      <p className="eyebrow">Trends · day/week/month/year</p>
+      <h3>{chart.label}</h3>
+      <div className="pulse-chart-placeholder" aria-label={`${chart.label} chart for day week month year buckets`} role="img">
+        {chart.points.map((point) => <span key={`${chart.id}-${point.period}`} style={{ "--bar-height": `${Math.max(18, Math.round((point.value / maxValue) * 100))}%` } as CSSProperties}>{point.period}</span>)}
+      </div>
+      <p>{chart.unit} · {chart.points.map((point) => `${point.period_label}: ${point.value}`).join(" · ")}</p>
+    </article>
+  );
+}
+
+function PulseDrilldownPanel({ event }: { event: PulseEvent | undefined }): ReactElement {
+  if (event === undefined) {
+    return (
+      <article className="planned-card pulse-drilldown-panel pulse-detail-drawer" aria-label="Pulse event detail drawer">
+        <p className="eyebrow">Drilldown drawer</p>
+        <h3>No activity selected</h3>
+        <p>Selected event details will connect timeline evidence, issue/PR/review context, usage, resources, failure analysis, suggested systemic fixes, and planned actions without exposing secrets.</p>
+      </article>
+    );
+  }
+
+  return (
+    <article className="planned-card pulse-drilldown-panel pulse-detail-drawer" aria-label="Pulse event detail drawer">
+      <p className="eyebrow">Drilldown drawer · selected row</p>
+      <h3>{event.title}</h3>
+      <dl className="pulse-detail-grid">
+        <div><dt>What</dt><dd>{event.summary}</dd></div>
+        <div><dt>When</dt><dd>{event.occurred_at} · {durationLabel(event.duration_ms)}</dd></div>
+        <div><dt>Why</dt><dd>{event.drilldown_sections.find((section) => section.label.toLowerCase().includes("failure"))?.body ?? event.drilldown_sections[0]?.body ?? "No failure analysis recorded."}</dd></div>
+        <div><dt>How</dt><dd>{[event.type, event.status, event.outcome].map((value) => humanize(value)).join(" · ")}</dd></div>
+        <div><dt>Who</dt><dd>{event.actor_ref ?? "actor pending"} · {humanize(event.issue_origin, "-")} · {event.author_association}</dd></div>
+        <div><dt>Issue / PR / session refs</dt><dd>{[event.repo_ref, event.issue_ref, event.pull_request_ref, event.worker_session_ref, event.command_job_ref, event.pulse_run_ref].filter(Boolean).join(" · ")}</dd></div>
+        <div><dt>Usage and cost</dt><dd>{usageSummary(event)}</dd></div>
+        <div><dt>Resources</dt><dd>{event.resources.map((resource) => `${resource.label}: ${resource.available_label} (${resource.pressure})`).join(" · ") || "Resource metadata pending"}</dd></div>
+        <div><dt>Suggested systemic fix</dt><dd>{event.drilldown_sections.find((section) => section.label.toLowerCase().includes("fix"))?.body ?? "Create a worker-ready follow-up when repeated blindspots appear."}</dd></div>
+        <div><dt>Planned actions</dt><dd>Open terminal output, redispatch worker, save systemic fix, and attach timeline evidence remain disabled until Phase 5 action routes land.</dd></div>
+      </dl>
+    </article>
+  );
+}
+
+function buildFilterGroups(pulse: GuiStatusData["pulse_workers"]): PulseFilterGroup[] {
+  return [
+    { label: "Repo", values: optionLabels(pulse.filters.repos) },
+    { label: "Event type", values: optionLabels(pulse.filters.event_types) },
+    { label: "Outcome", values: optionLabels(pulse.filters.outcomes) },
+    { label: "Status", values: unique(pulse.events.map((event) => humanize(event.status))) },
+    { label: "Severity", values: unique(pulse.events.map((event) => humanize(event.severity))) },
+    { label: "Resource", values: optionLabels(pulse.filters.resources) },
+    { label: "Provider / model", values: optionLabels(pulse.filters.providers) },
+    { label: "Model", values: unique(pulse.events.map((event) => event.usage?.model_ref?.replace("model:", "") ?? "model pending")) },
+    { label: "Issue origin", values: optionLabels(pulse.filters.issue_origins) },
+    { label: "Author", values: optionLabels(pulse.filters.authors) },
+    { label: "Author association", values: optionLabels(pulse.filters.author_associations) },
+    { label: "Cost range", values: unique(pulse.events.map((event) => event.usage?.estimated_cost_ref ?? "no cost metadata")) },
+    { label: "Duration range", values: unique(pulse.events.map((event) => durationBucket(event.duration_ms))) },
+  ];
+}
+
+function optionLabels(options: Array<{ label: string; count: number }>): string[] {
+  return options.map((option) => `${option.label} (${option.count})`);
+}
+
+function unique(values: string[]): string[] {
+  return Array.from(new Set(values.filter(Boolean)));
+}
+
+function filterSummary(options: Array<{ label: string; count: number }>): string {
+  return optionLabels(options).slice(0, 3).join(" · ") || "all";
+}
+
+function periodChoices(selected: string): string {
+  return ["day", "week", "month", "year"].map((period) => period === selected ? `${period} selected` : period).join(" / ");
+}
+
+function resourceSummary(row: PulseEvent): string {
+  const model = row.usage?.model_ref?.replace("model:", "");
+  const providerLabel = row.usage?.provider === "openai" ? "OpenAI" : row.usage?.provider === "anthropic" ? "Anthropic" : row.usage?.provider;
+  const provider = row.usage === null ? row.resources[0]?.available_label ?? "metadata only" : `${providerLabel ?? "Provider"} · ${model ?? "model metadata pending"}`;
+  const tokens = row.usage === null ? "" : ` · ${row.usage.total_tokens.toLocaleString()} tokens`;
+  const cost = row.usage?.estimated_cost_ref === null || row.usage?.estimated_cost_ref === undefined ? "" : ` · ${row.usage.estimated_cost_ref}`;
+
+  return `${provider}${tokens}${cost}`;
+}
+
+function usageSummary(event: PulseEvent): string {
+  if (event.usage === null) {
+    return "Usage metadata pending or not applicable.";
+  }
+
+  return `${event.usage.provider} · ${event.usage.model_ref ?? "model pending"} · ${event.usage.total_tokens.toLocaleString()} tokens · ${event.usage.estimated_cost_ref ?? "cost pending"} · ${durationLabel(event.usage.wall_time_ms)}`;
+}
+
+function durationBucket(durationMs: number | null): string {
+  if (durationMs === null) {
+    return "duration pending";
+  }
+  if (durationMs < 300000) {
+    return "under 5m";
+  }
+  if (durationMs < 1800000) {
+    return "5m-30m";
+  }
+
+  return "30m+";
+}
+
+function durationLabel(durationMs: number | null): string {
+  if (durationMs === null) {
+    return "duration pending";
+  }
+
+  return `${Math.round(durationMs / 60000)}m`;
+}
+
+function humanize(value: string, replacement = " "): string {
+  return value.replaceAll("_", replacement);
+}

package/packages/gui-web/src/styles.css

@@ -2261,6 +2261,10 @@ code {
   grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
 }
 
+.pulse-overview-layout {
+  grid-template-columns: minmax(280px, 0.8fr) minmax(320px, 1.2fr);
+}
+
 .pulse-kpi-card {
   display: grid;
   gap: 8px;
@@ -2284,11 +2288,23 @@ code {
 .pulse-chart-panel,
 .pulse-activity-panel,
 .pulse-drilldown-panel,
-.pulse-actions-panel {
+.pulse-actions-panel,
+.pulse-filter-panel {
   display: grid;
   gap: 12px;
 }
 
+.pulse-attention-critical,
+.pulse-status-blocked strong,
+.pulse-status-failed strong {
+  color: var(--notification-error-fg);
+}
+
+.pulse-attention-warning,
+.pulse-status-needs_attention strong {
+  color: var(--notification-warning-fg);
+}
+
 .pulse-attention-panel ul {
   display: grid;
   gap: 8px;
@@ -2318,11 +2334,37 @@ code {
   font-size: 0.75rem;
   font-weight: 900;
   justify-content: center;
-  min-height: calc(40px + var(--bar-index, 1) * 18px);
+  min-height: max(40px, var(--bar-height, calc(40px + var(--bar-index, 1) * 18px)));
   padding: 8px 4px;
   text-transform: uppercase;
 }
 
+.pulse-chart-grid,
+.pulse-filter-groups {
+  display: grid;
+  gap: 12px;
+  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+}
+
+.pulse-filter-group {
+  border: 1px solid var(--border);
+  border-radius: 14px;
+  margin: 0;
+  padding: 10px;
+}
+
+.pulse-filter-group legend {
+  color: var(--accent);
+  font-size: 0.76rem;
+  font-weight: 900;
+  padding: 0 6px;
+  text-transform: uppercase;
+}
+
+.pulse-quick-filter-row {
+  justify-content: flex-end;
+}
+
 .pulse-chart-placeholder span:nth-child(2) { --bar-index: 3; }
 .pulse-chart-placeholder span:nth-child(3) { --bar-index: 5; }
 .pulse-chart-placeholder span:nth-child(4) { --bar-index: 2; }
@@ -2349,6 +2391,25 @@ code {
   padding: 12px 14px;
 }
 
+.pulse-activity-row.selected {
+  background: color-mix(in srgb, var(--accent) 9%, transparent);
+}
+
+.pulse-activity-row td {
+  display: grid;
+  gap: 3px;
+}
+
+.pulse-activity-row td span {
+  color: var(--text-muted);
+  font-size: 0.82rem;
+}
+
+.pulse-row-select {
+  justify-self: start;
+  padding: 4px 8px;
+}
+
 .pulse-activity-row + .pulse-activity-row {
   border-top: 1px solid var(--border);
 }
@@ -2372,6 +2433,59 @@ code {
   justify-self: start;
 }
 
+.pulse-card-stream {
+  display: none;
+}
+
+.pulse-event-card {
+  background: var(--surface-muted);
+  border: 1px solid var(--border);
+  border-radius: 14px;
+  color: var(--text-primary);
+  display: grid;
+  gap: 5px;
+  padding: 12px;
+  text-align: left;
+}
+
+.pulse-event-card.selected {
+  border-color: var(--border-accent);
+}
+
+.pulse-event-card span,
+.pulse-event-card small {
+  color: var(--text-secondary);
+}
+
+.pulse-detail-drawer {
+  border-left: 4px solid var(--border-accent);
+}
+
+.pulse-detail-grid {
+  display: grid;
+  gap: 10px;
+  margin: 0;
+}
+
+.pulse-detail-grid div {
+  background: var(--surface-muted);
+  border: 1px solid var(--border);
+  border-radius: 12px;
+  padding: 10px;
+}
+
+.pulse-detail-grid dt {
+  color: var(--accent);
+  font-size: 0.74rem;
+  font-weight: 900;
+  text-transform: uppercase;
+}
+
+.pulse-detail-grid dd {
+  color: var(--text-secondary);
+  margin: 3px 0 0;
+}
+
 .apps-surface .compact-notice {
   margin-bottom: 0;
 }
@@ -3817,11 +3931,26 @@ button.managed-toggle:focus-visible {
   .data-row,
   .editable-row,
   .managed-app-details,
+  .pulse-overview-layout,
   .pulse-activity-row,
   .provider-account-list li {
     grid-template-columns: 1fr;
   }
 
+  .pulse-chart-grid,
+  .pulse-filter-groups {
+    grid-template-columns: 1fr;
+  }
+
+  .pulse-activity-table {
+    display: none;
+  }
+
+  .pulse-card-stream {
+    display: grid;
+    gap: 10px;
+  }
+
   .pulse-activity-header {
     display: none;
   }
@@ -3836,6 +3965,20 @@ button.managed-toggle:focus-visible {
     font-weight: 900;
   }
 
+  .pulse-detail-drawer {
+    border-left: 0;
+    border-radius: 0;
+    margin-inline: -16px;
+  }
+
+  .pulse-detail-drawer::before {
+    color: var(--text-muted);
+    content: "Full-screen sheet layout on small screens";
+    font-size: 0.78rem;
+    font-weight: 900;
+    text-transform: uppercase;
+  }
+
   .pill-tabs {
     width: 100%;
   }

package/setup.sh

@@ -12,7 +12,7 @@ shopt -s inherit_errexit 2>/dev/null || true
 # AI Assistant Server Access Framework Setup Script
 # Helps developers set up the framework for their infrastructure
 #
-# Version: 3.29.39
+# Version: 3.29.40
 #
 # Quick Install:
 #   npm install -g aidevops && aidevops update          (recommended)