From 42bb6432d3e53042723b43330c22eafbf553e10f Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Mon, 25 May 2026 05:09:10 +0000
Subject: refactor(web): remove the create-task modal from the UI (Phase 3)

The observability UI no longer creates tasks; chatbots do that via the chatbot
MCP server. Removes the New Task button, the #task-modal (manual form + the
now-defunct AI-elaborate textbox + validate panel), their handlers
(elaborateTask/validateTask/buildValidatePayload/renderValidationResult/
openTaskModal/closeTaskModal/createTask) and the orphaned
newTaskButtonShouldShowOnTab helper plus its test.

Verified with node --test (267 JS tests pass) and a JS syntax check. Not
browser-verified in this environment.

https://claude.ai/code/session_01SESwn7kQ7oP62trWw6pc39
---
 web/index.html | 45 ---------------------------------------------
 1 file changed, 45 deletions(-)

(limited to 'web/index.html')

diff --git a/web/index.html b/web/index.html
index 0632cd7..d3bf81b 100644
--- a/web/index.html
+++ b/web/index.html
@@ -36,7 +36,6 @@
       </select>
       <button id="btn-notifications" class="btn-secondary" title="Enable push notifications">🔔</button>
       <button id="btn-start-next" class="btn-secondary">Start Next</button>
-      <button id="btn-new-task" class="btn-primary">New Task</button>
     </div>
   </header>
   <nav class="tab-bar">
@@ -76,50 +75,6 @@
     </div>
   </main>
 
-  <dialog id="task-modal">
-    <form id="task-form" method="dialog">
-      <h2>New Task</h2>
-      <div class="elaborate-section">
-        <label>Describe what you want the agent to do
-          <textarea id="elaborate-prompt" rows="3"
-            placeholder="e.g. run tests with race detector and check coverage"></textarea>
-        </label>
-        <button type="button" id="btn-elaborate" class="btn-secondary">
-          Draft with AI ✦
-        </button>
-        <p class="elaborate-hint">AI will fill in the form fields below. You can edit before submitting.</p>
-      </div>
-      <hr class="form-divider">
-      <label>Repository URL
-        <input name="repository_url" id="repository-url" placeholder="https://github.com/user/repo.git" required>
-      </label>
-      <label>Container Image
-        <input name="container_image" id="container-image" placeholder="claudomator-agent:latest" value="claudomator-agent:latest">
-      </label>
-      <label>Name <input name="name" required></label>
-      <label>Instructions <textarea name="instructions" rows="6" required></textarea></label>
-      <div class="validate-section">
-        <button type="button" id="btn-validate" class="btn-secondary">
-          Validate Instructions
-        </button>
-        <div id="validate-result" hidden></div>
-      </div>
-      <label>Max Budget (USD) <input name="max_budget_usd" type="number" step="0.01" value="1.00"></label>
-      <label>Timeout <input name="timeout" value="15m"></label>
-      <label>Priority
-        <select name="priority">
-          <option value="normal" selected>Normal</option>
-          <option value="high">High</option>
-          <option value="low">Low</option>
-        </select>
-      </label>
-      <div class="form-actions">
-        <button type="button" id="btn-cancel-task">Cancel</button>
-        <button type="submit" class="btn-primary">Create &amp; Queue</button>
-      </div>
-    </form>
-  </dialog>
-
   <!-- Side panel backdrop -->
   <div id="task-panel-backdrop" class="panel-backdrop" hidden></div>
 
-- 
cgit v1.2.3


From 5669e2ca58b4a99616083eaff9f639ecce4ba809 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Mon, 25 May 2026 05:12:54 +0000
Subject: refactor(web): remove the stories dashboard from the UI (Phase 3)

The observability UI drops the stories surface: the Stories tab, the stories
panel, the New/Detail story modals, and all their app.js code
(STORY_STATUS_LABELS, storyStatusLabel, renderStoryCard, renderStoriesPanel,
openStoryDetail, openStoryModal, renderElaboratedPlan, the story-modal init
handlers, and the panel-dispatch 'stories' case) plus stories.test.mjs.

The stories BACKEND (table, /api/stories* handlers, story-elaborate) is left
intact for the Phase 8 cleanup pass; this only removes the UI surface. Dead CSS
for the removed elements is likewise deferred to Phase 8.

Verified with node --test (251 JS tests pass) and a module-import check. Not
browser-verified in this environment.

https://claude.ai/code/session_01SESwn7kQ7oP62trWw6pc39
---
 web/app.js                | 383 ----------------------------------------------
 web/index.html            |  32 ----
 web/test/stories.test.mjs | 164 --------------------
 3 files changed, 579 deletions(-)
 delete mode 100644 web/test/stories.test.mjs

(limited to 'web/index.html')

diff --git a/web/app.js b/web/app.js
index 0a66a11..8a2662f 100644
--- a/web/app.js
+++ b/web/app.js
@@ -611,90 +611,6 @@ export function computeExecutionStats(executions) {
   };
 }
 
