Skip to content

Record that AlchemyDiag is permanent, not temporary instrumentation - #70

Open
MMagTech wants to merge 1 commit into
masterfrom
docs/keep-diag-permanently
Open

Record that AlchemyDiag is permanent, not temporary instrumentation#70
MMagTech wants to merge 1 commit into
masterfrom
docs/keep-diag-permanently

Conversation

@MMagTech

Copy link
Copy Markdown
Owner

Both the AlchemyDiag header and setupDebugGesture carried "remove once the investigation concludes" notes. The decision is to keep them, so those notes are now a trap — a future reader would strip a tool that's relied on.

Rewrites both to record why it stays:

  • The failures it catches happen on one device, while backgrounded, intermittently, and leave no server-side trace.
  • Reasoning from source produced several confident wrong answers during the recent investigation; the log produced the right one in minutes.
  • The iOS behaviour it probes is undocumented and changes between releases, so the next regression wants the instrument already in place.

Also notes that on the installed PWA the long-press gesture is the only route to the log — no address bar to type /?debug=1 into, and Safari reads a different storage partition.

Comments only. No behaviour change, so no cache version bump — a browser serving the previously cached file loses nothing.

🤖 Generated with Claude Code

Both the AlchemyDiag header and setupDebugGesture carried "remove once the
investigation concludes" notes. The decision is to keep them, so those
notes are now a trap -- a future reader would strip a tool that is relied
on.

Rewrites both to say why it stays: the failures it catches happen on one
device, while backgrounded, intermittently, and leave no server-side
trace. Reasoning from source produced several confident wrong answers
where the log produced the right one immediately, and the iOS behaviour it
probes is undocumented and changes between releases.

Also notes that on the installed PWA the long-press gesture is the only
route to the log, since there is no address bar and Safari reads a
different storage partition.

Comments only -- no behaviour change, so no cache version bump needed.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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.

1 participant