Skip to content

Commit d91c600

Browse files
author
J.A.R.V.I.S.
committed
docs(v3.11.0): sync README + ROADMAP
- README: fix test badge 1739→1552 (full suite run: 1552 passed, 26 skipped) - README: add v3.11 worker endpoints to API Quick Reference table - ROADMAP: update header to v3.11.0 (a4b31ca) - ROADMAP: mark v3.7–v3.11 as completed with test counts - ROADMAP: add v3.12.0 candidate features (governance metadata P1, bilateral proof P2)
1 parent a4c6475 commit d91c600

2 files changed

Lines changed: 39 additions & 10 deletions

File tree

README.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@
1515
<img src="https://img.shields.io/badge/python-3.9%2B-blue?style=flat-square" alt="Python">
1616
<img src="https://img.shields.io/badge/stdlib__only-zero__heavy__deps-orange?style=flat-square" alt="Deps">
1717
<img src="https://img.shields.io/badge/latency-0.6ms_avg-brightgreen?style=flat-square" alt="Latency">
18-
<img src="https://img.shields.io/badge/tested-1739%2F1739_PASS-success?style=flat-square" alt="Tests">
18+
<img src="https://img.shields.io/badge/tested-1552%2F1552_PASS-success?style=flat-square" alt="Tests">
1919
</p>
2020

2121
<p>
@@ -316,7 +316,7 @@ for event in sseclient.SSEClient("http://localhost:7901/stream"):
316316
- **0.6ms** avg send latency · **2.8ms** P99
317317
- **1,100+ req/s** sequential throughput · **1,200+ req/s** concurrent (10 threads)
318318
- **< 50ms** SSE push latency (threading.Event, not polling)
319-
- **1739/1739 unit + integration tests PASS** (error handling · pressure test · NAT traversal · ring pipeline · transport_modes · context query · federation · Pub/Sub · heartbeat-agent · task-queue-worker)
319+
- **1552/1552 unit + integration tests PASS** (error handling · pressure test · NAT traversal · ring pipeline · transport_modes · context query · federation · Pub/Sub · heartbeat-agent · task-queue-worker)
320320
- **190+ commits** · **3,300+ lines** · **zero known P0/P1 bugs**
321321

322322
---
@@ -351,6 +351,10 @@ for event in sseclient.SSEClient("http://localhost:7901/stream"):
351351
| Publish to topic | POST | `/peers/broadcast/{topic}` |
352352
| List active topics | GET | `/peers/topics` |
353353
| Poll queue summary | GET | `/offline-queue/summary` |
354+
| Enqueue async task | POST | `/tasks/queue` `{"role":"agent","payload":{...}}` |
355+
| Register worker | POST | `/tasks/queue/worker` `{"callback_url":"http://...","peer_id":"...","skill_id":"..."}` |
356+
| List workers | GET | `/tasks/queue/workers` |
357+
| Deregister worker | DELETE | `/tasks/queue/worker/{id}` |
354358

355359
HTTP default port: `7901` · WebSocket port: `7801`
356360

@@ -714,7 +718,7 @@ curl -X POST http://localhost:7901/peers/connect \
714718

