Praetor Current Development Roadmap

状态：当前执行 checklist，2026-05-25。

这份 roadmap 是接下来实际开发用的控制表。旧的 docs/PRAETOR_PAPERCLIP_MATURITY_ROADMAP.zh-CN.md 已经记录 Paperclip-inspired 成熟化的大方向与许多已完成项目；本文件只追踪从现在开始要继续推进的具体功能。开发规则：一个 phase 一个 phase 做；每个 phase 完成后必须有代码、验证，并做 git commit。

当前原则

[x] Praetor 的定位是 AI 公司本身，不只是 AI 公司管理系统。
[x] 用户管理 Agent；Role 是 Agent 的职责、权限与责任框架。
[x] Agent 之间有上下级关系，任务与会议都必须能追溯 owner。
[x] Workspace 必须是用户本机可浏览的真实文件夹。
[x] CEO 消息不写死 template；所有对话由 AI 在清楚框架下生成。
[x] Paperclip 是 UI/操作成熟度参考，不复制它的产品定位。

Phase 0 - 已完成基础

[x] Project model、project routing、CEO 自动归属 mission 到 project。
[x] Office Dashboard 显示 Project Portfolio。
[x] Project detail 页面显示 stage board、files、meetings、agent activity。
[x] Project progress 使用完成任务数计算：completed missions / total missions。
[x] Project usage aggregation：runs、input/output/total tokens、estimated cost。
[x] Project detail 显示 Usage Ledger：by mission、by agent。
[x] Office Project Portfolio 显示 runs、tokens、cost。
[x] Agent interaction request workflow。
[x] Codex executor section lifecycle 设计：每个任务新 section，不保留 section 上下文。
[x] Agent development review：默认 weekly。
[x] Company Evolution Report。
[x] Browser capability 文档：第一次授权，以后可按用户授权策略使用。

Phase 1 - Premium Dashboard / Project Console

目标：让 Dashboard 与 Project 页面更像高级 AI 公司工作台，清楚、专业、可扫描，接近 Paperclip 的成熟感。

[x] Project 页面加入顶层 command strip：stage、owner、health、next action、open decisions。
[x] Project 页面加入 project settings console：标签、预算、默认 runtime、risk policy、workspace path。
[x] Project 页面加入 timeline：mission、meeting、decision、artifact、agent activity 统一时间线。
[x] Project 页面加入 drill-down filters：只看 blocked、needs decision、active agents、recent outputs。
[x] Project usage ledger 加入 cost window：today、month、project lifetime。
[x] Project usage ledger 支持按 Agent、mission、provider/model 切换视图。
[x] Office Dashboard 的 Project Portfolio 加入健康状态：on track、blocked、needs decision、idle。
[x] Office Dashboard 加入跨项目 progress summary：active projects、finished projects、blocked projects。
[x] UI polish：统一 panel hierarchy、spacing、empty states、loading states、error states。
[x] 验证：rtk npm --prefix apps/web run typecheck。
[x] 验证：rtk npm --prefix apps/web run build。
[x] Commit：Improve project dashboard console。

Phase 2 - File Browser / Workspace Steward

目标：用户可以在 UI 中清楚看到 Praetor 公司的真实文件，且 File System Steward 有明确管理职责。

[x] Workspace browser 显示根目录：Projects、Missions、Wiki、Decisions、Archive。
[x] Workspace browser 支持 project-scoped file view。
[x] Workspace browser 支持 mission-scoped file view。
[x] File detail 支持 preview：Markdown、JSON、plain text。
[x] File detail 显示 absolute host path 与 relative workspace path。
[x] File System Steward 生成 workspace hygiene report。
[x] File System Steward index 显示根目录健康、最近 work products、meeting files、decision files、steward contract。
[x] Hygiene report 检查 meeting linked files 是否遗失或跑出 workspace root。
[x] File System Steward 能建议移动、归档、重命名，但高风险 destructive action 要 approval。
[x] UI 显示 Steward recommendations。
[x] 支持一键打开对应 project/mission folder 的路径提示。
[x] 验证：新增或扩充 workspace/file smoke。
[x] Commit：Add workspace file browser。