-// ── Stories ───────────────────────────────────────────────────────────────────
-
-const STORY_STATUS_LABELS = {
-  PENDING:      'Pending',
-  IN_PROGRESS:  'In Progress',
-  SHIPPABLE:    'Shippable',
-  DEPLOYED:     'Deployed',
-  VALIDATING:   'Validating',
-  REVIEW_READY: 'Review Ready',
-  NEEDS_FIX:    'Needs Fix',
-};
-
-export function storyStatusLabel(status) {
-  return STORY_STATUS_LABELS[status] || status;
-}
-
-export function renderStoryCard(story, doc = document) {
-  const card = doc.createElement('div');
-  card.className = 'story-card';
-  card.dataset.storyId = story.id;
-
-  const header = doc.createElement('div');
-  header.className = 'story-card-header';
-
-  const name = doc.createElement('span');
-  name.className = 'story-name';
-  name.textContent = story.name;
-  header.appendChild(name);
-
-  const badge = doc.createElement('span');
-  badge.className = 'story-status-badge';
-  badge.dataset.status = story.status;
-  badge.textContent = storyStatusLabel(story.status);
-  header.appendChild(badge);
-
-  card.appendChild(header);
-
-  const meta = doc.createElement('div');
-  meta.className = 'story-meta';
-
-  const project = doc.createElement('span');
-  project.className = 'story-project';
-  project.textContent = story.project_id || '—';
-  meta.appendChild(project);
-
-  if (story.branch_name) {
-    const branch = doc.createElement('span');
-    branch.className = 'story-branch';
-    branch.textContent = story.branch_name;
-    meta.appendChild(branch);
-  }
-
-  card.appendChild(meta);
-
-  // Ship button for SHIPPABLE stories.
-  if (story.status === 'SHIPPABLE') {
-    const shipBtn = doc.createElement('button');
-    shipBtn.className = 'btn-primary story-ship-btn';
-    shipBtn.textContent = 'Ship';
-    shipBtn.addEventListener('click', async (e) => {
-      e.stopPropagation();
-      shipBtn.disabled = true;
-      shipBtn.textContent = 'Shipping…';
-      try {
-        const res = await fetch(`${API_BASE}/api/stories/${story.id}/ship`, { method: 'POST' });
-        if (!res.ok) {
-          const body = await res.json().catch(() => ({}));
-          alert(body.error || `Ship failed (${res.status})`);
-          shipBtn.disabled = false;
-          shipBtn.textContent = 'Ship';
-        } else {
-          renderStoriesPanel();
-        }
-      } catch {
-        shipBtn.disabled = false;
-        shipBtn.textContent = 'Ship';
-      }
-    });
-    card.appendChild(shipBtn);
-  }
-
-  return card;
-}
-
 export function updateFilterTabs() {
   const current = getTaskFilterTab();
   document.querySelectorAll('.filter-tab[data-filter]').forEach(el => {
@@ -1370,9 +1286,6 @@ function renderActiveTab(allTasks) {
         .then(([execs, agentData, dashStats]) => renderStatsPanel(allTasks, execs, agentData, dashStats))
         .catch(() => {});
       break;
-    case 'stories':
-      renderStoriesPanel();
-      break;
     case 'drops':
       renderDropsPanel();
       break;
@@ -3073,217 +2986,6 @@ async function fetchDrops() {
 
 // ── Stories panel ─────────────────────────────────────────────────────────────
 
-async function renderStoriesPanel() {
-  const panel = document.querySelector('[data-panel="stories"]');
-  if (!panel) return;
-
-  let stories;
-  try {
-    const res = await fetch(`${BASE_PATH}/api/stories`);
-    stories = res.ok ? await res.json() : [];
-  } catch {
-    panel.innerHTML = '<p class="task-meta" style="padding:1rem">Failed to load stories.</p>';
-    return;
-  }
-
-  panel.innerHTML = '';
-
-  const toolbar = document.createElement('div');
-  toolbar.className = 'stories-toolbar';
-  const btnNew = document.createElement('button');
-  btnNew.className = 'btn-primary';
-  btnNew.textContent = 'New Story';
-  btnNew.addEventListener('click', openStoryModal);
-  toolbar.appendChild(btnNew);
-  panel.appendChild(toolbar);
-
-  if (!stories || stories.length === 0) {
-    const empty = document.createElement('p');
-    empty.className = 'task-empty';
-    empty.textContent = 'No stories yet. Create one to get started.';
-    panel.appendChild(empty);
-    return;
-  }
-
-  const list = document.createElement('div');
-  list.className = 'stories-list';
-  for (const story of stories) {
-    const card = renderStoryCard(story);
-    card.addEventListener('click', () => openStoryDetail(story));
-    list.appendChild(card);
-  }
-  panel.appendChild(list);
-}
-
-function openStoryDetail(story) {
-  const modal = document.getElementById('story-detail-modal');
-  if (!modal) return;
-
-  document.getElementById('story-detail-name').textContent = story.name;
-
-  const body = document.getElementById('story-detail-body');
-  body.innerHTML = '';
-
-  function addRow(label, value) {
-    const row = document.createElement('div');
-    row.className = 'meta-item';
-    const lbl = document.createElement('div');
-    lbl.className = 'meta-label';
-    lbl.textContent = label;
-    const val = document.createElement('div');
-    val.className = 'meta-value';
-    val.textContent = value || '—';
-    row.appendChild(lbl);
-    row.appendChild(val);
-    body.appendChild(row);
-  }
-
-  const badge = document.createElement('span');
-  badge.className = 'story-status-badge';
-  badge.dataset.status = story.status;
-  badge.textContent = storyStatusLabel(story.status);
-
-  const statusRow = document.createElement('div');
-  statusRow.className = 'meta-item';
-  const statusLbl = document.createElement('div');
-  statusLbl.className = 'meta-label';
-  statusLbl.textContent = 'Status';
-  statusRow.appendChild(statusLbl);
-  statusRow.appendChild(badge);
-  body.appendChild(statusRow);
-
-  addRow('Project', story.project_id);
-  addRow('Branch', story.branch_name);
-  addRow('Created', story.created_at ? new Date(story.created_at).toLocaleString() : '—');
-
-  // Load tasks for this story.
-  const tasksSection = document.createElement('div');
-  tasksSection.className = 'story-detail-tasks';
-  tasksSection.innerHTML = '<p class="task-meta">Loading tasks…</p>';
-  body.appendChild(tasksSection);
-
-  fetch(`${API_BASE}/api/stories/${story.id}/tasks`)
-    .then(r => r.ok ? r.json() : [])
-    .then(async tasks => {
-      tasksSection.innerHTML = '';
-      const topLevel = tasks.filter(t => !t.parent_task_id);
-      if (topLevel.length === 0) {
-        tasksSection.innerHTML = '<p class="task-meta">No tasks yet.</p>';
-        return;
-      }
-      const ol = document.createElement('ol');
-      ol.className = 'story-detail-task-list';
-      for (const t of topLevel) {
-        const li = document.createElement('li');
-        li.className = `story-detail-task story-detail-task-${t.state.toLowerCase()}`;
-        li.textContent = `${STATE_EMOJI[t.state] || '•'} ${t.name}`;
-        const subs = tasks.filter(s => s.parent_task_id === t.id);
-        if (subs.length > 0) {
-          const ul = document.createElement('ul');
-          ul.className = 'story-detail-subtask-list';
-          for (const s of subs) {
-            const sli = document.createElement('li');
-            sli.className = `subtask-item subtask-${s.state.toLowerCase()}`;
-            sli.textContent = `${STATE_EMOJI[s.state] || '•'} ${s.name}`;
-            ul.appendChild(sli);
-          }
-          li.appendChild(ul);
-        }
-        ol.appendChild(li);
-      }
-      tasksSection.appendChild(ol);
-    })
-    .catch(() => { tasksSection.innerHTML = '<p class="task-meta">Could not load tasks.</p>'; });
-
-  modal.showModal();
-}
-
-function openStoryModal() {
-  const modal = document.getElementById('story-modal');
-  if (!modal) return;
-
-  // Reset form state
-  document.getElementById('story-goal').value = '';
-  const planArea = document.getElementById('story-plan-area');
-  planArea.innerHTML = '';
-  planArea.setAttribute('hidden', '');
-
-  const btnElaborate = document.getElementById('btn-story-elaborate');
-  btnElaborate.disabled = false;
-  btnElaborate.textContent = 'Elaborate with AI ✦';
-
-  const btnApprove = document.getElementById('btn-story-approve');
-  btnApprove.setAttribute('hidden', '');
-  btnApprove._elaboratedPlan = null;
-
-  // Populate project dropdown
-  fetch(`${BASE_PATH}/api/projects`)
-    .then(r => r.ok ? r.json() : [])
-    .then(projects => {
-      const sel = document.getElementById('story-project');
-      sel.innerHTML = '';
-      for (const p of projects) {
-        const opt = document.createElement('option');
-        opt.value = p.id;
-        opt.textContent = p.name;
-        sel.appendChild(opt);
-      }
-    })
-    .catch(() => {});
-
-  modal.showModal();
-}
-
-function renderElaboratedPlan(plan) {
-  const planArea = document.getElementById('story-plan-area');
-  planArea.innerHTML = '';
-  planArea.removeAttribute('hidden');
-
-  const nameEl = document.createElement('p');
-  nameEl.className = 'story-plan-name';
-  nameEl.textContent = `Story: ${plan.name}`;
-  planArea.appendChild(nameEl);
-
-  if (plan.branch_name) {
-    const branchEl = document.createElement('p');
-    branchEl.className = 'story-plan-branch';
-    branchEl.textContent = `Branch: ${plan.branch_name}`;
-    planArea.appendChild(branchEl);
-  }
-
-  if (plan.tasks && plan.tasks.length > 0) {
-    const tasksHeader = document.createElement('p');
-    tasksHeader.className = 'story-plan-section';
-    tasksHeader.textContent = `Tasks (${plan.tasks.length}):`;
-    planArea.appendChild(tasksHeader);
-
-    const taskList = document.createElement('ol');
-    taskList.className = 'story-plan-tasks';
-    for (const t of plan.tasks) {
-      const li = document.createElement('li');
-      li.textContent = t.name;
-      if (t.subtasks && t.subtasks.length > 0) {
-        const subList = document.createElement('ul');
-        for (const s of t.subtasks) {
-          const subLi = document.createElement('li');
-          subLi.textContent = s.name;
-          subList.appendChild(subLi);
-        }
-        li.appendChild(subList);
-      }
-      taskList.appendChild(li);
-    }
-    planArea.appendChild(taskList);
-  }
-
-  if (plan.validation && plan.validation.type) {
-    const valHeader = document.createElement('p');
-    valHeader.className = 'story-plan-section';
-    valHeader.textContent = `Validation: ${plan.validation.type}`;
-    planArea.appendChild(valHeader);
-  }
-}
-
 async function renderDropsPanel() {
   const panel = document.querySelector('[data-panel="drops"] .drops-panel');
   if (!panel) return;
@@ -3404,90 +3106,5 @@ if (typeof document !== 'undefined') {
     }
 
 
-    // Story modal
-    const storyModal = document.getElementById('story-modal');
-    if (storyModal) {
-      document.getElementById('btn-close-story-modal').addEventListener('click', () => storyModal.close());
-
-      document.getElementById('btn-story-elaborate').addEventListener('click', async () => {
-        const btn = document.getElementById('btn-story-elaborate');
-        const goal = document.getElementById('story-goal').value.trim();
-        const projectId = document.getElementById('story-project').value;
-
-        if (!goal) {
-          const errEl = document.createElement('p');
-          errEl.className = 'form-error';
-          errEl.textContent = 'Please enter a goal before elaborating.';
-          storyModal.querySelector('.story-modal-body').appendChild(errEl);
-          return;
-        }
-
-        storyModal.querySelectorAll('.form-error').forEach(el => el.remove());
-        btn.disabled = true;
-        btn.textContent = 'Elaborating…';
-
-        try {
-          const res = await fetch(`${BASE_PATH}/api/stories/elaborate`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ goal, project_id: projectId }),
-          });
-          if (!res.ok) {
-            const err = await res.json().catch(() => ({ error: res.statusText }));
-            throw new Error(err.error || res.statusText);
-          }
-          const plan = await res.json();
-          renderElaboratedPlan(plan);
-
-          const btnApprove = document.getElementById('btn-story-approve');
-          btnApprove._elaboratedPlan = { ...plan, project_id: projectId };
-          btnApprove.removeAttribute('hidden');
-        } catch (err) {
-          const errEl = document.createElement('p');
-          errEl.className = 'form-error';
-          errEl.textContent = `Elaboration failed: ${err.message}`;
-          storyModal.querySelector('.story-modal-body').appendChild(errEl);
-        } finally {
-          btn.disabled = false;
-          btn.textContent = 'Elaborate with AI ✦';
-        }
-      });
-
-      document.getElementById('btn-story-approve').addEventListener('click', async () => {
-        const btn = document.getElementById('btn-story-approve');
-        const plan = btn._elaboratedPlan;
-        if (!plan) return;
-
-        btn.disabled = true;
-        btn.textContent = 'Approving…';
-
-        try {
-          const res = await fetch(`${BASE_PATH}/api/stories/approve`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify(plan),
-          });
-          if (!res.ok) {
-            const err = await res.json().catch(() => ({ error: res.statusText }));
-            throw new Error(err.error || res.statusText);
-          }
-          storyModal.close();
-          renderStoriesPanel();
-        } catch (err) {
-          const errEl = document.createElement('p');
-          errEl.className = 'form-error';
-          errEl.textContent = `Approve failed: ${err.message}`;
-          storyModal.querySelector('.story-modal-body').appendChild(errEl);
-          btn.disabled = false;
-          btn.textContent = 'Approve & Queue';
-        }
-      });
-    }
-
-    // Story detail modal
-    const storyDetailModal = document.getElementById('story-detail-modal');
-    if (storyDetailModal) {
-      document.getElementById('btn-close-story-detail').addEventListener('click', () => storyDetailModal.close());
-    }
   });
 }
