@jonit-dev/night-watch-cli 1.0.0

package/dist/utils/ui.js

@@ -0,0 +1,121 @@
+/**
+ * UI utilities for Night Watch CLI
+ * Provides colored output, spinners, and table formatting
+ */
+import chalk from "chalk";
+import ora from "ora";
+import Table from "cli-table3";
+/**
+ * Print a success message with green check prefix
+ */
+export function success(msg) {
+    console.log(chalk.green("✔"), msg);
+}
+/**
+ * Print an error message with red cross prefix
+ */
+export function error(msg) {
+    console.log(chalk.red("✖"), msg);
+}
+/**
+ * Print a warning message with yellow warning prefix
+ */
+export function warn(msg) {
+    console.log(chalk.yellow("⚠"), msg);
+}
+/**
+ * Print an info message with cyan info prefix
+ */
+export function info(msg) {
+    console.log(chalk.cyan("ℹ"), msg);
+}
+/**
+ * Print a bold section header with underline
+ */
+export function header(title) {
+    const line = "─".repeat(Math.max(40, title.length + 4));
+    console.log();
+    console.log(chalk.bold(title));
+    console.log(chalk.dim(line));
+}
+/**
+ * Print dimmed text for secondary information
+ */
+export function dim(msg) {
+    console.log(chalk.dim(msg));
+}
+/**
+ * Format and print a key-value pair with consistent alignment
+ */
+export function label(key, value) {
+    const paddedKey = key.padEnd(18);
+    console.log(`  ${chalk.dim(paddedKey)}${value}`);
+}
+/**
+ * Create an ora spinner instance
+ */
+export function createSpinner(text) {
+    return ora({
+        text,
+        spinner: "dots",
+    });
+}
+/**
+ * Create a configured cli-table3 instance with sensible defaults
+ */
+export function createTable(options) {
+    const defaultOptions = {
+        chars: {
+            top: "─",
+            "top-mid": "┬",
+            "top-left": "┌",
+            "top-right": "┐",
+            bottom: "─",
+            "bottom-mid": "┴",
+            "bottom-left": "└",
+            "bottom-right": "┘",
+            left: "│",
+            "left-mid": "├",
+            mid: "─",
+            "mid-mid": "┼",
+            right: "│",
+            "right-mid": "┤",
+            middle: "│",
+        },
+        style: {
+            "padding-left": 1,
+            "padding-right": 1,
+            head: ["cyan"],
+            border: ["dim"],
+        },
+    };
+    return new Table({ ...defaultOptions, ...options });
+}
+/**
+ * Format status indicator: green running or dim not running
+ */
+export function formatRunningStatus(running, pid) {
+    if (running) {
+        return chalk.green(`● Running (PID: ${pid})`);
+    }
+    if (pid) {
+        return chalk.dim(`○ Stale lock (PID: ${pid})`);
+    }
+    return chalk.dim("○ Not running");
+}
+/**
+ * Format installed status: green installed or yellow not installed
+ */
+export function formatInstalledStatus(installed) {
+    if (installed) {
+        return chalk.green("✔ Installed");
+    }
+    return chalk.yellow("⚠ Not installed");
+}
+/**
+ * Print a step message with step number
+ */
+export function step(current, total, msg) {
+    console.log(chalk.dim(`[${current}/${total}]`), msg);
+}
+//# sourceMappingURL=ui.js.map

