@ultracart/bq-skill 0.1.2

package/dist/commands/config.js

@@ -0,0 +1,749 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configCommand = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const commander_1 = require("commander");
+const bigquery_1 = require("@google-cloud/bigquery");
+const config_writer_1 = require("../lib/config-writer");
+const config_1 = require("../lib/config");
+const manifest_1 = require("../lib/manifest");
+const deck_1 = require("../lib/deck");
+function getMerchantId(cmd) {
+    const globalOpts = cmd.optsWithGlobals ? cmd.optsWithGlobals() : (cmd.parent?.parent?.opts() || {});
+    const raw = (0, config_writer_1.readRawConfig)();
+    return globalOpts.merchant || raw.default_merchant;
+}
+function ensureMerchant(raw, merchantId) {
+    if (!raw.merchants?.[merchantId]) {
+        throw new Error(`Merchant "${merchantId}" not found in config. Available: ${Object.keys(raw.merchants || {}).join(', ')}`);
+    }
+    return raw.merchants[merchantId];
+}
+function ensureExternalProject(merchant, alias) {
+    if (!merchant.external_projects?.[alias]) {
+        throw new Error(`External project "${alias}" not found. Available: ${Object.keys(merchant.external_projects || {}).join(', ') || 'none'}`);
+    }
+    return merchant.external_projects[alias];
+}
+exports.configCommand = new commander_1.Command('config')
+    .description('Manage configuration — add/remove merchants, external projects, datasets, tables');
+// show
+exports.configCommand
+    .command('show')
+    .description('Display current configuration')
+    .action(() => {
+    const raw = (0, config_writer_1.readRawConfig)();
+    console.log(JSON.stringify(raw, null, 2));
+});
+// add-merchant
+exports.configCommand
+    .command('add-merchant <id>')
+    .description('Add a merchant to the config')
+    .requiredOption('--taxonomy <level>', 'Taxonomy level: standard, low, medium, high')
+    .option('--dataset <dataset>', 'BigQuery dataset name', 'ultracart_dw')
+    .action((id, options) => {
+    const validLevels = ['standard', 'low', 'medium', 'high'];
+    if (!validLevels.includes(options.taxonomy)) {
+        console.error(`Error: taxonomy must be one of: ${validLevels.join(', ')}`);
+        process.exit(1);
+    }
+    const raw = (0, config_writer_1.readRawConfig)();
+    if (raw.merchants?.[id]) {
+        console.error(`Error: Merchant "${id}" already exists.`);
+        process.exit(1);
+    }
+    if (!raw.merchants)
+        raw.merchants = {};
+    raw.merchants[id] = { taxonomy_level: options.taxonomy, dataset: options.dataset };
+    (0, config_writer_1.writeConfig)(raw);
+    console.log(`  Added merchant "${id}" (taxonomy: ${options.taxonomy}, dataset: ${options.dataset})`);
+});
+// remove-merchant
+exports.configCommand
+    .command('remove-merchant <id>')
+    .description('Remove a merchant from the config')
+    .action((id) => {
+    const raw = (0, config_writer_1.readRawConfig)();
+    ensureMerchant(raw, id);
+    if (raw.default_merchant === id) {
+        console.error(`Error: Cannot remove the default merchant "${id}". Change default_merchant first.`);
+        process.exit(1);
+    }
+    delete raw.merchants[id];
+    (0, config_writer_1.writeConfig)(raw);
+    console.log(`  Removed merchant "${id}"`);
+});
+// add-project
+exports.configCommand
+    .command('add-project <alias>')
+    .description('Register an external BigQuery project')
+    .requiredOption('--project-id <id>', 'GCP project ID')
+    .option('--description <desc>', 'Description of the project')
+    .action((alias, options, cmd) => {
+    const raw = (0, config_writer_1.readRawConfig)();
+    const merchantId = getMerchantId(cmd);
+    const merchant = ensureMerchant(raw, merchantId);
+    if (merchant.external_projects?.[alias]) {
+        console.error(`Error: External project "${alias}" already exists for merchant "${merchantId}".`);
+        process.exit(1);
+    }
+    if (!merchant.external_projects)
+        merchant.external_projects = {};
+    merchant.external_projects[alias] = {
+        project_id: options.projectId,
+        ...(options.description ? { description: options.description } : {}),
+        datasets: {},
+    };
+    (0, config_writer_1.writeConfig)(raw);
+    console.log(`  Added external project "${alias}" (${options.projectId}) to merchant "${merchantId}"`);
+});
+// remove-project
+exports.configCommand
+    .command('remove-project <alias>')
+    .description('Remove an external BigQuery project')
+    .action((alias, _options, cmd) => {
+    const raw = (0, config_writer_1.readRawConfig)();
+    const merchantId = getMerchantId(cmd);
+    const merchant = ensureMerchant(raw, merchantId);
+    ensureExternalProject(merchant, alias);
+    delete merchant.external_projects[alias];
+    if (Object.keys(merchant.external_projects).length === 0) {
+        delete merchant.external_projects;
+    }
+    (0, config_writer_1.writeConfig)(raw);
+    console.log(`  Removed external project "${alias}" from merchant "${merchantId}"`);
+});
+// add-dataset
+exports.configCommand
+    .command('add-dataset <alias> <dataset>')
+    .description('Add a dataset to an external project')
+    .option('--discover', 'Auto-discover and add all tables from the dataset')
+    .action(async (alias, dataset, options, cmd) => {
+    const raw = (0, config_writer_1.readRawConfig)();
+    const merchantId = getMerchantId(cmd);
+    const merchant = ensureMerchant(raw, merchantId);
+    const project = ensureExternalProject(merchant, alias);
+    if (project.datasets[dataset]) {
+        console.error(`Error: Dataset "${dataset}" already exists in project "${alias}".`);
+        process.exit(1);
+    }
+    let tables = [];
+    if (options.discover) {
+        console.log(`  Discovering tables in ${project.project_id}.${dataset}...`);
+        const bq = new bigquery_1.BigQuery({ projectId: project.project_id });
+        const [bqTables] = await bq.dataset(dataset).getTables();
+        tables = bqTables.map(t => t.id).filter(Boolean);
+        console.log(`  Found ${tables.length} tables`);
+    }
+    project.datasets[dataset] = tables;
+    (0, config_writer_1.writeConfig)(raw);
+    console.log(`  Added dataset "${dataset}" to project "${alias}" (${tables.length} tables)`);
+});
+// remove-dataset
+exports.configCommand
+    .command('remove-dataset <alias> <dataset>')
+    .description('Remove a dataset from an external project')
+    .action((alias, dataset, _options, cmd) => {
+    const raw = (0, config_writer_1.readRawConfig)();
+    const merchantId = getMerchantId(cmd);
+    const merchant = ensureMerchant(raw, merchantId);
+    const project = ensureExternalProject(merchant, alias);
+    if (!project.datasets[dataset]) {
+        console.error(`Error: Dataset "${dataset}" not found in project "${alias}".`);
+        process.exit(1);
+    }
+    delete project.datasets[dataset];
+    (0, config_writer_1.writeConfig)(raw);
+    console.log(`  Removed dataset "${dataset}" from project "${alias}"`);
+});
+// add-tables
+exports.configCommand
+    .command('add-tables <alias> <dataset> <tables...>')
+    .description('Add tables to a dataset in an external project')
+    .action((alias, dataset, tables, cmd) => {
+    const raw = (0, config_writer_1.readRawConfig)();
+    const merchantId = getMerchantId(cmd);
+    const merchant = ensureMerchant(raw, merchantId);
+    const project = ensureExternalProject(merchant, alias);
+    if (!project.datasets[dataset]) {
+        project.datasets[dataset] = [];
+    }
+    const existing = new Set(project.datasets[dataset]);
+    let added = 0;
+    for (const t of tables) {
+        if (!existing.has(t)) {
+            project.datasets[dataset].push(t);
+            existing.add(t);
+            added++;
+        }
+    }
+    (0, config_writer_1.writeConfig)(raw);
+    console.log(`  Added ${added} table(s) to ${alias}.${dataset} (${project.datasets[dataset].length} total)`);
+});
+// remove-tables
+exports.configCommand
+    .command('remove-tables <alias> <dataset> <tables...>')
+    .description('Remove tables from a dataset in an external project')
+    .action((alias, dataset, tables, cmd) => {
+    const raw = (0, config_writer_1.readRawConfig)();
+    const merchantId = getMerchantId(cmd);
+    const merchant = ensureMerchant(raw, merchantId);
+    const project = ensureExternalProject(merchant, alias);
+    if (!project.datasets[dataset]) {
+        console.error(`Error: Dataset "${dataset}" not found in project "${alias}".`);
+        process.exit(1);
+    }
+    const toRemove = new Set(tables);
+    const before = project.datasets[dataset].length;
+    project.datasets[dataset] = project.datasets[dataset].filter((t) => !toRemove.has(t));
+    (0, config_writer_1.writeConfig)(raw);
+    console.log(`  Removed ${before - project.datasets[dataset].length} table(s) from ${alias}.${dataset} (${project.datasets[dataset].length} remaining)`);
+});
+// ---------------------------------------------------------------------------
+// Delivery config helpers & subcommands
+// ---------------------------------------------------------------------------
+function loadReportForDelivery(cmd, reportName) {
+    const config = (0, config_1.loadConfig)();
+    const globalOpts = cmd.optsWithGlobals ? cmd.optsWithGlobals() : (cmd.parent?.parent?.opts() || {});
+    const merchant = (0, config_1.resolveMerchant)(config, globalOpts.merchant);
+    const reportDir = path.join(path.resolve(merchant.default_output_dir), reportName);
+    if (!fs.existsSync(reportDir))
+        throw new Error(`Report "${reportName}" not found`);
+    const manifest = (0, manifest_1.loadManifest)(reportDir);
+    return { manifest, reportDir };
+}
+// add-slack
+exports.configCommand
+    .command('add-slack <report> <channels...>')
+    .description('Add Slack channel(s) to a report\'s delivery config')
+    .action((report, channels, _options, cmd) => {
+    const { manifest, reportDir } = loadReportForDelivery(cmd, report);
+    if (!manifest.delivery)
+        manifest.delivery = {};
+    if (!manifest.delivery.slack)
+        manifest.delivery.slack = { channels: [] };
+    const existing = new Set(manifest.delivery.slack.channels);
+    for (const ch of channels) {
+        existing.add(ch);
+    }
+    manifest.delivery.slack.channels = [...existing];
+    (0, manifest_1.saveManifest)(reportDir, manifest);
+    console.log(`  Slack channels for "${report}": ${manifest.delivery.slack.channels.join(', ')}`);
+});
+// remove-slack
+exports.configCommand
+    .command('remove-slack <report> <channels...>')
+    .description('Remove Slack channel(s) from a report\'s delivery config')
+    .action((report, channels, _options, cmd) => {
+    const { manifest, reportDir } = loadReportForDelivery(cmd, report);
+    if (!manifest.delivery?.slack) {
+        console.log('  No Slack delivery configured.');
+        return;
+    }
+    const toRemove = new Set(channels);
+    manifest.delivery.slack.channels = manifest.delivery.slack.channels.filter(ch => !toRemove.has(ch));
+    if (manifest.delivery.slack.channels.length === 0) {
+        delete manifest.delivery.slack;
+    }
+    if (manifest.delivery && !manifest.delivery.slack && !manifest.delivery.email) {
+        delete manifest.delivery;
+    }
+    (0, manifest_1.saveManifest)(reportDir, manifest);
+    if (manifest.delivery?.slack) {
+        console.log(`  Slack channels for "${report}": ${manifest.delivery.slack.channels.join(', ')}`);
+    }
+    else {
+        console.log(`  Removed all Slack channels from "${report}".`);
+    }
+});
+// set-email
+exports.configCommand
+    .command('set-email <report>')
+    .description('Set email delivery config for a report')
+    .option('--to <emails>', 'Comma-separated recipient email addresses')
+    .option('--provider <provider>', 'Email provider: sendgrid, ses, postmark, mailgun, resend')
+    .option('--subject <subject>', 'Email subject line')
+    .action((report, options, cmd) => {
+    const { manifest, reportDir } = loadReportForDelivery(cmd, report);
+    if (!manifest.delivery)
+        manifest.delivery = {};
+    const validProviders = ['sendgrid', 'ses', 'postmark', 'mailgun', 'resend'];
+    if (!manifest.delivery.email) {
+        // First use — all three are required
+        if (!options.to || !options.provider || !options.subject) {
+            console.error('Error: --to, --provider, and --subject are all required when creating email delivery config.');
+            process.exit(1);
+        }
+        if (!validProviders.includes(options.provider)) {
+            console.error(`Error: provider must be one of: ${validProviders.join(', ')}`);
+            process.exit(1);
+        }
+        manifest.delivery.email = {
+            to: options.to.split(',').map(e => e.trim()),
+            provider: options.provider,
+            subject: options.subject,
+        };
+    }
+    else {
+        // Subsequent use — update only what's specified
+        if (options.to) {
+            manifest.delivery.email.to = options.to.split(',').map(e => e.trim());
+        }
+        if (options.provider) {
+            if (!validProviders.includes(options.provider)) {
+                console.error(`Error: provider must be one of: ${validProviders.join(', ')}`);
+                process.exit(1);
+            }
+            manifest.delivery.email.provider = options.provider;
+        }
+        if (options.subject) {
+            manifest.delivery.email.subject = options.subject;
+        }
+    }
+    (0, manifest_1.saveManifest)(reportDir, manifest);
+    console.log(`  Email delivery for "${report}":`);
+    console.log(`    To: ${manifest.delivery.email.to.join(', ')}`);
+    console.log(`    Provider: ${manifest.delivery.email.provider}`);
+    console.log(`    Subject: ${manifest.delivery.email.subject}`);
+});
+// add-email
+exports.configCommand
+    .command('add-email <report> <emails...>')
+    .description('Add email recipient(s) to a report\'s delivery config')
+    .action((report, emails, _options, cmd) => {
+    const { manifest, reportDir } = loadReportForDelivery(cmd, report);
+    if (!manifest.delivery?.email) {
+        console.error('Error: No email delivery configured. Use "set-email" first to set provider and subject.');
+        process.exit(1);
+    }
+    const existing = new Set(manifest.delivery.email.to);
+    for (const e of emails) {
+        existing.add(e);
+    }
+    manifest.delivery.email.to = [...existing];
+    (0, manifest_1.saveManifest)(reportDir, manifest);
+    console.log(`  Email recipients for "${report}": ${manifest.delivery.email.to.join(', ')}`);
+});
+// remove-email
+exports.configCommand
+    .command('remove-email <report> <emails...>')
+    .description('Remove email recipient(s) from a report\'s delivery config')
+    .action((report, emails, _options, cmd) => {
+    const { manifest, reportDir } = loadReportForDelivery(cmd, report);
+    if (!manifest.delivery?.email) {
+        console.log('  No email delivery configured.');
+        return;
+    }
+    const toRemove = new Set(emails);
+    manifest.delivery.email.to = manifest.delivery.email.to.filter(e => !toRemove.has(e));
+    if (manifest.delivery.email.to.length === 0) {
+        delete manifest.delivery.email;
+    }
+    if (manifest.delivery && !manifest.delivery.slack && !manifest.delivery.email) {
+        delete manifest.delivery;
+    }
+    (0, manifest_1.saveManifest)(reportDir, manifest);
+    if (manifest.delivery?.email) {
+        console.log(`  Email recipients for "${report}": ${manifest.delivery.email.to.join(', ')}`);
+    }
+    else {
+        console.log(`  Removed all email delivery from "${report}".`);
+    }
+});
+// set-email-provider
+exports.configCommand
+    .command('set-email-provider <report> <provider>')
+    .description('Update the email provider for a report')
+    .action((report, provider, _options, cmd) => {
+    const validProviders = ['sendgrid', 'ses', 'postmark', 'mailgun', 'resend'];
+    if (!validProviders.includes(provider)) {
+        console.error(`Error: provider must be one of: ${validProviders.join(', ')}`);
+        process.exit(1);
+    }
+    const { manifest, reportDir } = loadReportForDelivery(cmd, report);
+    if (!manifest.delivery?.email) {
+        console.error('Error: No email delivery configured. Use "set-email" first.');
+        process.exit(1);
+    }
+    manifest.delivery.email.provider = provider;
+    (0, manifest_1.saveManifest)(reportDir, manifest);
+    console.log(`  Email provider for "${report}" set to: ${provider}`);
+});
+// set-email-subject
+exports.configCommand
+    .command('set-email-subject <report> <subject>')
+    .description('Update the email subject for a report')
+    .action((report, subject, _options, cmd) => {
+    const { manifest, reportDir } = loadReportForDelivery(cmd, report);
+    if (!manifest.delivery?.email) {
+        console.error('Error: No email delivery configured. Use "set-email" first.');
+        process.exit(1);
+    }
+    manifest.delivery.email.subject = subject;
+    (0, manifest_1.saveManifest)(reportDir, manifest);
+    console.log(`  Email subject for "${report}" set to: ${subject}`);
+});
+// show-delivery
+exports.configCommand
+    .command('show-delivery <report>')
+    .description('Display the delivery configuration for a report')
+    .action((report, _options, cmd) => {
+    const { manifest } = loadReportForDelivery(cmd, report);
+    if (!manifest.delivery) {
+        console.log(`  No delivery configured for "${report}".`);
+        return;
+    }
+    console.log(`  Delivery config for "${report}":`);
+    if (manifest.delivery.slack) {
+        console.log(`    Slack channels: ${manifest.delivery.slack.channels.join(', ')}`);
+    }
+    if (manifest.delivery.email) {
+        console.log(`    Email to: ${manifest.delivery.email.to.join(', ')}`);
+        console.log(`    Email provider: ${manifest.delivery.email.provider}`);
+        console.log(`    Email subject: ${manifest.delivery.email.subject}`);
+    }
+});
+// ---------------------------------------------------------------------------
+// Alarm config subcommands
+// ---------------------------------------------------------------------------
+const VALID_ALARM_TYPES = ['threshold', 'pct_change', 'missing_data'];
+const VALID_SEVERITIES = ['low', 'high', 'critical'];
+const VALID_OPERATORS = ['<', '>', '<=', '>=', '==', '!='];
+const VALID_AGGREGATES = ['sum', 'avg', 'min', 'max', 'first', 'last'];
+const VALID_DELIVERY_MODES = ['always', 'alarm_only'];
+// add-alarm
+exports.configCommand
+    .command('add-alarm <report>')
+    .description('Add an alarm to a report')
+    .requiredOption('--name <name>', 'Alarm name')
+    .requiredOption('--type <type>', 'Alarm type: threshold, pct_change, missing_data')
+    .option('--metric <metric>', 'Column name in data.json to evaluate')
+    .option('--aggregate <agg>', 'Aggregation: sum, avg, min, max, first, last', 'sum')
+    .option('--operator <op>', 'Comparison operator: <, >, <=, >=, ==, !=')
+    .option('--value <value>', 'Threshold value or percent')
+    .option('--severity <severity>', 'Severity: low, high, critical', 'high')
+    .option('--cooldown <cooldown>', 'Cooldown duration (e.g. 24h, 7d, 1h)', '24h')
+    .action((report, options, cmd) => {
+    const { manifest, reportDir } = loadReportForDelivery(cmd, report);
+    if (!VALID_ALARM_TYPES.includes(options.type)) {
+        console.error(`Error: type must be one of: ${VALID_ALARM_TYPES.join(', ')}`);
+        process.exit(1);
+    }
+    if (options.severity && !VALID_SEVERITIES.includes(options.severity)) {
+        console.error(`Error: severity must be one of: ${VALID_SEVERITIES.join(', ')}`);
+        process.exit(1);
+    }
+    if (options.operator && !VALID_OPERATORS.includes(options.operator)) {
+        console.error(`Error: operator must be one of: ${VALID_OPERATORS.join(', ')}`);
+        process.exit(1);
+    }
+    if (options.aggregate && !VALID_AGGREGATES.includes(options.aggregate)) {
+        console.error(`Error: aggregate must be one of: ${VALID_AGGREGATES.join(', ')}`);
+        process.exit(1);
+    }
+    // Validate required fields per type
+    if (options.type !== 'missing_data') {
+        if (!options.metric) {
+            console.error('Error: --metric is required for threshold and pct_change alarms.');
+            process.exit(1);
+        }
+        if (!options.operator) {
+            console.error('Error: --operator is required for threshold and pct_change alarms.');
+            process.exit(1);
+        }
+        if (options.value === undefined) {
+            console.error('Error: --value is required for threshold and pct_change alarms.');
+            process.exit(1);
+        }
+    }
+    if (!manifest.alarms)
+        manifest.alarms = [];
+    // Check for duplicate name
+    if (manifest.alarms.some(a => a.name === options.name)) {
+        console.error(`Error: Alarm "${options.name}" already exists on report "${report}".`);
+        process.exit(1);
+    }
+    const alarm = {
+        name: options.name,
+        type: options.type,
+        severity: options.severity || 'high',
+        cooldown: options.cooldown || '24h',
+    };
+    if (options.type !== 'missing_data') {
+        alarm.metric = options.metric;
+        alarm.aggregate = options.aggregate || 'sum';
+        alarm.operator = options.operator;
+        alarm.value = parseFloat(options.value);
+        if (options.type === 'pct_change') {
+            alarm.compare_to = 'previous_run';
+        }
+    }
+    manifest.alarms.push(alarm);
+    (0, manifest_1.saveManifest)(reportDir, manifest);
+    console.log(`  Added alarm "${options.name}" to report "${report}"`);
+    console.log(`    Type: ${options.type}`);
+    if (alarm.metric)
+        console.log(`    Metric: ${alarm.metric} (${alarm.aggregate})`);
+    if (alarm.operator)
+        console.log(`    Condition: ${alarm.operator} ${alarm.value}`);
+    console.log(`    Severity: ${alarm.severity}`);
+    console.log(`    Cooldown: ${alarm.cooldown}`);
+});
+// show-alarms
+exports.configCommand
+    .command('show-alarms <report>')
+    .description('Display all alarms configured on a report')
+    .action((report, _options, cmd) => {
+    const { manifest } = loadReportForDelivery(cmd, report);
+    if (!manifest.alarms || manifest.alarms.length === 0) {
+        console.log(`  No alarms configured for "${report}".`);
+        return;
+    }
+    console.log('');
+    console.log(`  Alarms for "${report}":`);
+    console.log('  ' + '─'.repeat(60));
+    for (const alarm of manifest.alarms) {
+        console.log(`  ${alarm.name}`);
+        console.log(`    Type:     ${alarm.type}`);
+        if (alarm.metric)
+            console.log(`    Metric:   ${alarm.metric} (${alarm.aggregate || 'sum'})`);
+        if (alarm.operator)
+            console.log(`    Condition: ${alarm.operator} ${alarm.value}`);
+        console.log(`    Severity: ${alarm.severity}`);
+        console.log(`    Cooldown: ${alarm.cooldown || '24h'}`);
+        console.log('');
+    }
+});
+// remove-alarm
+exports.configCommand
+    .command('remove-alarm <report> <alarm-name>')
+    .description('Remove an alarm from a report')
+    .action((report, alarmName, _options, cmd) => {
+    const { manifest, reportDir } = loadReportForDelivery(cmd, report);
+    if (!manifest.alarms || manifest.alarms.length === 0) {
+        console.log(`  No alarms configured for "${report}".`);
+        return;
+    }
+    const before = manifest.alarms.length;
+    manifest.alarms = manifest.alarms.filter(a => a.name !== alarmName);
+    if (manifest.alarms.length === before) {
+        console.error(`Error: Alarm "${alarmName}" not found on report "${report}".`);
+        console.error(`  Available: ${manifest.alarms.map(a => a.name).join(', ')}`);
+        process.exit(1);
+    }
+    if (manifest.alarms.length === 0) {
+        delete manifest.alarms;
+    }
+    (0, manifest_1.saveManifest)(reportDir, manifest);
+    console.log(`  Removed alarm "${alarmName}" from report "${report}".`);
+});
+// set-delivery-mode
+exports.configCommand
+    .command('set-delivery-mode <report> <mode>')
+    .description('Set delivery mode for a report (always or alarm_only)')
+    .action((report, mode, _options, cmd) => {
+    if (!VALID_DELIVERY_MODES.includes(mode)) {
+        console.error(`Error: mode must be one of: ${VALID_DELIVERY_MODES.join(', ')}`);
+        process.exit(1);
+    }
+    const { manifest, reportDir } = loadReportForDelivery(cmd, report);
+    if (!manifest.delivery)
+        manifest.delivery = {};
+    manifest.delivery.mode = mode;
+    (0, manifest_1.saveManifest)(reportDir, manifest);
+    console.log(`  Delivery mode for "${report}" set to: ${mode}`);
+});
+// set-mention-on-alarm
+exports.configCommand
+    .command('set-mention-on-alarm <report> <mention>')
+    .description('Set the Slack mention for critical alarms (e.g., @channel, @here)')
+    .action((report, mention, _options, cmd) => {
+    const { manifest, reportDir } = loadReportForDelivery(cmd, report);
+    if (!manifest.delivery)
+        manifest.delivery = {};
+    if (!manifest.delivery.slack) {
+        console.error('Error: No Slack delivery configured. Use "add-slack" first.');
+        process.exit(1);
+    }
+    manifest.delivery.slack.mention_on_alarm = mention;
+    (0, manifest_1.saveManifest)(reportDir, manifest);
+    console.log(`  Slack mention_on_alarm for "${report}" set to: ${mention}`);
+});
+// ---------------------------------------------------------------------------
+// Deck delivery mode
+// ---------------------------------------------------------------------------
+// set-deck-delivery-mode
+exports.configCommand
+    .command('set-deck-delivery-mode <deck> <mode>')
+    .description('Set delivery mode for a deck (always or alarm_only)')
+    .action((deckArg, mode, _options, cmd) => {
+    if (!VALID_DELIVERY_MODES.includes(mode)) {
+        console.error(`Error: mode must be one of: ${VALID_DELIVERY_MODES.join(', ')}`);
+        process.exit(1);
+    }
+    const { deck, decksDir, deckName } = loadDeckForConfig(cmd, deckArg);
+    if (!deck.delivery)
+        deck.delivery = {};
+    deck.delivery.mode = mode;
+    (0, deck_1.saveDeck)(decksDir, deckName, deck);
+    console.log(`  Delivery mode for deck "${deckName}" set to: ${mode}`);
+});
+// ---------------------------------------------------------------------------
+// Deck parameter helpers & subcommands
+// ---------------------------------------------------------------------------
+function loadDeckForConfig(cmd, deckName) {
+    const config = (0, config_1.loadConfig)();
+    const globalOpts = cmd.optsWithGlobals ? cmd.optsWithGlobals() : (cmd.parent?.parent?.opts() || {});
+    const merchant = (0, config_1.resolveMerchant)(config, globalOpts.merchant);
+    const decksDir = path.join(path.resolve(merchant.default_output_dir), 'decks');
+    const deck = (0, deck_1.loadDeck)(decksDir, deckName);
+    return { deck, decksDir, deckName };
+}
+// set-deck-param
+exports.configCommand
+    .command('set-deck-param <deck> <param> <value>')
+    .description('Set a parameter default on a deck')
+    .action((deckArg, param, value, _options, cmd) => {
+    const { deck, decksDir, deckName } = loadDeckForConfig(cmd, deckArg);
+    if (!deck.parameters)
+        deck.parameters = {};
+    deck.parameters[param] = value;
+    (0, deck_1.saveDeck)(decksDir, deckName, deck);
+    console.log(`  Set deck parameter "${param}" = "${value}" on deck "${deckName}"`);
+});
+// remove-deck-param
+exports.configCommand
+    .command('remove-deck-param <deck> <param>')
+    .description('Remove a parameter default from a deck')
+    .action((deckArg, param, _options, cmd) => {
+    const { deck, decksDir, deckName } = loadDeckForConfig(cmd, deckArg);
+    if (!deck.parameters || deck.parameters[param] === undefined) {
+        console.log(`  Parameter "${param}" not found on deck "${deckName}".`);
+        return;
+    }
+    delete deck.parameters[param];
+    if (Object.keys(deck.parameters).length === 0) {
+        delete deck.parameters;
+    }
+    (0, deck_1.saveDeck)(decksDir, deckName, deck);
+    console.log(`  Removed deck parameter "${param}" from deck "${deckName}"`);
+});
+// show-deck-params
+exports.configCommand
+    .command('show-deck-params <deck>')
+    .description('Display all parameter defaults for a deck')
+    .action((deckArg, _options, cmd) => {
+    const { deck, deckName } = loadDeckForConfig(cmd, deckArg);
+    const params = deck.parameters || {};
+    const keys = Object.keys(params);
+    if (keys.length === 0) {
+        console.log(`  No parameters configured for deck "${deckName}".`);
+        return;
+    }
+    console.log('');
+    console.log(`  Deck parameters for "${deckName}":`);
+    console.log('  ' + '─'.repeat(50));
+    for (const key of keys) {
+        console.log(`  ${key.padEnd(25)} ${params[key]}`);
+    }
+    console.log('');
+});
+// ---------------------------------------------------------------------------
+// Report parameter helpers & subcommands
+// ---------------------------------------------------------------------------
+// set-param
+exports.configCommand
+    .command('set-param <report> <param> <value>')
+    .description('Set the default value for a report parameter')
+    .action((report, param, value, _options, cmd) => {
+    const { manifest, reportDir } = loadReportForDelivery(cmd, report);
+    const params = manifest.parameters || [];
+    const paramDef = params.find((p) => p.name === param);
+    if (!paramDef) {
+        console.error(`Error: Parameter "${param}" not found in report "${report}". Available: ${params.map((p) => p.name).join(', ') || 'none'}`);
+        process.exit(1);
+    }
+    paramDef.default = value;
+    (0, manifest_1.saveManifest)(reportDir, manifest);
+    console.log(`  Set parameter "${param}" default = "${value}" on report "${report}"`);
+});
+// remove-param
+exports.configCommand
+    .command('remove-param <report> <param>')
+    .description('Remove the default value for a report parameter (will prompt on run)')
+    .action((report, param, _options, cmd) => {
+    const { manifest, reportDir } = loadReportForDelivery(cmd, report);
+    const params = manifest.parameters || [];
+    const paramDef = params.find((p) => p.name === param);
+    if (!paramDef) {
+        console.error(`Error: Parameter "${param}" not found in report "${report}". Available: ${params.map((p) => p.name).join(', ') || 'none'}`);
+        process.exit(1);
+    }
+    if (paramDef.default === undefined) {
+        console.log(`  Parameter "${param}" already has no default on report "${report}".`);
+        return;
+    }
+    delete paramDef.default;
+    (0, manifest_1.saveManifest)(reportDir, manifest);
+    console.log(`  Removed default for parameter "${param}" on report "${report}"`);
+});
+// show-params
+exports.configCommand
+    .command('show-params <report>')
+    .description('Display all parameters and their defaults for a report')
+    .action((report, _options, cmd) => {
+    const { manifest } = loadReportForDelivery(cmd, report);
+    const params = manifest.parameters || [];
+    if (params.length === 0) {
+        console.log(`  No parameters defined for report "${report}".`);
+        return;
+    }
+    console.log('');
+    console.log(`  Parameters for "${report}":`);
+    console.log('  ' + '─'.repeat(60));
+    console.log(`  ${'Name'.padEnd(20)} ${'Type'.padEnd(10)} ${'Required'.padEnd(10)} Default`);
+    console.log('  ' + '─'.repeat(60));
+    for (const p of params) {
+        const name = p.name || '';
+        const type = p.type || '';
+        const required = p.required ? 'yes' : 'no';
+        const defaultVal = p.default !== undefined ? String(p.default) : '(none)';
+        console.log(`  ${name.padEnd(20)} ${type.padEnd(10)} ${required.padEnd(10)} ${defaultVal}`);
+    }
+    console.log('');
+});
+//# sourceMappingURL=config.js.map