@build-astron-co/nimbus 0.2.0 → 0.4.0

package/dist/src/commands/pipeline.js

@@ -0,0 +1,153 @@
+/**
+ * Pipeline Command — H2
+ *
+ * View CI/CD pipeline status from GitHub Actions, GitLab CI, or CircleCI.
+ *
+ * Usage:
+ *   nimbus pipeline status [run-id]
+ *   nimbus pipeline status --provider github --limit 10
+ */
+import { execFileSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { ui } from '../wizard/ui';
+/**
+ * Auto-detect the CI/CD provider by scanning the cwd for config files.
+ */
+export function detectProvider(cwd = process.cwd()) {
+    if (fs.existsSync(path.join(cwd, '.github', 'workflows')))
+        return 'github';
+    if (fs.existsSync(path.join(cwd, '.gitlab-ci.yml')))
+        return 'gitlab';
+    if (fs.existsSync(path.join(cwd, '.circleci', 'config.yml')))
+        return 'circleci';
+    return null;
+}
+function fetchGitHubRuns(limit, runId) {
+    if (runId) {
+        const raw = execFileSync('gh', ['run', 'view', runId, '--json', 'status,conclusion,name,createdAt,url,databaseId'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+        const r = JSON.parse(raw);
+        return [{
+                id: String(r.databaseId ?? runId),
+                workflow: r.name ?? '',
+                status: r.status ?? '',
+                result: r.conclusion ?? '-',
+                started: r.createdAt ?? '',
+                url: r.url,
+            }];
+    }
+    const raw = execFileSync('gh', ['run', 'list', '--limit', String(limit), '--json', 'status,conclusion,name,createdAt,databaseId'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+    const runs = JSON.parse(raw);
+    return runs.map(r => ({
+        id: String(r['databaseId'] ?? ''),
+        workflow: String(r['name'] ?? ''),
+        status: String(r['status'] ?? ''),
+        result: String(r['conclusion'] ?? '-'),
+        started: String(r['createdAt'] ?? ''),
+    }));
+}
+function fetchGitLabRuns(limit) {
+    const raw = execFileSync('glab', ['ci', 'list', '--format', 'json'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+    const pipelines = JSON.parse(raw);
+    return pipelines.slice(0, limit).map(p => ({
+        id: String(p['id'] ?? ''),
+        workflow: String(p['ref'] ?? ''),
+        status: String(p['status'] ?? ''),
+        result: String(p['status'] ?? '-'),
+        started: String(p['created_at'] ?? ''),
+        url: String(p['web_url'] ?? ''),
+    }));
+}
+function fetchCircleCIRuns() {
+    const raw = execFileSync('circleci', ['pipeline', 'list'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+    // CircleCI CLI output is not always JSON; do best-effort parse
+    try {
+        const pipelines = JSON.parse(raw);
+        return pipelines.map(p => ({
+            id: String(p['id'] ?? ''),
+            workflow: String(p['vcs'] ?? ''),
+            status: String(p['state'] ?? ''),
+            result: String(p['state'] ?? '-'),
+            started: String(p['created_at'] ?? ''),
+        }));
+    }
+    catch {
+        return [{ id: '-', workflow: '-', status: raw.trim().slice(0, 40), result: '-', started: '-' }];
+    }
+}
+function printTable(runs) {
+    const COL = { id: 12, workflow: 30, status: 12, result: 12, started: 22 };
+    const pad = (s, n) => s.slice(0, n).padEnd(n);
+    const divider = `${'-'.repeat(COL.id + 2)}+${'-'.repeat(COL.workflow + 2)}+${'-'.repeat(COL.status + 2)}+${'-'.repeat(COL.result + 2)}+${'-'.repeat(COL.started + 2)}`;
+    console.log(divider);
+    console.log(`| ${pad('ID', COL.id)} | ${pad('Workflow', COL.workflow)} | ${pad('Status', COL.status)} | ${pad('Result', COL.result)} | ${pad('Started', COL.started)} |`);
+    console.log(divider);
+    for (const r of runs) {
+        console.log(`| ${pad(r.id, COL.id)} | ${pad(r.workflow, COL.workflow)} | ${pad(r.status, COL.status)} | ${pad(r.result, COL.result)} | ${pad(r.started, COL.started)} |`);
+    }
+    console.log(divider);
+}
+/**
+ * Main pipeline command dispatcher.
+ */
+export async function pipelineCommand(subcommand, args) {
+    const options = { format: 'table', limit: 10 };
+    let runId;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--provider' && args[i + 1]) {
+            options.provider = args[++i];
+        }
+        else if (arg === '--format' && args[i + 1]) {
+            options.format = args[++i];
+        }
+        else if (arg === '--limit' && args[i + 1]) {
+            options.limit = parseInt(args[++i], 10);
+        }
+        else if (arg === '--json') {
+            options.format = 'json';
+        }
+        else if (!arg.startsWith('-') && !runId && subcommand === 'status') {
+            runId = arg;
+        }
+    }
+    const provider = options.provider === 'auto' || !options.provider
+        ? detectProvider()
+        : options.provider;
+    if (!provider) {
+        ui.error('Could not detect CI/CD provider. Use --provider github|gitlab|circleci or run in a repo with CI config.');
+        process.exit(1);
+    }
+    let runs;
+    try {
+        if (provider === 'github') {
+            runs = fetchGitHubRuns(options.limit ?? 10, runId);
+        }
+        else if (provider === 'gitlab') {
+            runs = fetchGitLabRuns(options.limit ?? 10);
+        }
+        else {
+            runs = fetchCircleCIRuns();
+        }
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            const installHints = {
+                github: 'Install GitHub CLI: https://cli.github.com',
+                gitlab: 'Install GitLab CLI: https://gitlab.com/gitlab-org/cli',
+                circleci: 'Install CircleCI CLI: https://circleci.com/docs/local-cli/',
+            };
+            ui.error(`CLI not found for provider "${provider}". ${installHints[provider] ?? ''}`);
+        }
+        else {
+            ui.error(`Failed to fetch pipeline status: ${error.message}`);
+        }
+        process.exit(1);
+    }
+    if (options.format === 'json') {
+        console.log(JSON.stringify(runs, null, 2));
+        return;
+    }
+    ui.header(`Pipeline Status (${provider})`);
+    printTable(runs);
+}

package/dist/src/commands/plan/display.js

@@ -0,0 +1,216 @@
+/**
+ * Plan Display Utilities
+ *
+ * Format and display plan output for different infrastructure types
+ */
+import { ui } from '../../wizard';
+/**
+ * Action symbols for display
+ */
+const ACTION_SYMBOLS = {
+    create: { symbol: '+', color: 'green' },
+    add: { symbol: '+', color: 'green' },
+    apply: { symbol: '~', color: 'cyan' },
+    update: { symbol: '~', color: 'yellow' },
+    change: { symbol: '~', color: 'yellow' },
+    delete: { symbol: '-', color: 'red' },
+    destroy: { symbol: '-', color: 'red' },
+    read: { symbol: '<=', color: 'blue' },
+    'no-op': { symbol: ' ', color: 'blue' },
+};
+/**
+ * Format action for display
+ */
+function formatAction(action) {
+    const config = ACTION_SYMBOLS[action.toLowerCase()] || { symbol: '?', color: 'yellow' };
+    return ui.color(config.symbol, config.color);
+}
+/**
+ * Format resource for display
+ */
+function formatResource(resource) {
+    return resource;
+}
+/**
+ * Display plan summary
+ */
+function displaySummary(changes) {
+    ui.print('Plan Summary:');
+    ui.newLine();
+    const { add, change, destroy } = changes;
+    const total = add + change + destroy;
+    if (total === 0) {
+        ui.print('  No changes. Infrastructure is up to date.');
+        return;
+    }
+    if (add > 0) {
+        ui.print(`  ${ui.color(`+ ${add} to add`, 'green')}`);
+    }
+    if (change > 0) {
+        ui.print(`  ${ui.color(`~ ${change} to change`, 'yellow')}`);
+    }
+    if (destroy > 0) {
+        ui.print(`  ${ui.color(`- ${destroy} to destroy`, 'red')}`);
+    }
+    ui.newLine();
+    ui.print(`  Total: ${total} resource(s)`);
+}
+/**
+ * Display resource changes
+ */
+function displayResources(resources) {
+    if (!resources || resources.length === 0) {
+        return;
+    }
+    ui.newLine();
+    ui.print('Resource Changes:');
+    ui.newLine();
+    // Group by action
+    const grouped = {};
+    for (const resource of resources) {
+        const action = resource.action.toLowerCase();
+        if (!grouped[action]) {
+            grouped[action] = [];
+        }
+        grouped[action].push(resource);
+    }
+    // Display in order: create, update, delete, other
+    const order = ['create', 'add', 'update', 'change', 'apply', 'delete', 'destroy', 'read'];
+    for (const action of order) {
+        const items = grouped[action];
+        if (!items || items.length === 0) {
+            continue;
+        }
+        for (const item of items) {
+            const symbol = formatAction(item.action);
+            const resource = formatResource(item.resource);
+            ui.print(`  ${symbol} ${resource}`);
+            // Show address if different from resource name
+            if (item.address && item.address !== item.resource) {
+                ui.print(`      ${ui.dim(item.address)}`);
+            }
+        }
+    }
+    // Display any remaining actions not in order
+    for (const [action, items] of Object.entries(grouped)) {
+        if (order.includes(action)) {
+            continue;
+        }
+        for (const item of items) {
+            const symbol = formatAction(item.action);
+            const resource = formatResource(item.resource);
+            ui.print(`  ${symbol} ${resource}`);
+        }
+    }
+}
+/**
+ * Display raw plan output (detailed mode)
+ */
+function displayRawPlan(raw) {
+    ui.newLine();
+    ui.print('Detailed Plan:');
+    ui.newLine();
+    // Limit output length
+    const maxLength = 5000;
+    if (raw.length > maxLength) {
+        ui.print(raw.slice(0, maxLength));
+        ui.newLine();
+        ui.print(ui.dim(`... (output truncated, ${raw.length - maxLength} more characters)`));
+    }
+    else {
+        ui.print(raw);
+    }
+}
+/**
+ * Display Terraform-specific plan
+ */
+function displayTerraformPlan(plan, detailed) {
+    if (plan.changes) {
+        displaySummary(plan.changes);
+    }
+    if (plan.resources && plan.resources.length > 0) {
+        displayResources(plan.resources);
+    }
+    if (detailed && plan.raw) {
+        displayRawPlan(plan.raw);
+    }
+    // Show next steps
+    ui.newLine();
+    ui.print('Next steps:');
+    ui.print('  - Review the changes above');
+    ui.print('  - Run "nimbus apply terraform" to apply');
+    ui.print('  - Or run "nimbus tf apply" for more options');
+}
+/**
+ * Display Kubernetes-specific plan
+ */
+function displayK8sPlan(plan, detailed) {
+    if (plan.changes) {
+        ui.print('Plan Summary:');
+        ui.newLine();
+        ui.print(`  ${ui.color(`${plan.changes.add} resource(s) to apply`, 'cyan')}`);
+        if (plan.changes.change > 0) {
+            ui.print(`  ${ui.color(`${plan.changes.change} resource(s) will be updated`, 'yellow')}`);
+        }
+        ui.newLine();
+        ui.info("Note: Kubernetes apply is idempotent - unchanged resources won't be modified");
+    }
+    if (plan.resources && plan.resources.length > 0) {
+        displayResources(plan.resources);
+    }
+    if (detailed && plan.raw) {
+        displayRawPlan(plan.raw);
+    }
+    // Show next steps
+    ui.newLine();
+    ui.print('Next steps:');
+    ui.print('  - Review the resources above');
+    ui.print('  - Run "nimbus apply k8s" to apply');
+    ui.print('  - Or run "nimbus k8s apply" for more options');
+}
+/**
+ * Display Helm-specific plan
+ */
+function displayHelmPlan(plan, detailed) {
+    if (plan.changes) {
+        ui.print('Plan Summary:');
+        ui.newLine();
+        if (plan.changes.add > 0) {
+            ui.print(`  ${ui.color(`+ ${plan.changes.add} resource(s) to create`, 'green')}`);
+        }
+        if (plan.changes.change > 0) {
+            ui.print(`  ${ui.color(`~ ${plan.changes.change} resource(s) to update`, 'yellow')}`);
+        }
+        if (plan.changes.destroy > 0) {
+            ui.print(`  ${ui.color(`- ${plan.changes.destroy} resource(s) to remove`, 'red')}`);
+        }
+    }
+    if (plan.resources && plan.resources.length > 0) {
+        displayResources(plan.resources);
+    }
+    if (detailed && plan.raw) {
+        displayRawPlan(plan.raw);
+    }
+    // Show next steps
+    ui.newLine();
+    ui.print('Next steps:');
+    ui.print('  - Review the changes above');
+    ui.print('  - Run "nimbus apply helm" to install/upgrade');
+    ui.print('  - Or run "nimbus helm install/upgrade" for more options');
+}
+/**
+ * Display plan result
+ */
+export function displayPlan(plan, detailed = false) {
+    switch (plan.type) {
+        case 'terraform':
+            displayTerraformPlan(plan, detailed);
+            break;
+        case 'k8s':
+            displayK8sPlan(plan, detailed);
+            break;
+        case 'helm':
+            displayHelmPlan(plan, detailed);
+            break;
+    }
+}