package/dist/utils/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/utils/ui.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@jonit-dev/night-watch-cli",
+  "version": "1.0.0",
+  "description": "Autonomous PRD execution using AI Provider CLIs + cron",
+  "type": "module",
+  "bin": {
+    "night-watch": "./bin/night-watch.mjs"
+  },
+  "main": "./dist/cli.js",
+  "exports": {
+    ".": {
+      "import": "./dist/cli.js",
+      "types": "./dist/cli.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "dev": "tsx src/cli.ts",
+    "prepublishOnly": "npm run build && npm test",
+    "publish:npm": "npm publish --access public"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "scripts/",
+    "templates/"
+  ],
+  "keywords": [
+    "claude",
+    "codex",
+    "ai",
+    "prd",
+    "automation",
+    "cron",
+    "cli",
+    "night-watch"
+  ],
+  "author": "Joao Pio",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/joaopio/night-watch-cli.git"
+  },
+  "homepage": "https://github.com/joaopio/night-watch-cli#readme",
+  "bugs": {
+    "url": "https://github.com/joaopio/night-watch-cli/issues"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^12.0.0",
+    "ora": "^9.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/scripts/night-watch-cron.sh

@@ -0,0 +1,148 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Night Watch Cron Runner (project-agnostic)
+# Usage: night-watch-cron.sh /path/to/project
+# Finds the next eligible PRD and passes it to the configured AI provider for implementation.
+#
+# NOTE: This script expects environment variables to be set by the caller.
+# The Node.js CLI will inject config values via environment variables.
+# Required env vars (with defaults shown):
+#   NW_MAX_RUNTIME=7200          - Maximum runtime in seconds (2 hours)
+#   NW_PROVIDER_CMD=claude       - AI provider CLI to use (claude, codex, etc.)
+#   NW_DRY_RUN=0                 - Set to 1 for dry-run mode (prints diagnostics only)
+
+PROJECT_DIR="${1:?Usage: $0 /path/to/project}"
+PROJECT_NAME=$(basename "${PROJECT_DIR}")
+PRD_DIR="${PROJECT_DIR}/docs/PRDs/night-watch"
+LOG_DIR="${PROJECT_DIR}/logs"
+LOG_FILE="${LOG_DIR}/night-watch.log"
+LOCK_FILE="/tmp/night-watch-${PROJECT_NAME}.lock"
+MAX_RUNTIME="${NW_MAX_RUNTIME:-7200}"  # 2 hours
+MAX_LOG_SIZE="524288"  # 512 KB
+PROVIDER_CMD="${NW_PROVIDER_CMD:-claude}"
+
+# Ensure NVM / Node / Claude are on PATH
+export NVM_DIR="${HOME}/.nvm"
+[ -s "${NVM_DIR}/nvm.sh" ] && . "${NVM_DIR}/nvm.sh"
+
+# NOTE: Environment variables should be set by the caller (Node.js CLI).
+# The .env.night-watch sourcing has been removed - config is now injected via env vars.
+
+mkdir -p "${LOG_DIR}"
+
+# Load shared helpers
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=night-watch-helpers.sh
+source "${SCRIPT_DIR}/night-watch-helpers.sh"
+
+# Validate provider
+if ! validate_provider "${PROVIDER_CMD}"; then
+  echo "ERROR: Unknown provider: ${PROVIDER_CMD}" >&2
+  exit 1
+fi
+
+rotate_log
+
+if ! acquire_lock "${LOCK_FILE}"; then
+  exit 0
+fi
+
+cleanup_worktrees "${PROJECT_DIR}"
+
+ELIGIBLE_PRD=$(find_eligible_prd "${PRD_DIR}")
+
+if [ -z "${ELIGIBLE_PRD}" ]; then
+  log "SKIP: No eligible PRDs (all done, in-progress, or blocked)"
+  exit 0
+fi
+
+PRD_NAME="${ELIGIBLE_PRD%.md}"
+BRANCH_NAME="night-watch/${PRD_NAME}"
+DEFAULT_BRANCH=$(detect_default_branch "${PROJECT_DIR}")
+
+log "START: Processing ${ELIGIBLE_PRD} on branch ${BRANCH_NAME}"
+
+cd "${PROJECT_DIR}"
+
+PROMPT="Implement the PRD at docs/PRDs/night-watch/${ELIGIBLE_PRD}
+
+## Setup
+- Branch name MUST be exactly: ${BRANCH_NAME}
+- Create the branch from ${DEFAULT_BRANCH}: git checkout ${DEFAULT_BRANCH} && git pull origin ${DEFAULT_BRANCH} && git checkout -b ${BRANCH_NAME}
+- Use a git worktree: git worktree add ../${PROJECT_NAME}-nw-${PRD_NAME} ${BRANCH_NAME}
+- cd into the worktree, install dependencies
+
+## Implementation — PRD Executor Workflow
+Read .claude/commands/prd-executor.md and follow its FULL execution pipeline:
+1. Parse the PRD into phases and extract dependencies
+2. Build a dependency graph to identify parallelism
+3. Create a task list with one task per phase
+4. Execute phases in parallel waves using agent swarms — launch ALL independent phases concurrently
+5. Run the project's verify/test command between waves to catch issues early
+6. After all phases complete, run final verification and fix any issues
+Follow all CLAUDE.md conventions (if present).
+
+## Finalize
+- Commit all changes, push, and open a PR:
+  git push -u origin ${BRANCH_NAME}
+  gh pr create --title \"feat: <short title>\" --body \"<summary referencing PRD>\"
+- After PR is created, clean up: git worktree remove ../${PROJECT_NAME}-nw-${PRD_NAME}
+- Do NOT move the PRD to done/ — the cron script handles that
+- Do NOT process any other PRDs — only ${ELIGIBLE_PRD}"
+
+# Dry-run mode: print diagnostics and exit
+if [ "${NW_DRY_RUN:-0}" = "1" ]; then
+  log "DRY-RUN: Would process ${ELIGIBLE_PRD}"
+  log "DRY-RUN: Provider: ${PROVIDER_CMD}"
+  log "DRY-RUN: Runtime: ${MAX_RUNTIME}s"
+  echo "=== Dry Run: PRD Executor ==="
+  echo "Provider:    ${PROVIDER_CMD}"
+  echo "Eligible PRD: ${ELIGIBLE_PRD}"
+  echo "Branch:      ${BRANCH_NAME}"
+  echo "Timeout:     ${MAX_RUNTIME}s"
+  exit 0
+fi
+
+case "${PROVIDER_CMD}" in
+  claude)
+    timeout "${MAX_RUNTIME}" \
+      claude -p "${PROMPT}" \
+        --dangerously-skip-permissions \
+        >> "${LOG_FILE}" 2>&1
+    ;;
+  codex)
+    timeout "${MAX_RUNTIME}" \
+      codex --quiet \
+        --yolo \
+        --prompt "${PROMPT}" \
+        >> "${LOG_FILE}" 2>&1
+    ;;
+  *)
+    log "ERROR: Unknown provider: ${PROVIDER_CMD}"
+    exit 1
+    ;;
+esac
+
+EXIT_CODE=$?
+
+if [ ${EXIT_CODE} -eq 0 ]; then
+  PR_EXISTS=$(gh pr list --state open --json headRefName --jq '.[].headRefName' 2>/dev/null | grep -cF "${BRANCH_NAME}" || echo "0")
+  if [ "${PR_EXISTS}" -gt 0 ]; then
+    mark_prd_done "${PRD_DIR}" "${ELIGIBLE_PRD}"
+    git -C "${PROJECT_DIR}" add -A docs/PRDs/night-watch/
+    git -C "${PROJECT_DIR}" commit -m "chore: mark ${ELIGIBLE_PRD} as done (PR opened on ${BRANCH_NAME})
+
+Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>" || true
+    git -C "${PROJECT_DIR}" push origin "${DEFAULT_BRANCH}" || true
+    log "DONE: ${ELIGIBLE_PRD} implemented, PR opened, PRD moved to done/"
+  else
+    log "WARN: ${PROVIDER_CMD} exited 0 but no PR found on ${BRANCH_NAME} — PRD NOT moved to done"
+  fi
+elif [ ${EXIT_CODE} -eq 124 ]; then
+  log "TIMEOUT: Night watch killed after ${MAX_RUNTIME}s while processing ${ELIGIBLE_PRD}"
+  cleanup_worktrees "${PROJECT_DIR}"
+else
+  log "FAIL: Night watch exited with code ${EXIT_CODE} while processing ${ELIGIBLE_PRD}"
+  cleanup_worktrees "${PROJECT_DIR}"
+fi

