@fnndsc/cumin 3.16.1 → 3.17.0

package/dist/cache/index.d.ts

@@ -3,12 +3,13 @@
  *
  * @module
  */
-export { ListCache, listCache_get } from './listCache.js';
+export { ListCache, listCache_get, LIST_CACHE_SIGNAL_BACKED_TTL_MS, LIST_CACHE_SIGNAL_FREE_TTL_MS, LIST_CACHE_PLUGIN_INDEX_TTL_MS, LIST_CACHE_MAX_ENTRIES, } from './listCache.js';
 export type { CacheStats, CacheResult, CacheOptions, ListCacheSnapshot, ListCacheEntrySnapshot } from './listCache.js';
 export { listCheckpointPath_get, listCheckpoint_restore, listCheckpoint_save, listCheckpoint_watch, } from './listCheckpoint.js';
 export type { ListCheckpointRestoreResult } from './listCheckpoint.js';
-export { ProcCache, procCache_get, status_isTerminal, feed_isActive, feedTopology_changed, PROC_TERMINAL_STATUSES } from './procCache.js';
-export type { ProcInstance, ProcFeed, ProcFeedScopeCounts, ProcWarmupProgress, ProcCacheState, ProcCacheLifecycle, ProcCacheSnapshot, ProcFeedSnapshot, ProcCacheChange, ProcCacheListener, } from './procCache.js';
+export { listingsForFeeds_note, listingsForFeeds_drop, listingsForRoster_note, listingInvalidation_flush, listingInvalidation_reset, LISTING_INVALIDATION_WINDOW_MS, } from './listingInvalidation.js';
+export { ProcCache, procCache_get, status_isTerminal, feed_isActive, feedTopology_changed, PROC_TERMINAL_STATUSES, PROC_ARRIVAL_TTL_MS } from './procCache.js';
+export type { RosterFolders, ProcInstance, ProcFeed, ProcFeedScopeCounts, ProcWarmupProgress, ProcFeedLoadProgress, ProcCacheState, ProcCacheLifecycle, ProcCacheSnapshot, ProcFeedSnapshot, ProcCacheChange, ProcCacheListener, } from './procCache.js';
 export type { ProcPromptState, ProcPromptProgress } from '@fnndsc/menu';
 export { procCheckpointPath_get, procCheckpointDir_get, procCheckpoint_restore, procCheckpoint_save, procCheckpointFeed_save, procCheckpointRoster_save, procCheckpoint_watch, } from './procCheckpoint.js';
 export type { ProcCheckpointRestoreResult } from './procCheckpoint.js';

