hereya-cli 0.20.0 → 0.22.0

package/README.md

@@ -1,7 +1,7 @@
 hereya-cli
 =================
 
-Use infrastructure components as simple software packages.
+Manage infrastructure components as packages.
 
 
 [![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
@@ -20,7 +20,7 @@ $ npm install -g hereya-cli
 $ hereya COMMAND
 running command...
 $ hereya (--version)
-hereya-cli/0.20.0 linux-x64 node-v22.13.1
+hereya-cli/0.22.0 linux-x64 node-v22.13.1
 $ hereya --help [COMMAND]
 USAGE
   $ hereya COMMAND
@@ -59,12 +59,19 @@ USAGE
   $ hereya add PACKAGE [--chdir <value>] [--debug] [-p <value>...]
 
 ARGUMENTS
-  PACKAGE  The package to add. Packages are gitHub repositories. Use the format owner/repository
+  PACKAGE  The package to add, specified as a GitHub repository in the format owner/repository.
+           To change the registry URL, set the HEREYA_REGISTRY_URL environment variable, so that it points to
+           $HEREYA_REGISTRY_URL/owner/repository.
+           For local packages, use the format local://path/to/package where path/to/package is the path to the package
+           on your local machine.
 
 FLAGS
   -p, --parameter=<value>...  [default: ] parameter for the package, in the form of 'key=value'. Can be specified
                               multiple times.
-      --chdir=<value>         directory to run command in
+      --chdir=<value>         Directory where the command will be executed.
+                              If not specified, it defaults to the current working directory.
+                              Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR
+                              environment variable.
       --debug                 enable debug mode
 
 DESCRIPTION
@@ -74,7 +81,7 @@ EXAMPLES
   $ hereya add cloudy/docker_postgres
 ```
 
-_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/add/index.ts)_
+_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/add/index.ts)_
 
 ## `hereya bootstrap INFRASTRUCTURETYPE`
 
@@ -99,7 +106,7 @@ EXAMPLES
   $ hereya bootstrap local
 ```
 
-_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/bootstrap/index.ts)_
+_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/bootstrap/index.ts)_
 
 ## `hereya deploy`
 
@@ -111,7 +118,10 @@ USAGE
 
 FLAGS
   -w, --workspace=<value>  (required) name of the workspace to deploy the packages for
-      --chdir=<value>      directory to run command in
+      --chdir=<value>      Directory where the command will be executed.
+                           If not specified, it defaults to the current working directory.
+                           Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR
+                           environment variable.
       --debug              enable debug mode
 
 DESCRIPTION
@@ -121,7 +131,7 @@ EXAMPLES
   $ hereya deploy
 ```
 
-_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/deploy/index.ts)_
+_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/deploy/index.ts)_
 
 ## `hereya down`
 
@@ -132,8 +142,11 @@ USAGE
   $ hereya down [--chdir <value>] [--debug] [--deploy] [-w <value>]
 
 FLAGS
-  -w, --workspace=<value>  name of the workspace to install the packages for
-      --chdir=<value>      directory to run command in
+  -w, --workspace=<value>  name of the workspace to destroy the packages for
+      --chdir=<value>      Directory where the command will be executed.
+                           If not specified, it defaults to the current working directory.
+                           Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR
+                           environment variable.
       --debug              enable debug mode
       --deploy             destroy deployment companion packages
 
@@ -144,7 +157,7 @@ EXAMPLES
   $ hereya down
 ```
 
-_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/down/index.ts)_
+_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/down/index.ts)_
 
 ## `hereya env [NAME]`
 
@@ -175,7 +188,7 @@ EXAMPLES
   $ hereya env -w dev -l
 ```
 
-_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/env/index.ts)_
+_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/env/index.ts)_
 
 ## `hereya env set [NAME]`
 
@@ -202,7 +215,7 @@ EXAMPLES
   $ hereya env set FOO -v bar -w dev
 ```
 
