@sanqianx/project-knowledge 4.7.0 → 5.0.0

package/_site/_test/task15-20-ui-flow-test.js

@@ -1,148 +0,0 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawnServer } = require('./helpers/spawn-server');
-const { findChrome } = require('./helpers/find-chrome');
-const { launchCdpBrowser, requestJson, waitFor } = require('./helpers/cdp-browser');
-const { createLoggingUiFixture } = require('./helpers/logging-ui-fixture');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const sitePort = 8200 + (process.pid % 250);
-const profileDir = path.join(os.tmpdir(), 'pk-ui-flow-profile-' + process.pid);
-const artifactDir = path.join(ROOT, '.agent-state', 'ui-v13');
-
-async function capture(browser, name) {
-  const filePath = path.join(artifactDir, name + '.png');
-  await browser.screenshot(filePath);
-  assert(fs.statSync(filePath).size > 10000, `screenshot ${name} must contain rendered UI`);
-}
-
-(async () => {
-  const fixture = await createLoggingUiFixture({ totalLogs: 240 });
-  const server = spawnServer({ root: ROOT, port: sitePort, dataDir: fixture.dataDir, tag: 'ui-flow-v13', stdio: 'ignore' });
-  let browser;
-  try {
-    await waitFor(() => requestJson(`http://127.0.0.1:${sitePort}/api/health`).then(body => body.ok), 'flow server', 20000);
-    browser = await launchCdpBrowser({ chrome: findChrome(), profileDir, url: `http://127.0.0.1:${sitePort}/`, width: 1366, height: 768 });
-    await waitFor(() => browser.evaluate('window.__PK_APP__ && window.__PK_APP__.getState().projects === 1'), 'full shell', 20000);
-
-    await browser.setViewport(1920, 1080);
-    await capture(browser, '01-main-shell-1920-light');
-    // T2: 聊天由内嵌终端提供 —— 壳断言嵌入视图与 iframe 挂载
-    assert.strictEqual(await browser.evaluate("document.getElementById('view-terminal').classList.contains('active')"), true);
-    assert.strictEqual(await browser.evaluate("document.getElementById('fr-5760').src.includes('/agent-terminal/')"), true);
-    await capture(browser, '02-terminal-embed-1920-light');
-
-    await browser.evaluate("document.querySelector('[data-go=\"import\"]').click()");
-    assert.strictEqual(await browser.evaluate("document.getElementById('import-path').required"), true);
-    assert.strictEqual(await browser.evaluate("document.querySelectorAll('#import-knowledge-path').length"), 1, 'Import takes an explicit knowledge address (T3.2)');
-    await capture(browser, '03-import-1920-light');
-
-    // 开发对话已迁移到 ai-coding-event-bridge 模块：设置抽屉只有日志一节
-    await browser.evaluate("window.__PK_APP__.openSettings()");
-    await waitFor(() => browser.evaluate("document.getElementById('settings-logs').classList.contains('active')"), 'logs settings');
-    assert.strictEqual(await browser.evaluate("document.querySelectorAll('[data-settings]').length"), 1, 'settings drawer must only expose logs (conversation moved to event-bridge module)');
-    await capture(browser, '04-settings-logs-1920-light');
-
-    await browser.setViewport(1366, 768);
-    await browser.evaluate("window.__PK_APP__.showSettings('logs')");
-    // 等 DOM 实际渲染出全部行（loadLogs 先清空再异步渲染，只看内存状态会撞上清空间隙）
-    await waitFor(() => browser.evaluate('window.__PK_APP__.getState().logCount >= 240 && document.querySelectorAll(".record-row").length >= 240'), '200+ log rows', 20000);
-    const auditLogs = () => browser.evaluate(`(() => {
-      const rows = [...document.querySelectorAll('.record-row')];
-      const drawer = document.getElementById('settings-drawer');
-      const list = document.getElementById('record-list');
-      const card = document.querySelector('.logs-card').getBoundingClientRect();
-      const content = document.querySelector('.settings-content').getBoundingClientRect();
-      const overlaps = rows.filter(row => {
-        const body = row.querySelector('.record-main').getBoundingClientRect();
-        const time = row.querySelector('.record-time').getBoundingClientRect();
-        return body.right + 8 > time.left;
-      }).length;
-      const scrollables = [...drawer.querySelectorAll('*')].filter(node => {
-        const style = getComputedStyle(node);
-        return /(auto|scroll)/.test(style.overflowY) && node.scrollHeight > node.clientHeight + 1;
-      }).map(node => node.id || node.className);
-      const colorParts = level => {
-        const row = document.querySelector('.record-entry[data-level=' + level + '] .record-row');
-        return row ? [row, row.querySelector('.record-title'), row.querySelector('.record-meta'), row.querySelector('.record-time')].map(node => getComputedStyle(node).color) : [];
-      };
-      return {
-        rows: rows.length,
-        overlaps,
-        scrollables,
-        maxHeight: getComputedStyle(list).maxHeight,
-        listOverflow: getComputedStyle(list).overflowY,
-        cardBottomGap: Math.round(content.bottom - card.bottom),
-        warnColors: colorParts('warn'),
-        errorColors: colorParts('error'),
-        severityMarks: document.querySelectorAll('.record-entry svg, .record-entry img, .record-entry .dot, .record-entry .severity').length,
-        pageOverflow: document.body.scrollWidth > document.documentElement.clientWidth + 1,
-        recordHeight: document.querySelector('.record-shell').getBoundingClientRect().height,
-      };
-    })()`);
-    const desktopLogs = await auditLogs();
-    assert(desktopLogs.rows >= 240);
-    assert.strictEqual(desktopLogs.overlaps, 0, 'message/meta must never overlap the fixed time column');
-    assert.deepStrictEqual(desktopLogs.scrollables, ['record-list'], 'record-list must be the only vertical scroller in the active logs drawer');
-    assert(desktopLogs.maxHeight === 'none');
-    assert.strictEqual(desktopLogs.listOverflow, 'auto');
-    assert(desktopLogs.cardBottomGap <= 23, 'logs card must reach the settings content bottom');
-    assert(desktopLogs.warnColors.length === 4 && new Set(desktopLogs.warnColors).size === 1, 'warn message/meta/time must share whole-row color');
-    assert(desktopLogs.errorColors.length === 4 && new Set(desktopLogs.errorColors).size === 1, 'error message/meta/time must share whole-row color');
-    assert.strictEqual(desktopLogs.severityMarks, 0);
-    assert.strictEqual(desktopLogs.pageOverflow, false);
-
-    await browser.evaluate("document.querySelector('.record-entry[data-level=error] .record-row').click()");
-    assert.strictEqual(await browser.evaluate("document.querySelector('.record-entry[data-level=error]').classList.contains('open')"), true);
-    await capture(browser, '07-logs-1366x768-expanded-light');
-    await browser.evaluate("document.getElementById('record-list').scrollTop = 0");
-    await browser.evaluate("fetch('/api/health?ui-sse=' + Date.now()).then(response => response.json())");
-    await waitFor(() => browser.evaluate('window.__PK_APP__.getState().newLogs > 0'), 'new-record banner', 20000);
-    assert.strictEqual(await browser.evaluate("document.getElementById('new-records').hidden"), false);
-    assert.strictEqual(await browser.evaluate("document.getElementById('record-list').scrollTop"), 0, 'SSE append must not steal a scrolled-up position');
-    await capture(browser, '08-logs-scrolled-new-banner-light');
-    await browser.evaluate("document.getElementById('new-records').click()");
-    await waitFor(() => browser.evaluate("window.__PK_APP__.getState().newLogs === 0 && document.getElementById('record-list').scrollHeight - document.getElementById('record-list').scrollTop - document.getElementById('record-list').clientHeight < 2"), 'return to log bottom');
-
-    await browser.setViewport(1920, 1080);
-    const tallLogs = await auditLogs();
-    assert(tallLogs.recordHeight > desktopLogs.recordHeight + 200, 'record shell must grow with viewport height');
-    await browser.evaluate("document.getElementById('theme-button').click()");
-    assert.strictEqual(await browser.evaluate('document.documentElement.dataset.theme'), 'dark');
-    await capture(browser, '09-logs-1920x1080-dark');
-
-    await browser.setViewport(820, 900);
-    const narrowLogs = await auditLogs();
-    assert.strictEqual(narrowLogs.overlaps, 0);
-    assert.strictEqual(narrowLogs.pageOverflow, false);
-    await capture(browser, '10-logs-820x900-dark');
-
-    await browser.setViewport(390, 844);
-    const mobileLogs = await auditLogs();
-    assert.strictEqual(mobileLogs.overlaps, 0);
-    assert.strictEqual(mobileLogs.pageOverflow, false);
-    assert.strictEqual(await browser.evaluate("getComputedStyle(document.querySelector('.settings-nav')).flexDirection"), 'row');
-    await capture(browser, '11-mobile-logs-390x844-dark');
-
-    await browser.evaluate(`(() => {
-      window.__PK_APP__.showSettings('logs');
-      const card = document.querySelector('#project-list .project-card');
-      card.dispatchEvent(new MouseEvent('contextmenu', { bubbles: true, cancelable: true, clientX: 100, clientY: 300 }));
-    })()`);
-    await waitFor(() => browser.evaluate("document.getElementById('context-menu').classList.contains('show')"), 'mobile context menu');
-    await browser.evaluate("document.getElementById('remove-project').click()");
-    await waitFor(() => browser.evaluate("document.getElementById('delete-dialog').open"), 'project delete modal');
-    await capture(browser, '13-mobile-delete-modal-dark');
-    assert.strictEqual(browser.exceptions.length, 0, 'browser runtime exceptions: ' + JSON.stringify(browser.exceptions));
-    console.log('task15-20 UI flow test PASS');
-  } finally {
-    if (browser) await browser.close();
-    await server.cleanup();
-    fixture.cleanup();
-  }
-})().catch(error => {
-  console.error(error.stack || error.message);
-  process.exitCode = 1;
-});

