agent-control-plane 0.1.0

package/hooks/issue-reconcile-hooks.sh

@@ -0,0 +1,217 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+HOOK_SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=/dev/null
+source "${HOOK_SCRIPT_DIR}/../tools/bin/flow-config-lib.sh"
+
+FLOW_SKILL_DIR="$(cd "${HOOK_SCRIPT_DIR}/.." && pwd)"
+CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
+ADAPTER_BIN_DIR="${FLOW_SKILL_DIR}/bin"
+FLOW_TOOLS_DIR="${FLOW_SKILL_DIR}/tools/bin"
+REPO_SLUG="$(flow_resolve_repo_slug "${CONFIG_YAML}")"
+AGENT_ROOT="$(flow_resolve_agent_root "${CONFIG_YAML}")"
+STATE_ROOT="$(flow_resolve_state_root "${CONFIG_YAML}")"
+RUNS_ROOT="$(flow_resolve_runs_root "${CONFIG_YAML}")"
+BLOCKED_RECOVERY_STATE_DIR="${STATE_ROOT}/blocked-recovery-issues"
+
+issue_clear_blocked_recovery_state() {
+  rm -f "${BLOCKED_RECOVERY_STATE_DIR}/${ISSUE_ID}.env" 2>/dev/null || true
+}
+
+issue_has_schedule_cadence() {
+  local issue_json issue_body
+  issue_json="$(flow_github_issue_view_json "${REPO_SLUG}" "${ISSUE_ID}" 2>/dev/null || true)"
+  issue_body="$(jq -r '.body // ""' <<<"${issue_json:-"{}"}")"
+  ISSUE_BODY="$issue_body" node <<'EOF' >/dev/null
+const body = process.env.ISSUE_BODY || '';
+const match = body.match(/^\s*(?:Agent schedule|Schedule|Cadence)\s*:\s*(?:every\s+)?(\d+)\s*([mhd])\s*$/im);
+process.exit(match ? 0 : 1);
+EOF
+}
+
+issue_scheduled_status_kind() {
+  local issue_json issue_title issue_body
+  issue_json="$(flow_github_issue_view_json "${REPO_SLUG}" "${ISSUE_ID}" 2>/dev/null || true)"
+  issue_title="$(jq -r '.title // ""' <<<"${issue_json:-"{}"}")"
+  issue_body="$(jq -r '.body // ""' <<<"${issue_json:-"{}"}")"
+  ISSUE_TITLE="$issue_title" ISSUE_BODY="$issue_body" node <<'EOF'
+const title = process.env.ISSUE_TITLE || '';
+const body = process.env.ISSUE_BODY || '';
+const haystack = `${title}\n${body}`.toLowerCase();
+if (/\be2e\b|\bsmoke\b|playwright|detox|maestro|automation test|smoke test/.test(haystack)) {
+  process.stdout.write('smoke\n');
+  process.exit(0);
+}
+if (/\btypecheck\b|\blint\b|\bunit test\b|\bunit-test\b|\bjest\b|\bvitest\b|\btest suite\b|\bbuild\b|\bci\b/.test(haystack)) {
+  process.stdout.write('checks\n');
+  process.exit(0);
+}
+if (/\bhealth\b|\/health\b|prod health|system health/.test(haystack)) {
+  process.stdout.write('health\n');
+  process.exit(0);
+}
+process.stdout.write('\n');
+EOF
+}
+
+issue_ensure_status_label_exists() {
+  local label_name="${1:?label required}"
+  local label_description="${2:-}"
+  local label_color="${3:-1D76DB}"
+  flow_github_label_create "$REPO_SLUG" "$label_name" "$label_description" "$label_color" >/dev/null 2>&1 || true
+}
+
+issue_update_scheduled_status() {
+  local status_kind="${1:?status required}"
+  local scheduled_kind ok_label alert_label
+
+  if ! issue_has_schedule_cadence; then
+    return 0
+  fi
+  scheduled_kind="$(issue_scheduled_status_kind)"
+  if [[ -z "$scheduled_kind" ]]; then
+    return 0
+  fi
+
+  case "$scheduled_kind" in
+    health)
+      ok_label="health-ok"
+      alert_label="health-not-ok"
+      issue_ensure_status_label_exists "$ok_label" "Latest scheduled health check passed" "0E8A16"
+      issue_ensure_status_label_exists "$alert_label" "Latest scheduled health check reported an alert" "B60205"
+      ;;
+    checks)
+      ok_label="checks-ok"
+      alert_label="checks-not-ok"
+      issue_ensure_status_label_exists "$ok_label" "Latest scheduled verification checks passed" "0E8A16"
+      issue_ensure_status_label_exists "$alert_label" "Latest scheduled verification checks reported an alert" "B60205"
+      ;;
+    smoke)
+      ok_label="smoke-ok"
+      alert_label="smoke-not-ok"
+      issue_ensure_status_label_exists "$ok_label" "Latest scheduled smoke or E2E check passed" "0E8A16"
+      issue_ensure_status_label_exists "$alert_label" "Latest scheduled smoke or E2E check reported an alert" "B60205"
+      ;;
+    *)
+      return 0
+      ;;
+  esac
+
+  case "$status_kind" in
+    ok)
+      bash "${FLOW_TOOLS_DIR}/agent-github-update-labels" \
+        --repo-slug "${REPO_SLUG}" \
+        --number "$ISSUE_ID" \
+        --remove health-ok \
+        --remove health-not-ok \
+        --remove checks-ok \
+        --remove checks-not-ok \
+        --remove smoke-ok \
+        --remove smoke-not-ok \
+        --add "$ok_label" >/dev/null || true
+      ;;
+    alert)
+      bash "${FLOW_TOOLS_DIR}/agent-github-update-labels" \
+        --repo-slug "${REPO_SLUG}" \
+        --number "$ISSUE_ID" \
+        --remove health-ok \
+        --remove health-not-ok \
+        --remove checks-ok \
+        --remove checks-not-ok \
+        --remove smoke-ok \
+        --remove smoke-not-ok \
+        --add "$alert_label" >/dev/null || true
+      ;;
+  esac
+}
+
+issue_before_success() {
+  if issue_has_schedule_cadence; then
+    return 0
+  fi
+  ACP_AGENT_ROOT="${AGENT_ROOT}" ACP_RUNS_ROOT="${RUNS_ROOT}" F_LOSNING_RUNS_ROOT="${RUNS_ROOT}" \
+    "${ADAPTER_BIN_DIR}/label-follow-up-issues.sh" "$SESSION" >/dev/null || true
+}
+
+issue_before_blocked() {
+  if issue_has_schedule_cadence; then
+    return 0
+  fi
+  ACP_AGENT_ROOT="${AGENT_ROOT}" ACP_RUNS_ROOT="${RUNS_ROOT}" F_LOSNING_RUNS_ROOT="${RUNS_ROOT}" \
+    "${ADAPTER_BIN_DIR}/label-follow-up-issues.sh" "$SESSION" >/dev/null || true
+}
+
+issue_schedule_retry() {
+  local reason="${1:?reason required}"
+  if issue_has_schedule_cadence; then
+    return 0
+  fi
+  "${FLOW_TOOLS_DIR}/retry-state.sh" issue "$ISSUE_ID" schedule "$reason" >/dev/null || true
+}
+
+issue_mark_ready() {
+  issue_clear_blocked_recovery_state
+  bash "${FLOW_TOOLS_DIR}/agent-github-update-labels" --repo-slug "${REPO_SLUG}" --number "$ISSUE_ID" --remove agent-running --remove agent-blocked >/dev/null || true
+}
+
+issue_clear_retry() {
+  issue_clear_blocked_recovery_state
+  "${FLOW_TOOLS_DIR}/retry-state.sh" issue "$ISSUE_ID" clear >/dev/null || true
+}
+
+issue_publish_extra_args() {
+  printf '%s\n' --keep-open-label agent-keep-open
+}
+
+issue_remove_running() {
+  bash "${FLOW_TOOLS_DIR}/agent-github-update-labels" --repo-slug "${REPO_SLUG}" --number "$ISSUE_ID" --remove agent-ready --remove agent-running --remove agent-blocked >/dev/null || true
+}
+
+issue_mark_blocked() {
+  bash "${FLOW_TOOLS_DIR}/agent-github-update-labels" \
+    --repo-slug "${REPO_SLUG}" \
+    --number "$ISSUE_ID" \
+    --remove agent-running \
+    --add agent-blocked >/dev/null || true
+}
+
+issue_should_close_as_superseded() {
+  local comment_file="${run_dir}/issue-comment.md"
+  [[ -s "$comment_file" ]] || return 1
+  head -n 1 "$comment_file" | grep -q '^Superseded by focused follow-up issues:'
+}
+
+issue_close_as_superseded() {
+  bash "${FLOW_TOOLS_DIR}/agent-github-update-labels" --repo-slug "${REPO_SLUG}" --number "$ISSUE_ID" --remove agent-running --remove agent-blocked >/dev/null || true
+  flow_github_issue_close "$REPO_SLUG" "$ISSUE_ID" >/dev/null 2>&1 || true
+}
+
+issue_after_pr_created() {
+  local pr_number="${1:?pr number required}"
+  local risk_json
+  risk_json="$("${ADAPTER_BIN_DIR}/pr-risk.sh" "$pr_number")"
+  if [[ "$(jq -r '.eligibleForAutoMerge' <<<"$risk_json")" == "true" ]]; then
+    bash "${FLOW_TOOLS_DIR}/agent-github-update-labels" --repo-slug "${REPO_SLUG}" --number "$pr_number" --add agent-automerge >/dev/null || true
+  fi
+  "${FLOW_TOOLS_DIR}/kick-scheduler.sh" 5 >/dev/null || true
+}
+
+issue_after_reconciled() {
+  local status="${1:-}"
+  local outcome="${2:-}"
+  local action="${3:-}"
+
+  if [[ "$status" == "SUCCEEDED" && "$outcome" == "reported" ]]; then
+    case "$action" in
+      host-comment-scheduled-report)
+        issue_update_scheduled_status ok
+        ;;
+      host-comment-scheduled-alert)
+        issue_update_scheduled_status alert
+        ;;
+    esac
+  fi
+
+  "${FLOW_TOOLS_DIR}/kick-scheduler.sh" 2 >/dev/null || true
+}

