@hustle-together/api-dev-tools 3.12.3 → 4.5.1

package/commands/hustle-api-create.md

@@ -468,6 +468,28 @@ Both conditions must be true for the flag to be set.
 └───────────────────────────────────────────────────────────┘
 ```
 
+### End-of-Workflow Summary
+
+After successful API creation, display:
+
+```
+═══════════════════════════════════════════════════════════════
+✅ API CREATED: [endpoint-name]
+
+📍 Quick Links:
+  • Test it:     /api-showcase
+  • API Docs:    /docs/api/[endpoint-name]
+  • Run tests:   pnpm test src/app/api/v2/[endpoint-name]
+  • TypeDoc:     pnpm typedoc
+
+📊 Dashboard:    /hustle-dev-dashboard
+
+Next Steps:
+  • /hustle-combine - Combine with other APIs
+  • /commit - Commit your changes
+═══════════════════════════════════════════════════════════════
+```
+
 ### Showcase Redirect
 
 After successful API creation, output:

package/commands/hustle-build.md

@@ -0,0 +1,259 @@
+# Hustle Build - Master Orchestrator v4.6.0
+
+**Usage:** `/hustle-build [description] [--auto] [--parallel] [--resume] [--dry-run]`
+
+**Purpose:** Build complete features from natural language descriptions. Orchestrates API, Component, Page, and Combined workflows automatically with shared decisions.
+
+## Arguments
+
+- `$ARGUMENTS` - Natural language description of what to build
+- `--auto` - Fully autonomous mode, auto-answers questions with comprehensive defaults
+- `--parallel` - Run up to 5 Opus agents in parallel (requires worktrees)
+- `--resume [id]` - Resume an interrupted build from last checkpoint
+- `--dry-run` - Show what would be created without executing
+- `--max-iterations [N]` - Max retry iterations per phase (default: 5)
+- `--skip-document` - Skip the project document prompt
+- `--from-document [path]` - Use specified file as project document (PRD, spec)
+
+---
+
+## Quick Start
+
+```bash
+# Simple build
+/hustle-build weather dashboard with search and forecast
+
+# With a PRD/spec document
+/hustle-build --from-document ./specs/feature.md
+
+# Fully autonomous
+/hustle-build --auto e-commerce checkout with cart and payments
+
+# Parallel execution (5 agents)
+/hustle-build --parallel dashboard with stats, charts, and user settings
+```
+
+---
+
+## 10-Phase Workflow
+
+### Phase 1: Document Intake & Parsing
+- Prompts for project document (PRD, spec, requirements)
+- Parses document to extract pages, components, APIs
+- Builds dependency graph
+- User approves decomposition
+
+### Phase 2: Decomposition
+- Analyzes request to identify:
+  - **APIs** needed (Tier 1 - no dependencies)
+  - **Components** needed (Tier 2 - depend on APIs)
+  - **Pages** needed (Tier 3 - depend on components)
+- Determines execution order based on dependencies
+
+### Phase 3: Orchestrator Interview
+- Single interview for shared decisions:
+  - Authentication method
+  - Error handling strategy
+  - Brand guide usage
+  - Caching strategy
+- Answers propagate to ALL sub-workflows
+
+### Phases 4-6: Sub-Workflow Execution
+- Executes each workflow with injected context
+- Uses `/api-create` for APIs
+- Uses `/hustle-ui-create` for components
+- Uses `/hustle-ui-create-page` for pages
+- Ralph Wiggum loops ensure quality
+
+### Phase 7: Integration & Wiring
+- Connects components to API data
+- Wires up state management
+- Creates data flow patterns
+
+### Phase 8: Unified Testing
+- Runs full test suite across all created elements
+- Integration tests for API → Component → Page flow
+- Visual regression tests
+
+### Phase 9: Documentation
+- Updates registry with all new elements
+- Generates API documentation
+- Creates component Storybook stories
+
+### Phase 10: Completion
+- Final verification
+- Commits all changes
+- Summary of created elements
+
+---
+
+## Auto Mode (`--auto`)
+
+When `--auto` flag is used:
+
+1. **No Interactive Questions:**
+   - All questions auto-answered with comprehensive defaults
+   - Uses `.claude/hustle-build-defaults.json` for configured answers
+   - Falls back to "most comprehensive" option when no default exists
+
+2. **Default Selections:**
+   - Auth: As configured in defaults (typically JWT or API Key)
+   - Error Handling: partial-success
+   - Brand Guide: enabled
+   - Testing: full coverage
+
+3. **Logging:**
+   - All decisions logged to `.claude/hustle-build-state.json`
+   - Review with `/hustle-build-review [build-id]`
+
+---
+
+## Parallel Execution (`--parallel`)
+
+When `--parallel` flag is used:
+
+1. **Creates git worktrees** for each independent workflow
+2. **Spawns up to 5 Opus agents** simultaneously
+3. **Injects shared decisions** from interview into each agent
+4. **Merges results** when all complete
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    PARALLEL ORCHESTRATOR                        │
+├─────────────────────────────────────────────────────────────────┤
+│  Shared Context (from Interview)                               │
+│  ┌───────────────────────────────────────────────────────┐     │
+│  │ Auth: JWT | Errors: partial-success | Brand: yes      │     │
+│  └───────────────────────────────────────────────────────┘     │
+│                          │                                      │
+│          ┌───────────────┼───────────────┐                     │
+│          ▼               ▼               ▼                     │
+│  ┌──────────────┐ ┌──────────────┐ ┌──────────────┐           │
+│  │ Agent #1     │ │ Agent #2     │ │ Agent #3     │           │
+│  │ /api-create  │ │ /api-create  │ │ /hustle-ui   │           │
+│  │ user-stats   │ │ chart-data   │ │ StatCard     │           │
+│  └──────────────┘ └──────────────┘ └──────────────┘           │
+│          │               │               │                     │
+│          └───────────────┼───────────────┘                     │
+│                          ▼                                      │
+│  ┌───────────────────────────────────────────────────────┐     │
+│  │              MERGE COORDINATOR                         │     │
+│  │  • Combines registry entries                          │     │
+│  │  • Resolves conflicts                                 │     │
+│  │  • Creates unified PR                                 │     │
+│  └───────────────────────────────────────────────────────┘     │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Ralph Wiggum Loops (Self-Terminating)
+
+Each quality gate loops until passing:
+
+| Phase | Loop Until | Promise Signal |
+|-------|-----------|----------------|
+| TDD Green | All tests pass | `<promise>TESTS_PASSING</promise>` |
+| Code Review | Greptile clean | `<promise>REVIEW_CLEAN</promise>` |
+| Visual QA | Haiku approves | `<promise>VISUAL_CLEAN</promise>` |
+| Verification | Docs match code | `<promise>VERIFIED</promise>` |
+
+---
+
+## State Tracking
+
+All progress tracked in `.claude/hustle-build-state.json`:
+
+```json
+{
+  "build_id": "weather-dashboard-20231215",
+  "status": "in_progress",
+  "current_phase": 4,
+  "decomposition": {
+    "apis": ["weather-current", "weather-forecast"],
+    "components": ["SearchBar", "WeatherCard", "ForecastList"],
+    "pages": ["WeatherDashboard"]
+  },
+  "shared_decisions": {
+    "auth": "none",
+    "error_handling": "partial-success",
+    "brand_guide": true
+  },
+  "completed_workflows": ["weather-current", "weather-forecast"],
+  "pending_workflows": ["SearchBar", "WeatherCard"]
+}
+```
+
+---
+
+## Remote Dashboard
+
+Monitor builds from your phone:
+
+```bash
+# Start the dashboard server
+python hooks/remote-question-server.py
+```
+
+Access at `http://localhost:8765` or `http://YOUR_COMPUTER_IP:8765` on same network.
+
+Features:
+- Real-time phase progress
+- Answer questions remotely
+- Browser notifications for new questions
+- Build queue visualization
+
+---
+
+## Examples
+
+### Example 1: Weather Dashboard
+```
+/hustle-build weather dashboard with city search, current conditions, and 5-day forecast
+```
+
+Creates:
+- `weather-geocoding` API (Open-Meteo)
+- `weather-forecast` API (Open-Meteo)
+- `SearchBar` component
+- `WeatherCard` component
+- `ForecastList` component
+- `WeatherDashboard` page
+
+### Example 2: E-commerce Checkout
+```
+/hustle-build --auto checkout flow with cart summary, payment form, and order confirmation
+```
+
+Creates:
+- `cart` API
+- `payments` API (Stripe)
+- `orders` API
+- `CartSummary` component
+- `PaymentForm` component
+- `OrderConfirmation` component
+- `CheckoutPage` page
+
+### Example 3: User Dashboard
+```
+/hustle-build --parallel user dashboard with profile, stats, activity feed, and settings
+```
+
+Creates (in parallel):
+- `user-profile` API
+- `user-stats` API
+- `activity-feed` API
+- `ProfileCard` component
+- `StatsGrid` component
+- `ActivityFeed` component
+- `SettingsPanel` component
+- `DashboardPage` page
+
+---
+
+## See Also
+
+- `/hustle-combine` - Combine existing APIs/components
+- `/hustle-ui-create` - Create single component
+- `/hustle-ui-create-page` - Create single page
+- `/api-create` - Create single API integration

