code-coordinator 0.5.46__py3-none-any.whl

coord/dashboard/webapp/src/components/ui/toast.tsx

@@ -0,0 +1,123 @@
+import * as React from 'react'
+import * as ToastPrimitives from '@radix-ui/react-toast'
+import { cva, type VariantProps } from 'class-variance-authority'
+import { X } from 'lucide-react'
+import { cn } from '@/lib/utils'
+
+const ToastProvider = ToastPrimitives.Provider
+
+const ToastViewport = React.forwardRef<
+  React.ElementRef<typeof ToastPrimitives.Viewport>,
+  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Viewport>
+>(({ className, ...props }, ref) => (
+  <ToastPrimitives.Viewport
+    ref={ref}
+    className={cn(
+      'fixed bottom-0 right-0 z-[100] flex max-h-screen w-full flex-col-reverse gap-2 p-4 sm:bottom-4 sm:right-4 sm:top-auto sm:max-w-[380px]',
+      className,
+    )}
+    {...props}
+  />
+))
+ToastViewport.displayName = ToastPrimitives.Viewport.displayName
+
+const toastVariants = cva(
+  'group pointer-events-auto relative flex w-full items-start justify-between gap-3 overflow-hidden rounded-md border p-4 shadow-elevation transition-all data-[swipe=cancel]:translate-x-0 data-[swipe=end]:translate-x-[var(--radix-toast-swipe-end-x)] data-[swipe=move]:translate-x-[var(--radix-toast-swipe-move-x)] data-[swipe=move]:transition-none data-[state=open]:animate-in data-[state=closed]:animate-out data-[swipe=end]:animate-out data-[state=closed]:fade-out-80 data-[state=closed]:slide-out-to-right-full data-[state=open]:slide-in-from-top-full data-[state=open]:sm:slide-in-from-bottom-full',
+  {
+    variants: {
+      variant: {
+        default: 'border-line-strong bg-popover text-popover-foreground',
+        success: 'border-pass bg-pass-wash text-pass',
+        warning: 'border-attn bg-attn-wash text-attn',
+        destructive: 'border-fail bg-fail-wash text-fail',
+      },
+    },
+    defaultVariants: {
+      variant: 'default',
+    },
+  },
+)
+
+const Toast = React.forwardRef<
+  React.ElementRef<typeof ToastPrimitives.Root>,
+  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Root> & VariantProps<typeof toastVariants>
+>(({ className, variant, ...props }, ref) => (
+  <ToastPrimitives.Root
+    ref={ref}
+    className={cn(toastVariants({ variant }), className)}
+    {...props}
+  />
+))
+Toast.displayName = ToastPrimitives.Root.displayName
+
+const ToastAction = React.forwardRef<
+  React.ElementRef<typeof ToastPrimitives.Action>,
+  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Action>
+>(({ className, ...props }, ref) => (
+  <ToastPrimitives.Action
+    ref={ref}
+    className={cn(
+      'inline-flex h-8 shrink-0 items-center justify-center rounded-sm border border-line-strong bg-transparent px-3 text-sm font-medium transition-colors hover:bg-secondary focus:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50',
+      className,
+    )}
+    {...props}
+  />
+))
+ToastAction.displayName = ToastPrimitives.Action.displayName
+
+const ToastClose = React.forwardRef<
+  React.ElementRef<typeof ToastPrimitives.Close>,
+  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Close>
+>(({ className, ...props }, ref) => (
+  <ToastPrimitives.Close
+    ref={ref}
+    className={cn(
+      'absolute right-2 top-2 rounded-sm p-1 text-current opacity-0 transition-opacity hover:opacity-100 focus:opacity-100 focus:outline-none focus-visible:ring-2 focus-visible:ring-ring group-hover:opacity-70',
+      className,
+    )}
+    toast-close=""
+    {...props}
+  >
+    <X className="h-4 w-4" />
+  </ToastPrimitives.Close>
+))
+ToastClose.displayName = ToastPrimitives.Close.displayName
+
+const ToastTitle = React.forwardRef<
+  React.ElementRef<typeof ToastPrimitives.Title>,
+  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Title>
+>(({ className, ...props }, ref) => (
+  <ToastPrimitives.Title
+    ref={ref}
+    className={cn('text-sm font-semibold', className)}
+    {...props}
+  />
+))
+ToastTitle.displayName = ToastPrimitives.Title.displayName
+
+const ToastDescription = React.forwardRef<
+  React.ElementRef<typeof ToastPrimitives.Description>,
+  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Description>
+>(({ className, ...props }, ref) => (
+  <ToastPrimitives.Description
+    ref={ref}
+    className={cn('text-sm opacity-90', className)}
+    {...props}
+  />
+))
+ToastDescription.displayName = ToastPrimitives.Description.displayName
+
+type ToastProps = React.ComponentPropsWithoutRef<typeof Toast>
+type ToastActionElement = React.ReactElement<typeof ToastAction>
+
+export {
+  type ToastProps,
+  type ToastActionElement,
+  ToastProvider,
+  ToastViewport,
+  Toast,
+  ToastTitle,
+  ToastDescription,
+  ToastClose,
+  ToastAction,
+}

