feat: support dot-folder scanning via .codesightignore negation (#41)

Scanner previously skipped any entry whose name begins with `.` (except
.env/.env.example/.env.local), making it impossible to scan projects
that keep code under folders like `.source/` or `.config/`.

Add gitignore-style negation: lines prefixed with `!` in .codesightignore
explicitly re-include an entry that would otherwise be skipped, and
negations override positive ignore patterns for the same name.

Example .codesightignore:
    .*
    !.source
    !.config

- Skips most dot-folders (default behavior preserved)
- Walks into .source/ and .config/
- Negation wins when same name appears in both lists

Closes #41

Author: Houseofmvps

package.json

@@ -1,6 +1,6 @@
 {
   "name": "codesight",
-  "version": "1.13.1",
+  "version": "1.14.0",
   "description": "See your codebase clearly. Universal AI context generator that maps routes, schema, components, dependencies, and more for Claude Code, Cursor, Copilot, Codex, and any AI coding tool.",
   "main": "dist/index.js",
   "bin": {

src/scanner.ts

@@ -126,19 +126,41 @@ export async function collectFiles(
 ): Promise<string[]> {
   const files: string[] = [];
 
-  // Build a set of exact dir names to skip (simple patterns like "data", "fixtures")
-  // Also support simple glob-style with trailing /* or /**
-  const extraIgnore = new Set(
-    ignorePatterns.map((p) => p.replace(/\/\*\*?$/, "").replace(/^\//, ""))
-  );
+  // Split positive ignores from gitignore-style negations (`!pattern`). A
+  // negation explicitly re-includes an entry that would otherwise be skipped
+  // — including dot-folders, which are skipped by default.
+  const positivePatterns: string[] = [];
+  const negationPatterns: string[] = [];
+  for (const raw of ignorePatterns) {
+    if (raw.startsWith("!")) {
+      negationPatterns.push(raw.slice(1));
+    } else {
+      positivePatterns.push(raw);
+    }
+  }
+
+  const normalize = (p: string) => p.replace(/\/\*\*?$/, "").replace(/^\//, "");
+  const extraIgnore = new Set(positivePatterns.map(normalize));
+  const negationNames = new Set(negationPatterns.map(normalize));
+
+  function isExplicitlyIncluded(name: string, fullPath: string): boolean {
+    if (negationNames.has(name)) return true;
+    const rel = fullPath.replace(root, "").replace(/^[/\\]/, "");
+    for (const pattern of negationPatterns) {
+      const clean = normalize(pattern);
+      if (rel === clean || rel.startsWith(clean + "/") || rel.startsWith(clean + "\\")) return true;
+    }
+    return false;
+  }
 
   function shouldIgnoreDir(name: string, fullPath: string): boolean {
+    if (isExplicitlyIncluded(name, fullPath)) return false;
     if (IGNORE_DIRS.has(name)) return true;
     if (extraIgnore.has(name)) return true;
     // Check if any pattern matches a path segment
     const rel = fullPath.replace(root, "").replace(/^[/\\]/, "");
-    for (const pattern of ignorePatterns) {
-      const clean = pattern.replace(/\/\*\*?$/, "").replace(/^\//, "");
+    for (const pattern of positivePatterns) {
+      const clean = normalize(pattern);
       if (rel === clean || rel.startsWith(clean + "/") || rel.startsWith(clean + "\\")) return true;
     }
     return false;
@@ -153,8 +175,14 @@ export async function collectFiles(
       return;
     }
     for (const entry of entries) {
-      if (entry.name.startsWith(".") && entry.name !== ".env" && entry.name !== ".env.example" && entry.name !== ".env.local") continue;
       const fullPath = join(dir, entry.name);
+      if (
+        entry.name.startsWith(".") &&
+        entry.name !== ".env" &&
+        entry.name !== ".env.example" &&
+        entry.name !== ".env.local" &&
+        !isExplicitlyIncluded(entry.name, fullPath)
+      ) continue;
       if (entry.isDirectory()) {
         if (shouldIgnoreDir(entry.name, fullPath)) continue;
         await walk(fullPath, depth + 1);

tests/detectors.test.ts

@@ -1300,3 +1300,71 @@ end sub
     );
   });
 });
+
+// =================== DOT-FOLDER INCLUSION TESTS (issue #41) ===================
+
+describe("Dot-folder inclusion via .codesightignore negation", async () => {
+  const mods = await loadModules();
+
+  it("skips dot-folders by default", async () => {
+    const dir = await writeFixture("dotfolder-default-skip", {
+      "package.json": JSON.stringify({ name: "test" }),
+      "src/index.ts": "export const a = 1;",
+      ".source/lib.ts": "export const fromDot = 1;",
+    });
+    const files = await mods.collectFiles(dir);
+    assert.ok(
+      files.some((f: string) => f.endsWith("src/index.ts")),
+      "expected src/index.ts in default scan"
+    );
+    assert.ok(
+      !files.some((f: string) => f.includes(".source/")),
+      `did not expect .source/* in default scan, got: ${files.join(", ")}`
+    );
+  });
+
+  it("includes a dot-folder when explicitly unignored via !.name", async () => {
+    const dir = await writeFixture("dotfolder-negate-include", {
+      "package.json": JSON.stringify({ name: "test" }),
+      "src/index.ts": "export const a = 1;",
+      ".source/lib.ts": "export const fromDot = 1;",
+      ".config/skip.ts": "export const skipped = 1;",
+    });
+    // .codesightignore unignores .source but leaves .config alone
+    const files = await mods.collectFiles(dir, 10, ["!.source"]);
+    assert.ok(
+      files.some((f: string) => f.endsWith(".source/lib.ts")),
+      `expected .source/lib.ts in scan, got: ${files.join(", ")}`
+    );
+    assert.ok(
+      !files.some((f: string) => f.includes(".config/")),
+      `did not expect .config/* in scan, got: ${files.join(", ")}`
+    );
+  });
+
+  it("supports multiple negated dot-folders", async () => {
+    const dir = await writeFixture("dotfolder-multi-negate", {
+      "package.json": JSON.stringify({ name: "test" }),
+      ".source/a.ts": "export const a = 1;",
+      ".config/b.ts": "export const b = 1;",
+      ".hidden/c.ts": "export const c = 1;",
+    });
+    const files = await mods.collectFiles(dir, 10, ["!.source", "!.config"]);
+    assert.ok(files.some((f: string) => f.endsWith(".source/a.ts")), `expected .source/a.ts`);
+    assert.ok(files.some((f: string) => f.endsWith(".config/b.ts")), `expected .config/b.ts`);
+    assert.ok(!files.some((f: string) => f.includes(".hidden/")), `did not expect .hidden/*`);
+  });
+
+  it("negation overrides positive ignore for same name", async () => {
+    const dir = await writeFixture("dotfolder-negate-overrides", {
+      "package.json": JSON.stringify({ name: "test" }),
+      ".source/lib.ts": "export const x = 1;",
+    });
+    // Even if user lists .source as a positive ignore, the negation wins.
+    const files = await mods.collectFiles(dir, 10, [".source", "!.source"]);
+    assert.ok(
+      files.some((f: string) => f.endsWith(".source/lib.ts")),
+      `expected .source/lib.ts (negation should override), got: ${files.join(", ")}`
+    );
+  });
+});