specflow-cc 1.0.0

package/commands/sf/todos.md

@@ -0,0 +1,133 @@
+---
+name: sf:todos
+description: List all to-do items sorted by priority
+allowed-tools:
+  - Read
+  - Bash
+---
+
+<purpose>
+Display all to-do items from the backlog, sorted by priority. Shows ID, description, priority, and creation date. Provides quick access to convert items to specifications.
+</purpose>
+
+<context>
+@.specflow/todos/TODO.md
+</context>
+
+<workflow>
+
+## Step 1: Verify Initialization
+
+```bash
+[ -d .specflow ] && echo "OK" || echo "NOT_INITIALIZED"
+```
+
+**If NOT_INITIALIZED:**
+```
+SpecFlow not initialized.
+
+Run `/sf init` to start.
+```
+Exit.
+
+## Step 2: Check for TODO.md
+
+```bash
+[ -f .specflow/todos/TODO.md ] && echo "EXISTS" || echo "NO_TODOS"
+```
+
+**If NO_TODOS:**
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ TO-DO LIST
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+No to-do items found.
+
+Add your first idea:
+`/sf todo "your idea here"`
+```
+Exit.
+
+## Step 3: Parse TODO.md
+
+Read `.specflow/todos/TODO.md` and extract each todo block:
+- ID (TODO-XXX)
+- Date (from header)
+- Description
+- Priority (high | medium | low | —)
+- Notes (optional)
+
+Look for pattern:
+```
+## TODO-XXX — YYYY-MM-DD
+**Description:** ...
+**Priority:** ...
+**Notes:** ...
+```
+
+## Step 4: Sort by Priority
+
+Sort todos:
+1. high
+2. medium
+3. low
+4. — (unset)
+
+Within same priority, sort by date (oldest first).
+
+## Step 5: Count Statistics
+
+- Total todos
+- By priority (high, medium, low, unset)
+
+## Step 6: Display List
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ TO-DO LIST
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+| #  | ID       | Description              | Priority | Created    |
+|----|----------|--------------------------|----------|------------|
+| 1  | TODO-001 | Add caching for API      | high     | 2024-01-10 |
+| 2  | TODO-003 | Refactor AuthService     | medium   | 2024-01-12 |
+| 3  | TODO-002 | Update documentation     | low      | 2024-01-11 |
+| 4  | TODO-004 | Research WebSocket       | —        | 2024-01-13 |
+
+**Total:** {N} items ({high} high, {medium} medium, {low} low, {unset} unset)
+
+---
+
+**Actions:**
+- `/sf plan 1` — convert first item to specification
+- `/sf plan TODO-001` — convert by ID
+- `/sf priority` — change priorities
+- `/sf todo "new idea"` — add new item
+```
+
+## Step 7: Show Notes (if any have notes)
+
+If any todo has non-empty notes:
+
+```
+---
+
+**Notes:**
+
+**TODO-001:** Consider Redis or in-memory
+**TODO-003:** Split into smaller services first
+```
+
+</workflow>
+
+<success_criteria>
+- [ ] Initialization verified
+- [ ] TODO.md parsed if exists
+- [ ] All todos extracted with ID, description, priority, date
+- [ ] Sorted by priority then date
+- [ ] Numbered list displayed (# column for easy reference)
+- [ ] Statistics shown
+- [ ] Clear actions provided
+- [ ] Notes shown if present
+</success_criteria>

package/hooks/statusline.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+// Claude Code Statusline - SpecFlow Edition
+// Shows: model | spec status | directory | context usage
+
+const fs = require('fs');
+const path = require('path');
+
+// Read JSON from stdin (Claude Code protocol)
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', chunk => input += chunk);
+process.stdin.on('end', () => {
+  try {
+    const data = JSON.parse(input);
+    const model = data.model?.display_name || 'Claude';
+    const dir = data.workspace?.current_dir || process.cwd();
+    const remaining = data.context_window?.remaining_percentage;
+
+    // Context window display (shows USED percentage)
+    let ctx = '';
+    if (remaining != null) {
+      const rem = Math.round(remaining);
+      const used = Math.max(0, Math.min(100, 100 - rem));
+
+      // Build progress bar (10 segments)
+      const filled = Math.floor(used / 10);
+      const bar = '█'.repeat(filled) + '░'.repeat(10 - filled);
+
+      // Color based on usage
+      if (used < 50) {
+        ctx = ` \x1b[32m${bar} ${used}%\x1b[0m`;
+      } else if (used < 65) {
+        ctx = ` \x1b[33m${bar} ${used}%\x1b[0m`;
+      } else if (used < 80) {
+        ctx = ` \x1b[38;5;208m${bar} ${used}%\x1b[0m`;
+      } else {
+        ctx = ` \x1b[5;31m💀 ${bar} ${used}%\x1b[0m`;
+      }
+    }
+
+    // SpecFlow status from STATE.md
+    let sfStatus = '';
+    const stateFile = path.join(dir, '.specflow', 'STATE.md');
+    if (fs.existsSync(stateFile)) {
+      try {
+        const content = fs.readFileSync(stateFile, 'utf8');
+        const specMatch = content.match(/\*\*Active Specification:\*\*\s*(\S+)/);
+        const statusMatch = content.match(/\*\*Status:\*\*\s*(\S+)/);
+
+        const spec = specMatch ? specMatch[1] : null;
+        const status = statusMatch ? statusMatch[1] : null;
+
+        if (spec && spec !== '—' && spec !== 'none') {
+          sfStatus = `\x1b[36m[SF: ${spec}`;
+          if (status) {
+            sfStatus += ` ${status}`;
+          }
+          sfStatus += ']\x1b[0m │ ';
+        }
+      } catch (e) {}
+    }
+
+    // Output
+    const dirname = path.basename(dir);
+    process.stdout.write(`${sfStatus}\x1b[2m${model}\x1b[0m │ \x1b[2m${dirname}\x1b[0m${ctx}`);
+  } catch (e) {
+    // Silent fail - don't break statusline on parse errors
+  }
+});

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "specflow-cc",
+  "version": "1.0.0",
+  "description": "Spec-driven development system for Claude Code — quality-first workflow with explicit audit cycles",
+  "bin": {
+    "specflow-cc": "bin/install.js"
+  },
+  "files": [
+    "bin",
+    "commands",
+    "agents",
+    "templates",
+    "hooks",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "spec-driven",
+    "development",
+    "audit"
+  ],
+  "author": "ivkan",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ivkan/specflow-cc.git"
+  },
+  "homepage": "https://github.com/ivkan/specflow-cc",
+  "bugs": {
+    "url": "https://github.com/ivkan/specflow-cc/issues"
+  },
+  "engines": {
+    "node": ">=16.7.0"
+  }
+}