-_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/env/set/index.ts)_
+_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/env/set/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -248,7 +261,7 @@ EXAMPLES
   $ hereya init myProject -w=defaultWorkspace --chdir=./myProject
 ```
 
-_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/init/index.ts)_
+_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/init/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -259,10 +272,13 @@ USAGE
   $ hereya remove PACKAGE [--chdir <value>] [--debug]
 
 ARGUMENTS
-  PACKAGE  The package to remove. Packages are gitHub repositories. Use the format owner/repository
+  PACKAGE  Remove a previously added package.
 
 FLAGS
-  --chdir=<value>  directory to run command in
+  --chdir=<value>  Directory where the command will be executed.
+                   If not specified, it defaults to the current working directory.
+                   Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment
+                   variable.
   --debug          enable debug mode
 
 DESCRIPTION
@@ -272,7 +288,7 @@ EXAMPLES
   $ hereya remove cloudy/docker_postgres
 ```
 
-_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/remove/index.ts)_
+_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -298,7 +314,7 @@ EXAMPLES
   $ hereya run -w uat -- node index.js
 ```
 
-_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/run/index.ts)_
+_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/run/index.ts)_
 
 ## `hereya unbootstrap INFRASTRUCTURETYPE`
 
@@ -323,7 +339,7 @@ EXAMPLES
   $ hereya unbootstrap local
 ```
 
-_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/unbootstrap/index.ts)_
+_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -335,7 +351,10 @@ USAGE
 
 FLAGS
   -w, --workspace=<value>  (required) name of the workspace to undeploy the packages for
-      --chdir=<value>      directory to run command in
+      --chdir=<value>      Directory where the command will be executed.
+                           If not specified, it defaults to the current working directory.
+                           Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR
+                           environment variable.
       --debug              enable debug mode
 
 DESCRIPTION
@@ -345,7 +364,7 @@ EXAMPLES
   $ hereya undeploy
 ```
 
-_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/undeploy/index.ts)_
+_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/undeploy/index.ts)_
 
 ## `hereya up`
 
@@ -357,7 +376,10 @@ USAGE
 
 FLAGS
   -w, --workspace=<value>  name of the workspace to install the packages for
-      --chdir=<value>      directory to run command in
+      --chdir=<value>      Directory where the command will be executed.
+                           If not specified, it defaults to the current working directory.
+                           Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR
+                           environment variable.
       --debug              enable debug mode
       --deploy             provision deployment companion packages
 
@@ -368,7 +390,7 @@ EXAMPLES
   $ hereya up
 ```
 
-_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/up/index.ts)_
+_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/up/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -388,7 +410,7 @@ EXAMPLES
   $ hereya workspace create dev
 ```
 
-_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/workspace/create/index.ts)_
+_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -408,7 +430,7 @@ EXAMPLES
   $ hereya workspace delete dev
 ```
 
-_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/workspace/delete/index.ts)_
+_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -434,7 +456,7 @@ EXAMPLES
   $ hereya workspace env myEnv -w dev
 ```
 
-_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/workspace/env/index.ts)_
+_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace env set`
 
@@ -458,7 +480,7 @@ EXAMPLES
   $ hereya workspace env set -w my-workspace -n myVar -v my-value -i aws -s
 ```
 
-_See code: [src/commands/workspace/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/workspace/env/set/index.ts)_
+_See code: [src/commands/workspace/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/workspace/env/set/index.ts)_
 
 ## `hereya workspace env unset`
 
@@ -479,7 +501,7 @@ EXAMPLES
   $ hereya workspace env unset -w my-workspace -n myVar
 ```
 
-_See code: [src/commands/workspace/env/unset/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/workspace/env/unset/index.ts)_
+_See code: [src/commands/workspace/env/unset/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/workspace/env/unset/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -506,7 +528,7 @@ EXAMPLES
   $ hereya workspace install hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/workspace/install/index.ts)_
+_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -533,5 +555,5 @@ EXAMPLES
   $ hereya workspace uninstall hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.20.0/src/commands/workspace/uninstall/index.ts)_
+_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.22.0/src/commands/workspace/uninstall/index.ts)_
 <!-- commandsstop -->

package/dist/commands/add/index.js

@@ -5,13 +5,18 @@ import { getExecutor } from '../../executor/index.js';
 import { getConfigManager } from '../../lib/config/index.js';
 import { logEnv } from '../../lib/env-utils.js';
 import { getEnvManager } from '../../lib/env/index.js';
