ai-prompt-guide-mcp 1.0.0

package/dist/__tests__/config-types.test.js

@@ -0,0 +1,189 @@
+/**
+ * Tests for project configuration types and schema
+ */
+import { describe, it, expect } from 'vitest';
+import { ProjectConfigSchema } from '../config.js';
+describe('ProjectConfig Types and Schema', () => {
+    describe('Valid configurations', () => {
+        it('should validate config with all paths', () => {
+            const config = {
+                env: {
+                    MCP_WORKSPACE_PATH: '/path/to/docs',
+                    WORKFLOWS_BASE_PATH: '/path/to/workflows',
+                    GUIDES_BASE_PATH: '/path/to/guides'
+                }
+            };
+            const result = ProjectConfigSchema.safeParse(config);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.env.MCP_WORKSPACE_PATH).toBe('/path/to/docs');
+                expect(result.data.env.WORKFLOWS_BASE_PATH).toBe('/path/to/workflows');
+                expect(result.data.env.GUIDES_BASE_PATH).toBe('/path/to/guides');
+            }
+        });
+        it('should validate config with partial paths (only MCP_WORKSPACE_PATH)', () => {
+            const config = {
+                env: {
+                    MCP_WORKSPACE_PATH: '/path/to/docs'
+                }
+            };
+            const result = ProjectConfigSchema.safeParse(config);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.env.MCP_WORKSPACE_PATH).toBe('/path/to/docs');
+                expect(result.data.env.WORKFLOWS_BASE_PATH).toBeUndefined();
+                expect(result.data.env.GUIDES_BASE_PATH).toBeUndefined();
+            }
+        });
+        it('should validate config with only WORKFLOWS_BASE_PATH', () => {
+            const config = {
+                env: {
+                    WORKFLOWS_BASE_PATH: '/path/to/workflows'
+                }
+            };
+            const result = ProjectConfigSchema.safeParse(config);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.env.WORKFLOWS_BASE_PATH).toBe('/path/to/workflows');
+                expect(result.data.env.MCP_WORKSPACE_PATH).toBeUndefined();
+                expect(result.data.env.GUIDES_BASE_PATH).toBeUndefined();
+            }
+        });
+        it('should validate config with only GUIDES_BASE_PATH', () => {
+            const config = {
+                env: {
+                    GUIDES_BASE_PATH: '/path/to/guides'
+                }
+            };
+            const result = ProjectConfigSchema.safeParse(config);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.env.GUIDES_BASE_PATH).toBe('/path/to/guides');
+                expect(result.data.env.MCP_WORKSPACE_PATH).toBeUndefined();
+                expect(result.data.env.WORKFLOWS_BASE_PATH).toBeUndefined();
+            }
+        });
+        it('should validate config with empty env object', () => {
+            const config = {
+                env: {}
+            };
+            const result = ProjectConfigSchema.safeParse(config);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.env).toEqual({});
+            }
+        });
+    });
+    describe('Invalid configurations', () => {
+        it('should reject config missing env object', () => {
+            const config = {};
+            const result = ProjectConfigSchema.safeParse(config);
+            expect(result.success).toBe(false);
+            if (!result.success) {
+                expect(result.error.issues).toHaveLength(1);
+                expect(result.error.issues[0]?.path).toEqual(['env']);
+            }
+        });
+        it('should reject config with null env', () => {
+            const config = {
+                env: null
+            };
+            const result = ProjectConfigSchema.safeParse(config);
+            expect(result.success).toBe(false);
+        });
+        it('should reject config with MCP_WORKSPACE_PATH as non-string (number)', () => {
+            const config = {
+                env: {
+                    MCP_WORKSPACE_PATH: 123
+                }
+            };
+            const result = ProjectConfigSchema.safeParse(config);
+            expect(result.success).toBe(false);
+            if (!result.success) {
+                const docsPathError = result.error.issues.find(issue => issue.path.includes('MCP_WORKSPACE_PATH'));
+                expect(docsPathError).toBeDefined();
+            }
+        });
+        it('should reject config with WORKFLOWS_BASE_PATH as non-string (boolean)', () => {
+            const config = {
+                env: {
+                    WORKFLOWS_BASE_PATH: true
+                }
+            };
+            const result = ProjectConfigSchema.safeParse(config);
+            expect(result.success).toBe(false);
+            if (!result.success) {
+                const workflowsPathError = result.error.issues.find(issue => issue.path.includes('WORKFLOWS_BASE_PATH'));
+                expect(workflowsPathError).toBeDefined();
+            }
+        });
+        it('should reject config with GUIDES_BASE_PATH as non-string (array)', () => {
+            const config = {
+                env: {
+                    GUIDES_BASE_PATH: ['/path/to/guides']
+                }
+            };
+            const result = ProjectConfigSchema.safeParse(config);
+            expect(result.success).toBe(false);
+            if (!result.success) {
+                const guidesPathError = result.error.issues.find(issue => issue.path.includes('GUIDES_BASE_PATH'));
+                expect(guidesPathError).toBeDefined();
+            }
+        });
+        it('should reject config with MCP_WORKSPACE_PATH as empty string', () => {
+            const config = {
+                env: {
+                    MCP_WORKSPACE_PATH: ''
+                }
+            };
+            const result = ProjectConfigSchema.safeParse(config);
+            expect(result.success).toBe(false);
+            if (!result.success) {
+                const docsPathError = result.error.issues.find(issue => issue.path.includes('MCP_WORKSPACE_PATH'));
+                expect(docsPathError).toBeDefined();
+            }
+        });
+        it('should reject config with env as array', () => {
+            const config = {
+                env: []
+            };
+            const result = ProjectConfigSchema.safeParse(config);
+            expect(result.success).toBe(false);
+        });
+        it('should reject config with env as string', () => {
+            const config = {
+                env: 'not an object'
+            };
+            const result = ProjectConfigSchema.safeParse(config);
+            expect(result.success).toBe(false);
+        });
+    });
+    describe('Type checking', () => {
+        it('should type-check valid ProjectConfig', () => {
+            const config = {
+                env: {
+                    MCP_WORKSPACE_PATH: '/path/to/docs',
+                    WORKFLOWS_BASE_PATH: '/path/to/workflows',
+                    GUIDES_BASE_PATH: '/path/to/guides'
+                }
+            };
+            expect(config.env.MCP_WORKSPACE_PATH).toBe('/path/to/docs');
+        });
+        it('should type-check ProjectConfig with optional fields', () => {
+            const config = {
+                env: {
+                    MCP_WORKSPACE_PATH: '/path/to/docs'
+                }
+            };
+            expect(config.env.MCP_WORKSPACE_PATH).toBe('/path/to/docs');
+            expect(config.env.WORKFLOWS_BASE_PATH).toBeUndefined();
+        });
+        it('should type-check ProjectConfig with empty env', () => {
+            const config = {
+                env: {}
+            };
+            expect(config.env).toEqual({});
+        });
+    });
+});
+//# sourceMappingURL=config-types.test.js.map

