syntax-map-mcp 0.1.5 → 0.1.6

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+## 0.1.6 - 2026-05-06
+
+- 하위 디렉터리의 `.gitignore` 패턴도 인덱싱 대상 파일 제외에 반영하도록 했습니다.
+
 ## 0.1.5 - 2026-05-06
 
 - `express-rate-limit` transitive 의존성을 override해 npm audit 취약점 경고를 제거했습니다.

package/README.md

@@ -45,7 +45,7 @@ npx -y syntax-map-mcp --workspace-root /path/to/workspace
 
 ## SQLite 인덱스
 
-`index_workspace`는 `workspaceRoot` 아래의 `.syntax-map-mcp/index.sqlite`에 인덱스를 저장합니다. 인덱싱 대상은 `.js`, `.jsx`, `.ts`, `.tsx`, `.py` 파일이며, `.git`, `.syntax-map-mcp`, `dist`, `node_modules` 디렉터리와 `workspaceRoot`의 `.gitignore`에 매칭되는 파일은 제외합니다.
+`index_workspace`는 `workspaceRoot` 아래의 `.syntax-map-mcp/index.sqlite`에 인덱스를 저장합니다. 인덱싱 대상은 `.js`, `.jsx`, `.ts`, `.tsx`, `.py` 파일이며, `.git`, `.syntax-map-mcp`, `dist`, `node_modules` 디렉터리와 `workspaceRoot` 아래의 `.gitignore` 패턴에 매칭되는 파일은 제외합니다. 하위 디렉터리의 `.gitignore`는 해당 디렉터리 기준으로 적용합니다.
 
 파일 변경 여부는 `mtimeMs`와 `size`로 판단합니다. 다시 `index_workspace`를 호출하면 변경된 파일만 재파싱하고, 삭제된 파일은 인덱스에서 제거합니다. `search_symbols`, `find_indexed_definition`, `find_indexed_references`는 `isStale`, `staleFiles`, `refreshed`를 반환해 검색 결과가 최신 인덱스 기반인지 알려줍니다. 세 도구에 `refreshIfStale: true`를 전달하면 stale 파일이 있을 때 먼저 인덱스를 갱신한 뒤 검색합니다. 인덱스 검색 도구는 인덱스에 저장된 위치를 조회한 뒤 현재 파일에서 해당 줄 snippet을 읽어 반환합니다. `contextBefore`, `contextAfter`를 0-10 사이 정수로 전달하면 snippet 주변 라인도 함께 반환합니다. `includePreview: true`를 전달하면 `path:line` 헤더와 코드블록으로 구성된 `previewMarkdown`도 함께 반환합니다. 자동 watch 모드는 아직 포함하지 않았습니다.
 

package/dist/workspace.js

@@ -10,22 +10,38 @@ function isInsideRoot(root, candidate) {
 function failure(code, message) {
     return { ok: false, error: { code, message } };
 }
-async function loadGitignore(root) {
+async function loadGitignore(directory) {
     const matcher = ignore();
     try {
-        matcher.add(await readFile(path.join(root, '.gitignore'), 'utf8'));
+        matcher.add(await readFile(path.join(directory, '.gitignore'), 'utf8'));
     }
     catch {
-        // A workspace without .gitignore indexes all supported source files.
+        return undefined;
     }
-    return matcher;
+    return { baseDirectory: directory, matcher };
 }
 function toGitignorePath(relativePath) {
     return relativePath.split(path.sep).join('/');
 }
+function isGitignored(absolutePath, matchers) {
+    let ignored = false;
+    for (const { baseDirectory, matcher } of matchers) {
+        const relativePath = path.relative(baseDirectory, absolutePath);
+        if (relativePath === '' || relativePath.startsWith('..') || path.isAbsolute(relativePath)) {
+            continue;
+        }
+        const result = matcher.test(toGitignorePath(relativePath));
+        if (result.ignored) {
+            ignored = true;
+        }
+        if (result.unignored) {
+            ignored = false;
+        }
+    }
+    return ignored;
+}
 export async function createWorkspace(workspaceRoot) {
     const root = await realpath(path.resolve(workspaceRoot));
-    const gitignore = await loadGitignore(root);
     async function readSourceFile(inputPath) {
         const resolved = path.resolve(root, inputPath);
         if (!isInsideRoot(root, resolved)) {
@@ -62,21 +78,22 @@ export async function createWorkspace(workspaceRoot) {
             mtimeMs: fileStat.mtimeMs
         };
     }
-    async function listSourceFilesInDirectory(directory) {
+    async function listSourceFilesInDirectory(directory, parentMatchers) {
+        const gitignore = await loadGitignore(directory);
+        const matchers = gitignore ? [...parentMatchers, gitignore] : parentMatchers;
         const entries = await readdir(directory, { withFileTypes: true });
         const files = [];
         for (const entry of entries) {
             const absolutePath = path.join(directory, entry.name);
             if (entry.isDirectory()) {
                 if (!EXCLUDED_DIRECTORIES.has(entry.name)) {
-                    files.push(...(await listSourceFilesInDirectory(absolutePath)));
+                    files.push(...(await listSourceFilesInDirectory(absolutePath, matchers)));
                 }
                 continue;
             }
-            const relativeEntryPath = path.relative(root, absolutePath);
             if (!entry.isFile() ||
                 !SUPPORTED_EXTENSIONS.has(path.extname(entry.name)) ||
-                gitignore.ignores(toGitignorePath(relativeEntryPath))) {
+                isGitignored(absolutePath, matchers)) {
                 continue;
             }
             let actualPath;
@@ -109,7 +126,7 @@ export async function createWorkspace(workspaceRoot) {
             return Promise.all(inputPaths.map(readSourceFile));
         },
         listSourceFiles() {
-            return listSourceFilesInDirectory(root);
+            return listSourceFilesInDirectory(root, []);
         }
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "syntax-map-mcp",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Tree-sitter based code analysis MCP server",
   "license": "MIT",
   "type": "module",