specflow-cc 1.0.0

package/commands/sf/deps.md

@@ -0,0 +1,234 @@
+---
+name: sf:deps
+description: Show dependency graph between specifications
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+---
+
+<purpose>
+Display the dependency graph between specifications. Shows which specs can be worked on immediately (no dependencies), which are blocked, and the chains of dependent work. Helps plan execution order.
+</purpose>
+
+<context>
+@.specflow/STATE.md
+@.specflow/specs/SPEC-*.md
+</context>
+
+<arguments>
+- `[ID]` — Specification ID to show dependencies for. Optional — shows full graph if omitted.
+</arguments>
+
+<workflow>
+
+## Step 1: Verify Initialization
+
+```bash
+[ -d .specflow ] && echo "OK" || echo "NOT_INITIALIZED"
+```
+
+**If NOT_INITIALIZED:**
+```
+SpecFlow not initialized.
+
+Run `/sf init` first.
+```
+Exit.
+
+## Step 2: Scan All Specifications
+
+```bash
+ls .specflow/specs/SPEC-*.md 2>/dev/null
+```
+
+**If no specs:**
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ DEPENDENCY GRAPH
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+No specifications found.
+
+Create your first spec: `/sf new "task description"`
+```
+Exit.
+
+## Step 3: Parse Dependencies
+
+For each specification, read frontmatter and extract:
+- `id` — Specification ID
+- `status` — Current status
+- `depends_on` — Array of dependency IDs (may be empty)
+- `title` — From first heading
+
+Build dependency map:
+```
+{
+  "SPEC-001a": { status: "done", depends_on: [], title: "..." },
+  "SPEC-001b": { status: "running", depends_on: ["SPEC-001a"], title: "..." },
+  "SPEC-001c": { status: "draft", depends_on: ["SPEC-001b"], title: "..." }
+}
+```
+
+## Step 4: Branch Based on Arguments
+
+**If specific ID provided:** Go to Step 5a (Specific View)
+**If no ID provided:** Go to Step 5b (Full Graph View)
+
+## Step 5a: Specific Spec Dependencies
+
+**Check spec exists:**
+```bash
+[ -f ".specflow/specs/{ID}.md" ] && echo "FOUND" || echo "NOT_FOUND"
+```
+
+**If NOT_FOUND:**
+```
+Specification {ID} not found.
+
+Use `/sf list` to see available specifications.
+```
+Exit.
+
+**Display specific dependencies:**
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ DEPENDENCIES: {ID}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Spec:** {ID} — {title}
+**Status:** {status}
+
+## Depends On (upstream)
+
+{If no dependencies:}
+None — this specification can be worked on immediately.
+
+{If has dependencies:}
+| ID        | Title                    | Status  |     |
+|-----------|--------------------------|---------|-----|
+| SPEC-XXX  | {title}                  | done    | ✓   |
+| SPEC-YYY  | {title}                  | running | ← blocking |
+
+## Depended By (downstream)
+
+{If nothing depends on this:}
+None — no other specifications depend on this.
+
+{If has dependents:}
+| ID        | Title                    | Status  |
+|-----------|--------------------------|---------|
+| SPEC-ZZZ  | {title}                  | blocked |
+
+---
+
+{If blocked:}
+**Blocked by:** {blocking spec ID} must complete first.
+
+When {blocking ID} is done, run: `/sf run {ID}`
+
+{If ready:}
+**Ready:** All dependencies satisfied.
+
+Next: `/sf audit {ID}` or `/sf run {ID}`
+
+{If done:}
+**Complete:** This specification is done.
+
+{If has dependents that are now ready:}
+**Unblocked:** The following can now proceed:
+- {dependent ID}
+```
+Exit.
+
+## Step 5b: Full Graph View
+
+### Categorize Specs
+
+**Independent (no depends_on):**
+- Can be started immediately
+- Status: draft, audited, etc.
+
+**In Chains (has depends_on or is depended upon):**
+- Part of dependency sequences
+- Show chains visually
+
+**Blocked (depends on incomplete spec):**
+- Cannot proceed until dependency completes
+
+### Build Chain Visualization
+
+For each chain, create visual:
+```
+SPEC-001a [done] → SPEC-001b [running] → SPEC-001c [blocked]
+                   ↑ you are here
+```
+
+### Display Full Graph
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ DEPENDENCY GRAPH
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+## Independent (can start now)
+
+{If any:}
+| ID       | Title                    | Status  |
+|----------|--------------------------|---------|
+| SPEC-002 | API rate limiting        | draft   |
+| SPEC-005 | Settings page            | audited |
+
+{If none:}
+None — all specifications are in dependency chains.
+
+## Chains
+
+{For each chain:}
+```
+SPEC-001a [done] → SPEC-001b [running] → SPEC-001c [blocked] → SPEC-001d [blocked]
+                   ↑ current
+```
+
+{If parallel chains:}
+```
+SPEC-003 [audited] → SPEC-004 [draft]
+```
+
+## Summary
+
+| Category    | Count |
+|-------------|-------|
+| Ready       | {N}   |
+| In Progress | {N}   |
+| Blocked     | {N}   |
+| Done        | {N}   |
+
+---
+
+**Next actionable:**
+{List specs that are ready to work on, sorted by priority}
+
+- `/sf run SPEC-001b` (running)
+- `/sf audit SPEC-005` (audited)
+- `/sf audit SPEC-002` (draft)
+
+**Tip:** `/sf deps SPEC-XXX` for details on a specific spec.
+```
+
+</workflow>
+
+<success_criteria>
+- [ ] Initialization verified
+- [ ] All specs scanned and parsed
+- [ ] Dependencies extracted from frontmatter
+- [ ] Graph built correctly (no circular deps assumed)
+- [ ] Independent specs identified
+- [ ] Chains visualized clearly
+- [ ] Blocked specs identified with blocker
+- [ ] Summary statistics provided
+- [ ] Next actionable specs suggested
+</success_criteria>

package/commands/sf/done.md

@@ -0,0 +1,271 @@
+---
+name: sf:done
+description: Finalize specification, archive, and update state
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - AskUserQuestion
+---
+
+<purpose>
+Finalize the completed specification. Archives the spec, updates STATE.md, extracts decisions, and prepares for the next task.
+</purpose>
+
+<context>
+@.specflow/STATE.md
+@.specflow/PROJECT.md
+</context>
+
+<workflow>
+
+## Step 1: Verify Initialization
+
+```bash
+[ -d .specflow ] && echo "OK" || echo "NOT_INITIALIZED"
+```
+
+**If NOT_INITIALIZED:**
+```
+SpecFlow not initialized.
+
+Run `/sf init` first.
+```
+Exit.
+
+## Step 2: Get Active Specification
+
+Read `.specflow/STATE.md` and extract Active Specification.
+
+**If no active specification:**
+```
+No active specification to finalize.
+
+Run `/sf new "task description"` to create one.
+```
+Exit.
+
+## Step 3: Load Specification
+
+Read the active spec file: `.specflow/specs/SPEC-XXX.md`
+
+## Step 4: Check Review Status
+
+**If status is "done" (already approved):**
+Continue to finalization.
+
+**If status is "review" but has APPROVED review:**
+Continue to finalization.
+
+**If status is NOT approved:**
+Show warning:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ WARNING: Specification has not passed review
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Specification:** SPEC-XXX
+**Current Status:** {status}
+
+{If review exists with issues:}
+### Outstanding Issues
+
+From last review (v{N}):
+
+1. {Critical issue}
+2. {Major issue}
+
+---
+
+Proceeding without review approval may result in:
+- Incomplete or buggy implementation in production
+- Technical debt
+
+Continue anyway?
+```
+
+Use AskUserQuestion with options:
+- "Yes, finalize anyway" → continue, log warning
+- "No, run review first" → exit with `/sf review` suggestion
+
+**If user proceeds anyway:**
+Log in STATE.md Warnings table:
+```
+| {date} | SPEC-XXX | Finalized without review approval |
+```
+
+## Step 5: Create Archive Directory
+
+```bash
+mkdir -p .specflow/archive
+```
+
+## Step 6: Update Specification Status
+
+Update frontmatter:
+- status → "done"
+
+Add completion timestamp:
+
+```markdown
+---
+
+## Completion
+
+**Completed:** {date} {time}
+**Total Commits:** {count from Execution Summary}
+**Review Cycles:** {count of Review v[N] entries}
+```
+
+## Step 7: Extract Decisions
+
+Scan specification for important decisions:
+- Technology choices mentioned in Context or Assumptions
+- Patterns established during implementation
+- Constraints discovered
+
+If significant decisions found, add to STATE.md Decisions table:
+
+```markdown
+| {date} | SPEC-XXX | {decision description} |
+```
+
+## Step 8: Archive Specification
+
+Move spec to archive:
+
+```bash
+mv .specflow/specs/SPEC-XXX.md .specflow/archive/
+```
+
+## Step 9: Update STATE.md
+
+### Clear Active Specification
+
+- Active Specification → "none"
+- Status → "idle"
+- Next Step → "/sf new or /sf next"
+
+### Remove from Queue
+
+Remove SPEC-XXX row from Queue table.
+
+### Update Project Patterns (if applicable)
+
+If implementation established new patterns, add to Project Patterns section.
+
+## Step 10: Create Final Commit (if needed)
+
+Check for uncommitted changes:
+
+```bash
+git status --porcelain
+```
+
+If changes exist:
+
+```bash
+git add .specflow/
+git commit -m "docs(sf): complete SPEC-XXX
+
+- Archived specification
+- Updated STATE.md
+"
+```
+
+## Step 11: Display Completion Summary
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ SPECIFICATION COMPLETED
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Specification:** SPEC-XXX
+**Title:** {title}
+**Type:** {feature|refactor|bugfix}
+
+### Summary
+
+- **Files created:** {count}
+- **Files modified:** {count}
+- **Files deleted:** {count}
+- **Commits:** {count}
+- **Audit cycles:** {count}
+- **Review cycles:** {count}
+
+### Archived To
+
+`.specflow/archive/SPEC-XXX.md`
+
+{If decisions extracted:}
+### Decisions Recorded
+
+- {decision 1}
+- {decision 2}
+
+---
+
+## Queue Status
+
+{If queue has more specs:}
+**Next in queue:** SPEC-YYY — {title}
+
+Run `/sf next` to start the next specification.
+
+{If queue is empty:}
+Queue is empty.
+
+Run `/sf new "task"` to create a new specification
+or `/sf todos` to see pending ideas.
+```
+
+</workflow>
+
+<fallback>
+
+## Inline Finalization
+
+### Update Spec
+
+Set frontmatter status to "done".
+Add Completion section with timestamp.
+
+### Archive
+
+```bash
+mkdir -p .specflow/archive
+mv .specflow/specs/SPEC-XXX.md .specflow/archive/
+```
+
+### Update STATE.md
+
+1. Set Active Specification to "none"
+2. Set Status to "idle"
+3. Set Next Step to "/sf new or /sf next"
+4. Remove from Queue table
+5. Add any extracted decisions
+
+### Commit
+
+```bash
+git add .specflow/
+git commit -m "docs(sf): complete SPEC-XXX"
+```
+
+</fallback>
+
+<success_criteria>
+- [ ] Active specification identified
+- [ ] Review status checked (warning if not approved)
+- [ ] Spec status updated to "done"
+- [ ] Completion section added
+- [ ] Decisions extracted (if any)
+- [ ] Spec moved to archive
+- [ ] STATE.md updated (cleared active, removed from queue)
+- [ ] Final commit created
+- [ ] Clear completion summary shown
+- [ ] Next steps provided
+</success_criteria>