agent-control-plane 0.3.0 → 0.6.0

package/tools/bin/scaffold-profile.sh

@@ -14,7 +14,12 @@ Create a new installed project profile, profile templates, and profile notes.
 
 Options:
   --profile-id <id>                  Profile id, e.g. billing-api
-  --repo-slug <owner/repo>           GitHub repo slug
+  --repo-slug <owner/repo>           Forge repo slug
+  --forge-provider <github|gitea>    Forge provider (default: github)
+  --gitea-base-url <url>             Base URL for a local/self-hosted Gitea instance
+  --gitea-token <token>              Gitea API token written to profile runtime.env
+  --gitea-username <user>            Gitea username written to profile runtime.env
+  --gitea-password <pass>            Gitea password written to profile runtime.env
   --profile-home <path>              Profile registry root (default: ~/.agent-runtime/control-plane/profiles)
   --repo-root <path>                 Canonical repo root
   --agent-repo-root <path>           Agent-owned anchor repo root (defaults to repo root)
@@ -40,6 +45,11 @@ EOF
 
 profile_id=""
 repo_slug=""
+forge_provider="github"
+gitea_base_url=""
+gitea_token=""
+gitea_username=""
+gitea_password=""
 profile_home=""
 repo_root=""
 agent_repo_root=""
@@ -63,6 +73,11 @@ while [[ $# -gt 0 ]]; do
   case "$1" in
     --profile-id) profile_id="${2:-}"; shift 2 ;;
     --repo-slug) repo_slug="${2:-}"; shift 2 ;;
+    --forge-provider) forge_provider="${2:-}"; shift 2 ;;
+    --gitea-base-url) gitea_base_url="${2:-}"; shift 2 ;;
+    --gitea-token) gitea_token="${2:-}"; shift 2 ;;
+    --gitea-username) gitea_username="${2:-}"; shift 2 ;;
+    --gitea-password) gitea_password="${2:-}"; shift 2 ;;
     --profile-home) profile_home="${2:-}"; shift 2 ;;
     --repo-root) repo_root="${2:-}"; shift 2 ;;
     --agent-repo-root) agent_repo_root="${2:-}"; shift 2 ;;
@@ -104,6 +119,14 @@ case "$coding_worker" in
     ;;
 esac
 
+case "$forge_provider" in
+  github|gitea) ;;
+  *)
+    echo "--forge-provider must be github or gitea" >&2
+    exit 1
+    ;;
+esac
+
 case "$claude_effort" in
   low|medium|high|max) ;;
   *)
@@ -133,6 +156,7 @@ profile_home="${profile_home:-$(resolve_flow_profile_registry_root)}"
 profiles_dir="${profile_home}"
 profile_dir="${profiles_dir}/${profile_id}"
 profile_yaml="${profile_dir}/control-plane.yaml"
+profile_runtime_env="${profile_dir}/runtime.env"
 profile_templates_dir="${profile_dir}/templates"
 profile_readme="${profile_dir}/README.md"
 
@@ -228,9 +252,9 @@ session_naming:
   pr_worktree_branch_prefix: "${pr_worktree_branch_prefix}"
   managed_pr_branch_globs: "${managed_pr_branch_globs}"
 queue:
-  source: "github"
+  source: "${forge_provider}"
   issue_labels:
-    ready: "agent-ready"
+    ready: ""
     running: "agent-running"
     blocked: "agent-blocked"
     heavy: "agent-e2e-heavy"
@@ -366,7 +390,38 @@ policies:
 EOF
 }
 
