@enspirit/emb 0.17.0 → 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.0 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,6 +113,8 @@ EXAMPLES
   $ emb clean
 ```
 
+_See code: [src/commands/clean.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/clean.ts)_
+
 ## `emb components`
 
 List components.
@@ -135,6 +138,8 @@ EXAMPLES
   $ emb components
 ```
 
+_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]`
 
 Get components logs.
@@ -154,9 +159,6 @@ FLAGS
 DESCRIPTION
   Get components logs.
 
-ALIASES
-  $ emb logs
-
 EXAMPLES
   $ emb components logs
 
@@ -167,6 +169,8 @@ EXAMPLES
   $ emb components logs --no-follow backend
 ```
 
+_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`
 
 Get a shell on a running component.
@@ -193,6 +197,8 @@ EXAMPLES
   $ emb components shell
 ```
 
+_See code: [src/commands/components/shell.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/components/shell.ts)_
+
 ## `emb config print`
 
 Print the current config.
@@ -216,6 +222,8 @@ EXAMPLES
   $ emb config print
 ```
 
+_See code: [src/commands/config/print.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/config/print.ts)_
+
 ## `emb containers`
 
 List docker containers.
@@ -239,6 +247,8 @@ EXAMPLES
   $ emb containers
 ```
 
+_See code: [src/commands/containers/index.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/containers/index.ts)_
+
 ## `emb containers prune`
 
 Prune containers.
@@ -261,6 +271,8 @@ EXAMPLES
   $ emb containers prune
 ```
 
+_See code: [src/commands/containers/prune.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/containers/prune.ts)_
+
 ## `emb down`
 
 Stop the whole project.
@@ -284,6 +296,8 @@ EXAMPLES
   $ emb down
 ```
 
+_See code: [src/commands/down.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/down.ts)_
+
 ## `emb help [COMMAND]`
 
 Display help for emb.
@@ -328,6 +342,8 @@ EXAMPLES
   $ emb images
 ```
 
+_See code: [src/commands/images/index.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/images/index.ts)_
+
 ## `emb images delete`
 
 Delete project images.
@@ -351,6 +367,8 @@ EXAMPLES
   $ emb images delete
 ```
 
+_See code: [src/commands/images/delete.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/images/delete.ts)_
+
 ## `emb images prune`
 
 Prune project images.
@@ -374,6 +392,8 @@ EXAMPLES
   $ emb images prune
 ```
 
+_See code: [src/commands/images/prune.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/images/prune.ts)_
+
 ## `emb images push`
 
 Push docker images.
@@ -401,6 +421,8 @@ EXAMPLES
   $ emb images push --registry my.registry.io --retag newtag
 ```
 
+_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`
 
 Follow kubernetes logs.
@@ -421,13 +443,12 @@ 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.18.0/src/commands/kubernetes/logs.ts)_
+
 ## `emb kubernetes ps`
 
 Show running pods.
@@ -449,6 +470,8 @@ EXAMPLES
   $ emb kubernetes ps
 ```
 
+_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]`
 
 Restart pods of an instance.
@@ -472,6 +495,8 @@ EXAMPLES
   $ emb kubernetes restart
 ```
 
+_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`
 
 Get a shell on a deployed component.
@@ -499,6 +524,8 @@ EXAMPLES
   $ emb kubernetes shell
 ```
 
+_See code: [src/commands/kubernetes/shell.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/kubernetes/shell.ts)_
+
 ## `emb logs [COMPONENT]`
 
 Get components logs.
@@ -518,9 +545,6 @@ FLAGS
 DESCRIPTION
   Get components logs.
 
-ALIASES
-  $ emb logs
-
 EXAMPLES
   $ emb logs
 
@@ -531,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.
@@ -552,6 +614,8 @@ EXAMPLES
   $ emb ps
 ```
 
+_See code: [src/commands/ps.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/ps.ts)_
+
 ## `emb resources`
 
 List resources.
@@ -575,6 +639,8 @@ EXAMPLES
   $ emb resources
 ```
 
+_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]`
 
 Build the resources of the monorepo
@@ -603,6 +669,8 @@ EXAMPLES
   $ emb resources build build --flavor development
 ```
 
+_See code: [src/commands/resources/build.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/resources/build.ts)_
+
 ## `emb restart [COMPONENT]`
 
 Restart the whole project.
@@ -629,6 +697,8 @@ EXAMPLES
   $ emb restart
 ```
 
+_See code: [src/commands/restart.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/restart.ts)_
+
 ## `emb run TASK`
 
 Run tasks.
@@ -685,6 +755,8 @@ EXAMPLES
   $ emb secrets --json
 ```
 
+_See code: [src/commands/secrets/index.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/secrets/index.ts)_
+
 ## `emb secrets providers`
 
 Show configured secret providers and their status.
@@ -708,6 +780,8 @@ EXAMPLES
   $ emb secrets providers
 ```
 
+_See code: [src/commands/secrets/providers.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/secrets/providers.ts)_
+
 ## `emb secrets validate`
 
 Validate that all secret references can be resolved (without showing values).
@@ -736,6 +810,8 @@ EXAMPLES
   $ emb secrets validate --json
 ```
 
+_See code: [src/commands/secrets/validate.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/secrets/validate.ts)_
+
 ## `emb shell COMPONENT`
 
 Get a shell on a running component.
