gms-mcp 0.1.17__tar.gz

gms_mcp-0.1.17/.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: CI
+
+on:
+  pull_request:
+    branches:
+      - "main"
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: test
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+          python -m pip install -U build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Run test suite
+        run: python cli/tests/python/run_all_tests.py
+
+      - name: Run final verification
+        run: python -m pytest cli/tests/python/test_final_verification.py
+

gms_mcp-0.1.17/.github/workflows/publish.yml

@@ -0,0 +1,123 @@
+name: Publish to PyPI
+
+concurrency:
+  group: pypi-publish
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+on:
+  push:
+    branches:
+      - "main"
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Publish a packaging-only post-release (example: 0.1.0.post1)"
+        required: false
+        type: string
+
+jobs:
+  compute:
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.ver.outputs.version }}
+      should_publish: ${{ steps.ver.outputs.should_publish }}
+      reason: ${{ steps.ver.outputs.reason }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install version tooling
+        run: python -m pip install -U packaging
+      - name: Compute version
+        id: ver
+        env:
+          VERSION_OVERRIDE: ${{ inputs.version }}
+        run: python scripts/ci_version.py
+      - name: Summary
+        run: |
+          echo "version=${{ steps.ver.outputs.version }}"
+          echo "should_publish=${{ steps.ver.outputs.should_publish }}"
+          echo "reason=${{ steps.ver.outputs.reason }}"
+
+  test:
+    name: Test (${{ matrix.os }}, Py${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install pytest
+          pip install -e .
+      - name: Run all tests
+        run: python cli/tests/python/run_all_tests.py
+      - name: Run final verification
+        run: python -m pytest cli/tests/python/test_final_verification.py
+
+  build:
+    needs: [compute, test]
+    if: needs.compute.outputs.should_publish == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install build tooling
+        run: python -m pip install -U build
+      - name: Build
+        env:
+          SETUPTOOLS_SCM_PRETEND_VERSION: ${{ needs.compute.outputs.version }}
+        run: python -m build
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*
+
+  publish:
+    needs: [compute, build]
+    if: needs.compute.outputs.should_publish == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+      - name: Verify PyPI project exists
+        shell: bash
+        run: |
+          set -euo pipefail
+          PROJECT="$(python3 -c 'import tomllib, pathlib; print(tomllib.load(pathlib.Path("pyproject.toml").open("rb"))["project"]["name"])')"
+          CODE="$(curl -sS -o /dev/null -w "%{http_code}" "https://pypi.org/pypi/${PROJECT}/json" || true)"
+          if [ "${CODE}" != "200" ]; then
+            echo "::error::PyPI project '${PROJECT}' does not exist yet (HTTP ${CODE})."
+            echo "::error::You must do the first upload manually (user identity) before Trusted Publishing can work."
+            echo "::error::Run scripts/first_pypi_upload.ps1 (Windows) or scripts/first_pypi_upload.sh (macOS/Linux)."
+            exit 1
+          fi
+      - name: Publish to PyPI (Trusted Publishing)
+        uses: pypa/gh-action-pypi-publish@release/v1

gms_mcp-0.1.17/.gitignore

@@ -0,0 +1,20 @@
+__pycache__/
+*.py[cod]
+*.pyo
+
+.venv/
+venv/
+.gms-mcp/
+
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+build/
+dist/
+*.egg-info/
+
+gamemaker/
+.vscode/settings.json
+.cursor/mcp.json
+.cursor/debug.log

gms_mcp-0.1.17/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [Unreleased]
+
+### Added
+- **Introspection Tools**: Implemented comprehensive project introspection tools including `gm_list_assets`, `gm_read_asset`, and `gm_search_references`. These tools support all GameMaker asset types, including **Extensions** and **Included Files (Datafiles)**.
+- **Asset Dependency Graph**: Added `gm_get_asset_graph` tool with both **Shallow** (structural metadata only) and **Deep** (full GML code parsing) modes for tracing relationships between objects, sprites, scripts, and more.
+- **MCP Resources**: Exposed addressable, cacheable project indices and graphs via MCP resources (`gms://project/index` and `gms://project/asset-graph`) for high-performance agent context loading.
+- **Project Statistics**: Added `gm_get_project_stats` for quick summaries of project asset counts by type.
+- **Project-Relative Debug Logging**: Debug logs are now normalized to `.gms_mcp/logs/debug.log` within the resolved project root, ensuring logs are captured correctly in both development and installed (`pipx`) environments.
+- **Purge Command**: Implemented the previously stubbed `purge` command. It now correctly identifies orphaned assets, respects `maintenance_keep.txt` and `--keep` patterns, and safely moves files to a timestamped `.maintenance_trash` folder with an automatically generated `MANIFEST.txt`.
+- **CI Test Suite**: Added a comprehensive CI test job to `publish.yml` that runs the full test suite and final verification across Linux and Windows on Python 3.11, 3.12, and 3.13, ensuring project stability before every build. Updated test runner to automatically create a minimal GameMaker project environment when running in clean CI environments.
+- **Coverage Tooling**: Wired up `pytest-cov` and added coverage reporting targets in `pyproject.toml`. Developers can now generate HTML and terminal coverage reports using `pytest`.
+
+### Fixed
+- **Output Encoding**: Corrected a bug in `utils.py` where the UTF-8 fallback wrapper failed to reassign `sys.stdout` and `sys.stderr` on older Windows systems, ensuring Unicode-safe console output.
+- **MCP Stdio Deadlocks**: Resolved "silent hangs" in Cursor by isolating subprocess stdin (`DEVNULL`) and disabling streaming logs (`ctx.log()`) during active execution.
+- **Windows Performance**: Defaulted to in-process execution for MCP tools, making them near-instant on Windows and bypassing shim/wrapper overhead.
+- **Asset Creation Defaults**: Assets created without an explicit `parent_path` now correctly default to the project root (mirroring GameMaker IDE behavior).
+- **Invalid Room Schema**: Fixed invalid JSON generation for room `.yy` files by ensuring all 8 view slots include required fields (`hborder`, `objectId`, etc.).
+- **FastMCP Parameter Conflict**: Renamed `constructor` parameter to `is_constructor` in `gm_create_script` to resolve internal naming conflicts in FastMCP.
+
+### Changed
+- **Execution Model Documentation**: Updated README and tool docstrings to align with the actual high-reliability subprocess execution model (standardizing on captured output and isolated stdin).
+- **Project Root Resolution**: Standardized environment variable support across MCP server and CLI tools. Both now consistently check for `GM_PROJECT_ROOT` followed by `PROJECT_ROOT`, improving consistency when running in different environments.
+- **Test Suite Logs**: Improved test output by clearly labeling expected errors during negative testing as `[EXPECTED ERROR]`, reducing confusion during CI runs.
+- MCP tools now default to `skip_maintenance=True` and `maintenance_verbose=False` for faster feedback loops.
+- `gm_maintenance_dedupe_resources` now defaults to `auto=True` to prevent interactive prompt hangs.
+- Removed legacy `test_mcp_streaming_runner.py` in favor of the more stable direct/non-streaming architecture.
+- CLI test suite now imports `gms_helpers` directly from `src` and uses module invocation, removing legacy shim modules.

gms_mcp-0.1.17/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Ampersand Game Studios
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

gms_mcp-0.1.17/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: gms-mcp
+Version: 0.1.17
+Summary: GameMaker CLI + MCP server toolset
+Author: Callum Lory, Ampersand Game Studios
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Ampersand-Game-Studios/gms-mcp
+Project-URL: Repository, https://github.com/Ampersand-Game-Studios/gms-mcp
+Project-URL: Issues, https://github.com/Ampersand-Game-Studios/gms-mcp/issues
+Keywords: gamemaker,mcp,cursor,cli,tools
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=9.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=6.0.0; extra == "dev"
+Dynamic: license-file
+
+# GameMaker MCP Tools
+
+This repo provides:
+- `gms`: a Python CLI for GameMaker project operations (asset creation, maintenance, runner, etc).
+- `gms-mcp`: an MCP server that exposes the same operations as MCP tools (Cursor is the primary example client).
+- **Introspection**: complete project inspection with support for all asset types (including extensions and datafiles).
+- **MCP Resources**: addressable project index and asset graph for high-performance agent context loading.
+- `gms-mcp-init`: generates shareable MCP config files for a workspace. Now auto-detects environment variables like `GMS_MCP_GMS_PATH` to include in the generated config.
+
+## Install (recommended: pipx)
+
+```powershell
+pipx install gms-mcp
+```
+
+## Local Development Setup
+
+If you are working on the `gms-mcp` codebase itself, follow these steps to set up a local development environment:
+
+1.  **Clone and install in editable mode**:
+    ```powershell
+    git checkout dev
+    pip install -e .
+    ```
+
+2.  **Initialize local and global MCP servers for testing**:
+    We recommend setting up two separate MCP server configurations in Cursor to test your changes:
+    
+    *   **Global (`gms-global`)**: For general use across all your GameMaker projects.
+    *   **Local (`gms-local`)**: Specifically for testing your current changes to the server.
+
+    Run these commands from the project root:
+    ```powershell
+    # Global setup (names it 'gms-global' in Cursor)
+    gms-mcp-init --cursor-global --server-name gms-global --mode python-module --python python --non-interactive
+
+    # Local setup (names it 'gms-local' in Cursor)
+    gms-mcp-init --cursor --server-name gms-local --mode python-module --python python --non-interactive
+    ```
+
+3.  **Verify in Cursor**:
+    Go to **Cursor Settings > Features > MCP** to see your new servers. You may need to click "Reload" or restart Cursor to see changes.
+
+## Publishing (maintainers)
+
+Publishing is automated via GitHub Actions (PyPI Trusted Publishing) on every push to `main` and on tags `v*`.
+See `RELEASING.md` for the one-time PyPI setup and the first manual upload helper scripts.
+
+## Use with a GameMaker project (multi-project friendly)
+
+Run this inside each GameMaker project workspace (or repo) to generate config:
+
+```powershell
+gms-mcp-init --cursor
+```
+
+This writes `.cursor/mcp.json` and attempts to auto-detect the `.yyp` location to set `GM_PROJECT_ROOT`.
+
+For a one-time setup that works across many projects, write Cursor's global config instead:
+
+```powershell
+gms-mcp-init --cursor-global
+```
+
+Generate example configs for other MCP-capable clients:
+
+```powershell
+gms-mcp-init --vscode --windsurf --antigravity
+```
+
+Or generate everything at once:
+
+```powershell
+gms-mcp-init --all
+```
+
+## Monorepos / multiple `.yyp`
+
+If multiple `.yyp` projects are detected in a workspace:
+- `gms-mcp-init` will warn and (when interactive) prompt you to pick one.
+- In non-interactive environments, it defaults `GM_PROJECT_ROOT` to `${workspaceFolder}` (safe).
+
+Force a specific project root:
+
+```powershell
+gms-mcp-init --cursor --gm-project-root path\\to\\project
+```
+
+Preview output without writing files:
+
+```powershell
+gms-mcp-init --cursor --dry-run
+```
+
+## Introspection Tools
+
+The MCP server provides comprehensive project introspection capabilities:
+
+### Asset Listing (`gm_list_assets`)
+List all assets in your project, optionally filtered by type:
+- **Supported types**: script, object, sprite, room, sound, font, shader, path, timeline, tileset, animcurve, sequence, note, folder, **extension**, **includedfile** (datafiles)
+
+### Asset Reading (`gm_read_asset`)
+Read the complete `.yy` JSON metadata for any asset by name or path.
+
+### Reference Search (`gm_search_references`)
+Search for patterns across project files with:
+- **Scopes**: `all`, `gml`, `yy`, `scripts`, `objects`, `extensions`, `datafiles`
+- **Modes**: literal string or regex
+- **Options**: case sensitivity, max results
+
+### Asset Graph (`gm_get_asset_graph`)
+Build a dependency graph of assets with two modes:
+- **Shallow (fast)**: Parses `.yy` files for structural references (parent objects, sprites, etc.)
+- **Deep (complete)**: Also scans all GML code for runtime references like `instance_create`, `sprite_index`, `audio_play_sound`, etc.
+
+### MCP Resources
+Pre-built, cacheable project data for agents:
+- `gms://project/index`: Complete project structure (assets, folders, room order, audio/texture groups, IDE version)
+- `gms://project/asset-graph`: Asset dependency graph
+- `gms://system/updates`: Returns a human-readable message if a newer version of `gms-mcp` is available on PyPI or GitHub.
+
+### Update Notifier
+The server automatically checks for updates on startup and during common operations:
+- **Tool**: `gm_check_updates` returns structured update info.
+- **Auto-check**: `gm_project_info` includes an `updates` field.
+- **Resource**: `gms://system/updates` provides a quick text status.
+
+## CLI usage
+
+Run from a project directory (or pass `--project-root`):
+
+```powershell
+gms --version
+gms --project-root . asset create script my_function --parent-path "folders/Scripts.yy"
+```

gms_mcp-0.1.17/README.md

@@ -0,0 +1,136 @@
+# GameMaker MCP Tools
+
+This repo provides:
+- `gms`: a Python CLI for GameMaker project operations (asset creation, maintenance, runner, etc).
+- `gms-mcp`: an MCP server that exposes the same operations as MCP tools (Cursor is the primary example client).
+- **Introspection**: complete project inspection with support for all asset types (including extensions and datafiles).
+- **MCP Resources**: addressable project index and asset graph for high-performance agent context loading.
+- `gms-mcp-init`: generates shareable MCP config files for a workspace. Now auto-detects environment variables like `GMS_MCP_GMS_PATH` to include in the generated config.
+
+## Install (recommended: pipx)
+
+```powershell
+pipx install gms-mcp
+```
+
+## Local Development Setup
+
+If you are working on the `gms-mcp` codebase itself, follow these steps to set up a local development environment:
+
+1.  **Clone and install in editable mode**:
+    ```powershell
+    git checkout dev
+    pip install -e .
+    ```
+
+2.  **Initialize local and global MCP servers for testing**:
+    We recommend setting up two separate MCP server configurations in Cursor to test your changes:
+    
+    *   **Global (`gms-global`)**: For general use across all your GameMaker projects.
+    *   **Local (`gms-local`)**: Specifically for testing your current changes to the server.
+
+    Run these commands from the project root:
+    ```powershell
+    # Global setup (names it 'gms-global' in Cursor)
+    gms-mcp-init --cursor-global --server-name gms-global --mode python-module --python python --non-interactive
+
+    # Local setup (names it 'gms-local' in Cursor)
+    gms-mcp-init --cursor --server-name gms-local --mode python-module --python python --non-interactive
+    ```
+
+3.  **Verify in Cursor**:
+    Go to **Cursor Settings > Features > MCP** to see your new servers. You may need to click "Reload" or restart Cursor to see changes.
+
+## Publishing (maintainers)
+
+Publishing is automated via GitHub Actions (PyPI Trusted Publishing) on every push to `main` and on tags `v*`.
+See `RELEASING.md` for the one-time PyPI setup and the first manual upload helper scripts.
+
+## Use with a GameMaker project (multi-project friendly)
+
+Run this inside each GameMaker project workspace (or repo) to generate config:
+
+```powershell
+gms-mcp-init --cursor
+```
+
+This writes `.cursor/mcp.json` and attempts to auto-detect the `.yyp` location to set `GM_PROJECT_ROOT`.
+
+For a one-time setup that works across many projects, write Cursor's global config instead:
+
+```powershell
+gms-mcp-init --cursor-global
+```
+
+Generate example configs for other MCP-capable clients:
+
+```powershell
+gms-mcp-init --vscode --windsurf --antigravity
+```
+
+Or generate everything at once:
+
+```powershell
+gms-mcp-init --all
+```
+
+## Monorepos / multiple `.yyp`
+
+If multiple `.yyp` projects are detected in a workspace:
+- `gms-mcp-init` will warn and (when interactive) prompt you to pick one.
+- In non-interactive environments, it defaults `GM_PROJECT_ROOT` to `${workspaceFolder}` (safe).
+
+Force a specific project root:
+
+```powershell
+gms-mcp-init --cursor --gm-project-root path\\to\\project
+```
+
+Preview output without writing files:
+
+```powershell
+gms-mcp-init --cursor --dry-run
+```
+
+## Introspection Tools
+
+The MCP server provides comprehensive project introspection capabilities:
+
+### Asset Listing (`gm_list_assets`)
+List all assets in your project, optionally filtered by type:
+- **Supported types**: script, object, sprite, room, sound, font, shader, path, timeline, tileset, animcurve, sequence, note, folder, **extension**, **includedfile** (datafiles)
+
+### Asset Reading (`gm_read_asset`)
+Read the complete `.yy` JSON metadata for any asset by name or path.
+
+### Reference Search (`gm_search_references`)
+Search for patterns across project files with:
+- **Scopes**: `all`, `gml`, `yy`, `scripts`, `objects`, `extensions`, `datafiles`
+- **Modes**: literal string or regex
+- **Options**: case sensitivity, max results
+
+### Asset Graph (`gm_get_asset_graph`)
+Build a dependency graph of assets with two modes:
+- **Shallow (fast)**: Parses `.yy` files for structural references (parent objects, sprites, etc.)
+- **Deep (complete)**: Also scans all GML code for runtime references like `instance_create`, `sprite_index`, `audio_play_sound`, etc.
+
+### MCP Resources
+Pre-built, cacheable project data for agents:
+- `gms://project/index`: Complete project structure (assets, folders, room order, audio/texture groups, IDE version)
+- `gms://project/asset-graph`: Asset dependency graph
+- `gms://system/updates`: Returns a human-readable message if a newer version of `gms-mcp` is available on PyPI or GitHub.
+
+### Update Notifier
+The server automatically checks for updates on startup and during common operations:
+- **Tool**: `gm_check_updates` returns structured update info.
+- **Auto-check**: `gm_project_info` includes an `updates` field.
+- **Resource**: `gms://system/updates` provides a quick text status.
+
+## CLI usage
+
+Run from a project directory (or pass `--project-root`):
+
+```powershell
+gms --version
+gms --project-root . asset create script my_function --parent-path "folders/Scripts.yy"
+```

gms_mcp-0.1.17/RELEASING.md

@@ -0,0 +1,52 @@
+# Releasing `gms-mcp`
+
+This project uses `setuptools-scm` + CI to control versions.
+
+Policy:
+- `main` publishes a **normal release** and bumps **patch** automatically (`X.Y.Z`).
+- `dev` publishes **dev releases** (`X.Y.(Z+1).devN`).
+- `prerelease` publishes **release candidates** (`X.Y.(Z+1)rcN`).
+- **Post releases** (`X.Y.Z.postN`) are **manual only** and intended for packaging/deployment fixes (not code changes).
+
+## One-time: install tooling
+
+```bash
+python -m pip install -U build twine
+```
+
+## Local build
+
+```bash
+python -m build
+```
+
+Artifacts are created in `dist/`.
+
+## First publish (manual)
+
+PyPI Trusted Publishing cannot create a brand-new project: the project must exist first.
+
+- Windows: `scripts/first_pypi_upload.ps1`
+- macOS/Linux: `scripts/first_pypi_upload.sh`
+
+These scripts build, validate, and upload from `dist/` using a PyPI API token.
+
+## Ongoing publishes (automated): GitHub Trusted Publishing
+
+Once the project exists on PyPI (name is `gms-mcp`, shown as `GMS-MCP` on PyPI), configure a Trusted Publisher:
+
+1. On PyPI, open the project settings for `GMS-MCP`.
+2. Add a Trusted Publisher for:
+   - Owner: `Ampersand-Game-Studios`
+   - Repository: `gms-mcp`
+   - Workflow: `.github/workflows/publish.yml`
+   - Environment: (leave blank unless you use one)
+3. Push to `main` to publish a post-release automatically, or push a version tag like `v0.1.0` to set a new base version.
+
+Notes:
+- The GitHub Actions workflow publishes on every push to `main` (as requested). This will create many versions on PyPI.
+- If you want fewer releases, change the workflow trigger to tags-only.
+
+## Manual post-release (packaging fix only)
+
+Use GitHub Actions `workflow_dispatch` for `Publish to PyPI` and provide an explicit version like `0.1.0.post1`.

gms_mcp-0.1.17/cli/__init__.py

@@ -0,0 +1 @@
+# CLI support utilities live under this directory.

gms_mcp-0.1.17/cli/agent_setup.py

@@ -0,0 +1,32 @@
+#!/usr/bin/env python3
+"""
+Convenience entrypoint for setting up the `gms` command.
+
+For releases, prefer `gms` and `gms-mcp-init` entrypoints.
+"""
+
+from pathlib import Path
+import sys
+
+HERE = Path(__file__).resolve().parent
+REPO_ROOT = HERE.parent
+SRC = REPO_ROOT / "src"
+if str(SRC) not in sys.path:
+    sys.path.insert(0, str(SRC))
+
+# Re-export the full implementation so `import agent_setup` behaves like the
+# original module (some tests/importers expect helper functions to exist).
+from gms_helpers.agent_setup import *  # type: ignore  # noqa: F403,E402
+from gms_helpers.agent_setup import main as _main  # noqa: E402
+
+if __name__ == "__main__":
+    raise SystemExit(0 if _main() else 1)
+
+
+
+
+
+
+
+
+