@simplysf/simply-gitlab 0.1.0

package/bin/run.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+// eslint-disable-next-line node/shebang
+async function main() {
+  const { execute } = await import('@oclif/core');
+  await execute({ dir: import.meta.url });
+}
+
+await main();

package/lib/commands/gitlab/branch/create.d.ts

@@ -0,0 +1,14 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabBranchCreate extends GitLabCommand<typeof GitlabBranchCreate> {
+    static isWrite: boolean;
+    static readonly summary = "Create a branch.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        branch: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        ref: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/lib/commands/gitlab/branch/create.js

@@ -0,0 +1,50 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags } from '@oclif/core';
+import { formatKeyValue } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, projectFlag, writeFlags } from '../../../shared/base-command.js';
+export default class GitlabBranchCreate extends GitLabCommand {
+    static isWrite = true;
+    static summary = 'Create a branch.';
+    static description = 'Points a new branch at an existing branch, tag, or commit SHA. GitLab refuses a name that ' +
+        'already exists rather than moving it, so this can never rewrite a branch someone else is using.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project --branch feature/thing --ref main',
+        '<%= config.bin %> <%= command.id %> --project group/project --branch hotfix --ref v1.2.0',
+    ];
+    static flags = {
+        ...projectFlag,
+        ...writeFlags,
+        branch: Flags.string({ summary: 'Name of the new branch.', required: true }),
+        ref: Flags.string({ summary: 'Branch, tag, or commit SHA to branch from.', required: true }),
+    };
+    async run() {
+        const request = { branch: this.flags.branch, ref: this.flags.ref };
+        if (this.flags['dry-run']) {
+            this.log('Dry run — not sent. Request body:');
+            this.log(JSON.stringify(request, null, 2));
+            return request;
+        }
+        const created = (await this.gitlab().createBranch(this.flags.project, this.flags.branch, this.flags.ref));
+        this.logSafe(formatKeyValue([
+            ['Created', created.name ?? this.flags.branch],
+            ['Commit', created.commit?.short_id],
+            ['URL', created.web_url],
+        ]));
+        return created;
+    }
+}
+//# sourceMappingURL=create.js.map

package/lib/commands/gitlab/branch/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../../src/commands/gitlab/branch/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAQzF,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,aAAwC;IAC/E,MAAM,CAAU,OAAO,GAAG,IAAI,CAAC;IAE/B,MAAM,CAAmB,OAAO,GAAG,kBAAkB,CAAC;IACtD,MAAM,CAAmB,WAAW,GACzC,4FAA4F;QAC5F,iGAAiG,CAAC;IAE7F,MAAM,CAAmB,QAAQ,GAAG;QACzC,+FAA+F;QAC/F,0FAA0F;KAC3F,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,WAAW;QACd,GAAG,UAAU;QACb,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC5E,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KAC7F,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAEnE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;YAC9C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3C,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,YAAY,CAC/C,IAAI,CAAC,KAAK,CAAC,OAAO,EAClB,IAAI,CAAC,KAAK,CAAC,MAAM,EACjB,IAAI,CAAC,KAAK,CAAC,GAAG,CACf,CAAkB,CAAC;QAEpB,IAAI,CAAC,OAAO,CACV,cAAc,CAAC;YACb,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YAC9C,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC;YACpC,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC;SACzB,CAAC,CACH,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC"}

package/lib/commands/gitlab/branch/list.d.ts

@@ -0,0 +1,12 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabBranchList extends GitLabCommand<typeof GitlabBranchList> {
+    static readonly summary = "List repository branches.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/lib/commands/gitlab/branch/list.js

@@ -0,0 +1,45 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags } from '@oclif/core';
+import { branchColumns, formatTable } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, limitFlag, projectFlag } from '../../../shared/base-command.js';
+const DEFAULT_LIMIT = 20;
+export default class GitlabBranchList extends GitLabCommand {
+    static summary = 'List repository branches.';
+    static description = 'Branches come back in GitLab order, which is alphabetical rather than by recency, so on a ' +
+        'busy repository --search is usually what you want. The MERGED column reflects whether the ' +
+        'branch is merged into the default branch, not into whatever you are working on.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project',
+        '<%= config.bin %> <%= command.id %> --project group/project --search release --limit 50',
+    ];
+    static flags = {
+        ...projectFlag,
+        ...limitFlag(DEFAULT_LIMIT, 'branches'),
+        search: Flags.string({ summary: 'Return only branches whose name contains this term.' }),
+    };
+    async run() {
+        const result = await this.gitlab().listBranches(this.flags.project, { search: this.flags.search }, this.flags.limit);
+        if (result.items.length === 0) {
+            this.log('No branches matched.');
+            return result;
+        }
+        this.logSafe(formatTable(result.items, branchColumns));
+        this.reportList(result.items.length, result.total, result.complete, this.flags.limit, 'branch(es)');
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

package/lib/commands/gitlab/branch/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/commands/gitlab/branch/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAY,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAExF,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,aAAsC;IAC3E,MAAM,CAAmB,OAAO,GAAG,2BAA2B,CAAC;IAC/D,MAAM,CAAmB,WAAW,GACzC,4FAA4F;QAC5F,4FAA4F;QAC5F,iFAAiF,CAAC;IAE7E,MAAM,CAAmB,QAAQ,GAAG;QACzC,6DAA6D;QAC7D,yFAAyF;KAC1F,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,WAAW;QACd,GAAG,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC;QACvC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,qDAAqD,EAAE,CAAC;KACzF,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,YAAY,CAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,EAClB,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAC7B,IAAI,CAAC,KAAK,CAAC,KAAK,CACjB,CAAC;QAEF,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;YACjC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,KAAc,EAAE,aAAa,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QACpG,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/lib/commands/gitlab/ci/environment/list.d.ts

@@ -0,0 +1,14 @@
+import { GitLabCommand } from '../../../../shared/base-command.js';
+export default class GitlabCiEnvironmentList extends GitLabCommand<typeof GitlabCiEnvironmentList> {
+    static readonly summary = "List a project deployment environments.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        state: import("@oclif/core/interfaces").OptionFlag<"available" | "stopped" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/lib/commands/gitlab/ci/environment/list.js

@@ -0,0 +1,47 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags } from '@oclif/core';
+import { environmentColumns, formatTable } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, limitFlag, projectFlag } from '../../../../shared/base-command.js';
+const DEFAULT_LIMIT = 20;
+export default class GitlabCiEnvironmentList extends GitLabCommand {
+    static summary = 'List a project deployment environments.';
+    static 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".';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project',
+        '<%= config.bin %> <%= command.id %> --project group/project --state available --search prod',
+    ];
+    static flags = {
+        ...projectFlag,
+        ...limitFlag(DEFAULT_LIMIT, 'environments'),
+        name: Flags.string({ summary: 'Return the environment with exactly this name.' }),
+        search: Flags.string({ summary: 'Return environments whose name contains this term.' }),
+        state: Flags.option({ summary: 'Environment state.', options: ['available', 'stopped'] })(),
+    };
+    async run() {
+        const result = await this.gitlab().listEnvironments(this.flags.project, { name: this.flags.name, search: this.flags.search, states: this.flags.state }, this.flags.limit);
+        if (result.items.length === 0) {
+            this.log('No environments matched.');
+            return result;
+        }
+        this.logSafe(formatTable(result.items, environmentColumns));
+        this.reportList(result.items.length, result.total, result.complete, this.flags.limit, 'environment(s)');
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

package/lib/commands/gitlab/ci/environment/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../../src/commands/gitlab/ci/environment/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAY,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAE3F,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,aAA6C;IACzF,MAAM,CAAmB,OAAO,GAAG,yCAAyC,CAAC;IAC7E,MAAM,CAAmB,WAAW,GACzC,8FAA8F;QAC9F,6FAA6F;QAC7F,2EAA2E,CAAC;IAEvE,MAAM,CAAmB,QAAQ,GAAG;QACzC,6DAA6D;QAC7D,6FAA6F;KAC9F,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,WAAW;QACd,GAAG,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC;QAC3C,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;QACjF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;QACvF,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,SAAS,CAAU,EAAE,CAAC,EAAE;KACrG,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,gBAAgB,CACjD,IAAI,CAAC,KAAK,CAAC,OAAO,EAClB,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAC9E,IAAI,CAAC,KAAK,CAAC,KAAK,CACjB,CAAC;QAEF,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,KAAc,EAAE,kBAAkB,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;QACxG,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/lib/commands/gitlab/ci/job/list.d.ts

@@ -0,0 +1,12 @@
+import { GitLabCommand } from '../../../../shared/base-command.js';
+export default class GitlabCiJobList extends GitLabCommand<typeof GitlabCiJobList> {
+    static readonly summary = "List CI jobs for a project.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        scope: import("@oclif/core/interfaces").OptionFlag<("created" | "pending" | "running" | "failed" | "success" | "canceled" | "skipped" | "waiting_for_resource" | "manual")[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/lib/commands/gitlab/ci/job/list.js

@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags } from '@oclif/core';
+import { formatTable, jobColumns } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, limitFlag, projectFlag } from '../../../../shared/base-command.js';
+const DEFAULT_LIMIT = 20;
+const SCOPES = [
+    'created',
+    'pending',
+    'running',
+    'failed',
+    'success',
+    'canceled',
+    'skipped',
+    'waiting_for_resource',
+    'manual',
+];
+export default class GitlabCiJobList extends GitLabCommand {
+    static summary = 'List CI jobs for a project.';
+    static 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.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project --scope failed --limit 10',
+        '<%= config.bin %> <%= command.id %> --project group/project --scope running --scope pending',
+    ];
+    static flags = {
+        ...projectFlag,
+        ...limitFlag(DEFAULT_LIMIT, 'jobs'),
+        scope: Flags.option({ summary: 'Job states to include. Repeatable.', options: SCOPES, multiple: true })(),
+    };
+    async run() {
+        const result = await this.gitlab().listJobs(this.flags.project, { scope: this.flags.scope }, this.flags.limit);
+        if (result.items.length === 0) {
+            this.log('No jobs matched.');
+            return result;
+        }
+        this.logSafe(formatTable(result.items, jobColumns));
+        this.reportList(result.items.length, result.total, result.complete, this.flags.limit, 'job(s)');
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

package/lib/commands/gitlab/ci/job/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../../src/commands/gitlab/ci/job/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAY,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAE3F,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,MAAM,MAAM,GAAG;IACb,SAAS;IACT,SAAS;IACT,SAAS;IACT,QAAQ;IACR,SAAS;IACT,UAAU;IACV,SAAS;IACT,sBAAsB;IACtB,QAAQ;CACA,CAAC;AAEX,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,aAAqC;IACzE,MAAM,CAAmB,OAAO,GAAG,6BAA6B,CAAC;IACjE,MAAM,CAAmB,WAAW,GACzC,8FAA8F;QAC9F,qFAAqF,CAAC;IAEjF,MAAM,CAAmB,QAAQ,GAAG;QACzC,uFAAuF;QACvF,6FAA6F;KAC9F,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,WAAW;QACd,GAAG,SAAS,CAAC,aAAa,EAAE,MAAM,CAAC;QACnC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE;KAC1G,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAE/G,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAC7B,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,KAAc,EAAE,UAAU,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAChG,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/lib/commands/gitlab/ci/job/log.d.ts

@@ -0,0 +1,12 @@
+import { GitLabCommand } from '../../../../shared/base-command.js';
+export default class GitlabCiJobLog extends GitLabCommand<typeof GitlabCiJobLog> {
+    static readonly summary = "Print a job log.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        job: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        tail: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/lib/commands/gitlab/ci/job/log.js

@@ -0,0 +1,54 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags } from '@oclif/core';
+import { tailLog } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, projectFlag } from '../../../../shared/base-command.js';
+const DEFAULT_TAIL = 200;
+export default class GitlabCiJobLog extends GitLabCommand {
+    static summary = 'Print a job log.';
+    static 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\n' +
+        'The 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.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project --job 12345',
+        '<%= config.bin %> <%= command.id %> --project group/project --job 12345 --tail 0',
+    ];
+    static flags = {
+        ...projectFlag,
+        job: Flags.integer({ summary: 'Job id, as listed by ci job list.', required: true }),
+        tail: Flags.integer({
+            summary: 'Print only the last N lines. 0 prints the whole trace.',
+            default: DEFAULT_TAIL,
+            min: 0,
+        }),
+    };
+    async run() {
+        const log = await this.gitlab().getJobLog(this.flags.project, this.flags.job);
+        if (log.trim() === '') {
+            this.log('This job has no log yet.');
+            return { job: this.flags.job, log: '', truncated: false };
+        }
+        const { text, truncated } = tailLog(log, this.flags.tail);
+        if (truncated)
+            this.log(`(showing the last ${this.flags.tail} lines; pass --tail 0 for the whole trace)\n`);
+        this.logSafe(text.trimEnd());
+        return { job: this.flags.job, log: text, truncated };
+    }
+}
+//# sourceMappingURL=log.js.map

