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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (22) hide show
  1. package/README.md +66 -59
  2. package/bin/cli.js +14 -14
  3. package/commands/README.md +20 -20
  4. package/commands/api-create.md +7 -7
  5. package/commands/api-interview.md +5 -5
  6. package/commands/api-research.md +7 -7
  7. package/commands/api-verify.md +8 -8
  8. package/demo/workflow-demo.html +53 -53
  9. package/hooks/enforce-deep-research.py +2 -2
  10. package/hooks/enforce-disambiguation.py +3 -3
  11. package/hooks/enforce-documentation.py +2 -2
  12. package/hooks/enforce-environment.py +2 -2
  13. package/hooks/enforce-refactor.py +3 -3
  14. package/hooks/enforce-research.py +2 -2
  15. package/hooks/enforce-schema.py +3 -3
  16. package/hooks/enforce-scope.py +2 -2
  17. package/hooks/enforce-tdd-red.py +2 -2
  18. package/hooks/enforce-verify.py +5 -5
  19. package/hooks/verify-after-green.py +2 -2
  20. package/package.json +1 -1
  21. package/templates/CLAUDE-SECTION.md +15 -15
  22. package/templates/api-dev-state.json +13 -0
package/hooks/verify-after-green.py CHANGED
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env python3
2
2
  """
3
3
  Hook: PostToolUse (after test runs)
4
- Purpose: Trigger Phase 9 (Verify) + Manifest Generation after tests pass
4
+ Purpose: Trigger Phase 10 (Verify) + Manifest Generation after tests pass
5
5
 
6
6
  This hook detects when tests pass (TDD Green phase complete) and:
7
7
  1. Runs the programmatic manifest generation scripts
@@ -243,7 +243,7 @@ def main():
243
243
  context_parts.append("---")
244
244
  context_parts.append("")
245
245
 
246
- context_parts.append("## Phase 9: Implementation Verification Required")
246
+ context_parts.append("## Phase 10: Implementation Verification Required")
247
247
  context_parts.append("")
248
248
  context_parts.append("Tests are passing. Before proceeding, you MUST verify your implementation:")
249
249
  context_parts.append("")
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hustle-together/api-dev-tools",
3
- "version": "3.6.1",
3
+ "version": "3.6.4",
4
4
  "description": "Interview-driven, research-first API development workflow with continuous verification loops for Claude Code",
5
5
  "main": "bin/cli.js",
6
6
  "bin": {
package/templates/CLAUDE-SECTION.md CHANGED
@@ -6,29 +6,29 @@ This project uses **@hustle-together/api-dev-tools** for interview-driven, resea
6
6
 
7
7
  | Command | Purpose |
8
8
  |---------|---------|
9
- | `/api-create [endpoint]` | Complete 12-phase workflow |
9
+ | `/api-create [endpoint]` | Complete 13-phase workflow |
10
10
  | `/api-interview [endpoint]` | Questions FROM research findings |
11
11
  | `/api-research [library]` | Adaptive propose-approve research |
12
12
  | `/api-verify [endpoint]` | Re-research and verify implementation |
13
13
  | `/api-env [endpoint]` | Check API keys |
14
14
  | `/api-status [endpoint]` | Track progress |
15
15
 
16
- ### 12-Phase Flow
16
+ ### 13-Phase Flow
17
17
 
18
18
  ```
19
- Phase 0: DISAMBIGUATION - Clarify ambiguous terms before research
20
- Phase 1: SCOPE - Confirm understanding of endpoint
21
- Phase 2: INITIAL RESEARCH - 2-3 targeted searches (Context7, WebSearch)
22
- Phase 3: INTERVIEW - Questions generated FROM discovered params
23
- Phase 4: DEEP RESEARCH - Propose additional searches based on answers
24
- Phase 5: SCHEMA - Create Zod schema from research + interview
25
- Phase 6: ENVIRONMENT - Verify API keys exist
26
- Phase 7: TDD RED - Write failing tests from schema
27
- Phase 8: TDD GREEN - Minimal implementation to pass tests
28
- Phase 9: VERIFY - Re-research docs, compare to implementation
29
- Phase 10: TDD REFACTOR - Clean up code while tests pass
30
- Phase 11: DOCUMENTATION - Update manifests, cache research
31
- Phase 12: COMPLETION - Final verification, commit
19
+ Phase 1: DISAMBIGUATION - Clarify ambiguous terms before research
20
+ Phase 2: SCOPE - Confirm understanding of endpoint
21
+ Phase 3: INITIAL RESEARCH - 2-3 targeted searches (Context7, WebSearch)
22
+ Phase 4: INTERVIEW - Questions generated FROM discovered params
23
+ Phase 5: DEEP RESEARCH - Propose additional searches based on answers
24
+ Phase 6: SCHEMA - Create Zod schema from research + interview
25
+ Phase 7: ENVIRONMENT - Verify API keys exist
26
+ Phase 8: TDD RED - Write failing tests from schema
27
+ Phase 9: TDD GREEN - Minimal implementation to pass tests
28
+ Phase 10: VERIFY - Re-research docs, compare to implementation
29
+ Phase 11: TDD REFACTOR - Clean up code while tests pass
30
+ Phase 12: DOCUMENTATION - Update manifests, cache research
31
+ Phase 13: COMPLETION - Final verification, commit
32
32
  ```
33
33
 
34
34
  ### Key Principles
package/templates/api-dev-state.json CHANGED
@@ -140,6 +140,19 @@
140
140
  "phase_exit_confirmed": false,
141
141
  "last_question_type": null,
142
142
  "description": "Update manifests, OpenAPI, cache research"
143
+ },
144
+ "completion": {
145
+ "status": "not_started",
146
+ "all_tests_passing": false,
147
+ "coverage_100_percent": false,
148
+ "typescript_compiles": false,
149
+ "docs_updated": false,
150
+ "commit_ready": false,
151
+ "files_created": [],
152
+ "files_modified": [],
153
+ "phase_exit_confirmed": false,
154
+ "last_question_type": null,
155
+ "description": "Final verification - all tests pass, docs complete, ready for commit"
143
156
  }
144
157
  },
145
158
  "manifest_generation": {