@brightchain/brightchain-lib 0.14.0 → 0.15.0

package/src/lib/interfaces/availability/blockRegistry.d.ts

@@ -4,8 +4,9 @@
  * Defines the interface for maintaining a fast local index of blocks,
  * supporting O(1) lookups, Bloom filter export, and manifest generation.
  *
- * @see Requirements 3.1, 3.6, 3.7
+ * @see Requirements 3.1, 3.5, 3.6, 3.7, 4.5
  */
+import { PoolId } from '../storage/pooledBlockStore';
 /**
  * Bloom filter for efficient block existence queries.
  * A space-efficient probabilistic data structure used to test
@@ -65,6 +66,35 @@ export interface BlockManifest {
      */
     checksum: string;
 }
+/**
+ * Pool-scoped Bloom filter container.
+ * Contains per-pool Bloom filters using keys in "poolId:blockId" format,
+ * plus a global filter for backward compatibility.
+ *
+ * @see Requirements 4.5
+ */
+export interface PoolScopedBloomFilter {
+    /** Per-pool Bloom filters using keys in format "poolId:blockId" */
+    filters: Map<PoolId, BloomFilter>;
+    /** Global filter for backward compatibility */
+    globalFilter: BloomFilter;
+}
+/**
+ * Pool-scoped manifest for synchronization.
+ * Groups block IDs by their pool, enabling per-pool reconciliation.
+ *
+ * @see Requirements 3.1, 3.5
+ */
+export interface PoolScopedManifest {
+    /** Unique identifier of the node that generated this manifest */
+    nodeId: string;
+    /** Block IDs grouped by pool */
+    pools: Map<PoolId, string[]>;
+    /** Timestamp when the manifest was generated */
+    generatedAt: Date;
+    /** Checksum of the manifest for integrity verification */
+    checksum: string;
+}
 /**
  * Block Registry Interface
  *
@@ -86,14 +116,16 @@ export interface IBlockRegistry {
      * Add a block to the local registry
      *
      * @param blockId - The block ID to add
+     * @param poolId - Optional pool the block belongs to
      */
-    addLocal(blockId: string): void;
+    addLocal(blockId: string, poolId?: PoolId): void;
     /**
      * Remove a block from the local registry
      *
      * @param blockId - The block ID to remove
+     * @param poolId - Optional pool the block belonged to
      */
-    removeLocal(blockId: string): void;
+    removeLocal(blockId: string, poolId?: PoolId): void;
     /**
      * Get count of local blocks
      *
@@ -131,5 +163,22 @@ export interface IBlockRegistry {
      * @see Requirements 3.5
      */
     rebuild(): Promise<void>;
+    /**
+     * Export a pool-scoped Bloom filter.
+     * Each pool gets its own filter with keys in "poolId:blockId" format.
+     * Also includes a global filter for backward compatibility.
+     *
+     * @returns A pool-scoped Bloom filter container
+     * @see Requirements 4.5
+     */
+    exportPoolScopedBloomFilter(): PoolScopedBloomFilter;
+    /**
+     * Export a pool-scoped manifest grouping block IDs by pool.
+     * Used for pool-aware reconciliation with peers.
+     *
+     * @returns A manifest with block IDs grouped by pool
+     * @see Requirements 3.1, 3.5
+     */
+    exportPoolScopedManifest(): PoolScopedManifest;
 }
 //# sourceMappingURL=blockRegistry.d.ts.map

