ai-cli-mcp 2.18.0 → 2.20.0

package/.github/pull_request_template.md

@@ -1,28 +0,0 @@
-## Summary
-
-<!-- Briefly describe what this PR does -->
-
-## Type of Change
-
-- [ ] feat: New feature
-- [ ] fix: Bug fix
-- [ ] refactor: Refactoring
-- [ ] docs: Documentation
-- [ ] test: Add or update tests
-- [ ] chore: Build, CI, dependencies, etc.
-
-## Changes
-
-<!-- List the main changes -->
-
--
-
-## Test Plan
-
-- [ ] `npm run test:unit` passes
-- [ ] `npm run build` passes
-- [ ] Manual testing (if applicable)
-
-## Notes
-
-<!-- Any additional context for reviewers -->

package/.github/workflows/ci.yml

@@ -1,34 +0,0 @@
-name: Node.js CI
-
-on:
-  push:
-    branches: [ develop ]
-  pull_request:
-    branches: [ develop ]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        node-version: [20.19.0, 22.12.0, 24.x]
-
-    steps:
-    - name: Checkout repository
-      uses: actions/checkout@v4
-
-    - name: Set up Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v4
-      with:
-        node-version: ${{ matrix.node-version }}
-        cache: 'npm'
-
-    - name: Install dependencies
-      run: npm ci
-
-    - name: Build project
-      run: npm run build
-
-    - name: Run unit tests
-      run: npm run test:unit

package/.github/workflows/dependency-review.yml

@@ -1,22 +0,0 @@
-name: Dependency Review
-
-on:
-  pull_request:
-    branches:
-      - develop
-
-permissions:
-  contents: read
-
-jobs:
-  dependency-review:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Dependency Review
-        uses: actions/dependency-review-action@v4
-        with:
-          fail-on-severity: moderate
-          fail-on-scopes: runtime

package/.github/workflows/publish.yml

@@ -1,89 +0,0 @@
-name: Release
-
-on:
-  push:
-    branches:
-      - develop
-
-permissions:
-  contents: read
-
-jobs:
-  release:
-    name: Release
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write      # to create release and push changelog
-      issues: write        # to comment on released issues
-      pull-requests: write # to comment on released PRs
-      id-token: write      # for OIDC trusted publishing
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          fetch-tags: true
-          persist-credentials: false
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '24'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Install dependencies
-        run: npm clean-install
-
-      - name: Build
-        run: npm run build
-
-      - name: Run tests
-        run: npm test
-
-      - name: Verify provenance attestations
-        run: npm audit signatures
-
-      - name: Capture version before release
-        id: release_before
-        run: |
-          VERSION=$(node -p 'require("./package.json").version')
-          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
-
-      - name: Release
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: npx semantic-release
-
-      - name: Capture version after release
-        id: release_after
-        run: |
-          VERSION=$(node -p 'require("./package.json").version')
-          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
-
-      - name: Detect whether a release was published
-        id: release_status
-        run: |
-          if [ "${{ steps.release_before.outputs.version }}" != "${{ steps.release_after.outputs.version }}" ]; then
-            echo "published=true" >> "$GITHUB_OUTPUT"
-          else
-            echo "published=false" >> "$GITHUB_OUTPUT"
-          fi
-
-      - name: Install mcp-publisher
-        if: steps.release_status.outputs.published == 'true'
-        run: |
-          curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
-
-      - name: Authenticate to MCP Registry
-        if: steps.release_status.outputs.published == 'true'
-        run: ./mcp-publisher login github-oidc
-
-      - name: Set version in server.json
-        if: steps.release_status.outputs.published == 'true'
-        run: |
-          VERSION=$(node -p "require('./package.json').version")
-          jq --arg v "$VERSION" '.version = $v | .packages[0].version = $v' server.json > server.tmp && mv server.tmp server.json
-
-      - name: Publish to MCP Registry
-        if: steps.release_status.outputs.published == 'true'
-        run: ./mcp-publisher publish

package/.github/workflows/test.yml

@@ -1,20 +0,0 @@
-name: test
-
-on:
-  pull_request:
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          cache: 'npm'
-      - name: Install
-        run: npm ci
-      - name: Test
-        run: npm test

package/.github/workflows/watch-session-prs.yml