package/templates/audit.md

@@ -0,0 +1,61 @@
+---
+spec_id: SPEC-XXX
+audit_version: v1
+auditor: fresh-context
+date: YYYY-MM-DD
+verdict: pass | fail | conditional
+---
+
+# Audit Report: SPEC-XXX
+
+## Summary
+
+[One-line summary of the audit outcome]
+
+## Specification Analysis
+
+### Clarity
+- [ ] Task description is unambiguous
+- [ ] Requirements are specific and measurable
+- [ ] Acceptance criteria are testable
+
+### Completeness
+- [ ] All necessary files listed
+- [ ] Interfaces/types defined where needed
+- [ ] Edge cases considered
+
+### Feasibility
+- [ ] Complexity estimate is reasonable
+- [ ] No conflicting requirements
+- [ ] Dependencies are identified
+
+## Issues Found
+
+### Critical (blocks implementation)
+
+<!-- Issues that must be resolved before implementation -->
+
+1. **[Issue Title]**
+   - Location: [section/line]
+   - Problem: [description]
+   - Suggestion: [how to fix]
+
+### Major (should fix)
+
+<!-- Issues that significantly affect implementation quality -->
+
+### Minor (nice to fix)
+
+<!-- Small improvements, clarifications -->
+
+## Verdict
+
+**[PASS | FAIL | CONDITIONAL]**
+
+[Explanation of the verdict and any conditions for proceeding]
+
+---
+
+## Response History
+
+<!-- Filled by /sf revise -->

