@jahia/jahia-cli 0.1.4 → 0.2.0

package/dist/commands/jahia/alive.js

@@ -0,0 +1,118 @@
+import { Command, Flags } from '@oclif/core';
+import { getActiveEnvironment } from '../../lib/state/get-active-environment.js';
+import { getJahiaConnectionDefaults } from '../../lib/state/get-jahia-connection-defaults.js';
+import { stateFilePath } from '../../lib/state/state-file-path.js';
+import { stateFlag } from '../../lib/state/state-flag.js';
+import { waitForSam } from '../../lib/sam/wait-for-sam.js';
+const DEFAULT_INTERVAL = 2;
+const DEFAULT_TIMEOUT = 300;
+const DEFAULT_COUNT = 5;
+const DEFAULT_SEVERITY = 'MEDIUM';
+export default class JahiaAlive extends Command {
+    static description = 'Wait until the Jahia environment is fully alive and responding GREEN. ' +
+        'Polls the Server Availability Manager (SAM) healthcheck endpoint and requires ' +
+        'N consecutive GREEN responses before declaring the environment ready.';
+    static examples = [
+        '<%= config.bin %> jahia alive',
+        '<%= config.bin %> jahia alive --count 10 --timeout 600',
+        '<%= config.bin %> jahia alive --url http://localhost:8080 --json',
+        '<%= config.bin %> jahia alive --state /ci/workspace/state.json',
+    ];
+    static flags = {
+        state: stateFlag,
+        url: Flags.string({
+            description: 'Jahia base URL (default: from state, or http://localhost:8080)',
+        }),
+        username: Flags.string({
+            char: 'u',
+            description: 'Jahia username for SAM authentication (default: from state, or root)',
+        }),
+        password: Flags.string({
+            char: 'P',
+            description: 'Jahia password for SAM authentication (default: from state, or root1234)',
+        }),
+        severity: Flags.string({
+            char: 's',
+            description: 'SAM probe severity to evaluate (LOW, MEDIUM, HIGH, CRITICAL)',
+            default: DEFAULT_SEVERITY,
+        }),
+        interval: Flags.integer({
+            char: 'i',
+            description: 'Seconds between health checks',
+            default: DEFAULT_INTERVAL,
+        }),
+        timeout: Flags.integer({
+            char: 't',
+            description: 'Maximum seconds to wait before failing',
+            default: DEFAULT_TIMEOUT,
+        }),
+        count: Flags.integer({
+            char: 'c',
+            description: 'Number of consecutive GREEN responses required',
+            default: DEFAULT_COUNT,
+        }),
+        json: Flags.boolean({
+            description: 'Output result as structured JSON (for AI agents and scripting)',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(JahiaAlive);
+        const stateOverride = flags.state;
+        const statePath = stateFilePath(stateOverride);
+        const env = await getActiveEnvironment(stateOverride);
+        const envName = env?.name ?? 'unknown';
+        const defaults = getJahiaConnectionDefaults(env);
+        const url = flags.url ?? defaults.url;
+        const username = flags.username ?? defaults.username;
+        const password = flags.password ?? defaults.password;
+        if (!flags.json) {
+            this.log(`Waiting for Jahia environment "${envName}" to become alive...`);
+            this.log(`  URL:      ${url}`);
+            this.log(`  Requires: ${String(flags.count)} consecutive GREEN at ${String(flags.interval)}s interval`);
+            this.log(`  Timeout:  ${String(flags.timeout)}s`);
+            this.log(`  State:    ${statePath}`);
+            this.log('');
+        }
+        const onPoll = (event) => {
+            if (flags.json)
+                return;
+            const icon = event.health === 'GREEN' ? '●' : '○';
+            const progress = event.health === 'GREEN' ? ` (${String(event.consecutiveGreen)}/${String(flags.count)})` : '';
+            const detail = event.message ? ` — ${event.message}` : '';
+            this.log(`  ${icon} [${String(event.elapsedSeconds).padStart(4)}s] ${event.health}${progress}${detail}`);
+        };
+        try {
+            const result = await waitForSam({
+                url,
+                username,
+                password,
+                severity: flags.severity,
+                intervalSeconds: flags.interval,
+                timeoutSeconds: flags.timeout,
+                consecutiveCount: flags.count,
+                onPoll,
+            });
+            if (flags.json) {
+                this.log(JSON.stringify({ ...result, environment: envName, stateFile: statePath }, null, 2));
+            }
+            else {
+                this.log('');
+                this.log(`✓ Environment "${envName}" is alive and responding GREEN`);
+                this.log(`  Confirmed in ${String(result.elapsedSeconds)}s with ${String(result.consecutiveGreen)} consecutive checks`);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (flags.json) {
+                this.log(JSON.stringify({ success: false, environment: envName, stateFile: statePath, error: 'timeout', message }, null, 2));
+            }
+            else {
+                this.log('');
+                this.log(`✗ ${message}`);
+            }
+            this.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=alive.js.map

package/dist/commands/jahia/alive.js.map

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

package/dist/commands/jahia/provision.d.ts

@@ -0,0 +1,33 @@
+import { Command } from '@oclif/core';
+import type { ProvisioningAttachment } from '../../lib/provisioning/types.js';
+/**
+ * Reads file attachments from disk and returns them as ProvisioningAttachment objects.
+ */
+export declare const loadAttachments: (filePaths: readonly string[]) => Promise<readonly ProvisioningAttachment[]>;
+/**
+ * Formats a provisioning result for human-readable output.
+ */
+export declare const formatProvisioningResultHuman: (result: {
+    readonly success: boolean;
+    readonly statusCode: number;
+    readonly message: string;
+    readonly responseBody: unknown;
+    readonly manifest: string;
+    readonly durationMs: number;
+}) => string;
+export default class JahiaProvision extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        state: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        manifest: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        username: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        password: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        file: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        assets: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=provision.d.ts.map

package/dist/commands/jahia/provision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provision.d.ts","sourceRoot":"","sources":["../../../src/commands/jahia/provision.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAO7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAM9E;;GAEG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,SAAS,MAAM,EAAE,KAC3B,OAAO,CAAC,SAAS,sBAAsB,EAAE,CAQ3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B,GAAI,QAAQ;IACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,KAAG,MAkBH,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,OAAgB,WAAW,SAG2D;IAEtF,OAAgB,QAAQ,WAOtB;IAEF,OAAgB,KAAK;;;;;;;;;MA+BnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAgGlC"}

package/dist/commands/jahia/provision.js

@@ -0,0 +1,164 @@
+import { readFile } from 'node:fs/promises';
+import { basename } from 'node:path';
+import { Command, Flags } from '@oclif/core';
+import { detectManifestSource } from '../../lib/provisioning/detect-manifest-source.js';
+import { fetchManifest } from '../../lib/provisioning/fetch-manifest.js';
+import { readManifest } from '../../lib/provisioning/read-manifest.js';
+import { resolveAssetPaths } from '../../lib/provisioning/resolve-asset-paths.js';
+import { submitProvisioning } from '../../lib/provisioning/submit-provisioning.js';
+import { getActiveEnvironment } from '../../lib/state/get-active-environment.js';
+import { getJahiaConnectionDefaults } from '../../lib/state/get-jahia-connection-defaults.js';
+import { stateFilePath } from '../../lib/state/state-file-path.js';
+import { stateFlag } from '../../lib/state/state-flag.js';
+/**
+ * Reads file attachments from disk and returns them as ProvisioningAttachment objects.
+ */
+export const loadAttachments = async (filePaths) => {
+    const results = await Promise.all(filePaths.map(async (filePath) => {
+        const content = await readFile(filePath);
+        return { filename: basename(filePath), content };
+    }));
+    return results;
+};
+/**
+ * Formats a provisioning result for human-readable output.
+ */
+export const formatProvisioningResultHuman = (result) => {
+    const icon = result.success ? '✓' : '✗';
+    const status = result.success ? 'Provisioning succeeded' : 'Provisioning failed';
+    const lines = [
+        `${icon} ${status}`,
+        `  Manifest:  ${result.manifest}`,
+        `  Status:    HTTP ${String(result.statusCode)}`,
+        `  Duration:  ${String(result.durationMs)}ms`,
+    ];
+    if (result.responseBody !== undefined) {
+        lines.push('');
+        lines.push(JSON.stringify(result.responseBody, null, 2));
+    }
+    else if (!result.success && result.message) {
+        lines.push(`  Error:     ${result.message}`);
+    }
+    return lines.join('\n');
+};
+export default class JahiaProvision extends Command {
+    static description = 'Execute a provisioning script against a running Jahia instance. ' +
+        'The manifest can be a local YAML file or a public URL (auto-detected). ' +
+        'Optional file attachments can be included via --file flags or --assets directory.';
+    static examples = [
+        '<%= config.bin %> jahia provision --manifest ./provisioning/setup.yaml',
+        '<%= config.bin %> jahia provision --manifest https://raw.githubusercontent.com/org/repo/main/provisioning.yaml',
+        '<%= config.bin %> jahia provision --manifest ./setup.yaml --file ./modules/mymodule.jar',
+        '<%= config.bin %> jahia provision --manifest ./setup.yaml --assets ./artifacts',
+        '<%= config.bin %> jahia provision --manifest ./setup.yaml --file ./mod1.jar --file ./mod2.jar --json',
+        '<%= config.bin %> jahia provision --manifest ./setup.yaml --url http://localhost:8080 --username root --password secret',
+    ];
+    static flags = {
+        state: stateFlag,
+        manifest: Flags.string({
+            char: 'm',
+            description: 'Path to a local YAML file or a public URL of the provisioning manifest',
+            required: true,
+        }),
+        url: Flags.string({
+            description: 'Jahia base URL (default: from state, or http://localhost:8080)',
+        }),
+        username: Flags.string({
+            char: 'u',
+            description: 'Jahia admin username (default: from state, or root)',
+        }),
+        password: Flags.string({
+            char: 'P',
+            description: 'Jahia admin password (default: from state, or root1234)',
+        }),
+        file: Flags.string({
+            char: 'f',
+            description: 'File attachment to include (can be specified multiple times)',
+            multiple: true,
+        }),
+        assets: Flags.string({
+            char: 'a',
+            description: 'Directory whose files are attached to the provisioning request (recursive)',
+        }),
+        json: Flags.boolean({
+            description: 'Output result as structured JSON (for AI agents and scripting)',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(JahiaProvision);
+        const stateOverride = flags.state;
+        const statePath = stateFilePath(stateOverride);
+        const env = await getActiveEnvironment(stateOverride);
+        const envName = env?.name ?? 'unknown';
+        const defaults = getJahiaConnectionDefaults(env);
+        const url = flags.url ?? defaults.url;
+        const username = flags.username ?? defaults.username;
+        const password = flags.password ?? defaults.password;
+        const manifest = flags.manifest;
+        const source = detectManifestSource(manifest);
+        if (!flags.json) {
+            this.log(`Provisioning Jahia environment "${envName}"...`);
+            this.log(`  Manifest: ${manifest} (${source})`);
+            this.log(`  URL:      ${url}`);
+            this.log(`  State:    ${statePath}`);
+            if (flags.file && flags.file.length > 0) {
+                this.log(`  Files:    ${flags.file.join(', ')}`);
+            }
+            if (flags.assets) {
+                this.log(`  Assets:   ${flags.assets}`);
+            }
+            this.log('');
+        }
+        try {
+            // Load manifest
+            if (!flags.json) {
+                this.log(source === 'url' ? 'Downloading manifest...' : 'Reading manifest...');
+            }
+            const { content: manifestContent, filename: manifestFilename } = source === 'url'
+                ? await fetchManifest(manifest)
+                : await readManifest(manifest);
+            // Load file attachments from --file flags and --assets directory
+            const filePaths = flags.file ?? [];
+            const assetPaths = flags.assets ? await resolveAssetPaths(flags.assets) : [];
+            const allPaths = [...filePaths, ...assetPaths];
+            const attachments = await loadAttachments(allPaths);
+            if (!flags.json && attachments.length > 0) {
+                this.log(`Attaching ${String(attachments.length)} file(s)...`);
+            }
+            if (!flags.json) {
+                this.log('Submitting provisioning script...');
+            }
+            const result = await submitProvisioning({
+                url,
+                username,
+                password,
+                manifestContent,
+                manifestFilename,
+                attachments,
+            });
+            if (flags.json) {
+                this.log(JSON.stringify({ ...result, environment: envName, stateFile: statePath, source }, null, 2));
+            }
+            else {
+                this.log('');
+                this.log(formatProvisioningResultHuman(result));
+            }
+            if (!result.success) {
+                this.exit(1);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (flags.json) {
+                this.log(JSON.stringify({ success: false, environment: envName, stateFile: statePath, error: message }, null, 2));
+            }
+            else {
+                this.log('');
+                this.log(`✗ ${message}`);
+            }
+            this.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=provision.js.map

package/dist/commands/jahia/provision.js.map

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

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

@@ -0,0 +1,56 @@
+import { Command } from '@oclif/core';
+import type { ScaffoldingConfig } from '../../lib/config/types.js';
+import type { SyncAction, SyncMissingFilesResult } from '../../lib/tests/types.js';
+/**
+ * Resolves ScaffoldingConfig from the loaded config, falling back to defaults.
+ */
+export declare const resolveScaffoldingConfig: (scaffolding: ScaffoldingConfig | undefined) => ScaffoldingConfig;
+/**
+ * Formats a single sync action line for human-readable output.
+ */
+export declare const formatSyncLine: (action: SyncAction, path: string, reason: string) => string;
+/**
+ * Builds human-readable output for the tests init command.
+ */
+export declare const formatTestsInitHuman: (params: {
+    readonly version: string;
+    readonly destinationPath: string;
+    readonly repositoryUrl: string;
+    readonly scaffoldingPath: string;
+    readonly result: SyncMissingFilesResult;
+    readonly configFile: string;
+    readonly configCreated: boolean;
+    readonly gitignoreEntriesAdded: number;
+    readonly logLines: readonly string[];
+}) => string;
+/**
+ * Builds structured JSON output for AI agents and scripting.
+ */
+export declare const buildTestsInitSuccessJson: (params: {
+    readonly version: string;
+    readonly destinationPath: string;
+    readonly repositoryUrl: string;
+    readonly scaffoldingPath: string;
+    readonly result: SyncMissingFilesResult;
+    readonly configFile: string;
+    readonly configCreated: boolean;
+    readonly gitignoreEntriesAdded: number;
+}) => string;
+/**
+ * Builds structured JSON failure output.
+ */
+export declare const buildTestsInitFailureJson: (params: {
+    readonly destinationPath: string;
+    readonly message: string;
+}) => string;
+export default class TestsInit extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        path: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/tests/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAU7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAInE,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAInF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GACnC,aAAa,iBAAiB,GAAG,SAAS,KACzC,iBAID,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,UAAU,EAAE,MAAM,MAAM,EAAE,QAAQ,MAAM,KAAG,MAOjF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,KAAG,MAWH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,QAAQ;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;CACxC,KAAG,MAkBD,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,QAAQ;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,KAAG,MAUD,CAAC;AAEJ,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,OAAgB,WAAW,SAGwC;IAEnE,OAAgB,QAAQ,WAItB;IAEF,OAAgB,KAAK;;;;MAcnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA+GlC"}

package/dist/commands/tests/init.js

@@ -0,0 +1,195 @@
+import { access, mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { Command, Flags } from '@oclif/core';
+import { buildBlankConfig } from '../../lib/config/build-blank-config.js';
+import { DEFAULT_SCAFFOLDING_PATH, DEFAULT_SCAFFOLDING_REPOSITORY, DEFAULT_SCAFFOLDING_VERSION, } from '../../lib/config/defaults.js';
+import { initializeConfigFile } from '../../lib/config/initialize-config-file.js';
+import { loadConfigFile } from '../../lib/config/parser.js';
+import { cloneScaffolding } from '../../lib/tests/clone-scaffolding.js';
+import { updateGitignore } from '../../lib/tests/gitignore-manager.js';
+import { syncMissingFiles } from '../../lib/tests/sync-missing-files.js';
+const DEFAULT_CONFIG_FILE = 'jahia-cli.config.yml';
+/**
+ * Resolves ScaffoldingConfig from the loaded config, falling back to defaults.
+ */
+export const resolveScaffoldingConfig = (scaffolding) => ({
+    repository: scaffolding?.repository ?? DEFAULT_SCAFFOLDING_REPOSITORY,
+    path: scaffolding?.path ?? DEFAULT_SCAFFOLDING_PATH,
+    version: scaffolding?.version ?? DEFAULT_SCAFFOLDING_VERSION,
+});
+/**
+ * Formats a single sync action line for human-readable output.
+ */
+export const formatSyncLine = (action, path, reason) => {
+    const labels = {
+        copied: '  SYNC:   ',
+        kept: '  SKIP:   ',
+        ignored: '  IGNORED:',
+    };
+    return `${labels[action]} ${path} (${reason})`;
+};
+/**
+ * Builds human-readable output for the tests init command.
+ */
+export const formatTestsInitHuman = (params) => {
+    const lines = [
+        ...params.logLines,
+        '',
+        `Summary: ${String(params.result.copied.length)} synced, ${String(params.result.kept.length)} skipped, ${String(params.result.ignored.length)} ignored`,
+        params.gitignoreEntriesAdded > 0
+            ? `.gitignore updated: ${String(params.gitignoreEntriesAdded)} entries in managed section`
+            : '.gitignore: no new entries needed',
+        `✓ Test scaffolding initialized (${params.version})`,
+    ];
+    return lines.join('\n');
+};
+/**
+ * Builds structured JSON output for AI agents and scripting.
+ */
+export const buildTestsInitSuccessJson = (params) => JSON.stringify({
+    success: true,
+    version: params.version,
+    repository: params.repositoryUrl,
+    scaffoldingPath: params.scaffoldingPath,
+    destination: params.destinationPath,
+    synced: params.result.copied,
+    skipped: params.result.kept,
+    ignored: params.result.ignored,
+    gitignoreUpdated: params.gitignoreEntriesAdded > 0,
+    gitignoreEntriesAdded: params.gitignoreEntriesAdded,
+    configFile: params.configFile,
+    configCreated: params.configCreated,
+}, null, 2);
+/**
+ * Builds structured JSON failure output.
+ */
+export const buildTestsInitFailureJson = (params) => JSON.stringify({
+    success: false,
+    error: 'tests_init_failed',
+    destination: params.destinationPath,
+    message: params.message,
+}, null, 2);
+export default class TestsInit extends Command {
+    static description = 'Initialize local test scaffolding from a remote repository. ' +
+        'Syncs missing files from the configured scaffolding source and manages .gitignore ' +
+        'so that remotely-sourced files are not accidentally committed.';
+    static examples = [
+        '<%= config.bin %> tests init',
+        '<%= config.bin %> tests init --config ./my-config.yml',
+        '<%= config.bin %> tests init --path ./tests --json',
+    ];
+    static flags = {
+        config: Flags.string({
+            char: 'c',
+            description: `Path to config file (default: ${DEFAULT_CONFIG_FILE})`,
+            env: 'JAHIA_CLI_CONFIG',
+        }),
+        path: Flags.string({
+            char: 'p',
+            description: 'Override destination directory for scaffolding files',
+        }),
+        json: Flags.boolean({
+            description: 'Output result as structured JSON (for AI agents and scripting)',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(TestsInit);
+        const configFile = resolve(flags.config ?? DEFAULT_CONFIG_FILE);
+        const destinationPath = resolve(flags.path ?? '.');
+        const gitignorePath = join(destinationPath, '.gitignore');
+        const tempDir = await mkdtemp(join(tmpdir(), 'jahia-cli-tests-init-'));
+        const logLines = [];
+        try {
+            // Load or generate config
+            const configExists = await access(configFile).then(() => true).catch(() => false);
+            const configCreated = !configExists;
+            if (!configExists) {
+                this.log(`Config not found at ${configFile}, generating blank...`);
+                logLines.push(`Config not found at ${configFile}, generating blank...`);
+                const blank = buildBlankConfig();
+                await initializeConfigFile({ outputFile: configFile, config: blank, force: false });
+            }
+            const config = await loadConfigFile(configFile);
+            const scaffolding = resolveScaffoldingConfig(config.tests?.scaffolding);
+            logLines.push(`Loading config from ${configFile}...`);
+            logLines.push(`Repository: ${scaffolding.repository}`);
+            logLines.push(`Scaffolding path: ${scaffolding.path}`);
+            logLines.push(`Version: ${scaffolding.version}`);
+            // Resolve version and clone
+            const resolvedVersion = scaffolding.version === 'latest' ? undefined : scaffolding.version;
+            logLines.push(scaffolding.version === 'latest'
+                ? `Resolving latest tag for ${scaffolding.repository}...`
+                : `Using version: ${scaffolding.version}`);
+            const cloned = await cloneScaffolding({
+                version: resolvedVersion,
+                workDir: tempDir,
+                repositoryUrl: scaffolding.repository.endsWith('.git')
+                    ? scaffolding.repository
+                    : `${scaffolding.repository}.git`,
+                scaffoldingPath: scaffolding.path.replace(/\/$/, ''),
+            });
+            logLines.push(`Resolved version: ${cloned.version}`);
+            logLines.push(`Cloning ${scaffolding.repository}@${cloned.version}...`);
+            logLines.push(`Syncing ${scaffolding.path} → ${destinationPath}`);
+            logLines.push('');
+            // Sync files with per-file logging
+            const result = await syncMissingFiles({
+                sourceDir: cloned.scaffoldingDir,
+                destinationDir: destinationPath,
+                logger: (action, relativePath, reason) => {
+                    logLines.push(formatSyncLine(action, relativePath, reason));
+                },
+            });
+            // Update .gitignore with all remote-sourced files (copied + kept).
+            // This ensures the managed section persists across re-runs — files stay
+            // gitignored until the user manually removes the entry to "own" that file.
+            const gitignoreResult = await updateGitignore(gitignorePath, [...result.copied, ...result.kept]);
+            if (gitignoreResult.entriesAdded > 0) {
+                logLines.push('');
+                logLines.push(`.gitignore updated: ${String(gitignoreResult.entriesAdded)} entries added to managed section`);
+            }
+            // Output
+            if (flags.json) {
+                this.log(buildTestsInitSuccessJson({
+                    version: cloned.version,
+                    destinationPath,
+                    repositoryUrl: scaffolding.repository,
+                    scaffoldingPath: scaffolding.path,
+                    result,
+                    configFile,
+                    configCreated,
+                    gitignoreEntriesAdded: gitignoreResult.entriesAdded,
+                }));
+            }
+            else {
+                this.log(formatTestsInitHuman({
+                    version: cloned.version,
+                    destinationPath,
+                    repositoryUrl: scaffolding.repository,
+                    scaffoldingPath: scaffolding.path,
+                    result,
+                    configFile,
+                    configCreated,
+                    gitignoreEntriesAdded: gitignoreResult.entriesAdded,
+                    logLines,
+                }));
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (flags.json) {
+                this.log(buildTestsInitFailureJson({ destinationPath, message }));
+            }
+            else {
+                this.error(message);
+            }
+            this.exit(1);
+        }
+        finally {
+            await rm(tempDir, { recursive: true, force: true });
+        }
+    }
+}
+//# sourceMappingURL=init.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/commands/tests/init.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,SAGiD;IAE5E,OAAgB,QAAQ,WAKtB;IAEF,OAAgB,KAAK;;;;MAenB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAoClC"}