SpecFlow CLI
Copyright (c) 2026 Rômulo Penha. Licença MIT para este pacote autoral.
CLI local para preparar projetos, recuperar contexto e verificar gates de um processo Spec Driven próprio. O agente no editor executa especificação, implementação e revisão; o terminal não chama IA automaticamente. phaseExecuted=false significa que preparar a instrução não concluiu a fase.
Instalação local
Python >=3.11. Uv é recomendado, não obrigatório; o wheel também é um pacote Python padrão instalável em ambiente isolado.
uv tool install specflow-cli
specflow --version
specflow init meu-projeto --integration copilot
cd meu-projeto
specflow doctor
specflow nova-change "Criar cadastro de clientes"
Execute a instalação a partir do diretório que contém dist. Para as duas integrações, repita --integration codex. Em consumidor existente, use specflow init .; mesma versão permite acrescentar integração sem resetar configurações. Atualizar o pacote não aplica upgrade nos consumidores.
doctor considera opcionais em DEFINIR como inativos, sem executar probes. O arquivo configuracao.properties é sempre criado no init e preservado depois. Qualquer DEFINIR mantém o recurso inteiro inativo. Campos só opcionais no modo declarado podem usar NAO_APLICAVEL. Perfis none/basic/token validam configuração, sem certificar API ou versão de serviço externo.
Comandos
init,doctor,nova-change: estrutura, configuração e rascunhos.contexto(aliascontext),check,evaluate: leitura determinística e gates, sem aplicar transições.especificar,esclarecer,revisar-spec,planejar,implementar,teste-humano,revisar-implementacao,validar,aprovar,encerrar: instruções para o agente e verificação de suas pré-condições.
Fases recebem --change ID. check/evaluate exigem --target ESTADO. --project seleciona raiz explícita; --json produz saída estruturada. Flags comuns podem vir antes/depois do subcomando; valores conflitantes são rejeitados. --help e --version não exigem projeto. Também disponível via python -m specflow no ambiente Python em que o pacote estiver instalado.
Após nova-change, contexto reconhece RASCUNHO. O agente completa os quatro documentos, manifesta seus hashes e converte explicitamente draft.json em change.json; os dois simultâneos são conflito. Não há comando para inventar aprovação humana. O formato dos registros é descrito nos recursos instalados e validado pelas bibliotecas fechadas de domínio.
Gates e limites
SPEC_APROVADA humana corrente e plano precedem código. Aplicações são geradas abaixo de apps e preservam arquivos existentes. A implementação exige suíte aprovada e cobertura atual mínima de 80% por arquivo/agregado, meta 90%, aceitando valores maiores. Evidências de implementação vinculam contrato + build por targetManifest; a entrega vincula o build em artifactManifest. Mudanças em contrato, testes, logs ou relatórios invalidam os registros dependentes.
validar executa o gate confiável de segurança quando a revisão da implementação permite, sem executar command do JSON. Qualquer achado aberto ou prova insuficiente bloqueia. Os bindings de evidência são necessários além do código 0 do gate. Aprovação, execução das fases e encerramento não são consequências automáticas de um comando ou de testes verdes.
O lock coordena escritores conformes; um editor externo pode causar conflito/WRITE_PARTIAL, sem rollback destrutivo. Recuperação de lock abandonado é ação explícita do operador. O produto verifica consistência, não autentica pessoas nem garante a verdade de evidências. Não importa código do consumidor nem inicializa infraestrutura. Extensões incompletas/direitos desconhecidos e material de pesquisa não integram esta distribuição.
Compatibilidade e descoberta de comandos nos clientes só são homologadas por evidência do ambiente executado; testes unitários e arquivos presentes não certificam Linux ou interface de editor. Publicação e aceite humano do build são etapas separadas.
Organizacao de artefatos (em desenvolvimento)
Na Change 10033, a proposta organiza revisoes em reviews/spec/ e reviews/implementation/, decisoes em decisions/spec/ e decisions/final/, cobertura em coverage/ e evidencias em evidence/. Referencias legadas permanecem validas. Esta alteracao ainda nao foi publicada no PyPI.
Metadata
Release files for specflow-cli 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| specflow_cli-0.2.1.tar.gz | 64.0 kB | With provenance | Details for specflow_cli-0.2.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| specflow_cli-0.2.1-py3-none-any.whl | Python 3 | none | any | Details for specflow_cli-0.2.1-py3-none-any.whl |
Total release size: 127.8 kB
Release files / specflow_cli-0.2.1.tar.gz
| Download URL | specflow_cli-0.2.1.tar.gz |
|---|---|
| Size | 64.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c73314831bb95d94d097416e89c0d785d89c673b813f01d44d943208cec04150
|
|
BLAKE2b-256 checksum How to use checksums |
e59496f9bd152c062b1b67d6002bf343101564dfa557f7b6f1270adc23fbe114
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.
Transparency logRelease files / specflow_cli-0.2.1-py3-none-any.whl
| Download URL | specflow_cli-0.2.1-py3-none-any.whl |
|---|---|
| Size | 63.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c81f15a63ffc7efa9e00d9a025a4ce2c2f1f53ec50ea1b4c0c2b12e74f0b0612
|
|
BLAKE2b-256 checksum How to use checksums |
71ade6494321b7694228b2d7191e5f0943bddd6386fdd2015d53226b5cc9d8ec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.
Transparency logSecurity for specflow-cli 0.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for specflow_cli-0.2.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.