specweave 0.21.3 → 0.22.2

package/dist/src/core/workflow/autonomous-executor.js

@@ -0,0 +1,275 @@
+/**
+ * Autonomous Executor - Fully autonomous workflow execution
+ *
+ * Executes complete workflows without human intervention, with safety guardrails:
+ * - Max iteration limits
+ * - Infinite loop detection
+ * - Cost threshold enforcement
+ * - Checkpoint/recovery system
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow/autonomous-executor
+ * @since v0.22.0
+ */
+import { WorkflowOrchestrator } from './workflow-orchestrator.js';
+import { StateManager } from './state-manager.js';
+import { CostEstimator } from './cost-estimator.js';
+import { CommandInvoker } from './command-invoker.js';
+import { WorkflowPhase } from './types.js';
+import * as path from 'path';
+/**
+ * Autonomous Executor - Fully autonomous workflow execution with safety guardrails
+ */
+export class AutonomousExecutor {
+    constructor(config = {}) {
+        this.config = config;
+        this.orchestrator = new WorkflowOrchestrator();
+        this.stateManager = new StateManager();
+        this.costEstimator = new CostEstimator();
+        this.commandInvoker = new CommandInvoker();
+        // Apply defaults
+        this.config.maxIterations = config.maxIterations || 50;
+        this.config.costThreshold = config.costThreshold || 20.0;
+        this.config.enableCheckpoints = config.enableCheckpoints !== false;
+        this.config.maxRetries = config.maxRetries || 3;
+        this.config.stopOnError = config.stopOnError || false;
+        this.config.verbose = config.verbose || false;
+    }
+    /**
+     * Execute workflow autonomously
+     *
+     * @param incrementId - Increment ID to execute
+     * @param resumeCheckpointId - Optional checkpoint to resume from
+     * @returns Autonomous execution result
+     */
+    async execute(incrementId, resumeCheckpointId) {
+        this.log(`🚀 Starting autonomous execution for increment ${incrementId}`);
+        // Initialize state
+        let state;
+        if (resumeCheckpointId) {
+            state = await this.resumeFromCheckpoint(incrementId, resumeCheckpointId);
+            this.log(`📂 Resumed from checkpoint ${resumeCheckpointId} (iteration ${state.iteration})`);
+        }
+        else {
+            state = this.initializeState(incrementId);
+            this.log(`🆕 Starting fresh execution`);
+        }
+        // Pre-flight checks
+        const preflightResult = await this.preflightCheck(incrementId);
+        if (!preflightResult.passed) {
+            return {
+                success: false,
+                incrementId,
+                iterations: 0,
+                commandsExecuted: [],
+                totalCost: 0,
+                finalPhase: WorkflowPhase.UNKNOWN,
+                reason: `Preflight check failed: ${preflightResult.reason}`,
+                error: preflightResult.reason
+            };
+        }
+        // Main execution loop
+        try {
+            while (state.iteration < this.config.maxIterations) {
+                this.log(`\n📍 Iteration ${state.iteration + 1}/${this.config.maxIterations}`);
+                // Safety checks
+                const safetyCheck = this.checkSafety(state);
+                if (!safetyCheck.safe) {
+                    return this.terminateExecution(state, safetyCheck.reason, false);
+                }
+                // Execute next step
+                const result = await this.executeStep(state);
+                // Handle execution result
+                if (!result.success) {
+                    if (this.config.stopOnError) {
+                        return this.terminateExecution(state, `Step failed: ${result.error}`, false);
+                    }
+                    else {
+                        this.log(`⚠️  Step failed (continuing): ${result.error}`);
+                    }
+                }
+                // Update state
+                state.iteration++;
+                state.phase = result.phase;
+                state.phaseHistory.push(result.phase);
+                if (result.command) {
+                    state.commandsExecuted.push(result.command);
+                }
+                // Save checkpoint
+                if (this.config.enableCheckpoints) {
+                    await this.saveCheckpoint(state);
+                }
+                // Check completion
+                if (this.isComplete(state)) {
+                    return this.terminateExecution(state, 'Workflow completed successfully', true);
+                }
+            }
+            // Max iterations reached
+            return this.terminateExecution(state, `Max iterations (${this.config.maxIterations}) reached`, false);
+        }
+        catch (error) {
+            return this.terminateExecution(state, `Fatal error: ${error instanceof Error ? error.message : String(error)}`, false);
+        }
+    }
+    /**
+     * Execute single step in workflow
+     */
+    async executeStep(state) {
+        this.log(`🔍 Detecting current phase...`);
+        // Use orchestrator to detect phase and determine action
+        const result = await this.orchestrator.executeNext(state.incrementId, {
+            autonomous: true,
+            verbose: this.config.verbose
+        });
+        this.log(`📊 Phase: ${result.phase} (confidence: ${(result.confidence * 100).toFixed(0)}%)`);
+        this.log(`🎯 Action: ${result.action}`);
+        // Execute command if suggested
+        if (result.command && result.success) {
+            this.log(`⚡ Executing: ${result.command}`);
+            const invokeResult = await this.commandInvoker.invokeWithRetry(result.command, {
+                captureOutput: true
+            }, this.config.maxRetries);
+            if (!invokeResult.success) {
+                this.log(`❌ Command failed: ${invokeResult.error}`);
+                return {
+                    ...result,
+                    success: false,
+                    error: invokeResult.error
+                };
+            }
+            this.log(`✅ Command completed in ${(invokeResult.executionTime / 1000).toFixed(1)}s`);
+        }
+        return result;
+    }
+    /**
+     * Preflight check before execution
+     */
+    async preflightCheck(incrementId) {
+        // Check increment exists
+        const incrementPath = path.join(process.cwd(), '.specweave/increments', incrementId);
+        const fs = await import('fs-extra');
+        if (!await fs.pathExists(incrementPath)) {
+            return {
+                passed: false,
+                reason: `Increment ${incrementId} not found`
+            };
+        }
+        // Estimate cost
+        const estimate = await this.costEstimator.estimateIncrement(incrementPath);
+        this.log(`💰 Estimated cost: $${estimate.estimatedCost.toFixed(2)} (${estimate.riskLevel.toUpperCase()})`);
+        if (estimate.estimatedCost > this.config.costThreshold) {
+            return {
+                passed: false,
+                reason: `Estimated cost ($${estimate.estimatedCost.toFixed(2)}) exceeds threshold ($${this.config.costThreshold})`
+            };
+        }
+        return { passed: true };
+    }
+    /**
+     * Safety checks during execution
+     */
+    checkSafety(state) {
+        // Check for infinite loop
+        if (this.stateManager.detectLoop(state.phaseHistory)) {
+            return {
+                safe: false,
+                reason: 'Infinite loop detected (same phase repeated 3+ times)'
+            };
+        }
+        // Check cost threshold
+        if (state.totalCost > this.config.costThreshold) {
+            return {
+                safe: false,
+                reason: `Cost threshold ($${this.config.costThreshold}) exceeded (current: $${state.totalCost.toFixed(2)})`
+            };
+        }
+        return { safe: true };
+    }
+    /**
+     * Check if workflow is complete
+     */
+    isComplete(state) {
+        // Completion phase reached
+        if (state.phase === WorkflowPhase.COMPLETION) {
+            return true;
+        }
+        // Unknown phase with no further actions (stuck)
+        if (state.phase === WorkflowPhase.UNKNOWN && state.iteration > 5) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Initialize execution state
+     */
+    initializeState(incrementId) {
+        return {
+            incrementId,
+            iteration: 0,
+            phase: WorkflowPhase.UNKNOWN,
+            commandsExecuted: [],
+            totalCost: 0,
+            phaseHistory: []
+        };
+    }
+    /**
+     * Resume from checkpoint
+     */
+    async resumeFromCheckpoint(incrementId, checkpointId) {
+        const checkpoints = await this.stateManager.loadCheckpoints(incrementId);
+        const checkpoint = checkpoints.find(c => c.id === checkpointId);
+        if (!checkpoint) {
+            throw new Error(`Checkpoint ${checkpointId} not found`);
+        }
+        return {
+            incrementId,
+            iteration: checkpoint.iteration,
+            phase: checkpoint.phase,
+            commandsExecuted: checkpoint.actions,
+            totalCost: 0, // Reset cost tracking
+            phaseHistory: [checkpoint.phase]
+        };
+    }
+    /**
+     * Save execution checkpoint
+     */
+    async saveCheckpoint(state) {
+        await this.stateManager.saveCheckpoint({
+            id: `autonomous-${Date.now()}`,
+            timestamp: Date.now(),
+            incrementId: state.incrementId,
+            phase: state.phase,
+            iteration: state.iteration,
+            actions: state.commandsExecuted
+        });
+    }
+    /**
+     * Terminate execution and return result
+     */
+    terminateExecution(state, reason, success) {
+        this.log(`\n${success ? '✅' : '❌'} ${reason}`);
+        this.log(`📊 Final stats:`);
+        this.log(`   - Iterations: ${state.iteration}`);
+        this.log(`   - Commands: ${state.commandsExecuted.length}`);
+        this.log(`   - Cost: $${state.totalCost.toFixed(2)}`);
+        return {
+            success,
+            incrementId: state.incrementId,
+            iterations: state.iteration,
+            commandsExecuted: state.commandsExecuted,
+            totalCost: state.totalCost,
+            finalPhase: state.phase,
+            reason
+        };
+    }
+    /**
+     * Log message (if verbose enabled)
+     */
+    log(message) {
+        if (this.config.verbose) {
+            console.log(message);
+        }
+    }
+}
+//# sourceMappingURL=autonomous-executor.js.map

package/dist/src/core/workflow/autonomous-executor.js.map

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

package/dist/src/core/workflow/backlog-scanner.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Backlog Scanner - Intelligent backlog scanning and ranking
+ *
+ * Scans .specweave/increments/_backlog/ directory and ranks items
+ * by priority, dependencies, and project match.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow/backlog-scanner
+ * @since v0.22.0
+ */
+/**
+ * Backlog item metadata
+ */
+export interface BacklogItem {
+    /** Increment ID */
+    incrementId: string;
+    /** Full path to spec.md */
+    specPath: string;
+    /** Title */
+    title: string;
+    /** Priority (P0, P1, P2, P3) */
+    priority: string;
+    /** Project (if multi-project) */
+    project?: string;
+    /** Dependencies (other increment IDs) */
+    dependencies: string[];
+    /** Estimated effort (hours or weeks) */
+    estimatedEffort?: string;
+    /** Creation date */
+    created?: string;
+}
+/**
+ * Ranked backlog item with score
+ */
+export interface RankedBacklogItem extends BacklogItem {
+    /** Ranking score (higher = better) */
+    score: number;
+    /** Ranking explanation */
+    reason: string;
+}
+/**
+ * Backlog recommendation
+ */
+export interface BacklogRecommendation {
+    /** Recommended items (top N) */
+    items: RankedBacklogItem[];
+    /** Total backlog size */
+    totalItems: number;
+    /** Explanation */
+    summary: string;
+}
+/**
+ * Backlog Scanner - Scan and rank backlog items
+ */
+export declare class BacklogScanner {
+    private backlogDir;
+    constructor(rootDir?: string);
+    /**
+     * Scan backlog directory
+     *
+     * @returns Array of backlog items
+     */
+    scanBacklog(): Promise<BacklogItem[]>;
+    /**
+     * Parse backlog item from spec.md
+     */
+    private parseBacklogItem;
+    /**
+     * Rank backlog items by priority, dependencies, and project match
+     *
+     * Ranking algorithm:
+     * - Priority: P0=10, P1=7, P2=5, P3=3
+     * - Dependencies met: +5
+     * - Project match: +3
+     * - Recently created: +2
+     *
+     * @param items - Backlog items to rank
+     * @param currentProject - Current project (for filtering)
+     * @param completedIncrements - List of completed increment IDs
+     * @returns Ranked items (sorted by score descending)
+     */
+    rankItems(items: BacklogItem[], currentProject?: string, completedIncrements?: string[]): RankedBacklogItem[];
+    /**
+     * Get top N recommendations
+     *
+     * @param n - Number of recommendations (default: 3)
+     * @param currentProject - Current project filter
+     * @param completedIncrements - Completed increments
+     * @returns Backlog recommendations
+     */
+    getTopRecommendations(n?: number, currentProject?: string, completedIncrements?: string[]): Promise<BacklogRecommendation>;
+}
+//# sourceMappingURL=backlog-scanner.d.ts.map

package/dist/src/core/workflow/backlog-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlog-scanner.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/backlog-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,GAAE,MAAsB;IAI3C;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAmC3C;;OAEG;YACW,gBAAgB;IA2B9B;;;;;;;;;;;;;OAaG;IACH,SAAS,CACP,KAAK,EAAE,WAAW,EAAE,EACpB,cAAc,CAAC,EAAE,MAAM,EACvB,mBAAmB,GAAE,MAAM,EAAO,GACjC,iBAAiB,EAAE;IAoDtB;;;;;;;OAOG;IACG,qBAAqB,CACzB,CAAC,GAAE,MAAU,EACb,cAAc,CAAC,EAAE,MAAM,EACvB,mBAAmB,GAAE,MAAM,EAAO,GACjC,OAAO,CAAC,qBAAqB,CAAC;CAoBlC"}

package/dist/src/core/workflow/backlog-scanner.js

@@ -0,0 +1,170 @@
+/**
+ * Backlog Scanner - Intelligent backlog scanning and ranking
+ *
+ * Scans .specweave/increments/_backlog/ directory and ranks items
+ * by priority, dependencies, and project match.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow/backlog-scanner
+ * @since v0.22.0
+ */
+import * as fs from 'fs-extra';
+import * as path from 'path';
+import * as yaml from 'js-yaml';
+/**
+ * Backlog Scanner - Scan and rank backlog items
+ */
+export class BacklogScanner {
+    constructor(rootDir = process.cwd()) {
+        this.backlogDir = path.join(rootDir, '.specweave/increments/_backlog');
+    }
+    /**
+     * Scan backlog directory
+     *
+     * @returns Array of backlog items
+     */
+    async scanBacklog() {
+        // Check if backlog directory exists
+        if (!await fs.pathExists(this.backlogDir)) {
+            return [];
+        }
+        const items = [];
+        const dirs = await fs.readdir(this.backlogDir);
+        for (const dir of dirs) {
+            const dirPath = path.join(this.backlogDir, dir);
+            const stat = await fs.stat(dirPath);
+            if (!stat.isDirectory()) {
+                continue;
+            }
+            // Check if spec.md exists
+            const specPath = path.join(dirPath, 'spec.md');
+            if (!await fs.pathExists(specPath)) {
+                continue;
+            }
+            // Parse spec.md frontmatter
+            try {
+                const item = await this.parseBacklogItem(dir, specPath);
+                items.push(item);
+            }
+            catch (error) {
+                console.warn(`Failed to parse backlog item ${dir}:`, error);
+            }
+        }
+        return items;
+    }
+    /**
+     * Parse backlog item from spec.md
+     */
+    async parseBacklogItem(incrementId, specPath) {
+        const content = await fs.readFile(specPath, 'utf-8');
+        // Extract YAML frontmatter
+        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!frontmatterMatch) {
+            throw new Error('No YAML frontmatter found in spec.md');
+        }
+        const frontmatter = yaml.load(frontmatterMatch[1]);
+        // Extract title from first heading
+        const titleMatch = content.match(/^#\s+(.+)$/m);
+        const title = titleMatch ? titleMatch[1] : frontmatter.title || incrementId;
+        return {
+            incrementId,
+            specPath,
+            title,
+            priority: frontmatter.priority || 'P2',
+            project: frontmatter.project,
+            dependencies: frontmatter.dependencies || [],
+            estimatedEffort: frontmatter.estimated_effort || frontmatter.estimatedEffort,
+            created: frontmatter.created
+        };
+    }
+    /**
+     * Rank backlog items by priority, dependencies, and project match
+     *
+     * Ranking algorithm:
+     * - Priority: P0=10, P1=7, P2=5, P3=3
+     * - Dependencies met: +5
+     * - Project match: +3
+     * - Recently created: +2
+     *
+     * @param items - Backlog items to rank
+     * @param currentProject - Current project (for filtering)
+     * @param completedIncrements - List of completed increment IDs
+     * @returns Ranked items (sorted by score descending)
+     */
+    rankItems(items, currentProject, completedIncrements = []) {
+        const ranked = items.map(item => {
+            let score = 0;
+            const reasons = [];
+            // Priority score
+            const priorityScores = {
+                'P0': 10,
+                'P1': 7,
+                'P2': 5,
+                'P3': 3
+            };
+            const priorityScore = priorityScores[item.priority] || 3;
+            score += priorityScore;
+            reasons.push(`Priority ${item.priority} (${priorityScore} pts)`);
+            // Dependencies met
+            const unmetDeps = item.dependencies.filter(dep => !completedIncrements.includes(dep));
+            if (unmetDeps.length === 0 && item.dependencies.length > 0) {
+                score += 5;
+                reasons.push('All dependencies met (+5 pts)');
+            }
+            else if (unmetDeps.length > 0) {
+                reasons.push(`Blocked by: ${unmetDeps.join(', ')}`);
+            }
+            // Project match
+            if (currentProject && item.project === currentProject) {
+                score += 3;
+                reasons.push(`Project match: ${currentProject} (+3 pts)`);
+            }
+            // Recently created (bonus for new items)
+            if (item.created) {
+                const createdDate = new Date(item.created);
+                const daysSinceCreated = (Date.now() - createdDate.getTime()) / (1000 * 60 * 60 * 24);
+                if (daysSinceCreated < 7) {
+                    score += 2;
+                    reasons.push('Recently created (+2 pts)');
+                }
+            }
+            return {
+                ...item,
+                score,
+                reason: reasons.join('; ')
+            };
+        });
+        // Sort by score (descending)
+        return ranked.sort((a, b) => b.score - a.score);
+    }
+    /**
+     * Get top N recommendations
+     *
+     * @param n - Number of recommendations (default: 3)
+     * @param currentProject - Current project filter
+     * @param completedIncrements - Completed increments
+     * @returns Backlog recommendations
+     */
+    async getTopRecommendations(n = 3, currentProject, completedIncrements = []) {
+        const items = await this.scanBacklog();
+        const ranked = this.rankItems(items, currentProject, completedIncrements);
+        const topItems = ranked.slice(0, n);
+        let summary = '';
+        if (items.length === 0) {
+            summary = 'No items in backlog. Use /specweave:increment to create new work.';
+        }
+        else if (topItems.length === 0) {
+            summary = 'No actionable items found (all blocked by dependencies).';
+        }
+        else {
+            summary = `Found ${items.length} items in backlog. Top ${topItems.length} recommendations based on priority and dependencies.`;
+        }
+        return {
+            items: topItems,
+            totalItems: items.length,
+            summary
+        };
+    }
+}
+//# sourceMappingURL=backlog-scanner.js.map

package/dist/src/core/workflow/backlog-scanner.js.map

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

package/dist/src/core/workflow/command-invoker.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Command Invoker - Programmatic command execution
+ *
+ * Provides utilities to invoke SpecWeave commands programmatically
+ * from within the workflow orchestration system.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow/command-invoker
+ * @since v0.22.0
+ */
+/**
+ * Command invocation options
+ */
+export interface InvokeOptions {
+    /** Command arguments */
+    args?: string[];
+    /** Working directory */
+    cwd?: string;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Capture stdout */
+    captureOutput?: boolean;
+}
+/**
+ * Command invocation result
+ */
+export interface InvokeResult {
+    /** Command succeeded */
+    success: boolean;
+    /** Exit code */
+    exitCode: number;
+    /** Standard output */
+    stdout?: string;
+    /** Standard error */
+    stderr?: string;
+    /** Error message */
+    error?: string;
+    /** Execution time in milliseconds */
+    executionTime: number;
+}
+/**
+ * Error severity level
+ */
+export declare enum ErrorSeverity {
+    INFO = "info",
+    WARNING = "warning",
+    ERROR = "error",
+    CRITICAL = "critical"
+}
+/**
+ * Command Invoker - Execute SpecWeave commands programmatically
+ */
+export declare class CommandInvoker {
+    /**
+     * Invoke a SpecWeave command
+     *
+     * @param command - Command name (e.g., 'plan', 'do', 'validate')
+     * @param options - Invocation options
+     * @returns Command execution result
+     */
+    invoke(command: string, options?: InvokeOptions): Promise<InvokeResult>;
+    /**
+     * Invoke command with automatic retry on transient failures
+     *
+     * @param command - Command name
+     * @param options - Invocation options
+     * @param maxRetries - Maximum retry attempts (default: 3)
+     * @returns Command execution result
+     */
+    invokeWithRetry(command: string, options?: InvokeOptions, maxRetries?: number): Promise<InvokeResult>;
+    /**
+     * Classify error severity
+     *
+     * @param result - Command result
+     * @returns Error severity level
+     */
+    classifyError(result: InvokeResult): ErrorSeverity;
+    /**
+     * Delay execution
+     *
+     * @param ms - Milliseconds to delay
+     */
+    private delay;
+}
+//# sourceMappingURL=command-invoker.d.ts.map

package/dist/src/core/workflow/command-invoker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-invoker.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/command-invoker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB;;;;;;OAMG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAsCjF;;;;;;;OAOG;IACG,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,aAAkB,EAC3B,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC,YAAY,CAAC;IA+BxB;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa;IAqBlD;;;;OAIG;IACH,OAAO,CAAC,KAAK;CAGd"}