@ibgib/core-gib 0.1.20 → 0.1.22

package/tmp.md

@@ -1,3 +1,62 @@
-Clarifying Merge Context
+Great! Ty for going through that! In crafting my response for you, I have since updated the libs\core-gib\src\sync\README.md file, so please re-read that file for me. There were several inaccuracies and it is much improved.
 
-I'm now integrating merge context into handleDeltaFrame. It's crucial that this function knows the history of conflicts. I'm focusing on deriving state from the sagaIbGib and arguments, as the coordinator is mostly stateless. I'm thinking of checking for conflicts in the Ack within the saga history. If conflicts existed, I can then check for available merge data. This will involve inspecting delta changes to determine merge necessity, and if required, triggering merge based on existing conflicts. I'll add the necessary type updates accordingly.
+Now for your questions. Let's get to them!
+
+## foundational
+
+1. I don't know if the conflict merging aspect is working well or not. I have implemented a similar optimistic strategy before in a previous sync prototype that worked well (though that implementation was very slow). This approach is the same, except two additions: a) naive text merge if the transform targets `data.text`, and b) adding "graft info" (libs\core-gib\src\sync\graft-info) to the timeline after the merge so that original divergent states aren't lost. Both of these should be straightforward though. The main problem right now is trying to isolate the various stages of the "ping-pong" exchange.
+
+2. Tjp is fully implemented and has been for several years now. Including the tjpGib in the full address, instead of just using a bare hash, has proved immensely useful (and as you know, this is completely novel/innovative as there is no other protocol that does this).
+
+3. We originally had control and domain payloads grouped together and we had to separate them. However, this was done poorly by the original agent, and may yet still be incomplete. AFAICT though, the most recent attempt at completing the separation was successful. The current blocking issue is that it's hard to tell what is causing the test in sync-conflict.respec.mts to fail. The logging gets too verbose and is hard to track throughout the entire transaction. 
+
+4. We are deferring integrating the session keystones until we get the non-keystone workflow going.
+
+## current state
+
+5. The immediate symptom is the test in `sync-conflict.respect.mts` is failing. You can see the output of the most recent run in C:\Users\billm\antigravity\ibgib\libs\core-gib\test_output.log .  But it is a coarse test, and really, it's hard to even read the test itself. But it's also hard to try to create more granular unit tests, though that may be the right path forward.
+
+6. AFAICT the v16 implementation plan has been partially implemented. For example, `handleAckFrame` in `saga-coordinator.mts` still has not had the `payloadIbGibs` separated properly, i.e., there is still a variable called `payloadIbGibs`, despite us mandating that there should be NO references to this. Every instance of that string should be separated into control and domain payload ibgibs. It's actually looking like that `handleAckFrame` is not right anymore, though the libs\core-gib\src\sync\sync-innerspace-dest-ahead.respec.mts test is still passing so it's not completely wrong. But if you read through that method, you'll see it's not right and there is a not-implemented error line in there.
+
+The same is true for `payloadAddrs`, which should NOT exist anywhere. But it still is on `SyncDeltaData`. It should not be "deprecated", it should have been removed and references to it should have led us to more places to complete the separation of control and domain addrs.
+
+7. I think part of the problem is that our implementation plans have been too complex and we didn't follow through to ensure that each and every piece was taken care of. Perhaps a todo/checklist would be more appropriate. But I devote quite a bit of time to refine the implementation plan, and then the nuances get lost. So we have a bunch of messy, half-completed code. Granted, this is a relatively complex sync algorithm, but it should absolutely be feasible.
+
+But let me speak to your specific questions on this:
+
+* Too many iterations/refactorings without clear direction?
+  * I don't mind the iterations. I mind thinking that something is complete and it is not. This is partially my fault in not breaking it down and unit testing it more granularly, but that would add a huge amount of overhead, and what inevitably happens is we troubleshoot the tests and not the code.
+* Type boundaries bleeding between concerns?
+  * Our types are pretty well created by this point. 
+* The polling mechanism feeling hacky?
+  * No, the polling mechanism is fine.
+* Race conditions or timing issues?
+  * There have been no race conditions that I know of.
+
+I had previous success with Antigravity on other smaller tasks, but this one seems to have been a little too advanced for the Gemini 3 High model. Your model seems to be performing better, however we hit the smaller context window rather quickly. Overall, I am just trying not to have to go through every single LoC myself, though it's looking like that is more and more likely.
+
+Here is another example I've come across that is messy. Look at the following code found in `sync-saga-coordinator.mts`:
+
+```
+// 4. EXECUTE SAGA LOOP (FSM)
+// Inject tempSpace into peer so it can pull control payloads to the right place
+if ('opts' in peer && peer.opts) {
+    (peer.opts as any).senderTempSpace = tempSpace;
+}
+```
+
+This is terrible! This is a hack so that if we have a `SyncPeerInnerspace_V1`, we set its temp space. This is "messy" to say the least.
+
+### sync test results
+
+* libs\core-gib\src\sync\sync-innerspace.respec.mts PASSING
+* libs\core-gib\src\sync\sync-innerspace-constants.respec.mts PASSING
+* libs\core-gib\src\sync\sync-innerspace-dest-ahead.respec.mts PASSING
+* libs\core-gib\src\sync\sync-innerspace-deep-updates.respec.mts PASSING
+* libs\core-gib\src\sync\sync-innerspace-multiple-timelines.respec.mts PASSING
+* libs\core-gib\src\sync\sync-innerspace-partial-update.respec.mts PASSING
+* libs\core-gib\src\sync\sync-conflict.respec.mts FAILING
+
+## how you can help
+
+All of the simpler tests that don't require a Delta frame back and forth (short back-and-forth to resolve the conflict) are all passing. I _think_ that the merge logic itself is fine, though I haven't gone through that with a fine-tooth comb yet. To me, the most obvious problem right now is that the mechanism for passing domain ibgibs back and forth is not working. For example, look in libs\core-gib\src\sync\sync-saga-coordinator.mts for `srcGraph`. That was added early on in the code sketch. IIRC, it was supposed to be for the domain ibgibs in the original sender's location. Is that another name for payloadIbGibs, but stored in a map? How does it get populated? How do the payload ibgibs go from the peer to the handle____ methods? So don't do any coding right now. Perhaps this whole conversation will just be you and I talking about the code as I go through it. So just point me to things that you see and I will make changes, because I need to wrap this up in the next 3 days. Do note that I have made some changes since starting this message to you, and it doesn't build at the moment. But overall there are still things that you can just point me to if you just examine the logic.

