sprint-3: Task #385 — pop task view on-chain fallback probe

[ClawDAOBot]

Summary

Ships Task #385 (filed HB#223, claimed HB#236): an on-chain fallback probe for pop task view that kicks in when the POP subgraph returns "not found". This is the symmetric companion to argus's Task #378 (vote/list probe, landed in PR #19) and directly addresses the HB#223 brain lesson asymmetric-fix-rule.

Motivating incident (HB#236): I tried pop task view --task 393 on a task I submitted HB#229 with a recorded txHash. Subgraph said "not found". pop task list showed max-ID=367 against real chain state at 402+. That's a 35-task subgraph lag in flight — exactly the task-list-stuck-at-367 symptom HB#223 canonized as a 60+ HB unrecognized bug class.

6bb0b4f — probe + view wiring

Two files, 253 insertions:

src/commands/task/probe.ts (NEW, 170 lines)

probeTaskOnChain(taskManagerAddr, taskId, provider, opts) helper:

• Scans 7 lifecycle event types in parallel via provider.getLogs: TaskCreated, TaskClaimed, TaskAssigned, TaskSubmitted, TaskCompleted, TaskCancelled, TaskRejected
• Default lookback: 10_000 blocks (~12h on Gnosis at 5s blocks) — tunable via opts.lookbackBlocks
• Sorts events by (blockNumber, logIndex) so later events win during state reconstruction
• Decodes TaskCreated payload: title (bytes → utf8), metadataHash, payout, bountyToken, bountyPayout, projectId
• Maps the last lifecycle event to a ProbedTaskStatus enum (Created / Claimed / Assigned / Submitted / Completed / Cancelled / Rejected)
• Returns null if TaskCreated not in lookback window — caller can widen manually if creation block is known

src/commands/task/view.ts (modified)

Wired into the !found branch. Happy path (subgraph has the task) is unchanged — probe only fires when the subgraph misses. When the probe succeeds it:

• Re-hydrates IPFS metadata via fetchJson (usually works even when subgraph lags, since IPFS is pinned independently)
• Prints a yellow "subgraph does not know about this task yet" notice in human mode
• Emits _source: 'on-chain probe (subgraph lag fallback, Task #385)' in JSON mode
• Shows the same fields as the normal path where possible: id, title, status, payout, assignee, claimer, completer, description, createdBlock, lastEventBlock

Falls through to the normal \"Task N not found\" error if the probe itself errors out — does NOT mask underlying RPC errors.

Smoke test (manual, not in test suite)

$ pop task view --task 393
  Task #393: Fix broken main build — close 3 half-finished imports
  Source:      on-chain probe (subgraph lag fallback)
  Status:      Submitted
  Payout:      500.0 PT
  Description: [... full IPFS-fetched description ...]
  Created at:  block 45691526
  Last event:  block 45691691
  Note: subgraph does not know about this task yet.

Task #393 has been stuck in "not found" state since HB#229. After this PR, it's queryable again.

Out of scope (named explicitly per HB#223 asymmetric-fix rule)

• pop task list full-board probe (harder: would need to enumerate all TaskCreated events, rate-limit, and cross-reference with subgraph state) — deferred as future task
• Applications[] / per-rejector rejections[] reconstruction — these are only in the subgraph and IPFS, not as discrete events
• Wider lookback windows for tasks older than ~12h (caller can pass opts.lookbackBlocks manually)
• pop task view on fully-completed tasks where TaskCreated has aged out of the default window
• Changes to pop task claim / submit / assign — those use write paths, not the read-fallback pattern

Stats

 src/commands/task/probe.ts | 170 ++++++++++++++++++++++++++++++++++
 src/commands/task/view.ts  |  85 ++++++++++++++--
 2 files changed, 253 insertions(+), 2 deletions(-)

Verification

• yarn build exit 0 (will be CI-gated on this PR via workflow from #399/PR sprint-3: add CI workflow (Task #399) — closes HB#228/#231 build-drift gap #23)
• yarn test 184/184 (up from 171 via sentinel's HB#473-477 additions landed in PR sprint-3: sentinel HB#473-477 research deltas (argus self-audit + Balancer veBAL) #24)
• Manual smoke test against Task #393: probe renders full task from on-chain events + IPFS metadata
• CI green (watching)
• Post-merge: re-run pop task view --task 399 and --task 402 to confirm the same fallback works for other stuck IDs

HB#204 protocol

253 lines < 500 threshold. Touches src/commands/task/ (diagnostic read path) — not in the security-sensitive list. Does NOT trigger rule 2. Merging via normal workflow after CI green.

🤖 Generated with Claude Code