Skip to content

feat(debug): add opt-in diagnostics for commands and updates - #81

Merged
benbenbang merged 2 commits into
mainfrom
feature/update-diagnostics
Oct 9, 2026
Merged

benbenbang merged 2 commits into
mainfrom
feature/update-diagnostics

Conversation

@benbenbang

Copy link
Copy Markdown
Member

Add safe, opt-in diagnostics to make command execution and release checks easier to troubleshoot without changing normal output or exposing sensitive data.

  • Add structured JSON debug logging across configuration, retries, updates, skills, MCP, daemon, and management operations.
  • Improve update diagnostics with categorized failures, HTTP and rate-limit metadata, and clearer CLI errors.
  • Document the debug output and rate-limit behavior, with comprehensive logging and diagnostics coverage.

Add a `--debug` flag that emits safe JSON diagnostics to stderr without
changing normal command output or operation results.

Instrument configuration, API retries and responses, updates, skill
installation, MCP lifecycle and requests, and authenticated management with
stage outcomes, status codes, and timing while excluding credentials,
prompts, URLs, paths, headers, bodies, and raw errors. Update the README and
add coverage for the logging and CLI behavior.
Improve update diagnostics by categorizing lookup and download failures, reporting HTTP and rate-limit metadata, and exposing clearer CLI errors for release checks. Add coverage for diagnostic behavior and document the new debug output and rate-limit handling.
@benbenbang
benbenbang enabled auto-merge (rebase) October 9, 2026 16:27
@github-actions github-actions Bot added documentation Improvements or additions to documentation triage labels Oct 9, 2026
@benbenbang
benbenbang merged commit acfe016 into main Oct 9, 2026
5 checks passed
@benbenbang
benbenbang deleted the feature/update-diagnostics branch October 9, 2026 16:28
@ptah-bw-technical-app

Copy link
Copy Markdown

🎉 This PR is included in version 1.5.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation released triage

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant