@switchbot/openapi-cli 3.2.1 → 3.2.2

package/dist/rules/audit-query.js

@@ -1,90 +0,0 @@
-/**
- * Shared filters + aggregations over the audit log for
- * `switchbot rules tail` and `switchbot rules replay`.
- *
- * All functions are pure — no I/O, no clock reads — so they can be
- * unit-tested with fixture arrays. The CLI entry points handle file
- * reading, `--follow` tailing, and human vs JSON rendering.
- */
-/** The subset of audit kinds the rules engine emits. */
-export const RULE_AUDIT_KINDS = [
-    'rule-fire',
-    'rule-fire-dry',
-    'rule-throttled',
-    'rule-webhook-rejected',
-];
-/** Keep entries that are rule-engine emitted and match the filter. */
-export function filterRuleAudits(entries, filter = {}) {
-    const kinds = new Set(filter.kinds ?? RULE_AUDIT_KINDS);
-    const out = [];
-    for (const e of entries) {
-        if (!kinds.has(e.kind))
-            continue;
-        if (filter.sinceMs !== undefined) {
-            const ms = Date.parse(e.t);
-            if (!Number.isFinite(ms) || ms < filter.sinceMs)
-                continue;
-        }
-        if (filter.ruleName !== undefined) {
-            if (e.rule?.name !== filter.ruleName)
-                continue;
-        }
-        out.push(e);
-    }
-    return out;
-}
-/** Aggregate a filtered stream into per-rule counters. */
-export function aggregateRuleAudits(entries) {
-    const byRule = new Map();
-    let webhookRejectedCount = 0;
-    for (const e of entries) {
-        if (e.kind === 'rule-webhook-rejected' && !e.rule) {
-            webhookRejectedCount++;
-            continue;
-        }
-        const name = e.rule?.name;
-        if (!name)
-            continue;
-        let s = byRule.get(name);
-        if (!s) {
-            s = {
-                rule: name,
-                fires: 0,
-                driesFires: 0,
-                throttled: 0,
-                errors: 0,
-                errorRate: 0,
-                firstAt: null,
-                lastAt: null,
-                triggerSource: null,
-            };
-            byRule.set(name, s);
-        }
-        if (e.kind === 'rule-fire')
-            s.fires++;
-        else if (e.kind === 'rule-fire-dry')
-            s.driesFires++;
-        else if (e.kind === 'rule-throttled')
-            s.throttled++;
-        if (e.result === 'error')
-            s.errors++;
-        if (!s.firstAt || e.t < s.firstAt)
-            s.firstAt = e.t;
-        if (!s.lastAt || e.t > s.lastAt)
-            s.lastAt = e.t;
-        const source = e.rule?.triggerSource;
-        if (source) {
-            if (s.triggerSource === null)
-                s.triggerSource = source;
-            else if (s.triggerSource !== source)
-                s.triggerSource = 'mixed';
-        }
-    }
-    for (const s of byRule.values()) {
-        const denom = s.fires + s.driesFires;
-        s.errorRate = denom === 0 ? 0 : s.errors / denom;
-    }
-    const summaries = [...byRule.values()].sort((a, b) => b.fires + b.driesFires - (a.fires + a.driesFires));
-    return { total: entries.length, summaries, webhookRejectedCount };
-}
-//# sourceMappingURL=audit-query.js.map

package/dist/rules/audit-query.js.map

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

package/dist/rules/conflict-analyzer.d.ts

