@simplysf/simply-gitlab 0.7.0 → 0.8.0

package/oclif.manifest.json

@@ -1875,6 +1875,162 @@
         "list:mr:gitlab"
       ]
     },
+    "gitlab:mr:merge": {
+      "aliases": [],
+      "args": {},
+      "description": "Merging cannot be undone by any other command, so this one refuses to send anything without --confirm. Without it, it prints the request it would send and exits 1.\n\nPass --sha with the head you reviewed (the \"Head\" line of mr view): GitLab then refuses if anything was pushed since. --auto-merge merges once checks pass, and on a project with merge trains it joins the train. --skip-merge-train uses GitLab's experimental \"merge immediately without restarting the merge train\", which merges changes the train has not tested against the merge requests queued ahead of it; it requires --sha.\n\nWhen GitLab refuses with a bare 405, the merge request is read back and the reason is named.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --sha <head-sha> --confirm",
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --auto-merge --confirm",
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --skip-merge-train --sha <head-sha> --confirm",
+        "<%= config.bin %> <%= command.id %> --project group/project --mr 42 --squash --dry-run"
+      ],
+      "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"
+        },
+        "dry-run": {
+          "name": "dry-run",
+          "summary": "Print the request that would be sent and exit without sending it.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "mr": {
+          "name": "mr",
+          "required": true,
+          "summary": "Merge request iid.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sha": {
+          "name": "sha",
+          "summary": "Full sha of the source branch head you reviewed. Recommended; required with --skip-merge-train.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "auto-merge": {
+          "exclusive": [
+            "skip-merge-train"
+          ],
+          "name": "auto-merge",
+          "summary": "Merge when checks pass. On a project with merge trains, this joins the train.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-merge-train": {
+          "exclusive": [
+            "auto-merge"
+          ],
+          "name": "skip-merge-train",
+          "summary": "Merge now without restarting the merge train. Experimental in GitLab.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "squash": {
+          "name": "squash",
+          "summary": "Squash the commits into one.",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "remove-source-branch": {
+          "name": "remove-source-branch",
+          "summary": "Delete the source branch after merging.",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "merge-commit-message": {
+          "name": "merge-commit-message",
+          "summary": "Custom merge commit message.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "squash-commit-message": {
+          "name": "squash-commit-message",
+          "summary": "Custom squash commit message.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "confirm": {
+          "name": "confirm",
+          "summary": "Send the merge. Without it, nothing is sent.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "gitlab:mr:merge",
+      "pluginAlias": "@simplysf/simply-gitlab",
+      "pluginName": "@simplysf/simply-gitlab",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Merge a merge request, or add it to the merge train.",
+      "enableJsonFlag": true,
+      "isWrite": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "gitlab",
+        "mr",
+        "merge.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "gitlab:mr:merge",
+        "mr:gitlab:merge",
+        "mr:merge:gitlab",
+        "gitlab:merge:mr",
+        "merge:gitlab:mr",
+        "merge:mr:gitlab"
+      ]
+    },
     "gitlab:mr:update": {
       "aliases": [],
       "args": {},
@@ -2621,13 +2777,13 @@
         "list:release:gitlab"
       ]
     },
-    "gitlab:tag:list": {
+    "gitlab:ci:environment:list": {
       "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": "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 --search v1. --limit 50"
+        "<%= config.bin %> <%= command.id %> --project group/project --state available --search prod"
       ],
       "flags": {
         "json": {
@@ -2677,51 +2833,46 @@
         },
         "limit": {
           "name": "limit",
-          "summary": "Maximum number of tags to return across all pages.",
+          "summary": "Maximum number of environments to return across all pages.",
           "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "search": {
-          "name": "search",
-          "summary": "Return only tags whose name contains this term.",
+        "name": {
+          "name": "name",
+          "summary": "Return the environment with exactly this name.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "order-by": {
-          "name": "order-by",
-          "summary": "Field to sort by.",
+        "search": {
+          "name": "search",
+          "summary": "Return environments whose name contains this term.",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "name",
-            "updated",
-            "version"
-          ],
           "type": "option"
         },
-        "sort": {
-          "name": "sort",
-          "summary": "Sort direction.",
+        "state": {
+          "name": "state",
+          "summary": "Environment state.",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "asc",
-            "desc"
+            "available",
+            "stopped"
           ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:tag:list",
+      "id": "gitlab:ci:environment:list",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "List repository tags.",
+      "summary": "List a project deployment environments.",
       "enableJsonFlag": true,
       "isWrite": false,
       "isESM": true,
@@ -2729,26 +2880,45 @@
         "lib",
         "commands",
         "gitlab",
-        "tag",
+        "ci",
+        "environment",
         "list.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:tag:list",
-        "tag:gitlab:list",
-        "tag:list:gitlab",
-        "gitlab:list:tag",
-        "list:gitlab:tag",
-        "list:tag:gitlab"
+        "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:ci:job:list": {
+    "gitlab:tag:list": {
       "aliases": [],
       "args": {},
-      "description": "Jobs across every pipeline, newest first. --scope is repeatable and the scopes are ORed, so --scope failed --scope running is \"either\". The ID column is what ci job log takes.",
+      "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 --scope failed --limit 10",
-        "<%= config.bin %> <%= command.id %> --project group/project --scope running --scope pending"
+        "<%= config.bin %> <%= command.id %> --project group/project",
+        "<%= config.bin %> <%= command.id %> --project group/project --search v1. --limit 50"
       ],
       "flags": {
         "json": {
@@ -2798,39 +2968,51 @@
         },
         "limit": {
           "name": "limit",
-          "summary": "Maximum number of jobs to return across all pages.",
+          "summary": "Maximum number of tags to return across all pages.",
           "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "scope": {
-          "name": "scope",
-          "summary": "Job states to include. Repeatable.",
+        "search": {
+          "name": "search",
+          "summary": "Return only tags whose name contains this term.",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "order-by": {
+          "name": "order-by",
+          "summary": "Field to sort by.",
+          "hasDynamicHelp": false,
+          "multiple": false,
           "options": [
-            "created",
-            "pending",
-            "running",
-            "failed",
-            "success",
-            "canceled",
-            "skipped",
-            "waiting_for_resource",
-            "manual"
+            "name",
+            "updated",
+            "version"
+          ],
+          "type": "option"
+        },
+        "sort": {
+          "name": "sort",
+          "summary": "Sort direction.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "asc",
+            "desc"
           ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:ci:job:list",
+      "id": "gitlab:tag:list",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "List CI jobs for a project.",
+      "summary": "List repository tags.",
       "enableJsonFlag": true,
       "isWrite": false,
       "isESM": true,
@@ -2838,45 +3020,26 @@
         "lib",
         "commands",
         "gitlab",
-        "ci",
-        "job",
+        "tag",
         "list.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:ci:job:list",
-        "ci:gitlab:job:list",
-        "ci:job:gitlab:list",
-        "ci:job:list:gitlab",
-        "gitlab:job:ci:list",
-        "job:gitlab:ci:list",
-        "job:ci:gitlab:list",
-        "job:ci:list:gitlab",
-        "gitlab:job:list:ci",
-        "job:gitlab:list:ci",
-        "job:list:gitlab:ci",
-        "job:list:ci:gitlab",
-        "gitlab:ci:list:job",
-        "ci:gitlab:list:job",
-        "ci:list:gitlab:job",
-        "ci:list:job:gitlab",
-        "gitlab:list:ci:job",
-        "list:gitlab:ci:job",
-        "list:ci:gitlab:job",
-        "list:ci:job:gitlab",
-        "gitlab:list:job:ci",
-        "list:gitlab:job:ci",
-        "list:job:gitlab:ci",
-        "list:job:ci:gitlab"
+        "gitlab:tag:list",
+        "tag:gitlab:list",
+        "tag:list:gitlab",
+        "gitlab:list:tag",
+        "list:gitlab:tag",
+        "list:tag:gitlab"
       ]
     },
-    "gitlab:ci:job:log": {
+    "gitlab:ci:variable:list": {
       "aliases": [],
       "args": {},
-      "description": "A job trace regularly runs to tens of megabytes, and what matters about a failed job is at the end, so only the last 200 lines are printed. --tail changes that number and --tail 0 prints the whole thing.\n\nThe trace is written by whatever the job ran, which means it is arbitrary text from an untrusted source. Control characters are stripped before it is printed, so the coloured output a runner emits arrives here plain.",
+      "description": "Variable values are hidden by default, including under --json. GitLab returns every value in clear text on this endpoint — the \"masked\" attribute only hides a value in job logs, not from the API — and those values are deploy keys and production credentials.\n\nPass --reveal to print them. Doing so puts live secrets on stdout, into your shell history if you redirect it, and into the context of anything reading this output, so it is a deliberate step rather than the default.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --project group/project --job 12345",
-        "<%= config.bin %> <%= command.id %> --project group/project --job 12345 --tail 0"
+        "<%= config.bin %> <%= command.id %> --project group/project",
+        "<%= config.bin %> <%= command.id %> --project group/project --reveal"
       ],
       "flags": {
         "json": {
@@ -2924,31 +3087,30 @@
           "multiple": false,
           "type": "option"
         },
-        "job": {
-          "name": "job",
-          "required": true,
-          "summary": "Job id, as listed by ci job list.",
+        "limit": {
+          "name": "limit",
+          "summary": "Maximum number of variables to return across all pages.",
+          "default": 50,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "tail": {
-          "name": "tail",
-          "summary": "Print only the last N lines. 0 prints the whole trace.",
-          "default": 200,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "reveal": {
+          "description": "Off by default. Every value on this endpoint is a live secret, so revealing them is worth a moment of thought about where this output is going.",
+          "name": "reveal",
+          "summary": "Print the variable values in clear text.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:ci:job:log",
+      "id": "gitlab:ci:variable:list",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "Print a job log.",
+      "summary": "List a project CI/CD variables.",
       "enableJsonFlag": true,
       "isWrite": false,
       "isESM": true,
@@ -2957,44 +3119,44 @@
         "commands",
         "gitlab",
         "ci",
-        "job",
-        "log.js"
+        "variable",
+        "list.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:ci:job:log",
-        "ci:gitlab:job:log",
-        "ci:job:gitlab:log",
-        "ci:job:log:gitlab",
-        "gitlab:job:ci:log",
-        "job:gitlab:ci:log",
-        "job:ci:gitlab:log",
-        "job:ci:log:gitlab",
-        "gitlab:job:log:ci",
-        "job:gitlab:log:ci",
-        "job:log:gitlab:ci",
-        "job:log:ci:gitlab",
-        "gitlab:ci:log:job",
-        "ci:gitlab:log:job",
-        "ci:log:gitlab:job",
-        "ci:log:job:gitlab",
-        "gitlab:log:ci:job",
-        "log:gitlab:ci:job",
-        "log:ci:gitlab:job",
-        "log:ci:job:gitlab",
-        "gitlab:log:job:ci",
-        "log:gitlab:job:ci",
-        "log:job:gitlab:ci",
-        "log:job:ci:gitlab"
+        "gitlab:ci:variable:list",
+        "ci:gitlab:variable:list",
+        "ci:variable:gitlab:list",
+        "ci:variable:list:gitlab",
+        "gitlab:variable:ci:list",
+        "variable:gitlab:ci:list",
+        "variable:ci:gitlab:list",
+        "variable:ci:list:gitlab",
+        "gitlab:variable:list:ci",
+        "variable:gitlab:list:ci",
+        "variable:list:gitlab:ci",
+        "variable:list:ci:gitlab",
+        "gitlab:ci:list:variable",
+        "ci:gitlab:list:variable",
+        "ci:list:gitlab:variable",
+        "ci:list:variable:gitlab",
+        "gitlab:list:ci:variable",
+        "list:gitlab:ci:variable",
+        "list:ci:gitlab:variable",
+        "list:ci:variable:gitlab",
+        "gitlab:list:variable:ci",
+        "list:gitlab:variable:ci",
+        "list:variable:gitlab:ci",
+        "list:variable:ci:gitlab"
       ]
     },
-    "gitlab:ci:variable:list": {
+    "gitlab:ci:job:list": {
       "aliases": [],
       "args": {},
-      "description": "Variable values are hidden by default, including under --json. GitLab returns every value in clear text on this endpoint — the \"masked\" attribute only hides a value in job logs, not from the API — and those values are deploy keys and production credentials.\n\nPass --reveal to print them. Doing so puts live secrets on stdout, into your shell history if you redirect it, and into the context of anything reading this output, so it is a deliberate step rather than the default.",
+      "description": "Jobs across every pipeline, newest first. --scope is repeatable and the scopes are ORed, so --scope failed --scope running is \"either\". The ID column is what ci job log takes.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --project group/project",
-        "<%= config.bin %> <%= command.id %> --project group/project --reveal"
+        "<%= config.bin %> <%= command.id %> --project group/project --scope failed --limit 10",
+        "<%= config.bin %> <%= command.id %> --project group/project --scope running --scope pending"
       ],
       "flags": {
         "json": {
@@ -3044,28 +3206,39 @@
         },
         "limit": {
           "name": "limit",
-          "summary": "Maximum number of variables to return across all pages.",
-          "default": 50,
+          "summary": "Maximum number of jobs to return across all pages.",
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "reveal": {
-          "description": "Off by default. Every value on this endpoint is a live secret, so revealing them is worth a moment of thought about where this output is going.",
-          "name": "reveal",
-          "summary": "Print the variable values in clear text.",
-          "allowNo": false,
-          "type": "boolean"
+        "scope": {
+          "name": "scope",
+          "summary": "Job states to include. Repeatable.",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "created",
+            "pending",
+            "running",
+            "failed",
+            "success",
+            "canceled",
+            "skipped",
+            "waiting_for_resource",
+            "manual"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:ci:variable:list",
+      "id": "gitlab:ci:job:list",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "List a project CI/CD variables.",
+      "summary": "List CI jobs for a project.",
       "enableJsonFlag": true,
       "isWrite": false,
       "isESM": true,
@@ -3074,44 +3247,44 @@
         "commands",
         "gitlab",
         "ci",
-        "variable",
+        "job",
         "list.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "gitlab:ci:variable:list",
-        "ci:gitlab:variable:list",
-        "ci:variable:gitlab:list",
-        "ci:variable:list:gitlab",
-        "gitlab:variable:ci:list",
-        "variable:gitlab:ci:list",
-        "variable:ci:gitlab:list",
-        "variable:ci:list:gitlab",
-        "gitlab:variable:list:ci",
-        "variable:gitlab:list:ci",
-        "variable:list:gitlab:ci",
-        "variable:list:ci:gitlab",
-        "gitlab:ci:list:variable",
-        "ci:gitlab:list:variable",
-        "ci:list:gitlab:variable",
-        "ci:list:variable:gitlab",
-        "gitlab:list:ci:variable",
-        "list:gitlab:ci:variable",
-        "list:ci:gitlab:variable",
-        "list:ci:variable:gitlab",
-        "gitlab:list:variable:ci",
-        "list:gitlab:variable:ci",
-        "list:variable:gitlab:ci",
-        "list:variable:ci:gitlab"
+        "gitlab:ci:job:list",
+        "ci:gitlab:job:list",
+        "ci:job:gitlab:list",
+        "ci:job:list:gitlab",
+        "gitlab:job:ci:list",
+        "job:gitlab:ci:list",
+        "job:ci:gitlab:list",
+        "job:ci:list:gitlab",
+        "gitlab:job:list:ci",
+        "job:gitlab:list:ci",
+        "job:list:gitlab:ci",
+        "job:list:ci:gitlab",
+        "gitlab:ci:list:job",
+        "ci:gitlab:list:job",
+        "ci:list:gitlab:job",
+        "ci:list:job:gitlab",
+        "gitlab:list:ci:job",
+        "list:gitlab:ci:job",
+        "list:ci:gitlab:job",
+        "list:ci:job:gitlab",
+        "gitlab:list:job:ci",
+        "list:gitlab:job:ci",
+        "list:job:gitlab:ci",
+        "list:job:ci:gitlab"
       ]
     },
-    "gitlab:ci:environment:list": {
+    "gitlab:ci:job:log": {
       "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": "A job trace regularly runs to tens of megabytes, and what matters about a failed job is at the end, so only the last 200 lines are printed. --tail changes that number and --tail 0 prints the whole thing.\n\nThe trace is written by whatever the job ran, which means it is arbitrary text from an untrusted source. Control characters are stripped before it is printed, so the coloured output a runner emits arrives here plain.",
       "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 --job 12345",
+        "<%= config.bin %> <%= command.id %> --project group/project --job 12345 --tail 0"
       ],
       "flags": {
         "json": {
@@ -3159,48 +3332,31 @@
           "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.",
+        "job": {
+          "name": "job",
+          "required": true,
+          "summary": "Job id, as listed by ci job list.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "state": {
-          "name": "state",
-          "summary": "Environment state.",
+        "tail": {
+          "name": "tail",
+          "summary": "Print only the last N lines. 0 prints the whole trace.",
+          "default": 200,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "available",
-            "stopped"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "gitlab:ci:environment:list",
+      "id": "gitlab:ci:job:log",
       "pluginAlias": "@simplysf/simply-gitlab",
       "pluginName": "@simplysf/simply-gitlab",
       "pluginType": "core",
       "strict": true,
-      "summary": "List a project deployment environments.",
+      "summary": "Print a job log.",
       "enableJsonFlag": true,
       "isWrite": false,
       "isESM": true,
@@ -3209,37 +3365,37 @@
         "commands",
         "gitlab",
         "ci",
-        "environment",
-        "list.js"
+        "job",
+        "log.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:ci:job:log",
+        "ci:gitlab:job:log",
+        "ci:job:gitlab:log",
+        "ci:job:log:gitlab",
+        "gitlab:job:ci:log",
+        "job:gitlab:ci:log",
+        "job:ci:gitlab:log",
+        "job:ci:log:gitlab",
+        "gitlab:job:log:ci",
+        "job:gitlab:log:ci",
+        "job:log:gitlab:ci",
+        "job:log:ci:gitlab",
+        "gitlab:ci:log:job",
+        "ci:gitlab:log:job",
+        "ci:log:gitlab:job",
+        "ci:log:job:gitlab",
+        "gitlab:log:ci:job",
+        "log:gitlab:ci:job",
+        "log:ci:gitlab:job",
+        "log:ci:job:gitlab",
+        "gitlab:log:job:ci",
+        "log:gitlab:job:ci",
+        "log:job:gitlab:ci",
+        "log:job:ci:gitlab"
       ]
     }
   },
-  "version": "0.7.0"
+  "version": "0.8.0"
 }