@enspirit/emb 0.15.0 → 0.17.0

package/README.md

@@ -14,7 +14,7 @@ $ npm install -g @enspirit/emb
 $ emb COMMAND
 running command...
 $ emb (--version)
-@enspirit/emb/0.15.0 darwin-arm64 node-v22.21.1
+@enspirit/emb/0.17.0 darwin-arm64 node-v22.21.1
 $ emb --help [COMMAND]
 USAGE
   $ emb COMMAND
@@ -26,7 +26,7 @@ USAGE
 * [`emb autocomplete [SHELL]`](#emb-autocomplete-shell)
 * [`emb clean`](#emb-clean)
 * [`emb components`](#emb-components)
-* [`emb components logs COMPONENT`](#emb-components-logs-component)
+* [`emb components logs [COMPONENT]`](#emb-components-logs-component)
 * [`emb components shell COMPONENT`](#emb-components-shell-component)
 * [`emb config print`](#emb-config-print)
 * [`emb containers`](#emb-containers)
@@ -41,12 +41,15 @@ USAGE
 * [`emb kubernetes ps`](#emb-kubernetes-ps)
 * [`emb kubernetes restart [DEPLOYMENT]`](#emb-kubernetes-restart-deployment)
 * [`emb kubernetes shell COMPONENT`](#emb-kubernetes-shell-component)
-* [`emb logs COMPONENT`](#emb-logs-component)
+* [`emb logs [COMPONENT]`](#emb-logs-component)
 * [`emb ps`](#emb-ps)
 * [`emb resources`](#emb-resources)
 * [`emb resources build [COMPONENT]`](#emb-resources-build-component)
 * [`emb restart [COMPONENT]`](#emb-restart-component)
 * [`emb run TASK`](#emb-run-task)
+* [`emb secrets`](#emb-secrets)
+* [`emb secrets providers`](#emb-secrets-providers)
+* [`emb secrets validate`](#emb-secrets-validate)
 * [`emb shell COMPONENT`](#emb-shell-component)
 * [`emb start [COMPONENT]`](#emb-start-component)
 * [`emb stop`](#emb-stop)
@@ -92,9 +95,10 @@ Clean the project.
 
 ```
 USAGE
-  $ emb clean [--json] [--verbose] [-f]
+  $ emb clean [--json] [--verbose] [-C <value>] [-f]
 
 FLAGS
+  -C, --root=<value>  Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -f, --force         Force the deletion of containers & images
   --[no-]verbose
 
@@ -114,10 +118,11 @@ List components.
 
 ```
 USAGE
-  $ emb components [--json] [--verbose] [--flavor <value>]
+  $ emb components [--json] [--verbose] [-C <value>] [--flavor <value>]
 
 FLAGS
-  --flavor=<value>  Specify the flavor to use.
+  -C, --root=<value>    Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
+      --flavor=<value>  Specify the flavor to use.
   --[no-]verbose
 
 GLOBAL FLAGS
@@ -130,18 +135,19 @@ EXAMPLES
   $ emb components
 ```
 
-## `emb components logs COMPONENT`
+## `emb components logs [COMPONENT]`
 
 Get components logs.
 
 ```
 USAGE
-  $ emb components logs COMPONENT [--verbose] [-f]
+  $ emb components logs [COMPONENT...] [--verbose] [-C <value>] [-f]
 
 ARGUMENTS
-  COMPONENT  The component you want to see the logs of
+  [COMPONENT...]  The component(s) you want to see the logs of (all if omitted)
 
 FLAGS
+  -C, --root=<value>  Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -f, --[no-]follow   Follow log output
   --[no-]verbose
 
@@ -153,6 +159,12 @@ ALIASES
 
 EXAMPLES
   $ emb components logs
+
+  $ emb components logs backend
+
+  $ emb components logs backend frontend
+
+  $ emb components logs --no-follow backend
 ```
 
 ## `emb components shell COMPONENT`
@@ -161,12 +173,13 @@ Get a shell on a running component.
 
 ```
 USAGE
-  $ emb components shell COMPONENT [--verbose] [-s <value>]
+  $ emb components shell COMPONENT [--verbose] [-C <value>] [-s <value>]
 
 ARGUMENTS
   COMPONENT  The component you want to get a shell on
 
 FLAGS
+  -C, --root=<value>   Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -s, --shell=<value>  [default: bash] The shell to run
   --[no-]verbose
 
@@ -186,10 +199,11 @@ Print the current config.
 
 ```
 USAGE
-  $ emb config print [--json] [--verbose] [--flavor <value>]
+  $ emb config print [--json] [--verbose] [-C <value>] [--flavor <value>]
 
 FLAGS
-  --flavor=<value>  Specify the flavor to use.
+  -C, --root=<value>    Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
+      --flavor=<value>  Specify the flavor to use.
   --[no-]verbose
 
 GLOBAL FLAGS
@@ -208,9 +222,10 @@ List docker containers.
 
 ```
 USAGE
-  $ emb containers [--json] [--verbose] [-a]
+  $ emb containers [--json] [--verbose] [-C <value>] [-a]
 
 FLAGS
+  -C, --root=<value>  Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -a, --all           Retun all containers. By default, only running containers are shown
   --[no-]verbose
 
@@ -230,9 +245,10 @@ Prune containers.
 
 ```
 USAGE
-  $ emb containers prune [--json] [--verbose]
+  $ emb containers prune [--json] [--verbose] [-C <value>]
 
 FLAGS
+  -C, --root=<value>  Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   --[no-]verbose
 
 GLOBAL FLAGS
@@ -251,10 +267,11 @@ Stop the whole project.
 
 ```
 USAGE
-  $ emb down [--json] [--verbose] [--flavor <value>]
+  $ emb down [--json] [--verbose] [-C <value>] [--flavor <value>]
 
 FLAGS
-  --flavor=<value>  Specify the flavor to use.
+  -C, --root=<value>    Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
+      --flavor=<value>  Specify the flavor to use.
   --[no-]verbose
 
 GLOBAL FLAGS
@@ -293,9 +310,10 @@ List docker images.
 
 ```
 USAGE
-  $ emb images [--json] [--verbose] [--flavor <value>] [-a]
+  $ emb images [--json] [--verbose] [-C <value>] [--flavor <value>] [-a]
 
 FLAGS
+  -C, --root=<value>    Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -a, --all             Show all images. Only images from a final layer (no children) are shown by default.
       --flavor=<value>  Specify the flavor to use.
   --[no-]verbose
@@ -316,9 +334,10 @@ Delete project images.
 
 ```
 USAGE
-  $ emb images delete [--json] [--verbose] [-f]
+  $ emb images delete [--json] [--verbose] [-C <value>] [-f]
 
 FLAGS
+  -C, --root=<value>  Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -f, --force         Remove the image even if it is being used by stopped containers or has other tags
   --[no-]verbose
 
@@ -338,9 +357,10 @@ Prune project images.
 
 ```
 USAGE
-  $ emb images prune [--json] [--verbose] [-a]
+  $ emb images prune [--json] [--verbose] [-C <value>] [-a]
 
 FLAGS
+  -C, --root=<value>  Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -a, --all           Prune all images. When set to true all images will be pruned, not only dangling ones
   --[no-]verbose
 
@@ -360,12 +380,13 @@ Push docker images.
 
 ```
 USAGE
-  $ emb images push [--json] [--verbose] [--flavor <value>] [--registry <value>] [--retag <value>]
+  $ emb images push [--json] [--verbose] [-C <value>] [--flavor <value>] [--registry <value>] [--retag <value>]
 
 FLAGS
-  --flavor=<value>    Specify the flavor to use.
-  --registry=<value>  Override the registry to push to
-  --retag=<value>     Override the original tag to push to a new tag
+  -C, --root=<value>      Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
+      --flavor=<value>    Specify the flavor to use.
+      --registry=<value>  Override the registry to push to
+      --retag=<value>     Override the original tag to push to a new tag
   --[no-]verbose
 
 GLOBAL FLAGS
@@ -386,12 +407,13 @@ Follow kubernetes logs.
 
 ```
 USAGE
-  $ emb kubernetes logs COMPONENT -n <value> [--verbose] [-f]
+  $ emb kubernetes logs COMPONENT -n <value> [--verbose] [-C <value>] [-f]
 
 ARGUMENTS
   COMPONENT  The component you want to see the logs of
 
 FLAGS
+  -C, --root=<value>       Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -f, --[no-]follow        Follow log output
   -n, --namespace=<value>  (required) [env: K8S_NAMESPACE] The Kubernetes namespace to target
   --[no-]verbose
@@ -412,9 +434,10 @@ Show running pods.
 
 ```
 USAGE
-  $ emb kubernetes ps -n <value> [--verbose] [--watch]
+  $ emb kubernetes ps -n <value> [--verbose] [-C <value>] [--watch]
 
 FLAGS
+  -C, --root=<value>       Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -n, --namespace=<value>  (required) [env: K8S_NAMESPACE] The Kubernetes namespace to target
   --[no-]verbose
   --[no-]watch
@@ -432,12 +455,13 @@ Restart pods of an instance.
 
 ```
 USAGE
-  $ emb kubernetes restart [DEPLOYMENT...] -n <value> [--verbose]
+  $ emb kubernetes restart [DEPLOYMENT...] -n <value> [--verbose] [-C <value>]
 
 ARGUMENTS
   [DEPLOYMENT...]  The deployment(s) to restart
 
 FLAGS
+  -C, --root=<value>       Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -n, --namespace=<value>  (required) [env: K8S_NAMESPACE] The Kubernetes namespace to target
   --[no-]verbose
 
@@ -454,12 +478,13 @@ Get a shell on a deployed component.
 
 ```
 USAGE
-  $ emb kubernetes shell COMPONENT -n <value> [--verbose] [-s <value>]
+  $ emb kubernetes shell COMPONENT -n <value> [--verbose] [-C <value>] [-s <value>]
 
 ARGUMENTS
   COMPONENT  The component you want to get a shell on
 
 FLAGS
+  -C, --root=<value>       Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -n, --namespace=<value>  (required) [env: K8S_NAMESPACE] The Kubernetes namespace to target
   -s, --shell=<value>      [default: bash] The shell to run
   --[no-]verbose
@@ -474,18 +499,19 @@ EXAMPLES
   $ emb kubernetes shell
 ```
 
-## `emb logs COMPONENT`
+## `emb logs [COMPONENT]`
 
 Get components logs.
 
 ```
 USAGE
-  $ emb logs COMPONENT [--verbose] [-f]
+  $ emb logs [COMPONENT...] [--verbose] [-C <value>] [-f]
 
 ARGUMENTS
-  COMPONENT  The component you want to see the logs of
+  [COMPONENT...]  The component(s) you want to see the logs of (all if omitted)
 
 FLAGS
+  -C, --root=<value>  Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -f, --[no-]follow   Follow log output
   --[no-]verbose
 
@@ -497,6 +523,12 @@ ALIASES
 
 EXAMPLES
   $ emb logs
+
+  $ emb logs backend
+
+  $ emb logs backend frontend
+
+  $ emb logs --no-follow backend
 ```
 
 ## `emb ps`
@@ -505,9 +537,10 @@ Lists the containers running in the project.
 
 ```
 USAGE
-  $ emb ps [--verbose] [--flavor <value>] [-a]
+  $ emb ps [--verbose] [-C <value>] [--flavor <value>] [-a]
 
 FLAGS
+  -C, --root=<value>    Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -a, --all             Show all stopped containers
       --flavor=<value>  Specify the flavor to use.
   --[no-]verbose
@@ -525,10 +558,11 @@ List resources.
 
 ```
 USAGE
-  $ emb resources [--json] [--verbose] [--flavor <value>]
+  $ emb resources [--json] [--verbose] [-C <value>] [--flavor <value>]
 
 FLAGS
-  --flavor=<value>  Specify the flavor to use.
+  -C, --root=<value>    Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
+      --flavor=<value>  Specify the flavor to use.
   --[no-]verbose
 
 GLOBAL FLAGS
@@ -547,12 +581,13 @@ Build the resources of the monorepo
 
 ```
 USAGE
-  $ emb resources build [COMPONENT...] [--json] [--verbose] [--flavor <value>] [--dry-run] [-f]
+  $ emb resources build [COMPONENT...] [--json] [--verbose] [-C <value>] [--flavor <value>] [--dry-run] [-f]
 
 ARGUMENTS
   [COMPONENT...]  List of resources to build (defaults to all)
 
 FLAGS
+  -C, --root=<value>    Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -f, --force           Bypass the cache and force the build
       --dry-run         Do not build the resources but only produce build meta information
       --flavor=<value>  Specify the flavor to use.
@@ -574,12 +609,13 @@ Restart the whole project.
 
 ```
 USAGE
-  $ emb restart [COMPONENT...] [--json] [--verbose] [-f]
+  $ emb restart [COMPONENT...] [--json] [--verbose] [-C <value>] [-f]
 
 ARGUMENTS
   [COMPONENT...]  The component(s) to restart
 
 FLAGS
+  -C, --root=<value>  Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -f, --no-deps       Don't restart depdendent components
   --[no-]verbose
 
@@ -599,12 +635,13 @@ Run tasks.
 
 ```
 USAGE
-  $ emb run TASK... [--json] [--verbose] [-x container|local] [-a]
+  $ emb run TASK... [--json] [--verbose] [-C <value>] [-x container|local] [-a]
 
 ARGUMENTS
   TASK...  List of tasks to run. You can provide either ids or names (eg: component:task or task)
 
 FLAGS
+  -C, --root=<value>       Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -a, --all-matching       Run all tasks matching (when multiple matches)
   -x, --executor=<option>  Where to run the task. (experimental!)
                            <options: container|local>
@@ -623,18 +660,95 @@ EXAMPLES
   $ emb run
 ```
 
+## `emb secrets`
+
+List all secret references in the configuration.
+
+```
+USAGE
+  $ emb secrets [--json] [--verbose] [-C <value>] [--flavor <value>]
+
+FLAGS
+  -C, --root=<value>    Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
+      --flavor=<value>  Specify the flavor to use.
+  --[no-]verbose
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List all secret references in the configuration.
+
+EXAMPLES
+  $ emb secrets
+
+  $ emb secrets --json
+```
+
+## `emb secrets providers`
+
+Show configured secret providers and their status.
+
+```
+USAGE
+  $ emb secrets providers [--json] [--verbose] [-C <value>] [--flavor <value>]
+
+FLAGS
+  -C, --root=<value>    Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
+      --flavor=<value>  Specify the flavor to use.
+  --[no-]verbose
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Show configured secret providers and their status.
+
+EXAMPLES
+  $ emb secrets providers
+```
+
+## `emb secrets validate`
+
+Validate that all secret references can be resolved (without showing values).
+
+```
+USAGE
+  $ emb secrets validate [--json] [--verbose] [-C <value>] [--flavor <value>] [--fail-fast]
+
+FLAGS
+  -C, --root=<value>    Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
+      --fail-fast       Stop on first validation error
+      --flavor=<value>  Specify the flavor to use.
+  --[no-]verbose
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Validate that all secret references can be resolved (without showing values).
+
+EXAMPLES
+  $ emb secrets validate
+
+  $ emb secrets validate --fail-fast
+
+  $ emb secrets validate --json
+```
+
 ## `emb shell COMPONENT`
 
 Get a shell on a running component.
 
 ```
 USAGE
-  $ emb shell COMPONENT [--verbose] [-s <value>]
+  $ emb shell COMPONENT [--verbose] [-C <value>] [-s <value>]
 
 ARGUMENTS
   COMPONENT  The component you want to get a shell on
 
 FLAGS
+  -C, --root=<value>   Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -s, --shell=<value>  [default: bash] The shell to run
   --[no-]verbose
 
@@ -654,12 +768,13 @@ Starts the whole project.
 
 ```
 USAGE
-  $ emb start [COMPONENT...] [--json] [--verbose]
+  $ emb start [COMPONENT...] [--json] [--verbose] [-C <value>]
 
 ARGUMENTS
   [COMPONENT...]  The component(s) to start
 
 FLAGS
+  -C, --root=<value>  Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   --[no-]verbose
 
 GLOBAL FLAGS
@@ -678,10 +793,11 @@ Stop the whole project.
 
 ```
 USAGE
-  $ emb stop [--json] [--verbose] [--flavor <value>]
+  $ emb stop [--json] [--verbose] [-C <value>] [--flavor <value>]
 
 FLAGS
-  --flavor=<value>  Specify the flavor to use.
+  -C, --root=<value>    Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
+      --flavor=<value>  Specify the flavor to use.
   --[no-]verbose
 
 GLOBAL FLAGS
@@ -700,9 +816,10 @@ List tasks.
 
 ```
 USAGE
-  $ emb tasks [--json] [--verbose]
+  $ emb tasks [--json] [--verbose] [-C <value>]
 
 FLAGS
+  -C, --root=<value>  Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   --[no-]verbose
 
 GLOBAL FLAGS
@@ -721,12 +838,13 @@ Run tasks.
 
 ```
 USAGE
-  $ emb tasks run TASK... [--json] [--verbose] [-x container|local] [-a]
+  $ emb tasks run TASK... [--json] [--verbose] [-C <value>] [-x container|local] [-a]
 
 ARGUMENTS
   TASK...  List of tasks to run. You can provide either ids or names (eg: component:task or task)
 
 FLAGS
+  -C, --root=<value>       Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -a, --all-matching       Run all tasks matching (when multiple matches)
   -x, --executor=<option>  Where to run the task. (experimental!)
                            <options: container|local>
@@ -751,12 +869,13 @@ Start the whole project.
 
 ```
 USAGE
-  $ emb up [COMPONENT...] [--json] [--verbose] [--flavor <value>] [-f]
+  $ emb up [COMPONENT...] [--json] [--verbose] [-C <value>] [--flavor <value>] [-f]
 
 ARGUMENTS
   [COMPONENT...]  The component(s) to build and start
 
 FLAGS
+  -C, --root=<value>    Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
   -f, --force           Bypass caches, force the recreation of containers, etc
       --flavor=<value>  Specify the flavor to use.
   --[no-]verbose

package/dist/src/cli/abstract/BaseCommand.d.ts

@@ -4,6 +4,7 @@ export declare abstract class BaseCommand extends Command {
     protected context: EmbContext;
     static baseFlags: {
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        root: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     init(): Promise<void>;
 }

package/dist/src/cli/abstract/BaseCommand.js

@@ -1,9 +1,10 @@
-import { DockerComposeClient, getContext, setContext } from '../../index.js';
+import { DockerComposeClient, getContext, isContextStale, resetContext, setContext, } from '../../index.js';
 import { Command, Flags } from '@oclif/core';
 import Dockerode from 'dockerode';
 import { loadConfig } from '../../config/index.js';
 import { createKubernetesClient } from '../../kubernetes/client.js';
 import { Monorepo } from '../../monorepo/monorepo.js';
+import { SecretManager } from '../../secrets/index.js';
 import { withMarker } from '../utils.js';
 export class BaseCommand extends Command {
     context;
@@ -12,15 +13,34 @@ export class BaseCommand extends Command {
             name: 'verbose',
             allowNo: true,
         }),
+        root: Flags.string({
+            char: 'C',
+            description: 'Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.',
+            name: 'root',
+            required: false,
+        }),
     };
     async init() {
         const { flags } = await this.parse();
         await super.init();
+        // Reset context if EMB_ROOT changed (e.g., in tests switching between examples)
+        if (isContextStale()) {
+            resetContext();
+        }
         if (getContext()) {
             return;
         }
         try {
-            const { rootDir, config } = await withMarker('emb:config', 'load', () => loadConfig());
+            const { rootDir, config } = await withMarker('emb:config', 'load', () => loadConfig({ root: flags.root }));
+            // Create SecretManager early so plugins can register providers during init
+            const secrets = new SecretManager();
+            // Set a partial context before monorepo init so plugins can access secrets
+            const partialContext = {
+                docker: new Dockerode(),
+                kubernetes: createKubernetesClient(),
+                secrets,
+            };
+            setContext(partialContext);
             const monorepo = await withMarker('emb:monorepo', 'init', () => {
                 return new Monorepo(config, rootDir).init();
             });
@@ -29,10 +49,9 @@ export class BaseCommand extends Command {
             }
             const compose = new DockerComposeClient(monorepo);
             this.context = setContext({
-                docker: new Dockerode(),
+                ...partialContext,
                 monorepo,
                 compose,
-                kubernetes: createKubernetesClient(),
             });
         }
         catch (error) {

package/dist/src/cli/abstract/FlavouredCommand.d.ts

@@ -6,6 +6,7 @@ export declare abstract class FlavoredCommand<T extends typeof Command> extends
     static baseFlags: {
         flavor: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
         verbose: Interfaces.BooleanFlag<boolean>;
+        root: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
     };
     static enableJsonFlag: boolean;
     protected args: Args<T>;

package/dist/src/cli/abstract/KubernetesCommand.d.ts

@@ -3,5 +3,6 @@ export declare abstract class KubernetesCommand extends BaseCommand {
     static baseFlags: {
         namespace: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        root: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
 }

package/dist/src/cli/commands/components/logs.d.ts

@@ -4,11 +4,12 @@ export default class ComponentsLogs extends BaseCommand {
     static description: string;
     static enableJsonFlag: boolean;
     static examples: string[];
+    static strict: boolean;
     static flags: {
         follow: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     static args: {
-        component: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        component: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     run(): Promise<void>;
 }