patchwarden 1.5.1 → 1.6.2

package/docs/control-center/control-center-phase2.md

@@ -1,159 +0,0 @@
-# PatchWarden Control Center Phase 2
-
-> v0.6.3 在 v0.6.2 MVP 基础上增强任务、工作区、Direct session 和日志体验。
-> 不重构架构，不合并 Core/Direct MCP，不改现有 MCP 工具注册逻辑。
-> 不发布 npm，不打 git tag。
-
-## 概述
-
-Phase 2 完全在 Control Center HTTP 层增强，未触动 MCP 工具注册、watcher 核心循环或
-Direct session 写入逻辑。新增的 API 全部沿用既有 token 校验、路径围栏和脱敏机制。
-
-- **Stale Task 管理**：4 条规则识别僵死任务，reconcile 只标注不删除
-- **task-detail 增强**：变更文件、验证摘要、警告/错误、stale 横幅 + 4 个动作按钮
-- **工作区按需 git 状态**：仅在用户点击时对单个 repo 执行 `git status --short`
-- **Direct Sessions 页面**：浏览 `.patchwarden/direct-sessions` 下的会话产物
-- **Logs 页面**：core/direct/watcher/control-center 四类日志，支持 tail 100/300/1000
-
-## 启动方式
-
-启动方式与 MVP 完全一致，无新增入口：
-
-```powershell
-.\PatchWarden-Control.cmd
-# 或
-npm.cmd run build
-npm.cmd run start:control
-```
-
-启动后访问 `http://127.0.0.1:8090`，左侧导航新增「Direct 会话」和「日志」两项。
-
-## 改动文件
-
-| 文件 | 改动 |
-| --- | --- |
-| `src/version.ts` | `PATCHWARDEN_VERSION` 0.6.2 → 0.6.3 |
-| `package.json` | `version` 0.6.2 → 0.6.3 |
-| `src/controlCenter.ts` | 新增 stale/reconcile/task-detail 增强/workspace repo status/direct sessions/logs 分类等 API |
-| `ui/pages/dashboard.html` | 侧边栏新增 Direct 会话 + 日志导航 |
-| `ui/pages/tasks.html` | 侧边栏新增 Direct 会话 + 日志导航 |
-| `ui/pages/task-detail.html` | 新增变更文件卡、验证摘要卡、警告/错误卡、stale 横幅、Refresh/Copy task_id/Open folder/Run audit/Reconcile 按钮 |
-| `ui/pages/workspace.html` | 每个 repo 新增「检查」按钮，按需调用 `/api/workspace/:repo/status`，渲染 git 状态面板 |
-| `ui/pages/audit.html` | 侧边栏新增 Direct 会话 + 日志导航 |
-| `ui/pages/direct-sessions.html` | 新页面：会话列表 + 会话详情（summary.md / audit.md / audit.json / diff.patch / changed-files.json） |
-| `ui/pages/logs.html` | 新页面：分类选择 + tail 选择 + 自动刷新开关 |
-| `scripts/checks/control-center-smoke.js` | 新增 Test 11–15 覆盖 Phase 2 API |
-| `docs/control-center/control-center-phase2.md` | 本文档 |
-
-## 新增 API
-
-### GET 接口（免 token）
-
-| 路径 | 说明 |
-| --- | --- |
-| `GET /api/tasks/stale` | 返回当前判定为 stale 的任务列表（含 stale_reasons） |
-| `GET /api/tasks/:taskId` | 增强详情：新增 `changed_files`、`file_stats`、`verification_summary`、`warnings`、`errors`、`stale`、`reconcile`、`task_dir`、`independent_review`、`verify_log` |
-| `GET /api/workspace/:repo/status` | 对单个 repo 执行 `git status --short`，返回 changed_files_count/untracked_count/modified_count/is_clean/short_status |
-| `GET /api/direct-sessions` | 列出 `.patchwarden/direct-sessions` 下所有会话摘要 |
-| `GET /api/direct-sessions/:sessionId` | 返回会话详情：summary/session/summary_md/diff_patch/audit_json/audit_md/changed_files |
-| `GET /api/logs/:category?tail=<100\|300\|1000>` | 四类日志（core/direct/watcher/control-center），支持 tail 行数 |
-
-### POST 接口（必须校验 token）
-
-| 路径 | 说明 |
-| --- | --- |
-| `POST /api/tasks/:taskId/reconcile` | 标注 stale/archived，写入 `reconcile.json`，不删除任务 |
-| `POST /api/tasks/:taskId/audit` | 仅当任务处于终态时委托 `auditTask` 运行独立审计 |
-| `POST /api/tasks/:taskId/open-folder` | 通过系统命令打开任务目录 |
-
-## Stale Task 判定规则
-
-`classifyStaleTask` 仅对 `pending` / `running` 状态任务判定（终态任务直接返回非 stale）。
-判定使用 `config.watcherStaleSeconds` 作为阈值，4 条规则任一命中即标记 stale：
-
-| 规则 | 字段值 | 说明 |
-| --- | --- | --- |
-| `heartbeat_stale` | status=running 且 last_heartbeat_at 超过阈值 | 运行中但心跳长时间未更新 |
-| `collecting_artifacts_stale` | phase=collecting_artifacts 且心跳超过阈值 | 卡在产物收集阶段 |
-| `running_no_command_watcher_healthy` | status=running 且 current_command 为空且 watcher healthy | 运行中无命令但 watcher 在工作，疑似僵死 |
-| `heartbeat_far_behind_watcher` | 任务心跳比 watcher 心跳早 2× 阈值以上且 watcher healthy | 任务明显落后于 watcher |
-
-`/api/status` 和 `/api/tasks` 返回的任务对象均带 `is_stale: boolean` 和
-`stale_reasons: string[]`。`/api/status.tasks` 还聚合了 `stale` 计数和
-`stale_task_ids` 列表。
-
-## Reconcile 行为
-
-`POST /api/tasks/:taskId/reconcile` 的安全契约：
-
-- **不删除任务**，不修改 `status` 枚举值
-- 读取 `status.json` / `runtime.json` 重建 `TaskEntry`，重新调用 `classifyStaleTask`
-- 决策（`decision` 字段）：
-  - `marked_archived`：任务已处于终态 → 标注归档
-  - `marked_stale`：stale 且 watcher 未在驱动（无 current_command 或 watcher 非 healthy）→ 标注僵死
-  - `no_action`：不满足上述条件 → 仅记录，不标注
-- 写入 `tasks/<taskId>/reconcile.json`（完整决策记录）
-- 仅当 `safe=true` 时，在 `status.json` 追加 `reconcile_state`（`"stale"` 或 `"archived"`）和 `reconciled_at`，**原 status 字段保持不变**
-- 返回 reconcile 记录 JSON
-
-## 路径围栏（workspace repo status）
-
-`GET /api/workspace/:repo/status` 的安全约束：
-
-- `repo` 参数经 `decodeURIComponent` 后若包含 `..` 或 `\0` → 直接 400
-- 通过 `guardWorkspacePath(repo, workspaceRoot)` 解析为绝对路径，任何逃逸 `workspaceRoot` 的路径 → 400
-- 仅对解析后的目录执行 `git status --short`，超时 8 秒，maxBuffer 1MB
-- 非 git 仓库或 git 不可用时返回 200 + `is_git_repo: false` + error 字段，不返回 500
-- smoke test 用 `encodeURIComponent("../secret")` 验证穿越被拒（400）
-
-## Direct Sessions 数据来源
-
-- 会话目录：`getDirectSessionsDir(config)` → `<runtime>/.patchwarden/direct-sessions/`
-- 每个会话子目录读取：`session.json`、`summary.json`、`audit.json`、`summary.md`、`diff.patch`、`audit.md`、`changed-files.json`
-- `DirectSessionSummary` 字段：`session_id`、`repo_path`、`resolved_repo_path`、`created_at`、`expires_at`、`finalized`、`finalized_at`、`audited`、`changed_files_total`、`verification_summary`、`audit_decision`、`audit_checked_at`、`title`
-- 目录不存在时返回 `{ sessions: [], total: 0, reason: null }`，**不返回 500**
-- 会话按 `created_at` 降序排列
-
-## 日志脱敏
-
-- 所有 `/api/logs/:category` 响应均经 `redactSensitiveContent` 脱敏
-- tail 行数限制在 `ALLOWED_LOG_TAILS = {100, 300, 1000}`，非法值回退到 100
-- 日志文件缺失时返回 `{ stdout: "", stderr: "", reason: "log file not found" }`
-
-## 冒烟测试
-
-`scripts/checks/control-center-smoke.js` 在原 10 项基础上新增 5 项（共 16 项）：
-
-| # | 测试 |
-| --- | --- |
-| 11 | `GET /api/tasks/stale` 返回有效 JSON（`stale_tasks` 数组、`total` 数字、`stale_threshold_seconds` 数字） |
-| 12 | `GET /api/workspace/<traversal>/status` 被拒绝（400，error 含 "traversal"） |
-| 13 | `POST /api/tasks/:taskId/reconcile` 无 token → 403 |
-| 14 | `GET /api/direct-sessions` 目录缺失时返回空列表（200，非 500） |
-| 15 | `GET /api/logs/core?tail=300` 响应包含 `tail: 300` |
-
-## 测试结果
-
-```
-npm.cmd run build         # tsc 编译通过
-node scripts/checks/control-center-smoke.js
-  # Summary: 16 passed, 0 failed
-```
-
-全量 `npm test` 链路（security 139 + unit 136 + lifecycle 22 + control-center 16）
-全部通过，0 失败。
-
-> 注：在 TRAE IDE 沙盒内运行 `npm test` 时，control-center-smoke spawn 的子进程退出
-> 后 Windows 会尝试更新 jump list 临时文件，被沙盒拒绝并打印
-> "TRAE Sandbox Error: hit restricted …CustomDestinations…"。该错误与测试逻辑无关，
-> 所有测试用例均报告 PASS。直接运行 `node scripts/checks/control-center-smoke.js` 退出码为 0。
-
-## 已知限制
-
-- `/api/workspace/:repo/status` 仅运行 `git status --short`，不返回 diff 或 stash 信息
-- reconcile 不会清理任务文件，需人工后续处理或由 watcher 在下个周期自然覆盖
-- `/api/tasks/:taskId/audit` 仅在任务处于终态（done/failed/failed_verification/
-  failed_scope_violation/failed_policy_violation/canceled/timeout）时才执行，否则返回 409
-- Direct Sessions 页面只读，不提供 finalize 或 audit 触发入口（这些操作仍需通过 MCP 工具完成）
-- Logs 页面的自动刷新间隔固定为 5 秒，不读取 watcher 实时事件
-- task-detail 的「Open task folder」按钮通过 `explorer.exe` / `open` / `xdg-open` 打开，需要本地图形环境

