@ibgib/core-gib 0.1.48 → 0.1.50

package/ibgib-foundations.md

@@ -6,102 +6,120 @@ This document serves as an onboarding guide and technical reference for the **ib
 
 At its lowest level, anything in the system is an **ibGib**.
 
-*   **ib**: The "Metadata". Often a string like "comment", "pic", or "link". It can be descriptive or functional (e.g., class names).
-*   **gib**: The "Hash". A cryptographic hash (SHA-256 in V1) of the entire ibGib record.
-*   **ib^gib**: The content address. Uniquely identifies a record in the universe.
+* **ib**: The "Metadata". Often a string like "comment", "pic", or "link". It can be descriptive or functional (e.g., class names).
+* **gib**: The "Hash". A cryptographic hash (SHA-256 in V1) of the entire ibGib record.
+* **ib^gib**: The content address. Uniquely identifies a record in the universe.
 
 ### `gib` Nuances: Punctiliar vs. TJP
 The `gib` is more than a single hash; it encodes timeline context.
-*   **Punctiliar Hash**: The hash of *just* the current frame's content. Every ibgib has this.
-*   **TJP Gib (Timeline ID)**: The `gib` of the **Temporal Junction Point (TJP)**—the very first frame (Genesis/Fork) of the timeline.
-*   **Composite Address**: Use `ib^[punctiliar_hash].[tjp_gib]`.
-    *   Example: `comment^<CURRENT_HASH>.<GENESIS_HASH>`
-    *   This allows us to identify *which* timeline a frame belongs to simply by looking at its address.
-    *   The `tjp` frame itself has a single hash (since its punctiliar hash IS the tjp gib).
+* **Punctiliar Hash**: The hash of *just* the current frame's content. Every ibgib has this.
+* **TJP Gib (Timeline ID)**: The `gib` of the **Temporal Junction Point (TJP)**—the very first frame (Genesis/Fork) of the timeline.
+* **Composite Address**: Use `ib^[punctiliar_hash].[tjp_gib]`.
+    * Example: `comment^<CURRENT_HASH>.<GENESIS_HASH>`
+    * This allows us to identify *which* timeline a frame belongs to simply by looking at its address.
+    * The `tjp` frame itself has a single hash (since its punctiliar hash IS the tjp gib).
 
 ### Structure
 An `IbGib_V1` object has two primary payload containers:
-1.  **data**: Intrinsic, immutable properties. (e.g., text content, configuration flags).
-2.  **rel8ns**: Extrinsic, Directed Acyclic Graph (DAG) links to other ibGibs.
-    *   Named edges (e.g., `past`, `ancestor`, `pic`).
-    *   Always stored as an array of addresses (`IbGibAddr[]`).
+1. **data**: Intrinsic, immutable properties. (e.g., text content, configuration flags).
+2. **rel8ns**: Extrinsic, Directed Acyclic Graph (DAG) links to other ibGibs.
+    * Named edges (e.g., `past`, `ancestor`, `pic`).
+    * Always stored as an array of addresses (`IbGibAddr[]`).
 
 ### Transforms (The "Verbs")
 State is never mutated in place; it is evolved via transforms.
-*   **[fork](file:../libs/ts-gib/src/V1/transforms/fork.mts)**: Creates a new timeline.
-    *   **Crucial**: Appends to `ancestor` but **CLEARS** the `past` rel8n. This is what births a new timeline.
-*   **[mut8](file:../libs/ts-gib/src/V1/transforms/mut8.mts)** (Mutate): Evolves intrinsic data.
-    *   **Accretive**: By default, it *appends* the new address to the `past` array. It does **not** create a linked list unless `linkedRel8ns` is explicitly used.
-    *   Access the immediate past via `ibgib.rel8ns.past.at(-1)`.
-*   **[rel8](file:../libs/ts-gib/src/V1/transforms/rel8.mts)** (Relate): Evolves extrinsic relationships.
-    *   Also accretive by default.
+* **[fork](file:../libs/ts-gib/src/V1/transforms/fork.mts)**: Creates a new timeline.
+    * **Crucial**: Appends to `ancestor` but **CLEARS** the `past` rel8n. This is what births a new timeline.
+* **[mut8](file:../libs/ts-gib/src/V1/transforms/mut8.mts)** (Mutate): Evolves intrinsic data.
+    * **Accretive**: By default, it *appends* the new address to the `past` array. It does **not** create a linked list unless `linkedRel8ns` is explicitly used.
+    * Access the immediate past via `ibgib.rel8ns.past.at(-1)`.
+* **[rel8](file:../libs/ts-gib/src/V1/transforms/rel8.mts)** (Relate): Evolves extrinsic relationships.
+    * Also accretive by default.
 
 ### DNA (The "How")
 The **`dna`** rel8n is a critical component for distributed consistency.