Phase 3 - Agent Organization Console

目标：让用户真的感觉自己在管理一间 AI 公司，而不是一组平面 bots。

[x] Agent org chart 支持按 project / mission 过滤。
[x] Agent detail 显示 responsibility chain：reports to、direct reports、meeting owner history。
[x] Agent detail 显示 active sections、recent interaction requests、current blocker。
[x] Agent detail 显示 weekly review summary。
[x] Agent improvement UI 显示 auto-applied improvements 与 evidence。
[x] Agent evaluation 支持 coworkers + manager input。
[x] CEO/manager 能根据 evaluation 自动补强 skill、guidance、guardrails。
[x] 高风险 permission 扩张仍需 owner approval。
[x] 验证：扩充 organization-smoke 或新增 agent-review smoke。
[x] Commit：Improve agent organization console。

Phase 4 - Meetings / Decisions Drill-Down

目标：AI 之间的会议、提案、反对意见、决议和行动项必须变成可操作资产。

[x] Meeting detail 显示 owner of meeting。
[x] Meeting detail 清楚区分 proposal、discussion、dissent、decision、action items。
[x] Meeting action item 可直接连接 mission task。
[x] Meeting decision 可连接 project timeline。
[x] Project detail 显示所有 project-related meetings。
[x] Project detail 显示 decision ledger。
[x] Decision detail 显示 rationale、superseded_by、linked artifacts。
[x] 验证：扩充 meeting-level3-smoke。
[x] Commit：Improve meeting decision console。

Phase 5 - Codex / Browser Execution Controls

目标：Agent 能使用 Codex 与 browser，但权限边界清楚、记录完整、上下文不乱保存。

[x] Codex section UI 显示 section lifecycle：created、running、needs interaction、closed、cleaned。
[x] Codex section 结束时要求 durable summary 写入 mission memory / wiki / artifacts。
[x] Section cleanup record 可审计。
[x] Browser request UI 显示 first-use authorization。
[x] Browser screenshot policy：temporary evidence vs durable artifact。
[x] Browser QA evidence 自动连接 work product / mission / project。
[x] Agent 遇到 Codex interaction request 时按组织图向上升级。
[x] 验证：扩充 interaction request smoke。
[x] Commit：Add executor browser control surface。

Phase 6 - Installation / Onboarding Polish

目标：安装和首次启动尽量接近 Paperclip 的简单、漂亮、直观。

[x] 安装完成页显示 App URL、workspace、doctor、backup、executor setup。
[x] Onboarding 视觉 polish：更少文字、更清楚步骤、更强默认值。
[x] Onboarding 让 workspace root 选择更直观。
[x] Onboarding 展示 AI company 初始组织图。
[x] Onboarding 展示默认 approval boundaries。
[x] Docker / non-Docker 安装路径说明清楚。
[x] Codex in-Docker vs host bridge 决策写入 setup guide。
[x] 验证：install checklist 更新。
[x] Commit：Polish first run installation。

Phase 7 - QA / Release Readiness

目标：大优化后进入一轮真实测试前，先把自动检查和 release evidence 准备好。

[x] 统一 smoke matrix。
[x] 补 docs site build。
[x] 补 API import + route count gate。
[x] 补 frontend typecheck/build。
[x] 补 app smoke。
[x] 补 screenshots 或 manual UI verification path。
[x] 生成 release readiness report。
[x] Commit：Prepare release readiness checks。

Phase 8 - Mission Owner Review Command Center

目标：让 chairman / owner 在 mission detail 中可以像董事长审查一样，一眼看到 CEO briefing、成果、文件、会议、决策、测试、阻塞与下一步。

