docs: daily update 2026-08-05 — release v4.181.0

[deco-cms]

Summary

Daily docs check for release v4.181.0 (previous: v4.180.1).

Note: this PR is branched from docs/auto-update-2026-08-05-release-4.180.0 (PR #5740), the most recently created open docs-automation PR at the time this ran. Merge #5740 first (and its own dependency, #5738), then this one, to avoid conflicts.

Commits covered (v4.180.1...v4.181.0)

• ff15bbe5e — feat(task-board): auto-task subscription paywall UI + billing settings (feat(task-board): auto-task subscription paywall UI + billing settings #5731) — warranted a docs update
• 54563ea01 — feat(commerce-onboarding): gate Shopify card behind ?shopify search param (feat(commerce-onboarding): gate Shopify card behind ?shopify search param #5743) — skipped: internal rollout flag hiding an unreleased companion behind an unlisted query param; no stable, documented workflow it affects
• 54d243103 — [chore]: bump homebrew cask to 4.180.1 — skipped (release bot version bump only)
• 773197910 — [release]: bump changed workspace versions — skipped (release bot version bump only)

Doc files changed

• studio/task-board.mdx (en + pt-br): added a new Billing and auto-task quota section — free trial (3 lifetime runs), paid subscription ($50/month, 10 runs/cycle), the 5-run per-task cap, the three paywall dialog variants (trial exhausted / monthly exhausted / task run limit), and where to manage billing (Settings → Billing).
• studio/self-hosting/deploy/docker-compose.mdx (en + pt-br): added the STUDIO_TASK_QUOTA_ENFORCED, STUDIO_FREE_TASKS, STUDIO_MONTHLY_TASKS, and STUDIO_MAX_RUNS_PER_TASK environment variables to the table, cross-linked from the new Task Board section. These back the feature this release surfaces in the UI; self-hosted deployments are unmetered by default.

pt-br was auto-translated, keeping UI labels, code, and product terms (Super Agent, Task Board, Settings → Billing, etc.) in English per the doc conventions already used on these pages.

Consistency notes

• Checked concepts.mdx, architecture.mdx, and ai-providers.mdx for Task Board / Super Agent / billing references — all are high-level mentions unaffected by this specific paywall/billing detail, no changes needed.
• No user-management.mdx or built-in-tools reference doc changes: the new ORGANIZATION_TASK_QUOTA_GET / ORGANIZATION_BILLING_CHECKOUT_START / ORGANIZATION_BILLING_PORTAL tools are internal reads/writes backing the Billing settings page (not part of the Decopilot built-in tool surface documented in decopilot/tools.mdx), so no addition made there.
• STUDIO_TASK_QUOTA_ENFORCED backend support actually landed in an earlier release (feat(billing): gate reports-task executions behind the org subscription #5663) without a matching self-hosting doc update; since this release is what makes the feature user-visible (Settings → Billing UI, paywall dialog), the env var docs were added now rather than left stale.

---

Release: v4.180.1...v4.181.0 compare · CI run: https://github.com/decocms/studio/actions/runs/31013516023

---

Summary by cubic

Docs update for release v4.181.0. Adds a full Task Board guide with auto-task billing/quota and updates across agents, AI providers, runtime/architecture, and self-hosting.

• New Features

  • Task Board: new page covering comments, multi-repo runs, automated reviewers, auto-merge/ship-to-prod, report findings, and Super Agent billing/quota (trial 3 runs; subscription $50/mo for 10; 5 re-runs per task; manage under Settings → Billing).
  • Agents & CMS: Files and skills (25MB per file), Fast Preview and CMS settings reorg, GitHub fork support in repo picker, Studio Native coding-agent terminals with local CLIs, worktree reclaim on archive, and blocks-form description tooltip toggle.
  • AI & runtime: claude-code sandbox harness for hosted runs; link your personal Claude Pro/Max under Settings → AI Providers to pay for your own sandbox coding runs.
  • Architecture: documented hosted harnesses and removal of the desktop tier; clarified live NATS use.
  • Security/health: block private-network URLs for Custom Connections; automations auto-deactivate on unrecoverable errors with a clear reason in Monitoring.
  • Self-hosting/K8s: sandbox daemon OTLP metrics opt-in; sandbox image is now studio-sandbox-go only.

• Migration

  • Auth is env-only: configure via AUTH_* variables; don’t mount auth-config.json.
  • Optional billing: new STUDIO_TASK_QUOTA_ENFORCED, STUDIO_FREE_TASKS, STUDIO_MONTHLY_TASKS, STUDIO_MAX_RUNS_PER_TASK, and STUDIO_TOPUP_FEE_PERCENT vars (self-hosted stays unmetered unless enabled).
  • Helm: set sandbox image to ghcr.io/decocms/studio/studio-sandbox-go; no TypeScript daemon switch.
  • K8s telemetry: if enabled, provide the collector ClusterIP (telemetry.otlp.ip) and port (4318/4317).

^{Written for commit 7fdc2d8. Summary will update on new commits.}