@simplysf/simply-gitlab 0.6.2 → 0.7.0

package/oclif.manifest.json

@@ -1546,16 +1546,13 @@
         "view:file: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": {
@@ -1593,96 +1590,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"
@@ -1707,12 +1700,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,
@@ -1720,27 +1713,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": {
@@ -1778,48 +1771,90 @@
           "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 projects to return across all pages.",
+          "summary": "Maximum number of merge requests to return across all pages.",
           "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "search": {
-          "name": "search",
-          "summary": "Match against the project name and path.",
+        "state": {
+          "name": "state",
+          "summary": "Merge request state to return.",
+          "default": "opened",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "opened",
+            "closed",
+            "locked",
+            "merged",
+            "all"
+          ],
           "type": "option"
         },
-        "membership": {
-          "name": "membership",
-          "summary": "Only projects you are a member of.",
-          "allowNo": false,
-          "type": "boolean"
+        "source-branch": {
+          "name": "source-branch",
+          "summary": "Only merge requests from this source branch.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "owned": {
-          "name": "owned",
-          "summary": "Only projects you own.",
-          "allowNo": false,
-          "type": "boolean"
+        "target-branch": {
+          "name": "target-branch",
+          "summary": "Only merge requests into this target branch.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "simple": {
-          "name": "simple",
-          "summary": "Return only the core fields, for a much smaller payload.",
-          "allowNo": false,
-          "type": "boolean"
+        "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"
         }
       },
       "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,
@@ -1827,26 +1862,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": {
@@ -1893,250 +1929,82 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "gitlab:project:view",
-      "pluginAlias": "@simplysf/simply-gitlab",
-      "pluginName": "@simplysf/simply-gitlab",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Show one project.",
-      "enableJsonFlag": true,
-      "isWrite": false,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "gitlab",
-        "project",
-        "view.js"
-      ],
-      "aliasPermutations": [],
-      "permutations": [
-        "gitlab:project:view",
-        "project:gitlab:view",
-        "project:view:gitlab",
-        "gitlab:view:project",
-        "view:gitlab:project",
-        "view:project:gitlab"
-      ]
-    },
-    "gitlab:release:list": {
-      "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.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --project group/project",
-        "<%= config.bin %> <%= command.id %> --project group/project --limit 5 --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "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.",
-          "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 releases to return across all pages.",
-          "default": 20,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "gitlab:release:list",
-      "pluginAlias": "@simplysf/simply-gitlab",
-      "pluginName": "@simplysf/simply-gitlab",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "List releases for a project.",
-      "enableJsonFlag": true,
-      "isWrite": false,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "gitlab",
-        "release",
-        "list.js"
-      ],
-      "aliasPermutations": [],
-      "permutations": [
-        "gitlab:release:list",
-        "release:gitlab:list",
-        "release:list:gitlab",
-        "gitlab:list:release",
-        "list:gitlab:release",
-        "list:release:gitlab"
-      ]
-    },
-    "gitlab:mr: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.",
-      "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"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
+        "dry-run": {
+          "name": "dry-run",
+          "summary": "Print the request that would be sent and exit without sending it.",
           "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.",
-          "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.",
+        "mr": {
+          "name": "mr",
+          "required": true,
+          "summary": "Merge request iid.",
           "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.",
+        "title": {
+          "name": "title",
+          "summary": "New title.",
           "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.",
+        "description": {
+          "name": "description",
+          "summary": "New description, as Markdown.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "target-branch": {
           "name": "target-branch",
-          "summary": "Branch the changes are proposed for.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "title": {
-          "name": "title",
-          "summary": "Merge request title.",
+          "summary": "New target branch.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "name": "description",
-          "summary": "Merge request description, as Markdown.",
+        "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": false,
+          "allowNo": true,
           "type": "boolean"
         },
         "remove-source-branch": {
           "name": "remove-source-branch",
           "summary": "Delete the source branch on merge.",
-          "allowNo": false,
+          "allowNo": true,
           "type": "boolean"
         },
         "assignee-id": {
           "name": "assignee-id",
-          "summary": "User id to assign. Repeatable.",
+          "summary": "User id to assign, replacing the set. Repeatable.",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
         "reviewer-id": {
           "name": "reviewer-id",
-          "summary": "User id to request review from. Repeatable.",
+          "summary": "User id to review, replacing the set. Repeatable.",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
         "labels": {
           "name": "labels",
-          "summary": "Comma-separated labels to apply.",
+          "summary": "Comma-separated labels, replacing the existing set.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2168,12 +2036,12 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:mr:create",
+      "id": "gitlab:mr:update",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "Open a merge request.",
+      "summary": "Change an existing merge request.",
       "enableJsonFlag": true,
       "isWrite": true,
       "isESM": true,
@@ -2182,26 +2050,25 @@
         "commands",
         "gitlab",
         "mr",
-        "create.js"
+        "update.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:mr:create",
-        "mr:gitlab:create",
-        "mr:create:gitlab",
-        "gitlab:create:mr",
-        "create:gitlab:mr",
-        "create:mr:gitlab"
+        "gitlab:mr:update",
+        "mr:gitlab:update",
+        "mr:update:gitlab",
+        "gitlab:update:mr",
+        "update:gitlab:mr",
+        "update:mr:gitlab"
       ]
     },
-    "gitlab:mr:list": {
+    "gitlab:mr:view": {
       "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": "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 --state merged --target-branch main --limit 10",
-        "<%= config.bin %> <%= command.id %> --project group/project --author-username someone --json"
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42",
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --json"
       ],
       "flags": {
         "json": {
@@ -2249,67 +2116,10 @@
           "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"
-        },
-        "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.",
+        "mr": {
+          "name": "mr",
+          "required": true,
+          "summary": "Merge request iid.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2317,12 +2127,12 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:mr:list",
+      "id": "gitlab:mr:view",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "List merge requests for a project.",
+      "summary": "Show one merge request.",
       "enableJsonFlag": true,
       "isWrite": false,
       "isESM": true,
@@ -2331,26 +2141,28 @@
         "commands",
         "gitlab",
         "mr",
-        "list.js"
+        "view.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:mr:list",
-        "mr:gitlab:list",
-        "mr:list:gitlab",
-        "gitlab:list:mr",
-        "list:gitlab:mr",
-        "list:mr:gitlab"
+        "gitlab:mr:view",
+        "mr:gitlab:view",
+        "mr:view:gitlab",
+        "gitlab:view:mr",
+        "view:gitlab:mr",
+        "view:mr:gitlab"
       ]
     },
-    "gitlab:mr:update": {
+    "gitlab:project: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": "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 --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 %> --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": {
@@ -2388,98 +2200,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"
         },
-        "mr": {
-          "name": "mr",
-          "required": true,
-          "summary": "Merge request iid.",
+        "name": {
+          "name": "name",
+          "summary": "Project name. The path is derived from it when --path is not given.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "title": {
-          "name": "title",
-          "summary": "New title.",
+        "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"
         },
-        "description": {
-          "name": "description",
-          "summary": "New description, as Markdown.",
+        "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"
         },
-        "target-branch": {
-          "name": "target-branch",
-          "summary": "New target branch.",
+        "description": {
+          "name": "description",
+          "summary": "Project description.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "state": {
-          "name": "state",
-          "summary": "Close or reopen the merge request.",
+        "visibility": {
+          "name": "visibility",
+          "summary": "Who can see the project.",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "close",
-            "reopen"
+            "private",
+            "internal",
+            "public"
           ],
           "type": "option"
         },
-        "squash": {
-          "name": "squash",
-          "summary": "Squash the commits when it merges.",
-          "allowNo": true,
-          "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.",
-          "allowNo": true,
+        "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, replacing the set. 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 review, replacing the set. 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, replacing the existing set.",
+        "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"
@@ -2504,12 +2314,12 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:mr:update",
+      "id": "gitlab:project:create",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "Change an existing merge request.",
+      "summary": "Create a project, blank or from a template.",
       "enableJsonFlag": true,
       "isWrite": true,
       "isESM": true,
@@ -2517,26 +2327,27 @@
         "lib",
         "commands",
         "gitlab",
-        "mr",
-        "update.js"
+        "project",
+        "create.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:mr:update",
-        "mr:gitlab:update",
-        "mr:update:gitlab",
-        "gitlab:update:mr",
-        "update:gitlab:mr",
-        "update:mr:gitlab"
+        "gitlab:project:create",
+        "project:gitlab:create",
+        "project:create:gitlab",
+        "gitlab:create:project",
+        "create:gitlab:project",
+        "create:project:gitlab"
       ]
     },
-    "gitlab:mr:view": {
+    "gitlab:project: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": "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 --mr 42",
-        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --json"
+        "<%= config.bin %> <%= command.id %> --membership",
+        "<%= config.bin %> <%= command.id %> --search platform --limit 10",
+        "<%= config.bin %> <%= command.id %> --search platform --simple --json"
       ],
       "flags": {
         "json": {
@@ -2574,33 +2385,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.",
+        "limit": {
+          "name": "limit",
+          "summary": "Maximum number of projects to return across all pages.",
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "mr": {
-          "name": "mr",
-          "required": true,
-          "summary": "Merge request iid.",
+        "search": {
+          "name": "search",
+          "summary": "Match against the project name and path.",
           "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:mr:view",
+      "id": "gitlab:project:list",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "Show one merge request.",
+      "summary": "List projects you can see.",
       "enableJsonFlag": true,
       "isWrite": false,
       "isESM": true,
@@ -2608,26 +2434,26 @@
         "lib",
         "commands",
         "gitlab",
-        "mr",
-        "view.js"
+        "project",
+        "list.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:mr:view",
-        "mr:gitlab:view",
-        "mr:view:gitlab",
-        "gitlab:view:mr",
-        "view:gitlab:mr",
-        "view:mr:gitlab"
+        "gitlab:project:list",
+        "project:gitlab:list",
+        "project:list:gitlab",
+        "gitlab:list:project",
+        "list:gitlab:project",
+        "list:project:gitlab"
       ]
     },
-    "gitlab:tag:list": {
+    "gitlab:project:view": {
       "aliases": [],
       "args": {},
-      "description": "Tags come back newest first by the commit date they point at. That is the commit date, not the tag creation date, so a tag cut today on an old commit sorts by the old commit — use --order-by name if you need a deterministic order instead.",
+      "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",
-        "<%= config.bin %> <%= command.id %> --project group/project --search v1. --limit 50"
+        "<%= config.bin %> <%= command.id %> --project 1234 --json"
       ],
       "flags": {
         "json": {
@@ -2674,54 +2500,107 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "gitlab:project:view",
+      "pluginAlias": "@simplysf/simply-gitlab",
+      "pluginName": "@simplysf/simply-gitlab",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Show one project.",
+      "enableJsonFlag": true,
+      "isWrite": false,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "gitlab",
+        "project",
+        "view.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "gitlab:project:view",
+        "project:gitlab:view",
+        "project:view:gitlab",
+        "gitlab:view:project",
+        "view:gitlab:project",
+        "view:project:gitlab"
+      ]
+    },
+    "gitlab:release:list": {
+      "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.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --project group/project",
+        "<%= config.bin %> <%= command.id %> --project group/project --limit 5 --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "limit": {
-          "name": "limit",
-          "summary": "Maximum number of tags to return across all pages.",
-          "default": 20,
+        "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"
         },
-        "search": {
-          "name": "search",
-          "summary": "Return only tags whose name contains this term.",
+        "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"
         },
-        "order-by": {
-          "name": "order-by",
-          "summary": "Field to sort by.",
+        "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,
-          "options": [
-            "name",
-            "updated",
-            "version"
-          ],
           "type": "option"
         },
-        "sort": {
-          "name": "sort",
-          "summary": "Sort direction.",
+        "limit": {
+          "name": "limit",
+          "summary": "Maximum number of releases to return across all pages.",
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "asc",
-            "desc"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:tag:list",
+      "id": "gitlab:release:list",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "List repository tags.",
+      "summary": "List releases for a project.",
       "enableJsonFlag": true,
       "isWrite": false,
       "isESM": true,
@@ -2729,26 +2608,26 @@
         "lib",
         "commands",
         "gitlab",
-        "tag",
+        "release",
         "list.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:tag:list",
-        "tag:gitlab:list",
-        "tag:list:gitlab",
-        "gitlab:list:tag",
-        "list:gitlab:tag",
-        "list:tag:gitlab"
+        "gitlab:release:list",
+        "release:gitlab:list",
+        "release:list:gitlab",
+        "gitlab:list:release",
+        "list:gitlab:release",
+        "list:release:gitlab"
       ]
     },
-    "gitlab:ci:environment:list": {
+    "gitlab:tag:list": {
       "aliases": [],
       "args": {},
-      "description": "Environments are what CI deploys to and what review apps create. Both available and stopped ones are listed; --state narrows to one. Use --json for the last deployment on each, which is the field worth having when you are answering \"what is running where\".",
+      "description": "Tags come back newest first by the commit date they point at. That is the commit date, not the tag creation date, so a tag cut today on an old commit sorts by the old commit — use --order-by name if you need a deterministic order instead.",
       "examples": [
         "<%= config.bin %> <%= command.id %> --project group/project",
-        "<%= config.bin %> <%= command.id %> --project group/project --state available --search prod"
+        "<%= config.bin %> <%= command.id %> --project group/project --search v1. --limit 50"
       ],
       "flags": {
         "json": {
@@ -2798,46 +2677,51 @@
         },
         "limit": {
           "name": "limit",
-          "summary": "Maximum number of environments to return across all pages.",
+          "summary": "Maximum number of tags to return across all pages.",
           "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "name": "name",
-          "summary": "Return the environment with exactly this name.",
+        "search": {
+          "name": "search",
+          "summary": "Return only tags whose name contains this term.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "search": {
-          "name": "search",
-          "summary": "Return environments whose name contains this term.",
+        "order-by": {
+          "name": "order-by",
+          "summary": "Field to sort by.",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "name",
+            "updated",
+            "version"
+          ],
           "type": "option"
         },
-        "state": {
-          "name": "state",
-          "summary": "Environment state.",
+        "sort": {
+          "name": "sort",
+          "summary": "Sort direction.",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "available",
-            "stopped"
+            "asc",
+            "desc"
           ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:ci:environment:list",
+      "id": "gitlab:tag:list",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "List a project deployment environments.",
+      "summary": "List repository tags.",
       "enableJsonFlag": true,
       "isWrite": false,
       "isESM": true,
@@ -2845,36 +2729,17 @@
         "lib",
         "commands",
         "gitlab",
-        "ci",
-        "environment",
+        "tag",
         "list.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:ci:environment:list",
-        "ci:gitlab:environment:list",
-        "ci:environment:gitlab:list",
-        "ci:environment:list:gitlab",
-        "gitlab:environment:ci:list",
-        "environment:gitlab:ci:list",
-        "environment:ci:gitlab:list",
-        "environment:ci:list:gitlab",
-        "gitlab:environment:list:ci",
-        "environment:gitlab:list:ci",
-        "environment:list:gitlab:ci",
-        "environment:list:ci:gitlab",
-        "gitlab:ci:list:environment",
-        "ci:gitlab:list:environment",
-        "ci:list:gitlab:environment",
-        "ci:list:environment:gitlab",
-        "gitlab:list:ci:environment",
-        "list:gitlab:ci:environment",
-        "list:ci:gitlab:environment",
-        "list:ci:environment:gitlab",
-        "gitlab:list:environment:ci",
-        "list:gitlab:environment:ci",
-        "list:environment:gitlab:ci",
-        "list:environment:ci:gitlab"
+        "gitlab:tag:list",
+        "tag:gitlab:list",
+        "tag:list:gitlab",
+        "gitlab:list:tag",
+        "list:gitlab:tag",
+        "list:tag:gitlab"
       ]
     },
     "gitlab:ci:job:list": {
@@ -3239,7 +3104,142 @@
         "list:variable:gitlab:ci",
         "list:variable:ci:gitlab"
       ]
+    },
+    "gitlab:ci:environment:list": {
+      "aliases": [],
+      "args": {},
+      "description": "Environments are what CI deploys to and what review apps create. Both available and stopped ones are listed; --state narrows to one. Use --json for the last deployment on each, which is the field worth having when you are answering \"what is running where\".",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --project group/project",
+        "<%= config.bin %> <%= command.id %> --project group/project --state available --search prod"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "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.",
+          "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 environments to return across all pages.",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "name": "name",
+          "summary": "Return the environment with exactly this name.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "search": {
+          "name": "search",
+          "summary": "Return environments whose name contains this term.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "state": {
+          "name": "state",
+          "summary": "Environment state.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "available",
+            "stopped"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "gitlab:ci:environment:list",
+      "pluginAlias": "@simplysf/simply-gitlab",
+      "pluginName": "@simplysf/simply-gitlab",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "List a project deployment environments.",
+      "enableJsonFlag": true,
+      "isWrite": false,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "gitlab",
+        "ci",
+        "environment",
+        "list.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "gitlab:ci:environment:list",
+        "ci:gitlab:environment:list",
+        "ci:environment:gitlab:list",
+        "ci:environment:list:gitlab",
+        "gitlab:environment:ci:list",
+        "environment:gitlab:ci:list",
+        "environment:ci:gitlab:list",
+        "environment:ci:list:gitlab",
+        "gitlab:environment:list:ci",
+        "environment:gitlab:list:ci",
+        "environment:list:gitlab:ci",
+        "environment:list:ci:gitlab",
+        "gitlab:ci:list:environment",
+        "ci:gitlab:list:environment",
+        "ci:list:gitlab:environment",
+        "ci:list:environment:gitlab",
+        "gitlab:list:ci:environment",
+        "list:gitlab:ci:environment",
+        "list:ci:gitlab:environment",
+        "list:ci:environment:gitlab",
+        "gitlab:list:environment:ci",
+        "list:gitlab:environment:ci",
+        "list:environment:gitlab:ci",
+        "list:environment:ci:gitlab"
+      ]
     }
   },
-  "version": "0.6.2"
+  "version": "0.7.0"
 }