@blockspool/core 0.3.1 → 0.3.3

package/dist/scout/scanner.js

@@ -0,0 +1,164 @@
+/**
+ * File scanner - Discovers and reads files for analysis
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Default exclusion patterns
+ */
+const DEFAULT_EXCLUDES = [
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    'coverage',
+    '.next',
+    '.cache',
+    '*.min.js',
+    '*.map',
+    '*.lock',
+    'package-lock.json',
+    'yarn.lock',
+    'pnpm-lock.yaml',
+];
+/**
+ * Check if a path matches a simple glob pattern
+ *
+ * Supports:
+ * - ** for recursive matching
+ * - * for single segment matching
+ * - Direct path matching
+ */
+function matchesPattern(filePath, pattern) {
+    // Normalize paths
+    const normalizedPath = filePath.replace(/\\/g, '/');
+    const normalizedPattern = pattern.replace(/\\/g, '/');
+    // Direct match
+    if (normalizedPath === normalizedPattern) {
+        return true;
+    }
+    // Check if pattern is a directory prefix (without glob)
+    if (!normalizedPattern.includes('*') && normalizedPath.startsWith(normalizedPattern + '/')) {
+        return true;
+    }
+    // Simple glob matching
+    if (normalizedPattern.includes('*')) {
+        // Escape regex special chars except *
+        const escaped = normalizedPattern
+            .replace(/[.+^${}()|[\]\\]/g, '\\$&');
+        // Convert glob patterns to regex
+        // Note: **/ should be optional to match files directly in the directory
+        // e.g., src/services/**/*.ts should match both src/services/auditor.ts
+        // and src/services/sub/file.ts
+        const regexPattern = escaped
+            .replace(/\*\*\//g, '<<<DOUBLESTARSLASH>>>')
+            .replace(/\*\*/g, '<<<DOUBLESTAR>>>')
+            .replace(/\*/g, '[^/]*')
+            .replace(/<<<DOUBLESTARSLASH>>>/g, '(.*\\/)?')
+            .replace(/<<<DOUBLESTAR>>>/g, '.*');
+        const regex = new RegExp(`^${regexPattern}$`);
+        return regex.test(normalizedPath);
+    }
+    return false;
+}
+/**
+ * Check if a path should be excluded
+ */
+function shouldExclude(filePath, excludePatterns) {
+    const allExcludes = [...DEFAULT_EXCLUDES, ...excludePatterns];
+    for (const pattern of allExcludes) {
+        if (matchesPattern(filePath, pattern)) {
+            return true;
+        }
+        // Also check if any path segment matches (for things like node_modules)
+        const segments = filePath.split('/');
+        if (segments.some(seg => matchesPattern(seg, pattern))) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if a file matches any include pattern
+ */
+function shouldInclude(filePath, includePatterns) {
+    // If no patterns specified, include source-like files
+    if (includePatterns.length === 0) {
+        const ext = path.extname(filePath).toLowerCase();
+        return ['.ts', '.tsx', '.js', '.jsx', '.py', '.go', '.rs', '.java', '.rb', '.md'].includes(ext);
+    }
+    return includePatterns.some(pattern => matchesPattern(filePath, pattern));
+}
+/**
+ * Recursively scan directory for files
+ */
+function walkDir(dir, baseDir, options, files) {
+    const maxFileSize = options.maxFileSize ?? 100 * 1024; // 100KB
+    const maxFiles = options.maxFiles ?? 500;
+    if (files.length >= maxFiles) {
+        return;
+    }
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return; // Skip unreadable directories
+    }
+    for (const entry of entries) {
+        if (files.length >= maxFiles) {
+            break;
+        }
+        const fullPath = path.join(dir, entry.name);
+        const relativePath = path.relative(baseDir, fullPath);
+        // Check exclusions first
+        if (shouldExclude(relativePath, options.exclude ?? [])) {
+            continue;
+        }
+        if (entry.isDirectory()) {
+            walkDir(fullPath, baseDir, options, files);
+        }
+        else if (entry.isFile()) {
+            // Check inclusion
+            if (!shouldInclude(relativePath, options.include)) {
+                continue;
+            }
+            // Check file size
+            try {
+                const stat = fs.statSync(fullPath);
+                if (stat.size > maxFileSize) {
+                    continue;
+                }
+                // Read content
+                const content = fs.readFileSync(fullPath, 'utf-8');
+                files.push({
+                    path: relativePath,
+                    content,
+                    size: stat.size,
+                });
+            }
+            catch {
+                // Skip unreadable files
+            }
+        }
+    }
+}
+/**
+ * Scan a directory for files matching the given patterns
+ */
+export function scanFiles(options) {
+    const files = [];
+    walkDir(options.cwd, options.cwd, options, files);
+    return files;
+}
+/**
+ * Group files into batches for processing
+ */
+export function batchFiles(files, batchSize = 3) {
+    const batches = [];
+    for (let i = 0; i < files.length; i += batchSize) {
+        batches.push(files.slice(i, i + batchSize));
+    }
+    return batches;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scout/scanner.js.map

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

package/dist/scout/types.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Scout types - Shared type definitions for codebase scanning
+ */
+/**
+ * Proposal categories
+ */
+export type ProposalCategory = 'refactor' | 'docs' | 'test' | 'perf' | 'security';
+/**
+ * Complexity levels
+ */
+export type ComplexityLevel = 'trivial' | 'simple' | 'moderate' | 'complex';
+/**
+ * A ticket proposal generated by the scout
+ */
+export interface TicketProposal {
+    /** Unique ID (scout-{timestamp}-{random}) */
+    id: string;
+    /** Category of improvement */
+    category: ProposalCategory;
+    /** Short, actionable title */
+    title: string;
+    /** What needs to be done and why */
+    description: string;
+    /** Verifiable acceptance criteria */
+    acceptance_criteria: string[];
+    /** Commands to verify the fix */
+    verification_commands: string[];
+    /** Files that can be modified */
+    allowed_paths: string[];
+    /** Specific files identified for change */
+    files: string[];
+    /** Confidence score (0-100) */
+    confidence: number;
+    /** Impact score (1-10, optional) — how much this matters */
+    impact_score?: number;
+    /** Why this improvement matters */
+    rationale: string;
+    /** Estimated complexity */
+    estimated_complexity: ComplexityLevel;
+}
+/**
+ * Scout configuration options
+ */
+export interface ScoutOptions {
+    /** Glob pattern for files to scan (e.g., "src/**") */
+    scope: string;
+    /** Filter to specific categories */
+    types?: ProposalCategory[];
+    /** Categories to exclude */
+    excludeTypes?: ProposalCategory[];
+    /** Glob patterns to exclude */
+    exclude?: string[];
+    /** Maximum proposals to generate (default: 10) */
+    maxProposals?: number;
+    /** Minimum confidence threshold (default: 50) */
+    minConfidence?: number;
+    /** Working directory (default: cwd) */
+    projectPath?: string;
+    /** Timeout per batch in ms (default: 120000) */
+    timeoutMs?: number;
+    /** Cancellation signal */
+    signal?: AbortSignal;
+    /** Progress callback */
+    onProgress?: (progress: ScoutProgress) => void;
+    /** Recently completed ticket titles to avoid duplicates */
+    recentlyCompletedTitles?: string[];
+    /** Model to use (default: opus) */
+    model?: 'haiku' | 'sonnet' | 'opus';
+    /** Custom prompt from formula — tells the AI what to focus on */
+    customPrompt?: string;
+    /** Scout backend to use (default: ClaudeScoutBackend) */
+    backend?: import('./runner.js').ScoutBackend;
+    /** Files the scout can read but must NOT propose changes to */
+    protectedFiles?: string[];
+}
+/**
+ * Progress update during scanning
+ */
+export interface ScoutProgress {
+    /** Current phase */
+    phase: 'discovering' | 'analyzing' | 'generating' | 'complete';
+    /** Files scanned so far */
+    filesScanned: number;
+    /** Total files to scan */
+    totalFiles: number;
+    /** Proposals found so far */
+    proposalsFound: number;
+    /** Current batch number */
+    currentBatch: number;
+    /** Total batches */
+    totalBatches: number;
+    /** Current file being processed */
+    currentFile?: string;
+}
+/**
+ * Scout result
+ */
+export interface ScoutResult {
+    /** Whether the scan completed successfully */
+    success: boolean;
+    /** Generated proposals */
+    proposals: TicketProposal[];
+    /** Any errors encountered */
+    errors: string[];
+    /** Total files scanned */
+    scannedFiles: number;
+    /** Total scan duration in ms */
+    scanDurationMs: number;
+}
+/**
+ * Schema for validating LLM output
+ */
+export declare const PROPOSAL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly proposals: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["category", "title", "description", "acceptance_criteria", "verification_commands", "allowed_paths", "files", "confidence", "rationale", "estimated_complexity"];
+                readonly properties: {
+                    readonly category: {
+                        readonly type: "string";
+                        readonly enum: readonly ["refactor", "docs", "test", "perf", "security"];
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                    };
+                    readonly acceptance_criteria: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly verification_commands: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly allowed_paths: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly files: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly confidence: {
+                        readonly type: "number";
+                        readonly minimum: 0;
+                        readonly maximum: 100;
+                    };
+                    readonly impact_score: {
+                        readonly type: "number";
+                        readonly minimum: 1;
+                        readonly maximum: 10;
+                    };
+                    readonly rationale: {
+                        readonly type: "string";
+                    };
+                    readonly estimated_complexity: {
+                        readonly type: "string";
+                        readonly enum: readonly ["trivial", "simple", "moderate", "complex"];
+                    };
+                };
+            };
+        };
+    };
+    readonly required: readonly ["proposals"];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/scout/types.d.ts.map

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

package/dist/scout/types.js

@@ -0,0 +1,44 @@
+/**
+ * Scout types - Shared type definitions for codebase scanning
+ */
+/**
+ * Schema for validating LLM output
+ */
+export const PROPOSAL_SCHEMA = {
+    type: 'object',
+    properties: {
+        proposals: {
+            type: 'array',
+            items: {
+                type: 'object',
+                required: [
+                    'category',
+                    'title',
+                    'description',
+                    'acceptance_criteria',
+                    'verification_commands',
+                    'allowed_paths',
+                    'files',
+                    'confidence',
+                    'rationale',
+                    'estimated_complexity',
+                ],
+                properties: {
+                    category: { type: 'string', enum: ['refactor', 'docs', 'test', 'perf', 'security'] },
+                    title: { type: 'string' },
+                    description: { type: 'string' },
+                    acceptance_criteria: { type: 'array', items: { type: 'string' } },
+                    verification_commands: { type: 'array', items: { type: 'string' } },
+                    allowed_paths: { type: 'array', items: { type: 'string' } },
+                    files: { type: 'array', items: { type: 'string' } },
+                    confidence: { type: 'number', minimum: 0, maximum: 100 },
+                    impact_score: { type: 'number', minimum: 1, maximum: 10 },
+                    rationale: { type: 'string' },
+                    estimated_complexity: { type: 'string', enum: ['trivial', 'simple', 'moderate', 'complex'] },
+                },
+            },
+        },
+    },
+    required: ['proposals'],
+};
+//# sourceMappingURL=types.js.map

