升级日志

新增 roundtable doctor 接入自检，并将项目接入材料收敛为厂商中立的工作流网关模式，保持 Roundtable 开源协议边界清晰。

• 新增 roundtable doctor，检查版本一致性、必需文件、Agent registry、核心角色、示例归档、质量门禁和 benchmark。
• 支持 --json、--project-root、--agent-source 和 --skip-benchmark，方便宿主项目与 CI 消费诊断结果。
• 将接入回归场景统一为 workflow-gateway-integration，继续保持 13/13 benchmark 覆盖。
• README、协议、manifest、集成指南和发行包只描述 Roundtable 自身能力，不绑定具体宿主产品。

把 v1.8.3 的 registry-backed Agent Review 能力推进到可接入、可解释、可回归的项目落地版本，并明确通用工作流门禁位置。

• 新增 integration-guide，说明 Roundtable 在需求分析之后、实现之前的工作流门禁位置。
• 明确宿主工作流通过 review-result.json 消费 continue、needs_human_review 和 blocked。
• 给出 review-result.json、active_agents 和 agent_opinions 的通用接入映射。
• 新增 workflow-gateway-integration benchmark，回归矩阵从 12/12 扩展到 13/13。

补强真实 Agent registry 文件兼容性，让 .markdown / .MARKDOWN、BOM、CRLF frontmatter 和 metadata 变体都能稳定参与 Agent Review。

• Agent 查找支持 .markdown / .MARKDOWN 文件，并对递归 basename 匹配做大小写兼容。
• Agent brief 解析会剥离 UTF-8 BOM、处理 CRLF frontmatter，并支持逗号分隔的标量 metadata 列表。
• 新增 agent-markdown-compat benchmark，验证变体 Agent markdown 仍能生成 source-backed brief_only 评审意见。
• 保持 v1.8 registry-backed Agent Review 契约，继续输出 active_agents 和 agent_opinions 的来源元数据。

强化 security、data、SRE 和 project manager 专家路由，让中英文需求里的高风险信号更容易触发正确专家席位。

• 扩展安全、数据、SRE、项目管理触发词，覆盖更多常见中英文规划和风险描述。
• Standard 评审继续限制最多 2 个额外专家，Full 评审可覆盖全部 4 类专家。
• 新增 agent-specialist-routing benchmark，验证专家选择和评审产物可追踪。

强化 registry 路径和 Agent markdown 解析，降低不同运行时、不同文件系统和不同换行格式带来的接入波动。

• Agent source path 支持 $HOME、~ 和环境变量展开。
• Agent markdown 查找支持大写 .MD 文件。
• Agent brief 解析支持 CRLF frontmatter 和简单 list frontmatter。

Agent Review 从抽象角色升级为可解析真实 Agent registry 的评审契约，明确 selected、brief_only、fallback 和 unavailable 状态。

• roundtable review <input> 会从 AGENCY_AGENTS_HOME、.agents 或兼容目录解析角色 Agent。
• report.json.active_agents[] 记录每个角色的 selected、brief_only、fallback 或 unavailable 状态。
• review-result.json.agent_opinions[] 增加 review_mode、来源元数据、evidence_refs 和 degraded fallback reason。
• quality-check.mjs 新增 Q-026 到 Q-030，校验 active-agent 覆盖、source-backed brief_only、人工复核路由和 fallback 退化行为。

新增 roundtable review <input>，可从需求或分析文件生成完整 Agent Review archive，并在输出前自动验证。

• 新增 review / generate CLI 命令，从输入文件生成 Agent Review archive。
• 生成产物包括 context-pack.json、review-result.json、decisions.json、tasks.json、validation-plan.md、report.md 和 report.json。
• 生成流程完成后自动运行 schema validation 和 quality gate，再报告 archive 路径。
• 新增 generated-agent-review benchmark，覆盖生成式评审归档的基础回归。

在 v1.5 Agent Review 结果契约基础上，补强版本一致性、自动测试、benchmark 稳定性和 npm 发布内容，让协议包发布前后都可验证。

• 协议版本同步到 v1.6.0，并在 README、README.zh-CN、SKILL、manifest 和 roundtable.config.json 中保持一致。
• 新增 check-version.mjs、node --test 测试套件和 npm run ci，覆盖 CLI、benchmark、JSON schema 和版本一致性。
• validate-json.mjs 支持 $ref、allOf、if/then 和 additionalProperties 校验，增强 review-result.json 等契约验证能力。
• run-benchmarks.mjs 增强错误处理、超时、空 benchmark 失败和包内 archive 路径解析。
• npm 包补齐 homepage、repository、bugs、keywords，并清理发布文件清单与历史 test-runs 噪声。

