cleanup: update stale comments

kernel/src/Api/Filesystem.hpp

@@ -62,9 +62,9 @@ namespace montauk::abi {
         if (proc == nullptr) return -1;
 
         // Use a rotating ring of scratch pages below the heap instead of
-        // bumping heapNext on every call. This keeps repeated directory scans
-        // from leaking user heap space while still allowing nested callers to
-        // hold multiple readdir results at once.
+        // extending the heap high-water mark on every call. This keeps repeated
+        // directory scans from consuming user heap address space while still
+        // allowing nested callers to hold multiple readdir results at once.
         uint32_t slot = proc->readdirCursor % Sched::UserReadDirSlots;
         proc->readdirCursor = (slot + 1) % Sched::UserReadDirSlots;
 

kernel/src/Api/Syscall.hpp

@@ -617,7 +617,7 @@ namespace montauk::abi {
         uint8_t  state;        // 0=Free, 1=Ready, 2=Running, 3=Blocked, 4=Terminated
         uint8_t  _pad[3];
         char     name[64];
-        uint64_t heapUsed;     // heapNext - UserHeapBase (bytes)
+        uint64_t heapUsed;     // Distance from UserHeapBase to high-water mark
         uint64_t cpuTimeMs;    // accumulated scheduler runtime
     };