@hustle-together/api-dev-tools 3.11.1 → 3.12.1

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 (139) hide show
  1. package/.claude/agents/code-reviewer.md +170 -0
  2. package/.claude/agents/docs-generator.md +80 -0
  3. package/.claude/agents/implementation-reviewer.md +119 -0
  4. package/.claude/agents/parallel-researcher.md +52 -0
  5. package/.claude/agents/research-validator.md +116 -0
  6. package/.claude/agents/schema-generator.md +70 -0
  7. package/.claude/agents/test-writer.md +104 -0
  8. package/.claude/api-dev-state.json +228 -56
  9. package/.claude/commands/README.md +21 -10
  10. package/.claude/commands/add-command.md +8 -5
  11. package/.claude/commands/api-create.md +36 -25
  12. package/.claude/commands/api-env.md +1 -0
  13. package/.claude/commands/api-interview.md +32 -19
  14. package/.claude/commands/api-research.md +47 -21
  15. package/.claude/commands/api-status.md +21 -1
  16. package/.claude/commands/api-verify.md +14 -13
  17. package/.claude/commands/beepboop.md +4 -5
  18. package/.claude/commands/busycommit.md +2 -3
  19. package/.claude/commands/commit.md +2 -3
  20. package/.claude/commands/cycle.md +2 -7
  21. package/.claude/commands/gap.md +2 -3
  22. package/.claude/commands/green.md +2 -7
  23. package/.claude/commands/issue.md +3 -8
  24. package/.claude/commands/ntfy-setup.md +91 -0
  25. package/.claude/commands/ntfy-test.md +74 -0
  26. package/.claude/commands/plan.md +2 -3
  27. package/.claude/commands/pr.md +2 -3
  28. package/.claude/commands/publish.md +40 -0
  29. package/.claude/commands/red.md +2 -7
  30. package/.claude/commands/refactor.md +2 -7
  31. package/.claude/commands/spike.md +2 -7
  32. package/.claude/commands/summarize.md +2 -3
  33. package/.claude/commands/tdd.md +2 -7
  34. package/.claude/commands/worktree-add.md +208 -216
  35. package/.claude/commands/worktree-cleanup.md +172 -178
  36. package/.claude/settings.json +63 -12
  37. package/.claude/settings.local.json +2 -1
  38. package/.claude-plugin/marketplace.json +2 -11
  39. package/.skills/README.md +55 -53
  40. package/.skills/_shared/settings.json +1 -1
  41. package/.skills/add-command/SKILL.md +10 -5
  42. package/.skills/api-create/SKILL.md +146 -35
  43. package/.skills/api-env/SKILL.md +1 -0
  44. package/.skills/api-interview/SKILL.md +32 -19
  45. package/.skills/api-research/SKILL.md +47 -21
  46. package/.skills/api-status/SKILL.md +21 -1
  47. package/.skills/api-verify/SKILL.md +14 -13
  48. package/.skills/beepboop/SKILL.md +6 -5
  49. package/.skills/busycommit/SKILL.md +4 -3
  50. package/.skills/commit/SKILL.md +4 -3
  51. package/.skills/cycle/SKILL.md +4 -7
  52. package/.skills/gap/SKILL.md +4 -3
  53. package/.skills/green/SKILL.md +4 -7
  54. package/.skills/issue/SKILL.md +5 -8
  55. package/.skills/plan/SKILL.md +4 -3
  56. package/.skills/pr/SKILL.md +4 -3
  57. package/.skills/publish/SKILL.md +160 -0
  58. package/.skills/red/SKILL.md +4 -7
  59. package/.skills/refactor/SKILL.md +4 -7
  60. package/.skills/spike/SKILL.md +4 -7
  61. package/.skills/summarize/SKILL.md +4 -3
  62. package/.skills/tdd/SKILL.md +4 -7
  63. package/.skills/update-todos/SKILL.md +22 -0
  64. package/.skills/worktree-add/SKILL.md +210 -216
  65. package/.skills/worktree-cleanup/SKILL.md +183 -187
  66. package/CHANGELOG.md +97 -79
  67. package/README.md +161 -7142
  68. package/bin/cli.js +448 -805
  69. package/commands/README.md +66 -31
  70. package/commands/add-command.md +8 -5
  71. package/commands/beepboop.md +4 -5
  72. package/commands/busycommit.md +2 -3
  73. package/commands/commit.md +2 -3
  74. package/commands/cycle.md +2 -7
  75. package/commands/gap.md +2 -3
  76. package/commands/green.md +2 -7
  77. package/commands/hustle-api-continue.md +8 -5
  78. package/commands/hustle-api-create.md +70 -29
  79. package/commands/hustle-api-env.md +1 -0
  80. package/commands/hustle-api-interview.md +32 -19
  81. package/commands/hustle-api-research.md +47 -21
  82. package/commands/hustle-api-sessions.md +8 -7
  83. package/commands/hustle-api-status.md +21 -1
  84. package/commands/hustle-api-verify.md +14 -13
  85. package/commands/hustle-combine.md +488 -241
  86. package/commands/hustle-ui-create-page.md +113 -50
  87. package/commands/hustle-ui-create.md +179 -26
  88. package/commands/issue.md +3 -8
  89. package/commands/plan.md +2 -3
  90. package/commands/pr.md +2 -3
  91. package/commands/red.md +2 -7
  92. package/commands/refactor.md +2 -7
  93. package/commands/spike.md +2 -7
  94. package/commands/summarize.md +2 -3
  95. package/commands/tdd.md +2 -7
  96. package/commands/worktree-add.md +208 -216
  97. package/commands/worktree-cleanup.md +172 -178
  98. package/hooks/api-workflow-check.py +5 -3
  99. package/hooks/enforce-component-type-confirm.py +97 -0
  100. package/hooks/lib/__init__.py +1 -0
  101. package/hooks/lib/greptile.py +355 -0
  102. package/hooks/lib/ntfy.py +209 -0
  103. package/hooks/notify-input-needed.py +73 -0
  104. package/hooks/notify-phase-complete.py +90 -0
  105. package/hooks/run-code-review.py +246 -0
  106. package/hooks/track-token-usage.py +121 -0
  107. package/package.json +13 -3
  108. package/scripts/collect-test-results.ts +102 -77
  109. package/scripts/extract-parameters.ts +112 -70
  110. package/scripts/generate-test-manifest.ts +118 -77
  111. package/templates/.env.example +57 -0
  112. package/templates/BRAND_GUIDE.md +92 -52
  113. package/templates/CLAUDE-SECTION.md +40 -37
  114. package/templates/SPEC.json +186 -38
  115. package/templates/api-dev-state.json +33 -4
  116. package/templates/api-showcase/_components/APICard.tsx +22 -18
  117. package/templates/api-showcase/_components/APIModal.tsx +110 -64
  118. package/templates/api-showcase/_components/APIShowcase.tsx +53 -35
  119. package/templates/api-showcase/_components/APITester.tsx +128 -67
  120. package/templates/api-showcase/page.tsx +4 -4
  121. package/templates/api-test/page.tsx +51 -30
  122. package/templates/api-test/test-structure/route.ts +43 -34
  123. package/templates/component/Component.stories.tsx +41 -39
  124. package/templates/component/Component.test.tsx +96 -78
  125. package/templates/component/Component.tsx +63 -52
  126. package/templates/component/Component.types.ts +10 -6
  127. package/templates/component/Component.visual.spec.ts +170 -0
  128. package/templates/component/index.ts +2 -2
  129. package/templates/dev-tools/_components/DevToolsLanding.tsx +8 -8
  130. package/templates/dev-tools/page.tsx +4 -3
  131. package/templates/mcp-servers.json +30 -2
  132. package/templates/page/page.e2e.test.ts +56 -48
  133. package/templates/page/page.tsx +3 -3
  134. package/templates/shared/HeroHeader.tsx +16 -15
  135. package/templates/shared/index.ts +1 -1
  136. package/templates/ui-showcase/_components/PreviewCard.tsx +20 -20
  137. package/templates/ui-showcase/_components/PreviewModal.tsx +149 -108
  138. package/templates/ui-showcase/_components/UIShowcase.tsx +43 -35
  139. package/templates/ui-showcase/page.tsx +4 -4
