@enspirit/emb 0.17.5 → 0.18.0

package/README.md

@@ -14,7 +14,7 @@ $ npm install -g @enspirit/emb
 $ emb COMMAND
 running command...
 $ emb (--version)
-@enspirit/emb/0.17.5 darwin-arm64 node-v22.21.1
+@enspirit/emb/0.18.0 darwin-arm64 node-v22.21.1
 $ emb --help [COMMAND]
 USAGE
   $ emb COMMAND
@@ -42,6 +42,7 @@ USAGE
 * [`emb kubernetes restart [DEPLOYMENT]`](#emb-kubernetes-restart-deployment)
 * [`emb kubernetes shell COMPONENT`](#emb-kubernetes-shell-component)
 * [`emb logs [COMPONENT]`](#emb-logs-component)
+* [`emb logs archive [COMPONENT]`](#emb-logs-archive-component)
 * [`emb ps`](#emb-ps)
 * [`emb resources`](#emb-resources)
 * [`emb resources build [COMPONENT]`](#emb-resources-build-component)
@@ -112,7 +113,7 @@ EXAMPLES
   $ emb clean
 ```
 
-_See code: [src/commands/clean.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/clean.ts)_
+_See code: [src/commands/clean.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/clean.ts)_
 
 ## `emb components`
 
@@ -137,7 +138,7 @@ EXAMPLES
   $ emb components
 ```
 
-_See code: [src/commands/components/index.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/components/index.ts)_
+_See code: [src/commands/components/index.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/components/index.ts)_
 
 ## `emb components logs [COMPONENT]`
 
@@ -158,9 +159,6 @@ FLAGS
 DESCRIPTION
   Get components logs.
 
-ALIASES
-  $ emb logs
-
 EXAMPLES
   $ emb components logs
 
@@ -171,7 +169,7 @@ EXAMPLES
   $ emb components logs --no-follow backend
 ```
 
-_See code: [src/commands/components/logs.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/components/logs.ts)_
+_See code: [src/commands/components/logs.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/components/logs.ts)_
 
 ## `emb components shell COMPONENT`
 
@@ -199,7 +197,7 @@ EXAMPLES
   $ emb components shell
 ```
 
-_See code: [src/commands/components/shell.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/components/shell.ts)_
+_See code: [src/commands/components/shell.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/components/shell.ts)_
 
 ## `emb config print`
 
@@ -224,7 +222,7 @@ EXAMPLES
   $ emb config print
 ```
 
-_See code: [src/commands/config/print.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/config/print.ts)_
+_See code: [src/commands/config/print.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/config/print.ts)_
 
 ## `emb containers`
 
@@ -249,7 +247,7 @@ EXAMPLES
   $ emb containers
 ```
 
-_See code: [src/commands/containers/index.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/containers/index.ts)_
+_See code: [src/commands/containers/index.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/containers/index.ts)_
 
 ## `emb containers prune`
 
@@ -273,7 +271,7 @@ EXAMPLES
   $ emb containers prune
 ```
 
-_See code: [src/commands/containers/prune.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/containers/prune.ts)_
+_See code: [src/commands/containers/prune.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/containers/prune.ts)_
 
 ## `emb down`
 
@@ -298,7 +296,7 @@ EXAMPLES
   $ emb down
 ```
 
-_See code: [src/commands/down.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/down.ts)_
+_See code: [src/commands/down.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/down.ts)_
 
 ## `emb help [COMMAND]`
 
@@ -344,7 +342,7 @@ EXAMPLES
   $ emb images
 ```
 
-_See code: [src/commands/images/index.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/images/index.ts)_
+_See code: [src/commands/images/index.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/images/index.ts)_
 
 ## `emb images delete`
 
@@ -369,7 +367,7 @@ EXAMPLES
   $ emb images delete
 ```
 
-_See code: [src/commands/images/delete.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/images/delete.ts)_
+_See code: [src/commands/images/delete.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/images/delete.ts)_
 
 ## `emb images prune`
 
@@ -394,7 +392,7 @@ EXAMPLES
   $ emb images prune
 ```
 
-_See code: [src/commands/images/prune.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/images/prune.ts)_
+_See code: [src/commands/images/prune.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/images/prune.ts)_
 
 ## `emb images push`
 
@@ -423,7 +421,7 @@ EXAMPLES
   $ emb images push --registry my.registry.io --retag newtag
 ```
 
-_See code: [src/commands/images/push.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/images/push.ts)_
+_See code: [src/commands/images/push.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/images/push.ts)_
 
 ## `emb kubernetes logs COMPONENT`
 
@@ -445,14 +443,11 @@ FLAGS
 DESCRIPTION
   Follow kubernetes logs.
 
-ALIASES
-  $ emb logs
-
 EXAMPLES
   $ emb kubernetes logs
 ```
 
-_See code: [src/commands/kubernetes/logs.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/kubernetes/logs.ts)_
+_See code: [src/commands/kubernetes/logs.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/kubernetes/logs.ts)_
 
 ## `emb kubernetes ps`
 
@@ -475,7 +470,7 @@ EXAMPLES
   $ emb kubernetes ps
 ```
 
-_See code: [src/commands/kubernetes/ps.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/kubernetes/ps.ts)_
+_See code: [src/commands/kubernetes/ps.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/kubernetes/ps.ts)_
 
 ## `emb kubernetes restart [DEPLOYMENT]`
 
@@ -500,7 +495,7 @@ EXAMPLES
   $ emb kubernetes restart
 ```
 
-_See code: [src/commands/kubernetes/restart.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/kubernetes/restart.ts)_
+_See code: [src/commands/kubernetes/restart.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/kubernetes/restart.ts)_
 
 ## `emb kubernetes shell COMPONENT`
 
@@ -529,7 +524,7 @@ EXAMPLES
   $ emb kubernetes shell
 ```
 
-_See code: [src/commands/kubernetes/shell.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/kubernetes/shell.ts)_
+_See code: [src/commands/kubernetes/shell.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/kubernetes/shell.ts)_
 
 ## `emb logs [COMPONENT]`
 
@@ -550,9 +545,6 @@ FLAGS
 DESCRIPTION
   Get components logs.
 
-ALIASES
-  $ emb logs
-
 EXAMPLES
   $ emb logs
 
@@ -563,6 +555,44 @@ EXAMPLES
   $ emb logs --no-follow backend
 ```
 
+_See code: [src/commands/logs/index.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/logs/index.ts)_
+
+## `emb logs archive [COMPONENT]`
+
+Archive docker compose logs to files (one file per component).
+
+```
+USAGE
+  $ emb logs archive [COMPONENT...] [--json] [--verbose] [-C <value>] [-t] [--tail <value>] [-o <value>]
+
+ARGUMENTS
+  [COMPONENT...]  The component(s) to archive logs for (all if omitted)
+
+FLAGS
+  -C, --root=<value>    Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.
+  -o, --output=<value>  Output directory for log files (defaults to .emb/<flavor>/logs/docker/compose)
+  -t, --timestamps      Include timestamps in logs
+      --tail=<value>    Number of lines to show from the end of the logs
+  --[no-]verbose
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Archive docker compose logs to files (one file per component).
+
+EXAMPLES
+  $ emb logs archive
+
+  $ emb logs archive backend frontend
+
+  $ emb logs archive --timestamps
+
+  $ emb logs archive --tail 1000
+```
+
+_See code: [src/commands/logs/archive.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/logs/archive.ts)_
+
 ## `emb ps`
 
 Lists the containers running in the project.
@@ -584,7 +614,7 @@ EXAMPLES
   $ emb ps
 ```
 
-_See code: [src/commands/ps.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/ps.ts)_
+_See code: [src/commands/ps.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/ps.ts)_
 
 ## `emb resources`
 
@@ -609,7 +639,7 @@ EXAMPLES
   $ emb resources
 ```
 
-_See code: [src/commands/resources/index.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/resources/index.ts)_
+_See code: [src/commands/resources/index.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/resources/index.ts)_
 
 ## `emb resources build [COMPONENT]`
 
@@ -639,7 +669,7 @@ EXAMPLES
   $ emb resources build build --flavor development
 ```
 
-_See code: [src/commands/resources/build.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/resources/build.ts)_
+_See code: [src/commands/resources/build.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/resources/build.ts)_
 
 ## `emb restart [COMPONENT]`
 
@@ -667,7 +697,7 @@ EXAMPLES
   $ emb restart
 ```
 
-_See code: [src/commands/restart.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/restart.ts)_
+_See code: [src/commands/restart.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/restart.ts)_
 
 ## `emb run TASK`
 
@@ -725,7 +755,7 @@ EXAMPLES
   $ emb secrets --json
 ```
 
-_See code: [src/commands/secrets/index.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/secrets/index.ts)_
+_See code: [src/commands/secrets/index.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/secrets/index.ts)_
 
 ## `emb secrets providers`
 
@@ -750,7 +780,7 @@ EXAMPLES
   $ emb secrets providers
 ```
 
-_See code: [src/commands/secrets/providers.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/secrets/providers.ts)_
+_See code: [src/commands/secrets/providers.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/secrets/providers.ts)_
 
 ## `emb secrets validate`
 
@@ -780,7 +810,7 @@ EXAMPLES
   $ emb secrets validate --json
 ```
 
-_See code: [src/commands/secrets/validate.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/secrets/validate.ts)_
+_See code: [src/commands/secrets/validate.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/secrets/validate.ts)_
 
 ## `emb shell COMPONENT`
 
@@ -833,7 +863,7 @@ EXAMPLES
   $ emb start
 ```
 
-_See code: [src/commands/start.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/start.ts)_
+_See code: [src/commands/start.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/start.ts)_
 
 ## `emb stop`
 
@@ -858,7 +888,7 @@ EXAMPLES
   $ emb stop
 ```
 
-_See code: [src/commands/stop.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/stop.ts)_
+_See code: [src/commands/stop.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/stop.ts)_
 
 ## `emb tasks`
 
@@ -882,7 +912,7 @@ EXAMPLES
   $ emb tasks
 ```
 
-_See code: [src/commands/tasks/index.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/tasks/index.ts)_
+_See code: [src/commands/tasks/index.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/tasks/index.ts)_
 
 ## `emb tasks run TASK`
 
@@ -915,7 +945,7 @@ EXAMPLES
   $ emb tasks run
 ```
 
-_See code: [src/commands/tasks/run.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/tasks/run.ts)_
+_See code: [src/commands/tasks/run.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/tasks/run.ts)_
 
 ## `emb up [COMPONENT]`
 
@@ -944,7 +974,7 @@ EXAMPLES
   $ emb up
 ```
 
-_See code: [src/commands/up.ts](https://github.com/enspirit/emb/blob/v0.17.5/src/commands/up.ts)_
+_See code: [src/commands/up.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/up.ts)_
 
 ## `emb update [CHANNEL]`
 

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

@@ -1,6 +1,5 @@
 import { BaseCommand } from '../../index.js';
 export default class ComponentsLogs extends BaseCommand {
-    static aliases: string[];
     static description: string;
     static enableJsonFlag: boolean;
     static examples: string[];

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

@@ -2,7 +2,6 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand, getContext } from '../../index.js';
 import { ComposeLogsOperation } from '../../../docker/index.js';
 export default class ComponentsLogs extends BaseCommand {
-    static aliases = ['logs'];
     static description = 'Get components logs.';
     static enableJsonFlag = false;
     static examples = [

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

@@ -1,6 +1,5 @@
 import { KubernetesCommand } from '../../index.js';
 export default class KubernetesLogs extends KubernetesCommand {
-    static aliases: string[];
     static description: string;
     static enableJsonFlag: boolean;
     static examples: string[];

package/dist/src/cli/commands/kubernetes/logs.js

@@ -4,7 +4,6 @@ import { PassThrough } from 'node:stream';
 import { KubernetesCommand } from '../../index.js';
 import { GetDeploymentPodsOperation } from '../../../kubernetes/operations/GetDeploymentPodsOperation.js';
 export default class KubernetesLogs extends KubernetesCommand {
-    static aliases = ['logs'];
     static description = 'Follow kubernetes logs.';
     static enableJsonFlag = false;
     static examples = ['<%= config.bin %> <%= command.id %>'];

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

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../index.js';
+export default class LogsArchive extends BaseCommand {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static strict: boolean;
+    static flags: {
+        timestamps: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        tail: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static args: {
+        component: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/src/cli/commands/logs/archive.js

@@ -0,0 +1,59 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand, getContext } from '../../index.js';
+import { ComposeLogsArchiveOperation } from '../../../docker/index.js';
+export default class LogsArchive extends BaseCommand {
+    static description = 'Archive docker compose logs to files (one file per component).';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> backend frontend',
+        '<%= config.bin %> <%= command.id %> --timestamps',
+        '<%= config.bin %> <%= command.id %> --tail 1000',
+    ];
+    static strict = false;
+    static flags = {
+        timestamps: Flags.boolean({
+            char: 't',
+            description: 'Include timestamps in logs',
+            default: false,
+        }),
+        tail: Flags.integer({
+            description: 'Number of lines to show from the end of the logs',
+        }),
+        output: Flags.string({
+            char: 'o',
+            description: 'Output directory for log files (defaults to .emb/<flavor>/logs/docker/compose)',
+        }),
+    };
+    static args = {
+        component: Args.string({
+            name: 'component',
+            description: 'The component(s) to archive logs for (all if omitted)',
+            required: false,
+        }),
+    };
+    async run() {
+        const { flags, argv } = await this.parse(LogsArchive);
+        const { monorepo } = await getContext();
+        const componentNames = argv;
+        // Validate that all specified components exist
+        if (componentNames.length > 0) {
+            componentNames.forEach((name) => monorepo.component(name));
+        }
+        const result = await monorepo.run(new ComposeLogsArchiveOperation(), {
+            components: componentNames.length > 0 ? componentNames : undefined,
+            outputDir: flags.output,
+            timestamps: flags.timestamps,
+            tail: flags.tail,
+        });
+        if (this.jsonEnabled()) {
+            this.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            this.log('Archived logs:');
+            for (const file of result) {
+                this.log(`  ${file.component}: ${file.path}`);
+            }
+        }
+    }
+}

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

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../index.js';
+export default class Logs 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 | undefined, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,44 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand, getContext } from '../../index.js';
+import { ComposeLogsOperation } from '../../../docker/index.js';
+export default class Logs extends BaseCommand {
+    static description = 'Get components logs.';
+    static enableJsonFlag = false;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> backend',
+        '<%= config.bin %> <%= command.id %> backend frontend',
+        '<%= config.bin %> <%= command.id %> --no-follow backend',
+    ];
+    static strict = false;
+    static flags = {
+        follow: Flags.boolean({
+            name: 'follow',
+            char: 'f',
+            allowNo: true,
+            description: 'Follow log output',
+            default: true,
+        }),
+    };
+    static args = {
+        component: Args.string({
+            name: 'component',
+            description: 'The component(s) you want to see the logs of (all if omitted)',
+            required: false,
+        }),
+    };
+    async run() {
+        const { flags, argv } = await this.parse(Logs);
+        const { monorepo } = await getContext();
+        const componentNames = argv;
+        // Validate that all specified components exist
+        const services = componentNames.map((name) => {
+            const component = monorepo.component(name);
+            return component.name;
+        });
+        await monorepo.run(new ComposeLogsOperation(), {
+            services: services.length > 0 ? services : undefined,
+            follow: flags.follow,
+        });
+    }
+}

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

@@ -0,0 +1,17 @@
+import * as z from 'zod';
+import { AbstractOperation } from '../../../operations/index.js';
+export declare const ComposeLogsArchiveOperationInputSchema: z.ZodOptional<z.ZodObject<{
+    components: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    outputDir: z.ZodOptional<z.ZodString>;
+    timestamps: z.ZodOptional<z.ZodBoolean>;
+    tail: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+export interface ArchivedLogFile {
+    component: string;
+    path: string;
+}
+export declare class ComposeLogsArchiveOperation extends AbstractOperation<typeof ComposeLogsArchiveOperationInputSchema, ArchivedLogFile[]> {
+    constructor();
+    protected _run(input: z.input<typeof ComposeLogsArchiveOperationInputSchema>): Promise<ArchivedLogFile[]>;
+    private archiveComponentLogs;
+}

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

@@ -0,0 +1,77 @@
+import { spawn } from 'node:child_process';
+import { createWriteStream } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import * as z from 'zod';
+import { AbstractOperation } from '../../../operations/index.js';
+export const ComposeLogsArchiveOperationInputSchema = z
+    .object({
+    components: z
+        .array(z.string())
+        .optional()
+        .describe('The list of components to archive logs for (all if omitted)'),
+    outputDir: z
+        .string()
+        .optional()
+        .describe('Output directory for log files (defaults to .emb/<flavor>/logs/docker/compose)'),
+    timestamps: z.boolean().optional().describe('Include timestamps in logs'),
+    tail: z
+        .number()
+        .optional()
+        .describe('Number of lines to show from the end'),
+})
+    .optional();
+export class ComposeLogsArchiveOperation extends AbstractOperation {
+    constructor() {
+        super(ComposeLogsArchiveOperationInputSchema);
+    }
+    async _run(input) {
+        const { monorepo } = this.context;
+        // Determine which components to archive
+        const componentNames = input?.components ?? monorepo.components.map((c) => c.name);
+        // Validate all component names
+        const components = componentNames.map((name) => monorepo.component(name));
+        // Determine output directory
+        const outputDir = input?.outputDir ?? monorepo.store.join('logs/docker/compose');
+        // Ensure output directory exists
+        await mkdir(outputDir, { recursive: true });
+        // Archive logs for each component
+        const archivePromises = components.map(async (component) => {
+            const logPath = join(outputDir, `${component.name}.log`);
+            await this.archiveComponentLogs(component.name, logPath, input);
+            return { component: component.name, path: logPath };
+        });
+        return Promise.all(archivePromises);
+    }
+    async archiveComponentLogs(serviceName, outputPath, input) {
+        const { monorepo } = this.context;
+        // Ensure parent directory exists
+        await mkdir(dirname(outputPath), { recursive: true });
+        const cmd = 'docker';
+        const args = ['compose', 'logs', '--no-color'];
+        if (input?.timestamps) {
+            args.push('-t');
+        }
+        if (input?.tail !== undefined) {
+            args.push('--tail', String(input.tail));
+        }
+        args.push(serviceName);
+        return new Promise((resolve, reject) => {
+            const writeStream = createWriteStream(outputPath);
+            const child = spawn(cmd, args, {
+                stdio: ['ignore', 'pipe', 'pipe'],
+                cwd: monorepo.rootDir,
+            });
+            child.stdout?.pipe(writeStream, { end: false });
+            child.stderr?.pipe(writeStream, { end: false });
+            child.on('error', (err) => {
+                writeStream.end();
+                reject(new Error(`Failed to get logs for ${serviceName}: ${err.message}`));
+            });
+            child.on('exit', () => {
+                writeStream.end();
+                resolve();
+            });
+        });
+    }
+}

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

@@ -1,6 +1,7 @@
 export * from './ComposeDownOperation.js';
 export * from './ComposeExecOperation.js';
 export * from './ComposeExecShellOperation.js';
+export * from './ComposeLogsArchiveOperation.js';
 export * from './ComposeLogsOperation.js';
 export * from './ComposePsOperation.js';
 export * from './ComposeRestartOperation.js';

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

@@ -1,6 +1,7 @@
 export * from './ComposeDownOperation.js';
 export * from './ComposeExecOperation.js';
 export * from './ComposeExecShellOperation.js';
+export * from './ComposeLogsArchiveOperation.js';
 export * from './ComposeLogsOperation.js';
 export * from './ComposePsOperation.js';
 export * from './ComposeRestartOperation.js';

package/oclif.manifest.json

@@ -454,9 +454,7 @@
       ]
     },
     "components:logs": {
-      "aliases": [
-        "logs"
-      ],
+      "aliases": [],
       "args": {
         "component": {
           "description": "The component(s) you want to see the logs of (all if omitted)",
@@ -978,9 +976,7 @@
       ]
     },
     "kubernetes:logs": {
-      "aliases": [
-        "logs"
-      ],
+      "aliases": [],
       "args": {
         "component": {
           "description": "The component you want to see the logs of",
@@ -1235,13 +1231,21 @@
         "shell.js"
       ]
     },
-    "secrets": {
+    "logs:archive": {
       "aliases": [],
-      "args": {},
-      "description": "List all secret references in the configuration.",
+      "args": {
+        "component": {
+          "description": "The component(s) to archive logs for (all if omitted)",
+          "name": "component",
+          "required": false
+        }
+      },
+      "description": "Archive docker compose logs to files (one file per component).",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --json"
+        "<%= config.bin %> <%= command.id %> backend frontend",
+        "<%= config.bin %> <%= command.id %> --timestamps",
+        "<%= config.bin %> <%= command.id %> --tail 1000"
       ],
       "flags": {
         "json": {
@@ -1265,66 +1269,24 @@
           "multiple": false,
           "type": "option"
         },
-        "flavor": {
-          "description": "Specify the flavor to use.",
-          "name": "flavor",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "secrets",
-      "pluginAlias": "@enspirit/emb",
-      "pluginName": "@enspirit/emb",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "src",
-        "cli",
-        "commands",
-        "secrets",
-        "index.js"
-      ]
-    },
-    "secrets:providers": {
-      "aliases": [],
-      "args": {},
-      "description": "Show configured secret providers and their status.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
+        "timestamps": {
+          "char": "t",
+          "description": "Include timestamps in logs",
+          "name": "timestamps",
           "allowNo": false,
           "type": "boolean"
         },
-        "verbose": {
-          "name": "verbose",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "root": {
-          "char": "C",
-          "description": "Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.",
-          "name": "root",
-          "required": false,
+        "tail": {
+          "description": "Number of lines to show from the end of the logs",
+          "name": "tail",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "flavor": {
-          "description": "Specify the flavor to use.",
-          "name": "flavor",
-          "required": false,
+        "output": {
+          "char": "o",
+          "description": "Output directory for log files (defaults to .emb/<flavor>/logs/docker/compose)",
+          "name": "output",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1332,11 +1294,11 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "secrets:providers",
+      "id": "logs:archive",
       "pluginAlias": "@enspirit/emb",
       "pluginName": "@enspirit/emb",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -1344,27 +1306,27 @@
         "src",
         "cli",
         "commands",
-        "secrets",
-        "providers.js"
+        "logs",
+        "archive.js"
       ]
     },
-    "secrets:validate": {
+    "logs": {
       "aliases": [],
-      "args": {},
-      "description": "Validate that all secret references can be resolved (without showing values).",
+      "args": {
+        "component": {
+          "description": "The component(s) you want to see the logs of (all if omitted)",
+          "name": "component",
+          "required": false
+        }
+      },
+      "description": "Get components logs.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --fail-fast",
-        "<%= config.bin %> <%= command.id %> --json"
+        "<%= config.bin %> <%= command.id %> backend",
+        "<%= config.bin %> <%= command.id %> backend frontend",
+        "<%= config.bin %> <%= command.id %> --no-follow backend"
       ],
       "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "verbose": {
           "name": "verbose",
           "allowNo": true,
@@ -1379,37 +1341,30 @@
           "multiple": false,
           "type": "option"
         },
-        "flavor": {
-          "description": "Specify the flavor to use.",
-          "name": "flavor",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "fail-fast": {
-          "description": "Stop on first validation error",
-          "name": "fail-fast",
-          "allowNo": false,
+        "follow": {
+          "char": "f",
+          "description": "Follow log output",
+          "name": "follow",
+          "allowNo": true,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "secrets:validate",
+      "id": "logs",
       "pluginAlias": "@enspirit/emb",
       "pluginName": "@enspirit/emb",
       "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
+      "strict": false,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "src",
         "cli",
         "commands",
-        "secrets",
-        "validate.js"
+        "logs",
+        "index.js"
       ]
     },
     "resources:build": {
@@ -1667,7 +1622,184 @@
         "tasks",
         "run.js"
       ]
+    },
+    "secrets": {
+      "aliases": [],
+      "args": {},
+      "description": "List all secret references in the configuration.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "name": "verbose",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "root": {
+          "char": "C",
+          "description": "Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.",
+          "name": "root",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "flavor": {
+          "description": "Specify the flavor to use.",
+          "name": "flavor",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "secrets",
+      "pluginAlias": "@enspirit/emb",
+      "pluginName": "@enspirit/emb",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "src",
+        "cli",
+        "commands",
+        "secrets",
+        "index.js"
+      ]
+    },
+    "secrets:providers": {
+      "aliases": [],
+      "args": {},
+      "description": "Show configured secret providers and their status.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "name": "verbose",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "root": {
+          "char": "C",
+          "description": "Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.",
+          "name": "root",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "flavor": {
+          "description": "Specify the flavor to use.",
+          "name": "flavor",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "secrets:providers",
+      "pluginAlias": "@enspirit/emb",
+      "pluginName": "@enspirit/emb",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "src",
+        "cli",
+        "commands",
+        "secrets",
+        "providers.js"
+      ]
+    },
+    "secrets:validate": {
+      "aliases": [],
+      "args": {},
+      "description": "Validate that all secret references can be resolved (without showing values).",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --fail-fast",
+        "<%= config.bin %> <%= command.id %> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "name": "verbose",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "root": {
+          "char": "C",
+          "description": "Run as if emb was started in <path>. Can also be set via EMB_ROOT env var.",
+          "name": "root",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "flavor": {
+          "description": "Specify the flavor to use.",
+          "name": "flavor",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "fail-fast": {
+          "description": "Stop on first validation error",
+          "name": "fail-fast",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "secrets:validate",
+      "pluginAlias": "@enspirit/emb",
+      "pluginName": "@enspirit/emb",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "src",
+        "cli",
+        "commands",
+        "secrets",
+        "validate.js"
+      ]
     }
   },
-  "version": "0.17.5"
+  "version": "0.18.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@enspirit/emb",
   "type": "module",
-  "version": "0.17.5",
+  "version": "0.18.0",
   "keywords": [
     "monorepo",
     "docker",