specweave 2.3.0 → 3.0.0

package/dist/src/utils/generate-skills-index.js

@@ -1,413 +0,0 @@
-/**
- * Skills Index Generator
- *
- * @deprecated SKILLS-INDEX.md is no longer used. Skills are discovered via
- * SKILL.md frontmatter directly (each skill has name + description with
- * activation keywords). This file is kept for potential CI/CD use but is
- * not part of the active workflow.
- *
- * Generates SKILLS-INDEX.md from all SKILL.md files
- * Simulates Claude Code's progressive disclosure for non-native tools
- *
- * This allows GitHub Copilot, Cursor, and other AI tools to:
- * 1. Quickly scan all available skills (single file read)
- * 2. Match user requests to activation keywords
- * 3. Load full SKILL.md only when relevant
- * 4. Follow skill workflows for consistent output
- *
- * Usage:
- *   import { generateSkillsIndex } from './generate-skills-index.js';
- *   await generateSkillsIndex();
- *
- * Or run directly:
- *   npx ts-node src/utils/generate-skills-index.ts
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import * as yaml from 'js-yaml';
-import { fileURLToPath } from 'url';
-import { dirname } from 'path';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-/**
- * Skill categories for organization
- */
-const SkillCategory = {
-    FRAMEWORK: 'Framework Core',
-    INTEGRATIONS: 'External Integrations',
-    ARCHITECTURE: 'Architecture & Design',
-    DEVELOPMENT: 'Development',
-    QUALITY: 'Quality & Testing',
-    INFRASTRUCTURE: 'Infrastructure',
-    DOCUMENTATION: 'Documentation',
-    ORCHESTRATION: 'Orchestration & Planning',
-    OTHER: 'Other',
-};
-/**
- * Parse YAML frontmatter from SKILL.md
- */
-function parseSkillMetadata(content, filePath) {
-    try {
-        // Extract YAML frontmatter
-        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
-        if (!frontmatterMatch) {
-            console.warn(`⚠️  No frontmatter found in: ${filePath}`);
-            return null;
-        }
-        let frontmatter;
-        try {
-            frontmatter = yaml.load(frontmatterMatch[1]);
-        }
-        catch (yamlError) {
-            // If YAML parsing fails, try manual parsing for simple key-value pairs
-            // This handles cases where descriptions have unquoted colons
-            frontmatter = {};
-            const lines = frontmatterMatch[1].split('\n');
-            for (const line of lines) {
-                const colonIndex = line.indexOf(':');
-                if (colonIndex > 0) {
-                    const key = line.substring(0, colonIndex).trim();
-                    const value = line.substring(colonIndex + 1).trim();
-                    frontmatter[key] = value;
-                }
-            }
-        }
-        if (!frontmatter.name || !frontmatter.description) {
-            console.warn(`⚠️  Missing name or description in: ${filePath}`);
-            return null;
-        }
-        // Extract activation keywords from description
-        // Look for "Activates for:" or "Activates when user mentions:" in description
-        const activationKeywords = [];
-        const activatesMatch = frontmatter.description.match(/Activates (?:for|when user mentions):\s*(.+?)(?:\.|$)/i);
-        if (activatesMatch) {
-            // Split by comma and clean up
-            const keywords = activatesMatch[1]
-                .split(',')
-                .map((k) => k.trim())
-                .filter((k) => k.length > 0);
-            activationKeywords.push(...keywords);
-        }
-        // Determine category from skill name
-        const category = categorizeSkill(frontmatter.name, frontmatter.description);
-        // Relative path from .claude/skills/
-        const skillDir = path.basename(path.dirname(filePath));
-        const location = `.claude/skills/${skillDir}/SKILL.md`;
-        return {
-            name: frontmatter.name,
-            description: frontmatter.description,
-            activationKeywords,
-            location,
-            allowedTools: frontmatter['allowed-tools'],
-            category,
-        };
-    }
-    catch (error) {
-        console.error(`❌ Error parsing ${filePath}:`, error);
-        return null;
-    }
-}
-/**
- * Categorize skill based on name and description
- */
-function categorizeSkill(name, description) {
-    const nameLower = name.toLowerCase();
-    const descLower = description.toLowerCase();
-    // Framework core
-    if (nameLower.includes('increment') ||
-        nameLower.includes('context') ||
-        nameLower.includes('specweave') ||
-        nameLower.includes('skill-creator')) {
-        return SkillCategory.FRAMEWORK;
-    }
-    // Integrations
-    if (nameLower.includes('jira') ||
-        nameLower.includes('ado') ||
-        nameLower.includes('github') ||
-        nameLower.includes('sync') ||
-        nameLower.includes('figma-mcp')) {
-        return SkillCategory.INTEGRATIONS;
-    }
-    // Architecture & Design
-    if (nameLower.includes('diagram') ||
-        nameLower.includes('architect') ||
-        nameLower.includes('design-system') ||
-        descLower.includes('architecture') ||
-        descLower.includes('c4 model')) {
-        return SkillCategory.ARCHITECTURE;
-    }
-    // Development
-    if (nameLower.includes('frontend') ||
-        nameLower.includes('backend') ||
-        nameLower.includes('nodejs') ||
-        nameLower.includes('python') ||
-        nameLower.includes('dotnet') ||
-        nameLower.includes('nextjs') ||
-        nameLower.includes('figma')) {
-        return SkillCategory.DEVELOPMENT;
-    }
-    // Quality & Testing
-    if (nameLower.includes('quality') ||
-        nameLower.includes('test') ||
-        nameLower.includes('e2e') ||
-        nameLower.includes('playwright') ||
-        descLower.includes('testing') ||
-        descLower.includes('validation')) {
-        return SkillCategory.QUALITY;
-    }
-    // Infrastructure
-    if (nameLower.includes('hetzner') ||
-        nameLower.includes('provision') ||
-        nameLower.includes('cost-optimizer') ||
-        descLower.includes('infrastructure') ||
-        descLower.includes('deployment') ||
-        descLower.includes('hosting')) {
-        return SkillCategory.INFRASTRUCTURE;
-    }
-    // Documentation
-    if (nameLower.includes('docusaurus') ||
-        nameLower.includes('docs') ||
-        descLower.includes('documentation') ||
-        descLower.includes('generating documentation')) {
-        return SkillCategory.DOCUMENTATION;
-    }
-    // Orchestration
-    if (nameLower.includes('orchestrat') ||
-        nameLower.includes('role-orchestrator') ||
-        nameLower.includes('skill-router') ||
-        nameLower.includes('brainstorm') ||
-        descLower.includes('multi-agent') ||
-        descLower.includes('coordinates') ||
-        descLower.includes('routing')) {
-        return SkillCategory.ORCHESTRATION;
-    }
-    return SkillCategory.OTHER;
-}
-/**
- * Generate markdown for skills index
- */
-function generateIndexMarkdown(skills) {
-    const now = new Date().toISOString();
-    const totalSkills = skills.length;
-    // Group skills by category
-    const categorized = new Map();
-    for (const skill of skills) {
-        const category = skill.category;
-        if (!categorized.has(category)) {
-            categorized.set(category, []);
-        }
-        categorized.get(category).push(skill);
-    }
-    // Sort skills within each category alphabetically
-    for (const skillList of categorized.values()) {
-        skillList.sort((a, b) => a.name.localeCompare(b.name));
-    }
-    let markdown = `# SpecWeave Skills Index
-
-**Purpose**: Quick reference for all available skills. Read this file BEFORE starting any task.
-
-**Last Updated**: ${now} (auto-generated, do not edit manually)
-
-**Total Skills**: ${totalSkills}
-
----
-
-## 🚀 Quick Start (Progressive Disclosure)
-
-**MANDATORY**: Skills are your expert manuals. Always check for relevant skills BEFORE starting implementation.
-
-### Progressive Disclosure Pattern
-
-1. **Scan this index** to find skills matching your task
-2. **Match activation keywords** to your current request
-3. **Load full SKILL.md** for matching skills
-4. **Follow the workflow** in SKILL.md precisely
-
-### Example Workflow
-
-\`\`\`
-User asks: "Plan a new feature for user authentication"
-
-Step 1: Scan this index → Find "increment" skill
-Step 2: Check keywords → Matches "feature planning", "create increment"
-Step 3: Load skill → cat .claude/skills/increment/SKILL.md
-Step 4: Execute → Follow the increment planning workflow
-\`\`\`
-
----
-
-## 📚 All Available Skills
-
-`;
-    // Define category order
-    const categoryOrder = [
-        SkillCategory.FRAMEWORK,
-        SkillCategory.ORCHESTRATION,
-        SkillCategory.INTEGRATIONS,
-        SkillCategory.ARCHITECTURE,
-        SkillCategory.DEVELOPMENT,
-        SkillCategory.QUALITY,
-        SkillCategory.INFRASTRUCTURE,
-        SkillCategory.DOCUMENTATION,
-        SkillCategory.OTHER,
-    ];
-    // Generate sections by category
-    for (const category of categoryOrder) {
-        const skillList = categorized.get(category);
-        if (!skillList || skillList.length === 0)
-            continue;
-        markdown += `\n### ${category}\n\n`;
-        for (const skill of skillList) {
-            markdown += `#### ${skill.name}\n\n`;
-            markdown += `**Description**: ${skill.description}\n\n`;
-            if (skill.activationKeywords.length > 0) {
-                markdown += `**Activates for**: ${skill.activationKeywords.join(', ')}\n\n`;
-            }
-            markdown += `**Location**: \`${skill.location}\`\n\n`;
-            if (skill.allowedTools && Array.isArray(skill.allowedTools)) {
-                markdown += `**Allowed tools**: ${skill.allowedTools.join(', ')}\n\n`;
-            }
-            else if (skill.allowedTools && typeof skill.allowedTools === 'string') {
-                markdown += `**Allowed tools**: ${skill.allowedTools}\n\n`;
-            }
-            markdown += '---\n\n';
-        }
-    }
-    // Add usage guide
-    markdown += `
-## 💡 How Skills Work
-
-**Level 1 - Discovery (this file)**:
-- Scan activation keywords
-- Match to your current task
-- Identify 1-3 relevant skills
-
-**Level 2 - Deep Dive (SKILL.md)**:
-- Load full skill documentation
-- Read required prerequisites
-- Follow step-by-step workflow
-
-**Level 3 - Execution**:
-- Apply skill's instructions
-- Use recommended tools
-- Follow SpecWeave best practices
-
----
-
-## 🎯 Task → Skill Matching Guide
-
-| Your Task | Relevant Skill | Keywords |
-|-----------|---------------|----------|
-| "Plan a new feature" | \`increment\` | "feature planning", "create increment" |
-| "Sync to JIRA" | \`jira-sync\` | "JIRA sync", "create JIRA issue" |
-| "Create diagram" | \`diagrams\` | "architecture diagram", "C4 diagram" |
-| "Build React UI" | \`frontend\` | "React", "components", "UI" |
-| "Deploy to cloud" | \`hetzner-provisioner\` | "deploy", "infrastructure" |
-| "Quality check" | \`increment-quality-judge\` | "quality check", "assess spec" |
-| "E2E testing" | \`e2e-playwright\` | "E2E test", "browser test" |
-| "Generate docs site" | \`docusaurus\` | "documentation site", "docs" |
-
----
-
-## ⚡ Why Skills Matter
-
-**Without skills**:
-- ❌ Reinvent workflows every session
-- ❌ Inconsistent increment structure
-- ❌ Miss SpecWeave conventions
-- ❌ Waste tokens on irrelevant docs
-
-**With skills**:
-- ✅ Proven workflows ready to use
-- ✅ Consistent high-quality output
-- ✅ SpecWeave best practices enforced
-- ✅ Efficient token usage (load only what's needed)
-
----
-
-## 🔧 For AI Tool Developers
-
-This index simulates Claude Code's native progressive disclosure:
-- Claude pre-loads skill metadata at startup (name + description)
-- Other tools read this index file for same benefit
-- Single file read replaces ${totalSkills} individual file scans
-- Token savings: ~97% (1 file vs ${totalSkills} files)
-
-**How to use in your AI tool**:
-1. Load this file at session start
-2. Parse activation keywords
-3. Match user requests to keywords
-4. Load full SKILL.md when matched
-5. Execute skill workflow
-
----
-
-**Generated by**: \`src/utils/generate-skills-index.ts\`
-
-**Regenerate with**: \`npm run generate-skills-index\`
-`;
-    return markdown;
-}
-/**
- * Main function: Generate skills index
- */
-export async function generateSkillsIndex(outputPath) {
-    console.log('🔍 Scanning skills...');
-    // Determine skills directory (root-level after v0.5.0 Claude native architecture)
-    const skillsDir = path.join(__dirname, '../../skills');
-    if (!fs.existsSync(skillsDir)) {
-        throw new Error(`Skills directory not found: ${skillsDir}`);
-    }
-    // Scan all SKILL.md files
-    const skills = [];
-    const skillDirs = fs.readdirSync(skillsDir).filter(name => {
-        const fullPath = path.join(skillsDir, name);
-        return fs.statSync(fullPath).isDirectory();
-    });
-    for (const skillDir of skillDirs) {
-        const skillPath = path.join(skillsDir, skillDir, 'SKILL.md');
-        if (fs.existsSync(skillPath)) {
-            const content = fs.readFileSync(skillPath, 'utf-8');
-            const metadata = parseSkillMetadata(content, skillPath);
-            if (metadata) {
-                skills.push(metadata);
-            }
-        }
-    }
-    console.log(`✅ Found ${skills.length} skills`);
-    // Generate markdown
-    const markdown = generateIndexMarkdown(skills);
-    // Determine output path (root-level after v0.5.0 Claude native architecture)
-    const defaultOutputPath = path.join(__dirname, '../../skills/SKILLS-INDEX.md');
-    const finalOutputPath = outputPath || defaultOutputPath;
-    // Write to file
-    fs.writeFileSync(finalOutputPath, markdown, 'utf-8');
-    console.log(`✅ Generated skills index: ${finalOutputPath}`);
-    console.log('');
-    console.log('📊 Summary:');
-    console.log(`   Total skills: ${skills.length}`);
-    // Count by category
-    const categoryCounts = new Map();
-    for (const skill of skills) {
-        categoryCounts.set(skill.category, (categoryCounts.get(skill.category) || 0) + 1);
-    }
-    for (const [category, count] of Array.from(categoryCounts.entries()).sort((a, b) => b[1] - a[1])) {
-        console.log(`   ${category}: ${count}`);
-    }
-}
-/**
- * CLI entry point (check if this file is being run directly)
- */
-if (import.meta.url === `file://${process.argv[1]}`) {
-    generateSkillsIndex()
-        .then(() => {
-        console.log('');
-        console.log('✅ Skills index generation complete!');
-        process.exit(0);
-    })
-        .catch((error) => {
-        console.error('❌ Error generating skills index:', error);
-        process.exit(1);
-    });
-}
-//# sourceMappingURL=generate-skills-index.js.map

