Method canWriteFile

src/utils/file-system.ts:185–216

(filePath: string)

  }

  static async canWriteFile(filePath: string): Promise<boolean> {
    try {
      const stats = await fs.stat(filePath);

      if (stats.isDirectory()) {
        return hasWritableModeAndAccess(filePath);
      }

      if (!stats.isFile()) {
        return true;
      }

      return hasWritableModeAndAccess(filePath);
    } catch (error: any) {
      if (error.code === 'ENOENT') {
        // File doesn't exist - find first existing parent directory and check its permissions
        const parentDir = path.dirname(filePath);
        const existingDir = await this.findFirstExistingDirectory(parentDir);

        if (existingDir === null) {
          // No existing parent directory found (edge case)
          return false;
        }

        // Check if the existing parent directory is writable.
        return hasWritableModeAndAccess(existingDir);
      }

      console.debug(`Unable to determine write permissions for ${filePath}: ${error.message}`);
      return false;
    }
  }

  static async directoryExists(dirPath: string): Promise<boolean> {
    try {