Skip to content

Conversation

@GarthDB
Copy link
Owner

@GarthDB GarthDB commented Aug 29, 2025

Summary

This PR adds comprehensive development tooling to the act-testing-mcp repository, bringing it up to modern standards with automated workflows and code quality tools.

Changes

🛠️ Development Tools Added

  • Changesets: Automated version management and release notes
  • Commitlint: Conventional commit message validation
  • Prettier: Automatic code formatting with git hooks
  • Husky: Git hooks for pre-commit validation
  • Lint-staged: Automatic formatting of staged files

�� GitHub Actions Workflows

  • CI Workflow: Runs tests, formatting checks, and compatibility tests
  • Release Workflow: Automated npm publishing with changesets

📋 Configuration Files

  • Cursor Rules: Comprehensive development guidelines adapted from spectrum-tokens
  • MCP Configuration: Local development setup for testing the MCP server
  • Branch Protection Guide: Instructions for setting up repository protections

🎯 Key Features

  • Conventional commit enforcement with commitlint
  • Automatic code formatting on commit
  • Comprehensive testing with coverage reporting
  • Automated releases when changesets are merged
  • CI/CD pipeline with proper checks

Testing

  • ✅ All 26 tests pass
  • ✅ Code formatting works correctly
  • ✅ Git hooks function properly
  • ✅ Workflow files are valid
  • ✅ MCP server runs successfully

Next Steps

After this PR is merged:

  1. Set up branch protection rules using docs/BRANCH_PROTECTION_SETUP.md
  2. Configure NPM_TOKEN secret for automated releases
  3. All future changes should go through pull requests

Breaking Changes

None - this is purely additive development tooling setup.

- Add changeset support for automated version management
- Add commitlint with conventional commit validation
- Add prettier with git hooks for code formatting
- Add GitHub Actions for CI/CD and automated releases
- Set up husky for pre-commit hooks
- Configure lint-staged for automatic formatting
- Add proper release automation workflow

🛠️  Development tools included:
- @changesets/cli for version management
- @commitlint/cli for commit message validation
- prettier for code formatting
- husky for git hooks
- lint-staged for pre-commit formatting

🔄 Automated workflows:
- CI workflow with tests and formatting checks
- Release workflow with automated npm publishing
- Changeset-based version management
- Add comprehensive cursor rules adapted from spectrum-tokens
- Add MCP configuration for standalone repository
- Add branch protection setup guide with recommended settings
- Update package.json with correct husky prepare script
- Configure act-testing MCP server for local development
- Add comprehensive secrets setup documentation
- Add .npmignore to control what gets published
- Add files field to package.json for explicit inclusion
- Document complete release workflow process
- Include troubleshooting and security best practices
- Fix baseline file path for standalone repository structure
- Add baseline creation step to CI workflow when missing
- Ensures compatibility check passes when act is not available in CI

The CI was failing because the compatibility check required a baseline
file that didn't exist. Now the workflow automatically creates one
if missing, and the baseline file path has been corrected for the
standalone repository structure.
@GarthDB GarthDB force-pushed the feat/development-tooling-setup branch from f33ae6e to 9bf1d5c Compare August 29, 2025 20:05
- Add changeset bot workflow for PR commenting
- Configure bot messages for changesets presence/absence
- Update changeset config with experimental options
- Add changeset bot workflow to guide documentation

The bot will automatically comment on PRs to indicate whether
changesets are needed and guide contributors through the process.
The changeset bot GitHub App was installed directly on the repository,
so the custom GitHub Actions workflow is unnecessary. The official
app provides better integration and doesn't require workflow runs.
@changeset-bot
Copy link

changeset-bot bot commented Aug 29, 2025

🦋 Changeset detected

Latest commit: 96feceb

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
act-testing-mcp Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@GarthDB GarthDB merged commit 7d35796 into main Aug 29, 2025
1 check passed
@github-actions github-actions bot mentioned this pull request Aug 29, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants