@zaip-ai/cli 3.3.0 → 3.4.0

package/templates/.agents/design/apps/catalog/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/design-catalog",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "private": true,
   "type": "module",
   "scripts": {

package/templates/.agents/design/apps/catalog/src/components/DashboardFiltersSpecimen.tsx

@@ -0,0 +1,61 @@
+import { useState } from "react";
+import { Card } from "./Primitives.js";
+
+export const dashboardFilterFixtures = [
+  { name: "Operação", labels: ["Busca", "Status", "Risco", "Origem"] },
+  {
+    name: "Custos",
+    labels: [
+      "Buscar custos",
+      "Provider",
+      "Agente",
+      "Modelo",
+      "Status",
+      "Prioridade",
+      "Risco",
+      "Fase",
+      "Entrada",
+      "Trabalho",
+    ],
+  },
+] as const;
+/** Native catalog adapter: business modules keep the query and lifecycle contracts. */
+export function DashboardFiltersSpecimen({
+  fixture = dashboardFilterFixtures[0],
+}: {
+  fixture?: (typeof dashboardFilterFixtures)[number];
+}) {
+  const [values, setValues] = useState<Record<string, string>>({});
+  return (
+    <Card>
+      <h3>{fixture.name}</h3>
+      <details open>
+        <summary>Filtros de {fixture.name.toLowerCase()}</summary>
+        {fixture.labels.map((label) => (
+          <label key={label} style={{ display: "block", marginBlock: 8 }}>
+            {label}
+            {label.startsWith("Busca") ? (
+              <input
+                aria-label={label}
+                value={values[label] ?? ""}
+                onChange={(e) => setValues({ ...values, [label]: e.target.value })}
+              />
+            ) : (
+              <select
+                aria-label={label}
+                value={values[label] ?? ""}
+                onChange={(e) => setValues({ ...values, [label]: e.target.value })}
+              >
+                <option value="">Todos</option>
+                <option value="example">{label === "Status" ? "Bloqueado" : "Exemplo"}</option>
+              </select>
+            )}
+          </label>
+        ))}
+        <button type="button" onClick={() => setValues({})}>
+          Limpar filtros
+        </button>
+      </details>
+    </Card>
+  );
+}

package/templates/.agents/design/apps/catalog/src/components/Primitives.tsx

@@ -34,6 +34,30 @@ export function Card({ children, accent = false }: { children: ReactNode; accent
   return <article className={accent ? "card card-accent" : "card"}>{children}</article>;
 }
 
+export function EditorialHero({
+  eyebrow,
+  title,
+  description,
+  children,
+}: {
+  eyebrow?: string;
+  title: string;
+  description: string;
+  children?: ReactNode;
+}) {
+  return (
+    <section className="editorial-hero">
+      <div className="editorial-hero-copy">
+        {eyebrow ? <p className="eyebrow">{eyebrow}</p> : null}
+        <h2>{title}</h2>
+        <p>{description}</p>
+        {children ? <div className="editorial-hero-actions">{children}</div> : null}
+      </div>
+      <div aria-hidden="true" className="editorial-hero-orbit" />
+    </section>
+  );
+}
+
 export function Metric({ label, value, change }: { label: string; value: string; change: string }) {
   return (
     <Card>

package/templates/.agents/design/apps/catalog/src/components/WorkspaceStatusSpecimen.tsx

@@ -0,0 +1,26 @@
+import { Card } from "./Primitives.js";
+
+export const workspaceStatusFixtures = [
+  { name: "Inicializado", message: "Lifecycle inicializado" },
+  { name: "Ausente", message: "Lifecycle não inicializado" },
+  { name: "Inválido", message: "Manifesto do lifecycle inválido" },
+  { name: "Indisponível", message: "Não foi possível consultar a saúde do Dashboard" },
+] as const;
+
+/** Native adapter: the catalog cannot depend on the Dashboard application. */
+export function WorkspaceStatusSpecimen({
+  fixture = workspaceStatusFixtures[0],
+}: {
+  fixture?: (typeof workspaceStatusFixtures)[number];
+}) {
+  return (
+    <Card>
+      <h3>{fixture.name}</h3>
+      <aside aria-label="Workspace do Dashboard" style={{ overflowWrap: "anywhere" }}>
+        <strong>zaip-growth</strong>
+        <p>C:/projetos/zaip-growth</p>
+        <p>{fixture.message}</p>
+      </aside>
+    </Card>
+  );
+}

package/templates/.agents/design/apps/catalog/src/design-contract.test.ts

@@ -7,19 +7,28 @@ const designRoot = resolve(import.meta.dirname, "../../..");
 
 describe("design contract", () => {
   it("keeps structured tokens aligned with DESIGN.md frontmatter", async () => {
-    const [markdown, tokensSource, componentsPage, primitives, stories, app, ...styles] =
-      await Promise.all([
-        readFile(resolve(designRoot, "DESIGN.md"), "utf8"),
-        readFile(resolve(designRoot, "tokens.json"), "utf8"),
-        readFile(resolve(import.meta.dirname, "pages/ComponentsPage.tsx"), "utf8"),
-        readFile(resolve(import.meta.dirname, "components/Primitives.tsx"), "utf8"),
-        readFile(resolve(import.meta.dirname, "stories/Components.stories.tsx"), "utf8"),
-        readFile(resolve(import.meta.dirname, "App.tsx"), "utf8"),
-        readFile(resolve(import.meta.dirname, "styles.css"), "utf8"),
-        readFile(resolve(import.meta.dirname, "styles/catalog.css"), "utf8"),
-        readFile(resolve(import.meta.dirname, "styles/design-system.css"), "utf8"),
-        readFile(resolve(import.meta.dirname, "styles/components.css"), "utf8"),
-      ]);
+    const [
+      markdown,
+      tokensSource,
+      designSystemPage,
+      componentsPage,
+      primitives,
+      stories,
+      app,
+      ...styles
+    ] = await Promise.all([
+      readFile(resolve(designRoot, "DESIGN.md"), "utf8"),
+      readFile(resolve(designRoot, "tokens.json"), "utf8"),
+      readFile(resolve(import.meta.dirname, "pages/DesignSystemPage.tsx"), "utf8"),
+      readFile(resolve(import.meta.dirname, "pages/ComponentsPage.tsx"), "utf8"),
+      readFile(resolve(import.meta.dirname, "components/Primitives.tsx"), "utf8"),
+      readFile(resolve(import.meta.dirname, "stories/Components.stories.tsx"), "utf8"),
+      readFile(resolve(import.meta.dirname, "App.tsx"), "utf8"),
+      readFile(resolve(import.meta.dirname, "styles.css"), "utf8"),
+      readFile(resolve(import.meta.dirname, "styles/catalog.css"), "utf8"),
+      readFile(resolve(import.meta.dirname, "styles/design-system.css"), "utf8"),
+      readFile(resolve(import.meta.dirname, "styles/components.css"), "utf8"),
+    ]);
     const css = styles.join("\n");
     const match = /^---\n([\s\S]+?)\n---/.exec(markdown);
     expect(match?.[1]).toBeDefined();
@@ -30,6 +39,7 @@ describe("design contract", () => {
     expect(tokens.dark).toEqual(design.dark);
     expect(tokens.effects).toEqual(design.effects);
     expect(tokens.neutral).toEqual(design.neutral);
+    expect(tokens.typography).toEqual(design.typography);
     expect(tokens.rounded).toEqual(design.rounded);
     expect(tokens.spacing).toEqual(design.spacing);
     for (const value of Object.values(tokens.colors as Record<string, string>)) {
@@ -58,5 +68,9 @@ describe("design contract", () => {
       expect(componentsPage).toContain(`<${specimen}`);
       expect(stories).toContain(`<${specimen}`);
     }
+    expect(primitives).toContain("function EditorialHero");
+    expect(designSystemPage).toContain("<EditorialHero");
+    expect(componentsPage).toContain("<EditorialHero");
+    expect(stories).toContain("<EditorialHero");
   });
 });

package/templates/.agents/design/apps/catalog/src/pages/ComponentsPage.tsx

@@ -1,4 +1,8 @@
 import { AutonomySpecimen, autonomyFixtures } from "../components/AutonomySpecimen.js";
+import {
+  DashboardFiltersSpecimen,
+  dashboardFilterFixtures,
+} from "../components/DashboardFiltersSpecimen.js";
 import { PageIntro, Section } from "../components/CatalogShell.js";
 import {
   CostPopulationSpecimen,
@@ -15,6 +19,7 @@ import {
   ChartPanel,
   DataTable,
   DialogSpecimen,
+  EditorialHero,
   Field,
   FilterForm,
   Metric,
@@ -25,6 +30,10 @@ import {
   ProjectStatusSpecimen,
   projectStatusFixtures,
 } from "../components/ProjectStatusSpecimen.js";
+import {
+  WorkspaceStatusSpecimen,
+  workspaceStatusFixtures,
+} from "../components/WorkspaceStatusSpecimen.js";
 
 const dashboardFamilies = [
   ["Dialogs e popups", "TaskDetailsDialog, TraceStageDialog", "Foco, contexto e saída explícita"],
@@ -44,6 +53,35 @@ export function ComponentsPage() {
         title="Components"
         description="Famílias reais do dashboard representadas por espécimes compartilhados com o Storybook. O catálogo documenta o contrato; os componentes de negócio continuam em seus módulos."
       />
+      <Section
+        title="Filtros do Dashboard"
+        description="Operação expõe busca, status, risco e origem no cabeçalho visível. Custos mantém seus filtros dimensionais acessíveis na área integrada; Desenvolvedores usa somente o período. Adaptadores nativos com limpeza e foco de teclado."
+      >
+        {dashboardFilterFixtures.map((fixture) => (
+          <DashboardFiltersSpecimen key={fixture.name} fixture={fixture} />
+        ))}
+      </Section>
+      <Section
+        title="Hero editorial"
+        description="Componente público para promessa, explicação e até duas ações; a variação de ação secundária permanece legível sobre navy."
+      >
+        <EditorialHero
+          eyebrow="Componente central"
+          title="Uma direção pública que chama para a ação."
+          description="Use em abertura de páginas de marca; mantenha a prova detalhada e a lógica comercial no conteúdo local."
+        >
+          <Button>Ação principal</Button>
+          <Button variant="secondary">Ação secundária</Button>
+        </EditorialHero>
+      </Section>
+      <Section
+        title="Workspace do Dashboard"
+        description="Nome e caminho absolutos sempre visíveis; lifecycle ausente ou inválido impede a exibição de zeros como dados válidos. Adaptador nativo do componente WorkspaceStatus."
+      >
+        {workspaceStatusFixtures.map((fixture) => (
+          <WorkspaceStatusSpecimen key={fixture.name} fixture={fixture} />
+        ))}
+      </Section>
       <Section
         title="Dialogs e popups"
         description="Superfícies focadas com nome acessível, contexto, Escape e ação de fechamento."

package/templates/.agents/design/apps/catalog/src/pages/DesignSystemPage.tsx

@@ -1,10 +1,11 @@
 import { PageIntro, Section } from "../components/CatalogShell.js";
-import { Badge, Button, Card, Field } from "../components/Primitives.js";
+import { Badge, Button, Card, EditorialHero, Field } from "../components/Primitives.js";
 
 const primaryColors = [
   ["Primary", "#00B0F0", "Ação, foco e identidade"],
   ["Primary strong", "#018abb", "Hover e ênfase reforçada"],
   ["Primary ink", "#006b91", "Texto e ícones sobre fundos claros"],
+  ["Primary soft", "#dffcff", "Base breve para badge e ênfase"],
 ] as const;
 
 const secondaryColors = [
@@ -87,6 +88,19 @@ export function DesignSystemPage() {
           ))}
         </div>
       </Section>
+      <Section
+        title="Hero editorial público"
+        description="Hero de alto contraste para comunicar uma promessa verificável, com ações claras e espaço para leitura."
+      >
+        <EditorialHero
+          eyebrow="Direção pública"
+          title="Mais contraste para decisões mais claras."
+          description="Navy estabelece profundidade; tipografia expressiva e CTAs pill deixam a próxima ação inequívoca."
+        >
+          <Button>Começar agora</Button>
+          <Button variant="secondary">Entender o sistema</Button>
+        </EditorialHero>
+      </Section>
       <Section
         title="Tipografia"
         description="Hierarquia compacta para produto e escala expressiva para superfícies públicas."

package/templates/.agents/design/apps/catalog/src/stories/Components.stories.tsx

@@ -14,6 +14,7 @@ import {
   ChartPanel,
   DataTable,
   DialogSpecimen,
+  EditorialHero,
   FilterForm,
   Metric,
   StateGallery,
@@ -75,6 +76,23 @@ export const DialogsAndPopups: Story = {
   render: () => <DialogSpecimen />,
 };
 
+export const EditorialHeroes: Story = {
+  render: () => (
+    <EditorialHero
+      eyebrow="Componente central"
+      title="Contraste e direção para páginas públicas."
+      description="Mantenha uma promessa verificável e no máximo duas ações, inclusive em telas estreitas."
+    >
+      <button className="button button-primary" type="button">
+        Ação principal
+      </button>
+      <button className="button button-secondary" type="button">
+        Ação secundária
+      </button>
+    </EditorialHero>
+  ),
+};
+
 export const CardsAndMetrics: Story = {
   render: () => (
     <div className="metric-grid">

package/templates/.agents/design/apps/catalog/src/stories/DashboardFilters.stories.tsx

@@ -0,0 +1,7 @@
+import {
+  DashboardFiltersSpecimen,
+  dashboardFilterFixtures,
+} from "../components/DashboardFiltersSpecimen.js";
+export default { title: "Components/Filtros do Dashboard", component: DashboardFiltersSpecimen };
+export const Operations = { args: { fixture: dashboardFilterFixtures[0] } };
+export const Costs = { args: { fixture: dashboardFilterFixtures[1] } };

package/templates/.agents/design/apps/catalog/src/stories/WorkspaceStatus.stories.tsx

@@ -0,0 +1,9 @@
+import {
+  WorkspaceStatusSpecimen,
+  workspaceStatusFixtures,
+} from "../components/WorkspaceStatusSpecimen.js";
+export default { title: "Components/Workspace do Dashboard", component: WorkspaceStatusSpecimen };
+export const Initialized = { args: { fixture: workspaceStatusFixtures[0] } };
+export const Missing = { args: { fixture: workspaceStatusFixtures[1] } };
+export const Invalid = { args: { fixture: workspaceStatusFixtures[2] } };
+export const Unavailable = { args: { fixture: workspaceStatusFixtures[3] } };

package/templates/.agents/design/apps/catalog/src/styles/components.css

@@ -6,7 +6,74 @@
   box-shadow: 0 18px 48px rgba(15, 23, 42, 0.08);
 }
 .card-accent {
-  background: linear-gradient(180deg, #f3feff 0%, #ffffff 100%);
+  background: linear-gradient(180deg, var(--primary-soft) 0%, #ffffff 100%);
+}
+.editorial-hero {
+  position: relative;
+  isolation: isolate;
+  display: grid;
+  min-height: 380px;
+  align-items: center;
+  overflow: hidden;
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  border-radius: 32px;
+  padding: clamp(32px, 7vw, 76px);
+  background:
+    radial-gradient(circle at 82% 20%, rgba(0, 176, 240, 0.24), transparent 24%),
+    linear-gradient(135deg, var(--secondary) 0%, var(--secondary-elevated) 100%);
+  color: #f1f5f9;
+  box-shadow: 0 26px 70px rgba(15, 23, 42, 0.22);
+}
+.editorial-hero-copy {
+  position: relative;
+  z-index: 1;
+  max-width: 720px;
+}
+.editorial-hero .eyebrow {
+  color: #72f4fb;
+}
+.editorial-hero h2 {
+  max-width: 680px;
+  margin: 14px 0 18px;
+  font-family: Inter, Poppins, ui-sans-serif, system-ui, sans-serif;
+  font-size: clamp(2.5rem, 6vw, 4.25rem);
+  font-weight: 650;
+  line-height: 1.05;
+  letter-spacing: -0.05em;
+}
+.editorial-hero-copy > p:not(.eyebrow) {
+  max-width: 620px;
+  margin: 0;
+  color: #cbd5e1;
+  font-size: clamp(1rem, 2vw, 1.2rem);
+  line-height: 1.65;
+}
+.editorial-hero-actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 12px;
+  margin-top: 30px;
+}
+.editorial-hero .button-secondary {
+  border-color: rgba(255, 255, 255, 0.3);
+  color: #f1f5f9;
+}
+.editorial-hero .button-secondary:hover {
+  border-color: var(--primary);
+  background: rgba(0, 176, 240, 0.12);
+}
+.editorial-hero-orbit {
+  position: absolute;
+  z-index: 0;
+  width: min(48vw, 540px);
+  aspect-ratio: 1;
+  right: -12%;
+  bottom: -42%;
+  border: 1px solid rgba(114, 244, 251, 0.28);
+  border-radius: 50%;
+  box-shadow:
+    0 0 0 46px rgba(0, 176, 240, 0.05),
+    0 0 0 112px rgba(0, 176, 240, 0.035);
 }
 .card h3 {
   margin: 24px 0 8px;
@@ -201,7 +268,7 @@ tbody tr:last-child td {
   height: 64px;
   place-items: center;
   border-radius: 24px;
-  background: #dffcff;
+  background: var(--primary-soft);
   color: #006b91;
   font-size: 2rem;
 }
@@ -404,6 +471,17 @@ tbody tr:last-child td {
 }
 
 @media (max-width: 560px) {
+  .editorial-hero {
+    min-height: 0;
+    border-radius: 24px;
+  }
+  .editorial-hero-actions {
+    align-items: stretch;
+    flex-direction: column;
+  }
+  .editorial-hero-actions .button {
+    width: 100%;
+  }
   .filter-form {
     grid-template-columns: 1fr;
   }
@@ -422,6 +500,9 @@ tbody tr:last-child td {
 }
 
 @media (prefers-reduced-motion: reduce) {
+  .editorial-hero-orbit {
+    box-shadow: none;
+  }
   .loading-spinner {
     animation: none;
     border-color: var(--primary);

package/templates/.agents/design/apps/catalog/src/styles.css

@@ -11,7 +11,9 @@
   --primary: #00b0f0;
   --primary-strong: #018abb;
   --primary-ink: #006b91;
+  --primary-soft: #dffcff;
   --secondary: #0a0e17;
+  --secondary-elevated: #111827;
   --surface: #ffffff;
   --surface-muted: #f5f7fb;
   --text: #0f172a;

package/templates/.agents/design/packages/local-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/design-local-runtime",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "private": true,
   "type": "module",
   "scripts": {

package/templates/.agents/design/tokens.json

@@ -5,7 +5,9 @@
     "primary": "#00B0F0",
     "primary-strong": "#018abb",
     "primary-ink": "#006b91",
+    "primary-soft": "#dffcff",
     "secondary": "#0a0e17",
+    "secondary-elevated": "#111827",
     "surface": "#ffffff",
     "surface-muted": "#f5f7fb",
     "text": "#0f172a",
@@ -43,6 +45,36 @@
     "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",

package/templates/.agents/requirements/autonomous-assurance.md

@@ -6,7 +6,7 @@ title: Garantia adaptativa e execução autônoma
 status: active
 version: 3
 source_change: null
-source_release: "3.3.0"
+source_release: "3.4.0"
 ---
 
 # Garantia adaptativa e execução autônoma

package/templates/.agents/requirements/cloud-hostinger-autonomy.md

@@ -6,7 +6,7 @@ title: Autonomia delimitada para Cloudflare e Hostinger
 status: proposed
 version: 1
 source_change: null
-source_release: "3.3.0"
+source_release: "3.4.0"
 ---
 
 # Cloudflare e Hostinger (proposta de requisito)

package/templates/.agents/requirements/comparative-audit.md

@@ -6,7 +6,7 @@ title: Auditoria comparativa e plano de evolução
 status: active
 version: 1
 source_change: null
-source_release: "3.3.0"
+source_release: "3.4.0"
 ---
 
 # Auditoria comparativa e plano de evolução

package/templates/.agents/requirements/context-engine.md

@@ -6,7 +6,7 @@ title: Contexto mínimo, seguro e navegável
 status: active
 version: 8
 source_change: null
-source_release: "3.3.0"
+source_release: "3.4.0"
 ---
 
 # Context engine

package/templates/.agents/requirements/cost-observability.md

@@ -6,7 +6,7 @@ title: Tokens, custos e cobertura
 status: active
 version: 10
 source_change: null
-source_release: "3.3.0"
+source_release: "3.4.0"
 ---
 
 # Cost observability

package/templates/.agents/requirements/dashboard-launch.md

@@ -6,7 +6,7 @@ title: Inicialização e hidratação confiável do dashboard
 status: active
 version: 1
 source_change: null
-source_release: "3.3.0"
+source_release: "3.4.0"
 ---
 
 # Inicialização e hidratação confiável do dashboard

package/templates/.agents/requirements/data-export.md

@@ -6,7 +6,7 @@ title: Exportação contextual de dados para Excel
 status: proposed
 version: 2
 source_change: null
-source_release: "3.3.0"
+source_release: "3.4.0"
 ---
 
 # Exportação contextual de dados

package/templates/.agents/requirements/design-system.md

@@ -6,7 +6,7 @@ title: Contrato visual e catálogo executável
 status: active
 version: 5
 source_change: null
-source_release: "3.3.0"
+source_release: "3.4.0"
 ---
 
 # Design system

package/templates/.agents/requirements/execution-engine.md

@@ -6,7 +6,7 @@ title: Preparação, materialização e DAG
 status: active
 version: 11
 source_change: null
-source_release: "3.3.0"
+source_release: "3.4.0"
 ---
 
 # Execution engine

package/templates/.agents/requirements/kanban-dashboard.md

@@ -6,7 +6,7 @@ title: Projeções operacionais e analíticas
 status: active
 version: 14
 source_change: null
-source_release: "3.3.0"
+source_release: "3.4.0"
 ---
 
 # Kanban and dashboard

package/templates/.agents/requirements/model-orchestration.md

@@ -6,7 +6,7 @@ title: Seleção automática e observável de modelo e effort
 status: active
 version: 8
 source_change: null
-source_release: "3.3.0"
+source_release: "3.4.0"
 ---
 
 # Orquestração de modelos

package/templates/.agents/requirements/public-distribution.md

@@ -4,9 +4,9 @@ id: REQUIREMENTS-PUBLIC-DISTRIBUTION
 area: public-distribution
 title: Distribuição pública e ativação
 status: active
-version: 7
+version: 8
 source_change: null
-source_release: "3.3.0"
+source_release: "3.4.0"
 ---
 
 # Distribuição pública e ativação
@@ -26,7 +26,7 @@ A distribuição pública só pode ser candidata quando fonte canônica, templat
 
 A skill portátil de publicação é `zaip-skill-github-deploy`. A publicação npm do framework pertence exclusivamente ao GitHub Actions do repositório mantenedor, com versão alinhada ao tag GitHub e canal explícito. Workflow mantenedor e skill legada de publicação npm não entram no template nem no pacote. Atualizações removem arquivos obsoletos comprovadamente gerenciados e inalterados, preservando personalizações e arquivos sem prova de ownership.
 
-- `AC-DIST-002-01`: o gate de release executa sync reproduzível, audit, typecheck, testes, pack, doctor, smoke e rollback sobre o candidato exato, sem substituir falha por evidência de outro checkout.
+- `AC-DIST-002-01`: o gate padrão de release usa o perfil `essential-v3`: sync reproduzível, integridade e paridade, audit de dependências, typecheck, regressões prioritárias de instalação/rollback e contratos de release, pack, doctor e smoke do runtime/SQLite/API sobre o candidato exato. O recibo assinado vincula perfil, gates, SHA e hashes do pacote; falha ou timeout não produz aprovação. Validação de cada aba do Dashboard, XLSX, cobertura completa e matriz estendida ficam no perfil full solicitado explicitamente, sem bloquear uma nova versão por padrão. Mudança funcional nesses componentes exige somente os testes pertinentes ao impacto.
 - `AC-DIST-002-02`: o manifest registra versão, hashes e conteúdo efetivo de `.agents`, incluindo o runtime; qualquer divergência entre fonte, template e pacote bloqueia a candidatura.
 - `AC-DIST-002-03`: README, guias de instalação, versão pública e comandos documentados permanecem alinhados ao pacote qualificado e não prometem capability ausente.
 
@@ -38,6 +38,12 @@ classificação explícita. Dependências, compatibilidade, schemas, migrações
 históricas conservam seus próprios números. Igualdade de versão não substitui paridade
 de bytes, hashes, instalação real nem prova da versão publicada.
 
+Pedidos simples de atualização usam `npx --yes @zaip-ai/cli@latest init --force --yes --profile full`
+(`npx.cmd` no Windows), com backup antes de sobrescrever e instalação das dependências ausentes.
+Restrições explícitas prevalecem. No init sem force, catálogo oficial legado reconhecido pode
+ser atualizado e passa a integrar o lock; catálogo personalizado permanece protegido. Discovery
+gerenciada é uma projeção única, regenerada a partir do catálogo da versão instalada.
+
 ## REQ-DIST-003 — Configuração global portátil do Codex
 
 O CLI público deve descobrir o diretório inicial do usuário em execução e reconciliar a proteção