@guanlin4924/devflow-pi 0.1.95 → 0.1.97

package/README.md

@@ -11,7 +11,7 @@ Devflow Pi 是一个面向项目研发交付的独立 OMP 产品入口，内置
 安装与启动：
 
 ```bash
-npm install -g @guanlin4924/devflow-pi@0.1.95
+npm install -g @guanlin4924/devflow-pi@0.1.97
 cd /path/to/your-project
 devflow-pi init
 devflow-pi doctor
@@ -31,6 +31,16 @@ devflow-pi
 /usage-stats
 ```
 
+已有功能可从空闲状态启动回归验收：调用 `devflow_bootstrap` 时使用
+`flow="regression-acceptance"`，随后按“回归测试设计 → 主流程 DSL → 批准 → 验收执行”推进，
+不需要补建功能开发链路。用例冻结时必须明确 `oracle_source`：`requirement` 来自需求，
+`contract` 来自外部接口/权限约定，`invariant` 表示内部一致性，`characterization` 只表示经人确认的现有行为基线。
+后三者都必须附 `oracle_evidence`；`characterization` 不能被表述为正确性证明。
+
+测试环境 profile 的 `secret_env` 只声明变量名。打开 `/devflow control` 的“测试凭据”输入值后，
+凭据仅保存在当前扩展进程的内存中，不写入 `process.env`、文件、日志或审计，也不会被 Agent 子进程继承；
+只有 Core 启动验收执行子进程时才会注入。面板输入没有遮罩能力，输入时值会显示在屏幕上，退出 devflow-pi 后失效。
+
 `/devflow project-init` 会先读取当前项目已有的 `.devflow/planning/PROJECT.md` 与 `.devflow/planning/navigation/INDEX.md`：仅回填仍存在于项目根目录内的已登记前后端路径，删除或越界的历史路径会被忽略。随后可选择复用已有边界、复用边界并重建索引，或手动覆盖。初始化模式使用选择器提供“只读规划（默认）”和“写入初始化”；选择后者并确认，只会创建 Devflow 的 `.devflow/planning/` 与 `.devflow/context/` 初始化产物，不会修改业务源码、依赖或项目配置。
 
 用量统计默认只读取当前项目的隔离会话：`/usage-stats`。需要明确查看历史 OMP 会话时，使用 `/usage-stats omp`，或加筛选条件：`/usage-stats omp --from 2026-08-01 --to 2026-08-10`。历史统计保留真实会话路径，不再把不同项目的长会话文件合并成 `main`；统计只使用 assistant message 的原始 usage，不虚构工具调用成本分摊。
@@ -115,7 +125,7 @@ Devflow 会在输入框上方显示“当前 Feature 交付链路”：它基于
 - 验收失败不会创建另一套人工台账，而是进入 `acceptance-remediation`：诊断 → 修复 → code-index 刷新 → 原冻结 `TC-*` 重跑。
 - CP-4 通过后只进入一个 `workflow-release-closeout` 步骤，统一写入 `.devflow/planning/milestones/current-CLOSEOUT.md` 并更新项目状态、导航和版本记录。
 
-正常使用不需要记忆底层命令：在 Devflow 工作流中按步骤继续即可。需要排查时，可用 `devflow_acceptance_tests` 查看冻结套件，或由工作流调用 `devflow_tdd_evidence` 与 `devflow_run_acceptance_tests` 生成 Core 指定写入的证据；不要手写“已测试”来替代结果文件。本地 hook 拒绝 Agent 文件工具与 shell 访问 `control.db` 及 Devflow 数据目录 `projects/`、拒绝写入 canonical 验收结果文件（Read 类读取工具仍可读取结果文件；shell 命令仅在指向真实控制库路径时才被拒，单纯出现 `control.db` 文本不受影响）。它是误操作防护，不构成对同系统用户恶意进程的安全隔离。
+正常使用不需要记忆底层命令：在 Devflow 工作流中按步骤继续即可。需要排查时，可用 `devflow_acceptance_tests` 查看冻结套件，或由工作流调用 `devflow_tdd_evidence` 与 `devflow_run_acceptance_tests` 生成 Core 指定写入的证据；不要手写“已测试”来替代结果文件。本地 hook 拒绝 Agent 文件工具与 shell 访问 `control.db` 及 Devflow 数据目录 `projects/`、拒绝写入 canonical 验收结果文件，并默认拒绝访问 `.devflow/runs/` 运行工件，仅白名单放行 `result.json`（Read 类读取工具仍可读取 `acceptance-results.json`；trace、截图、网络工件和 `runtime.log` 由用户本地查看）。它是防误用，不构成对同系统用户恶意进程的安全隔离。
 
 ### Core 软门禁模式
 
