@ibgib/vcs-gib 0.0.30 → 0.0.32

package/dist/cli/commands/branch-cmd.mjs

@@ -1,21 +1,17 @@
 /**
  * @module branch-cmd
  *
- * Command handler for `vcs branch [branchName]`.
- * Lists registered branches or creates a new B2tFSBranchIbGib_V1 node registered in B2tFSIndexIbGib_V1.
+ * CLI command handler for `vcs branch [branchName]`.
+ * Delegates to executeVcsBranch and formats terminal output.
  */
 import path from 'node:path';
 import fs from 'node:fs/promises';
 import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
-import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
-import { putInSpace } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
+import { executeVcsBranch } from '@ibgib/core-gib/dist/vcs/commands/branch-cmd.mjs';
+import { resolveContextualBranchName } from '@ibgib/core-gib/dist/vcs/branch/branch-helper.mjs';
 import { bootstrapVcsMetaspace } from '../../bootstrap/node-bootstrap.mjs';
-import { createB2tFSBranchIbGib } from '../../engine/branch/branch-helper.mjs';
-import { getOrCreateBranchSpace } from '../../engine/branch/branch-space-helper.mjs';
-import { populateBranchSpaceFromGraph } from '../../engine/branch/branch-graph-helper.mjs';
-import { B2TFS_CHILD_ITEM_REL8N_NAME } from '../../engine/item/item-types.mjs';
-import { getIbGibWithMetaspaceFallback } from '../../engine/item/item-helper.mjs';
-import { getB2tFSIndexIbGib, updateB2tFSIndexIbGib, getSpaceQualifiedIbGibAddr } from '../../engine/index/index-helper.mjs';
+import { getOrCreateBranchSpace } from '@ibgib/node-gib/dist/vcs/branch-space-helper.mjs';
+import { readVcsIndexProjectionFromDisk, writeVcsIndexProjectionToDisk } from '../vcs-projection-helper.mjs';
 import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
 const lcFile = `[branch-cmd]`;
 const logalot = GLOBAL_LOG_A_LOT;
