ai-prompt-guide-mcp 1.0.0

package/dist/__tests__/config-path-resolution.test.js

@@ -0,0 +1,88 @@
+/**
+ * Tests for path resolution utilities
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { join } from 'path';
+// Mock process.cwd() before importing the module
+const mockCwd = vi.fn();
+vi.stubGlobal('process', { ...process, cwd: mockCwd });
+describe('Path Resolution Utilities', () => {
+    beforeEach(() => {
+        // Set a consistent mock working directory
+        mockCwd.mockReturnValue('/mock/project/root');
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('getWorkspacePath', async () => {
+        // Dynamic import after mocking
+        const { getWorkspacePath } = await import('../config.js');
+        it('should return absolute paths as-is', () => {
+            const absolutePath = '/absolute/path/to/docs';
+            const result = getWorkspacePath(absolutePath);
+            expect(result).toBe(absolutePath);
+        });
+        it('should resolve relative paths from process.cwd()', () => {
+            const relativePath = 'relative/path/to/docs';
+            const result = getWorkspacePath(relativePath);
+            expect(result).toBe(join('/mock/project/root', relativePath));
+        });
+        it('should resolve paths with ../ correctly', () => {
+            const relativePath = '../parent/docs';
+            const result = getWorkspacePath(relativePath);
+            expect(result).toBe(join('/mock/project/root', relativePath));
+        });
+        it('should resolve paths with ./ correctly', () => {
+            const relativePath = './current/docs';
+            const result = getWorkspacePath(relativePath);
+            expect(result).toBe(join('/mock/project/root', relativePath));
+        });
+    });
+    describe('getWorkflowsPath', async () => {
+        const { getWorkflowsPath } = await import('../config.js');
+        it('should return absolute paths as-is', () => {
+            const absolutePath = '/absolute/path/to/workflows';
+            const result = getWorkflowsPath(absolutePath);
+            expect(result).toBe(absolutePath);
+        });
+        it('should resolve relative paths from process.cwd()', () => {
+            const relativePath = 'relative/path/to/workflows';
+            const result = getWorkflowsPath(relativePath);
+            expect(result).toBe(join('/mock/project/root', relativePath));
+        });
+        it('should resolve paths with ../ correctly', () => {
+            const relativePath = '../parent/workflows';
+            const result = getWorkflowsPath(relativePath);
+            expect(result).toBe(join('/mock/project/root', relativePath));
+        });
+        it('should resolve paths with ./ correctly', () => {
+            const relativePath = './current/workflows';
+            const result = getWorkflowsPath(relativePath);
+            expect(result).toBe(join('/mock/project/root', relativePath));
+        });
+    });
+    describe('getGuidesPath', async () => {
+        const { getGuidesPath } = await import('../config.js');
+        it('should return absolute paths as-is', () => {
+            const absolutePath = '/absolute/path/to/guides';
+            const result = getGuidesPath(absolutePath);
+            expect(result).toBe(absolutePath);
+        });
+        it('should resolve relative paths from process.cwd()', () => {
+            const relativePath = 'relative/path/to/guides';
+            const result = getGuidesPath(relativePath);
+            expect(result).toBe(join('/mock/project/root', relativePath));
+        });
+        it('should resolve paths with ../ correctly', () => {
+            const relativePath = '../parent/guides';
+            const result = getGuidesPath(relativePath);
+            expect(result).toBe(join('/mock/project/root', relativePath));
+        });
+        it('should resolve paths with ./ correctly', () => {
+            const relativePath = './current/guides';
+            const result = getGuidesPath(relativePath);
+            expect(result).toBe(join('/mock/project/root', relativePath));
+        });
+    });
+});
+//# sourceMappingURL=config-path-resolution.test.js.map

package/dist/__tests__/config-path-resolution.test.js.map

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

package/dist/__tests__/config-path-validation.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Tests for path validation in parseEnvironmentVariables
+ * Validates that path existence checks work correctly for required and optional paths
+ */
+export {};
+//# sourceMappingURL=config-path-validation.test.d.ts.map

package/dist/__tests__/config-path-validation.test.d.ts.map

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

package/dist/__tests__/config-path-validation.test.js

