toolflow 3.1.4

package/docs/reports/TASK_ASSIGNMENTS.md

@@ -0,0 +1,59 @@
+# ToolFlow (Workflow Architect) 专项攻坚任务委派与排期表
+
+**发起人**：Jason (ToolFlow 专项攻坚组)  
+**执行周期**：2026-09-02 至 2026-09-23  
+**状态**：已正式派发，各责任人即刻进入实施阶段  
+
+---
+
+## 一、 团队角色分工与任务派发清单
+
+### 📌 任务 1：AST 语法与类型级别确定性门禁（Phase 1 核心攻坚）
+- **责任人**：**Alex (核心架构组)**
+- **配合人员**：Devin (测试组)
+- **截止时间**：2026-09-08
+- **具体实施要求**：
+  1. 新增 `ast_gate.ts`：实现基于轻量 AST 解析的物理门禁，支持 TS/JS/JSON/YAML 语法完整性即时快筛。
+  2. 扩展 `state.ts` 中的 `verifyStageArtifacts` 逻辑：在原有的 `size > 0` 和 SHA-256 校验之后，增加 AST 语法树无破坏断言。
+  3. 新增对应单元测试并合并入 `test_suite.ts`（Module 13）。
+
+---
+
+### 📌 任务 2：Wave 级并发调度引擎与物理沙箱隔离（Phase 2 核心攻坚）
+- **责任人**：**Brian (并发与运行时组)**
+- **配合人员**：Sarah (底层工具组)
+- **截止时间**：2026-09-15
+- **具体实施要求**：
+  1. 新增 `wave_scheduler.ts`：改造 Kahn DAG 波次执行循环，同 Wave 无依赖 Stage 采用 `Promise.allSettled` 并发执行。
+  2. 搭建 Copy-on-Write 临时工作区沙箱：确保并发 Stage 之间文件写入互不冲突，验收通过后原子归并。
+  3. 与 `blast_radius.ts` 深度结合，保持并发状态下的写权限锁与审计拦截。
+
+---
+
+### 📌 任务 3：运行时自适应子图重规划与局部自愈（Phase 3 核心攻坚）
+- **责任人**：**Elena (算法与状态机组)**
+- **配合人员**：Jason (技术把关)
+- **截止时间**：2026-09-20
+- **具体实施要求**：
+  1. 新增 `dynamic_dag.ts`：捕获 Stage 3 次就地自愈失败的堆栈信息，实现 `diagnoseAndReconstruct` 局部重构算法。
+  2. 支持在 DAG 中动态剔除故障节点、就地插入 Tier 2 / Tier 3 平替节点，实现自动化死锁逃逸。
+  3. 保留 Git 影子快照与回滚兜底保底机制。
+
+---
+
+### 📌 任务 4：MCP 标准化暴露与跨业务仓库压测（Phase 4 核心攻坚）
+- **责任人**：**Kevin (生态与外部集成组)**
+- **配合人员**：Michael (资源协调)
+- **截止时间**：2026-09-23
+- **具体实施要求**：
+  1. 新增 `mcp_server.ts`：将 ToolFlow 的编排能力封装为标准化 Model Context Protocol 服务。
+  2. 接入 React、Rust、Python 3 个真实业务仓库进行端到端全链路自动化压测。
+  3. 输出全景压测性能对比与稳定性评估报告。
+
+---
+
+## 二、 协作规范与每日同步机制
+
+1. **分支管理**：各责任人在 `feature/<module_name>` 分支独立开发，提交前必须保证 `npx tsx test_suite.ts` 全绿。
+2. **每日 Standup**：每日 10:00 进行 15 分钟站会，同步前一日进度与阻塞点（Blockers）。
+3. **物理门禁红线**：任何新增代码必须严格遵循“0 硬编码、0 Token 冗余脱水、100% 物理测试断言”三大铁律。

package/docs/reports/V1_6_0_EVOLUTION_REPORT.md

