Skip to content

feat: add debug observability foundation#40

Merged
samzong merged 1 commit intomainfrom
feat/debug-observability-foundation
Mar 15, 2026
Merged

feat: add debug observability foundation#40
samzong merged 1 commit intomainfrom
feat/debug-observability-foundation

Conversation

@samzong
Copy link
Collaborator

@samzong samzong commented Mar 15, 2026

Summary

  • Structured debug logging with ring buffer + daily ndjson files across main process, gateway WS, and renderer
  • traceId and feature fields on every DebugEvent for cross-layer request correlation
  • Renderer debug events bridge to main process via debug:renderer-event IPC (fire-and-forget)
  • One-click export bundle: recent-events.ndjson, timeline.json, gateway-status.json, config.sanitized.json, environment.json
  • Troubleshooting guide in DEVELOPMENT.md with event naming conventions, healthy flow references, and common failure pattern lookup table

Test plan

  • pnpm typecheck passes
  • pnpm test — 28 tests pass (includes debug-observability and debug-export tests)
  • Manual: trigger export via devtools window.clawwork.exportDebugBundle(), verify bundle contains renderer-side events
  • Manual: send a message, confirm debug log shows full flow from ipc.ws.send-message.requested through renderer.chat.finalized

🤖 Generated with Claude Code

Structured debug logging across main, gateway WS, and renderer with
traceId/feature correlation, renderer-to-main IPC bridge, and one-click
export bundle. Includes troubleshooting guide for AI-assisted debugging.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Signed-off-by: samzong <samzong.lu@gmail.com>
@github-actions
Copy link

Hi @samzong,
Thanks for your pull request!
If the PR is ready, use the /auto-cc command to assign Reviewer to Review.
We will review it shortly.

Details

Instructions for interacting with me using comments are available here.
If you have questions or suggestions related to my behavior, please file an issue against the gh-ci-bot repository.

@samzong samzong merged commit 9f7e8c3 into main Mar 15, 2026
4 checks passed
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