gitlab-catalog-browser 0.1.0

package/dist/commands/batch.js

@@ -0,0 +1,174 @@
+/**
+ * Batch command execution handler.
+ *
+ * Implements `batch` command for executing multiple CLI commands
+ * in a single invocation, sequentially.
+ */
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// ──────────────────────────────────────────────
+// Path resolution
+// ──────────────────────────────────────────────
+const __filename = fileURLToPath(import.meta.url);
+/**
+ * Find the CLI binary path. Tries several strategies:
+ * 1. GITLAB_CI_CLI_BIN env var (explicit override)
+ * 2. resolve __filename relative to current script (for source runs)
+ * 3. Check common locations
+ */
+function findCliPath() {
+    // 1. Env var override
+    const envBin = process.env.GITLAB_CI_CLI_BIN;
+    if (envBin && existsSync(envBin))
+        return resolve(envBin);
+    // 2. Try the bin/gitlab-ci-cli.js relative to this file
+    const binPath = resolve(dirname(__filename), '..', '..', 'bin', 'gitlab-ci-cli.js');
+    if (existsSync(binPath))
+        return binPath;
+    // 3. Try process.argv[1] (the script that started this process)
+    if (process.argv[1] && existsSync(process.argv[1]))
+        return resolve(process.argv[1]);
+    // 4. Fallback: use the same node executable with a known relative path
+    return 'gitlab-ci-cli';
+}
+/**
+ * Read JSON commands from stdin.
+ */
+async function readStdinCommands() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.from(chunk));
+    }
+    const content = Buffer.concat(chunks).toString('utf-8');
+    const parsed = JSON.parse(content);
+    if (!Array.isArray(parsed)) {
+        throw new Error('Stdin JSON must be an array of command strings');
+    }
+    return parsed.map((c) => String(c));
+}
+// ──────────────────────────────────────────────
+// Handlers
+// ──────────────────────────────────────────────
+/**
+ * Handle `batch <commands...> [--bail]` or `batch --json` (stdin).
+ */
+export async function handleBatch(commands, _config, options = {}) {
+    try {
+        // ── Collect commands ─────────────────────
+        let cmdList;
+        if (options.json) {
+            // Read from stdin
+            cmdList = await readStdinCommands();
+        }
+        else if (commands && commands.length > 0) {
+            cmdList = commands;
+        }
+        else {
+            return {
+                exitCode: 1,
+                output: options.json
+                    ? JSON.stringify({ success: false, error: 'No commands provided. Pipe JSON to --json or pass commands as arguments.' })
+                    : 'No commands provided. Pipe JSON to --json or pass commands as arguments.',
+            };
+        }
+        if (cmdList.length === 0) {
+            return {
+                exitCode: 0,
+                output: options.json ? JSON.stringify({ results: [], summary: { total: 0, succeeded: 0, failed: 0 } }) : 'No commands to execute.',
+            };
+        }
+        // ── Execute commands ─────────────────────
+        const cliPath = findCliPath();
+        const results = [];
+        let hasFailure = false;
+        for (let i = 0; i < cmdList.length; i++) {
+            const cmd = cmdList[i];
+            try {
+                const fullCmd = `${process.execPath} ${cliPath} ${cmd}`;
+                const stdout = execSync(fullCmd, {
+                    encoding: 'utf-8',
+                    timeout: 60000,
+                    maxBuffer: 10 * 1024 * 1024, // 10MB
+                });
+                results.push({
+                    command: cmd,
+                    index: i,
+                    exitCode: 0,
+                    stdout: stdout.trimEnd(),
+                    stderr: '',
+                });
+            }
+            catch (err) {
+                const execErr = err;
+                const exitCode = execErr.status ?? 1;
+                const stderr = execErr.stderr?.trimEnd() ?? execErr.message;
+                results.push({
+                    command: cmd,
+                    index: i,
+                    exitCode,
+                    stdout: execErr.stdout?.trimEnd() ?? '',
+                    stderr,
+                });
+                hasFailure = true;
+                if (options.bail) {
+                    // Stop at first failure
+                    break;
+                }
+            }
+        }
+        // ── Format results ────────────────────────
+        const succeeded = results.filter((r) => r.exitCode === 0).length;
+        const failed = results.filter((r) => r.exitCode !== 0).length;
+        if (options.json) {
+            return {
+                exitCode: hasFailure ? 1 : 0,
+                output: JSON.stringify({
+                    results: results.map((r) => ({
+                        command: r.command,
+                        exit_code: r.exitCode,
+                        stdout: r.stdout,
+                        stderr: r.stderr,
+                    })),
+                    summary: {
+                        total: results.length,
+                        succeeded,
+                        failed,
+                        bailed: options.bail && hasFailure,
+                    },
+                }, null, 2),
+            };
+        }
+        // Text output
+        const lines = [];
+        for (const result of results) {
+            const status = result.exitCode === 0 ? '✓' : '✗';
+            lines.push(`${status} [${result.index + 1}/${cmdList.length}] ${result.command}`);
+            if (result.stdout) {
+                lines.push(result.stdout);
+            }
+            if (result.stderr) {
+                lines.push(`  Error: ${result.stderr}`);
+            }
+            lines.push('');
+        }
+        lines.push(`--- Summary ---`);
+        lines.push(`Total: ${results.length}, Succeeded: ${succeeded}, Failed: ${failed}`);
+        if (options.bail && hasFailure) {
+            lines.push('Batch stopped early due to --bail flag.');
+        }
+        return {
+            exitCode: hasFailure ? 1 : 0,
+            output: lines.join('\n'),
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (options.json) {
+            return { exitCode: 1, output: JSON.stringify({ success: false, error: message }) };
+        }
+        return { exitCode: 1, output: `Error: ${message}` };
+    }
+}
+//# sourceMappingURL=batch.js.map

package/dist/commands/batch.js.map

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

package/dist/commands/catalog.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Catalog browsing command handlers.
+ *
+ * Implements `catalog list`, `catalog search`, and `catalog info` commands.
+ * Uses the CatalogApi client for GitLab API interactions.
+ */
+import type { GitLabCIConfig } from '../config/types.js';
+export interface CatalogListOptions {
+    json?: boolean;
+    page?: number;
+    perPage?: number;
+}
+export interface CatalogSearchOptions {
+    json?: boolean;
+    page?: number;
+    perPage?: number;
+}
+export interface CatalogInfoOptions {
+    json?: boolean;
+}
+/**
+ * Handle `catalog list --org <namespace>`.
+ */
+export declare function handleCatalogList(namespace: string, config: Partial<GitLabCIConfig>, options?: CatalogListOptions): Promise<{
+    exitCode: number;
+    output: string;
+}>;
+/**
+ * Handle `catalog search <query>`.
+ */
+export declare function handleCatalogSearch(query: string, config: Partial<GitLabCIConfig>, options?: CatalogSearchOptions): Promise<{
+    exitCode: number;
+    output: string;
+}>;
+/**
+ * Handle `catalog info <full-path>`.
+ */
+export declare function handleCatalogInfo(fullPath: string, config: Partial<GitLabCIConfig>, options?: CatalogInfoOptions): Promise<{
+    exitCode: number;
+    output: string;
+}>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/commands/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/commands/catalog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOzD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAeD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,EAC/B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAoD/C;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,EAC/B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAoD/C;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,EAC/B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAuC/C"}

package/dist/commands/catalog.js

@@ -0,0 +1,158 @@
+/**
+ * Catalog browsing command handlers.
+ *
+ * Implements `catalog list`, `catalog search`, and `catalog info` commands.
+ * Uses the CatalogApi client for GitLab API interactions.
+ */
+import { CatalogApi } from '../api/catalog.js';
+import { GitLabApiClient } from '../api/gitlab.js';
+import { renderTable, renderDetail } from '../output/table.js';
+import { NotFoundError } from '../types/api.js';
+// ──────────────────────────────────────────────
+// Helpers
+// ──────────────────────────────────────────────
+function createCatalogApi(config) {
+    const client = new GitLabApiClient(config);
+    return new CatalogApi(client);
+}
+// ──────────────────────────────────────────────
+// Handlers
+// ──────────────────────────────────────────────
+/**
+ * Handle `catalog list --org <namespace>`.
+ */
+export async function handleCatalogList(namespace, config, options = {}) {
+    try {
+        const api = createCatalogApi(config);
+        const components = await api.listComponents(namespace, {
+            page: options.page,
+            perPage: options.perPage,
+        });
+        if (components.length === 0) {
+            return {
+                exitCode: 0,
+                output: options.json
+                    ? JSON.stringify({ success: true, data: [], message: `No components found in namespace '${namespace}'` })
+                    : `No components found in namespace '${namespace}'`,
+            };
+        }
+        if (options.json) {
+            return {
+                exitCode: 0,
+                output: JSON.stringify({ success: true, data: components }, null, 2),
+            };
+        }
+        const rows = components.map((c) => ({
+            Name: c.name,
+            Version: c.version,
+            Description: c.description ?? '',
+            Path: c.full_path,
+        }));
+        const table = renderTable([
+            { header: 'Name' },
+            { header: 'Version' },
+            { header: 'Description' },
+            { header: 'Path' },
+        ], rows);
+        return { exitCode: 0, output: table };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (options.json) {
+            return {
+                exitCode: 1,
+                output: JSON.stringify({ success: false, error: { message } }),
+            };
+        }
+        return { exitCode: 1, output: `Error: ${message}` };
+    }
+}
+/**
+ * Handle `catalog search <query>`.
+ */
+export async function handleCatalogSearch(query, config, options = {}) {
+    try {
+        const api = createCatalogApi(config);
+        const components = await api.searchComponents(query, {
+            page: options.page,
+            perPage: options.perPage,
+        });
+        if (components.length === 0) {
+            return {
+                exitCode: 0,
+                output: options.json
+                    ? JSON.stringify({ success: true, data: [], message: `No components matching '${query}'` })
+                    : `No components matching '${query}'`,
+            };
+        }
+        if (options.json) {
+            return {
+                exitCode: 0,
+                output: JSON.stringify({ success: true, data: components }, null, 2),
+            };
+        }
+        const rows = components.map((c) => ({
+            Name: c.name,
+            Version: c.version,
+            Description: c.description ?? '',
+            Path: c.full_path,
+        }));
+        const table = renderTable([
+            { header: 'Name' },
+            { header: 'Version' },
+            { header: 'Description' },
+            { header: 'Path' },
+        ], rows);
+        return { exitCode: 0, output: table };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (options.json) {
+            return {
+                exitCode: 1,
+                output: JSON.stringify({ success: false, error: { message } }),
+            };
+        }
+        return { exitCode: 1, output: `Error: ${message}` };
+    }
+}
+/**
+ * Handle `catalog info <full-path>`.
+ */
+export async function handleCatalogInfo(fullPath, config, options = {}) {
+    try {
+        const api = createCatalogApi(config);
+        const component = await api.getComponentInfo(fullPath);
+        if (options.json) {
+            return {
+                exitCode: 0,
+                output: JSON.stringify({ success: true, data: component }, null, 2),
+            };
+        }
+        const detail = renderDetail([
+            { label: 'Name', value: component.name },
+            { label: 'Path', value: component.full_path },
+            { label: 'Version', value: component.version },
+            { label: 'Description', value: component.description ?? '' },
+            { label: 'Inputs', value: String(component.inputs?.length ?? 0) },
+            { label: 'Jobs', value: String(component.jobs?.length ?? 0) },
+            { label: 'Workflows', value: String(component.workflows?.length ?? 0) },
+        ]);
+        return { exitCode: 0, output: detail };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        // Give a friendlier message for not-found
+        const userMessage = err instanceof NotFoundError
+            ? `Component '${fullPath}' not found`
+            : `Error: ${message}`;
+        if (options.json) {
+            return {
+                exitCode: 1,
+                output: JSON.stringify({ success: false, error: { message: userMessage } }),
+            };
+        }
+        return { exitCode: 1, output: userMessage };
+    }
+}
+//# sourceMappingURL=catalog.js.map

package/dist/commands/catalog.js.map

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

package/dist/commands/component.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Component schema inspection command handlers.
+ *
+ * Implements `component schema`, `component inputs`, `component workflows`,
+ * and `component jobs` commands.
+ */
+import type { GitLabCIConfig } from '../config/types.js';
+export interface ComponentSchemaOptions {
+    version?: string;
+    outputFile?: string;
+    noCache?: boolean;
+}
+export interface ComponentInputsOptions {
+    json?: boolean;
+}
+/**
+ * Handle `component schema <full-path>`.
+ */
+export declare function handleComponentSchema(fullPath: string, config: Partial<GitLabCIConfig>, options?: ComponentSchemaOptions): Promise<{
+    exitCode: number;
+    output: string;
+}>;
+/**
+ * Handle `component inputs <full-path>`.
+ */
+export declare function handleComponentInputs(fullPath: string, config: Partial<GitLabCIConfig>, options?: ComponentInputsOptions): Promise<{
+    exitCode: number;
+    output: string;
+}>;
+/**
+ * Handle `component workflows <full-path>`.
+ */
+export declare function handleComponentWorkflows(fullPath: string, config: Partial<GitLabCIConfig>): Promise<{
+    exitCode: number;
+    output: string;
+}>;
+/**
+ * Handle `component jobs <full-path>`.
+ */
+export declare function handleComponentJobs(fullPath: string, config: Partial<GitLabCIConfig>, options?: {
+    withArtifacts?: boolean;
+}): Promise<{
+    exitCode: number;
+    output: string;
+}>;
+//# sourceMappingURL=component.d.ts.map

package/dist/commands/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/commands/component.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAQzD,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAeD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,EAC/B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAoD/C;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,EAC/B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA4D/C;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAC9B,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAiC/C;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,EAC/B,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAiD/C"}

package/dist/commands/component.js

@@ -0,0 +1,213 @@
+/**
+ * Component schema inspection command handlers.
+ *
+ * Implements `component schema`, `component inputs`, `component workflows`,
+ * and `component jobs` commands.
+ */
+import { writeFileSync } from 'node:fs';
+import { CatalogApi } from '../api/catalog.js';
+import { GitLabApiClient } from '../api/gitlab.js';
+import { renderTable } from '../output/table.js';
+import { NotFoundError } from '../types/api.js';
+import { SchemaCache, buildComponentCacheKey } from '../cache/schema-cache.js';
+// ──────────────────────────────────────────────
+// Helpers
+// ──────────────────────────────────────────────
+function createCatalogApi(config) {
+    const client = new GitLabApiClient(config);
+    return new CatalogApi(client);
+}
+// ──────────────────────────────────────────────
+// Handlers
+// ──────────────────────────────────────────────
+/**
+ * Handle `component schema <full-path>`.
+ */
+export async function handleComponentSchema(fullPath, config, options = {}) {
+    try {
+        // ── Check cache (unless --no-cache) ─────────
+        const cacheKey = buildComponentCacheKey(fullPath, options.version);
+        if (!options.noCache) {
+            const cache = new SchemaCache();
+            const cached = cache.get(cacheKey);
+            if (cached) {
+                const yamlContent = cached.data.spec ?? '# No schema available';
+                const output = `(from cache) ${yamlContent}`;
+                if (options.outputFile) {
+                    writeFileSync(options.outputFile, yamlContent, 'utf-8');
+                    return {
+                        exitCode: 0,
+                        output: `Schema saved to ${options.outputFile} (from cache)`,
+                    };
+                }
+                return { exitCode: 0, output };
+            }
+        }
+        // ── Fetch from API ──────────────────────────
+        const api = createCatalogApi(config);
+        const component = await api.getComponentInfo(fullPath);
+        const yamlContent = component.spec ?? '# No schema available';
+        // ── Store in cache ──────────────────────────
+        if (!options.noCache) {
+            const cache = new SchemaCache();
+            cache.set(cacheKey, { spec: yamlContent });
+        }
+        if (options.outputFile) {
+            writeFileSync(options.outputFile, yamlContent, 'utf-8');
+            return {
+                exitCode: 0,
+                output: `Schema saved to ${options.outputFile}`,
+            };
+        }
+        return { exitCode: 0, output: yamlContent };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const userMessage = err instanceof NotFoundError
+            ? `Component '${fullPath}' not found`
+            : `Error: ${message}`;
+        return { exitCode: 1, output: userMessage };
+    }
+}
+/**
+ * Handle `component inputs <full-path>`.
+ */
+export async function handleComponentInputs(fullPath, config, options = {}) {
+    try {
+        const api = createCatalogApi(config);
+        const component = await api.getComponentInfo(fullPath);
+        const inputs = component.inputs ?? [];
+        if (inputs.length === 0) {
+            return {
+                exitCode: 0,
+                output: options.json
+                    ? JSON.stringify({ success: true, data: [], message: `Component '${fullPath}' defines no inputs` })
+                    : `Component '${fullPath}' defines no inputs`,
+            };
+        }
+        if (options.json) {
+            return {
+                exitCode: 0,
+                output: JSON.stringify({ success: true, data: inputs }, null, 2),
+            };
+        }
+        const rows = inputs.map((input) => ({
+            Name: input.name,
+            Type: input.type,
+            Required: input.required ? 'Yes' : 'No',
+            Default: input.default !== undefined ? String(input.default) : '-',
+            Description: input.description ?? '',
+            Options: input.options?.join(', ') ?? '',
+            Regex: input.regex ?? '',
+        }));
+        const table = renderTable([
+            { header: 'Name' },
+            { header: 'Type' },
+            { header: 'Required' },
+            { header: 'Default' },
+            { header: 'Description' },
+            { header: 'Options' },
+            { header: 'Regex' },
+        ], rows);
+        return { exitCode: 0, output: table };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const userMessage = err instanceof NotFoundError
+            ? `Component '${fullPath}' not found`
+            : `Error: ${message}`;
+        if (options.json) {
+            return {
+                exitCode: 1,
+                output: JSON.stringify({ success: false, error: { message: userMessage } }),
+            };
+        }
+        return { exitCode: 1, output: userMessage };
+    }
+}
+/**
+ * Handle `component workflows <full-path>`.
+ */
+export async function handleComponentWorkflows(fullPath, config) {
+    try {
+        const api = createCatalogApi(config);
+        const component = await api.getComponentInfo(fullPath);
+        const workflows = component.workflows ?? [];
+        if (workflows.length === 0) {
+            return {
+                exitCode: 0,
+                output: `Component '${fullPath}' defines no workflows`,
+            };
+        }
+        const lines = [];
+        for (const wf of workflows) {
+            lines.push(`Workflow: ${wf.name}`);
+            lines.push(`  Triggers: ${wf.triggers.join(', ')}`);
+            lines.push(`  Jobs:     ${wf.jobs.join(', ')}`);
+            if (wf.rules && wf.rules.length > 0) {
+                lines.push(`  Rules:    ${wf.rules.join(', ')}`);
+            }
+            lines.push('');
+        }
+        return { exitCode: 0, output: lines.join('\n').trimEnd() };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const userMessage = err instanceof NotFoundError
+            ? `Component '${fullPath}' not found`
+            : `Error: ${message}`;
+        return { exitCode: 1, output: userMessage };
+    }
+}
+/**
+ * Handle `component jobs <full-path>`.
+ */
+export async function handleComponentJobs(fullPath, config, options = {}) {
+    try {
+        const api = createCatalogApi(config);
+        const component = await api.getComponentInfo(fullPath);
+        const jobs = component.jobs ?? [];
+        if (jobs.length === 0) {
+            return {
+                exitCode: 0,
+                output: `Component '${fullPath}' defines no jobs`,
+            };
+        }
+        const lines = [];
+        for (const job of jobs) {
+            lines.push(`Job: ${job.name}`);
+            lines.push(`  Stage:  ${job.stage}`);
+            if (job.image)
+                lines.push(`  Image:  ${job.image}`);
+            lines.push(`  Script: ${job.script.join(' && ')}`);
+            if (job.variables && Object.keys(job.variables).length > 0) {
+                const varsStr = Object.entries(job.variables)
+                    .map(([k, v]) => `${k}=${v}`)
+                    .join(', ');
+                lines.push(`  Variables: ${varsStr}`);
+            }
+            if (job.rules && job.rules.length > 0) {
+                lines.push(`  Rules:  ${job.rules.join(', ')}`);
+            }
+            if (job.needs && job.needs.length > 0) {
+                lines.push(`  Needs:  ${job.needs.join(', ')}`);
+                if (options.withArtifacts) {
+                    lines.push(`  (artifact dependencies shown)`);
+                }
+            }
+            if (job.when) {
+                lines.push(`  When:   ${job.when}`);
+            }
+            lines.push('');
+        }
+        return { exitCode: 0, output: lines.join('\n').trimEnd() };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const userMessage = err instanceof NotFoundError
+            ? `Component '${fullPath}' not found`
+            : `Error: ${message}`;
+        return { exitCode: 1, output: userMessage };
+    }
+}
+//# sourceMappingURL=component.js.map