shipwright-cli 2.2.2 → 2.3.1

package/dashboard/src/design/tokens.ts

@@ -0,0 +1,160 @@
+// Design System Tokens
+// Single source of truth for colors, typography, spacing, shadows, animations, and z-index.
+// CSS custom properties mirror these values; Canvas2D code reads from here directly.
+
+export const colors = {
+  bg: {
+    abyss: "#060a14",
+    deep: "#0a1628",
+    ocean: "#0d1f3c",
+    surface: "#132d56",
+    foam: "#1a3a6a",
+  },
+  accent: {
+    cyan: "#00d4ff",
+    cyanGlow: "rgba(0, 212, 255, 0.15)",
+    cyanDim: "rgba(0, 212, 255, 0.4)",
+    purple: "#7c3aed",
+    purpleGlow: "rgba(124, 58, 237, 0.15)",
+    blue: "#0066ff",
+  },
+  semantic: {
+    success: "#4ade80",
+    warning: "#fbbf24",
+    error: "#f43f5e",
+  },
+  text: {
+    primary: "#e8ecf4",
+    secondary: "#8899b8",
+    muted: "#5a6d8a",
+  },
+} as const;
+
+export const fonts = {
+  display: "'Instrument Serif', Georgia, serif",
+  body: "'Plus Jakarta Sans', system-ui, sans-serif",
+  mono: "'JetBrains Mono', 'SF Mono', monospace",
+} as const;
+
+export const typeScale = {
+  display: { size: 32, weight: 400, family: fonts.display },
+  heading: { size: 24, weight: 400, family: fonts.display },
+  title: { size: 20, weight: 600, family: fonts.body },
+  body: { size: 14, weight: 400, family: fonts.body },
+  caption: { size: 12, weight: 500, family: fonts.body },
+  tiny: { size: 11, weight: 400, family: fonts.body },
+  mono: { size: 13, weight: 400, family: fonts.mono },
+  monoSm: { size: 11, weight: 400, family: fonts.mono },
+} as const;
+
+export const spacing: Record<number, number> = {
+  0: 0,
+  1: 4,
+  2: 8,
+  3: 12,
+  4: 16,
+  5: 20,
+  6: 24,
+  8: 32,
+  10: 40,
+  12: 48,
+  16: 64,
+};
+
+export const radius = {
+  sm: 4,
+  md: 8,
+  lg: 12,
+  xl: 16,
+  full: 9999,
+} as const;
+
+export const shadows = {
+  glow: {
+    cyan: "0 0 20px rgba(0, 212, 255, 0.15)",
+    purple: "0 0 20px rgba(124, 58, 237, 0.15)",
+    success: "0 0 12px rgba(74, 222, 128, 0.2)",
+    error: "0 0 12px rgba(244, 63, 94, 0.2)",
+  },
+  elevated: "0 8px 32px rgba(0, 0, 0, 0.4)",
+} as const;
+
+export const duration = {
+  fast: 150,
+  base: 300,
+  slow: 500,
+  glacial: 1000,
+} as const;
+
+export const easing = {
+  default: "ease",
+  smooth: "cubic-bezier(0.4, 0, 0.2, 1)",
+  spring: "cubic-bezier(0.34, 1.56, 0.64, 1)",
+} as const;
+
+export const zIndex = {
+  base: 1,
+  dropdown: 10,
+  sticky: 20,
+  overlay: 30,
+  modal: 40,
+  toast: 50,
+} as const;
+
+export const STAGES = [
+  "intake",
+  "plan",
+  "design",
+  "build",
+  "test",
+  "review",
+  "compound_quality",
+  "pr",
+  "merge",
+  "deploy",
+  "monitor",
+] as const;
+
+export type StageName = (typeof STAGES)[number];
+
+export const STAGE_SHORT: Record<StageName, string> = {
+  intake: "INT",
+  plan: "PLN",
+  design: "DSN",
+  build: "BLD",
+  test: "TST",
+  review: "REV",
+  compound_quality: "QA",
+  pr: "PR",
+  merge: "MRG",
+  deploy: "DPL",
+  monitor: "MON",
+};
+
+export const STAGE_COLORS: string[] = [
+  "c-cyan",
+  "c-blue",
+  "c-purple",
+  "c-green",
+  "c-amber",
+  "c-cyan",
+  "c-blue",
+  "c-purple",
+  "c-green",
+  "c-amber",
+  "c-cyan",
+];
+
+export const STAGE_HEX: Record<StageName, string> = {
+  intake: "#00d4ff",
+  plan: "#0066ff",
+  design: "#7c3aed",
+  build: "#4ade80",
+  test: "#fbbf24",
+  review: "#00d4ff",
+  compound_quality: "#0066ff",
+  pr: "#7c3aed",
+  merge: "#4ade80",
+  deploy: "#fbbf24",
+  monitor: "#00d4ff",
+};

package/dashboard/src/main.ts

