@simplysf/simply-gitlab 0.1.0

package/lib/index.d.ts

@@ -0,0 +1 @@
+export { AuthError, CliError, ConfigError, GitLabClient, HttpError, NetworkError, resolveGitLabConfig, type ConfigOverrides, type EnvLike, type GitLabConfig, type ListResult, type ProjectRef, } from '@simplysf/simply-gitlab-core';

package/lib/index.js

@@ -0,0 +1,22 @@
+/*
+ * 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.
+ */
+// This package is a CLI first (see bin/run.js). The library surface lives in
+// `@simplysf/simply-gitlab-core`; these re-exports exist so a consumer that installed the CLI can
+// reach the client without a second dependency, and so the two packages cannot drift on the names
+// they use for the same thing. New code should import the core package directly, which is where
+// anything added from here on will appear.
+export { AuthError, CliError, ConfigError, GitLabClient, HttpError, NetworkError, resolveGitLabConfig, } from '@simplysf/simply-gitlab-core';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,6EAA6E;AAC7E,kGAAkG;AAClG,kGAAkG;AAClG,gGAAgG;AAChG,2CAA2C;AAC3C,OAAO,EACL,SAAS,EACT,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,mBAAmB,GAMpB,MAAM,8BAA8B,CAAC"}

package/lib/shared/base-command.d.ts

@@ -0,0 +1,91 @@
+import { Command, type Interfaces } from '@oclif/core';
+import { GitLabClient, type GitLabConfig } from '@simplysf/simply-gitlab-core';
+/**
+ * Splits a comma-separated flag value, dropping blanks. `--labels ''` and `--labels 'a,'` would
+ * otherwise yield an empty label, which GitLab stores as one.
+ */
+export declare function parseList(value: string | undefined): string[] | undefined;
+/**
+ * Flags every write command shares, defined once so the wording cannot drift between them.
+ *
+ * There is no `--confirm` here, because no command in this CLI destroys anything yet — every
+ * write either creates something or edits a merge request, and both are recoverable. Requiring
+ * a confirmation for those would train a caller to pass it always, at which point it protects
+ * nothing while still implying that it does. The first command that deletes a branch, a tag, or
+ * a file is the one that brings the flag back.
+ */
+export declare const writeFlags: {
+    'dry-run': Interfaces.BooleanFlag<boolean>;
+};
+/** The project selector, on every command that is scoped to one. */
+export declare const projectFlag: {
+    project: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
+};
+/** The paging ceiling, worded once so every list command reads the same. */
+export declare function limitFlag(fallback: number, what: string): {
+    limit: Interfaces.OptionFlag<number>;
+};
+declare const gitlabFlags: {
+    'gitlab-url': Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+    'gitlab-token': Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+    'env-file': Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+};
+export type GitLabFlags<T extends typeof Command> = Interfaces.InferredFlags<typeof gitlabFlags & T['flags']>;
+export type CommandArgs<T extends typeof Command> = Interfaces.InferredArgs<T['args']>;
+/**
+ * Everything every command shares: `--json` (oclif prints whatever `run()` returns, verbatim),
+ * the `--gitlab-*` connection flags, `--env-file` loading, and turning failures into stable exit
+ * codes without letting anything reach stdout.
+ *
+ * GitLab is one product with one API, so unlike the Atlassian CLI this repo is modelled on there
+ * is no second base class per product — the connection flags live here directly.
+ */
+export declare abstract class GitLabCommand<T extends typeof Command> extends Command {
+    static enableJsonFlag: boolean;
+    static baseFlags: {
+        'gitlab-url': Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        'gitlab-token': Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        'env-file': Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+    };
+    /**
+     * Set by any command that changes data. The read-only guard is then enforced centrally in
+     * `init()`, so a future write command cannot forget to call it — which is exactly the kind
+     * of omission that would go unnoticed until it mattered.
+     */
+    static isWrite: boolean;
+    protected args: CommandArgs<T>;
+    protected rawFlags: Record<string, unknown>;
+    protected get flags(): GitLabFlags<T>;
+    init(): Promise<void>;
+    protected gitlab(): GitLabClient;
+    /** Explicit flags outrank the environment, which outranks the `--env-file` contents. */
+    protected gitlabConfig(): GitLabConfig;
+    /**
+     * Turns any failure into one compact, machine-readable line on stderr plus a stable exit
+     * code, and never lets a failure reach stdout.
+     *
+     * This has to cover *every* error, not just this CLI's own: oclif's default `--json` error
+     * path serializes its whole parse context — including the raw argv, and therefore any token
+     * passed as a flag — to stdout. For a caller that captures stdout into an AI agent's
+     * context, that is a credential disclosure, so the default path is never taken here.
+     *
+     * Exit codes stay identical with and without `--json`: 2 config or usage, 3 auth, 1
+     * everything else.
+     */
+    protected catch(error: Interfaces.CommandError): Promise<unknown>;
+    /**
+     * Logs a line that contains server-supplied text. Everything the instance chose is stripped of
+     * control characters first — the same treatment error output gets, and for the same reason:
+     * this stream is parsed by an agent, and a bare escape sequence can make what a person sees
+     * differ from what the agent ingests.
+     *
+     * Repository file contents and job traces come through here too. Those are the widest input of
+     * all: anyone who can open a merge request controls them.
+     */
+    protected logSafe(message: string): void;
+    /** Renders a list result and says plainly whether the limit cut it short. */
+    protected reportList(count: number, total: number | undefined, complete: boolean, limit: number, what: string): void;
+    /** Narrowed accessor so subclasses read flags without casting at every use. */
+    protected flagValue(name: string): string | undefined;
+}
+export {};

