# pulse:status

> Show PULSE project status - progress, config, errors. Reads from CONFIG.json, PULSE_FEATURES.json, PULSE_PROGRESS.json.

- Author: Damion Davy
- Repository: drddavi/PULSE
- Version: 20260126085815
- Stars: 1
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/drddavi/PULSE
- Web: https://mule.run/skillshub/@@drddavi/PULSE~pulse:status:20260126085815

---

---
name: pulse:status
description: Show PULSE project status - progress, config, errors. Reads from CONFIG.json, PULSE_FEATURES.json, PULSE_PROGRESS.json.
---

# Project Status

Display current project status.

## Pre-Check: Ensure Config Complete

Before displaying status, merge any missing CONFIG.json keys from the reference template.

**Reference:** `~/.claude/skills/pulse-project-init/templates/CONFIG.json`

```bash
jq --slurpfile ref <(cat ~/.claude/skills/pulse-project-init/templates/CONFIG.json) '
  ($ref[0].settings + .settings) as $settings |
  ($ref[0].verification + .verification) as $verification |
  ($ref[0].models + .models) as $models |
  . + {settings: $settings, verification: $verification, models: $models}
' .pulse/CONFIG.json > .pulse/CONFIG.tmp && mv .pulse/CONFIG.tmp .pulse/CONFIG.json
```

If keys were added, display: `Config updated: Added {list of keys}`

---

## Process

1. **Check init**: If no `.pulse/CONFIG.json`, tell user to run `/pulse:project-init`

2. **Load files**:
   - `.pulse/CONFIG.json` - project settings
   - `.pulse/PULSE_FEATURES.json` - all features with status
   - `.pulse/PULSE_PROGRESS.json` - execution state

3. **Calculate**:
   - Total features, completed, skipped, pending
   - Current feature (if executing)
   - Total duration (sum of duration_minutes)
   - Features with retries (total_attempts > 1)

4. **Display** (adapt header based on PULSE_PROGRESS.json status):

```
═══════════════════════════════════════════════════════════════════════════
  [Project Name] - Status
═══════════════════════════════════════════════════════════════════════════

  Progress: 7/7 features (100%)

  Feature 1: playwright-verification-test   ✓ Complete
  Feature 2: full-pipeline-playwright-test  ✓ Complete
  Feature 3: localhost-multi-screenshot     ✓ Complete
  Feature 4: playwright-final-test          ✓ Complete
  Feature 5: fork-verifier-test             ✓ Complete
  Feature 6: engine-skills-test             ✓ Complete
  Feature 7: lean-orchestrator-test         ✓ Complete

───────────────────────────────────────────────────────────────────────────
  Summary
───────────────────────────────────────────────────────────────────────────

  ┌────┬──────────────────────────────┬──────────┬──────────┬─────────────────┐
  │ #  │ Feature                      │ Status   │ Duration │ Attempts        │
  ├────┼──────────────────────────────┼──────────┼──────────┼─────────────────┤
  │ 1  │ playwright-verification-test │ ✓ Done   │ 4 min    │ 3 (2 retries)   │
  │ 2  │ full-pipeline-playwright-test│ ✓ Done   │ 4 min    │ 2 (1 retry)     │
  │ 3  │ localhost-multi-screenshot   │ ✓ Done   │ 7 min    │ 1               │
  │ 4  │ playwright-final-test        │ ✓ Done   │ 6 min    │ 3 (2 retries)   │
  │ 5  │ fork-verifier-test           │ ✓ Done   │ 4 min    │ 1               │
  │ 6  │ engine-skills-test           │ ✓ Done   │ 5 min    │ 1               │
  │ 7  │ lean-orchestrator-test       │ ✓ Done   │ 2 min    │ 1               │
  └────┴──────────────────────────────┴──────────┴──────────┴─────────────────┘

  Total: 7 features │ Completed: 7 │ Skipped: 0 │ Duration: 32 min

───────────────────────────────────────────────────────────────────────────
  Config
───────────────────────────────────────────────────────────────────────────

  Models:
    Default model:         sonnet    (first attempts)
    Retry model:           opus      (after threshold)
    Escalate after:        1 attempt(s)

  Retries:
    Max retries/session:   3
    Skip on max retries:   false     (block if false)

  Settings:
    Auto commit:           false
    Auto process features: false

═══════════════════════════════════════════════════════════════════════════
  Commands: /pulse:features-from-file | /pulse:execute
═══════════════════════════════════════════════════════════════════════════
```

## Status Headers

| PULSE_PROGRESS.json status | Header |
|---------------------------|--------|
| `idle` | `[Project] - Status` |
| `executing` | `[Project] - EXECUTING` |
| `complete` | `[Project] - COMPLETE ✓` |
| `blocked` | `[Project] - BLOCKED ⚠` |

## Status Icons

| Icon | Status |
|------|--------|
| `✓` | complete |
| `○` | pending |
| `▶` | in_progress / pending_verification |
| `⊘` | skipped |
| `⚠` | blocked |

## Summary Table Rules

| Column | Source | Format |
|--------|--------|--------|
| # | `feature.id` | Number |
| Feature | `feature.name` | Truncate to 28 chars |
| Status | `feature.status` | `✓ Done`, `⊘ Skip`, `⚠ Block`, `○ Pending` |
| Duration | `feature.duration_minutes` | `X min` or `-` if null |
| Attempts | `feature.total_attempts` | Show `(N retries)` if > 1 |

## If Blocked

Show blocker details prominently:

```
═══════════════════════════════════════════════════════════════════════════
  [Project Name] - BLOCKED ⚠
═══════════════════════════════════════════════════════════════════════════

  Feature: 7 (lean-orchestrator-test)
  Error: {error from PULSE_PROGRESS.json}
  Last error: {last_error from feature}

  Options:
    1. Fix issue, run /pulse:execute to resume
    2. Run /pulse:features-from-file-unblock to skip/retry

═══════════════════════════════════════════════════════════════════════════
```

## If Executing

Show current stage:

```
═══════════════════════════════════════════════════════════════════════════
  [Project Name] - EXECUTING
═══════════════════════════════════════════════════════════════════════════

  Current: Feature 7 (lean-orchestrator-test)
  Stage: worker
  Model: sonnet

  ...features list...
```

## Potential Issues Section

Show when ANY feature has issues:

```
───────────────────────────────────────────────────────────────────────────
  Potential Issues
───────────────────────────────────────────────────────────────────────────

  • Feature 1 (playwright-verification-test): Required 2 retries
  • Feature 4 (playwright-final-test): Required 2 retries
  • Feature 6 (notifications): Skipped after 3 attempts
```

Triggers:
- `status == "skipped"` → "Skipped after N attempts"
- `status == "blocked"` → "Blocked: {last_error}"
- `total_attempts > 1` → "Required N retries"