package/lib/commands/gitlab/ci/job/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../../../../src/commands/gitlab/ci/job/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEhF,MAAM,YAAY,GAAG,GAAG,CAAC;AAEzB,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,aAAoC;IACvE,MAAM,CAAmB,OAAO,GAAG,kBAAkB,CAAC;IACtD,MAAM,CAAmB,WAAW,GACzC,6FAA6F;QAC7F,2FAA2F;QAC3F,6BAA6B;QAC7B,yFAAyF;QACzF,0FAA0F;QAC1F,2CAA2C,CAAC;IAEvC,MAAM,CAAmB,QAAQ,GAAG;QACzC,yEAAyE;QACzE,kFAAkF;KACnF,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,WAAW;QACd,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,mCAAmC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACpF,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;YAClB,OAAO,EAAE,wDAAwD;YACjE,OAAO,EAAE,YAAY;YACrB,GAAG,EAAE,CAAC;SACP,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE9E,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;YACrC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAC5D,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,SAAS;YAAE,IAAI,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,KAAK,CAAC,IAAI,8CAA8C,CAAC,CAAC;QAC5G,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAE7B,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACvD,CAAC"}

package/lib/commands/gitlab/ci/variable/list.d.ts

@@ -0,0 +1,12 @@
+import { GitLabCommand } from '../../../../shared/base-command.js';
+export default class GitlabCiVariableList extends GitLabCommand<typeof GitlabCiVariableList> {
+    static readonly summary = "List a project CI/CD variables.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        reveal: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/lib/commands/gitlab/ci/variable/list.js

@@ -0,0 +1,56 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags } from '@oclif/core';
+import { formatTable, maskVariables, variableColumns } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, limitFlag, projectFlag } from '../../../../shared/base-command.js';
+const DEFAULT_LIMIT = 50;
+export default class GitlabCiVariableList extends GitLabCommand {
+    static summary = 'List a project CI/CD variables.';
+    static 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\n' +
+        'Pass --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.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project',
+        '<%= config.bin %> <%= command.id %> --project group/project --reveal',
+    ];
+    static flags = {
+        ...projectFlag,
+        ...limitFlag(DEFAULT_LIMIT, 'variables'),
+        reveal: Flags.boolean({
+            summary: 'Print the variable values in clear text.',
+            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.',
+            default: false,
+        }),
+    };
+    async run() {
+        const result = await this.gitlab().listVariables(this.flags.project, this.flags.limit);
+        const items = this.flags.reveal ? result.items : maskVariables(result.items);
+        if (items.length === 0) {
+            this.log('This project has no CI/CD variables.');
+            return { ...result, items };
+        }
+        this.logSafe(formatTable(items, variableColumns));
+        this.reportList(items.length, result.total, result.complete, this.flags.limit, 'variable(s)');
+        if (!this.flags.reveal)
+            this.log('Values are hidden. Pass --reveal to print them.');
+        return { ...result, items };
+    }
+}
+//# sourceMappingURL=list.js.map

