@dotcontext/cli 0.8.0

package/dist/services/mcp/gateway/response.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * MCP Response Helpers
+ *
+ * Standardized response creation for MCP tool handlers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createJsonResponse = createJsonResponse;
+exports.createErrorResponse = createErrorResponse;
+exports.createTextResponse = createTextResponse;
+exports.createScaffoldResponse = createScaffoldResponse;
+/**
+ * Creates a successful JSON response for MCP tool handlers.
+ */
+function createJsonResponse(data) {
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(data, null, 2)
+            }]
+    };
+}
+/**
+ * Creates an error response for MCP tool handlers.
+ */
+function createErrorResponse(error) {
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    success: false,
+                    error: error instanceof Error ? error.message : String(error)
+                }, null, 2)
+            }],
+        isError: true
+    };
+}
+/**
+ * Creates a plain text response for MCP tool handlers.
+ */
+function createTextResponse(text) {
+    return {
+        content: [{
+                type: 'text',
+                text
+            }]
+    };
+}
+/**
+ * Creates a scaffold response that includes the enhancement prompt.
+ * This ensures AI agents always receive instructions to enhance generated scaffolding.
+ */
+function createScaffoldResponse(data, options = {}) {
+    const { filesGenerated = 0, pendingFiles = [], repoPath, enhancementPrompt: customPrompt, nextSteps: customNextSteps } = options;
+    const hasFilesToEnhance = filesGenerated > 0 || pendingFiles.length > 0;
+    const hasCustomPrompt = customPrompt || customNextSteps;
+    // Build enhanced response with clear action signals
+    const enhancedData = {
+        // Original data
+        ...data,
+        // Action signals (appear first for visibility)
+        ...(hasFilesToEnhance || hasCustomPrompt) && {
+            _actionRequired: true,
+            _status: hasCustomPrompt && !hasFilesToEnhance ? 'ready' : 'incomplete',
+            _warning: hasCustomPrompt && !hasFilesToEnhance ? 'ACTION SUGGESTED' : 'SCAFFOLDING REQUIRES ENHANCEMENT',
+            // Enhancement instructions
+            enhancementPrompt: customPrompt || buildEnhancementPrompt(pendingFiles, repoPath),
+            // Clear next steps
+            nextSteps: customNextSteps || [
+                'Call context({ action: "listToFill" }) to get files needing content',
+                'For each file, call context({ action: "fillSingle", filePath: "..." })',
+                'Generate content based on the semantic context returned',
+                'Write enhanced content using the Write tool',
+            ],
+            // Files needing enhancement
+            ...(pendingFiles.length > 0 && {
+                pendingEnhancement: pendingFiles,
+                pendingCount: pendingFiles.length,
+            }),
+        },
+    };
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(enhancedData, null, 2)
+            }]
+    };
+}
+/**
+ * Build enhancement prompt for scaffold files.
+ */
+function buildEnhancementPrompt(pendingFiles, repoPath) {
+    const filesList = pendingFiles.slice(0, 5).map((f, i) => `${i + 1}. ${f}`).join('\n');
+    const moreFiles = pendingFiles.length > 5 ? `\n... and ${pendingFiles.length - 5} more files` : '';
+    return `IMPORTANT ENHANCEMENT REQUIRED
+
+Scaffolding has been created but files need codebase-specific content.
+
+Files to enhance:
+${filesList}${moreFiles}
+
+REQUIRED WORKFLOW:
+1. Call context({ action: "fillSingle", filePath: "<file>" }) for each file
+2. Use the returned semantic context to generate rich content
+3. Write the enhanced content to the file
+
+${repoPath ? `Repository: ${repoPath}` : ''}
+
+DO NOT report completion until ALL files have been enhanced.`;
+}
+//# sourceMappingURL=response.js.map

package/dist/services/mcp/gateway/response.js.map

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