+write_profile_runtime_env() {
+  local target_file="${1:?target file required}"
+
+  : >"$target_file"
+  {
+    printf 'ACP_FORGE_PROVIDER=%s\n' "${forge_provider}"
+    printf 'F_LOSNING_FORGE_PROVIDER=%s\n' "${forge_provider}"
+    if [[ "${forge_provider}" == "gitea" ]]; then
+      if [[ -n "${gitea_base_url}" ]]; then
+        printf 'ACP_GITEA_BASE_URL=%s\n' "${gitea_base_url}"
+        printf 'GITEA_BASE_URL=%s\n' "${gitea_base_url}"
+      fi
+      if [[ -n "${gitea_token}" ]]; then
+        printf 'ACP_GITEA_TOKEN=%s\n' "${gitea_token}"
+        printf 'GITEA_TOKEN=%s\n' "${gitea_token}"
+      fi
+      if [[ -n "${gitea_username}" ]]; then
+        printf 'ACP_GITEA_USERNAME=%s\n' "${gitea_username}"
+        printf 'GITEA_USERNAME=%s\n' "${gitea_username}"
+      fi
+      if [[ -n "${gitea_password}" ]]; then
+        printf 'ACP_GITEA_PASSWORD=%s\n' "${gitea_password}"
+        printf 'GITEA_PASSWORD=%s\n' "${gitea_password}"
+      fi
+      printf 'ACP_SOURCE_SYNC_REMOTE=gitea\n'
+      printf 'F_LOSNING_SOURCE_SYNC_REMOTE=gitea\n'
+    fi
+  } >"$target_file"
+}
+
 write_profile_yaml "$profile_yaml"
+write_profile_runtime_env "$profile_runtime_env"
 write_profile_readme "$profile_readme"
 
 if compgen -G "${flow_skill_dir}/tools/templates/*.md" >/dev/null; then
@@ -375,15 +430,18 @@ fi
 
 profile_home_real="$(mkdir -p "$profile_home" && cd "$profile_home" && pwd -P)"
 profile_yaml_real="$(cd "$(dirname "$profile_yaml")" && pwd -P)/$(basename "$profile_yaml")"
+profile_runtime_env_real="$(cd "$(dirname "$profile_runtime_env")" && pwd -P)/$(basename "$profile_runtime_env")"
 profile_templates_dir_real="$(cd "$profile_templates_dir" && pwd -P)"
 profile_readme_real="$(cd "$(dirname "$profile_readme")" && pwd -P)/$(basename "$profile_readme")"
 
 printf 'PROFILE_ID=%s\n' "$profile_id"
 printf 'PROFILE_HOME=%s\n' "$profile_home_real"
 printf 'PROFILE_YAML=%s\n' "$profile_yaml_real"
+printf 'PROFILE_RUNTIME_ENV=%s\n' "$profile_runtime_env_real"
 printf 'PROFILE_TEMPLATE_DIR=%s\n' "$profile_templates_dir_real"
 printf 'PROFILE_README=%s\n' "$profile_readme_real"
 printf 'REPO_SLUG=%s\n' "$repo_slug"
+printf 'FORGE_PROVIDER=%s\n' "$forge_provider"
 printf 'CODING_WORKER=%s\n' "$coding_worker"
 printf 'NEXT_STEP=ACP_PROJECT_ID=%s bash %s/tools/bin/render-flow-config.sh\n' "$profile_id" "$flow_skill_dir"
 printf 'NEXT_STEP=bash %s/tools/bin/sync-shared-agent-home.sh\n' "$flow_skill_dir"

package/tools/bin/uninstall-project-systemd.sh

@@ -0,0 +1,87 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'EOF'
+Usage:
+  uninstall-project-systemd.sh --profile-id <id> [options]
+
+Remove a previously installed systemd user service for an ACP project.
+
+Options:
+  --profile-id <id>       Installed profile id to manage
+  --unit-name <name>       Override systemd unit name (default: agent-project-<id>.service)
+  --help                   Show this help
+EOF
+}
+
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=/dev/null
+source "${script_dir}/flow-config-lib.sh"
+
+profile_id_override=""
+unit_name_override=""
+profile_registry_root_override="${ACP_PROJECT_RUNTIME_PROFILE_REGISTRY_ROOT:-${ACP_PROFILE_REGISTRY_ROOT:-}}"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --profile-id) profile_id_override="${2:-}"; shift 2 ;;
+    --unit-name) unit_name_override="${2:-}"; shift 2 ;;
+    --help|-h) usage; exit 0 ;;
+    *) echo "Unknown argument: $1" >&2; usage >&2; exit 64 ;;
+  esac
+done
+
+if [[ -z "${profile_id_override}" ]]; then
+  usage >&2
+  exit 64
+fi
+
+export ACP_PROJECT_ID="${profile_id_override}"
+export AGENT_PROJECT_ID="${profile_id_override}"
+
+if [[ -n "${profile_registry_root_override}" ]]; then
+  export ACP_PROFILE_REGISTRY_ROOT="${profile_registry_root_override}"
+fi
+
+flow_skill_dir="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
+if ! flow_require_explicit_profile_selection "${flow_skill_dir}" "uninstall-project-systemd.sh"; then
+  exit 64
+fi
+
+config_yaml="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
+if [[ ! -f "${config_yaml}" ]]; then
+  printf 'profile not installed: %s\n' "${profile_id_override}" >&2
+  exit 66
+fi
+
+profile_id="$(flow_resolve_adapter_id "${config_yaml}")"
+profile_slug="$(printf '%s' "${profile_id}" | tr -c 'A-Za-z0-9._-' '-')"
+home_dir="${ACP_PROJECT_RUNTIME_HOME_DIR:-${HOME:-}}"
+systemd_dir="${ACP_PROJECT_RUNTIME_SYSTEMD_DIR:-${home_dir}/.config/systemd/user}"
+unit_name="${unit_name_override:-${ACP_PROJECT_RUNTIME_SYSTEMD_UNIT:-agent-project-${profile_slug}.service}}"
+unit_file="${systemd_dir}/${unit_name}"
+workspace_dir="${ACP_PROJECT_RUNTIME_WORKSPACE_DIR:-${home_dir}/.agent-runtime/control-plane/workspace}"
+wrapper_path="${workspace_dir}/bin/agent-project-${profile_slug}-systemd.sh"
+
+# Check if systemd is available
+if ! command -v systemctl &>/dev/null; then
+  echo "systemctl not found. Is systemd installed?" >&2
+  exit 1
+fi
+
+# Stop and disable the service
+"${SYSTEMCTL_BIN}" --user stop "${unit_name}" 2>&1 || true
+"${SYSTEMCTL_BIN}" --user disable "${unit_name}" 2>&1 || true
+
+# Remove unit file
+rm -f "${unit_file}"
+
+# Remove wrapper script
+rm -f "${wrapper_path}"
+
+printf 'SYSTEMD_UNINSTALL_STATUS=ok\n'
+printf 'PROFILE_ID=%s\n' "${profile_id}"
+printf 'UNIT_NAME=%s\n' "${unit_name}"
+printf 'UNIT_FILE=%s\n' "${unit_file}"
+printf 'WRAPPER=%s\n' "${wrapper_path}"

package/tools/dashboard/app.js

@@ -72,6 +72,35 @@ function relativeTime(input) {
   return seconds >= 0 ? `${absolute}s ago` : `in ${absolute}s`;
 }
 
