agent-control-plane 0.1.16 → 0.3.0

package/tools/dashboard/app.js

@@ -219,6 +219,9 @@ function renderProfile(profile) {
       ? `<span class="badge">${profile.provider_pool.backend}: ${profile.provider_pool.model || "n/a"}</span>`
       : "",
     profile.provider_pool.name ? `<span class="badge">${profile.provider_pool.name}</span>` : "",
+    profile.provider_pool.pools_exhausted
+      ? `<span class="badge warn">pools exhausted</span>`
+      : "",
     profile.provider_pool.last_reason ? `<span class="badge warn">${profile.provider_pool.last_reason}</span>` : "",
   ]
     .filter(Boolean)
@@ -280,6 +283,7 @@ function renderProfile(profile) {
     [
       { label: "Issue", key: "issue_id" },
       { label: "State", render: renderControllerState },
+      { label: "Lane", render: (row) => `${row.lane_kind || "n/a"} / ${row.lane_value || "n/a"}` },
       { label: "Reason", render: (row) => row.reason || "n/a" },
       { label: "Provider", render: (row) => `${row.provider_backend || "n/a"} ${row.provider_model || ""}`.trim() },
       { label: "Failover", render: (row) => `${row.provider_failover_count} failovers / ${row.provider_switch_count} switches` },
@@ -320,6 +324,7 @@ function renderProfile(profile) {
       { label: "Scope", key: "scope" },
       { label: "Worker", key: "coding_worker" },
       { label: "Issue", render: (row) => row.issue_id || "n/a" },
+      { label: "Lane", render: (row) => `${row.resident_lane_kind || "n/a"} / ${row.resident_lane_value || "n/a"}` },
       { label: "Tasks", key: "task_count" },
       { label: "Last status", render: (row) => row.last_status || "n/a" },
       { label: "Last started", render: (row) => row.last_started_at ? `${relativeTime(row.last_started_at)}<div class="muted">${row.last_started_at}</div>` : "n/a" },
@@ -355,6 +360,7 @@ function renderProfile(profile) {
     [
       { label: "Issue", key: "issue_id" },
       { label: "Session", render: (row) => row.session ? `<div class="mono">${row.session}</div>` : "n/a" },
+      { label: "Queued by", key: "queued_by" },
       { label: "Updated", render: (row) => row.updated_at ? `${relativeTime(row.updated_at)}<div class="muted">${row.updated_at}</div>` : "n/a" },
     ],
     profile.issue_queue.pending,
@@ -365,6 +371,7 @@ function renderProfile(profile) {
     [
       { label: "Issue", key: "issue_id" },
       { label: "Session", render: (row) => row.session ? `<div class="mono">${row.session}</div>` : "n/a" },
+      { label: "Claimed by", key: "claimer" },
       { label: "Updated", render: (row) => row.updated_at ? `${relativeTime(row.updated_at)}<div class="muted">${row.updated_at}</div>` : "n/a" },
     ],
     profile.issue_queue.claims || [],

package/tools/dashboard/dashboard_snapshot.py

@@ -13,9 +13,15 @@ from typing import Any
 
 ROOT_DIR = Path(__file__).resolve().parents[2]
 TOOLS_BIN_DIR = ROOT_DIR / "tools" / "bin"
+DASHBOARD_DIR = ROOT_DIR / "tools" / "dashboard"
 RENDER_FLOW_CONFIG = TOOLS_BIN_DIR / "render-flow-config.sh"
 WORKER_STATUS_TOOL = TOOLS_BIN_DIR / "agent-project-worker-status"
 
+if str(DASHBOARD_DIR) not in sys.path:
+    sys.path.insert(0, str(DASHBOARD_DIR))
+
+from issue_queue_state import collect_issue_queue
+
 
 def utc_now_iso() -> str:
     return datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
@@ -493,6 +499,13 @@ def collect_resident_workers(state_root: Path) -> list[dict[str, Any]]:
                 "last_action": env.get("LAST_ACTION", ""),
                 "last_failure_reason": env.get("LAST_FAILURE_REASON", ""),
                 "worktree": env.get("WORKTREE", ""),
+                "resident_lane_kind": env.get("RESIDENT_LANE_KIND", ""),
+                "resident_lane_value": env.get("RESIDENT_LANE_VALUE", ""),
+                "resident_lane": (
+                    f"{env.get('RESIDENT_LANE_KIND', '')}/{env.get('RESIDENT_LANE_VALUE', '')}"
+                    if env.get("RESIDENT_LANE_KIND", "") and env.get("RESIDENT_LANE_VALUE", "")
+                    else ""
+                ),
                 "metadata_file": str(path),
             }
         )
@@ -695,35 +708,6 @@ def resolve_history_root(render_env: dict[str, str], yaml_env: dict[str, str], r
         return runs_root.parent / "history"
     return Path(".")
 
-
-def collect_issue_queue(state_root: Path) -> dict[str, list[dict[str, Any]]]:
-    queue_root = state_root / "resident-workers" / "issue-queue"
-    pending_root = queue_root / "pending"
-    claims_root = queue_root / "claims"
-
-    def collect_files(root: Path) -> list[dict[str, Any]]:
-        if not root.is_dir():
-            return []
-        items: list[dict[str, Any]] = []
-        for path in sorted(root.glob("*.env"), key=lambda item: item.stat().st_mtime, reverse=True):
-            env = read_env_file(path)
-            items.append(
-                {
-                    "issue_id": env.get("ISSUE_ID", path.stem.removeprefix("issue-")),
-                    "session": env.get("SESSION", ""),
-                    "claim_file": env.get("CLAIM_FILE", ""),
-                    "updated_at": env.get("UPDATED_AT", "") or file_mtime_iso(path),
-                    "state_file": str(path),
-                }
-            )
-        return items
-
-    return {
-        "pending": collect_files(pending_root),
-        "claims": collect_files(claims_root),
-    }
-
-
 def build_profile_snapshot(profile_id: str, registry_root: Path) -> dict[str, Any]:
     env = env_with_profile(profile_id, registry_root)
     render_env = run_key_value_script(RENDER_FLOW_CONFIG, env)

package/tools/templates/pr-fix-template.md

@@ -2,13 +2,9 @@ You are the PR repair worker for `{REPO_SLUG}`.
 
 Before making any change:
 
-1. Read `{REPO_ROOT}/AGENTS.md`.
-2. If present, read `{REPO_ROOT}/openspec/AGENT_RULES.md`.
-3. If present, read `{REPO_ROOT}/openspec/AGENTS.md`.
-4. If present, read `{REPO_ROOT}/openspec/project.md`.
-5. If present, read `{REPO_ROOT}/openspec/CONVENTIONS.md`.
-6. If present, read `{REPO_ROOT}/docs/TESTING_AND_SEED_POLICY.md`.
-7. Stay on this PR branch worktree. Do not push or mutate GitHub from inside the worker.
+1. Read the following repo context before changing code:
+{PR_CONTEXT_READS_TEXT}
+2. Stay on this PR branch worktree. Do not push or mutate GitHub from inside the worker.
 
 PR metadata:
 

package/tools/templates/pr-merge-repair-template.md

@@ -2,13 +2,9 @@ You are the PR merge-repair worker for `{REPO_SLUG}`.
 
 Before making any change:
 
-1. Read `{REPO_ROOT}/AGENTS.md`.
-2. If present, read `{REPO_ROOT}/openspec/AGENT_RULES.md`.
-3. If present, read `{REPO_ROOT}/openspec/AGENTS.md`.
-4. If present, read `{REPO_ROOT}/openspec/project.md`.
-5. If present, read `{REPO_ROOT}/openspec/CONVENTIONS.md`.
-6. If present, read `{REPO_ROOT}/docs/TESTING_AND_SEED_POLICY.md`.
-7. Stay on this PR branch worktree. Do not push or mutate GitHub from inside the worker.
+1. Read the following repo context before changing code:
+{PR_CONTEXT_READS_TEXT}
+2. Stay on this PR branch worktree. Do not push or mutate GitHub from inside the worker.
 
 PR metadata:
 

package/tools/templates/pr-review-template.md

@@ -2,7 +2,8 @@ You are the PR review and final-merge worker for `{REPO_SLUG}`.
 
 Before making any decision:
 
-1. Read `{REPO_ROOT}/AGENTS.md` and any repo-specific conventions or design docs relevant to the PR.
+1. Read the following repo context before deciding:
+{PR_CONTEXT_READS_TEXT}
 2. Do not edit product code in this worktree. This is review and final-review only.
 3. Never run dependency bootstrap or workspace-mutating commands here.
 

package/SKILL.md

@@ -1,149 +0,0 @@
----
-name: agent-control-plane
-description: Use when working on the shared multi-project agent control plane, including scheduler/runtime orchestration, worktree and worker lifecycle, profile onboarding, and cross-project automation flows.
----
-
-# Agent Control Plane
-
-This repository is the canonical `agent-control-plane` package. It owns the
-generic scheduler/runtime, worktree lifecycle, profile onboarding, queue/risk
-automation, and profile-scoped prompt/template resolution used across multiple
-projects.
-
-Installed project profiles live under
-`~/.agent-runtime/control-plane/profiles/<id>/`. Treat the control plane itself
-as generic, then load the selected profile's local guidance only when the task
-is truly about that project. Integrated project data should stay in that
-external profile registry, not inside this repository.
-
-## What Lives Here
-
-- core operating manual in this `SKILL.md`
-- installed project profiles in `~/.agent-runtime/control-plane/profiles/*/control-plane.yaml`
-- installed profile notes in `~/.agent-runtime/control-plane/profiles/*/README.md`
-- workflow catalog in `assets/workflow-catalog.json`
-- worker dashboard in `tools/dashboard/` with launcher at `tools/dashboard/dashboard_snapshot.py`
-  and `tools/bin/serve-dashboard.sh`
-- dashboard autostart helpers in `tools/bin/dashboard-launchd-bootstrap.sh` and
-  `tools/bin/install-dashboard-launchd.sh`
-- project autostart helpers in `tools/bin/project-launchd-bootstrap.sh`,
-  `tools/bin/install-project-launchd.sh`, and
-  `tools/bin/uninstall-project-launchd.sh`
-- queue/label/risk scripts in `bin/`
-- heartbeat and reconcile hooks in `hooks/`
-- shared runtime wrappers, onboarding tools, and tests in `tools/bin/` and
-  `tools/tests/`
-
-The vendored runtime entrypoints used by live schedulers are published from this
-checkout into the shared canonical skill copy under
-`skills/openclaw/agent-control-plane`, then copied into
-`~/.agent-runtime/runtime-home/skills/openclaw/agent-control-plane` by
-`tools/bin/sync-shared-agent-home.sh`.
-
-## Required Startup Sequence
-
-Before doing non-trivial work in this repository or on an integrated project:
-
-1. Determine the active profile with `AGENT_PROJECT_ID`, `ACP_PROJECT_ID`, or
-   `tools/bin/render-flow-config.sh`.
-2. Read the selected profile notes in
-   `~/.agent-runtime/control-plane/profiles/<id>/README.md` when they exist.
-3. Read the selected repo's local startup docs before changing behavior:
-   `AGENTS.md`, `openspec/AGENT_RULES.md`, `openspec/AGENTS.md`,
-   `openspec/project.md`, and `openspec/CONVENTIONS.md`.
-4. Use a clean read-only inspection checkout first; move to an isolated
-   worktree or agent-owned checkout before making non-trivial edits.
-5. If the task changes product behavior, inspect the active OpenSpec changes
-   before implementation.
-
-For onboarding a new repository onto the shared control plane:
-
-1. Prefer `tools/bin/project-init.sh --profile-id <id> --repo-slug <owner/repo>`
-2. Fill in `~/.agent-runtime/control-plane/profiles/<id>/README.md`
-3. If you need manual control, the underlying steps remain:
-   `tools/bin/scaffold-profile.sh`, `tools/bin/profile-smoke.sh`,
-   `tools/bin/profile-adopt.sh`, and `tools/bin/sync-shared-agent-home.sh`
-
-For runtime control of one installed profile:
-
-1. Check state with `tools/bin/project-runtimectl.sh status --profile-id <id>`
-2. Start or ensure runtime with `tools/bin/project-runtimectl.sh start --profile-id <id>`
-3. Stop or recycle runtime with `tools/bin/project-runtimectl.sh stop --profile-id <id>`
-4. Use `tools/bin/project-runtimectl.sh restart --profile-id <id>` for a clean bounce
-5. Use `tools/bin/install-project-launchd.sh --profile-id <id>` when one
-   profile should survive reboot/login via a per-project LaunchAgent
-6. Remove per-project autostart with
-   `tools/bin/uninstall-project-launchd.sh --profile-id <id>`
-7. Remove an installed profile with `tools/bin/project-remove.sh --profile-id <id>`
-
-## Task Routing
-
-Pick the smallest matching path and load only the relevant references:
-
-- Control-plane layout, publication model, and profile ownership:
-  `references/control-plane-map.md`
-- Control-plane operator commands and profile-management entrypoints:
-  `references/commands.md`
-- Control-plane repository layout:
-  `references/repo-map.md`
-- Control-plane docs and profile guidance locations:
-  `references/docs-map.md`
-- Project-specific rules and repo commands:
-  `~/.agent-runtime/control-plane/profiles/<id>/README.md`
-
-## Repo Rules That Matter Most
-
-- Keep the core engine generic. Put repo-specific behavior behind a profile,
-  profile templates, or profile-scoped docs instead of hardcoding it into the
-  shared runtime.
-- Follow OpenSpec and the selected repo's local rules before implementing
-  product behavior changes.
-- Do not simplify or change approach without explicit user approval.
-- Prefer deterministic wrappers and config-driven routing over special-case
-  conditionals.
-- For any non-trivial write task, use a dedicated agent worktree or another
-  isolated clean checkout.
-- Preserve dirty retained checkouts; continue from a fresh isolated worktree
-  instead of layering more edits there.
-- Prefer canonical docs and profile-local notes over stale audits or incidental
-  markdown snapshots.
-- When updating the control plane itself, repair published copies after the
-  source change so runtime and source do not drift.
-
-## Common Operating Patterns
-
-### Analysis and Planning
-
-- Resolve the active profile first.
-- Read `~/.agent-runtime/control-plane/profiles/<id>/README.md` for repo-local context.
-- Use `references/docs-map.md` to find the canonical control-plane or
-  profile-local source instead of scanning random files.
-
-### Implementation
-
-- Keep generic scheduler/runtime changes in the shared engine.
-- Put repo-specific prompts, commands, or heuristics in the installed profile
-  directory under `~/.agent-runtime/control-plane/profiles/<id>/`.
-- Keep changes reversible and tightly scoped.
-
-### Testing
-
-- Use `references/commands.md` for control-plane checks.
-- Use the selected profile's README for repo-specific dev/test commands.
-- Re-run `tools/bin/profile-smoke.sh`, `tools/bin/check-skill-contracts.sh`,
-  dashboard tests, and targeted shell tests after meaningful control-plane
-  changes.
-
-### Publishing and Runtime Health
-
-- Use `tools/bin/flow-runtime-doctor.sh` to confirm source/runtime sync.
-- Use `tools/bin/sync-shared-agent-home.sh` after changing runtime-facing files.
-- Prefer copied published artifacts over symlink aliases.
-
-## References
-
-- `references/control-plane-map.md`
-- `references/commands.md`
-- `references/repo-map.md`
-- `references/docs-map.md`
-- `~/.agent-runtime/control-plane/profiles/<id>/README.md`