@@ -0,0 +1,203 @@
+/**
+ * Tests for path validation in parseEnvironmentVariables
+ * Validates that path existence checks work correctly for required and optional paths
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { mkdirSync, rmSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { loadConfig } from '../config.js';
+describe('Config Path Validation', () => {
+    let tempDir;
+    let originalEnv;
+    let originalCwd;
+    let loggerSpy;
+    beforeEach(async () => {
+        // Save original environment and cwd
+        originalEnv = { ...process.env };
+        originalCwd = process.cwd();
+        // Create temp directory
+        tempDir = join(tmpdir(), `mcp-test-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`);
+        mkdirSync(tempDir, { recursive: true });
+        // Change to temp directory
+        process.chdir(tempDir);
+        // Mock logger
+        const { getGlobalLogger } = await import('../utils/logger.js');
+        const logger = getGlobalLogger();
+        loggerSpy = {
+            warn: vi.spyOn(logger, 'warn'),
+            info: vi.spyOn(logger, 'info')
+        };
+    });
+    afterEach(() => {
+        // Restore environment and cwd
+        process.env = originalEnv;
+        process.chdir(originalCwd);
+        // Clean up temp directory
+        try {
+            rmSync(tempDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        // Clear mocks
+        vi.clearAllMocks();
+    });
+    describe('Required MCP_WORKSPACE_PATH Validation', () => {
+        it('should throw error when MCP_WORKSPACE_PATH does not exist', () => {
+            // Setup: Non-existent docs path
+            const nonExistentPath = join(tempDir, 'non-existent-docs');
+            process.env['MCP_WORKSPACE_PATH'] = nonExistentPath;
+            // Act & Assert: Should throw error for non-existent workspace path
+            expect(() => loadConfig()).toThrow(/Workspace directory does not exist/);
+        });
+        it('should succeed when MCP_WORKSPACE_PATH exists', () => {
+            // Setup: Existing docs path
+            const docsPath = join(tempDir, 'docs');
+            mkdirSync(docsPath, { recursive: true });
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            // Act: Should not throw
+            expect(() => loadConfig()).not.toThrow();
+        });
+        it('should throw error when relative MCP_WORKSPACE_PATH resolves to non-existent directory', () => {
+            // Setup: Relative path that doesn't exist
+            process.env['MCP_WORKSPACE_PATH'] = './non-existent-docs';
+            // Act & Assert: Should throw error after resolution
+            expect(() => loadConfig()).toThrow(/Workspace directory does not exist/);
+        });
+        it('should succeed when relative MCP_WORKSPACE_PATH resolves to existing directory', () => {
+            // Setup: Create directory and use relative path
+            const docsPath = join(tempDir, 'docs');
+            mkdirSync(docsPath, { recursive: true });
+            process.env['MCP_WORKSPACE_PATH'] = './docs';
+            // Act: Should not throw
+            expect(() => loadConfig()).not.toThrow();
+        });
+    });
+    describe('Optional WORKFLOWS_BASE_PATH Validation', () => {
+        it('should log warning when WORKFLOWS_BASE_PATH does not exist', () => {
+            // Setup: Valid docs path, non-existent workflows path
+            const docsPath = join(tempDir, 'docs');
+            mkdirSync(docsPath, { recursive: true });
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            const nonExistentWorkflows = join(tempDir, 'non-existent-workflows');
+            process.env['WORKFLOWS_BASE_PATH'] = nonExistentWorkflows;
+            // Act: Should not throw but log warning
+            expect(() => loadConfig()).not.toThrow();
+            // Assert: Warning should be logged
+            expect(loggerSpy.warn).toHaveBeenCalledWith(expect.stringContaining('WORKFLOWS_BASE_PATH directory does not exist'), expect.objectContaining({
+                path: expect.any(String)
+            }));
+        });
+        it('should not log warning when WORKFLOWS_BASE_PATH exists', () => {
+            // Setup: Valid docs and workflows paths
+            const docsPath = join(tempDir, 'docs');
+            const workflowsPath = join(tempDir, 'workflows');
+            mkdirSync(docsPath, { recursive: true });
+            mkdirSync(workflowsPath, { recursive: true });
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            process.env['WORKFLOWS_BASE_PATH'] = workflowsPath;
+            // Clear previous calls
+            loggerSpy.warn.mockClear();
+            // Act: Should not throw
+            expect(() => loadConfig()).not.toThrow();
+            // Assert: No warning about non-existent WORKFLOWS_BASE_PATH
+            expect(loggerSpy.warn).not.toHaveBeenCalledWith(expect.stringContaining('WORKFLOWS_BASE_PATH directory does not exist'), expect.any(Object));
+        });
+    });
+    describe('Optional GUIDES_BASE_PATH Validation', () => {
+        it('should log warning when GUIDES_BASE_PATH does not exist', () => {
+            // Setup: Valid docs path, non-existent guides path
+            const docsPath = join(tempDir, 'docs');
+            mkdirSync(docsPath, { recursive: true });
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            const nonExistentGuides = join(tempDir, 'non-existent-guides');
+            process.env['GUIDES_BASE_PATH'] = nonExistentGuides;
+            // Act: Should not throw but log warning
+            expect(() => loadConfig()).not.toThrow();
+            // Assert: Warning should be logged
+            expect(loggerSpy.warn).toHaveBeenCalledWith(expect.stringContaining('GUIDES_BASE_PATH directory does not exist'), expect.objectContaining({
+                path: expect.any(String)
+            }));
+        });
+        it('should not log warning when GUIDES_BASE_PATH exists', () => {
+            // Setup: Valid docs and guides paths
+            const docsPath = join(tempDir, 'docs');
+            const guidesPath = join(tempDir, 'guides');
+            mkdirSync(docsPath, { recursive: true });
+            mkdirSync(guidesPath, { recursive: true });
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            process.env['GUIDES_BASE_PATH'] = guidesPath;
+            // Clear previous calls
+            loggerSpy.warn.mockClear();
+            // Act: Should not throw
+            expect(() => loadConfig()).not.toThrow();
+            // Assert: No warning about non-existent GUIDES_BASE_PATH
+            expect(loggerSpy.warn).not.toHaveBeenCalledWith(expect.stringContaining('GUIDES_BASE_PATH directory does not exist'), expect.any(Object));
+        });
+    });
+    describe('Multiple Path Validation', () => {
+        it('should log warnings for multiple non-existent optional paths', () => {
+            // Setup: Valid docs, non-existent workflows and guides
+            const docsPath = join(tempDir, 'docs');
+            mkdirSync(docsPath, { recursive: true });
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            process.env['WORKFLOWS_BASE_PATH'] = join(tempDir, 'non-existent-workflows');
+            process.env['GUIDES_BASE_PATH'] = join(tempDir, 'non-existent-guides');
+            // Act: Should not throw
+            expect(() => loadConfig()).not.toThrow();
+            // Assert: Both warnings logged
+            expect(loggerSpy.warn).toHaveBeenCalledWith(expect.stringContaining('WORKFLOWS_BASE_PATH directory does not exist'), expect.any(Object));
+            expect(loggerSpy.warn).toHaveBeenCalledWith(expect.stringContaining('GUIDES_BASE_PATH directory does not exist'), expect.any(Object));
+        });
+        it('should not log warnings when all paths exist', () => {
+            // Setup: All paths exist
+            const docsPath = join(tempDir, 'docs');
+            const workflowsPath = join(tempDir, 'workflows');
+            const guidesPath = join(tempDir, 'guides');
+            mkdirSync(docsPath, { recursive: true });
+            mkdirSync(workflowsPath, { recursive: true });
+            mkdirSync(guidesPath, { recursive: true });
+            process.env['MCP_WORKSPACE_PATH'] = docsPath;
+            process.env['WORKFLOWS_BASE_PATH'] = workflowsPath;
+            process.env['GUIDES_BASE_PATH'] = guidesPath;
+            // Clear previous calls
+            loggerSpy.warn.mockClear();
+            // Act: Should not throw
+            expect(() => loadConfig()).not.toThrow();
+            // Assert: No path existence warnings
+            expect(loggerSpy.warn).not.toHaveBeenCalledWith(expect.stringMatching(/BASE_PATH directory does not exist/), expect.any(Object));
+        });
+    });
+    describe('Project Config Path Validation', () => {
+        it('should validate paths from .mcp-config.json', () => {
+            // Setup: Create .mcp-config.json with non-existent docs path
+            const nonExistentDocs = join(tempDir, 'config-docs');
+            const configContent = {
+                env: {
+                    MCP_WORKSPACE_PATH: nonExistentDocs
+                }
+            };
+            writeFileSync(join(tempDir, '.mcp-config.json'), JSON.stringify(configContent, null, 2));
+            // Act & Assert: Should throw error
+            expect(() => loadConfig()).toThrow(/Workspace directory does not exist/);
+        });
+        it('should validate optional paths from .mcp-config.json', () => {
+            // Setup: Create .mcp-config.json with valid docs, invalid workflows
+            const docsPath = join(tempDir, 'docs');
+            mkdirSync(docsPath, { recursive: true });
+            const configContent = {
+                env: {
+                    MCP_WORKSPACE_PATH: docsPath,
+                    WORKFLOWS_BASE_PATH: join(tempDir, 'config-workflows-missing')
+                }
+            };
+            writeFileSync(join(tempDir, '.mcp-config.json'), JSON.stringify(configContent, null, 2));
+            // Act: Should not throw
+            expect(() => loadConfig()).not.toThrow();
+            // Assert: Warning logged
+            expect(loggerSpy.warn).toHaveBeenCalledWith(expect.stringContaining('WORKFLOWS_BASE_PATH directory does not exist'), expect.any(Object));
+        });
+    });
+});
+//# sourceMappingURL=config-path-validation.test.js.map

package/dist/__tests__/config-path-validation.test.js.map

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

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

@@ -0,0 +1,5 @@
+/**
+ * Tests for configuration precedence merging between .mcp-config.json and process.env
+ */
+export {};
+//# sourceMappingURL=config-precedence.test.d.ts.map

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

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

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

