@archildata/just-bash 0.8.10 → 0.8.11

package/dist/index.cjs

@@ -615,12 +615,62 @@ function createArchilCommand(client, fs) {
         return ok("Delegations:\n" + lines.join("\n") + "\n");
       } catch (err) {
         return fail(`Failed to list delegations: ${err instanceof Error ? err.message : err}
+`);
+      }
+    }
+    if (subcommand === "invalidate-cache") {
+      const pathArg = args.slice(1).find((a) => !a.startsWith("-"));
+      let scopeLabel = "(mount-wide)";
+      if (pathArg) {
+        const fullPath = fs.resolvePath(ctx.cwd, pathArg);
+        try {
+          await fs.resolveInodeId(fullPath);
+          scopeLabel = `(via ${fullPath})`;
+        } catch (err) {
+          return fail(`Failed to resolve ${fullPath}: ${err instanceof Error ? err.message : err}
+`);
+        }
+      }
+      try {
+        const stats = client.invalidateCache();
+        return ok(
+          `Invalidated cache ${scopeLabel}: ${stats.totalEvictedInodes} inodes evicted (attr=${stats.attribute}, xattr=${stats.extendedAttribute}, dirent=${stats.dirent}, file=${stats.fileData})
+`
+        );
+      } catch (err) {
+        return fail(`Failed to invalidate cache: ${err instanceof Error ? err.message : err}
+`);
+      }
+    }
+    if (subcommand === "set-cache-expiry") {
+      const rest = args.slice(1);
+      const flagIdx = rest.indexOf("--readdir-expiry");
+      if (flagIdx === -1 || flagIdx === rest.length - 1) {
+        return fail("Usage: archil set-cache-expiry <path> --readdir-expiry <seconds>\n");
+      }
+      const flagValueIdx = flagIdx + 1;
+      const expirySeconds = Number(rest[flagValueIdx]);
+      if (!Number.isInteger(expirySeconds) || expirySeconds < 0) {
+        return fail("--readdir-expiry must be a non-negative integer (seconds)\n");
+      }
+      const pathArg = rest.find((a, i) => i !== flagIdx && i !== flagValueIdx && !a.startsWith("-"));
+      if (!pathArg) {
+        return fail("Usage: archil set-cache-expiry <path> --readdir-expiry <seconds>\n");
+      }
+      const fullPath = fs.resolvePath(ctx.cwd, pathArg);
+      try {
+        const inodeId = await fs.resolveInodeId(fullPath);
+        client.setCacheExpiry(inodeId, expirySeconds);
+        return ok(`Set readdir cache expiry for ${fullPath} (inode ${inodeId}) to ${expirySeconds}s
+`);
+      } catch (err) {
+        return fail(`Failed to set cache expiry for ${fullPath}: ${err instanceof Error ? err.message : err}
 `);
       }
     }
     if (subcommand === "help" || !subcommand) {
       return ok(
-        "Archil commands:\n  archil checkout [--force|-f] <path>  - Acquire write delegation\n  archil checkin <path>                - Release write delegation\n  archil list-delegations              - Show held delegations\n  archil help                          - Show this help message\n\nThe --force flag revokes any existing delegation from other clients.\n"
+        "Archil commands:\n  archil checkout [--force|-f] <path>             - Acquire write delegation\n  archil checkin <path>                           - Release write delegation\n  archil list-delegations                         - Show held delegations\n  archil invalidate-cache [<path>]                - Drop every evictable cache entry\n  archil set-cache-expiry <path> --readdir-expiry <secs>\n                                                  - Set readdir cache TTL on a directory\n  archil help                                     - Show this help message\n\nThe --force flag revokes any existing delegation from other clients.\n"
       );
     }
     return fail(`Unknown archil command: ${subcommand}

package/dist/index.d.cts

@@ -169,8 +169,9 @@ declare class ArchilFs implements IFileSystem {
 /**
  * Create the `archil` custom command for use with just-bash.
  *
- * Provides checkout/checkin delegation management and delegation listing
- * as a shell command that works in scripts, pipes, and interactive use.
+ * Provides checkout/checkin delegation management, delegation listing, and
+ * cache control (invalidate-cache, set-cache-expiry) as a shell command that
+ * works in scripts, pipes, and interactive use.
  *
  * @example
  * ```typescript

package/dist/index.d.ts

@@ -169,8 +169,9 @@ declare class ArchilFs implements IFileSystem {
 /**
  * Create the `archil` custom command for use with just-bash.
  *
- * Provides checkout/checkin delegation management and delegation listing
- * as a shell command that works in scripts, pipes, and interactive use.
+ * Provides checkout/checkin delegation management, delegation listing, and
+ * cache control (invalidate-cache, set-cache-expiry) as a shell command that
+ * works in scripts, pipes, and interactive use.
  *
  * @example
  * ```typescript

package/dist/index.js

@@ -577,12 +577,62 @@ function createArchilCommand(client, fs) {
         return ok("Delegations:\n" + lines.join("\n") + "\n");
       } catch (err) {
         return fail(`Failed to list delegations: ${err instanceof Error ? err.message : err}
+`);
+      }
+    }
+    if (subcommand === "invalidate-cache") {
+      const pathArg = args.slice(1).find((a) => !a.startsWith("-"));
+      let scopeLabel = "(mount-wide)";
+      if (pathArg) {
+        const fullPath = fs.resolvePath(ctx.cwd, pathArg);
+        try {
+          await fs.resolveInodeId(fullPath);
+          scopeLabel = `(via ${fullPath})`;
+        } catch (err) {
+          return fail(`Failed to resolve ${fullPath}: ${err instanceof Error ? err.message : err}
+`);
+        }
+      }
+      try {
+        const stats = client.invalidateCache();
+        return ok(
+          `Invalidated cache ${scopeLabel}: ${stats.totalEvictedInodes} inodes evicted (attr=${stats.attribute}, xattr=${stats.extendedAttribute}, dirent=${stats.dirent}, file=${stats.fileData})
+`
+        );
+      } catch (err) {
+        return fail(`Failed to invalidate cache: ${err instanceof Error ? err.message : err}
+`);
+      }
+    }
+    if (subcommand === "set-cache-expiry") {
+      const rest = args.slice(1);
+      const flagIdx = rest.indexOf("--readdir-expiry");
+      if (flagIdx === -1 || flagIdx === rest.length - 1) {
+        return fail("Usage: archil set-cache-expiry <path> --readdir-expiry <seconds>\n");
+      }
+      const flagValueIdx = flagIdx + 1;
+      const expirySeconds = Number(rest[flagValueIdx]);
+      if (!Number.isInteger(expirySeconds) || expirySeconds < 0) {
+        return fail("--readdir-expiry must be a non-negative integer (seconds)\n");
+      }
+      const pathArg = rest.find((a, i) => i !== flagIdx && i !== flagValueIdx && !a.startsWith("-"));
+      if (!pathArg) {
+        return fail("Usage: archil set-cache-expiry <path> --readdir-expiry <seconds>\n");
+      }
+      const fullPath = fs.resolvePath(ctx.cwd, pathArg);
+      try {
+        const inodeId = await fs.resolveInodeId(fullPath);
+        client.setCacheExpiry(inodeId, expirySeconds);
+        return ok(`Set readdir cache expiry for ${fullPath} (inode ${inodeId}) to ${expirySeconds}s
+`);
+      } catch (err) {
+        return fail(`Failed to set cache expiry for ${fullPath}: ${err instanceof Error ? err.message : err}
 `);
       }
     }
     if (subcommand === "help" || !subcommand) {
       return ok(
-        "Archil commands:\n  archil checkout [--force|-f] <path>  - Acquire write delegation\n  archil checkin <path>                - Release write delegation\n  archil list-delegations              - Show held delegations\n  archil help                          - Show this help message\n\nThe --force flag revokes any existing delegation from other clients.\n"
+        "Archil commands:\n  archil checkout [--force|-f] <path>             - Acquire write delegation\n  archil checkin <path>                           - Release write delegation\n  archil list-delegations                         - Show held delegations\n  archil invalidate-cache [<path>]                - Drop every evictable cache entry\n  archil set-cache-expiry <path> --readdir-expiry <secs>\n                                                  - Set readdir cache TTL on a directory\n  archil help                                     - Show this help message\n\nThe --force flag revokes any existing delegation from other clients.\n"
       );
     }
     return fail(`Unknown archil command: ${subcommand}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archildata/just-bash",
-  "version": "0.8.10",
+  "version": "0.8.11",
   "description": "Archil filesystem adapter for just-bash",
   "type": "module",
   "main": "dist/index.cjs",
@@ -26,10 +26,10 @@
     "shell": "tsx bin/shell.ts"
   },
   "dependencies": {
-    "@archildata/native": "^0.8.10",
+    "@archildata/native": "^0.8.11",
     "commander": "^14.0.3",
     "debug": "^4.3.4",
-    "disk": "^0.8.10",
+    "disk": "^0.8.11",
     "just-bash": "^2.7.0"
   },
   "devDependencies": {