package/dist/src/utils/generate-skills-index.js.map

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

package/dist/src/utils/github-url.d.ts

@@ -1,53 +0,0 @@
-/**
- * GitHub URL Utilities
- *
- * Utilities for converting local file paths to GitHub URLs.
- */
-export interface GitHubUrlOptions {
-    owner: string;
-    repo: string;
-    branch?: string;
-}
-/**
- * Convert local file path to GitHub URL
- *
- * @param localPath - Local file path (can start with ./ or be absolute)
- * @param options - GitHub repository options
- * @returns Full GitHub URL
- *
- * @example
- * ```typescript
- * toGitHubUrl('.specweave/docs/internal/specs/default/FS-001/FEATURE.md', {
- *   owner: 'anton-abyzov',
- *   repo: 'specweave',
- *   branch: 'develop'
- * });
- * // => 'https://github.com/anton-abyzov/specweave/blob/develop/.specweave/docs/internal/specs/default/FS-001/FEATURE.md'
- * ```
- */
-export declare function toGitHubUrl(localPath: string, options: GitHubUrlOptions): string;
-/**
- * Convert local directory path to GitHub tree URL
- *
- * @param localPath - Local directory path
- * @param options - GitHub repository options
- * @returns Full GitHub tree URL
- *
- * @example
- * ```typescript
- * toGitHubTreeUrl('.specweave/increments/0001-feature', {
- *   owner: 'anton-abyzov',
- *   repo: 'specweave',
- *   branch: 'develop'
- * });
- * // => 'https://github.com/anton-abyzov/specweave/tree/develop/.specweave/increments/0001-feature'
- * ```
- */
-export declare function toGitHubTreeUrl(localPath: string, options: GitHubUrlOptions): string;
-/**
- * Get GitHub URL options from git remote
- *
- * @returns GitHub URL options or null if not a GitHub repository
- */
-export declare function getGitHubOptions(): Promise<GitHubUrlOptions | null>;
-//# sourceMappingURL=github-url.d.ts.map

