@simplysf/simply-gitlab 0.4.0 → 0.6.0

package/docs/guides/credentials.md

@@ -0,0 +1,100 @@
+---
+title: Credentials
+description: How the Simply GitLab CLI finds its connection settings, which token scope to use, and how flags, environment variables, and an env file take precedence.
+---
+
+Connection settings come from environment variables, from flags, or from a `.env` file named with
+`-e/--env-file`. Only GitLab connection variables are read from that file; anything else in it is
+ignored.
+
+```
+GITLAB_TOKEN=glpat-...
+GITLAB_URL=https://gitlab.example.com   # omit entirely for gitlab.com
+```
+
+There are only two settings, and one of them has a default — `GITLAB_URL` is `https://gitlab.com`
+unless you say otherwise. A gitlab.com user needs the token and nothing else.
+
+## Tokens and scopes
+
+The token is a personal access token (**Preferences › Access tokens**), a project access token, or
+a group access token. All three work the same way; the CLI sends whichever you give it as GitLab's
+`PRIVATE-TOKEN` header.
+
+| Scope      | Covers                                      |
+| ---------- | ------------------------------------------- |
+| `read_api` | Every read command on this site. No writes. |
+| `api`      | Reads and writes.                           |
+
+Prefer `read_api` and reach for `api` only when you mean to change something — see
+[Write safety](/guides/write-safety/) for why that distinction carries more weight than it looks
+like it should.
+
+OAuth 2 tokens are not supported: GitLab accepts those only as `Authorization: Bearer`, and this
+CLI runs no OAuth flow.
+
+## Precedence
+
+Explicit flags beat the environment, which beats the file's contents. That ordering is what makes
+the two-file arrangement in [Write safety](/guides/write-safety/) work: a `read_api` file can be
+the default, and a write-capable one is named explicitly for the one command that needs it.
+
+```sh
+simply gitlab mr list -e ~/gitlab.env --project group/project
+simply gitlab mr update -e ~/gitlab-write.env --project group/project --mr 42 --state close
+```
+
+A variable exported as an empty string does not outrank the file. `export GITLAB_TOKEN=` in a
+wrapper script would otherwise discard the real token and fail as though nothing were configured.
+
+## Naming a project
+
+Not a credential, but it belongs in the same shell profile. `GITLAB_PROJECT` sets the default for
+`-p/--project`:
+
+```sh
+export GITLAB_PROJECT=group/subgroup/project
+simply gitlab mr list
+```
+
+A project is named by numeric id or full path, and the path is URL-encoded for you.
+
+## Self-managed instances
+
+Set `GITLAB_URL` to the instance origin. A subpath is kept, because self-managed instances are
+routinely served from one:
+
+```
+GITLAB_URL=https://example.com/gitlab
+```
+
+One thing to watch: pasting a **project** URL from gitlab.com — `https://gitlab.com/group/project`
+— sets the instance, not the project. The CLI keeps only the origin in that case, since gitlab.com
+has no subpath. On a self-managed host it cannot tell a subpath from a project path, so give it the
+instance root and name the project with `--project`.
+
+## Certificate verification
+
+Certificate verification is always on. For an instance behind an internal or agency certificate
+authority, trust that CA rather than disabling verification:
+
+```sh
+NODE_EXTRA_CA_CERTS=/path/to/ca.pem simply gitlab project list
+```
+
+A `GITLAB_SSL_VERIFY=false` carried over from other GitLab tooling is rejected with an error rather
+than silently ignored, so nobody ends up believing verification is off when it is on, or the
+reverse.
+
+## Checking what you're connected as
+
+There is no `whoami` command. The cheapest check is a list you expect to be non-empty:
+
+```sh
+simply gitlab project list --membership --limit 5
+```
+
+A wrong or expired token comes back as an authentication error with exit code `3`. A `403` on a
+command that changes data says the token may be `read_api`-scoped, or that your role on the project
+does not permit the change — so a refused write is distinguishable from a genuine permissions
+problem.

package/docs/guides/scripting.md