@@ -0,0 +1,68 @@
+// Fleet Command Dashboard - Main Entry Point
+// Boots WebSocket, router, header, modals, and registers all views
+
+import { connect } from "./core/ws";
+import { store } from "./core/state";
+import { setupRouter, registerView } from "./core/router";
+import {
+  setupHeader,
+  renderCostTicker,
+  renderAlertBanner,
+  updateEmergencyBrakeVisibility,
+  updateAmbientIndicator,
+  detectCompletions,
+} from "./components/header";
+import { setupInterventionModal, setupBulkActions } from "./components/modal";
+
+// Views
+import { overviewView } from "./views/overview";
+import { agentsView } from "./views/agents";
+import { pipelinesView } from "./views/pipelines";
+import { timelineView } from "./views/timeline";
+import { activityView } from "./views/activity";
+import { metricsView } from "./views/metrics";
+import { machinesView } from "./views/machines";
+import { insightsView } from "./views/insights";
+import { teamView } from "./views/team";
+
+// New visualization views (lazy-loaded when tabs exist)
+import { fleetMapView } from "./views/fleet-map";
+import { pipelineTheaterView } from "./views/pipeline-theater";
+import { agentCockpitView } from "./views/agent-cockpit";
+
+// Register all views
+registerView("overview", overviewView);
+registerView("agents", agentsView);
+registerView("pipelines", pipelinesView);
+registerView("timeline", timelineView);
+registerView("activity", activityView);
+registerView("metrics", metricsView);
+registerView("machines", machinesView);
+registerView("insights", insightsView);
+registerView("team", teamView);
+registerView("fleet-map", fleetMapView);
+registerView("pipeline-theater", pipelineTheaterView);
+registerView("agent-cockpit", agentCockpitView);
+
+// Setup header (user menu, daemon control, emergency brake)
+setupHeader();
+
+// Setup shared modals
+setupInterventionModal();
+setupBulkActions();
+
+// Setup tab routing
+setupRouter();
+
+// Subscribe to fleet state for global UI updates
+store.subscribe("fleetState", (data) => {
+  if (!data) return;
+  renderCostTicker(data);
+  renderAlertBanner(data);
+  updateEmergencyBrakeVisibility(data);
+  updateAmbientIndicator(data);
+  detectCompletions(data);
+});
+
+// Connect WebSocket
+connect();

package/dashboard/src/types/api.ts

