hereya-cli 0.87.0 → 0.89.0

package/oclif.manifest.json

@@ -241,14 +241,6 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "workspace": {
           "char": "w",
           "description": "name of the workspace to deploy the packages for",
@@ -455,28 +447,58 @@
         "index.js"
       ]
     },
-    "git": {
+    "import": {
       "aliases": [],
-      "args": {},
-      "description": "Run an arbitrary git command with the hereya credential helper available. Wraps `git <args...>`, propagating an ephemeral `--token` to the credential-helper grandchild via `HEREYA_EPHEMERAL_TOKEN`. After a successful `clone`, also wires the cloned repo to use the hereya credential helper for future `push`/`pull`/`fetch` operations. Use `--` to separate hereya flags from git flags so e.g. `--depth` reaches git instead of being parsed by oclif.",
+      "args": {
+        "package": {
+          "description": "\n        The package to import, specified as a GitHub repository in the format owner/repository.\n        To change the registry URL, set the HEREYA_REGISTRY_URL environment variable, so that it points to $HEREYA_REGISTRY_URL/owner/repository.\n        For local packages, use the format local/path/to/package where path/to/package is the path to the package on your local machine.\n      ",
+          "name": "package",
+          "required": true
+        }
+      },
+      "description": "Import a package resource into your project",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --token <token> -- push",
-        "<%= config.bin %> <%= command.id %> --token <token> -- pull --rebase",
-        "<%= config.bin %> <%= command.id %> --token <token> -- clone https://github.com/owner/repo my-dir",
-        "<%= config.bin %> <%= command.id %> -- log --oneline -10"
+        "<%= config.bin %> <%= command.id %> hereya/my-package -f state.tfstate",
+        "<%= config.bin %> <%= command.id %> org/my-package -f state.tfstate -w my-workspace"
       ],
       "flags": {
         "chdir": {
-          "description": "directory to run git in (cwd of the spawned git process)",
+          "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"
         },
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Propagated to the git credential-helper grandchild via the HEREYA_EPHEMERAL_TOKEN env var. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "parameter": {
+          "char": "p",
+          "description": "parameters for the package, in the form of 'key=value'. Can be specified multiple times.",
+          "name": "parameter",
+          "required": false,
+          "default": [],
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "stateFile": {
+          "char": "f",
+          "description": "state file to use",
+          "name": "stateFile",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "workspace to import into",
+          "name": "workspace",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -485,63 +507,54 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "git",
+      "id": "import",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "git",
+        "import",
         "index.js"
       ]
     },
-    "import": {
+    "import-repo": {
       "aliases": [],
       "args": {
-        "package": {
-          "description": "\n        The package to import, specified as a GitHub repository in the format owner/repository.\n        To change the registry URL, set the HEREYA_REGISTRY_URL environment variable, so that it points to $HEREYA_REGISTRY_URL/owner/repository.\n        For local packages, use the format local/path/to/package where path/to/package is the path to the package on your local machine.\n      ",
-          "name": "package",
+        "project": {
+          "description": "project name",
+          "name": "project",
           "required": true
         }
       },
-      "description": "Import a package resource into your project",
+      "description": "Register an existing GitHub repository as a hereya project so it can be deployed via the remote executor.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> hereya/my-package -f state.tfstate",
-        "<%= config.bin %> <%= command.id %> org/my-package -f state.tfstate -w my-workspace"
+        "<%= config.bin %> <%= command.id %> myProject -w=dev -r=https://github.com/acme/api.git",
+        "<%= config.bin %> <%= command.id %> myProject -w=dev -r=https://github.com/acme/api --clone",
+        "<%= config.bin %> <%= command.id %> myProject -w=dev -r=https://github.com/acme/api --clone --chdir=./api"
       ],
       "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": "directory to clone into (only meaningful with --clone)",
           "name": "chdir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
+        "clone": {
+          "description": "also clone the repository locally and write hereya.yaml after the import",
+          "name": "clone",
           "allowNo": false,
           "type": "boolean"
         },
-        "parameter": {
-          "char": "p",
-          "description": "parameters for the package, in the form of 'key=value'. Can be specified multiple times.",
-          "name": "parameter",
-          "required": false,
-          "default": [],
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "stateFile": {
-          "char": "f",
-          "description": "state file to use",
-          "name": "stateFile",
+        "repo-url": {
+          "char": "r",
+          "description": "GitHub HTTPS clone URL (e.g. https://github.com/owner/repo.git)",
+          "name": "repo-url",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -549,9 +562,9 @@
         },
         "workspace": {
           "char": "w",
-          "description": "workspace to import into",
+          "description": "workspace to set as default",
           "name": "workspace",
-          "required": false,
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -559,7 +572,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "import",
+      "id": "import-repo",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -569,7 +582,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "import",
+        "import-repo",
         "index.js"
       ]
     },
@@ -625,14 +638,6 @@
           "multiple": false,
           "type": "option"
         },
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "workspace": {
           "char": "w",
           "description": "workspace to set as default",
@@ -818,14 +823,6 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -921,14 +918,6 @@
           "multiple": false,
           "type": "option"
         },
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "workspace": {
           "char": "w",
           "description": "name of the workspace to run the command in",
@@ -996,14 +985,6 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -1089,14 +1070,6 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "workspace": {
           "char": "w",
           "description": "name of the workspace to undeploy the packages for",
@@ -1123,57 +1096,43 @@
         "index.js"
       ]
     },
-    "up": {
+    "uninit": {
       "aliases": [],
-      "args": {},
-      "description": "Provision all packages in the project.",
+      "args": {
+        "project": {
+          "description": "project name",
+          "name": "project",
+          "required": true
+        }
+      },
+      "description": "Destroy template infrastructure and uninitialize a project.",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %> myProject -w dev",
+        "<%= config.bin %> <%= command.id %> myProject -w dev -p prodWorkspace=prod"
       ],
       "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": "directory to run command in",
           "name": "chdir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "deploy": {
-          "description": "provision deployment companion packages",
-          "name": "deploy",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "select": {
-          "char": "s",
-          "description": "select the packages to provision",
-          "name": "select",
+        "parameter": {
+          "char": "p",
+          "description": "parameter for the template, in the form of 'key=value'. Overrides saved parameters.",
+          "name": "parameter",
           "default": [],
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to install the packages for",
+          "description": "workspace used during init",
           "name": "workspace",
-          "required": false,
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1181,7 +1140,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "up",
+      "id": "uninit",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -1191,37 +1150,43 @@
       "relativePath": [
         "dist",
         "commands",
-        "up",
+        "uninit",
         "index.js"
       ]
     },
-    "uninit": {
+    "up": {
       "aliases": [],
-      "args": {
-        "project": {
-          "description": "project name",
-          "name": "project",
-          "required": true
-        }
-      },
-      "description": "Destroy template infrastructure and uninitialize a project.",
+      "args": {},
+      "description": "Provision all packages in the project.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> myProject -w dev",
-        "<%= config.bin %> <%= command.id %> myProject -w dev -p prodWorkspace=prod"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "chdir": {
-          "description": "directory to run command in",
+          "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"
         },
-        "parameter": {
-          "char": "p",
-          "description": "parameter for the template, in the form of 'key=value'. Overrides saved parameters.",
-          "name": "parameter",
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "deploy": {
+          "description": "provision deployment companion packages",
+          "name": "deploy",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "select": {
+          "char": "s",
+          "description": "select the packages to provision",
+          "name": "select",
           "default": [],
           "hasDynamicHelp": false,
           "multiple": true,
@@ -1229,9 +1194,9 @@
         },
         "workspace": {
           "char": "w",
-          "description": "workspace used during init",
+          "description": "name of the workspace to install the packages for",
           "name": "workspace",
-          "required": true,
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1239,7 +1204,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "uninit",
+      "id": "up",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -1249,7 +1214,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "uninit",
+        "up",
         "index.js"
       ]
     },
@@ -1324,14 +1289,6 @@
           "multiple": true,
           "type": "option"
         },
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "version": {
           "description": "specific app version to deploy (defaults to latest)",
           "name": "version",
@@ -1379,16 +1336,7 @@
       "examples": [
         "<%= config.bin %> <%= command.id %> my-org/my-app"
       ],
-      "flags": {
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
       "id": "app:deployments",
@@ -1443,14 +1391,6 @@
           "multiple": true,
           "type": "option"
         },
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "workspace": {
           "char": "w",
           "description": "workspace where the app is currently deployed",
@@ -1498,14 +1438,6 @@
         "<%= config.bin %> <%= command.id %> my-org/my-app -w my-workspace DATABASE_URL"
       ],
       "flags": {
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "workspace": {
           "char": "w",
           "description": "workspace to read env outputs from",
@@ -1540,16 +1472,7 @@
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
-      "flags": {
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
       "id": "app:list",
@@ -1631,14 +1554,6 @@
         "<%= config.bin %> <%= command.id %> my-org/my-app -w my-workspace"
       ],
       "flags": {
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "workspace": {
           "char": "w",
           "description": "workspace to read deployment status from",
@@ -3198,35 +3113,26 @@
         "index.js"
       ]
     },
-    "workspace:executor:install": {
+    "workspace:env:unset": {
       "aliases": [],
       "args": {},
-      "description": "Install a remote executor into a workspace",
+      "description": "unset an env var for a workspace",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -w my-workspace -n myVar"
+      ],
       "flags": {
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "force": {
-          "char": "f",
-          "description": "force reinstall even if executor is already installed",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
+        "name": {
+          "char": "n",
+          "description": "name of the env var to unset",
+          "name": "name",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace",
+          "description": "name of the workspace to unset an env var for",
           "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
@@ -3236,7 +3142,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:executor:install",
+      "id": "workspace:env:unset",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -3247,31 +3153,32 @@
         "dist",
         "commands",
         "workspace",
-        "executor",
-        "install",
+        "env",
+        "unset",
         "index.js"
       ]
     },
-    "workspace:env:unset": {
+    "workspace:executor:install": {
       "aliases": [],
       "args": {},
-      "description": "unset an env var for a workspace",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> -w my-workspace -n myVar"
-      ],
+      "description": "Install a remote executor into a workspace",
       "flags": {
-        "name": {
-          "char": "n",
-          "description": "name of the env var to unset",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "char": "f",
+          "description": "force reinstall even if executor is already installed",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
         },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to unset an env var for",
+          "description": "name of the workspace",
           "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
@@ -3281,7 +3188,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:env:unset",
+      "id": "workspace:executor:install",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -3292,8 +3199,8 @@
         "dist",
         "commands",
         "workspace",
-        "env",
-        "unset",
+        "executor",
+        "install",
         "index.js"
       ]
     },
@@ -3302,14 +3209,6 @@
       "args": {},
       "description": "Generate a workspace-scoped executor token for the remote executor",
       "flags": {
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "workspace": {
           "char": "w",
           "description": "name of the workspace",
@@ -3349,14 +3248,6 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "token": {
-          "description": "Ephemeral cloud access token used for this invocation only. Held in memory; never written to the keychain or `~/.hereya/secrets/`. Takes precedence over the HEREYA_TOKEN environment variable.",
-          "name": "token",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "workspace": {
           "char": "w",
           "description": "name of the workspace",
@@ -3386,5 +3277,5 @@
       ]
     }
   },
-  "version": "0.87.0"
+  "version": "0.89.0"
 }