usage: bb [-h] [--root RAIZ] <comando> ...

Big Bang: ferramentas do framework.

positional arguments:
  <comando>
    targets (alvos)     lista alvos e formatos de deploy instalados (somente
                        leitura)
    config              lê o bigbang.toml
    generate (gerar)    gera a camada gerada a partir de .bigbang/ e do
                        bigbang.toml
    init                Fundação F0: cria o bigbang.toml e liga o projeto ao
                        GitHub
    verify (verificar)  confere framework, arquivos gerados e workflows
    test (testes)       executa a suíte completa ou os testes afetados no
                        Flash
    claim (assumir)     confirma a posse e abre uma pasta de trabalho própria
    renew               v3: renova o prazo da posse da sessão na pasta atual
    unclaim (liberar)   libera a posse da sessão na pasta de trabalho atual
    status              resumo dos painéis, posses, flags e segurança (somente
                        leitura)
    acceptance (aceite)
                        testes de aceite do épico
    decision (decisao)  registra uma decisão do dono (frase + label)
    review (revisao)    revisão de PR
    checklist           validação final
    pipeline (esteira)  regras da esteira para os scripts (uso interno)
    migrate (migrar)    migração opcional para a v3, em quatro PRs
    board               v3: quadro único (labels, Project, reconciliação)
    move                v3: move um cartão conferindo regras, portões e
                        evidências
    sprint              v3: inicia a sprint dos épicos em Selected
    branches            v3: cria as branches desbloqueadas a partir da develop
    merge               v3: mescla um PR aprovado e verde na develop ou na
                        release (nunca na main)
    release             v3: corte e portão da release
    qa                  v3: homologação
    autonomy            v3: modo autonomous (contrato e controles)
    cleanup             v3: faxina de branches concluídas; relata posses
                        antigas
    flag                v3: liga, desliga ou lista feature flags (flags.toml)
    docs (documentacao)
                        documentação local privada ou Wiki pública versionada
    community (comunidade)
                        padrões de Discussions, painéis e Social preview
    update (atualizar)  atualiza o framework numa branch framework/vX.Y.Z (PR)
    package (pacote)    empacota .bigbang/ para a release do framework
                        (manutenção)
    checksums           confere ou grava .bigbang/CHECKSUMS (manutenção)

options:
  -h, --help            show this help message and exit
  --root, --raiz RAIZ   raiz do projeto (padrão: a pasta acima de .bigbang/)

usage: bb targets [-h]

options:
  -h, --help  show this help message and exit

usage: bb config [-h] <subcomando> ...

positional arguments:
  <subcomando>
    get         mostra o valor de uma chave (secao.chave)

options:
  -h, --help    show this help message and exit

usage: bb config get [-h] chave

positional arguments:
  chave

options:
  -h, --help  show this help message and exit

usage: bb generate [-h] [--dry-run] [--pipeline]

options:
  -h, --help            show this help message and exit
  --dry-run, --simular  só mostra o que mudaria (diff), sem gravar
  --pipeline, --esteira
                        instala a esteira (.github/) pela primeira vez
                        (Fundação F5)

usage: bb init [-h] --name NOME [--slug SLUG] [--owner DONO]
               [--repository REPOSITORIO] [--visibility {privado,publico}]
               [--license LICENCA] [--mode {normal,padrao,flash,autonomous}]
               [--workflow {grouping,epic-branch}] [--no-github] [--dry-run]

options:
  -h, --help            show this help message and exit
  --name, --nome NOME   nome do sistema
  --slug SLUG           identificador em minúsculas com hífen (padrão: a
                        partir do nome)
  --owner, --dono DONO  login do GitHub do dono (padrão: o do repositório ou
                        do gh)
  --repository, --repositorio REPOSITORIO
                        dono/nome (padrão: o remote origin)
  --visibility, --visibilidade {privado,publico}
  --license, --licenca LICENCA
                        identificador SPDX (obrigatório se público)
  --mode, --modo {normal,padrao,flash,autonomous}
                        modo de trabalho: normal (padrao), flash ou autonomous
                        (pode mudar depois)
  --workflow, --fluxo {grouping,epic-branch}
                        fluxo de trabalho: grouping (v3, quadro único) ou
                        epic-branch (anterior)
  --no-github, --sem-github
                        não cria label nem issue no GitHub
  --dry-run, --simular  só mostra o plano