把需求分析后的多 Agent 评审结果落成 review-result.json，使工作流可以稳定消费 continue、needs_human_review 或 blocked。

• 新增 review-result.json schema、template 和 sample archive 示例。
• new-archive.mjs 支持 --mode agent-review --input <requirement-analysis.md> 初始化评审档案。
• quality-check.mjs 新增 Q-021 到 Q-025，校验评审结果、人工复核角色、阻塞理由、continue 安全性和核心角色意见。
• manifest、README、references、scripts 文档和 benchmark 同步 Agent Review 结果契约。
• 站点同步 v1.5 文案，并优化生命周期状态图，减少分支连线交叉。

把 Roundtable 明确升级为需求分析后的多 Agent 评审流程，并补齐风险、审批、修订、版本和质量门禁。

• 新增 Agent Review Mode，默认由产品、架构、开发、QA 等角色评审需求分析结果。
• 评审结论统一为 continue、needs_human_review 或 blocked，便于接入工作流编排。
• 补齐 risk lifecycle、approval、amendment、versioning 和 quality gate 协议章节。
• 新增 Q-001 到 Q-020 质量检查，以及 benchmark 回归场景。
• README 与站点图表统一使用 draw.io 源文件生成的中文 PNG。

小版本补丁：轻接入 CodeGraph，把代码符号、调用图、路由和影响半径作为可选 context-pack 证据，不引入默认依赖。

• 新增 CodeGraph evidence adapter，定位为证据来源，不是专家、决策源或执行器。
• context-pack.json 增加可选 codegraph 字段，记录 enabled、status、index_ref、archive_policy 和 evidence。
• schema、new-archive、sample archive 和 manifest 同步 CodeGraph 槽位。
• 默认关闭，仅建议在 --scan、--full、架构重构和高风险代码路径中启用。
• 索引采用 reference_only 策略，不默认复制 .codegraph/ 到 Roundtable archive。

小版本补丁：保持 v1.3 协议结构不变，补强 agency-agents 在 Codex、Claude Code、Trae 等不同运行时里的路径发现稳定性。

• agency-agents 注册表优先从 AGENCY_AGENTS_HOME 读取。
• 未设置环境变量时回退到 $HOME/agency-agents。
• 新产物继续统一使用 agency://<agent-id> 作为 canonical ref。
• .claude/agents 仅作为 legacy compatibility source。
• roundtable.config.json、manifest、schema、new-archive 和示例 archive 同步 env 字段。

将 Roundtable 从单体协议文档升级为可在 Codex、Claude Code、Trae 中使用的跨平台 skill 包，并收口执行结果语义。

• 新增 execution_result_state：not_executed、executed_unverified、executed_reviewed。
• execution-review.md 仅允许在 executed_reviewed 时生成。
• 新增 Codex / Claude Code / Trae 三端薄适配入口。
• 新增 manifest.json、roundtable.config.json、examples 和 templates。
• 新增 new-archive.mjs 初始化归档骨架。
• 增强 validate-json.mjs，校验 artifact_refs、acceptance_refs 和 execution-review 状态规则。

将 Roundtable 从“决策与交付协议”升级为“决策后执行也可被编排和审计”的操作系统。

• 新增 Superpowers Execution Adapter，定位为执行层而非决策源。
• 新增 execution_method_selection 与 superpowers_execution 节点。
• 按复杂度动态启用：light 不自动启用，mini 条件建议，standard/full 实施流默认启用。
• 新增 --execute-with superpowers 和 --no-superpowers。
• 新增 execution-context.json、execution-plan.md、execution-log.md、execution-review.md。
• 验证契约新增 execution category。

在 v1 基础上补齐审计时间戳、机器可读验收引用、验证枚举和图表归档路径。

• report.json 增加 generated_at 与 last_updated_at。
• decisions.json 增加 decided_at。
• Acceptance Criteria 统一使用 AC-xxx 前缀。
• prototype-review.json 固定 category 枚举。
• --draw 产物路径固定为 diagrams/*.mmd。
• tasks.owner 增加 agent:<id> 命名空间示例。

把 Lovable 绑定升级为可切换的 Prototype Target，默认目标切换到 Pencil，同时保留 Lovable 兼容路径。

• 主交付物从 lovable-handoff.md 升级为 prototype-handoff.md。
• 新增 pencil 与 lovable 目标适配器。
• Pencil 成为默认原型目标。
• Design Intelligence Adapter 作为可选 UI/UX 增强层。
• 建立 report、decisions、tasks、context-pack 等核心 JSON 产物契约。