package/_site/_test/ui-i18n-toggle-test.js

@@ -1,114 +0,0 @@
-// _site/_test/ui-i18n-toggle-test.js
-//
-// T10: UI language toggle + persistence + smoke check that key labels
-// actually change after switching zh-CN -> en-US. The test boots a real
-// server, drives a headless Chromium, and inspects label textContent.
-
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawnServer } = require('./helpers/spawn-server');
-const { findChrome } = require('./helpers/find-chrome');
-const { launchCdpBrowser, waitFor } = require('./helpers/cdp-browser');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const sitePort = 7980 + (process.pid % 200);
-const profileDir = path.join(os.tmpdir(), 'pk-i18n-' + process.pid);
-
-async function waitForLanguage(browser, language, label) {
-  await waitFor(async () => {
-    const state = await browser.evaluate(`(() => ({
-      appReady: Boolean(window.__PK_APP__),
-      active: window.I18N && window.I18N.activeLanguage(),
-      select: document.getElementById('ui-language')?.value,
-      documentLanguage: document.documentElement.lang,
-    }))()`);
-    return state.appReady && state.active === language && state.select === language && state.documentLanguage === (language === 'en-US' ? 'en' : 'zh-CN')
-      ? { ok: true }
-      : null;
-  }, label, 20000);
-}
-
-(async () => {
-  const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-i18n-data-' + process.pid + '-'));
-  const server = spawnServer({
-    root: ROOT, port: sitePort, dataDir, tag: 'ui-i18n', stdio: 'ignore',
-    extraEnv: { KB_SKIP_MIGRATION: '1' },
-  });
-  let browser;
-  try {
-    await waitFor(async () => {
-      try {
-        const r = await fetch(`http://127.0.0.1:${sitePort}/api/health`);
-        return r.ok ? { ok: true } : null;
-      } catch { return null; }
-    }, 'isolated server', 20000);
-    browser = await launchCdpBrowser({
-      chrome: findChrome(), profileDir, url: `http://127.0.0.1:${sitePort}/`, width: 1440, height: 900,
-    });
-    // Wait for i18n.js to be available on window
-    await waitFor(async () => {
-      const ready = await browser.evaluate('Boolean(window.I18N)');
-      return ready ? { ok: true } : null;
-    }, 'window.I18N available', 20000);
-
-    // Case 1: default language is zh-CN.
-    {
-      const lang = await browser.evaluate('window.I18N.activeLanguage()');
-      assert.strictEqual(lang, 'zh-CN', 'default language must be zh-CN when no preference exists');
-    }
-
-    // Case 2: switch to en-US via the settings drawer toggle.
-    await browser.evaluate(`(() => {
-      // Open settings drawer (data-settings='ai' button)
-      const btn = document.querySelector('[data-settings="ai"]') || document.getElementById('open-settings');
-      if (btn) btn.click();
-    })()`);
-    await waitFor(async () => {
-      const open = await browser.evaluate('Boolean(document.getElementById("ui-language"))');
-      return open ? { ok: true } : null;
-    }, 'ui-language select visible', 5000);
-    await browser.evaluate(`(() => {
-      const sel = document.getElementById('ui-language');
-      sel.value = 'en-US';
-      sel.dispatchEvent(new Event('change', { bubbles: true }));
-    })()`);
-    await waitForLanguage(browser, 'en-US', 'language switched to en-US');
-    assert.strictEqual(await browser.evaluate('document.querySelector("label[for=ui-language]").textContent'), 'UI language');
-
-    // Case 3: persistence across reload — preference must survive a hard
-    // reload. The browser context keeps localStorage across reloads.
-    await browser.evaluate('location.reload()');
-    await waitForLanguage(browser, 'en-US', 'language persists after reload');
-
-    // Case 4: switch back to zh-CN and verify activeLanguage reflects it.
-    await browser.evaluate(`(() => {
-      document.getElementById('ui-language').value = 'zh-CN';
-      document.getElementById('ui-language').dispatchEvent(new Event('change', { bubbles: true }));
-    })()`);
-    await waitForLanguage(browser, 'zh-CN', 'switch back to zh-CN');
-    assert.strictEqual(await browser.evaluate('document.querySelector("label[for=ui-language]").textContent'), '界面语言');
-
-    // Case 5: unknown key returns the key string (no missing-key placeholder).
-    {
-      const missing = await browser.evaluate('window.I18N.t("does.not.exist")');
-      assert.strictEqual(missing, 'does.not.exist', 'unknown keys must return the key string, not a placeholder');
-    }
-
-    // Case 6: availableLanguages contains both zh-CN and en-US.
-    {
-      const list = await browser.evaluate('window.I18N.availableLanguages().sort().join(",")');
-      assert.strictEqual(list, 'en-US,zh-CN', 'availableLanguages must include zh-CN and en-US');
-    }
-  } finally {
-    if (browser) await browser.close();
-    server.child.kill();
-    await new Promise(resolve => server.child.once('exit', resolve));
-    fs.rmSync(dataDir, { recursive: true, force: true });
-  }
-  console.log('ui-i18n-toggle-test PASS');
-})().catch(error => {
-  console.error(error.stack || error.message);
-  process.exit(1);
-});

