# CLI

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

## create-central-oon

```bash
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

```json title="package.json"
{
  "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

```bash
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

```json title="backend/package.json"
{
  "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

```bash
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.

Fonte: https://sdk.oonapps.com/docs/referencia/cli