package/dist/services/mcp/gateway/shared.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Shared Utilities for Gateway Handlers
+ *
+ * Common utilities used across multiple gateway handlers.
+ */
+/**
+ * Minimal UI interface for services that require UI dependencies.
+ * Returns no-op functions for all UI operations since MCP handlers
+ * return structured data instead of displaying output.
+ */
+export declare const minimalUI: {
+    displayOutput: () => void;
+    displaySuccess: () => void;
+    displayError: () => void;
+    displayInfo: () => void;
+    displayWarning: () => void;
+    displayWelcome: () => void;
+    displayPrevcExplanation: () => void;
+    displayStep: () => void;
+    displayBox: () => void;
+    startSpinner: () => void;
+    stopSpinner: () => void;
+    updateSpinner: () => void;
+    prompt: () => Promise<string>;
+    confirm: () => Promise<boolean>;
+};
+/**
+ * Mock translation function for services that require i18n.
+ */
+export declare const mockTranslate: (key: string) => string;
+/**
+ * Tool execution context for AI tools.
+ */
+export declare const toolContext: {
+    toolCallId: string;
+    messages: never[];
+};
+//# sourceMappingURL=shared.d.ts.map

package/dist/services/mcp/gateway/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;CAerB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,WAAQ,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,WAAW;;;CAAmC,CAAC"}

package/dist/services/mcp/gateway/shared.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Shared Utilities for Gateway Handlers
+ *
+ * Common utilities used across multiple gateway handlers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolContext = exports.mockTranslate = exports.minimalUI = void 0;
+/**
+ * Minimal UI interface for services that require UI dependencies.
+ * Returns no-op functions for all UI operations since MCP handlers
+ * return structured data instead of displaying output.
+ */
+exports.minimalUI = {
+    displayOutput: () => { },
+    displaySuccess: () => { },
+    displayError: () => { },
+    displayInfo: () => { },
+    displayWarning: () => { },
+    displayWelcome: () => { },
+    displayPrevcExplanation: () => { },
+    displayStep: () => { },
+    displayBox: () => { },
+    startSpinner: () => { },
+    stopSpinner: () => { },
+    updateSpinner: () => { },
+    prompt: async () => '',
+    confirm: async () => true,
+};
+/**
+ * Mock translation function for services that require i18n.
+ */
+const mockTranslate = (key) => key;
+exports.mockTranslate = mockTranslate;
+/**
+ * Tool execution context for AI tools.
+ */
+exports.toolContext = { toolCallId: '', messages: [] };
+//# sourceMappingURL=shared.js.map

package/dist/services/mcp/gateway/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/shared.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH;;;;GAIG;AACU,QAAA,SAAS,GAAG;IACvB,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;IACvB,cAAc,EAAE,GAAG,EAAE,GAAE,CAAC;IACxB,YAAY,EAAE,GAAG,EAAE,GAAE,CAAC;IACtB,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;IACrB,cAAc,EAAE,GAAG,EAAE,GAAE,CAAC;IACxB,cAAc,EAAE,GAAG,EAAE,GAAE,CAAC;IACxB,uBAAuB,EAAE,GAAG,EAAE,GAAE,CAAC;IACjC,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;IACrB,UAAU,EAAE,GAAG,EAAE,GAAE,CAAC;IACpB,YAAY,EAAE,GAAG,EAAE,GAAE,CAAC;IACtB,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;IACrB,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;IACvB,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;IACtB,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;CAC1B,CAAC;AAEF;;GAEG;AACI,MAAM,aAAa,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC;AAArC,QAAA,aAAa,iBAAwB;AAElD;;GAEG;AACU,QAAA,WAAW,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC"}