@@ -787,6 +863,8 @@ EXAMPLES
   $ emb start
 ```
 
+_See code: [src/commands/start.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/start.ts)_
+
 ## `emb stop`
 
 Stop the whole project.
@@ -810,6 +888,8 @@ EXAMPLES
   $ emb stop
 ```
 
+_See code: [src/commands/stop.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/stop.ts)_
+
 ## `emb tasks`
 
 List tasks.
@@ -832,6 +912,8 @@ EXAMPLES
   $ emb tasks
 ```
 
+_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`
 
 Run tasks.
@@ -863,6 +945,8 @@ EXAMPLES
   $ emb tasks run
 ```
 
+_See code: [src/commands/tasks/run.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/tasks/run.ts)_
+
 ## `emb up [COMPONENT]`
 
 Start the whole project.
@@ -890,6 +974,8 @@ EXAMPLES
   $ emb up
 ```
 
+_See code: [src/commands/up.ts](https://github.com/enspirit/emb/blob/v0.18.0/src/commands/up.ts)_
+
 ## `emb update [CHANNEL]`
 
 update the emb CLI

package/bin/release

@@ -0,0 +1,122 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+error() {
+  echo -e "${RED}Error: $1${NC}" >&2
+  exit 1
+}
+
+info() {
+  echo -e "${GREEN}$1${NC}"
+}
+
+warn() {
+  echo -e "${YELLOW}$1${NC}"
+}
+
+# Check argument
+if [ $# -ne 1 ]; then
+  echo "Usage: $0 <patch|minor|major>"
+  echo ""
+  echo "Examples:"
+  echo "  $0 patch   # 0.17.0 -> 0.17.1"
+  echo "  $0 minor   # 0.17.0 -> 0.18.0"
+  echo "  $0 major   # 0.17.0 -> 1.0.0"
+  exit 1
+fi
+
+BUMP_TYPE="$1"
+
+if [[ "$BUMP_TYPE" != "patch" && "$BUMP_TYPE" != "minor" && "$BUMP_TYPE" != "major" ]]; then
+  error "Invalid bump type: $BUMP_TYPE. Must be one of: patch, minor, major"
+fi
+
+# Check we're on master branch
+CURRENT_BRANCH=$(git branch --show-current)
+if [ "$CURRENT_BRANCH" != "master" ]; then
+  error "Must be on master branch (currently on: $CURRENT_BRANCH)"
+fi
+
+# Check for pristine git status
+if [ -n "$(git status --porcelain)" ]; then
+  error "Working directory is not clean. Commit or stash your changes first.\n$(git status --short)"
+fi
+
+# Check we're up to date with remote
+git fetch origin master --quiet
+LOCAL=$(git rev-parse HEAD)
+REMOTE=$(git rev-parse origin/master)
+if [ "$LOCAL" != "$REMOTE" ]; then
+  error "Local master is not up to date with origin/master. Run 'git pull' first."
+fi
+
+# Get current version
+CURRENT_VERSION=$(node -p "require('./package.json').version")
+info "Current version: $CURRENT_VERSION"
+
+# Calculate new version
+IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT_VERSION"
+
+case "$BUMP_TYPE" in
+  major)
+    NEW_VERSION="$((MAJOR + 1)).0.0"
+    ;;
+  minor)
+    NEW_VERSION="${MAJOR}.$((MINOR + 1)).0"
+    ;;
+  patch)
+    NEW_VERSION="${MAJOR}.${MINOR}.$((PATCH + 1))"
+    ;;
+esac
+
+info "New version: $NEW_VERSION"
+
+# Check tag doesn't already exist
+if git rev-parse "$NEW_VERSION" >/dev/null 2>&1; then
+  error "Tag $NEW_VERSION already exists"
+fi
+
+# Confirm with user
+echo ""
+warn "This will:"
+echo "  1. Update package.json version to $NEW_VERSION"
+echo "  2. Commit the change"
+echo "  3. Create tag $NEW_VERSION"
+echo "  4. Push to origin (commit + tag)"
+echo ""
+read -p "Continue? [y/N] " -n 1 -r
+echo ""
+
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+  echo "Aborted."
+  exit 0
+fi
+
+# Update package.json version
+info "Updating package.json..."
+npm version "$NEW_VERSION" --no-git-tag-version --allow-same-version
+
+# Commit
+info "Committing..."
+git add package.json
+git commit -m "Bump to $NEW_VERSION"
+
+# Create tag
+info "Creating tag $NEW_VERSION..."
+git tag "$NEW_VERSION"
+
+# Push
+info "Pushing to origin..."
+git push origin master
+git push origin "$NEW_VERSION"
+
+echo ""
+info "Release $NEW_VERSION complete!"
+echo "GitHub Actions will now build, test, and publish to npm."
+echo "Monitor the release at: https://github.com/enspirit/emb/actions"

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/cli/commands/tasks/run.js

@@ -1,4 +1,4 @@
-import { AmbiguousReferenceError, getContext, UnkownReferenceError } from '../../../index.js';
+import { AmbiguousReferenceError, CommandExecError, getContext, UnkownReferenceError, } from '../../../index.js';
 import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../index.js';
 import { ExecutorType, RunTasksOperation } from '../../../monorepo/index.js';
@@ -51,6 +51,11 @@ export default class RunTask extends BaseCommand {
                     `Check the list of tasks available by running: \`emb tasks\``,
                 ]);
             }
+            if (error instanceof CommandExecError) {
+                throw error.toCliError([
+                    `Task command exited with code ${error.exitCode}`,
+                ]);
+            }
             throw error;
         }
     }

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;
+}