Health

---
name: health
description: Plugin health check — version, auth, hooks, graph, tasks.
argument-hint: "[--json]"
---

Run a full diagnostic of the Composure installation and project setup. This skill is self-contained — no API calls needed.

## Progress Tracking

This skill uses TaskCreate for progress tracking. Before starting work:
1. Create one task per major step using TaskCreate
2. Set each task to `in_progress` when starting it (TaskUpdate)
3. Mark `completed` when done
4. Write deliverables to files, not inline — inline text is for communication only

## Content Loading

**Preferred (MCP tool):**

Invoke the `composure_fetch_skill` MCP tool with:
- `plugin`: `"composure"`
- `skill`: `"health"`
- `step`: the step filename without the `.md` extension


**Fallback (Bash CLI — for sandbox environments where MCP servers are not available):**

```bash
<home>/.composure/bin/composure-fetch.mjs skill composure health {step-filename}
```

Replace `<home>` with the user's **resolved absolute home directory** (e.g., `/Users/username` on macOS, `/home/username` on Linux). Do NOT use `$HOME`, `~`, or quotes — Claude Code permissions require the literal path.

**Do NOT read cache files directly** — they are encrypted at rest. Always use one of the methods above.

## Steps

| # | File | Purpose |
|---|------|---------|
| 01 | `01-plugin-manifests.md` | Plugin version + manifest validation |
| 02 | `02-hook-integrity.md` | SHA-256 verification of installed hooks |
| 03 | `03-fetch-binaries.md` | Verify CLI binaries present + executable |
| 04 | `04-cortex-state.md` | Cortex + graph database state (includes Decision 19 path detection) |
| 05 | `05-auth-state.md` | Authentication status (read-only, never prompts) |
| 06 | `06-remediate.md` | Present fix-up commands for any detected drift |

Execute all 6 steps in order. Do NOT skip checks — run all of them even if earlier ones fail. After all steps, present results in the standard status table format. If `--json` is provided, output JSON instead.