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

runspec_gitlab-0.2.0/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Changelog
+
+All notable changes to `runspec-gitlab` are documented here.
+
+## [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.1.0 → runspec_gitlab-0.2.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: runspec-gitlab
-Version: 0.1.0
+Version: 0.2.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-gitlab-core>=0.2.0
 Requires-Dist: runspec>=0.44.0
 Provides-Extra: dev
 Requires-Dist: mypy; extra == 'dev'

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

@@ -4,14 +4,14 @@ build-backend = "hatchling.build"
 
 [project]
 name = "runspec-gitlab"
-version = "0.1.0"
+version = "0.2.0"
 requires-python = ">=3.10"
 description = "GitLab read runnable for runspec — issues, merge requests, pipelines, and repository reads, ported from the GitLab MCP server"
 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.scripts]

{runspec_gitlab-0.1.0 → runspec_gitlab-0.2.0}/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.0}/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.0}/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.0}/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).