hereya-cli 0.48.0 → 0.50.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.48.0 linux-x64 node-v22.17.1
+hereya-cli/0.50.0 linux-x64 node-v22.17.1
 $ hereya --help [COMMAND]
 USAGE
   $ hereya COMMAND
@@ -40,7 +40,10 @@ 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)
@@ -95,7 +98,7 @@ EXAMPLES
   $ hereya add cloudy/docker_postgres
 ```
 
-_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/add/index.ts)_
+_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/add/index.ts)_
 
 ## `hereya bootstrap INFRASTRUCTURETYPE`
 
@@ -120,7 +123,7 @@ EXAMPLES
   $ hereya bootstrap local
 ```
 
-_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/bootstrap/index.ts)_
+_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/bootstrap/index.ts)_
 
 ## `hereya config export-backend [FILE]`
 
@@ -142,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.48.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.50.0/src/commands/config/export-backend/index.ts)_
 
 ## `hereya config get-backend`
 
@@ -159,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.48.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.50.0/src/commands/config/get-backend/index.ts)_
 
 ## `hereya config import-backend FILE`
 
@@ -179,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.48.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.50.0/src/commands/config/import-backend/index.ts)_
 
 ## `hereya config use-backend TYPE`
 
@@ -201,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.48.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.50.0/src/commands/config/use-backend/index.ts)_
 
 ## `hereya delete-state`
 
@@ -227,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.48.0/src/commands/delete-state/index.ts)_
+_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/delete-state/index.ts)_
 
 ## `hereya deploy`
 
@@ -252,7 +255,7 @@ EXAMPLES
   $ hereya deploy
 ```
 
-_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/deploy/index.ts)_
+_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/deploy/index.ts)_
 
 ## `hereya down`
 
@@ -279,7 +282,7 @@ EXAMPLES
   $ hereya down
 ```
 
-_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/down/index.ts)_
+_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/down/index.ts)_
 
 ## `hereya env [NAME]`
 
@@ -310,7 +313,7 @@ EXAMPLES
   $ hereya env -w dev -l
 ```
 
-_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/env/index.ts)_
+_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/env/index.ts)_
 
 ## `hereya env set [NAME]`
 
@@ -337,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.48.0/src/commands/env/set/index.ts)_
+_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.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.50.0/src/commands/flow/add/index.ts)_
 
 ## `hereya flow down`
 
@@ -371,7 +412,71 @@ EXAMPLES
   $ hereya flow down --pin
 ```
 
-_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/flow/down/index.ts)_
+_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.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.50.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.50.0/src/commands/flow/remove/index.ts)_
 
 ## `hereya flow run CMD`
 
@@ -400,7 +505,7 @@ EXAMPLES
   $ hereya flow run --pin -- npm test
 ```
 
-_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/flow/run/index.ts)_
+_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/flow/run/index.ts)_
 
 ## `hereya flow up`
 
@@ -434,7 +539,7 @@ EXAMPLES
   $ hereya flow up --pin
 ```
 
-_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/flow/up/index.ts)_
+_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/flow/up/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -491,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.48.0/src/commands/import/index.ts)_
+_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/import/index.ts)_
 
 ## `hereya init PROJECT`
 
@@ -517,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.48.0/src/commands/init/index.ts)_
+_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/init/index.ts)_
 
 ## `hereya login [URL]`
 
@@ -546,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.48.0/src/commands/login/index.ts)_
+_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/login/index.ts)_
 
 ## `hereya logout`
 
@@ -563,7 +668,7 @@ EXAMPLES
   $ hereya logout
 ```
 
-_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/logout/index.ts)_
+_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/logout/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -591,7 +696,7 @@ EXAMPLES
   $ hereya remove cloudy/docker_postgres
 ```
 
-_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/remove/index.ts)_
+_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -617,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.48.0/src/commands/run/index.ts)_
+_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/run/index.ts)_
 
 ## `hereya unbootstrap INFRASTRUCTURETYPE`
 
@@ -642,7 +747,7 @@ EXAMPLES
   $ hereya unbootstrap local
 ```
 
-_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/unbootstrap/index.ts)_
+_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -667,7 +772,7 @@ EXAMPLES
   $ hereya undeploy
 ```
 