package/dist/sync/merge-info/merge-info-constants.d.mts

@@ -1,2 +0,0 @@
-export declare const MERGE_INFO_ATOM = "merge_info";
-//# sourceMappingURL=merge-info-constants.d.mts.map

package/dist/sync/merge-info/merge-info-constants.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"merge-info-constants.d.mts","sourceRoot":"","sources":["../../../src/sync/merge-info/merge-info-constants.mts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,eAAe,CAAC"}

package/dist/sync/merge-info/merge-info-constants.mjs

@@ -1,2 +0,0 @@
-export const MERGE_INFO_ATOM = 'merge_info';
-//# sourceMappingURL=merge-info-constants.mjs.map

package/dist/sync/merge-info/merge-info-constants.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"merge-info-constants.mjs","sourceRoot":"","sources":["../../../src/sync/merge-info/merge-info-constants.mts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC"}

package/dist/sync/merge-info/merge-info-helpers.d.mts

@@ -1,51 +0,0 @@
-import { IbGib_V1 } from "@ibgib/ts-gib/dist/V1/types.mjs";
-import { MetaspaceService } from "../../witness/space/metaspace/metaspace-types.mjs";
-import { MergeInfoData_V1, MergeInfoIbGib_V1, MergeInfoIb_V1 } from "./merge-info-types.mjs";
-import { IbGibSpaceAny } from "../../witness/space/space-base-v1.mjs";
-/**
- * Validates and constructs the `ib` object for a Merge Info ibGib.
- */
-export declare function getMergeInfoIb({ data }: {
-    data: MergeInfoData_V1;
-}): Promise<string>;
-/**
- * Parses a standard Merge Info 'ib' string.
- */
-export declare function parseMergeInfoIb({ ib }: {
-    ib: string;
-}): Promise<MergeInfoIb_V1>;
-/**
- * Creates a new MergeInfo ibGib.
- */
-export declare function createMergeInfo({ algo, ancestors, details, }: {
-    algo: string;
-    ancestors: IbGib_V1[];
-    details?: string;
-}): Promise<MergeInfoIbGib_V1>;
-/**
- * Naive text merge.
- * Strategies:
- * 1. Concat (A + B)
- * 2. structured diff (not impl)
- */
-export declare function mergeText({ textA, textB, }: {
-    textA: string;
-    textB: string;
-}): Promise<string>;
-/**
- * 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 declare function combineDivergentTimelines({ targetTip, sourceTip, lca, space, metaspace, }: {
-    targetTip: IbGib_V1;
-    sourceTip: IbGib_V1;
-    lca: IbGib_V1;
-    space: IbGibSpaceAny;
-    metaspace: MetaspaceService;
-}): Promise<IbGib_V1>;
-//# sourceMappingURL=merge-info-helpers.d.mts.map

package/dist/sync/merge-info/merge-info-helpers.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"merge-info-helpers.d.mts","sourceRoot":"","sources":["../../../src/sync/merge-info/merge-info-helpers.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAI3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AAErF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAItE;;GAEG;AACH,wBAAsB,cAAc,CAAC,EACjC,IAAI,EACP,EAAE;IACC,IAAI,EAAE,gBAAgB,CAAA;CACzB,GAAG,OAAO,CAAC,MAAM,CAAC,CAKlB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,EACnC,EAAE,EACL,EAAE;IACC,EAAE,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAAC,cAAc,CAAC,CAgB1B;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,EAClC,IAAI,EACJ,SAAS,EACT,OAAO,GACV,EAAE;IACC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0B7B;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,EAC5B,KAAK,EACL,KAAK,GACR,EAAE;IACC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAKlB;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAAC,EAC5C,SAAS,EACT,SAAS,EACT,GAAG,EACH,KAAK,EACL,SAAS,GACZ,EAAE;IACC,SAAS,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,QAAQ,CAAC;IACpB,GAAG,EAAE,QAAQ,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,gBAAgB,CAAC;CAC/B,GAAG,OAAO,CAAC,QAAQ,CAAC,CAGpB"}

package/dist/sync/merge-info/merge-info-helpers.mjs

@@ -1,92 +0,0 @@
-import { Factory_V1 } from "@ibgib/ts-gib/dist/V1/factory.mjs";
-import { getIbGibAddr } from "@ibgib/ts-gib/dist/helper.mjs";
-import { extractErrorMsg } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
-import { MERGE_INFO_ATOM } from "./merge-info-constants.mjs";
-const lc = `[merge-info-helpers]`;
-/**
- * Validates and constructs the `ib` object for a Merge Info ibGib.
- */
-export async function getMergeInfoIb({ data }) {
-    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 }) {
-    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, }) {
-    const data = {
-        algo,
-        details,
-    };
-    const ib = await getMergeInfoIb({ data });
-    const rel8ns = {};
-    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;
-}
-/**
- * Naive text merge.
- * Strategies:
- * 1. Concat (A + B)
- * 2. structured diff (not impl)
- */
-export async function mergeText({ textA, textB, }) {
-    // 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, }) {
-    // stub implementation
-    return targetTip;
-}
-//# sourceMappingURL=merge-info-helpers.mjs.map