package/_site/_test/ui-smoke-test.js

@@ -1,73 +0,0 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawnServer } = require('./helpers/spawn-server');
-const { findChrome } = require('./helpers/find-chrome');
-const { launchCdpBrowser, requestJson, waitFor } = require('./helpers/cdp-browser');
-const { createLoggingUiFixture } = require('./helpers/logging-ui-fixture');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const sitePort = 7900 + (process.pid % 300);
-const profileDir = path.join(os.tmpdir(), 'pk-ui-smoke-profile-' + process.pid);
-const screenshotPath = path.join(os.tmpdir(), 'pk-ui-smoke-' + process.pid + '.png');
-
-(async () => {
-  const fixture = await createLoggingUiFixture({ totalLogs: 18 });
-  const server = spawnServer({ root: ROOT, port: sitePort, dataDir: fixture.dataDir, tag: 'ui-smoke-v13', stdio: 'ignore' });
-  let browser;
-  try {
-    await waitFor(() => requestJson(`http://127.0.0.1:${sitePort}/api/health`).then(payload => payload.ok), 'isolated server', 20000);
-    browser = await launchCdpBrowser({ chrome: findChrome(), profileDir, url: `http://127.0.0.1:${sitePort}/`, width: 1440, height: 900 });
-    await waitFor(() => browser.evaluate('window.__PK_APP__ && window.__PK_APP__.getState().projects === 1'), 'v13 shell', 20000);
-
-    const snapshot = await browser.evaluate(`(() => ({
-      title: document.title,
-      shell: document.querySelectorAll('.shell').length,
-      sidebar: getComputedStyle(document.querySelector('.sidebar')).display,
-      terminalView: document.getElementById('view-terminal').classList.contains('active'),
-      projects: document.querySelectorAll('#project-list .project-card').length,
-      unsafeImages: document.querySelectorAll('img').length,
-      xss: window.__xss,
-      bodyWidth: document.body.scrollWidth,
-      viewportWidth: document.documentElement.clientWidth
-    }))()`);
-    assert.strictEqual(snapshot.title, 'Project Knowledge');
-    assert.strictEqual(snapshot.shell, 1);
-    assert.notStrictEqual(snapshot.sidebar, 'none');
-    assert.strictEqual(snapshot.terminalView, true);
-    assert.strictEqual(snapshot.projects, 1);
-    assert.strictEqual(snapshot.unsafeImages, 0);
-    assert.strictEqual(snapshot.xss, undefined);
-    assert(snapshot.bodyWidth <= snapshot.viewportWidth + 1, 'desktop shell must not overflow horizontally');
-
-    await browser.evaluate("document.getElementById('theme-button').click()");
-    assert.strictEqual(await browser.evaluate('document.documentElement.dataset.theme'), 'dark');
-
-    await browser.setViewport(390, 844);
-    const mobile = await browser.evaluate(`(() => ({
-      sidebar: getComputedStyle(document.querySelector('.sidebar')).display,
-      mobileBar: getComputedStyle(document.querySelector('.mobile-strip')).display,
-      bodyWidth: document.body.scrollWidth,
-      viewportWidth: document.documentElement.clientWidth,
-      projectUsable: document.getElementById('mobile-project').getBoundingClientRect().width > 100
-    }))()`);
-    assert.strictEqual(mobile.sidebar, 'none');
-    assert.notStrictEqual(mobile.mobileBar, 'none');
-    assert.strictEqual(mobile.projectUsable, true);
-    assert(mobile.bodyWidth <= mobile.viewportWidth + 1, 'mobile shell must not overflow horizontally');
-
-    await browser.screenshot(screenshotPath);
-    assert(fs.statSync(screenshotPath).size > 10000, 'real browser screenshot should contain rendered UI');
-    assert.strictEqual(browser.exceptions.length, 0, 'browser runtime exceptions: ' + JSON.stringify(browser.exceptions));
-    console.log('ui smoke test PASS');
-  } finally {
-    if (browser) await browser.close();
-    await server.cleanup();
-    fixture.cleanup();
-    try { fs.rmSync(screenshotPath, { force: true }); } catch {}
-  }
-})().catch(error => {
-  console.error(error.stack || error.message);
-  process.exitCode = 1;
-});

