Dispatch — Linear Backlog (ready to import)

Status: Phase 1 + Phase 2 created in Linear · Last updated: 2026-06-22

This doc mirrors the Phase 1 plan (docs/superpowers/plans/2026-06-15-dispatch-phase-1.md) and the design spec (docs/dispatch-production-design.md), and records the Linear issue ids once created.

Targets

Thing	Value
Team	`gravitas`
Label (new)	`dispatch` — color `#C1D841` (brand neon) — desc: "Dispatch — AI-augmented BPO cooperative OS"
Project	`Dispatch — Phase 1 (MVP Core)` — team `gravitas`, label `dispatch`
Issue label on every issue	`dispatch`
Link on every issue	the plan doc + relevant spec section

Creation order (tool calls)

list_teams → resolve gravitas team id.
list_issue_labels (filter dispatch) → create via create_issue_label if absent (team-scoped to gravitas).
save_project → create Dispatch — Phase 1 (MVP Core) in gravitas with label dispatch.
save_issue ×6 → the Phase 1 epics below (project set, label dispatch).
save_issue ×2 → the Phase 2 and Phase 3 roadmap tracking issues.
(Optional, on request) explode any epic into per-task sub-issues via save_issue with parentId.

Phase 1 epics (6 issues)

Each epic's description should carry its task checklist (below) plus: Plan: docs/superpowers/plans/2026-06-15-dispatch-phase-1.md and Spec: docs/dispatch-production-design.md.

Epic 1 — WS0: Foundation & infra scaffolding

Stand up the monorepo, Go API skeleton (+ Swagger), Angular shell (+ theme port), Supabase, and infra/CI skeletons.

[ ] 0.1 Monorepo + tooling skeleton (/api, /web, /supabase, /.github/workflows) — go build + ng build succeed, CI green on empty PR.
[ ] 0.2 Go API skeleton + /health + gin-swagger mounted at /swagger — httptest health test passes; swag init generates docs/swagger.json.
[ ] 0.3 Angular shell (zoneless, SSR/SSG) + design-system theme port (styles.css/bespoke.css, DaisyUI via PostCSS) — brand tokens render; theme toggle persists to dispatch_theme.
[ ] 0.4 Supabase project + migration tooling + Fly/Cloudflare configs (enable pgcrypto, vector) — supabase db reset clean; fly config validate passes.

Epic 2 — WS1: Auth & roles

Google Workspace OIDC via Supabase, Go JWT + role-guard, Angular auth + guards.

[ ] 1.1 Supabase Google Workspace OIDC + hosted-domain gate; public.users row on first sign-in with membership_role, OIDC name.
[ ] 1.2 Go JWT verify + RequireAuth/RequireRole middleware — tests: valid→ctx, invalid→401, role mismatch→403.
[ ] 1.3 Angular auth (login, OIDC callback, authGuard, roleGuard); admin button role-gated; session deferred to afterNextRender.

Epic 3 — WS2: Domain schema & migrations

Full Dispatch Postgres schema with role-aware authorization and seed.

[ ] 2.1 Core tables: organizations, mandates, tasks (gacx_reward display-only), skills, user_skills (0.00–10.00, coefficient), votes/vote_ballots, notifications.
[ ] 2.2 Role-aware RLS policies (Members own; MP/Admin all; validated_score MP-only) + authz matrix doc.
[ ] 2.3 Seed data matching the reference demo; sample mandate completion cross-checks WS3.3.

Epic 4 — WS3: Go API — CRUD engine + domain services

Generic CRUD + OpenAPI + completion + skills/validation + notifications.

[ ] 3.1 Generic crud[T] engine + per-entity schema (orgs/mandates/tasks/users); round-trip + validation + role tests.
[ ] 3.2 OpenAPI annotations + swag init generated spec + CI drift check.
[ ] 3.3 Completion service (Passed 100 · Live 60 · Progress 50 · Queued/Failed 0) — table-driven tests.
[ ] 3.4 Skills + user-skills + validation queue (MP-only Approve/Reject/Re-open; 0.00–10.00; coefficient).
[ ] 3.5 Notifications + Supabase Realtime publish (member-registration → MP alert; mark-read).

Epic 5 — WS4: Angular app

Typed client, schema-driven CRUD, admin console, member app, registration, connection indicator + PWA.

[ ] 4.1 Generated typed API client from swagger.json + auth/error interceptors.
[ ] 4.2 Schema-driven CRUD components (table, form-modal, delete-confirm, search, toasts).
[ ] 4.3 Admin console (dashboard + completion rings + breakdown, entities, validation queue, notifications slide-over) — routes 1:1 with design.md §8.
[ ] 4.4 Member app: Dispatch / Mandates / Tasks tabs (AI chat stubbed; Pulse/OKRs/Vote/Wallet placeholders); role-gated Admin button.
[ ] 4.5 Registration first-run flow (Profile from OIDC name → Skills typeahead → Review → Start → MP notification + validation queue).
[ ] 4.6 Connection indicator (ConnectionService on /health, afterNextRender) + PWA (@angular/service-worker, manifest/icons).

Epic 6 — WS5: Tests, CI/CD & deploy

Parity tests, e2e, pipeline, and first deploy.

