oh-my-claude-sisyphus 3.3.10 → 3.4.0

package/dist/hooks/ultrapilot/state.js

@@ -0,0 +1,258 @@
+/**
+ * Ultrapilot State Management
+ *
+ * Persistent state for ultrapilot workflow - tracks parallel workers,
+ * file ownership, and progress.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { DEFAULT_CONFIG } from './types.js';
+const STATE_FILE = 'ultrapilot-state.json';
+const OWNERSHIP_FILE = 'ultrapilot-ownership.json';
+/**
+ * Get the state file path
+ */
+function getStateFilePath(directory) {
+    const omcDir = join(directory, '.omc', 'state');
+    return join(omcDir, STATE_FILE);
+}
+/**
+ * Get the ownership file path
+ */
+function getOwnershipFilePath(directory) {
+    const omcDir = join(directory, '.omc', 'state');
+    return join(omcDir, OWNERSHIP_FILE);
+}
+/**
+ * Ensure the state directory exists
+ */
+function ensureStateDir(directory) {
+    const stateDir = join(directory, '.omc', 'state');
+    if (!existsSync(stateDir)) {
+        mkdirSync(stateDir, { recursive: true });
+    }
+}
+/**
+ * Read ultrapilot state from disk
+ */
+export function readUltrapilotState(directory) {
+    const stateFile = getStateFilePath(directory);
+    if (!existsSync(stateFile)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(stateFile, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write ultrapilot state to disk
+ */
+export function writeUltrapilotState(directory, state) {
+    try {
+        ensureStateDir(directory);
+        const stateFile = getStateFilePath(directory);
+        writeFileSync(stateFile, JSON.stringify(state, null, 2));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Clear ultrapilot state
+ */
+export function clearUltrapilotState(directory) {
+    const stateFile = getStateFilePath(directory);
+    const ownershipFile = getOwnershipFilePath(directory);
+    try {
+        if (existsSync(stateFile)) {
+            unlinkSync(stateFile);
+        }
+        if (existsSync(ownershipFile)) {
+            unlinkSync(ownershipFile);
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if ultrapilot is active
+ */
+export function isUltrapilotActive(directory) {
+    const state = readUltrapilotState(directory);
+    return state !== null && state.active === true;
+}
+/**
+ * Initialize a new ultrapilot session
+ */
+export function initUltrapilot(directory, task, subtasks, sessionId, config) {
+    const mergedConfig = { ...DEFAULT_CONFIG, ...config };
+    const now = new Date().toISOString();
+    const state = {
+        active: true,
+        iteration: 1,
+        maxIterations: mergedConfig.maxIterations,
+        originalTask: task,
+        subtasks,
+        workers: [],
+        ownership: {
+            coordinator: mergedConfig.sharedFiles,
+            workers: {},
+            conflicts: []
+        },
+        startedAt: now,
+        completedAt: null,
+        totalWorkersSpawned: 0,
+        successfulWorkers: 0,
+        failedWorkers: 0,
+        sessionId
+    };
+    writeUltrapilotState(directory, state);
+    return state;
+}
+/**
+ * Update worker state
+ */
+export function updateWorkerState(directory, workerId, updates) {
+    const state = readUltrapilotState(directory);
+    if (!state)
+        return false;
+    const workerIndex = state.workers.findIndex((w) => w.id === workerId);
+    if (workerIndex === -1)
+        return false;
+    state.workers[workerIndex] = { ...state.workers[workerIndex], ...updates };
+    return writeUltrapilotState(directory, state);
+}
+/**
+ * Add a new worker
+ */
+export function addWorker(directory, worker) {
+    const state = readUltrapilotState(directory);
+    if (!state)
+        return false;
+    state.workers.push(worker);
+    state.totalWorkersSpawned += 1;
+    // Update ownership
+    state.ownership.workers[worker.id] = worker.ownedFiles;
+    return writeUltrapilotState(directory, state);
+}
+/**
+ * Mark worker as complete
+ */
+export function completeWorker(directory, workerId, filesCreated, filesModified) {
+    const state = readUltrapilotState(directory);
+    if (!state)
+        return false;
+    const workerIndex = state.workers.findIndex((w) => w.id === workerId);
+    if (workerIndex === -1)
+        return false;
+    state.workers[workerIndex].status = 'complete';
+    state.workers[workerIndex].completedAt = new Date().toISOString();
+    state.workers[workerIndex].filesCreated = filesCreated;
+    state.workers[workerIndex].filesModified = filesModified;
+    state.successfulWorkers += 1;
+    return writeUltrapilotState(directory, state);
+}
+/**
+ * Mark worker as failed
+ */
+export function failWorker(directory, workerId, error) {
+    const state = readUltrapilotState(directory);
+    if (!state)
+        return false;
+    const workerIndex = state.workers.findIndex((w) => w.id === workerId);
+    if (workerIndex === -1)
+        return false;
+    state.workers[workerIndex].status = 'failed';
+    state.workers[workerIndex].completedAt = new Date().toISOString();
+    state.workers[workerIndex].error = error;
+    state.failedWorkers += 1;
+    return writeUltrapilotState(directory, state);
+}
+/**
+ * Complete ultrapilot session
+ */
+export function completeUltrapilot(directory) {
+    const state = readUltrapilotState(directory);
+    if (!state)
+        return false;
+    state.active = false;
+    state.completedAt = new Date().toISOString();
+    return writeUltrapilotState(directory, state);
+}
+/**
+ * Read file ownership mapping
+ */
+export function readFileOwnership(directory) {
+    const ownershipFile = getOwnershipFilePath(directory);
+    if (!existsSync(ownershipFile)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(ownershipFile, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write file ownership mapping
+ */
+export function writeFileOwnership(directory, ownership) {
+    try {
+        ensureStateDir(directory);
+        const ownershipFile = getOwnershipFilePath(directory);
+        writeFileSync(ownershipFile, JSON.stringify(ownership, null, 2));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Record a file conflict
+ */
+export function recordConflict(directory, filePath) {
+    const state = readUltrapilotState(directory);
+    if (!state)
+        return false;
+    if (!state.ownership.conflicts.includes(filePath)) {
+        state.ownership.conflicts.push(filePath);
+    }
+    return writeUltrapilotState(directory, state);
+}
+/**
+ * Get all completed workers
+ */
+export function getCompletedWorkers(directory) {
+    const state = readUltrapilotState(directory);
+    if (!state)
+        return [];
+    return state.workers.filter((w) => w.status === 'complete');
+}
+/**
+ * Get all running workers
+ */
+export function getRunningWorkers(directory) {
+    const state = readUltrapilotState(directory);
+    if (!state)
+        return [];
+    return state.workers.filter((w) => w.status === 'running');
+}
+/**
+ * Get all failed workers
+ */
+export function getFailedWorkers(directory) {
+    const state = readUltrapilotState(directory);
+    if (!state)
+        return [];
+    return state.workers.filter((w) => w.status === 'failed');
+}
+//# sourceMappingURL=state.js.map

package/dist/hooks/ultrapilot/state.js.map

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

package/dist/hooks/ultrapilot/types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Ultrapilot Types
+ *
+ * Type definitions for the ultrapilot coordinator - manages parallel worker spawning
+ * and coordination with file ownership to avoid conflicts.
+ *
+ * Ultrapilot decomposes tasks into parallelizable subtasks, spawns workers (max 5),
+ * tracks progress, and integrates results while managing shared file access.
+ */
+/**
+ * Configuration options for ultrapilot behavior
+ */
+export interface UltrapilotConfig {
+    /** Maximum number of parallel workers */
+    maxWorkers?: number;
+    /** Maximum iterations before giving up */
+    maxIterations?: number;
+    /** Timeout per worker in milliseconds */
+    workerTimeout?: number;
+    /** Model to use for workers (haiku/sonnet/opus) */
+    workerModel?: string;
+    /** List of shared files that only coordinator can modify */
+    sharedFiles?: string[];
+    /** Whether to enable verbose logging */
+    verbose?: boolean;
+}
+/**
+ * State of an individual worker
+ */
+export interface WorkerState {
+    /** Unique worker ID */
+    id: string;
+    /** Worker index (0-4) */
+    index: number;
+    /** Task assigned to this worker */
+    task: string;
+    /** Files this worker owns (can modify) */
+    ownedFiles: string[];
+    /** Current status */
+    status: 'pending' | 'running' | 'complete' | 'failed';
+    /** Task agent ID (from Task tool) */
+    taskId?: string;
+    /** Start timestamp */
+    startedAt?: string;
+    /** Completion timestamp */
+    completedAt?: string;
+    /** Error message if failed */
+    error?: string;
+    /** Files created by this worker */
+    filesCreated: string[];
+    /** Files modified by this worker */
+    filesModified: string[];
+}
+/**
+ * File ownership mapping to prevent conflicts
+ */
+export interface FileOwnership {
+    /** Files owned by the coordinator (shared files) */
+    coordinator: string[];
+    /** Files owned by each worker (keyed by worker ID) */
+    workers: Record<string, string[]>;
+    /** Files that have conflicts (multiple workers attempted to modify) */
+    conflicts: string[];
+}
+/**
+ * Complete ultrapilot state
+ */
+export interface UltrapilotState {
+    /** Whether ultrapilot is currently active */
+    active: boolean;
+    /** Current iteration number */
+    iteration: number;
+    /** Maximum iterations before giving up */
+    maxIterations: number;
+    /** Original task provided by user */
+    originalTask: string;
+    /** Decomposed subtasks */
+    subtasks: string[];
+    /** State for each worker */
+    workers: WorkerState[];
+    /** File ownership mapping */
+    ownership: FileOwnership;
+    /** Metrics and timestamps */
+    startedAt: string;
+    completedAt: string | null;
+    totalWorkersSpawned: number;
+    successfulWorkers: number;
+    failedWorkers: number;
+    /** Session binding */
+    sessionId?: string;
+}
+/**
+ * Result from integrating worker outputs
+ */
+export interface IntegrationResult {
+    /** Whether integration was successful */
+    success: boolean;
+    /** All files created across workers */
+    filesCreated: string[];
+    /** All files modified across workers */
+    filesModified: string[];
+    /** List of conflicts that need manual resolution */
+    conflicts: string[];
+    /** List of errors encountered */
+    errors: string[];
+    /** Summary of work completed */
+    summary: string;
+}
+/**
+ * Default configuration for ultrapilot
+ */
+export declare const DEFAULT_CONFIG: Required<UltrapilotConfig>;
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/ultrapilot/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/ultrapilot/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,qBAAqB;IACrB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IACtD,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oCAAoC;IACpC,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAClC,uEAAuE;IACvE,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4BAA4B;IAC5B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,6BAA6B;IAC7B,SAAS,EAAE,aAAa,CAAC;IACzB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wCAAwC;IACxC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,oDAAoD;IACpD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iCAAiC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,gBAAgB,CAsBrD,CAAC"}

package/dist/hooks/ultrapilot/types.js

@@ -0,0 +1,36 @@
+/**
+ * Ultrapilot Types
+ *
+ * Type definitions for the ultrapilot coordinator - manages parallel worker spawning
+ * and coordination with file ownership to avoid conflicts.
+ *
+ * Ultrapilot decomposes tasks into parallelizable subtasks, spawns workers (max 5),
+ * tracks progress, and integrates results while managing shared file access.
+ */
+/**
+ * Default configuration for ultrapilot
+ */
+export const DEFAULT_CONFIG = {
+    maxWorkers: 5,
+    maxIterations: 3,
+    workerTimeout: 300000, // 5 minutes
+    workerModel: 'sonnet',
+    sharedFiles: [
+        'package.json',
+        'package-lock.json',
+        'tsconfig.json',
+        'jest.config.js',
+        '.gitignore',
+        'README.md',
+        'Makefile',
+        'go.mod',
+        'go.sum',
+        'Cargo.toml',
+        'Cargo.lock',
+        'pyproject.toml',
+        'requirements.txt',
+        'setup.py'
+    ],
+    verbose: false
+};
+//# sourceMappingURL=types.js.map

package/dist/hooks/ultrapilot/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hooks/ultrapilot/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0GH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAA+B;IACxD,UAAU,EAAE,CAAC;IACb,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,YAAY;IACnC,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE;QACX,cAAc;QACd,mBAAmB;QACnB,eAAe;QACf,gBAAgB;QAChB,YAAY;QACZ,WAAW;QACX,UAAU;QACV,QAAQ;QACR,QAAQ;QACR,YAAY;QACZ,YAAY;QACZ,gBAAgB;QAChB,kBAAkB;QAClB,UAAU;KACX;IACD,OAAO,EAAE,KAAK;CACf,CAAC"}

package/dist/hooks/ultraqa/index.d.ts

@@ -0,0 +1,94 @@
+/**
+ * UltraQA Loop Hook
+ *
+ * QA cycling workflow that runs test → architect verify → fix → repeat
+ * until the QA goal is met or max cycles reached.
+ */
+export type UltraQAGoalType = 'tests' | 'build' | 'lint' | 'typecheck' | 'custom';
+export interface UltraQAState {
+    /** Whether the loop is currently active */
+    active: boolean;
+    /** Type of QA goal */
+    goal_type: UltraQAGoalType;
+    /** Custom pattern to match (for custom goal type) */
+    goal_pattern: string | null;
+    /** Current cycle number */
+    cycle: number;
+    /** Maximum cycles before stopping */
+    max_cycles: number;
+    /** Array of failure descriptions for pattern detection */
+    failures: string[];
+    /** When the loop started */
+    started_at: string;
+    /** Session ID the loop is bound to */
+    session_id?: string;
+}
+export interface UltraQAOptions {
+    /** Maximum cycles (default: 5) */
+    maxCycles?: number;
+    /** Custom pattern for custom goal type */
+    customPattern?: string;
+}
+export interface UltraQAResult {
+    /** Whether the goal was met */
+    success: boolean;
+    /** Number of cycles taken */
+    cycles: number;
+    /** Reason for exit */
+    reason: 'goal_met' | 'max_cycles' | 'same_failure' | 'env_error' | 'cancelled';
+    /** Diagnosis message if failed */
+    diagnosis?: string;
+}
+/**
+ * Read UltraQA state from disk
+ */
+export declare function readUltraQAState(directory: string): UltraQAState | null;
+/**
+ * Write UltraQA state to disk
+ */
+export declare function writeUltraQAState(directory: string, state: UltraQAState): boolean;
+/**
+ * Clear UltraQA state
+ */
+export declare function clearUltraQAState(directory: string): boolean;
+/**
+ * Check if Ralph Loop is active (mutual exclusion check)
+ */
+export declare function isRalphLoopActive(directory: string): boolean;
+/**
+ * Start a new UltraQA cycle
+ * Returns false if Ralph Loop is already active (mutual exclusion)
+ */
+export declare function startUltraQA(directory: string, goalType: UltraQAGoalType, sessionId: string, options?: UltraQAOptions): {
+    success: boolean;
+    error?: string;
+};
+/**
+ * Record a failure and increment cycle
+ */
+export declare function recordFailure(directory: string, failureDescription: string): {
+    state: UltraQAState | null;
+    shouldExit: boolean;
+    reason?: string;
+};
+/**
+ * Mark UltraQA as successful
+ */
+export declare function completeUltraQA(directory: string): UltraQAResult | null;
+/**
+ * Stop UltraQA with failure
+ */
+export declare function stopUltraQA(directory: string, reason: 'max_cycles' | 'same_failure' | 'env_error', diagnosis: string): UltraQAResult | null;
+/**
+ * Cancel UltraQA
+ */
+export declare function cancelUltraQA(directory: string): boolean;
+/**
+ * Get goal command based on goal type
+ */
+export declare function getGoalCommand(goalType: UltraQAGoalType): string;
+/**
+ * Format progress message
+ */
+export declare function formatProgressMessage(cycle: number, maxCycles: number, status: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/ultraqa/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/ultraqa/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElF,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,MAAM,EAAE,OAAO,CAAC;IAChB,sBAAsB;IACtB,SAAS,EAAE,eAAe,CAAC;IAC3B,qDAAqD;IACrD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,cAAc,GAAG,WAAW,GAAG,WAAW,CAAC;IAC/E,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAavE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CASjF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAa5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAG5D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAsBtC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,MAAM,GACzB;IAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAqCtE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAevE;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,GAAG,cAAc,GAAG,WAAW,EACnD,SAAS,EAAE,MAAM,GAChB,aAAa,GAAG,IAAI,CAgBtB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAExD;AAgBD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAahE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,CAER"}