[x] Mission briefing tab 加入 Owner Decision Center。
[x] Owner Decision Center 显示 mission state、deliverables、verification、meetings 四个核心摘要。
[x] Owner Decision Center 显示 review checklist：CEO briefing、deliverables、verification evidence、meeting decisions、open approvals。
[x] Owner Decision Center 显示 workspace path、changed files、approval blockers。
[x] Owner review actions 保留：continue、stop、request changes、rerun Tester、next mission、promote memory。
[x] Owner review copy 改为要求先看 decision readiness、CEO briefing、delivery evidence、meetings、approvals。
[x] 验证：rtk npm --prefix apps/web run typecheck。
[x] 验证：rtk npm --prefix apps/web run build。
[x] 验证：rtk pixi run app-smoke。
[x] Commit：Polish mission owner review panel。

Phase 9 - Mission Closeout / Memory Promotion UI

目标：任务结束时不只是显示完成，而是让 owner 清楚看到哪些成果被接受、哪些证据被保留、哪些内容会进入 durable company memory、哪些 follow-up 要变成下一步。

[x] 前端新增 MemoryPromotionReview 与 PromotionFinding types。
[x] 前端新增 mission memory promotion API client：list/create。
[x] Mission detail briefing tab 加入 Closeout and Memory Promotion panel。
[x] Closeout panel 显示 closeout stage、accepted artifacts、promotion findings、follow-ups。
[x] Closeout panel 显示 checklist：owner-visible report、accepted/reviewed artifacts、verification retained、memory promotion review。
[x] Closeout panel 支持直接 create/refresh memory promotion review。
[x] Closeout panel 显示 promotion review status、summary、disposition counts、findings。
[x] 验证：rtk npm --prefix apps/web run typecheck。
[x] 验证：rtk npm --prefix apps/web run build。
[x] 验证：rtk pixi run app-smoke。
[x] Commit：Add mission closeout promotion panel。

Phase 10 - Mission Detail Navigation Polish

目标：Mission detail 不再只是长页面和普通 tabs，而是像成熟工作台一样，提供清楚的页面级入口，让 owner 快速进入 review、closeout、files、meetings、runtime、team。

[x] Mission detail header 加入 command rail。
[x] Command rail 显示 Review、Closeout、Files、Meetings、Runtime、Team 六个入口。
[x] 每个入口显示当前状态或数量摘要：approval blockers、promotion findings、artifacts、meeting decisions、runtime attempts、agents/browser QA。
[x] Review / Closeout 入口可跳到 briefing tab 内对应 panel。
[x] 复用现有 mission queries，不新增后端 model/API。
[x] 验证：rtk npm --prefix apps/web run typecheck。
[x] 验证：rtk npm --prefix apps/web run build。
[x] 验证：rtk pixi run app-smoke。
[x] Commit：Polish mission detail navigation。

Phase 11 - Mission Detail Visual QA

目标：用 in-app browser 实际检查 mission detail 在 desktop/mobile 的层级、文字溢出、面板密度和跳转行为，并修正发现的问题。

[x] 使用 in-app browser 以 desktop 视口检查 mission detail command rail、review panel、closeout panel。
[x] 使用 in-app browser 以 mobile 视口检查 mission detail。
[x] 发现并修正 mobile master/detail 问题：有选定 mission 时，detail 应先显示，mission list 移到下方。
[x] 优化 mobile command rail 密度：从单列六张卡改为双栏。
[x] 保留 desktop 左侧 mission list + 右侧 detail 的成熟工作台布局。
[x] 验证：rtk npm --prefix apps/web run typecheck。
[x] 验证：rtk npm --prefix apps/web run build。
[x] 验证：rtk pixi run app-ui-smoke。
[x] 验证：rtk pixi run app-smoke。
[x] Commit：Fix mission detail mobile visual QA。

Phase 12 - Mission Detail Evidence Deep Links

目标：Mission detail 的摘要数字不只显示状态，还能直接跳到对应 evidence section，让 owner 从 review / closeout 摘要快速进入 artifacts、meetings、runtime、promotion findings。