+import { getLogger, isDebug, setDebug } from '../../lib/log.js';
 import { arrayOfStringToObject } from '../../lib/object-utils.js';
 import { getParameterManager } from '../../lib/parameter/index.js';
-import { delay, setDebug } from '../../lib/shell.js';
+import { delay } from '../../lib/shell.js';
 export default class Add extends Command {
     static args = {
         package: Args.string({
-            description: 'The package to add. Packages are gitHub repositories. Use the format owner/repository',
+            description: `
+        The package to add, specified as a GitHub repository in the format owner/repository.
+        To change the registry URL, set the HEREYA_REGISTRY_URL environment variable, so that it points to $HEREYA_REGISTRY_URL/owner/repository.
+        For local packages, use the format local://path/to/package where path/to/package is the path to the package on your local machine.
+      `,
             required: true,
         }),
     };
@@ -19,7 +24,11 @@ export default class Add extends Command {
     static examples = ['<%= config.bin %> <%= command.id %> cloudy/docker_postgres'];
     static flags = {
         chdir: Flags.string({
-            description: 'directory to run command in',
+            description: `
+        Directory where the command will be executed.
+        If not specified, it defaults to the current working directory.
+        Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment variable.
+      `,
             required: false,
         }),
         debug: Flags.boolean({
@@ -77,13 +86,17 @@ export default class Add extends Command {
                             title: 'Resolving package parameters',
                         },
                         {
-                            async task(ctx) {
+                            rendererOptions: {
+                                persistentOutput: isDebug(),
+                            },
+                            async task(ctx, task) {
                                 const executor$ = getExecutor();
                                 if (!executor$.success) {
                                     throw new Error(executor$.reason);
                                 }
                                 const { executor } = executor$;
                                 const provisionOutput = await executor.provision({
+                                    logger: getLogger(task),
                                     package: ctx.package,
                                     parameters: ctx.parametersOutput.parameters,
                                     project: ctx.configOutput.config.project,
@@ -145,7 +158,7 @@ export default class Add extends Command {
                             },
                             title: 'Saving state',
                         },
-                    ], { concurrent: false });
+                    ], { concurrent: false, rendererOptions: { collapseSubtasks: !isDebug() } });
                 },
                 title: `Adding ${args.package}`,
             },

package/dist/commands/deploy/index.js

@@ -5,14 +5,19 @@ import { getBackend } from '../../backend/index.js';
 import { getExecutor } from '../../executor/index.js';
 import { getConfigManager } from '../../lib/config/index.js';
 import { getEnvManager } from '../../lib/env/index.js';
+import { getLogger, isDebug, setDebug } from '../../lib/log.js';
 import { getParameterManager } from '../../lib/parameter/index.js';
-import { delay, setDebug } from '../../lib/shell.js';
+import { delay } from '../../lib/shell.js';
 export default class Deploy extends Command {
     static description = 'Deploy a hereya project using the project deployment package';
     static examples = ['<%= config.bin %> <%= command.id %>'];
     static flags = {
         chdir: Flags.string({
-            description: 'directory to run command in',
+            description: `
+        Directory where the command will be executed.
+        If not specified, it defaults to the current working directory.
+        Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment variable.
+      `,
             required: false,
         }),
         debug: Flags.boolean({
@@ -91,7 +96,10 @@ export default class Deploy extends Command {
                 skip: (ctx) => ctx.removedDeployPackages.length === 0,
                 task(ctx, task) {
                     return task.newListr(ctx.removedDeployPackages.map((packageName) => ({
-                        async task() {
+                        rendererOptions: {
+                            persistentOutput: isDebug(),
+                        },
+                        async task(_, task) {
                             const parameterManager = getParameterManager();
                             const { parameters } = await parameterManager.getPackageParameters({
                                 package: packageName,
@@ -105,6 +113,7 @@ export default class Deploy extends Command {
                             const { executor } = executor$;
                             const destroyOutput = await executor.destroy({
                                 isDeploying: true,
+                                logger: getLogger(task),
                                 package: packageName,
                                 parameters,
                                 project: ctx.configOutput.config.project,
@@ -117,7 +126,7 @@ export default class Deploy extends Command {
                             }
                         },
                         title: `Destroying package ${packageName}`,
-                    })), { concurrent: true });
+                    })), { concurrent: true, rendererOptions: { collapseSubtasks: !isDebug() } });
                 },
                 title: 'Destroying removed deployment packages',
             },
@@ -125,7 +134,10 @@ export default class Deploy extends Command {
                 skip: (ctx) => ctx.removedPackages.length === 0,
                 task(ctx, task) {
                     return task.newListr(ctx.removedPackages.map((packageName) => ({
-                        async task() {
+                        rendererOptions: {
+                            persistentOutput: isDebug(),
+                        },
+                        async task(_, task) {
                             const parameterManager = getParameterManager();
                             const { parameters } = await parameterManager.getPackageParameters({
                                 package: packageName,
@@ -139,6 +151,7 @@ export default class Deploy extends Command {
                             const { executor } = executor$;
                             const destroyOutput = await executor.destroy({
                                 isDeploying: true,
+                                logger: getLogger(task),
                                 package: packageName,
                                 parameters,
                                 project: ctx.configOutput.config.project,
@@ -154,7 +167,7 @@ export default class Deploy extends Command {
                             ctx.removed = output;
                         },
                         title: `Destroying ${packageName}`,
-                    })), { concurrent: true });
+                    })), { concurrent: true, rendererOptions: { collapseSubtasks: !isDebug() } });
                 },
                 title: 'Destroying removed packages',
             },
@@ -165,7 +178,10 @@ export default class Deploy extends Command {
                         return;
                     }
                     return task.newListr(ctx.packages.map((packageName) => ({
-                        async task() {
+                        rendererOptions: {
+                            persistentOutput: isDebug(),
+                        },
+                        async task(_, task) {
                             const parameterManager = getParameterManager();
                             const { parameters } = await parameterManager.getPackageParameters({
                                 package: packageName,
@@ -179,6 +195,7 @@ export default class Deploy extends Command {
                             const { executor } = executor$;
                             const provisionOutput = await executor.provision({
                                 isDeploying: true,
+                                logger: getLogger(task),
                                 package: packageName,
                                 parameters,
                                 project: ctx.configOutput.config.project,
@@ -194,7 +211,7 @@ export default class Deploy extends Command {
                             ctx.added = output;
                         },
                         title: `Provisioning ${packageName}`,
-                    })), { concurrent: true });
+                    })), { concurrent: true, rendererOptions: { collapseSubtasks: !isDebug() } });
                 },
                 title: `Provisioning packages`,
             },
@@ -262,7 +279,10 @@ export default class Deploy extends Command {
                     }
                     const { env: projectEnv } = getProjectEnvOutput;
                     return task.newListr(ctx.deployPackages.map((packageName) => ({
-                        async task() {
+                        rendererOptions: {
+                            persistentOutput: isDebug(),
+                        },
+                        async task(_, task) {
                             const parameterManager = getParameterManager();
                             const { parameters } = await parameterManager.getPackageParameters({
                                 package: packageName,
@@ -276,6 +296,7 @@ export default class Deploy extends Command {
                             const { executor } = executor$;
                             const provisionOutput = await executor.provision({
                                 isDeploying: true,
+                                logger: getLogger(task),
                                 package: packageName,
                                 parameters,
                                 project: ctx.configOutput.config.project,
@@ -291,7 +312,7 @@ export default class Deploy extends Command {
                                 .join('\n'));
                         },
                         title: `Provisioning package ${packageName}`,
-                    })), { concurrent: true });
+                    })), { concurrent: true, rendererOptions: { collapseSubtasks: !isDebug() } });
                 },
                 title: 'Provisioning deployment packages',
             },

package/dist/commands/down/index.js

@@ -4,14 +4,19 @@ import { getBackend } from '../../backend/index.js';
 import { getExecutor } from '../../executor/index.js';
 import { getConfigManager } from '../../lib/config/index.js';
 import { getEnvManager } from '../../lib/env/index.js';
+import { getLogger, isDebug, setDebug } from '../../lib/log.js';
 import { getParameterManager } from '../../lib/parameter/index.js';
-import { delay, setDebug } from '../../lib/shell.js';
+import { delay } from '../../lib/shell.js';
 export default class Down extends Command {
     static description = 'Destroy all packages in the project.';
     static examples = ['<%= config.bin %> <%= command.id %>'];
     static flags = {
         chdir: Flags.string({
-            description: 'directory to run command in',
+            description: `
+        Directory where the command will be executed.
+        If not specified, it defaults to the current working directory.
+        Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment variable.
+      `,
             required: false,
         }),
         debug: Flags.boolean({
@@ -24,7 +29,7 @@ export default class Down extends Command {
         }),
         workspace: Flags.string({
             char: 'w',
-            description: 'name of the workspace to install the packages for',
+            description: 'name of the workspace to destroy the packages for',
             required: false,
         }),
     };
@@ -75,7 +80,10 @@ export default class Down extends Command {
                                     return;
                                 }
                                 return task.newListr(ctx.packages.map((packageName) => ({
-                                    async task() {
+                                    rendererOptions: {
+                                        persistentOutput: isDebug(),
+                                    },
+                                    async task(_, task) {
                                         const parameterManager = getParameterManager();
                                         const { parameters } = await parameterManager.getPackageParameters({
                                             package: packageName,
@@ -89,6 +97,7 @@ export default class Down extends Command {
                                         const { executor } = executor$;
                                         const destroyOutput = await executor.destroy({
                                             isDeploying: flags.deploy,
+                                            logger: getLogger(task),
                                             package: packageName,
                                             parameters,
                                             project: ctx.configOutput.config.project,
@@ -104,7 +113,7 @@ export default class Down extends Command {
                                         ctx.destroyed = output;
                                     },
                                     title: `Destroying ${packageName}`,
-                                })), { concurrent: true });
+                                })), { concurrent: true, rendererOptions: { collapseSubtasks: !isDebug() } });
                             },
                             title: `Destroying packages`,
                         },
@@ -139,7 +148,7 @@ export default class Down extends Command {
                             },
                             title: 'Saving state',
                         },
-                    ], { concurrent: false });
+                    ], { concurrent: false, rendererOptions: { collapseSubtasks: !isDebug() } });
                 },
                 title: 'Shutting down the project',
             },

package/dist/commands/remove/index.js

@@ -4,12 +4,13 @@ import { getBackend } from '../../backend/index.js';
 import { getExecutor } from '../../executor/index.js';
 import { getConfigManager } from '../../lib/config/index.js';
 import { getEnvManager } from '../../lib/env/index.js';
+import { getLogger, isDebug, setDebug } from '../../lib/log.js';
 import { getParameterManager } from '../../lib/parameter/index.js';
-import { delay, setDebug } from '../../lib/shell.js';
+import { delay } from '../../lib/shell.js';
 export default class Remove extends Command {
     static args = {
         package: Args.string({
-            description: 'The package to remove. Packages are gitHub repositories. Use the format owner/repository',
+            description: `Remove a previously added package.`,
             required: true,
         }),
     };
@@ -17,7 +18,11 @@ export default class Remove extends Command {
     static examples = ['<%= config.bin %> <%= command.id %> cloudy/docker_postgres'];
     static flags = {
         chdir: Flags.string({
-            description: 'directory to run command in',
+            description: `
+        Directory where the command will be executed.
+        If not specified, it defaults to the current working directory.
+        Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment variable.
+      `,
             required: false,
         }),
         debug: Flags.boolean({
@@ -69,13 +74,17 @@ export default class Remove extends Command {
                             title: 'Resolving package parameters',
                         },
                         {
-                            async task(ctx) {
+                            rendererOptions: {
+                                persistentOutput: isDebug(),
+                            },
+                            async task(ctx, task) {
                                 const executor$ = getExecutor();
                                 if (!executor$.success) {
                                     throw new Error(executor$.reason);
                                 }
                                 const { executor } = executor$;
                                 const destroyOutput = await executor.destroy({
+                                    logger: getLogger(task),
                                     package: ctx.package,
                                     parameters: ctx.parametersOutput.parameters,
                                     project: ctx.configOutput.config.project,
@@ -129,7 +138,7 @@ export default class Remove extends Command {
                 },
                 title: `Removing ${args.package}`,
             },
-        ]);
+        ], { concurrent: false, rendererOptions: { collapseSubtasks: !isDebug() } });
         try {
             await task.run();
             myLogger.log(ListrLogLevels.COMPLETED, 'Package removed successfully');