dsh-notes-board 0.0.0-stage → 0.1.1

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# dsh-notes-board bundle patch：只插入一条 loader entry。
+# name 必须是实际包名 —— cordis 按 name 解析包；客户端 bundle 也按包名取，
+# 所以 package.json 的 name、这里的 name、client.js 里 __ModuleLoader__ 的 id 三者必须一致。
+- insert:
+    - id: dsh-notes-board
+      name: dsh-notes-board

package/icon.svg

@@ -0,0 +1,16 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="Notes Board">
+  <defs>
+    <linearGradient id="nb-cover" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#3b82f6"/>
+      <stop offset="1" stop-color="#1e3a8a"/>
+    </linearGradient>
+  </defs>
+  <rect x="6" y="6" width="52" height="52" rx="13" fill="url(#nb-cover)"/>
+  <path d="M22 16h14.5L45 24.5V48H22z" fill="#f8fafc" opacity="0.96"/>
+  <path d="M36 16v9h9" fill="none" stroke="#93c5fd" stroke-width="2.4" stroke-linejoin="round"/>
+  <g stroke="#1e40af" stroke-width="2.6" stroke-linecap="round">
+    <path d="M27.5 28h12"/>
+    <path d="M27.5 33.5h12"/>
+    <path d="M27.5 39h7.5"/>
+  </g>
+</svg>

package/index.js

