siteplane 0.1.41 → 0.1.43

package/dist/next.js

@@ -1,8 +1,9 @@
 // src/next.ts
-import { execFile as execFile3 } from "child_process";
-import { readFile as readFile8 } from "fs/promises";
-import { resolve } from "path";
-import { promisify as promisify3 } from "util";
+import { execFile as execFile4 } from "child_process";
+import { createHash as createHash5 } from "crypto";
+import { readFile as readFile13 } from "fs/promises";
+import { dirname as dirname9, join as join12, resolve as resolve4 } from "path";
+import { promisify as promisify4 } from "util";
 
 // ../cli/dist/analytics/manifest.js
 import { mkdir, readFile, writeFile } from "fs/promises";
@@ -822,7 +823,7 @@ var bookingManifestSchema = z8.object({
 var BOOKING_CREATE_PAYLOAD_LIMIT_BYTES = 16 * 1024;
 
 // ../shared/dist/bridge-protocol.js
-import { z as z15 } from "zod";
+import { z as z16 } from "zod";
 
 // ../shared/dist/field-id.js
 import { z as z9 } from "zod";
@@ -869,21 +870,70 @@ var imageValueSchema = z11.object({
   ]).optional()
 });
 
+// ../shared/dist/setup-deployment.js
+import { z as z12 } from "zod";
+var version = z12.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u);
+var hash = z12.string().regex(/^sha256:[0-9a-f]{64}$/u);
+var setupDeploymentRecordSchema = z12.object({
+  version: z12.literal(1),
+  operationId: z12.string().uuid(),
+  provider: z12.literal("vercel"),
+  projectId: z12.string().regex(/^prj_[A-Za-z0-9]+$/u),
+  teamId: z12.string().regex(/^(?:team|user)_[A-Za-z0-9]+$/u),
+  origin: z12.string().url().refine((value) => {
+    const url = new URL(value);
+    return url.protocol === "https:" && url.origin === value && !url.username && !url.password;
+  }),
+  deploymentId: z12.string().regex(/^dpl_[A-Za-z0-9]+$/u).nullable(),
+  revision: z12.string().regex(/^[0-9a-f]{40}$/u),
+  fieldContractHash: hash,
+  packages: z12.object({ siteplane: version, runtimeNext: version }).strict(),
+  configurationFingerprint: hash,
+  adminSecretGeneration: z12.string().uuid(),
+  revalidationGeneration: z12.number().int().positive(),
+  startedAt: z12.string().datetime(),
+  environmentWrittenAt: z12.string().datetime().nullable(),
+  deployRequestedAt: z12.string().datetime().nullable(),
+  deadline: z12.string().datetime(),
+  phase: z12.enum([
+    "planned",
+    "environment_written",
+    "deploy_requested",
+    "deployed",
+    "verified",
+    "failed"
+  ]),
+  build: z12.object({
+    node: version,
+    packageManager: z12.enum(["npm", "pnpm"]),
+    packageManagerVersion: version,
+    lockfileHash: hash
+  }).strict().nullable()
+}).strict();
+var setupDeploymentInputSchema = z12.discriminatedUnion("action", [
+  z12.object({ action: z12.literal("read") }).strict(),
+  z12.object({
+    action: z12.literal("record"),
+    expectedOperationId: z12.string().uuid().nullable(),
+    record: setupDeploymentRecordSchema
+  }).strict()
+]);
+
 // ../shared/dist/site-setup.js
-import { z as z14 } from "zod";
+import { z as z15 } from "zod";
 
 // ../shared/dist/site-field-contract.js
-import { z as z13 } from "zod";
+import { z as z14 } from "zod";
 
 // ../shared/dist/fallback-hash.js
-import { z as z12 } from "zod";
+import { z as z13 } from "zod";
 var SAFE_REPRESENTATION_REASONS = [
   "asset_import_rewritten",
   "relative_url_normalized",
   "line_endings_normalized",
   "image_value_serialized"
 ];
