siteplane 0.1.40 → 0.1.42

package/README.md

@@ -3,6 +3,31 @@
 Public Siteplane CLI for connected-site setup, field synchronization, Analytics
 instrumentation and Booking integration.
 
+## Initial setup
+
+Copy the setup prompt in Siteplane, then run its exact one-time command in the
+website repository:
+
+```bash
+npx -y siteplane@0.1.42 init --setup-token <one-time-setup-grant>
+npx siteplane setup context
+```
+
+`init` exchanges the short-lived grant for the run-bound Project Connection and
+stores it only in the ignored `.siteplane/credentials.json`. No browser approval
+is required. The same connection resumes the open setup and review corrections
+until the owner completes or revokes the setup.
+
+`setup context` returns the single `siteplane.setup-task.v2` task: exact packages, current run,
+authorized modules/scopes, separate unchanged user instructions, environment provenance and one next action.
+An initial instruction such as `Only prices` does not start a correction workflow. The agent integrates
+Siteplane's existing CMS editing layer, preserving the website; it does not build a separate CMS.
+
+Report observed work with `siteplane setup activity --phase inspecting` (also integrating, deploying,
+verifying or repairing). Reports are limited to one per 30 seconds; context polling is not activity.
+Optional Analytics preparation uses this same connection with explicit authorization. It grants no
+activation, import, reporting, booking or publishing rights. Standalone bootstrap cannot replace an open task.
+
 ## Approved fields
 
 Run the exact command from Siteplane's compact apply prompt. It authenticates