Docs › Referência

CLI

Referência dos comandos de create-central-oon, oonCore-back e oonCore-front.

create-central-oon

npx @oondemand/create-central-oon <nome-do-app> [--here] [--force] [--no-install]
npx create-central-oon docs sync|check
npx create-central-oon conformance [--root .] [--json]
npx create-central-oon dev|doctor|example [--root .]
Comando Descrição
<nome-do-app> Gera uma nova Central a partir da base _base
docs sync Sincroniza .ooncore/ com a versão instalada (também docs --sync)
docs check Valida fonte, versão, schema, entrada, hashes e arquivos do cache
conformance Verifica fronteiras de segurança e arquitetura; --json para saída estruturada
doctor Versões, lockfiles, manifestos, docs, conformance e composição — JSON, exit 1 se houver pendências
dev Orquestrador local (backend + frontend + sessão)
example Instala a jornada de exemplo em uma base limpa, sem sobrescrever
Opção Efeito
--here Gera no diretório atual
--force Permite gerar em diretório não vazio
--no-install Não executa npm install
--root <dir> Raiz do App para conformance, doctor e example
--json Saída JSON (conformance)

Scripts gerados na raiz

{
  "scripts": {
    "ooncore:docs": "create-central-oon docs sync",
    "ooncore:docs:check": "create-central-oon docs check",
    "ooncore:conformance": "create-central-oon conformance",
    "check": "create-central-oon doctor",
    "dev": "create-central-oon dev",
    "dev:backend": "npm run dev --prefix backend",
    "dev:frontend": "npm run dev --prefix frontend"
  }
}

oonCore-back

npx oonCore-back <comando>
Comando Descrição
start Carrega o backend do cwd, conecta o Mongo, inicializa capabilities e inicia o HTTP
dev Inicia em modo de desenvolvimento
activate Fluxo legado de ativação (não usado no runtime local)
deploy:validate Valida o contrato de deploy
infra:validate Valida o contrato de infraestrutura
publish:request Solicita publicação (uso do pipeline)
build:image Builda a imagem de delivery
k8s:render Renderiza manifestos Kubernetes
deploy Legado — não injeta capabilities no runtime

Erros de manifesto são listados um por linha, no formato - <path>: <mensagem>, sem stack.

Scripts gerados no backend

{
  "scripts": {
    "dev": "oonCore-back dev",
    "start": "oonCore-back start",
    "activate": "oonCore-back activate",
    "build:image": "oonCore-back build:image",
    "k8s:render": "oonCore-back k8s:render",
    "deploy": "oonCore-back deploy"
  }
}

oonCore-front

npx oonCore-front <comando>
Comando Descrição
dev Sobe o Vite em modo dev
build Build de produção (vite build)
preview Serve o build
sync:metadata Baixa /core/metadata do backend (via OON_API_URL/VITE_API_URL) e cacheia em src/.oon/metadata.json

O Core não impõe o Vite: o CLI encaminha para o binário local do projeto.