package/scripts/night-watch-helpers.sh

@@ -0,0 +1,155 @@
+#!/usr/bin/env bash
+# Night Watch helper functions — shared by cron scripts.
+# Source this file, don't execute it directly.
+
+# ── Provider validation ───────────────────────────────────────────────────────
+
+# Validates that the provider command is supported.
+# Returns 0 if valid, 1 if unknown.
+# Supported providers: claude, codex
+validate_provider() {
+  local provider="${1:?provider required}"
+  case "${provider}" in
+    claude|codex)
+      return 0
+      ;;
+    *)
+      return 1
+      ;;
+  esac
+}
+
+# ── Logging ──────────────────────────────────────────────────────────────────
+
+log() {
+  local log_file="${LOG_FILE:?LOG_FILE not set}"
+  echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" >> "${log_file}"
+}
+
+# ── Log rotation ─────────────────────────────────────────────────────────────
+
+rotate_log() {
+  local log_file="${LOG_FILE:?LOG_FILE not set}"
+  local max_size="${MAX_LOG_SIZE:-524288}"
+
+  if [ -f "${log_file}" ] && [ "$(stat -c%s "${log_file}" 2>/dev/null || echo 0)" -gt "${max_size}" ]; then
+    mv "${log_file}" "${log_file}.old"
+  fi
+}
+
+# ── Lock management ──────────────────────────────────────────────────────────
+
+acquire_lock() {
+  local lock_file="${1:?lock_file required}"
+
+  if [ -f "${lock_file}" ]; then
+    local lock_pid
+    lock_pid=$(cat "${lock_file}" 2>/dev/null || echo "")
+    if [ -n "${lock_pid}" ] && kill -0 "${lock_pid}" 2>/dev/null; then
+      log "SKIP: Previous run (PID ${lock_pid}) still active"
+      return 1
+    fi
+    log "WARN: Stale lock file found (PID ${lock_pid}), removing"
+    rm -f "${lock_file}"
+  fi
+
+  trap "rm -f '${lock_file}'" EXIT
+  echo $$ > "${lock_file}"
+  return 0
+}
+
+# ── Detect default branch ───────────────────────────────────────────────────
+
+detect_default_branch() {
+  local project_dir="${1:?project_dir required}"
+  git -C "${project_dir}" symbolic-ref refs/remotes/origin/HEAD 2>/dev/null \
+    | sed 's@^refs/remotes/origin/@@' || echo "master"
+}
+
+# ── Find next eligible PRD ───────────────────────────────────────────────────
+
+find_eligible_prd() {
+  local prd_dir="${1:?prd_dir required}"
+  local done_dir="${prd_dir}/done"
+
+  local prd_files
+  prd_files=$(find "${prd_dir}" -maxdepth 1 -name '*.md' ! -name 'NIGHT-WATCH-SUMMARY.md' -type f 2>/dev/null | sort)
+
+  if [ -z "${prd_files}" ]; then
+    return 0
+  fi
+
+  local open_branches
+  open_branches=$(gh pr list --state open --json headRefName --jq '.[].headRefName' 2>/dev/null || echo "")
+
+  for prd_path in ${prd_files}; do
+    local prd_file
+    prd_file=$(basename "${prd_path}")
+    local prd_name="${prd_file%.md}"
+
+    # Skip if a PR already exists for this PRD
+    if echo "${open_branches}" | grep -qF "${prd_name}"; then
+      log "SKIP-PRD: ${prd_file} — open PR already exists"
+      continue
+    fi
+
+    # Check dependencies
+    local depends_on
+    depends_on=$(grep -i 'depends on' "${prd_path}" 2>/dev/null \
+      | head -1 \
+      | grep -oP '[a-z0-9_-]+\.md' || echo "")
+    if [ -n "${depends_on}" ]; then
+      local dep_met=true
+      for dep_file in ${depends_on}; do
+        if [ ! -f "${done_dir}/${dep_file}" ]; then
+          log "SKIP-PRD: ${prd_file} — unmet dependency: ${dep_file}"
+          dep_met=false
+          break
+        fi
+      done
+      if [ "${dep_met}" = false ]; then
+        continue
+      fi
+    fi
+
+    echo "${prd_file}"
+    return 0
+  done
+}
+
+# ── Clean up worktrees ───────────────────────────────────────────────────────
+# Removes any worktrees with "-nw-" in the path (night-watch worktrees).
+
+cleanup_worktrees() {
+  local project_dir="${1:?project_dir required}"
+  local project_name
+  project_name=$(basename "${project_dir}")
+
+  git -C "${project_dir}" worktree list --porcelain 2>/dev/null \
+    | grep '^worktree ' \
+    | awk '{print $2}' \
+    | grep "${project_name}-nw" \
+    | while read -r wt; do
+        log "CLEANUP: Removing leftover worktree ${wt}"
+        git -C "${project_dir}" worktree remove --force "${wt}" 2>/dev/null || true
+      done || true
+}
+
+# ── Mark PRD as done ─────────────────────────────────────────────────────────
+
+mark_prd_done() {
+  local prd_dir="${1:?prd_dir required}"
+  local prd_file="${2:?prd_file required}"
+  local done_dir="${prd_dir}/done"
+
+  mkdir -p "${done_dir}"
+
+  if [ -f "${prd_dir}/${prd_file}" ]; then
+    mv "${prd_dir}/${prd_file}" "${done_dir}/${prd_file}"
+    log "DONE-PRD: Moved ${prd_file} to done/"
+    return 0
+  else
+    log "WARN: PRD file not found: ${prd_dir}/${prd_file}"
+    return 1
+  fi
+}

