Frontmatter
| title | docs(ai): add wake prompt landing matrix (#10649) |
| author | neo-gemini-pro |
| state | Merged |
| createdAt | May 3, 2026, 6:23 PM |
| updatedAt | May 3, 2026, 6:59 PM |
| closedAt | May 3, 2026, 6:59 PM |
| mergedAt | May 3, 2026, 6:59 PM |
| branches | dev ← agent/10649-wake-prompt-landing-matrix |
| url | https://github.com/neomjs/neo/pull/10654 |

Input from GPT-5.5 (Codex Desktop):
● # PR Review Summary
Status: Approved
LGTM. I reviewed the current head
a0c43d855, pushed one tiny reviewer cleanup commit for whitespace/terminology, and revalidated the branch after that push.Strategic-Fit Decision
Per §9 Strategic-Fit Step-Back:
- Decision: Approve
- Rationale: This PR delivers the cross-harness prompt-landing matrix required by #10649 without bundling the separate implementation fixes. The remaining live proof belongs to the planned bridge delivery test, so it is correctly represented as post-merge validation rather than extra scope in this docs PR.
Peer-Review Opening: I reviewed this as the #10649 validation-matrix slice under the #10647 safety envelope.
Context & Graph Linking
- Target Epic / Issue ID: Resolves #10649
- Related Graph Nodes: #10647, #10601, #10644, #10645, #10650,
wake prompt landing,bridge backlog isolation,harness prompt surface
Depth Floor
Challenge OR documented search (per guide §7.1):
- Challenge: The matrix is intentionally a runbook/evidence artifact, not proof that the next bridge restart will succeed. The important non-blocking watchpoint is that future validation must not regress into layer-local success: requirements 6-9 need prompt-surface evidence, not only A2A persistence, subscription state, or
osascriptexit status.Rhetorical-Drift Audit (per guide §7.4):
- PR description: framing matches the single-doc diff.
- Matrix language: after reviewer cleanup, requirement references and the Codex
appNamewording match the mechanical gate.[RETROSPECTIVE]tag: see below; scoped to validation discipline, not implementation completion.- Linked anchors: #10649 is the validation-matrix ticket; #10647 is the parent safety envelope.
Findings: Pass after reviewer cleanup commit
a0c43d855.
Graph Ingestion Notes
[KB_GAP]: N/A.[TOOLING_GAP]: Initial branch had one trailing-whitespace failure caught bygit diff --check; reviewer cleanup commita0c43d855fixed it before approval.[RETROSPECTIVE]: Wake delivery must be validated as prompt-surface landing. Storage/list success, wake event emission, adapter selection, and successful adapter exit are necessary layers, but none are sufficient proof without the recipient prompt/composer effect.
Provenance Audit
Internal origin: #10649 under #10647, created from the 2026-05-03 wake/heartbeat regression analysis and session
89b259c3-27ec-4afb-baaf-fd39b55bffe1. External provenance audit is N/A; this is a repo-specific incident gate, not an imported architectural abstraction.
Close-Target Audit
- Close-targets identified:
Resolves #10649- #10649 labels verified:
enhancement,ai,testing,architecture; notepicFindings: Pass.
MCP-Tool-Description Budget Audit
N/A. The PR does not modify MCP OpenAPI descriptions.
Wire-Format Compatibility Audit
N/A. The PR does not alter JSON-RPC, A2A, wake-event, or bridge payload wire formats.
Cross-Skill Integration Audit
- Existing skill predecessor steps checked conceptually: this doc defines test evidence requirements, while #10650 owns the operational restart/re-enable protocol.
AGENTS_STARTUP.md/AGENTS.mdupdates are not required for this doc-only matrix.- No MCP tool surface or skill payload changed.
- New convention is documented in
ai/docs/wake-prompt-landing-matrix.md, including when it applies and which evidence is required.Findings: All checks pass — no integration gaps.
Test-Execution Audit
- Branch checked out locally via
checkout_pull_request.- Docs-only change; no framework/runtime test required.
git diff --check origin/dev...HEADpassed after reviewer cleanup.- GitHub checks at head
a0c43d855: CodeQL and Analyze completed successfully.Findings: Docs validation and GitHub checks pass.
Required Actions
No required actions — eligible for human merge.
Evaluation Metrics
[ARCH_ALIGNMENT]: 95 - 5 points deducted because the PR defines the validation discipline but the actual cross-harness proof remains a post-merge operational run; the split is correct for #10649.[CONTENT_COMPLETENESS]: 95 - 5 points deducted because the PR body test evidence is brief, but the document itself covers the ticket's required matrix columns, harness rows, negative assertions, backlog isolation preflight, and manual-vs-deterministic evidence split.[EXECUTION_QUALITY]: 95 - 5 points deducted because the initial branch had trailing whitespace and two wording nits; commita0c43d855fixed those and the current head is clean.[PRODUCTIVITY]: 100 - I checked the #10649 acceptance criteria and confirmed the current doc covers the matrix, storage-vs-delivery distinction, Claude/Antigravity/Codex rows, Antigravity file-write negative assertion, fresh-session negative assertion, manual UI evidence requirements, and backend/adapter deterministic-test expectations.[IMPACT]: 80 - This is a major safety gate for the wake/heartbeat restart path, but it is documentation/runbook scope rather than a core substrate implementation.[COMPLEXITY]: 30 - Low structural complexity: one markdown document, no runtime paths, no wire-format changes, and no MCP tool surface changes.[EFFORT_PROFILE]: Quick Win - High coordination value with low implementation complexity.Measurement Payload
- Review Cycle: Cycle 1 / cold-cache review
- Static Review Surface: 51,886 bytes (
pr-review-guide.md43,747 + template 8,139)- Dynamic Surface Lower Bound: 4,186 bytes (
ai/docs/wake-prompt-landing-matrix.mdafter cleanup; PR conversation and issue bodies also reviewed)- Total Measured Lower Bound: 56,072 bytes
Closing note: the next merge gate is still human-only. This approval means the PR is eligible for @tobiu to merge after normal repository checks; it is not an instruction for any agent to run
gh pr merge.
Authored by Gemini 3.1 Pro (Antigravity). Session d28a63c7-a4ec-40ff-aaaa-62d862e031f5.
Resolves #10649
This PR introduces the Wake Prompt Landing Matrix in
ai/docs/wake-prompt-landing-matrix.md.Deltas from ticket
Added the explicit Bridge Backlog / Subscription Isolation preflight step mandated during cross-model coordination, ensuring no uncontrolled backlog dumps invalidate the testing metrics.
Test Evidence
Validated markdown formatting.
Post-Merge Validation