hereya-cli 0.47.0 → 0.49.0

package/README.md

@@ -1,7 +1,7 @@
 hereya-cli
 =================
 
-Manage infrastructure components as packages.
+The package manager for infrastructure resources.
 
 
 [![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.47.0 linux-x64 node-v22.17.1
+hereya-cli/0.49.0 linux-x64 node-v22.17.1
 $ hereya --help [COMMAND]
 USAGE
   $ hereya COMMAND
@@ -40,7 +40,11 @@ USAGE
 * [`hereya down`](#hereya-down)
 * [`hereya env [NAME]`](#hereya-env-name)
 * [`hereya env set [NAME]`](#hereya-env-set-name)
+* [`hereya flow add PACKAGE`](#hereya-flow-add-package)
 * [`hereya flow down`](#hereya-flow-down)
+* [`hereya flow env [NAME]`](#hereya-flow-env-name)
+* [`hereya flow remove PACKAGE`](#hereya-flow-remove-package)
+* [`hereya flow run CMD`](#hereya-flow-run-cmd)
 * [`hereya flow up`](#hereya-flow-up)
 * [`hereya help [COMMAND]`](#hereya-help-command)
 * [`hereya import PACKAGE`](#hereya-import-package)
@@ -94,7 +98,7 @@ EXAMPLES
   $ hereya add cloudy/docker_postgres
 ```
 
-_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/add/index.ts)_
+_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/add/index.ts)_
 
 ## `hereya bootstrap INFRASTRUCTURETYPE`
 
@@ -119,7 +123,7 @@ EXAMPLES
   $ hereya bootstrap local
 ```
 
-_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/bootstrap/index.ts)_
+_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/bootstrap/index.ts)_
 
 ## `hereya config export-backend [FILE]`
 
@@ -141,7 +145,7 @@ EXAMPLES
   $ hereya config export-backend ./path/to/export.json
 ```
 
-_See code: [src/commands/config/export-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/config/export-backend/index.ts)_
+_See code: [src/commands/config/export-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/config/export-backend/index.ts)_
 
 ## `hereya config get-backend`
 
@@ -158,7 +162,7 @@ EXAMPLES
   $ hereya config get-backend
 ```
 
-_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/config/get-backend/index.ts)_
+_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/config/get-backend/index.ts)_
 
 ## `hereya config import-backend FILE`
 
@@ -178,7 +182,7 @@ EXAMPLES
   $ hereya config import-backend ./path/to/cloud-backend.json
 ```
 
-_See code: [src/commands/config/import-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/config/import-backend/index.ts)_
+_See code: [src/commands/config/import-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/config/import-backend/index.ts)_
 
 ## `hereya config use-backend TYPE`
 
@@ -200,7 +204,7 @@ EXAMPLES
   $ hereya config use-backend local
 ```
 
-_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/config/use-backend/index.ts)_
+_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/config/use-backend/index.ts)_
 
 ## `hereya delete-state`
 
@@ -226,7 +230,7 @@ EXAMPLES
   $ hereya delete-state --workspace staging
 ```
 
-_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/delete-state/index.ts)_
+_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/delete-state/index.ts)_
 
 ## `hereya deploy`
 
@@ -251,7 +255,7 @@ EXAMPLES
   $ hereya deploy
 ```
 
-_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/deploy/index.ts)_
+_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/deploy/index.ts)_
 
 ## `hereya down`
 
@@ -278,7 +282,7 @@ EXAMPLES
   $ hereya down
 ```
 
-_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/down/index.ts)_
+_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/down/index.ts)_
 
 ## `hereya env [NAME]`
 
@@ -309,7 +313,7 @@ EXAMPLES
   $ hereya env -w dev -l
 ```
 
-_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/env/index.ts)_
+_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/env/index.ts)_
 
 ## `hereya env set [NAME]`
 
@@ -336,7 +340,45 @@ 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.47.0/src/commands/env/set/index.ts)_
+_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/env/set/index.ts)_
+
+## `hereya flow add PACKAGE`
+
+Add a package to the project in a git branch-based workspace
+
+```
+USAGE
+  $ hereya flow add PACKAGE [--chdir <value>] [--debug] [-p <value>...] [--profile <value>]
+
+ARGUMENTS
+  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 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
+      --profile=<value>       profile to use for the workspace (will be appended to workspace name)
+
+DESCRIPTION
+  Add a package to the project in a git branch-based workspace
+
+EXAMPLES
+  $ hereya flow add cloudy/docker_postgres
+
+  $ hereya flow add cloudy/docker_postgres --profile staging
+
+  $ hereya flow add cloudy/docker_postgres -p DB_NAME=mydb -p DB_USER=admin
+```
+
+_See code: [src/commands/flow/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/flow/add/index.ts)_
 
 ## `hereya flow down`
 
@@ -370,7 +412,100 @@ EXAMPLES
   $ hereya flow down --pin
 ```
 
-_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/flow/down/index.ts)_
+_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/flow/down/index.ts)_
+
+## `hereya flow env [NAME]`
+
+Print project environment variables for a git branch-based workspace
+
+```
+USAGE
+  $ hereya flow env [NAME] [--chdir <value>] [-l] [--pin] [--profile <value>]
+
+ARGUMENTS
+  NAME  name of the env to display
+
+FLAGS
+  -l, --list             list only the env vars without values
+      --chdir=<value>    project root directory
+      --pin              append git commit SHA to workspace name for commit-specific isolation
+      --profile=<value>  profile to use for the workspace (will be appended to workspace name)
+
+DESCRIPTION
+  Print project environment variables for a git branch-based workspace
+
+EXAMPLES
+  $ hereya flow env
+
+  $ hereya flow env myEnv
+
+  $ hereya flow env --profile staging
+
+  $ hereya flow env --pin
+
+  $ hereya flow env -l
+```
+
+_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/flow/env/index.ts)_
+
+## `hereya flow remove PACKAGE`
+
+Remove a package from the project in a git branch-based workspace
+
+```
+USAGE
+  $ hereya flow remove PACKAGE [--chdir <value>] [--debug] [--profile <value>]
+
+ARGUMENTS
+  PACKAGE  Remove a previously added package.
+
+FLAGS
+  --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
+  --profile=<value>  profile to use for the workspace (will be appended to workspace name)
+
+DESCRIPTION
+  Remove a package from the project in a git branch-based workspace
+
+EXAMPLES
+  $ hereya flow remove cloudy/docker_postgres
+
+  $ hereya flow remove cloudy/docker_postgres --profile staging
+```
+
+_See code: [src/commands/flow/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/flow/remove/index.ts)_
+
+## `hereya flow run CMD`
+
+Run a command with hereya env vars in a git branch-based workspace
+
+```
+USAGE
+  $ hereya flow run CMD... [--chdir <value>] [--pin] [--profile <value>]
+
+ARGUMENTS
+  CMD...  command to run
+
+FLAGS
+  --chdir=<value>    directory to run command in
+  --pin              append git commit SHA to workspace name for commit-specific isolation
+  --profile=<value>  profile to use for the workspace (will be appended to workspace name)
+
+DESCRIPTION
+  Run a command with hereya env vars in a git branch-based workspace
+
+EXAMPLES
+  $ hereya flow run -- npm run dev
+
+  $ hereya flow run --profile staging -- node index.js
+
+  $ hereya flow run --pin -- npm test
+```
+
+_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/flow/run/index.ts)_
 
 ## `hereya flow up`
 
@@ -404,7 +539,7 @@ EXAMPLES
   $ hereya flow up --pin
 ```
 
-_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/flow/up/index.ts)_
+_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/flow/up/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -461,7 +596,7 @@ EXAMPLES
   $ hereya import org/my-package -f state.tfstate -w my-workspace
 ```
 
-_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/import/index.ts)_
+_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/import/index.ts)_
 
 ## `hereya init PROJECT`
 
@@ -487,7 +622,7 @@ EXAMPLES
   $ hereya init myProject -w=defaultWorkspace --chdir=./myProject
 ```
 
