Method findFirstExistingDirectory

src/utils/file-system.ts:155–183

* Finds the first existing parent directory by walking up the directory tree. * @param dirPath Starting directory path * @returns The first existing directory path, or null if root is reached without finding one

(dirPath: string)

   * @returns The first existing directory path, or null if root is reached without finding one
   */
  private static async findFirstExistingDirectory(dirPath: string): Promise<string | null> {
    let currentDir = dirPath;

    while (true) {
      try {
        const stats = await fs.stat(currentDir);
        if (stats.isDirectory()) {
          return currentDir;
        }
        // Path component exists but is not a directory (edge case)
        console.debug(`Path component ${currentDir} exists but is not a directory`);
        return null;
      } catch (error: any) {
        if (error.code === 'ENOENT') {
          // Directory doesn't exist, move up one level
          const parentDir = path.dirname(currentDir);
          if (parentDir === currentDir) {
            // Reached filesystem root without finding existing directory
            return null;
          }
          currentDir = parentDir;
        } else {
          // Unexpected error (permissions, I/O error, etc.)
          console.debug(`Error checking directory ${currentDir}: ${error.message}`);
          return null;
        }
      }
    }
  }

  static async canWriteFile(filePath: string): Promise<boolean> {
    try {