runspec-gitlab 0.1.0__tar.gz → 0.2.1__tar.gz

runspec_gitlab-0.2.1/CHANGELOG.md

@@ -0,0 +1,54 @@
+# Changelog
+
+All notable changes to `runspec-gitlab` are documented here.
+
+## [0.2.1] — 2026-09-20
+
+### Changed
+
+- **Packaging metadata for the runspec-console Marketplace.** Add a README
+  (rendered in the Marketplace card's Details view) and publish `keywords`
+  and Documentation / Source / Changelog / Issues project URLs, so the
+  package's Marketplace card shows a description, tags and links. No
+  runnable, argument, or behaviour changes.
+
+## [0.2.0]
+
+Reconciled the verb set against GitLab's canonical MCP tool registry
+(`app/services/mcp/tools/manager.rb` + the `route_setting :mcp` declarations in
+the REST route files) and closed the gaps. **17 read verbs** now (all
+`autonomy = "autonomous"`).
+
+- **Renamed** `get-merge-request-changes` → `get-merge-request-diffs` — matches
+  the canonical `get_merge_request_diffs` tool and its `/diffs` endpoint; the old
+  verb used the deprecated `/changes` endpoint. **Breaking** vs 0.1.0.
+- **Added** canonical MR read tools: `get-merge-request-commits`,
+  `get-merge-request-notes`, `get-merge-request-pipelines`,
+  `get-merge-request-conflicts`.
+- `get-merge-request-conflicts` is **best-effort** — GitLab has no public
+  `/api/v4` conflicts endpoint (its MCP server calls an internal service in
+  process), so it relays the non-public web-UI endpoint
+  (`/{project}/-/merge_requests/:iid/conflicts`) and returns its JSON verbatim;
+  the shape is GitLab's and may change between versions.
+- Docs now separate the canonical 1:1 ports from the extra REST reads GitLab has
+  no MCP tool for (`whoami`, `get-project`, `search-projects`, `list-issues`,
+  `get-file`, `list-tree`).
+- Requires `runspec-gitlab-core >= 0.2.0`.
+
+## [0.1.0]
+
+Initial release. One runnable, `gitlab`, with a read verb per tool of the
+[GitLab MCP server](https://docs.gitlab.com/user/model_context_protocol/mcp_server/),
+**ported onto the GitLab REST API (v4)** rather than proxying that server — so it
+runs over the runspec-console SSH fleet with no extra process. `runspec serve`
+re-expands each verb into its own leaf MCP tool (`gitlab_get-issue`,
+`gitlab_list-pipelines`, …).
+
+- Verbs (all `autonomy = "autonomous"` — read-only): `whoami`, `get-project`,
+  `search-projects`, `list-issues`, `get-issue`, `list-merge-requests`,
+  `get-merge-request`, `get-merge-request-changes`, `list-pipelines`,
+  `get-pipeline-jobs`, `get-job-log`, `get-file`, `list-tree`.
+- Global `--env` (dev/uat/prod) selects `GITLAB_<ENV>_*` env vars; auth is
+  `GITLAB_URL` (default `https://gitlab.com`) + `GITLAB_TOKEN`. `project` accepts
+  a numeric id or `group/project` path and falls back to `GITLAB_PROJECT`.
+- Thin wrapper over `runspec-gitlab-core` (the dependency-free REST logic core).

runspec_gitlab-0.2.1/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.5
+Name: runspec-gitlab
+Version: 0.2.1
+Summary: GitLab read runnable for runspec — issues, merge requests, pipelines, and repository reads, ported from the GitLab MCP server
+Project-URL: Documentation, https://runspec.app/
+Project-URL: Source, https://github.com/jasonfinestone/runspec/tree/main/packages/python/runspec-gitlab
+Project-URL: Changelog, https://github.com/jasonfinestone/runspec/blob/main/packages/python/runspec-gitlab/CHANGELOG.md
+Project-URL: Issues, https://github.com/jasonfinestone/runspec/issues
+Keywords: gitlab,mcp,runnable,runspec
+Requires-Python: >=3.10
+Requires-Dist: runspec-gitlab-core>=0.2.0
+Requires-Dist: runspec>=0.44.0
+Provides-Extra: dev
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff==0.15.20; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# runspec-gitlab
+
+A read-only GitLab runnable for [runspec](https://pypi.org/project/runspec/),
+ported onto the GitLab REST API (v4) — **not** proxying GitLab's hosted MCP
+server. One runnable — **`gitlab`** — with 17 read verbs, all `autonomy =
+"autonomous"`. `pip install` it into a venv and it's discoverable by `runspec
+local`, `runspec serve` (MCP), and runspec-console.
+
+`runspec serve` flattens each verb into a leaf MCP tool (`gitlab_get-issue`, …).
+Verb names are reconciled against GitLab's canonical MCP tool registry; the
+extras (`whoami`, `get-project`, `search-projects`, `list-issues`, `get-file`,
+`list-tree`) are useful REST reads GitLab has no MCP tool for.
+
+## Install
+
+```
+pip install runspec-gitlab
+```
+
+## Verbs
+
+| Area | Verbs |
+|---|---|
+| Account / project | `whoami`, `get-project`, `search-projects`, `get-file`, `list-tree` |
+| Issues | `list-issues`, `get-issue` |
+| Merge requests | `list-merge-requests`, `get-merge-request`, `get-merge-request-diffs`, `get-merge-request-commits`, `get-merge-request-notes`, `get-merge-request-pipelines`, `get-merge-request-conflicts` |
+| Pipelines | `list-pipelines`, `get-pipeline-jobs`, `get-job-log` |
+
+`get-merge-request-conflicts` is best-effort — GitLab has no public `/api/v4`
+conflicts endpoint, so it relays the web-UI endpoint and returns its JSON
+verbatim.
+
+## Auth — env vars only
+
+```
+export GITLAB_URL=https://gitlab.example.com        # default https://gitlab.com
+export GITLAB_TOKEN=<personal-or-project-access-token>
+export GITLAB_PROJECT=group/subgroup/project        # optional default
+```
+
+Every verb takes `--env`, selecting `GITLAB_<ENV>_*` prefixed vars. `--project`
+accepts a numeric id or a `group/project` path and falls back to
+`GITLAB_PROJECT`.
+
+```
+gitlab whoami
+gitlab list-merge-requests --project group/app --state opened
+gitlab get-job-log --project group/app --job-id 998877
+```
+
+## Public Python API
+
+The pure logic is in **[`runspec-gitlab-core`](../runspec-gitlab-core)** —
+`httpx`-only, no `runspec` dependency, no entry points. Every op takes a
+`GitlabConfig` first arg and raises `GitlabError`, so a private wrapper can
+inject credentials and bake in a default `project` / `env`:
+
+```python
+from runspec_gitlab_core import config_from_env, get_issue, list_merge_requests
+
+cfg = config_from_env(env="prod")
+mrs = list_merge_requests(cfg, state="opened")
+```
+
+## Development
+
+```
+python -m venv .venv && . .venv/bin/activate
+pip install -e ".[dev]"
+ruff check . && ruff format --check .
+pytest
+```

runspec_gitlab-0.2.1/README.md

@@ -0,0 +1,72 @@
+# runspec-gitlab
+
+A read-only GitLab runnable for [runspec](https://pypi.org/project/runspec/),
+ported onto the GitLab REST API (v4) — **not** proxying GitLab's hosted MCP
+server. One runnable — **`gitlab`** — with 17 read verbs, all `autonomy =
+"autonomous"`. `pip install` it into a venv and it's discoverable by `runspec
+local`, `runspec serve` (MCP), and runspec-console.
+
+`runspec serve` flattens each verb into a leaf MCP tool (`gitlab_get-issue`, …).
+Verb names are reconciled against GitLab's canonical MCP tool registry; the
+extras (`whoami`, `get-project`, `search-projects`, `list-issues`, `get-file`,
+`list-tree`) are useful REST reads GitLab has no MCP tool for.
+
+## Install
+
+```
+pip install runspec-gitlab
+```
+
+## Verbs
+
+| Area | Verbs |
+|---|---|
+| Account / project | `whoami`, `get-project`, `search-projects`, `get-file`, `list-tree` |
+| Issues | `list-issues`, `get-issue` |
+| Merge requests | `list-merge-requests`, `get-merge-request`, `get-merge-request-diffs`, `get-merge-request-commits`, `get-merge-request-notes`, `get-merge-request-pipelines`, `get-merge-request-conflicts` |
+| Pipelines | `list-pipelines`, `get-pipeline-jobs`, `get-job-log` |
+
+`get-merge-request-conflicts` is best-effort — GitLab has no public `/api/v4`
+conflicts endpoint, so it relays the web-UI endpoint and returns its JSON
+verbatim.
+
+## Auth — env vars only
+
+```
+export GITLAB_URL=https://gitlab.example.com        # default https://gitlab.com
+export GITLAB_TOKEN=<personal-or-project-access-token>
+export GITLAB_PROJECT=group/subgroup/project        # optional default
+```
+
+Every verb takes `--env`, selecting `GITLAB_<ENV>_*` prefixed vars. `--project`
+accepts a numeric id or a `group/project` path and falls back to
+`GITLAB_PROJECT`.
+
+```
+gitlab whoami
+gitlab list-merge-requests --project group/app --state opened
+gitlab get-job-log --project group/app --job-id 998877
+```
+
+## Public Python API
+
+The pure logic is in **[`runspec-gitlab-core`](../runspec-gitlab-core)** —
+`httpx`-only, no `runspec` dependency, no entry points. Every op takes a
+`GitlabConfig` first arg and raises `GitlabError`, so a private wrapper can
+inject credentials and bake in a default `project` / `env`:
+
+```python
+from runspec_gitlab_core import config_from_env, get_issue, list_merge_requests
+
+cfg = config_from_env(env="prod")
+mrs = list_merge_requests(cfg, state="opened")
+```
+
+## Development
+
+```
+python -m venv .venv && . .venv/bin/activate
+pip install -e ".[dev]"
+ruff check . && ruff format --check .
+pytest
+```

{runspec_gitlab-0.1.0 → runspec_gitlab-0.2.1}/pyproject.toml

@@ -4,16 +4,24 @@ build-backend = "hatchling.build"
 
 [project]
 name = "runspec-gitlab"
-version = "0.1.0"
+version = "0.2.1"
 requires-python = ">=3.10"
 description = "GitLab read runnable for runspec — issues, merge requests, pipelines, and repository reads, ported from the GitLab MCP server"
+readme = "README.md"
+keywords = ["runspec", "runnable", "gitlab", "mcp"]
 dependencies = [
     # 0.44.0 surfaces inherited args (the global --env) on each leaf subcommand's
     # MCP tool via `runspec serve`.
     "runspec>=0.44.0",
-    "runspec-gitlab-core>=0.1.0",
+    "runspec-gitlab-core>=0.2.0",
 ]
 
+[project.urls]
+Documentation = "https://runspec.app/"
+Source        = "https://github.com/jasonfinestone/runspec/tree/main/packages/python/runspec-gitlab"
+Changelog     = "https://github.com/jasonfinestone/runspec/blob/main/packages/python/runspec-gitlab/CHANGELOG.md"
+Issues        = "https://github.com/jasonfinestone/runspec/issues"
+
 [project.scripts]
 # Entry point name MUST match the runnable name in runspec.toml (`gitlab`).
 gitlab = "runspec_gitlab.cli:main"

{runspec_gitlab-0.1.0 → runspec_gitlab-0.2.1}/runspec_gitlab/__init__.py

@@ -20,7 +20,11 @@ from runspec_gitlab_core import (
     get_issue,
     get_job_log,
     get_merge_request,
-    get_merge_request_changes,
+    get_merge_request_commits,
+    get_merge_request_conflicts,
+    get_merge_request_diffs,
+    get_merge_request_notes,
+    get_merge_request_pipelines,
     get_pipeline_jobs,
     get_project,
     gitlab_request,
@@ -45,7 +49,11 @@ __all__ = [
     "get_issue",
     "list_merge_requests",
     "get_merge_request",
-    "get_merge_request_changes",
+    "get_merge_request_diffs",
+    "get_merge_request_commits",
+    "get_merge_request_notes",
+    "get_merge_request_pipelines",
+    "get_merge_request_conflicts",
     "list_pipelines",
     "get_pipeline_jobs",
     "get_job_log",

{runspec_gitlab-0.1.0 → runspec_gitlab-0.2.1}/runspec_gitlab/cli.py

@@ -24,7 +24,11 @@ from runspec_gitlab_core import (
     get_issue,
     get_job_log,
     get_merge_request,
-    get_merge_request_changes,
+    get_merge_request_commits,
+    get_merge_request_conflicts,
+    get_merge_request_diffs,
+    get_merge_request_notes,
+    get_merge_request_pipelines,
     get_pipeline_jobs,
     get_project,
     list_issues,
@@ -79,8 +83,41 @@ def _dispatch(spec: rs.RunSpec, config: GitlabConfig) -> Any:
         )
     if command == "get-merge-request":
         return get_merge_request(config, mr_iid=spec.mr_iid.value, project=spec.project.value)
-    if command == "get-merge-request-changes":
-        return get_merge_request_changes(config, mr_iid=spec.mr_iid.value, project=spec.project.value)
+    if command == "get-merge-request-diffs":
+        return get_merge_request_diffs(
+            config,
+            mr_iid=spec.mr_iid.value,
+            project=spec.project.value,
+            per_page=spec.per_page.value,
+            page=spec.page.value,
+        )
+    if command == "get-merge-request-commits":
+        return get_merge_request_commits(
+            config,
+            mr_iid=spec.mr_iid.value,
+            project=spec.project.value,
+            per_page=spec.per_page.value,
+            page=spec.page.value,
+        )
+    if command == "get-merge-request-notes":
+        return get_merge_request_notes(
+            config,
+            mr_iid=spec.mr_iid.value,
+            project=spec.project.value,
+            sort=spec.sort.value,
+            per_page=spec.per_page.value,
+            page=spec.page.value,
+        )
+    if command == "get-merge-request-pipelines":
+        return get_merge_request_pipelines(
+            config,
+            mr_iid=spec.mr_iid.value,
+            project=spec.project.value,
+            per_page=spec.per_page.value,
+            page=spec.page.value,
+        )
+    if command == "get-merge-request-conflicts":
+        return get_merge_request_conflicts(config, mr_iid=spec.mr_iid.value, project=spec.project.value)
     if command == "list-pipelines":
         return list_pipelines(
             config,

{runspec_gitlab-0.1.0 → runspec_gitlab-0.2.1}/runspec_gitlab/runspec.toml

@@ -98,10 +98,50 @@ autonomy = "autonomous"
 project = {type = "str", short = "-p", required = false, description = "Project id or path (falls back to GITLAB_PROJECT)"}
 mr-iid = {type = "int", required = true, description = "Merge request internal id (the !N shown in the UI)"}
 
-[gitlab.commands.get-merge-request-changes]
-description = "Fetch a merge request together with its file changes / diffs"
+[gitlab.commands.get-merge-request-diffs]
+description = "List a merge request's file diffs (the canonical get_merge_request_diffs tool)"
 autonomy = "autonomous"
-[gitlab.commands.get-merge-request-changes.args]
+[gitlab.commands.get-merge-request-diffs.args]
+project = {type = "str", short = "-p", required = false, description = "Project id or path (falls back to GITLAB_PROJECT)"}
+mr-iid = {type = "int", required = true, description = "Merge request internal id (the !N shown in the UI)"}
+per-page = {type = "int", default = 20, description = "Results per page (GitLab caps at 100)"}
+page = {type = "int", default = 1, description = "Page number"}
+
+[gitlab.commands.get-merge-request-commits]
+description = "List the commits on a merge request (canonical get_merge_request_commits)"
+autonomy = "autonomous"
+[gitlab.commands.get-merge-request-commits.args]
+project = {type = "str", short = "-p", required = false, description = "Project id or path (falls back to GITLAB_PROJECT)"}
+mr-iid = {type = "int", required = true, description = "Merge request internal id (the !N shown in the UI)"}
+per-page = {type = "int", default = 20, description = "Results per page (GitLab caps at 100)"}
+page = {type = "int", default = 1, description = "Page number"}
+
+[gitlab.commands.get-merge-request-notes]
+description = "List a merge request's notes/comments (canonical get_merge_request_notes)"
+autonomy = "autonomous"
+[gitlab.commands.get-merge-request-notes.args]
+project = {type = "str", short = "-p", required = false, description = "Project id or path (falls back to GITLAB_PROJECT)"}
+mr-iid = {type = "int", required = true, description = "Merge request internal id (the !N shown in the UI)"}
+sort = {type = "choice", options = ["asc", "desc"], required = false, description = "Sort order by created date"}
+per-page = {type = "int", default = 20, description = "Results per page (GitLab caps at 100)"}
+page = {type = "int", default = 1, description = "Page number"}
+
+[gitlab.commands.get-merge-request-pipelines]
+description = "List the pipelines run for a merge request (canonical get_merge_request_pipelines)"
+autonomy = "autonomous"
+[gitlab.commands.get-merge-request-pipelines.args]
+project = {type = "str", short = "-p", required = false, description = "Project id or path (falls back to GITLAB_PROJECT)"}
+mr-iid = {type = "int", required = true, description = "Merge request internal id (the !N shown in the UI)"}
+per-page = {type = "int", default = 20, description = "Results per page (GitLab caps at 100)"}
+page = {type = "int", default = 1, description = "Page number"}
+
+[gitlab.commands.get-merge-request-conflicts]
+# Best-effort: GitLab has no public /api/v4 conflicts endpoint — this relays
+# the non-public web-UI endpoint (/{project}/-/merge_requests/:iid/conflicts),
+# so the response shape is GitLab's and may change between versions.
+description = "Fetch a merge request's conflict files (best-effort; relays GitLab's non-public web conflicts endpoint)"
+autonomy = "autonomous"
+[gitlab.commands.get-merge-request-conflicts.args]
 project = {type = "str", short = "-p", required = false, description = "Project id or path (falls back to GITLAB_PROJECT)"}
 mr-iid = {type = "int", required = true, description = "Merge request internal id (the !N shown in the UI)"}
 

{runspec_gitlab-0.1.0 → runspec_gitlab-0.2.1}/tests/test_cli.py

@@ -64,6 +64,18 @@ def test_dispatch_get_job_log_tail(monkeypatch) -> None:
     assert result["truncated"] is True
 
 
+def test_dispatch_mr_conflicts_uses_web_endpoint(monkeypatch) -> None:
+    seen = _capture(monkeypatch, httpx.Response(200, json={"files": []}))
+    h = _harness()
+    spec = h.expect_ok(["get-merge-request-conflicts", "--project", "grp/app", "--mr-iid", "3"])
+    result = cli._dispatch(spec, CFG)
+    h.close()
+    assert result == {"files": []}
+    # non-public web endpoint, not /api/v4
+    assert seen["path"] == "/grp/app/-/merge_requests/3/conflicts"
+    assert "/api/v4" not in seen["path"]
+
+
 def test_dispatch_whoami(monkeypatch) -> None:
     seen = _capture(monkeypatch, httpx.Response(200, json={"username": "alice"}))
     h = _harness()

runspec_gitlab-0.1.0/CHANGELOG.md

@@ -1,21 +0,0 @@
-# Changelog
-
-All notable changes to `runspec-gitlab` are documented here.
-
-## [0.1.0]
-
-Initial release. One runnable, `gitlab`, with a read verb per tool of the
-[GitLab MCP server](https://docs.gitlab.com/user/model_context_protocol/mcp_server/),
-**ported onto the GitLab REST API (v4)** rather than proxying that server — so it
-runs over the runspec-console SSH fleet with no extra process. `runspec serve`
-re-expands each verb into its own leaf MCP tool (`gitlab_get-issue`,
-`gitlab_list-pipelines`, …).
-
-- Verbs (all `autonomy = "autonomous"` — read-only): `whoami`, `get-project`,
-  `search-projects`, `list-issues`, `get-issue`, `list-merge-requests`,
-  `get-merge-request`, `get-merge-request-changes`, `list-pipelines`,
-  `get-pipeline-jobs`, `get-job-log`, `get-file`, `list-tree`.
-- Global `--env` (dev/uat/prod) selects `GITLAB_<ENV>_*` env vars; auth is
-  `GITLAB_URL` (default `https://gitlab.com`) + `GITLAB_TOKEN`. `project` accepts
-  a numeric id or `group/project` path and falls back to `GITLAB_PROJECT`.
-- Thin wrapper over `runspec-gitlab-core` (the dependency-free REST logic core).

runspec_gitlab-0.1.0/PKG-INFO

@@ -1,11 +0,0 @@
-Metadata-Version: 2.4
-Name: runspec-gitlab
-Version: 0.1.0
-Summary: GitLab read runnable for runspec — issues, merge requests, pipelines, and repository reads, ported from the GitLab MCP server
-Requires-Python: >=3.10
-Requires-Dist: runspec-gitlab-core>=0.1.0
-Requires-Dist: runspec>=0.44.0
-Provides-Extra: dev
-Requires-Dist: mypy; extra == 'dev'
-Requires-Dist: pytest>=8.0; extra == 'dev'
-Requires-Dist: ruff==0.15.20; extra == 'dev'