-_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/init/index.ts)_
+_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/init/index.ts)_
 
 ## `hereya login [URL]`
 
@@ -516,7 +651,7 @@ EXAMPLES
   $ hereya login --token=your-token https://cloud.hereya.dev
 ```
 
-_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/login/index.ts)_
+_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/login/index.ts)_
 
 ## `hereya logout`
 
@@ -533,7 +668,7 @@ EXAMPLES
   $ hereya logout
 ```
 
-_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/logout/index.ts)_
+_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/logout/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -561,7 +696,7 @@ EXAMPLES
   $ hereya remove cloudy/docker_postgres
 ```
 
-_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/remove/index.ts)_
+_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -587,7 +722,7 @@ EXAMPLES
   $ hereya run -w uat -- node index.js
 ```
 
-_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/run/index.ts)_
+_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/run/index.ts)_
 
 ## `hereya unbootstrap INFRASTRUCTURETYPE`
 
@@ -612,7 +747,7 @@ EXAMPLES
   $ hereya unbootstrap local
 ```
 
-_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/unbootstrap/index.ts)_
+_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -637,7 +772,7 @@ EXAMPLES
   $ hereya undeploy
 ```
 
-_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/undeploy/index.ts)_
+_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/undeploy/index.ts)_
 
 ## `hereya up`
 
