@enspirit/emb 0.2.0 → 0.3.1

package/README.md

@@ -14,7 +14,7 @@ $ npm install -g @enspirit/emb
 $ emb COMMAND
 running command...
 $ emb (--version)
-@enspirit/emb/0.2.0 darwin-x64 node-v22.12.0
+@enspirit/emb/0.3.1 darwin-x64 node-v22.12.0
 $ emb --help [COMMAND]
 USAGE
   $ emb COMMAND

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

@@ -1,6 +1,6 @@
 import { Args, Flags } from '@oclif/core';
 import { FlavoredCommand, getContext } from '../../index.js';
-import { ExecShellOperation } from '../../../docker/index.js';
+import { ComposeExecShellOperation } from '../../../docker/index.js';
 import { ShellExitError } from '../../../errors.js';
 export default class ComponentsLogs extends FlavoredCommand {
     static aliases = ['shell'];
@@ -26,8 +26,8 @@ export default class ComponentsLogs extends FlavoredCommand {
         const { flags, args } = await this.parse(ComponentsLogs);
         const { monorepo } = await getContext();
         try {
-            await monorepo.run(new ExecShellOperation(), {
-                component: args.component,
+            await monorepo.run(new ComposeExecShellOperation(), {
+                service: args.component,
                 shell: flags.shell,
             });
         }

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

@@ -9,19 +9,31 @@ export default class TasksIndex extends BaseCommand {
     async run() {
         const { flags } = await this.parse(TasksIndex);
         const { monorepo: { tasks }, } = await getContext();
+        const sortedTasks = tasks.toSorted((a, b) => {
+            const ac = a.component;
+            const bc = b.component;
+            // Put null/undefined first
+            if (!ac && bc) {
+                return -1;
+            }
+            if (Boolean(ac) && !bc) {
+                return 1;
+            }
+            // Compare components (if both not null)
+            if (Boolean(ac) && Boolean(bc)) {
+                const cmp = ac.localeCompare(bc);
+                if (cmp !== 0) {
+                    return cmp;
+                }
+            }
+            // Compare names as fallback
+            return a.name.localeCompare(b.name);
+        });
         if (!flags.json) {
             printTable({
                 ...TABLE_DEFAULTS,
                 columns: ['name', 'component', 'description', 'id'],
-                data: tasks.toSorted((a, b) => {
-                    if (a.component === b.component) {
-                        return a.name < b.name ? -1 : 1;
-                    }
-                    if (!a.component && b.component) {
-                        return -1;
-                    }
-                    return 0;
-                }),
+                data: sortedTasks,
             });
         }
         return tasks;

package/dist/src/docker/compose/operations/ComposeExecOperation.d.ts

@@ -0,0 +1,13 @@
+import { Writable } from 'node:stream';
+import * as z from 'zod';
+import { AbstractOperation } from '../../../operations/index.js';
+declare const schema: z.ZodObject<{
+    command: z.ZodString;
+    service: z.ZodString;
+}, z.core.$strip>;
+export declare class ComposeExecOperation extends AbstractOperation<typeof schema, void> {
+    protected out?: Writable | undefined;
+    constructor(out?: Writable | undefined);
+    protected _run(input: z.input<typeof schema>): Promise<void>;
+}
+export {};

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

@@ -0,0 +1,59 @@
+import { spawn } from 'node:child_process';
+import * as z from 'zod';
+import { ComposeExecError } from '../../../errors.js';
+import { AbstractOperation } from '../../../operations/index.js';
+const schema = z.object({
+    command: z.string().describe('The command to execute on the service'),
+    service: z
+        .string()
+        .describe('The name of the compose service to exec a shell'),
+});
+export class ComposeExecOperation extends AbstractOperation {
+    out;
+    constructor(out) {
+        super(schema);
+        this.out = out;
+    }
+    async _run(input) {
+        const { monorepo } = this.context;
+        const cmd = 'docker';
+        const args = ['compose', 'exec', input.service, input.command];
+        const child = spawn(cmd, args, {
+            stdio: 'pipe',
+            shell: true,
+            cwd: monorepo.rootDir,
+        });
+        if (this.out) {
+            child.stderr.pipe(this.out);
+            child.stdout.pipe(this.out);
+        }
+        const forward = (sig) => {
+            try {
+                child.kill(sig);
+            }
+            catch { }
+        };
+        const signals = [
+            'SIGINT',
+            'SIGTERM',
+            'SIGHUP',
+            'SIGQUIT',
+        ];
+        signals.forEach((sig) => {
+            process.on(sig, () => forward(sig));
+        });
+        return new Promise((resolve, reject) => {
+            child.on('error', (err) => {
+                reject(new Error(`Failed to execute docker compose: ${err.message}`));
+            });
+            child.on('exit', (code, signal) => {
+                if (code !== null && code !== 0) {
+                    reject(new ComposeExecError(`The shell exited unexpectedly. ${code}`, code, signal));
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+}

package/dist/src/docker/{operations/containers/ExecShellOperation.d.ts → compose/operations/ComposeExecShellOperation.d.ts}

@@ -2,9 +2,9 @@ import * as z from 'zod';
 import { AbstractOperation } from '../../../operations/index.js';
 declare const schema: z.ZodObject<{
     shell: z.ZodOptional<z.ZodDefault<z.ZodString>>;
-    component: z.ZodString;
+    service: z.ZodString;
 }, z.core.$strip>;
-export declare class ExecShellOperation extends AbstractOperation<typeof schema, void> {
+export declare class ComposeExecShellOperation extends AbstractOperation<typeof schema, void> {
     constructor();
     protected _run(input: z.input<typeof schema>): Promise<void>;
 }

package/dist/src/docker/{operations/containers/ExecShellOperation.js → compose/operations/ComposeExecShellOperation.js}

@@ -1,38 +1,24 @@
-import { getContext, ListContainersOperation, MultipleContainersFoundError, NoContainerFoundError, ShellExitError, } from '../../../index.js';
 import { spawn } from 'node:child_process';
 import * as z from 'zod';
+import { ShellExitError } from '../../../errors.js';
 import { AbstractOperation } from '../../../operations/index.js';
 const schema = z.object({
     shell: z.string().default('bash').optional(),
-    component: z
+    service: z
         .string()
-        .describe('The name of the component on which to run a shell'),
+        .describe('The name of the compose service to exec a shell'),
 });
-export class ExecShellOperation extends AbstractOperation {
+export class ComposeExecShellOperation extends AbstractOperation {
     constructor() {
         super(schema);
     }
     async _run(input) {
-        const { monorepo } = getContext();
-        const containers = await monorepo.run(new ListContainersOperation(), {
-            filters: {
-                label: [
-                    `emb/project=${monorepo.name}`,
-                    `emb/component=${input.component}`,
-                    `emb/flavor=${monorepo.currentFlavor}`,
-                ],
-            },
-        });
-        if (containers.length === 0) {
-            throw new NoContainerFoundError(`No container found for component \`${input.component}\``, input.component);
-        }
-        if (containers.length > 1) {
-            throw new MultipleContainersFoundError(`More than one container found for component \`${input.component}\``, input.component);
-        }
+        const { monorepo } = this.context;
         const cmd = 'docker';
-        const args = ['exec', '-it', containers[0].Id, input?.shell || 'bash'];
+        const args = ['compose', 'exec', input.service, input.shell || 'bash'];
         const child = spawn(cmd, args, {
             stdio: 'inherit',
+            cwd: monorepo.rootDir,
             env: {
                 ...process.env,
                 DOCKER_CLI_HINTS: 'false',
@@ -55,11 +41,11 @@ export class ExecShellOperation extends AbstractOperation {
         });
         return new Promise((resolve, reject) => {
             child.on('error', (err) => {
-                reject(new Error(`Failed to exeucte docker: ${err.message}`));
+                reject(new Error(`Failed to execute docker: ${err.message}`));
             });
             child.on('exit', (code, signal) => {
                 if (code !== null && code !== 0) {
-                    reject(new ShellExitError(`The shell exited unexpectedly. ${code}`, input.component, code, signal));
+                    reject(new ShellExitError(`The shell exited unexpectedly. ${code}`, input.service, code, signal));
                 }
                 else {
                     resolve();

package/dist/src/docker/compose/operations/index.d.ts

@@ -1,2 +1,4 @@
 export * from './ComposeDownOperation.js';
+export * from './ComposeExecOperation.js';
+export * from './ComposeExecShellOperation.js';
 export * from './ComposeUpOperation.js';

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

@@ -1,2 +1,4 @@
 export * from './ComposeDownOperation.js';
+export * from './ComposeExecOperation.js';
+export * from './ComposeExecShellOperation.js';
 export * from './ComposeUpOperation.js';

package/dist/src/docker/operations/containers/index.d.ts

@@ -1,4 +1,3 @@
-export * from './ExecContainerOperation.js';
-export * from './ExecShellOperation.js';
+export * from './ContainerExecOperation.js';
 export * from './ListContainersOperation.js';
 export * from './PruneContainersOperation.js';

package/dist/src/docker/operations/containers/index.js

@@ -1,4 +1,3 @@
-export * from './ExecContainerOperation.js';
-export * from './ExecShellOperation.js';
+export * from './ContainerExecOperation.js';
 export * from './ListContainersOperation.js';
 export * from './PruneContainersOperation.js';

package/dist/src/docker/operations/images/BuildImageOperation.d.ts

@@ -1,3 +1,4 @@
+import { Writable } from 'node:stream';
 import * as z from 'zod';
 import { AbstractOperation } from '../../../operations/index.js';
 /**
@@ -13,7 +14,7 @@ export declare const BuildImageOperationInputSchema: z.ZodObject<{
     target: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare class BuildImageOperation extends AbstractOperation<typeof BuildImageOperationInputSchema, Array<unknown>> {
-    private observer?;
-    constructor(observer?: ((progress: string) => void) | undefined);
+    private out?;
+    constructor(out?: Writable | undefined);
     protected _run(input: z.input<typeof BuildImageOperationInputSchema>): Promise<Array<unknown>>;
 }

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

@@ -30,13 +30,14 @@ export const BuildImageOperationInputSchema = z.object({
     target: z.string().optional().describe('Target build stage'),
 });
 export class BuildImageOperation extends AbstractOperation {
-    observer;
-    constructor(observer) {
+    out;
+    constructor(out) {
         super(BuildImageOperationInputSchema);
-        this.observer = observer;
+        this.out = out;
     }
     async _run(input) {
         const logStream = await this.context.monorepo.store.createWriteStream(`logs/docker/build/${input.tag}.log`);
+        this.out?.write('Sending build context to Docker\n');
         const stream = await this.context.docker.buildImage({
             context: input.context,
             src: [...input.src],
@@ -48,6 +49,7 @@ export class BuildImageOperation extends AbstractOperation {
             target: input.target,
             version: '2',
         });
+        this.out?.write('Starting build\n');
         return new Promise((resolve, reject) => {
             this.context.docker.modem.followProgress(stream, (err, traces) => {
                 logStream.close();
@@ -62,7 +64,7 @@ export class BuildImageOperation extends AbstractOperation {
                         const { vertexes } = await decodeBuildkitStatusResponse(trace.aux);
                         vertexes.forEach((v) => {
                             // logStream.write(JSON.stringify(v) + '\n');
-                            this.observer?.(v.name);
+                            this.out?.write(v.name + '\n');
                         });
                     }
                     catch (error) {

package/dist/src/docker/resources/DockerImageResource.js

@@ -1,42 +1,79 @@
+import { fdir as Fdir } from 'fdir';
 import { stat, statfs } from 'node:fs/promises';
 import { join } from 'node:path';
 import pMap from 'p-map';
 import { GitPrerequisitePlugin } from '../../prerequisites/index.js';
 import { ResourceFactory, } from '../../monorepo/resources/ResourceFactory.js';
 import { BuildImageOperation } from '../operations/index.js';
-const DockerImageOpFactory = async ({ config, component, monorepo }) => {
-    const fromConfig = (config.params || {});
-    const context = fromConfig.context
-        ? fromConfig.context[0] === '/'
-            ? monorepo.join(fromConfig.context)
-            : component.join(fromConfig.context)
-        : monorepo.join(component.rootDir);
-    // Ensure the folder exists
-    await statfs(context);
-    const plugin = new GitPrerequisitePlugin();
-    const sources = await plugin.collect(context);
-    const imageName = [monorepo.name, fromConfig.tag || component.name].join('/');
-    const tagName = fromConfig.tag || monorepo.defaults.docker?.tag || 'latest';
-    const buildParams = {
-        context,
-        dockerfile: fromConfig.dockerfile || 'Dockerfile',
-        src: sources.map((s) => s.path),
-        buildArgs: await monorepo.expand({
-            ...monorepo.defaults.docker?.buildArgs,
-            ...fromConfig.buildArgs,
-        }),
-        tag: await monorepo.expand(`${imageName}:${tagName}`),
-        labels: await monorepo.expand({
-            ...fromConfig.labels,
-            'emb/project': monorepo.name,
-            'emb/component': component.name,
-            'emb/flavor': monorepo.currentFlavor,
-        }),
-        target: fromConfig.target,
-    };
-    const lastUpdatedInfo = async (sources) => {
+class DockerImageResourceBuilder {
+    buildContext;
+    context;
+    constructor(buildContext) {
+        this.buildContext = buildContext;
+        this.context = this.config.context
+            ? this.config.context[0] === '/'
+                ? buildContext.monorepo.join(this.config.context)
+                : buildContext.component.join(this.config.context)
+            : buildContext.monorepo.join(buildContext.component.rootDir);
+    }
+    get monorepo() {
+        return this.buildContext.monorepo;
+    }
+    get config() {
+        return (this.buildContext.config.params || {});
+    }
+    get component() {
+        return this.buildContext.component;
+    }
+    async build(out) {
+        // Ensure the folder exists
+        await statfs(this.context);
+        const imageName = [
+            this.monorepo.name,
+            this.config.tag || this.component.name,
+        ].join('/');
+        const tagName = this.config.tag || this.monorepo.defaults.docker?.tag || 'latest';
+        const crawler = new Fdir();
+        const sources = await crawler
+            .withRelativePaths()
+            .crawl(this.context)
+            .withPromise();
+        const buildParams = {
+            context: this.context,
+            dockerfile: this.config.dockerfile || 'Dockerfile',
+            src: sources,
+            buildArgs: await this.monorepo.expand({
+                ...this.monorepo.defaults.docker?.buildArgs,
+                ...this.config.buildArgs,
+            }),
+            tag: await this.monorepo.expand(`${imageName}:${tagName}`),
+            labels: await this.monorepo.expand({
+                ...this.config.labels,
+                'emb/project': this.monorepo.name,
+                'emb/component': this.component.name,
+                'emb/flavor': this.monorepo.currentFlavor,
+            }),
+            target: this.config.target,
+        };
+        return {
+            input: buildParams,
+            operation: new BuildImageOperation(out),
+        };
+    }
+    async mustBuild(sentinel) {
+        const plugin = new GitPrerequisitePlugin();
+        const sources = await plugin.collect(this.context);
+        const lastUpdated = await this.lastUpdatedInfo(sources);
+        if (!sentinel) {
+            return lastUpdated;
+        }
+        return lastUpdated && lastUpdated.time.getTime() > sentinel.mtime
+            ? lastUpdated
+            : undefined;
+    }
+    async lastUpdatedInfo(sources) {
         const stats = await pMap(sources, async (s) => {
-            const stats = await stat(join(context, s.path));
+            const stats = await stat(join(this.context, s.path));
             return {
                 time: stats.mtime,
                 path: s.path,
@@ -48,20 +85,7 @@ const DockerImageOpFactory = async ({ config, component, monorepo }) => {
         return stats.reduce((last, entry) => {
             return last.time > entry.time ? last : entry;
         }, stats[0]);
-    };
-    return {
-        async mustBuild(sentinel) {
-            const lastUpdated = await lastUpdatedInfo(sources);
-            if (!sentinel) {
-                return lastUpdated;
-            }
-            return lastUpdated && lastUpdated.time.getTime() > sentinel.mtime
-                ? lastUpdated
-                : undefined;
-        },
-        input: buildParams,
-        operation: new BuildImageOperation(),
-    };
-};
+    }
+}
 // Bring better abstraction and register as part of the plugin initialization
-ResourceFactory.register('docker/image', DockerImageOpFactory);
+ResourceFactory.register('docker/image', async (context) => new DockerImageResourceBuilder(context));

package/dist/src/errors.d.ts

@@ -59,10 +59,10 @@ export declare class CircularDependencyError extends EMBError {
     constructor(msg: string, deps: Array<Array<string>>);
 }
 export declare class ShellExitError extends EMBError {
-    component: string;
+    service: string;
     exitCode: number;
     signal?: (NodeJS.Signals | null) | undefined;
-    constructor(msg: string, component: string, exitCode: number, signal?: (NodeJS.Signals | null) | undefined);
+    constructor(msg: string, service: string, exitCode: number, signal?: (NodeJS.Signals | null) | undefined);
 }
 export declare class NoContainerFoundError extends EMBError {
     component: string;
@@ -72,3 +72,8 @@ export declare class MultipleContainersFoundError extends EMBError {
     component: string;
     constructor(msg: string, component: string);
 }
+export declare class ComposeExecError extends EMBError {
+    exitCode: number;
+    signal?: (NodeJS.Signals | null) | undefined;
+    constructor(msg: string, exitCode: number, signal?: (NodeJS.Signals | null) | undefined);
+}

package/dist/src/errors.js

@@ -71,12 +71,12 @@ export class CircularDependencyError extends EMBError {
     }
 }
 export class ShellExitError extends EMBError {
-    component;
+    service;
     exitCode;
     signal;
-    constructor(msg, component, exitCode, signal) {
+    constructor(msg, service, exitCode, signal) {
         super('SHELL_EXIT_ERR', msg);
-        this.component = component;
+        this.service = service;
         this.exitCode = exitCode;
         this.signal = signal;
     }
@@ -95,3 +95,12 @@ export class MultipleContainersFoundError extends EMBError {
         this.component = component;
     }
 }
+export class ComposeExecError extends EMBError {
+    exitCode;
+    signal;
+    constructor(msg, exitCode, signal) {
+        super('COMPOSE_EXEC_ERR', msg);
+        this.exitCode = exitCode;
+        this.signal = signal;
+    }
+}

package/dist/src/monorepo/operations/resources/BuildResourcesOperation.d.ts

@@ -7,6 +7,7 @@ export type BuildResourceMeta = {
     force?: boolean;
     resource?: ResourceInfo;
     builder?: ResourceBuilderInfo<unknown, unknown>;
+    builderInput?: unknown;
     sentinelData?: unknown;
     cacheHit?: boolean;
 };

package/dist/src/monorepo/operations/resources/BuildResourcesOperation.js

@@ -1,3 +1,4 @@
+import { PRESET_TIMER, } from 'listr2';
 import * as z from 'zod';
 import { EMBCollection, findRunOrder, taskManagerFactory, } from '../../index.js';
 import { ResourceFactory, } from '../../resources/ResourceFactory.js';
@@ -63,6 +64,9 @@ export class BuildResourcesOperation extends AbstractOperation {
             rendererOptions: {
                 collapseSkips: true,
                 collapseSubtasks: true,
+                timer: {
+                    ...PRESET_TIMER,
+                },
             },
             ctx: {},
         });
@@ -84,35 +88,42 @@ export class BuildResourcesOperation extends AbstractOperation {
             },
             // Actual build
             {
-                title: `Build ${resource.id}`,
+                title: `Checking cache for ${resource.id}`,
                 /** Skip the build if the builder knows it can be skipped */
-                task: async (ctx, task) => {
+                task: async (ctx) => {
                     if (ctx.builder?.mustBuild) {
                         const previousSentinelData = await this.readSentinelFile(resource);
                         ctx.sentinelData =
                             await ctx.builder.mustBuild(previousSentinelData);
                         ctx.cacheHit = !ctx.sentinelData;
                     }
-                    if (!ctx.force && (ctx.dryRun || ctx.cacheHit)) {
-                        const prefix = ctx.dryRun ? '[dry run]' : '[cache hit]';
+                },
+            },
+            {
+                title: `Build image for ${resource.id}`,
+                async task(ctx, task) {
+                    const skip = (prefix) => {
                         parentTask.title = `${prefix} ${resource.id}`;
                         task.skip();
                         return parentTask.skip();
+                    };
+                    if (ctx.cacheHit && !ctx.force && !ctx.dryRun) {
+                        return skip('[cache hit]');
+                    }
+                    const { input, operation } = await ctx.builder.build(task.stdout());
+                    ctx.builderInput = input;
+                    if (ctx.dryRun) {
+                        return skip('[dry run]');
                     }
-                    return ctx.builder.operation.run(ctx.builder?.input);
+                    return operation.run(ctx.builderInput);
                 },
             },
             {
                 // Return build meta data and dump
                 // cache data into sentinel file
                 task: async (ctx) => {
-                    // TODO: clean this
-                    if (ctx.builder?.mustBuild) {
-                        delete ctx.builder.mustBuild;
-                    }
-                    if (ctx.builder?.operation) {
-                        // @ts-expect-error duynno
-                        delete ctx.builder.operation;
+                    if (ctx.builder) {
+                        delete ctx.builder;
                     }
                     //
                     parentContext[resource.id] = ctx;
@@ -140,7 +151,14 @@ export class BuildResourcesOperation extends AbstractOperation {
     }
     async readSentinelFile(resource) {
         const path = this.sentinelFilePath(resource);
+        const stats = await this.context.monorepo.store.stat(path, false);
+        if (!stats) {
+            return undefined;
+        }
         const data = await this.context.monorepo.store.readFile(path, false);
-        return data ? JSON.parse(data) : undefined;
+        return {
+            data,
+            mtime: stats.mtime.getTime(),
+        };
     }
 }

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

@@ -1,7 +1,7 @@
 import { getContext } from '../../../index.js';
-import { ContainerExecOperation } from '../../../docker/index.js';
+import { ComposeExecOperation } from '../../../docker/index.js';
 import { EMBCollection, findRunOrder, taskManagerFactory, } from '../../index.js';
-import { ExecuteLocalCommandOperation, GetComponentContainerOperation, } from '../index.js';
+import { ExecuteLocalCommandOperation } from '../index.js';
 export var ExecutorType;
 (function (ExecutorType) {
     ExecutorType["container"] = "container";
@@ -53,18 +53,17 @@ export class RunTasksOperation {
     }
     async runDocker(task, out) {
         const { monorepo } = getContext();
-        const containerInfo = await monorepo.run(new GetComponentContainerOperation(), task.component);
-        return monorepo.run(new ContainerExecOperation(out), {
+        return monorepo.run(new ComposeExecOperation(out), {
             attachStderr: true,
             attachStdout: true,
-            container: containerInfo.Id,
-            script: task.script,
+            service: task.component,
+            command: task.script,
         });
     }
     async runLocal(task) {
         const { monorepo } = getContext();
         const cwd = task.component
-            ? monorepo.component(task.component).rootDir
+            ? monorepo.join(monorepo.component(task.component).rootDir)
             : monorepo.rootDir;
         return monorepo.run(new ExecuteLocalCommandOperation(), {
             script: task.script,

package/dist/src/monorepo/resources/FileResource.js

@@ -2,12 +2,16 @@ import { CreateFileOperation } from '../index.js';
 import { ResourceFactory } from './ResourceFactory.js';
 // Bring better abstraction and register as part of the plugin initialization
 ResourceFactory.register('file', async ({ config, component }) => {
-    const fromConfig = (config.params || {});
-    const input = {
-        path: component.join(fromConfig?.path || config.name),
-    };
     return {
-        input,
-        operation: new CreateFileOperation(),
+        async build() {
+            const fromConfig = (config.params || {});
+            const input = {
+                path: component.join(fromConfig?.path || config.name),
+            };
+            return {
+                input,
+                operation: new CreateFileOperation(),
+            };
+        },
     };
 });

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

@@ -1,4 +1,5 @@
 import { Component, Monorepo, ResourceInfo } from '../../index.js';
+import { Writable } from 'node:stream';
 import { IOperation } from '../../operations/types.js';
 export type ResourceBuildContext = {
     config: ResourceInfo;
@@ -10,8 +11,18 @@ export type SentinelData<T = void> = {
     data: T;
 };
 export type ResourceBuilderInfo<I, O, D = unknown> = {
-    input: I;
-    operation: IOperation<I, O>;
+    /**
+     * Returns input and operation required to actually
+     * build the resources.
+     * This allows the dry-run mechanism to be implemented outside
+     * resource builder implementations
+     *
+     * @param out The Writable to use to write logs
+     */
+    build(out?: Writable): Promise<{
+        input: I;
+        operation: IOperation<I, O>;
+    }>;
     mustBuild?: (previousSentinelData: SentinelData<D> | undefined) => Promise<undefined | unknown>;
 };
 export type ResourceFactoryOutput<I, O> = Promise<ResourceBuilderInfo<I, O>>;

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

@@ -14,6 +14,7 @@ export declare class EMBStore {
     init(): Promise<void>;
     join(path: string): string;
     mkdirp(path: string): Promise<void>;
+    stat(path: string, mustExist?: boolean): Promise<import("fs").Stats | undefined>;
     readFile(path: string, mustExist?: boolean): Promise<string | undefined>;
     trash(): Promise<void>;
     writeFile(path: string, data: string): Promise<void>;

package/dist/src/monorepo/store/index.js

@@ -1,5 +1,5 @@
 import { constants, createReadStream, createWriteStream } from 'node:fs';
-import { access, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { access, mkdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
 import { dirname, join, normalize } from 'node:path';
 /**
  * A first implementation of a "store" where
@@ -54,6 +54,17 @@ export class EMBStore {
         const normalized = normalize(join('/', path));
         await mkdir(this.join(normalized), { recursive: true });
     }
+    async stat(path, mustExist = true) {
+        try {
+            return await stat(this.join(path));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT' && !mustExist) {
+                return;
+            }
+            throw error;
+        }
+    }
     async readFile(path, mustExist = true) {
         try {
             return (await readFile(this.join(path))).toString();

package/oclif.manifest.json

@@ -268,10 +268,12 @@
         "shell.js"
       ]
     },
-    "config:print": {
-      "aliases": [],
+    "containers": {
+      "aliases": [
+        "ps"
+      ],
       "args": {},
-      "description": "Print the current config.",
+      "description": "List docker containers.",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -283,21 +285,22 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "flavor": {
-          "description": "Specify the flavor to use.",
-          "name": "flavor",
+        "all": {
+          "char": "a",
+          "description": "Retun all containers. By default, only running containers are shown",
+          "name": "all",
           "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:print",
+      "id": "containers",
       "pluginAlias": "@enspirit/emb",
       "pluginName": "@enspirit/emb",
       "pluginType": "core",
+      "strict": true,
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -305,16 +308,14 @@
         "src",
         "cli",
         "commands",
-        "config",
-        "print.js"
+        "containers",
+        "index.js"
       ]
     },
-    "containers": {
-      "aliases": [
-        "ps"
-      ],
+    "containers:prune": {
+      "aliases": [],
       "args": {},
-      "description": "List docker containers.",
+      "description": "Prune containers.",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -325,19 +326,11 @@
           "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",
+      "id": "containers:prune",
       "pluginAlias": "@enspirit/emb",
       "pluginName": "@enspirit/emb",
       "pluginType": "core",
@@ -350,13 +343,13 @@
         "cli",
         "commands",
         "containers",
-        "index.js"
+        "prune.js"
       ]
     },
-    "containers:prune": {
+    "config:print": {
       "aliases": [],
       "args": {},
-      "description": "Prune containers.",
+      "description": "Print the current config.",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -367,15 +360,22 @@
           "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": "containers:prune",
+      "id": "config:print",
       "pluginAlias": "@enspirit/emb",
       "pluginName": "@enspirit/emb",
       "pluginType": "core",
-      "strict": true,
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -383,8 +383,8 @@
         "src",
         "cli",
         "commands",
-        "containers",
-        "prune.js"
+        "config",
+        "print.js"
       ]
     },
     "images:delete": {
@@ -520,12 +520,18 @@
         "prune.js"
       ]
     },
-    "tasks": {
+    "resources:build": {
       "aliases": [],
-      "args": {},
-      "description": "List tasks.",
+      "args": {
+        "component": {
+          "description": "List of resources to build (defaults to all)",
+          "name": "component",
+          "required": false
+        }
+      },
+      "description": "Build the resources of the monorepo",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %> build --flavor development"
       ],
       "flags": {
         "json": {
@@ -534,15 +540,38 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
+        },
+        "flavor": {
+          "description": "Specify the flavor to use.",
+          "name": "flavor",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "description": "Do not build the resources but only produce build meta information",
+          "name": "dry-run",
+          "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,
       "hiddenAliases": [],
-      "id": "tasks",
+      "id": "resources:build",
       "pluginAlias": "@enspirit/emb",
       "pluginName": "@enspirit/emb",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -550,20 +579,14 @@
         "src",
         "cli",
         "commands",
-        "tasks",
-        "index.js"
+        "resources",
+        "build.js"
       ]
     },
-    "tasks:run": {
+    "resources": {
       "aliases": [],
-      "args": {
-        "task": {
-          "description": "List of tasks to run. You can provide either ids or names (eg: component:task or task)",
-          "name": "task",
-          "required": true
-        }
-      },
-      "description": "Run tasks.",
+      "args": {},
+      "description": "List resources.",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -575,33 +598,21 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "executor": {
-          "char": "x",
-          "description": "Where to run the task. (experimental!)",
-          "name": "executor",
+        "flavor": {
+          "description": "Specify the flavor to use.",
+          "name": "flavor",
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "container",
-            "local"
-          ],
           "type": "option"
-        },
-        "all-matching": {
-          "char": "a",
-          "description": "Run all tasks matching (when multiple matches)",
-          "name": "all-matching",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tasks:run",
+      "id": "resources",
       "pluginAlias": "@enspirit/emb",
       "pluginName": "@enspirit/emb",
       "pluginType": "core",
-      "strict": false,
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -609,22 +620,16 @@
         "src",
         "cli",
         "commands",
-        "tasks",
-        "run.js"
+        "resources",
+        "index.js"
       ]
     },
-    "resources:build": {
+    "tasks": {
       "aliases": [],
-      "args": {
-        "component": {
-          "description": "List of resources to build (defaults to all)",
-          "name": "component",
-          "required": false
-        }
-      },
-      "description": "Build the resources of the monorepo",
+      "args": {},
+      "description": "List tasks.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> build --flavor development"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "json": {
@@ -633,38 +638,15 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        },
-        "flavor": {
-          "description": "Specify the flavor to use.",
-          "name": "flavor",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "dry-run": {
-          "description": "Do not build the resources but only produce build meta information",
-          "name": "dry-run",
-          "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,
       "hiddenAliases": [],
-      "id": "resources:build",
+      "id": "tasks",
       "pluginAlias": "@enspirit/emb",
       "pluginName": "@enspirit/emb",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -672,14 +654,20 @@
         "src",
         "cli",
         "commands",
-        "resources",
-        "build.js"
+        "tasks",
+        "index.js"
       ]
     },
-    "resources": {
+    "tasks:run": {
       "aliases": [],
-      "args": {},
-      "description": "List resources.",
+      "args": {
+        "task": {
+          "description": "List of tasks to run. You can provide either ids or names (eg: component:task or task)",
+          "name": "task",
+          "required": true
+        }
+      },
+      "description": "Run tasks.",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -691,21 +679,33 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "flavor": {
-          "description": "Specify the flavor to use.",
-          "name": "flavor",
-          "required": false,
+        "executor": {
+          "char": "x",
+          "description": "Where to run the task. (experimental!)",
+          "name": "executor",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "container",
+            "local"
+          ],
           "type": "option"
+        },
+        "all-matching": {
+          "char": "a",
+          "description": "Run all tasks matching (when multiple matches)",
+          "name": "all-matching",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "resources",
+      "id": "tasks:run",
       "pluginAlias": "@enspirit/emb",
       "pluginName": "@enspirit/emb",
       "pluginType": "core",
+      "strict": false,
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -713,10 +713,10 @@
         "src",
         "cli",
         "commands",
-        "resources",
-        "index.js"
+        "tasks",
+        "run.js"
       ]
     }
   },
-  "version": "0.2.0"
+  "version": "0.3.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@enspirit/emb",
   "type": "module",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "keywords": ["monorepo", "docker", "taskrunner", "ci", "docker compose", "sentinel", "makefile"],
   "author": "Louis Lambeau <louis.lambeau@enspirit.be>",
   "license": "ISC",
@@ -47,6 +47,7 @@
     "dotenv": "^17.2.1",
     "execa": "^9.6.0",
     "fast-json-patch": "^3.1.1",
+    "fdir": "^6.4.6",
     "find-up": "^7.0.0",
     "glob": "^11.0.3",
     "graphlib": "^2.1.8",