@amsterdamdatalabs/enact-factory 0.1.1

package/dist/agents/pipelineGuards.js

@@ -0,0 +1,257 @@
+// ============================================
+// EnactFactory - Pipeline Guards
+// Quality gates and validation between executor/reviewer
+// ============================================
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { getRegistryStore } from '../registry/sqliteStore.js';
+import { scanFile as scanFileForBs } from '../registry/bsDetector.js';
+const execFileAsync = promisify(execFile);
+// Uncertainty Detection Patterns
+const UNCERTAINTY_PATTERNS = [
+    'maybe', 'might', 'probably', 'perhaps',
+    'workaround', 'hack', 'temporary fix', 'temp fix',
+    'not sure', 'not certain', 'unclear',
+    'i think', 'i believe', 'i assume',
+    'could be', 'seems like', 'appears to',
+    'not tested', 'untested', 'skip test',
+    'todo', 'fixme', 'xxx',
+];
+// Fake Data Detection Patterns
+const FAKE_DATA_PATTERNS = [
+    /faker\./i,
+    /\bnp\.random\b/,
+    /Math\.random\(\)/,
+    /lorem\s*ipsum/i,
+    /test@test\.com/i,
+    /foo@bar\.com/i,
+    /mockData\b/i,
+    /dummy\s*data/i,
+    /placeholder\s*text/i,
+    /sample\s*data/i,
+];
+// Conventional Commit Pattern
+const CONVENTIONAL_COMMIT_RE = /^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\(.+\))?!?:\s.+/;
+// Branch Name Patterns
+const VALID_BRANCH_PATTERNS = [
+    /^factory\/.+/,
+    /^feature\/.+/,
+    /^release\/v.+/,
+    /^hotfix\/.+/,
+    /^main$/,
+    /^develop$/,
+];
+// Guard Functions
+/**
+ * Quality gate: run tsc --noEmit on TypeScript files or ruff check on Python files.
+ * Blocking — failure causes a revise.
+ */
+async function runQualityGate(executorResult, projectPath) {
+    const guard = 'qualityGate';
+    const workItems = [];
+    const tsFiles = executorResult.filesChanged.filter(f => f.endsWith('.ts') || f.endsWith('.tsx'));
+    const pyFiles = executorResult.filesChanged.filter(f => f.endsWith('.py'));
+    if (tsFiles.length > 0) {
+        try {
+            await execFileAsync('npx', ['tsc', '--noEmit'], {
+                cwd: projectPath,
+                timeout: 60_000,
+            });
+        }
+        catch (err) {
+            const execErr = err;
+            const stderr = execErr.stderr || execErr.stdout || String(err);
+            workItems.push(`TypeScript check failed: ${stderr.slice(0, 500)}`);
+        }
+    }
+    if (pyFiles.length > 0) {
+        try {
+            await execFileAsync('ruff', ['check', ...pyFiles], {
+                cwd: projectPath,
+                timeout: 60_000,
+            });
+        }
+        catch (err) {
+            const execErr = err;
+            const stderr = execErr.stderr || execErr.stdout || String(err);
+            workItems.push(`Ruff check failed: ${stderr.slice(0, 500)}`);
+        }
+    }
+    return { passed: workItems.length === 0, guard, workItems, blocking: true };
+}
+/**
+ * Fake data guard: detect faker, random, mock data patterns in changed output.
+ * Non-blocking — warning only.
+ */
+function runFakeDataGuard(executorResult) {
+    const guard = 'fakeDataGuard';
+    const workItems = [];
+    const textToScan = executorResult.output.slice(0, 5000);
+    for (const pattern of FAKE_DATA_PATTERNS) {
+        const match = textToScan.match(pattern);
+        if (match) {
+            workItems.push(`Possible fake/mock data detected: "${match[0]}"`);
+        }
+    }
+    return { passed: workItems.length === 0, guard, workItems, blocking: false };
+}
+/**
+ * Conventional commit guard: validate commit message format.
+ * Non-blocking — warning only.
+ */
+export function runConventionalCommitGuard(commitMessage) {
+    const guard = 'conventionalCommits';
+    const workItems = [];
+    const firstLine = commitMessage.split('\n')[0].trim();
+    if (!CONVENTIONAL_COMMIT_RE.test(firstLine)) {
+        workItems.push(`Commit message does not follow conventional format: "${firstLine.slice(0, 80)}". ` +
+            `Expected: type(scope): description`);
+    }
+    return { passed: workItems.length === 0, guard, workItems, blocking: false };
+}
+/**
+ * Branch name guard: validate branch naming convention.
+ * Non-blocking — warning only.
+ */
+async function runBranchNameGuard(projectPath) {
+    const guard = 'branchValidation';
+    const workItems = [];
+    try {
+        const { stdout } = await execFileAsync('git', ['branch', '--show-current'], {
+            cwd: projectPath,
+            timeout: 5_000,
+        });
+        const branch = stdout.trim();
+        if (branch && !VALID_BRANCH_PATTERNS.some(p => p.test(branch))) {
+            workItems.push(`Branch "${branch}" does not match allowed patterns: factory/*, feature/*, release/v*, hotfix/*, main, develop`);
+        }
+    }
+    catch {
+        // git not available or not in repo — skip silently
+    }
+    return { passed: workItems.length === 0, guard, workItems, blocking: false };
+}
+/**
+ * Uncertainty detection: scan executor output for uncertainty phrases.
+ * Non-blocking — populates uncertaintySignals on ExecutorResult.
+ */
+function runUncertaintyDetection(executorResult) {
+    const guard = 'uncertaintyDetection';
+    const workItems = [];
+    const textToScan = (executorResult.summary + ' ' + executorResult.output.slice(0, 2000)).toLowerCase();
+    const detected = [];
+    for (const phrase of UNCERTAINTY_PATTERNS) {
+        if (textToScan.includes(phrase)) {
+            detected.push(phrase);
+        }
+    }
+    if (detected.length > 0) {
+        workItems.push(`Uncertainty signals detected: ${detected.join(', ')}`);
+        // Populate on the result for downstream use
+        executorResult.uncertaintySignals = detected;
+    }
+    return { passed: workItems.length === 0, guard, workItems, blocking: false };
+}
+/**
+ * Registry check: scan changed files against code registry.
+ * Non-blocking — warns about deprecated/broken entities being modified,
+ * untested entities being added, or active warnings on touched code.
+ */
+function runRegistryCheck(executorResult) {
+    const guard = 'registryCheck';
+    const workItems = [];
+    try {
+        const store = getRegistryStore();
+        for (const filePath of executorResult.filesChanged) {
+            const brief = store.fileBrief(filePath);
+            if (brief.entities.length === 0)
+                continue;
+            // deprecated 엔티티가 있는 파일 수정 시 경고
+            const deprecated = brief.entities.filter(e => e.status === 'deprecated');
+            if (deprecated.length > 0) {
+                workItems.push(`[${filePath}] ${deprecated.length} deprecated entity modified: ` +
+                    deprecated.map(e => `${e.name}${e.deprecatedReason ? ` (${e.deprecatedReason})` : ''}`).join(', '));
+            }
+            // broken 엔티티가 있는 파일 수정 시 경고
+            const broken = brief.entities.filter(e => e.status === 'broken');
+            if (broken.length > 0) {
+                workItems.push(`[${filePath}] ${broken.length} broken entity: ${broken.map(e => e.name).join(', ')}`);
+            }
+            // 미해결 critical/error 경고가 있는 엔티티
+            const withCriticalWarnings = brief.entities.filter(e => e.warnings.some(w => !w.resolved && (w.severity === 'critical' || w.severity === 'error')));
+            if (withCriticalWarnings.length > 0) {
+                for (const e of withCriticalWarnings) {
+                    const criticals = e.warnings.filter(w => !w.resolved && (w.severity === 'critical' || w.severity === 'error'));
+                    workItems.push(`[${filePath}] ${e.name}: ${criticals.map(w => `${w.severity}/${w.category}: ${w.message}`).join('; ')}`);
+                }
+            }
+            // high-risk + untested 조합 경고
+            const riskyUntested = brief.entities.filter(e => e.riskLevel === 'high' && !e.hasTests && e.status === 'active');
+            if (riskyUntested.length > 0) {
+                workItems.push(`[${filePath}] ${riskyUntested.length} high-risk untested: ${riskyUntested.map(e => e.name).join(', ')}`);
+            }
+        }
+    }
+    catch (err) {
+        // 레지스트리 DB가 없거나 접근 불가 시 무시
+        console.warn('[Guard:registryCheck] Registry unavailable:', err);
+    }
+    return { passed: workItems.length === 0, guard, workItems, blocking: false };
+}
+/**
+ * BS Detector guard: scan changed files for BS patterns in actual source code.
+ * CRITICAL BS → blocking. WARNING/MINOR → non-blocking.
+ */
+async function runBsDetectorGuard(executorResult, projectPath) {
+    const guard = 'bsDetector';
+    const workItems = [];
+    let hasCritical = false;
+    try {
+        const { join } = await import('node:path');
+        for (const filePath of executorResult.filesChanged) {
+            const fullPath = join(projectPath, filePath);
+            const bsWorkItems = await scanFileForBs(fullPath);
+            for (const bs of bsWorkItems) {
+                const prefix = bs.severity === 'critical' ? 'CRITICAL' : bs.severity === 'warning' ? 'WARNING' : 'MINOR';
+                workItems.push(`[${prefix}] ${filePath}:${bs.line} — ${bs.message} (${bs.matchedText})`);
+                if (bs.severity === 'critical')
+                    hasCritical = true;
+            }
+        }
+    }
+    catch (err) {
+        console.warn('[Guard:bsDetector] Error:', err);
+    }
+    return { passed: workItems.length === 0, guard, workItems, blocking: hasCritical };
+}
+// Guard Runner
+/**
+ * Run all enabled guards on a executor result.
+ */
+export async function runGuards(executorResult, projectPath, config) {
+    const results = [];
+    if (config.qualityGate) {
+        results.push(await runQualityGate(executorResult, projectPath));
+    }
+    if (config.fakeDataGuard) {
+        results.push(runFakeDataGuard(executorResult));
+    }
+    if (config.branchValidation) {
+        results.push(await runBranchNameGuard(projectPath));
+    }
+    if (config.uncertaintyDetection) {
+        results.push(runUncertaintyDetection(executorResult));
+    }
+    if (config.registryCheck) {
+        results.push(runRegistryCheck(executorResult));
+    }
+    if (config.bsDetector) {
+        results.push(await runBsDetectorGuard(executorResult, projectPath));
+    }
+    // conventionalCommits is checked separately (needs commit message)
+    // haltToAzdo is handled by the pipeline, not a guard function
+    const combinedWorkItems = results.flatMap(r => r.workItems);
+    const allPassed = results.every(r => r.passed || !r.blocking);
+    return { allPassed, results, combinedWorkItems };
+}
+//# sourceMappingURL=pipelineGuards.js.map

