by:resume

/resume -- Resume Campaign from Last Checkpoint

Resume an interrupted or failed campaign from its most recent checkpoint.

Instructions

This command reads checkpoint files to determine exactly where the campaign stopped, then dispatches the appropriate agent to continue from that point.

Step 1: Find the campaign directory

CAMPAIGN_DIR=$(cat .by/active_campaign 2>/dev/null || echo "")

If no active campaign is set, scan .by/campaigns/ for the most recently modified campaign directory. If multiple campaigns exist, list them and ask the user which one to resume.

Step 2: Read checkpoint files

Scan $CAMPAIGN_DIR/checkpoints/ for checkpoint files. They are named by phase with numeric prefix for ordering:

checkpoints/
  00_draft.json           -- campaign created
  01_configured.json      -- plan approved, parameters set
  02_designing.json       -- jobs submitted (includes job_ids)
  03_design_complete.json -- results received
  04_screening.json       -- screening started
  05_screening_complete.json -- scores computed
  06_ranking.json         -- composite scores computed
  07_complete.json        -- campaign done

Identify the latest checkpoint file (highest numeric prefix). This is the resume point.

Step 3: Read checkpoint contents

Each checkpoint file contains:

{
  "phase": "designing",
  "timestamp": "2026-03-24T15:00:00Z",
  "campaign_id": "pd-l1-20260324-150000",
  "completed_actions": ["research", "plan_approval", "job_submission"],
  "pending_actions": ["monitor_jobs", "collect_results"],
  "job_ids": ["by_boltzgen_abc123"],
  "partial_results": {
    "designs_received": 5,
    "designs_expected": 20,
    "designs_scored": 3
  },
  "next_action": "poll_job_status",
  "agent_to_dispatch": "by-design",
  "resume_context": "Jobs submitted to Tamarind. 5/20 designs returned before interruption."
}

Step 4: Build resume plan

Present the resume plan to the user:

------------------------------------------------------
 BY > RESUME CAMPAIGN
------------------------------------------------------

**Campaign:** {campaign_id}
**Last checkpoint:** {phase} ({timestamp})
**Interrupted at:** {resume_context}

**Completed phases:**
{for each completed_action: "  * {action}"}

**Resume action:** {next_action}
**Agent:** {agent_to_dispatch}

**Partial results (if any):**
- Designs received: {designs_received}/{designs_expected}
- Designs scored: {designs_scored}

------------------------------------------------------
> Type "go" to resume, or describe adjustments
------------------------------------------------------