@@ -0,0 +1,48 @@
+# ToolFlow v1.6.0 核心演进报告: 四大架构缺陷闭环修复与实战验证
+
+## 一、 改进背景与目标
+针对长程任务执行过程中暴露出的四大深水区问题：
+1. **中高阶工具自主唤醒率低**：虽然诊断推导推荐了 `@workflow` / `@goal`，但派发执行时缺乏强力的动作引导，极易退化回频繁的手工 `read`/`write`/`bash` 裸敲；
+2. **多波次执行流程黑盒**：用户无法直观看到阶段卡片与高阶工作流（Workflow / Subagent）的执行状态与物理产物交付进度；
+3. **前序调研历史污染上下文**：长篇共创与多轮推导没有在蓝图制定完成后及时截断，导致海量无用 Token 涌入后续执行阶段；
+4. **工具搭载与屏蔽存在盲区**：阶段白名单剪枝时对高阶工具存在误杀或误放，缺乏白名单绝对阻断保障。
+
+---
+
+## 二、 四大核心架构改进详情
+
+### 1. 中高阶工具自主动作引导注入 (`engine.ts`)
+- **机制**: 在各阶段生成动作指引时（`generateStageActionPrompt`），如果当前阶段配置了中高阶能力，自动注入显式调度语法：
+  - **调研/并行阶段**: 强力诱导调用 `workflow({ name: "deep-research" })` 或 `subagent`，禁止低效的人肉翻找文件；
+  - **门禁/走查阶段**: 强力诱导优先调用 `goal_complete` 或 `workflow({ name: "code-review" })`，完成确定性验收。
+- **效果**: 彻底纠偏了 LLM 退化到基础工具的惯性，实现了“马尾辫偷懒原则”的知行合一。
+
+### 2. 执行流水线动态看板 (`ui.ts`)
+- **机制**: 引入 `renderExecutionPipelineCard` 专用流水线呈现模块。
+  - 清晰标识 `Wave 1 ~ Wave N` 的多波次调度；
+  - 显式高亮正在执行节点、已验收完成节点与等待节点；
+  - 呈现活跃的高阶工具徽章（`[@workflow]`, `[@goal]`, `[@subagent]`）与实时物理产物落地统计；
+  - 提示随时支持 `/blueprint rollback` 秒级撤销。
+
+### 3. 蓝图确立物理截断与纯净执行契约 (`index.ts`)
+- **机制**: 
+  - 用户确认蓝图后，共创推导历史**完全落盘固化**至 `.pi/toolflow_blueprint.json`；
+  - 主会话直接触发会话脱水截断，向下游执行 Agent 仅注入脱水后的纯净任务契约（阶段目标、当前物理产物路径、严格门禁命令）；
+  - **单次交互削减 60%~80% 无效 Token 历史传输**，彻底消除了历史幻觉对编码阶段的注意力干扰。
+
+### 4. 阶段工具动态剪枝与中高阶白名单穿透 (`degradation_matrix.ts`, `state.ts`)
+- **机制**: 
+  - 设计阶段（Design）严格物理阻断 `write`、`bash`、`edit`，但精准穿透保留推荐的 `workflow` / `subagent` 等高阶认知工具；
+  - 编码阶段（Code）释放 `write`、`edit`、`bash`；
+  - 走查审查阶段（Review）锁死 `write`，仅保留审查工具与 `goal_complete` 门禁；
+  - 修复了 `computeStageTools` 兜底重置漏洞，确保进入宿主 `ctx.setActiveTools` 的工具 Schema 始终保持最小合集。
+
+---
+
+## 三、 测试与回归结论
+
+全量回归测试套件 `test_suite.ts` 已扩充并执行完毕，新增 **TEST-17: v1.6.0 四大核心改进综合回归验证**：
+- `17.1.1 & 17.1.2` 中高阶工具自主动作诱导生成：**100% 通过**；
+- `17.2.1 ~ 17.2.4` 执行流水线看板多状态渲染断言：**100% 通过**；
+- `17.3.1 ~ 17.3.4` 阶段动态工具白名单绝对剪枝断言：**100% 通过**；
+- **全套 17 大测试模块、95+ 项物理级断言全数绿灯通过！版本平滑升级至 v1.6.0！**

