@oondemand/create-central-oon 0.3.44 → 0.3.46

package/README.md

@@ -1,133 +1,141 @@
 # @oondemand/create-central-oon
 
-Gerador de **Centrais Oon**. Cria, a partir do nome da Central, um `backend/` de domínio e um `frontend/` declarativo prontos para consumir o Core (`@oondemand/oon-core-back` e `@oondemand/oon-core-front`).
-
-> A documentação pública pode existir para consulta, mas a fonte de verdade para codificação assistida fica dentro deste pacote npm, versionada junto com o gerador.
-
-Toda Central gerada nasce com o padrão visual e operacional consolidado na **Central Minexco**:
-
-- identidade visual Oon/CST com Poppins, azul `#0474AF` e fundo `#F8F9FA`;
-- menu lateral compacto, responsivo e agrupado por seções;
-- datagrids densos com busca, ordenação, paginação, badges e ações;
-- formulários em diálogo, duas colunas e validação detalhada por campo;
-- campos relacionados com seleção pesquisável;
-- esteiras horizontais com colunas `#E8ECEF` e cartões operacionais brancos.
-
-O padrão fica no `@oondemand/oon-core-front`; os templates funcionais apenas declaram domínio, coleções, documentos e esteiras. Assim, não é necessário copiar ou manter um frontend diferente para cada Central.
+Gerador de **Centrais Oon declarativas**. Cria backend e frontend prontos para consumir `@oondemand/oon-core-back` e `@oondemand/oon-core-front`, sem copiar shell, autenticação, páginas genéricas ou infraestrutura para a Central.
 
 ## Uso
 
 ```bash
 npx create-central-oon central-transtour
-npx create-central-oon central-transtour --template=omie-sidecar
-npx create-central-oon "Minha Loja" --template=multi-moedas --no-install
+npx create-central-oon central-transtour --template=servicos-tomados
 npx create-central-oon --list
 ```
 
 Aliases: o binário também responde por `scaffold-central-oon`.
 
-### Opções
-
-| Flag             | Efeito                                                        |
-| ---------------- | ------------------------------------------------------------- |
-| `--template=<t>` | Template funcional inicial (default: `basic`). Veja `--list`. |
-| `--here`         | Gera na pasta atual em vez de criar `<nome>/`.                |
-| `--force`        | Sobrescreve uma pasta existente não-vazia.                    |
-| `--no-install`   | Não roda `npm install` nos projetos gerados.                  |
-| `--list`         | Lista os templates e sai.                                     |
-
-## Documentação interna para Codex
-
-O pacote inclui documentação canônica em `docs/`. Ela é publicada no npm junto com o gerador.
+## Contrato `central.app.json`
+
+Toda Central gerada possui um manifesto raiz com identidade e capabilities:
+
+```json
+{
+  "$schema": "./node_modules/@oondemand/create-central-oon/schemas/central.app.schema.json",
+  "schemaVersion": 1,
+  "id": "central-exemplo",
+  "name": "Central Exemplo",
+  "slug": "central-exemplo",
+  "appKind": "member-central",
+  "modules": {
+    "collections": true,
+    "documents": false,
+    "pipelines": false,
+    "integrations": false,
+    "omie": false,
+    "assistants": false,
+    "currencies": false
+  },
+  "capabilities": ["core.collections"],
+  "compatibility": {
+    "core": {
+      "minVersion": "0.3.45",
+      "maxVersionExclusive": "0.4.0"
+    }
+  }
+}
+```
 
-A referência completa das opções do manifesto front fica em:
+O schema versionado é publicado no pacote em:
 
 ```txt
-packages/create-central-oon/docs/FRONTEND_MANIFEST_REFERENCE.md
+@oondemand/create-central-oon/schemas/central.app.schema.json
 ```
 
-Ao criar uma Central, o CLI gera uma pasta `.ooncore/` com um cache local da documentação da versão instalada:
+Responsabilidades do manifesto:
 
-```txt
-<central>/
-└── .ooncore/
-    ├── CODEX.md
-    ├── context.generated.md
-    ├── manifest.json
-    └── docs/
-```
+- identidade estável (`id`, `name`, `slug`);
+- perfil arquitetural (`appKind`);
+- módulos e capabilities habilitados;
+- faixa compatível do OonCore;
+- metadados declarativos de ativação.
 
-A pasta `.ooncore/` não é a fonte de verdade. Ela é apenas o contexto local para o Codex trabalhar sem depender de site externo.
+`backend/central.config.js` fica reservado a extensões excepcionais de runtime. Em Centrais `member-central` e `portal-cockpit`, identidade, módulos e autenticação não podem ser reintroduzidos nesse arquivo. O token local de desenvolvimento é validado pelo próprio OonCore por `DEV_TOKEN`.
 
-### Sincronizar documentação local
+## Verificação de conformidade
 
 Na raiz da Central:
 
 ```bash
-npm run ooncore:docs
+npm run ooncore:conformance
 ```
 
