Skip to content

Track modern FSEvents full history and docID support #369

Description

@emcrisostomo

Follow-up from review of fsevents_monitor against current macOS FSEvents headers.

The monitor already handles the current event flag family through kFSEventStreamEventFlagItemCloned, but newer stream creation options from macOS 10.15 are not modeled yet:

  • kFSEventStreamCreateFlagFullHistory
  • kFSEventStreamCreateWithDocID
  • kFSEventStreamEventExtendedDocIDKey

Potential scope:

  • Add configure/CMake feature detection for macOS 10.15 FSEvents symbols.
  • Decide whether fswatch should expose historical replay semantics instead of always using kFSEventStreamEventIdSinceNow.
  • Decide whether the public event metadata model should expose docID separately from the existing correlation/file ID.
  • Document limitations and expected behavior when historical replay is unavailable.

This is intentionally separate from smaller stream-option modernizations like WatchRoot, IgnoreSelf, MarkSelf, and CF ownership cleanup.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:backendMonitor backends and platform event APIsarea:macosmacOS and FSEvents behavior

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions