gpxe 1.0.0

package/src/demo.js

@@ -0,0 +1,211 @@
+const DEMO_MODE = ['1', 'true', 'yes', 'on'].includes((process.env.GRIDPOINT_DEMO || '').toLowerCase());
+
+const isDemo = (opts) => Boolean(opts?.demo) || DEMO_MODE;
+
+const demoIncidentExplain = (incidentId) => ({
+    id: incidentId,
+    severity: 'high',
+    status: 'ongoing',
+    summary: 'Elevated 5xx on api-gateway after deploy v2.14.3; queue latency increased 3.2x.',
+    confidence: 0.82,
+    primary_cause: { type: 'deploy', id: 'v2.14.3', score: 0.91 },
+    signals: [
+        { name: 'p95_latency_ms', delta: '+420ms', service: 'api-gateway' },
+        { name: 'queue_backlog', delta: '+18k', service: 'ingest' },
+        { name: 'db_pool_saturation', delta: '92%', service: 'core-db' }
+    ],
+    evidence: [
+        { detail: 'deploy v2.14.3 at 09:12 UTC -> error spike at 09:15 UTC' },
+        { detail: 'trace sample 7a3f... shows retry storm from queue worker' },
+        { detail: 'regression in handler /v1/events (diff hunk #42)' }
+    ],
+    suggested_actions: [
+        {
+            reason: 'Validate recent changes',
+            cmd: 'gridpoint changes correlate --window 2h --service api-gateway'
+        },
+        { reason: 'Check SLO burn', cmd: 'gridpoint slos status --service api-gateway' },
+        {
+            reason: 'Rollback last deploy',
+            cmd: 'gridpoint deploy rollback v2.14.3 --service api-gateway'
+        }
+    ]
+});
+
+const demoChangesCorrelate = (window) => ({
+    window: window || '24h',
+    results: [
+        { type: 'deploy', id: 'v2.14.3', score: 0.91, impact: { error_rate_pct: 3.8 } },
+        { type: 'config', id: 'queue.concurrency', score: 0.62, impact: { p95_latency_ms: -120 } },
+        { type: 'infra', id: 'db.resize', score: 0.41, impact: { cpu_pct: -18 } }
+    ]
+});
+
+const demoSloStatus = (project) => ({
+    project: project || 'core',
+    slos: [
+        {
+            service: 'api-gateway',
+            availability: 99.93,
+            budget_left_pct: 38,
+            burn_rate: 1.3,
+            time_to_breach: '6d'
+        },
+        {
+            service: 'ingest',
+            availability: 99.88,
+            budget_left_pct: 22,
+            burn_rate: 2.1,
+            time_to_breach: '2d'
+        }
+    ]
+});
+
+const demoAlertsTune = (window, service) => ({
+    window: window || '24h',
+    service: service || null,
+    summary: {
+        noisy_alerts: 12,
+        total_alerts: 38,
+        noise_pct: 32
+    },
+    recommendations: [
+        {
+            alert: 'latency_p95',
+            action: 'raise_threshold',
+            current: '900ms',
+            suggested: '1.2s',
+            expected_noise_reduction_pct: 28
+        },
+        {
+            alert: 'queue_backlog',
+            action: 'add_sustained_window',
+            current: '5m',
+            suggested: '10m',
+            expected_noise_reduction_pct: 18
+        },
+        {
+            alert: 'error_rate',
+            action: 'lower_sensitivity',
+            current: '1.8%',
+            suggested: '2.2%',
+            expected_noise_reduction_pct: 12
+        }
+    ]
+});
+
+const demoRunbookSuggest = (incidentId, service) => ({
+    incident_id: incidentId,
+    title: 'Elevated 5xx on api-gateway',
+    service: service || 'api-gateway',
+    steps: [
+        {
+            title: 'Confirm change correlation',
+            command: 'gridpoint changes correlate --window 2h --service api-gateway',
+            rationale: 'Recent deploys or config changes are the most common cause.'
+        },
+        {
+            title: 'Review SLO burn',
+            command: 'gridpoint slos status --service api-gateway',
+            rationale: 'Determine if this will breach the error budget.'
+        },
+        {
+            title: 'Tune alerts temporarily',
+            command: 'gridpoint alerts tune --service api-gateway --window 6h',
+            rationale: 'Reduce alert noise while triaging.'
+        },
+        {
+            title: 'Rollback last deploy',
+            command: 'gridpoint deploy rollback v2.14.3 --service api-gateway',
+            rationale: 'Rollback typically stabilizes error rate within minutes.'
+        }
+    ]
+});
+
+const demoCapacityForecast = (window, service) => ({
+    window: window || '30d',
+    service: service || 'ingest',
+    saturation: { days: 18, utilization_pct: 86 },
+    cost: { projected_monthly_usd: 1240, delta_pct: 18 },
+    recommendations: [
+        { action: 'increase_worker_pool', detail: 'Scale ingest workers to 12 by week 3.' },
+        { action: 'optimize_batching', detail: 'Raise batch size to 1200 to reduce CPU cost.' }
+    ]
+});
+
+const demoBillingStatus = () => ({
+    account: {
+        id: 'acct_4c1d',
+        workspace_id: 'core',
+        plan: 'Pro',
+        usage_tier: 'Growth',
+        usage_limit: 5000000,
+        status: 'active',
+        period_start: '2025-12-01',
+        period_end: '2025-12-31',
+        payment_method: { brand: 'Visa', last4: '4242' },
+        next_invoice: { amount: 8900, currency: 'USD', due_at: '2026-01-01' },
+        portal_url: 'https://app.gridpointanalytics.com/billing'
+    },
+    usage: {
+        month: '2025-12',
+        unit: 'events',
+        total: 1842000,
+        by_service: [
+            { service: 'api-gateway', total: 920000, unit: 'events' },
+            { service: 'ingest', total: 642000, unit: 'events' },
+            { service: 'workers', total: 280000, unit: 'events' }
+        ]
+    },
+    invoices: [
+        {
+            id: 'inv_1032',
+            number: 'INV-1032',
+            status: 'paid',
+            amount_due: 8900,
+            currency: 'USD',
+            issued_at: '2025-12-01',
+            due_at: '2025-12-01',
+            hosted_url: 'https://app.gridpointanalytics.com/invoices/INV-1032'
+        }
+    ]
+});
+
+const demoBillingUsageReport = (payload) => ({
+    status: 'recorded',
+    usage: {
+        id: 'use_demo',
+        account_id: payload.account_id || null,
+        workspace_id: payload.workspace_id || null,
+        service: payload.service || null,
+        quantity: payload.quantity,
+        unit: payload.unit || 'events',
+        source: payload.source || 'cli',
+        created_at: new Date().toISOString()
+    }
+});
+
+const demoSupportRequest = (topic, subject, message, email) => ({
+    status: 'open',
+    request: {
+        id: 'sup_demo',
+        topic: topic || 'general',
+        subject: subject || 'Billing question',
+        message: message || 'Need help with invoice history.',
+        email: email || 'operator@example.com',
+        created_at: new Date().toISOString()
+    }
+});
+
+module.exports = {
+    isDemo,
+    demoIncidentExplain,
+    demoChangesCorrelate,
+    demoSloStatus,
+    demoAlertsTune,
+    demoRunbookSuggest,
+    demoCapacityForecast,
+    demoBillingStatus,
+    demoBillingUsageReport,
+    demoSupportRequest,
+};

