inp-backend

Safe, reversible Alembic migrations for inp-backend. Use when adding a column, table, FK, index, or constraint. Covers up/down, non-destructive adds, FK index requirement, and data-migration splits.

No-op. Documents that caveman mode is wired globally via ~/.claude/settings.json (SessionStart + UserPromptSubmit hooks). Project files do not need to re-enable it. Switch level with /caveman lite|full|ultra or say "stop caveman".

FastAPI router patterns for inp-backend. Use when adding a new endpoint, new *_routes.py, or wiring a new resource into app/main.py. Covers function-based routers, schema-first validation, layered architecture, and idempotency keys.

JWT issuance, validation, refresh, password hashing, and Google OAuth for inp-backend. Use when modifying app/auth.py, adding a new auth endpoint, or wiring OAuth.

Multi-provider LLM routing for app/services/llm_service.py. Use when adding a new LLM provider, fixing provider-specific bugs, or adjusting the priority chain. Priority: OpenRouter > ApiFreeLLM > GLM > Vultr.

Polar SDK patterns for inp-backend. Use when modifying app/routers/polar_routes.py, app/services/subscription_service.py, or webhook handling. Covers checkout creation, webhook signature verification, and sandbox vs live toggle.

Pydantic v2 Settings patterns for inp-backend. Use when extending app/core/config.py — env validation, Field() patterns, backward compatibility, and the rule to never read os.getenv outside this file.

Pytest patterns for inp-backend. Use when writing or running tests. Covers conftest fixtures, FastAPI TestClient vs httpx AsyncClient, mocking LLM providers with respx, and the marker system.

Security middleware order, headers, rate limits, request sanitization, and input validation for inp-backend. Use when modifying app/middleware/security.py or hardening a route.

SQLAlchemy 2.0 model patterns for inp-backend. Use when defining or modifying app/models.py — declarative style, timestamps, soft delete via is_deleted, relationships, and index hints.

Stripe (legacy) patterns for inp-backend. Use when modifying app/routers/stripe_routes.py. Covers checkout, webhook signature, and idempotency keys. Note: Polar is the primary billing path; Stripe routes exist for back-compat.

TDD workflow adapted to FastAPI + service layer in inp-backend. Use when adding a new endpoint, service method, or business rule. Red → Green → Refactor, with the project's test layout and markers.