@@ -26,7 +22,7 @@ export async function executeBranchCmd({ branchName, itemPath, targetDir = proce
             console.log(`${lc} starting... (I: 4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f)`);
         }
         const absTargetDir = path.resolve(targetDir);
-        const { metaspace, localSpace, vcsPath } = await bootstrapVcsMetaspace({
+        const { metaspace, localSpace, vcsPath, repoRoot } = await bootstrapVcsMetaspace({
             repoPath: absTargetDir,
             vcsFolderName,
         });
@@ -38,158 +34,64 @@ export async function executeBranchCmd({ branchName, itemPath, targetDir = proce
             throw new Error(`Not an ibgib repository (directory ${vcsPath} does not exist) (E: 5d4e3f2a1b0c9d8e7f6a5b4c3d2e1f0a)`);
         }
         // 1. Fetch authoritative repository index from localSpace
-        const indexIbGib = await getB2tFSIndexIbGib({ space: localSpace, vcsPath });
+        const indexIbGib = await readVcsIndexProjectionFromDisk({ vcsPath, space: localSpace });
         if (!indexIbGib) {
             throw new Error(`Repository index B2tFSIndexIbGib_V1 not found in localSpace (E: 6e5f4a3b2c1d0e9f8a7b6c5d4e3f2a1b)`);
         }
-        const activeBranchName = indexIbGib.data?.activeBranch || 'main';
+        const activeBranchName = resolveContextualBranchName({
+            targetDir: absTargetDir,
+            repoRoot,
+            indexIbGib,
+        });
         // Resolve active branch space b2s_<activeBranch>
         const { space: activeBranchSpace } = await getOrCreateBranchSpace({
             metaspace,
             vcsPath,
             branchName: activeBranchName,
         });
-        // 2. Fetch all registered branch ibgibs
-        const branchAddrs = [
-            ...(indexIbGib.rel8ns?.branch || []),
-            ...(indexIbGib.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);
-                }
-            }
+        // If creating a branch, ensure target branch space exists on Node
+        if (branchName && branchName.trim().length > 0) {
+            await getOrCreateBranchSpace({
+                metaspace,
+                vcsPath,
+                branchName: branchName.trim(),
+            });
         }
-        // Deduplicate branch nodes by branch name
-        const branchMap = new Map();
-        for (const b of branchIbGibs) {
-            if (b?.data?.name) {
-                branchMap.set(b.data.name, b);
-            }
+        const branchRes = await executeVcsBranch({
+            metaspace,
+            localSpace,
+            activeBranchSpace,
+            indexIbGib,
+            branchName,
+            itemPath,
+            repoRoot,
+            targetDir: absTargetDir,
+            vcsFolderName,
+        });
+        if (branchRes.updatedIndex) {
+            await writeVcsIndexProjectionToDisk({ vcsPath, indexIbGib: branchRes.updatedIndex });
         }
-        const trimmedBranchName = branchName?.trim();
-        if (!trimmedBranchName) {
-            // LIST BRANCHES
-            const branches = [];
-            for (const [name, bNode] of branchMap.entries()) {
-                const addr = getIbGibAddr({ ibGib: bNode });
-                const rootItemAddr = bNode.rel8ns?.b2tfs_item?.at(-1);
-                const isActive = name === activeBranchName;
-                branches.push({
-                    name,
-                    isActive,
-                    addr,
-                    rootItemAddr,
-                });
-            }
-            if (!quiet) {
+        const branches = branchRes.branches.map(b => ({
+            name: b.name,
+            isActive: b.isActive,
+            addr: b.commitAddr || '',
+            rootItemAddr: b.rootItemAddr,
+        }));
+        if (!quiet) {
+            if (!branchName) {
                 for (const b of branches) {
                     const prefix = b.isActive ? '* ' : '  ';
                     console.log(`${prefix}${b.name}`);
                 }
             }
-            return { branches };
-        }
-        // CREATE BRANCH
-        if (branchMap.has(trimmedBranchName)) {
-            throw new Error(`Branch '${trimmedBranchName}' already exists (E: 7f6a5b4c3d2e1f0a9b8c7d6e5f4a3b2c)`);
-        }
-        // Find active branch root item to fork from
-        const activeBranchIbGib = branchMap.get(activeBranchName) || branchIbGibs.at(0);
-        const rootItemAddr = activeBranchIbGib?.rel8ns?.b2tfs_item?.at(-1);
-        if (!rootItemAddr) {
-            throw new Error(`Cannot find active branch root item to fork branch from (E: 8f7e6d5c4b3a2f1e0d9c8b7a6f5e4d3c)`);
-        }
-        const rootItem = await getIbGibWithMetaspaceFallback({
-            addr: rootItemAddr,
-            space: activeBranchSpace,
-            metaspace,
-        });
-        if (!rootItem) {
-            throw new Error(`Root item node for address '${rootItemAddr}' not found in localSpace (E: 9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e)`);
-        }
-        let targetRootItem = rootItem;
-        if (itemPath && itemPath.trim().length > 0) {
-            const normalizedItemPath = itemPath.trim().replace(/\\/g, '/').replace(/^\.\//, '');
-            const committedBranchItemsMap = new Map();
-            await executeBranchCmd_walkBranchGraphForItems({
-                item: rootItem,
-                space: activeBranchSpace,
-                metaspace,
-                currentRelPath: '',
-                outMap: committedBranchItemsMap,
-            });
-            const targetItemNode = committedBranchItemsMap.get(normalizedItemPath);
-            if (!targetItemNode) {
-                throw new Error(`Item '${itemPath}' not found in active branch snapshot (E: 8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c)`);
+            else {
+                console.log(`Created branch '${branchRes.createdBranchName}'`);
             }
-            targetRootItem = targetItemNode;
-        }
-        // Instantiate new branch space b2s_<newBranch>
-        const { space: newBranchSpace, spaceId: newBranchSpaceId } = await getOrCreateBranchSpace({
-            metaspace,
-            vcsPath,
-            branchName: trimmedBranchName,
-        });
-        // Populate new branch space from live dependency graph of targetRootItem
-        await populateBranchSpaceFromGraph({
-            sourceSpace: activeBranchSpace,
-            targetBranchSpace: newBranchSpace,
-            rootItemIbGib: targetRootItem,
-            metaspace,
-        });
-        // Create new B2tFSBranchIbGib_V1 branch node inside newBranchSpace
-        const newBranchIbGib = await createB2tFSBranchIbGib({
-            branchName: trimmedBranchName,
-            rootItem: targetRootItem,
-            space: newBranchSpace,
-            metaspace,
-        });
-        // Put in activeBranchSpace so active index can reference it
-        await putInSpace({ space: activeBranchSpace, ibGib: newBranchIbGib });
-        const newBranchAddr = getIbGibAddr({ ibGib: newBranchIbGib });
-        const sqNewBranchAddr = getSpaceQualifiedIbGibAddr({
-            spaceId: newBranchSpaceId,
-            ibGibAddr: newBranchAddr,
-        });
-        // Register new branch node in B2tFSIndexIbGib_V1 using space-qualified address
-        await updateB2tFSIndexIbGib({
-            space: activeBranchSpace,
-            metaspace,
-            indexIbGib,
-            rel8nsToUpdate: {
-                branch: [sqNewBranchAddr],
-                branch_tjp: [sqNewBranchAddr],
-            },
-            vcsPath,
-        });
-        if (!quiet) {
-            console.log(`Created branch '${trimmedBranchName}' (I: 0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5e)`);
-        }
-        // Return updated branch list
-        branchMap.set(trimmedBranchName, newBranchIbGib);
-        const branches = [];
-        for (const [name, bNode] of branchMap.entries()) {
-            const addr = getIbGibAddr({ ibGib: bNode });
-            const itemAddr = bNode.rel8ns?.b2tfs_item?.at(0);
-            branches.push({
-                name,
-                isActive: name === activeBranchName,
-                addr,
-                rootItemAddr: itemAddr,
-            });
         }
         return {
             branches,
-            createdBranchName: trimmedBranchName,
-            createdBranchAddr: newBranchAddr,
+            createdBranchName: branchRes.createdBranchName,
+            createdBranchAddr: branchRes.createdBranchAddr,
         };
     }
     catch (error) {
@@ -202,37 +104,4 @@ export async function executeBranchCmd({ branchName, itemPath, targetDir = proce
         }
     }
 }
-// #region executeBranchCmd_walkBranchGraphForItems
-async function executeBranchCmd_walkBranchGraphForItems({ item, space, metaspace, currentRelPath, outMap, }) {
-    if (!item || !item.data) {
-        return;
-    }
-    const { fsType } = item.data;
-    if (currentRelPath) {
-        outMap.set(currentRelPath, 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 && childItem.data) {
-                const childRelPath = currentRelPath
-                    ? `${currentRelPath}/${childItem.data.name}`
-                    : childItem.data.name;
-                await executeBranchCmd_walkBranchGraphForItems({
-                    item: childItem,
-                    space,
-                    metaspace,
-                    currentRelPath: childRelPath,
-                    outMap,
-                });
-            }
-        }
-    }
-}
-// #endregion executeBranchCmd_walkBranchGraphForItems
 //# sourceMappingURL=branch-cmd.mjs.map

package/dist/cli/commands/branch-cmd.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"branch-cmd.mjs","sourceRoot":"","sources":["../../../src/cli/commands/branch-cmd.mts"],"names":[],"mappings":"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"}
+{"version":3,"file":"branch-cmd.mjs","sourceRoot":"","sources":["../../../src/cli/commands/branch-cmd.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,mDAAmD,CAAC;AAEhG,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAC1F,OAAO,EAAE,8BAA8B,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7G,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,MAAM,GAAG,cAAc,CAAC;AAC9B,MAAM,OAAO,GAAG,gBAAgB,CAAC;AAuBjC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EACnC,UAAU,EACV,QAAQ,EACR,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,EACzB,aAAa,GAAG,SAAS,EACzB,KAAK,GAAG,KAAK,GAChB,GAAkB,EAAE;IACjB,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,gBAAgB,CAAC,IAAI,GAAG,CAAC;IACjD,IAAI,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,oDAAoD,CAAC,CAAC;QAAC,CAAC;QAExF,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAE7C,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,qBAAqB,CAAC;YAC7E,QAAQ,EAAE,YAAY;YACtB,aAAa;SAChB,CAAC,CAAC;QAEH,qBAAqB;QACrB,IAAI,CAAC;YACD,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACL,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,wDAAwD,CAAC,CAAC;QAC3H,CAAC;QAED,0DAA0D;QAC1D,MAAM,UAAU,GAAG,MAAM,8BAA8B,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACxF,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,mGAAmG,CAAC,CAAC;QACzH,CAAC;QAED,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;YACjD,SAAS,EAAE,YAAY;YACvB,QAAQ;YACR,UAAU;SACb,CAAC,CAAC;QAEH,iDAAiD;QACjD,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,MAAM,sBAAsB,CAAC;YAC9D,SAAS;YACT,OAAO;YACP,UAAU,EAAE,gBAAgB;SAC/B,CAAC,CAAC;QAEH,kEAAkE;QAClE,IAAI,UAAU,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,sBAAsB,CAAC;gBACzB,SAAS;gBACT,OAAO;gBACP,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE;aAChC,CAAC,CAAC;QACP,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC;YACrC,SAAS;YACT,UAAU;YACV,iBAAiB;YACjB,UAAU;YACV,UAAU;YACV,QAAQ;YACR,QAAQ;YACR,SAAS,EAAE,YAAY;YACvB,aAAa;SAChB,CAAC,CAAC;QAEH,IAAI,SAAS,CAAC,YAAY,EAAE,CAAC;YACzB,MAAM,6BAA6B,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC;QACzF,CAAC;QAED,MAAM,QAAQ,GAAiB,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACxD,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,IAAI,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE;YACxB,YAAY,EAAE,CAAC,CAAC,YAAY;SAC/B,CAAC,CAAC,CAAC;QAEJ,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,IAAI,CAAC,UAAU,EAAE,CAAC;gBACd,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;oBACvB,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;oBACxC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACtC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,GAAG,CAAC,mBAAmB,SAAS,CAAC,iBAAiB,GAAG,CAAC,CAAC;YACnE,CAAC;QACL,CAAC;QAED,OAAO;YACH,QAAQ;YACR,iBAAiB,EAAE,SAAS,CAAC,iBAAiB;YAC9C,iBAAiB,EAAE,SAAS,CAAC,iBAAiB;SACjD,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;YAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,kDAAkD,CAAC,CAAC;QAAC,CAAC;IAC1F,CAAC;AACL,CAAC"}

package/dist/cli/commands/checkout-cmd.d.mts

@@ -1,8 +1,8 @@
 /**
  * @module checkout-cmd
  *
- * Command handler for `vcs checkout <branchName>`.
- * Switches activeBranch in B2tFSIndexIbGib_V1 in localSpace and projects branch snapshot onto worktree path.
+ * CLI command handler for `vcs checkout <branchName>`.
+ * Bootstraps workspace projection space, delegates to executeVcsCheckout, and writes projection cache.
  */
 export interface CheckoutCmdOpts {
     branchName?: string;
@@ -13,8 +13,6 @@ export interface CheckoutCmdOpts {
 export interface CheckoutCmdResult {
     previousBranch: string;
     currentBranch: string;
-    branchAddr: string;
-    rootItemAddr: string;
     worktreePath: string;
 }
 export declare function executeCheckoutCmd({ branchName, targetDir, vcsFolderName, quiet, }?: CheckoutCmdOpts): Promise<CheckoutCmdResult>;

package/dist/cli/commands/checkout-cmd.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"checkout-cmd.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/checkout-cmd.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuBH,MAAM,WAAW,eAAe;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,kBAAkB,CAAC,EACrC,UAAU,EACV,SAAyB,EACzB,aAAyB,EACzB,KAAa,GAChB,GAAE,eAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkLnD"}
+{"version":3,"file":"checkout-cmd.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/checkout-cmd.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,MAAM,WAAW,eAAe;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,kBAAkB,CAAC,EACrC,UAAU,EACV,SAAyB,EACzB,aAAyB,EACzB,KAAa,GAChB,GAAE,eAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkFnD"}

package/dist/cli/commands/checkout-cmd.mjs

@@ -1,20 +1,17 @@
 /**
  * @module checkout-cmd
  *
- * Command handler for `vcs checkout <branchName>`.
- * Switches activeBranch in B2tFSIndexIbGib_V1 in localSpace and projects branch snapshot onto worktree path.
+ * CLI command handler for `vcs checkout <branchName>`.
+ * Bootstraps workspace projection space, delegates to executeVcsCheckout, and writes projection cache.
  */
 import path from 'node:path';
 import fs from 'node:fs/promises';
 import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
-import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
-import { putInSpace, getLatestAddrs } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
+import { executeVcsCheckout } from '@ibgib/core-gib/dist/vcs/commands/checkout-cmd.mjs';
 import { bootstrapVcsMetaspace } from '../../bootstrap/node-bootstrap.mjs';
-import { getB2tFSBranchSpaceName } from '../../engine/branch/branch-helper.mjs';
-import { getOrCreateBranchSpace } from '../../engine/branch/branch-space-helper.mjs';
-import { B2TFS_CHILD_ITEM_REL8N_NAME } from '../../engine/item/item-types.mjs';
-import { writeB2tFSItemToFS, getIbGibWithMetaspaceFallback } from '../../engine/item/item-helper.mjs';
-import { getB2tFSIndexIbGib, updateB2tFSIndexIbGib } from '../../engine/index/index-helper.mjs';
+import { getOrCreateBranchSpace } from '@ibgib/node-gib/dist/vcs/branch-space-helper.mjs';
+import { getOrCreateWorkspaceProjectionSpace } from '@ibgib/node-gib/dist/vcs/workspace-space-helper.mjs';
+import { readVcsIndexProjectionFromDisk, writeVcsIndexProjectionToDisk } from '../vcs-projection-helper.mjs';
 import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
 const lcFile = `[checkout-cmd]`;
 const logalot = GLOBAL_LOG_A_LOT;
@@ -22,7 +19,7 @@ export async function executeCheckoutCmd({ branchName, targetDir = process.cwd()
     const lc = `${lcFile}[${executeCheckoutCmd.name}]`;
     try {
         if (logalot) {
-            console.log(`${lc} starting... (I: 3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8e)`);
+            console.log(`${lc} starting... (I: 3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e)`);
         }
         const trimmedBranchName = branchName?.trim();
         if (!trimmedBranchName) {
@@ -41,133 +38,57 @@ export async function executeCheckoutCmd({ branchName, targetDir = process.cwd()
             throw new Error(`Not an ibgib repository (directory ${vcsPath} does not exist) (E: 5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0e)`);
         }
         // 1. Fetch authoritative repository index from localSpace
-        const indexIbGib = await getB2tFSIndexIbGib({ space: localSpace, vcsPath });
+        const indexIbGib = await readVcsIndexProjectionFromDisk({ vcsPath, space: localSpace });
         if (!indexIbGib) {
             throw new Error(`Repository index B2tFSIndexIbGib_V1 not found in localSpace (E: 6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f)`);
         }
-        const previousBranch = indexIbGib.data?.activeBranch || 'main';
-        // 2. Fetch all registered branch ibgibs
-        const branchAddrs = [
-            ...(indexIbGib.rel8ns?.branch || []),
-            ...(indexIbGib.rel8ns?.branch_tjp || []),
-        ];
-        let branchIbGibs = [];
-        if (branchAddrs.length > 0) {
-            for (const bAddr of branchAddrs) {
-                const bIbGib = await getIbGibWithMetaspaceFallback({
-                    addr: bAddr,
-                    space: localSpace,
-                    metaspace,
-                });
-                if (bIbGib) {
-                    branchIbGibs.push(bIbGib);
-                }
-            }
-        }
-        // Find target branch node
-        const targetBranchIbGib = branchIbGibs.findLast((b) => b?.data?.name === trimmedBranchName);
-        if (!targetBranchIbGib) {
-            throw new Error(`Branch '${trimmedBranchName}' does not exist (E: 7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a)`);
-        }
-        // 3. Resolve target branch space b2s_<branchName>
+        // 2. Resolve target branch space b2s_<branchName>
         const targetBranchSpaceRes = await getOrCreateBranchSpace({
             metaspace,
             vcsPath,
             branchName: trimmedBranchName,
         });
         const targetBranchSpace = targetBranchSpaceRes.space;
-        const targetBranchAddr = getIbGibAddr({ ibGib: targetBranchIbGib });
-        const targetBranchTjpAddr = targetBranchIbGib.rel8ns?.tjp?.at(0) || targetBranchAddr;
-        const latestTargetBranchRes = await getLatestAddrs({ space: targetBranchSpace, addrs: [targetBranchTjpAddr] });
-        const latestTargetBranchAddr = latestTargetBranchRes?.data?.latestAddrs?.[0] || targetBranchAddr;
-        const latestTargetBranchIbGib = (await getIbGibWithMetaspaceFallback({
-            addr: latestTargetBranchAddr,
-            space: targetBranchSpace,
-            metaspace,
-        })) || targetBranchIbGib;
-        const rootItemAddr = latestTargetBranchIbGib.rel8ns?.b2tfs_item?.at(-1);
-        if (!rootItemAddr) {
-            throw new Error(`Branch '${trimmedBranchName}' does not have a valid root item address (E: 8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b)`);
-        }
-        await putInSpace({ space: targetBranchSpace, ibGib: targetBranchIbGib });
-        // Update activeBranch in B2tFSIndexIbGib_V1 in targetBranchSpace and localSpace
-        const updatedIndex = await updateB2tFSIndexIbGib({
-            space: targetBranchSpace,
-            metaspace,
-            indexIbGib,
-            dataToUpdate: {
-                activeBranch: trimmedBranchName,
-                activeSpaceId: getB2tFSBranchSpaceName(trimmedBranchName),
-                mySpaceId: targetBranchSpaceRes.spaceId,
-            },
-            vcsPath,
-        });
-        if (localSpace !== targetBranchSpace) {
-            await putInSpace({ space: localSpace, ibGib: updatedIndex });
-        }
-        // 4. Project branch snapshot onto worktree subfolder:
-        //    'main' -> repoRoot
-        //    other branches -> repoRoot/b/<branch_name>/
         const isDefaultBranch = trimmedBranchName === 'main';
         const worktreePath = isDefaultBranch
             ? repoRoot
             : path.join(repoRoot, 'b', trimmedBranchName);
         await fs.mkdir(worktreePath, { recursive: true });
-        // Retrieve root item and project branch snapshot onto worktree subfolder:
-        // If rootItem is a single file, write it directly to worktreePath (my-repo/b/<branchName>/<fileName>).
-        // If rootItem is a folder, write child items into worktreePath.
-        const rootItem = await getIbGibWithMetaspaceFallback({
-            addr: rootItemAddr,
-            space: targetBranchSpace,
+        const { space: workspaceSpace } = await getOrCreateWorkspaceProjectionSpace({
             metaspace,
+            workspaceRoot: worktreePath,
+            vcsFolderName,
+            backingSpace: targetBranchSpace,
         });
-        if (rootItem) {
-            if (rootItem.data?.fsType === 'file') {
-                await writeB2tFSItemToFS({
-                    item: rootItem,
-                    destPath: worktreePath,
-                    space: targetBranchSpace,
-                    metaspace,
-                });
-            }
-            else {
-                const childAddrs = rootItem.rel8ns?.[B2TFS_CHILD_ITEM_REL8N_NAME] || [];
-                for (const childAddr of childAddrs) {
-                    const childItem = await getIbGibWithMetaspaceFallback({
-                        addr: childAddr,
-                        space: targetBranchSpace,
-                        metaspace,
-                    });
-                    if (childItem) {
-                        await writeB2tFSItemToFS({
-                            item: childItem,
-                            destPath: worktreePath,
-                            space: targetBranchSpace,
-                            metaspace,
-                        });
-                    }
-                }
-            }
-        }
+        const checkoutRes = await executeVcsCheckout({
+            metaspace,
+            localSpace,
+            targetBranchSpace,
+            workspaceSpace,
+            indexIbGib,
+            branchName: trimmedBranchName,
+            repoRoot,
+            targetDir: absTargetDir,
+            vcsFolderName,
+        });
+        await writeVcsIndexProjectionToDisk({ vcsPath, indexIbGib: checkoutRes.updatedIndex });
         if (!quiet) {
-            console.log(`Switched to branch '${trimmedBranchName}' (I: 9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c)`);
-            console.log(`  Worktree projection: ${worktreePath}`);
+            console.log(`Switched to branch '${trimmedBranchName}' (I: 0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d)`);
+            console.log(`Worktree path: ${worktreePath}`);
         }
         return {
-            previousBranch,
-            currentBranch: trimmedBranchName,
-            branchAddr: targetBranchAddr,
-            rootItemAddr,
+            previousBranch: checkoutRes.previousBranch,
+            currentBranch: checkoutRes.currentBranch,
             worktreePath,
         };
     }
     catch (error) {
-        console.error(`${lc} ${extractErrorMsg(error)} (E: 0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d)`);
+        console.error(`${lc} ${extractErrorMsg(error)} (E: 1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d)`);
         throw error;
     }
     finally {
         if (logalot) {
-            console.log(`${lc} complete. (I: 1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e)`);
+            console.log(`${lc} complete. (I: 2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e)`);
         }
     }
 }

package/dist/cli/commands/checkout-cmd.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"checkout-cmd.mjs","sourceRoot":"","sources":["../../../src/cli/commands/checkout-cmd.mts"],"names":[],"mappings":"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"}
+{"version":3,"file":"checkout-cmd.mjs","sourceRoot":"","sources":["../../../src/cli/commands/checkout-cmd.mts"],"names":[],"mappings":"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"}

package/dist/cli/commands/commit-cmd.d.mts

@@ -1,24 +1,23 @@
 /**
  * @module commit-cmd
  *
- * Command handler for `vcs commit -m "message"`.
- * Ingests staged items and co-located .ib.*.md comment metadata files,
- * attaches comments to corresponding file and folder b2tfs_items,
- * attaches overall commit message to root b2tfs_item, evolves root item,
- * advances B2tFSBranchIbGib_V1 with committedPaths, and clears index staging area.
+ * CLI command handler for `vcs commit -m <message>`.
+ * Bootstraps workspace projection space and delegates to executeVcsCommit.
  */
 export interface CommitCmdOpts {
     message?: string;
     targetDir?: string;
     vcsFolderName?: string;
+    author?: string;
     quiet?: boolean;
 }
 export interface CommitCmdResult {
+    branchName: string;
     commitAddr: string;
     commentAddr?: string;
-    branchName: string;
-    committedPaths: string[];
     rootItemAddr: string;
+    committedPaths: string[];
+    ingestedCommentsCount: number;
 }
-export declare function executeCommitCmd({ message, targetDir, vcsFolderName, quiet, }?: CommitCmdOpts): Promise<CommitCmdResult>;
+export declare function executeCommitCmd({ message, targetDir, vcsFolderName, author, quiet, }?: CommitCmdOpts): Promise<CommitCmdResult>;
 //# sourceMappingURL=commit-cmd.d.mts.map

package/dist/cli/commands/commit-cmd.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"commit-cmd.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/commit-cmd.mts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA+BH,MAAM,WAAW,aAAa;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,gBAAgB,CAAC,EACnC,OAAY,EACZ,SAAyB,EACzB,aAAyB,EACzB,KAAa,GAChB,GAAE,aAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAmM/C"}
+{"version":3,"file":"commit-cmd.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/commit-cmd.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,MAAM,WAAW,aAAa;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;CACjC;AAED,wBAAsB,gBAAgB,CAAC,EACnC,OAAO,EACP,SAAyB,EACzB,aAAyB,EACzB,MAAmB,EACnB,KAAa,GAChB,GAAE,aAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAmF/C"}