fleet-stop

Your objective is to stop a running CocoFleet.

Before proceeding, verify that .cocoplus/ exists. If not: output "CocoPlus not initialized in this directory. Run $pod init to begin." Then stop.

Parse argument: $fleet stop [fleet-id] If no fleet-id: output "Usage: $fleet stop [fleet-id]" Then stop.

Read .cocoplus/fleet/[fleet-id]-state.json. If not found: output "Fleet state not found for [fleet-id]." Then stop.

Terminate Running Instances

For each instance with status == "running":

1. Read PID from state.json
2. Terminate the process using cross-platform Node.js via the Bash tool:

   node -e "try{process.kill([pid],'SIGTERM')}catch(e){}" 
   

3. Wait up to 10 seconds for graceful shutdown, checking liveness each second:

   node -e "
     const pid=[pid];
     let waited=0;
     const iv=setInterval(()=>{
       try{process.kill(pid,0);waited++;}
       catch(e){clearInterval(iv);}
       if(waited>=10){try{process.kill(pid,'SIGKILL')}catch(_){}clearInterval(iv);}
     },1000);"
   

4. Update state.json: status = "stopped", completed_at = [timestamp]

Write Stop Record

Write .cocoplus/fleet/[fleet-id]-stop-record.md:

# Fleet Stop Record

**Fleet ID:** [fleet-id]
**Stopped At:** [ISO 8601 timestamp]

## Instances Stopped
| Instance | Last Status | Last Checkpoint | PID |
|----------|-------------|-----------------|-----|
[one row per stopped instance]

Output: "Fleet [fleet-id] stopped. [N] processes terminated. Stop record: .cocoplus/fleet/[fleet-id]-stop-record.md."

Anti-Rationalization

Shortcut / Temptation	Why It Fails
Skip SIGKILL after SIGTERM timeout	A process that ignores SIGTERM will keep running and orphan log files; SIGKILL ensures termination
Update state.json before sending signals	State must reflect reality — only mark "stopped" after confirming the process is dead
Skip writing the stop record	The stop record is audit evidence; missing it means no trace of when/why the fleet was halted

Exit Criteria

• All instances previously in "running" state now have status: "stopped" in .cocoplus/fleet/[fleet-id]-state.json
• .cocoplus/fleet/[fleet-id]-stop-record.md exists with a list of stopped instances
• No PIDs from the fleet remain alive (verified with node -e "process.kill([pid],0)" returning an error)