@arii/boomtick-mcp 0.3.3

package/.env.example

@@ -0,0 +1,6 @@
+GITHUB_TOKEN=
+GITHUB_OWNER=arii
+GITHUB_REPO=tech-dancer
+BOOMTICK_REPO_PATH=
+DEFAULT_BASE_BRANCH=main
+VITE_BASE_PATH=/tech-dancer/

package/.mcp/schemas/agent.search_ddgs.json

@@ -0,0 +1 @@
+{"name":"agent.search_ddgs","description":"Search the web using DuckDuckGo (via ddgs python library).","parameters":null}

package/.mcp/schemas/boomtick.health.json

@@ -0,0 +1 @@
+{"name":"boomtick.health","description":"Check the health and configuration of the MCP server.","parameters":null}

package/.mcp/schemas/github.checkout_branch.json

@@ -0,0 +1 @@
+{"name":"github.checkout_branch","description":"Checkout a specific branch in the repository or worktree.","parameters":null}

package/.mcp/schemas/github.comment_triage_summary.json

@@ -0,0 +1 @@
+{"name":"github.comment_triage_summary","description":"Comment on the original PR with a diagnosis and replacement link.","parameters":null}

package/.mcp/schemas/github.create_issue.json

@@ -0,0 +1 @@
+{"name":"github.create_issue","description":"Create a new GitHub issue.","parameters":null}

package/.mcp/schemas/github.create_pull_request.json

@@ -0,0 +1 @@
+{"name":"github.create_pull_request","description":"Creates a pull request on GitHub using the MCP server's integrated credentials. Bypasses terminal CLI constraints.","parameters":null}

package/.mcp/schemas/github.get_merge_conflict_files.json

@@ -0,0 +1 @@
+{"name":"github.get_merge_conflict_files","description":"Detect files that conflict when a PR is merged with the base branch.","parameters":null}

package/.mcp/schemas/github.get_pr.json

@@ -0,0 +1 @@
+{"name":"github.get_pr","description":"Get details of a GitHub PR including title, state, and URLs.","parameters":null}

package/.mcp/schemas/github.get_pr_diff.json

@@ -0,0 +1 @@
+{"name":"github.get_pr_diff","description":"Get the diff and changed files for a pull request.","parameters":null}

package/.mcp/schemas/github.issue_comment.json

@@ -0,0 +1 @@
+{"name":"github.issue_comment","description":"Add a new comment to a GitHub issue.","parameters":null}

package/.mcp/schemas/github.issue_update.json

@@ -0,0 +1 @@
+{"name":"github.issue_update","description":"Update a GitHub issue's body, labels, and/or state.","parameters":null}

package/.mcp/schemas/github.issue_view.json

@@ -0,0 +1 @@
+{"name":"github.issue_view","description":"View details of a GitHub issue including title, body, and state.","parameters":null}

package/.mcp/schemas/github.open_replacement_pr.json

@@ -0,0 +1 @@
+{"name":"github.open_replacement_pr","description":"Open a new PR that replaces or repairs the original PR.","parameters":null}

package/.mcp/schemas/github.search_open_prs.json

@@ -0,0 +1 @@
+{"name":"github.search_open_prs","description":"Search for open pull requests in the repository.","parameters":null}

package/.mcp/schemas/jules.cancel_session.json

@@ -0,0 +1 @@
+{"name":"jules.cancel_session","description":"Cancel an ongoing Jules session.","parameters":null}

package/.mcp/schemas/jules.create_session.json

@@ -0,0 +1 @@
+{"name":"jules.create_session","description":"Create a Jules session that performs work externally and may generate a GitHub pull request.","parameters":null}

package/.mcp/schemas/jules.get_messages.json

@@ -0,0 +1 @@
+{"name":"jules.get_messages","description":"Get the message history of a Jules session.","parameters":null}

package/.mcp/schemas/jules.get_pr.json

@@ -0,0 +1 @@
+{"name":"jules.get_pr","description":"Get the generated pull request url associated with an active Jules agent session.","parameters":null}

package/.mcp/schemas/jules.get_session.json

@@ -0,0 +1 @@
+{"name":"jules.get_session","description":"Get the status and details of a Jules session.","parameters":null}

