@ibgib/vcs-gib 0.0.30 → 0.0.33

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

@@ -1,346 +0,0 @@
-/**
- * @module add-cmd
- *
- * Command handler for `vcs add <path...>`.
- * Stages files and directories into candidate B2tFSItemIbGib_V1 and BinIbGib_V1 graph nodes
- * and updates B2tFSIndexIbGib_V1 in localSpace.
- */
-import path from 'node:path';
-import fs from 'node:fs/promises';
-import crypto from 'node:crypto';
-import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
-import { getGib } from '@ibgib/ts-gib/dist/V1/transforms/transform-helper.mjs';
-import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
-import { putInSpace, persistTransformResult } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
-import { bootstrapVcsMetaspace } from '../../bootstrap/node-bootstrap.mjs';
-import { getOrCreateBranchSpace } from '../../engine/branch/branch-space-helper.mjs';
-import { resolveContextualBranchName } from '../../engine/branch/branch-helper.mjs';
-import { isCommentMetadataFilename } from '../../engine/status/status-helper.mjs';
-import { B2TFS_CHILD_ITEM_REL8N_NAME } from '../../engine/item/item-types.mjs';
-import { getIbGibWithMetaspaceFallback, createB2tFSItemIbGib, evolveB2tFSItemIbGib } from '../../engine/item/item-helper.mjs';
-import { isPathFiltered, parseFilterFileContent, globToRegExp } from '../../engine/filter/glob-helper.mjs';
-import { getB2tFSIndexIbGib, updateB2tFSIndexIbGib } from '../../engine/index/index-helper.mjs';
-import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
-const lcFile = `[add-cmd]`;
-const logalot = GLOBAL_LOG_A_LOT;
-export async function executeAddCmd({ paths = [], targetDir = process.cwd(), vcsFolderName = '.vcsgib', all = false, quiet = false, } = {}) {
-    const lc = `${lcFile}[${executeAddCmd.name}]`;
-    try {
-        if (logalot) {
-            console.log(`${lc} starting... (I: 1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d)`);
-        }
-        const absTargetDir = path.resolve(targetDir);
-        const { metaspace, localSpace, vcsPath, repoRoot } = 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: 2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d)`);
-        }
-        // Retrieve authoritative B2tFSIndexIbGib_V1 from space
-        const indexIbGib = await getB2tFSIndexIbGib({ space: localSpace, vcsPath });
-        if (!indexIbGib) {
-            throw new Error(`Repository not initialized. Run 'vcs init' first. (E: 2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e)`);
-        }
-        const activeBranch = resolveContextualBranchName({
-            targetDir: absTargetDir,
-            repoRoot,
-            indexIbGib,
-        });
-        const activeWorktreeDir = activeBranch === 'main' ? repoRoot : path.join(repoRoot, 'b', activeBranch);
-        // Target active branch space b2s_<activeBranch>
-        const { space: activeSpace } = await getOrCreateBranchSpace({
-            metaspace,
-            vcsPath,
-            branchName: activeBranch,
-        });
-        // Read .ibgibignore if present in active worktree
-        let filterPatterns = [];
-        const ignorePath = path.join(activeWorktreeDir, '.ibgibignore');
-        try {
-            const ignoreContent = await fs.readFile(ignorePath, 'utf8');
-            filterPatterns = parseFilterFileContent(ignoreContent);
-        }
-        catch {
-            // Ignore file not found is fine
-        }
-        // Walk active branch graph items to find committed files in snapshot
-        const committedBranchItemsMap = new Map();
-        const branchAddrs = [
-            ...(indexIbGib?.rel8ns?.branch || []),
-            ...(indexIbGib?.rel8ns?.branch_tjp || []),
-        ];
-        if (branchAddrs.length > 0) {
-            let branchIbGibs = [];
-            for (const bAddr of branchAddrs) {
-                const bIbGib = await getIbGibWithMetaspaceFallback({
-                    addr: bAddr,
-                    space: activeSpace,
-                    metaspace,
-                });
-                if (bIbGib) {
-                    branchIbGibs.push(bIbGib);
-                }
-            }
-            const activeBranchIbGib = branchIbGibs.findLast((b) => b?.data?.name === activeBranch) || branchIbGibs.at(-1);
-            const rootItemAddr = activeBranchIbGib?.rel8ns?.b2tfs_item?.at(-1);
-            if (rootItemAddr) {
-                const rootItem = await getIbGibWithMetaspaceFallback({
-                    addr: rootItemAddr,
-                    space: activeSpace,
-                    metaspace,
-                });
-                if (rootItem) {
-                    await addCmd_walkBranchGraph({
-                        item: rootItem,
-                        space: activeSpace,
-                        metaspace,
-                        currentRelPath: '',
-                        outMap: committedBranchItemsMap,
-                    });
-                }
-            }
-        }
-        // Determine candidate file paths to stage
-        const targetFilePaths = [];
-        if (all || paths.length === 0 || (paths.length === 1 && paths[0] === '.')) {
-            await addCmd_collectFilesRecursively({
-                dirPath: activeWorktreeDir,
-                baseDir: activeWorktreeDir,
-                vcsFolderName,
-                filterPatterns,
-                outFiles: targetFilePaths,
-            });
-        }
-        else {
-            for (const relOrAbs of paths) {
-                if (relOrAbs.includes('*') || relOrAbs.includes('?')) {
-                    const rx = globToRegExp(relOrAbs);
-                    const candidateFiles = [];
-                    await addCmd_collectFilesRecursively({
-                        dirPath: activeWorktreeDir,
-                        baseDir: activeWorktreeDir,
-                        vcsFolderName,
-                        filterPatterns,
-                        outFiles: candidateFiles,
-                    });
-                    let matchedCount = 0;
-                    for (const candidateAbsPath of candidateFiles) {
-                        const candidateRelPath = path.relative(activeWorktreeDir, candidateAbsPath).replace(/\\/g, '/');
-                        const pathBasename = candidateRelPath.split('/').pop() || candidateRelPath;
-                        if (rx.test(candidateRelPath) || rx.test(pathBasename)) {
-                            if (!targetFilePaths.includes(candidateAbsPath)) {
-                                targetFilePaths.push(candidateAbsPath);
-                            }
-                            matchedCount++;
-                        }
-                    }
-                    if (matchedCount === 0) {
-                        throw new Error(`No files matched glob pattern: ${relOrAbs} (E: e23d4c5f6a7b8c9d0e1f2a3b4c5d6e7f)`);
-                    }
-                }
-                else {
-                    const fullPath = path.isAbsolute(relOrAbs) ? relOrAbs : path.resolve(absTargetDir, relOrAbs);
-                    let stat;
-                    try {
-                        stat = await fs.stat(fullPath);
-                    }
-                    catch {
-                        throw new Error(`Path does not exist: ${relOrAbs} (E: 10c11d12e13f14a15b16c17d18e19f20)`);
-                    }
-                    const relPath = path.relative(activeWorktreeDir, fullPath).replace(/\\/g, '/');
-                    if (relPath.startsWith('..') || path.isAbsolute(relPath)) {
-                        throw new Error(`Path '${relOrAbs}' is outside of active worktree repository (E: 7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f)`);
-                    }
-                    if (isPathFiltered({ relativePath: relPath, isDirectory: stat.isDirectory(), filterPatterns })) {
-                        continue;
-                    }
-                    if (stat.isDirectory()) {
-                        await addCmd_collectFilesRecursively({
-                            dirPath: fullPath,
-                            baseDir: activeWorktreeDir,
-                            vcsFolderName,
-                            filterPatterns,
-                            outFiles: targetFilePaths,
-                        });
-                    }
-                    else if (stat.isFile()) {
-                        if (!targetFilePaths.includes(fullPath)) {
-                            targetFilePaths.push(fullPath);
-                        }
-                    }
-                }
-            }
-        }
-        const stagedItemAddrs = [...(indexIbGib.data?.staged_item || [])];
-        const stagedPathsMap = { ...(indexIbGib.data?.stagedPaths || {}) };
-        const newlyStagedPaths = [];
-        for (const absFilePath of targetFilePaths) {
-            const relPath = path.relative(activeWorktreeDir, absFilePath).replace(/\\/g, '/');
-            // Read file data & compute hash
-            const fileData = await fs.readFile(absFilePath);
-            const fileHash = crypto.createHash('sha256').update(fileData).digest('hex');
-            // Skip staging if candidate file matches active branch committed snapshot
-            const committedItem = committedBranchItemsMap.get(relPath);
-            if (committedItem && committedItem.fileHash && committedItem.fileHash === fileHash) {
-                continue;
-            }
-            // 1. Create BinIbGib_V1 graph node as Uint8Array
-            const binData = new Uint8Array(fileData);
-            const binIb = `bin ${fileHash}`;
-            const binGib = await getGib({ ibGib: { ib: binIb, data: binData } });
-            const binIbGib = {
-                ib: binIb,
-                gib: binGib,
-                data: binData,
-            };
-            const binAddr = getIbGibAddr({ ibGib: binIbGib });
-            await putInSpace({ ibGib: binIbGib, space: activeSpace });
-            await metaspace.registerNewIbGib({ ibGib: binIbGib, space: activeSpace });
-            // 2. Create or Evolve B2tFSItemIbGib_V1 candidate graph node
-            const fileName = path.basename(absFilePath);
-            const nameHash = crypto.createHash('sha256').update(fileName).digest('hex');
-            let itemRes;
-            if (committedItem && committedItem.item) {
-                itemRes = await evolveB2tFSItemIbGib({
-                    existingItem: committedItem.item,
-                    dataToUpdate: {
-                        fileHash,
-                    },
-                    rel8nsToUpdate: {
-                        bin: [binAddr],
-                    },
-                });
-            }
-            else {
-                itemRes = await createB2tFSItemIbGib({
-                    fsType: 'file',
-                    name: fileName,
-                    data: {
-                        nameHash,
-                        fileHash,
-                        fileEncoding: 'utf8',
-                    },
-                    rel8ns: {
-                        bin: [binAddr],
-                    },
-                });
-            }
-            const itemIbGib = itemRes.newIbGib;
-            const itemAddr = getIbGibAddr({ ibGib: itemIbGib });
-            await persistTransformResult({ resTransform: itemRes, space: activeSpace });
-            await metaspace.registerNewIbGib({ ibGib: itemIbGib, space: activeSpace });
-            if (!stagedItemAddrs.includes(itemAddr)) {
-                stagedItemAddrs.push(itemAddr);
-            }
-            stagedPathsMap[relPath] = {
-                itemAddr,
-                binAddr,
-                fileHash,
-                fsType: 'file',
-                stagedAt: new Date().toISOString(),
-            };
-            newlyStagedPaths.push(relPath);
-            if (!quiet) {
-                console.log(`staged: ${relPath}`);
-            }
-        }
-        // 3. Update B2tFSIndexIbGib_V1 in activeSpace & localSpace
-        const updatedIndex = await updateB2tFSIndexIbGib({
-            space: activeSpace,
-            metaspace,
-            indexIbGib,
-            dataToUpdate: {
-                stagedPaths: stagedPathsMap,
-                staged_item: stagedItemAddrs,
-            },
-            vcsPath,
-        });
-        if (localSpace !== activeSpace) {
-            await putInSpace({ space: localSpace, ibGib: updatedIndex });
-        }
-        return {
-            stagedPaths: newlyStagedPaths,
-            stagedCount: newlyStagedPaths.length,
-        };
-    }
-    catch (error) {
-        console.error(`${lc} ${extractErrorMsg(error)} (E: 3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f)`);
-        throw error;
-    }
-    finally {
-        if (logalot) {
-            console.log(`${lc} complete. (I: 4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a)`);
-        }
-    }
-}
-// #region addCmd_walkBranchGraph
-async function addCmd_walkBranchGraph({ item, space, metaspace, currentRelPath, outMap, }) {
-    if (!item || !item.data) {
-        return;
-    }
-    const { fsType, fileHash } = item.data;
-    if (currentRelPath) {
-        outMap.set(currentRelPath, { relPath: currentRelPath, fileHash, fsType, 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 addCmd_walkBranchGraph({
-                    item: childItem,
-                    space,
-                    metaspace,
-                    currentRelPath: childRelPath,
-                    outMap,
-                });
-            }
-        }
-    }
-}
-// #endregion addCmd_walkBranchGraph
-// #region addCmd_collectFilesRecursively
-async function addCmd_collectFilesRecursively({ dirPath, baseDir, vcsFolderName, filterPatterns, outFiles, }) {
-    const entries = await fs.readdir(dirPath, { withFileTypes: true });
-    for (const entry of entries) {
-        const fullPath = path.join(dirPath, entry.name);
-        const relPath = path.relative(baseDir, fullPath).replace(/\\/g, '/');
-        // Ignore vcs storage folder, .git, and worktrees folder b
-        if (relPath === vcsFolderName || relPath.startsWith(vcsFolderName + '/') ||
-            relPath === '.git' || relPath.startsWith('.git/') ||
-            relPath === 'b' || relPath.startsWith('b/')) {
-            continue;
-        }
-        if (isPathFiltered({ relativePath: relPath, isDirectory: entry.isDirectory(), filterPatterns })) {
-            continue;
-        }
-        if (entry.isDirectory()) {
-            await addCmd_collectFilesRecursively({
-                dirPath: fullPath,
-                baseDir,
-                vcsFolderName,
-                filterPatterns,
-                outFiles,
-            });
-        }
-        else if (entry.isFile()) {
-            if (!isCommentMetadataFilename(entry.name)) {
-                outFiles.push(fullPath);
-            }
-        }
-    }
-}
-// #endregion addCmd_collectFilesRecursively
-//# sourceMappingURL=add-cmd.mjs.map

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"branch-cmd.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/branch-cmd.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuBH,MAAM,WAAW,aAAa;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAsB,gBAAgB,CAAC,EACnC,UAAU,EACV,QAAQ,EACR,SAAyB,EACzB,aAAyB,EACzB,KAAa,GAChB,GAAE,aAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CA+M/C"}

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

@@ -1,238 +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 } 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 { 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 { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
-const lcFile = `[branch-cmd]`;
-const logalot = GLOBAL_LOG_A_LOT;
-export async function executeBranchCmd({ branchName, itemPath, targetDir = process.cwd(), vcsFolderName = '.vcsgib', quiet = false, } = {}) {
-    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 = [];
-        if (branchAddrs.length > 0) {
-            for (const bAddr of branchAddrs) {
-                const bIbGib = await getIbGibWithMetaspaceFallback({
-                    addr: bAddr,
-                    space: activeBranchSpace,
-                    metaspace,
-                });
-                if (bIbGib) {
-                    branchIbGibs.push(bIbGib);
-                }
-            }
-        }
-        // 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 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) {
-                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)`);
-            }
-            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,
-        };
-    }
-    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, }) {
-    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 +0,0 @@
-{"version":3,"file":"branch-cmd.mjs","sourceRoot":"","sources":["../../../src/cli/commands/branch-cmd.mts"],"names":[],"mappings":"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"}

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

@@ -1,21 +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.
- */
-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 declare function executeCheckoutCmd({ branchName, targetDir, vcsFolderName, quiet, }?: CheckoutCmdOpts): Promise<CheckoutCmdResult>;
-//# sourceMappingURL=checkout-cmd.d.mts.map

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

@@ -1 +0,0 @@
-{"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"}