@@ -1,276 +0,0 @@
-name: Watch Session PRs
-
-on:
-  schedule:
-    - cron: '17 0 * * *'
-  workflow_dispatch:
-
-permissions:
-  contents: read
-  issues: write
-
-jobs:
-  watch-codex-fork:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Check Codex fork PR and update issue
-        uses: actions/github-script@v7
-        env:
-          UPSTREAM_OWNER: openai
-          UPSTREAM_REPO: codex
-          UPSTREAM_PR_NUMBER: '13537'
-          TARGET_ISSUE_NUMBER: '7'
-          COMMENT_MARKER: '<!-- codex-fork-pr-13537-status -->'
-          READY_LABEL: '[ready]'
-          STOP_LABEL: '[stop]'
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          script: |
-            const owner = process.env.UPSTREAM_OWNER;
-            const repo = process.env.UPSTREAM_REPO;
-            const pull_number = Number(process.env.UPSTREAM_PR_NUMBER);
-            const issue_number = Number(process.env.TARGET_ISSUE_NUMBER);
-            const marker = process.env.COMMENT_MARKER;
-            const readyLabel = process.env.READY_LABEL;
-            const stopLabel = process.env.STOP_LABEL;
-
-            const { data: pr } = await github.rest.pulls.get({ owner, repo, pull_number });
-            const desiredLabel = pr.merged_at ? readyLabel : stopLabel;
-            const staleLabel = pr.merged_at ? stopLabel : readyLabel;
-            const { data: issue } = await github.rest.issues.get({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number,
-            });
-
-            if (!issue.labels.some((label) => label.name === desiredLabel)) {
-              await github.rest.issues.addLabels({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number,
-                labels: [desiredLabel],
-              });
-              core.info(`Added label ${desiredLabel} to issue #${issue_number}.`);
-            }
-
-            if (issue.labels.some((label) => label.name === staleLabel)) {
-              try {
-                await github.rest.issues.removeLabel({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  issue_number,
-                  name: staleLabel,
-                });
-                core.info(`Removed label ${staleLabel} from issue #${issue_number}.`);
-              } catch (error) {
-                core.warning(`Failed to remove label ${staleLabel}: ${error.message}`);
-              }
-            }
-
-            core.summary
-              .addHeading('Codex PR status')
-              .addTable([
-                [
-                  { data: 'Field', header: true },
-                  { data: 'Value', header: true },
-                ],
-                ['PR', `${owner}/${repo}#${pr.number}`],
-                ['Title', pr.title],
-                ['State', pr.state],
-                ['Merged', pr.merged_at ? 'yes' : 'no'],
-                ['Merged at', pr.merged_at ?? 'not merged'],
-                ['Updated at', pr.updated_at],
-                ['URL', pr.html_url],
-              ]);
-
-            const comments = await github.paginate(github.rest.issues.listComments, {
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number,
-              per_page: 100,
-            });
-
-            const existingComment = comments.find((comment) => comment.body?.includes(marker));
-            const body = [
-              marker,
-              'upstream PR `openai/codex#13537` status watcher',
-              '',
-              `- PR: ${pr.html_url}`,
-              `- State: ${pr.state}`,
-              `- Merged: ${pr.merged_at ? 'yes' : 'no'}`,
-              `- Merged at: ${pr.merged_at ?? 'not merged'}`,
-              `- Updated at: ${pr.updated_at}`,
-              '',
-              pr.merged_at
-                ? 'This PR has been merged. `codex exec --fork <SESSION_ID> [PROMPT]` should become available once the change lands in the installed Codex version.'
-                : 'This PR is not merged yet. Non-interactive forking is still not available in released Codex builds.',
-              'A new session ID is expected when using `--fork`; `resume` itself continues the same session.',
-            ].join('\n');
-
-            if (existingComment?.body === body) {
-              core.info(`Issue #${issue_number} status comment is already up to date.`);
-              await core.summary.addRaw(`No update needed: ${existingComment.html_url}\n`).write();
-              return;
-            }
-
-            if (existingComment) {
-              const { data: comment } = await github.rest.issues.updateComment({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                comment_id: existingComment.id,
-                body,
-              });
-              core.info(`Updated issue #${issue_number}: ${comment.html_url}`);
-              await core.summary.addRaw(`Updated status comment: ${comment.html_url}\n`).write();
-              return;
-            }
-
-            const { data: comment } = await github.rest.issues.createComment({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number,
-              body,
-            });
-            core.info(`Created issue #${issue_number} status comment: ${comment.html_url}`);
-            await core.summary.addRaw(`Created status comment: ${comment.html_url}\n`).write();
-
-  watch-gemini-session-work:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Check Gemini session PRs and update issue
-        uses: actions/github-script@v7
-        env:
-          UPSTREAM_OWNER: google-gemini
-          UPSTREAM_REPO: gemini-cli
-          TARGET_ISSUE_NUMBER: '16'
-          COMMENT_MARKER: '<!-- gemini-session-pr-status -->'
-          WATCH_PR_NUMBERS: '17921,19629,19994'
-          READY_PR_NUMBERS: '17921,19629'
-          READY_LABEL: '[ready]'
-          STOP_LABEL: '[stop]'
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          script: |
-            const owner = process.env.UPSTREAM_OWNER;
-            const repo = process.env.UPSTREAM_REPO;
-            const issue_number = Number(process.env.TARGET_ISSUE_NUMBER);
-            const marker = process.env.COMMENT_MARKER;
-            const pullNumbers = process.env.WATCH_PR_NUMBERS.split(',').map((value) => Number(value.trim()));
-            const readyPullNumbers = process.env.READY_PR_NUMBERS.split(',').map((value) => Number(value.trim()));
-            const readyLabel = process.env.READY_LABEL;
-            const stopLabel = process.env.STOP_LABEL;
-
-            const pulls = await Promise.all(
-              pullNumbers.map(async (pull_number) => {
-                const { data: pr } = await github.rest.pulls.get({ owner, repo, pull_number });
-                return pr;
-              }),
-            );
-            const isReady = pulls.some((pr) => readyPullNumbers.includes(pr.number) && Boolean(pr.merged_at));
-            const desiredLabel = isReady ? readyLabel : stopLabel;
-            const staleLabel = isReady ? stopLabel : readyLabel;
-
-            const { data: issue } = await github.rest.issues.get({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number,
-            });
-
-            if (!issue.labels.some((label) => label.name === desiredLabel)) {
-              await github.rest.issues.addLabels({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number,
-                labels: [desiredLabel],
-              });
-              core.info(`Added label ${desiredLabel} to issue #${issue_number}.`);
-            }
-
-            if (issue.labels.some((label) => label.name === staleLabel)) {
-              try {
-                await github.rest.issues.removeLabel({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  issue_number,
-                  name: staleLabel,
-                });
-                core.info(`Removed label ${staleLabel} from issue #${issue_number}.`);
-              } catch (error) {
-                core.warning(`Failed to remove label ${staleLabel}: ${error.message}`);
-              }
-            }
-
-            const lines = pulls.flatMap((pr) => [
-              `- \`${owner}/${repo}#${pr.number}\` ${pr.title}`,
-              `  - State: ${pr.state}`,
-              `  - Merged: ${pr.merged_at ? 'yes' : 'no'}`,
-              `  - Merged at: ${pr.merged_at ?? 'not merged'}`,
-              `  - Updated at: ${pr.updated_at}`,
-              `  - URL: ${pr.html_url}`,
-            ]);
-
-            core.summary
-              .addHeading('Gemini PR status')
-              .addTable([
-                [
-                  { data: 'PR', header: true },
-                  { data: 'State', header: true },
-                  { data: 'Merged', header: true },
-                  { data: 'Updated at', header: true },
-                ],
-                ...pulls.map((pr) => [
-                  `${owner}/${repo}#${pr.number}`,
-                  pr.state,
-                  pr.merged_at ? 'yes' : 'no',
-                  pr.updated_at,
-                ]),
-              ]);
-
-            const comments = await github.paginate(github.rest.issues.listComments, {
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number,
-              per_page: 100,
-            });
-
-            const existingComment = comments.find((comment) => comment.body?.includes(marker));
-            const body = [
-              marker,
-              'upstream Gemini CLI session-related PR status watcher',
-              '',
-              'Tracked PRs:',
-              ...lines,
-              '',
-              'Interpretation:',
-              '- `#19994` is a fix for resumed session ID stats mismatch, not a fork/new-session feature.',
-              '- `#17921` is the `/new` command proposal for starting a fresh session while preserving the previous one.',
-              '- `#19629` is the `--session-id` proposal for explicit session UUID control.',
-              '- Even if these land, that still does not automatically imply Codex-style headless fork semantics from `--resume` alone.',
-            ].join('\n');
-
-            if (existingComment?.body === body) {
-              core.info(`Issue #${issue_number} Gemini status comment is already up to date.`);
-              await core.summary.addRaw(`No update needed: ${existingComment.html_url}\n`).write();
-              return;
-            }
-
-            if (existingComment) {
-              const { data: comment } = await github.rest.issues.updateComment({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                comment_id: existingComment.id,
-                body,
-              });
-              core.info(`Updated issue #${issue_number}: ${comment.html_url}`);
-              await core.summary.addRaw(`Updated status comment: ${comment.html_url}\n`).write();
-              return;
-            }
-
-            const { data: comment } = await github.rest.issues.createComment({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number,
-              body,
-            });
-            core.info(`Created issue #${issue_number} status comment: ${comment.html_url}`);
-            await core.summary.addRaw(`Created status comment: ${comment.html_url}\n`).write();

