@sanqianx/project-knowledge 5.0.23 → 5.0.25

package/_site/lib/runtime-control.js

@@ -1,89 +1,89 @@
-'use strict';
-const net = require('node:net');
-const fs = require('node:fs');
-const path = require('node:path');
-const crypto = require('node:crypto');
-
-const SCHEMA = 'project-knowledge/runtime-control/v1';
-function normalizeDataDir(value) {
-  const absolute = path.resolve(value);
-  return process.platform === 'win32' ? absolute.toLowerCase() : absolute;
-}
-function controlPath(dataDir) {
-  const hash = crypto.createHash('sha256').update(normalizeDataDir(dataDir)).digest('hex').slice(0, 32);
-  return process.platform === 'win32' ? `\\\\.\\pipe\\project-knowledge-${hash}` : path.join(dataDir, 'runtime-control.sock');
-}
-function identity(dataDir, endpoint = {}) {
-  return { schema: SCHEMA, name: 'project-knowledge', pid: process.pid, dataDir: path.resolve(dataDir), ...endpoint };
-}
-function request(dataDir, message, timeoutMs = 45000) {
-  return new Promise((resolve, reject) => {
-    const socket = net.createConnection(controlPath(dataDir));
-    let buffer = '', done = false;
-    const timer = setTimeout(() => socket.destroy(new Error('知识库控制请求超时，停止尚未确认。')), timeoutMs);
-    const finish = (error, result) => {
-      if (done) return; done = true;
-      clearTimeout(timer); socket.destroy();
-      if (error) reject(error); else resolve(result);
-    };
-    socket.once('connect', () => socket.write(JSON.stringify(message) + '\n'));
-    socket.on('data', chunk => {
-      buffer += chunk.toString();
-      if (buffer.length > 65536) return finish(new Error('无效的实例响应。'));
-      if (!buffer.includes('\n')) return;
-      try {
-        const value = JSON.parse(buffer.slice(0, buffer.indexOf('\n')));
-        if (!value.ok) return finish(new Error(value.message || '实例控制失败。'));
-        if (value.instance?.schema !== SCHEMA || normalizeDataDir(value.instance.dataDir) !== normalizeDataDir(dataDir)) return finish(new Error('实例身份不匹配，已拒绝控制。'));
-        finish(null, value);
-      } catch (error) { finish(error); }
-    });
-    socket.once('error', error => finish(error));
-    socket.once('end', () => { if (!buffer.includes('\n')) finish(new Error('实例断开连接，停止尚未确认。')); });
-  });
-}
-
-async function listen(dataDir, info, stop) {
-  const address = controlPath(dataDir);
-  if (process.platform !== 'win32' && fs.existsSync(address)) {
-    try { await request(dataDir, { action: 'status' }, 1000); throw new Error('另一个知识库实例已占用控制通道。'); }
-    catch (error) {
-      if (!['ECONNREFUSED', 'ENOENT'].includes(error.code)) throw error;
-      fs.unlinkSync(address);
-    }
-  }
-  const sockets = new Set();
-  let stopping = false, stoppingSocket;
-  const server = net.createServer(socket => {
-    sockets.add(socket); socket.once('close', () => sockets.delete(socket));
-    socket.on('error', () => {});
-    socket.setTimeout(45000, () => socket.destroy());
-    let buffer = '';
-    socket.on('data', chunk => {
-      buffer += chunk.toString();
-      if (buffer.length > 16384) return socket.destroy();
-      if (!buffer.includes('\n')) return;
-      socket.removeAllListeners('data');
-      const respond = value => { if (!socket.destroyed) socket.end(JSON.stringify({ ...value, instance: info }) + '\n'); };
-      let message;
-      try { message = JSON.parse(buffer.slice(0, buffer.indexOf('\n'))); }
-      catch { return respond({ ok: false, message: '无效的控制请求。' }); }
-      if (message.action === 'status') return respond({ ok: true, status: stopping ? 'stopping' : 'running' });
-      // A stale endpoint/port must never become a signal to an unrelated PID.
-      if (message.action !== 'stop' || message.pid !== info.pid || message.port !== info.port || message.startedAt !== info.startedAt) return respond({ ok: false, message: '实例身份已变化，已拒绝停止。' });
-      if (stopping) return respond({ ok: false, message: '实例正在停止，请稍后查询状态。' });
-      stopping = true; stoppingSocket = socket;
-      Promise.resolve().then(stop).then(() => respond({ ok: true, status: 'stopped' })).catch(error => respond({ ok: false, message: error.message }));
-    });
-  });
-  await new Promise((resolve, reject) => { server.once('error', reject); server.listen(address, resolve); });
-  if (process.platform !== 'win32') fs.chmodSync(address, 0o600);
-  return {
-    close() {
-      // Keep only the requesting socket for the final shutdown acknowledgement.
-      return new Promise(resolve => { server.close(resolve); for (const socket of sockets) if (socket !== stoppingSocket) socket.destroy(); if (stopping) resolve(); });
-    },
-  };
-}
-
-module.exports = { SCHEMA, normalizeDataDir, identity, controlPath, request, listen };
+'use strict';
+const net = require('node:net');
+const fs = require('node:fs');
+const path = require('node:path');
+const crypto = require('node:crypto');
+
+const SCHEMA = 'project-knowledge/runtime-control/v1';
+function normalizeDataDir(value) {
+  const absolute = path.resolve(value);
+  return process.platform === 'win32' ? absolute.toLowerCase() : absolute;
+}
+function controlPath(dataDir) {
+  const hash = crypto.createHash('sha256').update(normalizeDataDir(dataDir)).digest('hex').slice(0, 32);
+  return process.platform === 'win32' ? `\\\\.\\pipe\\project-knowledge-${hash}` : path.join(dataDir, 'runtime-control.sock');
+}
+function identity(dataDir, endpoint = {}) {
+  return { schema: SCHEMA, name: 'project-knowledge', pid: process.pid, dataDir: path.resolve(dataDir), ...endpoint };
+}
+function request(dataDir, message, timeoutMs = 45000) {
+  return new Promise((resolve, reject) => {
+    const socket = net.createConnection(controlPath(dataDir));
+    let buffer = '', done = false;
+    const timer = setTimeout(() => socket.destroy(new Error('知识库控制请求超时，停止尚未确认。')), timeoutMs);
+    const finish = (error, result) => {
+      if (done) return; done = true;
+      clearTimeout(timer); socket.destroy();
+      if (error) reject(error); else resolve(result);
+    };
+    socket.once('connect', () => socket.write(JSON.stringify(message) + '\n'));
+    socket.on('data', chunk => {
+      buffer += chunk.toString();
+      if (buffer.length > 65536) return finish(new Error('无效的实例响应。'));
+      if (!buffer.includes('\n')) return;
+      try {
+        const value = JSON.parse(buffer.slice(0, buffer.indexOf('\n')));
+        if (!value.ok) return finish(new Error(value.message || '实例控制失败。'));
+        if (value.instance?.schema !== SCHEMA || normalizeDataDir(value.instance.dataDir) !== normalizeDataDir(dataDir)) return finish(new Error('实例身份不匹配，已拒绝控制。'));
+        finish(null, value);
+      } catch (error) { finish(error); }
+    });
+    socket.once('error', error => finish(error));
+    socket.once('end', () => { if (!buffer.includes('\n')) finish(new Error('实例断开连接，停止尚未确认。')); });
+  });
+}
+
+async function listen(dataDir, info, stop) {
+  const address = controlPath(dataDir);
+  if (process.platform !== 'win32' && fs.existsSync(address)) {
+    try { await request(dataDir, { action: 'status' }, 1000); throw new Error('另一个知识库实例已占用控制通道。'); }
+    catch (error) {
+      if (!['ECONNREFUSED', 'ENOENT'].includes(error.code)) throw error;
+      fs.unlinkSync(address);
+    }
+  }
+  const sockets = new Set();
+  let stopping = false, stoppingSocket;
+  const server = net.createServer(socket => {
+    sockets.add(socket); socket.once('close', () => sockets.delete(socket));
+    socket.on('error', () => {});
+    socket.setTimeout(45000, () => socket.destroy());
+    let buffer = '';
+    socket.on('data', chunk => {
+      buffer += chunk.toString();
+      if (buffer.length > 16384) return socket.destroy();
+      if (!buffer.includes('\n')) return;
+      socket.removeAllListeners('data');
+      const respond = value => { if (!socket.destroyed) socket.end(JSON.stringify({ ...value, instance: info }) + '\n'); };
+      let message;
+      try { message = JSON.parse(buffer.slice(0, buffer.indexOf('\n'))); }
+      catch { return respond({ ok: false, message: '无效的控制请求。' }); }
+      if (message.action === 'status') return respond({ ok: true, status: stopping ? 'stopping' : 'running' });
+      // A stale endpoint/port must never become a signal to an unrelated PID.
+      if (message.action !== 'stop' || message.pid !== info.pid || message.port !== info.port || message.startedAt !== info.startedAt) return respond({ ok: false, message: '实例身份已变化，已拒绝停止。' });
+      if (stopping) return respond({ ok: false, message: '实例正在停止，请稍后查询状态。' });
+      stopping = true; stoppingSocket = socket;
+      Promise.resolve().then(stop).then(() => respond({ ok: true, status: 'stopped' })).catch(error => respond({ ok: false, message: error.message }));
+    });
+  });
+  await new Promise((resolve, reject) => { server.once('error', reject); server.listen(address, resolve); });
+  if (process.platform !== 'win32') fs.chmodSync(address, 0o600);
+  return {
+    close() {
+      // Keep only the requesting socket for the final shutdown acknowledgement.
+      return new Promise(resolve => { server.close(resolve); for (const socket of sockets) if (socket !== stoppingSocket) socket.destroy(); if (stopping) resolve(); });
+    },
+  };
+}
+
+module.exports = { SCHEMA, normalizeDataDir, identity, controlPath, request, listen };

