@coreyuan/vector-mind 1.0.49 → 1.0.52

package/README.md

@@ -1,37 +1,59 @@
 # VectorMind MCP
 
-VectorMind 是一个给 AI 编程助手用的本地项目记忆 MCP。
-
-它把“当前在做什么、为什么这样改、哪些决定已经更新、哪些文件不能乱动”保存到项目本地，帮助 AI 在长周期开发里少丢上下文、少猜路径、少把旧功能改回来。
-
-当前版本：`1.0.49`
-
-## 1.0.49 的效果
-
-- 普通新功能遇到 3000 行以上实现文件，会被拦住，不再继续往巨量文件里堆代码。
-- AI 会先收到 `huge_file_modularization_required`，并被要求进入机械搬迁式模块化拆分流程。
-- 拆分会使用真实模块名和清晰目录，按完整函数、类型、类、impl、声明块搬迁。
-- 拆分时禁止创建 `*.generated.*`、`.parts`、`*.rs.parts`、`part1/part2` 这类假拆分文件。
-- 只有明确进入 `mechanical_modularization` 模式时，AI 才能继续操作巨量文件做拆分。
-- 拆分计划和拆分结果会被记录，后续会话能知道这个文件正在或已经被拆，不会每次都只重复提示。
-- 这只影响开发规范、文件边界和上下文记忆，不处理客户端运行权限或审批权限。
-
-## 主要能力
-
-- **恢复上下文**：新会话可恢复项目总结、最新决策、近期需求、近期改动、待同步变化。
-- **记录需求**：每次开发先记录一个清晰需求，后续改动归属到这个需求下。
-- **记录改动原因**：改完代码后保存“改了什么、为什么改”。
-- **最新决策优先**：新规则可以覆盖旧记录，减少 AI 按旧需求回退功能。
-- **项目知识沉淀**：保存项目总结、笔记、约定、构建命令、命名规则、TODO。
-- **代码定位**：维护文件和符号索引，帮助 AI 找函数、类、配置、关键逻辑。
-- **安全读文件/搜索**：提供有边界的文件列表、按行读取、文本搜索，避免一次塞入太多内容。
-- **本地记忆搜索**：搜索需求、改动、决策、笔记、代码片段和文档片段。
-- **Pending Changes**：发现“文件变了但还没记录原因”的改动。
-- **开发边界检查**：改代码前检查目标文件是否超出当前需求，避免乱改相关但未要求的功能。
-- **巨量文件拆分引导**：检测到巨量实现文件时，要求先做机械搬迁式模块化拆分，使用真实模块目录，禁止 `*.generated.*`、`.parts`、`*.rs.parts`、`part1/part2` 这类假拆分。
-- **记忆维护**：压缩过旧记忆、清理无效索引，减轻大项目长期使用后的检索压力。
-- **低 token 输出**：默认返回 compact 结果，也集成 `rtk` 来减少命令输出占用。
-- **内置开发规范**：提供计划、架构、UI 输出、git 提交、长线程、大文件、需求边界等开发规范；只定义开发质量要求，不接管客户端操作权限。
+VectorMind 是给 AI 编程助手用的本地项目记忆 MCP。
+
+它会把“当前在做什么、为什么这样改、哪些决策已经更新、哪些文件不能乱动”保存到项目本地，帮助 AI 在长期开发里少丢上下文、少猜路径、少把旧功能改回来。
+
+当前版本：`1.0.52`
+
+## 它能做什么
+
+- **恢复上下文**：新会话可以找回项目摘要、最近需求、最近改动、决策、约定和待同步文件。
+- **守住需求边界**：修改前先确认当前需求和计划文件，减少乱改无关模块。
+- **记录改动原因**：改完后保存“改了什么、为什么改”，后续会话能接上。
+- **让新决策覆盖旧记忆**：需求反转或规则更新后，可以标记旧记忆过时，避免 AI 按旧规则回退功能。
+- **查看上下文时间线**：按需求、文件、记忆或关键词查看前后发生了什么，帮助判断新旧关系。
+- **保存会话检查点**：长会话或交接前保存 waypoint，后续只读恢复上下文，不改变模型判断。
+- **诊断记忆质量**：检查记忆冲突、重复记忆和 checkpoint 差异，只给证据，不自动修改。
+- **沉淀项目知识**：保存架构说明、构建命令、命名规则、注意事项和 TODO。
+- **定位代码和搜索文本**：帮 AI 找函数、类、配置、关键逻辑，不靠猜。
+- **安全读取文件**：按目录、按行、按大小读取，避免一次塞入过多上下文。
+- **治理巨量文件**：遇到几千行实现文件，会要求先做真实模块拆分，不继续往大文件里堆代码。
+- **维护长期记忆**：压缩过时记忆、清理无效索引，减轻大项目越用越慢的问题。
+- **减少输出占用**：默认返回简洁结果，并可配合 `rtk` 降低命令输出负担。
+
+更完整的能力表见：`docs/capability-matrix.md`
+
+## 推荐工作流
+
+开发任务建议让 AI 按这个顺序使用：
+
+1. 恢复上下文：`bootstrap_context`
+2. 记录当前需求：`start_requirement`
+3. 修改前检查范围：`preflight_change_scope`
+4. 修改文件
+5. 查看未同步改动：`get_pending_changes`
+6. 同步改动原因：`sync_change_intent`
+7. 需求规则变化时：`upsert_decision` / `supersede_memory`
+8. 完成后：`upsert_project_summary` / `complete_requirement`
+
+## 巨量文件规则
+
+当实现文件达到巨量阈值时，VectorMind 会提示：
+
+- 不要继续往这个文件里加新功能。
+- 先做机械搬迁式模块化拆分。
+- 使用真实模块名和清晰目录。
+- 禁止 `*.generated.*`、`.parts`、`*.rs.parts`、`part1/part2` 这类假拆分。
+- 拆分计划和结果会被记录，后续会话知道这个文件正在或已经被治理。
+
+## 它不做什么
+
+VectorMind 只定义开发规范、记忆和质量约束。
+
+它的输出只是上下文证据和质量信号，不替模型做决定，不削弱模型自己的推理、判断、创造和实现能力。
+
+它不接管 Codex、Claude 或其他客户端的运行控制，也不处理客户端自己的确认弹窗、执行策略或访问设置。
 
 ## 安装
 