+function formatDuration(seconds) {
+  if (!seconds && seconds !== 0) return "n/a";
+  const absSeconds = Math.abs(seconds);
+  const parts = [];
+  const units = [
+    [86400, "d"],
+    [3600, "h"],
+    [60, "m"],
+    [1, "s"],
+  ];
+  for (const [unitSeconds, label] of units) {
+    if (absSeconds >= unitSeconds) {
+      const amount = Math.floor(absSeconds / unitSeconds);
+      parts.push(`${amount}${label}`);
+      seconds -= amount * unitSeconds;
+    }
+  }
+  return parts.slice(0, 2).join(" ") || "0s";
+}
+
+function timeRemaining(isoString) {
+  if (!isoString) return "n/a";
+  const next = new Date(isoString);
+  if (Number.isNaN(next.getTime())) return isoString;
+  const diffSeconds = Math.round((next.getTime() - Date.now()) / 1000);
+  if (diffSeconds <= 0) return "ready now";
+  return formatDuration(diffSeconds);
+}
+
 function statusClass(status) {
   if (!status) return "";
   return status.replace(/[^a-zA-Z0-9_-]/g, "-");
@@ -111,9 +140,10 @@ function renderOverview(snapshot) {
       acc.cooldowns += profile.counts.provider_cooldowns;
       acc.queue += profile.counts.queued_issues;
       acc.alerts += profile.counts.alerts || 0;
+      acc.pendingGithubWrites += profile.counts.pending_github_writes || 0;
       return acc;
     },
-    { activeRuns: 0, runningRuns: 0, implementedRuns: 0, reportedRuns: 0, blockedRuns: 0, controllers: 0, cooldowns: 0, queue: 0, alerts: 0 },
+    { activeRuns: 0, runningRuns: 0, implementedRuns: 0, reportedRuns: 0, blockedRuns: 0, controllers: 0, cooldowns: 0, queue: 0, alerts: 0, pendingGithubWrites: 0 },
   );
 
   overviewNode.innerHTML = [
@@ -125,8 +155,11 @@ function renderOverview(snapshot) {
     ["Blocked", totals.blockedRuns],
     ["Live Controllers", totals.controllers],
     ["Provider Cooldowns", totals.cooldowns],
+    ["Pending GitHub Writes", totals.pendingGithubWrites],
     ["Alerts", totals.alerts],
     ["Queued Issues", totals.queue],
+    ["Retries", totals.retries || 0],
+    ["Blockers", totals.blockers || 0],
   ]
     .map(
       ([label, value]) => `
@@ -237,6 +270,8 @@ function renderProfile(profile) {
     ["Live controllers", profile.counts.live_resident_controllers],
     ["Stale controllers", profile.counts.stale_resident_controllers],
     ["Provider cooldowns", profile.counts.provider_cooldowns],
+    ["Pending GitHub writes", profile.counts.pending_github_writes || 0],
+    ["Failed GitHub writes", profile.counts.failed_github_writes || 0],
     ["Alerts", profile.counts.alerts || 0],
     ["Issue retries", profile.counts.active_retries],
     ["Queued issues", profile.counts.queued_issues],
@@ -252,6 +287,23 @@ function renderProfile(profile) {
     )
     .join("");
 
+  const runsFilterState = window._acpRunsFilter || { search: "", status: "all" };
+  window._acpRunsFilter = runsFilterState;
+
+  const filteredRuns = profile.runs.filter((row) => {
+    if (runsFilterState.status !== "all" && row.status !== runsFilterState.status) return false;
+    if (runsFilterState.search) {
+      const q = runsFilterState.search.toLowerCase();
+      return (
+        (row.session || "").toLowerCase().includes(q) ||
+        (row.coding_worker || "").toLowerCase().includes(q) ||
+        (row.task_kind || "").toLowerCase().includes(q) ||
+        (row.task_id || "").toLowerCase().includes(q)
+      );
+    }
+    return true;
+  });
+
   const runsTable = renderTable(
     [
       { label: "Session", render: (row) => `<div class="mono">${row.session}</div>` },
@@ -262,10 +314,26 @@ function renderProfile(profile) {
       { label: "Result", render: renderResult },
       { label: "Updated", render: (row) => row.updated_at ? `${relativeTime(row.updated_at)}<div class="muted">${row.updated_at}</div>` : "n/a" },
     ],
-    profile.runs,
+    filteredRuns,
     "No active run directories for this profile.",
   );
 
+  const historyFilterState = window._acpHistoryFilter || { search: "", result: "all" };
+  window._acpHistoryFilter = historyFilterState;
+
+  const filteredHistory = (profile.recent_history || []).filter((row) => {
+    if (historyFilterState.result !== "all" && row.result_kind !== historyFilterState.result) return false;
+    if (historyFilterState.search) {
+      const q = historyFilterState.search.toLowerCase();
+      return (
+        (row.session || "").toLowerCase().includes(q) ||
+        (row.coding_worker || "").toLowerCase().includes(q) ||
+        (row.task_kind || "").toLowerCase().includes(q)
+      );
+    }
+    return true;
+  });
+
   const recentHistoryTable = renderTable(
     [
       { label: "Session", render: (row) => `<div class="mono">${row.session}</div>` },
@@ -275,7 +343,7 @@ function renderProfile(profile) {
       { label: "Result", render: renderResult },
       { label: "Updated", render: (row) => row.updated_at ? `${relativeTime(row.updated_at)}<div class="muted">${row.updated_at}</div>` : "n/a" },
     ],
-    profile.recent_history || [],
+    filteredHistory,
     "No recently archived runs.",
   );
 
@@ -301,6 +369,7 @@ function renderProfile(profile) {
       { label: "Reason", render: (row) => row.last_reason || "n/a" },
       { label: "Attempts", key: "attempts" },
       { label: "Next attempt", render: (row) => row.next_attempt_at ? `${relativeTime(row.next_attempt_at)}<div class="muted">${row.next_attempt_at}</div>` : "n/a" },
+      { label: "Time Remaining", render: (row) => row.next_attempt_at ? timeRemaining(row.next_attempt_at) : "n/a" },
     ],
     profile.issue_retries || [],
     "No issue retries recorded.",
@@ -313,6 +382,7 @@ function renderProfile(profile) {
       { label: "Reason", render: (row) => row.last_reason || "n/a" },
       { label: "Attempts", key: "attempts" },
       { label: "Next attempt", render: (row) => row.next_attempt_at ? `${relativeTime(row.next_attempt_at)}<div class="muted">${row.next_attempt_at}</div>` : "n/a" },
+      { label: "Time Remaining", render: (row) => row.next_attempt_at ? timeRemaining(row.next_attempt_at) : "n/a" },
     ],
     profile.pr_retries || [],
     "No PR retries recorded.",
@@ -340,6 +410,7 @@ function renderProfile(profile) {
       { label: "Reason", render: (row) => row.last_reason || "n/a" },
       { label: "Attempts", key: "attempts" },
       { label: "Next attempt", render: (row) => row.next_attempt_at ? `${relativeTime(row.next_attempt_at)}<div class="muted">${row.next_attempt_at}</div>` : "n/a" },
+      { label: "Time Remaining", render: (row) => row.next_attempt_at ? timeRemaining(row.next_attempt_at) : "n/a" },
     ],
     profile.provider_cooldowns,
     "No provider cooldowns recorded.",
@@ -350,6 +421,7 @@ function renderProfile(profile) {
       { label: "Issue", key: "issue_id" },
       { label: "Interval", render: (row) => `${row.interval_seconds}s` },
       { label: "Next due", render: (row) => row.next_due_at ? `${relativeTime(row.next_due_at)}<div class="muted">${row.next_due_at}</div>` : "n/a" },
+      { label: "Time Remaining", render: (row) => row.next_due_at ? timeRemaining(row.next_due_at) : "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" },
     ],
     profile.scheduled_issues,
@@ -378,6 +450,26 @@ function renderProfile(profile) {
     "No claimed issues.",
   );
 
+  const githubOutbox = profile.github_outbox || { counts: {}, pending: [] };
+  const githubOutboxTable = renderTable(
+    [
+      { label: "Type", render: (row) => row.type || "n/a" },
+      { label: "Target", render: (row) => `${row.kind || row.type || "write"} #${row.number || "?"}` },
+      {
+        label: "Payload",
+        render: (row) => {
+          if (row.type === "labels") {
+            return `+${row.add_count || 0} / -${row.remove_count || 0}`;
+          }
+          return row.body_preview || "n/a";
+        },
+      },
+      { label: "Created", render: (row) => row.created_at ? `${relativeTime(row.created_at)}<div class="muted">${row.created_at}</div>` : "n/a" },
+    ],
+    githubOutbox.pending || [],
+    "No pending GitHub write intents.",
+  );
+
   const codexRotationPanel =
     profile.coding_worker === "codex"
       ? `
@@ -389,6 +481,28 @@ function renderProfile(profile) {
       `
       : "";
 
