@pipeline-builder/pipeline-manager 3.1.0

package/dist/utils/audit-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.d.ts","sourceRoot":"","sources":["../../src/utils/audit-log.ts"],"names":[],"mappings":"AAwBA;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CA2BjF"}

package/dist/utils/audit-log.js

@@ -0,0 +1,53 @@
+"use strict";
+// Copyright 2026 Pipeline Builder Contributors
+// SPDX-License-Identifier: Apache-2.0
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.auditLog = auditLog;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Local audit logger for sensitive CLI operations.
+ * Writes timestamped entries to ~/.pipeline-manager/audit.log.
+ * Never logs credentials or tokens — only operation metadata.
+ */
+const AUDIT_DIR = path_1.default.join(os_1.default.homedir(), '.pipeline-manager');
+const AUDIT_FILE = path_1.default.join(AUDIT_DIR, 'audit.log');
+const MAX_AUDIT_SIZE = 1024 * 1024; // 1MB — rotate when exceeded
+/**
+ * Log a sensitive operation to the local audit file.
+ *
+ * @param command - The command name (e.g., 'store-token', 'deploy', 'bootstrap')
+ * @param details - Non-sensitive metadata about the operation
+ */
+function auditLog(command, details) {
+    try {
+        if (!fs_1.default.existsSync(AUDIT_DIR)) {
+            fs_1.default.mkdirSync(AUDIT_DIR, { recursive: true, mode: 0o700 });
+        }
+        // Rotate if file is too large
+        if (fs_1.default.existsSync(AUDIT_FILE)) {
+            const stats = fs_1.default.statSync(AUDIT_FILE);
+            if (stats.size > MAX_AUDIT_SIZE) {
+                const rotated = `${AUDIT_FILE}.1`;
+                if (fs_1.default.existsSync(rotated))
+                    fs_1.default.unlinkSync(rotated);
+                fs_1.default.renameSync(AUDIT_FILE, rotated);
+            }
+        }
+        const entry = {
+            timestamp: new Date().toISOString(),
+            command,
+            user: os_1.default.userInfo().username,
+            details,
+        };
+        fs_1.default.appendFileSync(AUDIT_FILE, JSON.stringify(entry) + '\n', { mode: 0o600 });
+    }
+    catch {
+        // Audit logging is best-effort — never block the CLI
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXVkaXQtbG9nLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3V0aWxzL2F1ZGl0LWxvZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUEsK0NBQStDO0FBQy9DLHNDQUFzQzs7Ozs7QUE2QnRDLDRCQTJCQztBQXRERCw0Q0FBb0I7QUFDcEIsNENBQW9CO0FBQ3BCLGdEQUF3QjtBQUV4Qjs7OztHQUlHO0FBRUgsTUFBTSxTQUFTLEdBQUcsY0FBSSxDQUFDLElBQUksQ0FBQyxZQUFFLENBQUMsT0FBTyxFQUFFLEVBQUUsbUJBQW1CLENBQUMsQ0FBQztBQUMvRCxNQUFNLFVBQVUsR0FBRyxjQUFJLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxXQUFXLENBQUMsQ0FBQztBQUNyRCxNQUFNLGNBQWMsR0FBRyxJQUFJLEdBQUcsSUFBSSxDQUFDLENBQUMsNkJBQTZCO0FBU2pFOzs7OztHQUtHO0FBQ0gsU0FBZ0IsUUFBUSxDQUFDLE9BQWUsRUFBRSxPQUFpQztJQUN6RSxJQUFJLENBQUM7UUFDSCxJQUFJLENBQUMsWUFBRSxDQUFDLFVBQVUsQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDO1lBQzlCLFlBQUUsQ0FBQyxTQUFTLENBQUMsU0FBUyxFQUFFLEVBQUUsU0FBUyxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsS0FBSyxFQUFFLENBQUMsQ0FBQztRQUM1RCxDQUFDO1FBRUQsOEJBQThCO1FBQzlCLElBQUksWUFBRSxDQUFDLFVBQVUsQ0FBQyxVQUFVLENBQUMsRUFBRSxDQUFDO1lBQzlCLE1BQU0sS0FBSyxHQUFHLFlBQUUsQ0FBQyxRQUFRLENBQUMsVUFBVSxDQUFDLENBQUM7WUFDdEMsSUFBSSxLQUFLLENBQUMsSUFBSSxHQUFHLGNBQWMsRUFBRSxDQUFDO2dCQUNoQyxNQUFNLE9BQU8sR0FBRyxHQUFHLFVBQVUsSUFBSSxDQUFDO2dCQUNsQyxJQUFJLFlBQUUsQ0FBQyxVQUFVLENBQUMsT0FBTyxDQUFDO29CQUFFLFlBQUUsQ0FBQyxVQUFVLENBQUMsT0FBTyxDQUFDLENBQUM7Z0JBQ25ELFlBQUUsQ0FBQyxVQUFVLENBQUMsVUFBVSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1lBQ3JDLENBQUM7UUFDSCxDQUFDO1FBRUQsTUFBTSxLQUFLLEdBQWU7WUFDeEIsU0FBUyxFQUFFLElBQUksSUFBSSxFQUFFLENBQUMsV0FBVyxFQUFFO1lBQ25DLE9BQU87WUFDUCxJQUFJLEVBQUUsWUFBRSxDQUFDLFFBQVEsRUFBRSxDQUFDLFFBQVE7WUFDNUIsT0FBTztTQUNSLENBQUM7UUFFRixZQUFFLENBQUMsY0FBYyxDQUFDLFVBQVUsRUFBRSxJQUFJLENBQUMsU0FBUyxDQUFDLEtBQUssQ0FBQyxHQUFHLElBQUksRUFBRSxFQUFFLElBQUksRUFBRSxLQUFLLEVBQUUsQ0FBQyxDQUFDO0lBQy9FLENBQUM7SUFBQyxNQUFNLENBQUM7UUFDUCxxREFBcUQ7SUFDdkQsQ0FBQztBQUNILENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBDb3B5cmlnaHQgMjAyNiBQaXBlbGluZSBCdWlsZGVyIENvbnRyaWJ1dG9yc1xuLy8gU1BEWC1MaWNlbnNlLUlkZW50aWZpZXI6IEFwYWNoZS0yLjBcblxuaW1wb3J0IGZzIGZyb20gJ2ZzJztcbmltcG9ydCBvcyBmcm9tICdvcyc7XG5pbXBvcnQgcGF0aCBmcm9tICdwYXRoJztcblxuLyoqXG4gKiBMb2NhbCBhdWRpdCBsb2dnZXIgZm9yIHNlbnNpdGl2ZSBDTEkgb3BlcmF0aW9ucy5cbiAqIFdyaXRlcyB0aW1lc3RhbXBlZCBlbnRyaWVzIHRvIH4vLnBpcGVsaW5lLW1hbmFnZXIvYXVkaXQubG9nLlxuICogTmV2ZXIgbG9ncyBjcmVkZW50aWFscyBvciB0b2tlbnMg4oCUIG9ubHkgb3BlcmF0aW9uIG1ldGFkYXRhLlxuICovXG5cbmNvbnN0IEFVRElUX0RJUiA9IHBhdGguam9pbihvcy5ob21lZGlyKCksICcucGlwZWxpbmUtbWFuYWdlcicpO1xuY29uc3QgQVVESVRfRklMRSA9IHBhdGguam9pbihBVURJVF9ESVIsICdhdWRpdC5sb2cnKTtcbmNvbnN0IE1BWF9BVURJVF9TSVpFID0gMTAyNCAqIDEwMjQ7IC8vIDFNQiDigJQgcm90YXRlIHdoZW4gZXhjZWVkZWRcblxuaW50ZXJmYWNlIEF1ZGl0RW50cnkge1xuICB0aW1lc3RhbXA6IHN0cmluZztcbiAgY29tbWFuZDogc3RyaW5nO1xuICB1c2VyPzogc3RyaW5nO1xuICBkZXRhaWxzPzogUmVjb3JkPHN0cmluZywgdW5rbm93bj47XG59XG5cbi8qKlxuICogTG9nIGEgc2Vuc2l0aXZlIG9wZXJhdGlvbiB0byB0aGUgbG9jYWwgYXVkaXQgZmlsZS5cbiAqXG4gKiBAcGFyYW0gY29tbWFuZCAtIFRoZSBjb21tYW5kIG5hbWUgKGUuZy4sICdzdG9yZS10b2tlbicsICdkZXBsb3knLCAnYm9vdHN0cmFwJylcbiAqIEBwYXJhbSBkZXRhaWxzIC0gTm9uLXNlbnNpdGl2ZSBtZXRhZGF0YSBhYm91dCB0aGUgb3BlcmF0aW9uXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBhdWRpdExvZyhjb21tYW5kOiBzdHJpbmcsIGRldGFpbHM/OiBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPik6IHZvaWQge1xuICB0cnkge1xuICAgIGlmICghZnMuZXhpc3RzU3luYyhBVURJVF9ESVIpKSB7XG4gICAgICBmcy5ta2RpclN5bmMoQVVESVRfRElSLCB7IHJlY3Vyc2l2ZTogdHJ1ZSwgbW9kZTogMG83MDAgfSk7XG4gICAgfVxuXG4gICAgLy8gUm90YXRlIGlmIGZpbGUgaXMgdG9vIGxhcmdlXG4gICAgaWYgKGZzLmV4aXN0c1N5bmMoQVVESVRfRklMRSkpIHtcbiAgICAgIGNvbnN0IHN0YXRzID0gZnMuc3RhdFN5bmMoQVVESVRfRklMRSk7XG4gICAgICBpZiAoc3RhdHMuc2l6ZSA+IE1BWF9BVURJVF9TSVpFKSB7XG4gICAgICAgIGNvbnN0IHJvdGF0ZWQgPSBgJHtBVURJVF9GSUxFfS4xYDtcbiAgICAgICAgaWYgKGZzLmV4aXN0c1N5bmMocm90YXRlZCkpIGZzLnVubGlua1N5bmMocm90YXRlZCk7XG4gICAgICAgIGZzLnJlbmFtZVN5bmMoQVVESVRfRklMRSwgcm90YXRlZCk7XG4gICAgICB9XG4gICAgfVxuXG4gICAgY29uc3QgZW50cnk6IEF1ZGl0RW50cnkgPSB7XG4gICAgICB0aW1lc3RhbXA6IG5ldyBEYXRlKCkudG9JU09TdHJpbmcoKSxcbiAgICAgIGNvbW1hbmQsXG4gICAgICB1c2VyOiBvcy51c2VySW5mbygpLnVzZXJuYW1lLFxuICAgICAgZGV0YWlscyxcbiAgICB9O1xuXG4gICAgZnMuYXBwZW5kRmlsZVN5bmMoQVVESVRfRklMRSwgSlNPTi5zdHJpbmdpZnkoZW50cnkpICsgJ1xcbicsIHsgbW9kZTogMG82MDAgfSk7XG4gIH0gY2F0Y2gge1xuICAgIC8vIEF1ZGl0IGxvZ2dpbmcgaXMgYmVzdC1lZmZvcnQg4oCUIG5ldmVyIGJsb2NrIHRoZSBDTElcbiAgfVxufVxuIl19

package/dist/utils/auth-guard.d.ts

@@ -0,0 +1,16 @@
+interface TokenPayload {
+    role?: string;
+    isAdmin?: boolean;
+    sub?: string;
+    organizationId?: string;
+}
+/**
+ * Decode a JWT token payload without signature verification.
+ *
+ * SECURITY: NO signature verification. The decoded payload MUST NOT be used
+ * for authorization decisions — the server validates the token on every API
+ * call. Use only for advisory UX hints.
+ */
+export declare function decodeTokenPayload(token: string): TokenPayload | null;
+export {};
+//# sourceMappingURL=auth-guard.d.ts.map

package/dist/utils/auth-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-guard.d.ts","sourceRoot":"","sources":["../../src/utils/auth-guard.ts"],"names":[],"mappings":"AAGA,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CASrE"}

package/dist/utils/auth-guard.js

@@ -0,0 +1,25 @@
+"use strict";
+// Copyright 2026 Pipeline Builder Contributors
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeTokenPayload = decodeTokenPayload;
+/**
+ * Decode a JWT token payload without signature verification.
+ *
+ * SECURITY: NO signature verification. The decoded payload MUST NOT be used
+ * for authorization decisions — the server validates the token on every API
+ * call. Use only for advisory UX hints.
+ */
+function decodeTokenPayload(token) {
+    try {
+        const parts = token.split('.');
+        if (parts.length !== 3 || !parts[1])
+            return null;
+        const payload = Buffer.from(parts[1], 'base64url').toString('utf-8');
+        return JSON.parse(payload);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXV0aC1ndWFyZC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy9hdXRoLWd1YXJkLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQSwrQ0FBK0M7QUFDL0Msc0NBQXNDOztBQWdCdEMsZ0RBU0M7QUFoQkQ7Ozs7OztHQU1HO0FBQ0gsU0FBZ0Isa0JBQWtCLENBQUMsS0FBYTtJQUM5QyxJQUFJLENBQUM7UUFDSCxNQUFNLEtBQUssR0FBRyxLQUFLLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQy9CLElBQUksS0FBSyxDQUFDLE1BQU0sS0FBSyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO1lBQUUsT0FBTyxJQUFJLENBQUM7UUFDakQsTUFBTSxPQUFPLEdBQUcsTUFBTSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLEVBQUUsV0FBVyxDQUFDLENBQUMsUUFBUSxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQ3JFLE9BQU8sSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQWlCLENBQUM7SUFDN0MsQ0FBQztJQUFDLE1BQU0sQ0FBQztRQUNQLE9BQU8sSUFBSSxDQUFDO0lBQ2QsQ0FBQztBQUNILENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBDb3B5cmlnaHQgMjAyNiBQaXBlbGluZSBCdWlsZGVyIENvbnRyaWJ1dG9yc1xuLy8gU1BEWC1MaWNlbnNlLUlkZW50aWZpZXI6IEFwYWNoZS0yLjBcblxuaW50ZXJmYWNlIFRva2VuUGF5bG9hZCB7XG4gIHJvbGU/OiBzdHJpbmc7XG4gIGlzQWRtaW4/OiBib29sZWFuO1xuICBzdWI/OiBzdHJpbmc7XG4gIG9yZ2FuaXphdGlvbklkPzogc3RyaW5nO1xufVxuXG4vKipcbiAqIERlY29kZSBhIEpXVCB0b2tlbiBwYXlsb2FkIHdpdGhvdXQgc2lnbmF0dXJlIHZlcmlmaWNhdGlvbi5cbiAqXG4gKiBTRUNVUklUWTogTk8gc2lnbmF0dXJlIHZlcmlmaWNhdGlvbi4gVGhlIGRlY29kZWQgcGF5bG9hZCBNVVNUIE5PVCBiZSB1c2VkXG4gKiBmb3IgYXV0aG9yaXphdGlvbiBkZWNpc2lvbnMg4oCUIHRoZSBzZXJ2ZXIgdmFsaWRhdGVzIHRoZSB0b2tlbiBvbiBldmVyeSBBUElcbiAqIGNhbGwuIFVzZSBvbmx5IGZvciBhZHZpc29yeSBVWCBoaW50cy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGRlY29kZVRva2VuUGF5bG9hZCh0b2tlbjogc3RyaW5nKTogVG9rZW5QYXlsb2FkIHwgbnVsbCB7XG4gIHRyeSB7XG4gICAgY29uc3QgcGFydHMgPSB0b2tlbi5zcGxpdCgnLicpO1xuICAgIGlmIChwYXJ0cy5sZW5ndGggIT09IDMgfHwgIXBhcnRzWzFdKSByZXR1cm4gbnVsbDtcbiAgICBjb25zdCBwYXlsb2FkID0gQnVmZmVyLmZyb20ocGFydHNbMV0sICdiYXNlNjR1cmwnKS50b1N0cmluZygndXRmLTgnKTtcbiAgICByZXR1cm4gSlNPTi5wYXJzZShwYXlsb2FkKSBhcyBUb2tlblBheWxvYWQ7XG4gIH0gY2F0Y2gge1xuICAgIHJldHVybiBudWxsO1xuICB9XG59XG4iXX0=

package/dist/utils/aws-secrets.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Options for Secrets Manager operations.
+ */
+export interface SecretsOptions {
+    region?: string;
+    profile?: string;
+}
+/**
+ * Create or update a secret in AWS Secrets Manager.
+ * Tries create first; if it exists, updates the value and description.
+ */
+export declare function upsertSecret(secretName: string, secretValue: string, description: string, options: SecretsOptions): Promise<void>;
+/**
+ * Get the ARN of a secret.
+ */
+export declare function getSecretArn(secretName: string, options: SecretsOptions): Promise<string>;
+/**
+ * Get the value of a secret.
+ */
+export declare function getSecretValue(secretName: string, options: SecretsOptions): Promise<string>;
+//# sourceMappingURL=aws-secrets.d.ts.map

package/dist/utils/aws-secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-secrets.d.ts","sourceRoot":"","sources":["../../src/utils/aws-secrets.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAWD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CASjB"}

package/dist/utils/aws-secrets.js

@@ -0,0 +1,74 @@
+"use strict";
+// Copyright 2026 Pipeline Builder Contributors
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.upsertSecret = upsertSecret;
+exports.getSecretArn = getSecretArn;
+exports.getSecretValue = getSecretValue;
+const client_secrets_manager_1 = require("@aws-sdk/client-secrets-manager");
+const output_utils_1 = require("./output-utils");
+function createClient(options) {
+    return new client_secrets_manager_1.SecretsManagerClient({
+        region: options.region || process.env.AWS_REGION || process.env.CDK_DEFAULT_REGION,
+        ...(options.profile && {
+            credentials: undefined, // profile is handled by AWS SDK credential chain
+        }),
+    });
+}
+/**
+ * Create or update a secret in AWS Secrets Manager.
+ * Tries create first; if it exists, updates the value and description.
+ */
+async function upsertSecret(secretName, secretValue, description, options) {
+    const client = createClient(options);
+    try {
+        await client.send(new client_secrets_manager_1.CreateSecretCommand({
+            Name: secretName,
+            Description: description,
+            SecretString: secretValue,
+        }));
+        (0, output_utils_1.printSuccess)('Secret created in Secrets Manager');
+    }
+    catch (error) {
+        const errMsg = error instanceof Error ? error.message : '';
+        if (errMsg.includes('ResourceExistsException') || errMsg.includes('already exists')) {
+            (0, output_utils_1.printInfo)('Secret already exists, updating...');
+            await client.send(new client_secrets_manager_1.PutSecretValueCommand({
+                SecretId: secretName,
+                SecretString: secretValue,
+            }));
+            await client.send(new client_secrets_manager_1.UpdateSecretCommand({
+                SecretId: secretName,
+                Description: description,
+            }));
+            (0, output_utils_1.printSuccess)('Secret updated in Secrets Manager');
+        }
+        else {
+            throw error;
+        }
+    }
+}
+/**
+ * Get the ARN of a secret.
+ */
+async function getSecretArn(secretName, options) {
+    const client = createClient(options);
+    const response = await client.send(new client_secrets_manager_1.DescribeSecretCommand({
+        SecretId: secretName,
+    }));
+    return response.ARN ?? '(unknown)';
+}
+/**
+ * Get the value of a secret.
+ */
+async function getSecretValue(secretName, options) {
+    const client = createClient(options);
+    const response = await client.send(new client_secrets_manager_1.GetSecretValueCommand({
+        SecretId: secretName,
+    }));
+    if (!response.SecretString) {
+        throw new Error(`Secret "${secretName}" is empty`);
+    }
+    return response.SecretString;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXdzLXNlY3JldHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdXRpbHMvYXdzLXNlY3JldHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBLCtDQUErQztBQUMvQyxzQ0FBc0M7O0FBaUN0QyxvQ0FnQ0M7QUFLRCxvQ0FTQztBQUtELHdDQVlDO0FBOUZELDRFQU95QztBQUN6QyxpREFBeUQ7QUFVekQsU0FBUyxZQUFZLENBQUMsT0FBdUI7SUFDM0MsT0FBTyxJQUFJLDZDQUFvQixDQUFDO1FBQzlCLE1BQU0sRUFBRSxPQUFPLENBQUMsTUFBTSxJQUFJLE9BQU8sQ0FBQyxHQUFHLENBQUMsVUFBVSxJQUFJLE9BQU8sQ0FBQyxHQUFHLENBQUMsa0JBQWtCO1FBQ2xGLEdBQUcsQ0FBQyxPQUFPLENBQUMsT0FBTyxJQUFJO1lBQ3JCLFdBQVcsRUFBRSxTQUFTLEVBQUUsaURBQWlEO1NBQzFFLENBQUM7S0FDSCxDQUFDLENBQUM7QUFDTCxDQUFDO0FBRUQ7OztHQUdHO0FBQ0ksS0FBSyxVQUFVLFlBQVksQ0FDaEMsVUFBa0IsRUFDbEIsV0FBbUIsRUFDbkIsV0FBbUIsRUFDbkIsT0FBdUI7SUFFdkIsTUFBTSxNQUFNLEdBQUcsWUFBWSxDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBRXJDLElBQUksQ0FBQztRQUNILE1BQU0sTUFBTSxDQUFDLElBQUksQ0FBQyxJQUFJLDRDQUFtQixDQUFDO1lBQ3hDLElBQUksRUFBRSxVQUFVO1lBQ2hCLFdBQVcsRUFBRSxXQUFXO1lBQ3hCLFlBQVksRUFBRSxXQUFXO1NBQzFCLENBQUMsQ0FBQyxDQUFDO1FBQ0osSUFBQSwyQkFBWSxFQUFDLG1DQUFtQyxDQUFDLENBQUM7SUFDcEQsQ0FBQztJQUFDLE9BQU8sS0FBSyxFQUFFLENBQUM7UUFDZixNQUFNLE1BQU0sR0FBRyxLQUFLLFlBQVksS0FBSyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7UUFDM0QsSUFBSSxNQUFNLENBQUMsUUFBUSxDQUFDLHlCQUF5QixDQUFDLElBQUksTUFBTSxDQUFDLFFBQVEsQ0FBQyxnQkFBZ0IsQ0FBQyxFQUFFLENBQUM7WUFDcEYsSUFBQSx3QkFBUyxFQUFDLG9DQUFvQyxDQUFDLENBQUM7WUFDaEQsTUFBTSxNQUFNLENBQUMsSUFBSSxDQUFDLElBQUksOENBQXFCLENBQUM7Z0JBQzFDLFFBQVEsRUFBRSxVQUFVO2dCQUNwQixZQUFZLEVBQUUsV0FBVzthQUMxQixDQUFDLENBQUMsQ0FBQztZQUNKLE1BQU0sTUFBTSxDQUFDLElBQUksQ0FBQyxJQUFJLDRDQUFtQixDQUFDO2dCQUN4QyxRQUFRLEVBQUUsVUFBVTtnQkFDcEIsV0FBVyxFQUFFLFdBQVc7YUFDekIsQ0FBQyxDQUFDLENBQUM7WUFDSixJQUFBLDJCQUFZLEVBQUMsbUNBQW1DLENBQUMsQ0FBQztRQUNwRCxDQUFDO2FBQU0sQ0FBQztZQUNOLE1BQU0sS0FBSyxDQUFDO1FBQ2QsQ0FBQztJQUNILENBQUM7QUFDSCxDQUFDO0FBRUQ7O0dBRUc7QUFDSSxLQUFLLFVBQVUsWUFBWSxDQUNoQyxVQUFrQixFQUNsQixPQUF1QjtJQUV2QixNQUFNLE1BQU0sR0FBRyxZQUFZLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDckMsTUFBTSxRQUFRLEdBQUcsTUFBTSxNQUFNLENBQUMsSUFBSSxDQUFDLElBQUksOENBQXFCLENBQUM7UUFDM0QsUUFBUSxFQUFFLFVBQVU7S0FDckIsQ0FBQyxDQUFDLENBQUM7SUFDSixPQUFPLFFBQVEsQ0FBQyxHQUFHLElBQUksV0FBVyxDQUFDO0FBQ3JDLENBQUM7QUFFRDs7R0FFRztBQUNJLEtBQUssVUFBVSxjQUFjLENBQ2xDLFVBQWtCLEVBQ2xCLE9BQXVCO0lBRXZCLE1BQU0sTUFBTSxHQUFHLFlBQVksQ0FBQyxPQUFPLENBQUMsQ0FBQztJQUNyQyxNQUFNLFFBQVEsR0FBRyxNQUFNLE1BQU0sQ0FBQyxJQUFJLENBQUMsSUFBSSw4Q0FBcUIsQ0FBQztRQUMzRCxRQUFRLEVBQUUsVUFBVTtLQUNyQixDQUFDLENBQUMsQ0FBQztJQUNKLElBQUksQ0FBQyxRQUFRLENBQUMsWUFBWSxFQUFFLENBQUM7UUFDM0IsTUFBTSxJQUFJLEtBQUssQ0FBQyxXQUFXLFVBQVUsWUFBWSxDQUFDLENBQUM7SUFDckQsQ0FBQztJQUNELE9BQU8sUUFBUSxDQUFDLFlBQVksQ0FBQztBQUMvQixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLy8gQ29weXJpZ2h0IDIwMjYgUGlwZWxpbmUgQnVpbGRlciBDb250cmlidXRvcnNcbi8vIFNQRFgtTGljZW5zZS1JZGVudGlmaWVyOiBBcGFjaGUtMi4wXG5cbmltcG9ydCB7XG4gIFNlY3JldHNNYW5hZ2VyQ2xpZW50LFxuICBDcmVhdGVTZWNyZXRDb21tYW5kLFxuICBQdXRTZWNyZXRWYWx1ZUNvbW1hbmQsXG4gIFVwZGF0ZVNlY3JldENvbW1hbmQsXG4gIERlc2NyaWJlU2VjcmV0Q29tbWFuZCxcbiAgR2V0U2VjcmV0VmFsdWVDb21tYW5kLFxufSBmcm9tICdAYXdzLXNkay9jbGllbnQtc2VjcmV0cy1tYW5hZ2VyJztcbmltcG9ydCB7IHByaW50SW5mbywgcHJpbnRTdWNjZXNzIH0gZnJvbSAnLi9vdXRwdXQtdXRpbHMnO1xuXG4vKipcbiAqIE9wdGlvbnMgZm9yIFNlY3JldHMgTWFuYWdlciBvcGVyYXRpb25zLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFNlY3JldHNPcHRpb25zIHtcbiAgcmVnaW9uPzogc3RyaW5nO1xuICBwcm9maWxlPzogc3RyaW5nO1xufVxuXG5mdW5jdGlvbiBjcmVhdGVDbGllbnQob3B0aW9uczogU2VjcmV0c09wdGlvbnMpOiBTZWNyZXRzTWFuYWdlckNsaWVudCB7XG4gIHJldHVybiBuZXcgU2VjcmV0c01hbmFnZXJDbGllbnQoe1xuICAgIHJlZ2lvbjogb3B0aW9ucy5yZWdpb24gfHwgcHJvY2Vzcy5lbnYuQVdTX1JFR0lPTiB8fCBwcm9jZXNzLmVudi5DREtfREVGQVVMVF9SRUdJT04sXG4gICAgLi4uKG9wdGlvbnMucHJvZmlsZSAmJiB7XG4gICAgICBjcmVkZW50aWFsczogdW5kZWZpbmVkLCAvLyBwcm9maWxlIGlzIGhhbmRsZWQgYnkgQVdTIFNESyBjcmVkZW50aWFsIGNoYWluXG4gICAgfSksXG4gIH0pO1xufVxuXG4vKipcbiAqIENyZWF0ZSBvciB1cGRhdGUgYSBzZWNyZXQgaW4gQVdTIFNlY3JldHMgTWFuYWdlci5cbiAqIFRyaWVzIGNyZWF0ZSBmaXJzdDsgaWYgaXQgZXhpc3RzLCB1cGRhdGVzIHRoZSB2YWx1ZSBhbmQgZGVzY3JpcHRpb24uXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiB1cHNlcnRTZWNyZXQoXG4gIHNlY3JldE5hbWU6IHN0cmluZyxcbiAgc2VjcmV0VmFsdWU6IHN0cmluZyxcbiAgZGVzY3JpcHRpb246IHN0cmluZyxcbiAgb3B0aW9uczogU2VjcmV0c09wdGlvbnMsXG4pOiBQcm9taXNlPHZvaWQ+IHtcbiAgY29uc3QgY2xpZW50ID0gY3JlYXRlQ2xpZW50KG9wdGlvbnMpO1xuXG4gIHRyeSB7XG4gICAgYXdhaXQgY2xpZW50LnNlbmQobmV3IENyZWF0ZVNlY3JldENvbW1hbmQoe1xuICAgICAgTmFtZTogc2VjcmV0TmFtZSxcbiAgICAgIERlc2NyaXB0aW9uOiBkZXNjcmlwdGlvbixcbiAgICAgIFNlY3JldFN0cmluZzogc2VjcmV0VmFsdWUsXG4gICAgfSkpO1xuICAgIHByaW50U3VjY2VzcygnU2VjcmV0IGNyZWF0ZWQgaW4gU2VjcmV0cyBNYW5hZ2VyJyk7XG4gIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgY29uc3QgZXJyTXNnID0gZXJyb3IgaW5zdGFuY2VvZiBFcnJvciA/IGVycm9yLm1lc3NhZ2UgOiAnJztcbiAgICBpZiAoZXJyTXNnLmluY2x1ZGVzKCdSZXNvdXJjZUV4aXN0c0V4Y2VwdGlvbicpIHx8IGVyck1zZy5pbmNsdWRlcygnYWxyZWFkeSBleGlzdHMnKSkge1xuICAgICAgcHJpbnRJbmZvKCdTZWNyZXQgYWxyZWFkeSBleGlzdHMsIHVwZGF0aW5nLi4uJyk7XG4gICAgICBhd2FpdCBjbGllbnQuc2VuZChuZXcgUHV0U2VjcmV0VmFsdWVDb21tYW5kKHtcbiAgICAgICAgU2VjcmV0SWQ6IHNlY3JldE5hbWUsXG4gICAgICAgIFNlY3JldFN0cmluZzogc2VjcmV0VmFsdWUsXG4gICAgICB9KSk7XG4gICAgICBhd2FpdCBjbGllbnQuc2VuZChuZXcgVXBkYXRlU2VjcmV0Q29tbWFuZCh7XG4gICAgICAgIFNlY3JldElkOiBzZWNyZXROYW1lLFxuICAgICAgICBEZXNjcmlwdGlvbjogZGVzY3JpcHRpb24sXG4gICAgICB9KSk7XG4gICAgICBwcmludFN1Y2Nlc3MoJ1NlY3JldCB1cGRhdGVkIGluIFNlY3JldHMgTWFuYWdlcicpO1xuICAgIH0gZWxzZSB7XG4gICAgICB0aHJvdyBlcnJvcjtcbiAgICB9XG4gIH1cbn1cblxuLyoqXG4gKiBHZXQgdGhlIEFSTiBvZiBhIHNlY3JldC5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGdldFNlY3JldEFybihcbiAgc2VjcmV0TmFtZTogc3RyaW5nLFxuICBvcHRpb25zOiBTZWNyZXRzT3B0aW9ucyxcbik6IFByb21pc2U8c3RyaW5nPiB7XG4gIGNvbnN0IGNsaWVudCA9IGNyZWF0ZUNsaWVudChvcHRpb25zKTtcbiAgY29uc3QgcmVzcG9uc2UgPSBhd2FpdCBjbGllbnQuc2VuZChuZXcgRGVzY3JpYmVTZWNyZXRDb21tYW5kKHtcbiAgICBTZWNyZXRJZDogc2VjcmV0TmFtZSxcbiAgfSkpO1xuICByZXR1cm4gcmVzcG9uc2UuQVJOID8/ICcodW5rbm93biknO1xufVxuXG4vKipcbiAqIEdldCB0aGUgdmFsdWUgb2YgYSBzZWNyZXQuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBnZXRTZWNyZXRWYWx1ZShcbiAgc2VjcmV0TmFtZTogc3RyaW5nLFxuICBvcHRpb25zOiBTZWNyZXRzT3B0aW9ucyxcbik6IFByb21pc2U8c3RyaW5nPiB7XG4gIGNvbnN0IGNsaWVudCA9IGNyZWF0ZUNsaWVudChvcHRpb25zKTtcbiAgY29uc3QgcmVzcG9uc2UgPSBhd2FpdCBjbGllbnQuc2VuZChuZXcgR2V0U2VjcmV0VmFsdWVDb21tYW5kKHtcbiAgICBTZWNyZXRJZDogc2VjcmV0TmFtZSxcbiAgfSkpO1xuICBpZiAoIXJlc3BvbnNlLlNlY3JldFN0cmluZykge1xuICAgIHRocm93IG5ldyBFcnJvcihgU2VjcmV0IFwiJHtzZWNyZXROYW1lfVwiIGlzIGVtcHR5YCk7XG4gIH1cbiAgcmV0dXJuIHJlc3BvbnNlLlNlY3JldFN0cmluZztcbn1cbiJdfQ==

package/dist/utils/banner.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Banner display options
+ */
+export interface BannerOptions {
+    showDescription?: boolean;
+    minimal?: boolean;
+    message?: string;
+    showTimestamp?: boolean;
+    showExecutionId?: boolean;
+}
+/**
+ * Display CLI banner with application info
+ */
+export declare function banner(options?: BannerOptions): void;
+/**
+ * Display a minimal banner (name and version only)
+ */
+export declare function miniBanner(): void;
+//# sourceMappingURL=banner.d.ts.map

package/dist/utils/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/utils/banner.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,IAAI,CA8CxD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAMjC"}

package/dist/utils/banner.js

@@ -0,0 +1,59 @@
+"use strict";
+// Copyright 2026 Pipeline Builder Contributors
+// SPDX-License-Identifier: Apache-2.0
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.banner = banner;
+exports.miniBanner = miniBanner;
+const figlet_1 = __importDefault(require("figlet"));
+const picocolors_1 = __importDefault(require("picocolors"));
+const cli_constants_1 = require("../config/cli.constants");
+const { bold, green, cyan, dim } = picocolors_1.default;
+/**
+ * Display CLI banner with application info
+ */
+function banner(options = {}) {
+    const { showDescription = true, minimal = false, message, showTimestamp = false, showExecutionId = false, } = options;
+    if (minimal) {
+        console.log(green(bold(`[${cli_constants_1.APP_NAME.toUpperCase()}]`)), cyan(`v${cli_constants_1.APP_VERSION}`));
+        if (message)
+            console.log(dim(message));
+        if (showExecutionId)
+            console.log(dim(`Execution ID: ${(0, cli_constants_1.generateExecutionId)()}`));
+        console.log('');
+        return;
+    }
+    // Full banner with ASCII art
+    try {
+        const asciiArt = figlet_1.default.textSync('Pipeline Manager', cli_constants_1.BANNER_OPTIONS);
+        console.log(green(asciiArt));
+    }
+    catch {
+        const width = cli_constants_1.BANNER_OPTIONS.getWidth();
+        console.log(green(bold('═'.repeat(width))));
+        console.log(green(bold(`  ${cli_constants_1.APP_NAME.toUpperCase()}`)));
+        console.log(green(bold('═'.repeat(width))));
+    }
+    console.log(green(bold(`[${cli_constants_1.APP_NAME.toUpperCase()}]`)), cyan(`v${cli_constants_1.APP_VERSION}`));
+    if (message) {
+        console.log(dim(message));
+    }
+    else if (showDescription) {
+        console.log(dim(cli_constants_1.APP_DESCRIPTION));
+    }
+    if (showExecutionId)
+        console.log(dim(`Execution ID: ${(0, cli_constants_1.generateExecutionId)()}`));
+    if (showTimestamp)
+        console.log(dim(`Started: ${new Date().toLocaleString()}`));
+    console.log('');
+}
+/**
+ * Display a minimal banner (name and version only)
+ */
+function miniBanner() {
+    console.log(green(bold(`[${cli_constants_1.APP_NAME.toUpperCase()}]`)), cyan(`v${cli_constants_1.APP_VERSION}`));
+    console.log('');
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmFubmVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3V0aWxzL2Jhbm5lci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUEsK0NBQStDO0FBQy9DLHNDQUFzQzs7Ozs7QUE0QnRDLHdCQThDQztBQUtELGdDQU1DO0FBbkZELG9EQUE0QjtBQUM1Qiw0REFBOEI7QUFDOUIsMkRBTWlDO0FBRWpDLE1BQU0sRUFBRSxJQUFJLEVBQUUsS0FBSyxFQUFFLElBQUksRUFBRSxHQUFHLEVBQUUsR0FBRyxvQkFBSSxDQUFDO0FBYXhDOztHQUVHO0FBQ0gsU0FBZ0IsTUFBTSxDQUFDLFVBQXlCLEVBQUU7SUFDaEQsTUFBTSxFQUNKLGVBQWUsR0FBRyxJQUFJLEVBQ3RCLE9BQU8sR0FBRyxLQUFLLEVBQ2YsT0FBTyxFQUNQLGFBQWEsR0FBRyxLQUFLLEVBQ3JCLGVBQWUsR0FBRyxLQUFLLEdBQ3hCLEdBQUcsT0FBTyxDQUFDO0lBRVosSUFBSSxPQUFPLEVBQUUsQ0FBQztRQUNaLE9BQU8sQ0FBQyxHQUFHLENBQ1QsS0FBSyxDQUFDLElBQUksQ0FBQyxJQUFJLHdCQUFRLENBQUMsV0FBVyxFQUFFLEdBQUcsQ0FBQyxDQUFDLEVBQzFDLElBQUksQ0FBQyxJQUFJLDJCQUFXLEVBQUUsQ0FBQyxDQUN4QixDQUFDO1FBQ0YsSUFBSSxPQUFPO1lBQUUsT0FBTyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQztRQUN2QyxJQUFJLGVBQWU7WUFBRSxPQUFPLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxpQkFBaUIsSUFBQSxtQ0FBbUIsR0FBRSxFQUFFLENBQUMsQ0FBQyxDQUFDO1FBQ2hGLE9BQU8sQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDLENBQUM7UUFDaEIsT0FBTztJQUNULENBQUM7SUFFRCw2QkFBNkI7SUFDN0IsSUFBSSxDQUFDO1FBQ0gsTUFBTSxRQUFRLEdBQUcsZ0JBQU0sQ0FBQyxRQUFRLENBQUMsa0JBQWtCLEVBQUUsOEJBQWMsQ0FBQyxDQUFDO1FBQ3JFLE9BQU8sQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUM7SUFDL0IsQ0FBQztJQUFDLE1BQU0sQ0FBQztRQUNQLE1BQU0sS0FBSyxHQUFHLDhCQUFjLENBQUMsUUFBUSxFQUFFLENBQUM7UUFDeEMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFDNUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLEtBQUssd0JBQVEsQ0FBQyxXQUFXLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDO1FBQ3hELE9BQU8sQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBQzlDLENBQUM7SUFFRCxPQUFPLENBQUMsR0FBRyxDQUNULEtBQUssQ0FBQyxJQUFJLENBQUMsSUFBSSx3QkFBUSxDQUFDLFdBQVcsRUFBRSxHQUFHLENBQUMsQ0FBQyxFQUMxQyxJQUFJLENBQUMsSUFBSSwyQkFBVyxFQUFFLENBQUMsQ0FDeEIsQ0FBQztJQUVGLElBQUksT0FBTyxFQUFFLENBQUM7UUFDWixPQUFPLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDO0lBQzVCLENBQUM7U0FBTSxJQUFJLGVBQWUsRUFBRSxDQUFDO1FBQzNCLE9BQU8sQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLCtCQUFlLENBQUMsQ0FBQyxDQUFDO0lBQ3BDLENBQUM7SUFFRCxJQUFJLGVBQWU7UUFBRSxPQUFPLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxpQkFBaUIsSUFBQSxtQ0FBbUIsR0FBRSxFQUFFLENBQUMsQ0FBQyxDQUFDO0lBQ2hGLElBQUksYUFBYTtRQUFFLE9BQU8sQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLFlBQVksSUFBSSxJQUFJLEVBQUUsQ0FBQyxjQUFjLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQztJQUUvRSxPQUFPLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxDQUFDO0FBQ2xCLENBQUM7QUFFRDs7R0FFRztBQUNILFNBQWdCLFVBQVU7SUFDeEIsT0FBTyxDQUFDLEdBQUcsQ0FDVCxLQUFLLENBQUMsSUFBSSxDQUFDLElBQUksd0JBQVEsQ0FBQyxXQUFXLEVBQUUsR0FBRyxDQUFDLENBQUMsRUFDMUMsSUFBSSxDQUFDLElBQUksMkJBQVcsRUFBRSxDQUFDLENBQ3hCLENBQUM7SUFDRixPQUFPLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxDQUFDO0FBQ2xCLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBDb3B5cmlnaHQgMjAyNiBQaXBlbGluZSBCdWlsZGVyIENvbnRyaWJ1dG9yc1xuLy8gU1BEWC1MaWNlbnNlLUlkZW50aWZpZXI6IEFwYWNoZS0yLjBcblxuaW1wb3J0IGZpZ2xldCBmcm9tICdmaWdsZXQnO1xuaW1wb3J0IHBpY28gZnJvbSAncGljb2NvbG9ycyc7XG5pbXBvcnQge1xuICBBUFBfREVTQ1JJUFRJT04sXG4gIEFQUF9OQU1FLFxuICBBUFBfVkVSU0lPTixcbiAgQkFOTkVSX09QVElPTlMsXG4gIGdlbmVyYXRlRXhlY3V0aW9uSWQsXG59IGZyb20gJy4uL2NvbmZpZy9jbGkuY29uc3RhbnRzJztcblxuY29uc3QgeyBib2xkLCBncmVlbiwgY3lhbiwgZGltIH0gPSBwaWNvO1xuXG4vKipcbiAqIEJhbm5lciBkaXNwbGF5IG9wdGlvbnNcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBCYW5uZXJPcHRpb25zIHtcbiAgc2hvd0Rlc2NyaXB0aW9uPzogYm9vbGVhbjtcbiAgbWluaW1hbD86IGJvb2xlYW47XG4gIG1lc3NhZ2U/OiBzdHJpbmc7XG4gIHNob3dUaW1lc3RhbXA/OiBib29sZWFuO1xuICBzaG93RXhlY3V0aW9uSWQ/OiBib29sZWFuO1xufVxuXG4vKipcbiAqIERpc3BsYXkgQ0xJIGJhbm5lciB3aXRoIGFwcGxpY2F0aW9uIGluZm9cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGJhbm5lcihvcHRpb25zOiBCYW5uZXJPcHRpb25zID0ge30pOiB2b2lkIHtcbiAgY29uc3Qge1xuICAgIHNob3dEZXNjcmlwdGlvbiA9IHRydWUsXG4gICAgbWluaW1hbCA9IGZhbHNlLFxuICAgIG1lc3NhZ2UsXG4gICAgc2hvd1RpbWVzdGFtcCA9IGZhbHNlLFxuICAgIHNob3dFeGVjdXRpb25JZCA9IGZhbHNlLFxuICB9ID0gb3B0aW9ucztcblxuICBpZiAobWluaW1hbCkge1xuICAgIGNvbnNvbGUubG9nKFxuICAgICAgZ3JlZW4oYm9sZChgWyR7QVBQX05BTUUudG9VcHBlckNhc2UoKX1dYCkpLFxuICAgICAgY3lhbihgdiR7QVBQX1ZFUlNJT059YCksXG4gICAgKTtcbiAgICBpZiAobWVzc2FnZSkgY29uc29sZS5sb2coZGltKG1lc3NhZ2UpKTtcbiAgICBpZiAoc2hvd0V4ZWN1dGlvbklkKSBjb25zb2xlLmxvZyhkaW0oYEV4ZWN1dGlvbiBJRDogJHtnZW5lcmF0ZUV4ZWN1dGlvbklkKCl9YCkpO1xuICAgIGNvbnNvbGUubG9nKCcnKTtcbiAgICByZXR1cm47XG4gIH1cblxuICAvLyBGdWxsIGJhbm5lciB3aXRoIEFTQ0lJIGFydFxuICB0cnkge1xuICAgIGNvbnN0IGFzY2lpQXJ0ID0gZmlnbGV0LnRleHRTeW5jKCdQaXBlbGluZSBNYW5hZ2VyJywgQkFOTkVSX09QVElPTlMpO1xuICAgIGNvbnNvbGUubG9nKGdyZWVuKGFzY2lpQXJ0KSk7XG4gIH0gY2F0Y2gge1xuICAgIGNvbnN0IHdpZHRoID0gQkFOTkVSX09QVElPTlMuZ2V0V2lkdGgoKTtcbiAgICBjb25zb2xlLmxvZyhncmVlbihib2xkKCfilZAnLnJlcGVhdCh3aWR0aCkpKSk7XG4gICAgY29uc29sZS5sb2coZ3JlZW4oYm9sZChgICAke0FQUF9OQU1FLnRvVXBwZXJDYXNlKCl9YCkpKTtcbiAgICBjb25zb2xlLmxvZyhncmVlbihib2xkKCfilZAnLnJlcGVhdCh3aWR0aCkpKSk7XG4gIH1cblxuICBjb25zb2xlLmxvZyhcbiAgICBncmVlbihib2xkKGBbJHtBUFBfTkFNRS50b1VwcGVyQ2FzZSgpfV1gKSksXG4gICAgY3lhbihgdiR7QVBQX1ZFUlNJT059YCksXG4gICk7XG5cbiAgaWYgKG1lc3NhZ2UpIHtcbiAgICBjb25zb2xlLmxvZyhkaW0obWVzc2FnZSkpO1xuICB9IGVsc2UgaWYgKHNob3dEZXNjcmlwdGlvbikge1xuICAgIGNvbnNvbGUubG9nKGRpbShBUFBfREVTQ1JJUFRJT04pKTtcbiAgfVxuXG4gIGlmIChzaG93RXhlY3V0aW9uSWQpIGNvbnNvbGUubG9nKGRpbShgRXhlY3V0aW9uIElEOiAke2dlbmVyYXRlRXhlY3V0aW9uSWQoKX1gKSk7XG4gIGlmIChzaG93VGltZXN0YW1wKSBjb25zb2xlLmxvZyhkaW0oYFN0YXJ0ZWQ6ICR7bmV3IERhdGUoKS50b0xvY2FsZVN0cmluZygpfWApKTtcblxuICBjb25zb2xlLmxvZygnJyk7XG59XG5cbi8qKlxuICogRGlzcGxheSBhIG1pbmltYWwgYmFubmVyIChuYW1lIGFuZCB2ZXJzaW9uIG9ubHkpXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBtaW5pQmFubmVyKCk6IHZvaWQge1xuICBjb25zb2xlLmxvZyhcbiAgICBncmVlbihib2xkKGBbJHtBUFBfTkFNRS50b1VwcGVyQ2FzZSgpfV1gKSksXG4gICAgY3lhbihgdiR7QVBQX1ZFUlNJT059YCksXG4gICk7XG4gIGNvbnNvbGUubG9nKCcnKTtcbn1cbiJdfQ==

package/dist/utils/cdk-utils.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Path to dist/boilerplate.js. tsc emits commands at dist/commands/, so
+ * boilerplate is one level up.
+ */
+export declare function resolveBoilerplatePath(callerDir: string): string;
+export interface CdkInfo {
+    available: boolean;
+    version: string | null;
+    error?: string;
+}
+/**
+ * Checks whether the AWS CDK CLI is installed and returns its version.
+ */
+export declare function getCdkInfo(): CdkInfo;
+/**
+ * Checks whether the AWS CDK CLI is installed and accessible on the PATH.
+ */
+export declare function checkCdkAvailable(): boolean;
+/**
+ * Asserts that the AWS CDK CLI is installed; throws with a user-friendly
+ * message + install hint when it isn't. Use at the top of any command that
+ * shells out to `cdk`.
+ */
+export declare function ensureCdkAvailable(): void;
+/**
+ * Options for executing a CDK shell command.
+ */
+export interface CdkShellOptions {
+    /** When `true`, prints the error to stderr on failure. */
+    debug?: boolean;
+    /** When `true`, inherits stdio so output streams to the terminal. Defaults to `true`. */
+    showOutput?: boolean;
+    /** Additional environment variables to inject. */
+    env?: Record<string, string>;
+}
+/**
+ * Result of a CDK shell command execution.
+ */
+export interface CdkShellResult {
+    success: boolean;
+    duration: number;
+}
+/**
+ * Executes a CDK CLI command as a child process.
+ *
+ * @param command - The full CDK CLI command string (e.g., `cdk bootstrap ...`).
+ * @param options - Optional execution settings.
+ * @returns An object with `success` and `duration` in ms.
+ */
+export declare function executeCdkShellCommand(command: string, options?: CdkShellOptions): CdkShellResult;
+//# sourceMappingURL=cdk-utils.d.ts.map

package/dist/utils/cdk-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdk-utils.d.ts","sourceRoot":"","sources":["../../src/utils/cdk-utils.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAOpC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAKzC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yFAAyF;IACzF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,eAAoB,GAC5B,cAAc,CA2ChB"}

package/dist/utils/cdk-utils.js

@@ -0,0 +1,101 @@
+"use strict";
+// Copyright 2026 Pipeline Builder Contributors
+// SPDX-License-Identifier: Apache-2.0
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveBoilerplatePath = resolveBoilerplatePath;
+exports.getCdkInfo = getCdkInfo;
+exports.checkCdkAvailable = checkCdkAvailable;
+exports.ensureCdkAvailable = ensureCdkAvailable;
+exports.executeCdkShellCommand = executeCdkShellCommand;
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const output_utils_1 = require("./output-utils");
+/**
+ * Path to dist/boilerplate.js. tsc emits commands at dist/commands/, so
+ * boilerplate is one level up.
+ */
+function resolveBoilerplatePath(callerDir) {
+    return path_1.default.join(callerDir, '..', 'boilerplate.js');
+}
+/**
+ * Checks whether the AWS CDK CLI is installed and returns its version.
+ */
+function getCdkInfo() {
+    try {
+        const output = (0, child_process_1.execSync)('cdk --version', { encoding: 'utf-8', stdio: 'pipe' });
+        return { available: true, version: output.trim() };
+    }
+    catch (error) {
+        return { available: false, version: null, error: error instanceof Error ? error.message : 'Unknown error' };
+    }
+}
+/**
+ * Checks whether the AWS CDK CLI is installed and accessible on the PATH.
+ */
+function checkCdkAvailable() {
+    return getCdkInfo().available;
+}
+/**
+ * Asserts that the AWS CDK CLI is installed; throws with a user-friendly
+ * message + install hint when it isn't. Use at the top of any command that
+ * shells out to `cdk`.
+ */
+function ensureCdkAvailable() {
+    if (checkCdkAvailable())
+        return;
+    (0, output_utils_1.printError)('AWS CDK is not installed or not accessible');
+    console.log('Install CDK with: npm install -g aws-cdk');
+    throw new Error('AWS CDK not found');
+}
+/**
+ * Executes a CDK CLI command as a child process.
+ *
+ * @param command - The full CDK CLI command string (e.g., `cdk bootstrap ...`).
+ * @param options - Optional execution settings.
+ * @returns An object with `success` and `duration` in ms.
+ */
+function executeCdkShellCommand(command, options = {}) {
+    const { debug = false, showOutput = true, env: extraEnv } = options;
+    const startTime = Date.now();
+    try {
+        const env = {
+            ...process.env,
+            ...extraEnv,
+        };
+        (0, child_process_1.execSync)(command, {
+            stdio: showOutput ? ['inherit', 'inherit', 'pipe'] : 'pipe',
+            env,
+        });
+        const duration = Date.now() - startTime;
+        return {
+            success: true,
+            duration,
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        // Extract stderr/stdout from execSync error when available
+        if (error && typeof error === 'object' && 'stderr' in error) {
+            const execError = error;
+            const stderr = execError.stderr?.toString().trim();
+            const stdout = execError.stdout?.toString().trim();
+            console.error('');
+            console.error('CDK deployment failed:');
+            if (stderr)
+                console.error(stderr);
+            if (stdout)
+                console.error(stdout);
+            if (execError.status !== undefined) {
+                console.error(`Exit code: ${execError.status} (after ${duration}ms)`);
+            }
+        }
+        else if (debug) {
+            console.error('CDK execution failed:', error);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2RrLXV0aWxzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3V0aWxzL2Nkay11dGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUEsK0NBQStDO0FBQy9DLHNDQUFzQzs7Ozs7QUFVdEMsd0RBRUM7QUFXRCxnQ0FPQztBQUtELDhDQUVDO0FBT0QsZ0RBS0M7QUE2QkQsd0RBOENDO0FBMUhELGlEQUF5QztBQUN6QyxnREFBd0I7QUFDeEIsaURBQTRDO0FBRTVDOzs7R0FHRztBQUNILFNBQWdCLHNCQUFzQixDQUFDLFNBQWlCO0lBQ3RELE9BQU8sY0FBSSxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsSUFBSSxFQUFFLGdCQUFnQixDQUFDLENBQUM7QUFDdEQsQ0FBQztBQVFEOztHQUVHO0FBQ0gsU0FBZ0IsVUFBVTtJQUN4QixJQUFJLENBQUM7UUFDSCxNQUFNLE1BQU0sR0FBRyxJQUFBLHdCQUFRLEVBQUMsZUFBZSxFQUFFLEVBQUUsUUFBUSxFQUFFLE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSxFQUFFLENBQUMsQ0FBQztRQUMvRSxPQUFPLEVBQUUsU0FBUyxFQUFFLElBQUksRUFBRSxPQUFPLEVBQUUsTUFBTSxDQUFDLElBQUksRUFBRSxFQUFFLENBQUM7SUFDckQsQ0FBQztJQUFDLE9BQU8sS0FBSyxFQUFFLENBQUM7UUFDZixPQUFPLEVBQUUsU0FBUyxFQUFFLEtBQUssRUFBRSxPQUFPLEVBQUUsSUFBSSxFQUFFLEtBQUssRUFBRSxLQUFLLFlBQVksS0FBSyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxlQUFlLEVBQUUsQ0FBQztJQUM5RyxDQUFDO0FBQ0gsQ0FBQztBQUVEOztHQUVHO0FBQ0gsU0FBZ0IsaUJBQWlCO0lBQy9CLE9BQU8sVUFBVSxFQUFFLENBQUMsU0FBUyxDQUFDO0FBQ2hDLENBQUM7QUFFRDs7OztHQUlHO0FBQ0gsU0FBZ0Isa0JBQWtCO0lBQ2hDLElBQUksaUJBQWlCLEVBQUU7UUFBRSxPQUFPO0lBQ2hDLElBQUEseUJBQVUsRUFBQyw0Q0FBNEMsQ0FBQyxDQUFDO0lBQ3pELE9BQU8sQ0FBQyxHQUFHLENBQUMsMENBQTBDLENBQUMsQ0FBQztJQUN4RCxNQUFNLElBQUksS0FBSyxDQUFDLG1CQUFtQixDQUFDLENBQUM7QUFDdkMsQ0FBQztBQXNCRDs7Ozs7O0dBTUc7QUFDSCxTQUFnQixzQkFBc0IsQ0FDcEMsT0FBZSxFQUNmLFVBQTJCLEVBQUU7SUFFN0IsTUFBTSxFQUFFLEtBQUssR0FBRyxLQUFLLEVBQUUsVUFBVSxHQUFHLElBQUksRUFBRSxHQUFHLEVBQUUsUUFBUSxFQUFFLEdBQUcsT0FBTyxDQUFDO0lBQ3BFLE1BQU0sU0FBUyxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQztJQUU3QixJQUFJLENBQUM7UUFDSCxNQUFNLEdBQUcsR0FBRztZQUNWLEdBQUcsT0FBTyxDQUFDLEdBQUc7WUFDZCxHQUFHLFFBQVE7U0FDWixDQUFDO1FBRUYsSUFBQSx3QkFBUSxFQUFDLE9BQU8sRUFBRTtZQUNoQixLQUFLLEVBQUUsVUFBVSxDQUFDLENBQUMsQ0FBQyxDQUFDLFNBQVMsRUFBRSxTQUFTLEVBQUUsTUFBTSxDQUFDLENBQUMsQ0FBQyxDQUFDLE1BQU07WUFDM0QsR0FBRztTQUNKLENBQUMsQ0FBQztRQUVILE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUUsR0FBRyxTQUFTLENBQUM7UUFFeEMsT0FBTztZQUNMLE9BQU8sRUFBRSxJQUFJO1lBQ2IsUUFBUTtTQUNULENBQUM7SUFDSixDQUFDO0lBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztRQUNmLE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUUsR0FBRyxTQUFTLENBQUM7UUFFeEMsMkRBQTJEO1FBQzNELElBQUksS0FBSyxJQUFJLE9BQU8sS0FBSyxLQUFLLFFBQVEsSUFBSSxRQUFRLElBQUksS0FBSyxFQUFFLENBQUM7WUFDNUQsTUFBTSxTQUFTLEdBQUcsS0FBZ0YsQ0FBQztZQUNuRyxNQUFNLE1BQU0sR0FBRyxTQUFTLENBQUMsTUFBTSxFQUFFLFFBQVEsRUFBRSxDQUFDLElBQUksRUFBRSxDQUFDO1lBQ25ELE1BQU0sTUFBTSxHQUFHLFNBQVMsQ0FBQyxNQUFNLEVBQUUsUUFBUSxFQUFFLENBQUMsSUFBSSxFQUFFLENBQUM7WUFFbkQsT0FBTyxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUMsQ0FBQztZQUNsQixPQUFPLENBQUMsS0FBSyxDQUFDLHdCQUF3QixDQUFDLENBQUM7WUFDeEMsSUFBSSxNQUFNO2dCQUFFLE9BQU8sQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLENBQUM7WUFDbEMsSUFBSSxNQUFNO2dCQUFFLE9BQU8sQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLENBQUM7WUFDbEMsSUFBSSxTQUFTLENBQUMsTUFBTSxLQUFLLFNBQVMsRUFBRSxDQUFDO2dCQUNuQyxPQUFPLENBQUMsS0FBSyxDQUFDLGNBQWMsU0FBUyxDQUFDLE1BQU0sV0FBVyxRQUFRLEtBQUssQ0FBQyxDQUFDO1lBQ3hFLENBQUM7UUFDSCxDQUFDO2FBQU0sSUFBSSxLQUFLLEVBQUUsQ0FBQztZQUNqQixPQUFPLENBQUMsS0FBSyxDQUFDLHVCQUF1QixFQUFFLEtBQUssQ0FBQyxDQUFDO1FBQ2hELENBQUM7UUFFRCxNQUFNLEtBQUssQ0FBQztJQUNkLENBQUM7QUFDSCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLy8gQ29weXJpZ2h0IDIwMjYgUGlwZWxpbmUgQnVpbGRlciBDb250cmlidXRvcnNcbi8vIFNQRFgtTGljZW5zZS1JZGVudGlmaWVyOiBBcGFjaGUtMi4wXG5cbmltcG9ydCB7IGV4ZWNTeW5jIH0gZnJvbSAnY2hpbGRfcHJvY2Vzcyc7XG5pbXBvcnQgcGF0aCBmcm9tICdwYXRoJztcbmltcG9ydCB7IHByaW50RXJyb3IgfSBmcm9tICcuL291dHB1dC11dGlscyc7XG5cbi8qKlxuICogUGF0aCB0byBkaXN0L2JvaWxlcnBsYXRlLmpzLiB0c2MgZW1pdHMgY29tbWFuZHMgYXQgZGlzdC9jb21tYW5kcy8sIHNvXG4gKiBib2lsZXJwbGF0ZSBpcyBvbmUgbGV2ZWwgdXAuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiByZXNvbHZlQm9pbGVycGxhdGVQYXRoKGNhbGxlckRpcjogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIHBhdGguam9pbihjYWxsZXJEaXIsICcuLicsICdib2lsZXJwbGF0ZS5qcycpO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIENka0luZm8ge1xuICBhdmFpbGFibGU6IGJvb2xlYW47XG4gIHZlcnNpb246IHN0cmluZyB8IG51bGw7XG4gIGVycm9yPzogc3RyaW5nO1xufVxuXG4vKipcbiAqIENoZWNrcyB3aGV0aGVyIHRoZSBBV1MgQ0RLIENMSSBpcyBpbnN0YWxsZWQgYW5kIHJldHVybnMgaXRzIHZlcnNpb24uXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRDZGtJbmZvKCk6IENka0luZm8ge1xuICB0cnkge1xuICAgIGNvbnN0IG91dHB1dCA9IGV4ZWNTeW5jKCdjZGsgLS12ZXJzaW9uJywgeyBlbmNvZGluZzogJ3V0Zi04Jywgc3RkaW86ICdwaXBlJyB9KTtcbiAgICByZXR1cm4geyBhdmFpbGFibGU6IHRydWUsIHZlcnNpb246IG91dHB1dC50cmltKCkgfTtcbiAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICByZXR1cm4geyBhdmFpbGFibGU6IGZhbHNlLCB2ZXJzaW9uOiBudWxsLCBlcnJvcjogZXJyb3IgaW5zdGFuY2VvZiBFcnJvciA/IGVycm9yLm1lc3NhZ2UgOiAnVW5rbm93biBlcnJvcicgfTtcbiAgfVxufVxuXG4vKipcbiAqIENoZWNrcyB3aGV0aGVyIHRoZSBBV1MgQ0RLIENMSSBpcyBpbnN0YWxsZWQgYW5kIGFjY2Vzc2libGUgb24gdGhlIFBBVEguXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBjaGVja0Nka0F2YWlsYWJsZSgpOiBib29sZWFuIHtcbiAgcmV0dXJuIGdldENka0luZm8oKS5hdmFpbGFibGU7XG59XG5cbi8qKlxuICogQXNzZXJ0cyB0aGF0IHRoZSBBV1MgQ0RLIENMSSBpcyBpbnN0YWxsZWQ7IHRocm93cyB3aXRoIGEgdXNlci1mcmllbmRseVxuICogbWVzc2FnZSArIGluc3RhbGwgaGludCB3aGVuIGl0IGlzbid0LiBVc2UgYXQgdGhlIHRvcCBvZiBhbnkgY29tbWFuZCB0aGF0XG4gKiBzaGVsbHMgb3V0IHRvIGBjZGtgLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZW5zdXJlQ2RrQXZhaWxhYmxlKCk6IHZvaWQge1xuICBpZiAoY2hlY2tDZGtBdmFpbGFibGUoKSkgcmV0dXJuO1xuICBwcmludEVycm9yKCdBV1MgQ0RLIGlzIG5vdCBpbnN0YWxsZWQgb3Igbm90IGFjY2Vzc2libGUnKTtcbiAgY29uc29sZS5sb2coJ0luc3RhbGwgQ0RLIHdpdGg6IG5wbSBpbnN0YWxsIC1nIGF3cy1jZGsnKTtcbiAgdGhyb3cgbmV3IEVycm9yKCdBV1MgQ0RLIG5vdCBmb3VuZCcpO1xufVxuXG4vKipcbiAqIE9wdGlvbnMgZm9yIGV4ZWN1dGluZyBhIENESyBzaGVsbCBjb21tYW5kLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIENka1NoZWxsT3B0aW9ucyB7XG4gIC8qKiBXaGVuIGB0cnVlYCwgcHJpbnRzIHRoZSBlcnJvciB0byBzdGRlcnIgb24gZmFpbHVyZS4gKi9cbiAgZGVidWc/OiBib29sZWFuO1xuICAvKiogV2hlbiBgdHJ1ZWAsIGluaGVyaXRzIHN0ZGlvIHNvIG91dHB1dCBzdHJlYW1zIHRvIHRoZSB0ZXJtaW5hbC4gRGVmYXVsdHMgdG8gYHRydWVgLiAqL1xuICBzaG93T3V0cHV0PzogYm9vbGVhbjtcbiAgLyoqIEFkZGl0aW9uYWwgZW52aXJvbm1lbnQgdmFyaWFibGVzIHRvIGluamVjdC4gKi9cbiAgZW52PzogUmVjb3JkPHN0cmluZywgc3RyaW5nPjtcbn1cblxuLyoqXG4gKiBSZXN1bHQgb2YgYSBDREsgc2hlbGwgY29tbWFuZCBleGVjdXRpb24uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ2RrU2hlbGxSZXN1bHQge1xuICBzdWNjZXNzOiBib29sZWFuO1xuICBkdXJhdGlvbjogbnVtYmVyO1xufVxuXG4vKipcbiAqIEV4ZWN1dGVzIGEgQ0RLIENMSSBjb21tYW5kIGFzIGEgY2hpbGQgcHJvY2Vzcy5cbiAqXG4gKiBAcGFyYW0gY29tbWFuZCAtIFRoZSBmdWxsIENESyBDTEkgY29tbWFuZCBzdHJpbmcgKGUuZy4sIGBjZGsgYm9vdHN0cmFwIC4uLmApLlxuICogQHBhcmFtIG9wdGlvbnMgLSBPcHRpb25hbCBleGVjdXRpb24gc2V0dGluZ3MuXG4gKiBAcmV0dXJucyBBbiBvYmplY3Qgd2l0aCBgc3VjY2Vzc2AgYW5kIGBkdXJhdGlvbmAgaW4gbXMuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBleGVjdXRlQ2RrU2hlbGxDb21tYW5kKFxuICBjb21tYW5kOiBzdHJpbmcsXG4gIG9wdGlvbnM6IENka1NoZWxsT3B0aW9ucyA9IHt9LFxuKTogQ2RrU2hlbGxSZXN1bHQge1xuICBjb25zdCB7IGRlYnVnID0gZmFsc2UsIHNob3dPdXRwdXQgPSB0cnVlLCBlbnY6IGV4dHJhRW52IH0gPSBvcHRpb25zO1xuICBjb25zdCBzdGFydFRpbWUgPSBEYXRlLm5vdygpO1xuXG4gIHRyeSB7XG4gICAgY29uc3QgZW52ID0ge1xuICAgICAgLi4ucHJvY2Vzcy5lbnYsXG4gICAgICAuLi5leHRyYUVudixcbiAgICB9O1xuXG4gICAgZXhlY1N5bmMoY29tbWFuZCwge1xuICAgICAgc3RkaW86IHNob3dPdXRwdXQgPyBbJ2luaGVyaXQnLCAnaW5oZXJpdCcsICdwaXBlJ10gOiAncGlwZScsXG4gICAgICBlbnYsXG4gICAgfSk7XG5cbiAgICBjb25zdCBkdXJhdGlvbiA9IERhdGUubm93KCkgLSBzdGFydFRpbWU7XG5cbiAgICByZXR1cm4ge1xuICAgICAgc3VjY2VzczogdHJ1ZSxcbiAgICAgIGR1cmF0aW9uLFxuICAgIH07XG4gIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgY29uc3QgZHVyYXRpb24gPSBEYXRlLm5vdygpIC0gc3RhcnRUaW1lO1xuXG4gICAgLy8gRXh0cmFjdCBzdGRlcnIvc3Rkb3V0IGZyb20gZXhlY1N5bmMgZXJyb3Igd2hlbiBhdmFpbGFibGVcbiAgICBpZiAoZXJyb3IgJiYgdHlwZW9mIGVycm9yID09PSAnb2JqZWN0JyAmJiAnc3RkZXJyJyBpbiBlcnJvcikge1xuICAgICAgY29uc3QgZXhlY0Vycm9yID0gZXJyb3IgYXMgeyBzdGRlcnI/OiBCdWZmZXIgfCBzdHJpbmc7IHN0ZG91dD86IEJ1ZmZlciB8IHN0cmluZzsgc3RhdHVzPzogbnVtYmVyIH07XG4gICAgICBjb25zdCBzdGRlcnIgPSBleGVjRXJyb3Iuc3RkZXJyPy50b1N0cmluZygpLnRyaW0oKTtcbiAgICAgIGNvbnN0IHN0ZG91dCA9IGV4ZWNFcnJvci5zdGRvdXQ/LnRvU3RyaW5nKCkudHJpbSgpO1xuXG4gICAgICBjb25zb2xlLmVycm9yKCcnKTtcbiAgICAgIGNvbnNvbGUuZXJyb3IoJ0NESyBkZXBsb3ltZW50IGZhaWxlZDonKTtcbiAgICAgIGlmIChzdGRlcnIpIGNvbnNvbGUuZXJyb3Ioc3RkZXJyKTtcbiAgICAgIGlmIChzdGRvdXQpIGNvbnNvbGUuZXJyb3Ioc3Rkb3V0KTtcbiAgICAgIGlmIChleGVjRXJyb3Iuc3RhdHVzICE9PSB1bmRlZmluZWQpIHtcbiAgICAgICAgY29uc29sZS5lcnJvcihgRXhpdCBjb2RlOiAke2V4ZWNFcnJvci5zdGF0dXN9IChhZnRlciAke2R1cmF0aW9ufW1zKWApO1xuICAgICAgfVxuICAgIH0gZWxzZSBpZiAoZGVidWcpIHtcbiAgICAgIGNvbnNvbGUuZXJyb3IoJ0NESyBleGVjdXRpb24gZmFpbGVkOicsIGVycm9yKTtcbiAgICB9XG5cbiAgICB0aHJvdyBlcnJvcjtcbiAgfVxufVxuIl19

package/dist/utils/command-utils.d.ts

@@ -0,0 +1,56 @@
+import { ApiClient } from './api-client';
+/**
+ * Print command header with section title and execution ID.
+ * Returns the execution ID for use in error handlers and summaries.
+ */
+export declare function printCommandHeader(title: string, subtitle?: string): string;
+/**
+ * Print execution summary with ID, duration, and status.
+ */
+export declare function printExecutionSummary(executionId: string, duration: number): void;
+/**
+ * Warn if SSL verification is disabled.
+ */
+export declare function printSslWarning(verifySsl?: boolean): void;
+/**
+ * Resolve a platform auth token using two methods (in priority order):
+ *
+ * 1. PLATFORM_TOKEN env var
+ * 2. --store-tokens flag → fetch credentials from AWS Secrets Manager, then authenticate
+ *
+ * @returns JWT token string
+ */
+export declare function resolveToken(options: {
+    storeTokens?: boolean;
+    verifySsl?: boolean;
+    region?: string;
+    profile?: string;
+}): Promise<string>;
+/**
+ * Initialize and return an authenticated API client.
+ *
+ * Supports two auth methods:
+ * 1. PLATFORM_TOKEN env var
+ * 2. --store-tokens + PLATFORM_SECRET_NAME env var → fetch token from Secrets Manager
+ */
+export declare function createAuthenticatedClientAsync(options: {
+    storeTokens?: boolean;
+    verifySsl?: boolean;
+    region?: string;
+    profile?: string;
+}): Promise<ApiClient>;
+/**
+ * Initialize and return an authenticated API client (sync — requires PLATFORM_TOKEN).
+ * Use createAuthenticatedClientAsync for --store-tokens support.
+ */
+export declare function createAuthenticatedClient(options: {
+    verifySsl?: boolean;
+}): ApiClient;
+/**
+ * Validate a required entity ID (ULID or UUID format).
+ * Returns trimmed ID.
+ *
+ * @throws Error if ID is empty
+ */
+export declare function validateEntityId(id: string | undefined, entityName: string): string;
+//# sourceMappingURL=command-utils.d.ts.map

package/dist/utils/command-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-utils.d.ts","sourceRoot":"","sources":["../../src/utils/command-utils.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAQzC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAM3E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOjF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAKzD;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiClB;AAED;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAAC,OAAO,EAAE;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,SAAS,CAAC,CAQrB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAYrF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAiBnF"}