@sanqianx/project-knowledge 5.0.24 → 5.0.25

package/_site/lib/integration-intent.js

@@ -1,88 +1,88 @@
-'use strict';
-// User intent for external agent integrations.
-//
-// The install state alone cannot distinguish "broken, should heal" from
-// "deliberately removed, must stay away": both look like hooks-absent. This
-// store records the user's switch position per client so the startup repair
-// event only ever touches clients the user actually connected.
-
-const fs = require('fs');
-const path = require('path');
-
-const SCHEMA = 'project-knowledge/integration-intent/v1';
-const FILENAME = 'integration-intent.json';
-const STATES = new Set(['connected', 'disconnected']);
-
-function intentPath(dataDir) {
-  return path.join(path.resolve(dataDir), FILENAME);
-}
-
-function normalize(value) {
-  if (!value || typeof value !== 'object' || value.schema !== SCHEMA) return null;
-  const clients = {};
-  for (const [client, state] of Object.entries(value.clients || {})) {
-    if (STATES.has(state)) clients[client] = state;
-  }
-  return { schema: SCHEMA, clients };
-}
-
-function readIntent(dataDir) {
-  try {
-    return normalize(JSON.parse(fs.readFileSync(intentPath(dataDir), 'utf-8')));
-  } catch {
-    return null;
-  }
-}
-
-function writeIntent(dataDir, clients) {
-  const target = intentPath(dataDir);
-  const temp = `${target}.${process.pid}.tmp`;
-  fs.mkdirSync(path.dirname(target), { recursive: true });
-  fs.writeFileSync(temp, JSON.stringify({ schema: SCHEMA, clients }, null, 2) + '\n', 'utf-8');
-  try {
-    fs.renameSync(temp, target);
-  } catch {
-    // Windows cannot always rename over an existing file.
-    try { fs.unlinkSync(target); } catch {}
-    fs.renameSync(temp, target);
-  }
-  return { schema: SCHEMA, clients };
-}
-
-function markIntent(dataDir, client, state) {
-  if (!STATES.has(state)) throw new Error(`invalid integration intent state: ${state}`);
-  const current = readIntent(dataDir);
-  const clients = { ...(current?.clients || {}), [client]: state };
-  return writeIntent(dataDir, clients);
-}
-
-// Migration: fill entries only for clients the file has never seen AND whose
-// status scan has settled — a mid-flight scan reports installed as undefined,
-// which must never be recorded as a removal decision. A client whose hooks
-// are installed counts as connected (standalone install or pre-upgrade
-// state); settled-but-absent hooks count as disconnected — the store is never
-// allowed to rewrite a decision the user already made.
-function bootstrapIntent(dataDir, clientsStatus) {
-  const current = readIntent(dataDir);
-  const clients = { ...(current?.clients || {}) };
-  let changed = false;
-  for (const entry of clientsStatus || []) {
-    if (!entry || !entry.client || entry.client in clients) continue;
-    if (entry.developmentCapture?.state === 'checking' || entry.developmentCapture?.installed === undefined) continue;
-    clients[entry.client] = entry.developmentCapture?.installed === true ? 'connected' : 'disconnected';
-    changed = true;
-  }
-  if (!changed && current) return current;
-  return writeIntent(dataDir, clients);
-}
-
-// Aggregate badge state for the single-switch UI.
-function summarizeClient(entry, repair) {
-  if (entry.developmentCapture?.state === 'checking' || entry.knowledgeIntegration?.state === 'checking') return 'checking';
-  if (!(entry.available || entry.configFound)) return 'not-detected';
-  if (entry.developmentCapture?.installed === true) return 'connected';
-  if (repair?.[entry.client]?.state === 'failed') return 'error';
-  return 'disconnected';
-}
-
-module.exports = { SCHEMA, FILENAME, intentPath, readIntent, markIntent, bootstrapIntent, summarizeClient };
+'use strict';
+// User intent for external agent integrations.
+//
+// The install state alone cannot distinguish "broken, should heal" from
+// "deliberately removed, must stay away": both look like hooks-absent. This
+// store records the user's switch position per client so the startup repair
+// event only ever touches clients the user actually connected.
+
+const fs = require('fs');
+const path = require('path');
+
+const SCHEMA = 'project-knowledge/integration-intent/v1';
+const FILENAME = 'integration-intent.json';
+const STATES = new Set(['connected', 'disconnected']);
+
+function intentPath(dataDir) {
+  return path.join(path.resolve(dataDir), FILENAME);
+}
+
+function normalize(value) {
+  if (!value || typeof value !== 'object' || value.schema !== SCHEMA) return null;
+  const clients = {};
+  for (const [client, state] of Object.entries(value.clients || {})) {
+    if (STATES.has(state)) clients[client] = state;
+  }
+  return { schema: SCHEMA, clients };
+}
+
+function readIntent(dataDir) {
+  try {
+    return normalize(JSON.parse(fs.readFileSync(intentPath(dataDir), 'utf-8')));
+  } catch {
+    return null;
+  }
+}
+
+function writeIntent(dataDir, clients) {
+  const target = intentPath(dataDir);
+  const temp = `${target}.${process.pid}.tmp`;
+  fs.mkdirSync(path.dirname(target), { recursive: true });
+  fs.writeFileSync(temp, JSON.stringify({ schema: SCHEMA, clients }, null, 2) + '\n', 'utf-8');
+  try {
+    fs.renameSync(temp, target);
+  } catch {
+    // Windows cannot always rename over an existing file.
+    try { fs.unlinkSync(target); } catch {}
+    fs.renameSync(temp, target);
+  }
+  return { schema: SCHEMA, clients };
+}
+
+function markIntent(dataDir, client, state) {
+  if (!STATES.has(state)) throw new Error(`invalid integration intent state: ${state}`);
+  const current = readIntent(dataDir);
+  const clients = { ...(current?.clients || {}), [client]: state };
+  return writeIntent(dataDir, clients);
+}
+
+// Migration: fill entries only for clients the file has never seen AND whose
+// status scan has settled — a mid-flight scan reports installed as undefined,
+// which must never be recorded as a removal decision. A client whose hooks
+// are installed counts as connected (standalone install or pre-upgrade
+// state); settled-but-absent hooks count as disconnected — the store is never
+// allowed to rewrite a decision the user already made.
+function bootstrapIntent(dataDir, clientsStatus) {
+  const current = readIntent(dataDir);
+  const clients = { ...(current?.clients || {}) };
+  let changed = false;
+  for (const entry of clientsStatus || []) {
+    if (!entry || !entry.client || entry.client in clients) continue;
+    if (entry.developmentCapture?.state === 'checking' || entry.developmentCapture?.installed === undefined) continue;
+    clients[entry.client] = entry.developmentCapture?.installed === true ? 'connected' : 'disconnected';
+    changed = true;
+  }
+  if (!changed && current) return current;
+  return writeIntent(dataDir, clients);
+}
+
+// Aggregate badge state for the single-switch UI.
+function summarizeClient(entry, repair) {
+  if (entry.developmentCapture?.state === 'checking' || entry.knowledgeIntegration?.state === 'checking') return 'checking';
+  if (!(entry.available || entry.configFound)) return 'not-detected';
+  if (entry.developmentCapture?.installed === true) return 'connected';
+  if (repair?.[entry.client]?.state === 'failed') return 'error';
+  return 'disconnected';
+}
+
+module.exports = { SCHEMA, FILENAME, intentPath, readIntent, markIntent, bootstrapIntent, summarizeClient };

