Run NestQuest orchestration directly in the terminal (#151)

Co-authored-by: orchestrator-agent <orchestrator@cubecraftlabs.com> Co-committed-by: orchestrator-agent <orchestrator@cubecraftlabs.com>
2026-09-22 21:35:30 -04:00
parent 8ddae78551
commit b5c2b55d9b
16 changed files with 270 additions and 213 deletions
@@ -1,44 +0,0 @@
-#!/usr/bin/env bash
-# Manually control the durable NestQuest development cycle from OpenCode.
-set -euo pipefail
-
-if [[ $# -ne 1 ]]; then
-  echo "usage: nq-cycle start|stop|status" >&2
-  exit 64
-fi
-
-unit=nestquest-controller.service
-controller=/home/overseer/.local/share/nestquest-controller/scripts/nq-controller
-
-show_status() {
-  systemctl --user show "$unit" -p ActiveState -p SubState -p UnitFileState
-  if [[ -f /home/overseer/.local/state/nestquest-controller/last-run.json ]]; then
-    python3 -c 'import json,pathlib; p=pathlib.Path.home()/".local/state/nestquest-controller/last-run.json"; d=json.loads(p.read_text()); print("LastTickState="+str(d.get("state","unknown"))); print("LastTickTime="+str(d.get("time","unknown")))'
-  fi
-}
-
-case "$1" in
-  start)
-    systemctl --user start "$unit"
-    show_status
-    if session_status=$("$controller" --check-interactive); then
-      echo "$session_status"
-      if [[ "$session_status" == "interactive NestQuest session open" ]]; then
-        echo "Close the interactive NestQuest OpenCode session to let the controller run its first tick."
-      fi
-    else
-      echo "The controller will wait for OpenCode session detection to recover."
-    fi
-    ;;
-  stop)
-    systemctl --user stop "$unit"
-    show_status
-    ;;
-  status)
-    show_status
-    ;;
-  *)
-    echo "usage: nq-cycle start|stop|status" >&2
-    exit 64
-    ;;
-esac
@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# Launch the NestQuest orchestrator immediately in the foreground terminal.
+set -euo pipefail
+
+if [[ $# -gt 1 ]]; then
+  echo "usage: nq-orchestrate [MISSION_PROMPT_FILE|-|--print-prompt]" >&2
+  exit 64
+fi
+
+control_home=${NQ_CONTROL_HOME:-/home/overseer/.local/share/nestquest-controller}
+project=${NQ_PROJECT_ROOT:-/mnt/ai-storage/projects/NestQuest}
+opencode_bin=${OPENCODE_BIN:-/home/overseer/.opencode/bin/opencode}
+systemctl_bin=${SYSTEMCTL_BIN:-systemctl}
+renderer="$control_home/scripts/render-cycle-prompt"
+profile="$control_home/templates/nestquest.profile.json"
+
+for required in "$renderer" "$profile"; do
+  [[ -e "$required" ]] || { echo "missing required path: $required" >&2; exit 66; }
+done
+
+prompt=$("$renderer" "$profile")
+if [[ ${1:-} == "--print-prompt" ]]; then
+  printf '%s\n' "$prompt"
+  exit 0
+fi
+for required in "$project" "$opencode_bin" "$control_home/.opencode/agents/terminal-orchestrator.md"; do
+  [[ -e "$required" ]] || { echo "missing required path: $required" >&2; exit 66; }
+done
+if [[ $# -eq 1 ]]; then
+  if [[ "$1" == "-" ]]; then
+    mission=$(cat)
+  else
+    [[ -f "$1" ]] || { echo "mission prompt not found: $1" >&2; exit 66; }
+    mission=$(cat "$1")
+  fi
+  [[ -n "${mission//[[:space:]]/}" ]] || { echo "mission prompt is empty" >&2; exit 65; }
+  prompt+=$'\n\n---\n\n# USER MISSION\n\n'
+  prompt+="$mission"
+fi
+
+# Foreground mode owns orchestration. A dormant service must never race it.
+"$systemctl_bin" --user stop nestquest-controller.service
+
+session_status=$("$control_home/scripts/nq-controller" --check-interactive --project "$project")
+if [[ "$session_status" == "interactive NestQuest session open" ]]; then
+  echo "Another interactive NestQuest OpenCode session is open." >&2
+  echo "Close it, then run nq-orchestrate again." >&2
+  exit 75
+fi
+
+export OPENCODE_CONFIG_DIR="$control_home/.opencode"
+exec "$opencode_bin" "$project" --pure --agent terminal-orchestrator --prompt "$prompt"