Development Tools

The Development Tools skill is the primary command-line interface for engineers working on the Multigres codebase. It streamlines the development lifecycle for this Vitess adaptation for PostgreSQL by abstracting complex test execution, environment setup, and resource management into a simple /mt-dev command structure. Developers use this tool to ensure system integrity during local development, debugging, and feature implementation across core components like multigateway, multipooler, pgctld, and multiorch.

• Executes granular unit tests for isolated package validation, supporting pattern matching and race detection.

• Manages complex integration tests that require building binaries via make build and coordinating external services.

• Orchestrates port allocation through a robust port-pool mechanism to prevent flaky network collisions during parallel testing.

• Provides a unified interface for developers to verify PostgreSQL compatibility using the regression test suite.

• Summarizes test results, error logs, and coverage metrics directly in the console for immediate developer feedback.

• Target audience: Backend engineers, infrastructure developers, and contributors working on the Multigres core engine.

• Input requirements: The tool expects a terminal environment within the repository root; commands like /mt-dev unit [path] or /mt-dev integration [package] must be provided with specific Go package paths or test patterns.

• Execution context: Always run make build before integration tests to ensure the current binary reflects the latest code changes. Use the provided port-pool scripts to avoid address conflicts in local environments.

• Constraints: The skill is specific to the Multigres Go-based architecture; it is not intended for general-purpose system administration outside of the repository's development scope.