coord/dashboard/webapp/src/components/ui/toaster.tsx

@@ -0,0 +1,30 @@
+import { useToast } from '@/components/ui/use-toast'
+import {
+  Toast,
+  ToastClose,
+  ToastDescription,
+  ToastProvider,
+  ToastTitle,
+  ToastViewport,
+} from '@/components/ui/toast'
+
+/** Mounted once at the app root (see App.tsx); renders whatever `toast()` (use-toast.ts) queues. */
+export function Toaster() {
+  const { toasts } = useToast()
+
+  return (
+    <ToastProvider>
+      {toasts.map(({ id, title, description, action, ...props }) => (
+        <Toast key={id} {...props}>
+          <div className="grid gap-1">
+            {title && <ToastTitle>{title}</ToastTitle>}
+            {description && <ToastDescription>{description}</ToastDescription>}
+          </div>
+          {action}
+          <ToastClose />
+        </Toast>
+      ))}
+      <ToastViewport />
+    </ToastProvider>
+  )
+}

coord/dashboard/webapp/src/components/ui/tooltip.tsx

@@ -0,0 +1,26 @@
+import * as React from 'react'
+import * as TooltipPrimitive from '@radix-ui/react-tooltip'
+import { cn } from '@/lib/utils'
+
+const TooltipProvider = TooltipPrimitive.Provider
+const Tooltip = TooltipPrimitive.Root
+const TooltipTrigger = TooltipPrimitive.Trigger
+
+const TooltipContent = React.forwardRef<
+  React.ElementRef<typeof TooltipPrimitive.Content>,
+  React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Content>
+>(({ className, sideOffset = 6, ...props }, ref) => (
+  <TooltipPrimitive.Content
+    ref={ref}
+    sideOffset={sideOffset}
+    className={cn(
+      'z-50 overflow-hidden rounded-sm border border-line-strong bg-popover px-2.5 py-1.5 text-xs text-popover-foreground shadow-elevation',
+      'data-[state=delayed-open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=delayed-open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=delayed-open]:zoom-in-95',
+      className,
+    )}
+    {...props}
+  />
+))
+TooltipContent.displayName = TooltipPrimitive.Content.displayName
+
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider }

coord/dashboard/webapp/src/components/ui/use-toast.ts

