agent-control-plane 0.1.0

package/tools/tests/test-sync-recurring-issue-checklist.sh

@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SCRIPT="${FLOW_ROOT}/tools/bin/sync-recurring-issue-checklist.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+bin_dir="$tmpdir/bin"
+mkdir -p "$bin_dir"
+
+patched_body_file="$tmpdir/patched-body.json"
+
+cat >"$bin_dir/gh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+patched_body_file="${TEST_PATCHED_BODY_FILE:?}"
+
+if [[ "${1:-}" == "issue" && "${2:-}" == "view" ]]; then
+  cat <<'JSON'
+{"number":42,"state":"OPEN","title":"Recurring checklist demo","body":"This is a recurring keep-open issue.\n\nChecklist:\n- [ ] Add a `completedRatio` field to the summary output.\n- [ ] Document one example command per output mode in `README.md`.\n","url":"https://example.test/issues/42","labels":[{"name":"agent-keep-open"}],"comments":[{"body":"Opened PR #11: https://example.test/pull/11","createdAt":"2026-03-27T10:00:00Z"},{"body":"Opened PR #12: https://example.test/pull/12","createdAt":"2026-03-27T11:00:00Z"}],"createdAt":"2026-03-27T09:00:00Z","updatedAt":"2026-03-27T11:00:00Z"}
+JSON
+  exit 0
+fi
+
+if [[ "${1:-}" == "pr" && "${2:-}" == "view" ]]; then
+  pr_number="${3:-}"
+  case "${pr_number}" in
+    11)
+      cat <<'JSON'
+{"number":11,"title":"feat(task-metrics): add completedRatio to summary output","body":"Implements the completedRatio checklist item.","url":"https://example.test/pull/11","headRefName":"agent/demo/issue-42-completed-ratio","baseRefName":"main","mergeStateStatus":"MERGED","statusCheckRollup":[],"labels":[],"comments":[],"state":"MERGED","isDraft":false}
+JSON
+      ;;
+    12)
+      cat <<'JSON'
+{"number":12,"title":"docs(readme): add example commands per output mode","body":"Adds README examples for each output mode.","url":"https://example.test/pull/12","headRefName":"agent/demo/issue-42-readme-examples","baseRefName":"main","mergeStateStatus":"MERGED","statusCheckRollup":[],"labels":[],"comments":[],"state":"MERGED","isDraft":false}
+JSON
+      ;;
+    *)
+      echo "unexpected pr view: $*" >&2
+      exit 1
+      ;;
+  esac
+  exit 0
+fi
+
+if [[ "${1:-}" == "api" ]]; then
+  route="${2:-}"
+  shift 2
+  if [[ "${route}" == "repos/example/demo/issues/42" ]]; then
+    input_file=""
+    while [[ $# -gt 0 ]]; do
+      case "$1" in
+        --input)
+          input_file="${2:-}"
+          shift 2
+          ;;
+        *)
+          shift
+          ;;
+      esac
+    done
+    if [[ -n "${input_file}" && -f "${input_file}" ]]; then
+      cp "${input_file}" "$patched_body_file"
+    else
+      cat >"$patched_body_file"
+    fi
+    exit 0
+  fi
+fi
+
+echo "unexpected gh args: $*" >&2
+exit 1
+EOF
+chmod +x "$bin_dir/gh"
+
+out="$(
+  PATH="$bin_dir:$PATH" \
+  TEST_PATCHED_BODY_FILE="$patched_body_file" \
+  bash "$SCRIPT" --repo-slug example/demo --issue-id 42
+)"
+
+grep -q '^CHECKLIST_SYNC_STATUS=updated$' <<<"$out"
+grep -q '^CHECKLIST_TOTAL=2$' <<<"$out"
+grep -q '^CHECKLIST_CHECKED=2$' <<<"$out"
+grep -q '^CHECKLIST_UNCHECKED=0$' <<<"$out"
+grep -q '^CHECKLIST_MATCHED_PR_NUMBERS=11,12$' <<<"$out"
+
+test -f "$patched_body_file"
+jq -r '.body' "$patched_body_file" | grep -q -- '- \[x\] Add a `completedRatio` field to the summary output\.'
+jq -r '.body' "$patched_body_file" | grep -q -- '- \[x\] Document one example command per output mode in `README.md`\.'
+
+echo "sync recurring issue checklist test passed"