+  const runsFilterBar = `
+    <div class="filter-bar">
+      <input type="text" class="filter-search" placeholder="Search runs..." value="${runsFilterState.search}"
+        oninput="window._acpRunsFilter.search=this.value; rerenderAll();" />
+      <button class="filter-btn ${runsFilterState.status === 'all' ? 'active' : ''}" onclick="window._acpRunsFilter.status='all'; rerenderAll();">All</button>
+      <button class="filter-btn ${runsFilterState.status === 'RUNNING' ? 'active' : ''}" onclick="window._acpRunsFilter.status='RUNNING'; rerenderAll();">Running</button>
+      <button class="filter-btn ${runsFilterState.status === 'SUCCEEDED' ? 'active' : ''}" onclick="window._acpRunsFilter.status='SUCCEEDED'; rerenderAll();">Completed</button>
+      <button class="filter-btn ${runsFilterState.status === 'FAILED' ? 'active' : ''}" onclick="window._acpRunsFilter.status='FAILED'; rerenderAll();">Failed</button>
+    </div>
+  `;
+
+  const historyFilterBar = `
+    <div class="filter-bar">
+      <input type="text" class="filter-search" placeholder="Search history..." value="${historyFilterState.search}"
+        oninput="window._acpHistoryFilter.search=this.value; rerenderAll();" />
+      <button class="filter-btn ${historyFilterState.result === 'all' ? 'active' : ''}" onclick="window._acpHistoryFilter.result='all'; rerenderAll();">All</button>
+      <button class="filter-btn ${historyFilterState.result === 'implemented' ? 'active' : ''}" onclick="window._acpHistoryFilter.result='implemented'; rerenderAll();">Implemented</button>
+      <button class="filter-btn ${historyFilterState.result === 'reported' ? 'active' : ''}" onclick="window._acpHistoryFilter.result='reported'; rerenderAll();">Reported</button>
+      <button class="filter-btn ${historyFilterState.result === 'blocked' ? 'active' : ''}" onclick="window._acpHistoryFilter.result='blocked'; rerenderAll();">Blocked</button>
+    </div>
+  `;
+
   return `
     <article class="profile">
       <header class="profile-header">
@@ -411,11 +525,13 @@ function renderProfile(profile) {
         <section class="panel">
           <h3>Active Runs</h3>
           <p class="panel-subtitle">Lifecycle shows technical session completion. Result shows what the run achieved: implemented, reported, or blocked.</p>
+          ${runsFilterBar}
           ${runsTable}
         </section>
         <section class="panel">
           <h3>Recent Completed Runs</h3>
           <p class="panel-subtitle">Recently archived runs so they do not disappear from the dashboard immediately after completion.</p>
+          ${historyFilterBar}
           ${recentHistoryTable}
         </section>
         <section class="panel">
@@ -436,6 +552,18 @@ function renderProfile(profile) {
           <h3>Resident Worker Metadata</h3>
           ${workerTable}
         </section>
+        <section class="panel">
+          <h3>Troubleshooting</h3>
+          <p class="panel-subtitle">Run diagnostics or debugging tools against this live profile.</p>
+          <div class="action-bar">
+            <button class="action-btn" onclick="runDoctor('${profile.id}')">Run Doctor</button>
+            <button class="action-btn" onclick="exportProfile('${profile.id}')">Export Profile</button>
+            <button class="action-btn" onclick="document.getElementById('import-file-${profile.id}').click()">Import Profile</button>
+            <input type="file" id="import-file-${profile.id}" style="display:none" accept=".json" onchange="importProfile('${profile.id}', this)">
+            <span id="doctor-status-${profile.id}"></span>
+          </div>
+          <pre id="doctor-output-${profile.id}" class="doctor-output" style="display:none;"></pre>
+        </section>
         <section class="panel half">
           <h3>Provider Cooldowns</h3>
           ${cooldownTable}
@@ -452,6 +580,11 @@ function renderProfile(profile) {
           <h3>Claimed Issues</h3>
           ${claimsTable}
         </section>
+        <section class="panel">
+          <h3>GitHub Outbox</h3>
+          <p class="panel-subtitle">Local write intents queued while ACP defers or retries GitHub sync. Pending ${githubOutbox.counts?.pending || 0}, sent ${githubOutbox.counts?.sent || 0}, failed ${githubOutbox.counts?.failed || 0}.</p>
+          ${githubOutboxTable}
+        </section>
       </section>
     </article>
   `;