@@ -664,7 +799,7 @@ EXAMPLES
   $ hereya up
 ```
 
-_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/up/index.ts)_
+_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/up/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -688,7 +823,7 @@ EXAMPLES
   $ hereya workspace create dev
 ```
 
-_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/workspace/create/index.ts)_
+_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -708,7 +843,7 @@ EXAMPLES
   $ hereya workspace delete dev
 ```
 
-_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/workspace/delete/index.ts)_
+_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -734,7 +869,7 @@ EXAMPLES
   $ hereya workspace env myEnv -w dev
 ```
 
-_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/workspace/env/index.ts)_
+_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace env set`
 
@@ -758,7 +893,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.47.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.49.0/src/commands/workspace/env/set/index.ts)_
 
 ## `hereya workspace env unset`
 
@@ -779,7 +914,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.47.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.49.0/src/commands/workspace/env/unset/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -806,7 +941,7 @@ EXAMPLES
   $ hereya workspace install hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/workspace/install/index.ts)_
+_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace list`
 
@@ -823,7 +958,7 @@ EXAMPLES
   $ hereya workspace list
 ```
 
-_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/workspace/list/index.ts)_
+_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/workspace/list/index.ts)_
 
 ## `hereya workspace set-profile PROFILE`
 
@@ -846,7 +981,7 @@ EXAMPLES
   $ hereya workspace set-profile prod-profile -w production
 ```
 
-_See code: [src/commands/workspace/set-profile/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/workspace/set-profile/index.ts)_
+_See code: [src/commands/workspace/set-profile/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/workspace/set-profile/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -873,5 +1008,5 @@ EXAMPLES
   $ hereya workspace uninstall hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.47.0/src/commands/workspace/uninstall/index.ts)_
+_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.49.0/src/commands/workspace/uninstall/index.ts)_
 <!-- commandsstop -->

