@jahia/jahia-cli 0.1.4 → 0.3.0

package/dist/commands/tests/run.js

@@ -0,0 +1,166 @@
+import { resolve } from 'node:path';
+import { Command, Flags } from '@oclif/core';
+import { execa } from 'execa';
+import { applyEnvInjections, getComponent, resolveComponent } from '../../lib/components/index.js';
+import { loadConfigFile } from '../../lib/config/parser.js';
+import { buildRunArgs, containerName, removeContainer } from '../../lib/providers/docker/container.js';
+import { getActiveEnvironment } from '../../lib/state/get-active-environment.js';
+import { stateFilePath } from '../../lib/state/state-file-path.js';
+import { stateFlag } from '../../lib/state/state-flag.js';
+import { DEFAULT_IMAGE_NAME, parseKeyValueArgs } from '../../lib/tests/build-image.js';
+/**
+ * Formats a human-readable test run start message.
+ */
+export const formatRunStart = (image, network, name) => [
+    `▶ Running tests`,
+    `  Image:     ${image}`,
+    `  Network:   ${network}`,
+    `  Container: ${name}`,
+    '',
+].join('\n');
+/**
+ * Formats a human-readable test completion message.
+ */
+export const formatRunComplete = (name, exitCode) => {
+    const icon = exitCode === 0 ? '✓' : '✗';
+    const status = exitCode === 0 ? 'passed' : `failed (exit code ${String(exitCode)})`;
+    return `${icon} Tests ${status}\n  Container "${name}" kept for inspection`;
+};
+/**
+ * Builds a ResolvedComponent for the cypress test runner using the component registry.
+ * Reads image/tag from tests.container config and applies env injections from sibling components.
+ */
+export const buildCypressComponent = (envComponents, containerConfig, scaffoldingVersion, extraEnv) => {
+    const definition = getComponent('cypress');
+    if (definition === undefined) {
+        throw new Error('cypress component not found in registry');
+    }
+    const imageOverride = containerConfig?.image ?? DEFAULT_IMAGE_NAME;
+    const tagOverride = containerConfig?.tag ?? scaffoldingVersion ?? 'latest';
+    const resolved = resolveComponent(definition, {
+        image: `${imageOverride}:${tagOverride}`,
+        env: extraEnv,
+    });
+    // Build sibling components (from persisted env) to apply envInjections
+    const siblings = envComponents
+        .map((name) => {
+        const def = getComponent(name);
+        return def !== undefined ? resolveComponent(def) : undefined;
+    })
+        .filter((c) => c !== undefined);
+    const allComponents = [...siblings, resolved];
+    const injected = applyEnvInjections(allComponents);
+    // Return the cypress component with injections applied
+    const cypressResult = injected[injected.length - 1];
+    if (cypressResult === undefined) {
+        throw new Error('Failed to resolve cypress component after env injection');
+    }
+    return cypressResult;
+};
+export default class TestsRun extends Command {
+    static description = 'Run the test Docker image against an active environment. ' +
+        'The container attaches to the environment network, streams output in real-time, ' +
+        'and the CLI exits with the container exit code. Container is kept after completion for debugging.';
+    static examples = [
+        '<%= config.bin %> tests run -c config.yml',
+        '<%= config.bin %> tests run -c config.yml --env CYPRESS_SPEC=cypress/e2e/login.cy.ts',
+        '<%= config.bin %> tests run -c config.yml --state /ci/workspace/state.json --json',
+    ];
+    static flags = {
+        config: Flags.string({
+            char: 'c',
+            description: 'Path to jahia-cli config file',
+            required: true,
+        }),
+        state: stateFlag,
+        env: Flags.string({
+            char: 'e',
+            description: 'Additional env var for test container (KEY=VALUE, repeatable). Supports ${VAR:-default}.',
+            multiple: true,
+        }),
+        json: Flags.boolean({
+            description: 'Output result as structured JSON',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(TestsRun);
+        const statePath = stateFilePath(flags.state);
+        try {
+            const activeEnv = await getActiveEnvironment(statePath);
+            if (activeEnv === undefined) {
+                throw new Error('No active environment found. Create one with "environment create" first.');
+            }
+            if (activeEnv.provider !== 'docker') {
+                throw new Error(`tests run requires a Docker environment. Current provider: ${activeEnv.provider}`);
+            }
+            const config = await loadConfigFile(resolve(flags.config));
+            const containerConfig = config.tests?.container;
+            const userEnv = flags.env !== undefined
+                ? parseKeyValueArgs(flags.env)
+                : {};
+            const component = buildCypressComponent(activeEnv.components.map((c) => c.name), containerConfig, config.tests?.scaffolding?.version, userEnv);
+            const imageRef = `${component.effectiveImage}:${component.effectiveTag}`;
+            const name = containerName(activeEnv.name, 'cypress');
+            const args = buildRunArgs({
+                envName: activeEnv.name,
+                componentName: component.definition.name,
+                image: component.effectiveImage,
+                tag: component.effectiveTag,
+                networkName: activeEnv.network,
+                ports: component.effectivePorts,
+                env: component.effectiveEnv,
+                volumes: component.definition.volumes,
+                networkAliases: component.definition.networkAliases,
+                detached: false,
+            });
+            if (!flags.json) {
+                this.log(formatRunStart(imageRef, activeEnv.network, name));
+            }
+            // Remove any leftover container from a previous run
+            await removeContainer(name);
+            const result = await execa('docker', [...args], {
+                stdio: 'inherit',
+                reject: false,
+            });
+            const exitCode = result.exitCode ?? 1;
+            if (flags.json) {
+                this.log(JSON.stringify({
+                    success: exitCode === 0,
+                    exitCode,
+                    container: name,
+                    image: imageRef,
+                    network: activeEnv.network,
+                }, null, 2));
+            }
+            else {
+                this.log(formatRunComplete(name, exitCode));
+            }
+            if (exitCode !== 0) {
+                this.exit(exitCode);
+            }
+        }
+        catch (error) {
+            if (isExecaError(error)) {
+                const exitCode = error.exitCode ?? 1;
+                if (!flags.json) {
+                    this.log(formatRunComplete('unknown', exitCode));
+                }
+                this.exit(exitCode);
+                return;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            if (flags.json) {
+                this.log(JSON.stringify({ success: false, error: message }, null, 2));
+            }
+            else {
+                this.error(message);
+            }
+        }
+    }
+}
+/**
+ * Type guard for ExecaError (has exitCode property).
+ */
+const isExecaError = (error) => error instanceof Error && 'exitCode' in error;
+//# sourceMappingURL=run.js.map

package/dist/commands/tests/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/commands/tests/run.ts"],"names":[],"mappings":"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"}

package/dist/commands/workflow/init.d.ts

@@ -0,0 +1,21 @@
+import { Command } from '@oclif/core';
+import type { JahiaCliConfig } from '../../lib/config/types.js';
+/**
+ * Loads an existing config file if it exists, returning an empty config if not found.
+ */
+export declare const loadExistingConfigForWorkflow: (filePath: string) => Promise<JahiaCliConfig>;
+/**
+ * Builds a human-readable success message for the workflow init command.
+ */
+export declare const buildWorkflowInitSuccessMessage: (outputPath: string) => string;
+export default class WorkflowInit extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        config: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/workflow/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/init.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAK7C,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,2BAA2B,CAAC;AAM3E;;GAEG;AACH,eAAO,MAAM,6BAA6B,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,cAAc,CAQ5F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,+BAA+B,GAAI,YAAY,MAAM,KAAG,MAGlB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,OAAO;IAC/C,OAAgB,WAAW,SAI4B;IAEvD,OAAgB,QAAQ,WAKtB;IAEF,OAAgB,KAAK;;;;MAenB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAoClC"}

package/dist/commands/workflow/init.js

@@ -0,0 +1,84 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { Command, Flags } from '@oclif/core';
+import yaml from 'js-yaml';
+import { configToYaml } from '../../lib/config/config-to-yaml.js';
+import { validateConfig } from '../../lib/config/parser.js';
+import { buildSampleWorkflows } from '../../lib/workflow/build-sample-workflow.js';
+import { mergeWorkflowsIntoConfig } from '../../lib/workflow/merge-workflow-into-config.js';
+const DEFAULT_CONFIG_FILE = 'jahia-cli.config.yml';
+/**
+ * Loads an existing config file if it exists, returning an empty config if not found.
+ */
+export const loadExistingConfigForWorkflow = async (filePath) => {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        const raw = yaml.load(content);
+        return validateConfig(raw);
+    }
+    catch {
+        return {};
+    }
+};
+/**
+ * Builds a human-readable success message for the workflow init command.
+ */
+export const buildWorkflowInitSuccessMessage = (outputPath) => `✓ Sample workflows added to ${outputPath}\n\n` +
+    '  Edit the workflow steps to match your needs, then run:\n' +
+    `  jahia-cli workflow run --config ${outputPath}`;
+export default class WorkflowInit extends Command {
+    static description = 'Add sample workflows section to a configuration file. ' +
+        'Generates a named "main" workflow with representative steps ' +
+        '(init, create, alive, test, cleanup) to help get started. ' +
+        'Preserves existing environment and tests sections.';
+    static examples = [
+        '<%= config.bin %> workflow init',
+        '<%= config.bin %> workflow init --config ./my-config.yml',
+        '<%= config.bin %> workflow init --force',
+        '<%= config.bin %> workflow init --json',
+    ];
+    static flags = {
+        config: Flags.string({
+            char: 'c',
+            description: 'Path to the YAML configuration file',
+            default: DEFAULT_CONFIG_FILE,
+        }),
+        force: Flags.boolean({
+            char: 'f',
+            description: 'Overwrite existing workflows section if already present',
+            default: false,
+        }),
+        json: Flags.boolean({
+            description: 'Output result as structured JSON (for AI agents and scripting)',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(WorkflowInit);
+        const configPath = resolve(flags.config);
+        const existingConfig = await loadExistingConfigForWorkflow(configPath);
+        if (existingConfig.workflows !== undefined && !flags.force) {
+            const msg = `Configuration file already has a workflows section.\n\n` +
+                `  File: ${configPath}\n\n` +
+                '  Use --force to overwrite the existing workflows.';
+            if (flags.json) {
+                this.log(JSON.stringify({ success: false, error: 'workflows_exists', file: configPath }));
+            }
+            else {
+                this.error(msg);
+            }
+            return;
+        }
+        const sampleWorkflows = buildSampleWorkflows();
+        const merged = mergeWorkflowsIntoConfig(existingConfig, sampleWorkflows);
+        const yamlContent = configToYaml(merged);
+        await writeFile(configPath, yamlContent, 'utf-8');
+        if (flags.json) {
+            this.log(JSON.stringify({ success: true, file: configPath, workflows: sampleWorkflows }, undefined, 2));
+        }
+        else {
+            this.log(buildWorkflowInitSuccessMessage(configPath));
+        }
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/workflow/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/commands/workflow/init.ts"],"names":[],"mappings":"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"}

package/dist/commands/workflow/run.d.ts

@@ -0,0 +1,22 @@
+import { Command } from '@oclif/core';
+import type { StepResult } from '../../lib/workflow/types.js';
+/**
+ * Formats a duration in milliseconds to a human-readable string.
+ */
+export declare const formatDuration: (ms: number) => string;
+/**
+ * Builds a formatted summary of workflow execution for human-readable output.
+ */
+export declare const buildWorkflowSummary: (workflowName: string, steps: readonly StepResult[], success: boolean, totalDurationMs: number) => string;
+export default class WorkflowRun extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        config: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        state: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/workflow/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/run.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAK7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,MAAM,KAAG,MAa3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,cAAc,MAAM,EACpB,OAAO,SAAS,UAAU,EAAE,EAC5B,SAAS,OAAO,EAChB,iBAAiB,MAAM,KACtB,MAoBF,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,OAAO;IAC9C,OAAgB,WAAW,SAIsC;IAEjE,OAAgB,QAAQ,WAItB;IAEF,OAAgB,KAAK;;;;;MAkBnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAqDlC"}

package/dist/commands/workflow/run.js

@@ -0,0 +1,111 @@
+import { resolve } from 'node:path';
+import { Command, Flags } from '@oclif/core';
+import { loadConfigFile } from '../../lib/config/parser.js';
+import { executeWorkflow } from '../../lib/workflow/executor.js';
+import { resolveDefaultWorkflow, resolveWorkflowByName } from '../../lib/workflow/resolve-workflow.js';
+/**
+ * Formats a duration in milliseconds to a human-readable string.
+ */
+export const formatDuration = (ms) => {
+    if (ms < 1000) {
+        return `${String(ms)}ms`;
+    }
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60) {
+        return `${String(seconds)}s`;
+    }
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    return `${String(minutes)}m ${String(remainingSeconds)}s`;
+};
+/**
+ * Builds a formatted summary of workflow execution for human-readable output.
+ */
+export const buildWorkflowSummary = (workflowName, steps, success, totalDurationMs) => {
+    const header = success
+        ? `✓ Workflow "${workflowName}" completed successfully`
+        : `✗ Workflow "${workflowName}" failed`;
+    const stepLines = steps.map((step) => `  ${step.success ? '✓' : '✗'} ${step.name} (${formatDuration(step.durationMs)})${step.error !== undefined ? `\n    Error: ${step.error}` : ''}`);
+    return [
+        header,
+        '',
+        '  Steps:',
+        ...stepLines,
+        '',
+        `  Total time: ${formatDuration(totalDurationMs)}`,
+    ].join('\n');
+};
+export default class WorkflowRun extends Command {
+    static description = 'Execute a named workflow defined in a configuration file. ' +
+        'Runs steps sequentially — shell commands via execa, ' +
+        'jahia-cli commands via subprocess. Stops on first failure. ' +
+        'Use --name to select a workflow, or omit to run the default.';
+    static examples = [
+        '<%= config.bin %> workflow run --config jahia-cli.config.yml',
+        '<%= config.bin %> workflow run --config jahia-cli.config.yml --name setup',
+        '<%= config.bin %> workflow run --config ./my-config.yml --json',
+    ];
+    static flags = {
+        config: Flags.string({
+            char: 'c',
+            description: 'Path to the YAML configuration file',
+            required: true,
+        }),
+        name: Flags.string({
+            char: 'n',
+            description: 'Name of the workflow to run (runs default workflow if omitted)',
+        }),
+        json: Flags.boolean({
+            description: 'Output result as structured JSON (for AI agents and scripting)',
+            default: false,
+        }),
+        state: Flags.string({
+            char: 's',
+            description: 'Path to the state file (auto-passed to jahia-cli subcommands)',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(WorkflowRun);
+        const configPath = resolve(flags.config);
+        const config = await loadConfigFile(configPath);
+        if (config.workflows === undefined) {
+            this.error('No workflows section found in configuration file.\n\n' +
+                '  Run "jahia-cli workflow init" to generate sample workflows.');
+            return;
+        }
+        const { name: workflowName, workflow } = flags.name !== undefined
+            ? { name: flags.name, workflow: resolveWorkflowByName(config.workflows, flags.name) }
+            : resolveDefaultWorkflow(config.workflows);
+        const { steps } = workflow;
+        if (!flags.json) {
+            this.log(`▶ Running workflow "${workflowName}" (${String(steps.length)} steps)\n`);
+        }
+        const cliEntryPoint = resolve(this.config.root, 'bin', 'run.js');
+        const result = await executeWorkflow({
+            steps,
+            configPath,
+            statePath: flags.state,
+            cwd: process.cwd(),
+            cliEntryPoint,
+            workflows: config.workflows,
+            callStack: [workflowName],
+            onStepStart: flags.json
+                ? undefined
+                : (stepName, index) => {
+                    this.log(`  [${String(index + 1)}/${String(steps.length)}] ${stepName}...`);
+                },
+            onStepComplete: undefined,
+        });
+        if (flags.json) {
+            this.log(JSON.stringify({ ...result, workflowName }, undefined, 2));
+        }
+        else {
+            this.log('');
+            this.log(buildWorkflowSummary(workflowName, result.steps, result.success, result.totalDurationMs));
+        }
+        if (!result.success) {
+            this.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/workflow/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/commands/workflow/run.ts"],"names":[],"mappings":"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"}

package/dist/lib/artifacts/collect-all.d.ts

@@ -0,0 +1,17 @@
+import type { PersistedEnvironment } from '../state/types.js';
+import type { CollectionResult } from './types.js';
+/**
+ * Resolves the VictoriaLogs base URL from a persisted environment.
+ * Returns undefined if VictoriaLogs is not present or its port can't be determined.
+ */
+export declare const resolveVlogsUrl: (env: PersistedEnvironment) => string | undefined;
+/**
+ * Collects all artifacts (logs + file copies) for every component in an environment.
+ * Errors are isolated per-component — one failure does not block the others.
+ */
+export declare const collectAllArtifacts: (params: {
+    readonly env: PersistedEnvironment;
+    readonly outputDir: string;
+    readonly onProgress?: ((message: string) => void) | undefined;
+}) => Promise<CollectionResult>;
+//# sourceMappingURL=collect-all.d.ts.map

package/dist/lib/artifacts/collect-all.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-all.d.ts","sourceRoot":"","sources":["../../../src/lib/artifacts/collect-all.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAI9D,OAAO,KAAK,EAAsB,gBAAgB,EAA6B,MAAM,YAAY,CAAC;AAElG;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,oBAAoB,KAAG,MAAM,GAAG,SAUpE,CAAC;AAkCF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAU,QAAQ;IAChD,QAAQ,CAAC,GAAG,EAAE,oBAAoB,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC/D,KAAG,OAAO,CAAC,gBAAgB,CA0E3B,CAAC"}

package/dist/lib/artifacts/collect-all.js

@@ -0,0 +1,107 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { resolveConfigComponents } from '../config/parser.js';
+import { copyContainerArtifacts } from './copy-container-artifacts.js';
+import { fetchContainerLogs } from './fetch-container-logs.js';
+/**
+ * Resolves the VictoriaLogs base URL from a persisted environment.
+ * Returns undefined if VictoriaLogs is not present or its port can't be determined.
+ */
+export const resolveVlogsUrl = (env) => {
+    const vlComponent = env.components.find((c) => c.name === 'victorialogs');
+    if (vlComponent === undefined) {
+        return undefined;
+    }
+    // VictoriaLogs HTTP API listens on port 9428
+    const resolved = env.config.components.find((c) => c.name === 'victorialogs');
+    const portOverride = resolved?.overrides?.ports?.find((p) => p.container === 9428);
+    const hostPort = portOverride?.host ?? 9428;
+    return `http://localhost:${String(hostPort)}`;
+};
+/**
+ * Collects logs for a single container, returning log metadata.
+ */
+const collectLogsForComponent = async (params) => {
+    const logFileName = `${params.componentName}.log`;
+    const logFilePath = join(params.outputDir, logFileName);
+    try {
+        const logResult = await fetchContainerLogs({
+            containerId: params.containerId,
+            componentName: params.componentName,
+            envName: params.envName,
+            vlogsBaseUrl: params.vlogsBaseUrl,
+        });
+        await writeFile(logFilePath, logResult.content, 'utf-8');
+        return { logFile: logFileName, logSource: logResult.source, logError: undefined };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { logFile: undefined, logSource: undefined, logError: message };
+    }
+};
+/**
+ * Collects all artifacts (logs + file copies) for every component in an environment.
+ * Errors are isolated per-component — one failure does not block the others.
+ */
+export const collectAllArtifacts = async (params) => {
+    const { env, outputDir, onProgress } = params;
+    if (env.provider !== 'docker') {
+        throw new Error(`Artifact collection is only supported for Docker environments (got "${env.provider}").`);
+    }
+    await mkdir(outputDir, { recursive: true });
+    const vlogsUrl = resolveVlogsUrl(env);
+    // Re-resolve components from config to get effectiveArtifacts
+    const resolvedComponents = resolveConfigComponents(env.config);
+    // Map persisted components by name for container ID lookup
+    const containerIdByName = new Map(env.components.map((c) => [c.name, c.containerId]));
+    const componentResults = await resolvedComponents.reduce(async (chainPromise, resolved) => {
+        const chain = await chainPromise;
+        const componentName = resolved.definition.name;
+        const containerId = containerIdByName.get(componentName);
+        if (containerId === undefined) {
+            return [...chain, {
+                    componentName,
+                    containerId: 'unknown',
+                    logFile: undefined,
+                    logSource: undefined,
+                    logError: `No container ID found in state for "${componentName}"`,
+                    artifacts: [],
+                }];
+        }
+        // Collect logs
+        onProgress?.(`Collecting logs for ${componentName}...`);
+        const logResult = await collectLogsForComponent({
+            containerId,
+            componentName,
+            envName: env.name,
+            vlogsBaseUrl: vlogsUrl,
+            outputDir,
+        });
+        // Copy artifacts
+        const artifactResults = resolved.effectiveArtifacts.length > 0
+            ? await (() => {
+                onProgress?.(`Copying artifacts for ${componentName}...`);
+                return copyContainerArtifacts({
+                    containerId,
+                    componentName,
+                    artifactPaths: resolved.effectiveArtifacts,
+                    outputDir,
+                });
+            })()
+            : [];
+        return [...chain, {
+                componentName,
+                containerId,
+                logFile: logResult.logFile,
+                logSource: logResult.logSource,
+                logError: logResult.logError,
+                artifacts: artifactResults,
+            }];
+    }, Promise.resolve([]));
+    return {
+        envName: env.name,
+        outputDir,
+        components: componentResults,
+    };
+};
+//# sourceMappingURL=collect-all.js.map

package/dist/lib/artifacts/collect-all.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-all.js","sourceRoot":"","sources":["../../../src/lib/artifacts/collect-all.ts"],"names":[],"mappings":"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"}

package/dist/lib/artifacts/copy-container-artifacts.d.ts

@@ -0,0 +1,13 @@
+import type { ArtifactCopyResult } from './types.js';
+/**
+ * Copies artifact paths from a container using `docker cp`.
+ * Each artifact path is copied to a per-component subdirectory.
+ * Errors are captured per-path — one failure does not block others.
+ */
+export declare const copyContainerArtifacts: (params: {
+    readonly containerId: string;
+    readonly componentName: string;
+    readonly artifactPaths: readonly string[];
+    readonly outputDir: string;
+}) => Promise<readonly ArtifactCopyResult[]>;
+//# sourceMappingURL=copy-container-artifacts.d.ts.map

package/dist/lib/artifacts/copy-container-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-container-artifacts.d.ts","sourceRoot":"","sources":["../../../src/lib/artifacts/copy-container-artifacts.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAU,QAAQ;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,KAAG,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAyCxC,CAAC"}

package/dist/lib/artifacts/copy-container-artifacts.js

@@ -0,0 +1,48 @@
+import { execFile } from 'node:child_process';
+import { mkdir } from 'node:fs/promises';
+import { basename, join } from 'node:path';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/**
+ * Copies artifact paths from a container using `docker cp`.
+ * Each artifact path is copied to a per-component subdirectory.
+ * Errors are captured per-path — one failure does not block others.
+ */
+export const copyContainerArtifacts = async (params) => {
+    if (params.artifactPaths.length === 0) {
+        return [];
+    }
+    const componentDir = join(params.outputDir, params.componentName);
+    await mkdir(componentDir, { recursive: true });
+    const results = await params.artifactPaths.reduce(async (chainPromise, artifactPath) => {
+        const chain = await chainPromise;
+        const destName = basename(artifactPath);
+        const destPath = join(componentDir, destName);
+        try {
+            // First try copying as directory contents (trailing '/.' avoids double-nesting).
+            // If the path is a file, this will fail, so we fall back to a plain copy.
+            try {
+                await mkdir(destPath, { recursive: true });
+                await execFileAsync('docker', [
+                    'cp',
+                    `${params.containerId}:${artifactPath}/.`,
+                    destPath,
+                ]);
+            }
+            catch {
+                await execFileAsync('docker', [
+                    'cp',
+                    `${params.containerId}:${artifactPath}`,
+                    destPath,
+                ]);
+            }
+            return [...chain, { path: artifactPath, success: true }];
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return [...chain, { path: artifactPath, success: false, error: message }];
+        }
+    }, Promise.resolve([]));
+    return results;
+};
+//# sourceMappingURL=copy-container-artifacts.js.map