Skip to content

fix: resolve documentation inconsistencies and minor code issues#82

Merged
rhuanbarreto merged 4 commits into
mainfrom
fix/docs-inconsistencies
Mar 18, 2026
Merged

fix: resolve documentation inconsistencies and minor code issues#82
rhuanbarreto merged 4 commits into
mainfrom
fix/docs-inconsistencies

Conversation

@rhuanbarreto

Copy link
Copy Markdown
Contributor

Summary

  • Remove phantom archgate mcp command from README (no source/registration exists)
  • Fix plugin path in CLAUDE.md from archgate/claude-code-plugin to ../plugins/claude-code
  • Add ARCH-008 (Typed Command Options) and ARCH-009 (Centralized Platform Detection) to CLAUDE.md ADR list
  • Replace non-existent bun run build with bun run build:check in CLAUDE.md
  • Update .prototools versions in CLAUDE.md to match actual values (Bun 1.3.9, npm 11.11.0)
  • Add all undocumented commands to CLAUDE.md table: plugin, plugin install, plugin url, login status, login logout, login refresh, session-context claude-code, session-context cursor
  • Fix all command description mismatches in CLAUDE.md to match source .description() strings
  • Add review-context and session-context sections to CLI reference docs (en + pt-br for GEN-002 parity)
  • Replace direct console.log with logInfo in git.ts and login-flow.ts for ARCH-003 consistency
  • Update signup error message to direct users to archgate login instead of external URL
  • Add 3s timeout to WSL spawn in resolveCommand to prevent test/runtime hangs on Windows
  • Add missing tests for adr/index.ts and plugin/index.ts command registration

Test plan

  • bun run validate passes (lint, typecheck, format, 310 tests, ADR check, build check)
  • New tests for adr/index.ts and plugin/index.ts verify subcommand registration
  • en/pt-br CLI docs maintain parity (GEN-002)

rhuanbarreto and others added 2 commits March 19, 2026 00:22
- Remove phantom `archgate mcp` command from README
- Fix plugin path in CLAUDE.md to `../plugins/claude-code`
- Add ARCH-008, ARCH-009 to CLAUDE.md ADR list
- Replace `bun run build` with `bun run build:check` in CLAUDE.md
- Update .prototools versions in CLAUDE.md (Bun 1.3.9, npm 11.11.0)
- Add all undocumented commands/subcommands to CLAUDE.md table
- Fix command description mismatches to match source code
- Add review-context and session-context to CLI docs (en + pt-br)
- Replace direct console.log with logInfo in git.ts and login-flow.ts
- Update signup error message to direct users to `archgate login`
- Add 3s timeout to WSL spawn in resolveCommand to prevent hangs
- Add missing tests for adr/index.ts and plugin/index.ts
@cloudflare-workers-and-pages

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

Copy link
Copy Markdown

Deploying archgate-cli with  Cloudflare Pages  Cloudflare Pages

Latest commit: cbe16fd
Status: ✅  Deploy successful!
Preview URL: https://cc41b073.archgate-cli.pages.dev
Branch Preview URL: https://fix-docs-inconsistencies.archgate-cli.pages.dev

View logs

Extend ARCH-002 to enforce centralized logging in helper and engine
files. The new `use-log-helpers` rule flags direct console.log/warn/info
calls, requiring logInfo/logWarn/logDebug from helpers/log.ts instead.

Command files are exempt (I/O layer), along with log.ts (canonical
implementation), reporter.ts (check output system), and login-flow.ts
(interactive device flow UI).
@rhuanbarreto rhuanbarreto merged commit ec50cca into main Mar 18, 2026
9 checks passed
@rhuanbarreto rhuanbarreto deleted the fix/docs-inconsistencies branch March 18, 2026 23:34
@github-actions github-actions Bot mentioned this pull request Mar 18, 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