@zaip-ai/cli 3.4.0 → 3.5.0

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

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

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

@@ -0,0 +1,70 @@
+import { Card } from "./Primitives.js";
+
+type VersionKind = "exact" | "reference";
+
+export type StackVersionFieldFixture = {
+  name: string;
+  technology: string;
+  value: string;
+  kind: VersionKind;
+  source: string;
+};
+
+/** Stable native adapter for the Setup Project version-or-reference input contract. */
+export const stackVersionFieldFixtures: readonly StackVersionFieldFixture[] = [
+  {
+    name: "Versão exata",
+    technology: "TypeScript",
+    value: "7.0.2",
+    kind: "exact",
+    source: "npm:typescript",
+  },
+  {
+    name: "Serviço em nuvem",
+    technology: "PostgreSQL via Supabase",
+    value: "Serviço em nuvem",
+    kind: "reference",
+    source: "service:supabase-postgresql",
+  },
+  {
+    name: "Hospedagem em nuvem",
+    technology: "Hostinger VPS",
+    value: "Serviço em nuvem",
+    kind: "reference",
+    source: "provider:hostinger-vps",
+  },
+] as const;
+
+export function StackVersionFieldSpecimen({
+  fixture,
+}: {
+  fixture: StackVersionFieldFixture;
+}) {
+  const isReference = fixture.kind === "reference";
+  const label = isReference ? "Referência descritiva" : "Versão exata";
+
+  return (
+    <Card>
+      <div className="stack-version-field-heading">
+        <div>
+          <p className="metric-label">{label}</p>
+          <h3>{fixture.technology}</h3>
+        </div>
+        <span className={`stack-version-kind is-${fixture.kind}`}>{label}</span>
+      </div>
+      <label className="stack-version-field">
+        <span>{isReference ? "Versão atual ou referência" : "Versão exata"}</span>
+        <input
+          aria-describedby={`stack-version-source-${fixture.name}`}
+          className={isReference ? "is-reference-value" : undefined}
+          defaultValue={fixture.value}
+          inputMode={isReference ? "text" : "decimal"}
+          readOnly
+        />
+      </label>
+      <p className="stack-version-source" id={`stack-version-source-${fixture.name}`}>
+        {fixture.source}
+      </p>
+    </Card>
+  );
+}

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

@@ -1,10 +1,14 @@
 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" },
+  { name: "Configuração", kind: "settings", message: "C:/projetos/zaip-growth" },
+  { name: "Ausente", kind: "warning", message: "Lifecycle não inicializado" },
+  { name: "Inválido", kind: "warning", message: "Manifesto do lifecycle inválido" },
+  {
+    name: "Indisponível",
+    kind: "warning",
+    message: "Não foi possível consultar a saúde do Dashboard",
+  },
 ] as const;
 
 /** Native adapter: the catalog cannot depend on the Dashboard application. */