@@ -0,0 +1,122 @@
+---
+title: Scripts and agents
+description: The output contract that makes the Simply GitLab CLI safe to drive from a shell script or an AI agent - raw JSON, stable exit codes, honest truncation, no prompts.
+---
+
+The CLI is designed for two callers at once: a person at a terminal, and a script or AI agent
+running it as shell commands. The defaults serve the person; a small, stable contract serves the
+script.
+
+## `--json` returns the raw API payload
+
+Every command accepts `--json`, without exception. The output is the unmodified response from the
+GitLab API — the full object, not the curated subset the table shows — so anything the API exposes
+is reachable with `jq`, and the payload shape is GitLab's contract rather than this CLI's.
+
+```sh
+simply gitlab mr view --project group/project --mr 42 --json | jq -r '.detailed_merge_status'
+```
+
+## Lists tell you when they were cut short
+
+Every list command follows pages up to `--limit`, so there is no single response to hand back.
+They return an envelope instead:
+
+```json
+{ "items": [...], "total": 500, "pages": 3, "complete": false }
+```
+
+The elements inside `items` are still raw API objects. **`complete: false` means `--limit` cut the
+results short** and more exist, so a caller can detect truncation without counting rows. `total` is
+present only when GitLab reports one — keyset-paginated endpoints and very large result sets omit
+it, so treat a missing `total` as unknown rather than zero.
+
+```sh
+out=$(simply gitlab mr list --project group/project --state all --limit 100 --json)
+if [ "$(jq -r .complete <<<"$out")" = "false" ]; then
+  echo "more than 100 merge requests; raise --limit" >&2
+fi
+```
+
+## Exit codes and errors
+
+Errors carry no stack trace and map to stable exit codes:
+
+| Exit code | Meaning                                                    |
+| --------- | ---------------------------------------------------------- |
+| `0`       | Success                                                    |
+| `2`       | Configuration or usage problem, e.g. a missing token       |
+| `3`       | Authentication or authorization failure                    |
+| `1`       | Anything else, including an API error or a network failure |
+
+Under `--json`, a failure is written as one JSON object on **stderr** and stdout stays empty, so a
+caller that captures stdout never has to disambiguate an error from a payload. The object nests
+under an `error` key:
+
+```json
+{ "error": { "name": "HttpError", "message": "...", "exitCode": 1, "status": 404, "body": {} } }
+```
+
+`body` carries the API's own response when there was one. Every string in the object — the message
+and everything inside `body` — is scrubbed of any known credential value and of characters that
+could rewrite the terminal or hide text, so a response that quotes your token back at you does not
+put it on the stream.
+
+```sh
+if ! out=$(simply gitlab mr view --project group/project --mr 999 --json 2>err.json); then
+  case $? in
+    3) echo "credentials rejected";;
+    *) jq -r .error.message err.json;;
+  esac
+fi
+```
+
+## Address merge requests by `iid`
+
+A merge request has both an `id` and an `iid`. Both are bare integers, both appear in every
+payload, and the endpoints take the **`iid`** — the number in the web URL. Passing the wrong one
+does not fail: it addresses a different merge request in a different project that happens to share
+the number.
+
+The CLI validates the shape and refuses anything that is not a positive whole number, but it cannot
+catch a valid-looking wrong number. When scripting, read `iid` from the list output, never `id`:
+
+```sh
+simply gitlab mr list --project group/project --json | jq -r '.items[].iid'
+```
+
+## Keep payloads small
+
+`--simple` on `project list` returns a much smaller object. `--stat` on `commit diff` lists the
+changed files without the hunks. `--tail` on `ci job log` defaults to the last 200 lines, because a
+trace is regularly tens of megabytes and an agent pays for every token it reads:
+
+```sh
+simply gitlab ci job list --project group/project --scope failed --limit 5 --json \
+  | jq -r '.items[0].id' \
+  | xargs -I{} simply gitlab ci job log --project group/project --job {} --tail 50
+```
+
+## Retries are handled for you
+
+429 and 5xx responses retry with exponential backoff, honouring a capped `Retry-After`. DNS
+failures and certificate problems do not retry, because another attempt cannot fix them. A script
+does not need its own retry loop around these commands.
+
+## Never interactive
+
+No command prompts or blocks on stdin, and there is no `--confirm` flag to hang on. Every write
+takes `--dry-run` instead. See [Write safety](/guides/write-safety/) for the full set of layers and
+the two-credential-file arrangement that keeps an agent's normal loop read-only.
+
+## Help is discovery
+
+`--help` output is generated from the command classes and written to be self-sufficient, so an
+agent can discover flags and examples the same way a person does:
+
+```sh
+simply gitlab mr --help
+simply gitlab mr create --help
+```
+
+The same text, for every command, is on the [Command Reference](/reference/) pages.

package/docs/guides/write-safety.md