package/docs/execution-plan-2026-07-09.md

@@ -1,315 +0,0 @@
-# PatchWarden Execution Plan 2026-07-09
-
-> Created: 2026-07-09
-> Base document: `docs/roadmap-execution-and-acceptance.md`
-> Scope: 基于 2026-07-09 实地核验后的细化执行计划，覆盖 P0–P3 全阶段。
-> Codex 负责实现与门禁验证；用户负责 credentialed / external-write 操作（push、merge、release、publish）。
-
-## 0. 当前真实状态核验（对 roadmap 文档的修正）
-
-| 项目 | roadmap 假设 | 2026-07-09 实地核验 | 影响 |
-| --- | --- | --- | --- |
-| 分支 | `codex/patchwarden-v1.5.0` | 一致 | — |
-| HEAD | `cc27e6a Add OSS application evidence materials` | 一致 | — |
-| 工作区 | dirty，preserve user changes | 34 个 M + 5 个 ??，含 `package.json`、`version.ts`、`src/tools/*`、`ui/pages/*`、4 个新增 docs | P0 前必须逐文件核对并提交 |
-| 本地源码版本 | 1.5.1 | `package.json` = 1.5.1，CHANGELOG v1.5.1 主题为 Dashboard UI 优化 | 一致 |
-| GitHub Release / npm | 仍为 v1.5.0 | 未重新核验（roadmap 已记录） | P0 任务成立 |
-| Evidence Pack 现状 | 仅 `evidence.json` + `EVIDENCE.md` | `src/tools/evidencePack.ts` 确认只写这两个文件 | P1 v2 差距成立 |
-| 已有 docs | 部分缺失 | `lineage-evidence-pack-workflow.md`、`threat-model.md` 已存在（未跟踪）；缺 `why-patchwarden.md`、`evidence-pack-schema.md`、`spec-kit-integration.md`、`agentseal-integration.md`、`mcp-inspector-testing.md`、`opencode-worker.md`、`openhands-worker.md` | P1 docs 任务成立 |
-
-**关键修正**：roadmap P0 假设"本地源码已就绪，只需发布"。实地发现工作区有大量未提交修改（看起来是 v1.5.1 Dashboard UI 优化的实现）。因此新增 **P0-0 前置步骤：逐文件核对并提交工作区修改**。
-
-## 1. 用户决策记录（2026-07-09）
-
-1. 工作区 34 个 M + 5 个 ?? 文件：**逐文件核对**后决定纳入范围。
-2. P0 发布的 credentialed / external-write 操作（push、merge、release、publish）：**用户手动执行**。Codex 只负责本地门禁与分支准备。
-3. 本计划：**写入 docs 文件存档**，便于后续按阶段跟踪。
-
-## 2. P0：v1.5.1 可信发布
-
-### P0-0 前置：逐文件核对并提交工作区修改（新增）
-
-#### 核对结果（2026-07-09 完成）
-
-实际工作区：**41 个 M + 9 个 ??**（非最初预估的 34+5）。
-
-**版本号一致性**：`package.json` / `version.ts` / `CHANGELOG.md` 三处均为 1.5.1 ✅；`README.md` 第 11 行 / `README.en.md` 第 11 行仍为 v1.5.0 ❌（发布前必修）。
-
-**分类汇总**：
-
-| 分类 | 文件数 | 判定 |
-| --- | --- | --- |
-| Dashboard UI 优化本体 | 9 M + 4 ?? | 属于 v1.5.1 |
-| async 重构链（sync→async） | 16 M | **隐性依赖**：controlCenter.ts v1.5.1 端点 `await safeFinalizeDirectSession(...)` 依赖此链，技术上不可简单拆分 |
-| 并发任务执行特性（maxConcurrentTasks） | 8 M | 独立新特性，CHANGELOG 未提及，可拆为下一版本 |
-| 安全加固 / Bug 修复 | 4 M | 独立，建议纳入（含二进制检测窗口 8KB→1MB、Windows fs.rmSync 修复） |
-| 用户本地配置（AGENTS.md Codex Memory） | 1 M | 含本机绝对路径 `D:\ai_agent\CodexMemory`，不应入库 |
-| IDE 状态 / 发布产物 | 3 ?? | `.trae/`、`patchwarden-v1.1.0-SHA256SUMS.txt`、`patchwarden-v1.5.0-SHA256SUMS.txt` → 加入 `.gitignore` |
-| 规划文档 | 2 ?? | `docs/roadmap-execution-and-acceptance.md`、`docs/execution-plan-2026-07-09.md` → 是否入库由用户决定 |
-
-**Dashboard UI 本体（9 M）**：`CHANGELOG.md`、`package.json`、`version.ts`、`scripts/checks/control-center-smoke.js`、`ui/pages/audit.html`、`ui/pages/dashboard.html`、`ui/pages/direct-sessions.html`、`ui/pages/task-detail.html`、`ui/pages/tasks.html`
-
-**Dashboard docs（4 ??）**：`docs/dashboard-overview.md`、`docs/direct-session-workflow.md`、`docs/lineage-evidence-pack-workflow.md`、`docs/task-safe-review-workflow.md`（均被 README 新章节链接引用）
-
-**async 重构链（16 M）**：`changeCapture.ts`、`runTask.ts`、`agentAssessor.ts`、`assessmentStore.ts`、`confirmCli.ts`、`createTask.ts`、`createDirectSession.ts`、`finalizeDirectSession.ts`、`goalSubgoalTask.ts`、`retryTask.ts`、`safeViews.ts`、`registry.ts`、`runTaskLoop.ts`、`smoke-test.ts`、`scripts/checks/lifecycle-smoke.js`、`src/test/unit/goal-subgoal-task.test.ts`
-
-**并发任务执行特性（8 M）**：`config.ts`（新增 maxConcurrentTasks）、`watch.ts`（跨进程 lockfile + 并发执行 + executed-tasks.json）、6 个 unit test（command-guard / diagnose-task / reconcile-tasks / safe-status / sync-file / watcher-status，各加 1 行满足新必填字段）
-
-**安全加固（4 M）**：`directGuards.ts`、`postTaskCleanup.ts`、`direct-guards.test.ts`、`path-guard.test.ts`
-
-#### 关键风险
-
-1. **async 重构是 v1.5.1 隐性依赖**：controlCenter.ts 的 v1.5.1 端点调用 async 函数，若排除 async 链则需回退这些端点，否则编译/运行断裂。
-2. **README 版本号漏改**：第 11 行必须从 v1.5.0 改为 v1.5.1。
-3. **AGENTS.md 含本机绝对路径**：`D:\ai_agent\CodexMemory` 不应入库。
-4. **.gitignore 需扩充**：新增 `.trae/` 与 `patchwarden-v*-SHA256SUMS.txt` 通配规则。
-
-#### 范围决策（待用户确定）
-
-- 方案 A（推荐）：v1.5.1 = Dashboard UI(9) + async 重构链(16) + 安全加固(4) + 4 docs + 版本号修正；并发特性(8) 拆为 v1.5.2/v1.6.0；CHANGELOG 补 async 与安全修复说明。
-- 方案 B：回退 controlCenter.ts 中依赖 async 的端点，只发纯 Dashboard UI。
-- 方案 C：全部纳入（含并发特性），CHANGELOG 补全说明。
-
-### P0-1 本地全套门禁
-
-```powershell
-npm.cmd ci
-npm.cmd run build
-npm.cmd run test:unit
-npm.cmd run test:mcp
-npm.cmd run test:http-mcp
-npm.cmd run doctor:ci
-npm.cmd run verify:package
-npm.cmd test
-npm.cmd run pack:clean
-```
-
-### P0-2 提交并推送（用户执行 push）
-
-- 提交工作区修改到 `codex/patchwarden-v1.5.0`（或新建 `codex/patchwarden-v1.5.1`）
-- 若 PR #24 落后 main：`git fetch origin main` + `git rebase origin/main`
-- git credential 出错时修复 credential/proxy，**禁止 force-push 或 reset 绕过**
-
-### P0-3 PR #24 推进（用户执行 merge）
-
-- 标记 ready for review（仅本地门禁全绿后）
-- 监控 GitHub Actions
-- checks 绿时通过 PR 合并
-
-### P0-4 发布（用户执行 release + publish）
-
-- 创建 `v1.5.1` tag + GitHub Release（非 draft）
-- 确认 npm auth 后发布（不暴露 token）
-
-### P0 验收
-
-```powershell
-gh pr view 24 --repo jiezeng2004-design/PatchWarden --json state,mergeStateStatus,statusCheckRollup
-gh release view v1.5.1 --repo jiezeng2004-design/PatchWarden --json tagName,name,isDraft,isPrerelease,publishedAt,url
-npm.cmd view patchwarden version dist-tags --json --cache "$env:TEMP\patchwarden-npm-cache"
-```
-
-通过标准：PR 已合并 · Release `v1.5.1` 存在且非 draft · npm `version=1.5.1` · `dist-tags.latest=1.5.1` · 发布说明不夸大未验证内容。
-
-### P0 风险
-
-- 工作区修改可能混入非 v1.5.1 内容 → P0-0 逐文件核对
-- README 第 11 行版本号待更新
-- npm publish 需用户 credentialed 操作
-
-## 3. P1-A：Evidence Pack v2
-
-### 目标
-
-把 Evidence Pack 从 2 文件升级为有界多文件结构，成为项目招牌能力。
-
-### 当前差距
-
-`src/tools/evidencePack.ts` 当前只写：
-
-- `.patchwarden/evidence-packs/<lineage_id>/evidence.json`
-- `.patchwarden/evidence-packs/<lineage_id>/EVIDENCE.md`
-
-### v2 目标文件结构
-
-| 文件 | 内容 |
-| --- | --- |
-| `risk.json` | 风险项与严重度 |
-| `verify.json` | 每条验证命令的结构化记录 |
-| `diffstat.json` | 文件级增删统计（非完整 diff） |
-| `lineage.json` | lineage 有界摘要 |
-| `attestation.json` | 版本/commit/Node/OS/tool profile/schema epoch |
-| `redactions.json` | 脱敏类别与原因（**不存原始隐藏值**） |
-
-### 执行步骤
-
-1. 扩展 `SafeEvidencePack` 接口，新增 v2 文件字段
-2. 在 `exportTaskEvidencePack` 中按文件逐个写入，保持有界
-3. 更新 `src/tools/taskLineage.ts`、`src/tools/registry.ts`、`src/tools/toolRegistry.ts` 工具清单
-4. 更新 `src/test/unit/evidence-pack.test.ts` 覆盖 v2 文件
-5. 新增 `docs/evidence-pack-schema.md`（schema 参考）
-6. 更新 `docs/lineage-evidence-pack-workflow.md` 补 v2 文件说明
-
-### 实现红线
-
-- 不含完整 stdout/stderr/diff/secrets/.env/token/cookie/凭据路径
-- redactions 只存类别+原因，不存原值
-- attestation 含 PatchWarden version、commit、package version、Node version、OS、tool profile、schema epoch
-- `.patchwarden/evidence-packs/` 不得进入 npm 包（`package.json` 已排除 `.patchwarden/`）
-
-### P1-A 验收
-
-```powershell
-npm.cmd run build
-npm.cmd run test:unit
-npm.cmd run doctor:ci
-npm.cmd run verify:package
-```
-
-手动验收：跑一次 `run_task_loop` → `export_task_evidence_pack` → 确认 6 个 v2 文件存在 · `EVIDENCE.md` 可读有界 · `redactions.json` 无原始密钥 · npm 包不含 evidence-packs 输出。
-
-## 4. P1-B：README 与公开文档就绪
-
-### 目标
-
-在外部 PR 引流前，让仓库对外部用户可读。
-
-### 待补文档
-
-| 文档 | 状态 | 说明 |
-| --- | --- | --- |
-| `docs/why-patchwarden.md` | 新建 | 定位与动机 |
-| `docs/evidence-pack-schema.md` | 新建（与 P1-A 同步） | v2 schema 参考 |
-| `docs/spec-kit-integration.md` | 新建 | Spec Kit 集成 |
-| `docs/agentseal-integration.md` | 新建 | AgentSeal 集成 |
-| `docs/mcp-inspector-testing.md` | 新建 | MCP Inspector 测试 |
-| `docs/opencode-worker.md` | 新建 | OpenCode worker |
-| `docs/openhands-worker.md` | 新建 | OpenHands worker |
-| `docs/threat-model.md` | 已存在，更新 | 不重复创建 |
-
-### README 前页需保留的 8 个章节
-
-1. 一句定位
-2. 架构图
-3. 为何不是远程 shell
-4. 五分钟 demo
-5. Evidence Pack 样本
-6. 支持的 agent
-7. 安全边界
-8. 生态适配
-
-### P1-B 验收
-
-```powershell
-npm.cmd run build
-npm.cmd run check:brand
-npm.cmd run doctor:ci
-npm.cmd run verify:package
-```
-
-通过标准：README 在 npm/GitHub 确认前不声称 v1.5.1 已发布 · 安全边界在外部集成之前讲解 · 示例用占位版本号除非有发布真相。
-
-## 5. P2：外部 PR 批次 1（按风险递增顺序）
-
-### P2-1 MCP Inspector（最先，最低风险）
-
-- PR 形态：`docs: add CLI smoke testing example for MCP servers`
-- 通用优先，PatchWarden 仅作示例之一
-- 流程：clone inspector → 建 `docs/cli-smoke-testing-example` → 查上游贡献规则 → 仅改 docs → 跑上游 docs/lint/test → 推 fork 分支 → 开 PR → 监控 CI
-- 验收：上游检查通过 · 无营销措辞 · 不依赖 PatchWarden 也能成立
-
-### P2-2 AgentSeal（第二）
-
-- PR 形态：`feat: detect PatchWarden MCP configs and project policies` 或 `docs: add guarded local agent execution pattern`
-- 流程：clone agentseal → 建 `detect/patchwarden-policy` → 查 CONTRIBUTING + 现有 probes/tests → 选 code 或 docs 范围
-- 验收：detector 识别 `.patchwarden/config.json` 和 `project-policy.json` 但不读密钥 · 正负 fixture 测试 · 描述通用安全模式非营销
-
-### P2-3 PatchWarden 兼容文档（第三）
-
-- 新增 `docs/mcp-inspector-testing.md`、`docs/agentseal-integration.md`
-- 验收：Windows PowerShell 可运行 · 文档链接到真实上游 PR/issue
-
-## 6. P2：外部 PR 批次 2
-
-### Spec Kit（在 Evidence Pack v2 之后）
-
-- 前置依赖：**P1-A 完成**（需要稳定 evidence schema）
-- PR 形态：`docs: add evidence pack pattern for spec-driven development` 或 `walkthrough: verify implemented tasks with an external MCP safety layer`
-- 流程：clone spec-kit → 建 `docs/evidence-verification-pattern`
-- 验收：PR 映射 spec→tasks→implementation→evidence verification · PatchWarden 仅作示例实现 · 上游 docs 检查通过
-
-## 7. P3：外部 PR 批次 3（最后，需已发布 evidence 可引用）
-
-### OpenCode / OpenHands / Aider
-
-- **OpenCode**：流量大、repo 大，先 docs-only external supervisor pattern
-- **OpenHands**：源码归属在迁移，先查当前 repo 结构再选目标
-- **Aider**：成熟 CLI，safe wrapper pattern 有用但应在 PatchWarden 有发布示例之后
-- 每个 PR 验收：查上游贡献规则 · 不依赖 PatchWarden 也能用 · CI 或文档化本地检查通过 · PatchWarden README 仅在 PR 存在后回链
-
-## 8. Issue Backlog（P0 发布真相干净后创建）
-
-1. `fix: close v1.5.1 release truth gap`
-2. `feat: add Evidence Pack v2 artifact schema`
-3. `docs: add Evidence Pack v2 schema reference`
-4. `feat: export goal final report`
-5. `feat: import Spec Kit tasks into Goal Session`
-6. `docs: add MCP Inspector CLI smoke testing guide`
-7. `docs: add AgentSeal compatibility guide`
-8. `docs: add OpenCode worker integration guide`
-9. `docs: add OpenHands worker integration guide`
-10. `docs: add external PR roadmap and ecosystem compatibility matrix`
-
-## 9. 全局验收规则
-
-### 每个内部 PatchWarden PR
-
-```powershell
-npm.cmd run build
-npm.cmd run test:unit
-npm.cmd run test:mcp
-npm.cmd run test:http-mcp
-npm.cmd run doctor:ci
-npm.cmd run verify:package
-```
-
-### 发布前追加
-
-```powershell
-npm.cmd ci
-npm.cmd test
-npm.cmd run pack:clean
-gh pr checks <PR_NUMBER> --repo jiezeng2004-design/PatchWarden --watch
-gh release view v<version> --repo jiezeng2004-design/PatchWarden --json tagName,isDraft,publishedAt,url
-npm.cmd view patchwarden version dist-tags --json --cache "$env:TEMP\patchwarden-npm-cache"
-```
-
-**铁律**：GitHub Release 与 npm registry 真相都匹配目标版本前，绝不标记发布完成。
-
-## 10. 执行顺序与依赖
-
-```
-P0-0 逐文件核对 → P0-1 门禁 → P0-2 提交推送(用户) → P0-3 PR(用户) → P0-4 发布(用户)
-                                                                       │
-                                                                       v
-                                                                 P1-A Evidence Pack v2
-                                                                       │
-                                                         P1-B docs ───┤
-                                                                       v
-                                                       P2-1 Inspector → P2-2 AgentSeal → P2-3 兼容文档
-                                                                       │
-                                                                       v
-                                                                 P2 Spec Kit (依赖 P1-A)
-                                                                       │
-                                                                       v
-                                                       P3 OpenCode / OpenHands / Aider
-```
-
-## 11. 安全边界（贯穿全阶段）
-
-- 不暴露通用远程 shell，不弱化精确命令匹配
-- 所有 repo 路径在 `workspaceRoot` 内，阻止敏感名与越界改动
-- 不读取或持久化 token/cookie/浏览器状态/.env/SSH 密钥/凭据文件
-- 不 blanket-kill watcher/tunnel，仅监督 launcher 拥有的进程
-- live tunnel/watcher 切换与本地代码验证分开，不重启 live 服务除非显式要求
-- 保留结构化任务证据、心跳状态、前后 Git 快照、变更文件记录与脱敏