package/src/main.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+const { program } = require('commander');
+const chalk = require('chalk');
+const {
+    initFlags,
+    shouldShowBanner,
+    shouldShowHints,
+} = require('./util');
+const { recordUsage } = require('./billing');
+
+
+
+program
+    .name('gpxe')
+    .version('2.0.0')
+    .description('CLI-first telemetry for Cloudflare stacks.')
+    .usage('<command> [options]')
+    .addHelpText(
+        'after',
+        '\nQuick start:\n  gpxe login\n  gpxe init\n  gpxe status\n\nExamples:\n  gpxe metrics --watch 10\n  gpxe incidents explain inc_123 --demo\n  gpxe alerts tune --service api-gateway\n  gpxe capacity forecast --window 30d\n  gpxe status --json\n'
+    );
+
+program.hook('postAction', async (thisCommand, actionCommand) => {
+    await recordUsage(actionCommand);
+});
+
+program.hook('preAction', (thisCommand, actionCommand) => {
+    if (actionCommand && typeof actionCommand.opts === 'function') {
+        actionCommand.opts()._startTime = Date.now();
+    }
+});
+
+require('./commands/basic');
+require('./commands/reserve');
+require('./commands/config');
+require('./commands/status');
+require('./commands/incidents');
+require('./commands/changes');
+require('./commands/slos');
+require('./commands/alerts');
+require('./commands/runbooks');
+require('./commands/capacity');
+require('./commands/deploy');
+require('./commands/billing');
+require('./commands/support');
+
+
+
+const run = async (argv) => {
+    initFlags(argv);
+
+    if (shouldShowBanner()) {
+
+        console.log(chalk.green.bold("\nGridpoint Analytics CLI (gpxe)\n"));
+
+    }
+
+    await program.parseAsync(argv);
+
+    if (!argv.slice(2).length) {
+        program.outputHelp();
+    }
+};
+
+
+
+if (require.main === module) {
+
+    run(process.argv).catch((err) => {
+
+        console.error(chalk.red('Unexpected CLI error.'));
+
+        if (shouldShowHints()) {
+
+            console.error(err);
+
+        }
+
+        process.exitCode = 1;
+
+    });
+
+}
+
+
+
+module.exports = { run };
+
+