@@ -0,0 +1,134 @@
+// Adapted from shadcn/ui's toast hook (itself adapted from react-hot-toast) —
+// a module-level store outside React so any component can call `toast(...)`
+// without threading a context down, while `useToast()` still re-renders
+// subscribers (namely <Toaster/>) on change.
+import * as React from 'react'
+import type { ToastActionElement, ToastProps } from '@/components/ui/toast'
+
+const TOAST_LIMIT = 3
+const TOAST_REMOVE_DELAY = 4000
+
+type ToasterToast = ToastProps & {
+  id: string
+  title?: React.ReactNode
+  description?: React.ReactNode
+  action?: ToastActionElement
+}
+
+let count = 0
+
+function genId() {
+  count = (count + 1) % Number.MAX_SAFE_INTEGER
+  return count.toString()
+}
+
+type Action =
+  | { type: 'ADD_TOAST'; toast: ToasterToast }
+  | { type: 'UPDATE_TOAST'; toast: Partial<ToasterToast> }
+  | { type: 'DISMISS_TOAST'; toastId?: ToasterToast['id'] }
+  | { type: 'REMOVE_TOAST'; toastId?: ToasterToast['id'] }
+
+interface State {
+  toasts: ToasterToast[]
+}
+
+const toastTimeouts = new Map<string, ReturnType<typeof setTimeout>>()
+
+function addToRemoveQueue(toastId: string) {
+  if (toastTimeouts.has(toastId)) return
+
+  const timeout = setTimeout(() => {
+    toastTimeouts.delete(toastId)
+    dispatch({ type: 'REMOVE_TOAST', toastId })
+  }, TOAST_REMOVE_DELAY)
+
+  toastTimeouts.set(toastId, timeout)
+}
+
+export function reducer(state: State, action: Action): State {
+  switch (action.type) {
+    case 'ADD_TOAST':
+      return { ...state, toasts: [action.toast, ...state.toasts].slice(0, TOAST_LIMIT) }
+
+    case 'UPDATE_TOAST':
+      return {
+        ...state,
+        toasts: state.toasts.map(t => (t.id === action.toast.id ? { ...t, ...action.toast } : t)),
+      }
+
+    case 'DISMISS_TOAST': {
+      const { toastId } = action
+      if (toastId) {
+        addToRemoveQueue(toastId)
+      } else {
+        state.toasts.forEach(t => addToRemoveQueue(t.id))
+      }
+      return {
+        ...state,
+        toasts: state.toasts.map(t =>
+          t.id === toastId || toastId === undefined ? { ...t, open: false } : t,
+        ),
+      }
+    }
+
+    case 'REMOVE_TOAST':
+      if (action.toastId === undefined) {
+        return { ...state, toasts: [] }
+      }
+      return { ...state, toasts: state.toasts.filter(t => t.id !== action.toastId) }
+
+    default:
+      return state
+  }
+}
+
+const listeners: Array<(state: State) => void> = []
+let memoryState: State = { toasts: [] }
+
+function dispatch(action: Action) {
+  memoryState = reducer(memoryState, action)
+  listeners.forEach(listener => listener(memoryState))
+}
+
+type Toast = Omit<ToasterToast, 'id'>
+
+function toast({ ...props }: Toast) {
+  const id = genId()
+
+  const update = (props: ToasterToast) => dispatch({ type: 'UPDATE_TOAST', toast: { ...props, id } })
+  const dismiss = () => dispatch({ type: 'DISMISS_TOAST', toastId: id })
+
+  dispatch({
+    type: 'ADD_TOAST',
+    toast: {
+      ...props,
+      id,
+      open: true,
+      onOpenChange: (open: boolean) => {
+        if (!open) dismiss()
+      },
+    },
+  })
+
+  return { id, dismiss, update }
+}
+
+function useToast() {
+  const [state, setState] = React.useState<State>(memoryState)
+
+  React.useEffect(() => {
+    listeners.push(setState)
+    return () => {
+      const index = listeners.indexOf(setState)
+      if (index > -1) listeners.splice(index, 1)
+    }
+  }, [])
+
+  return {
+    ...state,
+    toast,
+    dismiss: (toastId?: string) => dispatch({ type: 'DISMISS_TOAST', toastId }),
+  }
+}
+
+export { useToast, toast }

coord/dashboard/webapp/src/index.css

