Index Status

---
name: index-status
description: "Show the current state of the project index: staleness, module coverage, hook health, and recent sync activity. Use to diagnose index issues."
disable-model-invocation: true
allowed-tools: ["Read", "Glob", "Grep", "Bash"]
---

# /index-status

Show the health and status of the project index.

## Step 1: Announce

Say: "Checking MacroManAtlas index status..."

## Step 2: Check index existence

Read `.claude/index.md`. If it doesn't exist, report:
```
MacroManAtlas Status
────────────────
⚠ No index found. Run /index-init to generate one.
```
And stop.

## Step 3: Parse index metadata

From `.claude/index.md`, extract:
- Generation timestamp
- Project type
- Module count
- File count

## Step 4: Check each module

For each module listed in the index:
1. Check if `<Module>/README.md` exists
2. Get the README's last modification time (use `git log -1 --format=%ci -- <Module>/README.md` or Bash `stat`)
3. Get the latest file modification in the module (use `git log -1 --format=%ci -- <Module>/`)
4. Count files in filesystem: `git ls-files <Module>/ | wc -l` (or Glob fallback)
5. Count files listed in the README's Files table
6. Compare: if filesystem has more files than README, mark as stale

Status symbols:
- ✓ = README exists and is fresh (no newer files than README)
- ⚠ = README exists but stale (newer files not indexed)
- ✗ = No README.md found

## Step 5: Check hooks

Read the plugin's hooks.json to verify hook registration. Check for:
- SessionStart hook
- PostToolUse hook
- PreCompact hook
- Stop hook

## Step 6: Check recent sync activity

Read last 20 lines of `~/.claude/logs/index-sync.log` (if exists).
Extract the most recent sync: module name and timestamp.

## Step 7: Present dashboard

Format output as:

```
MacroManAtlas Status
────────────────
Index: .claude/index.md (generated <time ago>)
Type: <project-type> | Modules: <N> | Indexed files: <N>

Module Health:
  ✓ ModuleName          — <N> files, README fresh
  ⚠ ModuleName          — <N> files, README stale (<N> new files not indexed)
  ✗ ModuleName          — no README.md

Hooks: SessionStart ✓ | PostToolUse ✓ | PreCompact ✓ | Stop ✓
Last sync: <module> (<time ago>) — <change_type>
```

If no sync log exists, show: `Last sync: no activity recorded`