package/dist/cache/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.procCheckpoint_watch = exports.procCheckpointRoster_save = exports.procCheckpointFeed_save = exports.procCheckpoint_save = exports.procCheckpoint_restore = exports.procCheckpointDir_get = exports.procCheckpointPath_get = exports.PROC_TERMINAL_STATUSES = exports.feedTopology_changed = exports.feed_isActive = exports.status_isTerminal = exports.procCache_get = exports.ProcCache = exports.listCheckpoint_watch = exports.listCheckpoint_save = exports.listCheckpoint_restore = exports.listCheckpointPath_get = exports.listCache_get = exports.ListCache = void 0;
+exports.procCheckpoint_watch = exports.procCheckpointRoster_save = exports.procCheckpointFeed_save = exports.procCheckpoint_save = exports.procCheckpoint_restore = exports.procCheckpointDir_get = exports.procCheckpointPath_get = exports.PROC_ARRIVAL_TTL_MS = exports.PROC_TERMINAL_STATUSES = exports.feedTopology_changed = exports.feed_isActive = exports.status_isTerminal = exports.procCache_get = exports.ProcCache = exports.LISTING_INVALIDATION_WINDOW_MS = exports.listingInvalidation_reset = exports.listingInvalidation_flush = exports.listingsForRoster_note = exports.listingsForFeeds_drop = exports.listingsForFeeds_note = exports.listCheckpoint_watch = exports.listCheckpoint_save = exports.listCheckpoint_restore = exports.listCheckpointPath_get = exports.LIST_CACHE_MAX_ENTRIES = exports.LIST_CACHE_PLUGIN_INDEX_TTL_MS = exports.LIST_CACHE_SIGNAL_FREE_TTL_MS = exports.LIST_CACHE_SIGNAL_BACKED_TTL_MS = exports.listCache_get = exports.ListCache = void 0;
 /**
  * @file Cache module exports.
  *
@@ -9,11 +9,22 @@ exports.procCheckpoint_watch = exports.procCheckpointRoster_save = exports.procC
 var listCache_js_1 = require("./listCache.js");
 Object.defineProperty(exports, "ListCache", { enumerable: true, get: function () { return listCache_js_1.ListCache; } });
 Object.defineProperty(exports, "listCache_get", { enumerable: true, get: function () { return listCache_js_1.listCache_get; } });
+Object.defineProperty(exports, "LIST_CACHE_SIGNAL_BACKED_TTL_MS", { enumerable: true, get: function () { return listCache_js_1.LIST_CACHE_SIGNAL_BACKED_TTL_MS; } });
+Object.defineProperty(exports, "LIST_CACHE_SIGNAL_FREE_TTL_MS", { enumerable: true, get: function () { return listCache_js_1.LIST_CACHE_SIGNAL_FREE_TTL_MS; } });
+Object.defineProperty(exports, "LIST_CACHE_PLUGIN_INDEX_TTL_MS", { enumerable: true, get: function () { return listCache_js_1.LIST_CACHE_PLUGIN_INDEX_TTL_MS; } });
+Object.defineProperty(exports, "LIST_CACHE_MAX_ENTRIES", { enumerable: true, get: function () { return listCache_js_1.LIST_CACHE_MAX_ENTRIES; } });
 var listCheckpoint_js_1 = require("./listCheckpoint.js");
 Object.defineProperty(exports, "listCheckpointPath_get", { enumerable: true, get: function () { return listCheckpoint_js_1.listCheckpointPath_get; } });
 Object.defineProperty(exports, "listCheckpoint_restore", { enumerable: true, get: function () { return listCheckpoint_js_1.listCheckpoint_restore; } });
 Object.defineProperty(exports, "listCheckpoint_save", { enumerable: true, get: function () { return listCheckpoint_js_1.listCheckpoint_save; } });
 Object.defineProperty(exports, "listCheckpoint_watch", { enumerable: true, get: function () { return listCheckpoint_js_1.listCheckpoint_watch; } });
+var listingInvalidation_js_1 = require("./listingInvalidation.js");
+Object.defineProperty(exports, "listingsForFeeds_note", { enumerable: true, get: function () { return listingInvalidation_js_1.listingsForFeeds_note; } });
+Object.defineProperty(exports, "listingsForFeeds_drop", { enumerable: true, get: function () { return listingInvalidation_js_1.listingsForFeeds_drop; } });
+Object.defineProperty(exports, "listingsForRoster_note", { enumerable: true, get: function () { return listingInvalidation_js_1.listingsForRoster_note; } });
+Object.defineProperty(exports, "listingInvalidation_flush", { enumerable: true, get: function () { return listingInvalidation_js_1.listingInvalidation_flush; } });
+Object.defineProperty(exports, "listingInvalidation_reset", { enumerable: true, get: function () { return listingInvalidation_js_1.listingInvalidation_reset; } });
+Object.defineProperty(exports, "LISTING_INVALIDATION_WINDOW_MS", { enumerable: true, get: function () { return listingInvalidation_js_1.LISTING_INVALIDATION_WINDOW_MS; } });
 var procCache_js_1 = require("./procCache.js");
 Object.defineProperty(exports, "ProcCache", { enumerable: true, get: function () { return procCache_js_1.ProcCache; } });
 Object.defineProperty(exports, "procCache_get", { enumerable: true, get: function () { return procCache_js_1.procCache_get; } });
@@ -21,6 +32,7 @@ Object.defineProperty(exports, "status_isTerminal", { enumerable: true, get: fun
 Object.defineProperty(exports, "feed_isActive", { enumerable: true, get: function () { return procCache_js_1.feed_isActive; } });
 Object.defineProperty(exports, "feedTopology_changed", { enumerable: true, get: function () { return procCache_js_1.feedTopology_changed; } });
 Object.defineProperty(exports, "PROC_TERMINAL_STATUSES", { enumerable: true, get: function () { return procCache_js_1.PROC_TERMINAL_STATUSES; } });
+Object.defineProperty(exports, "PROC_ARRIVAL_TTL_MS", { enumerable: true, get: function () { return procCache_js_1.PROC_ARRIVAL_TTL_MS; } });
 var procCheckpoint_js_1 = require("./procCheckpoint.js");
 Object.defineProperty(exports, "procCheckpointPath_get", { enumerable: true, get: function () { return procCheckpoint_js_1.procCheckpointPath_get; } });
 Object.defineProperty(exports, "procCheckpointDir_get", { enumerable: true, get: function () { return procCheckpoint_js_1.procCheckpointDir_get; } });

package/dist/cache/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,+CAA0D;AAAjD,yGAAA,SAAS,OAAA;AAAE,6GAAA,aAAa,OAAA;AAEjC,yDAK6B;AAJ3B,2HAAA,sBAAsB,OAAA;AACtB,2HAAA,sBAAsB,OAAA;AACtB,wHAAA,mBAAmB,OAAA;AACnB,yHAAA,oBAAoB,OAAA;AAGtB,+CAA0I;AAAjI,yGAAA,SAAS,OAAA;AAAE,6GAAA,aAAa,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AAAE,6GAAA,aAAa,OAAA;AAAE,oHAAA,oBAAoB,OAAA;AAAE,sHAAA,sBAAsB,OAAA;AAwBjH,yDAQ6B;AAP3B,2HAAA,sBAAsB,OAAA;AACtB,0HAAA,qBAAqB,OAAA;AACrB,2HAAA,sBAAsB,OAAA;AACtB,wHAAA,mBAAmB,OAAA;AACnB,4HAAA,uBAAuB,OAAA;AACvB,8HAAA,yBAAyB,OAAA;AACzB,yHAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,+CAOwB;AANtB,yGAAA,SAAS,OAAA;AACT,6GAAA,aAAa,OAAA;AACb,+HAAA,+BAA+B,OAAA;AAC/B,6HAAA,6BAA6B,OAAA;AAC7B,8HAAA,8BAA8B,OAAA;AAC9B,sHAAA,sBAAsB,OAAA;AAGxB,yDAK6B;AAJ3B,2HAAA,sBAAsB,OAAA;AACtB,2HAAA,sBAAsB,OAAA;AACtB,wHAAA,mBAAmB,OAAA;AACnB,yHAAA,oBAAoB,OAAA;AAGtB,mEAOkC;AANhC,+HAAA,qBAAqB,OAAA;AACrB,+HAAA,qBAAqB,OAAA;AACrB,gIAAA,sBAAsB,OAAA;AACtB,mIAAA,yBAAyB,OAAA;AACzB,mIAAA,yBAAyB,OAAA;AACzB,wIAAA,8BAA8B,OAAA;AAEhC,+CAA+J;AAAtJ,yGAAA,SAAS,OAAA;AAAE,6GAAA,aAAa,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AAAE,6GAAA,aAAa,OAAA;AAAE,oHAAA,oBAAoB,OAAA;AAAE,sHAAA,sBAAsB,OAAA;AAAE,mHAAA,mBAAmB,OAAA;AA0BtI,yDAQ6B;AAP3B,2HAAA,sBAAsB,OAAA;AACtB,0HAAA,qBAAqB,OAAA;AACrB,2HAAA,sBAAsB,OAAA;AACtB,wHAAA,mBAAmB,OAAA;AACnB,4HAAA,uBAAuB,OAAA;AACvB,8HAAA,yBAAyB,OAAA;AACzB,yHAAA,oBAAoB,OAAA"}

package/dist/cache/listCache.d.ts

@@ -1,17 +1,22 @@
 /**
- * @file Enhanced Directory Listing Cache with TTL and dirty tracking.
+ * Lifetime for a path `/proc` reports movement on.
  *
- * Provides a singleton cache for directory listings to avoid redundant API calls
- * during tab completion and file operations. Features:
- * - TTL-based expiration (different TTLs per path pattern)
- * - Dirty flag tracking (local mutations mark cache as needing refresh)
- * - LRU eviction (bounded memory usage)
- * - Optimistic serving (serve stale cache while refreshing)
- *
- * Generic implementation - stores any data type keyed by path.
+ * Long by design: arrivals, departures and job completions mark these
+ * dirty as they happen, so the clock is a backstop against a missed
+ * notification rather than the mechanism.
+ */
+export declare const LIST_CACHE_SIGNAL_BACKED_TTL_MS: number;
+/** Lifetime for a path nothing reports movement on. */
+export declare const LIST_CACHE_SIGNAL_FREE_TTL_MS: number;
+/**
+ * Lifetime for the plugin and pipeline indexes.
  *
- * @module
+ * Registration is an administrative act on a CUBE, not something a
+ * session causes, and it happens on a scale of months.
  */