package/dist/agents/pipelineGuards.js.map

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

package/dist/agents/reviewer.d.ts

@@ -0,0 +1,37 @@
+import type { ExecutorResult, ReviewResult } from '../agents/agentPair.js';
+import type { AdapterName, ProcessContext } from '../adapters/types.js';
+export interface ReviewerOptions {
+    workItemTitle: string;
+    workItemDescription: string;
+    executorResult: ExecutorResult;
+    projectPath: string;
+    timeoutMs?: number;
+    model?: string;
+    maxTurns?: number;
+    adapterName?: AdapterName;
+    processContext?: ProcessContext;
+}
+export interface PreCheckResult {
+    passed: boolean;
+    workItems: string[];
+    confidence: number;
+}
+/**
+ * Run fast pre-check validation with Haiku model
+ * This is a cheap filter before expensive Sonnet review
+ * Expected to catch 30-40% of obvious workItems, saving ~35% on review costs
+ */
+export declare function runPreCheck(options: ReviewerOptions): Promise<PreCheckResult>;
+/**
+ * Run Reviewer agent (full review with Sonnet)
+ */
+export declare function runReviewer(options: ReviewerOptions): Promise<ReviewResult>;
+/**
+ * Format Reviewer result as a Discord message
+ */
+export declare function formatReviewFeedback(result: ReviewResult): string;
+/**
+ * Convert Reviewer feedback into revision instructions for Executor
+ */
+export declare function buildRevisionPrompt(result: ReviewResult): string;
+//# sourceMappingURL=reviewer.d.ts.map

