@sanqianx/project-knowledge 5.0.24 → 5.0.25

package/_site/_test/orphaned-claim-recovery-test.js

@@ -1,80 +1,80 @@
-// Run: node _site/_test/orphaned-claim-recovery-test.js
-
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { StorageLayout } = require('../lib/storage-layout');
-const { ProjectRegistryStore } = require('../lib/project-registry-store');
-const { ProjectStore } = require('../lib/project-store');
-const { recoverOrphanedClaims } = require('../lib/post-commit-automation');
-
-const temp = fs.mkdtempSync(path.join(os.tmpdir(), `kb-orphaned-claim-${process.pid}-`));
-const layout = new StorageLayout({ dataDir: path.join(temp, 'data') });
-const registryStore = new ProjectRegistryStore({ layout });
-const projectStore = new ProjectStore({ layout });
-const projectId = 'project-orphaned-claim';
-const oldCommit = 'a'.repeat(40);
-const lastAnalyzedCommit = 'b'.repeat(40);
-let warnings = 0;
-let analyzerCalls = 0;
-
-(async () => {
-  await registryStore.initialize();
-  await registryStore.add(projectId);
-  await projectStore.create(projectId, {
-    repoPath: temp,
-    knowledgePath: path.join(temp, 'knowledge'),
-  }, {
-    trackingStartCommit: lastAnalyzedCommit,
-    lastAnalyzedCommit,
-    analysis: {
-      status: 'evidence.prepared',
-      activeClaim: {
-        schema: 'commit-claim/v1',
-        projectId,
-        commitSha: oldCommit,
-        runId: 'run-before-restart',
-        operationId: 'operation-before-restart',
-        fingerprint: 'frozen-claim',
-        phase: 'evidence.prepared',
-      },
-    },
-  });
-
-  const recovered = await recoverOrphanedClaims({
-    layout,
-    registryStore,
-    projectStore,
-    claimProcessor: { processClaim: async () => { analyzerCalls += 1; } },
-    now: () => '2026-08-25T00:00:00.000Z',
-    logger: { warn: async () => { warnings += 1; } },
-  });
-
-  assert.deepStrictEqual(recovered, [{
-    projectId,
-    commitSha: oldCommit,
-    runId: 'run-before-restart',
-    previousPhase: 'evidence.prepared',
-  }]);
-  const state = projectStore.readState(projectId);
-  assert.strictEqual(state.lastAnalyzedCommit, lastAnalyzedCommit, 'startup recovery must not advance commit state');
-  assert.strictEqual(state.analysis.status, 'failed');
-  assert.strictEqual(state.analysis.activeClaim.commitSha, oldCommit);
-  assert.strictEqual(state.analysis.activeClaim.phase, 'failed');
-  assert.strictEqual(state.analysis.activeClaim.error.code, 'ORPHANED_CLAIM');
-  assert.strictEqual(state.analysis.activeClaim.error.retryable, false);
-  assert.strictEqual(state.analysis.lastError.code, 'ORPHANED_CLAIM');
-  assert.strictEqual(analyzerCalls, 0, 'startup recovery must never invoke analysis');
-  assert.strictEqual(warnings, 1);
-
-  const secondPass = await recoverOrphanedClaims({ layout, registryStore, projectStore });
-  assert.strictEqual(secondPass.length, 0, 'recovery is idempotent while the terminal claim remains visible');
-  assert.strictEqual(projectStore.readState(projectId).analysis.activeClaim.error.code, 'ORPHANED_CLAIM');
-  console.log('orphaned-claim-recovery-test PASS');
-})().catch(error => {
-  console.error(error.stack || error.message);
-  process.exitCode = 1;
-}).finally(() => {
-  fs.rmSync(temp, { recursive: true, force: true });
-});
+// Run: node _site/_test/orphaned-claim-recovery-test.js
+
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { StorageLayout } = require('../lib/storage-layout');
+const { ProjectRegistryStore } = require('../lib/project-registry-store');
+const { ProjectStore } = require('../lib/project-store');
+const { recoverOrphanedClaims } = require('../lib/post-commit-automation');
+
+const temp = fs.mkdtempSync(path.join(os.tmpdir(), `kb-orphaned-claim-${process.pid}-`));
+const layout = new StorageLayout({ dataDir: path.join(temp, 'data') });
+const registryStore = new ProjectRegistryStore({ layout });
+const projectStore = new ProjectStore({ layout });
+const projectId = 'project-orphaned-claim';
+const oldCommit = 'a'.repeat(40);
+const lastAnalyzedCommit = 'b'.repeat(40);
+let warnings = 0;
+let analyzerCalls = 0;
+
+(async () => {
+  await registryStore.initialize();
+  await registryStore.add(projectId);
+  await projectStore.create(projectId, {
+    repoPath: temp,
+    knowledgePath: path.join(temp, 'knowledge'),
+  }, {
+    trackingStartCommit: lastAnalyzedCommit,
+    lastAnalyzedCommit,
+    analysis: {
+      status: 'evidence.prepared',
+      activeClaim: {
+        schema: 'commit-claim/v1',
+        projectId,
+        commitSha: oldCommit,
+        runId: 'run-before-restart',
+        operationId: 'operation-before-restart',
+        fingerprint: 'frozen-claim',
+        phase: 'evidence.prepared',
+      },
+    },
+  });
+
+  const recovered = await recoverOrphanedClaims({
+    layout,
+    registryStore,
+    projectStore,
+    claimProcessor: { processClaim: async () => { analyzerCalls += 1; } },
+    now: () => '2026-08-25T00:00:00.000Z',
+    logger: { warn: async () => { warnings += 1; } },
+  });
+
+  assert.deepStrictEqual(recovered, [{
+    projectId,
+    commitSha: oldCommit,
+    runId: 'run-before-restart',
+    previousPhase: 'evidence.prepared',
+  }]);
+  const state = projectStore.readState(projectId);
+  assert.strictEqual(state.lastAnalyzedCommit, lastAnalyzedCommit, 'startup recovery must not advance commit state');
+  assert.strictEqual(state.analysis.status, 'failed');
+  assert.strictEqual(state.analysis.activeClaim.commitSha, oldCommit);
+  assert.strictEqual(state.analysis.activeClaim.phase, 'failed');
+  assert.strictEqual(state.analysis.activeClaim.error.code, 'ORPHANED_CLAIM');
+  assert.strictEqual(state.analysis.activeClaim.error.retryable, false);
+  assert.strictEqual(state.analysis.lastError.code, 'ORPHANED_CLAIM');
+  assert.strictEqual(analyzerCalls, 0, 'startup recovery must never invoke analysis');
+  assert.strictEqual(warnings, 1);
+
+  const secondPass = await recoverOrphanedClaims({ layout, registryStore, projectStore });
+  assert.strictEqual(secondPass.length, 0, 'recovery is idempotent while the terminal claim remains visible');
+  assert.strictEqual(projectStore.readState(projectId).analysis.activeClaim.error.code, 'ORPHANED_CLAIM');
+  console.log('orphaned-claim-recovery-test PASS');
+})().catch(error => {
+  console.error(error.stack || error.message);
+  process.exitCode = 1;
+}).finally(() => {
+  fs.rmSync(temp, { recursive: true, force: true });
+});