-*   **Memoization**: It stores the *arguments* used to create a transform (e.g., the specific `dataToAddOrPatch` in a `mut8`).
-*   **In-Structure History**: These arguments are embedded directly in the ibGib structure via the `dna` rel8n.
-*   **Merge Strategy**: When resolving divergent timelines, we don't just compare the final state. We examine the `dna` to understand the *intent* of the divergence.
-    *   *Example*: Two users edit a comment. One fixes a typo, one adds a sentence. By examining the `dna` (the `mut8` args), we can construct a new transform that applies both changes, rather than one overwriting the other.
+* **Memoization**: It stores the *arguments* used to create a transform (e.g., the specific `dataToAddOrPatch` in a `mut8`).
+* **In-Structure History**: These arguments are embedded directly in the ibGib structure via the `dna` rel8n.
+* **Merge Strategy**: When resolving divergent timelines, we don't just compare the final state. We examine the `dna` to understand the *intent* of the divergence.
+    *  *Example*: Two users edit a comment. One fixes a typo, one adds a sentence. By examining the `dna` (the `mut8` args), we can construct a new transform that applies both changes, rather than one overwriting the other.
 
 
 ## 2. Higher-Level Architecture (`core-gib`)
 
 ### Witness Pattern
 The **[Witness](file:src/witness/witness-types.mts)** is the core functional paradigm.
-*   **Concept**: An ibGib that "observes" (witnesses) another ibGib and produces a result.
-*   **Benefits**:
-    *   **Memoization**: Enables memoizing inputs, outputs, and parameters of the witness class itself.
-    *   **Aspect-Oriented Composeability**: Provides a single interaction point for easy composition of behaviors (logging, security, permissions).
-*   **Interface**: `witness(arg: IbGib) -> Promise<IbGib>`
+* **Concept**: An ibGib that "observes" (witnesses) another ibGib and produces a result.
+* **Benefits**:
+    * **Memoization**: Enables memoizing inputs, outputs, and parameters of the witness class itself.
+    * **Aspect-Oriented Composeability**: Provides a single interaction point for easy composition of behaviors (logging, security, permissions).
+* **Interface**: `witness(arg: IbGib) -> Promise<IbGib>`
 
 ### Space Paradigm & Metaspace
 **[Space](file:src/witness/space/space-types.mts)** is a specialized Witness responsible for storage and retrieval.
-*   **Commands**: `put`, `get`, `delete`.
-*   **Locations**: `local`, `sync`, `innerspace` (memory-only/test).
+* **Commands**: `put`, `get`, `delete`.
+* **Locations**: `local`, `sync`, `innerspace` (memory-only/test).
 
 **[Metaspace](file:src/witness/space/metaspace/metaspace-types.mts)**
-*   **Role**: Currently acts as a **Singleton Facade** for the runtime context.
-    *   Does NOT yet actively route "get from any space" requests (though planned).
-    *   Initializes default local spaces.
-    *   **Persistence vs. Indexing**:
-        *   `metaspace.put`: Persists the ibGib to the underlying space(s).
-        *   `metaspace.registerNewIbGib`: Updates the *index* (e.g., "Latest" pointers for timelines) and broadcasts the event via PubSub.
-        *   *Usage*: Always `put` first, then `register` if it's a new timeline tip.
+* **Role**: Currently acts as a **Singleton Facade** for the runtime context.
+    * Does NOT yet actively route "get from any space" requests (though planned).
+    * Initializes default local spaces.
+    * **Persistence vs. Indexing**:
+        * `metaspace.put`: Persists the ibGib to the underlying space(s) via `putInSpace`.
+        * `metaspace.registerNewIbGib`: Updates the *index* (e.g., "Latest" pointers for timelines) and broadcasts the event via `registerNewIbGib` with the pre-configured `fnBroadcast` when metaspace is initialized.
+        *  *Usage*: put first, then register (skipping register only in rare cases).
 
 ### Timeline Facade (`timeline-api`)
 **[Timeline API](file:src/timeline/timeline-api.mts)** acts as a consumer-friendly facade over the raw Witness/Transform calls.
