@enspirit/emb 0.0.7 → 0.0.9

package/README.md

@@ -14,7 +14,7 @@ $ npm install -g @enspirit/emb
 $ emb COMMAND
 running command...
 $ emb (--version)
-@enspirit/emb/0.0.7 darwin-x64 node-v22.12.0
+@enspirit/emb/0.0.9 darwin-x64 node-v22.18.0
 $ emb --help [COMMAND]
 USAGE
   $ emb COMMAND
@@ -120,14 +120,15 @@ Build the components of the monorepo
 
 ```
 USAGE
-  $ emb components build [COMPONENT...] [--json] [--flavor <value>] [--dry-run]
+  $ emb components build [COMPONENT...] [--json] [--flavor <value>] [--dry-run] [-f]
 
 ARGUMENTS
   COMPONENT...  List of components to build (defaults to all)
 
 FLAGS
-  --dry-run         Do not build the components but only produce build meta information
-  --flavor=<value>  Specify the flavor to use.
+  -f, --force           Bypass the cache and force the build
+      --dry-run         Do not build the components but only produce build meta information
+      --flavor=<value>  Specify the flavor to use.
 
 GLOBAL FLAGS
   --json  Format output as json.
@@ -354,12 +355,13 @@ Run tasks.
 
 ```
 USAGE
-  $ emb tasks run TASK... [--json] [-x container|local]
+  $ emb tasks run TASK... [--json] [-x container|local] [-a]
 
 ARGUMENTS
   TASK...  List of tasks to run. You can provide either ids or names (eg: component:task or task)
 
 FLAGS
+  -a, --all-matching       Run all tasks matching (when multiple matches)
   -x, --executor=<option>  Where to run the task. (experimental!)
                            <options: container|local>
 

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

@@ -8,6 +8,7 @@ export default class BuildCommand extends FlavoredCommand<typeof BuildCommand> {
     static examples: string[];
     static flags: {
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     static enableJsonFlag: boolean;
     static strict: boolean;

package/dist/src/cli/commands/components/build.js

@@ -17,6 +17,12 @@ export default class BuildCommand extends FlavoredCommand {
             required: false,
             description: 'Do not build the components but only produce build meta information',
         }),
+        force: Flags.boolean({
+            name: 'force',
+            char: 'f',
+            required: false,
+            description: 'Bypass the cache and force the build',
+        }),
     };
     static enableJsonFlag = true;
     static strict = false;
@@ -25,6 +31,8 @@ export default class BuildCommand extends FlavoredCommand {
         const { monorepo } = getContext();
         return monorepo.run(new BuildComponentsOperation(), {
             dryRun: flags['dry-run'],
+            force: flags.force,
+            silent: flags.json,
             components: argv.length > 0
                 ? argv
                 : monorepo.components.map((c) => c.name),

package/dist/src/cli/commands/tasks/run.d.ts

@@ -8,6 +8,7 @@ export default class RunTask extends Command {
     static examples: string[];
     static flags: {
         executor: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'all-matching': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     static strict: boolean;
     run(): Promise<void>;

package/dist/src/cli/commands/tasks/run.js

@@ -1,4 +1,4 @@
-import { getContext } from '../../../index.js';
+import { AmbiguousTaskError, getContext } from '../../../index.js';
 import { Args, Command, Flags } from '@oclif/core';
 import { ExecutorType, RunTasksOperation } from '../../../monorepo/index.js';
 export default class RunTask extends Command {
@@ -18,14 +18,32 @@ export default class RunTask extends Command {
             description: 'Where to run the task. (experimental!)',
             options: Object.values(ExecutorType),
         }),
+        'all-matching': Flags.boolean({
+            name: 'all-matching',
+            char: 'a',
+            description: 'Run all tasks matching (when multiple matches)',
+            default: false,
+        }),
     };
     static strict = false;
     async run() {
         const { argv, flags } = await this.parse(RunTask);
         const { monorepo } = await getContext();
-        await monorepo.run(new RunTasksOperation(), {
-            tasks: argv,
-            executor: flags.executor,
-        });
+        try {
+            await monorepo.run(new RunTasksOperation(), {
+                tasks: argv,
+                executor: flags.executor,
+                allMatching: flags['all-matching'],
+            });
+        }
+        catch (error) {
+            if (error instanceof AmbiguousTaskError) {
+                throw error.toCliError([
+                    `Specify just one. Eg: \`emb tasks run ${error.options[0]}\``,
+                    'Run the same command with --all-matches / -a',
+                    'Review the list of tasks by running `emb tasks`',
+                ]);
+            }
+        }
     }
 }

package/dist/src/docker/compose/operations/ComposeUpOperation.js

@@ -1,7 +1,6 @@
 import { getContext } from '../../../index.js';
-import { Listr } from 'listr2';
 import * as z from 'zod';
-import { ExecuteLocalCommandOperation } from '../../../monorepo/index.js';
+import { ExecuteLocalCommandOperation, taskManagerFactory } from '../../../monorepo/index.js';
 import { AbstractOperation } from '../../../operations/index.js';
 /**
  * https://docs.docker.com/reference/cli/docker/compose/up/
@@ -20,20 +19,22 @@ export class ComposeUpOperation extends AbstractOperation {
     }
     async _run(input) {
         const { monorepo } = getContext();
+        const manager = taskManagerFactory();
         const command = ['docker', 'compose', 'up', '-d'];
         if (input?.forceRecreate) {
             command.push('--force-recreate');
         }
-        const task = new Listr({
-            rendererOptions: { persistentOutput: true },
-            async task() {
-                return monorepo.run(new ExecuteLocalCommandOperation(), {
-                    script: command.join(' '),
-                    workingDir: monorepo.rootDir,
-                });
+        manager.add([
+            {
+                async task() {
+                    return monorepo.run(new ExecuteLocalCommandOperation(), {
+                        script: command.join(' '),
+                        workingDir: monorepo.rootDir,
+                    });
+                },
+                title: 'Starting project',
             },
-            title: 'Starting project',
-        });
-        await task.run();
+        ]);
+        await manager.runAll();
     }
 }

package/dist/src/docker/operations/images/BuildImageOperation.js

@@ -55,7 +55,7 @@ export class BuildImageOperation extends AbstractOperation {
                     try {
                         const { vertexes } = await decodeBuildkitStatusResponse(trace.aux);
                         vertexes.forEach((v) => {
-                            logStream.write(JSON.stringify(v) + '\n');
+                            // logStream.write(JSON.stringify(v) + '\n');
                             this.observer?.(v.name);
                         });
                     }

package/dist/src/errors.d.ts

@@ -0,0 +1,57 @@
+export declare class EMBError extends Error {
+    code: string;
+    message: string;
+    constructor(code: string, message: string);
+    toCliError(suggestions: string[], ref?: string): CliError;
+}
+export declare class CliError extends EMBError {
+    /**
+     * a unique error code for this error class
+     */
+    code: string;
+    /**
+     * message to display related to the error
+     */
+    message: string;
+    /**
+     * a suggestion that may be useful or provide additional context
+     */
+    suggestions?: string[] | undefined;
+    /**
+     * a url to find out more information related to this error
+     * or fixing the error
+     */
+    ref?: string | undefined;
+    constructor(
+    /**
+     * a unique error code for this error class
+     */
+    code: string, 
+    /**
+     * message to display related to the error
+     */
+    message: string, 
+    /**
+     * a suggestion that may be useful or provide additional context
+     */
+    suggestions?: string[] | undefined, 
+    /**
+     * a url to find out more information related to this error
+     * or fixing the error
+     */
+    ref?: string | undefined);
+}
+export declare class AmbiguousTaskError extends EMBError {
+    options: string[];
+    constructor(msg: string, options: string[]);
+}
+export declare class UnkownReferenceError extends EMBError {
+    constructor(msg: string);
+}
+export declare class TaskNameCollisionError extends EMBError {
+    collisions: Array<string>;
+    constructor(msg: string, collisions: Array<string>);
+}
+export declare class CircularDependencyError extends EMBError {
+    constructor(msg: string);
+}

package/dist/src/errors.js

@@ -0,0 +1,66 @@
+export class EMBError extends Error {
+    code;
+    message;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.message = message;
+    }
+    toCliError(suggestions, ref) {
+        return new CliError(this.code, this.message, suggestions, ref);
+    }
+}
+export class CliError extends EMBError {
+    code;
+    message;
+    suggestions;
+    ref;
+    constructor(
+    /**
+     * a unique error code for this error class
+     */
+    code, 
+    /**
+     * message to display related to the error
+     */
+    message, 
+    /**
+     * a suggestion that may be useful or provide additional context
+     */
+    suggestions, 
+    /**
+     * a url to find out more information related to this error
+     * or fixing the error
+     */
+    ref) {
+        super(code, message);
+        this.code = code;
+        this.message = message;
+        this.suggestions = suggestions;
+        this.ref = ref;
+    }
+}
+export class AmbiguousTaskError extends EMBError {
+    options;
+    constructor(msg, options) {
+        super('AMBIG_TASK', msg);
+        this.options = options;
+    }
+}
+export class UnkownReferenceError extends EMBError {
+    constructor(msg) {
+        super('UNKNOWN_REF', msg);
+    }
+}
+export class TaskNameCollisionError extends EMBError {
+    collisions;
+    constructor(msg, collisions) {
+        super('UNKNOWN_REF', msg);
+        this.collisions = collisions;
+    }
+}
+export class CircularDependencyError extends EMBError {
+    constructor(msg) {
+        super('CIRCULAR_DEPS', msg);
+    }
+}

package/dist/src/index.d.ts

@@ -1,3 +1,4 @@
 export * from './context.js';
+export * from './errors.js';
 export * from './types.js';
 export { run } from '@oclif/core';

package/dist/src/index.js

@@ -1,3 +1,4 @@
 export * from './context.js';
+export * from './errors.js';
 export * from './types.js';
 export { run } from '@oclif/core';

package/dist/src/monorepo/monorepo.d.ts

@@ -24,6 +24,7 @@ export declare class Monorepo {
     expand(str: string, expander?: TemplateExpander): Promise<string>;
     expand<R extends Record<string, unknown>>(record: R, expander?: TemplateExpander): Promise<R>;
     private installStore;
+    private installEnv;
     init(): Promise<Monorepo>;
     join(...paths: string[]): string;
     run<I, O>(operation: IOperation<I, O>, args: I): Promise<O>;

package/dist/src/monorepo/monorepo.js

@@ -84,6 +84,19 @@ export class Monorepo {
         this._store = store || new EMBStore(this);
         await this._store.init();
     }
+    async installEnv() {
+        // Expand env vars at the init and then we don't expand anymore
+        // The only available source for them is the existing env
+        const expander = new TemplateExpander();
+        const options = {
+            default: 'env',
+            sources: {
+                env: process.env,
+            },
+        };
+        const expanded = await expander.expandRecord(this._config.env, options);
+        Object.assign(process.env, expanded);
+    }
     // Initialize
     async init() {
         if (this.initialized) {
@@ -98,17 +111,7 @@ export class Monorepo {
             const newConfig = await plugin.extendConfig?.(await pConfig);
             return newConfig ?? pConfig;
         }, Promise.resolve(this._config));
-        // Expand env vars at the init and then we don't expand anymore
-        // The only available source for them is the existing env
-        const expander = new TemplateExpander();
-        const options = {
-            default: 'env',
-            sources: {
-                env: process.env,
-            },
-        };
-        const expanded = await expander.expandRecord(this._config.env, options);
-        Object.assign(process.env, expanded);
+        await this.installEnv();
         this.initialized = true;
         await Promise.all(plugins.map(async (p) => {
             await p.init?.();
@@ -125,6 +128,7 @@ export class Monorepo {
     async withFlavor(name) {
         const repo = new Monorepo(this._config.withFlavor(name));
         await repo.installStore();
+        await repo.installEnv();
         return repo;
     }
 }

package/dist/src/monorepo/operations/components/BuildComponentsOperation.d.ts

@@ -4,6 +4,7 @@ import { AbstractOperation } from '../../../operations/index.js';
 export type BuildComponentMeta = {
     dryRun?: boolean;
     cacheHit?: boolean;
+    force?: boolean;
     build: DockerComponentBuild;
     preBuildMeta?: string;
     sentinelFile: string;
@@ -11,6 +12,8 @@ export type BuildComponentMeta = {
 declare const schema: z.ZodObject<{
     components: z.ZodOptional<z.ZodArray<z.ZodString>>;
     dryRun: z.ZodOptional<z.ZodBoolean>;
+    silent: z.ZodOptional<z.ZodBoolean>;
+    force: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare class BuildComponentsOperation extends AbstractOperation<typeof schema, Record<string, BuildComponentMeta>> {
     constructor();

package/dist/src/monorepo/operations/components/BuildComponentsOperation.js

@@ -13,6 +13,14 @@ const schema = z.object({
         .boolean()
         .optional()
         .describe('Do not build but return the config that would be used to build the images'),
+    silent: z
+        .boolean()
+        .optional()
+        .describe('Do not produce any output on the terminal'),
+    force: z
+        .boolean()
+        .optional()
+        .describe('Bypass the cache and force the build'),
 });
 export class BuildComponentsOperation extends AbstractOperation {
     constructor() {
@@ -28,22 +36,39 @@ export class BuildComponentsOperation extends AbstractOperation {
             forbidIdNameCollision: true,
         });
         const ordered = findRunOrder(selection.map((s) => s.name), collection);
-        const tasks = await Promise.all(ordered.map((cmp) => {
+        const tasks = ordered.map((cmp) => {
             return {
                 task: async (context, task) => {
-                    return this.buildComponent(cmp, task, context, input.dryRun);
+                    return this.buildComponent(cmp, task, context, {
+                        dryRun: input.dryRun,
+                        force: input.force,
+                    });
                 },
                 title: `Building ${cmp.name}`,
             };
-        }));
-        const list = manager.newListr([...tasks], {
-            rendererOptions: { persistentOutput: true },
+        });
+        manager.add([
+            {
+                title: 'Build images',
+                async task(ctx, task) {
+                    return task.newListr([...tasks], {
+                        rendererOptions: {
+                            collapseSubtasks: true,
+                        },
+                    });
+                },
+            },
+        ], {
+            rendererOptions: {
+                collapseSkips: false,
+                collapseSubtasks: false,
+            },
             ctx: {},
         });
-        const results = await list.run();
+        const results = await manager.runAll();
         return results;
     }
-    async buildComponent(cmp, parentTask, parentContext, dryRun = false) {
+    async buildComponent(cmp, parentTask, parentContext, options) {
         const prereqPlugin = new FilePrerequisitePlugin();
         const list = parentTask.newListr([
             // Collect all the prerequisites and other build infos
@@ -52,6 +77,7 @@ export class BuildComponentsOperation extends AbstractOperation {
                 async task(ctx) {
                     // Install the context for this specific component build chain
                     ctx.cacheHit = false;
+                    ctx.force = options?.force;
                     ctx.sentinelFile = getSentinelFile(cmp);
                     ctx.build = await cmp.toDockerBuild();
                 },
@@ -59,6 +85,9 @@ export class BuildComponentsOperation extends AbstractOperation {
             },
             // Check for sentinal information to see if the build can be skipped
             {
+                skip(ctx) {
+                    return Boolean(ctx.force);
+                },
                 task: async (ctx) => {
                     ctx.preBuildMeta = await prereqPlugin.meta(cmp, ctx.build.prerequisites, 'pre');
                     let lastValue;
@@ -70,19 +99,17 @@ export class BuildComponentsOperation extends AbstractOperation {
                     }
                     if (lastValue) {
                         const diff = await prereqPlugin.diff(cmp, ctx.build.prerequisites, lastValue, ctx.preBuildMeta);
-                        if (!diff) {
+                        if (!ctx.force && !diff) {
                             ctx.cacheHit = true;
-                            // parentTask.skip(`${parentTask.title} (cache hit)`);
+                            parentTask.skip(`${parentTask.title} (cache hit)`);
                         }
                     }
                 },
                 title: 'Checking prerequisites',
             },
             {
+                skip: (ctx) => !ctx.force && (Boolean(ctx.cacheHit) || Boolean(ctx.dryRun)),
                 task: async (ctx, task) => {
-                    if (ctx.cacheHit || ctx.dryRun) {
-                        return task.skip();
-                    }
                     const title = `Building image ${ctx.build.name}:${ctx.build.tag}`;
                     task.title = title;
                     const op = new BuildImageOperation((progress) => {
@@ -104,10 +131,8 @@ export class BuildComponentsOperation extends AbstractOperation {
             },
             // Update sentinel file
             {
-                task: async (ctx, task) => {
-                    if (ctx.cacheHit || ctx.dryRun) {
-                        return task.skip();
-                    }
+                skip: (ctx) => !ctx.force && (Boolean(ctx.cacheHit) || Boolean(ctx.dryRun)),
+                task: async (ctx) => {
                     const sentinelValue = await prereqPlugin.meta(cmp, ctx.build.prerequisites, 'post');
                     await this.context.monorepo.store.writeFile(ctx.sentinelFile, sentinelValue);
                 },
@@ -117,13 +142,15 @@ export class BuildComponentsOperation extends AbstractOperation {
                 // Return build meta data
                 async task(ctx) {
                     parentContext[cmp.name] = ctx;
-                    if (ctx.dryRun) {
-                        // parentTask.skip(`${parentTask.title} (dry run)`);
+                    if (!ctx.force && ctx.dryRun) {
+                        parentTask.skip(`${parentTask.title} (dry run)`);
                     }
                 },
             },
         ], {
-            ctx: { dryRun },
+            ctx: {
+                ...options,
+            },
         });
         return list;
     }

package/dist/src/monorepo/operations/tasks/RunTasksOperation.d.ts

@@ -8,13 +8,12 @@ export declare enum ExecutorType {
 export type RunTasksOperationParams = {
     tasks: Array<string>;
     executor?: ExecutorType | undefined;
+    allMatching?: boolean;
 };
 export type TaskWithScript = TaskInfo & {
     script: string;
 };
 export declare class RunTasksOperation implements IOperation<RunTasksOperationParams, Array<TaskInfo>> {
-    protected out?: Writable | undefined;
-    constructor(out?: Writable | undefined);
     run(params: RunTasksOperationParams): Promise<Array<TaskInfo>>;
     protected runDocker(task: TaskWithScript, out?: Writable): Promise<void>;
     protected runLocal(task: TaskWithScript): Promise<import("stream").Readable>;

package/dist/src/monorepo/operations/tasks/RunTasksOperation.js

@@ -1,7 +1,6 @@
 import { getContext } from '../../../index.js';
-import { Manager } from '@listr2/manager';
 import { ContainerExecOperation } from '../../../docker/index.js';
-import { EMBCollection, findRunOrder } from '../../index.js';
+import { EMBCollection, findRunOrder, taskManagerFactory, } from '../../index.js';
 import { ExecuteLocalCommandOperation, GetComponentContainerOperation, } from '../index.js';
 export var ExecutorType;
 (function (ExecutorType) {
@@ -9,10 +8,6 @@ export var ExecutorType;
     ExecutorType["local"] = "local";
 })(ExecutorType || (ExecutorType = {}));
 export class RunTasksOperation {
-    out;
-    constructor(out) {
-        this.out = out;
-    }
     async run(params) {
         const { monorepo } = getContext();
         // First ensure the selection is valid (user can use task IDs or names)
@@ -20,16 +15,11 @@ export class RunTasksOperation {
             idField: 'id',
             depField: 'pre',
         });
-        const ordered = findRunOrder(params.tasks, collection);
-        const runner = new Manager({
-            concurrent: false,
-            exitOnError: false,
-            rendererOptions: {
-                collapseSubtasks: false,
-                collapseSkips: false,
-            },
+        const ordered = findRunOrder(params.tasks, collection, {
+            onAmbiguous: params.allMatching ? 'runAll' : 'error',
         });
-        const list = runner.newListr(ordered.map((task) => {
+        const manager = taskManagerFactory();
+        manager.add(ordered.map((task) => {
             return {
                 rendererOptions: {
                     persistentOutput: true,
@@ -58,7 +48,7 @@ export class RunTasksOperation {
                 title: `Running ${task.id}`,
             };
         }));
-        await list.run();
+        await manager.runAll();
         return ordered;
     }
     async runDocker(task, out) {

package/dist/src/monorepo/taskManagerFactory.js

@@ -8,6 +8,7 @@ export function taskManagerFactory(override) {
         rendererOptions: {
             collapseErrors: false,
             collapseSubtasks: false,
+            collapseSkips: false,
             icon: {
                 [ListrDefaultRendererLogLevels.SKIPPED_WITH_COLLAPSE]: '♺',
             },

package/dist/src/monorepo/utils/findRunOrder.js

@@ -1,4 +1,5 @@
 import graphlib from 'graphlib';
+import { AmbiguousTaskError, CircularDependencyError, TaskNameCollisionError, UnkownReferenceError, } from '../../errors.js';
 export class EMBCollection {
     items;
     idField;
@@ -63,8 +64,7 @@ export class EMBCollection {
                 parts.push(`id↔name collisions (${collisions.length}):\n` +
                     collisions.join('\n'));
             }
-            // eslint-disable-next-line unicorn/error-message
-            throw new Error(parts.join('\n\n'));
+            throw new TaskNameCollisionError('Collision between task names and ids', parts);
         }
     }
     /** All items (stable array iteration) */
@@ -83,13 +83,13 @@ export class EMBCollection {
             return opts?.multiple ? [idHit] : idHit;
         const nameHits = this.byName.get(ref) ?? [];
         if (nameHits.length === 0) {
-            throw new Error(`Unknown reference "${ref}"`);
+            throw new UnkownReferenceError(`Unknown reference "${ref}"`);
         }
         if (opts?.multiple)
             return nameHits;
         if (nameHits.length > 1) {
-            const ids = nameHits.map((t) => this.idOf(t)).join(', ');
-            throw new Error(`Ambiguous reference "${ref}" matches multiple ids: [${ids}]`);
+            const ids = nameHits.map((t) => this.idOf(t));
+            throw new AmbiguousTaskError(`Ambiguous reference "${ref}" matches multiple id/name`, ids);
         }
         return nameHits[0];
     }
@@ -136,7 +136,7 @@ export function findRunOrder(selection, collection, { onAmbiguous = 'error' } =
     const g = buildGraph(collection, onAmbiguous);
     const cycles = graphlib.alg.findCycles(g);
     if (cycles.length > 0) {
-        throw new Error(`Circular dependencies detected: ${JSON.stringify(cycles)}`);
+        throw new CircularDependencyError(`Circular dependencies detected: ${JSON.stringify(cycles)}`);
     }
     const selectedIds = new Set();
     for (const ref of selection)

package/oclif.manifest.json

@@ -164,6 +164,14 @@
           "required": false,
           "allowNo": false,
           "type": "boolean"
+        },
+        "force": {
+          "char": "f",
+          "description": "Bypass the cache and force the build",
+          "name": "force",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -226,12 +234,10 @@
         "index.js"
       ]
     },
-    "containers": {
-      "aliases": [
-        "ps"
-      ],
+    "config:print": {
+      "aliases": [],
       "args": {},
-      "description": "List docker containers.",
+      "description": "Print the current config.",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -243,18 +249,18 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "all": {
-          "char": "a",
-          "description": "Retun all containers. By default, only running containers are shown",
-          "name": "all",
+        "flavor": {
+          "description": "Specify the flavor to use.",
+          "name": "flavor",
           "required": false,
-          "allowNo": false,
-          "type": "boolean"
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "containers",
+      "id": "config:print",
       "pluginAlias": "@enspirit/emb",
       "pluginName": "@enspirit/emb",
       "pluginType": "core",
@@ -266,14 +272,16 @@
         "src",
         "cli",
         "commands",
-        "containers",
-        "index.js"
+        "config",
+        "print.js"
       ]
     },
-    "containers:prune": {
-      "aliases": [],
+    "containers": {
+      "aliases": [
+        "ps"
+      ],
       "args": {},
-      "description": "Prune containers.",
+      "description": "List docker containers.",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -284,11 +292,19 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
+        },
+        "all": {
+          "char": "a",
+          "description": "Retun all containers. By default, only running containers are shown",
+          "name": "all",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "containers:prune",
+      "id": "containers",
       "pluginAlias": "@enspirit/emb",
       "pluginName": "@enspirit/emb",
       "pluginType": "core",
@@ -301,13 +317,13 @@
         "cli",
         "commands",
         "containers",
-        "prune.js"
+        "index.js"
       ]
     },
-    "config:print": {
+    "containers:prune": {
       "aliases": [],
       "args": {},
-      "description": "Print the current config.",
+      "description": "Prune containers.",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -318,19 +334,11 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        },
-        "flavor": {
-          "description": "Specify the flavor to use.",
-          "name": "flavor",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:print",
+      "id": "containers:prune",
       "pluginAlias": "@enspirit/emb",
       "pluginName": "@enspirit/emb",
       "pluginType": "core",
@@ -342,8 +350,8 @@
         "src",
         "cli",
         "commands",
-        "config",
-        "print.js"
+        "containers",
+        "prune.js"
       ]
     },
     "images:delete": {
@@ -538,6 +546,13 @@
             "local"
           ],
           "type": "option"
+        },
+        "all-matching": {
+          "char": "a",
+          "description": "Run all tasks matching (when multiple matches)",
+          "name": "all-matching",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -559,5 +574,5 @@
       ]
     }
   },
-  "version": "0.0.7"
+  "version": "0.0.9"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@enspirit/emb",
   "type": "module",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "keywords": ["monorepo", "docker", "taskrunner", "ci", "docker compose", "sentinel", "makefile"],
   "author": "Louis Lambeau <louis.lambeau@enspirit.be>",
   "license": "ISC",
@@ -109,6 +109,11 @@
     ],
     "topicSeparator": " ",
     "topics": {
+      "images": {"description": "List, delete, prune docker containers" },
+      "containers": {"description": "List, delete, prune docker images" },
+      "components": {"description": "List & build components resources" },
+      "config": {"description": "It's all about config" },
+      "tasks": {"description": "List and run tasks" }
     }
   }
 }