package/lib/shared/base-command.js

@@ -0,0 +1,242 @@
+/*
+ * 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 process from 'node:process';
+import { Command, Flags } from '@oclif/core';
+import { assertWritesAllowed, AuthError, CliError, collectSecrets, GitLabClient, HttpError, loadEnvFile, redactSecrets, resolveGitLabConfig, sanitiseDeep, SECRET_ENV, stripControl, } from '@simplysf/simply-gitlab-core';
+/**
+ * Splits a comma-separated flag value, dropping blanks. `--labels ''` and `--labels 'a,'` would
+ * otherwise yield an empty label, which GitLab stores as one.
+ */
+export function parseList(value) {
+    if (value === undefined)
+        return undefined;
+    const items = value
+        .split(',')
+        .map((item) => item.trim())
+        .filter((item) => item !== '');
+    return items.length === 0 ? undefined : items;
+}
+/** Credential flags, used both to declare them and to scrub their values out of any output. */
+const SECRET_FLAGS = new Set(['gitlab-token']);
+/**
+ * Every credential that could otherwise ride along in an error message. Values are collected
+ * from the process arguments and environment rather than parsed flags, because the errors most
+ * likely to echo an argument are the ones thrown before parsing finishes. The redaction itself
+ * is the core package's, shared with the MCP server; only the argv half is this CLI's.
+ */
+function secrets() {
+    const values = [];
+    const argv = process.argv;
+    for (const [index, arg] of argv.entries()) {
+        if (arg.startsWith('--') && SECRET_FLAGS.has(arg.slice(2)))
+            values.push(argv[index + 1]);
+        const inline = /^--([a-z-]+)=(.+)$/.exec(arg);
+        if (inline?.[1] !== undefined && SECRET_FLAGS.has(inline[1]))
+            values.push(inline[2]);
+    }
+    for (const name of SECRET_ENV)
+        values.push(process.env[name]);
+    return collectSecrets(values);
+}
+/** Names the failure for a machine reader: our own errors keep their class name. */
+function errorName(error, oclifExit) {
+    if (error instanceof CliError)
+        return error.name;
+    return oclifExit === undefined ? 'Error' : 'UsageError';
+}
+/**
+ * Flags every write command shares, defined once so the wording cannot drift between them.
+ *
+ * There is no `--confirm` here, because no command in this CLI destroys anything yet — every
+ * write either creates something or edits a merge request, and both are recoverable. Requiring
+ * a confirmation for those would train a caller to pass it always, at which point it protects
+ * nothing while still implying that it does. The first command that deletes a branch, a tag, or
+ * a file is the one that brings the flag back.
+ */
+export const writeFlags = {
+    'dry-run': Flags.boolean({
+        summary: 'Print the request that would be sent and exit without sending it.',
+        default: false,
+    }),
+};
+/** The project selector, on every command that is scoped to one. */
+export const projectFlag = {
+    project: Flags.string({
+        char: 'p',
+        summary: 'Project id, or its full path such as group/subgroup/project.',
+        required: true,
+        env: 'GITLAB_PROJECT',
+    }),
+};
+/** The paging ceiling, worded once so every list command reads the same. */
+export function limitFlag(fallback, what) {
+    return {
+        limit: Flags.integer({
+            summary: `Maximum number of ${what} to return across all pages.`,
+            default: fallback,
+            min: 1,
+        }),
+    };
+}
+const envFileFlag = {
+    'env-file': Flags.string({
+        char: 'e',
+        summary: 'Path to a .env file holding connection settings.',
+        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',
+    }),
+};
+const gitlabFlags = {
+    ...envFileFlag,
+    'gitlab-url': Flags.string({
+        summary: 'Base URL of the GitLab instance. Defaults to https://gitlab.com.',
+        env: 'GITLAB_URL',
+        helpGroup: 'CONNECTION',
+    }),
+    'gitlab-token': Flags.string({
+        summary: 'Personal, project, or group access token.',
+        env: 'GITLAB_TOKEN',
+        helpGroup: 'CONNECTION',
+    }),
+};
+/**
+ * Everything every command shares: `--json` (oclif prints whatever `run()` returns, verbatim),
+ * the `--gitlab-*` connection flags, `--env-file` loading, and turning failures into stable exit
+ * codes without letting anything reach stdout.
+ *
+ * GitLab is one product with one API, so unlike the Atlassian CLI this repo is modelled on there
+ * is no second base class per product — the connection flags live here directly.
+ */
+export class GitLabCommand extends Command {
+    static enableJsonFlag = true;
+    static baseFlags = gitlabFlags;
+    /**
+     * Set by any command that changes data. The read-only guard is then enforced centrally in
+     * `init()`, so a future write command cannot forget to call it — which is exactly the kind
+     * of omission that would go unnoticed until it mattered.
+     */
+    static isWrite = false;
+    args;
+    rawFlags = {};
+    get flags() {
+        return this.rawFlags;
+    }
+    async init() {
+        await super.init();
+        const { args, flags } = await this.parse({
+            baseFlags: this.constructor.baseFlags,
+            flags: this.ctor.flags,
+            enableJsonFlag: this.ctor.enableJsonFlag,
+            args: this.ctor.args,
+            strict: this.ctor.strict,
+        });
+        this.args = args;
+        this.rawFlags = flags;
+        // Applied here, before anything reads configuration, so every later lookup sees the file.
+        const envFile = this.rawFlags['env-file'];
+        if (typeof envFile === 'string')
+            loadEnvFile(envFile);
+        // After the env file, so a read-only guard carried in a credential file is honoured, and
+        // before run(), so no write command can issue a request first.
+        if (this.constructor.isWrite)
+            assertWritesAllowed();
+    }
+    gitlab() {
+        return new GitLabClient(this.gitlabConfig());
+    }
+    /** Explicit flags outrank the environment, which outranks the `--env-file` contents. */
+    gitlabConfig() {
+        const overrides = {
+            url: this.flagValue('gitlab-url'),
+            token: this.flagValue('gitlab-token'),
+        };
+        return resolveGitLabConfig(overrides);
+    }
+    /**
+     * Turns any failure into one compact, machine-readable line on stderr plus a stable exit
+     * code, and never lets a failure reach stdout.
+     *
+     * This has to cover *every* error, not just this CLI's own: oclif's default `--json` error
+     * path serializes its whole parse context — including the raw argv, and therefore any token
+     * passed as a flag — to stdout. For a caller that captures stdout into an AI agent's
+     * context, that is a credential disclosure, so the default path is never taken here.
+     *
+     * Exit codes stay identical with and without `--json`: 2 config or usage, 3 auth, 1
+     * everything else.
+     */
+    async catch(error) {
+        // oclif attaches its own exit code to usage errors; reuse it so --json and plain runs agree.
+        const oclifExit = error.oclif?.exit;
+        const exitCode = error instanceof CliError ? error.exitCode : (oclifExit ?? 1);
+        // Error text can quote a server response body, which is as attacker-influenced as any other
+        // field the instance returns. Control-stripped but NOT collapsed to one line: newlines here
+        // are this CLI's own. Server-supplied text is made single-line where it is interpolated
+        // instead — see `formatSnippet` in core/http.ts.
+        const redact = secrets();
+        const message = stripControl(redactSecrets(error.message, redact));
+        if (this.jsonEnabled()) {
+            // Written straight to the stream: oclif silences this.log/logToStderr under --json.
+            process.stderr.write(`${JSON.stringify({
+                error: {
+                    name: errorName(error, oclifExit),
+                    message,
+                    exitCode,
+                    ...(error instanceof HttpError ? { status: error.status, body: sanitiseDeep(error.body, redact) } : {}),
+                    ...(error instanceof AuthError ? { status: error.status } : {}),
+                },
+            })}\n`);
+            this.exit(exitCode);
+        }
+        if (error instanceof CliError) {
+            this.error(message, { exit: exitCode, code: error.name });
+        }
+        // An unexpected error — a TypeError from a malformed payload, say — would otherwise reach
+        // oclif's default handler carrying the original, unsanitised and unredacted text. Rethrow
+        // the sanitised message instead, preserving the exit code oclif attached.
+        const sanitised = new Error(message);
+        Object.assign(sanitised, { oclif: { exit: exitCode } });
+        return super.catch(sanitised);
+    }
+    /**
+     * Logs a line that contains server-supplied text. Everything the instance chose is stripped of
+     * control characters first — the same treatment error output gets, and for the same reason:
+     * this stream is parsed by an agent, and a bare escape sequence can make what a person sees
+     * differ from what the agent ingests.
+     *
+     * Repository file contents and job traces come through here too. Those are the widest input of
+     * all: anyone who can open a merge request controls them.
+     */
+    logSafe(message) {
+        // Redacted as well as stripped. `--body-file` reads any readable path and `--dry-run` prints
+        // what would be sent, so a caller who points it at a `.env` by mistake would otherwise put a
+        // live token on stdout — and, without --dry-run, into a commit other people fetch.
+        this.log(stripControl(redactSecrets(message, secrets())));
+    }
+    /** Renders a list result and says plainly whether the limit cut it short. */
+    reportList(count, total, complete, limit, what) {
+        const scope = total === undefined ? '' : ` of ${total}`;
+        const note = complete ? '' : ` (limit ${limit} reached; more available)`;
+        this.log(`\nShowing ${count}${scope} ${what}${note}.`);
+    }
+    /** Narrowed accessor so subclasses read flags without casting at every use. */
+    flagValue(name) {
+        const value = this.rawFlags[name];
+        return typeof value === 'string' ? value : undefined;
+    }
+}
+//# sourceMappingURL=base-command.js.map

