Consultar o modelo

Um modelo com algumas centenas de caixas deixa de caber na cabeça. Estes comandos respondem sem abrir o navegador — e todos aceitam --json.

`cfour find` — procurar por qualquer coisa

cfour find loja-api

element   loja/loja-api                               id  API da Loja
relation  loja/loja-api~sync~estoque/estoque-api      id  Reserva
relation  loja/loja-web~sync~loja/loja-api            id  Chama
relation  shared/erp-corporativo~batch~loja/loja-api  id  Carga de preços

Ele procura em identificador, nome, descrição, tecnologia, etiqueta, metadado e texto de nota. A terceira coluna diz onde o termo casou.

--tipo restringe: element, relation, note, diagram, flow ou project.

cfour find squad-espacos --tipo element

`cfour element show` — tudo sobre uma caixa

cfour element show loja-api

loja/loja-api
  nome         API da Loja
  nivel        container
  forma        api
  parent       loja/loja
  tecnologia   .NET 8
  descricao    Regras de pedido — monta o carrinho, aplica preço e fecha a compra.
  tags         core, pci
  meta.domain   vendas
  meta.owner    squad-checkout
  arquivo      loja/elements/containers.yaml
  filhos       loja/pedido-repository, loja/preco-client, ...

  14 referencia(s):
    ...

Além dos campos escritos, ele mostra o que só o motor sabe: o nível derivado, os filhos, o arquivo de origem e tudo o que aponta para aquela caixa.

`cfour refs` — o que quebra se isto sair

cfour refs loja-api

14 referencia(s) a loja/loja-api:
  loja/pedido-repository tem loja/loja-api como parent
    loja/elements/checkout/componentes.yaml
  loja/loja-web -> loja/loja-api
    loja/relations/integracoes.yaml
  o diagrama "API da Loja — Componentes" detalha loja/loja-api
    loja/diagrams/componentes.yaml
  loja/loja-api é participante do fluxo "Fechar pedido"
    loja/flows/checkout.yaml
  ...

É a mesma pergunta que o element rm faz para decidir se recusa a remoção — com o arquivo de cada referência, para você ir direto ao ponto.

Listar cada família

cfour element list --level container --tag nucleo --projeto reservas
cfour relation list --from painel --kind sync
cfour diagram list --projeto reservas
cfour flow list
cfour note list --target api --scope containers
cfour project list
cfour group list containers
cfour path list reservar

`--resolved`: o que um diagrama de fato mostra

cfour diagram show containers --resolved

reservas/containers  (Reserva de Salas — Containers)
  nivel        container
  fronteira    Reserva de Salas
  7 caixa(s), 6 seta(s)

  reservas/painel                 dentro    children:reservas/reservas
  reservas/colaborador            contexto  neighbors: 1
  ...
  reservas/api -> reservas/banco  sync  "Le e grava"

A terceira coluna diz qual seletor trouxe cada caixa. É a forma de responder “por que essa caixa está aqui” — e “por que essa não está”.

`cfour flow show` — a sequência inteira

cfour flow show reservar

  passos:
     1. reservas/colaborador -> reservas/painel  Escolhe sala e horario
     2. reservas/painel -> reservas/api  Pede a reserva
     3. reservas/api -> reservas/servico-de-reserva  Confirma a reserva
     4. reservas/servico-de-reserva -> reservas/repositorio-de-reservas  ...  [conflito]

  desvio "Sala ocupada" (failure) a partir de [conflito]: 3 passo(s)

O número à esquerda é o que --n endereça nos comandos de passo; o [conflito] é o identificador do passo, quando ele tem um.

`cfour config show` — o vocabulário desta modelagem

cfour config show

Lista formas, tipos de seta, tipos de nota, desfechos e paleta que valem ali — os padrões do motor com o workspace.yaml por cima. É a resposta para “quais valores eu posso escrever em shape:?”.

Consultar outra modelagem

Todos aceitam --modelagem <id>:

cfour find api --modelagem portaria

Consultar o modelo

cfour find — procurar por qualquer coisa

cfour element show — tudo sobre uma caixa

cfour refs — o que quebra se isto sair