package/.mcp/schemas/jules.list_sessions.json

@@ -0,0 +1 @@
+{"name":"jules.list_sessions","description":"List all Jules sessions.","parameters":null}

package/.mcp/schemas/jules.send_message.json

@@ -0,0 +1 @@
+{"name":"jules.send_message","description":"Send a message to an active Jules session.","parameters":null}

package/.mcp/schemas/jules.trigger_feedback.json

@@ -0,0 +1 @@
+{"name":"jules.trigger_feedback","description":"Automatically collect CI status/logs for the PR associated with a Jules session and send them back as feedback.","parameters":null}

package/.mcp/schemas/repo.commit_patch.json

@@ -0,0 +1 @@
+{"name":"repo.commit_patch","description":"Commit verified repair changes in a worktree.","parameters":null}

package/.mcp/schemas/repo.create_branch.json

@@ -0,0 +1 @@
+{"name":"repo.create_branch","description":"Creates a new clean git branch from a target base branch.","parameters":null}

package/.mcp/schemas/repo.create_repair_branch.json

@@ -0,0 +1 @@
+{"name":"repo.create_repair_branch","description":"Creates a fresh worktree and a new repair branch for an existing PR. This isolates the repair work from the main codebase.","parameters":null}

package/.mcp/schemas/repo.get_changed_files.json

@@ -0,0 +1 @@
+{"name":"repo.get_changed_files","description":"Get the list of changed files between two refs.","parameters":null}

package/.mcp/schemas/repo.get_command_schema.json

@@ -0,0 +1 @@
+{"name":"repo.get_command_schema","description":"Retrieve a lightweight, targeted schema for a specific td-cli subcommand. Use this instead of reading the entire cli-schema.json to save tokens.","parameters":null}

package/.mcp/schemas/repo.get_package_scripts.json

@@ -0,0 +1 @@
+{"name":"repo.get_package_scripts","description":"Get the scripts defined in package.json.","parameters":null}

package/.mcp/schemas/repo.get_route_map.json

@@ -0,0 +1 @@
+{"name":"repo.get_route_map","description":"Get the mapping of routes to content files.","parameters":null}

package/.mcp/schemas/repo.logs.json

@@ -0,0 +1 @@
+{"name":"repo.logs","description":"Stream or grep combined CI logs for all jobs in a pull request.","parameters":null}

package/.mcp/schemas/repo.read_agent_context.json

@@ -0,0 +1 @@
+{"name":"repo.read_agent_context","description":"Read the full repository index including file tree, CLI schema, and MCP tools.","parameters":null}

package/.mcp/schemas/repo.read_ci_logs.json

@@ -0,0 +1 @@
+{"name":"repo.read_ci_logs","description":"Read CI logs for a given pull request.","parameters":null}

package/.mcp/schemas/repo.run_lighthouse.json

@@ -0,0 +1 @@
+{"name":"repo.run_lighthouse","description":"Run Lighthouse CI audits.","parameters":null}

package/.mcp/schemas/repo.run_playwright.json

@@ -0,0 +1 @@
+{"name":"repo.run_playwright","description":"Run Playwright E2E tests.","parameters":null}

package/.mcp/schemas/repo.run_tests.json

@@ -0,0 +1 @@
+{"name":"repo.run_tests","description":"Run repository tests and checks.","parameters":null}

package/CHANGELOG.md

