agent-control-plane 0.3.0 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-control-plane",
-  "version": "0.3.0",
+  "version": "0.6.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": {
@@ -17,6 +17,23 @@
   "bin": {
     "agent-control-plane": "./bin/agent-control-plane"
   },
+  "keywords": [
+    "agents",
+    "automation",
+    "background-jobs",
+    "dashboard",
+    "control-plane",
+    "developer-tools",
+    "github-actions",
+    "github",
+    "npm",
+    "runtime"
+  ],
+  "scripts": {
+    "doctor": "node ./npm/bin/agent-control-plane.js doctor",
+    "smoke": "node ./npm/bin/agent-control-plane.js smoke",
+    "test": "bash tools/tests/test-package-surface.sh && bash tools/tests/test-package-public-metadata.sh"
+  },
   "files": [
     "README.md",
     "assets/workflow-catalog.json",
@@ -25,46 +42,36 @@
     "bin/label-follow-up-issues.sh",
     "bin/pr-risk.sh",
     "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/dashboard/app.js",
-    "tools/dashboard/dashboard_snapshot.py",
-    "tools/dashboard/index.html",
-    "tools/dashboard/server.py",
-    "tools/dashboard/styles.css",
-    "tools/templates",
-    "!tools/templates/legacy/",
+    "hooks/",
+    "npm/",
+    "tools/bin/agent-project-run-*.sh",
+    "tools/bin/flow-*.sh",
+    "tools/bin/project-*.sh",
+    "tools/bin/scaffold-*.sh",
+    "tools/bin/sync-*.sh",
+    "tools/bin/install-*.sh",
+    "tools/bin/uninstall-*.sh",
+    "tools/bin/debug-session.sh",
+    "tools/bin/ensure-*.sh",
+    "tools/bin/heartbeat-*.sh",
+    "tools/bin/github-*.sh",
+    "tools/bin/profile-*.sh",
+    "tools/bin/test-smoke.sh",
+    "tools/dashboard/",
+    "tools/templates/issue-prompt-template.md",
+    "tools/templates/pr-fix-template.md",
+    "tools/templates/pr-merge-repair-template.md",
+    "tools/templates/pr-review-template.md",
+    "tools/templates/scheduled-issue-prompt-template.md",
     "tools/vendor/codex-quota/LICENSE",
     "tools/vendor/codex-quota/codex-quota.js",
     "tools/vendor/codex-quota/lib",
     "tools/vendor/codex-quota-manager/scripts"
   ],
-  "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-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",
-    "automation",
-    "background-jobs",
-    "dashboard",
-    "control-plane",
-    "developer-tools",
-    "github-actions",
-    "github",
-    "npx",
-    "runtime"
-  ],
   "engines": {
     "node": ">=18"
   }

package/tools/bin/debug-session.sh

@@ -0,0 +1,106 @@
+#!/usr/bin/env bash
+# debug-session.sh - Troubleshoot ACP worker sessions
+# Usage: debug-session.sh [session-name]
+# If no session name given, lists all agent- sessions with diagnostics
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+SESSION_NAME="${1:-}"
+
+echo "=== ACP Session Debugger ==="
+echo ""
+
+# --- Check tmux ---
+if ! command -v tmux &>/dev/null; then
+    echo "ERROR: tmux is not installed. Cannot debug sessions."
+    exit 1
+fi
+
+# --- List or Debug Specific ---
+if [[ -z "${SESSION_NAME}" ]]; then
+    echo "--- All agent- tmux sessions ---"
+    tmux ls 2>/dev/null | grep "^agent-" || echo "No agent- sessions found."
+    echo ""
+    echo "Usage: $0 <session-name>"
+    echo "       $0 agent-control-plane"
+    exit 0
+fi
+
+# --- Check if session exists ---
+if ! tmux has-session -t "${SESSION_NAME}" 2>/dev/null; then
+    echo "ERROR: Session '${SESSION_NAME}' not found."
+    echo ""
+    echo "Available sessions:"
+    tmux ls 2>/dev/null | grep "^agent-" || echo "  (none)"
+    exit 1
+fi
+
+echo "--- Session: ${SESSION_NAME} ---"
+echo ""
+
+# --- Session Info ---
+echo "1. Session Info:"
+tmux display-message -t "${SESSION_NAME}" -p "Session created: #{session_created_string}" 2>/dev/null || true
+tmux display-message -t "${SESSION_NAME}" -p "Session width: #{session_width}, height: #{session_height}" 2>/dev/null || true
+echo ""
+
+# --- Pane List ---
+echo "2. Panes:"
+tmux list-panes -t "${SESSION_NAME}" -F "  Pane #{pane_index}: pid=#{pane_pid} [#{pane_width}x#{pane_height}] #{?pane_active,(active),}"
+echo ""
+
+# --- Recent Output (last 50 lines) ---
+echo "3. Recent Output (last 50 lines):"
+echo "--- START ---"
+tmux capture-pane -t "${SESSION_NAME}" -p -S -50 2>/dev/null || echo "(no output captured)"
+echo "--- END ---"
+echo ""
+
+# --- Process Tree ---
+echo "4. Process Tree:"
+PANE_PID=$(tmux display-message -t "${SESSION_NAME}" -p "#{pane_pid}" 2>/dev/null || echo "")
+if [[ -n "${PANE_PID}" ]]; then
+    if command -v pstree &>/dev/null; then
+        pstree -p "${PANE_PID}" 2>/dev/null || ps -p "${PANE_PID}" -o pid,ppid,cmd 2>/dev/null || echo "(cannot inspect process)"
+    else
+        ps -p "${PANE_PID}" -o pid,ppid,cmd 2>/dev/null || echo "(cannot inspect process)"
+    fi
+else
+    echo "(cannot get pane pid)"
+fi
+echo ""
+
+# --- Check for Common Issues ---
+echo "5. Diagnostics:"
+CAPTURE=$(tmux capture-pane -t "${SESSION_NAME}" -p -S -100 2>/dev/null || echo "")
+
+# Check for errors
+ERROR_COUNT=$(echo "${CAPTURE}" | grep -ic "error\|fail\|fatal\|exception" || true)
+echo "  Error-like lines in last 100: ${ERROR_COUNT}"
+
+# Check for stalls (no output for a while)
+if echo "${CAPTURE}" | tail -10 | grep -q "."; then
+    echo "  Recent output: yes"
+else
+    echo "  Recent output: NO (may be stalled)"
+fi
+
+# Check for specific worker patterns
+if echo "${CAPTURE}" | grep -q "streaming\|tool_use\|thinking"; then
+    echo "  Worker activity: active (streaming/tool_use detected)"
+elif echo "${CAPTURE}" | grep -q "IDLE\|waiting\|queue"; then
+    echo "  Worker activity: idle/waiting"
+else
+    echo "  Worker activity: unknown"
+fi
+echo ""
+
+# --- Offer Actions ---
+echo "6. Quick Actions:"
+echo "  Attach:    tmux attach -t ${SESSION_NAME}"
+echo "  Kill:      tmux kill-session -t ${SESSION_NAME}"
+echo "  Capture:   tmux capture-pane -t ${SESSION_NAME} -p > output.txt"
+echo ""
+
+echo "=== Debug Complete ==="