@sanqianx/project-knowledge 4.8.0 → 5.0.1

package/docs/fresh-v5-start.md

@@ -0,0 +1,34 @@
+# v5 从头开始
+
+本版按用户确认不再迁移以前的知识库数据。旧文件留在原位置，但新版不会读取它们；没有对用户代码仓库或旧知识目录执行删除。
+
+## 更新
+
+```bash
+project-knowledge stop
+npm install -g @sanqianx/project-knowledge@latest --registry=https://registry.npmjs.org/
+project-knowledge-integrations update
+project-knowledge
+```
+
+需要 Node ≥22 和 Git。默认使用 `~/.project-knowledge-v5`，四模块的托管数据也在此目录内。若环境变量 `KB_DATA_DIR` 仍指向旧目录，请取消该设置或改为新的空目录。不要把旧 `projects.json`、设置或引擎状态复制进新目录。
+
+在“系统状态”重新配置模型与后台默认模型、embedding 和知识根目录，然后在“领域与项目”导入代码目录及新的空知识目录。原代码目录无需移动。若残留旧知识库托管 Hook，导入预检会要求明确确认替换；不会覆盖第三方 Hook。导入建立 HEAD 基线，不分析已有历史。
+
+如果模块是自己独立启动的旧进程，请在它原来的终端中停止后重启新版外壳。外壳不会擅自杀死其他服务；版本或运行期鉴权不一致时显示具体连接阶段，不接管旧服务数据。
+
+5.0.1 修复旧版 Git 的项目导入失败（日志中的路径包含
+`--path-format=absolute` 和换行）。升级 5.0.0 → 5.0.1 不需要清空新版数据或
+重新配置模型。失败项目可以直接重试导入；原代码、第三方 Hook 与旧知识文件不删除。
+导入失败会在弹窗保留错误码和操作 ID，系统诊断默认查询“系统与所有项目”，
+可按操作 ID 查找导入事务的真实失败阶段和原始错误。
+
+## 解绑与恢复
+
+“解绑并保留数据”从项目列表移除登记、取消未开始任务并卸下本项目托管 Hook，保留代码、知识、会话及证据。实际分析或索引写入尚未结束时仍禁止解绑，防止丢失写入状态。队列本身不再被当成正在运行。
+
+删除的是旧版本兼容路径，不是新版的故障恢复能力：v5 自身的重启恢复、提交去重、并发限制、失败重试和索引修复仍有效。`upgrade-recovery` 不再存在。
+
+## 回归范围
+
+旧格式迁移专用测试随旧实现删除，替换为旧目录拒绝且原字节不变、空状态启动、连接失败诊断与恢复、旧托管 Hook 的显式替换和回滚测试。真实提交链路继续由引擎 Git/Hook/journal/晋升/索引回归和五服务网页回归覆盖。模型替身和真实模型的结果分开记录；旧版本真实调用记录不计为本版通过。

package/module-runtime-manifest.json