+export declare const LIST_CACHE_PLUGIN_INDEX_TTL_MS: number;
+/** How many path listings the cache retains before evicting the oldest. */
+export declare const LIST_CACHE_MAX_ENTRIES: number;
 /**
  * Result returned by cache_get with freshness information.
  */
@@ -69,6 +74,8 @@ export interface CacheStats {
     entries: number;
     /** Estimated total memory usage in bytes. */
     totalSize: number;
+    /** Age of the oldest retained entry in milliseconds, or null when empty. */
+    oldestAge: number | null;
 }
 /**
  * Singleton cache for directory listings with TTL and dirty tracking.
@@ -112,10 +119,19 @@ export declare class ListCache {
     private cache;
     /** Maximum cache entries (LRU eviction). */
     private maxEntries;
-    /** Default TTL for unconfigured paths (3 minutes). */
+    /** Lifetime for a path no configured prefix covers. */
     private defaultTTL;
-    /** Path-specific TTL configuration. */
+    /**
+     * Prefix-keyed lifetimes, longest prefix winning.
+     *
+     * A path is governed by a signal or by a clock, never argued over by
+     * both. Where `/proc` reports movement, the clock is only a backstop
+     * against a missed notification and can be long. Where nothing reports,
+     * a guess is all that is available and it stays short.
+     */
     private ttlConfig;
