@karajan-family/code 4.70.4 → 5.0.0

package/README.md

@@ -110,9 +110,9 @@ Tier B is the guarantee floor — hosts without hooks lose A, never B; C re-veri
 
 Every chokepoint decision lands in a hash-chained log (`kj policy anchor` seals its head in git), and `kj policy report` turns that log into evidence of process: per rule, how often it warned, denied or was exempted, which denials are still open, which grants are alive, expired or renewed — so a rule "gains teeth" on data, not on a hunch, and a renewed exception is read for what it is: the policy asking to change.
 
-## Headless mode
+## Unattended runs (CI and automation)
 
-The classic multiagent pipeline lives on for CI and automation: `kj run "<task>"` orchestrates coder/reviewer/tester subprocess roles unattended, with the same gates. Agents and CI pass `--non-interactive` (or `KJ_NON_INTERACTIVE=1`): safe gates auto-answer, FAIL findings stop the run with a real exit code. `kj advanced` lists the full surface. [Headless mode docs](https://karajancode.com/docs/v4/headless/).
+The classic multiagent pipeline (`kj run` and its family) was retired in 5.0: your agent does the work and Karajan governs it. In CI and scripts, pass `--non-interactive` (or `KJ_NON_INTERACTIVE=1`): safe gates auto-answer, FAIL findings stop with a real exit code. Moving from 4.x? See [MIGRATION-v5.md](MIGRATION-v5.md). `kj advanced` lists the full surface.
 
 ## v3 (historical)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karajan-family/code",
-  "version": "4.70.4",
+  "version": "5.0.0",
   "description": "Local multi-agent coding orchestrator with TDD, SonarQube, and code review pipeline",
   "type": "module",
   "license": "AGPL-3.0",
@@ -94,30 +94,24 @@
     "prepublishOnly": "node scripts/verify-pack.mjs",
     "verify-quickstart": "node scripts/quickstart-gate.mjs"
   },
-  "simple-git-hooks": {
-    "pre-commit": "npx lint-staged"
-  },
-  "lint-staged": {
-    "src/**/*.js": "eslint --max-warnings=999"
-  },
   "overrides": {
     "fast-uri": "^3.1.2"
   },
   "dependencies": {
     "@babel/parser": "^7.29.7",
-    "@karajan-family/atril": "^1.0.0",
+    "@karajan-family/atril": "^1.1.0",
     "@karajan-family/governance": "^0.1.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@xterm/xterm": "^6.0.0",
-    "better-sqlite3": "^12.10.0",
     "chokidar": "^5.0.0",
     "commander": "^15.0.0",
+    "driver.js": "1.10.2",
     "execa": "^9.6.0",
     "express": "^5.1.0",
     "express-rate-limit": "^8.5.0",
     "helmet": "^8.1.0",
     "js-yaml": "^4.2.0",
-    "karajan-core": "^1.6.0",
+    "karajan-core": "^1.7.0",
     "karajan-rag": "^1.2.0",
     "knip": "^6.15.0",
     "madge": "^8.0.0",
@@ -133,19 +127,17 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@vitest/coverage-v8": "^4.1.8",
+    "@vitest/coverage-v8": "^4.1.12",
     "esbuild": "^0.28.0",
     "eslint": "^10.4.1",
     "eslint-plugin-import-x": "^4.16.2",
     "eslint-plugin-node-security": "5.2.2",
     "eslint-plugin-security": "^4.0.0",
     "globals": "^17.6.0",
-    "lint-staged": "^17.0.7",
     "postject": "^1.0.0-alpha.6",
     "prettier": "^3.4.2",
-    "simple-git-hooks": "^2.13.1",
     "smol-toml": "^1.7.0",
-    "vitest": "^4.1.8"
+    "vitest": "^4.1.12"
   },
   "publishConfig": {
     "access": "public"

package/packages/hu-board/package.json

@@ -14,8 +14,8 @@
   },
   "dependencies": {
     "@xterm/xterm": "^6.0.0",
-    "better-sqlite3": "^12.10.0",
     "chokidar": "^5.0.0",
+    "driver.js": "1.10.2",
     "express": "^5.1.0",
     "express-rate-limit": "^8.5.0",
     "helmet": "^8.1.0",

package/packages/hu-board/public/app.js

@@ -123,24 +123,9 @@ function renderEmptyState(title, text) {
 
 // ---- Plan execution ----
 //
-// The board delegates execution to the CLI via `POST /api/projects/:id/run`.
-// There's no more intermediate "certify" step: the user reviews HUs
-// (editing inline if needed — see edit-in-place PR), and when happy
-// clicks "Run plan", which spawns `kj run --plan <id>` as a detached
-// child on the server. Status updates flow back through the plan JSON
-// watcher without any manual refresh.
-//
-// We still expose a per-HU status PATCH endpoint for corrective moves
-// (e.g. retry a failed HU manually), but it's no longer the primary
-// action on the card.
+// KJC-TSK-1319: the board no longer launches kj run (retired in 5.0); your
+// agent does the work. A per-HU status PATCH stays for corrective moves.
 
-/**
- * Launch the pipeline over every plan of a project. Returns when the
- * spawn ack is received — not when the run completes. Live progress is
- * reflected automatically by the plans-dir watcher on the server, so
- * the board re-renders without us having to poll.
- * @param {string} projectId
- */
 // Track the most recently launched planId so the "View log" button in
 // the section header can re-open the viewer without the user hunting
 // through plan ids.
@@ -249,6 +234,7 @@ function handleRoute() {
     btn.classList.toggle('active', btn.dataset.view === currentView);
   });
 
-  render();
+  // KJC-TSK-1198: the view's promise, so the boot can wait for it before the tour.
+  return render();
 }
 