-ou diretamente:
+ou:
 
 ```bash
-npx create-central-oon docs --sync
+npx create-central-oon conformance
+npx create-central-oon conformance --json
 ```
 
-### Verificar se está atualizada
+O comando falha quando encontra, entre outros desvios:
 
-```bash
-npm run ooncore:docs:check
-```
+- ausência ou incompatibilidade de `central.app.json`;
+- transformações ou registries no bootstrap do frontend;
+- páginas genéricas e extensões executáveis locais;
+- identidade ou autenticação reintroduzida em `central.config.js`;
+- models técnicos de integração;
+- workers, runtimes, locks, clients Omie ou registries locais;
+- patches de métodos do Mongoose;
+- arquivos com extensões fora da allowlist.
+
+A CI de uma Central deve executar o comando antes do build e da publicação.
+
+## Documentação interna para Codex
 
-ou diretamente:
+O pacote inclui documentação canônica em `docs/`. Ao criar uma Central, o CLI gera `.ooncore/` como cache local da documentação da versão instalada.
 
 ```bash
-npx create-central-oon docs --check
+npm run ooncore:docs
+npm run ooncore:docs:check
 ```
 
-O check compara a versão e o hash da documentação local com a versão instalada do pacote.
+A pasta `.ooncore/` não é fonte de verdade; ela pode ser regenerada a partir do pacote npm.
 
 ## Templates funcionais
 
-Todos utilizam o mesmo frontend padrão Minexco.
-
-| Template              | O que gera                                                    |
-| --------------------- | ------------------------------------------------------------- |
-| `basic`               | Uma coleção dinâmica (`Pessoa`).                              |
-| `omie-sidecar`        | Coleção + integração Omie (mapping de cliente + trigger).     |
-| `servicos-tomados`    | Prestadores + esteira de serviços por `statusProcessamento`.  |
-| `servicos-prestados`  | Clientes + esteira de serviços prestados por `etapa`.         |
-| `pedidos-marketplace` | Catálogo de produtos + esteira de pedidos por `status`.       |
-| `documentos-fiscais`  | Documento fiscal com aprovação (`CoreDocument`).              |
-| `multi-moedas`        | `Moeda` + `Cotacao` com o módulo currencies.                  |
+| Template | O que gera |
+| --- | --- |
+| `basic` | Uma coleção dinâmica (`Pessoa`). |
+| `omie-sidecar` | Estrutura declarativa inicial para mapping Omie. |
+| `servicos-tomados` | Prestadores e esteira por status. |
+| `servicos-prestados` | Clientes e esteira por etapa. |
+| `pedidos-marketplace` | Catálogo e esteira de pedidos. |
+| `documentos-fiscais` | Documento fiscal com aprovação. |
+| `multi-moedas` | Moedas e cotações. |
 
 ## Estrutura gerada
 
 ```txt
 <central>/
-├── README.md
-├── package.json              # scripts de sync/check da documentação OonCore
-├── .ooncore/                 # cache local gerado a partir do pacote instalado
-├── backend/                  # consome @oondemand/oon-core-back
-│   ├── central.config.js     # identidade + módulos + paths de domínio
-│   ├── central.manifest.json # valores de deploy (render no Core)
-│   └── src/{models,validations,triggers,hooks,mappings,documents,
-│            pipelines,integrations,routes,controllers,services}/
-└── frontend/                 # consome o frontend padrão Minexco do OonCore
-    ├── central.ui.json       # menu e telas (coleções/esteiras/documentos)
-    └── src/
-        ├── main.tsx          # startFromManifest(manifest, { apiBaseUrl })
-        └── {collections,documents,pipelines,dashboards,overrides}/
+├── central.app.json            # identidade, appKind, módulos e capabilities
+├── package.json                # docs, conformance e comandos locais
+├── .ooncore/                   # cache regenerável da documentação
+├── backend/
+│   ├── central.config.js       # somente extensão excepcional de runtime
+│   ├── central.domain.json     # domínio declarativo
+│   └── src/{validations,triggers,hooks,mappings,rules}/
+└── frontend/
+    ├── central.ui.json         # telas, formulários, grids e esteiras
+    └── src/main.tsx            # bootstrap mínimo gerado
 ```
 
-## Próximos passos após gerar
+O bootstrap gerado importa `central.app.json` e `central.ui.json` e chama `startCentralFromManifest`. Não deve transformar manifestos, registrar componentes padrão nem conhecer regras de um cliente.
+
+## Próximos passos
 
 ```bash
 cd <central>
-npm run ooncore:docs:check
+npm run check
 
-cd backend  && cp .env.example .env && npm run dev
+cd backend && cp .env.example .env && npm run dev
 cd ../frontend && cp .env.example .env && npm run dev
 ```
 
-Evoluir a Central significa criar models em `backend/src/models` e declarar as telas em `frontend/central.ui.json`. Menu, rotas, datagrids, formulários e esteiras são montados pelo Core mantendo o padrão Minexco.
+Evoluir a Central significa declarar domínio, UI, mappings e regras específicas. O OonCore implementa como a aplicação funciona.

package/bin/cli.js