package/_site/_test/v4122-upgrade-data-contract-test.js

@@ -1,56 +0,0 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { StorageLayout } = require('../lib/storage-layout');
-const { MigrationService } = require('../lib/migration-service');
-const { publicAiProfilesConfig } = require('../lib/contracts');
-
-function fixture() {
-  const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-v4122-upgrade-'));
-  const knowledgeRoot = path.join(dataDir, 'knowledge-root');
-  const projects = {};
-  for (const slug of ['alpha', 'beta', 'gamma']) {
-    const repoPath = path.join(dataDir, 'repos', slug);
-    const knowledgePath = path.join(knowledgeRoot, `preserved-${slug}`);
-    fs.mkdirSync(knowledgePath, { recursive: true });
-    fs.writeFileSync(path.join(knowledgePath, 'README.md'), `# ${slug}\n`);
-    projects[slug] = { repoPath, kbPath: knowledgePath, aiProfileId: slug === 'alpha' ? 'primary' : 'secondary' };
-  }
-  fs.writeFileSync(path.join(dataDir, 'projects.json'), JSON.stringify(projects));
-  fs.writeFileSync(path.join(dataDir, 'knowledge-store.json'), JSON.stringify({ rootPath: knowledgeRoot }));
-  fs.writeFileSync(path.join(dataDir, 'ai-profiles.json'), JSON.stringify({ profiles: [
-    { id: 'primary', apiKey: 'fixture-secret-one', model: 'model-a' },
-    { id: 'secondary', apiKey: 'fixture-secret-two', model: 'model-b' },
-  ] }));
-  fs.writeFileSync(path.join(dataDir, 'embedding-config.json'), JSON.stringify({ modelId: 'embedding-v4122', localFilesOnly: true, localModelPath: path.join(dataDir, 'models') }));
-  fs.mkdirSync(path.join(dataDir, 'models', 'A', 'B'), { recursive: true });
-  fs.writeFileSync(path.join(dataDir, 'models', 'A', 'B', 'model.onnx'), 'exact-model-content');
-  return { dataDir, knowledgeRoot, projects };
-}
-
-(async () => {
-  const { dataDir, knowledgeRoot, projects } = fixture();
-  try {
-    const layout = new StorageLayout({ dataDir });
-    const result = await new MigrationService({ layout, legacyDataDir: dataDir }).migrateIfNeeded({ migrationRunId: 'v4122-contract' });
-    assert.equal(result.ok, true);
-    const registry = JSON.parse(fs.readFileSync(layout.getProjectRegistryPath(), 'utf8'));
-    assert.equal(registry.projectOrder.length, 3);
-    const settings = JSON.parse(fs.readFileSync(layout.getSettingsPath(), 'utf8'));
-    assert.equal(settings.knowledge.rootPath, knowledgeRoot);
-    assert.deepEqual(settings.embedding, { modelId: 'embedding-v4122', localFilesOnly: true, localModelPath: path.join(dataDir, 'models') });
-    assert.equal(settings.ai.profiles.length, 2);
-    assert.equal(publicAiProfilesConfig(settings.ai).profiles.every(profile => profile.hasApiKey && !Object.hasOwn(profile, 'apiKey')), true);
-    for (const projectId of registry.projectOrder) {
-      const config = JSON.parse(fs.readFileSync(layout.getProjectConfigPath(projectId), 'utf8'));
-      const legacy = projects[config.legacyExtensions.slug];
-      assert.equal(config.repoPath, legacy.repoPath);
-      assert.equal(config.knowledgePath, legacy.kbPath);
-    }
-    assert.equal(fs.readFileSync(path.join(dataDir, 'cache', 'models', 'A', 'B', 'model.onnx'), 'utf8'), 'exact-model-content');
-    assert.equal(result.marker.projectCount, 3);
-    assert.equal(result.marker.aiProfileCount, 2);
-  } finally { fs.rmSync(dataDir, { recursive: true, force: true }); }
-  console.log('v4122-upgrade-data-contract-test PASS');
-})().catch(error => { console.error(error.stack || error.message); process.exit(1); });

