multi-agent-platform 0.2.0__tar.gz → 0.3.1__tar.gz

{multi_agent_platform-0.2.0 → multi_agent_platform-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multi-agent-platform
-Version: 0.2.0
+Version: 0.3.1
 Summary: Multi-Agent experiment collaboration platform
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/quantaeye/multi-agent-platform
@@ -9,11 +9,12 @@ 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
@@ -61,72 +62,60 @@ pip install multi-agent-platform
 
 **新用户？** 一键启动：`./scripts/quickstart.sh`，或阅读 [Quick Start 指南](docs/QUICKSTART.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)
-- [架构设计](docs/ARCHITECTURE.md)
-- [Python SDK 指南](docs/SDK.md)
-- [MCP Server 指南（stdio）](docs/MCP.md)
-
-## 状态
+## 让你的 AI Agent 自动使用 MAP
 
-**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）**：
+**方式一：安装 Skill（推荐，完整功能）**
 
-- **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）+ 审计日志（关键写操作打点 + 对象/全局查询）。
+```bash
+pip install multi-agent-platform
+map skill install          # 将 5 个 Skill 文件安装到 .cursor/skills/
+```
 
-详见 [PRD v0.3](docs/prd/archive/v0.3.md)。
+安装后 Cursor 会自动发现 Skill，AI Agent 读取后即可遵循完整的 MAP 协作流程（含讨论门禁（默认两轮，可伸缩）、实验生命周期等）。
 
-**v0.4 已完成（M15–M18）**：
+**方式二：使用简化 Prompt（快速上手）**
 
-- **M15**：站内通知收件箱（`notifications` 表 + 统一事件扇出 + API/Web/CLI/SDK/MCP）。
-- **M16**：评论 `@提及` → 待办 `mentions` 分区 + 定向通知。
-- **M17**：实验页计划版本 diff 只读视图（`PlanDiffView`）。
-- **M18**：话题置顶（`topics.pinned` + 列表优先排序）。
+复制 [MAP_AGENT_PROMPT.md](MAP_AGENT_PROMPT.md) 中的 prompt 内容，粘贴到你的 AI Agent 的 system prompt 或项目规则中。适合不想安装文件、快速体验的场景。
 
-详见 [PRD v0.4](docs/prd/archive/v0.4.md)。
+## 文档
 
-**v0.5 已完成（M19–M21）**：
+- [文档总入口](docs/INDEX.md)
+- [MAP Agent Prompt（给 AI Agent 的协作指南）](MAP_AGENT_PROMPT.md)
+- [Quick Start 指南（新用户必读）](docs/QUICKSTART.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)
 
-- **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 接入计划停用。
 
@@ -194,9 +183,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
@@ -204,6 +203,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
@@ -259,14 +262,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.2.0 → multi_agent_platform-0.3.1}/README.md

@@ -16,72 +16,60 @@ pip install multi-agent-platform
 
 **新用户？** 一键启动：`./scripts/quickstart.sh`，或阅读 [Quick Start 指南](docs/QUICKSTART.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)
-- [架构设计](docs/ARCHITECTURE.md)
-- [Python SDK 指南](docs/SDK.md)
-- [MCP Server 指南（stdio）](docs/MCP.md)
-
-## 状态
+## 让你的 AI Agent 自动使用 MAP
 
-**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）**：
+**方式一：安装 Skill（推荐，完整功能）**
 
-- **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）+ 审计日志（关键写操作打点 + 对象/全局查询）。
+```bash
+pip install multi-agent-platform
+map skill install          # 将 5 个 Skill 文件安装到 .cursor/skills/
+```
 
-详见 [PRD v0.3](docs/prd/archive/v0.3.md)。
+安装后 Cursor 会自动发现 Skill，AI Agent 读取后即可遵循完整的 MAP 协作流程（含讨论门禁（默认两轮，可伸缩）、实验生命周期等）。
 
-**v0.4 已完成（M15–M18）**：
+**方式二：使用简化 Prompt（快速上手）**
 
-- **M15**：站内通知收件箱（`notifications` 表 + 统一事件扇出 + API/Web/CLI/SDK/MCP）。
-- **M16**：评论 `@提及` → 待办 `mentions` 分区 + 定向通知。
-- **M17**：实验页计划版本 diff 只读视图（`PlanDiffView`）。
-- **M18**：话题置顶（`topics.pinned` + 列表优先排序）。
+复制 [MAP_AGENT_PROMPT.md](MAP_AGENT_PROMPT.md) 中的 prompt 内容，粘贴到你的 AI Agent 的 system prompt 或项目规则中。适合不想安装文件、快速体验的场景。
 
-详见 [PRD v0.4](docs/prd/archive/v0.4.md)。
+## 文档
 
-**v0.5 已完成（M19–M21）**：
+- [文档总入口](docs/INDEX.md)
+- [MAP Agent Prompt（给 AI Agent 的协作指南）](MAP_AGENT_PROMPT.md)
+- [Quick Start 指南（新用户必读）](docs/QUICKSTART.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)
 
-- **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 接入计划停用。
 
@@ -149,9 +137,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
@@ -159,6 +157,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
@@ -214,14 +216,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.2.0 → multi_agent_platform-0.3.1}/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.2.0 → multi_agent_platform-0.3.1}/cli/commands/experiment.py

