feat(pgpm): add test-packages command for integration testing

[pyramation]

feat(pgpm): add test-packages command for integration testing

Summary

Adds a new pgpm test-packages CLI command that abstracts the integration deploy testing scripts from pgpm-modules and constructive-db into a reusable command in the constructive repo. This addresses constructive-io/projects-issues#375.

The command discovers all PGPM modules in a workspace and runs integration tests on each by creating a temporary database, deploying, and optionally running verify/revert/deploy cycles.

Key features:

• --exclude - Module names to exclude from testing
• --stop-on-fail - Stop on first failure vs collect all failures
• --full-cycle - Run full deploy/verify/revert/deploy cycle (default: deploy only)
• --cwd - Working directory (default: current directory)

Implementation approach:

• Uses PgpmPackage.getModules() for module discovery (reads from workspace pgpm.json config)
• Uses PgpmPackage.deploy(), verify(), revert() methods directly instead of spawning CLI subprocesses
• Uses SQL via pg-cache for database creation/dropping (no shell commands)
• Properly terminates connections before dropping test databases

Updates since last revision

• Added README documentation for test-packages command to both CLI packages:
  • pgpm/pgpm/README.md (pgpm CLI)
  • packages/cli/README.md (@constructive-io/cli which inherits pgpm commands via cnc/constructive)

Review & Testing Checklist for Human

• Test end-to-end in a real workspace: Run pgpm test-packages in constructive-db to verify it discovers and tests modules correctly
• Verify module discovery: Confirm that PgpmPackage.getModules() returns the same modules that the old scripts/test-all-packages.js would find (check if pgpm.json packages globs cover all expected directories)
• Test database permissions: The SQL-based CREATE DATABASE/DROP DATABASE may require different privileges than the old createdb/dropdb approach
• Verify --full-cycle behavior: Test that verify/revert/deploy cycle works correctly with the internal APIs

Recommended test plan:

cd /path/to/constructive-db
pgpm test-packages --help
pgpm test-packages  # deploy only
pgpm test-packages --full-cycle  # full cycle
pgpm test-packages --exclude some-module --stop-on-fail

Notes

• Closes constructive-io/projects-issues#375
• Requested by: Dan Lynch (@pyramation)
• Devin run: https://app.devin.ai/sessions/1709376c8b9c45f1a1cbbf1ecc531b7d

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring