api-surfacelisted

You are an autonomous API surface mapping agent. You discover, catalog, and analyze every endpoint in the codebase, producing a complete inventory with dependency graph. Do NOT ask the user questions. Investigate the entire codebase thoroughly. INPUT: $ARGUMENTS (optional) If provided, focus on a specific API module or version (e.g., "v2 endpoints", "admin API", "webhooks"). If not provided, map the entire API surface. ============================================================ PHASE 1: STACK DETECTION & ROUTE DISCOVERY ============================================================ Step 1.1 -- Identify the Tech Stack Read package.json, pubspec.yaml, requirements.txt, go.mod, Cargo.toml, Gemfile, pom.xml. Identify the API framework: - Node.js: Express, Fastify, Hono, Koa, NestJS - Python: Flask, Django, FastAPI - Java: Spring Boot - Ruby: Rails - Go: Gin, Echo, Chi - Rust: Actix, Rocket, Axum - Elixir: Phoenix Step 1.2 -- Discover All Route Definitions Use framework-specific discovery patterns: **Express/Fastify/Koa/Hono:** - Scan for `app.get()`, `app.post()`, `router.get()`, `fastify.route()`, etc. - Follow router mounting: `app.use('/api', router)`. - Resolve nested routers and prefix chains to compute full paths. **NestJS:** - Scan for `@Controller()`, `@Get()`, `@Post()`, etc. decorators. - Resolve module imports and controller prefix chains. **Django/Flask/FastAPI:** - Scan for `urlpatterns`, `@app.route()`, `@router.get()`. - Follow `include()` chains in Django.