package/tools/tests/test-sync-shared-agent-home-local-source-root.sh

@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SYNC_SCRIPT="${FLOW_ROOT}/tools/bin/sync-shared-agent-home.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+source_home="$tmpdir/source-home"
+target_home="$tmpdir/runtime-home"
+
+mkdir -p \
+  "$source_home/tools/bin" \
+  "$source_home/skills/openclaw/codex-quota-manager/scripts"
+mkdir -p "$source_home/.git/objects/aa"
+printf 'fake-object\n' >"$source_home/.git/objects/aa/test"
+
+cat >"$source_home/tools/bin/test-shared-tool" <<'INNER'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'shared-tool-ok\n'
+INNER
+
+cat >"$source_home/skills/openclaw/codex-quota-manager/scripts/auto-switch.sh" <<'INNER'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'quota-switch-ok\n'
+INNER
+
+chmod +x \
+  "$source_home/tools/bin/test-shared-tool" \
+  "$source_home/skills/openclaw/codex-quota-manager/scripts/auto-switch.sh"
+
+mkdir -p \
+  "$source_home/skills/openclaw/legacy-agent-control-plane/assets" \
+  "$target_home/skills/openclaw/legacy-agent-control-plane/assets" \
+  "$source_home/flows/project-adapters" \
+  "$source_home/flows/profiles" \
+  "$target_home/flows/project-adapters" \
+  "$target_home/flows/profiles"
+printf '{"control_plane":"stale"}\n' >"$source_home/skills/openclaw/legacy-agent-control-plane/assets/workflow-catalog.json"
+printf '{"control_plane":"stale"}\n' >"$target_home/skills/openclaw/legacy-agent-control-plane/assets/workflow-catalog.json"
+printf 'stale-source-publication\n' >"$source_home/flows/project-adapters/legacy-project.yaml"
+printf 'stale-source-profile\n' >"$source_home/flows/profiles/legacy-project"
+ln -s ../../skills/openclaw/legacy-agent-control-plane/assets/legacy-project.yaml "$target_home/flows/project-adapters/legacy-project.yaml"
+printf 'stale-runtime-profile\n' >"$target_home/flows/profiles/legacy-project"
+
+bash "$SYNC_SCRIPT" "$source_home" "$target_home" >/dev/null
+
+test -f "$source_home/skills/openclaw/agent-control-plane/SKILL.md"
+test -f "$source_home/skills/openclaw/agent-control-plane/assets/workflow-catalog.json"
+test -f "$source_home/.git/objects/aa/test"
+test ! -e "$source_home/skills/openclaw/agent-control-plane/profiles"
+test ! -e "$source_home/skills/openclaw/legacy-agent-control-plane"
+test ! -e "$source_home/flows/project-adapters"
+test ! -e "$source_home/flows/profiles"
+test -f "$target_home/skills/openclaw/agent-control-plane/SKILL.md"
+test -f "$target_home/skills/openclaw/agent-control-plane/assets/workflow-catalog.json"
+test ! -e "$target_home/.git"
+test ! -e "$target_home/skills/openclaw/agent-control-plane/profiles"
+test ! -e "$target_home/skills/openclaw/legacy-agent-control-plane"
+test ! -e "$target_home/flows/project-adapters"
+test ! -e "$target_home/flows/profiles"
+
+echo "sync-shared-agent-home local source root test passed"