package/dist/agents/reviewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewer.d.ts","sourceRoot":"","sources":["../../src/agents/reviewer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMvE,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AA4ED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAgEnF;AAID;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CA2BjF;AAID;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAoCjE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAOhE"}

package/dist/agents/reviewer.js

@@ -0,0 +1,214 @@
+// ============================================
+// EnactFactory - Reviewer Agent
+// Code review agent (CLI adapter based)
+// ============================================
+import { t, getPrompts } from '../locale/index.js';
+import { getAdapter, spawnCli } from '../adapters/index.js';
+import { expandPath } from '../core/config.js';
+// Prompts
+/**
+ * Build Pre-Check prompt for fast validation (Haiku)
+ */
+function buildPreCheckPrompt(options) {
+    const files = options.executorResult.filesChanged;
+    const filesSummary = files.length <= 20
+        ? (files.join(', ') || '(none)')
+        : `${files.slice(0, 20).join(', ')} (+${files.length - 20} more)`;
+    return `You are a fast pre-check validator. Perform a quick validation of the Executor's output.
+
+## WorkItem
+${options.workItemTitle}
+
+## Executor Result
+- Success: ${options.executorResult.success}
+- Files Changed (${files.length}): ${filesSummary}
+- Summary: ${options.executorResult.summary}
+
+## Your Job (Fast Check Only)
+Check for OBVIOUS problems:
+1. **Syntax Errors**: Are there any clear syntax errors in the output?
+2. **Missing Files**: Did the executor claim to create/modify files that don't exist?
+3. **Incomplete Output**: Does the output look cut off or incomplete?
+4. **Basic Format WorkItems**: Are there obvious formatting problems?
+
+**DO NOT** perform deep logical review - that's for the next stage.
+
+## Response Format
+Respond in this EXACT format:
+
+PASSED: [yes/no]
+CONFIDENCE: [0-3]
+WORKITEMS:
+- [workItem 1]
+- [workItem 2]
+...
+
+Keep it brief. This is a fast filter, not a deep review.`;
+}
+/**
+ * Build Reviewer prompt using locale templates
+ */
+function buildReviewerPrompt(options) {
+    const files = options.executorResult.filesChanged;
+    const filesSummary = files.length <= 20
+        ? (files.join(', ') || '(none)')
+        : `${files.slice(0, 20).join(', ')} (+${files.length - 20} more)`;
+    const cmds = options.executorResult.commands;
+    const cmdsSummary = cmds.length <= 10
+        ? (cmds.join(', ') || '(none)')
+        : `${cmds.slice(0, 10).join(', ')} (+${cmds.length - 10} more)`;
+    const executorReport = `
+- **Success:** ${options.executorResult.success}
+- **Summary:** ${options.executorResult.summary}
+- **Files Changed (${files.length}):** ${filesSummary}
+- **Commands:** ${cmdsSummary}
+${options.executorResult.error ? `- **Error:** ${options.executorResult.error}` : ''}
+`;
+    return getPrompts().buildReviewerPrompt({
+        workItemTitle: options.workItemTitle,
+        workItemDescription: options.workItemDescription,
+        executorReport,
+    });
+}
+// Pre-Check Execution (Fast Validation with Haiku)
+/**
+ * Run fast pre-check validation with Haiku model
+ * This is a cheap filter before expensive Sonnet review
+ * Expected to catch 30-40% of obvious workItems, saving ~35% on review costs
+ */
+export async function runPreCheck(options) {
+    const prompt = buildPreCheckPrompt(options);
+    const cwd = expandPath(options.projectPath);
+    const adapter = getAdapter(options.adapterName);
+    try {
+        // Use Haiku for fast validation
+        const raw = await spawnCli(adapter, {
+            prompt,
+            cwd,
+            timeoutMs: 30000, // 30 seconds max for pre-check
+            model: options.model,
+            maxTurns: options.maxTurns,
+            processContext: options.processContext,
+        });
+        // DEBUG: Log raw Haiku output for troubleshooting
+        console.log('[Reviewer] Pre-check raw output (first 500 chars):', raw.stdout.slice(0, 500));
+        // Parse pre-check output
+        const lines = raw.stdout.split('\n');
+        const passedLine = lines.find((l) => l.startsWith('PASSED:'));
+        const confidenceLine = lines.find((l) => l.startsWith('CONFIDENCE:'));
+        const passed = passedLine?.includes('yes') ?? false;
+        const confidence = parseInt(confidenceLine?.split(':')[1]?.trim() || '1', 10);
+        const workItemStart = lines.findIndex((l) => l.startsWith('WORKITEMS:'));
+        const workItems = workItemStart >= 0
+            ? lines.slice(workItemStart + 1)
+                .filter((l) => l.trim().startsWith('-'))
+                .map((l) => l.replace(/^-\s*/, '').trim())
+                .filter(Boolean)
+            : [];
+        // DEBUG: Log parsing results
+        if (!passed && workItems.length === 0) {
+            console.warn('[Reviewer] Pre-check failed but no workItems found. Haiku may not be following format.');
+            console.warn('[Reviewer] PASSED line:', passedLine || '(not found)');
+            console.warn('[Reviewer] WORKITEMS section:', workItemStart >= 0 ? 'found' : 'not found');
+            // Provide better default error message
+            if (!passedLine) {
+                workItems.push('Haiku did not provide PASSED: line in expected format');
+            }
+            if (workItemStart < 0) {
+                workItems.push('Haiku did not provide WORKITEMS: section in expected format');
+            }
+        }
+        return {
+            passed,
+            workItems: workItems.length > 0 ? workItems : ['Pre-check failed with no specific workItems (format parsing error)'],
+            confidence: Math.min(3, Math.max(0, confidence)),
+        };
+    }
+    catch (error) {
+        // If pre-check fails, allow proceeding to full review
+        console.warn('[Reviewer] Pre-check failed, proceeding to full review:', error);
+        return {
+            passed: true, // Don't block on pre-check failure
+            workItems: ['Pre-check timed out or failed'],
+            confidence: 0,
+        };
+    }
+}
+// Reviewer Execution
+/**
+ * Run Reviewer agent (full review with Sonnet)
+ */
+export async function runReviewer(options) {
+    const prompt = buildReviewerPrompt(options);
+    const cwd = expandPath(options.projectPath);
+    const adapter = getAdapter(options.adapterName);
+    try {
+        // Run CLI via adapter
+        const raw = await spawnCli(adapter, {
+            prompt,
+            cwd,
+            timeoutMs: options.timeoutMs ?? 180000, // 3 min default (review is faster)
+            model: options.model,
+            maxTurns: options.maxTurns,
+            processContext: options.processContext,
+            systemPrompt: getPrompts().systemPrompt,
+        });
+        // Parse result via adapter
+        return adapter.parseReviewerOutput(raw);
+    }
+    catch (error) {
+        return {
+            decision: 'reject',
+            feedback: `Reviewer execution failed: ${error instanceof Error ? error.message : String(error)}`,
+            workItems: ['Error occurred during reviewer agent execution'],
+            suggestions: ['Manual review required'],
+        };
+    }
+}
+// Formatting
+/**
+ * Format Reviewer result as a Discord message
+ */
+export function formatReviewFeedback(result) {
+    const decisionEmoji = {
+        approve: '✅',
+        revise: '🔄',
+        reject: '❌',
+    }[result.decision];
+    const decisionText = {
+        approve: 'APPROVED',
+        revise: 'REVISION NEEDED',
+        reject: 'REJECTED',
+    }[result.decision];
+    const lines = [];
+    lines.push(`${decisionEmoji} ${t('agents.reviewer.report.decision', { text: decisionText })}`);
+    lines.push('');
+    lines.push(t('agents.reviewer.report.feedback', { text: result.feedback }));
+    if (result.workItems && result.workItems.length > 0) {
+        lines.push('');
+        lines.push(t('agents.reviewer.report.workItems'));
+        for (const workItem of result.workItems.slice(0, 5)) {
+            lines.push(`  • ${workItem}`);
+        }
+    }
+    if (result.suggestions && result.suggestions.length > 0) {
+        lines.push('');
+        lines.push(t('agents.reviewer.report.suggestions'));
+        for (const suggestion of result.suggestions.slice(0, 5)) {
+            lines.push(`  • ${suggestion}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Convert Reviewer feedback into revision instructions for Executor
+ */
+export function buildRevisionPrompt(result) {
+    return getPrompts().buildRevisionPromptFromReview({
+        decision: result.decision,
+        feedback: result.feedback,
+        workItems: result.workItems || [],
+        suggestions: result.suggestions || [],
+    });
+}
+//# sourceMappingURL=reviewer.js.map

package/dist/agents/reviewer.js.map

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

package/dist/agents/skillDocumenter.d.ts

@@ -0,0 +1,23 @@
+import type { ExecutorResult } from '../agents/agentPair.js';
+import type { AdapterName } from '../adapters/types.js';
+import { type CostInfo } from '../support/costTracker.js';
+export interface SkillDocumenterOptions {
+    workItemTitle: string;
+    workItemDescription: string;
+    executorResult: ExecutorResult;
+    projectPath: string;
+    timeoutMs?: number;
+    model?: string;
+    maxTurns?: number;
+    adapterName?: AdapterName;
+}
+export interface SkillDocumenterResult {
+    success: boolean;
+    updatedFiles: string[];
+    summary: string;
+    error?: string;
+    costInfo?: CostInfo;
+}
+export declare function runSkillDocumenter(options: SkillDocumenterOptions): Promise<SkillDocumenterResult>;
+export declare function formatSkillDocReport(result: SkillDocumenterResult): string;
+//# sourceMappingURL=skillDocumenter.d.ts.map

package/dist/agents/skillDocumenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillDocumenter.d.ts","sourceRoot":"","sources":["../../src/agents/skillDocumenter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,KAAK,QAAQ,EAAyC,MAAM,0BAA0B,CAAC;AAKhG,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAuDD,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAuBxG;AAoID,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAmB1E"}