跳到主要内容

变更日志

本项目暂无 git 标签/发布版本，按日期倒序分节（组内按依赖顺序）；面向使用者与开发者的变更，纯内部记忆提交（brain:）不收录。括号内为 commit 短 sha。

2026-09-24 — 文档补充与 P3 收尾​

  • docs: 站点发布至 GitHub Pages（https://adam-ikari.github.io/pi-a2a-ext/），push master 经 GitHub Actions 自动构建部署；url/baseUrl 按 GITHUB_REPOSITORY 环境感知（本地预览仍是 /）
  • docs: Docusaurus 文档站（website/：构建时同步 README/CHANGELOG/docs 进生成目录 website/content，中文界面，首页 + 指南 + 协议 + 测试 + 变更日志 + 历史设计存档）
  • docs: 新增 docs/protocol.md（wire 契约：传输、处理顺序、会话生命周期、方法示例、错误码总表）、docs/testing.md（单测矩阵、三 E2E 判读含审批探针 VERDICT A/B/C）、CHANGELOG.md 与 README 故障排查节
  • chore: 新增 MIT LICENSE、package.json license 字段与 README 许可节（d4930b9）
  • chore: 引入 Biome lint/format（tab 缩进、120 列、recommended 规则，2 空格 JSON 不受管），新增 bun run lint，存量风格归一（5b2342f）
  • feat: 审计记录携带 Mcp-Session-Id——共享 token 下调用可归因到客户端会话（单测 + 加固探针双重断言）（c20dc4e）
  • refactor: 移除全部 3 处 as never：TSchema 从 ToolInfo 原生流入 toolWireSchema，execute() 上下文对真实 AgentToolContext 逐字段校验（变异测试验证校验非空洞）（806ad85）
  • fix: 500 响应体固定为 internal error，宿主内部细节只进服务端 stderr（e7393eb）

2026-09-24 — 元评审修正（第一轮收尾）​

  • docs: README 实话修正——无 UI 下 prompt 审批挂起 ≥90s（非 isError，调用方须自设超时）、默认 yolo 下 token 即工具执行全权、两阶段审计格式、宿主 omp 版本事实更正为 18.2.10（18.2.11 是 registry latest 的误读）（f332b4a）
  • test: 真实宿主加固核验（29 项）与审批判别探针落仓为手动脚本 test/hardening.ts、test/approval-probe.ts，接入 test:hardening / test:approval（6e0414a）
  • test: 版本守卫 test/versions.test.ts——pi-* pin 必须精确、实装 == pin 硬断言、omp --version ≠ pin 告警（4ffdbf7）
  • feat: 审计改为两阶段——派发即写 start，未落定的调用（无 UI 审批挂起）在日志中可见（6162136）
  • test: 单测审计路径 A2A_BRIDGE_AUDIT 沙箱化、断言与执行顺序解耦（9560729）

2026-09-23/24 — 评审加固第一轮​

  • docs: README 补充配置校验（fail-closed）、暴露语义、会话规则、审计日志与开发脚本（cf58cef）
  • feat: fail-closed 配置校验（非法字段拒绝启动，仅 token 自愈并持久）、调用 ∩ 目录暴露交集门、JSONL 审计日志、端口占用回退告警（339a46b）
  • fix: 协议加固——鉴权前置于一切状态变更、强制 Mcp-Session-Id（缺头 400 / 未知 404，通知同样受限）、版本协商固定 2025-11-25 不回显、会话表上限 64 淘汰最久未见（998f572）
  • chore: @oh-my-pi/pi-* 以精确版本声明为 devDependencies，建立 pin == 宿主版本不变量（48d52ca）

2026-09-11 — 首版实现​

  • fix: 会话 TTL 改为命中刷新、过期条目惰性清理（d80237a）
  • docs: README（安装、配置、远程 mcp.json、SSH 转发、审批语义）（a4ad053）
  • test: 真实宿主 E2E 冒烟 test/smoke.ts（隔离 HOME 启动 omp、走完整 MCP 流程、tools/call read 落真实 Main 会话）（19a2259）
  • feat: A2A bridge 核心——Bun.serve JSON-RPC 服务器（server/bridge/config/auth）、扩展入口 session_start 起服与 /a2a 命令（5a4bd02）

2026-09-10 — 设计与计划​

  • spec+plan: 按评审修正设计（pi-ai schema 导入路径、buildCallTool 签名、审批经 wrapper runner 而非 ctx.ui）（41ae4a2）
  • plan: 实施计划 T1-T9（72bc255）
  • spec: omp 即 MCP 服务器的 A2A bridge 设计（66517b1）