@@ -0,0 +1,50 @@
+# Changelog
+
+## [0.3.3](https://github.com/arii/boomtick/compare/mcp-v0.3.2...mcp-v0.3.3) (2026-07-20)
+
+
+### Bug Fixes
+
+* resolve ERR_MODULE_NOT_FOUND when running check-visual-changes.ts ([#259](https://github.com/arii/boomtick/issues/259)) ([54f4a2f](https://github.com/arii/boomtick/commit/54f4a2f842517d4de31cf201efbeb6fdf5a57c94))
+
+## [0.3.2](https://github.com/arii/boomtick/compare/mcp-v0.3.1...mcp-v0.3.2) (2026-07-17)
+
+
+### Bug Fixes
+
+* pass jules_api_key env to impact analysis steps ([#151](https://github.com/arii/boomtick/issues/151)) ([a4744ee](https://github.com/arii/boomtick/commit/a4744eeed2d665eb87053f828551a1136259b0fc))
+
+## [0.3.1](https://github.com/arii/boomtick/compare/mcp-v0.3.0...mcp-v0.3.1) (2026-07-17)
+
+
+### Bug Fixes
+
+* resolve workflow audit failures and consolidate automation ([#110](https://github.com/arii/boomtick/issues/110)) ([aa3682b](https://github.com/arii/boomtick/commit/aa3682b966cc3de6639f0a895bfafffb89106fcb))
+
+## [0.3.0](https://github.com/arii/boomtick/compare/mcp-v0.2.1...mcp-v0.3.0) (2026-07-15)
+
+
+### Features
+
+* **cli:** Add tool to fetch PR and review comments natively ([#3355](https://github.com/arii/boomtick/issues/3355)) ([7c98b80](https://github.com/arii/boomtick/commit/7c98b8097b51066abc2c97ab16582a451565b626))
+* Consolidate CI setup logic into composite action ([#3073](https://github.com/arii/boomtick/issues/3073)) ([ac9012f](https://github.com/arii/boomtick/commit/ac9012f4ec377c29fada9f71d1091854394d96c0))
+* consolidated package extraction for boomtick-pkg ([#3491](https://github.com/arii/boomtick/issues/3491)) ([8e33e34](https://github.com/arii/boomtick/commit/8e33e34e4ca2711d1468944c0f8294386bf26445))
+* Handle missing node_modules gracefully in verify:schemas script ([#3438](https://github.com/arii/boomtick/issues/3438)) ([b9645a8](https://github.com/arii/boomtick/commit/b9645a8d9846dbafab2ca5a1c6951005ad862af1))
+* **mcp:** add dedicated github.get_pr tool ([#3277](https://github.com/arii/boomtick/issues/3277)) ([a74dc79](https://github.com/arii/boomtick/commit/a74dc79e1d7d1a4ade89852c28a16ec5b834ea30))
+* migrate release workflows to boomtick-pkg and setup symlinks wi… ([#3614](https://github.com/arii/boomtick/issues/3614)) ([0b31b7c](https://github.com/arii/boomtick/commit/0b31b7c7869beea22d47d5b0834eb3f99243a464))
+* Unified Python Core Engine Consolidation ([#3166](https://github.com/arii/boomtick/issues/3166)) ([0dad8bb](https://github.com/arii/boomtick/commit/0dad8bbdf3e331e25a5b106c35d95ee38bf0c012))
+
+
+### Bug Fixes
+
+* add state parameter to github.issue_update MCP schema ([#3205](https://github.com/arii/boomtick/issues/3205)) ([5642e83](https://github.com/arii/boomtick/commit/5642e833dcf66cdd309a489a4935f247fe9a5f1e))
+* **ci:** handle missing AI logs gracefully in verify-metrics ([#3554](https://github.com/arii/boomtick/issues/3554)) ([5e0c346](https://github.com/arii/boomtick/commit/5e0c34659d6344ff7a79a86dc88d06bee8b96998))
+* **ci:** handle missing AI logs gracefully in verify-metrics ([#3580](https://github.com/arii/boomtick/issues/3580)) ([b126289](https://github.com/arii/boomtick/commit/b126289e565c403a1a84ba5160b40223ea8ccce7))
+* **ci:** pass --ignore-scripts to impact build main ([#53](https://github.com/arii/boomtick/issues/53)) ([7160e49](https://github.com/arii/boomtick/commit/7160e494992764d9d95f0dadd0c5c5d23f199428))
+* **ci:** pass --ignore-scripts to impact build main ([#55](https://github.com/arii/boomtick/issues/55)) ([4a5d1d9](https://github.com/arii/boomtick/commit/4a5d1d989f21fd62627e28027624b1bb4982127b))
+* detect-antipatterns.mjs path resolution and impact-analysis-utils eslint errors ([#52](https://github.com/arii/boomtick/issues/52)) ([797475e](https://github.com/arii/boomtick/commit/797475ef8b93c5d74627d329e7bf842852a374c8))
+* **mcp:** use sessionId for jules tools to avoid PR ID confusion ([#3286](https://github.com/arii/boomtick/issues/3286)) ([0c4147b](https://github.com/arii/boomtick/commit/0c4147b8cdd98160f0422dcf73ec8b35164176bf))
+* **mcp:** use z.input instead of z.infer for CreateBranchInputSchema ([#3094](https://github.com/arii/boomtick/issues/3094)) ([baeaf41](https://github.com/arii/boomtick/commit/baeaf41a0333b73dc597a72c876e87c4dd4a1ae3))
+* path resolution and linting issues in impact analysis ([#49](https://github.com/arii/boomtick/issues/49)) ([2b23a39](https://github.com/arii/boomtick/commit/2b23a39848e4c012d7c94b633c0627cad85619f6))
+* resolve ModuleNotFoundError in Jules session creation and isolate python env ([#3442](https://github.com/arii/boomtick/issues/3442)) ([6870392](https://github.com/arii/boomtick/commit/6870392b6a1f5784110d9a75a1e6b972cf297775))
+* Resolve tester findings and update progress documentation ([#3191](https://github.com/arii/boomtick/issues/3191)) ([1cfea38](https://github.com/arii/boomtick/commit/1cfea3813129f9289122a12f80c543103a541f6a))

package/README.md

@@ -0,0 +1,108 @@
+# Boomtick MCP: PR Rescue + Merge Conflict Agent
+
+A Model Context Protocol (MCP) server designed to empower AI agents with structured access to GitHub Pull Requests, repository state, CI logs, and validation tools.
+
+## Features
+
+### 🛠 Tools
+- **GitHub Ops**: Search PRs, get diffs, detect merge conflicts, open replacement PRs, and triage comments.
+- **Repo Ops**: Inspect changed files, extract package scripts, map application routes, and read CI logs.
+- **Validation**: Isolated repair branch creation, and running verification suites (Tests, Lighthouse, Playwright).
+- **Jules Operations**: Create, monitor, and interact with macro-agent Jules sessions.
+
+### 📄 Resources
+- `repo://package-json`: Access root package manifest.
+- `repo://routes`: Access application route-to-content mapping.
+- `repo://design-tokens`: Access UI design tokens.
+- `repo://diff/{prNumber}`: Access full PR diff text.
+- `repo://ci/{prNumber}`: Access detailed CI check results and logs.
+
+### 🧠 Prompts
+- `prompt://conflict-scout`: Scout for PRs needing rescue.
+- `prompt://pr-consolidation`: Guidelines for analyzing and proposing consolidation of overlapping PRs.
+- `prompt://repo-context`: Gather context before repair.
+- `prompt://repair-agent`: Apply minimal safe fixes.
+- `prompt://verifier-agent`: Prove the repair works.
+- `prompt://pr-writer`: Write professional replacement PR summaries.
+
+### 📝 Scripts
+- `scripts/create_instructions.sh`: Generates the `pr-consolidation.prompt.md` instructions file based on PR overlaps.
+
+## Safety First
+- **Isolated Worktrees**: All repair and merge operations happen in temporary git worktrees to prevent mutating your local working directory.
+- **Safe Shell**: All commands are restricted via an allowlist with automatic token redaction and timeouts.
+- **Write Guards**: Mutating operations (commits, branch creation, PR opening) require explicit `writeMode: true` or `pushMode: true` flags.
+
+## Setup
+
+### Prerequisites
+- Node.js >= 22
+- pnpm >= 10
+- GitHub CLI (`gh`) authenticated and in your PATH.
+
+### Installation
+```bash
+cd boomtick-mcp
+pnpm install
+pnpm build
+```
+
+### Installation via MCP Client (e.g. Claude Desktop)
+Add the following to your MCP client configuration (e.g. `claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "boomtick": {
+      "command": "node",
+      "args": ["/absolute/path/to/boomtick-mcp/dist/index.js"],
+      "env": {
+        "GITHUB_TOKEN": "your_pat",
+        "GITHUB_OWNER": "your_org",
+        "GITHUB_REPO": "your_repo",
+        "BOOMTICK_REPO_PATH": "/absolute/path/to/repo"
+      }
+    }
+  }
+}
+```
+
+### Configuration
+Create a `.env` file in the `boomtick-mcp` directory:
+```env
+GITHUB_TOKEN=your_pat
+GITHUB_OWNER=your_org
+GITHUB_REPO=your_repo
+BOOMTICK_REPO_PATH=/path/to/repo
+```
+
+## Usage
+Run the server via stdio:
+```bash
+node dist/index.js
+```
+
+## Release Process
+1. Run tests: `pnpm test`
+2. Run evals: `pnpm run run-evals`
+3. Update version: `pnpm run release:patch` (or `minor`/`major`)
+4. Build: `pnpm run build`
+5. Push changes and tags.
+
+## Future Roadmap
+
+### ContentOps + Merch Compliance
+- `content.validate_affiliate_disclosure`: Ensure Amazon mandatory wording is present.
+- `content.check_trademark_risk`: Flag potential trademark issues in blog posts.
+- `amazon.validate_affiliate_card`: Verify affiliate links and product names match media.
+
+### UX Regression + Spec-Driven Redesign
+- `ux.capture_screenshot`: Capture multi-viewport screenshots.
+- `ux.compare_screenshots`: Detect visual regressions using Playwright.
+- `ux.run_accessibility_check`: Automated Axe-core audits.
+
+## Development
+- **Build**: `pnpm run build`
+- **Test**: `pnpm test`
+- **Verify**: `pnpm run run-evals`
+
+For detailed verification steps, see [docs/testing.md](./docs/testing.md).

package/actions/ai-review/action.yml

@@ -0,0 +1,15 @@
+name: BoomTick AI Review
+description: Runs AI code review via python3 -m dev_tools.cli CLI
+inputs:
+  pr_number:
+    description: PR number to review
+    required: true
+runs:
+  using: composite
+  steps:
+    - uses: ./mcp/actions/setup
+    - name: AI review
+      env:
+        PR_NUMBER: ${{ inputs.pr_number }}
+      run: python3 -m dev_tools.cli gh audit-pr "$PR_NUMBER" --fetch --audit
+      shell: bash

package/actions/audit/action.yml

@@ -0,0 +1,37 @@
+name: BoomTick Anti-Pattern Audit
+description: Runs UI anti-pattern and design token compliance audits
+inputs:
+  github_token:
+    description: 'GitHub token'
+    required: true
+runs:
+  using: composite
+  steps:
+    - uses: ./mcp/actions/setup
+
+    - name: Install dependencies
+      run: pnpm install --frozen-lockfile --prefer-offline
+      shell: bash
+
+    - name: UI Anti-Pattern Audit - Gate
+      env:
+        GITHUB_TOKEN: ${{ inputs.github_token }}
+      run: |
+        echo "::group::Audit"
+        trap 'echo "::endgroup::"' EXIT
+        export PATH="$HOME/.local/bin:/github/home/.local/bin:$PATH"
+        if ! node scripts/detect-antipatterns.mjs; then echo "Audit failed"; exit 1; fi
+        python3 -m dev_tools.cli gh audit-gate
+      shell: bash
+
+    - name: Design Token Compliance
+      run: |
+        VIOLATIONS=$(find . -name "*.tsx" -not -path "*/node_modules/*" -type f | xargs grep -h '#[0-9a-fA-F]\{3,6\}' \
+          | grep -vc "design-tokens\|tokens.css\|// impeccable-ignore" || echo 0)
+        if [ "$VIOLATIONS" -gt 0 ]; then
+          echo "⚠️ Found $VIOLATIONS raw hex color(s) in tsx files. Use CSS variables instead."
+          find . -name "*.tsx" -not -path "*/node_modules/*" -type f | xargs grep -rn '#[0-9a-fA-F]\{3,6\}' | grep -v "design-tokens\|tokens.css"
+          exit 1
+        fi
+        echo "✅ Design token compliance passed."
+      shell: bash

package/actions/ci-validate/action.yml

@@ -0,0 +1,9 @@
+name: BoomTick CI Validate
+description: Runs pre-submit checks via python3 -m dev_tools.cli CLI
+runs:
+  using: composite
+  steps:
+    - uses: ./mcp/actions/setup
+    - name: Pre-submit gate
+      run: python3 -m dev_tools.cli gh pre-submit
+      shell: bash