context-audit

# zuvo:context-audit — Context Health Monitor Tracks what fills your context window over time and flags waste. Two data sources: 1. **Auto-collected** — `~/.zuvo/runs.log` field 12 (`name:bytes` pairs, populated by `track-includes.sh` hook on every Read) 2. **Manual** — `/context` output (optional, for full system-level audit) ## Argument Parsing | Flag | Effect | |------|--------| | `--full` | Full audit: requires `/context` data. Audits MCP, CLAUDE.md, settings, permissions | | `--baseline` | Save current state as baseline for future delta comparisons | | `--since N` | Show trend for last N days (default: 7) | | _(no flags)_ | Trend mode: analyze context-metrics.log, show include loading patterns | ## Mandatory File Loading Read these files: ``` CORE FILES LOADED: 1. ../../shared/includes/run-logger.md -- READ 2. ../../shared/includes/retrospective.md -- READ ``` ## Phase 0: Collect Data ### Metrics data (from runs.log) Read `~/.zuvo/runs.log` — the single source of truth for all skill run data: ```bash RUNS_LOG="$HOME/.zuvo/runs.log" ``` Filter entries that have INCLUDES data (field 12 contains `:`). These are v3+ entries with `name:bytes` format. ```bash # Extract v3 entries (field 12 has name:bytes pairs) awk -F'\t' 'NF>=12 && $12 ~ /:/' "$RUNS_LOG" ``` If fewer than 3 entries with INCLUDES data: print "Not enough data yet. Run a few zuvo skills first — the `track-includes.sh` hook captures include sizes automatically." and exit. Parse field 12...