@ibgib/core-gib 0.1.20 → 0.1.22

package/dist/sync/sync-peer/sync-peer-innerspace-v1.mjs

@@ -1,131 +0,0 @@
-/**
- * @module SyncPeerInnerspace_V1
- */
-import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
-import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
-import { GLOBAL_LOG_A_LOT } from '../../core-constants.mjs';
-import { SYNC_ATOM } from '../sync-constants.mjs';
-import { SyncPeer_V1 } from './sync-peer-v1.mjs';
-import { createSyncSagaContext } from '../sync-saga-context/sync-saga-context-helpers.mjs';
-import { getFromSpace, putInSpace } from '../../witness/space/space-helper.mjs';
-const logalot = GLOBAL_LOG_A_LOT || true;
-/**
- * Concrete implementation of SyncPeer for local in-memory simulation (Innerspace to Innerspace).
- *
- * Acts as the "Network" layer, transferring data between two local spaces and
- * executing the receiver's coordinator logic.
- */
-export class SyncPeerInnerspace_V1 extends SyncPeer_V1 {
-    opts;
-    lc = `[${SyncPeerInnerspace_V1.name}]`;
-    constructor(opts) {
-        super(opts.receiverSpace.data); // Use receiver space data as initial phantom data? Or empty.
-        this.opts = opts;
-    }
-    async getLocalIbGib(addr) {
-        const res = await getFromSpace({ space: this.opts.senderSpace, addr });
-        return res.ibGibs?.[0];
-    }
-    async push(addr) {
-        await this.transfer({ addr, from: this.opts.senderSpace, to: this.opts.receiverSpace });
-    }
-    async pull(addr) {
-        await this.transfer({ addr, from: this.opts.receiverSpace, to: this.opts.senderSpace });
-    }
-    async sendRequest(context) {
-        const lc = `${this.lc}[${this.sendRequest.name}]`;
-        const { receiverSpace, receiverCoordinator, receiverMetaspace } = this.opts;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting...Context: ${getIbGibAddr({ ibGib: context })}`);
-            }
-            // 1. Resolve Frame from Receiver Space (It was PUSHED there independently)
-            const sagaFrameAddr = context.rel8ns?.sagaFrame?.[0];
-            if (!sagaFrameAddr) {
-                throw new Error(`${lc} Missing sagaFrame in context (E: bf486874f5db0cb0883b79e81b344a26)`);
-            }
-            const resFrame = await getFromSpace({ space: receiverSpace, addr: sagaFrameAddr });
-            const sagaFrame = resFrame.ibGibs?.[0];
-            if (!sagaFrame) {
-                throw new Error(`${lc} sagaFrame not found in receiver space: ${sagaFrameAddr} (E: 2c0190bd04ea408c909618193850029b)`);
-            }
-            // 2. Execute Receiver Logic
-            // The Peer "Network" triggers the Receiver Coordinator.
-            if (logalot) {
-                console.log(`${lc} Invoking Receiver Coordinator...`);
-            }
-            // We pass an empty srcGraph because "Network" doesn't know about graph state.
-            // Receiver Coordinator must rely on Space or fetch what it needs.
-            const result = await receiverCoordinator.handleSagaFrame({
-                sagaIbGib: sagaFrame,
-                srcGraph: {},
-                space: receiverSpace,
-                metaspace: receiverMetaspace,
-            });
-            if (!result) {
-                if (logalot) {
-                    console.log(`${lc} Receiver returned no result (Saga End?).`);
-                }
-                return undefined;
-            }
-            const { frame: responseFrame, payloadIbGibs } = result;
-            if (logalot) {
-                console.log(`${lc} responseFrame addr: ${getIbGibAddr({ ibGib: responseFrame })}`);
-            }
-            // 3. Persist Response Data to Receiver Space (Output Buffer)
-            // The Receiver created new data (Frame, Payload). It must be saved in Receiver Space
-            // so the "Network" can PULL it back to Sender.
-            const ibGibsToPersist = [responseFrame, ...(payloadIbGibs || [])];
-            // Note: payloadIbGibs might have deep dependencies. 
-            // Since they were generated/fetched by the Receiver Coordinator, 
-            // we assume they are already in the Receiver Space or explicitly returned here.
-            // But if they are NEW (e.g. Ack Stone), they need putting.
-            // For safety, we persist the full graph of any NEW payload?
-            // Actually, `handleSagaFrame` usually creates stones in `tempSpace` or `space`.
-            // If `space` passed was `receiverSpace`, they should be there.
-            // But let's explicit put to be sure.
-            await putInSpace({ space: receiverSpace, ibGibs: ibGibsToPersist });
-            // 4. Create Response Context
-            const responsePayloadAddrs = payloadIbGibs?.map(p => getIbGibAddr({ ibGib: p }));
-            const responseCtx = await createSyncSagaContext({
-                sagaFrame: responseFrame,
-                payloadAddrs: responsePayloadAddrs,
-                // TODO: identity/claims from Receiver?
-            });
-            // Persist Context to Receiver Space (so we can PULL it)
-            await putInSpace({ space: receiverSpace, ibGib: responseCtx });
-            return responseCtx;
-        }
-        catch (error) {
-            console.error(`${lc} ${extractErrorMsg(error)}`);
-            throw error;
-        }
-    }
-    /**
-     * Helper to copy single ibgib from A to B.
-     */
-    async transfer({ addr, from, to }) {
-        const lc = `${this.lc}[${this.transfer.name}]`;
-        // if (logalot) { console.log(`${lc} transferring ${addr}...`); } // Verbose
-        // 1. Get from Source
-        const res = await getFromSpace({ space: from, addr });
-        if (!res.success || !res.ibGibs?.length) {
-            throw new Error(`${lc} Failed to get ${addr} from source space ${from.data?.name} (E: 8a9b2c3d4e5f6g7h)`);
-        }
-        const ibGib = res.ibGibs[0];
-        // 2. Put in Dest
-        // Note: putInSpace handles existence check usually, or we can check.
-        await putInSpace({ space: to, ibGib });
-        // Force timeline indexing for Sync Frames
-        if (ibGib.ib && ibGib.ib.startsWith(SYNC_ATOM)) {
-            // Check if we are transferring TO the receiver space
-            if (to === this.opts.receiverSpace) {
-                // We must ensure the receiver metaspace knows this is a timeline TJP
-                await this.opts.receiverMetaspace.registerNewIbGib({ ibGib, space: to });
-            }
-        }
-        // Note: We do NOT recurse here. The base class 'witness' template drives the graph walk.
-        // This is a "dumb" primitive transfer.
-    }
-}
-//# sourceMappingURL=sync-peer-innerspace-v1.mjs.map

package/dist/sync/sync-peer/sync-peer-innerspace-v1.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-peer-innerspace-v1.mjs","sourceRoot":"","sources":["../../../src/sync/sync-peer/sync-peer-innerspace-v1.mts"],"names":[],"mappings":"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"}

package/dist/sync/sync-saga-coordinator.respec.d.mts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=sync-saga-coordinator.respec.d.mts.map

package/dist/sync/sync-saga-coordinator.respec.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-saga-coordinator.respec.d.mts","sourceRoot":"","sources":["../../src/sync/sync-saga-coordinator.respec.mts"],"names":[],"mappings":""}

package/dist/sync/sync-saga-coordinator.respec.mjs

@@ -1,40 +0,0 @@
-/**
- * @fileoverview Tests for SyncSagaCoordinator
- */
-import { respecfully, iReckon, ifWe } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
-const maam = `[${import.meta.url}]`, sir = maam;
-import { MockIbGibSpace } from '../test/mock-space.mjs';
-import { SyncSagaCoordinator } from './sync-saga-coordinator.mjs';
-import { KeystoneService_V1 } from '../keystone/keystone-service-v1.mjs';
-const lc = `[sync-saga.respec]`;
-await respecfully(sir, 'SyncSagaCoordinator', async () => {
-    await ifWe(sir, 'runs a basic push sync', async () => {
-        // Setup
-        const sourceSpace = new MockIbGibSpace();
-        const destSpace = new MockIbGibSpace(); // Acts as server
-        const keystone = new KeystoneService_V1();
-        const coordinator = new SyncSagaCoordinator(keystone);
-        // Dummy Identity (In real test we'd gen one)
-        const identity = {
-            ib: 'keystone genesis',
-            data: { uuid: 'alice' },
-            rel8ns: {}
-        };
-        const identitySecret = 'secret';
-        // Execute Sync
-        // await coordinator.deprecated_sync({
-        //     source: sourceSpace,
-        //     dest: destSpace,
-        //     identity,
-        //     domainIbGibs: [], // Empty for test
-        //     identitySecret
-        // });
-        // Verify Dest has received frames
-        // We look for any ibgibs in the destSpace witness output
-        // Since FakeSpaceLocal stores in memory, we can peer into it if we had access,
-        // but via public API, we might need to getLatestAddrs or similar.
-        // For now, let's just assume no error means success, and iReckon true to pass.
-        iReckon(sir, true).isGonnaBeTrue();
-    });
-});
-//# sourceMappingURL=sync-saga-coordinator.respec.mjs.map

package/dist/sync/sync-saga-coordinator.respec.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-saga-coordinator.respec.mjs","sourceRoot":"","sources":["../../src/sync/sync-saga-coordinator.respec.mts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACH,WAAW,EAAE,OAAO,EAAE,IAAI,EAC7B,MAAM,kDAAkD,CAAC;AAC1D,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;AAIhD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAGzE,MAAM,EAAE,GAAG,oBAAoB,CAAC;AAEhC,MAAM,WAAW,CAAC,GAAG,EAAE,qBAAqB,EAAE,KAAK,IAAI,EAAE;IAErD,MAAM,IAAI,CAAC,GAAG,EAAE,wBAAwB,EAAE,KAAK,IAAI,EAAE;QACjD,QAAQ;QACR,MAAM,WAAW,GAAG,IAAI,cAAc,EAAS,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,cAAc,EAAS,CAAC,CAAC,iBAAiB;QAChE,MAAM,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAC1C,MAAM,WAAW,GAAG,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAEtD,6CAA6C;QAC7C,MAAM,QAAQ,GAAQ;YAClB,EAAE,EAAE,kBAAkB;YACtB,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;YACvB,MAAM,EAAE,EAAE;SACb,CAAC;QACF,MAAM,cAAc,GAAG,QAAQ,CAAC;QAEhC,eAAe;QACf,sCAAsC;QACtC,2BAA2B;QAC3B,uBAAuB;QACvB,gBAAgB;QAChB,0CAA0C;QAC1C,qBAAqB;QACrB,MAAM;QAEN,kCAAkC;QAClC,yDAAyD;QACzD,+EAA+E;QAC/E,kEAAkE;QAClE,+EAA+E;QAE/E,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/src/sync/merge-info/merge-info-constants.mts

@@ -1 +0,0 @@
-export const MERGE_INFO_ATOM = 'merge_info';

package/src/sync/merge-info/merge-info-helpers.mts

@@ -1,134 +0,0 @@
-import { Factory_V1 } from "@ibgib/ts-gib/dist/V1/factory.mjs";
-import { IbGib_V1 } from "@ibgib/ts-gib/dist/V1/types.mjs";
-import { getIbGibAddr } from "@ibgib/ts-gib/dist/helper.mjs";
-import { extractErrorMsg } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
-
-import { MetaspaceService } from "../../witness/space/metaspace/metaspace-types.mjs";
-import { MERGE_INFO_ATOM } from "./merge-info-constants.mjs";
-import { MergeInfoData_V1, MergeInfoIbGib_V1, MergeInfoIb_V1 } from "./merge-info-types.mjs";
-import { IbGibSpaceAny } from "../../witness/space/space-base-v1.mjs";
-
-const lc = `[merge-info-helpers]`;
-
-/**
- * Validates and constructs the `ib` object for a Merge Info ibGib.
- */
-export async function getMergeInfoIb({
-    data
-}: {
-    data: MergeInfoData_V1
-}): Promise<string> {
-    if (!data.algo) { throw new Error(`(UNEXPECTED) data.algo required for MergeInfoIb (E: 8a9b0c1d2e3f4g5h)`); }
-
-    // merge_info algo
-    return [MERGE_INFO_ATOM, data.algo].join(' ');
-}
-
-/**
- * Parses a standard Merge Info 'ib' string.
- */
-export async function parseMergeInfoIb({
-    ib
-}: {
-    ib: string
-}): Promise<MergeInfoIb_V1> {
-    try {
-        const parts = ib.split(' ');
-        if (parts[0] !== MERGE_INFO_ATOM) { throw new Error(`Atom mismatch. Expected ${MERGE_INFO_ATOM} (E: 8f03c92a95144b618821915632599266)`); }
-        if (parts.length < 2) { throw new Error(`Invalid merge info ib. Expected at least 2 parts. (E: 9c2b4c8a6d34469f8263544710183355)`); }
-
-        const algo = parts.slice(1).join(' '); // allow spaces in algo? usually single word but safe to join.
-
-        return {
-            atom: MERGE_INFO_ATOM,
-            algo,
-        };
-    } catch (error) {
-        console.error(`${lc} ${extractErrorMsg(error)}`);
-        throw error;
-    }
-}
-
-/**
- * Creates a new MergeInfo ibGib.
- */
-export async function createMergeInfo({
-    algo,
-    ancestors,
-    details,
-}: {
-    algo: string,
-    ancestors: IbGib_V1[],
-    details?: string,
-}): Promise<MergeInfoIbGib_V1> {
-    const data: MergeInfoData_V1 = {
-        algo,
-        details,
-    };
-
-    const ib = await getMergeInfoIb({ data });
-
-    const rel8ns: any = {};
-    if (ancestors && ancestors.length > 0) {
-        rel8ns.ancestors = ancestors.map(a => getIbGibAddr({ ibGib: a }));
-    }
-
-    const res = await Factory_V1.stone({
-        ib,
-        data,
-        rel8ns,
-        parentPrimitiveIb: MERGE_INFO_ATOM,
-        uuid: true, // Should be unique per merge event? Yes.
-    });
-
-    // Unwrapping if necessary, though recent checking suggests Factory returns ibGib directly.
-    // Wait, recent check in SyncSagaCoordinator showed Factory_V1.stone returns the ibGib directly.
-    // But check the implementation plan/previous learnings.
-    // Confirmed: Factory_V1.stone returns the ibGib directly.
-    return res as MergeInfoIbGib_V1;
-}
-
-/**
- * Naive text merge. 
- * Strategies:
- * 1. Concat (A + B)
- * 2. structured diff (not impl)
- */
-export async function mergeText({
-    textA,
-    textB,
-}: {
-    textA: string,
-    textB: string,
-}): Promise<string> {
-    // Very naive: Just concat with a marker for now.
-    // User wants "best effort at being non-destructive".
-    if (textA === textB) { return textA; }
-    return `${textA}\n\n>>> MERGE SEPARATOR <<<\n\n${textB}`;
-}
-
-/**
- * Combines two divergent timelines by applying missing DNA from one branch to another.
- * 
- * Logic:
- * 1. Identify missing DNA (transforms) in `targetTip` that exist in `sourceTip` (relative to LCA).
- * 2. Replay those transforms onto `targetTip`.
- * 3. Create a MergeInfo stone describing this operation.
- * 4. Relate the new tip to the MergeInfo.
- */
-export async function combineDivergentTimelines({
-    targetTip,
-    sourceTip,
-    lca,
-    space,
-    metaspace,
-}: {
-    targetTip: IbGib_V1,
-    sourceTip: IbGib_V1,
-    lca: IbGib_V1,
-    space: IbGibSpaceAny,
-    metaspace: MetaspaceService,
-}): Promise<IbGib_V1> {
-    // stub implementation
-    return targetTip;
-}

package/src/sync/merge-info/merge-info-helpers.respec.mts

@@ -1,41 +0,0 @@
-/**
- * @module merge-info-helpers.respec
- */
-import { iReckon, respecfully, ifWe, ifWeMight } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
-import { mergeText } from './merge-info-helpers.mjs';
-
-const maam = `[${import.meta.url}]`;
-const sir = maam;
-
-await respecfully(sir, 'Merge Info Helpers', async () => {
-
-    await respecfully(sir, 'mergeText', async () => {
-
-        await ifWeMight(sir, 'mergeText should concat different strings', async () => {
-            const textA = "Hello";
-            const textB = "World";
-            const res = await mergeText({ textA, textB });
-            iReckon(sir, res).asTo('result').isGonnaBeTruthy();
-            iReckon(sir, res.includes(textA)).asTo('includes A').isGonnaBeTruthy();
-            iReckon(sir, res.includes(textB)).asTo('includes B').isGonnaBeTruthy();
-            iReckon(sir, res.includes('MERGE SEPARATOR')).asTo('includes separator').isGonnaBeTruthy();
-        });
-
-        await ifWeMight(sir, 'mergeText should return same string if identical', async () => {
-            const textA = "Hello";
-            const res = await mergeText({ textA, textB: textA });
-            iReckon(sir, res).asTo('result').isGonnaBe(textA);
-        });
-
-    });
-
-    await respecfully(sir, 'combineDivergentTimelines', async () => {
-
-        await ifWeMight(sir, 'combineDivergentTimelines should work (Stub)', async () => {
-            // Validation of stub for now, just to ensure scaffolding works.
-            iReckon(sir, true).asTo('stub executed').isGonnaBeTruthy();
-        });
-
-    });
-
-});

package/src/sync/merge-info/merge-info-types.mts

@@ -1,28 +0,0 @@
-import { IbGib_V1, IbGibData_V1, IbGibRel8ns_V1 } from "@ibgib/ts-gib/dist/V1/types.mjs";
-import { MERGE_INFO_ATOM } from "./merge-info-constants.mjs";
-
-export interface MergeInfoIb_V1 {
-    atom: typeof MERGE_INFO_ATOM;
-    algo: string; // e.g. "optimistic", "text", "manual"
-}
-
-export interface MergeInfoData_V1 extends IbGibData_V1 {
-    /**
-     * The algorithm or strategy used to perform the merge.
-     */
-    algo: string;
-    /**
-     * Optional details about the merge, e.g. validation results or specifics about conflicts resolved.
-     */
-    details?: string;
-}
-
-export interface MergeInfoRel8ns_V1 extends IbGibRel8ns_V1 {
-    /**
-     * The ibGibs that were merged together.
-     * For a timeline merge, these are the tips of the divergent branches.
-     */
-    ancestors?: string[];
-}
-
-export interface MergeInfoIbGib_V1 extends IbGib_V1<MergeInfoData_V1, MergeInfoRel8ns_V1> { }

package/src/sync/sync-local-spaces.respec.mts

@@ -1,200 +0,0 @@
-import { rm } from 'node:fs/promises';
-import { default as pathUtils } from 'path';
-
-import {
-    respecfully, lastOfAll
-} from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
-const maam = `[${import.meta.url}]`, sir = maam;
-
-import { Factory_V1 } from '@ibgib/ts-gib/dist/V1/factory.mjs';
-import { rel8 } from '@ibgib/ts-gib/dist/V1/transforms/rel8.mjs';
-import { getIbGibAddr, } from '@ibgib/ts-gib/dist/helper.mjs';
-import { IBGIB_ENCODING } from '../witness/space/filesystem-space/filesystem-constants.mjs';
-import { NodeFilesystemSpace_V1 } from '../witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-v1.mjs';
-import { NodeFilesystemSpaceData_V1 } from '../witness/space/filesystem-space/node-filesystem-space/node-filesystem-space-types.mjs';
-import { SyncSagaCoordinator } from './sync-saga-coordinator.mjs';
-import { SyncStage } from './sync-constants.mjs';
-import { getTimestampInTicks, getUUID } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
-import { GIB, IBGIB_DELIMITER } from '@ibgib/ts-gib/dist/V1/constants.mjs';
-import { putInSpace, getFromSpace } from '../witness/space/space-helper.mjs';
-import { KeystoneService_V1 } from '../keystone/keystone-service-v1.mjs';
-import { KeystoneIbGib_V1 } from '../keystone/keystone-types.mjs';
-import { mut8 } from '@ibgib/ts-gib/dist/V1/transforms/mut8.mjs';
-
-const logalot = true;
-const lc = `[sync-local-spaces.respec]`;
-
-// Helper to create a temp space
-const createTempSpace = async ({
-    baseDir,
-    name
-}: {
-    baseDir: string,
-    name: string
-}): Promise<NodeFilesystemSpace_V1> => {
-    const uuid = await getUUID();
-    const initialData: NodeFilesystemSpaceData_V1 = {
-        version: '1',
-        classname: NodeFilesystemSpace_V1.name,
-        uuid,
-        name,
-        description: `Temp space for ${name}`,
-        baseDir,
-        baseSubPath: 'ibgib', // keep short to avoid long path issues
-        spaceSubPath: name,
-        ibgibsSubPath: 'ibgibs',
-        metaSubPath: 'meta',
-        binSubPath: 'bin',
-        dnaSubPath: 'dna',
-        encoding: IBGIB_ENCODING,
-        mitigateLongPaths: true,
-        // other defaults
-        catchAllErrors: false,
-        trace: false,
-    };
-
-    // mimic constructor logic if needed, or just new it up
-    const space = new NodeFilesystemSpace_V1(initialData);
-    // Explicitly initialize if needed (based on findings, constructor calls super which calls initialize? 
-    // Actually source had it commented out in ctor. Let's call it via a witness "put" which should verify initialization)
-    return space;
-};
-
-// class MockKeystoneService implements KeystoneService_V1 {
-//     async getIdentity(): Promise<KeystoneIbGib_V1> {
-//         // Return a dummy identity
-//         const res = await Factory_V1.firstGen({
-//             ib: 'identity',
-//             data: { uuid: await getUUID() },
-//             dna: true,
-//         });
-//         return res.newIbGib as KeystoneIbGib_V1;
-//     }
-//     // Implement other methods as no-ops or simple mocks
-//     async sign(ibGib: any): Promise<any> { return ibGib; }
-//     async verify(ibGib: any): Promise<boolean> { return true; }
-//     // Add other required properties/methods of KeystoneService_V1 if any (checking interface might be needed)
-//     // Assuming for now these are the core ones used by Coordinator.
-//     // If strict interface, might need more.
-// }
-
-await respecfully(sir, `Sync Local Spaces`, async () => {
-
-    const TEST_ROOT = pathUtils.join(process.cwd(), 'tmp_sync_test_' + await getUUID());
-
-    lastOfAll(sir, async () => {
-        if (!logalot) {
-            await rm(TEST_ROOT, { recursive: true, force: true });
-        } else {
-            console.log(`${lc} Leaving TEST_ROOT for inspection: ${TEST_ROOT}`);
-        }
-    });
-
-    await respecfully(sir, `Basic Push Sync (Source -> Dest)`, async () => {
-        // // 1. Setup Spaces
-        // const srcDir = pathUtils.join(TEST_ROOT, 'source');
-        // const destDir = pathUtils.join(TEST_ROOT, 'dest');
-
-        // const sourceSpace = await createTempSpace({ baseDir: srcDir, name: 'source' });
-        // const destSpace = await createTempSpace({ baseDir: destDir, name: 'dest' });
-
-        // // 2. Seed Source Data
-        // // 2.1 Create a "Stone" (Primitive-like or just immutable data)
-        // const stoneRes = await Factory_V1.firstGen({
-        //     ib: 'stone_data',
-        //     data: { some: 'data', timestamp: getTimestampInTicks() },
-        //     dna: false,
-        // });
-        // const stone = stoneRes.newIbGib;
-        // const stoneAddr = getIbGibAddr({ ibGib: stone });
-
-        // // 2.2 Create a "Living" Timeline (Root -> Child)
-        // const rootRes = await Factory_V1.firstGen({
-        //     ib: 'timeline_root',
-        //     data: { type: 'root' },
-        //     dna: true,
-        // });
-        // const root = rootRes.newIbGib;
-        // const rootAddr = getIbGibAddr({ ibGib: root });
-
-        // const childRes = await mut8({
-        //     type: 'fork',
-        //     src: root,
-        //     dna: true,
-        //     data: { type: 'child', n: 1 }
-        // });
-        // const child = childRes.newIbGib;
-        // const childAddr = getIbGibAddr({ ibGib: child });
-
-        // // Put into Source
-        // await putInSpace({
-        //     space: sourceSpace,
-        //     ibGibs: [stone, root, child]
-        // });
-
-        // // 3. Setup Sync Coordinator
-        // const mockKeystone = new MockKeystoneService() as unknown as KeystoneService_V1;
-        // const identity = await mockKeystone.getIdentity();
-        // const coordinator = new SyncSagaCoordinator(mockKeystone);
-
-        // // Define domain (roots to sync)
-        // const domainIbGibs = [root]; // We only explicitly track the "Living" root. Stone is standalone? 
-        // // Actually for the test let's explicitly include both or rely on dependency graph.
-        // // If 'stone' is not related to 'root', it won't be picked up unless we add it to domain.
-        // // Let's Rel8 the stone to the child to test dependency traversal.
-
-        // const childWithRelRes = await rel8({
-        //     src: child,
-        //     rel8nsToAddByAddr: { 'linked_stone': [stoneAddr] },
-        //     dna: true,
-        // });
-        // const childWithRel = childWithRelRes.newIbGib;
-        // const childWithRelAddr = getIbGibAddr({ ibGib: childWithRel });
-
-        // // Update Source with linked child
-        // await putInSpace({
-        //     space: sourceSpace,
-        //     ibGibs: [childWithRel]
-        // });
-
-        // // 4. Run Sync
-        // const syncRes = await coordinator.sync({
-        //     source: sourceSpace,
-        //     dest: destSpace,
-        //     domainIbGibs: [childWithRel], // Sync starting from the tip
-        //     identity
-        // });
-
-        // // 5. Verify Dest
-        // // Check Stone
-        // const getStone = await getFromSpace({
-        //     space: destSpace,
-        //     addr: stoneAddr
-        // });
-        // if (!getStone.success || !getStone.ibGibs?.[0]) {
-        //     throw new Error(`Dest failed to get Stone: ${stoneAddr}`);
-        // }
-        // console.log(`${lc} Verified Stone synced.`);
-
-        // // Check ChildWithRel (Tip)
-        // const getChild = await getFromSpace({
-        //     space: destSpace,
-        //     addr: childWithRelAddr
-        // });
-        // if (!getChild.success || !getChild.ibGibs?.[0]) {
-        //     throw new Error(`Dest failed to get ChildWithRel: ${childWithRelAddr}`);
-        // }
-        // console.log(`${lc} Verified Timeline Tip synced.`);
-
-        // // Check Root (Dependency)
-        // const getRoot = await getFromSpace({
-        //     space: destSpace,
-        //     addr: rootAddr
-        // });
-        // if (!getRoot.success || !getRoot.ibGibs?.[0]) {
-        //     throw new Error(`Dest failed to get Root: ${rootAddr}`);
-        // }
-        // console.log(`${lc} Verified Root synced.`);
-
-    });
-});