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

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.0",
+  "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": {