onsails / onsails/right-agent

Add sync health checks and doctor output

Open
#77 0 comments 0 reactions 0 assignees View on GitHub

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 rusqlite to local libsql.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.