@chiway/contextweaver 1.1.0 → 1.5.0

package/dist/index.js

@@ -1,36 +1,228 @@
 #!/usr/bin/env node
 import {
+  withLock
+} from "./chunk-HHYPQA3X.js";
+import {
+  initFilter,
+  isFiltered,
   scan
-} from "./chunk-NQR4CGQ6.js";
-import "./chunk-6QMYML5V.js";
+} from "./chunk-GDVB6PJ4.js";
+import "./chunk-XMZZZKG7.js";
+import "./chunk-LB42CZEB.js";
+import "./chunk-XFIM2T6S.js";
+import "./chunk-3BNHQV5W.js";
+import {
+  getDefaultEnvFileContent
+} from "./chunk-TPM6YP43.js";
+import "./chunk-BFCIZ52F.js";
 import {
   generateProjectId
-} from "./chunk-6Z4JEEVJ.js";
+} from "./chunk-PPLFJGO3.js";
 import {
   logger
-} from "./chunk-AMQQK4P7.js";
-import "./chunk-RJURH22T.js";
+} from "./chunk-JVKVSTQ3.js";
+import "./chunk-SKBAE26T.js";
 
 // src/index.ts
-import { promises as fs } from "fs";
+import { promises as fs2 } from "fs";
 import os from "os";
-import path from "path";
+import path3 from "path";
 import { fileURLToPath } from "url";
 import cac from "cac";