package/tools/tests/test-sync-shared-agent-home-preserves-unrelated-workflow-catalog-skill.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SYNC_SCRIPT="${FLOW_ROOT}/tools/bin/sync-shared-agent-home.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+source_home="$tmpdir/source-home"
+target_home="$tmpdir/runtime-home"
+
+mkdir -p   "$source_home/tools/bin"   "$source_home/skills/openclaw/codex-quota-manager/scripts"   "$source_home/skills/openclaw/unrelated-skill/assets"   "$target_home/skills/openclaw/unrelated-skill/assets"
+
+cat >"$source_home/tools/bin/test-shared-tool" <<'INNER'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'shared-tool-ok
+'
+INNER
+
+cat >"$source_home/skills/openclaw/codex-quota-manager/scripts/auto-switch.sh" <<'INNER'
+#!/usr/bin/env bash
+set -euo pipefail
+printf 'quota-switch-ok
+'
+INNER
+
+printf '# unrelated skill
+' >"$source_home/skills/openclaw/unrelated-skill/SKILL.md"
+printf '{"catalog":"keep"}
+' >"$source_home/skills/openclaw/unrelated-skill/assets/workflow-catalog.json"
+printf '# unrelated skill
+' >"$target_home/skills/openclaw/unrelated-skill/SKILL.md"
+printf '{"catalog":"keep"}
+' >"$target_home/skills/openclaw/unrelated-skill/assets/workflow-catalog.json"
+
+chmod +x   "$source_home/tools/bin/test-shared-tool"   "$source_home/skills/openclaw/codex-quota-manager/scripts/auto-switch.sh"
+
+bash "$SYNC_SCRIPT" "$source_home" "$target_home" >/dev/null
+
+test -f "$source_home/skills/openclaw/unrelated-skill/SKILL.md"
+test -f "$source_home/skills/openclaw/unrelated-skill/assets/workflow-catalog.json"
+test -f "$target_home/skills/openclaw/unrelated-skill/SKILL.md"
+test -f "$target_home/skills/openclaw/unrelated-skill/assets/workflow-catalog.json"
+
+echo "sync-shared-agent-home preserves unrelated workflow-catalog skill test passed"

package/tools/tests/test-test-smoke.sh

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SMOKE_BIN="${FLOW_ROOT}/tools/bin/test-smoke.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "${tmpdir}"' EXIT
+
+call_log="${tmpdir}/calls.log"
+check_stub="${tmpdir}/check.sh"
+profile_stub="${tmpdir}/profile.sh"
+runtimectl_stub="${tmpdir}/runtimectl.sh"
+fail_stub="${tmpdir}/fail.sh"
+
+write_stub() {
+  local path="${1:?path required}"
+  local label="${2:?label required}"
+  local body="${3:-}"
+  cat >"${path}" <<EOF
+#!/usr/bin/env bash
+set -euo pipefail
+printf '%s\n' "${label}" >>"${call_log}"
+${body}
+EOF
+  chmod +x "${path}"
+}
+
+write_stub "${check_stub}" "check"
+write_stub "${profile_stub}" "profile"
+write_stub "${runtimectl_stub}" "runtimectl"
+write_stub "${fail_stub}" "fail" "exit 23"
+
+success_output="$(
+  ACP_TEST_SMOKE_CHECK_CONTRACTS_SCRIPT="${check_stub}" \
+  ACP_TEST_SMOKE_PROFILE_TEST_SCRIPT="${profile_stub}" \
+  ACP_TEST_SMOKE_RUNTIMECTL_TEST_SCRIPT="${runtimectl_stub}" \
+    bash "${SMOKE_BIN}"
+)"
+
+grep -q '^SMOKE_STEP=check-skill-contracts$' <<<"${success_output}"
+grep -q '^SMOKE_STEP=test-profile-smoke$' <<<"${success_output}"
+grep -q '^SMOKE_STEP=test-project-runtimectl$' <<<"${success_output}"
+[[ "$(grep -c '^SMOKE_STEP_STATUS=ok$' <<<"${success_output}")" -eq 3 ]]
+grep -q '^SMOKE_TEST_STATUS=ok$' <<<"${success_output}"
+grep -q '^check$' "${call_log}"
+grep -q '^profile$' "${call_log}"
+grep -q '^runtimectl$' "${call_log}"
+
+success_calls=()
+while IFS= read -r line; do
+  success_calls+=("${line}")
+done <"${call_log}"
+[[ "${success_calls[0]}" == "check" ]]
+[[ "${success_calls[1]}" == "profile" ]]
+[[ "${success_calls[2]}" == "runtimectl" ]]
+
+: >"${call_log}"
+
+set +e
+failure_output="$(
+  ACP_TEST_SMOKE_CHECK_CONTRACTS_SCRIPT="${check_stub}" \
+  ACP_TEST_SMOKE_PROFILE_TEST_SCRIPT="${fail_stub}" \
+  ACP_TEST_SMOKE_RUNTIMECTL_TEST_SCRIPT="${runtimectl_stub}" \
+    bash "${SMOKE_BIN}" 2>&1
+)"
+failure_status=$?
+set -e
+
+[[ "${failure_status}" -eq 23 ]]
+grep -q '^SMOKE_STEP=check-skill-contracts$' <<<"${failure_output}"
+grep -q '^SMOKE_STEP=test-profile-smoke$' <<<"${failure_output}"
+grep -q '^SMOKE_STEP_STATUS=failed$' <<<"${failure_output}"
+grep -q '^FAILED_STEP=test-profile-smoke$' <<<"${failure_output}"
+grep -q '^EXIT_CODE=23$' <<<"${failure_output}"
+grep -q '^SMOKE_TEST_STATUS=failed$' <<<"${failure_output}"
+
+failure_calls=()
+while IFS= read -r line; do
+  failure_calls+=("${line}")
+done <"${call_log}"
+[[ "${failure_calls[0]}" == "check" ]]
+[[ "${failure_calls[1]}" == "fail" ]]
+[[ "${#failure_calls[@]}" -eq 2 ]]
+
+echo "test smoke entrypoint test passed"

