@hustle-together/api-dev-tools 3.10.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.
- package/.claude/agents/code-reviewer.md +170 -0
- package/.claude/agents/docs-generator.md +80 -0
- package/.claude/agents/implementation-reviewer.md +119 -0
- package/.claude/agents/parallel-researcher.md +52 -0
- package/.claude/agents/research-validator.md +116 -0
- package/.claude/agents/schema-generator.md +70 -0
- package/.claude/agents/test-writer.md +104 -0
- package/.claude/api-dev-state.json +331 -0
- package/.claude/commands/README.md +196 -0
- package/.claude/commands/add-command.md +212 -0
- package/.claude/commands/api-create.md +510 -0
- package/.claude/commands/api-env.md +51 -0
- package/.claude/commands/api-interview.md +344 -0
- package/.claude/commands/api-research.md +357 -0
- package/.claude/commands/api-status.md +279 -0
- package/.claude/commands/api-verify.md +232 -0
- package/.claude/commands/beepboop.md +96 -0
- package/.claude/commands/busycommit.md +111 -0
- package/.claude/commands/commit.md +82 -0
- package/.claude/commands/cycle.md +137 -0
- package/.claude/commands/gap.md +85 -0
- package/.claude/commands/green.md +137 -0
- package/.claude/commands/issue.md +187 -0
- package/.claude/commands/ntfy-setup.md +91 -0
- package/.claude/commands/ntfy-test.md +74 -0
- package/.claude/commands/plan.md +167 -0
- package/.claude/commands/pr.md +121 -0
- package/.claude/commands/publish.md +40 -0
- package/.claude/commands/red.md +137 -0
- package/.claude/commands/refactor.md +137 -0
- package/.claude/commands/spike.md +137 -0
- package/.claude/commands/summarize.md +93 -0
- package/.claude/commands/tdd.md +139 -0
- package/.claude/commands/worktree-add.md +307 -0
- package/.claude/commands/worktree-cleanup.md +275 -0
- package/.claude/hooks/api-workflow-check.py +227 -0
- package/.claude/hooks/enforce-deep-research.py +185 -0
- package/.claude/hooks/enforce-disambiguation.py +155 -0
- package/.claude/hooks/enforce-documentation.py +192 -0
- package/.claude/hooks/enforce-environment.py +253 -0
- package/.claude/hooks/enforce-external-research.py +328 -0
- package/.claude/hooks/enforce-interview.py +421 -0
- package/.claude/hooks/enforce-refactor.py +189 -0
- package/.claude/hooks/enforce-research.py +159 -0
- package/.claude/hooks/enforce-schema.py +186 -0
- package/.claude/hooks/enforce-scope.py +160 -0
- package/.claude/hooks/enforce-tdd-red.py +250 -0
- package/.claude/hooks/enforce-verify.py +186 -0
- package/.claude/hooks/periodic-reground.py +154 -0
- package/.claude/hooks/session-startup.py +151 -0
- package/.claude/hooks/track-tool-use.py +626 -0
- package/.claude/hooks/verify-after-green.py +282 -0
- package/.claude/hooks/verify-implementation.py +225 -0
- package/.claude/research/index.json +6 -0
- package/.claude/settings.json +144 -0
- package/.claude/settings.local.json +12 -0
- package/.claude-plugin/marketplace.json +103 -0
- package/.skills/README.md +293 -0
- package/.skills/_shared/convert-commands.py +192 -0
- package/.skills/_shared/hooks/api-workflow-check.py +227 -0
- package/.skills/_shared/hooks/enforce-deep-research.py +185 -0
- package/.skills/_shared/hooks/enforce-disambiguation.py +155 -0
- package/.skills/_shared/hooks/enforce-documentation.py +192 -0
- package/.skills/_shared/hooks/enforce-environment.py +253 -0
- package/.skills/_shared/hooks/enforce-external-research.py +328 -0
- package/.skills/_shared/hooks/enforce-interview.py +421 -0
- package/.skills/_shared/hooks/enforce-refactor.py +189 -0
- package/.skills/_shared/hooks/enforce-research.py +159 -0
- package/.skills/_shared/hooks/enforce-schema.py +186 -0
- package/.skills/_shared/hooks/enforce-scope.py +160 -0
- package/.skills/_shared/hooks/enforce-tdd-red.py +250 -0
- package/.skills/_shared/hooks/enforce-verify.py +186 -0
- package/.skills/_shared/hooks/periodic-reground.py +154 -0
- package/.skills/_shared/hooks/session-startup.py +151 -0
- package/.skills/_shared/hooks/track-tool-use.py +626 -0
- package/.skills/_shared/hooks/verify-after-green.py +282 -0
- package/.skills/_shared/hooks/verify-implementation.py +225 -0
- package/.skills/_shared/install.sh +114 -0
- package/.skills/_shared/settings.json +93 -0
- package/.skills/add-command/SKILL.md +227 -0
- package/.skills/api-create/SKILL.md +623 -0
- package/.skills/api-env/SKILL.md +64 -0
- package/.skills/api-interview/SKILL.md +357 -0
- package/.skills/api-research/SKILL.md +370 -0
- package/.skills/api-status/SKILL.md +292 -0
- package/.skills/api-verify/SKILL.md +245 -0
- package/.skills/beepboop/SKILL.md +111 -0
- package/.skills/busycommit/SKILL.md +126 -0
- package/.skills/commit/SKILL.md +97 -0
- package/.skills/cycle/SKILL.md +152 -0
- package/.skills/gap/SKILL.md +100 -0
- package/.skills/green/SKILL.md +152 -0
- package/.skills/issue/SKILL.md +202 -0
- package/.skills/plan/SKILL.md +182 -0
- package/.skills/pr/SKILL.md +136 -0
- package/.skills/publish/SKILL.md +160 -0
- package/.skills/red/SKILL.md +152 -0
- package/.skills/refactor/SKILL.md +152 -0
- package/.skills/spike/SKILL.md +152 -0
- package/.skills/summarize/SKILL.md +108 -0
- package/.skills/tdd/SKILL.md +154 -0
- package/.skills/update-todos/SKILL.md +250 -0
- package/.skills/worktree-add/SKILL.md +322 -0
- package/.skills/worktree-cleanup/SKILL.md +290 -0
- package/CHANGELOG.md +115 -0
- package/README.md +161 -7101
- package/bin/cli.js +448 -805
- package/commands/README.md +66 -31
- package/commands/add-command.md +8 -5
- package/commands/beepboop.md +4 -5
- package/commands/busycommit.md +2 -3
- package/commands/commit.md +2 -3
- package/commands/cycle.md +2 -7
- package/commands/gap.md +2 -3
- package/commands/green.md +2 -7
- package/commands/hustle-api-continue.md +8 -5
- package/commands/hustle-api-create.md +70 -29
- package/commands/hustle-api-env.md +1 -0
- package/commands/hustle-api-interview.md +32 -19
- package/commands/hustle-api-research.md +47 -21
- package/commands/hustle-api-sessions.md +8 -7
- package/commands/hustle-api-status.md +21 -1
- package/commands/hustle-api-verify.md +14 -13
- package/commands/hustle-combine.md +488 -241
- package/commands/hustle-ui-create-page.md +113 -50
- package/commands/hustle-ui-create.md +179 -26
- package/commands/issue.md +3 -8
- package/commands/plan.md +2 -3
- package/commands/pr.md +2 -3
- package/commands/red.md +2 -7
- package/commands/refactor.md +2 -7
- package/commands/spike.md +2 -7
- package/commands/summarize.md +2 -3
- package/commands/tdd.md +2 -7
- package/commands/worktree-add.md +208 -216
- package/commands/worktree-cleanup.md +172 -178
- package/hooks/api-workflow-check.py +5 -3
- package/hooks/enforce-component-type-confirm.py +97 -0
- package/hooks/lib/__init__.py +1 -0
- package/hooks/lib/greptile.py +355 -0
- package/hooks/lib/ntfy.py +209 -0
- package/hooks/notify-input-needed.py +73 -0
- package/hooks/notify-phase-complete.py +90 -0
- package/hooks/run-code-review.py +246 -0
- package/hooks/track-token-usage.py +121 -0
- package/package.json +33 -12
- package/scripts/collect-test-results.ts +102 -77
- package/scripts/extract-parameters.ts +112 -70
- package/scripts/generate-test-manifest.ts +118 -77
- package/templates/.env.example +57 -0
- package/templates/BRAND_GUIDE.md +92 -52
- package/templates/CLAUDE-SECTION.md +40 -37
- package/templates/SPEC.json +186 -38
- package/templates/api-dev-state.json +33 -4
- package/templates/api-showcase/_components/APICard.tsx +22 -18
- package/templates/api-showcase/_components/APIModal.tsx +110 -64
- package/templates/api-showcase/_components/APIShowcase.tsx +53 -35
- package/templates/api-showcase/_components/APITester.tsx +128 -67
- package/templates/api-showcase/page.tsx +4 -4
- package/templates/api-test/page.tsx +51 -30
- package/templates/api-test/test-structure/route.ts +43 -34
- package/templates/component/Component.stories.tsx +41 -39
- package/templates/component/Component.test.tsx +96 -78
- package/templates/component/Component.tsx +63 -52
- package/templates/component/Component.types.ts +10 -6
- package/templates/component/Component.visual.spec.ts +170 -0
- package/templates/component/index.ts +2 -2
- package/templates/dev-tools/_components/DevToolsLanding.tsx +8 -8
- package/templates/dev-tools/page.tsx +4 -3
- package/templates/mcp-servers.json +30 -2
- package/templates/page/page.e2e.test.ts +56 -48
- package/templates/page/page.tsx +3 -3
- package/templates/shared/HeroHeader.tsx +16 -15
- package/templates/shared/index.ts +1 -1
- package/templates/ui-showcase/_components/PreviewCard.tsx +20 -20
- package/templates/ui-showcase/_components/PreviewModal.tsx +149 -108
- package/templates/ui-showcase/_components/UIShowcase.tsx +43 -35
- 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]
|
|
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
|
|
146
|
-
|
|
147
|
-
| Official docs
|
|
148
|
-
| Context7
|
|
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
|
|
154
|
-
|
|
155
|
-
| domain param | â
|
|
156
|
-
| format param | 4 options | 3 options
|
|
157
|
-
| size param
|
|
158
|
-
| webhook
|
|
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>
|