package/src/lib/interfaces/availability/blockRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blockRegistry.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/availability/blockRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;;OAOG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;OAEG;IACH,WAAW,EAAE,IAAI,CAAC;IAElB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAEnC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC;;;;OAIG;IACH,aAAa,IAAI,MAAM,CAAC;IAExB;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,EAAE,CAAC;IAE7B;;;;;;;OAOG;IACH,iBAAiB,IAAI,WAAW,CAAC;IAEjC;;;;;;OAMG;IACH,cAAc,IAAI,aAAa,CAAC;IAEhC;;;;;;OAMG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}
+{"version":3,"file":"blockRegistry.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/availability/blockRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;;OAOG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;OAEG;IACH,WAAW,EAAE,IAAI,CAAC;IAElB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClC,+CAA+C;IAC/C,YAAY,EAAE,WAAW,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7B,gDAAgD;IAChD,WAAW,EAAE,IAAI,CAAC;IAClB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAEnC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjD;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpD;;;;OAIG;IACH,aAAa,IAAI,MAAM,CAAC;IAExB;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,EAAE,CAAC;IAE7B;;;;;;;OAOG;IACH,iBAAiB,IAAI,WAAW,CAAC;IAEjC;;;;;;OAMG;IACH,cAAc,IAAI,aAAa,CAAC;IAEhC;;;;;;OAMG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;;;;;OAOG;IACH,2BAA2B,IAAI,qBAAqB,CAAC;IAErD;;;;;;OAMG;IACH,wBAAwB,IAAI,kBAAkB,CAAC;CAChD"}

package/src/lib/interfaces/availability/blockRegistry.js

@@ -5,7 +5,7 @@
  * Defines the interface for maintaining a fast local index of blocks,
  * supporting O(1) lookups, Bloom filter export, and manifest generation.
  *
- * @see Requirements 3.1, 3.6, 3.7
+ * @see Requirements 3.1, 3.5, 3.6, 3.7, 4.5
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=blockRegistry.js.map

package/src/lib/interfaces/availability/discoveryProtocol.d.ts

@@ -7,7 +7,9 @@
  *
  * @see Requirements 5.1, 5.2, 5.3, 5.4, 5.5, 5.6, 5.7, 5.8
  */
-import { BloomFilter } from './blockRegistry';
+import type { ICBLIndexEntry } from '../storage/cblIndex';
+import { PoolId } from '../storage/pooledBlockStore';
+import { BloomFilter, PoolScopedBloomFilter } from './blockRegistry';
 import { ILocationRecord } from './locationRecord';
 /**
  * Result of a block discovery operation.
@@ -38,6 +40,13 @@ export interface DiscoveryResult {
      * Total duration of the discovery operation in milliseconds
      */
     duration: number;
+    /**
+     * Pool context used for this discovery, if any.
+     * Set when discoverBlock was called with a poolId parameter.
+     *
+     * @see Requirements 4.1
+     */
+    poolId?: PoolId;
 }
 /**
  * Result of querying a single peer for a block.
@@ -107,6 +116,49 @@ export interface DiscoveryConfig {
  * Default discovery configuration values.
  */
 export declare const DEFAULT_DISCOVERY_CONFIG: DiscoveryConfig;
+/**
+ * Query for searching CBL metadata across pool peers.
+ * All fields are optional; only specified fields are used as filters.
+ *
+ * @see Requirements 8.5
+ */
+export interface CBLMetadataSearchQuery {
+    /** Filter by file name (substring match) */
+    fileName?: string;
+    /** Filter by MIME type (exact match) */
+    mimeType?: string;
+    /** Filter by tags (entries must have all specified tags) */
+    tags?: string[];
+    /** Scope the search to a specific pool */
+    poolId?: PoolId;
+}
+/**
+ * A single matching entry from a CBL metadata search,
+ * annotated with the source node that reported it.
+ *
+ * @see Requirements 8.5
+ */
+export interface CBLMetadataSearchHit {
+    /** The matching CBL index entry */
+    entry: ICBLIndexEntry;
+    /** Node ID of the peer that reported this entry */
+    sourceNodeId: string;
+}
+/**
+ * Result of a CBL metadata search across pool peers.
+ *
+ * @see Requirements 8.5
+ */
+export interface CBLMetadataSearchResult {
+    /** The query that was executed */
+    query: CBLMetadataSearchQuery;
+    /** Matching entries with source node information */
+    hits: CBLMetadataSearchHit[];
+    /** Number of peers that were queried */
+    queriedPeers: number;
+    /** Total duration of the search in milliseconds */
+    duration: number;
+}
 /**
  * Discovery Protocol Interface
  *
@@ -125,11 +177,15 @@ export interface IDiscoveryProtocol {
      * 3. Make direct queries to peers whose Bloom filters indicate possible match
      * 4. Cache and return results sorted by latency
      *
+     * When poolId is provided, uses pool-scoped Bloom filters and
+     * includes poolId in peer queries for pool-specific discovery.
+     *
      * @param blockId - The block ID to discover
+     * @param poolId - Optional pool to scope the discovery to
      * @returns Promise resolving to discovery result with locations
-     * @see Requirements 5.1, 5.2, 5.3, 5.4, 5.5
+     * @see Requirements 4.1, 4.2, 4.3, 5.1, 5.2, 5.3, 5.4, 5.5
      */