package/lib/commands/gitlab/ci/variable/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../../src/commands/gitlab/ci/variable/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAY,MAAM,8BAA8B,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAE3F,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,aAA0C;IACnF,MAAM,CAAmB,OAAO,GAAG,iCAAiC,CAAC;IACrE,MAAM,CAAmB,WAAW,GACzC,+FAA+F;QAC/F,gGAAgG;QAChG,4EAA4E;QAC5E,gGAAgG;QAChG,+FAA+F;QAC/F,+BAA+B,CAAC;IAE3B,MAAM,CAAmB,QAAQ,GAAG;QACzC,6DAA6D;QAC7D,sEAAsE;KACvE,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,WAAW;QACd,GAAG,SAAS,CAAC,aAAa,EAAE,WAAW,CAAC;QACxC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;YACpB,OAAO,EAAE,0CAA0C;YACnD,WAAW,EACT,4FAA4F;gBAC5F,uDAAuD;YACzD,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE7E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;YACjD,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC;QAC9B,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAc,EAAE,eAAe,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAC9F,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,IAAI,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAEpF,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC"}

package/lib/commands/gitlab/commit/create.d.ts

@@ -0,0 +1,22 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabCommitCreate extends GitLabCommand<typeof GitlabCommitCreate> {
+    static isWrite: boolean;
+    static readonly summary = "Commit several file changes at once.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        branch: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        message: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        actions: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'start-branch': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'start-sha': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'author-email': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'author-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        body: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'body-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/lib/commands/gitlab/commit/create.js

@@ -0,0 +1,74 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags } from '@oclif/core';
+import { buildCommitBody, formatKeyValue, parseActionsInput, parseBodyInput } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, projectFlag, writeFlags } from '../../../shared/base-command.js';
+export default class GitlabCommitCreate extends GitLabCommand {
+    static isWrite = true;
+    static summary = 'Commit several file changes at once.';
+    static description = 'Sends one commit containing a batch of actions — create, update, delete, move, chmod — which ' +
+        'is how GitLab writes more than one file atomically. The actions are JSON, supplied with ' +
+        '--actions or inside a --body-file, because there is no readable flag form for a list of ' +
+        'file operations.\n\n' +
+        'Each action is an object with an "action" and a "file_path"; create and update also need ' +
+        '"content", move needs "previous_path", and chmod needs "execute_filemode". Those rules are ' +
+        'checked before anything is sent, so a bad entry names its own index.\n\n' +
+        'Use --dry-run to see exactly what would be sent.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project --branch main --message "chore: tidy" --actions \'[{"action":"delete","file_path":"old.txt"}]\'',
+        '<%= config.bin %> <%= command.id %> --project group/project --branch main --message "feat: batch" --body-file ./commit.json --dry-run',
+    ];
+    static flags = {
+        ...projectFlag,
+        ...writeFlags,
+        branch: Flags.string({ summary: 'Branch to commit to.' }),
+        message: Flags.string({ summary: 'Commit message.' }),
+        actions: Flags.string({ summary: 'JSON array of file actions.' }),
+        'start-branch': Flags.string({ summary: 'Branch to create --branch from, if it does not exist.' }),
+        'start-sha': Flags.string({ summary: 'Commit SHA to start the new commit from.' }),
+        'author-email': Flags.string({ summary: 'Commit author email.' }),
+        'author-name': Flags.string({ summary: 'Commit author name.' }),
+        force: Flags.boolean({ summary: 'Overwrite the branch with the new commit.', default: false }),
+        body: Flags.string({ summary: 'Raw JSON request body.', exclusive: ['body-file'] }),
+        'body-file': Flags.string({ summary: 'Path to a file holding the raw JSON request body.' }),
+    };
+    async run() {
+        const request = buildCommitBody({
+            branch: this.flags.branch,
+            message: this.flags.message,
+            actions: parseActionsInput(this.flags.actions),
+            startBranch: this.flags['start-branch'],
+            startSha: this.flags['start-sha'],
+            authorEmail: this.flags['author-email'],
+            authorName: this.flags['author-name'],
+            force: this.flags.force || undefined,
+            body: parseBodyInput(this.flags.body, this.flags['body-file']),
+        });
+        if (this.flags['dry-run']) {
+            this.log('Dry run — not sent. Request body:');
+            this.logSafe(JSON.stringify(request, null, 2));
+            return request;
+        }
+        const created = (await this.gitlab().createCommit(this.flags.project, request));
+        this.logSafe(formatKeyValue([
+            ['Created', created.id],
+            ['Title', created.title],
+            ['URL', created.web_url],
+        ]));
+        return created;
+    }
+}
+//# sourceMappingURL=create.js.map