@@ -45,16 +67,16 @@ npx -y @coreyuan/vector-mind
 npm install -g @coreyuan/vector-mind
 ```
 
-全局安装后会提供：
+全局安装后可用：
 
 ```text
 vector-mind
 rtk
 ```
 
-## Codex 配置示例
+## Codex 配置
 
-在 `~/.codex/config.toml` 中添加：
+在 `~/.codex/config.toml` 添加：
 
 ```toml
 [mcp_servers.vector-mind]
@@ -65,7 +87,7 @@ args = ["-y", "@coreyuan/vector-mind"]
 
 配置后重启 Codex，并开启新会话。
 
-## Claude Desktop 配置示例
+## Claude Desktop 配置
 
 ```json
 {
@@ -78,23 +100,9 @@ args = ["-y", "@coreyuan/vector-mind"]
 }
 ```
 
-## 推荐用法
-
-你不需要记工具名，直接这样告诉 AI 即可：
+## 多项目使用
 
-```text
-先用 VectorMind 恢复这个项目的上下文，再继续做。
-```
-
-```text
-这是最新决定：任务申请不再需要上级审核，申请后直接通过。请写入 VectorMind，并标记旧审核需求已过时。
-```
-
-```text
-改完后，把这次改动原因同步到 VectorMind。
-```
-
-多项目使用时，建议明确项目路径：
+建议明确告诉 AI 当前项目路径：
 
 ```text
 这个任务的项目路径是 H:\2025\YourProject，请 VectorMind 使用这个 project_root。
@@ -106,24 +114,23 @@ args = ["-y", "@coreyuan/vector-mind"]
 <project>/.vectormind/
 ```
 
-## 主要工具
+## 常用工具
 
 | 能力 | 工具 |
 | --- | --- |
 | 恢复上下文 | `bootstrap_context`, `get_brain_dump` |
-| 需求管理 | `start_requirement`, `complete_requirement` |
+| 需求管理 | `start_requirement`, `preflight_change_scope`, `complete_requirement` |
 | 改动记录 | `sync_change_intent`, `get_pending_changes` |