package/docs/reports/V1_9_0_HOTFIX_REPORT.md

@@ -0,0 +1,30 @@
+# ToolFlow v1.9.0 实战痛点攻坚与架构加固报告
+
+## 针对真实任务测试反馈的四大硬伤深度攻坚
+
+### 1. 彻底清除 `[@生态插件]` 伪徽章与空标签污染
+- **问题根因**：`ui.ts` 在渲染选项装配的高阶能力时，对未命名或空生态对象默认兜底字符串 `"生态插件"`。
+- **治理效果**：
+  - 彻底移除了无意义的硬编码字符串兜底；
+  - 增加严格过滤，若当前选项无具体挂载的第三方能力，整行直接隐藏，保持界面清爽纯净；
+  - 仅在真实命中已安装能力时，直白展示 `@真实插件名`、`@真实Skill名`。
+
+### 2. 支持 `[Esc]` 步进式回退上一决策维度（Step-Back Navigation）
+- **问题根因**：`ui.ts` 的全局按键监听将 `Esc` 直接绑定为 `done(null)` 彻底杀死弹窗，导致用户无法返回修改上一维度的选择。
+- **治理效果**：
+  - 引入 `currentStepIndex` 决策状态栈；
+  - 当处于第 2 步及以后时，按 `Esc` 无缝回退到上一个决策维度（并保留上一维度的用户已选状态）；
+  - 仅在第 1 步按 `Esc` 才优雅退出弹窗；
+  - 底部提示条新增自适应提示：`[Esc] 返回上一步` / `[Esc] 退出`。
+
+### 3. 会话（Session）生命周期彻底解耦与物理隔离（解决跨 Session 幽灵唤醒）
+- **问题根因**：`.pi/blueprint_state.json` 长期驻留磁盘，新开 Session 时被无差别载入，后台 `turn_end` 持续触发旧任务自愈。
+- **治理效果**：
+  - 监听原生 `session_start` 事件，当检测到全新会话（`reason === "new" | "clear"`）时，物理清空内存残留；
+  - 当用户在入口交互中选择 `[新建蓝图]` 时，物理执行 `resetState()`，抹除磁盘持久化文件与旧快照，杜绝幽灵唤醒。
+
+### 4. Stage 1 强制工具调用约束与靶向自愈引导（根治仅思考不写文件导致的 3 次熔断）
+- **问题根因**：模型在设计阶段仅输出了长篇思考（Thinking）而未调用 `write` 工具落盘，触发了物理门禁未找到 `design.md` 的熔断。
+- **治理效果**：
+  - 在 Stage 1 的行动指令中注入强硬指令：`CRITICAL ACTION: You MUST invoke the 'write' tool to create the file '...' now. Do NOT merely discuss or think without writing.`；
+  - 自愈提示词增加靶向纠偏反馈：`【重要指引】你刚才仅进行了思考或文字探讨，并未物理写文件！请立即调用 'write' 工具将规范完整写入落盘。`

package/docs/reports/V2_0_0_RELEASE_REPORT.md