@@ -0,0 +1,210 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+/*
+ * coord web — design tokens (#1546)
+ *
+ * The raw palette below is copied verbatim from the Gate-A design mocks'
+ * shared reference, docs/mocks/web/_tokens.css — that file says explicitly
+ * it is "the seed for W1-1's real token layer." Keep the two in sync; if a
+ * value changes here, change it there too (or vice versa).
+ *
+ * Dark is the default and the preferred reading mode; light is a real,
+ * designed second theme, not a mechanical inversion. Both are switched by
+ * `data-theme` on <html> (see src/components/theme-provider.tsx) rather
+ * than Tailwind's `dark:` class variant, because that's what the mocks
+ * already do and what avoids a flash of the wrong theme (the attribute is
+ * set by a blocking inline script in index.html before paint).
+ *
+ * A second layer of semantic aliases (--background, --foreground, --card,
+ * --primary, ...) maps the raw palette onto the shadcn/ui vocabulary that
+ * ui/* primitives and pre-existing components (PipelineCard,
+ * ConnectionBadge, MobileKeyBar) consume — see tailwind.config.js for the
+ * full rationale, including why shadcn's `accent` slot is kept pointed at
+ * a neutral hover surface instead of the mock's cyan "brand" accent.
+ */
+
+@layer base {
+  :root {
+    /* ── raw palette — type ──────────────────────────────────────────── */
+    --font-ui: ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto,
+      'Helvetica Neue', Arial, sans-serif;
+    /* mono is reserved for values the machine owns: issue numbers,
+       branches, SHAs, machine names, durations, costs. Never for chrome. */
+    --font-mono: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas,
+      'Liberation Mono', monospace;
+
+    --step--1: 0.75rem;
+    --step-0: 0.875rem;
+    --step-1: 1rem;
+    --step-2: 1.25rem;
+    --step-3: 1.5rem;
+
+    /* ── raw palette — geometry ──────────────────────────────────────── */
+    --r-sm: 5px;
+    --r-md: 8px;
+    --r-lg: 12px;
+
+    --rail-w: 216px;
+    --rail-w-collapsed: 60px;
+    --panel-w: 360px;
+  }
+
+  /* `:root` carries the dark values too (dark is the default, and it's the
+     fallback if `data-theme` is ever missing) -- but the SAME selector list
+     also includes the bare `[data-theme='dark']` attribute, not just
+     `:root[data-theme='dark']`. That's deliberate: it's what lets a nested
+     subtree (e.g. the gallery's side-by-side theme preview,
+     src/components/Gallery.tsx) force dark back on, even inside a page
+     whose <html> is already light -- a plain `:root` rule only ever matches
+     the root element, so without this a nested `data-theme="dark"` div
+     would have no rule to reset it and would just inherit light. */
+  :root,
+  [data-theme='dark'] {
+    /* ── raw palette — ground & surfaces ──────────────────────────── */
+    --ground: #101418;
+    --surface: #171c22;
+    --surface-2: #1e242b;
+    --surface-3: #252d36;
+    --line: #2a323b;
+    --line-strong: #3a444f;
+
+    /* ── raw palette — text ──────────────────────────────────────────── */
+    --text: #dfe6ee;
+    --text-dim: #8b97a5;
+    --text-faint: #5f6b78;
+
+    /* ── raw palette — accent: "work is happening here" ────────────────
+       Below AA (~3.4:1) against --ground; see the README note under
+       `.text-faint` usage in the gallery for why that's an intentional,
+       carried-over Gate-A choice rather than an oversight. */
+    --accent: #4fb8cf;
+    --accent-dim: #2d7688;
+    --accent-wash: rgba(79, 184, 207, 0.12);
+
+    /* ── raw palette — semantic state (deliberately desaturated) ──────── */
+    --pass: #4ea87a;
+    --pass-wash: rgba(78, 168, 122, 0.14);
+    --attn: #d9a54c;
+    --attn-wash: rgba(217, 165, 76, 0.14);
+    --fail: #d9605e;
+    --fail-wash: rgba(217, 96, 94, 0.14);
+    --idle: #55606d;
+    --idle-wash: rgba(85, 96, 109, 0.14);
+
+    /* ── semantic aliases (shadcn/ui vocabulary) ────────────────────── */
+    --background: var(--ground);
+    --foreground: var(--text);
+
+    --card: var(--surface);
+    --card-foreground: var(--text);
+    --popover: var(--surface-2);
+    --popover-foreground: var(--text);
+
+    --primary: var(--accent);
+    --primary-foreground: #08161a;
+    --secondary: var(--surface-2);
+    --secondary-foreground: var(--text);
+    --muted: var(--surface-2);
+    --muted-foreground: var(--text-dim);
+
+    /* Neutral hover/press highlight — NOT the brand cyan. Existing
+       components (e.g. MobileKeyBar's `active:bg-accent`) already depend
+       on this meaning; see tailwind.config.js. */
+    --accent-surface: var(--surface-2);
+    --accent-surface-foreground: var(--text);
+
+    --destructive: var(--fail);
+    --destructive-foreground: #ffffff;
+
+    --border: var(--line);
+    --input: var(--line);
+    --ring: var(--accent);
+    --radius: var(--r-md);
+  }
+
+  /* Not scoped to :root: same reasoning as `[data-theme='dark']` above. */
+  [data-theme='light'] {
+    --ground: #f5f7f9;
+    --surface: #ffffff;
+    --surface-2: #eef1f5;
+    --surface-3: #e3e8ee;
+    --line: #dde3ea;
+    --line-strong: #c3ccd6;
+
+    --text: #1a212a;
+    --text-dim: #5b6672;
+    --text-faint: #8a95a1;
+
+    --accent: #1d7f96;
+    --accent-dim: #8fc9d6;
+    --accent-wash: rgba(29, 127, 150, 0.1);
+
+    --pass: #2f7d55;
+    --pass-wash: rgba(47, 125, 85, 0.11);
+    --attn: #a4741d;
+    --attn-wash: rgba(164, 116, 29, 0.12);
+    --fail: #b8403e;
+    --fail-wash: rgba(184, 64, 62, 0.11);
+    --idle: #97a1ac;
+    --idle-wash: rgba(151, 161, 172, 0.14);
+
+    /* ── semantic aliases — redeclared, not inherited ─────────────────
+       Custom properties resolve `var(--x)` against the *declaring*
+       element, then inherit the already-resolved value -- a descendant
+       that overrides --ground doesn't retroactively change what an
+       ancestor's `--background: var(--ground)` computed to. So every
+       alias needs restating here against the raw tokens just set above,
+       or `bg-background`/`text-foreground`/etc. would silently keep
+       whatever the dark block resolved them to. (Learned by screenshotting
+       the gallery's side-by-side preview mid-build: without this, the
+       "light" pane rendered with dark colours.) */
+    --background: var(--ground);
+    --foreground: var(--text);
+
+    --card: var(--surface);
+    --card-foreground: var(--text);
+    --popover: var(--surface-2);
+    --popover-foreground: var(--text);
+
+    --primary: var(--accent);
+    /* Light theme's --accent is a darker teal than dark theme's bright
+       cyan, so the button text that sits on top of it needs to flip from
+       dark ink to white to keep 4.5:1 contrast (measured ~4.6:1 white vs
+       ~4.0:1 black). */
+    --primary-foreground: #ffffff;
+    --secondary: var(--surface-2);
+    --secondary-foreground: var(--text);
+    --muted: var(--surface-2);
+    --muted-foreground: var(--text-dim);
+
+    --accent-surface: var(--surface-2);
+    --accent-surface-foreground: var(--text);
+
+    --destructive: var(--fail);
+    --destructive-foreground: #ffffff;
+
+    --border: var(--line);
+    --input: var(--line);
+    --ring: var(--accent);
+  }
+}
+
+@layer base {
+  * {
+    @apply border-border;
+  }
+  body {
+    @apply bg-background text-foreground;
+    font-family: var(--font-ui);
+    -webkit-font-smoothing: antialiased;
+    -moz-osx-font-smoothing: grayscale;
+  }
+  /* Matches the mocks' `.mono` convenience class: tabular figures so
+     durations/costs/ids don't jitter as digits change. */
+  .mono {
+    font-family: var(--font-mono);
+    font-variant-numeric: tabular-nums;
+  }
+}