@@ -0,0 +1,337 @@
+// Shared TypeScript interfaces for all API responses
+// These types mirror the actual shapes returned by dashboard/server.ts
+
+export interface DaemonInfo {
+  running: boolean;
+  pid: number | null;
+  uptime_s: number;
+  maxParallel: number;
+  pollInterval: number;
+}
+
+export interface PipelineInfo {
+  issue: number;
+  title: string;
+  stage: string;
+  stagesDone: string[];
+  elapsed_s: number;
+  worktree?: string;
+  iteration: number;
+  maxIterations: number;
+  linesWritten?: number;
+  testsPassing?: boolean;
+  cost?: number;
+  branch?: string;
+  status?: string;
+}
+
+export interface QueueItem {
+  issue: number;
+  title: string;
+  score?: number;
+  estimated_cost?: number;
+  factors?: ScoringFactors;
+}
+
+export interface ScoringFactors {
+  complexity?: number;
+  impact?: number;
+  priority?: number;
+  age?: number;
+  dependency?: number;
+  memory?: number;
+}
+
+export interface EventItem {
+  ts?: string;
+  timestamp?: string;
+  type: string;
+  issue?: number;
+  issueTitle?: string;
+  title?: string;
+  duration_s?: number;
+  stage?: string;
+  result?: string;
+  [key: string]: unknown;
+}
+
+export interface ScaleInfo {
+  from?: number;
+  to?: number;
+  cpuCores?: number;
+  maxByCpu?: number;
+  maxByMem?: number;
+  maxByBudget?: number;
+  availMemGb?: number;
+}
+
+export interface MetricsSummary {
+  completed?: number;
+  failed?: number;
+  cpuCores?: number;
+}
+
+export interface CostInfo {
+  today_spent: number;
+  daily_budget: number;
+  pct_used: number;
+}
+
+export interface DoraMetric {
+  value: number;
+  unit: string;
+  grade: string;
+}
+
+export interface DoraGrades {
+  deploy_freq: DoraMetric;
+  lead_time: DoraMetric;
+  cfr: DoraMetric;
+  mttr: DoraMetric;
+}
+
+export interface AgentInfo {
+  id: string;
+  issue: number;
+  title: string;
+  machine: string;
+  stage: string;
+  iteration: number;
+  activity: string;
+  memory_mb: number;
+  cpu_pct: number;
+  status: "active" | "idle" | "stale" | "dead";
+  heartbeat_age_s: number;
+  started_at: string;
+  elapsed_s: number;
+}
+
+export interface FleetState {
+  timestamp: string;
+  daemon: DaemonInfo;
+  pipelines: PipelineInfo[];
+  queue: QueueItem[];
+  events: EventItem[];
+  scale: ScaleInfo;
+  metrics: MetricsSummary;
+  agents: AgentInfo[];
+  machines: MachineInfo[];
+  cost: CostInfo;
+  dora: DoraGrades;
+  team?: TeamData;
+}
+
+export interface CostBreakdown {
+  by_model?: Record<string, number>;
+  by_stage?: Record<string, number>;
+  by_issue?: Array<{ issue: number; cost: number }>;
+  budget?: number;
+  spent?: number;
+}
+
+export interface StageHistoryEntry {
+  stage: string;
+  duration_s: number;
+  ts: string;
+}
+
+export interface PipelineDetail {
+  issue: number;
+  title: string;
+  stage: string;
+  stageHistory: StageHistoryEntry[];
+  plan: string;
+  design: string;
+  dod: string;
+  intake: Record<string, unknown> | null;
+  elapsed_s: number;
+  branch: string;
+  prLink: string;
+}
+
+export interface TimelineEntry {
+  issue: number;
+  title: string;
+  segments: TimelineSegment[];
+}
+
+export interface TimelineSegment {
+  stage: string;
+  start: string;
+  end: string | null;
+  status: "complete" | "running" | "failed";
+}
+
+export interface MetricsData {
+  success_rate: number;
+  avg_duration_s: number;
+  throughput_per_hour: number;
+  total_completed: number;
+  total_failed: number;
+  stage_durations: Record<string, number>;
+  daily_counts: DailyCount[];
+  dora_grades: DoraGrades;
+}
+
+export interface DailyCount {
+  date: string;
+  completed: number;
+  failed: number;
+}
+
+export interface DoraMetrics {
+  deploy_freq?: DoraMetric;
+  lead_time?: DoraMetric;
+  cfr?: DoraMetric;
+  mttr?: DoraMetric;
+}
+
+export interface MachineInfo {
+  name: string;
+  host: string;
+  role: string;
+  max_workers: number;
+  active_workers: number;
+  registered_at: string;
+  ssh_user?: string;
+  shipwright_path?: string;
+  status: "online" | "degraded" | "offline";
+  health: MachineHealth;
+  join_token?: string;
+}
+
+export interface MachineHealth {
+  daemon_running: boolean;
+  heartbeat_count: number;
+  last_heartbeat_s_ago: number;
+}
+
+export interface JoinToken {
+  label: string;
+  created_at?: string;
+  used?: boolean;
+  token?: string;
+}
+
+export interface InsightsData {
+  patterns: FailurePattern[] | null;
+  decisions: Decision[] | null;
+  patrol: PatrolFinding[] | null;
+  heatmap: HeatmapData | null;
+  globalLearnings: Array<Record<string, unknown>> | null;
+}
+
+export interface FailurePattern {
+  description?: string;
+  pattern?: string;
+  frequency?: number;
+  count?: number;
+  root_cause?: string;
+  fix?: string;
+  suggested_fix?: string;
+}
+
+export interface Decision {
+  timestamp?: string;
+  ts?: string;
+  action?: string;
+  decision?: string;
+  outcome?: string;
+  result?: string;
+  issue?: number;
+}
+
+export interface PatrolFinding {
+  severity?: string;
+  type?: string;
+  category?: string;
+  description?: string;
+  message?: string;
+  file?: string;
+}
+
+// Heatmap from server: { heatmap: Record<stage, Record<date, count>> }
+export interface HeatmapData {
+  heatmap: Record<string, Record<string, number>>;
+}
+
+export interface DaemonConfig {
+  paused?: boolean;
+  config?: Record<string, unknown>;
+  budget?: Record<string, unknown>;
+}
+
+export interface AlertInfo {
+  severity: string;
+  message: string;
+  type?: string;
+  issue?: number;
+  actions?: string[];
+}
+
+export interface TeamData {
+  total_online?: number;
+  total_active_pipelines?: number;
+  total_queued?: number;
+  developers?: TeamDeveloper[];
+}
+
+export interface TeamDeveloper {
+  developer_id: string;
+  machine_name: string;
+  hostname?: string;
+  platform?: string;
+  last_heartbeat?: number;
+  daemon_running: boolean;
+  daemon_pid?: number | null;
+  active_jobs: Array<{ issue: number; title?: string; stage?: string }>;
+  queued: number[];
+  events_since?: number;
+  _presence?: string;
+}
+
+export interface TeamActivityEvent {
+  ts?: string;
+  type: string;
+  issue?: number;
+  from_developer?: string;
+  stage?: string;
+  result?: string;
+}
+
+export interface StagePerformance {
+  name?: string;
+  stage?: string;
+  avg_s: number;
+  min_s?: number;
+  max_s?: number;
+  count: number;
+  trend_pct?: number;
+}
+
+export interface UserInfo {
+  username?: string;
+  avatarUrl?: string;
+  isAdmin?: boolean;
+  role?: "viewer" | "operator" | "admin";
+}
+
+export type TabId =
+  | "overview"
+  | "agents"
+  | "pipelines"
+  | "timeline"
+  | "activity"
+  | "metrics"
+  | "machines"
+  | "insights"
+  | "team"
+  | "fleet-map"
+  | "pipeline-theater"
+  | "agent-cockpit";
+
+export interface View {
+  init(): void;
+  render(state: FleetState): void;
+  destroy(): void;
+}