@ibgib/vcs-gib 0.0.6 → 0.0.18

package/dist/engine/branch/branch-graph-helper.mjs

@@ -1,40 +1,72 @@
 /**
  * @module branch-graph-helper
  *
- * Helper for extracting dependency graphs and populating branch spaces.
+ * Helper for populating branch spaces via SyncSagaCoordinator.
  */
-import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
-import { getDependencyGraph } from '@ibgib/core-gib/dist/common/other/graph-helper.mjs';
-import { putInSpace } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
+import { clone, extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { SyncSagaCoordinator } from '@ibgib/core-gib/dist/sync/sync-saga-coordinator.mjs';
+import { SyncPeerInnerspace_V1 } from '@ibgib/core-gib/dist/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-v1.mjs';
+import { SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1 } from '@ibgib/core-gib/dist/sync/sync-peer/sync-peer-innerspace/sync-peer-innerspace-constants.mjs';
 import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
+import { createB2tFSBranchIbGib } from './branch-helper.mjs';
 const lcFile = `[branch-graph-helper]`;
 const logalot = GLOBAL_LOG_A_LOT;
 /**
- * Extracts the live dependency graph of rootItemIbGib from sourceSpace and persists all ibgibs into targetBranchSpace.
+ * Executes SSM (Space - Sync - Metadata) for branch space initialization:
+ * 1. Space: Target branch space targetBranchSpace (b2s_<branchName>).
+ * 2. Sync: Syncs rootItemIbGib from sourceSpace -> targetBranchSpace using SyncSagaCoordinator.
+ * 3. Metadata: Creates B2tFSBranchIbGib_V1 metadata node in targetBranchSpace pointing to rootItem.
  */
-export async function populateBranchSpaceFromGraph({ sourceSpace, targetBranchSpace, rootItemIbGib, metaspace, }) {
+export async function populateBranchSpaceFromGraph({ sourceSpace, targetBranchSpace, rootItemIbGib, branchName, metaspace, }) {
     const lc = `${lcFile}[${populateBranchSpaceFromGraph.name}]`;
     try {
         if (logalot) {
             console.log(`${lc} starting... (I: 1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d)`);
         }
-        if (!sourceSpace || !targetBranchSpace || !rootItemIbGib) {
-            throw new Error(`sourceSpace, targetBranchSpace, and rootItemIbGib are required (E: 2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e)`);
+        if (!sourceSpace || !targetBranchSpace || !rootItemIbGib || !metaspace) {
+            throw new Error(`sourceSpace, targetBranchSpace, rootItemIbGib, and metaspace are required (E: 2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e)`);
         }
-        const graph = await getDependencyGraph({
-            ibGib: rootItemIbGib,
-            space: sourceSpace,
-            live: true,
+        // 1. Space: targetBranchSpace provided/instantiated
+        // 2. Sync: Execute SyncSagaCoordinator space-to-space sync (sourceSpace -> targetBranchSpace)
+        const senderCoordinator = new SyncSagaCoordinator();
+        const receiverCoordinator = new SyncSagaCoordinator();
+        const peer = new SyncPeerInnerspace_V1(clone(SYNC_PEER_INNERSPACE_DEFAULT_DATA_V1));
+        await peer.initialized;
+        await peer.initializeOpts({
+            localMetaspace: metaspace,
+            localSpace: sourceSpace,
+            receiverSpace: targetBranchSpace,
+            receiverCoordinator,
+            receiverMetaspace: metaspace,
         });
-        for (const [addr, ibGib] of Object.entries(graph)) {
-            await putInSpace({ space: targetBranchSpace, ibGib });
-            if (metaspace) {
-                await metaspace.registerNewIbGib({ ibGib, space: targetBranchSpace });
-            }
+        const resSync = await senderCoordinator.sync({
+            peer,
+            localSpace: sourceSpace,
+            metaspace,
+            domainIbGibs: [rootItemIbGib],
+        });
+        await resSync.done;
+        if (logalot) {
+            console.log(`${lc} SyncSagaCoordinator sync initiated for ${rootItemIbGib.ib} (I: 3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f)`);
+        }
+        const syncedCount = 1;
+        // 3. Metadata: Create B2tFSBranchIbGib_V1 metadata node in targetBranchSpace pointing to rootItem
+        let branchIbGib;
+        if (branchName && metaspace) {
+            branchIbGib = await createB2tFSBranchIbGib({
+                branchName,
+                rootItem: rootItemIbGib,
+                space: targetBranchSpace,
+                metaspace,
+            });
         }
         if (logalot) {
-            console.log(`${lc} Populated target branch space with ${Object.keys(graph).length} ibgibs (I: 3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f)`);
+            console.log(`${lc} Populated target branch space via SyncSagaCoordinator (I: 4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f)`);
         }
+        return {
+            syncedCount,
+            branchIbGib,
+        };
     }
     catch (error) {
         console.error(`${lc} ${extractErrorMsg(error)} (E: 4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a)`);

package/dist/engine/branch/branch-graph-helper.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"branch-graph-helper.mjs","sourceRoot":"","sources":["../../../src/engine/branch/branch-graph-helper.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAElF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAExF,OAAO,EAAE,UAAU,EAAE,MAAM,qDAAqD,CAAC;AAGjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,MAAM,GAAG,uBAAuB,CAAC;AACvC,MAAM,OAAO,GAAG,gBAAgB,CAAC;AASjC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,EAC/C,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,SAAS,GACsB;IAC/B,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,4BAA4B,CAAC,IAAI,GAAG,CAAC;IAC7D,IAAI,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,oDAAoD,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,CAAC,WAAW,IAAI,CAAC,iBAAiB,IAAI,CAAC,aAAa,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,sGAAsG,CAAC,CAAC;QAC5H,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC;YACnC,KAAK,EAAE,aAAa;YACpB,KAAK,EAAE,WAAW;YAClB,IAAI,EAAE,IAAI;SACb,CAAC,CAAC;QAEH,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,MAAM,UAAU,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC;YACtD,IAAI,SAAS,EAAE,CAAC;gBACZ,MAAM,SAAS,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;YAC1E,CAAC;QACL,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,uCAAuC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,+CAA+C,CAAC,CAAC;QACtI,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,eAAe,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACvF,MAAM,KAAK,CAAC;IAChB,CAAC;YAAS,CAAC;QACP,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,kDAAkD,CAAC,CAAC;QACzE,CAAC;IACL,CAAC;AACL,CAAC"}
+{"version":3,"file":"branch-graph-helper.mjs","sourceRoot":"","sources":["../../../src/engine/branch/branch-graph-helper.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAIzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,sFAAsF,CAAC;AAC7H,OAAO,EAAE,oCAAoC,EAAE,MAAM,6FAA6F,CAAC;AAEnJ,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,MAAM,GAAG,uBAAuB,CAAC;AACvC,MAAM,OAAO,GAAG,gBAAgB,CAAC;AAejC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,EAC/C,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,SAAS,GACsB;IAC/B,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,4BAA4B,CAAC,IAAI,GAAG,CAAC;IAC7D,IAAI,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,oDAAoD,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,CAAC,WAAW,IAAI,CAAC,iBAAiB,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,iHAAiH,CAAC,CAAC;QACvI,CAAC;QAED,oDAAoD;QAEpD,8FAA8F;QAC9F,MAAM,iBAAiB,GAAG,IAAI,mBAAmB,EAAE,CAAC;QACpD,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAC;QAEtD,MAAM,IAAI,GAAG,IAAI,qBAAqB,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAC;QACpF,MAAM,IAAI,CAAC,WAAW,CAAC;QACvB,MAAM,IAAI,CAAC,cAAc,CAAC;YACtB,cAAc,EAAE,SAAS;YACzB,UAAU,EAAE,WAAW;YACvB,aAAa,EAAE,iBAAiB;YAChC,mBAAmB;YACnB,iBAAiB,EAAE,SAAS;SAC/B,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC;YACzC,IAAI;YACJ,UAAU,EAAE,WAAW;YACvB,SAAS;YACT,YAAY,EAAE,CAAC,aAAa,CAAC;SAChC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,IAAI,CAAC;QAEnB,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,2CAA2C,aAAa,CAAC,EAAE,wCAAwC,CAAC,CAAC;QAC1H,CAAC;QAED,MAAM,WAAW,GAAG,CAAC,CAAC;QAEtB,kGAAkG;QAClG,IAAI,WAA4C,CAAC;QACjD,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;YAC1B,WAAW,GAAG,MAAM,sBAAsB,CAAC;gBACvC,UAAU;gBACV,QAAQ,EAAE,aAAoB;gBAC9B,KAAK,EAAE,iBAAiB;gBACxB,SAAS;aACZ,CAAC,CAAC;QACP,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,8FAA8F,CAAC,CAAC;QACrH,CAAC;QAED,OAAO;YACH,WAAW;YACX,WAAW;SACd,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,eAAe,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACvF,MAAM,KAAK,CAAC;IAChB,CAAC;YAAS,CAAC;QACP,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,kDAAkD,CAAC,CAAC;QACzE,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/engine/branch/branch-space-helper.d.mts

@@ -5,6 +5,7 @@
  */
 import { Metaspace_Nodespace } from '@ibgib/node-gib/dist/witness/space/metaspace/metaspace-nodespace/metaspace-nodespace.mjs';
 import { NodeFilesystemSpace_V1 } from '@ibgib/node-gib/dist/witness/space/node-filesystem-space/node-filesystem-space-v1.mjs';
+export { populateBranchSpaceFromGraph, PopulateBranchSpaceFromGraphOpts, PopulateBranchSpaceFromGraphResult, } from './branch-graph-helper.mjs';
 export interface GetOrCreateBranchSpaceOpts {
     metaspace: Metaspace_Nodespace;
     vcsPath: string;

package/dist/engine/branch/branch-space-helper.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"branch-space-helper.d.mts","sourceRoot":"","sources":["../../../src/engine/branch/branch-space-helper.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0FAA0F,CAAC;AAC/H,OAAO,EAAE,sBAAsB,EAAE,MAAM,uFAAuF,CAAC;AAU/H,MAAM,WAAW,0BAA0B;IACvC,SAAS,EAAE,mBAAmB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,4BAA4B;IACzC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,EACzC,SAAS,EACT,OAAO,EACP,UAAU,GACb,EAAE,0BAA0B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAiEpE"}
+{"version":3,"file":"branch-space-helper.d.mts","sourceRoot":"","sources":["../../../src/engine/branch/branch-space-helper.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0FAA0F,CAAC;AAC/H,OAAO,EAAE,sBAAsB,EAAE,MAAM,uFAAuF,CAAC;AAO/H,OAAO,EACH,4BAA4B,EAC5B,gCAAgC,EAChC,kCAAkC,GACrC,MAAM,2BAA2B,CAAC;AAKnC,MAAM,WAAW,0BAA0B;IACvC,SAAS,EAAE,mBAAmB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,4BAA4B;IACzC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,EACzC,SAAS,EACT,OAAO,EACP,UAAU,GACb,EAAE,0BAA0B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAiEpE"}

package/dist/engine/branch/branch-space-helper.mjs

@@ -10,6 +10,7 @@ import { DEFAULT_NODE_FILESYSTEM_SPACE_DATA_V1 } from '@ibgib/node-gib/dist/witn
 import { putInSpace } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
 import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
 import { getB2tFSBranchSpaceName } from './branch-helper.mjs';
+export { populateBranchSpaceFromGraph, } from './branch-graph-helper.mjs';
 const lcFile = `[branch-space-helper]`;
 const logalot = GLOBAL_LOG_A_LOT;
 /**

package/dist/engine/branch/branch-space-helper.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"branch-space-helper.mjs","sourceRoot":"","sources":["../../../src/engine/branch/branch-space-helper.mts"],"names":[],"mappings":"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"}
+{"version":3,"file":"branch-space-helper.mjs","sourceRoot":"","sources":["../../../src/engine/branch/branch-space-helper.mts"],"names":[],"mappings":"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"}

package/dist/engine/branch/{branch-space.respec.node.d.mts → branch-space.respec.d.mts}

@@ -5,4 +5,4 @@
  * and graph population into branch spaces.
  */
 export {};
-//# sourceMappingURL=branch-space.respec.node.d.mts.map
+//# sourceMappingURL=branch-space.respec.d.mts.map

package/dist/engine/branch/branch-space.respec.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-space.respec.d.mts","sourceRoot":"","sources":["../../../src/engine/branch/branch-space.respec.mts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/engine/branch/{branch-space.respec.node.mjs → branch-space.respec.mjs}

@@ -116,18 +116,23 @@ await respecfully(lc, `Branch Space & Graph Helper Respecs`, async () => {
                     vcsPath,
                     branchName: 'main',
                 });
-                // Populate target branch space from source localSpace graph
-                await populateBranchSpaceFromGraph({
+                // Populate target branch space from source localSpace graph and create branch metadata node (SSM)
+                const popResult = await populateBranchSpaceFromGraph({
                     sourceSpace: localSpace,
                     targetBranchSpace,
                     rootItemIbGib: rootItem,
+                    branchName: 'main',
                     metaspace,
                 });
+                iReckon(lc, popResult.syncedCount > 0).isGonnaBeTrue();
+                iReckon(lc, popResult.branchIbGib).isGonnaBeTruthy();
+                iReckon(lc, popResult.branchIbGib?.data?.name).willEqual('main');
+                iReckon(lc, popResult.branchIbGib?.rel8ns?.b2tfs_item).includes(rootAddr);
                 // Verify items exist in targetBranchSpace
-                const rootGet = await getFromSpace({ space: targetBranchSpace, addr: rootAddr });
-                iReckon(lc, rootGet).isGonnaBeTruthy();
-                const childGet = await getFromSpace({ space: targetBranchSpace, addr: childAddr });
-                iReckon(lc, childGet).isGonnaBeTruthy();
+                const rootGet = await getFromSpace({ space: targetBranchSpace, addrs: [rootAddr] });
+                iReckon(lc, rootGet?.ibGibs?.length === 1).isGonnaBeTrue();
+                const childGet = await getFromSpace({ space: targetBranchSpace, addrs: [childAddr] });
+                iReckon(lc, childGet?.ibGibs?.length === 1).isGonnaBeTrue();
             }
             finally {
                 await fs.rm(testDir, { recursive: true, force: true });
@@ -135,4 +140,4 @@ await respecfully(lc, `Branch Space & Graph Helper Respecs`, async () => {
         });
     });
 });
-//# sourceMappingURL=branch-space.respec.node.mjs.map
+//# sourceMappingURL=branch-space.respec.mjs.map

package/dist/engine/branch/branch-space.respec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-space.respec.mjs","sourceRoot":"","sources":["../../../src/engine/branch/branch-space.respec.mts"],"names":[],"mappings":"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"}

package/dist/engine/diff/{line-diff-helper.respec.node.d.mts → line-diff-helper.respec.d.mts}

@@ -4,4 +4,4 @@
  * Unit tests for native zero-dependency Myers / LCS line-diffing engine.
  */
 export {};
-//# sourceMappingURL=line-diff-helper.respec.node.d.mts.map
+//# sourceMappingURL=line-diff-helper.respec.d.mts.map

package/dist/engine/diff/line-diff-helper.respec.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-diff-helper.respec.d.mts","sourceRoot":"","sources":["../../../src/engine/diff/line-diff-helper.respec.mts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/engine/diff/{line-diff-helper.respec.node.mjs → line-diff-helper.respec.mjs}

@@ -63,4 +63,4 @@ await respecfully(lc, `Native Line Diff Engine (Zero-Dependency)`, async () => {
         });
     });
 });
-//# sourceMappingURL=line-diff-helper.respec.node.mjs.map
+//# sourceMappingURL=line-diff-helper.respec.mjs.map

package/dist/engine/diff/line-diff-helper.respec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-diff-helper.respec.mjs","sourceRoot":"","sources":["../../../src/engine/diff/line-diff-helper.respec.mts"],"names":[],"mappings":"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"}

package/dist/engine/filter/{glob-helper.respec.node.d.mts → glob-helper.respec.d.mts}

@@ -4,4 +4,4 @@
  * Unit tests for native zero-dependency glob pattern matching engine.
  */
 export {};
-//# sourceMappingURL=glob-helper.respec.node.d.mts.map
+//# sourceMappingURL=glob-helper.respec.d.mts.map

package/dist/engine/filter/glob-helper.respec.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob-helper.respec.d.mts","sourceRoot":"","sources":["../../../src/engine/filter/glob-helper.respec.mts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/engine/filter/{glob-helper.respec.node.mjs → glob-helper.respec.mjs}

@@ -75,4 +75,4 @@ await respecfully(lc, `Native Glob Engine (Zero-Dependency)`, async () => {
         });
     });
 });
-//# sourceMappingURL=glob-helper.respec.node.mjs.map
+//# sourceMappingURL=glob-helper.respec.mjs.map

package/dist/engine/filter/glob-helper.respec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob-helper.respec.mjs","sourceRoot":"","sources":["../../../src/engine/filter/glob-helper.respec.mts"],"names":[],"mappings":"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"}

package/dist/engine/index/index-helper.d.mts

@@ -75,4 +75,39 @@ export declare function writeVcsIndexProjection({ vcsPath, indexIbGib, }: {
     vcsPath: string;
     indexIbGib: B2tFSIndexIbGib_V1;
 }): Promise<void>;
+export interface UnstagePathsFromIndexOpts {
+    indexIbGib: B2tFSIndexIbGib_V1;
+    paths?: string[];
+    targetDir?: string;
+    activeWorktreeDir?: string;
+    vcsPath?: string;
+    space: IbGibSpaceAny;
+    metaspace: MetaspaceService;
+    all?: boolean;
+}
+export interface UnstagePathsFromIndexResult {
+    updatedIndex: B2tFSIndexIbGib_V1;
+    unstagedPaths: string[];
+}
+/**
+ * Unstages specified paths (or all paths if `all` or empty `paths`) from `indexIbGib.data.stagedPaths`
+ * and `indexIbGib.data.staged_item`.
+ */
+export declare function unstagePathsFromIndex({ indexIbGib, paths, targetDir, activeWorktreeDir, vcsPath, space, metaspace, all, }: UnstagePathsFromIndexOpts): Promise<UnstagePathsFromIndexResult>;
+export interface RestoreWorktreePathsOpts {
+    paths?: string[];
+    targetDir?: string;
+    activeWorktreeDir: string;
+    activeBranchSpace: IbGibSpaceAny;
+    metaspace: MetaspaceService;
+    indexIbGib?: B2tFSIndexIbGib_V1;
+    vcsPath?: string;
+}
+export interface RestoreWorktreePathsResult {
+    restoredPaths: string[];
+}
+/**
+ * Restores working tree physical files from committed branch item snapshot.
+ */
+export declare function restoreWorktreePathsFromSnapshot({ paths, targetDir, activeWorktreeDir, activeBranchSpace, metaspace, indexIbGib, vcsPath, }: RestoreWorktreePathsOpts): Promise<RestoreWorktreePathsResult>;
 //# sourceMappingURL=index-helper.d.mts.map

package/dist/engine/index/index-helper.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index-helper.d.mts","sourceRoot":"","sources":["../../../src/engine/index/index-helper.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kEAAkE,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AAIrF,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAKxH,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,yCAAyC,OAAO,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,0BAA0B,CACtC,aAAa,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAC9D,YAAY,CAAC,EAAE,MAAM,GACtB,uBAAuB,CAKzB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CACxC,YAAY,EAAE;IAAE,kBAAkB,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAC3E;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAwCzF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAarE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC5B,aAAa,GAAE,MAAM,EAAO,EAC5B,QAAQ,GAAE,MAAM,EAAO,GACxB,MAAM,EAAE,CAiBV;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,EACxC,OAAO,EACP,aAAa,EACb,YAAY,EACZ,KAAK,EACL,SAAS,EACT,UAAU,GACb,EAAE;IACC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAuD9B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,EACrC,KAAK,EACL,OAAO,GACV,EAAE;IACC,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAwC1C;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,EACxC,KAAK,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,cAAc,EACd,OAAO,GACV,EAAE;IACC,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC1C,cAAc,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6D9B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,EAC1C,OAAO,EACP,UAAU,GACb,EAAE;IACC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,kBAAkB,CAAC;CAClC,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhB"}
+{"version":3,"file":"index-helper.d.mts","sourceRoot":"","sources":["../../../src/engine/index/index-helper.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kEAAkE,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AAIrF,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAQxH,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,yCAAyC,OAAO,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,0BAA0B,CACtC,aAAa,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAC9D,YAAY,CAAC,EAAE,MAAM,GACtB,uBAAuB,CAKzB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CACxC,YAAY,EAAE;IAAE,kBAAkB,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAC3E;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAwCzF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAarE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC5B,aAAa,GAAE,MAAM,EAAO,EAC5B,QAAQ,GAAE,MAAM,EAAO,GACxB,MAAM,EAAE,CAiBV;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,EACxC,OAAO,EACP,aAAa,EACb,YAAY,EACZ,KAAK,EACL,SAAS,EACT,UAAU,GACb,EAAE;IACC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAuD9B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,EACrC,KAAK,EACL,OAAO,GACV,EAAE;IACC,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAwC1C;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,EACxC,KAAK,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,cAAc,EACd,OAAO,GACV,EAAE;IACC,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC1C,cAAc,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6D9B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,EAC1C,OAAO,EACP,UAAU,GACb,EAAE;IACC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,kBAAkB,CAAC;CAClC,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhB;AAED,MAAM,WAAW,yBAAyB;IACtC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,GAAG,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,2BAA2B;IACxC,YAAY,EAAE,kBAAkB,CAAC;IACjC,aAAa,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,EACxC,UAAU,EACV,KAAU,EACV,SAAyB,EACzB,iBAAiB,EACjB,OAAO,EACP,KAAK,EACL,SAAS,EACT,GAAW,GACd,EAAE,yBAAyB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CA2ElE;AAED,MAAM,WAAW,wBAAwB;IACrC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,aAAa,CAAC;IACjC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACvC,aAAa,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAsB,gCAAgC,CAAC,EACnD,KAAU,EACV,SAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,OAAO,GACV,EAAE,wBAAwB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CA2HhE"}

package/dist/engine/index/index-helper.mjs

@@ -12,6 +12,8 @@ import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
 import { getIbGibsFromCache_fallbackToSpaces } from '@ibgib/core-gib/dist/common/other/ibgib-helper.mjs';
 import { persistTransformResult } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
 import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
+import { B2TFS_CHILD_ITEM_REL8N_NAME } from '../item/item-types.mjs';
+import { getIbGibWithMetaspaceFallback, writeB2tFSItemToFS } from '../item/item-helper.mjs';
 const lcFile = `[index-helper]`;
 const logalot = GLOBAL_LOG_A_LOT;
 export const SOFT_ADDR_DATA_KEY_PREFIX = '@';
@@ -286,4 +288,243 @@ export async function writeVcsIndexProjection({ vcsPath, indexIbGib, }) {
         }
     }
 }
+/**
+ * Unstages specified paths (or all paths if `all` or empty `paths`) from `indexIbGib.data.stagedPaths`
+ * and `indexIbGib.data.staged_item`.
+ */
+export async function unstagePathsFromIndex({ indexIbGib, paths = [], targetDir = process.cwd(), activeWorktreeDir, vcsPath, space, metaspace, all = false, }) {
+    const lc = `${lcFile}[${unstagePathsFromIndex.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d)`);
+        }
+        const currentStagedPaths = { ...(indexIbGib.data?.stagedPaths || {}) };
+        let currentStagedItems = [...(indexIbGib.data?.staged_item || [])];
+        const unstagedPaths = [];
+        const worktreeDir = activeWorktreeDir || targetDir;
+        if (all || paths.length === 0 || (paths.length === 1 && (paths[0] === '.' || paths[0] === ''))) {
+            for (const relPath of Object.keys(currentStagedPaths)) {
+                unstagedPaths.push(relPath);
+            }
+            const updatedIndex = await updateB2tFSIndexIbGib({
+                space,
+                metaspace,
+                indexIbGib,
+                dataToUpdate: {
+                    stagedPaths: {},
+                    staged_item: [],
+                },
+                vcsPath,
+            });
+            return { updatedIndex, unstagedPaths };
+        }
+        for (const p of paths) {
+            let relPath = p.replace(/\\/g, '/');
+            if (path.isAbsolute(p)) {
+                relPath = path.relative(worktreeDir, p).replace(/\\/g, '/');
+            }
+            else if (targetDir !== worktreeDir) {
+                const absP = path.resolve(targetDir, p);
+                relPath = path.relative(worktreeDir, absP).replace(/\\/g, '/');
+            }
+            const targetKeys = Object.keys(currentStagedPaths).filter((k) => {
+                return k === relPath || k.startsWith(relPath + '/');
+            });
+            for (const key of targetKeys) {
+                const record = currentStagedPaths[key];
+                if (record && record.itemAddr) {
+                    currentStagedItems = currentStagedItems.filter((addr) => addr !== record.itemAddr);
+                }
+                delete currentStagedPaths[key];
+                if (!unstagedPaths.includes(key)) {
+                    unstagedPaths.push(key);
+                }
+            }
+        }
+        const updatedIndex = await updateB2tFSIndexIbGib({
+            space,
+            metaspace,
+            indexIbGib,
+            dataToUpdate: {
+                stagedPaths: currentStagedPaths,
+                staged_item: currentStagedItems,
+            },
+            vcsPath,
+        });
+        return { updatedIndex, unstagedPaths };
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)} (E: 7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e)`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete. (I: 8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f)`);
+        }
+    }
+}
+/**
+ * Restores working tree physical files from committed branch item snapshot.
+ */
+export async function restoreWorktreePathsFromSnapshot({ paths = [], targetDir = process.cwd(), activeWorktreeDir, activeBranchSpace, metaspace, indexIbGib, vcsPath, }) {
+    const lc = `${lcFile}[${restoreWorktreePathsFromSnapshot.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a)`);
+        }
+        let currIndex = indexIbGib;
+        if (!currIndex) {
+            currIndex = await getB2tFSIndexIbGib({ space: activeBranchSpace, vcsPath });
+        }
+        if (!currIndex) {
+            throw new Error(`Repository index B2tFSIndexIbGib_V1 not found (E: 0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b)`);
+        }
+        const activeBranch = currIndex.data?.activeBranch || 'main';
+        const branchAddrs = [
+            ...(currIndex.rel8ns?.branch || []),
+            ...(currIndex.rel8ns?.branch_tjp || []),
+        ];
+        let branchIbGibs = [];
+        if (branchAddrs.length > 0) {
+            for (const bAddr of branchAddrs) {
+                const bIbGib = await getIbGibWithMetaspaceFallback({
+                    addr: bAddr,
+                    space: activeBranchSpace,
+                    metaspace,
+                });
+                if (bIbGib) {
+                    branchIbGibs.push(bIbGib);
+                }
+            }
+        }
+        const activeBranchIbGib = branchIbGibs.find((b) => b?.data?.name === activeBranch) || branchIbGibs.at(0);
+        if (!activeBranchIbGib) {
+            throw new Error(`Branch '${activeBranch}' not found (E: 1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c)`);
+        }
+        const rootItemAddr = activeBranchIbGib.rel8ns?.b2tfs_item?.at(0);
+        if (!rootItemAddr) {
+            throw new Error(`Branch '${activeBranch}' has no root item (E: 2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d)`);
+        }
+        const rootItem = await getIbGibWithMetaspaceFallback({
+            addr: rootItemAddr,
+            space: activeBranchSpace,
+            metaspace,
+        });
+        if (!rootItem) {
+            throw new Error(`Root item node '${rootItemAddr}' could not be fetched (E: 3f7e6d5c4b3a2f1e0d9c8b7a6f5e4d3c)`);
+        }
+        const committedItemMap = new Map();
+        await restoreCmd_collectCommittedItems({
+            item: rootItem,
+            parentRelPath: '',
+            space: activeBranchSpace,
+            metaspace,
+            outMap: committedItemMap,
+        });
+        const restoredPaths = [];
+        if (paths.length === 0 || (paths.length === 1 && (paths[0] === '.' || paths[0] === ''))) {
+            for (const entry of committedItemMap.values()) {
+                const destPath = path.join(activeWorktreeDir, entry.parentRelPath);
+                await writeB2tFSItemToFS({
+                    item: entry.item,
+                    destPath,
+                    space: activeBranchSpace,
+                    metaspace,
+                });
+                restoredPaths.push(entry.relPath);
+            }
+        }
+        else {
+            for (const p of paths) {
+                let relPath = p.replace(/\\/g, '/');
+                if (path.isAbsolute(p)) {
+                    relPath = path.relative(activeWorktreeDir, p).replace(/\\/g, '/');
+                }
+                else if (targetDir !== activeWorktreeDir) {
+                    const absP = path.resolve(targetDir, p);
+                    relPath = path.relative(activeWorktreeDir, absP).replace(/\\/g, '/');
+                }
+                let matchedCount = 0;
+                for (const entry of committedItemMap.values()) {
+                    if (entry.relPath === relPath || entry.relPath.startsWith(relPath + '/')) {
+                        const destPath = path.join(activeWorktreeDir, entry.parentRelPath);
+                        await writeB2tFSItemToFS({
+                            item: entry.item,
+                            destPath,
+                            space: activeBranchSpace,
+                            metaspace,
+                        });
+                        if (!restoredPaths.includes(entry.relPath)) {
+                            restoredPaths.push(entry.relPath);
+                        }
+                        matchedCount++;
+                    }
+                }
+                if (matchedCount === 0) {
+                    throw new Error(`pathspec '${p}' did not match any committed file(s) in snapshot (E: 4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c)`);
+                }
+            }
+        }
+        return { restoredPaths };
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)} (E: 5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b)`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete. (I: 6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b)`);
+        }
+    }
+}
+// #region restoreCmd_collectCommittedItems
+async function restoreCmd_collectCommittedItems({ item, parentRelPath, space, metaspace, outMap, }) {
+    if (!item || !item.data) {
+        return;
+    }
+    const { fsType, name } = item.data;
+    if (fsType === 'folder' && !parentRelPath) {
+        const childAddrs = item.rel8ns?.[B2TFS_CHILD_ITEM_REL8N_NAME] || [];
+        for (const childAddr of childAddrs) {
+            const childItem = await getIbGibWithMetaspaceFallback({
+                addr: childAddr,
+                space,
+                metaspace,
+            });
+            if (childItem) {
+                await restoreCmd_collectCommittedItems({
+                    item: childItem,
+                    parentRelPath: '',
+                    space,
+                    metaspace,
+                    outMap,
+                });
+            }
+        }
+    }
+    else {
+        const relPath = parentRelPath ? `${parentRelPath}/${name}` : name;
+        outMap.set(relPath, { relPath, parentRelPath, item });
+        if (fsType === 'folder') {
+            const childAddrs = item.rel8ns?.[B2TFS_CHILD_ITEM_REL8N_NAME] || [];
+            for (const childAddr of childAddrs) {
+                const childItem = await getIbGibWithMetaspaceFallback({
+                    addr: childAddr,
+                    space,
+                    metaspace,
+                });
+                if (childItem) {
+                    await restoreCmd_collectCommittedItems({
+                        item: childItem,
+                        parentRelPath: relPath,
+                        space,
+                        metaspace,
+                        outMap,
+                    });
+                }
+            }
+        }
+    }
+}
+// #endregion restoreCmd_collectCommittedItems
 //# sourceMappingURL=index-helper.mjs.map