@beyondwork/docx-react-component 1.0.0

package/scripts/wave-overnight-supervisor.sh

@@ -0,0 +1,145 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+LANE="${WAVE_LANE:-main}"
+SLEEP_SECONDS="${WAVE_OVERNIGHT_SLEEP_SECONDS:-300}"
+TIMEOUT_MINUTES="${WAVE_OVERNIGHT_TIMEOUT_MINUTES:-240}"
+STATE_DIR="$REPO_ROOT/.tmp/${LANE}-wave-launcher"
+SUP_DIR="$STATE_DIR/overnight"
+SAMPLES_DIR="$SUP_DIR/samples"
+LOG_PATH="$SUP_DIR/supervisor.log"
+PID_FILE="$SUP_DIR/launch.pid"
+LAST_STATUS_FILE="$SUP_DIR/last-status.txt"
+LAST_WAVE_FILE="$SUP_DIR/last-wave.txt"
+
+mkdir -p "$SAMPLES_DIR"
+
+timestamp() {
+  date -u +%Y-%m-%dT%H:%M:%SZ
+}
+
+log() {
+  printf '[%s] %s\n' "$(timestamp)" "$*" | tee -a "$LOG_PATH"
+}
+
+current_launch_pid() {
+  if [[ -f "$PID_FILE" ]]; then
+    tr -d '\n' < "$PID_FILE"
+  fi
+}
+
+launch_running() {
+  local pid
+  pid="$(current_launch_pid)"
+  [[ -n "${pid:-}" ]] && kill -0 "$pid" 2>/dev/null
+}
+
+write_quality_sample() {
+  local wave="$1"
+  local sample_path="$SAMPLES_DIR/wave-${wave}-$(date -u +%Y%m%dT%H%M%SZ).json"
+  set +e
+  bash "$SCRIPT_DIR/context7-export-env.sh" run \
+    pnpm exec wave control status --lane "$LANE" --wave "$wave" --json >"$sample_path"
+  local sample_exit=$?
+  set -e
+  if [[ $sample_exit -eq 0 ]]; then
+    log "sampled wave ${wave} control state -> ${sample_path#$REPO_ROOT/}"
+  else
+    log "control-state sample for wave ${wave} failed with exit ${sample_exit}"
+  fi
+}
+
+start_launcher() {
+  local run_id launch_log
+  run_id="$(date -u +%Y%m%dT%H%M%SZ)"
+  launch_log="$SUP_DIR/launch-${run_id}.log"
+  (
+    cd "$REPO_ROOT"
+    bash "$SCRIPT_DIR/wave-launch.sh" \
+      --auto-next \
+      --resume-control-state \
+      --timeout-minutes "$TIMEOUT_MINUTES"
+  ) >>"$launch_log" 2>&1 &
+  local pid=$!
+  printf '%s\n' "$pid" > "$PID_FILE"
+  log "started launcher pid=${pid} log=${launch_log#$REPO_ROOT/}"
+}
+
+record_status_change() {
+  local status_output="$1"
+  local wave="$2"
+  local last_status=""
+  if [[ -f "$LAST_STATUS_FILE" ]]; then
+    last_status="$(cat "$LAST_STATUS_FILE")"
+  fi
+  if [[ "$status_output" != "$last_status" ]]; then
+    printf '%s\n' "$status_output" > "$LAST_STATUS_FILE"
+    log "$status_output"
+    if [[ -n "$wave" ]]; then
+      write_quality_sample "$wave"
+    fi
+  fi
+}
+
+while true; do
+  set +e
+  status_output="$(bash "$SCRIPT_DIR/wave-status.sh" 2>&1)"
+  status_exit=$?
+  set -e
+
+  wave="$(printf '%s\n' "$status_output" | sed -n 's/.* wave=\([^ ]*\).*/\1/p')"
+  phase="$(printf '%s\n' "$status_output" | sed -n 's/.* phase=\([^ ]*\).*/\1/p')"
+  attempt="$(printf '%s\n' "$status_output" | sed -n 's/.* attempt=\([^ ]*\).*/\1/p')"
+  record_status_change "$status_output" "$wave"
+
+  if [[ -n "$wave" ]]; then
+    last_wave=""
+    if [[ -f "$LAST_WAVE_FILE" ]]; then
+      last_wave="$(cat "$LAST_WAVE_FILE")"
+    fi
+    if [[ "$wave" != "$last_wave" ]]; then
+      printf '%s\n' "$wave" > "$LAST_WAVE_FILE"
+      log "active wave changed to ${wave}"
+    fi
+  fi
+
+  if [[ $status_exit -eq 0 ]]; then
+    log "all waves completed"
+    exit 0
+  fi
+
+  if [[ $status_exit -eq 20 ]]; then
+    set +e
+    auto_answer_output="$(bash "$SCRIPT_DIR/wave-auto-answer.sh" --lane "$LANE" 2>&1)"
+    auto_answer_exit=$?
+    set -e
+    if [[ $auto_answer_exit -eq 0 && "$auto_answer_output" =~ answered=([1-9][0-9]*) ]]; then
+      while IFS= read -r line; do
+        [[ -n "$line" ]] && log "$line"
+      done <<< "$auto_answer_output"
+      log "auto-answered human input; continuing"
+      sleep 2
+      continue
+    fi
+    log "human input required; supervisor paused"
+    exit 20
+  fi
+
+  if [[ $status_exit -eq 40 ]]; then
+    log "wave failed; supervisor stopped"
+    exit 40
+  fi
+
+  if launch_running; then
+    log "launcher pid=$(current_launch_pid) still running"
+  elif [[ "${phase:-}" == "running" && -n "${attempt:-}" && "${attempt}" != "0" && "${attempt}" != "none" ]]; then
+    log "no active launcher detected, but wave ${wave} already has attempt=${attempt}; waiting for the next signal change"
+  else
+    log "no active launcher detected"
+    start_launcher
+  fi
+
+  sleep "$SLEEP_SECONDS"
+done