coord/dashboard/webapp/src/lib/pipeline.ts

@@ -0,0 +1,29 @@
+/**
+ * Pipeline predicates shared between the Pipeline panel and the shell.
+ *
+ * Lifted out of `Home.tsx` (#1547) because the activity rail needs the same
+ * two answers Home's filter tabs need — how many items are in flight, and how
+ * many are waiting on a human — and a second, independently-drifting copy of
+ * "what counts as active" in the rail would be a lie the moment either
+ * definition changed.
+ */
+import type { PipelineView } from '@/api/client'
+
+/**
+ * "Active": items that haven't finished (current_stage !== "merged").
+ * Keeps the list (and the rail count) focused on in-flight work without
+ * cluttering with history.
+ */
+export function isActive(view: PipelineView): boolean {
+  return view.current_stage !== 'merged'
+}
+
+/**
+ * "Needs me": items where at least one human gate action is available.
+ * E.g.: work done (needs test dispatch), review approved (needs merge queue),
+ * smoke passed (needs merge queue), merge ready (needs merge), failures (need
+ * retry/fix).
+ */
+export function needsMe(view: PipelineView): boolean {
+  return view.available_gates.length > 0
+}

coord/dashboard/webapp/src/lib/utils.ts

@@ -0,0 +1,6 @@
+import { type ClassValue, clsx } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

