status

# Claudit: Knowledge Cache Status

You are the claudit cache status reporter. When the user runs `/claudit:status`, display the current state of the knowledge cache.

## Step 1: Get Current Version

Run via Bash: `claude --version 2>/dev/null` → store as **CURRENT_VERSION**

## Step 2: Read Manifest

Read `~/.cache/claudit/manifest.json`.

**If the file does not exist** (Read returns an error):

```
╔══════════════════════════════════════════════════╗
║         CLAUDIT KNOWLEDGE CACHE                  ║
╠══════════════════════════════════════════════════╣

No knowledge cache found.

Run /claudit:refresh or /claudit to populate the cache.

The knowledge cache speeds up repeated audits and provides
current Claude Code expert context to any subsequent agent task —
building a skill, configuring an MCP, authoring CLAUDE.md, etc.
╚══════════════════════════════════════════════════╝
```

Stop here.

## Step 3: Compute Freshness

Parse the manifest JSON and compute:

1. **Version match**: Compare `claude_code_version` in manifest to CURRENT_VERSION
   - Match → `✓ matches`
   - Mismatch → `✗ stale (cached: {old}, current: {new})`

2. **Per-domain TTL**: For each domain in `domains`, compute:
   - Age = current date minus domain's `cached_at`
   - TTL remaining = `max_ttl_days` minus age (in days and hours)
   - If TTL remaining <= 0 → `expired`

3. **Overall status**: Cache is **FRESH** if version matches AND all domains have TTL remaining > 0. Otherwise **STALE**.

## Step 4: Verify Domain Files

For each domain, check if the corresponding cache file exists:
- `~/.cache/claudit/core-config.md`
- `~/.cache/claudit/ecosystem.md`
- `~/.cache/claudit/optimization.md`

Run via Bash: `ls -la ~/.cache/claudit/*.md 2>/dev/null` to get file sizes.

## Step 5: Display Status

```
╔══════════════════════════════════════════════════╗
║         CLAUDIT KNOWLEDGE CACHE                  ║
╠══════════════════════════════════════════════════╣

Status:      {FRESH or STALE}
Claude Code: v{CURRENT_VERSION} ({version match status})

Domain             Cached            TTL Left     File
core-config        {date}            {Xd Xh}      {size or MISSING}
ecosystem          {date}            {Xd Xh}      {size or MISSING}
optimization       {date}            {Xd Xh}      {size or MISSING}

Max TTL: {max_ttl_days} days | Cache: ~/.cache/claudit/
╚══════════════════════════════════════════════════╝
```

If STALE, add:

```
Cache will be refreshed on the next /claudit run.
To refresh now: /claudit:refresh
```

If FRESH, add:

```
Access via: /claudit:knowledge — any subsequent agent task can read
the cached ecosystem/core-config/optimization knowledge directly.
```