@ai-ecoverse/slicc-kernel 1.110.0 → 1.110.1

package/README.md

@@ -880,7 +880,7 @@ Not covered: hard links (OPFS cannot share contents between names; they work onl
 
 Reads retry briefly when a concurrent write has invalidated the OPFS file snapshot (`NotReadableError`).
 
-A kernel caches the directory handles it has walked and the sidecar entries it has read. Its own changes keep both caches current, and the other kernels on the origin hear of them through a `BroadcastChannel` named after the database (one for the sidecar, one for directories). A cached directory is checked against its path (`resolve()`) at most once a second before a lookup goes through it, so a directory moved, removed or replaced by another writer, such as a page using the OPFS API, is found at its new place or reported missing within a second.
+A kernel caches the directory handles it has walked and the sidecar entries it has read. Its own changes keep both caches current, and the other kernels on the origin hear of them through a `BroadcastChannel` named after the database (one for the sidecar, one for directories). A cached directory is checked against its path (`resolve()`) at most once a second before a lookup goes through it, so a directory moved, removed or replaced by another writer, such as a page using the OPFS API, is found at its new place or reported missing within a second. It also keeps the file handles it has looked up (up to 4,096, the least recently used dropped first) for a second after each lookup. Before it uses one, it reads the file through it, which is the read a `stat` needs anyway, so a file another writer removed is missing at once and a rewritten one shows its new contents. One replaced by a directory is seen as a directory within a second. Its own changes, and the other kernels' notices, drop the handles they touch at once.
 
 The filesystem is our own rather than [ZenFS](https://github.com/zen-fs/core) (which SLICC uses), because OPFS stays the single source of truth: other writers, such as the BIOS installing packages or a page writing files, need no index to stay consistent with, and nothing is preloaded into memory at mount. POSIX metadata lives in the IndexedDB sidecar described above, which has per-entry transactions instead of one JSON file rewritten on every change.
 

package/dist/kernel-worker.js

@@ -984,6 +984,8 @@ var S_ISGID2 = 1024;
 var READ_ATTEMPTS = 3;
 var MAX_LINKS2 = 40;
 var CHECK_MS = 1e3;
+var FILE_HANDLES = 4096;
+var STALE = /* @__PURE__ */ new Set(["NotFoundError", "TypeMismatchError"]);
 var EXECUTABLE = /\/node_modules\/(?:@[^/]+\/)?[^/]+\/bin\//;
 var ERRNO_BY_DOM_ERROR = {
   NotFoundError: "ENOENT",
@@ -1109,6 +1111,9 @@ var OpfsFs = class {
   root;
   meta;
   dirs = new PathMap();
+  files = new PathMap();
+  snapshots = /* @__PURE__ */ new WeakMap();
+  found = /* @__PURE__ */ new WeakMap();
   checked = /* @__PURE__ */ new WeakMap();
   channel;
   remote;
@@ -1346,6 +1351,19 @@ var OpfsFs = class {
   }
   forget(path) {
     this.dirs.deleteTree(path);
+    this.files.deleteTree(path);
+  }
+  remember(path, handle, looked = false) {
+    if (handle.kind !== "file") return handle;
+    if (looked) {
+      this.found.set(handle, performance.now());
+      this.snapshots.delete(handle);
+    }
+    this.files.delete(path);
+    if (this.files.size >= FILE_HANDLES)
+      this.files.delete(this.files.keys().next().value);
+    this.files.set(path, handle);
+    return handle;
   }
   async inDir(path, op) {
     const dir = await this.dir(path);
@@ -1369,16 +1387,30 @@ var OpfsFs = class {
   }
   async handle(path) {
     if (split(path).length === 0) return this.root;
+    const cached = this.files.get(path);
+    const fresh2 = cached && performance.now() - (this.found.get(cached) ?? -CHECK_MS) < CHECK_MS;
+    if (cached && !fresh2) this.files.delete(path);
+    if (cached && fresh2) {
+      try {
+        this.snapshots.set(cached, await cached.getFile());
+        return this.remember(path, cached);
+      } catch (err) {
+        if (!STALE.has(err?.name))
+          throw translate(err, path, "read");
+        this.files.delete(path);
+        this.snapshots.delete(cached);
+      }
+    }
     const [dir, name2] = await this.parent(path);
     const known = this.dirs.has(path);
     return this.inDir(dir, async (parent) => {
       const [first, second] = known ? ["directory", "file"] : ["file", "directory"];
       try {
-        return await this.child(parent, name2, first);
+        return this.remember(path, await this.child(parent, name2, first), true);
       } catch (err) {
         if (err?.name !== "TypeMismatchError") throw err;
       }
-      return this.child(parent, name2, second);
+      return this.remember(path, await this.child(parent, name2, second), true);
     }).catch((err) => {
       throw translate(err, path);
     });
@@ -1521,9 +1553,15 @@ var OpfsFs = class {
       if (this.dirTimes.get(path) === ms) this.dirTimes.delete(path);
     }
   }
+  async snapshot(handle) {
+    const taken = this.snapshots.get(handle);
+    if (!taken) return handle.getFile();
+    this.snapshots.delete(handle);
+    return taken;
+  }
   async statOf(path, handle, meta, touched) {
     const directory = handle.kind === "directory";
-    const file = directory ? void 0 : await handle.getFile();
+    const file = directory ? void 0 : await this.snapshot(handle);
     const modified = file?.lastModified ?? 0;
     const kept = meta?.mtimeMs !== void 0 && meta.mtimeFor === modified ? meta.mtimeMs : modified;
     const mtime = touched ?? kept;
@@ -6108,7 +6146,7 @@ function satisfies(version, range2) {
 }
 
 // src/version.ts
-var KERNEL_VERSION = true ? "1.110.0" : "0.0.0-dev";
+var KERNEL_VERSION = true ? "1.110.1" : "0.0.0-dev";
 var OS_RELEASE = "6.0.0-slicc";
 function procVersion() {
   return `Linux version ${OS_RELEASE} (slicc-kernel ${KERNEL_VERSION}) #1 SMP PREEMPT_DYNAMIC