Shared helpers for formula-driven cron agents: lock, memory guard, formula loading, context building, session startup, crash recovery. - planner-run.sh uses shared helpers instead of inline code - gardener-agent.sh delegates crash recovery to formula_phase_callback - agent-smoke.sh updated for renamed planner script + new lib file Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
120 lines
5.6 KiB
Bash
Executable file
120 lines
5.6 KiB
Bash
Executable file
#!/usr/bin/env bash
|
|
# =============================================================================
|
|
# planner-run.sh — Cron wrapper: direct planner execution via Claude + formula
|
|
#
|
|
# Runs weekly (or on-demand). Guards against concurrent runs and low memory.
|
|
# Creates a tmux session with Claude (opus) reading formulas/run-planner.toml.
|
|
# No action issues — the planner is a nervous system component, not work.
|
|
#
|
|
# The planner plans for ALL projects (harb + disinto) but is itself disinto
|
|
# infrastructure — always sources projects/disinto.toml.
|
|
# =============================================================================
|
|
set -euo pipefail
|
|
|
|
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
|
|
FACTORY_ROOT="$(dirname "$SCRIPT_DIR")"
|
|
|
|
# Source disinto project config — the planner is disinto infrastructure
|
|
export PROJECT_TOML="$FACTORY_ROOT/projects/disinto.toml"
|
|
# shellcheck source=../lib/env.sh
|
|
source "$FACTORY_ROOT/lib/env.sh"
|
|
# shellcheck source=../lib/agent-session.sh
|
|
source "$FACTORY_ROOT/lib/agent-session.sh"
|
|
# shellcheck source=../lib/formula-session.sh
|
|
source "$FACTORY_ROOT/lib/formula-session.sh"
|
|
|
|
LOG_FILE="$SCRIPT_DIR/planner.log"
|
|
SESSION_NAME="planner-${PROJECT_NAME}"
|
|
PHASE_FILE="/tmp/planner-session-${PROJECT_NAME}.phase"
|
|
|
|
# shellcheck disable=SC2034 # read by monitor_phase_loop in lib/agent-session.sh
|
|
PHASE_POLL_INTERVAL=15
|
|
|
|
log() { echo "[$(date -u +%Y-%m-%dT%H:%M:%S)Z] $*" >> "$LOG_FILE"; }
|
|
|
|
# ── Guards ────────────────────────────────────────────────────────────────
|
|
acquire_cron_lock "/tmp/planner-run.lock"
|
|
check_memory 2000
|
|
|
|
log "--- Planner run start ---"
|
|
|
|
# ── Load formula + context ───────────────────────────────────────────────
|
|
load_formula "$FACTORY_ROOT/formulas/run-planner.toml"
|
|
build_context_block VISION.md AGENTS.md RESOURCES.md
|
|
|
|
# ── Read planner memory ─────────────────────────────────────────────────
|
|
MEMORY_BLOCK=""
|
|
MEMORY_FILE="$FACTORY_ROOT/planner/MEMORY.md"
|
|
if [ -f "$MEMORY_FILE" ]; then
|
|
MEMORY_BLOCK="
|
|
### planner/MEMORY.md (persistent memory from prior runs)
|
|
$(cat "$MEMORY_FILE")
|
|
"
|
|
fi
|
|
|
|
# ── Build prompt ─────────────────────────────────────────────────────────
|
|
PROMPT="You are the strategic planner for ${CODEBERG_REPO}. Work through the formula below. You MUST write PHASE:done to '${PHASE_FILE}' when finished — the orchestrator will time you out if you return to the prompt without signalling.
|
|
|
|
## Project context
|
|
${CONTEXT_BLOCK}${MEMORY_BLOCK}
|
|
|
|
## Formula
|
|
${FORMULA_CONTENT}
|
|
|
|
## Codeberg API reference
|
|
Base URL: ${CODEBERG_API}
|
|
Auth header: -H \"Authorization: token \$CODEBERG_TOKEN\"
|
|
Read issue: curl -sf -H \"Authorization: token \$CODEBERG_TOKEN\" '${CODEBERG_API}/issues/{number}' | jq '.body'
|
|
Create issue: curl -sf -X POST -H \"Authorization: token \$CODEBERG_TOKEN\" -H 'Content-Type: application/json' '${CODEBERG_API}/issues' -d '{\"title\":\"...\",\"body\":\"...\",\"labels\":[LABEL_ID]}'
|
|
Relabel: curl -sf -H \"Authorization: token \$CODEBERG_TOKEN\" -X PUT -H 'Content-Type: application/json' '${CODEBERG_API}/issues/{number}/labels' -d '{\"labels\":[LABEL_ID]}'
|
|
Comment: curl -sf -H \"Authorization: token \$CODEBERG_TOKEN\" -X POST -H 'Content-Type: application/json' '${CODEBERG_API}/issues/{number}/comments' -d '{\"body\":\"...\"}'
|
|
Close: curl -sf -H \"Authorization: token \$CODEBERG_TOKEN\" -X PATCH -H 'Content-Type: application/json' '${CODEBERG_API}/issues/{number}' -d '{\"state\":\"closed\"}'
|
|
List labels: curl -sf -H \"Authorization: token \$CODEBERG_TOKEN\" '${CODEBERG_API}/labels'
|
|
NEVER echo or include the actual token value in output — always reference \$CODEBERG_TOKEN.
|
|
|
|
## Environment
|
|
FACTORY_ROOT=${FACTORY_ROOT}
|
|
PROJECT_REPO_ROOT=${PROJECT_REPO_ROOT}
|
|
PRIMARY_BRANCH=${PRIMARY_BRANCH}
|
|
|
|
## Phase protocol (REQUIRED)
|
|
When all work is done:
|
|
echo 'PHASE:done' > '${PHASE_FILE}'
|
|
On unrecoverable error:
|
|
printf 'PHASE:failed\nReason: %s\n' 'describe error' > '${PHASE_FILE}'"
|
|
|
|
# ── Create tmux session ─────────────────────────────────────────────────
|
|
export CLAUDE_MODEL="opus"
|
|
if ! start_formula_session "$SESSION_NAME" "$PROJECT_REPO_ROOT" "$PHASE_FILE"; then
|
|
exit 1
|
|
fi
|
|
|
|
agent_inject_into_session "$SESSION_NAME" "$PROMPT"
|
|
log "Prompt sent to tmux session"
|
|
matrix_send "planner" "Planner session started for ${CODEBERG_REPO}" 2>/dev/null || true
|
|
|
|
# ── Phase monitoring loop ────────────────────────────────────────────────
|
|
log "Monitoring phase file: ${PHASE_FILE}"
|
|
_FORMULA_CRASH_COUNT=0
|
|
|
|
monitor_phase_loop "$PHASE_FILE" 7200 "formula_phase_callback"
|
|
|
|
FINAL_PHASE=$(read_phase "$PHASE_FILE")
|
|
log "Final phase: ${FINAL_PHASE:-none}"
|
|
|
|
if [ "$FINAL_PHASE" != "PHASE:done" ]; then
|
|
case "${_MONITOR_LOOP_EXIT:-}" in
|
|
idle_prompt)
|
|
log "planner: Claude returned to prompt without writing phase signal"
|
|
;;
|
|
idle_timeout)
|
|
log "planner: timed out after 2h with no phase signal"
|
|
;;
|
|
*)
|
|
log "planner finished without PHASE:done (phase: ${FINAL_PHASE:-none}, exit: ${_MONITOR_LOOP_EXIT:-})"
|
|
;;
|
|
esac
|
|
fi
|
|
|
|
matrix_send "planner" "Planner session finished (${FINAL_PHASE:-no phase})" 2>/dev/null || true
|
|
log "--- Planner run done ---"
|