package/scripts/night-watch-pr-reviewer-cron.sh

@@ -0,0 +1,135 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Night Watch PR Reviewer Cron Runner (project-agnostic)
+# Usage: night-watch-pr-reviewer-cron.sh /path/to/project
+#
+# NOTE: This script expects environment variables to be set by the caller.
+# The Node.js CLI will inject config values via environment variables.
+# Required env vars (with defaults shown):
+#   NW_REVIEWER_MAX_RUNTIME=3600 - Maximum runtime in seconds (1 hour)
+#   NW_PROVIDER_CMD=claude       - AI provider CLI to use (claude, codex, etc.)
+#   NW_DRY_RUN=0                 - Set to 1 for dry-run mode (prints diagnostics only)
+
+PROJECT_DIR="${1:?Usage: $0 /path/to/project}"
+PROJECT_NAME=$(basename "${PROJECT_DIR}")
+LOG_DIR="${PROJECT_DIR}/logs"
+LOG_FILE="${LOG_DIR}/night-watch-pr-reviewer.log"
+LOCK_FILE="/tmp/night-watch-pr-reviewer-${PROJECT_NAME}.lock"
+MAX_RUNTIME="${NW_REVIEWER_MAX_RUNTIME:-3600}"  # 1 hour
+MAX_LOG_SIZE="524288"  # 512 KB
+PROVIDER_CMD="${NW_PROVIDER_CMD:-claude}"
+
+# Ensure NVM / Node / Claude are on PATH
+export NVM_DIR="${HOME}/.nvm"
+[ -s "${NVM_DIR}/nvm.sh" ] && . "${NVM_DIR}/nvm.sh"
+
+# NOTE: Environment variables should be set by the caller (Node.js CLI).
+# The .env.night-watch sourcing has been removed - config is now injected via env vars.
+
+mkdir -p "${LOG_DIR}"
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=night-watch-helpers.sh
+source "${SCRIPT_DIR}/night-watch-helpers.sh"
+
+# Validate provider
+if ! validate_provider "${PROVIDER_CMD}"; then
+  echo "ERROR: Unknown provider: ${PROVIDER_CMD}" >&2
+  exit 1
+fi
+
+rotate_log
+
+if ! acquire_lock "${LOCK_FILE}"; then
+  exit 0
+fi
+
+cd "${PROJECT_DIR}"
+
+OPEN_PRS=$(gh pr list --state open --json headRefName --jq '.[].headRefName' 2>/dev/null | grep -E '^(feat/|night-watch/)' | wc -l)
+
+if [ "${OPEN_PRS}" -eq 0 ]; then
+  log "SKIP: No open night-watch/ or feat/ PRs to review"
+  exit 0
+fi
+
+NEEDS_WORK=0
+REPO=$(gh repo view --json nameWithOwner --jq '.nameWithOwner' 2>/dev/null)
+PRS_NEEDING_WORK=""
+
+while IFS=$'\t' read -r pr_number pr_branch; do
+  FAILED_CHECKS=$(gh pr checks "${pr_number}" 2>/dev/null | grep -ci 'fail' || true)
+  if [ "${FAILED_CHECKS}" -gt 0 ]; then
+    log "INFO: PR #${pr_number} (${pr_branch}) has ${FAILED_CHECKS} failed CI check(s)"
+    NEEDS_WORK=1
+    PRS_NEEDING_WORK="${PRS_NEEDING_WORK} #${pr_number}"
+    continue
+  fi
+
+  ALL_COMMENTS=$(
+    {
+      gh pr view "${pr_number}" --json comments --jq '.comments[].body' 2>/dev/null
+      gh api "repos/${REPO}/issues/${pr_number}/comments" --jq '.[].body' 2>/dev/null
+    } | sort -u
+  )
+  LATEST_SCORE=$(echo "${ALL_COMMENTS}" \
+    | grep -oP 'Overall Score:\*?\*?\s*(\d+)/100' \
+    | tail -1 \
+    | grep -oP '\d+(?=/100)' || echo "")
+  if [ -n "${LATEST_SCORE}" ] && [ "${LATEST_SCORE}" -lt 80 ]; then
+    log "INFO: PR #${pr_number} (${pr_branch}) has review score ${LATEST_SCORE}/100"
+    NEEDS_WORK=1
+    PRS_NEEDING_WORK="${PRS_NEEDING_WORK} #${pr_number}"
+  fi
+done < <(gh pr list --state open --json number,headRefName --jq '.[] | select(.headRefName | test("^(feat/|night-watch/)")) | [.number, .headRefName] | @tsv' 2>/dev/null)
+
+if [ "${NEEDS_WORK}" -eq 0 ]; then
+  log "SKIP: All ${OPEN_PRS} open PR(s) have passing CI and review score >= 80 (or no score yet)"
+  exit 0
+fi
+
+log "START: Found PR(s) needing work:${PRS_NEEDING_WORK}"
+
+cleanup_worktrees "${PROJECT_DIR}"
+
+# Dry-run mode: print diagnostics and exit
+if [ "${NW_DRY_RUN:-0}" = "1" ]; then
+  echo "=== Dry Run: PR Reviewer ==="
+  echo "Provider: ${PROVIDER_CMD}"
+  echo "Open PRs needing work:${PRS_NEEDING_WORK}"
+  echo "Timeout: ${MAX_RUNTIME}s"
+  exit 0
+fi
+
+case "${PROVIDER_CMD}" in
+  claude)
+    timeout "${MAX_RUNTIME}" \
+      claude -p "/night-watch-pr-reviewer" \
+        --dangerously-skip-permissions \
+        >> "${LOG_FILE}" 2>&1
+    ;;
+  codex)
+    timeout "${MAX_RUNTIME}" \
+      codex --quiet \
+        --yolo \
+        --prompt "$(cat "${PROJECT_DIR}/.claude/commands/night-watch-pr-reviewer.md")" \
+        >> "${LOG_FILE}" 2>&1
+    ;;
+  *)
+    log "ERROR: Unknown provider: ${PROVIDER_CMD}"
+    exit 1
+    ;;
+esac
+
+EXIT_CODE=$?
+
+cleanup_worktrees "${PROJECT_DIR}"
+
+if [ ${EXIT_CODE} -eq 0 ]; then
+  log "DONE: PR reviewer completed successfully"
+elif [ ${EXIT_CODE} -eq 124 ]; then
+  log "TIMEOUT: PR reviewer killed after ${MAX_RUNTIME}s"
+else
+  log "FAIL: PR reviewer exited with code ${EXIT_CODE}"
+fi