olympus-ai 1.0.0

package/dist/hooks/ralph-verifier/index.js

@@ -0,0 +1,223 @@
+/**
+ * The Ascent Verifier
+ *
+ * Adds oracle verification to the-ascent completion claims.
+ * When the-ascent outputs a completion promise, instead of immediately
+ * accepting it, we trigger an oracle verification phase.
+ *
+ * Flow:
+ * 1. Ascent-loop outputs <promise>TASK_COMPLETE</promise>
+ * 2. System detects this and enters verification mode
+ * 3. Oracle agent is invoked to verify the work
+ * 4. If oracle approves -> truly complete
+ * 5. If oracle finds flaws -> continue the-ascent with oracle feedback
+ */
+import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync } from 'fs';
+import { join } from 'path';
+const DEFAULT_MAX_VERIFICATION_ATTEMPTS = 3;
+/**
+ * Get verification state file path
+ */
+function getVerificationStatePath(directory) {
+    return join(directory, '.olympus', 'ascent-verification.json');
+}
+/**
+ * Read verification state
+ */
+export function readVerificationState(directory) {
+    const statePath = getVerificationStatePath(directory);
+    if (!existsSync(statePath)) {
+        return null;
+    }
+    try {
+        return JSON.parse(readFileSync(statePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write verification state
+ */
+export function writeVerificationState(directory, state) {
+    const statePath = getVerificationStatePath(directory);
+    const stateDir = join(directory, '.olympus');
+    if (!existsSync(stateDir)) {
+        try {
+            mkdirSync(stateDir, { recursive: true });
+        }
+        catch {
+            return false;
+        }
+    }
+    try {
+        writeFileSync(statePath, JSON.stringify(state, null, 2));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Clear verification state
+ */
+export function clearVerificationState(directory) {
+    const statePath = getVerificationStatePath(directory);
+    if (existsSync(statePath)) {
+        try {
+            unlinkSync(statePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Start verification process
+ */
+export function startVerification(directory, completionClaim, originalTask) {
+    const state = {
+        pending: true,
+        completion_claim: completionClaim,
+        verification_attempts: 0,
+        max_verification_attempts: DEFAULT_MAX_VERIFICATION_ATTEMPTS,
+        requested_at: new Date().toISOString(),
+        original_task: originalTask
+    };
+    writeVerificationState(directory, state);
+    return state;
+}
+/**
+ * Record oracle feedback
+ */
+export function recordOracleFeedback(directory, approved, feedback) {
+    const state = readVerificationState(directory);
+    if (!state) {
+        return null;
+    }
+    state.verification_attempts += 1;
+    state.oracle_approved = approved;
+    state.oracle_feedback = feedback;
+    if (approved) {
+        // Clear state on approval
+        clearVerificationState(directory);
+        return { ...state, pending: false };
+    }
+    // Check if max attempts reached
+    if (state.verification_attempts >= state.max_verification_attempts) {
+        clearVerificationState(directory);
+        return { ...state, pending: false };
+    }
+    // Continue verification loop
+    writeVerificationState(directory, state);
+    return state;
+}
+/**
+ * Generate oracle verification prompt
+ */
+export function getOracleVerificationPrompt(state) {
+    return `<ascent-verification>
+
+[ORACLE VERIFICATION REQUIRED - Attempt ${state.verification_attempts + 1}/${state.max_verification_attempts}]
+
+The agent claims the task is complete. Before accepting, YOU MUST verify with Oracle.
+
+**Original Task:**
+${state.original_task}
+
+**Completion Claim:**
+${state.completion_claim}
+
+${state.oracle_feedback ? `**Previous Oracle Feedback (rejected):**\n${state.oracle_feedback}\n` : ''}
+
+## MANDATORY VERIFICATION STEPS
+
+1. **Spawn Oracle Agent** for verification:
+   \`\`\`
+   Task(subagent_type="oracle", prompt="Verify this task completion claim...")
+   \`\`\`
+
+2. **Oracle must check:**
+   - Are ALL requirements from the original task met?
+   - Is the implementation complete, not partial?
+   - Are there any obvious bugs or issues?
+   - Does the code compile/run without errors?
+   - Are tests passing (if applicable)?
+
+3. **Based on Oracle's response:**
+   - If APPROVED: Output \`<oracle-approved>VERIFIED_COMPLETE</oracle-approved>\`
+   - If REJECTED: Continue working on the identified issues
+
+DO NOT output the completion promise again until Oracle approves.
+
+</ascent-verification>
+
+---
+
+`;
+}
+/**
+ * Generate continuation prompt after oracle rejection
+ */
+export function getOracleRejectionContinuationPrompt(state) {
+    return `<ascent-continuation-after-rejection>
+
+[ORACLE REJECTED - Continue Working]
+
+Oracle found issues with your completion claim. You must address them.
+
+**Oracle Feedback:**
+${state.oracle_feedback}
+
+**Original Task:**
+${state.original_task}
+
+## INSTRUCTIONS
+
+1. Address ALL issues identified by Oracle
+2. Do NOT claim completion again until issues are fixed
+3. When truly done, output the completion promise again
+4. Another Oracle verification will be triggered
+
+Continue working now.
+
+</ascent-continuation-after-rejection>
+
+---
+
+`;
+}
+/**
+ * Check if text contains oracle approval
+ */
+export function detectOracleApproval(text) {
+    return /<oracle-approved>.*?VERIFIED_COMPLETE.*?<\/oracle-approved>/is.test(text);
+}
+/**
+ * Check if text contains oracle rejection indicators
+ */
+export function detectOracleRejection(text) {
+    // Look for explicit rejection patterns
+    const rejectionPatterns = [
+        /oracle.*?(rejected|found issues|not complete|incomplete)/i,
+        /issues? (found|identified|detected)/i,
+        /not yet complete/i,
+        /missing.*?(implementation|feature|test)/i,
+        /bug.*?(found|detected|identified)/i,
+        /error.*?(found|detected|identified)/i
+    ];
+    for (const pattern of rejectionPatterns) {
+        if (pattern.test(text)) {
+            // Extract feedback (rough heuristic)
+            const feedbackMatch = text.match(/(?:oracle|feedback|issue|problem|error|bug)[:\s]+([^.]+\.)/i);
+            return {
+                rejected: true,
+                feedback: feedbackMatch ? feedbackMatch[1] : 'Oracle found issues with the implementation.'
+            };
+        }
+    }
+    return { rejected: false, feedback: '' };
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/ralph-verifier/index.js.map

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

package/dist/hooks/rules-injector/constants.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Rules Injector Constants
+ *
+ * Constants for rule file discovery and matching.
+ *
+ * Ported from oh-my-opencode's rules-injector hook.
+ */
+/** Storage directory for rules injector state */
+export declare const OLYMPUS_STORAGE_DIR: string;
+export declare const RULES_INJECTOR_STORAGE: string;
+/** Project marker files that indicate a project root */
+export declare const PROJECT_MARKERS: string[];
+/** Subdirectories to search for rules within projects */
+export declare const PROJECT_RULE_SUBDIRS: [string, string][];
+/** Single-file rules that always apply */
+export declare const PROJECT_RULE_FILES: string[];
+/** Pattern for GitHub instructions files */
+export declare const GITHUB_INSTRUCTIONS_PATTERN: RegExp;
+/** User-level rule directory */
+export declare const USER_RULE_DIR = ".claude/rules";
+/** Valid rule file extensions */
+export declare const RULE_EXTENSIONS: string[];
+/** Tools that trigger rule injection */
+export declare const TRACKED_TOOLS: string[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/hooks/rules-injector/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/hooks/rules-injector/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,iDAAiD;AACjD,eAAO,MAAM,mBAAmB,QAA8B,CAAC;AAC/D,eAAO,MAAM,sBAAsB,QAA8C,CAAC;AAElF,wDAAwD;AACxD,eAAO,MAAM,eAAe,UAO3B,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAIlD,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,kBAAkB,EAAE,MAAM,EAEtC,CAAC;AAEF,4CAA4C;AAC5C,eAAO,MAAM,2BAA2B,QAAwB,CAAC;AAEjE,gCAAgC;AAChC,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C,iCAAiC;AACjC,eAAO,MAAM,eAAe,UAAkB,CAAC;AAE/C,wCAAwC;AACxC,eAAO,MAAM,aAAa,UAAyC,CAAC"}

package/dist/hooks/rules-injector/constants.js

@@ -0,0 +1,40 @@
+/**
+ * Rules Injector Constants
+ *
+ * Constants for rule file discovery and matching.
+ *
+ * Ported from oh-my-opencode's rules-injector hook.
+ */
+import { join } from 'path';
+import { homedir } from 'os';
+/** Storage directory for rules injector state */
+export const OLYMPUS_STORAGE_DIR = join(homedir(), '.olympus');
+export const RULES_INJECTOR_STORAGE = join(OLYMPUS_STORAGE_DIR, 'rules-injector');
+/** Project marker files that indicate a project root */
+export const PROJECT_MARKERS = [
+    '.git',
+    'pyproject.toml',
+    'package.json',
+    'Cargo.toml',
+    'go.mod',
+    '.venv',
+];
+/** Subdirectories to search for rules within projects */
+export const PROJECT_RULE_SUBDIRS = [
+    ['.github', 'instructions'],
+    ['.cursor', 'rules'],
+    ['.claude', 'rules'],
+];
+/** Single-file rules that always apply */
+export const PROJECT_RULE_FILES = [
+    '.github/copilot-instructions.md',
+];
+/** Pattern for GitHub instructions files */
+export const GITHUB_INSTRUCTIONS_PATTERN = /\.instructions\.md$/;
+/** User-level rule directory */
+export const USER_RULE_DIR = '.claude/rules';
+/** Valid rule file extensions */
+export const RULE_EXTENSIONS = ['.md', '.mdc'];
+/** Tools that trigger rule injection */
+export const TRACKED_TOOLS = ['read', 'write', 'edit', 'multiedit'];
+//# sourceMappingURL=constants.js.map

package/dist/hooks/rules-injector/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/hooks/rules-injector/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE7B,iDAAiD;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CAAC;AAElF,wDAAwD;AACxD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM;IACN,gBAAgB;IAChB,cAAc;IACd,YAAY;IACZ,QAAQ;IACR,OAAO;CACR,CAAC;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAuB;IACtD,CAAC,SAAS,EAAE,cAAc,CAAC;IAC3B,CAAC,SAAS,EAAE,OAAO,CAAC;IACpB,CAAC,SAAS,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,kBAAkB,GAAa;IAC1C,iCAAiC;CAClC,CAAC;AAEF,4CAA4C;AAC5C,MAAM,CAAC,MAAM,2BAA2B,GAAG,qBAAqB,CAAC;AAEjE,gCAAgC;AAChC,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAE7C,iCAAiC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAE/C,wCAAwC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC"}

package/dist/hooks/rules-injector/finder.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Rules Finder
+ *
+ * Finds rule files in project directories and user home.
+ *
+ * Ported from oh-my-opencode's rules-injector hook.
+ */
+import type { RuleFileCandidate } from './types.js';
+/**
+ * Find project root by walking up from startPath.
+ * Checks for PROJECT_MARKERS (.git, package.json, etc.)
+ */
+export declare function findProjectRoot(startPath: string): string | null;
+/**
+ * Calculate directory distance between a rule file and current file.
+ */
+export declare function calculateDistance(rulePath: string, currentFile: string, projectRoot: string | null): number;
+/**
+ * Find all rule files for a given context.
+ * Searches from currentFile upward to projectRoot for rule directories,
+ * then user-level directory (~/.claude/rules).
+ */
+export declare function findRuleFiles(projectRoot: string | null, homeDir: string, currentFile: string): RuleFileCandidate[];
+//# sourceMappingURL=finder.d.ts.map

package/dist/hooks/rules-injector/finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finder.d.ts","sourceRoot":"","sources":["../../../src/hooks/rules-injector/finder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAmBpD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBhE;AAqCD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,MAAM,CAoCR;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,iBAAiB,EAAE,CA2FrB"}

package/dist/hooks/rules-injector/finder.js

@@ -0,0 +1,215 @@
+/**
+ * Rules Finder
+ *
+ * Finds rule files in project directories and user home.
+ *
+ * Ported from oh-my-opencode's rules-injector hook.
+ */
+import { existsSync, readdirSync, realpathSync, statSync, } from 'fs';
+import { dirname, join, relative } from 'path';
+import { GITHUB_INSTRUCTIONS_PATTERN, PROJECT_MARKERS, PROJECT_RULE_FILES, PROJECT_RULE_SUBDIRS, RULE_EXTENSIONS, USER_RULE_DIR, } from './constants.js';
+/**
+ * Check if a directory is a GitHub instructions directory.
+ */
+function isGitHubInstructionsDir(dir) {
+    return dir.includes('.github/instructions') || dir.endsWith('.github/instructions');
+}
+/**
+ * Check if a file is a valid rule file.
+ */
+function isValidRuleFile(fileName, dir) {
+    if (isGitHubInstructionsDir(dir)) {
+        return GITHUB_INSTRUCTIONS_PATTERN.test(fileName);
+    }
+    return RULE_EXTENSIONS.some((ext) => fileName.endsWith(ext));
+}
+/**
+ * Find project root by walking up from startPath.
+ * Checks for PROJECT_MARKERS (.git, package.json, etc.)
+ */
+export function findProjectRoot(startPath) {
+    let current;
+    try {
+        const stat = statSync(startPath);
+        current = stat.isDirectory() ? startPath : dirname(startPath);
+    }
+    catch {
+        current = dirname(startPath);
+    }
+    while (true) {
+        for (const marker of PROJECT_MARKERS) {
+            const markerPath = join(current, marker);
+            if (existsSync(markerPath)) {
+                return current;
+            }
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+/**
+ * Recursively find all rule files in a directory.
+ */
+function findRuleFilesRecursive(dir, results) {
+    if (!existsSync(dir))
+        return;
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                findRuleFilesRecursive(fullPath, results);
+            }
+            else if (entry.isFile()) {
+                if (isValidRuleFile(entry.name, dir)) {
+                    results.push(fullPath);
+                }
+            }
+        }
+    }
+    catch {
+        // Permission denied or other errors - silently skip
+    }
+}
+/**
+ * Resolve symlinks safely with fallback to original path.
+ */
+function safeRealpathSync(filePath) {
+    try {
+        return realpathSync(filePath);
+    }
+    catch {
+        return filePath;
+    }
+}
+/**
+ * Calculate directory distance between a rule file and current file.
+ */
+export function calculateDistance(rulePath, currentFile, projectRoot) {
+    if (!projectRoot) {
+        return 9999;
+    }
+    try {
+        const ruleDir = dirname(rulePath);
+        const currentDir = dirname(currentFile);
+        const ruleRel = relative(projectRoot, ruleDir);
+        const currentRel = relative(projectRoot, currentDir);
+        // Handle paths outside project root
+        if (ruleRel.startsWith('..') || currentRel.startsWith('..')) {
+            return 9999;
+        }
+        // Split by both forward and back slashes for cross-platform compatibility
+        const ruleParts = ruleRel ? ruleRel.split(/[/\\]/) : [];
+        const currentParts = currentRel ? currentRel.split(/[/\\]/) : [];
+        // Find common prefix length
+        let common = 0;
+        for (let i = 0; i < Math.min(ruleParts.length, currentParts.length); i++) {
+            if (ruleParts[i] === currentParts[i]) {
+                common++;
+            }
+            else {
+                break;
+            }
+        }
+        // Distance is how many directories up from current file to common ancestor
+        return currentParts.length - common;
+    }
+    catch {
+        return 9999;
+    }
+}
+/**
+ * Find all rule files for a given context.
+ * Searches from currentFile upward to projectRoot for rule directories,
+ * then user-level directory (~/.claude/rules).
+ */
+export function findRuleFiles(projectRoot, homeDir, currentFile) {
+    const candidates = [];
+    const seenRealPaths = new Set();
+    // Search from current file's directory up to project root
+    let currentDir = dirname(currentFile);
+    let distance = 0;
+    while (true) {
+        // Search rule directories in current directory
+        for (const [parent, subdir] of PROJECT_RULE_SUBDIRS) {
+            const ruleDir = join(currentDir, parent, subdir);
+            const files = [];
+            findRuleFilesRecursive(ruleDir, files);
+            for (const filePath of files) {
+                const realPath = safeRealpathSync(filePath);
+                if (seenRealPaths.has(realPath))
+                    continue;
+                seenRealPaths.add(realPath);
+                candidates.push({
+                    path: filePath,
+                    realPath,
+                    isGlobal: false,
+                    distance,
+                });
+            }
+        }
+        // Stop at project root or filesystem root
+        if (projectRoot && currentDir === projectRoot)
+            break;
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir)
+            break;
+        currentDir = parentDir;
+        distance++;
+    }
+    // Check for single-file rules at project root
+    if (projectRoot) {
+        for (const ruleFile of PROJECT_RULE_FILES) {
+            const filePath = join(projectRoot, ruleFile);
+            if (existsSync(filePath)) {
+                try {
+                    const stat = statSync(filePath);
+                    if (stat.isFile()) {
+                        const realPath = safeRealpathSync(filePath);
+                        if (!seenRealPaths.has(realPath)) {
+                            seenRealPaths.add(realPath);
+                            candidates.push({
+                                path: filePath,
+                                realPath,
+                                isGlobal: false,
+                                distance: 0,
+                                isSingleFile: true,
+                            });
+                        }
+                    }
+                }
+                catch {
+                    // Skip if file can't be read
+                }
+            }
+        }
+    }
+    // Search user-level rule directory (~/.claude/rules)
+    const userRuleDir = join(homeDir, USER_RULE_DIR);
+    const userFiles = [];
+    findRuleFilesRecursive(userRuleDir, userFiles);
+    for (const filePath of userFiles) {
+        const realPath = safeRealpathSync(filePath);
+        if (seenRealPaths.has(realPath))
+            continue;
+        seenRealPaths.add(realPath);
+        candidates.push({
+            path: filePath,
+            realPath,
+            isGlobal: true,
+            distance: 9999, // Global rules always have max distance
+        });
+    }
+    // Sort by distance (closest first, then global rules last)
+    candidates.sort((a, b) => {
+        if (a.isGlobal !== b.isGlobal) {
+            return a.isGlobal ? 1 : -1;
+        }
+        return a.distance - b.distance;
+    });
+    return candidates;
+}
+//# sourceMappingURL=finder.js.map

package/dist/hooks/rules-injector/finder.js.map

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

package/dist/hooks/rules-injector/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Rules Injector Hook
+ *
+ * Automatically injects relevant rule files when Claude accesses files.
+ * Supports project-level (.claude/rules, .github/instructions) and
+ * user-level (~/.claude/rules) rule files.
+ *
+ * Ported from oh-my-opencode's rules-injector hook.
+ */
+import type { RuleToInject } from './types.js';
+export * from './types.js';
+export * from './constants.js';
+export * from './finder.js';
+export * from './parser.js';
+export * from './matcher.js';
+export * from './storage.js';
+/**
+ * Create a rules injector hook for Claude Code.
+ *
+ * @param workingDirectory - The working directory for resolving paths
+ * @returns Hook handlers for tool execution
+ */
+export declare function createRulesInjectorHook(workingDirectory: string): {
+    /**
+     * Process a tool execution and inject rules if relevant.
+     */
+    processToolExecution: (toolName: string, filePath: string, sessionId: string) => string;
+    /**
+     * Get rules for a specific file without marking as injected.
+     */
+    getRulesForFile: (filePath: string) => RuleToInject[];
+    /**
+     * Clear session cache when session ends.
+     */
+    clearSession: (sessionId: string) => void;
+    /**
+     * Check if a tool triggers rule injection.
+     */
+    isTrackedTool: (toolName: string) => boolean;
+};
+/**
+ * Get rules for a file path (simple utility function).
+ */
+export declare function getRulesForPath(filePath: string, workingDirectory?: string): RuleToInject[];
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/rules-injector/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/rules-injector/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAU7B;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,gBAAgB,EAAE,MAAM;IA6F5D;;OAEG;qCAES,MAAM,YACN,MAAM,aACL,MAAM,KAChB,MAAM;IAST;;OAEG;gCACyB,MAAM,KAAG,YAAY,EAAE;IA0CnD;;OAEG;8BACuB,MAAM,KAAG,IAAI;IAKvC;;OAEG;8BACuB,MAAM,KAAG,OAAO;EAI7C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAI3F"}