diff --git a/web/index.html b/web/index.html
index d3bf81b..8a705cc 100644
--- a/web/index.html
+++ b/web/index.html
@@ -39,7 +39,6 @@
     </div>
   </header>
   <nav class="tab-bar">
-    <button class="tab" data-tab="stories" title="Stories">📖</button>
     <button class="tab active" data-tab="queue" title="Queue">⏳</button>
     <button class="tab" data-tab="interrupted" title="Interrupted">⚠️<span class="tab-count-badge" hidden></span></button>
     <button class="tab" data-tab="ready" title="Ready">✅<span class="tab-count-badge" hidden></span></button>
@@ -68,7 +67,6 @@
     <div data-panel="drops" hidden>
       <div class="drops-panel"></div>
     </div>
-    <div data-panel="stories" hidden></div>
     <div data-panel="stats" hidden></div>
     <div data-panel="settings" hidden>
       <p class="task-meta" style="padding:1rem">Settings coming soon.</p>
@@ -97,36 +95,6 @@
     </div>
   </dialog>
 
-  <!-- New Story modal -->
-  <dialog id="story-modal">
-    <div class="story-modal-header">
-      <h2>New Story</h2>
-      <button id="btn-close-story-modal" class="btn-close-panel" aria-label="Close">&#x2715;</button>
-    </div>
-    <div class="story-modal-body">
-      <label>Project
-        <select id="story-project"></select>
-      </label>
-      <label>Goal
-        <textarea id="story-goal" rows="4" placeholder="Describe the feature or change you want to build…"></textarea>
-      </label>
-      <button type="button" id="btn-story-elaborate" class="btn-secondary">Elaborate with AI ✦</button>
-      <div id="story-plan-area" hidden></div>
-      <div class="form-actions">
-        <button type="button" id="btn-story-approve" class="btn-primary" hidden>Approve &amp; Queue</button>
-      </div>
-    </div>
-  </dialog>
-
-  <!-- Story detail modal -->
-  <dialog id="story-detail-modal">
-    <div class="story-modal-header">
-      <h2 id="story-detail-name">Story</h2>
-      <button id="btn-close-story-detail" class="btn-close-panel" aria-label="Close">&#x2715;</button>
-    </div>
-    <div id="story-detail-body" class="story-detail-body meta-grid"></div>
-  </dialog>
-
   <script type="module" src="app.js"></script>
 </body>
 </html>
