fix: address PR feedback for watcher edge cases

Author: PatrickSys

src/core/file-watcher.ts

@@ -14,7 +14,11 @@ const TRACKED_EXTENSIONS = new Set(
   getSupportedExtensions().map((extension) => extension.toLowerCase())
 );
 
+const TRACKED_METADATA_FILES = new Set(['.gitignore']);
+
 function isTrackedSourcePath(filePath: string): boolean {
+  const basename = path.basename(filePath).toLowerCase();
+  if (TRACKED_METADATA_FILES.has(basename)) return true;
   const extension = path.extname(filePath).toLowerCase();
   return extension.length > 0 && TRACKED_EXTENSIONS.has(extension);
 }

tests/auto-refresh-e2e.test.ts

@@ -44,11 +44,21 @@ async function waitFor(
   intervalMs: number
 ): Promise<void> {
   const startedAt = Date.now();
+  let lastError: unknown;
   while (Date.now() - startedAt < timeoutMs) {
-    if (await condition()) return;
+    try {
+      if (await condition()) return;
+      lastError = undefined;
+    } catch (error) {
+      lastError = error;
+    }
     await sleep(intervalMs);
   }
-  throw new Error(`Timed out after ${timeoutMs}ms waiting for condition`);
+  const reason =
+    lastError instanceof Error && lastError.message
+      ? ` Last transient error: ${lastError.message}`
+      : '';
+  throw new Error(`Timed out after ${timeoutMs}ms waiting for condition.${reason}`);
 }
 
 describe('Auto-refresh E2E', () => {

tests/file-watcher.test.ts

@@ -107,4 +107,26 @@ describe('FileWatcher', () => {
       stop();
     }
   }, 5000);
+
+  it('triggers on .gitignore changes', async () => {
+    const debounceMs = 250;
+    let callCount = 0;
+
+    const stop = startFileWatcher({
+      rootPath: tempDir,
+      debounceMs,
+      onChanged: () => {
+        callCount++;
+      }
+    });
+
+    try {
+      await new Promise((resolve) => setTimeout(resolve, 100));
+      await fs.writeFile(path.join(tempDir, '.gitignore'), 'dist/\n');
+      await new Promise((resolve) => setTimeout(resolve, debounceMs + 700));
+      expect(callCount).toBe(1);
+    } finally {
+      stop();
+    }
+  }, 5000);
 });