@zaip-ai/cli 2.2.0 → 3.0.0

package/templates/.agents/design/.zaip-managed.json

@@ -1,14 +1,14 @@
 {
   "schemaVersion": 1,
-  "version": "2.2.0",
+  "version": "3.0.0",
   "files": [
     {
       "path": "DESIGN.md",
-      "sha256": "9970e5040403dfe41b86651128b691ddb3ee6f5e9909cebfacf0a614555cb7f6"
+      "sha256": "c43a420a697a5be0f729031c27f933e555b8e1e5a8d3169a75ef732971cf6bf8"
     },
     {
       "path": "README.md",
-      "sha256": "7efaff80b0a1add169646dc250b84d5b3a42378c57f6e891bab51ac2bb0e4b50"
+      "sha256": "3421b640843c4531a5867cd08c6b71bc5dd3700de6b90620025d066795bb3d62"
     },
     {
       "path": "apps/catalog/.storybook/main.ts",
@@ -22,45 +22,69 @@
       "path": "apps/catalog/dist/assets/index-BEmIE7WE.css",
       "sha256": "0dec92315d3d26a016136093c1db4172c38f4a502e4c57eecbb59a7bc03491ce"
     },
+    {
+      "path": "apps/catalog/dist/assets/index-BJV597iq.js",
+      "sha256": "21b800284807d7e24d2cb0158735231a407b4a5320fcdc77e998aa25b11adbac"
+    },
+    {
+      "path": "apps/catalog/dist/assets/index-BOjCcUaU.js",
+      "sha256": "6a9b1016f383271faadbfdf1e3ecd7b2f637a1378dcd720fe5b0107db8a8be96"
+    },
+    {
+      "path": "apps/catalog/dist/assets/index-B_WhrCZe.js",
+      "sha256": "e6cb2980664683803b11f825bcfdd26dece46e10645e1dedf3a4b3b1bfc0497e"
+    },
     {
       "path": "apps/catalog/dist/assets/index-CqqYWY2f.js",
       "sha256": "8316a3bfa4c0fdf4128c850b5ab0724e54fe1d71c3368a6d31db4ba7172b9006"
     },
+    {
+      "path": "apps/catalog/dist/assets/index-CqtYXZfV.js",
+      "sha256": "3e33cde89232dfdd2c2168e662c4f19e02c389e1b337a0d52ff5c3a98d543d8a"
+    },
     {
       "path": "apps/catalog/dist/assets/index-D9pj7Jlf.js",
       "sha256": "5d6ff092c238ebc0df8587c753271d5f6561f723c6271b7ef26a855667079fb4"
     },
+    {
+      "path": "apps/catalog/dist/assets/index-D_lfqoyx.js",
+      "sha256": "dcc34d6f634d6d743e4d2f274356102883b99b0ec51cab2c4be73fa165f04d07"
+    },
+    {
+      "path": "apps/catalog/dist/assets/index-i_PO2k9R.js",
+      "sha256": "44394c96e7b5193e08a5f7d726beee39384d4dc64025dbb29e99e5fd8f5acf41"
+    },
     {
       "path": "apps/catalog/dist/index.html",
-      "sha256": "262c0178c7ea79fe0aee2bb7236f9b5b1388f19f85bcbfdff44c7cfa5af249ff"
+      "sha256": "18ff187bda3952dc4a33817417f51b676e7e65b81da7994210ffb532b7cadf4d"
     },
     {
       "path": "apps/catalog/dist/logo_novo_azul.png",
       "sha256": "bb6043bda9fc53a111aaea4d6a004559b9ce8a3569691c060d217a7c6aafa0ae"
     },
     {
-      "path": "apps/catalog/dist/storybook/assets/CatalogShell-BWY-80s4.js",
-      "sha256": "84d451e4102b3f22bb5ad5862f7c1639929f12a1b972ec390076b49381814e0c"
+      "path": "apps/catalog/dist/storybook/assets/CatalogShell-Cstn1UwA.js",
+      "sha256": "8e0579004ab4c0762e8b146027245e25e8a4b08636bf442d3baeb088df165c38"
     },
     {
-      "path": "apps/catalog/dist/storybook/assets/Color-6AOWCN3U-B-kAgAjB.js",
-      "sha256": "0e3ac0b9820668e73414175d055967f9d49bb2e7d826cdbd4aa6cd7fd384a713"
+      "path": "apps/catalog/dist/storybook/assets/Color-6AOWCN3U-Cm-yJJz_.js",
+      "sha256": "23f476e91f11645780ffe4f087c38984ea0965abde8643d1bdca86557a5709ed"
     },
     {
-      "path": "apps/catalog/dist/storybook/assets/Components.stories-Be2mDUQj.js",
-      "sha256": "2981c30e093c3a23616f465a6afc1bc287732692af998d608593598a731c97c4"
+      "path": "apps/catalog/dist/storybook/assets/Components.stories-D1WopB2L.js",
+      "sha256": "2543b4ee66c023533961b9b2819df1037fd9ad7325161b101d34aad65930336a"
     },
     {
-      "path": "apps/catalog/dist/storybook/assets/DesignSystem.stories-DRx9blDs.js",
-      "sha256": "3471400ec1a7cf9cce8f1e58068f91ebe416d34aea4be99a2431aeb0dba776a2"
+      "path": "apps/catalog/dist/storybook/assets/DesignSystem.stories-DQ9PJ3N3.js",
+      "sha256": "9eda01f608291b76264c5be12d7705ceb0f98b3db5d0b233115924616879e54f"
     },
     {
-      "path": "apps/catalog/dist/storybook/assets/DocsRenderer-JROSPFPF-BVN7xHtv.js",
-      "sha256": "162d64f939550ce9e9582f15e3befbb7a8d5fdcc502410ed88262994d6cb82ce"
+      "path": "apps/catalog/dist/storybook/assets/DocsRenderer-JROSPFPF-Belk4jRr.js",
+      "sha256": "8523cd25ceeadf333725b3b3ce040da3085c8f000aab78253be23d005044ef54"
     },
     {
-      "path": "apps/catalog/dist/storybook/assets/WithTooltip-7X4HQR7L-CDHtKYkz.js",
-      "sha256": "9be8ec095a76bf6993527027d4fd16ed5a97340c31de0bf86d1658840989aabe"
+      "path": "apps/catalog/dist/storybook/assets/WithTooltip-7X4HQR7L-DoPvjkS1.js",
+      "sha256": "e8f1f5ba181489d068dbdc3827f2ad5ffee3dc5c0a0b1b5adf879e248d10eda8"
     },
     {
       "path": "apps/catalog/dist/storybook/assets/axe-Bk3eEgJf.js",
@@ -71,33 +95,33 @@
       "sha256": "99518b5bd7da5186fe889de049274f734939938a15b2a6ff4fd72b09b89ddf3b"
     },
     {
-      "path": "apps/catalog/dist/storybook/assets/chunk-DRQKCCAG-D6AsDkMK.js",
-      "sha256": "6802628b929020272748a738451006529a09d123e54c31e174612fbc134e34f5"
+      "path": "apps/catalog/dist/storybook/assets/chunk-DRQKCCAG-B1itKXEN.js",
+      "sha256": "27542bdba914092f8cf4689ad4dcbfb685a5ee4f58da5e1c0b9d88fcfd73567e"
     },
     {
       "path": "apps/catalog/dist/storybook/assets/chunk-QQBDHPVZ-nYh9QWsm.js",
       "sha256": "9ffd7aa2b8e7fab1f375c22fdb4b4755ccfc867e7665f99f997792d0f54de00f"
     },
     {
-      "path": "apps/catalog/dist/storybook/assets/chunk-W22LQPXL-B4m5uloN.js",
-      "sha256": "8c45d2277c1a1c93f0bdc62c0122c515babacff466bb79538c95c1f885e76a1b"
-    },
-    {
-      "path": "apps/catalog/dist/storybook/assets/components-CN8YyTUg.js",
-      "sha256": "2793aa528869e3947d41591db2023524f8d81578f713214e9acac02f743d22e7"
+      "path": "apps/catalog/dist/storybook/assets/chunk-W22LQPXL-C-Eb5SPY.js",
+      "sha256": "271931e984ef5a8ae88a0656891a09759e35317a03e822feba30b007c9f41ad8"
     },
     {
-      "path": "apps/catalog/dist/storybook/assets/formatter-L2YTDE3Q-EwuTh8Zk.js",
-      "sha256": "73f231544e7f0272b6ac45ec3a665c69b6fc2073afa243915c1d09e119c18aa7"
+      "path": "apps/catalog/dist/storybook/assets/components-DnyKLwhj.js",
+      "sha256": "ac5912a25c27494ad9a29ae1a9bf40e029dcb8e5c791afbdf4c187e334c9219f"
     },
     {
-      "path": "apps/catalog/dist/storybook/assets/iframe-9yZfIsdT.js",
-      "sha256": "df67a8dec8d3c121cf18f0564e2bce71ba6ff261beb0c1d6950f035e924b79bb"
+      "path": "apps/catalog/dist/storybook/assets/formatter-L2YTDE3Q-D0OSgxWz.js",
+      "sha256": "9d4d56b3d4a0c056061d50222b4decd82678e8e8761b05f59f813482eecbe72e"
     },
     {
       "path": "apps/catalog/dist/storybook/assets/iframe-BEmIE7WE.css",
       "sha256": "0dec92315d3d26a016136093c1db4172c38f4a502e4c57eecbb59a7bc03491ce"
     },
+    {
+      "path": "apps/catalog/dist/storybook/assets/iframe-DcXBsFPz.js",
+      "sha256": "40b5d200ef9399e02ecb80556abf037c22440ec63f6f4cff4bba398728a65be0"
+    },
     {
       "path": "apps/catalog/dist/storybook/assets/jsx-runtime-f3rHp9ZU.js",
       "sha256": "26ef3f0950be4bb72906cc4b4f17246878b27b597267f289269b983924d71708"
@@ -111,20 +135,20 @@
       "sha256": "d010fa8d2cdceaf3b253755a2361c1bfe3aec58a535addad704b993439203d0a"
     },
     {
-      "path": "apps/catalog/dist/storybook/assets/react-18-BoCSnq6H.js",
-      "sha256": "df23d7771d993b8ba5253df50e543a9b400b58b11a7072b133d7eda5e8f80c85"
+      "path": "apps/catalog/dist/storybook/assets/react-18-CRM89QRf.js",
+      "sha256": "6649cba74dcb232a0eb2a0dae30fc14e89feb1a2ce058d739eee60f179fc3367"
     },
     {
-      "path": "apps/catalog/dist/storybook/assets/react-DyL61NPT.js",
-      "sha256": "4acedd0abf660b7a77ad5b6a6ba23085084a64047985a934f0bb46247de65203"
+      "path": "apps/catalog/dist/storybook/assets/react-C3tkVMIp.js",
+      "sha256": "b09a358f062f4384248dbc36ac02f10ccadef817d5f8e99c868f8b4b01186ecc"
     },
     {
-      "path": "apps/catalog/dist/storybook/assets/syntaxhighlighter-YFXUGROL-Bnn_nMwJ.js",
-      "sha256": "7e5238e615473f83cfaa939d4f3c4ec1462af17900163a0dcf3ec4de32a9cfbf"
+      "path": "apps/catalog/dist/storybook/assets/syntaxhighlighter-YFXUGROL-B03jQGTF.js",
+      "sha256": "f11d6edf9a82c4b9cbc17bd1634536693ea6f3d4a6790077304e9d2284653ca7"
     },
     {
-      "path": "apps/catalog/dist/storybook/assets/theming-DS_ue2sb.js",
-      "sha256": "deba2831ca2a9bae10430a9388d4c1cb3b83d0824f2e55f3ffce97bf51818cf2"
+      "path": "apps/catalog/dist/storybook/assets/theming-4ZyufAga.js",
+      "sha256": "f75b8877a9ee69ee36cc4e682409007e67ab9a88b6e10f477fccbbf5b6b34d5e"
     },
     {
       "path": "apps/catalog/dist/storybook/favicon-wrapper.svg",
@@ -136,7 +160,7 @@
     },
     {
       "path": "apps/catalog/dist/storybook/iframe.html",
-      "sha256": "b7deee3a08a07f9977c8bf559d84b697fc61082a9540fbd963a4f3768d5fee95"
+      "sha256": "fee23dc8cd65234edfceab7fbb0eae7f4fd37b1835a1238c91dfaed9247928b9"
     },
     {
       "path": "apps/catalog/dist/storybook/index.html",
@@ -144,7 +168,7 @@
     },
     {
       "path": "apps/catalog/dist/storybook/index.json",
-      "sha256": "c572a7733e2d4f98ac10da5d5b1c6a77d4b383a753d15be85a83d4d9f6e21943"
+      "sha256": "1055b3e9b85dbeb01c13d59621863c0ca990e7356648258cb17ff9be91d821a3"
     },
     {
       "path": "apps/catalog/dist/storybook/logo_novo_azul.png",
@@ -228,7 +252,7 @@
     },
     {
       "path": "apps/catalog/package.json",
-      "sha256": "44766720319e51f1a60ddce76263e081a109e7d01d5ce63b01c20f82200d0abb"
+      "sha256": "f7691218b679609a07adc311a1ab5861aee4e636a848985a4590f13a0c13008f"
     },
     {
       "path": "apps/catalog/public/logo_novo_azul.png",
@@ -238,14 +262,34 @@
       "path": "apps/catalog/src/App.tsx",
       "sha256": "a3aab3182b47fb78512945fd99d993a9c6cff3ef251a83055c7579ae4cbec854"
     },
+    {
+      "path": "apps/catalog/src/components/AutonomySpecimen.tsx",
+      "sha256": "fdef00ec4dc4a76e072a22605407dcee8e5b65fb568c6449e622470b30fbf677"
+    },
     {
       "path": "apps/catalog/src/components/CatalogShell.tsx",
       "sha256": "9c1c20501aabf476bde54b453fe826efe31a0b3d484a0a050c898bf45f343096"
     },
+    {
+      "path": "apps/catalog/src/components/CostPopulationSpecimen.test.tsx",
+      "sha256": "2e76031ba2e94f0d4473d09c5e96e41f749fe099a13b3e4bcdd24a8455b16ac4"
+    },
+    {
+      "path": "apps/catalog/src/components/CostPopulationSpecimen.tsx",
+      "sha256": "d92bc8d55660b020db6ba9d47037a782fbbeba9b76febf7869718064d1928170"
+    },
+    {
+      "path": "apps/catalog/src/components/EstimatedCostSpecimen.tsx",
+      "sha256": "9350423a97fec486c54eeadd1f74bbdb066ef830cc8b980385c389c1f001feda"
+    },
     {
       "path": "apps/catalog/src/components/Primitives.tsx",
       "sha256": "68d65caaa90818b7e942db30cd2fd6f68912e63b974c940ce694b93fa1bdc5ce"
     },
+    {
+      "path": "apps/catalog/src/components/ProjectStatusSpecimen.tsx",
+      "sha256": "3ff413dad7e8e9e127c8c2cfebe685afcfe0e7840742960c1d9408cadaf3f092"
+    },
     {
       "path": "apps/catalog/src/components/dialog-focus.test.ts",
       "sha256": "b62a5209b8554a4500ff241fb3d0cb67bff4ff751b8eddbda2dfd17dd9b6beed"
@@ -264,7 +308,7 @@
     },
     {
       "path": "apps/catalog/src/pages/ComponentsPage.tsx",
-      "sha256": "c3e8636f2c71e4207221515804ca34f699a9bdddbe73c90cd8bfd9239fd8ddff"
+      "sha256": "7d2173517ecb0469bc197aeef93e6d9fb79bc0c0eaaca9ed1ffe1481c0310664"
     },
     {
       "path": "apps/catalog/src/pages/DesignSystemPage.tsx",
@@ -272,7 +316,7 @@
     },
     {
       "path": "apps/catalog/src/stories/Components.stories.tsx",
-      "sha256": "6912173802ebc94e6771baea062eed57eae0524dda4fc8fb7b447b0f37c5f2fd"
+      "sha256": "b8c891b3473f710bd45aea316a76639f6ac49e5f5f2e0c7e823f3e8d8b4eb495"
     },
     {
       "path": "apps/catalog/src/stories/DesignSystem.stories.tsx",
@@ -308,7 +352,7 @@
     },
     {
       "path": "packages/local-runtime/package.json",
-      "sha256": "4584315601e42ab39805a047ad2073fc3ef51fb030fee1aa7aafb60942d0bba2"
+      "sha256": "39f18ddf46b11fc8894c3200673a65076c573c63305d990c2fbd192cd98db91c"
     },
     {
       "path": "packages/local-runtime/runtime.mjs",

package/templates/.agents/design/DESIGN.md

@@ -1,187 +1,3 @@
----
-schema_version: 1
-name: "ZAIP"
-status: active
-source_of_truth: true
-colors:
-  primary: "#00B0F0"
-  primary-strong: "#018abb"
-  primary-ink: "#006b91"
-  secondary: "#0a0e17"
-  surface: "#ffffff"
-  surface-muted: "#f5f7fb"
-  text: "#0f172a"
-  text-muted: "#526176"
-  border: "#dbe4ef"
-  success: "#16a34a"
-  success-ink: "#166534"
-  warning: "#d97706"
-  warning-ink: "#92400e"
-  error: "#dc2626"
-  error-ink: "#b91c1c"
-  focus: "#00B0F0"
-dark:
-  surface: "#0a0e17"
-  surface-muted: "#111827"
-  text: "#f1f5f9"
-  text-muted: "#94a3b8"
-  border: "rgba(255,255,255,0.12)"
-  error-surface: "rgba(220,38,38,0.14)"
-  error-text: "#fecaca"
-effects:
-  overlay: "rgba(10,14,23,0.72)"
-  dialog-shadow: "rgba(15,23,42,0.22)"
-  primary-wash: "rgba(0,176,240,0.05)"
-  error-surface: "#fef2f2"
-neutral:
-  text-primary: "#0f172a"
-  text-secondary: "#475569"
-  text-muted: "#94a3b8"
-  border: "#e2e8f0"
-  surface-muted: "#f8fafc"
-  canvas: "#f5f7fb"
-  white: "#ffffff"
-typography:
-  display:
-    fontFamily: "Inter, Poppins, ui-sans-serif, system-ui, sans-serif"
-    fontSize: "clamp(2.5rem, 6vw, 4.25rem)"
-    fontWeight: "650"
-    lineHeight: "1.05"
-    letterSpacing: "-0.05em"
-  heading:
-    fontFamily: "Inter, Poppins, ui-sans-serif, system-ui, sans-serif"
-    fontSize: "clamp(1.75rem, 4vw, 2.5rem)"
-    fontWeight: "650"
-    lineHeight: "1.15"
-    letterSpacing: "-0.035em"
-  body:
-    fontFamily: "Inter, ui-sans-serif, system-ui, sans-serif"
-    fontSize: "1rem"
-    fontWeight: "400"
-    lineHeight: "1.65"
-    letterSpacing: "0"
-  label:
-    fontFamily: "Inter, ui-sans-serif, system-ui, sans-serif"
-    fontSize: "0.75rem"
-    fontWeight: "700"
-    lineHeight: "1.3"
-    letterSpacing: "0.12em"
-rounded:
-  sm: "8px"
-  md: "16px"
-  lg: "24px"
-  pill: "999px"
-spacing:
-  xs: "4px"
-  sm: "8px"
-  md: "16px"
-  lg: "24px"
-  xl: "40px"
-  xxl: "64px"
-components:
-  button-primary:
-    bg: "linear-gradient(135deg, #00B0F0 0%, #72f4fb 100%)"
-    text: "#042330"
-    border: "transparent"
-    radius: "999px"
-    padding: "12px 22px"
-  button-secondary:
-    bg: "transparent"
-    text: "#006b91"
-    border: "rgba(0,176,240,0.45)"
-    radius: "999px"
-    padding: "12px 22px"
-  card:
-    bg: "#ffffff"
-    border: "#dbe4ef"
-    radius: "24px"
-    shadow: "0 18px 48px rgba(15,23,42,0.08)"
-    padding: "24px"
-  input:
-    bg: "#ffffff"
-    text: "#0f172a"
-    border: "#cbd5e1"
-    radius: "16px"
-    padding: "12px 14px"
----
+# Design system
 
-# ZAIP Design System
-
-Este arquivo é o contrato visual central do repositório. Antes de criar ou alterar uma interface,
-o agente deve ler o frontmatter, identificar a superfície (`frontend`, `site` ou ferramenta local)
-e reutilizar os tokens e componentes existentes. O frontmatter é normativo; este texto explica a
-intenção e os limites.
-
-## 1. Direção visual
-
-A identidade ZAIP combina navy profundo, superfícies claras e ciano elétrico. O ciano é assinatura,
-ação e foco — não deve preencher grandes áreas sem necessidade. Interfaces de produto priorizam
-clareza, densidade controlada e leitura rápida; páginas públicas podem ampliar tipografia e espaço.
-
-- Use `#0a0e17` para fundos escuros e `#00B0F0` para ação, seleção e foco.
-- Use Inter como fonte operacional. Poppins é fallback de marca para superfícies públicas.
-- Prefira contraste de superfícies a excesso de sombras.
-- Preserve cantos generosos em cards e formato pill em ações primárias.
-- Não recrie o logotipo com texto; use o ativo oficial disponível no projeto.
-
-## 2. Hierarquia e responsividade
-
-- `display` é reservado a hero ou título principal de catálogo.
-- `heading` organiza seções; não use tamanho como substituto de hierarquia semântica.
-- Texto corrido permanece entre 45 e 75 caracteres por linha quando possível.
-- A escala parte de mobile. Grids devem colapsar sem scroll horizontal; tabelas podem usar um
-  contêiner rolável com cabeçalho preservado.
-- Use a escala de espaçamento do frontmatter. Valores intermediários exigem justificativa local.
-
-## 3. Temas e tokens semânticos
-
-Componentes devem consumir papéis semânticos (`surface`, `text`, `border`, `primary`) em vez de
-cores literais espalhadas. O tema escuro troca superfície, texto e borda; `primary` permanece ciano.
-Estados de sucesso, alerta e erro não substituem a cor de marca.
-
-## 4. Componentes mínimos
-
-O catálogo obrigatório contém botões, badges, cards, métricas, campos, estados vazios e tabelas.
-Cada componente precisa documentar estado padrão, foco visível, desabilitado e erro quando fizer
-sentido. Componentes do produto vivem em seus packages; o catálogo em `.agents/design` documenta
-o contrato e fornece espécimes, não uma segunda implementação de domínio.
-
-### Botões
-
-- Primário: uma ação principal por região visual.
-- Secundário: alternativa reversível ou navegação contextual.
-- Ghost: ações de baixa ênfase; nunca dependa apenas de cor para comunicar estado.
-- Área interativa mínima recomendada: `44px`.
-
-### Formulários
-
-Labels são persistentes. Placeholder não substitui label. Erro deve informar correção e estar
-associado ao campo. Foco usa anel ciano visível em temas claro e escuro.
-
-### Cards e dados
-
-Cards agrupam uma única ideia. Métricas usam números tabulares e contexto explícito. Tabelas devem
-ter cabeçalhos, estados vazio/carregando/erro e alinhamento numérico consistente.
-
-## 5. Acessibilidade
-
-- Contraste mínimo WCAG AA para texto e controles.
-- Navegação completa por teclado e foco nunca removido sem substituto.
-- HTML semântico antes de ARIA; ícones decorativos usam `aria-hidden`.
-- Movimento respeita `prefers-reduced-motion`.
-- Cor nunca é o único indicador de resultado ou seleção.
-
-## 6. Governança
-
-Uma mudança visual começa neste arquivo quando altera a linguagem global. Depois, atualize
-`tokens.json`, os espécimes, as stories e os testes na mesma Change. Uma necessidade isolada de um
-módulo não deve virar token global automaticamente. O Storybook é documentação executável; as
-páginas `design-system` e `components` são a leitura humana consolidada.
-
-## 7. Antipadrões
-
-- Duplicar tokens em módulos sem vínculo com este contrato.
-- Copiar componentes antigos apenas por semelhança visual.
-- Misturar estilos do dashboard operacional com a UI do produto ou com o site público.
-- Criar uma biblioteca universal antes de existir reutilização comprovada.
-- Exibir apenas swatches: o catálogo deve aplicar tokens em espécimes reais.
+Em construção.

package/templates/.agents/design/README.md

@@ -13,8 +13,18 @@ ferramentas. O catálogo reaproveita os mesmos espécimes em duas superfícies:
 - `apps/catalog/dist/storybook/index.html`: Storybook estático gerado para instalações do CLI.
 
 O catálogo documenta todo o repositório, mas não pertence ao dashboard e não substitui packages de
-UI do produto. Para mudar a linguagem global, atualize `DESIGN.md`, `tokens.json`, espécimes, stories
-e testes na mesma Change.
+UI do produto. Para criar ou mudar a linguagem global a pedido do usuário, atualize na mesma Change
+`DESIGN.md`, os tokens afetados, espécimes, stories, testes e as duas páginas reais do catálogo:
+`apps/catalog/src/pages/DesignSystemPage.tsx` e `apps/catalog/src/pages/ComponentsPage.tsx`.
+Valide as rotas `#/design-system` e `#/components`; elas são a prova renderizada de que o contrato
+central está sincronizado. A personalização substitui o padrão instalado para aquele projeto e não
+deve criar uma cópia paralela do design system.
+
+Todo componente de UI novo, inclusive um componente local, precisa de uma representação
+renderizável em `#/components`, com exemplo e estados ou variantes aplicáveis. Uma lista, nome ou
+story isolada não comprova essa cobertura. A amostra preserva a identidade vigente de `DESIGN.md`
+(cores, tipografia, espaçamento, raios, bordas e estados) e seus tokens pertinentes, sem mover a
+lógica de negócio ao catálogo nem tornar um componente local em contrato global.
 
 ## Abrir o frontend pelo terminal