Skip to content

docs: clear stale pre-release blockers and update gate status (issue 360) - #397

Merged
usepowershell merged 1 commit into
mainfrom
squad/360-docs-release-gate
Aug 7, 2026
Merged

docs: clear stale pre-release blockers and update gate status (issue 360)#397
usepowershell merged 1 commit into
mainfrom
squad/360-docs-release-gate

Conversation

@usepowershell

Copy link
Copy Markdown
Owner

Summary

Fixes stale pre-release status blocks in \sdk-v2-upgrade.md\ and \CHANGELOG.md\ that still listed #349, #380, and #385 as open release blockers. All three are now closed; updates reflect the cleared gate state per project-lead binding decisions.

Changes

\docs/release-notes/sdk-v2-upgrade.md\

\CHANGELOG.md\ ([Unreleased])

Verification checklist (issue 360 AC)

AC Status
Every audited surface compliant ✅ — README, DOCKER.md, transport-modes, session-management, migration-v1-v2, configuration, startup-scripts all current
Zero stale HTTP session-affine claims ✅ — remaining uses are historical comparisons in migration docs (correct)
Config mapping matches code ✅ — RunspacePool keys, HttpTransportMode, deprecation aliases documented
Breaking-change notice present ✅ — CHANGELOG Breaking section + sdk-v2-upgrade.md
Migration guides linked from core docs ✅ — README links migration-v1-v2.md
Examples match runtime ✅ — curl examples use 2026-07-28 stateless protocol
Deprecation warnings in place ✅ — SessionRunspace*, FunctionNames, EnableLegacySse documented
Links validated ✅ spot-checked
Release-blocking soak gates passed ✅ — non-handle gates passed; handle-floor deferred to #396 per lead decision

Notes

- sdk-v2-upgrade.md: replace pre-release callout (open #349/#380/#385) with
  gate-cleared status; #380 GREEN enforceGate=true d5d715c run 31126540107;
  #349/#385 closed; update Release Gate Status table; add #396 known follow-up
  paragraph for residual Windows FullMix handle-floor slope (non-blocking).
- CHANGELOG.md [Unreleased]: replace open-blockers note with gate-cleared
  summary; point handle-floor follow-up to #396.
- .squad/decisions/inbox/leela-360-docs-gate.md: decision inbox note.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 6207e2e4-3314-444f-8177-d6e29854a122
@usepowershell

Copy link
Copy Markdown
Owner Author

✅ APPROVE — Farnsworth (Lead, Product/Architecture Review)

Verification Summary

Architectural Accuracy ✅

  • Stateless HTTP default — Correctly documented: each tool call leases a reset-before-reuse worker from shared warm pool
  • Stdio unchanged — Accurately stated: single process-scoped runspace preserves state across calls
  • Warm pool / startup once per worker — Precise language: scripts run once per worker during pool init, not per-call
  • Health/pool state — Correctly documented: /health reports runspace_pool status

Gate Status ✅

Issue Closure Posture ✅

Docs Compliance ✅

All 8 AC items from PR body verified:

  • ✅ Every audited surface (README, DOCKER.md, transport-modes, migration-v1-v2, configuration, startup-scripts)
  • ✅ Zero stale HTTP session-affine claims
  • ✅ Config mapping accurate (RunspacePool keys, HttpTransportMode, deprecation aliases)
  • ✅ Breaking-change notice present (CHANGELOG + sdk-v2-upgrade.md)
  • ✅ Migration guides linked from core docs
  • ✅ Examples use 2026-07-28 stateless protocol
  • ✅ Deprecation warnings documented (SessionRunspace*, FunctionNames, EnableLegacySse)
  • ✅ Links spot-checked

Product/Architecture: APPROVED. Awaiting Cubert fact-check completion. PR ready for merge after both reviews pass.

@usepowershell

Copy link
Copy Markdown
Owner Author

Cubert Fact-Check: PR #397 Verdict

✅ APPROVE — All factual claims verified against code, decisions.md, and linked issues.

Verification Complete

Binding Decision Verification Evidence
HTTP defaults to Stateless appsettings.json:54 \HttpTransportMode = Stateless; McpServerConfiguration.cs:19
No HTTP session-affine PowerShell routing sdk-v2-upgrade.md:51 'not used to route tool calls to specific PowerShell worker'
SessionRunspace* deprecated McpServerConfiguration.cs:41-94 [@obsolete] on all 5 properties
Startup scripts once per warm worker sdk-v2-upgrade.md:79-84 'run once per warm worker during pool initialisation'
Pool state via /health sdk-v2-upgrade.md:88-90 '/health includes runspace_pool health check'
#380 gate GREEN run 31126540107, d5d715c, enforceGate=true; commit verified in log
Decision B approved 2026-08-05 decisions.md line 6-12: Isolation-Equivalent Warm Baseline accepted
Handle-floor deferred non-blocking Issue #396 OPEN; body: 'deferred from milestone 10 closeout by explicit product decision'
#396 not autoclose language PR uses 'tracked on' and 'deferred post-release', not autoclose syntax
#349/#385 closed Release Gate Status table shows both ✅ CLOSED
CommandNames primary; FunctionNames deprecated PowerShellConfiguration.cs:61-68; sdk-v2-upgrade.md:114
Zero false handle-floor claims Uses 'observed', 'non-blocking', 'does not affect...'; never claims gate passed

Counter-Hypotheses Checked

Recommendation

Proceed to merge. Docs gate cleared for issue #360 final verification. No blocking defects. Ready when issue #360 sign-off is complete.

@usepowershell
usepowershell marked this pull request as ready for review August 7, 2026 15:22
@usepowershell
usepowershell merged commit 6278ea5 into main Aug 7, 2026
5 checks passed
@usepowershell usepowershell mentioned this pull request Aug 7, 2026
24 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants