Task lifecycle (end-to-end)
This page is the canonical overview of how a task moves through Pairag after the May 2026 release. Use the sidebar for create / join / submit / accept guides; open Gold (fiat) transactions for USD escrow. Client labels may differ slightly, but all map to the same numeric status machine.
Happy path (typical)
- Draft — owner edits manifest, stages, Points bounties, and optional gold (USD) list amounts in the app (manual form or AI-assisted V18 JSON).
- Submit for platform review — task becomes *pending review*; content safety and structure checks run. Owners may be charged a submit fee in Points when configured.
- Recruiting — task is public; candidates apply per stage. Owner admits assignees and runs the alignment meeting (scope, IO, constraints).
- Readiness gates — when every stage has an assignee and alignment is *ready*, the product freezes delivery deposits (Points) and, for gold stages, Stripe pre-authorization plus Connect onboarding for assignees.
- Pending deposit (if needed) — task waits here until all required deposits / pre-auths succeed; owners can retry from the app.
- In progress — assignees deliver per stage (upload bundles, chat, optional artifact scan jobs). Owners may be notified on pre-auth state changes in chat.
- Accepting — when every non-cancelled stage has requested review, the task enters the acceptance pool. Owners (or review stages) approve or reject per stage.
- Review / wrap-up — after all stages reach a terminal outcome, the task enters a review window for continuation tasks, reputation settlement, and the optional G1 collaboration discussion period before completed or dissolved.
Task statuses (API values 1–10)
Numeric status values below. **Stage** statuses are separate (e.g. stage review overdue on a stage, not the same as task terminated).
- 1 Draft — editable; not visible for recruiting.
- 2 Pending review — submitted; awaiting platform approval.
- 3 Recruiting — open applications; alignment sub-state tracks meeting progress.
- 4 Pending deposit — alignment ready but deposits / gold pre-auth not complete.
- 5 In progress — gates cleared; stages execute in parallel where allowed.
- 6 Accepting — all required stages are in the review pool.
- 7 Review — wrap-up window (continuation tasks, G1, reputation).
- 8 Completed — legacy compatibility path; new flows prefer dissolve after review.
- 9 Terminated — timeout or forced stop; gold pre-auths are voided per policy.
- 10 Dissolved — normal closure after review window or owner dissolve when rules allow.
Alignment sub-state (orthogonal)
While recruiting, `alignment_status` tracks the meeting: 0 not started (e.g. missing assignee), 1 pending confirmations, 2 ready to start (Points: signatures done; gold: signatures + pre-auth + Connect), 3 failed (may require re-recruiting; existing gold pre-auth may be voided).
Stage-level flow (summary)
- Assignee works → uploads deliverable bundle → may trigger artifact scan (async; failures surface on the bundle).
- Assignee calls request review; owner confirms or rejects (gold capture only on owner confirm + funds password when required—no auto-capture on idle deadline for gold).
- Points bounties release on approved stages; gold follows Stripe capture, platform fee, cooling, then Connect payout.
Gold (fiat) transactions — See **Gold (fiat) transactions** for formulas, Stripe dashboards, and cooling period.