@rljson/fs-agent 0.0.34 → 0.0.35

package/dist/fs-agent.d.ts

@@ -622,6 +622,18 @@ export declare class FsAgent {
      * @param connector - Connector to broadcast on.
      */
     private _readvertiseAfterRefusal;
+    /**
+     * Whether a tree describes a folder holding nothing whatsoever.
+     *
+     * Deliberately conservative: an empty DIRECTORY counts as content. A user who
+     * creates a folder and puts a directory in it has made a statement about what
+     * should be there, and the silence this gates is only correct for an agent
+     * that has established nothing at all. Being wrong in that direction would
+     * mean a folder that never advertises until something else happens to change.
+     * @param tree - The tree to inspect.
+     * @returns `true` when the tree carries no entries at all.
+     */
+    private _treeIsEmpty;
     private _adoptAppliedRef;
     /**
      * Derives a deterministic content key from an FsTree.

package/dist/fs-agent.js

@@ -1883,7 +1883,16 @@ ${err.stack}` : String(err);
       this._timeouts.fetchTree,
       `syncToDb → initial storeFsTree(${treeKey})`
     );
-    if (initialRef) {
+    const isSilentJoiner = initialParentRef === void 0 && this._treeIsEmpty(initialTree);
+    if (isSilentJoiner) {
+      console.warn(
+        `[FsAgent] ${this._rootPath} is empty and has no remembered state — joining quietly rather than announcing emptiness.`
+      );
+      this._currentRef = initialRef;
+      this._persistCurrentRef(initialRef);
+      this._lastSentContentKey = this._contentKeyFromTree(initialTree);
+    }
+    if (initialRef && !isSilentJoiner) {
       this._lastSentRef = initialRef;
       this._currentRef = initialRef;
       this._persistCurrentRef(initialRef);
@@ -2136,6 +2145,20 @@ ${err.stack}` : String(err);
       console.warn(`[FsAgent] re-announcement failed: ${String(err)}`);
     }
   }
+  /**
+   * Whether a tree describes a folder holding nothing whatsoever.
+   *
+   * Deliberately conservative: an empty DIRECTORY counts as content. A user who
+   * creates a folder and puts a directory in it has made a statement about what
+   * should be there, and the silence this gates is only correct for an agent
+   * that has established nothing at all. Being wrong in that direction would
+   * mean a folder that never advertises until something else happens to change.
+   * @param tree - The tree to inspect.
+   * @returns `true` when the tree carries no entries at all.
+   */
+  _treeIsEmpty(tree) {
+    return this._getFileContentMap(tree).size === 0;
+  }
   _adoptAppliedRef(connector, treeRef) {
     if (this._lastAppliedRef && this._lastAppliedRef !== treeRef) {
       connector.invalidateSent?.(this._lastAppliedRef);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rljson/fs-agent",
-  "version": "0.0.34",
+  "version": "0.0.35",
   "description": "Rljson fs-agent description",
   "homepage": "https://github.com/rljson/fs-agent",
   "bugs": "https://github.com/rljson/fs-agent/issues",