Inputs and stages
The setup pipeline reads public pages and their structure/styles, extracts company/brand context, proposes audiences and opportunities, generates approved-target alternatives, validates configuration and saves draft work. Goal discovery and design/placement review support the launch process. Thesetup directory separates public fetching, site reading, selector stability, preview context, navigation, style extraction, generation prompts, assembly, validation and checkpoints. Use those boundaries when extending it; avoid putting browser delivery logic into a research job.
External page text and documents are data. Generated claims must remain grounded in sources; generated persona hypotheses are not verified facts about real visitors. Review typography, responsive behavior, links, preserved native controls and factual claims on the actual site.
Jobs and recovery
Active job execution and cancellation controllers live in the process. Saved run state/checkpoints live with durable records. Optimistic checks protect edits made while work is underway. The current startup path callsresumeInterruptedSetups(); recovery depends on the saved phase/checkpoint and must be inspected, not assumed complete after a restart.
The service can start in standby for a controlled handoff. Background activation is a separate operation from accepting HTTP traffic. Do not run multiple active setup/catalog owners against the same workspaces.
Regeneration can replace draft work and incur authoring-model usage. Retry/cancel/regenerate are different operations; use the returned run state and preserve human edits. A preview-only demo stays unpublished even if setup reports ready.