@@ -0,0 +1,122 @@
+---
+title: Write safety
+description: The layers between a Simply GitLab command and a change to your repository, which of them is a real boundary, and why CI variable values are hidden by default.
+---
+
+Seven commands change data — `project create`, `branch create`, `file create`, `file update`,
+`commit create`, `mr create`, and `mr update`. Nothing in this CLI deletes anything. Those seven sit
+behind several layers, and only the last is a real boundary.
+
+## No `--confirm`, deliberately
+
+Every write here either creates something or edits a merge request, and both are recoverable: a
+branch can be deleted, a file can be committed over, a closed merge request can be reopened.
+Requiring a confirmation for actions like those would train you to pass it always, at which point
+it protects nothing while still implying that it does.
+
+So there is no `--confirm` flag anywhere in this CLI. The first command that irreversibly destroys
+something is the one that brings it back.
+
+## `--dry-run`
+
+Accepted by all seven. It prints the exact request body that would be sent and sends nothing, which
+is the cheapest way to see what is about to happen. The one nuance is `project create`: a namespace
+or template given as a path is still looked up, so the printed ids are the ones that would be sent.
+
+```sh
+simply gitlab mr create --project group/project \
+  --source-branch feature/thing --target-branch main --title "feat: the thing" --dry-run
+```
+
+```
+Dry run — not sent. Request body:
+{
+  "source_branch": "feature/thing",
+  "target_branch": "main",
+  "title": "feat: the thing"
+}
+```
+
+## `--last-commit-id` on a file update
+
+`file update` replaces the whole file; there is no partial edit. That makes a lost-update race real
+whenever two people or two runs touch the same file. `file view` reports the file's last commit,
+and passing it back makes GitLab reject the write if anything changed meanwhile:
+
+```sh
+simply gitlab file view --project group/project --path README.md --ref main
+# Last commit: 9a1b2c3
+
+simply gitlab file update --project group/project --path README.md --branch main \
+  --content-file ./README.md --message "docs: refresh" --last-commit-id 9a1b2c3
+```
+
+Without it, the last writer silently wins.
+
+## `GITLAB_READ_ONLY`
+
+Set it to `1`, `true`, `yes`, or `on` and every write command refuses before making any request.
+Reads are unaffected. This guards against misconfiguration: the wrong credential file, the wrong
+project, the wrong context. It is not a security boundary, because anything that can run commands
+can also unset an environment variable.
+
+## A `read_api` token
+
+This is the only layer that actually binds. A `read_api`-scoped token cannot create, edit, or push
+anything — GitLab refuses server-side, regardless of what this CLI sends or what any caller is
+persuaded to attempt.
+
+That matters most when an AI agent drives the CLI, because merge request descriptions, commit
+messages, and file contents are written by anyone who can push, and an agent reading that text
+cannot reliably tell instructions from content. The arrangement worth adopting is two credential
+files:
+
+```
+~/gitlab.env        # read_api token — what the agent uses by default
+~/gitlab-write.env  # api token — passed explicitly, by a person
+```
+
+```sh
+simply gitlab mr list -e ~/gitlab.env --project group/project
+simply gitlab mr update -e ~/gitlab-write.env --project group/project --mr 42 --state close
+```
+
+The agent's normal loop is then structurally incapable of changing anything, and a write becomes a
+deliberate act.
+
+## CI variable values are hidden
+
+`simply gitlab ci variable list` replaces every value with `<hidden>`, in the table and under
+`--json` alike:
+
+```sh
+simply gitlab ci variable list --project group/project
+```
+
+```
+KEY         SCOPE  TYPE     PROTECTED  MASKED  VALUE
+──────────  ─────  ───────  ─────────  ──────  ────────
+DEPLOY_KEY  *      env_var  yes        yes     <hidden>
+
+Showing 1 of 1 variable(s).
+Values are hidden. Pass --reveal to print them.
+```
+
+This is worth explaining, because GitLab's own API does not do this. `GET /projects/:id/variables`
+returns **every** value in clear text — including the ones marked "masked", since masking only
+hides a value in job logs, not from the API. Those values are deploy keys, signing certificates,
+and production credentials, and the usual reason to list them is to see _which_ exist, not to read
+them.
+
+`--reveal` prints them. It exists on the CLI and has no equivalent in the
+[MCP server](/guides/mcp-server/), deliberately: a value revealed to a person is on their screen,
+and a value revealed to an agent is in a context window, a transcript, and whatever that agent
+writes next.
+
+## Untrusted text is stripped
+
+Merge request titles and descriptions, commit messages, repository file contents, and CI job traces
+are all written by whoever can push to a project or open a merge request. Every one of them is
+stripped of control characters before it is printed, so an escape sequence cannot make your
+terminal show something other than what the API returned — and your token is redacted from every
+error message and response body.

