Skip to content

docs(#518/#519/#520): case study — the trace that couldn't name its socket - #528

Merged
debugmcpdev merged 1 commit into
mainfrom
docs/518-519-520-case-study
Aug 27, 2026
Merged

docs(#518/#519/#520): case study — the trace that couldn't name its socket#528
debugmcpdev merged 1 commit into
mainfrom
docs/518-519-520-case-study

Conversation

@debugmcpdev

Copy link
Copy Markdown
Collaborator

Summary

The measure-fix-measure narrative behind the #518/#519/#520 observability cluster (PRs #524/#525/#526): one scripted js-attach scenario against the real server — idle node --inspect target, DAP_TRACE=1, attach → 14s wait → pause → stack → failing evaluate — run byte-for-byte identically before and after the fixes, with the artifact diffs as the acceptance test.

Signal Before (main @ f9b9019) After
threads frames in the attach trace 222 (111 futile polls + false warning) 4, no warning
routing lines in proxy-<sessionId>.log 0 (905 in an undocumented per-pid file) 520
failed-response log lines no success flag anywhere success: false, request_seq: …
trace records naming their connection 0 of 348 129 of 129 (parent/child:<id8>)

Adds the case study under docs/case-studies/ and one README line, following the #523 pattern.

Dogfood side-finding filed during the capture: #527 (dev-proxy can't inject backend env vars).

🤖 Generated with Claude Code

https://claude.ai/code/session_017Qu6eqpquEZ5rdXHV5s7QA

…ocket

The measure-fix-measure narrative behind PRs #524/#525/#526: one scripted
js-attach scenario against the real server, run byte-for-byte identically
before and after the fixes, with the artifact diffs as the acceptance
test. Baseline reproduced all three filings on Windows (111 futile
threads polls ending in a false warning; 0 routing lines in the
per-session log vs 905 in an undocumented per-pid file; 0 of 348 trace
records naming their connection); the after run measured 4 threads
frames, 520 routing lines in the session log, success flags on response
lines, and 129 of 129 records tagged parent/child.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017Qu6eqpquEZ5rdXHV5s7QA
@codecov

codecov Bot commented Aug 27, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@debugmcpdev
debugmcpdev merged commit 5985661 into main Aug 27, 2026
10 checks passed
@debugmcpdev
debugmcpdev deleted the docs/518-519-520-case-study branch August 27, 2026 18:39
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