package/dist/scout/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scout/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkHH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,SAAS,EAAE;YACT,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE;oBACR,UAAU;oBACV,OAAO;oBACP,aAAa;oBACb,qBAAqB;oBACrB,uBAAuB;oBACvB,eAAe;oBACf,OAAO;oBACP,YAAY;oBACZ,WAAW;oBACX,sBAAsB;iBACvB;gBACD,UAAU,EAAE;oBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;oBACpF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC/B,mBAAmB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBACjE,qBAAqB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBACnE,aAAa,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBAC3D,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBACnD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE;oBACxD,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;oBACzD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC7B,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE;iBAC7F;aACF;SACF;KACF;IACD,QAAQ,EAAE,CAAC,WAAW,CAAC;CACf,CAAC"}

package/dist/services/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Service exports
+ *
+ * Services provide business logic orchestration.
+ * They use repositories for data access and are dependency-injected for testability.
+ */
+export { scoutRepo, approveProposals, type ScoutDeps, type ScoutRepoOptions, type ScoutRepoResult, type ScoutProgress, type GitService, type Logger, } from './scout.js';
+export type { ScoutBackend } from '../scout/index.js';
+export { runQa, getQaRunDetails, type QaDeps, type QaLogger, type QaCommand, type QaConfig, type QaArtifactsConfig, type QaRetryConfig, type QaRunOptions, type QaRunResult, } from './qa.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,MAAM,GACZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EACL,KAAK,EACL,eAAe,EACf,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,SAAS,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,9 @@
+/**
+ * Service exports
+ *
+ * Services provide business logic orchestration.
+ * They use repositories for data access and are dependency-injected for testability.
+ */
+export { scoutRepo, approveProposals, } from './scout.js';
+export { runQa, getQaRunDetails, } from './qa.js';
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,SAAS,EACT,gBAAgB,GAOjB,MAAM,YAAY,CAAC;AAIpB,OAAO,EACL,KAAK,EACL,eAAe,GAShB,MAAM,SAAS,CAAC"}