package/docs/schema/baseline-v1.json

@@ -0,0 +1,124 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://simplysf.github.io/simply-cli/schema/baseline-v1.json",
+  "title": "Simply GitLab configuration baseline",
+  "description": "What a set of GitLab projects should have in common. Read by `simply gitlab config plan` and `simply gitlab config apply`. Advisory: the CLI's own validator is what runs, and its errors name the exact path that is wrong.",
+  "type": "object",
+  "required": ["version"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": { "type": "string" },
+    "version": {
+      "const": 1,
+      "description": "Config format version. Only 1 exists."
+    },
+    "targets": { "$ref": "#/$defs/targets" },
+    "group": { "$ref": "#/$defs/groupDesired" },
+    "project": { "$ref": "#/$defs/projectDesired" },
+    "overrides": {
+      "type": "object",
+      "description": "Per-target exceptions, keyed by full project or group path.",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "project": { "$ref": "#/$defs/projectDesired" },
+          "group": { "$ref": "#/$defs/groupDesired" }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "targets": {
+      "type": "object",
+      "description": "What the run acts on. Groups expand through their subgroups.",
+      "additionalProperties": false,
+      "anyOf": [{ "required": ["groups"] }, { "required": ["projects"] }],
+      "properties": {
+        "groups": {
+          "type": "array",
+          "description": "Group paths or ids. Each expands to every project in the group and its subgroups.",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "projects": {
+          "type": "array",
+          "description": "Individual project paths or ids, added to whatever the groups expanded to.",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "exclude": {
+          "type": "array",
+          "description": "Removed from the union. A trailing * drops a whole subtree.",
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "groupDesired": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "settings": {
+          "type": "object",
+          "description": "Attributes for PUT /groups/:id. Names are GitLab's own."
+        }
+      }
+    },
+    "projectDesired": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "settings": {
+          "type": "object",
+          "description": "Attributes for PUT /projects/:id — merge method, CI config path, build timeout, and the rest. Names are GitLab's own; only what you declare is compared."
+        },
+        "protectedBranches": {
+          "$ref": "#/$defs/section",
+          "description": "Branch protections, keyed by name. Corrected in place with PATCH."
+        },
+        "protectedTags": {
+          "$ref": "#/$defs/section",
+          "description": "Tag protections, keyed by name. GitLab has no update endpoint, so a change is a delete and a create."
+        },
+        "approvals": {
+          "type": "object",
+          "description": "Project approval settings (Premium/Ultimate)."
+        },
+        "approvalRules": {
+          "$ref": "#/$defs/section",
+          "description": "Approval rules, keyed by name (Premium/Ultimate). Accepts `usernames`, group paths under `groups`, and branch names under `protectedBranches`; the ids are resolved for you."
+        },
+        "pushRules": {
+          "type": "object",
+          "description": "Push rules (Premium/Ultimate)."
+        },
+        "variables": {
+          "$ref": "#/$defs/section",
+          "description": "CI/CD variable metadata, keyed by key + environment_scope. Reported only, never written: creating or updating a variable requires its value, and this file holds none."
+        }
+      }
+    },
+    "section": {
+      "description": "A list section: a bare array, or an object that can also prune or replace.",
+      "oneOf": [
+        { "type": "array", "items": { "type": "object" } },
+        {
+          "type": "object",
+          "required": ["entries"],
+          "additionalProperties": false,
+          "properties": {
+            "prune": {
+              "type": "boolean",
+              "description": "Delete entries that exist on the instance but are not declared here. Off by default, so a first run cannot remove a protection that predates the config.",
+              "default": false
+            },
+            "$replace": {
+              "type": "boolean",
+              "description": "In an override, replace the baseline's entries entirely instead of merging into them by key.",
+              "default": false
+            },
+            "entries": { "type": "array", "items": { "type": "object" } }
+          }
+        }
+      ]
+    }
+  }
+}

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

@@ -0,0 +1,25 @@
+import { GitLabCommand } from '../../../shared/base-command.js';
+export default class GitlabProjectCreate extends GitLabCommand<typeof GitlabProjectCreate> {
+    static isWrite: boolean;
+    static readonly summary = "Create a project, blank or from a template.";
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        path: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        namespace: 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>;
+        visibility: import("@oclif/core/interfaces").OptionFlag<"private" | "internal" | "public" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'default-branch': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'initialize-with-readme': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        topics: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        template: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'custom-template': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'template-group': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'template-project': import("@oclif/core/interfaces").OptionFlag<string | 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>;
+    };
+    run(): Promise<unknown>;
+}

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

