Development Guide

Welcome to the Seed development guide! This section covers everything you need to contribute to Seed.

Development Workflow

Quick Links

• Development Setup - Set up your development environment
• Testing Guide - Writing and running tests
• Code Quality - Linting, formatting, and standards
• Adding MCP Tools - Create new MCP tools
• Adding MCP Prompts - Create new MCP prompts
• Adding MCP Resources - Create new MCP resources
• Contributing - Contribution guidelines

Development Commands

Build and Run

npm run build          # Compile TypeScript to dist/
npm run dev            # Development mode with hot reload
npm start              # Run compiled code

Testing

npm test               # Run all tests once
npm run test:watch     # Run tests in watch mode
npm run test:coverage  # Generate coverage report

Code Quality

npm run lint           # Lint source code
npm run typecheck      # Type check without emitting
npm run format         # Format code with Prettier
npm run format:check   # Check formatting
npm run validate       # Run all quality checks

Project Standards

• TypeScript - Strict mode with ESM modules
• Testing - Vitest with comprehensive coverage (42 config validation tests, 96.26% coverage)
• Code Style - ESLint + Prettier
• Commits - Clear, descriptive messages
• Branches - feature/, fix/, docs/, refactor/ prefixes
• Production Ready - ✅ Graceful shutdown, health checks, config validation, token revocation

Getting Help

• Open an issue on GitLab
• Check existing documentation
• Review CONTRIBUTING.md