---
name: config-audit:status
description: Show current session state and available actions
allowed-tools: Read, Glob, Bash
model: sonnet
---

# Config-Audit: Status

Display current session state and guide next actions.

## Usage

```
/config-audit status
/config-audit status --raw   # show the raw v5.0.0 phase identifiers (current_phase: "discover", etc.) instead of humanized labels
```

## Phase-label translation

The `state.yaml` field `current_phase` is the machine contract — never rename it. The user-facing label is humanized. Map the field value to a plain-language label when rendering (default mode):

| `current_phase` (machine field, unchanged) | User-facing label |
|--------------------------------------------|-------------------|
| `discover`  | Looking at your config files |
| `analyze`   | Working out what to recommend |
| `interview` | Asking what you'd like to focus on |
| `plan`      | Putting together your action plan |
| `implement` | Making the changes |
| `verify`    | Double-checking everything worked |

When `--raw` is in `$ARGUMENTS`, render the raw `current_phase` field value verbatim (no humanization).

## Implementation

1. **Parse flags**:
   ```bash
   RAW_FLAG=""
   if echo "$ARGUMENTS" | grep -q -- "--raw"; then RAW_FLAG="--raw"; fi
   ```

2. **Find active session**:
   ```
   Glob: ~/.claude/config-audit/sessions/*/state.yaml
   Sort by modification time
   Use most recent
   ```

3. **Read session state** with the Read tool:
   ```yaml
   session_id: "20250126_143022"
   current_phase: "analyze"
   completed_phases: ["discover", "analyze"]
   next_phase: "interview"
   ...
   ```

4. **Display status** (default mode — humanized phase labels):
   ```
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   Config-Audit Session Status
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   Session:  20250126_143022
   Started:  2025-01-26 14:30:22

   PHASE PROGRESS
   ──────────────
   ✓ Phase 1: Looking at your config files     - 15 files found (current directory)
   ✓ Phase 2: Working out what to recommend    - report generated
   ○ Phase 3: Asking what you'd like to focus on - not started (optional)
   ○ Phase 4: Putting together your action plan  - not started
   ○ Phase 5: Making the changes                 - not started

   NEXT ACTION
   ───────────
   Run: /config-audit interview
   Or:  /config-audit plan (skip interview)

   SESSION FILES
   ─────────────
   Scope:    ~/.claude/config-audit/sessions/20250126_143022/scope.yaml
   Findings: ~/.claude/config-audit/sessions/20250126_143022/findings/
   Report:   ~/.claude/config-audit/sessions/20250126_143022/analysis-report.md

   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   ```

   In `--raw` mode, replace the humanized phase labels with the verbatim machine field values (`Phase 1: discover`, `Phase 2: analyze`, etc.).

5. **If no session found**:
   ```
   No active config-audit session found.

   Start a new audit with:
   /config-audit           # Full audit with auto-scope
   /config-audit discover  # Discovery phase only
   ```

## Session Information

Display based on completed phases:

| Phase | Info to Display |
|-------|-----------------|
| scope | Scope type, paths to scan |
| discover | Files found count, issues count |
| analyze | Conflicts, duplicates, opportunities |
| interview | Preferences summary |
| plan | Actions count, risk level |
| implement | Success/fail counts, backup location |

## List All Sessions

With `all` flag:
```
/config-audit status all
```

Shows:
```
All config-audit sessions:

| Session | Phase | Created |
|---------|-------|---------|
| 20250126_143022 | analyze | 2025-01-26 14:30 |
| 20250125_091500 | complete | 2025-01-25 09:15 |
| 20250120_160000 | implement | 2025-01-20 16:00 |
```

## Resume Session

If multiple sessions exist:
```
/config-audit resume {session-id}
```

Sets that session as active and continues from last phase.
