hereya-cli 0.61.0 → 0.62.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g hereya-cli
 $ hereya COMMAND
 running command...
 $ hereya (--version)
-hereya-cli/0.61.0 linux-x64 node-v24.13.0
+hereya-cli/0.62.0 linux-x64 node-v24.13.0
 $ hereya --help [COMMAND]
 USAGE
   $ hereya COMMAND
@@ -44,6 +44,7 @@ USAGE
 * [`hereya flow add PACKAGE`](#hereya-flow-add-package)
 * [`hereya flow down`](#hereya-flow-down)
 * [`hereya flow env [NAME]`](#hereya-flow-env-name)
+* [`hereya flow provid PACKAGE`](#hereya-flow-provid-package)
 * [`hereya flow remove PACKAGE`](#hereya-flow-remove-package)
 * [`hereya flow run CMD`](#hereya-flow-run-cmd)
 * [`hereya flow up`](#hereya-flow-up)
@@ -102,7 +103,7 @@ EXAMPLES
   $ hereya add cloudy/docker_postgres
 ```
 
-_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/add/index.ts)_
+_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/add/index.ts)_
 
 ## `hereya bootstrap INFRASTRUCTURETYPE`
 
@@ -127,7 +128,7 @@ EXAMPLES
   $ hereya bootstrap local
 ```
 
-_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/bootstrap/index.ts)_
+_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/bootstrap/index.ts)_
 
 ## `hereya config export-backend [FILE]`
 
@@ -149,7 +150,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.61.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.62.0/src/commands/config/export-backend/index.ts)_
 
 ## `hereya config get-backend`
 
@@ -166,7 +167,7 @@ EXAMPLES
   $ hereya config get-backend
 ```
 
-_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.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.62.0/src/commands/config/get-backend/index.ts)_
 
 ## `hereya config import-backend FILE`
 
@@ -186,7 +187,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.61.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.62.0/src/commands/config/import-backend/index.ts)_
 
 ## `hereya config use-backend TYPE`
 
@@ -208,7 +209,7 @@ EXAMPLES
   $ hereya config use-backend local
 ```
 
-_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.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.62.0/src/commands/config/use-backend/index.ts)_
 
 ## `hereya delete-state`
 
@@ -234,7 +235,7 @@ EXAMPLES
   $ hereya delete-state --workspace staging
 ```
 
-_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/delete-state/index.ts)_
+_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/delete-state/index.ts)_
 
 ## `hereya deploy`
 
@@ -259,7 +260,7 @@ EXAMPLES
   $ hereya deploy
 ```
 
-_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/deploy/index.ts)_
+_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/deploy/index.ts)_
 
 ## `hereya doc PACKAGE`
 
@@ -292,7 +293,7 @@ EXAMPLES
   $ hereya doc my-package --no-doc
 ```
 
-_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/doc/index.ts)_
+_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/doc/index.ts)_
 
 ## `hereya down`
 
@@ -319,7 +320,7 @@ EXAMPLES
   $ hereya down
 ```
 
-_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/down/index.ts)_
+_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/down/index.ts)_
 
 ## `hereya env [NAME]`
 
@@ -350,7 +351,7 @@ EXAMPLES
   $ hereya env -w dev -l
 ```
 
-_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/env/index.ts)_
+_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/env/index.ts)_
 
 ## `hereya env set [NAME]`
 
@@ -377,7 +378,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.61.0/src/commands/env/set/index.ts)_
+_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/env/set/index.ts)_
 
 ## `hereya flow add PACKAGE`
 
@@ -415,7 +416,7 @@ EXAMPLES
   $ 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.61.0/src/commands/flow/add/index.ts)_
+_See code: [src/commands/flow/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/flow/add/index.ts)_
 
 ## `hereya flow down`
 
@@ -449,7 +450,7 @@ EXAMPLES
   $ hereya flow down --pin
 ```
 
-_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/flow/down/index.ts)_
+_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/flow/down/index.ts)_
 
 ## `hereya flow env [NAME]`
 
