Module files 

File coordination tools (advisory marks and exclusive locks).

Supports two modes:

• Advisory marks (default): warns if another agent holds a file mark.
• Exclusive locks (lock: prefix): rejects with error if another agent holds the lock.

The lock: namespace uses the same file_locks table but enforces mutual exclusion. Example: mark_file(file="lock:git-commit") acquires an exclusive lock on the resource “git-commit”. Another agent attempting the same lock will receive an error.

Functions

get_tools

list_marks

mark_file

mark_updates

Synchronous version of mark_updates.

mark_updates_async

Async version of mark_updates.

unmark_file