[x] 新增统一的 mission evidence navigation helper：切换 tab 后滚动到 anchor。
[x] Command rail 支持 Files、Meetings、Runtime、Team 的 section anchor。
[x] Review panel 的 Deliverables、Verification、Meetings metric cards 可直接打开对应 evidence。
[x] Closeout panel 的 Accepted artifacts、Promotion findings、Follow-ups metric cards 可直接打开对应 evidence。
[x] Files tab 加入 mission-artifacts anchor。
[x] Meetings tab 加入 mission-meetings-list anchor。
[x] Runtime tab 加入 mission-runtime-runs anchor。
[x] Promotion findings section 加入 mission-promotion-findings anchor。
[x] 验证：rtk npm --prefix apps/web run typecheck。
[x] 验证：rtk npm --prefix apps/web run build。
[x] 验证：rtk pixi run app-smoke。
[x] Commit：Add mission evidence deep links。

Phase 13 - Mission Evidence Empty-State Quality

目标：Mission evidence 为空时不再只是显示 no results，而是清楚说明为什么为空、owner/CEO 下一步要做什么、哪些证据应该进入 workspace 或 durable memory。

[x] 新增统一的 EvidenceEmptyState UI pattern。
[x] Results 空状态说明缺少 CEO closeout summary / result files，以及下一步应该 prepare briefing 或继续 mission。
[x] Run replay 空状态说明缺少 executor replay context，并提示继续 mission / rerun Tester。
[x] Run replay 的 logs、changed files、tests、approvals、jobs 空状态改成 actionable copy。
[x] Closeout checklist 的 verification retained 空状态改成要求 rerun Tester 或记录 Browser QA。
[x] Promotion review 空状态说明 durable memory promotion review 尚未生成，并提供 Create review 入口。
[x] Promotion findings section 即使没有 findings 也保留 anchor 与说明，避免 deep link 跳到空位置。
[x] Board briefing 的 completed work、changed files、tests、artifacts 空状态改成 owner 可行动说明。
[x] Browser QA 空状态说明缺少 viewport checks / screenshots / external QA links，并提示使用 request form。
[x] Files tab 的 artifacts / result files 空状态说明缺少 durable work products，并提示 CEO link workspace files。
[x] 验证：rtk npm --prefix apps/web run typecheck。
[x] 验证：rtk npm --prefix apps/web run build。
[x] 验证：rtk pixi run app-smoke。
[x] Commit：Improve mission evidence empty states。

Phase 14 - Mission Evidence Ledger Polish

目标：把 mission detail 里分散在 artifacts、tests、Browser QA、meetings、promotion findings 的证据整理成统一 ledger，让 owner 可以从一个视图审查证据链，并快速跳回原始证据区域。

[x] Mission detail 新增 Evidence tab。
[x] Command rail 新增 Evidence 入口，显示已链接证据数量。
[x] Evidence ledger 聚合 work products / result files / run tests / Browser QA / meetings / memory promotion findings。
[x] Evidence ledger 提供 artifacts、verification、meetings、promotion 四个摘要数字。
[x] Evidence ledger 提供 search、type filter、status filter。
[x] 每个 evidence card 显示类型、状态、日期、来源、说明、路径。
[x] 每个 evidence card 支持 Open source，跳回 files / runs / Browser QA / meetings / promotion findings 原始区域。
[x] Browser QA evidence section 新增 mission-browser-qa-evidence anchor。
[x] Evidence ledger 空状态说明没有 evidence 或当前 filter 没有结果时的下一步。
[x] 验证：rtk npm --prefix apps/web run typecheck。
[x] 验证：rtk npm --prefix apps/web run build。
[x] 验证：rtk pixi run app-smoke。
[x] Commit：Add mission evidence ledger。

Phase 15 - Mission Evidence Visual QA

目标：实际检查 Evidence tab / command rail 在 desktop 和 mobile 的密度、筛选控件、文字溢出和 source jump 行为，并修正发现的问题。