package/docs/release-v0.6.0.md

@@ -1,71 +0,0 @@
-# PatchWarden v0.6.0
-
-PatchWarden v0.6.0 在保持 `chatgpt_core` 固定 16 工具兼容的同时，加入默认关闭的
-`chatgpt_direct` 安全直接开发模式、本地 assess → confirm → execute 闭环，以及更可靠的
-Windows Core/Direct 双通道运行管理。
-
-## 主要更新
-
-### ChatGPT Core 安全体验
-
-- `assess_only` 返回最小化的结构化 `next_tool_call`；execute 只需
-  `execution_mode` 和完整 `assessment_id`，不再重复传输目标、计划和仓库参数。
-- 中风险票据通过本地 `patchwarden-confirm <full_assessment_id>` 确认。该入口不是 MCP
-  工具，远程调用者不能自行放行。
-- 确认和执行会重新校验票据时效、工作区、计划、策略和工具 Manifest。
-- `audit_task` 将已确认失败、可能误报和人工核查项分开呈现。
-- `get_task_summary(view: "compact")` 和终态 `wait_for_task` 返回有界验收证据，避免长任务
-  结果淹没客户端上下文。
-
-### ChatGPT Direct 模式
-
-- 默认关闭；启用需设置 `enableDirectProfile: true` 并使用 `chatgpt_direct` Profile。
-- 固定 9 工具：健康检查、工作区列表、会话创建、搜索、文件读取、JSON 补丁、白名单
-  验证、会话完成和独立审计。
-- 所有写操作绑定 Direct session 和内容哈希；不支持任意 shell、删除/重命名、Git 推送、
-  npm 发布或远程部署。
-
-### Windows Core/Direct 控制与可观测性
-
-- 根目录统一使用 `PatchWarden.cmd`，支持 Core、Direct 或两者的
-  `start`、`stop`、`restart`、`status`、`health` 和受限 `kill`。
-- Core 和 Direct 分别使用 `127.0.0.1:8080` 与 `127.0.0.1:8081`，并自动校正各自
-  tunnel profile 的 health 地址。
-- supervisor 将 stdout/stderr 写入各自 runtime 目录；非零退出时显示 stderr 最后 30 行，
-  并把退出码、脱敏 tail 和日志路径写入 `tunnel-status.json`。
-- 修复 Core watcher 的 `XDG_CONFIG_HOME` 泄漏到 tunnel-client，导致 Core 错误读取
-  `%LOCALAPPDATA%\patchwarden\opencode-config\tunnel-client\patchwarden.yaml` 并反复退出的问题。
-- `stop` / `restart` 可清理 Profile 精确匹配的遗留 tunnel-client；无关端口占用只报告、不误杀。
-- `status` 支持 health endpoint fallback，陈旧 JSON 不再把实际 ready 的实例误报为 stopped。
-- 旧的单用途入口迁入 `scripts/launchers/`；个人 `.local/launchers/`、运行时配置、凭据和日志
-  不进入 Git、npm 包或 GitHub 发布资产。
-
-## 兼容性
-
-- `chatgpt_core` 仍为固定 16 工具；`chatgpt_direct` 为固定 9 工具。
-- schema epoch 为 `2026-06-22-v6`。
-- `assess_only`、`execute`、`assessment_id`、`plan_ref` 和既有任务记录保持兼容。
-- npm 包名保持 `patchwarden`；旧的 `safe-bifrost` 包继续冻结在 v0.3.0。
-
-## 验证
-
-发布候选通过以下门禁：
-
-```powershell
-npm.cmd run build
-npm.cmd test
-npm.cmd run check:tool-manifest
-npm.cmd run check:direct-tool-manifest
-npm.cmd run test:mcp
-npm.cmd run test:http-mcp
-npm.cmd run doctor:ci
-npm.cmd run pack:clean
-npm.cmd run verify:package
-git diff --check
-```
-
-本机双通道验收确认 Core 16 工具和 Direct 9 工具均为 `running`、`ready=true`，8080/8081
-由对应 `tunnel-client.exe` 监听，两个 `/readyz` 均返回 `ready`。
-
-GitHub Release 与 npm Registry 是独立发布面。创建 Tag/Release 不会自动发布 npm；npm 发布后
-仍需单独核对 `patchwarden@latest`、版本时间、dist-tag 和包完整性。

