@hustle-together/api-dev-tools 3.6.1 → 3.6.3

package/README.md

@@ -1,4 +1,4 @@
-# API Development Tools for Claude Code v3.6.1
+# API Development Tools for Claude Code v3.6.3
 
 **Interview-driven, research-first API development with 100% phase enforcement**
 
@@ -7,7 +7,7 @@
 │ ❯ npx @hustle-together/api-dev-tools         │
 │         --scope=project                      │
 │                                              │
-│ 🚀 Installing v3.6.1...                      │
+│ 🚀 Installing v3.6.3...                      │
 │                                              │
 │ ✅ Python 3.12.0                             │
 │ 📦 24 slash commands                         │
@@ -17,9 +17,9 @@
 │ 📚 research cache ready                      │
 │ 🔌 MCP: context7, github                     │
 │                                              │
-│ ═════════════════════════════════════        │
+│ ════════════════════════════════════════════ │
 │ 🎉 Installation complete!                    │
-│ ═════════════════════════════════════        │
+│ ════════════════════════════════════════════ │
 │                                              │
 │ Quick Start: /api-create my-endpoint         │
 └──────────────────────────────────────────────┘
@@ -49,7 +49,7 @@ When developers use Claude (or any LLM) to build APIs, five predictable failure
 
 ### Our Solution
 
-**A 12-phase workflow enforced by Python hooks that BLOCK progress** until each phase is complete with explicit user approval. Not suggestions. Not guidelines. **Hard stops using Exit Code 2.**
+**A 13-phase workflow enforced by Python hooks that BLOCK progress** until each phase is complete with explicit user approval. Not suggestions. Not guidelines. **Hard stops using Exit Code 2.**
 
 This means:
 - Claude cannot skip research
@@ -62,9 +62,9 @@ Every decision is tracked. Every phase is verified. Every step is enforced.
 
 ---
 
-## The 12-Phase Workflow
+## The 13-Phase Workflow
 
-When you run `/api-create brandfetch`, Claude is guided through 12 enforced phases. Each phase has three components:
+When you run `/api-create brandfetch`, Claude is guided through 13 enforced phases. Each phase has three components:
 
 1. **The Problem** - What goes wrong without enforcement
 2. **The Solution** - How the phase prevents the problem
