@mmnto/cli 1.5.4 → 1.5.5

package/dist/commands/ledger-analyzer.js

@@ -0,0 +1,64 @@
+import * as fs from 'node:fs';
+import * as readline from 'node:readline';
+import { LedgerEventSchema } from '@mmnto/totem';
+// ─── Public API ────────────────────────────────────
+/**
+ * Analyze the Trap Ledger to compute bypass rates per rule.
+ *
+ * Reads bypass events from the ledger (source of truth for exceptions)
+ * and trigger counts from rule-metrics (only source for trigger data).
+ */
+export async function analyzeLedger(totemDir, onWarn) {
+    // 1. Read bypass counts from ledger (streaming)
+    const bypassCounts = await readLedgerBypassCounts(totemDir, onWarn);
+    // 2. Read trigger counts from rule-metrics
+    const { loadRuleMetrics } = await import('@mmnto/totem');
+    const metrics = loadRuleMetrics(totemDir, onWarn);
+    // 3. Merge into stats
+    const stats = new Map();
+    const allRuleIds = new Set([...bypassCounts.keys(), ...Object.keys(metrics.rules)]);
+    for (const ruleId of allRuleIds) {
+        const bypasses = bypassCounts.get(ruleId) ?? 0;
+        const triggers = metrics.rules[ruleId]?.triggerCount ?? 0;
+        const total = triggers + bypasses;
+        stats.set(ruleId, {
+            ruleId,
+            triggerCount: triggers,
+            bypassCount: bypasses,
+            bypassRate: total === 0 ? 0 : bypasses / total,
+            totalEvents: total,
+        });
+    }
+    return stats;
+}
+// ─── Internal ──────────────────────────────────────
+/**
+ * Stream the ledger NDJSON file and count bypass events per ruleId.
+ * Uses readline for memory-efficient parsing of large ledgers.
+ */
+export async function readLedgerBypassCounts(totemDir, onWarn) {
+    const path = await import('node:path');
+    const ledgerPath = path.join(totemDir, 'ledger', 'events.ndjson');
+    const counts = new Map();
+    if (!fs.existsSync(ledgerPath))
+        return counts;
+    const stream = fs.createReadStream(ledgerPath, 'utf-8');
+    const rl = readline.createInterface({ input: stream });
+    for await (const line of rl) {
+        if (!line.trim())
+            continue;
+        try {
+            const parsed = JSON.parse(line);
+            const result = LedgerEventSchema.safeParse(parsed);
+            if (!result.success)
+                continue;
+            const event = result.data;
+            counts.set(event.ruleId, (counts.get(event.ruleId) ?? 0) + 1);
+        }
+        catch {
+            onWarn?.('Skipping malformed ledger line');
+        }
+    }
+    return counts;
+}
+//# sourceMappingURL=ledger-analyzer.js.map

package/dist/commands/ledger-analyzer.js.map

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

package/dist/commands/ledger-analyzer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ledger-analyzer.test.d.ts.map

package/dist/commands/ledger-analyzer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-analyzer.test.d.ts","sourceRoot":"","sources":["../../src/commands/ledger-analyzer.test.ts"],"names":[],"mappings":""}

package/dist/commands/ledger-analyzer.test.js