@@ -1,57 +0,0 @@
-/**
- * Static conflict analysis for automation rules.
- *
- * Detects patterns that are technically valid but likely to cause
- * operational problems:
- *
- *   1. Opposing-action pairs — same device, opposite commands (e.g.
- *      turnOn / turnOff), triggered by the same source within a short
- *      window and with no throttle on either rule.
- *
- *   2. High-frequency MQTT rules without throttle — rules that listen
- *      on `device.shadow` (catch-all) with no throttle can fire on
- *      every shadow push (up to once per second) and exhaust the daily
- *      API quota quickly.
- *
- *   3. Potentially-destructive action without quiet-hours protection —
- *      a rule that targets a destructive verb is technically blocked by
- *      the engine, but we can still flag it early so users don't get a
- *      surprise at runtime.
- *
- * Results are designed to be consumed by `rules doctor --json` and
- * by CI pipelines. Each finding carries a `severity` so callers can
- * decide how to gate on them.
- */
-import type { Rule } from './types.js';
-export type ConflictSeverity = 'error' | 'warning' | 'info';
-export interface ConflictFinding {
-    severity: ConflictSeverity;
-    code: string;
-    message: string;
-    /** Rule names involved in this finding. */
-    rules: string[];
-    hint?: string;
-}
-export interface ConflictReport {
-    findings: ConflictFinding[];
-    /** Count per severity level. */
-    counts: Record<ConflictSeverity, number>;
-    /** True when there are no error-severity findings. */
-    clean: boolean;
-}
-/**
- * MQTT events that fire on every device state push and can rapidly exhaust
- * the daily API quota when a rule has no throttle.
- *
- * Conditional events like `motion.detected` are intentionally excluded —
- * they fire discretely, not at continuous high frequency. Extend this set
- * when new catch-all or near-continuous event types are added to the classifier.
- */
-export declare const HIGH_FREQ_EVENTS: readonly string[];
-/** Returns true when an MQTT event is known to fire at high frequency. */
-export declare function isHighFreqEvent(event: string): boolean;
-export interface QuietHours {
-    start: string;
-    end: string;
-}
-export declare function analyzeConflicts(rules: Rule[], quietHours?: QuietHours | null): ConflictReport;

package/dist/rules/conflict-analyzer.js