[ ] 5.1 Shared-rule parity tests (completion + 0.00–10.00 competence) on Go and Angular.
[ ] 5.2 Playwright e2e: login→dispatch; registration→validation→MP approve.
[ ] 5.3 CI/CD: lint/test/build/e2e + deploy (Supabase migrations, Go API→Fly, Angular→Cloudflare); secrets in secret stores; tag phase-1.

Phase 2 — created in Linear (`Dispatch — Phase 2 (AI, Engagement & Governance)`)

Created 2026-06-22 as a sibling project to Phase 1, team gravitas, label dispatch. Four epics (parent issues, WS-numbering continued from Phase 1's WS5) with sub-issues. Each carries Spec: docs/dispatch-production-design.md §-refs. AI infra = High priority, the rest Medium; all start in Backlog.

Epic — WS6: Dispatch AI (RAG) · GAC-49

RAG pipeline (adapts docs/implementation/contract-qa/). Spec §7–§8.

[ ] 6.1 Python worker scaffold + Celery + Upstash Redis — GAC-53
[ ] 6.2 Document ingestion: PDF/Word/Excel → Markdown (MarkItDown) → chunk — GAC-54
[ ] 6.3 Embeddings + pgvector: Voyage, vector migration, top-k search — GAC-55
[ ] 6.4 Go API dispatch-ai: /ask + context assembly + SSE streaming — GAC-56
[ ] 6.5 Model routing + cost-tracking + semantic-cache layer — GAC-57
[ ] 6.6 Angular chat UI: browser-only SSE consumption + source citations — GAC-58
[ ] 6.7 Tests: pytest (stubbed Voyage) + Go handler tests + e2e — GAC-59

Epic — WS7: Governance voting · GAC-50

Proposals + one-member-one-vote YES/NO/Abstain + quorum/eligibility. Extends votes/vote_ballots. Spec §10, §12.

[ ] 7.1 Schema + RLS: proposals, ballots, quorum/eligibility config (+ define the rules) — GAC-60
[ ] 7.2 Go API: proposal CRUD, cast ballot, tally + quorum/eligibility — GAC-61
[ ] 7.3 Angular: Vote tab — proposals, cast YES/NO/Abstain, live tally — GAC-62
[ ] 7.4 Tests: Go handler/policy tests + e2e live vote — GAC-63

Epic — WS8: OKRs · GAC-51

Objectives + key results with derived progress rollup. Spec §10.

[ ] 8.1 Schema + RLS: objectives, key_results — GAC-64
[ ] 8.2 Go API: OKR CRUD + progress rollup — GAC-65
[ ] 8.3 Angular: OKRs tab — objectives + key results + progress — GAC-66
[ ] 8.4 Tests: Go handler tests + e2e — GAC-67

Epic — WS9: Pulse surveys · GAC-52

eNPS + anonymous breakdown; privacy review gates the schema. Spec §10, §12.

[ ] 9.1 Privacy review + Schema + RLS: surveys, questions, anonymized responses — GAC-68
[ ] 9.2 Go API: survey CRUD, anonymized submission, eNPS aggregation — GAC-69
[ ] 9.3 Angular: Pulse tab — take survey + eNPS results breakdown — GAC-70
[ ] 9.4 Tests: Go handler tests (incl. anonymity invariant) + e2e — GAC-71

Two product gates before build: 7.1 (GAC-60) needs the voting quorum + eligibility rules defined, and 9.1 (GAC-68) needs the pulse anonymity guarantee reviewed — both flagged in spec §12.

Phase 3 (final) — GACx wallet

Roadmap tracking issue (not yet created in Linear).

[ ] GACx double-entry ledger (accounts/transactions/postings, idempotent, 1:1 USD peg).
[ ] Wallet value-movement (deposit/withdraw/transfer, history); task Passed → reward posting.
[ ] On-chain settlement via SettlementProvider interface (chain choice, custody, peg mechanism — separate workstream).

Notes for the import

All issues: team gravitas, project Dispatch — Phase 1 (MVP Core) (Phase 1 epics) or a sibling project/Phase 2/Phase 3 milestone (roadmap issues), label dispatch, description in Markdown (literal newlines, no escaping).
Full per-task TDD detail (failing test → run → implement → pass → commit) lives in the plan doc; the epic checklists above are the issue-level summary. Per-task sub-issues can be generated on request.
Keep this doc in sync if the plan changes before import.

Dispatch — Linear Backlog (ready to import) ​

Targets ​

Creation order (tool calls) ​

Phase 1 epics (6 issues) ​

Epic 1 — WS0: Foundation & infra scaffolding ​

Epic 2 — WS1: Auth & roles ​

Epic 3 — WS2: Domain schema & migrations ​

Epic 4 — WS3: Go API — CRUD engine + domain services ​

Epic 5 — WS4: Angular app ​

Epic 6 — WS5: Tests, CI/CD & deploy ​

Phase 2 — created in Linear (Dispatch — Phase 2 (AI, Engagement & Governance)) ​

Epic — WS6: Dispatch AI (RAG) · GAC-49 ​

Epic — WS7: Governance voting · GAC-50 ​

Epic — WS8: OKRs · GAC-51 ​

Epic — WS9: Pulse surveys · GAC-52 ​

Phase 3 (final) — GACx wallet ​

Notes for the import ​