Component Author

Projekt z Figmy zamienia się w mail automatycznie. Gdy jakaś sekcja nie pasuje do żadnego istniejącego komponentu, ląduje w mailu jako płaski obrazek.

Operator klika na ten obrazek Request Component. Powstaje zgłoszenie i zaczyna się praca agenta.

async function drive(request, command) {
  switch (command) {
    case "runAuthor":       return app.runAuthor(request.id);
    case "runVerification": return app.runVerification(request.id);
    case "recoverApply":    return app.apply(request.id, { recover: true });
  }
}
// claim → drive → complete; kłódka chroni przed dwoma workerami
claim = await deps.work.claim(candidate.id, deps.workerId, leaseSeconds);

query({
  prompt,
  options: {
    cwd: repoRoot,
    model: "opus",
    maxTurns: 120,
    maxBudgetUsd,
    systemPrompt,
    allowedTools: [
      "Read", "Edit", "Write", "Glob", "Grep", "Bash",
      "mcp__component_author__save_resolution",
      "mcp__component_author__render_previews",
      "mcp__component_author__finish",
    ],
    permissionMode: "bypassPermissions", // VM nie ma sekretów
    resume: resumeSessionId,             // kontynuuje poprzednią rozmowę
  },
});

# Component Author

You author one email component from a Figma
section that ingestion could only ship as an
image fallback. You work in an isolated sandbox.

## Reuse is a valid verdict
If an existing block renders this section
faithfully, do not write code. Finish with
`reuse_existing`. The tree must be unchanged.

## Allowed paths (enforced by the host)
- studio/lib/email/blocks/types.ts
- studio/lib/email/blocks/manifest.ts
- studio/app/(studio)/composer/config.tsx
  …
Never touch: .github/, .claude/, supabase/ …
Never run git commit, git push or gh.

W Studio operator nie ogląda zrzutów. Widzi prawdziwy HTML maila w odizolowanym iframe (bez skryptów, linki otwierają się w nowej karcie), w 4 wariantach: desktop i mobile, jasny i ciemny. PNG zostają jako dowód i zapas dla starych rewizji.

Uwagę można przypiąć do konkretnego elementu (mapa elementów z DOM) i wysłać agenta na kolejną rundę. Sandbox zostaje ciepły 15 minut, a model wraca do swojej poprzedniej rozmowy.

Dlaczego bot może otwierać PR do main? Merge to od razu deploy, a komponent maila działa dopiero po deployu. Obrona tej decyzji to allowlist, zielone bramki przed PR i człowiek, który klika merge.

Co z czerwonym reviewem? Uwagi developera trafiają do agenta jako runda pr_repair, z tym samym werdyktem i komponentem. Liczba prób jest ograniczona, potem zgłoszenie wraca do człowieka.

publishing:             ["technical_review", "policy_rejected", "cancelled"],
technical_review:       ["merged_awaiting_deploy", "visual_review", "budget_paused", "cancelled"],
merged_awaiting_deploy: ["ready_to_apply", "cancelled"],
ready_to_apply:         ["applying", "cancelled"],
applying:               ["applied", "ready_to_apply"],
// dziś worker zatrzymuje się na publishing; UI pokazuje „Awaiting publication”