@chllming/wave-orchestration 0.8.5 → 0.8.7

package/scripts/wave-orchestrator/task-entity.mjs

@@ -17,8 +17,8 @@ import {
   isSecurityReviewAgent,
 } from "./role-helpers.mjs";
 import {
+  coordinationRecordBlocksWave,
   isOpenCoordinationStatus,
-  openClarificationLinkedRequests,
 } from "./coordination-store.mjs";
 
 export const TASK_TYPES = new Set([
@@ -647,7 +647,7 @@ export function buildTasksFromCoordinationState(coordinationState, feedbackReque
   const tasks = [];
 
   for (const record of coordinationState.clarifications || []) {
-    if (!isOpenCoordinationStatus(record.status)) {
+    if (!coordinationRecordBlocksWave(record)) {
       continue;
     }
     const waveNumber = Number.isFinite(record.wave) ? record.wave : 0;
@@ -683,7 +683,7 @@ export function buildTasksFromCoordinationState(coordinationState, feedbackReque
   }
 
   for (const record of coordinationState.humanFeedback || []) {
-    if (!isOpenCoordinationStatus(record.status)) {
+    if (!coordinationRecordBlocksWave(record)) {
       continue;
     }
     const waveNumber = Number.isFinite(record.wave) ? record.wave : 0;
@@ -719,7 +719,7 @@ export function buildTasksFromCoordinationState(coordinationState, feedbackReque
   }
 
   for (const record of coordinationState.humanEscalations || []) {
-    if (!isOpenCoordinationStatus(record.status)) {
+    if (!coordinationRecordBlocksWave(record)) {
       continue;
     }
     const waveNumber = Number.isFinite(record.wave) ? record.wave : 0;

package/scripts/wave-orchestrator/terminals.mjs

@@ -84,6 +84,14 @@ function extractTmuxSessionName(command, socketName) {
   return sessionName || null;
 }
 
+function sanitizeTmuxSessionName(value) {
+  return String(value || "").replace(/[^a-zA-Z0-9:_-]/g, "_");
+}
+
+export function createWaveAgentSessionName(lanePaths, wave, agentSlug) {
+  return sanitizeTmuxSessionName(`${lanePaths.tmuxSessionPrefix}${wave}_${agentSlug}`);
+}
+
 export function createTemporaryTerminalEntries(
   lanePaths,
   wave,
@@ -93,10 +101,7 @@ export function createTemporaryTerminalEntries(
 ) {
   const agentEntries = agents.map((agent) => {
     const terminalName = `${lanePaths.terminalNamePrefix}${wave}-${agent.slug}`;
-    const sessionName = `${lanePaths.tmuxSessionPrefix}${wave}_${agent.slug}_${runTag}`.replace(
-      /[^a-zA-Z0-9_-]/g,
-      "_",
-    );
+    const sessionName = createWaveAgentSessionName(lanePaths, wave, agent.slug);
     return {
       terminalName,
       sessionName,
@@ -111,9 +116,8 @@ export function createTemporaryTerminalEntries(
   if (!includeDashboard) {
     return agentEntries;
   }
-  const dashboardSessionName = `${lanePaths.tmuxDashboardSessionPrefix}${wave}_${runTag}`.replace(
-    /[^a-zA-Z0-9_-]/g,
-    "_",
+  const dashboardSessionName = sanitizeTmuxSessionName(
+    `${lanePaths.tmuxDashboardSessionPrefix}${wave}`,
   );
   agentEntries.push({
     terminalName: `${lanePaths.dashboardTerminalNamePrefix}${wave}`,
@@ -129,9 +133,8 @@ export function createTemporaryTerminalEntries(
 }
 
 export function createGlobalDashboardTerminalEntry(lanePaths, runTag) {
-  const sessionName = `${lanePaths.tmuxGlobalDashboardSessionPrefix}_current`.replace(
-    /[^a-zA-Z0-9:_-]/g,
-    "_",
+  const sessionName = sanitizeTmuxSessionName(
+    `${lanePaths.tmuxGlobalDashboardSessionPrefix}_current`,
   );
   return {
     terminalName: lanePaths.globalDashboardTerminalName,
@@ -146,10 +149,7 @@ export function createGlobalDashboardTerminalEntry(lanePaths, runTag) {
 }
 
 export function createCurrentWaveDashboardTerminalEntry(lanePaths) {
-  const sessionName = `${lanePaths.tmuxDashboardSessionPrefix}_current`.replace(
-    /[^a-zA-Z0-9:_-]/g,
-    "_",
-  );
+  const sessionName = sanitizeTmuxSessionName(`${lanePaths.tmuxDashboardSessionPrefix}_current`);
   const terminalName = currentWaveDashboardTerminalName(lanePaths);
   return {
     terminalName,

package/scripts/wave-orchestrator/wave-control-schema.mjs

@@ -13,6 +13,8 @@ export const WAVE_CONTROL_ENTITY_TYPES = new Set([
   "fact",
   "wave_run",
   "agent_run",
+  "wave_signal",
+  "agent_signal",
   "coordination_record",
   "gate",
   "artifact",

package/scripts/wave-orchestrator/wave-files.mjs

@@ -36,7 +36,7 @@ import {
 } from "./shared.mjs";
 import { normalizeContext7Config, hashAgentPromptFingerprint } from "./context7.mjs";
 import {
-  isOpenCoordinationStatus,
+  coordinationRecordBlocksWave,
   openClarificationLinkedRequests,
   readMaterializedCoordinationState,
 } from "./coordination-store.mjs";
@@ -2154,23 +2154,19 @@ export function resolveAgentExecutor(agent, options = {}) {
       ? "claude.maxTurns"
       : profile?.claude?.maxTurns !== null && profile?.claude?.maxTurns !== undefined
         ? "claude.maxTurns"
-        : runtimeBudget.turns !== null
-          ? "budget.turns"
-          : laneProfile.executors.claude.maxTurns !== null &&
-              laneProfile.executors.claude.maxTurns !== undefined
-            ? "claude.maxTurns"
-            : null;
+        : laneProfile.executors.claude.maxTurns !== null &&
+            laneProfile.executors.claude.maxTurns !== undefined
+          ? "claude.maxTurns"
+          : null;
   const opencodeStepsSource =
     executorConfig?.opencode?.steps !== null && executorConfig?.opencode?.steps !== undefined
       ? "opencode.steps"
       : profile?.opencode?.steps !== null && profile?.opencode?.steps !== undefined
         ? "opencode.steps"
-        : runtimeBudget.turns !== null
-          ? "budget.turns"
-          : laneProfile.executors.opencode.steps !== null &&
-              laneProfile.executors.opencode.steps !== undefined
-            ? "opencode.steps"
-            : null;
+        : laneProfile.executors.opencode.steps !== null &&
+            laneProfile.executors.opencode.steps !== undefined
+          ? "opencode.steps"
+          : null;
   return {
     id: executorId,
     initialExecutorId: executorId,
@@ -2253,7 +2249,6 @@ export function resolveAgentExecutor(agent, options = {}) {
       maxTurns:
         executorConfig?.claude?.maxTurns ??
         profile?.claude?.maxTurns ??
-        runtimeBudget.turns ??
         laneProfile.executors.claude.maxTurns,
       maxTurnsSource: claudeMaxTurnsSource,
     },
@@ -2271,7 +2266,6 @@ export function resolveAgentExecutor(agent, options = {}) {
       steps:
         executorConfig?.opencode?.steps ??
         profile?.opencode?.steps ??
-        runtimeBudget.turns ??
         laneProfile.executors.opencode.steps,
       stepsSource: opencodeStepsSource,
     },
@@ -3114,7 +3108,7 @@ function analyzeWaveCompletionFromStatusFiles(wave, statusDir, options = {}) {
     coordinationLogPath,
   );
   const openClarificationIds = coordinationState.clarifications
-    .filter((record) => isOpenCoordinationStatus(record.status))
+    .filter((record) => coordinationRecordBlocksWave(record))
     .map((record) => record.id);
   if (openClarificationIds.length > 0) {
     pushWaveCompletionReason(
@@ -3123,9 +3117,9 @@ function analyzeWaveCompletionFromStatusFiles(wave, statusDir, options = {}) {
       `Open clarification records: ${openClarificationIds.join(", ")}.`,
     );
   }
-  const openClarificationRequestIds = openClarificationLinkedRequests(coordinationState).map(
-    (record) => record.id,
-  );
+  const openClarificationRequestIds = openClarificationLinkedRequests(coordinationState)
+    .filter((record) => coordinationRecordBlocksWave(record))
+    .map((record) => record.id);
   if (openClarificationRequestIds.length > 0) {
     pushWaveCompletionReason(
       reasons,
@@ -3134,7 +3128,7 @@ function analyzeWaveCompletionFromStatusFiles(wave, statusDir, options = {}) {
     );
   }
   const openHumanEscalationIds = coordinationState.humanEscalations
-    .filter((record) => isOpenCoordinationStatus(record.status))
+    .filter((record) => coordinationRecordBlocksWave(record))
     .map((record) => record.id);
   if (openHumanEscalationIds.length > 0) {
     pushWaveCompletionReason(
@@ -3144,7 +3138,7 @@ function analyzeWaveCompletionFromStatusFiles(wave, statusDir, options = {}) {
     );
   }
   const openHumanFeedbackIds = coordinationState.humanFeedback
-    .filter((record) => isOpenCoordinationStatus(record.status))
+    .filter((record) => coordinationRecordBlocksWave(record))
     .map((record) => record.id);
   if (openHumanFeedbackIds.length > 0) {
     pushWaveCompletionReason(

package/scripts/wave-orchestrator/wave-state-reducer.mjs

@@ -1,6 +1,9 @@
 import { materializeControlPlaneState } from "./control-plane.mjs";
 import {
   buildCoordinationResponseMetrics,
+  coordinationBlockerSeverity,
+  coordinationRecordBlocksWave,
+  coordinationRecordIsHardBlocker,
   isOpenCoordinationStatus,
   materializeCoordinationState,
   openClarificationLinkedRequests,
@@ -135,18 +138,18 @@ function derivePhase({
   clarificationBarrier,
 }) {
   const blockers = (coordinationState?.blockers || []).filter(
-    (record) =>
-      isOpenCoordinationStatus(record.status) &&
-      ["high", "urgent"].includes(record.priority),
+    (record) => coordinationRecordIsHardBlocker(record),
   );
   if (blockers.length > 0) {
     return "blocked";
   }
 
   const openClarifications = (coordinationState?.clarifications || []).filter(
-    (record) => isOpenCoordinationStatus(record.status),
+    (record) => coordinationRecordBlocksWave(record),
+  );
+  const openClarificationRequests = openClarificationLinkedRequests(coordinationState).filter(
+    (record) => coordinationRecordBlocksWave(record),
   );
-  const openClarificationRequests = openClarificationLinkedRequests(coordinationState);
   if (openClarifications.length > 0 || openClarificationRequests.length > 0) {
     return "clarifying";
   }
@@ -228,6 +231,51 @@ function derivePhase({
   return "running";
 }
 
+function gateBlockerMetadata(gateName, gate) {
+  if (!gate || gate.ok !== false) {
+    return {
+      blocking: false,
+      blockerSeverity: "advisory",
+    };
+  }
+  if (gateName === "componentGate" && gate.statusCode === "shared-component-sibling-pending") {
+    return {
+      blocking: true,
+      blockerSeverity: "soft",
+    };
+  }
+  if (
+    ["implementationGate", "contEvalGate"].includes(gateName)
+  ) {
+    return {
+      blocking: true,
+      blockerSeverity: "proof-critical",
+    };
+  }
+  if (
+    [
+      "designGate",
+      "integrationBarrier",
+      "documentationGate",
+      "contQaGate",
+      "clarificationBarrier",
+      "helperAssignmentBarrier",
+      "dependencyBarrier",
+      "componentMatrixGate",
+      "componentGate",
+    ].includes(gateName)
+  ) {
+    return {
+      blocking: true,
+      blockerSeverity: "closure-critical",
+    };
+  }
+  return {
+    blocking: true,
+    blockerSeverity: "hard",
+  };
+}
+
 /**
  * Map waveState from phase for end-state output.
  */
@@ -338,6 +386,8 @@ function deriveOpenBlockers(coordinationState, gateSnapshot) {
     if (!isOpenCoordinationStatus(record.status)) {
       continue;
     }
+    const blocking = coordinationRecordBlocksWave(record);
+    const blockerSeverity = coordinationBlockerSeverity(record);
     blockers.push({
       kind: "coordination-blocker",
       id: record.id,
@@ -348,6 +398,8 @@ function deriveOpenBlockers(coordinationState, gateSnapshot) {
           ? record.targets
           : (record.agentId ? [record.agentId] : []),
       resolutionHint: record.resolutionHint || null,
+      blocking,
+      blockerSeverity,
     });
   }
 
@@ -355,6 +407,8 @@ function deriveOpenBlockers(coordinationState, gateSnapshot) {
     if (!isOpenCoordinationStatus(record.status)) {
       continue;
     }
+    const blocking = coordinationRecordBlocksWave(record);
+    const blockerSeverity = coordinationBlockerSeverity(record);
     blockers.push({
       kind: "clarification",
       id: record.id,
@@ -365,6 +419,8 @@ function deriveOpenBlockers(coordinationState, gateSnapshot) {
           ? record.targets
           : (record.agentId ? [record.agentId] : []),
       resolutionHint: "Resolve clarification before proceeding.",
+      blocking,
+      blockerSeverity,
     });
   }
 
@@ -372,6 +428,8 @@ function deriveOpenBlockers(coordinationState, gateSnapshot) {
     if (!isOpenCoordinationStatus(record.status)) {
       continue;
     }
+    const blocking = coordinationRecordBlocksWave(record);
+    const blockerSeverity = coordinationBlockerSeverity(record);
     blockers.push({
       kind: "human-escalation",
       id: record.id,
@@ -382,6 +440,8 @@ function deriveOpenBlockers(coordinationState, gateSnapshot) {
           ? record.targets
           : (record.agentId ? [record.agentId] : []),
       resolutionHint: "Human intervention required.",
+      blocking,
+      blockerSeverity,
     });
   }
 
@@ -389,6 +449,8 @@ function deriveOpenBlockers(coordinationState, gateSnapshot) {
     if (!isOpenCoordinationStatus(record.status)) {
       continue;
     }
+    const blocking = coordinationRecordBlocksWave(record);
+    const blockerSeverity = coordinationBlockerSeverity(record);
     blockers.push({
       kind: "human-feedback",
       id: record.id,
@@ -399,6 +461,8 @@ function deriveOpenBlockers(coordinationState, gateSnapshot) {
           ? record.targets
           : (record.agentId ? [record.agentId] : []),
       resolutionHint: "Awaiting human feedback.",
+      blocking,
+      blockerSeverity,
     });
   }
 
@@ -407,12 +471,15 @@ function deriveOpenBlockers(coordinationState, gateSnapshot) {
       if (gateName === "overall" || !gate || gate.ok !== false) {
         continue;
       }
+      const metadata = gateBlockerMetadata(gateName, gate);
       blockers.push({
         kind: "gate-failure",
         id: gateName,
         detail: gate.detail || gate.statusCode || "",
         blockedAgentIds: gate.agentId ? [gate.agentId] : [],
         resolutionHint: `Gate ${gateName} must pass before wave closure.`,
+        blocking: metadata.blocking,
+        blockerSeverity: metadata.blockerSeverity,
       });
     }
   }

package/scripts/wave-status.sh

@@ -0,0 +1,200 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+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
+}
+
+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
+
+run_wave_cli() {
+  if [ -n "${WAVE_WRAPPER_ENTRY:-}" ]; then
+    node "$WAVE_WRAPPER_ENTRY" "$@"
+    return
+  fi
+  if [ -f "scripts/wave.mjs" ]; then
+    node "scripts/wave.mjs" "$@"
+    return
+  fi
+  if [ -f "node_modules/@chllming/wave-orchestration/scripts/wave.mjs" ]; then
+    node "node_modules/@chllming/wave-orchestration/scripts/wave.mjs" "$@"
+    return
+  fi
+  if command -v pnpm >/dev/null 2>&1; then
+    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 - "$lane" "$run_id" "$dry_run" <<'NODE'
+const fs = require("node:fs");
+const path = require("node:path");
+
+const lane = process.argv[2] || "main";
+const runId = process.argv[3] || "";
+const dryRun = process.argv[4] === "1";
+const stateDir = runId
+  ? path.join(process.cwd(), ".tmp", `${lane}-wave-launcher`, "adhoc", runId, dryRun ? "dry-run" : "")
+  : path.join(process.cwd(), ".tmp", `${lane}-wave-launcher`, dryRun ? "dry-run" : "");
+const runStatePath = path.join(stateDir, "run-state.json");
+let payload = null;
+try {
+  payload = JSON.parse(fs.readFileSync(runStatePath, "utf8"));
+} catch {
+  payload = null;
+}
+const waves = Object.values(payload?.waves || {})
+  .filter((entry) => entry && typeof entry === "object")
+  .map((entry) => ({
+    wave: Number.parseInt(String(entry.wave ?? ""), 10),
+    state: String(entry.currentState || "").trim().toLowerCase(),
+  }))
+  .filter((entry) => Number.isFinite(entry.wave))
+  .sort((left, right) => left.wave - right.wave);
+const active = waves.findLast(
+  (entry) => !["completed", "failed", "timed_out", "timed-out"].includes(entry.state),
+);
+if (active) {
+  process.stdout.write(String(active.wave));
+  process.exit(0);
+}
+const completed = Array.isArray(payload?.completedWaves)
+  ? payload.completedWaves
+      .map((value) => Number.parseInt(String(value), 10))
+      .filter((value) => Number.isFinite(value))
+      .sort((left, right) => left - right)
+  : [];
+process.stdout.write(String(completed.at(-1) ?? 0));
+NODE
+}
+
+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="$(run_wave_cli "${status_args[@]}")"
+
+if [ "$json_output" = "1" ]; then
+  printf '%s\n' "$payload"
+  exit 0
+fi
+
+PAYLOAD="$payload" node - "$lane" "$wave" "$agent" <<'NODE'
+const fs = require("node:fs");
+
+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" : "waiting",
+  lane,
+  wave,
+  phase: payload?.phase || "unknown",
+  status: payload?.blockingEdge ? "blocked" : "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 || "none";
+const shouldWake =
+  typeof effective.shouldWake === "boolean" ? (effective.shouldWake ? "yes" : "no") : "n/a";
+console.log(
+  [
+    `signal=${effective.signal || "waiting"}`,
+    `lane=${lane}`,
+    `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 (String(effective.signal || "").trim().toLowerCase() === "completed") {
+  process.exit(0);
+}
+if (String(effective.signal || "").trim().toLowerCase() === "failed") {
+  process.exit(40);
+}
+if (String(effective.signal || "").trim().toLowerCase() === "feedback-requested") {
+  process.exit(20);
+}
+process.exit(10);
+NODE