agent-nuvira 1.14.0

package/dist/team/review.js

@@ -0,0 +1,293 @@
+/**
+ * Team Review — Review workflow (agent PR → review → merge).
+ *
+ * The review workflow enables team members to review agent-generated changes
+ * before applying them. It mimics a simplified PR workflow:
+ *
+ * 1. PR Creation: Agent proposes changes → saved as a "review bundle"
+ * 2. Review: Team member reviews the proposed changes
+ * 3. Merge: Approved changes are applied to the working directory
+ *
+ * Review bundles are stored in ~/.buff/team/reviews/ and can be shared
+ * via git (if team memory is set up) or locally.
+ *
+ * Each bundle contains:
+ *   - Metadata (author, timestamp, goal, provider)
+ *   - Proposed file changes (path, original, new content)
+ *   - Review comments (status, feedback)
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { logger } from '../utils/logger.js';
+// ─── Constants ──────────────────────────────────────────────────────────────
+const REVIEWS_DIR = join(homedir(), '.buff', 'team', 'reviews');
+const REVIEWS_INDEX_PATH = join(REVIEWS_DIR, 'index.json');
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function ensureDir() {
+    if (!existsSync(REVIEWS_DIR)) {
+        mkdirSync(REVIEWS_DIR, { recursive: true });
+    }
+}
+function generateReviewId() {
+    return `review-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+}
+function readIndex() {
+    try {
+        ensureDir();
+        if (!existsSync(REVIEWS_INDEX_PATH)) {
+            return { reviews: [] };
+        }
+        return JSON.parse(readFileSync(REVIEWS_INDEX_PATH, 'utf-8'));
+    }
+    catch {
+        return { reviews: [] };
+    }
+}
+function writeIndex(index) {
+    ensureDir();
+    writeFileSync(REVIEWS_INDEX_PATH, JSON.stringify(index, null, 2), 'utf-8');
+}
+function bundlePath(id) {
+    return join(REVIEWS_DIR, `${id}.json`);
+}
+// ─── Review Operations ──────────────────────────────────────────────────────
+/**
+ * Create a new review bundle from proposed file changes.
+ * Typically called after an agent execution to capture the proposed changes
+ * for review before applying them.
+ *
+ * @param title — Short title for the review
+ * @param goal — The original goal
+ * @param changes — Proposed file changes
+ * @param options — Optional metadata
+ * @returns The created ReviewBundle
+ */
+export function createReview(title, goal, changes, options) {
+    const id = generateReviewId();
+    const bundle = {
+        id,
+        title,
+        goal,
+        author: options?.author || process.env.USER || 'unknown',
+        status: 'pending',
+        createdAt: Date.now(),
+        provider: options?.provider || 'unknown',
+        model: options?.model || 'unknown',
+        changes,
+        comments: [],
+        summary: options?.summary,
+        tags: options?.tags || [],
+    };
+    // Save to disk
+    ensureDir();
+    writeFileSync(bundlePath(id), JSON.stringify(bundle, null, 2), 'utf-8');
+    // Update index
+    const index = readIndex();
+    index.reviews.unshift({
+        id,
+        title,
+        status: 'pending',
+        createdAt: bundle.createdAt,
+        author: bundle.author,
+    });
+    // Keep only last 100 entries in the index
+    if (index.reviews.length > 100) {
+        index.reviews = index.reviews.slice(0, 100);
+    }
+    writeIndex(index);
+    logger.success(`Created review bundle: ${id} — "${title}"`);
+    return bundle;
+}
+/**
+ * Load a review bundle by ID.
+ */
+export function getReview(id) {
+    const path = bundlePath(id);
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List all review bundles, sorted by recency.
+ */
+export function listReviews(limit = 20) {
+    const index = readIndex();
+    const reviews = [];
+    for (const entry of index.reviews.slice(0, limit)) {
+        const bundle = getReview(entry.id);
+        if (bundle)
+            reviews.push(bundle);
+    }
+    return reviews;
+}
+/**
+ * Add a review comment to a bundle.
+ */
+export function addReviewComment(id, reviewer, status, comment) {
+    const bundle = getReview(id);
+    if (!bundle) {
+        logger.error(`Review not found: ${id}`);
+        return null;
+    }
+    bundle.comments.push({
+        reviewer,
+        status,
+        comment,
+        timestamp: Date.now(),
+    });
+    // Update status based on comment
+    if (status === 'approve') {
+        bundle.status = 'approved';
+    }
+    else if (status === 'request-changes') {
+        bundle.status = 'changes-requested';
+    }
+    // Save
+    writeFileSync(bundlePath(id), JSON.stringify(bundle, null, 2), 'utf-8');
+    // Update index
+    const index = readIndex();
+    const entry = index.reviews.find((r) => r.id === id);
+    if (entry)
+        entry.status = bundle.status;
+    writeIndex(index);
+    return bundle;
+}
+/**
+ * Merge a review bundle — apply approved changes to the working directory.
+ *
+ * @param id — Review bundle ID
+ * @param workingDir — Working directory to apply changes to (default: process.cwd())
+ * @returns The number of files changed
+ */
+export function mergeReview(id, workingDir) {
+    const bundle = getReview(id);
+    if (!bundle) {
+        logger.error(`Review not found: ${id}`);
+        return 0;
+    }
+    if (bundle.status === 'rejected') {
+        logger.error('Cannot merge a rejected review.');
+        return 0;
+    }
+    if (bundle.status === 'pending') {
+        logger.warn('Review is still pending. Approve first with `buff team review approve <id>`.');
+        return 0;
+    }
+    const dir = resolve(workingDir || process.cwd());
+    let count = 0;
+    for (const change of bundle.changes) {
+        const fullPath = resolve(dir, change.path);
+        switch (change.status) {
+            case 'created':
+            case 'modified':
+                if (change.newContent !== undefined) {
+                    const targetDir = join(fullPath, '..');
+                    if (!existsSync(targetDir)) {
+                        mkdirSync(targetDir, { recursive: true });
+                    }
+                    writeFileSync(fullPath, change.newContent, 'utf-8');
+                    count++;
+                }
+                break;
+            case 'deleted':
+                if (existsSync(fullPath)) {
+                    try {
+                        const { unlinkSync } = require('node:fs');
+                        unlinkSync(fullPath);
+                        count++;
+                    }
+                    catch {
+                        logger.warn(`Could not delete ${change.path}`);
+                    }
+                }
+                break;
+        }
+    }
+    // Update status
+    bundle.status = 'merged';
+    writeFileSync(bundlePath(id), JSON.stringify(bundle, null, 2), 'utf-8');
+    const index = readIndex();
+    const entry = index.reviews.find((r) => r.id === id);
+    if (entry)
+        entry.status = 'merged';
+    writeIndex(index);
+    logger.success(`Merged review ${id}: ${count} file(s) changed.`);
+    return count;
+}
+/**
+ * Reject a review bundle.
+ */
+export function rejectReview(id, reason) {
+    const bundle = getReview(id);
+    if (!bundle) {
+        logger.error(`Review not found: ${id}`);
+        return false;
+    }
+    bundle.status = 'rejected';
+    if (reason) {
+        bundle.comments.push({
+            reviewer: bundle.author,
+            status: 'request-changes',
+            comment: reason,
+            timestamp: Date.now(),
+        });
+    }
+    writeFileSync(bundlePath(id), JSON.stringify(bundle, null, 2), 'utf-8');
+    const index = readIndex();
+    const entry = index.reviews.find((r) => r.id === id);
+    if (entry)
+        entry.status = 'rejected';
+    writeIndex(index);
+    logger.info(`Review ${id} rejected.${reason ? ` Reason: ${reason}` : ''}`);
+    return true;
+}
+/**
+ * Create a review bundle from the current orchestrator result.
+ * This captures all file changes proposed by the agents into a review.
+ *
+ * @param goal — The original goal
+ * @param fileChanges — The proposed file changes from the orchestrator
+ * @param summary — Execution summary
+ * @returns The created ReviewBundle
+ */
+export function createReviewFromResult(goal, fileChanges, summary, options) {
+    // Read original content for modified files
+    const changes = fileChanges.map((fc) => {
+        const change = {
+            path: fc.path,
+            status: fc.status,
+        };
+        if (fc.originalContent)
+            change.originalContent = fc.originalContent;
+        if (fc.newContent)
+            change.newContent = fc.newContent;
+        // Try to read original content if not provided
+        if (!change.originalContent && change.status === 'modified') {
+            try {
+                const fullPath = resolve(process.cwd(), fc.path);
+                if (existsSync(fullPath)) {
+                    change.originalContent = readFileSync(fullPath, 'utf-8');
+                }
+            }
+            catch { /* ignore */ }
+        }
+        return change;
+    });
+    const title = summary
+        ? summary.split('\n')[0].slice(0, 80)
+        : `Changes for: ${goal.slice(0, 60)}`;
+    return createReview(title, goal, changes, {
+        provider: options?.provider,
+        model: options?.model,
+        author: options?.author,
+        summary,
+        tags: ['agent-generated'],
+    });
+}
+//# sourceMappingURL=review.js.map

package/dist/team/review.js.map

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

package/dist/utils/env.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Load environment variables from .env files
+ * Checks: project .env, home dir .env, and process.env
+ *
+ * .env file features:
+ * - Lines starting with # are comments
+ * - Inline comments are supported (KEY=value # comment)
+ * - export prefix is stripped (export KEY=value)
+ * - Variable expansion: $VAR, ${VAR}, ${VAR:-default}
+ *   - References already-parsed vars in the same file first
+ *   - Falls back to process.env
+ *   - ${VAR:-default} uses 'default' if VAR is not set
+ * - Windows CRLF line endings are handled
+ * - Quoted values (single and double) are unquoted
+ * - Double-quoted values support variable expansion
+ * - Single-quoted values are literal (no expansion)
+ */
+export declare function loadEnv(): Record<string, string | undefined>;
+//# sourceMappingURL=env.d.ts.map

package/dist/utils/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAiB5D"}

package/dist/utils/env.js

@@ -0,0 +1,250 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+/**
+ * Load environment variables from .env files
+ * Checks: project .env, home dir .env, and process.env
+ *
+ * .env file features:
+ * - Lines starting with # are comments
+ * - Inline comments are supported (KEY=value # comment)
+ * - export prefix is stripped (export KEY=value)
+ * - Variable expansion: $VAR, ${VAR}, ${VAR:-default}
+ *   - References already-parsed vars in the same file first
+ *   - Falls back to process.env
+ *   - ${VAR:-default} uses 'default' if VAR is not set
+ * - Windows CRLF line endings are handled
+ * - Quoted values (single and double) are unquoted
+ * - Double-quoted values support variable expansion
+ * - Single-quoted values are literal (no expansion)
+ */
+export function loadEnv() {
+    const env = { ...process.env };
+    // Try loading from .env in project root
+    const projectEnv = findEnvFile(process.cwd());
+    if (projectEnv) {
+        Object.assign(env, projectEnv);
+    }
+    // Try loading from ~/.buff/.env
+    const homeEnvPath = join(homedir(), '.buff', '.env');
+    if (existsSync(homeEnvPath)) {
+        const homeEnv = parseEnvFile(readFileSync(homeEnvPath, 'utf-8'));
+        Object.assign(env, homeEnv);
+    }
+    return env;
+}
+function findEnvFile(dir) {
+    const envPath = join(dir, '.env');
+    if (existsSync(envPath)) {
+        return parseEnvFile(readFileSync(envPath, 'utf-8'));
+    }
+    return null;
+}
+/**
+ * Parse a .env file content into key-value pairs.
+ *
+ * Supports:
+ * - Comments: # full line  and  KEY=val # inline comment
+ * - export prefix: export KEY=value
+ * - Variable expansion: $VAR, ${VAR}, ${VAR:-default}
+ * - Quoted values: KEY="value"  KEY='value'
+ * - CRLF line endings
+ * - Empty lines
+ */
+function parseEnvFile(content) {
+    const env = {};
+    const lines = splitIntoLines(content);
+    for (const rawLine of lines) {
+        // Skip empty lines and full-line comments
+        if (rawLine.length === 0)
+            continue;
+        // Strip 'export ' prefix if present
+        const trimmed = rawLine.startsWith('export ')
+            ? rawLine.slice(7).trimStart()
+            : rawLine;
+        // Check if the line is just a comment after stripping export
+        if (trimmed.startsWith('#') || trimmed.length === 0)
+            continue;
+        // Find the first '=' that separates key from value
+        const eqIndex = trimmed.indexOf('=');
+        if (eqIndex === -1)
+            continue;
+        const key = trimmed.slice(0, eqIndex).trim();
+        if (!key)
+            continue;
+        const rawValue = trimmed.slice(eqIndex + 1).trim();
+        // Parse the value, handling quotes and inline comments
+        const value = parseValue(rawValue, env);
+        env[key] = value;
+    }
+    return env;
+}
+/**
+ * Split content into lines, handling CRLF and trailing newlines.
+ */
+function splitIntoLines(content) {
+    // Normalize CRLF to LF, then split
+    const normalized = content.replace(/\r\n/g, '\n');
+    const lines = normalized.split('\n');
+    // Trim trailing empty line from final newline
+    if (lines.length > 0 && lines[lines.length - 1] === '') {
+        return lines.slice(0, -1);
+    }
+    return lines;
+}
+/**
+ * Parse a value string from a .env file line.
+ *
+ * Handles:
+ * - Unquoted values: strip inline comments, expand vars
+ * - Double-quoted values: unquote, expand vars, preserve inline comments
+ * - Single-quoted values: unquote, literal (no expansion, no comment stripping)
+ */
+function parseValue(rawValue, env) {
+    if (rawValue.length === 0)
+        return '';
+    // Single-quoted: literal value, no expansion, no inline comments
+    if (rawValue.startsWith("'")) {
+        const closingQuote = rawValue.indexOf("'", 1);
+        if (closingQuote !== -1) {
+            return rawValue.slice(1, closingQuote);
+        }
+        // No closing quote — treat rest as literal
+        return rawValue.slice(1);
+    }
+    // Double-quoted or unquoted: handle inline comments and variable expansion
+    // First, strip inline comments from unquoted values
+    // (Double-quoted values keep everything inside the quotes, including #)
+    let value;
+    if (rawValue.startsWith('"')) {
+        // Find closing double quote
+        const closingQuote = findClosingQuote(rawValue, 0);
+        if (closingQuote !== -1) {
+            value = rawValue.slice(1, closingQuote);
+            // Rest after the closing quote is ignored (could be an inline comment)
+        }
+        else {
+            // No closing quote — treat entire rest as value
+            value = rawValue.slice(1);
+        }
+    }
+    else {
+        // Unquoted: strip inline comments
+        value = stripInlineComment(rawValue);
+    }
+    // Expand variables
+    value = expandVariables(value, env);
+    return value;
+}
+/**
+ * Find the closing double quote starting from a given position.
+ * Handles escaped quotes inside the string.
+ */
+function findClosingQuote(s, start) {
+    let i = start + 1;
+    while (i < s.length) {
+        if (s[i] === '\\') {
+            i += 2; // Skip escaped character
+            continue;
+        }
+        if (s[i] === '"') {
+            return i;
+        }
+        i++;
+    }
+    return -1;
+}
+/**
+ * Strip inline comments from an unquoted value.
+ *
+ * A '#' starts a comment UNLESS it's inside:
+ * - A quoted string (single or double)
+ * - It's escaped (\#)
+ */
+function stripInlineComment(value) {
+    let result = '';
+    let i = 0;
+    while (i < value.length) {
+        // Escaped character — keep literally
+        if (value[i] === '\\' && i + 1 < value.length) {
+            result += value[i + 1];
+            i += 2;
+            continue;
+        }
+        // Start of a quote — find matching closing quote and include the whole thing
+        if (value[i] === "'") {
+            const close = value.indexOf("'", i + 1);
+            if (close !== -1) {
+                result += value.slice(i, close + 1);
+                i = close + 1;
+                continue;
+            }
+            // No closing quote — include rest
+            result += value.slice(i);
+            break;
+        }
+        if (value[i] === '"') {
+            const close = findClosingQuote(value, i);
+            if (close !== -1) {
+                result += value.slice(i, close + 1);
+                i = close + 1;
+                continue;
+            }
+            // No closing quote — include rest
+            result += value.slice(i);
+            break;
+        }
+        // Comment start — stop here
+        if (value[i] === '#') {
+            break;
+        }
+        result += value[i];
+        i++;
+    }
+    return result.trim();
+}
+/**
+ * Expand variable references in a value string.
+ *
+ * Supports:
+ * - $VAR — simple variable reference (ends at non-identifier char)
+ * - ${VAR} — explicit variable reference
+ * - ${VAR:-default} — with default value if VAR is unset or empty
+ *
+ * Variables are resolved from:
+ * 1. The current file's already-parsed env object
+ * 2. process.env as fallback
+ */
+function expandVariables(value, env) {
+    if (!value.includes('$'))
+        return value;
+    return value.replace(/\$(?:\{([^}]+)\}|([a-zA-Z_][a-zA-Z0-9_]*))/g, (match, bracedVar, simpleVar) => {
+        if (bracedVar !== undefined) {
+            // ${VAR} or ${VAR:-default}
+            const colonDefaultIndex = bracedVar.indexOf(':-');
+            if (colonDefaultIndex !== -1) {
+                const varName = bracedVar.slice(0, colonDefaultIndex);
+                const defaultValue = bracedVar.slice(colonDefaultIndex + 2);
+                // Bash semantics: use default if var is unset OR empty
+                const resolved = resolveVar(varName, env);
+                if (resolved !== null && resolved !== '')
+                    return resolved;
+                return defaultValue;
+            }
+            return resolveVar(bracedVar, env) ?? '';
+        }
+        // $VAR
+        return resolveVar(simpleVar, env) ?? '';
+    });
+}
+/**
+ * Resolve a single variable name from the env object or process.env.
+ */
+function resolveVar(varName, env) {
+    if (varName in env)
+        return env[varName];
+    if (varName in process.env)
+        return process.env[varName];
+    return null;
+}
+//# sourceMappingURL=env.js.map

package/dist/utils/env.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,11 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export declare function setLogLevel(level: LogLevel): void;
+export declare const logger: {
+    debug: (message: string, ...args: unknown[]) => void;
+    info: (message: string, ...args: unknown[]) => void;
+    success: (message: string, ...args: unknown[]) => void;
+    warn: (message: string, ...args: unknown[]) => void;
+    error: (message: string, ...args: unknown[]) => void;
+    highlight: (message: string) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAW3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAMD,eAAO,MAAM,MAAM;qBACA,MAAM,WAAW,OAAO,EAAE;oBAM3B,MAAM,WAAW,OAAO,EAAE;uBAMvB,MAAM,WAAW,OAAO,EAAE;oBAM7B,MAAM,WAAW,OAAO,EAAE;qBAMzB,MAAM,WAAW,OAAO,EAAE;yBAMtB,MAAM;CAG5B,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,45 @@
+import chalk from 'chalk';
+let currentLogLevel = 'info';
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+export function setLogLevel(level) {
+    currentLogLevel = level;
+}
+function shouldLog(level) {
+    return LOG_LEVELS[level] >= LOG_LEVELS[currentLogLevel];
+}
+export const logger = {
+    debug: (message, ...args) => {
+        if (shouldLog('debug')) {
+            console.log(chalk.gray(`[debug] ${message}`), ...args);
+        }
+    },
+    info: (message, ...args) => {
+        if (shouldLog('info')) {
+            console.log(chalk.blue(`ℹ ${message}`), ...args);
+        }
+    },
+    success: (message, ...args) => {
+        if (shouldLog('info')) {
+            console.log(chalk.green(`✔ ${message}`), ...args);
+        }
+    },
+    warn: (message, ...args) => {
+        if (shouldLog('warn')) {
+            console.log(chalk.yellow(`⚠ ${message}`), ...args);
+        }
+    },
+    error: (message, ...args) => {
+        if (shouldLog('error')) {
+            console.error(chalk.red(`✖ ${message}`), ...args);
+        }
+    },
+    highlight: (message) => {
+        console.log(chalk.cyan(message));
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,IAAI,eAAe,GAAa,MAAM,CAAC;AAEvC,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,eAAe,GAAG,KAAK,CAAC;AAC1B,CAAC;AAED,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,eAAe,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;QAC7C,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;QAC5C,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;QAC/C,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;QAC5C,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;QAC7C,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,SAAS,EAAE,CAAC,OAAe,EAAE,EAAE;QAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACnC,CAAC;CACF,CAAC"}