@simplysf/simply-gitlab 0.9.0 → 0.10.0

package/oclif.manifest.json

@@ -1546,13 +1546,16 @@
         "view:file:gitlab"
       ]
     },
-    "gitlab:mr:create": {
+    "gitlab:project:create": {
       "aliases": [],
       "args": {},
-      "description": "Both branches must already exist on the project. --draft prefixes the title with \"Draft: \", which is how GitLab itself marks a draft; there is no separate field for it.\n\nAssignees and reviewers are numeric user ids, not usernames — GitLab accepts only ids here. --body or --body-file supplies raw JSON for anything the flags do not cover, such as approval rules. Use --dry-run to see exactly what would be sent.",
+      "description": "Creates the project in --namespace, or in the namespace of the token owner when none is given. Give it --name or --path; GitLab derives whichever one is missing.\n\n--template names one of the built-in templates GitLab ships, such as express or rails. To create from a custom template instead, add --custom-template for one the instance administrator registered, --template-group for one in a group, or use --template-project to name the template project itself by id or path — which GitLab prefers, because a name can be ambiguous. Add --template-group to --template-project when the template belongs to a group rather than the instance. Custom templates need a Premium or Ultimate instance.\n\nA template is applied asynchronously: this command returns as soon as the project record exists, with an import status of \"scheduled\", and the files arrive a few seconds later. Check \"project view\" until its import_status reads \"finished\" before writing to the repository. --dry-run prints the exact request body; a namespace or template given as a path is still looked up, so the printed ids are the ones that would be sent.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --project group/project --source-branch feature --target-branch main --title \"feat: the thing\"",
-        "<%= config.bin %> <%= command.id %> --project group/project --source-branch feature --target-branch main --title wip --draft --squash"
+        "<%= config.bin %> <%= command.id %> --name new-service --namespace platform/apps",
+        "<%= config.bin %> <%= command.id %> --name new-service --namespace platform/apps --template express --visibility internal",
+        "<%= config.bin %> <%= command.id %> --name new-service --namespace platform/apps --template service-skeleton --template-group platform/templates",
+        "<%= config.bin %> <%= command.id %> --path new-service --template-project platform/templates/service-skeleton --dry-run",
+        "<%= config.bin %> <%= command.id %> --name new-service --template-project platform/templates/service-skeleton --template-group platform/templates"
       ],
       "flags": {
         "json": {
@@ -1590,92 +1593,96 @@
           "multiple": false,
           "type": "option"
         },
-        "project": {
-          "char": "p",
-          "env": "GITLAB_PROJECT",
-          "name": "project",
-          "required": true,
-          "summary": "Project id, or its full path such as group/subgroup/project.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "dry-run": {
           "name": "dry-run",
           "summary": "Print the request that would be sent and exit without sending it.",
           "allowNo": false,
           "type": "boolean"
         },
-        "source-branch": {
-          "name": "source-branch",
-          "summary": "Branch holding the changes.",
+        "name": {
+          "name": "name",
+          "summary": "Project name. The path is derived from it when --path is not given.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "target-branch": {
-          "name": "target-branch",
-          "summary": "Branch the changes are proposed for.",
+        "path": {
+          "name": "path",
+          "summary": "Repository path, the URL slug. The name is derived from it when --name is not given.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "title": {
-          "name": "title",
-          "summary": "Merge request title.",
+        "namespace": {
+          "description": "Defaults to the namespace of the token owner.",
+          "name": "namespace",
+          "summary": "Group or user namespace to create the project in, by id or full path.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "description": {
           "name": "description",
-          "summary": "Merge request description, as Markdown.",
+          "summary": "Project description.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "draft": {
-          "name": "draft",
-          "summary": "Open it as a draft.",
-          "allowNo": false,
-          "type": "boolean"
+        "visibility": {
+          "name": "visibility",
+          "summary": "Who can see the project.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "private",
+            "internal",
+            "public"
+          ],
+          "type": "option"
         },
-        "squash": {
-          "name": "squash",
-          "summary": "Squash the commits when it merges.",
-          "allowNo": false,
-          "type": "boolean"
+        "default-branch": {
+          "name": "default-branch",
+          "summary": "Name of the default branch.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "remove-source-branch": {
-          "name": "remove-source-branch",
-          "summary": "Delete the source branch on merge.",
+        "initialize-with-readme": {
+          "name": "initialize-with-readme",
+          "summary": "Create a first commit holding a README, so the repository is not empty.",
           "allowNo": false,
           "type": "boolean"
         },
-        "assignee-id": {
-          "name": "assignee-id",
-          "summary": "User id to assign. Repeatable.",
+        "topics": {
+          "name": "topics",
+          "summary": "Comma-separated topics to label the project with.",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "reviewer-id": {
-          "name": "reviewer-id",
-          "summary": "User id to request review from. Repeatable.",
+        "template": {
+          "name": "template",
+          "summary": "Template to create from: a built-in name, or with --custom-template or --template-group a custom one.",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "labels": {
-          "name": "labels",
-          "summary": "Comma-separated labels to apply.",
+        "custom-template": {
+          "name": "custom-template",
+          "summary": "Look --template up among the instance's custom project templates rather than the built-in ones.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "template-group": {
+          "name": "template-group",
+          "summary": "Group whose custom project templates --template or --template-project names, by id or full path.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "milestone-id": {
-          "name": "milestone-id",
-          "summary": "Milestone id to attach.",
+        "template-project": {
+          "name": "template-project",
+          "summary": "Custom template project to create from, by id or full path. Cannot be combined with --template.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1700,12 +1707,12 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:mr:create",
+      "id": "gitlab:project:create",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "Open a merge request.",
+      "summary": "Create a project, blank or from a template.",
       "enableJsonFlag": true,
       "isWrite": true,
       "isESM": true,
@@ -1713,27 +1720,27 @@
         "lib",
         "commands",
         "gitlab",
-        "mr",
+        "project",
         "create.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:mr:create",
-        "mr:gitlab:create",
-        "mr:create:gitlab",
-        "gitlab:create:mr",
-        "create:gitlab:mr",
-        "create:mr:gitlab"
+        "gitlab:project:create",
+        "project:gitlab:create",
+        "project:create:gitlab",
+        "gitlab:create:project",
+        "create:gitlab:project",
+        "create:project:gitlab"
       ]
     },
-    "gitlab:mr:list": {
+    "gitlab:project:list": {
       "aliases": [],
       "args": {},
-      "description": "Defaults to open merge requests, which is what a list is nearly always for; pass --state all to include closed and merged ones. The IID column is the number to pass to the other mr commands — it is per-project, and is not the \"id\" field in the JSON payload.",
+      "description": "Without --search this lists every project the token can reach, newest activity first, which on a large instance is not a useful answer — narrow it with --search or --membership. Use --simple for a much smaller payload when you only need ids and paths.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --project group/project",
-        "<%= config.bin %> <%= command.id %> --project group/project --state merged --target-branch main --limit 10",
-        "<%= config.bin %> <%= command.id %> --project group/project --author-username someone --json"
+        "<%= config.bin %> <%= command.id %> --membership",
+        "<%= config.bin %> <%= command.id %> --search platform --limit 10",
+        "<%= config.bin %> <%= command.id %> --search platform --simple --json"
       ],
       "flags": {
         "json": {
@@ -1771,90 +1778,48 @@
           "multiple": false,
           "type": "option"
         },
-        "project": {
-          "char": "p",
-          "env": "GITLAB_PROJECT",
-          "name": "project",
-          "required": true,
-          "summary": "Project id, or its full path such as group/subgroup/project.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "limit": {
           "name": "limit",
-          "summary": "Maximum number of merge requests to return across all pages.",
+          "summary": "Maximum number of projects to return across all pages.",
           "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "state": {
-          "name": "state",
-          "summary": "Merge request state to return.",
-          "default": "opened",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "opened",
-            "closed",
-            "locked",
-            "merged",
-            "all"
-          ],
-          "type": "option"
-        },
-        "source-branch": {
-          "name": "source-branch",
-          "summary": "Only merge requests from this source branch.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target-branch": {
-          "name": "target-branch",
-          "summary": "Only merge requests into this target branch.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "author-username": {
-          "name": "author-username",
-          "summary": "Only merge requests opened by this username.",
+        "search": {
+          "name": "search",
+          "summary": "Match against the project name and path.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "reviewer-username": {
-          "name": "reviewer-username",
-          "summary": "Only merge requests this username is reviewing.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "membership": {
+          "name": "membership",
+          "summary": "Only projects you are a member of.",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "labels": {
-          "name": "labels",
-          "summary": "Comma-separated labels every result must carry.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "owned": {
+          "name": "owned",
+          "summary": "Only projects you own.",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "search": {
-          "name": "search",
-          "summary": "Match against the title and description.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "simple": {
+          "name": "simple",
+          "summary": "Return only the core fields, for a much smaller payload.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:mr:list",
+      "id": "gitlab:project:list",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "List merge requests for a project.",
+      "summary": "List projects you can see.",
       "enableJsonFlag": true,
       "isWrite": false,
       "isESM": true,
@@ -1862,28 +1827,26 @@
         "lib",
         "commands",
         "gitlab",
-        "mr",
+        "project",
         "list.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:mr:list",
-        "mr:gitlab:list",
-        "mr:list:gitlab",
-        "gitlab:list:mr",
-        "list:gitlab:mr",
-        "list:mr:gitlab"
+        "gitlab:project:list",
+        "project:gitlab:list",
+        "project:list:gitlab",
+        "gitlab:list:project",
+        "list:gitlab:project",
+        "list:project:gitlab"
       ]
     },
-    "gitlab:mr:merge": {
+    "gitlab:project:view": {
       "aliases": [],
       "args": {},
-      "description": "Merging cannot be undone by any other command, so this one refuses to send anything without --confirm. Without it, it prints the request it would send and exits 1.\n\nPass --sha with the head you reviewed (the \"Head\" line of mr view): GitLab then refuses if anything was pushed since. --auto-merge merges once checks pass, and on a project with merge trains it joins the train. --skip-merge-train uses GitLab's experimental \"merge immediately without restarting the merge train\", which merges changes the train has not tested against the merge requests queued ahead of it; it requires --sha.\n\nWhen GitLab refuses with a bare 405, the merge request is read back and the reason is named.",
+      "description": "Accepts either the numeric id or the full path. Use --json for the complete, unmodified API payload, which carries far more than the summary below — permissions, statistics, and every feature toggle on the project.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --sha <head-sha> --confirm",
-        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --auto-merge --confirm",
-        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --skip-merge-train --sha <head-sha> --confirm",
-        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --squash --dry-run"
+        "<%= config.bin %> <%= command.id %> --project group/project",
+        "<%= config.bin %> <%= command.id %> --project 1234 --json"
       ],
       "flags": {
         "json": {
@@ -1930,115 +1893,43 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "dry-run": {
-          "name": "dry-run",
-          "summary": "Print the request that would be sent and exit without sending it.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "mr": {
-          "name": "mr",
-          "required": true,
-          "summary": "Merge request iid.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sha": {
-          "name": "sha",
-          "summary": "Full sha of the source branch head you reviewed. Recommended; required with --skip-merge-train.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "auto-merge": {
-          "exclusive": [
-            "skip-merge-train"
-          ],
-          "name": "auto-merge",
-          "summary": "Merge when checks pass. On a project with merge trains, this joins the train.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "skip-merge-train": {
-          "exclusive": [
-            "auto-merge"
-          ],
-          "name": "skip-merge-train",
-          "summary": "Merge now without restarting the merge train. Experimental in GitLab.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "squash": {
-          "name": "squash",
-          "summary": "Squash the commits into one.",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "remove-source-branch": {
-          "name": "remove-source-branch",
-          "summary": "Delete the source branch after merging.",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "merge-commit-message": {
-          "name": "merge-commit-message",
-          "summary": "Custom merge commit message.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "squash-commit-message": {
-          "name": "squash-commit-message",
-          "summary": "Custom squash commit message.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "confirm": {
-          "name": "confirm",
-          "summary": "Send the merge. Without it, nothing is sent.",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:mr:merge",
+      "id": "gitlab:project:view",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "Merge a merge request, or add it to the merge train.",
+      "summary": "Show one project.",
       "enableJsonFlag": true,
-      "isWrite": true,
+      "isWrite": false,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "gitlab",
-        "mr",
-        "merge.js"
+        "project",
+        "view.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:mr:merge",
-        "mr:gitlab:merge",
-        "mr:merge:gitlab",
-        "gitlab:merge:mr",
-        "merge:gitlab:mr",
-        "merge:mr:gitlab"
+        "gitlab:project:view",
+        "project:gitlab:view",
+        "project:view:gitlab",
+        "gitlab:view:project",
+        "view:gitlab:project",
+        "view:project:gitlab"
       ]
     },
-    "gitlab:mr:update": {
+    "gitlab:mr:create": {
       "aliases": [],
       "args": {},
-      "description": "Only the attributes you name are changed, with one exception worth knowing: --labels replaces the whole label set rather than adding to it.\n\nNaming nothing to change is refused rather than sent, because GitLab answers an empty update with a cheerful 200 and an unchanged merge request. --state close and --state reopen do what the buttons of those names do; neither merges anything.",
+      "description": "Both branches must already exist on the project. --draft prefixes the title with \"Draft: \", which is how GitLab itself marks a draft; there is no separate field for it.\n\nAssignees and reviewers are numeric user ids, not usernames — GitLab accepts only ids here. --body or --body-file supplies raw JSON for anything the flags do not cover, such as approval rules. Use --dry-run to see exactly what would be sent.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --title \"feat: renamed\"",
-        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --state close",
-        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --labels backend,urgent --dry-run"
+        "<%= config.bin %> <%= command.id %> --project group/project --source-branch feature --target-branch main --title \"feat: the thing\"",
+        "<%= config.bin %> <%= command.id %> --project group/project --source-branch feature --target-branch main --title wip --draft --squash"
       ],
       "flags": {
         "json": {
@@ -2092,75 +1983,69 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "mr": {
-          "name": "mr",
-          "required": true,
-          "summary": "Merge request iid.",
+        "source-branch": {
+          "name": "source-branch",
+          "summary": "Branch holding the changes.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "title": {
-          "name": "title",
-          "summary": "New title.",
+        "target-branch": {
+          "name": "target-branch",
+          "summary": "Branch the changes are proposed for.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "name": "description",
-          "summary": "New description, as Markdown.",
+        "title": {
+          "name": "title",
+          "summary": "Merge request title.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "target-branch": {
-          "name": "target-branch",
-          "summary": "New target branch.",
+        "description": {
+          "name": "description",
+          "summary": "Merge request description, as Markdown.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "state": {
-          "name": "state",
-          "summary": "Close or reopen the merge request.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "close",
-            "reopen"
-          ],
-          "type": "option"
+        "draft": {
+          "name": "draft",
+          "summary": "Open it as a draft.",
+          "allowNo": false,
+          "type": "boolean"
         },
         "squash": {
           "name": "squash",
           "summary": "Squash the commits when it merges.",
-          "allowNo": true,
+          "allowNo": false,
           "type": "boolean"
         },
         "remove-source-branch": {
           "name": "remove-source-branch",
           "summary": "Delete the source branch on merge.",
-          "allowNo": true,
+          "allowNo": false,
           "type": "boolean"
         },
         "assignee-id": {
           "name": "assignee-id",
-          "summary": "User id to assign, replacing the set. Repeatable.",
+          "summary": "User id to assign. Repeatable.",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
         "reviewer-id": {
           "name": "reviewer-id",
-          "summary": "User id to review, replacing the set. Repeatable.",
+          "summary": "User id to request review from. Repeatable.",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
         "labels": {
           "name": "labels",
-          "summary": "Comma-separated labels, replacing the existing set.",
+          "summary": "Comma-separated labels to apply.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2192,12 +2077,12 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:mr:update",
+      "id": "gitlab:mr:create",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "Change an existing merge request.",
+      "summary": "Open a merge request.",
       "enableJsonFlag": true,
       "isWrite": true,
       "isESM": true,
@@ -2206,25 +2091,26 @@
         "commands",
         "gitlab",
         "mr",
-        "update.js"
+        "create.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:mr:update",
-        "mr:gitlab:update",
-        "mr:update:gitlab",
-        "gitlab:update:mr",
-        "update:gitlab:mr",
-        "update:mr:gitlab"
+        "gitlab:mr:create",
+        "mr:gitlab:create",
+        "mr:create:gitlab",
+        "gitlab:create:mr",
+        "create:gitlab:mr",
+        "create:mr:gitlab"
       ]
     },
-    "gitlab:mr:view": {
+    "gitlab:mr:list": {
       "aliases": [],
       "args": {},
-      "description": "Takes the project-scoped iid — the number in the merge request URL — not the instance-wide id. Use --json for the full payload, which carries the pipeline status, approvals, and diff refs the summary below leaves out.",
+      "description": "Defaults to open merge requests, which is what a list is nearly always for; pass --state all to include closed and merged ones. The IID column is the number to pass to the other mr commands — it is per-project, and is not the \"id\" field in the JSON payload.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --project group/project --mr 42",
-        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --json"
+        "<%= config.bin %> <%= command.id %> --project group/project",
+        "<%= config.bin %> <%= command.id %> --project group/project --state merged --target-branch main --limit 10",
+        "<%= config.bin %> <%= command.id %> --project group/project --author-username someone --json"
       ],
       "flags": {
         "json": {
@@ -2272,10 +2158,67 @@
           "multiple": false,
           "type": "option"
         },
-        "mr": {
-          "name": "mr",
-          "required": true,
-          "summary": "Merge request iid.",
+        "limit": {
+          "name": "limit",
+          "summary": "Maximum number of merge requests to return across all pages.",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "state": {
+          "name": "state",
+          "summary": "Merge request state to return.",
+          "default": "opened",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "opened",
+            "closed",
+            "locked",
+            "merged",
+            "all"
+          ],
+          "type": "option"
+        },
+        "source-branch": {
+          "name": "source-branch",
+          "summary": "Only merge requests from this source branch.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-branch": {
+          "name": "target-branch",
+          "summary": "Only merge requests into this target branch.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "author-username": {
+          "name": "author-username",
+          "summary": "Only merge requests opened by this username.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "reviewer-username": {
+          "name": "reviewer-username",
+          "summary": "Only merge requests this username is reviewing.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "labels": {
+          "name": "labels",
+          "summary": "Comma-separated labels every result must carry.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "search": {
+          "name": "search",
+          "summary": "Match against the title and description.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2283,12 +2226,12 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:mr:view",
+      "id": "gitlab:mr:list",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "Show one merge request.",
+      "summary": "List merge requests for a project.",
       "enableJsonFlag": true,
       "isWrite": false,
       "isESM": true,
@@ -2297,28 +2240,27 @@
         "commands",
         "gitlab",
         "mr",
-        "view.js"
+        "list.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:mr:view",
-        "mr:gitlab:view",
-        "mr:view:gitlab",
-        "gitlab:view:mr",
-        "view:gitlab:mr",
-        "view:mr:gitlab"
+        "gitlab:mr:list",
+        "mr:gitlab:list",
+        "mr:list:gitlab",
+        "gitlab:list:mr",
+        "list:gitlab:mr",
+        "list:mr:gitlab"
       ]
     },
-    "gitlab:project:create": {
+    "gitlab:mr:merge": {
       "aliases": [],
       "args": {},
-      "description": "Creates the project in --namespace, or in the namespace of the token owner when none is given. Give it --name or --path; GitLab derives whichever one is missing.\n\n--template names one of the built-in templates GitLab ships, such as express or rails. To create from a custom template instead, add --custom-template for one the instance administrator registered, --template-group for one in a group, or use --template-project to name the template project itself by id or path — which GitLab prefers, because a name can be ambiguous. Add --template-group to --template-project when the template belongs to a group rather than the instance. Custom templates need a Premium or Ultimate instance.\n\nA template is applied asynchronously: this command returns as soon as the project record exists, with an import status of \"scheduled\", and the files arrive a few seconds later. Check \"project view\" until its import_status reads \"finished\" before writing to the repository. --dry-run prints the exact request body; a namespace or template given as a path is still looked up, so the printed ids are the ones that would be sent.",
+      "description": "Merging cannot be undone by any other command, so this one refuses to send anything without --confirm. Without it, it prints the request it would send and exits 1.\n\nPass --sha with the head you reviewed (the \"Head\" line of mr view): GitLab then refuses if anything was pushed since. --auto-merge merges once checks pass, and on a project with merge trains it joins the train. --skip-merge-train uses GitLab's experimental \"merge immediately without restarting the merge train\", which merges changes the train has not tested against the merge requests queued ahead of it; it requires --sha.\n\nWhen GitLab refuses with a bare 405, the merge request is read back and the reason is named.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --name new-service --namespace platform/apps",
-        "<%= config.bin %> <%= command.id %> --name new-service --namespace platform/apps --template express --visibility internal",
-        "<%= config.bin %> <%= command.id %> --name new-service --namespace platform/apps --template service-skeleton --template-group platform/templates",
-        "<%= config.bin %> <%= command.id %> --path new-service --template-project platform/templates/service-skeleton --dry-run",
-        "<%= config.bin %> <%= command.id %> --name new-service --template-project platform/templates/service-skeleton --template-group platform/templates"
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --sha <head-sha> --confirm",
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --auto-merge --confirm",
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --skip-merge-train --sha <head-sha> --confirm",
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --squash --dry-run"
       ],
       "flags": {
         "json": {
@@ -2356,126 +2298,96 @@
           "multiple": false,
           "type": "option"
         },
+        "project": {
+          "char": "p",
+          "env": "GITLAB_PROJECT",
+          "name": "project",
+          "required": true,
+          "summary": "Project id, or its full path such as group/subgroup/project.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "dry-run": {
           "name": "dry-run",
           "summary": "Print the request that would be sent and exit without sending it.",
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "name": "name",
-          "summary": "Project name. The path is derived from it when --path is not given.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "path": {
-          "name": "path",
-          "summary": "Repository path, the URL slug. The name is derived from it when --name is not given.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "namespace": {
-          "description": "Defaults to the namespace of the token owner.",
-          "name": "namespace",
-          "summary": "Group or user namespace to create the project in, by id or full path.",
+        "mr": {
+          "name": "mr",
+          "required": true,
+          "summary": "Merge request iid.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "name": "description",
-          "summary": "Project description.",
+        "sha": {
+          "name": "sha",
+          "summary": "Full sha of the source branch head you reviewed. Recommended; required with --skip-merge-train.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "visibility": {
-          "name": "visibility",
-          "summary": "Who can see the project.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "private",
-            "internal",
-            "public"
+        "auto-merge": {
+          "exclusive": [
+            "skip-merge-train"
           ],
-          "type": "option"
-        },
-        "default-branch": {
-          "name": "default-branch",
-          "summary": "Name of the default branch.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "initialize-with-readme": {
-          "name": "initialize-with-readme",
-          "summary": "Create a first commit holding a README, so the repository is not empty.",
+          "name": "auto-merge",
+          "summary": "Merge when checks pass. On a project with merge trains, this joins the train.",
           "allowNo": false,
           "type": "boolean"
         },
-        "topics": {
-          "name": "topics",
-          "summary": "Comma-separated topics to label the project with.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "template": {
-          "name": "template",
-          "summary": "Template to create from: a built-in name, or with --custom-template or --template-group a custom one.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "custom-template": {
-          "name": "custom-template",
-          "summary": "Look --template up among the instance's custom project templates rather than the built-in ones.",
+        "skip-merge-train": {
+          "exclusive": [
+            "auto-merge"
+          ],
+          "name": "skip-merge-train",
+          "summary": "Merge now without restarting the merge train. Experimental in GitLab.",
           "allowNo": false,
           "type": "boolean"
         },
-        "template-group": {
-          "name": "template-group",
-          "summary": "Group whose custom project templates --template or --template-project names, by id or full path.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "squash": {
+          "name": "squash",
+          "summary": "Squash the commits into one.",
+          "allowNo": true,
+          "type": "boolean"
         },
-        "template-project": {
-          "name": "template-project",
-          "summary": "Custom template project to create from, by id or full path. Cannot be combined with --template.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "remove-source-branch": {
+          "name": "remove-source-branch",
+          "summary": "Delete the source branch after merging.",
+          "allowNo": true,
+          "type": "boolean"
         },
-        "body": {
-          "exclusive": [
-            "body-file"
-          ],
-          "name": "body",
-          "summary": "Raw JSON request body.",
+        "merge-commit-message": {
+          "name": "merge-commit-message",
+          "summary": "Custom merge commit message.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "body-file": {
-          "name": "body-file",
-          "summary": "Path to a file holding the raw JSON request body.",
+        "squash-commit-message": {
+          "name": "squash-commit-message",
+          "summary": "Custom squash commit message.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "confirm": {
+          "name": "confirm",
+          "summary": "Send the merge. Without it, nothing is sent.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:project:create",
+      "id": "gitlab:mr:merge",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "Create a project, blank or from a template.",
+      "summary": "Merge a merge request, or add it to the merge train.",
       "enableJsonFlag": true,
       "isWrite": true,
       "isESM": true,
@@ -2483,27 +2395,27 @@
         "lib",
         "commands",
         "gitlab",
-        "project",
-        "create.js"
+        "mr",
+        "merge.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:project:create",
-        "project:gitlab:create",
-        "project:create:gitlab",
-        "gitlab:create:project",
-        "create:gitlab:project",
-        "create:project:gitlab"
+        "gitlab:mr:merge",
+        "mr:gitlab:merge",
+        "mr:merge:gitlab",
+        "gitlab:merge:mr",
+        "merge:gitlab:mr",
+        "merge:mr:gitlab"
       ]
     },
-    "gitlab:project:list": {
+    "gitlab:mr:update": {
       "aliases": [],
       "args": {},
-      "description": "Without --search this lists every project the token can reach, newest activity first, which on a large instance is not a useful answer — narrow it with --search or --membership. Use --simple for a much smaller payload when you only need ids and paths.",
+      "description": "Only the attributes you name are changed, with one exception worth knowing: --labels replaces the whole label set rather than adding to it.\n\nNaming nothing to change is refused rather than sent, because GitLab answers an empty update with a cheerful 200 and an unchanged merge request. --state close and --state reopen do what the buttons of those names do; neither merges anything.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --membership",
-        "<%= config.bin %> <%= command.id %> --search platform --limit 10",
-        "<%= config.bin %> <%= command.id %> --search platform --simple --json"
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --title \"feat: renamed\"",
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --state close",
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --labels backend,urgent --dry-run"
       ],
       "flags": {
         "json": {
@@ -2541,75 +2453,155 @@
           "multiple": false,
           "type": "option"
         },
-        "limit": {
-          "name": "limit",
-          "summary": "Maximum number of projects to return across all pages.",
-          "default": 20,
+        "project": {
+          "char": "p",
+          "env": "GITLAB_PROJECT",
+          "name": "project",
+          "required": true,
+          "summary": "Project id, or its full path such as group/subgroup/project.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "search": {
-          "name": "search",
-          "summary": "Match against the project name and path.",
+        "dry-run": {
+          "name": "dry-run",
+          "summary": "Print the request that would be sent and exit without sending it.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "mr": {
+          "name": "mr",
+          "required": true,
+          "summary": "Merge request iid.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "membership": {
-          "name": "membership",
-          "summary": "Only projects you are a member of.",
-          "allowNo": false,
-          "type": "boolean"
+        "title": {
+          "name": "title",
+          "summary": "New title.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "owned": {
-          "name": "owned",
-          "summary": "Only projects you own.",
-          "allowNo": false,
+        "description": {
+          "name": "description",
+          "summary": "New description, as Markdown.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-branch": {
+          "name": "target-branch",
+          "summary": "New target branch.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "state": {
+          "name": "state",
+          "summary": "Close or reopen the merge request.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "close",
+            "reopen"
+          ],
+          "type": "option"
+        },
+        "squash": {
+          "name": "squash",
+          "summary": "Squash the commits when it merges.",
+          "allowNo": true,
           "type": "boolean"
         },
-        "simple": {
-          "name": "simple",
-          "summary": "Return only the core fields, for a much smaller payload.",
-          "allowNo": false,
+        "remove-source-branch": {
+          "name": "remove-source-branch",
+          "summary": "Delete the source branch on merge.",
+          "allowNo": true,
           "type": "boolean"
+        },
+        "assignee-id": {
+          "name": "assignee-id",
+          "summary": "User id to assign, replacing the set. Repeatable.",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "reviewer-id": {
+          "name": "reviewer-id",
+          "summary": "User id to review, replacing the set. Repeatable.",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "labels": {
+          "name": "labels",
+          "summary": "Comma-separated labels, replacing the existing set.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "milestone-id": {
+          "name": "milestone-id",
+          "summary": "Milestone id to attach.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "body": {
+          "exclusive": [
+            "body-file"
+          ],
+          "name": "body",
+          "summary": "Raw JSON request body.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "body-file": {
+          "name": "body-file",
+          "summary": "Path to a file holding the raw JSON request body.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:project:list",
+      "id": "gitlab:mr:update",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "List projects you can see.",
+      "summary": "Change an existing merge request.",
       "enableJsonFlag": true,
-      "isWrite": false,
+      "isWrite": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "gitlab",
-        "project",
-        "list.js"
+        "mr",
+        "update.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:project:list",
-        "project:gitlab:list",
-        "project:list:gitlab",
-        "gitlab:list:project",
-        "list:gitlab:project",
-        "list:project:gitlab"
+        "gitlab:mr:update",
+        "mr:gitlab:update",
+        "mr:update:gitlab",
+        "gitlab:update:mr",
+        "update:gitlab:mr",
+        "update:mr:gitlab"
       ]
     },
-    "gitlab:project:view": {
+    "gitlab:mr:view": {
       "aliases": [],
       "args": {},
-      "description": "Accepts either the numeric id or the full path. Use --json for the complete, unmodified API payload, which carries far more than the summary below — permissions, statistics, and every feature toggle on the project.",
+      "description": "Takes the project-scoped iid — the number in the merge request URL — not the instance-wide id. Use --json for the full payload, which carries the pipeline status, approvals, and diff refs the summary below leaves out.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --project group/project",
-        "<%= config.bin %> <%= command.id %> --project 1234 --json"
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42",
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --json"
       ],
       "flags": {
         "json": {
@@ -2656,16 +2648,24 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "mr": {
+          "name": "mr",
+          "required": true,
+          "summary": "Merge request iid.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:project:view",
+      "id": "gitlab:mr:view",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "Show one project.",
+      "summary": "Show one merge request.",
       "enableJsonFlag": true,
       "isWrite": false,
       "isESM": true,
@@ -2673,17 +2673,17 @@
         "lib",
         "commands",
         "gitlab",
-        "project",
+        "mr",
         "view.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:project:view",
-        "project:gitlab:view",
-        "project:view:gitlab",
-        "gitlab:view:project",
-        "view:gitlab:project",
-        "view:project:gitlab"
+        "gitlab:mr:view",
+        "mr:gitlab:view",
+        "mr:view:gitlab",
+        "gitlab:view:mr",
+        "view:gitlab:mr",
+        "view:mr:gitlab"
       ]
     },
     "gitlab:release:list": {
@@ -3546,5 +3546,5 @@
       ]
     }
   },
-  "version": "0.9.0"
+  "version": "0.10.0"
 }