mev-beta/TOOLS_SUMMARY.md

Development Tools and Scripts Summary

Last Updated: October 24, 2025 Production Status: ✅ All tools validated in production deployment

Overview

This project includes a comprehensive set of development tools and scripts designed to improve productivity, maintain consistency, and enable efficient development workflows. The tools are designed to be reusable across multiple projects.

Production Tools (October 2025)

• Production Log Manager (scripts/log-manager.sh) - Advanced log analysis and monitoring
• Archive System (scripts/archive-logs.sh) - Log archiving and compression
• Build Scripts (scripts/build.sh) - Production binary compilation
• Development Tools - Comprehensive testing and quality assurance suite

Core Components

1. Enhanced Makefile

The main Makefile has been extended with:

• Multi-level testing: From basic to audit-level testing
• Comprehensive test coverage: Unit, integration, e2e, property, fuzzing, stress, security
• Development workflows: Integrated format, vet, lint, and test commands
• Math-specific testing: Dedicated targets for mathematical function testing
• Documentation generation: Auto-generate code documentation

2. Reusable Scripts

Located in the scripts/ directory:

Production Tools:

• log-manager.sh: Production-grade log management system with health scoring, analytics, and monitoring
• archive-logs.sh: Log archiving with compression and metadata
• quick-archive.sh: Rapid archiving for operational workflows
• view-latest-archive.sh: Browse archived log files

Development Tools:

• test-runner.sh: Universal test runner with configurable test levels and coverage
• build.sh: Universal build script with configurable options (creates bin/mev-beta)
• run.sh: Development server with hot reload
• setup-dev.sh: Development environment setup
• performance-profile.sh: Performance profiling and benchmarking
• create-project-template.sh: Generate new projects with standardized structure
• mev-tools.sh: Global tools manager for cross-project tool management

3. Project Template System

The create-project-template.sh script creates new Go projects with:

• Standardized directory structure
• Pre-configured Makefile with all testing levels
• Development scripts
• Documentation templates
• Proper Go module setup

4. Documentation

• DEVELOPER_DOCS.md: Comprehensive documentation for all tools and commands
• Inline help in Makefile via make help
• Self-documented scripts with usage information

Testing Levels

Basic Testing (Fast)

• make test-basic: Runs quick tests with -short flag
• Ideal for rapid development cycles

Comprehensive Testing

• make test-comprehensive: Unit + integration + e2e tests
• Good for pre-commit validation

Audit-Level Testing

• make test-audit: All testing types including security, stress, and benchmarks
• For release validation and comprehensive checks

Reusability Approach

The tools are designed with reusability in mind:

1. Environment Variables: All scripts use configurable environment variables
2. Modular Design: Each script focuses on a specific function
3. Global Installation: Scripts can be installed globally via mev-tools.sh install
4. Cross-Project Compatibility: Tools work with any Go project with minimal configuration

Quick Start

For This Project:

# Run basic development workflow
make dev-workflow

# Run comprehensive tests
make test-comprehensive

# Generate documentation
make docs

For New Projects:

# Create new project with standardized structure
./scripts/create-project-template.sh my-new-project

# Or use global tools manager
./scripts/mev-tools.sh setup-project my-new-project

For Global Installation:

./scripts/mev-tools.sh install
# Tools will be available globally as:
# test-runner, build-tool, dev-setup, perf-profile

Key Benefits

1. Consistency: Standardized development workflow across projects
2. Efficiency: Multi-level testing for different development phases
3. Reusability: Tools designed to work across multiple projects
4. Documentation: Comprehensive documentation for all tools
5. Extensibility: Easy to add new commands and scripts

Maintenance

The system is designed for easy maintenance:

• All configuration through environment variables
• Self-contained scripts with minimal external dependencies
• Clear separation of concerns
• Comprehensive error handling

Integration

These tools integrate well with:

• CI/CD pipelines (pre-commit, nightly builds, release validation)
• IDE environments
• Development workflows
• Team collaboration practices