hereya-cli 0.60.1 → 0.62.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g hereya-cli
 $ hereya COMMAND
 running command...
 $ hereya (--version)
-hereya-cli/0.60.1 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)
@@ -52,6 +53,7 @@ USAGE
 * [`hereya init PROJECT`](#hereya-init-project)
 * [`hereya login [URL]`](#hereya-login-url)
 * [`hereya logout`](#hereya-logout)
+* [`hereya provid PACKAGE`](#hereya-provid-package)
 * [`hereya publish`](#hereya-publish)
 * [`hereya remove PACKAGE`](#hereya-remove-package)
 * [`hereya run CMD`](#hereya-run-cmd)
@@ -101,7 +103,7 @@ EXAMPLES
   $ hereya add cloudy/docker_postgres
 ```
 
-_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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`
 
@@ -126,7 +128,7 @@ EXAMPLES
   $ hereya bootstrap local
 ```
 
-_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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]`
 
@@ -148,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.60.1/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`
 
@@ -165,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.60.1/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`
 
@@ -185,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.60.1/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`
 
@@ -207,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.60.1/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`
 
@@ -233,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.60.1/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`
 
@@ -258,7 +260,7 @@ EXAMPLES
   $ hereya deploy
 ```
 
-_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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`
 
@@ -291,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.60.1/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`
 
@@ -318,7 +320,7 @@ EXAMPLES
   $ hereya down
 ```
 
-_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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]`
 
@@ -349,7 +351,7 @@ EXAMPLES
   $ hereya env -w dev -l
 ```
 
-_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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]`
 
@@ -376,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.60.1/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`
 
@@ -414,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.60.1/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`
 
@@ -448,7 +450,7 @@ EXAMPLES
   $ hereya flow down --pin
 ```
 
-_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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]`
 
@@ -482,7 +484,36 @@ EXAMPLES
   $ hereya flow env -l
 ```
 
-_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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`
 
@@ -512,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.60.1/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`
 
@@ -541,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.60.1/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`
 
@@ -575,7 +606,7 @@ EXAMPLES
   $ hereya flow up --pin
 ```
 
-_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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]`
 
@@ -632,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.60.1/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`
 
@@ -658,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.60.1/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]`
 
@@ -687,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.60.1/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`
 
@@ -704,7 +735,35 @@ EXAMPLES
   $ hereya logout
 ```
 
-_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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`
+
+Display the provisioning ID for a package
+
+```
+USAGE
+  $ hereya provid PACKAGE [-C <value>] [-w <value>]
+
+ARGUMENTS
+  PACKAGE  Package name (e.g., hereya/postgres)
+
+FLAGS
+  -C, --chdir=<value>      Project root directory
+  -w, --workspace=<value>  Name of the workspace
+
+DESCRIPTION
+  Display the provisioning ID for a package
+
+EXAMPLES
+  $ hereya provid hereya/postgres
+
+  $ hereya provid hereya/postgres -w dev
+
+  $ hereya provid hereya/postgres --workspace staging
+```
+
+_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.62.0/src/commands/provid/index.ts)_
 
 ## `hereya publish`
 
@@ -727,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.60.1/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`
 
@@ -755,7 +814,7 @@ EXAMPLES
   $ hereya remove cloudy/docker_postgres
 ```
 
-_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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`
 
@@ -781,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.60.1/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`
 
@@ -812,7 +871,7 @@ EXAMPLES
   $ hereya search database --json
 ```
 
-_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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`
 
@@ -837,7 +896,7 @@ EXAMPLES
   $ hereya unbootstrap local
 ```
 
-_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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`
 
@@ -862,7 +921,7 @@ EXAMPLES
   $ hereya undeploy
 ```
 
-_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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`
 
@@ -889,7 +948,7 @@ EXAMPLES
   $ hereya up
 ```
 
-_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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`
 
@@ -914,7 +973,7 @@ EXAMPLES
   $ hereya workspace create dev
 ```
 
-_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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`
 
@@ -934,7 +993,7 @@ EXAMPLES
   $ hereya workspace delete dev
 ```
 
-_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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]`
 
@@ -960,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.60.1/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`
 
@@ -984,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.60.1/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`
 
@@ -1005,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.60.1/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`
 
@@ -1032,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.60.1/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`
 
@@ -1049,7 +1108,7 @@ EXAMPLES
   $ hereya workspace list
 ```
 
-_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.1/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`
 
@@ -1073,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.60.1/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`
 
@@ -1100,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.60.1/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/dist/commands/provid/index.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class Provid 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>;
+        workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private findPackageVersion;
+}

package/dist/commands/provid/index.js

@@ -0,0 +1,104 @@
+import { Args, Command, Flags } from '@oclif/core';
+import fs from 'node:fs/promises';
+import { getBackend } from '../../backend/index.js';
+import { getPackageDownloadPath } from '../../infrastructure/common.js';
+import { getProvisioningLogicalId } from '../../infrastructure/index.js';
+import { getConfigManager } from '../../lib/config/index.js';
+import { getPackageCanonicalName } from '../../lib/package/index.js';
+export default class Provid 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';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> hereya/postgres',
+        '<%= config.bin %> <%= command.id %> hereya/postgres -w dev',
+        '<%= config.bin %> <%= command.id %> hereya/postgres --workspace staging',
+    ];
+    static flags = {
+        chdir: Flags.string({
+            char: 'C',
+            description: 'Project root directory',
+            required: false,
+        }),
+        workspace: Flags.string({
+            char: 'w',
+            description: 'Name of the workspace',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Provid);
+        const projectRootDir = flags.chdir || process.env.HEREYA_PROJECT_ROOT_DIR;
+        const configManager = getConfigManager();
+        const loadConfigOutput = await configManager.loadConfig({ projectRootDir });
+        if (!loadConfigOutput.found) {
+            this.warn(`Project not initialized. Run 'hereya init' first.`);
+            return;
+        }
+        const { config } = loadConfigOutput;
+        let { workspace } = flags;
+        if (!workspace) {
+            workspace = config.workspace;
+        }
+        if (!workspace) {
+            this.error('You must specify a workspace with --workspace or set a default workspace in hereya.yaml');
+        }
+        const { project } = config;
+        const packageName = args.package;
+        const packageCanonicalName = getPackageCanonicalName(packageName);
+        const logicalId = getProvisioningLogicalId({ pkg: packageName, project, workspace });
+        const backend = await getBackend();
+        const provisioningIdResult = await backend.getProvisioningId({
+            logicalId,
+            packageCanonicalName,
+            project,
+            workspace,
+        });
+        if (!provisioningIdResult.success) {
+            this.error(provisioningIdResult.reason);
+        }
+        // Get version from config (packages, deploy, or onDeploy sections)
+        const version = this.findPackageVersion(config, packageName);
+        const packagePath = await getPackageDownloadPath({ id: provisioningIdResult.id, version });
+        this.log(`Package: ${packageName}`);
+        this.log(`Workspace: ${workspace}`);
+        this.log(`Project: ${project}`);
+        this.log(`Logical ID: ${logicalId}`);
+        this.log(`Provisioning ID: ${provisioningIdResult.id}`);
+        // Check if the package path exists locally
+        const pathExists = await fs.stat(packagePath).then(() => true).catch(() => false);
+        if (pathExists) {
+            this.log(`Package Path: ${packagePath}`);
+        }
+        else {
+            this.log(`Package Path: not found locally (provisioning may not have happened yet or occurred on a different computer)`);
+        }
+    }
+    findPackageVersion(config, packageName) {
+        // Check direct packages entry
+        if (config.packages?.[packageName]?.version) {
+            return config.packages[packageName].version;
+        }
+        // Check direct deploy entry
+        if (config.deploy?.[packageName]?.version) {
+            return config.deploy[packageName].version;
+        }
+        // Check onDeploy sections in packages
+        for (const pkg of Object.values(config.packages ?? {})) {
+            if (pkg.onDeploy?.pkg === packageName && pkg.onDeploy?.version) {
+                return pkg.onDeploy.version;
+            }
+        }
+        // Check onDeploy sections in deploy
+        for (const pkg of Object.values(config.deploy ?? {})) {
+            if (pkg.onDeploy?.pkg === packageName && pkg.onDeploy?.version) {
+                return pkg.onDeploy.version;
+            }
+        }
+        return undefined;
+    }
+}

package/dist/iac/common.d.ts

@@ -17,9 +17,10 @@ export type ApplyInput = {
     };
     id: string;
     infraConfig?: {
-        terraformStateBucketName: string;
+        localStatePath?: string;
+        terraformStateBucketName?: string;
         terraformStateBucketRegion?: string;
-        terraformStateLockTableName: string;
+        terraformStateLockTableName?: string;
     };
     logger?: Logger;
     parameters?: {
@@ -40,10 +41,11 @@ export type DestroyInput = ApplyInput;
 export type DestroyOutput = ApplyOutput;
 export type GetStateLocationInput = {
     id: string;
-    infraConfig: {
-        terraformStateBucketName: string;
+    infraConfig?: {
+        localStatePath?: string;
+        terraformStateBucketName?: string;
         terraformStateBucketRegion?: string;
-        terraformStateLockTableName: string;
+        terraformStateLockTableName?: string;
     };
 };
 export type GetStateLocationOutput = {
@@ -51,6 +53,9 @@ export type GetStateLocationOutput = {
     key: string;
     region: string;
     success: true;
+} | {
+    localPath: string;
+    success: true;
 } | {
     reason: string;
     success: false;

package/dist/iac/terraform.js

@@ -8,10 +8,24 @@ import { mapObject } from '../lib/object-utils.js';
 import { runShell } from '../lib/shell.js';
 export class Terraform {
     async apply(input) {
-        if (input.infraConfig &&
+        if (input.infraConfig?.localStatePath) {
+            // Local backend
+            await fs.promises.mkdir(input.infraConfig.localStatePath, { recursive: true });
+            const backendConfig = `
+      terraform {
+            backend "local" {
+                path = "${path.join(input.infraConfig.localStatePath, 'terraform.tfstate')}"
+            }
+      }
+      `;
+            const backendFile = path.join(input.pkgPath, 'hereya_terraform_backend.tf');
+            await fs.promises.writeFile(backendFile, backendConfig);
+        }
+        else if (input.infraConfig &&
             input.infraConfig.terraformStateBucketName &&
             input.infraConfig.terraformStateLockTableName &&
             input.infraConfig.terraformStateBucketRegion) {
+            // S3 backend
             const backendConfig = `
       terraform {
             backend "s3" {
@@ -72,6 +86,38 @@ export class Terraform {
     }
     async destroy(input) {
         const terraform = await this.getTerraformBinary(input.logger);
+        // Write backend configuration
+        if (input.infraConfig?.localStatePath) {
+            // Local backend
+            await fs.promises.mkdir(input.infraConfig.localStatePath, { recursive: true });
+            const backendConfig = `
+      terraform {
+            backend "local" {
+                path = "${path.join(input.infraConfig.localStatePath, 'terraform.tfstate')}"
+            }
+      }
+      `;
+            const backendFile = path.join(input.pkgPath, 'hereya_terraform_backend.tf');
+            await fs.promises.writeFile(backendFile, backendConfig);
+        }
+        else if (input.infraConfig &&
+            input.infraConfig.terraformStateBucketName &&
+            input.infraConfig.terraformStateLockTableName &&
+            input.infraConfig.terraformStateBucketRegion) {
+            // S3 backend
+            const backendConfig = `
+      terraform {
+            backend "s3" {
+                bucket = "${input.infraConfig.terraformStateBucketName}"
+                key = "${input.id}/terraform.tfstate"
+                region = "${input.infraConfig.terraformStateBucketRegion}"
+                dynamodb_table = "${input.infraConfig.terraformStateLockTableName}"
+            }
+      }
+      `;
+            const backendFile = path.join(input.pkgPath, 'hereya_terraform_backend.tf');
+            await fs.promises.writeFile(backendFile, backendConfig);
+        }
         try {
             await runShell(terraform, ['init'], {
                 directory: input.pkgPath,
@@ -177,11 +223,23 @@ export class Terraform {
         return true;
     }
     async getStateLocation(input) {
+        if (input.infraConfig?.localStatePath) {
+            return {
+                localPath: path.join(input.infraConfig.localStatePath, 'terraform.tfstate'),
+                success: true,
+            };
+        }
+        if (input.infraConfig?.terraformStateBucketName) {
+            return {
+                bucket: input.infraConfig.terraformStateBucketName,
+                key: `${input.id}/terraform.tfstate`,
+                region: input.infraConfig.terraformStateBucketRegion ?? '',
+                success: true,
+            };
+        }
         return {
-            bucket: input.infraConfig.terraformStateBucketName,
-            key: `${input.id}/terraform.tfstate`,
-            region: input.infraConfig.terraformStateBucketRegion ?? '',
-            success: true,
+            reason: 'No state location configuration provided',
+            success: false,
         };
     }
     async getEnv(pkgPath, logger) {

package/dist/infrastructure/aws.js

@@ -248,6 +248,9 @@ export class AwsInfrastructure {
         if (!stateLocation$.success) {
             return { reason: stateLocation$.reason, success: false };
         }
+        if (!('bucket' in stateLocation$)) {
+            return { reason: 'Expected S3 state location for AWS infrastructure', success: false };
+        }
         const { bucket, key } = stateLocation$;
         const s3Client = new S3Client({});
         await s3Client.send(new PutObjectCommand({

package/dist/infrastructure/local.js

@@ -1,4 +1,6 @@
 import * as fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
 import { getIac } from '../iac/index.js';
 import { downloadPackage } from '../lib/package/index.js';
 import { getPackageDownloadPath, } from './common.js';
@@ -25,6 +27,9 @@ export class LocalInfrastructure {
         const output = await iac.destroy({
             env: input.env ?? {},
             id: input.id,
+            infraConfig: {
+                localStatePath: path.join(os.homedir(), '.hereya', 'tf', 'states', input.id),
+            },
             logger: input.logger,
             parameters: input.parameters,
             pkgPath: downloadPath,
@@ -47,6 +52,9 @@ export class LocalInfrastructure {
         const output = await iac.apply({
             env: input.env ?? {},
             id: input.id,
+            infraConfig: {
+                localStatePath: path.join(os.homedir(), '.hereya', 'tf', 'states', input.id),
+            },
             logger: input.logger,
             parameters: input.parameters,
             pkgPath: downloadPath,

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": {
@@ -564,27 +564,44 @@
         "index.js"
       ]
     },
-    "publish": {
+    "provid": {
       "aliases": [],
-      "args": {},
-      "description": "Publish a package to the Hereya registry",
+      "args": {
+        "package": {
+          "description": "Package name (e.g., hereya/postgres)",
+          "name": "package",
+          "required": true
+        }
+      },
+      "description": "Display the provisioning ID for a package",
       "examples": [
-        "$ hereya publish",
-        "$ hereya publish --chdir=/path/to/package"
+        "<%= config.bin %> <%= command.id %> hereya/postgres",
+        "<%= config.bin %> <%= command.id %> hereya/postgres -w dev",
+        "<%= config.bin %> <%= command.id %> hereya/postgres --workspace staging"
       ],
       "flags": {
         "chdir": {
-          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n      ",
+          "char": "C",
+          "description": "Project root directory",
           "name": "chdir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "Name of the workspace",
+          "name": "workspace",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "publish",
+      "id": "provid",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -594,7 +611,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "publish",
+        "provid",
         "index.js"
       ]
     },
@@ -652,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": {
@@ -968,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",
@@ -995,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",
@@ -1027,7 +1078,7 @@
         "dist",
         "commands",
         "config",
-        "use-backend",
+        "import-backend",
         "index.js"
       ]
     },
@@ -1295,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": {
@@ -1936,5 +2045,5 @@
       ]
     }
   },
-  "version": "0.60.1"
+  "version": "0.62.0"
 }

package/package.json

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