@@ -151,3 +161,33 @@ npm install -g @guanlin4924/devflow-pi@latest
 - 索引是加速器，不是真相源；过期时回退到 LSP、搜索、源码和测试。
 - 人工 checkpoint 不得在 headless 模式静默通过。
 - semantic correctness 不能靠 prompt 保证，必须由契约、确定性校验、独立审查和可复现测试共同约束。
+## Devflow MCP（阶段 B）
+
+`devflow-pi mcp --client <name>` 通过 stdio 提供四个 feature 级工具：`validate_feature`、`run_feature`、`get_feature_report` 和 `dsl_draft_validate`。Server 只做输入校验、授权、审计和调用包内 Core；不读取或导出 trace、截图等运行工件，也不能确认批准。缺批准的用例仍需在 `/devflow` 面板完成批准。
+
+授权文件位于 `$DEVFLOW_HOME/mcp.json`（默认 `~/.devflow-pi/mcp.json`），例如：
+
+```json
+{
+  "schema_version": 1,
+  "clients": { "claude-code": { "projects": {
+    "/abs/path/to/project": {
+      "features": ["order"],
+      "permissions": ["validate", "run", "report", "dsl_draft"],
+      "environment_profiles": ["local"]
+    }
+  } } }
+}
+```
+
+这里的 `--client` 是声明式身份，用于匹配授权和写入审计，不是密码学认证；stdio 调用方与 Server 是同一台机器上的同一用户。Claude Code 注册：`claude mcp add devflow-acceptance -- devflow-pi mcp --client claude-code`。Codex 在 `config.toml` 中注册：
+
+```toml
+[mcp_servers.devflow-acceptance]
+command = "devflow-pi"
+args = ["mcp", "--client", "codex"]
+```
+
+`run_feature` 是同步调用，默认最多运行 2 小时，可用 `--run-timeout-seconds` 下调；客户端也应把 MCP 请求超时设得足够长，并启用 progress。审计写入 `$DEVFLOW_HOME/mcp-audit/`。批准仍只能在 `/devflow` 面板完成。
+
+Core 在 MCP Server 的进程环境中执行，因此注册 Server 时要把被测环境需要的变量一并传入：HTTP adapter 的基础地址变量（如 `DEVFLOW_TEST_BASE_URL`）和环境 profile 中 `secret_env` 声明的密钥变量；缺失时对应用例会是 failed 或 blocked。`mcp.json` 的 `environment_profiles` 只约束 `devflow_playwright` 绑定引用的 profile；HTTP adapter 的目标地址来自这些环境变量，不受 `mcp.json` 授权约束，应由启动 Server 的人控制。`run_feature` 在有用例未通过时仍返回报告，是否通过以其中的 `gate` 为准。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guanlin4924/devflow-pi",
-  "version": "0.1.95",
+  "version": "0.1.97",
   "type": "module",
   "description": "Devflow 专项研发 Pi，基于固定版本 OMP Runtime 组装研发状态机、代码智能、设计、实现与质量门禁。",
   "license": "UNLICENSED",
@@ -23,6 +23,7 @@
     "node": ">=20"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "1.32.1",
     "@oh-my-pi/pi-coding-agent": "17.2.7",
     "@playwright/test": "1.63.0",
     "@plurnk/plurnk-mimetypes-grammar-cpp": "1.16.1",