opencode-goopspec 0.1.2 → 0.1.4

package/commands/goop-status.md

@@ -1,153 +1,299 @@
 ---
 name: goop-status
-description: Show GoopSpec status and progress
+description: Show current GoopSpec status and next steps
 ---
 
-# GoopSpec Status
+# /goop-status
 
-Display the current status of your GoopSpec project and workflow progress.
+**Show project status.** View progress, active phase, gates, and suggested next command.
 
 ## Usage
 
+```bash
+/goop-status [--verbose]
 ```
-/goop-status
-```
 
-## Information Shown
+## Tools Used
+
+| Tool | Purpose in This Command |
+|------|------------------------|
+| `goop_status` | Primary tool - retrieves full workflow state |
+| `memory_search` | Optionally find recent context |
 
-### Project State
-- Initialized: Yes/No
-- Active: Yes/No
-- Current milestone (if any)
-- Task mode: Quick | Standard | Comprehensive | Milestone
+**Hook Support:** None specific - read-only operation.
 
-### Current Workflow
-- Phase: Plan | Research | Specify | Execute | Accept
-- Spec locked: Yes/No
-- Acceptance confirmed: Yes/No
-- Last activity timestamp
+---
 
-### Execution Progress (if in Execute phase)
-- Current wave: N of M
-- Tasks completed in current wave
-- Total tasks completed
-- Recent commits
+## Process
 
-### Contract Status
-- Specification locked at: [timestamp]
-- Must-haves: N total
-- Must-haves completed: N of M
-- Nice-to-haves completed: N of M
+**Execute these reads:**
 
-### Checkpoints
-- Total checkpoints saved
-- Latest checkpoint info
-- Resume available: Yes/No
+```
+Read(".goopspec/state.json")
+Read(".goopspec/REQUIREMENTS.md")
+Read(".goopspec/SPEC.md")
+Read(".goopspec/BLUEPRINT.md")
+Read(".goopspec/CHRONICLE.md")
+Read(".goopspec/HANDOFF.md")
+```
 
-### Memory Stats
-- Decisions logged: N
-- Observations saved: N
-- Patterns documented: N
+## Status Dashboard
 
-## Example Output
+Display a comprehensive status view:
 
 ```
-⬢ GoopSpec · Status
-──────────────────────────────────────────────────────
++--------------------------------------------------------+
+|  GOOPSPEC STATUS                                        |
++--------------------------------------------------------+
+
+## Project State
+
+| Attribute | Value |
+|-----------|-------|
+| Phase | [current phase] |
+| Interview Complete | [Yes/No] |
+| Spec Locked | [Yes/No] |
+| Wave | [N of M] |
+| Task | [X of Y] |
+
+## Gate Status
+
+| Gate | Status | Requirement |
+|------|--------|-------------|
+| Discovery | [PASSED/BLOCKED] | interview_complete |
+| Spec | [PASSED/BLOCKED] | spec_locked |
+| Execution | [PASSED/BLOCKED] | all_tasks_done |
+| Acceptance | [PASSED/BLOCKED] | verification_passed |
 
-Project: Initialized ✓
-Mode: Standard
-Milestone: Authentication System
+## Progress
 
-WORKFLOW:
-Phase: Execute (Wave 2 of 4)
-Spec Locked: Yes (2024-01-15 10:30)
-Acceptance: Pending
+[Progress bar and completion percentage]
 
-PROGRESS:
-Wave 1: Foundation [COMPLETE] ✓
-  ☑ Task 1.1: Setup
-  ☑ Task 1.2: Config
-  ☑ Task 1.3: Base
+### Completed
+- [x] [Item 1]
+- [x] [Item 2]
 
-Wave 2: Core [IN PROGRESS]
-  ☑ Task 2.1: Auth
-  ◉ Task 2.2: Logic
-  ○ Task 2.3: Data
+### In Progress
+- [ ] [Current item] <- **Current**
 
-Wave 3: Integration [PENDING]
-Wave 4: Polish [PENDING]
+### Remaining
+- [ ] [Item 3]
+- [ ] [Item 4]
 
-MUST-HAVES: 2 of 3 complete
-☑ User can log in
-☑ Session persists
-○ Error messages displayed
+## Active Blockers
 
-CHECKPOINTS: 2 saved
-Latest: checkpoint-xyz789 (30 mins ago)
+[None | List of blockers]
 
-MEMORY: 5 decisions, 12 observations
+## Pending Decisions
 
