patchwarden 1.5.1 → 1.6.2

package/dist/tools/runVerification.js

@@ -1,36 +0,0 @@
-import { readDirectSession, appendDirectSessionVerificationRun, } from "../direct/directSessionStore.js";
-import { guardDirectSessionActive } from "../direct/directGuards.js";
-import { runDirectVerification } from "../direct/directVerification.js";
-export async function runVerification(input) {
-    // 1. Read session and guard active
-    const session = readDirectSession(input.session_id);
-    guardDirectSessionActive(session);
-    // 2. Call runDirectVerification with command, resolvedRepoPath,
-    //    sessionId, and timeoutSeconds
-    const timeoutSeconds = input.timeout_seconds ?? 120;
-    const result = await runDirectVerification({
-        command: input.command,
-        resolvedRepoPath: session.resolved_repo_path,
-        sessionId: input.session_id,
-        timeoutSeconds,
-    });
-    // 3. Append verification run to session
-    appendDirectSessionVerificationRun(input.session_id, result.run);
-    // 4. Return result
-    return {
-        command: result.run.command,
-        exit_code: result.run.exit_code,
-        passed: result.run.passed,
-        timed_out: result.run.timed_out,
-        redacted: Boolean(result.run.redacted),
-        redaction_categories: result.run.redaction_categories || [],
-        started_at: result.run.started_at,
-        finished_at: result.run.finished_at,
-        stdout_tail: result.run.stdout_tail,
-        stderr_tail: result.run.stderr_tail,
-        log_path: result.run.log_path,
-        next_action: result.run.passed
-            ? "Call finalize_direct_session to complete the session."
-            : "Review the verification output and apply_patch to fix issues.",
-    };
-}

package/dist/tools/syncFile.js

@@ -1,65 +0,0 @@
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { PatchWardenError } from "../errors.js";
-import { getConfig } from "../config.js";
-import { guardDirectPath, guardDirectWritePath } from "../direct/directGuards.js";
-import { guardSensitivePath } from "../security/sensitiveGuard.js";
-import { computeFileSha256 } from "../direct/directPatch.js";
-/**
- * Copy a file from source to target within the same session repo.
- * Both source and target must be inside the session's repo_path.
- */
-export function syncFile(sessionId, sourcePath, targetPath, options, config) {
-    const cfg = config || getConfig();
-    const sessionsDir = resolve(cfg.workspaceRoot, cfg.directSessionsDir);
-    // Load session to get repo_path
-    const sessionFile = resolve(sessionsDir, sessionId, "session.json");
-    if (!existsSync(sessionFile)) {
-        throw new PatchWardenError("direct_session_not_found", `Direct session "${sessionId}" not found.`, "Create a direct session first using direct_start_session.", true, { session_id: sessionId });
-    }
-    const session = JSON.parse(readFileSync(sessionFile, "utf-8"));
-    const repoPath = resolve(session.repo_path);
-    const workspaceRoot = cfg.workspaceRoot;
-    // Guard source path — must be inside repo
-    const resolvedSource = guardDirectPath(sourcePath, repoPath, workspaceRoot);
-    guardSensitivePath(resolvedSource);
-    if (!existsSync(resolvedSource)) {
-        throw new PatchWardenError("source_file_not_found", `Source file does not exist: "${sourcePath}".`, "Ensure the source path is correct.", true, { source_path: sourcePath });
-    }
-    // Guard target path — must be inside repo, not in blocked dirs
-    const resolvedTarget = guardDirectWritePath(targetPath, repoPath, workspaceRoot);
-    guardSensitivePath(resolvedTarget);
-    // Verify source sha256 if provided
-    const sourceSha256 = computeFileSha256(resolvedSource);
-    if (options?.expected_source_sha256 && options.expected_source_sha256 !== sourceSha256) {
-        throw new PatchWardenError("source_hash_mismatch", `Source file hash mismatch. Expected "${options.expected_source_sha256}" but got "${sourceSha256}".`, "Re-read the source file to get the current sha256.", true, { expected_sha256: options.expected_source_sha256, actual_sha256: sourceSha256 });
-    }
-    // Get target sha256 before copy
-    let beforeTargetSha256 = null;
-    if (existsSync(resolvedTarget)) {
-        beforeTargetSha256 = computeFileSha256(resolvedTarget);
-        // Verify target sha256 if provided
-        if (options?.expected_target_sha256 && options.expected_target_sha256 !== beforeTargetSha256) {
-            throw new PatchWardenError("target_hash_mismatch", `Target file hash mismatch. Expected "${options.expected_target_sha256}" but got "${beforeTargetSha256}".`, "Re-read the target file to get the current sha256.", true, { expected_sha256: options.expected_target_sha256, actual_sha256: beforeTargetSha256 });
-        }
-    }
-    // Read source content
-    const sourceContent = readFileSync(resolvedSource);
-    const copiedBytes = sourceContent.length;
-    // Create target directory if needed
-    mkdirSync(dirname(resolvedTarget), { recursive: true });
-    // Write to target
-    writeFileSync(resolvedTarget, sourceContent, "utf-8");
-    // Compute after hash
-    const afterTargetSha256 = computeFileSha256(resolvedTarget);
-    const changed = beforeTargetSha256 !== afterTargetSha256;
-    return {
-        source_path: sourcePath,
-        target_path: targetPath,
-        before_target_sha256: beforeTargetSha256,
-        after_target_sha256: afterTargetSha256,
-        source_sha256: sourceSha256,
-        copied_bytes: copiedBytes,
-        changed,
-    };
-}

