@chiway/contextweaver 1.0.0

package/dist/chunk-RJURH22T.js

@@ -0,0 +1,266 @@
+// src/config.ts
+import fs from "fs";
+import os from "os";
+import path from "path";
+import dotenv from "dotenv";
+var isDev = process.env.NODE_ENV === "dev";
+var isMcpMode = process.argv.includes("mcp");
+function loadEnv() {
+  const candidates = isDev ? [
+    path.join(process.cwd(), ".env"),
+    // 1. 当前目录（开发用）
+    path.join(os.homedir(), ".contextweaver", ".env")
+    // 2. 用户配置目录（回退）
+  ] : [
+    path.join(os.homedir(), ".contextweaver", ".env")
+    // 生产环境只用用户配置
+  ];
+  const envPath = candidates.find((p) => fs.existsSync(p));
+  if (envPath) {
+    const result = dotenv.config({ path: envPath, quiet: true });
+    if (result.error) {
+      console.error(`[config] \u52A0\u8F7D\u73AF\u5883\u53D8\u91CF\u5931\u8D25: ${result.error.message}`);
+      process.exit(1);
+    }
+  }
+}
+loadEnv();
+var DEFAULT_API_KEY_PLACEHOLDER = "your-api-key-here";
+function checkEmbeddingEnv() {
+  const missingVars = [];
+  const apiKey = process.env.EMBEDDINGS_API_KEY;
+  if (!apiKey || apiKey === DEFAULT_API_KEY_PLACEHOLDER) {
+    missingVars.push("EMBEDDINGS_API_KEY");
+  }
+  if (!process.env.EMBEDDINGS_BASE_URL) {
+    missingVars.push("EMBEDDINGS_BASE_URL");
+  }
+  if (!process.env.EMBEDDINGS_MODEL) {
+    missingVars.push("EMBEDDINGS_MODEL");
+  }
+  return {
+    isValid: missingVars.length === 0,
+    missingVars
+  };
+}
+function checkRerankerEnv() {
+  const missingVars = [];
+  const apiKey = process.env.RERANK_API_KEY;
+  if (!apiKey || apiKey === DEFAULT_API_KEY_PLACEHOLDER) {
+    missingVars.push("RERANK_API_KEY");
+  }
+  if (!process.env.RERANK_BASE_URL) {
+    missingVars.push("RERANK_BASE_URL");
+  }
+  if (!process.env.RERANK_MODEL) {
+    missingVars.push("RERANK_MODEL");
+  }
+  return {
+    isValid: missingVars.length === 0,
+    missingVars
+  };
+}
+function getEmbeddingConfig() {
+  const apiKey = process.env.EMBEDDINGS_API_KEY;
+  const baseUrl = process.env.EMBEDDINGS_BASE_URL;
+  const model = process.env.EMBEDDINGS_MODEL;
+  const maxConcurrency = parseInt(process.env.EMBEDDINGS_MAX_CONCURRENCY || "10", 10);
+  if (!apiKey) {
+    throw new Error("EMBEDDINGS_API_KEY \u73AF\u5883\u53D8\u91CF\u672A\u8BBE\u7F6E");
+  }
+  if (!baseUrl) {
+    throw new Error("EMBEDDINGS_BASE_URL \u73AF\u5883\u53D8\u91CF\u672A\u8BBE\u7F6E");
+  }
+  if (!model) {
+    throw new Error("EMBEDDINGS_MODEL \u73AF\u5883\u53D8\u91CF\u672A\u8BBE\u7F6E");
+  }
+  const dimensions = parseInt(process.env.EMBEDDINGS_DIMENSIONS || "1024", 10);
+  return {
+    apiKey,
+    baseUrl,
+    model,
+    maxConcurrency: Number.isNaN(maxConcurrency) ? 4 : maxConcurrency,
+    dimensions: Number.isNaN(dimensions) ? 1024 : dimensions
+  };
+}
+function getRerankerConfig() {
+  const apiKey = process.env.RERANK_API_KEY;
+  const baseUrl = process.env.RERANK_BASE_URL;
+  const model = process.env.RERANK_MODEL;
+  const topN = parseInt(process.env.RERANK_TOP_N || "10", 10);
+  if (!apiKey) {
+    throw new Error("RERANK_API_KEY \u73AF\u5883\u53D8\u91CF\u672A\u8BBE\u7F6E");
+  }
+  if (!baseUrl) {
+    throw new Error("RERANK_BASE_URL \u73AF\u5883\u53D8\u91CF\u672A\u8BBE\u7F6E");
+  }
+  if (!model) {
+    throw new Error("RERANK_MODEL \u73AF\u5883\u53D8\u91CF\u672A\u8BBE\u7F6E");
+  }
+  return {
+    apiKey,
+    baseUrl,
+    model,
+    topN: Number.isNaN(topN) ? 10 : topN
+  };
+}
+var DEFAULT_EXCLUDE_PATTERNS = [
+  // --- 1. 依赖与环境 (绝对黑名单) ---
+  "node_modules",
+  "bower_components",
+  ".venv",
+  "venv",
+  // Python 虚拟环境
+  ".env.*",
+  // 环境变量文件 (.env.local, .env.production 等)
+  // --- 2. 锁文件 (Token 杀手，且语义密度极低) ---
+  "package-lock.json",
+  "yarn.lock",
+  "pnpm-lock.yaml",
+  "bun.lockb",
+  "poetry.lock",
+  "Gemfile.lock",
+  "composer.lock",
+  "Cargo.lock",
+  // --- 3. 版本控制与 IDE ---
+  ".git",
+  ".svn",
+  ".hg",
+  ".idea",
+  ".vscode",
+  ".vs",
+  // --- 4. 构建产物与缓存 ---
+  // 通用构建输出
+  "dist",
+  "build",
+  "out",
+  "target",
+  // 编译产物
+  "*.pyc",
+  "*.pyo",
+  "*.pyd",
+  "*.so",
+  "*.dll",
+  "*.exe",
+  "*.bin",
+  "*.wasm",
+  // 现代前端框架产物
+  ".next",
+  ".nuxt",
+  ".output",
+  ".svelte-kit",
+  // Bundler 缓存
+  ".turbo",
+  ".parcel-cache",
+  ".webpack",
+  ".esbuild",
+  ".rollup.cache",
+  // 测试覆盖率
+  "coverage",
+  ".nyc_output",
+  // Python 缓存
+  "__pycache__",
+  ".pytest_cache",
+  ".mypy_cache",
+  ".tox",
+  ".eggs",
+  "*.egg-info",
+  // --- 5. 纯噪音文件 (无文本语义) ---
+  // 压缩文件与 SourceMap
+  "*.min.js",
+  "*.min.css",
+  "*.map",
+  // 图片与多媒体
+  "*.svg",
+  "*.png",
+  "*.jpg",
+  "*.jpeg",
+  "*.gif",
+  "*.ico",
+  "*.webp",
+  "*.bmp",
+  "*.pdf",
+  "*.mp3",
+  "*.mp4",
+  "*.wav",
+  "*.webm",
+  "*.ogg",
+  "*.flac",
+  // 字体文件
+  "*.woff",
+  "*.woff2",
+  "*.ttf",
+  "*.eot",
+  "*.otf",
+  // 压缩包
+  "*.zip",
+  "*.tar",
+  "*.gz",
+  "*.rar",
+  "*.7z",
+  // 系统垃圾
+  ".DS_Store",
+  "Thumbs.db",
+  // --- 6. 测试噪音 (保留 *.test.ts，但剔除这些) ---
+  // Jest 快照
+  "__snapshots__",
+  "*.snap",
+  // 测试夹具与数据
+  "test/fixtures",
+  "tests/fixtures",
+  "__fixtures__",
+  "test/data",
+  "tests/data",
+  "testdata",
+  "test-data",
+  "testutils",
+  // Mock 数据
+  "mock",
+  "mocks",
+  "__mocks__",
+  "stub",
+  "stubs",
+  // --- 7. 第三方与生成文件 ---
+  // 第三方依赖目录
+  "vendor",
+  "vendors",
+  "third_party",
+  "thirdparty",
+  "3rdparty",
+  "external",
+  "externals",
+  // 生成文件
+  "generated",
+  "gen",
+  "auto-generated",
+  "*.generated.ts",
+  "*.generated.js",
+  "*.pb.go",
+  "*.pb.ts",
+  // protobuf 生成
+  // --- 8. 日志与临时文件 ---
+  "*.log",
+  ".cache",
+  ".tmp",
+  "tmp"
+];
+function getExcludePatterns() {
+  const envPatterns = process.env.IGNORE_PATTERNS;
+  const patterns = [...DEFAULT_EXCLUDE_PATTERNS];
+  if (envPatterns) {
+    const additional = envPatterns.split(",").map((p) => p.trim()).filter(Boolean);
+    patterns.push(...additional);
+  }
+  return patterns;
+}
+
+export {
+  isDev,
+  isMcpMode,
+  checkEmbeddingEnv,
+  checkRerankerEnv,
+  getEmbeddingConfig,
+  getRerankerConfig,
+  getExcludePatterns
+};
+//# sourceMappingURL=chunk-RJURH22T.js.map

