@switchbot/openapi-cli 3.2.0 → 3.2.1

package/dist/rules/action.js

@@ -0,0 +1,217 @@
+/**
+ * Rule action executor — the only place that calls into `executeCommand`
+ * from the rules pipeline.
+ *
+ * Responsibilities:
+ *   1. Parse the `command` string into a `{ deviceId, verb, parameter }`
+ *      tuple, rejecting shapes the PoC doesn't understand.
+ *   2. Enforce the destructive-command blocklist as a second line of
+ *      defence (the validator should have caught it at load time — this
+ *      protects against hand-crafted engine inputs).
+ *   3. Resolve `action.device` (alias or deviceId) into the `<id>`
+ *      slot.
+ *   4. Branch on `dry_run`: dry-run writes audit with kind
+ *      `rule-fire-dry` and returns without touching the API.
+ *   5. Live run delegates to `executeCommand`, then re-writes audit
+ *      with the rule-scoped kind + fireId so `rules tail` / `replay`
+ *      can correlate multi-action fires.
+ */
+import { executeCommand } from '../lib/devices.js';
+import { writeAudit } from '../utils/audit.js';
+import { isDestructiveCommand } from './destructive.js';
+const DEVICES_COMMAND_RE = /^devices\s+command\s+(\S+)\s+(\S+)(?:\s+(.*))?$/;
+export function parseRuleCommand(cmd) {
+    const m = DEVICES_COMMAND_RE.exec(cmd.trim());
+    if (!m)
+        return null;
+    const deviceIdSlot = m[1];
+    const verb = m[2];
+    const rest = (m[3] ?? '').trim();
+    return {
+        deviceIdSlot,
+        verb,
+        parameterTokens: rest.length === 0 ? [] : rest.split(/\s+/),
+    };
+}
+/** Alias-first resolver — falls back to the raw value (assumed deviceId). */
+export function resolveActionDevice(explicit, slot, aliases) {
+    // Explicit device field on the action wins.
+    const candidate = explicit ?? (slot && slot !== '<id>' ? slot : null);
+    if (!candidate)
+        return null;
+    if (aliases[candidate])
+        return aliases[candidate];
+    return candidate;
+}
+/**
+ * Render a parameter for SwitchBot's command API. For the PoC we pass
+ * the raw token string for single-token args, join with `:` for
+ * multi-token args (matches the CLI's `devices command` convention),
+ * and `undefined` when no tokens were supplied (the SDK substitutes
+ * `'default'`).
+ */
+function renderParameter(tokens) {
+    if (tokens.length === 0)
+        return undefined;
+    if (tokens.length === 1)
+        return tokens[0];
+    return tokens.join(':');
+}
+export async function executeRuleAction(action, ctx) {
+    const parsed = parseRuleCommand(action.command);
+    if (!parsed) {
+        writeAudit({
+            t: new Date().toISOString(),
+            kind: 'rule-fire',
+            deviceId: 'unknown',
+            command: action.command,
+            parameter: null,
+            commandType: 'command',
+            dryRun: true,
+            result: 'error',
+            error: 'unparseable-command',
+            rule: {
+                name: ctx.rule.name,
+                triggerSource: ctx.rule.when.source,
+                fireId: ctx.fireId,
+                reason: 'unparseable-command',
+            },
+        });
+        return { ok: false, error: 'unparseable-command', blocked: true };
+    }
+    if (isDestructiveCommand(action.command)) {
+        writeAudit({
+            t: new Date().toISOString(),
+            kind: 'rule-fire',
+            deviceId: resolveActionDevice(action.device, parsed.deviceIdSlot, ctx.aliases) ?? 'unknown',
+            command: action.command,
+            parameter: null,
+            commandType: 'command',
+            dryRun: true,
+            result: 'error',
+            error: `destructive-verb:${parsed.verb}`,
+            rule: {
+                name: ctx.rule.name,
+                triggerSource: ctx.rule.when.source,
+                fireId: ctx.fireId,
+                reason: `destructive verb "${parsed.verb}" refused at runtime`,
+            },
+        });
+        return { ok: false, error: `destructive-verb:${parsed.verb}`, blocked: true, verb: parsed.verb };
+    }
+    const deviceId = resolveActionDevice(action.device, parsed.deviceIdSlot, ctx.aliases);
+    if (!deviceId || deviceId === '<id>') {
+        writeAudit({
+            t: new Date().toISOString(),
+            kind: 'rule-fire',
+            deviceId: 'unknown',
+            command: action.command,
+            parameter: null,
+            commandType: 'command',
+            dryRun: true,
+            result: 'error',
+            error: 'missing-device',
+            rule: {
+                name: ctx.rule.name,
+                triggerSource: ctx.rule.when.source,
+                fireId: ctx.fireId,
+                reason: 'action omitted `device` and command used `<id>` placeholder',
+            },
+        });
+        return { ok: false, error: 'missing-device', verb: parsed.verb };
+    }
+    const dryRun = ctx.globalDryRun === true || ctx.rule.dry_run === true;
+    const parameter = renderParameter(parsed.parameterTokens);
+    if (dryRun) {
+        writeAudit({
+            t: new Date().toISOString(),
+            kind: 'rule-fire-dry',
+            deviceId,
+            command: parsed.verb,
+            parameter: parameter ?? 'default',
+            commandType: 'command',
+            dryRun: true,
+            result: 'ok',
+            rule: {
+                name: ctx.rule.name,
+                triggerSource: ctx.rule.when.source,
+                matchedDevice: deviceId,
+                fireId: ctx.fireId,
+            },
+        });
+        return { ok: true, dryRun: true, deviceId, verb: parsed.verb };
+    }
+    if (ctx.skipApiCall) {
+        writeAudit({
+            t: new Date().toISOString(),
+            kind: 'rule-fire',
+            deviceId,
+            command: parsed.verb,
+            parameter: parameter ?? 'default',
+            commandType: 'command',
+            dryRun: false,
+            result: 'ok',
+            rule: {
+                name: ctx.rule.name,
+                triggerSource: ctx.rule.when.source,
+                matchedDevice: deviceId,
+                fireId: ctx.fireId,
+                reason: 'api-skipped',
+            },
+        });
+        return { ok: true, deviceId, verb: parsed.verb };
+    }
+    try {
+        await executeCommand(deviceId, parsed.verb, parameter, 'command', ctx.httpClient);
+        writeAudit({
+            t: new Date().toISOString(),
+            kind: 'rule-fire',
+            deviceId,
+            command: parsed.verb,
+            parameter: parameter ?? 'default',
+            commandType: 'command',
+            dryRun: false,
+            result: 'ok',
+            rule: {
+                name: ctx.rule.name,
+                triggerSource: ctx.rule.when.source,
+                matchedDevice: deviceId,
+                fireId: ctx.fireId,
+            },
+        });
+        return { ok: true, deviceId, verb: parsed.verb };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        writeAudit({
+            t: new Date().toISOString(),
+            kind: 'rule-fire',
+            deviceId,
+            command: parsed.verb,
+            parameter: parameter ?? 'default',
+            commandType: 'command',
+            dryRun: false,
+            result: 'error',
+            error: msg,
+            rule: {
+                name: ctx.rule.name,
+                triggerSource: ctx.rule.when.source,
+                matchedDevice: deviceId,
+                fireId: ctx.fireId,
+            },
+        });
+        return { ok: false, error: msg, deviceId, verb: parsed.verb };
+    }
+}
+/**
+ * Extract the raw deviceId from an action object without alias resolution.
+ * Prefers `action.device` over the deviceId embedded in the command string.
+ * Use resolveActionDevice() when alias resolution is needed.
+ */
+export function extractDeviceIdFromAction(action) {
+    if (action.device)
+        return action.device;
+    const m = /\bdevices\s+command\s+(\S+)/.exec(action.command ?? '');
+    return m ? m[1] : null;
+}
+//# sourceMappingURL=action.js.map