package/dist/services/qa.d.ts

@@ -0,0 +1,76 @@
+/**
+ * QA Service - Run local QA commands and record results
+ *
+ * This is pure orchestration: no FS writes, no raw SQL.
+ * Uses repos + ExecRunner for all operations.
+ */
+import type { DatabaseAdapter } from '../db/adapter.js';
+import type { ExecRunner } from '../exec/types.js';
+import * as runs from '../repos/runs.js';
+import * as runSteps from '../repos/run_steps.js';
+export interface QaLogger {
+    info: (msg: string) => void;
+    warn?: (msg: string) => void;
+    error: (msg: string) => void;
+    debug?: (msg: string) => void;
+}
+export interface QaCommand {
+    name: string;
+    cmd: string;
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+    timeoutMs?: number;
+}
+export interface QaArtifactsConfig {
+    dir: string;
+    maxLogBytes: number;
+    tailBytes: number;
+}
+export interface QaRetryConfig {
+    enabled: boolean;
+    maxAttempts: number;
+}
+export interface QaConfig {
+    commands: QaCommand[];
+    artifacts: QaArtifactsConfig;
+    retry: QaRetryConfig;
+}
+export interface QaDeps {
+    db: DatabaseAdapter;
+    exec: ExecRunner;
+    logger: QaLogger;
+}
+export interface QaRunOptions {
+    projectId: string;
+    repoRoot: string;
+    config: QaConfig;
+    maxAttemptsOverride?: number;
+    signal?: AbortSignal;
+}
+export interface QaRunResult {
+    runId: string;
+    projectId: string;
+    status: 'success' | 'failed' | 'canceled';
+    attempts: number;
+    latestAttempt: number;
+    failedAt?: {
+        attempt: number;
+        stepName: string;
+    };
+    startedAtMs: number;
+    endedAtMs: number;
+    durationMs: number;
+}
+/**
+ * Run QA commands and record results
+ */
+export declare function runQa(deps: QaDeps, opts: QaRunOptions): Promise<QaRunResult>;
+/**
+ * Get QA run details with step information
+ */
+export declare function getQaRunDetails(db: DatabaseAdapter, runId: string): Promise<{
+    run: runs.Run | null;
+    steps: runSteps.RunStep[];
+    summary: runSteps.StepSummary;
+} | null>;
+//# sourceMappingURL=qa.d.ts.map

package/dist/services/qa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa.d.ts","sourceRoot":"","sources":["../../src/services/qa.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAA0B,MAAM,kBAAkB,CAAC;AAE3E,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,QAAQ,MAAM,uBAAuB,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,eAAe,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAyBD;;GAEG;AACH,wBAAsB,KAAK,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,WAAW,CAAC,CAmOtB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,eAAe,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IACT,GAAG,EAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC1B,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC;CAC/B,GAAG,IAAI,CAAC,CAQR"}