circle-ir-ai 1.1.0

package/dist/specifica/feature-clustering.js

@@ -0,0 +1,231 @@
+/**
+ * Feature Clustering
+ *
+ * Groups related files into features for multi-file spec generation.
+ */
+import * as path from 'path';
+/**
+ * Cluster files into features based on package, naming, and dependencies
+ */
+export function clusterFilesByFeature(evidenceList, rootDir) {
+    const clusters = new Map();
+    // Strategy 1: Package-based clustering (Java, etc.)
+    const packageClusters = clusterByPackage(evidenceList, rootDir);
+    for (const cluster of packageClusters) {
+        clusters.set(cluster.name, cluster);
+    }
+    // Strategy 2: Directory-based clustering (JS/TS, Python)
+    if (clusters.size === 0) {
+        const dirClusters = clusterByDirectory(evidenceList, rootDir);
+        for (const cluster of dirClusters) {
+            clusters.set(cluster.name, cluster);
+        }
+    }
+    // Strategy 3: Naming pattern clustering
+    const nameClusters = clusterByNaming(evidenceList);
+    mergeClusters(clusters, nameClusters);
+    // If no clustering worked, create one cluster per file
+    if (clusters.size === 0) {
+        for (const evidence of evidenceList) {
+            const name = extractFeatureNameFromFile(evidence.filePath);
+            clusters.set(name, {
+                name,
+                files: [evidence.filePath],
+                evidence: [evidence],
+                confidence: 0.5,
+                clusteringMethod: 'naming',
+            });
+        }
+    }
+    return Array.from(clusters.values());
+}
+/**
+ * Cluster by Java package structure
+ */
+function clusterByPackage(evidenceList, rootDir) {
+    const clusters = new Map();
+    for (const evidence of evidenceList) {
+        // Only works for languages with explicit packages
+        if (evidence.language !== 'java')
+            continue;
+        // Extract package from imports/types
+        const packageName = extractPackageName(evidence);
+        if (!packageName)
+            continue;
+        // Group by last segment of package (e.g., com.example.user -> user)
+        const feature = packageName.split('.').pop() || 'unknown';
+        if (!clusters.has(feature)) {
+            clusters.set(feature, []);
+        }
+        clusters.get(feature).push(evidence);
+    }
+    return Array.from(clusters.entries()).map(([name, evidence]) => ({
+        name,
+        files: evidence.map(e => e.filePath),
+        evidence,
+        confidence: 0.9,
+        clusteringMethod: 'package',
+    }));
+}
+/**
+ * Cluster by directory structure
+ */
+function clusterByDirectory(evidenceList, rootDir) {
+    const clusters = new Map();
+    for (const evidence of evidenceList) {
+        // Get directory relative to root
+        const relativePath = path.relative(rootDir, evidence.filePath);
+        const dir = path.dirname(relativePath);
+        // Use last directory segment as feature name
+        const segments = dir.split(path.sep);
+        const feature = segments[segments.length - 1] || 'root';
+        if (!clusters.has(feature)) {
+            clusters.set(feature, []);
+        }
+        clusters.get(feature).push(evidence);
+    }
+    return Array.from(clusters.entries()).map(([name, evidence]) => ({
+        name,
+        files: evidence.map(e => e.filePath),
+        evidence,
+        confidence: 0.7,
+        clusteringMethod: 'directory',
+    }));
+}
+/**
+ * Cluster by naming patterns (UserController, UserService -> user)
+ */
+function clusterByNaming(evidenceList) {
+    const clusters = new Map();
+    for (const evidence of evidenceList) {
+        const fileName = path.basename(evidence.filePath, path.extname(evidence.filePath));
+        // Extract feature name from file name
+        const feature = extractFeatureNameFromFile(fileName);
+        if (!clusters.has(feature)) {
+            clusters.set(feature, []);
+        }
+        clusters.get(feature).push(evidence);
+    }
+    return Array.from(clusters.entries()).map(([name, evidence]) => ({
+        name,
+        files: evidence.map(e => e.filePath),
+        evidence,
+        confidence: 0.6,
+        clusteringMethod: 'naming',
+    }));
+}
+/**
+ * Merge naming-based clusters into existing clusters
+ */
+function mergeClusters(existing, newClusters) {
+    for (const newCluster of newClusters) {
+        if (existing.has(newCluster.name)) {
+            // Merge evidence from naming cluster into existing
+            const existingCluster = existing.get(newCluster.name);
+            // Add files that aren't already in the cluster
+            for (const evidence of newCluster.evidence) {
+                if (!existingCluster.files.includes(evidence.filePath)) {
+                    existingCluster.files.push(evidence.filePath);
+                    existingCluster.evidence.push(evidence);
+                }
+            }
+            // Update confidence (max of both methods)
+            existingCluster.confidence = Math.max(existingCluster.confidence, newCluster.confidence);
+        }
+    }
+}
+/**
+ * Extract package name from evidence
+ */
+function extractPackageName(evidence) {
+    // Try to find package from imports
+    for (const imp of evidence.imports) {
+        if (imp.module && imp.module.includes('.')) {
+            // Return package without the class name
+            const parts = imp.module.split('.');
+            return parts.slice(0, -1).join('.');
+        }
+    }
+    // Try to infer from file path
+    const segments = evidence.filePath.split('/');
+    const javaIndex = segments.findIndex(s => s === 'java');
+    if (javaIndex !== -1 && javaIndex < segments.length - 2) {
+        return segments.slice(javaIndex + 1, -1).join('.');
+    }
+    return null;
+}
+/**
+ * Extract feature name from file name
+ * Examples:
+ *   UserController -> user
+ *   OrderService -> order
+ *   product-repository -> product
+ */
+function extractFeatureNameFromFile(fileName) {
+    // Remove common suffixes
+    const cleaned = fileName
+        .replace(/Controller$/i, '')
+        .replace(/Service$/i, '')
+        .replace(/Repository$/i, '')
+        .replace(/Handler$/i, '')
+        .replace(/Manager$/i, '')
+        .replace(/Impl$/i, '')
+        .replace(/Model$/i, '')
+        .replace(/Entity$/i, '');
+    // Convert to kebab-case
+    return cleaned
+        .replace(/([A-Z])/g, '-$1')
+        .toLowerCase()
+        .replace(/^-/, '')
+        .replace(/_/g, '-')
+        .replace(/\s+/g, '-');
+}
+/**
+ * Filter clusters to only include those with multiple files or significant size
+ */
+export function filterSignificantClusters(clusters, minFiles = 1) {
+    return clusters.filter(cluster => {
+        // Include if it has enough files
+        if (cluster.files.length >= minFiles) {
+            return true;
+        }
+        // Include if single file but has significant content
+        if (cluster.files.length === 1) {
+            const evidence = cluster.evidence[0];
+            const hasAPI = evidence.publicAPI.length > 0;
+            const hasMethods = evidence.methods.length > 3;
+            const hasVulns = evidence.vulnerabilities.length > 0;
+            return hasAPI || hasMethods || hasVulns;
+        }
+        return false;
+    });
+}
+/**
+ * Sort clusters by importance (API endpoints, method count, vulnerabilities)
+ */
+export function sortClustersByImportance(clusters) {
+    return clusters.sort((a, b) => {
+        // Calculate importance score
+        const scoreA = calculateImportance(a);
+        const scoreB = calculateImportance(b);
+        return scoreB - scoreA;
+    });
+}
+/**
+ * Calculate importance score for a cluster
+ */
+function calculateImportance(cluster) {
+    let score = 0;
+    for (const evidence of cluster.evidence) {
+        score += evidence.publicAPI.length * 10; // API endpoints are high value
+        score += evidence.methods.length * 1;
+        score += evidence.vulnerabilities.length * 5; // Security issues matter
+        score += evidence.types.length * 2;
+    }
+    // Bonus for multiple files (indicates larger feature)
+    if (cluster.files.length > 1) {
+        score += cluster.files.length * 5;
+    }
+    return score;
+}
+//# sourceMappingURL=feature-clustering.js.map