-| 开发边界检查 | `preflight_change_scope`, `development_warnings` |
-| 巨量文件拆分 | `plan_large_file_split`, `record_large_file_split` |
-| 最新决策 | `upsert_decision`, `supersede_memory` |
+| 决策更新 | `upsert_decision`, `supersede_memory` |
 | 项目知识 | `upsert_project_summary`, `add_note`, `upsert_convention` |
-| 搜索记忆 | `semantic_search`, `read_memory_item` |
+| 时间线/检查点 | `memory_timeline`, `create_checkpoint`, `list_checkpoints`, `restore_checkpoint_context` |
+| 记忆诊断 | `analyze_memory_conflicts`, `memory_quality_report`, `compare_checkpoint_context` |
 | 代码定位 | `query_codebase`, `grep` |
 | 读项目文件 | `list_project_files`, `read_file_lines`, `read_file_text` |
 | 读 Codex 文本 | `read_codex_text_file` |
+| 巨量文件拆分 | `plan_large_file_split`, `record_large_file_split` |
 | 记忆维护 | `maintain_memory`, `prune_index` |
-| token 节省 | `detect_rtk`, `install_rtk`, `get_token_savings` |
-| 调试 | `get_activity_summary`, `get_activity_log`, `clear_activity_log` |
+| 调试/降噪 | `get_activity_summary`, `get_activity_log`, `get_token_savings`, `detect_rtk` |
 
 ## 开发与发布
 

package/dist/activity-log.d.ts

@@ -0,0 +1,19 @@
+export declare function configureActivityLogProjectRoot(fn: () => string): void;
+type ActivityEvent = {
+    id: number;
+    ts: string;
+    type: string;
+    project_root: string;
+    data: Record<string, unknown>;
+};
+export declare function logActivity(type: string, data: Record<string, unknown>): void;
+export declare function snapshotActivityLog(opts: {
+    sinceId: number;
+    limit: number;
+}): {
+    events: ActivityEvent[];
+    last_id: number;
+};
+export declare function clearActivityLog(): void;
+export declare function summarizeActivityEvent(e: ActivityEvent): string;
+export {};

package/dist/activity-log.js

