chore: JSDocs for interfaces

src/services/fileWalker.ts

@@ -6,9 +6,15 @@ import {
   DEFAULT_EXCLUDE_PATTERNS,
 } from '../core/patterns.js';
 
+/**
+ * Options for finding files
+ */
 interface FindFilesOptions {
+  /** Include patterns for files to find */
   include?: string[];
+  /** Exclude patterns for files to skip */
   exclude?: string[];
+  /** Specific files to include (overrides include/exclude) */
   files?: string[];
 }
 

src/services/git.ts

@@ -10,6 +10,9 @@ import {
 } from '../config/constants.js';
 import type { GitignoreIssue } from '../config/types.js';
 
+/** 
+ * Options for checking gitignore status
+ */
 interface GitignoreCheckOptions {
   /** Project root directory (default: process.cwd()) */
   cwd?: string;

src/services/printScanResult.ts

@@ -26,10 +26,17 @@ import { printHealthScore } from '../ui/scan/printHealthScore.js';
 import { printExpireWarnings } from '../ui/scan/printExpireWarnings.js';
 import { printInconsistentNamingWarning } from '../ui/scan/printInconsistentNamingWarning.js';
 
+/**
+ * Context for auto-fix operations
+ */
 interface FixContext {
+  /** Whether any fixes were applied */
   fixApplied: boolean;
+  /** List of removed duplicate keys */
   removedDuplicates: string[];
+  /** List of added environment variables */
   addedEnv: string[];
+  /** Whether the .gitignore file was updated */
   gitignoreUpdated: boolean;
 }