From 5d3ec8090786f992f197e00c6fbbed332d6017f9 Mon Sep 17 00:00:00 2001 From: Marcus Quinn <6428977+marcusquinn@users.noreply.github.com> Date: Sun, 10 May 2026 01:43:21 +0100 Subject: [PATCH] Resolve supervisor dashboard freshness alert (#32) (#33) * wip: preserve worker changes on abnormal exit * docs: document health dashboard remediation * chore: drop restored metadata marker --- .ai-workflows/health-dashboard-remediation.md | 22 +++++++++++++++++++ .ai-workflows/readme.md | 1 + 2 files changed, 23 insertions(+) create mode 100644 .ai-workflows/health-dashboard-remediation.md diff --git a/.ai-workflows/health-dashboard-remediation.md b/.ai-workflows/health-dashboard-remediation.md new file mode 100644 index 0000000..a3337c2 --- /dev/null +++ b/.ai-workflows/health-dashboard-remediation.md @@ -0,0 +1,22 @@ +# Supervisor health dashboard remediation + +Use this runbook when the repository supervisor health dashboard becomes stale. + +## Signals + +- The pinned supervisor issue has an old `last_refresh:` marker. +- The stats scheduler exists and is loaded, but wrapper runs overlap or remain active beyond the expected timeout. +- Recent stats logs stop before the affected repository is updated. + +## Remediation + +1. Confirm the launchd job and stats log are present. +2. Check for an active `stats-wrapper.sh` process that has exceeded `STATS_TIMEOUT`. +3. Terminate the stale wrapper process, remove the stale stats pidfile, and run one targeted health issue refresh for this repository. +4. Verify the pinned dashboard issue now has a fresh `last_refresh:` marker and recent `updated_at` timestamp. + +## Verification evidence for issue #32 + +- Scheduler plist existed and launchd reported `com.aidevops.aidevops-stats-wrapper` loaded. +- The stats log showed repeated overlapping runs and a stale wrapper process, with the repository dashboard skipped before the targeted refresh. +- A targeted refresh updated dashboard issue #10 with `last_refresh: 2026-05-10T00:38:30Z`. diff --git a/.ai-workflows/readme.md b/.ai-workflows/readme.md index 6c05206..9119154 100644 --- a/.ai-workflows/readme.md +++ b/.ai-workflows/readme.md @@ -10,6 +10,7 @@ This directory contains workflow documentation for AI assistants working with th - **feature-development.md**: Process for developing new features - **folder-structure.md**: Documentation of the plugin's folder structure and naming conventions - **git-workflow.md**: Detailed git workflow and branch management guidelines +- **health-dashboard-remediation.md**: Supervisor health dashboard staleness triage and remediation - **incremental-development.md**: Time-efficient approach for incremental development and testing - **local-env-vars.md**: Local development environment paths and URLs - **multi-repo-workspace.md**: Guidelines for working in workspaces with multiple repositories