@ibgib/vcs-gib 0.0.30 → 0.0.33

package/src/cli/commands/branch-cmd.mts

@@ -1,311 +0,0 @@
-/**
- * @module branch-cmd
- *
- * Command handler for `vcs branch [branchName]`.
- * Lists registered branches or creates a new B2tFSBranchIbGib_V1 node registered in B2tFSIndexIbGib_V1.
- */
-
-import path from 'node:path';
-import fs from 'node:fs/promises';
-
-import { extractErrorMsg, getUUID } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
-import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
-import { getIbGibsFromCache_fallbackToSpaces } from '@ibgib/core-gib/dist/common/other/ibgib-helper.mjs';
-import { putInSpace } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
-
-import { bootstrapVcsMetaspace } from '../../bootstrap/node-bootstrap.mjs';
-import { B2tFSBranchIbGib_V1 } from '../../engine/branch/branch-types.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 { B2tFSItemIbGib_V1, 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 { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
-
-const lcFile = `[branch-cmd]`;
-const logalot = GLOBAL_LOG_A_LOT;
-
-export interface BranchCmdOpts {
-    branchName?: string;
-    itemPath?: string;
-    targetDir?: string;
-    vcsFolderName?: string;
-    quiet?: boolean;
-}
-
-export interface BranchInfo {
-    name: string;
-    isActive: boolean;
-    addr: string;
-    rootItemAddr?: string;
-}
-
-export interface BranchCmdResult {
-    branches: BranchInfo[];
-    createdBranchName?: string;
-    createdBranchAddr?: string;
-}
-
-export async function executeBranchCmd({
-    branchName,
-    itemPath,
-    targetDir = process.cwd(),
-    vcsFolderName = '.vcsgib',
-    quiet = false,
-}: BranchCmdOpts = {}): Promise<BranchCmdResult> {
-    const lc = `${lcFile}[${executeBranchCmd.name}]`;
-    try {
-        if (logalot) { console.log(`${lc} starting... (I: 4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f)`); }
-
-        const absTargetDir = path.resolve(targetDir);
-
-        const { metaspace, localSpace, vcsPath } = await bootstrapVcsMetaspace({
-            repoPath: absTargetDir,
-            vcsFolderName,
-        });
-
-        // Verify repo exists
-        try {
-            await fs.access(vcsPath);
-        } catch {
-            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 });
-        if (!indexIbGib) {
-            throw new Error(`Repository index B2tFSIndexIbGib_V1 not found in localSpace (E: 6e5f4a3b2c1d0e9f8a7b6c5d4e3f2a1b)`);
-        }
-
-        const activeBranchName = indexIbGib.data?.activeBranch || 'main';
-
-        // 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: B2tFSBranchIbGib_V1[] = [];
-        if (branchAddrs.length > 0) {
-            for (const bAddr of branchAddrs) {
-                const bIbGib = await getIbGibWithMetaspaceFallback({
-                    addr: bAddr,
-                    space: activeBranchSpace,
-                    metaspace,
-                });
-                if (bIbGib) {
-                    branchIbGibs.push(bIbGib as B2tFSBranchIbGib_V1);
-                }
-            }
-        }
-
-        // Deduplicate branch nodes by branch name
-        const branchMap = new Map<string, B2tFSBranchIbGib_V1>();
-        for (const b of branchIbGibs) {
-            if (b?.data?.name) {
-                branchMap.set(b.data.name, b);
-            }
-        }
-
-        const trimmedBranchName = branchName?.trim();
-
-        if (!trimmedBranchName) {
-            // LIST BRANCHES
-            const branches: BranchInfo[] = [];
-            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) {
-                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,
-        }) as B2tFSItemIbGib_V1;
-
-        if (!rootItem) {
-            throw new Error(`Root item node for address '${rootItemAddr}' not found in localSpace (E: 9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e)`);
-        }
-
-        let targetRootItem: B2tFSItemIbGib_V1 = rootItem;
-        if (itemPath && itemPath.trim().length > 0) {
-            const normalizedItemPath = itemPath.trim().replace(/\\/g, '/').replace(/^\.\//, '');
-            const committedBranchItemsMap = new Map<string, B2tFSItemIbGib_V1>();
-            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)`);
-            }
-            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: BranchInfo[] = [];
-        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,
-        };
-    } catch (error) {
-        console.error(`${lc} ${extractErrorMsg(error)} (E: 1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a)`);
-        throw error;
-    } finally {
-        if (logalot) {
-            console.log(`${lc} complete. (I: 2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b)`);
-        }
-    }
-}
-
-// #region executeBranchCmd_walkBranchGraphForItems
-async function executeBranchCmd_walkBranchGraphForItems({
-    item,
-    space,
-    metaspace,
-    currentRelPath,
-    outMap,
-}: {
-    item: B2tFSItemIbGib_V1;
-    space: any;
-    metaspace?: any;
-    currentRelPath: string;
-    outMap: Map<string, B2tFSItemIbGib_V1>;
-}): Promise<void> {
-    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,
-            }) as B2tFSItemIbGib_V1;
-
-            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

package/src/cli/commands/checkout-cmd.mts

@@ -1,227 +0,0 @@
-/**
- * @module checkout-cmd
- * 
- * Command handler for `vcs checkout <branchName>`.
- * Switches activeBranch in B2tFSIndexIbGib_V1 in localSpace and projects branch snapshot onto worktree path.
- */
-
-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 { getIbGibsFromCache_fallbackToSpaces } from '@ibgib/core-gib/dist/common/other/ibgib-helper.mjs';
-import { putInSpace, getLatestAddrs } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
-
-
-import { bootstrapVcsMetaspace } from '../../bootstrap/node-bootstrap.mjs';
-import { B2tFSBranchIbGib_V1 } from '../../engine/branch/branch-types.mjs';
-import { getB2tFSBranchSpaceName } from '../../engine/branch/branch-helper.mjs';
-import { getOrCreateBranchSpace } from '../../engine/branch/branch-space-helper.mjs';
-import { B2tFSItemIbGib_V1, 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 { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
-
-const lcFile = `[checkout-cmd]`;
-const logalot = GLOBAL_LOG_A_LOT;
-
-export interface CheckoutCmdOpts {
-    branchName?: string;
-    targetDir?: string;
-    vcsFolderName?: string;
-    quiet?: boolean;
-}
-
-export interface CheckoutCmdResult {
-    previousBranch: string;
-    currentBranch: string;
-    branchAddr: string;
-    rootItemAddr: string;
-    worktreePath: string;
-}
-
-export async function executeCheckoutCmd({
-    branchName,
-    targetDir = process.cwd(),
-    vcsFolderName = '.vcsgib',
-    quiet = false,
-}: CheckoutCmdOpts = {}): Promise<CheckoutCmdResult> {
-    const lc = `${lcFile}[${executeCheckoutCmd.name}]`;
-    try {
-        if (logalot) {
-            console.log(`${lc} starting... (I: 3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8e)`);
-        }
-
-        const trimmedBranchName = branchName?.trim();
-        if (!trimmedBranchName) {
-            throw new Error(`Branch name is required for checkout (E: 4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d)`);
-        }
-
-        const absTargetDir = path.resolve(targetDir);
-
-        const { metaspace, localSpace, repoRoot, vcsPath } = await bootstrapVcsMetaspace({
-            repoPath: absTargetDir,
-            vcsFolderName,
-        });
-
-        // Verify repo exists
-        try {
-            await fs.access(vcsPath);
-        } catch {
-            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 });
-        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: B2tFSBranchIbGib_V1[] = [];
-        if (branchAddrs.length > 0) {
-            for (const bAddr of branchAddrs) {
-                const bIbGib = await getIbGibWithMetaspaceFallback({
-                    addr: bAddr,
-                    space: localSpace,
-                    metaspace,
-                });
-                if (bIbGib) {
-                    branchIbGibs.push(bIbGib as B2tFSBranchIbGib_V1);
-                }
-            }
-        }
-
-        // 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>
-        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 as any)?.latestAddrs?.[0] || targetBranchAddr;
-
-
-        const latestTargetBranchIbGib = (await getIbGibWithMetaspaceFallback({
-            addr: latestTargetBranchAddr,
-            space: targetBranchSpace,
-            metaspace,
-        })) as B2tFSBranchIbGib_V1 || 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,
-            metaspace,
-        }) as B2tFSItemIbGib_V1;
-
-        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,
-                    }) as B2tFSItemIbGib_V1;
-
-                    if (childItem) {
-                        await writeB2tFSItemToFS({
-                            item: childItem,
-                            destPath: worktreePath,
-                            space: targetBranchSpace,
-                            metaspace,
-                        });
-                    }
-                }
-            }
-        }
-
-        if (!quiet) {
-            console.log(`Switched to branch '${trimmedBranchName}' (I: 9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c)`);
-            console.log(`  Worktree projection: ${worktreePath}`);
-        }
-
-        return {
-            previousBranch,
-            currentBranch: trimmedBranchName,
-            branchAddr: targetBranchAddr,
-            rootItemAddr,
-            worktreePath,
-        };
-    } catch (error) {
-        console.error(`${lc} ${extractErrorMsg(error)} (E: 0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d)`);
-        throw error;
-    } finally {
-        if (logalot) {
-            console.log(`${lc} complete. (I: 1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e)`);
-        }
-    }
-}