@@ -1582,13 +1582,13 @@ Research shows context dilution accelerates after 7-10 messages. Re-grounding ev
 ## File Structure
 
 ```
-@hustle-together/api-dev-tools v3.6.1
+@hustle-together/api-dev-tools v3.6.3
 │
 ├── bin/
 │   └── cli.js                         # NPX installer
 │
 ├── commands/                          # 24 slash commands
-│   ├── api-create.md                  # Main 12-phase workflow
+│   ├── api-create.md                  # Main 13-phase workflow
 │   ├── api-interview.md               # Structured interview
 │   ├── api-research.md                # Adaptive research
 │   ├── api-verify.md                  # Manual verification
@@ -1644,7 +1644,7 @@ Research shows context dilution accelerates after 7-10 messages. Re-grounding ev
 │   └── api-workflow-check.py          # Phase 12 (block if incomplete)
 │
 ├── templates/
-│   ├── api-dev-state.json             # 12 phases + phase_exit_confirmed
+│   ├── api-dev-state.json             # 13 phases + phase_exit_confirmed
 │   ├── settings.json                  # Hook registrations
 │   ├── research-index.json            # 7-day freshness tracking
 │   └── CLAUDE-SECTION.md              # CLAUDE.md injection
@@ -1804,11 +1804,18 @@ npx @hustle-together/api-dev-tools --scope=project
 
 ---
 
+## What's New in v3.6.3
+
+### Phase Numbering Fix
+- Fixed inconsistency: "12-phase workflow" → "13-phase workflow"
+- Added missing Phase 12 (Completion) to state file template
+- Phases are now numbered 0-12 (13 total), not 0-11
+
 ## What's New in v3.6.1
 
 ### README Improvements
 - Removed verbose ASCII workflow simulations (was 798 lines)
-- Added comprehensive explanations for all 12 phases
+- Added comprehensive explanations for all 13 phases
 - Detailed sections on Exit Code 2, Context7, phase_exit_confirmed
 - Better mobile/narrow display formatting (50-char width ASCII)
 - Collapsible sections for easier scanning

package/bin/cli.js

@@ -482,7 +482,7 @@ function main() {
   log('   Test UI:   /api-test page + /api/test-structure API (if Next.js)', 'blue');
 
   log('\n🆕 New in v3.0:', 'bright');
-  log('   • 12 phases, each with mandatory user checkpoint', 'cyan');
+  log('   • 13 phases, each with mandatory user checkpoint', 'cyan');
   log('   • AskUserQuestion required at EVERY phase transition', 'cyan');
   log('   • Loop-back support when user wants changes', 'cyan');
   log('   • Adaptive research (propose-approve, not shotgun)', 'cyan');
@@ -502,12 +502,12 @@ function main() {
   log('   • Phase 11: "Documentation complete?" (final checklist)', 'cyan');
 
   log('\n📚 Available Commands:', 'bright');
-  log('  /api-create [endpoint]    - Complete 12-phase workflow', 'blue');
+  log('  /api-create [endpoint]    - Complete 13-phase workflow', 'blue');
   log('  /api-interview [endpoint] - Questions FROM research', 'blue');
   log('  /api-research [library]   - Adaptive propose-approve research', 'blue');
   log('  /api-verify [endpoint]    - Manual Phase 9 verification', 'blue');
   log('  /api-env [endpoint]       - Check API keys and environment', 'blue');
-  log('  /api-status [endpoint]    - Track 12-phase progress', 'blue');
+  log('  /api-status [endpoint]    - Track 13-phase progress', 'blue');
 
   log('\n🚀 Quick Start:', 'bright');
   log('   /api-create my-endpoint', 'blue');

package/commands/README.md

@@ -30,7 +30,7 @@
 ### Complete Workflow
 
 **`/api-create [endpoint-name]`**
-- Runs all 12 phases automatically
+- Runs all 13 phases automatically
 - Loop-back architecture at every checkpoint
 - See [api-create.md](api-create.md) for full flow
 
@@ -57,7 +57,7 @@
 - See [api-env.md](api-env.md)
 
 **`/api-status [endpoint-name]`**
-- Track progress through 12 phases
+- Track progress through 13 phases
 - See [api-status.md](api-status.md)
 
 ### TDD Commands
@@ -68,7 +68,7 @@ From [@wbern/claude-instructions](https://github.com/wbern/claude-instructions):
 - `/refactor` - Clean up while tests pass
 - `/cycle [description]` - Full Red → Green → Refactor
 
-## 12-Phase Flow
+## 13-Phase Flow
 
 ```
 Phase 0:  DISAMBIGUATION     - Clarify ambiguous terms

package/demo/workflow-demo.html

@@ -1117,7 +1117,7 @@
     }
 
     /* ============================================
-       SECTION 5: THE 12 PHASES
+       SECTION 5: THE 13 PHASES
        ============================================ */
     #phases .section-header {
       text-align: center;
@@ -3036,11 +3036,11 @@ Required actions:
     </div>
   </section>
 
-  <!-- Section 5: The 12 Phases -->
+  <!-- Section 5: The 13 Phases -->
   <section id="phases">
     <div class="section-inner">
       <div class="section-header">
-        <h2>The 12 Phases</h2>
+        <h2>The 13 Phases</h2>
         <p class="text-muted">Each phase must complete before proceeding. Click EXPAND for details.</p>
       </div>
 
@@ -3560,7 +3560,7 @@ Required actions:
               <div class="terminal-title">~/project</div>
               <pre><span class="prompt">Final check...</span>
 
-<span class="success"><i class="fa-solid fa-check"></i></span> <span class="output">All 12 phases complete</span>
+<span class="success"><i class="fa-solid fa-check"></i></span> <span class="output">All 13 phases complete</span>
 <span class="success"><i class="fa-solid fa-check"></i></span> <span class="output">Tests passing</span>
 <span class="success"><i class="fa-solid fa-check"></i></span> <span class="output">Docs updated</span>
 <span class="success"><i class="fa-solid fa-check"></i></span> <span class="output">Research cached</span>
@@ -3598,7 +3598,7 @@ Required actions:
     <div class="section-inner">
       <div class="section-header">
         <h2>See It In Action</h2>
-        <p class="text-muted">Watch the complete 12-phase workflow: /api-create brandfetch</p>
+        <p class="text-muted">Watch the complete 13-phase workflow: /api-create brandfetch</p>
       </div>
 
       <div class="demo-controls-bar">
@@ -3767,7 +3767,7 @@ Required actions:
         <div class="state-explanation">
           <div class="state-field">
             <h4><i class="fa-solid fa-database"></i> phases.*</h4>
-            <p>Tracks completion status for all 12 phases. Hooks check this before allowing operations.</p>
+            <p>Tracks completion status for all 13 phases. Hooks check this before allowing operations.</p>
           </div>
 
           <div class="state-field">
