Skip to content

fix: show manual install commands on failure, split CLI docs#171

Merged
rhuanbarreto merged 2 commits into
mainfrom
fix/plugin-install-manual-fallback-and-docs-split
Mar 25, 2026
Merged

fix: show manual install commands on failure, split CLI docs#171
rhuanbarreto merged 2 commits into
mainfrom
fix/plugin-install-manual-fallback-and-docs-split

Conversation

@rhuanbarreto

Copy link
Copy Markdown
Contributor

Summary

  • Plugin install fallback: When archgate plugin install auto-installation fails (throws), the error output now includes the manual commands so users can retry themselves. Previously manual commands were only shown when the CLI binary wasn't found, not when the install command itself failed.
  • CLI docs split: Split the monolithic cli-commands.mdx (736 lines) into 11 individual pages per locale under reference/cli/, nested in the sidebar under a "CLI Commands" group. Both EN and PT-BR have full 1:1 page parity.

Test plan

  • bun run validate passes (lint, typecheck, format, 599 tests, 22/22 ADR checks, build)
  • Verify docs build (bun run docs:build) renders all new pages correctly
  • Verify sidebar navigation shows nested CLI command pages
  • Manual test: archgate plugin install with a broken token shows fallback commands

rhuanbarreto and others added 2 commits March 25, 2026 02:21
…I docs

Plugin install: when auto-installation fails (not just when the CLI is
missing), the error output now includes the manual commands so users can
retry themselves. Covers all four editors (claude, copilot, cursor, vscode).

Docs: split the monolithic cli-commands.mdx into individual pages per
command (login, init, plugin, check, adr, review-context, session-context,
upgrade, doctor, clean) with an overview index. Both EN and PT-BR locales
updated with full 1:1 page parity.
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Mar 25, 2026

Copy link
Copy Markdown

Deploying archgate-cli with  Cloudflare Pages  Cloudflare Pages

Latest commit: b9dbc93
Status: ✅  Deploy successful!
Preview URL: https://f9759cc9.archgate-cli.pages.dev
Branch Preview URL: https://fix-plugin-install-manual-fa.archgate-cli.pages.dev

View logs

@rhuanbarreto rhuanbarreto merged commit 91544c4 into main Mar 25, 2026
9 checks passed
@rhuanbarreto rhuanbarreto deleted the fix/plugin-install-manual-fallback-and-docs-split branch March 25, 2026 01:35
@github-actions github-actions Bot mentioned this pull request Mar 25, 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.

1 participant