@vibe-agent-toolkit/utils 0.1.4 → 0.1.5

package/dist/fs-utils.d.ts

@@ -11,4 +11,28 @@
  * await copyDirectory('/source/dir', '/dest/dir');
  */
 export declare function copyDirectory(src: string, dest: string): Promise<void>;
+/**
+ * Verify that a file exists with the exact case-sensitive filename.
+ *
+ * On case-insensitive filesystems (Windows, macOS), a file might be found even if
+ * the case doesn't match. This function checks that the actual filename on disk
+ * matches the requested path exactly (case-sensitive).
+ *
+ * @param filePath - Absolute path to the file to verify
+ * @returns Object with exists flag and actual filename (or null if not found)
+ *
+ * @example
+ * ```typescript
+ * // On case-insensitive filesystem with file "README.md"
+ * const result1 = await verifyCaseSensitiveFilename('/project/README.md');
+ * // { exists: true, actualName: 'README.md' }
+ *
+ * const result2 = await verifyCaseSensitiveFilename('/project/readme.md');
+ * // { exists: false, actualName: 'README.md' } - case mismatch!
+ * ```
+ */
+export declare function verifyCaseSensitiveFilename(filePath: string): Promise<{
+    exists: boolean;
+    actualName: string | null;
+}>;
 //# sourceMappingURL=fs-utils.d.ts.map

package/dist/fs-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs-utils.d.ts","sourceRoot":"","sources":["../src/fs-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5E"}
+{"version":3,"file":"fs-utils.d.ts","sourceRoot":"","sources":["../src/fs-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAmCzD"}

package/dist/fs-utils.js

@@ -28,4 +28,54 @@ export async function copyDirectory(src, dest) {
         }
     }
 }
+/**
+ * Verify that a file exists with the exact case-sensitive filename.
+ *
+ * On case-insensitive filesystems (Windows, macOS), a file might be found even if
+ * the case doesn't match. This function checks that the actual filename on disk
+ * matches the requested path exactly (case-sensitive).
+ *
+ * @param filePath - Absolute path to the file to verify
+ * @returns Object with exists flag and actual filename (or null if not found)
+ *
+ * @example
+ * ```typescript
+ * // On case-insensitive filesystem with file "README.md"
+ * const result1 = await verifyCaseSensitiveFilename('/project/README.md');
+ * // { exists: true, actualName: 'README.md' }
+ *
+ * const result2 = await verifyCaseSensitiveFilename('/project/readme.md');
+ * // { exists: false, actualName: 'README.md' } - case mismatch!
+ * ```
+ */
+export async function verifyCaseSensitiveFilename(filePath) {
+    // Get parent directory and expected filename
+    const parentDir = path.dirname(filePath);
+    const expectedName = path.basename(filePath);
+    // Read actual directory entries
+    let entries;
+    try {
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- parentDir from validated path
+        entries = await fs.readdir(parentDir);
+    }
+    catch {
+        // Parent directory doesn't exist
+        return { exists: false, actualName: null };
+    }
+    // Find the actual filename (case-sensitive exact match)
+    const exactMatch = entries.find(entry => entry === expectedName);
+    if (exactMatch) {
+        // Found exact case match - file exists with correct case
+        return { exists: true, actualName: exactMatch };
+    }
+    // No exact match - check for case-insensitive match
+    const caseInsensitiveMatch = entries.find(entry => entry.toLowerCase() === expectedName.toLowerCase());
+    // Return result:
+    // - If case-insensitive match found: exists=false (wrong case), actualName=<actual>
+    // - If no match at all: exists=false, actualName=null
+    return {
+        exists: false,
+        actualName: caseInsensitiveMatch ?? null,
+    };
+}
 //# sourceMappingURL=fs-utils.js.map

package/dist/fs-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../src/fs-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,IAAY;IAC3D,mGAAmG;IACnG,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,mGAAmG;IACnG,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../src/fs-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,IAAY;IAC3D,mGAAmG;IACnG,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,mGAAmG;IACnG,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,QAAgB;IAEhB,6CAA6C;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE7C,gCAAgC;IAChC,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,oGAAoG;QACpG,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,iCAAiC;QACjC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAC7C,CAAC;IAED,wDAAwD;IACxD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,YAAY,CAAC,CAAC;IAEjE,IAAI,UAAU,EAAE,CAAC;QACf,yDAAyD;QACzD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;IAClD,CAAC;IAED,oDAAoD;IACpD,MAAM,oBAAoB,GAAG,OAAO,CAAC,IAAI,CACvC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,WAAW,EAAE,CAC5D,CAAC;IAEF,iBAAiB;IACjB,oFAAoF;IACpF,sDAAsD;IACtD,OAAO;QACL,MAAM,EAAE,KAAK;QACb,UAAU,EAAE,oBAAoB,IAAI,IAAI;KACzC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-agent-toolkit/utils",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "type": "module",
   "description": "Core utility functions with no external dependencies",
   "keywords": [