package/hooks/pr-reconcile-hooks.sh

@@ -0,0 +1,225 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+HOOK_SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=/dev/null
+source "${HOOK_SCRIPT_DIR}/../tools/bin/flow-config-lib.sh"
+
+FLOW_SKILL_DIR="$(cd "${HOOK_SCRIPT_DIR}/.." && pwd)"
+CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
+ADAPTER_BIN_DIR="${FLOW_SKILL_DIR}/bin"
+FLOW_TOOLS_DIR="${FLOW_SKILL_DIR}/tools/bin"
+RUNS_ROOT="$(flow_resolve_runs_root "${CONFIG_YAML}")"
+: "${RUNS_ROOT:?RUNS_ROOT is required}"
+AGENT_ROOT="$(flow_resolve_agent_root "${CONFIG_YAML}")"
+STATE_ROOT="$(flow_resolve_state_root "${CONFIG_YAML}")"
+REPO_SLUG="$(flow_resolve_repo_slug "${CONFIG_YAML}")"
+AGENT_REPO_ROOT="$(flow_resolve_agent_repo_root "${CONFIG_YAML}")"
+ISSUE_SESSION_PREFIX="$(flow_resolve_issue_session_prefix "${CONFIG_YAML}")"
+PR_WORKTREE_BRANCH_PREFIX="$(flow_resolve_pr_worktree_branch_prefix "${CONFIG_YAML}")"
+PR_LANE_OVERRIDE_DIR="${STATE_ROOT}/pr-lane-overrides"
+
+pr_best_effort_update_labels() {
+  bash "${FLOW_TOOLS_DIR}/agent-github-update-labels" "$@" >/dev/null 2>&1 || true
+}
+
+pr_best_effort_sync_pr_labels() {
+  "${ADAPTER_BIN_DIR}/sync-pr-labels.sh" "$1" >/dev/null 2>&1 || true
+}
+
+pr_set_lane_override() {
+  local pr_number="${1:?pr number required}"
+  local lane="${2:?lane required}"
+  mkdir -p "${PR_LANE_OVERRIDE_DIR}"
+  cat >"${PR_LANE_OVERRIDE_DIR}/${pr_number}.env" <<EOF
+PR_LANE_OVERRIDE=${lane}
+UPDATED_AT=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+EOF
+}
+
+pr_clear_lane_override() {
+  local pr_number="${1:?pr number required}"
+  rm -f "${PR_LANE_OVERRIDE_DIR}/${pr_number}.env"
+}
+
+pr_schedule_retry() {
+  local reason="${1:?reason required}"
+  "${FLOW_TOOLS_DIR}/retry-state.sh" pr "$PR_NUMBER" schedule "$reason" >/dev/null || true
+}
+
+pr_clear_retry() {
+  "${FLOW_TOOLS_DIR}/retry-state.sh" pr "$PR_NUMBER" clear >/dev/null || true
+}
+
+pr_linked_issue_should_close() {
+  local issue_id="${1:?issue id required}"
+  local issue_json
+  issue_json="$(flow_github_issue_view_json "${REPO_SLUG}" "${issue_id}" 2>/dev/null || true)"
+  if [[ -n "$issue_json" ]] && jq -e 'any(.labels[]?; .name == "agent-keep-open")' >/dev/null <<<"$issue_json"; then
+    printf 'no\n'
+  else
+    printf 'yes\n'
+  fi
+}
+
+pr_cleanup_linked_issue_session() {
+  local issue_id="${1:-}"
+  [[ -n "$issue_id" ]] || return 0
+
+  local should_close
+  should_close="$(pr_linked_issue_should_close "$issue_id")"
+  update_args=(--remove agent-ready --remove agent-running --remove agent-blocked --remove agent-e2e-heavy --remove agent-automerge --remove agent-exclusive)
+  pr_best_effort_update_labels --repo-slug "${REPO_SLUG}" --number "$issue_id" "${update_args[@]}"
+
+  local issue_session="${ISSUE_SESSION_PREFIX}${issue_id}"
+  local issue_meta="${RUNS_ROOT}/${issue_session}/run.env"
+  if [[ -f "$issue_meta" ]]; then
+    local issue_worktree
+    issue_worktree="$(awk -F= '/^WORKTREE=/{print $2}' "$issue_meta" | head -n 1)"
+    "${FLOW_TOOLS_DIR}/cleanup-worktree.sh" "${issue_worktree:-}" "$issue_session" >/dev/null || true
+  fi
+}
+
+pr_cleanup_merged_residue() {
+  local pr_number="${1:?pr number required}"
+  local agent_repo_root="${AGENT_REPO_ROOT}"
+  local cleanup_tool="${FLOW_TOOLS_DIR}/agent-cleanup-worktree"
+  local temp_branch=""
+  local head_ref=""
+
+  if [[ ! -d "$agent_repo_root" ]]; then
+    return 0
+  fi
+
+  git -C "$agent_repo_root" fetch --prune origin >/dev/null 2>&1 || true
+
+  while IFS= read -r temp_branch; do
+    [[ -n "$temp_branch" ]] || continue
+    (
+      cd "$agent_repo_root"
+      "$cleanup_tool" --branch "$temp_branch" --remote "" --allow-unmerged >/dev/null
+    ) || true
+  done < <(git -C "$agent_repo_root" for-each-ref --format='%(refname:short)' "refs/heads/${PR_WORKTREE_BRANCH_PREFIX}-${pr_number}-*")
+
+  head_ref="$(flow_github_pr_view_json "${REPO_SLUG}" "${pr_number}" 2>/dev/null | jq -r '.headRefName // empty' 2>/dev/null || true)"
+  if [[ -n "$head_ref" ]]; then
+    git -C "$agent_repo_root" branch -r -d "origin/${head_ref}" >/dev/null 2>&1 || true
+  fi
+
+  git -C "$agent_repo_root" fetch --prune origin >/dev/null 2>&1 || true
+}
+
+pr_refresh_linked_issue_checklist() {
+  local pr_number="${1:?pr number required}"
+  local risk_json=""
+  local linked_issue_id=""
+
+  risk_json="$("${ADAPTER_BIN_DIR}/pr-risk.sh" "$pr_number" 2>/dev/null || true)"
+  [[ -n "${risk_json}" ]] || return 0
+
+  linked_issue_id="$(jq -r '.linkedIssueId // empty' <<<"${risk_json}")"
+  [[ -n "${linked_issue_id}" ]] || return 0
+  [[ "$(pr_linked_issue_should_close "${linked_issue_id}")" == "no" ]] || return 0
+
+  bash "${FLOW_TOOLS_DIR}/sync-recurring-issue-checklist.sh" \
+    --repo-slug "${REPO_SLUG}" \
+    --issue-id "${linked_issue_id}" >/dev/null 2>&1 || true
+}
+
+pr_after_merged() {
+  local pr_number="${1:?pr number required}"
+  pr_clear_lane_override "$pr_number"
+  pr_best_effort_update_labels --repo-slug "${REPO_SLUG}" --number "$pr_number" --remove agent-running --remove agent-automerge --remove agent-repair-queued --remove agent-fix-needed --remove agent-manual-fix-override --remove agent-ci-refresh --remove agent-ci-bypassed --remove agent-double-check-1/2 --remove agent-double-check-2/2 --remove agent-human-review --remove agent-human-approved --remove agent-blocked --remove agent-handoff --remove agent-exclusive
+  pr_refresh_linked_issue_checklist "$pr_number"
+  "${FLOW_TOOLS_DIR}/kick-scheduler.sh" 5 >/dev/null || true
+}
+
+pr_after_closed() {
+  local pr_number="${1:?pr number required}"
+  pr_clear_lane_override "$pr_number"
+  pr_best_effort_update_labels --repo-slug "${REPO_SLUG}" --number "$pr_number" --remove agent-running --remove agent-automerge --remove agent-repair-queued --remove agent-fix-needed --remove agent-manual-fix-override --remove agent-ci-refresh --remove agent-ci-bypassed --remove agent-double-check-1/2 --remove agent-double-check-2/2 --remove agent-human-review --remove agent-human-approved --remove agent-blocked --remove agent-handoff --remove agent-exclusive
+  "${FLOW_TOOLS_DIR}/kick-scheduler.sh" 5 >/dev/null || true
+}
+
+pr_automerge_allowed() {
+  local pr_number="${1:?pr number required}"
+  local risk_json
+  risk_json="$("${ADAPTER_BIN_DIR}/pr-risk.sh" "$pr_number")"
+  local lane
+  lane="$(jq -r '.agentLane' <<<"$risk_json")"
+  if [[ "$lane" == "automerge" || "$lane" == "double-check-2" || "$(jq -r '.eligibleForAutoMerge' <<<"$risk_json")" == "true" ]]; then
+    printf 'yes\n'
+  else
+    printf 'no\n'
+  fi
+}
+
+pr_review_pass_action() {
+  local pr_number="${1:?pr number required}"
+  local risk_json lane
+  risk_json="$("${ADAPTER_BIN_DIR}/pr-risk.sh" "$pr_number")"
+  lane="$(jq -r '.agentLane' <<<"$risk_json")"
+
+  case "$lane" in
+    double-check-1)
+      printf 'advance-double-check-2\n'
+      ;;
+    double-check-2|automerge)
+      printf 'merge\n'
+      ;;
+    human-review)
+      printf 'wait-human\n'
+      ;;
+    *)
+      printf 'merge\n'
+      ;;
+  esac
+}
+
+pr_after_double_check_advanced() {
+  local pr_number="${1:?pr number required}"
+  local next_stage="${2:?next stage required}"
+  local next_label=""
+
+  case "$next_stage" in
+    2) next_label="agent-double-check-2/2" ;;
+    *) echo "unsupported double-check stage: $next_stage" >&2; return 1 ;;
+  esac
+
+  pr_set_lane_override "$pr_number" "double-check-${next_stage}"
+  pr_best_effort_update_labels --repo-slug "${REPO_SLUG}" --number "$pr_number" --remove agent-running --remove agent-automerge --remove agent-repair-queued --remove agent-fix-needed --remove agent-manual-fix-override --remove agent-ci-refresh --remove agent-human-review --remove agent-human-approved --remove agent-double-check-1/2 --remove agent-double-check-2/2 --add "$next_label"
+  pr_best_effort_sync_pr_labels "$pr_number"
+  "${FLOW_TOOLS_DIR}/kick-scheduler.sh" 5 >/dev/null || true
+}
+
+pr_after_updated_branch() {
+  local pr_number="${1:?pr number required}"
+  pr_clear_lane_override "$pr_number"
+  pr_best_effort_update_labels --repo-slug "${REPO_SLUG}" --number "$pr_number" --remove agent-running --remove agent-blocked --remove agent-repair-queued --remove agent-fix-needed --remove agent-manual-fix-override --remove agent-ci-refresh --remove agent-double-check-1/2 --remove agent-double-check-2/2 --remove agent-human-approved
+  pr_best_effort_sync_pr_labels "$pr_number"
+}
+
+pr_after_blocked() {
+  local pr_number="${1:?pr number required}"
+  pr_clear_lane_override "$pr_number"
+  pr_best_effort_update_labels --repo-slug "${REPO_SLUG}" --number "$pr_number" --remove agent-running --remove agent-blocked --remove agent-automerge --remove agent-ci-refresh --remove agent-ci-bypassed --remove agent-double-check-1/2 --remove agent-double-check-2/2 --remove agent-human-review --remove agent-human-approved --remove agent-fix-needed --remove agent-manual-fix-override --add agent-repair-queued
+  pr_best_effort_sync_pr_labels "$pr_number"
+}
+
+pr_after_succeeded() {
+  local pr_number="${1:?pr number required}"
+  pr_clear_lane_override "$pr_number"
+  pr_best_effort_update_labels --repo-slug "${REPO_SLUG}" --number "$pr_number" --remove agent-running --remove agent-repair-queued --remove agent-fix-needed --remove agent-manual-fix-override --remove agent-ci-refresh --remove agent-double-check-1/2 --remove agent-double-check-2/2
+  pr_best_effort_sync_pr_labels "$pr_number"
+}
+
+pr_after_failed() {
+  local pr_number="${1:?pr number required}"
+  pr_clear_lane_override "$pr_number"
+  pr_best_effort_update_labels --repo-slug "${REPO_SLUG}" --number "$pr_number" --remove agent-running --remove agent-blocked --remove agent-repair-queued --remove agent-fix-needed --remove agent-manual-fix-override --remove agent-ci-refresh --remove agent-double-check-1/2 --remove agent-double-check-2/2
+  pr_best_effort_sync_pr_labels "$pr_number"
+}
+
+pr_after_reconciled() {
+  "${FLOW_TOOLS_DIR}/kick-scheduler.sh" 2 >/dev/null || true
+}