feat(task-board): task-based flow behind taskBasedFlow flag

[guitavano]

Summary

Operate a repo-bound site entirely in terms of Tasks, hiding Git (branches, PRs, sync). All gated behind the org flag taskBasedFlow (off by default), toggleable in Settings → Organization → Experimental.

Web

• Task pill replaces the branch picker in the workspace header, with the task board as source of truth: names the current task, filters by column (Backlog / A Fazer / … / Concluído, defaulting to the current task's column), switches tasks, and creates new ones. Only renders for repo-bound agents.
• New-task dialog (describe → agent runs it, or edit manually → fresh CMS branch). Each task gets its own branch (generateBranchName); "edit manually" opens a fresh branch straight in the CMS (chat closed, ?cms=1 auto-opens the editor).
• Hides Git surfaces under the flag: branch picker, "Sincronizar", open-in-board button.
• Repo selector in the task dialog's Properties.

API

• task_board_items gains repo_owner/repo_name (migration 169) so a task is scoped to its site; threaded through storage, create/update tools, and schemas.
• Review lifecycle fix: repo-backed tasks advance to In Review only via the PR-open hook, never on thread-finish (In Review with no PR is the wrong state). Keyed on the task's repoOwner, since CMS threads carry no repo metadata of their own.
• TASK_BOARD_ITEM_UPDATE gains linkPr (mirrors linkThreadId) so the CMS submit-for-review flow — which opens PRs outside an agent run — links the PR and advances the task to In Review.

Testing

• Unit: review-advance gate (repo-backed / repo-named vs repo-less), repo helpers. All green.
• Real-Postgres (CI): repo round-trip through create/update, repo-named no-advance-on-finish, PR link + advance (idempotent).
• bun run fmt clean; tsc clean in apps/api, apps/web, packages/shared; lint clean on touched files.

Notes / follow-ups

• packages/shared/src/tools/tool-io.ts was hand-patched (the contract generator is degraded in this dev env). Re-run bun run --cwd=apps/api generate:tool-contracts in a full env to confirm output matches.
• linkPr on TASK_BOARD_ITEM_UPDATE mirrors the existing linkThreadId; open to moving it to a dedicated un-gated TASK_BOARD_ITEM_PR_LINK if preferred (discussed).
• Two pre-existing tasks created before the branch-isolation fix share a branch (data, not code).

🤖 Generated with Claude Code

---

Summary by cubic

Task-based flow behind the taskBasedFlow org flag: the workspace operates in Tasks (not branches), each task gets its own branch and optional repo scope, and the CMS submit-for-review path links the PR and moves the task to In Review. All Git surfaces stay hidden under the flag.

• Adds taskBasedFlow toggle in Settings → Organization → Experimental.

• Replaces the branch picker with a task pill for repo-bound agents: shows the current task, filters by column, switches tasks, and creates new tasks via prompt (agent run) or manual edit (fresh CMS branch; chat closed; ?cms=1 opens the editor). Each task starts on a fresh branch.

• Hides Git surfaces under the flag (branch picker, Sync, open-in-board).

• Task dialog includes a repo selector; tasks store a single repo slug (owner/name) for scoping.

• TASK_BOARD_ITEM_UPDATE accepts linkPr to associate a PR and set status to In Review; the publish dialog calls this when it opens a PR (idempotent).

• Migration

  • DB: add repo (owner/name) to task_board_items (migration 170).
  • Regenerate tool contracts if needed: run bun run --cwd=apps/api generate:tool-contracts.
  • Flag is off by default; enable per org.

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