groove-admin-doctor

<!-- groove:managed — do not edit; changes will be overwritten by groove update --> # groove-admin-doctor ## Outcome All groove sub-skill health checks are run and a consolidated summary is reported. User knows exactly what is working, what is misconfigured, and what action to take for any failure. ## Acceptance Criteria - `/groove-utilities-task-doctor` and `/groove-utilities-memory-doctor` are run - Companion skill presence is checked directly - Results are shown per sub-skill with pass/fail per check - Overall status is shown: all healthy, or N issues found - Each failure includes a specific remediation action ## Output format ``` groove doctor ───────────────────────────────────── groove ✓ git repo: detected ✓ groove-version: 0.1.0 ✓ installed version: 0.1.0 ✓ up to date task ✓ .groove/index.md present ✓ tasks.backend: beans ✓ beans installed (v0.x.x) ✓ .beans.yml present ✓ beans reachable memory ✓ memory path exists (.groove/memory/) [hardcoded] ✓ memory dirs exist (.groove/memory/daily/, weekly/, monthly/, git/) companions ✓ find-skills installed ✓ agent-browser installed ✓ pdf-to-markdown installed platform symlinks ✓ .claude/skills/groove → ../../.agents/skills/groove ✗ .cursor/skills/ missing — run: /groove-admin-install ───────────────────────────────────── 1 issue found. Run the suggested commands above to fix. ``` ## Constraints - Run git repo check first, then version check, then `/groove-utilities-task-doctor`, `/groove-utilities-memory-doctor`, companions check in sequence - Git repo check: - Run `git rev-parse --is-inside-work-tree` in the current directory - If it succeeds: `✓ git repo: detected` - If it fails: `✗ git repo: not a git repository — groove requires a git repo` - Version check: - Read `groove-version:` from `.groove/index.md` (if absent, treat as `0.1.0`) - Read `version:` from `skills/groove/SKILL.md` - If they differ: `✗ groove-version (<local>) behind installed (<installed>) — run: /groove-admin-update` - Companions check: - Check `ls .agents/skills/find-skills/SKILL.md` — if absent: `✗ find-skills not installed — run: /groove-admin-install` - Check `ls .agents/skills/agent-browser/SKILL.md` — if absent: `✗ agent-browser not installed — run: /groove-admin-install` - Check `ls .agents/skills/pdf-to-markdown/SKILL.md` — if absent: `✗ pdf-to-markdown not installed — run: /groove-admin-install` - Platform symlinks check (after companions): - For each `groove-*` directory in `.agents/skills/`: check that `.claude/skills/<name>` is a symlink pointing to `../../.agents/skills/<name>` - If missing or not a symlink: `✗ .claude/skills/<name> not a symlink — run: /groove-admin-install` - If symlink is broken (target doesn't exist): `✗ .claude/skills/<name> broken symlink — run: /groove-admin-install` - Check if `.cursor/skills/` directory exists: - If absent: `✗ .cursor/skills/ missing — run: /groove-admin-install` - If present: check each groove symlink as above - All symlinks healthy: `✓ platform symlinks (.claude/, .cursor/)` - Claude Code native hooks check (after platform symlinks): - Check if `.claude/settings.json` exists - If it exists: parse JSON and verify groove's hook entries are present (`daily-end-reminder`, `git-activity-buffer`, `block-managed-paths`, `context-reprime`, `version-check`, `session-capture` commands in the `hooks` key) - Each missing entry: `✗ .claude/settings.json missing groove hook <name> — run: /groove-admin-claude-hooks` - If absent: `ℹ .claude/settings.json not present — run /groove-admin-claude-hooks to install native hooks (optional)` - All present: `✓ Claude Code native hooks (daily-end-reminder, git-activity-buffer, block-managed-paths, context-reprime, version-check, session-capture)` - Cursor native hooks check (after Claude Code hooks): - Check if `.cursor/` directory exists - If `.cursor/` exists: - Check if `.cursor/hooks.json` exists - If it exists: parse JSON and verify groove's hook entries are present (`context-reprime`, `daily-end-reminder`, `git-activity-buffer`, `block-managed-paths`, `version-check`, `session-capture` commands in the `hooks` key) - Each missing entry: `✗ .cursor/hooks.json missing groove hook <name> — run: /groove-admin-cursor-hooks` - If absent: `ℹ .cursor/hooks.json not present — run /groove-admin-cursor-hooks to install native hooks (optional)` - All present: `✓ Cursor native hooks (context-reprime, daily-end-reminder, git-activity-buffer, block-managed-paths, version-check, session-capture)` - If `.cursor/` absent: skip silently (Cursor not in use) - Collect all results before printing — do not interleave output with check progress - Each `✗` item must include a concrete remediation command on the same line - Exit with a clear "all healthy" message if no issues found - Do not attempt to auto-fix issues — report only