@@ -160,9 +160,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")

multi_agent_platform-0.3.1/cli/commands/host.py

@@ -0,0 +1,150 @@
+"""``map host ...`` sub-app — host-orchestrated agent invocation.
+
+Lets the host agent directly invoke participant/reviewer agents and get
+synchronous responses, without relying on simple-waker polling.
+
+Usage::
+
+    map --persona host host invoke --persona participant --prompt "..."
+    map --persona host host invoke --persona reviewer --prompt-file ./review-task.md
+"""
+from __future__ import annotations
+
+from pathlib import Path
+
+import typer
+
+host_app = typer.Typer(help="Host-only orchestration commands (invoke other personas)")
+
+
+@host_app.callback()
+def host_callback() -> None:
+    """Host-only orchestration commands.
+
+    Lets the host agent directly invoke participant/reviewer agents
+    and get synchronous responses, without relying on simple-waker polling.
+    """
+    # Callback exists to force multi-command mode (so `map host invoke`
+    # is required rather than `map host` directly invoking the single command).
+    return
+
+
+@host_app.command("invoke")
+def host_invoke(
+    persona: str = typer.Option(
+        ...,
+        "--persona",
+        "-p",
+        help="Target persona to invoke (participant or reviewer)",
+    ),
+    prompt: str | None = typer.Option(
+        None,
+        "--prompt",
+        help="Prompt text to send to the target persona",
+    ),
+    prompt_file: Path | None = typer.Option(
+        None,
+        "--prompt-file",
+        help="Read prompt from file (overrides --prompt)",
+    ),
+    new_session: bool = typer.Option(
+        False,
+        "--new-session",
+        help="Start a fresh Claude session instead of resuming",
+    ),
+    model: str | None = typer.Option(
+        None,
+        "--model",
+        help="Optional Claude model override",
+    ),
+    ignore_waker: bool = typer.Option(
+        False,
+        "--ignore-waker",
+        help="Allow invoking even if simple-waker is running for this persona",
+    ),
+    project_root: Path | None = typer.Option(
+        None,
+        "--project-root",
+        help="Repo root containing .map/ (default: search upward from cwd)",
+    ),
+    json_output: bool = typer.Option(
+        False,
+        "--json",
+        help="Output result as JSON (response + metadata) instead of plain text",
+    ),
+) -> None:
+    """Invoke another persona agent (participant/reviewer) from host.
+
+    The host agent constructs a prompt describing what the target persona
+    should do (e.g., comment on a topic, review an experiment). The target
+    persona agent processes the prompt using its own Claude session and
+    Skills, and the response is printed to stdout.
+
+    Examples::
+
+        # Ask participant to comment on a topic
+        map --persona host host invoke --persona participant \\
+            --prompt "请参与话题 <topic-id> 的讨论，发表你的观点"
+
+        # Ask reviewer to review an experiment plan
+        map --persona host host invoke --persona reviewer \\
+            --prompt "请评审实验 <experiment-id> 的计划，提交结构化评审"
+
+        # Read prompt from file
+        map --persona host host invoke --persona participant \\
+            --prompt-file ./task.md
+    """
+    import json as json_lib
+
+    from cli.main import _cli_options
+    from cli.orchestrator import run_invoke
+
+    # Resolve prompt
+    if prompt_file is not None:
+        actual_prompt = prompt_file.read_text(encoding="utf-8")
+    elif prompt is not None:
+        actual_prompt = prompt
+    else:
+        typer.echo("Error: either --prompt or --prompt-file is required", err=True)
+        raise typer.Exit(1)
+
+    result = run_invoke(
+        persona=persona,
+        prompt=actual_prompt,
+        project_root=project_root or _cli_options.get("project_root"),
+        new_session=new_session,
+        model=model,
+        ignore_waker=ignore_waker,
+    )
+
+    if json_output:
+        typer.echo(
+            json_lib.dumps(
+                {
+                    "persona": result.persona,
+                    "status": result.status,
+                    "response": result.response_text,
+                    "session_id": result.session_id,
+                },
+                ensure_ascii=False,
+                indent=2,
+            )
+        )
+        return
+
+    if result.status == "error":
+        typer.echo(
+            f"Error: agent '{persona}' returned error status"
+            + (f": {result.error}" if result.error else ""),
+            err=True,
+        )
+        raise typer.Exit(1)
+
+    if result.response_text:
+        typer.echo(result.response_text)
+
+    typer.echo(
+        f"\n[orchestrator] persona={result.persona} status={result.status} "
+        f"session={result.session_id or '<none>'}",
+        err=True,
+    )

{multi_agent_platform-0.2.0 → multi_agent_platform-0.3.1}/cli/commands/runtime.py

@@ -52,7 +52,7 @@ def runtime_chat(
     ignore_waker: bool = typer.Option(
         False,
         "--ignore-waker",
-        help="Allow chat while map-runtime-waker is running (may conflict)",
+        help="Allow chat while simple-waker is running (may conflict)",
     ),
     model: str | None = typer.Option(None, "--model", help="Optional Claude model override"),
 ) -> None: