@hustle-together/api-dev-tools 3.12.16 → 4.5.3

package/templates/registry.json

@@ -1,7 +1,96 @@
 {
-  "version": "1.0.0",
+  "version": "1.5.0",
   "updated_at": "",
-  "description": "Central registry tracking all APIs, components, and pages created through Hustle Dev Tools",
+  "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": {},
 
@@ -9,5 +98,192 @@
 
   "pages": {},
 
-  "combined": {}
+  "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": {}
+  }
 }