-──────────────────────────────────────────────────────
+[None | List of decisions awaiting user input]
+
+## Recent Activity
+
+| Time | Action | Agent |
+|------|--------|-------|
+| [time] | [action] | [agent] |
+
++--------------------------------------------------------+
+
+## > Suggested Next Command
+
+Based on current state: `/goop-[command]`
+
+[Brief explanation of why this is suggested]
+
++--------------------------------------------------------+
 ```
 
-## Phase-Specific Information
+## Information Sources
 
-### Plan Phase
-- Intent captured: Yes/No
-- Requirements categorized: Yes/No
-- Success criteria defined: Yes/No
-- Ready for research: Yes/No
+| Source | Information |
+|--------|-------------|
+| `state.json` | Phase, locks, timestamps |
+| `REQUIREMENTS.md` | Interview status |
+| `SPEC.md` | Must-haves, lock status |
+| `BLUEPRINT.md` | Waves, tasks, traceability |
+| `CHRONICLE.md` | Progress, decisions, blockers |
+| `HANDOFF.md` | Last session context |
 
-### Research Phase
-- Agents spawned: N
-- Research complete: Yes/No
-- RESEARCH.md created: Yes/No
-- Ready for specify: Yes/No
+## Gate Logic
 
-### Specify Phase
-- SPEC.md created: Yes/No
-- BLUEPRINT.md created: Yes/No
-- Contract presented: Yes/No
-- User confirmed: Yes/No
-
-### Execute Phase
-- Current wave: N of M
-- Tasks complete: N of M
-- Deviations: N logged
-- Blockers: N active
-
-### Accept Phase
-- Verification complete: Yes/No
-- Must-haves verified: N of M
-- Tests passing: Yes/No
-- User accepted: Yes/No
-
-## Quick Actions
-
-From status view, you can:
-- `/goop-plan [intent]` - Start planning
-- `/goop-research` - Begin research
-- `/goop-specify` - Lock specification
-- `/goop-execute` - Continue execution
-- `/goop-accept` - Verify completion
-- `/goop-pause` - Save checkpoint
-- `/goop-resume` - Resume from checkpoint
+### Discovery Gate
+```
+IF REQUIREMENTS.md exists AND interview_complete == true:
+  PASSED
+ELSE:
+  BLOCKED - Run /goop-discuss
+```
+
+### Spec Gate
+```
+IF SPEC.md exists AND spec_locked == true:
+  PASSED
+ELSE:
+  BLOCKED - Run /goop-specify
+```
+
+### Execution Gate
+```
+IF CHRONICLE shows all waves complete:
+  PASSED
+ELSE:
+  BLOCKED - Continue /goop-execute
+```
+
+### Acceptance Gate
+```
+IF verification_passed == true AND user_accepted == true:
+  PASSED
+ELSE:
+  BLOCKED - Run /goop-accept
+```
+
+## Suggested Commands
+
+Based on current state, suggest the appropriate next command:
+
+| State | Suggested Command |
+|-------|-------------------|
+| No project | `/goop-discuss` to start discovery |
+| Interview incomplete | `/goop-discuss` to complete interview |
+| Interview complete, no spec | `/goop-plan` to create blueprint |
+| Spec draft, not locked | `/goop-specify` to lock |
+| Spec locked, not executing | `/goop-execute` to start |
+| Executing, tasks remaining | `/goop-execute` to continue |
+| Executing, all done | `/goop-accept` to verify |
+| Verified, not accepted | `/goop-accept` to accept |
+| Accepted | `/goop-complete` to archive |
 
 ## Verbose Mode
 
-For detailed status:
+With `--verbose`:
+
+```
+## Full Task History
+
+| Wave | Task | Status | Commit | Time |
+|------|------|--------|--------|------|
+| 1 | 1.1 | Complete | abc123 | 10m |
+| 1 | 1.2 | Complete | def456 | 15m |
+| 2 | 2.1 | In Progress | - | - |
 
+## Memory Stats
+
+- Total memories: [N]
+- Decisions: [M]
+- Observations: [P]
+- Recent: [list]
+
+## Recent Deviations
+
+| Rule | Description | Resolution |
+|------|-------------|------------|
+| [N] | [What happened] | [How resolved] |
+
+## Checkpoint History
+
+| ID | Phase | Wave | Created |
+|----|-------|------|---------|
+| [id] | [phase] | [wave] | [time] |
 ```
-/goop-status --verbose
+
+## Examples
+
+**Fresh Project:**
 ```
+User: /goop-status
+
++--------------------------------------------------------+
+|  GOOPSPEC STATUS                                        |
++--------------------------------------------------------+
+
+## Project State
+
+| Attribute | Value |
+|-----------|-------|
+| Phase | idle |
+| Interview Complete | No |
+| Spec Locked | No |
+
+## Gate Status
+
+| Gate | Status |
+|------|--------|
+| Discovery | BLOCKED |
+| Spec | BLOCKED |
+| Execution | BLOCKED |
+| Acceptance | BLOCKED |
+
+## > Suggested Next Command
+
+`/goop-discuss` - Start discovery interview
+
+No project documents found. Begin with discovery.
+```
+
+**Mid-Execution:**
+```
+User: /goop-status
+
++--------------------------------------------------------+
+|  GOOPSPEC STATUS                                        |
++--------------------------------------------------------+
+
+## Project State
+
+| Attribute | Value |
+|-----------|-------|
+| Phase | execute |
+| Interview Complete | Yes |
+| Spec Locked | Yes |
+| Wave | 2 of 3 |
+| Task | 3 of 4 |
+
+## Gate Status
+
+| Gate | Status |
+|------|--------|
+| Discovery | PASSED |
+| Spec | PASSED |
+| Execution | In Progress |
+| Acceptance | Pending |
+
+## Progress
+
+[################____] 75%
+
+### Completed
+- [x] Wave 1: Foundation (4/4 tasks)
+- [x] Wave 2.1: Define types
+- [x] Wave 2.2: Implement handler
+
+### In Progress
+- [ ] Wave 2.3: Add validation <- **Current**
+
+### Remaining
+- [ ] Wave 2.4: Add tests
+- [ ] Wave 3: Integration (3 tasks)
+
+## > Suggested Next Command
+
+`/goop-execute` - Continue Wave 2
+
+2 tasks remaining in Wave 2, then Wave 3.
+```
+
+## Success Criteria
 
-Shows additional information:
-- Full task list with commit hashes
-- All deviations with details
-- Complete checkpoint history
-- Memory entries related to current work
+- [ ] All state files read
+- [ ] Phase correctly identified
+- [ ] Gate status accurately shown
+- [ ] Progress clearly displayed
+- [ ] Blockers highlighted
+- [ ] Next command suggested based on state
+- [ ] Verbose mode shows full history
 
 ---
 
-**GoopSpec**: Know exactly where you stand.
+*Status Protocol v0.1.4*
+*"Know where you are. Know where to go."*