package/tools/tests/test-uninstall-project-launchd.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+UNINSTALL_BIN="${FLOW_ROOT}/tools/bin/uninstall-project-launchd.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+home_dir="$tmpdir/home"
+workspace_dir="$home_dir/.agent-runtime/control-plane/workspace"
+launch_agents_dir="$home_dir/Library/LaunchAgents"
+label="ai.agent.project.demo"
+wrapper_path="$workspace_dir/bin/agent-project-demo-launchd.sh"
+plist_path="$launch_agents_dir/$label.plist"
+
+mkdir -p "$(dirname "$wrapper_path")" "$launch_agents_dir"
+printf '#!/usr/bin/env bash\n' >"$wrapper_path"
+printf '<plist></plist>\n' >"$plist_path"
+
+output="$(
+  ACP_PROJECT_RUNTIME_HOME_DIR="$home_dir" \
+  ACP_PROJECT_RUNTIME_WORKSPACE_DIR="$workspace_dir" \
+  ACP_PROJECT_RUNTIME_LAUNCH_AGENTS_DIR="$launch_agents_dir" \
+  ACP_PROJECT_RUNTIME_SKIP_LAUNCHCTL=1 \
+  bash "$UNINSTALL_BIN" --profile-id demo
+)"
+
+grep -q '^LAUNCHD_UNINSTALL_STATUS=ok$' <<<"$output"
+grep -q '^PROFILE_ID=demo$' <<<"$output"
+grep -q "^LABEL=$label$" <<<"$output"
+grep -q "^PLIST=$plist_path$" <<<"$output"
+grep -q "^WRAPPER=$wrapper_path$" <<<"$output"
+[[ ! -e "$wrapper_path" ]]
+[[ ! -e "$plist_path" ]]
+
+echo "uninstall project launchd test passed"