@@ -0,0 +1,163 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { analyzeLedger, readLedgerBypassCounts } from './ledger-analyzer.js';
+// ─── Helpers ────────────────────────────────────────────
+function makeTmpDir() {
+    return fs.mkdtempSync(path.join(os.tmpdir(), 'totem-ledger-analyzer-'));
+}
+function makeLedgerEvent(ruleId, type = 'suppress') {
+    return JSON.stringify({
+        timestamp: '2026-03-25T12:00:00.000Z',
+        type,
+        ruleId,
+        file: 'src/index.ts',
+        justification: type === 'override' ? 'Legacy code' : '',
+        source: 'lint',
+    });
+}
+function writeLedger(totemDir, lines) {
+    const ledgerDir = path.join(totemDir, 'ledger');
+    fs.mkdirSync(ledgerDir, { recursive: true });
+    fs.writeFileSync(path.join(ledgerDir, 'events.ndjson'), lines.join('\n') + '\n', 'utf-8');
+}
+function writeMetrics(totemDir, rules) {
+    const cacheDir = path.join(totemDir, 'cache');
+    fs.mkdirSync(cacheDir, { recursive: true });
+    const metricsData = {
+        version: 1,
+        rules: Object.fromEntries(Object.entries(rules).map(([id, counts]) => [
+            id,
+            {
+                triggerCount: counts.triggerCount,
+                suppressCount: counts.suppressCount,
+                lastTriggeredAt: '2026-03-25T12:00:00.000Z',
+                lastSuppressedAt: null,
+            },
+        ])),
+    };
+    fs.writeFileSync(path.join(cacheDir, 'rule-metrics.json'), JSON.stringify(metricsData, null, 2) + '\n', 'utf-8');
+}
+// ─── readLedgerBypassCounts ─────────────────────────────
+describe('readLedgerBypassCounts', () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = makeTmpDir();
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('returns empty map when ledger does not exist', async () => {
+        const counts = await readLedgerBypassCounts(tmpDir);
+        expect(counts.size).toBe(0);
+    });
+    it('counts bypass events per ruleId', async () => {
+        writeLedger(tmpDir, [
+            makeLedgerEvent('rule-a'),
+            makeLedgerEvent('rule-b'),
+            makeLedgerEvent('rule-a'),
+            makeLedgerEvent('rule-a', 'override'),
+        ]);
+        const counts = await readLedgerBypassCounts(tmpDir);
+        expect(counts.get('rule-a')).toBe(3);
+        expect(counts.get('rule-b')).toBe(1);
+    });
+    it('skips malformed lines and warns', async () => {
+        const onWarn = vi.fn();
+        writeLedger(tmpDir, [makeLedgerEvent('rule-a'), '{{{invalid json', makeLedgerEvent('rule-b')]);
+        const counts = await readLedgerBypassCounts(tmpDir, onWarn);
+        expect(counts.get('rule-a')).toBe(1);
+        expect(counts.get('rule-b')).toBe(1);
+        expect(onWarn).toHaveBeenCalledWith('Skipping malformed ledger line');
+    });
+    it('skips events that fail schema validation', async () => {
+        writeLedger(tmpDir, [
+            makeLedgerEvent('rule-a'),
+            JSON.stringify({ type: 'suppress' }), // missing required fields
+        ]);
+        const counts = await readLedgerBypassCounts(tmpDir);
+        expect(counts.get('rule-a')).toBe(1);
+        expect(counts.size).toBe(1);
+    });
+    it('skips blank lines', async () => {
+        const ledgerDir = path.join(tmpDir, 'ledger');
+        fs.mkdirSync(ledgerDir, { recursive: true });
+        fs.writeFileSync(path.join(ledgerDir, 'events.ndjson'), makeLedgerEvent('rule-a') + '\n\n\n' + makeLedgerEvent('rule-b') + '\n', 'utf-8');
+        const counts = await readLedgerBypassCounts(tmpDir);
+        expect(counts.get('rule-a')).toBe(1);
+        expect(counts.get('rule-b')).toBe(1);
+    });
+});
+// ─── analyzeLedger ──────────────────────────────────────
+describe('analyzeLedger', () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = makeTmpDir();
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('returns empty map when no ledger or metrics exist', async () => {
+        const stats = await analyzeLedger(tmpDir);
+        expect(stats.size).toBe(0);
+    });
+    it('counts bypass events from ledger', async () => {
+        writeLedger(tmpDir, [
+            makeLedgerEvent('rule-a'),
+            makeLedgerEvent('rule-a'),
+            makeLedgerEvent('rule-b'),
+        ]);
+        const stats = await analyzeLedger(tmpDir);
+        expect(stats.get('rule-a')?.bypassCount).toBe(2);
+        expect(stats.get('rule-b')?.bypassCount).toBe(1);
+    });
+    it('merges trigger counts from rule-metrics', async () => {
+        writeLedger(tmpDir, [makeLedgerEvent('rule-a')]);
+        writeMetrics(tmpDir, {
+            'rule-a': { triggerCount: 10, suppressCount: 1 },
+            'rule-c': { triggerCount: 5, suppressCount: 0 },
+        });
+        const stats = await analyzeLedger(tmpDir);
+        // rule-a: 10 triggers + 1 bypass from ledger
+        expect(stats.get('rule-a')?.triggerCount).toBe(10);
+        expect(stats.get('rule-a')?.bypassCount).toBe(1);
+        expect(stats.get('rule-a')?.totalEvents).toBe(11);
+        // rule-c: 5 triggers, 0 bypasses (not in ledger)
+        expect(stats.get('rule-c')?.triggerCount).toBe(5);
+        expect(stats.get('rule-c')?.bypassCount).toBe(0);
+        expect(stats.get('rule-c')?.totalEvents).toBe(5);
+    });
+    it('calculates correct bypass rate', async () => {
+        writeLedger(tmpDir, [makeLedgerEvent('rule-a'), makeLedgerEvent('rule-a')]);
+        writeMetrics(tmpDir, {
+            'rule-a': { triggerCount: 8, suppressCount: 2 },
+        });
+        const stats = await analyzeLedger(tmpDir);
+        const ruleA = stats.get('rule-a');
+        // 2 bypasses / (8 triggers + 2 bypasses) = 0.2
+        expect(ruleA.bypassRate).toBeCloseTo(0.2);
+        expect(ruleA.totalEvents).toBe(10);
+    });
+    it('handles div-by-zero: 0 events yields 0% rate', async () => {
+        // Rule exists in metrics with 0 triggers and 0 suppressions
+        writeMetrics(tmpDir, {
+            'rule-empty': { triggerCount: 0, suppressCount: 0 },
+        });
+        const stats = await analyzeLedger(tmpDir);
+        const ruleEmpty = stats.get('rule-empty');
+        expect(ruleEmpty.bypassRate).toBe(0);
+        expect(ruleEmpty.totalEvents).toBe(0);
+    });
+    it('handles missing ledger file gracefully', async () => {
+        writeMetrics(tmpDir, {
+            'rule-a': { triggerCount: 3, suppressCount: 0 },
+        });
+        const stats = await analyzeLedger(tmpDir);
+        const ruleA = stats.get('rule-a');
+        expect(ruleA.triggerCount).toBe(3);
+        expect(ruleA.bypassCount).toBe(0);
+        expect(ruleA.bypassRate).toBe(0);
+    });
+});
+//# sourceMappingURL=ledger-analyzer.test.js.map