package/lib/shared/base-command.js.map

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

package/package.json

@@ -0,0 +1,243 @@
+{
+  "name": "@simplysf/simply-gitlab",
+  "description": "Command-line interface for working with GitLab",
+  "version": "0.1.0",
+  "author": "@ClayChipps",
+  "homepage": "https://github.com/SimplySF/simply-gitlab",
+  "bugs": "https://github.com/SimplySF/simply-gitlab/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SimplySF/simply-gitlab",
+    "directory": "packages/simply-gitlab"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "files": [
+    "/lib",
+    "/oclif.lock",
+    "/oclif.manifest.json"
+  ],
+  "keywords": [
+    "oclif",
+    "gitlab",
+    "ci",
+    "merge-requests",
+    "simply"
+  ],
+  "license": "Apache-2.0",
+  "exports": "./lib/index.js",
+  "type": "module",
+  "types": "./lib/index.d.ts",
+  "bin": {
+    "simply": "./bin/run.js"
+  },
+  "oclif": {
+    "additionalVersionFlags": [
+      "-v"
+    ],
+    "additionalHelpFlags": [
+      "-h"
+    ],
+    "bin": "simply",
+    "commands": "./lib/commands",
+    "devPlugins": [
+      "@oclif/plugin-command-snapshot"
+    ],
+    "flexibleTaxonomy": true,
+    "plugins": [],
+    "repositoryPrefix": "<%- repo %>/blob/@simplysf/simply-gitlab@<%- version %>/packages/simply-gitlab/<%- commandPath %>",
+    "topicSeparator": " ",
+    "topics": {
+      "gitlab": {
+        "description": "Work with GitLab."
+      },
+      "gitlab:project": {
+        "description": "Read project metadata."
+      },
+      "gitlab:file": {
+        "description": "Read and write repository files."
+      },
+      "gitlab:branch": {
+        "description": "List and create branches."
+      },
+      "gitlab:commit": {
+        "description": "Read history and commit changes."
+      },
+      "gitlab:mr": {
+        "description": "Read and manage merge requests."
+      },
+      "gitlab:tag": {
+        "description": "List repository tags."
+      },
+      "gitlab:release": {
+        "description": "List releases."
+      },
+      "gitlab:ci": {
+        "description": "Inspect CI/CD jobs, variables, and environments."
+      },
+      "gitlab:ci:job": {
+        "description": "List CI jobs and read their logs."
+      },
+      "gitlab:ci:variable": {
+        "description": "List CI/CD variables."
+      },
+      "gitlab:ci:environment": {
+        "description": "List deployment environments."
+      }
+    }
+  },
+  "dependencies": {
+    "@oclif/core": "^4.11.2",
+    "@simplysf/simply-gitlab-core": "workspace:^0.1.0"
+  },
+  "devDependencies": {
+    "@oclif/plugin-command-snapshot": "^5.4.0",
+    "@vitest/coverage-v8": "^4.1.10",
+    "vitest": "^4.1.10"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "wireit",
+    "compile": "wireit",
+    "fix-license": "eslint src test --fix --rule \"header/header: [2]\"",
+    "format": "wireit",
+    "lint": "wireit",
+    "readme": "oclif readme --no-aliases",
+    "test": "wireit",
+    "test:coverage": "wireit",
+    "test:only": "wireit",
+    "test:watch": "wireit"
+  },
+  "wireit": {
+    "build": {
+      "dependencies": [
+        "command-snapshot",
+        "compile",
+        "lint"
+      ]
+    },
+    "compile": {
+      "command": "tsc -p . --pretty --incremental",
+      "files": [
+        "src/**/*.ts",
+        "**/tsconfig.json",
+        "../../tsconfig.json"
+      ],
+      "output": [
+        "lib/**",
+        "*.tsbuildinfo"
+      ],
+      "clean": "if-file-deleted",
+      "dependencies": [
+        "../simply-gitlab-core:compile"
+      ]
+    },
+    "format": {
+      "command": "prettier --write \"+(src|test)/**/*.+(ts|js|json)|command-snapshot.json\"",
+      "files": [
+        "src/**/*.ts",
+        "test/**/*.ts",
+        "command-snapshot.json",
+        ".prettier*"
+      ],
+      "output": []
+    },
+    "lint": {
+      "command": "eslint src test --color --cache --cache-location .eslintcache",
+      "files": [
+        "src/**/*.ts",
+        "test/**/*.ts",
+        "**/.eslint*",
+        "**/tsconfig.json",
+        "../../eslint.config.mjs",
+        "../../tsconfig.json"
+      ],
+      "output": [],
+      "dependencies": [
+        "../simply-gitlab-core:compile"
+      ]
+    },
+    "test": {
+      "dependencies": [
+        "test:compile",
+        "test:only",
+        "lint"
+      ]
+    },
+    "command-snapshot": {
+      "command": "node --loader ts-node/esm --no-warnings=ExperimentalWarning \"./bin/dev.js\" snapshot:generate && prettier --write command-snapshot.json",
+      "files": [
+        "src/**/*.ts"
+      ],
+      "output": [
+        "command-snapshot.json"
+      ],
+      "dependencies": [
+        "compile"
+      ]
+    },
+    "test:compile": {
+      "command": "tsc -p \"./test\" --pretty",
+      "files": [
+        "test/**/*.ts",
+        "**/tsconfig.json",
+        "../../tsconfig.json"
+      ],
+      "output": [],
+      "dependencies": [
+        "../simply-gitlab-core:compile"
+      ]
+    },
+    "test:only": {
+      "command": "vitest run --project simply-gitlab",
+      "env": {
+        "FORCE_COLOR": "2"
+      },
+      "files": [
+        "test/**/*.ts",
+        "src/**/*.ts",
+        "**/tsconfig.json",
+        "../../tsconfig.json",
+        "vitest.config.ts",
+        "!*.nut.ts"
+      ],
+      "output": [],
+      "dependencies": [
+        "../simply-gitlab-core:compile"
+      ]
+    },
+    "test:coverage": {
+      "command": "vitest run --coverage --project simply-gitlab",
+      "env": {
+        "FORCE_COLOR": "2"
+      },
+      "dependencies": [
+        "../simply-gitlab-core:compile"
+      ],
+      "files": [
+        "test/**/*.ts",
+        "src/**/*.ts",
+        "**/tsconfig.json",
+        "../../tsconfig.json",
+        "vitest.config.ts",
+        "!*.nut.ts"
+      ],
+      "output": [
+        "coverage/**"
+      ]
+    },
+    "test:watch": {
+      "command": "vitest watch --project simply-gitlab",
+      "env": {
+        "FORCE_COLOR": "2"
+      },
+      "dependencies": [
+        "../simply-gitlab-core:compile"
+      ],
+      "service": true
+    }
+  }
+}