@pennyfarthing/core 10.4.0 → 11.0.0

package/packages/core/dist/shared/skill-search.js

@@ -0,0 +1,300 @@
+/**
+ * Skill Search Utility - Story 9-2
+ *
+ * Searches the skill registry by tag, keyword, category, or description query.
+ * Returns matching skills with metadata for discovery and suggestions.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolvePennyfarthingDist } from './portrait-resolver.js';
+/** Valid categories from the registry */
+const VALID_CATEGORIES = [
+    'ai-llm',
+    'documentation',
+    'development',
+    'tools',
+    'benchmarking',
+    'project-management',
+    'theming'
+];
+/**
+ * Simple YAML parser for skill registry
+ * Handles nested objects and arrays in the specific structure we need
+ */
+function parseRegistryYaml(content) {
+    const result = { version: '', skills: {} };
+    const lines = content.split('\n');
+    let currentSkillKey = null;
+    let currentArrayField = null;
+    let insideExamples = false;
+    for (const line of lines) {
+        const trimmed = line.trimEnd();
+        // Skip empty lines and comments
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const indent = line.length - line.trimStart().length;
+        const colonIndex = trimmed.indexOf(':');
+        const key = colonIndex >= 0 ? trimmed.substring(0, colonIndex).trim() : trimmed.trim();
+        const value = colonIndex >= 0 ? trimmed.substring(colonIndex + 1).trim() : '';
+        // Top-level version
+        if (indent === 0 && key === 'version') {
+            result.version = value.replace(/^["']|["']$/g, '');
+            continue;
+        }
+        // Top-level skills key
+        if (indent === 0 && key === 'skills') {
+            continue;
+        }
+        // Skill key (indent 2)
+        if (indent === 2 && !trimmed.startsWith('-')) {
+            currentSkillKey = key;
+            result.skills[currentSkillKey] = {
+                name: '',
+                description: '',
+                category: '',
+                tags: [],
+                version: '',
+                prerequisites: [],
+                examples: [],
+                anti_patterns: [],
+                related_skills: [],
+                keywords: []
+            };
+            currentArrayField = null;
+            insideExamples = false;
+            continue;
+        }
+        // Skill fields (indent 4)
+        if (indent === 4 && currentSkillKey) {
+            insideExamples = false;
+            currentArrayField = null;
+            if (key === 'name') {
+                result.skills[currentSkillKey].name = value.replace(/^["']|["']$/g, '');
+            }
+            else if (key === 'description') {
+                result.skills[currentSkillKey].description = value.replace(/^["']|["']$/g, '');
+            }
+            else if (key === 'category') {
+                result.skills[currentSkillKey].category = value.replace(/^["']|["']$/g, '');
+            }
+            else if (key === 'version') {
+                result.skills[currentSkillKey].version = value.replace(/^["']|["']$/g, '');
+            }
+            else if (key === 'tags') {
+                // Inline array: [tag1, tag2]
+                if (value.startsWith('[')) {
+                    result.skills[currentSkillKey].tags = parseInlineArray(value);
+                }
+                else {
+                    currentArrayField = 'tags';
+                }
+            }
+            else if (key === 'keywords') {
+                if (value.startsWith('[')) {
+                    result.skills[currentSkillKey].keywords = parseInlineArray(value);
+                }
+                else {
+                    currentArrayField = 'keywords';
+                }
+            }
+            else if (key === 'prerequisites') {
+                if (value.startsWith('[')) {
+                    result.skills[currentSkillKey].prerequisites = parseInlineArray(value);
+                }
+                else {
+                    currentArrayField = 'prerequisites';
+                }
+            }
+            else if (key === 'related_skills') {
+                if (value.startsWith('[')) {
+                    result.skills[currentSkillKey].related_skills = parseInlineArray(value);
+                }
+                else {
+                    currentArrayField = 'related_skills';
+                }
+            }
+            else if (key === 'anti_patterns') {
+                currentArrayField = 'anti_patterns';
+            }
+            else if (key === 'examples') {
+                insideExamples = true;
+                currentArrayField = null;
+            }
+            continue;
+        }
+        // Array items (indent 6 starting with -)
+        if (indent === 6 && currentSkillKey && trimmed.startsWith('-')) {
+            const itemValue = trimmed.substring(1).trim().replace(/^["']|["']$/g, '');
+            if (insideExamples) {
+                // Start of a new example object
+                result.skills[currentSkillKey].examples.push({ context: '', invocation: '' });
+            }
+            else if (currentArrayField && currentArrayField in result.skills[currentSkillKey]) {
+                const arr = result.skills[currentSkillKey][currentArrayField];
+                if (Array.isArray(arr) && typeof arr[0] !== 'object') {
+                    arr.push(itemValue);
+                }
+            }
+            continue;
+        }
+        // Example sub-fields (indent 8)
+        if (indent === 8 && currentSkillKey && insideExamples) {
+            const examples = result.skills[currentSkillKey].examples;
+            if (examples.length > 0) {
+                const lastExample = examples[examples.length - 1];
+                if (key === 'context') {
+                    lastExample.context = value.replace(/^["']|["']$/g, '');
+                }
+                else if (key === 'invocation') {
+                    lastExample.invocation = value.replace(/^["']|["']$/g, '');
+                }
+            }
+            continue;
+        }
+    }
+    return result;
+}
+/**
+ * Parse inline YAML array like [tag1, tag2, tag3]
+ */
+function parseInlineArray(value) {
+    const match = value.match(/^\[(.*)\]$/);
+    if (!match)
+        return [];
+    return match[1]
+        .split(',')
+        .map(item => item.trim().replace(/^["']|["']$/g, ''))
+        .filter(Boolean);
+}
+/**
+ * Search skills in the registry based on provided options.
+ *
+ * @param options - Search options (tag, keyword, query, category)
+ * @returns Promise resolving to array of matching skills
+ * @throws Error if registry file not found or invalid category
+ */
+export async function searchSkills(options) {
+    // Resolve registry path
+    let registryPath = options.registryPath;
+    if (!registryPath) {
+        const distPath = resolvePennyfarthingDist();
+        if (!distPath) {
+            throw new Error('Registry not found: Cannot resolve pennyfarthing-dist directory');
+        }
+        registryPath = join(distPath, 'skills', 'skill-registry.yaml');
+    }
+    // Validate registry exists
+    if (!existsSync(registryPath)) {
+        throw new Error(`Registry not found: ${registryPath}`);
+    }
+    // Validate category if provided
+    if (options.category && !VALID_CATEGORIES.includes(options.category)) {
+        throw new Error(`Invalid category: ${options.category}. Valid categories: ${VALID_CATEGORIES.join(', ')}`);
+    }
+    // Parse registry
+    const content = readFileSync(registryPath, 'utf-8');
+    const registry = parseRegistryYaml(content);
+    // Convert to SkillResult array
+    let results = Object.values(registry.skills).map(skill => ({
+        name: skill.name,
+        description: skill.description,
+        category: skill.category,
+        tags: skill.tags,
+        keywords: skill.keywords.length > 0 ? skill.keywords : undefined,
+        version: skill.version || undefined,
+        related_skills: skill.related_skills.length > 0 ? skill.related_skills : undefined
+    }));
+    // Apply filters (AND logic - all filters must match)
+    // Filter by category
+    if (options.category) {
+        results = results.filter(s => s.category === options.category);
+    }
+    // Filter by tag (case-insensitive)
+    if (options.tag) {
+        const searchTag = options.tag.toLowerCase();
+        results = results.filter(s => s.tags.some(t => t.toLowerCase() === searchTag));
+    }
+    // Filter by keyword (case-insensitive)
+    if (options.keyword) {
+        const searchKeyword = options.keyword.toLowerCase();
+        results = results.filter(s => s.keywords?.some(k => k.toLowerCase() === searchKeyword));
+    }
+    // Filter by query (searches description, case-insensitive)
+    if (options.query) {
+        const searchQuery = options.query.toLowerCase();
+        results = results.filter(s => s.description.toLowerCase().includes(searchQuery));
+    }
+    return results;
+}
+// CLI entry point when run directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const args = process.argv.slice(2);
+    const options = {};
+    let jsonOutput = false;
+    // Parse command-line arguments
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--help' || arg === '-h') {
+            console.log(`Usage: skill-search [options]
+
+Options:
+  --tag <tag>        Filter by tag (e.g., "tdd", "quality")
+  --keyword <kw>     Filter by keyword (e.g., "jest", "vitest")
+  --query <text>     Search description text
+  --category <cat>   Filter by category
+  --json             Output as JSON (default: table)
+  --help, -h         Show this help
+
+Examples:
+  skill-search --tag tdd
+  skill-search --category development --json
+  skill-search --query "TDD workflow"
+`);
+            process.exit(0);
+        }
+        else if (arg === '--json') {
+            jsonOutput = true;
+        }
+        else if (arg === '--tag' && args[i + 1]) {
+            options.tag = args[++i];
+        }
+        else if (arg === '--keyword' && args[i + 1]) {
+            options.keyword = args[++i];
+        }
+        else if (arg === '--query' && args[i + 1]) {
+            options.query = args[++i];
+        }
+        else if (arg === '--category' && args[i + 1]) {
+            options.category = args[++i];
+        }
+    }
+    searchSkills(options)
+        .then(results => {
+        if (jsonOutput) {
+            console.log(JSON.stringify(results, null, 2));
+        }
+        else {
+            // Table output
+            if (results.length === 0) {
+                console.log('No skills found matching criteria.');
+            }
+            else {
+                const maxName = Math.max(...results.map(s => s.name.length), 4);
+                const maxCat = Math.max(...results.map(s => s.category.length), 8);
+                console.log(`${'NAME'.padEnd(maxName)}  ${'CATEGORY'.padEnd(maxCat)}  DESCRIPTION`);
+                console.log(`${'-'.repeat(maxName)}  ${'-'.repeat(maxCat)}  ${'-'.repeat(40)}`);
+                for (const skill of results) {
+                    const desc = skill.description.length > 50
+                        ? skill.description.substring(0, 47) + '...'
+                        : skill.description;
+                    console.log(`${skill.name.padEnd(maxName)}  ${skill.category.padEnd(maxCat)}  ${desc}`);
+                }
+            }
+        }
+    })
+        .catch(err => {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=skill-search.js.map

package/packages/core/dist/shared/skill-search.js.map

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

package/packages/core/dist/shared/skill-search.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tests for Story 9-2: Build Skill Search Utility
+ *
+ * These tests verify:
+ * - Tag filtering returns expected skills
+ * - Keyword search returns expected skills
+ * - Category filtering works
+ * - Combined filters use AND logic
+ * - JSON output is valid and includes required fields
+ * - Empty results return empty array (not error)
+ * - Error handling for missing registry
+ *
+ * Run with: npm test -- scripts/utils/skill-search.test.ts
+ */
+export {};
+//# sourceMappingURL=skill-search.test.d.ts.map

package/packages/core/dist/shared/skill-search.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-search.test.d.ts","sourceRoot":"","sources":["../../src/shared/skill-search.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/packages/core/dist/shared/skill-search.test.js

@@ -0,0 +1,177 @@
+/**
+ * Tests for Story 9-2: Build Skill Search Utility
+ *
+ * These tests verify:
+ * - Tag filtering returns expected skills
+ * - Keyword search returns expected skills
+ * - Category filtering works
+ * - Combined filters use AND logic
+ * - JSON output is valid and includes required fields
+ * - Empty results return empty array (not error)
+ * - Error handling for missing registry
+ *
+ * Run with: npm test -- scripts/utils/skill-search.test.ts
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { execSync } from 'child_process';
+import { existsSync } from 'fs';
+import { join } from 'path';
+// Import functions to test - these don't exist yet, tests should fail
+import { searchSkills } from './skill-search.js';
+// Path to the shell wrapper for integration tests
+const WRAPPER_PATH = join(import.meta.dirname, 'skill-search.sh');
+describe('Story 9-2: Skill Search Utility', () => {
+    describe('searchSkills() - Core Function', () => {
+        describe('AC1: Script is functional', () => {
+            it('should read skill-registry.yaml and return all skills when no filters', async () => {
+                // AC1: Reads skill-registry.yaml
+                const results = await searchSkills({});
+                assert.ok(Array.isArray(results), 'Should return an array');
+                assert.ok(results.length > 0, 'Should return skills from registry');
+                assert.ok(results.length === 22, 'Should return all 22 skills when no filters');
+            });
+            it('should return skills with required fields', async () => {
+                // AC1: Each skill should have core metadata
+                const results = await searchSkills({});
+                for (const skill of results) {
+                    assert.ok(skill.name, `Skill should have name`);
+                    assert.ok(skill.description, `Skill ${skill.name} should have description`);
+                    assert.ok(skill.category, `Skill ${skill.name} should have category`);
+                    assert.ok(Array.isArray(skill.tags), `Skill ${skill.name} should have tags array`);
+                }
+            });
+            it('should filter by tag with --tag option', async () => {
+                // AC1: Filters by tag with --tag <category>
+                const results = await searchSkills({ tag: 'tdd' });
+                assert.ok(results.length > 0, 'Should return at least one skill with tdd tag');
+                assert.ok(results.every(s => s.tags.includes('tdd')), 'All results should have tdd tag');
+            });
+            it('should filter by keyword with --keyword option', async () => {
+                // AC1: Filters by keyword with --keyword <term>
+                const results = await searchSkills({ keyword: 'jest' });
+                assert.ok(results.length > 0, 'Should return at least one skill with jest keyword');
+                assert.ok(results.every(s => s.keywords?.includes('jest')), 'All results should have jest in keywords');
+            });
+            it('should search descriptions with --query option', async () => {
+                // AC1: Searches descriptions with --query <text>
+                const results = await searchSkills({ query: 'TDD workflow' });
+                assert.ok(results.length > 0, 'Should return skills matching query');
+                assert.ok(results.some(s => s.description.toLowerCase().includes('tdd')), 'At least one result should mention TDD in description');
+            });
+        });
+        describe('AC2: Tag/keyword search returns expected results', () => {
+            it('should return testing skill when filtering by --tag tdd', async () => {
+                // AC2: --tag development returns skills with that tag
+                const results = await searchSkills({ tag: 'tdd' });
+                const skillNames = results.map(s => s.name);
+                assert.ok(skillNames.includes('pf-testing'), 'Should include testing skill for tdd tag');
+            });
+            it('should return testing skill when filtering by --keyword vitest', async () => {
+                // AC2: --keyword jest returns skills mentioning jest in keywords
+                const results = await searchSkills({ keyword: 'vitest' });
+                const skillNames = results.map(s => s.name);
+                assert.ok(skillNames.includes('pf-testing'), 'Should include testing skill for vitest keyword');
+            });
+            it('should return 4 skills when filtering by --category development', async () => {
+                // AC2: Category filter returns expected count
+                const results = await searchSkills({ category: 'development' });
+                assert.strictEqual(results.length, 4, 'Should return 4 development skills');
+                assert.ok(results.every(s => s.category === 'development'), 'All results should be development category');
+            });
+            it('should combine multiple filters with AND logic', async () => {
+                // AC2: Multiple filters can be combined (AND logic)
+                const results = await searchSkills({
+                    tag: 'quality',
+                    category: 'development'
+                });
+                assert.ok(results.length > 0, 'Should return at least one result');
+                assert.ok(results.length < 3, 'Should be narrower than just category filter');
+                assert.ok(results.every(s => s.category === 'development' && s.tags.includes('quality')), 'All results should match both filters');
+            });
+            it('should return empty array for non-existent tag (not error)', async () => {
+                // AC2: Empty results handled gracefully
+                const results = await searchSkills({ tag: 'nonexistent-tag-xyz' });
+                assert.ok(Array.isArray(results), 'Should return an array');
+                assert.strictEqual(results.length, 0, 'Should return empty array for no matches');
+            });
+            it('should return empty array for non-existent keyword', async () => {
+                // AC2: Empty results for non-existent keyword
+                const results = await searchSkills({ keyword: 'nonexistent-keyword-xyz' });
+                assert.ok(Array.isArray(results), 'Should return an array');
+                assert.strictEqual(results.length, 0, 'Should return empty array for no matches');
+            });
+            it('should handle case-insensitive tag matching', async () => {
+                // AC2: Tags should match case-insensitively
+                const upperResults = await searchSkills({ tag: 'TDD' });
+                const lowerResults = await searchSkills({ tag: 'tdd' });
+                assert.deepStrictEqual(upperResults.map(s => s.name).sort(), lowerResults.map(s => s.name).sort(), 'Tag matching should be case-insensitive');
+            });
+        });
+        describe('AC3: JSON output format', () => {
+            it('should return valid JSON-serializable results', async () => {
+                // AC3: Output should be valid JSON
+                const results = await searchSkills({});
+                const jsonString = JSON.stringify(results);
+                const parsed = JSON.parse(jsonString);
+                assert.ok(Array.isArray(parsed), 'Should produce valid JSON array');
+            });
+            it('should include name, description, category, tags in each result', async () => {
+                // AC3: Each skill object includes: name, description, category, tags
+                const results = await searchSkills({});
+                for (const skill of results) {
+                    assert.ok('name' in skill, 'Should include name');
+                    assert.ok('description' in skill, 'Should include description');
+                    assert.ok('category' in skill, 'Should include category');
+                    assert.ok('tags' in skill, 'Should include tags');
+                }
+            });
+            it('should include keywords in results when present', async () => {
+                // AC3: Keywords should be included for search relevance
+                const results = await searchSkills({ keyword: 'jest' });
+                assert.ok(results.length > 0, 'Should have results');
+                assert.ok(results.every(s => 'keywords' in s), 'All results should include keywords field');
+            });
+        });
+        describe('Error Handling', () => {
+            it('should throw helpful error when registry file is missing', async () => {
+                // Error handling: Missing registry file shows helpful error
+                await assert.rejects(async () => searchSkills({ registryPath: '/nonexistent/path/registry.yaml' }), {
+                    message: /registry.*not found|cannot find|no such file/i
+                }, 'Should throw error with helpful message for missing registry');
+            });
+            it('should throw error for invalid category value', async () => {
+                // Error handling: Invalid category should be rejected
+                await assert.rejects(async () => searchSkills({ category: 'invalid-category' }), {
+                    message: /invalid category|unknown category/i
+                }, 'Should throw error for invalid category');
+            });
+        });
+    });
+    describe('Shell Wrapper Integration', { skip: !existsSync(WRAPPER_PATH) }, () => {
+        // Skip all wrapper tests if skill-search.sh doesn't exist yet
+        it('should execute via bash wrapper', () => {
+            const result = execSync(`bash ${WRAPPER_PATH} --help`, { encoding: 'utf-8' });
+            assert.ok(result.includes('search') || result.includes('usage'), 'Should show help text');
+        });
+        it('should output JSON with --json flag via wrapper', () => {
+            const result = execSync(`bash ${WRAPPER_PATH} --json`, { encoding: 'utf-8' });
+            const parsed = JSON.parse(result);
+            assert.ok(Array.isArray(parsed), 'Should output valid JSON array');
+        });
+        it('should filter by tag via wrapper', () => {
+            const result = execSync(`bash ${WRAPPER_PATH} --tag tdd --json`, { encoding: 'utf-8' });
+            const parsed = JSON.parse(result);
+            assert.ok(parsed.length > 0, 'Should return results for tdd tag');
+            assert.ok(parsed.every((s) => s.tags.includes('tdd')), 'All results should have tdd tag');
+        });
+        it('should show human-readable table without --json flag', () => {
+            const result = execSync(`bash ${WRAPPER_PATH} --tag tdd`, { encoding: 'utf-8' });
+            // Should not be valid JSON (it's a table)
+            assert.throws(() => JSON.parse(result), 'Non-JSON output should not be valid JSON');
+            // Should contain skill name and some formatting
+            assert.ok(result.includes('testing'), 'Should show testing skill name');
+        });
+    });
+});
+//# sourceMappingURL=skill-search.test.js.map

package/packages/core/dist/shared/skill-search.test.js.map

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

package/packages/core/dist/shared/skill-suggest.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Skill Suggestions Utility - Story 9-3
+ *
+ * Provides intelligent skill suggestions based on:
+ * - AC1: Session context (story, ACs, phase)
+ * - AC2: Keyword extraction and matching
+ * - AC3: Non-intrusive presentation (thresholds, limits)
+ *
+ * Reuses searchSkills() from skill-search.ts for registry access.
+ */
+/**
+ * Session context for story-aware suggestions
+ */
+export interface SessionContext {
+    /** Story identifier (e.g., "9-3") */
+    storyId: string;
+    /** List of acceptance criteria */
+    acceptanceCriteria: string[];
+    /** Current workflow phase */
+    phase: string;
+    /** Optional Jira issue key */
+    jiraKey?: string;
+}
+/**
+ * Options for skill suggestions
+ */
+export interface SuggestOptions {
+    /** Minimum confidence score (0-1) to include suggestion. Default: 0.3 */
+    confidenceThreshold?: number;
+    /** Maximum number of suggestions to return. Default: 5 */
+    maxResults?: number;
+    /** Skills to exclude from suggestions (already in use) */
+    excludeSkills?: string[];
+    /** Session context for combined suggestions */
+    sessionContext?: SessionContext;
+    /** Custom path to registry file (for testing) */
+    registryPath?: string;
+}
+/**
+ * A skill suggestion with relevance scoring
+ */
+export interface SkillSuggestion {
+    /** Skill name */
+    name: string;
+    /** Skill description */
+    description: string;
+    /** Relevance score (0-1) */
+    score: number;
+    /** Reason for suggesting this skill */
+    reason: string;
+    /** What triggered the match (keywords, tags, phase) */
+    matchedOn?: string[];
+}
+/**
+ * Suggest skills based on session context (story, ACs, phase)
+ *
+ * @param context - Session context with story details
+ * @returns Promise resolving to array of skill suggestions
+ */
+export declare function suggestFromSession(context: SessionContext): Promise<SkillSuggestion[]>;
+/**
+ * Suggest skills based on keywords in user input
+ *
+ * @param userInput - User's message or query
+ * @returns Promise resolving to array of skill suggestions
+ */
+export declare function suggestFromKeywords(userInput: string): Promise<SkillSuggestion[]>;
+/**
+ * Main suggestion function combining session context and keywords
+ *
+ * @param userInput - User's message or query
+ * @param options - Suggestion options (threshold, limits, exclusions)
+ * @returns Promise resolving to filtered, limited skill suggestions
+ */
+export declare function suggestSkills(userInput: string, options?: SuggestOptions): Promise<SkillSuggestion[]>;
+//# sourceMappingURL=skill-suggest.d.ts.map

package/packages/core/dist/shared/skill-suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-suggest.d.ts","sourceRoot":"","sources":["../../src/shared/skill-suggest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAyDD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC,CA0D5B;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,EAAE,CAAC,CAqD5B;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,eAAe,EAAE,CAAC,CA2E5B"}