@@ -1,215 +0,0 @@
-/**
- * Static conflict analysis for automation rules.
- *
- * Detects patterns that are technically valid but likely to cause
- * operational problems:
- *
- *   1. Opposing-action pairs — same device, opposite commands (e.g.
- *      turnOn / turnOff), triggered by the same source within a short
- *      window and with no throttle on either rule.
- *
- *   2. High-frequency MQTT rules without throttle — rules that listen
- *      on `device.shadow` (catch-all) with no throttle can fire on
- *      every shadow push (up to once per second) and exhaust the daily
- *      API quota quickly.
- *
- *   3. Potentially-destructive action without quiet-hours protection —
- *      a rule that targets a destructive verb is technically blocked by
- *      the engine, but we can still flag it early so users don't get a
- *      surprise at runtime.
- *
- * Results are designed to be consumed by `rules doctor --json` and
- * by CI pipelines. Each finding carries a `severity` so callers can
- * decide how to gate on them.
- */
-import { isTimeBetween, isAllCondition, isAnyCondition, isNotCondition } from './types.js';
-import { parseMaxPerMs } from './throttle.js';
-import { isDestructiveCommand } from './destructive.js';
-import { extractDeviceIdFromAction } from './action.js';
-/** Known opposing command pairs (order-independent). */
-const OPPOSING_PAIRS = [
-    ['turnOn', 'turnOff'],
-    ['lock', 'unlock'],
-    ['open', 'close'],
-    ['openDoor', 'closeDoor'],
-    ['openCurtain', 'closeCurtain'],
-    ['turnOn', 'standby'],
-    ['brightnessUp', 'brightnessDown'],
-    ['volumeUp', 'volumeDown'],
-    ['fanSpeedUp', 'fanSpeedDown'],
-];
-/**
- * MQTT events that fire on every device state push and can rapidly exhaust
- * the daily API quota when a rule has no throttle.
- *
- * Conditional events like `motion.detected` are intentionally excluded —
- * they fire discretely, not at continuous high frequency. Extend this set
- * when new catch-all or near-continuous event types are added to the classifier.
- */
-export const HIGH_FREQ_EVENTS = ['device.shadow', '*'];
-/** Returns true when an MQTT event is known to fire at high frequency. */
-export function isHighFreqEvent(event) {
-    return HIGH_FREQ_EVENTS.includes(event);
-}
-function commandsAreOpposing(a, b) {
-    for (const [x, y] of OPPOSING_PAIRS) {
-        if ((a === x && b === y) || (a === y && b === x))
-            return true;
-    }
-    return false;
-}
-function extractCommandVerb(command) {
-    // command strings are like "devices command <id> turnOn" — extract last token
-    const parts = command.trim().split(/\s+/);
-    return parts[parts.length - 1] ?? command;
-}
-function effectiveCooldownMs(rule) {
-    if (rule.cooldown) {
-        try {
-            return parseMaxPerMs(rule.cooldown);
-        }
-        catch {
-            return null;
-        }
-    }
-    if (rule.throttle?.max_per) {
-        try {
-            return parseMaxPerMs(rule.throttle.max_per);
-        }
-        catch {
-            return null;
-        }
-    }
-    return null;
-}
-function hasTimeBetweenGuard(conditions) {
-    if (!conditions)
-        return false;
-    for (const c of conditions) {
-        if (isTimeBetween(c))
-            return true;
-        if (isAllCondition(c) && hasTimeBetweenGuard(c.all))
-            return true;
-        if (isAnyCondition(c) && hasTimeBetweenGuard(c.any))
-            return true;
-        if (isNotCondition(c) && hasTimeBetweenGuard([c.not]))
-            return true;
-    }
-    return false;
-}
-export function analyzeConflicts(rules, quietHours) {
-    const findings = [];
-    const active = rules.filter((r) => r.enabled !== false);
-    // 1. Opposing-action pairs on the same device
-    for (let i = 0; i < active.length; i++) {
-        for (let j = i + 1; j < active.length; j++) {
-            const a = active[i];
-            const b = active[j];
-            // Only flag when they share the same trigger source (otherwise they
-            // can't race each other in normal operation).
-            if (a.when.source !== b.when.source)
-                continue;
-            const cooldownA = effectiveCooldownMs(a);
-            const cooldownB = effectiveCooldownMs(b);
-            // If both rules have meaningful cooldowns (≥ 5 minutes), the risk is
-            // low — skip.
-            const bothThrottled = cooldownA !== null && cooldownA >= 5 * 60_000 &&
-                cooldownB !== null && cooldownB >= 5 * 60_000;
-            if (bothThrottled)
-                continue;
-            for (const actionA of a.then) {
-                for (const actionB of b.then) {
-                    const deviceA = extractDeviceIdFromAction(actionA);
-                    const deviceB = extractDeviceIdFromAction(actionB);
-                    // Skip if devices can't be compared.
-                    if (!deviceA || !deviceB || deviceA !== deviceB)
-                        continue;
-                    const verbA = extractCommandVerb(actionA.command);
-                    const verbB = extractCommandVerb(actionB.command);
-                    if (commandsAreOpposing(verbA, verbB)) {
-                        const noThrottle = cooldownA === null || cooldownB === null;
-                        findings.push({
-                            severity: noThrottle ? 'warning' : 'info',
-                            code: 'opposing-actions',
-                            message: `Rules "${a.name}" and "${b.name}" issue opposing commands (${verbA} / ${verbB}) on device "${deviceA}" via the same trigger source.`,
-                            rules: [a.name, b.name],
-                            hint: noThrottle
-                                ? 'Add a "cooldown" or "throttle.max_per" to both rules to prevent rapid state oscillation.'
-                                : undefined,
-                        });
-                    }
-                }
-            }
-        }
-    }
-    // 2. High-frequency MQTT catch-all rules without throttle
-    for (const rule of active) {
-        if (rule.when.source !== 'mqtt')
-            continue;
-        const event = rule.when.event;
-        const isHighFreq = isHighFreqEvent(event);
-        if (!isHighFreq)
-            continue;
-        const cooldown = effectiveCooldownMs(rule);
-        if (cooldown === null) {
-            findings.push({
-                severity: 'warning',
-                code: 'high-frequency-no-throttle',
-                message: `Rule "${rule.name}" listens on "${event}" (high-frequency catch-all) with no throttle/cooldown. This can rapidly exhaust the daily API quota.`,
-                rules: [rule.name],
-                hint: 'Add "cooldown: 1m" or "throttle: { max_per: 1m }" to rate-limit this rule.',
-            });
-        }
-        else if (cooldown < 30_000) {
-            findings.push({
-                severity: 'info',
-                code: 'high-frequency-low-throttle',
-                message: `Rule "${rule.name}" listens on "${event}" with a throttle under 30 s. Consider increasing to at least 1 m to protect API quota.`,
-                rules: [rule.name],
-            });
-        }
-    }
-    // 3. Destructive actions in rules (engine blocks these at runtime, but
-    //    surface early with clear guidance).
-    for (const rule of active) {
-        for (let i = 0; i < rule.then.length; i++) {
-            const verb = extractCommandVerb(rule.then[i].command);
-            if (isDestructiveCommand(verb)) {
-                findings.push({
-                    severity: 'error',
-                    code: 'destructive-action-in-rule',
-                    message: `Rule "${rule.name}" then[${i}] contains destructive command "${verb}". The engine blocks this at runtime.`,
-                    rules: [rule.name],
-                    hint: 'Remove the destructive command or replace it with a non-destructive alternative.',
-                });
-            }
-        }
-    }
-    // 4. Event-driven rules with no time_between guard when quiet_hours is defined.
-    //    Cron rules fire on an explicit schedule so their overlap with quiet hours
-    //    requires schedule analysis — flag those separately when needed.
-    if (quietHours?.start && quietHours?.end) {
-        for (const rule of active) {
-            if (rule.when.source === 'cron')
-                continue;
-            if (!hasTimeBetweenGuard(rule.conditions)) {
-                findings.push({
-                    severity: 'warning',
-                    code: 'no-quiet-hours-guard',
-                    message: `Rule "${rule.name}" (${rule.when.source} trigger) has no time_between condition and may fire during quiet hours (${quietHours.start}–${quietHours.end}).`,
-                    rules: [rule.name],
-                    hint: `Add a conditions entry "{ time_between: ['${quietHours.end}', '${quietHours.start}'] }" to block this rule during quiet hours.`,
-                });
-            }
-        }
-    }
-    const counts = { error: 0, warning: 0, info: 0 };
-    for (const f of findings)
-        counts[f.severity]++;
-    return {
-        findings,
-        counts,
-        clean: counts.error === 0,
-    };
-}
-//# sourceMappingURL=conflict-analyzer.js.map