@@ -0,0 +1,106 @@
+import { debugLogEnabled, debugLogMaxEntries } from "./config.js";
+let getProjectRoot = () => "";
+export function configureActivityLogProjectRoot(fn) {
+    getProjectRoot = fn;
+}
+let activitySeq = 0;
+const activityLog = [];
+function sanitizeForLog(value, depth = 0) {
+    if (depth > 4)
+        return "[max-depth]";
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value === "string") {
+        return value.length > 500 ? `${value.slice(0, 500)}...` : value;
+    }
+    if (typeof value === "number" || typeof value === "boolean")
+        return value;
+    if (Array.isArray(value)) {
+        const sliced = value.slice(0, 20).map((v) => sanitizeForLog(v, depth + 1));
+        return value.length > 20 ? [...sliced, `[+${value.length - 20} more]`] : sliced;
+    }
+    if (typeof value === "object") {
+        const obj = value;
+        const keys = Object.keys(obj).slice(0, 40);
+        const out = {};
+        for (const k of keys)
+            out[k] = sanitizeForLog(obj[k], depth + 1);
+        if (Object.keys(obj).length > 40)
+            out["__more_keys__"] = Object.keys(obj).length - 40;
+        return out;
+    }
+    try {
+        return String(value);
+    }
+    catch {
+        return "[unserializable]";
+    }
+}
+export function logActivity(type, data) {
+    if (!debugLogEnabled)
+        return;
+    activityLog.push({
+        id: ++activitySeq,
+        ts: new Date().toISOString(),
+        type,
+        project_root: getProjectRoot() || "",
+        data: sanitizeForLog(data),
+    });
+    while (activityLog.length > debugLogMaxEntries)
+        activityLog.shift();
+}
+export function snapshotActivityLog(opts) {
+    const sinceId = Math.max(0, opts.sinceId);
+    const limit = Math.max(1, Math.min(500, opts.limit));
+    const lastId = activitySeq;
+    const events = activityLog.filter((e) => e.id > sinceId).slice(0, limit);
+    return { events, last_id: lastId };
+}
+export function clearActivityLog() {
+    activityLog.length = 0;
+    activitySeq = 0;
+}
+export function summarizeActivityEvent(e) {
+    const d = e.data ?? {};
+    switch (e.type) {
+        case "index_file":
+            return `index ${String(d.file_path ?? "")} reason=${String(d.reason ?? "")} symbols=${String(d.symbols ?? "")} chunks=${String(d.chunks ?? "")}`;
+        case "remove_file":
+            return `remove ${String(d.file_path ?? "")}`;
+        case "pending_flush":
+            return `pending_flush entries=${String(d.entries ?? "")}`;
+        case "pending_prune":
+            return `pending_prune ${String(d.before ?? "")}->${String(d.after ?? "")}`;
+        case "bootstrap_context":
+            return `bootstrap q=${String(d.query ?? "")} pending=${String(d.pending_returned ?? "")}/${String(d.pending_total ?? "")} reqs=${String(d.requirements_returned ?? "")} semantic=${String(d.semantic_mode ?? "")}+${String(d.semantic_matches ?? "")}`;
+        case "get_brain_dump":
+            return `brain_dump pending=${String(d.pending_returned ?? "")}/${String(d.pending_total ?? "")} reqs=${String(d.requirements_returned ?? "")} notes=${String(d.notes_returned ?? "")}`;
+        case "get_pending_changes":
+            return `pending_list returned=${String(d.returned ?? "")} total=${String(d.total ?? "")}`;
+        case "semantic_search":
+            return `semantic_search mode=${String(d.mode ?? "")} q=${String(d.query ?? "")} matches=${String(d.matches ?? "")}`;
+        case "grep":
+            return `grep backend=${String(d.backend ?? "")} q=${String(d.query ?? "")} matches=${String(d.matches ?? "")} truncated=${String(d.truncated ?? "")}`;
+        case "query_codebase":
+            return `query_codebase q=${String(d.query ?? "")} matches=${String(d.matches ?? "")}`;
+        case "read_file_lines":
+            return `read_file_lines file=${String(d.file_path ?? "")} returned=${String(d.returned ?? "")} truncated=${String(d.truncated ?? "")}`;
+        case "read_file_text":
+            return `read_file_text file=${String(d.file_path ?? "")} returned=${String(d.returned_chars ?? "")}/${String(d.total_chars ?? "")} truncated=${String(d.truncated ?? "")}`;
+        case "list_project_files":
+            return `list_project_files path=${String(d.path ?? "")} returned=${String(d.returned ?? "")} scanned=${String(d.scanned ?? "")} truncated=${String(d.truncated ?? "")}`;
+        case "read_codex_text_file":
+            return `read_codex_text_file file=${String(d.file_path ?? "")} returned=${String(d.returned_chars ?? "")}/${String(d.total_chars ?? "")} truncated=${String(d.truncated ?? "")}`;
+        case "start_requirement":
+            return `start_requirement #${String(d.req_id ?? "")} ${String(d.title ?? "")}`;
+        case "sync_change_intent":
+            return `sync_change_intent #${String(d.req_id ?? "")} files=${String(d.files_total ?? "")}`;
+        case "complete_requirement":
+            return `complete_requirement ${String(d.all_active ? "all_active" : d.req_id ?? "")}`;
+        case "memory_maintenance":
+            return `memory_maintenance trigger=${String(d.trigger ?? "")} compacted=${String(d.compacted ?? "")} stale=${String(d.stale_files ?? "")} chunks_deleted=${String(d.chunks_deleted ?? "")}`;
+        default:
+            return e.type;
+    }
+}
+//# sourceMappingURL=activity-log.js.map

package/dist/activity-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-log.js","sourceRoot":"","sources":["../src/activity-log.ts"],"names":[],"mappings":"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"}

package/dist/builtin-conventions.d.ts

