Phase 05 Plan 02: Integration Decision Records Summary

MCP revision handling, ACP v1 plus realm/tool extension, and Omp API names verified against the official pages, all pinned by exact-string doc tests.

Performance

• Duration: not tracked by executor (plan constraints forbid running gates)
• Started: 2026-10-22
• Completed: 2026-10-22
• Tasks: 3
• Files modified: 6

Accomplishments

• omp.md Q1-Q4 verified against https://omp.sh/docs/extension-authoring and https://omp.sh/docs/hooks (read 2026-10-22); setStatus signature stays upstream-sourced, Q4 OPEN carried
• mcp.md Q5 records revision 2026-07-28 with server/discover probe plus initialize handshake and no other revision string
• acp.md Q5 records protocol generation v1 with clientInfo/agentInfo plus the realm/tool Realm extension (not standard ACP)
• anda.md Q5 and anda-decision.md record that Anda consumes Realm over MCP with mcp.md Q5 evidence
• test/docs/phase5-notes.test.ts pins every cited string so an invented revision, version, or API name fails the suite

Task Commits

No per-task commits were made by the executor: the assignment forbids all git commands and commits, and the orchestrator commits between waves.

1. Task 1: Verify Omp ExtensionAPI names — uncommitted (orchestrator commits)
2. Task 2: Record MCP Q5, ACP version plus extension, and the Anda MCP path — uncommitted (orchestrator commits)
3. Task 3: Doc-decision pins with exact cited strings — uncommitted (orchestrator commits)

Files Created/Modified

• test/docs/phase5-notes.test.ts - 8 exact-string pin tests (TOOL-05 x4, OMP-01 x4); reads notes as text, starts no process, touches no network
• docs/integration/omp.md - Phase 5 verification pass table plus per-answer verification lines in Q1-Q4 with official URLs and 2026-10-22 read date
• docs/integration/mcp.md - Q5 decision record (P5-D9)
• docs/integration/acp.md - Q5 decision record (P5-D10)
• docs/integration/anda.md - Q5 Phase 5 direction (P5-D1)
• docs/integration/anda-decision.md - Section 7 Phase 5 direction (P5-D1), revisit triggers renumbered to 8

Decisions Made

• Q5 carries 2026-07-28 as its only revision string: the 2024-11-05 caveat is referenced by pointer to Q1 (no literal), so the no-other-revision pin holds.
• ctx.ui.setStatus(key, text) stays upstream-sourced (OQ-P5-01): the official omp.sh pages name status/widgets only in prose; the exact signature comes from upstream hooks.md.
• Q4 stays OPEN (OQ-P5-01, OQ-P5-02): neither official page documents that setActiveTools removal or a tool_call block provably enforces required mode; plan 05-05 codes fail-closed.
• restrictToolNames / setActiveToolsByName are SDK-session mechanisms (upstream sdk.md), not a plugin mechanism; recorded as such in Q4.

Deviations from Plan

None - plan executed exactly as written. (The mid-run full-disk ENOSPC was environmental and transient: space recovered on its own; one duplicated paragraph from the recovery was removed inline, leaving no content change.)

Issues Encountered

• Disk filled to 100% mid-task, failing one edit with ENOSPC. While investigating, usage dropped to 95% (23G free) on its own. Retried the edit, removed a duplicated paragraph caused by the stale-hash recovery. No files lost; no cleanup of other agents' files performed.
• The edit tool once inserted a literal *** End Patch marker line into acp.md; removed it with a CUT in the next call. Verified the region reads clean.

User Setup Required

None - no external service configuration required.

Next Phase Readiness

• Plans 05-03 (MCP server), 05-04 (ACP agent), and 05-05 (Omp plugin) can code against these notes: revision, version, method name, and API names are pinned by test/docs/phase5-notes.test.ts.
• Blocker for 05-05 awareness: Q4 OPEN — the tool_call block plus residual-risk statement from OQ-P5-02 still needs its proving test in plan 05-05.
• Verification not run by executor (forbidden): orchestrator must run npx tsc -p tsconfig.json && node --test dist/test/docs/phase5-notes.test.js and grep the test titles for TOOL-05 and OMP-01 per the plan's verification step.

---

Phase: 05-omp-plugin-mcp-and-acp-surfacesCompleted: 2026-10-22