package/dist/__tests__/config-types.test.js.map

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

package/dist/__tests__/config.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Comprehensive unit tests for configuration loading and validation
+ */
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/__tests__/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/config.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/__tests__/config.test.js

@@ -0,0 +1,229 @@
+/**
+ * Comprehensive unit tests for configuration loading and validation
+ */
+import { describe, test, expect, beforeEach, afterEach, vi } from 'vitest';
+import { mkdirSync, rmSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { DEFAULT_CONFIG, ERROR_CODES } from '../constants/defaults.js';
+// Mock the process.env and dotenv
+const originalEnv = process.env;
+let testDir;
+let docsPath;
+// Mock dotenv to prevent loading .env file during tests
+vi.mock('dotenv', () => ({
+    config: vi.fn(() => ({ parsed: {} }))
+}));
+describe('loadConfig', () => {
+    beforeEach(() => {
+        // Create temp directory for test
+        testDir = join(tmpdir(), `mcp-config-test-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`);
+        mkdirSync(testDir, { recursive: true });
+        // Create docs directory
+        docsPath = join(testDir, 'docs');
+        mkdirSync(docsPath, { recursive: true });
+        // Reset modules and environment before each test
+        vi.resetModules();
+        process.env = {};
+    });
+    afterEach(() => {
+        // Clean up temp directory
+        try {
+            rmSync(testDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        // Restore original environment
+        process.env = originalEnv;
+    });
+    describe('referenceExtractionDepth configuration', () => {
+        test('should use default value when REFERENCE_EXTRACTION_DEPTH is not set', async () => {
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            const { loadConfig } = await import('../config.js');
+            const config = loadConfig();
+            expect(config.referenceExtractionDepth).toBe(DEFAULT_CONFIG.REFERENCE_EXTRACTION_DEPTH);
+            expect(config.referenceExtractionDepth).toBe(3);
+        });
+        test('should use valid environment value for REFERENCE_EXTRACTION_DEPTH', async () => {
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            process.env['REFERENCE_EXTRACTION_DEPTH'] = '2';
+            const { loadConfig } = await import('../config.js');
+            const config = loadConfig();
+            expect(config.referenceExtractionDepth).toBe(2);
+        });
+        test('should accept minimum valid value (1)', async () => {
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            process.env['REFERENCE_EXTRACTION_DEPTH'] = '1';
+            const { loadConfig } = await import('../config.js');
+            const config = loadConfig();
+            expect(config.referenceExtractionDepth).toBe(1);
+        });
+        test('should accept maximum valid value (5)', async () => {
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            process.env['REFERENCE_EXTRACTION_DEPTH'] = '5';
+            const { loadConfig } = await import('../config.js');
+            const config = loadConfig();
+            expect(config.referenceExtractionDepth).toBe(5);
+        });
+        test('should throw error for value below minimum (0)', async () => {
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            process.env['REFERENCE_EXTRACTION_DEPTH'] = '0';
+            const { loadConfig } = await import('../config.js');
+            expect(() => loadConfig()).toThrow();
+            try {
+                loadConfig();
+            }
+            catch (error) {
+                const specError = error;
+                expect(specError.code).toBe(ERROR_CODES.ENVIRONMENT_ERROR);
+                expect(specError.message).toContain('REFERENCE_EXTRACTION_DEPTH must be a valid integer between 1 and 5');
+            }
+        });
+        test('should throw error for value above maximum (6)', async () => {
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            process.env['REFERENCE_EXTRACTION_DEPTH'] = '6';
+            const { loadConfig } = await import('../config.js');
+            expect(() => loadConfig()).toThrow();
+            try {
+                loadConfig();
+            }
+            catch (error) {
+                const specError = error;
+                expect(specError.code).toBe(ERROR_CODES.ENVIRONMENT_ERROR);
+                expect(specError.message).toContain('REFERENCE_EXTRACTION_DEPTH must be a valid integer between 1 and 5');
+            }
+        });
+        test('should throw error for negative value', async () => {
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            process.env['REFERENCE_EXTRACTION_DEPTH'] = '-1';
+            const { loadConfig } = await import('../config.js');
+            expect(() => loadConfig()).toThrow();
+            try {
+                loadConfig();
+            }
+            catch (error) {
+                const specError = error;
+                expect(specError.code).toBe(ERROR_CODES.ENVIRONMENT_ERROR);
+                expect(specError.message).toContain('REFERENCE_EXTRACTION_DEPTH must be a number between 1 and 5');
+            }
+        });
+        test('should throw error for non-numeric value', async () => {
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            process.env['REFERENCE_EXTRACTION_DEPTH'] = 'invalid';
+            const { loadConfig } = await import('../config.js');
+            expect(() => loadConfig()).toThrow();
+            try {
+                loadConfig();
+            }
+            catch (error) {
+                const specError = error;
+                expect(specError.code).toBe(ERROR_CODES.ENVIRONMENT_ERROR);
+                expect(specError.message).toContain('REFERENCE_EXTRACTION_DEPTH must be a number between 1 and 5');
+            }
+        });
+        test('should throw error for empty string value', async () => {
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            process.env['REFERENCE_EXTRACTION_DEPTH'] = '';
+            const { loadConfig } = await import('../config.js');
+            expect(() => loadConfig()).toThrow();
+            try {
+                loadConfig();
+            }
+            catch (error) {
+                const specError = error;
+                expect(specError.code).toBe(ERROR_CODES.ENVIRONMENT_ERROR);
+                expect(specError.message).toContain('REFERENCE_EXTRACTION_DEPTH must be a number between 1 and 5');
+            }
+        });
+        test('should throw error for decimal value', async () => {
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            process.env['REFERENCE_EXTRACTION_DEPTH'] = '2.5';
+            const { loadConfig } = await import('../config.js');
+            expect(() => loadConfig()).toThrow();
+            try {
+                loadConfig();
+            }
+            catch (error) {
+                const specError = error;
+                expect(specError.code).toBe(ERROR_CODES.ENVIRONMENT_ERROR);
+                expect(specError.message).toContain('REFERENCE_EXTRACTION_DEPTH must be a number between 1 and 5');
+            }
+        });
+        test('should pass Zod validation for valid referenceExtractionDepth values', async () => {
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            // Test each valid value
+            for (let depth = 1; depth <= 5; depth++) {
+                process.env['REFERENCE_EXTRACTION_DEPTH'] = depth.toString();
+                const { loadConfig } = await import('../config.js');
+                const config = loadConfig();
+                expect(config.referenceExtractionDepth).toBe(depth);
+                expect(typeof config.referenceExtractionDepth).toBe('number');
+                expect(Number.isInteger(config.referenceExtractionDepth)).toBe(true);
+            }
+        });
+    });
+    describe('complete configuration with referenceExtractionDepth', () => {
+        test('should return complete configuration object with all fields including referenceExtractionDepth', async () => {
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            process.env['REFERENCE_EXTRACTION_DEPTH'] = '4';
+            const { loadConfig } = await import('../config.js');
+            const config = loadConfig();
+            // Verify all expected fields are present
+            expect(config).toHaveProperty('serverName');
+            expect(config).toHaveProperty('serverVersion');
+            expect(config).toHaveProperty('logLevel');
+            expect(config).toHaveProperty('workspaceBasePath');
+            expect(config).toHaveProperty('maxFileSize');
+            expect(config).toHaveProperty('maxFilesPerOperation');
+            expect(config).toHaveProperty('rateLimitRequestsPerMinute');
+            expect(config).toHaveProperty('rateLimitBurstSize');
+            expect(config).toHaveProperty('enableFileSafetyChecks');
+            expect(config).toHaveProperty('enableMtimePrecondition');
+            expect(config).toHaveProperty('referenceExtractionDepth');
+            // Verify specific values
+            expect(config.workspaceBasePath).toBe(docsPath);
+            expect(config.referenceExtractionDepth).toBe(4);
+            // Verify types
+            expect(typeof config.referenceExtractionDepth).toBe('number');
+        });
+        test('should maintain backward compatibility when REFERENCE_EXTRACTION_DEPTH is not provided', async () => {
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            // Explicitly ensure REFERENCE_EXTRACTION_DEPTH is not set
+            delete process.env['REFERENCE_EXTRACTION_DEPTH'];
+            const { loadConfig } = await import('../config.js');
+            const config = loadConfig();
+            expect(config.referenceExtractionDepth).toBe(DEFAULT_CONFIG.REFERENCE_EXTRACTION_DEPTH);
+            expect(config.workspaceBasePath).toBe(docsPath);
+        });
+        test('should work with both required and optional configuration together', async () => {
+            const customDocsPath = join(testDir, 'custom-docs');
+            mkdirSync(customDocsPath, { recursive: true });
+            process.env['MCP_WORKSPACE_PATH'] = customDocsPath;
+            process.env['LOG_LEVEL'] = 'debug';
+            process.env['REFERENCE_EXTRACTION_DEPTH'] = '2';
+            process.env['MCP_SERVER_NAME'] = 'custom-server';
+            const { loadConfig } = await import('../config.js');
+            const config = loadConfig();
+            expect(config.workspaceBasePath).toBe(customDocsPath);
+            expect(config.logLevel).toBe('debug');
+            expect(config.referenceExtractionDepth).toBe(2);
+            expect(config.serverName).toBe('custom-server');
+        });
+        test('should use zero-config defaults when MCP_WORKSPACE_PATH is missing', async () => {
+            // Zero-config mode: MCP_WORKSPACE_PATH defaults to process.cwd()
+            process.env['REFERENCE_EXTRACTION_DEPTH'] = '3';
+            delete process.env['MCP_WORKSPACE_PATH'];
+            const { loadConfig } = await import('../config.js');
+            // Should NOT throw - defaults to process.cwd()
+            const config = loadConfig();
+            expect(config.workspaceBasePath).toBe(process.cwd());
+            expect(config.referenceExtractionDepth).toBe(3);
+            // In zero-config mode, paths should use .ai-prompt-guide/ prefix
+            expect(config.docsBasePath).toContain('.ai-prompt-guide/docs');
+            expect(config.archivedBasePath).toContain('.ai-prompt-guide/archived');
+            expect(config.coordinatorBasePath).toContain('.ai-prompt-guide/coordinator');
+        });
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/__tests__/config.test.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Configuration management with Zod validation
+ */
+import { z } from 'zod';
+import type { ServerConfig } from './types/index.js';
+/**
+ * Zod schema for project configuration from .mcp-config.json
+ * All paths are optional and will fallback to defaults if not provided
+ */
+export declare const ProjectConfigSchema: z.ZodObject<{
+    env: z.ZodObject<{
+        MCP_WORKSPACE_PATH: z.ZodOptional<z.ZodString>;
+        WORKFLOWS_BASE_PATH: z.ZodOptional<z.ZodString>;
+        GUIDES_BASE_PATH: z.ZodOptional<z.ZodString>;
+        DOCS_BASE_PATH: z.ZodOptional<z.ZodString>;
+        ARCHIVED_BASE_PATH: z.ZodOptional<z.ZodString>;
+        COORDINATOR_BASE_PATH: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Loads and parses .mcp-config.json from process.cwd()
+ * Returns parsed env object or empty object if file doesn't exist
+ * Logs warnings for invalid JSON or invalid structure
+ */
+export declare function loadProjectConfig(): Record<string, unknown>;
+/**
+ * Loads and validates server configuration
+ * Project config from .mcp-config.json takes precedence over process.env
+ */
+export declare function loadConfig(): ServerConfig;
+/**
+ * Resolves the workspace base path relative to project root
+ *
+ * @param workspacePath - Workspace path from configuration (absolute or relative)
+ * @returns Resolved absolute workspace path
+ *
+ * Note: This function is tested in __tests__/config-path-resolution.test.ts
+ * which is excluded from dead-code checking (see package.json ignoreFiles pattern).
+ */
+export declare function getWorkspacePath(workspacePath: string): string;
+/**
+ * Resolves the workflows base path relative to project root
+ *
+ * @param workflowsPath - Workflows path from configuration (absolute or relative)
+ * @returns Resolved absolute workflows path
+ *
+ * Note: This function is used in prompts/workflow-prompts.ts which is excluded
+ * from dead-code checking (see package.json ignoreFiles pattern). The function
+ * is exported for tool handler usage as per project requirements.
+ */
+export declare function getWorkflowsPath(workflowsPath: string): string;
+/**
+ * Resolves the guides base path relative to project root
+ *
+ * @param guidesPath - Guides path from configuration (absolute or relative)
+ * @returns Resolved absolute guides path
+ *
+ * Note: This function is used in prompts/workflow-prompts.ts which is excluded
+ * from dead-code checking (see package.json ignoreFiles pattern). The function
+ * is exported for tool handler usage as per project requirements.
+ */
+export declare function getGuidesPath(guidesPath: string): string;
+/**
+ * Resolves the docs base path relative to project root
+ *
+ * @param docsPath - Docs path from configuration (absolute or relative)
+ * @returns Resolved absolute docs path
+ */
+export declare function getDocsPath(docsPath: string): string;
+/**
+ * Resolves the archived base path relative to project root
+ *
+ * @param archivedPath - Archived path from configuration (absolute or relative)
+ * @returns Resolved absolute archived path
+ */
+export declare function getArchivedPath(archivedPath: string): string;
+/**
+ * Resolves the coordinator base path relative to project root
+ *
+ * @param coordinatorPath - Coordinator path from configuration (absolute or relative)
+ * @returns Resolved absolute coordinator path
+ *
+ * Note: This function is used in logConfigurationStartup for logging configuration.
+ * It's exported for consistency with other path resolution functions.
+ */
+export declare function getCoordinatorPath(coordinatorPath: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,kBAAkB,CAAC;AA6CpE;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;iBAS9B,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2C3D;AAkTD;;;GAGG;AACH,wBAAgB,UAAU,IAAI,YAAY,CA4CzC;AAeD;;;;;;;;GAQG;AAEH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;;;;GASG;AAEH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;;;;GASG;AAEH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;;;;GAQG;AAEH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAElE"}