@@ -483,7 +484,36 @@ EXAMPLES
   $ hereya flow env -l
 ```
 
-_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/flow/env/index.ts)_
+_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/flow/env/index.ts)_
+
+## `hereya flow provid PACKAGE`
+
+Display the provisioning ID for a package in a git branch-based workspace
+
+```
+USAGE
+  $ hereya flow provid PACKAGE [-C <value>] [--pin] [--profile <value>]
+
+ARGUMENTS
+  PACKAGE  Package name (e.g., hereya/postgres)
+
+FLAGS
+  -C, --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
+  Display the provisioning ID for a package in a git branch-based workspace
+
+EXAMPLES
+  $ hereya flow provid hereya/postgres
+
+  $ hereya flow provid hereya/postgres --profile staging
+
+  $ hereya flow provid hereya/postgres --pin
+```
+
+_See code: [src/commands/flow/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/flow/provid/index.ts)_
 
 ## `hereya flow remove PACKAGE`
 
@@ -513,7 +543,7 @@ EXAMPLES
   $ hereya flow remove cloudy/docker_postgres --profile staging
 ```
 
-_See code: [src/commands/flow/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/flow/remove/index.ts)_
+_See code: [src/commands/flow/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/flow/remove/index.ts)_
 
 ## `hereya flow run CMD`
 
@@ -542,7 +572,7 @@ EXAMPLES
   $ hereya flow run --pin -- npm test
 ```
 
-_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/flow/run/index.ts)_
+_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/flow/run/index.ts)_
 
 ## `hereya flow up`
 
@@ -576,7 +606,7 @@ EXAMPLES
   $ hereya flow up --pin
 ```
 
-_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/flow/up/index.ts)_
+_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/flow/up/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -633,7 +663,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.61.0/src/commands/import/index.ts)_
+_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/import/index.ts)_
 
 ## `hereya init PROJECT`
 
@@ -659,7 +689,7 @@ EXAMPLES
   $ hereya init myProject -w=defaultWorkspace --chdir=./myProject
 ```
 
-_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/init/index.ts)_
+_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/init/index.ts)_
 
 ## `hereya login [URL]`
 
@@ -688,7 +718,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.61.0/src/commands/login/index.ts)_
+_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/login/index.ts)_
 
 ## `hereya logout`
 
@@ -705,7 +735,7 @@ EXAMPLES
   $ hereya logout
 ```
 
-_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/logout/index.ts)_
+_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/logout/index.ts)_
 
 ## `hereya provid PACKAGE`
 
@@ -733,7 +763,7 @@ EXAMPLES
   $ hereya provid hereya/postgres --workspace staging
 ```
 
-_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/provid/index.ts)_
+_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/provid/index.ts)_
 
 ## `hereya publish`
 
@@ -756,7 +786,7 @@ EXAMPLES
   $ hereya publish --chdir=/path/to/package
 ```
 
-_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/publish/index.ts)_
+_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/publish/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -784,7 +814,7 @@ EXAMPLES
   $ hereya remove cloudy/docker_postgres
 ```
 
-_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/remove/index.ts)_
+_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -810,7 +840,7 @@ EXAMPLES
   $ hereya run -w uat -- node index.js
 ```
 
-_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/run/index.ts)_
+_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/run/index.ts)_
 
 ## `hereya search QUERY`
 
@@ -841,7 +871,7 @@ EXAMPLES
   $ hereya search database --json
 ```
 
-_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/search/index.ts)_
+_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/search/index.ts)_
 
 ## `hereya unbootstrap INFRASTRUCTURETYPE`
 
@@ -866,7 +896,7 @@ EXAMPLES
   $ hereya unbootstrap local
 ```
 
-_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/unbootstrap/index.ts)_
+_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -891,7 +921,7 @@ EXAMPLES
   $ hereya undeploy
 ```
 
-_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/undeploy/index.ts)_
+_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/undeploy/index.ts)_
 
 ## `hereya up`
 
@@ -918,7 +948,7 @@ EXAMPLES
   $ hereya up
 ```
 
-_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/up/index.ts)_
+_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/up/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -943,7 +973,7 @@ EXAMPLES
   $ hereya workspace create dev
 ```
 
-_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/workspace/create/index.ts)_
+_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -963,7 +993,7 @@ EXAMPLES
   $ hereya workspace delete dev
 ```
 
-_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/workspace/delete/index.ts)_
+_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -989,7 +1019,7 @@ EXAMPLES
   $ hereya workspace env myEnv -w dev
 ```
 
-_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/workspace/env/index.ts)_
+_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace env set`
 