package/dist/src/utils/github-url.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"github-url.d.ts","sourceRoot":"","sources":["../../../src/utils/github-url.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAcD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAIhF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAIpF;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA6BzE"}

package/dist/src/utils/github-url.js

@@ -1,91 +0,0 @@
-/**
- * GitHub URL Utilities
- *
- * Utilities for converting local file paths to GitHub URLs.
- */
-/**
- * Clean a local path for use in GitHub URLs
- * Removes leading ./ and ensures .specweave prefix if needed
- */
-function cleanLocalPath(localPath) {
-    let cleanPath = localPath.replace(/^\.\//, '');
-    if (!cleanPath.startsWith('.specweave')) {
-        cleanPath = `.specweave/${cleanPath}`;
-    }
-    return cleanPath;
-}
-/**
- * Convert local file path to GitHub URL
- *
- * @param localPath - Local file path (can start with ./ or be absolute)
- * @param options - GitHub repository options
- * @returns Full GitHub URL
- *
- * @example
- * ```typescript
- * toGitHubUrl('.specweave/docs/internal/specs/default/FS-001/FEATURE.md', {
- *   owner: 'anton-abyzov',
- *   repo: 'specweave',
- *   branch: 'develop'
- * });
- * // => 'https://github.com/anton-abyzov/specweave/blob/develop/.specweave/docs/internal/specs/default/FS-001/FEATURE.md'
- * ```
- */
-export function toGitHubUrl(localPath, options) {
-    const { owner, repo, branch = 'develop' } = options;
-    const cleanPath = cleanLocalPath(localPath);
-    return `https://github.com/${owner}/${repo}/blob/${branch}/${cleanPath}`;
-}
-/**
- * Convert local directory path to GitHub tree URL
- *
- * @param localPath - Local directory path
- * @param options - GitHub repository options
- * @returns Full GitHub tree URL
- *
- * @example
- * ```typescript
- * toGitHubTreeUrl('.specweave/increments/0001-feature', {
- *   owner: 'anton-abyzov',
- *   repo: 'specweave',
- *   branch: 'develop'
- * });
- * // => 'https://github.com/anton-abyzov/specweave/tree/develop/.specweave/increments/0001-feature'
- * ```
- */
-export function toGitHubTreeUrl(localPath, options) {
-    const { owner, repo, branch = 'develop' } = options;
-    const cleanPath = cleanLocalPath(localPath);
-    return `https://github.com/${owner}/${repo}/tree/${branch}/${cleanPath}`;
-}
-/**
- * Get GitHub URL options from git remote
- *
- * @returns GitHub URL options or null if not a GitHub repository
- */
-export async function getGitHubOptions() {
-    try {
-        const { execFile } = await import('child_process');
-        const { promisify } = await import('util');
-        const execFileAsync = promisify(execFile);
-        // Get remote URL
-        const { stdout } = await execFileAsync('git', ['remote', 'get-url', 'origin']);
-        const remoteUrl = stdout.trim();
-        // Parse GitHub URL (supports both HTTPS and SSH)
-        // HTTPS: https://github.com/owner/repo.git
-        // SSH: git@github.com:owner/repo.git
-        const match = remoteUrl.match(/github\.com[:/]([^/]+)\/(.+?)(?:\.git)?$/);
-        if (!match) {
-            return null;
-        }
-        const [, owner, repo] = match;
-        // Get current branch
-        const { stdout: branchOutput } = await execFileAsync('git', ['branch', '--show-current']);
-        const branch = branchOutput.trim() || 'develop';
-        return { owner, repo, branch };
-    }
-    catch (error) {
-        return null;
-    }
-}
-//# sourceMappingURL=github-url.js.map

package/dist/src/utils/github-url.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"github-url.js","sourceRoot":"","sources":["../../../src/utils/github-url.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;;GAGG;AACH,SAAS,cAAc,CAAC,SAAiB;IACvC,IAAI,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACxC,SAAS,GAAG,cAAc,SAAS,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,OAAyB;IACtE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,OAAO,CAAC;IACpD,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO,sBAAsB,KAAK,IAAI,IAAI,SAAS,MAAM,IAAI,SAAS,EAAE,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,OAAyB;IAC1E,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,OAAO,CAAC;IACpD,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO,sBAAsB,KAAK,IAAI,IAAI,SAAS,MAAM,IAAI,SAAS,EAAE,CAAC;AAC3E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QACnD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QAE1C,iBAAiB;QACjB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC/E,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAEhC,iDAAiD;QACjD,2CAA2C;QAC3C,qCAAqC;QACrC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAE1E,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;QAE9B,qBAAqB;QACrB,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC1F,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;QAEhD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}