package/_site/lib/runtime-endpoint.js

@@ -1,160 +1,160 @@
-// Stable discovery record for the one local project-knowledge backend.
-//
-// Git hooks and the desktop shell must not bake in a port: the CLI can fall
-// back from 5757 when that port is occupied.  This small file lives in the
-// version-independent data directory and is replaced atomically whenever a
-// backend starts.
-
-const fs = require('fs');
-const path = require('path');
-
-const SCHEMA = 'project-knowledge/runtime-endpoint/v1';
-const FILENAME = 'runtime-endpoint.json';
-
-function endpointPath(dataDir) {
-  return path.join(path.resolve(dataDir), FILENAME);
-}
-
-function isLoopbackHost(host) {
-  const value = String(host || '').trim().toLowerCase();
-  return value === '127.0.0.1' || value === 'localhost' || value === '::1';
-}
-
-function normalizeEndpoint(value) {
-  if (!value || typeof value !== 'object') return null;
-  const pid = Number(value.pid);
-  const port = Number(value.port);
-  const host = String(value.host || '127.0.0.1').trim();
-  if (!Number.isInteger(pid) || pid <= 0) return null;
-  if (!Number.isInteger(port) || port < 1 || port > 65535) return null;
-  // Runtime discovery is intentionally local-only. Never let a modified
-  // endpoint file make hooks send repository metadata to a remote host.
-  if (!isLoopbackHost(host)) return null;
-  return {
-    schema: SCHEMA,
-    pid,
-    host,
-    port,
-    mode: String(value.mode || 'cli'),
-    startedAt: String(value.startedAt || ''),
-  };
-}
-
-function readEndpoint(dataDir) {
-  try {
-    const parsed = JSON.parse(fs.readFileSync(endpointPath(dataDir), 'utf-8'));
-    if (parsed.schema !== SCHEMA) return null;
-    return normalizeEndpoint(parsed);
-  } catch {
-    return null;
-  }
-}
-
-function isProcessAlive(pid) {
-  try {
-    process.kill(Number(pid), 0);
-    return true;
-  } catch (error) {
-    // EPERM means the process exists but we lack permission to signal it
-    // (common on Windows when the daemon and this process run at different
-    // privilege levels). Treat that as alive — only ESRCH/ENOENT mean dead.
-    // Misjudging a live process as dead would delete a running backend's
-    // endpoint file (see readLiveEndpoint) and spawn a duplicate.
-    if (error && error.code === 'EPERM') return true;
-    return false;
-  }
-}
-
-function readLiveEndpoint(dataDir, { removeStale = true } = {}) {
-  const endpoint = readEndpoint(dataDir);
-  if (!endpoint) return null;
-  if (isProcessAlive(endpoint.pid)) return endpoint;
-  if (removeStale) clearEndpoint(dataDir, { pid: endpoint.pid });
-  return null;
-}
-
-function writeEndpoint(dataDir, value) {
-  const endpoint = normalizeEndpoint({
-    ...value,
-    startedAt: value && value.startedAt || new Date().toISOString(),
-  });
-  if (!endpoint) throw new Error('invalid runtime endpoint');
-  const target = endpointPath(dataDir);
-  const temp = `${target}.${process.pid}.tmp`;
-  fs.mkdirSync(path.dirname(target), { recursive: true });
-  fs.writeFileSync(temp, JSON.stringify(endpoint, null, 2) + '\n', 'utf-8');
-  try {
-    fs.renameSync(temp, target);
-  } catch (error) {
-    // Windows cannot always replace an existing file with renameSync.
-    try { fs.unlinkSync(target); } catch {
-      // The following rename is authoritative and reports endpoint replacement failure.
-    }
-    fs.renameSync(temp, target);
-  }
-  return endpoint;
-}
-
-function claimEndpoint(dataDir, value) {
-  const endpoint = normalizeEndpoint({
-    ...value,
-    startedAt: value && value.startedAt || new Date().toISOString(),
-  });
-  if (!endpoint) throw new Error('invalid runtime endpoint');
-  const target = endpointPath(dataDir);
-  fs.mkdirSync(path.dirname(target), { recursive: true });
-
-  for (let attempt = 0; attempt < 2; attempt++) {
-    try {
-      fs.writeFileSync(target, JSON.stringify(endpoint, null, 2) + '\n', {
-        encoding: 'utf-8',
-        flag: 'wx',
-      });
-      return { claimed: true, endpoint };
-    } catch (error) {
-      if (!error || error.code !== 'EEXIST') throw error;
-      const existing = readEndpoint(dataDir);
-      if (existing && isProcessAlive(existing.pid)) {
-        return { claimed: false, endpoint: existing };
-      }
-      // A just-created file can briefly be unreadable while another process
-      // writes it. Treat it as busy rather than deleting a concurrent claim.
-      try {
-        const ageMs = Date.now() - fs.statSync(target).mtimeMs;
-        if (!existing && ageMs < 2000) return { claimed: false, endpoint: null };
-      } catch {
-        // clearEndpoint performs the ownership-safe final check when stat is unavailable.
-      }
-      clearEndpoint(dataDir, existing ? { pid: existing.pid } : {});
-    }
-  }
-  return { claimed: false, endpoint: readLiveEndpoint(dataDir) };
-}
-
-function clearEndpoint(dataDir, { pid } = {}) {
-  const target = endpointPath(dataDir);
-  if (pid != null) {
-    const current = readEndpoint(dataDir);
-    if (current && current.pid !== Number(pid)) return false;
-  }
-  try {
-    fs.unlinkSync(target);
-    return true;
-  } catch (error) {
-    return error.code === 'ENOENT';
-  }
-}
-
-module.exports = {
-  SCHEMA,
-  FILENAME,
-  endpointPath,
-  isLoopbackHost,
-  normalizeEndpoint,
-  readEndpoint,
-  readLiveEndpoint,
-  writeEndpoint,
-  claimEndpoint,
-  clearEndpoint,
-  isProcessAlive,
-};
+// Stable discovery record for the one local project-knowledge backend.
+//
+// Git hooks and the desktop shell must not bake in a port: the CLI can fall
+// back from 5757 when that port is occupied.  This small file lives in the
+// version-independent data directory and is replaced atomically whenever a
+// backend starts.
+
+const fs = require('fs');
+const path = require('path');
+
+const SCHEMA = 'project-knowledge/runtime-endpoint/v1';
+const FILENAME = 'runtime-endpoint.json';
+
+function endpointPath(dataDir) {
+  return path.join(path.resolve(dataDir), FILENAME);
+}
+
+function isLoopbackHost(host) {
+  const value = String(host || '').trim().toLowerCase();
+  return value === '127.0.0.1' || value === 'localhost' || value === '::1';
+}
+
+function normalizeEndpoint(value) {
+  if (!value || typeof value !== 'object') return null;
+  const pid = Number(value.pid);
+  const port = Number(value.port);
+  const host = String(value.host || '127.0.0.1').trim();
+  if (!Number.isInteger(pid) || pid <= 0) return null;
+  if (!Number.isInteger(port) || port < 1 || port > 65535) return null;
+  // Runtime discovery is intentionally local-only. Never let a modified
+  // endpoint file make hooks send repository metadata to a remote host.
+  if (!isLoopbackHost(host)) return null;
+  return {
+    schema: SCHEMA,
+    pid,
+    host,
+    port,
+    mode: String(value.mode || 'cli'),
+    startedAt: String(value.startedAt || ''),
+  };
+}
+
+function readEndpoint(dataDir) {
+  try {
+    const parsed = JSON.parse(fs.readFileSync(endpointPath(dataDir), 'utf-8'));
+    if (parsed.schema !== SCHEMA) return null;
+    return normalizeEndpoint(parsed);
+  } catch {
+    return null;
+  }
+}
+
+function isProcessAlive(pid) {
+  try {
+    process.kill(Number(pid), 0);
+    return true;
+  } catch (error) {
+    // EPERM means the process exists but we lack permission to signal it
+    // (common on Windows when the daemon and this process run at different
+    // privilege levels). Treat that as alive — only ESRCH/ENOENT mean dead.
+    // Misjudging a live process as dead would delete a running backend's
+    // endpoint file (see readLiveEndpoint) and spawn a duplicate.
+    if (error && error.code === 'EPERM') return true;
+    return false;
+  }
+}
+
+function readLiveEndpoint(dataDir, { removeStale = true } = {}) {
+  const endpoint = readEndpoint(dataDir);
+  if (!endpoint) return null;
+  if (isProcessAlive(endpoint.pid)) return endpoint;
+  if (removeStale) clearEndpoint(dataDir, { pid: endpoint.pid });
+  return null;
+}
+
+function writeEndpoint(dataDir, value) {
+  const endpoint = normalizeEndpoint({
+    ...value,
+    startedAt: value && value.startedAt || new Date().toISOString(),
+  });
+  if (!endpoint) throw new Error('invalid runtime endpoint');
+  const target = endpointPath(dataDir);
+  const temp = `${target}.${process.pid}.tmp`;
+  fs.mkdirSync(path.dirname(target), { recursive: true });
+  fs.writeFileSync(temp, JSON.stringify(endpoint, null, 2) + '\n', 'utf-8');
+  try {
+    fs.renameSync(temp, target);
+  } catch (error) {
+    // Windows cannot always replace an existing file with renameSync.
+    try { fs.unlinkSync(target); } catch {
+      // The following rename is authoritative and reports endpoint replacement failure.
+    }
+    fs.renameSync(temp, target);
+  }
+  return endpoint;
+}
+
+function claimEndpoint(dataDir, value) {
+  const endpoint = normalizeEndpoint({
+    ...value,
+    startedAt: value && value.startedAt || new Date().toISOString(),
+  });
+  if (!endpoint) throw new Error('invalid runtime endpoint');
+  const target = endpointPath(dataDir);
+  fs.mkdirSync(path.dirname(target), { recursive: true });
+
+  for (let attempt = 0; attempt < 2; attempt++) {
+    try {
+      fs.writeFileSync(target, JSON.stringify(endpoint, null, 2) + '\n', {
+        encoding: 'utf-8',
+        flag: 'wx',
+      });
+      return { claimed: true, endpoint };
+    } catch (error) {
+      if (!error || error.code !== 'EEXIST') throw error;
+      const existing = readEndpoint(dataDir);
+      if (existing && isProcessAlive(existing.pid)) {
+        return { claimed: false, endpoint: existing };
+      }
+      // A just-created file can briefly be unreadable while another process
+      // writes it. Treat it as busy rather than deleting a concurrent claim.
+      try {
+        const ageMs = Date.now() - fs.statSync(target).mtimeMs;
+        if (!existing && ageMs < 2000) return { claimed: false, endpoint: null };
+      } catch {
+        // clearEndpoint performs the ownership-safe final check when stat is unavailable.
+      }
+      clearEndpoint(dataDir, existing ? { pid: existing.pid } : {});
+    }
+  }
+  return { claimed: false, endpoint: readLiveEndpoint(dataDir) };
+}
+
+function clearEndpoint(dataDir, { pid } = {}) {
+  const target = endpointPath(dataDir);
+  if (pid != null) {
+    const current = readEndpoint(dataDir);
+    if (current && current.pid !== Number(pid)) return false;
+  }
+  try {
+    fs.unlinkSync(target);
+    return true;
+  } catch (error) {
+    return error.code === 'ENOENT';
+  }
+}
+
+module.exports = {
+  SCHEMA,
+  FILENAME,
+  endpointPath,
+  isLoopbackHost,
+  normalizeEndpoint,
+  readEndpoint,
+  readLiveEndpoint,
+  writeEndpoint,
+  claimEndpoint,
+  clearEndpoint,
+  isProcessAlive,
+};