-    discoverBlock(blockId: string): Promise<DiscoveryResult>;
+    discoverBlock(blockId: string, poolId?: PoolId): Promise<DiscoveryResult>;
     /**
      * Query a specific peer for a block.
      * Makes a direct query without Bloom filter pre-check.
@@ -169,11 +225,33 @@ export interface IDiscoveryProtocol {
      * @see Requirements 4.2, 5.2
      */
     getPeerBloomFilter(peerId: string): Promise<BloomFilter>;
+    /**
+     * Get the pool-scoped Bloom filter from a peer.
+     * Used for pool-aware discovery to pre-check block existence
+     * within specific pools before making direct queries.
+     *
+     * @param peerId - The peer to get the pool-scoped Bloom filter from
+     * @returns Promise resolving to the peer's pool-scoped Bloom filter
+     * @see Requirements 4.2, 4.5
+     */
+    getPeerPoolScopedBloomFilter(peerId: string): Promise<PoolScopedBloomFilter>;
     /**
      * Get the current configuration.
      *
      * @returns The discovery configuration
      */
     getConfig(): DiscoveryConfig;
+    /**
+     * Search for CBL index entries by metadata across pool peers.
+     *
+     * Queries connected peers for CBL entries matching the given criteria
+     * (file name, MIME type, tags) within the specified pool. Results are
+     * deduplicated by magnet URL, keeping the first occurrence.
+     *
+     * @param query - Search criteria with optional fileName, mimeType, tags, poolId
+     * @returns Promise resolving to search results with matching entries and source nodes
+     * @see Requirements 8.5
+     */
+    searchCBLMetadata(query: CBLMetadataSearchQuery): Promise<CBLMetadataSearchResult>;
 }
 //# sourceMappingURL=discoveryProtocol.d.ts.map

package/src/lib/interfaces/availability/discoveryProtocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discoveryProtocol.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/availability/discoveryProtocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;;;OAIG;IACH,SAAS,EAAE,eAAe,EAAE,CAAC;IAE7B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,4BAA4B,EAAE,MAAM,CAAC;IAErC;;;;OAIG;IACH,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAMtC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEzD;;;;;;;;OAQG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAErE;;;;;;;OAOG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,GAAG,IAAI,CAAC;IAE9D;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;OAEG;IACH,aAAa,IAAI,IAAI,CAAC;IAEtB;;;;;;;OAOG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEzD;;;;OAIG;IACH,SAAS,IAAI,eAAe,CAAC;CAC9B"}
+{"version":3,"file":"discoveryProtocol.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/availability/discoveryProtocol.ts"],"names":[],"mappings":"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"}

package/src/lib/interfaces/availability/discoveryProtocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"discoveryProtocol.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/availability/discoveryProtocol.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAiHH;;GAEG;AACU,QAAA,wBAAwB,GAAoB;IACvD,cAAc,EAAE,IAAI;IACpB,oBAAoB,EAAE,EAAE;IACxB,UAAU,EAAE,KAAK;IACjB,4BAA4B,EAAE,IAAI;IAClC,oBAAoB,EAAE,CAAC;CACxB,CAAC"}
+{"version":3,"file":"discoveryProtocol.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/availability/discoveryProtocol.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA2HH;;GAEG;AACU,QAAA,wBAAwB,GAAoB;IACvD,cAAc,EAAE,IAAI;IACpB,oBAAoB,EAAE,EAAE;IACxB,UAAU,EAAE,KAAK;IACjB,4BAA4B,EAAE,IAAI;IAClC,oBAAoB,EAAE,CAAC;CACxB,CAAC"}

package/src/lib/interfaces/availability/gossipService.d.ts

