Allow project creation by name by purplecabbage · Pull Request #243 · adobe/aio-cli-plugin-console

purplecabbage · 2026-03-26T20:18:10Z

Description

Allow create calls for new projects in dev-console. Assumes name is unique, or it will fail with the appropriate message.
This will enable agents to create new App Builder projects without user interaction.

aio console project create --name=alphaNumericName1 --title="alphaNumeric with spaces" --description="free text up to 1000 char"
--json output is now formatted for both human readability and machines

Related Issue

ACNA-4400

Motivation and Context

Agents need to be able to create projects with all parameters specified, the only other way to create a project was through `app init' with prompts for a project name,title,description ...

How Has This Been Tested?

tested against live dev-console api

Screenshots (if appropriate):

Types of changes

Bug fix (non-breaking change which fixes an issue)
New feature (non-breaking change which adds functionality)
Breaking change (fix or feature that would cause existing functionality to change)

Checklist:

I have signed the Adobe Open Source CLA.
My code follows the code style of this project.
My change requires a change to the documentation.
I have updated the documentation accordingly.
I have read the CONTRIBUTING document.
I have added tests to cover my changes.
All new and existing tests passed.

codecov · 2026-03-26T23:19:31Z

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

src/commands/console/project/create.js

test/commands/console/project/create.test.js

…too short if it is too long.

Copilot

Pull request overview

Adds a new console project create command to enable non-interactive Adobe Developer Console project creation (by name) for a specified (or configured) organization, intended to support agent workflows.

Changes:

Introduces src/commands/console/project/create.js implementing project creation with local validation and a pre-check for duplicate project names.
Adds test/commands/console/project/create.test.js covering core create-path behavior and several validation/error cases.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 8 comments.

File	Description
`src/commands/console/project/create.js`	New CLI command to create a Console project by name/title/description with validations and org resolution.
`test/commands/console/project/create.test.js`	New unit tests validating creation inputs, org selection behavior, and basic duplicate/validation errors.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-03-27T00:50:51Z

test/commands/console/project/create.test.js

+    command = new TheCommand()
+    mockConsoleCLIInstance.createProject.mockReset()


beforeEach only resets createProject, but several tests mutate getProjects’s resolved value. Not resetting getProjects here makes the suite more order-dependent as it grows. Consider resetting/re-initializing both mocks in beforeEach (similar to other command test suites).

Suggested change

command = new TheCommand()

mockConsoleCLIInstance.createProject.mockReset()

command = new TheCommand()

mockConsoleCLIInstance.getProjects.mockReset()

mockConsoleCLIInstance.getProjects.mockResolvedValue([])

mockConsoleCLIInstance.createProject.mockReset()

mockConsoleCLIInstance.createProject.mockResolvedValue(mockProject)

test/commands/console/project/create.test.js

src/commands/console/project/create.js

Copilot · 2026-03-27T00:50:52Z

src/commands/console/project/create.js

+    await this.initSdk()
+    // check name is not already in use
+    const projects = await this.consoleCLI.getProjects(orgId)
+    if (projects.find(project => project.name === projectDetails.name)) {
+      this.error(`Project ${projectDetails.name} already exists. Please choose a different name.`)
+    }
+
+    // if we get here, all validation passed, so call server to create project
+    const project = await this.consoleCLI.createProject(orgId, projectDetails)
+    this.log(`Project ${project.name} created successfully.`)
+    return project


This command doesn’t wrap SDK calls in a try/catch/finally and never calls cleanOutput(). Other console commands ensure LibConsoleCLI.cleanStdOut() is called in a finally block so terminal output isn’t left in a dirty state when requests fail. Consider aligning with the existing pattern (logger debug in catch + cleanOutput() in finally).

src/commands/console/project/create.js

…umans)

Copilot

Pull request overview

Copilot reviewed 26 out of 26 changed files in this pull request and generated 3 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-03-28T02:21:43Z

src/commands/console/index.js

   */
  printJson (data) {
-    this.log(JSON.stringify(data))
+    this.log(JSON.stringify(data, 0, 2))


JSON.stringify(data, 0, 2) relies on a non-standard-looking replacer argument (0). While it currently behaves like undefined, it’s confusing to readers and easy to misinterpret. Use null (or omit the replacer argument) to make the intent of pretty-printing explicit.

Suggested change

this.log(JSON.stringify(data, 0, 2))

this.log(JSON.stringify(data, null, 2))

src/commands/console/project/create.js

Copilot · 2026-03-28T02:21:43Z

src/commands/console/project/create.js

+}
+
+CreateCommand.aliases = [
+  'console:project:create',


CreateCommand.aliases includes the command’s own canonical name (console:project:create). In oclif this is redundant and differs from the pattern in other commands (aliases are only for alternative spellings like console:project:ls). Consider removing the self-alias and keeping only true alternatives (e.g., console:project:init).

Suggested change

'console:project:create',

Copilot

Pull request overview

Copilot reviewed 26 out of 26 changed files in this pull request and generated 2 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-03-28T02:31:27Z

src/commands/console/project/create.js

+    }
+
+    // Project title allows only alphanumeric values and spaces
+    if (!/^[a-zA-Z0-9\s]+$/.test(projectDetails.title)) {


The title validation regex uses \s, which matches tabs/newlines and other whitespace—not just spaces as the error message states. This can allow control characters in --title (e.g., newlines) and produce unexpected output/log formatting. Use a pattern that only permits literal spaces (and consider trimming) to align behavior with the validation message.

Suggested change

if (!/^[a-zA-Z0-9\s]+$/.test(projectDetails.title)) {

if (!/^[a-zA-Z0-9 ]+$/.test(projectDetails.title)) {

Copilot · 2026-03-28T02:31:28Z

src/commands/console/index.js

  printJson (data) {
-    this.log(JSON.stringify(data))
+    this.log(JSON.stringify(data, 0, 2))
  }


printJson() now pretty-prints JSON for all commands, which changes the --json output format across the plugin but isn’t mentioned in the PR description. If the intent is only to support structured output for project:create, consider scoping formatting changes to that command (or call this out explicitly). Also, pass null as the JSON.stringify replacer instead of 0 for clarity (0 is ignored by JSON.stringify).

Copilot

Pull request overview

Copilot reviewed 26 out of 26 changed files in this pull request and generated 2 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

src/commands/console/project/create.js

test/commands/console/index.test.js

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

purplecabbage added 2 commits March 26, 2026 13:15

wip: allow project creation by name

e8d6bbe

fix: name,title,desc validation. + tests full coverage

0b4d8f2

purplecabbage marked this pull request as ready for review March 26, 2026 23:18

pru55e11 requested changes Mar 26, 2026

View reviewed changes

src/commands/console/project/create.js Outdated Show resolved Hide resolved

src/commands/console/project/create.js Outdated Show resolved Hide resolved

test/commands/console/project/create.test.js Show resolved Hide resolved

purplecabbage added 3 commits March 26, 2026 17:12

nit: don't say it is too long if it is too short and don't say it is …

69aaa25

…too short if it is too long.

delay initSDK till after validation

ecab131

nit: test for too short name/title

7fb27c8

pru55e11 approved these changes Mar 27, 2026

View reviewed changes

pru55e11 mentioned this pull request Mar 27, 2026

Allow workspace creation by name #244

Open

4 tasks

purplecabbage requested a review from Copilot March 27, 2026 00:44

Copilot started reviewing on behalf of purplecabbage March 27, 2026 00:45 View session

Copilot AI reviewed Mar 27, 2026

View reviewed changes

shazron approved these changes Mar 27, 2026

View reviewed changes

src/commands/console/project/create.js Outdated Show resolved Hide resolved

src/commands/console/project/create.js Show resolved Hide resolved

src/commands/console/project/create.js Outdated Show resolved Hide resolved

purplecabbage added 5 commits March 27, 2026 17:55

nit: make json output slightly more readable

793d6cd

nit: use logger, respect json/yml flags, flag chars for less typing(h…

27bb29d

…umans)

Grammar for Shaz

8a5d005

added fixtures/tests for --json / --yml

88cf57b

nit: correct allowed characters

97756ca

purplecabbage requested a review from Copilot March 28, 2026 02:17

Copilot started reviewing on behalf of purplecabbage March 28, 2026 02:18 View session

Copilot AI reviewed Mar 28, 2026

View reviewed changes

nit: finally trying to catch

e107b27

purplecabbage requested a review from Copilot March 28, 2026 02:26

Copilot started reviewing on behalf of purplecabbage March 28, 2026 02:27 View session

Copilot AI reviewed Mar 28, 2026

View reviewed changes

nit title spaces but NOT tabs or newlines

3a5c7ec

purplecabbage requested a review from Copilot March 28, 2026 06:02

Copilot started reviewing on behalf of purplecabbage March 28, 2026 06:02 View session

Copilot AI reviewed Mar 28, 2026

View reviewed changes

src/commands/console/project/create.js Outdated Show resolved Hide resolved

test/commands/console/index.test.js Outdated Show resolved Hide resolved

purplecabbage and others added 2 commits March 27, 2026 23:09

Update test/commands/console/index.test.js

961938b

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update src/commands/console/project/create.js

9204fa1

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

		command = new TheCommand()
		mockConsoleCLIInstance.createProject.mockReset()

	this.log(JSON.stringify(data, 0, 2))
	this.log(JSON.stringify(data, null, 2))

	if (!/^[a-zA-Z0-9\s]+$/.test(projectDetails.title)) {
	if (!/^[a-zA-Z0-9 ]+$/.test(projectDetails.title)) {

Conversation

purplecabbage commented Mar 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Related Issue

Motivation and Context

How Has This Been Tested?

Screenshots (if appropriate):

Types of changes

Checklist:

Uh oh!

codecov bot commented Mar 26, 2026

Codecov Report

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Mar 27, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI Mar 27, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Mar 28, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI Mar 28, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Mar 28, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 28, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

purplecabbage commented Mar 26, 2026 •

edited

Loading