Files
proxmox/docs/00-meta/PARALLEL_TASK_STRUCTURE.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands
- CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround
- CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check
- NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere
- MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates
- LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 15:46:57 -08:00

7.3 KiB

Parallel Task Structure

Purpose: Enable maximum automation by removing artificial order-of-operations blockers.
Principle: Split large tasks into smaller atomic units; mark real vs fake dependencies; group by parallel cohort.

Full remaining work (all TODOs): For the complete list of remaining items ordered for full maximum parallel mode (Wave 0 → Wave 1 → Wave 2 → Wave 3), see FULL_PARALLEL_EXECUTION_ORDER.md. Run all items in the same wave concurrently.


Parallel Cohorts

Tasks in the same cohort have no dependencies on each other and can run in parallel.

Cohort A — Immediate (no blockers)

ID Task File/Scope Automation
A1 Add env check to e-signature.ts the-order/services/legal-documents Edit
A2 Add env check to court-efiling.ts the-order/services/legal-documents Edit
A3 Add ISSUER_DID env to identity the-order/services/identity Edit
A4 Add env stub to OCR placeholder the-order/packages/workflows Edit
A5 Add env stub to approval placeholder the-order/packages/workflows Edit
A6 Add OIDC env vars to shared auth the-order/packages/shared Edit
A7 Add DID env to auth/did.ts the-order/packages/auth Edit
A8 Create ISO deploy script (forge) smom-dbis-138/scripts New file
A9 Add Uniswap env stub alltra-lifi-settlement Edit
A10 Add Curve env stub alltra-lifi-settlement Edit
A11 Add payment-intent env stub alltra-lifi-settlement Edit
A12 Create OMNIS EntityList.test.tsx OMNIS New file
A13 Create OMNIS TreasuryCharts.test.tsx OMNIS New file
A14 Add GlobalSearch mock for tests OMNIS Edit
A15 Fix dbis JsonValue type (one module) dbis_core Edit
A16 Create Prometheus scrape config smom-dbis-138/monitoring Edit
A17 Create verify-websocket standalone script scripts/verify Edit
A18 Add .env vars to IP_CENTRALIZATION docs Edit

Cohort B — After Cohort A (or parallel if A not needed)

ID Task File/Scope Depends On
B1 Finance DB persistence (schema) the-order/packages/database None
B2 Dataroom document metadata save the-order/services/dataroom None
B3 Identity VC verification logic the-order/services/identity A3
B4 Vault test VLT-001 only smom-dbis-138/test None
B5 ISO test ISO-001 only smom-dbis-138/test None
B6 Bridge BRG-VLT deposit token smom-dbis-138/contracts None
B7 Bridge BRG-ISO deposit token smom-dbis-138/contracts None
B8 OMNIS cash flow chart stub OMNIS None
B9 OMNIS Gantt stub OMNIS None
B10 dbis IRU SES env stub dbis_core None
B11 dbis IRU sanctions env stub dbis_core None
B12 NPMplus backup cron script scripts None
B13 Phase 3 CCIP Ops script skeleton scripts/deployment None
B14 Phase 4 tenant script skeleton scripts/deployment None

Cohort C — Independent external integrations

Each can run in parallel; no cross-deps:

ID Task Blocker
C1 Li.Fi SDK integration API key
C2 LayerZero integration API/config
C3 Uniswap routing (real) RPC, pool addresses
C4 DocuSign e-signature API key
C5 MoonPay fiat on-ramp API key
C6 Ramp Network fiat API key

Cohort D — Infrastructure (SSH-able; can parallelize by host)

ID Task Host Depends On
D1 Verify ml110 containers ml110 SSH
D2 Verify r630-01 containers r630-01 SSH
D3 Verify r630-02 containers r630-02 SSH
D4 Backup NPMplus (if NPM_PASSWORD) r630-01 SSH, creds
D5 Export Prometheus targets r630-01 SSH

Dependency Rules