-_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/undeploy/index.ts)_
+_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/undeploy/index.ts)_
 
 ## `hereya up`
 
@@ -694,7 +799,7 @@ EXAMPLES
   $ hereya up
 ```
 
-_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/up/index.ts)_
+_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/up/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -718,7 +823,7 @@ EXAMPLES
   $ hereya workspace create dev
 ```
 
-_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/workspace/create/index.ts)_
+_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -738,7 +843,7 @@ EXAMPLES
   $ hereya workspace delete dev
 ```
 
-_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/workspace/delete/index.ts)_
+_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -764,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.48.0/src/commands/workspace/env/index.ts)_
+_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace env set`
 
@@ -788,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.48.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.50.0/src/commands/workspace/env/set/index.ts)_
 
 ## `hereya workspace env unset`
 
@@ -809,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.48.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.50.0/src/commands/workspace/env/unset/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -836,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.48.0/src/commands/workspace/install/index.ts)_
+_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace list`
 
@@ -853,7 +958,7 @@ EXAMPLES
   $ hereya workspace list
 ```
 
-_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/workspace/list/index.ts)_
+_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/workspace/list/index.ts)_
 
 ## `hereya workspace set-profile PROFILE`
 
@@ -876,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.48.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.50.0/src/commands/workspace/set-profile/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -903,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.48.0/src/commands/workspace/uninstall/index.ts)_
+_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.50.0/src/commands/workspace/uninstall/index.ts)_
 <!-- commandsstop -->

package/dist/backend/cloud/cloud-backend.js

