Implement Run Execution Management (ISSUE-005)

[proboscis]

Summary

• Adds execution management features to runbox for observing and controlling running jobs
• Extends Run struct with status, runtime, session_ref, log_ref, timeline, exit_code, and pid fields
• Implements new CLI commands: ps, logs, stop, attach, _on-exit
• Enhances runbox run with --runtime flag for background, tmux, zellij, or foreground execution
• Maintains backward compatibility with existing JSON format

Key Features

Run Structure Extensions

• RunStatus: Pending, Running, Exited, Failed, Killed
• Runtime: Background (bg), Tmux, Zellij, Foreground
• LogRef: Path to log file for stdout/stderr capture
• Timeline: created_at, started_at, ended_at timestamps

New CLI Commands

Command	Description
runbox ps [--status <status>]	List running/recent runs
runbox logs <run_id>	Show run logs
runbox logs -f <run_id>	Follow log output
runbox stop <run_id>	Stop a running run
runbox attach <run_id>	Attach to tmux/zellij session

Enhanced runbox run

runbox run -t <template> --runtime bg      # Background process
runbox run -t <template> --runtime tmux    # Tmux session
runbox run -t <template> --runtime zellij  # Zellij session
runbox run -t <template> --runtime foreground  # Blocking execution

References

• Issue: ISSUE-005

Test plan

• All existing tests pass
• New Run struct tests for lifecycle management
• Backward compatibility test for old JSON format
• Manual testing of tmux/zellij integration
• Manual testing of background execution

🤖 Generated with Claude Code