package/_site/lib/data-state-classifier.js

@@ -1,40 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const { SCHEMAS } = require('./contracts');
-const { LEGACY_ASSETS, assetPath } = require('./legacy-data-manifest');
-
-const STATES = Object.freeze({ FRESH: 'FRESH', LEGACY: 'LEGACY', V2_VALID: 'V2_VALID', MIGRATION_INCOMPLETE: 'MIGRATION_INCOMPLETE', CONFLICT: 'CONFLICT', CORRUPT: 'CORRUPT' });
-
-function readJson(filePath) {
-  if (!fs.existsSync(filePath)) return { exists: false, value: null };
-  try { const raw = fs.readFileSync(filePath, 'utf8'); return { exists: true, value: JSON.parse(raw.charCodeAt(0) === 0xfeff ? raw.slice(1) : raw) }; }
-  catch (error) { return { exists: true, error }; }
-}
-function isEmptyJson(value) {
-  if (value == null || typeof value !== 'object') return false;
-  if (Array.isArray(value)) return value.length === 0;
-  if (value.schema === SCHEMAS.projectRegistry) return Array.isArray(value.projectOrder) && value.projectOrder.length === 0;
-  return Object.keys(value).length === 0;
-}
-function hasRecovery(root) { const recovery = path.join(root, 'recovery'); return fs.existsSync(recovery) && fs.statSync(recovery).isDirectory() && fs.readdirSync(recovery).length > 0; }
-function classifyDataState(root) {
-  const projects = readJson(path.join(root, 'projects.json'));
-  const settings = readJson(path.join(root, 'settings.json'));
-  if (projects.error || settings.error) return { state: STATES.CORRUPT, projects, settings };
-  // Logs and hook diagnostics can be created before startup classification;
-  // alone they are not user configuration evidence and must not turn a clean
-  // install into an impossible legacy migration.
-  const hasLegacyAssets = LEGACY_ASSETS.some(asset => asset.authority !== 'history' && fs.existsSync(assetPath(root, asset)));
-  const isV2 = projects.value && projects.value.schema === SCHEMAS.projectRegistry && projects.value.schemaVersion === 2;
-  const settingsV2 = settings.value && settings.value.schema === SCHEMAS.settings && settings.value.schemaVersion === 2;
-  if (isV2 && settingsV2) return { state: STATES.V2_VALID, projects, settings, hasLegacyAssets };
-  // A failed migration may have written default v2 settings before activation.
-  // A non-v2 projects registry remains authoritative legacy evidence and is
-  // eligible for a controlled retry; it must never be classified as Fresh.
-  if (projects.exists && !isV2 && hasLegacyAssets) return { state: STATES.LEGACY, projects, settings, hasLegacyAssets };
-  if (isV2 || settingsV2 || hasRecovery(root)) return { state: STATES.MIGRATION_INCOMPLETE, projects, settings, hasLegacyAssets };
-  if (hasLegacyAssets) return { state: STATES.LEGACY, projects, settings, hasLegacyAssets };
-  return { state: STATES.FRESH, projects, settings, hasLegacyAssets };
-}
-
-module.exports = { STATES, readJson, isEmptyJson, classifyDataState };

