Skip to content

Document the backup CLI refusal when a saved login targets a loopback address - #738

Draft
cb1kenobi wants to merge 4 commits into
mainfrom
docs/backup-cli-loopback-target
Draft

cb1kenobi wants to merge 4 commits into
mainfrom
docs/backup-cli-loopback-target

Conversation

@cb1kenobi

@cb1kenobi cb1kenobi commented Oct 20, 2026 •

Copy link
Copy Markdown
Member

⊙ Problem

HarperFast/harper#3320 (Backup CLI: refuse restore, delete and purge offline when a saved login targets a loopback address) changes how backup commands treat a target saved by harper login. With a loopback target saved and the local server stopped, restore_backup, delete_backup and purge_backups now fail instead of acting on local files. The backup pages did not mention saved or environment targets at all.

❓ Your call: should these docs wait for the release?

I'd merge them with #3320. The page then describes the fixed behavior. Readers on older patch releases see a refusal their version does not have; an "As of vX.Y.Z" note can be added once the patch versions are known.

💡 Solution

✅ Verification

  • npm run build passes and prettier --check is clean on both files.
  • The behavior was checked against the #3320 branch: the refusal, the offline create_backup/list_backups/verify_backup and the harper logout route were run through the built CLI in a temporary install. The .env and get_backup statements are from reading bin/login.ts and bin/backup.ts, not from a run.

🤖 Generated by Claude Code (Claude Opus 5.5); posted via @cb1kenobi.

Related PRs: none found
Complexity: easy

Review-Coverage: authored=claude; ran=gemini,cursor-composer,codex; adjudicated=domain; declined=cursor-grok,cursor-kimi,cursor-muse; rounds=2; full=1 @ a8cb276

Review-Attention: skim ~2m (decisions: loopback-liveness-proxy, env-target-as-explicit, overview-crosslink-vs-mirror) @ a8cb276

cb1kenobi and others added 3 commits October 20, 2026 03:13
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
gemini-code-assist[bot]

This comment was marked as resolved.

@github-actions
github-actions Bot temporarily deployed to pr-738 October 20, 2026 08:41 Inactive
@github-actions

Copy link
Copy Markdown

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-documentation.harperfabric.com/pr-738

This preview will update automatically when you push new commits.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-documentation.harperfabric.com/pr-738

This preview will update automatically when you push new commits.

This branch was successfully deployed

1 active deployment
pr-738 — 84a635c9 Deployed Oct 20, 2026 by github-actions[bot]
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.

1 participant