Add sync health checks and doctor output
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 35
- Forks
- 4
- Avg merge
- 17h 19m
- Merged PRs (30d)
- 8
Description
Context
Future work from docs/superpowers/specs/2026-05-24-local-libsql-migration-design.md.
The local libsql migration and embedded replica/sync mode are prerequisites. This issue should expose direct status signals rather than inferring health from side effects.
Scope
- Add explicit health probes for configured cloud-backed storage modes.
- Report sync/replica status through doctor and runtime health surfaces.
- Define thresholds for stale sync, authentication failures, and unreachable remote databases.
- Ensure errors propagate to logs and operator-visible checks.
Acceptance Criteria
- Local-only agents do not show irrelevant cloud warnings.
- Cloud-backed agents expose direct sync status and last-error details.
- Doctor output includes actionable remediation without leaking secrets.
- Tests cover healthy, stale, auth-failed, and unreachable states.
Out Of Scope
- Designing cloud configuration.
- Implementing backup/restore UX.
- Migrating from
rusqliteto locallibsql.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with docs/superpowers/specs/2026-05-24-local-libsql-migration-design.md, then locate the doctor and runtime health surfaces that handle cloud-backed storage. Define how healthy, stale, authentication-failed, and unreachable states appear, and run or add tests covering those states, local-only warning suppression, actionable remediation, and secret-free output.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- databases, observability
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100