@@ -0,0 +1,185 @@
+/**
+ * dsh-notes-board · Host 半边
+ *
+ * 只做两件事，都是只读：
+ *   1. 把 workspace registry 里登记的工作区列成 JSON（面板顶部的下拉框用它）；
+ *   2. 读某个工作区 <dir>/.agents/notes 下的 Markdown 原文，按相对路径回给客户端。
+ *
+ * 解析、分类、引用入度、四个视图，全部交给原版看板的前端逻辑
+ * （vendor/board.html 里的 parseNote / ingestDataset），Host 不重复实现一遍。
+ */
+
+import { existsSync } from 'node:fs'
+import { readdir, readFile, stat } from 'node:fs/promises'
+import { basename, join, sep } from 'node:path'
+import { gzipSync } from 'node:zlib'
+
+export const inject = ['webServer']
+
+const BASE = '/api/dsh-notes-board'
+/* 安全阀，不是业务上限：只防挂错目录（比如挂到家目录）时把进程拖死。
+   真触发时响应里带 truncated:true，面板会明确提示，绝不静默截断。 */
+const SAFETY_MAX_FILES = 50000
+const MAX_BODY = 400 * 1024
+
+function sendJson(req, res, code, payload) {
+  const raw = Buffer.from(JSON.stringify(payload), 'utf8')
+  const accepts = String((req && req.headers && req.headers['accept-encoding']) || '')
+  if (raw.length > 64 * 1024 && /\bgzip\b/.test(accepts)) {
+    const body = gzipSync(raw)
+    res.writeHead(code, {
+      'content-type': 'application/json; charset=utf-8',
+      'content-encoding': 'gzip',
+      'content-length': body.length,
+      'cache-control': 'no-store',
+    })
+    res.end(body)
+    return
+  }
+  res.writeHead(code, {
+    'content-type': 'application/json; charset=utf-8',
+    'content-length': raw.length,
+    'cache-control': 'no-store',
+  })
+  res.end(raw)
+}
+
+function fail(req, res, code, message) {
+  sendJson(req, res, code, { ok: false, message })
+}
+
+function listWorkspaces(ctx) {
+  const registry = ctx.get('workspaceRegistry')
+  if (!registry || typeof registry.list !== 'function') return []
+  const seen = new Set()
+  const out = []
+  for (const workspace of registry.list()) {
+    const path = typeof workspace?.path === 'string' ? workspace.path : ''
+    if (!path || seen.has(path)) continue
+    seen.add(path)
+    out.push({
+      id: String(workspace.id ?? path),
+      title: String(workspace.title || basename(path) || path),
+      path,
+      hasNotes: existsSync(join(path, '.agents', 'notes')),
+    })
+  }
+  return out
+}
+
+function resolveWorkspace(ctx, idOrPath) {
+  const wanted = String(idOrPath || '')
+  if (!wanted) return undefined
+  const all = listWorkspaces(ctx)
+  return (
+    all.find((w) => w.id === wanted) ||
+    all.find((w) => w.path === wanted) ||
+    all.find((w) => w.title === wanted)
+  )
+}
+
+/** 广度优先收集 .agents/notes 下的 Markdown，跳过点开头目录 */
+async function walkNotes(root) {
+  const found = []
+  const queue = [{ dir: root, depth: 0 }]
+  let truncated = false
+  while (queue.length) {
+    const current = queue.shift()
+    let entries
+    try {
+      entries = await readdir(current.dir, { withFileTypes: true })
+    } catch {
+      continue
+    }
+    for (const entry of entries) {
+      if (entry.name.startsWith('.')) continue
+      const abs = join(current.dir, entry.name)
+      if (entry.isDirectory()) {
+        if (current.depth < 5) queue.push({ dir: abs, depth: current.depth + 1 })
+        continue
+      }
+      if (!entry.isFile() || !/\.md$/i.test(entry.name)) continue
+      if (found.length >= SAFETY_MAX_FILES) {
+        truncated = true
+        break
+      }
+      found.push(abs)
+    }
+    if (truncated) break
+  }
+  return { paths: found, truncated }
+}
+
+async function readNotes(workspace) {
+  const root = join(workspace.path, '.agents', 'notes')
+  if (!existsSync(root)) return { root, exists: false, files: [], truncated: false }
+  const { paths: absPaths, truncated } = await walkNotes(root)
+  // 中英对照的 x.md / x.zh.md 只回一份，按原版看板的规则「zh 优先」
+  const byCleanPath = new Map()
+  for (const abs of absPaths) {
+    const rel = abs.slice(root.length + 1).split(sep).join('/')
+    const isZh = /\.zh\.md$/i.test(rel)
+    const clean = isZh ? rel.replace(/\.zh\.md$/i, '.md') : rel
+    const current = byCleanPath.get(clean)
+    if (!current || isZh) byCleanPath.set(clean, { abs, rel, isZh })
+  }
+  const files = []
+  for (const [cleanRel, entry] of byCleanPath) {
+    try {
+      const info = await stat(entry.abs)
+      const text = await readFile(entry.abs, 'utf8')
+      files.push({
+        path: cleanRel,
+        raw: text.length > MAX_BODY ? text.slice(0, MAX_BODY) : text,
+        mtime: Math.round(info.mtimeMs / 1000),
+      })
+    } catch {
+      /* 单个文件读失败不影响整体 */
+    }
+  }
+  files.sort((a, b) => a.path.localeCompare(b.path))
+  return { root, exists: true, files, truncated }
+}
+
+export function apply(ctx) {
+  ctx.effect(() =>
+    ctx.webServer.register({
+      kind: 'exact',
+      path: `${BASE}/workspaces`,
+      handler(req, res) {
+        try {
+          sendJson(req, res, 200, { ok: true, workspaces: listWorkspaces(ctx) })
+        } catch (error) {
+          fail(req, res, 500, error instanceof Error ? error.message : String(error))
+        }
+      },
+    }),
+  )
+
+  ctx.effect(() =>
+    ctx.webServer.register({
+      kind: 'exact',
+      path: `${BASE}/scan`,
+      async handler(req, res) {
+        const url = new URL(req.url || '/', 'http://localhost')
+        const workspace = resolveWorkspace(ctx, url.searchParams.get('workspace') || '')
+        if (!workspace) return fail(req, res, 404, '未登记的工作区')
+        try {
+          const { root, exists, files, truncated } = await readNotes(workspace)
+          sendJson(req, res, 200, {
+            ok: true,
+            workspace,
+            root,
+            exists,
+            files,
+            truncated: !!truncated,
+            safetyLimit: SAFETY_MAX_FILES,
+            scannedAt: Date.now(),
+          })
+        } catch (error) {
+          fail(req, res, 500, error instanceof Error ? error.message : String(error))
+        }
+      },
+    }),
+  )
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Notes Board",
+    "description": "Adds a Notes Board panel to the sidebar: pick a workspace and read its .agents/notes decision records through the original agent-notes-board UI — architecture baseline (in-degree pillars), evolution timeline, pitfalls, and decision list, plus the five-section detail drawer. The Host only supplies read-only note text."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "笔记看板",
+    "description": "在左侧栏加一个「笔记看板」面板：切换工作区后，直接渲染该工作区 .agents/notes 的工程决策笔记——架构基线（引用入度承重墙）、演进时间线、避坑智库、决策清单四个板块，附带抽屉五节详情。界面即原版 agent-notes-board，数据改由宿主只读注入。"
+  }
+}

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "dsh-notes-board",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "type": "module",
+  "description": "笔记看板：把各个工作区 .agents/notes 的工程决策笔记渲染成 DeepSeek Harness 原生面板，四板块 + 抽屉五节，支持切换工作区。",
+  "license": "MIT",
+  "author": "scccy",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "agent-notes",
+    "notes",
+    "decision-log"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/scccy/dsh-notes-board.git"
+  },
+  "homepage": "https://github.com/scccy/dsh-notes-board#readme",
+  "bugs": {
+    "url": "https://github.com/scccy/dsh-notes-board/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "src/**",
+    "scripts/**",
+    "vendor/**",
+    "README.md",
+    "LICENSE",
+    "NOTICE.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "build": "node scripts/build-client.mjs",
+    "test": "node scripts/test-board.mjs"
+  }
 }

package/scripts/build-client.mjs

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+/**
+ * 把原版看板模板（vendor/board.html）改造成能挂在 Harness 面板里的形态，
+ * 与 src/panel.js 拼成 client.js。
+ *
+ * 设计原则：原版逻辑一行都不重写，只做「作用域改写 + 宿主接管数据源」两类机械补丁。
+ * 上游更新时：替换 vendor/board.html → 重跑本脚本；补丁数量断言会立刻告诉你哪里变了。
+ */
+
+import { readFileSync, writeFileSync } from 'node:fs'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const src = readFileSync(resolve(ROOT, 'vendor/board.html'), 'utf8')
+const shell = readFileSync(resolve(ROOT, 'src/panel.js'), 'utf8')
+
+function must(condition, message) {
+  if (!condition) throw new Error('build failed: ' + message)
+}
+
+function replaceCounted(text, from, to, expected, label) {
+  const count = text.split(from).length - 1
+  must(count === expected, `${label}: 期望 ${expected} 处 "${from}"，实际 ${count} 处（上游可能已变）`)
+  return text.split(from).join(to)
+}
+
+/* ── 1. 切出 CSS / 正文 / 脚本 / 字体 ─────────────────────── */
+
+const cssMatch = /<style[^>]*>([\s\S]*?)<\/style>/.exec(src)
+must(cssMatch, '找不到 <style> 块')
+let css = cssMatch[1]
+
+const bodyStart = src.indexOf('<body>')
+const bodyEnd = src.indexOf('<script')
+must(bodyStart >= 0 && bodyEnd > bodyStart, '找不到 <body> … <script> 之间的正文')
+const bodyHtml = src.slice(bodyStart + '<body>'.length, bodyEnd).trim()
+
+const scripts = [...src.matchAll(/<script[^>]*>([\s\S]*?)<\/script>/g)].map((m) => m[1])
+const script = scripts.find((s) => s.length > 5000)
+must(script, '找不到看板主脚本')
+
+const fontMatch = /<link href="https:\/\/fonts\.googleapis\.com[^>]*>/.exec(src)
+const font = fontMatch ? fontMatch[0] : ''
+
+/* ── 2. CSS：:root → :host，抽屉定位从 fixed 收到面板内 ───── */
+
+must((css.match(/:root\s*\{/g) || []).length === 1, 'CSS 里 :root 应该只有一处')
+css = css.replace(
+  /:root\s*\{/,
+  ':host{position:relative;display:block;height:100%;overflow:hidden;',
+)
+css = replaceCounted(css, 'position: fixed', 'position: absolute', 2, 'CSS 抽屉定位')
+css +=
+  '\n/* ── 宿主注入 ──────────────────────────────────────────── */\n' +
+  '/* 原版靠浏览器默认白底，面板里没有 body，这里补上 */\n' +
+  '.nbx-stage{height:100%;overflow:auto;background:var(--bg-base);color:var(--text-primary);}\n' +
+  '/* 原版顶栏按整页宽度设计，窄面板里会被压成竖排：改成可换行 + 子项不压缩 */\n' +
+  'header.hud-topbar{flex-wrap:wrap;height:auto;min-height:56px;padding:8px 16px;gap:12px;row-gap:8px;}\n' +
+  'header.hud-topbar>*{flex-shrink:0;}\n' +
+  '.brand-text,nav.deck-tabs,.deck-tab,.sync-beacon,.telemetry-chip{white-space:nowrap;}\n' +
+  '.hud-grow{flex:1 1 auto;min-width:0;}\n' +
+  '.hud-search{width:220px;flex:0 0 auto;}\n' +
+  '/* 原版聚焦时把输入框撑到 320px，溢出 260px 容器、盖住右侧同步状态 */\n' +
+  '.hud-search input:focus{width:100%;}\n' +
+  '.onboarding-deck{display:none !important;}\n'
+
+/* ── 3. JS：作用域改写 ───────────────────────────────────── */
+
+// 先摘掉「自动读取浏览器授权目录」那段启动逻辑，数据改由宿主注入。
+const bootStart = script.indexOf('if (window.__INLINE_DATA__')
+const bootEnd = script.indexOf("window.addEventListener('focus'")
+must(bootStart > 0 && bootEnd > bootStart, '找不到原版启动数据块')
+let code =
+  script.slice(0, bootStart) +
+  '// 数据由宿主注入：React 侧拿到 .agents/notes 原文后调用 ingestFiles()\n  ' +
+  script.slice(bootEnd)
+
+code = replaceCounted(code, 'document.getElementById(', 'byId(', 51, 'getElementById 作用域改写')
+code = replaceCounted(code, 'document.querySelectorAll(', 'root.querySelectorAll(', 3, 'querySelectorAll 作用域改写')
+code = replaceCounted(code, 'document.querySelector(', 'root.querySelector(', 1, 'querySelector 作用域改写')
+code = replaceCounted(code, 'window.addEventListener(', 'onWin(', 3, 'window 事件接管')
+code = replaceCounted(code, 'document.addEventListener(', 'onRoot(', 2, 'document 事件接管')
+code = replaceCounted(
+  code,
+  "onRoot('DOMContentLoaded', startMission);",
+  '/* 启动由宿主 mountBoard() 调用 startMission() */',
+  1,
+  '移除 DOMContentLoaded 自启动',
+)
+code = replaceCounted(code, 'location.hash', 'panelRoute.hash', 5, 'hash 路由收进面板')
+code = replaceCounted(code, 'history.replaceState', 'panelRoute.replaceState', 3, 'history 收进面板')
+
+// 懒渲染：原版一次把四个视图全渲染出来，1300 篇时时间线单次产出近 1MB HTML。
+// 改成只渲染当前 tab，切 tab 时再按需渲染 —— 首屏从四份降到一份。
+code = replaceCounted(
+  code,
+  `function renderInterface() {
+  renderBaseline();
+  renderTimeline();
+  renderAlternatives();
+  renderDirectory();
+}`,
+  `function renderView(view) {
+  if (view === 'timeline') renderTimeline();
+  else if (view === 'alternatives') renderAlternatives();
+  else if (view === 'directory') renderDirectory();
+  else renderBaseline();
+}
+
+function renderInterface() {
+  renderView(Core.activeTab);
+}`,
+  1,
+  '视图懒渲染',
+)
+code = replaceCounted(
+  code,
+  '  Core.activeTab = viewId;',
+  '  Core.activeTab = viewId;\n  renderView(viewId);',
+  1,
+  '切换 tab 时补渲染',
+)
+
+// KPI 卡片：原版是内联 onclick="routeToListFilter(...)"。内联处理器在「全局作用域」求值，
+// 而改造后所有原版函数都收进了 factory 闭包 → 每点一次必抛 ReferenceError: routeToListFilter is not defined。
+// 机械补丁：标记换成 data-kpi-filter，点击交给下面那段已有的 root 委托监听。
+code = replaceCounted(
+  code,
+  '<div class="kpi-instrument" onclick="routeToListFilter(\'${escapeHtml(k.filter)}\')">',
+  '<div class="kpi-instrument" data-kpi-filter="${escapeHtml(k.filter)}">',
+  1,
+  'KPI 卡片内联 onclick → data-kpi-filter',
+)
+code = replaceCounted(
+  code,
+  `onRoot('click', e => {
+    const nodeTrigger = e.target.closest('[data-node-id]');`,
+  `onRoot('click', e => {
+    const kpiTrigger = e.target.closest('[data-kpi-filter]');
+    if (kpiTrigger) {
+      const kpiFilter = kpiTrigger.getAttribute('data-kpi-filter');
+      if (kpiFilter) routeToListFilter(kpiFilter);
+      return;
+    }
+    const nodeTrigger = e.target.closest('[data-node-id]');`,
+  1,
+  'KPI 卡片点击委托',
+)
+
+// 兜底断言：内联事件处理器在全局作用域求值，而本文件所有函数都在 factory 闭包里，
+// 只要再出现一个就跟 routeToListFilter 一样必抛。上游新增一定要在这里被拦住。
+must(
+  !/\son(?:click|change|input|keydown|keyup|keypress|submit|load|focus|blur|mouseover|mouseout)\s*=/.test(code),
+  '注入脚本里仍有内联事件处理器，改造成模块闭包后会抛 ReferenceError，请用 data-属性 + 事件委托替代',
+)
+
+/* ── 4. 拼装 client.js ───────────────────────────────────── */
+
+let out = shell
+for (const [token, value] of [
+  ['/*__BOARD_CSS__*/ \'\'', `/*__BOARD_CSS__*/ ${JSON.stringify(css)}`],
+  ['/*__BOARD_HTML__*/ \'\'', `/*__BOARD_HTML__*/ ${JSON.stringify(bodyHtml)}`],
+  ['/*__BOARD_FONT__*/ \'\'', `/*__BOARD_FONT__*/ ${JSON.stringify(font)}`],
+  ['/*__BOARD_SCRIPT__*/', code],
+]) {
+  must(out.includes(token), `src/panel.js 缺少占位符 ${token.slice(0, 24)}…`)
+  out = out.replace(token, () => value)
+}
+
+writeFileSync(resolve(ROOT, 'client.js'), out, 'utf8')
+console.log(
+  `ok: client.js ${(out.length / 1024).toFixed(1)}KB（css ${(css.length / 1024).toFixed(1)}KB / ` +
+    `html ${(bodyHtml.length / 1024).toFixed(1)}KB / js ${(code.length / 1024).toFixed(1)}KB）`,
+)

package/scripts/test-board.mjs

@@ -0,0 +1,188 @@
+import { readFileSync } from 'node:fs'
+import vm from 'node:vm'
+
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+const SRC = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'client.js')
+
+const cache = new Map()
+function makeEl(id) {
+  return {
+    id, style: {}, dataset: {}, children: [], innerHTML: '', textContent: '', value: '', className: '',
+    classList: { add() {}, remove() {}, toggle() {}, contains() { return false } },
+    appendChild() {}, removeChild() {}, append() {},
+    addEventListener() {}, removeEventListener() {},
+    querySelector(sel) { return bySel(sel) }, querySelectorAll() { return [] },
+    getAttribute() { return null }, setAttribute() {}, closest() { return null },
+    focus() {}, scrollIntoView() {}, insertAdjacentHTML() {}, remove() {},
+  }
+}
+const byId = (id) => { if (!cache.has(id)) cache.set(id, makeEl(id)); return cache.get(id) }
+const bySel = (sel) => { const k = 'sel:' + sel; if (!cache.has(k)) cache.set(k, makeEl(k)); return cache.get(k) }
+
+const listeners = []
+const shadow = {
+  getElementById: byId,
+  querySelector: bySel,
+  querySelectorAll: () => [],
+  addEventListener: (t, fn) => listeners.push([t, fn]),
+  removeEventListener: () => {},
+}
+
+const sandbox = {
+  window: { __ModuleLoader__: { load(d) { sandbox.__def = d } }, addEventListener() {}, removeEventListener() {}, setInterval: () => 0, clearInterval() {} },
+  console, setTimeout, clearTimeout,
+  setInterval: () => 0, clearInterval() {},
+  location: { hash: '' }, history: { replaceState() {} },
+  document: { activeElement: null, hasFocus: () => true, addEventListener() {}, createElement: () => makeEl('tmp') },
+  alert: (m) => console.log('[alert]', m),
+}
+sandbox.globalThis = sandbox
+vm.createContext(sandbox)
+vm.runInContext(readFileSync(SRC, 'utf8'), sandbox, { filename: SRC })
+
+const ReactStub = { createElement: () => null, useState: () => [null, () => {}], useEffect: () => {}, useRef: () => ({ current: null }), useCallback: (f) => f }
+const plugin = sandbox.__def.factory((name) => { if (name === 'react') return ReactStub; throw new Error('unexpected require ' + name) })
+plugin.apply({ slots: { inject(_n, fn) { fn() }, register() { return () => {} } } })
+
+const A = `# Agent Note: 能力 seam 三权分立
+
+Status: implemented
+
+## Problem
+
+各项能力关注点以不同速率变化，换沙箱实现时工具 Schema 频发破坏性变更。
+
+## Decision
+
+拆成 Service Definition / Provider / Consumer 三者独立演进。
+
+## Alternatives considered
+
+### 始终合并各角色
+否决，重新耦合了独立变化的关注点。
+
+## Consequences
+
+包数量增加；换来后端替换零破坏。
+`
+const B = `# Agent Note: 工具输出规范化
+
+Status: implemented
+
+## Problem
+
+工具直接产出模型可读文本，编程式调用拿不到强类型对象。
+
+## Decision
+
+每个工具声明 Canonical Output，执行期给强类型 DTO。
+
+## Alternatives considered
+
+### 双轨返回值
+否决，双重契约增加心智负担。
+
+## Consequences
+
+PTC 模式无需反解析字符串。参见 [能力 seam](../architecture/2026-10-01-a.md)。
+`
+const C = `# Agent Note: 笔记看板接入 GUI
+
+Status: proposed
+
+## Problem
+
+笔记只能翻目录看。
+
+## Proposal
+
+左侧栏加一个原生面板。
+
+## Alternatives considered
+
+无
+
+## Acceptance criteria
+
+能在面板里切换工作区。
+
+## Risks
+
+只读路由的权限边界。
+`
+const D = `# Agent Note: 用 iframe 复用原版看板
+
+Status: rejected
+
+## Problem
+
+想直接嵌原版 HTML。
+
+## Proposal
+
+Host 提供 HTML，面板 iframe 引用。
+
+## Alternatives considered
+
+### 内联移植
+否决，工作量大。
+
+## Risks
+
+拿不到宿主主题与 locale。
+`
+
+const files = [
+  { path: 'implemented/architecture/2026-10-01-a.md', raw: A },
+  { path: 'implemented/feature/2026-10-15-b.md', raw: B },
+  { path: 'proposed/process/2026-11-01-c.md', raw: C },
+  { path: 'rejected/bug-fix/2026-11-02-d.md', raw: D },
+]
+
+const board = plugin.mountBoard(shadow, {})
+const count = board.ingest(files)
+console.log('ingest 数量:', count)
+console.log('总计数 chip:', byId('chip-total-count').textContent)
+console.log('统计条:', byId('beacon-status').textContent)
+
+const probe = (label, id, needle) => {
+  const html = byId(id).innerHTML || ''
+  console.log(`  ${html.includes(needle) ? 'ok  ' : 'MISS'} ${label} (${id}, ${html.length}B)`)
+}
+probe('承重墙含被引用笔记', 'pillars-vault', '能力 seam')
+probe('分类阵列非空', 'matrix-chambers', '架构')
+console.log('  首屏未渲染时间线（懒渲染生效）:', (byId('chrono-track').innerHTML || '').length === 0)
+
+board.switchTab('timeline')
+probe('时间线非空', 'chrono-track', '2026')
+board.switchTab('alternatives')
+probe('避坑智库含否决项', 'pitfalls-grid', 'iframe')
+board.switchTab('directory')
+probe('决策清单含标题', 'matrix-rows-stream', '能力 seam 三权分立')
+
+console.log('注册的根监听:', listeners.map(([t]) => t))
+// 抽屉：模拟点击某行 -> openConsole
+const clickHandler = (listeners.find(([t]) => t === 'click') || [])[1]
+if (!clickHandler) throw new Error('没有拿到 click 代理')
+clickHandler({
+  target: { closest: (sel) => (sel === '[data-node-id]' ? { getAttribute: () => 'implemented/architecture/2026-10-01-a.md' } : null) },
+})
+probe('抽屉-背景', 'dr-body-problem', '换沙箱实现')
+probe('抽屉-裁定', 'dr-body-decision', 'Service Definition')
+probe('抽屉-备选', 'dr-body-alt', '始终合并各角色')
+probe('抽屉-代价', 'dr-body-consequences', '零破坏')
+console.log('抽屉标题:', byId('dr-headline').textContent)
+console.log('抽屉血缘:', (byId('dr-lineage-stream').innerHTML || '').length, 'B')
+
+// KPI 卡片：原版用内联 onclick 调 routeToListFilter，收进 factory 闭包后点击必抛
+// ReferenceError。现在改成 data-kpi-filter + 事件委托，这里模拟一次点击看筛选是否生效。
+clickHandler({
+  target: { closest: (sel) => (sel === '[data-kpi-filter]' ? { getAttribute: () => 'rejected' } : null) },
+})
+const kpiHtml = byId('matrix-rows-stream').innerHTML || ''
+const kpiOk = kpiHtml.includes('用 iframe 复用原版看板') && !kpiHtml.includes('能力 seam')
+console.log(`  ${kpiOk ? 'ok  ' : 'MISS'} KPI 点击 → 决策清单只剩「否决」项（${kpiHtml.length}B）`)
+
+board.dispose()
+console.log('dispose ok')