package/templates/project.md

@@ -0,0 +1,39 @@
+# PROJECT.md Template
+
+## What This Is
+
+[One sentence describing what this project is]
+
+## Core Value
+
+[The ONE thing that must work for this project to be valuable]
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|------------|
+| Language | [e.g., TypeScript] |
+| Framework | [e.g., Next.js] |
+| Database | [e.g., PostgreSQL] |
+| ORM | [e.g., Prisma] |
+| Styling | [e.g., Tailwind CSS] |
+
+## Project Structure
+
+```
+[Directory tree showing main folders]
+```
+
+## Patterns & Conventions
+
+- [Pattern 1: e.g., API routes in /app/api/]
+- [Pattern 2: e.g., Components in PascalCase]
+- [Pattern 3]
+
+## Constraints
+
+- [Constraint 1: e.g., Must work offline]
+- [Constraint 2]
+
+---
+*Generated by SpecFlow on [date]*

package/templates/spec.md

@@ -0,0 +1,59 @@
+---
+id: SPEC-XXX
+type: feature | refactor | bugfix
+status: draft | audited | running | review | done
+priority: high | medium | low
+complexity: small | medium | large
+created: YYYY-MM-DD
+---
+
+# [Task Title]
+
+## Context
+
+[Why this is needed — background, motivation, problem being solved]
+
+## Task
+
+[What needs to be done — clear description of the work]
+
+## Requirements
+
+### Interfaces (if applicable)
+
+```typescript
+// Type definitions, API contracts, etc.
+```
+
+### Files to Create/Modify
+
+- [ ] `path/to/file.ext` — [what to do]
+- [ ] `path/to/another.ext` — [what to do]
+
+### Files to Delete
+
+- [ ] `path/to/old.ext` — [reason for deletion]
+
+## Acceptance Criteria
+
+- [ ] [Criterion 1 — specific, measurable]
+- [ ] [Criterion 2 — specific, measurable]
+- [ ] [Criterion 3 — specific, measurable]
+
+## Constraints
+
+- [What NOT to do]
+- [Boundaries and limitations]
+
+## Assumptions
+
+> Filled by spec-creator agent. Review and correct if needed.
+
+- [Assumption 1]
+- [Assumption 2]
+
+---
+
+## Audit History
+
+<!-- Filled by /sf audit -->

package/templates/state.md

@@ -0,0 +1,32 @@
+# STATE.md Template
+
+## Current Position
+
+- **Active Specification:** [none | SPEC-XXX]
+- **Status:** [idle | drafting | auditing | running | reviewing]
+- **Next Step:** [/sf new | /sf audit | /sf run | /sf review | /sf done]
+
+## Queue
+
+| # | ID | Title | Priority | Status |
+|---|----|-------|----------|--------|
+| — | — | — | — | — |
+
+## Decisions
+
+| Date | Specification | Decision |
+|------|---------------|----------|
+| — | — | — |
+
+## Project Patterns
+
+- [Patterns discovered during work]
+
+## Warnings
+
+| Date | Specification | Reason |
+|------|---------------|--------|
+| — | — | — |
+
+---
+*Last updated: [date]*

package/templates/todo.md

@@ -0,0 +1,15 @@
+# To-Do List
+
+<!--
+  Format for each todo:
+
+  ## TODO-XXX — YYYY-MM-DD
+  **Description:** Short description
+  **Priority:** high | medium | low | —
+  **Notes:** Optional notes
+
+  ---
+-->
+
+---
+*Last updated: [date]*