package/.husky/pre-commit

@@ -1 +0,0 @@
-npm run test:unit

package/.mcp.json

@@ -1,11 +0,0 @@
-{
-  "mcpServers": {
-    "acm-dev": {
-      "command": "npm",
-      "args": [
-        "run",
-        "dev"
-      ]
-    }
-  }
-}

package/.releaserc.json

@@ -1,18 +0,0 @@
-{
-  "branches": ["develop"],
-  "plugins": [
-    "@semantic-release/commit-analyzer",
-    "@semantic-release/release-notes-generator",
-    ["@semantic-release/changelog", {
-      "changelogFile": "CHANGELOG.md"
-    }],
-    "@semantic-release/npm",
-    ["@semantic-release/github", {
-      "assets": []
-    }],
-    ["@semantic-release/git", {
-      "assets": ["CHANGELOG.md", "package.json", "package-lock.json"],
-      "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
-    }]
-  ]
-}

package/.vscode/settings.json

@@ -1,3 +0,0 @@
-{
-    "git.ignoreLimitWarning": true
-}

package/CONTRIBUTING.md

@@ -1,81 +0,0 @@
-# Contributing
-
-## Development Setup
-
-```bash
-git clone https://github.com/mkXultra/ai-cli-mcp.git
-cd ai-cli-mcp
-npm install
-npm run build
-```
-
-## Testing
-
-```bash
-# Run all tests
-npm test
-
-# Unit tests only
-npm run test:unit
-
-# E2E tests (with mocks)
-npm run test:e2e
-
-# E2E tests locally (requires Claude CLI)
-npm run test:e2e:local
-
-# Watch mode
-npm run test:watch
-
-# Coverage
-npm run test:coverage
-```
-
-## Manual Testing with MCP Inspector
-
-```bash
-npm run build
-npx @modelcontextprotocol/inspector node dist/server.js
-```
-
-## CLI Direct Execution
-
-Run AI CLI tools directly from the terminal (foreground, no MCP server):
-
-```bash
-npm run -s cli.run -- --model sonnet --workFolder /tmp --prompt "hello"
-```
-
-See [docs/development.md](docs/development.md#cli-direct-execution-clirun) for full options.
-
-## Local Development with npm link
-
-```bash
-npm install
-npm run build
-npm link
-```
-
-Then use `ai-cli-mcp` command globally.
-
-## Environment Variables
-
-| Variable | Description |
-|----------|-------------|
-| `CLAUDE_CLI_NAME` | Claude CLI binary name or absolute path |
-| `CODEX_CLI_NAME` | Codex CLI binary name or absolute path |
-| `GEMINI_CLI_NAME` | Gemini CLI binary name or absolute path |
-| `MCP_CLAUDE_DEBUG` | Enable debug logging (`true`/`false`) |
-
-## Release Process
-
-See [docs/RELEASE_CHECKLIST.md](docs/RELEASE_CHECKLIST.md) for release instructions.
-
-Uses semantic-release with Conventional Commits:
-- `fix:` → patch release
-- `feat:` → minor release
-- `feat!:` or `BREAKING CHANGE:` → major release
-
-## License
-
-MIT