usage: bb verify [-h]

options:
  -h, --help  show this help message and exit

usage: bb test [-h] [--base BASE] [--phase {tarefa,candidata,producao}]
               [--release VERSAO] [--full] [--dry-run]

options:
  -h, --help            show this help message and exit
  --base BASE           referência Git de comparação; ausência força suíte
                        completa
  --phase, --fase {tarefa,candidata,producao}
  --release, --versao VERSAO
                        versão de entrega X.Y.Z (major/minor exige suíte
                        completa)
  --full, --completo    força suíte completa
  --dry-run, --simular  mostra a decisão sem executar testes

usage: bb claim [-h] [--force-claim] [--quote FRASE] [--folder PASTA]
                [--person]
                issue nome

positional arguments:
  issue
  nome

options:
  -h, --help            show this help message and exit
  --force-claim, --forcar
                        retoma uma posse parada por ordem do dono
  --quote, --frase FRASE
                        ordem do dono (obrigatória com --forcar)
  --folder, --pasta PASTA
                        pasta própria do worktree (padrão: ../repo-nome)
  --person              v3: posse de uma pessoa (login) em vez de IA

usage: bb renew [-h] issue

positional arguments:
  issue

options:
  -h, --help  show this help message and exit

usage: bb unclaim [-h] issue

positional arguments:
  issue

options:
  -h, --help  show this help message and exit

usage: bb status [-h]

options:
  -h, --help  show this help message and exit

usage: bb acceptance [-h] <subcomando> ...

positional arguments:
  <subcomando>
    unpend (liberar)  retira as marcas de pendente da sua tarefa

options:
  -h, --help          show this help message and exit

usage: bb acceptance unpend [-h] tarefa

positional arguments:
  tarefa

options:
  -h, --help  show this help message and exit

usage: bb decision [-h] --quote FRASE [--agent IA]
                   {refinamento-aprovado,prototipo-aprovado,testes-aprovados,teste-alterado-aprovado,homologado,reprovado,dono:revisao-ia,pr-aprovado,approved:refinement,approved:prototype,approved:tests,approved:test-change,qa:approved,qa:rejected,owner:ai-review,pr:approved,approved:backlog,approved:selection,approved:cancel}
                   numero

positional arguments:
  {refinamento-aprovado,prototipo-aprovado,testes-aprovados,teste-alterado-aprovado,homologado,reprovado,dono:revisao-ia,pr-aprovado,approved:refinement,approved:prototype,approved:tests,approved:test-change,qa:approved,qa:rejected,owner:ai-review,pr:approved,approved:backlog,approved:selection,approved:cancel}
  numero                issue ou PR

options:
  -h, --help            show this help message and exit
  --quote, --frase FRASE
                        as palavras do dono, como ele disse
  --agent, --ia IA      nome da IA (padrão: BB_IA ou 'ia')

usage: bb review [-h] <subcomando> ...

positional arguments:
  <subcomando>
    approve (aprovar)  põe pr-aprovado depois do bb-revisor-pr

options:
  -h, --help           show this help message and exit

usage: bb review approve [-h] [--agent IA] [--report RELATORIO] pr

positional arguments:
  pr

options:
  -h, --help            show this help message and exit
  --agent, --ia IA
  --report, --relatorio RELATORIO
                        arquivo com o relatório do revisor

usage: bb checklist [-h] <subcomando> ...

positional arguments:
  <subcomando>
    production (producao)
                        checklist de produção (seção 8.2)

options:
  -h, --help            show this help message and exit

usage: bb checklist production [-h] [--content-dir DADOS] [--no-github]

options:
  -h, --help            show this help message and exit
  --content-dir, --dados DADOS
                        pasta com o conteúdo a conferir (padrão: a raiz)
  --no-github, --sem-github
                        não confere os achados de segurança

usage: bb pipeline [-h] <subcomando> ...

