docs(phase4): Cloud Run activation prompt + mark Phase 4 merged

[jeffgreendesign]

Phase 4 — activation docs

Phase 4 (async upload processing via Cloud Tasks) is merged (#99, #102, #101). This adds the maintainer-facing activation guidance and updates the trackers. Docs only — no code changes.

What changed

• New docs/plans/2026-06-06-phase4-cloud-run-activation.md — a verified, copy-paste agent prompt to finish prod activation (set the 4 Cloud Tasks env vars + raise the Cloud Run timeout to 600), plus a live-state table and a smoke-test checklist.
• Edit infra/cloud-tasks/README.md — links to the activation doc and corrects the now-stale note (GCS_UPLOAD_BUCKET is already set on the service; Phase 3 storage is active).
• Edit docs/plans/2026-05-31-large-upload-gcs-resumable-plan.md — Phase 4 tracker marked merged, with a pointer to the activation doc.

Verified live state (from gcloud, kept OUT of the committed docs)

The code is already deployed (image 0e42895 = main HEAD; auto-deploy via Cloud Build); queue, invoker SA, bucket, and all IAM bindings exist; only the 4 env vars + timeout remain.

Privacy

This is a public repo. The live Cloud Run URL, gcloud account, and unrelated project name are intentionally not committed — the prompt resolves the service URL at run time via gcloud run services describe. Sensitive-literal scan + markdownlint + docs-check + security-check all clean.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
dashboard	Building	Preview, Comment	Jun 10, 2026 5:10pm
textrawl	Ready	Preview, Comment	Jun 10, 2026 5:10pm

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: f84082e4-ce35-4077-bcc3-c31daa84df57

📥 Commits

Reviewing files that changed from the base of the PR and between f30c05d and e47f163.

📒 Files selected for processing (3)

• docs/plans/2026-05-31-large-upload-gcs-resumable-plan.md
• docs/plans/2026-06-06-phase4-cloud-run-activation.md
• infra/cloud-tasks/README.md

✅ Files skipped from review due to trivial changes (3)

• infra/cloud-tasks/README.md
• docs/plans/2026-05-31-large-upload-gcs-resumable-plan.md
• docs/plans/2026-06-06-phase4-cloud-run-activation.md

---

Walkthrough

This PR adds documentation to support Phase 4 production activation. It introduces a new Cloud Run activation runbook that documents the current infrastructure state (deployment, service URL, service account, Cloud Tasks queue, GCS bucket configuration, and IAM permissions), specifies the exact command to set four missing environment variables and increase request timeout to 600, and includes verification steps (OIDC check plus end-to-end upload test) and a rollback command. Supporting updates mark Phase 4 code as merged in the progress tracker and update the Cloud Tasks README to reference the new activation documentation and clarify that the GCS bucket variable is already configured.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Description check	❓ Inconclusive	The description provides a clear summary of changes, explains what files were modified, and notes that this is documentation-only with no code changes. However, it does not follow the repository's pull request template structure (missing checklist items and 'Type of Change' section).	Consider structuring the description to align with the repository template, including the checklist items and Type of Change section, even though some (like typecheck/pnpm dev) may not apply to docs-only changes.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main changes: adding Phase 4 cloud activation prompt documentation and marking Phase 4 as merged in the progress tracker.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/phase4-activation-prompt

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}