+    /** Whether this session has already reported that the cache filled. */
+    private evictionReported;
     /** Cache statistics. */
     private stats;
     /** Listeners told after any mutation a persister would want to see. */
@@ -170,6 +186,15 @@ export declare class ListCache {
      * @param options - Optional TTL and dirty flag.
      */
     cache_set<T = unknown>(path: string, data: T, options?: CacheOptions): void;
+    /**
+     * Every path the cache currently holds.
+     *
+     * Returned as a snapshot so a caller may mark or invalidate while
+     * iterating without mutating the map underneath itself.
+     *
+     * @returns The cached paths, least recently used first.
+     */
+    paths_get(): string[];
     /**
      * Marks a cached path as dirty (needs refresh).
      * Used when local mutations might have changed the data.

package/dist/cache/listCache.js

@@ -1,4 +1,7 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListCache = exports.LIST_CACHE_MAX_ENTRIES = exports.LIST_CACHE_PLUGIN_INDEX_TTL_MS = exports.LIST_CACHE_SIGNAL_FREE_TTL_MS = exports.LIST_CACHE_SIGNAL_BACKED_TTL_MS = void 0;
+exports.listCache_get = listCache_get;
 /**
  * @file Enhanced Directory Listing Cache with TTL and dirty tracking.
  *
@@ -13,9 +16,26 @@
  *
  * @module
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ListCache = void 0;
-exports.listCache_get = listCache_get;
+const errorStack_1 = require("../error/errorStack");
+/**
+ * Lifetime for a path `/proc` reports movement on.
+ *
+ * Long by design: arrivals, departures and job completions mark these
+ * dirty as they happen, so the clock is a backstop against a missed
+ * notification rather than the mechanism.
+ */
+exports.LIST_CACHE_SIGNAL_BACKED_TTL_MS = 60 * 60 * 1000;
+/** Lifetime for a path nothing reports movement on. */
+exports.LIST_CACHE_SIGNAL_FREE_TTL_MS = 3 * 60 * 1000;
+/**
+ * Lifetime for the plugin and pipeline indexes.
+ *
+ * Registration is an administrative act on a CUBE, not something a
+ * session causes, and it happens on a scale of months.
+ */
+exports.LIST_CACHE_PLUGIN_INDEX_TTL_MS = 24 * 60 * 60 * 1000;
+/** How many path listings the cache retains before evicting the oldest. */
+exports.LIST_CACHE_MAX_ENTRIES = 500;
 /**
  * Singleton cache for directory listings with TTL and dirty tracking.
  *
@@ -109,16 +129,33 @@ class ListCache {
         /** Cache storage: path → entry. */
         this.cache = new Map();
         /** Maximum cache entries (LRU eviction). */
-        this.maxEntries = 100;
-        /** Default TTL for unconfigured paths (3 minutes). */
-        this.defaultTTL = 3 * 60 * 1000;
-        /** Path-specific TTL configuration. */
+        this.maxEntries = exports.LIST_CACHE_MAX_ENTRIES;
+        /** Lifetime for a path no configured prefix covers. */
+        this.defaultTTL = exports.LIST_CACHE_SIGNAL_FREE_TTL_MS;
+        /**
+         * Prefix-keyed lifetimes, longest prefix winning.
+         *
+         * A path is governed by a signal or by a clock, never argued over by
+         * both. Where `/proc` reports movement, the clock is only a backstop
+         * against a missed notification and can be long. Where nothing reports,
+         * a guess is all that is available and it stays short.
+         */
         this.ttlConfig = new Map([
-            ['/PUBLIC', 10 * 60 * 1000], // 10 min (stable, public directory)
-            ['/home', 5 * 60 * 1000], // 5 min (user home directories)
-            ['/bin', 60 * 60 * 1000], // 1 hour (plugins rarely change)
-            ['/feeds/*', 5 * 60 * 1000], // 5 min (feed outputs)
+            // Signal-covered: the roster and job-completion notifications decide
+            // when these go stale (see listing_dirtyByFeed).
+            ['/home', exports.LIST_CACHE_SIGNAL_BACKED_TTL_MS],
+            ['/SHARED', exports.LIST_CACHE_SIGNAL_BACKED_TTL_MS],
+            ['/PUBLIC', exports.LIST_CACHE_SIGNAL_BACKED_TTL_MS],
+            // Signal-free: nothing reports movement, so a clock is the only option.
+            // Plugin registration is an administrative act on a scale of months,
+            // so a day is closer to true than an hour; `refresh` is the escape
+            // hatch when an operator knows a plugin was just registered.
+            ['/bin', exports.LIST_CACHE_PLUGIN_INDEX_TTL_MS],
+            ['/usr/share', exports.LIST_CACHE_PLUGIN_INDEX_TTL_MS],
+            ['/PIPELINES', exports.LIST_CACHE_PLUGIN_INDEX_TTL_MS],
         ]);
+        /** Whether this session has already reported that the cache filled. */
+        this.evictionReported = false;
         /** Cache statistics. */
         this.stats = {
             hits: 0,
@@ -189,6 +226,17 @@ class ListCache {
         this.evict_lru();
         this.change_emit();
     }
+    /**
+     * Every path the cache currently holds.
+     *
+     * Returned as a snapshot so a caller may mark or invalidate while
+     * iterating without mutating the map underneath itself.
+     *
+     * @returns The cached paths, least recently used first.
+     */
+    paths_get() {
+        return Array.from(this.cache.keys());
+    }
     /**
      * Marks a cached path as dirty (needs refresh).
      * Used when local mutations might have changed the data.
@@ -270,18 +318,23 @@ class ListCache {
      * @returns TTL in milliseconds.
      */
     ttl_get(path) {
-        if (this.ttlConfig.has(path)) {
-            return this.ttlConfig.get(path);
-        }
-        for (const [pattern, ttl] of this.ttlConfig) {
-            if (pattern.includes('*')) {
-                const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
-                if (regex.test(path)) {
-                    return ttl;
-                }
+        const exact = this.ttlConfig.get(path);
+        if (exact !== undefined)
+            return exact;
+        // Longest matching prefix wins, so a deeper entry can override a
+        // shallower one. Matching is on whole segments: `/bindings` must not
+        // inherit `/bin`'s lifetime.
+        let bestLength = -1;
+        let bestTTL = this.defaultTTL;
+        for (const [prefix, ttl] of this.ttlConfig) {
+            if (!path.startsWith(prefix + '/'))
+                continue;
+            if (prefix.length > bestLength) {
+                bestLength = prefix.length;
+                bestTTL = ttl;
             }
         }
-        return this.defaultTTL;
+        return bestTTL;
     }
     /**
      * Evicts oldest entries if cache exceeds max size.
@@ -292,6 +345,14 @@ class ListCache {
             if (oldestKey !== undefined) {
                 this.cache.delete(oldestKey);
                 this.stats.evictions++;
+                // An eviction is not an error, but it is worth knowing about: the
+                // dropped listing also leaves the checkpoint, so a restart comes
+                // back thinner than the session that wrote it. Said once, because
+                // a session that crosses the cap will cross it repeatedly.
+                if (!this.evictionReported) {
+                    this.evictionReported = true;
+                    errorStack_1.errorStack.stack_push('warning', `listing cache is full at ${this.maxEntries} paths; the least recently used listings are being dropped and will not survive to the next session`);
+                }
             }
             else {
                 break; // Should never happen, but safety check
@@ -305,9 +366,13 @@ class ListCache {
      */
     stats_get() {
         let totalSize = 0;
+        let oldestTimestamp = null;
         for (const entry of this.cache.values()) {
             // Rough estimate: JSON string length
             totalSize += JSON.stringify(entry.data).length;
+            if (oldestTimestamp === null || entry.timestamp < oldestTimestamp) {
+                oldestTimestamp = entry.timestamp;
+            }
         }
         return {
             hits: this.stats.hits,
@@ -316,6 +381,7 @@ class ListCache {
             evictions: this.stats.evictions,
             entries: this.cache.size,
             totalSize,
+            oldestAge: oldestTimestamp === null ? null : Date.now() - oldestTimestamp,
         };
     }
     /**
@@ -327,6 +393,7 @@ class ListCache {
         this.stats.misses = 0;
         this.stats.staleHits = 0;
         this.stats.evictions = 0;
+        this.evictionReported = false;
     }
 }
 exports.ListCache = ListCache;

package/dist/cache/listCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"listCache.js","sourceRoot":"","sources":["../../src/cache/listCache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"listCache.js","sourceRoot":"","sources":["../../src/cache/listCache.ts"],"names":[],"mappings":"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"}

package/dist/cache/listingInvalidation.d.ts

@@ -0,0 +1,47 @@
+/**
+ * How long feed movement collects before the cache is walked.
+ *
+ * Short on purpose: the whole point is that the mark beats the operator's
+ * next listing of that folder.
+ */
+export declare const LISTING_INVALIDATION_WINDOW_MS: number;
+/**
+ * Notes that a feed's contents moved, so its cached folder listings are
+ * behind. Call when a job crosses into a terminal state — that is when
+ * output becomes visible.
+ *
+ * @param feedIDs - Feeds whose contents changed.
+ */
+export declare function listingsForFeeds_note(feedIDs: readonly number[]): void;
+/**
+ * Notes that feeds arrived in, or vanished from, a parent folder.
+ *
+ * An arrival changes the *parent* listing rather than anything inside the
+ * feed, which is why this takes the folders as well: a feed shared to this
+ * identity adds a row to a folder that may itself be perfectly fresh.
+ *
+ * @param feedIDs - Feeds that arrived or departed.
+ * @param parentPaths - Folder listings whose membership therefore changed.
+ */
+export declare function listingsForRoster_note(feedIDs: readonly number[], parentPaths: readonly string[]): void;
+/**
+ * Removes every cached listing belonging to feeds that are gone.
+ *
+ * A departure is not staleness. A feed this identity can no longer see has
+ * no contents to serve, and dirty entries are still served while they
+ * refresh, so marking one would keep showing a tree that has been taken
+ * away. This deletes instead, and does so at once rather than on the
+ * window, because there is nothing to race.
+ *
+ * @param feedIDs - Feeds that vanished from the roster.
+ * @returns The cache paths removed.
+ */
+export declare function listingsForFeeds_drop(feedIDs: readonly number[]): string[];
+/**
+ * Applies any pending movement at once, without waiting for the window.
+ *
+ * @returns The cache paths marked dirty.
+ */
+export declare function listingInvalidation_flush(): string[];
+/** Discards pending movement without applying it (tests, cache reset). */
+export declare function listingInvalidation_reset(): void;

package/dist/cache/listingInvalidation.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LISTING_INVALIDATION_WINDOW_MS = void 0;
+exports.listingsForFeeds_note = listingsForFeeds_note;
+exports.listingsForRoster_note = listingsForRoster_note;
+exports.listingsForFeeds_drop = listingsForFeeds_drop;
+exports.listingInvalidation_flush = listingInvalidation_flush;
+exports.listingInvalidation_reset = listingInvalidation_reset;
+/**
+ * @file Feed movement invalidates the folder listings it touched.
+ *
+ * The listing cache used to decide staleness with a clock that had no
+ * relationship to when anything changed, while `/proc` — in the same
+ * process — knew and said nothing. This is the wire between them.
+ *
+ * Two rules govern what happens on the far end:
+ *
+ * - **Your own act deletes; someone else's act dirties.** A mutation
+ *   (rm, mv, cp, upload) removes the entry, because showing a file you
+ *   just deleted is incoherent. A job's output or a colleague's share is
+ *   not wrong, merely behind, so the entry is marked dirty and served at
+ *   once while it refreshes behind.
+ * - **Movement coalesces.** A feed completing a fan-out stage lands many
+ *   terminal transitions in the same second; they collapse into one pass
+ *   over the cache keys.
+ *
+ * Nothing here subscribes to the process cache's change stream. That
+ * stream fires on every instance add and status observation, so indexing
+ * one large feed emits tens of thousands of events, none of which mean a
+ * file appeared. Movement is pushed from the two places that know.
+ *
+ * @module
+ */
+const listCache_1 = require("./listCache");
+const chrisPath_1 = require("../path/chrisPath");
+/**
+ * How long feed movement collects before the cache is walked.
+ *
+ * Short on purpose: the whole point is that the mark beats the operator's
+ * next listing of that folder.
+ */
+exports.LISTING_INVALIDATION_WINDOW_MS = 1500;
+/** Feed ids whose listings are waiting to be marked. */
+const pendingFeeds = new Set();
+/** Parent folders waiting to be marked, from arrivals and departures. */
+const pendingParents = new Set();
+/** The open coalescing window, or null when nothing is pending. */
+let windowTimer = null;
+/**
+ * Marks every cached listing belonging to the given feeds, and any parent
+ * folders queued alongside them.
+ *
+ * @returns The cache paths marked dirty.
+ */
+function pending_flush() {
+    const feeds = new Set(pendingFeeds);
+    const parents = new Set(pendingParents);
+    pendingFeeds.clear();
+    pendingParents.clear();
+    windowTimer = null;
+    if (feeds.size === 0 && parents.size === 0)
+        return [];
+    // Only paths the cache still holds are considered, so a listing dropped
+    // between the note and the flush leaves nothing behind to mark.
+    const cache = (0, listCache_1.listCache_get)();
+    const marked = [];
+    for (const path of cache.paths_get()) {
+        const feedID = (0, chrisPath_1.path_extractFeedID)(path);
+        const isFeedPath = feedID !== null && feeds.has(feedID);
+        if (!isFeedPath && !parents.has(path))
+            continue;
+        cache.cache_markDirty(path);
+        marked.push(path);
+    }
+    return marked;
+}
+/** Opens the coalescing window if one is not already running. */
+function window_open() {
+    if (windowTimer !== null)
+        return;
+    windowTimer = setTimeout(() => { pending_flush(); }, exports.LISTING_INVALIDATION_WINDOW_MS);
+    // A pending mark must never hold a process open on its own.
+    windowTimer.unref?.();
+}
+/**
+ * Notes that a feed's contents moved, so its cached folder listings are
+ * behind. Call when a job crosses into a terminal state — that is when
+ * output becomes visible.
+ *
+ * @param feedIDs - Feeds whose contents changed.
+ */
+function listingsForFeeds_note(feedIDs) {
+    if (feedIDs.length === 0)
+        return;
+    for (const feedID of feedIDs)
+        pendingFeeds.add(feedID);
+    window_open();
+}
+/**
+ * Notes that feeds arrived in, or vanished from, a parent folder.
+ *
+ * An arrival changes the *parent* listing rather than anything inside the
+ * feed, which is why this takes the folders as well: a feed shared to this
+ * identity adds a row to a folder that may itself be perfectly fresh.
+ *
+ * @param feedIDs - Feeds that arrived or departed.
+ * @param parentPaths - Folder listings whose membership therefore changed.
+ */
+function listingsForRoster_note(feedIDs, parentPaths) {
+    if (feedIDs.length === 0 && parentPaths.length === 0)
+        return;
+    for (const feedID of feedIDs)
+        pendingFeeds.add(feedID);
+    for (const path of parentPaths)
+        pendingParents.add(path);
+    window_open();
+}
+/**
+ * Removes every cached listing belonging to feeds that are gone.
+ *
+ * A departure is not staleness. A feed this identity can no longer see has
+ * no contents to serve, and dirty entries are still served while they
+ * refresh, so marking one would keep showing a tree that has been taken
+ * away. This deletes instead, and does so at once rather than on the
+ * window, because there is nothing to race.
+ *
+ * @param feedIDs - Feeds that vanished from the roster.
+ * @returns The cache paths removed.
+ */
+function listingsForFeeds_drop(feedIDs) {
+    if (feedIDs.length === 0)
+        return [];
+    const gone = new Set(feedIDs);
+    const cache = (0, listCache_1.listCache_get)();
+    const removed = [];
+    for (const path of cache.paths_get()) {
+        const feedID = (0, chrisPath_1.path_extractFeedID)(path);
+        if (feedID === null || !gone.has(feedID))
+            continue;
+        cache.cache_invalidate(path);
+        removed.push(path);
+    }
+    // A feed that left must not be resurrected by movement noted before it
+    // went; drop it from anything still pending.
+    for (const feedID of feedIDs)
+        pendingFeeds.delete(feedID);
+    return removed;
+}
+/**
+ * Applies any pending movement at once, without waiting for the window.
+ *
+ * @returns The cache paths marked dirty.
+ */
+function listingInvalidation_flush() {
+    if (windowTimer !== null) {
+        clearTimeout(windowTimer);
+        windowTimer = null;
+    }
+    return pending_flush();
+}
+/** Discards pending movement without applying it (tests, cache reset). */
+function listingInvalidation_reset() {
+    if (windowTimer !== null) {
+        clearTimeout(windowTimer);
+        windowTimer = null;
+    }
+    pendingFeeds.clear();
+    pendingParents.clear();
+}
+//# sourceMappingURL=listingInvalidation.js.map

package/dist/cache/listingInvalidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listingInvalidation.js","sourceRoot":"","sources":["../../src/cache/listingInvalidation.ts"],"names":[],"mappings":"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"}