package/dist/codebaseRetrieval-IC44RHCL.js

@@ -0,0 +1,12 @@
+import {
+  codebaseRetrievalSchema,
+  handleCodebaseRetrieval
+} from "./chunk-EZG4H4MN.js";
+import "./chunk-B6OWNBOD.js";
+import "./chunk-AMQQK4P7.js";
+import "./chunk-RJURH22T.js";
+export {
+  codebaseRetrievalSchema,
+  handleCodebaseRetrieval
+};
+//# sourceMappingURL=codebaseRetrieval-IC44RHCL.js.map

package/dist/config-BWZ6CU3W.js

@@ -0,0 +1,19 @@
+import {
+  checkEmbeddingEnv,
+  checkRerankerEnv,
+  getEmbeddingConfig,
+  getExcludePatterns,
+  getRerankerConfig,
+  isDev,
+  isMcpMode
+} from "./chunk-RJURH22T.js";
+export {
+  checkEmbeddingEnv,
+  checkRerankerEnv,
+  getEmbeddingConfig,
+  getExcludePatterns,
+  getRerankerConfig,
+  isDev,
+  isMcpMode
+};
+//# sourceMappingURL=config-BWZ6CU3W.js.map

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+import {
+  scan
+} from "./chunk-2CY5SYBI.js";
+import "./chunk-HR5KUQSM.js";
+import {
+  generateProjectId
+} from "./chunk-B6OWNBOD.js";
+import {
+  logger
+} from "./chunk-AMQQK4P7.js";
+import "./chunk-RJURH22T.js";
+
+// src/index.ts
+import { promises as fs } from "fs";
+import os from "os";
+import path 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"));
+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");
+  logger.info("\u5F00\u59CB\u521D\u59CB\u5316 ContextWeaver...");
+  try {
+    await fs.mkdir(configDir, { recursive: true });
+    logger.info(`\u521B\u5EFA\u914D\u7F6E\u76EE\u5F55: ${configDir}`);
+  } catch (err) {
+    const error = err;
+    if (error.code !== "EEXIST") {
+      logger.error({ err, stack: error.stack }, `\u521B\u5EFA\u914D\u7F6E\u76EE\u5F55\u5931\u8D25: ${error.message}`);
+      process.exit(1);
+    }
+    logger.info(`\u914D\u7F6E\u76EE\u5F55\u5DF2\u5B58\u5728: ${configDir}`);
+  }
+  try {
+    await fs.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
+`;
+  try {
+    await fs.writeFile(envFile, defaultEnvContent);
+    logger.info(`\u521B\u5EFA .env \u6587\u4EF6: ${envFile}`);
+  } catch (err) {
+    const error = err;
+    logger.error({ err, stack: error.stack }, `\u521B\u5EFA .env \u6587\u4EF6\u5931\u8D25: ${error.message}`);
+    process.exit(1);
+  }
+  logger.info("\u4E0B\u4E00\u6B65\u64CD\u4F5C:");
+  logger.info(`   1. \u7F16\u8F91\u914D\u7F6E\u6587\u4EF6: ${envFile}`);
+  logger.info("   2. \u586B\u5199\u4F60\u7684 API Key \u548C\u5176\u4ED6\u914D\u7F6E");
+  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 projectId = generateProjectId(rootPath);
+  logger.info(`\u5F00\u59CB\u626B\u63CF: ${rootPath}`);
+  logger.info(`\u9879\u76EE ID: ${projectId}`);
+  if (options.force) {
+    logger.info("\u5F3A\u5236\u91CD\u65B0\u7D22\u5F15: \u662F");
+  }
+  const startTime = Date.now();
+  try {
+    const { withLock } = await import("./lock-DVY3KJSK.js");
+    let lastLoggedPercent = 0;
+    const stats = await withLock(
+      projectId,
+      "index",
+      async () => scan(rootPath, {
+        force: options.force,
+        onProgress: (current, total, message) => {
+          if (total !== void 0) {
+            const percent = Math.floor(current / total * 100);
+            if (percent >= lastLoggedPercent + 30 && percent < 100) {
+              logger.info(`\u7D22\u5F15\u8FDB\u5EA6: ${percent}% - ${message || ""}`);
+              lastLoggedPercent = Math.floor(percent / 30) * 30;
+            }
+          }
+        }
+      }),
+      10 * 60 * 1e3
+    );
+    process.stdout.write("\n");
+    const duration = ((Date.now() - startTime) / 1e3).toFixed(2);
+    logger.info(`\u7D22\u5F15\u5B8C\u6210 (${duration}s)`);
+    logger.info(
+      `\u603B\u6570:${stats.totalFiles} \u65B0\u589E:${stats.added} \u4FEE\u6539:${stats.modified} \u672A\u53D8:${stats.unchanged} \u5220\u9664:${stats.deleted} \u8DF3\u8FC7:${stats.skipped} \u9519\u8BEF:${stats.errors}`
+    );
+  } catch (err) {
+    const error = err;
+    logger.error({ err, stack: error.stack }, `\u7D22\u5F15\u5931\u8D25: ${error.message}`);
+    process.exit(1);
+  }
+});
+cli.command("mcp", "\u542F\u52A8 MCP \u670D\u52A1\u5668").action(async () => {
+  const { startMcpServer } = await import("./server-PPQUHCUB.js");
+  try {
+    await startMcpServer();
+  } catch (err) {
+    const error = err;
+    logger.error(
+      { error: error.message, stack: error.stack },
+      `MCP \u670D\u52A1\u5668\u542F\u52A8\u5931\u8D25: ${error.message}`
+    );
+    process.exit(1);
+  }
+});
+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 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-IC44RHCL.js");
+    const response = await handleCodebaseRetrieval({
+      repo_path: repoPath,
+      information_request: informationRequest,
+      technical_terms: technicalTerms.length > 0 ? technicalTerms : void 0
+    });
+    const text = response.content.map((item) => item.text).join("\n");
+    process.stdout.write(`${text}
+`);
+  }
+);
+cli.help();
+cli.parse();
+//# sourceMappingURL=index.js.map

package/dist/lock-DVY3KJSK.js

@@ -0,0 +1,128 @@
+import {
+  logger
+} from "./chunk-AMQQK4P7.js";
+import "./chunk-RJURH22T.js";
+
+// src/utils/lock.ts
+import fs from "fs";
+import os from "os";
+import path from "path";
+var BASE_DIR = path.join(os.homedir(), ".contextweaver");
+var LOCK_CHECK_INTERVAL_MS = 100;
+var LOCK_WRITE_GRACE_MS = 2e3;
+function getLockAgeMs(lockPath) {
+  try {
+    const stats = fs.statSync(lockPath);
+    return Date.now() - stats.mtimeMs;
+  } catch {
+    return null;
+  }
+}
+function getLockFilePath(projectId) {
+  return path.join(BASE_DIR, projectId, "index.lock");
+}
+function isLockValid(lockPath) {
+  try {
+    if (!fs.existsSync(lockPath)) {
+      return false;
+    }
+    const content = fs.readFileSync(lockPath, "utf-8");
+    const lockInfo = JSON.parse(content);
+    try {
+      process.kill(lockInfo.pid, 0);
+      return true;
+    } catch (err) {
+      const error = err;
+      if (error.code === "EPERM") {
+        return true;
+      }
+      logger.warn({ pid: lockInfo.pid }, "\u6301\u6709\u9501\u7684\u8FDB\u7A0B\u5DF2\u6B7B\u4EA1");
+      return false;
+    }
+  } catch (err) {
+    const ageMs = getLockAgeMs(lockPath);
+    if (ageMs !== null && ageMs <= LOCK_WRITE_GRACE_MS) {
+      return true;
+    }
+    const error = err;
+    logger.debug({ error: error.message }, "\u8BFB\u53D6\u9501\u6587\u4EF6\u5931\u8D25");
+    return false;
+  }
+}
+async function acquireLock(projectId, operation, timeoutMs = 3e4) {
+  const lockPath = getLockFilePath(projectId);
+  const dir = path.dirname(lockPath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  const startTime = Date.now();
+  while (Date.now() - startTime < timeoutMs) {
+    try {
+      const lockInfo = {
+        pid: process.pid,
+        timestamp: Date.now(),
+        operation
+      };
+      fs.writeFileSync(lockPath, JSON.stringify(lockInfo), { flag: "wx" });
+      logger.debug({ projectId: projectId.slice(0, 10), operation }, "\u83B7\u53D6\u9501\u6210\u529F");
+      return true;
+    } catch (err) {
+      const error = err;
+      if (error.code === "EEXIST") {
+        if (!isLockValid(lockPath)) {
+          try {
+            fs.unlinkSync(lockPath);
+            logger.warn({ projectId: projectId.slice(0, 10) }, "\u79FB\u9664\u5931\u6548\u9501");
+            continue;
+          } catch (unlinkErr) {
+            const unlinkError = unlinkErr;
+            if (unlinkError.code !== "ENOENT") {
+              logger.debug({ error: unlinkError.message }, "\u79FB\u9664\u5931\u6548\u9501\u5931\u8D25\uFF0C\u91CD\u8BD5\u4E2D...");
+            }
+          }
+        } else {
+          logger.debug({ projectId: projectId.slice(0, 10) }, "\u7B49\u5F85\u9501\u91CA\u653E...");
+        }
+      } else {
+        logger.debug({ error: error.message }, "\u83B7\u53D6\u9501\u5931\u8D25\uFF0C\u91CD\u8BD5\u4E2D...");
+      }
+    }
+    await new Promise((resolve) => setTimeout(resolve, LOCK_CHECK_INTERVAL_MS));
+  }
+  logger.warn({ projectId: projectId.slice(0, 10), timeoutMs }, "\u83B7\u53D6\u9501\u8D85\u65F6");
+  return false;
+}
+function releaseLock(projectId) {
+  const lockPath = getLockFilePath(projectId);
+  try {
+    if (!fs.existsSync(lockPath)) {
+      return;
+    }
+    const content = fs.readFileSync(lockPath, "utf-8");
+    const lockInfo = JSON.parse(content);
+    if (lockInfo.pid === process.pid) {
+      fs.unlinkSync(lockPath);
+      logger.debug({ projectId: projectId.slice(0, 10) }, "\u91CA\u653E\u9501\u6210\u529F");
+    } else {
+      logger.warn({ ownPid: process.pid, lockPid: lockInfo.pid }, "\u5C1D\u8BD5\u91CA\u653E\u975E\u81EA\u5DF1\u6301\u6709\u7684\u9501");
+    }
+  } catch (err) {
+    const error = err;
+    logger.debug({ error: error.message }, "\u91CA\u653E\u9501\u65F6\u51FA\u9519");
+  }
+}
+async function withLock(projectId, operation, fn, timeoutMs = 3e4) {
+  const acquired = await acquireLock(projectId, operation, timeoutMs);
+  if (!acquired) {
+    throw new Error(`\u65E0\u6CD5\u83B7\u53D6\u9879\u76EE\u9501 (${projectId.slice(0, 10)})\uFF0C\u5176\u4ED6\u8FDB\u7A0B\u6B63\u5728\u64CD\u4F5C\u7D22\u5F15`);
+  }
+  try {
+    return await fn();
+  } finally {
+    releaseLock(projectId);
+  }
+}
+export {
+  withLock
+};
+//# sourceMappingURL=lock-DVY3KJSK.js.map

package/dist/scanner-SZ2BDYDS.js

@@ -0,0 +1,11 @@
+import {
+  scan
+} from "./chunk-2CY5SYBI.js";
+import "./chunk-HR5KUQSM.js";
+import "./chunk-B6OWNBOD.js";
+import "./chunk-AMQQK4P7.js";
+import "./chunk-RJURH22T.js";
+export {
+  scan
+};
+//# sourceMappingURL=scanner-SZ2BDYDS.js.map