-*   **Purpose**: Simplifies common operations like "Update this timeline with new data" (`mut8Timeline`).
-*   **Abstraction**: Hides the complexity of TJP lookup, generic transforms, and graph traversal.
-
-### respec-gib Test Framework
-
-`respec-gib` is a custom, vastly simplified testing framework. Key points:
-
-- **No CLI arguments**: The test runner does NOT parse command-line arguments like `--testPathPattern` or other Jest-style flags.
-- **Focusing tests**: The ONLY way to focus/filter tests is via `ifWeMight(` regex pattern matching in the test runner script.
-- Commands: Use `npm run test:agent` to run all tests, or modify the `ifWeMight` regex in `src/respec-gib.node.mts` to focus specific test files. (`respec-gib`)
-**[respec-gib](file:src/respec-gib.node.mts)** is the custom BDD-style testing framework.
-*   **Structure**:
-    *   `respecfully`: Top-level organizational block (must `await`).
-    *   `ifWe`: Leaf-node test block (must `await`).
-    *   `iReckon`: Assertions (synchronous, inside `ifWe`).
-    *   *Note*: The test runner crudely regex-searches for `"ifWeMight("`.
+* **Purpose**: Simplifies common operations like "Update this timeline with new data" (`mut8Timeline`).
+* **Abstraction**: Hides the complexity of TJP lookup, generic transforms, and graph traversal.
+
+### *respec-gib* Test Framework
+
+Since `ibgib` has unique execution environment requirements and a high need for custom asynchronous block handling, it uses a custom testing framework located in `@ibgib/helper-gib/dist/respec-gib`. Each lib/app has its own test runner script located in [lib/app]/src/respec-gib.node.mts, e.g., libs/helper-gib/src/respec-gib.node.mts or libs/core-gib/src/respec-gib.node.mts.
+
+Key features include:
+* **`respecfully`**: The equivalent of `describe` or an outer test suite block.
+  * async call, MUST USE await
+  * organizational block
+  * YES can be nested
+* **`ifWe`**: The equivalent of `it`, used for defining a specific test case block.
+  * async call, MUST USE await
+  * can NOT be nested
+* **`ifWeMight`**: A focused test case (equivalent to `fit` or `it.only`). Using this will restrict execution to only the `ifWeMight` block(s) and skip all others.
+  * async call, MUST USE await
+  * can NOT be nested
+* **`iReckon`**: The assertion fluent API (equivalent to `expect`).
+  * sync call, do NOT await
+  * Only specific assertion methods are available compared to other bigger (and funded/helped) testing frameworks:
+  * *Assertions*:
+    * `willEqual(expected)` - Tests deep equality or reference equality.
+    * `isGonnaBe(expected)` - Tests equality.
+    * `isGonnaBeTruthy()` / `isGonnaBeFalsy()` - Tests truthiness.
+    * `isGonnaBeTrue()` / `isGonnaBeFalse()` - Strict equality to true/false.
+    * `isGonnaBeUndefined()` - Strict equality to undefined.
+    * `includes(expected)` - Tests array or substring inclusion.
+  * *Modifiers*:
+    * **`.not`**: Can precede any assertion (e.g., `iReckon(sir, x).not.isGonnaBe(true)`).
+    * **`.asTo(label)`**: Used to add context to the error message (e.g., `iReckon(sir, x).asTo("Checking user ID").willEqual(5)`).
+* Setup and Teardown methods run dynamically per suite context:
+  * `firstOfAll` / `lastOfAll` - Runs once per outer suite.
+  * `firstOfEach` / `lastOfEach` - Runs before/after each inner child (`respecfully` or `ifWe/Might`), or modify the `ifWeMight` regex in `src/respec-gib.node.mts` to focus specific test files.
 
 ### Timelines & Temporal Junction Points (TJPs)