package/dist/rules/conflict-analyzer.js.map

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

package/dist/rules/cron-scheduler.d.ts

@@ -1,62 +0,0 @@
-/**
- * Cron trigger scheduler for the rules engine.
- *
- * Each cron rule gets its own scheduler entry. On every tick the
- * scheduler synthesises an `EngineEvent` with `source: 'cron'` and hands
- * it to the same dispatch path the MQTT pipeline uses, so conditions,
- * throttle, and action execution behave identically regardless of
- * trigger source.
- *
- * Tests can drive the scheduler deterministically via `fireNowForTest()`
- * — the scheduler's internal timer still uses `setTimeout`, which means
- * `vi.useFakeTimers()` plus `vi.advanceTimersByTime()` also work. Croner
- * is used only for `nextRun(fromDate)` calculations; we own the
- * timer/dispatch loop so the engine can drain events through a single
- * serialised queue.
- */
-import type { EngineEvent, Rule, DayOfWeek } from './types.js';
-/** Return true if `t` falls on one of the listed days (or days is absent/empty). */
-export declare function matchesDayFilter(days: DayOfWeek[] | undefined, t: Date): boolean;
-export interface CronDispatch {
-    (rule: Rule, event: EngineEvent): Promise<void>;
-}
-export interface CronSchedulerOptions {
-    /** Dispatch callback — the engine's queue wrapper that runs the rule. */
-    dispatch: CronDispatch;
-    /** Clock injection for tests; defaults to Date.now. */
-    now?: () => Date;
-}
-export declare class CronScheduler {
-    private readonly opts;
-    private readonly entries;
-    private started;
-    private stopped;
-    constructor(opts: CronSchedulerOptions);
-    getScheduledFor(ruleName: string): {
-        schedule: string;
-        nextAt: Date | null;
-    } | null;
-    hasRegistered(ruleName: string): boolean;
-    /**
-     * Register a cron rule. Validates the pattern eagerly — an invalid
-     * schedule throws synchronously so engine start can surface the error.
-     */
-    register(rule: Rule): void;
-    unregister(ruleName: string): void;
-    start(): void;
-    stop(): void;
-    /**
-     * Test helper — compute the pattern's next run after a reference
-     * timestamp without actually scheduling it. Handy for regression tests.
-     */
-    nextRunAfter(ruleName: string, after: Date): Date | null;
-    /**
-     * Test helper — fire a rule immediately, bypassing the timer. Used by
-     * unit tests to skip vi.advanceTimersByTime logic when the focus is on
-     * dispatch behaviour, not scheduling accuracy.
-     */
-    fireNowForTest(ruleName: string): Promise<void>;
-    private nowDate;
-    private arm;
-    private fire;
-}

