From 944016318ba08d5875e3028ddfaae62ba65d3e1b Mon Sep 17 00:00:00 2001
From: Chrilleweb <christian.munknissen@gmail.com>
Date: Tue, 3 Feb 2026 23:00:40 +0100
Subject: [PATCH 1/2] chore: JSDocs for interfaces

---
 src/services/fileWalker.ts | 6 ++++++
 1 file changed, 6 insertions(+)

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[];
 }
 

From 2017c41e20801ec4699d2183046c349829f2c0c5 Mon Sep 17 00:00:00 2001
From: Chrilleweb <christian.munknissen@gmail.com>
Date: Tue, 3 Feb 2026 23:06:10 +0100
Subject: [PATCH 2/2] chore: more jsdocs for interfaces

---
 src/services/git.ts             | 3 +++
 src/services/printScanResult.ts | 7 +++++++
 2 files changed, 10 insertions(+)

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;
 }