@@ -1,26 +1,8 @@
 #!/usr/bin/env node
 "use strict";
 
-/**
- * CLI do create-central-oon.
- *
- *   npx create-central-oon <nome-da-central> [opções]
- *   npx create-central-oon docs --sync
- *   npx create-central-oon docs --check
- *
- * Opções:
- *   --template=<t>   Template inicial (default: basic). Veja --list.
- *   --here           Gera na pasta atual em vez de criar <nome>/.
- *   --force          Sobrescreve pasta existente.
- *   --no-install     Não roda npm install nos projetos gerados.
- *   --list           Lista os templates disponíveis e sai.
- *
- * Documentação:
- *   docs --sync      Gera/atualiza .ooncore/ com a documentação da versão instalada.
- *   docs --check     Valida se .ooncore/ está sincronizado com a versão instalada.
- */
-
 const { run, listTemplates, syncDocs, checkDocs } = require("../src/index");
+const { checkConformance } = require("../src/conformance");
 
 function parseArgs(argv) {
   const opts = {
@@ -32,33 +14,29 @@ function parseArgs(argv) {
     list: false,
     docsSync: false,
     docsCheck: false,
+    json: false,
+    root: undefined,
   };
   const positionals = [];
 
   for (let i = 0; i < argv.length; i += 1) {
     const arg = argv[i];
-
     if (arg === "--here") opts.here = true;
     else if (arg === "--force") opts.force = true;
     else if (arg === "--no-install") opts.install = false;
     else if (arg === "--list") opts.list = true;
     else if (arg === "--sync") opts.docsSync = true;
     else if (arg === "--check") opts.docsCheck = true;
+    else if (arg === "--json") opts.json = true;
+    else if (arg.startsWith("--root=")) opts.root = arg.slice("--root=".length);
+    else if (arg === "--root") { opts.root = argv[i + 1]; i += 1; }
     else if (arg.startsWith("--template=")) opts.template = arg.slice("--template=".length);
-    else if (arg === "--template") {
-      opts.template = argv[i + 1];
-      i += 1;
-    } else if (!arg.startsWith("-")) {
-      positionals.push(arg);
-    }
-  }
-
-  if (positionals[0] === "docs") {
-    opts.command = "docs";
-  } else {
-    opts.name = positionals[0];
+    else if (arg === "--template") { opts.template = argv[i + 1]; i += 1; }
+    else if (!arg.startsWith("-")) positionals.push(arg);
   }
 
+  if (["docs", "conformance"].includes(positionals[0])) opts.command = positionals[0];
+  else opts.name = positionals[0];
   return opts;
 }
 
@@ -66,34 +44,42 @@ function printUsage() {
   console.error("Uso:");
   console.error("  npx create-central-oon <nome-da-central> [--template=basic]");
   console.error("  npx create-central-oon --list");
-  console.error("  npx create-central-oon docs --sync");
-  console.error("  npx create-central-oon docs --check");
+  console.error("  npx create-central-oon docs --sync|--check");
+  console.error("  npx create-central-oon conformance [--root .] [--json]");
 }
 
 async function main() {
   const opts = parseArgs(process.argv.slice(2));
-
   if (opts.list) {
     console.log("Templates disponíveis:\n");
-    for (const t of listTemplates()) console.log(`  ${t.id.padEnd(20)} ${t.description}`);
-    process.exit(0);
+    for (const template of listTemplates()) {
+      console.log(`  ${template.id.padEnd(20)} ${template.description}`);
+    }
+    return;
   }
 
   try {
     if (opts.command === "docs") {
-      if (opts.docsCheck) {
-        checkDocs();
-      } else {
-        syncDocs();
-      }
+      if (opts.docsCheck) checkDocs();
+      else syncDocs();
       return;
     }
-
+    if (opts.command === "conformance") {
+      const result = checkConformance({ cwd: opts.root || process.cwd() });
+      if (opts.json) console.log(JSON.stringify(result, null, 2));
+      else if (result.ok) console.log(`✔ Central conforme (${result.filesChecked} arquivos verificados).`);
+      else {
+        console.error("✖ Conformidade da Central reprovada:");
+        for (const issue of result.issues) {
+          console.error(`  - [${issue.code}] ${issue.path}: ${issue.message}`);
+        }
+      }
+      process.exit(result.ok ? 0 : 1);
+    }
     if (!opts.name) {
       printUsage();
       process.exit(1);
     }
-
     await run(opts);
   } catch (err) {
     console.error("\n✖", err.message);

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "@oondemand/create-central-oon",
-  "version": "0.3.44",
+  "version": "0.3.46",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/oondemand/oon-platform.git",
     "directory": "packages/create-central-oon"
   },
-  "description": "Gerador de Centrais Oon com backend declarativo, frontend padrão e documentação interna OonCore para Codex.",
+  "description": "Gerador de Centrais Oon com contratos declarativos, guardrails de conformidade e documentação interna para Codex.",
   "main": "src/index.js",
   "exports": {
-    ".": "./src/index.js"
+    ".": "./src/index.js",
+    "./conformance": "./src/conformance.js",
+    "./schemas/central.app.schema.json": "./schemas/central.app.schema.json"
   },
   "bin": {
     "create-central-oon": "bin/cli.js",
@@ -19,9 +21,13 @@
     "bin",
     "src",
     "templates",
+    "schemas",
     "docs",
     "README.md"
   ],
+  "scripts": {
+    "test": "node --test"
+  },
   "engines": {
     "node": ">=18"
   },
@@ -33,7 +39,8 @@
     "create",
     "generator",
     "codex",
-    "docs"
+    "docs",
+    "conformance"
   ],
   "license": "SEE LICENSE IN LICENSE",
   "publishConfig": {

package/schemas/central.app.schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.oondemand.com.br/central.app.v1.schema.json",
+  "title": "Oon Central App Manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "id",
+    "name",
+    "slug",
+    "appKind",
+    "modules",
+    "capabilities",
+    "compatibility"
+  ],
+  "properties": {
+    "$schema": { "type": "string" },
+    "schemaVersion": { "const": 1 },
+    "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]*$" },
+    "name": { "type": "string", "minLength": 1 },
+    "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "appKind": {
+      "enum": ["root-central", "member-central", "portal-cockpit"]
+    },
+    "modules": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "collections": { "type": "boolean" },
+        "documents": { "type": "boolean" },
+        "pipelines": { "type": "boolean" },
+        "integrations": { "type": "boolean" },
+        "omie": { "type": "boolean" },
+        "assistants": { "type": "boolean" },
+        "currencies": { "type": "boolean" }
+      }
+    },
+    "capabilities": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9]*(?:[._:-][a-z0-9][a-z0-9-]*)+$"
+      }
+    },
+    "compatibility": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["core"],
+      "properties": {
+        "core": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["minVersion"],
+          "properties": {
+            "minVersion": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?$" },
+            "maxVersionExclusive": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?$" }
+          }
+        }
+      }
+    },
+    "activation": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "configurationVersion": { "type": "integer", "minimum": 1 },
+        "fields": { "type": "array" }
+      }
+    }
+  }
+}

