@simplysf/simply-gitlab 0.1.0

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

@@ -0,0 +1,64 @@
+/*
+ * 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, mergeRequestColumns } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, limitFlag, parseList, projectFlag } from '../../../shared/base-command.js';
+const DEFAULT_LIMIT = 20;
+export default class GitlabMrList extends GitLabCommand {
+    static summary = 'List merge requests for a project.';
+    static 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.';
+    static 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',
+    ];
+    static flags = {
+        ...projectFlag,
+        ...limitFlag(DEFAULT_LIMIT, 'merge requests'),
+        state: Flags.option({
+            summary: 'Merge request state to return.',
+            options: ['opened', 'closed', 'locked', 'merged', 'all'],
+            default: 'opened',
+        })(),
+        'source-branch': Flags.string({ summary: 'Only merge requests from this source branch.' }),
+        'target-branch': Flags.string({ summary: 'Only merge requests into this target branch.' }),
+        'author-username': Flags.string({ summary: 'Only merge requests opened by this username.' }),
+        'reviewer-username': Flags.string({ summary: 'Only merge requests this username is reviewing.' }),
+        labels: Flags.string({ summary: 'Comma-separated labels every result must carry.' }),
+        search: Flags.string({ summary: 'Match against the title and description.' }),
+    };
+    async run() {
+        const result = await this.gitlab().listMergeRequests(this.flags.project, {
+            state: this.flags.state,
+            sourceBranch: this.flags['source-branch'],
+            targetBranch: this.flags['target-branch'],
+            authorUsername: this.flags['author-username'],
+            reviewerUsername: this.flags['reviewer-username'],
+            labels: parseList(this.flags.labels),
+            search: this.flags.search,
+        }, this.flags.limit);
+        if (result.items.length === 0) {
+            this.log('No merge requests matched.');
+            return result;
+        }
+        this.logSafe(formatTable(result.items, mergeRequestColumns));
+        this.reportList(result.items.length, result.total, result.complete, this.flags.limit, 'merge request(s)');
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/commands/gitlab/mr/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAY,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnG,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,aAAkC;IACnE,MAAM,CAAmB,OAAO,GAAG,oCAAoC,CAAC;IACxE,MAAM,CAAmB,WAAW,GACzC,+FAA+F;QAC/F,0FAA0F;QAC1F,8EAA8E,CAAC;IAE1E,MAAM,CAAmB,QAAQ,GAAG;QACzC,6DAA6D;QAC7D,4GAA4G;QAC5G,8FAA8F;KAC/F,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,WAAW;QACd,GAAG,SAAS,CAAC,aAAa,EAAE,gBAAgB,CAAC;QAC7C,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;YAClB,OAAO,EAAE,gCAAgC;YACzC,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAU;YACjE,OAAO,EAAE,QAAiB;SAC3B,CAAC,EAAE;QACJ,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC;QAC1F,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC;QAC1F,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC;QAC5F,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,iDAAiD,EAAE,CAAC;QACjG,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,iDAAiD,EAAE,CAAC;QACpF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;KAC9E,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,iBAAiB,CAClD,IAAI,CAAC,KAAK,CAAC,OAAO,EAClB;YACE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK;YACvB,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;YACzC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;YACzC,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC;YAC7C,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC;YACjD,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YACpC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;SAC1B,EACD,IAAI,CAAC,KAAK,CAAC,KAAK,CACjB,CAAC;QAEF,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;YACvC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,KAAc,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;QAC1G,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/lib/commands/gitlab/mr/update.d.ts

@@ -0,0 +1,25 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabMrUpdate extends GitLabCommand<typeof GitlabMrUpdate> {
+    static isWrite: boolean;
+    static readonly summary = "Change an existing merge request.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        mr: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        title: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'target-branch': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        state: import("@oclif/core/interfaces").OptionFlag<"close" | "reopen" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        squash: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'remove-source-branch': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'assignee-id': import("@oclif/core/interfaces").OptionFlag<number[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'reviewer-id': import("@oclif/core/interfaces").OptionFlag<number[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        labels: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'milestone-id': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        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/mr/update.js

@@ -0,0 +1,82 @@
+/*
+ * 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 { assertIid, buildMergeRequestUpdateBody, formatKeyValue, parseBodyInput } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, parseList, projectFlag, writeFlags } from '../../../shared/base-command.js';
+export default class GitlabMrUpdate extends GitLabCommand {
+    static isWrite = true;
+    static summary = 'Change an existing merge request.';
+    static 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\n' +
+        'Naming 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.';
+    static 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',
+    ];
+    static flags = {
+        ...projectFlag,
+        ...writeFlags,
+        mr: Flags.integer({ summary: 'Merge request iid.', required: true }),
+        title: Flags.string({ summary: 'New title.' }),
+        description: Flags.string({ summary: 'New description, as Markdown.' }),
+        'target-branch': Flags.string({ summary: 'New target branch.' }),
+        state: Flags.option({
+            summary: 'Close or reopen the merge request.',
+            options: ['close', 'reopen'],
+        })(),
+        squash: Flags.boolean({ summary: 'Squash the commits when it merges.', allowNo: true }),
+        'remove-source-branch': Flags.boolean({ summary: 'Delete the source branch on merge.', allowNo: true }),
+        'assignee-id': Flags.integer({ summary: 'User id to assign, replacing the set. Repeatable.', multiple: true }),
+        'reviewer-id': Flags.integer({ summary: 'User id to review, replacing the set. Repeatable.', multiple: true }),
+        labels: Flags.string({ summary: 'Comma-separated labels, replacing the existing set.' }),
+        'milestone-id': Flags.integer({ summary: 'Milestone id to attach.' }),
+        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 iid = assertIid(this.flags.mr);
+        const request = buildMergeRequestUpdateBody({
+            title: this.flags.title,
+            description: this.flags.description,
+            targetBranch: this.flags['target-branch'],
+            stateEvent: this.flags.state,
+            squash: this.flags.squash,
+            removeSourceBranch: this.flags['remove-source-branch'],
+            assigneeIds: this.flags['assignee-id'],
+            reviewerIds: this.flags['reviewer-id'],
+            labels: parseList(this.flags.labels),
+            milestoneId: this.flags['milestone-id'],
+            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 updated = (await this.gitlab().updateMergeRequest(this.flags.project, iid, request));
+        this.logSafe(formatKeyValue([
+            ['Updated', `!${updated.iid ?? iid}`],
+            ['Title', updated.title],
+            ['State', updated.state],
+            ['URL', updated.web_url],
+        ]));
+        return updated;
+    }
+}
+//# sourceMappingURL=update.js.map

package/lib/commands/gitlab/mr/update.js.map

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

package/lib/commands/gitlab/mr/view.d.ts

@@ -0,0 +1,11 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabMrView extends GitLabCommand<typeof GitlabMrView> {
+    static readonly summary = "Show one merge request.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        mr: 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/mr/view.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 { assertIid, formatKeyValue } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, projectFlag } from '../../../shared/base-command.js';
+export default class GitlabMrView extends GitLabCommand {
+    static summary = 'Show one merge request.';
+    static 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.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project --mr 42',
+        '<%= config.bin %> <%= command.id %> --project group/project --mr 42 --json',
+    ];
+    static flags = {
+        ...projectFlag,
+        mr: Flags.integer({ summary: 'Merge request iid.', required: true }),
+    };
+    async run() {
+        const iid = assertIid(this.flags.mr);
+        const mr = (await this.gitlab().getMergeRequest(this.flags.project, iid));
+        this.logSafe(formatKeyValue([
+            ['Merge request', `!${mr.iid ?? iid}`],
+            ['Title', mr.title],
+            ['State', mr.draft === true ? `${mr.state ?? 'opened'} (draft)` : mr.state],
+            ['Branches', `${mr.source_branch ?? '?'} -> ${mr.target_branch ?? '?'}`],
+            ['Author', mr.author?.username],
+            ['Merge status', mr.detailed_merge_status ?? mr.merge_status],
+            ['Conflicts', mr.has_conflicts === true ? 'yes' : undefined],
+            ['Labels', mr.labels?.join(', ')],
+            ['Updated', mr.updated_at],
+            ['URL', mr.web_url],
+        ]));
+        if (typeof mr.description === 'string' && mr.description.trim() !== '') {
+            this.log('');
+            this.logSafe(mr.description.trimEnd());
+        }
+        return mr;
+    }
+}
+//# sourceMappingURL=view.js.map

package/lib/commands/gitlab/mr/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../../src/commands/gitlab/mr/view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAmB7E,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,aAAkC;IACnE,MAAM,CAAmB,OAAO,GAAG,yBAAyB,CAAC;IAC7D,MAAM,CAAmB,WAAW,GACzC,6FAA6F;QAC7F,8FAA8F;QAC9F,oCAAoC,CAAC;IAEhC,MAAM,CAAmB,QAAQ,GAAG;QACzC,qEAAqE;QACrE,4EAA4E;KAC7E,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,WAAW;QACd,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KACrE,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAiB,CAAC;QAE1F,IAAI,CAAC,OAAO,CACV,cAAc,CAAC;YACb,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC;YACtC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC;YACnB,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,QAAQ,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC;YAC3E,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,aAAa,IAAI,GAAG,OAAO,EAAE,CAAC,aAAa,IAAI,GAAG,EAAE,CAAC;YACxE,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;YAC/B,CAAC,cAAc,EAAE,EAAE,CAAC,qBAAqB,IAAI,EAAE,CAAC,YAAY,CAAC;YAC7D,CAAC,WAAW,EAAE,EAAE,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5D,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACjC,CAAC,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC;YAC1B,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC;SACpB,CAAC,CACH,CAAC;QACF,IAAI,OAAO,EAAE,CAAC,WAAW,KAAK,QAAQ,IAAI,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC"}

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

@@ -0,0 +1,14 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabProjectList extends GitLabCommand<typeof GitlabProjectList> {
+    static readonly summary = "List projects you can see.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        membership: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        owned: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        simple: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number>;
+    };
+    run(): Promise<unknown>;
+}

package/lib/commands/gitlab/project/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, projectColumns } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, limitFlag } from '../../../shared/base-command.js';
+const DEFAULT_LIMIT = 20;
+export default class GitlabProjectList extends GitLabCommand {
+    static summary = 'List projects you can see.';
+    static 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.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --membership',
+        '<%= config.bin %> <%= command.id %> --search platform --limit 10',
+        '<%= config.bin %> <%= command.id %> --search platform --simple --json',
+    ];
+    static flags = {
+        ...limitFlag(DEFAULT_LIMIT, 'projects'),
+        search: Flags.string({ summary: 'Match against the project name and path.' }),
+        membership: Flags.boolean({ summary: 'Only projects you are a member of.', default: false }),
+        owned: Flags.boolean({ summary: 'Only projects you own.', default: false }),
+        simple: Flags.boolean({
+            summary: 'Return only the core fields, for a much smaller payload.',
+            default: false,
+        }),
+    };
+    async run() {
+        const result = await this.gitlab().listProjects({
+            search: this.flags.search,
+            membership: this.flags.membership || undefined,
+            owned: this.flags.owned || undefined,
+            simple: this.flags.simple || undefined,
+        }, this.flags.limit);
+        if (result.items.length === 0) {
+            this.log('No projects matched.');
+            return result;
+        }
+        this.log(formatTable(result.items, projectColumns));
+        this.reportList(result.items.length, result.total, result.complete, this.flags.limit, 'project(s)');
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/commands/gitlab/project/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAY,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAE3E,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,aAAuC;IAC7E,MAAM,CAAmB,OAAO,GAAG,4BAA4B,CAAC;IAChE,MAAM,CAAmB,WAAW,GACzC,8FAA8F;QAC9F,4FAA4F;QAC5F,uEAAuE,CAAC;IAEnE,MAAM,CAAmB,QAAQ,GAAG;QACzC,kDAAkD;QAClD,kEAAkE;QAClE,uEAAuE;KACxE,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC;QACvC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;QAC7E,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5F,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC3E,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;YACpB,OAAO,EAAE,0DAA0D;YACnE,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,YAAY,CAC7C;YACE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YACzB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,SAAS;YAC9C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,SAAS;YACpC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,SAAS;SACvC,EACD,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,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,KAAc,EAAE,cAAc,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,YAAY,CAAC,CAAC;QACpG,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/lib/commands/gitlab/project/view.d.ts

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

package/lib/commands/gitlab/project/view.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 { formatKeyValue } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, projectFlag } from '../../../shared/base-command.js';
+export default class GitlabProjectView extends GitLabCommand {
+    static summary = 'Show one project.';
+    static 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.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project',
+        '<%= config.bin %> <%= command.id %> --project 1234 --json',
+    ];
+    static flags = { ...projectFlag };
+    async run() {
+        const project = (await this.gitlab().getProject(this.flags.project));
+        this.logSafe(formatKeyValue([
+            ['Project', project.path_with_namespace],
+            ['ID', project.id],
+            ['Description', project.description],
+            ['Visibility', project.visibility],
+            ['Default branch', project.default_branch],
+            ['Open issues', project.open_issues_count],
+            ['Stars', project.star_count],
+            ['Forks', project.forks_count],
+            ['Last activity', project.last_activity_at],
+            ['URL', project.web_url],
+        ]));
+        return project;
+    }
+}
+//# sourceMappingURL=view.js.map

package/lib/commands/gitlab/project/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../../src/commands/gitlab/project/view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAe7E,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,aAAuC;IAC7E,MAAM,CAAmB,OAAO,GAAG,mBAAmB,CAAC;IACvD,MAAM,CAAmB,WAAW,GACzC,8FAA8F;QAC9F,8FAA8F;QAC9F,gCAAgC,CAAC;IAE5B,MAAM,CAAmB,QAAQ,GAAG;QACzC,6DAA6D;QAC7D,2DAA2D;KAC5D,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;IAEpD,KAAK,CAAC,GAAG;QACd,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAY,CAAC;QAEhF,IAAI,CAAC,OAAO,CACV,cAAc,CAAC;YACb,CAAC,SAAS,EAAE,OAAO,CAAC,mBAAmB,CAAC;YACxC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;YAClB,CAAC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC;YACpC,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC;YAClC,CAAC,gBAAgB,EAAE,OAAO,CAAC,cAAc,CAAC;YAC1C,CAAC,aAAa,EAAE,OAAO,CAAC,iBAAiB,CAAC;YAC1C,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC;YAC7B,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC;YAC9B,CAAC,eAAe,EAAE,OAAO,CAAC,gBAAgB,CAAC;YAC3C,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC;SACzB,CAAC,CACH,CAAC;QAEF,OAAO,OAAO,CAAC;IACjB,CAAC"}

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

@@ -0,0 +1,11 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabReleaseList extends GitLabCommand<typeof GitlabReleaseList> {
+    static readonly summary = "List releases for a project.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        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/release/list.js

@@ -0,0 +1,43 @@
+/*
+ * 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 { formatTable, releaseColumns } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, limitFlag, projectFlag } from '../../../shared/base-command.js';
+const DEFAULT_LIMIT = 20;
+export default class GitlabReleaseList extends GitLabCommand {
+    static summary = 'List releases for a project.';
+    static 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.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project',
+        '<%= config.bin %> <%= command.id %> --project group/project --limit 5 --json',
+    ];
+    static flags = {
+        ...projectFlag,
+        ...limitFlag(DEFAULT_LIMIT, 'releases'),
+    };
+    async run() {
+        const result = await this.gitlab().listReleases(this.flags.project, this.flags.limit);
+        if (result.items.length === 0) {
+            this.log('No releases found.');
+            return result;
+        }
+        this.logSafe(formatTable(result.items, releaseColumns));
+        this.reportList(result.items.length, result.total, result.complete, this.flags.limit, 'release(s)');
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/commands/gitlab/release/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAY,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAExF,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,aAAuC;IAC7E,MAAM,CAAmB,OAAO,GAAG,8BAA8B,CAAC;IAClE,MAAM,CAAmB,WAAW,GACzC,2FAA2F;QAC3F,8FAA8F;QAC9F,YAAY,CAAC;IAER,MAAM,CAAmB,QAAQ,GAAG;QACzC,6DAA6D;QAC7D,8EAA8E;KAC/E,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,WAAW;QACd,GAAG,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC;KACxC,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEtF,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;YAC/B,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,KAAc,EAAE,cAAc,CAAC,CAAC,CAAC;QACjE,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/search.d.ts

@@ -0,0 +1,14 @@
+import { GitLabCommand } from '../../shared/base-command.js';
+export default class GitlabSearch extends GitLabCommand<typeof GitlabSearch> {
+    static readonly summary = "Search GitLab.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        scope: import("@oclif/core/interfaces").OptionFlag<"projects" | "issues" | "merge_requests" | "milestones" | "wiki_blobs" | "commits" | "blobs" | "notes" | "users" | "snippet_titles", import("@oclif/core/interfaces").CustomOptions>;
+        query: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        group: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number>;
+    };
+    run(): Promise<unknown>;
+}

package/lib/commands/gitlab/search.js

@@ -0,0 +1,68 @@
+/*
+ * 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, needsAdvancedSearch, searchColumns, } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, limitFlag } from '../../shared/base-command.js';
+const DEFAULT_LIMIT = 20;
+const SCOPES = [
+    'projects',
+    'issues',
+    'merge_requests',
+    'milestones',
+    'wiki_blobs',
+    'commits',
+    'blobs',
+    'notes',
+    'users',
+    'snippet_titles',
+];
+export default class GitlabSearch extends GitLabCommand {
+    static summary = 'Search GitLab.';
+    static description = 'Searches the whole instance by default, or one project with --project, or one group with ' +
+        '--group. These are three different GitLab endpoints, and they do not accept the same scopes: ' +
+        'projects and users are instance-wide only, while a project search can look at notes.\n\n' +
+        'The blobs, commits, wiki_blobs, notes, and snippet_titles scopes need Advanced Search ' +
+        '(Elasticsearch) enabled on the instance. Where it is not, GitLab answers with an empty list ' +
+        'and a 200 rather than an error, so an empty result for one of those scopes is reported here ' +
+        'as possibly meaning "not enabled" rather than "no matches".';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --scope projects --query platform',
+        '<%= config.bin %> <%= command.id %> --scope blobs --query UMCN_Account --project group/project',
+        '<%= config.bin %> <%= command.id %> --scope merge_requests --query "flaky test" --group my-group --json',
+    ];
+    static flags = {
+        ...limitFlag(DEFAULT_LIMIT, 'results'),
+        scope: Flags.option({ summary: 'What to search.', options: SCOPES, required: true })(),
+        query: Flags.string({ summary: 'The search term.', required: true }),
+        project: Flags.string({ summary: 'Search within this project id or path.', exclusive: ['group'] }),
+        group: Flags.string({ summary: 'Search within this group id or path.' }),
+    };
+    async run() {
+        const scope = this.flags.scope;
+        const result = await this.gitlab().search({ scope, search: this.flags.query, project: this.flags.project, group: this.flags.group }, this.flags.limit);
+        if (result.items.length === 0) {
+            const caveat = needsAdvancedSearch(scope)
+                ? ` The ${scope} scope needs Advanced Search on the instance; without it GitLab returns an empty list rather than an error.`
+                : '';
+            this.log(`No results.${caveat}`);
+            return result;
+        }
+        this.logSafe(formatTable(result.items, searchColumns(scope)));
+        this.reportList(result.items.length, result.total, result.complete, this.flags.limit, 'result(s)');
+        return result;
+    }
+}
+//# sourceMappingURL=search.js.map

package/lib/commands/gitlab/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/commands/gitlab/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,GAGd,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAExE,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,MAAM,MAAM,GAAG;IACb,UAAU;IACV,QAAQ;IACR,gBAAgB;IAChB,YAAY;IACZ,YAAY;IACZ,SAAS;IACT,OAAO;IACP,OAAO;IACP,OAAO;IACP,gBAAgB;CACR,CAAC;AAEX,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,aAAkC;IACnE,MAAM,CAAmB,OAAO,GAAG,gBAAgB,CAAC;IACpD,MAAM,CAAmB,WAAW,GACzC,2FAA2F;QAC3F,+FAA+F;QAC/F,0FAA0F;QAC1F,wFAAwF;QACxF,8FAA8F;QAC9F,8FAA8F;QAC9F,6DAA6D,CAAC;IAEzD,MAAM,CAAmB,QAAQ,GAAG;QACzC,uEAAuE;QACvE,gGAAgG;QAChG,yGAAyG;KAC1G,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,SAAS,CAAC,aAAa,EAAE,SAAS,CAAC;QACtC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE;QACtF,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACpE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,wCAAwC,EAAE,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAClG,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;KACzE,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,KAAK,GAAgB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CACvC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EACzF,IAAI,CAAC,KAAK,CAAC,KAAK,CACjB,CAAC;QAEF,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC;gBACvC,CAAC,CAAC,QAAQ,KAAK,6GAA6G;gBAC5H,CAAC,CAAC,EAAE,CAAC;YACP,IAAI,CAAC,GAAG,CAAC,cAAc,MAAM,EAAE,CAAC,CAAC;YACjC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,KAAc,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QACnG,OAAO,MAAM,CAAC;IAChB,CAAC"}

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

@@ -0,0 +1,14 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabTagList extends GitLabCommand<typeof GitlabTagList> {
+    static readonly summary = "List repository tags.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'order-by': import("@oclif/core/interfaces").OptionFlag<"name" | "updated" | "version" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sort: import("@oclif/core/interfaces").OptionFlag<"asc" | "desc" | 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/tag/list.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 { formatTable, tagColumns } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, limitFlag, projectFlag } from '../../../shared/base-command.js';
+const DEFAULT_LIMIT = 20;
+export default class GitlabTagList extends GitLabCommand {
+    static summary = 'List repository tags.';
+    static 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.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --project group/project',
+        '<%= config.bin %> <%= command.id %> --project group/project --search v1. --limit 50',
+    ];
+    static flags = {
+        ...projectFlag,
+        ...limitFlag(DEFAULT_LIMIT, 'tags'),
+        search: Flags.string({ summary: 'Return only tags whose name contains this term.' }),
+        'order-by': Flags.option({
+            summary: 'Field to sort by.',
+            options: ['name', 'updated', 'version'],
+        })(),
+        sort: Flags.option({ summary: 'Sort direction.', options: ['asc', 'desc'] })(),
+    };
+    async run() {
+        const result = await this.gitlab().listTags(this.flags.project, { search: this.flags.search, orderBy: this.flags['order-by'], sort: this.flags.sort }, this.flags.limit);
+        if (result.items.length === 0) {
+            this.log('No tags matched.');
+            return result;
+        }
+        this.logSafe(formatTable(result.items, tagColumns));
+        this.reportList(result.items.length, result.total, result.complete, this.flags.limit, 'tag(s)');
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/commands/gitlab/tag/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,iCAAiC,CAAC;AAExF,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,aAAmC;IACrE,MAAM,CAAmB,OAAO,GAAG,uBAAuB,CAAC;IAC3D,MAAM,CAAmB,WAAW,GACzC,6FAA6F;QAC7F,2FAA2F;QAC3F,4DAA4D,CAAC;IAExD,MAAM,CAAmB,QAAQ,GAAG;QACzC,6DAA6D;QAC7D,qFAAqF;KACtF,CAAC;IAEK,MAAM,CAAmB,KAAK,GAAG;QACtC,GAAG,WAAW;QACd,GAAG,SAAS,CAAC,aAAa,EAAE,MAAM,CAAC;QACnC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,iDAAiD,EAAE,CAAC;QACpF,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC;YACvB,OAAO,EAAE,mBAAmB;YAC5B,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAU;SACjD,CAAC,EAAE;QACJ,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAU,EAAE,CAAC,EAAE;KACxF,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CACzC,IAAI,CAAC,KAAK,CAAC,OAAO,EAClB,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EACrF,IAAI,CAAC,KAAK,CAAC,KAAK,CACjB,CAAC;QAEF,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"}