PROPOSAL: Dump Doctor
OPENPull Request
node-deployment-operations
Development Fund Proposal Submission
Proposal file: /proposal<Dumb Doctor>.md
---
Summary
Dump Doctor is a safe, offline-first CLI that turns Canton health.dump() ZIPs into a prioritized triage report (Markdown + JSON) with redaction-by-default, so operators can diagnose incidents faster and share consistent evidence in support tickets. It standardizes interpretation of logs, metrics, and thread dumps into actionable “what to check next” findings grounded in Canton troubleshooting guidance, without requiring any node changes or privileged write access.
---
Checklist
- [x] Proposal file added under
/proposals/ - [x] Milestones and funding amounts defined
- [x] Acceptance criteria included
- [x] Alignment with Canton priorities described
---
Notes for Reviewers
- Safe-by-default: Dump Doctor is offline-first and read-only. It only parses
health.dump()ZIPs and never performs admin write actions, node mutations, uploads, or telemetry by default. - Not observability or LocalNet tooling: This proposal does not add dashboards, monitoring stacks, or local dev environment orchestration. It focuses solely on fast interpretation of an existing diagnostic artifact.
- Deterministic and testable: Outputs are deterministic (stable ordering, stable rule IDs, versioned JSON schema) and backed by fixture-based tests to minimize regressions across Canton versions.
- Redaction and data handling: Reports are redacted by default with bounded evidence excerpts to reduce leakage risk; optional evidence extraction is explicit and opt-in.
- Scope is intentionally narrow: MVP ships a curated high-signal rulepack (10–15 rules) grounded in official troubleshooting guidance, with a data-driven rule format to support future community extensions without scope creep.