@simplysf/simply-gitlab 0.5.0 → 0.6.0

package/README.md

@@ -150,6 +150,7 @@ exitCode, status?, body?}}` — and nothing to stdout. Exit codes are identical
 - [`simply gitlab mr list`](#simply-gitlab-mr-list)
 - [`simply gitlab mr update`](#simply-gitlab-mr-update)
 - [`simply gitlab mr view`](#simply-gitlab-mr-view)
+- [`simply gitlab project create`](#simply-gitlab-project-create)
 - [`simply gitlab project list`](#simply-gitlab-project-list)
 - [`simply gitlab project view`](#simply-gitlab-project-view)
 - [`simply gitlab release list`](#simply-gitlab-release-list)
@@ -197,7 +198,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/branch/create.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/branch/create.js)_
+_See code: [lib/commands/gitlab/branch/create.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/branch/create.js)_
 
 ## `simply gitlab branch list`
 
@@ -240,7 +241,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/branch/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/branch/list.js)_
+_See code: [lib/commands/gitlab/branch/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/branch/list.js)_
 
 ## `simply gitlab ci environment list`
 
@@ -286,7 +287,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/ci/environment/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/ci/environment/list.js)_
+_See code: [lib/commands/gitlab/ci/environment/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/ci/environment/list.js)_
 
 ## `simply gitlab ci job list`
 
@@ -330,7 +331,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/ci/job/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/ci/job/list.js)_
+_See code: [lib/commands/gitlab/ci/job/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/ci/job/list.js)_
 
 ## `simply gitlab ci job log`
 
@@ -375,7 +376,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/ci/job/log.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/ci/job/log.js)_
+_See code: [lib/commands/gitlab/ci/job/log.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/ci/job/log.js)_
 
 ## `simply gitlab ci variable list`
 
@@ -426,7 +427,7 @@ FLAG DESCRIPTIONS
     where this output is going.
 ```
 
-_See code: [lib/commands/gitlab/ci/variable/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/ci/variable/list.js)_
+_See code: [lib/commands/gitlab/ci/variable/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/ci/variable/list.js)_
 
 ## `simply gitlab commit create`
 
@@ -486,7 +487,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/commit/create.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/commit/create.js)_
+_See code: [lib/commands/gitlab/commit/create.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/commit/create.js)_
 
 ## `simply gitlab commit diff`
 
@@ -528,7 +529,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/commit/diff.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/commit/diff.js)_
+_See code: [lib/commands/gitlab/commit/diff.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/commit/diff.js)_
 
 ## `simply gitlab commit list`
 
@@ -579,7 +580,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/commit/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/commit/list.js)_
+_See code: [lib/commands/gitlab/commit/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/commit/list.js)_
 
 ## `simply gitlab commit view`
 
@@ -620,7 +621,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/commit/view.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/commit/view.js)_
+_See code: [lib/commands/gitlab/commit/view.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/commit/view.js)_
 
 ## `simply gitlab config apply`
 
@@ -687,7 +688,7 @@ FLAG DESCRIPTIONS
     the config does not target is an error rather than a silent no-op.
 ```
 
-_See code: [lib/commands/gitlab/config/apply.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/config/apply.js)_
+_See code: [lib/commands/gitlab/config/apply.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/config/apply.js)_
 
 ## `simply gitlab config export`
 
@@ -738,7 +739,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/config/export.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/config/export.js)_
+_See code: [lib/commands/gitlab/config/export.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/config/export.js)_
 
 ## `simply gitlab config plan`
 
@@ -806,7 +807,7 @@ FLAG DESCRIPTIONS
     the config does not target is an error rather than a silent no-op.
 ```
 
-_See code: [lib/commands/gitlab/config/plan.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/config/plan.js)_
+_See code: [lib/commands/gitlab/config/plan.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/config/plan.js)_
 
 ## `simply gitlab file create`
 
@@ -858,7 +859,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/file/create.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/file/create.js)_
+_See code: [lib/commands/gitlab/file/create.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/file/create.js)_
 
 ## `simply gitlab file update`
 
@@ -911,7 +912,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/file/update.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/file/update.js)_
+_See code: [lib/commands/gitlab/file/update.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/file/update.js)_
 
 ## `simply gitlab file view`
 
@@ -957,7 +958,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/file/view.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/file/view.js)_
+_See code: [lib/commands/gitlab/file/view.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/file/view.js)_
 
 ## `simply gitlab mr create`
 
@@ -1018,7 +1019,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/mr/create.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/mr/create.js)_
+_See code: [lib/commands/gitlab/mr/create.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/mr/create.js)_
 
 ## `simply gitlab mr list`
 
@@ -1072,7 +1073,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/mr/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/mr/list.js)_
+_See code: [lib/commands/gitlab/mr/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/mr/list.js)_
 
 ## `simply gitlab mr update`
 
@@ -1136,7 +1137,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/mr/update.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/mr/update.js)_
+_See code: [lib/commands/gitlab/mr/update.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/mr/update.js)_
 
 ## `simply gitlab mr view`
 