package/dist/sync/merge-info/merge-info-helpers.mjs.map

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

package/dist/sync/merge-info/merge-info-helpers.respec.d.mts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=merge-info-helpers.respec.d.mts.map

package/dist/sync/merge-info/merge-info-helpers.respec.d.mts.map

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

package/dist/sync/merge-info/merge-info-helpers.respec.mjs

@@ -1,32 +0,0 @@
-/**
- * @module merge-info-helpers.respec
- */
-import { iReckon, respecfully, 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();
-        });
-    });
-});
-//# sourceMappingURL=merge-info-helpers.respec.mjs.map

package/dist/sync/merge-info/merge-info-helpers.respec.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"merge-info-helpers.respec.mjs","sourceRoot":"","sources":["../../../src/sync/merge-info/merge-info-helpers.respec.mts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAQ,SAAS,EAAE,MAAM,kDAAkD,CAAC;AACzG,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;AACpC,MAAM,GAAG,GAAG,IAAI,CAAC;AAEjB,MAAM,WAAW,CAAC,GAAG,EAAE,oBAAoB,EAAE,KAAK,IAAI,EAAE;IAEpD,MAAM,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE;QAE3C,MAAM,SAAS,CAAC,GAAG,EAAE,2CAA2C,EAAE,KAAK,IAAI,EAAE;YACzE,MAAM,KAAK,GAAG,OAAO,CAAC;YACtB,MAAM,KAAK,GAAG,OAAO,CAAC;YACtB,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,eAAe,EAAE,CAAC;YACnD,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,eAAe,EAAE,CAAC;YACvE,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,eAAe,EAAE,CAAC;YACvE,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,eAAe,EAAE,CAAC;QAC/F,CAAC,CAAC,CAAC;QAEH,MAAM,SAAS,CAAC,GAAG,EAAE,kDAAkD,EAAE,KAAK,IAAI,EAAE;YAChF,MAAM,KAAK,GAAG,OAAO,CAAC;YACtB,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACrD,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IAEP,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,CAAC,GAAG,EAAE,2BAA2B,EAAE,KAAK,IAAI,EAAE;QAE3D,MAAM,SAAS,CAAC,GAAG,EAAE,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC5E,gEAAgE;YAChE,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,eAAe,EAAE,CAAC;QAC/D,CAAC,CAAC,CAAC;IAEP,CAAC,CAAC,CAAC;AAEP,CAAC,CAAC,CAAC"}