package/dist/services/mcp/gateway/skill.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Skill Gateway Handler
+ *
+ * Handles skill management operations.
+ * Replaces: listSkills, getSkillContent, getSkillsForPhase, scaffoldSkills,
+ *           exportSkills, fillSkills
+ */
+import type { SkillParams } from './types';
+import type { MCPToolResponse } from './response';
+export interface SkillOptions {
+    repoPath: string;
+}
+/**
+ * Handles skill gateway actions for skill management.
+ */
+export declare function handleSkill(params: SkillParams, options: SkillOptions): Promise<MCPToolResponse>;
+//# sourceMappingURL=skill.d.ts.map

package/dist/services/mcp/gateway/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/skill.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB;AA0ID;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,eAAe,CAAC,CAqL1B"}

package/dist/services/mcp/gateway/skill.js

@@ -0,0 +1,323 @@
+"use strict";
+/**
+ * Skill Gateway Handler
+ *
+ * Handles skill management operations.
+ * Replaces: listSkills, getSkillContent, getSkillsForPhase, scaffoldSkills,
+ *           exportSkills, fillSkills
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSkill = handleSkill;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
+const version_1 = require("../../../version");
+const workflow_1 = require("../../../workflow");
+const tools_1 = require("../../ai/tools");
+const response_1 = require("./response");
+const shared_1 = require("./shared");
+/**
+ * Get fill instructions for a skill based on its type.
+ */
+function getSkillFillInstructions(skillSlug) {
+    const instructions = {
+        'commit-message': `Fill this skill with:
+- Commit message format conventions for this project
+- Examples of good commit messages from the codebase
+- Branch naming conventions if applicable
+- Semantic versioning guidelines`,
+        'pr-review': `Fill this skill with:
+- PR review checklist specific to this codebase
+- Code quality standards to check
+- Testing requirements before merge
+- Documentation expectations`,
+        'code-review': `Fill this skill with:
+- Code review guidelines for this project
+- Common patterns to look for
+- Security and performance considerations
+- Style and convention checks`,
+        'test-generation': `Fill this skill with:
+- Testing framework and conventions used
+- Test file organization patterns
+- Mocking strategies for this codebase
+- Coverage requirements`,
+        'documentation': `Fill this skill with:
+- Documentation standards for this project
+- JSDoc/TSDoc conventions
+- README structure expectations
+- API documentation guidelines`,
+        'refactoring': `Fill this skill with:
+- Refactoring patterns common in this codebase
+- Code smell detection guidelines
+- Safe refactoring procedures
+- Testing requirements after refactoring`,
+        'bug-investigation': `Fill this skill with:
+- Debugging workflow for this codebase
+- Common bug patterns and their fixes
+- Logging and error handling conventions
+- Test verification steps`,
+        'feature-breakdown': `Fill this skill with:
+- Feature decomposition approach
+- Task estimation guidelines
+- Dependency identification process
+- Integration points to consider`,
+        'api-design': `Fill this skill with:
+- API design patterns used in this project
+- Endpoint naming conventions
+- Request/response format standards
+- Versioning and deprecation policies`,
+        'security-audit': `Fill this skill with:
+- Security checklist for this codebase
+- Common vulnerabilities to check
+- Authentication/authorization patterns
+- Data validation requirements`,
+    };
+    return instructions[skillSlug] || `Fill this skill with project-specific content for ${skillSlug}:
+- Identify relevant patterns from the codebase
+- Include specific examples from the project
+- Add conventions and best practices
+- Reference important files and components`;
+}
+/**
+ * Build comprehensive fill prompt for skills.
+ */
+function buildSkillFillPrompt(skills, semanticContext) {
+    const lines = [];
+    lines.push('# Skill Fill Instructions');
+    lines.push('');
+    lines.push('You MUST fill each of the following skill files with codebase-specific content.');
+    lines.push('');
+    if (semanticContext) {
+        lines.push('## Codebase Context');
+        lines.push('');
+        lines.push('Use this semantic context to understand the codebase:');
+        lines.push('');
+        lines.push('```');
+        lines.push(semanticContext.length > 6000 ? semanticContext.substring(0, 6000) + '\n...(truncated)' : semanticContext);
+        lines.push('```');
+        lines.push('');
+    }
+    lines.push('## Skills to Fill');
+    lines.push('');
+    for (const skill of skills) {
+        lines.push(`### ${skill.skillName} (${skill.skillSlug})`);
+        lines.push(`**Path:** \`${skill.skillPath}\``);
+        if (skill.description) {
+            lines.push(`**Description:** ${skill.description}`);
+        }
+        lines.push('');
+        lines.push('**Fill Instructions:**');
+        lines.push(skill.instructions);
+        lines.push('');
+    }
+    lines.push('## Action Required');
+    lines.push('');
+    lines.push('For each skill listed above:');
+    lines.push('1. Read the current skill template');
+    lines.push('2. Generate codebase-specific content based on the instructions and context');
+    lines.push('3. Write the filled content to the skill file');
+    lines.push('');
+    lines.push('Each skill should be personalized with:');
+    lines.push('- Specific examples from this codebase');
+    lines.push('- Project-specific conventions and patterns');
+    lines.push('- References to relevant files and components');
+    lines.push('');
+    lines.push('DO NOT leave placeholder text. Each skill must have meaningful, project-specific content.');
+    return lines.join('\n');
+}
+/**
+ * Handles skill gateway actions for skill management.
+ */
+async function handleSkill(params, options) {
+    const repoPath = options.repoPath || process.cwd();
+    const { createSkillRegistry, BUILT_IN_SKILLS } = require('../../../workflow/skills');
+    try {
+        switch (params.action) {
+            case 'list': {
+                const registry = createSkillRegistry(repoPath);
+                const discovered = await registry.discoverAll();
+                const format = (skill) => ({
+                    slug: skill.slug,
+                    name: skill.metadata.name,
+                    description: skill.metadata.description,
+                    phases: skill.metadata.phases || [],
+                    isBuiltIn: skill.isBuiltIn,
+                    ...(params.includeContent ? { content: skill.content } : {}),
+                });
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    totalSkills: discovered.all.length,
+                    builtInCount: discovered.builtIn.length,
+                    customCount: discovered.custom.length,
+                    skills: {
+                        builtIn: discovered.builtIn.map(format),
+                        custom: discovered.custom.map(format),
+                    },
+                });
+            }
+            case 'getContent': {
+                const registry = createSkillRegistry(repoPath);
+                const content = await registry.getSkillContent(params.skillSlug);
+                if (!content) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: `Skill not found: ${params.skillSlug}`,
+                        availableSkills: BUILT_IN_SKILLS,
+                    });
+                }
+                const skill = await registry.getSkillMetadata(params.skillSlug);
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    skill: {
+                        slug: params.skillSlug,
+                        name: skill?.metadata.name,
+                        description: skill?.metadata.description,
+                        phases: skill?.metadata.phases,
+                        isBuiltIn: skill?.isBuiltIn,
+                    },
+                    content,
+                });
+            }
+            case 'getForPhase': {
+                const registry = createSkillRegistry(repoPath);
+                const skills = await registry.getSkillsForPhase(params.phase);
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    phase: params.phase,
+                    phaseName: workflow_1.PHASE_NAMES_EN[params.phase],
+                    skills: skills.map((s) => ({
+                        slug: s.slug,
+                        name: s.metadata.name,
+                        description: s.metadata.description,
+                        isBuiltIn: s.isBuiltIn,
+                    })),
+                    count: skills.length,
+                });
+            }
+            case 'scaffold': {
+                const { createSkillGenerator } = require('../../../generators/skills');
+                const generator = createSkillGenerator({ repoPath });
+                const result = await generator.generate({ skills: params.skills, force: params.includeBuiltIn });
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    skillsDir: result.skillsDir,
+                    generated: result.generatedSkills,
+                    skipped: result.skippedSkills,
+                    indexPath: result.indexPath,
+                });
+            }
+            case 'export': {
+                const { SkillExportService } = require('../../export/skillExportService');
+                const exportService = new SkillExportService({
+                    ui: shared_1.minimalUI,
+                    t: shared_1.mockTranslate,
+                    version: version_1.VERSION,
+                });
+                const result = await exportService.run(repoPath, {
+                    preset: params.preset,
+                    includeBuiltIn: params.includeBuiltIn,
+                    force: false,
+                });
+                return (0, response_1.createJsonResponse)({
+                    success: result.filesCreated > 0,
+                    targets: result.targets,
+                    skillsExported: result.skillsExported,
+                    filesCreated: result.filesCreated,
+                    filesSkipped: result.filesSkipped,
+                });
+            }
+            case 'fill': {
+                const registry = createSkillRegistry(repoPath);
+                const skillsDir = path.join(repoPath, '.context', 'skills');
+                if (!await fs.pathExists(skillsDir)) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'Skills directory does not exist. Run skill({ action: "scaffold" }) first.',
+                        skillsDir,
+                    });
+                }
+                const discovered = await registry.discoverAll();
+                let skillsToFill = discovered.all;
+                if (params.skills && params.skills.length > 0) {
+                    skillsToFill = skillsToFill.filter((s) => params.skills.includes(s.slug));
+                }
+                if (!params.includeBuiltIn) {
+                    skillsToFill = skillsToFill.filter((s) => {
+                        if (!fs.existsSync(s.path))
+                            return true;
+                        const content = fs.readFileSync(s.path, 'utf-8');
+                        return content.includes('<!-- TODO') || content.includes('[PLACEHOLDER]') || content.length < 500;
+                    });
+                }
+                if (skillsToFill.length === 0) {
+                    return (0, response_1.createJsonResponse)({
+                        success: true,
+                        message: 'No skills need filling. Use includeBuiltIn: true to refill existing skills.',
+                        skillsDir,
+                    });
+                }
+                let semanticContext;
+                try {
+                    semanticContext = await (0, tools_1.getOrBuildContext)(repoPath);
+                }
+                catch {
+                    semanticContext = undefined;
+                }
+                const fillInstructions = skillsToFill.map((skill) => ({
+                    skillPath: skill.path,
+                    skillSlug: skill.slug,
+                    skillName: skill.metadata.name || skill.slug,
+                    description: skill.metadata.description || '',
+                    isBuiltIn: skill.isBuiltIn,
+                    instructions: getSkillFillInstructions(skill.slug),
+                }));
+                const fillPrompt = buildSkillFillPrompt(fillInstructions, semanticContext);
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    skillsToFill: fillInstructions,
+                    semanticContext,
+                    fillPrompt,
+                    instructions: 'IMPORTANT: You MUST now fill each skill file using the semantic context and fill instructions provided. Write the content to each skillPath.',
+                });
+            }
+            default:
+                return (0, response_1.createErrorResponse)(`Unknown skill action: ${params.action}`);
+        }
+    }
+    catch (error) {
+        return (0, response_1.createErrorResponse)(error);
+    }
+}
+//# sourceMappingURL=skill.js.map

package/dist/services/mcp/gateway/skill.js.map

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

package/dist/services/mcp/gateway/sync.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Sync Gateway Handler
+ *
+ * Handles import/export synchronization operations.
+ * Replaces: exportRules, exportDocs, exportAgents, exportContext, exportSkills,
+ *           reverseQuickSync, importDocs, importAgents, importSkills
+ */
+import type { SyncParams } from './types';
+import type { MCPToolResponse } from './response';
+export interface SyncOptions {
+    repoPath: string;
+}
+/**
+ * Handles sync gateway actions for import/export operations.
+ */
+export declare function handleSync(params: SyncParams, options: SyncOptions): Promise<MCPToolResponse>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/services/mcp/gateway/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,CAAC,CAgO1B"}