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

package/.claude/registry.json

@@ -0,0 +1,289 @@
+{
+  "version": "1.5.0",
+  "updated_at": "",
+  "description": "Central registry tracking all APIs, components, pages, hooks, utilities, types, routes, environment variables, external services, ADRs, and brand guide created through Hustle Dev Tools",
+
+  "adrs": {
+    "_description": "Architecture Decision Records - significant decisions with context and reasoning. Created during research, updated during interview.",
+    "_example": {
+      "0001-database-choice": {
+        "number": 1,
+        "title": "Database Choice",
+        "status": "accepted",
+        "date": "2025-12-30",
+        "phase": "interview",
+        "endpoint": "todo-app",
+        "category": "database",
+        "decision": "supabase",
+        "options_considered": ["supabase", "firebase", "postgres"],
+        "file": ".claude/adrs/0001-database-choice.md",
+        "decided_at": "2025-12-30T10:15:00Z"
+      }
+    }
+  },
+
+  "brand_guide": {
+    "_description": "Brand guide configuration tracking. Single source of truth for all UI styling decisions.",
+    "created_at": null,
+    "last_updated": null,
+    "version": 0,
+    "interview_completed": false,
+    "file": ".claude/BRAND_GUIDE.md",
+    "brand_page": "src/app/brand/page.tsx",
+    "theme_file": "src/lib/theme.ts",
+    "sections": {
+      "colors": false,
+      "typography": false,
+      "spacing": false,
+      "animations": false,
+      "voice": false,
+      "custom_elements": false
+    },
+    "custom_elements": [],
+    "_custom_elements_options": [
+      "terminal-animation",
+      "gradient-text",
+      "typing-effect",
+      "parallax-scroll",
+      "particle-background",
+      "three-js-scene",
+      "gsap-animations",
+      "lottie-animations",
+      "glassmorphism",
+      "neumorphism"
+    ],
+    "voice": {
+      "tone": null,
+      "_tone_options": ["professional", "friendly", "technical", "playful", "custom"],
+      "terminology": {},
+      "dos": [],
+      "donts": []
+    },
+    "colors": {
+      "primary": null,
+      "secondary": null,
+      "accent": null,
+      "background": null,
+      "foreground": null,
+      "muted": null,
+      "destructive": null,
+      "gradients": []
+    },
+    "typography": {
+      "font_sans": null,
+      "font_mono": null,
+      "font_heading": null,
+      "scale": "default"
+    },
+    "motion": {
+      "style": null,
+      "_style_options": ["snappy", "smooth", "bouncy", "minimal", "none"],
+      "duration_fast": "150ms",
+      "duration_normal": "300ms",
+      "duration_slow": "500ms",
+      "easing": "ease-out",
+      "library": null,
+      "_library_options": ["css", "framer-motion", "gsap", "none"]
+    },
+    "shadcn": {
+      "initialized": false,
+      "components_installed": [],
+      "theme_configured": false
+    }
+  },
+
+  "apis": {},
+
+  "components": {},
+
+  "pages": {},
+
+  "combined": {},
+
+  "routes": {
+    "_description": "All application routes - API routes, page routes, middleware. Enables dead route detection and navigation planning.",
+    "_example": {
+      "/api/users": {
+        "file": "src/app/api/users/route.ts",
+        "methods": ["GET", "POST"],
+        "auth_required": true,
+        "rate_limited": true,
+        "description": "User CRUD operations"
+      },
+      "/api/users/[id]": {
+        "file": "src/app/api/users/[id]/route.ts",
+        "methods": ["GET", "PUT", "DELETE"],
+        "auth_required": true,
+        "params": ["id"],
+        "description": "Single user operations"
+      },
+      "/dashboard": {
+        "file": "src/app/dashboard/page.tsx",
+        "type": "page",
+        "auth_required": true,
+        "layout": "src/app/dashboard/layout.tsx"
+      }
+    }
+  },
+
+  "env_vars": {
+    "_description": "Environment variables required by the application. Enables /api-env validation and deployment checklists.",
+    "_example": {
+      "DATABASE_URL": {
+        "required": true,
+        "description": "PostgreSQL connection string",
+        "used_by": ["prisma", "src/lib/db.ts"],
+        "format": "postgresql://user:pass@host:5432/db",
+        "sensitive": true
+      },
+      "NEXT_PUBLIC_API_URL": {
+        "required": true,
+        "description": "Public API base URL",
+        "used_by": ["src/lib/api-client.ts"],
+        "public": true,
+        "sensitive": false
+      },
+      "STRIPE_SECRET_KEY": {
+        "required": false,
+        "description": "Stripe API secret key",
+        "used_by": ["src/app/api/payments/route.ts"],
+        "sensitive": true,
+        "docs": "https://stripe.com/docs/keys"
+      }
+    }
+  },
+
+  "services": {
+    "_description": "External services and APIs the application depends on. Enables dependency tracking and outage awareness.",
+    "_example": {
+      "stripe": {
+        "name": "Stripe",
+        "type": "payment",
+        "sdk": "@stripe/stripe-js",
+        "env_vars": ["STRIPE_SECRET_KEY", "STRIPE_PUBLISHABLE_KEY", "STRIPE_WEBHOOK_SECRET"],
+        "endpoints_used": ["/v1/customers", "/v1/subscriptions", "/v1/checkout/sessions"],
+        "webhooks": ["/api/webhooks/stripe"],
+        "docs": "https://stripe.com/docs/api",
+        "status_page": "https://status.stripe.com"
+      },
+      "supabase": {
+        "name": "Supabase",
+        "type": "database",
+        "sdk": "@supabase/supabase-js",
+        "env_vars": ["SUPABASE_URL", "SUPABASE_ANON_KEY", "SUPABASE_SERVICE_KEY"],
+        "features_used": ["auth", "database", "storage"],
+        "docs": "https://supabase.com/docs",
+        "status_page": "https://status.supabase.com"
+      },
+      "openai": {
+        "name": "OpenAI",
+        "type": "ai",
+        "sdk": "openai",
+        "env_vars": ["OPENAI_API_KEY"],
+        "models_used": ["gpt-4", "gpt-3.5-turbo"],
+        "docs": "https://platform.openai.com/docs",
+        "status_page": "https://status.openai.com"
+      }
+    }
+  },
+
+  "webhooks": {
+    "_description": "Incoming webhook endpoints and their configurations. Critical for security auditing.",
+    "_example": {
+      "/api/webhooks/stripe": {
+        "file": "src/app/api/webhooks/stripe/route.ts",
+        "service": "stripe",
+        "signature_header": "stripe-signature",
+        "signature_secret_env": "STRIPE_WEBHOOK_SECRET",
+        "events_handled": ["checkout.session.completed", "customer.subscription.updated"],
+        "idempotency": true
+      },
+      "/api/webhooks/github": {
+        "file": "src/app/api/webhooks/github/route.ts",
+        "service": "github",
+        "signature_header": "x-hub-signature-256",
+        "signature_secret_env": "GITHUB_WEBHOOK_SECRET",
+        "events_handled": ["push", "pull_request"]
+      }
+    }
+  },
+
+  "hooks": {
+    "_description": "Custom React hooks - tracked to prevent duplication and enable reuse",
+    "_example": {
+      "useAuth": {
+        "file": "src/hooks/useAuth.ts",
+        "returns": "{ user: User | null, login: Function, logout: Function }",
+        "description": "Authentication hook with login/logout methods"
+      }
+    }
+  },
+
+  "utils": {
+    "_description": "Utility functions - tracked to prevent duplication",
+    "_example": {
+      "formatCurrency": {
+        "file": "src/lib/utils/format.ts",
+        "signature": "(amount: number, currency?: string) => string",
+        "description": "Format number as currency with locale support"
+      }
+    }
+  },
+
+  "types": {
+    "_description": "Shared TypeScript types - tracked for schema consistency",
+    "_example": {
+      "User": {
+        "file": "src/types/user.ts",
+        "definition": "{ id: string, email: string, name: string }",
+        "used_by": ["useAuth", "UserProfile", "api/users"]
+      }
+    }
+  },
+
+  "providers": {
+    "_description": "React Context providers - tracked to show app structure",
+    "_example": {
+      "AuthProvider": {
+        "file": "src/providers/AuthProvider.tsx",
+        "context": "AuthContext",
+        "provides": "{ user, login, logout }",
+        "wraps": "entire app"
+      }
+    }
+  },
+
+  "orchestrator_defaults": {
+    "description": "Shared decisions from /hustle-build orchestrator interviews - applied to all sub-workflows",
+    "error_handling": {
+      "style": null,
+      "options": ["try-catch-rethrow", "error-boundary", "result-type", "error-codes"]
+    },
+    "authentication": {
+      "method": null,
+      "options": ["jwt", "session", "api-key", "oauth", "none"]
+    },
+    "logging": {
+      "level": null,
+      "options": ["verbose", "standard", "minimal", "none"]
+    },
+    "api_versioning": {
+      "strategy": null,
+      "options": ["url-prefix", "header", "query-param", "none"]
+    },
+    "testing": {
+      "coverage_threshold": null,
+      "visual_viewports": ["mobile-portrait", "mobile-notch", "mobile-landscape", "tablet-portrait", "tablet-landscape", "small-desktop", "desktop"]
+    },
+    "styling": {
+      "approach": null,
+      "options": ["tailwind", "css-modules", "styled-components", "emotion", "vanilla"]
+    }
+  },
+
+  "visual_test_results": {
+    "description": "Results from /test-visual runs - populated by visual-analyzer agent",
+    "last_run": null,
+    "elements": {}
+  }
+}

