sdtk-wiki-kit 0.2.1 → 0.3.0

package/assets/atlas/doc_atlas_viewer_template.html

@@ -359,6 +359,7 @@ body.nav-open .page-nav-toggle{display:none}
 #atlas-ask-model-select{flex:0 0 136px;width:136px}
 #atlas-ask-mode-select{flex:1 1 140px;width:140px}
 #atlas-ask-info-toggle{flex:0 0 36px}
+#atlas-ask-path-filter{padding:0 12px;background-image:none;flex:1 1 120px}
 .atlas-ask-send{display:inline-flex;align-items:center;justify-content:center;flex:0 0 42px;width:42px;height:42px;border-radius:999px;border:0;background:linear-gradient(135deg,#4f78ff 0%,#3156c9 100%);color:#ffffff;cursor:pointer;font-size:20px;font-weight:900;box-shadow:0 14px 24px rgba(49,86,201,0.26)}
 .atlas-ask-send:hover{filter:brightness(1.03)}
 .atlas-ask-send:disabled{opacity:.5;cursor:not-allowed}
@@ -407,6 +408,47 @@ body.nav-open .page-nav-toggle{display:none}
 .atlas-ask-history-item strong{font-size:12px;color:#24344d}
 .atlas-ask-history-meta{font-size:11px;color:#6d7d95;line-height:1.4}
 .atlas-ask-history-preview{font-size:12px;color:#52606f;line-height:1.45}
+.ask-scope-wrap{position:relative;flex:1 1 150px;min-width:0}
+.ask-scope-btn{display:flex;align-items:center;gap:8px;width:100%;height:36px;padding:0 12px;border-radius:999px;border:1px solid #d9cfbf;background:#fff;color:#24344d;font-size:12px;font-weight:700;cursor:pointer;box-shadow:0 8px 18px rgba(15,23,42,0.04);text-align:left}
+.ask-scope-btn:hover{border-color:#aebfe7;background:#f6f8ff}
+.ask-scope-btn .scope-ico{flex:0 0 auto}
+.ask-scope-btn .scope-label{flex:1 1 auto;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.ask-scope-btn .scope-caret{flex:0 0 auto;color:#7d8fa8;font-size:9px}
+.ask-scope-menu{display:none;position:absolute;left:0;bottom:calc(100% + 8px);z-index:5;flex-direction:column;gap:2px;padding:8px;min-width:248px;max-width:320px;background:rgba(255,255,255,0.99);border:1px solid #d9cfbf;border-radius:18px;box-shadow:0 18px 30px rgba(94,83,63,0.18);max-height:340px;overflow:auto}
+.ask-scope-wrap.open .ask-scope-menu{display:flex}
+.ask-scope-opt{display:flex;align-items:center;gap:10px;padding:9px 10px;border-radius:12px;cursor:pointer;color:#24344d}
+.ask-scope-opt:hover{background:#f7f9ff}
+.ask-scope-opt.active{background:#eef3ff;border:1px solid #cad7ff;padding:8px 9px}
+.ask-scope-opt.disabled{opacity:.45;cursor:not-allowed;pointer-events:none}
+.ask-scope-opt .opt-ico{flex:0 0 18px;text-align:center}
+.ask-scope-opt .opt-copy{display:flex;align-items:center;min-width:0;flex:1}
+.ask-scope-opt .opt-copy strong{font-size:12.5px;font-weight:700;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.ask-scope-opt .opt-check{flex:0 0 auto;color:#3156c9;font-weight:900;visibility:hidden}
+.ask-scope-opt.active .opt-check{visibility:visible}
+.ask-scope-sep{height:1px;background:#ece4d8;margin:4px 2px}
+.ask-folder-block{display:none;flex-direction:column;gap:6px;padding:4px 4px 6px;margin:2px 0 0;border-top:1px dashed #e6ded1}
+.ask-folder-block.open{display:flex}
+.ask-folder-filter{height:32px;border-radius:999px;border:1px solid #d9cfbf;background:#fff;padding:0 12px;font:inherit;font-size:12px;color:#24344d}
+.ask-folder-filter:focus{outline:none;border-color:#5f89ff;box-shadow:0 0 0 3px rgba(95,137,255,0.12)}
+.ask-folder-list{display:flex;flex-direction:column;gap:1px;max-height:170px;overflow:auto}
+.ask-folder-item{display:flex;align-items:center;justify-content:space-between;gap:10px;padding:7px 10px;border-radius:10px;cursor:pointer;font-size:12px}
+.ask-folder-item:hover{background:#f7f9ff}
+.ask-folder-item.active{background:#eef3ff}
+.ask-folder-item .f-path{font-family:'SF Mono',Consolas,monospace;color:#354153;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.ask-folder-item .f-count{flex:0 0 auto;font-size:11px;font-weight:800;color:#6d7d95;background:#f3efe7;border:1px solid #e6ded1;border-radius:999px;padding:1px 8px}
+.ask-sources{margin-top:2px;border:1px solid #e6ded1;border-radius:14px;background:rgba(255,255,255,0.9);overflow:hidden}
+.ask-sources-head{display:flex;align-items:center;gap:8px;width:100%;padding:10px 12px;background:none;border:0;cursor:pointer;color:#52606f;font-size:12px;font-weight:700;text-align:left}
+.ask-sources-head:hover{background:#f7f9ff}
+.ask-sources-caret{transition:transform .15s ease;color:#7d8fa8;font-size:10px}
+.ask-sources.open .ask-sources-caret{transform:rotate(90deg)}
+.ask-sources-badge{display:inline-flex;align-items:center;justify-content:center;min-width:20px;height:18px;padding:0 6px;border-radius:999px;background:#3156c9;color:#fff;font-size:11px;font-weight:800}
+.ask-sources-body{display:none;flex-direction:column;gap:6px;padding:4px 12px 12px}
+.ask-sources.open .ask-sources-body{display:flex}
+.ask-source-row{display:flex;align-items:center;justify-content:space-between;gap:10px;padding:7px 10px;border:1px solid #ece4d8;border-radius:10px;background:#fff}
+.ask-source-row .s-path{font-family:'SF Mono',Consolas,monospace;font-size:11.5px;color:#354153;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.s-chip{flex:0 0 auto;font-size:10px;font-weight:800;letter-spacing:.04em;text-transform:uppercase;border-radius:999px;padding:2px 8px}
+.s-chip.primary{color:#2f8f5b;background:#e7f6ee;border:1px solid #bfe6cf}
+.s-chip.related{color:#3156c9;background:#eef3ff;border:1px solid #cad7ff}
 @media (max-width: 1180px){
   .atlas-ask-dock{position:relative;left:auto;top:auto;bottom:auto;width:100%;max-width:none;margin-top:14px}
   .atlas-ask-dock:not(.open){width:100%}
@@ -482,6 +524,47 @@ body.nav-open .page-nav-toggle{display:none}
   .graph-toolbar-overlay,.graph-toolbar-overlay.compact,.graph-toolbar-overlay.minimized{position:relative;top:auto;left:auto;width:100%;max-width:none;margin-bottom:14px}
   .graph-focus-overlay,.graph-focus-overlay.minimized{position:relative;top:auto;right:auto;bottom:auto;width:100%;height:auto;max-height:none;pointer-events:auto}
 }
+/* BK-272 Agent Kaban board */
+.kaban-header{display:flex;align-items:flex-start;flex-wrap:wrap;gap:8px;padding:8px 2px}
+.kaban-feature-info{flex:1;min-width:0}
+.kaban-feature-name{font-size:14px;font-weight:700;color:var(--graph-text)}
+.kaban-meta{font-size:11px;color:var(--graph-muted);margin-top:2px}
+.kaban-liveness{font-size:11px;color:#b84c00;font-weight:700;padding:2px 8px;border:1px solid rgba(184,76,0,.35);border-radius:4px;white-space:nowrap;background:rgba(240,136,62,.07)}
+.kaban-freshness{font-size:10px;color:var(--graph-muted)}
+.kaban-notice{margin:0 0 6px;padding:5px 10px;border-radius:5px;font-size:11px;background:rgba(184,76,0,.06);color:#b84c00;border:1px solid rgba(184,76,0,.18)}
+.kaban-tabs{display:flex;border-bottom:1px solid var(--graph-border);margin-bottom:6px}
+.kaban-tab{background:none;border:none;border-bottom:2px solid transparent;padding:5px 14px;font-size:11px;font-weight:600;color:var(--graph-muted);cursor:pointer;margin-bottom:-1px}
+.kaban-tab:hover{color:var(--graph-text)}
+.kaban-tab.active{color:var(--graph-text);border-bottom-color:#5f89ff}
+.kaban-board-wrap{overflow-x:auto;padding-bottom:8px}
+.kaban-board{display:grid;grid-template-columns:80px repeat(4,minmax(110px,1fr));min-width:540px;column-gap:5px;row-gap:0}
+.kaban-col-header{font-size:9px;text-transform:uppercase;letter-spacing:.06em;font-weight:700;padding:3px 4px 6px;text-align:center;color:var(--graph-muted)}
+.kaban-col-header.kaban-col-inprog{color:#3156c9}
+.kaban-col-header.kaban-col-pending{color:#b84c00}
+.kaban-col-header.kaban-col-done{color:#1a7f37}
+.kaban-swimlane-header{font-size:8px;font-weight:700;text-transform:uppercase;letter-spacing:.05em;color:var(--graph-muted);padding:7px 4px 3px;text-align:right;border-top:1px solid var(--graph-border)}
+.kaban-cell{min-height:28px;padding:3px 2px;border-top:1px solid var(--graph-border);display:flex;flex-direction:column;gap:3px}
+.kaban-cell.kaban-cell-inprog .kaban-card{border-left:3px solid #3156c9}
+.kaban-cell.kaban-cell-pending .kaban-card{border-left:3px solid #b84c00}
+.kaban-cell.kaban-cell-done .kaban-card{border-left:3px solid #1a7f37}
+.kaban-cell.kaban-cell-todo .kaban-card{border-left:3px solid var(--border)}
+.kaban-card{background:var(--surface);border:1px solid var(--border);border-radius:4px;padding:5px 7px;font-size:11px;color:var(--text);cursor:pointer;line-height:1.4;transition:background .12s}
+.kaban-card:hover{background:var(--surface2)}
+.kaban-card-title{font-weight:600}
+.kaban-card-badges{display:flex;gap:3px;flex-wrap:wrap;margin-top:2px}
+.kaban-badge{font-size:9px;font-weight:700;text-transform:uppercase;letter-spacing:.04em;padding:1px 4px;border-radius:3px;display:inline-block}
+.kaban-badge-attention{background:rgba(184,76,0,.14);color:#b84c00;border:1px solid rgba(184,76,0,.28)}
+.kaban-badge-gate{background:rgba(100,60,200,.08);color:#6438c8;border:1px solid rgba(100,60,200,.2)}
+.kaban-card-detail{position:fixed;top:10%;left:10%;right:10%;max-height:76vh;z-index:200;background:var(--surface);border:1px solid var(--border);border-radius:10px;display:flex;flex-direction:column;box-shadow:0 16px 48px rgba(0,0,0,.7)}
+.kaban-detail-header{display:flex;align-items:flex-start;gap:10px;padding:12px 14px 8px;border-bottom:1px solid var(--border)}
+.kaban-detail-phase{font-size:9px;text-transform:uppercase;letter-spacing:.07em;color:var(--text2);font-weight:700}
+.kaban-detail-title{font-size:14px;font-weight:700;color:var(--text);margin-top:3px}
+.kaban-detail-close{background:none;border:none;color:var(--text2);font-size:18px;cursor:pointer;padding:0 4px;line-height:1;border-radius:3px;flex-shrink:0}
+.kaban-detail-close:hover{color:var(--text);background:var(--surface2)}
+.kaban-detail-body{padding:12px 14px;overflow-y:auto;flex:1;font-size:12px;line-height:1.6}
+.kaban-detail-row{display:flex;gap:8px;margin-bottom:5px}
+.kaban-detail-label{font-size:10px;text-transform:uppercase;letter-spacing:.05em;color:var(--text2);font-weight:600;min-width:68px;flex-shrink:0}
+.kaban-detail-value{color:var(--text);flex:1;word-break:break-word}
 
 </style>
 </head>
@@ -503,25 +586,33 @@ body.nav-open .page-nav-toggle{display:none}
       <p>Project-local wiki and knowledge graph - generated __ATLAS_GENERATED__</p>
     </div>
     <div class="screen-scroll">
-      <div class="dash-grid">
-        <div class="dash-card" style="border-color:#58a6ff">
-          <span class="num" style="color:#58a6ff" id="stat-total">-</span>
-          <span class="label">Total Docs</span>
+      <div class="kaban-header" id="kaban-header">
+        <div class="kaban-feature-info">
+          <div class="kaban-feature-name" id="kaban-feature-name">Agent Kaban Board</div>
+          <div class="kaban-meta" id="kaban-meta">Loading pipeline data...</div>
         </div>
-        <div class="dash-card" style="border-color:#3fb950">
-          <span class="num" style="color:#3fb950" id="stat-families">-</span>
-          <span class="label">Families</span>
-        </div>
-        <div class="dash-card" style="border-color:#f0883e">
-          <span class="num" style="color:#f0883e" id="stat-edges">-</span>
-          <span class="label">Graph Edges</span>
-        </div>
-        <div class="dash-card" style="border-color:#d2a8ff">
-          <span class="num" style="color:#d2a8ff" id="stat-issues">-</span>
-          <span class="label">BK Issues</span>
+        <div class="kaban-liveness" id="kaban-liveness" style="display:none">&#9888; <span id="kaban-liveness-text"></span></div>
+        <div class="kaban-freshness" id="kaban-freshness"></div>
+      </div>
+      <div class="kaban-notice" id="kaban-notice" style="display:none"></div>
+      <div class="kaban-tabs">
+        <button class="kaban-tab active" id="kaban-tab-pipeline" onclick="switchKabanTab('pipeline')">Pipeline</button>
+        <button class="kaban-tab" id="kaban-tab-quality" onclick="switchKabanTab('quality')">Quality Gates</button>
+      </div>
+      <div class="kaban-board-wrap">
+        <div id="kaban-board-pipeline"></div>
+        <div id="kaban-board-quality" style="display:none"></div>
+      </div>
+    </div>
+    <div class="kaban-card-detail" id="kaban-card-detail" style="display:none">
+      <div class="kaban-detail-header">
+        <div style="flex:1;min-width:0">
+          <div class="kaban-detail-phase" id="kd-phase"></div>
+          <div class="kaban-detail-title" id="kd-title"></div>
         </div>
+        <button class="kaban-detail-close" onclick="closeKabanDetail()" aria-label="Close card detail" title="Close card detail">&times;</button>
       </div>
-      <div id="dash-family-rows"></div>
+      <div class="kaban-detail-body" id="kd-body"></div>
     </div>
   </div>
 </div>
@@ -614,7 +705,7 @@ body.nav-open .page-nav-toggle{display:none}
                 <button class="graph-focus-toggle atlas-ask-collapse" id="atlas-ask-toggle" title="Hide Ask SDTK-WIKI" onclick="toggleWikiAsk(false)">&#9662;</button>
                 <div class="atlas-ask-attachments" id="atlas-ask-attachments"></div>
                 <div class="atlas-ask-input-wrap">
-                  <textarea class="atlas-ask-input" id="atlas-ask-input" placeholder="Ask about the visible graph group, current focus, or attached docs..."></textarea>
+                  <textarea class="atlas-ask-input" id="atlas-ask-input" placeholder="Ask something about your docs..."></textarea>
                   <div class="atlas-ask-mention-results" id="atlas-ask-mention-results"></div>
                 </div>
                 <div class="atlas-ask-source-summary" id="atlas-ask-source-summary"></div>
@@ -622,11 +713,40 @@ body.nav-open .page-nav-toggle{display:none}
                   <div class="atlas-ask-controls">
                     <select class="atlas-ask-mode-select" id="atlas-ask-runtime-select" onchange="setWikiAskRuntimeAgent(this.value)" aria-label="Select runtime agent"></select>
                     <select class="atlas-ask-mode-select" id="atlas-ask-model-select" onchange="setWikiAskModel(this.value)" aria-label="Select model"></select>
-                    <select class="atlas-ask-mode-select" id="atlas-ask-mode-select" onchange="setWikiAskMode(this.value)" aria-label="Select grounding mode">
-                      <option value="visible-group">Visible Group</option>
-                      <option value="current-focus">Current Focus</option>
-                      <option value="selected-docs">Selected Docs</option>
-                    </select>
+                    <div class="ask-scope-wrap" id="ask-scope-wrap">
+                      <button class="ask-scope-btn" id="ask-scope-btn" onclick="toggleWikiAskScopeMenu(event)" aria-haspopup="listbox" aria-expanded="false" title="Select Ask scope">
+                        <span class="scope-ico" id="ask-scope-ico">&#128218;</span>
+                        <span class="scope-label" id="ask-scope-label">All Docs</span>
+                        <span class="scope-caret">&#9650;</span>
+                      </button>
+                      <div class="ask-scope-menu" id="ask-scope-menu" role="listbox">
+                        <div class="ask-scope-opt active" data-scope="all" role="option" tabindex="0" onclick="pickWikiAskScope('all')" title="Hỏi trên toàn bộ tài liệu đã index (mặc định).">
+                          <span class="opt-ico">&#128218;</span>
+                          <span class="opt-copy"><strong>All Docs</strong></span>
+                          <span class="opt-check">&#10003;</span>
+                        </div>
+                        <div class="ask-scope-opt" id="ask-scope-opt-folder" data-scope="folder" role="option" tabindex="0" onclick="toggleWikiAskFolderBlock(event)" title="Chọn một thư mục có thật để giới hạn phạm vi hỏi.">
+                          <span class="opt-ico">&#128193;</span>
+                          <span class="opt-copy"><strong>By folder</strong></span>
+                          <span class="opt-check">&#10003;</span>
+                        </div>
+                        <div class="ask-folder-block" id="ask-folder-block">
+                          <input class="ask-folder-filter" id="ask-folder-filter" type="text" placeholder="Filter folders&#x2026;" oninput="filterWikiAskFolders(this.value)" aria-label="Filter folders by name">
+                          <div class="ask-folder-list" id="ask-folder-list"></div>
+                        </div>
+                        <div class="ask-scope-sep"></div>
+                        <div class="ask-scope-opt" id="ask-scope-opt-focus" data-scope="focus" role="option" tabindex="0" onclick="pickWikiAskScope('focus')" title="T&#xE0;i li&#x1EC7;u &#x111;ang focus + c&#xE1;c t&#xE0;i li&#x1EC7;u li&#xEA;n quan c&#xF9;ng BK / knowledge / skill.">
+                          <span class="opt-ico">&#127919;</span>
+                          <span class="opt-copy"><strong>This doc + related</strong></span>
+                          <span class="opt-check">&#10003;</span>
+                        </div>
+                        <div class="ask-scope-opt" id="ask-scope-opt-selected" data-scope="selected" role="option" tabindex="0" onclick="pickWikiAskScope('selected')" title="Ch&#x1EC9; h&#x1ECF;i tr&#xEA;n c&#xE1;c t&#xE0;i li&#x1EC7;u b&#x1EA1;n &#x111;&#xE3; &#x111;&#xED;nh k&#xE8;m.">
+                          <span class="opt-ico">&#10003;</span>
+                          <span class="opt-copy"><strong id="ask-scope-selected-label">Selected docs</strong></span>
+                          <span class="opt-check">&#10003;</span>
+                        </div>
+                      </div>
+                    </div>
                     <button class="atlas-ask-icon-btn" id="atlas-ask-info-toggle" title="Show grounding info" onclick="toggleWikiAskAdvanced()">i</button>
                   </div>
                   <button class="atlas-ask-send" id="atlas-ask-submit" onclick="submitWikiAsk()" aria-label="Submit SDTK-WIKI Ask" title="Submit SDTK-WIKI Ask">&#8593;</button>
@@ -740,26 +860,179 @@ const FAMILY_GLYPHS = {
 };
 const GRAPH_EDGE_COLORS = { references_path: 'rgba(95,137,255,0.38)', references_wiki_link: 'rgba(46,181,125,0.44)' };
 const GRAPH_FRAME_MS = 40;
-(function initDash() {
-  const docs = INDEX.documents;
-  const families = new Set(docs.map(d => d.family));
-  const issues = new Set(docs.flatMap(d => d.issues));
-  const edges = GRAPH.edges.filter(e => e.type !== 'same_family');
-  document.getElementById('stat-total').textContent = docs.length;
-  document.getElementById('stat-families').textContent = families.size;
-  document.getElementById('stat-edges').textContent = edges.length;
-  document.getElementById('stat-issues').textContent = issues.size;
-  const famCounts = {};
-  docs.forEach(d => { famCounts[d.family] = (famCounts[d.family] || 0) + 1; });
-  const rows = document.getElementById('dash-family-rows');
-  Object.entries(famCounts).sort((a,b)=>b[1]-a[1]).forEach(([fam,cnt]) => {
-    const color = FAMILY_COLORS[fam] || '#8b949e';
-    const row = document.createElement('div');
-    row.className = 'stat-row';
-    row.innerHTML = `<span class="label"><span class="dot" style="background:${color}"></span> ${fam}</span><span class="val" style="color:${color}">${cnt}</span>`;
-    rows.appendChild(row);
-  });
-})();
+// BK-272: Agent Kaban board — state, render, and poll
+var kabanState = { data: null, activeTab: 'pipeline', pollTimer: null, lastFetch: null };
+const KABAN_POLL_MS = 3000;
+const KABAN_LIVENESS_MIN_JS = 15;
+const KABAN_COLS = ['todo', 'in_progress', 'pending', 'done'];
+const KABAN_COL_LABELS = { todo: 'Todo', in_progress: 'In Progress', pending: 'Pending', done: 'Done' };
+const KABAN_COL_CSS = { todo: '', in_progress: 'kaban-col-inprog', pending: 'kaban-col-pending', done: 'kaban-col-done' };
+const KABAN_CELL_CSS = { todo: 'kaban-cell-todo', in_progress: 'kaban-cell-inprog', pending: 'kaban-cell-pending', done: 'kaban-cell-done' };
+
+function safeKabanHtml(s) {
+  return String(s || '').replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
+}
+function formatKabanFreshness(dt) {
+  if (!dt) return '';
+  const d = Math.floor((new Date() - dt) / 1000);
+  if (d < 5) return 'just now';
+  if (d < 60) return d + 's ago';
+  if (d < 3600) return Math.floor(d / 60) + 'm ago';
+  return Math.floor(d / 3600) + 'h ago';
+}
+function renderKabanCard(card) {
+  const badges = [];
+  if (card.attention) badges.push('<span class="kaban-badge kaban-badge-attention">&#9888; Pending</span>');
+  if (card.isGate) badges.push('<span class="kaban-badge kaban-badge-gate">GATE</span>');
+  const id = safeKabanHtml(card.id);
+  const tab = safeKabanHtml(kabanState.activeTab);
+  return '<div class="kaban-card" onclick="openKabanDetail(\'' + id + '\',\'' + tab + '\')" role="button" tabindex="0">' +
+    '<div class="kaban-card-title">' + safeKabanHtml(card.title || card.id) + '</div>' +
+    (badges.length ? '<div class="kaban-card-badges">' + badges.join('') + '</div>' : '') +
+    '</div>';
+}
+function renderKabanBoard(containerId, cards, agents) {
+  const container = document.getElementById(containerId);
+  if (!container) return;
+  if (!cards || cards.length === 0) {
+    container.innerHTML = '<div style="padding:16px;text-align:center;font-size:11px;color:var(--text2)">No data — SHARED_PLANNING.md or QUALITY_CHECKLIST.md not found in project root.</div>';
+    return;
+  }
+  let html = '<div class="kaban-board">';
+  html += '<div class="kaban-col-header"></div>';
+  for (const col of KABAN_COLS) {
+    html += '<div class="kaban-col-header ' + (KABAN_COL_CSS[col] || '') + '">' + KABAN_COL_LABELS[col] + '</div>';
+  }
+  for (const agent of agents) {
+    html += '<div class="kaban-swimlane-header">' + safeKabanHtml(agent) + '</div>';
+    for (const col of KABAN_COLS) {
+      const cellCards = cards.filter(function(c){ return c.agent === agent && c.column === col; });
+      html += '<div class="kaban-cell ' + KABAN_CELL_CSS[col] + '">';
+      for (const c of cellCards) html += renderKabanCard(c);
+      html += '</div>';
+    }
+  }
+  const otherCards = cards.filter(function(c){ return !agents.includes(c.agent); });
+  if (otherCards.length > 0) {
+    html += '<div class="kaban-swimlane-header">OTHER</div>';
+    for (const col of KABAN_COLS) {
+      const cellCards = otherCards.filter(function(c){ return c.column === col; });
+      html += '<div class="kaban-cell ' + KABAN_CELL_CSS[col] + '">';
+      for (const c of cellCards) html += renderKabanCard(c);
+      html += '</div>';
+    }
+  }
+  html += '</div>';
+  container.innerHTML = html;
+}
+function renderKaban(data) {
+  if (!data) return;
+  const meta = data.meta || {};
+  const agents = data.agents || ['PM','BA','ARCH','DEV','QA'];
+  const nameEl = document.getElementById('kaban-feature-name');
+  if (nameEl) nameEl.textContent = meta.featureName || meta.featureKey || 'Agent Kaban Board';
+  const metaEl = document.getElementById('kaban-meta');
+  if (metaEl) {
+    const parts = [];
+    if (meta.featureKey) parts.push(meta.featureKey);
+    if (meta.lastUpdated) parts.push('Updated: ' + meta.lastUpdated);
+    metaEl.textContent = parts.join(' · ') || 'No pipeline data';
+  }
+  const freshEl = document.getElementById('kaban-freshness');
+  if (freshEl && kabanState.lastFetch) freshEl.textContent = 'Fetched ' + formatKabanFreshness(kabanState.lastFetch);
+  const livenessEl = document.getElementById('kaban-liveness');
+  const livenessTextEl = document.getElementById('kaban-liveness-text');
+  if (livenessEl && meta.lastUpdated) {
+    try {
+      const lu = new Date(meta.lastUpdated.replace(' ','T'));
+      const diffMin = Math.floor((new Date() - lu) / 60000);
+      if (diffMin > KABAN_LIVENESS_MIN_JS && !isNaN(diffMin)) {
+        if (livenessTextEl) livenessTextEl.textContent = 'No movement for ' + diffMin + ' min';
+        livenessEl.style.display = '';
+      } else { livenessEl.style.display = 'none'; }
+    } catch(_) { livenessEl.style.display = 'none'; }
+  } else if (livenessEl) { livenessEl.style.display = 'none'; }
+  const noticeEl = document.getElementById('kaban-notice');
+  if (noticeEl) {
+    const notices = [];
+    if (!meta.pipelinePresent) notices.push('SHARED_PLANNING.md not found');
+    if (!meta.qualityPresent) notices.push('QUALITY_CHECKLIST.md not found');
+    (meta.errors || []).forEach(function(e){ notices.push(e); });
+    if (notices.length > 0) { noticeEl.textContent = notices.join(' · '); noticeEl.style.display = ''; }
+    else { noticeEl.style.display = 'none'; }
+  }
+  renderKabanBoard('kaban-board-pipeline', (data.pipeline || {}).cards || [], agents);
+  renderKabanBoard('kaban-board-quality', (data.quality || {}).cards || [], agents);
+}
+function openKabanDetail(cardId, tab) {
+  if (!kabanState.data) return;
+  const src = tab === 'quality' ? (kabanState.data.quality || {}) : (kabanState.data.pipeline || {});
+  const card = (src.cards || []).find(function(c){ return c.id === cardId; });
+  if (!card) return;
+  const phaseEl = document.getElementById('kd-phase');
+  const titleEl = document.getElementById('kd-title');
+  const bodyEl = document.getElementById('kd-body');
+  const detailEl = document.getElementById('kaban-card-detail');
+  if (!detailEl) return;
+  if (phaseEl) phaseEl.textContent = (card.agent || '') + (card.phase ? ' · ' + card.phase : '');
+  if (titleEl) titleEl.textContent = card.title || card.id;
+  if (bodyEl) {
+    const rows = [];
+    function addRow(label, value) {
+      if (!value) return;
+      rows.push('<div class="kaban-detail-row"><span class="kaban-detail-label">' + safeKabanHtml(label) + '</span><span class="kaban-detail-value">' + safeKabanHtml(value) + '</span></div>');
+    }
+    addRow('Column', KABAN_COL_LABELS[card.column] || card.column);
+    addRow('Status', card.rawStatus);
+    addRow('Owner', card.owner);
+    addRow('Artifact', card.artifact);
+    addRow('Notes', card.notes);
+    addRow('Issue', card.issue);
+    addRow('Last update', card.lastUpdate);
+    addRow('Handoff →', card.handoffNext);
+    if (card.isGate) rows.push('<div style="margin-top:8px"><span class="kaban-badge kaban-badge-gate">GATE CHECKPOINT</span></div>');
+    if (card.attention) rows.push('<div style="margin-top:4px"><span class="kaban-badge kaban-badge-attention">&#9888; Needs attention</span></div>');
+    bodyEl.innerHTML = rows.join('') || '<span style="color:var(--text2)">No additional detail.</span>';
+  }
+  detailEl.style.display = 'flex';
+}
+function closeKabanDetail() {
+  const el = document.getElementById('kaban-card-detail');
+  if (el) el.style.display = 'none';
+}
+function switchKabanTab(tab) {
+  kabanState.activeTab = tab;
+  const ptab = document.getElementById('kaban-tab-pipeline');
+  const qtab = document.getElementById('kaban-tab-quality');
+  const pboard = document.getElementById('kaban-board-pipeline');
+  const qboard = document.getElementById('kaban-board-quality');
+  if (ptab) ptab.classList.toggle('active', tab === 'pipeline');
+  if (qtab) qtab.classList.toggle('active', tab === 'quality');
+  if (pboard) pboard.style.display = tab === 'pipeline' ? '' : 'none';
+  if (qboard) qboard.style.display = tab === 'quality' ? '' : 'none';
+  closeKabanDetail();
+}
+async function fetchKabanData() {
+  try {
+    const resp = await fetch('/api/kaban');
+    if (!resp.ok) throw new Error('HTTP ' + resp.status);
+    const data = await resp.json();
+    kabanState.data = data;
+    kabanState.lastFetch = new Date();
+    renderKaban(data);
+  } catch(e) {
+    const noticeEl = document.getElementById('kaban-notice');
+    if (noticeEl) { noticeEl.textContent = 'Could not load kaban data: ' + e.message; noticeEl.style.display = ''; }
+  }
+}
+function startKabanPoll() {
+  stopKabanPoll();
+  fetchKabanData();
+  kabanState.pollTimer = setInterval(fetchKabanData, KABAN_POLL_MS);
+}
+function stopKabanPoll() {
+  if (kabanState.pollTimer) { clearInterval(kabanState.pollTimer); kabanState.pollTimer = null; }
+}
 
 
 function applySidebarState(collapsed) {
@@ -805,6 +1078,7 @@ function showPanel(name, btn) {
   } else {
     stopGraphAnimation();
   }
+  if (name === 'dash') { startKabanPoll(); } else { stopKabanPoll(); }
 }
 
 let activeFamily = null;
@@ -879,7 +1153,8 @@ const graphState = {
 };
 const wikiAskState = {
   open: false,
-  mode: 'visible-group',
+  mode: 'all-docs',
+  docPathFilter: '',
   selectedDocIds: [],
   status: 'idle',
   answer: null,
@@ -1433,8 +1708,165 @@ function openGraphToolbarPeek(event) {
   toggleGraphToolbarMinimized(false);
 }
 function getWikiAskModeLabel(mode) {
-  return ({ 'current-focus': 'Current Focus', 'visible-group': 'Visible Group', 'selected-docs': 'Selected Docs' }[mode]) || 'Ask SDTK-WIKI';
+  return ({ 'all-docs': 'All Docs', 'current-focus': 'This doc + related', 'visible-group': 'All Docs', 'selected-docs': 'Selected docs' }[mode]) || 'Ask SDTK-WIKI';
+}
+function getWikiAskAllDocIds(pathFilter) {
+  const filter = (pathFilter || '').trim().toLowerCase();
+  return docs.filter(d => {
+    if (!filter) return true;
+    const docPath = (d.sourcePath || d.path || d.id || '').toLowerCase();
+    return docPath.startsWith(filter);
+  }).map(d => d.id);
+}
+function setWikiAskDocPathFilter(value) {
+  wikiAskState.docPathFilter = value || '';
+  renderWikiAsk();
+}
+function getWikiAskFolderList() {
+  var counts = {};
+  for (var i = 0; i < docs.length; i++) {
+    var d = docs[i];
+    var sp = (d.sourcePath || d.path || d.id || '').replace(/\\/g, '/');
+    if (!sp) continue;
+    var parts = sp.split('/');
+    if (parts.length >= 2) {
+      var prefix = parts.slice(0, 2).join('/') + '/';
+      counts[prefix] = (counts[prefix] || 0) + 1;
+    }
+  }
+  return Object.entries(counts)
+    .sort(function(a, b) { return b[1] - a[1] || a[0].localeCompare(b[0]); })
+    .slice(0, 8)
+    .map(function(e) { return { path: e[0], count: e[1] }; });
+}
+function renderWikiAskFolderList() {
+  var list = document.getElementById('ask-folder-list');
+  if (!list) return;
+  var folders = getWikiAskFolderList();
+  if (!folders.length) {
+    list.innerHTML = '<div style="padding:8px 10px;font-size:12px;color:#6d7d95">No folders found.</div>';
+    return;
+  }
+  list.innerHTML = folders.map(function(f) {
+    var active = wikiAskState.docPathFilter === f.path ? ' active' : '';
+    return '<div class="ask-folder-item' + active + '" data-path="' + escapeHtml(f.path) + '" onclick="pickWikiAskFolder(' + JSON.stringify(f.path) + ')"><span class="f-path">' + escapeHtml(f.path) + '</span><span class="f-count">' + f.count + '</span></div>';
+  }).join('');
 }
+function toggleWikiAskScopeMenu(event) {
+  if (event) event.stopPropagation();
+  var wrap = document.getElementById('ask-scope-wrap');
+  if (!wrap) return;
+  var isOpen = wrap.classList.contains('open');
+  if (!isOpen) {
+    renderWikiAskFolderList();
+    syncWikiAskScopeMenu();
+  }
+  wrap.classList.toggle('open', !isOpen);
+  var btn = document.getElementById('ask-scope-btn');
+  if (btn) btn.setAttribute('aria-expanded', String(!isOpen));
+}
+function closeWikiAskScopeMenu() {
+  var wrap = document.getElementById('ask-scope-wrap');
+  if (wrap) {
+    wrap.classList.remove('open');
+    var btn = document.getElementById('ask-scope-btn');
+    if (btn) btn.setAttribute('aria-expanded', 'false');
+  }
+}
+function syncWikiAskScopeMenu() {
+  var menu = document.getElementById('ask-scope-menu');
+  if (!menu) return;
+  menu.querySelectorAll('.ask-scope-opt').forEach(function(opt) { opt.classList.remove('active'); });
+  var scope = wikiAskState.mode === 'current-focus' ? 'focus'
+    : wikiAskState.mode === 'selected-docs' ? 'selected'
+    : wikiAskState.docPathFilter ? 'folder'
+    : 'all';
+  var target = menu.querySelector('[data-scope="' + scope + '"]');
+  if (target) target.classList.add('active');
+  var focusOpt = document.getElementById('ask-scope-opt-focus');
+  var focusId = typeof getGraphFocusId !== 'undefined' ? getGraphFocusId() : null;
+  if (focusOpt) {
+    if (focusId) { focusOpt.classList.remove('disabled'); focusOpt.removeAttribute('aria-disabled'); }
+    else { focusOpt.classList.add('disabled'); focusOpt.setAttribute('aria-disabled', 'true'); }
+  }
+  var selectedOpt = document.getElementById('ask-scope-opt-selected');
+  if (selectedOpt) {
+    var selLabel = document.getElementById('ask-scope-selected-label');
+    if (wikiAskState.selectedDocIds.length > 0) {
+      selectedOpt.style.display = '';
+      if (selLabel) selLabel.textContent = 'Selected docs (' + wikiAskState.selectedDocIds.length + ')';
+    } else { selectedOpt.style.display = 'none'; }
+  }
+  if (scope === 'folder') {
+    var folderBlock = document.getElementById('ask-folder-block');
+    if (folderBlock) folderBlock.classList.add('open');
+    document.querySelectorAll('#ask-folder-list .ask-folder-item').forEach(function(item) {
+      item.classList.toggle('active', item.dataset.path === wikiAskState.docPathFilter);
+    });
+  }
+}
+function pickWikiAskScope(scope) {
+  if (scope === 'focus') {
+    var focusId = typeof getGraphFocusId !== 'undefined' ? getGraphFocusId() : null;
+    if (!focusId) return;
+    wikiAskState.mode = 'current-focus';
+    wikiAskState.docPathFilter = '';
+  } else if (scope === 'selected') {
+    wikiAskState.mode = 'selected-docs';
+    wikiAskState.docPathFilter = '';
+  } else {
+    wikiAskState.mode = 'all-docs';
+    wikiAskState.docPathFilter = '';
+  }
+  closeWikiAskScopeMenu();
+  renderWikiAsk();
+}
+function toggleWikiAskFolderBlock(event) {
+  if (event) event.stopPropagation();
+  var block = document.getElementById('ask-folder-block');
+  if (!block) return;
+  var isOpen = block.classList.contains('open');
+  block.classList.toggle('open', !isOpen);
+  if (!isOpen) { var filter = document.getElementById('ask-folder-filter'); if (filter) filter.focus(); }
+}
+function pickWikiAskFolder(path) {
+  wikiAskState.mode = 'all-docs';
+  wikiAskState.docPathFilter = path;
+  document.querySelectorAll('#ask-folder-list .ask-folder-item').forEach(function(item) {
+    item.classList.toggle('active', item.dataset.path === path);
+  });
+  closeWikiAskScopeMenu();
+  renderWikiAsk();
+}
+function filterWikiAskFolders(q) {
+  var query = (q || '').trim().toLowerCase();
+  document.querySelectorAll('#ask-folder-list .ask-folder-item').forEach(function(item) {
+    var p = item.dataset.path.toLowerCase();
+    item.style.display = (!query || p.indexOf(query) !== -1) ? '' : 'none';
+  });
+}
+function renderWikiAskSourcesPanel(context) {
+  if (!context) return '';
+  var sourcePaths = Array.isArray(context.source_paths) ? context.source_paths : [];
+  var relationMap = context.truncated && typeof context.truncated === 'object' && context.truncated.relation ? context.truncated.relation : {};
+  var total = sourcePaths.length;
+  if (!total) return '';
+  var rows = sourcePaths.map(function(p) {
+    var rel = relationMap[p];
+    var chipHtml;
+    if (!rel || rel === 'primary') {
+      chipHtml = '<span class="s-chip primary">primary</span>';
+    } else {
+      var facetsRaw = rel.replace(/^shares\s+/, '');
+      var bkMatch = facetsRaw.match(/issue:([^,\s]+)/);
+      var relLabel = bkMatch ? 'related \u00b7 ' + bkMatch[1] : 'related';
+      chipHtml = '<span class="s-chip related">' + escapeHtml(relLabel) + '</span>';
+    }
+    return '<div class="ask-source-row"><span class="s-path">' + escapeHtml(p) + '</span>' + chipHtml + '</div>';
+  }).join('');
+  return '<div class="ask-sources"><button class="ask-sources-head" onclick="this.parentElement.classList.toggle(\'open\')" title="Toggle sources used panel"><span class="ask-sources-caret">&#9658;</span><span>Sources used</span><span class="ask-sources-badge">' + total + '</span></button><div class="ask-sources-body">' + rows + '</div></div>';
+}
+
 function getWikiAskVisibleDocIds() {
   return getVisibleDocs().map(doc => doc.id);
 }
@@ -1569,7 +2001,8 @@ function loadWikiAskHistoryItem(id) {
   wikiAskState.question = '';
   wikiAskState.pendingQuestion = '';
   wikiAskState.lastQuestion = item.question || '';
-  wikiAskState.mode = item.mode || 'visible-group';
+  wikiAskState.mode = (item.mode === 'visible-group' ? 'all-docs' : (item.mode || 'all-docs'));
+  wikiAskState.docPathFilter = item.doc_path_filter || '';
   wikiAskState.selectedDocIds = Array.isArray(item.selected_doc_ids) ? [...item.selected_doc_ids] : [];
   wikiAskState.answer = {
     question: item.question || '',
@@ -1696,20 +2129,23 @@ function clearWikiAskSources() {
   renderWikiAsk();
 }
 function getWikiAskSourceSummaryHtml() {
-  const visibleCount = getWikiAskVisibleDocIds().length;
   const selectedCount = wikiAskState.selectedDocIds.length;
   const focusId = getGraphFocusId();
-  const focusLabel = focusId ? ((docById[focusId] && (docById[focusId].title || focusId)) || focusId) : 'None';
+  const focusLabel = focusId ? ((docById[focusId] && (docById[focusId].title || focusId)) || focusId) : null;
+  if (wikiAskState.mode === 'all-docs') {
+    const filteredIds = getWikiAskAllDocIds(wikiAskState.docPathFilter);
+    if (wikiAskState.docPathFilter) {
+      return `<strong>Scope:</strong> By folder <code>${escapeHtml(wikiAskState.docPathFilter)}</code> — ${filteredIds.length} of ${docs.length} docs.`;
+    }
+    return `<strong>Scope:</strong> All Docs — ${filteredIds.length} docs indexed.`;
+  }
   if (wikiAskState.mode === 'current-focus') {
     if (focusId) {
-      return `<strong>Grounding:</strong> Current focus source. <strong>Focus:</strong> ${escapeHtml(focusLabel)}. <strong>Visible group:</strong> ${visibleCount} docs.`;
+      return `<strong>Scope:</strong> This doc + related — <strong>${escapeHtml(focusLabel)}</strong> and its related siblings.`;
     }
-    return `<strong>Grounding:</strong> Current focus source. Select a graph note to anchor this ask. <strong>Visible group:</strong> ${visibleCount} docs.`;
-  }
-  if (wikiAskState.mode === 'visible-group') {
-    return `<strong>Grounding:</strong> Visible graph group. <strong>Visible docs:</strong> ${visibleCount}.${selectedCount ? ` <strong>Explicit docs:</strong> ${selectedCount}.` : ''}`;
+    return `<strong>Scope:</strong> This doc + related — <em>focus a graph node first.</em>`;
   }
-  return `<strong>Grounding:</strong> Explicit source pack. <strong>Selected docs:</strong> ${selectedCount}.${selectedCount ? '' : ' Use graph search results or @mention docs before asking.'}`;
+  return `<strong>Scope:</strong> Selected docs — ${selectedCount} doc${selectedCount !== 1 ? 's' : ''} attached.${selectedCount ? '' : ' Attach docs via @mention or graph search.'}`;
 }
 function getWikiAskAdvancedSummaryText() {
   const bits = [];
@@ -1837,7 +2273,6 @@ function renderWikiAsk() {
   );
   const runtimeSelect = document.getElementById('atlas-ask-runtime-select');
   const modelSelect = document.getElementById('atlas-ask-model-select');
-  const modeSelect = document.getElementById('atlas-ask-mode-select');
   const input = document.getElementById('atlas-ask-input');
   const attachments = document.getElementById('atlas-ask-attachments');
   const sourceSummary = document.getElementById('atlas-ask-source-summary');
@@ -1857,7 +2292,24 @@ function renderWikiAsk() {
     modelSelect.innerHTML = modelOptions.map(model => `<option value="${model}">${escapeHtml(getWikiAskModelLabel(model))}</option>`).join('');
     if (modelSelect.value !== wikiAskState.model) modelSelect.value = wikiAskState.model;
   }
-  if (modeSelect && modeSelect.value !== wikiAskState.mode) modeSelect.value = wikiAskState.mode;
+  const scopeIco = document.getElementById('ask-scope-ico');
+  const scopeLbl = document.getElementById('ask-scope-label');
+  if (scopeIco && scopeLbl) {
+    if (wikiAskState.mode === 'current-focus') {
+      scopeIco.textContent = '\u{1F3AF}';
+      scopeLbl.textContent = 'This doc + related';
+    } else if (wikiAskState.mode === 'selected-docs') {
+      scopeIco.textContent = '\u2713';
+      const selCnt = wikiAskState.selectedDocIds.length;
+      scopeLbl.textContent = selCnt > 0 ? `Selected docs (${selCnt})` : 'Selected docs';
+    } else if (wikiAskState.docPathFilter) {
+      scopeIco.textContent = '\u{1F4C1}';
+      scopeLbl.textContent = wikiAskState.docPathFilter;
+    } else {
+      scopeIco.textContent = '\u{1F4DA}';
+      scopeLbl.textContent = 'All Docs';
+    }
+  }
   if (sourceSummary) sourceSummary.innerHTML = getWikiAskSourceSummaryHtml();
   if (mentionResults) renderWikiAskMentions();
   if (attachments) {
@@ -1903,7 +2355,8 @@ function renderWikiAsk() {
       ? `<ul>${turn.citations.map(item => `<li><button class="wiki-link" onclick="focusGraphNode('${item.path}')">${escapeHtml(item.title || item.path)}</button> &middot; ${escapeHtml(item.reason || 'Grounded source')}</li>`).join('')}</ul>`
       : '<p class="muted">No citations were returned.</p>';
     blocks.push(`<div class="atlas-ask-message user"><div class="atlas-ask-message-label">You</div><div class="atlas-ask-message-bubble">${escapeHtml(turn.question || '')}</div></div>`);
-    blocks.push(`<div class="atlas-ask-message assistant"><div class="atlas-ask-message-label">SDTK-WIKI Ask</div><div class="atlas-ask-answer-card"><div class="graph-note-prose">${renderMarkdownFragment(turn.answer_markdown || '')}</div>${turn.disclaimer ? `<span class="muted">${escapeHtml(turn.disclaimer)}</span>` : ''}</div><div class="atlas-ask-answer-card"><h3>Citations</h3>${citationHtml}</div></div>`);
+    const sourcesHtml = renderWikiAskSourcesPanel(turn.context || null);
+    blocks.push(`<div class="atlas-ask-message assistant"><div class="atlas-ask-message-label">SDTK-WIKI Ask</div><div class="atlas-ask-answer-card"><div class="graph-note-prose">${renderMarkdownFragment(turn.answer_markdown || '')}</div>${turn.disclaimer ? `<span class="muted">${escapeHtml(turn.disclaimer)}</span>` : ''}</div><div class="atlas-ask-answer-card"><h3>Citations</h3>${citationHtml}</div>${sourcesHtml}</div>`);
   });
 
   if (wikiAskState.pendingQuestion) {
@@ -1912,7 +2365,7 @@ function renderWikiAsk() {
   }
 
   if (!blocks.length) {
-    answer.innerHTML = '<div class="atlas-ask-empty">Ask SDTK-WIKI from the visible graph group by default, or narrow the source pack with a selected node or attached docs.</div>';
+    answer.innerHTML = '<div class="atlas-ask-empty">Use <strong>Ask within</strong> to choose your scope: All Docs for full coverage, By folder to narrow by path, This doc + related to focus on the current graph node, or Selected docs for pinned sources.</div>';
     return;
   }
 
@@ -1930,14 +2383,18 @@ async function submitWikiAsk() {
     renderWikiAsk();
     return;
   }
+  const allDocIds = wikiAskState.mode === 'all-docs'
+    ? getWikiAskAllDocIds(wikiAskState.docPathFilter)
+    : getWikiAskVisibleDocIds();
   const payload = {
     question: draftQuestion,
     mode: wikiAskState.mode,
     runtime_agent: wikiAskState.runtimeAgent,
     model: wikiAskState.model,
     focus_doc_id: getGraphFocusId() || '',
-    visible_doc_ids: getWikiAskVisibleDocIds(),
+    visible_doc_ids: allDocIds,
     selected_doc_ids: [...wikiAskState.selectedDocIds],
+    doc_path_filter: wikiAskState.mode === 'all-docs' ? (wikiAskState.docPathFilter || '') : '',
   };
   wikiAskState.pendingQuestion = draftQuestion;
   wikiAskState.question = '';
@@ -2416,6 +2873,10 @@ document.addEventListener('mousedown', event => {
     graphState.settingsOpen = false;
     syncGraphSettings();
   }
+  const scopeWrap = document.getElementById('ask-scope-wrap');
+  if (scopeWrap && scopeWrap.classList.contains('open') && !scopeWrap.contains(event.target)) {
+    closeWikiAskScopeMenu();
+  }
 });
 window.addEventListener('mousemove', dragWikiAsk);
 window.addEventListener('mouseup', stopWikiAskDrag);