@@ -0,0 +1,200 @@
+/**
+ * Tests for configuration precedence merging between .mcp-config.json and process.env
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdirSync, writeFileSync, rmSync } from 'fs';
+import { join, dirname } from 'path';
+import { tmpdir } from 'os';
+import { fileURLToPath } from 'url';
+import { loadConfig } from '../config.js';
+import { getGlobalLogger, setGlobalLogger, createSilentLogger } from '../utils/logger.js';
+describe('loadConfig - configuration precedence', () => {
+    let testDir;
+    let originalCwd;
+    let originalEnv;
+    let originalLogger;
+    // Get the plugin's .ai-prompt-guide directory as default paths
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const pluginRoot = join(__dirname, '..', '..');
+    const pluginWorkflowsPath = join(pluginRoot, '.ai-prompt-guide', 'workflows');
+    const pluginGuidesPath = join(pluginRoot, '.ai-prompt-guide', 'guides');
+    beforeEach(() => {
+        // Create a temporary directory for test files
+        testDir = join(tmpdir(), `mcp-config-precedence-test-${Date.now()}`);
+        mkdirSync(testDir, { recursive: true });
+        // Save original cwd and change to test directory
+        originalCwd = process.cwd();
+        process.chdir(testDir);
+        // Save original environment variables
+        originalEnv = {
+            MCP_WORKSPACE_PATH: process.env['MCP_WORKSPACE_PATH'],
+            WORKFLOWS_BASE_PATH: process.env['WORKFLOWS_BASE_PATH'],
+            GUIDES_BASE_PATH: process.env['GUIDES_BASE_PATH']
+        };
+        // Save original logger and set silent logger for tests
+        originalLogger = getGlobalLogger();
+        setGlobalLogger(createSilentLogger());
+    });
+    afterEach(() => {
+        // Restore original cwd
+        process.chdir(originalCwd);
+        // Restore environment variables
+        if (originalEnv['MCP_WORKSPACE_PATH'] != null) {
+            process.env['MCP_WORKSPACE_PATH'] = originalEnv['MCP_WORKSPACE_PATH'];
+        }
+        else {
+            delete process.env['MCP_WORKSPACE_PATH'];
+        }
+        if (originalEnv['WORKFLOWS_BASE_PATH'] != null) {
+            process.env['WORKFLOWS_BASE_PATH'] = originalEnv['WORKFLOWS_BASE_PATH'];
+        }
+        else {
+            delete process.env['WORKFLOWS_BASE_PATH'];
+        }
+        if (originalEnv['GUIDES_BASE_PATH'] != null) {
+            process.env['GUIDES_BASE_PATH'] = originalEnv['GUIDES_BASE_PATH'];
+        }
+        else {
+            delete process.env['GUIDES_BASE_PATH'];
+        }
+        // Clean up test directory
+        try {
+            rmSync(testDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        // Restore original logger
+        setGlobalLogger(originalLogger);
+    });
+    it('uses default config when no .mcp-config.json exists', () => {
+        // Set MCP_WORKSPACE_PATH as it's required
+        process.env['MCP_WORKSPACE_PATH'] = testDir;
+        const config = loadConfig();
+        expect(config.workspaceBasePath).toBe(testDir);
+        expect(config.workflowsBasePath).toBe(pluginWorkflowsPath);
+        expect(config.guidesBasePath).toBe(pluginGuidesPath);
+    });
+    it('project config overrides MCP_WORKSPACE_PATH only', () => {
+        const customDocsPath = join(testDir, 'custom-docs');
+        mkdirSync(customDocsPath, { recursive: true });
+        // Set process.env with all paths
+        process.env['MCP_WORKSPACE_PATH'] = testDir;
+        process.env['WORKFLOWS_BASE_PATH'] = '/env/workflows';
+        process.env['GUIDES_BASE_PATH'] = '/env/guides';
+        // Create .mcp-config.json that overrides only MCP_WORKSPACE_PATH
+        const projectConfig = {
+            env: {
+                MCP_WORKSPACE_PATH: customDocsPath
+            }
+        };
+        writeFileSync(join(testDir, '.mcp-config.json'), JSON.stringify(projectConfig));
+        const config = loadConfig();
+        // Project config should override MCP_WORKSPACE_PATH
+        expect(config.workspaceBasePath).toBe(customDocsPath);
+        // Other paths should use defaults (not process.env values)
+        expect(config.workflowsBasePath).toBe(pluginWorkflowsPath);
+        expect(config.guidesBasePath).toBe(pluginGuidesPath);
+    });
+    it('project config overrides WORKFLOWS_BASE_PATH only', () => {
+        const customWorkflowsPath = join(testDir, 'custom-workflows');
+        mkdirSync(customWorkflowsPath, { recursive: true });
+        // Set required MCP_WORKSPACE_PATH
+        process.env['MCP_WORKSPACE_PATH'] = testDir;
+        process.env['WORKFLOWS_BASE_PATH'] = '/env/workflows';
+        process.env['GUIDES_BASE_PATH'] = '/env/guides';
+        // Create .mcp-config.json that overrides only WORKFLOWS_BASE_PATH
+        const projectConfig = {
+            env: {
+                WORKFLOWS_BASE_PATH: customWorkflowsPath
+            }
+        };
+        writeFileSync(join(testDir, '.mcp-config.json'), JSON.stringify(projectConfig));
+        const config = loadConfig();
+        // MCP_WORKSPACE_PATH should use process.env since not overridden
+        expect(config.workspaceBasePath).toBe(testDir);
+        // Project config should override WORKFLOWS_BASE_PATH
+        expect(config.workflowsBasePath).toBe(customWorkflowsPath);
+        // GUIDES_BASE_PATH should use default
+        expect(config.guidesBasePath).toBe(pluginGuidesPath);
+    });
+    it('project config overrides GUIDES_BASE_PATH only', () => {
+        const customGuidesPath = join(testDir, 'custom-guides');
+        mkdirSync(customGuidesPath, { recursive: true });
+        // Set required MCP_WORKSPACE_PATH
+        process.env['MCP_WORKSPACE_PATH'] = testDir;
+        process.env['WORKFLOWS_BASE_PATH'] = '/env/workflows';
+        process.env['GUIDES_BASE_PATH'] = '/env/guides';
+        // Create .mcp-config.json that overrides only GUIDES_BASE_PATH
+        const projectConfig = {
+            env: {
+                GUIDES_BASE_PATH: customGuidesPath
+            }
+        };
+        writeFileSync(join(testDir, '.mcp-config.json'), JSON.stringify(projectConfig));
+        const config = loadConfig();
+        // MCP_WORKSPACE_PATH should use process.env since not overridden
+        expect(config.workspaceBasePath).toBe(testDir);
+        // WORKFLOWS_BASE_PATH should use default
+        expect(config.workflowsBasePath).toBe(pluginWorkflowsPath);
+        // Project config should override GUIDES_BASE_PATH
+        expect(config.guidesBasePath).toBe(customGuidesPath);
+    });
+    it('project config overrides all three paths', () => {
+        const customDocsPath = join(testDir, 'custom-docs');
+        const customWorkflowsPath = join(testDir, 'custom-workflows');
+        const customGuidesPath = join(testDir, 'custom-guides');
+        mkdirSync(customDocsPath, { recursive: true });
+        mkdirSync(customWorkflowsPath, { recursive: true });
+        mkdirSync(customGuidesPath, { recursive: true });
+        // Set process.env values
+        process.env['MCP_WORKSPACE_PATH'] = '/env/docs';
+        process.env['WORKFLOWS_BASE_PATH'] = '/env/workflows';
+        process.env['GUIDES_BASE_PATH'] = '/env/guides';
+        // Create .mcp-config.json that overrides all paths
+        const projectConfig = {
+            env: {
+                MCP_WORKSPACE_PATH: customDocsPath,
+                WORKFLOWS_BASE_PATH: customWorkflowsPath,
+                GUIDES_BASE_PATH: customGuidesPath
+            }
+        };
+        writeFileSync(join(testDir, '.mcp-config.json'), JSON.stringify(projectConfig));
+        const config = loadConfig();
+        // All paths should use project config values (not process.env)
+        expect(config.workspaceBasePath).toBe(customDocsPath);
+        expect(config.workflowsBasePath).toBe(customWorkflowsPath);
+        expect(config.guidesBasePath).toBe(customGuidesPath);
+    });
+    it('project config takes precedence over process.env for all matching keys', () => {
+        const projectDocsPath = join(testDir, 'project-docs');
+        const projectWorkflowsPath = join(testDir, 'project-workflows');
+        const projectGuidesPath = join(testDir, 'project-guides');
+        mkdirSync(projectDocsPath, { recursive: true });
+        mkdirSync(projectWorkflowsPath, { recursive: true });
+        mkdirSync(projectGuidesPath, { recursive: true });
+        // Set process.env with different values
+        process.env['MCP_WORKSPACE_PATH'] = join(testDir, 'env-docs');
+        process.env['WORKFLOWS_BASE_PATH'] = join(testDir, 'env-workflows');
+        process.env['GUIDES_BASE_PATH'] = join(testDir, 'env-guides');
+        // Create .mcp-config.json with different values
+        const projectConfig = {
+            env: {
+                MCP_WORKSPACE_PATH: projectDocsPath,
+                WORKFLOWS_BASE_PATH: projectWorkflowsPath,
+                GUIDES_BASE_PATH: projectGuidesPath
+            }
+        };
+        writeFileSync(join(testDir, '.mcp-config.json'), JSON.stringify(projectConfig));
+        const config = loadConfig();
+        // Project config should completely override process.env values
+        expect(config.workspaceBasePath).toBe(projectDocsPath);
+        expect(config.workflowsBasePath).toBe(projectWorkflowsPath);
+        expect(config.guidesBasePath).toBe(projectGuidesPath);
+        // Values should NOT be from process.env
+        expect(config.workspaceBasePath).not.toBe(process.env['MCP_WORKSPACE_PATH']);
+        expect(config.workflowsBasePath).not.toBe(process.env['WORKFLOWS_BASE_PATH']);
+        expect(config.guidesBasePath).not.toBe(process.env['GUIDES_BASE_PATH']);
+    });
+});
+//# sourceMappingURL=config-precedence.test.js.map

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

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

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

@@ -0,0 +1,5 @@
+/**
+ * Tests for project configuration types and schema
+ */
+export {};
+//# sourceMappingURL=config-types.test.d.ts.map

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

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