@ibgib/core-gib 0.1.20 → 0.1.22

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

@@ -19,11 +19,14 @@ import { Metaspace_Innerspace } from '../witness/space/metaspace/metaspace-inner
 import { InnerSpace_V1 } from '../witness/space/inner-space/inner-space-v1.mjs';
 import { createTimelineRootHelper, getTestKeystoneServiceHelper } from '../agent-helpers.mjs';
 import { mut8Timeline } from '../timeline/timeline-api.mjs';
-import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace-v1.mjs';
+import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs';
 import { DEFAULT_INNER_SPACE_DATA_V1 } from '../witness/space/inner-space/inner-space-types.mjs';
-import { toDto } from '../common/other/ibgib-helper.mjs';
+import { getTjpAddr, toDto } from '../common/other/ibgib-helper.mjs';
 import { SyncConflictStrategy, SyncSagaInfo } from './sync-types.mjs';
-import { IbGibData_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
+import { IbGibData_V1, IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
+import { fnObs } from '../common/pubsub/observer/observer-helper.mjs';
+import { getDependencyGraph } from '../common/other/graph-helper.mjs';
+import { ErrorIbGib_V1 } from '../common/error/error-types.mjs';
 
 interface TestData extends IbGibData_V1 {
     text?: string;
@@ -71,28 +74,43 @@ await respecfully(sir, `Sync Conflict Resolution`, async () => {
 
         // 2. Seed Common History (V0 -> V1)
         console.log(`${lc} Creating Common History...`);
-        const root = await createTimelineRootHelper<TestData>({
+        const testRoot = await createTimelineRootHelper<TestData>({
             ib: 'timeline_root',
-            data: { type: 'root', text: 'v0' },
+            data: { type: 'testRoot', text: 'v0' },
             space: sourceSpace,
         });
-        // Sync root to dest immediately so they start synced
-        await metaspace.put({ ibGib: root, space: destSpace });
-        await metaspace.registerNewIbGib({ ibGib: root, space: destSpace });
-
-
         // Create V1 (Common)
-        const v1_Source = await mut8Timeline<TestData>({
-            timeline: root,
-            mut8Opts: { dataToAddOrPatch: { text: 'v1_common' } },
+        const v1_Common = await mut8Timeline<TestData>({
+            timeline: testRoot,
+            mut8Opts: {
+                mut8Ib: testRoot.ib + '_common',
+                dataToAddOrPatch: { text: 'v1_common' }
+            },
             metaspace,
             space: sourceSpace,
         });
-        // Sync V1 to dest
-        await metaspace.put({ ibGib: v1_Source, space: destSpace });
-        await metaspace.registerNewIbGib({ ibGib: v1_Source, space: destSpace });
+        const tjpAddr =
+            getTjpAddr({ ibGib: testRoot, defaultIfNone: 'incomingAddr' }) ??
+            getIbGibAddr({ ibGib: testRoot });
+        console.log(`${lc} [TEST DEBUG] tjpAddr: ${tjpAddr}`)
+        // Sync testRoot to dest immediately so they start synced
+        // must get the entire dependency graph for testRoot
+        const depGraph_testRootAndV1Common = await getDependencyGraph({
+            ibGibAddrs: [tjpAddr],
+            space: sourceSpace,
+            live: true,
+        }) ?? {};
+        console.log(`${lc} depGraph_testRootAndV1Common: ${pretty(depGraph_testRootAndV1Common)}`)
+        if (Object.keys(depGraph_testRootAndV1Common).length === 0) {
+            throw new Error(`(UNEXPECTED) depGraph_testRootAndV1Common empty? (E: 39b4d855ffa65476084b4123786da826)`);
+        }
+        // put the entire graph into the destspace, but...
+        await metaspace.put({ ibGibs: Object.values(depGraph_testRootAndV1Common), space: destSpace });
+        // ...only register the main ibgibs
+        await metaspace.registerNewIbGib({ ibGib: testRoot, space: destSpace });
+        await metaspace.registerNewIbGib({ ibGib: v1_Common, space: destSpace });
 
-        const resGetDest = await getFromSpace({ space: destSpace, addr: getIbGibAddr({ ibGib: v1_Source }) });
+        const resGetDest = await getFromSpace({ space: destSpace, addr: getIbGibAddr({ ibGib: v1_Common }) });
         if (!resGetDest.success || !resGetDest.ibGibs || resGetDest.ibGibs.length === 0) {
             throw new Error(`Failed to retrieve v1_Dest from destSpace. (E: a1b2c3d4e5f6g7h8i9j0)`);
         }
@@ -104,8 +122,11 @@ await respecfully(sir, `Sync Conflict Resolution`, async () => {
 
         // Source: V1 -> V2a (Edit Field A)
         const v2a = await mut8Timeline<TestData>({
-            timeline: v1_Source,
-            mut8Opts: { dataToAddOrPatch: { fieldA: 'source_edit' } },
+            timeline: v1_Common,
+            mut8Opts: {
+                mut8Ib: testRoot.ib + '_v2a',
+                dataToAddOrPatch: { fieldA: 'source_edit' }
+            },
             metaspace,
             space: sourceSpace,
         });
@@ -113,15 +134,15 @@ await respecfully(sir, `Sync Conflict Resolution`, async () => {
         // Dest: V1 -> V2b (Edit Field B)
         const v2b = await mut8Timeline<TestData>({
             timeline: v1_Dest,
-            mut8Opts: { dataToAddOrPatch: { fieldB: 'dest_edit' } },
+            mut8Opts: {
+                mut8Ib: testRoot.ib + '_v2b',
+                dataToAddOrPatch: { fieldB: 'dest_edit' }
+            },
             metaspace,
             space: destSpace,
         });
 
         // Verify Divergence
-        const tjpAddr = root.rel8ns!.tjp![0]; // wait, root IS tjp, so no tjp rel8n...
-        // Actually root frame has isTjp: true.
-        // v1 has tjp: [v0_gib].
         console.log(`${lc} Divergence created.`);
 
 
@@ -131,27 +152,47 @@ await respecfully(sir, `Sync Conflict Resolution`, async () => {
         const senderCoordinator = new SyncSagaCoordinator(mockKeystone);
         const receiverCoordinator = new SyncSagaCoordinator(mockKeystone);
 
+
+
         const peer = new SyncPeerInnerspace_V1({
             senderSpace: sourceSpace,
+            // No senderTempSpace - sync() creates its own internally
             receiverSpace: destSpace,
             receiverCoordinator,
             receiverMetaspace: metaspace,
+            receiverTempSpace: 0 as any, // placeholder this is wrong
+            senderTempSpace: 0 as any, // placeholder this is wrong
+        }, {
+            classname: SyncPeerInnerspace_V1.name,
         });
+        await peer.initialized;
+        await peer.initialize();
 
         // Verify Receiver has correct KV (Pre-Sync Check)
         // This ensures the conflict precondition exists.
         await ifWe(sir, 'verify receiver KV pre-sync', async () => {
-            const destKV = await receiverCoordinator.getKnowledgeVector({
-                space: destSpace,
-                metaspace,
-                domainIbGibs: [v1_Dest]
-            });
-            const v1TjpAddr = v1_Dest.rel8ns?.tjp?.[0] || getIbGibAddr({ ibGib: v1_Dest }); // v1 might be tjp if it was root, but here v1 is child of root
-            // Actually v1 has tjp rel8n.
-            const destTip = destKV[v1TjpAddr];
-            iReckon(sir, !!destTip).asTo(`Dest KV has timeline tip for ${v1TjpAddr}`).isGonnaBeTruthy();
-            if (!destTip) {
-                throw new Error(`Test Setup Fail: Dest Space does not have index for timeline ${v1TjpAddr}. Seeding failed. (E: 8a9b0c1d)`);
+            try {
+                const destKV = await receiverCoordinator.getKnowledgeVector({
+                    space: destSpace,
+                    metaspace,
+                    domainIbGibs: [v1_Dest]
+                });
+                const v1TjpAddr = getTjpAddr({ ibGib: v1_Dest, defaultIfNone: 'incomingAddr' }) ?? getIbGibAddr({ ibGib: v1_Dest });
+                console.log(`[TEST DEBUG] v1_Dest: ${JSON.stringify(v1_Dest)}`);
+                console.log(`[TEST DEBUG] v1TjpAddr: ${v1TjpAddr}`);
+                console.log(`[TEST DEBUG] destKV: ${JSON.stringify(destKV)}`);
+                console.log(`[TEST DEBUG] v1_Dest.rel8ns.tjp: ${v1_Dest.rel8ns?.tjp?.join(', ')}`);
+
+                // Actually v1 has tjp rel8n.
+                const destTip = destKV[v1TjpAddr];
+                iReckon(sir, !!destTip).asTo(`Dest KV has timeline tip for ${v1TjpAddr}`).isGonnaBeTruthy();
+                if (!destTip) {
+                    throw new Error(`Test Setup Fail: Dest Space does not have index for timeline ${v1TjpAddr}. Seeding failed. (E: c194a80b4e4877b77826c37a1753b826)`);
+                }
+
+            } catch (error) {
+                console.error(`${lc} ${extractErrorMsg(error)}`);
+                iReckon(sir, true).asTo('getKnowledgeVector errored out').isGonnaBeFalse();
             }
         });
 
@@ -171,7 +212,32 @@ await respecfully(sir, `Sync Conflict Resolution`, async () => {
                 // explicit useSessionIdentity: true is default
             });
 
+            const sublc = `${lc}[updates$]`;
+            /**
+             * I have added this so you can see how to subscribe to an ibgib
+             * observable using {@link fnObs}.
+             */
+            const subscription = await resSync.updates$.subscribe(fnObs({
+                next: async (ctxIbGib) => {
+                    // console.log(`${sublc} next fired. ${JSON.stringify(ctxIbGib)}`);
+                    console.log(`${sublc} next fired. (I: 72db8820f058312f5cb2a92b8f9bde26)`);
+                },
+                error: async (e: ErrorIbGib_V1) => {
+                    if (e.data) {
+                        console.error(`${sublc} error fired. error: ${JSON.stringify(e.data)} (E: 01cc08ba05ad99682831174fd7c31a26)`);
+                    } else {
+                        console.dir(e);
+                        console.error(`${sublc} error fired. error: ${extractErrorMsg(e)} (E: 73d3d61464e8e4ce4cd6efd8b9675826)`);
+                    }
+                },
+                complete: async () => {
+                    console.log(`${sublc} complete fired`);
+                },
+            }));
+
+            console.log(`${lc} awaiting resSync.done`)
             await resSync.done;
+
             console.log(`${lc} Sync Complete.`);
         } catch (e) {
             console.error(`${lc} Sync Failed with Error:`, e);
@@ -185,9 +251,83 @@ await respecfully(sir, `Sync Conflict Resolution`, async () => {
         const resSourceTip = await getFromSpace({ space: sourceSpace, addr: getIbGibAddr({ ibGib: v2a }) });
 
         await ifWe(sir, `verify merge happened`, async () => {
-            // We expect a new tip that is NOT v2a or v2b
-            // For now, valid failure is that this code doesn't start or completes without merge.
-            iReckon(sir, true).asTo('Merge Verification Not Yet Implemented').isGonnaBeFalse();
+            // Retrieve updated KV from Source (or check what happened to v2a)
+            // Ideally, we just check the source space for the timeline tip
+            // The timeline tip for testRoot/v0 should now be NEW.
+
+            try {
+                // Get the KV for the Source Space
+                const sourceKV = await senderCoordinator.getKnowledgeVector({
+                    space: sourceSpace,
+                    metaspace,
+                    domainIbGibs: [testRoot] // We want to know the tip of this timeline
+                });
+                const tjpAddr =
+                    getTjpAddr({ ibGib: testRoot, defaultIfNone: 'incomingAddr' }) ??
+                    getIbGibAddr({ ibGib: testRoot });
+
+                if (logalot) { console.log(`${lc} getKnowledgeVector returned. sourceKV: ${pretty(sourceKV)} (I: e8780cda37c8b2a46eeb85786874e926)`); }
+
+                const sourceTipAddr = sourceKV[tjpAddr];
+                if (!sourceTipAddr) {
+                    throw new Error(`Source Space missing timeline tip for ${tjpAddr} (E: ec95980b9c980c5c5870812e15e43826)`);
+                }
+                console.log(`${lc} [TEST DEBUG] sourceTipAddr: ${sourceTipAddr}`);
+                console.log(`${lc} [TEST DEBUG] v2a: ${getIbGibAddr({ ibGib: v2a })}`);
+                console.log(`${lc} [TEST DEBUG] v2b: ${getIbGibAddr({ ibGib: v2b })}`);
+
+
+                iReckon(sir, sourceTipAddr).asTo(`Source Tip (${sourceTipAddr}) should NOT be v2a`).not.isGonnaBe(getIbGibAddr({ ibGib: v2a }));
+                iReckon(sir, sourceTipAddr).asTo(`Source Tip (${sourceTipAddr}) should NOT be v2b`).not.isGonnaBe(getIbGibAddr({ ibGib: v2b }));
+
+                // Fetch the new tip
+                const resTip = await getFromSpace({ space: sourceSpace, addr: sourceTipAddr });
+                const newTip = resTip.ibGibs![0] as IbGib_V1<TestData>;
+                console.log(`${lc} [TEST DEBUG] newTip: ${JSON.stringify(newTip)}`);
+
+
+                // Check Data: Should have BOTH edits
+                iReckon(sir, newTip.data!.fieldA).asTo('New Tip Data Field A').isGonnaBe('source_edit');
+                iReckon(sir, newTip.data!.fieldB).asTo('New Tip Data Field B').isGonnaBe('dest_edit');
+
+                // Check Graft Structure
+                // Look for 'graftinfo' rel8n
+                const graftInfoRel = newTip.rel8ns?.graftinfo;
+                iReckon(sir, graftInfoRel).asTo('New Tip should have graftinfo rel8n').isGonnaBeTruthy();
+                if (graftInfoRel) {
+                    iReckon(sir, graftInfoRel!.length).asTo('Only 1 graftinfo').isGonnaBe(1);
+
+                    // Fetch Graft Info Stone
+                    const resGraft = await getFromSpace({ space: sourceSpace, addr: graftInfoRel![0] });
+                    const graftInfo = resGraft.ibGibs![0];
+                    console.log(`${lc} [TEST DEBUG] graftInfo: ${JSON.stringify(graftInfo)}`);
+
+                    // Check Graft Relations (graftbase, graftorphan)
+                    const baseRel = graftInfo.rel8ns?.graftbase;
+                    const orphanRel = graftInfo.rel8ns?.graftorphan;
+
+                    iReckon(sir, baseRel).asTo('Graft Base exists').isGonnaBeTruthy();
+                    iReckon(sir, orphanRel).asTo('Graft Orphan exists').isGonnaBeTruthy();
+
+
+                    // Verify Base/Orphan identity (one should be v2a, one v2b)
+                    const addrV2a = getIbGibAddr({ ibGib: v2a });
+                    const addrV2b = getIbGibAddr({ ibGib: v2b });
+
+                    const bases = baseRel || [];
+                    const orphans = orphanRel || [];
+
+                    const isV2aInvolved = bases.includes(addrV2a) || orphans.includes(addrV2a);
+                    const isV2bInvolved = bases.includes(addrV2b) || orphans.includes(addrV2b);
+
+                    iReckon(sir, isV2aInvolved).asTo('V2a is involved in graft').isGonnaBeTrue();
+                    iReckon(sir, isV2bInvolved).asTo('V2b is involved in graft').isGonnaBeTrue();
+                }
+            } catch (error) {
+                console.error(`${lc} ${extractErrorMsg(error)}`);
+                iReckon(sir, true).asTo('getKnowledgeVector errored out').isGonnaBeFalse();
+            }
+
         });
     });
 

package/src/sync/sync-constants.mts

@@ -1,27 +1,24 @@
 export const SYNC_ATOM = "sync";
 
 export const SYNC_MSG_REL8N_NAME = "sync-msg";
-export const SYNC_SAGA_PAYLOAD_ADDRS_REL8N_NAME = "@payloadAddrs";
-
 /**
- * Protocol version string for V1.
+ * payload addrs should be domain-only, i.e., we are not including the sync
+ * saga ibgib, or its message stone, or identity keystones.
  */
-export const SYNC_PROTOCOL_V1 = "sync 1.0.0";
+export const SYNC_SAGA_PAYLOAD_ADDRS_DOMAIN = "@payloadAddrsDomain";
 
 export const SYNC_STAGE_INIT = "init";
 export const SYNC_STAGE_ACK = "ack";
 export const SYNC_STAGE_REQUEST = "request";
 export const SYNC_STAGE_DELTA = "delta";
 export const SYNC_STAGE_COMMIT = "commit";
-export const SYNC_STAGE_CONFLICT = "conflict";
 
 export type SyncStage =
     | typeof SYNC_STAGE_INIT
     | typeof SYNC_STAGE_ACK
     | typeof SYNC_STAGE_REQUEST
     | typeof SYNC_STAGE_DELTA
-    | typeof SYNC_STAGE_COMMIT
-    | typeof SYNC_STAGE_CONFLICT;
+    | typeof SYNC_STAGE_COMMIT;
 
 export const SyncStage = {
     init: SYNC_STAGE_INIT,
@@ -29,5 +26,4 @@ export const SyncStage = {
     request: SYNC_STAGE_REQUEST,
     delta: SYNC_STAGE_DELTA,
     commit: SYNC_STAGE_COMMIT,
-    conflict: SYNC_STAGE_CONFLICT,
-} as const;
+} satisfies { [key: string]: SyncStage };

package/src/sync/sync-helpers.mts

@@ -7,6 +7,7 @@ import { SYNC_ATOM, SYNC_MSG_REL8N_NAME } from "./sync-constants.mjs";
 import { SyncData_V1, SyncIb_V1, SyncIbGib_V1 } from "./sync-types.mjs";
 import { IbGibSpaceAny } from "../witness/space/space-base-v1.mjs";
 import { getFromSpace } from "../witness/space/space-helper.mjs";
+import { IbGibSpaceResultData, IbGibSpaceResultIbGib, IbGibSpaceResultRel8ns } from "../witness/space/space-types.mjs";
 
 const logalot = GLOBAL_LOG_A_LOT;
 
@@ -161,6 +162,8 @@ export async function isPastFrame({
 /**
  * Gets a shallow dependency graph for a Sync Saga Frame.
  * 
+ * DOES NOT GET THE ENTIRE DEPENDENCY FRAME (INCLUDING PAST).
+ * 
  * Unlike standard `getDependencyGraph`, this does NOT traverse `ancestor` (history) or `past`.
  * It only retrieves the *content* of the current frame:
  * 1. The Frame itself.
@@ -181,13 +184,14 @@ export async function getSyncSagaDependencyGraph({
 
     // Helper to fetch and push
     const fetchAndPush = async (addrs: string[]) => {
-        for (const addr of addrs) {
-            const res = await getFromSpace({ space, addr });
-            if (res.success && res.ibGibs?.length) {
-                result.push(res.ibGibs[0]);
-            } else {
-                if (logalot) { console.warn(`${lc} Failed to find dependency ${addr} for saga frame.`); }
-            }
+        const res = await getFromSpace({ space, addrs });
+        if (res.success && res.ibGibs?.length === addrs.length) {
+            res.ibGibs!.forEach(x => result.push(x));
+        } else {
+            const resIbGib =
+                res.rawResultIbGib as IbGibSpaceResultIbGib<IbGib_V1, IbGibSpaceResultData, IbGibSpaceResultRel8ns>
+            if (!resIbGib.data) { throw new Error(`(UNEXPECTED) res.rawResultIbGib.data falsy? (E: c26c681d2f831fc537ba6f48fee36d26)`); }
+            throw new Error(`(UNEXPECTED) couldn't find addrs? addrsNotFound: ${resIbGib.data.addrsNotFound}? (E: 43b7b5a6ad982715c8f3eed69bfa0d26)`);
         }
     };
 

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

@@ -16,10 +16,10 @@ import { Factory_V1 } from '@ibgib/ts-gib/dist/V1/index.mjs';
 import { SyncSagaCoordinator } from './sync-saga-coordinator.mjs';
 import { putInSpace, getFromSpace } from '../witness/space/space-helper.mjs';
 import { Metaspace_Innerspace } from '../witness/space/metaspace/metaspace-innerspace/metaspace-innerspace.mjs';
-import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace-v1.mjs';
 import { InnerSpace_V1 } from '../witness/space/inner-space/inner-space-v1.mjs';
 import { DEFAULT_INNER_SPACE_DATA_V1 } from '../witness/space/inner-space/inner-space-types.mjs';
 import { getTestKeystoneServiceHelper } from '../agent-helpers.mjs';
+import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs';
 
 const lc = `[sync-innerspace-constants.respec]`;
 
@@ -74,6 +74,10 @@ await respecfully(sir, `Sync Constants (No TJP)`, async () => {
             receiverSpace: destSpace,
             receiverCoordinator: receiverCoordinator,
             receiverMetaspace: metaspace,
+            receiverTempSpace: 0 as any, // placeholder this is wrong
+            senderTempSpace: 0 as any, // placeholder this is wrong
+        }, {
+            classname: SyncPeerInnerspace_V1.name,
         });
 
         // 4. Sync C1 (First Pass)

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

@@ -19,9 +19,9 @@ import { Metaspace_Innerspace } from '../witness/space/metaspace/metaspace-inner
 import { InnerSpace_V1 } from '../witness/space/inner-space/inner-space-v1.mjs';
 import { createTimelineRootHelper, getTestKeystoneServiceHelper } from '../agent-helpers.mjs';
 import { mut8Timeline } from '../timeline/timeline-api.mjs';
-import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace-v1.mjs';
 import { DEFAULT_INNER_SPACE_DATA_V1 } from '../witness/space/inner-space/inner-space-types.mjs';
 import { toDto } from '../common/other/ibgib-helper.mjs';
+import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs';
 
 const logalot = true;
 const lc = `[sync-innerspace-deep-updates.respec]`;
@@ -105,6 +105,10 @@ await respecfully(sir, `Sync InnerSpaces (Deep Updates)`, async () => {
             receiverSpace: destSpace,
             receiverCoordinator: receiverCoordinator,
             receiverMetaspace: metaspace,
+            receiverTempSpace: 0 as any,
+            senderTempSpace: 0 as any,
+        }, {
+            classname: SyncPeerInnerspace_V1.name,
         });
 
         // 4. Run Sync

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

@@ -19,9 +19,9 @@ import { Metaspace_Innerspace } from '../witness/space/metaspace/metaspace-inner
 import { InnerSpace_V1 } from '../witness/space/inner-space/inner-space-v1.mjs';
 import { createTimelineRootHelper, getTestKeystoneServiceHelper } from '../agent-helpers.mjs';
 import { mut8Timeline } from '../timeline/timeline-api.mjs';
-import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace-v1.mjs';
 import { DEFAULT_INNER_SPACE_DATA_V1 } from '../witness/space/inner-space/inner-space-types.mjs';
 import { toDto } from '../common/other/ibgib-helper.mjs';
+import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs';
 
 const logalot = true;
 const lc = `[sync-innerspace-dest-ahead.respec]`;
@@ -98,7 +98,7 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
         });
         const addrV2 = getIbGibAddr({ ibGib: v2 });
 
-        await ifWe(sir, 'verify setup', async () => {
+        await ifWeMight(sir, 'verify setup', async () => {
             // Ensure V2 is ONLY in Dest (it is, per `space: destSpace`)
             // Ensure Source does NOT have V2
             const checkV2InSource = await getFromSpace({ space: sourceSpace, addr: addrV2 });
@@ -115,6 +115,10 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
             receiverSpace: destSpace,
             receiverCoordinator: receiverCoordinator,
             receiverMetaspace: metaspace,
+            receiverTempSpace: 0 as any,// this is wrong just getting to build
+            senderTempSpace: 0 as any, // this is wrong just getting to build
+        }, {
+            classname: SyncPeerInnerspace_V1.name
         });
 
         // 4. Run Sync (Source Pushes V1)
@@ -132,7 +136,7 @@ await respecfully(sir, `Sync InnerSpaces (Dest Ahead)`, async () => {
         // 5. Verify Dest (Should still have V2 as latest)
         console.log(`${lc} Verifying Destination...`);
 
-        await ifWe(sir, `verify dest stays ahead`, async () => {
+        await ifWeMight(sir, `verify dest stays ahead`, async () => {
             // Verify Tip (V2)
             const getV2 = await getFromSpace({ space: destSpace, addr: addrV2 });
             iReckon(sir, getV2.success).asTo('V2 still present in Dest').isGonnaBeTrue();

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

@@ -19,9 +19,9 @@ import { Metaspace_Innerspace } from '../witness/space/metaspace/metaspace-inner
 import { InnerSpace_V1 } from '../witness/space/inner-space/inner-space-v1.mjs';
 import { createTimelineRootHelper, getTestKeystoneServiceHelper } from '../agent-helpers.mjs';
 import { mut8Timeline } from '../timeline/timeline-api.mjs';
-import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace-v1.mjs';
 import { DEFAULT_INNER_SPACE_DATA_V1 } from '../witness/space/inner-space/inner-space-types.mjs';
 import { toDto } from '../common/other/ibgib-helper.mjs';
+import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs';
 
 const logalot = true;
 const lc = `[sync-innerspace-multiple-timelines.respec]`;
@@ -109,6 +109,10 @@ await respecfully(sir, `Sync InnerSpaces (Multiple Timelines)`, async () => {
             receiverSpace: destSpace,
             receiverCoordinator: receiverCoordinator,
             receiverMetaspace: metaspace,
+            receiverTempSpace: 0 as any,
+            senderTempSpace: 0 as any,
+        }, {
+            classname: SyncPeerInnerspace_V1.name,
         });
 
         // 4. Run Sync (Push Both)

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

@@ -19,9 +19,9 @@ import { Metaspace_Innerspace } from '../witness/space/metaspace/metaspace-inner
 import { InnerSpace_V1 } from '../witness/space/inner-space/inner-space-v1.mjs';
 import { createTimelineRootHelper, getTestKeystoneServiceHelper } from '../agent-helpers.mjs';
 import { mut8Timeline } from '../timeline/timeline-api.mjs';
-import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace-v1.mjs';
 import { DEFAULT_INNER_SPACE_DATA_V1 } from '../witness/space/inner-space/inner-space-types.mjs';
 import { toDto } from '../common/other/ibgib-helper.mjs';
+import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs';
 
 const logalot = true;
 const lc = `[sync-innerspace-partial-update.respec]`;
@@ -117,7 +117,13 @@ await respecfully(sir, `Sync InnerSpaces (Partial Update)`, async () => {
             receiverSpace: destSpace,
             receiverCoordinator: receiverCoordinator,
             receiverMetaspace: metaspace,
-        });
+            receiverTempSpace: 0 as any,
+            senderTempSpace: 0 as any,
+        },
+            {
+                classname: SyncPeerInnerspace_V1.name,
+            }
+        );
 
         // 4. Run Sync (Source Pushes V2)
         console.log(`${lc} Running Sync...`);

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

@@ -19,10 +19,10 @@ import { Metaspace_Innerspace } from '../witness/space/metaspace/metaspace-inner
 import { InnerSpace_V1 } from '../witness/space/inner-space/inner-space-v1.mjs';
 import { createTimelineRootHelper, getTestKeystoneServiceHelper } from '../agent-helpers.mjs';
 import { mut8Timeline, } from '../timeline/timeline-api.mjs';
-import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace-v1.mjs';
 import { DEFAULT_INNER_SPACE_DATA_V1 } from '../witness/space/inner-space/inner-space-types.mjs';
 import { toDto } from '../common/other/ibgib-helper.mjs';
 import { fnObs } from '../common/pubsub/observer/observer-helper.mjs';
+import { SyncPeerInnerspace_V1 } from './sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs';
 
 const logalot = true;
 const lc = `[sync-innerspace.respec]`;
@@ -108,6 +108,10 @@ await respecfully(sir, `Sync InnerSpaces`, async () => {
             receiverSpace: destSpace,   // "Server"
             receiverCoordinator: receiverCoordinator,
             receiverMetaspace: metaspace,
+            senderTempSpace: 0 as any,
+            receiverTempSpace: 0 as any,
+        }, {
+            classname: SyncPeerInnerspace_V1.name,
         });
 
         // 4. Run Sync

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

@@ -0,0 +1,8 @@
+/**
+ * @module sync peer innerspace constants
+ */
+
+/**
+ * Atom for the sync peer innerspace ibgib.
+ */
+export const SYNC_PEER_INNERSPACE_ATOM = 'sync_peer_innerspace';

package/src/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-helpers.mts

@@ -0,0 +1,72 @@
+/**
+ * @module sync peer innerspace helpers
+ */
+
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { Ib } from '@ibgib/ts-gib/dist/types.mjs';
+
+import { SYNC_PEER_INNERSPACE_ATOM } from './sync-peer-innerspace-constants.mjs';
+import { SyncPeerInnerspaceIb_V1, SyncPeerInnerspaceData_V1 } from './sync-peer-innerspace-types.mjs';
+
+/**
+ * Constructs the standard 'ib' string for a Sync Peer Innerspace stone.
+ */
+export async function getSyncPeerInnerspaceIb({
+    data,
+}: {
+    data: SyncPeerInnerspaceData_V1,
+}): Promise<Ib> {
+    const lc = `[${getSyncPeerInnerspaceIb.name}]`;
+    try {
+        if (!data) { throw new Error(`data required (E: 7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d)`); }
+
+        if (!data.classname) { throw new Error(`invalid data. data.classname required. (E: 3aad38bfe23866c2d8c1ca66b03d9126)`); }
+
+        // sync_peer_innerspace
+        const ib = [
+            SYNC_PEER_INNERSPACE_ATOM,
+            data.classname,
+        ].join(' ');
+
+        return ib;
+    } catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+}
+
+/**
+ * Parses a standard Sync Peer Innerspace 'ib' string.
+ */
+export async function parseSyncPeerInnerspaceIb({
+    ib,
+}: {
+    ib: Ib,
+}): Promise<SyncPeerInnerspaceIb_V1> {
+    const lc = `[${parseSyncPeerInnerspaceIb.name}]`;
+    try {
+        if (ib !== SYNC_PEER_INNERSPACE_ATOM) {
+            throw new Error(`Atom mismatch. Expected ${SYNC_PEER_INNERSPACE_ATOM}. Got ${ib}. (E: 8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e)`);
+        }
+
+        const pieces = ib.split(' ');
+
+        if (pieces.length !== 2) {
+            throw new Error(`invalid ib. expected 2 pieces: atom and classname (E: f9c0c8067368444bac69f5777eeaa826)`);
+        }
+
+        const [
+            atom,
+            classname
+        ] = pieces;
+
+        if (atom !== SYNC_PEER_INNERSPACE_ATOM) {
+            throw new Error(`invalid ib. atom (${atom}) is expected to be ${SYNC_PEER_INNERSPACE_ATOM} (E: fda078ef3a0853629eb22e48a01a8826)`);
+        }
+
+        return { atom, classname };
+    } catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+}