hereya-cli 0.51.0 → 0.52.0

package/dist/commands/remove/index.js

@@ -8,6 +8,7 @@ import { getLogger, getLogPath, isDebug, setDebug } from '../../lib/log.js';
 import { getParameterManager } from '../../lib/parameter/index.js';
 import { getProfileFromWorkspace } from '../../lib/profile-utils.js';
 import { delay } from '../../lib/shell.js';
+import { validateDevelopmentWorkspace } from '../../lib/workspace-validation.js';
 export default class Remove extends Command {
     static args = {
         package: Args.string({
@@ -60,6 +61,12 @@ export default class Remove extends Command {
                                 ctx.configOutput = loadConfigOutput;
                                 // Use workspace from flag if provided, otherwise use config workspace
                                 ctx.workspace = flags.workspace || loadConfigOutput.config.workspace;
+                                // Validate that the workspace is a development workspace
+                                const backend = await getBackend();
+                                const validation = await validateDevelopmentWorkspace(ctx.workspace, backend, 'remove');
+                                if (!validation.isValid) {
+                                    throw new Error(validation.message);
+                                }
                                 const { config } = loadConfigOutput;
                                 if (!(ctx.package in (config.packages ?? {})) && !(ctx.package in (config.deploy ?? {}))) {
                                     throw new Error(`Package ${ctx.package} not found in the project.`);

package/dist/commands/run/index.js

@@ -4,6 +4,7 @@ import { getConfigManager } from '../../lib/config/index.js';
 import { getEnvManager } from '../../lib/env/index.js';
 import { getProfileFromWorkspace } from '../../lib/profile-utils.js';
 import { runShell } from '../../lib/shell.js';
+import { validateDevelopmentWorkspace } from '../../lib/workspace-validation.js';
 export default class Run extends Command {
     static args = {
         cmd: Args.string({ description: 'command to run', required: true }),
@@ -43,6 +44,11 @@ export default class Run extends Command {
             this.error('you must specify a workspace to run the command in');
         }
         const backend = await getBackend();
+        // Validate that the workspace is a development workspace
+        const validation = await validateDevelopmentWorkspace(workspace, backend, 'run');
+        if (!validation.isValid) {
+            this.error(validation.message);
+        }
         const profile = await getProfileFromWorkspace(backend, workspace, config.project);
         const envManager = getEnvManager();
         const getProjectEnvOutput = await envManager.getProjectEnv({

package/dist/commands/undeploy/index.js

@@ -9,6 +9,7 @@ import { getLogger, getLogPath, isDebug, setDebug } from '../../lib/log.js';
 import { getParameterManager } from '../../lib/parameter/index.js';
 import { getProfileFromWorkspace } from '../../lib/profile-utils.js';
 import { delay } from '../../lib/shell.js';
+import { validateDeploymentWorkspace } from '../../lib/workspace-validation.js';
 export default class Undeploy extends Command {
     static description = 'Undeploy a hereya project by removing all resources.';
     static examples = ['<%= config.bin %> <%= command.id %>'];
@@ -35,6 +36,12 @@ export default class Undeploy extends Command {
         const { flags } = await this.parse(Undeploy);
         setDebug(flags.debug);
         const projectRootDir = path.resolve(flags.chdir || process.env.HEREYA_PROJECT_ROOT_DIR || process.cwd());
+        // Validate that the workspace is a deployment workspace
+        const backend = await getBackend();
+        const validation = await validateDeploymentWorkspace(flags.workspace, backend, 'undeploy');
+        if (!validation.isValid) {
+            this.error(validation.message);
+        }
         const myLogger = new ListrLogger({ useIcons: false });
         const task = new Listr([
             {

package/dist/commands/up/index.js

@@ -8,6 +8,7 @@ import { getLogger, getLogPath, isDebug, setDebug } from '../../lib/log.js';
 import { getParameterManager } from '../../lib/parameter/index.js';
 import { getProfileFromWorkspace } from '../../lib/profile-utils.js';
 import { delay } from '../../lib/shell.js';
+import { validateDevelopmentWorkspace } from '../../lib/workspace-validation.js';
 export default class Up extends Command {
     static description = 'Provision all packages in the project.';
     static examples = ['<%= config.bin %> <%= command.id %>'];
@@ -58,6 +59,12 @@ export default class Up extends Command {
                                 }
                                 ctx.configOutput = loadConfigOutput;
                                 ctx.workspace = flags.workspace || loadConfigOutput.config.workspace;
+                                // Validate that the workspace is a development workspace
+                                const backend = await getBackend();
+                                const validation = await validateDevelopmentWorkspace(ctx.workspace, backend, 'up');
+                                if (!validation.isValid) {
+                                    throw new Error(validation.message);
+                                }
                                 await delay(500);
                             },
                             title: 'Loading project config',

package/dist/commands/workspace/create/index.d.ts

@@ -6,6 +6,7 @@ export default class WorkspaceCreate extends Command {
     static description: string;
     static examples: string[];
     static flags: {
+        deployment: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         mirror: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };

package/dist/commands/workspace/create/index.js

@@ -7,6 +7,7 @@ export default class WorkspaceCreate extends Command {
     static description = 'Create a new workspace if it does not exist.';
     static examples = ['<%= config.bin %> <%= command.id %> dev'];
     static flags = {
+        deployment: Flags.boolean({ char: 'd', description: 'mark workspace as a deployment workspace', required: false }),
         mirror: Flags.string({ description: 'workspace to mirror', required: false }),
         profile: Flags.string({ description: 'workspace profile to set (cloud backend only)', required: false }),
     };
@@ -14,6 +15,7 @@ export default class WorkspaceCreate extends Command {
         const { args, flags } = await this.parse(WorkspaceCreate);
         const backend = await getBackend();
         const createWorkspaceOutput = await backend.createWorkspace({
+            isDeploy: flags.deployment,
             mirrorOf: flags.mirror,
             name: args.name,
             profile: flags.profile,

package/dist/commands/workspace/list/index.js

@@ -19,12 +19,14 @@ export default class WorkspaceList extends Command {
                     const result = await backend.getWorkspace(name);
                     if (result.found && !result.hasError) {
                         return {
+                            deployment: result.workspace.isDeploy ? 'Yes' : 'No',
                             mirrorOf: result.workspace.mirrorOf || '-',
                             name,
                             profile: result.workspace.profile || '-',
                         };
                     }
                     return {
+                        deployment: 'No',
                         mirrorOf: '-',
                         name,
                         profile: '-',
@@ -32,6 +34,7 @@ export default class WorkspaceList extends Command {
                 }
                 catch {
                     return {
+                        deployment: 'No',
                         mirrorOf: '-',
                         name,
                         profile: '-',
@@ -41,13 +44,14 @@ export default class WorkspaceList extends Command {
             // Calculate column widths for alignment
             const nameWidth = Math.max(4, ...workspaceDetails.map(w => w.name.length)); // min 4 for "Name"
             const profileWidth = Math.max(7, ...workspaceDetails.map(w => w.profile.length)); // min 7 for "Profile"
+            const deploymentWidth = Math.max(10, ...workspaceDetails.map(w => w.deployment.length)); // min 10 for "Deployment"
             const mirrorWidth = Math.max(9, ...workspaceDetails.map(w => w.mirrorOf.length)); // min 9 for "Mirror Of"
             // Display header
-            this.log(`${'Name'.padEnd(nameWidth)}  ${'Profile'.padEnd(profileWidth)}  ${'Mirror Of'.padEnd(mirrorWidth)}`);
-            this.log('-'.repeat(nameWidth + profileWidth + mirrorWidth + 4));
+            this.log(`${'Name'.padEnd(nameWidth)}  ${'Profile'.padEnd(profileWidth)}  ${'Deployment'.padEnd(deploymentWidth)}  ${'Mirror Of'.padEnd(mirrorWidth)}`);
+            this.log('-'.repeat(nameWidth + profileWidth + deploymentWidth + mirrorWidth + 6));
             // Display rows
             for (const workspace of workspaceDetails) {
-                this.log(`${workspace.name.padEnd(nameWidth)}  ${workspace.profile.padEnd(profileWidth)}  ${workspace.mirrorOf.padEnd(mirrorWidth)}`);
+                this.log(`${workspace.name.padEnd(nameWidth)}  ${workspace.profile.padEnd(profileWidth)}  ${workspace.deployment.padEnd(deploymentWidth)}  ${workspace.mirrorOf.padEnd(mirrorWidth)}`);
             }
         }
         catch (error) {

package/dist/commands/workspace/set-profile/index.d.ts

@@ -6,6 +6,7 @@ export default class WorkspaceSetProfile extends Command {
     static description: string;
     static examples: string[];
     static flags: {
+        deployment: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         workspace: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;

package/dist/commands/workspace/set-profile/index.js

@@ -4,21 +4,38 @@ export default class WorkspaceSetProfile extends Command {
     static args = {
         profile: Args.string({ description: 'AWS profile name to set for the workspace', required: true }),
     };
-    static description = 'Set AWS profile for a workspace (cloud backend only).';
+    static description = 'Set AWS profile and deployment status for a workspace (cloud backend only).';
     static examples = ['<%= config.bin %> <%= command.id %> prod-profile -w production'];
     static flags = {
+        deployment: Flags.boolean({
+            allowNo: true,
+            char: 'd',
+            description: 'mark workspace as a deployment workspace (use --no-deployment to unset)',
+            required: false,
+        }),
         workspace: Flags.string({ char: 'w', description: 'workspace name', required: true }),
     };
     async run() {
         const { args, flags } = await this.parse(WorkspaceSetProfile);
         const backend = await getBackend();
         const updateResult = await backend.updateWorkspace({
+            isDeploy: flags.deployment,
             name: flags.workspace,
             profile: args.profile,
         });
         if (!updateResult.success) {
-            this.error(`Failed to set profile: ${updateResult.reason}`);
+            this.error(`Failed to update workspace: ${updateResult.reason}`);
         }
-        this.log(`Profile '${args.profile}' set for workspace '${flags.workspace}' successfully!`);
+        const messages = [];
+        messages.push(`Profile '${args.profile}' set for workspace '${flags.workspace}'`);
+        if (flags.deployment !== undefined) {
+            if (flags.deployment) {
+                messages.push(`Workspace marked as deployment workspace`);
+            }
+            else {
+                messages.push(`Workspace unmarked as deployment workspace`);
+            }
+        }
+        this.log(messages.join('. ') + '!');
     }
 }

package/dist/lib/workspace-validation.d.ts

@@ -0,0 +1,17 @@
+import { Backend } from '../backend/common.js';
+export interface WorkspaceValidationResult {
+    isValid: boolean;
+    message?: string;
+}
+/**
+ * Validates that a workspace exists and is marked as a deployment workspace (isDeploy=true)
+ */
+export declare function validateDeploymentWorkspace(workspaceName: string, backend: Backend, commandName: string): Promise<WorkspaceValidationResult>;
+/**
+ * Validates that a workspace exists and is NOT marked as a deployment workspace (isDeploy=false or undefined)
+ */
+export declare function validateDevelopmentWorkspace(workspaceName: string, backend: Backend, commandName: string): Promise<WorkspaceValidationResult>;
+/**
+ * Validates that flow commands are not used with deployment workspaces
+ */
+export declare function validateFlowCommand(workspaceName: string | undefined, backend: Backend): Promise<WorkspaceValidationResult>;

package/dist/lib/workspace-validation.js

@@ -0,0 +1,102 @@
+/**
+ * Validates that a workspace exists and is marked as a deployment workspace (isDeploy=true)
+ */
+export async function validateDeploymentWorkspace(workspaceName, backend, commandName) {
+    const result = await backend.getWorkspace(workspaceName);
+    if (!result.found) {
+        return {
+            isValid: false,
+            message: `Workspace '${workspaceName}' not found. Create a deployment workspace with:\n$ hereya workspace:create ${workspaceName} --deployment`,
+        };
+    }
+    if (result.hasError) {
+        return {
+            isValid: false,
+            message: `Error accessing workspace '${workspaceName}': ${result.error}`,
+        };
+    }
+    const { workspace } = result;
+    if (!workspace.isDeploy) {
+        return {
+            isValid: false,
+            message: `Cannot use '${commandName}' with development workspace '${workspaceName}'.
+
+The '${commandName}' command requires a deployment workspace. You have two options:
+
+1. Create a deployment workspace:
+   $ hereya workspace:create prod-deployment --deployment
+
+2. Convert existing workspace to deployment (if using cloud backend):
+   $ hereya workspace:set-profile ${workspaceName} --deployment
+
+Then run: $ hereya ${commandName} -w prod-deployment`,
+        };
+    }
+    return { isValid: true };
+}
+/**
+ * Validates that a workspace exists and is NOT marked as a deployment workspace (isDeploy=false or undefined)
+ */
+export async function validateDevelopmentWorkspace(workspaceName, backend, commandName) {
+    const result = await backend.getWorkspace(workspaceName);
+    if (!result.found) {
+        return {
+            isValid: false,
+            message: `Workspace '${workspaceName}' not found. Create a workspace with:\n$ hereya workspace:create ${workspaceName}`,
+        };
+    }
+    if (result.hasError) {
+        return {
+            isValid: false,
+            message: `Error accessing workspace '${workspaceName}': ${result.error}`,
+        };
+    }
+    const { workspace } = result;
+    if (workspace.isDeploy === true) {
+        return {
+            isValid: false,
+            message: `Cannot use '${commandName}' with deployment workspace '${workspaceName}'.
+
+The '${commandName}' command is for development workspaces only. Deployment workspaces 
+should only be managed through 'deploy' and 'undeploy' commands.
+
+To work with packages in development:
+1. Use a development workspace: $ hereya ${commandName} <args> -w dev-workspace
+2. Or create a new one: $ hereya workspace:create dev-workspace`,
+        };
+    }
+    return { isValid: true };
+}
+/**
+ * Validates that flow commands are not used with deployment workspaces
+ */
+export async function validateFlowCommand(workspaceName, backend) {
+    if (!workspaceName) {
+        // If no workspace specified, flow commands will create their own
+        return { isValid: true };
+    }
+    const result = await backend.getWorkspace(workspaceName);
+    if (!result.found) {
+        // Workspace doesn't exist, flow command will create it
+        return { isValid: true };
+    }
+    if (result.hasError) {
+        return {
+            isValid: false,
+            message: `Error accessing workspace '${workspaceName}': ${result.error}`,
+        };
+    }
+    const { workspace } = result;
+    if (workspace.isDeploy === true) {
+        return {
+            isValid: false,
+            message: `Flow commands cannot be used with deployment workspaces.
+
+Flow commands are designed for feature branch development workflows.
+For deployment workspaces, use the standard 'deploy' and 'undeploy' commands.
+
+Current workspace '${workspaceName}' is marked as a deployment workspace.`,
+        };
+    }
+    return { isValid: true };
+}

package/oclif.manifest.json

@@ -1,5 +1,44 @@
 {
   "commands": {
+    "bootstrap": {
+      "aliases": [],
+      "args": {
+        "infrastructureType": {
+          "description": "infrastructure to bootstrap. Options are local, aws",
+          "name": "infrastructureType",
+          "required": true
+        }
+      },
+      "description": "Install necessary resources for hereya operations in an infrastructure.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> aws",
+        "<%= config.bin %> <%= command.id %> local"
+      ],
+      "flags": {
+        "force": {
+          "char": "f",
+          "description": "redeploy hereya resources if already deployed",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "bootstrap",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "bootstrap",
+        "index.js"
+      ]
+    },
     "add": {
       "aliases": [],
       "args": {
@@ -63,45 +102,6 @@
         "index.js"
       ]
     },
-    "bootstrap": {
-      "aliases": [],
-      "args": {
-        "infrastructureType": {
-          "description": "infrastructure to bootstrap. Options are local, aws",
-          "name": "infrastructureType",
-          "required": true
-        }
-      },
-      "description": "Install necessary resources for hereya operations in an infrastructure.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> aws",
-        "<%= config.bin %> <%= command.id %> local"
-      ],
-      "flags": {
-        "force": {
-          "char": "f",
-          "description": "redeploy hereya resources if already deployed",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "bootstrap",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "bootstrap",
-        "index.js"
-      ]
-    },
     "delete-state": {
       "aliases": [],
       "args": {},
@@ -193,47 +193,42 @@
         "index.js"
       ]
     },
-    "down": {
+    "env": {
       "aliases": [],
-      "args": {},
-      "description": "Destroy all packages in the project.",
+      "args": {
+        "name": {
+          "description": "name of the env to display",
+          "name": "name",
+          "required": false
+        }
+      },
+      "description": "Print project environment variables.",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> myEnv",
+        "<%= config.bin %> <%= command.id %> -w dev",
+        "<%= config.bin %> <%= command.id %> -w dev -l"
       ],
       "flags": {
         "chdir": {
-          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n        Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment variable.\n      ",
+          "description": "project root directory",
           "name": "chdir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "deploy": {
-          "description": "destroy deployment companion packages",
-          "name": "deploy",
+        "list": {
+          "char": "l",
+          "description": "list only the env vars without values",
+          "name": "list",
           "required": false,
           "allowNo": false,
           "type": "boolean"
         },
-        "select": {
-          "char": "s",
-          "description": "select the packages to destroy",
-          "name": "select",
-          "default": [],
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to destroy the packages for",
+          "description": "name of the workspace to print the env vars for",
           "name": "workspace",
           "required": false,
           "hasDynamicHelp": false,
@@ -243,7 +238,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "down",
+      "id": "env",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -253,46 +248,51 @@
       "relativePath": [
         "dist",
         "commands",
-        "down",
+        "env",
         "index.js"
       ]
     },
-    "env": {
+    "down": {
       "aliases": [],
-      "args": {
-        "name": {
-          "description": "name of the env to display",
-          "name": "name",
-          "required": false
-        }
-      },
-      "description": "Print project environment variables.",
+      "args": {},
+      "description": "Destroy all packages in the project.",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> myEnv",
-        "<%= config.bin %> <%= command.id %> -w dev",
-        "<%= config.bin %> <%= command.id %> -w dev -l"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "chdir": {
-          "description": "project root directory",
+          "description": "\n        Directory where the command will be executed.\n        If not specified, it defaults to the current working directory.\n        Alternatively, you can define the project root by setting the HEREYA_PROJECT_ROOT_DIR environment variable.\n      ",
           "name": "chdir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "list": {
-          "char": "l",
-          "description": "list only the env vars without values",
-          "name": "list",
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "deploy": {
+          "description": "destroy deployment companion packages",
+          "name": "deploy",
           "required": false,
           "allowNo": false,
           "type": "boolean"
         },
+        "select": {
+          "char": "s",
+          "description": "select the packages to destroy",
+          "name": "select",
+          "default": [],
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to print the env vars for",
+          "description": "name of the workspace to destroy the packages for",
           "name": "workspace",
           "required": false,
           "hasDynamicHelp": false,
@@ -302,7 +302,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "env",
+      "id": "down",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -312,7 +312,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "env",
+        "down",
         "index.js"
       ]
     },
@@ -1345,6 +1345,14 @@
         "<%= config.bin %> <%= command.id %> dev"
       ],
       "flags": {
+        "deployment": {
+          "char": "d",
+          "description": "mark workspace as a deployment workspace",
+          "name": "deployment",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
         "mirror": {
           "description": "workspace to mirror",
           "name": "mirror",
@@ -1558,11 +1566,19 @@
           "required": true
         }
       },
-      "description": "Set AWS profile for a workspace (cloud backend only).",
+      "description": "Set AWS profile and deployment status for a workspace (cloud backend only).",
       "examples": [
         "<%= config.bin %> <%= command.id %> prod-profile -w production"
       ],
       "flags": {
+        "deployment": {
+          "char": "d",
+          "description": "mark workspace as a deployment workspace (use --no-deployment to unset)",
+          "name": "deployment",
+          "required": false,
+          "allowNo": true,
+          "type": "boolean"
+        },
         "workspace": {
           "char": "w",
           "description": "workspace name",
@@ -1770,5 +1786,5 @@
       ]
     }
   },
-  "version": "0.51.0"
+  "version": "0.52.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hereya-cli",
   "description": "Infrastructure as Package",
-  "version": "0.51.0",
+  "version": "0.52.0",
   "author": "Hereya Developers",
   "bin": {
     "hereya": "./bin/run.js"
@@ -52,7 +52,7 @@
     "oclif": "^4.17.27",
     "shx": "^0.3.4",
     "sinon": "^19.0.2",
-    "ts-node": "^10.9.2",
+    "tsx": "^4.20.3",
     "typescript": "^5.7.3"
   },
   "engines": {