package/packages/hu-board/public/index.html

@@ -6,6 +6,7 @@
   <title>Karajan HU Board</title>
   <link rel="stylesheet" href="/styles.css">
   <link rel="stylesheet" href="/vendor/xterm/css/xterm.css">
+  <link rel="stylesheet" href="/vendor/driver/driver.css">
   <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'><rect width='32' height='32' rx='6' fill='%237c3aed'/><text x='16' y='22' text-anchor='middle' fill='white' font-size='16' font-family='sans-serif' font-weight='bold'>K</text></svg>">
 </head>
 <body>
@@ -25,7 +26,7 @@
       <div class="header__controls">
         <button class="control-btn" id="help-btn" title="What does each view do? Quick reference for Board / Graph / Dashboard / Sessions / Pipeline.">?</button>
         <button class="control-btn" id="config-btn" title="Configurar Karajan (modelos, agentes, tope de iteraciones, …)">⚙</button>
-        <button class="control-btn" id="commands-btn" title="Launch a Karajan CLI command (kj plan, kj architect, kj clean…)">⚡</button>
+        <button class="control-btn" id="commands-btn" title="Launch a Karajan CLI command (kj clean)">⚡</button>
         <button class="control-btn" id="conversation-btn" title="Conversación con tu agente — la terminal real, dentro del board (ADR 0008)" onclick="openConversationPanel()">💬</button>
         <button class="control-btn" id="restart-btn" title="Restart the HU Board server (preserves URL, the page reconnects automatically)">🔁</button>
         <button class="control-btn" id="sync-btn" title="Re-scan disk for new batches">🔄</button>
@@ -72,6 +73,9 @@
   <script src="/utils/story-detail-view.js"></script>
   <script src="/utils/preflight-view.js"></script>
   <script src="/utils/plan-rollup-view.js"></script>
+  <script src="/utils/shared-board-notice.js"></script>
+  <script src="/vendor/driver/driver.js.iife.js"></script>
+  <script src="/utils/board-tour.js"></script>
   <script src="/utils/log-panel.js"></script>
   <script src="/vendor/xterm/lib/xterm.js"></script>
   <script src="/utils/terminal-panel.js"></script>
@@ -80,7 +84,6 @@
   <script src="/utils/story-edit-form.js"></script>
   <script src="/utils/config-editor.js"></script>
   <script src="/utils/command-launcher.js"></script>
-  <script src="/utils/run-launcher.js"></script>
   <script src="/utils/server-push.js"></script>
   <script src="/app.js"></script>
   <script src="/utils/init-listeners.js"></script>

package/packages/hu-board/public/styles.css

@@ -374,6 +374,14 @@ a:hover {
   color: var(--text-muted);
 }
 