package/dist/rules/cron-scheduler.js

@@ -1,187 +0,0 @@
-/**
- * Cron trigger scheduler for the rules engine.
- *
- * Each cron rule gets its own scheduler entry. On every tick the
- * scheduler synthesises an `EngineEvent` with `source: 'cron'` and hands
- * it to the same dispatch path the MQTT pipeline uses, so conditions,
- * throttle, and action execution behave identically regardless of
- * trigger source.
- *
- * Tests can drive the scheduler deterministically via `fireNowForTest()`
- * — the scheduler's internal timer still uses `setTimeout`, which means
- * `vi.useFakeTimers()` plus `vi.advanceTimersByTime()` also work. Croner
- * is used only for `nextRun(fromDate)` calculations; we own the
- * timer/dispatch loop so the engine can drain events through a single
- * serialised queue.
- */
-import { Cron } from 'croner';
-/** Maps JS getDay() (0=Sun) to 3-letter abbreviation. */
-const JS_DAY_TO_ABBR = ['sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat'];
-/** Expand a days[] entry to its canonical 3-letter abbr so comparisons are O(1). */
-function normaliseDay(d) {
-    return d.toLowerCase().slice(0, 3);
-}
-/** Return true if `t` falls on one of the listed days (or days is absent/empty). */
-export function matchesDayFilter(days, t) {
-    if (!days || days.length === 0)
-        return true;
-    const todayAbbr = JS_DAY_TO_ABBR[t.getDay()];
-    return days.some((d) => normaliseDay(d) === todayAbbr);
-}
-export class CronScheduler {
-    opts;
-    entries = new Map();
-    started = false;
-    stopped = false;
-    constructor(opts) {
-        this.opts = opts;
-    }
-    getScheduledFor(ruleName) {
-        const s = this.entries.get(ruleName);
-        if (!s)
-            return null;
-        return { schedule: s.schedule, nextAt: s.nextAt };
-    }
-    hasRegistered(ruleName) {
-        return this.entries.has(ruleName);
-    }
-    /**
-     * Register a cron rule. Validates the pattern eagerly — an invalid
-     * schedule throws synchronously so engine start can surface the error.
-     */
-    register(rule) {
-        if (rule.when.source !== 'cron') {
-            throw new Error(`CronScheduler.register called for non-cron rule "${rule.name}"`);
-        }
-        if (this.entries.has(rule.name)) {
-            throw new Error(`CronScheduler: duplicate rule name "${rule.name}"`);
-        }
-        const schedule = rule.when.schedule;
-        let pattern;
-        try {
-            pattern = new Cron(schedule, { paused: true });
-        }
-        catch (err) {
-            throw new Error(`CronScheduler: invalid cron expression for rule "${rule.name}": ${schedule} (${err instanceof Error ? err.message : String(err)})`);
-        }
-        const entry = {
-            rule,
-            schedule,
-            pattern,
-            timer: null,
-            nextAt: null,
-        };
-        this.entries.set(rule.name, entry);
-        if (this.started && !this.stopped)
-            this.arm(entry);
-    }
-    unregister(ruleName) {
-        const e = this.entries.get(ruleName);
-        if (!e)
-            return;
-        if (e.timer)
-            clearTimeout(e.timer);
-        try {
-            e.pattern.stop();
-        }
-        catch {
-            // croner throws when already stopped — ignore.
-        }
-        this.entries.delete(ruleName);
-    }
-    start() {
-        if (this.stopped) {
-            throw new Error('CronScheduler: cannot start after stop().');
-        }
-        if (this.started)
-            return;
-        this.started = true;
-        for (const entry of this.entries.values())
-            this.arm(entry);
-    }
-    stop() {
-        if (this.stopped)
-            return;
-        this.stopped = true;
-        this.started = false;
-        for (const e of this.entries.values()) {
-            if (e.timer)
-                clearTimeout(e.timer);
-            e.timer = null;
-            try {
-                e.pattern.stop();
-            }
-            catch {
-                // ignore
-            }
-        }
-    }
-    /**
-     * Test helper — compute the pattern's next run after a reference
-     * timestamp without actually scheduling it. Handy for regression tests.
-     */
-    nextRunAfter(ruleName, after) {
-        const e = this.entries.get(ruleName);
-        if (!e)
-            return null;
-        return e.pattern.nextRun(after) ?? null;
-    }
-    /**
-     * Test helper — fire a rule immediately, bypassing the timer. Used by
-     * unit tests to skip vi.advanceTimersByTime logic when the focus is on
-     * dispatch behaviour, not scheduling accuracy.
-     */
-    async fireNowForTest(ruleName) {
-        const e = this.entries.get(ruleName);
-        if (!e)
-            throw new Error(`CronScheduler.fireNowForTest: no rule "${ruleName}"`);
-        await this.fire(e);
-    }
-    nowDate() {
-        return this.opts.now ? this.opts.now() : new Date();
-    }
-    arm(entry) {
-        if (this.stopped)
-            return;
-        const now = this.nowDate();
-        const next = entry.pattern.nextRun(now);
-        if (!next) {
-            entry.nextAt = null;
-            return;
-        }
-        entry.nextAt = next;
-        const delayMs = Math.max(0, next.getTime() - now.getTime());
-        entry.timer = setTimeout(() => {
-            entry.timer = null;
-            // Fire and then re-arm, regardless of outcome — we never want one
-            // misbehaving rule to kill its own future ticks.
-            this.fire(entry)
-                .catch(() => undefined)
-                .finally(() => {
-                if (!this.stopped && this.entries.has(entry.rule.name))
-                    this.arm(entry);
-            });
-        }, delayMs);
-        // Unref so a process with only cron rules still exits on SIGINT when
-        // the user expects (e.g. in integration tests).
-        if (typeof entry.timer.unref === 'function') {
-            entry.timer.unref();
-        }
-    }
-    async fire(entry) {
-        const when = this.nowDate();
-        // Apply the optional day-of-week filter before dispatching.
-        const trigger = entry.rule.when;
-        if (trigger.source === 'cron' && !matchesDayFilter(trigger.days, when)) {
-            return;
-        }
-        const event = {
-            source: 'cron',
-            event: entry.schedule,
-            t: when,
-            payload: { schedule: entry.schedule },
-        };
-        await this.opts.dispatch(entry.rule, event);
-    }
-}
-//# sourceMappingURL=cron-scheduler.js.map

package/dist/rules/cron-scheduler.js.map

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

package/dist/rules/destructive.d.ts

@@ -1,20 +0,0 @@
-/**
- * Destructive command parsing — single source of truth shared between the
- * policy validator post-hook (rejects destructive commands inside
- * `automation.rules[].then[].command`) and the runtime executor (second-
- * line guard that refuses to shell out even if validation was bypassed).
- */
-export declare const DESTRUCTIVE_COMMANDS: readonly ["lock", "unlock", "deleteWebhook", "deleteScene", "factoryReset"];
-export type DestructiveCommand = (typeof DESTRUCTIVE_COMMANDS)[number];
-/**
- * Parse the verb out of a rule action command string. The expected form
- * mirrors what the engine will eventually build: `devices command <id> <verb> [args...]`.
- * We also accept scene shorthands (`scenes run <id>`, `webhooks delete <id>`).
- *
- * Returns null for anything we cannot confidently attribute to a known verb
- * slot — the validator treats null as "probably fine, let the engine's own
- * guard handle it if it's not."
- */
-export declare function extractVerb(cmd: string): string | null;
-export declare function isDestructiveCommand(cmd: string): boolean;
-export declare function destructiveVerbOf(cmd: string): DestructiveCommand | null;