* wip: preserve worker changes on abnormal exit * docs: document health dashboard remediation * chore: drop restored metadata marker
This commit is contained in:
@@ -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`.
|
||||||
@@ -10,6 +10,7 @@ This directory contains workflow documentation for AI assistants working with th
|
|||||||
- **feature-development.md**: Process for developing new features
|
- **feature-development.md**: Process for developing new features
|
||||||
- **folder-structure.md**: Documentation of the plugin's folder structure and naming conventions
|
- **folder-structure.md**: Documentation of the plugin's folder structure and naming conventions
|
||||||
- **git-workflow.md**: Detailed git workflow and branch management guidelines
|
- **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
|
- **incremental-development.md**: Time-efficient approach for incremental development and testing
|
||||||
- **local-env-vars.md**: Local development environment paths and URLs
|
- **local-env-vars.md**: Local development environment paths and URLs
|
||||||
- **multi-repo-workspace.md**: Guidelines for working in workspaces with multiple repositories
|
- **multi-repo-workspace.md**: Guidelines for working in workspaces with multiple repositories
|
||||||
|
|||||||
Reference in New Issue
Block a user