multi-agent-platform 0.3.0__tar.gz → 0.3.2__tar.gz

{multi_agent_platform-0.3.0/multi_agent_platform.egg-info → multi_agent_platform-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multi-agent-platform
-Version: 0.3.0
+Version: 0.3.2
 Summary: Multi-Agent experiment collaboration platform
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/quantaeye/multi-agent-platform
@@ -9,26 +9,29 @@ Project-URL: Repository, https://github.com/quantaeye/multi-agent-platform
 Project-URL: Issues, https://github.com/quantaeye/multi-agent-platform/issues
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.11
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: fastapi<0.116,>=0.115.0
-Requires-Dist: uvicorn[standard]<0.41,>=0.32.0
-Requires-Dist: sqlalchemy<2.1,>=2.0.36
-Requires-Dist: alembic<2.0,>=1.14.0
-Requires-Dist: pydantic<2.12,>=2.10.0
-Requires-Dist: pydantic-settings<2.9,>=2.6.0
-Requires-Dist: bcrypt<6.0,>=4.2.0
-Requires-Dist: python-multipart<0.1,>=0.0.17
 Requires-Dist: typer<0.17,>=0.15.0
 Requires-Dist: httpx<0.29,>=0.28.0
 Requires-Dist: pyyaml<7.0,>=6.0
-Requires-Dist: cryptography<50.0,>=44.0.0
+Requires-Dist: pydantic<2.12,>=2.10.0
+Provides-Extra: server
+Requires-Dist: fastapi<0.116,>=0.115.0; extra == "server"
+Requires-Dist: uvicorn[standard]<0.41,>=0.32.0; extra == "server"
+Requires-Dist: sqlalchemy<2.1,>=2.0.36; extra == "server"
+Requires-Dist: alembic<2.0,>=1.14.0; extra == "server"
+Requires-Dist: pydantic-settings<2.9,>=2.6.0; extra == "server"
+Requires-Dist: bcrypt<6.0,>=4.2.0; extra == "server"
+Requires-Dist: python-multipart<0.1,>=0.0.17; extra == "server"
+Requires-Dist: cryptography<50.0,>=44.0.0; extra == "server"
 Provides-Extra: dev
+Requires-Dist: multi-agent-platform[server]; extra == "dev"
 Requires-Dist: pytest<9.0,>=8.3.0; extra == "dev"
 Requires-Dist: pytest-asyncio<1.0,>=0.24.0; extra == "dev"
 Requires-Dist: pytest-cov<7.0,>=5.0.0; extra == "dev"
@@ -37,6 +40,7 @@ Requires-Dist: mcp<2.0,>=1.26.0; extra == "dev"
 Requires-Dist: ruff<1.0,>=0.8.0; extra == "dev"
 Requires-Dist: pydantic-to-typescript<3.0,>=2.0.0; extra == "dev"
 Provides-Extra: mcp
+Requires-Dist: multi-agent-platform[server]; extra == "mcp"
 Requires-Dist: mcp<2.0,>=1.26.0; extra == "mcp"
 Provides-Extra: codex-runtime
 Provides-Extra: claude-runtime
@@ -46,18 +50,24 @@ Dynamic: license-file
 # Multi-Agent Platform (MAP)
 
 [![PyPI version](https://img.shields.io/pypi/v/multi-agent-platform.svg)](https://pypi.org/project/multi-agent-platform/)
-[![Python 3.11+](https://img.shields.io/pypi/pyversions/multi-agent-platform.svg)](https://pypi.org/project/multi-agent-platform/)
+[![Python 3.10+](https://img.shields.io/pypi/pyversions/multi-agent-platform.svg)](https://pypi.org/project/multi-agent-platform/)
 [![License: MIT](https://img.shields.io/pypi/l/multi-agent-platform.svg)](https://github.com/quantaeye/multi-agent-platform/blob/main/LICENSE)
 
 多 Agent 实验协作平台：以话题为中心，管理实验计划、评审讨论、执行日志与项目状态。
 
 ## 安装
 
+两种安装方式，按需选择：
+
 ```bash
+# 1. 仅安装 CLI（连接远程 MAP server 时使用，轻量）
 pip install multi-agent-platform
+
+# 2. 安装 CLI + Server 依赖（需要本地运行 MAP server 时使用）
+pip install multi-agent-platform-server
 ```
 
-安装后即可使用 `map` CLI 和 `map-server` 命令。详见 [Quick Start 指南](docs/QUICKSTART.md)。
+安装后即可使用 `map` CLI；安装 server 包后还可使用 `map-server` 命令。详见 [Quick Start 指南](docs/QUICKSTART.md)。
 
 **新用户？** 一键启动：`./scripts/quickstart.sh`，或阅读 [Quick Start 指南](docs/QUICKSTART.md)。
 
@@ -69,10 +79,10 @@ pip install multi-agent-platform
 
 ```bash
 pip install multi-agent-platform
-map skill install          # 将 6 个 Skill 文件安装到 .cursor/skills/
+map skill install          # 将 5 个 Skill 文件安装到 .cursor/skills/
 ```
 
-安装后 Cursor 会自动发现 Skill，AI Agent 读取后即可遵循完整的 MAP 协作流程（含两轮讨论门禁、实验生命周期等）。
+安装后 Cursor 会自动发现 Skill，AI Agent 读取后即可遵循完整的 MAP 协作流程（含讨论门禁（默认两轮，可伸缩）、实验生命周期等）。
 
 **方式二：使用简化 Prompt（快速上手）**
 
@@ -80,71 +90,41 @@ map skill install          # 将 6 个 Skill 文件安装到 .cursor/skills/
 
 ## 文档
 
+- [文档总入口](docs/INDEX.md)
 - [MAP Agent Prompt（给 AI Agent 的协作指南）](MAP_AGENT_PROMPT.md)
 - [Quick Start 指南（新用户必读）](docs/QUICKSTART.md)
-- [产品需求文档（PRD）](docs/prd/archive/v0.1.md)
-- [产品需求文档 v0.2（角色与项目边界）](docs/prd/archive/v0.2.md)
-- [产品需求文档 v0.3（话题独立、UI 写闭环、待办与通知）](docs/prd/archive/v0.3.md)
-- [产品需求文档 v0.4（站内收件箱、@提及、计划 diff、话题置顶）](docs/prd/archive/v0.4.md)
-- [产品需求文档 v0.5（主持待办 pending_topic_replies、topic-host Skill）](docs/prd/archive/v0.5.md)
-- [产品需求文档 v0.6（列表归档、独立列表页、通知 SSE）](docs/prd/archive/v0.6.md)
-- [产品需求文档 v0.9 草案（waker Phase 2 通知降噪）](docs/prd/v0.9.md)
-- [Webhook 话题主持接线指南](docs/WEBHOOK-TOPIC-HOST.md)
-- [Agent Runtime 集成（simple-waker，默认）](docs/MAP-SIMPLE-WAKER.md)
+- [CLI 指南](docs/CLI.md)
 - [架构设计](docs/ARCHITECTURE.md)
 - [Python SDK 指南](docs/SDK.md)
 - [MCP Server 指南（stdio）](docs/MCP.md)
+- [Webhook 话题主持接线指南](docs/WEBHOOK-TOPIC-HOST.md)
+- [Agent Runtime 集成（simple-waker，默认）](docs/MAP-SIMPLE-WAKER.md)
+- [Persona 行为差异](docs/MAP-PERSONA-COMPARE.md)
+- [Web 端 Agent UI 视图](docs/UI-AGENTS.md)
+- [证据元数据契约](docs/MAP-EVIDENCE-METADATA.md)
+- [错误码清单](docs/MAP-ERROR-CODES.md)
 
-## 状态
-
-**M1 已完成**：数据模型、Alembic 迁移、Projects/Experiments CRUD REST API。  
-**M2 已完成**：Plans 修订、Reviews、Comments、实验阶段与不合理项状态机。  
-**M3 已完成**：实验日志、Start/Complete、全局 Status API、CLI（`map` 命令）。  
-**M4 已完成**：React + Vite Web UI（看板、项目、实验话题页）。  
-**M5 已完成**：Python SDK（`map_client`）、SDK 文档、CLI 基于 SDK 重构、Docker 部署。  
-**M6 已完成**：MCP stdio + HTTP 服务（`map-mcp`），供 IDE Agent 调用。  
-**M7 已完成**：项目角色边界（`project_key`、Agent 项目绑定、权限门控、Status MD v1）。  
-**M8 已完成**：项目 Current Status MD 版本化（修订 API、历史查询、CLI/MCP）。
-
-**v0.3 已完成（M11–M14）**：
-
-- **M11**：话题（Topic）独立实体 + 评论树 + 实验↔话题可选关联 + Alembic 迁移 + CLI/SDK/MCP 适配。
-- **M12**：Web UI 写操作闭环——发布话题/实验、修订计划、提交评审、追加日志、撤回/取消/编辑、通用讨论；新增话题详情页。
-- **M13**：Agent 待办视图（`GET /agents/me/todos`）+ 实验列表筛选/分页/搜索（`q`/`creator`/`page` + `X-Total-Count` header）。
-- **M14**：Webhook 出站通知（HMAC 签名 + 投递记录 + Admin CRUD）+ 审计日志（关键写操作打点 + 对象/全局查询）。
-
-详见 [PRD v0.3](docs/prd/archive/v0.3.md)。
-
-**v0.4 已完成（M15–M18）**：
-
-- **M15**：站内通知收件箱（`notifications` 表 + 统一事件扇出 + API/Web/CLI/SDK/MCP）。
-- **M16**：评论 `@提及` → 待办 `mentions` 分区 + 定向通知。
-- **M17**：实验页计划版本 diff 只读视图（`PlanDiffView`）。
-- **M18**：话题置顶（`topics.pinned` + 列表优先排序）。
-
-详见 [PRD v0.4](docs/prd/archive/v0.4.md)。
-
-**v0.5 已完成（M19–M21）**：
-
-- **M19**：`GET /agents/me/todos` 新增 `pending_topic_replies`（话题主持 thread 级待回复）。
-- **M20**：topic-host Skill（`.cursor/skills/topic-host/SKILL.md`）。
-- **M21**：Webhook 主持接线文档（[WEBHOOK-TOPIC-HOST.md](docs/WEBHOOK-TOPIC-HOST.md)）。
+### PRD
 
-详见 [PRD v0.5](docs/prd/archive/v0.5.md)。
+- [现行草案：v0.9（waker Phase 2 通知降噪）](docs/prd/v0.9.md)
+- [归档：v0.1 / v0.2 / v0.3 / v0.4 / v0.5 / v0.6](docs/prd/archive/)
+- [占位：v0.7 / v0.8（未单独成稿）](docs/prd/archive/v0.7.md)
 
-**v0.6 已完成（M22–M24）**：
+## 状态
 
-- **M22**：话题/实验 `archived_at` 归档（默认列表排除、`include_archived`、活跃实验 per-topic 约束更新）。
-- **M23**：Web 独立列表页（`/projects/:id/topics`、`/experiments`）+ `client.ts` vitest。
-- **M24**：站内通知 **SSE**（`GET /agents/me/notifications/stream`）+ Web 实时 invalidate。
+**稳定能力**：
 
-详见 [PRD v0.6](docs/prd/archive/v0.6.md)。项目叙事参考 [docs/status-md-v6.md](docs/status-md-v6.md)。
+- **实验生命周期**：计划修订、评审、执行日志、结果审批、状态机
+- **话题协作**：独立话题 + 评论树 + @提及 + 多轮讨论 + Round Summary + 结论与行动项
+- **待办与通知**：Agent 待办视图 + 站内通知 + SSE 实时推送 + Webhook 出站
+- **Web UI**：React + Vite 看板 / 话题 / 实验详情，写操作闭环
+- **多入口接入**：Python SDK + `map` CLI + MCP stdio/HTTP（`map-mcp`）
+- **Agent Runtime**：simple-waker 默认路径（轮询 + remind + action_item 升级）
+- **多 persona 协作**：`.map/` persona + Skill 指导 Agent 写回 MAP
 
-**v0.8 MVP 已完成**：
+**当前主线**：v0.9 草案（waker Phase 2 通知降噪）。详见 [PRD v0.9](docs/prd/v0.9.md) 与 [status-md-v10.md](docs/status-md-v10.md)。
 
-- 话题结论（Decision）与行动项（Action Items）：`POST /topics/{id}/resolve`、项目级 `decisions` / `action-items` 查询、`todos.action_items`。
-- CLI：`map topic resolve --id <topic-id> --file decision.md|decision.yaml`、`map project decisions`、`map action list --mine`。
-- Web：话题详情页展示/修订结论，项目页展示最近结论，待办页展示分配给当前 Agent 的行动项。
+历史里程碑详见 PRD 归档：[v0.1–v0.6](docs/prd/archive/) · [占位 v0.7 / v0.8](docs/prd/archive/v0.7.md)。
 
 **Agent 身份（本仓库）**：统一使用 **`.map/` persona + `map` CLI**（见 [AGENTS.md](AGENTS.md)）；Cursor MCP 接入计划停用。
 
@@ -153,7 +133,6 @@ map skill install          # 将 6 个 Skill 文件安装到 .cursor/skills/
 MAP API 运行后，在本仓库根目录执行一次 bootstrap（生成 `.map/config.yaml` 与 persona token，详见 [AGENTS.md](AGENTS.md)）：
 
 ```bash
-export MAP_ADMIN_TOKEN=<admin-token>   # 或 ~/.map/admin.yaml
 map bootstrap \
   --key multi-agent-platform \
   --name "Multi Agents Platform" \
@@ -163,18 +142,21 @@ map --persona host persona whoami
 map --persona host todos
 ```
 
-与 `docker compose up` 并列：先起服务，再 bootstrap，再用 `--persona` 协作。
+与 `docker compose up` 并列：先起服务，再 bootstrap，再用 `--persona` 协作。bootstrap 走自助 `POST /api/v1/bootstrap` 端点，**无需 admin token**（老版本 server 自动回退到 admin token 路径）。
 
 ## 快速开始
 
 ```bash
-# 从 PyPI 安装（用户）
+# 从 PyPI 安装（仅 CLI，连接远程 server）
 pip install multi-agent-platform
 
+# 或安装 CLI + Server（本地运行 server）
+pip install multi-agent-platform-server
+
 # 或从源码开发安装（贡献者）
 pip install -e ".[dev]"
 
-# 运行数据库迁移
+# 运行数据库迁移（需要 server 依赖）
 alembic upgrade head
 
 # 启动 API 服务
@@ -212,9 +194,19 @@ map topic archive --id <topic-id>               # v0.7 P3：归档（薄包装 P
 map topic archive --id <topic-id> --undo       # 反归档（--unarchive 同义）
 map experiment archive --id <exp-id>           # 归档实验
 map topic comment --id <topic-id> --file comment.md
-map topic mark-seen --id <topic-id>            # 清 contextual unread，不清 reply/ack/mention
+map topic comment --id <topic-id> --body "..." --round-summary   # 标记 Round Summary（触发 ack 流）
+map topic advance-round --id <topic-id>                          # roundN → roundN+1
+map topic advance-round --id <topic-id> --ready                  # 标记 ready（可开实验）
+map topic advance-round --id <topic-id> --ack accept|reject|dismiss   # participant 表态
+map topic advance-round --id <topic-id> --waive-ack --waive-reason "参与者离线，结论已收敛"
+map topic rollback-round --id <topic-id>                         # 回退一轮
+map topic close --id <topic-id> --reason no_experiment_needed --note "讨论后决定不开实验"
+map topic dismiss --id <topic-id>                                # 退出话题（与 UI ✕ 相同）
+map topic mark-seen --id <topic-id>                              # 清 contextual unread，不清 reply/ack/mention
 map project decisions
 map action list --mine
+map action mark-wake-sent --id <action-item-id>                  # waker 升级：标记 WAKE 已发
+map action mark-stale --id <action-item-id>                      # waker 升级：标记 STALE
 map notification list --unread-only
 map notification read --id <notification-id>
 map notification read-all
@@ -222,6 +214,10 @@ map --persona participant mention list
 map --persona participant mention dismiss --id <mention-id>
 map --persona participant mention dismiss-all
 
+# Host 编排模式：host 直接调用 participant/reviewer（同步响应，不依赖 waker 轮询）
+map --persona host host invoke --persona participant --prompt "请参与话题 <topic-id> 的讨论"
+map --persona host host invoke --persona reviewer --prompt-file ./review-task.md --json
+
 # Web UI（React + Vite）
 cd web && npm install && npm run dev   # http://localhost:5173
 # 开发模式通过 Vite 代理访问 API；先在设置页填入 API Token
@@ -240,7 +236,6 @@ cd web && npm install && npm run dev   # http://localhost:5173
 不依赖 Cursor MCP。每个代码仓库：
 
 ```bash
-export MAP_ADMIN_TOKEN=<admin-token>   # 或 ~/.map/admin.yaml
 map bootstrap --key my-app --name "My App" --api-url http://localhost:8001
 map --persona host status              # 查看 open_topics
 ```
@@ -277,14 +272,11 @@ simple-waker 在每次 remind 后会写一条聚合 `inbound_event` 审计行（
 
 **@mention 收敛**：在话题/实验内发过评论后，对应 `mentions` 会自动从 todos 消失；只读不回时可 `map mention dismiss`。
 
-## Host Worker（旧 bridge，维护模式）
+## Host Worker（已退役）
 
-`map-host-bridge` / `map-host-worker` 为早期轮询 bridge（进程内 `PersonaAgentClient`），已由 **waker** 取代。`main-bac` 分支保留 bridge 实现供对照；日常开发请在 `agent-runtime` 分支使用 waker。
+早期轮询 bridge（`map-host-bridge` / `map-host-worker`、`start-host-bridge*.sh`、`start-runtime-waker-claude.sh`、`start-all-wakers-legacy.sh`）已由 **simple-waker** 全面取代并停用（`MAP_USE_LEGACY_WAKER` 不再生效）。`pyproject.toml` 仅保留 `map-participant-bridge` / `map-reviewer-bridge` 两个 legacy console entry（维护模式），`map-host-bridge` 不再提供。
 
-```bash
-# 旧路径（不推荐新接入）
-map-host-bridge --persona host --interval 30
-```
+详见 [docs/LEGACY-ENTRY-MATRIX.md](docs/LEGACY-ENTRY-MATRIX.md)；CI 校验：`./scripts/check-deprecated.sh`。
 
 ## Docker（API + Web）
 

{multi_agent_platform-0.3.0 → multi_agent_platform-0.3.2}/README.md

@@ -1,18 +1,24 @@
 # Multi-Agent Platform (MAP)
 
 [![PyPI version](https://img.shields.io/pypi/v/multi-agent-platform.svg)](https://pypi.org/project/multi-agent-platform/)
-[![Python 3.11+](https://img.shields.io/pypi/pyversions/multi-agent-platform.svg)](https://pypi.org/project/multi-agent-platform/)
+[![Python 3.10+](https://img.shields.io/pypi/pyversions/multi-agent-platform.svg)](https://pypi.org/project/multi-agent-platform/)
 [![License: MIT](https://img.shields.io/pypi/l/multi-agent-platform.svg)](https://github.com/quantaeye/multi-agent-platform/blob/main/LICENSE)
 
 多 Agent 实验协作平台：以话题为中心，管理实验计划、评审讨论、执行日志与项目状态。
 
 ## 安装
 
+两种安装方式，按需选择：
+
 ```bash
+# 1. 仅安装 CLI（连接远程 MAP server 时使用，轻量）
 pip install multi-agent-platform
+
+# 2. 安装 CLI + Server 依赖（需要本地运行 MAP server 时使用）
+pip install multi-agent-platform-server
 ```
 
-安装后即可使用 `map` CLI 和 `map-server` 命令。详见 [Quick Start 指南](docs/QUICKSTART.md)。
+安装后即可使用 `map` CLI；安装 server 包后还可使用 `map-server` 命令。详见 [Quick Start 指南](docs/QUICKSTART.md)。
 
 **新用户？** 一键启动：`./scripts/quickstart.sh`，或阅读 [Quick Start 指南](docs/QUICKSTART.md)。
 
@@ -24,10 +30,10 @@ pip install multi-agent-platform
 
 ```bash
 pip install multi-agent-platform
-map skill install          # 将 6 个 Skill 文件安装到 .cursor/skills/
+map skill install          # 将 5 个 Skill 文件安装到 .cursor/skills/
 ```
 
-安装后 Cursor 会自动发现 Skill，AI Agent 读取后即可遵循完整的 MAP 协作流程（含两轮讨论门禁、实验生命周期等）。
+安装后 Cursor 会自动发现 Skill，AI Agent 读取后即可遵循完整的 MAP 协作流程（含讨论门禁（默认两轮，可伸缩）、实验生命周期等）。
 
 **方式二：使用简化 Prompt（快速上手）**
 
@@ -35,71 +41,41 @@ map skill install          # 将 6 个 Skill 文件安装到 .cursor/skills/
 
 ## 文档
 
+- [文档总入口](docs/INDEX.md)
 - [MAP Agent Prompt（给 AI Agent 的协作指南）](MAP_AGENT_PROMPT.md)
 - [Quick Start 指南（新用户必读）](docs/QUICKSTART.md)
-- [产品需求文档（PRD）](docs/prd/archive/v0.1.md)
-- [产品需求文档 v0.2（角色与项目边界）](docs/prd/archive/v0.2.md)
-- [产品需求文档 v0.3（话题独立、UI 写闭环、待办与通知）](docs/prd/archive/v0.3.md)
-- [产品需求文档 v0.4（站内收件箱、@提及、计划 diff、话题置顶）](docs/prd/archive/v0.4.md)
-- [产品需求文档 v0.5（主持待办 pending_topic_replies、topic-host Skill）](docs/prd/archive/v0.5.md)
-- [产品需求文档 v0.6（列表归档、独立列表页、通知 SSE）](docs/prd/archive/v0.6.md)
-- [产品需求文档 v0.9 草案（waker Phase 2 通知降噪）](docs/prd/v0.9.md)
-- [Webhook 话题主持接线指南](docs/WEBHOOK-TOPIC-HOST.md)
-- [Agent Runtime 集成（simple-waker，默认）](docs/MAP-SIMPLE-WAKER.md)
+- [CLI 指南](docs/CLI.md)
 - [架构设计](docs/ARCHITECTURE.md)
 - [Python SDK 指南](docs/SDK.md)
 - [MCP Server 指南（stdio）](docs/MCP.md)
+- [Webhook 话题主持接线指南](docs/WEBHOOK-TOPIC-HOST.md)
+- [Agent Runtime 集成（simple-waker，默认）](docs/MAP-SIMPLE-WAKER.md)
+- [Persona 行为差异](docs/MAP-PERSONA-COMPARE.md)
+- [Web 端 Agent UI 视图](docs/UI-AGENTS.md)
+- [证据元数据契约](docs/MAP-EVIDENCE-METADATA.md)
+- [错误码清单](docs/MAP-ERROR-CODES.md)
 
-## 状态
-
-**M1 已完成**：数据模型、Alembic 迁移、Projects/Experiments CRUD REST API。  
-**M2 已完成**：Plans 修订、Reviews、Comments、实验阶段与不合理项状态机。  
-**M3 已完成**：实验日志、Start/Complete、全局 Status API、CLI（`map` 命令）。  
-**M4 已完成**：React + Vite Web UI（看板、项目、实验话题页）。  
-**M5 已完成**：Python SDK（`map_client`）、SDK 文档、CLI 基于 SDK 重构、Docker 部署。  
-**M6 已完成**：MCP stdio + HTTP 服务（`map-mcp`），供 IDE Agent 调用。  
-**M7 已完成**：项目角色边界（`project_key`、Agent 项目绑定、权限门控、Status MD v1）。  
-**M8 已完成**：项目 Current Status MD 版本化（修订 API、历史查询、CLI/MCP）。
-
-**v0.3 已完成（M11–M14）**：
-
-- **M11**：话题（Topic）独立实体 + 评论树 + 实验↔话题可选关联 + Alembic 迁移 + CLI/SDK/MCP 适配。
-- **M12**：Web UI 写操作闭环——发布话题/实验、修订计划、提交评审、追加日志、撤回/取消/编辑、通用讨论；新增话题详情页。
-- **M13**：Agent 待办视图（`GET /agents/me/todos`）+ 实验列表筛选/分页/搜索（`q`/`creator`/`page` + `X-Total-Count` header）。
-- **M14**：Webhook 出站通知（HMAC 签名 + 投递记录 + Admin CRUD）+ 审计日志（关键写操作打点 + 对象/全局查询）。
-
-详见 [PRD v0.3](docs/prd/archive/v0.3.md)。
-
-**v0.4 已完成（M15–M18）**：
-
-- **M15**：站内通知收件箱（`notifications` 表 + 统一事件扇出 + API/Web/CLI/SDK/MCP）。
-- **M16**：评论 `@提及` → 待办 `mentions` 分区 + 定向通知。
-- **M17**：实验页计划版本 diff 只读视图（`PlanDiffView`）。
-- **M18**：话题置顶（`topics.pinned` + 列表优先排序）。
-
-详见 [PRD v0.4](docs/prd/archive/v0.4.md)。
-
-**v0.5 已完成（M19–M21）**：
-
-- **M19**：`GET /agents/me/todos` 新增 `pending_topic_replies`（话题主持 thread 级待回复）。
-- **M20**：topic-host Skill（`.cursor/skills/topic-host/SKILL.md`）。
-- **M21**：Webhook 主持接线文档（[WEBHOOK-TOPIC-HOST.md](docs/WEBHOOK-TOPIC-HOST.md)）。
+### PRD
 
-详见 [PRD v0.5](docs/prd/archive/v0.5.md)。
+- [现行草案：v0.9（waker Phase 2 通知降噪）](docs/prd/v0.9.md)
+- [归档：v0.1 / v0.2 / v0.3 / v0.4 / v0.5 / v0.6](docs/prd/archive/)
+- [占位：v0.7 / v0.8（未单独成稿）](docs/prd/archive/v0.7.md)
 
-**v0.6 已完成（M22–M24）**：
+## 状态
 
-- **M22**：话题/实验 `archived_at` 归档（默认列表排除、`include_archived`、活跃实验 per-topic 约束更新）。
-- **M23**：Web 独立列表页（`/projects/:id/topics`、`/experiments`）+ `client.ts` vitest。
-- **M24**：站内通知 **SSE**（`GET /agents/me/notifications/stream`）+ Web 实时 invalidate。
+**稳定能力**：
 
-详见 [PRD v0.6](docs/prd/archive/v0.6.md)。项目叙事参考 [docs/status-md-v6.md](docs/status-md-v6.md)。
+- **实验生命周期**：计划修订、评审、执行日志、结果审批、状态机
+- **话题协作**：独立话题 + 评论树 + @提及 + 多轮讨论 + Round Summary + 结论与行动项
+- **待办与通知**：Agent 待办视图 + 站内通知 + SSE 实时推送 + Webhook 出站
+- **Web UI**：React + Vite 看板 / 话题 / 实验详情，写操作闭环
+- **多入口接入**：Python SDK + `map` CLI + MCP stdio/HTTP（`map-mcp`）
+- **Agent Runtime**：simple-waker 默认路径（轮询 + remind + action_item 升级）
+- **多 persona 协作**：`.map/` persona + Skill 指导 Agent 写回 MAP
 
-**v0.8 MVP 已完成**：
+**当前主线**：v0.9 草案（waker Phase 2 通知降噪）。详见 [PRD v0.9](docs/prd/v0.9.md) 与 [status-md-v10.md](docs/status-md-v10.md)。
 
-- 话题结论（Decision）与行动项（Action Items）：`POST /topics/{id}/resolve`、项目级 `decisions` / `action-items` 查询、`todos.action_items`。
-- CLI：`map topic resolve --id <topic-id> --file decision.md|decision.yaml`、`map project decisions`、`map action list --mine`。
-- Web：话题详情页展示/修订结论，项目页展示最近结论，待办页展示分配给当前 Agent 的行动项。
+历史里程碑详见 PRD 归档：[v0.1–v0.6](docs/prd/archive/) · [占位 v0.7 / v0.8](docs/prd/archive/v0.7.md)。
 
 **Agent 身份（本仓库）**：统一使用 **`.map/` persona + `map` CLI**（见 [AGENTS.md](AGENTS.md)）；Cursor MCP 接入计划停用。
 
@@ -108,7 +84,6 @@ map skill install          # 将 6 个 Skill 文件安装到 .cursor/skills/
 MAP API 运行后，在本仓库根目录执行一次 bootstrap（生成 `.map/config.yaml` 与 persona token，详见 [AGENTS.md](AGENTS.md)）：
 
 ```bash
-export MAP_ADMIN_TOKEN=<admin-token>   # 或 ~/.map/admin.yaml
 map bootstrap \
   --key multi-agent-platform \
   --name "Multi Agents Platform" \
@@ -118,18 +93,21 @@ map --persona host persona whoami
 map --persona host todos
 ```
 
-与 `docker compose up` 并列：先起服务，再 bootstrap，再用 `--persona` 协作。
+与 `docker compose up` 并列：先起服务，再 bootstrap，再用 `--persona` 协作。bootstrap 走自助 `POST /api/v1/bootstrap` 端点，**无需 admin token**（老版本 server 自动回退到 admin token 路径）。
 
 ## 快速开始
 
 ```bash
-# 从 PyPI 安装（用户）
+# 从 PyPI 安装（仅 CLI，连接远程 server）
 pip install multi-agent-platform
 
+# 或安装 CLI + Server（本地运行 server）
+pip install multi-agent-platform-server
+
 # 或从源码开发安装（贡献者）
 pip install -e ".[dev]"
 
-# 运行数据库迁移
+# 运行数据库迁移（需要 server 依赖）
 alembic upgrade head
 
 # 启动 API 服务
@@ -167,9 +145,19 @@ map topic archive --id <topic-id>               # v0.7 P3：归档（薄包装 P
 map topic archive --id <topic-id> --undo       # 反归档（--unarchive 同义）
 map experiment archive --id <exp-id>           # 归档实验
 map topic comment --id <topic-id> --file comment.md
-map topic mark-seen --id <topic-id>            # 清 contextual unread，不清 reply/ack/mention
+map topic comment --id <topic-id> --body "..." --round-summary   # 标记 Round Summary（触发 ack 流）
+map topic advance-round --id <topic-id>                          # roundN → roundN+1
+map topic advance-round --id <topic-id> --ready                  # 标记 ready（可开实验）
+map topic advance-round --id <topic-id> --ack accept|reject|dismiss   # participant 表态
+map topic advance-round --id <topic-id> --waive-ack --waive-reason "参与者离线，结论已收敛"
+map topic rollback-round --id <topic-id>                         # 回退一轮
+map topic close --id <topic-id> --reason no_experiment_needed --note "讨论后决定不开实验"
+map topic dismiss --id <topic-id>                                # 退出话题（与 UI ✕ 相同）
+map topic mark-seen --id <topic-id>                              # 清 contextual unread，不清 reply/ack/mention
 map project decisions
 map action list --mine
+map action mark-wake-sent --id <action-item-id>                  # waker 升级：标记 WAKE 已发
+map action mark-stale --id <action-item-id>                      # waker 升级：标记 STALE
 map notification list --unread-only
 map notification read --id <notification-id>
 map notification read-all
@@ -177,6 +165,10 @@ map --persona participant mention list
 map --persona participant mention dismiss --id <mention-id>
 map --persona participant mention dismiss-all
 
+# Host 编排模式：host 直接调用 participant/reviewer（同步响应，不依赖 waker 轮询）
+map --persona host host invoke --persona participant --prompt "请参与话题 <topic-id> 的讨论"
+map --persona host host invoke --persona reviewer --prompt-file ./review-task.md --json
+
 # Web UI（React + Vite）
 cd web && npm install && npm run dev   # http://localhost:5173
 # 开发模式通过 Vite 代理访问 API；先在设置页填入 API Token
@@ -195,7 +187,6 @@ cd web && npm install && npm run dev   # http://localhost:5173
 不依赖 Cursor MCP。每个代码仓库：
 
 ```bash
-export MAP_ADMIN_TOKEN=<admin-token>   # 或 ~/.map/admin.yaml
 map bootstrap --key my-app --name "My App" --api-url http://localhost:8001
 map --persona host status              # 查看 open_topics
 ```
@@ -232,14 +223,11 @@ simple-waker 在每次 remind 后会写一条聚合 `inbound_event` 审计行（
 
 **@mention 收敛**：在话题/实验内发过评论后，对应 `mentions` 会自动从 todos 消失；只读不回时可 `map mention dismiss`。
 
-## Host Worker（旧 bridge，维护模式）
+## Host Worker（已退役）
 
-`map-host-bridge` / `map-host-worker` 为早期轮询 bridge（进程内 `PersonaAgentClient`），已由 **waker** 取代。`main-bac` 分支保留 bridge 实现供对照；日常开发请在 `agent-runtime` 分支使用 waker。
+早期轮询 bridge（`map-host-bridge` / `map-host-worker`、`start-host-bridge*.sh`、`start-runtime-waker-claude.sh`、`start-all-wakers-legacy.sh`）已由 **simple-waker** 全面取代并停用（`MAP_USE_LEGACY_WAKER` 不再生效）。`pyproject.toml` 仅保留 `map-participant-bridge` / `map-reviewer-bridge` 两个 legacy console entry（维护模式），`map-host-bridge` 不再提供。
 
-```bash
-# 旧路径（不推荐新接入）
-map-host-bridge --persona host --interval 30
-```
+详见 [docs/LEGACY-ENTRY-MATRIX.md](docs/LEGACY-ENTRY-MATRIX.md)；CI 校验：`./scripts/check-deprecated.sh`。
 
 ## Docker（API + Web）
 

{multi_agent_platform-0.3.0 → multi_agent_platform-0.3.2}/cli/agent_client.py

@@ -1,6 +1,6 @@
 """Persistent in-process Claude SDK client with session resume.
 
-Used by map-runtime-waker (event-driven wake) and legacy bridges. The process
+Used by simple-waker (event-driven wake) and legacy bridges. The process
 holds ONE ``ClaudeSDKClient`` for its lifetime; ``claude_session_id`` is
 persisted in local state so the next restart resumes the same Claude session
 (via ``ClaudeAgentOptions(resume=...)``).
@@ -49,7 +49,7 @@ _MODEL_ENV_KEYS: tuple[str, ...] = ("ANTHROPIC_MODEL", "CLAUDE_MODEL")
 
 _EXPORT_RE = re.compile(r"^\s*export\s+([A-Za-z_][A-Za-z0-9_]*)=(.*)$")
 
-IntegrationMode = Literal["bridge", "waker", "manual"]
+IntegrationMode = Literal["bridge", "waker", "manual", "orchestrator"]
 
 
 class WakeUpEvent(TypedDict, total=False):
@@ -410,7 +410,7 @@ class PersonaAgentClient:
         if self.integration == "waker":
             return (
                 f"You are the **{self.persona}** persona of the MAP (Multi-Agent Platform) "
-                "project. When woken by map-runtime-waker you receive a single wake event. "
+                "project. When woken by simple-waker you receive a single wake event. "
                 f"Confirm identity with `map --persona {self.persona} persona whoami`, read "
                 f"latest work with `map --persona {self.persona} todos`, then handle only the "
                 "event in the wake prompt using the appropriate skill from `.cursor/skills/`. "
@@ -424,7 +424,18 @@ class PersonaAgentClient:
                 f"Use `map --persona {self.persona}` CLI and skills under `.cursor/skills/` "
                 "(topic-host, topic-participant, experiment-host, experiment-reviewer, "
                 "map-project-collab). Follow the operator's instructions for the current task. "
-                "Do not assume map-runtime-waker will send another wake for the same work item."
+                "Do not assume simple-waker will send another wake for the same work item."
+            )
+        if self.integration == "orchestrator":
+            return (
+                f"You are the **{self.persona}** persona of the MAP (Multi-Agent Platform) "
+                "project. You are being invoked directly by the host agent via "
+                f"`map host invoke`. Use `map --persona {self.persona}` CLI and skills "
+                "under `.cursor/skills/` (topic-host, topic-participant, experiment-host, "
+                "experiment-reviewer, map-project-collab) to handle the task in the prompt. "
+                "Gather context via the `map` CLI, perform the requested action, and report "
+                "a brief summary when done. Do not wait for a waker — this is a synchronous "
+                "invocation and the host is waiting for your response."
             )
         return (
             f"You are the **{self.persona}** persona of the MAP (Multi-Agent Platform) "

{multi_agent_platform-0.3.0 → multi_agent_platform-0.3.2}/cli/commands/experiment.py

@@ -18,9 +18,7 @@ from map_sdk.evidence import (
     EVIDENCE_METADATA_KEYS,
     metadata_has_completion_evidence,
 )
-
-from cli.table_render import enum_value, format_datetime, render_table, short_uuid, truncate
-from server.domain.schemas import (
+from map_types.schemas import (
     ExperimentComplete,
     ExperimentCreate,
     ExperimentLogCreate,
@@ -30,6 +28,8 @@ from server.domain.schemas import (
     ReviewCreate,
 )
 
+from cli.table_render import enum_value, format_datetime, render_table, short_uuid, truncate
+
 experiment_app = typer.Typer(help="Experiment commands", rich_markup_mode=None)
 lock_app = typer.Typer(help="Experiment execution lock commands (per-project).")
 review_app = typer.Typer(help="Review commands")
@@ -128,8 +128,9 @@ def experiment_list(
     Defaults to a compact table view. Use ``--format yaml`` or
     ``--format json`` for full structured output (scripts / piping).
     """
+    from map_types.enums import ExperimentPhase
+
     from cli.main import _resolve_project, _run  # lazy: avoid cycle
-    from server.domain.models import ExperimentPhase
 
     def action(c: MAPClient):
         pid = _resolve_project(c, project, project_key)
@@ -160,9 +161,34 @@ def experiment_approve(experiment_id: uuid.UUID = typer.Option(..., "--id")) ->
 
 
 @experiment_app.command("start")
-def experiment_start(experiment_id: uuid.UUID = typer.Option(..., "--id")) -> None:
-    from cli.main import _run  # lazy: avoid cycle
-    _run(lambda c: c.start_experiment(experiment_id), experiment_id=experiment_id)
+def experiment_start(
+    experiment_id: uuid.UUID = typer.Option(..., "--id"),
+    executor: str | None = typer.Option(
+        None,
+        "--executor",
+        help=(
+            "Delegate execution to another agent (name or UUID). The designated "
+            "executor becomes the sole non-admin caller allowed to ``complete``. "
+            "Omit to self-execute (host runs the experiment)."
+        ),
+    ),
+) -> None:
+    """Start experiment execution (approved → running).
+
+    Migration 042 adds optional executor delegation: pass ``--executor``
+    with an agent name or UUID to designate who may call ``complete``.
+    The host retains all other lifecycle gates (cancel / withdraw / etc).
+    """
+    from cli.main import _resolve_executor_agent_id, _resolve_project, _run  # lazy: avoid cycle
+
+    def action(c: MAPClient):
+        executor_agent_id: uuid.UUID | None = None
+        if executor is not None:
+            pid = _resolve_project(c, None, None)
+            executor_agent_id = _resolve_executor_agent_id(c, pid, executor)
+        return c.start_experiment(experiment_id, executor_agent_id=executor_agent_id)
+
+    _run(action, experiment_id=experiment_id)
 
 
 @experiment_app.command("pre-complete")
@@ -519,7 +545,7 @@ def experiment_archive(
     """
     from cli.main import _require_option_uuid, _run  # lazy: avoid cycle
     experiment_id = _require_option_uuid(experiment_id)
-    from server.domain.schemas import ExperimentUpdate
+    from map_types.schemas import ExperimentUpdate
 
     payload = ExperimentUpdate(archived=not (undo or unarchive))
     object_kind = "experiment"
@@ -735,9 +761,10 @@ def experiment_comment(
     body_file: Path | None = typer.Option(None, "--file", help="Read body from a file (avoids shell-quoting issues)."),
     parent: uuid.UUID | None = typer.Option(None, "--parent"),
 ) -> None:
+    from map_types.enums import CommentAnchorType
+    from map_types.schemas import CommentCreate
+
     from cli.main import _read_text_file, _run  # lazy: avoid cycle
-    from server.domain.models import CommentAnchorType
-    from server.domain.schemas import CommentCreate
 
     if body is None and body_file is None:
         typer.echo("Error: either --body or --file is required", err=True)