@@ -494,9 +627,8 @@ async function loadSnapshot() {
       throw new Error(`Snapshot request failed with ${response.status}`);
     }
     const snapshot = await response.json();
-    generatedAtNode.textContent = `Snapshot: ${snapshot.generated_at}`;
-    renderOverview(snapshot);
-    profilesNode.innerHTML = snapshot.profiles.map(renderProfile).join("");
+    window._acpSnapshot = snapshot;
+    renderFromSnapshot(snapshot);
     await maybeNotifyAlerts(snapshot);
   } catch (error) {
     generatedAtNode.textContent = `Snapshot load failed: ${error.message}`;
@@ -506,6 +638,96 @@ async function loadSnapshot() {
   }
 }
 
+function renderFromSnapshot(snapshot) {
+  generatedAtNode.textContent = `Snapshot: ${snapshot.generated_at}`;
+  renderOverview(snapshot);
+  profilesNode.innerHTML = snapshot.profiles.map(renderProfile).join("");
+}
+
+function rerenderAll() {
+  const snapshot = window._acpSnapshot;
+  if (!snapshot) return;
+  renderFromSnapshot(snapshot);
+}
+
+async function runDoctor(profileId) {
+  const statusEl = document.getElementById(`doctor-status-${profileId}`);
+  const outputEl = document.getElementById(`doctor-output-${profileId}`);
+  if (statusEl) statusEl.textContent = "Running...";
+  if (outputEl) {
+    outputEl.style.display = "none";
+    outputEl.textContent = "";
+  }
+  try {
+    const response = await fetch(`/api/doctor?profile_id=${encodeURIComponent(profileId)}`, { cache: "no-store" });
+    const data = await response.json();
+    if (statusEl) statusEl.textContent = response.ok ? "Done" : `Error: ${data.error || response.status}`;
+    if (outputEl) {
+      outputEl.style.display = "block";
+      outputEl.textContent = data.output || data.error || "No output";
+    }
+  } catch (error) {
+    if (statusEl) statusEl.textContent = `Error: ${error.message}`;
+  }
+}
+
+async function exportProfile(profileId) {
+  try {
+    const response = await fetch(`/api/profile/export?profile_id=${encodeURIComponent(profileId)}`, { cache: "no-store" });
+    if (!response.ok) {
+      const data = await response.json();
+      alert(`Export failed: ${data.error || response.status}`);
+      return;
+    }
+    const data = await response.json();
+    const blob = new Blob([JSON.stringify(data, null, 2)], { type: "application/json" });
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = `acp-profile-${profileId}.json`;
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+    URL.revokeObjectURL(url);
+  } catch (error) {
+    alert(`Export failed: ${error.message}`);
+  }
+}
+
+async function importProfile(profileId, inputEl) {
+  const file = inputEl.files[0];
+  if (!file) return;
+  
+  try {
+    const text = await file.text();
+    const data = JSON.parse(text);
+    
+    if (!data.profile_id || !data.config) {
+      alert("Invalid profile file: missing profile_id or config");
+      return;
+    }
+    
+    const response = await fetch("/api/profile/import", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(data),
+    });
+    
+    const result = await response.json();
+    if (response.ok) {
+      alert(`Profile ${profileId} imported successfully!`);
+      // Refresh the page to show imported profile
+      setTimeout(() => window.location.reload(), 1000);
+    } else {
+      alert(`Import failed: ${result.error || response.status}`);
+    }
+  } catch (error) {
+    alert(`Import failed: ${error.message}`);
+  } finally {
+    inputEl.value = "";
+  }
+}
+
 refreshButton.addEventListener("click", () => {
   void loadSnapshot();
 });