package/dist/commands/flow/add/index.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+export default class FlowAdd extends Command {
+    static args: {
+        package: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        chdir: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        parameter: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/flow/add/index.js

@@ -0,0 +1,90 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { getConfigManager } from '../../../lib/config/index.js';
+import { buildFlowWorkspaceName } from '../../../lib/flow-utils.js';
+import { setDebug } from '../../../lib/log.js';
+import Add from '../../add/index.js';
+import WorkspaceCreate from '../../workspace/create/index.js';
+export default class FlowAdd extends Command {
+    static args = {
+        package: Args.string({
+            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,
+        }),
+    };
+    static description = 'Add a package to the project in a git branch-based workspace';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> cloudy/docker_postgres',
+        '<%= config.bin %> <%= command.id %> cloudy/docker_postgres --profile staging',
+        '<%= config.bin %> <%= command.id %> cloudy/docker_postgres -p DB_NAME=mydb -p DB_USER=admin',
+    ];
+    static flags = {
+        chdir: Flags.string({
+            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({
+            default: false,
+            description: 'enable debug mode',
+        }),
+        parameter: Flags.string({
+            char: 'p',
+            default: [],
+            description: "parameter for the package, in the form of 'key=value'. Can be specified multiple times.",
+            multiple: true,
+        }),
+        profile: Flags.string({
+            description: 'profile to use for the workspace (will be appended to workspace name)',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FlowAdd);
+        setDebug(flags.debug);
+        const projectRootDir = flags.chdir || process.env.HEREYA_PROJECT_ROOT_DIR;
+        // Load project config
+        const configManager = getConfigManager();
+        const loadConfigOutput = await configManager.loadConfig({ projectRootDir });
+        if (!loadConfigOutput.found) {
+            this.error("Project not initialized. Run 'hereya init' first.");
+        }
+        // Build workspace name using flow utility (no pin support)
+        const workspaceName = await buildFlowWorkspaceName({
+            pin: false,
+            profile: flags.profile,
+            project: loadConfigOutput.config.project,
+            projectRootDir,
+        });
+        // Create workspace with mirror
+        const createArgs = [workspaceName, '--mirror', loadConfigOutput.config.workspace];
+        if (projectRootDir) {
+            createArgs.push('--chdir', projectRootDir);
+        }
+        if (flags.debug) {
+            createArgs.push('--debug');
+        }
+        if (flags.profile) {
+            createArgs.push('--profile', flags.profile);
+        }
+        await WorkspaceCreate.run(createArgs);
+        // Build args for add command
+        const addArgs = [args.package, '--workspace', workspaceName];
+        // Pass through all flags
+        if (flags.chdir)
+            addArgs.push('--chdir', flags.chdir);
+        if (flags.debug)
+            addArgs.push('--debug');
+        // Pass through parameters
+        for (const param of flags.parameter) {
+            addArgs.push('--parameter', param);
+        }
+        await Add.run(addArgs);
+    }
+}

package/dist/commands/flow/down/index.js

@@ -1,6 +1,6 @@
 import { Command, Flags } from '@oclif/core';
 import { getConfigManager } from '../../../lib/config/index.js';
-import { gitUtils } from '../../../lib/git-utils.js';
+import { buildFlowWorkspaceName } from '../../../lib/flow-utils.js';
 import { setDebug } from '../../../lib/log.js';
 import DeleteState from '../../delete-state/index.js';
 import Down from '../../down/index.js';
@@ -56,22 +56,13 @@ export default class FlowDown extends Command {
         if (!loadConfigOutput.found) {
             this.error("Project not initialized. Run 'hereya init' first.");
         }
-        // Get current git branch
-        const gitBranch = await gitUtils.getCurrentGitBranch(projectRootDir);
-        // Sanitize branch name
-        const sanitizedBranch = gitUtils.sanitizeBranchName(gitBranch);
-        if (!sanitizedBranch) {
-            this.error('Branch name contains only special characters and cannot be used for workspace name');
-        }
-        // Get commit SHA if pin flag is set
-        const commitSHA = flags.pin ? await gitUtils.getShortCommitSHA(projectRootDir) : null;
-        // Build workspace name parts
-        const parts = [loadConfigOutput.config.project, sanitizedBranch];
-        if (flags.profile)
-            parts.push(flags.profile);
-        if (commitSHA)
-            parts.push(commitSHA);
-        const workspaceName = parts.join('---');
+        // Build workspace name using flow utility
+        const workspaceName = await buildFlowWorkspaceName({
+            pin: flags.pin,
+            profile: flags.profile,
+            project: loadConfigOutput.config.project,
+            projectRootDir,
+        });
         // Create workspace with mirror
         const createArgs = [workspaceName, '--mirror', loadConfigOutput.config.workspace];
         if (projectRootDir) {

package/dist/commands/flow/env/index.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+export default class FlowEnv extends Command {
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        chdir: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        list: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        pin: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/flow/env/index.js

@@ -0,0 +1,64 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { getConfigManager } from '../../../lib/config/index.js';
+import { buildFlowWorkspaceName } from '../../../lib/flow-utils.js';
+import Env from '../../env/index.js';
+export default class FlowEnv extends Command {
+    static args = {
+        name: Args.string({ description: 'name of the env to display', required: false }),
+    };
+    static description = 'Print project environment variables for a git branch-based workspace';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> myEnv',
+        '<%= config.bin %> <%= command.id %> --profile staging',
+        '<%= config.bin %> <%= command.id %> --pin',
+        '<%= config.bin %> <%= command.id %> -l',
+    ];
+    static flags = {
+        chdir: Flags.string({
+            description: 'project root directory',
+            required: false,
+        }),
+        list: Flags.boolean({
+            char: 'l',
+            description: 'list only the env vars without values',
+            required: false,
+        }),
+        pin: Flags.boolean({
+            description: 'append git commit SHA to workspace name for commit-specific isolation',
+            required: false,
+        }),
+        profile: Flags.string({
+            description: 'profile to use for the workspace (will be appended to workspace name)',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FlowEnv);
+        const projectRootDir = flags.chdir || process.env.HEREYA_PROJECT_ROOT_DIR;
+        // Load project config
+        const configManager = getConfigManager();
+        const loadConfigOutput = await configManager.loadConfig({ projectRootDir });
+        if (!loadConfigOutput.found) {
+            this.error("Project not initialized. Run 'hereya init' first.");
+        }
+        // Build workspace name using flow utility
+        const workspaceName = await buildFlowWorkspaceName({
+            pin: flags.pin,
+            profile: flags.profile,
+            project: loadConfigOutput.config.project,
+            projectRootDir,
+        });
+        // Build args for env command
+        const envArgs = ['--workspace', workspaceName];
+        // Pass through all flags
+        if (flags.chdir)
+            envArgs.push('--chdir', flags.chdir);
+        if (flags.list)
+            envArgs.push('--list');
+        // Add the env name argument if provided
+        if (args.name)
+            envArgs.push(args.name);
+        await Env.run(envArgs);
+    }
+}

package/dist/commands/flow/remove/index.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class FlowRemove extends Command {
+    static args: {
+        package: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        chdir: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/flow/remove/index.js

@@ -0,0 +1,75 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { getConfigManager } from '../../../lib/config/index.js';
+import { buildFlowWorkspaceName } from '../../../lib/flow-utils.js';
+import { setDebug } from '../../../lib/log.js';
+import Remove from '../../remove/index.js';
+import WorkspaceCreate from '../../workspace/create/index.js';
+export default class FlowRemove extends Command {
+    static args = {
+        package: Args.string({
+            description: `Remove a previously added package.`,
+            required: true,
+        }),
+    };
+    static description = 'Remove a package from the project in a git branch-based workspace';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> cloudy/docker_postgres',
+        '<%= config.bin %> <%= command.id %> cloudy/docker_postgres --profile staging',
+    ];
+    static flags = {
+        chdir: Flags.string({
+            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({
+            default: false,
+            description: 'enable debug mode',
+        }),
+        profile: Flags.string({
+            description: 'profile to use for the workspace (will be appended to workspace name)',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FlowRemove);
+        setDebug(flags.debug);
+        const projectRootDir = flags.chdir || process.env.HEREYA_PROJECT_ROOT_DIR;
+        // Load project config
+        const configManager = getConfigManager();
+        const loadConfigOutput = await configManager.loadConfig({ projectRootDir });
+        if (!loadConfigOutput.found) {
+            this.error("Project not initialized. Run 'hereya init' first.");
+        }
+        // Build workspace name using flow utility (no pin support)
+        const workspaceName = await buildFlowWorkspaceName({
+            pin: false,
+            profile: flags.profile,
+            project: loadConfigOutput.config.project,
+            projectRootDir,
+        });
+        // Create workspace with mirror
+        const createArgs = [workspaceName, '--mirror', loadConfigOutput.config.workspace];
+        if (projectRootDir) {
+            createArgs.push('--chdir', projectRootDir);
+        }
+        if (flags.debug) {
+            createArgs.push('--debug');
+        }
+        if (flags.profile) {
+            createArgs.push('--profile', flags.profile);
+        }
+        await WorkspaceCreate.run(createArgs);
+        // Build args for remove command
+        const removeArgs = [args.package, '--workspace', workspaceName];
+        // Pass through all flags
+        if (flags.chdir)
+            removeArgs.push('--chdir', flags.chdir);
+        if (flags.debug)
+            removeArgs.push('--debug');
+        await Remove.run(removeArgs);
+    }
+}

package/dist/commands/flow/run/index.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+export default class FlowRun extends Command {
+    static args: {
+        cmd: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        chdir: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        pin: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static strict: boolean;
+    run(): Promise<void>;
+}

package/dist/commands/flow/run/index.js

@@ -0,0 +1,57 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { getConfigManager } from '../../../lib/config/index.js';
+import { buildFlowWorkspaceName } from '../../../lib/flow-utils.js';
+import Run from '../../run/index.js';
+export default class FlowRun extends Command {
+    static args = {
+        cmd: Args.string({ description: 'command to run', required: true }),
+    };
+    static description = 'Run a command with hereya env vars in a git branch-based workspace';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> -- npm run dev',
+        '<%= config.bin %> <%= command.id %> --profile staging -- node index.js',
+        '<%= config.bin %> <%= command.id %> --pin -- npm test',
+    ];
+    static flags = {
+        chdir: Flags.string({
+            description: 'directory to run command in',
+            required: false,
+        }),
+        pin: Flags.boolean({
+            description: 'append git commit SHA to workspace name for commit-specific isolation',
+            required: false,
+        }),
+        profile: Flags.string({
+            description: 'profile to use for the workspace (will be appended to workspace name)',
+            required: false,
+        }),
+    };
+    static strict = false;
+    async run() {
+        const { argv, flags } = await this.parse(FlowRun);
+        const projectRootDir = flags.chdir || process.env.HEREYA_PROJECT_ROOT_DIR;
+        // Load project config
+        const configManager = getConfigManager();
+        const loadConfigOutput = await configManager.loadConfig({ projectRootDir });
+        if (!loadConfigOutput.found) {
+            this.error("Project not initialized. Run 'hereya init' first.");
+        }
+        // Build workspace name using flow utility
+        const workspaceName = await buildFlowWorkspaceName({
+            pin: flags.pin,
+            profile: flags.profile,
+            project: loadConfigOutput.config.project,
+            projectRootDir,
+        });
+        // Build args for run command
+        const runArgs = ['--workspace', workspaceName];
+        // Pass through chdir flag
+        if (flags.chdir)
+            runArgs.push('--chdir', flags.chdir);
+        // Add the command and its arguments
+        // argv contains all the arguments after the double dash
+        const allCmdArgs = argv;
+        runArgs.push('--', ...allCmdArgs);
+        await Run.run(runArgs);
+    }
+}

package/dist/commands/flow/up/index.js

@@ -1,6 +1,6 @@
 import { Command, Flags } from '@oclif/core';
 import { getConfigManager } from '../../../lib/config/index.js';
-import { gitUtils } from '../../../lib/git-utils.js';
+import { buildFlowWorkspaceName } from '../../../lib/flow-utils.js';
 import { setDebug } from '../../../lib/log.js';
 import Up from '../../up/index.js';
 import WorkspaceCreate from '../../workspace/create/index.js';
@@ -54,22 +54,13 @@ export default class FlowUp extends Command {
         if (!loadConfigOutput.found) {
             this.error("Project not initialized. Run 'hereya init' first.");
         }
-        // Get current git branch
-        const gitBranch = await gitUtils.getCurrentGitBranch(projectRootDir);
-        // Sanitize branch name
-        const sanitizedBranch = gitUtils.sanitizeBranchName(gitBranch);
-        if (!sanitizedBranch) {
-            this.error('Branch name contains only special characters and cannot be used for workspace name');
-        }
-        // Get commit SHA if pin flag is set
-        const commitSHA = flags.pin ? await gitUtils.getShortCommitSHA(projectRootDir) : null;
-        // Build workspace name parts
-        const parts = [loadConfigOutput.config.project, sanitizedBranch];
-        if (flags.profile)
-            parts.push(flags.profile);
-        if (commitSHA)
-            parts.push(commitSHA);
-        const workspaceName = parts.join('---');
+        // Build workspace name using flow utility
+        const workspaceName = await buildFlowWorkspaceName({
+            pin: flags.pin,
+            profile: flags.profile,
+            project: loadConfigOutput.config.project,
+            projectRootDir,
+        });
         // Create workspace with mirror
         const createArgs = [workspaceName, '--mirror', loadConfigOutput.config.workspace];
         if (projectRootDir) {

package/dist/lib/flow-utils.d.ts

@@ -0,0 +1,7 @@
+export interface BuildFlowWorkspaceNameOptions {
+    pin?: boolean;
+    profile?: string;
+    project: string;
+    projectRootDir?: string;
+}
+export declare function buildFlowWorkspaceName(options: BuildFlowWorkspaceNameOptions): Promise<string>;

package/dist/lib/flow-utils.js

@@ -0,0 +1,22 @@
+import { gitUtils } from './git-utils.js';
+export async function buildFlowWorkspaceName(options) {
+    const { pin, profile, project, projectRootDir } = options;
+    // Get current git branch
+    const gitBranch = await gitUtils.getCurrentGitBranch(projectRootDir);
+    // Sanitize branch name
+    const sanitizedBranch = gitUtils.sanitizeBranchName(gitBranch);
+    if (!sanitizedBranch) {
+        throw new Error('Branch name contains only special characters and cannot be used for workspace name');
+    }
+    // Get commit SHA if pin is enabled
+    const commitSHA = pin ? await gitUtils.getShortCommitSHA(projectRootDir) : null;
+    // Build workspace name parts
+    const parts = [project, sanitizedBranch];
+    if (profile) {
+        parts.push(profile);
+    }
+    if (commitSHA) {
+        parts.push(commitSHA);
+    }
+    return parts.join('---');
+}

package/dist/lib/parameter/index.js

@@ -45,20 +45,6 @@ export class ParameterManager {
             };
         }
         const pkgName = getPackageCanonicalName(input.package);
-        const paramFilesExist = await Promise.all([
-            [`${pkgName}.yaml`, `${pkgName}.yml`],
-            [`${pkgName}.${input.workspace}.yaml`, `${pkgName}.${input.workspace}.yml`],
-        ].map(async ([filename, altFilename]) => {
-            const filePath = await getAnyPath(path.join(await this.getParametersFolder(input.projectRootDir), filename), path.join(await this.getParametersFolder(input.projectRootDir), altFilename));
-            const { found } = await load(filePath);
-            return found;
-        }));
-        if (paramFilesExist.some(Boolean)) {
-            return {
-                filePath: null,
-                saved: false,
-            };
-        }
         const filePath = path.join(await this.getParametersFolder(input.projectRootDir), `${pkgName}.yaml`);
         await save(input.parameters, filePath);
         return {

package/oclif.manifest.json

@@ -939,6 +939,71 @@
         "index.js"
       ]
     },
+    "flow:add": {
+      "aliases": [],
+      "args": {
+        "package": {
+          "description": "\n        The package to add, specified as a GitHub repository in the format owner/repository.\n        To change the registry URL, set the HEREYA_REGISTRY_URL environment variable, so that it points to $HEREYA_REGISTRY_URL/owner/repository.\n        For local packages, use the format local/path/to/package where path/to/package is the path to the package on your local machine.\n      ",
+          "name": "package",
+          "required": true
+        }
+      },
+      "description": "Add a package to the project in a git branch-based workspace",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres",
+        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres --profile staging",
+        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres -p DB_NAME=mydb -p DB_USER=admin"
+      ],
+      "flags": {
+        "chdir": {
+          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n        Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment variable.\n      ",
+          "name": "chdir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "parameter": {
+          "char": "p",
+          "description": "parameter for the package, in the form of 'key=value'. Can be specified multiple times.",
+          "name": "parameter",
+          "default": [],
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "profile": {
+          "description": "profile to use for the workspace (will be appended to workspace name)",
+          "name": "profile",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "flow:add",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flow",
+        "add",
+        "index.js"
+      ]
+    },
     "flow:down": {
       "aliases": [],
       "args": {},
@@ -1013,6 +1078,185 @@
         "index.js"
       ]
     },
+    "flow:env": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "name of the env to display",
+          "name": "name",
+          "required": false
+        }
+      },
+      "description": "Print project environment variables for a git branch-based workspace",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> myEnv",
+        "<%= config.bin %> <%= command.id %> --profile staging",
+        "<%= config.bin %> <%= command.id %> --pin",
+        "<%= config.bin %> <%= command.id %> -l"
+      ],
+      "flags": {
+        "chdir": {
+          "description": "project root directory",
+          "name": "chdir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "list": {
+          "char": "l",
+          "description": "list only the env vars without values",
+          "name": "list",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "pin": {
+          "description": "append git commit SHA to workspace name for commit-specific isolation",
+          "name": "pin",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "profile": {
+          "description": "profile to use for the workspace (will be appended to workspace name)",
+          "name": "profile",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "flow:env",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flow",
+        "env",
+        "index.js"
+      ]
+    },
+    "flow:remove": {
+      "aliases": [],
+      "args": {
+        "package": {
+          "description": "Remove a previously added package.",
+          "name": "package",
+          "required": true
+        }
+      },
+      "description": "Remove a package from the project in a git branch-based workspace",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres",
+        "<%= config.bin %> <%= command.id %> cloudy/docker_postgres --profile staging"
+      ],
+      "flags": {
+        "chdir": {
+          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n        Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment variable.\n      ",
+          "name": "chdir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "profile": {
+          "description": "profile to use for the workspace (will be appended to workspace name)",
+          "name": "profile",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "flow:remove",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flow",
+        "remove",
+        "index.js"
+      ]
+    },
+    "flow:run": {
+      "aliases": [],
+      "args": {
+        "cmd": {
+          "description": "command to run",
+          "name": "cmd",
+          "required": true
+        }
+      },
+      "description": "Run a command with hereya env vars in a git branch-based workspace",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -- npm run dev",
+        "<%= config.bin %> <%= command.id %> --profile staging -- node index.js",
+        "<%= config.bin %> <%= command.id %> --pin -- npm test"
+      ],
+      "flags": {
+        "chdir": {
+          "description": "directory to run command in",
+          "name": "chdir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "pin": {
+          "description": "append git commit SHA to workspace name for commit-specific isolation",
+          "name": "pin",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "profile": {
+          "description": "profile to use for the workspace (will be appended to workspace name)",
+          "name": "profile",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "flow:run",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flow",
+        "run",
+        "index.js"
+      ]
+    },
     "flow:up": {
       "aliases": [],
       "args": {},
@@ -1526,5 +1770,5 @@
       ]
     }
   },
-  "version": "0.47.0"
+  "version": "0.49.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hereya-cli",
   "description": "Infrastructure as Package",
-  "version": "0.47.0",
+  "version": "0.49.0",
   "author": "Hereya Developers",
   "bin": {
     "hereya": "./bin/run.js"