package/dist/specifica/feature-clustering.js.map

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

package/dist/specifica/generator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Specifica Generator
+ *
+ * Main orchestrator for generating Specifica specifications from code
+ */
+import type { SpecificaOptions, SpecificaOutput } from './types.js';
+/**
+ * Generate Specifica specification from a single file
+ */
+export declare function generateSpecifica(filePath: string, options?: SpecificaOptions): Promise<SpecificaOutput>;
+/**
+ * Generate Specifica for multiple files (directory)
+ * Phase 2: Feature clustering and multi-file analysis
+ */
+export declare function generateSpecificaForDirectory(dirPath: string, options?: SpecificaOptions): Promise<SpecificaOutput[]>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/specifica/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/specifica/generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAEhB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA6D1B;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,EAAE,CAAC,CA+H5B"}

package/dist/specifica/generator.js

@@ -0,0 +1,277 @@
+/**
+ * Specifica Generator
+ *
+ * Main orchestrator for generating Specifica specifications from code
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { analyze } from 'circle-ir';
+import { extractEvidence } from './evidence-extractor.js';
+import { generateSpec, formatSpecMarkdown } from './spec-generator.js';
+import { resolveConflict } from './conflict-resolver.js';
+/**
+ * Generate Specifica specification from a single file
+ */
+export async function generateSpecifica(filePath, options = {}) {
+    // Read source code
+    const code = fs.readFileSync(filePath, 'utf-8');
+    // Determine output directory (default: project root)
+    const outputDir = options.outputDir || findProjectRoot(filePath);
+    const specificaDir = path.join(outputDir, '.specifica');
+    // Run Circle-IR analysis (reuse existing if available)
+    const language = options.language || detectLanguage(filePath);
+    const analysis = await analyze(code, filePath, language, {
+    // AnalyzerOptions doesn't have enableLLMEnrichment
+    // LLM enrichment is handled separately in circle-ir-ai
+    });
+    // Extract evidence
+    const evidence = extractEvidence(filePath, code, analysis);
+    // Generate spec.md
+    const { spec, method, model } = await generateSpec(evidence, options);
+    // Determine feature name and output path
+    const featureName = generateFeatureName(evidence.filePath);
+    const featureDir = path.join(specificaDir, featureName);
+    const specPath = path.join(featureDir, 'spec.md');
+    // Check for conflicts
+    if (fs.existsSync(specPath) && !options.overwrite) {
+        const resolution = await resolveConflict(specPath, {
+            strategy: 'prompt',
+            backup: true,
+        });
+        if (resolution === 'skip') {
+            throw new Error(`Spec already exists at ${specPath}. Use --overwrite to replace.`);
+        }
+    }
+    // Create output directory
+    fs.mkdirSync(featureDir, { recursive: true });
+    // Format and write spec.md
+    const metadata = {
+        generatedAt: new Date().toISOString(),
+        generator: 'circle-ir-ai/specifica',
+        version: getVersion(),
+        model: model || 'static-generation',
+        filesAnalyzed: 1,
+        reviewRequired: true,
+    };
+    const markdown = formatSpecMarkdown(spec, { reviewRequired: true });
+    fs.writeFileSync(specPath, markdown, 'utf-8');
+    return {
+        featureName,
+        outputPath: featureDir,
+        spec,
+        metadata,
+        generationMethod: method,
+    };
+}
+/**
+ * Generate Specifica for multiple files (directory)
+ * Phase 2: Feature clustering and multi-file analysis
+ */
+export async function generateSpecificaForDirectory(dirPath, options = {}) {
+    const { clusterFilesByFeature, filterSignificantClusters, sortClustersByImportance } = await import('./feature-clustering.js');
+    const { aggregateEvidence } = await import('./evidence-aggregator.js');
+    // Find all source files in directory
+    const files = collectSourceFiles(dirPath);
+    if (files.length === 0) {
+        throw new Error(`No source files found in ${dirPath}`);
+    }
+    if (!options.quiet) {
+        console.log(`Found ${files.length} source files`);
+    }
+    // Analyze each file
+    const evidenceList = [];
+    for (let i = 0; i < files.length; i++) {
+        const file = files[i];
+        if (!options.quiet) {
+            console.log(`[${i + 1}/${files.length}] Analyzing ${path.basename(file)}...`);
+        }
+        try {
+            const code = fs.readFileSync(file, 'utf-8');
+            const language = detectLanguage(file);
+            const analysis = await analyze(code, file, language, {});
+            const evidence = extractEvidence(file, code, analysis);
+            evidenceList.push(evidence);
+        }
+        catch (error) {
+            console.error(`Failed to analyze ${file}:`, error instanceof Error ? error.message : String(error));
+        }
+    }
+    if (evidenceList.length === 0) {
+        throw new Error('Failed to analyze any files');
+    }
+    // Cluster files into features
+    if (!options.quiet) {
+        console.log('\nClustering files into features...');
+    }
+    let clusters = clusterFilesByFeature(evidenceList, dirPath);
+    clusters = filterSignificantClusters(clusters);
+    clusters = sortClustersByImportance(clusters);
+    if (!options.quiet) {
+        console.log(`Found ${clusters.length} features:\n`);
+        for (const cluster of clusters) {
+            console.log(`  - ${cluster.name} (${cluster.files.length} files, ${cluster.clusteringMethod})`);
+        }
+        console.log('');
+    }
+    // Generate specs for each cluster
+    const outputs = [];
+    for (let i = 0; i < clusters.length; i++) {
+        const cluster = clusters[i];
+        if (!options.quiet) {
+            console.log(`[${i + 1}/${clusters.length}] Generating spec for ${cluster.name}...`);
+        }
+        try {
+            // Aggregate evidence from all files in cluster
+            const aggregated = aggregateEvidence(cluster);
+            // Generate spec from aggregated evidence
+            const { spec, method, model } = await generateSpec(aggregated, options);
+            // Determine output path
+            const outputDir = options.outputDir || findProjectRoot(dirPath);
+            const specificaDir = path.join(outputDir, '.specifica');
+            const featureDir = path.join(specificaDir, cluster.name);
+            const specPath = path.join(featureDir, 'spec.md');
+            // Check for conflicts
+            if (fs.existsSync(specPath) && !options.overwrite) {
+                const resolution = await resolveConflict(specPath, {
+                    strategy: 'prompt',
+                    backup: true,
+                });
+                if (resolution === 'skip') {
+                    console.log(`Skipping ${cluster.name} (spec exists)`);
+                    continue;
+                }
+            }
+            // Create output directory
+            fs.mkdirSync(featureDir, { recursive: true });
+            // Format and write spec.md
+            const metadata = {
+                generatedAt: new Date().toISOString(),
+                generator: 'circle-ir-ai/specifica',
+                version: getVersion(),
+                model: model || 'static-generation',
+                filesAnalyzed: cluster.files.length,
+                reviewRequired: true,
+            };
+            const markdown = formatSpecMarkdown(spec, { reviewRequired: true });
+            fs.writeFileSync(specPath, markdown, 'utf-8');
+            outputs.push({
+                featureName: cluster.name,
+                outputPath: featureDir,
+                spec,
+                metadata,
+                generationMethod: method,
+            });
+            if (!options.quiet) {
+                console.log(`  ✓ Generated: ${featureDir}/spec.md`);
+            }
+        }
+        catch (error) {
+            console.error(`Failed to generate spec for ${cluster.name}:`, error instanceof Error ? error.message : String(error));
+        }
+    }
+    if (!options.quiet) {
+        console.log(`\n✓ Generated ${outputs.length} specifications`);
+    }
+    return outputs;
+}
+/**
+ * Find project root (directory containing package.json, pom.xml, etc.)
+ */
+function findProjectRoot(filePath) {
+    let current = path.dirname(path.resolve(filePath));
+    while (current !== '/') {
+        // Check for project markers
+        const markers = ['package.json', 'pom.xml', 'Cargo.toml', 'pyproject.toml', '.git'];
+        for (const marker of markers) {
+            if (fs.existsSync(path.join(current, marker))) {
+                return current;
+            }
+        }
+        // Move up one directory
+        const parent = path.dirname(current);
+        if (parent === current)
+            break; // Reached root
+        current = parent;
+    }
+    // Fallback: use file's directory
+    return path.dirname(path.resolve(filePath));
+}
+/**
+ * Detect language from file extension
+ */
+function detectLanguage(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    switch (ext) {
+        case '.java': return 'java';
+        case '.js':
+        case '.jsx': return 'javascript';
+        case '.ts':
+        case '.tsx': return 'typescript';
+        case '.py': return 'python';
+        case '.rs': return 'rust';
+        default: return 'java'; // Default fallback
+    }
+}
+/**
+ * Generate feature name from file path
+ * Example: UserAuthController.java -> user-auth
+ */
+function generateFeatureName(filePath) {
+    const fileName = path.basename(filePath, path.extname(filePath));
+    // Remove common suffixes
+    const cleaned = fileName
+        .replace(/Controller$/, '')
+        .replace(/Service$/, '')
+        .replace(/Repository$/, '')
+        .replace(/Handler$/, '')
+        .replace(/Manager$/, '')
+        .replace(/Impl$/, '');
+    // Convert to kebab-case
+    return cleaned
+        .replace(/([A-Z])/g, '-$1')
+        .toLowerCase()
+        .replace(/^-/, '')
+        .replace(/_/g, '-');
+}
+/**
+ * Collect all source files in a directory
+ */
+function collectSourceFiles(dirPath) {
+    const files = [];
+    const extensions = ['.java', '.js', '.ts', '.tsx', '.jsx', '.py', '.rs'];
+    function traverse(currentPath) {
+        const entries = fs.readdirSync(currentPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(currentPath, entry.name);
+            // Skip node_modules, .git, dist, build, etc.
+            if (entry.isDirectory()) {
+                const skipDirs = ['node_modules', '.git', 'dist', 'build', 'target', '__pycache__', '.specifica'];
+                if (!skipDirs.includes(entry.name)) {
+                    traverse(fullPath);
+                }
+            }
+            else if (entry.isFile()) {
+                const ext = path.extname(entry.name);
+                if (extensions.includes(ext)) {
+                    files.push(fullPath);
+                }
+            }
+        }
+    }
+    traverse(dirPath);
+    return files;
+}
+/**
+ * Get circle-ir-ai version
+ */
+function getVersion() {
+    try {
+        const packagePath = new URL('../../package.json', import.meta.url).pathname;
+        const pkg = JSON.parse(fs.readFileSync(packagePath, 'utf-8'));
+        return pkg.version;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=generator.js.map

package/dist/specifica/generator.js.map

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

package/dist/specifica/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Specifica Generation Module
+ *
+ * Generate Specifica-format specifications from existing code.
+ *
+ * Phase 1: Single file → spec.md
+ * Phase 2: Multi-file → spec.md + design.md
+ * Phase 3: Full project → spec.md + design.md + tasks.md
+ */
+export { generateSpecifica, generateSpecificaForDirectory } from './generator.js';
+export { extractEvidence } from './evidence-extractor.js';
+export { generateSpec, formatSpecMarkdown } from './spec-generator.js';
+export { resolveConflict, fileExists, getConflictStrategy } from './conflict-resolver.js';
+export type { SpecificaOptions, SpecificaOutput, FileEvidence, SpecMdContent, Requirement, GenerationMetadata, ConflictResolution, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/specifica/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAGlF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG1F,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/specifica/index.js

@@ -0,0 +1,18 @@
+/**
+ * Specifica Generation Module
+ *
+ * Generate Specifica-format specifications from existing code.
+ *
+ * Phase 1: Single file → spec.md
+ * Phase 2: Multi-file → spec.md + design.md
+ * Phase 3: Full project → spec.md + design.md + tasks.md
+ */
+// Main API
+export { generateSpecifica, generateSpecificaForDirectory } from './generator.js';
+// Evidence extraction
+export { extractEvidence } from './evidence-extractor.js';
+// Spec generation
+export { generateSpec, formatSpecMarkdown } from './spec-generator.js';
+// Conflict resolution
+export { resolveConflict, fileExists, getConflictStrategy } from './conflict-resolver.js';
+//# sourceMappingURL=index.js.map

package/dist/specifica/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/specifica/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,WAAW;AACX,OAAO,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAElF,sBAAsB;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEvE,sBAAsB;AACtB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/specifica/prompts.d.ts

@@ -0,0 +1,21 @@
+/**
+ * LLM Prompts for Specifica Generation
+ *
+ * Prompt templates for generating spec.md, design.md, and tasks.md
+ */
+import type { PromptContext } from './types.js';
+/**
+ * Generate prompt for spec.md (requirements specification)
+ */
+export declare function generateSpecPrompt(context: PromptContext): string;
+/**
+ * Generate prompt for design.md (architecture & decisions)
+ * TODO: Phase 2
+ */
+export declare function generateDesignPrompt(context: PromptContext): string;
+/**
+ * Generate prompt for tasks.md (implementation order)
+ * TODO: Phase 3
+ */
+export declare function generateTasksPrompt(context: PromptContext): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/specifica/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/specifica/prompts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAyHjE;AAgED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAEnE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAElE"}