@hanzlaa/rcode 3.4.33 → 3.6.0

package/server/lib/html/icons.js

@@ -0,0 +1,68 @@
+/**
+ * Inline SVG icon set (Lucide-style stroke icons).
+ *
+ * No CDN, no font — just path data rendered into a <svg>. Used server-side
+ * by shell.js for static chrome, and embedded as window.__ICONS__ so the
+ * client modules can render the same icons in dynamic markup.
+ *
+ * IMPORTANT: The ICONS map is duplicated in the ESM client counterpart:
+ *   server/lib/html/client/icons-client.js (in sync with this file)
+ * Keep both files in sync when adding or changing icon paths. The duplication
+ * is the no-build-step cost — the browser cannot import a CJS module as ESM.
+ */
+
+// name → inner SVG markup (viewBox 0 0 24 24, stroke = currentColor)
+// Keep in sync with server/lib/html/client/icons-client.js
+const ICONS = {
+  home:        '<path d="m3 9 9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/><path d="M9 22V12h6v10"/>',
+  activity:    '<path d="M22 12h-4l-3 9L9 3l-3 9H2"/>',
+  map:         '<polygon points="3 6 9 3 15 6 21 3 21 18 15 21 9 18 3 21"/><line x1="9" y1="3" x2="9" y2="18"/><line x1="15" y1="6" x2="15" y2="21"/>',
+  target:      '<circle cx="12" cy="12" r="10"/><circle cx="12" cy="12" r="6"/><circle cx="12" cy="12" r="2"/>',
+  layers:      '<polygon points="12 2 2 7 12 12 22 7 12 2"/><polyline points="2 17 12 22 22 17"/><polyline points="2 12 12 17 22 12"/>',
+  zap:         '<polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"/>',
+  checkSquare: '<polyline points="9 11 12 14 22 4"/><path d="M21 12v7a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h11"/>',
+  kanban:      '<rect x="3" y="4" width="5" height="16" rx="1"/><rect x="10" y="4" width="5" height="11" rx="1"/><rect x="17" y="4" width="5" height="14" rx="1"/>',
+  file:        '<path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/>',
+  users:       '<path d="M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2"/><circle cx="9" cy="7" r="4"/><path d="M22 21v-2a4 4 0 0 0-3-3.87"/><path d="M16 3.13a4 4 0 0 1 0 7.75"/>',
+  scale:       '<path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="8" y1="13" x2="16" y2="13"/><line x1="8" y1="17" x2="13" y2="17"/>',
+  database:    '<ellipse cx="12" cy="5" rx="9" ry="3"/><path d="M3 5v14c0 1.66 4 3 9 3s9-1.34 9-3V5"/><path d="M3 12c0 1.66 4 3 9 3s9-1.34 9-3"/>',
+  play:        '<polygon points="6 3 20 12 6 21 6 3"/>',
+  terminal:    '<polyline points="4 17 10 11 4 5"/><line x1="12" y1="19" x2="20" y2="19"/>',
+  square:      '<rect x="6" y="6" width="12" height="12" rx="1"/>',
+  x:           '<line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/>',
+  minimize:    '<line x1="5" y1="14" x2="19" y2="14"/>',
+  maximize:    '<path d="M8 3H5a2 2 0 0 0-2 2v3"/><path d="M21 8V5a2 2 0 0 0-2-2h-3"/><path d="M3 16v3a2 2 0 0 0 2 2h3"/><path d="M16 21h3a2 2 0 0 0 2-2v-3"/>',
+  clock:       '<circle cx="12" cy="12" r="10"/><polyline points="12 6 12 12 16 14"/>',
+  eye:         '<path d="M2 12s3.5-7 10-7 10 7 10 7-3.5 7-10 7-10-7-10-7z"/><circle cx="12" cy="12" r="3"/>',
+  filePen:     '<path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h7"/><polyline points="14 2 14 8 20 8"/><path d="M18.4 12.6a2 2 0 0 1 3 3L17 20l-4 1 1-4z"/>',
+  hourglass:   '<path d="M5 22h14M5 2h14M17 22v-4.17a2 2 0 0 0-.59-1.42L12 12l-4.41 4.41A2 2 0 0 0 7 17.83V22M7 2v4.17a2 2 0 0 0 .59 1.42L12 12l4.41-4.41A2 2 0 0 0 17 6.17V2"/>',
+
+  // Added in sprint 32.2 — emoji-to-SVG sweep
+  building:        '<rect x="4" y="2" width="16" height="20" rx="2"/><path d="M9 22V12h6v10"/><path d="M8 7h.01M12 7h.01M16 7h.01M8 11h.01M12 11h.01M16 11h.01"/>',
+  link:            '<path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"/><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"/>',
+  'alert-triangle':'<path d="m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3Z"/><line x1="12" y1="9" x2="12" y2="13"/><line x1="12" y1="17" x2="12.01" y2="17"/>',
+  brain:           '<path d="M9.5 2A2.5 2.5 0 0 1 12 4.5v15a2.5 2.5 0 0 1-4.96-.46 2.5 2.5 0 0 1-1.28-4.56A3 3 0 0 1 5 12c0-.56.15-1.1.42-1.57a2.5 2.5 0 0 1-.42-4.93V5.5A2.5 2.5 0 0 1 9.5 2z"/><path d="M14.5 2A2.5 2.5 0 0 0 12 4.5v15a2.5 2.5 0 0 0 4.96-.46 2.5 2.5 0 0 0 1.28-4.56A3 3 0 0 0 19 12c0-.56-.15-1.1-.42-1.57a2.5 2.5 0 0 0 .42-4.93V5.5A2.5 2.5 0 0 0 14.5 2z"/>',
+  'clipboard-list':'<rect x="8" y="2" width="8" height="4" rx="1" ry="1"/><path d="M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2"/><line x1="12" y1="11" x2="12" y2="17"/><line x1="9" y1="14" x2="15" y2="14"/>',
+  flag:            '<path d="M4 15s1-1 4-1 5 2 8 2 4-1 4-1V3s-1 1-4 1-5-2-8-2-4 1-4 1z"/><line x1="4" y1="22" x2="4" y2="15"/>',
+  monitor:         '<rect x="2" y="3" width="20" height="14" rx="2" ry="2"/><line x1="8" y1="21" x2="16" y2="21"/><line x1="12" y1="17" x2="12" y2="21"/>',
+  'file-text':     '<path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="16" y1="13" x2="8" y2="13"/><line x1="16" y1="17" x2="8" y2="17"/><polyline points="10 9 9 9 8 9"/>',
+  copy:            '<rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/>',
+  lightbulb:       '<line x1="9" y1="18" x2="15" y2="18"/><line x1="10" y1="22" x2="14" y2="22"/><path d="M15.09 14c.18-.98.65-1.74 1.41-2.5A4.65 4.65 0 0 0 18 8 6 6 0 0 0 6 8c0 1 .23 2.23 1.5 3.5A4.61 4.61 0 0 1 8.91 14"/>',
+  'edit-3':        '<path d="M12 20h9"/><path d="M16.5 3.5a2.121 2.121 0 0 1 3 3L7 19l-4 1 1-4L16.5 3.5z"/>',
+
+  // Added in sprint 32.3 — App/Topbar theme toggle icons
+  moon:            '<path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/>',
+  sun:             '<circle cx="12" cy="12" r="4"/><line x1="12" y1="2" x2="12" y2="6"/><line x1="12" y1="18" x2="12" y2="22"/><line x1="4.22" y1="4.22" x2="7.05" y2="7.05"/><line x1="16.95" y1="16.95" x2="19.78" y2="19.78"/><line x1="2" y1="12" x2="6" y2="12"/><line x1="18" y1="12" x2="22" y2="12"/><line x1="4.22" y1="19.78" x2="7.05" y2="16.95"/><line x1="16.95" y1="7.05" x2="19.78" y2="4.22"/>',
+};
+
+// Render an icon as an inline <svg>. size in px; cls adds extra classes.
+function icon(name, size, cls) {
+  const p = ICONS[name];
+  if (!p) return '';
+  const s = size || 16;
+  return '<svg class="ic' + (cls ? ' ' + cls : '') + '" width="' + s + '" height="' + s +
+    '" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" ' +
+    'stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">' + p + '</svg>';
+}
+
+module.exports = { ICONS, icon };

