triage-ai 1.0.2

package/dist/memory.js

@@ -0,0 +1,241 @@
+/**
+ * Memory writer — saves triage findings to AI model memory files.
+ *
+ * After triage runs, findings are written to model-specific memory files
+ * so that Claude, Gemini and Codex remember issues in future sessions.
+ *
+ * Supported memory files:
+ * - CLAUDE.md     — Claude Code project instructions
+ * - GEMINI.md     — Gemini CLI project context
+ * - AGENTS.md     — Codex/OpenAI agent instructions
+ */
+import { readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { clusterRepresentative, isConsensus } from './types.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const MEMORY_START = '<!-- triage:start -->';
+export const MEMORY_END = '<!-- triage:end -->';
+export const MEMORY_FILES = {
+    claude: 'CLAUDE.md',
+    gemini: 'GEMINI.md',
+    codex: 'AGENTS.md',
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Write triage findings to AI model memory files.
+ *
+ * Replaces any existing triage section (between markers) or appends
+ * a new one. This keeps memory current — old findings are replaced by
+ * the latest run, not accumulated forever.
+ */
+export async function writeMemory(merged, prompt, root, models) {
+    const rootDir = root ?? process.cwd();
+    const targetModels = models ?? Object.keys(MEMORY_FILES);
+    const content = _buildMemoryContent(merged, prompt);
+    if (!content) {
+        // No findings — clear any stale triage blocks
+        return clearMemory(rootDir, targetModels);
+    }
+    const results = {};
+    for (const model of targetModels) {
+        const filename = MEMORY_FILES[model];
+        if (!filename)
+            continue;
+        const filepath = join(rootDir, filename);
+        const success = await _updateMemoryFile(filepath, content);
+        results[filename] = success;
+        if (success) {
+            console.log(`  Updated ${filename} with triage findings`);
+        }
+    }
+    return results;
+}
+/**
+ * Remove triage sections from AI model memory files.
+ */
+export async function clearMemory(root, models) {
+    const rootDir = root ?? process.cwd();
+    const targetModels = models ?? Object.keys(MEMORY_FILES);
+    const results = {};
+    for (const model of targetModels) {
+        const filename = MEMORY_FILES[model];
+        if (!filename)
+            continue;
+        const filepath = join(rootDir, filename);
+        if (!existsSync(filepath))
+            continue;
+        try {
+            const existing = await readFile(filepath, 'utf-8');
+            if (!existing.includes(MEMORY_START))
+                continue;
+            if (!existing.includes(MEMORY_END)) {
+                console.log(`  Warning: ${filename} has start marker but no end marker — skipping`);
+                continue;
+            }
+            // Remove the triage section
+            const before = existing.slice(0, existing.indexOf(MEMORY_START)).trimEnd();
+            const afterIdx = existing.indexOf(MEMORY_END) + MEMORY_END.length;
+            const after = existing.slice(afterIdx).replace(/^\n+/, '');
+            let newContent = before;
+            if (after) {
+                newContent += '\n\n' + after;
+            }
+            newContent = newContent.trimEnd() + '\n';
+            await writeFile(filepath, newContent, 'utf-8');
+            results[filename] = true;
+            console.log(`  Cleared triage section from ${filename}`);
+        }
+        catch (e) {
+            console.log(`  Failed to clear ${filename}: ${e}`);
+            results[filename] = false;
+        }
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/** Build the memory content block from merged results. */
+export function _buildMemoryContent(merged, prompt) {
+    const total = merged.blockers.length +
+        merged.high.length +
+        merged.medium.length +
+        merged.low.length;
+    if (total === 0)
+        return '';
+    const now = new Date();
+    const timestamp = now.getFullYear() +
+        '-' +
+        String(now.getMonth() + 1).padStart(2, '0') +
+        '-' +
+        String(now.getDate()).padStart(2, '0') +
+        ' ' +
+        String(now.getHours()).padStart(2, '0') +
+        ':' +
+        String(now.getMinutes()).padStart(2, '0');
+    const lines = [];
+    lines.push(MEMORY_START);
+    lines.push('');
+    lines.push('## Triage Findings');
+    lines.push('');
+    lines.push(`*Last run: ${timestamp} — ${total} issues found, ${merged.consensus.length} consensus*`);
+    lines.push('');
+    if (prompt) {
+        lines.push(`> **Scope:** ${prompt}`);
+        lines.push('');
+    }
+    // Blockers — full detail
+    if (merged.blockers.length > 0) {
+        lines.push('### Blockers (must fix)');
+        lines.push('');
+        for (const cluster of merged.blockers) {
+            lines.push(..._formatCluster(cluster));
+        }
+        lines.push('');
+    }
+    // High priority — full detail
+    if (merged.high.length > 0) {
+        lines.push('### High Priority');
+        lines.push('');
+        for (const cluster of merged.high) {
+            lines.push(..._formatCluster(cluster));
+        }
+        lines.push('');
+    }
+    // Medium — summary only to keep memory concise
+    if (merged.medium.length > 0) {
+        lines.push('### Medium Priority');
+        lines.push('');
+        for (const cluster of merged.medium) {
+            const f = clusterRepresentative(cluster);
+            const consensusTag = isConsensus(cluster) ? ' **(consensus)**' : '';
+            lines.push(`- [${f.severity}] ${f.title} — \`${f.location.path}:${f.location.start_line}\`${consensusTag}`);
+        }
+        lines.push('');
+    }
+    // Low — just a count
+    if (merged.low.length > 0) {
+        lines.push(`*Plus ${merged.low.length} low-priority items (S3).*`);
+        lines.push('');
+    }
+    // Patterns to watch from consensus
+    if (merged.consensus.length > 0) {
+        lines.push('### Patterns to Watch');
+        lines.push('');
+        lines.push('These issues were flagged by multiple models — avoid introducing similar patterns:');
+        lines.push('');
+        for (const cluster of merged.consensus) {
+            const f = clusterRepresentative(cluster);
+            lines.push(`- **${f.title}**: ${f.recommendation}`);
+        }
+        lines.push('');
+    }
+    lines.push(MEMORY_END);
+    return lines.join('\n');
+}
+/** Format a finding cluster for memory output. */
+export function _formatCluster(cluster) {
+    const lines = [];
+    const f = clusterRepresentative(cluster);
+    const consensusTag = isConsensus(cluster) ? ' **(consensus)**' : '';
+    const models = [...cluster.models].sort().join(', ');
+    lines.push(`- **[${f.severity}] ${f.title}**${consensusTag}`);
+    lines.push(`  - Location: \`${f.location.path}:${f.location.start_line}-${f.location.end_line}\``);
+    lines.push(`  - Models: ${models}`);
+    if (f.recommendation) {
+        let rec = f.recommendation.slice(0, 200);
+        if (f.recommendation.length > 200)
+            rec += '...';
+        lines.push(`  - Fix: ${rec}`);
+    }
+    return lines;
+}
+/**
+ * Update a memory file with triage content.
+ *
+ * - If the file has an existing triage section, replace it.
+ * - If the file exists without a triage section, append.
+ * - If the file does not exist, create it with a minimal header.
+ */
+export async function _updateMemoryFile(filepath, content) {
+    try {
+        if (existsSync(filepath)) {
+            const existing = await readFile(filepath, 'utf-8');
+            let newContent;
+            if (existing.includes(MEMORY_START) && existing.includes(MEMORY_END)) {
+                // Replace existing triage section
+                const before = existing.slice(0, existing.indexOf(MEMORY_START)).trimEnd();
+                const afterIdx = existing.indexOf(MEMORY_END) + MEMORY_END.length;
+                const after = existing.slice(afterIdx).replace(/^\n+/, '');
+                newContent = before + '\n\n' + content;
+                if (after) {
+                    newContent += '\n\n' + after;
+                }
+                newContent = newContent.trimEnd() + '\n';
+            }
+            else {
+                // Append triage section
+                newContent = existing.trimEnd() + '\n\n' + content + '\n';
+            }
+            await writeFile(filepath, newContent, 'utf-8');
+        }
+        else {
+            // Create new file with minimal header
+            const filename = filepath.split('/').pop()?.replace('.md', '') ?? 'Memory';
+            const newContent = `# ${filename}\n\n${content}\n`;
+            await writeFile(filepath, newContent, 'utf-8');
+        }
+        return true;
+    }
+    catch (e) {
+        const filename = filepath.split('/').pop() ?? filepath;
+        console.log(`  Failed to write ${filename}: ${e}`);
+        return false;
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/merge.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Merge and deduplicate findings from multiple models.
+ *
+ * Handles:
+ * - Clustering similar findings
+ * - Identifying consensus (2+ models agree)
+ * - Detecting conflicts/disagreements
+ * - Aggregating patches
+ */
+import { type Finding, type Patch, type ModelResult, type FindingCluster, type Conflict, type MergedResult } from './types.js';
+export declare class MergeEngine {
+    private similarityThreshold;
+    constructor(similarityThreshold?: number);
+    /**
+     * Merge results from multiple models.
+     */
+    merge(results: ModelResult[]): MergedResult;
+    /** Cluster similar findings together using greedy linear clustering. */
+    _clusterFindings(findings: Finding[]): FindingCluster[];
+    /** Check if a finding should be added to a cluster. */
+    _shouldCluster(finding: Finding, cluster: FindingCluster): boolean;
+    /** Detect disagreements between models (severity disagreements >= 2 levels). */
+    _detectConflicts(clusters: FindingCluster[]): Conflict[];
+    /** Aggregate unique patches from all clusters, prioritizing consensus. */
+    _aggregatePatches(clusters: FindingCluster[]): Patch[];
+}
+/**
+ * Convert a MergedResult to a plain JSON-serializable object.
+ * Sets are converted to arrays.
+ */
+export declare function mergedResultToDict(merged: MergedResult): Record<string, unknown>;
+//# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,YAAY,EAMlB,MAAM,YAAY,CAAC;AAMpB,qBAAa,WAAW;IACtB,OAAO,CAAC,mBAAmB,CAAS;gBAExB,mBAAmB,SAAM;IAIrC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,YAAY;IA0E3C,wEAAwE;IACxE,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE;IA2BvD,uDAAuD;IACvD,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO;IASlE,gFAAgF;IAChF,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,QAAQ,EAAE;IAyBxD,0EAA0E;IAC1E,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,KAAK,EAAE;CAmBvD;AA4CD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgDhF"}

package/dist/merge.js

@@ -0,0 +1,251 @@
+/**
+ * Merge and deduplicate findings from multiple models.
+ *
+ * Handles:
+ * - Clustering similar findings
+ * - Identifying consensus (2+ models agree)
+ * - Detecting conflicts/disagreements
+ * - Aggregating patches
+ */
+import { findingsMatch, clusterSeverity, clusterRepresentative, clusterPatches, isConsensus, } from './types.js';
+// ---------------------------------------------------------------------------
+// MergeEngine
+// ---------------------------------------------------------------------------
+export class MergeEngine {
+    similarityThreshold;
+    constructor(similarityThreshold = 0.6) {
+        this.similarityThreshold = similarityThreshold;
+    }
+    /**
+     * Merge results from multiple models.
+     */
+    merge(results) {
+        const merged = {
+            blockers: [],
+            high: [],
+            medium: [],
+            low: [],
+            consensus: [],
+            unique_by_model: {},
+            conflicts: [],
+            patches: [],
+            questions: [],
+            summaries: {},
+        };
+        // Collect all findings
+        const allFindings = [];
+        for (const result of results) {
+            merged.summaries[result.model] = result.summary;
+            merged.questions.push(...result.questions);
+            for (const finding of result.findings) {
+                // Ensure model is set on each finding
+                const f = { ...finding, model: result.model };
+                allFindings.push(f);
+            }
+        }
+        // Cluster similar findings
+        const clusters = this._clusterFindings(allFindings);
+        // Categorize by severity and consensus
+        for (const cluster of clusters) {
+            const severity = clusterSeverity(cluster);
+            if (severity === 'S0') {
+                merged.blockers.push(cluster);
+            }
+            else if (severity === 'S1') {
+                merged.high.push(cluster);
+            }
+            else if (severity === 'S2') {
+                merged.medium.push(cluster);
+            }
+            else {
+                merged.low.push(cluster);
+            }
+            if (isConsensus(cluster)) {
+                merged.consensus.push(cluster);
+            }
+            else {
+                // Single model finding
+                const model = [...cluster.models][0];
+                if (!merged.unique_by_model[model]) {
+                    merged.unique_by_model[model] = [];
+                }
+                merged.unique_by_model[model].push(...cluster.findings);
+            }
+        }
+        // Detect conflicts
+        merged.conflicts = this._detectConflicts(clusters);
+        // Aggregate patches
+        merged.patches = this._aggregatePatches(clusters);
+        // Sort by model count (descending) within each category
+        const byModelCount = (a, b) => b.models.size - a.models.size;
+        merged.blockers.sort(byModelCount);
+        merged.high.sort(byModelCount);
+        merged.medium.sort(byModelCount);
+        merged.low.sort(byModelCount);
+        return merged;
+    }
+    /** Cluster similar findings together using greedy linear clustering. */
+    _clusterFindings(findings) {
+        const clusters = [];
+        for (const finding of findings) {
+            let added = false;
+            for (const cluster of clusters) {
+                if (this._shouldCluster(finding, cluster)) {
+                    cluster.findings.push(finding);
+                    cluster.models.add(finding.model);
+                    added = true;
+                    break;
+                }
+            }
+            if (!added) {
+                const cluster = {
+                    findings: [finding],
+                    models: new Set([finding.model]),
+                };
+                clusters.push(cluster);
+            }
+        }
+        return clusters;
+    }
+    /** Check if a finding should be added to a cluster. */
+    _shouldCluster(finding, cluster) {
+        for (const existing of cluster.findings) {
+            if (findingsMatch(finding, existing, this.similarityThreshold)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /** Detect disagreements between models (severity disagreements >= 2 levels). */
+    _detectConflicts(clusters) {
+        const conflicts = [];
+        const sevValues = { S0: 0, S1: 1, S2: 2, S3: 3 };
+        for (const cluster of clusters) {
+            if (cluster.findings.length < 2)
+                continue;
+            const severities = new Set(cluster.findings.map((f) => f.severity));
+            if (severities.size > 1) {
+                const sevNums = [...severities].map((s) => sevValues[s] ?? 3);
+                if (Math.max(...sevNums) - Math.min(...sevNums) >= 2) {
+                    const rep = clusterRepresentative(cluster);
+                    conflicts.push({
+                        title: rep.title,
+                        findings: cluster.findings,
+                        conflict_type: 'severity',
+                        details: `Models disagree on severity: ${JSON.stringify([...severities])}`,
+                    });
+                }
+            }
+        }
+        return conflicts;
+    }
+    /** Aggregate unique patches from all clusters, prioritizing consensus. */
+    _aggregatePatches(clusters) {
+        const patches = [];
+        const seen = new Set();
+        // Sort clusters by model count descending (consensus first)
+        const sorted = [...clusters].sort((a, b) => b.models.size - a.models.size);
+        for (const cluster of sorted) {
+            for (const patch of clusterPatches(cluster)) {
+                const key = `${patch.path}|${patch.diff.slice(0, 100)}`;
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    patches.push(patch);
+                }
+            }
+        }
+        return patches;
+    }
+}
+// ---------------------------------------------------------------------------
+// Serialisation helper
+// ---------------------------------------------------------------------------
+/** Serialize a FindingCluster to a plain JSON-safe object. */
+function clusterToDict(cluster) {
+    const rep = clusterRepresentative(cluster);
+    return {
+        is_consensus: isConsensus(cluster),
+        models: [...cluster.models],
+        severity: clusterSeverity(cluster),
+        representative: {
+            title: rep.title,
+            severity: rep.severity,
+            confidence: rep.confidence,
+            category: rep.category,
+            location: rep.location,
+            evidence: rep.evidence,
+            recommendation: rep.recommendation,
+            model: rep.model,
+            patch: rep.patch ?? null,
+        },
+        all_findings: cluster.findings.map((f) => ({
+            title: f.title,
+            severity: f.severity,
+            confidence: f.confidence,
+            category: f.category,
+            location: f.location,
+            evidence: f.evidence,
+            recommendation: f.recommendation,
+            model: f.model,
+            patch: f.patch ?? null,
+        })),
+        patches: clusterPatches(cluster).map((p) => ({
+            path: p.path,
+            diff: p.diff,
+            description: p.description,
+            model: p.model,
+        })),
+    };
+}
+/**
+ * Convert a MergedResult to a plain JSON-serializable object.
+ * Sets are converted to arrays.
+ */
+export function mergedResultToDict(merged) {
+    return {
+        blockers: merged.blockers.map(clusterToDict),
+        high: merged.high.map(clusterToDict),
+        medium: merged.medium.map(clusterToDict),
+        low: merged.low.map(clusterToDict),
+        consensus: merged.consensus.map(clusterToDict),
+        unique_by_model: Object.fromEntries(Object.entries(merged.unique_by_model).map(([model, findings]) => [
+            model,
+            findings.map((f) => ({
+                title: f.title,
+                severity: f.severity,
+                confidence: f.confidence,
+                category: f.category,
+                location: f.location,
+                evidence: f.evidence,
+                recommendation: f.recommendation,
+                model: f.model,
+                patch: f.patch ?? null,
+            })),
+        ])),
+        conflicts: merged.conflicts.map((c) => ({
+            title: c.title,
+            type: c.conflict_type,
+            details: c.details,
+            findings: c.findings.map((f) => ({
+                title: f.title,
+                severity: f.severity,
+                confidence: f.confidence,
+                category: f.category,
+                location: f.location,
+                evidence: f.evidence,
+                recommendation: f.recommendation,
+                model: f.model,
+                patch: f.patch ?? null,
+            })),
+        })),
+        patches: merged.patches.map((p) => ({
+            path: p.path,
+            diff: p.diff,
+            description: p.description,
+            model: p.model,
+        })),
+        questions: merged.questions,
+        summaries: merged.summaries,
+    };
+}
+//# sourceMappingURL=merge.js.map

package/dist/merge.js.map

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

package/dist/models/base.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Base model interface and subprocess runner.
+ *
+ * Ported from triage_cli/models/base.py
+ */
+import { type ModelResult, type ScanContext } from '../types.js';
+export declare abstract class BaseModel {
+    name: string;
+    cmdEnvVar: string;
+    defaultCmd: string[];
+    constructor();
+    /** Get the command to use for this model (env override > default). */
+    get command(): string[];
+    /**
+     * Run analysis using this model.
+     *
+     * Builds prompt, saves it for debugging, calls _runModel, parses the
+     * result, saves parsed JSON to resultsDir, returns ModelResult.
+     */
+    analyze(prompt: string, context: ScanContext, resultsDir: string, timeout?: number, nice?: number): Promise<ModelResult>;
+    /** Build the full prompt string from the template and scan context. */
+    buildPrompt(prompt: string, context: ScanContext): string;
+    /**
+     * Parse raw model output into a ModelResult.
+     *
+     * Tries in order:
+     *   1. JSON inside ```json ... ``` blocks
+     *   2. JSON inside ``` ... ``` blocks
+     *   3. Raw JSON parse of entire output
+     *   4. First `{...}` match in the string
+     */
+    parseOutput(output: string): ModelResult;
+    /** Serialize a ModelResult to a plain object for JSON saving. */
+    private _resultToDict;
+    /** Run the model and return raw string output. Subclasses implement this. */
+    abstract _runModel(prompt: string, timeout: number, nice: number): Promise<string>;
+}
+export declare abstract class SubprocessModel extends BaseModel {
+    /**
+     * Run model via subprocess.
+     *
+     * - Writes prompt to a temp file (for debugging / codex adapter)
+     * - Builds command via _buildCommand()
+     * - Applies env overrides (undefined value = delete key)
+     * - Spawns with detached:true so we can kill the whole process group
+     * - Passes prompt via stdin
+     * - Detects auth/quota errors in stderr
+     * - Kills process group on error or cancellation
+     * - Cleans up temp file in finally
+     */
+    _runModel(prompt: string, timeout: number, nice: number): Promise<string>;
+    /**
+     * Safely kill the process group that was created with detached:true.
+     * Because detached:true guarantees PGID == proc.pid, we negate the PID.
+     * Never targets PID <= 1 (init / our own group).
+     */
+    private _killProcessGroup;
+    /**
+     * Build the command and env overrides for this model.
+     *
+     * @param promptFile  Path to temp file containing the prompt text.
+     *                    Most adapters ignore this (they use stdin).
+     *                    The Codex adapter reads it and passes the text as an arg.
+     * @returns           `cmd` — argument list (no shell, no bash -c);
+     *                    `env` — overrides (undefined value = delete from env)
+     */
+    abstract _buildCommand(promptFile: string): {
+        cmd: string[];
+        env: Record<string, string | undefined>;
+    };
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/models/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/models/base.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,WAAW,EAGjB,MAAM,aAAa,CAAC;AA6CrB,8BAAsB,SAAS;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;;IAQrB,sEAAsE;IACtE,IAAI,OAAO,IAAI,MAAM,EAAE,CAItB;IAED;;;;;OAKG;IACG,OAAO,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,SAAM,EACb,IAAI,SAAK,GACR,OAAO,CAAC,WAAW,CAAC;IAsCvB,uEAAuE;IACvE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM;IAqDzD;;;;;;;;OAQG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW;IAwCxC,iEAAiE;IACjE,OAAO,CAAC,aAAa;IAWrB,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CACnF;AAMD,8BAAsB,eAAgB,SAAQ,SAAS;IACrD;;;;;;;;;;;OAWG;IACY,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2GxF;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAczB;;;;;;;;OAQG;IACH,QAAQ,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG;QAC1C,GAAG,EAAE,MAAM,EAAE,CAAC;QACd,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;KACzC;CACF"}