Local static preview build runbook

Contact Capture Static Preview Build Runbook

Runbook only

Runbook Outcome

  • 1ready-for-static-preview-build-runbook-owner-review means command order is ready for owner review.
  • 2ready-for-more-local-review keeps visual review active without command-order approval.
  • 3changes-requested-static-preview-build-runbook sends the runbook back for local edits.
  • !blocked-static-preview-build-runbook appears if request evidence or safety confirmation is missing.

Evidence Required

  • 1/mobile-assistant-static-preview-build-request must return ready-for-static-preview-build-owner-review.
  • 2staticPreviewBuildRequestReference, packagingTargetRequestReference, and releaseReadinessReference must be present.
  • 3routeVerificationReference, browserVerificationReference, and baselineGitStatusReference must be present.
  • 4buildCommandTemplateReference, expectedArtifactDirectoryReference, artifactCleanupPlanReference, and postBuildVerificationPlanReference must be present.

Command Sequence

  • 1prepare-build-runbook prepares command order for owner review only.
  • 2continue-local-review keeps command planning paused; request-changes sends it back for local edits.
  • 3git status --short --branch (review baseline only).
  • !npm run build (not executed by this runbook).
  • 5npm run verify:local-preview-routes after a separately approved build.
  • 6npm run verify:mobile-assistant-static-preview-build-request-browser after a separately approved build.

Artifact Handling

  • 1Generated build output is review evidence, not a default commit target.
  • 2Do not commit build output unless the owner separately approves artifact handling.
  • 3Clean generated artifacts after review unless a separate retention reason exists.
  • !Never include credentials, raw contact data, OCR text, Google Contacts payloads, production payloads, or notification payloads in static artifacts.

Safety Confirmations

  • 1runbookOnly, ownerApprovalNotRecorded, noBuildStarted, and noCommandExecuted remain true.
  • 2noBuildArtifactCreated, noPackageInstall, noDeployStarted, noHostingChange, and noDnsChange remain true.
  • 3noLiveAdapters, noGoogleContacts, noN8nExecution, noCredentialAccess, and noProductionAccess remain true.
  • !strictControlRequiredForCommand is mandatory before any command execution.

Owner Decision Gates

  • 1decision-static-preview-build-command-window.
  • 2decision-static-preview-artifact-retention.
  • 3decision-static-preview-post-build-checks.
  • 4decision-static-preview-cleanup-owner.

Stop Rules

  • !No build command execution, package install, generated artifact write/retention, deploy, hosting, DNS, production, or native package.
  • !No service-worker cache expansion, live OCR, Google Contacts read/write, n8n/Contacts Agent execution, credential/token access, durable write, raw payload storage, or notification send.

Local Endpoints

  • 1/mobile-assistant-static-preview-build-runbook-policy lists command-runbook guardrails.
  • 2/mobile-assistant-static-preview-build-runbook-plan creates the runbook packet without execution.
  • 3/mobile-assistant-static-preview-build-strict-control-request prepares the next owner request without execution.
  • 4npm run verify:mobile-assistant-static-preview-build-runbook-browser checks this page visually.