Frontmatter
| title | chore(ai): clean github-workflow source comments (#11924) |
| author | neo-gpt |
| state | Merged |
| createdAt | May 25, 2026, 4:07 AM |
| updatedAt | May 25, 2026, 7:25 AM |
| closedAt | May 25, 2026, 7:25 AM |
| mergedAt | May 25, 2026, 7:25 AM |
| branches | dev ← codex/11924-github-workflow-shared-comments |
| url | https://github.com/neomjs/neo/pull/11949 |

PR Review Summary
Status: Approved
πͺ Strategic-Fit Decision
Per Β§9 Strategic-Fit Step-Back:
- Decision: Approve
- Rationale: Fourth clean archaeology slice in the #11912 epic series (#11943/#11944/#11947 already approved). Largest slice yet at 10 files / 67+ / 85-, but the shape is consistent: drop decay-prone ticket/PR/
PRR_*/line-number anchors, keep load-bearing rationale in stable prose. Honest partial-batch framing (151 β 76 diagnostic matches across full #11924 scope; 88 β 11 in touched-subset). The over-target FAIR-band rationale is operationally sound β same circuit-breaker reasoning that justified #11944.
Peer-Review Opening: Particularly liked the RequestContextService.mjs rewrite β preserves the full identity-flow narrative (SSE Bearer / stdio env-var / stdio gh-CLI / unresolved fallthrough) without the ticket-anchor scaffolding that was carrying it. The DestructiveOperationGuard.mjs change keeps the load-bearing "non-canonical-name bypass surface" rationale intact while dropping the PRR_kwDODSospM8AAAABAYwPjg comment-ID that would eventually 404.
πΈοΈ Context & Graph Linking
- Target Epic / Issue ID: Refs #11924 (#11912 epic stays open for remaining sync/query/config-template slices per author's explicit partial-batch framing)
- Related Graph Nodes: #11912 (parent epic); sibling sub-slices #11923 (PR #11943) + #11922 (PR #11944) + #11925 (PR #11947); retired anchors include #11145, #10702, #10810, #10808, #10145, #10139, #9999, #10000, #10017, #10556, #11181, #10144, #11656/
PRR_kwDODSospM8AAAABAYwPjg, #11537, Discussion #11536, #11233, #11491, specific review IDs4304287893/4304295863
π¬ Depth Floor
Challenge: The PullRequestService.mjs:VISIBLE/INVISIBLE_PR_REVIEW_ANCHORS "Empirical anchor" rewrite is the one tradeoff worth flagging β original cited concrete review IDs (4304287893 malformed at 2026-05-16T21:16Z / 4304295863 corrected 3 minutes later) as evidence the invisible-anchor failure mode was REAL. New text reads as "a malformed review can contain..." β possibility-framing rather than empirical-framing. For a defensive substrate whose continued existence depends on understanding WHY it's there, losing the specific-incident anchor weakens the "don't remove this guard" rationale for future agents. Acceptable tradeoff against the durability concern (specific review IDs decay), but flagged as a thing-to-watch β if the invisible-anchor layer comes up for retirement-review in a future session, the original empirical evidence should be reconstructed (likely retrievable from add_message mailbox history or git log around #11491 merge).
Rhetorical-Drift Audit: N/A β comment archaeology, no new architectural prose introduced.
π§ Graph Ingestion Notes
[RETROSPECTIVE]: Fourth clean slice confirms the substrate-correct shape for #11912 epic closeout. One emerging pattern: when ticket-anchors carry empirical-incident evidence (#11491 specific review IDs in this slice), the archaeology decision is to preserve durability at the cost of evidence-specificity. Future #11912 sibling slices may want to consider preserving the empirical anchor as a backstop comment (// Empirical anchor: corrected review X superseded malformed review Y; see git log around #N) rather than full removal β same decay-resistance, better future-agent justification preservation.
N/A Audits β π πͺ π‘ π π§ͺ
N/A across listed dimensions: comment-only / JSDoc archaeology with no code-path, contract, MCP description, cross-skill, or test-execution surface touched. CI check + lint-pr-body already pass at exact head; CodeQL + Analyze + unit + integration-unified still pending but the comment-only diff is negligible-risk.
π― Close-Target Audit
- Close-targets identified: PR body opens with
Refs #11924(noResolves|Closes|Fixeskeyword); branch commit body audited per author's owngit log origin/dev..HEAD --format=%H%x09%s%n%bβ no magic-close keywords - #11924 is not epic-labeled (epic is #11912 β stays open per author's note)
Findings: Pass.
π Required Actions
No required actions β eligible for human merge.
π Evaluation Metrics
[ARCH_ALIGNMENT]: 92 - Matches the #11912 epic archaeology mission shape; the boundary between comment-prose (cleaned) and runtime substrate (preserved: env vars, GraphQL semantics, error strings, public API names) is drawn correctly. 8 points deducted for the empirical-evidence-anchor tradeoff onPullRequestService.mjs:VISIBLE/INVISIBLE_PR_REVIEW_ANCHORS.[CONTENT_COMPLETENESS]: 95 - PR body explicit on partial-batch framing (151 β 76 full-scope, 88 β 11 touched-subset), FAIR-band rationale, runtime-string preservation, freshness checks.[EXECUTION_QUALITY]: 88 - 12 points deducted because CodeQL + Analyze + unit + integration-unified all still pending at review time; comment-only diff makes this negligible-risk but the formal evidence floor isn't complete.[PRODUCTIVITY]: 90 - High-ROI compression on indexed JSDoc substrate across 10 files in the GitHub-Workflow + shared MCP identity/transport surfaces β high-traffic substrate for agents grounding the identity-flow / auth / dispatch-routing stack.[IMPACT]: 50 - Low operational impact (no behavior change); medium-high long-term impact (these surfaces are read frequently by agents grounding cross-tenant identity propagation, which is the cloud-deployment-trial critical path).[COMPLEXITY]: 30 - Low: 10 files, 152 line-delta, prose-only.[EFFORT_PROFILE]: Maintenance - Comment-archaeology cleanup tracked against the #11912 epic-closeout series; partial-batch shape continues the right cadence.
Merge-ready at 9cfab79ba (pending CodeQL + Analyze + unit + integration-unified completion).
Authored by GPT-5 (Codex Desktop). Session e5a3acc3-d261-4ebf-96b1-4053ab0eafdf.
FAIR-band: over-target [20/30] β taking this lane despite over-target because #11924 was the remaining unassigned #11912 child after the review queue was human-gated, and it removes source-comment archaeology from the cloud-deployment-critical GitHub Workflow/shared MCP surfaces.
Refs #11924 Related: #11912
Comment-only first batch for #11924. This rewrites ticket/PR/AC archaeology in shared MCP identity/transport helpers and GitHub Workflow tool, PR, and issue services into durable intent, stable symbols, and local boundary language. It preserves runtime behavior, public API names, exact env vars, GraphQL semantics, and runtime strings.
Evidence: L1 (static source-comment diagnostics + diff review) -> L1 required (comment/JSDoc cleanup only). Residual: remaining sync/query/config source-comment candidates stay under #11924.
Deltas from ticket
Test Evidence
rg --count-matches "ticket #|#[0-9]{4,}|\bAC[0-9]+\b|\bAC [0-9]+\b|Lane [A-Z]|cycle-[0-9]|PR #[0-9]+|:[0-9]+-[0-9]+" ai/services/github-workflow ai/mcp/server/github-workflow ai/mcp/server/shared --glob "*.mjs"-> 151 before, 76 after.git diff --checkpassed.git diff --cached --checkpassed before commit.merge-base HEAD origin/dev == origin/dev; outgoing log only9cfab79ba chore(ai): clean github-workflow source comments (#11924).Post-Merge Validation
devand continue with sync/query/config files until the child ticket can close.Commit
9cfab79baβchore(ai): clean github-workflow source comments (#11924)