@sanqianx/project-knowledge 4.7.0 → 5.0.0

package/ui/product.js

@@ -0,0 +1,412 @@
+(() => {
+  'use strict';
+  const $ = id => document.getElementById(id);
+  const all = selector => [...document.querySelectorAll(selector)];
+  const titles = { home: '智脑首页', work: '开始工作', search: '知识检索', memory: '长期记忆', projects: '领域与项目', activity: '活动记录' };
+  const modules = { terminal: 'Agent 工作台', vectorHub: '知识索引', eventBridge: '开发事件', engine: '知识引擎' };
+  const frames = {
+    terminal: { id: 'workFrame', url: '/modules/terminal/agent-terminal/?embed=1&apiBase=/api/terminal', view: 'work', ready: false },
+    vectorHub: { id: 'vectorFrame', url: '/modules/vectorhub/?embed=1&apiBase=/api/vectorhub&engineBase=/api/engine', view: 'search', ready: false },
+    eventBridge: { id: 'bridgeFrame', url: '/modules/eventbridge/?embed=1&apiBase=/api/eventbridge', view: 'activity', ready: false },
+    engine: { id: 'engineFrame', url: '/modules/engine/?embed=1&apiBase=/api/engine', ready: false },
+  };
+  const state = { brain: { id: 'brain-default', name: '我的智脑', domains: [] }, root: '', projects: [], projectId: localStorage.getItem('kb.project') || '', view: 'home', scope: 'project', memoryTab: 'confirmed', activityTab: 'updates', health: {}, snapshot: { projects: [], runs: [], events: [], memories: [] }, engineAvailable: false, epoch: 0, contexts: new Map(), stream: null, refreshing: false, importId: '', preflight: null, preflightEpoch: 0 };
+  const esc = value => String(value ?? '').replace(/[&<>"']/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c]));
+  const activeProject = () => state.projects.find(p => p.projectId === state.projectId);
+  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: '维护失败', 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, 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 });
+    return data;
+  }
+  function toast(text) { $('toast').textContent = text; $('toast').hidden = false; clearTimeout(toastTimer); toastTimer = setTimeout(() => { $('toast').hidden = true; }, 4000); }
+  function on(id, event, callback) { $(id).addEventListener(event, e => Promise.resolve(callback(e)).catch(error => toast(error.message))); }
+  function post(key, message) { const frame = frames[key]; if (frame.ready) $(frame.id).contentWindow.postMessage(message, location.origin); }
+  function initializeFrame(key) { const frame = frames[key]; if (!frame.initialized) { $(frame.id).src = frame.url; frame.initialized = true; } }
+  function frameVisible(key) { return key === 'engine' ? $('engineDialog').open : state.view === frames[key].view && (key !== 'eventBridge' || state.activityTab === 'sessions'); }
+  function frameContext(key) {
+    const project = activeProject();
+    const frame = frames[key];
+    const ref = key === 'terminal' ? project?.modules.terminal.projectId || project?.workspacePath : key === 'eventBridge' ? project?.modules.eventBridge.projectId || project?.workspacePath : project?.projectId;
+    frame.requestId = `${state.epoch}:${key}`;
+    post(key, { type: 'kb:theme', theme: document.documentElement.dataset.theme });
+    post(key, { type: 'kb:scope', scope: state.scope });
+    post(key, { type: 'kb:sidebar', visible: key === 'terminal' });
+    post(key, { type: 'kb:select-project', project: ref || '', projectId: project?.projectId || '', requestId: frame.requestId });
+    post(key, { type: 'kb:visibility', visible: frameVisible(key) });
+  }
+  function setView(view) {
+    if (!titles[view]) view = 'home';
+    state.view = view;
+    history.replaceState(null, '', `#${view}`);
+    all('[data-view]').forEach(button => button.classList.toggle('active', button.dataset.view === view));
+    all('.view').forEach(section => section.classList.toggle('active', section.id === `view-${view}`));
+    $('pageTitle').textContent = titles[view];
+    if (view === 'work' && activeProject()) initializeFrame('terminal');
+    if (view === 'search' && activeProject()) initializeFrame('vectorHub');
+    if (view === 'activity' && state.activityTab === 'sessions' && activeProject()) initializeFrame('eventBridge');
+    Object.keys(frames).forEach(key => post(key, { type: 'kb:visibility', visible: frameVisible(key) }));
+    render();
+  }
+  function selectProject(id) {
+    if (id === state.projectId && activeProject()) return;
+    state.projectId = id; state.epoch++;
+    referenceEpoch++; $('referenceDialog').close();
+    if ($('logsDialog').open) loadLogs().catch(error => toast(error.message));
+    localStorage.setItem('kb.project', id);
+    $('projectSelect').value = id;
+    Object.keys(frames).forEach(frameContext);
+    render(); setView(state.view);
+  }
+  function renderProjectOptions() {
+    $('projectSelect').innerHTML = state.projects.length ? state.projects.map(p => `<option value="${esc(p.projectId)}">${esc(p.name)}</option>`).join('') : '<option value="">尚未导入项目</option>';
+    $('projectSelect').disabled = !state.projects.length;
+    $('projectSelect').value = state.projectId;
+  }
+  function render() {
+    const project = activeProject();
+    $('brainLabel').textContent = state.brain.name; $('homeTitle').textContent = state.brain.name;
+    $('breadcrumb').textContent = project ? `${state.brain.name} / ${domainName(project.domainId)} / ${project.name}` : state.brain.name;
+    $('workEmpty').hidden = !!project; $('workLayout').hidden = !project;
+    $('searchEmpty').hidden = !!project; $('vectorFrame').parentElement.hidden = !project;
+    const candidates = state.snapshot.memories.filter(m => m.status === 'candidate');
+    $('memoryCount').textContent = candidates.length; $('memoryCount').hidden = !candidates.length; $('candidateCount').textContent = candidates.length || '';
+    if (state.view === 'home') renderHome(candidates);
+    if (state.view === 'projects') renderProjects();
+    if (state.view === 'memory') renderMemories();
+    if (state.view === 'activity') renderActivity();
+    renderContext();
+  }
+  function renderHome(candidates) {
+    if (!state.projects.length) { $('homeContent').innerHTML = '<div class="empty"><h2>从第一个项目开始</h2><p>选择代码目录和知识目录，保留项目原有文件。</p><button class="primary" data-action="import">导入第一个项目</button></div>'; return; }
+    const runs = state.snapshot.runs.filter(r => !state.projectId || r.projectId === state.projectId);
+    const issues = runs.filter(r => ['failed', 'index-pending'].includes(r.state));
+    const scopeIssues = (state.snapshot.sharedScopes || []).filter(s => s.brainId === state.brain.id && s.index?.status === 'pending');
+    const projectRows = state.projects.map(p => `<div class="row"><div><b>${esc(p.name)}</b><small>${esc(domainName(p.domainId))}</small></div>${badge(Object.values(p.modules).every(m => m.registered) ? '已连接' : '接线待恢复', Object.values(p.modules).every(m => m.registered) ? 'up' : 'issue')}<button data-select-project="${esc(p.projectId)}">打开</button></div>`).join('');
+    const updates = runs.slice(0, 5).map(r => `<div class="row"><time>${time(r.startedAt)}</time><div><b>${esc(projectName(r.projectId))}</b><small>${esc(r.commitSha.slice(0, 8))} · ${esc(label(r))}</small></div></div>`).join('') || '<p>尚无维护记录。导入时不会分析历史提交。</p>';
+    $('homeContent').innerHTML = `<div class="grid2"><div class="stack"><section class="panel"><h2>领域与项目</h2>${projectRows}</section><section class="panel"><h2>最近知识更新</h2>${state.engineAvailable ? updates : '<p>知识引擎暂时不可用，恢复后显示真实记录。</p>'}</section></div><div class="stack"><section class="panel"><h2>待确认记忆</h2>${candidates.length ? candidates.slice(0, 3).map(m => `<div class="row"><div><b>${esc(m.text)}</b><small>${esc(projectName(m.evidence.projectId))} · ${esc(m.evidence.commitSha.slice(0, 8))}</small></div></div>`).join('') + '<button data-go="memory">查看候选箱</button>' : '<p>没有待确认记忆。智脑不会自动把项目行为当作你的偏好。</p>'}</section><section class="panel"><h2>需要处理</h2>${issues.length ? issues.slice(0, 3).map(r => `<div class="row"><div><b>${esc(projectName(r.projectId))}</b><small>${esc(r.error?.message || label(r))}</small></div></div>`).join('') + '<button data-go="activity">查看运行详情</button>' : scopeIssues.length ? '' : '<p>没有待处理的维护异常。</p>'}${scopeIssues.map(s => `<div class="row"><div><b>${esc(s.name)}</b><small>${esc(s.index.message)}</small></div></div>`).join('')}${scopeIssues.length ? '<button data-action="system">检查索引连接</button>' : ''}${!state.engineAvailable ? '<p>知识引擎离线，请检查系统状态。</p>' : ''}</section></div></div>`;
+  }
+  function renderProjects() {
+    const group = (id, name) => `<h3>${esc(name)}</h3>${state.projects.filter(p => (p.domainId || '') === id).map(p => `<button class="${p.projectId === state.projectId ? 'active' : ''}" data-select-project="${esc(p.projectId)}">${esc(p.name)}</button>`).join('') || '<small>暂无项目</small>'}`;
+    $('projectTree').innerHTML = `<h2>${esc(state.brain.name)}</h2>${state.brain.domains.map(d => group(d.id, d.name)).join('')}${group('', '未分组')}`;
+    const project = activeProject();
+    if (!project) { $('projectDetail').innerHTML = '<div class="empty"><h2>尚未导入项目</h2><button class="primary" data-action="import">导入第一个项目</button></div>'; return; }
+    $('projectDetail').innerHTML = `<h2>${esc(project.name)}</h2><div class="detail-label">代码目录</div><div class="detail-path">${esc(project.workspacePath)}</div><div class="detail-label">知识目录</div><div class="detail-path">${esc(project.knowledgePath)}</div><label>所属领域<select id="projectDomain"><option value="">未分组</option>${state.brain.domains.map(d => `<option value="${esc(d.id)}" ${d.id === project.domainId ? 'selected' : ''}>${esc(d.name)}</option>`).join('')}</select></label><h3>项目连接</h3>${Object.entries(modules).map(([key, name]) => `<div class="row"><div>${esc(name)}</div>${badge(project.modules[key]?.registered ? '已连接' : '待恢复', project.modules[key]?.registered ? 'up' : 'issue')}</div>`).join('')}<div class="actions"><button class="primary" data-go="work">开始工作</button><button data-action="repair">修复接线</button><button data-action="unbind">解绑并保留数据</button></div>`;
+  }
+  function renderMemories() {
+    all('[data-memory-tab]').forEach(button => button.classList.toggle('active', button.dataset.memoryTab === state.memoryTab));
+    const memories = state.snapshot.memories.filter(m => m.status === state.memoryTab);
+    $('memoryContent').innerHTML = !state.engineAvailable ? '<div class="empty">知识引擎暂时不可用。未读取到的记忆不会显示为已确认。</div>' : memories.length ? `<div class="memory-grid">${memories.map(m => `<article class="memory-card"><p>${esc(m.text)}</p><small>${esc(projectName(m.evidence.projectId))} · commit ${esc(m.evidence.commitSha.slice(0, 8))}<br>${esc(m.evidence.entryId)}</small><div class="actions"><button data-memory-action="evidence" data-memory-id="${esc(m.id)}">查看依据</button><button data-memory-action="edit" data-memory-id="${esc(m.id)}">编辑</button>${m.status === 'candidate' ? `<button class="primary" data-memory-action="confirm" data-memory-id="${esc(m.id)}">确认</button><button data-memory-action="ignore" data-memory-id="${esc(m.id)}">忽略</button>` : badge('已确认', 'up')}</div></article>`).join('')}</div>` : `<div class="empty">${state.memoryTab === 'confirmed' ? '还没有已确认的长期记忆。' : '候选箱为空。维护产物中的有据偏好会进入这里，等待你的确认。'}</div>`;
+  }
+  function renderActivity() {
+    all('[data-activity-tab]').forEach(button => button.classList.toggle('active', button.dataset.activityTab === state.activityTab));
+    $('activityUpdates').hidden = state.activityTab !== 'updates'; $('activitySessions').hidden = state.activityTab !== 'sessions';
+    const runs = state.snapshot.runs.filter(r => r.projectId === state.projectId);
+    const open = new Set(all('.run[open]').map(d => d.dataset.runId));
+    $('activityUpdates').innerHTML = state.engineAvailable ? runs.map(r => `<details class="run" data-run-id="${esc(r.runId)}" ${open.has(r.runId) ? 'open' : ''}><summary><time>${time(r.startedAt)}</time><strong>${esc(projectName(r.projectId))} · ${esc(r.commitSha.slice(0, 8))}</strong>${badge(label(r), ['failed', 'index-pending'].includes(r.state) ? 'issue' : r.state === 'succeeded' ? 'up' : '')}</summary><div><p>提交：${esc(r.commitSha)}<br>阶段：${esc(r.phase)} · 入口：${esc(r.trigger)}<br>知识晋升：${time(r.promotedAt)} · 索引：${esc(r.indexState)}</p>${r.error ? `<p class="error">${esc(r.error.message)} (${esc(r.error.code)})</p>` : ''}${(r.staging?.operations || []).map(op => `<div class="operation">${esc(op.operation)} · ${esc(op.path)}<br>${esc(op.reason)}</div>`).join('')}${['failed', 'index-pending'].includes(r.state) ? `<button data-retry-run="${esc(r.runId)}">重试失败阶段</button>` : ''}</div></details>`).join('') || '<div class="empty">当前项目还没有知识维护记录。</div>' : '<div class="empty">知识引擎离线。记录仍保留在本机，连接恢复后自动读取。</div>';
+  }
+  function renderContext() {
+    const saved = state.contexts.get(state.projectId);
+    const context = saved?.status === 'not-retrieved' ? null : saved;
+    $('contextScope').textContent = context ? ({ ready: '已检索知识', 'file-fallback': '索引暂不可用，已检索原文件', unavailable: '知识服务不可用，未注入上下文', unregistered: '项目尚未登记知识库', disabled: '未启用知识连接' })[context.status] || '本次任务上下文' : '任务发送前自动检索';
+    $('contextContent').classList.toggle('small-empty', !context?.references?.length);
+    const seen = new Set();
+    const references = (context?.references || []).map((r, index) => ({ ...r, index })).filter(r => { const key = `${r.spaceId}:${r.projectId}:${r.entryId}:${r.commitSha || ''}`; if (seen.has(key)) return false; seen.add(key); return true; });
+    $('contextContent').classList.toggle('empty', !references.length);
+    $('contextContent').innerHTML = references.length ? references.map(r => `<button class="reference" data-context-index="${r.index}"><b>${esc(r.title)}</b><small>${esc(projectName(r.projectId))} / ${esc(r.entryId)}${r.commitSha ? ` · ${esc(r.commitSha.slice(0, 8))}` : ''}</small><p>${esc(r.text.slice(0, 180))}</p></button>`).join('') : context ? '本次任务未找到可引用的知识。' : '发送任务后显示实际检索到的项目事实、领域经验和已确认记忆。';
+  }
+  async function openReference(reference) {
+    const id = state.projectId;
+    const epoch = ++referenceEpoch;
+    $('referenceTitle').textContent = reference.title || reference.entryId;
+    $('referenceMeta').textContent = `${projectName(reference.projectId)} / ${reference.entryId}${reference.commitSha ? ` · commit ${reference.commitSha}` : ''}`;
+    $('referenceContent').textContent = reference.text || '读取知识文件…'; $('referenceDialog').showModal();
+    if (reference.entryId) {
+      const result = await api('/api/engine/get', { method: 'POST', body: { projectId: state.projects.some(p => p.projectId === reference.projectId) ? reference.projectId : id, spaceId: reference.spaceId, entryId: reference.entryId } });
+      if (epoch === referenceEpoch && id === state.projectId && $('referenceDialog').open) $('referenceContent').textContent = result.chunks.map(c => c.chunk_text).join('\n');
+    }
+  }
+  async function refreshSnapshot() {
+    const epoch = ++snapshotEpoch;
+    try { const snapshot = await api('/api/engine/snapshot'); if (epoch !== snapshotEpoch || !navigator.onLine) return; state.snapshot = snapshot; state.engineAvailable = true; }
+    catch { if (epoch !== snapshotEpoch) return; state.engineAvailable = false; }
+    render();
+  }
+  function scheduleRefresh() { if (!navigator.onLine) return; clearTimeout(refreshTimer); refreshTimer = setTimeout(() => { refreshSnapshot(); post('eventBridge', { type: 'kb:refresh' }); }, 160); }
+  function connectProgress() {
+    if (!navigator.onLine || !state.health.engine?.up || state.stream) return;
+    const stream = new EventSource('/api/engine/progress'); state.stream = stream;
+    stream.addEventListener('snapshot', () => { if (state.stream !== stream) return; $('activityConnection').textContent = '已连接实时更新'; scheduleRefresh(); });
+    stream.addEventListener('progress', () => { if (state.stream === stream) scheduleRefresh(); });
+    stream.onerror = () => { if (state.stream === stream) $('activityConnection').textContent = '连接中断，正在恢复快照'; };
+  }
+  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 { 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 || '服务恢复后自动重试。'}${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 = '网页连接中断';
+      $('systemDetail').textContent = '恢复连接后自动读取状态，后台维护不受影响。';
+      $('moduleHealth').innerHTML = '<p>当前网页无法确认服务状态，连接恢复后重新读取。</p>';
+    }
+  }
+  async function openSystem() {
+    $('systemDrawer').hidden = false; $('drawerBackdrop').hidden = false;
+    $('brainName').value = state.brain.name; $('knowledgeRoot').value = state.root;
+    await loadMaintenance();
+  }
+  async function loadLogs() {
+    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 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} 条诊断记录 · 当前项目`;
+    if (!$('logsSearch').value.trim()) {
+      const streamParams = new URLSearchParams({ streamCursor: result.streamCursor || '' });
+      if (state.projectId) 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); });
+    }
+  }
+  function appendLog(record) {
+    const row = document.createElement('details'); row.className = 'log-entry';
+    row.dataset.level = record.level;
+    const summary = document.createElement('summary'); summary.className = 'row';
+    const date = document.createElement('time'); date.textContent = time(record.ts || record.at);
+    const text = document.createElement('pre'); text.textContent = record.message || '';
+    const detail = document.createElement('pre'); detail.className = 'log-detail';
+    detail.textContent = JSON.stringify(record, null, 2);
+    summary.append(date, text); row.append(summary, detail); $('logsContent').append(row);
+    while ($('logsContent').childElementCount > 100) $('logsContent').firstElementChild.remove();
+  }
+  function closeSystem() {
+    $('systemDrawer').hidden = true; $('drawerBackdrop').hidden = true;
+    if (resumeImport) {
+      resumeImport = false;
+      $('importDialog').showModal();
+      checkImport().catch(error => toast(error.message));
+    }
+  }
+  async function loadMaintenance() {
+    try {
+      const [profiles, saved] = await Promise.all([api('/api/terminal/profiles'), api('/api/terminal/maintenance-default')]);
+      const list = Array.isArray(profiles) ? profiles : profiles.profiles || [];
+      $('maintenanceModel').innerHTML = '<option value="">尚未选择后台默认模型</option>' + list.filter(p => p.enabled && p.credentialConfigured).map(p => `<option value="${esc(p.id)}">${esc(p.name)} · ${esc(p.models.default)}</option>`).join('');
+      $('maintenanceModel').value = saved.profileId || '';
+      $('configurationStatus').textContent = saved.profileId ? '此默认模型仅用于后台维护。' : '先配置供应商，再选择后台默认模型。';
+      const embedding = await api('/api/terminal/embedding-config');
+      $('embeddingStatus').textContent = embedding.configured ? `已配置 · ${embedding.config.model}` : '未配置，使用文本检索降级。';
+      const capture = (await api('/api/terminal/health')).conversationCapture;
+      $('captureStatus').textContent = !capture ? '工作台对话接线尚未启用。' : capture.error ? `工作台对话待恢复 · ${capture.pending} 条事件保留在本机，请检查接线。` : capture.pending ? `工作台对话正在同步 · ${capture.pending} 条待写入。` : capture.enabled ? '工作台对话自动保存到开发会话记录。' : '工作台对话捕获已关闭。';
+    } catch { $('maintenanceModel').innerHTML = '<option value="">工作台暂时不可用</option>'; $('configurationStatus').textContent = '无法读取模型配置，请恢复工作台服务。'; }
+  }
+  async function openEmbedding() {
+    const [profiles, embedding] = await Promise.all([api('/api/terminal/profiles'), api('/api/terminal/embedding-config')]);
+    const list = Array.isArray(profiles) ? profiles : profiles.profiles || [];
+    $('embeddingProfile').innerHTML = '<option value="">独立凭据</option>' + list.filter(p => p.enabled && p.credentialConfigured).map(p => `<option value="${esc(p.id)}">${esc(p.name)}</option>`).join('');
+    const saved = embedding.config || {};
+    $('embeddingProfile').value = saved.profileId || '';
+    $('embeddingProvider').value = saved.provider || 'minimax';
+    $('embeddingModel').value = saved.model || 'embo-01';
+    $('embeddingEndpoint').value = saved.endpoint || '';
+    $('embeddingSecret').value = '';
+    $('embeddingSecretLabel').hidden = !!saved.profileId;
+    $('embeddingFeedback').textContent = embedding.configured ? '配置已保存。留空凭据不会覆盖现有密钥。' : '向量检索尚未配置。';
+    closeSystem(); $('embeddingDialog').showModal();
+  }
+  async function saveEmbedding(enabled = true) {
+    const body = enabled ? { provider: $('embeddingProvider').value, model: $('embeddingModel').value, endpoint: $('embeddingEndpoint').value, profileId: $('embeddingProfile').value || null, secret: $('embeddingSecret').value } : { enabled: false };
+    await api('/api/terminal/embedding-config', { method: 'PUT', body });
+    $('embeddingSecret').value = '';
+    const result = await api('/api/modules/configure', { method: 'POST', body: {} });
+    $('embeddingFeedback').textContent = !enabled ? '已停用向量模型，知识文件保留。' : result.configuration.embedding ? '已保存并同步到向量检索服务。' : '配置已保存，向量服务待恢复。请检查模块连接。';
+    await loadMaintenance();
+  }
+  async function repair() {
+    const project = activeProject(); if (!project) return toast('请先导入项目。');
+    const result = await api(`/api/projects/${encodeURIComponent(project.projectId)}/module-register`, { method: 'POST', body: {} });
+    const pending = Object.entries(result.modules).filter(([, v]) => !v.ok).map(([key]) => modules[key]);
+    $('wiringFeedback').textContent = pending.length ? `项目已登记，待恢复：${pending.join('、')}` : '四个模块已连接。';
+    toast($('wiringFeedback').textContent); await refreshRegistry(); Object.keys(frames).forEach(frameContext);
+  }
+  async function pick(target) {
+    const result = await api('/api/terminal/system/pick-folder');
+    if (result.cancelled || !result.path) return;
+    $(target).value = result.path; $(target).dispatchEvent(new Event('input', { bubbles: true }));
+  }
+  function openImport() {
+    resumeImport = false; $('setupImportRoot').hidden = true;
+    $('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; $('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, 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;
+    $('setupImportRoot').hidden = true;
+    if (!$('importCode').value.trim()) return;
+    $('preflightStatus').textContent = '正在检查目录、仓库与接线条件…';
+    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; $('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 || 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 => {
+    const button = e.target.closest('button'); if (!button) return;
+    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 === '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(); }
+      if (button.dataset.activityTab) { state.activityTab = button.dataset.activityTab; setView('activity'); post('eventBridge', { type: 'kb:visibility', visible: state.activityTab === 'sessions' }); post('eventBridge', { type: 'kb:refresh' }); }
+      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 && !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) {
+        const memory = state.snapshot.memories.find(m => m.id === button.dataset.memoryId); if (!memory) return;
+        const action = button.dataset.memoryAction;
+        if (action === 'evidence') await openReference({ ...memory.evidence, text: memory.evidence.quote, title: '记忆来源依据' });
+        else if (action === 'edit') { editingMemoryId = memory.id; $('memoryText').value = memory.text; $('memoryEvidence').textContent = `${projectName(memory.evidence.projectId)} · ${memory.evidence.commitSha.slice(0, 8)} / ${memory.evidence.entryId}`; $('memoryDialog').showModal(); }
+        else { await api(`/api/engine/memories/${encodeURIComponent(memory.id)}`, { method: 'PATCH', body: { status: action === 'confirm' ? 'confirmed' : 'ignored' } }); await refreshSnapshot(); }
+      }
+    };
+    execute().catch(error => toast(error.message));
+  });
+  document.addEventListener('change', e => { if (e.target.id === 'projectDomain') api(`/api/projects/${encodeURIComponent(state.projectId)}`, { method: 'PATCH', body: { domainId: e.target.value || null } }).then(refreshRegistry).catch(error => toast(error.message)); });
+  window.addEventListener('message', event => {
+    if (event.origin !== location.origin || !event.data || typeof event.data !== 'object') return;
+    const key = Object.keys(frames).find(k => $(frames[k].id).contentWindow === event.source); if (!key) return;
+    const message = event.data;
+    if (message.type === 'kb:ready') { frames[key].ready = true; frameContext(key); if (frames[key].openSettings) { post(key, { type: 'kb:open-settings' }); frames[key].openSettings = false; } }
+    if (message.requestId && message.requestId !== frames[key].requestId) return;
+    if (message.type === 'kb:knowledge' && key === 'terminal') {
+      const project = state.projects.find(p => p.modules.terminal.projectId === message.projectId);
+      if (project) { state.contexts.set(project.projectId, message.knowledge); if (project.projectId === state.projectId) renderContext(); }
+    }
+  });
+  on('projectSelect', 'change', e => selectProject(e.target.value));
+  on('themeToggle', 'click', () => { document.documentElement.dataset.theme = document.documentElement.dataset.theme === 'dark' ? 'light' : 'dark'; localStorage.setItem('kb.theme', document.documentElement.dataset.theme); Object.keys(frames).forEach(key => post(key, { type: 'kb:theme', theme: document.documentElement.dataset.theme })); });
+  on('openSystem', 'click', openSystem); on('closeSystem', 'click', closeSystem); on('drawerBackdrop', 'click', closeSystem);
+  on('repairWiring', 'click', repair);
+  on('configureProviders', 'click', () => { closeSystem(); setView('work'); initializeFrame('terminal'); if (frames.terminal.ready) post('terminal', { type: 'kb:open-settings' }); else frames.terminal.openSettings = true; });
+  on('saveMaintenance', 'click', async () => { await api('/api/terminal/maintenance-default', { method: 'PUT', body: { profileId: $('maintenanceModel').value || null } }); const result = await api('/api/modules/configure', { method: 'POST', body: {} }); $('configurationStatus').textContent = result.configuration.model ? '后台默认模型已保存并同步。' : '配置已保存，后台运行配置尚未同步，请检查模块连接。'; });
+  on('openEmbedding', 'click', openEmbedding);
+  on('embeddingProfile', 'change', () => { $('embeddingSecretLabel').hidden = !!$('embeddingProfile').value; });
+  on('embeddingProvider', 'change', () => { $('embeddingModel').value = $('embeddingProvider').value === 'minimax' ? 'embo-01' : 'text-embedding-3-small'; });
+  on('embeddingForm', 'submit', async event => { event.preventDefault(); await saveEmbedding(); });
+  on('disableEmbedding', 'click', () => saveEmbedding(false));
+  on('embeddingDialog', 'close', () => { $('embeddingSecret').value = ''; });
+  on('saveBrainSettings', 'click', async () => { await api('/api/brain', { method: 'PATCH', body: { name: $('brainName').value } }); await api('/api/settings', { method: 'PATCH', body: { knowledge: { rootPath: $('knowledgeRoot').value } } }); toast('设置已保存，已有知识未移动。'); await refreshRegistry(); if (resumeImport) closeSystem(); });
+  on('setupImportRoot', 'click', async () => { $('importDialog').close(); resumeImport = true; await openSystem(); $('knowledgeRoot').focus(); });
+  on('pickRoot', 'click', () => pick('knowledgeRoot')); on('pickCode', 'click', () => pick('importCode')); on('pickKnowledge', 'click', () => pick('importKnowledge'));
+  on('openEngine', 'click', () => { closeSystem(); initializeFrame('engine'); $('engineDialog').showModal(); post('engine', { type: 'kb:visibility', visible: true }); });
+  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('copyReference', 'click', async () => {
+    const text = $('referenceMeta').textContent + '\n\n' + $('referenceContent').textContent;
+    try { await navigator.clipboard.writeText(text); }
+    catch { const field = document.createElement('textarea'); field.value = text; document.body.append(field); field.select(); const copied = document.execCommand('copy'); field.remove(); if (!copied) throw new Error('复制失败，请选择引用内容手动复制。'); }
+    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('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 || 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(); }
+  });
+  window.addEventListener('hashchange', () => setView(location.hash.slice(1)));
+  window.addEventListener('offline', () => {
+    snapshotEpoch++; clearTimeout(refreshTimer);
+    state.stream?.close(); state.stream = null; logStream?.close(); logStream = null; logEpoch++;
+    state.engineAvailable = false; $('activityConnection').textContent = '连接中断，恢复后自动读取快照';
+    renderSystem(); render();
+  });
+  window.addEventListener('online', () => {
+    $('activityConnection').textContent = '正在恢复快照'; refreshRegistry();
+    if ($('logsDialog').open) loadLogs().catch(error => toast(error.message));
+  });
+  window.addEventListener('beforeunload', () => { state.stream?.close(); logStream?.close(); });
+  document.addEventListener('keydown', e => { if (e.key === 'Escape') closeSystem(); });
+  document.documentElement.dataset.theme = localStorage.getItem('kb.theme') === 'dark' ? 'dark' : 'light';
+  all('[data-scope]').forEach(button => button.classList.toggle('active', button.dataset.scope === state.scope));
+  state.view = titles[location.hash.slice(1)] ? location.hash.slice(1) : 'home';
+  setView(state.view); refreshRegistry();
+  setInterval(() => { if (!document.hidden) refreshRegistry(); }, 30000);
+})();

package/vendor-manifest.json

@@ -0,0 +1,45 @@
+{
+  "schema": "project-knowledge/vendor-runtime/v1",
+  "modules": {
+    "knowledge-engine": {
+      "name": "@sanqianx/ai-coding-knowledge-engine",
+      "version": "0.2.0",
+      "root": "_modules/knowledge-engine",
+      "files": {
+        "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": "e85f1f604d2090bd466244d73cf8e1862e0cbe436e62d4a2f7193afd2fac7843",
+        "src/headless-analyzer.js": "2473b28d4bf06088abbcafa21d491560a9ca0ab100024c912a36bc6f981d8576",
+        "src/memories.js": "0a8667e6daba99fa5022393951a28e96cdadf98af85b6af9a6be96c7f4e896fc",
+        "src/retrieval.js": "acbf76bb93fd13dac391c2e918891a56ace869db5583d2a5994641b6782496d6",
+        "src/runtime/README.md": "9be676eca76a7857b34d7357194e6f0ee733c22e61d962d53984715dbec7f673",
+        "src/runtime/atomic-file.js": "9846b4b69db5ded811acf19a1181ef93615d93efaa542b858e552a7f3124ad23",
+        "src/runtime/automation-config.js": "6498c5397be12b155829740595a1553d4dcd6eaa7db6ced3ef88fdc60218f00e",
+        "src/runtime/commit-conversation-binder.js": "4f5a7a13c3dfac3765ad70e54de351f5d81e0ed4b2b2d7ecb90ef77cb29e0c15",
+        "src/runtime/commit-processing-ledger.js": "455aa1ac4e212c0b63d9df99e49aa94703cd24145e41aa9794f16274b2ec2e18",
+        "src/runtime/commit-prompt.js": "11856175a405c00514add6a540324a0efe3d7e5dd872c9e8a0b77f9f40abc551",
+        "src/runtime/commit-reconciler.js": "27a894ac7588701fc56e19811cbf266664357e8ac9beb9ffc4eccfc1f8e75b46",
+        "src/runtime/content-hash.js": "201ee7dcc054310f14097a00058cf9b28fa913367eef616e0fdd8facbf3c6c41",
+        "src/runtime/contracts.js": "567fbace85ad0534fb0119f5c0e57d73acc0b76cc799af93d778c5ecbade53df",
+        "src/runtime/conversation-exclusions.js": "ef8545034b862d384fb460140490bb531b58d94992f5e2222ebaaa079b44fa63",
+        "src/runtime/conversation-store.js": "8ea0135588e40dfe0bab0288220a0fb481a470855558ae38b8274d57ce55fc39",
+        "src/runtime/evidence-bundle.js": "33d4614849d5e1d69aba8b75c3a43c18b7b6f94e5c78654c82ef631331cc94cc",
+        "src/runtime/git-runner.js": "b74fe197bd4dcf3e70635ef7b1f2615edf965c1d9a3ffe5406aabd41b76d74a9",
+        "src/runtime/knowledge-promotion.js": "c24aba505caf11cdc8faba763beffc65956c1330ef28ed5fbd6ae16eac640fa6",
+        "src/runtime/knowledge-retrieval-service.js": "75444f495a9ad0720af0e57b8d27d7ac1325c78a768f4f68ebd86ebc2524945e",
+        "src/runtime/layout.js": "c48fa1db62e5df1edefe13218e470c5ceea4ef2781293512c2c18e5c2ba0c7e9",
+        "src/runtime/markdown-knowledge-indexer.js": "44a76a9adefad07e78f77b1106b10d6c1cc7873d76362df4c546892b21f3939c",
+        "src/runtime/scanner.js": "d99fa8d74a6fbbaae75ca49f62127e14cf9e48b1404e4b4d597ef39df5441410",
+        "src/server.js": "e7f0b07b7a8cf2623690b9d2d23492f2c95737dc974adfeea049610a4b5ded55",
+        "src/store.js": "71f0417c2c1e42b89429e3dee1adff7b2c09e86682cb3f4843ce6d9e5aafd7ec",
+        "ui/app.css": "7ad370c269e60a7b5ec907d81a607b2d16bd07b2d7c22a81f102dab51eeb2889",
+        "ui/app.js": "91ee6d8c31712e6af46de2eecbd72bbc5236c06b7cd055800831e7d57f84a0be",
+        "ui/index.html": "ce3565cfefd4838b11d37a91a906ef26ca5a1834844fe3f7c897b56851a3c418"
+      }
+    }
+  }
+}

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');
-})();