package/_site/_test/package-boundary-test.js

@@ -1,43 +1,43 @@
-const assert = require('assert');
-const fs = require('fs');
-const path = require('path');
-const { spawnSync } = require('child_process');
-
-const root = path.resolve(__dirname, '..', '..');
-const npmCli = process.env.npm_execpath
-  || path.join(path.dirname(process.execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js');
-const result = spawnSync(process.execPath, [npmCli, 'pack', '--dry-run', '--json'], {
-  cwd: root,
-  encoding: 'utf8',
-  windowsHide: true,
-});
-
-assert.strictEqual(result.status, 0, result.stderr || result.stdout);
-const report = JSON.parse(result.stdout);
-const files = report[0].files.map(entry => entry.path.replace(/\\/g, '/'));
-const forbidden = [
-  'docs/project-knowledge-base-review-deliverables.zip',
-  'docs/project-knowledge-base-review-deliverables/',
-  'docs/project-knowledge-base-pro-review-prompt.md',
-  'docs/knowledge-base-trigger-refactor-plan.md',
-  'docs/log-ui-comparison.html',
-  'ui/claude-workspace-preview.html',
-];
-for (const candidate of forbidden) {
-  assert(!files.some(file => candidate.endsWith('/') ? file.startsWith(candidate) : file === candidate), `local review artifact leaked into npm package: ${candidate}`);
-}
-assert(files.includes('docs/README.zh-CN.md'));
-assert(files.includes('ui/index.html'));
-assert(files.includes('ui/knowledge-panel.html'), 'K1 knowledge panel page must ship in the npm package');
-
-// Every local asset referenced by the packaged HTML must be present in the
-// tarball. This is deliberately derived from index.html so adding a future
-// script, stylesheet, or icon cannot silently produce a broken npm install.
-const html = fs.readFileSync(path.join(root, 'ui', 'index.html'), 'utf8');
-const referencedAssets = [...html.matchAll(/<(?:script|link)\b[^>]*(?:src|href)="(\/[^"?#]+)(?:[?#][^"]*)?"/gi)]
-  .map(match => `ui/${match[1].replace(/^\//, '')}`);
-assert(referencedAssets.length > 0, 'ui/index.html must reference packaged assets');
-for (const asset of referencedAssets) {
-  assert(files.includes(asset), `HTML references an asset missing from the npm package: ${asset}`);
-}
-console.log('package-boundary-test PASS');
+const assert = require('assert');
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const root = path.resolve(__dirname, '..', '..');
+const npmCli = process.env.npm_execpath
+  || path.join(path.dirname(process.execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js');
+const result = spawnSync(process.execPath, [npmCli, 'pack', '--dry-run', '--json'], {
+  cwd: root,
+  encoding: 'utf8',
+  windowsHide: true,
+});
+
+assert.strictEqual(result.status, 0, result.stderr || result.stdout);
+const report = JSON.parse(result.stdout);
+const files = report[0].files.map(entry => entry.path.replace(/\\/g, '/'));
+const forbidden = [
+  'docs/project-knowledge-base-review-deliverables.zip',
+  'docs/project-knowledge-base-review-deliverables/',
+  'docs/project-knowledge-base-pro-review-prompt.md',
+  'docs/knowledge-base-trigger-refactor-plan.md',
+  'docs/log-ui-comparison.html',
+  'ui/claude-workspace-preview.html',
+];
+for (const candidate of forbidden) {
+  assert(!files.some(file => candidate.endsWith('/') ? file.startsWith(candidate) : file === candidate), `local review artifact leaked into npm package: ${candidate}`);
+}
+assert(files.includes('docs/README.zh-CN.md'));
+assert(files.includes('ui/index.html'));
+assert(files.includes('ui/knowledge-panel.html'), 'K1 knowledge panel page must ship in the npm package');
+
+// Every local asset referenced by the packaged HTML must be present in the
+// tarball. This is deliberately derived from index.html so adding a future
+// script, stylesheet, or icon cannot silently produce a broken npm install.
+const html = fs.readFileSync(path.join(root, 'ui', 'index.html'), 'utf8');
+const referencedAssets = [...html.matchAll(/<(?:script|link)\b[^>]*(?:src|href)="(\/[^"?#]+)(?:[?#][^"]*)?"/gi)]
+  .map(match => `ui/${match[1].replace(/^\//, '')}`);
+assert(referencedAssets.length > 0, 'ui/index.html must reference packaged assets');
+for (const asset of referencedAssets) {
+  assert(files.includes(asset), `HTML references an asset missing from the npm package: ${asset}`);
+}
+console.log('package-boundary-test PASS');

package/_site/_test/package-startup-test.js

@@ -1,56 +1,56 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawn } = require('child_process');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const BIN = path.join(ROOT, 'bin', 'project-knowledge.js');
-const PORT = 7825;
-const BASE = `http://127.0.0.1:${PORT}`;
-const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pkb-package-v2-'));
-
-async function waitForServer() {
-  for (let attempt = 0; attempt < 150; attempt += 1) {
-    try { if ((await fetch(`${BASE}/api/health`)).ok) return; } catch {}
-    await new Promise(resolve => setTimeout(resolve, 100));
-  }
-  throw new Error('packaged CLI server did not start');
-}
-
-(async () => {
-  const child = spawn(process.execPath, [BIN, '--fg', '--port', String(PORT), '--host', '127.0.0.1', '--no-open'], {
-    cwd: ROOT,
-    env: { ...process.env, KB_DATA_DIR: dataDir, KB_SKIP_MIGRATION: '1' },
-    stdio: ['ignore', 'pipe', 'pipe'],
-    windowsHide: true,
-  });
-  let output = '';
-  child.stdout.on('data', chunk => { output += chunk; });
-  child.stderr.on('data', chunk => { output += chunk; });
-  try {
-    await waitForServer();
-    const stateResponse = await fetch(`${BASE}/api/state`);
-    const state = await stateResponse.json();
-    assert.strictEqual(state.schema, 'server-state/v2');
-    assert.deepStrictEqual(state.projects, []);
-
-    const registry = JSON.parse(fs.readFileSync(path.join(dataDir, 'projects.json'), 'utf8'));
-    assert.strictEqual(registry.schema, 'project-registry/v2');
-    assert.deepStrictEqual(registry.projectOrder, []);
-    const endpoint = JSON.parse(fs.readFileSync(path.join(dataDir, 'runtime-endpoint.json'), 'utf8'));
-    assert.strictEqual(endpoint.schema, 'project-knowledge/runtime-endpoint/v1');
-    assert.strictEqual(endpoint.port, PORT);
-
-    const removed = await fetch(`${BASE}/api/projects/example/hook-install`, { method: 'POST' });
-    assert.strictEqual(removed.status, 404);
-    console.log('package-startup-test PASS');
-  } catch (error) {
-    console.error(output);
-    throw error;
-  } finally {
-    child.kill('SIGTERM');
-    await new Promise(resolve => child.once('exit', resolve));
-    fs.rmSync(dataDir, { recursive: true, force: true });
-  }
-})().catch(error => { console.error(error); process.exitCode = 1; });
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const BIN = path.join(ROOT, 'bin', 'project-knowledge.js');
+const PORT = 7825;
+const BASE = `http://127.0.0.1:${PORT}`;
+const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pkb-package-v2-'));
+
+async function waitForServer() {
+  for (let attempt = 0; attempt < 150; attempt += 1) {
+    try { if ((await fetch(`${BASE}/api/health`)).ok) return; } catch {}
+    await new Promise(resolve => setTimeout(resolve, 100));
+  }
+  throw new Error('packaged CLI server did not start');
+}
+
+(async () => {
+  const child = spawn(process.execPath, [BIN, '--fg', '--port', String(PORT), '--host', '127.0.0.1', '--no-open'], {
+    cwd: ROOT,
+    env: { ...process.env, KB_DATA_DIR: dataDir, KB_SKIP_MIGRATION: '1' },
+    stdio: ['ignore', 'pipe', 'pipe'],
+    windowsHide: true,
+  });
+  let output = '';
+  child.stdout.on('data', chunk => { output += chunk; });
+  child.stderr.on('data', chunk => { output += chunk; });
+  try {
+    await waitForServer();
+    const stateResponse = await fetch(`${BASE}/api/state`);
+    const state = await stateResponse.json();
+    assert.strictEqual(state.schema, 'server-state/v2');
+    assert.deepStrictEqual(state.projects, []);
+
+    const registry = JSON.parse(fs.readFileSync(path.join(dataDir, 'projects.json'), 'utf8'));
+    assert.strictEqual(registry.schema, 'project-registry/v2');
+    assert.deepStrictEqual(registry.projectOrder, []);
+    const endpoint = JSON.parse(fs.readFileSync(path.join(dataDir, 'runtime-endpoint.json'), 'utf8'));
+    assert.strictEqual(endpoint.schema, 'project-knowledge/runtime-endpoint/v1');
+    assert.strictEqual(endpoint.port, PORT);
+
+    const removed = await fetch(`${BASE}/api/projects/example/hook-install`, { method: 'POST' });
+    assert.strictEqual(removed.status, 404);
+    console.log('package-startup-test PASS');
+  } catch (error) {
+    console.error(output);
+    throw error;
+  } finally {
+    child.kill('SIGTERM');
+    await new Promise(resolve => child.once('exit', resolve));
+    fs.rmSync(dataDir, { recursive: true, force: true });
+  }
+})().catch(error => { console.error(error); process.exitCode = 1; });

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

@@ -1,88 +1,88 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawnSync } = require('child_process');
-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 PORT = 8250 + (process.pid % 500);
-const BASE = `http://127.0.0.1:${PORT}`;
-const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), `pk-packaged-ui-${process.pid}-`));
-const packDir = path.join(tempRoot, 'pack');
-const installDir = path.join(tempRoot, 'install');
-const profileDir = path.join(tempRoot, 'chrome-profile');
-fs.mkdirSync(packDir, { recursive: true });
-fs.mkdirSync(installDir, { recursive: true });
-
-function npmCliPath() {
-  return process.env.npm_execpath
-    || path.join(path.dirname(process.execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js');
-}
-
-function buildAndInstallPackage() {
-  const packed = spawnSync(process.execPath, [npmCliPath(), 'pack', '--json', '--pack-destination', packDir], {
-    cwd: ROOT,
-    encoding: 'utf8',
-    windowsHide: true,
-  });
-  assert.strictEqual(packed.status, 0, packed.stderr || packed.stdout);
-  const report = JSON.parse(packed.stdout);
-  const tarball = path.join(packDir, report[0].filename);
-  assert(fs.existsSync(tarball), `npm pack did not create ${tarball}`);
-
-  const installed = spawnSync(process.execPath, [npmCliPath(), 'install', '--ignore-scripts', '--no-audit', '--no-fund', '--prefix', installDir, tarball], {
-    encoding: 'utf8',
-    windowsHide: true,
-  });
-  assert.strictEqual(installed.status, 0, installed.stderr || installed.stdout);
-  // Resolve the install path from the package's actual name (moved to
-  // @sanqianx/project-knowledge in 4.7.0; prior releases used the unscoped
-  // 'project-knowledge' which would live at node_modules/project-knowledge).
-  const pkg = require(path.join(ROOT, 'package.json'));
-  const installPath = pkg.name.startsWith('@')
-    ? path.join(installDir, 'node_modules', pkg.name.split('/')[0], pkg.name.split('/')[1])
-    : path.join(installDir, 'node_modules', pkg.name);
-  return installPath;
-}
-
-(async () => {
-  let server;
-  let browser;
-  try {
-    const packagedRoot = buildAndInstallPackage();
-    for (const file of ['index.html', 'knowledge-panel.html', 'product.js', 'product.css']) assert(fs.existsSync(path.join(packagedRoot, 'ui', file)), `packed UI must include ${file}`);
-    for (const file of ['app.js', 'app.css', 'i18n.js']) assert(!fs.existsSync(path.join(packagedRoot, 'ui', file)), `obsolete shell resource must not be shipped: ${file}`);
-
-    server = spawnServer({ root: packagedRoot, port: PORT, dataDir: path.join(tempRoot, 'data'), tag: 'packaged-ui', analysisOwner: 'engine', stdio: 'ignore' });
-    await waitFor(async () => {
-      try { return (await fetch(`${BASE}/api/health`)).ok ? { ok: true } : null; }
-      catch { return null; }
-    }, 'packaged server', 20000);
-
-    const productResponse = await fetch(`${BASE}/product.js`);
-    assert.strictEqual(productResponse.status, 200, 'packaged server must serve /product.js');
-    assert.match(String(productResponse.headers.get('content-type') || ''), /javascript/i);
-
-    browser = await launchCdpBrowser({ chrome: findChrome(), profileDir, url: `${BASE}/`, width: 1920, height: 1080 });
-    await browser.setViewport(1920, 1080);
-    await waitFor(async () => {
-      const ready = await browser.evaluate("document.getElementById('homeContent').textContent.includes('第一个项目')");
-      return ready ? { ok: true } : null;
-    }, 'packaged UI bootstrap', 20000);
-
-    assert.strictEqual(await browser.evaluate("document.getElementById('projectSelect').disabled"), true);
-    assert.strictEqual(await browser.evaluate("document.querySelectorAll('nav [data-view]').length"), 6);
-    assert.strictEqual(browser.exceptions.length, 0, `packaged UI runtime exceptions: ${JSON.stringify(browser.exceptions)}`);
-    console.log('packaged-ui-smoke-test PASS');
-  } finally {
-    if (browser) await browser.close();
-    if (server) await server.cleanup();
-    try { fs.rmSync(tempRoot, { recursive: true, force: true }); } catch {}
-  }
-})().catch(error => {
-  console.error(error.stack || error.message);
-  process.exitCode = 1;
-});
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+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 PORT = 8250 + (process.pid % 500);
+const BASE = `http://127.0.0.1:${PORT}`;
+const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), `pk-packaged-ui-${process.pid}-`));
+const packDir = path.join(tempRoot, 'pack');
+const installDir = path.join(tempRoot, 'install');
+const profileDir = path.join(tempRoot, 'chrome-profile');
+fs.mkdirSync(packDir, { recursive: true });
+fs.mkdirSync(installDir, { recursive: true });
+
+function npmCliPath() {
+  return process.env.npm_execpath
+    || path.join(path.dirname(process.execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js');
+}
+
+function buildAndInstallPackage() {
+  const packed = spawnSync(process.execPath, [npmCliPath(), 'pack', '--json', '--pack-destination', packDir], {
+    cwd: ROOT,
+    encoding: 'utf8',
+    windowsHide: true,
+  });
+  assert.strictEqual(packed.status, 0, packed.stderr || packed.stdout);
+  const report = JSON.parse(packed.stdout);
+  const tarball = path.join(packDir, report[0].filename);
+  assert(fs.existsSync(tarball), `npm pack did not create ${tarball}`);
+
+  const installed = spawnSync(process.execPath, [npmCliPath(), 'install', '--ignore-scripts', '--no-audit', '--no-fund', '--prefix', installDir, tarball], {
+    encoding: 'utf8',
+    windowsHide: true,
+  });
+  assert.strictEqual(installed.status, 0, installed.stderr || installed.stdout);
+  // Resolve the install path from the package's actual name (moved to
+  // @sanqianx/project-knowledge in 4.7.0; prior releases used the unscoped
+  // 'project-knowledge' which would live at node_modules/project-knowledge).
+  const pkg = require(path.join(ROOT, 'package.json'));
+  const installPath = pkg.name.startsWith('@')
+    ? path.join(installDir, 'node_modules', pkg.name.split('/')[0], pkg.name.split('/')[1])
+    : path.join(installDir, 'node_modules', pkg.name);
+  return installPath;
+}
+
+(async () => {
+  let server;
+  let browser;
+  try {
+    const packagedRoot = buildAndInstallPackage();
+    for (const file of ['index.html', 'knowledge-panel.html', 'product.js', 'product.css']) assert(fs.existsSync(path.join(packagedRoot, 'ui', file)), `packed UI must include ${file}`);
+    for (const file of ['app.js', 'app.css', 'i18n.js']) assert(!fs.existsSync(path.join(packagedRoot, 'ui', file)), `obsolete shell resource must not be shipped: ${file}`);
+
+    server = spawnServer({ root: packagedRoot, port: PORT, dataDir: path.join(tempRoot, 'data'), tag: 'packaged-ui', analysisOwner: 'engine', stdio: 'ignore' });
+    await waitFor(async () => {
+      try { return (await fetch(`${BASE}/api/health`)).ok ? { ok: true } : null; }
+      catch { return null; }
+    }, 'packaged server', 20000);
+
+    const productResponse = await fetch(`${BASE}/product.js`);
+    assert.strictEqual(productResponse.status, 200, 'packaged server must serve /product.js');
+    assert.match(String(productResponse.headers.get('content-type') || ''), /javascript/i);
+
+    browser = await launchCdpBrowser({ chrome: findChrome(), profileDir, url: `${BASE}/`, width: 1920, height: 1080 });
+    await browser.setViewport(1920, 1080);
+    await waitFor(async () => {
+      const ready = await browser.evaluate("document.getElementById('homeContent').textContent.includes('第一个项目')");
+      return ready ? { ok: true } : null;
+    }, 'packaged UI bootstrap', 20000);
+
+    assert.strictEqual(await browser.evaluate("document.getElementById('projectSelect').disabled"), true);
+    assert.strictEqual(await browser.evaluate("document.querySelectorAll('nav [data-view]').length"), 6);
+    assert.strictEqual(browser.exceptions.length, 0, `packaged UI runtime exceptions: ${JSON.stringify(browser.exceptions)}`);
+    console.log('packaged-ui-smoke-test PASS');
+  } finally {
+    if (browser) await browser.close();
+    if (server) await server.cleanup();
+    try { fs.rmSync(tempRoot, { recursive: true, force: true }); } catch {}
+  }
+})().catch(error => {
+  console.error(error.stack || error.message);
+  process.exitCode = 1;
+});