package/dist/sync/merge-info/merge-info-types.d.mts

@@ -1,26 +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;
-}
-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> {
-}
-//# sourceMappingURL=merge-info-types.d.mts.map

package/dist/sync/merge-info/merge-info-types.mjs

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=merge-info-types.mjs.map

package/dist/sync/merge-info/merge-info-types.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"merge-info-types.mjs","sourceRoot":"","sources":["../../../src/sync/merge-info/merge-info-types.mts"],"names":[],"mappings":""}

package/dist/sync/sync-local-spaces.respec.d.mts

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

package/dist/sync/sync-local-spaces.respec.d.mts.map

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

package/dist/sync/sync-local-spaces.respec.mjs

@@ -1,159 +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 { 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 { getUUID } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
-const logalot = true;
-const lc = `[sync-local-spaces.respec]`;
-// Helper to create a temp space
-const createTempSpace = async ({ baseDir, name }) => {
-    const uuid = await getUUID();
-    const initialData = {
-        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.`);
-    });
-});
-//# sourceMappingURL=sync-local-spaces.respec.mjs.map

package/dist/sync/sync-local-spaces.respec.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-local-spaces.respec.mjs","sourceRoot":"","sources":["../../src/sync/sync-local-spaces.respec.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAE5C,OAAO,EACH,WAAW,EAAE,SAAS,EACzB,MAAM,kDAAkD,CAAC;AAC1D,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;AAKhD,OAAO,EAAE,cAAc,EAAE,MAAM,4DAA4D,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,MAAM,sFAAsF,CAAC;AAI9H,OAAO,EAAuB,OAAO,EAAE,MAAM,iDAAiD,CAAC;AAO/F,MAAM,OAAO,GAAG,IAAI,CAAC;AACrB,MAAM,EAAE,GAAG,4BAA4B,CAAC;AAExC,gCAAgC;AAChC,MAAM,eAAe,GAAG,KAAK,EAAE,EAC3B,OAAO,EACP,IAAI,EAIP,EAAmC,EAAE;IAClC,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;IAC7B,MAAM,WAAW,GAA+B;QAC5C,OAAO,EAAE,GAAG;QACZ,SAAS,EAAE,sBAAsB,CAAC,IAAI;QACtC,IAAI;QACJ,IAAI;QACJ,WAAW,EAAE,kBAAkB,IAAI,EAAE;QACrC,OAAO;QACP,WAAW,EAAE,OAAO,EAAE,uCAAuC;QAC7D,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,QAAQ;QACvB,WAAW,EAAE,MAAM;QACnB,UAAU,EAAE,KAAK;QACjB,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,cAAc;QACxB,iBAAiB,EAAE,IAAI;QACvB,iBAAiB;QACjB,cAAc,EAAE,KAAK;QACrB,KAAK,EAAE,KAAK;KACf,CAAC;IAEF,uDAAuD;IACvD,MAAM,KAAK,GAAG,IAAI,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACtD,uGAAuG;IACvG,sHAAsH;IACtH,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,4DAA4D;AAC5D,uDAAuD;AACvD,qCAAqC;AACrC,kDAAkD;AAClD,8BAA8B;AAC9B,+CAA+C;AAC/C,yBAAyB;AACzB,cAAc;AACd,mDAAmD;AACnD,QAAQ;AACR,2DAA2D;AAC3D,6DAA6D;AAC7D,kEAAkE;AAClE,iHAAiH;AACjH,uEAAuE;AACvE,+CAA+C;AAC/C,IAAI;AAEJ,MAAM,WAAW,CAAC,GAAG,EAAE,mBAAmB,EAAE,KAAK,IAAI,EAAE;IAEnD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,GAAG,MAAM,OAAO,EAAE,CAAC,CAAC;IAEpF,SAAS,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE;QACtB,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,sCAAsC,SAAS,EAAE,CAAC,CAAC;QACxE,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,CAAC,GAAG,EAAE,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAClE,qBAAqB;QACrB,sDAAsD;QACtD,qDAAqD;QAErD,kFAAkF;QAClF,+EAA+E;QAE/E,yBAAyB;QACzB,kEAAkE;QAClE,+CAA+C;QAC/C,wBAAwB;QACxB,gEAAgE;QAChE,kBAAkB;QAClB,MAAM;QACN,mCAAmC;QACnC,oDAAoD;QAEpD,oDAAoD;QACpD,8CAA8C;QAC9C,2BAA2B;QAC3B,8BAA8B;QAC9B,iBAAiB;QACjB,MAAM;QACN,iCAAiC;QACjC,kDAAkD;QAElD,gCAAgC;QAChC,oBAAoB;QACpB,iBAAiB;QACjB,iBAAiB;QACjB,oCAAoC;QACpC,MAAM;QACN,mCAAmC;QACnC,oDAAoD;QAEpD,qBAAqB;QACrB,qBAAqB;QACrB,0BAA0B;QAC1B,mCAAmC;QACnC,MAAM;QAEN,+BAA+B;QAC/B,mFAAmF;QACnF,qDAAqD;QACrD,6DAA6D;QAE7D,mCAAmC;QACnC,oGAAoG;QACpG,sFAAsF;QACtF,4FAA4F;QAC5F,qEAAqE;QAErE,uCAAuC;QACvC,kBAAkB;QAClB,0DAA0D;QAC1D,iBAAiB;QACjB,MAAM;QACN,iDAAiD;QACjD,kEAAkE;QAElE,qCAAqC;QACrC,qBAAqB;QACrB,0BAA0B;QAC1B,6BAA6B;QAC7B,MAAM;QAEN,iBAAiB;QACjB,2CAA2C;QAC3C,2BAA2B;QAC3B,uBAAuB;QACvB,kEAAkE;QAClE,eAAe;QACf,MAAM;QAEN,oBAAoB;QACpB,iBAAiB;QACjB,wCAAwC;QACxC,wBAAwB;QACxB,sBAAsB;QACtB,MAAM;QACN,oDAAoD;QACpD,iEAAiE;QACjE,IAAI;QACJ,+CAA+C;QAE/C,8BAA8B;QAC9B,wCAAwC;QACxC,wBAAwB;QACxB,6BAA6B;QAC7B,MAAM;QACN,oDAAoD;QACpD,+EAA+E;QAC/E,IAAI;QACJ,sDAAsD;QAEtD,6BAA6B;QAC7B,uCAAuC;QACvC,wBAAwB;QACxB,qBAAqB;QACrB,MAAM;QACN,kDAAkD;QAClD,+DAA+D;QAC/D,IAAI;QACJ,8CAA8C;IAElD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/sync/sync-peer/sync-peer-innerspace-v1.d.mts

@@ -1,39 +0,0 @@
-/**
- * @module SyncPeerInnerspace_V1
- */
-import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
-import { IbGibSpaceAny } from '../../witness/space/space-base-v1.mjs';
-import { SyncSagaContextIbGib_V1 } from '../sync-saga-context/sync-saga-context-types.mjs';
-import { SyncPeer_V1 } from './sync-peer-v1.mjs';
-import { SyncSagaCoordinator } from '../sync-saga-coordinator.mjs';
-import { MetaspaceService } from '../../witness/space/metaspace/metaspace-types.mjs';
-export interface SyncPeerInnerspaceOptions {
-    senderSpace: IbGibSpaceAny;
-    receiverSpace: IbGibSpaceAny;
-    receiverCoordinator: SyncSagaCoordinator;
-    receiverMetaspace: MetaspaceService;
-}
-/**
- * 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 declare class SyncPeerInnerspace_V1 extends SyncPeer_V1 {
-    opts: SyncPeerInnerspaceOptions;
-    protected lc: string;
-    constructor(opts: SyncPeerInnerspaceOptions);
-    protected getLocalIbGib(addr: string): Promise<IbGib_V1 | undefined>;
-    protected push(addr: string): Promise<void>;
-    protected pull(addr: string): Promise<void>;
-    protected sendRequest(context: SyncSagaContextIbGib_V1): Promise<SyncSagaContextIbGib_V1 | undefined>;
-    /**
-     * Helper to copy single ibgib from A to B.
-     */
-    protected transfer({ addr, from, to }: {
-        addr: string;
-        from: IbGibSpaceAny;
-        to: IbGibSpaceAny;
-    }): Promise<void>;
-}
-//# sourceMappingURL=sync-peer-innerspace-v1.d.mts.map

package/dist/sync/sync-peer/sync-peer-innerspace-v1.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-peer-innerspace-v1.d.mts","sourceRoot":"","sources":["../../../src/sync/sync-peer/sync-peer-innerspace-v1.mts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAK3D,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kDAAkD,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAGnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AAErF,MAAM,WAAW,yBAAyB;IACtC,WAAW,EAAE,aAAa,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,iBAAiB,EAAE,gBAAgB,CAAC;CACvC;AAID;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,WAAW;IAKvC,IAAI,EAAE,yBAAyB;IAH1C,SAAS,CAAC,EAAE,EAAE,MAAM,CAAqC;gBAG9C,IAAI,EAAE,yBAAyB;cAK1B,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;cAK1D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cAIjC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cAIjC,WAAW,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAwE3G;;OAEG;cACa,QAAQ,CAAC,EACrB,IAAI,EACJ,IAAI,EACJ,EAAE,EACL,EAAE;QACC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,aAAa,CAAC;QACpB,EAAE,EAAE,aAAa,CAAA;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC;CA2BpB"}