package/.claude/settings.json

@@ -20,7 +20,21 @@
       "Bash(ccusage:*)",
       "Bash(curl:*)"
     ],
-    "deny": ["Read(./.env*)", "Bash(rm -rf:*)"]
+    "deny": [
+      "Read(./.env*)",
+      "Read(**/.env*)",
+      "Read(**/secrets/**)",
+      "Read(**/*.pem)",
+      "Read(**/*.key)",
+      "Read(**/.ssh/**)",
+      "Read(**/.aws/**)",
+      "Bash(rm -rf:*)",
+      "Bash(sudo:*)",
+      "Bash(git push --force:*)",
+      "Bash(git push -f:*)",
+      "Bash(git reset --hard:*)",
+      "Bash(eval:*)"
+    ]
   },
   "hooks": {
     "SessionStart": [
@@ -44,6 +58,15 @@
       }
     ],
     "PreToolUse": [
+      {
+        "matcher": "Skill",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/hooks/project-document-prompt.py"
+          }
+        ]
+      },
       {
         "matcher": "Write|Edit",
         "hooks": [
@@ -68,6 +91,10 @@
       {
         "matcher": "AskUserQuestion",
         "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/hooks/remote-question-proxy.py"
+          },
           {
             "type": "command",
             "command": "$CLAUDE_PROJECT_DIR/hooks/notify-input-needed.py"
@@ -116,6 +143,23 @@
           {
             "type": "command",
             "command": "$CLAUDE_PROJECT_DIR/hooks/verify-after-green.py"
+          },
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/hooks/run-code-review.py"
+          },
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/hooks/run-visual-qa.py"
+          }
+        ]
+      },
+      {
+        "matcher": "Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/hooks/run-visual-qa.py"
           }
         ]
       }

package/.claude/workflow-logs/None.json

@@ -0,0 +1,49 @@
+{
+  "workflow_id": null,
+  "started_at": "2025-12-31T10:47:34.890055",
+  "events": [
+    {
+      "timestamp": "2025-12-31T10:47:34.890060",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-31T11:42:24.803048",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-31T12:48:30.930758",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-31T13:03:02.208852",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-31T13:57:26.590368",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-31T14:13:44.346541",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-31T14:52:15.551084",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    }
+  ],
+  "last_activity": "2025-12-31T14:52:15.551091"
+}

package/.claude/workflow-logs/session-20251230-143727.json

@@ -0,0 +1,106 @@
+{
+  "workflow_id": "session-20251230-143727",
+  "started_at": "2025-12-30T14:37:27.686881",
+  "events": [
+    {
+      "timestamp": "2025-12-30T14:37:27.686883",
+      "type": "session_start",
+      "directories_created": [
+        ".claude/workflow-logs",
+        ".claude/adrs"
+      ],
+      "registry_created": true
+    },
+    {
+      "timestamp": "2025-12-30T14:50:12.196714",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-30T15:07:01.110692",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-30T15:29:13.991468",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-30T16:17:49.753967",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-30T17:09:14.175522",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-30T17:17:54.527338",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-30T17:44:21.434629",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-30T18:07:24.057087",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-30T18:19:02.627702",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-30T21:11:02.689606",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-30T22:36:41.675022",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-30T23:18:37.288618",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-30T23:18:43.802291",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-30T23:21:10.084416",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    },
+    {
+      "timestamp": "2025-12-31T09:11:59.343488",
+      "type": "session_start",
+      "directories_created": [],
+      "registry_created": false
+    }
+  ],
+  "last_activity": "2025-12-31T09:11:59.343495"
+}