Initial commit

commands/openspec/status.md

@@ -0,0 +1,104 @@
+---
+name: openspec:status
+description: Show current OpenSpec change status and progress.
+category: openspec
+tags: [openspec, status, progress]
+---
+
+<!-- OPENSPEC:START -->
+
+**Purpose**
+
+This command shows the current state of your OpenSpec work:
+
+- Which change you're actively working on
+- Progress on tasks (completed vs remaining)
+- Time since you started and last checkpoint
+- Quick access to the OpenSpec dashboard
+
+**Steps**
+
+1. **Check for active change**
+   - Read `openspec/active.json`
+   - If file doesn't exist or is empty: "No active change. Use /openspec:work to start working on a change."
+   - Exit if no active change
+
+2. **Parse active change data**
+   - Extract: `change` (change ID), `started` (timestamp), `lastCheckpoint` (timestamp)
+   - Calculate time elapsed since started and last checkpoint
+
+3. **Run OpenSpec dashboard**
+   - Execute `openspec view` to get current state of all changes
+   - This shows the progress bars and task counts
+
+4. **Load task progress**
+   - Read `openspec/changes/<change-id>/tasks.md`
+   - Count total tasks (lines starting with `- [ ]` or `- [x]`)
+   - Count completed tasks (lines starting with `- [x]`)
+   - Calculate percentage: `(completed / total) * 100`
+
+5. **Display status summary**
+
+   ```txt
+   📊 OpenSpec Status
+
+   Active Change: <change-id>
+   Started: <X hours/days ago>
+   Last Checkpoint: <Y minutes/hours ago>
+
+   Progress:
+   ├─ Tasks: <completed>/<total> (<percentage>%)
+   ├─ Status: <In Progress|Blocked|Ready for Review>
+   └─ Next: <first incomplete task from tasks.md>
+
+   Recent Context (from design.md):
+   <last 5-10 lines of design.md to show recent decisions/progress>
+
+   Commands:
+   - /openspec:checkpoint - Save current progress
+   - /openspec:work - Switch to different change
+   - /openspec:done - Complete and archive
+   ```
+
+6. **Show OpenSpec dashboard**
+   - Output result of `openspec view` for full context
+
+**Error Handling**
+
+- If active.json exists but change directory missing: "Active change '<change-id>' not found. It may have been archived. Use /openspec:work to select a new change."
+- If tasks.md missing: Show "0/0 tasks (no tasks.md found)"
+- If design.md missing: Skip "Recent Context" section
+
+**Example Usage**
+
+```txt
+User: /openspec:status
+Assistant:
+📊 OpenSpec Status
+
+Active Change: add-dark-mode
+Started: 2 hours ago
+Last Checkpoint: 15 minutes ago
+
+Progress:
+├─ Tasks: 8/12 (67%)
+├─ Status: In Progress
+└─ Next: Implement theme toggle in settings page
+
+Recent Context (from design.md):
+- Created ThemeContext with light/dark modes
+- Added theme provider to root layout
+- Implemented CSS variable system for colors
+- Need to add persistence with localStorage
+
+[openspec view output shown]
+```
+
+**Notes**
+
+- This command is read-only - it doesn't modify anything
+- Useful for quick progress checks without reading all files
+- Shows "at a glance" summary before diving into details
+- Complements `openspec view` with active change focus
+
+<!-- OPENSPEC:END -->