agent-control-plane 0.2.0 → 0.4.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-control-plane",
-  "version": "0.2.0",
+  "version": "0.4.9",
   "description": "Help a repo keep GitHub-driven coding agents running reliably without constant human babysitting",
   "homepage": "https://github.com/ducminhnguyen0319/agent-control-plane",
   "bugs": {
@@ -19,7 +19,6 @@
   },
   "files": [
     "README.md",
-    "SKILL.md",
     "assets/workflow-catalog.json",
     "bin/agent-control-plane",
     "bin/issue-resource-class.sh",
@@ -28,11 +27,12 @@
     "bin/sync-pr-labels.sh",
     "hooks",
     "npm/bin",
-    "references",
     "tools/bin",
-    "!tools/bin/audit-*.sh",
-    "!tools/bin/check-skill-contracts.sh",
-    "!tools/bin/render-dashboard-snapshot.py",
+  "!tools/bin/audit-*.sh",
+  "!tools/bin/check-skill-contracts.sh",
+  "!tools/bin/split-retained-slice.sh",
+  "!tools/bin/render-dashboard-snapshot.py",
+  "!tools/bin/resident-issue-queue-status.py",
     "tools/dashboard/app.js",
     "tools/dashboard/dashboard_snapshot.py",
     "tools/dashboard/index.html",
@@ -48,7 +48,11 @@
   "scripts": {
     "doctor": "node ./npm/bin/agent-control-plane.js doctor",
     "smoke": "node ./npm/bin/agent-control-plane.js smoke",
-    "test": "bash tools/tests/test-agent-control-plane-npm-cli.sh && bash tools/tests/test-agent-project-detached-launch-stable-cwd.sh && bash tools/tests/test-agent-project-claude-session-wrapper-reaps-child-on-term.sh && bash tools/tests/test-agent-project-claude-session-wrapper-does-not-retry-provider-quota.sh && bash tools/tests/test-agent-project-reconcile-issue-provider-quota-schedules-provider-cooldown.sh && bash tools/tests/test-pr-reconcile-hooks-refreshes-recurring-issue-checklist.sh && bash tools/tests/test-issue-reconcile-hooks-kick-scheduler-uses-profile.sh && bash tools/tests/test-profile-adopt-skip-anchor-sync-creates-agent-repo-root.sh && bash tools/tests/test-vendored-codex-quota-claude-oauth-only.sh && bash tools/tests/test-package-smoke-command.sh"
+    "test": "node -e \"const { spawnSync } = require('node:child_process'); const result = spawnSync('bash', ['tools/tests/run-all.sh'], { stdio: 'inherit' }); if (result.error) throw result.error; process.exit(result.status ?? 1);\""
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
   },
   "keywords": [
     "agents",

package/tools/bin/agent-github-update-labels

@@ -20,6 +20,7 @@ number=""
 add_file="$(mktemp)"
 remove_file="$(mktemp)"
 trap 'rm -f "$add_file" "$remove_file"' EXIT
+github_outbox_script="${SCRIPT_DIR}/github-write-outbox.sh"
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
@@ -47,12 +48,40 @@ if [[ -z "$repo_slug" || -z "$number" ]]; then
   exit 1
 fi
 
+enqueue_label_update() {
+  local -a args=()
+  local label=""
+
+  [[ "${ACP_GITHUB_OUTBOX_DISABLE_ENQUEUE:-0}" != "1" ]] || return 1
+  [[ -x "${github_outbox_script}" ]] || return 1
+
+  args=(enqueue-labels --repo-slug "${repo_slug}" --number "${number}")
+  while IFS= read -r label; do
+    [[ -n "${label}" ]] || continue
+    args+=(--add "${label}")
+  done <"${add_file}"
+  while IFS= read -r label; do
+    [[ -n "${label}" ]] || continue
+    args+=(--remove "${label}")
+  done <"${remove_file}"
+
+  "${github_outbox_script}" "${args[@]}" >/dev/null
+}
+
 resource="issues/${number}"
+if flow_github_core_rate_limit_active; then
+  enqueue_label_update && exit 0
+  exit 1
+fi
+
 # Use caller-provided cached JSON if available to skip the GET call
 if [[ -n "${ACP_CACHED_ISSUE_JSON:-}" ]]; then
   current_json="${ACP_CACHED_ISSUE_JSON}"
 else
-  current_json="$(flow_github_api_repo "${repo_slug}" "${resource}")"
+  if ! current_json="$(flow_github_api_repo "${repo_slug}" "${resource}")"; then
+    enqueue_label_update && exit 0
+    exit 1
+  fi
 fi
 add_json="$(jq -R . <"$add_file" | jq -s .)"
 remove_json="$(jq -R . <"$remove_file" | jq -s .)"
@@ -68,4 +97,9 @@ process.stdout.write(JSON.stringify({ labels: Array.from(labels).sort() }));
 EOF
 )"
 
-printf '%s' "$payload" | flow_github_api_repo "${repo_slug}" "${resource}" --method PATCH --input - >/dev/null
+if printf '%s' "$payload" | flow_github_api_repo "${repo_slug}" "${resource}" --method PATCH --input - >/dev/null; then
+  exit 0
+fi
+
+enqueue_label_update && exit 0
+exit 1

package/tools/bin/agent-project-catch-up-merged-prs

@@ -46,6 +46,7 @@ optional_hooks=(
   pr_cleanup_merged_residue
   pr_linked_issue_should_close
   pr_after_merged
+  pr_after_closed
 )
 
 for hook_name in "${optional_hooks[@]}"; do
@@ -54,8 +55,9 @@ for hook_name in "${optional_hooks[@]}"; do
   fi
 done
 
-merged_ledger_dir="${state_root}/merged-pr-catchup"
-closed_ledger_dir="${state_root}/closed-pr-catchup"
+forge_scope="$(printf '%s' "${ACP_FORGE_PROVIDER:-${F_LOSNING_FORGE_PROVIDER:-github}}" | tr -c '[:alnum:]._-' '-')"
+merged_ledger_dir="${state_root}/merged-pr-catchup-${forge_scope}"
+closed_ledger_dir="${state_root}/closed-pr-catchup-${forge_scope}"
 mkdir -p "$merged_ledger_dir" "$closed_ledger_dir"
 
 get_pr_risk_json() {

package/tools/bin/agent-project-cleanup-session

@@ -95,6 +95,7 @@ cleanup_error=""
 cleanup_mode="noop"
 orphan_fallback_used="false"
 active_tmux_session="false"
+archived_dir=""
 
 if [[ -n "$session" ]]; then
   meta_file="${runs_root}/${session}/run.env"
@@ -390,6 +391,47 @@ cleanup_orphan_worktree_dir() {
   git -C "$repo_root" worktree prune >/dev/null 2>&1 || true
 }
 
+worktree_path_is_registered() {
+  local candidate_path="${1:-}"
+  [[ -n "${candidate_path}" ]] || return 1
+
+  git -C "$repo_root" worktree list --porcelain 2>/dev/null \
+    | grep -F -x -q -- "worktree ${candidate_path}"
+}
+
+write_cleanup_warning_artifact() {
+  local target_dir=""
+  local notice_file=""
+  local cleanup_error_line=""
+  local recorded_at=""
+
+  [[ "${cleanup_status}" != "0" ]] || return 0
+
+  if [[ -n "${archived_dir}" && -d "${archived_dir}" ]]; then
+    target_dir="${archived_dir}"
+  elif [[ -n "${session}" && -n "${runs_root}" && -d "${runs_root}/${session}" ]]; then
+    target_dir="${runs_root}/${session}"
+  fi
+
+  [[ -n "${target_dir}" && -d "${target_dir}" ]] || return 0
+
+  cleanup_error_line="$(printf '%s' "${cleanup_error}" | tr '\n' ' ' | sed 's/  */ /g')"
+  recorded_at="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+  notice_file="${target_dir}/cleanup-warning.txt"
+  {
+    printf 'recorded_at=%s\n' "${recorded_at}"
+    printf 'session=%s\n' "${session}"
+    printf 'mode=%s\n' "${mode}"
+    printf 'worktree=%s\n' "${worktree_path}"
+    printf 'branch=%s\n' "${branch_name}"
+    printf 'cleanup_mode=%s\n' "${cleanup_mode}"
+    printf 'cleanup_status=%s\n' "${cleanup_status}"
+    if [[ -n "${cleanup_error_line}" ]]; then
+      printf 'cleanup_error=%s\n' "${cleanup_error_line}"
+    fi
+  } >"${notice_file}"
+}
+
 if [[ "$active_tmux_session" == "true" ]]; then
   cleanup_mode="deferred-active-session"
 elif [[ "$skip_worktree_cleanup" != "true" && -n "${worktree_path}" ]] \
@@ -413,7 +455,7 @@ elif [[ "$skip_worktree_cleanup" != "true" && -n "$branch_name" ]]; then
       fi
     fi
   fi
-elif [[ "$skip_worktree_cleanup" != "true" && -n "$worktree_path" ]] && git -C "$repo_root" worktree list --porcelain | rg -F -q "worktree $worktree_path"; then
+elif [[ "$skip_worktree_cleanup" != "true" && -n "$worktree_path" ]] && worktree_path_is_registered "$worktree_path"; then
   git -C "$repo_root" worktree remove "$worktree_path" --force || true
   git -C "$repo_root" worktree prune
   cleanup_mode="worktree"
@@ -433,16 +475,14 @@ if [[ -n "$session" && "$active_tmux_session" != "true" ]]; then
       --session "$session" \
       --remove-file "${remove_file:-}"
   )"
+  archived_dir="$(awk -F= '/^ARCHIVED_DIR=/{print substr($0, index($0, "=") + 1); exit}' <<<"${archive_output}")"
 fi
 
 if [[ "$skip_worktree_cleanup" != "true" && -n "$worktree_path" && ! -d "$worktree_path" ]]; then
   clear_resident_worktree_realpath_references "$worktree_path"
 fi
 
-if [[ "$cleanup_status" != "0" && -z "$session" ]]; then
-  [[ -n "$cleanup_error" ]] && printf '%s\n' "$cleanup_error" >&2
-  exit "$cleanup_status"
-fi
+write_cleanup_warning_artifact
 
 printf 'SESSION=%s\n' "$session"
 printf 'MODE=%s\n' "$mode"
@@ -467,3 +507,7 @@ fi
 if [[ "$cleanup_status" != "0" && -n "$cleanup_error" ]]; then
   printf 'CLEANUP_ERROR=%s\n' "$(printf '%s' "$cleanup_error" | tr '\n' ' ' | sed 's/  */ /g')"
 fi
+
+if [[ "$cleanup_status" != "0" ]]; then
+  exit "$cleanup_status"
+fi