Skip to content

Add CLI Phase A (version, doctor, status --json) - #7

Merged
cursor[bot] merged 2 commits into
mainfrom
cursor/cli-phase-a-ux-9d62
Sep 13, 2026
Merged

cursor[bot] merged 2 commits into
mainfrom
cursor/cli-phase-a-ux-9d62

Conversation

@aleaz

@aleaz aleaz commented Sep 13, 2026 •

Copy link
Copy Markdown
Owner

Summary

Implements CLI Phase A from ADR 0021:

  • flixbox version / flixbox --version (reads VERSION, falls back to git describe)
  • flixbox doctor [--json] — host/env/Docker readiness without starting the stack
  • flixbox status [--json] [-q] — Compose status plus operator context; machine-readable schema v1
  • Shared exit taxonomy on these paths: 2 usage, 3 Docker, 4 config, 5 dependency

Also

  • Docs: docs/user/17-cli.md, INDEX/REFERENCE/roadmap touch-ups
  • CI contract C-91 for Phase A commands
  • Keep warn_mode_vpn_mismatch / warn_decluttarr_vpn_slow immediately after load_env in cmd_status so C-28/C-90 still pass with the larger --json body

Release notes

docs/releases/v0.1.1-notes.md matches main and the published GitHub Release body (no conflict markers; content already includes the corrected install/credentials/FLIXBOX_PUBLIC_HOST wording).

Test plan

  • Local multi-role QA for version/doctor/status
  • Local C-28/C-90 fragment checks after warn placement fix
  • CI green on 36950eb (secrets, validate, configure-smoke-pr, security)
Open in Web Open in Cursor 

Implement ADR 0021 Phase A discoverability and diagnostics with a
stable exit taxonomy on those paths, operator docs, and CI contract
checks. GitHub repo description still needs a manual Jellyfin-first
update (token cannot edit it).

Co-authored-by: Alejandro Azario <aleaz@users.noreply.github.com>
@aleaz
aleaz marked this pull request as ready for review September 13, 2026 01:41
Move warn_mode_vpn_mismatch / warn_decluttarr_vpn_slow immediately
after load_env in cmd_status (covers --json too) and widen C-28/C-90
grep windows so Phase A status --json does not break validate.

Co-authored-by: Alejandro Azario <aleaz@users.noreply.github.com>
@cursor
cursor Bot merged commit 36950eb into main Sep 13, 2026
5 checks passed
@cursor
cursor Bot deleted the cursor/cli-phase-a-ux-9d62 branch September 13, 2026 18:55
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