diff --git a/web/test/stories.test.mjs b/web/test/stories.test.mjs
deleted file mode 100644
index 263f202..0000000
--- a/web/test/stories.test.mjs
+++ /dev/null
@@ -1,164 +0,0 @@
-// stories.test.mjs — TDD tests for stories UI functions.
-//
-// Run with: node --test web/test/stories.test.mjs
-
-import { describe, it, beforeEach } from 'node:test';
-import assert from 'node:assert/strict';
-import { renderStoryCard, storyStatusLabel } from '../app.js';
-
-// ── Minimal DOM mock ──────────────────────────────────────────────────────────
-
-function makeMockDoc() {
-  function createElement(tag) {
-    return {
-      tag,
-      className: '',
-      textContent: '',
-      innerHTML: '',
-      hidden: false,
-      dataset: {},
-      children: [],
-      _listeners: {},
-      style: {},
-      appendChild(child) { this.children.push(child); return child; },
-      prepend(...nodes) { this.children.unshift(...nodes); },
-      append(...nodes) { nodes.forEach(n => this.children.push(n)); },
-      addEventListener(ev, fn) { this._listeners[ev] = fn; },
-      querySelector(sel) {
-        const cls = sel.startsWith('.') ? sel.slice(1) : null;
-        function search(el) {
-          if (cls && el.className && el.className.split(' ').includes(cls)) return el;
-          for (const c of el.children || []) {
-            const found = search(c);
-            if (found) return found;
-          }
-          return null;
-        }
-        return search(this);
-      },
-      querySelectorAll(sel) {
-        const cls = sel.startsWith('.') ? sel.slice(1) : null;
-        const results = [];
-        function search(el) {
-          if (cls && el.className && el.className.split(' ').includes(cls)) results.push(el);
-          for (const c of el.children || []) search(c);
-        }
-        search(this);
-        return results;
-      },
-    };
-  }
-  return { createElement };
-}
-
-function makeStory(overrides = {}) {
-  return {
-    id: 'story-1',
-    name: 'Add login page',
-    project_id: 'claudomator',
-    branch_name: 'story/add-login-page',
-    status: 'PENDING',
-    created_at: '2026-03-25T10:00:00Z',
-    updated_at: '2026-03-25T10:00:00Z',
-    ...overrides,
-  };
-}
-
-// ── storyStatusLabel ──────────────────────────────────────────────────────────
-
-describe('storyStatusLabel', () => {
-  it('returns human-readable label for PENDING', () => {
-    assert.equal(storyStatusLabel('PENDING'), 'Pending');
-  });
-
-  it('returns human-readable label for IN_PROGRESS', () => {
-    assert.equal(storyStatusLabel('IN_PROGRESS'), 'In Progress');
-  });
-
-  it('returns human-readable label for SHIPPABLE', () => {
-    assert.equal(storyStatusLabel('SHIPPABLE'), 'Shippable');
-  });
-
-  it('returns human-readable label for DEPLOYED', () => {
-    assert.equal(storyStatusLabel('DEPLOYED'), 'Deployed');
-  });
-
-  it('returns human-readable label for VALIDATING', () => {
-    assert.equal(storyStatusLabel('VALIDATING'), 'Validating');
-  });
-
-  it('returns human-readable label for REVIEW_READY', () => {
-    assert.equal(storyStatusLabel('REVIEW_READY'), 'Review Ready');
-  });
-
-  it('returns human-readable label for NEEDS_FIX', () => {
-    assert.equal(storyStatusLabel('NEEDS_FIX'), 'Needs Fix');
-  });
-
-  it('falls back to the raw status for unknown values', () => {
-    assert.equal(storyStatusLabel('UNKNOWN_STATE'), 'UNKNOWN_STATE');
-  });
-});
-
-// ── renderStoryCard ───────────────────────────────────────────────────────────
-
-describe('renderStoryCard', () => {
-  let doc;
-  beforeEach(() => { doc = makeMockDoc(); });
-
-  it('renders the story name', () => {
-    const card = renderStoryCard(makeStory(), doc);
-    function findText(el, text) {
-      if (el.textContent === text) return true;
-      return (el.children || []).some(c => findText(c, text));
-    }
-    assert.ok(findText(card, 'Add login page'), 'card should contain story name');
-  });
-
-  it('has story-card class', () => {
-    const card = renderStoryCard(makeStory(), doc);
-    assert.ok(card.className.split(' ').includes('story-card'), 'root element should have story-card class');
-  });
-
-  it('status badge has data-status matching story status', () => {
-    const card = renderStoryCard(makeStory({ status: 'IN_PROGRESS' }), doc);
-    const badge = card.querySelector('.story-status-badge');
-    assert.ok(badge, 'badge element should exist');
-    assert.equal(badge.dataset.status, 'IN_PROGRESS');
-  });
-
-  it('status badge shows human-readable label', () => {
-    const card = renderStoryCard(makeStory({ status: 'REVIEW_READY' }), doc);
-    const badge = card.querySelector('.story-status-badge');
-    assert.equal(badge.textContent, 'Review Ready');
-  });
-
-  it('shows project_id', () => {
-    const card = renderStoryCard(makeStory({ project_id: 'nav' }), doc);
-    function findText(el, text) {
-      if (el.textContent === text) return true;
-      return (el.children || []).some(c => findText(c, text));
-    }
-    assert.ok(findText(card, 'nav'), 'card should show project_id');
-  });
-
-  it('shows branch_name when present', () => {
-    const card = renderStoryCard(makeStory({ branch_name: 'story/my-feature' }), doc);
-    function findText(el, text) {
-      if (el.textContent && el.textContent.includes(text)) return true;
-      return (el.children || []).some(c => findText(c, text));
-    }
-    assert.ok(findText(card, 'story/my-feature'), 'card should show branch_name');
-  });
-
-  it('does not show branch section when branch_name is empty', () => {
-    const card = renderStoryCard(makeStory({ branch_name: '' }), doc);
-    const branchEl = card.querySelector('.story-branch');
-    assert.ok(!branchEl, 'no .story-branch element when branch is empty');
-  });
-
-  it('card dataset.storyId is set to story id', () => {
-    const card = renderStoryCard(makeStory({ id: 'abc-123' }), doc);
-    assert.equal(card.dataset.storyId, 'abc-123');
-  });
-});
-- 
cgit v1.2.3