package/src/conformance.js

@@ -0,0 +1,228 @@
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+const IGNORED_DIRS = new Set([".git", ".ooncore", "node_modules", "dist", "build", "coverage"]);
+const EXECUTABLE_EXTENSIONS = new Set([".js", ".cjs", ".mjs", ".ts", ".tsx", ".jsx"]);
+const TECHNICAL_MODEL_NAMES = new Set([
+  "IntegrationExecution",
+  "IntegrationOutbox",
+  "IntegrationInbox",
+  "WebhookInbox",
+  "ExecutionHistory",
+  "ProviderRegistry",
+  "DistributedLock",
+  "OmieConfiguracao",
+  "OmieCategoria",
+  "OmieContaCorrente",
+  "OmieBaixaPagamento",
+]);
+
+function normalize(relativePath) {
+  return relativePath.split(path.sep).join("/");
+}
+
+function listFiles(root, current = root) {
+  const files = [];
+  for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+    if (entry.isDirectory() && IGNORED_DIRS.has(entry.name)) continue;
+    const absolute = path.join(current, entry.name);
+    if (entry.isDirectory()) files.push(...listFiles(root, absolute));
+    else if (entry.isFile()) files.push(normalize(path.relative(root, absolute)));
+  }
+  return files.sort();
+}
+
+function readText(root, relativePath) {
+  return fs.readFileSync(path.join(root, relativePath), "utf8");
+}
+
+function addIssue(issues, code, file, message) {
+  issues.push({ code, path: file, message });
+}
+
+function fallbackValidateAppManifest(manifest) {
+  const required = ["schemaVersion", "id", "name", "slug", "appKind", "modules", "capabilities", "compatibility"];
+  const missing = required.filter((key) => manifest?.[key] === undefined);
+  if (missing.length) throw new Error(`campos obrigatórios ausentes: ${missing.join(", ")}.`);
+  if (manifest.schemaVersion !== 1) throw new Error("schemaVersion deve ser 1.");
+  if (!Array.isArray(manifest.capabilities)) throw new Error("capabilities deve ser uma lista.");
+}
+
+function validateAppManifest(root, manifest) {
+  try {
+    const entry = require.resolve("@oondemand/oon-core-back", {
+      paths: [path.join(root, "backend"), root, __dirname],
+    });
+    const core = require(entry);
+    if (typeof core.validateAppManifest === "function") {
+      core.validateAppManifest(manifest);
+      return;
+    }
+  } catch (error) {
+    if (error?.code !== "MODULE_NOT_FOUND") throw error;
+  }
+  fallbackValidateAppManifest(manifest);
+}
+
+function checkAppManifest(root, issues) {
+  const file = "central.app.json";
+  const absolute = path.join(root, file);
+  if (!fs.existsSync(absolute)) {
+    addIssue(issues, "APP_MANIFEST_REQUIRED", file, "central.app.json é obrigatório.");
+    return;
+  }
+  try {
+    validateAppManifest(root, JSON.parse(readText(root, file)));
+  } catch (error) {
+    const details = error?.issues?.length
+      ? error.issues.map((item) => `${item.path}: ${item.message}`).join("; ")
+      : error.message;
+    addIssue(issues, "APP_MANIFEST_INVALID", file, details);
+  }
+}
+
+function checkBootstrap(root, files, issues) {
+  const file = files.find((candidate) => /^frontend\/src\/main\.(?:t|j)sx?$/.test(candidate));
+  if (!file) {
+    addIssue(issues, "FRONTEND_BOOTSTRAP_REQUIRED", "frontend/src/main.tsx", "bootstrap gerado não encontrado.");
+    return;
+  }
+  const source = readText(root, file);
+  if (!/\bstart(?:Central)?FromManifest\b/.test(source)) {
+    addIssue(
+      issues,
+      "FRONTEND_BOOTSTRAP_INVALID",
+      file,
+      "deve iniciar o Core com startCentralFromManifest.",
+    );
+  }
+  const forbidden = [
+    /structuredClone\s*\(/,
+    /\b(?:configure|prepare|transform)[A-Z_a-z0-9]*\s*\(/,
+    /\b(?:registry|pageComponents|cellRenderers|fieldRenderers|cardRenderers|layoutSlots)\b/,
+    /\.find\s*\(/,
+    /\.push\s*\(/,
+    /Object\.assign\s*\(/,
+  ];
+  for (const pattern of forbidden) {
+    if (pattern.test(source)) {
+      addIssue(issues, "FRONTEND_BOOTSTRAP_TRANSFORM", file, `transform local detectado: ${pattern}.`);
+    }
+  }
+  const localImports = [...source.matchAll(/from\s+["'](\.\.?\/[^"']+)["']/g)]
+    .map((match) => match[1])
+    .filter((value) => !value.endsWith(".json"));
+  if (localImports.length) {
+    addIssue(
+      issues,
+      "FRONTEND_BOOTSTRAP_LOCAL_CODE",
+      file,
+      `imports locais executáveis não permitidos: ${localImports.join(", ")}.`,
+    );
+  }
+
+  const extraFrontendSources = files.filter(
+    (candidate) => candidate.startsWith("frontend/src/")
+      && candidate !== file
+      && candidate !== "frontend/src/vite-env.d.ts",
+  );
+  for (const extra of extraFrontendSources) {
+    addIssue(issues, "FRONTEND_LOCAL_EXTENSION", extra, "frontend declarativo deve manter somente o bootstrap gerado.");
+  }
+}
+
+function checkCentralConfig(root, files, issues) {
+  const file = files.find((candidate) => candidate === "backend/central.config.js");
+  if (!file) return;
+  const source = readText(root, file);
+  const forbiddenKeys = ["name", "slug", "appKind", "appCode", "appCodigo", "ecosystem", "activation", "modules", "capabilities", "auth"];
+  for (const key of forbiddenKeys) {
+    if (new RegExp(`\\b${key}\\s*:`).test(source)) {
+      addIssue(
+        issues,
+        "CENTRAL_CONFIG_BOUNDARY",
+        file,
+        `${key} deve ser declarado em central.app.json ou fornecido pelo Core.`,
+      );
+    }
+  }
+}
+
+function checkDomainManifest(root, issues) {
+  const file = "backend/central.domain.json";
+  if (!fs.existsSync(path.join(root, file))) return;
+  try {
+    const manifest = JSON.parse(readText(root, file));
+    for (const model of manifest.models || []) {
+      if (TECHNICAL_MODEL_NAMES.has(model.name) || /(?:Outbox|Inbox|Execution|Provider|Lock|Webhook|Omie)/i.test(model.name)) {
+        addIssue(issues, "TECHNICAL_MODEL", file, `model técnica não permitida na Central: ${model.name}.`);
+      }
+    }
+  } catch (error) {
+    addIssue(issues, "DOMAIN_MANIFEST_INVALID", file, error.message);
+  }
+}
+
+function checkExecutableFiles(root, files, issues) {
+  const suspiciousPath = /(?:^|\/)(?:workers?|runtime|registr(?:y|ies)|clients?|patches?|infrastructure|infra)(?:\/|\.)/i;
+  const omieClient = /(?:^|\/)(?:omie[-_.]?(?:client|http|service)|clients?\/omie)(?:\.|\/)/i;
+  const genericPage = /^frontend\/src\/(?:pages|components)\/(?:Core|Integration|Integracao|Settings|Configurac)/i;
+  const mongoosePatch = /mongoose\.(?:Model|Query|Document)\.prototype|\.prototype\.(?:save|updateOne|findOneAndUpdate)\s*=|patchMongoose/i;
+  const registryCode = /\b(?:pageComponents|cellRenderers|fieldRenderers|cardRenderers|actionRenderers|layoutSlots)\b/;
+
+  for (const file of files) {
+    if (!EXECUTABLE_EXTENSIONS.has(path.extname(file))) continue;
+    if (suspiciousPath.test(file)) addIssue(issues, "GENERIC_RUNTIME", file, "runtime/worker/registry local não permitido.");
+    if (omieClient.test(file)) addIssue(issues, "OMIE_CLIENT", file, "cliente Omie deve pertencer ao adaptador nativo do Core.");
+    if (genericPage.test(file)) addIssue(issues, "GENERIC_PAGE", file, "página genérica deve pertencer ao OonCore.");
+
+    const source = readText(root, file);
+    if (mongoosePatch.test(source)) addIssue(issues, "MONGOOSE_PATCH", file, "patch de Mongoose não permitido na Central.");
+    if (file !== "frontend/src/main.tsx" && file.startsWith("frontend/") && registryCode.test(source)) {
+      addIssue(issues, "LOCAL_REGISTRY", file, "registry de componentes padrão não permitido na Central.");
+    }
+  }
+}
+
+function checkAllowedExtensions(files, issues) {
+  const allowed = new Set([
+    "", ".json", ".md", ".txt", ".yml", ".yaml", ".js", ".cjs", ".mjs", ".ts", ".tsx", ".jsx",
+    ".html", ".css", ".svg", ".png", ".jpg", ".jpeg", ".webp", ".ico", ".env", ".example", ".sh",
+  ]);
+  for (const file of files) {
+    const base = path.basename(file);
+    if (base.startsWith(".env")) continue;
+    const extension = path.extname(file).toLowerCase();
+    if (!allowed.has(extension)) addIssue(issues, "FILE_EXTENSION", file, `extensão não permitida: ${extension || "(sem extensão)"}.`);
+  }
+}
+
+function checkConformance({ cwd = process.cwd() } = {}) {
+  const root = path.resolve(cwd);
+  const files = listFiles(root);
+  const issues = [];
+  checkAppManifest(root, issues);
+  checkBootstrap(root, files, issues);
+  checkCentralConfig(root, files, issues);
+  checkDomainManifest(root, issues);
+  checkExecutableFiles(root, files, issues);
+  checkAllowedExtensions(files, issues);
+  return { ok: issues.length === 0, root, filesChecked: files.length, issues };
+}
+
+function assertConformance(options = {}) {
+  const result = checkConformance(options);
+  if (!result.ok) {
+    const error = new Error(
+      `Conformidade da Central reprovada:\n${result.issues.map((issue) => `- [${issue.code}] ${issue.path}: ${issue.message}`).join("\n")}`,
+    );
+    error.code = "OON_CONFORMANCE_FAILED";
+    error.issues = result.issues;
+    throw error;
+  }
+  return result;
+}
+
+module.exports = { checkConformance, assertConformance, listFiles };

package/templates/_base/README.md

@@ -1,44 +1,45 @@
 # __NAME__
 
-Central Oon gerada com `create-central-oon`. É composta por dois projetos mínimos que consomem o Core:
+Central Oon declarativa gerada com `create-central-oon`.
 
-- **backend/** — só domínio (`src/models`, `validations`, `triggers`, …).
-  Sobe com `oonCore-back dev`. Toda a infra (boot, db, auth, RBAC, metadata,
-  CRUD, deploy) vem do `@oondemand/oon-core-back`.
-- **frontend/** — só declaração (`central.ui.json`). Sobe com `oonCore-front
-  dev`. Shell, providers, roteamento, auth e telas vêm do
-  `@oondemand/oon-core-front`, renderizados a partir do `/core/metadata` do back.
+## Fronteira arquitetural
 
-## Documentação local do OonCore
+- `central.app.json` declara identidade, `appKind`, módulos, capabilities e compatibilidade com o OonCore;
+- `backend/central.domain.json` declara models e regras do domínio;
+- `frontend/central.ui.json` declara telas, formulários, grids e esteiras;
+- `backend/central.config.js` fica reservado a extensões excepcionais de runtime;
+- `frontend/src/main.tsx` é um bootstrap gerado e não deve transformar manifestos.
 
-A pasta `.ooncore/` é gerada automaticamente a partir da versão instalada do pacote `@oondemand/create-central-oon`.
+Autenticação, shell, roteamento, RBAC, metadata, CRUD, páginas genéricas e infraestrutura pertencem ao OonCore.
 
-Ela serve como contexto local para o Codex codificar sem depender de site externo.
+## Documentação e conformidade
 
 ```bash
 npm run ooncore:docs        # sincroniza .ooncore/
-npm run ooncore:docs:check  # valida versão/hash da documentação local
+npm run ooncore:docs:check  # valida versão/hash do cache local
+npm run ooncore:conformance # valida a fronteira da Central
+npm run check               # executa os gates locais
 ```
 
-Não edite `.ooncore/context.generated.md` manualmente. Atualize o pacote e rode o sync.
+A pasta `.ooncore/` é um cache regenerável da documentação publicada no pacote. Não edite `context.generated.md` manualmente.
 
 ## Rodando
 
 ```bash
-# raiz da Central
 npm install
-npm run ooncore:docs:check
+npm run check
 
-# backend
 cd backend && cp .env.example .env && npm install && npm run dev
-
-# frontend (noutro terminal)
-cd frontend && cp .env.example .env && npm install && npm run dev
+cd ../frontend && cp .env.example .env && npm install && npm run dev
 ```
 
+Em desenvolvimento, configure o mesmo valor em `DEV_TOKEN` no backend e `VITE_DEV_TOKEN` no frontend. A validação do token local é fornecida pelo Core; não implemente `auth.verifyToken` na Central.
+
 ## Evoluindo a Central
 
-1. Crie models em `backend/src/models` (só schema + CRUD).
-2. Declare as telas em `frontend/central.ui.json` (coleções/esteiras/documentos).
-3. Use validations, triggers, hooks, mappings e integrations para regras e processos.
-4. O resto — grid, form, rotas, menu — é montado pelo Core automaticamente.
+1. Declare domínio e fórmulas em `backend/central.domain.json`.
+2. Declare telas em `frontend/central.ui.json`.
+3. Use validações, triggers, hooks, mappings e regras somente para comportamento específico do negócio.
+4. Execute `npm run check` antes de abrir o PR.
+
+O OonCore implementa como a aplicação funciona; a Central declara o que pertence ao negócio.

package/templates/_base/backend/central.config.js

@@ -1,54 +1,6 @@
 /**
- * Configuração da Central __NAME__ (Seção 8). Apenas identidade, módulos
- * ativos e os paths de domínio. Sem db/auth/deploy — isso vive no Core e nas
- * variáveis de ambiente.
+ * Extensões exclusivamente de runtime da Central __NAME__.
+ * Identidade, appKind, módulos, capabilities e ativação vivem em
+ * ../central.app.json. Autenticação local é fornecida pelo OonCore.
  */
-
-// Em desenvolvimento, aceita o DEV_TOKEN sem chamar o Meus Apps.
-// Para usar: acesse http://localhost:5173/?code=<DEV_TOKEN>
-const devAuth =
-  process.env.NODE_ENV === "development" && process.env.DEV_TOKEN
-    ? {
-        verifyToken: async (token) => {
-          if (token !== process.env.DEV_TOKEN) {
-            const err = new Error("Token inválido.");
-            err.statusCode = 401;
-            throw err;
-          }
-          return { tipo: "admin", nome: "Dev Local", email: "dev@local" };
-        },
-      }
-    : undefined;
-
-module.exports = {
-  ecosystem: { role: "member" },
-  activation: { enabled: true, configurationVersion: 1, fields: [] },
-  name: "__NAME__",
-  slug: "__SLUG__",
-
-  auth: devAuth,
-
-  // Módulos opinativos do Core ligados nesta Central.
-  modules: {
-    collections: true,
-    documents: false,
-    pipelines: false,
-    integrations: false,
-    omie: false,
-    assistants: false,
-    currencies: false,
-  },
-
-  // Paths de domínio (carregados por convenção pelo Core no boot).
-  domain: {
-    models: "src/models",
-    validations: "src/validations",
-    triggers: "src/triggers",
-    hooks: "src/hooks",
-    mappings: "src/mappings",
-    documents: "src/documents",
-    pipelines: "src/pipelines",
-    integrations: "src/integrations",
-    routes: "src/routes",
-  },
-};
+module.exports = {};

package/templates/_base/backend/package.json

@@ -12,6 +12,6 @@
     "deploy": "oonCore-back deploy"
   },
   "dependencies": {
-    "@oondemand/oon-core-back": "^0.3.44"
+    "@oondemand/oon-core-back": "^0.3.46"
   }
 }

package/templates/_base/central.app.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "./node_modules/@oondemand/create-central-oon/schemas/central.app.schema.json",
+  "schemaVersion": 1,
+  "id": "__SLUG__",
+  "name": "__NAME__",
+  "slug": "__SLUG__",
+  "appKind": "member-central",
+  "modules": {
+    "collections": true,
+    "documents": false,
+    "pipelines": false,
+    "integrations": false,
+    "omie": false,
+    "assistants": false,
+    "currencies": false
+  },
+  "capabilities": [
+    "core.collections"
+  ],
+  "compatibility": {
+    "core": {
+      "minVersion": "0.3.45",
+      "maxVersionExclusive": "0.4.0"
+    }
+  },
+  "activation": {
+    "enabled": true,
+    "configurationVersion": 1,
+    "fields": []
+  }
+}

package/templates/_base/frontend/central.ui.json

@@ -1,6 +1,5 @@
 {
-  "name": "__NAME__",
-  "slug": "__SLUG__",
+  "schemaVersion": 2,
   "backend": { "metadataUrl": "/core/metadata" },
   "navigation": { "mode": "auto" },
   "collections": [],

package/templates/_base/frontend/package.json

@@ -10,7 +10,7 @@
     "sync:metadata": "oonCore-front sync:metadata"
   },
   "dependencies": {
-    "@oondemand/oon-core-front": "^0.3.44",
+    "@oondemand/oon-core-front": "^0.3.46",
     "@chakra-ui/react": "^3.13.0",
     "@emotion/react": "^11.14.0",
     "@tanstack/react-query": "^5.65.0",

package/templates/_base/frontend/src/main.tsx

@@ -1,15 +1,9 @@
-import { startFromManifest } from "@oondemand/oon-core-front";
-import manifest from "../central.ui.json";
+import { startCentralFromManifest } from "@oondemand/oon-core-front";
+import app from "../../central.app.json";
+import ui from "../central.ui.json";
 
-/**
- * Toda a Central __NAME__ inicia por aqui. Sem providers, router, auth, layout
- * ou páginas — só o manifesto declarativo `central.ui.json`. O Core resolve as
- * telas a partir do `/core/metadata` do backend.
- */
-startFromManifest(manifest, {
+startCentralFromManifest({ app, ui }, {
   apiBaseUrl: import.meta.env.VITE_API_URL ?? "http://localhost:4000",
   meusAppsUrl: import.meta.env.VITE_MEUS_APPS_URL,
-  // O valor só entra no bundle servido pelo Vite em modo de desenvolvimento.
-  // O backend continua validando se ele coincide com DEV_TOKEN.
   devToken: import.meta.env.DEV ? (import.meta.env.VITE_DEV_TOKEN ?? "dev-local") : undefined,
 });

package/templates/_base/frontend/vite.config.ts

@@ -3,5 +3,8 @@ import react from "@vitejs/plugin-react";
 
 export default defineConfig({
   plugins: [react()],
-  server: { port: 5173 },
+  server: {
+    port: 5173,
+    fs: { allow: [".."] },
+  },
 });

package/templates/_base/package.json

@@ -6,10 +6,12 @@
   "scripts": {
     "ooncore:docs": "create-central-oon docs --sync",
     "ooncore:docs:check": "create-central-oon docs --check",
+    "ooncore:conformance": "create-central-oon conformance",
+    "check": "npm run ooncore:docs:check && npm run ooncore:conformance",
     "dev:backend": "npm run dev --prefix backend",
     "dev:frontend": "npm run dev --prefix frontend"
   },
   "devDependencies": {
-    "@oondemand/create-central-oon": "^0.3.8"
+    "@oondemand/create-central-oon": "0.3.45"
   }
 }

package/templates/basic/frontend/central.ui.json

@@ -1,6 +1,5 @@
 {
-  "name": "__NAME__",
-  "slug": "__SLUG__",
+  "schemaVersion": 2,
   "backend": { "metadataUrl": "/core/metadata" },
   "navigation": { "mode": "auto" },
   "collections": [{ "model": "Pessoa", "mode": "dynamic" }],

package/templates/documentos-fiscais/frontend/central.ui.json

@@ -1,6 +1,5 @@
 {
-  "name": "__NAME__",
-  "slug": "__SLUG__",
+  "schemaVersion": 2,
   "backend": { "metadataUrl": "/core/metadata" },
   "navigation": { "mode": "auto" },
   "collections": [],

package/templates/multi-moedas/frontend/central.ui.json

@@ -1,6 +1,5 @@
 {
-  "name": "__NAME__",
-  "slug": "__SLUG__",
+  "schemaVersion": 2,
   "backend": { "metadataUrl": "/core/metadata" },
   "navigation": { "mode": "auto" },
   "collections": [

package/templates/omie-sidecar/frontend/central.ui.json

@@ -1,6 +1,5 @@
 {
-  "name": "__NAME__",
-  "slug": "__SLUG__",
+  "schemaVersion": 2,
   "backend": { "metadataUrl": "/core/metadata" },
   "navigation": { "mode": "auto" },
   "collections": [{ "model": "Pessoa", "mode": "dynamic", "section": "Cadastros" }],

package/templates/pedidos-marketplace/frontend/central.ui.json

@@ -1,6 +1,5 @@
 {
-  "name": "__NAME__",
-  "slug": "__SLUG__",
+  "schemaVersion": 2,
   "backend": { "metadataUrl": "/core/metadata" },
   "navigation": { "mode": "auto" },
   "collections": [{ "model": "Produto", "mode": "dynamic", "section": "Catálogo" }],

package/templates/servicos-prestados/frontend/central.ui.json

@@ -1,6 +1,5 @@
 {
-  "name": "__NAME__",
-  "slug": "__SLUG__",
+  "schemaVersion": 2,
   "backend": { "metadataUrl": "/core/metadata" },
   "navigation": { "mode": "auto" },
   "collections": [{ "model": "Cliente", "mode": "dynamic", "section": "Cadastros" }],

package/templates/servicos-tomados/frontend/central.ui.json

@@ -1,6 +1,5 @@
 {
-  "name": "__NAME__",
-  "slug": "__SLUG__",
+  "schemaVersion": 2,
   "backend": { "metadataUrl": "/core/metadata" },
   "navigation": { "mode": "auto" },
   "collections": [{ "model": "Pessoa", "label": "Prestadores", "mode": "dynamic", "section": "Cadastros" }],