[x] 尝试使用 Codex in-app browser；当前 session 未暴露 browser skill 所需的 Node browser control tool，因此改用本地 Playwright visual QA fallback。
[x] 使用 app-smoke 资料集启动 mission detail，检查 Evidence tab 有 artifacts / verification / meetings / promotion 摘要。
[x] Desktop 截图检查 Evidence tab、command rail、filter controls、evidence cards。
[x] Mobile 截图检查 detail-first layout、Evidence tab、filter controls、evidence cards、mission list fallback。
[x] 验证 Open source 从 test evidence 跳回 Run replay context。
[x] 验证 search/filter 无结果时显示 actionable empty state。
[x] 修正 command rail：Evidence 加入后不再使用过窄 7 栏，desktop 改成稳定 4 栏。
[x] 修正 Evidence filter controls：input/select 加入 min-w-0 与 w-full，避免窄宽度挤压。
[x] 验证：Phase 15 Playwright visual QA fallback。
[x] 验证：rtk npm --prefix apps/web run typecheck。
[x] 验证：rtk npm --prefix apps/web run build。
[x] 验证：rtk pixi run app-ui-smoke。
[x] 验证：rtk pixi run app-smoke。
[x] Commit：Polish mission evidence visual QA。

Phase 16 - Mission Evidence Ledger Data Model

目标：把 frontend-only ledger 抽成后端 mission evidence endpoint，减少前端聚合逻辑，并让 Web UI、API、connector、CEO 外部入口都能读取同一份证据链。

[x] 后端新增 MissionEvidenceKind / MissionEvidenceTarget / MissionEvidenceEntry / MissionEvidenceLedger models。
[x] 后端新增 PraetorService.mission_evidence_ledger() 聚合 work products / result files / run tests / Browser QA / meetings / memory promotion findings。
[x] 后端新增 /api/missions/{mission_id}/evidence endpoint。
[x] 前端新增 MissionEvidenceLedger / MissionEvidenceEntry / MissionEvidenceKind types。
[x] 前端新增 getMissionEvidence() API client 与 qk.missionEvidence() query key。
[x] Mission detail refresh flow 会 invalidate mission evidence query。
[x] Evidence tab 改为读取 backend ledger，不再在前端重复聚合所有 evidence source。
[x] app-smoke 新增 evidence endpoint gate，确认 ledger 至少包含 artifact / result_file / test / meeting / promotion。
[x] 验证：rtk pixi run app-import-check。
[x] 验证：rtk npm --prefix apps/web run typecheck。
[x] 验证：rtk npm --prefix apps/web run build。
[x] 验证：rtk pixi run app-smoke。
[x] Commit：Add mission evidence API。

当前建议开发顺序

[x] Phase 1：Premium Dashboard / Project Console。
[x] Phase 2：File Browser / Workspace Steward。
[x] Phase 3：Agent Organization Console。
[x] Phase 4：Meetings / Decisions Drill-Down。
[x] Phase 5：Codex / Browser Execution Controls。
[x] Phase 6/7：安装体验 polish 与 release readiness。
[x] Phase 8：Mission Owner Review Command Center。
[x] Phase 9：Mission Closeout / Memory Promotion UI。
[x] Phase 10：Mission Detail Navigation Polish。
[x] Phase 11：Mission Detail Visual QA。
[x] Phase 12：Mission Detail Evidence Deep Links。
[x] Phase 13：Mission Evidence Empty-State Quality。
[x] Phase 14：Mission Evidence Ledger Polish。
[x] Phase 15：Mission Evidence Visual QA。
[x] Phase 16：Mission Evidence Ledger Data Model。
[x] 当前 roadmap 已完成：没有未完成 phase。

Post-Roadmap Backlog

这一段是下一轮成熟化路线，目标是把已有系统从「功能存在」继续推进到「像一间真实 AI 公司一样可运营、可发布、可安装、可外部接入」。

Phase 17 - Company Evolution Board Polish

目标：把已存在的 Agent Development Review / Company Evolution Report 做成 owner 一眼能看懂的公司成长面板，显示能力成长、风险降低、自动改进、下一轮观察重点和历史报告。

[x] Company Evolution panel 显示 period / cadence / created_by。
[x] Company Evolution panel 显示 agent improvements 列表。
[x] Company Evolution panel 显示 skills added、guardrails added、risks reduced。
[x] Company Evolution panel 显示 next observation focus。
[x] Company Evolution panel 显示最近报告历史。
[x] 空状态说明如何生成 report。
[x] 验证：rtk npm --prefix apps/web run typecheck。
[x] 验证：rtk npm --prefix apps/web run build。
[x] 验证：rtk pixi run python tools/agent_development_review_smoke.py。
[x] 验证：rtk pixi run python tools/company_evolution_report_smoke.py。
[x] Commit：Polish company evolution board。

