feat(ops): launchd jobs (nightly + market-open) + caffeinate + install scripts

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016DvdRZkyCy9NJpHYDdPqmS

scripts/execute.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+# launchd wrapper for the market-open execution (08:30 CT = 09:30 ET). Gated on Alpaca's clock.
+cd /Users/aryan/Documents/GitHub/trading-agent
+export PATH="/opt/homebrew/bin:$PATH"
+mkdir -p state/logs
+exec uv run python -m execution.run_market_open >> state/logs/launchd_execution.log 2>&1

scripts/install_launchd.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# Install the launchd jobs (caffeinate, nightly research, market-open execution).
+set -euo pipefail
+PROJ="/Users/aryan/Documents/GitHub/trading-agent"
+LA="$HOME/Library/LaunchAgents"
+mkdir -p "$LA" "$PROJ/state/logs"
+chmod +x "$PROJ/scripts/nightly.sh" "$PROJ/scripts/execute.sh"
+
+for p in caffeinate nightly market_open; do
+  cp "$PROJ/launchd/ai.tradingagent.$p.plist" "$LA/"
+  launchctl unload "$LA/ai.tradingagent.$p.plist" 2>/dev/null || true
+  launchctl load "$LA/ai.tradingagent.$p.plist"
+  echo "loaded ai.tradingagent.$p"
+done
+
+cat <<'EOF'
+
+── ONE-TIME MANUAL STEP (needs sudo) ─────────────────────────────
+Wake the Mac nightly at 23:55 CT so the 00:00 job can fire:
+
+  sudo pmset repeat wakeorpoweron MTWRFSU 23:55:00
+
+── REQUIREMENTS for overnight runs ───────────────────────────────
+  • plugged into AC power
+  • lid OPEN (caffeinate can't beat clamshell sleep on a laptop)
+  • logged in (lock screen is fine; logged out = jobs won't run)
+  • oMLX running with a model available (it auto-starts on login)
+  • .env populated with Alpaca paper + Finnhub keys
+──────────────────────────────────────────────────────────────────
+EOF

scripts/nightly.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+# launchd wrapper for the nightly research run (00:00 CT).
+cd /Users/aryan/Documents/GitHub/trading-agent
+export PATH="/opt/homebrew/bin:$PATH"
+mkdir -p state/logs
+exec uv run python -m orchestration.run_nightly >> state/logs/launchd_nightly.log 2>&1

scripts/run_dashboard.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# Launch the local dashboard: uv run streamlit run web/dashboard.py
+set -euo pipefail
+cd "$(dirname "$0")/.."
+exec uv run streamlit run web/dashboard.py "$@"

scripts/uninstall_launchd.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+# Remove the launchd jobs and print how to clear the wake schedule.
+set -euo pipefail
+LA="$HOME/Library/LaunchAgents"
+for p in caffeinate nightly market_open; do
+  launchctl unload "$LA/ai.tradingagent.$p.plist" 2>/dev/null || true
+  rm -f "$LA/ai.tradingagent.$p.plist"
+  echo "removed ai.tradingagent.$p"
+done
+echo
+echo "Also clear the nightly wake schedule (needs sudo):"
+echo "  sudo pmset repeat cancel"