feat(taskctl): Autonomous task pipeline — Composer + Pulse + developer loop (#201)

[randomm]

Summary

Implements the full taskctl autonomous pipeline (EPIC #201, Phases #202–#208).

PM calls taskctl start <issueNumber> and the pipeline handles decomposition, development, adversarial review, and committing — automatically.

What's included

• Phase 1 (feat(taskctl): Phase 1 — Task store: types, storage, scheduler, validation, CRUD tool #202): Task store — types, atomic JSON writes, scheduler, validation, CRUD tool
• Phase 2 (feat(taskctl): Phase 2 — Composer agent: spec validation and task decomposition #203): Composer agent — LLM-based spec validation and task decomposition
• Phase 3a (feat(taskctl): Phase 3a — Pulse core loop: heartbeat, scheduling, singleton lock, crash recovery #204): Pulse core — 5-second deterministic loop, singleton lock, crash recovery, worktree lifecycle
• Phase 3b (feat(taskctl): Phase 3b — Developer + adversarial pipeline: verdict tool, retry loop, @ops commit #205): Developer/adversarial pipeline — taskctl verdict tool, retry loop (3 attempts), @ops commit, PM escalation
• Phase 3c (feat(taskctl): Phase 3c — PM-facing commands: status, stop, resume, override, retry, inspect #206): PM commands — stop, resume, inspect, override, retry
• Phase 4 (feat(taskctl): Phase 4 — Steering agent + timeout recovery #207): Steering agent — 15-minute progress checks, developer replacement, adversarial timeout recovery
• Phase 5 (feat(taskctl): Phase 5 — PM prompt migration and agent definitions into codebase #208): Agent definitions in codebase (developer-pipeline, adversarial-pipeline, steering) + AGENTS.md documentation

New files

packages/opencode/src/tasks/
  types.ts          — Task, Job, AdversarialVerdict types
  store.ts          — Atomic file-based persistence
  scheduler.ts      — Dependency + conflict-aware scheduling
  validation.ts     — Cycle detection
  composer.ts       — LLM task decomposition
  pulse.ts          — Deterministic pipeline loop
  tool.ts           — taskctl CLI tool (19 commands)
  index.ts          — Module exports

packages/opencode/test/tasks/
  store.test.ts, scheduler.test.ts, validation.test.ts
  composer.test.ts, pulse.test.ts, pipeline.test.ts
  steering.test.ts, commands.test.ts

Key design decisions

• Pulse is deterministic TypeScript (setInterval), not LLM — fast and predictable
• Tasks stored as JSON files in ~/.local/share/opencode/tasks/<projectId>/
• Singleton lock file prevents double-Pulse on restart
• Adversarial writes structured JSON verdict via taskctl verdict (not text)
• 3-strike escalation: APPROVED→commit, ISSUES_FOUND→retry (max 3), then PM notified
• Steering evaluated every 15 min per task: continue / steer (send guidance) / replace

Testing

• 8 test files covering all new modules
• Known gaps tracked in issues test(taskctl): improve pipeline.test.ts to cover processAdversarialVerdicts state machine #220, test(taskctl): pipeline.test.ts uses hardcoded /tmp path — switch to tmpdir() fixture #221, test(taskctl): add edge case tests for Pulse tick concurrency and crash recovery #225

Open issues for follow-up

• test(taskctl): improve pipeline.test.ts to cover processAdversarialVerdicts state machine #220 — Improve pipeline.test.ts state machine coverage
• test(taskctl): pipeline.test.ts uses hardcoded /tmp path — switch to tmpdir() fixture #221 — Switch pipeline.test.ts to tmpdir() fixture
• refactor(taskctl): split pulse.ts and tool.ts — both exceed 500-line module limit #224 — Refactor pulse.ts + tool.ts (both exceed 500-line limit)
• test(taskctl): add edge case tests for Pulse tick concurrency and crash recovery #225 — Add Pulse edge case tests (tick concurrency, crash recovery)

Closes #201 #202 #203 #204 #205 #206 #207 #208

[randomm]

Reopening to trigger CI webhook