@dotcontext/mcp 0.9.0

package/dist/utils/gitignoreManager.js

@@ -0,0 +1,211 @@
+"use strict";
+/**
+ * GitIgnoreManager - Loads and applies .gitignore rules for file filtering.
+ *
+ * Uses the `ignore` library for spec-compliant .gitignore pattern matching.
+ * Caches lookup results via Map for O(1) repeat lookups.
+ * Gracefully falls back to empty rules if no .gitignore exists.
+ *
+ * @see https://github.com/kaelzhang/node-ignore
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitIgnoreManager = void 0;
+exports.ensureGitignorePatterns = ensureGitignorePatterns;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
+const ignore_1 = __importDefault(require("ignore"));
+/**
+ * Default patterns that should always be excluded, regardless of .gitignore content.
+ * These match the original hardcoded excludes from FileMapper.
+ */
+const DEFAULT_EXCLUDE_PATTERNS = [
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '*.log',
+    '.env*',
+    '*.tmp',
+    '.DS_Store',
+];
+class GitIgnoreManager {
+    constructor(options = {}) {
+        this.options = options;
+        this.resultCache = new Map();
+        this.loaded = false;
+        this.ignoreInstance = (0, ignore_1.default)();
+        this.applyDefaults();
+    }
+    /**
+     * Load .gitignore rules from the given repository root.
+     * Safe to call multiple times — resets and reloads each time.
+     *
+     * @param repoPath - Absolute path to the repository root
+     */
+    async loadFromRepo(repoPath) {
+        // Reset for fresh load
+        this.ignoreInstance = (0, ignore_1.default)();
+        this.resultCache.clear();
+        this.loaded = false;
+        // 1. Apply default patterns
+        this.applyDefaults();
+        // 2. Load .gitignore from repo root
+        const gitignorePath = path.join(repoPath, '.gitignore');
+        try {
+            const exists = await fs.pathExists(gitignorePath);
+            if (exists) {
+                const content = await fs.readFile(gitignorePath, 'utf-8');
+                const patterns = this.parseGitignore(content);
+                if (patterns.length > 0) {
+                    this.ignoreInstance.add(patterns);
+                }
+            }
+        }
+        catch {
+            // .gitignore not readable — continue with defaults only
+        }
+        // 3. Apply extra patterns from options
+        if (this.options.extraPatterns && this.options.extraPatterns.length > 0) {
+            this.ignoreInstance.add(this.options.extraPatterns);
+        }
+        this.loaded = true;
+    }
+    /**
+     * Check if a path should be ignored.
+     *
+     * @param relativePath - Path relative to the repository root (forward slashes)
+     * @returns true if the path should be ignored
+     */
+    shouldIgnore(relativePath) {
+        // Normalize to forward slashes for cross-platform consistency
+        const normalized = relativePath.replace(/\\/g, '/');
+        // Empty or root path should not be ignored
+        if (!normalized || normalized === '.' || normalized === '/') {
+            return false;
+        }
+        // Check cache first
+        const cached = this.resultCache.get(normalized);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const result = this.ignoreInstance.ignores(normalized);
+        this.resultCache.set(normalized, result);
+        return result;
+    }
+    /**
+     * Filter an array of relative paths, returning only non-ignored ones.
+     *
+     * @param relativePaths - Array of paths relative to repo root
+     * @returns Filtered array of non-ignored paths
+     */
+    filterPaths(relativePaths) {
+        return relativePaths.filter(p => !this.shouldIgnore(p));
+    }
+    /**
+     * Get all patterns currently loaded (for debugging/logging).
+     */
+    get isLoaded() {
+        return this.loaded;
+    }
+    /**
+     * Clear the result cache. Useful after adding new patterns.
+     */
+    clearCache() {
+        this.resultCache.clear();
+    }
+    /**
+     * Parse .gitignore content into an array of patterns.
+     * Strips comments and empty lines.
+     */
+    parseGitignore(content) {
+        return content
+            .split(/\r?\n/)
+            .map(line => line.trim())
+            .filter(line => line.length > 0 && !line.startsWith('#'));
+    }
+    /**
+     * Apply default exclusion patterns.
+     */
+    applyDefaults() {
+        if (this.options.useDefaults !== false) {
+            this.ignoreInstance.add([...DEFAULT_EXCLUDE_PATTERNS]);
+        }
+    }
+}
+exports.GitIgnoreManager = GitIgnoreManager;
+function normalizeGitignorePattern(pattern) {
+    let normalized = pattern.replace(/\\/g, '/').trim();
+    if (!normalized) {
+        return normalized;
+    }
+    if (normalized.endsWith('/**')) {
+        normalized = `${normalized.slice(0, -3)}/`;
+    }
+    return normalized;
+}
+async function ensureGitignorePatterns(repoPath, patterns, options = {}) {
+    const gitignorePath = path.join(path.resolve(repoPath), '.gitignore');
+    const header = options.header ?? '# dotcontext runtime state';
+    const normalizedPatterns = patterns
+        .map(normalizeGitignorePattern)
+        .filter((pattern, index, list) => Boolean(pattern) && list.indexOf(pattern) === index);
+    const exists = await fs.pathExists(gitignorePath);
+    const original = exists ? await fs.readFile(gitignorePath, 'utf-8') : '';
+    const lines = original.split(/\r?\n/);
+    const existingPatterns = new Set(lines
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !line.startsWith('#')));
+    const missingPatterns = normalizedPatterns.filter((pattern) => !existingPatterns.has(pattern));
+    if (missingPatterns.length === 0) {
+        return { updated: false, addedPatterns: [], gitignorePath };
+    }
+    const outputLines = exists && original.length > 0 ? [...lines] : [];
+    while (outputLines.length > 0 && outputLines[outputLines.length - 1].trim() === '') {
+        outputLines.pop();
+    }
+    if (outputLines.length > 0) {
+        outputLines.push('');
+    }
+    outputLines.push(header);
+    outputLines.push(...missingPatterns);
+    outputLines.push('');
+    await fs.writeFile(gitignorePath, `${outputLines.join('\n')}\n`, 'utf-8');
+    return { updated: true, addedPatterns: missingPatterns, gitignorePath };
+}
+//# sourceMappingURL=gitignoreManager.js.map

package/dist/utils/gitignoreManager.js.map

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