@@ -1,4 +1,4 @@
-import { addOrgPrefix, extractOrgPrefix } from '../../lib/org-utils.js';
+import { resolveWorkspaceName } from '../../lib/workspace-utils.js';
 export class CloudBackend {
     config;
     constructor(config) {
@@ -212,13 +212,7 @@ export class CloudBackend {
     }
     async getWorkspaceEnv(input) {
         // Apply org prefix if project has one and workspace doesn't
-        let workspaceName = input.workspace;
-        if (input.project) {
-            const { org: projectOrg } = extractOrgPrefix(input.project);
-            if (projectOrg) {
-                workspaceName = addOrgPrefix(projectOrg, input.workspace);
-            }
-        }
+        const workspaceName = resolveWorkspaceName(input.workspace, input.project);
         const workspace$ = await this.getWorkspace(workspaceName);
         if (!workspace$.found) {
             return {

package/dist/backend/file.js

@@ -1,6 +1,6 @@
 import { randomUUID } from 'node:crypto';
 import { stringify } from 'yaml';
-import { addOrgPrefix, extractOrgPrefix } from '../lib/org-utils.js';
+import { resolveWorkspaceName } from '../lib/workspace-utils.js';
 import { parseYaml } from '../lib/yaml-utils.js';
 import { WorkspaceSchema, } from './common.js';
 export class FileBackend {
@@ -292,13 +292,7 @@ export class FileBackend {
     }
     async getWorkspaceEnv(input) {
         // Apply org prefix if project has one and workspace doesn't
-        let workspaceName = input.workspace;
-        if (input.project) {
-            const { org: projectOrg } = extractOrgPrefix(input.project);
-            if (projectOrg) {
-                workspaceName = addOrgPrefix(projectOrg, input.workspace);
-            }
-        }
+        const workspaceName = resolveWorkspaceName(input.workspace, input.project);
         const workspace$ = await this.getWorkspace(workspaceName);
         if (!workspace$.found) {
             return {

package/dist/commands/add/index.js

@@ -83,7 +83,7 @@ export default class Add extends Command {
                                 const userSpecifiedParameters = arrayOfStringToObject(ctx.userSpecifiedParameters);
                                 const parameterManager = getParameterManager();
                                 const backend = await getBackend();
-                                const profile = await getProfileFromWorkspace(backend, ctx.workspace);
+                                const profile = await getProfileFromWorkspace(backend, ctx.workspace, ctx.configOutput.config.project);
                                 const parametersOutput = await parameterManager.getPackageParameters({
                                     package: ctx.package,
                                     profile,

package/dist/commands/deploy/index.js

@@ -55,7 +55,7 @@ export default class Deploy extends Command {
             {
                 async task(ctx) {
                     const backend = await getBackend();
-                    const profile = await getProfileFromWorkspace(backend, ctx.workspace);
+                    const profile = await getProfileFromWorkspace(backend, ctx.workspace, ctx.configOutput.config.project);
                     const envManager = getEnvManager();
                     const getProjectEnvOutput = await envManager.getProjectEnv({
                         markSecret: true,
@@ -106,7 +106,7 @@ export default class Deploy extends Command {
                         async task(_, task) {
                             const parameterManager = getParameterManager();
                             const backend = await getBackend();
-                            const profile = await getProfileFromWorkspace(backend, ctx.workspace);
+                            const profile = await getProfileFromWorkspace(backend, ctx.workspace, ctx.configOutput.config.project);
                             const { parameters } = await parameterManager.getPackageParameters({
                                 package: packageName,
                                 profile,
@@ -146,7 +146,7 @@ export default class Deploy extends Command {
                         async task(_, task) {
                             const parameterManager = getParameterManager();
                             const backend = await getBackend();
-                            const profile = await getProfileFromWorkspace(backend, ctx.workspace);
+                            const profile = await getProfileFromWorkspace(backend, ctx.workspace, ctx.configOutput.config.project);
                             const { parameters } = await parameterManager.getPackageParameters({
                                 package: packageName,
                                 profile,
@@ -192,7 +192,7 @@ export default class Deploy extends Command {
                         async task(_, task) {
                             const parameterManager = getParameterManager();
                             const backend = await getBackend();
-                            const profile = await getProfileFromWorkspace(backend, ctx.workspace);
+                            const profile = await getProfileFromWorkspace(backend, ctx.workspace, ctx.configOutput.config.project);
                             const { parameters } = await parameterManager.getPackageParameters({
                                 package: packageName,
                                 profile,
@@ -279,7 +279,7 @@ export default class Deploy extends Command {
                 skip: (ctx) => ctx.deployPackages.length === 0,
                 async task(ctx, task) {
                     const backend = await getBackend();
-                    const profile = await getProfileFromWorkspace(backend, ctx.workspace);
+                    const profile = await getProfileFromWorkspace(backend, ctx.workspace, ctx.configOutput.config.project);
                     const envManager = getEnvManager();
                     const getProjectEnvOutput = await envManager.getProjectEnv({
                         markSecret: true,
@@ -298,7 +298,7 @@ export default class Deploy extends Command {
                         async task(_, task) {
                             const parameterManager = getParameterManager();
                             const backend = await getBackend();
-                            const profile = await getProfileFromWorkspace(backend, ctx.workspace);
+                            const profile = await getProfileFromWorkspace(backend, ctx.workspace, ctx.configOutput.config.project);
                             const { parameters } = await parameterManager.getPackageParameters({
                                 package: packageName,
                                 profile,

package/dist/commands/down/index.js

@@ -96,7 +96,7 @@ export default class Down extends Command {
                                     async task(_, task) {
                                         const parameterManager = getParameterManager();
                                         const backend = await getBackend();
-                                        const profile = await getProfileFromWorkspace(backend, ctx.workspace);
+                                        const profile = await getProfileFromWorkspace(backend, ctx.workspace, ctx.configOutput.config.project);
                                         const { parameters } = await parameterManager.getPackageParameters({
                                             package: packageName,
                                             profile,

package/dist/commands/env/index.js

@@ -49,7 +49,7 @@ export default class Env extends Command {
             this.error('you must specify a workspace to print the env vars for');
         }
         const backend = await getBackend();
-        const profile = await getProfileFromWorkspace(backend, workspace);
+        const profile = await getProfileFromWorkspace(backend, workspace, config.project);
         const envManager = getEnvManager();
         const getProjectEnvOutput = await envManager.getProjectEnv({
             profile,

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);
+    }
+}