Phase 18 - Release Readiness Packaging

目标：把 release readiness 从一次性检查扩展成清楚的发布流程：版本、验证矩阵、已知风险、安装验证、artifact 清单。

[x] Release readiness report 纳入 mission evidence endpoint。
[x] Release checklist 增加 installer、API route count、frontend build、app smoke、UI smoke、API smoke。
[x] Developer setup 标清楚 release 前后动作。
[x] QA smoke matrix 标出 mission evidence ledger gate。
[x] 验证：rtk pixi run release-readiness。
[x] Commit：Polish release readiness packaging。

Phase 19 - Installer First-Run Polish

目标：继续靠近 Paperclip 风格的一键安装体验，让 Docker / non-Docker / Codex bridge / workspace root 的选择更清楚。

[x] README 安装路径更短、更直接。
[x] First-run setup guide 对 Docker 与 host Codex bridge 的边界更明确。
[x] 安装 checklist 补 workspace visibility 与 File System Steward。
[x] 验证：rtk pixi run docs-site。
[x] Commit：Polish first-run installer docs。

Phase 20 - CEO External Entry Foundation

目标：为之后 connector 做基础，不先实现所有通信 app，而是定义一个统一的外部 CEO 对话入口，让 UI、terminal、未来 connector 都走同一条路径。

[x] 定义外部 CEO message intake contract。
[x] API 支持创建 CEO conversation message 并返回 session / mission links。
[x] Terminal helper 或 docs 展示如何从 Web UI 外跟 CEO 对话。
[x] 验证：rtk pixi run python tools/ceo_external_entry_smoke.py。
[x] 验证：rtk pixi run app-import-check。
[x] 验证：rtk npm --prefix apps/web run typecheck。
[x] 验证：rtk npm --prefix apps/web run build。
[x] 验证：rtk pixi run docs-site。
[x] Commit：Add CEO external entry foundation。

Phase 21 - Connector Backlog Planning

目标：把 Slack / Teams / Telegram / email 等 connector 降低为薄薄的入口层，只负责把消息送到 CEO external entry，并把 CEO 回复送回原 app。

[x] 列出 connector 能力边界。
[x] 定义 connector risk / approval policy。
[x] 定义每个 connector 的最小可用模式。
[x] Connector status metadata 标出 entry contract、minimum mode、risk policy。
[x] 验证：rtk pixi run python tools/connector_backlog_smoke.py。
[x] 验证：rtk pixi run app-import-check。
[x] 验证：rtk pixi run docs-site。
[x] Commit：Plan CEO connector backlog。

Phase 22 - Runtime Model Routing Policy

目标：先建立保守、provider-neutral 的模型分派策略，不急着自建 subagent orchestration。

[x] 决策：内部使用 fast / standard / reasoning / critical model profiles，不在 mission/agent 层硬编码 provider model name。
[x] 决策：复杂度不确定时保守使用 reasoning；高风险治理、security、privacy、legal、finance、credentials、runtime、final review 使用 critical。
[x] 决策：Praetor v1 不管理 first-party subagent lifecycle；开发与研究任务可允许 Codex / Claude Code 使用 executor-native subagents。
[x] 文档：新增 docs/ADR-003-model-routing-and-native-subagents.md。
[x] 文档：更新 system spec、repo architecture、executor bridge spec、user manual。
[ ] 实作：Runtime settings 支持 provider profile mapping。
[ ] 实作：Mission / agent assignment 记录 model_profile 与 routing reason。
[ ] 实作：Executor task spec 带 native_subagents policy，并在 result 中记录 native subagent usage summary。

每轮开发固定流程

[ ] 选择本文件中一个 phase 或一个小 vertical slice。
[ ] 实作 backend model/service/API，如需要。
[ ] 实作 frontend UI。
[ ] 补 smoke/typecheck/build。
[ ] 更新本文件 checkbox。
[ ] git commit。