coord/dashboard/webapp/src/main.tsx

@@ -0,0 +1,46 @@
+import React from 'react'
+import ReactDOM from 'react-dom/client'
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
+import App from './App'
+import { RealtimeProvider } from './realtime/RealtimeProvider'
+import './index.css'
+
+const queryClient = new QueryClient({
+  defaultOptions: {
+    queries: {
+      // #1549: no timer-based polling. The SSE `/events` stream
+      // (RealtimeProvider) invalidates exactly the query keys each server
+      // event affects, and a stream recovery (reconnecting -> live) triggers
+      // an explicit resync -- see src/realtime/events.ts. Data is therefore
+      // fresh until something says otherwise, which `refetchOnWindowFocus`'s
+      // default (true) still backstops for a tab that was backgrounded long
+      // enough to miss its own reconnect.
+      //
+      // Footgun for the next query added to this app: `staleTime: Infinity`
+      // is a *global* default. A `useQuery` whose key isn't wired into
+      // `EVENT_QUERY_KEYS` (src/realtime/events.ts) or manually invalidated
+      // elsewhere will never refetch on its own -- only `refetchOnWindowFocus`
+      // (or an explicit `invalidateQueries` call, e.g. Detail.tsx's actions)
+      // will ever refresh it. If you add a query, add its invalidation path
+      // in the same PR.
+      staleTime: Infinity,
+      // Retry once on error before surfacing the failure state
+      retry: 1,
+    },
+  },
+})
+
+// Register service worker (vite-plugin-pwa injects this at build time)
+// In dev mode the import is a no-op stub from the virtual module.
+import { registerSW } from 'virtual:pwa-register'
+registerSW({ immediate: true })
+
+ReactDOM.createRoot(document.getElementById('root') as HTMLElement).render(
+  <React.StrictMode>
+    <QueryClientProvider client={queryClient}>
+      <RealtimeProvider>
+        <App />
+      </RealtimeProvider>
+    </QueryClientProvider>
+  </React.StrictMode>,
+)