libs/fs_watch/

libs/fs_watch

Real-Time Filesystem Event Watcher

An asynchronous filesystem watcher engineered for hot-reloading development servers, build triggers, and live editor file sync. Listens for file additions, modifications, renames, and deletions with debounced event queuing.

Kernel APIsReadDirectoryChangesW / inotify

Debounce FilterAdjustable 5-50ms

ScaleRecursive 500k+ Files

MilestoneActive Module

Protocol & Wire Format Architecture

Zero-Heap Allocation Primitives

Deterministic Memory

Buffer allocations are bound to caller lifecycle with zero heap fragmentation

RFC Wire Conformance

Strict binary packet layout and protocol compliance written in pure Kale

Monorepo Integration

Instantly consumable by Compiler, Editor, and Bare-Metal targets

Architecture Contract

High-Throughput Systems Foundation

Engineered to maximize CPU instruction pipelining and data cache locality. Every algorithm avoids heap pointer indirection wherever contiguous stack or arena buffers can be employed.

Verification: 138/138 Regression Suite Pass

Signed commit governance • Strict type safety

watch_demo.kl

kale

import "libs/fs_watch/watcher.kl" as fsw;

fn on_file_event(ev: fsw.FileEvent) -> void {
    print("Change detected in: " + ev.path + " (Type: " + ev.kind_str + ")\n");
}

fn main() -> int32 {
    let watcher: fsw.Watcher = fsw.create_watcher();
    fsw.watch_recursive(&watcher, "src/", on_file_event);
    fsw.start_event_loop(&watcher);
    return 0;
}

Compilation & Linker Directives

Deterministic command-line invocations to build, link native dynamic dependencies, and run automated regression tests:

$kale build tests/test_fs_watch.kl -o bin/test_fs_watch.exe

$./bin/test_fs_watch.exe

Monorepo Governance

GPG Key 1B917D4779A6102E • Continuous integration with automated symbol verification.

Architectural Capabilities

Kernel-Level Notifications

Zero CPU polling overhead by leveraging OS native change notification handles.

Debouncing & Deduplication

Coalesces rapid burst modifications from text editors and build tools into clean single events.

Recursive Directory Trees

Watches massive nested project trees with automatic detection of new subfolders.

← Previous Modulelibs/term

Next Module →libs/audio