-var __dirname = path.dirname(fileURLToPath(import.meta.url));
-var pkgPath = path.resolve(__dirname, "../package.json");
-var pkg = JSON.parse(await fs.readFile(pkgPath, "utf-8"));
+
+// src/cli/mirrorCommands.ts
+import path from "path";
+function parseOptionalPositiveInt(value) {
+  if (!value) {
+    return void 0;
+  }
+  const parsed = Number.parseInt(value, 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : void 0;
+}
+async function writeResponse(response) {
+  const text = response.content.map((item) => item.text).join("\n");
+  process.stdout.write(`${text}
+`);
+}
+function registerMirrorCommands(cli2) {
+  cli2.command("list-files [path]", "\u5217\u51FA\u5DF2\u7D22\u5F15\u6587\u4EF6\u7ED3\u6784\uFF08\u955C\u50CF MCP list-files\uFF09").option("--glob <pattern>", "\u8DEF\u5F84 glob \u8FC7\u6EE4").option("--language <language>", "\u8BED\u8A00\u8FC7\u6EE4").option("--max-results <n>", "\u6700\u591A\u8FD4\u56DE\u6570\u91CF").action(
+    async (targetPath, options) => {
+      const repoPath = targetPath ? path.resolve(targetPath) : process.cwd();
+      const { handleListFiles } = await import("./listFiles-4VT2TPJD.js");
+      const response = await handleListFiles({
+        repo_path: repoPath,
+        glob: options.glob,
+        language: options.language,
+        max_results: parseOptionalPositiveInt(options.maxResults)
+      });
+      await writeResponse(response);
+    }
+  );
+  cli2.command("definition <symbol>", "\u67E5\u770B\u7B26\u53F7\u5B9A\u4E49\uFF08\u955C\u50CF MCP get-symbol-definition\uFF09").option("-p, --path <path>", "\u9879\u76EE\u8DEF\u5F84\uFF08\u9ED8\u8BA4\u5F53\u524D\u76EE\u5F55\uFF09").option("--hint-path <path>", "\u7528\u4E8E\u540C\u540D\u5B9A\u4E49\u6D88\u6B67\u7684\u504F\u597D\u8DEF\u5F84").option("--max-results <n>", "\u6700\u591A\u8FD4\u56DE\u6570\u91CF").action(
+    async (symbol, options) => {
+      const repoPath = options.path ? path.resolve(options.path) : process.cwd();
+      const { handleGetSymbolDefinition } = await import("./getSymbolDefinition-6KMY4H33.js");
+      const response = await handleGetSymbolDefinition({
+        repo_path: repoPath,
+        symbol,
+        hint_path: options.hintPath,
+        max_results: parseOptionalPositiveInt(options.maxResults)
+      });
+      await writeResponse(response);
+    }
+  );
+  cli2.command("references <symbol>", "\u67E5\u770B\u7B26\u53F7\u5F15\u7528\uFF08\u955C\u50CF MCP find-references\uFF09").option("-p, --path <path>", "\u9879\u76EE\u8DEF\u5F84\uFF08\u9ED8\u8BA4\u5F53\u524D\u76EE\u5F55\uFF09").option("--exclude-definition", "\u6392\u9664\u5B9A\u4E49\u672C\u8EAB").option("--max-results <n>", "\u6700\u591A\u8FD4\u56DE\u6570\u91CF").action(
+    async (symbol, options) => {
+      const repoPath = options.path ? path.resolve(options.path) : process.cwd();
+      const { handleFindReferences } = await import("./findReferences-N7ML7TUP.js");
+      const response = await handleFindReferences({
+        repo_path: repoPath,
+        symbol,
+        exclude_definition: options.excludeDefinition,
+        max_results: parseOptionalPositiveInt(options.maxResults)
+      });
+      await writeResponse(response);
+    }
+  );
+}
+
+// src/scanner/watcher.ts
+import fs from "fs";
+import path2 from "path";
+function defaultWatchFactory(rootPath, options, callback) {
+  const watcher = fs.watch(rootPath, options, (eventType, fileName) => {
+    callback(eventType, fileName);
+  });
+  return {
+    close() {
+      watcher.close();
+    }
+  };
+}
+function normalizeRelativePath(fileName) {
+  if (!fileName) return null;
+  return fileName.replace(/\\/g, "/");
+}
+function createWatchCoordinator(rootPath, options) {
+  const { debounceMs, scanFn, shouldIgnore, watchFactory = defaultWatchFactory } = options;
+  let timer = null;
+  let watcher = null;
+  let started = false;
+  let closed = false;
+  let isScanning = false;
+  let rerunRequested = false;
+  const runScan = async () => {
+    if (closed) return;
+    if (isScanning) {
+      rerunRequested = true;
+      return;
+    }
+    isScanning = true;
+    try {
+      await scanFn();
+    } finally {
+      isScanning = false;
+      if (!closed && rerunRequested) {
+        rerunRequested = false;
+        void runScan();
+      }
+    }
+  };
+  const scheduleScan = () => {
+    if (closed) return;
+    if (timer) {
+      clearTimeout(timer);
+    }
+    timer = setTimeout(() => {
+      timer = null;
+      void runScan();
+    }, debounceMs);
+  };
+  const onWatchEvent = (_eventType, fileName) => {
+    const relativePath = normalizeRelativePath(fileName);
+    if (relativePath && shouldIgnore(relativePath)) {
+      return;
+    }
+    scheduleScan();
+  };
+  return {
+    async start() {
+      if (started) return;
+      started = true;
+      watcher = watchFactory(rootPath, { recursive: true }, onWatchEvent);
+      await runScan();
+    },
+    close() {
+      closed = true;
+      if (timer) {
+        clearTimeout(timer);
+        timer = null;
+      }
+      watcher?.close();
+      watcher = null;
+    }
+  };
+}
+async function startWatchMode(rootPath, options = {}) {
+  const absoluteRoot = path2.resolve(rootPath);
+  const projectId = generateProjectId(absoluteRoot);
+  const debounceMs = options.debounceMs ?? 500;
+  await initFilter(absoluteRoot);
+  const runLockedScan = async () => {
+    logger.info({ rootPath: absoluteRoot }, "watch: \u89E6\u53D1\u589E\u91CF\u626B\u63CF");
+    await withLock(
+      projectId,
+      "index",
+      async () => {
+        const stats = await scan(absoluteRoot, { vectorIndex: true });
+        logger.info(
+          {
+            added: stats.added,
+            modified: stats.modified,
+            deleted: stats.deleted,
+            unchanged: stats.unchanged,
+            skipped: stats.skipped,
+            errors: stats.errors
+          },
+          "watch: \u626B\u63CF\u5B8C\u6210"
+        );
+      },
+      10 * 60 * 1e3
+    );
+  };
+  const coordinator = createWatchCoordinator(absoluteRoot, {
+    debounceMs,
+    scanFn: runLockedScan,
+    shouldIgnore: (relativePath) => isFiltered(relativePath)
+  });
+  await coordinator.start();
+  logger.info({ rootPath: absoluteRoot, debounceMs }, "watch: \u6587\u4EF6\u76D1\u542C\u5DF2\u542F\u52A8\uFF0C\u6309 Ctrl+C \u505C\u6B62");
+  const shutdown = () => {
+    coordinator.close();
+    logger.info("watch: \u6587\u4EF6\u76D1\u542C\u5DF2\u505C\u6B62");
+    process.exit(0);
+  };
+  process.once("SIGINT", shutdown);
+  process.once("SIGTERM", shutdown);
+  await new Promise(() => {
+  });
+}
+
+// src/index.ts
+var __dirname = path3.dirname(fileURLToPath(import.meta.url));
+var pkgPath = path3.resolve(__dirname, "../package.json");
+var pkg = JSON.parse(await fs2.readFile(pkgPath, "utf-8"));
 var cli = cac("contextweaver");
 if (process.argv.includes("-v") || process.argv.includes("--version")) {
   console.log(pkg.version);
   process.exit(0);
 }
 cli.command("init", "\u521D\u59CB\u5316 ContextWeaver \u914D\u7F6E").action(async () => {
-  const configDir = path.join(os.homedir(), ".contextweaver");
-  const envFile = path.join(configDir, ".env");
+  const configDir = path3.join(os.homedir(), ".contextweaver");
+  const envFile = path3.join(configDir, ".env");
   logger.info("\u5F00\u59CB\u521D\u59CB\u5316 ContextWeaver...");
   try {
-    await fs.mkdir(configDir, { recursive: true });
+    await fs2.mkdir(configDir, { recursive: true });
     logger.info(`\u521B\u5EFA\u914D\u7F6E\u76EE\u5F55: ${configDir}`);
   } catch (err) {
     const error = err;
@@ -41,32 +233,15 @@ cli.command("init", "\u521D\u59CB\u5316 ContextWeaver \u914D\u7F6E").action(asyn
     logger.info(`\u914D\u7F6E\u76EE\u5F55\u5DF2\u5B58\u5728: ${configDir}`);
   }
   try {
-    await fs.access(envFile);
+    await fs2.access(envFile);
     logger.warn(`.env \u6587\u4EF6\u5DF2\u5B58\u5728: ${envFile}`);
     logger.info("\u521D\u59CB\u5316\u5B8C\u6210\uFF01");
     return;
   } catch {
   }
-  const defaultEnvContent = `# ContextWeaver \u793A\u4F8B\u73AF\u5883\u53D8\u91CF\u914D\u7F6E\u6587\u4EF6
-
-# Embedding API \u914D\u7F6E\uFF08\u5FC5\u9700\uFF09
-EMBEDDINGS_API_KEY=your-api-key-here
-EMBEDDINGS_BASE_URL=https://api.siliconflow.cn/v1/embeddings
-EMBEDDINGS_MODEL=BAAI/bge-m3
-EMBEDDINGS_MAX_CONCURRENCY=10
-EMBEDDINGS_DIMENSIONS=1024
-
-# Reranker \u914D\u7F6E\uFF08\u5FC5\u9700\uFF09
-RERANK_API_KEY=your-api-key-here
-RERANK_BASE_URL=https://api.siliconflow.cn/v1/rerank
-RERANK_MODEL=BAAI/bge-reranker-v2-m3
-RERANK_TOP_N=20
-
-# \u7D22\u5F15\u5FFD\u7565\u6A21\u5F0F\uFF08\u53EF\u9009\uFF0C\u9017\u53F7\u5206\u9694\uFF0C\u9ED8\u8BA4\u5DF2\u5305\u542B\u5E38\u89C1\u5FFD\u7565\u9879\uFF09
-# IGNORE_PATTERNS=.venv,node_modules
-`;
+  const defaultEnvContent = getDefaultEnvFileContent();
   try {
-    await fs.writeFile(envFile, defaultEnvContent);
+    await fs2.writeFile(envFile, defaultEnvContent);
     logger.info(`\u521B\u5EFA .env \u6587\u4EF6: ${envFile}`);
   } catch (err) {
     const error = err;
@@ -79,7 +254,7 @@ RERANK_TOP_N=20
   logger.info("\u521D\u59CB\u5316\u5B8C\u6210\uFF01");
 });
 cli.command("index [path]", "\u626B\u63CF\u4EE3\u7801\u5E93\u5E76\u5EFA\u7ACB\u7D22\u5F15").option("-f, --force", "\u5F3A\u5236\u91CD\u65B0\u7D22\u5F15").action(async (targetPath, options) => {
-  const rootPath = targetPath ? path.resolve(targetPath) : process.cwd();
+  const rootPath = targetPath ? path3.resolve(targetPath) : process.cwd();
   const projectId = generateProjectId(rootPath);
   logger.info(`\u5F00\u59CB\u626B\u63CF: ${rootPath}`);
   logger.info(`\u9879\u76EE ID: ${projectId}`);
@@ -88,9 +263,9 @@ cli.command("index [path]", "\u626B\u63CF\u4EE3\u7801\u5E93\u5E76\u5EFA\u7ACB\u7
   }
   const startTime = Date.now();
   try {
-    const { withLock } = await import("./lock-DVY3KJSK.js");
+    const { withLock: withLock2 } = await import("./lock-HNKQ6X5B.js");
     let lastLoggedPercent = 0;
-    const stats = await withLock(
+    const stats = await withLock2(
       projectId,
       "index",
       async () => scan(rootPath, {
@@ -119,8 +294,23 @@ cli.command("index [path]", "\u626B\u63CF\u4EE3\u7801\u5E93\u5E76\u5EFA\u7ACB\u7
     process.exit(1);
   }
 });
+cli.command("watch [path]", "\u76D1\u542C\u6587\u4EF6\u53D8\u5316\u5E76\u81EA\u52A8\u6267\u884C\u589E\u91CF\u7D22\u5F15").option("--debounce <ms>", "\u9632\u6296\u65F6\u95F4\uFF08\u6BEB\u79D2\uFF0C\u9ED8\u8BA4 500\uFF09").action(async (targetPath, options) => {
+  const rootPath = targetPath ? path3.resolve(targetPath) : process.cwd();
+  const debounceMs = options.debounce ? Number.parseInt(options.debounce, 10) : 500;
+  if (!Number.isFinite(debounceMs) || debounceMs < 0) {
+    logger.error("\u65E0\u6548\u7684 --debounce \u53C2\u6570\uFF0C\u5FC5\u987B\u662F\u5927\u4E8E\u7B49\u4E8E 0 \u7684\u6574\u6570");
+    process.exit(1);
+  }
+  try {
+    await startWatchMode(rootPath, { debounceMs });
+  } catch (err) {
+    const error = err;
+    logger.error({ err, stack: error.stack }, `watch \u6A21\u5F0F\u542F\u52A8\u5931\u8D25: ${error.message}`);
+    process.exit(1);
+  }
+});
 cli.command("mcp", "\u542F\u52A8 MCP \u670D\u52A1\u5668").action(async () => {
-  const { startMcpServer } = await import("./server-27HI7WZO.js");
+  const { startMcpServer } = await import("./server-UAI3U7AB.js");
   try {
     await startMcpServer();
   } catch (err) {
@@ -134,14 +324,14 @@ cli.command("mcp", "\u542F\u52A8 MCP \u670D\u52A1\u5668").action(async () => {
 });
 cli.command("search", "\u672C\u5730\u68C0\u7D22\uFF08\u53C2\u6570\u5BF9\u9F50 MCP\uFF09").option("--repo-path <path>", "\u4EE3\u7801\u5E93\u6839\u76EE\u5F55\uFF08\u9ED8\u8BA4\u5F53\u524D\u76EE\u5F55\uFF09").option("--information-request <text>", "\u81EA\u7136\u8BED\u8A00\u95EE\u9898\u63CF\u8FF0\uFF08\u5FC5\u586B\uFF09").option("--technical-terms <terms>", "\u7CBE\u786E\u672F\u8BED\uFF08\u9017\u53F7\u5206\u9694\uFF09").action(
   async (options) => {
-    const repoPath = options.repoPath ? path.resolve(options.repoPath) : process.cwd();
+    const repoPath = options.repoPath ? path3.resolve(options.repoPath) : process.cwd();
     const informationRequest = options.informationRequest;
     if (!informationRequest) {
       logger.error("\u7F3A\u5C11 --information-request");
       process.exit(1);
     }
     const technicalTerms = (options.technicalTerms || "").split(",").map((t) => t.trim()).filter(Boolean);
-    const { handleCodebaseRetrieval } = await import("./codebaseRetrieval-NLAMGOA2.js");
+    const { handleCodebaseRetrieval } = await import("./codebaseRetrieval-DIS5RH2C.js");
     const response = await handleCodebaseRetrieval({
       repo_path: repoPath,
       information_request: informationRequest,
@@ -152,6 +342,47 @@ cli.command("search", "\u672C\u5730\u68C0\u7D22\uFF08\u53C2\u6570\u5BF9\u9F50 MC
 `);
   }
 );
+cli.command("migrate", "LanceDB \u8FC1\u79FB\u7BA1\u7406\uFF08CRIT-B/CRIT-C\uFF09").option("--reset", "\u6E05\u7A7A LanceDB chunks \u8868\u5E76\u91CD\u7F6E\u8FC1\u79FB\u72B6\u6001\uFF08\u7528\u4E8E\u89E3\u9664 aborted\uFF09").option("-p, --path <path>", "\u9879\u76EE\u8DEF\u5F84\uFF08\u9ED8\u8BA4\u5F53\u524D\u76EE\u5F55\uFF09").action(async (options) => {
+  const rootPath = options.path ? path3.resolve(options.path) : process.cwd();
+  const projectId = generateProjectId(rootPath);
+  const { initDb, getLanceDbMigrationState, setLanceDbMigrationState, clearAllVectorIndexHash } = await import("./db-GBCLP4GG.js");
+  const db = initDb(projectId);
+  const state = getLanceDbMigrationState(db);
+  logger.info({ projectId, state }, "\u5F53\u524D LanceDB \u8FC1\u79FB\u72B6\u6001");
+  if (!options.reset) {
+    logger.info("\u5982\u9700\u89E3\u9664 aborted \u72B6\u6001\uFF0C\u4F7F\u7528 --reset \u9009\u9879");
+    db.close();
+    return;
+  }
+  if (state !== "aborted" && state !== "pending") {
+    logger.info(`\u72B6\u6001\u4E3A ${state ?? "\u672A\u8BBE\u7F6E"}\uFF0C\u65E0\u9700 reset`);
+    db.close();
+    return;
+  }
+  const { getVectorStore } = await import("./vectorStore-4ODCERRO.js");
+  const { getEmbeddingConfig } = await import("./config-LCOJHTCF.js");
+  const store = await getVectorStore(projectId, getEmbeddingConfig().dimensions);
+  await store.clear();
+  logger.info("LanceDB chunks \u8868\u5DF2\u6E05\u7A7A");
+  const cleared = clearAllVectorIndexHash(db);
+  logger.info({ cleared }, "vector_index_hash \u5DF2\u6E05\u7A7A");
+  setLanceDbMigrationState(db, "done");
+  logger.info("\u8FC1\u79FB\u72B6\u6001\u5DF2\u91CD\u7F6E\u4E3A done\u3002\u8BF7\u91CD\u65B0\u8FD0\u884C `contextweaver index` \u91CD\u5EFA\u7D22\u5F15\u3002");
+  db.close();
+});
+cli.command("stats", "\u67E5\u770B\u7D22\u5F15/\u641C\u7D22/\u5065\u5EB7\u7EDF\u8BA1").option("--json", "\u4EE5 JSON \u683C\u5F0F\u8F93\u51FA").option("-p, --path <path>", "\u9879\u76EE\u8DEF\u5F84\uFF08\u9ED8\u8BA4\u5F53\u524D\u76EE\u5F55\uFF09").action(async (options) => {
+  const rootPath = options.path ? path3.resolve(options.path) : process.cwd();
+  const projectId = generateProjectId(rootPath);
+  const { collectStats, renderStatsText } = await import("./stats-AGKUCJQI.js");
+  const report = await collectStats(projectId);
+  if (options.json) {
+    process.stdout.write(`${JSON.stringify(report, null, 2)}
+`);
+  } else {
+    process.stdout.write(`${renderStatsText(report)}
+`);
+  }
+});
+registerMirrorCommands(cli);
 cli.help();
 cli.parse();
-//# sourceMappingURL=index.js.map

package/dist/listFiles-4VT2TPJD.js

@@ -0,0 +1,14 @@
+import {
+  handleListFiles,
+  listFilesSchema
+} from "./chunk-Y6H7C3NA.js";
+import "./chunk-VWBKZ6QL.js";
+import "./chunk-TPM6YP43.js";
+import "./chunk-BFCIZ52F.js";
+import "./chunk-PPLFJGO3.js";
+import "./chunk-JVKVSTQ3.js";
+import "./chunk-SKBAE26T.js";
+export {
+  handleListFiles,
+  listFilesSchema
+};

package/dist/loadConfig-XTVT2OWW.js

@@ -0,0 +1,9 @@
+import {
+  createSearchConfigFingerprint,
+  getSearchConfigOverrides
+} from "./chunk-IZ6IUHNN.js";
+import "./chunk-BFCIZ52F.js";
+export {
+  createSearchConfigFingerprint,
+  getSearchConfigOverrides
+};

package/dist/lock-HNKQ6X5B.js

@@ -0,0 +1,8 @@
+import {
+  withLock
+} from "./chunk-HHYPQA3X.js";
+import "./chunk-JVKVSTQ3.js";
+import "./chunk-SKBAE26T.js";
+export {
+  withLock
+};

package/dist/scanner-QDFZJLP7.js

@@ -0,0 +1,13 @@
+import {
+  scan
+} from "./chunk-GDVB6PJ4.js";
+import "./chunk-XMZZZKG7.js";
+import "./chunk-LB42CZEB.js";
+import "./chunk-XFIM2T6S.js";
+import "./chunk-3BNHQV5W.js";
+import "./chunk-PPLFJGO3.js";
+import "./chunk-JVKVSTQ3.js";
+import "./chunk-SKBAE26T.js";
+export {
+  scan
+};