From ab4b364954af08fa602388495ca425eaef0abf74 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Tue, 26 May 2026 20:34:09 +0000
Subject: feat(api,web): budget headroom endpoint + UI chips (Phase 6)

Adds GET /api/budget returning per-provider rolling-window headroom (empty when
budget gating is unconfigured), wired from serve.go via SetBudget. The web UI
polls it and renders a chip per limited provider in the header, flagging any
under 20% remaining. New pure JS helpers formatBudgetHeadroom/
renderBudgetHeadroom are unit-tested; the endpoint is covered by Go handler
tests (empty/reports/500). UI render not browser-verified in this environment.

Completes Phase 6: spend accounting + dispatcher gating + observability surface.

https://claude.ai/code/session_01SESwn7kQ7oP62trWw6pc39
---
 internal/api/budget.go      | 36 ++++++++++++++++++++++++
 internal/api/budget_test.go | 68 +++++++++++++++++++++++++++++++++++++++++++++
 internal/api/server.go      |  2 ++
 internal/cli/serve.go       |  3 ++
 web/app.js                  | 48 ++++++++++++++++++++++++++++++++
 web/index.html              |  1 +
 web/style.css               | 21 ++++++++++++++
 web/test/budget.test.mjs    | 58 ++++++++++++++++++++++++++++++++++++++
 8 files changed, 237 insertions(+)
 create mode 100644 internal/api/budget.go
 create mode 100644 internal/api/budget_test.go
 create mode 100644 web/test/budget.test.mjs