@@ -8,6 +8,8 @@
  * @see Requirements 6.1, 6.2, 6.3, 6.4, 6.5, 6.6
  * @see Requirements 1.1, 1.2, 1.3, 1.5, 1.6, 10.1 (Unified Gossip Delivery)
  */
+import type { ICBLIndexEntry } from '../storage/cblIndex';
+import { PoolId } from '../storage/pooledBlockStore';
 /**
  * Metadata for message delivery via gossip protocol.
  * Attached to 'add' type BlockAnnouncements to indicate the announcement
@@ -45,6 +47,19 @@ export interface DeliveryAckMetadata {
     /** The node ID of the original message sender */
     originalSenderNode: string;
 }
+/**
+ * Metadata for HeadRegistry head pointer update announcements.
+ * Attached to 'head_update' type BlockAnnouncements to propagate
+ * head pointer changes across nodes.
+ *
+ * @see Requirements 2.1
+ */
+export interface HeadUpdateMetadata {
+    /** The database name containing the collection */
+    dbName: string;
+    /** The collection whose head pointer was updated */
+    collectionName: string;
+}
 /**
  * Block announcement message sent via gossip protocol.
  * Contains information about a block being added, removed, or acknowledged.
@@ -58,10 +73,15 @@ export interface BlockAnnouncement {
      * - 'add' for new blocks (may include messageDelivery metadata)
      * - 'remove' for deleted blocks
      * - 'ack' for delivery acknowledgments (must include deliveryAck metadata)
+     * - 'pool_deleted' for pool deletion propagation (requires poolId)
+     * - 'cbl_index_update' for new/updated CBL index entries (requires cblIndexEntry and poolId)
+     * - 'cbl_index_delete' for soft-deleted CBL index entries (requires cblIndexEntry and poolId)
+     * - 'head_update' for HeadRegistry head pointer updates (requires headUpdate metadata)
+     * - 'acl_update' for approved ACL updates (requires poolId and aclBlockId)
      *
-     * @see Requirements 1.1
+     * @see Requirements 1.1, 2.1, 8.1, 8.6, 13.4
      */
-    type: 'add' | 'remove' | 'ack';
+    type: 'add' | 'remove' | 'ack' | 'pool_deleted' | 'cbl_index_update' | 'cbl_index_delete' | 'head_update' | 'acl_update';
     /**
      * The block ID being announced (hex string)
      */
@@ -93,6 +113,38 @@ export interface BlockAnnouncement {
      * @see Requirements 1.3, 1.6
      */
     deliveryAck?: DeliveryAckMetadata;
+    /**
+     * Optional pool ID for pool-scoped announcements.
+     * Required for 'pool_deleted', 'cbl_index_update', and 'cbl_index_delete' types.
+     * Optional for 'add' and 'remove' types.
+     *
+     * @see Requirements 1.5, 1.6, 2.1, 8.1, 8.6
+     */
+    poolId?: PoolId;
+    /**
+     * Optional CBL index entry data for CBL index synchronization.
+     * Required for 'cbl_index_update' and 'cbl_index_delete' types.
+     * Contains the entry being announced (update) or the entry being soft-deleted (delete).
+     *
+     * @see Requirements 8.1, 8.6
+     */
+    cblIndexEntry?: ICBLIndexEntry;
+    /**
+     * Optional HeadRegistry update metadata for head pointer synchronization.
+     * Required for 'head_update' type announcements.
+     * The blockId field carries the new head block ID.
+     *
+     * @see Requirements 2.1
+     */
+    headUpdate?: HeadUpdateMetadata;
+    /**
+     * Optional ACL block ID for ACL update propagation.
+     * Required for 'acl_update' type announcements.
+     * Contains the block ID of the approved ACL document in the block store.
+     *
+     * @see Requirements 13.4
+     */
+    aclBlockId?: string;
 }
 /**
  * Configuration for priority-based gossip propagation.
@@ -178,19 +230,71 @@ export interface IGossipService {
      * The announcement will be batched and sent to a random subset of peers.
      *
      * @param blockId - The block ID to announce
+     * @param poolId - Optional pool the block belongs to
      * @returns Promise that resolves when the announcement is queued
-     * @see Requirements 6.1
+     * @see Requirements 6.1, 1.1, 6.3
      */