package/lib/commands/gitlab/commit/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../../src/commands/gitlab/commit/create.ts"],"names":[],"mappings":"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"}

package/lib/commands/gitlab/commit/diff.d.ts

@@ -0,0 +1,12 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabCommitDiff extends GitLabCommand<typeof GitlabCommitDiff> {
+    static readonly summary = "Show the changes a commit made.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        sha: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        stat: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/lib/commands/gitlab/commit/diff.js

@@ -0,0 +1,61 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Flags } from '@oclif/core';
+import { GitLabCommand, projectFlag } from '../../../shared/base-command.js';
+/** GitLab omits a path on the side of the change that does not have one. */
+const UNNAMED = '(unknown)';
+/** How a changed file is introduced above its hunk, so a rename or delete is not read as an edit. */
+function heading(entry) {
+    const from = entry.old_path ?? UNNAMED;
+    const to = entry.new_path ?? UNNAMED;
+    if (entry.deleted_file === true)
+        return `deleted ${from}`;
+    if (entry.new_file === true)
+        return `added ${to}`;
+    if (entry.renamed_file === true)
+        return `renamed ${from} -> ${to}`;
+    return `modified ${to}`;
+}
+export default class GitlabCommitDiff extends GitLabCommand {
+    static summary = 'Show the changes a commit made.';
+    static description = 'Prints the unified diff for each file the commit touched. GitLab truncates very large diffs ' +
+        'server-side and says so in the payload, so --stat is worth reaching for first on a big commit: ' +
+        'it lists the files without any hunks.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project --sha 9a1b2c3',
+        '<%= config.bin %> <%= command.id %> --project group/project --sha 9a1b2c3 --stat',
+    ];
+    static flags = {
+        ...projectFlag,
+        sha: Flags.string({ summary: 'Commit SHA, or the name of a branch or tag.', required: true }),
+        stat: Flags.boolean({ summary: 'List the changed files without printing the hunks.', default: false }),
+    };
+    async run() {
+        const entries = (await this.gitlab().getCommitDiff(this.flags.project, this.flags.sha));
+        if (!Array.isArray(entries) || entries.length === 0) {
+            this.log('This commit changed no files.');
+            return entries;
+        }
+        for (const entry of entries) {
+            this.logSafe(heading(entry));
+            if (!this.flags.stat && typeof entry.diff === 'string')
+                this.logSafe(entry.diff.trimEnd());
+        }
+        this.log(`\n${entries.length} file(s) changed.`);
+        return entries;
+    }
+}
+//# sourceMappingURL=diff.js.map