@@ -1,6 +1,7 @@
-export type BuiltinConventionSpec = {
+type BuiltinConventionSpec = {
     key: string;
     content: string;
     tags?: string[];
 };
 export declare const BUILTIN_CONVENTIONS: BuiltinConventionSpec[];
+export {};

package/dist/builtin-conventions.js

@@ -5,6 +5,11 @@ export const BUILTIN_CONVENTIONS = [
         content: `${DEVELOPMENT_GUIDELINE_SCOPE} VectorMind 的内置内容用于统一项目协作、代码组织、交付质量和长期记忆。`,
         tags: ["builtin", "development-guideline", "scope"],
     },
+    {
+        key: "builtin:model_autonomy_floor",
+        content: `${DEVELOPMENT_GUIDELINE_SCOPE} VectorMind 工具输出只是上下文证据和质量信号，不得削弱模型自身的推理、决策、创造和实现能力；当工具上下文不完整，或与直接观察到的仓库事实冲突时，应继续检查并使用模型判断。`,
+        tags: ["builtin", "model-autonomy", "advisory-only", "scope"],
+    },
     {
         key: "builtin:branch_write_boundary",
         content: `${DEVELOPMENT_GUIDELINE_SCOPE} 所有代码或文件改动默认在当前活跃分支中进行；禁止创建、切换或使用临时分支、临时子分支，除非用户明确要求或既有工作流已经这样安排。`,

package/dist/builtin-conventions.js.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-conventions.js","sourceRoot":"","sources":["../src/builtin-conventions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"builtin-conventions.js","sourceRoot":"","sources":["../src/builtin-conventions.ts"],"names":[],"mappings":"AAMA,MAAM,2BAA2B,GAC/B,yCAAyC,CAAC;AAE5C,MAAM,CAAC,MAAM,mBAAmB,GAA4B;IAC1D;QACE,GAAG,EAAE,qCAAqC;QAC1C,OAAO,EACL,GAAG,2BAA2B,2CAA2C;QAC3E,IAAI,EAAE,CAAC,SAAS,EAAE,uBAAuB,EAAE,OAAO,CAAC;KACpD;IACD;QACE,GAAG,EAAE,8BAA8B;QACnC,OAAO,EACL,GAAG,2BAA2B,6FAA6F;QAC7H,IAAI,EAAE,CAAC,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,OAAO,CAAC;KAC9D;IACD;QACE,GAAG,EAAE,+BAA+B;QACpC,OAAO,EACL,GAAG,2BAA2B,mEAAmE;QACnG,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,gBAAgB,CAAC;KAC9C;IACD;QACE,GAAG,EAAE,iCAAiC;QACtC,OAAO,EACL,GAAG,2BAA2B,kDAAkD;QAClF,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,CAAC;KACzD;IACD;QACE,GAAG,EAAE,iCAAiC;QACtC,OAAO,EACL,GAAG,2BAA2B,oGAAoG;QACpI,IAAI,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,CAAC;KACzD;IACD;QACE,GAAG,EAAE,qCAAqC;QAC1C,OAAO,EACL,GAAG,2BAA2B,6HAA6H;QAC7J,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC;KAC1C;IACD;QACE,GAAG,EAAE,qCAAqC;QAC1C,OAAO,EACL,GAAG,2BAA2B,kHAAkH;QAClJ,IAAI,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,gBAAgB,CAAC;KAChE;IACD;QACE,GAAG,EAAE,4CAA4C;QACjD,OAAO,EACL,GAAG,2BAA2B,sNAAsN;QACtP,IAAI,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,uBAAuB,EAAE,YAAY,EAAE,WAAW,CAAC;KACtF;IACD;QACE,GAAG,EAAE,yCAAyC;QAC9C,OAAO,EACL,GAAG,2BAA2B,gGAAgG;QAChI,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,CAAC;KAC3D;IACD;QACE,GAAG,EAAE,qCAAqC;QAC1C,OAAO,EACL,GAAG,2BAA2B,4GAA4G;QAC5I,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,CAAC;KACnE;IACD;QACE,GAAG,EAAE,4BAA4B;QACjC,OAAO,EACL,GAAG,2BAA2B,oHAAoH;QACpJ,IAAI,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,CAAC;KAC5D;IACD;QACE,GAAG,EAAE,4CAA4C;QACjD,OAAO,EACL,GAAG,2BAA2B,4HAA4H;QAC5J,IAAI,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,CAAC;KAC9D;IACD;QACE,GAAG,EAAE,sCAAsC;QAC3C,OAAO,EACL,GAAG,2BAA2B,uHAAuH;QACvJ,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,CAAC;KAChE;IACD;QACE,GAAG,EAAE,qCAAqC;QAC1C,OAAO,EACL,GAAG,2BAA2B,6FAA6F;QAC7H,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,CAAC;KACrD;IACD;QACE,GAAG,EAAE,qCAAqC;QAC1C,OAAO,EACL,GAAG,2BAA2B,2FAA2F;QAC3H,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC;KAC9C;IACD;QACE,GAAG,EAAE,sCAAsC;QAC3C,OAAO,EACL,GAAG,2BAA2B,kIAAkI;QAClK,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,CAAC;KAC7D;IACD;QACE,GAAG,EAAE,kCAAkC;QACvC,OAAO,EACL,GAAG,2BAA2B,wKAAwK;QACxM,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,CAAC;KAC1D;IACD;QACE,GAAG,EAAE,sCAAsC;QAC3C,OAAO,EACL,GAAG,2BAA2B,uFAAuF;QACvH,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,OAAO,CAAC;KAC5D;CACF,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,28 @@
+export declare const SERVER_NAME = "vector-mind";
+export declare const SERVER_VERSION = "1.0.52";
+export declare const prettyJsonOutput: boolean;
+export declare const debugLogEnabled: boolean;
+export declare const debugLogMaxEntries: number;
+export declare const PENDING_FLUSH_MS: number;
+export declare const PENDING_TTL_DAYS: number;
+export declare const PENDING_MAX_ENTRIES: number;
+export declare const PENDING_PRUNE_EVERY: number;
+export declare const DEVELOPMENT_WARN_FILE_LINES: number;
+export declare const DEVELOPMENT_BLOCK_FILE_LINES: number;
+export declare const DEVELOPMENT_HUGE_FILE_LINES: number;
+export declare const DEVELOPMENT_WARN_FILE_BYTES: number;
+export declare const DEVELOPMENT_WARN_PENDING_FILES: number;
+export declare const RIPGREP_RESOLVE_TIMEOUT_MS = 5000;
+export declare const RIPGREP_SEARCH_TIMEOUT_MS = 30000;
+export declare const RIPGREP_MAX_BUFFER_BYTES: number;
+export declare const INDEX_MAX_CODE_BYTES: number;
+export declare const INDEX_MAX_DOC_BYTES: number;
+export declare const INDEX_SKIP_MINIFIED: boolean;
+export declare const INDEX_AUTO_PRUNE_IGNORED: boolean;
+export declare const MAINTENANCE_AUTO_ENABLED: boolean;
+export declare const MAINTENANCE_INTERVAL_HOURS: number;
+export declare const MAINTENANCE_COMPACT_AFTER_DAYS: number;
+export declare const MAINTENANCE_MAX_MEMORY_ITEMS: number;
+export declare const MAINTENANCE_MAX_INDEX_FILES: number;
+export declare const ROOTS_LIST_TIMEOUT_MS: number;
+export declare const BOOTSTRAP_SEMANTIC_TIMEOUT_MS: number;

package/dist/config.js

@@ -0,0 +1,189 @@
+export const SERVER_NAME = "vector-mind";
+export const SERVER_VERSION = "1.0.52";
+export const prettyJsonOutput = ["1", "true", "on", "yes"].includes((process.env.VECTORMIND_PRETTY_JSON ?? "").trim().toLowerCase());
+export const debugLogEnabled = ["1", "true", "on", "yes"].includes((process.env.VECTORMIND_DEBUG_LOG ?? "").trim().toLowerCase());
+export const debugLogMaxEntries = (() => {
+    const raw = process.env.VECTORMIND_DEBUG_LOG_MAX?.trim();
+    if (!raw)
+        return 200;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n <= 0)
+        return 200;
+    return Math.min(5000, n);
+})();
+export const PENDING_FLUSH_MS = (() => {
+    const raw = process.env.VECTORMIND_PENDING_FLUSH_MS?.trim();
+    if (!raw)
+        return 200;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 0)
+        return 200;
+    return n;
+})();
+export const PENDING_TTL_DAYS = (() => {
+    const raw = process.env.VECTORMIND_PENDING_TTL_DAYS?.trim();
+    if (!raw)
+        return 30;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 0)
+        return 30;
+    return n;
+})();
+export const PENDING_MAX_ENTRIES = (() => {
+    const raw = process.env.VECTORMIND_PENDING_MAX?.trim();
+    if (!raw)
+        return 5000;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n <= 0)
+        return 5000;
+    return n;
+})();
+export const PENDING_PRUNE_EVERY = (() => {
+    const raw = process.env.VECTORMIND_PENDING_PRUNE_EVERY?.trim();
+    if (!raw)
+        return 500;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n <= 0)
+        return 500;
+    return n;
+})();
+export const DEVELOPMENT_WARN_FILE_LINES = (() => {
+    const raw = process.env.VECTORMIND_WARN_FILE_LINES?.trim();
+    if (!raw)
+        return 800;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 100)
+        return 800;
+    return Math.min(50_000, n);
+})();
+export const DEVELOPMENT_BLOCK_FILE_LINES = (() => {
+    const raw = process.env.VECTORMIND_BLOCK_FILE_LINES?.trim();
+    if (!raw)
+        return 1200;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < DEVELOPMENT_WARN_FILE_LINES)
+        return Math.max(1200, DEVELOPMENT_WARN_FILE_LINES);
+    return Math.min(100_000, n);
+})();
+export const DEVELOPMENT_HUGE_FILE_LINES = (() => {
+    const raw = process.env.VECTORMIND_HUGE_FILE_LINES?.trim();
+    if (!raw)
+        return 3000;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < DEVELOPMENT_BLOCK_FILE_LINES) {
+        return Math.max(3000, DEVELOPMENT_BLOCK_FILE_LINES);
+    }
+    return Math.min(200_000, n);
+})();
+export const DEVELOPMENT_WARN_FILE_BYTES = (() => {
+    const raw = process.env.VECTORMIND_WARN_FILE_BYTES?.trim();
+    if (!raw)
+        return 120_000;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 10_000)
+        return 120_000;
+    return Math.min(20_000_000, n);
+})();
+export const DEVELOPMENT_WARN_PENDING_FILES = (() => {
+    const raw = process.env.VECTORMIND_WARN_PENDING_FILES?.trim();
+    if (!raw)
+        return 12;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 1)
+        return 12;
+    return Math.min(500, n);
+})();
+export const RIPGREP_RESOLVE_TIMEOUT_MS = 5_000;
+export const RIPGREP_SEARCH_TIMEOUT_MS = 30_000;
+export const RIPGREP_MAX_BUFFER_BYTES = 16 * 1024 * 1024;
+export const INDEX_MAX_CODE_BYTES = (() => {
+    const raw = process.env.VECTORMIND_INDEX_MAX_CODE_BYTES?.trim();
+    if (!raw)
+        return 400_000;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n <= 0)
+        return 400_000;
+    return n;
+})();
+export const INDEX_MAX_DOC_BYTES = (() => {
+    const raw = process.env.VECTORMIND_INDEX_MAX_DOC_BYTES?.trim();
+    if (!raw)
+        return 600_000;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n <= 0)
+        return 600_000;
+    return n;
+})();
+export const INDEX_SKIP_MINIFIED = (() => {
+    const raw = (process.env.VECTORMIND_INDEX_SKIP_MINIFIED ?? "").trim().toLowerCase();
+    if (!raw)
+        return true;
+    return ["1", "true", "on", "yes"].includes(raw);
+})();
+export const INDEX_AUTO_PRUNE_IGNORED = (() => {
+    const raw = (process.env.VECTORMIND_INDEX_AUTO_PRUNE_IGNORED ?? "").trim().toLowerCase();
+    if (!raw)
+        return true;
+    return ["1", "true", "on", "yes"].includes(raw);
+})();
+export const MAINTENANCE_AUTO_ENABLED = (() => {
+    const raw = (process.env.VECTORMIND_MAINTENANCE_AUTO ?? "").trim().toLowerCase();
+    if (!raw)
+        return true;
+    return ["1", "true", "on", "yes"].includes(raw);
+})();
+export const MAINTENANCE_INTERVAL_HOURS = (() => {
+    const raw = process.env.VECTORMIND_MAINTENANCE_INTERVAL_HOURS?.trim();
+    if (!raw)
+        return 24;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 1)
+        return 24;
+    return Math.min(24 * 30, n);
+})();
+export const MAINTENANCE_COMPACT_AFTER_DAYS = (() => {
+    const raw = process.env.VECTORMIND_COMPACT_AFTER_DAYS?.trim();
+    if (!raw)
+        return 45;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 1)
+        return 45;
+    return Math.min(3650, n);
+})();
+export const MAINTENANCE_MAX_MEMORY_ITEMS = (() => {
+    const raw = process.env.VECTORMIND_MAINTENANCE_MAX_MEMORY_ITEMS?.trim();
+    if (!raw)
+        return 250;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 1)
+        return 250;
+    return Math.min(5000, n);
+})();
+export const MAINTENANCE_MAX_INDEX_FILES = (() => {
+    const raw = process.env.VECTORMIND_MAINTENANCE_MAX_INDEX_FILES?.trim();
+    if (!raw)
+        return 1500;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 1)
+        return 1500;
+    return Math.min(50_000, n);
+})();
+export const ROOTS_LIST_TIMEOUT_MS = (() => {
+    const raw = process.env.VECTORMIND_ROOTS_TIMEOUT_MS?.trim();
+    if (!raw)
+        return 750;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n <= 0)
+        return 750;
+    return n;
+})();
+export const BOOTSTRAP_SEMANTIC_TIMEOUT_MS = (() => {
+    const raw = process.env.VECTORMIND_SEMANTIC_TIMEOUT_MS?.trim();
+    if (!raw)
+        return 2500;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n <= 0)
+        return 2500;
+    return n;
+})();
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/database-runtime.d.ts