-*   **Accretion vs. Linked List**: Timelines are typically **accretive**. We carry the full history of addresses in the `past` array (`past: [h1, h2, h3...]`).
-    *   *Tradeoff*: Increases metadata size but avoids O(N) network fetches required to traverse a linked list history.
-    *   *Optimization*: Future storage engines will compress this redundancy.
-*   **TJP**: The stable identifier. In code, the TJP's `gib` is often used as the **Lock Scope** to serialize transforms on that timeline.
+* **Accretion vs. Linked List**: Timelines are typically **accretive**. We carry the full history of addresses in the `past` array (`past: [h1, h2, h3...]`).
+  *  *Tradeoff*: Increases metadata size but avoids O(N) network fetches required to traverse a linked list history.
+  *  *Optimization*: Future storage engines will compress this redundancy.
+* **TJP**: The stable identifier. In code, the TJP's `gib` is often used as the **Lock Scope** to serialize transforms on that timeline.
 
 ### IMPORTANT: Ancestor vs. Previous Frame
 It is critical to distinguish between these two relationships:
-*   **Previous Frame (`past`)**: Points to the immediate predecessor in the *same* timeline. This is the "parent" in the Git commit sense.
-    *   *Usage*: `mut8`, `rel8`.
-    *   *Meaning*: "I am the next step in this timeline."
-*   **Ancestor (`ancestor`)**: Points to the source from which a *new* timeline was spawned.
-    *   *Usage*: **ONLY** `fork`.
-    *   *Meaning*: "I am the beginning of a *new* timeline that came from that timeline."
-    *   *Constraint*: A `fork` transform clears the `past` array and adds the source to `ancestor`.
+* **Previous Frame (`past`)**: Points to the immediate predecessor in the *same* timeline. This is the "parent" in the Git commit sense.
+    *  *Usage*: `mut8`, `rel8`.
+    *  *Meaning*: "I am the next step in this timeline."
+* **Ancestor (`ancestor`)**: Points to the source from which a *new* timeline was spawned.
+    *  *Usage*: **ONLY** `fork`.
+    *  *Meaning*: "I am the beginning of a *new* timeline that came from that timeline."
+    *  *Constraint*: A `fork` transform clears the `past` array and adds the source to `ancestor`.
 
 > [!IMPORTANT]
 > Never use "ancestor" to refer to the previous frame in a timeline history. That is the "past". Ancestor implies a fork.
@@ -112,36 +130,38 @@ The Sync Protocol is a **Symmetric, Peer-to-Peer** protocol modeled as a "Saga".
 See: **[Sync README](file:src/sync/README.md)**
 
 ### Core Components
-*   **[SyncSagaIbGib](file:src/sync/sync-types.mts)**: The timeline tracking the sync session itself. Acts as an audit trail.
-*   **[SyncSagaCoordinator](file:src/sync/sync-saga-coordinator.mts)**: The State Machine driver. Code is identical on both "Alice" (Source) and "Bob" (Destination) nodes.
-*   **Message Stones**: Immutable data packets passed between peers (Init, Ack, Delta, Commit).
+* **[SyncSagaIbGib](file:src/sync/sync-types.mts)**: The timeline tracking the sync session itself. Acts as an audit trail.
+* **[SyncSagaCoordinator](file:src/sync/sync-saga-coordinator.mts)**: The State Machine driver. Code is identical on both "Alice" (Source) and "Bob" (Destination) nodes.
+* **Message Stones**: Immutable data packets passed between peers (Init, Ack, Delta, Commit).
 
 ### Protocol Flow
-1.  **Init**: Sender generates a **Knowledge Vector** (KV) summary.
-2.  **Gap Analysis**: Receiver compares KVs.
-    *   Sender behind -> **Push Offer**.
-    *   Sender ahead -> **Delta Request**.
-    *   Diverged -> **Conflict**.
-3.  **Ack**: Receiver sends back lists of needs/offers.
-4.  **Delta/Push**: Data exchange.
-5.  **Commit**: Session finalized.
+1. **Init**: Sender generates a **Knowledge Vector** (KV) summary.
+2. **Gap Analysis**: Receiver compares KVs.
+    * Sender behind -> **Push Offer**.
+    * Sender ahead -> **Delta Request**.
+    * Diverged -> **Conflict**.
+3. **Ack**: Receiver sends back lists of needs/offers.
+4. **Delta/Push**: Data exchange.
+5. **Commit**: Session finalized.
 
 ## 4. Identity (Keystone)
 
 **[Keystone](file:src/keystone/README.md)** is a novel, graph-native identity mechanism using **Hash-Based Cryptography** (Post-Quantum ready).
 