@@ -1013,7 +1043,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.61.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.62.0/src/commands/workspace/env/set/index.ts)_
 
 ## `hereya workspace env unset`
 
@@ -1034,7 +1064,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.61.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.62.0/src/commands/workspace/env/unset/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -1061,7 +1091,7 @@ EXAMPLES
   $ hereya workspace install hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/workspace/install/index.ts)_
+_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace list`
 
@@ -1078,7 +1108,7 @@ EXAMPLES
   $ hereya workspace list
 ```
 
-_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/workspace/list/index.ts)_
+_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/workspace/list/index.ts)_
 
 ## `hereya workspace set-profile PROFILE`
 
@@ -1102,7 +1132,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.61.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.62.0/src/commands/workspace/set-profile/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -1129,5 +1159,5 @@ EXAMPLES
   $ hereya workspace uninstall hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/workspace/uninstall/index.ts)_
+_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/workspace/uninstall/index.ts)_
 <!-- commandsstop -->

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

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class FlowProvid 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>;
+        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/provid/index.js

@@ -0,0 +1,64 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { getBackend } from '../../../backend/index.js';
+import { getConfigManager } from '../../../lib/config/index.js';
+import { buildFlowWorkspaceName } from '../../../lib/flow-utils.js';
+import { validateFlowCommand } from '../../../lib/workspace-validation.js';
+import Provid from '../../provid/index.js';
+export default class FlowProvid extends Command {
+    static args = {
+        package: Args.string({
+            description: 'Package name (e.g., hereya/postgres)',
+            required: true,
+        }),
+    };
+    static description = 'Display the provisioning ID for a package in a git branch-based workspace';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> hereya/postgres',
+        '<%= config.bin %> <%= command.id %> hereya/postgres --profile staging',
+        '<%= config.bin %> <%= command.id %> hereya/postgres --pin',
+    ];
+    static flags = {
+        chdir: Flags.string({
+            char: 'C',
+            description: 'Project root directory',
+            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(FlowProvid);
+        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,
+        });
+        // Validate that if workspace exists, it's not a deployment workspace
+        const backend = await getBackend();
+        const validation = await validateFlowCommand(workspaceName, backend);
+        if (!validation.isValid) {
+            this.error(validation.message);
+        }
+        // Build args for provid command
+        const providArgs = [args.package, '--workspace', workspaceName];
+        // Pass through chdir flag
+        if (flags.chdir)
+            providArgs.push('--chdir', flags.chdir);
+        await Provid.run(providArgs);
+    }
+}

package/oclif.manifest.json

@@ -193,63 +193,6 @@
         "index.js"
       ]
     },