package/src/util.js

@@ -0,0 +1,110 @@
+const chalk = require('chalk');
+const { program } = require('commander');
+
+let wantsJson = false;
+let showBanner = false;
+let showHints = false;
+
+const toInt = (value, fallback) => {
+    const parsed = Number.parseInt(value, 10);
+    return Number.isFinite(parsed) ? parsed : fallback;
+};
+
+const parseQuantity = (value) => {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+};
+
+const maskToken = (token) => {
+    if (!token) return null;
+    if (token.length <= 8) return "********";
+    return `${token.slice(0, 4)}...${token.slice(-4)}`;
+};
+
+const printRequestError = (error, fallback, endpoint) => {
+    const status = error?.response?.status;
+    const detail = error?.response?.data?.error || error?.response?.data?.message;
+    const message = status ? `${fallback} (HTTP ${status})` : fallback;
+    console.log(chalk.red(message));
+    if (detail) {
+        console.log(detail);
+    }
+    if (!showHints) return;
+    if (status === 401 || status === 403) {
+        console.log(chalk.gray('Tip: run "gpxe login" to set a token.'));
+        return;
+    }
+    if (error?.code === 'ECONNABORTED') {
+        console.log(chalk.gray('Tip: the endpoint is slow or unreachable. Check "gpxe config".'));
+        return;
+    }
+    if (error?.code === 'ENOTFOUND' || error?.code === 'ECONNREFUSED') {
+        console.log(chalk.gray(`Tip: verify the endpoint: ${endpoint || 'set with gpxe init'}`));
+        return;
+    }
+    console.log(chalk.gray('Tip: verify your endpoint with "gpxe config".'));
+};
+
+const getCommandPath = (actionCommand) => {
+    const parts = [];
+    let current = actionCommand;
+    while (current && typeof current.name === 'function') {
+        const name = current.name();
+        if (!name || name === 'gridpoint') break;
+        parts.unshift(name);
+        current = current.parent;
+    }
+    return parts.join(' ');
+};
+
+const formatImpact = (impact) => {
+    if (!impact || typeof impact !== 'object') return 'impact: n/a';
+    const parts = Object.entries(impact)
+        .filter(([, value]) => value !== null && value !== undefined)
+        .map(([key, value]) => {
+            if (typeof value === 'number') {
+                const sign = value > 0 ? '+' : '';
+                return `${key} ${sign}${value}`;
+            }
+            return `${key} ${value}`;
+        });
+    return parts.length ? `impact: ${parts.join(', ')}` : 'impact: n/a';
+};
+
+const formatPercent = (value) => (Number.isFinite(value) ? `${value}%` : 'n/a');
+const formatCurrency = (value) =>
+    Number.isFinite(value)
+        ? `$${value.toLocaleString('en-US', { maximumFractionDigits: 0 })}`
+        : 'n/a';
+const formatCents = (value, currency = 'USD') => {
+    if (!Number.isFinite(value)) return 'n/a';
+    const amount = (value / 100).toFixed(2);
+    return currency === 'USD' ? `$${amount}` : `${amount} ${currency}`;
+};
+
+const initFlags = (argv) => {
+    wantsJson = argv.includes('--json');
+    showBanner = process.stdout.isTTY && !wantsJson;
+    showHints = process.stdout.isTTY && !wantsJson;
+};
+
+
+const shouldShowHints = () => showHints;
+const shouldShowBanner = () => showBanner;
+const wantsJSON = () => wantsJson;
+
+module.exports = {
+    toInt,
+    parseQuantity,
+    maskToken,
+    printRequestError,
+    getCommandPath,
+    formatImpact,
+    formatPercent,
+    formatCurrency,
+    formatCents,
+    initFlags,
+    shouldShowHints,
+    shouldShowBanner,
+    wantsJSON,
+};