-    announceBlock(blockId: string): Promise<void>;
+    announceBlock(blockId: string, poolId?: PoolId): Promise<void>;
     /**
      * Announce block removal to the network.
      * The announcement will be batched and sent to a random subset of peers.
      *
      * @param blockId - The block ID being removed
+     * @param poolId - Optional pool the block belonged to
+     * @returns Promise that resolves when the announcement is queued
+     * @see Requirements 6.5, 2.2
+     */
+    announceRemoval(blockId: string, poolId?: PoolId): Promise<void>;
+    /**
+     * Announce that a pool has been deleted.
+     * Creates a pool_deleted announcement propagated as a tombstone.
+     *
+     * @param poolId - The pool that was deleted
+     * @returns Promise that resolves when the announcement is queued
+     * @see Requirements 2.2, 6.3
+     */
+    announcePoolDeletion(poolId: PoolId): Promise<void>;
+    /**
+     * Announce a new or updated CBL index entry to peers in the same pool.
+     * Creates a cbl_index_update announcement scoped to the entry's pool.
+     *
+     * @param entry - The CBL index entry being announced
+     * @returns Promise that resolves when the announcement is queued
+     * @see Requirements 8.1
+     */
+    announceCBLIndexUpdate(entry: ICBLIndexEntry): Promise<void>;
+    /**
+     * Announce a soft-deleted CBL index entry to peers in the same pool.
+     * Creates a cbl_index_delete announcement so peers also mark the entry as deleted.
+     *
+     * @param entry - The CBL index entry that was soft-deleted (with deletedAt set)
+     * @returns Promise that resolves when the announcement is queued
+     * @see Requirements 8.6
+     */
+    announceCBLIndexDelete(entry: ICBLIndexEntry): Promise<void>;
+    /**
+     * Announce a HeadRegistry head pointer update to peer nodes.
+     * Creates a head_update announcement with the database name, collection name,
+     * and new head block ID.
+     *
+     * @param dbName - The database name containing the collection
+     * @param collectionName - The collection whose head pointer was updated
+     * @param blockId - The new head block ID
+     * @returns Promise that resolves when the announcement is queued
+     * @see Requirements 2.1
+     */
+    announceHeadUpdate(dbName: string, collectionName: string, blockId: string): Promise<void>;
+    /**
+     * Announce an approved ACL update to peers in the same pool.
+     * Creates an acl_update announcement with the pool ID and the block ID
+     * of the signed ACL document stored in the block store.
+     *
+     * @param poolId - The pool whose ACL was updated
+     * @param aclBlockId - The block ID of the approved ACL document
      * @returns Promise that resolves when the announcement is queued
-     * @see Requirements 6.5
+     * @see Requirements 13.4
      */
-    announceRemoval(blockId: string): Promise<void>;
+    announceACLUpdate(poolId: string, aclBlockId: string): Promise<void>;
     /**
      * Handle an incoming block announcement from a peer.
      * Updates local location metadata and optionally forwards the announcement.

package/src/lib/interfaces/availability/gossipService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gossipService.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/availability/gossipService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gossipService.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/availability/gossipService.ts"],"names":[],"mappings":"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"}

package/src/lib/interfaces/availability/gossipService.js

@@ -13,6 +13,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_GOSSIP_CONFIG = void 0;
 exports.validateBlockAnnouncement = validateBlockAnnouncement;
 exports.validateGossipConfig = validateGossipConfig;
+const pooledBlockStore_1 = require("../storage/pooledBlockStore");
 /**
  * Default gossip configuration values.
  *
@@ -31,7 +32,16 @@ exports.DEFAULT_GOSSIP_CONFIG = {
 /**
  * Valid announcement types.
  */
-const VALID_ANNOUNCEMENT_TYPES = ['add', 'remove', 'ack'];
+const VALID_ANNOUNCEMENT_TYPES = [
+    'add',
+    'remove',
+    'ack',
+    'pool_deleted',
+    'cbl_index_update',
+    'cbl_index_delete',
+    'head_update',
+    'acl_update',
+];
 /**
  * Valid delivery ack statuses.
  */