package/docs/release-v0.6.1.md

@@ -1,75 +0,0 @@
-# PatchWarden v0.6.1 Release Notes
-
-**Release Date**: 2026-06-25
-
-## Overview
-
-PatchWarden v0.6.1 is a stability and observability release. It addresses watcher heartbeat false positives, adds Chinese path reliability, introduces two new tools (`safe_status` and `sync_file`), and adds comprehensive security guard unit tests.
-
-## New Features
-
-### safe_status Tool
-
-A minimal task lifecycle status tool that returns task state without exposing diff, log content, or file contents. Useful when upper-layer security policies block content-bearing tools.
-
-```json
-{
-  "task_id": "task-001",
-  "status": "running",
-  "phase": "executing_agent",
-  "last_heartbeat_at": "2026-06-24T10:00:12Z",
-  "current_command": "codex exec",
-  "watcher_state": "healthy"
-}
-```
-
-### sync_file Tool
-
-Copy a file from source to target within a Direct session repo. Both paths must be inside the session's `repo_path`. Supports optional sha256 verification for both source and target.
-
-### Android Build Doctor
-
-When a managed project contains an `android_app` directory, the health check now includes Android build environment diagnostics: Java version, JAVA_HOME, ANDROID_HOME, SDK platform, build-tools, Gradle wrapper, and APK output path.
-
-## Bug Fixes
-
-- **Watcher stale false positive**: Long-running tasks no longer cause the watcher to be incorrectly reported as stale. The watcher status now falls back to checking running task heartbeats.
-- **Chinese path encoding**: All file I/O operations verified to use UTF-8 encoding. Health check now reports `path_encoding` status.
-- **Tracked external dirty detection**: `captureRepoSnapshot` now correctly identifies tracked-but-modified external files via `dirty_paths` field parsed from `git status --porcelain`. The regex now includes `R` (rename) status, fixing dead code that previously never executed for renamed files.
-- **Release zip path separators**: The packaging script (`pack-clean.js`) now creates zip archives with POSIX `/` path separators instead of Windows backslashes. Linux `unzip` no longer reports `warning: appears to use backslashes as path separators`.
-
-## Security
-
-- 136 unit tests covering all security guards (path guard, sensitive guard, command guard, direct guards)
-- Tests use Node's built-in `node:test` — zero new dependencies
-
-## Observability
-
-- Structured JSON logging to stderr (never stdout, to avoid polluting MCP JSON-RPC)
-- Tool call audit logs with duration tracking
-- Global `unhandledRejection` and `uncaughtException` handlers
-
-## Tool Profile Changes
-
-| Profile | v0.6.0 | v0.6.1 |
-|---------|--------|--------|
-| full | 28 | 30 |
-| chatgpt_core | 16 | 17 |
-| chatgpt_direct | 9 | 10 |
-
-## Migration
-
-No breaking changes. All new fields are optional. New tools are additive and do not affect existing tools.
-
-## Verification
-
-- TypeScript compilation: PASS
-- Unit tests: 136 pass, 0 fail, 1 skipped (Windows symlink)
-- Smoke tests: 139 pass, 0 fail
-- Lifecycle tests: 22 pass, 0 fail (includes tracked external file rename regression test)
-- Doctor CI: PASS (81 OK, 0 WARN, 0 FAIL on the release check host)
-- Tool manifest check: PASS
-- Package manifest check: PASS (260 files)
-- Brand check: PASS (128 tracked files)
-- MCP HTTP tests: 13 pass, 0 fail
-- Release zip: POSIX path separators verified (261 entries, no backslashes)