package/commands/hustle-combine.md

@@ -1,9 +1,65 @@
-# Hustle Combine - API and UI Orchestration Workflow v3.11.0
+# Hustle Combine - API and UI Orchestration Workflow v4.0.0
 
-**Usage:** `/hustle-combine [api|ui]`
+**Usage:** `/hustle-combine [api|ui] [--auto] [--resume [workflow-id]]`
 
 **Purpose:** Combines existing APIs or UI elements from the registry into new orchestration endpoints or composed components.
 
+## Arguments
+
+- `[api|ui]` - Mode: combine APIs or UI elements
+- `--auto` - Fully autonomous mode, auto-answers all questions with comprehensive defaults
+- `--resume [workflow-id]` - Resume an interrupted workflow from its last phase
+
+---
+
+## Auto Mode (`--auto`)
+
+When `--auto` flag is used:
+
+1. **No Interactive Questions:**
+   - All questions auto-answered with comprehensive defaults
+   - Uses `.claude/hustle-build-defaults.json` for configured answers
+   - Falls back to "most comprehensive" option when no default exists
+
+2. **Comprehensive Selection Logic:**
+   - Selects parallel execution (when APIs are independent)
+   - Uses partial-success error handling
+   - Enables unified caching strategy
+   - Uses exponential retry with 30s timeout
+
+3. **API Selection in Orchestrated Mode:**
+   - When `orchestrated: true`, APIs are pre-selected by orchestrator
+   - Selection phase is skipped, proceeds directly to Scope
+
+4. **Logging:**
+   - All decisions logged to `.claude/workflow-logs/hustle-combine/[workflow-id].json`
+   - Review with `/hustle-combine-review [workflow-id]`
+
+---
+
+## Resume Mode (`--resume`)
+
+When `--resume [workflow-id]` is used:
+
+1. Load state from `.claude/api-dev-state.json`
+2. Find the last incomplete phase
+3. Continue from that point
+4. Preserve all previous decisions and API selections
+
+---
+
+## Orchestrated Mode
+
+When running as part of `/hustle-build`:
+
+1. `orchestrated: true` flag is set in state
+2. `shared_decisions` are pre-filled from orchestrator interview
+3. Source APIs are pre-selected based on orchestrator decomposition
+4. Questions covered by shared_decisions are SKIPPED
+5. Only combination-specific questions are asked (execution order, caching)
+
+---
+
 ## Overview
 
 This command reads from `.claude/registry.json` to present available elements for combination. It creates NEW orchestration layers using EXISTING, tested components.
