Skip to main content

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 (alias context), 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)

Source distribution for specflow-cli 0.2.1
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)

Table of built distributions (wheels) for specflow-cli 0.2.1
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

0.2.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page