@sanqianx/project-knowledge 5.0.18 → 5.0.20-rc.1

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

package/_site/_test/pr-consumer-contract-test.js

@@ -1,55 +1,55 @@
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { StorageLayout } = require('../lib/storage-layout');
-const { SettingsStore } = require('../lib/settings-store');
-const { ProjectRegistryStore } = require('../lib/project-registry-store');
-const { ProjectStore } = require('../lib/project-store');
-const { KnowledgeToolRuntime } = require('../lib/knowledge-tool-runtime');
-const { validateKb, buildPrContextPack } = require('../lib/kb-validator');
-const { regenerateIndexes } = require('../lib/index-builder');
-
-const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'pkb-pr-v2-'));
-const knowledgePath = path.join(temp, 'knowledge');
-
-function writeKnowledge() {
-  fs.mkdirSync(path.join(knowledgePath, 'modules'), { recursive: true });
-  fs.mkdirSync(path.join(knowledgePath, 'changes'), { recursive: true });
-  fs.writeFileSync(path.join(knowledgePath, 'README.md'), '# Test KB\n');
-  fs.writeFileSync(path.join(knowledgePath, 'GOAL.md'), '# Goal\n');
-  fs.writeFileSync(path.join(knowledgePath, 'ARCHITECTURE.md'), '# Architecture\n');
-  fs.writeFileSync(path.join(knowledgePath, 'modules', 'api.md'), '---\ntags: [api]\nsourcePaths: [src/api.js]\n---\n# API\n');
-  fs.writeFileSync(path.join(knowledgePath, 'changes', 'api-change.md'), '---\ntags: [api]\naffectedModules: [api]\ndevelopmentIntent: Add API memory.\n---\n# API change\n\n## Development Intent\nAdd API memory.\n\n## Implementation Result\nDone.\n\n## Evidence\n- src/api.js\n');
-  regenerateIndexes(knowledgePath);
-}
-
-(async () => {
-  try {
-    writeKnowledge();
-    const validation = validateKb(knowledgePath);
-    assert(validation.ok, JSON.stringify(validation.errors));
-    const pack = buildPrContextPack(knowledgePath);
-    assert(pack.ok);
-    assert.strictEqual(pack.pack.schema, 'pr-context-pack/v1');
-    assert(pack.pack.trustedKnowledge.some(item => item.path === 'modules/api.md'));
-    assert(!JSON.stringify(pack.pack).includes('_ai/'));
-
-    const layout = new StorageLayout({ dataDir: path.join(temp, 'data') });
-    const settingsStore = new SettingsStore({ layout });
-    const registryStore = new ProjectRegistryStore({ layout });
-    const projectStore = new ProjectStore({ layout });
-    await settingsStore.initialize({ knowledge: { rootPath: path.join(temp, 'future') } });
-    await registryStore.initialize();
-    await projectStore.create('project-consumer', { displayName: 'Consumer', storageName: 'consumer', repoPath: temp, knowledgePath }, { index: { dirty: true, generation: 1 } });
-    await registryStore.add('project-consumer', { displayNameSnapshot: 'Consumer' });
-    const runtime = new KnowledgeToolRuntime({ layout, settingsStore, registryStore, projectStore, cwd: temp });
-    const entry = await runtime.get({ projectId: 'project-consumer', entry: 'modules/api.md' });
-    assert.match(entry.chunks[0].chunk_text, /# API/);
-    await assert.rejects(runtime.get({ projectId: 'project-consumer', entry: '../settings.json' }), error => error.code === 'PATH_OUTSIDE_ROOT');
-    await runtime.close();
-    console.log('pr-consumer-contract-test PASS');
-  } finally {
-    fs.rmSync(temp, { 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 { StorageLayout } = require('../lib/storage-layout');
+const { SettingsStore } = require('../lib/settings-store');
+const { ProjectRegistryStore } = require('../lib/project-registry-store');
+const { ProjectStore } = require('../lib/project-store');
+const { KnowledgeToolRuntime } = require('../lib/knowledge-tool-runtime');
+const { validateKb, buildPrContextPack } = require('../lib/kb-validator');
+const { regenerateIndexes } = require('../lib/index-builder');
+
+const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'pkb-pr-v2-'));
+const knowledgePath = path.join(temp, 'knowledge');
+
+function writeKnowledge() {
+  fs.mkdirSync(path.join(knowledgePath, 'modules'), { recursive: true });
+  fs.mkdirSync(path.join(knowledgePath, 'changes'), { recursive: true });
+  fs.writeFileSync(path.join(knowledgePath, 'README.md'), '# Test KB\n');
+  fs.writeFileSync(path.join(knowledgePath, 'GOAL.md'), '# Goal\n');
+  fs.writeFileSync(path.join(knowledgePath, 'ARCHITECTURE.md'), '# Architecture\n');
+  fs.writeFileSync(path.join(knowledgePath, 'modules', 'api.md'), '---\ntags: [api]\nsourcePaths: [src/api.js]\n---\n# API\n');
+  fs.writeFileSync(path.join(knowledgePath, 'changes', 'api-change.md'), '---\ntags: [api]\naffectedModules: [api]\ndevelopmentIntent: Add API memory.\n---\n# API change\n\n## Development Intent\nAdd API memory.\n\n## Implementation Result\nDone.\n\n## Evidence\n- src/api.js\n');
+  regenerateIndexes(knowledgePath);
+}
+
+(async () => {
+  try {
+    writeKnowledge();
+    const validation = validateKb(knowledgePath);
+    assert(validation.ok, JSON.stringify(validation.errors));
+    const pack = buildPrContextPack(knowledgePath);
+    assert(pack.ok);
+    assert.strictEqual(pack.pack.schema, 'pr-context-pack/v1');
+    assert(pack.pack.trustedKnowledge.some(item => item.path === 'modules/api.md'));
+    assert(!JSON.stringify(pack.pack).includes('_ai/'));
+
+    const layout = new StorageLayout({ dataDir: path.join(temp, 'data') });
+    const settingsStore = new SettingsStore({ layout });
+    const registryStore = new ProjectRegistryStore({ layout });
+    const projectStore = new ProjectStore({ layout });
+    await settingsStore.initialize({ knowledge: { rootPath: path.join(temp, 'future') } });
+    await registryStore.initialize();
+    await projectStore.create('project-consumer', { displayName: 'Consumer', storageName: 'consumer', repoPath: temp, knowledgePath }, { index: { dirty: true, generation: 1 } });
+    await registryStore.add('project-consumer', { displayNameSnapshot: 'Consumer' });
+    const runtime = new KnowledgeToolRuntime({ layout, settingsStore, registryStore, projectStore, cwd: temp });
+    const entry = await runtime.get({ projectId: 'project-consumer', entry: 'modules/api.md' });
+    assert.match(entry.chunks[0].chunk_text, /# API/);
+    await assert.rejects(runtime.get({ projectId: 'project-consumer', entry: '../settings.json' }), error => error.code === 'PATH_OUTSIDE_ROOT');
+    await runtime.close();
+    console.log('pr-consumer-contract-test PASS');
+  } finally {
+    fs.rmSync(temp, { recursive: true, force: true });
+  }
+})().catch(error => { console.error(error); process.exitCode = 1; });

package/_site/_test/product-brand-contract-test.js

@@ -1,25 +1,25 @@
-'use strict';
-
-const assert = require('node:assert/strict');
-const fs = require('node:fs');
-const path = require('node:path');
-
-const ui = path.resolve(__dirname, '../../ui');
-const html = fs.readFileSync(path.join(ui, 'index.html'), 'utf8');
-const css = fs.readFileSync(path.join(ui, 'product.css'), 'utf8');
-const mark = fs.readFileSync(path.join(ui, 'favicon.svg'), 'utf8');
-const favicon = html.match(/<link\b(?=[^>]*\brel="icon")[^>]*\bhref="([^"]+)"/);
-const sidebar = html.match(/<img\b(?=[^>]*\bclass="brand-mark")[^>]*\bsrc="([^"]+)"/);
-
-assert(favicon, 'Product needs an SVG favicon.');
-assert(sidebar, 'Sidebar must use the product mark, not a second drawn icon.');
-assert.equal(sidebar[1], favicon[1], 'Favicon and sidebar must share the exact asset URL.');
-assert.equal(favicon[1].split('?')[0], '/favicon.svg');
-assert.match(favicon[1], /\?v=/, 'Brand changes need a new browser cache identity.');
-assert.match(mark, /viewBox="0 0 64 64"/);
-assert.match(mark, /fill="#516f89"/);
-assert.equal((mark.match(/<path\b/g) || []).length, 1, 'Keep one geometric silhouette.');
-assert.doesNotMatch(mark, /<(?:script|image|text|filter|linearGradient|radialGradient)\b/i);
-assert.doesNotMatch(html, /<span class="brand-mark">知<\/span>/);
-assert.match(css, /\.brand-mark\{[^}]*width:32px;[^}]*height:32px;[^}]*flex:none/);
-console.log('PASS product brand: shared SVG, cache identity, fixed-size layout, no decorative dependencies');
+'use strict';
+
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const ui = path.resolve(__dirname, '../../ui');
+const html = fs.readFileSync(path.join(ui, 'index.html'), 'utf8');
+const css = fs.readFileSync(path.join(ui, 'product.css'), 'utf8');
+const mark = fs.readFileSync(path.join(ui, 'favicon.svg'), 'utf8');
+const favicon = html.match(/<link\b(?=[^>]*\brel="icon")[^>]*\bhref="([^"]+)"/);
+const sidebar = html.match(/<img\b(?=[^>]*\bclass="brand-mark")[^>]*\bsrc="([^"]+)"/);
+
+assert(favicon, 'Product needs an SVG favicon.');
+assert(sidebar, 'Sidebar must use the product mark, not a second drawn icon.');
+assert.equal(sidebar[1], favicon[1], 'Favicon and sidebar must share the exact asset URL.');
+assert.equal(favicon[1].split('?')[0], '/favicon.svg');
+assert.match(favicon[1], /\?v=/, 'Brand changes need a new browser cache identity.');
+assert.match(mark, /viewBox="0 0 64 64"/);
+assert.match(mark, /fill="#516f89"/);
+assert.equal((mark.match(/<path\b/g) || []).length, 1, 'Keep one geometric silhouette.');
+assert.doesNotMatch(mark, /<(?:script|image|text|filter|linearGradient|radialGradient)\b/i);
+assert.doesNotMatch(html, /<span class="brand-mark">知<\/span>/);
+assert.match(css, /\.brand-mark\{[^}]*width:32px;[^}]*height:32px;[^}]*flex:none/);
+console.log('PASS product brand: shared SVG, cache identity, fixed-size layout, no decorative dependencies');