package/docs/control-center/control-center-daily-driver.md

@@ -1,211 +0,0 @@
-# PatchWarden Control Center Daily Driver
-
-> v0.6.4 在 v0.6.2 MVP 与 v0.6.3 Phase 2 基础上，把 Control Center 从「启动页面脚本」
-> 升级为日常入口：单实例启动、后台运行、托盘入口、健康修复建议、页面通知和活动时间线。
-> 不重构架构，不合并 Core/Direct MCP，不改现有 MCP 工具注册逻辑。
-> 不发布 npm，不打 git tag。
-
-## 概述
-
-Daily Driver 完全在 Control Center HTTP 层与启动脚本层增强，未触动 MCP 工具注册、
-watcher 核心循环或 Direct session 写入逻辑。新增的 API 沿用既有 token 校验、路径围栏
-和脱敏机制；托盘与后台模式仅调用现有 Control Center API，不引入新的进程管理路径。
-
-- **单实例启动**：status 文件 + 端口探测，重复运行只开浏览器，不启第二个服务
-- **后台运行**：`-Background`（默认）/ `-Foreground` / `-NoBrowser`，日志写入
-  `%LOCALAPPDATA%\patchwarden\control-center\control-center.{stdout,stderr}.log`
-- **托盘入口**：基于 .NET NotifyIcon 的轻量 PowerShell 托盘，无需 Electron
-- **健康修复建议**：`/api/status` 新增 `suggestions` 字段，dashboard 显示建议卡片
-- **页面通知**：dashboard 轮询状态变化时弹出 toast，同一事件只提示一次
-- **Activity Timeline**：`runtime/control-center-events.jsonl` 记录关键事件，
-  `GET /api/events` 返回最近事件，dashboard 显示时间线区块
-
-## 启动方式
-
-### 1. 日常入口（推荐）
-
-```powershell
-.\PatchWarden-Control.cmd
-```
-
-默认后台启动 Control Center 并打开浏览器。再次运行时：
-
-- 如果 127.0.0.1:8090 已经是当前 Control Center —— 直接打开浏览器页面，不重复启动
-- 如果端口被其他程序占用 —— 给出明确错误提示并退出
-- 如果 status 文件指向已死的 PID —— 清理孤儿进程后启动新实例
-
-### 2. 启动参数
-
-```powershell
-.\PatchWarden-Control.cmd -NoBrowser       # 启动但不打开浏览器
-.\PatchWarden-Control.cmd -Foreground      # 前台运行，日志直接输出到控制台
-.\PatchWarden-Control.cmd -Background      # 后台运行（默认），脚本启动后即退出
-```
-
-`-Foreground` 与 `-Background` 互斥；都不传时默认 `-Background`。
-
-### 3. 托盘入口
-
-```powershell
-.\PatchWarden-Control-Tray.cmd
-```
-
-启动 Windows 系统托盘图标（基于 .NET NotifyIcon，无需额外依赖）。如果 Control Center
-未运行，托盘脚本会先在后台启动它。托盘菜单：
-
-| 菜单项 | 行为 |
-| --- | --- |
-| Open Control Center | 在默认浏览器打开 dashboard |
-| Start All | `POST /api/start-all`（带 token） |
-| Stop All | `POST /api/stop-all`（带 token） |
-| Restart All | `POST /api/restart-all`（带 token） |
-| Open Workspace | 通过 `GET /api/workspace` 获取 workspaceRoot 后用 explorer 打开 |
-| Open Logs Folder | `POST /api/open-logs-folder`（带 token） |
-| Exit | 关闭托盘（不停止 Control Center 后台进程） |
-
-双击托盘图标打开 dashboard。所有 API 调用通过 `/control-token.json` 获取 token 后
-带 `X-PatchWarden-Control-Token` 头发起请求。
-
-## 改动文件
-
-| 文件 | 改动 |
-| --- | --- |
-| `src/version.ts` | `PATCHWARDEN_VERSION` 0.6.3 → 0.6.4 |
-| `package.json` | `version` 0.6.3 → 0.6.4 |
-| `src/controlCenter.ts` | 新增 status 文件、events JSONL、suggestions 引擎、`/api/events`、`/api/control-center-status`；`getControlCenterLogDir` 支持 `PATCHWARDEN_CONTROL_LOG_DIR` 覆盖 |
-| `scripts/control/start-control-center.ps1` | 重写：单实例检测、`-NoBrowser`/`-Foreground`/`-Background`、孤儿清理、端口冲突检测 |
-| `scripts/control/control-center-tray.ps1` | 新文件：.NET NotifyIcon 托盘，菜单驱动 Control Center API |
-| `PatchWarden-Control-Tray.cmd` | 新文件：托盘启动入口 |
-| `ui/pages/dashboard.html` | 新增 Health Suggestions 卡片、toast 通知、Activity Timeline 区块 |
-| `scripts/checks/control-center-smoke.js` | 新增 Test 16–20 覆盖 Daily Driver API；`PATCHWARDEN_CONTROL_LOG_DIR` 重定向到项目内临时目录 |
-| `scripts/release/pack-clean.js` | forbidden 列表新增 `.tmp/` |
-| `.gitignore` | 新增 `.tmp/` |
-| `docs/control-center/control-center-daily-driver.md` | 本文档 |
-
-## 新增 API
-
-### GET 接口（免 token）
-
-| 路径 | 说明 |
-| --- | --- |
-| `GET /api/events?limit=<N>` | 返回最近 N 条活动事件（最大 1000），结构 `{events, total, limit}` |
-| `GET /api/control-center-status` | 读取 status 文件，返回 `{running, pid, port, started_at, url, version}` 或 `{running: false}` |
-
-### /api/status 增强字段
-
-`GET /api/status` 响应新增 `suggestions` 数组，每条建议包含：
-
-```json
-{
-  "code": "core_stopped",
-  "severity": "warning",
-  "message": "Core 未运行，建议启动 Core profile",
-  "action": "/api/core/start",
-  "link": null
-}
-```
-
-| code | severity | 触发条件 | action |
-| --- | --- | --- | --- |
-| `core_stopped` | warning | Core 探测不可用 | `/api/core/start` |
-| `direct_stopped` | warning | Direct 探测不可用 | `/api/direct/start` |
-| `watcher_stale` | error | watcher 状态为 stale/unreadable | `/api/restart-all` |
-| `stale_task` | warning | 存在 stale 任务 | 无 action，`link` 指向 tasks 页面 |
-| `tunnel_not_ready` | warning | Core 或 Direct tunnel 未就绪 | `/api/restart-all` |
-| `agent_missing` | info | 配置的 agent 不可用 | 无 action，提示检查路径 |
-
-## 活动事件
-
-事件写入 `%LOCALAPPDATA%\patchwarden\control-center\control-center-events.jsonl`，
-每行一个 JSON 对象 `{timestamp, type, payload?}`。文件超过 512KB 时惰性裁剪到
-2000 行。
-
-### 事件类型
-
-| type | 触发时机 |
-| --- | --- |
-| `control_center.started` | 服务 listen 成功 |
-| `control_center.stopped` | 服务收到 SIGTERM/SIGINT 关闭 |
-| `manage.start.all` / `manage.stop.all` / `manage.restart.all` | 用户请求 start/stop/restart all |
-| `manage.<mode>.<action>.failed` | manage-patchwarden.ps1 执行失败 |
-| `core.status_changed` | Core 可用性发生变化（diff 自上次 /api/status 轮询） |
-| `direct.status_changed` | Direct 可用性发生变化 |
-| `watcher.status_changed` | watcher 状态发生变化 |
-| `task.status_changed` | 任务状态从 running → done/failed 等 |
-| `task.reconciled` | 用户对 stale 任务执行 reconcile |
-| `task.audited` | 用户对任务执行 audit |
-
-> Control Center 是无状态、拉取驱动的服务。`core/direct/watcher/task.status_changed`
-> 事件在 `/api/status` 轮询时通过 digest diff 检测，因此事件时间戳反映的是「被观察到」
-> 的时间，不保证是状态变化的精确时刻。
-
-## 页面通知（toast）
-
-dashboard.html 轮询 `/api/status`（30s）和 `/api/audit`（90s）时检测以下状态变化并
-弹出 toast 通知：
-
-- core/direct: available → unavailable（error）/ unavailable → available（success）
-- watcher: healthy → stale/unreadable（error）/ stale → healthy（success）
-- task: running → done（success）/ running → failed*（error）
-- audit: 新出现的 pass（success）/ warn（warning）/ fail（error）
-
-同一事件通过 dedup key 只提示一次；toast 8 秒后自动消失，也可手动关闭。首次加载时
-audit 列表会 seed 到 `seenAuditKeys`，不会对已有审计记录弹通知。
-
-## 运行时文件
-
-| 文件 | 路径 | 说明 |
-| --- | --- | --- |
-| status 文件 | `%LOCALAPPDATA%\patchwarden\control-center\control-center-status.json` | pid/port/started_at/url/version，服务启动时写入，关闭时删除 |
-| events 文件 | `%LOCALAPPDATA%\patchwarden\control-center\control-center-events.jsonl` | 活动事件 JSONL |
-| stdout 日志 | `%LOCALAPPDATA%\patchwarden\control-center\control-center.stdout.log` | 后台模式 stdout |
-| stderr 日志 | `%LOCALAPPDATA%\patchwarden\control-center\control-center.stderr.log` | 后台模式 stderr |
-
-> `PATCHWARDEN_CONTROL_LOG_DIR` 环境变量可覆盖上述目录（必须为绝对路径），
-> 主要用于 smoke test 将其重定向到项目内临时目录。
-
-## 测试
-
-```powershell
-npm.cmd test
-```
-
-### control-center-smoke.js（21 项）
-
-| # | 测试 | 覆盖 |
-| --- | --- | --- |
-| 1–1b | 静态文件 + 页面路由 | 基础服务 |
-| 2 | `/api/status` JSON + 容错 | 结构校验 |
-| 3–4 | tasks JSON + control-token | token 机制 |
-| 5–7 | POST 无 token / 错 token → 403 | 安全门 |
-| 8–9 | token 不污染 git + 无 CDN | 发布卫生 |
-| 10 | 其他 GET API 可达 | workspace/audit/logs/tunnel |
-| 11–15 | Phase 2 API | stale/reconcile/workspace/direct-sessions/logs |
-| **16** | `/api/status` 包含 `suggestions` 数组 | Daily Driver |
-| **17** | `/api/events` 返回 JSON | Daily Driver |
-| **18** | `/api/logs/control-center` 返回 JSON | Daily Driver |
-| **19** | POST `/api/restart-all` 无 token → 403 | Daily Driver |
-| **20** | `/api/control-center-status` 报告 running 实例 | Daily Driver（单实例检测） |
-
-### 全量测试结果
-
-```
-security tests:    139 passed, 0 failed
-unit tests:        136 passed, 0 failed (1 skipped: Windows symlink)
-lifecycle tests:    22 passed, 0 failed
-control-center:     21 passed, 0 failed
-```
-
-## 已知限制
-
-1. **托盘为 PowerShell 实现**：基于 .NET NotifyIcon，不提供跨平台支持；在非 Windows
-   环境下不可用。如需跨平台托盘，需引入 Electron 或类似框架（本阶段刻意避免）。
-2. **事件时间为观测时间**：Control Center 无状态，`status_changed` 事件在轮询时通过
-   diff 检测，时间戳是「被观察到」的时间，不保证是状态变化的精确时刻。
-3. **status 文件依赖可写目录**：如果 `%LOCALAPPDATA%` 不可写（如沙箱环境），
-   status 文件不会生成，单实例检测会退化为端口探测模式。可通过
-   `PATCHWARDEN_CONTROL_LOG_DIR` 覆盖到可写目录。
-4. **toast 为页面内通知**：不要求系统级通知；仅当 dashboard 页面打开时才会弹出。
-5. **托盘 Exit 不停止后台进程**：Exit 仅关闭托盘，Control Center 后台 node 进程继续
-   运行。需通过 Stop All 或 `Stop-Process -Id <pid>` 停止。
-6. **事件文件不轮转**：超过 512KB 时惰性裁剪到 2000 行，不按日期轮转。

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