715719
**ACP vs A2A (Google's protocol):** A2A requires OAuth 2.0, an HTTPS endpoint you must host, and an agent registry. ACP requires `pip install websockets`. A2A is great for enterprise platforms; ACP is for individuals, sandboxed agents, and fast prototyping.
716720

717-
**Status:** Single-file Python daemon, 1739 tests passing, Apache 2.0. Built in public over ~200 commits. Would love feedback on the P2P design and the `acp://` URI scheme.
721+
**Status:** Single-file Python daemon, 1552 tests passing, Apache 2.0. Built in public over ~200 commits. Would love feedback on the P2P design and the `acp://` URI scheme.
718722

719723
---
720724

docs/ROADMAP.md

Lines changed: 32 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# ACP 协议研发路线图
22

33
> 持续更新。贾维斯每周自动扫描竞品动态,每月产出一个新版本。
4-
> 最后更新:2026-04-10(v2.95.0:skill-scoped trust scores — governance_metadata.trust_scores dict + QuerySkill skill_trust_score;当前版本 2.95.0,commit 070e0d3
4+
> 最后更新:2026-04-12(v3.11.0:async task queue workers — POST /tasks/queue/worker + GET /tasks/queue/workers + DELETE;auto-dispatch;TQW1-TQW12 全 PASS;当前版本 3.11.0,commit a4b31ca
55
66
---
77

@@ -789,7 +789,9 @@ APS: https://github.com/aeoess/agent-passport-system (Ed25519 身份,v0.8
789789
| v2.94 | 主体多样性防御 | `GET /trust/bilateral-ir/diversity` — 共谋对惩罚(concentration>60%→0.10x权重);`principal_diversity_defense: true`;16测试PD01-16全通 | `b9f638e` |
790790
| v2.95 | Skill 信任评分 | `_compute_skill_trust_scores()` + `GET /trust/skill-scores` + QuerySkill `skill_trust_score` + `governance_metadata.trust_scores` dict;`skill_scoped_v1` 算法;16测试SS01-16全通 | `070e0d3` |
791791

792-
**当前版本**: `2.95.0` | **最新 commit**: `070e0d3`
792+
**当前版本**: `3.11.0` | **最新 commit**: `a4b31ca`
793+
794+
> 版本演进:v2.95 → v3.0(NAT Auto-Traversal, 2026-03-28)→ v3.1–v3.6(签名/安全系列, 2026-04-11)→ v3.7(CI压测+Authorization Hook)→ v3.8(heartbeat-agent三件套)→ v3.9(topic Pub/Sub, A2A #1196 首实现)→ v3.10(multi-relay federation)→ **v3.11(async task queue workers)**
793795
794796
---
795797

@@ -905,8 +907,31 @@ APS: https://github.com/aeoess/agent-passport-system (Ed25519 身份,v0.8
905907
- BUG-009 P1 修复:SSE 推送延迟 <50ms
906908
- BUG-003b P1 修复:重复连接幂等
907909

908-
## v3.7.0 候选特性
909-
- scenario_d 压测集成到 CI(P2)
910-
- SlimRPC 实验性绑定(待 A2A #1723 建仓确认,P3)
911-
- Agent Identity/Trust 互操作文档(参考 A2A #1672,P3)
912-
- ECDSA-SD 选择性披露评估(跟踪 ANP 进展,P3)
910+
## v3.7.0 ✅ 已完成 — 2026-04-12
911+
- **CI 压力测试 + Authorization Hook**: `test_scenario_d.py` local-relay 20-msg burst(P99 latency assertion,全 CI-safe);`_check_authorization()` stub 预留(A2A #1716 watchlist)
912+
- 测试:48 tests PASS
913+
914+
## v3.8.0 ✅ 已完成 — 2026-04-12
915+
- **Heartbeat-Agent 三件套闭环(A2A IS#1667**: `GET /offline-queue/summary`(轻量 polling 端点);`--heartbeat-agent` CLI 标志(implies `--local-only` + `availability.mode=heartbeat`);`capabilities.heartbeat_agent`
916+
- 测试:HA1–HA8 = 8/8 PASS
917+
918+
## v3.9.0 ✅ 已完成 — 2026-04-12
919+
- **Topic-based Pub/Sub subset(A2A #1196 对标)**: `POST /peers/subscribe/{topic}``POST /peers/unsubscribe/{topic}``POST /peers/broadcast/{topic}``GET /peers/topics``capabilities.topic_broadcast: true`
920+
- A2A #1196 首个工作参考实现(上游仅 proposal,无实现)
921+
- 测试:TP1–TP10 = 10/10 PASS
922+
923+
## v3.10.0 ✅ 已完成 — 2026-04-12
924+
- **Multi-relay Federation(跨 relay 实例消息路由)**: `GET /federation``POST /federation`(idempotent)、`POST /federation/route``acp.federation.route` WS 消息处理;offline-queue fallback 组合;`capabilities.federation: true`
925+
- Commit: `68bf6f6`
926+
- 测试:FED1–FED12 = 12/12 PASS
927+
928+
## v3.11.0 ✅ 已完成 — 2026-04-12
929+
- **Async Task Queue Workers**: `POST /tasks/queue/worker`(注册 callback_url + peer_id/skill_id 过滤器,幂等)、`GET /tasks/queue/workers`(列出 workers + stats)、`DELETE /tasks/queue/worker/{id}`(注销);入队自动派发;`capabilities.task_queue_worker: true`
930+
- 修复 filter 逻辑 bug:worker 有 peer_id 过滤器时,无 from_peer_id 的任务不应被派发
931+
- Commit: `a4b31ca`
932+
- 测试:TQW1–TQW12 = 12/12 PASS
933+
934+
## v3.12.0 候选特性
935+
- **P1**: Governance metadata block(A2A #1717,Microsoft AGT 团队)— `trust_score``capability_manifest``policy_compliance``audit_trail_reference`;ACP 现有覆盖 ~60%,扩展 `bilateral_proof` 支持
936+
- **P2**: Bilateral Signed Interaction Records(A2A #1718)— 双边签名交互记录,统一 trust/audit/delegation/Sybil-resistance
937+
- **P3**: SlimRPC CPB 实验性绑定(跟踪 A2A #1723

0 commit comments

Comments
 (0)