@@ -59,6 +69,89 @@ function validateBlockAnnouncement(announcement) {
     if (!VALID_ANNOUNCEMENT_TYPES.includes(announcement.type)) {
         return false;
     }
+    // pool_deleted requires valid poolId, must not have messageDelivery or deliveryAck
+    if (announcement.type === 'pool_deleted') {
+        if (!announcement.poolId || !(0, pooledBlockStore_1.isValidPoolId)(announcement.poolId)) {
+            return false;
+        }
+        if (announcement.messageDelivery || announcement.deliveryAck) {
+            return false;
+        }
+        return true;
+    }
+    // cbl_index_update and cbl_index_delete require valid poolId and cblIndexEntry,
+    // must not have messageDelivery or deliveryAck (Req 8.1, 8.6)
+    if (announcement.type === 'cbl_index_update' ||
+        announcement.type === 'cbl_index_delete') {
+        if (!announcement.poolId || !(0, pooledBlockStore_1.isValidPoolId)(announcement.poolId)) {
+            return false;
+        }
+        if (!announcement.cblIndexEntry) {
+            return false;
+        }
+        if (!announcement.cblIndexEntry.magnetUrl ||
+            typeof announcement.cblIndexEntry.magnetUrl !== 'string') {
+            return false;
+        }
+        if (!announcement.cblIndexEntry.blockId1 ||
+            typeof announcement.cblIndexEntry.blockId1 !== 'string') {
+            return false;
+        }
+        if (!announcement.cblIndexEntry.blockId2 ||
+            typeof announcement.cblIndexEntry.blockId2 !== 'string') {
+            return false;
+        }
+        if (announcement.messageDelivery || announcement.deliveryAck) {
+            return false;
+        }
+        return true;
+    }
+    // head_update requires non-empty blockId and headUpdate with non-empty dbName and collectionName,
+    // must not have messageDelivery, deliveryAck, or cblIndexEntry (Req 2.1)
+    if (announcement.type === 'head_update') {
+        if (!announcement.blockId || typeof announcement.blockId !== 'string') {
+            return false;
+        }
+        if (!announcement.headUpdate) {
+            return false;
+        }
+        if (!announcement.headUpdate.dbName ||
+            typeof announcement.headUpdate.dbName !== 'string') {
+            return false;
+        }
+        if (!announcement.headUpdate.collectionName ||
+            typeof announcement.headUpdate.collectionName !== 'string') {
+            return false;
+        }
+        if (announcement.messageDelivery ||
+            announcement.deliveryAck ||
+            announcement.cblIndexEntry) {
+            return false;
+        }
+        return true;
+    }
+    // acl_update requires valid poolId and non-empty aclBlockId,
+    // must not have messageDelivery, deliveryAck, or cblIndexEntry (Req 13.4)
+    if (announcement.type === 'acl_update') {
+        if (!announcement.poolId || !(0, pooledBlockStore_1.isValidPoolId)(announcement.poolId)) {
+            return false;
+        }
+        if (!announcement.aclBlockId ||
+            typeof announcement.aclBlockId !== 'string') {
+            return false;
+        }
+        if (announcement.messageDelivery ||
+            announcement.deliveryAck ||
+            announcement.cblIndexEntry) {
+            return false;
+        }
+        return true;
+    }
+    // Validate poolId format if present on any other type
+    if (announcement.poolId !== undefined &&
+        !(0, pooledBlockStore_1.isValidPoolId)(announcement.poolId)) {
+        return false;
+    }
     // Req 1.5: messageDelivery only allowed on 'add' type
     if (announcement.messageDelivery && announcement.type !== 'add') {
         return false;

package/src/lib/interfaces/availability/gossipService.js.map

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

package/src/lib/interfaces/availability/index.d.ts

@@ -4,5 +4,6 @@ export * from './discoveryProtocol';
 export * from './gossipService';
 export * from './heartbeatMonitor';
 export * from './locationRecord';
+export * from './poolDeletionTombstone';
 export * from './reconciliationService';
 //# sourceMappingURL=index.d.ts.map

package/src/lib/interfaces/availability/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/availability/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/availability/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/src/lib/interfaces/availability/index.js

@@ -7,5 +7,6 @@ tslib_1.__exportStar(require("./discoveryProtocol"), exports);
 tslib_1.__exportStar(require("./gossipService"), exports);
 tslib_1.__exportStar(require("./heartbeatMonitor"), exports);
 tslib_1.__exportStar(require("./locationRecord"), exports);
+tslib_1.__exportStar(require("./poolDeletionTombstone"), exports);
 tslib_1.__exportStar(require("./reconciliationService"), exports);
 //# sourceMappingURL=index.js.map

package/src/lib/interfaces/availability/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/availability/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,0DAAgC;AAChC,8DAAoC;AACpC,0DAAgC;AAChC,6DAAmC;AACnC,2DAAiC;AACjC,kEAAwC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/availability/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,0DAAgC;AAChC,8DAAoC;AACpC,0DAAgC;AAChC,6DAAmC;AACnC,2DAAiC;AACjC,kEAAwC;AACxC,kEAAwC"}

package/src/lib/interfaces/availability/locationRecord.d.ts

@@ -1,5 +1,6 @@
 import { AvailabilityState } from '../../enumerations/availabilityState';
 import { IBlockMetadata } from '../storage/blockMetadata';
+import { PoolId } from '../storage/pooledBlockStore';
 /**
  * Location record for a block, tracking which node holds a copy
  * and metadata about that copy.
@@ -23,6 +24,10 @@ export interface ILocationRecord {
      * Optional latency measurement to this node in milliseconds
      */
     latencyMs?: number;
+    /**
+     * Pool the block is stored in on this node
+     */
+    poolId?: PoolId;
 }
 /**
  * Extended block metadata with availability and location information.
@@ -60,6 +65,7 @@ export interface SerializedLocationRecord {
     lastSeen: string;
     isAuthoritative: boolean;
     latencyMs?: number;
+    poolId?: string;
 }
 /**
  * Serializable representation of IBlockMetadataWithLocation

package/src/lib/interfaces/availability/locationRecord.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locationRecord.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/availability/locationRecord.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAKzE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,IAAI,CAAC;IAEf;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA2B,SAAQ,cAAc;IAChE;;OAEG;IACH,iBAAiB,EAAE,iBAAiB,CAAC;IAErC;;OAEG;IACH,eAAe,EAAE,eAAe,EAAE,CAAC;IAEnC;;OAEG;IACH,iBAAiB,EAAE,IAAI,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,GAClB,IAAI,CACL,0BAA0B,EAC1B,mBAAmB,GAAG,iBAAiB,GAAG,mBAAmB,CAC9D,CAYA;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,eAAe,EAAE,wBAAwB,EAAE,CAAC;IAC5C,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,GACtB,wBAAwB,CAO1B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,wBAAwB,GACnC,eAAe,CA2CjB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,0BAA0B,GACnC,mCAAmC,CAkBrC;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,mCAAmC,GAC9C,0BAA0B,CA+I5B"}
+{"version":3,"file":"locationRecord.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-lib/src/lib/interfaces/availability/locationRecord.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAKzE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAiB,MAAM,6BAA6B,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,IAAI,CAAC;IAEf;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA2B,SAAQ,cAAc;IAChE;;OAEG;IACH,iBAAiB,EAAE,iBAAiB,CAAC;IAErC;;OAEG;IACH,eAAe,EAAE,eAAe,EAAE,CAAC;IAEnC;;OAEG;IACH,iBAAiB,EAAE,IAAI,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,GAClB,IAAI,CACL,0BAA0B,EAC1B,mBAAmB,GAAG,iBAAiB,GAAG,mBAAmB,CAC9D,CAYA;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,eAAe,EAAE,wBAAwB,EAAE,CAAC;IAC5C,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,GACtB,wBAAwB,CAQ1B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,wBAAwB,GACnC,eAAe,CA0DjB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,0BAA0B,GACnC,mCAAmC,CAkBrC;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,mCAAmC,GAC9C,0BAA0B,CA+I5B"}