package/_site/lib/legacy-data-manifest.js

@@ -1,26 +0,0 @@
-// The complete v4.1.x runtime asset inventory. Both relocation from an
-// installed package and layout-v2 migration consume this manifest.
-const path = require('path');
-
-const LEGACY_ASSETS = Object.freeze([
-  { source: 'projects.json', target: 'projects.json', kind: 'file', authority: 'user' },
-  { source: 'ai-profiles.json', target: 'ai-profiles.json', kind: 'file', authority: 'user' },
-  { source: 'knowledge-store.json', target: 'knowledge-store.json', kind: 'file', authority: 'user' },
-  { source: 'embedding-config.json', target: 'embedding-config.json', kind: 'file', authority: 'user' },
-  { source: 'logging.json', target: 'logging.json', kind: 'file', authority: 'user' },
-  { source: 'claude-prompts.json', target: 'claude-prompts.json', kind: 'file', authority: 'user' },
-  { source: 'github-team.json', target: 'github-team.json', kind: 'file', authority: 'user' },
-  { source: 'team-git-providers.json', target: 'team-git-providers.json', kind: 'file', authority: 'user' },
-  { source: 'knowledge-scopes.json', target: 'knowledge-scopes.json', kind: 'file', authority: 'user' },
-  { source: '.jobs-log.json', target: '.jobs-log.json', kind: 'file', authority: 'history' },
-  { source: '.hook-trigger-errors.log', target: '.hook-trigger-errors.log', kind: 'file', authority: 'history' },
-  { source: 'projects', target: 'projects', kind: 'dir', authority: 'user' },
-  { source: 'logs', target: 'logs', kind: 'dir', authority: 'history' },
-  { source: 'models', target: 'models', kind: 'dir', authority: 'cache-but-expensive' },
-  { source: path.join('_site', '_ai'), target: '_ai', kind: 'dir', authority: 'history' },
-]);
-
-function getLegacyAsset(source) { return LEGACY_ASSETS.find(asset => asset.source === source) || null; }
-function assetPath(root, asset, side = 'source') { return path.join(root, asset[side] || asset.source); }
-
-module.exports = { LEGACY_ASSETS, getLegacyAsset, assetPath };