@simplysf/simply-gitlab 0.6.1 → 0.6.2

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,27 +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:update": {
+    "gitlab:project:view": {
       "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": "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 --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",
+        "<%= config.bin %> <%= command.id %> --project 1234 --json"
       ],
       "flags": {
         "json": {
@@ -1929,146 +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"
-        },
-        "title": {
-          "name": "title",
-          "summary": "New title.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "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"
-        },
-        "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:mr:update",
+      "id": "gitlab:project:view",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "Change an existing merge request.",
+      "summary": "Show one project.",
       "enableJsonFlag": true,
-      "isWrite": true,
+      "isWrite": false,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "gitlab",
-        "mr",
-        "update.js"
+        "project",
+        "view.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:mr:update",
-        "mr:gitlab:update",
-        "mr:update:gitlab",
-        "gitlab:update:mr",
-        "update:gitlab:mr",
-        "update:mr:gitlab"
+        "gitlab:project:view",
+        "project:gitlab:view",
+        "project:view:gitlab",
+        "gitlab:view:project",
+        "view:gitlab:project",
+        "view:project:gitlab"
       ]
     },
-    "gitlab:mr:view": {
+    "gitlab:release: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": "Releases are tags with notes and assets attached, so a project can have many tags and no releases at all. Use --json for the release notes, asset links, and the commit each release points at.",
       "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 --limit 5 --json"
       ],
       "flags": {
         "json": {
@@ -2116,10 +1977,10 @@
           "multiple": false,
           "type": "option"
         },
-        "mr": {
-          "name": "mr",
-          "required": true,
-          "summary": "Merge request iid.",
+        "limit": {
+          "name": "limit",
+          "summary": "Maximum number of releases to return across all pages.",
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2127,12 +1988,12 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:mr:view",
+      "id": "gitlab:release:list",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "Show one merge request.",
+      "summary": "List releases for a project.",
       "enableJsonFlag": true,
       "isWrite": false,
       "isESM": true,
@@ -2140,29 +2001,26 @@
         "lib",
         "commands",
         "gitlab",
-        "mr",
-        "view.js"
+        "release",
+        "list.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:mr:view",
-        "mr:gitlab:view",
-        "mr:view:gitlab",
-        "gitlab:view:mr",
-        "view:gitlab:mr",
-        "view:mr:gitlab"
+        "gitlab:release:list",
+        "release:gitlab:list",
+        "release:list:gitlab",
+        "gitlab:list:release",
+        "list:gitlab:release",
+        "list:release:gitlab"
       ]
     },
-    "gitlab:project:create": {
+    "gitlab:mr:create": {
       "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": "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 %> --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 --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": {
@@ -2200,96 +2058,92 @@
           "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.",
+        "source-branch": {
+          "name": "source-branch",
+          "summary": "Branch holding the changes.",
           "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.",
+        "target-branch": {
+          "name": "target-branch",
+          "summary": "Branch the changes are proposed for.",
           "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.",
+        "title": {
+          "name": "title",
+          "summary": "Merge request title.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "description": {
           "name": "description",
-          "summary": "Project description.",
+          "summary": "Merge request description, as Markdown.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "visibility": {
-          "name": "visibility",
-          "summary": "Who can see the project.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "private",
-            "internal",
-            "public"
-          ],
-          "type": "option"
+        "draft": {
+          "name": "draft",
+          "summary": "Open it as a draft.",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "default-branch": {
-          "name": "default-branch",
-          "summary": "Name of the default branch.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "squash": {
+          "name": "squash",
+          "summary": "Squash the commits when it merges.",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "initialize-with-readme": {
-          "name": "initialize-with-readme",
-          "summary": "Create a first commit holding a README, so the repository is not empty.",
+        "remove-source-branch": {
+          "name": "remove-source-branch",
+          "summary": "Delete the source branch on merge.",
           "allowNo": false,
           "type": "boolean"
         },
-        "topics": {
-          "name": "topics",
-          "summary": "Comma-separated topics to label the project with.",
+        "assignee-id": {
+          "name": "assignee-id",
+          "summary": "User id to assign. Repeatable.",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "template": {
-          "name": "template",
-          "summary": "Template to create from: a built-in name, or with --custom-template or --template-group a custom one.",
+        "reviewer-id": {
+          "name": "reviewer-id",
+          "summary": "User id to request review from. Repeatable.",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "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.",
+        "labels": {
+          "name": "labels",
+          "summary": "Comma-separated labels to apply.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "template-project": {
-          "name": "template-project",
-          "summary": "Custom template project to create from, by id or full path. Cannot be combined with --template.",
+        "milestone-id": {
+          "name": "milestone-id",
+          "summary": "Milestone id to attach.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2314,12 +2168,12 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:project:create",
+      "id": "gitlab:mr:create",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "Create a project, blank or from a template.",
+      "summary": "Open a merge request.",
       "enableJsonFlag": true,
       "isWrite": true,
       "isESM": true,
@@ -2327,27 +2181,27 @@
         "lib",
         "commands",
         "gitlab",
-        "project",
+        "mr",
         "create.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:project:create",
-        "project:gitlab:create",
-        "project:create:gitlab",
-        "gitlab:create:project",
-        "create:gitlab:project",
-        "create:project:gitlab"
+        "gitlab:mr:create",
+        "mr:gitlab:create",
+        "mr:create:gitlab",
+        "gitlab:create:mr",
+        "create:gitlab:mr",
+        "create:mr:gitlab"
       ]
     },
-    "gitlab:project:list": {
+    "gitlab:mr:list": {
       "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": "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 %> --membership",
-        "<%= config.bin %> <%= command.id %> --search platform --limit 10",
-        "<%= config.bin %> <%= command.id %> --search platform --simple --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": {
@@ -2357,76 +2211,118 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "env-file": {
-          "char": "e",
-          "description": "Loaded before anything else. Variables already present in the environment win, so the file never overrides an explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.",
-          "helpGroup": "CONNECTION",
-          "name": "env-file",
-          "summary": "Path to a .env file holding connection settings.",
+        "env-file": {
+          "char": "e",
+          "description": "Loaded before anything else. Variables already present in the environment win, so the file never overrides an explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.",
+          "helpGroup": "CONNECTION",
+          "name": "env-file",
+          "summary": "Path to a .env file holding connection settings.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "gitlab-url": {
+          "env": "GITLAB_URL",
+          "helpGroup": "CONNECTION",
+          "name": "gitlab-url",
+          "summary": "Base URL of the GitLab instance. Defaults to https://gitlab.com.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "gitlab-token": {
+          "env": "GITLAB_TOKEN",
+          "helpGroup": "CONNECTION",
+          "name": "gitlab-token",
+          "summary": "Personal, project, or group access token.",
+          "hasDynamicHelp": false,
+          "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.",
+          "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"
         },
-        "gitlab-url": {
-          "env": "GITLAB_URL",
-          "helpGroup": "CONNECTION",
-          "name": "gitlab-url",
-          "summary": "Base URL of the GitLab instance. Defaults to https://gitlab.com.",
+        "target-branch": {
+          "name": "target-branch",
+          "summary": "Only merge requests into this target branch.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "gitlab-token": {
-          "env": "GITLAB_TOKEN",
-          "helpGroup": "CONNECTION",
-          "name": "gitlab-token",
-          "summary": "Personal, project, or group access token.",
+        "author-username": {
+          "name": "author-username",
+          "summary": "Only merge requests opened by this username.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "limit": {
-          "name": "limit",
-          "summary": "Maximum number of projects to return across all pages.",
-          "default": 20,
+        "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 project name and path.",
+          "summary": "Match against the title and description.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "membership": {
-          "name": "membership",
-          "summary": "Only projects you are a member of.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "owned": {
-          "name": "owned",
-          "summary": "Only projects you own.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "simple": {
-          "name": "simple",
-          "summary": "Return only the core fields, for a much smaller payload.",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:project:list",
+      "id": "gitlab:mr:list",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "List projects you can see.",
+      "summary": "List merge requests for a project.",
       "enableJsonFlag": true,
       "isWrite": false,
       "isESM": true,
@@ -2434,26 +2330,27 @@
         "lib",
         "commands",
         "gitlab",
-        "project",
+        "mr",
         "list.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:project:list",
-        "project:gitlab:list",
-        "project:list:gitlab",
-        "gitlab:list:project",
-        "list:gitlab:project",
-        "list:project:gitlab"
+        "gitlab:mr:list",
+        "mr:gitlab:list",
+        "mr:list:gitlab",
+        "gitlab:list:mr",
+        "list:gitlab:mr",
+        "list:mr:gitlab"
       ]
     },
-    "gitlab:project:view": {
+    "gitlab:mr:update": {
       "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": "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 %> --project group/project",
-        "<%= config.bin %> <%= command.id %> --project 1234 --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": {
@@ -2500,43 +2397,146 @@
           "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"
+        },
+        "title": {
+          "name": "title",
+          "summary": "New title.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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"
+        },
+        "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:view",
+      "id": "gitlab:mr:update",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "Show one project.",
+      "summary": "Change an existing merge request.",
       "enableJsonFlag": true,
-      "isWrite": false,
+      "isWrite": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "gitlab",
-        "project",
-        "view.js"
+        "mr",
+        "update.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:project:view",
-        "project:gitlab:view",
-        "project:view:gitlab",
-        "gitlab:view:project",
-        "view:gitlab:project",
-        "view:project:gitlab"
+        "gitlab:mr:update",
+        "mr:gitlab:update",
+        "mr:update:gitlab",
+        "gitlab:update:mr",
+        "update:gitlab:mr",
+        "update:mr:gitlab"
       ]
     },
-    "gitlab:release:list": {
+    "gitlab:mr:view": {
       "aliases": [],
       "args": {},
-      "description": "Releases are tags with notes and assets attached, so a project can have many tags and no releases at all. Use --json for the release notes, asset links, and the commit each release points at.",
+      "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 group/project --limit 5 --json"
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42",
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --json"
       ],
       "flags": {
         "json": {
@@ -2584,10 +2584,10 @@
           "multiple": false,
           "type": "option"
         },
-        "limit": {
-          "name": "limit",
-          "summary": "Maximum number of releases to return across all pages.",
-          "default": 20,
+        "mr": {
+          "name": "mr",
+          "required": true,
+          "summary": "Merge request iid.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2595,12 +2595,12 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:release:list",
+      "id": "gitlab:mr:view",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "List releases for a project.",
+      "summary": "Show one merge request.",
       "enableJsonFlag": true,
       "isWrite": false,
       "isESM": true,
@@ -2608,17 +2608,17 @@
         "lib",
         "commands",
         "gitlab",
-        "release",
-        "list.js"
+        "mr",
+        "view.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:release:list",
-        "release:gitlab:list",
-        "release:list:gitlab",
-        "gitlab:list:release",
-        "list:gitlab:release",
-        "list:release:gitlab"
+        "gitlab:mr:view",
+        "mr:gitlab:view",
+        "mr:view:gitlab",
+        "gitlab:view:mr",
+        "view:gitlab:mr",
+        "view:mr:gitlab"
       ]
     },
     "gitlab:tag:list": {
@@ -3241,5 +3241,5 @@
       ]
     }
   },
-  "version": "0.6.1"
+  "version": "0.6.2"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@simplysf/simply-gitlab",
   "description": "Command-line interface for working with GitLab",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "author": "@ClayChipps",
   "homepage": "https://github.com/SimplySF/simply-gitlab",
   "bugs": "https://github.com/SimplySF/simply-gitlab/issues",
@@ -90,11 +90,11 @@
   },
   "dependencies": {
     "@oclif/core": "^4.11.2",
-    "@simplysf/simply-gitlab-core": "^0.5.1"
+    "@simplysf/simply-gitlab-core": "^0.5.2"
   },
   "devDependencies": {
     "@oclif/plugin-command-snapshot": "^5.4.0",
-    "@vitest/coverage-v8": "^4.1.10",
+    "@vitest/coverage-v8": "^4.1.12",
     "oclif": "^4.23.0",
     "shx": "^0.4.0",
     "vitest": "^4.1.10"
@@ -245,5 +245,5 @@
       "service": true
     }
   },
-  "gitHead": "dc8cdc8e13b8a4053d503cb5efbdb54f637aa19a"
+  "gitHead": "351fcdeece1376bea6932efa857034e0cf321c90"
 }