Hexastack Tools (packages/hexastack_tools)

Developer tooling, repository governance, code-scanning analysis, and CI automation suite for the Hexastack monorepo.

📖 Complete Documentation & Usage

For full CLI usage instructions and command examples, see the canonical USAGE Guide or the online developer documentation.

🏛️ Architectural Intent

hexastack-tools strictly dogfoods Hexastack's own hexagonal architecture with:

• domain/: Pure data contracts (PrSummary, CheckRunFinding, ReviewThread, OutputFormat).
• ports/: Decoupled port interfaces (GitHubApiPort).
• adapters/: REST/GraphQL HTTP adapters (GitHubHttpAdapter) and multi-format presenters (pr.py, checks.py, security.py).
• commands/: Clean Typer CLI entrypoints.
• utils/: Shared monorepo workspace discovery and package graph resolvers.

⚙️ Output Presentation Modes

All CLI commands support multi-format presenters:

1. auto (default): Renders interactive Rich tables/panels if connected to a terminal TTY, or automatically switches to plain TSV when output is piped to tools like grep, awk, cut, or xargs.
2. rich: Colorized ANSI dashboards with status icons and panels.
3. json: Structured JSON payload for CI integration or agent tooling.
4. plain: Clean, newline- and tab-delimited (TSV) stream.

🛠️ Quick Command Reference

| uv run pypi-build | Builds sdist and wheel packages across workspace. | | uv run pypi-check | Verifies build metadata and checks for PyPI release collisions. | | uv run codeql-scan | Runs local SARIF CodeQL SAST security scan. |

For detailed syntax and flags, see USAGE.md.