@@ -13,12 +17,24 @@ export function WorkspaceStatusSpecimen({
 }: {
   fixture?: (typeof workspaceStatusFixtures)[number];
 }) {
+  if (fixture.kind === "settings") {
+    return (
+      <Card>
+        <h3>{fixture.name}</h3>
+        <section aria-label="Configuração do projeto">
+          <strong>Caminho do projeto</strong>
+          <p>
+            <code style={{ overflowWrap: "anywhere" }}>{fixture.message}</code>
+          </p>
+        </section>
+      </Card>
+    );
+  }
+
   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>
+      <aside aria-label="Saúde do Dashboard" style={{ overflowWrap: "anywhere" }}>
         <p>{fixture.message}</p>
       </aside>
     </Card>

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

@@ -1,13 +1,13 @@
 import { AutonomySpecimen, autonomyFixtures } from "../components/AutonomySpecimen.js";
-import {
-  DashboardFiltersSpecimen,
-  dashboardFilterFixtures,
-} from "../components/DashboardFiltersSpecimen.js";
 import { PageIntro, Section } from "../components/CatalogShell.js";
 import {
   CostPopulationSpecimen,
   costPopulationFixtures,
 } from "../components/CostPopulationSpecimen.js";
+import {
+  DashboardFiltersSpecimen,
+  dashboardFilterFixtures,
+} from "../components/DashboardFiltersSpecimen.js";
 import {
   EstimatedCostSpecimen,
   estimatedCostFixtures,
@@ -30,6 +30,10 @@ import {
   ProjectStatusSpecimen,
   projectStatusFixtures,
 } from "../components/ProjectStatusSpecimen.js";
+import {
+  StackVersionFieldSpecimen,
+  stackVersionFieldFixtures,
+} from "../components/StackVersionFieldSpecimen.js";
 import {
   WorkspaceStatusSpecimen,
   workspaceStatusFixtures,
@@ -75,8 +79,8 @@ export function ComponentsPage() {
         </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."
+        title="Identidade e saúde do Dashboard"
+        description="O caminho absoluto fica restrito à Configuração do projeto. A superfície global aparece somente para avisos de saúde; lifecycle ausente ou inválido impede a exibição de zeros como dados válidos."
       >
         {workspaceStatusFixtures.map((fixture) => (
           <WorkspaceStatusSpecimen key={fixture.name} fixture={fixture} />
@@ -109,6 +113,16 @@ export function ComponentsPage() {
           </div>
         ))}
       </Section>
+      <Section
+        title="Versões e referências da stack"
+        description="No Setup Project, versões exatas usam valor técnico curto. Serviços em nuvem e capacidade de hospedagem usam referência descritiva, identificada por texto e tratamento visual próprio — sem parecer uma versão numérica."
+      >
+        <div className="stack-version-field-grid">
+          {stackVersionFieldFixtures.map((fixture) => (
+            <StackVersionFieldSpecimen fixture={fixture} key={fixture.name} />
+          ))}
+        </div>
+      </Section>
       <Section
         title="Custo estimado compacto"
         description="Adaptador nativo: título e taxas compactos; cobertura parcial fica na ajuda acessível. Ausência não vira zero nem média de uma população incompleta."

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

@@ -23,6 +23,10 @@ import {
   ProjectStatusSpecimen,
   projectStatusFixtures,
 } from "../components/ProjectStatusSpecimen.js";
+import {
+  StackVersionFieldSpecimen,
+  stackVersionFieldFixtures,
+} from "../components/StackVersionFieldSpecimen.js";
 import { ComponentsPage } from "../pages/ComponentsPage.js";
 
 const meta = {
@@ -113,6 +117,16 @@ export const ProjectInstallationStatus: Story = {
   ),
 };
 
+export const StackVersionsAndReferences: Story = {
+  render: () => (
+    <div className="stack-version-field-grid">
+      {stackVersionFieldFixtures.map((fixture) => (
+        <StackVersionFieldSpecimen fixture={fixture} key={fixture.name} />
+      ))}
+    </div>
+  ),
+};
+
 export const Tables: Story = {
   render: () => <DataTable />,
 };

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

@@ -2,8 +2,11 @@ import {
   WorkspaceStatusSpecimen,
   workspaceStatusFixtures,
 } from "../components/WorkspaceStatusSpecimen.js";
-export default { title: "Components/Workspace do Dashboard", component: WorkspaceStatusSpecimen };
-export const Initialized = { args: { fixture: workspaceStatusFixtures[0] } };
+export default {
+  title: "Components/Identidade e saúde do Dashboard",
+  component: WorkspaceStatusSpecimen,
+};
+export const ProjectSettings = { 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

@@ -1,3 +1,4 @@
+@import "./stack-version-field.css";
 .card {
   border: 1px solid var(--border);
   border-radius: 24px;
@@ -498,7 +499,6 @@ tbody tr:last-child td {
     width: 100%;
   }
 }
-
 @media (prefers-reduced-motion: reduce) {
   .editorial-hero-orbit {
     box-shadow: none;

package/templates/.agents/design/apps/catalog/src/styles/stack-version-field.css

@@ -0,0 +1,17 @@
+.stack-version-field-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 18px; }
+.stack-version-field-grid > .card:last-child { grid-column: span 2; }
+.stack-version-field-heading { display: flex; align-items: flex-start; justify-content: space-between; gap: 12px; }
+.stack-version-field-heading h3 { margin: 8px 0 0; font-size: 1.1rem; }
+.stack-version-kind { flex: 0 0 auto; border-radius: 999px; padding: 5px 8px; font-size: 0.72rem; font-weight: 700; }
+.stack-version-kind.is-exact { background: #f0fdf4; color: #166534; }
+.stack-version-kind.is-reference { background: var(--primary-soft); color: var(--primary-ink); }
+.stack-version-field { display: grid; gap: 8px; margin-top: 18px; color: var(--text); font-size: 0.82rem; font-weight: 700; }
+.stack-version-field input { width: 100%; min-height: 44px; border: 1px solid #cbd5e1; border-radius: 10px; padding: 9px 10px; background: var(--surface-muted); color: var(--text); font: inherit; font-size: 0.88rem; overflow: hidden; text-overflow: ellipsis; }
+.stack-version-field input.is-reference-value { border-color: #9edcf2; background: #effaff; color: #075985; font-weight: 650; }
+.stack-version-field input:focus-visible { outline: 3px solid color-mix(in srgb, var(--focus) 38%, transparent); outline-offset: 2px; }
+.stack-version-source { margin: 10px 0 0; color: var(--text-muted); font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 0.75rem; overflow-wrap: anywhere; }
+
+@media (max-width: 720px) {
+  .stack-version-field-grid,
+  .stack-version-field-grid > .card:last-child { grid-template-columns: 1fr; grid-column: auto; }
+}

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

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

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.4.0"
+source_release: "3.5.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.4.0"
+source_release: "3.5.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.4.0"
+source_release: "3.5.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.4.0"
+source_release: "3.5.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.4.0"
+source_release: "3.5.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.4.0"
+source_release: "3.5.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.4.0"
+source_release: "3.5.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.4.0"
+source_release: "3.5.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.4.0"
+source_release: "3.5.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.4.0"
+source_release: "3.5.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.4.0"
+source_release: "3.5.0"
 ---
 
 # Orquestração de modelos

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

@@ -6,7 +6,7 @@ title: Distribuição pública e ativação
 status: active
 version: 8
 source_change: null
-source_release: "3.4.0"
+source_release: "3.5.0"
 ---
 
 # Distribuição pública e ativação

package/templates/.agents/requirements/software-architecture.md

@@ -6,7 +6,7 @@ title: Layout modular e limites de código-fonte
 status: active
 version: 5
 source_change: null
-source_release: "3.4.0"
+source_release: "3.5.0"
 ---
 
 # Software architecture

package/templates/.agents/requirements/strategic-improvements.md

@@ -6,7 +6,7 @@ title: Melhorias estratégicas de custo, qualidade e resiliência
 status: active
 version: 1
 source_change: null
-source_release: "3.4.0"
+source_release: "3.5.0"
 ---
 
 # Melhorias estratégicas de custo, qualidade e resiliência

package/templates/.agents/requirements/work-lifecycle.md

@@ -6,7 +6,7 @@ title: Ciclo de vida do trabalho
 status: active
 version: 26
 source_change: null
-source_release: "3.4.0"
+source_release: "3.5.0"
 ---
 
 # Work lifecycle

package/templates/.agents/requirements/zaip-strategic-95.md

@@ -6,7 +6,7 @@ title: Evidências, custo por Task e autonomia por SPEC
 status: active
 version: 1
 source_change: null
-source_release: "3.4.0"
+source_release: "3.5.0"
 ---
 
 # Evidências, custo por Task e autonomia por SPEC

package/templates/.agents/rules/workflow.md

@@ -23,6 +23,6 @@ phases: [planning, execution, verification, evidence]
 - `RUN-*` identifica invocação física: raiz `orchestrator`, pai nulo/profundidade zero; filha `delegated`, pai/raiz/profundidade positiva, mesmo quando o agente filho orquestra uma Task. Task é a unidade de tentativa; PRD/SPEC coordenam dependências e aceite parental. `MCALL-*` pertence a uma invocação; fechamento e retomada seguem `RULE-RUN-LIFECYCLE-CLOSURE`.
 - Reconciliação global só após confirmação humana no popup, nunca abrir dashboard/turno/intervalo; usa `task_complete` exato ou falha órfã após dez minutos, sem inferir cancelamento/sucesso. Risco é `lite|standard|critical`; anexos só por risco/Evidence. Assurance V1: standalone lite uma validação/Evidence e teste só lógica/regressão; standard 2–3 validações, teste e Evidence consolidada; critical 3+ e quality review independente. Mutação, rollback, commit final e Evidence/AC dependem de sinais persistidos; sem sinal preserve gate conservador. SPEC/PRD adicionam matriz parental, 3 validações/Evidences, integração e revisão independente.
 - Novos projetos usam `execution.runtime: managed`: PRD/SPEC gerenciados, avulsas diretas. Ausente/manual não invoca provider; autonomous permite também Task gerenciada explícita. Commit exige Task real e título: `[CODEX|CLAUDE] [P:XXXX] [S:XXXX] [T:XXXX]`, ou `[Task-first:XXXX]` sem PRD/SPEC. Assunto ≤96, título reduz por palavra, IDs completos em trailers `ZAIP-*`. Somente `.agents/records/**` e `.local/**` dispensam identidade; `.agents` inteira não. Nunca escolher última Task global. Política: `.agents/skills/zaip-skill-task/references/commit-policy.md`.
-- Pedido explícito de `deploy|push|publicar|publicação GitHub` autoriza `$zaip-skill-github-deploy` a reconciliar branch/worktree selecionados e commitar o diff evidenciado com pathspecs explícitos. Consumidor é GitHub-only e independente. Release inicia `v1.0`, incrementa minor, muda major só por pedido e reutiliza tag só com SHA idêntico. No framework, o helper resolve `vN.N` e pacote `N.N.0`; só GitHub Actions publica npm. Release beta é prerelease sem sufixo; `main` é promoção humana. Use `rebase` por padrão ou `merge` escolhido pelo usuário, com referência recuperável e stash nomeado. Produto exige Task atribuída; publicar commits existentes continua Git-only. Nunca staging amplo, `git add -A`, force, segredos, squash, feature alheia ou outro worktree.
+- Pedido explícito de `deploy|push|publicar|publicação GitHub` autoriza `$zaip-skill-github-deploy` a reconciliar branch/worktree selecionados e commitar o diff evidenciado com pathspecs explícitos. A branch local ou o estado detached identificam a origem; a branch configurada identifica o alvo remoto e não exige checkout local nela. Preserve uma referência recuperável, reconcilie o candidato por SHA e publique somente por refspec explícito. Consumidor é GitHub-only e independente. Release inicia `v1.0`, incrementa minor, muda major só por pedido e reutiliza tag só com SHA idêntico. No framework, o helper resolve `vN.N` e pacote `N.N.0`; só GitHub Actions publica npm. Release beta é prerelease sem sufixo; `main` é promoção humana. Use `rebase` por padrão ou `merge` escolhido pelo usuário, com referência recuperável e stash nomeado. Produto exige Task atribuída; publicar commits existentes continua Git-only. Nunca staging amplo, `git add -A`, force, segredos, squash, feature alheia ou outro worktree.
 - Executar uma entrega autoriza seu commit local via `task commit TASK --files PATH[,PATH] --run RUN` antes da prova final; preserve o index alheio e resolva sobreposição de autoria. Git, HEAD e identidade devem estar prontos antes de iniciar. Conversas não criam commits artificiais. `validation execute` usa o Node do host e script relativo versionado/revisado no SHA, sem código inline/loaders; a worktree comprova o candidato, não é sandbox do SO. Só essa prova separa alterações concorrentes da entrega intacta; registros manuais mantêm o gate conservador. Documento externo exige revisão identificada ou exportação versionada. Commit não autoriza push nem substitui revisão/finalizador.
 - Plano visível: `DEFINE:` contexto/resultado/critério, `PLAN:` ciclo/DAG, `EXECUTE:` mudança, `VERIFY:` valida/Evidence/encerra; não use artefato como fase nem narre comandos internos. Registre decisão humana/IA com origem junto de Change/Execution; derive ledger do Git diff e preserve alterações do usuário. Estado novo fica em `.agents/records/<kind>/<ano>/<mês>`; diário, `.agents/data` e V1 são legado só leitura até migração explícita.

package/templates/.agents/runtime/VERSION

@@ -1 +1 @@
-3.4.0
+3.5.0