positional arguments:
  <subcomando>
    form (formulario)   labels do formulário do épico (corpo na entrada
                        padrão): +label/-label
    ready (pronto)      Definition of Ready do épico (corpo na entrada padrão)
    severity (severidade)
                        label de severidade do formulário de bug (corpo na
                        entrada padrão)
    tasks (tarefas)     tarefas previstas: <índice>\t<título>\t<dependências>
    dependencies (dependencias)
                        épicos dos quais este depende (um número por linha)
    branch              nome da branch de uma issue
    branch-rule (regra-branch)
                        confere origem e destino de um PR
    title (titulo)      confere o título do PR (Conventional Commits)
    version (versao)    próxima versão a partir dos títulos dos PRs (entrada
                        padrão)
    changelog           grava a seção da versão no CHANGELOG.md (itens:
                        número\ttítulo\tlabels)
    artifact (artefato)
                        dos caminhos na entrada padrão, imprime os do artefato
    sensitive (sensivel)
                        dos caminhos na entrada padrão, imprime os de zona
                        sensível
    docs (documentacao)
                        Markdown válido, links relativos (DOC-14), README do
                        sistema (DOC-15), arquivos de comunidade (DOC-16) e
                        ícone global (DOC-17)
    community (comunidade)
                        cria os arquivos de comunidade que faltam (DOC-16) a
                        partir dos modelos
    only-unpend (so-liberacao)
                        o diff (entrada padrão) em tests/aceite/ só retira
                        marcas da issue?
    candidate-name (nome-candidata)
                        nome do binário na candidata (slug, versão, rc,
                        sistema, arquivo)
    production-name (nome-producao)
                        nome do binário em produção (tira o -rc.N)
    acceptance-lock (trava-aceite)
                        trava de tests/aceite/ (diff na entrada padrão)
    pending (pendentes)
                        marcas de pendente em tests/aceite/: <issue>
                        <arquivo:linha>
    traceability (rastreabilidade)
                        RN vigente sem teste, teste sem RN, RN apagada
    stack-guard (guarda-stack)
                        dependências diretas de execução fora do STACK.md
    osv-check (osv-avaliar)
                        relatório JSON do OSV-Scanner (entrada padrão):
                        reprova alta e crítica
    rls                 tabelas sem RLS nas migrações (quando
                        banco_no_navegador = true)
    write-version (gravar-versao)
                        grava a versão no arquivo de versão da stack
                        (entrega.arquivo_versao)
    claims-summary (resumo-posses)
                        possessões, flags e segurança (somente leitura)
    mark-stale (marcar-paradas)
                        marca posses sem push há mais que
                        ias.trava_expira_horas
    release-claim (liberar-posse)
                        liberação automática depois do merge (uso interno da
                        esteira)
    record-push (registrar-push)
                        registra push na posse pelo horário do GitHub (uso
                        interno)
    candidate-ready     v3: épicos da candidata em QA e PR da release
    pr-rules            v3: regras do PR (branch, título, Refs, aceite, flag,
                        zona sensível)
    controller          v3: aplica um evento do GitHub ao quadro (uso da
                        esteira)

options:
  -h, --help            show this help message and exit

usage: bb pipeline form [-h] [--before ANTES]

options:
  -h, --help            show this help message and exit
  --before, --antes ANTES
                        arquivo com o corpo anterior (evento edited): só
                        aplica respostas que mudaram

usage: bb pipeline ready [-h] [--labels LABELS]

options:
  -h, --help       show this help message and exit
  --labels LABELS  labels do épico, separadas por vírgula

usage: bb pipeline severity [-h]

options:
  -h, --help  show this help message and exit

usage: bb pipeline tasks [-h]

options:
  -h, --help  show this help message and exit

usage: bb pipeline dependencies [-h]

options:
  -h, --help  show this help message and exit

usage: bb pipeline branch [-h] tipo numero titulo

positional arguments:
  tipo
  numero
  titulo

options:
  -h, --help  show this help message and exit

usage: bb pipeline branch-rule [-h] head base

positional arguments:
  head
  base

options:
  -h, --help  show this help message and exit

usage: bb pipeline title [-h] titulo

positional arguments:
  titulo

options:
  -h, --help  show this help message and exit

usage: bb pipeline version [-h] --current ATUAL

options:
  -h, --help            show this help message and exit
  --current, --atual ATUAL

usage: bb pipeline changelog [-h] --release VERSAO [--date DATA]
                             [--file ARQUIVO]