package/docs/release-v0.6.4.md

@@ -1,45 +0,0 @@
-# PatchWarden v0.6.4 Release Notes
-
-**Release Date**: 2026-06-26
-
-## Overview
-
-PatchWarden v0.6.4 is a desktop experience release. It keeps the existing CLI and script surface, but makes the normal Windows workflow feel like a lightweight local application: start one desktop entry, control Core/Direct from the tray or Web dashboard, and shut everything down from one stop command.
-
-## Desktop Entry
-
-- Added `PatchWarden-Desktop.cmd` as the recommended daily entry point.
-- The desktop entry starts the tray in a hidden PowerShell host and ensures the local Control Center is available.
-- It does not automatically open a browser window. Use **Open Dashboard** from the tray or `PatchWarden-Control.cmd` when you want the full Web console.
-- `PatchWarden-Control-Tray.cmd --foreground` remains available for tray debugging.
-
-## Tray Improvements
-
-- Added single-instance protection for the tray process.
-- Replaced the generic system icon path with a small PatchWarden-styled shield icon drawn through WinForms/System.Drawing.
-- Kept the tray as a lightweight switch layer: Open Dashboard, Status, Start All, Stop All, Restart All, Open Logs, and Quit Tray.
-- Added clearer balloon/status feedback for startup and lifecycle actions.
-- Clarified action semantics: **Stop All** stops Core/Direct and leaves tray/dashboard available; **Quit Tray** exits only the tray; `Stop-PatchWarden.cmd` performs full shutdown.
-
-## Background Lifecycle
-
-- Control Center now invokes `manage-patchwarden.ps1` with `-Background` and `windowsHide: true` for lifecycle API calls.
-- The manager starts Core/Direct supervisors hidden for desktop/Web flows, while preserving visible launcher windows for explicit CLI/debug usage.
-- Added `-NoTunnelWebUi` to `start-patchwarden-tunnel.ps1` so background starts do not open tunnel-client Web UI tabs.
-
-## Verification
-
-- TypeScript build: PASS
-- Control smoke: PASS
-- Control Center smoke: PASS (23 passed, 0 failed)
-- Package manifest check: PASS
-- PowerShell control script parse check: PASS
-- Manual desktop-flow evidence: desktop entry starts only tray + Control Center; Start/Restart uses hidden supervisors; Stop-PatchWarden closes Core/Direct, Control Center, and tray.
-
-## Migration
-
-No breaking changes. Existing CLI commands and compatibility launchers remain available. For daily Windows use, prefer:
-
-```powershell
-.\PatchWarden-Desktop.cmd
-```