@@ -1,8 +1,8 @@
 {
   "schema": "project-knowledge/module-content/v1",
   "productFiles": {
-    "ui/index.html": "110e9ee2797e38b5fc955d033cbdeba7bd30cdb3f5fe023db36e42a0cf0a9f01",
-    "ui/product.js": "883bd1ba63e793c7c61e35958a45489584de732d8387169135307bf8a34aa293",
+    "ui/index.html": "d090decbb17ffc17ac2ac0ec63b69979e0436d712959e5ca49a02d6d9de7e59d",
+    "ui/product.js": "3d04538ca38f6cc1b85ae0337d61c244b6769e4f15f9d029e8ab096991d17dfb",
     "ui/product.css": "1e68f087cec85a69f4497492d31fd1dd8712cf5176b0c721ce765de36ce606e1"
   },
   "modules": {
@@ -174,12 +174,12 @@
     "eventBridge": {
       "name": "@sanqianx/ai-coding-event-bridge-console",
       "installName": "@sanqianx/ai-coding-event-bridge-console",
-      "version": "0.7.0",
+      "version": "0.7.1",
       "files": {
         "LICENSE": "94a3bded67f76ec9f6333ad3370111bcb6e5cadbeb6f306a8112f9543320ecc2",
         "README.md": "847242d93395aae17b42bbaa7fc8e36e6f89edecf11a1639b94b34c98729e1a9",
         "console/index.html": "680e6393c9ef88ea35c1eabff537e0b10f7a91c55986f18bca6bfe2a333eed6e",
-        "package.json": "63b9846552b8ac3b7e361bd86bb1d9389d55e7232934aaa939b168e43ad650b7",
+        "package.json": "a6c9fc47669a5aa64dd48d38d3fc2b4fb07322cfb41bbd42b0ac174f37560715",
         "src/agent-detect.js": "06d58150c4295f7d5980ac47fd6fb1a680f1b7c27fd3dcd3f57049825dc5f092",
         "src/bin.js": "e443cfabb8df1a694c9e2415a292db81f183d9e31b7fe8f5f9a14d2a09d03052",
         "src/bridge/bin/commit-boundary.js": "2c87126d9d6467ddae13acc1d0997f2124a68174738b8cd6f8614e7eeccb3d0d",
@@ -202,7 +202,7 @@
         "src/bridge/core/normalizer.js": "34b4023efada0cfdcaaba98775b072041eaf623eb7fde48953654dc27d470ae1",
         "src/bridge/core/paths.js": "6e829c00105d3b9214942f33af6225b338c668ff4cdda5c3ab92cb759d54be30",
         "src/bridge/core/project-registry.js": "8c5cc8e18d55af1a0c2d682c25ea1c37eb6f4687cf3eaa5997fc57532560d866",
-        "src/bridge/core/repo-context.js": "ea6c9638efcb7abdb45916747a4984a97c6df31cf3fc601d221e1730fa01409b",
+        "src/bridge/core/repo-context.js": "1627d416fd6aaa43d8c4be8ce5097bb69244b1afe7f1ce5e9f71956c5542ce3f",
         "src/bridge/core/runtime-home.js": "e68a3c927b02ca27299755c60c8f709f7ce97c9f4c5080deefe518bf60d9d989",
         "src/bridge/core/semver.js": "7f87ed40f3af3ae0480abc9934946358f0caa5d951472d5892b088aa468ec0f1",
         "src/bridge/core/turn-identity.js": "4ee79410d0122ca93cea565591c183db6bff64b0a467f50a4e590de4ee78c399",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanqianx/project-knowledge",
-  "version": "4.8.0",
+  "version": "5.0.1",
   "description": "Knowledge base manager with Git integration, AI-driven analysis, and bilingual (zh-CN/en-US) knowledge output",
   "main": "_site/server.js",
   "scripts": {
@@ -49,6 +49,7 @@
     "docs/project-registry-schema.md",
     "docs/team-knowledge-mode-a-plan.md",
     "docs/testing-strategy.md",
+    "docs/fresh-v5-start.md",
     "README.md",
     "NOTICE",
     "CHANGELOG.md"
@@ -79,7 +80,7 @@
     "@huggingface/transformers": "3.8.1",
     "@lancedb/lancedb": "0.31.0",
     "@modelcontextprotocol/sdk": "1.29.0",
-    "@sanqianx/ai-coding-event-bridge-console": "0.7.0",
+    "@sanqianx/ai-coding-event-bridge-console": "0.7.1",
     "@sanqianx/vector-hub": "1.0.7",
     "buffer": "^6.0.3",
     "cheerio": "^1.2.0",

package/plugins/project-knowledge/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "project-knowledge",
-  "version": "4.8.0",
+  "version": "5.0.1",
   "description": "Read durable project decisions and implementation history from Project Knowledge.",
   "author": {
     "name": "SanQianX",

package/plugins/project-knowledge/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "project-knowledge",
-  "version": "4.8.0",
+  "version": "5.0.1",
   "description": "Read durable project decisions and implementation history from Project Knowledge.",
   "author": {
     "name": "SanQianX",

package/plugins/project-knowledge/.mcp.json

@@ -6,7 +6,7 @@
       "args": [
         "-y",
         "--package",
-        "@sanqianx/project-knowledge@4.8.0",
+        "@sanqianx/project-knowledge@5.0.1",
         "project-knowledge-mcp"
       ]
     }

package/ui/index.html

@@ -32,7 +32,7 @@
   </main>
 </div>
 <div id="drawerBackdrop" class="drawer-backdrop" hidden></div>
-<dialog id="logsDialog" class="reference-dialog"><div class="dialog-heading"><h2>系统诊断记录</h2><button data-close="logsDialog" aria-label="关闭">×</button></div><div class="actions"><input id="logsSearch" placeholder="查找失败原因或提交 SHA" aria-label="筛选诊断记录"><button id="loadLogs">查询</button><button id="exportLogs">导出诊断记录</button></div><div id="logsStatus" class="muted"></div><div id="logsContent"></div></dialog>
+<dialog id="logsDialog" class="reference-dialog"><div class="dialog-heading"><h2>系统诊断记录</h2><button data-close="logsDialog" aria-label="关闭">×</button></div><div class="actions"><select id="logsScope" aria-label="诊断范围"><option value="all">系统与所有项目</option><option value="project">当前项目</option></select><input id="logsSearch" placeholder="查找失败原因、操作 ID 或提交 SHA" aria-label="筛选诊断记录"><button id="loadLogs">查询</button><button id="exportLogs">导出诊断记录</button></div><div id="logsStatus" class="muted"></div><div id="logsContent"></div></dialog>
 <aside class="drawer" id="systemDrawer" hidden aria-label="系统状态">
   <header><h2>系统状态</h2><button id="closeSystem" class="icon-button" aria-label="关闭系统状态">×</button></header>
   <div class="drawer-content">
@@ -54,9 +54,10 @@
   <p id="embeddingFeedback" class="muted" role="status"></p>
   <div class="dialog-actions"><button type="button" id="disableEmbedding">停用向量模型</button><button type="button" data-close="embeddingDialog">取消</button><button type="submit" class="primary">保存配置</button></div>
 </form></dialog>
-<dialog id="importDialog"><form id="importForm"><div class="dialog-heading"><h2>导入项目</h2><button type="button" data-close="importDialog" aria-label="关闭">×</button></div><p class="muted">绑定代码与知识目录。只建立跟踪基线，不分析全部历史。</p><label>代码目录<div class="input-with-action"><input name="localPath" id="importCode" required placeholder="D:\SanQian.Xu\my-project"><button type="button" id="pickCode">选择</button></div></label><label>项目名称<input name="displayName" id="importName" required maxlength="200"></label><label>知识目录<div class="input-with-action"><input name="knowledgePath" id="importKnowledge" required placeholder="D:\SanQian.Xu\knowledge\my-project"><button type="button" id="pickKnowledge">选择</button></div></label><label>所属领域<select name="domainId" id="importDomain"></select></label><label id="gitInitChoice" class="checkbox" hidden><input type="checkbox" name="confirmGitInit">这个目录不是 Git 仓库，我确认初始化 Git。</label><div id="preflightStatus" class="feedback" role="status">填写目录后检查导入条件。</div><button type="button" id="setupImportRoot" hidden>设置知识根目录</button><div class="dialog-actions"><button type="button" data-close="importDialog">取消</button><button type="submit" class="primary" id="confirmImport" disabled>导入项目</button></div></form></dialog>
+<dialog id="importDialog"><form id="importForm"><div class="dialog-heading"><h2>导入项目</h2><button type="button" data-close="importDialog" aria-label="关闭">×</button></div><p class="muted">绑定代码与新的空知识目录。只建立跟踪基线，不读取旧知识、不分析全部历史。</p><label>代码目录<div class="input-with-action"><input name="localPath" id="importCode" required placeholder="D:\SanQian.Xu\my-project"><button type="button" id="pickCode">选择</button></div></label><label>项目名称<input name="displayName" id="importName" required maxlength="200"></label><label>知识目录<div class="input-with-action"><input name="knowledgePath" id="importKnowledge" required placeholder="D:\SanQian.Xu\knowledge\my-project"><button type="button" id="pickKnowledge">选择</button></div></label><label>所属领域<select name="domainId" id="importDomain"></select></label><label id="gitInitChoice" class="checkbox" hidden><input type="checkbox" name="confirmGitInit">这个目录不是 Git 仓库，我确认初始化 Git。</label><label id="replaceHookChoice" class="checkbox" hidden><input type="checkbox" name="confirmReplaceHook">目录留有旧知识库的托管 Hook，我确认替换为新项目接线。不会覆盖第三方 Hook。</label><div id="preflightStatus" class="feedback" role="status">填写目录后检查导入条件。</div><button type="button" id="setupImportRoot" hidden>设置知识根目录</button><div class="dialog-actions"><button type="button" data-close="importDialog">取消</button><button type="submit" class="primary" id="confirmImport" disabled>导入项目</button></div></form></dialog>
 <dialog id="domainDialog"><form id="domainForm"><div class="dialog-heading"><h2>创建领域</h2><button type="button" data-close="domainDialog" aria-label="关闭">×</button></div><label>领域名称<input name="name" required maxlength="100" placeholder="例如：开发工具"></label><p class="muted">领域用于共享相关项目的知识，不是新的代码项目。</p><div class="dialog-actions"><button type="button" data-close="domainDialog">取消</button><button class="primary" type="submit">创建领域</button></div></form></dialog>
 <dialog id="memoryDialog"><form id="memoryForm"><div class="dialog-heading"><h2>编辑记忆</h2><button type="button" data-close="memoryDialog" aria-label="关闭">×</button></div><label>内容<textarea id="memoryText" maxlength="2000" required rows="5"></textarea></label><p id="memoryEvidence" class="muted"></p><div class="dialog-actions"><button type="button" data-close="memoryDialog">取消</button><button type="submit" class="primary">保存修改</button></div></form></dialog>
+<dialog id="unbindDialog"><form id="unbindForm"><div class="dialog-heading"><h2>解绑项目</h2><button type="button" data-close="unbindDialog" aria-label="关闭">×</button></div><p id="unbindProjectName"></p><p class="muted">项目将从列表移除，取消尚未开始的维护任务。代码、知识文件、提交证据和会话历史仍保留。正在执行的知识写入结束前不会解绑。</p><p id="unbindFeedback" class="feedback" role="status"></p><div class="dialog-actions"><button type="button" data-close="unbindDialog">取消</button><button class="primary" type="submit" id="confirmUnbind">解绑并保留数据</button></div></form></dialog>
 <dialog id="referenceDialog" class="reference-dialog"><div class="dialog-heading"><h2 id="referenceTitle">知识引用</h2><div class="actions"><button id="copyReference">复制引用</button><button data-close="referenceDialog" aria-label="关闭">×</button></div></div><p id="referenceMeta" class="muted"></p><pre id="referenceContent"></pre></dialog>
 <dialog id="engineDialog" class="engine-dialog"><div class="dialog-heading"><h2>知识引擎诊断</h2><button data-close="engineDialog" aria-label="关闭">×</button></div><iframe id="engineFrame" title="知识引擎诊断" referrerpolicy="same-origin"></iframe></dialog>
 <div id="toast" class="toast" role="status" aria-live="polite" hidden></div>

package/ui/product.js

@@ -16,16 +16,16 @@
   const domainName = id => state.brain.domains.find(d => d.id === id)?.name || '未分组';
   const projectName = id => state.projects.find(p => p.projectId === id)?.name || id;
   const time = value => value ? new Date(value).toLocaleString('zh-CN', { month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit' }) : '—';
-  const label = run => ({ queued: '排队', running: '维护中', succeeded: '已更新 · 可检索', 'index-pending': '知识已更新 · 索引待修复', failed: '维护失败' })[run.state] || run.state;
+  const label = run => ({ queued: '排队', running: '维护中', succeeded: '已更新 · 可检索', 'index-pending': '知识已更新 · 索引待修复', failed: '维护失败', cancelled: '已取消' })[run.state] || run.state;
   const badge = (text, status = '') => `<span class="status ${esc(status)}">${esc(text)}</span>`;
-  let toastTimer, refreshTimer, preflightTimer, editingMemoryId, logStream, logEpoch = 0, referenceEpoch = 0, snapshotEpoch = 0, resumeImport = false;
+  let toastTimer, refreshTimer, preflightTimer, editingMemoryId, logStream, logEpoch = 0, referenceEpoch = 0, snapshotEpoch = 0, registryEpoch = 0, registryPromise = null, resumeImport = false, unbindProjectId = '', unbinding = false;
   async function api(url, options = {}) {
     const { allowNotReady, ...init } = options;
     if (init.body && typeof init.body !== 'string') init.body = JSON.stringify(init.body);
     if (init.body) init.headers = { 'Content-Type': 'application/json', ...init.headers };
     const response = await fetch(url, init);
     const data = await response.json();
-    if (!response.ok || data.ok === false && !allowNotReady) throw Object.assign(new Error(data.error?.message || data.message || (typeof data.error === 'string' ? data.error : `请求失败 (${response.status})`)), { code: data.error?.code || data.error });
+    if (!response.ok || data.ok === false && !allowNotReady) throw Object.assign(new Error(data.error?.message || data.message || (typeof data.error === 'string' ? data.error : `请求失败 (${response.status})`)), { code: data.error?.code || data.error, operationId: data.error?.operationId || response.headers.get('X-Operation-Id') || '' });
     return data;
   }
   function toast(text) { $('toast').textContent = text; $('toast').hidden = false; clearTimeout(toastTimer); toastTimer = setTimeout(() => { $('toast').hidden = true; }, 4000); }
@@ -149,23 +149,29 @@
     stream.addEventListener('progress', () => { if (state.stream === stream) scheduleRefresh(); });
     stream.onerror = () => { if (state.stream === stream) $('activityConnection').textContent = '连接中断，正在恢复快照'; };
   }
-  async function refreshRegistry() {
-    if (!navigator.onLine || state.refreshing) return;
-    state.refreshing = true;
+  function refreshRegistry(force = false) {
+    if (!navigator.onLine) return Promise.resolve();
+    if (registryPromise && !force) return registryPromise;
+    const epoch = ++registryEpoch;
+    const job = (async () => {
     try {
       const [brain, projects, health] = await Promise.all([api('/api/brain'), api('/api/projects/aggregated'), api('/api/modules/health')]);
+      if (epoch !== registryEpoch) return;
       state.brain = brain.brain; state.root = brain.knowledgeRoot; state.projects = projects.projects; state.health = health.modules; state.ownership = health.ownership;
       if (!activeProject()) { state.projectId = state.projects[0]?.projectId || ''; state.epoch++; Object.keys(frames).forEach(frameContext); }
       renderProjectOptions(); renderSystem(); connectProgress(); await refreshSnapshot(); setView(state.view);
     } catch (error) { toast(error.message); }
-    finally { state.refreshing = false; connectProgress(); }
+    finally { if (epoch === registryEpoch) { registryPromise = null; connectProgress(); } }
+    })();
+    registryPromise = job;
+    return job;
   }
   function renderSystem() {
     const down = Object.keys(modules).filter(key => !state.health[key]?.up);
     const pending = state.ownership?.owner === 'engine' && !state.ownership.ready;
     $('systemDot').className = `dot ${down.length || pending ? 'issue' : 'up'}`;
-    $('systemTitle').textContent = pending ? '知识引擎接管待恢复' : down.length ? '部分服务需要处理' : '系统连接正常';
-    $('systemDetail').textContent = pending ? state.ownership.message || '迁移未完成，原知识与提交证据保留。' : down.length ? down.map(k => modules[k]).join('、') : '本机知识服务已连接';
+    $('systemTitle').textContent = pending ? '知识引擎连接待恢复' : down.length ? '部分服务需要处理' : '系统连接正常';
+    $('systemDetail').textContent = pending ? `${state.ownership.message || '服务恢复后自动重试。'}${state.ownership.error ? ` · ${state.ownership.error.step} (${state.ownership.error.code})` : ''}` : down.length ? down.map(k => modules[k]).join('、') : '本机知识服务已连接';
     $('moduleHealth').innerHTML = Object.entries(modules).map(([key, name]) => `<div class="row"><div><b>${esc(name)}</b><small>${esc(state.health[key]?.url || '')}</small></div>${badge(state.health[key]?.up ? '在线' : '离线', state.health[key]?.up ? 'up' : 'issue')}</div>`).join('');
     if (!navigator.onLine) {
       $('systemDot').className = 'dot issue'; $('systemTitle').textContent = '网页连接中断';
@@ -182,16 +188,17 @@
     const epoch = ++logEpoch;
     logStream?.close(); logStream = null;
     const params = new URLSearchParams({ pageSize: '100', q: $('logsSearch').value.trim() });
-    if (state.projectId) params.set('projectId', state.projectId);
+    const projectOnly = $('logsScope').value === 'project' && Boolean(state.projectId);
+    if (projectOnly) params.set('projectId', state.projectId);
     const result = await api(`/api/logs?${params}`);
     if (epoch !== logEpoch || !$('logsDialog').open) return;
     $('logsDialog').dataset.streamCursor = result.streamCursor || '';
     $('logsContent').replaceChildren();
     for (const record of [...(result.entries || [])].reverse()) appendLog(record);
-    $('logsStatus').textContent = `${(result.entries || []).length} 条诊断记录 · 当前项目`;
+    $('logsStatus').textContent = `${(result.entries || []).length} 条诊断记录 · ${projectOnly ? '当前项目' : '系统与所有项目'}`;
     if (!$('logsSearch').value.trim()) {
       const streamParams = new URLSearchParams({ streamCursor: result.streamCursor || '' });
-      if (state.projectId) streamParams.set('projectId', state.projectId);
+      if (projectOnly) streamParams.set('projectId', state.projectId);
       logStream = new EventSource(`/api/logs/stream?${streamParams}`);
       logStream.addEventListener('logs/appended', event => { if (epoch === logEpoch && $('logsDialog').open) appendLog(JSON.parse(event.data).record); });
     }
@@ -267,9 +274,9 @@
     $('importForm').reset(); state.importId = `project-${crypto.randomUUID()}`; state.preflight = null; state.preflightEpoch++;
     $('importDomain').innerHTML = '<option value="">未分组</option>' + state.brain.domains.map(d => `<option value="${esc(d.id)}">${esc(d.name)}</option>`).join('');
     $('importDomain').value = activeProject()?.domainId || '';
-    $('gitInitChoice').hidden = true; $('confirmImport').disabled = true; $('preflightStatus').textContent = '填写目录后检查导入条件。'; $('importDialog').showModal();
+    $('gitInitChoice').hidden = true; $('replaceHookChoice').hidden = true; $('confirmImport').disabled = true; $('preflightStatus').textContent = '填写目录后检查导入条件。'; $('importDialog').showModal();
   }
-  function importInput() { return { projectId: state.importId, brainId: state.brain.id, domainId: $('importDomain').value || null, localPath: $('importCode').value.trim(), knowledgePath: $('importKnowledge').value.trim(), displayName: $('importName').value.trim(), knowledgeLanguage: 'zh-CN', confirmGitInit: $('importForm').elements.confirmGitInit.checked }; }
+  function importInput() { return { projectId: state.importId, brainId: state.brain.id, domainId: $('importDomain').value || null, localPath: $('importCode').value.trim(), knowledgePath: $('importKnowledge').value.trim(), displayName: $('importName').value.trim(), knowledgeLanguage: 'zh-CN', confirmGitInit: $('importForm').elements.confirmGitInit.checked, replaceManagedHookProjectId: $('importForm').elements.confirmReplaceHook.checked ? state.preflight?.checks.hook?.replacementProjectId : undefined }; }
   const problemLabels = { KNOWLEDGE_ROOT_MISSING: '请在系统状态中设置知识根目录。', AI_PROFILE_REQUIRED: '请配置可用模型；后台默认模型在系统状态中设置。', DUPLICATE_PROJECT: '此项目已导入，请打开已有项目。', HOOK_CONFLICT: '存在第三方 Hook，不会覆盖。请先检查冲突。', PATH_MISSING: '代码目录不存在。', PATH_REQUIRED: '请选择代码目录。' };
   async function checkImport() {
     const epoch = ++state.preflightEpoch; $('confirmImport').disabled = true;
@@ -279,12 +286,12 @@
     try {
       const result = await api('/api/projects/preflight-import', { method: 'POST', body: importInput(), allowNotReady: true });
       if (epoch !== state.preflightEpoch || !$('importDialog').open) return;
-      state.preflight = result; $('gitInitChoice').hidden = !result.plannedGitInit;
+      state.preflight = result; $('gitInitChoice').hidden = !result.plannedGitInit; $('replaceHookChoice').hidden = !result.checks.hook?.replacementProjectId;
       const messages = result.problems.map(p => problemLabels[p.code] || p.message);
       $('setupImportRoot').hidden = !result.problems.some(p => p.code === 'KNOWLEDGE_ROOT_MISSING');
       $('preflightStatus').textContent = result.ready ? result.plannedGitInit ? '目录检查通过。请确认初始化 Git；不分析历史。' : '检查通过。只建立当前提交的跟踪基线，不分析历史。' : [...new Set(messages)].join('\n');
       $('preflightStatus').classList.toggle('issue', !result.ready);
-      $('confirmImport').disabled = !result.ready || result.plannedGitInit && !$('importForm').elements.confirmGitInit.checked || !$('importKnowledge').value.trim();
+      $('confirmImport').disabled = !result.ready || result.plannedGitInit && !$('importForm').elements.confirmGitInit.checked || result.checks.hook?.replacementProjectId && !$('importForm').elements.confirmReplaceHook.checked || !$('importKnowledge').value.trim();
     } catch (error) { if (epoch === state.preflightEpoch) $('preflightStatus').textContent = error.message; }
   }
   document.addEventListener('click', e => {
@@ -292,7 +299,7 @@
     const execute = async () => {
       if (button.dataset.view) setView(button.dataset.view);
       if (button.dataset.go) { if (button.dataset.go === 'memory') state.memoryTab = 'candidate'; setView(button.dataset.go); }
-      if (button.dataset.close) $(button.dataset.close).close();
+      if (button.dataset.close && !(button.dataset.close === 'unbindDialog' && unbinding)) $(button.dataset.close).close();
       if (button.dataset.selectProject) selectProject(button.dataset.selectProject);
       if (button.dataset.scope) { state.scope = button.dataset.scope; all('[data-scope]').forEach(b => b.classList.toggle('active', b.dataset.scope === state.scope)); post('vectorHub', { type: 'kb:scope', scope: state.scope }); }
       if (button.dataset.memoryTab) { state.memoryTab = button.dataset.memoryTab; renderMemories(); }
@@ -300,7 +307,7 @@
       if (button.dataset.action === 'import') openImport();
       if (button.dataset.action === 'repair') await repair();
       if (button.dataset.action === 'system') await openSystem();
-      if (button.dataset.action === 'unbind') { const p = activeProject(); if (p && confirm(`解绑 ${p.name}？代码、知识文件和会话历史将保留。`)) { await api(`/api/projects/${encodeURIComponent(p.projectId)}`, { method: 'DELETE', body: { deleteKnowledge: false } }); toast('已解绑，数据仍保留。'); await refreshRegistry(); } }
+      if (button.dataset.action === 'unbind') { const p = activeProject(); if (p && !unbinding) { unbindProjectId = p.projectId; $('unbindProjectName').textContent = `解绑「${p.name}」？`; $('unbindFeedback').textContent = ''; $('unbindDialog').showModal(); } }
       if (button.dataset.retryRun) { await api(`/api/engine/runs/${encodeURIComponent(button.dataset.retryRun)}/retry`, { method: 'POST', body: {} }); await refreshSnapshot(); }
       if (button.dataset.contextIndex !== undefined) await openReference(state.contexts.get(state.projectId).references[Number(button.dataset.contextIndex)]);
       if (button.dataset.memoryAction) {
@@ -344,6 +351,7 @@
   on('engineDialog', 'close', () => post('engine', { type: 'kb:visibility', visible: false }));
   on('openLogs', 'click', async () => { closeSystem(); $('logsDialog').showModal(); await loadLogs(); });
   on('logsDialog', 'close', () => { logEpoch++; logStream?.close(); logStream = null; });
+  on('logsScope', 'change', loadLogs);
   on('copyReference', 'click', async () => {
     const text = $('referenceMeta').textContent + '\n\n' + $('referenceContent').textContent;
     try { await navigator.clipboard.writeText(text); }
@@ -351,19 +359,46 @@
     toast('已复制知识与来源。');
   });
   on('loadLogs', 'click', loadLogs);
-  on('exportLogs', 'click', async () => { const params = new URLSearchParams({ q: $('logsSearch').value.trim() }); if (state.projectId) params.set('projectId', state.projectId); const response = await fetch(`/api/logs/export?${params}`); if (!response.ok) throw new Error('诊断导出失败。'); const blob = await response.blob(); const url = URL.createObjectURL(blob); const link = document.createElement('a'); link.href = url; link.download = 'knowledge-diagnostics.jsonl'; link.click(); setTimeout(() => URL.revokeObjectURL(url), 1000); });
+  on('exportLogs', 'click', async () => { const params = new URLSearchParams({ q: $('logsSearch').value.trim() }); if ($('logsScope').value === 'project' && state.projectId) params.set('projectId', state.projectId); const response = await fetch(`/api/logs/export?${params}`); if (!response.ok) throw new Error('诊断导出失败。'); const blob = await response.blob(); const url = URL.createObjectURL(blob); const link = document.createElement('a'); link.href = url; link.download = 'knowledge-diagnostics.jsonl'; link.click(); setTimeout(() => URL.revokeObjectURL(url), 1000); });
   on('createDomain', 'click', () => { $('domainForm').reset(); $('domainDialog').showModal(); });
   on('domainForm', 'submit', async e => { e.preventDefault(); await api('/api/domains', { method: 'POST', body: Object.fromEntries(new FormData(e.target)) }); $('domainDialog').close(); await refreshRegistry(); });
   on('memoryForm', 'submit', async e => { e.preventDefault(); await api(`/api/engine/memories/${encodeURIComponent(editingMemoryId)}`, { method: 'PATCH', body: { text: $('memoryText').value } }); $('memoryDialog').close(); await refreshSnapshot(); });
+  on('unbindForm', 'submit', async e => {
+    e.preventDefault(); if (!unbindProjectId || unbinding) return;
+    const projectId = unbindProjectId;
+    unbinding = true; $('confirmUnbind').disabled = true; $('confirmUnbind').textContent = '正在解绑…';
+    $('unbindFeedback').textContent = '正在停止项目接线并移除登记，磁盘文件不会删除。';
+    try {
+      await api(`/api/projects/${encodeURIComponent(projectId)}`, { method: 'DELETE', body: { deleteKnowledge: false } });
+      state.contexts.delete(projectId);
+      state.projects = state.projects.filter(project => project.projectId !== projectId);
+      if (state.projectId === projectId) { state.projectId = state.projects[0]?.projectId || ''; state.epoch++; }
+      renderProjectOptions(); render(); Object.keys(frames).forEach(frameContext);
+      $('unbindDialog').close(); unbindProjectId = '';
+      // A late read started before DELETE cannot restore the removed project.
+      await refreshRegistry(true); localStorage.setItem('kb.project', state.projectId);
+      Object.keys(frames).forEach(frameContext);
+      toast('项目已从列表移除，代码、知识和会话仍保留。');
+    } catch (error) { $('unbindFeedback').textContent = error.message; }
+    finally { unbinding = false; $('confirmUnbind').disabled = false; $('confirmUnbind').textContent = '解绑并保留数据'; }
+  });
+  on('unbindDialog', 'cancel', e => { if (unbinding) e.preventDefault(); });
   on('importForm', 'input', e => {
     if (e.target.id === 'importCode') { const name = e.target.value.trim().split(/[\\/]/).filter(Boolean).pop() || ''; $('importName').value = name; if (state.root) $('importKnowledge').value = `${state.root.replace(/[\\/]+$/, '')}/${name}-${state.importId.slice(-6)}`; }
     clearTimeout(preflightTimer); $('confirmImport').disabled = true; preflightTimer = setTimeout(checkImport, 250);
   });
   on('importForm', 'submit', async e => {
-    e.preventDefault(); if (!state.preflight?.ready || state.preflight.plannedGitInit && !$('importForm').elements.confirmGitInit.checked) return;
+    e.preventDefault(); if (!state.preflight?.ready || state.preflight.plannedGitInit && !$('importForm').elements.confirmGitInit.checked || state.preflight.checks.hook?.replacementProjectId && !$('importForm').elements.confirmReplaceHook.checked) return;
     $('confirmImport').disabled = true; $('confirmImport').textContent = '正在登记…';
-    try { const result = await api('/api/projects/import', { method: 'POST', body: importInput() }); state.projectId = result.projectId; state.epoch++; $('importDialog').close(); await refreshRegistry(); Object.keys(frames).forEach(frameContext); setView('projects'); toast(Object.values(result.modules).every(m => m.ok) ? '项目已导入，四个模块已连接。' : '项目已导入，部分接线待恢复。'); }
-    finally { $('confirmImport').textContent = '导入项目'; if ($('importDialog').open) checkImport(); }
+    let failed = false, registered = false;
+    try { const result = await api('/api/projects/import', { method: 'POST', body: importInput() }); registered = true; state.projectId = result.projectId; state.epoch++; $('importDialog').close(); await refreshRegistry(); Object.keys(frames).forEach(frameContext); setView('projects'); toast(Object.values(result.modules).every(m => m.ok) ? '项目已导入，四个模块已连接。' : '项目已导入，部分接线待恢复。'); }
+    catch (error) {
+      failed = true;
+      if (registered) { toast(`项目已登记，但页面状态刷新失败：${error.message}`); return; }
+      $('preflightStatus').textContent = `导入失败：${error.message}\n错误码：${error.code || 'UNKNOWN'}${error.operationId ? `\n操作 ID：${error.operationId}` : ''}\n请在系统诊断记录中查看详细原因。`;
+      $('preflightStatus').classList.add('issue'); $('confirmImport').disabled = false;
+    }
+    finally { $('confirmImport').textContent = '导入项目'; if ($('importDialog').open && !failed) checkImport(); }
   });
   window.addEventListener('hashchange', () => setView(location.hash.slice(1)));
   window.addEventListener('offline', () => {

package/vendor-manifest.json

@@ -3,19 +3,18 @@
   "modules": {
     "knowledge-engine": {
       "name": "@sanqianx/ai-coding-knowledge-engine",
-      "version": "0.1.0",
+      "version": "0.2.0",
       "root": "_modules/knowledge-engine",
       "files": {
-        "README.md": "27e06c47c58e75e3081296cbdb2885df2d346fbd87bd7e415254db501d8ef35d",
-        "package.json": "f6949c331796b8351e55293d2be5a18b4ac7a203b9270c564eeefd692a006daf",
+        "README.md": "c12b9bc9aa49dce6eaad0e6f3fd611466ab1ef6b17d2bdfb69a6dab6a42ab5ed",
+        "package.json": "6740fa3dec72ebae49fa903a4b5f8ddc2adf52d11ba9f7c4bc1f36a603636578",
         "src/analysis-contract.js": "90354d1e9b4eff74fdd9d47e097cdb5d47944785c2be66811f64e5958c94d8e7",
         "src/analysis-worker.js": "a105cabe6e1573b2d986b1e7a5aaf615e2fb53524156fc8e4e2c0a71f2c97e55",
         "src/bin.js": "22208907431d0f3a971a669c7e5eb44b3b7af9bbb36fd7ba17c3b90c4288bd70",
         "src/bridge-client.js": "ae0dba21e4286694bcd9e064ca36564ec997969ae1eb1ce4f8a6665e447cbffe",
-        "src/coordinator.js": "4e82cce47c8c16294ddc77eb946eb1c3a2f8bfd8918e05742c80845ed8ecf10c",
+        "src/coordinator.js": "e85f1f604d2090bd466244d73cf8e1862e0cbe436e62d4a2f7193afd2fac7843",
         "src/headless-analyzer.js": "2473b28d4bf06088abbcafa21d491560a9ca0ab100024c912a36bc6f981d8576",
         "src/memories.js": "0a8667e6daba99fa5022393951a28e96cdadf98af85b6af9a6be96c7f4e896fc",
-        "src/migration.js": "b018871727f3277e4a24350fef1911fbb89e2158578339210d88efc2e309be32",
         "src/retrieval.js": "acbf76bb93fd13dac391c2e918891a56ace869db5583d2a5994641b6782496d6",
         "src/runtime/README.md": "9be676eca76a7857b34d7357194e6f0ee733c22e61d962d53984715dbec7f673",
         "src/runtime/atomic-file.js": "9846b4b69db5ded811acf19a1181ef93615d93efaa542b858e552a7f3124ad23",
@@ -35,10 +34,10 @@
         "src/runtime/layout.js": "c48fa1db62e5df1edefe13218e470c5ceea4ef2781293512c2c18e5c2ba0c7e9",
         "src/runtime/markdown-knowledge-indexer.js": "44a76a9adefad07e78f77b1106b10d6c1cc7873d76362df4c546892b21f3939c",
         "src/runtime/scanner.js": "d99fa8d74a6fbbaae75ca49f62127e14cf9e48b1404e4b4d597ef39df5441410",
-        "src/server.js": "e2d983eaa9f4ffc240caab467fad8e21c6124779ac3f27c9cec2c4f06827ef65",
-        "src/store.js": "b778d93b97cd6a1174fccd3a5de1f2b170934a262e11e4447e7fdc698ac386e0",
+        "src/server.js": "e7f0b07b7a8cf2623690b9d2d23492f2c95737dc974adfeea049610a4b5ded55",
+        "src/store.js": "71f0417c2c1e42b89429e3dee1adff7b2c09e86682cb3f4843ce6d9e5aafd7ec",
         "ui/app.css": "7ad370c269e60a7b5ec907d81a607b2d16bd07b2d7c22a81f102dab51eeb2889",
-        "ui/app.js": "5f4f6fc6faeb951938a821e846e948de8859d7c908e04f6f93bf73208493993e",
+        "ui/app.js": "91ee6d8c31712e6af46de2eecbd72bbc5236c06b7cd055800831e7d57f84a0be",
         "ui/index.html": "ce3565cfefd4838b11d37a91a906ef26ca5a1834844fe3f7c897b56851a3c418"
       }
     }

package/_modules/knowledge-engine/src/migration.js

@@ -1,88 +0,0 @@
-'use strict';
-const fs = require('node:fs');
-const path = require('node:path');
-const crypto = require('node:crypto');
-const AtomicFile = require('./runtime/atomic-file');
-const { validateClaim } = require('./runtime/commit-reconciler');
-const { validateSha } = require('./runtime/scanner');
-const { initialRuntime } = require('./store');
-
-// Only frozen analysis artifacts cross this boundary, never shell settings,
-// registries or credentials. Canonical knowledge files stay where they are.
-async function importLegacyState(coordinator, input) {
-  const { store, layout } = coordinator;
-  if (!/^cutover-[a-f0-9-]{36}$/.test(input.migrationId || '') || !path.isAbsolute(input.sourceDataDir || '') || !Array.isArray(input.projects)) throw failure('INVALID_ARGUMENT');
-  if (store.state.migrations?.includes(input.migrationId)) return { reused: true };
-  if (coordinator.executionEnabled || coordinator.active.size) throw failure('ENGINE_NOT_PAUSED');
-  const backup = path.join(input.sourceDataDir, 'recovery', 'engine-cutover', input.migrationId);
-  if (!fs.existsSync(path.join(backup, 'snapshot.json'))) throw failure('MIGRATION_BACKUP_MISSING');
-  const snapshot = AtomicFile.readJsonStrict(path.join(backup, 'snapshot.json'));
-  if (snapshot.migrationId !== input.migrationId || snapshot.sourceDataDir !== input.sourceDataDir) throw failure('MIGRATION_BACKUP_MISMATCH');
-  input = snapshot;
-  const mappings = ['runs', 'claims', 'promotions', 'processed-commits'].map(kind => [path.join(input.sourceDataDir, 'runtime', kind), layout.getRuntimePath(kind)]);
-  mappings.push([path.join(input.sourceDataDir, 'recovery', 'promotions'), layout.getRecoveryPath('promotions')]);
-  for (const projected of input.projects) mappings.push([path.join(input.sourceDataDir, 'projects', projected.registration.projectId), layout.getProjectMetadataDir(projected.registration.projectId)]);
-  function remap(value) {
-    if (Array.isArray(value)) return value.map(remap);
-    if (value && typeof value === 'object') return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, remap(item)]));
-    if (typeof value === 'string' && path.isAbsolute(value) && !value.includes('\n')) {
-      const mapping = mappings.find(([from]) => layout.isPathInside(from, value));
-      if (mapping) return path.join(mapping[1], path.relative(mapping[0], value));
-    }
-    return value;
-  }
-  function copy(source, target) {
-    if (!fs.existsSync(source)) return;
-    const stat = fs.lstatSync(source);
-    if (stat.isSymbolicLink() || !layout.isPathInside(backup, source, { realpath: true }) || !layout.isPathInside(store.dataDir, target, { realpath: true })) throw failure('MIGRATION_UNSAFE_PATH');
-    if (stat.isDirectory()) {
-      for (const entry of fs.readdirSync(source)) copy(path.join(source, entry), path.join(target, entry));
-      return;
-    }
-    if (!stat.isFile()) throw failure('MIGRATION_UNSAFE_PATH');
-    let bytes = fs.readFileSync(source);
-    if (source.endsWith('.json')) bytes = Buffer.from(JSON.stringify(remap(JSON.parse(bytes.toString('utf8'))), null, 2));
-    if (fs.existsSync(target)) {
-      if (!fs.readFileSync(target).equals(bytes)) throw failure('MIGRATION_ARTIFACT_CONFLICT');
-    } else AtomicFile.writeFileAtomic(target, bytes);
-  }
-  for (const kind of ['runs', 'claims', 'promotions', 'processed-commits']) copy(path.join(backup, 'runtime', kind), layout.getRuntimePath(kind));
-  copy(path.join(backup, 'recovery', 'promotions'), layout.getRecoveryPath('promotions'));
-  for (const { registration, runtime } of input.projects) {
-    const project = store.addProject(registration).project;
-    if (project.migrationId === input.migrationId) continue;
-    if (store.state.runs.some(run => run.projectId === project.projectId)) throw failure('MIGRATION_PROJECT_ALREADY_ACTIVE');
-    const next = initialRuntime(registration);
-    if (runtime.lastAnalyzedCommit) next.lastAnalyzedCommit = validateSha(runtime.lastAnalyzedCommit);
-    next.conversationBaselineCursor = runtime.conversationBaselineCursor ?? next.conversationBaselineCursor;
-    if (runtime.conversationBaselineCursors) {
-      if (Object.entries(runtime.conversationBaselineCursors).some(([journal, cursor]) => !/^(global|sha256:[a-f0-9]{64})$/.test(journal) || !Number.isSafeInteger(cursor) || cursor < 0)) throw failure('MIGRATION_INVALID_BASELINE');
-      next.conversationBaselineCursors = { ...runtime.conversationBaselineCursors };
-    }
-    next.analysis.consumedRequirementIds = (runtime.analysis?.consumedRequirementIds || []).filter(id => typeof id === 'string');
-    next.index.dirty = runtime.index?.dirty === true;
-    const claim = runtime.analysis?.activeClaim;
-    if (claim) {
-      validateClaim(claim, project.projectId, validateSha(claim.commitSha));
-      const claimKeys = ['schema', 'projectId', 'commitSha', 'parents', 'triggerFirstSeen', 'requirementIds', 'requirementBinding', 'conversationSnapshotHash', 'conversationTurnIds', 'conversationEventIds', 'promptTemplateVersion', 'promptHash', 'patchHash', 'evidenceHash', 'evidenceManifestHash', 'retrievalManifestHash', 'knowledgePath', 'runId', 'operationId', 'phase', 'attempt', 'fingerprint'];
-      next.analysis.activeClaim = remap(Object.fromEntries(claimKeys.filter(key => claim[key] !== undefined).map(key => [key, claim[key]])));
-      next.analysis.status = claim.phase;
-    }
-    for (const name of ['conversation-events.jsonl', 'commit-boundaries', 'commit-conversations']) copy(path.join(backup, 'projects', project.projectId, name), path.join(layout.getProjectMetadataDir(project.projectId), name));
-    project.runtime = next;
-    project.migrationId = input.migrationId;
-    store.save();
-    if (claim) {
-      const run = store.addRun({ projectId: project.projectId, commitSha: claim.commitSha, trigger: 'upgrade-recovery' });
-      store.updateRun(run.runId, { analysisRunId: claim.runId, phase: 'recovering' });
-    } else if (next.index.dirty && next.lastAnalyzedCommit) {
-      const run = store.addRun({ projectId: project.projectId, commitSha: next.lastAnalyzedCommit, trigger: 'upgrade-index-recovery' });
-      store.updateRun(run.runId, { promotedAt: new Date().toISOString(), phase: 'index-pending', state: 'index-pending', indexState: 'failed' });
-    }
-  }
-  store.state.migrations = [...(store.state.migrations || []), input.migrationId];
-  store.save();
-  return { migrated: input.projects.length, fingerprint: crypto.createHash('sha256').update(JSON.stringify(input.projects.map(p => [p.registration.projectId, p.runtime.lastAnalyzedCommit]))).digest('hex') };
-}
-function failure(code) { return Object.assign(new Error('运行迁移未完成，原数据与升级备份已保留。'), { code, status: 409 }); }
-module.exports = { importLegacyState };

package/_site/_test/data-dir-migration-test.js

@@ -1,77 +0,0 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const dataDir = require('../lib/data-dir');
-const { LEGACY_ASSETS } = require('../lib/legacy-data-manifest');
-
-function temp(name) { return fs.mkdtempSync(path.join(os.tmpdir(), `pk-data-dir-${name}-`)); }
-function clean(dir) { fs.rmSync(dir, { recursive: true, force: true }); }
-function write(file, value = '{}') { fs.mkdirSync(path.dirname(file), { recursive: true }); fs.writeFileSync(file, value); }
-
-(() => {
-  // Resolution must be diagnostic-safe: resolving never creates the candidate.
-  const missing = path.join(temp('resolve'), 'not-created');
-  try {
-    assert.equal(dataDir.resolveDataDirPath({ dataDir: missing }), path.resolve(missing));
-    assert.equal(fs.existsSync(missing), false);
-    dataDir.ensureDataDir(missing);
-    assert.equal(fs.existsSync(missing), true);
-  } finally { clean(path.dirname(missing)); }
-
-  const legacy = temp('legacy');
-  const target = temp('target');
-  const saved = process.env.KB_DATA_DIR;
-  try {
-    write(path.join(legacy, 'projects.json'), JSON.stringify({ old: { repoPath: 'C:/legacy' } }));
-    write(path.join(legacy, 'ai-profiles.json'), JSON.stringify({ profiles: [{ id: 'primary', apiKey: 'test-secret' }] }));
-    write(path.join(legacy, 'knowledge-store.json'), JSON.stringify({ rootPath: 'C:/knowledge' }));
-    write(path.join(legacy, 'embedding-config.json'), JSON.stringify({ modelId: 'model', localModelPath: 'C:/models', localFilesOnly: true }));
-    write(path.join(legacy, 'knowledge-scopes.json'), JSON.stringify({ scopes: ['p'] }));
-    write(path.join(legacy, 'models', 'nested', 'model.onnx'), 'model-bytes');
-    // An empty target registry is non-authoritative and must not suppress legacy data.
-    write(path.join(target, 'projects.json'), '{}');
-    process.env.KB_DATA_DIR = target;
-    dataDir._resetCache();
-    const result = dataDir.migrateFromLegacy({ legacyRoot: legacy });
-    assert.equal(result.ok, true);
-    assert.equal(result.migrated, true);
-    assert.equal(JSON.parse(fs.readFileSync(path.join(target, 'projects.json'))).old.repoPath, 'C:/legacy');
-    assert.equal(JSON.parse(fs.readFileSync(path.join(target, 'ai-profiles.json'))).profiles.length, 1);
-    assert.equal(JSON.parse(fs.readFileSync(path.join(target, 'embedding-config.json'))).modelId, 'model');
-    assert.equal(fs.readFileSync(path.join(target, 'models', 'nested', 'model.onnx'), 'utf8'), 'model-bytes');
-    assert(LEGACY_ASSETS.some(asset => asset.source === 'embedding-config.json'));
-    assert(LEGACY_ASSETS.some(asset => asset.source === 'models'));
-  } finally { process.env.KB_DATA_DIR = saved; dataDir._resetCache(); clean(legacy); clean(target); }
-
-  const source = temp('conflict-source');
-  const destination = temp('conflict-destination');
-  try {
-    write(path.join(source, 'projects.json'), JSON.stringify({ old: { repoPath: 'C:/old' } }));
-    write(path.join(destination, 'projects.json'), JSON.stringify({ newer: { repoPath: 'C:/new' } }));
-    process.env.KB_DATA_DIR = destination;
-    dataDir._resetCache();
-    const result = dataDir.migrateFromLegacy({ legacyRoot: source });
-    assert.equal(result.ok, false);
-    assert.equal(result.requiresManualRecovery, true);
-    assert.equal(JSON.parse(fs.readFileSync(path.join(destination, 'projects.json'))).newer.repoPath, 'C:/new');
-  } finally { process.env.KB_DATA_DIR = saved; dataDir._resetCache(); clean(source); clean(destination); }
-
-  // The installed package can contain empty scaffolding directories (for
-  // example projects/) while the user data directory contains real projects.
-  // Empty package scaffolding is not a legacy source and must not block startup.
-  const packageRoot = temp('empty-package-root');
-  const userData = temp('existing-user-data');
-  try {
-    fs.mkdirSync(path.join(packageRoot, 'projects'), { recursive: true });
-    write(path.join(userData, 'projects', 'project-real', 'config.json'), JSON.stringify({ id: 'project-real' }));
-    process.env.KB_DATA_DIR = userData;
-    dataDir._resetCache();
-    const result = dataDir.migrateFromLegacy({ legacyRoot: packageRoot });
-    assert.equal(result.ok, true, 'empty package scaffolding must not be a migration conflict');
-    assert.equal(result.migrated, false);
-    assert.equal(result.reason, 'no legacy assets found');
-    assert.equal(fs.existsSync(path.join(userData, 'projects', 'project-real', 'config.json')), true);
-  } finally { process.env.KB_DATA_DIR = saved; dataDir._resetCache(); clean(packageRoot); clean(userData); }
-  console.log('data-dir-migration-test PASS');
-})();