Method ensureWritePermissions

src/utils/file-system.ts:278–315

(dirPath: string)

  }

  static async ensureWritePermissions(dirPath: string): Promise<boolean> {
    try {
      // If directory doesn't exist, check parent directory permissions
      if (!await this.directoryExists(dirPath)) {
        const parentDir = path.dirname(dirPath);
        if (!await this.directoryExists(parentDir)) {
          await this.createDirectory(parentDir);
        }
        return await this.ensureWritePermissions(parentDir);
      }

      const testFile = path.join(dirPath, '.openspec-test-' + Date.now() + '-' + Math.random().toString(36).slice(2));
      await fs.writeFile(testFile, '');

      // On Windows, file may be temporarily locked by antivirus or indexing services.
      // Retry unlink with a small delay if it fails.
      const maxRetries = 3;
      for (let attempt = 0; attempt < maxRetries; attempt++) {
        try {
          await fs.unlink(testFile);
          break;
        } catch (unlinkError: any) {
          if (attempt === maxRetries - 1) {
            // Last attempt failed, but we successfully wrote the file, so permissions are OK
            // Just log and continue - the temp file will be cleaned up eventually
            console.debug(`Could not clean up test file ${testFile}: ${unlinkError.message}`);
          } else {
            // Wait briefly before retrying (Windows file lock release)
            await new Promise((resolve) => setTimeout(resolve, 50));
          }
        }
      }
      return true;
    } catch (error: any) {
      console.debug(`Insufficient permissions to write to ${dirPath}: ${error.message}`);
      return false;
    }
  }
}

/**