-    "doc": {
-      "aliases": [],
-      "args": {
-        "package": {
-          "description": "Package name with optional version (e.g., my-package or my-package@1.0.0)",
-          "name": "package",
-          "required": true
-        }
-      },
-      "description": "Display documentation for a package from the registry",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> my-package",
-        "<%= config.bin %> <%= command.id %> my-package@1.0.0",
-        "<%= config.bin %> <%= command.id %> my-package --json",
-        "<%= config.bin %> <%= command.id %> my-package --no-doc"
-      ],
-      "flags": {
-        "chdir": {
-          "char": "C",
-          "description": "directory to run command in",
-          "helpGroup": "global",
-          "name": "chdir",
-          "default": ".",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "json": {
-          "char": "j",
-          "description": "Output in JSON format",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "no-doc": {
-          "description": "Show only metadata without the full documentation",
-          "name": "no-doc",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "doc",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "doc",
-        "index.js"
-      ]
-    },
     "down": {
       "aliases": [],
       "args": {},
@@ -314,6 +257,63 @@
         "index.js"
       ]
     },
+    "doc": {
+      "aliases": [],
+      "args": {
+        "package": {
+          "description": "Package name with optional version (e.g., my-package or my-package@1.0.0)",
+          "name": "package",
+          "required": true
+        }
+      },
+      "description": "Display documentation for a package from the registry",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> my-package",
+        "<%= config.bin %> <%= command.id %> my-package@1.0.0",
+        "<%= config.bin %> <%= command.id %> my-package --json",
+        "<%= config.bin %> <%= command.id %> my-package --no-doc"
+      ],
+      "flags": {
+        "chdir": {
+          "char": "C",
+          "description": "directory to run command in",
+          "helpGroup": "global",
+          "name": "chdir",
+          "default": ".",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "char": "j",
+          "description": "Output in JSON format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-doc": {
+          "description": "Show only metadata without the full documentation",
+          "name": "no-doc",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "doc",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "doc",
+        "index.js"
+      ]
+    },
     "env": {
       "aliases": [],
       "args": {
@@ -615,40 +615,6 @@
         "index.js"
       ]
     },
-    "publish": {
-      "aliases": [],
-      "args": {},
-      "description": "Publish a package to the Hereya registry",
-      "examples": [
-        "$ hereya publish",
-        "$ hereya publish --chdir=/path/to/package"
-      ],
-      "flags": {
-        "chdir": {
-          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n      ",
-          "name": "chdir",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "publish",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "publish",
-        "index.js"
-      ]
-    },
     "remove": {
       "aliases": [],
       "args": {
@@ -703,6 +669,40 @@
         "index.js"
       ]
     },
+    "publish": {
+      "aliases": [],
+      "args": {},
+      "description": "Publish a package to the Hereya registry",
+      "examples": [
+        "$ hereya publish",
+        "$ hereya publish --chdir=/path/to/package"
+      ],
+      "flags": {
+        "chdir": {
+          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n      ",
+          "name": "chdir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "publish",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "publish",
+        "index.js"
+      ]
+    },
     "run": {
       "aliases": [],
       "args": {
@@ -1019,23 +1019,24 @@
         "index.js"
       ]
     },
-    "config:import-backend": {
+    "config:use-backend": {
       "aliases": [],
       "args": {
-        "file": {
-          "description": "Path to the file containing the backend configuration to import",
-          "name": "file",
+        "type": {
+          "description": "type of backend to use. Possible values: s3, local",
+          "name": "type",
           "required": true
         }
       },
-      "description": "Import a backend configuration from a file",
+      "description": "set the current backend type",
       "examples": [
-        "<%= config.bin %> <%= command.id %> ./path/to/cloud-backend.json"
+        "<%= config.bin %> <%= command.id %> s3",
+        "<%= config.bin %> <%= command.id %> local"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:import-backend",
+      "id": "config:use-backend",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -1046,28 +1047,27 @@
         "dist",
         "commands",
         "config",
-        "import-backend",
+        "use-backend",
         "index.js"
       ]
     },
-    "config:use-backend": {
+    "config:import-backend": {
       "aliases": [],
       "args": {
-        "type": {
-          "description": "type of backend to use. Possible values: s3, local",
-          "name": "type",
+        "file": {
+          "description": "Path to the file containing the backend configuration to import",
+          "name": "file",
           "required": true
         }
       },
-      "description": "set the current backend type",
+      "description": "Import a backend configuration from a file",
       "examples": [
-        "<%= config.bin %> <%= command.id %> s3",
-        "<%= config.bin %> <%= command.id %> local"
+        "<%= config.bin %> <%= command.id %> ./path/to/cloud-backend.json"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:use-backend",
+      "id": "config:import-backend",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -1078,7 +1078,7 @@
         "dist",
         "commands",
         "config",
-        "use-backend",
+        "import-backend",
         "index.js"
       ]
     },
@@ -1346,6 +1346,64 @@
         "index.js"
       ]
     },
+    "flow:provid": {
+      "aliases": [],
+      "args": {
+        "package": {
+          "description": "Package name (e.g., hereya/postgres)",
+          "name": "package",
+          "required": true
+        }
+      },
+      "description": "Display the provisioning ID for a package in a git branch-based workspace",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> hereya/postgres",
+        "<%= config.bin %> <%= command.id %> hereya/postgres --profile staging",
+        "<%= config.bin %> <%= command.id %> hereya/postgres --pin"
+      ],
+      "flags": {
+        "chdir": {
+          "char": "C",
+          "description": "Project root directory",
+          "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:provid",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flow",
+        "provid",
+        "index.js"
+      ]
+    },
     "flow:remove": {
       "aliases": [],
       "args": {
@@ -1987,5 +2045,5 @@
       ]
     }
   },
-  "version": "0.61.0"
+  "version": "0.62.0"
 }

package/package.json

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