@@ -4169,7 +4169,7 @@ Required actions:
     }
 
     // ============================================
-    // TERMINAL DEMO - Scene-based system (All 12 phases)
+    // TERMINAL DEMO - Scene-based system (All 13 phases)
     // ============================================
 
     const demoScenes = [
@@ -4513,7 +4513,7 @@ Required actions:
         phase: 12,
         title: 'Phase 12: Completion',
         problem: 'How do you know everything is actually done? Claude might claim finished but skip steps.',
-        solution: 'The api-workflow-check hook runs at stop time. Verifies all 12 phases completed. All files created, tests passing, docs updated.',
+        solution: 'The api-workflow-check hook runs at stop time. Verifies all 13 phases completed. All files created, tests passing, docs updated.',
         hook: 'api-workflow-check.py (Stop)',
         lines: [
           { text: '', class: 'output' },
@@ -4521,7 +4521,7 @@ Required actions:
           { text: '║  PHASE 12: COMPLETION                                         ║', class: 'highlight' },
           { text: '╚══════════════════════════════════════════════════════════════╝', class: 'highlight' },
           { text: '', class: 'output' },
-          { text: '→ api-workflow-check.py verifying all 12 phases...', class: 'mcp-call' },
+          { text: '→ api-workflow-check.py verifying all 13 phases...', class: 'mcp-call' },
           { text: '', class: 'output' },
           { text: '  ✓ disambiguation: complete', class: 'success' },
           { text: '  ✓ scope: complete', class: 'success' },
@@ -4539,7 +4539,7 @@ Required actions:
           { text: 'Files created: route.ts, brandfetch.test.ts, schema.ts', class: 'output' },
           { text: '', class: 'output' },
           { text: '════════════════════════════════════════════════════════════════', class: 'success' },
-          { text: '  ✓ WORKFLOW COMPLETE - All 12 phases verified                  ', class: 'success' },
+          { text: '  ✓ WORKFLOW COMPLETE - All 13 phases verified                  ', class: 'success' },
           { text: '════════════════════════════════════════════════════════════════', class: 'success' }
         ]
       }
@@ -5411,7 +5411,7 @@ Required actions:
             solution: 'Six fixes with Python hooks...',
             grounding: 'Research grounding...',
             hooks: 'Workflow enforcement...',
-            phases: 'The 12 phases...',
+            phases: 'The 13 phases...',
             demo: 'See it in action...',
             state: 'Persistent memory...',
             install: 'Get started...'
@@ -5659,7 +5659,7 @@ Required actions:
           solution: 'Solution',
           grounding: 'Research',
           hooks: 'Workflow',
-          phases: '12 Phases',
+          phases: '13 Phases',
           demo: 'Demo',
           state: 'Memory',
           install: 'Install'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hustle-together/api-dev-tools",
-  "version": "3.6.1",
+  "version": "3.6.3",
   "description": "Interview-driven, research-first API development workflow with continuous verification loops for Claude Code",
   "main": "bin/cli.js",
   "bin": {

package/templates/CLAUDE-SECTION.md

@@ -6,14 +6,14 @@ This project uses **@hustle-together/api-dev-tools** for interview-driven, resea
 
 | Command | Purpose |
 |---------|---------|
-| `/api-create [endpoint]` | Complete 12-phase workflow |
+| `/api-create [endpoint]` | Complete 13-phase workflow |
 | `/api-interview [endpoint]` | Questions FROM research findings |
 | `/api-research [library]` | Adaptive propose-approve research |
 | `/api-verify [endpoint]` | Re-research and verify implementation |
 | `/api-env [endpoint]` | Check API keys |
 | `/api-status [endpoint]` | Track progress |
 
-### 12-Phase Flow
+### 13-Phase Flow
 
 ```
 Phase 0:  DISAMBIGUATION     - Clarify ambiguous terms before research

package/templates/api-dev-state.json

@@ -140,6 +140,19 @@
       "phase_exit_confirmed": false,
       "last_question_type": null,
       "description": "Update manifests, OpenAPI, cache research"
+    },
+    "completion": {
+      "status": "not_started",
+      "all_tests_passing": false,
+      "coverage_100_percent": false,
+      "typescript_compiles": false,
+      "docs_updated": false,
+      "commit_ready": false,
+      "files_created": [],
+      "files_modified": [],
+      "phase_exit_confirmed": false,
+      "last_question_type": null,
+      "description": "Final verification - all tests pass, docs complete, ready for commit"
     }
   },
   "manifest_generation": {