Fake dependencies (ignore for parallelization)

  • Phase 2 before Phase 3 → Observability config can be done alongside CCIP scripts
  • Vault tests before deployment → Deploy script can exist without tests passing
  • Auth before frontend charts → Chart stubs need no auth
  • DB before Finance service → Env stubs work without DB
  • BRG-VLT before BRG-ISO → Independent contract changes

Real dependencies (must respect)

  • CCIP commit nodes → need CCIP Ops/Admin (true infra dep)
  • NPMplus backup → needs NPM_PASSWORD (creds)
  • Real API calls → need API keys (creds)
  • Forge deploy → needs PRIVATE_KEY, RPC_URL (creds)

Task Splitting Guide

Monolithic Task Split Into
"Vault tests VLT-001 to VLT-009" VLT-001, VLT-002, … VLT-009 (9 parallel tasks)
"ISO tests ISO-001 to ISO-008" ISO-001, … ISO-008 (8 parallel tasks)
"Bridge BRG-VLT, BRG-ISO, BRG-EM" BRG-VLT, BRG-ISO, BRG-EM (3 parallel)
"CCIP Fleet" Ops script, Commit script, Execute script, RMN script (4 parallel scripts)
"dbis TypeScript fixes" By file: fix file1.ts, fix file2.ts, …
"OMNIS unit tests" Header, EntityList, TreasuryCharts, … (one test file each)
"the-order Identity" Env stub, VC issuance, verification, KMS (4 parallel)
"Documentation consolidation" By doc folder: 01-, 02-, 03-, … (parallel by section)

Execution Model

  1. Cohort A → Run all in parallel (no shared state).
  2. Cohort B → Run in parallel; some reference A outputs but can use defaults.
  3. Cohort C → Run when credentials available; independent of each other.
  4. Cohort D → Run per-host in parallel; SSH to ml110, r630-01, r630-02 concurrently.

Completed (2026-01-31)

Cohort A: A1-A2 (e-signature, court-efiling already had env checks), A3 (VC_ISSUER_DID exists), A4-A7 (workflows, auth env stubs), A8 (deploy-iso4217w-system.sh), A9-A11 (alltra env stubs), A12-A14 (EntityList, TreasuryCharts, GlobalSearch tests), A16 (scrape-proxmox.yml), A17 (verify-websocket exists), A18 (IP_CENTRALIZATION, .env.example).

Cohort B: B1-B2 (Finance/Dataroom DB wired), B12 (npmplus-backup-cron.sh), B13-B14 (phase3-ccip-ops.sh, phase4-sovereign-tenants.sh), B6-B7 (register-vault-deposit-tokens.sh, register-iso-deposit-tokens.sh), B8-B9 (TreasuryCharts, ProjectTimeline exist), B10-B11 (SES/sanctions env in dbis).

Cohort D: D4 (backup-npmplus ran successfully), D5 (export-prometheus-targets.sh, targets-proxmox.yml). PROXMOX_* added to .env.

Completed (2026-02-01): dbis_core deployment-orchestrator syntax fix; ari-reflex duplicate props; prisma generate. alltra-lifi-settlement: env.example, TypeScript fixes, workspace add, build passing. multi-chain-execution: Express router type annotations (build passing). OMNIS: vitest testTimeout 20s, hookTimeout 15s, MSW onUnhandledRequest bypass. smom: forge:test, forge:test:vault, forge:test:iso scripts.

dbis_core TypeScript Phases 1-4 (2026-01-31): Phase 1 (imports, route returns), Phase 2 (JsonValue, unknown, reduce types), Phase 3 (Prisma props, express.d.ts, null safety), Phase 4 (schema mismatches, gdsl-settlement, uhem-analytics). ~1186 TS errors remain. See REMAINING_TASKS_MASTER.


Automation Script

A runner can:

  • Parse this file for Cohort A/B task IDs
  • For each task: pnpm exec cursor-agent --task "A1" (or similar)
  • Collect results; proceed to next cohort
  • Never block A2 on A1, B2 on B1, etc.