package/dist/rules/action.js.map

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

package/dist/rules/audit-query.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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.
+ */
+import type { AuditEntry, AuditEntryKind } from '../utils/audit.js';
+/** The subset of audit kinds the rules engine emits. */
+export declare const RULE_AUDIT_KINDS: readonly AuditEntryKind[];
+export interface RuleAuditFilter {
+    /** Filter entries with `t >= sinceMs`. Unbounded when undefined. */
+    sinceMs?: number;
+    /** Filter to a single rule name (matched against entry.rule?.name). */
+    ruleName?: string;
+    /** Only these kinds are returned. Defaults to RULE_AUDIT_KINDS. */
+    kinds?: readonly AuditEntryKind[];
+}
+/** Keep entries that are rule-engine emitted and match the filter. */
+export declare function filterRuleAudits(entries: readonly AuditEntry[], filter?: RuleAuditFilter): AuditEntry[];
+export interface RuleSummary {
+    /** Rule name as recorded in the audit entry. */
+    rule: string;
+    /** Number of real (non-dry) fires. */
+    fires: number;
+    /** Number of dry fires. */
+    driesFires: number;
+    /** Number of throttled skips. */
+    throttled: number;
+    /** Number of entries whose `result === 'error'`. */
+    errors: number;
+    /** fires where result === 'ok' divided by fires + driesFires + errors fired. */
+    errorRate: number;
+    /** Earliest timestamp observed for this rule (ISO). */
+    firstAt: string | null;
+    /** Latest timestamp observed for this rule (ISO). */
+    lastAt: string | null;
+    /** Trigger source observed — 'mixed' if the same rule name spans sources. */
+    triggerSource: 'mqtt' | 'cron' | 'webhook' | 'mixed' | null;
+}
+export interface ReplayReport {
+    /** Total entries (after filter) considered. */
+    total: number;
+    /** Per-rule summaries, sorted by `fires + driesFires` descending. */
+    summaries: RuleSummary[];
+    /** Count of rule-webhook-rejected entries with no rule name. */
+    webhookRejectedCount: number;
+}
+/** Aggregate a filtered stream into per-rule counters. */
+export declare function aggregateRuleAudits(entries: readonly AuditEntry[]): ReplayReport;

package/dist/rules/audit-query.js

@@ -0,0 +1,90 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,57 @@
+/**
+ * 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

@@ -0,0 +1,215 @@
+/**
+ * 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

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