@sanqianx/project-knowledge 5.0.0 → 5.0.1

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
   "plugins": [
     {
       "name": "project-knowledge",
-      "version": "5.0.0",
+      "version": "5.0.1",
       "source": "./plugins/project-knowledge",
       "description": "Search durable project decisions and implementation history through MCP."
     }

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [5.0.1] - 2026-10-10
+
+- Fix project import on Git versions before 2.31: query hooks and common Git
+  directories without `--path-format`, then resolve relative paths against the
+  Git command's working directory. Reject empty, multi-line or echoed-option
+  responses before writing hooks or repository identities.
+- Apply the same correction to commit capture and pin event-bridge console
+  0.7.1 so importing a project and capturing its next commit use consistent
+  workspace metadata. No previous data is migrated.
+- Keep import failure feedback visible with its error code and operation ID.
+  Persist the actual failed transaction stage; system diagnostics default to
+  all projects so failures of not-yet-registered imports are visible/exportable.
+
 ## [5.0.0] - 2026-10-10
 
 - Fresh-data-only web product. Default state moves to `~/.project-knowledge-v5`;

package/_site/_test/git-path-compatibility-test.js

@@ -0,0 +1,80 @@
+const assert = require('assert/strict');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+const { resolveGitPath } = require('../lib/git-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 { ProjectLifecycleService } = require('../lib/project-lifecycle-service');
+const { BridgeAdapter } = require('../lib/bridge-adapter');
+const { Logger, LogRepository } = require('../lib/structured-logger');
+const hooks = require('../lib/hook-manager');
+
+(async () => {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-git-path-'));
+  const repo = path.join(root, '中文 空格项目'); fs.mkdirSync(repo);
+  const git = (args, cwd = repo) => {
+    const result = spawnSync('git', args, { cwd, encoding: 'utf8', windowsHide: true });
+    assert.equal(result.status, 0, result.stderr); return result.stdout.trim();
+  };
+  for (const invalid of ['', '--path-format=absolute\n.git/hooks', '.git/hooks\nother', '--unsupported', '\0']) {
+    assert.throws(() => resolveGitPath(repo, invalid), { code: 'INVALID_ARGUMENT' });
+  }
+  assert.equal(resolveGitPath(repo, '.git/hooks\r\n'), path.join(repo, '.git', 'hooks'));
+  git(['init', '-q']); git(['config', 'user.name', 'Git Compatibility']); git(['config', 'user.email', 'git-compat@example.invalid']);
+  fs.writeFileSync(path.join(repo, 'README.md'), '# baseline\n'); git(['add', '.']); git(['commit', '-qm', 'baseline']);
+  const layout = new StorageLayout({ dataDir: path.join(root, 'data') });
+  const settingsStore = new SettingsStore({ layout });
+  const registryStore = new ProjectRegistryStore({ layout });
+  const projectStore = new ProjectStore({ layout });
+  await settingsStore.initialize({ knowledge: { rootPath: path.join(root, 'knowledge') } });
+  await registryStore.initialize();
+  const bridgeAdapter = new BridgeAdapter({ dataDir: layout.getDataDir(), bridgeHomeDir: path.join(root, 'bridge') });
+  assert.ok(bridgeAdapter.isAvailable());
+  const logger = new Logger({ layout });
+  const triggerScriptPath = path.resolve(__dirname, '../scripts/hook-trigger.js');
+  const options = { layout, settingsStore, registryStore, projectStore, bridgeAdapter, logger, triggerScriptPath };
+  const lifecycle = new ProjectLifecycleService(options);
+  const input = { localPath: repo, knowledgePath: path.join(root, 'knowledge', 'fresh'), projectId: 'project-git-compat' };
+  const preflight = await lifecycle.preflightImport(input);
+  assert.equal(preflight.ready, true);
+  assert.equal(preflight.checks.git.commonDir, path.join(repo, '.git'));
+  const imported = await lifecycle.importProject(input);
+  assert.equal(imported.hook.hookPath, path.join(repo, '.git', 'hooks', 'post-commit'));
+  assert.equal(imported.config.repoIdentity.commonDir, path.join(repo, '.git'));
+  const nested = path.join(repo, 'src'); fs.mkdirSync(nested);
+  assert.equal((await bridgeAdapter.resolveRepoIdentity(nested)).repoIdentity.commonDir, imported.config.repoIdentity.commonDir);
+  fs.appendFileSync(path.join(repo, 'README.md'), 'commit after import\n'); git(['add', '.']); git(['commit', '-qm', 'captured update']);
+  const sha = git(['rev-parse', 'HEAD']);
+  const journal = await bridgeAdapter.readEvents({ after: 0, limit: 100 });
+  const boundary = journal.events.find(event => event.commitSha === sha && event.schema === 'git-commit-boundary/v1');
+  assert.ok(boundary, 'real Git post-commit Hook must append a durable boundary');
+  assert.equal(boundary.repoIdentity.commonDir, path.join(repo, '.git'));
+  assert.equal(boundary.projectId, input.projectId);
+  await lifecycle.deleteProject(input.projectId);
+  const brokenRegistry = Object.create(registryStore);
+  brokenRegistry.add = async () => { throw new Error('diagnostic registry failure'); };
+  await assert.rejects(new ProjectLifecycleService({ ...options, registryStore: brokenRegistry }).importProject(input), /Project import failed/);
+  const failed = new LogRepository({ layout }).query({ event: 'project.import.failed' }).entries[0];
+  assert.equal(failed.error.message, 'diagnostic registry failure');
+  assert.equal(failed.phase, 'hook-verified');
+  const transaction = JSON.parse(fs.readFileSync(lifecycle.transactionPath(failed.operationId), 'utf8'));
+  assert.equal(transaction.phase, 'failed'); assert.equal(transaction.failurePhase, 'hook-verified');
+  assert.equal(hooks.readHookStatus({ repoPath: repo }).installed, false);
+  const worktree = path.join(root, '关联 工作树'); git(['worktree', 'add', '-qb', 'linked', worktree]);
+  const sharedHook = hooks.installHook({ repoPath: worktree, projectId: 'project-worktree', triggerScriptPath });
+  assert.equal(path.dirname(sharedHook.hookPath), path.join(repo, '.git', 'hooks'));
+  hooks.uninstallHook({ repoPath: worktree, projectId: 'project-worktree' });
+  for (const custom of ['.custom hooks', path.join(root, '绝对 hooks')]) {
+    git(['config', 'core.hooksPath', custom], worktree);
+    const installed = hooks.installHook({ repoPath: worktree, projectId: 'project-worktree', triggerScriptPath });
+    assert.equal(path.dirname(installed.hookPath), path.resolve(worktree, custom));
+    assert.equal(hooks.readHookStatus({ repoPath: worktree }).installed, true);
+    hooks.uninstallHook({ repoPath: worktree, projectId: 'project-worktree' });
+  }
+  await logger.close();
+  console.log(`git-path-compatibility-test PASS (${git(['--version'])}; import → real Hook → journal; worktrees/custom hooks; diagnostic phase)`);
+})().catch(error => { console.error(error.stack || error.message); process.exitCode = 1; });

package/_site/_test/product-diagnostics-ui-test.js

@@ -8,10 +8,17 @@ const { spawnServer } = require('./helpers/spawn-server');
 const { findChrome } = require('./helpers/find-chrome');
 const { launchCdpBrowser, waitFor } = require('./helpers/cdp-browser');
 const { createLoggingUiFixture } = require('./helpers/logging-ui-fixture');
+const { Logger } = require('../lib/structured-logger');
+const { StorageLayout } = require('../lib/storage-layout');
 const ROOT = path.resolve(__dirname, '../..');
 
 async function main() {
-  const fixture = await createLoggingUiFixture({ totalLogs: 240 });
+  const fixture = await createLoggingUiFixture({ totalLogs: 240, freshProduct: true });
+  const logger = new Logger({ layout: new StorageLayout({ dataDir: fixture.dataDir }) });
+  await logger.error('project.import.failed', 'Import failed for an unregistered project', {
+    projectId: 'project-import-not-registered', operationId: 'op-import-diagnostic',
+    error: Object.assign(new Error('Git Hook path resolution failed'), { code: 'ENOENT' })
+  });
   const offline = http.createServer((req, res) => { res.writeHead(503, { 'content-type': 'application/json' }); res.end(JSON.stringify({ ok: false, error: { message: '验收中的离线模块' } })); });
   await new Promise(resolve => offline.listen(0, '127.0.0.1', resolve));
   const offlineUrl = `http://127.0.0.1:${offline.address().port}`;
@@ -35,6 +42,13 @@ async function main() {
     assert.ok(await run("document.getElementById('activityUpdates').textContent.includes('离线')"), 'offline cannot masquerade as empty/success');
     await click('#openSystem'); await click('#openLogs');
     await waitFor(() => run("document.querySelectorAll('#logsContent .log-entry').length === 100"), 'bounded diagnostic rendering');
+    assert.equal(await run("document.getElementById('logsScope').value"), 'all');
+    await run("document.getElementById('logsSearch').value='op-import-diagnostic'"); await click('#loadLogs');
+    await waitFor(() => run("document.getElementById('logsContent').textContent.includes('ENOENT')"), 'unregistered import visible despite active project');
+    await run("document.getElementById('logsScope').value='project'; document.getElementById('logsScope').dispatchEvent(new Event('change'))");
+    await waitFor(() => run("document.querySelectorAll('#logsContent .log-entry').length === 0"), 'current project excludes failed new import');
+    await run("document.getElementById('logsScope').value='all'; document.getElementById('logsScope').dispatchEvent(new Event('change'))");
+    await waitFor(() => run("document.getElementById('logsContent').textContent.includes('op-import-diagnostic')"), 'global diagnostic scope restored');
     assert.equal(await run("document.querySelectorAll('#logsDialog img, #logsDialog script').length"), 0);
     await run("document.getElementById('logsSearch').value='<img src=x onerror=window.__xss=1>'"); await click('#loadLogs');
     await waitFor(() => run("document.querySelectorAll('#logsContent .log-entry').length === 1"), 'real server query filter');
@@ -59,8 +73,8 @@ async function main() {
     // The registry does not own knowledge bytes. Use its actual double-directory binding.
     const project = (await (await fetch(base + '/api/projects/aggregated')).json()).projects[0];
     const retained = path.join(project.knowledgePath, 'keep.md'); fs.writeFileSync(retained, '# 保留知识\n');
-    await run('window.confirm = () => true'); await click('[data-action="unbind"]');
-    await waitFor(() => run("document.getElementById('toast').textContent.includes('无法安全停止写入')"), 'offline writer prevents unsafe unbind');
+    await click('[data-action="unbind"]'); await click('#confirmUnbind');
+    await waitFor(() => run("document.getElementById('unbindFeedback').textContent.includes('无法安全停止写入')"), 'offline writer prevents unsafe unbind');
     assert.equal((await (await fetch(base + '/api/projects/aggregated')).json()).projects.length, 1);
     assert.deepEqual(fs.readdirSync(fixture.repo.path), codeFiles); assert.ok(fs.existsSync(retained));
     assert.equal(browser.exceptions.length, 0, JSON.stringify(browser.exceptions));

package/_site/_test/product-import-ui-test.js

@@ -66,6 +66,18 @@ async function main() {
     await waitFor(() => run("document.getElementById('importDialog').open && !document.getElementById('confirmImport').disabled"), 'setup returns to ready import');
     const values = await run("Object.fromEntries(['importCode','importKnowledge','importName','importDomain'].map(id=>[id,document.getElementById(id).value]))");
     assert.deepEqual(values, { importCode: repo, importKnowledge: knowledge, importName: '回归项目', importDomain: domainId });
+    const racedHook = path.join(repo, '.git', 'hooks', 'post-commit');
+    fs.writeFileSync(racedHook, '#!/bin/sh\necho third-party fixture\n');
+    await click('#confirmImport');
+    await waitFor(() => run("document.getElementById('preflightStatus').textContent.includes('HOOK_CONFLICT') && document.getElementById('preflightStatus').textContent.includes('操作 ID：op-')"), 'durable import failure feedback');
+    await new Promise(resolve => setTimeout(resolve, 750));
+    assert.ok(await run("document.getElementById('preflightStatus').textContent.includes('HOOK_CONFLICT')"), 'failed import must not turn back into a passed preflight');
+    assert.equal((await api('/api/projects/aggregated')).projects.length, 0);
+    assert.equal(fs.readFileSync(racedHook, 'utf8'), '#!/bin/sh\necho third-party fixture\n');
+    const failureLogs = (await api('/api/logs?event=project.import.failed')).entries;
+    assert.equal(failureLogs.length, 1); assert.equal(failureLogs[0].error.code, 'HOOK_CONFLICT');
+    assert.ok(await run(`document.getElementById('preflightStatus').textContent.includes(${JSON.stringify(failureLogs[0].operationId)})`), 'UI operation ID resolves to the persisted failure');
+    fs.unlinkSync(racedHook);
     await click('#confirmImport');
     await waitFor(() => run("!document.getElementById('importDialog').open && document.getElementById('projectDetail').textContent.includes('回归项目')"), 'import feedback', 30000);
     const selected = await run("document.getElementById('projectSelect').value");

package/_site/lib/git-path.js

@@ -0,0 +1,14 @@
+const path = require('path');
+const { DomainError } = require('./contracts');
+
+function resolveGitPath(cwd, output) {
+  const value = String(output || '').trim();
+  // rev-parse may echo unsupported flags with exit code 0. Never let a
+  // multi-line response become a filesystem path or a repository identity.
+  if (!value || /[\r\n\0]/.test(value) || value.startsWith('--')) {
+    throw new DomainError('INVALID_ARGUMENT', 'Git 返回了无效的目录路径，请检查 Git 安装。', { status: 400 });
+  }
+  return path.resolve(cwd, value);
+}
+
+module.exports = { resolveGitPath };

package/_site/lib/hook-manager.js

@@ -3,6 +3,7 @@ const path = require('path');
 const { spawnSync } = require('child_process');
 const AtomicFile = require('./atomic-file');
 const { DomainError, validateProjectId } = require('./contracts');
+const { resolveGitPath } = require('./git-path');
 
 const HOOK_NAME = 'post-commit';
 const HOOK_MARKER = '# PROJECT-KNOWLEDGE-HOOK ';
@@ -28,13 +29,12 @@ function runGit(repoPath, args) {
 function resolveGitHooksDir(_gitDir, repoPath) {
   if (!repoPath) throw new DomainError('INVALID_ARGUMENT', 'repoPath is required.');
   const absolute = path.resolve(repoPath);
-  const hooksPath = runGit(absolute, ['rev-parse', '--path-format=absolute', '--git-path', 'hooks']);
-  if (!hooksPath) throw new DomainError('HOOK_INVALID', 'Git returned an empty hooks path.', { status: 400 });
-  return path.resolve(absolute, hooksPath);
+  const hooksPath = runGit(absolute, ['rev-parse', '--git-path', 'hooks']);
+  return resolveGitPath(absolute, hooksPath);
 }
 
 function repoGitDir(repoPath) {
-  try { return runGit(path.resolve(repoPath), ['rev-parse', '--path-format=absolute', '--git-dir']); }
+  try { return resolveGitPath(path.resolve(repoPath), runGit(path.resolve(repoPath), ['rev-parse', '--git-dir'])); }
   catch { return null; }
 }
 

package/_site/lib/post-commit-automation.js

@@ -27,7 +27,7 @@ async function handlePostCommitEvent(event = {}, deps = {}) {
   if (!resolved.registryStore.readDisplaySnapshot(projectId)) throw new DomainError('PROJECT_NOT_FOUND', 'Hook projectId is not registered.', { status: 404 });
   const config = resolved.projectStore.readConfig(projectId);
   const runtimeRoot = path.resolve(runGit(path.resolve(event.repoRoot), ['rev-parse', '--show-toplevel']).stdout);
-  const commonDir = path.resolve(runGit(runtimeRoot, ['rev-parse', '--path-format=absolute', '--git-common-dir']).stdout);
+  const commonDir = path.resolve(runtimeRoot, runGit(runtimeRoot, ['rev-parse', '--git-common-dir']).stdout);
   if (config.repoIdentity && config.repoIdentity.commonDir
     && !resolved.layout.pathsEqual(config.repoIdentity.commonDir, commonDir)) {
     if (fs.existsSync(config.repoPath)) {

package/_site/lib/project-lifecycle-service.js

@@ -6,6 +6,7 @@ const { DomainError, createId } = require('./contracts');
 const AtomicFile = require('./atomic-file');
 const hookManagerDefault = require('./hook-manager');
 const { resolveEffectiveAiProfile } = require('./ai-profile-resolver');
+const { resolveGitPath } = require('./git-path');
 
 function slugify(value) {
   const slug = String(value || '').trim().toLowerCase().replace(/[^a-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '');
@@ -86,12 +87,12 @@ class ProjectLifecycleService {
         checks.git = { ok: false, status: 'non-git', plannedInit: true, message: 'Directory is not a Git repository. Import will run `git init` before proceeding.' };
       } else {
         const head = runGit(localPath, ['rev-parse', '--verify', 'HEAD'], { allowFailure: true });
-        const commonDir = runGit(localPath, ['rev-parse', '--path-format=absolute', '--git-common-dir']);
+        const commonDir = runGit(localPath, ['rev-parse', '--git-common-dir']);
         const branch = runGit(localPath, ['branch', '--show-current'], { allowFailure: true });
         repoInspection = {
           ok: true,
           repoPath: top.ok ? path.resolve(top.stdout) : path.resolve(localPath),
-          commonDir: commonDir.ok ? path.resolve(commonDir.stdout) : '',
+          commonDir: commonDir.ok ? resolveGitPath(localPath, commonDir.stdout) : '',
           headCommit: head.ok ? head.stdout : null,
           branch: branch.ok ? branch.stdout : '',
           emptyRepo: !head.ok,
@@ -270,9 +271,9 @@ class ProjectLifecycleService {
       journal.gitInitialized = initialized.ok;
     }
     const top = runGit(repoPath, ['rev-parse', '--show-toplevel']).stdout;
-    const commonDir = runGit(repoPath, ['rev-parse', '--path-format=absolute', '--git-common-dir']).stdout;
+    const commonDir = runGit(repoPath, ['rev-parse', '--git-common-dir']).stdout;
     const head = runGit(repoPath, ['rev-parse', '--verify', 'HEAD'], { allowFailure: true });
-    return { repoPath: path.resolve(top), commonDir: path.resolve(commonDir), head: head.ok ? head.stdout : null };
+    return { repoPath: path.resolve(top), commonDir: resolveGitPath(repoPath, commonDir), head: head.ok ? head.stdout : null };
   }
 
   async importProject(input = {}) {
@@ -376,14 +377,18 @@ class ProjectLifecycleService {
       await log.info?.('project.import.completed', 'Project import completed.', { projectId, phase: 'registry-commit', durationMs: Date.now() - Date.parse(journal.startedAt) });
       return { ok: true, operationId, projectId, config: created.config, state: created.state, hook, gitInitialized: journal.gitInitialized === true };
     } catch (error) {
+      journal.failurePhase = journal.phase;
       const rollbackWarnings = await this.rollbackImport(journal);
       journal.phase = 'failed';
       journal.failedAt = new Date().toISOString();
       journal.error = { code: error.code || '', message: String(error.message || error) };
       journal.rollbackWarnings = rollbackWarnings;
       this.writeJournal(journal);
-      await log.error?.('project.import.failed', 'Project import failed.', { projectId: journal.projectId || '', phase: journal.phase, error, context: { rollbackWarnings } });
-      if (error instanceof DomainError) throw error;
+      await log.error?.('project.import.failed', 'Project import failed.', { projectId: journal.projectId || '', phase: journal.failurePhase, error, context: { rollbackWarnings } });
+      if (error instanceof DomainError) {
+        if (!error.operationId) error.operationId = operationId;
+        throw error;
+      }
       throw new DomainError('INVALID_ARGUMENT', 'Project import failed.', { status: 500, operationId, cause: error, details: { rollbackWarnings } });
     }
   }

package/_site/lib/requirement-recorder.js

@@ -98,9 +98,9 @@ class GitReader {
       const top = topResult.status === 0 && String(topResult.stdout || '').trim()
         ? path.resolve(String(topResult.stdout).trim())
         : null;
-      const commonResult = this.run(repoPath, ['rev-parse', '--path-format=absolute', '--git-common-dir']);
+      const commonResult = this.run(repoPath, ['rev-parse', '--git-common-dir']);
       const commonDir = commonResult.status === 0 && String(commonResult.stdout || '').trim()
-        ? path.resolve(String(commonResult.stdout).trim())
+        ? path.resolve(repoPath, String(commonResult.stdout).trim())
         : null;
       let repoIdentity = null;
       if (top && bridgeIdentityModule) {

package/_site/lib/server-app.js

@@ -234,12 +234,12 @@ async function inspectGitRepository(repoPath) {
     execGit(root, ['rev-parse', '--verify', 'HEAD']),
     execGit(root, ['branch', '--show-current']),
     execGit(root, ['status', '--porcelain=v1', '--untracked-files=normal']),
-    execGit(root, ['rev-parse', '--path-format=absolute', '--git-common-dir']),
+    execGit(root, ['rev-parse', '--git-common-dir']),
   ]);
   return {
     repoStatus: head.ok ? 'ok' : 'empty',
     repoPath: top.ok ? path.resolve(top.stdout.trim()) : root,
-    commonDir: commonDir.ok ? path.resolve(commonDir.stdout.trim()) : '',
+    commonDir: commonDir.ok ? path.resolve(root, commonDir.stdout.trim()) : '',
     headCommit: head.ok ? head.stdout.trim() : null,
     branch: branch.ok ? branch.stdout.trim() : '',
     dirty: status.ok && Boolean(status.stdout.trim()),

package/_site/scripts/hook-trigger.js

@@ -8,6 +8,7 @@ const { readLiveEndpoint } = require('../lib/runtime-endpoint');
 const { StorageLayout } = require('../lib/storage-layout');
 const { Logger } = require('../lib/structured-logger');
 const { BridgeAdapter } = require('../lib/bridge-adapter');
+const { resolveGitPath } = require('../lib/git-path');
 
 let bridgeIdentityModule = null;
 try {
@@ -96,11 +97,11 @@ function post(body) {
       if (toplevel) {
         let workspaceRoot = path.resolve(toplevel);
         try { workspaceRoot = fs.realpathSync.native(workspaceRoot) || workspaceRoot; } catch { workspaceRoot = path.resolve(toplevel); }
-        const commonDir = git(['rev-parse', '--path-format=absolute', '--git-common-dir']);
+        const commonDir = git(['rev-parse', '--git-common-dir']);
         const remoteRaw = git(['config', '--get', 'remote.origin.url']);
         repoIdentity = bridgeIdentityModule.buildRepoIdentityV1({
           workspaceRoot,
-          commonDir: commonDir ? path.resolve(commonDir) : null,
+          commonDir: commonDir ? resolveGitPath(repoRoot, commonDir) : null,
           remote: remoteRaw ? bridgeIdentityModule.normalizeGitUrl(remoteRaw) : null,
         });
       }

package/docs/fresh-v5-start.md

@@ -17,6 +17,12 @@ project-knowledge
 
 如果模块是自己独立启动的旧进程，请在它原来的终端中停止后重启新版外壳。外壳不会擅自杀死其他服务；版本或运行期鉴权不一致时显示具体连接阶段，不接管旧服务数据。
 
+5.0.1 修复旧版 Git 的项目导入失败（日志中的路径包含
+`--path-format=absolute` 和换行）。升级 5.0.0 → 5.0.1 不需要清空新版数据或
+重新配置模型。失败项目可以直接重试导入；原代码、第三方 Hook 与旧知识文件不删除。
+导入失败会在弹窗保留错误码和操作 ID，系统诊断默认查询“系统与所有项目”，
+可按操作 ID 查找导入事务的真实失败阶段和原始错误。
+
 ## 解绑与恢复
 
 “解绑并保留数据”从项目列表移除登记、取消未开始任务并卸下本项目托管 Hook，保留代码、知识、会话及证据。实际分析或索引写入尚未结束时仍禁止解绑，防止丢失写入状态。队列本身不再被当成正在运行。

package/module-runtime-manifest.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanqianx/project-knowledge",
-  "version": "5.0.0",
+  "version": "5.0.1",
   "description": "Knowledge base manager with Git integration, AI-driven analysis, and bilingual (zh-CN/en-US) knowledge output",
   "main": "_site/server.js",
   "scripts": {
@@ -80,7 +80,7 @@
     "@huggingface/transformers": "3.8.1",
     "@lancedb/lancedb": "0.31.0",
     "@modelcontextprotocol/sdk": "1.29.0",
-    "@sanqianx/ai-coding-event-bridge-console": "0.7.0",
+    "@sanqianx/ai-coding-event-bridge-console": "0.7.1",
     "@sanqianx/vector-hub": "1.0.7",
     "buffer": "^6.0.3",
     "cheerio": "^1.2.0",

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

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

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

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

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

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

package/ui/index.html

@@ -32,7 +32,7 @@
   </main>
 </div>
 <div id="drawerBackdrop" class="drawer-backdrop" hidden></div>
-<dialog id="logsDialog" class="reference-dialog"><div class="dialog-heading"><h2>系统诊断记录</h2><button data-close="logsDialog" aria-label="关闭">×</button></div><div class="actions"><input id="logsSearch" placeholder="查找失败原因或提交 SHA" aria-label="筛选诊断记录"><button id="loadLogs">查询</button><button id="exportLogs">导出诊断记录</button></div><div id="logsStatus" class="muted"></div><div id="logsContent"></div></dialog>
+<dialog id="logsDialog" class="reference-dialog"><div class="dialog-heading"><h2>系统诊断记录</h2><button data-close="logsDialog" aria-label="关闭">×</button></div><div class="actions"><select id="logsScope" aria-label="诊断范围"><option value="all">系统与所有项目</option><option value="project">当前项目</option></select><input id="logsSearch" placeholder="查找失败原因、操作 ID 或提交 SHA" aria-label="筛选诊断记录"><button id="loadLogs">查询</button><button id="exportLogs">导出诊断记录</button></div><div id="logsStatus" class="muted"></div><div id="logsContent"></div></dialog>
 <aside class="drawer" id="systemDrawer" hidden aria-label="系统状态">
   <header><h2>系统状态</h2><button id="closeSystem" class="icon-button" aria-label="关闭系统状态">×</button></header>
   <div class="drawer-content">

package/ui/product.js

@@ -25,7 +25,7 @@
     if (init.body) init.headers = { 'Content-Type': 'application/json', ...init.headers };
     const response = await fetch(url, init);
     const data = await response.json();
-    if (!response.ok || data.ok === false && !allowNotReady) throw Object.assign(new Error(data.error?.message || data.message || (typeof data.error === 'string' ? data.error : `请求失败 (${response.status})`)), { code: data.error?.code || data.error });
+    if (!response.ok || data.ok === false && !allowNotReady) throw Object.assign(new Error(data.error?.message || data.message || (typeof data.error === 'string' ? data.error : `请求失败 (${response.status})`)), { code: data.error?.code || data.error, operationId: data.error?.operationId || response.headers.get('X-Operation-Id') || '' });
     return data;
   }
   function toast(text) { $('toast').textContent = text; $('toast').hidden = false; clearTimeout(toastTimer); toastTimer = setTimeout(() => { $('toast').hidden = true; }, 4000); }
@@ -188,16 +188,17 @@
     const epoch = ++logEpoch;
     logStream?.close(); logStream = null;
     const params = new URLSearchParams({ pageSize: '100', q: $('logsSearch').value.trim() });
-    if (state.projectId) params.set('projectId', state.projectId);
+    const projectOnly = $('logsScope').value === 'project' && Boolean(state.projectId);
+    if (projectOnly) params.set('projectId', state.projectId);
     const result = await api(`/api/logs?${params}`);
     if (epoch !== logEpoch || !$('logsDialog').open) return;
     $('logsDialog').dataset.streamCursor = result.streamCursor || '';
     $('logsContent').replaceChildren();
     for (const record of [...(result.entries || [])].reverse()) appendLog(record);
-    $('logsStatus').textContent = `${(result.entries || []).length} 条诊断记录 · 当前项目`;
+    $('logsStatus').textContent = `${(result.entries || []).length} 条诊断记录 · ${projectOnly ? '当前项目' : '系统与所有项目'}`;
     if (!$('logsSearch').value.trim()) {
       const streamParams = new URLSearchParams({ streamCursor: result.streamCursor || '' });
-      if (state.projectId) streamParams.set('projectId', state.projectId);
+      if (projectOnly) streamParams.set('projectId', state.projectId);
       logStream = new EventSource(`/api/logs/stream?${streamParams}`);
       logStream.addEventListener('logs/appended', event => { if (epoch === logEpoch && $('logsDialog').open) appendLog(JSON.parse(event.data).record); });
     }
@@ -350,6 +351,7 @@
   on('engineDialog', 'close', () => post('engine', { type: 'kb:visibility', visible: false }));
   on('openLogs', 'click', async () => { closeSystem(); $('logsDialog').showModal(); await loadLogs(); });
   on('logsDialog', 'close', () => { logEpoch++; logStream?.close(); logStream = null; });
+  on('logsScope', 'change', loadLogs);
   on('copyReference', 'click', async () => {
     const text = $('referenceMeta').textContent + '\n\n' + $('referenceContent').textContent;
     try { await navigator.clipboard.writeText(text); }
@@ -357,7 +359,7 @@
     toast('已复制知识与来源。');
   });
   on('loadLogs', 'click', loadLogs);
-  on('exportLogs', 'click', async () => { const params = new URLSearchParams({ q: $('logsSearch').value.trim() }); if (state.projectId) params.set('projectId', state.projectId); const response = await fetch(`/api/logs/export?${params}`); if (!response.ok) throw new Error('诊断导出失败。'); const blob = await response.blob(); const url = URL.createObjectURL(blob); const link = document.createElement('a'); link.href = url; link.download = 'knowledge-diagnostics.jsonl'; link.click(); setTimeout(() => URL.revokeObjectURL(url), 1000); });
+  on('exportLogs', 'click', async () => { const params = new URLSearchParams({ q: $('logsSearch').value.trim() }); if ($('logsScope').value === 'project' && state.projectId) params.set('projectId', state.projectId); const response = await fetch(`/api/logs/export?${params}`); if (!response.ok) throw new Error('诊断导出失败。'); const blob = await response.blob(); const url = URL.createObjectURL(blob); const link = document.createElement('a'); link.href = url; link.download = 'knowledge-diagnostics.jsonl'; link.click(); setTimeout(() => URL.revokeObjectURL(url), 1000); });
   on('createDomain', 'click', () => { $('domainForm').reset(); $('domainDialog').showModal(); });
   on('domainForm', 'submit', async e => { e.preventDefault(); await api('/api/domains', { method: 'POST', body: Object.fromEntries(new FormData(e.target)) }); $('domainDialog').close(); await refreshRegistry(); });
   on('memoryForm', 'submit', async e => { e.preventDefault(); await api(`/api/engine/memories/${encodeURIComponent(editingMemoryId)}`, { method: 'PATCH', body: { text: $('memoryText').value } }); $('memoryDialog').close(); await refreshSnapshot(); });
@@ -388,8 +390,15 @@
   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(); }
+    let failed = false, registered = false;
+    try { const result = await api('/api/projects/import', { method: 'POST', body: importInput() }); registered = true; state.projectId = result.projectId; state.epoch++; $('importDialog').close(); await refreshRegistry(); Object.keys(frames).forEach(frameContext); setView('projects'); toast(Object.values(result.modules).every(m => m.ok) ? '项目已导入，四个模块已连接。' : '项目已导入，部分接线待恢复。'); }
+    catch (error) {
+      failed = true;
+      if (registered) { toast(`项目已登记，但页面状态刷新失败：${error.message}`); return; }
+      $('preflightStatus').textContent = `导入失败：${error.message}\n错误码：${error.code || 'UNKNOWN'}${error.operationId ? `\n操作 ID：${error.operationId}` : ''}\n请在系统诊断记录中查看详细原因。`;
+      $('preflightStatus').classList.add('issue'); $('confirmImport').disabled = false;
+    }
+    finally { $('confirmImport').textContent = '导入项目'; if ($('importDialog').open && !failed) checkImport(); }
   });
   window.addEventListener('hashchange', () => setView(location.hash.slice(1)));
   window.addEventListener('offline', () => {