@@ -0,0 +1,111 @@
+/*
+ * 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, parseBodyInput, prepareProjectCreate } from '@simplysf/simply-gitlab-core';
+import { GitLabCommand, parseList, writeFlags } from '../../../shared/base-command.js';
+export default class GitlabProjectCreate extends GitLabCommand {
+    static isWrite = true;
+    static summary = 'Create a project, blank or from a template.';
+    static description = 'Creates the project in --namespace, or in the namespace of the token owner when none is ' +
+        'given. Give it --name or --path; GitLab derives whichever one is missing.\n\n' +
+        '--template names one of the built-in templates GitLab ships, such as express or rails. To ' +
+        'create from a custom template instead, add --custom-template for one the instance ' +
+        'administrator registered, --template-group for one in a group, or use --template-project ' +
+        'to name the template project itself by id or path — which GitLab prefers, because a name ' +
+        'can be ambiguous. Custom templates need a Premium or Ultimate instance.\n\n' +
+        'A template is applied asynchronously: this command returns as soon as the project record ' +
+        'exists, with an import status of "scheduled", and the files arrive a few seconds later. ' +
+        'Check "project view" until its import_status reads "finished" before writing to the ' +
+        'repository. --dry-run prints the exact request body; a namespace or template given as a ' +
+        'path is still looked up, so the printed ids are the ones that would be sent.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --name new-service --namespace platform/apps',
+        '<%= config.bin %> <%= command.id %> --name new-service --namespace platform/apps --template express --visibility internal',
+        '<%= config.bin %> <%= command.id %> --name new-service --namespace platform/apps --template service-skeleton --template-group platform/templates',
+        '<%= config.bin %> <%= command.id %> --path new-service --template-project platform/templates/service-skeleton --dry-run',
+    ];
+    static flags = {
+        ...writeFlags,
+        name: Flags.string({ summary: 'Project name. The path is derived from it when --path is not given.' }),
+        path: Flags.string({
+            summary: 'Repository path, the URL slug. The name is derived from it when --name is not given.',
+        }),
+        namespace: Flags.string({
+            summary: 'Group or user namespace to create the project in, by id or full path.',
+            description: 'Defaults to the namespace of the token owner.',
+        }),
+        description: Flags.string({ summary: 'Project description.' }),
+        visibility: Flags.option({
+            summary: 'Who can see the project.',
+            options: ['private', 'internal', 'public'],
+        })(),
+        'default-branch': Flags.string({ summary: 'Name of the default branch.' }),
+        'initialize-with-readme': Flags.boolean({
+            summary: 'Create a first commit holding a README, so the repository is not empty.',
+            default: false,
+        }),
+        topics: Flags.string({ summary: 'Comma-separated topics to label the project with.' }),
+        template: Flags.string({
+            summary: 'Template to create from: a built-in name, or with --custom-template or --template-group a custom one.',
+        }),
+        'custom-template': Flags.boolean({
+            summary: "Look --template up among the instance's custom project templates rather than the built-in ones.",
+            default: false,
+        }),
+        'template-group': Flags.string({
+            summary: 'Group whose custom project templates --template names, by id or full path.',
+        }),
+        'template-project': Flags.string({
+            summary: 'Custom template project to create from, by id or full path. Cannot be combined with --template.',
+        }),
+        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 client = this.gitlab();
+        const request = await prepareProjectCreate(client, {
+            name: this.flags.name,
+            path: this.flags.path,
+            namespace: this.flags.namespace,
+            description: this.flags.description,
+            visibility: this.flags.visibility,
+            defaultBranch: this.flags['default-branch'],
+            initializeWithReadme: this.flags['initialize-with-readme'] || undefined,
+            topics: parseList(this.flags.topics),
+            template: this.flags.template,
+            customTemplate: this.flags['custom-template'] || undefined,
+            templateGroup: this.flags['template-group'],
+            templateProject: this.flags['template-project'],
+            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 client.createProject(request));
+        this.logSafe(formatKeyValue([
+            ['Created', created.path_with_namespace ?? this.flags.name ?? this.flags.path],
+            ['ID', created.id],
+            ['Visibility', created.visibility],
+            ['Default branch', created.default_branch],
+            ['Import status', created.import_status],
+            ['URL', created.web_url],
+        ]));
+        return created;
+    }
+}
+//# sourceMappingURL=create.js.map

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

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