-*   **Concept**: An identity is not a public key; it is a **Timeline** (Keystone). Verification is **Auditability**. To verify "Alice", you replay her Keystone timeline from Genesis to now, verifying proofs at each step.
-*   **Mechanisms**:
-    *   **Hash-Reveal**: Uses schemes similar to **Lamport Signatures** or **Winternitz OTS**, but adapted for the ibGib graph.
-    *   **Merkle DAGs**: Efficiently communicates identity state by only syncing missing graph nodes.
-    *   **Sigma Protocols**: Can support zero-knowledge proofs for authentication without revealing private keys (future).
-*   **Session Identity**: In Sync, we use ephemeral "Session Keystones" to sign the Saga, ensuring the integrity of the sync session without exposing long-term Master Identity keys.
+* **Concept**: An identity is not a public key; it is a **Timeline** (Keystone). Verification is **Auditability**. To verify "Alice", you replay her Keystone timeline from Genesis to now, verifying proofs at each step.
+* **Mechanisms**:
+    * **Hash-Reveal**: Uses schemes similar to **Lamport Signatures** or **Winternitz OTS**, but adapted for the ibGib graph.
+    * **Merkle DAGs**: Efficiently communicates identity state by only syncing missing graph nodes.
+    * **Sigma Protocols**: Can support zero-knowledge proofs for authentication without revealing private keys.
+      * Only partially implemented
+* **Session Identity**: In Sync, we use ephemeral "Session Keystones" to sign the Saga, ensuring the integrity of the sync session without exposing long-term Master Identity keys.
+  * Only partially implemented
 
 ## Reference Links
