hereya-cli 0.47.0 → 0.48.0

package/README.md

@@ -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.48.0 linux-x64 node-v22.17.1
 $ hereya --help [COMMAND]
 USAGE
   $ hereya COMMAND
@@ -41,6 +41,7 @@ USAGE
 * [`hereya env [NAME]`](#hereya-env-name)
 * [`hereya env set [NAME]`](#hereya-env-set-name)
 * [`hereya flow down`](#hereya-flow-down)
+* [`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 +95,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.48.0/src/commands/add/index.ts)_
 
 ## `hereya bootstrap INFRASTRUCTURETYPE`
 
@@ -119,7 +120,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.48.0/src/commands/bootstrap/index.ts)_
 
 ## `hereya config export-backend [FILE]`
 
@@ -141,7 +142,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.48.0/src/commands/config/export-backend/index.ts)_
 
 ## `hereya config get-backend`
 
@@ -158,7 +159,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.48.0/src/commands/config/get-backend/index.ts)_
 
 ## `hereya config import-backend FILE`
 
@@ -178,7 +179,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.48.0/src/commands/config/import-backend/index.ts)_
 
 ## `hereya config use-backend TYPE`
 
@@ -200,7 +201,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.48.0/src/commands/config/use-backend/index.ts)_
 
 ## `hereya delete-state`
 
@@ -226,7 +227,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.48.0/src/commands/delete-state/index.ts)_
 
 ## `hereya deploy`
 
@@ -251,7 +252,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.48.0/src/commands/deploy/index.ts)_
 
 ## `hereya down`
 
@@ -278,7 +279,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.48.0/src/commands/down/index.ts)_
 
 ## `hereya env [NAME]`
 
@@ -309,7 +310,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.48.0/src/commands/env/index.ts)_
 
 ## `hereya env set [NAME]`
 
@@ -336,7 +337,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.47.0/src/commands/env/set/index.ts)_
+_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.48.0/src/commands/env/set/index.ts)_
 
 ## `hereya flow down`
 
@@ -370,7 +371,36 @@ 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.48.0/src/commands/flow/down/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.48.0/src/commands/flow/run/index.ts)_
 
 ## `hereya flow up`
 
@@ -404,7 +434,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.48.0/src/commands/flow/up/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -461,7 +491,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.48.0/src/commands/import/index.ts)_
 
 ## `hereya init PROJECT`
 
@@ -487,7 +517,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.48.0/src/commands/init/index.ts)_
 
 ## `hereya login [URL]`
 
@@ -516,7 +546,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.48.0/src/commands/login/index.ts)_
 
 ## `hereya logout`
 
@@ -533,7 +563,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.48.0/src/commands/logout/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -561,7 +591,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.48.0/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -587,7 +617,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.48.0/src/commands/run/index.ts)_
 
 ## `hereya unbootstrap INFRASTRUCTURETYPE`
 
@@ -612,7 +642,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.48.0/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -637,7 +667,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.48.0/src/commands/undeploy/index.ts)_
 
 ## `hereya up`
 
@@ -664,7 +694,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.48.0/src/commands/up/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -688,7 +718,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.48.0/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -708,7 +738,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.48.0/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -734,7 +764,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.48.0/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace env set`
 
@@ -758,7 +788,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.48.0/src/commands/workspace/env/set/index.ts)_
 
 ## `hereya workspace env unset`
 
@@ -779,7 +809,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.48.0/src/commands/workspace/env/unset/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -806,7 +836,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.48.0/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace list`
 
@@ -823,7 +853,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.48.0/src/commands/workspace/list/index.ts)_
 
 ## `hereya workspace set-profile PROFILE`
 
@@ -846,7 +876,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.48.0/src/commands/workspace/set-profile/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -873,5 +903,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.48.0/src/commands/workspace/uninstall/index.ts)_
 <!-- commandsstop -->

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,66 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { getConfigManager } from '../../../lib/config/index.js';
+import { gitUtils } from '../../../lib/git-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.");
+        }
+        // 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 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/oclif.manifest.json

@@ -1013,6 +1013,63 @@
         "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 +1583,5 @@
       ]
     }
   },
-  "version": "0.47.0"
+  "version": "0.48.0"
 }

package/package.json

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