package/tools/tests/test-update-github-labels-prefers-sibling-helper.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SCRIPT_SRC="${FLOW_ROOT}/tools/bin/update-github-labels.sh"
+CONFIG_LIB_SRC="${FLOW_ROOT}/tools/bin/flow-config-lib.sh"
+SHELL_LIB_SRC="${FLOW_ROOT}/tools/bin/flow-shell-lib.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+bin_dir="$tmpdir/bin"
+profile_home="$tmpdir/profiles"
+log_file="$tmpdir/helper.log"
+
+mkdir -p "$bin_dir" "$profile_home/demo"
+
+cp "$SCRIPT_SRC" "$bin_dir/update-github-labels.sh"
+cp "$CONFIG_LIB_SRC" "$bin_dir/flow-config-lib.sh"
+cp "$SHELL_LIB_SRC" "$bin_dir/flow-shell-lib.sh"
+
+cat >"$profile_home/demo/control-plane.yaml" <<'EOF'
+schema_version: "1"
+id: "demo"
+repo:
+  slug: "example/demo"
+EOF
+
+cat >"$bin_dir/agent-github-update-labels" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+printf '%s\n' "$*" >"${TEST_HELPER_LOG:?}"
+EOF
+
+chmod +x \
+  "$bin_dir/update-github-labels.sh" \
+  "$bin_dir/flow-config-lib.sh" \
+  "$bin_dir/flow-shell-lib.sh" \
+  "$bin_dir/agent-github-update-labels"
+
+TEST_HELPER_LOG="$log_file" \
+ACP_PROFILE_REGISTRY_ROOT="$profile_home" \
+ACP_PROJECT_ID="demo" \
+AGENT_CONTROL_PLANE_ROOT="$tmpdir/not-a-skill-root" \
+bash "$bin_dir/update-github-labels.sh" 42 --add ready --remove blocked
+
+grep -q -- '--repo-slug example/demo --number 42 --add ready --remove blocked' "$log_file"
+
+echo "update-github-labels sibling helper test passed"

package/tools/tests/test-workflow-catalog.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+CATALOG_SCRIPT="${FLOW_ROOT}/tools/bin/workflow-catalog.sh"
+SCAFFOLD_SCRIPT="${FLOW_ROOT}/tools/bin/scaffold-profile.sh"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+profile_home="$tmpdir/profiles"
+
+bash "$SCAFFOLD_SCRIPT" --profile-home "$profile_home" --profile-id alpha --repo-slug example/alpha >/dev/null
+bash "$SCAFFOLD_SCRIPT" --profile-home "$profile_home" --profile-id demo --repo-slug example/demo-platform >/dev/null
+
+list_out="$(ACP_PROFILE_REGISTRY_ROOT="$profile_home" bash "$CATALOG_SCRIPT" list)"
+grep -q '^issue-implementation' <<<"$list_out"
+grep -q '^pr-review' <<<"$list_out"
+
+profiles_out="$(ACP_PROFILE_REGISTRY_ROOT="$profile_home" bash "$CATALOG_SCRIPT" profiles)"
+grep -q '^alpha$' <<<"$profiles_out"
+grep -q '^demo$' <<<"$profiles_out"
+
+context_out="$(ACP_PROFILE_REGISTRY_ROOT="$profile_home" bash "$CATALOG_SCRIPT" context)"
+grep -q '^ACTIVE_PROFILE=alpha$' <<<"$context_out"
+grep -q '^PROFILE_SELECTION_MODE=implicit-default$' <<<"$context_out"
+grep -q '^PROFILE_NOTES=' <<<"$context_out"
+
+show_out="$(ACP_PROFILE_REGISTRY_ROOT="$profile_home" bash "$CATALOG_SCRIPT" show pr-review)"
+grep -q '^ACTIVE_PROFILE=alpha$' <<<"$show_out"
+grep -q '^PROFILE_SELECTION_MODE=implicit-default$' <<<"$show_out"
+grep -q '^ID=pr-review$' <<<"$show_out"
+grep -q '^ENTRYPOINT=tools/bin/start-pr-review-worker.sh$' <<<"$show_out"
+
+json_out="$(ACP_PROFILE_REGISTRY_ROOT="$profile_home" bash "$CATALOG_SCRIPT" json)"
+grep -q '"control_plane": "agent-control-plane"' <<<"$json_out"
+grep -q '"available_profiles": \[' <<<"$json_out"
+grep -q '"active_profile": "alpha"' <<<"$json_out"
+grep -q '"profile_selection_mode": "implicit-default"' <<<"$json_out"
+grep -q '"demo"' <<<"$json_out"
+grep -q '"id": "pr-fix"' <<<"$json_out"
+
+echo "workflow catalog test passed"

package/tools/vendor/codex-quota/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shuv1337
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.