@zaip-ai/cli 6.2.0 → 7.5.0

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

@@ -39,6 +39,7 @@ import {
   WorkspaceStatusSpecimen,
   workspaceStatusFixtures,
 } from "../components/WorkspaceStatusSpecimen.js";
+import { MakerSpecimen } from "../specimens/MakerSpecimen.js";
 import {
   ReconciliationSpecimen,
   reconciliationFixtures,
@@ -50,7 +51,11 @@ const dashboardFamilies = [
   ["Tabelas", "DataTable, CostTables", "Cabeçalhos, densidade e alinhamento numérico"],
   ["Filtros e formulários", "CostFilters, PricingSettingsDialog", "Labels, ajuda e erro acionável"],
   ["Badges", "task-origin-badge, status badges", "Estado legível sem depender apenas de cor"],
-  ["Gráficos", "CostCharts", "Título, resumo textual e escala comparável"],
+  [
+    "Gráficos",
+    "CostCharts",
+    "Título, resumo textual e escala comparável; fases mostram a participação de cada métrica entre parênteses, sobre a soma das três fases. O dashboard exibe zero para ausência, preserva lacunas da série e documenta a cobertura",
+  ],
   ["Estados", "App, TraceabilityWorkspace", "Carregando, vazio e erro recuperável"],
 ] as const;
 
@@ -62,6 +67,12 @@ 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="Design System Maker"
+        description="Componentes locais reais do Maker: extrações, Viewer, revisões, propostas e feedback. Fixtures sintéticos e adaptador do formulário usam a identidade central vigente; cores extraídas são dados da proposta. A lógica de coleção e geração permanece no produto."
+      >
+        <MakerSpecimen />
+      </Section>
       <Section
         title="Filtros do Dashboard"
         description="Operação expõe busca, status, risco e origem no cabeçalho visível. O Monitor de Custos integrado usa o período global, sem painel adicional de filtros; Desenvolvedores também usa somente o período. Adaptadores nativos com limpeza e foco de teclado."
@@ -93,7 +104,7 @@ export function ComponentsPage() {
       </Section>
       <Section
         title="Identidade e saúde do Dashboard"
-        description="O título padrão é Dashboard ZAIP AIOS; na preparação, o nome do projeto aparece junto ao badge GitHub quando há repositório reconhecido. A superfície global reserva o caminho absoluto à Configuração do projeto e destaca avisos de saúde; lifecycle ausente ou inválido não aparece como dados válidos."
+        description="O caminho absoluto permanece na Configuração do projeto. Falha de saúde aparece como toast vermelho na pilha inferior direita, sem sobrepor atualização ou reconciliação, com ação Atualizar página e orientação para abrir novamente o executável. Lifecycle ausente ou inválido mantém seu diagnóstico específico."
       >
         {workspaceStatusFixtures.map((fixture) => (
           <WorkspaceStatusSpecimen key={fixture.name} fixture={fixture} />
@@ -224,7 +235,7 @@ export function ComponentsPage() {
       </Section>
       <Section
         title="Carregando, vazio e erro"
-        description="Estados assíncronos explicam o que ocorre e oferecem recuperação quando possível."
+        description="Estados assíncronos explicam o que ocorre e oferecem recuperação. No dashboard, o toast vermelho informa falha de carregamento ou atualização da projeção, com ação Atualizar página e orientação para reabrir o executável. Coleta pendente e dados novos não são erros; não há consulta de saúde periódica."
       >
         <StateGallery />
       </Section>

package/templates/.agents/design/apps/catalog/src/specimens/MAKER-HANDOFF.md

@@ -0,0 +1,134 @@
+# Maker central specimen — Task5
+
+Bounded result for TASK-2026-10-11-19-27-VISUAL-MAKER-APP-V64RAF5,
+CHG-2026-10-11-19-27-VISUAL-MAKER-APP-V64RAF5 and
+EXEC-2026-10-11-19-27-VISUAL-WORKFLOWS-V64RAF01. Acceptance: AC-DESIGN-002-04.
+Run: RUN-2026-10-11-23-50-SUBAGENT-AGENT-DESIGNER-V9RHL9DJUD.
+Parent: RUN-2026-10-11-22-59-SUBAGENT-AGENT-ORCHESTRATOR-CBNWKBGFR9.
+Native session: 01a12e03-ff90-7a83-a858-b899db3a7609;
+native turn: 01a12e04-015c-7c72-b680-bd9e006e1c04.
+Requested: gpt-6.1-sol/high. Effective: gpt-6.1-sol/high, observed by the host
+and relayed in the rich Start. The TOML was not treated as effective permission proof.
+Decision persisted by host: DEC-AI-2026-10-11-23-55-MAKER-SPECIMEN-E6JZFP8L5L.
+
+## Boundary and design decision
+
+The real Maker DOM presentation helpers are rendered through a small React mount adapter.
+`maker-native.js` imports only `shared/components.js` and `shared/viewer-detail.js`;
+their transitive dependency is the pure `shared/model.js`. It does not import API,
+collection, session, generation page orchestration, polling, or the Maker's CSS.
+Fixtures are synthetic, fixed, and independent of network, authentication and current time.
+Reference URLs are text and form values, never active external links.
+
+Every real helper link is contained to `#/components`; its intended original local
+path is retained in `data-maker-path` for inspection. Card actions select their
+synthetic output, sidebar links select via the product's real callback, historical
+revision buttons and return-current reuse `renderDetail`, and export/re-extraction
+links announce their illustrative path without requests or downloads. Modified-click
+destinations also remain the catalog hash. No reference screenshot is requested.
+
+The generator form has no independently exported presentation component. Its native
+fallback uses existing catalog Field/Button/Badge and represents the page's actual
+labels, URL validation constraints, busy/disabled fields, job status, log and recovery
+actions. It does not claim to exercise the product form or generation protocol.
+Interrupted monitoring keeps inputs/submission disabled and offers monitoring recovery;
+failed/completed states require a separate preparation, rather than sending a new job.
+
+Scoped CSS consumes existing semantic catalog variables and normative spacing/radius
+values (4/8/16/24/40px; 8/16/24px/pill), Inter/system fallback, central primary action,
+visible cyan focus and 44px controls. Dark semantics preserve readable text plus state
+labels. Candidate purple/amber are explicitly inferred proposal data, not global tokens.
+This work does not change the central contract; DESIGN.md/tokens/foundations are inputs.
+
+## Literal changed-file inventory
+
+All paths are relative to repository root. Existing tracked entry edited:
+
+- `.agents/design/apps/catalog/src/pages/ComponentsPage.tsx`
+
+New files:
+
+- `.agents/design/apps/catalog/src/specimens/MakerSpecimen.tsx`
+- `.agents/design/apps/catalog/src/specimens/MakerSpecimen.test.tsx`
+- `.agents/design/apps/catalog/src/specimens/maker-fixtures.js`
+- `.agents/design/apps/catalog/src/specimens/maker-fixtures.d.ts`
+- `.agents/design/apps/catalog/src/specimens/maker-native.js`
+- `.agents/design/apps/catalog/src/specimens/maker-native.d.ts`
+- `.agents/design/apps/catalog/src/specimens/MAKER-HANDOFF.md`
+- `.agents/design/apps/catalog/src/stories/Maker.stories.tsx`
+- `.agents/design/apps/catalog/src/styles/maker-specimen.css`
+- `.agents/design/tests/maker-native.test.mjs`
+
+No Maker implementation, runtime/data, source provenance, NOTICE, EXE, script/config,
+API, distributed build, lifecycle record, commit or publication was edited in this phase.
+The two declaration files describe the JS adapter/fixtures for strict TypeScript;
+the product's public JS exports were not changed.
+
+## Render and integration contract for Leo
+
+Entry: `#/components`, first section named **Design System Maker**.
+React boundary: `[data-testid="maker-central-specimen"]`.
+Story: `Components/Design System Maker`, exports `CatalogAndViewer`, `GenerationStates`.
+Both presentations use the same specimen and `maker-fixtures.js`.
+
+- Three `.catalog-card` articles: partial/ready/failed, unknown theme/archetype,
+  unassessed quality and inferred color candidates. Clicking a card's **Abrir output →**
+  selects that output in the same specimen, without visiting `/viewer/`.
+- `.maker-sidebar .output-item` links: exactly one `aria-current="page"`. Keyboard
+  activation changes selection and focuses `.maker-output[role="region"]`.
+- `.maker-hero` shows current revision 2 initially. **r1 · Parcial · 2026-10-10T12:00:00Z**
+  shows historical revision 1; **Voltar à revisão atual** returns to 2. Both move focus
+  to output. Failed selection exposes preserved interruption text.
+- `.maker-panels` render inferred colors, history, screenshot unavailable, candidate
+  JSON, observed components, provenance/capabilities, uncertainty and Markdown. The
+  visible `<script>`/`<img>` example strings must remain text, with no active nodes.
+- `.maker-feedback`: empty/loading/retry. Loading is `aria-busy="true"` and status;
+  **Tentar novamente (exemplo)** announces synthetic availability without fetching.
+- `[data-maker-job="idle"]`: editable URL/name and validation action. Invalid or
+  credentialed URL reports an associated error and focuses the URL field. Valid URL
+  announces local validation; no extraction is sent.
+- `[data-maker-job="queued"|"running"|"interrupted"]`: disabled inputs and submit.
+  Completed/failed also disable submit. Interrupted recovery explicitly resumes
+  monitoring without duplicate generation; failed recovery prepares another example.
+- Data/log regions are keyboard focusable and scrollable. All focused actions have
+  a scoped visible ring. At width<=760px, all Maker grids collapse to one column.
+
+Integration must examine served desktop and narrow views, light/dark identity,
+Tab/Enter and focus restoration, actual form feedback and absence of console errors
+or Maker API requests. Check `#/design-system` for regression. Build the source
+candidate through the authorized integration/distribution phase; no build was run here.
+Persist bounded screenshots with actual origin/viewport/candidate under the existing
+canonical mechanism; the root performs independent examination.
+
+## Observed verification and limits
+
+Environment: Windows, Node v22.16.0. Vitest 4.1.11. Tool outputs are locators for
+the host to record actual validations; this worker cannot persist lifecycle records.
+Recorded-at observation: 2026-10-11T23:58:19.2710866-03:00 (tool 9369f4).
+
+- `node --test .agents/design/tests/maker-native.test.mjs`:2/2 passed, toola85bf1.
+  Covers real helpers, safe text, no active reference images/scripts, contained links,
+  selection/history/return-current callbacks, focus call, failed detail and retry.
+- `node node_modules/vitest/vitest.mjs run src/specimens/MakerSpecimen.test.tsx src/design-contract.test.ts --no-cache --configLoader runner`
+  from catalog directory:2 files/3 tests passed, tool2033a2; start23:57:05-03:00.
+  Covers URL constraints, real disabled/status markup and unchanged central token parity.
+  Config runner/no-cache avoids configured out-of-scope cache/build output.
+- `node node_modules/typescript/bin/tsc --noEmit --project .agents/design/apps/catalog/tsconfig.json`:
+  passed exit0, tool483adb. An initial short `-p` variant was blocked before execution
+  by inline-interpreter classification. Host supplied the normal explicit syntax;
+  the guard was not edited or claimed repaired.
+- Scoped Biome10 files passed without fixes, tool6d5003. Initial formatting/import-order
+  issues and one assignment-in-expression in test fixture were corrected within scope.
+  A later scoped CSS/adapter check also passed, toolfc46de.
+- Literal Git diff/status observed tools23deaa/9eec02. Initial chained commands were
+  blocked and then separated as required by the hook. No Git policy was changed.
+- Source inventory tool32b908: all touched modules below400 lines; largest entry272,
+  stylesheet183 before final two selector additions. No build/output mutation.
+
+Final checks after the semantic region/standalone-story CSS and cleanup assertion:
+same Node command passed 2/2 (tool c4d2c6); same Vitest command passed 3/3 across two
+files (tool 320422, start 2026-10-12T00:00:48-03:00); same tsc command passed exit 0
+(tool ce160f); same scoped Biome check passed 10 files without fixes (tool 78bc70).
+DOM fixtures and server markup are not real browser,
+pixel, contrast, full accessibility or product integration proof. No final approval,
+Task completion, screenshot examination or publication is claimed by this worker.

package/templates/.agents/design/apps/catalog/src/specimens/MakerSpecimen.test.tsx

@@ -0,0 +1,143 @@
+import { renderToStaticMarkup } from "react-dom/server";
+import { describe, expect, it, vi } from "vitest";
+import { MakerGenerationSpecimen, validMakerExampleUrl } from "./MakerSpecimen.js";
+import { makerDetail, makerJobFixtures, makerSummaries } from "./maker-fixtures.js";
+
+// Minimal inert DOM for the native Maker renderer; no browser, API or source HTML execution.
+class MakerNode {
+  childNodes: MakerNode[] = [];
+  attrs: Record<string, string> = {};
+  dataset: Record<string, string> = {};
+  textContent = "";
+  className = "";
+  remove = () => {};
+  classList = { toggle() {}, remove() {} };
+  style: Record<string, unknown> = {
+    setProperty: (name: string, value: string) => {
+      this.style[name] = value;
+    },
+    removeProperty: (name: string) => {
+      delete this.style[name];
+    },
+  };
+  constructor(public tag: string) {}
+  get tagName() {
+    return this.tag.toUpperCase();
+  }
+  append(...children: MakerNode[]) {
+    this.childNodes.push(...children);
+  }
+  prepend(...children: MakerNode[]) {
+    this.childNodes.unshift(...children);
+  }
+  replaceChildren(...children: MakerNode[]) {
+    this.childNodes = children;
+  }
+  setAttribute(name: string, value: string) {
+    this.attrs[name] = value;
+  }
+  addEventListener() {}
+  querySelector(tag: string) {
+    const node = this.childNodes.find((child) => child.tag === tag);
+    if (node)
+      node.remove = () => {
+        this.childNodes = this.childNodes.filter((child) => child !== node);
+      };
+    return node ?? null;
+  }
+  set innerHTML(_value: string) {
+    throw new Error("Active HTML forbidden");
+  }
+}
+const descendants = (root: MakerNode): MakerNode[] => [
+  root,
+  ...root.childNodes.flatMap(descendants),
+];
+
+describe("Maker native form fallback", () => {
+  it("validates protocol and credential constraints without requesting an extraction", () => {
+    for (const value of [
+      "",
+      "not a URL",
+      "javascript:alert(1)",
+      "https://user:secret@example.test",
+    ]) {
+      expect(validMakerExampleUrl(value)).toBe(false);
+    }
+    expect(validMakerExampleUrl("https://example.test/synthetic")).toBe(true);
+    expect(validMakerExampleUrl("http://example.test/synthetic")).toBe(true);
+  });
+  it("keeps queued/running/interrupted fields disabled and terminal operations distinct", () => {
+    for (const fixture of makerJobFixtures) {
+      const html = renderToStaticMarkup(<MakerGenerationSpecimen fixture={fixture} />);
+      expect(html).toContain(`data-maker-job="${fixture.state}"`);
+      expect(html).toContain('role="status"');
+      expect(html).toContain('type="url"');
+      const inputs = html.match(/<input[^>]*>/g) ?? [];
+      expect(inputs).toHaveLength(2);
+      expect(inputs.every((input) => input.includes("disabled"))).toBe(
+        ["queued", "running", "interrupted"].includes(fixture.state),
+      );
+      if (fixture.state === "interrupted") expect(html).toContain("Retomar acompanhamento");
+      if (fixture.state === "failed") expect(html).toContain("Preparar outra extração");
+      if (fixture.state === "completed") expect(html).toContain("Output sintético disponível");
+      expect(html).not.toContain("/api/");
+    }
+  });
+  it("renders the real Maker detail with observed/CSS colors, explicit fallback and incomplete coverage", async () => {
+    vi.stubGlobal("document", { createElement: (tag: string) => new MakerNode(tag) });
+    try {
+      // The same native module is used by maker-native.js in the central Components page.
+      const modulePath = "../../../../design-system-maker/frontend/shared/viewer-detail.js";
+      const { renderDetail } = await import(new URL(modulePath, import.meta.url).href);
+      const hero = new MakerNode("div"),
+        panel = new MakerNode("div");
+      const summary = makerSummaries.find((item) => item.status === "partial")!;
+      const snapshot = JSON.stringify(summary);
+      renderDetail(makerDetail(summary), {
+        hero,
+        panel,
+        current() {},
+        viewRevision() {},
+        historyMore() {},
+      });
+      const all = descendants(panel);
+      const text = all.map((node) => node.textContent).join("\n");
+      for (const expected of [
+        "Observadas na captura",
+        "Candidatas CSS",
+        "#ff6600",
+        "#ffcc00",
+        "#8844cc",
+        "Fallback local do preview",
+        "Primária #171717",
+        "Papéis sem suporte: Primária, Destaque",
+        "Captura incompleta",
+        "48 omitidos",
+      ])
+        expect(text).toContain(expected);
+      expect(all.some((node) => node.dataset.paletteSource === "observed")).toBe(true);
+      expect(all.some((node) => node.dataset.paletteSource === "declared")).toBe(true);
+      expect(JSON.stringify(summary)).toBe(snapshot);
+      expect(
+        descendants(hero)
+          .map((node) => node.textContent)
+          .join("\n"),
+      ).toContain("fidelidade visual não medida");
+      renderDetail(makerDetail(summary, 1), {
+        hero,
+        panel,
+        current() {},
+        viewRevision() {},
+        historyMore() {},
+      });
+      expect(descendants(panel).some((node) => node.dataset.paletteSource)).toBe(false);
+      expect(makerDetail(summary, 1).visual_model).toBeUndefined();
+      expect(
+        makerDetail(makerSummaries.find((item) => item.status === "failed")!).report,
+      ).toBeUndefined();
+    } finally {
+      vi.unstubAllGlobals();
+    }
+  });
+});

package/templates/.agents/design/apps/catalog/src/specimens/MakerSpecimen.tsx

@@ -0,0 +1,132 @@
+import { useEffect, useId, useRef, useState } from "react";
+import { Badge, Button, Field } from "../components/Primitives.js";
+import { type MakerJobFixture, makerJobFixtures } from "./maker-fixtures.js";
+import { mountMakerSpecimen } from "./maker-native.js";
+import "../styles/maker-specimen.css";
+
+export function validMakerExampleUrl(value: string) {
+  try {
+    const url = new URL(value);
+    return ["http:", "https:"].includes(url.protocol) && !url.username && !url.password;
+  } catch {
+    return false;
+  }
+}
+
+// Native fallback for generate.html's page-bound form. It demonstrates the public
+// UI contract, without copying nonce, submission, polling or collection logic.
+export function MakerGenerationSpecimen({ fixture }: { fixture: MakerJobFixture }) {
+  const prefix = useId();
+  const [error, setError] = useState("");
+  const [notice, setNotice] = useState("");
+  const busy = ["queued", "running", "interrupted"].includes(fixture.state);
+  const tone =
+    fixture.state === "failed" ? "error" : fixture.state === "completed" ? "success" : "accent";
+  return (
+    <article className="maker-specimen maker-generation" data-maker-job={fixture.state}>
+      <form
+        aria-label={`Gerar proposta: ${fixture.name}`}
+        aria-busy={busy}
+        noValidate
+        onSubmit={(event) => {
+          event.preventDefault();
+          const data = new FormData(event.currentTarget);
+          if (!validMakerExampleUrl(String(data.get("url") ?? ""))) {
+            setError("Informe uma URL HTTP/HTTPS válida, sem credenciais.");
+            setNotice("");
+            const field = event.currentTarget.elements.namedItem("url");
+            if (field instanceof HTMLInputElement) field.focus();
+          } else {
+            setError("");
+            setNotice("URL válida no exemplo. Nenhuma extração foi enviada.");
+          }
+        }}
+      >
+        <h3>{fixture.name}</h3>
+        <Field
+          id={`${prefix}-url`}
+          name="url"
+          type="url"
+          label="URL pública"
+          hint="Exemplo sintético; o catálogo não faz extrações."
+          error={error}
+          required
+          maxLength={4096}
+          disabled={busy}
+          defaultValue="https://example.test/synthetic"
+        />
+        <Field
+          id={`${prefix}-name`}
+          name="name"
+          label="Nome do output (opcional)"
+          maxLength={128}
+          disabled={busy}
+          defaultValue="Proposta sintética"
+        />
+        <p>Novo output · primeira revisão</p>
+        <Button type="submit" disabled={fixture.state !== "idle"}>
+          Gerar DESIGN.md (exemplo)
+        </Button>
+        {error ? <p role="alert">{error}</p> : null}
+        <p role="status">{notice}</p>
+      </form>
+      <section aria-label={`Operação sintética: ${fixture.name}`}>
+        <h3>Acompanhe o output</h3>
+        <p role="status" aria-live="polite">
+          <Badge tone={tone}>{fixture.name}</Badge>
+        </p>
+        <p>Proposta local; qualidade e fidelidade permanecem não avaliadas.</p>
+        {fixture.state === "completed" ? <p>Output sintético disponível no Viewer acima.</p> : null}
+        {fixture.state === "failed" || fixture.state === "interrupted" ? (
+          <Button
+            variant="secondary"
+            onClick={() =>
+              setNotice(
+                fixture.state === "interrupted"
+                  ? "Acompanhamento retomado no exemplo; nenhuma geração reenviada."
+                  : "Preparação reiniciada no exemplo; nenhuma geração enviada.",
+              )
+            }
+          >
+            {fixture.state === "interrupted"
+              ? "Retomar acompanhamento (exemplo)"
+              : "Preparar outra extração (exemplo)"}
+          </Button>
+        ) : null}
+        <h4>Registro da operação</h4>
+        {/* biome-ignore lint/a11y/noNoninteractiveTabindex: scrollable log is keyboard accessible */}
+        <section className="code-region" tabIndex={0} aria-label={`Registro: ${fixture.name}`}>
+          <pre>{fixture.log}</pre>
+        </section>
+      </section>
+    </article>
+  );
+}
+
+export function MakerSpecimen() {
+  const root = useRef<HTMLDivElement>(null);
+  useEffect(() => {
+    if (root.current) return mountMakerSpecimen(root.current);
+    return undefined;
+  }, []);
+  return (
+    <div className="maker-specimen" data-testid="maker-central-specimen">
+      <p>
+        Implementação DOM real: filtros, dropdown de cores, cards, seleção, revisões e diálogo de
+        reprocessamento do Maker. O diálogo usa serviços sintéticos e avanço manual do cenário;
+        nenhum POST é enviado. Cores candidatas são propostas sintéticas, sem promoção de tokens.
+      </p>
+      <div ref={root} />
+      <h3>Formulário e operação: adaptador nativo</h3>
+      <p>
+        Fixtures fixos; sem API, sessão ou polling. Tab percorre ações, campos e dados roláveis;
+        Enter valida ou ativa a ação com foco visível.
+      </p>
+      <div className="maker-jobs">
+        {makerJobFixtures.map((fixture) => (
+          <MakerGenerationSpecimen key={fixture.state} fixture={fixture} />
+        ))}
+      </div>
+    </div>
+  );
+}

package/templates/.agents/design/apps/catalog/src/specimens/maker-fixtures.d.ts

@@ -0,0 +1,15 @@
+export interface MakerSummary {
+  id: string;
+  name: string;
+  status: string;
+  revision: number;
+  [key: string]: unknown;
+}
+export interface MakerJobFixture {
+  state: "idle" | "queued" | "running" | "completed" | "failed" | "interrupted";
+  name: string;
+  log: string;
+}
+export const makerSummaries: MakerSummary[];
+export function makerDetail(summary: MakerSummary, revision?: number): Record<string, unknown>;
+export const makerJobFixtures: MakerJobFixture[];

package/templates/.agents/design/apps/catalog/src/specimens/maker-fixtures.js

@@ -0,0 +1,86 @@
+// Synthetic, fixed examples. These are proposal data, never central design tokens.
+import { paletteFixture } from "../../../../design-system-maker/frontend/fixtures/palette-evidence.js";
+
+export const makerSummaries = ["partial", "ready", "failed"].map((status, index) => ({
+  id: `catalog-synthetic-${status}`,
+  name: ["Referência parcial", "Referência pronta", "Referência com falha"][index],
+  slug: `synthetic-${status}`,
+  host: "example.test",
+  url: "https://example.test/synthetic",
+  status,
+  design_score:
+    index === 2 ? null : { grade: index === 0 ? "B" : "A", overall: index === 0 ? 81 : 92 },
+  revision: 2,
+  theme: null,
+  archetype: null,
+  designMdUrl: "synthetic-design-text",
+  visual: {
+    inferred_swatches: [
+      { kind: "inferred", value: "#A855F7" },
+      { kind: "inferred", value: "#F59E0B" },
+    ],
+  },
+  capabilities: { screenshot_verified: false },
+  provenance: { source: "synthetic-fixture", observation: "CSS declarations only" },
+  uncertainty: ["Tema desconhecido", "Qualidade não avaliada", "Fidelidade não verificada"],
+  ...(status === "failed" ? {} : { visual_model: paletteFixture().visual_model }),
+}));
+
+export function makerDetail(summary, revision = 2) {
+  const evidence = paletteFixture();
+  const measured = summary.status !== "failed" && revision > 1;
+  const report = measured
+    ? {
+        ...evidence.report,
+        status: "measured-evidence",
+        score: 0,
+        score_kind: "extraction-evidence-coverage",
+        method_version: "synthetic-fixture-not-an-extraction",
+        metrics: [],
+        sampling: { total: 0, sampled: 0, truncated: 0 },
+        spacing: [],
+        radii: [],
+        components: [],
+        resources: [],
+        gaps: [],
+        limitations: [],
+        element_count: 0,
+      }
+    : undefined;
+  return {
+    summary: { ...summary, revision, visual_model: measured ? evidence.visual_model : undefined },
+    visual_model: measured ? evidence.visual_model : undefined,
+    ...(report ? { report } : {}),
+    revision,
+    revision_count: 2,
+    revisions: [
+      { revision: 2, status: summary.status, updated_at: "2026-10-11T12:00:00Z" },
+      { revision: 1, status: "partial", updated_at: "2026-10-10T12:00:00Z" },
+    ],
+    tokens: {
+      candidates: [{ kind: "inferred", value: "#A855F7", source: "synthetic CSS" }],
+      components: [{ name: "Card sintético", evidence: "<img src=x onerror=alert(1)>" }],
+    },
+    designMd:
+      "# Proposta sintética\n\n<script>alert('texto, nunca HTML')</script>\n\nSem promoção central.",
+    error:
+      summary.status === "failed" ? "Extração sintética interrompida; revisão preservada." : null,
+  };
+}
+
+export const makerJobFixtures = [
+  { state: "idle", name: "Validação do formulário", log: "Nenhuma operação iniciada." },
+  { state: "queued", name: "Na fila", log: "Operação sintética aceita; aguardando execução." },
+  { state: "running", name: "Em execução", log: "Coletando declarações CSS sintéticas." },
+  {
+    state: "completed",
+    name: "Concluído",
+    log: "Proposta sintética salva. Fidelidade não avaliada.",
+  },
+  { state: "failed", name: "Falhou", log: "Falha sintética. Nenhuma nova proposta disponível." },
+  {
+    state: "interrupted",
+    name: "Acompanhamento interrompido",
+    log: "Operação pode continuar; retome o acompanhamento, sem reenviar.",
+  },
+];

package/templates/.agents/design/apps/catalog/src/specimens/maker-native.d.ts

@@ -0,0 +1 @@
+export function mountMakerSpecimen(root: HTMLElement): () => void;