options:
  -h, --help            show this help message and exit
  --release, --versao VERSAO
  --date, --data DATA
  --file, --arquivo ARQUIVO

usage: bb pipeline artifact [-h]

options:
  -h, --help  show this help message and exit

usage: bb pipeline sensitive [-h] [--test-pr]

options:
  -h, --help            show this help message and exit
  --test-pr, --pr-de-teste
                        PR de teste do épico: tests/aceite/ liberado

usage: bb pipeline docs [-h] [--content-dir DADOS] [--published] [--community]
                        [--remote-visibility]

options:
  -h, --help            show this help message and exit
  --content-dir, --dados DADOS
                        pasta com o conteúdo revisado a conferir
  --published, --publicada
  --community, --comunidade
  --remote-visibility, --visibilidade-remota

usage: bb pipeline community [-h]

options:
  -h, --help  show this help message and exit

usage: bb pipeline only-unpend [-h] issue

positional arguments:
  issue

options:
  -h, --help  show this help message and exit

usage: bb pipeline candidate-name [-h] versao rc sistema arquivo

positional arguments:
  versao
  rc
  sistema
  arquivo

options:
  -h, --help  show this help message and exit

usage: bb pipeline production-name [-h] arquivo

positional arguments:
  arquivo

options:
  -h, --help  show this help message and exit

usage: bb pipeline acceptance-lock [-h] [--approved] tipo [issue]

positional arguments:
  tipo                  tipo da branch: teste, feature, docs, bugfix, hotfix…
  issue

options:
  -h, --help            show this help message and exit
  --approved, --aprovado
                        o PR tem teste-alterado-aprovado

usage: bb pipeline pending [-h] [--content-dir DADOS]

options:
  -h, --help            show this help message and exit
  --content-dir, --dados DADOS
                        pasta com o conteúdo a examinar (padrão: a raiz)

usage: bb pipeline traceability [-h] [--content-dir DADOS] [--changed MUDADOS]
                                [--content-test-pattern]

