@loro-dev/flock 4.4.2 → 4.4.4

package/src/index.ts

@@ -997,8 +997,11 @@ export class Flock {
   }
 
   /**
-   * Returns the exclusive version vector, which only includes peers that have
-   * at least one entry in the current state.
+   * Returns the exclusive/visible version vector.
+   *
+   * Only peers that currently own at least one visible entry are included.
+   * This vector is consistent with current visible state and is the correct
+   * baseline for incremental export/replication.
    *
    * Complexity: O(M + V log M + R (log L + log S)).
    * - M = memtablePeerCount
@@ -1015,10 +1018,13 @@ export class Flock {
   }
 
   /**
-   * Returns the inclusive version vector, which includes all peers ever seen,
-   * even if their entries have been overridden by other peers.
+   * Returns the inclusive/max-seen version vector.
+   *
+   * Tracks max seen clocks per peer for this process lifetime
+   * (open/import/local writes), including peers that may no longer own visible
+   * entries.
    *
-   * Use this version when checking if you have received all data from another peer.
+   * Use this version for completeness checks, not incremental export baselines.
    */
   inclusiveVersion(): VersionVector {
     return decodeVersionVectorFromRaw(inclusiveVersion_ffi(this.inner));