Initial commit — Director app (API + UI)

2026-04-07 15:18:16 -05:00
commit 5f29db67f3
44 changed files with 6727 additions and 0 deletions
--- a/ui/src/App.tsx
+++ b/ui/src/App.tsx
@@ -0,0 +1,141 @@
+import { useEffect, useState, useCallback } from 'react'
+import { api } from './lib/api'
+import type { Plan, Agent, QueueItem, PendingQuestion } from './lib/api'
+import { useWebSocket } from './hooks/useWebSocket'
+import { AgentStatus } from './components/AgentStatus'
+import { PlanBoard } from './components/PlanBoard'
+import { DirectorQueue } from './components/DirectorQueue'
+import { PendingQuestions } from './components/PendingQuestions'
+import { PlanDetail } from './components/PlanDetail'
+import { NewPlanModal } from './components/NewPlanModal'
+import { ClaudeModeToggle } from './components/ClaudeModeToggle'
+
+type RightTab = 'queue' | 'questions'
+
+function App() {
+  const [plans, setPlans] = useState<Plan[]>([])
+  const [agents, setAgents] = useState<Agent[]>([])
+  const [queue, setQueue] = useState<QueueItem[]>([])
+  const [questions, setQuestions] = useState<PendingQuestion[]>([])
+  const [rightTab, setRightTab] = useState<RightTab>('queue')
+  const [selectedPlan, setSelectedPlan] = useState<Plan | null>(null)
+  const [reviewItem, setReviewItem] = useState<QueueItem | null>(null)
+  const [showNewPlan, setShowNewPlan] = useState(false)
+  const [connected, setConnected] = useState(false)
+
+  const loadData = useCallback(() => {
+    api.plans.list().then(setPlans).catch(() => {})
+    api.agents.list().then(setAgents).catch(() => {})
+    api.queue.list().then(setQueue).catch(() => {})
+    api.questions.list().then(setQuestions).catch(() => {})
+  }, [])
+
+  useEffect(() => {
+    loadData()
+  }, [loadData])
+
+  useWebSocket(useCallback((event: string, _data: unknown) => {
+    if (event.startsWith('plan:')) loadData()
+    if (event.startsWith('task:')) loadData()
+    if (event.startsWith('agent:')) api.agents.list().then(setAgents)
+    if (event.startsWith('queue:')) api.queue.list().then(setQueue)
+    if (event.startsWith('question:')) api.questions.list().then(setQuestions)
+    if (event.startsWith('message:')) loadData()
+    setConnected(true)
+  }, [loadData]))
+
+  const handleReview = useCallback(async (item: QueueItem) => {
+    if (!item.plan_id) return
+    try {
+      const plan = await api.plans.get(item.plan_id)
+      setReviewItem(item)
+      setSelectedPlan(plan)
+    } catch (err) {
+      console.error('failed to load plan for review', err)
+    }
+  }, [])
+
+  const closeDetail = useCallback(() => {
+    setSelectedPlan(null)
+    setReviewItem(null)
+  }, [])
+
+  return (
+    <div className="min-h-screen bg-gray-100 dark:bg-gray-900 text-gray-900 dark:text-gray-100">
+      <header className="bg-white dark:bg-gray-800 border-b border-gray-200 dark:border-gray-700 px-6 py-3">
+        <div className="flex items-center justify-between max-w-7xl mx-auto">
+          <h1 className="font-display text-xl font-medium">Director</h1>
+          <div className="flex items-center gap-3">
+            <ClaudeModeToggle />
+            <button
+              onClick={() => setShowNewPlan(true)}
+              className="text-sm px-3 py-1.5 rounded bg-blue-600 hover:bg-blue-700 text-white cursor-pointer"
+            >
+              + New Plan
+            </button>
+            <span className={`w-2 h-2 rounded-full ${connected ? 'bg-green-500' : 'bg-red-500'}`} />
+            <span className="text-xs text-gray-500">{connected ? 'Connected' : 'Disconnected'}</span>
+          </div>
+        </div>
+      </header>
+
+      <main className="max-w-7xl mx-auto p-6 space-y-6">
+        <div className="grid grid-cols-1 lg:grid-cols-3 gap-6">
+          <div className="lg:col-span-1">
+            <AgentStatus agents={agents} />
+          </div>
+          <div className="lg:col-span-2">
+            {/* Tab toggle for queue vs questions */}
+            <div className="flex items-center gap-1 mb-3">
+              <button
+                onClick={() => setRightTab('queue')}
+                className={`font-mono text-[10px] uppercase tracking-wider px-3 py-1.5 rounded-md transition-colors cursor-pointer ${
+                  rightTab === 'queue'
+                    ? 'bg-blue-600 text-white'
+                    : 'text-gray-600 dark:text-gray-400 hover:bg-gray-200 dark:hover:bg-gray-800'
+                }`}
+              >
+                queue
+                {queue.length > 0 && (
+                  <span className="ml-1.5 tabular">{queue.length}</span>
+                )}
+              </button>
+              <button
+                onClick={() => setRightTab('questions')}
+                className={`font-mono text-[10px] uppercase tracking-wider px-3 py-1.5 rounded-md transition-colors cursor-pointer ${
+                  rightTab === 'questions'
+                    ? 'bg-blue-600 text-white'
+                    : 'text-gray-600 dark:text-gray-400 hover:bg-gray-200 dark:hover:bg-gray-800'
+                } ${questions.length > 0 && rightTab !== 'questions' ? 'ring-1 ring-amber-400' : ''}`}
+              >
+                questions
+                {questions.length > 0 && (
+                  <span className="ml-1.5 tabular">{questions.length}</span>
+                )}
+              </button>
+            </div>
+
+            {rightTab === 'queue' && <DirectorQueue items={queue} onReview={handleReview} />}
+            {rightTab === 'questions' && <PendingQuestions questions={questions} onChange={loadData} />}
+          </div>
+        </div>
+
+        <PlanBoard plans={plans} onSelect={setSelectedPlan} />
+      </main>
+
+      {selectedPlan && (
+        <PlanDetail
+          plan={selectedPlan}
+          onClose={closeDetail}
+          reviewItem={reviewItem ?? undefined}
+          onReviewActioned={loadData}
+        />
+      )}
+      {showNewPlan && (
+        <NewPlanModal onClose={() => setShowNewPlan(false)} onCreated={loadData} />
+      )}
+    </div>
+  )
+}
+
+export default App
--- a/ui/src/assets/hero.png
+++ b/ui/src/assets/hero.png
--- a/ui/src/assets/react.svg
+++ b/ui/src/assets/react.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="35.93" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228"><path fill="#00D8FF" d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path></svg>
--- a/ui/src/assets/vite.svg
+++ b/ui/src/assets/vite.svg
--- a/ui/src/components/AgentStatus.tsx
+++ b/ui/src/components/AgentStatus.tsx
@@ -0,0 +1,41 @@
+import type { Agent } from '../lib/api'
+
+const statusColors: Record<string, string> = {
+  idle: 'bg-gray-400',
+  working: 'bg-green-500',
+  blocked: 'bg-yellow-500',
+  error: 'bg-red-500',
+  offline: 'bg-gray-700',
+}
+
+const providerBadge: Record<string, string> = {
+  ollama: 'bg-blue-100 text-blue-800 dark:bg-blue-900 dark:text-blue-200',
+  anthropic: 'bg-orange-100 text-orange-800 dark:bg-orange-900 dark:text-orange-200',
+}
+
+export function AgentStatus({ agents }: { agents: Agent[] }) {
+  return (
+    <div className="rounded-lg border border-gray-200 dark:border-gray-700 bg-white dark:bg-gray-800 p-4">
+      <div className="flex items-center gap-2 mb-3">
+        <h2 className="text-lg font-semibold text-gray-900 dark:text-gray-100">Agents</h2>
+      </div>
+      <div className="space-y-2">
+        {agents.map((agent) => (
+          <div key={agent.id} className="flex items-center justify-between p-2 rounded bg-gray-50 dark:bg-gray-750">
+            <div className="flex items-center gap-2">
+              <span className={`w-2 h-2 rounded-full ${statusColors[agent.status] ?? 'bg-gray-400'}`} />
+              <span className="font-medium text-sm text-gray-900 dark:text-gray-100">{agent.name}</span>
+              <span className="text-xs text-gray-500">{agent.role}</span>
+            </div>
+            <div className="flex items-center gap-2">
+              <span className={`text-xs px-1.5 py-0.5 rounded ${providerBadge[agent.model_provider] ?? 'bg-gray-100'}`}>
+                {agent.model_provider}
+              </span>
+              <span className="text-xs text-gray-400">{agent.status}</span>
+            </div>
+          </div>
+        ))}
+      </div>
+    </div>
+  )
+}
--- a/ui/src/components/ClaudeModeToggle.tsx
+++ b/ui/src/components/ClaudeModeToggle.tsx
@@ -0,0 +1,48 @@
+import { useEffect, useState } from 'react'
+import { api } from '../lib/api'
+
+export function ClaudeModeToggle() {
+  const [mode, setMode] = useState<'api' | 'proxy' | 'unknown'>('unknown')
+  const [busy, setBusy] = useState(false)
+
+  useEffect(() => {
+    api.system.getClaudeMode().then((r) => setMode(r.mode)).catch(() => {})
+  }, [])
+
+  async function flip() {
+    if (busy) return
+    setBusy(true)
+    const target = mode === 'proxy' ? 'api' : 'proxy'
+    try {
+      const result = await api.system.setClaudeMode(target)
+      setMode(result.mode)
+    } catch (err) {
+      console.error('claude-mode flip failed', err)
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  const label = mode === 'proxy' ? 'sub' : mode === 'api' ? 'api' : '?'
+  const tooltip =
+    mode === 'proxy'
+      ? 'Claude routed via Max subscription proxy (free). Click to switch to direct API.'
+      : mode === 'api'
+      ? 'Claude routed via direct Anthropic API (billed). Click to switch to subscription proxy.'
+      : 'Claude provider mode unknown'
+
+  const dotColor = mode === 'proxy' ? 'bg-emerald-500' : mode === 'api' ? 'bg-amber-500' : 'bg-gray-400'
+
+  return (
+    <button
+      onClick={flip}
+      disabled={busy || mode === 'unknown'}
+      title={tooltip}
+      className="group flex items-center gap-2 px-2.5 py-1 rounded border border-gray-200 dark:border-gray-700 hover:border-gray-400 dark:hover:border-gray-500 transition-colors cursor-pointer disabled:opacity-50 disabled:cursor-wait"
+    >
+      <span className={`w-1.5 h-1.5 rounded-full ${dotColor} ${busy ? 'pulse-soft' : ''}`} />
+      <span className="font-mono text-[10px] uppercase tracking-wider text-gray-500 dark:text-gray-400">claude</span>
+      <span className="font-mono text-[10px] tabular text-gray-900 dark:text-gray-100">{label}</span>
+    </button>
+  )
+}
--- a/ui/src/components/DirectorQueue.tsx
+++ b/ui/src/components/DirectorQueue.tsx
@@ -0,0 +1,82 @@
+import type { QueueItem } from '../lib/api'
+import { relativeTime, absoluteTime } from '../lib/time'
+
+const statusColors: Record<string, string> = {
+  pending_verification: 'text-yellow-600',
+  ready_for_approval: 'text-blue-600 dark:text-blue-400',
+  returned: 'text-red-600',
+  approved: 'text-green-600',
+  redirected: 'text-orange-600',
+}
+
+function QueueItemCard({ item, onReview }: { item: QueueItem; onReview: () => void }) {
+  return (
+    <div className="group p-3 rounded-md border border-gray-200 dark:border-gray-700 bg-white dark:bg-gray-800 hover:border-gray-400 dark:hover:border-gray-500 transition-colors">
+      <div className="flex items-start justify-between gap-3 mb-1">
+        <span className="font-medium text-sm text-gray-900 dark:text-gray-100 leading-snug">
+          {item.plan_title || `Plan #${item.plan_id}`}
+        </span>
+        <span className={`shrink-0 font-mono text-[10px] uppercase tracking-wider ${statusColors[item.status] ?? ''}`}>
+          {item.status.replace(/_/g, ' ')}
+        </span>
+      </div>
+
+      {item.task_title && (
+        <div className="font-mono text-[10px] text-gray-500 dark:text-gray-400 mb-1">
+          → {item.task_title}
+        </div>
+      )}
+
+      {item.verification_notes && (
+        <div className="text-xs text-gray-600 dark:text-gray-400 mt-2 leading-relaxed line-clamp-2">
+          {item.verification_notes}
+        </div>
+      )}
+
+      <div className="flex items-center justify-between mt-3 pt-2 border-t border-gray-100 dark:border-gray-700/50">
+        <span className="font-mono text-[10px] tabular text-gray-400 dark:text-gray-500" title={absoluteTime(item.submitted_at)}>
+          submitted {relativeTime(item.submitted_at)}
+        </span>
+        {item.status === 'ready_for_approval' && (
+          <button
+            onClick={onReview}
+            className="font-mono text-[10px] uppercase tracking-wider px-3 py-1 rounded bg-blue-600 hover:bg-blue-700 text-white cursor-pointer"
+          >
+            review →
+          </button>
+        )}
+      </div>
+    </div>
+  )
+}
+
+export function DirectorQueue({
+  items,
+  onReview,
+}: {
+  items: QueueItem[]
+  onReview: (item: QueueItem) => void
+}) {
+  return (
+    <div className="rounded-lg border border-gray-200 dark:border-gray-700 bg-white dark:bg-gray-800 p-5">
+      <div className="flex items-baseline justify-between mb-4">
+        <h2 className="font-display text-xl font-medium text-gray-900 dark:text-gray-100">
+          Director Queue
+        </h2>
+        <span className="font-mono text-[10px] uppercase tracking-wider text-gray-400">
+          {items.length} {items.length === 1 ? 'item' : 'items'}
+        </span>
+      </div>
+
+      {items.length === 0 ? (
+        <p className="font-mono text-xs text-gray-500 italic">No items awaiting review</p>
+      ) : (
+        <div className="space-y-2">
+          {items.map((item) => (
+            <QueueItemCard key={item.id} item={item} onReview={() => onReview(item)} />
+          ))}
+        </div>
+      )}
+    </div>
+  )
+}
--- a/ui/src/components/EditableComment.tsx
+++ b/ui/src/components/EditableComment.tsx
@@ -0,0 +1,90 @@
+import { useEffect, useRef, useState } from 'react'
+
+interface Props {
+  text: string
+  onSave: (next: string) => Promise<void>
+  className?: string
+}
+
+// Inline-editable comment text. Click to enter edit mode (handled by parent),
+// or pass `editing` to control externally. This component focuses on the
+// editing interaction itself with a clean save/cancel UX.
+export function EditableComment({ text, onSave, className = '' }: Props) {
+  const [editing, setEditing] = useState(false)
+  const [draft, setDraft] = useState(text)
+  const [busy, setBusy] = useState(false)
+  const ref = useRef<HTMLTextAreaElement>(null)
+
+  useEffect(() => { setDraft(text) }, [text])
+
+  useEffect(() => {
+    if (editing && ref.current) {
+      ref.current.focus()
+      // Place cursor at end
+      ref.current.setSelectionRange(ref.current.value.length, ref.current.value.length)
+    }
+  }, [editing])
+
+  async function save() {
+    if (busy) return
+    if (!draft.trim()) return
+    if (draft === text) { setEditing(false); return }
+    setBusy(true)
+    try {
+      await onSave(draft.trim())
+      setEditing(false)
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  function cancel() {
+    setDraft(text)
+    setEditing(false)
+  }
+
+  if (editing) {
+    return (
+      <div onClick={(e) => e.stopPropagation()}>
+        <textarea
+          ref={ref}
+          value={draft}
+          onChange={(e) => setDraft(e.target.value)}
+          onKeyDown={(e) => {
+            if (e.key === 'Enter' && (e.metaKey || e.ctrlKey)) { e.preventDefault(); save() }
+            if (e.key === 'Escape') { e.preventDefault(); cancel() }
+          }}
+          rows={Math.max(2, Math.min(8, draft.split('\n').length + 1))}
+          className="w-full px-2.5 py-1.5 rounded border border-blue-300 dark:border-blue-800 bg-blue-50/40 dark:bg-blue-950/30 text-sm text-gray-900 dark:text-gray-100 focus:outline-none focus:ring-2 focus:ring-blue-200 dark:focus:ring-blue-900 resize-y leading-relaxed"
+        />
+        <div className="flex items-center justify-end gap-2 mt-1.5">
+          <span className="font-mono text-[9px] text-gray-400 mr-auto">cmd+enter to save · esc to cancel</span>
+          <button
+            onClick={cancel}
+            disabled={busy}
+            className="px-2.5 py-1 rounded text-[10px] font-mono uppercase tracking-wider text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-gray-100 cursor-pointer"
+          >
+            cancel
+          </button>
+          <button
+            onClick={save}
+            disabled={busy || !draft.trim() || draft === text}
+            className="px-3 py-1 rounded text-[10px] font-mono uppercase tracking-wider bg-blue-600 hover:bg-blue-700 text-white disabled:opacity-50 cursor-pointer"
+          >
+            {busy ? 'saving…' : 'save'}
+          </button>
+        </div>
+      </div>
+    )
+  }
+
+  return (
+    <div
+      onClick={(e) => { e.stopPropagation(); setEditing(true) }}
+      title="Click to edit"
+      className={`cursor-text rounded -mx-1 px-1 transition-colors hover:bg-blue-50/60 dark:hover:bg-blue-950/30 ${className}`}
+    >
+      {text}
+    </div>
+  )
+}
--- a/ui/src/components/InlineCommentBox.tsx
+++ b/ui/src/components/InlineCommentBox.tsx
@@ -0,0 +1,85 @@
+import { useEffect, useRef, useState } from 'react'
+
+interface Props {
+  onSubmit: (text: string) => Promise<void> | void
+  onCancel?: () => void
+  placeholder?: string
+  buttonLabel?: string
+  autoFocus?: boolean
+  compact?: boolean
+}
+
+export function InlineCommentBox({
+  onSubmit,
+  onCancel,
+  placeholder = 'Add your comment or question…',
+  buttonLabel = 'post',
+  autoFocus = true,
+  compact = false,
+}: Props) {
+  const [text, setText] = useState('')
+  const [busy, setBusy] = useState(false)
+  const ref = useRef<HTMLTextAreaElement>(null)
+
+  useEffect(() => {
+    if (autoFocus && ref.current) ref.current.focus()
+  }, [autoFocus])
+
+  async function submit() {
+    if (!text.trim() || busy) return
+    setBusy(true)
+    try {
+      await onSubmit(text.trim())
+      setText('')
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  return (
+    <div className={compact ? 'mt-1.5' : 'mt-2'}>
+      <div className="flex items-baseline gap-1.5 mb-1">
+        <span className="font-mono text-[9px] uppercase tracking-[0.12em] font-semibold text-blue-600 dark:text-blue-400">
+          &gt; director [joe]:
+        </span>
+      </div>
+      <textarea
+        ref={ref}
+        value={text}
+        onChange={(e) => setText(e.target.value)}
+        onKeyDown={(e) => {
+          if (e.key === 'Enter' && (e.metaKey || e.ctrlKey)) {
+            e.preventDefault()
+            submit()
+          }
+          if (e.key === 'Escape' && onCancel) {
+            e.preventDefault()
+            onCancel()
+          }
+        }}
+        placeholder={placeholder}
+        rows={compact ? 2 : 3}
+        className="w-full px-2.5 py-1.5 rounded border border-blue-200 dark:border-blue-900 bg-blue-50/30 dark:bg-blue-950/20 text-sm text-gray-900 dark:text-gray-100 placeholder:text-gray-400 dark:placeholder:text-gray-600 focus:outline-none focus:ring-2 focus:ring-blue-200 dark:focus:ring-blue-900 resize-y"
+      />
+      <div className="flex items-center justify-end gap-2 mt-1.5">
+        <span className="font-mono text-[9px] text-gray-400 mr-auto">cmd+enter to post · esc to cancel</span>
+        {onCancel && (
+          <button
+            onClick={onCancel}
+            disabled={busy}
+            className="px-2.5 py-1 rounded text-[10px] font-mono uppercase tracking-wider text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-gray-100 cursor-pointer"
+          >
+            cancel
+          </button>
+        )}
+        <button
+          onClick={submit}
+          disabled={busy || !text.trim()}
+          className="px-3 py-1 rounded text-[10px] font-mono uppercase tracking-wider bg-blue-600 hover:bg-blue-700 text-white disabled:opacity-50 cursor-pointer"
+        >
+          {busy ? 'posting…' : buttonLabel}
+        </button>
+      </div>
+    </div>
+  )
+}
--- a/ui/src/components/Metadata.tsx
+++ b/ui/src/components/Metadata.tsx
@@ -0,0 +1,35 @@
+import { relativeTime, absoluteTime } from '../lib/time'
+
+// Tiny clock-arc icon — drawn inline for crisp scaling and theming
+export function ClockGlyph({ className = '' }: { className?: string }) {
+  return (
+    <svg viewBox="0 0 12 12" className={className} fill="none" stroke="currentColor" strokeWidth="1" strokeLinecap="round">
+      <circle cx="6" cy="6" r="4.5" />
+      <path d="M6 3.5 V6 L7.5 7.5" />
+    </svg>
+  )
+}
+
+// Single timestamp display — monospace, tabular, with hover-revealed absolute time
+export function TimeStamp({ iso, label, className = '' }: { iso: string; label?: string; className?: string }) {
+  return (
+    <span className={`inline-flex items-baseline gap-1 font-mono text-[10px] tabular tracking-tight ${className}`} title={absoluteTime(iso)}>
+      {label && <span className="text-gray-400 dark:text-gray-500 uppercase">{label}</span>}
+      <span>{relativeTime(iso)}</span>
+    </span>
+  )
+}
+
+// A row of labeled metadata pairs — used in plan/task headers
+export function MetaRow({ items }: { items: { label: string; value: string; iso?: string }[] }) {
+  return (
+    <div className="flex flex-wrap items-baseline gap-x-5 gap-y-2 font-mono text-[10px] tabular">
+      {items.map((item, i) => (
+        <div key={i} className="flex items-baseline gap-1.5" title={item.iso ? absoluteTime(item.iso) : undefined}>
+          <span className="text-gray-400 dark:text-gray-500 uppercase tracking-wider">{item.label}</span>
+          <span className="text-gray-900 dark:text-gray-100">{item.value}</span>
+        </div>
+      ))}
+    </div>
+  )
+}
--- a/ui/src/components/NewPlanModal.tsx
+++ b/ui/src/components/NewPlanModal.tsx
@@ -0,0 +1,120 @@
+import { useState } from 'react'
+import { api } from '../lib/api'
+
+export function NewPlanModal({ onClose, onCreated }: { onClose: () => void; onCreated: () => void }) {
+  const [title, setTitle] = useState('')
+  const [description, setDescription] = useState('')
+  const [team, setTeam] = useState('tech')
+  const [priority, setPriority] = useState('3')
+  const [busy, setBusy] = useState(false)
+  const [error, setError] = useState('')
+
+  async function submit(e: React.FormEvent) {
+    e.preventDefault()
+    setBusy(true)
+    setError('')
+    try {
+      await api.plans.create({ title, description, team, priority })
+      onCreated()
+      onClose()
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err))
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  return (
+    <div className="fixed inset-0 bg-black/50 flex items-center justify-center z-50" onClick={onClose}>
+      <div
+        className="bg-white dark:bg-gray-800 rounded-lg w-full max-w-2xl m-4 p-6"
+        onClick={(e) => e.stopPropagation()}
+      >
+        <div className="flex items-center justify-between mb-4">
+          <h2 className="text-xl font-semibold text-gray-900 dark:text-gray-100">New Plan</h2>
+          <button onClick={onClose} className="text-gray-500 hover:text-gray-700 text-xl cursor-pointer">&times;</button>
+        </div>
+
+        <form onSubmit={submit} className="space-y-4">
+          <div>
+            <label className="block text-sm font-medium text-gray-700 dark:text-gray-300 mb-1">Title</label>
+            <input
+              type="text"
+              value={title}
+              onChange={(e) => setTitle(e.target.value)}
+              required
+              autoFocus
+              className="w-full px-3 py-2 rounded border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-900 text-gray-900 dark:text-gray-100"
+              placeholder="Feature or system name"
+            />
+          </div>
+
+          <div>
+            <label className="block text-sm font-medium text-gray-700 dark:text-gray-300 mb-1">Description</label>
+            <textarea
+              value={description}
+              onChange={(e) => setDescription(e.target.value)}
+              required
+              rows={6}
+              className="w-full px-3 py-2 rounded border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-900 text-gray-900 dark:text-gray-100"
+              placeholder="Describe the feature in plain English. The team lead will decompose it into tasks."
+            />
+          </div>
+
+          <div className="grid grid-cols-2 gap-4">
+            <div>
+              <label className="block text-sm font-medium text-gray-700 dark:text-gray-300 mb-1">Team</label>
+              <select
+                value={team}
+                onChange={(e) => setTeam(e.target.value)}
+                className="w-full px-3 py-2 rounded border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-900 text-gray-900 dark:text-gray-100"
+              >
+                <option value="tech">Tech</option>
+                <option value="comms">Comms</option>
+              </select>
+            </div>
+
+            <div>
+              <label className="block text-sm font-medium text-gray-700 dark:text-gray-300 mb-1">Priority</label>
+              <select
+                value={priority}
+                onChange={(e) => setPriority(e.target.value)}
+                className="w-full px-3 py-2 rounded border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-900 text-gray-900 dark:text-gray-100"
+              >
+                <option value="critical">Critical</option>
+                <option value="1">P1 — Highest</option>
+                <option value="2">P2 — High</option>
+                <option value="3">P3 — Normal</option>
+                <option value="4">P4 — Low</option>
+                <option value="5">P5 — Lowest</option>
+                <option value="backlog">Backlog</option>
+              </select>
+            </div>
+          </div>
+
+          {error && (
+            <div className="text-sm text-red-600">{error}</div>
+          )}
+
+          <div className="flex justify-end gap-2 pt-2">
+            <button
+              type="button"
+              onClick={onClose}
+              disabled={busy}
+              className="px-4 py-2 rounded bg-gray-200 hover:bg-gray-300 dark:bg-gray-700 dark:hover:bg-gray-600 text-gray-800 dark:text-gray-200 cursor-pointer"
+            >
+              Cancel
+            </button>
+            <button
+              type="submit"
+              disabled={busy || !title || !description}
+              className="px-4 py-2 rounded bg-blue-600 hover:bg-blue-700 text-white disabled:opacity-50 cursor-pointer"
+            >
+              {busy ? 'Creating...' : 'Create Plan'}
+            </button>
+          </div>
+        </form>
+      </div>
+    </div>
+  )
+}
--- a/ui/src/components/PendingQuestions.tsx
+++ b/ui/src/components/PendingQuestions.tsx
@@ -0,0 +1,159 @@
+import { useState } from 'react'
+import type { PendingQuestion } from '../lib/api'
+import { api } from '../lib/api'
+import { relativeTime, absoluteTime } from '../lib/time'
+
+const priorityBadge: Record<string, string> = {
+  critical: 'bg-red-600 text-white',
+  '1': 'bg-red-100 text-red-800 dark:bg-red-900 dark:text-red-200',
+  '2': 'bg-orange-100 text-orange-800 dark:bg-orange-900 dark:text-orange-200',
+  '3': 'bg-blue-100 text-blue-800 dark:bg-blue-900 dark:text-blue-200',
+  '4': 'bg-gray-100 text-gray-800 dark:bg-gray-700 dark:text-gray-200',
+  '5': 'bg-gray-100 text-gray-600 dark:bg-gray-700 dark:text-gray-400',
+}
+
+const roleColor: Record<string, string> = {
+  lead: 'text-emerald-600 dark:text-emerald-400',
+  agent: 'text-amber-600 dark:text-amber-400',
+}
+
+function QuestionCard({ q, onAnswered }: { q: PendingQuestion; onAnswered: () => void }) {
+  const [open, setOpen] = useState(false)
+  const [answer, setAnswer] = useState('')
+  const [busy, setBusy] = useState(false)
+
+  async function submit() {
+    if (!answer.trim() || busy) return
+    setBusy(true)
+    try {
+      await api.questions.answer(q.id, answer.trim())
+      setAnswer('')
+      setOpen(false)
+      onAnswered()
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  return (
+    <div className="rounded-md border border-gray-200 dark:border-gray-700 bg-white dark:bg-gray-800 hover:border-gray-400 dark:hover:border-gray-500 transition-colors">
+      <div className="p-3">
+        <div className="flex items-start justify-between gap-3 mb-2">
+          <div className="flex items-baseline gap-2 flex-wrap min-w-0">
+            <span className={`font-mono text-[10px] uppercase tracking-wider font-semibold ${roleColor[q.from_role] ?? 'text-gray-700'}`}>
+              {q.from_role}
+            </span>
+            <span className="font-mono text-[10px] text-gray-500 dark:text-gray-400">
+              {q.from_id}
+            </span>
+            {q.plan_title && (
+              <span className="font-mono text-[10px] text-gray-400 dark:text-gray-500 truncate">
+                · {q.plan_title}
+              </span>
+            )}
+            {q.task_title && (
+              <span className="font-mono text-[10px] text-gray-400 dark:text-gray-500 truncate">
+                / {q.task_title}
+              </span>
+            )}
+          </div>
+          <span className={`shrink-0 text-[10px] font-mono font-medium uppercase tracking-wider px-1.5 py-0.5 rounded ${priorityBadge[q.priority] ?? ''}`}>
+            {q.priority === 'critical' ? 'crit' : `p${q.priority}`}
+          </span>
+        </div>
+
+        <div className="text-sm text-gray-900 dark:text-gray-100 leading-relaxed mb-2">
+          {q.question}
+        </div>
+
+        {q.context && (
+          <div className="text-xs text-gray-500 dark:text-gray-400 leading-relaxed mb-2 italic">
+            {q.context}
+          </div>
+        )}
+
+        <div className="flex items-center justify-between pt-2 border-t border-gray-100 dark:border-gray-700/50">
+          <span className="font-mono text-[10px] tabular text-gray-400 dark:text-gray-500" title={absoluteTime(q.created_at)}>
+            asked {relativeTime(q.created_at)}
+          </span>
+          {!open && (
+            <button
+              onClick={() => setOpen(true)}
+              className="font-mono text-[10px] uppercase tracking-wider px-3 py-1 rounded bg-blue-600 hover:bg-blue-700 text-white cursor-pointer"
+            >
+              answer →
+            </button>
+          )}
+        </div>
+
+        {open && (
+          <div className="mt-3 pt-3 border-t border-gray-100 dark:border-gray-700/50">
+            <div className="font-mono text-[9px] uppercase tracking-[0.12em] font-semibold text-blue-600 dark:text-blue-400 mb-1">
+              &gt; director [joe]:
+            </div>
+            <textarea
+              value={answer}
+              onChange={(e) => setAnswer(e.target.value)}
+              onKeyDown={(e) => {
+                if (e.key === 'Enter' && (e.metaKey || e.ctrlKey)) { e.preventDefault(); submit() }
+                if (e.key === 'Escape') { e.preventDefault(); setOpen(false); setAnswer('') }
+              }}
+              placeholder="Your answer…"
+              autoFocus
+              rows={3}
+              className="w-full px-2.5 py-1.5 rounded border border-blue-200 dark:border-blue-900 bg-blue-50/30 dark:bg-blue-950/20 text-sm text-gray-900 dark:text-gray-100 focus:outline-none focus:ring-2 focus:ring-blue-200 dark:focus:ring-blue-900"
+            />
+            <div className="flex items-center justify-end gap-2 mt-2">
+              <span className="font-mono text-[9px] text-gray-400 mr-auto">cmd+enter to submit · esc to cancel</span>
+              <button
+                onClick={() => { setOpen(false); setAnswer('') }}
+                disabled={busy}
+                className="px-2.5 py-1 rounded text-[10px] font-mono uppercase tracking-wider text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-gray-100 cursor-pointer"
+              >
+                cancel
+              </button>
+              <button
+                onClick={submit}
+                disabled={busy || !answer.trim()}
+                className="px-3 py-1 rounded text-[10px] font-mono uppercase tracking-wider bg-blue-600 hover:bg-blue-700 text-white disabled:opacity-50 cursor-pointer"
+              >
+                {busy ? 'sending…' : 'send answer'}
+              </button>
+            </div>
+          </div>
+        )}
+      </div>
+    </div>
+  )
+}
+
+export function PendingQuestions({
+  questions,
+  onChange,
+}: {
+  questions: PendingQuestion[]
+  onChange: () => void
+}) {
+  return (
+    <div className="rounded-lg border border-gray-200 dark:border-gray-700 bg-white dark:bg-gray-800 p-5">
+      <div className="flex items-baseline justify-between mb-4">
+        <h2 className="font-display text-xl font-medium text-gray-900 dark:text-gray-100">
+          Pending Questions
+        </h2>
+        <span className="font-mono text-[10px] uppercase tracking-wider text-gray-400">
+          {questions.length} {questions.length === 1 ? 'question' : 'questions'}
+        </span>
+      </div>
+
+      {questions.length === 0 ? (
+        <p className="font-mono text-xs text-gray-500 italic">No pending questions</p>
+      ) : (
+        <div className="space-y-2">
+          {questions.map((q) => (
+            <QuestionCard key={q.id} q={q} onAnswered={onChange} />
+          ))}
+        </div>
+      )}
+    </div>
+  )
+}
--- a/ui/src/components/PlanBoard.tsx
+++ b/ui/src/components/PlanBoard.tsx
@@ -0,0 +1,90 @@
+import type { Plan } from '../lib/api'
+import { TimeStamp, ClockGlyph } from './Metadata'
+
+const priorityBadge: Record<string, string> = {
+  critical: 'bg-red-600 text-white',
+  '1': 'bg-red-100 text-red-800 dark:bg-red-900 dark:text-red-200',
+  '2': 'bg-orange-100 text-orange-800 dark:bg-orange-900 dark:text-orange-200',
+  '3': 'bg-blue-100 text-blue-800 dark:bg-blue-900 dark:text-blue-200',
+  '4': 'bg-gray-100 text-gray-800 dark:bg-gray-700 dark:text-gray-200',
+  '5': 'bg-gray-100 text-gray-600 dark:bg-gray-700 dark:text-gray-400',
+  backlog: 'bg-gray-50 text-gray-500 dark:bg-gray-800 dark:text-gray-500',
+}
+
+const columns = [
+  { key: 'draft', label: 'Draft' },
+  { key: 'approved', label: 'Approved' },
+  { key: 'in_progress', label: 'In Progress' },
+  { key: 'done', label: 'Done' },
+] as const
+
+function PlanCard({ plan, onClick }: { plan: Plan; onClick: () => void }) {
+  const isActive = plan.status === 'in_progress'
+  return (
+    <button
+      onClick={onClick}
+      className="group w-full text-left rounded-md border border-gray-200 dark:border-gray-700 bg-white dark:bg-gray-800 hover:border-gray-400 dark:hover:border-gray-500 transition-colors cursor-pointer overflow-hidden"
+    >
+      <div className="p-3">
+        <div className="flex items-start justify-between gap-2 mb-2">
+          <span className="font-display text-[15px] leading-snug font-medium text-gray-900 dark:text-gray-100 line-clamp-2">
+            {plan.title}
+          </span>
+          <span className={`shrink-0 text-[10px] font-mono font-medium uppercase tracking-wider px-1.5 py-0.5 rounded ${priorityBadge[plan.priority] ?? ''}`}>
+            {plan.priority === 'critical' ? 'crit' : `p${plan.priority}`}
+          </span>
+        </div>
+
+        <div className="flex items-center justify-between">
+          <span className="font-mono text-[10px] uppercase tracking-wider text-gray-400 dark:text-gray-500">
+            {plan.team}
+          </span>
+          <span className="flex items-center gap-1 text-gray-400 dark:text-gray-500">
+            <ClockGlyph className="w-2.5 h-2.5" />
+            <TimeStamp iso={plan.created_at} />
+          </span>
+        </div>
+      </div>
+
+      {isActive && (
+        <div className="h-0.5 bg-gradient-to-r from-blue-500 via-blue-400 to-transparent pulse-soft" />
+      )}
+    </button>
+  )
+}
+
+export function PlanBoard({ plans, onSelect }: { plans: Plan[]; onSelect: (plan: Plan) => void }) {
+  return (
+    <div className="rounded-lg border border-gray-200 dark:border-gray-700 bg-white dark:bg-gray-800 p-5">
+      <div className="flex items-baseline justify-between mb-4">
+        <h2 className="font-display text-xl font-medium text-gray-900 dark:text-gray-100">Plan Board</h2>
+        <span className="font-mono text-[10px] uppercase tracking-wider text-gray-400">
+          {plans.length} {plans.length === 1 ? 'plan' : 'plans'}
+        </span>
+      </div>
+
+      <div className="grid grid-cols-4 gap-4">
+        {columns.map((col) => {
+          const colPlans = plans.filter((p) => p.status === col.key || (col.key === 'draft' && p.status === 'clarification'))
+          return (
+            <div key={col.key}>
+              <div className="flex items-baseline justify-between mb-3 pb-2 border-b border-gray-200 dark:border-gray-700">
+                <span className="font-mono text-[10px] font-semibold text-gray-500 dark:text-gray-400 uppercase tracking-wider">
+                  {col.label}
+                </span>
+                <span className="font-mono text-[10px] tabular text-gray-400 dark:text-gray-500">
+                  {colPlans.length}
+                </span>
+              </div>
+              <div className="space-y-2 min-h-[100px]">
+                {colPlans.map((plan) => (
+                  <PlanCard key={plan.id} plan={plan} onClick={() => onSelect(plan)} />
+                ))}
+              </div>
+            </div>
+          )
+        })}
+      </div>
+    </div>
+  )
+}
--- a/ui/src/components/PlanDetail.tsx
+++ b/ui/src/components/PlanDetail.tsx
@@ -0,0 +1,670 @@
+import { useEffect, useMemo, useRef, useState } from 'react'
+import type { Plan, Task, Message, QueueItem } from '../lib/api'
+import { api } from '../lib/api'
+import { relativeTime, absoluteTime } from '../lib/time'
+import { InlineCommentBox } from './InlineCommentBox'
+import { EditableComment } from './EditableComment'
+
+function duration(fromIso: string, toIso?: string): string {
+  const from = new Date(fromIso).getTime()
+  const to = toIso ? new Date(toIso).getTime() : Date.now()
+  const sec = Math.max(0, Math.floor((to - from) / 1000))
+  if (sec < 60) return `${sec}s`
+  const min = Math.floor(sec / 60)
+  if (min < 60) return `${min}m ${sec % 60}s`
+  const hr = Math.floor(min / 60)
+  if (hr < 24) return `${hr}h ${min % 60}m`
+  const day = Math.floor(hr / 24)
+  return `${day}d ${hr % 24}h`
+}
+
+const taskStatusGlyph: Record<string, string> = {
+  queued: '○',
+  in_progress: '◐',
+  blocked: '■',
+  complete: '●',
+  returned: '↩',
+}
+
+const taskStatusColor: Record<string, string> = {
+  queued: 'text-gray-400',
+  in_progress: 'text-blue-500',
+  blocked: 'text-yellow-500',
+  complete: 'text-green-500',
+  returned: 'text-red-500',
+}
+
+const roleColor: Record<string, string> = {
+  director: 'text-blue-600 dark:text-blue-400',
+  lead: 'text-emerald-600 dark:text-emerald-400',
+  agent: 'text-amber-600 dark:text-amber-400',
+  system: 'text-gray-500',
+}
+
+const priorityBadge: Record<string, string> = {
+  critical: 'bg-red-600 text-white',
+  '1': 'bg-red-100 text-red-800 dark:bg-red-900 dark:text-red-200',
+  '2': 'bg-orange-100 text-orange-800 dark:bg-orange-900 dark:text-orange-200',
+  '3': 'bg-blue-100 text-blue-800 dark:bg-blue-900 dark:text-blue-200',
+  '4': 'bg-gray-100 text-gray-800 dark:bg-gray-700 dark:text-gray-200',
+  '5': 'bg-gray-100 text-gray-600 dark:bg-gray-700 dark:text-gray-400',
+  backlog: 'bg-gray-50 text-gray-500 dark:bg-gray-800 dark:text-gray-500',
+}
+
+function MetaItem({ label, value, title }: { label: string; value: string; title?: string }) {
+  return (
+    <div className="flex flex-col gap-0.5" title={title}>
+      <span className="font-mono text-[9px] uppercase tracking-[0.12em] text-gray-400 dark:text-gray-500">{label}</span>
+      <span className="font-mono text-xs tabular text-gray-900 dark:text-gray-100">{value}</span>
+    </div>
+  )
+}
+
+// Wrapper that makes any region click-to-comment with refined hover affordance.
+// The whole region is clickable; a "+ comment" chip appears top-right on hover
+// as a secondary visual signal. Children stop propagation if they need to.
+function Commentable({
+  active,
+  onActivate,
+  children,
+  className = '',
+  chipLabel = 'comment',
+  chipPosition = 'top-right',
+}: {
+  active: boolean
+  onActivate: () => void
+  children: React.ReactNode
+  className?: string
+  chipLabel?: string
+  chipPosition?: 'top-right' | 'inline'
+}) {
+  return (
+    <div
+      onClick={(e) => {
+        if (active) return
+        // Don't activate if user is selecting text
+        const sel = window.getSelection?.()
+        if (sel && sel.toString().length > 0) return
+        // Ignore clicks that originated on links or buttons
+        const target = e.target as HTMLElement
+        if (target.closest('button, a, textarea, input, [data-no-comment]')) return
+        onActivate()
+      }}
+      className={`relative group/c rounded-md transition-colors cursor-text ${
+        !active ? 'hover:bg-blue-50/50 dark:hover:bg-blue-950/20' : ''
+      } ${className}`}
+    >
+      {/* Subtle left accent on hover */}
+      {!active && (
+        <span
+          aria-hidden
+          className="pointer-events-none absolute left-0 top-1.5 bottom-1.5 w-[2px] rounded-full bg-blue-400/0 group-hover/c:bg-blue-400/60 dark:group-hover/c:bg-blue-500/60 transition-colors"
+        />
+      )}
+      {!active && chipPosition === 'top-right' && (
+        <span className="pointer-events-none absolute top-2 right-2 font-mono text-[9px] uppercase tracking-wider text-blue-500/0 group-hover/c:text-blue-500 dark:group-hover/c:text-blue-400 transition-colors">
+          + {chipLabel}
+        </span>
+      )}
+      {children}
+    </div>
+  )
+}
+
+// Single message rendered as a card. If it's a director message, the body is editable.
+function MessageCard({
+  message,
+  replies,
+  activeReplyTarget,
+  setActiveReplyTarget,
+  postReply,
+  editMessage,
+}: {
+  message: Message
+  replies: Message[]
+  activeReplyTarget: string | null
+  setActiveReplyTarget: (key: string | null) => void
+  postReply: (replyToId: number, text: string) => Promise<void>
+  editMessage: (id: number, next: string) => Promise<void>
+}) {
+  const replyKey = `msg:${message.id}`
+  const isOpen = activeReplyTarget === replyKey
+  const isDirector = message.from_role === 'director'
+
+  const inner = (
+    <div className="border-l-2 border-gray-200 dark:border-gray-700 pl-3 py-1.5 pr-2">
+      <div className="flex items-baseline gap-2 mb-1">
+        <span className={`font-mono text-[10px] uppercase tracking-wider font-semibold ${roleColor[message.from_role] ?? 'text-gray-700'}`}>
+          {message.from_role}
+        </span>
+        <span className="font-mono text-[10px] text-gray-500 dark:text-gray-400">{message.from_id}</span>
+        <span className="font-mono text-[10px] tabular text-gray-400 dark:text-gray-500" title={absoluteTime(message.created_at)}>
+          {relativeTime(message.created_at)}
+        </span>
+        {isDirector && (
+          <span className="font-mono text-[9px] uppercase tracking-wider text-gray-400 ml-1">· editable</span>
+        )}
+      </div>
+      {isDirector ? (
+        <div className="text-sm text-gray-700 dark:text-gray-300 leading-relaxed">
+          <EditableComment text={message.message} onSave={(next) => editMessage(message.id, next)} />
+        </div>
+      ) : (
+        <div className="text-sm text-gray-700 dark:text-gray-300 leading-relaxed whitespace-pre-line">
+          {message.message}
+        </div>
+      )}
+
+      {isOpen && (
+        <div data-no-comment>
+          <InlineCommentBox
+            placeholder="Reply to this message…"
+            buttonLabel="reply"
+            onCancel={() => setActiveReplyTarget(null)}
+            onSubmit={async (text) => {
+              await postReply(message.id, text)
+              setActiveReplyTarget(null)
+            }}
+          />
+        </div>
+      )}
+    </div>
+  )
+
+  return (
+    <div>
+      {isDirector ? (
+        // Director messages: not click-to-comment (clicking edits via EditableComment)
+        // but agents can still be replied to via the structure below.
+        <div className="rounded-md">{inner}</div>
+      ) : (
+        <Commentable
+          active={isOpen}
+          onActivate={() => setActiveReplyTarget(replyKey)}
+          chipLabel="reply"
+        >
+          {inner}
+        </Commentable>
+      )}
+
+      {replies.length > 0 && (
+        <div className="ml-5 mt-2 space-y-2">
+          {replies.map((reply) => (
+            <MessageCard
+              key={reply.id}
+              message={reply}
+              replies={[]}
+              activeReplyTarget={activeReplyTarget}
+              setActiveReplyTarget={setActiveReplyTarget}
+              postReply={postReply}
+              editMessage={editMessage}
+            />
+          ))}
+        </div>
+      )}
+    </div>
+  )
+}
+
+interface PlanDetailProps {
+  plan: Plan
+  onClose: () => void
+  reviewItem?: QueueItem
+  onReviewActioned?: () => void
+}
+
+export function PlanDetail({ plan: initial, onClose, reviewItem, onReviewActioned }: PlanDetailProps) {
+  const [plan, setPlan] = useState(initial)
+  const [tasks, setTasks] = useState<Task[]>([])
+  const [messages, setMessages] = useState<Message[]>([])
+  const [actionBusy, setActionBusy] = useState(false)
+  const [sendBackMode, setSendBackMode] = useState(false)
+  const [sendBackText, setSendBackText] = useState('')
+  const [activeReplyTarget, setActiveReplyTarget] = useState<string | null>(null)
+  const verificationRef = useRef<HTMLDivElement>(null)
+
+  function refresh() {
+    api.plans.get(initial.id).then(setPlan).catch(() => {})
+    api.tasks.list(initial.id).then(setTasks)
+    api.messages.list(initial.id).then(setMessages)
+  }
+
+  useEffect(() => {
+    refresh()
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [initial.id])
+
+  useEffect(() => {
+    if (reviewItem && verificationRef.current) {
+      verificationRef.current.scrollIntoView({ behavior: 'smooth', block: 'center' })
+    }
+  }, [reviewItem])
+
+  // Esc closes any open inline editor
+  useEffect(() => {
+    function handler(e: KeyboardEvent) {
+      if (e.key === 'Escape' && activeReplyTarget) {
+        setActiveReplyTarget(null)
+      }
+    }
+    window.addEventListener('keydown', handler)
+    return () => window.removeEventListener('keydown', handler)
+  }, [activeReplyTarget])
+
+  const totalDuration = plan.completed_at && plan.started_at
+    ? duration(plan.started_at, plan.completed_at)
+    : plan.started_at
+    ? duration(plan.started_at)
+    : null
+
+  const { topLevelMessages, repliesByMessageId, messagesByTaskId, verificationComments } = useMemo(() => {
+    const byMsg = new Map<number, Message[]>()
+    const byTask = new Map<number, Message[]>()
+    const verif: Message[] = []
+    const top: Message[] = []
+    for (const m of messages) {
+      if (m.reply_to_id != null) {
+        const arr = byMsg.get(m.reply_to_id) ?? []
+        arr.push(m)
+        byMsg.set(m.reply_to_id, arr)
+      } else if (m.task_id != null) {
+        const arr = byTask.get(m.task_id) ?? []
+        arr.push(m)
+        byTask.set(m.task_id, arr)
+      } else if (m.message_type === 'verification_comment') {
+        verif.push(m)
+      } else {
+        top.push(m)
+      }
+    }
+    return {
+      topLevelMessages: top,
+      repliesByMessageId: byMsg,
+      messagesByTaskId: byTask,
+      verificationComments: verif,
+    }
+  }, [messages])
+
+  async function postComment(payload: {
+    text: string
+    taskId?: number
+    replyToId?: number
+    messageType?: string
+  }) {
+    await api.messages.create(plan.id, {
+      from_role: 'director',
+      from_id: 'joe',
+      message: payload.text,
+      message_type: payload.messageType ?? 'comment',
+      task_id: payload.taskId,
+      reply_to_id: payload.replyToId,
+    })
+    refresh()
+  }
+
+  async function editMessage(id: number, next: string) {
+    await api.messages.update(id, next)
+    refresh()
+  }
+
+  async function handleApprove() {
+    if (!reviewItem || actionBusy) return
+    setActionBusy(true)
+    try {
+      await api.queue.update(reviewItem.id, { status: 'approved' })
+      onReviewActioned?.()
+      onClose()
+    } catch (err) {
+      console.error('approve failed', err)
+    } finally {
+      setActionBusy(false)
+    }
+  }
+
+  async function handleSendBack() {
+    if (!reviewItem || actionBusy || !sendBackText.trim()) return
+    setActionBusy(true)
+    try {
+      await postComment({ text: `Sent back: ${sendBackText.trim()}` })
+      await api.queue.update(reviewItem.id, {
+        status: 'redirected',
+        director_notes: sendBackText.trim(),
+      })
+      setSendBackText('')
+      setSendBackMode(false)
+      onReviewActioned?.()
+      onClose()
+    } catch (err) {
+      console.error('send back failed', err)
+    } finally {
+      setActionBusy(false)
+    }
+  }
+
+  return (
+    <div className="fixed inset-0 bg-black/60 backdrop-blur-sm flex items-center justify-center z-50 p-4" onClick={onClose}>
+      <div
+        className="bg-white dark:bg-gray-900 rounded-xl w-full max-w-3xl max-h-[92vh] overflow-auto shadow-2xl border border-gray-200 dark:border-gray-700"
+        onClick={(e) => e.stopPropagation()}
+      >
+        {reviewItem && (
+          <div className="bg-gradient-to-r from-blue-50 to-blue-50/50 dark:from-blue-950/30 dark:to-blue-950/10 border-b border-blue-200 dark:border-blue-900 px-7 py-3 sticky top-0 z-10 backdrop-blur-sm">
+            <div className="flex items-center gap-2">
+              <span className="font-mono text-[10px] uppercase tracking-wider font-semibold text-blue-700 dark:text-blue-400">
+                ⊙ Review mode
+              </span>
+              <span className="font-mono text-[10px] text-blue-600/70 dark:text-blue-400/70">
+                · click any item to comment · click your own comments to edit
+              </span>
+            </div>
+          </div>
+        )}
+
+        {/* Header */}
+        <div className="px-7 pt-6 pb-5 border-b border-gray-200 dark:border-gray-700">
+          <div className="flex items-start justify-between gap-4 mb-3">
+            <h2 className="font-display text-2xl font-medium leading-tight text-gray-900 dark:text-gray-100">
+              {plan.title}
+            </h2>
+            <div className="flex items-center gap-2 shrink-0">
+              <span className={`text-[10px] font-mono font-medium uppercase tracking-wider px-2 py-1 rounded ${priorityBadge[plan.priority] ?? ''}`}>
+                {plan.priority === 'critical' ? 'crit' : `p${plan.priority}`}
+              </span>
+              <button onClick={onClose} className="text-gray-400 hover:text-gray-700 dark:hover:text-gray-200 text-2xl leading-none w-7 h-7 flex items-center justify-center cursor-pointer">&times;</button>
+            </div>
+          </div>
+
+          <p className="text-sm text-gray-600 dark:text-gray-400 leading-relaxed mb-5">{plan.description}</p>
+
+          <div className="flex flex-wrap gap-x-7 gap-y-3 pt-4 border-t border-gray-100 dark:border-gray-800">
+            <MetaItem label="Plan #" value={String(plan.id)} />
+            <MetaItem label="Team" value={plan.team} />
+            <MetaItem label="Status" value={plan.status.replace(/_/g, ' ')} />
+            <MetaItem label="Created" value={relativeTime(plan.created_at)} title={absoluteTime(plan.created_at)} />
+            {plan.approved_at && <MetaItem label="Approved" value={relativeTime(plan.approved_at)} title={absoluteTime(plan.approved_at)} />}
+            {plan.started_at && <MetaItem label="Picked up" value={relativeTime(plan.started_at)} title={absoluteTime(plan.started_at)} />}
+            {plan.completed_at && <MetaItem label="Completed" value={relativeTime(plan.completed_at)} title={absoluteTime(plan.completed_at)} />}
+            {totalDuration && <MetaItem label={plan.completed_at ? 'Took' : 'Running'} value={totalDuration} />}
+          </div>
+        </div>
+
+        {/* Verification (review mode only) */}
+        {reviewItem && (
+          <div ref={verificationRef} className="px-7 py-5 border-b border-gray-200 dark:border-gray-700 bg-blue-50/30 dark:bg-blue-950/10">
+            <div className="flex items-baseline justify-between mb-2">
+              <h3 className="font-display text-base font-medium text-gray-900 dark:text-gray-100">Verification</h3>
+              <span className="font-mono text-[10px] uppercase tracking-wider text-blue-600 dark:text-blue-400">
+                {reviewItem.task_title ? `task: ${reviewItem.task_title}` : 'plan-level'}
+              </span>
+            </div>
+            <Commentable
+              active={activeReplyTarget === 'verification'}
+              onActivate={() => setActiveReplyTarget('verification')}
+              className="-mx-2 px-2 py-1.5"
+            >
+              {reviewItem.verification_notes ? (
+                <div className="text-sm text-gray-700 dark:text-gray-300 leading-relaxed">
+                  {reviewItem.verification_notes}
+                </div>
+              ) : (
+                <div className="font-mono text-xs text-gray-500 italic">No verification notes recorded</div>
+              )}
+              <div className="mt-2 font-mono text-[10px] tabular text-gray-500 dark:text-gray-400">
+                submitted {relativeTime(reviewItem.submitted_at)}
+              </div>
+              {activeReplyTarget === 'verification' && (
+                <div data-no-comment>
+                  <InlineCommentBox
+                    placeholder="Comment on the verification…"
+                    buttonLabel="post"
+                    onCancel={() => setActiveReplyTarget(null)}
+                    onSubmit={async (text) => {
+                      await postComment({
+                        text,
+                        taskId: reviewItem.task_id,
+                        messageType: 'verification_comment',
+                      })
+                      setActiveReplyTarget(null)
+                    }}
+                  />
+                </div>
+              )}
+            </Commentable>
+
+            {verificationComments.length > 0 && (
+              <div className="mt-4 space-y-2">
+                {verificationComments.map((c) => (
+                  <MessageCard
+                    key={c.id}
+                    message={c}
+                    replies={repliesByMessageId.get(c.id) ?? []}
+                    activeReplyTarget={activeReplyTarget}
+                    setActiveReplyTarget={setActiveReplyTarget}
+                    postReply={async (rid, text) => { await postComment({ text, replyToId: rid }) }}
+                    editMessage={editMessage}
+                  />
+                ))}
+              </div>
+            )}
+          </div>
+        )}
+
+        {/* Tasks */}
+        <section className="px-7 py-5 border-b border-gray-200 dark:border-gray-700">
+          <div className="flex items-baseline justify-between mb-3">
+            <h3 className="font-display text-base font-medium text-gray-900 dark:text-gray-100">Tasks</h3>
+            <span className="font-mono text-[10px] uppercase tracking-wider text-gray-400">
+              {tasks.filter((t) => t.status === 'complete').length} / {tasks.length} complete
+            </span>
+          </div>
+
+          {tasks.length === 0 ? (
+            <p className="font-mono text-xs text-gray-500 italic">No tasks yet — awaiting team lead decomposition</p>
+          ) : (
+            <div className="space-y-3">
+              {tasks.map((task) => {
+                const took = task.completed_at && task.started_at
+                  ? duration(task.started_at, task.completed_at)
+                  : task.started_at
+                  ? duration(task.started_at)
+                  : null
+                const isReviewedTask = task.id === reviewItem?.task_id
+                const taskKey = `task:${task.id}`
+                const taskComments = messagesByTaskId.get(task.id) ?? []
+                return (
+                  <div
+                    key={task.id}
+                    className={isReviewedTask ? 'rounded-md ring-1 ring-blue-200 dark:ring-blue-900 bg-blue-50/40 dark:bg-blue-950/20' : ''}
+                  >
+                    <Commentable
+                      active={activeReplyTarget === taskKey}
+                      onActivate={() => setActiveReplyTarget(taskKey)}
+                      className="px-3 py-2"
+                    >
+                      <div className="flex items-start gap-3">
+                        <span className={`text-base leading-tight pt-0.5 ${taskStatusColor[task.status] ?? 'text-gray-400'}`} title={task.status}>
+                          {taskStatusGlyph[task.status] ?? '○'}
+                        </span>
+                        <div className="flex-1 min-w-0">
+                          <div className="flex items-baseline gap-2">
+                            <span className="text-sm text-gray-900 dark:text-gray-100">{task.title}</span>
+                            {task.assigned_agent && (
+                              <span className="font-mono text-[10px] text-gray-400 dark:text-gray-500">
+                                → {task.assigned_agent}
+                              </span>
+                            )}
+                          </div>
+                          {task.description && (
+                            <div className="text-xs text-gray-500 dark:text-gray-400 mt-0.5 leading-relaxed">{task.description}</div>
+                          )}
+                          {task.progress_note && (
+                            <div className="font-mono text-[10px] text-gray-400 dark:text-gray-500 mt-1 italic">
+                              {task.progress_note}
+                            </div>
+                          )}
+                          <div className="flex items-center gap-3 mt-1 font-mono text-[10px] tabular text-gray-400 dark:text-gray-500">
+                            {task.started_at && (
+                              <span title={absoluteTime(task.started_at)}>started {relativeTime(task.started_at)}</span>
+                            )}
+                            {took && (
+                              <span className={task.completed_at ? 'text-gray-500 dark:text-gray-400' : 'text-blue-500'}>
+                                {task.completed_at ? `took ${took}` : `${took} elapsed`}
+                              </span>
+                            )}
+                          </div>
+
+                          {activeReplyTarget === taskKey && (
+                            <div data-no-comment>
+                              <InlineCommentBox
+                                placeholder={`Comment on "${task.title}"…`}
+                                buttonLabel="post"
+                                onCancel={() => setActiveReplyTarget(null)}
+                                onSubmit={async (text) => {
+                                  await postComment({ text, taskId: task.id })
+                                  setActiveReplyTarget(null)
+                                }}
+                              />
+                            </div>
+                          )}
+
+                          {taskComments.length > 0 && (
+                            <div className="mt-3 space-y-2 border-l border-gray-200 dark:border-gray-700 pl-3" data-no-comment>
+                              {taskComments.map((c) => (
+                                <MessageCard
+                                  key={c.id}
+                                  message={c}
+                                  replies={repliesByMessageId.get(c.id) ?? []}
+                                  activeReplyTarget={activeReplyTarget}
+                                  setActiveReplyTarget={setActiveReplyTarget}
+                                  postReply={async (rid, text) => { await postComment({ text, replyToId: rid }) }}
+                                  editMessage={editMessage}
+                                />
+                              ))}
+                            </div>
+                          )}
+                        </div>
+                      </div>
+                    </Commentable>
+                  </div>
+                )
+              })}
+            </div>
+          )}
+        </section>
+
+        {/* Activity */}
+        <section className="px-7 py-5">
+          <div className="flex items-baseline justify-between mb-3">
+            <h3 className="font-display text-base font-medium text-gray-900 dark:text-gray-100">Activity</h3>
+            <span className="font-mono text-[10px] uppercase tracking-wider text-gray-400">
+              {messages.length} {messages.length === 1 ? 'message' : 'messages'}
+            </span>
+          </div>
+
+          {topLevelMessages.length === 0 ? (
+            <p className="font-mono text-xs text-gray-500 italic">No plan-level messages</p>
+          ) : (
+            <div className="space-y-3">
+              {topLevelMessages.map((msg) => (
+                <MessageCard
+                  key={msg.id}
+                  message={msg}
+                  replies={repliesByMessageId.get(msg.id) ?? []}
+                  activeReplyTarget={activeReplyTarget}
+                  setActiveReplyTarget={setActiveReplyTarget}
+                  postReply={async (rid, text) => { await postComment({ text, replyToId: rid }) }}
+                  editMessage={editMessage}
+                />
+              ))}
+            </div>
+          )}
+
+          <div className="mt-5 pt-4 border-t border-gray-100 dark:border-gray-800">
+            {activeReplyTarget === 'plan' ? (
+              <InlineCommentBox
+                placeholder="Add a general note to this plan…"
+                buttonLabel="post"
+                onCancel={() => setActiveReplyTarget(null)}
+                onSubmit={async (text) => {
+                  await postComment({ text })
+                  setActiveReplyTarget(null)
+                }}
+              />
+            ) : (
+              <button
+                onClick={() => setActiveReplyTarget('plan')}
+                className="font-mono text-[10px] uppercase tracking-wider text-gray-500 hover:text-blue-600 dark:hover:text-blue-400 cursor-pointer"
+              >
+                + add plan-level comment
+              </button>
+            )}
+          </div>
+        </section>
+
+        {/* Sticky review actions */}
+        {reviewItem && (
+          <div className="sticky bottom-0 bg-white/95 dark:bg-gray-900/95 backdrop-blur-sm border-t border-gray-200 dark:border-gray-700 px-7 py-4">
+            {sendBackMode ? (
+              <div>
+                <div className="flex items-baseline gap-2 mb-2">
+                  <span className="font-mono text-[10px] uppercase tracking-wider font-semibold text-orange-600 dark:text-orange-400">
+                    sending back —
+                  </span>
+                  <span className="font-mono text-[10px] text-orange-600/70 dark:text-orange-400/70">
+                    explain what needs to change
+                  </span>
+                </div>
+                <textarea
+                  value={sendBackText}
+                  onChange={(e) => setSendBackText(e.target.value)}
+                  rows={3}
+                  autoFocus
+                  placeholder="Required: explain why and what to fix"
+                  className="w-full px-3 py-2 rounded border border-orange-300 dark:border-orange-800 bg-white dark:bg-gray-800 text-sm text-gray-900 dark:text-gray-100 focus:outline-none focus:ring-2 focus:ring-orange-200 dark:focus:ring-orange-900"
+                />
+                <div className="flex justify-end gap-2 mt-3">
+                  <button
+                    onClick={() => { setSendBackMode(false); setSendBackText('') }}
+                    disabled={actionBusy}
+                    className="px-3 py-1.5 rounded text-xs font-mono uppercase tracking-wider text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-gray-100 cursor-pointer"
+                  >
+                    cancel
+                  </button>
+                  <button
+                    onClick={handleSendBack}
+                    disabled={actionBusy || !sendBackText.trim()}
+                    className="px-4 py-1.5 rounded text-xs font-mono uppercase tracking-wider bg-orange-600 hover:bg-orange-700 text-white disabled:opacity-50 cursor-pointer"
+                  >
+                    {actionBusy ? 'sending…' : 'confirm send back'}
+                  </button>
+                </div>
+              </div>
+            ) : (
+              <div className="flex items-center justify-between">
+                <span className="font-mono text-[10px] text-gray-500 dark:text-gray-400">
+                  ready to decide?
+                </span>
+                <div className="flex items-center gap-2">
+                  <button
+                    onClick={() => setSendBackMode(true)}
+                    disabled={actionBusy}
+                    className="px-4 py-1.5 rounded text-xs font-mono uppercase tracking-wider border border-orange-300 dark:border-orange-800 text-orange-700 dark:text-orange-400 hover:bg-orange-50 dark:hover:bg-orange-950/30 cursor-pointer"
+                  >
+                    send back
+                  </button>
+                  <button
+                    onClick={handleApprove}
+                    disabled={actionBusy}
+                    className="px-5 py-1.5 rounded text-xs font-mono uppercase tracking-wider bg-emerald-600 hover:bg-emerald-700 text-white disabled:opacity-50 cursor-pointer"
+                  >
+                    {actionBusy ? 'approving…' : 'approve'}
+                  </button>
+                </div>
+              </div>
+            )}
+          </div>
+        )}
+      </div>
+    </div>
+  )
+}
--- a/ui/src/hooks/useWebSocket.ts
+++ b/ui/src/hooks/useWebSocket.ts
@@ -0,0 +1,34 @@
+import { useEffect, useRef, useCallback } from 'react'
+
+type EventHandler = (event: string, data: unknown) => void
+
+export function useWebSocket(onEvent: EventHandler) {
+  const wsRef = useRef<WebSocket | null>(null)
+  const handleRef = useRef(onEvent)
+  handleRef.current = onEvent
+
+  const connect = useCallback(() => {
+    const protocol = location.protocol === 'https:' ? 'wss:' : 'ws:'
+    const ws = new WebSocket(`${protocol}//${location.host}/ws`)
+
+    ws.onmessage = (e) => {
+      try {
+        const { event, data } = JSON.parse(e.data)
+        handleRef.current(event, data)
+      } catch {
+        // ignore malformed messages
+      }
+    }
+
+    ws.onclose = () => {
+      setTimeout(connect, 3000)
+    }
+
+    wsRef.current = ws
+  }, [])
+
+  useEffect(() => {
+    connect()
+    return () => wsRef.current?.close()
+  }, [connect])
+}
--- a/ui/src/index.css
+++ b/ui/src/index.css
@@ -0,0 +1,37 @@
+@import "tailwindcss";
+
+@theme {
+  --font-sans: "Inter", system-ui, sans-serif;
+  --font-display: "Fraunces", Georgia, serif;
+  --font-mono: "JetBrains Mono", ui-monospace, monospace;
+}
+
+:root {
+  font-family: var(--font-sans);
+  font-feature-settings: "cv02", "cv03", "cv04", "cv11";
+}
+
+.font-display {
+  font-family: var(--font-display);
+  font-optical-sizing: auto;
+}
+
+.font-mono {
+  font-family: var(--font-mono);
+}
+
+/* Tabular numerals — critical for timestamps and metrics */
+.tabular {
+  font-variant-numeric: tabular-nums;
+  font-feature-settings: "tnum";
+}
+
+/* Subtle pulse for active/working states */
+@keyframes pulse-soft {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.5; }
+}
+
+.pulse-soft {
+  animation: pulse-soft 2s ease-in-out infinite;
+}
--- a/ui/src/lib/api.ts
+++ b/ui/src/lib/api.ts
@@ -0,0 +1,144 @@
+const BASE = '/api'
+
+async function request<T>(path: string, opts?: RequestInit): Promise<T> {
+  const res = await fetch(`${BASE}${path}`, {
+    headers: { 'Content-Type': 'application/json' },
+    ...opts,
+  })
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({ error: res.statusText }))
+    throw new Error(err.error || res.statusText)
+  }
+  return res.json()
+}
+
+export interface Plan {
+  id: number
+  title: string
+  description: string
+  team: string
+  priority: string
+  status: string
+  created_at: string
+  updated_at: string
+  approved_at?: string
+  started_at?: string
+  completed_at?: string
+}
+
+export interface Task {
+  id: number
+  plan_id: number
+  title: string
+  description?: string
+  task_type: string
+  status: string
+  assigned_agent?: string
+  progress_note?: string
+  sort_order: number
+  created_at?: string
+  updated_at?: string
+  started_at?: string
+  completed_at?: string
+}
+
+export interface Agent {
+  id: string
+  name: string
+  team: string
+  role: string
+  model_provider: string
+  model_id: string
+  gpu_default?: string
+  status: string
+  current_task_id?: number
+  last_seen_at?: string
+}
+
+export interface QueueItem {
+  id: number
+  plan_id?: number
+  task_id?: number
+  status: string
+  verification_notes?: string
+  director_notes?: string
+  submitted_at: string
+  reviewed_at?: string
+  plan_title: string
+  task_title: string
+}
+
+export interface PendingQuestion {
+  id: number
+  plan_id?: number
+  task_id?: number
+  from_role: string
+  from_id: string
+  question: string
+  context?: string
+  priority: string
+  status: string
+  answer?: string
+  created_at: string
+  answered_at?: string
+  plan_title?: string
+  task_title?: string
+}
+
+export interface Message {
+  id: number
+  plan_id: number
+  task_id?: number
+  reply_to_id?: number
+  from_role: string
+  from_id: string
+  message: string
+  message_type: string
+  created_at: string
+}
+
+export interface ClaudeMode {
+  mode: 'api' | 'proxy' | 'unknown'
+  output: string
+}
+
+export const api = {
+  system: {
+    getClaudeMode: () => request<ClaudeMode>('/system/claude-mode'),
+    setClaudeMode: (mode: 'api' | 'proxy') =>
+      request<ClaudeMode>('/system/claude-mode', {
+        method: 'POST',
+        body: JSON.stringify({ mode }),
+      }),
+  },
+  plans: {
+    list: () => request<Plan[]>('/plans'),
+    get: (id: number) => request<Plan>(`/plans/${id}`),
+    create: (data: Partial<Plan>) => request<Plan>('/plans', { method: 'POST', body: JSON.stringify(data) }),
+    update: (id: number, data: Partial<Plan>) => request<Plan>(`/plans/${id}`, { method: 'PATCH', body: JSON.stringify(data) }),
+  },
+  tasks: {
+    list: (planId: number) => request<Task[]>(`/plans/${planId}/tasks`),
+    create: (planId: number, data: Partial<Task>) => request<Task>(`/plans/${planId}/tasks`, { method: 'POST', body: JSON.stringify(data) }),
+    update: (id: number, data: Partial<Task>) => request<Task>(`/tasks/${id}`, { method: 'PATCH', body: JSON.stringify(data) }),
+  },
+  agents: {
+    list: () => request<Agent[]>('/agents'),
+  },
+  queue: {
+    list: (status?: string) => request<QueueItem[]>(`/queue${status ? `?status=${status}` : ''}`),
+    update: (id: number, data: { status: string; director_notes?: string }) => request<QueueItem>(`/queue/${id}`, { method: 'PATCH', body: JSON.stringify(data) }),
+  },
+  questions: {
+    list: (status?: string) => request<PendingQuestion[]>(`/questions${status ? `?status=${status}` : ''}`),
+    answer: (id: number, answer: string) => request<{ id: number; status: string }>(`/questions/${id}`, {
+      method: 'PATCH',
+      body: JSON.stringify({ answer }),
+    }),
+  },
+  messages: {
+    list: (planId: number) => request<Message[]>(`/plans/${planId}/messages`),
+    create: (planId: number, data: Partial<Message>) => request<Message>(`/plans/${planId}/messages`, { method: 'POST', body: JSON.stringify(data) }),
+    update: (id: number, message: string) => request<{ id: number; message: string }>(`/messages/${id}`, { method: 'PATCH', body: JSON.stringify({ message }) }),
+  },
+}
--- a/ui/src/lib/time.ts
+++ b/ui/src/lib/time.ts
@@ -0,0 +1,26 @@
+// Relative time formatter — "3m ago", "2h ago", "5d ago"
+export function relativeTime(iso: string): string {
+  const then = new Date(iso).getTime()
+  const diff = Date.now() - then
+  const sec = Math.floor(diff / 1000)
+  if (sec < 10) return 'just now'
+  if (sec < 60) return `${sec}s ago`
+  const min = Math.floor(sec / 60)
+  if (min < 60) return `${min}m ago`
+  const hr = Math.floor(min / 60)
+  if (hr < 24) return `${hr}h ago`
+  const day = Math.floor(hr / 24)
+  if (day < 7) return `${day}d ago`
+  const wk = Math.floor(day / 7)
+  if (wk < 5) return `${wk}w ago`
+  const mo = Math.floor(day / 30)
+  if (mo < 12) return `${mo}mo ago`
+  return `${Math.floor(day / 365)}y ago`
+}
+
+export function absoluteTime(iso: string): string {
+  return new Date(iso).toLocaleString(undefined, {
+    year: 'numeric', month: 'short', day: 'numeric',
+    hour: 'numeric', minute: '2-digit',
+  })
+}
--- a/ui/src/main.tsx
+++ b/ui/src/main.tsx
@@ -0,0 +1,10 @@
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import './index.css'
+import App from './App.tsx'
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+)
				`@@ -0,0 +1 @@`
				<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="35.93" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228"><path fill="#00D8FF" d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path></svg>