@roarpeng/graphflow 0.6.6 → 0.6.15

package/CHANGELOG.md

@@ -4,6 +4,112 @@ All notable changes to this project are documented in this file.
 
 ## [Unreleased]
 
+## [0.6.15] - 2026-06-16
+
+### Added
+
+- MCP server 优雅停机：监听 `SIGTERM`/`SIGINT`，停止接收新的 stdin 输入并给在途请求短暂 flush 窗口后退出，避免长驻进程被硬杀导致状态丢失。
+- `VectorStore.close()`：释放底层 SQLite 句柄，与 `SqliteClient.close()` 对齐，避免长驻进程文件描述符泄漏。
+- MCP 工具入参长度上限（`MAX_STRING_FIELD_LENGTH`），防止超大 payload / prompt injection 风险。
+
+### Changed
+
+- `provider-executor` 改用结构化 `logger` 替换裸 `console.warn/error`，确保生产环境日志可被聚合采集。
+- `orchestrate()` 增加顶层错误边界：上下文构建 / DAG 执行 / 图同步的未捕获异常统一收敛为结构化 `HUMAN_REVIEW_REQUIRED` 结果，不再裸抛给调用方。
+
+### Fixed
+
+- DAG 执行 timeout 定时器在任务成功路径未被清除，长驻进程下存在 timer 泄漏；改为 `finally` 中 `clearTimeout`。
+- `m12-dynamic-routing` 测试不再依赖对 `api.anthropic.com` 的外网可达性：将 anthropic `baseUrl` 指向本地立即拒绝连接的地址，确定性触发非 strict 降级路径。
+
+## [0.6.13] - 2026-06-14
+
+### Fixed
+
+- 知识图谱面板力导向布局在大量节点时坐标爆炸，导致 viewBox 过大、画布仅显示角落小点；布局后归一化到画布并收紧力模拟参数。
+
+## [0.6.12] - 2026-06-14
+
+### Added
+
+- `snapshot-view` 模块：图谱样本的可读标签（`displayLabel`、`displayPath`、`folderGroup`）、分层视图（代码层 / 学习层）、按目录多样性采样。
+- 知识图谱面板：暗色主题、分层 Tab、目录聚类着色、关系线型区分、双击/按钮跳转源文件。
+
+### Changed
+
+- `inspectGraph` 默认样本上限提升至 96 节点 / 160 边；VS Code「查看图谱」命令使用 120 / 200。
+- 节点摘要预览长度由 96 提升至 160 字符。
+
+## [0.6.11] - 2026-06-14
+
+### Changed
+
+- 默认开启 `autoIndexOnSave`：保存/变更文件后 debounce 增量索引，实现项目更新时持续静默建图。
+- 路由就绪校验要求开启 Auto index on file save。
+- 旧配置中遗留的 `maxContextTokens: 400` 自动升级到 1500。
+- `graphflow.config.example.json` 同步 `autoIndexOnSave` 与 `maxContextTokens: 1500`。
+
+## [0.6.10] - 2026-06-14
+
+### Added
+
+- `runtime/` 子模块：`env`、`settings`、`graph`、`routing`、`panel`、`helpers`、`facade`。
+- `GraphFlowRuntimeModule` 与 `assertGraphFlowRuntime()`：扩展动态加载时使用统一类型校验。
+- VS Code 扩展 esbuild 单文件打包（`dist/extension.js`）。
+
+### Changed
+
+- `runtime.ts` 改为薄 re-export 层；业务逻辑拆分到子模块。
+- 扩展移除手写 `GraphFlowRuntime` 接口，改用 core 导出的类型。
+
+## [0.6.9] - 2026-06-14
+
+### Added
+
+- `loadConfigSafe`：损坏/缺失配置文件时回退默认配置并记录告警。
+- `hasPendingGraphIndexWork`：无文件变更时跳过 preview/run 的自动索引。
+- `runtime/types.ts`：CLI/MCP 公共类型集中导出。
+- `vscode-extension/src/workspace.ts`：可测试的工作区 cwd 解析。
+- 测试 `m41-optimization-hardening`。
+
+### Changed
+
+- `postinstall` 默认不再自动 init/MCP 注入；需 `GRAPHFLOW_ENABLE_POSTINSTALL=1` 显式开启。
+- CI 根依赖安装改为 `npm ci`，提升可复现构建。
+- 默认 `maxContextTokens` 从 400 提升到 1500，避免宽查询预览为空。
+- 文件索引器合并 stat 遍历，减少重复 I/O。
+- VSIX `.vscodeignore` 裁剪 vendor 中的 map/d.ts/tests/docs。
+
+### Fixed
+
+- 损坏的全局/项目 JSON 不再导致 GraphFlow 启动失败。
+
+## [0.6.8] - 2026-06-14
+
+### Fixed
+
+- 扩展在无工作区文件夹时也可打开 Settings 并保存全局模型配置；首次安装自动弹出 Settings 面板。
+- `showSetupGuide` 不再因未打开项目而失败；图谱建立/路由测试在无工作区时给出中文提示。
+
+## [0.6.7] - 2026-06-14
+
+### Added
+
+- 全局配置优先：`resolveWritableConfigPath` 默认将 Settings 保存到 `~/.graphflow.config.json`。
+- MCP 安装范围：`installScope: "user" | "all"`，默认仅写入用户级 Agent 配置（如 `~/.cursor/mcp.json`）。
+- 测试 `m40-config-global-first`：覆盖全局读取/写入与 MCP 用户级默认行为。
+
+### Changed
+
+- 扩展首次安装只 scaffold 全局 `~/.graphflow.config.json`，不再自动创建 `.graphflow/config.json` 工作区覆盖层。
+- `resolveConfig` 以全局配置为底，项目 `graphflow.config.json` / `.graphflow/config.json` 作为可选覆盖层合并。
+- `npm postinstall` / `graphflow init` 改为全局配置 + 用户级 MCP；README 说明更新为一次配置、所有项目可用。
+- 配置指南（`formatModelConfigGuide`）优先展示全局配置路径。
+
+### Fixed
+
+- `saveGraphFlowSettings` 补全 `resolveGlobalConfigPath` 导入，修复扩展打包 TypeScript 编译错误。
+
 ## [0.6.6] - 2026-06-11
 
 ### Added