@@ -1177,7 +1178,85 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/mr/view.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/mr/view.js)_
+_See code: [lib/commands/gitlab/mr/view.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/mr/view.js)_
+
+## `simply gitlab project create`
+
+Create a project, blank or from a template.
+
+```
+USAGE
+  $ simply gitlab project create [--json] [-e <value>] [--gitlab-url <value>] [--gitlab-token <value>] [--dry-run] [--name
+    <value>] [--path <value>] [--namespace <value>] [--description <value>] [--visibility private|internal|public]
+    [--default-branch <value>] [--initialize-with-readme] [--topics <value>] [--template <value>] [--custom-template]
+    [--template-group <value>] [--template-project <value>] [--body <value> | --body-file <value>]
+
+FLAGS
+  --body=<value>              Raw JSON request body.
+  --body-file=<value>         Path to a file holding the raw JSON request body.
+  --custom-template           Look --template up among the instance's custom project templates rather than the built-in
+                              ones.
+  --default-branch=<value>    Name of the default branch.
+  --description=<value>       Project description.
+  --dry-run                   Print the request that would be sent and exit without sending it.
+  --initialize-with-readme    Create a first commit holding a README, so the repository is not empty.
+  --name=<value>              Project name. The path is derived from it when --path is not given.
+  --namespace=<value>         Group or user namespace to create the project in, by id or full path.
+  --path=<value>              Repository path, the URL slug. The name is derived from it when --name is not given.
+  --template=<value>          Template to create from: a built-in name, or with --custom-template or --template-group a
+                              custom one.
+  --template-group=<value>    Group whose custom project templates --template names, by id or full path.
+  --template-project=<value>  Custom template project to create from, by id or full path. Cannot be combined with
+                              --template.
+  --topics=<value>            Comma-separated topics to label the project with.
+  --visibility=<option>       Who can see the project.
+                              <options: private|internal|public>
+
+CONNECTION FLAGS
+  -e, --env-file=<value>      Path to a .env file holding connection settings.
+      --gitlab-token=<value>  [env: GITLAB_TOKEN] Personal, project, or group access token.
+      --gitlab-url=<value>    [env: GITLAB_URL] Base URL of the GitLab instance. Defaults to https://gitlab.com.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Create a project, blank or from a template.
+
+  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.
+
+  --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.
+
+  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.
+
+EXAMPLES
+  $ simply gitlab project create --name new-service --namespace platform/apps
+
+  $ simply gitlab project create --name new-service --namespace platform/apps --template express --visibility internal
+
+  $ simply gitlab project create --name new-service --namespace platform/apps --template service-skeleton --template-group platform/templates
+
+  $ simply gitlab project create --path new-service --template-project platform/templates/service-skeleton --dry-run
+
+FLAG DESCRIPTIONS
+  -e, --env-file=<value>  Path to a .env file holding connection settings.
+
+    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.
+
+  --namespace=<value>  Group or user namespace to create the project in, by id or full path.
+
+    Defaults to the namespace of the token owner.
+```
+
+_See code: [lib/commands/gitlab/project/create.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/project/create.js)_
 
 ## `simply gitlab project list`
 
@@ -1224,7 +1303,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/project/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/project/list.js)_
+_See code: [lib/commands/gitlab/project/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/project/list.js)_
 
 ## `simply gitlab project view`
 
@@ -1263,7 +1342,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/project/view.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/project/view.js)_
+_See code: [lib/commands/gitlab/project/view.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/project/view.js)_
 
 ## `simply gitlab release list`
 
@@ -1304,7 +1383,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/release/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/release/list.js)_
+_See code: [lib/commands/gitlab/release/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/release/list.js)_
 
 ## `simply gitlab search`
 
@@ -1359,7 +1438,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/search.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/search.js)_
+_See code: [lib/commands/gitlab/search.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/search.js)_
 
 ## `simply gitlab tag list`
 
@@ -1406,7 +1485,7 @@ FLAG DESCRIPTIONS
     explicit export, and only GitLab connection variables are read from it. A path that cannot be read is an error.
 ```
 
-_See code: [lib/commands/gitlab/tag/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.2.0/packages/simply-gitlab/lib/commands/gitlab/tag/list.js)_
+_See code: [lib/commands/gitlab/tag/list.js](https://github.com/SimplySF/simply-gitlab/blob/@simplysf/simply-gitlab@0.5.0/packages/simply-gitlab/lib/commands/gitlab/tag/list.js)_
 <!-- commandsstop -->
 
 ## License

package/docs/guides/write-safety.md

@@ -3,9 +3,9 @@ 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.
 ---
 
-Six commands change data — `branch create`, `file create`, `file update`, `commit create`,
-`mr create`, and `mr update`. Nothing in this CLI deletes anything. Those six sit behind several
-layers, and only the last is a real boundary.
+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
 
@@ -19,8 +19,9 @@ something is the one that brings it back.
 
 ## `--dry-run`
 
-Accepted by all six. 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:
+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 \

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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"}