@@ -837,6 +893,29 @@ Update registry.json with the new combined API:
 }
 ```
 
+### End-of-Workflow Summary
+
+After successful combination, display:
+
+```
+═══════════════════════════════════════════════════════════════
+✅ COMBINED API CREATED: [combined-name]
+
+📍 Quick Links:
+  • Test it:     /api-showcase
+  • API Docs:    /docs/api/[combined-name]
+  • Run tests:   pnpm test src/app/api/v2/[combined-name]
+  • TypeDoc:     pnpm typedoc
+
+📦 Combined:     [api1] + [api2]
+📊 Dashboard:    /hustle-dev-dashboard
+
+Next Steps:
+  • /commit - Commit your changes
+  • /hustle-api-create - Create another API
+═══════════════════════════════════════════════════════════════
+```
+
 ---
 
 ## Mode B: Combine UI (Coming Soon)

package/commands/hustle-ui-create-page.md

@@ -5,11 +5,71 @@ argument-hint: [page-name]
 
 # Hustle UI Create - Page Mode
 
-**Version:** 3.11.0
+**Version:** 4.0.0
 **14-phase workflow for creating Next.js App Router pages**
 
+**Usage:** `/hustle-ui-create-page [page-name] [--auto] [--resume [workflow-id]]`
+
 You are creating a page using the Hustle Together interview-driven workflow.
 
+## Arguments
+
+- `[page-name]` - Name of the page to create
+- `--auto` - Fully autonomous mode, auto-answers all questions with comprehensive defaults
+- `--resume [workflow-id]` - Resume an interrupted workflow from its last phase
+
+---
+
+## Auto Mode (`--auto`)
+
+When `--auto` flag is used:
+
+1. **No Interactive Questions:**
+   - All questions auto-answered with comprehensive defaults
+   - Uses `.claude/hustle-build-defaults.json` for configured answers
+   - Falls back to "most comprehensive" option when no default exists
+
+2. **Comprehensive Selection Logic:**
+   - Uses responsive-grid layout
+   - Enables full SEO (Open Graph, Twitter cards, JSON-LD)
+   - Creates loading states and error boundaries
+   - Enables prefetching and Suspense
+   - Uses all available components from registry
+
+3. **Error Handling:**
+   - E2E test failures: Retry 3x, then log and continue
+   - Missing API routes: Log warning, create stubs
+   - Performance budget exceeded: Log warning, continue
+
+4. **Logging:**
+   - All decisions logged to `.claude/workflow-logs/ui-create-page/[workflow-id].json`
+   - Review with `/hustle-ui-create-page-review [workflow-id]`
+
+---
+
+## Resume Mode (`--resume`)
+
+When `--resume [workflow-id]` is used:
+
+1. Load state from `.claude/api-dev-state.json`
+2. Find the last incomplete phase
+3. Continue from that point
+4. Preserve all previous decisions
+
+---
+
+## Orchestrated Mode
+
+When running as part of `/hustle-build`:
+
+1. `orchestrated: true` flag is set in state
+2. `shared_decisions` are pre-filled from orchestrator interview
+3. Questions covered by shared_decisions are SKIPPED (e.g., auth, brand guide, testing level)
+4. Components to use are pre-selected based on orchestrator decomposition
+5. Only page-specific questions are asked (layout, SEO details)
+
+---
+
 ## Pre-Flight Check
 
 Before starting, verify state file exists:
@@ -911,6 +971,28 @@ Run `pnpm dev` and navigate to /ui-showcase to see it.
 
 Update state: `phases.completion.status = "complete"`
 
+### End-of-Workflow Summary
+
+After successful page creation, display:
+
+```
+═══════════════════════════════════════════════════════════════
+✅ PAGE CREATED: [PageName]
+
+📍 Quick Links:
+  • View page:    /[page-name]
+  • UI Showcase:  /ui-showcase
+  • Run E2E:      pnpm playwright test src/app/[page-name]
+
+📊 Dashboard:    /hustle-dev-dashboard
+
+Next Steps:
+  • /hustle-ui-create - Create components for this page
+  • /hustle-api-create - Create APIs this page needs
+  • /commit - Commit your changes
+═══════════════════════════════════════════════════════════════
+```
+
 ---
 
 # State File Structure
@@ -992,5 +1074,5 @@ Update state: `phases.completion.status = "complete"`
 
 ---
 
-**Version:** 3.11.0
+**Version:** 4.0.0
 **Last Updated:** 2025-12-28

package/commands/hustle-ui-create.md

@@ -5,11 +5,69 @@ argument-hint: [component-name]
 
 # Hustle UI Create
 
-**Version:** 3.11.0
+**Version:** 4.0.0
 **14-phase workflow for creating UI components and pages**
 
+**Usage:** `/hustle-ui-create [component-name] [--auto] [--resume [workflow-id]]`
+
 You are creating a UI element using the Hustle Together interview-driven workflow.
 
+## Arguments
+
+- `[component-name]` - Name of the component to create
+- `--auto` - Fully autonomous mode, auto-answers all questions with comprehensive defaults
+- `--resume [workflow-id]` - Resume an interrupted workflow from its last phase
+
+---
+
+## Auto Mode (`--auto`)
+
+When `--auto` flag is used:
+
+1. **No Interactive Questions:**
+   - All questions auto-answered with comprehensive defaults
+   - Uses `.claude/hustle-build-defaults.json` for configured answers
+   - Falls back to "most comprehensive" option when no default exists
+
+2. **Comprehensive Selection Logic:**
+   - Selects ALL variants (size, color, state)
+   - Enables full accessibility (WCAG 2.1 AA)
+   - Enables animations and responsive design
+   - Creates all Storybook stories
+
+3. **Error Handling:**
+   - Test failures: Retry 3x, then log and continue
+   - Visual regression: Update baselines automatically
+   - Missing packages: Install automatically
+
+4. **Logging:**
+   - All decisions logged to `.claude/workflow-logs/ui-create/[workflow-id].json`
+   - Review with `/hustle-ui-create-review [workflow-id]`
+
+---
+
+## Resume Mode (`--resume`)
+
+When `--resume [workflow-id]` is used:
+
+1. Load state from `.claude/api-dev-state.json`
+2. Find the last incomplete phase
+3. Continue from that point
+4. Preserve all previous decisions
+
+---
+
+## Orchestrated Mode
+
+When running as part of `/hustle-build`:
+
+1. `orchestrated: true` flag is set in state
+2. `shared_decisions` are pre-filled from orchestrator interview
+3. Questions covered by shared_decisions are SKIPPED (e.g., brand guide, testing level)
+4. Only component-specific questions are asked (variants, props)
+
+---
+
 ## Pre-Flight Check
 
 Before starting, verify state file exists:
@@ -901,6 +959,28 @@ For Sandpack live editing, install: `pnpm add @codesandbox/sandpack-react`
 
 Update state: `phases.completion.status = "complete"`
 
+### End-of-Workflow Summary
+
+After successful component creation, display:
+
+```
+═══════════════════════════════════════════════════════════════
+✅ COMPONENT CREATED: [ComponentName]
+
+📍 Quick Links:
+  • Preview it:   /ui-showcase
+  • Storybook:    http://localhost:6006
+  • Run tests:    pnpm test src/components/[ComponentName]
+  • Visual tests: pnpm playwright test --grep "[ComponentName]"
+
+📊 Dashboard:    /hustle-dev-dashboard
+
+Next Steps:
+  • /hustle-ui-create-page - Create a page using this component
+  • /commit - Commit your changes
+═══════════════════════════════════════════════════════════════
+```
+
 ---
 
 # Page Mode (14 Phases)
@@ -974,5 +1054,5 @@ See full page mode documentation in `/hustle-ui-create-page.md` (if implementing
 
 ---
 
-**Version:** 3.11.0
+**Version:** 4.0.0
 **Last Updated:** 2025-12-28