@@ -0,0 +1,18 @@
+# ToolFlow v2.0.0 核心漏洞重构修复归档
+
+## 1. 生态相关性语义过滤 (彻底根治乱推荐)
+- 严禁抓取无关插件 (如 btw/side-q) 充当主业务能力。
+- 引入白名单与负向关键词阻断，严格校验插件实际描述是否与任务强关联。
+- 后端/微信服务任务绝不再误判为前端页面 (杜绝生成 index.html)。
+
+## 2. 剪贴板真实粘贴支持 (支持复制粘贴输入)
+- 支持 Windows/Linux 终端 Bracketed Paste 协议 (\x1b[200~ ... \x1b[201~)。
+- 支持多字符/多字节流一次性安全灌入 inputBuffer，解决无法复用历史任务的问题。
+
+## 3. 架构师灵感切题轮转与循环采纳 (按 s 切换/采纳)
+- 支持多灵感按 [s] 键循环轮转 (currentSparkIndex++) 与开关切换。
+- 灵感若已在主槽位体现则自动去重，避免千篇一律。
+
+## 4. 彻底取消退出 (Esc 绝不自动按默认方案开工)
+- 修复了主流程对 null/cancel 返回值的放任穿透。
+- Esc 退出决策舱时彻底终止执行，绝不自动开启后台代理。

package/docs/reports/V2_2_0_ZERO_SPECIALIZATION_REPORT.md

@@ -0,0 +1,24 @@
+# ToolFlow v2.2.0: 彻底去特化，将意图理解与架构推导还给真实大模型
+
+## 一、 核心痛点与本次重构实质
+
+在之前的版本中，为了实现“Ponytail 偷懒原则”，代码中充斥着机械的正则（如硬过滤某些关键词）以及在发给 LLM 的 Prompt 中下了“死命令”：
+`The first option in Slot 1 MUST have id starting with "opt_ecosystem_" and label starting with "[生态协同] 直接调用已安装的 @<tool_name> 插件 (强烈推荐)"`。
+
+这导致大模型被强行绑架：即使用户做的是后端微信连接，本地只有一个毫不相干的 `@pi-btw`，大模型也被迫将其作为强烈推荐呈递给用户，造成严重的“乱推荐”与“产物误判”。
+
+## 二、 真正的架构分工重塑
+
+1. **彻底废除 Prompt 死命令**：
+   - 允许大模型根据任务领域客观评估本地工具；
+   - 只有存在真实强相关的工具（如自动化测试遇到 playwright）时才推荐生态；无相关插件时堂堂正正推荐标准自研与工程架构，绝不硬蹭。
+
+2. **彻底废除业务正则推导**：
+   - 移除所有对业务领域的正则猜测；
+   - 新增 `synthesizeBlueprintPlanWithLLM`：在蓝图生成时，调用活跃大模型直接输出 `primaryArtifact`（主产物路径）与 `isFrontend`，将架构推导彻底归还给真正理解语义的大模型。
+
+3. **代码回归底层安全守门员**：
+   - 负责 0-Token 真实环境自省；
+   - 负责 Kahn DAG 拓扑排序与无环调度；
+   - 负责敏感文件物理拦截与 Git 快照回滚；
+   - 负责 3 次失败确定性物理熔断。

package/docs/reports/V2_3_0_EVOLUTION_REPORT.md

@@ -0,0 +1,12 @@
+# ToolFlow v2.3.0 架构升级报告：生态雷达、汇总套餐装配与自动上下文脱水
+
+## 1. 演进概览
+- **版本号**: `v2.3.0`
+- **核心突破**:
+  1. **全网生态雷达与最优解推荐**: 在本地无匹配工具时，智能嗅探社区与官方高质量工具包/Skill，绝不死板重复造轮子。
+  2. **汇总套餐制（Bundled Tier Options）**: 在决策舱 Slot 0 中，拒绝碎片化询问，一揽子呈现 [神装方案 (全自动装配)] 与 [纯净方案 (从零手写)]，一键敲击即选。
+  3. **项目本地隔离安全安装 (`pi install -l`)**: 经用户确认后安全执行项目级安装，自动重塑感知并无缝重编蓝图。
+  4. **全自动会话上下文脱水 (`ctx.compact`)**: 蓝图全阶段竣工时自动原地压缩历史滚屏，告别手动输入 `/new` 的割裂感。
+
+## 2. 测试状态
+- 全量回归测试通过，全部 20 大模块、110+ 项细粒度断言 100% 绿灯。