@@ -18,6 +18,7 @@ Path: .claude/api-dev-state.json
18
18
  ```
19
19
 
20
20
  Parse the JSON and display a formatted status report showing:
21
+
21
22
  - Current endpoint being worked on
22
23
  - Phase completion status (scope, research, interview, TDD, docs)
23
24
  - Sources consulted during research
@@ -60,6 +61,7 @@ VERIFICATION:
60
61
  ## What This Shows
61
62
 
62
63
  ### For Specific Endpoint
64
+
63
65
  ```
64
66
  📊 Status: /api/v2/generate-css
65
67
 
@@ -87,6 +89,7 @@ Next Steps: None - endpoint complete
87
89
  ```
88
90
 
89
91
  ### For All Endpoints
92
+
90
93
  ```
91
94
  📊 V2 API Implementation Status
92
95
 
@@ -122,12 +125,14 @@ Last updated: 2025-12-06
122
125
  ## Commands
123
126
 
124
127
  ### View Status
128
+
125
129
  ```bash
126
130
  /hustle-api-status generate-css # Specific endpoint
127
131
  /hustle-api-status --all # All endpoints
128
132
  ```
129
133
 
130
134
  ### Update Status
135
+
131
136
  ```bash
132
137
  /hustle-api-status generate-css --phase=testing
133
138
  /hustle-api-status generate-css --complete
@@ -138,6 +143,7 @@ Last updated: 2025-12-06
138
143
  Updates: `/src/v2/docs/v2-api-implementation-status.md`
139
144
 
140
145
  **Format:**
146
+
141
147
  ```markdown
