karajan-code 4.70.3 → 5.0.0

package/packages/hu-board/public/utils/command-launcher.js

@@ -17,39 +17,19 @@
 // ---- Command launcher modal ----
 //
 // Opens a small form inside the existing <dialog> singleton with a
-// command picker (plan / architect / clean) and the appropriate
+// command picker (today: clean) and the appropriate
 // fields per command. Submit POSTs to /api/commands/:command, the
 // server spawns a detached `kj` child, and we open the existing log
-// viewer (re-uses openLogViewer's tail loop, just pointed at the
-// new generic /api/runs/:commandId/log endpoint).
+// viewer (openGenericLogPanel's tail loop, pointed at the
+// generic /api/runs/:commandId/log endpoint).
 
 
 async function showCommandLauncher() {
   const dlg = ensureDialog();
   // Per-command field schemas — kept in the client because each
   // command has different inputs and the modal renders accordingly.
+  // KJC-TSK-1323: kj plan (generate) and kj architect left with 5.0, which retired them.
   const SCHEMAS = {
-    plan: {
-      label: '📋 kj plan',
-      help: 'Generate an implementation plan with HUs. Paste the task text OR a file path.',
-      fields: [
-        { name: 'taskFile', label: 'SPEC file path (absolute)', type: 'text', placeholder: '/home/me/project/SPEC.md' },
-        { name: 'task', label: 'OR paste task text directly', type: 'textarea', rows: 6 },
-        { name: 'context', label: 'Extra context (optional)', type: 'text' },
-        { name: 'projectDir', label: 'Project directory (optional, defaults to board\'s cwd)', type: 'text' },
-        { name: 'quick', label: '--quick (skip synth + reviewer)', type: 'checkbox' },
-      ],
-    },
-    architect: {
-      label: '🏛 kj architect',
-      help: 'Design an architecture and persist ADRs. Same input as kj plan.',
-      fields: [
-        { name: 'taskFile', label: 'SPEC file path (absolute)', type: 'text', placeholder: '/home/me/project/SPEC.md' },
-        { name: 'task', label: 'OR paste task text directly', type: 'textarea', rows: 6 },
-        { name: 'context', label: 'Extra context (optional)', type: 'text' },
-        { name: 'projectDir', label: 'Project directory (optional)', type: 'text' },
-      ],
-    },
     clean: {
       label: '🧹 kj clean',
       help: 'Garbage-collect plans / sessions / batches. --nuke wipes everything including the board DB.',
@@ -60,25 +40,10 @@ async function showCommandLauncher() {
     },
   };
 
-  // Maggle mode (KJC-TSK-0810 AC2): the frequent action leads in plain
-  // language — one textarea, clear promise of what will happen. The full
-  // technical launcher (file paths, architect, clean) stays one click
-  // away behind "Más opciones…".
-  const maggle = isMaggleMode();
-  let advancedVisible = !maggle;
-  if (maggle) {
-    SCHEMAS.plan.label = maggleText('launcher.planLabel', SCHEMAS.plan.label);
-    SCHEMAS.plan.help = maggleText('launcher.planHelp', SCHEMAS.plan.help);
-    SCHEMAS.plan.simpleFields = [
-      { name: 'task', label: maggleText('launcher.taskLabel', 'Task'), type: 'textarea', rows: 6 },
-    ];
-  }
-
-  let active = 'plan';
+  let active = 'clean';
   const renderForm = () => {
     const s = SCHEMAS[active];
-    const visibleFields = (!advancedVisible && s.simpleFields) ? s.simpleFields : s.fields;
-    const fields = visibleFields.map((f) => {
+    const fields = s.fields.map((f) => {
       const id = `cmd-field-${f.name}`;
       if (f.type === 'textarea') {
         return `
@@ -112,7 +77,7 @@ async function showCommandLauncher() {
         </button>
       </div>
       <div style="padding:12px 18px;display:flex;gap:8px;border-bottom:1px solid var(--border)">
-        ${Object.entries(SCHEMAS).filter(([key]) => advancedVisible || key === 'plan').map(([key, s]) => `
+        ${Object.entries(SCHEMAS).map(([key, s]) => `
           <button type="button" data-cmd="${key}"
                   style="padding:6px 12px;border:1px solid var(--border);
                          background:${key === active ? 'var(--color-green)' : 'var(--bg-primary)'};
@@ -121,13 +86,6 @@ async function showCommandLauncher() {
             ${esc(s.label)}
           </button>
         `).join('')}
-        ${maggle && !advancedVisible ? `
-          <button type="button" id="cmd-more"
-                  style="margin-left:auto;padding:6px 12px;border:1px solid var(--border);background:var(--bg-primary);color:var(--text-muted);border-radius:var(--radius-sm);cursor:pointer;font-size:0.85rem"
-                  title="Comandos técnicos: kj plan con ficheros, kj architect, kj clean">
-            ${esc(maggleText('launcher.more', 'More…'))}
-          </button>
-        ` : ''}
       </div>
       <form id="cmd-form" onsubmit="return false"
             style="padding:14px 18px;display:flex;flex-direction:column;gap:12px;width:min(640px, 88vw);box-sizing:border-box">
@@ -149,8 +107,6 @@ async function showCommandLauncher() {
     dlg.querySelectorAll('[data-cmd]').forEach((btn) => {
       btn.addEventListener('click', () => { active = btn.dataset.cmd; renderForm(); });
     });
-    const moreBtn = dlg.querySelector('#cmd-more');
-    if (moreBtn) moreBtn.addEventListener('click', () => { advancedVisible = true; renderForm(); });
     dlg.querySelector('#cmd-close').addEventListener('click', () => dlg.close());
     dlg.querySelector('#cmd-cancel').addEventListener('click', () => dlg.close());
     dlg.querySelector('#cmd-submit').addEventListener('click', () => submitCommand(active));
@@ -168,23 +124,6 @@ async function showCommandLauncher() {
         if (v) body[f.name] = v;
       }
     }
-    // plan / architect: at least one of taskFile or task is required.
-    if ((command === 'plan' || command === 'architect') && !body.taskFile && !body.task) {
-      await showError(
-        maggle ? 'Escribe primero qué quieres pedir — con tus palabras vale.' : 'Provide either a SPEC file path or paste the task text.',
-        { title: 'Missing input' }
-      );
-      return;
-    }
-    // AC2: before launching, the maggle confirms knowing exactly what
-    // will happen — in their language, never a command name alone.
-    if (maggle && command === 'plan') {
-      const ok = await showConfirm(maggleText('launcher.confirm', ''), {
-        title: SCHEMAS.plan.label,
-        okLabel: maggleText('launcher.submit', 'Run'),
-      });
-      if (!ok) return;
-    }
     if (command === 'clean' && body.nuke) {
       const ok = await showConfirm(
         '`kj clean --nuke` will delete EVERY plan / session / batch + wipe the HU Board DB. Cannot be undone.',
@@ -220,8 +159,7 @@ async function showCommandLauncher() {
 
 /**
  * Open the run-log panel pointed at a /api/runs/<commandId>/log
- * tail. Reuses the same panel UI as openLogViewer() for plans —
- * just swaps the URL it polls.
+ * tail, with the generic panel UI (openGenericLogPanel).
  */
 function openCommandLogViewer(commandLabel, commandId) {
   const args = {

package/packages/hu-board/public/utils/formatters.js

@@ -161,6 +161,16 @@ function formatDuration(ms) {
   return `${min}m ${sec.toString().padStart(2, '0')}s`;
 }
 
+// KJC-TSK-0403 + KJC-BUG-0405: the three kanban lanes, one place for every view. A failed
+// HU goes back to Pending with its badge; `running` is what kj hu move and the shared-board
+// mirror write, next to the pipeline's coding/reviewing.
+const KANBAN_RUNNING = new Set(['coding', 'reviewing', 'running']);
+function kanbanColumnOf(status) {
+  if (KANBAN_RUNNING.has(status)) return 'running';
+  if (status === 'done') return 'done';
+  return 'pending';
+}
+
 function scoreClass(score, max = 60) {
   if (score === null || score === undefined) return '';
   const pct = score / max;

package/packages/hu-board/public/utils/governance-view.js

@@ -23,7 +23,7 @@ async function renderGovernance() {
       return;
     }
     localStorage.setItem(GOV_DIR_KEY, data.dir);
-    app.innerHTML = govDirForm(data.dir) + govIdentity(data.identity) + govChain(data.report, data.anchor) + govRules(data.policy, data.report) + govGrants(data.report.grants, data.policy) + govSignals(data.report.signals);
+    app.innerHTML = govDirForm(data.dir) + govIdentity(data.identity) + govChain(data.report, data.anchor) + govRules(data.policy, data.report) + govGrants(data.report.grants, data.policy) + govSignals(data.report.signals) + govLanes(data.lanes);
   } catch (err) {
     app.innerHTML = govDirForm(dir) + `<div class="empty-state"><div class="empty-state__title">Governance unavailable</div><div class="empty-state__text">${esc(err.message)}</div></div>`;
   }
@@ -146,4 +146,16 @@ function govGrants(g, policy) {
   return `<div class="section-header"><span class="section-header__title">Standing exceptions</span><span class="section-header__count">${(g.alive || []).length} alive · ${(g.soon || []).length} expiring · ${(g.expired || []).length} expired · ${g.point || 0} one-off</span></div>${alive}${renewals ? `<ul class="gov-list">${renewals}</ul>` : ''}${form}<p id="gov-msg" class="gov-note"></p>`;
 }
 
+// KJC-TSK-1314: worktree lanes outside the method, each with what to do about it.
+function govLanes(lanes) {
+  if (!lanes) return '';
+  const head = '<div class="section-header"><span class="section-header__title">Lanes</span></div>';
+  if (lanes.error) return `${head}<p class="gov-note">⚠ ${esc(lanes.error)}</p>`;
+  const items = [
+    ...lanes.noCard.map((l) => `<li>⚠ ${esc(l.slug)} (${esc(l.branch)}): its branch names no card. Work starts from a card.</li>`),
+    ...lanes.merged.map((l) => `<li>⚠ ${esc(l.slug)}: PR #${esc(String(l.pr))} is merged and the lane is still there: <code>${esc(l.done)}</code></li>`),
+  ];
+  return head + (items.length ? `<ul class="gov-list">${items.join('')}</ul>` : '<p class="gov-note">Every lane works a card and none is left over.</p>');
+}
+
 const govSignals = (signals) => `<div class="section-header"><span class="section-header__title">Signals</span></div>${(signals || []).length ? `<ul class="gov-list">${signals.map((s) => `<li>⚠ ${esc(s)}</li>`).join('')}</ul>` : '<p class="gov-note">None.</p>'}`;

package/packages/hu-board/public/utils/hu-actions.js

@@ -14,58 +14,6 @@
 //   - lastOpenedLog              (mutable in app.js — assignment crosses scripts
 //                                 transparently because both share the same realm)
 
-/**
- * PR4: launch a single HU from the per-card ▶ button. Confirms with
- * the user (so an accidental click doesn't kick a run) and POSTs to
- * the new /api/hus/:huId/run endpoint, which resolves the planId
- * server-side from the SQLite row.
- *
- * Exposed on `window` because the inline onclick on the card calls it.
- */
-window.runSingleHuFromCard = async function runSingleHuFromCard(huId, title) {
-  const friendlyTitle = (title || huId).replace(/'/g, "'");
-  const ok = await showConfirm(
-    `¿Lanzar solo esta HU?\n\n${friendlyTitle}\n\nKarajan ejecutará únicamente esta HU; las demás del plan no se tocarán.`,
-    { title: 'Lanzar HU individual', okLabel: 'Lanzar', cancelLabel: 'Cancelar' }
-  );
-  if (!ok) return;
-  try {
-    const res = await fetch(`/api/hus/${encodeURIComponent(huId)}/run`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({}),
-    });
-    if (!res.ok) {
-      const msg = (await res.json().catch(() => ({}))).error || `HTTP ${res.status}`;
-      await showError(msg, { title: 'No se pudo lanzar la HU' });
-      return;
-    }
-    const body = await res.json();
-    // Surface the log path so the user can tail it from the View log button
-    // AND auto-open the viewer so the click produces visible feedback. Without
-    // the open, the user clicks Lanzar, sees nothing change, and concludes the
-    // run never started — the run IS started, the log IS being written, the
-    // UI just wasn't showing it.
-    //
-    // The tail URL must be derived from body.logPath, not constructed from
-    // huId. When `kj run --plan ... --hu <id>` is launched, runPlan writes to
-    //   <runsDir>/<planId>--hu-<localHuId>.log
-    // — not <runsDir>/hu-<huId>.log. The previous code guessed the wrong
-    // filename and the viewer would have hit a non-existent file even if
-    // it had been opened.
-    if (body.logPath) {
-      const logBasename = body.logPath.split('/').pop().replace(/\.log$/, '');
-      const tailUrl = (offset) => `/api/runs/${encodeURIComponent(logBasename)}/log?offset=${offset || 0}`;
-      lastOpenedLog = { id: `hu-${huId}`, label: `HU ${huId}`, tailUrl };
-      openGenericLogPanel({ id: logBasename, label: `HU ${huId}`, tailUrl });
-    }
-    await fetch('/api/sync', { method: 'POST' }).catch(() => {});
-    await renderBoard();
-  } catch (err) {
-    await showError(err.message || String(err), { title: 'Fallo al lanzar la HU' });
-  }
-};
-
 /**
  * KJC-TSK-0394 step 2: devolver una HU al estado `pending` desde
  * cualquier estado no-terminal (coding/reviewing/blocked zombi) o
@@ -174,27 +122,28 @@ window.saveHuAssignee = async function saveHuAssignee(storyId) {
   }
 };
 
-// KJC-TSK-0408: deshace los cambios de una HU restaurando el snapshot
-// git tomado pre-run. ATENCIÓN: es destructivo (git reset --hard) —
-// confirmamos siempre antes de invocar.
-window.undoHuChanges = async function undoHuChanges(storyId) {
+// KJC-TSK-1324: the ▶ of a card. Board story ids are `<project>::<hu id>` (sync.js).
+window.startCardLane = async function startCardLane(storyId, event) {
+  event?.stopPropagation();
+  const [project, huId] = String(storyId).split('::');
+  if (!project || !huId) return showError(`Not a board card: ${storyId}`, { title: 'Cannot start the card' });
   const ok = await showConfirm(
-    '⚠️ Esta acción es destructiva.\n\nSe descartan los cambios de ficheros que esta HU hizo durante su última ejecución y se restaura el estado pre-run. La HU vuelve a pending y podrás relanzarla con otros modelos.\n\n¿Continuar?',
-    { title: 'Deshacer cambios de la HU', okLabel: 'Deshacer', cancelLabel: 'Cancelar' }
+    `Start ${huId}?\n\nkj opens its lane, moves the card to running and your panel's coder writes it there. Reviewing and committing stay with you.`,
+    { title: 'Start card', okLabel: 'Start' }
   );
   if (!ok) return;
   try {
-    const res = await fetch(`/api/stories/${encodeURIComponent(storyId)}/undo`, { method: 'POST' });
-    if (!res.ok) {
-      const msg = (await res.json().catch(() => ({}))).error || `HTTP ${res.status}`;
-      await showError(msg, { title: 'No se pudo deshacer la HU' });
-      return;
-    }
-    closeModal();
-    await fetch('/api/sync', { method: 'POST' }).catch(() => {});
-    await renderBoard();
+    const res = await fetch(`/api/hu/${encodeURIComponent(huId)}/start`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ project }),
+    });
+    const payload = await res.json().catch(() => ({}));
+    if (res.status === 409) return showError(`${huId} already has a lane. Open it with:\n\ncd ${payload.lane}`, { title: 'Card already started' });
+    if (!res.ok) return showError(payload.error || `HTTP ${res.status}`, { title: 'Could not start the card' });
+    openCommandLogViewer(`hu start ${huId}`, payload.commandId);
   } catch (err) {
-    await showError(err.message || String(err), { title: 'Fallo al deshacer la HU' });
+    await showError(err.message || String(err), { title: 'Could not start the card' });
   }
 };
 

package/packages/hu-board/public/utils/init-listeners.js

@@ -15,8 +15,7 @@
 //   - showStoryDetail()               (utils/story-detail-view.js)
 //   - showSessionDetail()             (utils/sessions-view.js)
 //   - selectProject()                 (app.js)
-//   - triggerSync(),
-//     startStandbyPolling()           (utils/api.js)
+//   - triggerSync()                   (utils/api.js)
 //   - subscribeToServerEvents(),
 //     smartRefresh()                  (utils/server-push.js)
 //   - selectedProject, currentView,
@@ -45,7 +44,7 @@ document.getElementById('sync-btn').addEventListener('click', async () => {
 });
 
 // Commands button — opens the launcher modal so the user can run
-// `kj plan`, `kj architect`, `kj clean` (and more later) without
+// `kj clean` (and more later) without
 // dropping to a terminal. Output streams to the existing log panel.
 document.getElementById('commands-btn').addEventListener('click', () => {
   showCommandLauncher();
@@ -145,13 +144,13 @@ window.showSessionDetail = showSessionDetail;
 window.closeModal = closeModal;
 window.selectProject = selectProject;
 
-// KJC-TSK-0414 PR4: arranca el polling del banner de standby al cargar la página.
-startStandbyPolling();
-
 // Initial load — sync disk data first so new batches are visible
-triggerSync().then(() => {
-  handleRoute();
+triggerSync().then(async () => {
+  const shown = handleRoute();
   subscribeToServerEvents();
+  // KJC-TSK-1198: the guided tour, by itself on the first visit only, once the view is drawn.
+  await shown;
+  maybeStartFirstTour();
 });
 
 // Auto-refresh every 60 seconds as a SAFETY NET only — the board is

package/packages/hu-board/public/utils/log-panel.js

@@ -1,8 +1,8 @@
 // KJC-TSK-0501 step 7/8 — Floating run-log panel + window controls.
 //
 // Classic script (no exports). Loaded by index.html before app.js so
-// the function declarations hoist and inline onclick="openLogViewer(...)"
-// handlers emitted by board-view / dashboard-view resolve transparently.
+// the function declarations hoist and the other scripts call
+// openGenericLogPanel() directly.
 // `logPollTimer` and `logViewerState` are top-level `let` bindings in
 // this classic script — same realm as app.js, so the cross-script
 // references keep working unchanged.
@@ -19,23 +19,10 @@
 let logPollTimer = null;
 let logViewerState = { planId: null, panel: null, offset: 0, isMax: false, isMin: false };
 
-/**
- * Open (or refocus) the run-log panel for the given plan. Thin shim
- * over `openGenericLogPanel` — the original entry point used for
- * `kj run --plan` runs that the Run-plan button kicks off.
- */
-function openLogViewer(planId) {
-  return openGenericLogPanel({
-    id: planId,
-    label: 'Run log',
-    tailUrl: (offset) => `/api/plans/${encodeURIComponent(planId)}/log?offset=${offset}`,
-  });
-}
-
 /**
  * Generic floating log panel anchored bottom-right. Used by:
- *   - openLogViewer(planId)         → /api/plans/:planId/log
  *   - openCommandLogViewer(cmd, id) → /api/runs/:commandId/log
+ *     (KJC-TSK-1351: the per-plan kj run log viewer went with kj run)
  *
  * The only thing that changes between callers is the tail URL +
  * the label; the window controls (min/max/close), polling, and ANSI

package/packages/hu-board/public/utils/maggle-mode.js

@@ -18,12 +18,7 @@ const MAGGLE_LABELS = {
   'board.title': 'Tu trabajo',
   'board.stories': 'tareas',
   'board.story': 'tarea',
-  'board.run': '▶ Continuar con lo pendiente',
-  'board.runTitle': 'Karajan seguirá con las tareas que faltan, una a una. Podrás ver la actividad aquí.',
-  'board.stop': '⏹ Parar',
-  'board.stopTitle': 'Detiene el trabajo en marcha. Lo ya terminado se conserva.',
   'board.viewLog': '📜 Ver actividad',
-  'board.running': 'en marcha',
   'board.ragPlaceholder': '🔍 Pregunta lo que quieras sobre este proyecto…',
   'header.subtitle': 'tu tablero de trabajo',
   'nav.board': 'Tablero',
@@ -31,14 +26,9 @@ const MAGGLE_LABELS = {
   'nav.more': 'Más',
   'picker.hint': 'Elige un proyecto para ver su tablero. Para cambiar de proyecto, vuelve a «Proyectos».',
   'picker.project': 'proyecto',
-  'launcher.title': '📝 Pedir trabajo a Karajan',
-  'launcher.planLabel': '📝 Pedir trabajo nuevo',
-  'launcher.planHelp': 'Cuéntale a Karajan qué quieres construir o cambiar, con tus palabras. Lo convertirá en tareas que verás en el tablero — todavía no toca tu código.',
-  'launcher.taskLabel': 'Qué quieres pedir',
-  'launcher.submit': 'Pedir',
+  'launcher.title': '⚡ Mantenimiento de Karajan',
+  'launcher.submit': 'Ejecutar',
   'launcher.cancel': 'Cancelar',
-  'launcher.more': 'Más opciones…',
-  'launcher.confirm': 'Voy a convertir tu petición en tareas del tablero. Tardará unos minutos y podrás seguir la actividad en esta ventana. ¿Sigo?',
   'conversation.title': 'Habla con tu agente',
   'conversation.hide': 'Ocultar — la conversación sigue viva',
   'conversation.end': 'Terminar la sesión del agente',

package/packages/hu-board/public/utils/modals.js

@@ -143,6 +143,11 @@ function showHelp() {
         Tip: hover any tab in the header for ~1 second to see a one-line summary.
       </div>
       <div style="padding:12px 18px;border-top:1px solid var(--border);text-align:right">
+        <button id="app-dialog-tour" class="control-btn"
+                style="padding:6px 16px;border:none;background:var(--color-blue,#3b82f6);color:#fff;
+                       border-radius:var(--radius-sm);cursor:pointer;margin-right:8px">
+          ▶ Start the guided tour
+        </button>
         <button id="app-dialog-close" class="control-btn"
                 style="padding:6px 16px;border:1px solid var(--border);
                        background:var(--bg-primary);color:var(--text);
@@ -157,6 +162,8 @@ function showHelp() {
     };
     dlg.addEventListener('close', done, { once: true });
     dlg.querySelector('#app-dialog-close').addEventListener('click', done, { once: true });
+    // KJC-TSK-1198: the tour highlights the page, so the modal closes first.
+    dlg.querySelector('#app-dialog-tour').addEventListener('click', () => { done(); startBoardTour(); }, { once: true });
     dlg.showModal();
   });
 }

package/packages/hu-board/public/utils/project-picker-view.js

@@ -52,7 +52,7 @@ async function renderProjectPicker() {
     const c = { pending: 0, running: 0, done: 0, failed: 0 };
     for (const s of stories) {
       if (['pending', 'certified', 'needs_context', 'blocked'].includes(s.status)) c.pending += 1;
-      else if (['coding', 'reviewing'].includes(s.status)) c.running += 1;
+      else if (kanbanColumnOf(s.status) === 'running') c.running += 1;
       else if (s.status === 'done') c.done += 1;
       else if (s.status === 'failed') c.failed += 1;
     }

package/packages/hu-board/public/utils/server-push.js

@@ -164,20 +164,11 @@ async function patchBoardIncremental() {
     stories = await api(`/api/projects/${encodeURIComponent(selectedProject)}/stories`);
   } catch { return false; }
 
-  // Re-derive the column → status mapping (kept in lockstep with
-  // renderBoard's `columns` object — change there, change here).
-  const statusToColumn = (status) => {
-    if (['pending', 'certified', 'needs_context', 'blocked'].includes(status)) return 'pending';
-    if (['coding', 'reviewing'].includes(status)) return 'running';
-    if (status === 'done') return 'done';
-    if (status === 'failed') return 'failed';
-    return 'pending';                  // safe default
-  };
-
+  // KJC-BUG-0405: the same lanes renderBoard uses (formatters.js::kanbanColumnOf).
   const seen = new Set();
   for (const story of stories) {
     seen.add(story.id);
-    const targetCol = columns[statusToColumn(story.status)];
+    const targetCol = columns[kanbanColumnOf(story.status)];
     if (!targetCol) continue;
     const existing = kanban.querySelector(`.story-card[data-story-id="${cssEscape(story.id)}"]`);
     if (!existing) {
@@ -232,21 +223,11 @@ async function patchBoardIncremental() {
       setTimeout(() => node.remove(), 160);
     }
   }
-  // Recount each column + update the "N running" badge in the header.
+  // Recount each column (the Running column's count is the "how many in progress").
   for (const [cls, col] of Object.entries(columns)) {
     const counter = col.querySelector('[data-column-count]');
     if (counter) counter.textContent = String(col.querySelectorAll('.story-card').length);
     col.style.opacity = col.querySelectorAll('.story-card').length === 0 ? '0.55' : '1';
   }
-  const runningCount = columns.running.querySelectorAll('.story-card').length;
-  const runningBadge = document.querySelector('.section-header__badge');
-  if (runningBadge) {
-    if (runningCount > 0) {
-      runningBadge.textContent = `⚙ ${runningCount} running…`;
-      runningBadge.style.display = '';
-    } else {
-      runningBadge.style.display = 'none';
-    }
-  }
   return true;
 }

package/packages/hu-board/public/utils/shared-board-notice.js

@@ -0,0 +1,33 @@
+// KJC-TSK-1197 — notice shown above the kanban when the project's board mirrors the
+// shared board (GitHub Issues, ADR 0025): what it is, how it changes, where it lives.
+//
+// Classic script (no exports), loaded before app.js like plan-rollup-view.js.
+// Globals consumed: esc() (app.js).
+
+// owner/name as GitHub allows them: nothing that could leave the href.
+const SHARED_BOARD_REPO = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
+
+/** The notice for the first plan that mirrors the shared board, or '' when there is none. */
+function sharedBoardNoticeHtml(plans) {
+  const mirror = (plans || []).find((p) => p.readonly === 'github');
+  if (!mirror) return '';
+  const link = SHARED_BOARD_REPO.test(mirror.repo || '')
+    ? ` <a href="https://github.com/${mirror.repo}/issues?q=${encodeURIComponent('label:kj:hu')}" target="_blank" rel="noopener" style="color:var(--color-blue,#3b82f6);">Open its issues on GitHub (${esc(mirror.repo)})</a>`
+    : '';
+  return `
+    <div role="note" style="margin:8px 0;padding:10px 14px;background:var(--bg-primary);border:1px solid var(--border);border-left:4px solid var(--color-blue,#3b82f6);border-radius:var(--radius-sm);font-size:0.85rem;">
+      <strong>This is the team's shared board.</strong>
+      Its stories live as GitHub Issues and the whole team sees the same ones, so it is read-only here:
+      change a story with <code>kj hu move</code> from a terminal.${link}
+    </div>
+  `;
+}
+
+/** Fills the notice slot for a project. No-op when the slot is not mounted. */
+async function renderSharedBoardNotice(projectId) {
+  const slot = document.getElementById('shared-board-notice');
+  if (!slot) return;
+  const r = await fetch(`/api/projects/${encodeURIComponent(projectId)}/plans-outcome`);
+  if (!r.ok) throw new Error(`plans-outcome answered ${r.status}`);
+  slot.innerHTML = sharedBoardNoticeHtml((await r.json()).plans);
+}

package/packages/hu-board/public/utils/story-detail-view.js

@@ -12,7 +12,7 @@
 //   - projectIsSharedCache        (mutable, app.js)
 //   - renderStoryEditForm()       (app.js)
 //   - closeModal(), changeHuStatusFromModal(), resetHuToPending(),
-//     undoHuChanges(), saveHuModels(), saveHuAssignee() — bound on
+//     saveHuModels(), saveHuAssignee() — bound on
 //     window from app.js so the inline handlers in this template
 //     keep working unchanged.
 
@@ -104,20 +104,6 @@ async function showStoryDetail(storyId) {
               ↺ Reset
             </button>
           ` : ''}
-          ${(() => {
-            // KJC-TSK-0408: Undo solo si la HU tiene snapshot_sha en outcome.
-            let parsedOutcome = null;
-            try { parsedOutcome = typeof story.outcome === 'string' ? JSON.parse(story.outcome) : story.outcome; } catch { /* */ }
-            const canUndo = parsedOutcome?.snapshot_sha && !parsedOutcome?.reverted;
-            return canUndo ? `
-              <button id="undo-hu-btn" class="control-btn"
-                      style="padding:6px 12px;border:1px solid var(--color-red,#ef4444);background:var(--bg-primary);color:var(--color-red,#ef4444);border-radius:var(--radius-sm);cursor:pointer;font-size:0.85rem"
-                      title="Deshacer cambios de esta HU: restaura los ficheros al snapshot pre-run y marca pending"
-                      onclick="undoHuChanges('${esc(story.id)}')">
-                ⏪ Undo
-              </button>
-            ` : '';
-          })()}
           <button class="modal__close" onclick="closeModal()">&times;</button>
         </div>
       </div>
@@ -254,10 +240,10 @@ async function showStoryDetail(storyId) {
         <div class="modal__section" style="border:1px solid var(--color-yellow,#eab308);background:rgba(234,179,8,0.08);padding:10px 12px;border-radius:var(--radius-sm)">
           <div class="modal__section-title" style="color:var(--color-yellow,#eab308)">⚠ Missing test contract</div>
           <div style="font-size:0.85rem;line-height:1.5;margin-top:4px">
-            This HU has no acceptance_tests declared. The tests-first pipeline (v2.7.5)
-            refuses to run HUs without an executable contract. Click ✎ Edit above and
-            add at least one test — a <code>shell</code> command that exits 0 on pass,
-            or a <code>gherkin</code> Given/When/Then spec.
+            This HU has no acceptance tests declared. The method writes the failing
+            test first, so declare at least one: ✎ Edit above, or
+            <code>kj hu add --tests</code>. A test is a <code>shell</code> command that
+            exits 0 on pass, or a <code>gherkin</code> Given/When/Then spec.
           </div>
         </div>
       ` : `

package/packages/hu-board/src/cleanup-zombies.js

@@ -91,7 +91,6 @@ export function cleanupZombies(opts = {}) {
     const storyIds = db.prepare('SELECT id FROM stories WHERE project_id = ?').all(proj.id).map((r) => r.id);
     const sessionIds = db.prepare('SELECT id FROM sessions WHERE project_id = ?').all(proj.id).map((r) => r.id);
     const fsPaths = [
-      ...storyIds.map((sid) => path.join(getKjHome(), 'hu-stories', sid)),
       ...sessionIds.map((sid) => path.join(getKjHome(), 'sessions', sid)),
       ...plansRoots().map((root) => path.join(root, proj.id)),
     ];