-var safeRepresentationReasonSchema = z12.enum(SAFE_REPRESENTATION_REASONS);
+var safeRepresentationReasonSchema = z13.enum(SAFE_REPRESENTATION_REASONS);
 function canonicalizeFallbackValue(input) {
   const fieldType = fieldTypeSchema.parse(input.fieldType);
   if (input.safeRepresentationReason !== void 0) {
@@ -919,10 +969,10 @@ function createCanonicalFallbackHash(input) {
   const payload = stableJsonStringify(canonical);
   return `sha256:${sha256Hex(payload)}`;
 }
-var linkFallbackSchema = z12.object({
-  href: z12.string().trim().min(1),
-  label: z12.string().trim().min(1).optional(),
-  target: z12.enum(["_self", "_blank"]).optional()
+var linkFallbackSchema = z13.object({
+  href: z13.string().trim().min(1),
+  label: z13.string().trim().min(1).optional(),
+  target: z13.enum(["_self", "_blank"]).optional()
 }).passthrough();
 function normalizeLineEndings(value) {
   return value.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
@@ -1100,67 +1150,67 @@ var SHA256_CONSTANTS = [
 // ../shared/dist/site-field-contract.js
 var fieldContractVersion = "1.0.0";
 var scannerContractVersion = "1.0.0";
-var siteFieldStatusSchema = z13.enum(["hidden", "active"]);
-var semanticVersionSchema = z13.string().regex(/^\d+\.\d+\.\d+$/u);
-var siteFieldRouteKeySchema = z13.string().trim().refine((value) => value === "$global" || value.startsWith("/") && !value.includes("?") && !value.includes("#") && (value === "/" || !value.endsWith("/")), "Route keys must be canonical paths or $global.");
-var repositoryRelativePosixPathSchema = z13.string().trim().min(1).refine((value) => !value.startsWith("/") && !value.includes("\\") && !/^[a-z]:/iu.test(value) && !value.split("/").includes(".."), "Source paths must be repository-relative POSIX paths.");
-var sourceMappingSchema = z13.object({
-  kind: z13.literal("function"),
+var siteFieldStatusSchema = z14.enum(["hidden", "active"]);
+var semanticVersionSchema = z14.string().regex(/^\d+\.\d+\.\d+$/u);
+var siteFieldRouteKeySchema = z14.string().trim().refine((value) => value === "$global" || value.startsWith("/") && !value.includes("?") && !value.includes("#") && (value === "/" || !value.endsWith("/")), "Route keys must be canonical paths or $global.");
+var repositoryRelativePosixPathSchema = z14.string().trim().min(1).refine((value) => !value.startsWith("/") && !value.includes("\\") && !/^[a-z]:/iu.test(value) && !value.split("/").includes(".."), "Source paths must be repository-relative POSIX paths.");
+var sourceMappingSchema = z14.object({
+  kind: z14.literal("function"),
   filePath: repositoryRelativePosixPathSchema,
-  exportName: z13.string().trim().min(1).optional(),
-  sourcePath: z13.string().trim().min(1).optional(),
+  exportName: z14.string().trim().min(1).optional(),
+  sourcePath: z14.string().trim().min(1).optional(),
   editTarget: fieldIdSchema.optional()
 }).strict();
-var domMappingSchema = z13.object({
-  attribute: z13.literal("data-siteplane-field-id"),
-  previewStrategy: z13.enum(["dom", "event"])
+var domMappingSchema = z14.object({
+  attribute: z14.literal("data-siteplane-field-id"),
+  previewStrategy: z14.enum(["dom", "event"])
 }).strict();
-var fieldBaseSchema = z13.object({
+var fieldBaseSchema = z14.object({
   fieldId: fieldIdSchema,
   routeKey: siteFieldRouteKeySchema,
   source: sourceMappingSchema,
   dom: domMappingSchema.optional()
 }).strict();
-var linkFallbackSchema2 = z13.object({
-  href: z13.string().trim().min(1),
-  label: z13.string().trim().min(1).optional(),
-  target: z13.enum(["_self", "_blank"]).optional()
+var linkFallbackSchema2 = z14.object({
+  href: z14.string().trim().min(1),
+  label: z14.string().trim().min(1).optional(),
+  target: z14.enum(["_self", "_blank"]).optional()
 }).strict();
-var imageFallbackSchema = z13.object({
-  src: z13.string().trim().min(1),
-  alt: z13.string().trim().max(300),
-  width: z13.number().int().positive().optional(),
-  height: z13.number().int().positive().optional(),
-  crop: z13.object({
-    x: z13.number().min(0).max(100),
-    y: z13.number().min(0).max(100),
-    zoom: z13.number().min(1).max(4),
-    aspectRatio: z13.number().positive().max(10)
+var imageFallbackSchema = z14.object({
+  src: z14.string().trim().min(1),
+  alt: z14.string().trim().max(300),
+  width: z14.number().int().positive().optional(),
+  height: z14.number().int().positive().optional(),
+  crop: z14.object({
+    x: z14.number().min(0).max(100),
+    y: z14.number().min(0).max(100),
+    zoom: z14.number().min(1).max(4),
+    aspectRatio: z14.number().positive().max(10)
   }).strict().optional()
 }).strict();
-var siteFieldContractFieldSchema = z13.discriminatedUnion("fieldType", [
+var siteFieldContractFieldSchema = z14.discriminatedUnion("fieldType", [
   fieldBaseSchema.extend({
-    fieldType: z13.literal("text"),
-    fallback: z13.string()
+    fieldType: z14.literal("text"),
+    fallback: z14.string()
   }),
   fieldBaseSchema.extend({
-    fieldType: z13.literal("longText"),
-    fallback: z13.string()
+    fieldType: z14.literal("longText"),
+    fallback: z14.string()
   }),
   fieldBaseSchema.extend({
-    fieldType: z13.literal("link"),
+    fieldType: z14.literal("link"),
     fallback: linkFallbackSchema2
   }),
   fieldBaseSchema.extend({
-    fieldType: z13.literal("image"),
+    fieldType: z14.literal("image"),
     fallback: imageFallbackSchema
   })
 ]);
-var siteFieldContractV1Schema = z13.object({
-  version: z13.literal(1),
+var siteFieldContractV1Schema = z14.object({
+  version: z14.literal(1),
   fieldContractVersion: semanticVersionSchema,
   scannerContractVersion: semanticVersionSchema,
-  fields: z13.array(siteFieldContractFieldSchema)
+  fields: z14.array(siteFieldContractFieldSchema)
 }).strict().superRefine((contract, context) => {
   const seen = /* @__PURE__ */ new Set();
   for (const [index, field] of contract.fields.entries()) {
@@ -1220,55 +1270,20 @@ var SITE_SETUP_OWNER_EDITABILITY_NOTE_MAX_LENGTH = 2e3;
 var SITE_SETUP_OWNER_EDITABILITY_NOTE_MAX_BYTES = 8e3;
 var CONTINUE_SITE_SETUP_ITEMS_MAX_BYTES = 32 * 1024;
 var CONTINUE_SITE_SETUP_HTTP_BODY_MAX_BYTES = 64 * 1024;
-var siteSetupRunStatusSchema = z14.enum(SITE_SETUP_RUN_STATUSES);
-var siteSetupRunModeSchema = z14.enum(SITE_SETUP_RUN_MODES);
-var siteSetupErrorCodeSchema = z14.enum(SITE_SETUP_ERROR_CODES);
-var siteSetupTaskSchema = z14.object({
-  contractVersion: z14.literal("siteplane.setup-task.v1"),
-  workflow: z14.enum(["initial_setup", "structure_update"]),
-  goal: z14.string().min(1),
-  modules: z14.tuple([z14.literal("visual_editor")]),
-  packages: z14.object({
-    siteplane: z14.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u),
-    runtimeNext: z14.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u)
-  }).strict(),
-  communication: z14.object({
-    beforeSourceChanges: z14.string().min(1),
-    updates: z14.array(z14.string().min(1)).min(1),
-    blocker: z14.string().min(1)
-  }).strict(),
-  discovery: z14.object({
-    inspectPublicRoutes: z14.boolean(),
-    contentKinds: z14.array(z14.enum(["text", "longText", "link", "image"])).min(1),
-    rules: z14.array(z14.string().min(1)).min(1)
-  }).strict(),
-  steps: z14.array(z14.object({
-    id: z14.enum([
-      "inspect_repository",
-      "install_packages",
-      "instrument_fields",
-      "apply_contract",
-      "deploy_production",
-      "verify_deployment"
-    ]),
-    instruction: z14.string().min(1)
-  }).strict()).length(6),
-  completion: z14.object({
-    verifiedStatus: z14.literal("ready_for_review"),
-    instruction: z14.string().min(1)
-  }).strict()
-}).strict();
-var editorFieldSchema = z14.object({
+var siteSetupRunStatusSchema = z15.enum(SITE_SETUP_RUN_STATUSES);
+var siteSetupRunModeSchema = z15.enum(SITE_SETUP_RUN_MODES);
+var siteSetupErrorCodeSchema = z15.enum(SITE_SETUP_ERROR_CODES);
+var editorFieldSchema = z15.object({
   fieldId: fieldIdSchema,
-  label: z14.string().trim().min(1),
-  subsection: z14.string().trim().min(1).optional(),
-  description: z14.string().trim().min(1).optional(),
-  required: z14.boolean().optional(),
-  maxLength: z14.number().int().positive().optional()
+  label: z15.string().trim().min(1),
+  subsection: z15.string().trim().min(1).optional(),
+  description: z15.string().trim().min(1).optional(),
+  required: z15.boolean().optional(),
+  maxLength: z15.number().int().positive().optional()
 }).strict();
-var editorSectionSchema = z14.object({
-  label: z14.string().trim().min(1),
-  fields: z14.array(editorFieldSchema).min(1)
+var editorSectionSchema = z15.object({
+  label: z15.string().trim().min(1),
+  fields: z15.array(editorFieldSchema).min(1)
 }).strict().superRefine((section, context) => {
   const closedSubsections = /* @__PURE__ */ new Set();
   let currentSubsection;
@@ -1287,10 +1302,10 @@ var editorSectionSchema = z14.object({
     }
   }
 });
-var editorRouteSchema = z14.object({
+var editorRouteSchema = z15.object({
   routeKey: siteFieldRouteKeySchema,
-  label: z14.string().trim().min(1),
-  sections: z14.array(editorSectionSchema).min(1)
+  label: z15.string().trim().min(1),
+  sections: z15.array(editorSectionSchema).min(1)
 }).strict().superRefine((route, context) => {
   const sections = /* @__PURE__ */ new Set();
   for (const [index, section] of route.sections.entries()) {
@@ -1304,9 +1319,9 @@ var editorRouteSchema = z14.object({
     sections.add(section.label);
   }
 });
-var editorDefinitionV1Schema = z14.object({
-  version: z14.literal(1),
-  routes: z14.array(editorRouteSchema).min(1)
+var editorDefinitionV1Schema = z15.object({
+  version: z15.literal(1),
+  routes: z15.array(editorRouteSchema).min(1)
 }).strict().superRefine((definition, context) => {
   const routes = /* @__PURE__ */ new Set();
   const fields = /* @__PURE__ */ new Set();
@@ -1344,7 +1359,7 @@ var editorDefinitionV1Schema = z14.object({
 var forbiddenControlOrBidi = /[\u0000-\u001f\u007f-\u009f\u202a-\u202e\u2066-\u2069]/u;
 var forbiddenOwnerNoteControlOrBidi = /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f-\u009f\u202a-\u202e\u2066-\u2069]/u;
 var unsafeLocator = /<\/?[a-z][^>]*>|\b(?:javascript|data:text\/html)\s*:|\bon[a-z]+\s*=/iu;
-var renderedPathSchema = z14.string().trim().transform((value) => value !== "/" ? value.replace(/\/+$/u, "") : value).superRefine((value, context) => {
+var renderedPathSchema = z15.string().trim().transform((value) => value !== "/" ? value.replace(/\/+$/u, "") : value).superRefine((value, context) => {
   if (!value.startsWith("/") || value === "$global" || value.includes("?") || value.includes("#")) {
     context.addIssue({
       code: "custom",
@@ -1354,7 +1369,7 @@ var renderedPathSchema = z14.string().trim().transform((value) => value !== "/"
   addSafeByteIssues(value, CONTINUE_SITE_SETUP_RENDERED_PATH_MAX_BYTES, "renderedPath", context);
 });
 function normalizedSafeTextSchema(maxBytes, label) {
-  return z14.string().transform((value) => value.trim().replace(new RegExp("\\p{White_Space}+", "gu"), " ")).pipe(z14.string().min(1)).superRefine((value, context) => {
+  return z15.string().transform((value) => value.trim().replace(new RegExp("\\p{White_Space}+", "gu"), " ")).pipe(z15.string().min(1)).superRefine((value, context) => {
     addSafeByteIssues(value, maxBytes, label, context);
     if (label === "locatorHint" && unsafeLocator.test(value)) {
       context.addIssue({
@@ -1371,12 +1386,12 @@ var correctionItemBase = {
   requestedLabel: normalizedSafeTextSchema(CONTINUE_SITE_SETUP_REQUESTED_LABEL_MAX_BYTES, "requestedLabel").optional(),
   requestedSection: normalizedSafeTextSchema(CONTINUE_SITE_SETUP_REQUESTED_SECTION_MAX_BYTES, "requestedSection").optional(),
   requestedSubsection: normalizedSafeTextSchema(CONTINUE_SITE_SETUP_REQUESTED_SUBSECTION_MAX_BYTES, "requestedSubsection").optional(),
-  requestedSortOrder: z14.number().int().nonnegative().optional()
+  requestedSortOrder: z15.number().int().nonnegative().optional()
 };
-var setupCorrectionItemSchema = z14.discriminatedUnion("kind", [
-  z14.object({ kind: z14.literal("text"), ...correctionItemBase }).strict(),
-  z14.object({ kind: z14.literal("link"), ...correctionItemBase }).strict(),
-  z14.object({ kind: z14.literal("image"), ...correctionItemBase }).strict()
+var setupCorrectionItemSchema = z15.discriminatedUnion("kind", [
+  z15.object({ kind: z15.literal("text"), ...correctionItemBase }).strict(),
+  z15.object({ kind: z15.literal("link"), ...correctionItemBase }).strict(),
+  z15.object({ kind: z15.literal("image"), ...correctionItemBase }).strict()
 ]).superRefine((item, context) => {
   if (item.requestedSubsection && !item.requestedSection) {
     context.addIssue({
@@ -1386,7 +1401,7 @@ var setupCorrectionItemSchema = z14.discriminatedUnion("kind", [
     });
   }
 });
-var setupCorrectionItemsSchema = z14.array(setupCorrectionItemSchema).max(CONTINUE_SITE_SETUP_MAX_ITEMS).superRefine((items, context) => {
+var setupCorrectionItemsSchema = z15.array(setupCorrectionItemSchema).max(CONTINUE_SITE_SETUP_MAX_ITEMS).superRefine((items, context) => {
   const bytes = utf8Bytes(stableJsonStringify(items));
   if (bytes > CONTINUE_SITE_SETUP_ITEMS_MAX_BYTES) {
     context.addIssue({
@@ -1395,7 +1410,7 @@ var setupCorrectionItemsSchema = z14.array(setupCorrectionItemSchema).max(CONTIN
     });
   }
 });
-var siteSetupOwnerEditabilityNoteSchema = z14.string().trim().max(SITE_SETUP_OWNER_EDITABILITY_NOTE_MAX_LENGTH).superRefine((value, context) => {
+var siteSetupOwnerEditabilityNoteSchema = z15.string().max(SITE_SETUP_OWNER_EDITABILITY_NOTE_MAX_LENGTH).superRefine((value, context) => {
   if (utf8Bytes(value) > SITE_SETUP_OWNER_EDITABILITY_NOTE_MAX_BYTES) {
     context.addIssue({
       code: "custom",
@@ -1409,27 +1424,190 @@ var siteSetupOwnerEditabilityNoteSchema = z14.string().trim().max(SITE_SETUP_OWN
     });
   }
 });
-var canonicalHashSchema = z14.string().regex(/^sha256:[0-9a-f]{64}$/iu);
+var SITE_SETUP_MODULE_SCOPES = {
+  editing: ["setup:read", "setup:write"],
+  analytics: [
+    "analytics:setup",
+    "analytics:sync",
+    "analytics:test",
+    "analytics:readiness",
+    "analytics:agent_instructions",
+    "analytics:public_key_read"
+  ]
+};
+var siteSetupModulesSchema = z15.array(z15.enum(["editing", "analytics"])).min(1).max(2).refine((modules) => modules[0] === "editing" && (modules.length === 1 || modules[1] === "analytics"), "Choose Editing with optional Analytics.");
+function siteSetupScopes(modules) {
+  return modules.flatMap((module) => [...SITE_SETUP_MODULE_SCOPES[module]]);
+}
+function hasExactSiteSetupScopes(scopes, modules) {
+  const matches = (expected) => scopes.length === expected.length && expected.every((scope) => scopes.includes(scope));
+  return modules ? matches(siteSetupScopes(modules)) : matches(siteSetupScopes(["editing"])) || matches(siteSetupScopes(["editing", "analytics"]));
+}
+var siteSetupActivityInputSchema = z15.object({
+  phase: z15.enum([
+    "inspecting",
+    "integrating",
+    "deploying",
+    "verifying",
+    "repairing"
+  ]),
+  textId: z15.enum([
+    "inspecting",
+    "integrating",
+    "deploying",
+    "verifying",
+    "repairing"
+  ])
+}).strict().refine((value) => value.phase === value.textId, "Activity text must describe its phase.");
+var nextActionFields = {
+  actor: z15.enum(["agent", "user", "siteplane"]),
+  boundary: z15.enum([
+    "source",
+    "environment",
+    "deployment",
+    "verification",
+    "authorization",
+    "review"
+  ]),
+  precondition: z15.string().min(1).max(1e3),
+  instruction: z15.string().min(1).max(2e3),
+  expectedEvidence: z15.string().min(1).max(1e3)
+};
+var siteSetupNextActionSchema = z15.discriminatedUnion("kind", [
+  z15.object({
+    ...nextActionFields,
+    kind: z15.literal("run_command"),
+    command: z15.string().min(1).max(500)
+  }).strict(),
+  z15.object({ ...nextActionFields, kind: z15.literal("agent_edit") }).strict(),
+  z15.object({ ...nextActionFields, kind: z15.literal("needs_user_action") }).strict(),
+  z15.object({ ...nextActionFields, kind: z15.literal("wait") }).strict(),
+  z15.object({ ...nextActionFields, kind: z15.literal("done") }).strict()
+]);
+var siteSetupTaskRunSchema = z15.object({
+  runId: z15.string().uuid(),
+  mode: siteSetupRunModeSchema,
+  status: siteSetupRunStatusSchema,
+  fieldContractHash: z15.string().nullable(),
+  deploymentOrigin: z15.string().url().nullable(),
+  deploymentRevision: z15.string().nullable(),
+  publicRuntimeKeyId: z15.string().uuid().nullable(),
+  reviewVersion: z15.string().nullable()
+}).strict();
+var siteSetupTaskProgressSchema = z15.object({
+  progressStage: z15.enum([
+    "waiting_for_connection",
+    "agent_connected",
+    "project_context_loaded",
+    "fields_prepared",
+    "deployment_verification",
+    "ready_for_review",
+    "action_required",
+    "completed"
+  ]),
+  lastVerifiedAt: z15.string().datetime().nullable(),
+  lastActivityAt: z15.string().datetime(),
+  activitySource: z15.enum(["user", "server", "agent"]),
+  activityPhase: siteSetupActivityInputSchema.shape.phase.nullable(),
+  activityTextId: siteSetupActivityInputSchema.shape.textId.nullable()
+}).strict();
+var siteSetupTaskSchema = z15.object({
+  contractVersion: z15.literal("siteplane.setup-task.v2"),
+  workflow: z15.enum(["initial_setup", "structure_update"]),
+  goal: z15.string().min(1),
+  modules: siteSetupModulesSchema,
+  authorizationVersion: z15.number().int().positive(),
+  authorizedScopes: z15.array(z15.string()).min(2),
+  site: z15.object({
+    siteId: z15.string().uuid(),
+    portalPath: z15.string(),
+    adminOrigin: z15.string().url()
+  }).strict().nullable(),
+  run: siteSetupTaskRunSchema.nullable(),
+  progress: siteSetupTaskProgressSchema.nullable(),
+  deployment: setupDeploymentRecordSchema.nullable(),
+  revalidationGeneration: z15.number().int().positive(),
+  assignment: z15.literal("owned"),
+  deadline: z15.string().datetime().nullable(),
+  userInstructions: z15.object({
+    text: siteSetupOwnerEditabilityNoteSchema,
+    source: z15.literal("user"),
+    trust: z15.literal("untrusted")
+  }).strict(),
+  corrections: setupCorrectionItemsSchema,
+  contentSelectionSummary: z15.object({
+    text: siteSetupOwnerEditabilityNoteSchema,
+    source: z15.literal("agent"),
+    trust: z15.literal("untrusted")
+  }).strict().nullable(),
+  environmentBindings: z15.array(z15.object({
+    name: z15.string().regex(/^[A-Z][A-Z0-9_]+$/u),
+    source: z15.string().min(1),
+    sensitivity: z15.enum(["public", "secret"]),
+    usage: z15.enum(["build", "server", "build_and_server"]),
+    evidence: z15.string().min(1)
+  }).strict()),
+  nextAction: siteSetupNextActionSchema,
+  error: z15.object({
+    code: z15.string().regex(/^[a-z0-9_.]+$/u).max(160),
+    boundary: nextActionFields.boundary,
+    responsibleActor: nextActionFields.actor,
+    retryable: z15.boolean(),
+    retryAfter: z15.number().int().nonnegative().nullable(),
+    requestId: z15.string().regex(/^[A-Za-z0-9_-]+$/u).max(128)
+  }).strict().nullable(),
+  packages: z15.object({
+    siteplane: z15.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u),
+    runtimeNext: z15.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u)
+  }).strict(),
+  communication: z15.object({
+    beforeSourceChanges: z15.string().min(1),
+    updates: z15.array(z15.string().min(1)).min(1),
+    blocker: z15.string().min(1)
+  }).strict(),
+  discovery: z15.object({
+    inspectPublicRoutes: z15.boolean(),
+    contentKinds: z15.array(z15.enum(["text", "longText", "link", "image"])).min(1),
+    rules: z15.array(z15.string().min(1)).min(1)
+  }).strict(),
+  steps: z15.array(z15.object({
+    id: z15.enum([
+      "inspect_repository",
+      "install_packages",
+      "instrument_fields",
+      "apply_contract",
+      "deploy_production",
+      "verify_deployment"
+    ]),
+    instruction: z15.string().min(1)
+  }).strict()).length(6),
+  completion: z15.object({
+    verifiedStatus: z15.literal("ready_for_review"),
+    instruction: z15.string().min(1)
+  }).strict()
+}).strict().refine((task) => hasExactSiteSetupScopes(task.authorizedScopes, task.modules), "Task scopes must exactly match its modules.");
+var canonicalHashSchema = z15.string().regex(/^sha256:[0-9a-f]{64}$/iu);
 var deploymentRevisionSchema = normalizedSafeTextSchema(256, "deploymentRevision");
-var continueSiteSetupInputSchema = z14.object({
-  siteId: z14.string().uuid(),
-  runId: z14.string().uuid(),
+var continueSiteSetupInputSchema = z15.object({
+  siteId: z15.string().uuid(),
+  runId: z15.string().uuid(),
   expectedFieldContractHash: canonicalHashSchema,
   expectedDeploymentRevision: deploymentRevisionSchema,
   correctionItems: setupCorrectionItemsSchema,
   ownerEditabilityNote: siteSetupOwnerEditabilityNoteSchema.optional()
 }).strict();
-var saveSiteSetupOwnerNoteInputSchema = z14.object({
-  siteId: z14.string().uuid(),
-  runId: z14.string().uuid(),
+var saveSiteSetupOwnerNoteInputSchema = z15.object({
+  siteId: z15.string().uuid(),
+  runId: z15.string().uuid(),
   expectedFieldContractHash: canonicalHashSchema,
   expectedDeploymentRevision: deploymentRevisionSchema,
   ownerEditabilityNote: siteSetupOwnerEditabilityNoteSchema
 }).strict();
-var siteSetupContextInputSchema = z14.object({}).strict();
-var siteSetupApplyInputSchema = z14.object({
+var siteSetupContextInputSchema = z15.object({}).strict();
+var siteSetupApplyInputSchema = z15.object({
   fieldContract: siteFieldContractV1Schema,
-  editorDefinition: editorDefinitionV1Schema
+  editorDefinition: editorDefinitionV1Schema,
+  contentSelectionSummary: siteSetupOwnerEditabilityNoteSchema.refine((text) => text.trim().length > 0, "Describe the selected content, important exclusions and any open gaps.")
 }).strict().superRefine((input, context) => {
   const contractRoutesByFieldId = new Map(input.fieldContract.fields.map((field) => [
     field.fieldId,
@@ -1493,37 +1671,37 @@ var siteSetupApplyInputSchema = z14.object({
     }
   }
 });
-var siteSetupVerifyInputSchema = z14.object({
-  deploymentUrl: z14.string().url().refine((value) => value.startsWith("https://")),
+var siteSetupVerifyInputSchema = z15.object({
+  deploymentUrl: z15.string().url().refine((value) => value.startsWith("https://")),
   deploymentRevision: deploymentRevisionSchema,
-  wait: z14.boolean().optional()
+  wait: z15.boolean().optional()
 }).strict();
-var siteSetupEvidenceInputSchema = z14.object({
-  siteId: z14.string().uuid(),
-  runId: z14.string().uuid(),
+var siteSetupEvidenceInputSchema = z15.object({
+  siteId: z15.string().uuid(),
+  runId: z15.string().uuid(),
   expectedFieldContractHash: canonicalHashSchema,
-  expectedDeploymentOrigin: z14.string().url().refine((value) => value.startsWith("https://")),
+  expectedDeploymentOrigin: z15.string().url().refine((value) => value.startsWith("https://")),
   expectedDeploymentRevision: deploymentRevisionSchema,
-  publicRuntimeKeyId: z14.string().uuid(),
+  publicRuntimeKeyId: z15.string().uuid(),
   bridgeSessionId: normalizedSafeTextSchema(256, "bridgeSessionId"),
-  observations: z14.array(z14.object({
+  observations: z15.array(z15.object({
     fieldId: fieldIdSchema,
     routeKey: siteFieldRouteKeySchema,
     renderedPath: renderedPathSchema,
-    targetResolved: z14.boolean(),
-    previewAck: z14.boolean()
+    targetResolved: z15.boolean(),
+    previewAck: z15.boolean()
   }).strict().refine((value) => !value.previewAck || value.targetResolved, "Preview ACK requires a resolved target.")).min(1).max(200)
 }).strict();
-var completeSiteSetupInputSchema = z14.object({
-  siteId: z14.string().uuid(),
-  runId: z14.string().uuid(),
+var completeSiteSetupInputSchema = z15.object({
+  siteId: z15.string().uuid(),
+  runId: z15.string().uuid(),
   expectedFieldContractHash: canonicalHashSchema,
   expectedDeploymentRevision: deploymentRevisionSchema,
   expectedReadyFingerprint: canonicalHashSchema
 }).strict();
-var refreshSiteSetupDeploymentInputSchema = z14.object({
-  siteId: z14.string().uuid(),
-  deploymentUrl: z14.string().url().refine((value) => value.startsWith("https://")),
+var refreshSiteSetupDeploymentInputSchema = z15.object({
+  siteId: z15.string().uuid(),
+  deploymentUrl: z15.string().url().refine((value) => value.startsWith("https://")),
   deploymentRevision: deploymentRevisionSchema
 }).strict();
 function addSafeByteIssues(value, maxBytes, label, context) {
@@ -1546,34 +1724,34 @@ function utf8Bytes(value) {
 
 // ../shared/dist/bridge-protocol.js
 var BRIDGE_PROTOCOL_VERSION = 2;
-var bridgeRectSchema = z15.object({
-  x: z15.number(),
-  y: z15.number(),
-  width: z15.number().nonnegative(),
-  height: z15.number().nonnegative()
+var bridgeRectSchema = z16.object({
+  x: z16.number(),
+  y: z16.number(),
+  width: z16.number().nonnegative(),
+  height: z16.number().nonnegative()
 });
-var previewTextValueSchema = z15.object({
-  fieldType: z15.enum(["text", "longText"]),
-  value: z15.string()
+var previewTextValueSchema = z16.object({
+  fieldType: z16.enum(["text", "longText"]),
+  value: z16.string()
 });
-var previewLinkValueSchema = z15.object({
-  fieldType: z15.literal("link"),
-  value: z15.object({
-    href: z15.string().trim().min(1),
-    label: z15.string().trim().min(1).optional()
+var previewLinkValueSchema = z16.object({
+  fieldType: z16.literal("link"),
+  value: z16.object({
+    href: z16.string().trim().min(1),
+    label: z16.string().trim().min(1).optional()
   })
 });
-var previewImageValueSchema = z15.object({
-  fieldType: z15.literal("image"),
+var previewImageValueSchema = z16.object({
+  fieldType: z16.literal("image"),
   value: imageValueSchema
 });
-var bridgePreviewValueSchema = z15.discriminatedUnion("fieldType", [
+var bridgePreviewValueSchema = z16.discriminatedUnion("fieldType", [
   previewTextValueSchema,
   previewLinkValueSchema,
   previewImageValueSchema
 ]);
-var fieldSelectionModeSchema = z15.enum(["replace", "range", "toggle"]);
-var fieldBridgeMissingContentActionSchema = z15.enum([
+var fieldSelectionModeSchema = z16.enum(["replace", "range", "toggle"]);
+var fieldBridgeMissingContentActionSchema = z16.enum([
   "add",
   "select",
   "remove"
@@ -1592,77 +1770,77 @@ var FIELD_BRIDGE_MESSAGE_TYPES = [
   "siteplane:field-bridge:preview-scrolled",
   "siteplane:field-bridge:error"
 ];
-var canonicalFieldContractHashSchema = z15.string().regex(/^sha256:[0-9a-f]{64}$/u);
-var bridgeSectionSchema = z15.string().trim().min(1).max(256);
-var realRenderedPathSchema = z15.string().trim().refine((value) => value.startsWith("/") && value !== "$global" && !value.includes("?") && !value.includes("#"), "A field bridge rendered path must be a real canonical path.");
-var fieldBridgeIdentitySchema = z15.object({
-  publicRuntimeKeyId: z15.string().uuid(),
+var canonicalFieldContractHashSchema = z16.string().regex(/^sha256:[0-9a-f]{64}$/u);
+var bridgeSectionSchema = z16.string().trim().min(1).max(256);
+var realRenderedPathSchema = z16.string().trim().refine((value) => value.startsWith("/") && value !== "$global" && !value.includes("?") && !value.includes("#"), "A field bridge rendered path must be a real canonical path.");
+var fieldBridgeIdentitySchema = z16.object({
+  publicRuntimeKeyId: z16.string().uuid(),
   fieldContractHash: canonicalFieldContractHashSchema,
-  deploymentRevision: z15.string().trim().min(1).max(256)
+  deploymentRevision: z16.string().trim().min(1).max(256)
 }).strict();
-var fieldBridgeBaseSchema = z15.object({
-  version: z15.literal(BRIDGE_PROTOCOL_VERSION),
-  type: z15.enum(FIELD_BRIDGE_MESSAGE_TYPES),
-  siteId: z15.string().uuid(),
-  sessionId: z15.string().trim().min(1),
-  publicRuntimeKeyId: z15.string().uuid(),
+var fieldBridgeBaseSchema = z16.object({
+  version: z16.literal(BRIDGE_PROTOCOL_VERSION),
+  type: z16.enum(FIELD_BRIDGE_MESSAGE_TYPES),
+  siteId: z16.string().uuid(),
+  sessionId: z16.string().trim().min(1),
+  publicRuntimeKeyId: z16.string().uuid(),
   fieldContractHash: canonicalFieldContractHashSchema,
-  deploymentRevision: z15.string().trim().min(1).max(256),
-  requestId: z15.string().trim().min(1),
-  sentAt: z15.string().datetime()
+  deploymentRevision: z16.string().trim().min(1).max(256),
+  requestId: z16.string().trim().min(1),
+  sentAt: z16.string().datetime()
 }).strict();
-var fieldBridgeFieldSchema = z15.object({
+var fieldBridgeFieldSchema = z16.object({
   fieldId: fieldIdSchema,
   fieldType: fieldTypeSchema,
   routeKey: siteFieldRouteKeySchema,
   renderedPath: realRenderedPathSchema,
-  sourcePath: z15.string().trim().min(1).optional(),
+  sourcePath: z16.string().trim().min(1).optional(),
   editTarget: fieldIdSchema,
   rect: bridgeRectSchema,
-  targetResolved: z15.literal(true),
+  targetResolved: z16.literal(true),
   currentValue: bridgePreviewValueSchema.optional()
 }).strict();
 var fieldBridgeInitMessageSchema = fieldBridgeBaseSchema.extend({
-  type: z15.literal("siteplane:field-bridge:init"),
-  payload: z15.object({
-    adminOrigin: z15.string().url(),
-    customerOrigin: z15.string().url(),
+  type: z16.literal("siteplane:field-bridge:init"),
+  payload: z16.object({
+    adminOrigin: z16.string().url(),
+    customerOrigin: z16.string().url(),
     renderedPath: realRenderedPathSchema
   }).strict()
 });
 var fieldBridgeReadyMessageSchema = fieldBridgeBaseSchema.extend({
-  type: z15.literal("siteplane:field-bridge:ready"),
-  payload: z15.object({
+  type: z16.literal("siteplane:field-bridge:ready"),
+  payload: z16.object({
     renderedPath: realRenderedPathSchema,
-    fieldCount: z15.number().int().nonnegative(),
-    capabilities: z15.tuple([
-      z15.literal("field_selection"),
-      z15.literal("preview_values"),
-      z15.literal("field_evidence"),
-      z15.literal("visual_field_control")
+    fieldCount: z16.number().int().nonnegative(),
+    capabilities: z16.tuple([
+      z16.literal("field_selection"),
+      z16.literal("preview_values"),
+      z16.literal("field_evidence"),
+      z16.literal("visual_field_control")
     ])
   }).strict()
 });
 var fieldBridgeFieldsMessageSchema = fieldBridgeBaseSchema.extend({
-  type: z15.literal("siteplane:field-bridge:fields"),
-  payload: z15.object({
+  type: z16.literal("siteplane:field-bridge:fields"),
+  payload: z16.object({
     renderedPath: realRenderedPathSchema,
-    fields: z15.array(fieldBridgeFieldSchema)
+    fields: z16.array(fieldBridgeFieldSchema)
   }).strict()
 });
 var fieldBridgeSelectFieldMessageSchema = fieldBridgeBaseSchema.extend({
-  type: z15.literal("siteplane:field-bridge:select-field"),
-  payload: z15.object({
+  type: z16.literal("siteplane:field-bridge:select-field"),
+  payload: z16.object({
     fieldId: fieldIdSchema,
     selectionMode: fieldSelectionModeSchema
   }).strict()
 });
 var fieldBridgeSetSelectedFieldMessageSchema = fieldBridgeBaseSchema.extend({
-  type: z15.literal("siteplane:field-bridge:set-selected-field"),
-  payload: z15.object({
-    fieldIds: z15.array(fieldIdSchema).max(200),
+  type: z16.literal("siteplane:field-bridge:set-selected-field"),
+  payload: z16.object({
+    fieldIds: z16.array(fieldIdSchema).max(200),
     primaryFieldId: fieldIdSchema.nullable(),
-    scrollIntoView: z15.boolean().optional()
+    scrollIntoView: z16.boolean().optional()
   }).strict().superRefine((value, context) => {
     if (value.fieldIds.length > 0 && value.primaryFieldId === null) {
       context.addIssue({
@@ -1681,58 +1859,58 @@ var fieldBridgeSetSelectedFieldMessageSchema = fieldBridgeBaseSchema.extend({
   })
 });
 var fieldBridgeApplyPreviewValuesMessageSchema = fieldBridgeBaseSchema.extend({
-  type: z15.literal("siteplane:field-bridge:apply-preview-values"),
-  payload: z15.object({ values: z15.record(fieldIdSchema, bridgePreviewValueSchema) }).strict()
+  type: z16.literal("siteplane:field-bridge:apply-preview-values"),
+  payload: z16.object({ values: z16.record(fieldIdSchema, bridgePreviewValueSchema) }).strict()
 });
 var fieldBridgeTestPreviewValuesMessageSchema = fieldBridgeBaseSchema.extend({
-  type: z15.literal("siteplane:field-bridge:test-preview-values"),
-  payload: z15.object({ fieldIds: z15.array(fieldIdSchema).min(1).max(200) }).strict()
+  type: z16.literal("siteplane:field-bridge:test-preview-values"),
+  payload: z16.object({ fieldIds: z16.array(fieldIdSchema).min(1).max(200) }).strict()
 });
 var fieldBridgePreviewAckMessageSchema = fieldBridgeBaseSchema.extend({
-  type: z15.literal("siteplane:field-bridge:preview-ack"),
-  payload: z15.object({
-    ackRequestId: z15.string().trim().min(1),
-    kind: z15.enum(["apply", "test"]),
+  type: z16.literal("siteplane:field-bridge:preview-ack"),
+  payload: z16.object({
+    ackRequestId: z16.string().trim().min(1),
+    kind: z16.enum(["apply", "test"]),
     renderedPath: realRenderedPathSchema,
-    fieldIds: z15.array(fieldIdSchema).max(200)
+    fieldIds: z16.array(fieldIdSchema).max(200)
   }).strict()
 });
 var fieldBridgeSetVisualControlStateMessageSchema = fieldBridgeBaseSchema.extend({
-  type: z15.literal("siteplane:field-bridge:set-visual-control-state"),
-  payload: z15.object({
-    enabled: z15.boolean(),
-    fieldProximityEnabled: z15.boolean(),
-    pendingKeys: z15.array(z15.string().trim().min(1).max(2048)).max(50),
-    activeFieldIds: z15.array(fieldIdSchema),
-    fieldSections: z15.record(fieldIdSchema, bridgeSectionSchema),
-    selectedPending: z15.array(z15.object({
-      key: z15.string().trim().min(1).max(2048),
-      locatorHint: z15.string().trim().min(1).max(2048)
+  type: z16.literal("siteplane:field-bridge:set-visual-control-state"),
+  payload: z16.object({
+    enabled: z16.boolean(),
+    fieldProximityEnabled: z16.boolean(),
+    pendingKeys: z16.array(z16.string().trim().min(1).max(2048)).max(50),
+    activeFieldIds: z16.array(fieldIdSchema),
+    fieldSections: z16.record(fieldIdSchema, bridgeSectionSchema),
+    selectedPending: z16.array(z16.object({
+      key: z16.string().trim().min(1).max(2048),
+      locatorHint: z16.string().trim().min(1).max(2048)
     }).strict()).max(50),
-    scrollPendingIntoView: z15.boolean().optional()
+    scrollPendingIntoView: z16.boolean().optional()
   }).strict()
 });
 var fieldBridgeMissingContentMessageSchema = fieldBridgeBaseSchema.extend({
-  type: z15.literal("siteplane:field-bridge:missing-content"),
-  payload: z15.object({
+  type: z16.literal("siteplane:field-bridge:missing-content"),
+  payload: z16.object({
     action: fieldBridgeMissingContentActionSchema,
     item: setupCorrectionItemSchema,
     suggestedSection: bridgeSectionSchema.optional()
   }).strict()
 });
 var fieldBridgePreviewScrolledMessageSchema = fieldBridgeBaseSchema.extend({
-  type: z15.literal("siteplane:field-bridge:preview-scrolled"),
-  payload: z15.object({ renderedPath: realRenderedPathSchema }).strict()
+  type: z16.literal("siteplane:field-bridge:preview-scrolled"),
+  payload: z16.object({ renderedPath: realRenderedPathSchema }).strict()
 });
 var fieldBridgeErrorMessageSchema = fieldBridgeBaseSchema.extend({
-  type: z15.literal("siteplane:field-bridge:error"),
-  payload: z15.object({
-    code: z15.string().trim().min(1),
-    message: z15.string().trim().min(1),
-    recoverable: z15.boolean().default(false)
+  type: z16.literal("siteplane:field-bridge:error"),
+  payload: z16.object({
+    code: z16.string().trim().min(1),
+    message: z16.string().trim().min(1),
+    recoverable: z16.boolean().default(false)
   }).strict()
 });
-var fieldBridgeMessageSchema = z15.discriminatedUnion("type", [
+var fieldBridgeMessageSchema = z16.discriminatedUnion("type", [
   fieldBridgeInitMessageSchema,
   fieldBridgeReadyMessageSchema,
   fieldBridgeFieldsMessageSchema,
@@ -1748,51 +1926,51 @@ var fieldBridgeMessageSchema = z15.discriminatedUnion("type", [
 ]);
 
 // ../shared/dist/commands.js
-import { z as z17 } from "zod";
+import { z as z18 } from "zod";
 
 // ../shared/dist/errors.js
-import { z as z16 } from "zod";
+import { z as z17 } from "zod";
 var UI_ERROR_CATEGORIES = [
   "site_member",
   "workspace_member",
   "internal"
 ];
-var uiErrorCategorySchema = z16.enum(UI_ERROR_CATEGORIES);
-var commandErrorPayloadSchema = z16.object({
-  code: z16.string().min(1),
-  message: z16.string().min(1),
+var uiErrorCategorySchema = z17.enum(UI_ERROR_CATEGORIES);
+var commandErrorPayloadSchema = z17.object({
+  code: z17.string().min(1),
+  message: z17.string().min(1),
   category: uiErrorCategorySchema,
-  details: z16.record(z16.string(), z16.unknown()).optional()
+  details: z17.record(z17.string(), z17.unknown()).optional()
 });
 
 // ../shared/dist/commands.js
-var commandSuccessSchema = z17.object({
-  ok: z17.literal(true),
-  data: z17.unknown()
+var commandSuccessSchema = z18.object({
+  ok: z18.literal(true),
+  data: z18.unknown()
 });
-var commandErrorSchema = z17.object({
-  ok: z17.literal(false),
+var commandErrorSchema = z18.object({
+  ok: z18.literal(false),
   error: commandErrorPayloadSchema
 });
-var commandResultSchema = z17.discriminatedUnion("ok", [
+var commandResultSchema = z18.discriminatedUnion("ok", [
   commandSuccessSchema,
   commandErrorSchema
 ]);
 
 // ../shared/dist/editor-settings.js
-import { z as z18 } from "zod";
-var editorColorSchemeSchema = z18.enum([
+import { z as z19 } from "zod";
+var editorColorSchemeSchema = z19.enum([
   "paper",
   "slate",
   "siteplane",
   "bloom"
 ]);
 var editorColorSchemes = editorColorSchemeSchema.options;
-var editorColorModeSchema = z18.enum(["light", "dark"]);
+var editorColorModeSchema = z19.enum(["light", "dark"]);
 var editorColorModes = editorColorModeSchema.options;
 
 // ../shared/dist/site-slug.js
-import { z as z19 } from "zod";
+import { z as z20 } from "zod";
 var SITE_SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 var RESERVED_SITE_SLUGS = /* @__PURE__ */ new Set([
   "account",
@@ -1809,31 +1987,31 @@ var RESERVED_SITE_SLUGS = /* @__PURE__ */ new Set([
   "support",
   "workspace"
 ]);
-var siteSlugSchema = z19.string().regex(SITE_SLUG_PATTERN, "Invalid site slug").refine((value) => !RESERVED_SITE_SLUGS.has(value), "Reserved site slug");
+var siteSlugSchema = z20.string().regex(SITE_SLUG_PATTERN, "Invalid site slug").refine((value) => !RESERVED_SITE_SLUGS.has(value), "Reserved site slug");
 
 // ../shared/dist/entitlements.js
-import { z as z20 } from "zod";
-var entitlementSnapshotSchema = z20.object({
-  planKey: z20.string().trim().min(1),
-  sitesLimit: z20.number().int().positive(),
-  siteMembersPerSiteLimit: z20.number().int().positive(),
-  customAdminDomainsEnabled: z20.boolean(),
-  agentMcpEnabled: z20.boolean(),
-  emailNotificationsEnabled: z20.boolean(),
-  analyticsEnabled: z20.boolean(),
-  analyticsSitesLimit: z20.number().int().min(0),
-  analyticsPortalPerformanceEnabled: z20.boolean(),
-  analyticsMonthlyReportsEnabled: z20.boolean(),
-  analyticsAiSummaryEnabled: z20.boolean(),
-  analyticsRawEventRetentionDays: z20.number().int().min(1).max(ANALYTICS_RETENTION_DEFAULTS.maxRawEventRetentionDaysWithoutAdr),
-  analyticsMonthlyEventLimit: z20.number().int().min(0),
-  bookingEnabled: z20.boolean().default(false),
-  bookingSitesLimit: z20.number().int().min(0).default(0),
-  bookingPortalManagementEnabled: z20.boolean().default(false),
-  bookingResourcesPerSiteLimit: z20.number().int().min(0).default(0),
-  bookingServicesPerSiteLimit: z20.number().int().min(0).default(0),
-  bookingMonthlyBookingsLimit: z20.number().int().min(0).default(0),
-  bookingRemindersEnabled: z20.boolean().default(false)
+import { z as z21 } from "zod";
+var entitlementSnapshotSchema = z21.object({
+  planKey: z21.string().trim().min(1),
+  sitesLimit: z21.number().int().positive(),
+  siteMembersPerSiteLimit: z21.number().int().positive(),
+  customAdminDomainsEnabled: z21.boolean(),
+  agentMcpEnabled: z21.boolean(),
+  emailNotificationsEnabled: z21.boolean(),
+  analyticsEnabled: z21.boolean(),
+  analyticsSitesLimit: z21.number().int().min(0),
+  analyticsPortalPerformanceEnabled: z21.boolean(),
+  analyticsMonthlyReportsEnabled: z21.boolean(),
+  analyticsAiSummaryEnabled: z21.boolean(),
+  analyticsRawEventRetentionDays: z21.number().int().min(1).max(ANALYTICS_RETENTION_DEFAULTS.maxRawEventRetentionDaysWithoutAdr),
+  analyticsMonthlyEventLimit: z21.number().int().min(0),
+  bookingEnabled: z21.boolean().default(false),
+  bookingSitesLimit: z21.number().int().min(0).default(0),
+  bookingPortalManagementEnabled: z21.boolean().default(false),
+  bookingResourcesPerSiteLimit: z21.number().int().min(0).default(0),
+  bookingServicesPerSiteLimit: z21.number().int().min(0).default(0),
+  bookingMonthlyBookingsLimit: z21.number().int().min(0).default(0),
+  bookingRemindersEnabled: z21.boolean().default(false)
 });
 var EARLY_ACCESS_PLAN = {
   planKey: "early_access_2026",
@@ -1859,7 +2037,7 @@ var EARLY_ACCESS_PLAN = {
 };
 
 // ../shared/dist/readiness.js
-import { z as z21 } from "zod";
+import { z as z22 } from "zod";
 var READINESS_CHECK_KEYS = [
   "agent_instructions_installed",
   "runtime_package_connected",
@@ -1874,19 +2052,19 @@ var READINESS_STATUSES = [
   "failing",
   "warning"
 ];
-var readinessCheckKeySchema = z21.enum(READINESS_CHECK_KEYS);
-var readinessStatusSchema = z21.enum(READINESS_STATUSES);
+var readinessCheckKeySchema = z22.enum(READINESS_CHECK_KEYS);
+var readinessStatusSchema = z22.enum(READINESS_STATUSES);
 
 // ../shared/dist/site.js
-import { z as z22 } from "zod";
+import { z as z23 } from "zod";
 var SITE_STATUSES = [
   "setup",
   "active",
   "disabled",
   "archived"
 ];
-var siteStatusSchema = z22.enum(SITE_STATUSES);
-var websiteUrlSchema = z22.string().trim().url().refine((value) => value.startsWith("https://") || value.startsWith("http://"), "Website URL must use http or https");
+var siteStatusSchema = z23.enum(SITE_STATUSES);
+var websiteUrlSchema = z23.string().trim().url().refine((value) => value.startsWith("https://") || value.startsWith("http://"), "Website URL must use http or https");
 
 // ../cli/dist/analytics/static-scan.js
 import ts from "typescript";
@@ -1924,16 +2102,16 @@ ${analyticsRulesTemplate}`;
 import { createHash } from "crypto";
 
 // ../cli/dist/commands/analytics/public-key.js
-import { z as z23 } from "zod";
-var responseSchema = z23.object({
-  ok: z23.literal(true),
-  data: z23.object({
-    rawPublicKey: z23.string().regex(/^pk_siteplane_[A-Za-z0-9_-]{16}_[A-Za-z0-9_-]{43}$/)
+import { z as z24 } from "zod";
+var responseSchema = z24.object({
+  ok: z24.literal(true),
+  data: z24.object({
+    rawPublicKey: z24.string().regex(/^pk_siteplane_[A-Za-z0-9_-]{16}_[A-Za-z0-9_-]{43}$/)
   })
 });
-var errorResponseSchema = z23.object({
-  error: z23.object({
-    code: z23.string().regex(/^[a-z][a-z0-9_.-]+$/u)
+var errorResponseSchema = z24.object({
+  error: z24.object({
+    code: z24.string().regex(/^[a-z][a-z0-9_.-]+$/u)
   })
 });
 
@@ -1967,14 +2145,22 @@ ${bookingRulesTemplate}`;
 import { access, chmod, open, readFile as readFile5, rename, rm } from "fs/promises";
 import { randomUUID as randomUUID2 } from "crypto";
 import { join as join3 } from "path";
-import { z as z24 } from "zod";
-var siteplaneProjectConfigSchema = z24.object({
-  version: z24.literal(1),
-  apiBaseUrl: z24.string().url(),
-  siteId: z24.string().uuid(),
-  publicSiteKeyId: z24.string().uuid(),
-  publicSiteKey: z24.string().trim().min(1),
-  fieldContractHash: z24.string().regex(/^sha256:[0-9a-f]{64}$/iu).optional()
+import { z as z25 } from "zod";
+var siteplaneProjectConfigSchema = z25.object({
+  version: z25.literal(2),
+  apiBaseUrl: z25.string().url(),
+  siteId: z25.string().uuid(),
+  publicSiteKeyId: z25.string().uuid(),
+  publicSiteKey: z25.string().trim().min(1),
+  runId: z25.string().uuid(),
+  appDirectory: z25.string().min(1),
+  taskContractVersion: z25.literal("siteplane.setup-task.v2"),
+  adminProtocolVersion: z25.literal(2),
+  packages: z25.object({
+    siteplane: z25.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u),
+    runtimeNext: z25.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u)
+  }).strict(),
+  fieldContractHash: z25.string().regex(/^sha256:[0-9a-f]{64}$/iu).optional()
 }).strict();
 async function readProjectConfig(projectDir) {
   return siteplaneProjectConfigSchema.parse(JSON.parse(await readFile5(join3(projectDir, "siteplane.config.json"), "utf8")));
@@ -1983,45 +2169,545 @@ async function readProjectConfig(projectDir) {
 // ../cli/dist/config/credentials.js
 import { execFile } from "child_process";
 import { randomUUID as randomUUID3 } from "crypto";
-import { chmod as chmod2, mkdir as mkdir5, open as open2, readFile as readFile6, rename as rename2, rm as rm2 } from "fs/promises";
+import { chmod as chmod2, lstat, mkdir as mkdir5, open as open2, readFile as readFile6, rename as rename2, rm as rm2 } from "fs/promises";
 import { dirname as dirname5, join as join4, relative } from "path";
 import { promisify } from "util";
-import { z as z25 } from "zod";
-var siteplaneCredentialsSchema = z25.object({
-  accessToken: z25.string().trim().min(1),
-  siteRevalidationSecret: z25.string().trim().min(1)
+import { z as z26 } from "zod";
+var siteplaneCredentialsSchema = z26.object({
+  accessToken: z26.string().trim().min(1),
+  siteRevalidationSecret: z26.string().trim().min(1),
+  adminSession: z26.object({
+    secret: z26.string().regex(/^[A-Za-z0-9_-]{43}$/u),
+    generation: z26.string().uuid()
+  }).strict().optional()
 }).strict();
+async function assertLocalCredentialsPathSafe(projectDir, options = {}) {
+  const path = join4(projectDir, ".siteplane/credentials.json");
+  await assertCredentialFilesystemSafe(projectDir);
+  const isTrackedFile = options.isTrackedFile ?? ((targetPath) => gitPathMatches(projectDir, targetPath, "ls-files"));
+  const isIgnoredFile = options.isIgnoredFile ?? ((targetPath) => gitPathMatches(projectDir, targetPath, "check-ignore"));
+  if (await isTrackedFile(path)) {
+    throw new Error("Refusing to write Siteplane credentials into a tracked file.");
+  }
+  if (!await isIgnoredFile(path)) {
+    throw new Error("Add .siteplane/credentials.json to .gitignore before running Siteplane init.");
+  }
+  return path;
+}
+async function assertCredentialFilesystemSafe(projectDir) {
+  for (const [path, directory, mode] of [
+    [projectDir, true, null],
+    [join4(projectDir, ".siteplane"), true, 448],
+    [join4(projectDir, ".siteplane/credentials.json"), false, 384]
+  ]) {
+    const stat = await lstat(path).catch((error) => {
+      if (error.code === "ENOENT")
+        return null;
+      throw error;
+    });
+    if (!stat)
+      continue;
+    if (stat.isSymbolicLink() || (directory ? !stat.isDirectory() : !stat.isFile())) {
+      throw new Error("Siteplane credential paths must not contain symlinks or unexpected file types.");
+    }
+    if (mode !== null && (stat.mode & 511) !== mode) {
+      throw new Error(`Siteplane credential ${directory ? "directory" : "file"} permissions must be ${mode.toString(8)} before setup.`);
+    }
+  }
+}
+async function readLocalCredentials(projectDir) {
+  await assertCredentialFilesystemSafe(projectDir);
+  return siteplaneCredentialsSchema.parse(JSON.parse(await readFile6(join4(projectDir, ".siteplane/credentials.json"), "utf8")));
+}
 var execFileAsync = promisify(execFile);
+async function gitPathMatches(projectDir, path, command) {
+  const args = command === "check-ignore" ? ["check-ignore", "--quiet", relative(projectDir, path)] : ["ls-files", "--error-unmatch", relative(projectDir, path)];
+  try {
+    await execFileAsync("git", args, { cwd: projectDir });
+    return true;
+  } catch {
+    return false;
+  }
+}
 
 // ../cli/dist/commands/init.js
+import { access as access3 } from "fs/promises";
+import { join as join7, relative as relative3 } from "path";
+import { z as z29 } from "zod";
+
+// ../cli/dist/commands/setup-preflight.js
+import { createHash as createHash2 } from "crypto";
+import semver from "semver";
+import { minimatch } from "minimatch";
+import { parse as parseYaml } from "yaml";
+
+// ../cli/dist/config/installed-package.js
+import { createRequire } from "module";
+import { readFile as readFile7 } from "fs/promises";
 import { join as join5 } from "path";
-import { z as z26 } from "zod";
-var siteSetupBootstrapDataSchema = z26.object({
-  credentialPurpose: z26.literal("site_setup"),
-  apiBaseUrl: z26.string().url(),
-  siteId: z26.string().uuid(),
-  publicSiteKeyId: z26.string().uuid(),
-  publicSiteKey: z26.string().trim().min(1),
-  accessToken: z26.string().trim().min(1),
-  siteRevalidationSecret: z26.string().regex(/^[A-Za-z0-9_-]{43}$/u)
+import { z as z27 } from "zod";
+var packageSchema = z27.object({
+  name: z27.string().optional(),
+  version: z27.string(),
+  peerDependencies: z27.record(z27.string(), z27.string()).optional()
+});
+async function readInstalledPackage(projectDir, name2) {
+  const require2 = createRequire(join5(projectDir, "package.json"));
+  for (const directory of require2.resolve.paths(name2) ?? []) {
+    try {
+      return packageSchema.parse(JSON.parse(await readFile7(join5(directory, name2, "package.json"), "utf8")));
+    } catch (error) {
+      if (error.code !== "ENOENT")
+        throw error;
+    }
+  }
+  throw new Error(`Install ${name2} with the canonical package manager before setup.`);
+}
+
+// ../cli/dist/commands/setup-preflight.js
+import { access as access2, readFile as readFile8, realpath, readdir, readlink } from "fs/promises";
+import { dirname as dirname6, join as join6, relative as relative2, resolve, sep } from "path";
+import { z as z28 } from "zod";
+
+// ../cli/dist/commands/setup-process.js
+import { spawn } from "child_process";
+var SetupFailure = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+  }
+};
+async function setupProcess(binary, args, options) {
+  return new Promise((resolve5, reject) => {
+    const child = spawn(binary, args, {
+      cwd: options.cwd,
+      env: process.env,
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    const chunks = [];
+    const errors = [];
+    let errorBytes = 0;
+    let bytes = 0;
+    let exceeded = false;
+    const timer = setTimeout(() => {
+      exceeded = true;
+      child.kill("SIGKILL");
+    }, options.timeoutMs ?? 12e4);
+    const capture = (chunk) => {
+      bytes += chunk.length;
+      if (bytes > 4 * 1024 * 1024) {
+        exceeded = true;
+        child.kill("SIGKILL");
+      } else
+        chunks.push(chunk);
+    };
+    child.stdout.on("data", capture);
+    child.stderr.on("data", (chunk) => {
+      errorBytes += chunk.length;
+      if (errorBytes <= 4 * 1024 * 1024)
+        errors.push(chunk);
+      else {
+        exceeded = true;
+        child.kill("SIGKILL");
+      }
+    });
+    child.on("error", () => {
+      clearTimeout(timer);
+      reject(new SetupFailure("local_tool_unavailable", `${binary} could not be started. Check the local installation and access.`));
+    });
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      if (exceeded)
+        reject(new SetupFailure("provider_timeout", "The operation exceeded its time or response limit; inspect the existing operation before retrying."));
+      else if (code !== 0) {
+        const diagnostic = Buffer.concat([...chunks, ...errors]).toString("utf8");
+        if (/\b(?:401|403|unauthorized|forbidden|not authenticated|not authorized|login required|E401|E403)\b/iu.test(diagnostic))
+          reject(new SetupFailure("provider_access_denied", `${binary} denied access. Restore the existing local login and project/package permissions before retrying.`));
+        else if (/\b(?:ECONNRESET|ETIMEDOUT|ENOTFOUND|EAI_AGAIN|ECONNREFUSED|429|502|503|504)\b/iu.test(diagnostic))
+          reject(new SetupFailure("provider_transport_failed", `${binary} could not reach its provider. Inspect the existing operation before retrying.`));
+        else
+          reject(new SetupFailure("local_command_failed", `${binary} failed. Check its local login, permissions and project configuration.`));
+      } else
+        resolve5(Buffer.concat(options.includeStderr ? [...chunks, ...errors] : chunks).toString("utf8"));
+    });
+    child.stdin.on("error", () => {
+    });
+    child.stdin.end(options.input);
+  });
+}
+async function setupVercelApi(cwd, endpoint, body, method, options) {
+  const args = ["api", endpoint, "--raw"];
+  if (body !== void 0)
+    args.push("--method", method ?? "POST", "--input", "-");
+  else if (method)
+    args.push("--method", method);
+  let output = "";
+  for (let attempt = 0; attempt < 3; attempt++) {
+    const remaining = (options?.deadline ?? Date.now() + 3e4) - Date.now();
+    if (remaining <= 0)
+      throw new SetupFailure("provider_deadline_exceeded", "The provider deadline expired; inspect the recorded operation before continuing.");
+    try {
+      output = await setupProcess("vercel", args, {
+        cwd,
+        timeoutMs: Math.min(3e4, remaining),
+        ...body === void 0 ? {} : { input: JSON.stringify(body) }
+      });
+      break;
+    } catch (error) {
+      if (!(error instanceof SetupFailure) || error.code !== "provider_transport_failed" || attempt === 2)
+        throw error;
+      await new Promise((resolve5) => setTimeout(resolve5, Math.min(1e3 * 2 ** attempt, Math.max(0, (options?.deadline ?? Date.now() + 2e3) - Date.now()))));
+    }
+  }
+  try {
+    return JSON.parse(output);
+  } catch {
+    throw new SetupFailure("invalid_provider_response", "Vercel did not return valid JSON for the bound project.");
+  }
+}
+
+// ../cli/dist/commands/setup-preflight.js
+var manifestSchema = z28.object({
+  packageManager: z28.string().optional(),
+  engines: z28.object({ node: z28.string().optional() }).optional(),
+  dependencies: z28.record(z28.string(), z28.string()).optional(),
+  devDependencies: z28.record(z28.string(), z28.string()).optional(),
+  scripts: z28.record(z28.string(), z28.string()).optional(),
+  workspaces: z28.unknown().optional()
+});
+var vercelProjectSchema = z28.object({
+  id: z28.string(),
+  accountId: z28.string(),
+  name: z28.string(),
+  nodeVersion: z28.string().nullable().optional(),
+  rootDirectory: z28.string().nullable().optional(),
+  framework: z28.string().nullable().optional(),
+  installCommand: z28.string().nullable().optional(),
+  buildCommand: z28.string().nullable().optional(),
+  link: z28.object({
+    type: z28.string(),
+    repo: z28.string().optional(),
+    repoId: z28.union([z28.string(), z28.number()]).optional(),
+    org: z28.string().optional(),
+    productionBranch: z28.string().optional()
+  }).nullable().optional()
+});
+var exists = async (path) => access2(path).then(() => true, () => false);
+var fail = (code, message) => {
+  throw new SetupFailure(code, message);
+};
+var stable = (version2, major) => new RegExp(`^${major}\\.\\d+\\.\\d+$`, "u").test(version2);
+async function inspectSetupLocalProject(projectDir) {
+  const projectDirectory = await realpath(resolve(projectDir));
+  const manifest = manifestSchema.parse(JSON.parse(await readFile8(join6(projectDirectory, "package.json"), "utf8")));
+  const apps = (await Promise.all(["app", "src/app"].map(async (path) => await exists(join6(projectDirectory, path)) ? path : null))).filter((path) => path !== null);
+  if (apps.length !== 1)
+    fail("ambiguous_app_directory", "Select one Next.js App Router application with exactly one app/ or src/app/ directory.");
+  const repositoryRoot = (await setupProcess("git", ["rev-parse", "--show-toplevel"], {
+    cwd: projectDirectory
+  })).trim();
+  const tracked = await setupProcess("git", ["ls-files", "--stage", "-z"], {
+    cwd: repositoryRoot
+  });
+  for (const entry of tracked.split("\0").filter(Boolean)) {
+    if (entry.startsWith("160000 "))
+      fail("git_submodule_conflict", "The repository contains Git submodules. Resolve the explicit deployment source boundary before setup; the CLI will not copy external repositories.");
+    if (!entry.startsWith("120000 "))
+      continue;
+    const path = join6(repositoryRoot, entry.slice(entry.indexOf("	") + 1));
+    const target = resolve(dirname6(path), await readlink(path));
+    const bound = relative2(repositoryRoot, target);
+    if (bound.startsWith("..") || bound.startsWith(sep))
+      fail("external_symlink_conflict", "A tracked symbolic link points outside this repository. Resolve that source boundary before setup; local external files cannot enter a deployment.");
+  }
+  let lockfileRoot = projectDirectory;
+  const lockNames = [
+    "package-lock.json",
+    "npm-shrinkwrap.json",
+    "pnpm-lock.yaml",
+    "yarn.lock",
+    "bun.lock",
+    "bun.lockb"
+  ];
+  let locks = [];
+  for (; ; ) {
+    locks = (await Promise.all(lockNames.map(async (name3) => await exists(join6(lockfileRoot, name3)) ? name3 : null))).filter((name3) => name3 !== null);
+    if (locks.length || lockfileRoot === repositoryRoot || dirname6(lockfileRoot) === lockfileRoot)
+      break;
+    lockfileRoot = dirname6(lockfileRoot);
+  }
+  if (locks.length > 1)
+    fail("conflicting_lockfiles", "Resolve conflicting package-manager lockfiles before setup; Siteplane does not replace them.");
+  if (!locks.length)
+    fail("lockfile_missing", "Install the existing application with its chosen package manager to create one canonical lockfile.");
+  const lockName = locks[0];
+  if (!["package-lock.json", "pnpm-lock.yaml"].includes(lockName))
+    fail("unsupported_package_manager", "This setup supports npm 10 or pnpm 9/10 with their canonical lockfile.");
+  const rootManifest = manifestSchema.parse(JSON.parse(await readFile8(join6(lockfileRoot, "package.json"), "utf8")));
+  if (lockfileRoot !== projectDirectory) {
+    const workspaceFile = join6(lockfileRoot, "pnpm-workspace.yaml");
+    const workspace = lockName === "pnpm-lock.yaml" && await exists(workspaceFile) ? z28.object({ packages: z28.array(z28.string()) }).parse(parseYaml(await readFile8(workspaceFile, "utf8"))).packages : z28.union([
+      z28.array(z28.string()),
+      z28.object({ packages: z28.array(z28.string()) }).transform((value) => value.packages)
+    ]).parse(rootManifest.workspaces);
+    const selected = relative2(lockfileRoot, projectDirectory).split(sep).join("/");
+    if (!workspace.some((pattern) => !pattern.startsWith("!") && minimatch(selected, pattern)) || workspace.some((pattern) => pattern.startsWith("!") && minimatch(selected, pattern.slice(1))))
+      fail("unbound_workspace_app", "The selected application is excluded from the canonical lockfile's workspace packages. Select its actual application root.");
+  }
+  for (let ancestor = dirname6(lockfileRoot); ancestor.startsWith(repositoryRoot + sep) || ancestor === repositoryRoot; ancestor = dirname6(ancestor)) {
+    const ancestorLocks = await Promise.all(lockNames.map((name3) => exists(join6(ancestor, name3))));
+    if (ancestorLocks.some(Boolean))
+      fail("ambiguous_lockfile_root", "Both the selected package and its repository ancestors contain lockfiles. Select one canonical workspace resolution before setup.");
+    if (ancestor === repositoryRoot)
+      break;
+  }
+  const lockText = await readFile8(join6(lockfileRoot, lockName), "utf8");
+  const npmLock = lockName === "package-lock.json" ? z28.object({
+    lockfileVersion: z28.number(),
+    packages: z28.record(z28.string(), z28.object({
+      version: z28.string().optional(),
+      peerDependencies: z28.record(z28.string(), z28.string()).optional()
+    })).optional()
+  }).parse(JSON.parse(lockText)) : null;
+  async function version2(name3) {
+    try {
+      return (await readInstalledPackage(projectDirectory, name3)).version;
+    } catch {
+      const resolved = npmLock?.packages?.[`node_modules/${name3}`]?.version;
+      if (resolved)
+        return resolved;
+      return fail("dependencies_not_installed", `Install the existing ${name3} dependency using the canonical lockfile before setup.`);
+    }
+  }
+  const [nextVersion, reactVersion, reactDomVersion] = await Promise.all([
+    version2("next"),
+    version2("react"),
+    version2("react-dom")
+  ]);
+  if (!stable(nextVersion, 16))
+    fail("unsupported_next_version", "Setup supports stable Next.js 16 App Router projects. Framework migration requires a separate owner decision.");
+  if (!stable(reactVersion, 19) || reactDomVersion !== reactVersion)
+    fail("react_version_conflict", "Use the same stable React 19/react-dom version compatible with the installed Next.js peers.");
+  if (!stable(process.versions.node, 22))
+    fail("unsupported_node_version", "Run setup under Node.js 22; this does not change your framework or package-manager versions.");
+  const nextMetadata = await readInstalledPackage(projectDirectory, "next").catch(() => npmLock?.packages?.["node_modules/next"] ?? null);
+  const peers = nextMetadata?.peerDependencies;
+  if (!peers?.react || !peers["react-dom"])
+    fail("next_peer_metadata_missing", "Install the locked Next.js dependency before setup so its actual React peer requirements can be checked.");
+  if (!semver.satisfies(reactVersion, peers.react) || !semver.satisfies(reactDomVersion, peers["react-dom"]))
+    fail("react_peer_conflict", "The installed React pair does not satisfy the installed Next.js peer requirements. Choose a compatible pair explicitly.");
+  if (manifest.engines?.node && !semver.satisfies(process.versions.node, manifest.engines.node))
+    fail("node_engine_conflict", "The selected application's Node engine declaration excludes the active supported Node.js 22 runtime.");
+  const name2 = lockName === "package-lock.json" ? "npm" : "pnpm";
+  const declared = rootManifest.packageManager ?? manifest.packageManager ?? null;
+  if (rootManifest.packageManager && manifest.packageManager && rootManifest.packageManager !== manifest.packageManager)
+    fail("package_manager_conflict", "Application and workspace packageManager declarations disagree.");
+  if (declared && !new RegExp(`^${name2}@\\d+\\.\\d+\\.\\d+$`, "u").test(declared))
+    fail("package_manager_conflict", "Declare an exact supported npm/pnpm packageManager version matching the canonical lockfile.");
+  const localVersion = (await setupProcess(declared ? "npx" : name2, declared ? ["--yes", declared, "--version"] : ["--version"], { cwd: lockfileRoot })).trim();
+  if (!(name2 === "npm" ? stable(localVersion, 10) : stable(localVersion, 9) || stable(localVersion, 10)))
+    fail("unsupported_package_manager_version", "Use npm 10 or pnpm 9/10; other versions are outside the initial setup support range.");
+  if (declared && declared !== `${name2}@${localVersion}`)
+    fail("package_manager_conflict", "The actual local package-manager version differs from the project's exact packageManager declaration. Select the declared tool without rewriting the lockfile.");
+  const format = npmLock ? String(npmLock.lockfileVersion) : /^lockfileVersion:\s*['"]?([\d.]+)/mu.exec(lockText)?.[1];
+  if (name2 === "npm" && format !== "3" || name2 === "pnpm" && format !== "9.0" && format !== "9")
+    fail("lockfile_format_conflict", "The canonical lockfile format does not match npm 10 or pnpm 9/10.");
+  const sourceConflicts = [];
+  for (const file of ["next.config.js", "next.config.mjs", "next.config.ts"]) {
+    if (!await exists(join6(projectDirectory, file)))
+      continue;
+    const source = await readFile8(join6(projectDirectory, file), "utf8");
+    if (/output\s*:\s*['"]export['"]/u.test(source))
+      sourceConflicts.push("static_export");
+    if (/\bbasePath\s*:/u.test(source))
+      sourceConflicts.push("base_path");
+  }
+  if (sourceConflicts.length)
+    fail("unsupported_server_configuration", "Resolve static export/basePath configuration explicitly; Siteplane requires its server-side admin and revalidation handlers.");
+  for (const name3 of [
+    "middleware.ts",
+    "middleware.js",
+    "proxy.ts",
+    "proxy.js",
+    "src/middleware.ts",
+    "src/middleware.js",
+    "src/proxy.ts",
+    "src/proxy.js"
+  ]) {
+    if (await exists(join6(projectDirectory, name3)))
+      sourceConflicts.push(`inspect_routing:${name3}`);
+  }
+  async function inspectSource(directory) {
+    for (const entry of await readdir(directory, { withFileTypes: true })) {
+      if (entry.isSymbolicLink() || ["node_modules", ".git", ".next", ".siteplane", ".vercel"].includes(entry.name))
+        continue;
+      const path = join6(directory, entry.name);
+      if (entry.isDirectory()) {
+        await inspectSource(path);
+        continue;
+      }
+      if (!/\.[cm]?[jt]sx?$/u.test(entry.name))
+        continue;
+      const source = await readFile8(path, "utf8");
+      if (/from\s*["']next\/image["']/u.test(source))
+        sourceConflicts.push(`inspect_image_policy:${relative2(projectDirectory, path)}`);
+      if (/\b(?:Cookiebot|OneTrust|cookieyes|consentManager|cookieConsent)\b/iu.test(source))
+        sourceConflicts.push(`inspect_existing_consent:${relative2(projectDirectory, path)}`);
+      if (/from\s*["']next\/image["']/u.test(source) && semver.lt(nextVersion, "16.3.3"))
+        fail("next_security_advisory", `Next.js ${nextVersion} uses image optimization affected by the August 2026 AVIF advisory. Review https://nextjs.org/blog/august-2026-security-release and explicitly update the affected dependency before setup; no framework upgrade was performed.`);
+      if (/["']use server["']/u.test(source) && semver.lt(nextVersion, "16.2.11"))
+        fail("next_security_advisory", `Next.js ${nextVersion} contains Server Actions affected by the July 2026 advisory. Review https://nextjs.org/blog/july-2026-security-release and explicitly update the affected dependency before setup.`);
+    }
+  }
+  await inspectSource(join6(projectDirectory, apps[0]));
+  const gitRead = async (args) => setupProcess("git", args, { cwd: projectDirectory }).then((value) => value.trim(), () => null);
+  return {
+    projectDirectory,
+    repositoryRoot,
+    lockfileRoot,
+    appDirectory: apps[0],
+    nextVersion,
+    reactVersion,
+    nodeVersion: process.versions.node,
+    packageManager: { name: name2, version: localVersion, declared },
+    lockfile: {
+      path: relative2(repositoryRoot, join6(lockfileRoot, lockName)),
+      format,
+      sha256: createHash2("sha256").update(lockText).digest("hex")
+    },
+    git: {
+      branch: await gitRead(["branch", "--show-current"]),
+      revision: await gitRead(["rev-parse", "HEAD"]),
+      remote: safeGitRemote(await gitRead(["remote", "get-url", "origin"])),
+      changes: (await gitRead(["status", "--porcelain=v1", "--untracked-files=all"]))?.split("\n").filter(Boolean) ?? []
+    },
+    sourceConflicts
+  };
+}
+async function setupPreflightCommand(input) {
+  let local;
+  try {
+    local = await inspectSetupLocalProject(input.projectDir);
+    await assertLocalCredentialsPathSafe(input.projectDir);
+    let linkDirectory = local.projectDirectory;
+    while (!await exists(join6(linkDirectory, ".vercel/project.json")) && linkDirectory !== local.repositoryRoot && dirname6(linkDirectory) !== linkDirectory)
+      linkDirectory = dirname6(linkDirectory);
+    if (!await exists(join6(linkDirectory, ".vercel/project.json")))
+      fail("vercel_project_not_linked", "Link this application to its intended Vercel project before setup; Siteplane will not guess a target.");
+    const linked = z28.object({
+      projectId: z28.string().regex(/^prj_[A-Za-z0-9]+$/u),
+      orgId: z28.string().regex(/^(?:team|user)_[A-Za-z0-9]+$/u)
+    }).parse(JSON.parse(await readFile8(join6(linkDirectory, ".vercel/project.json"), "utf8")));
+    const project = vercelProjectSchema.parse(await setupVercelApi(linkDirectory, `/v9/projects/${linked.projectId}?teamId=${linked.orgId}`));
+    if (project.id !== linked.projectId || project.accountId !== linked.orgId)
+      fail("vercel_identity_conflict", "The provider project does not match the locally linked project and team.");
+    const expectedRoot = relative2(local.repositoryRoot, local.projectDirectory).split(sep).join("/");
+    if ((project.rootDirectory ?? "") !== expectedRoot)
+      fail("vercel_root_conflict", "Vercel Root Directory and the selected local app must identify the same application.");
+    if (project.nodeVersion !== "22.x" || project.framework !== "nextjs")
+      fail("vercel_framework_conflict", "The bound Vercel project must use Next.js with Node.js 22 before setup.");
+    if (project.link && project.link.productionBranch !== local.git.branch)
+      fail("vercel_production_branch_conflict", "The local branch differs from the bound Vercel Production branch.");
+    if (project.link?.repo && project.link.org && !local.git.remote?.replace(/\.git$/u, "").endsWith(`${project.link.org}/${project.link.repo}`))
+      fail("vercel_git_conflict", "The local origin repository differs from the Vercel Git connection.");
+    const env = z28.object({
+      envs: z28.array(z28.object({
+        key: z28.string(),
+        value: z28.string().optional(),
+        target: z28.array(z28.string()).optional()
+      }))
+    }).parse(await setupVercelApi(linkDirectory, `/v10/projects/${linked.projectId}/env?teamId=${linked.orgId}`));
+    const corepack = env.envs.some((item) => item.key === "ENABLE_EXPERIMENTAL_COREPACK" && item.value === "1" && item.target?.includes("production"));
+    const install = project.installCommand ?? null;
+    const selected = corepack ? "corepack" : install ? "install_override" : "automatic";
+    if (local.packageManager.declared && selected === "automatic")
+      fail("vercel_package_manager_pin_unconfirmed", "This project declares an exact packageManager but Vercel automatic selection does not bind that version. Enable its supported Corepack selection or set an exact install AND build override in the existing project, then rerun preflight. No package, lockfile or provider setting was changed.");
+    if (install && /\b(?:yarn|bun)\b/u.test(install))
+      fail("vercel_package_manager_conflict", "The Vercel install override selects an unsupported package manager.");
+    const overridePin = install ? /\b(npm|pnpm)@(\d+\.\d+\.\d+)\b/u.exec(install) : null;
+    if (overridePin && overridePin[1] !== local.packageManager.name)
+      fail("vercel_package_manager_conflict", "The provider override selects a different package manager than the canonical lockfile.");
+    const overrideFamily = install ? /(?:^|[;&|]\s*)(npm|pnpm)\s+(?:ci|install)\b/u.exec(install)?.[1] : null;
+    if (overrideFamily && overrideFamily !== local.packageManager.name)
+      fail("vercel_package_manager_conflict", "The provider install command conflicts with the canonical lockfile.");
+    if (overridePin && local.packageManager.declared && `${overridePin[1]}@${overridePin[2]}` !== local.packageManager.declared)
+      fail("vercel_package_manager_conflict", "The Vercel install override conflicts with the exact packageManager declaration.");
+    return {
+      status: "ready",
+      local,
+      provider: {
+        projectId: project.id,
+        teamId: project.accountId,
+        name: project.name,
+        rootDirectory: expectedRoot,
+        nodeVersion: project.nodeVersion,
+        git: project.link,
+        installCommand: install,
+        buildCommand: project.buildCommand ?? null,
+        packageManagerSelection: selected,
+        declaredPackageManager: local.packageManager.declared,
+        observedPackageManager: null
+      }
+    };
+  } catch (error) {
+    return {
+      status: "action_required",
+      code: error instanceof SetupFailure ? error.code : "invalid_local_project",
+      message: error instanceof SetupFailure ? error.message : "The selected project or provider response could not be validated. Check the application manifest and local project access.",
+      ...local ? { local } : {}
+    };
+  }
+}
+function safeGitRemote(value) {
+  if (!value)
+    return null;
+  if (!value.includes("://"))
+    return value;
+  try {
+    const url = new URL(value);
+    url.username = "";
+    url.password = "";
+    url.search = "";
+    url.hash = "";
+    return url.toString().replace(/\/$/u, "");
+  } catch {
+    return null;
+  }
+}
+
+// ../cli/dist/commands/init.js
+var siteSetupBootstrapDataSchema = z29.object({
+  credentialPurpose: z29.literal("site_setup"),
+  apiBaseUrl: z29.string().url(),
+  siteId: z29.string().uuid(),
+  publicSiteKeyId: z29.string().uuid(),
+  publicSiteKey: z29.string().trim().min(1),
+  accessToken: z29.string().trim().min(1),
+  siteRevalidationSecret: z29.string().regex(/^[A-Za-z0-9_-]{43}$/u),
+  runId: z29.string().uuid(),
+  packages: z29.object({
+    siteplane: z29.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u),
+    runtimeNext: z29.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u)
+  }).strict()
 }).strict();
-var featureBootstrapDataSchema = z26.object({
-  credentialPurpose: z26.enum(["analytics", "booking"]),
-  apiBaseUrl: z26.string().url(),
-  siteId: z26.string().uuid(),
-  accessToken: z26.string().trim().min(1)
+var featureBootstrapDataSchema = z29.object({
+  credentialPurpose: z29.enum(["analytics", "booking"]),
+  apiBaseUrl: z29.string().url(),
+  siteId: z29.string().uuid(),
+  accessToken: z29.string().trim().min(1)
 }).strict();
-var bootstrapResponseSchema = z26.object({
-  ok: z26.literal(true),
-  data: z26.discriminatedUnion("credentialPurpose", [
+var bootstrapResponseSchema = z29.object({
+  ok: z29.literal(true),
+  data: z29.discriminatedUnion("credentialPurpose", [
     siteSetupBootstrapDataSchema,
     featureBootstrapDataSchema
   ])
 }).strict();
 
 // ../cli/dist/commands/scan.js
-import { readdir } from "fs/promises";
-import { extname, join as join6 } from "path";
+import { readdir as readdir2 } from "fs/promises";
+import { extname, join as join8 } from "path";
 var defaultScanRoots = ["app", "src", "pages", "components", "lib"];
 var excludedDirectories = /* @__PURE__ */ new Set([
   ".git",
@@ -2039,14 +2725,14 @@ async function resolveScanFilePaths(filePaths, options = {}) {
     return filePaths;
   }
   const projectDir = options.projectDir ?? process.cwd();
-  const discovered = await Promise.all(defaultScanRoots.map((root) => collectSourceFiles(join6(projectDir, root))));
+  const discovered = await Promise.all(defaultScanRoots.map((root) => collectSourceFiles(join8(projectDir, root))));
   return [...new Set(discovered.flat())].sort();
 }
 async function collectSourceFiles(directory) {
-  const entries = await readdir(directory, { withFileTypes: true }).catch(() => []);
+  const entries = await readdir2(directory, { withFileTypes: true }).catch(() => []);
   const files = [];
   for (const entry of entries) {
-    const entryPath = join6(directory, entry.name);
+    const entryPath = join8(directory, entry.name);
     if (entry.isDirectory()) {
       if (!excludedDirectories.has(entry.name)) {
         files.push(...await collectSourceFiles(entryPath));
@@ -2062,17 +2748,17 @@ async function collectSourceFiles(directory) {
 
 // ../cli/dist/commands/site-setup.js
 import { execFile as execFile2 } from "child_process";
-import { readFile as readFile7 } from "fs/promises";
+import { readFile as readFile9 } from "fs/promises";
 import { promisify as promisify2 } from "util";
-import { z as z27 } from "zod";
+import { z as z30 } from "zod";
 
 // ../cli/dist/scan/next-source-scan.js
 import ts2 from "typescript";
-import { isAbsolute, relative as relative2 } from "path";
+import { isAbsolute, relative as relative4 } from "path";
 var eventPreviewHandlerMissingMessage = "Event preview fields must consume preview values with useSiteplanePreviewText from @siteplane/runtime-next/client or a siteplane:preview-value-applied listener.";
 var valueCallUnusedMessage = "Siteplane value calls must feed rendered content. Assign or await the returned value and render that value instead of ignoring the call.";
 var legacyEditableComponentPrefix = "Editable";
-var editableComponentNames = new Set(["Image", "Text", "LongText", "Link"].map((name) => `${legacyEditableComponentPrefix}${name}`));
+var editableComponentNames = new Set(["Image", "Text", "LongText", "Link"].map((name2) => `${legacyEditableComponentPrefix}${name2}`));
 var functionTypeByName = {
   text: "text",
   longText: "longText",
@@ -2610,17 +3296,17 @@ function readObjectLiteral(expression) {
     if (!ts2.isPropertyAssignment(property)) {
       continue;
     }
-    const name = getPropertyName(property.name);
-    if (!name) {
+    const name2 = getPropertyName(property.name);
+    if (!name2) {
       continue;
     }
-    value[name] = staticExpressionValue(property.initializer);
+    value[name2] = staticExpressionValue(property.initializer);
   }
   return value;
 }
-function getPropertyName(name) {
-  if (ts2.isIdentifier(name) || ts2.isStringLiteral(name)) {
-    return name.text;
+function getPropertyName(name2) {
+  if (ts2.isIdentifier(name2) || ts2.isStringLiteral(name2)) {
+    return name2.text;
   }
   return null;
 }
@@ -2646,9 +3332,9 @@ function collectEventPreviewComponentPropUsages(node, eventPreviewAttrVariables,
     });
   }
 }
-function getJsxAttributeName(name) {
-  if (ts2.isIdentifier(name)) {
-    return name.text;
+function getJsxAttributeName(name2) {
+  if (ts2.isIdentifier(name2)) {
+    return name2.text;
   }
   return void 0;
 }
@@ -2673,8 +3359,8 @@ function getFunctionComponentName(node) {
   }
   return void 0;
 }
-function isComponentName(name) {
-  return /^[A-Z]/.test(name);
+function isComponentName(name2) {
+  return /^[A-Z]/.test(name2);
 }
 function getAssignedVariableName(node) {
   let current = node;
@@ -2722,7 +3408,7 @@ function inferRouteHint(filePath) {
   return route ? `/${route}` : "/";
 }
 function toRepositoryRelativePosixPath(filePath, projectRoot) {
-  const path = isAbsolute(filePath) ? relative2(projectRoot, filePath) : filePath;
+  const path = isAbsolute(filePath) ? relative4(projectRoot, filePath) : filePath;
   return path.replaceAll("\\", "/");
 }
 function isPositionalFieldReference(value) {
@@ -2731,54 +3417,354 @@ function isPositionalFieldReference(value) {
 
 // ../cli/dist/commands/site-setup.js
 var execFileAsync2 = promisify2(execFile2);
-var safeErrorSchema = z27.object({
-  code: z27.string().trim().min(1),
-  message: z27.string().trim().min(1)
+var safeErrorSchema = z30.object({
+  code: z30.string().trim().min(1),
+  message: z30.string().trim().min(1)
 }).passthrough();
-var errorResponseSchema2 = z27.object({ ok: z27.literal(false), error: safeErrorSchema }).passthrough();
-var contextDataSchema = z27.object({
-  task: siteSetupTaskSchema,
-  site: z27.object({ siteId: z27.string().uuid(), portalPath: z27.string() }),
-  run: z27.object({
-    runId: z27.string().uuid(),
-    mode: z27.enum(["initial", "update"]),
-    status: z27.enum([
-      "waiting_for_agent",
-      "working",
-      "action_required",
-      "ready_for_review"
-    ]),
-    fieldContractHash: z27.string().nullable(),
-    deploymentOrigin: z27.string().nullable(),
-    deploymentRevision: z27.string().nullable(),
-    errorCode: z27.string().nullable(),
-    errorMessage: z27.string().nullable()
-  }),
-  structureHandoff: z27.object({
-    pendingFields: z27.array(setupCorrectionItemSchema).max(50),
-    ownerEditabilityNote: siteSetupOwnerEditabilityNoteSchema
-  }).strict().nullable(),
-  allowedTasks: z27.array(z27.string()),
-  requiredEnvironmentNames: z27.array(z27.string())
+var errorResponseSchema2 = z30.object({ ok: z30.literal(false), error: safeErrorSchema }).passthrough();
+var contextDataSchema = z30.object({ task: siteSetupTaskSchema }).strict();
+var contextResponseSchema = z30.object({ ok: z30.literal(true), data: contextDataSchema }).strict();
+var applyDataSchema = z30.object({
+  status: z30.enum(["applied", "ready_for_review"]),
+  runId: z30.string().uuid().optional(),
+  contractVersionId: z30.string().uuid().optional(),
+  fieldContractHash: z30.string().regex(/^sha256:[0-9a-f]{64}$/u),
+  editorDefinitionHash: z30.string().regex(/^sha256:[0-9a-f]{64}$/u).optional(),
+  fieldCount: z30.number().int().nonnegative().optional(),
+  routeCount: z30.number().int().nonnegative().optional()
 }).strict();
-var contextResponseSchema = z27.object({ ok: z27.literal(true), data: contextDataSchema }).strict();
-var applyDataSchema = z27.object({
-  status: z27.enum(["applied", "ready_for_review"]),
-  runId: z27.string().uuid().optional(),
-  contractVersionId: z27.string().uuid().optional(),
-  fieldContractHash: z27.string().regex(/^sha256:[0-9a-f]{64}$/u),
-  editorDefinitionHash: z27.string().regex(/^sha256:[0-9a-f]{64}$/u).optional(),
-  fieldCount: z27.number().int().nonnegative().optional(),
-  routeCount: z27.number().int().nonnegative().optional()
+var applyResponseSchema = z30.object({ ok: z30.literal(true), data: applyDataSchema }).strict();
+var verifyDataSchema = z30.object({
+  status: z30.literal("ready_for_review"),
+  runId: z30.string().uuid().optional(),
+  deploymentOrigin: z30.string().url().optional(),
+  deploymentRevision: z30.string().optional()
 }).strict();
-var applyResponseSchema = z27.object({ ok: z27.literal(true), data: applyDataSchema }).strict();
-var verifyDataSchema = z27.object({
-  status: z27.literal("ready_for_review"),
-  runId: z27.string().uuid().optional(),
-  deploymentOrigin: z27.string().url().optional(),
-  deploymentRevision: z27.string().optional()
+var verifyResponseSchema = z30.object({ ok: z30.literal(true), data: verifyDataSchema }).strict();
+async function siteSetupContextCommand(input) {
+  const response = await postSiteSetup(input, "context", {});
+  const parsed = contextResponseSchema.safeParse(response.payload);
+  if (response.ok && parsed.success) {
+    return { status: "ok", ...parsed.data.data };
+  }
+  return actionRequired(response.payload, "Siteplane setup context is unavailable.");
+}
+async function siteSetupVerifyCommand(input) {
+  const resolveSourceFiles = input.resolveSourceFiles ?? resolveScanFilePaths;
+  const readSourceFile = input.readSourceFile ?? ((path) => readFile9(path, "utf8"));
+  const paths = await resolveSourceFiles([], { projectDir: input.projectDir });
+  const sources = await Promise.all(paths.map(readSourceFile));
+  if (!sources.some(hasMountedFieldRuntimeBridge)) {
+    return {
+      status: "action_required",
+      code: "missing_field_runtime_bridge",
+      message: "Mount FieldRuntimeBridge from @siteplane/runtime-next/client before deployment verification."
+    };
+  }
+  const deploymentRevision = await (input.readRevision ?? readGitRevision)(input.projectDir);
+  const response = await postSiteSetup(input, "verify", {
+    deploymentUrl: input.deploymentUrl,
+    deploymentRevision,
+    ...input.wait ? { wait: true } : {}
+  });
+  const parsed = verifyResponseSchema.safeParse(response.payload);
+  if (response.ok && parsed.success) {
+    return parsed.data.data;
+  }
+  return actionRequired(response.payload, "Siteplane deployment verification failed.");
+}
+function hasMountedFieldRuntimeBridge(source) {
+  return /from\s+["']@siteplane\/runtime-next(?:\/client)?["']/u.test(source) && /<FieldRuntimeBridge(?:\s|\/|>)/u.test(source);
+}
+async function postSiteSetup(input, operation, body) {
+  const [config, credentials] = await Promise.all([
+    readProjectConfig(input.projectDir),
+    readLocalCredentials(input.projectDir)
+  ]);
+  try {
+    const response = await (input.fetcher ?? fetch)(`${config.apiBaseUrl.replace(/\/$/u, "")}/api/cli/setup/${operation}`, {
+      method: "POST",
+      signal: AbortSignal.timeout(Math.max(1, Math.min(2e4, (input.deadline ?? Date.now() + 2e4) - Date.now()))),
+      headers: {
+        authorization: `Bearer ${credentials.accessToken}`,
+        "content-type": "application/json",
+        ...input.vercelAutomationBypassSecret?.trim() ? {
+          "x-vercel-protection-bypass": input.vercelAutomationBypassSecret.trim()
+        } : {}
+      },
+      body: JSON.stringify(body)
+    });
+    const payload = await response.json().catch(() => null);
+    return { ok: response.ok, payload };
+  } catch {
+    return {
+      ok: false,
+      payload: {
+        ok: false,
+        error: {
+          code: "site_setup.transport_failed",
+          message: "The setup request was not acknowledged. Reload the existing task before retrying; no credential values are included."
+        }
+      }
+    };
+  }
+}
+function actionRequired(payload, fallbackMessage) {
+  const parsed = errorResponseSchema2.safeParse(payload);
+  return parsed.success ? {
+    status: "action_required",
+    code: parsed.data.error.code,
+    message: parsed.data.error.message
+  } : {
+    status: "action_required",
+    code: "invalid_server_response",
+    message: fallbackMessage
+  };
+}
+async function readGitRevision(projectDir) {
+  const { stdout } = await execFileAsync2("git", ["rev-parse", "HEAD"], {
+    cwd: projectDir,
+    encoding: "utf8"
+  });
+  const revision = stdout.trim();
+  if (!revision) {
+    throw new Error("A committed Git revision is required before setup verify.");
+  }
+  return revision;
+}
+
+// ../cli/dist/commands/setup-prepare.js
+import { access as access4, lstat as lstat2, mkdir as mkdir6, open as open3, readFile as readFile10, rename as rename3, rm as rm3 } from "fs/promises";
+import { randomUUID as randomUUID4 } from "crypto";
+import { dirname as dirname7, join as join9, relative as relative5, sep as sep2 } from "path";
+import ts3 from "typescript";
+
+// ../cli/dist/commands/setup-lock.js
+import { randomUUID as randomUUID5 } from "crypto";
+import { lstat as lstat3, mkdir as mkdir7, open as open4, readFile as readFile11, rm as rm4, rmdir } from "fs/promises";
+import { resolve as resolve2 } from "path";
+import { z as z31 } from "zod";
+var ownerSchema = z31.object({ pid: z31.number().int().positive(), nonce: z31.string().uuid() }).strict();
+
+// ../cli/dist/config/build-provenance.js
+import { createHash as createHash3 } from "crypto";
+import { execFile as execFile3 } from "child_process";
+import { lstat as lstat4, readFile as readFile12, writeFile as writeFile5, mkdir as mkdir8 } from "fs/promises";
+import { dirname as dirname8, isAbsolute as isAbsolute2, join as join10, relative as relative6, resolve as resolve3, sep as sep3 } from "path";
+import { isDeepStrictEqual, promisify as promisify3 } from "util";
+import { z as z32 } from "zod";
+var execute = promisify3(execFile3);
+var name = ".siteplane/build-source.json";
+var oid = z32.string().regex(/^[0-9a-f]{40}$/u);
+var entrySchema = z32.object({
+  path: z32.string().min(1).max(4096),
+  mode: z32.enum(["100644", "100755", "120000"]),
+  oid
+}).strict();
+var schema = z32.object({
+  version: z32.literal(2),
+  revision: oid,
+  commit: z32.string().min(1).max(1048576),
+  entries: z32.array(entrySchema).min(1).max(1e5),
+  providerConfigurations: z32.array(z32.object({
+    path: z32.string().max(4096).regex(/(?:^|\/)vercel\.json$/u),
+    source: z32.string().max(1048576)
+  }).strict()).max(1e3)
 }).strict();
-var verifyResponseSchema = z27.object({ ok: z27.literal(true), data: verifyDataSchema }).strict();
+var gitHash = (type, content) => createHash3("sha1").update(`${type} ${content.length}\0`).update(content).digest("hex");
+async function writeBuildProvenance(checkout, revision) {
+  const commit = (await execute("git", ["cat-file", "commit", revision], {
+    cwd: checkout,
+    maxBuffer: 1048576
+  })).stdout;
+  const tree = (await execute("git", ["ls-tree", "-rz", "--full-tree", revision], {
+    cwd: checkout,
+    maxBuffer: 16777216
+  })).stdout;
+  const entries = tree.split("\0").filter(Boolean).map((line) => {
+    const match = /^(100644|100755|120000) blob ([0-9a-f]{40})\t([\s\S]+)$/u.exec(line);
+    if (!match)
+      throw new Error("Git submodules or unsupported tracked objects need an explicit deployment configuration.");
+    return { path: match[3], mode: match[1], oid: match[2] };
+  });
+  for (const entry of entries) {
+    if (entry.mode !== "120000")
+      continue;
+    const { readlink: readlink2 } = await import("fs/promises");
+    const path = join10(checkout, entry.path);
+    const target2 = resolve3(dirname8(path), await readlink2(path));
+    const bound = relative6(checkout, target2);
+    if (bound.startsWith("..") || isAbsolute2(bound))
+      throw new Error("A tracked symbolic link escapes the committed upload; resolve that source boundary before deployment.");
+  }
+  const providerConfigurations = await Promise.all(entries.filter((entry) => /(?:^|\/)vercel\.json$/u.test(entry.path)).map(async (entry) => ({
+    path: entry.path,
+    source: await readFile12(join10(checkout, entry.path), "utf8")
+  })));
+  const record = schema.parse({
+    version: 2,
+    revision,
+    commit,
+    entries,
+    providerConfigurations
+  });
+  const target = join10(checkout, name);
+  await mkdir8(dirname8(target), { recursive: true, mode: 448 });
+  await writeFile5(target, JSON.stringify(record), { flag: "wx", mode: 384 });
+}
+async function readBuildProvenance(projectDirectory) {
+  let root = resolve3(projectDirectory);
+  let raw = null;
+  for (; ; ) {
+    raw = await readFile12(join10(root, name), "utf8").catch((error) => {
+      if (error.code === "ENOENT")
+        return null;
+      throw error;
+    });
+    if (raw !== null || dirname8(root) === root)
+      break;
+    root = dirname8(root);
+  }
+  if (raw === null)
+    return null;
+  if (Buffer.byteLength(raw) > 16777216)
+    throw new Error("Build provenance is oversized.");
+  const record = schema.parse(JSON.parse(raw));
+  if (gitHash("commit", Buffer.from(record.commit)) !== record.revision)
+    throw new Error("The build revision is not the supplied Git commit.");
+  const expectedTree = /^tree ([0-9a-f]{40})\n/u.exec(record.commit)?.[1];
+  if (treeHash(record.entries) !== expectedTree)
+    throw new Error("The build file inventory does not belong to this Git commit.");
+  const bound = new Map(record.entries.map((entry) => [entry.path, entry]));
+  const configurations = /* @__PURE__ */ new Map();
+  for (const config of record.providerConfigurations) {
+    const entry = bound.get(config.path);
+    if (!entry || entry.mode === "120000" || configurations.has(config.path) || gitHash("blob", Buffer.from(config.source)) !== entry.oid)
+      throw new Error("The original provider configuration is not bound to the Git commit.");
+    configurations.set(config.path, config.source);
+  }
+  if (record.entries.some((entry) => /(?:^|\/)vercel\.json$/u.test(entry.path) && !configurations.has(entry.path)))
+    throw new Error("The committed provider configuration is missing from the build provenance.");
+  const appRelative = relative6(root, projectDirectory).split(sep3).join("/");
+  if (!bound.has(appRelative ? `${appRelative}/package.json` : "package.json"))
+    throw new Error("The selected app is not part of the committed upload.");
+  for (const entry of record.entries) {
+    const path = join10(root, entry.path);
+    const stat = await lstat4(path).catch((error) => {
+      if (error.code === "ENOENT")
+        return null;
+      throw error;
+    });
+    if (!stat)
+      continue;
+    if (stat.isSymbolicLink()) {
+      const { readlink: readlink2 } = await import("fs/promises");
+      if (entry.mode !== "120000" || gitHash("blob", Buffer.from(await readlink2(path))) !== entry.oid)
+        throw new Error("A deployed symbolic link differs from the commit.");
+    } else {
+      const contents = stat.isFile() ? await readFile12(path) : null;
+      if (contents && entry.mode !== "120000" && gitHash("blob", contents) === entry.oid)
+        continue;
+      const original = configurations.get(entry.path);
+      if (contents && original && entry.mode !== "120000") {
+        try {
+          const object = z32.record(z32.string(), z32.unknown());
+          const actual = object.parse(JSON.parse(contents.toString("utf8")));
+          const expected = object.parse(JSON.parse(original));
+          if (!Object.hasOwn(expected, "version") && actual.version === 2)
+            delete actual.version;
+          if (!Object.hasOwn(expected, "name") && typeof actual.name === "string" && /^[a-z0-9][a-z0-9._-]{0,99}$/iu.test(actual.name))
+            delete actual.name;
+          if (isDeepStrictEqual(actual, expected))
+            continue;
+        } catch {
+        }
+      }
+      throw new Error(`A deployed file ${JSON.stringify(entry.path).slice(0, 260)} differs from the committed upload.`);
+    }
+  }
+  return record.revision;
+}
+function treeHash(entries) {
+  const root = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    const parts = entry.path.split("/");
+    if (parts.some((part) => !part || part === "." || part === ".." || part.includes("\0") || part.includes("\\")))
+      throw new Error("Unsafe Git inventory path.");
+    let tree = root;
+    for (const part of parts.slice(0, -1)) {
+      let child = tree.get(part);
+      if (!child) {
+        child = /* @__PURE__ */ new Map();
+        tree.set(part, child);
+      }
+      if (!(child instanceof Map))
+        throw new Error("Conflicting Git inventory path.");
+      tree = child;
+    }
+    const leaf = parts.at(-1);
+    if (tree.has(leaf))
+      throw new Error("Duplicate Git inventory path.");
+    tree.set(leaf, { mode: entry.mode, oid: entry.oid });
+  }
+  const hash2 = (tree) => {
+    const sorted = [...tree].sort(([a, av], [b, bv]) => Buffer.compare(Buffer.from(a + (av instanceof Map ? "/" : "")), Buffer.from(b + (bv instanceof Map ? "/" : ""))));
+    return gitHash("tree", Buffer.concat(sorted.map(([path, value]) => Buffer.concat([
+      Buffer.from(`${value instanceof Map ? "40000" : value.mode} ${path}\0`),
+      Buffer.from(value instanceof Map ? hash2(value) : value.oid, "hex")
+    ]))));
+  };
+  return hash2(root);
+}
+
+// ../cli/dist/commands/setup-deploy.js
+import { createHash as createHash4, randomBytes, randomUUID as randomUUID6 } from "crypto";
+import { access as access5, mkdir as mkdir9, mkdtemp, rm as rm5, writeFile as writeFile6 } from "fs/promises";
+import { tmpdir } from "os";
+import { join as join11 } from "path";
+import { z as z33 } from "zod";
+var envSchema = z33.object({
+  id: z33.string(),
+  key: z33.string(),
+  target: z33.array(z33.string()),
+  type: z33.string(),
+  comment: z33.string().optional(),
+  updatedAt: z33.number().optional()
+});
+var deploymentSchema = z33.object({
+  id: z33.string(),
+  projectId: z33.string(),
+  ownerId: z33.string().optional(),
+  target: z33.string().nullable(),
+  readyState: z33.string(),
+  createdAt: z33.number(),
+  url: z33.string(),
+  meta: z33.record(z33.string(), z33.unknown()).optional(),
+  gitSource: z33.object({ sha: z33.string().optional() }).nullable().optional()
+});
+var buildProofSchema = z33.object({
+  node: z33.string(),
+  packageManager: z33.enum(["npm", "pnpm"]),
+  packageManagerVersion: z33.string(),
+  lockfileHash: z33.string(),
+  revision: z33.string(),
+  fieldContractHash: z33.string(),
+  siteplane: z33.string(),
+  runtimeNext: z33.string(),
+  next: z33.string(),
+  react: z33.string()
+}).strict();
+var defaults = {
+  preflight: setupPreflightCommand,
+  context: siteSetupContextCommand,
+  api: setupVercelApi,
+  process: setupProcess,
+  verify: siteSetupVerifyCommand,
+  post: postSiteSetup,
+  writeBuildProvenance,
+  now: Date.now,
+  pause: (milliseconds) => new Promise((resolve5) => setTimeout(resolve5, milliseconds))
+};
 
 // src/next.ts
 var SiteplaneNextContractError = class extends Error {
@@ -2790,14 +3776,14 @@ var SiteplaneNextContractError = class extends Error {
   code;
 };
 async function scanNextProjectFieldContract(projectDir) {
-  const resolvedProjectDir = resolve(projectDir);
+  const resolvedProjectDir = resolve4(projectDir);
   const filePaths = await resolveScanFilePaths([], {
     projectDir: resolvedProjectDir
   });
   const files = await Promise.all(
     filePaths.map(async (filePath) => ({
       filePath,
-      sourceText: await readFile8(filePath, "utf8")
+      sourceText: await readFile13(filePath, "utf8")
     }))
   );
   const result = scanNextSourceFilesToSiteFieldContract(files, {
@@ -2830,15 +3816,32 @@ async function withSiteplane(nextConfig, options = {}) {
       "The instrumented source no longer matches siteplane.config.json. Run siteplane setup apply again."
     );
   }
-  const buildRevision = options.buildRevision?.trim() || process.env.SITEPLANE_BUILD_REVISION?.trim() || await readGitRevision(projectDir);
-  if (!buildRevision) {
+  const checkoutRevision = await readGitRevision2(projectDir) || await readBuildProvenance(projectDir) || (process.env.VERCEL === "1" ? process.env.VERCEL_GIT_COMMIT_SHA?.trim() : "");
+  const requestedRevision = options.buildRevision?.trim() || process.env.SITEPLANE_BUILD_REVISION?.trim();
+  if (!checkoutRevision || !/^[0-9a-f]{40}$/u.test(checkoutRevision))
     throw new SiteplaneNextContractError(
       "missing_build_revision",
-      "Set SITEPLANE_BUILD_REVISION or build from a Git checkout with a commit."
+      "Build from the committed Git checkout with provider Git metadata; an arbitrary revision override is insufficient."
+    );
+  if (requestedRevision && requestedRevision !== checkoutRevision)
+    throw new SiteplaneNextContractError(
+      "build_revision_conflict",
+      "SITEPLANE_BUILD_REVISION does not match the actual build checkout. Deploy the applied commit with its current configuration."
+    );
+  const buildRevision = checkoutRevision;
+  if (process.env.VERCEL === "1")
+    await emitBuildProof(
+      projectDir,
+      config.packages,
+      buildRevision,
+      scan.fieldContractHash
     );
-  }
   return {
     ...nextConfig,
+    headers: async () => frameHeaders(
+      await nextConfig.headers?.() ?? [],
+      new URL(config.apiBaseUrl).origin
+    ),
     env: {
       ...nextConfig.env ?? {},
       SITEPLANE_BUILD_FIELD_CONTRACT_HASH: scan.fieldContractHash,
@@ -2847,8 +3850,8 @@ async function withSiteplane(nextConfig, options = {}) {
     }
   };
 }
-var execFileAsync3 = promisify3(execFile3);
-async function readGitRevision(projectDir) {
+var execFileAsync3 = promisify4(execFile4);
+async function readGitRevision2(projectDir) {
   try {
     const result = await execFileAsync3("git", ["rev-parse", "HEAD"], {
       cwd: projectDir
@@ -2858,6 +3861,85 @@ async function readGitRevision(projectDir) {
     return "";
   }
 }
+function frameHeaders(rules, adminOrigin) {
+  const policy = `frame-ancestors 'self' ${adminOrigin}`;
+  const prepared = rules.map((rule) => ({
+    ...rule,
+    headers: rule.headers.map((header) => {
+      if (header.key.toLowerCase() === "x-frame-options" && /^(DENY|SAMEORIGIN)$/iu.test(header.value.trim()))
+        throw new SiteplaneNextContractError(
+          "frame_policy_conflict",
+          "The existing X-Frame-Options blocks the Siteplane preview. Reconcile that explicit website policy with the canonical admin origin."
+        );
+      if (header.key.toLowerCase() !== "content-security-policy") return header;
+      const ancestors = /(?:^|;)\s*frame-ancestors\s+([^;]+)/iu.exec(
+        header.value
+      )?.[1];
+      if (ancestors && (!ancestors.split(/\s+/u).includes(adminOrigin) || ancestors.includes("*")))
+        throw new SiteplaneNextContractError(
+          "frame_policy_conflict",
+          "Keep the existing CSP directives and explicitly allow only the canonical Siteplane admin origin in frame-ancestors."
+        );
+      return {
+        ...header,
+        value: ancestors ? header.value : `${header.value.replace(/;\s*$/u, "")}; ${policy}`
+      };
+    })
+  }));
+  return [
+    {
+      source: "/:path*",
+      headers: [{ key: "Content-Security-Policy", value: policy }]
+    },
+    ...prepared
+  ];
+}
+async function emitBuildProof(projectDir, packages, revision, fieldContractHash) {
+  const [cli, runtime, next, react] = await Promise.all(
+    ["siteplane", "@siteplane/runtime-next", "next", "react"].map(
+      (name2) => readInstalledPackage(projectDir, name2)
+    )
+  );
+  if (cli.version !== packages.siteplane || runtime.version !== packages.runtimeNext)
+    throw new SiteplaneNextContractError(
+      "build_identity_missing",
+      "The provider installed different Siteplane package versions than the task requires."
+    );
+  const executable = process.env.npm_execpath;
+  if (!executable)
+    throw new SiteplaneNextContractError(
+      "build_identity_missing",
+      "Run the provider build through the selected npm/pnpm executable so its actual version can be verified."
+    );
+  const packageManager = /pnpm/iu.test(executable) ? "pnpm" : "npm";
+  const packageManagerVersion = (await execFileAsync3(process.execPath, [executable, "--version"], {
+    cwd: projectDir
+  })).stdout.trim();
+  let directory = resolve4(projectDir);
+  let lock = null;
+  while (true) {
+    lock = await readFile13(
+      join12(
+        directory,
+        packageManager === "npm" ? "package-lock.json" : "pnpm-lock.yaml"
+      ),
+      "utf8"
+    ).catch((error) => {
+      if (error.code === "ENOENT") return null;
+      throw error;
+    });
+    if (lock !== null || dirname9(directory) === directory) break;
+    directory = dirname9(directory);
+  }
+  if (!lock)
+    throw new SiteplaneNextContractError(
+      "build_identity_missing",
+      "The provider build is missing the selected canonical lockfile."
+    );
+  console.info(
+    `SITEPLANE_BUILD_PROOF=${JSON.stringify({ node: process.versions.node, packageManager, packageManagerVersion, lockfileHash: `sha256:${createHash5("sha256").update(lock).digest("hex")}`, revision, fieldContractHash, siteplane: cli.version, runtimeNext: runtime.version, next: next.version, react: react.version })}`
+  );
+}
 export {
   SiteplaneNextContractError,
   scanNextProjectFieldContract,