142
148
  # V2 API Implementation Status
143
149
 
@@ -148,6 +154,7 @@ Updates: `/src/v2/docs/v2-api-implementation-status.md`
148
154
  ## Endpoints
149
155
 
150
156
  ### ✅ /api/v2/health
157
+
151
158
  - **Status:** Complete
152
159
  - **Tests:** 15/15 passing
153
160
  - **Coverage:** 100%
@@ -156,6 +163,7 @@ Updates: `/src/v2/docs/v2-api-implementation-status.md`
156
163
  - **Purpose:** System health check with dependency validation
157
164
 
158
165
  ### 🚧 /api/v2/generate-css
166
+
159
167
  - **Status:** In Progress (Testing)
160
168
  - **Tests:** 20/33 passing
161
169
  - **Coverage:** 85%
@@ -165,6 +173,7 @@ Updates: `/src/v2/docs/v2-api-implementation-status.md`
165
173
  - **Next:** Complete remaining tests
166
174
 
167
175
  ### 📋 /api/v2/generate-html
176
+
168
177
  - **Status:** Planned
169
178
  - **Priority:** High
170
179
  - **Dependencies:** None
@@ -175,24 +184,28 @@ Updates: `/src/v2/docs/v2-api-implementation-status.md`
175
184
  ## Integration with Workflow
176
185
 
177
186
  ### After Interview
187
+
178
188
  ```bash
179
189
  /hustle-api-interview generate-css
180
190
  /hustle-api-status generate-css --phase=interview-complete
181
191
  ```
182
192
 
183
193
  ### After Research
194
+
184
195
  ```bash
185
196
  /hustle-api-research gemini-flash
186
197
  /hustle-api-status generate-css --phase=research-complete
187
198
  ```
188
199
 
189
200
  ### After TDD Cycle
201
+
190
202
  ```bash
191
203
  /cycle generate CSS with Gemini
192
204
  /hustle-api-status generate-css --complete
193
205
  ```
194
206
 
195
207
  ### Before Commit