-*   **Core Types**: [libs/ts-gib/src/types.mts](file:../libs/ts-gib/src/types.mts)
-*   **Transforms**: [libs/ts-gib/src/V1/transforms/](file:../libs/ts-gib/src/V1/transforms/)
-*   **Witness**: [libs/core-gib/src/witness/witness-types.mts](file:src/witness/witness-types.mts)
-*   **Space**: [libs/core-gib/src/witness/space/space-types.mts](file:src/witness/space/space-types.mts)
-*   **Timeline API**: [libs/core-gib/src/timeline/timeline-api.mts](file:src/timeline/timeline-api.mts)
-*   **Sync Coordinator**: [libs/core-gib/src/sync/sync-saga-coordinator.mts](file:src/sync/sync-saga-coordinator.mts)
-*   **Keystone**: [libs/core-gib/src/keystone/README.md](file:src/keystone/README.md)
+* **Core Types**: [libs/ts-gib/src/types.mts](file:../libs/ts-gib/src/types.mts)
+* **Transforms**: [libs/ts-gib/src/V1/transforms/](file:../libs/ts-gib/src/V1/transforms/)
+* **Witness**: [libs/core-gib/src/witness/witness-types.mts](file:src/witness/witness-types.mts)
+* **Space**: [libs/core-gib/src/witness/space/space-types.mts](file:src/witness/space/space-types.mts)
+* **Timeline API**: [libs/core-gib/src/timeline/timeline-api.mts](file:src/timeline/timeline-api.mts)
+* **Sync Coordinator**: [libs/core-gib/src/sync/sync-saga-coordinator.mts](file:src/sync/sync-saga-coordinator.mts)
+* **Keystone**: [libs/core-gib/src/keystone/README.md](file:src/keystone/README.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibgib/core-gib",
-  "version": "0.1.48",
+  "version": "0.1.50",
   "description": "ibgib core functionality, including base architecture for witnesses, spaces, apps, robbots, etc., as well as shared utility functions. Node v19+ needed for heavily-used isomorphic webcrypto hashing consumed in both node and browsers.",
   "funding": {
     "type": "individual",

package/src/common/comment/comment-constants.mts

@@ -8,3 +8,9 @@ export const DEFAULT_COMMENT_TEXT_IB_SUBSTRING_LENGTH = 20;
  * @example "comment thisisacomm here_is_addl_metadata"
  */
 export const DEFAULT_COMMENT_METADATA_IB_SUBSTRING_LENGTH = 128;
+
+/**
+ * if whitespace-only comment ibgib is enabled, the ib will contain this in
+ * place of the whitespace text.
+ */
+export const COMMENT_IB_WHITESPACE_ONLY_TEXT = '___whitespace___';

package/src/common/comment/comment-helper.mts

@@ -6,7 +6,7 @@ import { GLOBAL_LOG_A_LOT } from '../../core-constants.mjs';
 import { IbGibSpaceAny } from '../../witness/space/space-base-v1.mjs';
 import { persistTransformResult } from '../../witness/space/space-helper.mjs';
 import { CommentData_V1, CommentIbGib_V1 } from './comment-types.mjs';
-import { DEFAULT_COMMENT_METADATA_IB_SUBSTRING_LENGTH, DEFAULT_COMMENT_TEXT_IB_SUBSTRING_LENGTH } from './comment-constants.mjs';
+import { COMMENT_IB_WHITESPACE_ONLY_TEXT, DEFAULT_COMMENT_METADATA_IB_SUBSTRING_LENGTH, DEFAULT_COMMENT_TEXT_IB_SUBSTRING_LENGTH } from './comment-constants.mjs';
 
 const logalot = GLOBAL_LOG_A_LOT || false;
 
@@ -100,6 +100,7 @@ export async function createCommentIbGib({
   addlMetadataText,
   saveInSpace,
   space,
+  dontTrimText,
 }: {
   /**
    * comment text
@@ -121,6 +122,14 @@ export async function createCommentIbGib({
    * this space.
    */
   space?: IbGibSpaceAny,
+  /**
+   * If true, stores `text` verbatim without trimming leading/trailing
+   * whitespace. Required for lossless chunking where rawTexts must tile the
+   * parent source exactly.
+   *
+   * Default: false (existing behaviour — trims whitespace).
+   */
+  dontTrimText?: boolean,
 }): Promise<TransformResult<CommentIbGib_V1>> {
   const lc = `[${createCommentIbGib.name}]`;
 
@@ -128,16 +137,16 @@ export async function createCommentIbGib({
   try {
     if (!text) { throw new Error(`text required (E: 3e3d0f555e1a83771a6548eb10943522)`); }
 
-    text = text.trim();
+    if (!dontTrimText) { text = text.trim(); }
 
-    if (!text) { throw new Error(`text cannot be only whitespace (E: d6db3537b9834294836aeb70987c908e)`); }
+    if (!text) { throw new Error(`text cannot be only whitespace when dontTrimText is falsy. (E: d6db3537b9834294836aeb70987c908e)`); }
 
     const data: CommentData_V1 = { text, textTimestamp: getTimestamp() };
 
     // create an ibgib with the filename and ext
     const opts: any = {
       parentIbGib: factory.primitive({ ib: 'comment' }),
-      ib: getCommentIb({ commentText: text, addlMetadataText }),
+      ib: getCommentIb({ commentText: text.trim() || COMMENT_IB_WHITESPACE_ONLY_TEXT, addlMetadataText }),
       data,
       dna: true,
       tjp: { uuid: true, timestamp: true },

package/src/sync/sync-conflict-adv-multitimelines.respec.mts

@@ -86,7 +86,7 @@ await respecfully(sir, `Multi-round/timeline permutations`, async () => {
         const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
         await peer.initialized;
         await peer.initializeOpts({
-            senderSpace: sourceSpace,
+            localSpace: sourceSpace,
             receiverSpace: destSpace,
             receiverCoordinator: receiverCoordinator,
             receiverMetaspace: metaspace,

package/src/sync/sync-conflict-basic-divergence.respec.mts

@@ -222,7 +222,7 @@ await respecfully(sir, `Two different fields`, async () => {
             const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
             await peer.initialized;
             await peer.initializeOpts({
-                senderSpace: sourceSpace,   // "Client"
+                localSpace: sourceSpace,   // "Client"
                 receiverSpace: destSpace,   // "Server"
                 receiverCoordinator,
                 receiverMetaspace: metaspace,

package/src/sync/sync-conflict-basic-multitimelines.respec.mts

@@ -208,7 +208,7 @@ await respecfully(sir, `Two different fields and rel8d`, async () => {
     const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
     await peer.initialized;
     await peer.initializeOpts({
-        senderSpace: sourceSpace,   // "Client"
+        localSpace: sourceSpace,   // "Client"
         receiverSpace: destSpace,   // "Server"
         receiverCoordinator,
         receiverMetaspace: metaspace,

package/src/sync/sync-conflict-text-merge.respec.mts

@@ -88,7 +88,7 @@ await respecfully(sir, `Text merge (LCS) conflict resolution`, async () => {
         const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
         await peer.initialized;
         await peer.initializeOpts({
-            senderSpace: sourceSpace,
+            localSpace: sourceSpace,
             receiverSpace: destSpace,
             receiverCoordinator: receiverCoordinator,
             receiverMetaspace: metaspace,

package/src/sync/sync-innerspace-constants.respec.mts

@@ -73,7 +73,7 @@ await respecfully(sir, `Sync Constants (No TJP)`, async () => {
         const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
         await peer.initialized;
         await peer.initializeOpts({
-            senderSpace: sourceSpace,   // "Client"
+            localSpace: sourceSpace,   // "Client"
             receiverSpace: destSpace,   // "Server"
             receiverCoordinator,
             receiverMetaspace: metaspace,

package/src/sync/sync-innerspace-deep-updates.respec.mts

@@ -104,7 +104,7 @@ await respecfully(sir, `Sync InnerSpaces (Deep Updates)`, async () => {
         const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
         await peer.initialized;
         await peer.initializeOpts({
-            senderSpace: sourceSpace,   // "Client"
+            localSpace: sourceSpace,   // "Client"
             receiverSpace: destSpace,   // "Server"
             receiverCoordinator,
             receiverMetaspace: metaspace,

package/src/sync/sync-innerspace-dest-ahead-withid.respec.mts

@@ -124,7 +124,7 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
             return resGet.success && resGet.ibGibs && resGet.ibGibs.length === 1;
         }
 
-        await ifWeMight(sir, 'verify setup', async () => {
+        await ifWe(sir, 'verify setup', async () => {
             // Ensure V2 is ONLY in Dest (it is, per `space: destSpace`)
             // Ensure Source does NOT have V2
             iReckon(sir, await fnAddrExistsInSpace(addrV0, sourceSpace)).asTo('source has V0').isGonnaBeTrue();
@@ -143,7 +143,7 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
         const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
         await peer.initialized;
         await peer.initializeOpts({
-            senderSpace: sourceSpace,   // "Client"
+            localSpace: sourceSpace,   // "Client"
             receiverSpace: destSpace,   // "Server"
             receiverCoordinator,
             receiverMetaspace: metaspace,
@@ -193,7 +193,7 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
         // 5. Verify Sync (v2 should be in both source and dest now)
         console.log(`${lc} Verifying Sync...`);
 
-        await ifWeMight(sir, `verify v2 now also in source`, async () => {
+        await ifWe(sir, `verify v2 now also in source`, async () => {
             // Verify Tip (V2)
 
             iReckon(sir, await fnAddrExistsInSpace(addrV0, sourceSpace)).asTo('source has V0').isGonnaBeTrue();
@@ -205,7 +205,7 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
 
         });
 
-        await ifWeMight(sir, `dependency graphs the same`, async () => {
+        await ifWe(sir, `dependency graphs the same`, async () => {
 
             const sourceDepGraph = await getDependencyGraph({
                 ibGibAddr: addrV2,
@@ -234,7 +234,7 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
         // For now, we'll retrieve from spaces after sync completes
         let sessionKeystoneAddr: IbGibAddr | undefined;
 
-        await ifWeMight(sir, 'IDENTITY: session keystone exists in sender space', async () => {
+        await ifWe(sir, 'IDENTITY: session keystone exists in sender space', async () => {
             // TODO: Get saga IbGib and access sessionKeystones rel8n
             // Once saga access is implemented (per Bill's guidance), retrieve keystone addr from:
             // const keystoneAddrs = sagaIbGib.rel8ns?.sessionKeystones;
@@ -258,7 +258,7 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
                 .isGonnaBeTrue();
         });
 
-        await ifWeMight(sir, 'IDENTITY: session keystone exists in receiver space', async () => {
+        await ifWe(sir, 'IDENTITY: session keystone exists in receiver space', async () => {
             // Session keystone should be transferred to receiver's durable space
             iReckon(sir, sessionKeystoneAddr)
                 .asTo('session keystone address was captured')
@@ -272,7 +272,7 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
             }
         });
 
-        await ifWeMight(sir, 'IDENTITY: saga frames are signed', async () => {
+        await ifWe(sir, 'IDENTITY: saga frames are signed', async () => {
             // TODO: Get saga frames and check each has a proof
             // This will FAIL when we actually check - that's the point (TDD RED)
 
@@ -281,7 +281,7 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
                 .isGonnaBeTrue();
         });
 
-        await ifWeMight(sir, 'IDENTITY: frame signatures are valid', async () => {
+        await ifWe(sir, 'IDENTITY: frame signatures are valid', async () => {
             // TODO: For each saga frame, validate proof against session keystone
             // const isValid = await validateProofWithKeystone({
             //     proof: frame.proof,
@@ -296,7 +296,7 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
                 .isGonnaBeTrue();
         });
 
-        await ifWeMight(sir, 'IDENTITY: session keystone challenges are depleted', async () => {
+        await ifWe(sir, 'IDENTITY: session keystone challenges are depleted', async () => {
             // TODO: Session keystone should evolve after signing frames
             // This will FAIL because keystone evolution not implemented yet
 
@@ -305,7 +305,7 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
                 .isGonnaBeTrue();
         });
 
-        await ifWeMight(sir, 'IDENTITY: frame timestamps are present and fresh', async () => {
+        await ifWe(sir, 'IDENTITY: frame timestamps are present and fresh', async () => {
             // TODO: Check each frame has timestamp in proof claim
             // const claim = JSON.parse(frame.proof.claim.scope);
             // iReckon(sir, claim.timestamp).asTo('has timestamp').isGonnaBeTruthy();
@@ -318,7 +318,7 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
                 .isGonnaBeTrue();
         });
 
-        await ifWeMight(sir, 'IDENTITY: keystone has no hard links to domain ibgibs', async () => {
+        await ifWe(sir, 'IDENTITY: keystone has no hard links to domain ibgibs', async () => {
             if (sessionKeystoneAddr) {
                 const keystoneResult = await getFromSpace({
                     addr: sessionKeystoneAddr,
@@ -343,7 +343,7 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
             }
         });
 
-        await ifWeMight(sir, 'IDENTITY: saga frames have no hard links to domain ibgibs', async () => {
+        await ifWe(sir, 'IDENTITY: saga frames have no hard links to domain ibgibs', async () => {
             // Saga frames should NOT have hard links to domain ibgibs
             // This currently PASSES but will expose issues if hard links exist
 

package/src/sync/sync-innerspace-dest-ahead.respec.mts

@@ -135,7 +135,7 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
         const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
         await peer.initialized;
         await peer.initializeOpts({
-            senderSpace: sourceSpace,   // "Client"
+            localSpace: sourceSpace,   // "Client"
             receiverSpace: destSpace,   // "Server"
             receiverCoordinator,
             receiverMetaspace: metaspace,

package/src/sync/sync-innerspace-multiple-timelines.respec.mts

@@ -108,7 +108,7 @@ await respecfully(sir, `Sync InnerSpaces (Multiple Timelines)`, async () => {
         const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
         await peer.initialized;
         await peer.initializeOpts({
-            senderSpace: sourceSpace,   // "Client"
+            localSpace: sourceSpace,   // "Client"
             receiverSpace: destSpace,   // "Server"
             receiverCoordinator,
             receiverMetaspace: metaspace,

package/src/sync/sync-innerspace-partial-update.respec.mts

@@ -116,7 +116,7 @@ await respecfully(sir, `Sync InnerSpaces (Partial Update)`, async () => {
         const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
         await peer.initialized;
         await peer.initializeOpts({
-            senderSpace: sourceSpace,   // "Client"
+            localSpace: sourceSpace,   // "Client"
             receiverSpace: destSpace,   // "Server"
             receiverCoordinator,
             receiverMetaspace: metaspace,

package/src/sync/sync-innerspace.respec.mts

@@ -108,7 +108,7 @@ await respecfully(sir, `Sync InnerSpaces`, async () => {
         const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
         await peer.initialized;
         await peer.initializeOpts({
-            senderSpace: sourceSpace,   // "Client"
+            localSpace: sourceSpace,   // "Client"
             receiverSpace: destSpace,   // "Server"
             receiverCoordinator,
             receiverMetaspace: metaspace,