package/server/lib/html/shell.js

@@ -6,49 +6,11 @@ const { renderClientJs } = require('./client');
 
 function esc(s) { return String(s || '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;'); }
 
-function renderHtml(state) {
-  const projectName   = state.projectName || 'No project initialized';
-  const currentPhase  = state.currentPhase || '—';
-  const currentSprint = state.currentSprint || null;
-  const phaseCount    = (state.raw?.phases || []).length;
-  const decisionCount = (state.raw?.decisions || []).length;
-  const artifactCount = state.planningFiles.length;
+function renderHtml(state, orchToken) {
+  const projectName = state.projectName || 'No project initialized';
 
-  const agents = [
-    { name: 'Sadiq Damani', arabic: 'صادق', role: 'Director of Strategy', real: true, type: 'leadership' },
-    { name: 'Waleed Al Harthi', arabic: 'وليد', role: 'CTO', real: true, type: 'leadership' },
-    { name: 'Ahmed Al Hassani', arabic: 'أحمد الحسني', role: 'Technology & Development Director', real: true, type: 'leadership' },
-    { name: 'Nasser', arabic: 'ناصر', role: 'Engineering Manager', real: true, type: 'leadership' },
-    { name: 'Hussain', arabic: 'حسين', role: 'PM + Scrum Master', type: 'product' },
-    { name: 'Layla', arabic: 'ليلى', role: 'Lead UX Designer', type: 'design' },
-    { name: 'Zahra', arabic: 'زهرة', role: 'Branding & Creative Director', type: 'design' },
-    { name: 'Omar', arabic: 'عمر', role: 'Full-Stack Engineer', type: 'engineering' },
-    { name: 'Haitham Al Khamiyasi', arabic: 'هيثم', role: 'Senior Frontend', real: true, type: 'engineering' },
-    { name: 'Yousef', arabic: 'يوسف', role: 'Senior Backend', type: 'engineering' },
-    { name: 'Zayd', arabic: 'زيد', role: 'ML Engineer', type: 'engineering' },
-    { name: 'Fatima', arabic: 'فاطمة', role: 'QA Lead', type: 'quality' },
-    { name: 'Khalid', arabic: 'خالد', role: 'DevOps', type: 'engineering' },
-    { name: 'Noor', arabic: 'نور', role: 'Scribe', type: 'support' },
-    { name: 'Mariam', arabic: 'مريم', role: 'Marketing Lead', type: 'product' },
-    { name: 'Raees', arabic: 'رئيس', role: 'Orchestration Director', type: 'system' },
-    { name: 'Majlis', arabic: 'مجلس', role: 'Consulting Council', type: 'system' },
-    { name: 'Diwan', arabic: 'ديوان', role: 'Dashboard Registry', type: 'system' },
-  ];
-
-  // #305: separate real vs AI agents
-  const realAgents = agents.filter(a => a.real);
-  const aiAgents = agents.filter(a => !a.real);
-
-  function agentCard(a) {
-    const filterText = (a.name + ' ' + a.role + ' ' + a.arabic + ' ' + a.type).toLowerCase();
-    // #303: link to SKILL.md
-    const skillName = a.name.split(' ')[0].toLowerCase();
-    return `<div class="agent-card" data-filter-text="${filterText}" onclick="viewAgentSkill('${skillName}')" style="cursor:pointer;">
-      <div class="name">${esc(a.name)}${a.real ? ' <span class="real-badge">real</span>' : ''} <span class="type-badge">${esc(a.type)}</span></div>
-      <div class="arabic">${a.arabic}</div>
-      <div class="role">${esc(a.role)}</div>
-    </div>`;
-  }
+  // Agent roster moved to server/lib/html/client/agents-data.js (Sprint 31.3).
+  // AgentsView.js renders it client-side; shell.js no longer needs it.
 
   return `<!DOCTYPE html>
 <html lang="en" dir="ltr">
@@ -57,181 +19,25 @@ function renderHtml(state) {
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>Majlis — ${esc(projectName)}</title>
 <link rel="preconnect" href="https://fonts.googleapis.com">
-<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
-<script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"><\/script>
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/xterm@5.3.0/css/xterm.css">
+<script src="https://cdn.jsdelivr.net/npm/marked@15.0.7/marked.min.js"><\/script>
+<script src="https://cdn.jsdelivr.net/npm/xterm@5.3.0/lib/xterm.js"><\/script>
+<script src="https://cdn.jsdelivr.net/npm/xterm-addon-fit@0.8.0/lib/xterm-addon-fit.js"><\/script>
+<script>window.__ORCH_TOKEN__ = ${JSON.stringify(orchToken || '')};<\/script>
 ${renderCss()}
 </head>
 <body>
-<div class="app-shell">
-  <aside class="sidebar">
-    <div class="sidebar-project">
-      <div class="project-label">Project</div>
-      ${esc(projectName)}
-    </div>
-    <nav>
-      <div class="nav-section">Overview</div>
-      <button class="nav-link" data-view="overview">🏠 Overview</button>
-      <button class="nav-link" data-view="roadmap">🗺 Roadmap</button>
-      <div class="nav-section">Planning</div>
-      <button class="nav-link" data-view="milestones">🎯 Milestones</button>
-      <button class="nav-link" data-view="phases">📋 Phases</button>
-      <button class="nav-link" data-view="sprints">⚡ Sprints</button>
-      <button class="nav-link" data-view="tasks">✓ Tasks</button>
-      <div class="nav-section">Workspace</div>
-      <button class="nav-link" data-view="files">📄 Files</button>
-      <button class="nav-link" data-view="agents">🤝 Agents</button>
-      <button class="nav-link" data-view="decisions">⚖ Decisions</button>
-      <button class="nav-link" data-view="memory">🧠 Memory Bank</button>
-    </nav>
-  </aside>
-  <div id="sidebar-backdrop" onclick="closeSidebar()"></div>
-  <div class="content-area" id="main-content">
-    <header>
-      <div style="display:flex;align-items:center;gap:var(--space-3);">
-        <button class="hamburger-btn" id="hamburger-btn" onclick="toggleSidebar()" aria-label="Toggle menu">
-          <span></span><span></span><span></span>
-        </button>
-        <div class="brand">
-          <div class="icon">🕌</div>
-          <div>
-            <h1>Majlis — The Council</h1>
-            <div class="arabic">مجلس · ${esc(projectName)}</div>
-          </div>
-        </div>
-      </div>
-      <div class="header-actions">
-        <span class="live" id="live-dot"></span>
-        <span id="updated-ago" style="font-size:var(--text-sm);color:var(--text-secondary);">just now</span>
-        &nbsp;·&nbsp;
-        <button class="header-btn" id="refresh-btn" onclick="manualRefresh()">↺ Refresh</button>
-        <button class="header-btn" id="theme-btn" onclick="toggleTheme()" title="Toggle dark/light">☀️</button>
-        <button class="header-btn" onclick="copyUrl()" title="Copy URL">🔗</button>
-        <button class="header-btn" onclick="exportSnapshot()" title="Export snapshot">📥</button>
-      </div>
-    </header>
-
-    ${state.rawParseError ? `<div id="parse-warning">⚠️ <strong>state.json parse error:</strong> ${esc(state.rawParseError)} — Dashboard showing partial data.</div>` : ''}
-
-    ${state.blockers.length > 0 ? `
-    <div id="blocker-banner">
-      <span class="banner-title">🚧 ${state.blockers.length} Blocker${state.blockers.length > 1 ? 's' : ''}</span>
-      <span class="banner-list">${state.blockers.map(b => esc(typeof b === 'string' ? b : (b.title || ''))).join(' · ')}</span>
-      <button class="banner-dismiss" onclick="dismissBlockers()">Dismiss</button>
-    </div>` : ''}
-
-    <div id="view-overview" class="view active">
-      ${!state.exists ? `
-        <div class="empty" style="padding:80px;background:var(--bg-card);border-radius:var(--radius-lg);">
-          <h2 style="color:var(--rihal-gold);margin-bottom:16px;">No .rihal/ directory found</h2>
-          <p>Run the <code>*kickoff</code> workflow to initialize a project.</p>
-          <div class="empty-action">npx rcode install</div>
-        </div>
-      ` : `
-        <div class="stats">
-          <div class="stat">
-            <div class="label">Current Phase</div>
-            <div class="value">${esc(currentPhase)}</div>
-            <div class="sub">${phaseCount} total phases${currentSprint ? ` · Sprint ${esc(currentSprint)}` : ''}</div>
-          </div>
-          <div class="stat">
-            <div class="label">Milestone</div>
-            <div class="value" style="font-size:16px;padding-top:6px;" id="stat-milestone">${esc(state.milestone || '—')}</div>
-            <div class="sub">&nbsp;</div>
-          </div>
-          <div class="stat">
-            <div class="label">Decisions (ADRs)</div>
-            <div class="value">${decisionCount}</div>
-            <div class="sub">Architecture records</div>
-          </div>
-          <div class="stat">
-            <div class="label">Planning Files</div>
-            <div class="value">${artifactCount}</div>
-            <div class="sub">SPRINT, CONTEXT, VERIFY, RESEARCH</div>
-          </div>
-          ${state.blockers.length > 0 ? `
-          <div class="stat" style="border-left-color:var(--accent-red);">
-            <div class="label" style="color:var(--accent-red);">Blockers</div>
-            <div class="value" style="color:var(--accent-red);">${state.blockers.length}</div>
-            <div class="sub">Active blockers</div>
-          </div>` : ''}
-          ${state.councilSessions > 0 ? `
-          <div class="stat">
-            <div class="label">Council Sessions</div>
-            <div class="value">${state.councilSessions}</div>
-            <div class="sub">Recorded sessions</div>
-          </div>` : ''}
-        </div>
-
-        <div id="view-overview-dynamic"></div>
 
-        <section>
-          <h2>🎯 Active Context</h2>
-          <div class="body">
-            ${state.context
-              ? `<div class="item-preview" style="max-height:none;">${esc(state.context)}</div>`
-              : `<div class="empty">No active context.<div class="empty-action">Run context-build workflow</div></div>`}
-          </div>
-        </section>
-      `}
-    </div>
+<!-- ── Preact app mount ────────────────────────────────────────────────── -->
+<!-- App renders: sidebar, topbar, and all 12 Preact views (sprint 31.4).  -->
+<div id="app-root"></div>
 
-    <div id="view-roadmap"    class="view"></div>
-    <div id="view-milestones" class="view"></div>
-    <div id="view-phases"     class="view"></div>
-    <div id="view-sprints"    class="view"></div>
-    <div id="view-tasks"      class="view"></div>
-
-    <div id="view-files" class="view">
-      <div class="view-title">Files</div>
-      <div id="file-list-inline"></div>
-      <div id="file-view"></div>
-    </div>
-
-    <div id="view-agents" class="view">
-      <div class="view-title">Agents</div>
-      <div class="filter-bar">
-        <input class="filter-input" type="text" placeholder="Filter…" oninput="filterItems(this,'agents-list')">
-      </div>
-      <div id="agents-list">
-        <div style="font-size:var(--text-sm);font-weight:600;color:var(--rihal-gold);margin-bottom:var(--space-3);">Team Members</div>
-        <div class="agents" style="margin-bottom:var(--space-6);">
-          ${realAgents.map(agentCard).join('')}
-        </div>
-        <div style="font-size:var(--text-sm);font-weight:600;color:var(--accent-blue);margin-bottom:var(--space-3);">AI Agents</div>
-        <div class="agents">
-          ${aiAgents.map(agentCard).join('')}
-        </div>
-      </div>
-    </div>
-
-    <div id="view-decisions" class="view"></div>
+<!-- ── Toast ──────────────────────────────────────────────── -->
+<div class="toast" id="toast"></div>
 
-    <div id="view-memory" class="view">
-      <div id="view-memory-content"><div class="empty" style="padding:80px;background:var(--bg-card);border-radius:var(--radius-lg);"><h2 style="color:var(--rihal-gold);margin-bottom:16px;">Memory Bank</h2><p>Loading…</p></div></div>
-    </div>
+<!-- Xterm and orchestrator panels are now rendered by Preact (Sprint 31.4).
+     Static panel markup removed — XtermPanel.js + OrchPanel.js own the DOM. -->
 
-    <footer>
-      <div class="arabic">رحلة البناء · The Journey of Building</div>
-      <div>Rihal Code · View-Only Dashboard · <kbd>R</kbd> refresh · <kbd>1-9</kbd> switch views · <kbd>F</kbd> filter</div>
-    </footer>
-  </div>
-</div>
-<div class="toast" id="toast"></div>
-<script>
-// #303: view agent skill file
-function viewAgentSkill(name) {
-  // Try to find matching file in file tree
-  var items = document.querySelectorAll('.file-tree-item');
-  for (var i = 0; i < items.length; i++) {
-    if ((items[i].dataset.path || '').toLowerCase().includes(name)) {
-      items[i].click();
-      return;
-    }
-  }
-  // Fallback
-  navTo('files');
-}
-<\/script>
 ${renderClientJs(state)}
 </body>
 </html>`;

package/server/lib/scanner.js

@@ -31,6 +31,80 @@ function parseSimpleYaml(text) {
   return out;
 }
 
+/**
+ * Derive the phase → sprint → story tree from the .planning/phases/ filesystem,
+ * which is the committed source of truth. state.json sprint/story records are
+ * often incomplete (planner agents write SPRINT.md files without registering
+ * sprint entries), so the dashboard derives counts from disk instead of trusting
+ * state.json. When a phase has a directory with *-SPRINT.md files, those win;
+ * otherwise the raw state.json sprints array is kept as-is.
+ *
+ * @param {string} projectDir   repo root
+ * @param {Array}  rawPhases    state.raw.phases
+ * @returns {Array|null}        phases with a populated `sprints` array each
+ */
+function buildPhaseTree(projectDir, rawPhases) {
+  if (!Array.isArray(rawPhases)) return null;
+  const phasesDir = path.join(projectDir, '.planning', 'phases');
+  let dirs;
+  try {
+    dirs = fs.readdirSync(phasesDir, { withFileTypes: true }).filter(d => d.isDirectory());
+  } catch { return rawPhases; }
+
+  return rawPhases.map(p => {
+    const intId = String(p.id || p.number || '').split('.')[0];
+    if (!intId) return p;
+    const dir = dirs.find(d => d.name.startsWith(intId + '-') ||
+                               d.name.startsWith(intId.padStart(2, '0') + '-'));
+    if (!dir) return p;
+
+    let files;
+    try { files = fs.readdirSync(path.join(phasesDir, dir.name)); } catch { return p; }
+    const sprintFiles = files.filter(f => /-SPRINT\.md$/i.test(f)).sort();
+    if (!sprintFiles.length) return p;
+
+    const phaseComplete = /complete|done/i.test(p.status || '');
+    const sprints = sprintFiles.map(f => {
+      const m   = f.match(/^(\d+)-(\d+)-SPRINT\.md$/i);
+      const num = m ? parseInt(m[2], 10) : 0;
+      const sid = m ? `${parseInt(m[1], 10)}.${num}` : f.replace(/-SPRINT\.md$/i, '');
+      const text = safeReadText(path.join(phasesDir, dir.name, f)) || '';
+
+      // Sprint goal: frontmatter `goal:`, else first line of <objective>.
+      const fm = parseSimpleYaml((text.match(/^---\n([\s\S]*?)\n---/) || [])[1] || '');
+      let goal = fm.goal || '';
+      if (!goal) {
+        const obj = (text.match(/<objective>\s*([\s\S]*?)<\/objective>/) || [])[1] || '';
+        goal = (obj.trim().split('\n').map(s => s.trim()).filter(Boolean)[0] || '').slice(0, 160);
+      }
+
+      // Stories: one per <task> block; title from <title>.
+      const stories = [];
+      const taskRe = /<task\b([^>]*)>([\s\S]*?)<\/task>/g;
+      let tm;
+      while ((tm = taskRe.exec(text))) {
+        const idM    = tm[1].match(/id="([^"]+)"/);
+        const titleM = tm[2].match(/<title>([\s\S]*?)<\/title>/);
+        stories.push({
+          id:     idM ? idM[1] : `${sid}-task-${stories.length + 1}`,
+          title:  titleM ? titleM[1].trim() : `Task ${stories.length + 1}`,
+          status: phaseComplete ? 'done' : 'todo',
+        });
+      }
+
+      // Status: a *-SUMMARY.md sibling means the sprint shipped.
+      const hasSummary = files.includes(f.replace(/-SPRINT\.md$/i, '-SUMMARY.md'));
+      const status = hasSummary ? 'complete'
+        : (p.status === 'active' || p.status === 'in_progress') ? 'in_progress'
+        : 'planned';
+
+      return { id: sid, number: num, goal: goal || `Sprint ${num}`, status, stories };
+    });
+
+    return { ...p, sprints };
+  });
+}
+
 function scanState(rihalDir) {
   const projectDir = path.dirname(rihalDir);
   const state = {
@@ -167,6 +241,41 @@ function scanState(rihalDir) {
   }
   if (fs.existsSync(planningDir)) walkPlanning(planningDir, '');
 
+  // #12 — surface pending handoff (.rihal/HANDOFF.json) and active context
+  // (.rihal/context/active.md) for the dashboard banner + memory-bank summary.
+  // Both are no-op when the files don't exist. View-only — no writes.
+  const handoffPath = path.join(rihalDir, 'HANDOFF.json');
+  if (fs.existsSync(handoffPath)) {
+    const ho = safeReadJson(handoffPath);
+    if (ho && !ho.__parseError) {
+      state.pendingHandoff = {
+        path: '.rihal/HANDOFF.json',
+        ts: ho.ts || ho.timestamp || null,
+        summary: ho.summary || ho.note || ho.what_was_happening || null,
+        phase: ho.phase || ho.current_phase || null,
+        sprint: ho.sprint || ho.current_sprint || null,
+        resume_hint: ho.resume_hint || ho.next || null,
+      };
+    }
+  }
+
+  const activeCtx = path.join(rihalDir, 'context', 'active.md');
+  if (fs.existsSync(activeCtx)) {
+    try {
+      const stat = fs.statSync(activeCtx);
+      const text = fs.readFileSync(activeCtx, 'utf8');
+      state.memoryBank = state.memoryBank || {};
+      state.memoryBank.active = {
+        path: '.rihal/context/active.md',
+        bytes: stat.size,
+        lines: text.split('\n').length,
+        updated: stat.mtime.toISOString(),
+      };
+    } catch { /* ignore */ }
+  }
+
+  state.phaseTree = buildPhaseTree(projectDir, state.raw && state.raw.phases);
+
   return state;
 }