(limited to 'web/index.html')

diff --git a/internal/api/budget.go b/internal/api/budget.go
new file mode 100644
index 0000000..eee5d09
--- /dev/null
+++ b/internal/api/budget.go
@@ -0,0 +1,36 @@
+package api
+
+import (
+	"net/http"
+
+	"github.com/thepeterstone/claudomator/internal/budget"
+)
+
+// budgetReporter exposes per-provider spend headroom. Satisfied by
+// *budget.Accountant; an interface keeps the handler testable.
+type budgetReporter interface {
+	All() ([]budget.Headroom, error)
+}
+
+// SetBudget wires the budget accountant so GET /api/budget can report headroom.
+func (s *Server) SetBudget(b budgetReporter) {
+	s.budget = b
+}
+
+// handleGetBudget returns per-provider rolling-window spend headroom. When no
+// budget is configured it returns an empty list so the UI simply shows nothing.
+func (s *Server) handleGetBudget(w http.ResponseWriter, _ *http.Request) {
+	if s.budget == nil {
+		writeJSON(w, http.StatusOK, []budget.Headroom{})
+		return
+	}
+	hs, err := s.budget.All()
+	if err != nil {
+		writeJSON(w, http.StatusInternalServerError, map[string]string{"error": err.Error()})
+		return
+	}
+	if hs == nil {
+		hs = []budget.Headroom{}
+	}
+	writeJSON(w, http.StatusOK, hs)
+}
diff --git a/internal/api/budget_test.go b/internal/api/budget_test.go
new file mode 100644
index 0000000..d59836d
--- /dev/null
+++ b/internal/api/budget_test.go
@@ -0,0 +1,68 @@
+package api
+
+import (
+	"encoding/json"
+	"errors"
+	"net/http"
+	"net/http/httptest"
+	"testing"
+
+	"github.com/thepeterstone/claudomator/internal/budget"
+)
+
+type fakeBudget struct {
+	hs  []budget.Headroom
+	err error
+}
+
+func (f fakeBudget) All() ([]budget.Headroom, error) { return f.hs, f.err }
+
+func TestHandleGetBudget_NoBudgetConfigured_ReturnsEmpty(t *testing.T) {
+	srv, _ := testServer(t)
+	req := httptest.NewRequest("GET", "/api/budget", nil)
+	w := httptest.NewRecorder()
+	srv.Handler().ServeHTTP(w, req)
+
+	if w.Code != http.StatusOK {
+		t.Fatalf("status: want 200, got %d", w.Code)
+	}
+	var hs []budget.Headroom
+	if err := json.Unmarshal(w.Body.Bytes(), &hs); err != nil {
+		t.Fatalf("unmarshal: %v", err)
+	}
+	if len(hs) != 0 {
+		t.Errorf("want empty list, got %+v", hs)
+	}
+}
+
+func TestHandleGetBudget_ReportsHeadroom(t *testing.T) {
+	srv, _ := testServer(t)
+	srv.SetBudget(fakeBudget{hs: []budget.Headroom{
+		{Provider: "claude", Limited: true, Limit: 10, Spent: 4, Remaining: 6, Fraction: 0.6},
+	}})
+	req := httptest.NewRequest("GET", "/api/budget", nil)
+	w := httptest.NewRecorder()
+	srv.Handler().ServeHTTP(w, req)
+
+	if w.Code != http.StatusOK {
+		t.Fatalf("status: want 200, got %d", w.Code)
+	}
+	var hs []budget.Headroom
+	if err := json.Unmarshal(w.Body.Bytes(), &hs); err != nil {
+		t.Fatalf("unmarshal: %v", err)
+	}
+	if len(hs) != 1 || hs[0].Provider != "claude" || hs[0].Remaining != 6 {
+		t.Errorf("unexpected headroom: %+v", hs)
+	}
+}
+
+func TestHandleGetBudget_ErrorReturns500(t *testing.T) {
+	srv, _ := testServer(t)
+	srv.SetBudget(fakeBudget{err: errors.New("db down")})
+	req := httptest.NewRequest("GET", "/api/budget", nil)
+	w := httptest.NewRecorder()
+	srv.Handler().ServeHTTP(w, req)
+	if w.Code != http.StatusInternalServerError {
+		t.Errorf("want 500, got %d", w.Code)
+	}
+}
diff --git a/internal/api/server.go b/internal/api/server.go
index a4b7ea1..ffa8cd4 100644
--- a/internal/api/server.go
+++ b/internal/api/server.go
@@ -61,6 +61,7 @@ type Server struct {
 	pushStore        pushSubscriptionStore
 	dropsDir         string
 	llm              *llm.Client
+	budget           budgetReporter // optional; per-provider spend headroom for GET /api/budget
 }
 
 // SetAPIToken configures a bearer token that must be supplied to access the API.