options:
  -h, --help            show this help message and exit
  --content-dir, --dados DADOS
                        pasta com o conteúdo a examinar (padrão: a raiz)
  --changed, --mudados MUDADOS
                        arquivo com os caminhos mudados no PR (um por linha)
  --content-test-pattern, --padrao-dos-dados
                        usa testes.padrao_teste do bigbang.toml de --dados (PR
                        release/*: conteúdo já revisado)

usage: bb pipeline stack-guard [-h] [--content-dir DADOS]

options:
  -h, --help            show this help message and exit
  --content-dir, --dados DADOS
                        pasta com o conteúdo a examinar (padrão: a raiz)

usage: bb pipeline osv-check [-h]

options:
  -h, --help  show this help message and exit

usage: bb pipeline rls [-h] [--folder PASTA]

options:
  -h, --help            show this help message and exit
  --folder, --pasta PASTA

usage: bb pipeline write-version [-h] versao

positional arguments:
  versao

options:
  -h, --help  show this help message and exit

usage: bb pipeline claims-summary [-h]

options:
  -h, --help  show this help message and exit

usage: bb pipeline mark-stale [-h] [--apply]

options:
  -h, --help          show this help message and exit
  --apply, --aplicar  grava a label parada; padrão: simulação

usage: bb pipeline release-claim [-h] issue

positional arguments:
  issue

options:
  -h, --help  show this help message and exit

usage: bb pipeline record-push [-h] issue

positional arguments:
  issue

options:
  -h, --help  show this help message and exit

usage: bb pipeline candidate-ready [-h] --branch BRANCH --rc-tag RC_TAG

options:
  -h, --help       show this help message and exit
  --branch BRANCH
  --rc-tag RC_TAG

usage: bb pipeline pr-rules [-h] --pr PR [--content-dir CONTENT_DIR]

options:
  -h, --help            show this help message and exit
  --pr PR
  --content-dir CONTENT_DIR
                        pasta com o conteúdo do PR (lido como dado):
                        pendentes, rastreabilidade, guarda da stack

usage: bb pipeline controller [-h] --event EVENT [--payload PAYLOAD]

options:
  -h, --help         show this help message and exit
  --event EVENT      nome do evento (issues, push, pull_request, schedule)
  --payload PAYLOAD  arquivo JSON do evento (GITHUB_EVENT_PATH)

usage: bb migrate [-h] <parte> ...

positional arguments:
  <parte>
    config    migra config, com plano e volta
    board     migra board, com plano e volta
    workflow  migra workflow, com plano e volta
    labels    migra labels, com plano e volta

options:
  -h, --help  show this help message and exit

usage: bb migrate config [-h] [--dry-run] [--snapshot SNAPSHOT] [--rollback]
                         [--yes]

options:
  -h, --help           show this help message and exit
  --dry-run            só mostra o plano, sem gravar
  --snapshot SNAPSHOT  arquivo protegido com o estado anterior (obrigatório
                       para aplicar)
  --rollback           restaura a parte pelo snapshot
  --yes                confirma as escritas no GitHub desta parte

usage: bb migrate board [-h] [--dry-run] [--snapshot SNAPSHOT] [--rollback]
                        [--yes]

options:
  -h, --help           show this help message and exit
  --dry-run            só mostra o plano, sem gravar
  --snapshot SNAPSHOT  arquivo protegido com o estado anterior (obrigatório
                       para aplicar)
  --rollback           restaura a parte pelo snapshot
  --yes                confirma as escritas no GitHub desta parte

usage: bb migrate workflow [-h] [--dry-run] [--snapshot SNAPSHOT] [--rollback]
                           [--yes]

options:
  -h, --help           show this help message and exit
  --dry-run            só mostra o plano, sem gravar
  --snapshot SNAPSHOT  arquivo protegido com o estado anterior (obrigatório
                       para aplicar)
  --rollback           restaura a parte pelo snapshot
  --yes                confirma as escritas no GitHub desta parte

usage: bb migrate labels [-h] [--dry-run] [--snapshot SNAPSHOT] [--rollback]
                         [--yes]

options:
  -h, --help           show this help message and exit
  --dry-run            só mostra o plano, sem gravar
  --snapshot SNAPSHOT  arquivo protegido com o estado anterior (obrigatório
                       para aplicar)
  --rollback           restaura a parte pelo snapshot
  --yes                confirma as escritas no GitHub desta parte

usage: bb board [-h] <subcomando> ...

positional arguments:
  <subcomando>
    labels      cria as labels da v3 que faltam (idempotente)
    create      cria ou completa o Project único do repositório
    reconcile   devolve cada cartão ao estado registrado nos recibos
    show        estado de cada cartão aberto (somente leitura)

options:
  -h, --help    show this help message and exit

usage: bb board labels [-h]

options:
  -h, --help  show this help message and exit

usage: bb board create [-h] --title TITLE

options:
  -h, --help     show this help message and exit
  --title TITLE  nome do Project (normalmente o nome do produto)

usage: bb board reconcile [-h]

options:
  -h, --help  show this help message and exit

usage: bb board show [-h]

options:
  -h, --help  show this help message and exit

usage: bb move [-h] [--reason REASON] [--return-to RETURN_TO] issue state

positional arguments:
  issue
  state                 estado de destino (por exemplo: Backlog, Refinement,
                        Rejected)

options:
  -h, --help            show this help message and exit
  --reason REASON       motivo (Rejected: requirements, tests, code, security,
                        docs, qa…; Cancelled: texto)
  --return-to RETURN_TO
                        Rejected: estado para onde o trabalho volta

usage: bb sprint [-h] <subcomando> ...

positional arguments:
  <subcomando>
    start       cria teste, tarefas e documentação; branch de teste a partir
                da develop

options:
  -h, --help    show this help message and exit

usage: bb sprint start [-h] [--epic EPIC] [--date DATE]

options:
  -h, --help   show this help message and exit
  --epic EPIC  só estes épicos (repetível)
  --date DATE  AAAA-MM-DD (padrão: hoje)

usage: bb branches [-h] [--epic EPIC]

options:
  -h, --help   show this help message and exit
  --epic EPIC

usage: bb merge [-h] pr

positional arguments:
  pr

options:
  -h, --help  show this help message and exit

usage: bb release [-h] <subcomando> ...

positional arguments:
  <subcomando>
    cut          corta release/x.y.z da develop (versão pelos títulos dos PRs)
    items        PRs da release (número, título, labels) para o CHANGELOG
    gate         confere flags e testes pendentes dos épicos da release
    publish      portão e publicação da release (merge na main, épicos, sync)
    maintenance  publica um PR maintenance/* na main (sem mudar o artefato)

options:
  -h, --help     show this help message and exit

usage: bb release cut [-h] [--version VERSION]

options:
  -h, --help         show this help message and exit
  --version VERSION  X.Y.Z (padrão: calculada)

usage: bb release items [-h] [--head HEAD]

options:
  -h, --help   show this help message and exit
  --head HEAD  branch da release (padrão: develop)

usage: bb release gate [-h] --epic EPIC [--content-dir CONTENT_DIR]

options:
  -h, --help            show this help message and exit
  --epic EPIC
  --content-dir CONTENT_DIR
                        conteúdo da release lido como dado (padrão: --raiz)

usage: bb release publish [-h] --version VERSION [--dry-run]
                          [--content-dir CONTENT_DIR]

options:
  -h, --help            show this help message and exit
  --version VERSION
  --dry-run             só confere o portão
  --content-dir CONTENT_DIR
                        conteúdo da release (flags.toml, testes pendentes)
                        lido como dado (padrão: --raiz)

usage: bb release maintenance [-h] --pr PR [--dry-run]

options:
  -h, --help  show this help message and exit
  --pr PR
  --dry-run   só confere o portão

usage: bb qa [-h] <subcomando> ...

positional arguments:
  <subcomando>
    reject      reprovação registrada: épico de volta e tarefa de correção na
                release
    verdict     QA delegado: o agente independente registra o veredito da
                candidata

options:
  -h, --help    show this help message and exit

usage: bb qa reject [-h] --reason REASON [--dry-run] epic

positional arguments:
  epic

options:
  -h, --help       show this help message and exit
  --reason REASON  motivo nas palavras do dono
  --dry-run        só confere a reprovação registrada

usage: bb qa verdict [-h] --candidate CANDIDATE --digest DIGEST
                     --verdict {approved,rejected} --agent AGENT
                     epic

positional arguments:
  epic

options:
  -h, --help            show this help message and exit
  --candidate CANDIDATE
                        versão candidata homologada (ex.: v1.3.0-rc.1)
  --digest DIGEST       digest do artefato homologado
  --verdict {approved,rejected}
  --agent AGENT         nome do agente que homologou (de agents.names)

usage: bb autonomy [-h] <subcomando> ...

positional arguments:
  <subcomando>
    check       confere autonomy.toml e os controles exigidos (ruleset,
                production)

options:
  -h, --help    show this help message and exit

usage: bb autonomy check [-h]

options:
  -h, --help  show this help message and exit

usage: bb cleanup [-h] [--apply]

options:
  -h, --help  show this help message and exit
  --apply     apaga de verdade (padrão: só mostra o plano)

usage: bb flag [-h] <subcomando> ...

positional arguments:
  <subcomando>
    list        lista as flags e seus estados
    on          liga uma flag num ambiente
    off         desliga uma flag num ambiente

options:
  -h, --help    show this help message and exit

usage: bb flag list [-h]

options:
  -h, --help  show this help message and exit

usage: bb flag on [-h] [--env {staging,production}] name

positional arguments:
  name

options:
  -h, --help            show this help message and exit
  --env {staging,production}

usage: bb flag off [-h] [--env {staging,production}] name

positional arguments:
  name

options:
  -h, --help            show this help message and exit
  --env {staging,production}

usage: bb docs [-h]
               {read,ler,path,destino,prepare,preparar,write,gravar,propose,propor,validate,validar,publish,publicar,inventory,inventario} ...

positional arguments:
  {read,ler,path,destino,prepare,preparar,write,gravar,propose,propor,validate,validar,publish,publicar,inventory,inventario}
    read (ler)          resolve um documento lógico sem duplicar documentação
    path (destino)      resolve um documento lógico sem duplicar documentação
    prepare (preparar)  confere HEAD/acesso e clona a Wiki nos metadados Git
    write (gravar)      grava uma proposta documental; não publica na Wiki
                        oficial
    propose (propor)    envia commit da Wiki para revisão junto ao PR de
                        código
    validate (validar)  bloqueia cobertura incompleta, links ruins e
                        documentação desatualizada
    publish (publicar)  publica a proposta revisada com proteção contra
                        alterações concorrentes
    inventory (inventario)
                        lista fontes reais e hashes para a matriz de
                        rastreabilidade

options:
  -h, --help            show this help message and exit

usage: bb docs read [-h] documento

positional arguments:
  documento

options:
  -h, --help  show this help message and exit

usage: bb docs path [-h] documento

positional arguments:
  documento

options:
  -h, --help  show this help message and exit

usage: bb docs prepare [-h] [--repository REPOSITORIO]

options:
  -h, --help            show this help message and exit
  --repository, --repositorio REPOSITORIO

usage: bb docs write [-h] --file ARQUIVO documento

positional arguments:
  documento

options:
  -h, --help            show this help message and exit
  --file, --arquivo ARQUIVO

usage: bb docs propose [-h] --wiki WIKI --branch BRANCH

options:
  -h, --help       show this help message and exit
  --wiki WIKI      pasta Git com a proposta documental
  --branch BRANCH  bigbang/proposta-ISSUE-slug

usage: bb docs validate [-h] [--wiki WIKI] [--published] [--community]

options:
  -h, --help            show this help message and exit
  --wiki WIKI           snapshot local (padrão: SHA do manifesto)
  --published, --publicada
                        exige publicação confirmada no HEAD oficial da Wiki
  --community, --comunidade
                        confere Discussions e visibilidade dos três painéis

usage: bb docs publish [-h] [--dry-run]

options:
  -h, --help            show this help message and exit
  --dry-run, --simular

usage: bb docs inventory [-h]

options:
  -h, --help  show this help message and exit

usage: bb community [-h]
                    {welcome-post,primeiro-post,board,painel,social-preview} ...

positional arguments:
  {welcome-post,primeiro-post,board,painel,social-preview}
    welcome-post (primeiro-post)
                        publica as boas-vindas da IA uma única vez por
                        repositório
    board (painel)      audita, verifica ou publica um painel sem alterar
                        permissões de edição
    social-preview      mostra se a imagem personalizada foi instalada no
                        GitHub

options:
  -h, --help            show this help message and exit

usage: bb community welcome-post [-h] [--repository REPOSITORIO] [--name NOME]
                                 [--text TEXTO] [--dry-run]

options:
  -h, --help            show this help message and exit
  --repository, --repositorio REPOSITORIO
  --name, --nome NOME
  --text, --texto TEXTO
                        arquivo com conteúdo factual revisado em português
  --dry-run, --simular

usage: bb community board [-h] --repository REPOSITORIO --owner OWNER
                          [--audit AUDITORIA] [--created-title TITULO_CRIADO]
                          {auditar,auditar-criacao,validar,publicar} numero

positional arguments:
  {auditar,auditar-criacao,validar,publicar}
  numero

options:
  -h, --help            show this help message and exit
  --repository, --repositorio REPOSITORIO
  --owner OWNER
  --audit, --auditoria AUDITORIA
                        recibo da revisão do conteúdo atual antes de mudar a
                        visibilidade
  --created-title, --titulo-criado TITULO_CRIADO
                        título escolhido na criação, para auditar apenas
                        conteúdo padrão vazio

usage: bb community social-preview [-h] --repository REPOSITORIO

options:
  -h, --help            show this help message and exit
  --repository, --repositorio REPOSITORIO

usage: bb update [-h] [--dry-run] [--confirm-migration] [--no-attestation]
                 [versao]

positional arguments:
  versao                versão alvo X.Y.Z (padrão: a última da origem)

options:
  -h, --help            show this help message and exit
  --dry-run, --simular  baixa, confere e mostra a migração; não grava
  --confirm-migration, --confirmo-migracao
                        o dono confirmou os passos manuais do MIGRACAO.md
  --no-attestation, --sem-atestacao
                        só para origem sem atestação (fork privado); confere
                        apenas o SHA-256

usage: bb package [-h] [--output SAIDA] [--notes NOTAS]

options:
  -h, --help            show this help message and exit
  --output, --saida SAIDA
  --notes, --notas NOTAS
                        grava as notas da versão (MIGRACAO.md) neste arquivo

usage: bb checksums [-h] [--write]

options:
  -h, --help           show this help message and exit
  --write, --escrever  grava o CHECKSUMS com o estado atual