+/* KJC-TSK-1313: the worktree lane working the card. */
+.story-card__lane {
+  font-family: var(--font-mono);
+  font-size: 0.75rem;
+  color: var(--color-green);
+  overflow-wrap: anywhere;
+}
+
 .quality-bar {
   display: inline-flex;
   gap: 1px;
@@ -438,6 +446,24 @@ a:hover {
   margin-top: 4px;
 }
 
+/* KJC-TSK-1324: ▶ starts a pending card in its own lane. */
+.story-card__play {
+  margin-left: auto;
+  min-width: 28px;
+  min-height: 28px;
+  border: 1px solid var(--color-green);
+  border-radius: 6px;
+  background: transparent;
+  color: var(--color-green);
+  cursor: pointer;
+}
+.story-card__play:hover,
+.story-card__play:focus-visible {
+  background: rgba(52, 211, 153, 0.15);
+  outline: 2px solid var(--color-green);
+  outline-offset: 1px;
+}
+
 /* ---- Story Detail Modal ---- */
 .modal-backdrop {
   position: fixed;

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

@@ -6,9 +6,6 @@
 // Contents:
 //   - api(): thin JSON fetch wrapper used everywhere in the UI.
 //   - triggerSync(): POST /api/sync — fired on page load and the 🔄 button.
-//   - Standby banner: _standbyData state + refreshStandby() +
-//     _renderStandbyBanner() + _tickStandbyCountdowns() +
-//     startStandbyPolling() — KJC-TSK-0414 PR4.
 //   - Server-restart detector: pollServerVersion() + __versionBaseline +
 //     window.forceRefresh — KJC-TSK-0379.
 //
@@ -22,77 +19,6 @@ async function api(path) {
   return res.json();
 }
 
-// KJC-TSK-0414 PR4: standby banner — sesiones hibernadas pendientes de resume.
-// Polleamos /api/standby cada 30s + tick countdown cada 1s.
-let _standbyData = { sessions: [] };
-let _standbyPollTimer = null;
-let _standbyTickTimer = null;
-
-function _fmtCountdown(ms) {
-  if (ms <= 0) return '✓ resume inmediato';
-  const s = Math.round(ms / 1000);
-  const h = Math.floor(s / 3600);
-  const m = Math.floor((s % 3600) / 60);
-  const sec = s % 60;
-  return `${String(h).padStart(2, '0')}:${String(m).padStart(2, '0')}:${String(sec).padStart(2, '0')}`;
-}
-
-async function refreshStandby() {
-  try {
-    const r = await api('/api/standby');
-    _standbyData = r || { sessions: [] };
-    _renderStandbyBanner();
-  } catch { /* silencioso — endpoint nuevo, podría no existir en versiones viejas */ }
-}
-
-function _renderStandbyBanner() {
-  let banner = document.getElementById('standby-banner');
-  const sessions = _standbyData.sessions || [];
-  if (sessions.length === 0) {
-    if (banner) banner.remove();
-    return;
-  }
-  if (!banner) {
-    banner = document.createElement('div');
-    banner.id = 'standby-banner';
-    banner.style.cssText = 'background:rgba(251,191,36,0.12);border-left:4px solid #fbbf24;padding:10px 16px;margin:0 0 12px;font-size:0.85rem';
-    const app = document.getElementById('app');
-    if (app?.parentNode) app.parentNode.insertBefore(banner, app);
-  }
-  const now = Date.now();
-  banner.innerHTML = `
-    <div style="display:flex;align-items:center;gap:12px;flex-wrap:wrap">
-      <strong>💤 ${sessions.length} sesión(es) hibernadas:</strong>
-      ${sessions.map((s) => {
-        const ms = new Date(s.cooldownUntil).getTime() - now;
-        const label = _fmtCountdown(ms);
-        const reason = s.reason || '?';
-        const planInfo = s.planId ? ` · ${s.planId}${s.huId ? '/' + s.huId : ''}` : '';
-        return `<span data-session="${esc(s.sessionId)}" data-cooldown="${esc(s.cooldownUntil)}" style="background:rgba(0,0,0,0.15);padding:4px 8px;border-radius:4px;font-family:monospace" title="${esc(reason)}${esc(planInfo)}">${esc(s.sessionId)} · <span class="standby-countdown">${label}</span></span>`;
-      }).join('')}
-      <span style="margin-left:auto;color:var(--text-muted);font-size:0.75rem">Auto-resume al llegar el cooldown (board) o <code>kj resume &lt;id&gt;</code></span>
-    </div>
-  `;
-}
-
-function _tickStandbyCountdowns() {
-  const banner = document.getElementById('standby-banner');
-  if (!banner) return;
-  const now = Date.now();
-  for (const chip of banner.querySelectorAll('[data-cooldown]')) {
-    const target = new Date(chip.getAttribute('data-cooldown')).getTime();
-    const span = chip.querySelector('.standby-countdown');
-    if (span) span.textContent = _fmtCountdown(target - now);
-  }
-}
-
-function startStandbyPolling() {
-  if (_standbyPollTimer || _standbyTickTimer) return;
-  refreshStandby();
-  _standbyPollTimer = setInterval(refreshStandby, 30_000);
-  _standbyTickTimer = setInterval(_tickStandbyCountdowns, 1000);
-}
-
 /**
  * Trigger a full re-scan of disk data (hu-stories + sessions).
  * Called on page load and via the sync button.

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

@@ -0,0 +1,62 @@
+// KJC-TSK-1198 — guided tour of the HU Board (driver.js, served from the dependency at
+// /vendor/driver). It starts by itself the first time; the help modal relaunches it.
+//
+// Classic script (no exports). Globals consumed: window.driver.js (driver.js.iife.js).
+
+const BOARD_TOUR_SEEN_KEY = 'kj-board-tour-seen';
+
+// [selector, title, description, what to say when it is not on screen (else the step is skipped)]
+const BOARD_TOUR = [
+  ['[data-view="dashboard"]', 'Dashboard', 'Every project the board knows, with its stats. Click a project to open it.'],
+  ['#help-btn', 'Help', 'A quick reference of each view, and this tour again whenever you want it.'],
+  ['#config-btn', 'Settings', 'Configure Karajan: models, agents, iteration cap.'],
+  ['#commands-btn', 'Commands', 'Launch a kj command (kj clean) and watch its log.'],
+  ['#conversation-btn', 'Conversation', 'Your agent’s real terminal, inside the board.'],
+  ['#restart-btn', 'Restart', 'Restart the board server. The page reconnects by itself.'],
+  ['#sync-btn', 'Re-scan', 'Read the plans and sessions on disk again when something new is missing.'],
+  ['#force-refresh-btn', 'Clean reload', 'Wipe the browser caches and reload, for when the page looks stale.'],
+  ['#project-nav', 'Project bar', 'Board is the kanban of HUs, Graph who blocks whom, Sessions every kj run, Governance the rules and decision log, Pipeline the live runs, RAG the index of the code, Wiki the project docs.',
+    'Open a project from the Dashboard: a bar appears with its views (Board, Graph, Sessions, Governance, Pipeline, RAG, Wiki).'],
+  ['#preflight-panel', 'Project checks', 'Whether the project is ready to run: remote, clean tree, agents. Red means a blocker; open it to see why.'],
+  ['#rag-panel', 'Search', 'Ask anything about the project’s plans, onboarding or code.'],
+  ['#shared-board-notice [role="note"]', 'Shared board', 'These HUs are the team’s, from GitHub Issues: read-only here, changed with kj hu move.'],
+  ['.kanban', 'Kanban', 'Pending, Running and Done. Click a card to see the HU in detail.'],
+];
+
+const isOnScreen = (selector) => {
+  const el = document.querySelector(selector);
+  return Boolean(el) && el.offsetParent !== null;
+};
+
+/** The tour for what is on screen now: absent elements are skipped or explained in the middle. */
+function boardTourSteps() {
+  return BOARD_TOUR.flatMap(([element, title, description, whenAbsent]) => {
+    if (isOnScreen(element)) return [{ element, popover: { title, description } }];
+    return whenAbsent ? [{ popover: { title, description: whenAbsent } }] : [];
+  });
+}
+
+/** Run the whole tour; once closed or skipped, it does not start by itself again. */
+function startBoardTour() {
+  const tour = window.driver.js.driver({
+    showProgress: true,
+    allowKeyboardControl: true,
+    steps: boardTourSteps(),
+    onDestroyed: () => {
+      try { localStorage.setItem(BOARD_TOUR_SEEN_KEY, '1'); }
+      catch (err) { console.warn('board tour: cannot remember it was seen:', err.message); }
+    },
+  });
+  tour.drive();
+}
+
+/** First visit only. A browser that cannot remember it never gets it by itself. */
+function maybeStartFirstTour() {
+  try {
+    if (localStorage.getItem(BOARD_TOUR_SEEN_KEY)) return false;
+  } catch {
+    return false;
+  }
+  startBoardTour();
+  return true;
+}

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

@@ -6,12 +6,11 @@
 //
 // Globals consumed from app.js / earlier scripts:
 //   - api(), esc(), renderEmptyState(), renderProjectPicker(),
-//     renderPreflightPanel(), renderPlanRollup(), confirmRunWithPreflight(),
-//     runProject(), openGenericLogPanel(), humaniseProjectName(),
+//     renderPreflightPanel(), renderPlanRollup(),
+//     openGenericLogPanel(), humaniseProjectName(),
 //     resolveProjectMeta(), shortStoryId(), truncate(), scoreClass(),
 //     qualityBar(), timeAgo(), showError(), showConfirm(),
-//     showStoryDetail(), showOutcomeModal(), runSingleHuFromCard(),
-//     renameProjectModal()
+//     showStoryDetail(), showOutcomeModal(), renameProjectModal()
 //   - mutable: selectedProject, lastOpenedLog, projectNameCache,
 //     projectInitialsCache
 // All lookups are runtime-bound; load order only needs board-view.js to live
@@ -35,10 +34,13 @@ async function renderBoard() {
       return;
     }
 
-    const [stories, projectCost] = await Promise.all([
+    const [stories, projectCost, lanes] = await Promise.all([
       api(`/api/projects/${encodeURIComponent(selectedProject)}/stories`),
       api(`/api/projects/${encodeURIComponent(selectedProject)}/cost`).catch(() => null),
+      api(`/api/lanes/${encodeURIComponent(selectedProject)}`).catch((err) => ({ byStory: {}, error: String(err.message || err) })),
     ]);
+    lanesByStory = lanes.byStory || {};
+    if (lanes.error) console.warn(`[board] worktree lanes unavailable: ${lanes.error}`);
     const costSummary = projectCost ? formatProjectCostSummary(projectCost) : null;
     // Φ0-G (KJC-TSK-0525): aggregated cache-hit badge at the project
     // header, rendered alongside the project cost chip.
@@ -63,11 +65,9 @@ async function renderBoard() {
     // columna "Failed" — vuelven a Pending con result=fail y badge ✗.
     // status=failed legacy se trata como pending (migración lazy).
     const columns = {
-      pending: stories.filter((s) =>
-        ['pending', 'certified', 'needs_context', 'blocked', 'failed'].includes(s.status)
-      ),
-      running: stories.filter((s) => ['coding', 'reviewing'].includes(s.status)),
-      done: stories.filter((s) => s.status === 'done'),
+      pending: stories.filter((s) => kanbanColumnOf(s.status) === 'pending'),
+      running: stories.filter((s) => kanbanColumnOf(s.status) === 'running'),
+      done: stories.filter((s) => kanbanColumnOf(s.status) === 'done'),
     };
 
     if (stories.length === 0) {
@@ -75,15 +75,8 @@ async function renderBoard() {
       return;
     }
 
-    // "Run plan" bulk action: visible when a project is selected AND at
-    // least one HU is still awaiting execution AND nothing's currently
-    // running (to avoid accidentally launching a second pipeline over a
-    // live one). Replaces the old "Mark as certified" button — the
-    // intermediate "certified" state was noise from the user's POV.
-    const awaitingCount = columns.pending.length;
-    const runningCount = columns.running.length;
-    const canRun = Boolean(selectedProject) && awaitingCount > 0 && runningCount === 0;
-    const isRunning = runningCount > 0;
+    // KJC-TSK-1351: no "⚙ N running" badge in the header. It counted the HUs the board's kj run
+    // could launch; with kj run retired the Running column's own count says how many are in progress.
 
     // KJC-TSK-0403: 3 canonical lanes. Failed eliminado — HUs con
     // result=fail aparecen en Pending con badge ✗.
@@ -106,32 +99,13 @@ async function renderBoard() {
         <span class="section-header__count" title="stories">${stories.length} ${maggleText('board.stories', 'stories')}</span>
         ${costSummary ? `<span class="section-header__cost" title="${esc(costSummary.tooltip)}">💵 ${esc(costSummary.label)}</span>` : ''}
         ${cacheSummary ? `<span class="section-header__cache" title="${esc(cacheSummary.tooltip)}">${esc(cacheSummary.label)}</span>` : ''}
-        ${isRunning ? `
-          <button id="running-badge-btn" class="section-header__badge"
-                style="margin-left:auto;padding:4px 10px;font-size:0.8rem;background:var(--color-yellow,#eab308);color:#000;border-radius:var(--radius-sm);font-weight:600;border:none;cursor:pointer;"
-                title="Abrir el log de la HU en marcha">
-            ⚙ ${runningCount} ${maggleText('board.running', 'running')}…
-          </button>
-          <button id="stop-run-btn" class="control-btn"
-                style="padding:4px 10px;font-size:0.8rem;background:var(--color-red,#ef4444);color:#fff;border:none;border-radius:var(--radius-sm);cursor:pointer;font-weight:600;"
-                title="${maggleText('board.stopTitle', 'Abortar todos los kj run en marcha de este proyecto (SIGTERM con escalado a SIGKILL tras 5s)')}">
-            ${maggleText('board.stop', '⏹ Stop')}
-          </button>
-        ` : ''}
         ${lastOpenedLog ? `
           <button class="control-btn" id="view-log-btn"
-                  style="${isRunning ? '' : 'margin-left:auto;'}padding:6px 12px;font-size:0.85rem;background:var(--bg-primary);border:1px solid var(--border);color:var(--text);border-radius:var(--radius-sm);cursor:pointer;"
+                  style="margin-left:auto;padding:6px 12px;font-size:0.85rem;background:var(--bg-primary);border:1px solid var(--border);color:var(--text);border-radius:var(--radius-sm);cursor:pointer;"
                   title="Re-open the log of the most recent run/command">
             ${maggleText('board.viewLog', '📜 View log')}
           </button>
         ` : ''}
-        ${canRun ? `
-          <button class="control-btn" id="run-plan-btn"
-                  style="margin-left:auto;padding:6px 14px;font-size:0.9rem;background:var(--color-green);color:#fff;border:none;border-radius:var(--radius-sm);cursor:pointer;font-weight:600;"
-                  title="${maggleText('board.runTitle', 'Launch kj run --plan over every plan in this project')}">
-            ${maggleText('board.run', '▶ Run plan')} (${awaitingCount} ${maggleText('board.story', 'HU')}${awaitingCount === 1 ? '' : 's'})
-          </button>
-        ` : ''}
       </div>
       <div id="preflight-panel" class="preflight-panel" style="margin:8px 0;">
         <div class="preflight-panel__loading" style="font-size:0.8rem;color:var(--text-muted);padding:6px 10px;">
@@ -150,24 +124,13 @@ async function renderBoard() {
         </button>
         <div id="rag-results" style="flex-basis:100%;font-size:0.8rem;color:var(--text-muted);"></div>
       </div>
+      <div id="shared-board-notice"></div>
       <div id="plan-rollup-banner"></div>
       <div class="kanban">
         ${visibleColumns.map((c) => renderKanbanColumn(c.title, c.cls, c.rows)).join('')}
       </div>
     `;
 
-    if (canRun) {
-      document.getElementById('run-plan-btn').addEventListener('click', async () => {
-        // Pre-run safety: ask preflight if anything risky is missing
-        // (no remote, dirty tree, missing agents, etc.). The modal
-        // shows blockers + warnings in plain Spanish and the user
-        // can cancel or proceed anyway. If everything is green we
-        // skip the modal and run straight away.
-        const ok = await confirmRunWithPreflight(selectedProject);
-        if (!ok) return;
-        await runProject(selectedProject);
-      });
-    }
     // Preflight panel is rendered AFTER the kanban so we can fetch
     // it without blocking the initial paint. Replaces a placeholder
     // div in-place (no full re-render).
@@ -176,6 +139,8 @@ async function renderBoard() {
     // project has a stamped outcome. Non-blocking — if it fails the
     // user just doesn't see the banner.
     renderPlanRollup(selectedProject).catch(() => {});
+    // KJC-TSK-1197: explain the shared board when this project mirrors one.
+    renderSharedBoardNotice(selectedProject).catch((err) => console.warn('shared board notice:', err.message));
     const viewLogBtn = document.getElementById('view-log-btn');
     if (viewLogBtn && lastOpenedLog) {
       viewLogBtn.addEventListener('click', () => openGenericLogPanel({
@@ -184,76 +149,9 @@ async function renderBoard() {
         tailUrl: lastOpenedLog.tailUrl,
       }));
     }
-    // Wire the yellow "⚙ N running…" badge so it opens the live log of the
-    // first running HU. Without this the badge was decorative — and if the
-    // run was started before the current page load (refresh / new browser
-    // session) `lastOpenedLog` is null, so the "📜 View log" button isn't
-    // even rendered. Then the user has no way to see the live output.
-    //
-    // For a single-HU run the log lives at:
-    //   ~/.karajan/hu-board-runs/<planId>--hu-<localHuId>.log
-    // which the /api/runs/:commandId/log endpoint serves when commandId
-    // matches the basename. The composite id stored in SQLite is
-    // "<projectId>::<localHuId>", so we strip the prefix to derive
-    // localHuId and concatenate with plan_id (already on the story row).
-    const runningBadgeBtn = document.getElementById('running-badge-btn');
-    if (runningBadgeBtn) {
-      runningBadgeBtn.addEventListener('click', async () => {
-        const running = stories.find((s) => s.status === 'coding' || s.status === 'reviewing');
-        if (!running) return;
-        const planId = running.plan_id;
-        if (!planId) {
-          await showError('Esta HU no tiene plan_id asociado, no puedo localizar su log.', { title: 'Sin log' });
-          return;
-        }
-        const localHuId = running.id.includes('::') ? running.id.split('::').pop() : running.id;
-        const logBasename = `${planId}--hu-${localHuId}`;
-        const tailUrl = (offset) => `/api/runs/${encodeURIComponent(logBasename)}/log?offset=${offset || 0}`;
-        lastOpenedLog = { id: logBasename, label: `HU ${localHuId}`, tailUrl };
-        openGenericLogPanel({ id: logBasename, label: `HU ${localHuId}`, tailUrl });
-      });
-    }
-
-    // KJC-TSK-0396: botón ⏹ Stop. Abortar todos los kj run vivos del
-    // proyecto. Si hay múltiples planes corriendo (caso raro pero
-    // posible), itera sobre cada planId único de las HUs running.
-    const stopRunBtn = document.getElementById('stop-run-btn');
-    if (stopRunBtn) {
-      stopRunBtn.addEventListener('click', async () => {
-        const runningHus = stories.filter((s) => s.status === 'coding' || s.status === 'reviewing');
-        const planIds = [...new Set(runningHus.map((s) => s.plan_id).filter(Boolean))];
-        if (planIds.length === 0) {
-          await showError('No hay plan_id asociado a las HUs en marcha.', { title: 'Sin runs' });
-          return;
-        }
-        const ok = await showConfirm(
-          `Esto matará ${planIds.length === 1 ? 'el proceso' : `los ${planIds.length} procesos`} del orquestador en marcha y dejará las HUs en curso (coding/reviewing) en pending para que puedas relanzarlas.\n\n¿Seguro?`,
-          { title: 'Abortar kj run', okLabel: 'Stop', cancelLabel: 'Cancelar', destructive: true }
-        );
-        if (!ok) return;
-        const summaries = [];
-        for (const planId of planIds) {
-          try {
-            const res = await fetch(`/api/runs/${encodeURIComponent(planId)}/stop`, {
-              method: 'POST', headers: { 'Content-Type': 'application/json' }, body: '{}',
-            });
-            const body = await res.json();
-            if (!res.ok) summaries.push(`${planId}: error ${body.error || res.status}`);
-            else summaries.push(`${planId}: ${body.stopped} SIGTERM, ${body.killed} SIGKILL, ${body.hu_reset_count || 0} HUs → pending`);
-          } catch (err) {
-            summaries.push(`${planId}: ${err.message}`);
-          }
-        }
-        await fetch('/api/sync', { method: 'POST' }).catch(() => {});
-        await renderBoard();
-        if (summaries.some((s) => s.includes('SIGKILL') && !s.startsWith('0 ')) && summaries.some((s) => /\b[1-9]\d* SIGKILL/.test(s))) {
-          await showError(
-            `Algún proceso no respondió a SIGTERM en 5s y fue forzado con SIGKILL:\n\n${summaries.join('\n')}`,
-            { title: 'Forzado con SIGKILL' }
-          );
-        }
-      });
-    }
+    // KJC-TSK-1351: the "⚙ N running" badge is a count. It used to open the log of a
+    // kj run, and ⏹ Stop killed it: with kj run retired an HU in progress is someone
+    // working on it, with no process or log of the board's to open or stop.
 
     // RAG search panel (KJC-PCS-0049 Step 8) — input + scope + render hits.
     const ragInput = document.getElementById('rag-query');
@@ -315,6 +213,25 @@ function renderKanbanColumn(title, cssClass, stories) {
   `;
 }
 
+// KJC-TSK-1313: story id → the worktree lanes working it (GET /api/lanes/:project).
+let lanesByStory = {};
+
+/** KJC-TSK-1316: the lane's PR as a link (https only); a closed or merged one says so. */
+function renderLanePr(pr) {
+  if (!pr || !/^https:\/\//.test(String(pr.url))) return '';
+  const state = pr.state === 'OPEN' ? '' : ` (${esc(String(pr.state).toLowerCase())})`;
+  return ` · <a href="${esc(pr.url)}" target="_blank" rel="noopener noreferrer" onclick="event.stopPropagation()">PR #${esc(String(pr.number))}</a>${state}`;
+}
+
+/** One badge per lane working the card: its name, branch and commits ahead of the base. */
+function renderLaneBadges(story) {
+  return (lanesByStory[story.id] || []).map((l) => {
+    const ahead = typeof l.ahead === 'number' ? ` · ${l.ahead} ↑` : '';
+    const title = `carril ${l.slug} · ${l.path}`;
+    return `<span class="story-card__lane" title="${esc(title)}">🌿 ${esc(l.slug)} (${esc(l.branch)})${ahead}${renderLanePr(l.pr)}</span>`;
+  }).join('');
+}
+
 /**
  * Renders a story card for the kanban board.
  * @param {object} story
@@ -345,36 +262,15 @@ function renderStoryCard(story) {
   // this on the card so the user edits the HU before trying to run.
   const missingTestContract = testCount === 0 && ['pending', 'certified'].includes(story.status);
 
-  // PR4: per-HU ▶ Run button. Visible when:
-  //   - the HU is in a re-runnable lifecycle state (certified / failed /
-  //     pending / done — KJC-TSK-0394 step 2 adds `done` so the user can
-  //     replay a HU whose `result` was fail or partial without having to
-  //     "reset to pending" first) AND
-  //   - it has at least one acceptance test (otherwise the run would
-  //     refuse) AND
-  //   - it isn't currently coding/reviewing AND
-  //   - KJC-BUG-0048: it has no unresolved blocked_by deps. The card
-  //     already shows "⏳ waits for: ..." below the title; the ▶ button
-  //     must match that gating or the user can launch a HU whose deps
-  //     don't exist yet, hitting the missing-prereq path at runtime.
-  const canRunHu = ['certified', 'failed', 'pending', 'done'].includes(story.status)
-    && testCount > 0
-    && !['coding', 'reviewing'].includes(story.status)
-    && blockedBy.length === 0;
-
+  // KJC-TSK-1319: the per-HU ▶ launched kj run, retired in 5.0.
   return `
     <div class="story-card" data-story-id="${esc(story.id)}" data-status="${esc(story.status || 'pending')}" onclick="showStoryDetail('${esc(story.id)}')">
       <div class="story-card__id" title="${esc(story.id)}">
         ${esc(shortId)}
-        ${canRunHu ? `
-          <button class="story-card__run-btn"
-                  style="float:right;padding:1px 6px;font-size:0.7rem;background:var(--color-green);color:#fff;border:none;border-radius:var(--radius-sm);cursor:pointer;"
-                  title="Lanzar solo esta HU"
-                  onclick="event.stopPropagation(); window.runSingleHuFromCard('${esc(story.id)}', '${esc(title.replace(/'/g, '&#39;'))}');">▶</button>
-        ` : ''}
       </div>
       <div class="story-card__title">${esc(truncate(title, 100))}</div>
       <div class="story-card__meta" style="gap:10px">
+        ${renderLaneBadges(story)}
         ${acCount > 0 ? `<span title="${acCount} acceptance criteria">📋 ${acCount} AC${acCount === 1 ? '' : 's'}</span>` : ''}
         ${testCount > 0 ? `<span title="${testCount} acceptance tests declared">✅ ${testCount} test${testCount === 1 ? '' : 's'}</span>` : ''}
         ${story.spec_section ? `<span title="Implements SPEC ${esc(story.spec_section)}" style="font-family:var(--font-mono, monospace)">📖 §${esc(story.spec_section)}</span>` : ''}
@@ -415,11 +311,20 @@ function renderStoryCard(story) {
         ${renderResultBadge(computeEffectiveResult(story))}
         <span class="story-card__time">${timeAgo(story.updated_at)}</span>
         ${renderOutcomeChip(story.outcome)}
+        ${renderPlayButton(story)}
       </div>
     </div>
   `;
 }
 
+// KJC-TSK-1324: ▶ starts a pending card without a lane: kj opens its lane and the panel coder
+// writes it there (kj hu start --code). Review and commit stay with the person.
+function renderPlayButton(story) {
+  if (story.status !== 'pending' || (lanesByStory[story.id] || []).length > 0) return '';
+  const hint = 'Start: open its lane and have your coder write it';
+  return `<button type="button" class="story-card__play" title="${hint}" aria-label="${esc(`${hint} (${story.id})`)}" onclick="startCardLane('${esc(story.id)}', event)">▶</button>`;
+}
+
 /**
  * KJC-TSK-0394 step 5: result "efectivo" para la UI. Sobre el campo
  * persistido `story.result` (si existe), o inferido del status legacy