@@ -147,6 +148,7 @@ func (s *Server) routes() {
 	s.mux.HandleFunc("GET /api/tasks/{id}/events", s.handleListTaskEvents)
 	s.mux.HandleFunc("GET /api/executions", s.handleListRecentExecutions)
 	s.mux.HandleFunc("GET /api/stats", s.handleGetDashboardStats)
+	s.mux.HandleFunc("GET /api/budget", s.handleGetBudget)
 	s.mux.HandleFunc("GET /api/agents/status", s.handleGetAgentStatus)
 	s.mux.HandleFunc("GET /api/executions/{id}", s.handleGetExecution)
 	s.mux.HandleFunc("GET /api/executions/{id}/log", s.handleGetExecutionLog)
diff --git a/internal/cli/serve.go b/internal/cli/serve.go
index 55fdaf5..7afa678 100644
--- a/internal/cli/serve.go
+++ b/internal/cli/serve.go
@@ -171,6 +171,9 @@ func serve(addr string) error {
 	pool.RecoverStaleBlocked()
 
 	srv := api.NewServer(store, pool, agentRegistry, logger, cfg.ClaudeBinaryPath, cfg.GeminiBinaryPath)
+	if accountant != nil {
+		srv.SetBudget(accountant)
+	}
 
 	// Configure notifiers: combine webhook (if set) with web push.
 	notifiers := []notify.Notifier{}
diff --git a/web/app.js b/web/app.js
index 8a2662f..7f96e09 100644
--- a/web/app.js
+++ b/web/app.js
@@ -198,6 +198,53 @@ export async function fetchTaskEvents(taskId, fetchImpl = (typeof fetch !== 'und
   }
 }
 
+// ── Budget headroom ─────────────────────────────────────────────────────────
+// Renders the per-provider rolling-window spend headroom from GET /api/budget.
+
+// formatBudgetHeadroom turns one provider's headroom into a short label.
+// Returns '' for unlimited providers (nothing to show).
+export function formatBudgetHeadroom(h) {
+  if (!h || !h.limited) return '';
+  const pct = Math.round((h.fraction_remaining || 0) * 100);
+  const remaining = (h.remaining_usd || 0).toFixed(2);
+  const limit = (h.limit_usd || 0).toFixed(2);
+  const name = h.provider ? h.provider.charAt(0).toUpperCase() + h.provider.slice(1) : '?';
+  return `${name}: ${pct}% left ($${remaining} of $${limit})`;
+}
+
+// renderBudgetHeadroom builds a <span> chip per limited provider, flagging
+// providers under 20% remaining with a --low modifier. Returns the container.
+export function renderBudgetHeadroom(headrooms, doc = (typeof document !== 'undefined' ? document : null)) {
+  if (doc == null) return null;
+  const wrap = doc.createElement('div');
+  wrap.className = 'budget-bar';
+  for (const h of headrooms || []) {
+    if (!h || !h.limited) continue;
+    const chip = doc.createElement('span');
+    chip.className = 'budget-chip' + ((h.fraction_remaining || 0) < 0.2 ? ' budget-chip--low' : '');
+    chip.textContent = formatBudgetHeadroom(h);
+    wrap.appendChild(chip);
+  }
+  return wrap;
+}
+
+// loadBudget fetches headroom and injects chips into #budget-bar. Best-effort.
+async function loadBudget(fetchImpl = (typeof fetch !== 'undefined' ? fetch : null)) {
+  if (!fetchImpl || typeof document === 'undefined') return;
+  const slot = document.getElementById('budget-bar');
+  if (!slot) return;
+  try {
+    const resp = await fetchImpl(`${BASE_PATH}/api/budget`);
+    if (!resp.ok) return;
+    const headrooms = await resp.json();
+    const rendered = renderBudgetHeadroom(headrooms);
+    slot.innerHTML = '';
+    if (rendered) for (const c of rendered.children) slot.appendChild(c);
+  } catch {
+    // budget display is non-critical; ignore.
+  }
+}
+
 function truncateToWordBoundary(text, maxLen = 120) {
   if (!text || text.length <= maxLen) return text;
   const cut = text.lastIndexOf(' ', maxLen);
@@ -1297,6 +1344,7 @@ function renderActiveTab(allTasks) {
 
 async function poll() {
   try {
+    loadBudget(); // fire-and-forget; budget can change independently of tasks
     const health = await fetchHealth();
     const serverUpdate = health.last_updated;
 
diff --git a/web/index.html b/web/index.html
index 8a705cc..5aa7b44 100644
--- a/web/index.html
+++ b/web/index.html
@@ -37,6 +37,7 @@
       <button id="btn-notifications" class="btn-secondary" title="Enable push notifications">🔔</button>
       <button id="btn-start-next" class="btn-secondary">Start Next</button>
     </div>
+    <div id="budget-bar" class="budget-bar"></div>
   </header>
   <nav class="tab-bar">
     <button class="tab active" data-tab="queue" title="Queue">⏳</button>
diff --git a/web/style.css b/web/style.css
index f4a9d91..b6f0484 100644
--- a/web/style.css
+++ b/web/style.css
@@ -2034,3 +2034,24 @@ dialog label select:focus {
   font-size: 0.85rem;
   padding: 6px 10px;
 }
+
+/* Budget headroom chips */
+.budget-bar {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  align-items: center;
+}
+.budget-chip {
+  font-size: 0.72rem;
+  padding: 2px 8px;
+  border-radius: 999px;
+  background: var(--bg);
+  border: 1px solid var(--border);
+  color: var(--text-muted);
+  white-space: nowrap;
+}
+.budget-chip--low {
+  border-color: var(--state-budget-exceeded);
+  color: var(--state-budget-exceeded);
+}
diff --git a/web/test/budget.test.mjs b/web/test/budget.test.mjs
new file mode 100644
index 0000000..35d5256
--- /dev/null
+++ b/web/test/budget.test.mjs
@@ -0,0 +1,58 @@
+// budget.test.mjs — Unit tests for budget headroom display.
+//
+// Run with: node --test web/test/budget.test.mjs
+
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { formatBudgetHeadroom, renderBudgetHeadroom } from '../app.js';
+
+function makeDoc() {
+  return {
+    createElement(tag) {
+      return {
+        tag,
+        className: '',
+        textContent: '',
+        children: [],
+        appendChild(child) { this.children.push(child); return child; },
+      };
+    },
+  };
+}
+
+describe('formatBudgetHeadroom', () => {
+  it('formats a limited provider with percent and dollars', () => {
+    assert.equal(
+      formatBudgetHeadroom({ provider: 'claude', limited: true, limit_usd: 10, remaining_usd: 6, fraction_remaining: 0.6 }),
+      'Claude: 60% left ($6.00 of $10.00)',
+    );
+  });
+
+  it('returns empty string for unlimited providers', () => {
+    assert.equal(formatBudgetHeadroom({ provider: 'local', limited: false }), '');
+    assert.equal(formatBudgetHeadroom(null), '');
+  });
+});
+
+describe('renderBudgetHeadroom', () => {
+  it('renders one chip per limited provider, skipping unlimited', () => {
+    const wrap = renderBudgetHeadroom([
+      { provider: 'claude', limited: true, limit_usd: 10, remaining_usd: 6, fraction_remaining: 0.6 },
+      { provider: 'local', limited: false },
+    ], makeDoc());
+    assert.equal(wrap.children.length, 1);
+    assert.equal(wrap.children[0].className, 'budget-chip');
+    assert.match(wrap.children[0].textContent, /Claude: 60% left/);
+  });
+
+  it('flags providers under 20% remaining with --low', () => {
+    const wrap = renderBudgetHeadroom([
+      { provider: 'gemini', limited: true, limit_usd: 5, remaining_usd: 0.5, fraction_remaining: 0.1 },
+    ], makeDoc());
+    assert.equal(wrap.children[0].className, 'budget-chip budget-chip--low');
+  });
+
+  it('returns null when doc is null', () => {
+    assert.equal(renderBudgetHeadroom([], null), null);
+  });
+});
-- 
cgit v1.2.3