@@ -1,205 +0,0 @@
-# PatchWarden Control Center MVP
-
-> 本地 Web 控制中心，统一管理 PatchWarden Core 与 PatchWarden Direct 两个 MCP profile。
-> 不合并工具，不发布到 npm，不打 git tag。
-
-## 概述
-
-Control Center 是一个绑定 `127.0.0.1:8090` 的本地 HTTP 服务，提供静态 UI 页面和一组容错 JSON API。
-所有进程生命周期操作（start/stop/restart）均委托 `scripts/control/manage-patchwarden.ps1` 执行，
-Control Center 自身不直接 kill 进程，也不读取任意 PID 文件。
-
-- **Core profile**: `chatgpt_core`，17 个工具，HTTP 端口 8080
-- **Direct profile**: `chatgpt_direct`，10 个工具，HTTP 端口 8081
-
-## 新增文件
-
-| 文件 | 说明 |
-| --- | --- |
-| `src/controlCenter.ts` | Control Center HTTP 服务主程序（TypeScript 源） |
-| `scripts/checks/control-center-smoke.js` | 测试模式冒烟测试（ESM，仅用 Node 内置模块） |
-| `scripts/control/start-control-center.ps1` | PowerShell 启动脚本（含构建检查、端口轮询、浏览器自动打开；支持 `-NoBrowser`） |
-| `PatchWarden-Control.cmd` | 根目录 CMD 入口，调用上述 PowerShell 脚本 |
-| `ui/pages/dashboard.html` | 总控首页（真实状态，7 个工具栏按钮，两张服务卡） |
-| `ui/pages/tasks.html` | 任务列表页（接 `/api/tasks`） |
-| `ui/pages/task-detail.html` | 任务详情页（接 `/api/tasks/:taskId`） |
-| `ui/pages/workspace.html` | 工作区页（接轻量 `/api/workspace`） |
-| `ui/pages/audit.html` | 审计历史页（接 `/api/audit`） |
-| `ui/partials/project-shell.html` | 页面外壳（CDN 引用已替换为本地 `/vendor/`） |
-| `ui/colors_and_type.css` | 颜色与字体样式 |
-| `ui/vendor/tailwindcss-browser.js` | Tailwind v4.3.1 browser build（本地副本，离线可用） |
-| `ui/vendor/lucide.js` | Lucide v1.8.0 UMD（本地副本，离线可用） |
-| `docs/control-center/control-center-mvp.md` | 本文档 |
-
-## 改动文件
-
-| 文件 | 改动 |
-| --- | --- |
-| `package.json` | 新增 `start:control` 脚本（`node dist/controlCenter.js`）；`files` 数组新增 `ui/`；`test` 脚本末尾追加 `&& node scripts/checks/control-center-smoke.js` |
-| `.gitignore` | 新增 `/CODE_WIKI.md`、`/PatchWarden-UI.zip`、`/patchwarden-v0.6.1-SHA256SUMS.txt`（避免 brand-check 误报） |
-
-## 启动方式
-
-### 方式一：CMD 入口（推荐用户使用）
-
-```powershell
-.\PatchWarden-Control.cmd
-```
-
-### 方式二：PowerShell 脚本
-
-```powershell
-# 正常启动（构建检查 + 打开浏览器）
-powershell -ExecutionPolicy Bypass -File scripts\control\start-control-center.ps1
-
-# 测试模式（不打开浏览器）
-powershell -ExecutionPolicy Bypass -File scripts\control\start-control-center.ps1 -NoBrowser
-```
-
-### 方式三：npm 脚本（需先 `npm run build`）
-
-```powershell
-npm.cmd run build
-npm.cmd run start:control
-```
-
-启动后自动打开 `http://127.0.0.1:8090`。
-
-端口可通过环境变量覆盖（仅用于测试）：
-
-```powershell
-$env:PATCHWARDEN_CONTROL_PORT=18090; node dist/controlCenter.js
-```
-
-## 控制 Token 校验
-
-- 服务启动时通过 `crypto.randomUUID()` 生成 token，**仅保存在内存中**，不写入任何文件。
-- 前端通过 `GET /control-token.json` 从内存获取 token，响应头 `Cache-Control: no-store`。
-- **所有 POST 接口**（含 `/api/start-all`、`/api/stop-all`、`/api/restart-all`、`/api/core/*`、`/api/direct/*`、`/api/open-logs-folder`）必须携带 `X-PatchWarden-Control-Token` 请求头。
-- token 缺失或错误时返回 `403`，不执行任何进程控制或本地系统动作。
-- GET 接口（status、tasks、logs 等）不需要 token。
-- `git status --porcelain` 不会出现 `ui/control-token.json`。
-
-## API 清单
-
-### GET 接口（免 token）
-
-| 路径 | 说明 |
-| --- | --- |
-| `GET /` | 返回 `ui/pages/dashboard.html` |
-| `GET /control-token.json` | 从内存返回控制 token，`Cache-Control: no-store` |
-| `GET /colors_and_type.css` | 静态 CSS |
-| `GET /pages/*` | 静态 HTML 页面 |
-| `GET /partials/*` | 静态 HTML 片段 |
-| `GET /vendor/*` | 本地化的 Tailwind / Lucide |
-| `GET /api/status` | 聚合状态（容错，永不 500） |
-| `GET /api/tasks` | 任务列表（复用 `listTasks`） |
-| `GET /api/tasks/:taskId` | 任务详情（status/runtime/result/audit/diff_patch/test_log） |
-| `GET /api/logs/core` | Core runtime 日志尾部 100 行（脱敏） |
-| `GET /api/logs/direct` | Direct runtime 日志尾部 100 行（脱敏） |
-| `GET /api/logs/watcher` | Watcher 日志尾部 100 行（脱敏） |
-| `GET /api/workspace` | 轻量工作区信息（workspace_root、directories、agents、config 摘要；**不做 git 扫描**） |
-| `GET /api/audit` | 审计历史（扫描 tasks 目录下含 audit.json 的任务，最多 50 条） |
-| `GET /api/tunnel-ui-url` | 读取 Core/Direct 的 tunnel-health-url.txt |
-
-### POST 接口（必须校验 token）
-
-| 路径 | 委托命令 | 说明 |
-| --- | --- | --- |
-| `POST /api/start-all` | `manage-patchwarden.ps1 start all` | 启动全部 |
-| `POST /api/stop-all` | `manage-patchwarden.ps1 stop all` | 停止全部 |
-| `POST /api/restart-all` | `manage-patchwarden.ps1 restart all` | 重启全部 |
-| `POST /api/core/start` | `manage-patchwarden.ps1 start core` | 启动 Core |
-| `POST /api/core/stop` | `manage-patchwarden.ps1 stop core` | 停止 Core |
-| `POST /api/direct/start` | `manage-patchwarden.ps1 start direct` | 启动 Direct |
-| `POST /api/direct/stop` | `manage-patchwarden.ps1 stop direct` | 停止 Direct |
-| `POST /api/open-logs-folder` | 系统命令打开 runtime 目录 | 打开日志文件夹 |
-
-### `/api/status` 返回结构（容错）
-
-```json
-{
-  "core": { "available": false, "reason": "...", "healthz": null, "readyz": null },
-  "direct": { "available": false, "reason": "...", "healthz": null, "readyz": null },
-  "watcher": { "status": "missing|healthy|stale|unreadable", "available": false, "reason": "..." },
-  "tunnel": { "core": { "observed": false }, "direct": { "observed": false } },
-  "tools": {
-    "core": { "tool_profile": null, "tool_count": null, "schema_epoch": null, "tool_manifest_sha256": null, "tool_names": null },
-    "direct": { "tool_profile": null, "tool_count": null, "schema_epoch": null, "tool_manifest_sha256": null, "tool_names": null }
-  },
-  "agents": [],
-  "workspace_root": "string | null",
-  "tasks": { "tasks": [], "total": 0, "active": 0, "stale": 0, "reason": null }
-}
-```
-
-容错保证：
-- core/direct health 探测失败 → `{ available: false, reason: "..." }`，接口仍 200
-- runtime 文件（tunnel-status.json、tool-manifest.json）缺失 → 返回 null 或 `{ observed: false }`，接口仍 200
-- 日志文件缺失 → `{ stdout: "", stderr: "", reason: "..." }`，接口仍 200
-- tasks 目录缺失 → `{ tasks: [], total: 0, reason: "..." }`，接口仍 200
-- Core/Direct 未启动时 `/api/status` 仍返回 200 JSON，不报 500
-
-## 进程安全
-
-- Control Center **不直接 kill 进程**，所有 start/stop/restart 均委托 `scripts/control/manage-patchwarden.ps1`。
-- `manage-patchwarden.ps1` 的 `Test-TunnelProcessForMode` 在 stop/restart 前校验进程命令行属于 `tunnel-client.exe --profile` 模式，仅停止匹配的进程。
-- **不根据任意 PID 文件 kill 进程**。
-- Control Center 仅在自身服务关闭时退出自己启动的 HTTP server。
-
-## CDN 本地化
-
-- 所有 HTML 无 `https://cdn` 或 `https://unpkg` 引用。
-- `ui/vendor/tailwindcss-browser.js`（Tailwind v4.3.1）和 `ui/vendor/lucide.js`（Lucide v1.8.0）为本地副本。
-- 断网后页面样式和图标正常渲染。
-
-## 冒烟测试（测试模式）
-
-`scripts/checks/control-center-smoke.js` 严格遵循测试模式：
-
-- 不打开浏览器
-- 不真正 start/stop Core 或 Direct
-- 不 kill 任何进程（仅关闭自己 spawn 的 controlCenter 子进程）
-- 使用测试端口 `18090`（通过 `PATCHWARDEN_CONTROL_PORT`），避免 8090 冲突
-- 测试结束关闭 server，释放端口
-
-测试覆盖（10 项）：
-
-1. 静态文件服务（`/`、`/vendor/*`、`/colors_and_type.css` 返回 200 + 正确 Content-Type）
-2. `/api/status` 返回有效 JSON 且容错（core/direct 未启动时仍 200）
-3. `/api/tasks` 返回有效 JSON
-4. `/control-token.json` 返回 token + `Cache-Control: no-store`
-5. POST `/api/start-all` 不带 token → 403
-6. POST `/api/start-all` 带错误 token → 403
-7. POST `/api/open-logs-folder` 不带 token → 403
-8. token 不污染 Git（`git status --porcelain` 不含 `ui/control-token.json`）
-9. 无 CDN 引用（HTML 文件无 `https://cdn` / `https://unpkg`）
-10. 其他 GET API 可达（`/api/workspace`、`/api/audit`、`/api/logs/core`、`/api/tunnel-ui-url`）
-
-## 测试结果
-
-`npm test` 全量通过（`FINAL_EXIT_CODE: 0`）：
-
-| 测试链 | 结果 |
-| --- | --- |
-| smoke-test | OK |
-| unit-tests | 139 total（136 pass，0 fail，1 skipped） |
-| lifecycle-smoke | 22 passed, 0 failed |
-| doctor-smoke | OK |
-| tunnel-supervisor-smoke | OK |
-| watcher-supervisor-smoke | OK |
-| control-smoke | OK |
-| mcp-manifest-check | 17 tools, chatgpt_core profile |
-| brand-check | OK: 144 tracked files checked |
-| control-center-smoke | 10 passed, 0 failed |
-
-未发布 npm、未打 git tag、未上传 npm。
-
-## 已知限制
-
-1. **`/api/workspace` 轻量版**：第一版只返回 workspace_root、项目列表（一级子目录）、agents、config 摘要。不做 git 扫描，不返回 repo clean 状态。workspace.html 中 "Repo Clean 状态" 显示为"按需接口待实现"占位。
-2. **task-detail / workspace / audit 为基础接入**：能加载数据并渲染，但未实现全部高级功能（如 diff 高亮、审计证据深度展示）。diff/test-log 仅做文本预览。
-3. **进程控制仅支持 Windows**：`manage-patchwarden.ps1` 为 PowerShell 脚本，POST 控制接口在非 Windows 环境下不可用。`/api/open-logs-folder` 在 macOS/Linux 下会尝试 `open`/`xdg-open`。
-4. **Health 探测端口固定**：Core 探测 `127.0.0.1:8080`，Direct 探测 `127.0.0.1:8081`，暂不支持配置覆盖。
-5. **Control token 生命周期**：token 在服务进程内存中，服务重启后 token 会变化（前端通过 `/control-token.json` 重新获取）。
-6. **日志读取**：仅返回各日志文件尾部 100 行，并对敏感内容脱敏（复用 `redactSensitiveContent`）。