Instruction file imported from jeffusion/gitea-ai-assistant (.cursor/rules/01-project-structure.mdc). Copyright stays with the author.

Project Structure

Main Entry Points

The application entry point is src/index.ts, which sets up the Hono web server and defines the main routes.

Core Directories

• src/: Contains all source code
  • controllers/: Route handlers and business logic
  • services/: Service layer for external API interactions
  • config/: Configuration management
  • utils/: Utility functions
  • llm/: Multi-provider LLM gateway and provider adapters
  • db/: SQLite database layer for LLM configuration
  • crypto/: Encryption utilities for API key storage
  • agent/: Multi-agent review engine (planner, specialists, judge)

Configuration Files

• package.json: Project dependencies and scripts
• tsconfig.json: TypeScript compiler configuration
• Dockerfile: Container configuration
• kubernetes.yaml: Kubernetes deployment configuration

Build and Deployment

The project uses Bun for development and production:

• bun run dev: Development mode with watch
• bun run build: Build production assets
• bun run start: Run in production

Docker and Kubernetes configurations are available for containerized deployment.