package/_site/lib/integration-status-scan.js

@@ -1,99 +1,99 @@
-'use strict';
-const path = require('node:path');
-const { fork, spawn } = require('node:child_process');
-const { IntegrationManager, SUPPORTED_CLIENTS, CLIENT_LABELS } = require('./integration-installer');
-
-class IntegrationStatusScan {
-  constructor({ workerFile, timeoutMs = 20000 } = {}) {
-    this.workerFile = workerFile || path.join(__dirname, 'integration-status-worker.js');
-    this.timeoutMs = timeoutMs; this.entries = new Map(); this.children = new Set(); this.generation = 0;
-    this.queue = []; this.running = 0; this.closed = false;
-  }
-  async read(managerOptions, statusOptions = {}, { force = false, waitMs = 500 } = {}) {
-    if (managerOptions.runner || managerOptions.commandResolver || managerOptions.bridgeModule || managerOptions.codexHookProbe) return new IntegrationManager(managerOptions).statusAll(statusOptions);
-    const key = JSON.stringify([managerOptions.rootDir, managerOptions.homeDir, managerOptions.bridgeHomeDir, statusOptions.cwd, statusOptions.captureOnly, statusOptions.clients]);
-    let entry = this.entries.get(key);
-    if (!entry || !entry.promise && (force || Date.now() - entry.at > 30000)) {
-      entry = { at: Date.now(), generation: ++this.generation, summary: entry?.summary || null, promise: null };
-      entry.promise = this.run(managerOptions, statusOptions).then(summary => { entry.summary = summary; entry.at = Date.now(); return summary; }, error => {
-        if (entry.summary) {
-          entry.summary = { ...entry.summary, stale: true, error: { code: error.code || 'INTEGRATION_STATUS_FAILED' } };
-          return entry.summary;
-        }
-        entry.summary = { bridge: { ok: false, state: 'check-failed', detail: '接入状态检查失败或超时，未将其判为未安装。' },
-          clients: (statusOptions.clients || SUPPORTED_CLIENTS).map(client => ({ client, label: CLIENT_LABELS[client],
-            knowledgeIntegration: { ok: false, state: 'check-failed', detail: '检查未完成，请重试。' }, automaticContext: { supported: client !== 'opencode', configured: false, state: 'check-failed', detail: '检查未完成，不代表客户端未接入。' },
-            developmentCapture: { ok: false, state: 'check-failed', detail: '采集状态尚未核实。' } })), error: { code: error.code || 'INTEGRATION_STATUS_FAILED' } };
-        return entry.summary;
-      }).finally(() => { entry.promise = null; });
-      this.entries.set(key, entry);
-      if (this.entries.size > 100) for (const [oldKey, old] of this.entries) { if (!old.promise && oldKey !== key) { this.entries.delete(oldKey); break; } }
-    }
-    if (entry.promise && waitMs > 0) {
-      let timer;
-      await Promise.race([entry.promise, new Promise(resolve => { timer = setTimeout(resolve, waitMs); })]); clearTimeout(timer);
-    }
-    const pending = entry.promise !== null;
-    if (entry.summary) return { ...entry.summary, scan: { state: pending ? 'refreshing' : 'ready', generation: entry.generation, updatedAt: entry.at } };
-    return { bridge: { ok: true, state: 'checking' }, clients: (statusOptions.clients || SUPPORTED_CLIENTS).map(client => ({ client, label: CLIENT_LABELS[client],
-      configFound: new IntegrationManager(managerOptions).captureConfigFound(client),
-      knowledgeIntegration: { ok: true, state: 'checking', detail: '正在检查接入状态…' },
-      automaticContext: { supported: client !== 'opencode', configured: false, state: 'checking', detail: '正在检查开发前知识读取…' },
-      developmentCapture: { ok: true, state: 'checking', detail: '正在检查采集…' } })), scan: { state: 'checking', generation: entry.generation } };
-  }
-  run(managerOptions, statusOptions) {
-    return new Promise((resolve, reject) => {
-      if (this.closed || this.queue.length >= 64) { reject(Object.assign(new Error('状态检查暂不可用。'), { code: this.closed ? 'INTEGRATION_STATUS_CLOSED' : 'INTEGRATION_STATUS_BUSY' })); return; }
-      this.queue.push({ managerOptions, statusOptions, resolve, reject }); this.drain();
-    });
-  }
-  drain() {
-    while (!this.closed && this.running < 2 && this.queue.length) {
-      const next = this.queue.shift(); this.running++;
-      this.probe(next.managerOptions, next.statusOptions).then(next.resolve, next.reject).finally(() => { this.running--; this.drain(); });
-    }
-  }
-  probe(managerOptions, statusOptions) {
-    return new Promise((resolve, reject) => {
-      const child = fork(this.workerFile, [], { stdio: ['ignore', 'ignore', 'ignore', 'ipc'], windowsHide: true, env: { ...process.env, KB_INTEGRATION_STATUS_WORKER: '1' } });
-      this.children.add(child);
-      let settled = false;
-      const finish = (error, summary) => { if (settled) return; settled = true; clearTimeout(timer); error ? reject(error) : resolve(summary); };
-      const timer = setTimeout(() => {
-        Promise.resolve(managerOptions.logger?.warn?.('integration.status.timeout', '客户端接入状态检查超时；未将其判为未安装。', {
-          operationId: managerOptions.operationId, component: 'integration', phase: 'status',
-          context: { clients: statusOptions.clients || SUPPORTED_CLIENTS, timeoutMs: this.timeoutMs },
-        })).catch(() => {});
-        this.terminate(child); finish(Object.assign(new Error('状态检查超时。'), { code: 'INTEGRATION_STATUS_TIMEOUT' }));
-      }, this.timeoutMs);
-      child.on('message', message => {
-        if (message?.kind === 'log') {
-          if (['info', 'warn', 'error'].includes(message.level) && Array.isArray(message.args) && /^integration\./.test(message.args[0] || '')) Promise.resolve(managerOptions.logger?.[message.level]?.(...message.args)).catch(() => {});
-          return;
-        }
-        finish(message?.ok ? null : Object.assign(new Error('状态检查失败。'), { code: message?.code }), message?.summary);
-      });
-      child.once('error', error => finish(error));
-      child.once('exit', () => { this.children.delete(child); if (!settled) finish(Object.assign(new Error('状态检查进程提前退出。'), { code: 'INTEGRATION_STATUS_EXITED' })); });
-      const allowed = ['rootDir', 'homeDir', 'version', 'packageSpec', 'operationId', 'bridgeHomeDir', 'bridgeConsumerName', 'claudeSettingsFile', 'codexConfigFile', 'zcodeConfigFile', 'openCodePluginsDir'];
-      child.send({ managerOptions: Object.fromEntries(allowed.filter(k => managerOptions[k] !== undefined).map(k => [k, managerOptions[k]])), statusOptions });
-    });
-  }
-  terminate(child) {
-    if (child.exitCode !== null || child.signalCode !== null) return;
-    if (process.platform === 'win32') {
-      // Only the live worker we created, including its probe children. Never
-      // terminate by executable name or scan unrelated Node processes.
-      const killer = spawn('taskkill.exe', ['/PID', String(child.pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' });
-      killer.on('error', () => child.kill());
-    } else child.kill('SIGTERM');
-  }
-  invalidate() { for (const entry of this.entries.values()) entry.at = 0; }
-  close() {
-    this.closed = true;
-    for (const child of this.children) this.terminate(child);
-    for (const item of this.queue) item.reject(Object.assign(new Error('扫描已关闭。'), { code: 'INTEGRATION_STATUS_CLOSED' }));
-    this.queue = []; this.entries.clear();
-  }
-}
-module.exports = { IntegrationStatusScan };
+'use strict';
+const path = require('node:path');
+const { fork, spawn } = require('node:child_process');
+const { IntegrationManager, SUPPORTED_CLIENTS, CLIENT_LABELS } = require('./integration-installer');
+
+class IntegrationStatusScan {
+  constructor({ workerFile, timeoutMs = 20000 } = {}) {
+    this.workerFile = workerFile || path.join(__dirname, 'integration-status-worker.js');
+    this.timeoutMs = timeoutMs; this.entries = new Map(); this.children = new Set(); this.generation = 0;
+    this.queue = []; this.running = 0; this.closed = false;
+  }
+  async read(managerOptions, statusOptions = {}, { force = false, waitMs = 500 } = {}) {
+    if (managerOptions.runner || managerOptions.commandResolver || managerOptions.bridgeModule || managerOptions.codexHookProbe) return new IntegrationManager(managerOptions).statusAll(statusOptions);
+    const key = JSON.stringify([managerOptions.rootDir, managerOptions.homeDir, managerOptions.bridgeHomeDir, statusOptions.cwd, statusOptions.captureOnly, statusOptions.clients]);
+    let entry = this.entries.get(key);
+    if (!entry || !entry.promise && (force || Date.now() - entry.at > 30000)) {
+      entry = { at: Date.now(), generation: ++this.generation, summary: entry?.summary || null, promise: null };
+      entry.promise = this.run(managerOptions, statusOptions).then(summary => { entry.summary = summary; entry.at = Date.now(); return summary; }, error => {
+        if (entry.summary) {
+          entry.summary = { ...entry.summary, stale: true, error: { code: error.code || 'INTEGRATION_STATUS_FAILED' } };
+          return entry.summary;
+        }
+        entry.summary = { bridge: { ok: false, state: 'check-failed', detail: '接入状态检查失败或超时，未将其判为未安装。' },
+          clients: (statusOptions.clients || SUPPORTED_CLIENTS).map(client => ({ client, label: CLIENT_LABELS[client],
+            knowledgeIntegration: { ok: false, state: 'check-failed', detail: '检查未完成，请重试。' }, automaticContext: { supported: client !== 'opencode', configured: false, state: 'check-failed', detail: '检查未完成，不代表客户端未接入。' },
+            developmentCapture: { ok: false, state: 'check-failed', detail: '采集状态尚未核实。' } })), error: { code: error.code || 'INTEGRATION_STATUS_FAILED' } };
+        return entry.summary;
+      }).finally(() => { entry.promise = null; });
+      this.entries.set(key, entry);
+      if (this.entries.size > 100) for (const [oldKey, old] of this.entries) { if (!old.promise && oldKey !== key) { this.entries.delete(oldKey); break; } }
+    }
+    if (entry.promise && waitMs > 0) {
+      let timer;
+      await Promise.race([entry.promise, new Promise(resolve => { timer = setTimeout(resolve, waitMs); })]); clearTimeout(timer);
+    }
+    const pending = entry.promise !== null;
+    if (entry.summary) return { ...entry.summary, scan: { state: pending ? 'refreshing' : 'ready', generation: entry.generation, updatedAt: entry.at } };
+    return { bridge: { ok: true, state: 'checking' }, clients: (statusOptions.clients || SUPPORTED_CLIENTS).map(client => ({ client, label: CLIENT_LABELS[client],
+      configFound: new IntegrationManager(managerOptions).captureConfigFound(client),
+      knowledgeIntegration: { ok: true, state: 'checking', detail: '正在检查接入状态…' },
+      automaticContext: { supported: client !== 'opencode', configured: false, state: 'checking', detail: '正在检查开发前知识读取…' },
+      developmentCapture: { ok: true, state: 'checking', detail: '正在检查采集…' } })), scan: { state: 'checking', generation: entry.generation } };
+  }
+  run(managerOptions, statusOptions) {
+    return new Promise((resolve, reject) => {
+      if (this.closed || this.queue.length >= 64) { reject(Object.assign(new Error('状态检查暂不可用。'), { code: this.closed ? 'INTEGRATION_STATUS_CLOSED' : 'INTEGRATION_STATUS_BUSY' })); return; }
+      this.queue.push({ managerOptions, statusOptions, resolve, reject }); this.drain();
+    });
+  }
+  drain() {
+    while (!this.closed && this.running < 2 && this.queue.length) {
+      const next = this.queue.shift(); this.running++;
+      this.probe(next.managerOptions, next.statusOptions).then(next.resolve, next.reject).finally(() => { this.running--; this.drain(); });
+    }
+  }
+  probe(managerOptions, statusOptions) {
+    return new Promise((resolve, reject) => {
+      const child = fork(this.workerFile, [], { stdio: ['ignore', 'ignore', 'ignore', 'ipc'], windowsHide: true, env: { ...process.env, KB_INTEGRATION_STATUS_WORKER: '1' } });
+      this.children.add(child);
+      let settled = false;
+      const finish = (error, summary) => { if (settled) return; settled = true; clearTimeout(timer); error ? reject(error) : resolve(summary); };
+      const timer = setTimeout(() => {
+        Promise.resolve(managerOptions.logger?.warn?.('integration.status.timeout', '客户端接入状态检查超时；未将其判为未安装。', {
+          operationId: managerOptions.operationId, component: 'integration', phase: 'status',
+          context: { clients: statusOptions.clients || SUPPORTED_CLIENTS, timeoutMs: this.timeoutMs },
+        })).catch(() => {});
+        this.terminate(child); finish(Object.assign(new Error('状态检查超时。'), { code: 'INTEGRATION_STATUS_TIMEOUT' }));
+      }, this.timeoutMs);
+      child.on('message', message => {
+        if (message?.kind === 'log') {
+          if (['info', 'warn', 'error'].includes(message.level) && Array.isArray(message.args) && /^integration\./.test(message.args[0] || '')) Promise.resolve(managerOptions.logger?.[message.level]?.(...message.args)).catch(() => {});
+          return;
+        }
+        finish(message?.ok ? null : Object.assign(new Error('状态检查失败。'), { code: message?.code }), message?.summary);
+      });
+      child.once('error', error => finish(error));
+      child.once('exit', () => { this.children.delete(child); if (!settled) finish(Object.assign(new Error('状态检查进程提前退出。'), { code: 'INTEGRATION_STATUS_EXITED' })); });
+      const allowed = ['rootDir', 'homeDir', 'version', 'packageSpec', 'operationId', 'bridgeHomeDir', 'bridgeConsumerName', 'claudeSettingsFile', 'codexConfigFile', 'zcodeConfigFile', 'openCodePluginsDir'];
+      child.send({ managerOptions: Object.fromEntries(allowed.filter(k => managerOptions[k] !== undefined).map(k => [k, managerOptions[k]])), statusOptions });
+    });
+  }
+  terminate(child) {
+    if (child.exitCode !== null || child.signalCode !== null) return;
+    if (process.platform === 'win32') {
+      // Only the live worker we created, including its probe children. Never
+      // terminate by executable name or scan unrelated Node processes.
+      const killer = spawn('taskkill.exe', ['/PID', String(child.pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' });
+      killer.on('error', () => child.kill());
+    } else child.kill('SIGTERM');
+  }
+  invalidate() { for (const entry of this.entries.values()) entry.at = 0; }
+  close() {
+    this.closed = true;
+    for (const child of this.children) this.terminate(child);
+    for (const item of this.queue) item.reject(Object.assign(new Error('扫描已关闭。'), { code: 'INTEGRATION_STATUS_CLOSED' }));
+    this.queue = []; this.entries.clear();
+  }
+}
+module.exports = { IntegrationStatusScan };

package/_site/lib/integration-status-worker.js

@@ -1,14 +1,14 @@
-'use strict';
-const { IntegrationManager } = require('./integration-installer');
-process.once('message', async input => {
-  try {
-    const logger = Object.fromEntries(['info', 'warn', 'error'].map(level => [level, (...args) => {
-      if (process.connected) process.send({ kind: 'log', level, args: args.map(value => value instanceof Error ? { name: value.name, code: value.code, message: 'Integration command failed.' } : value) });
-    }]));
-    const manager = new IntegrationManager({ ...input.managerOptions, logger });
-    const summary = await manager.statusAll(input.statusOptions);
-    process.send({ ok: true, summary }, () => process.disconnect());
-  } catch (error) {
-    process.send({ ok: false, code: error.code || 'INTEGRATION_STATUS_FAILED' }, () => process.disconnect());
-  }
-});
+'use strict';
+const { IntegrationManager } = require('./integration-installer');
+process.once('message', async input => {
+  try {
+    const logger = Object.fromEntries(['info', 'warn', 'error'].map(level => [level, (...args) => {
+      if (process.connected) process.send({ kind: 'log', level, args: args.map(value => value instanceof Error ? { name: value.name, code: value.code, message: 'Integration command failed.' } : value) });
+    }]));
+    const manager = new IntegrationManager({ ...input.managerOptions, logger });
+    const summary = await manager.statusAll(input.statusOptions);
+    process.send({ ok: true, summary }, () => process.disconnect());
+  } catch (error) {
+    process.send({ ok: false, code: error.code || 'INTEGRATION_STATUS_FAILED' }, () => process.disconnect());
+  }
+});