feat(cli): Introduce CLI for local dev, API queries, and reports#66
Closed
caiocollete wants to merge 4 commits intoWorld-Open-Graph:mainfrom
Closed
feat(cli): Introduce CLI for local dev, API queries, and reports#66caiocollete wants to merge 4 commits intoWorld-Open-Graph:mainfrom
caiocollete wants to merge 4 commits intoWorld-Open-Graph:mainfrom
Conversation
- Added pyproject.toml for project configuration and dependencies. - Created main CLI entry point in main.py using Typer. - Implemented command groups for API queries, development management, ETL processes, health checks, and report generation. - Introduced configuration management with settings loaded from environment variables. - Established command structure for querying the public BR-ACC API and managing local development environments.
…tions and command structure - Introduced a detailed README.md for the BR-ACC CLI, outlining its functionalities, installation steps, configuration options, command structure, and usage examples. - Documented requirements and environment variable configurations necessary for operation. - Included sections for local environment management, health checks, API queries, ETL processes, and report generation.
- Introduced DEV_NOTES.md to provide guidance for developers on using `cypher-shell` with `bracc dev seed`. - Added uv.lock file to manage project dependencies, specifying versions and sources for required packages.
caiocollete
changed the title
Collaborator
|
Maintainer triage on March 8, 2026: refused for merge in this cycle and kept open. Blockers:
Required next step: split the CLI into narrower pieces or bring it back in a dedicated full-manual-review cycle. |
brunoclz
added
status:denied-cycle
Author
|
Hi Bruno, what should be the maximum number of lines per PR? This has 962 modified lines, but 483 are about documentation and uv.lock. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Add BR-ACC CLI for local development, API queries, ETL workflows, and report viewing. Centralizes commands that were previously run via
docker compose, shell scripts, and manual API calls.Release metadata
Release note (PT-BR):
CLI oficial do BR-ACC para operar o ambiente local, consultar a API pública, executar ETLs e acessar relatórios.
Release note (EN):
Official BR-ACC CLI for local operations, public API queries, ETL pipelines, and report access.
Release highlights (PT-BR, bullets with
|):| Comandos
dev(up, down, restart, seed) para ambiente local || Healthcheck da API e Neo4j |
| Consultas à API pública (meta, company, patterns) |
| Execução de ETLs (list, run, run-all, status) |
| Leitura de relatórios em
audit-results/|Release highlights (EN, bullets with
|):|
devcommands (up, down, restart, seed) for local environment || API and Neo4j healthcheck |
| Public API queries (meta, company, patterns) |
| ETL execution (list, run, run-all, status) |
| Report reading from
audit-results/|Included pattern IDs (comma-separated, or
none):none
Technical changes (PT-BR, bullets with
|):| Novo pacote
bracc-cliemcli/com Typer e Rich || Integração com
bracc-etlviauv runou binário || Configuração via
.env(BRACC_API_URL, NEO4J_PASSWORD) |Technical changes (EN, bullets with
|):| New
bracc-clipackage incli/using Typer and Rich || Integration with
bracc-etlviauv runor binary || Configuration via
.env(BRACC_API_URL, NEO4J_PASSWORD) |Change type (choose one release label from taxonomy):
release:majorrelease:featurerelease:patternsrelease:apirelease:datarelease:privacyrelease:fixrelease:docsrelease:infrarelease:securityBreaking change?
Validation
Public safety and compliance checklist
PUBLIC_MODEbehavior was reviewed (if relevant)docs/release/public_boundary_matrix.csvRisk and rollback
Risk: Low. The CLI is additive and does not change API, ETL, or frontend. It only adds a new tool for developers.
Rollback: Remove the
cli/directory and thebracc-clipackage. No impact on existing services.