package/scripts/wave-status.sh

@@ -0,0 +1,379 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+lane="${WAVE_LANE:-main}"
+wave=""
+agent=""
+run_id=""
+dry_run="0"
+json_output="0"
+
+usage() {
+  cat <<'EOF'
+Usage:
+  scripts/wave-status.sh [--lane <lane>] [--wave <n>] [--agent <id>] [--run <id>] [--dry-run] [--json]
+
+Exit codes:
+  0   completed
+  10  waiting or running
+  20  input required
+  40  failed
+EOF
+}
+
+run_wave_cli() {
+  if [ -n "${WAVE_WRAPPER_ENTRY:-}" ]; then
+    node "$WAVE_WRAPPER_ENTRY" "$@"
+    return
+  fi
+  if [ -f "$REPO_ROOT/scripts/wave.mjs" ]; then
+    node "$REPO_ROOT/scripts/wave.mjs" "$@"
+    return
+  fi
+  if [ -f "$REPO_ROOT/node_modules/@chllming/wave-orchestration/scripts/wave.mjs" ]; then
+    node "$REPO_ROOT/node_modules/@chllming/wave-orchestration/scripts/wave.mjs" "$@"
+    return
+  fi
+  if command -v pnpm >/dev/null 2>&1; then
+    (
+      cd "$REPO_ROOT"
+      pnpm exec wave "$@"
+    )
+    return
+  fi
+  echo "Unable to locate Wave CLI. Set WAVE_WRAPPER_ENTRY or install the package locally." >&2
+  exit 2
+}
+
+infer_wave() {
+  node - "$REPO_ROOT" "$lane" "$run_id" "$dry_run" <<'NODE'
+const fs = require("node:fs");
+const path = require("node:path");
+
+const repoRoot = process.argv[2];
+const lane = process.argv[3] || "main";
+const runId = process.argv[4] || "";
+const dryRun = process.argv[5] === "1";
+const stateDir = runId
+  ? path.join(repoRoot, ".tmp", `${lane}-wave-launcher`, "adhoc", runId, dryRun ? "dry-run" : "")
+  : path.join(repoRoot, ".tmp", `${lane}-wave-launcher`, dryRun ? "dry-run" : "");
+const runStatePath = path.join(stateDir, "run-state.json");
+const manualCompletionsPath = path.join(repoRoot, ".tmp", `${lane}-wave-launcher`, "manual-completions.json");
+
+let payload = null;
+try {
+  payload = JSON.parse(fs.readFileSync(runStatePath, "utf8"));
+} catch {
+  payload = null;
+}
+let manualCompletions = [];
+try {
+  const manualPayload = JSON.parse(fs.readFileSync(manualCompletionsPath, "utf8"));
+  manualCompletions = Array.isArray(manualPayload?.waves) ? manualPayload.waves : [];
+} catch {
+  manualCompletions = [];
+}
+
+const manualCompletedSet = new Set(
+  manualCompletions
+    .map((value) => Number.parseInt(String(value), 10))
+    .filter((value) => Number.isFinite(value)),
+);
+const waves = Object.values(payload?.waves || {})
+  .filter((entry) => entry && typeof entry === "object")
+  .map((entry) => ({
+    wave: Number.parseInt(String(entry.wave ?? ""), 10),
+    state: manualCompletedSet.has(Number.parseInt(String(entry.wave ?? ""), 10))
+      ? "completed_with_drift"
+      : String(entry.currentState || "").trim().toLowerCase(),
+  }))
+  .filter((entry) => Number.isFinite(entry.wave))
+  .sort((left, right) => left.wave - right.wave);
+
+const isComplete = (value) => String(value || "").trim().toLowerCase().startsWith("completed");
+const isTerminalFailure = (value) => ["failed", "timed_out", "timed-out"].includes(String(value || "").trim().toLowerCase());
+const highestCompleted = Math.max(
+  -1,
+  ...((Array.isArray(payload?.completedWaves) ? payload.completedWaves : [])
+    .map((value) => Number.parseInt(String(value), 10))
+    .filter((value) => Number.isFinite(value))),
+  ...manualCompletedSet,
+  ...waves.filter((entry) => isComplete(entry.state)).map((entry) => entry.wave),
+);
+const next = waves.find(
+  (entry) =>
+    entry.wave > highestCompleted &&
+    !isComplete(entry.state) &&
+    !isTerminalFailure(entry.state),
+);
+
+process.stdout.write(String(next ? next.wave : (waves.at(-1)?.wave ?? 0)));
+NODE
+}
+
+build_fallback_payload() {
+  node - "$REPO_ROOT" "$lane" "$wave" "$run_id" "$dry_run" "$agent" <<'NODE'
+const fs = require("node:fs");
+const path = require("node:path");
+
+const repoRoot = process.argv[2];
+const lane = process.argv[3] || "main";
+const requestedWave = Number.parseInt(String(process.argv[4] || ""), 10);
+const runId = process.argv[5] || "";
+const dryRun = process.argv[6] === "1";
+const agentId = String(process.argv[7] || "").trim();
+const stateDir = runId
+  ? path.join(repoRoot, ".tmp", `${lane}-wave-launcher`, "adhoc", runId, dryRun ? "dry-run" : "")
+  : path.join(repoRoot, ".tmp", `${lane}-wave-launcher`, dryRun ? "dry-run" : "");
+const runStatePath = path.join(stateDir, "run-state.json");
+const manualCompletionsPath = path.join(repoRoot, ".tmp", `${lane}-wave-launcher`, "manual-completions.json");
+
+let payload = null;
+try {
+  payload = JSON.parse(fs.readFileSync(runStatePath, "utf8"));
+} catch {
+  payload = null;
+}
+let manualCompletions = [];
+try {
+  const manualPayload = JSON.parse(fs.readFileSync(manualCompletionsPath, "utf8"));
+  manualCompletions = Array.isArray(manualPayload?.waves) ? manualPayload.waves : [];
+} catch {
+  manualCompletions = [];
+}
+
+const manualCompletedSet = new Set(
+  manualCompletions
+    .map((value) => Number.parseInt(String(value), 10))
+    .filter((value) => Number.isFinite(value)),
+);
+const waves = Object.values(payload?.waves || {})
+  .filter((entry) => entry && typeof entry === "object")
+  .map((entry) => ({
+    wave: Number.parseInt(String(entry.wave ?? ""), 10),
+    state: manualCompletedSet.has(Number.parseInt(String(entry.wave ?? ""), 10))
+      ? "completed_with_drift"
+      : String(entry.currentState || "").trim().toLowerCase(),
+  }))
+  .filter((entry) => Number.isFinite(entry.wave))
+  .sort((left, right) => left.wave - right.wave);
+
+const isComplete = (value) => String(value || "").trim().toLowerCase().startsWith("completed");
+const isTerminalFailure = (value) => ["failed", "timed_out", "timed-out"].includes(String(value || "").trim().toLowerCase());
+const highestCompleted = Math.max(
+  -1,
+  ...((Array.isArray(payload?.completedWaves) ? payload.completedWaves : [])
+    .map((value) => Number.parseInt(String(value), 10))
+    .filter((value) => Number.isFinite(value))),
+  ...manualCompletedSet,
+  ...waves.filter((entry) => isComplete(entry.state)).map((entry) => entry.wave),
+);
+const next = waves.find(
+  (entry) =>
+    entry.wave > highestCompleted &&
+    !isComplete(entry.state) &&
+    !isTerminalFailure(entry.state),
+);
+const allComplete = waves.length > 0 && !next && waves.every((entry) => isComplete(entry.state) || isTerminalFailure(entry.state));
+const resolvedWave = Number.isFinite(requestedWave)
+  ? requestedWave
+  : (next ? next.wave : (waves.at(-1)?.wave ?? 0));
+const entry = waves.find((candidate) => candidate.wave === resolvedWave) || null;
+
+let signal = "waiting";
+let phase = entry?.state || "unknown";
+let status = entry?.state || "unknown";
+if (allComplete || isComplete(entry?.state)) {
+  signal = "completed";
+  phase = "complete";
+  status = "completed";
+} else if (isTerminalFailure(entry?.state)) {
+  signal = "failed";
+  phase = entry?.state || "failed";
+  status = "failed";
+}
+
+process.stdout.write(
+  JSON.stringify({
+    lane,
+    wave: resolvedWave,
+    phase,
+    agentId: agentId || null,
+    blockingEdge: null,
+    logicalAgents: [],
+    tasks: [],
+    helperAssignments: [],
+    dependencies: [],
+    proofBundles: [],
+    feedbackRequests: [],
+    selectionSource: "none",
+    rerunRequest: null,
+    relaunchPlan: null,
+    nextTimer: null,
+    activeAttempt: null,
+    signals: {
+      wave: {
+        signal,
+        lane,
+        wave: resolvedWave,
+        phase,
+        status,
+        blocking: null,
+        attempt: 0,
+        targetAgentIds: agentId ? [agentId] : [],
+        shouldWake: agentId ? true : null,
+        version: 0,
+      },
+      agents: [],
+    },
+    fallbackSource: "run-state",
+  }),
+);
+NODE
+}
+
+print_status_and_exit() {
+  PAYLOAD="$1" node - "$lane" "$wave" "$agent" <<'NODE'
+const lane = process.argv[2] || "main";
+const wave = Number.parseInt(String(process.argv[3] || "0"), 10) || 0;
+const agentId = String(process.argv[4] || "").trim();
+const payload = JSON.parse(process.env.PAYLOAD || "{}");
+const signals = payload?.signals || {};
+const snapshot = agentId
+  ? (Array.isArray(signals.agents) ? signals.agents.find((entry) => entry.agentId === agentId) : null)
+  : signals.wave;
+const effective = snapshot || {
+  signal:
+    payload?.blockingEdge?.kind === "human-input"
+      ? "feedback-requested"
+      : payload?.phase === "complete"
+        ? "completed"
+        : payload?.phase === "failed"
+          ? "failed"
+          : "waiting",
+  lane,
+  wave: payload?.wave ?? wave,
+  phase: payload?.phase || "unknown",
+  status:
+    payload?.phase === "complete"
+      ? "completed"
+      : payload?.phase === "failed"
+        ? "failed"
+        : payload?.blockingEdge
+          ? "blocked"
+          : payload?.phase || "running",
+  blocking: payload?.blockingEdge || null,
+  attempt: payload?.activeAttempt?.attemptNumber || 0,
+  targetAgentIds: agentId ? [agentId] : [],
+  shouldWake: agentId ? true : null,
+  version: 0,
+};
+const targetKey = agentId ? "agent" : "agents";
+const targetValue = agentId || (effective.targetAgentIds || []).join(",") || "none";
+const blocking =
+  effective?.blocking?.kind ||
+  payload?.blockingEdge?.kind ||
+  "none";
+const shouldWake =
+  typeof effective.shouldWake === "boolean" ? (effective.shouldWake ? "yes" : "no") : "n/a";
+const signal = String(effective.signal || "waiting").trim().toLowerCase();
+console.log(
+  [
+    `signal=${signal || "waiting"}`,
+    `lane=${lane}`,
+    `wave=${payload?.wave ?? wave}`,
+    `phase=${effective.phase || "unknown"}`,
+    `status=${effective.status || "running"}`,
+    `blocking=${blocking}`,
+    `attempt=${effective.attempt || 0}`,
+    `${targetKey}=${targetValue}`,
+    `version=${effective.version || 0}`,
+    `should_wake=${shouldWake}`,
+  ].join(" "),
+);
+if (signal === "completed") {
+  process.exit(0);
+}
+if (signal === "failed") {
+  process.exit(40);
+}
+if (signal === "feedback-requested") {
+  process.exit(20);
+}
+process.exit(10);
+NODE
+}
+
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --lane)
+      lane="${2:-}"
+      shift 2
+      ;;
+    --wave)
+      wave="${2:-}"
+      shift 2
+      ;;
+    --agent)
+      agent="${2:-}"
+      shift 2
+      ;;
+    --run)
+      run_id="${2:-}"
+      shift 2
+      ;;
+    --dry-run)
+      dry_run="1"
+      shift
+      ;;
+    --json)
+      json_output="1"
+      shift
+      ;;
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown argument: $1" >&2
+      usage >&2
+      exit 2
+      ;;
+  esac
+done
+
+if [ -z "$wave" ]; then
+  wave="$(infer_wave)"
+fi
+
+status_args=(control status --lane "$lane" --wave "$wave" --json)
+if [ -n "$agent" ]; then
+  status_args+=(--agent "$agent")
+fi
+if [ -n "$run_id" ]; then
+  status_args+=(--run "$run_id")
+fi
+if [ "$dry_run" = "1" ]; then
+  status_args+=(--dry-run)
+fi
+
+payload=""
+set +e
+payload="$(run_wave_cli "${status_args[@]}" 2>/dev/null)"
+status_exit=$?
+set -e
+if [ "$status_exit" -ne 0 ] || [ -z "$payload" ]; then
+  payload="$(build_fallback_payload)"
+elif ! PAYLOAD="$payload" node -e 'JSON.parse(process.env.PAYLOAD || "{}")' >/dev/null 2>&1; then
+  payload="$(build_fallback_payload)"
+fi
+
+if [ "$json_output" = "1" ]; then
+  printf '%s\n' "$payload"
+  exit 0
+fi
+
+print_status_and_exit "$payload"