agent-control-plane 0.2.0 → 0.3.0

package/npm/bin/agent-control-plane.js

@@ -774,6 +774,9 @@ function detectPackageManager() {
   if (commandExists("brew")) {
     return { name: "brew" };
   }
+  if (commandExists("apt")) {
+    return { name: "apt" };
+  }
   if (commandExists("apt-get")) {
     return { name: "apt-get" };
   }
@@ -789,6 +792,9 @@ function detectPackageManager() {
   if (commandExists("zypper")) {
     return { name: "zypper" };
   }
+  if (commandExists("apk")) {
+    return { name: "apk" };
+  }
   return null;
 }
 
@@ -812,6 +818,24 @@ function dependencyPackageMap(managerName) {
         python3: "python3",
         tmux: "tmux"
       };
+    case "apt":
+      return {
+        bash: "bash",
+        git: "git",
+        gh: "gh",
+        jq: "jq",
+        python3: "python3",
+        tmux: "tmux"
+      };
+    case "apk":
+      return {
+        bash: "bash",
+        git: "git",
+        gh: "gh",
+        jq: "jq",
+        python3: "python3",
+        tmux: "tmux"
+      };
     case "dnf":
     case "yum":
       return {
@@ -870,6 +894,10 @@ function buildDependencyInstallPlan(missingTools) {
       commands.push([...prefix, "apt-get", "update"]);
       commands.push([...prefix, "apt-get", "install", "-y", ...packages]);
       break;
+    case "apt":
+      commands.push([...prefix, "apt", "update"]);
+      commands.push([...prefix, "apt", "install", "-y", ...packages]);
+      break;
     case "dnf":
       commands.push([...prefix, "dnf", "install", "-y", ...packages]);
       break;
@@ -882,6 +910,9 @@ function buildDependencyInstallPlan(missingTools) {
     case "zypper":
       commands.push([...prefix, "zypper", "install", "-y", ...packages]);
       break;
+    case "apk":
+      commands.push([...prefix, "apk", "add", "--no-cache", ...packages]);
+      break;
     default:
       return null;
   }
@@ -923,7 +954,7 @@ async function maybeInstallMissingDependencies(options, prereq) {
   if (!plan) {
     console.log("\nACP found missing core dependencies but cannot install them automatically on this machine.");
     console.log(`- missing tools: ${prereq.missingRequired.join(", ")}`);
-    console.log("- supported auto-install package managers today: brew, apt-get, dnf, yum, pacman, zypper");
+    console.log("- supported auto-install package managers today: brew, apt, apt-get, dnf, yum, pacman, zypper, apk");
     return {
       status: "unavailable",
       reason: "no-supported-package-manager",
@@ -1827,10 +1858,16 @@ async function collectSetupConfig(options, context) {
   let profileId = suggestedProfileId;
   let codingWorker = suggestedWorker;
 
-  if (!fs.existsSync(detectedRepoRoot)) {
+  const detectedRepoRootExists = fs.existsSync(detectedRepoRoot);
+  if (!detectedRepoRootExists && !options.allowMissingRepo) {
     throw new Error(`setup repo root does not exist: ${detectedRepoRoot}`);
   }
 
+  if (options.allowMissingRepo && !detectedRepoRootExists) {
+    console.log(`\nSource repo root not found yet: ${detectedRepoRoot}`);
+    console.log("- continuing because --allow-missing-repo was set; profile adopt will run in missing-repo mode.");
+  }
+
   if (!options.interactive) {
     if (!repoSlug) {
       throw new Error("setup could not detect --repo-slug automatically; pass --repo-slug <owner/repo> or run interactively inside a git checkout with origin set");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-control-plane",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "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",
@@ -48,7 +47,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": "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-run-codex-resilient-uses-path-python-and-gnu-stat.sh && bash tools/tests/test-heartbeat-safe-auto-uses-path-python.sh && bash tools/tests/test-heartbeat-safe-auto-skips-self-sync.sh && bash tools/tests/test-agent-project-catch-up-terminal-prs-defaults-closed-hook.sh && bash tools/tests/test-agent-project-codex-session-wrapper-prefers-path-codex.sh && bash tools/tests/test-agent-project-codex-session-wrapper-recovers-var-tmp-logged-artifacts.sh && bash tools/tests/test-agent-project-cleanup-session-removes-registered-worktree-without-rg.sh && bash tools/tests/test-agent-project-cleanup-session-propagates-failure-with-session.sh && bash tools/tests/test-cleanup-worktree-syncs-workspace-after-cleanup-failure.sh && bash tools/tests/test-resident-issue-queue-status-contract.sh && bash tools/tests/test-agent-project-reconcile-issue-provider-quota-schedules-provider-cooldown.sh && bash tools/tests/test-agent-project-reconcile-issue-session-warns-on-cleanup-failure.sh && bash tools/tests/test-agent-project-reconcile-pr-session-warns-on-cleanup-failure.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"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
   },
   "keywords": [
     "agents",

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

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