Skip to content

Post-Phase-10 — backup-service path fix + docs/USER_GUIDE.md#8

Merged
NazmulGit merged 1 commit into
mainfrom
claude/review-project-brief-R6PXw
Apr 28, 2026
Merged

Post-Phase-10 — backup-service path fix + docs/USER_GUIDE.md#8
NazmulGit merged 1 commit into
mainfrom
claude/review-project-brief-R6PXw

Conversation

@NazmulGit
Copy link
Copy Markdown
Owner

backup-service.ts now sources the DB path from the live better-sqlite3 handle (getDb().name) rather than re-reading config.dbPath. The two values are always equal in production, but the test harness installs a tmp DB and the route's loadConfig() returned the host's real path, causing ENOENT during create + filepath/id undefined during delete + restore. Same fix applied to the restoreBackup swap path. Production behaviour unchanged.

docs/USER_GUIDE.md (792 lines) — task-oriented walkthrough:

  1. Install — npm / install.sh / Docker / source
  2. First launch — wizard prompts, what each one writes,
    where the bearer token shows up
  3. Tour of the UI — every sidebar group, every page,
    header chrome, offline banner, mobile
  4. Common workflows — deploy agent · approve task ·
    diagnose with Doctor · take + restore
    backup · adjust budget after auto-pause ·
    schedule a heartbeat · add a model key ·
    chase a budget anomaly
  5. CLI reference — every subcommand + every env var
  6. Keyboard shortcuts — palette, jump-actions, G-then-X chord
  7. Configuration — config.json keys + every file under
    ~/.clawcontrol/ with mode + role
  8. Backups — what's in an archive, schedule + retention,
    manual + UI + DR paths
  9. Updates — 8-stage install pipeline, auto-install
  10. One-click scaling — listInstances / createInstance /
    stopInstance / getInstanceHealth
  11. Going to production — admin token, host binding, supervisor
    choice, off-host backups, logging,
    doctor as a CI smoke test
  12. Troubleshooting — symptoms → causes → fixes for the failure
    modes ops actually hit
  13. FAQ — port discrepancy, no-OpenClaw mode, adapter
    and Doctor extension points, multi-instance,
    package-name override, where to file bugs

Verified:
pnpm typecheck → clean
pnpm test → 28 server + 15 ui = 43 passing
pnpm build → server bundle 2.4 MB · UI 90.3 KB gzip JS
cold boot via CLI → server up in ~1 s, REST + WS smoke tests
green, graceful stop via SIGTERM (8 s grace)

backup-service.ts now sources the DB path from the live
better-sqlite3 handle (getDb().name) rather than re-reading
config.dbPath. The two values are always equal in production,
but the test harness installs a tmp DB and the route's
loadConfig() returned the host's real path, causing
ENOENT during create + filepath/id undefined during
delete + restore. Same fix applied to the restoreBackup
swap path. Production behaviour unchanged.

docs/USER_GUIDE.md (792 lines) — task-oriented walkthrough:
  1. Install        — npm / install.sh / Docker / source
  2. First launch   — wizard prompts, what each one writes,
                      where the bearer token shows up
  3. Tour of the UI — every sidebar group, every page,
                      header chrome, offline banner, mobile
  4. Common workflows — deploy agent · approve task ·
                       diagnose with Doctor · take + restore
                       backup · adjust budget after auto-pause ·
                       schedule a heartbeat · add a model key ·
                       chase a budget anomaly
  5. CLI reference  — every subcommand + every env var
  6. Keyboard shortcuts — palette, jump-actions, G-then-X chord
  7. Configuration  — config.json keys + every file under
                       ~/.clawcontrol/ with mode + role
  8. Backups        — what's in an archive, schedule + retention,
                       manual + UI + DR paths
  9. Updates        — 8-stage install pipeline, auto-install
  10. One-click scaling — listInstances / createInstance /
                          stopInstance / getInstanceHealth
  11. Going to production — admin token, host binding, supervisor
                            choice, off-host backups, logging,
                            doctor as a CI smoke test
  12. Troubleshooting — symptoms → causes → fixes for the failure
                        modes ops actually hit
  13. FAQ           — port discrepancy, no-OpenClaw mode, adapter
                       and Doctor extension points, multi-instance,
                       package-name override, where to file bugs

Verified:
  pnpm typecheck → clean
  pnpm test      → 28 server + 15 ui = 43 passing
  pnpm build     → server bundle 2.4 MB · UI 90.3 KB gzip JS
  cold boot via CLI → server up in ~1 s, REST + WS smoke tests
  green, graceful stop via SIGTERM (8 s grace)
@NazmulGit NazmulGit merged commit b76199d into main Apr 28, 2026
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.

2 participants