208
+
196
209
  ```bash
197
210
  pnpm test:run
198
211
  /hustle-api-status --all # Verify all green
@@ -202,6 +215,7 @@ pnpm test:run
202
215
  ## Automatic Updates
203
216
 
204
217
  The `/hustle-api-create` command automatically updates status:
218
+
205
219
  - Interview phase → "Interview Complete"
206
220
  - Red phase → "Tests Written"
207
221
  - Green phase → "Implementation Complete"
@@ -224,21 +238,27 @@ The `/hustle-api-create` command automatically updates status:
224
238
  ## Reports
225
239
 
226
240
  ### Coverage Report
241
+
227
242
  ```bash
228
243
  /hustle-api-status --coverage
229
244
  ```
245
+
230
246
  Shows test coverage for all V2 endpoints.
231
247
 
232
248
  ### Migration Report
249
+
233
250
  ```bash
234
251
  /hustle-api-status --migration
235
252
  ```
253
+
236
254
  Shows progress from legacy to V2.
237
255
 
238
256
  ### Blockers Report
257
+
239
258
  ```bash
240
259
  /hustle-api-status --blocked
241
260
  ```
261
+
242
262
  Shows endpoints blocked by missing keys, dependencies, etc.
243
263
 
244
264
  <claude-commands-template>
@@ -256,4 +276,4 @@ Shows endpoints blocked by missing keys, dependencies, etc.
256
276
  - Used by /commit to verify readiness
257
277
  - Used by team to see what's done
258
278
  - Used for planning future work
259
- </claude-commands-template>
279
+ </claude-commands-template>
@@ -138,24 +138,24 @@ Creates: `.claude/research/[api-name]/verification.md`
138
138
 
139
139
  **Date:** [current-date]
140
140
  **Implementation File:** src/app/api/v2/[endpoint]/route.ts
141
- **Test File:** src/app/api/v2/[endpoint]/__tests__/[endpoint].api.test.ts
141
+ **Test File:** src/app/api/v2/[endpoint]/**tests**/[endpoint].api.test.ts
142
142
 
143
143
  ## Documentation Sources Re-Checked
144
144
 
145
- | Source | URL | Checked |
146
- |--------|-----|---------|
147
- | Official docs | [URL] | ✓ |
148
- | Context7 | [library] | ✓ |
149
- | Cached research | .claude/research/[api]/CURRENT.md | ✓ |
145
+ | Source | URL | Checked |
146
+ | --------------- | --------------------------------- | ------- |
147
+ | Official docs | [URL] | ✓ |
148
+ | Context7 | [library] | ✓ |
149
+ | Cached research | .claude/research/[api]/CURRENT.md | ✓ |
150
150
 
151
151
  ## Feature Comparison
152
152
 
153
- | Feature | In Docs | Implemented | Status |
154
- |---------|---------|-------------|--------|
155
- | domain param | ✓ | ✓ | ✅ Match |
156
- | format param | 4 options | 3 options | âš ī¸ Fixed |
157
- | size param | ✓ | ✓ | âš ī¸ Fixed |
158
- | webhook | ✓ | ✗ | â„šī¸ Intentional |
153
+ | Feature | In Docs | Implemented | Status |
154
+ | ------------ | --------- | ----------- | -------------- |
155
+ | domain param | ✓ | ✓ | ✅ Match |
156
+ | format param | 4 options | 3 options | âš ī¸ Fixed |
157
+ | size param | ✓ | ✓ | âš ī¸ Fixed |
158
+ | webhook | ✓ | ✗ | â„šī¸ Intentional |
159
159
 
160
160
  ## Gaps Fixed
161
161
 
@@ -190,6 +190,7 @@ Creates: `.claude/research/[api-name]/verification.md`
190
190
  This command is normally triggered automatically by `verify-after-green.py` hook after tests pass.
191
191
 
192
192
  Manual invocation is useful when:
193
+
193
194
  - Hook was skipped or didn't trigger
194
195
  - Want to re-verify after changes
195
196
  - Research is stale and needs refresh
@@ -228,4 +229,4 @@ Phase 10: VERIFY ← /hustle-api-verify triggers this
228
229
  - Error codes handled?
229
230
  - Optional features accounted for?
230
231
  - Default values match docs?
231
- </claude-commands-template>
232
+ </claude-commands-template>