diff --git a/src/services/fileWalker.ts b/src/services/fileWalker.ts
index 72becb5..c7263a0 100644
--- a/src/services/fileWalker.ts
+++ b/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[];
 }
 
diff --git a/src/services/git.ts b/src/services/git.ts
index b9c5e65..3da2852 100644
--- a/src/services/git.ts
+++ b/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;
diff --git a/src/services/printScanResult.ts b/src/services/printScanResult.ts
index 234858f..d3a363d 100644
--- a/src/services/printScanResult.ts
+++ b/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;
 }