package/dist/commands/ledger-analyzer.test.js.map

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

package/dist/commands/rule-mutator.d.ts

@@ -0,0 +1,17 @@
+export interface DowngradeResult {
+    /** Whether the downgrade was applied */
+    downgraded: boolean;
+    /** Previous severity before the change (undefined if rule not found) */
+    previousSeverity?: string;
+    /** Human-readable rule heading (undefined if rule not found) */
+    ruleHeading?: string;
+}
+/**
+ * Downgrade a rule from error to warning in compiled-rules.json.
+ *
+ * Returns whether the downgrade was applied.
+ * Idempotent — skips rules already at warning severity.
+ * Never deletes rules (ADR-027).
+ */
+export declare function downgradeRuleToWarning(rulesPath: string, ruleId: string): DowngradeResult;
+//# sourceMappingURL=rule-mutator.d.ts.map

package/dist/commands/rule-mutator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-mutator.d.ts","sourceRoot":"","sources":["../../src/commands/rule-mutator.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,UAAU,EAAE,OAAO,CAAC;IACpB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAyBzF"}

package/dist/commands/rule-mutator.js

@@ -0,0 +1,33 @@
+import * as fs from 'node:fs';
+// ─── Public API ────────────────────────────────────
+/**
+ * Downgrade a rule from error to warning in compiled-rules.json.
+ *
+ * Returns whether the downgrade was applied.
+ * Idempotent — skips rules already at warning severity.
+ * Never deletes rules (ADR-027).
+ */
+export function downgradeRuleToWarning(rulesPath, ruleId) {
+    const content = fs.readFileSync(rulesPath, 'utf-8');
+    const data = JSON.parse(content);
+    const rule = data.rules?.find((r) => r.lessonHash === ruleId);
+    if (!rule)
+        return { downgraded: false };
+    const currentSeverity = rule.severity ?? 'error';
+    if (currentSeverity !== 'error') {
+        return {
+            downgraded: false,
+            previousSeverity: currentSeverity,
+            ruleHeading: rule.lessonHeading,
+        };
+    }
+    rule.severity = 'warning';
+    // Preserve 2-space indent formatting
+    fs.writeFileSync(rulesPath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+    return {
+        downgraded: true,
+        previousSeverity: 'error',
+        ruleHeading: rule.lessonHeading,
+    };
+}
+//# sourceMappingURL=rule-mutator.js.map

package/dist/commands/rule-mutator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-mutator.js","sourceRoot":"","sources":["../../src/commands/rule-mutator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAa9B,sDAAsD;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,MAAc;IACtE,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEjC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAyB,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC;IACtF,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAExC,MAAM,eAAe,GAAW,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC;IACzD,IAAI,eAAe,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,gBAAgB,EAAE,eAAe;YACjC,WAAW,EAAE,IAAI,CAAC,aAAa;SAChC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC1B,qCAAqC;IACrC,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAE3E,OAAO;QACL,UAAU,EAAE,IAAI;QAChB,gBAAgB,EAAE,OAAO;QACzB,WAAW,EAAE,IAAI,CAAC,aAAa;KAChC,CAAC;AACJ,CAAC"}

package/dist/commands/rule-mutator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rule-mutator.test.d.ts.map

package/dist/commands/rule-mutator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-mutator.test.d.ts","sourceRoot":"","sources":["../../src/commands/rule-mutator.test.ts"],"names":[],"mappings":""}

package/dist/commands/rule-mutator.test.js

@@ -0,0 +1,104 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { downgradeRuleToWarning } from './rule-mutator.js';
+// ─── Helpers ────────────────────────────────────────────
+function makeTmpDir() {
+    return fs.mkdtempSync(path.join(os.tmpdir(), 'totem-rule-mutator-'));
+}
+function makeCompiledRules(rules) {
+    return {
+        version: 1,
+        rules: rules.map((r) => ({
+            lessonHash: r.lessonHash,
+            lessonHeading: r.lessonHeading,
+            pattern: r.pattern ?? '\\bconsole\\.log\\b',
+            message: `Violation: ${r.lessonHeading}`,
+            engine: 'regex',
+            compiledAt: '2026-03-25T12:00:00.000Z',
+            ...(r.severity !== undefined ? { severity: r.severity } : {}),
+        })),
+    };
+}
+function writeRules(dir, data) {
+    const rulesPath = path.join(dir, 'compiled-rules.json');
+    fs.writeFileSync(rulesPath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+    return rulesPath;
+}
+// ─── downgradeRuleToWarning ─────────────────────────────
+describe('downgradeRuleToWarning', () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = makeTmpDir();
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('changes error to warning', () => {
+        const rulesPath = writeRules(tmpDir, makeCompiledRules([
+            { lessonHash: 'abc123', lessonHeading: 'No console.log', severity: 'error' },
+        ]));
+        const result = downgradeRuleToWarning(rulesPath, 'abc123');
+        expect(result.downgraded).toBe(true);
+        expect(result.previousSeverity).toBe('error');
+        expect(result.ruleHeading).toBe('No console.log');
+        // Verify the file was updated
+        const updated = JSON.parse(fs.readFileSync(rulesPath, 'utf-8'));
+        expect(updated.rules[0].severity).toBe('warning');
+    });
+    it('downgrades rules with implicit error severity (no severity field)', () => {
+        const rulesPath = writeRules(tmpDir, makeCompiledRules([
+            { lessonHash: 'abc123', lessonHeading: 'No console.log' }, // no severity = defaults to error
+        ]));
+        const result = downgradeRuleToWarning(rulesPath, 'abc123');
+        expect(result.downgraded).toBe(true);
+        expect(result.previousSeverity).toBe('error');
+        const updated = JSON.parse(fs.readFileSync(rulesPath, 'utf-8'));
+        expect(updated.rules[0].severity).toBe('warning');
+    });
+    it('skips rules already at warning (idempotent)', () => {
+        const rulesPath = writeRules(tmpDir, makeCompiledRules([
+            { lessonHash: 'abc123', lessonHeading: 'No console.log', severity: 'warning' },
+        ]));
+        const result = downgradeRuleToWarning(rulesPath, 'abc123');
+        expect(result.downgraded).toBe(false);
+        expect(result.previousSeverity).toBe('warning');
+        expect(result.ruleHeading).toBe('No console.log');
+    });
+    it('returns false for unknown ruleId', () => {
+        const rulesPath = writeRules(tmpDir, makeCompiledRules([
+            { lessonHash: 'abc123', lessonHeading: 'No console.log', severity: 'error' },
+        ]));
+        const result = downgradeRuleToWarning(rulesPath, 'nonexistent');
+        expect(result.downgraded).toBe(false);
+        expect(result.previousSeverity).toBeUndefined();
+        expect(result.ruleHeading).toBeUndefined();
+    });
+    it('preserves JSON formatting (2-space indent)', () => {
+        const rulesPath = writeRules(tmpDir, makeCompiledRules([
+            { lessonHash: 'abc123', lessonHeading: 'No console.log', severity: 'error' },
+        ]));
+        downgradeRuleToWarning(rulesPath, 'abc123');
+        const content = fs.readFileSync(rulesPath, 'utf-8');
+        // Verify 2-space indentation is preserved
+        expect(content).toContain('  "version"');
+        expect(content).toContain('    "lessonHash"');
+        // Verify trailing newline
+        expect(content.endsWith('\n')).toBe(true);
+    });
+    it('preserves other rules unchanged', () => {
+        const rulesPath = writeRules(tmpDir, makeCompiledRules([
+            { lessonHash: 'rule-1', lessonHeading: 'First rule', severity: 'error' },
+            { lessonHash: 'rule-2', lessonHeading: 'Second rule', severity: 'error' },
+            { lessonHash: 'rule-3', lessonHeading: 'Third rule', severity: 'warning' },
+        ]));
+        downgradeRuleToWarning(rulesPath, 'rule-1');
+        const updated = JSON.parse(fs.readFileSync(rulesPath, 'utf-8'));
+        expect(updated.rules[0].severity).toBe('warning'); // downgraded
+        expect(updated.rules[1].severity).toBe('error'); // unchanged
+        expect(updated.rules[2].severity).toBe('warning'); // unchanged
+        expect(updated.rules).toHaveLength(3); // no rules deleted (ADR-027)
+    });
+});
+//# sourceMappingURL=rule-mutator.test.js.map

package/dist/commands/rule-mutator.test.js.map

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

package/dist/commands/triage-pr.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `totem triage-pr <pr-number>` — Categorized triage view of bot review
+ * comments on a pull request.
+ *
+ * Fetches inline review comments, filters to bot authors, normalizes
+ * into structured findings, deduplicates, categorizes by blast radius,
+ * and renders a compact inbox to stdout.
+ */
+import type { CategorizedFinding } from '../parsers/triage-types.js';
+/**
+ * Format the complete triage output. Exported for testing.
+ */
+export declare function formatTriageOutput(prNumber: number, findings: CategorizedFinding[], totalComments: number, colorize: {
+    red: (s: string) => string;
+    yellow: (s: string) => string;
+    blue: (s: string) => string;
+    gray: (s: string) => string;
+    bold: (s: string) => string;
+}): string;
+export declare function triagePrCommand(prNumber: string): Promise<void>;
+//# sourceMappingURL=triage-pr.d.ts.map

package/dist/commands/triage-pr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage-pr.d.ts","sourceRoot":"","sources":["../../src/commands/triage-pr.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAkB,MAAM,4BAA4B,CAAC;AAkKrF;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE;IACR,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAC7B,GACA,MAAM,CAyER;AAID,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFrE"}