package/tools/dashboard/dashboard_snapshot.py

@@ -697,6 +697,57 @@ def collect_pr_retries(state_root: Path) -> list[dict[str, Any]]:
     return items
 
 
+def collect_github_outbox(state_root: Path) -> dict[str, Any]:
+    outbox_root = state_root / "github-outbox"
+    pending_root = outbox_root / "pending"
+    sent_root = outbox_root / "sent"
+    failed_root = outbox_root / "failed"
+
+    def list_items(root: Path, limit: int | None = None) -> list[dict[str, Any]]:
+        if not root.is_dir():
+            return []
+
+        items: list[dict[str, Any]] = []
+        for path in sorted(root.glob("*.json"), key=lambda item: item.stat().st_mtime, reverse=True):
+            payload = read_json_file(path)
+            items.append(
+                {
+                    "type": str(payload.get("type", "")),
+                    "repo_slug": str(payload.get("repo_slug", "")),
+                    "number": str(payload.get("number", "")),
+                    "kind": str(payload.get("kind", "")),
+                    "created_at": str(payload.get("created_at", "")),
+                    "updated_at": file_mtime_iso(path),
+                    "file": str(path),
+                    "add_count": len(payload.get("add", []) or []),
+                    "remove_count": len(payload.get("remove", []) or []),
+                    "body_preview": summarize_whitespace(str(payload.get("body", "")))[:120],
+                }
+            )
+            if limit is not None and len(items) >= limit:
+                break
+        return items
+
+    all_pending_items = list_items(pending_root)
+    pending_items = all_pending_items[:20]
+    sent_items = list_items(sent_root, limit=5)
+    failed_items = list_items(failed_root, limit=5)
+
+    return {
+        "pending": pending_items,
+        "sent_recent": sent_items,
+        "failed_recent": failed_items,
+        "counts": {
+            "pending": len(all_pending_items),
+            "sent": len(list(sent_root.glob("*.json"))) if sent_root.is_dir() else 0,
+            "failed": len(list(failed_root.glob("*.json"))) if failed_root.is_dir() else 0,
+            "pending_comments": sum(1 for item in all_pending_items if item["type"] == "comment"),
+            "pending_approvals": sum(1 for item in all_pending_items if item["type"] == "approval"),
+            "pending_label_updates": sum(1 for item in all_pending_items if item["type"] == "labels"),
+        },
+    }
+
+
 def resolve_history_root(render_env: dict[str, str], yaml_env: dict[str, str], runs_root: Path) -> Path:
     configured = (
         render_env.get("EFFECTIVE_HISTORY_ROOT", "").strip()
@@ -726,6 +777,7 @@ def build_profile_snapshot(profile_id: str, registry_root: Path) -> dict[str, An
     retries = collect_issue_retries(state_root)
     pr_retries = collect_pr_retries(state_root)
     queue = collect_issue_queue(state_root)
+    github_outbox = collect_github_outbox(state_root)
     alerts = [alert for run in (runs + recent_history) for alert in run.get("alerts", [])]
     codex_rotation = collect_codex_rotation(render_env)
 
@@ -773,6 +825,8 @@ def build_profile_snapshot(profile_id: str, registry_root: Path) -> dict[str, An
             "active_retries": sum(1 for item in retries if not item.get("ready", True)),
             "scheduled_issues": len(scheduled),
             "alerts": len(alerts),
+            "pending_github_writes": github_outbox["counts"]["pending"],
+            "failed_github_writes": github_outbox["counts"]["failed"],
         },
         "runs": runs,
         "recent_history": recent_history,
@@ -784,6 +838,7 @@ def build_profile_snapshot(profile_id: str, registry_root: Path) -> dict[str, An
         "issue_retries": retries,
         "pr_retries": pr_retries,
         "issue_queue": queue,
+        "github_outbox": github_outbox,
     }