@@ -0,0 +1,54 @@
+import Database from "better-sqlite3";
+import type { ExtractedSymbol } from "./types.js";
+export declare const FTS_TABLE_NAME = "memory_items_fts";
+export type PreparedDatabaseStatements = {
+    insertRequirementStmt: Database.Statement;
+    getActiveRequirementStmt: Database.Statement;
+    listActiveRequirementsStmt: Database.Statement;
+    listRecentRequirementsStmt: Database.Statement;
+    completeAllActiveRequirementsStmt: Database.Statement;
+    completeRequirementByIdStmt: Database.Statement;
+    completeAllActiveRequirementMemoryItemsStmt: Database.Statement;
+    completeRequirementMemoryItemByReqIdStmt: Database.Statement;
+    listChangeLogsForRequirementStmt: Database.Statement;
+    insertChangeLogStmt: Database.Statement;
+    insertMemoryItemStmt: Database.Statement;
+    getMemoryItemByIdStmt: Database.Statement;
+    getRequirementMemoryItemIdStmt: Database.Statement;
+    getConventionByKeyStmt: Database.Statement;
+    insertConventionStmt: Database.Statement;
+    updateConventionByIdStmt: Database.Statement;
+    listConventionsStmt: Database.Statement;
+    upsertDecisionStmt: Database.Statement;
+    getDecisionByKeyStmt: Database.Statement;
+    listCurrentDecisionsStmt: Database.Statement;
+    upsertProjectSummaryStmt: Database.Statement;
+    getProjectSummaryStmt: Database.Statement;
+    getLatestChangeIntentForFileStmt: Database.Statement;
+    deleteFileChunkItemsStmt: Database.Statement;
+    upsertPendingChangeStmt: Database.Statement;
+    listPendingChangesStmt: Database.Statement;
+    countPendingChangesStmt: Database.Statement;
+    deletePendingChangeStmt: Database.Statement;
+    deleteAllPendingChangesStmt: Database.Statement;
+    deleteOldPendingChangesStmt: Database.Statement;
+    deleteOldestPendingChangesStmt: Database.Statement;
+    deleteSymbolsForFileStmt: Database.Statement;
+    upsertSymbolStmt: Database.Statement;
+    searchSymbolsStmt: Database.Statement;
+    insertTokenSavingsStmt: Database.Statement;
+    summarizeTokenSavingsStmt: Database.Statement;
+    summarizeTokenSavingsByToolStmt: Database.Statement;
+    listRecentTokenSavingsStmt: Database.Statement;
+    getKvStmt: Database.Statement;
+    setKvStmt: Database.Statement;
+};
+export type DatabaseRuntime = {
+    db: Database.Database;
+    dbPath: string;
+    ftsAvailable: boolean;
+    ftsTableName: string;
+    indexFileSymbolsTx: ((filePath: string, symbols: ExtractedSymbol[]) => void) | null;
+    statements: PreparedDatabaseStatements;
+};
+export declare function openDatabaseRuntime(projectRoot: string): DatabaseRuntime;