@ibgib/vcs-gib 0.0.6

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

@@ -0,0 +1,333 @@
+/**
+ * @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, getUUID } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { Factory_V1 } from '@ibgib/ts-gib/dist/V1/factory.mjs';
+import { ROOT } from '@ibgib/ts-gib/dist/V1/constants.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 { getB2tFSItemIb } from '../../engine/item/item-atom-helper.mjs';
+import { B2TFS_CHILD_ITEM_REL8N_NAME } from '../../engine/item/item-types.mjs';
+import { getIbGibWithMetaspaceFallback } 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 = indexIbGib.data?.activeBranch || 'main';
+        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.find((b) => b?.data?.name === activeBranch) || branchIbGibs.at(0);
+            const rootItemAddr = activeBranchIbGib?.rel8ns?.b2tfs_item?.at(0);
+            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.resolve(activeWorktreeDir, 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 (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 B2tFSItemIbGib_V1 candidate graph node
+            const fileName = path.basename(absFilePath);
+            const fileNameSansExt = path.parse(fileName).name;
+            const fileExt = path.parse(fileName).ext.replace(/^\./, '');
+            const nameHash = crypto.createHash('sha256').update(fileName).digest('hex');
+            const itemRes = await Factory_V1.firstGen({
+                parentIbGib: ROOT,
+                ib: getB2tFSItemIb('file', fileName, nameHash),
+                data: {
+                    name: fileName,
+                    nameHash,
+                    fsType: 'file',
+                    fileNameSansExt,
+                    fileExt,
+                    fileHash,
+                    fileEncoding: 'utf8',
+                    diffTransactionId: await getUUID(),
+                    uuid: await getUUID(),
+                    classname: 'B2tFSItemIbGib_V1',
+                },
+                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 });
+    }
+    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()) {
+            outFiles.push(fullPath);
+        }
+    }
+}
+// #endregion addCmd_collectFilesRecursively
+//# sourceMappingURL=add-cmd.mjs.map

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

@@ -0,0 +1 @@
+{"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-checkout-cmd.respec.node.d.mts

@@ -0,0 +1,7 @@
+/**
+ * @module branch-checkout-cmd.respec
+ *
+ * Unit tests for `vcs branch` and `vcs checkout` command handlers & worktree projections.
+ */
+export {};
+//# sourceMappingURL=branch-checkout-cmd.respec.node.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"branch-checkout-cmd.respec.node.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/branch-checkout-cmd.respec.node.mts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/cli/commands/branch-checkout-cmd.respec.node.mjs

@@ -0,0 +1,288 @@
+/**
+ * @module branch-checkout-cmd.respec
+ *
+ * Unit tests for `vcs branch` and `vcs checkout` command handlers & worktree projections.
+ */
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { respecfully, ifWe, iReckon } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+import { executeInitCmd } from './init-cmd.mjs';
+import { executeAddCmd } from './add-cmd.mjs';
+import { executeCommitCmd } from './commit-cmd.mjs';
+import { executeBranchCmd } from './branch-cmd.mjs';
+import { executeCheckoutCmd } from './checkout-cmd.mjs';
+import { executeStatusCmd } from './status-cmd.mjs';
+const lc = `[apps/vcs-gib/src/cli/commands/branch-checkout-cmd.respec.node.mts]`;
+await respecfully(lc, `vcs branch and vcs checkout Command Handlers`, async () => {
+    await ifWe(lc, `lists default branch main for new repository`, async () => {
+        const testDir = path.join(process.cwd(), '.test_branch_checkout_1');
+        const vcsFolderName = '.vcsgib_test_bc_1';
+        try {
+            await executeInitCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            const branchRes = await executeBranchCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, branchRes.branches.length).willEqual(1);
+            iReckon(lc, branchRes.branches[0].name).willEqual('main');
+            iReckon(lc, branchRes.branches[0].isActive).isGonnaBeTrue();
+        }
+        finally {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+    });
+    await ifWe(lc, `creates new branch from active branch root item and rejects duplicates`, async () => {
+        const testDir = path.join(process.cwd(), '.test_branch_checkout_2');
+        const vcsFolderName = '.vcsgib_test_bc_2';
+        try {
+            await executeInitCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            // Create feature branch
+            const createRes = await executeBranchCmd({
+                branchName: 'feature-auth',
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, createRes.createdBranchName).willEqual('feature-auth');
+            iReckon(lc, Boolean(createRes.createdBranchAddr)).isGonnaBeTrue();
+            // List branches
+            const listRes = await executeBranchCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, listRes.branches.length).willEqual(2);
+            const featureBranch = listRes.branches.find(b => b.name === 'feature-auth');
+            iReckon(lc, Boolean(featureBranch)).isGonnaBeTrue();
+            iReckon(lc, featureBranch?.isActive).isGonnaBeFalse();
+            // Verify dedicated branch space subfolders exist in .vcsgib
+            const mainSpaceDir = path.join(testDir, vcsFolderName, 'ibgib', 'b2s_main');
+            const featureSpaceDir = path.join(testDir, vcsFolderName, 'ibgib', 'b2s_feature-auth');
+            const mainSpaceExists = await fs.stat(mainSpaceDir).then(s => s.isDirectory()).catch(() => fs.stat(path.join(testDir, vcsFolderName, 'b2s_main')).then(s => s.isDirectory()).catch(() => false));
+            const featureSpaceExists = await fs.stat(featureSpaceDir).then(s => s.isDirectory()).catch(() => fs.stat(path.join(testDir, vcsFolderName, 'b2s_feature-auth')).then(s => s.isDirectory()).catch(() => false));
+            iReckon(lc, mainSpaceExists).isGonnaBeTrue();
+            iReckon(lc, featureSpaceExists).isGonnaBeTrue();
+            // Duplicate branch attempt
+            let errorThrown = false;
+            try {
+                await executeBranchCmd({
+                    branchName: 'feature-auth',
+                    targetDir: testDir,
+                    vcsFolderName,
+                    quiet: true,
+                });
+            }
+            catch (err) {
+                errorThrown = true;
+                iReckon(lc, err.message).includes("already exists");
+            }
+            iReckon(lc, errorThrown).isGonnaBeTrue();
+        }
+        finally {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+    });
+    await ifWe(lc, `switches active branch with checkout and projects branch snapshot onto worktree subfolder`, async () => {
+        const testDir = path.join(process.cwd(), '.test_branch_checkout_3');
+        const vcsFolderName = '.vcsgib_test_bc_3';
+        try {
+            await executeInitCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            // Commit a file on main
+            await fs.writeFile(path.join(testDir, 'app.ts'), 'console.log("Main");', 'utf8');
+            await executeAddCmd({
+                paths: ['app.ts'],
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            await executeCommitCmd({
+                message: 'Add app.ts on main',
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            // Create branch feature-ui
+            await executeBranchCmd({
+                branchName: 'feature-ui',
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            // Checkout feature-ui
+            const checkoutRes = await executeCheckoutCmd({
+                branchName: 'feature-ui',
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, checkoutRes.previousBranch).willEqual('main');
+            iReckon(lc, checkoutRes.currentBranch).willEqual('feature-ui');
+            const expectedWorktree = path.join(testDir, 'b', 'feature-ui');
+            iReckon(lc, checkoutRes.worktreePath).willEqual(expectedWorktree);
+            // Verify project file exists in worktree path
+            const projectedFile = path.join(expectedWorktree, 'app.ts');
+            const fileContent = await fs.readFile(projectedFile, 'utf8');
+            iReckon(lc, fileContent).willEqual('console.log("Main");');
+            // Verify active branch in status
+            const statusRes = await executeStatusCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, statusRes.branchName).willEqual('feature-ui');
+            // Verify branch list displays ALL branches while on feature-ui
+            const branchListOnFeature = await executeBranchCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, branchListOnFeature.branches.length).willEqual(2);
+            iReckon(lc, branchListOnFeature.branches.map(b => b.name)).includes('main');
+            iReckon(lc, branchListOnFeature.branches.map(b => b.name)).includes('feature-ui');
+            // Make a commit on feature-ui branch
+            await fs.writeFile(path.join(expectedWorktree, 'ui.ts'), 'export const ui = 1;', 'utf8');
+            await executeAddCmd({
+                paths: ['ui.ts'],
+                targetDir: expectedWorktree,
+                vcsFolderName,
+                quiet: true,
+            });
+            await executeCommitCmd({
+                message: 'Add ui.ts on feature-ui',
+                targetDir: expectedWorktree,
+                vcsFolderName,
+                quiet: true,
+            });
+            // Verify branch list after commit on feature-ui still displays ALL branches
+            const branchListAfterCommit = await executeBranchCmd({
+                targetDir: expectedWorktree,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, branchListAfterCommit.branches.length).willEqual(2);
+            // Switch back to main
+            const switchBackRes = await executeCheckoutCmd({
+                branchName: 'main',
+                targetDir: expectedWorktree,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, switchBackRes.currentBranch).willEqual('main');
+            iReckon(lc, switchBackRes.worktreePath).willEqual(testDir);
+            // Verify branch list displays ALL branches while on main after feature-ui commit
+            const branchListOnMain = await executeBranchCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, branchListOnMain.branches.length).willEqual(2);
+            iReckon(lc, branchListOnMain.branches.map(b => b.name)).includes('main');
+            iReckon(lc, branchListOnMain.branches.map(b => b.name)).includes('feature-ui');
+            // Switch back to feature-ui seamlessly
+            const switchAgainRes = await executeCheckoutCmd({
+                branchName: 'feature-ui',
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, switchAgainRes.currentBranch).willEqual('feature-ui');
+        }
+        finally {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+    });
+    await ifWe(lc, `rejects checkout when branch does not exist or branchName missing`, async () => {
+        const testDir = path.join(process.cwd(), '.test_branch_checkout_4');
+        const vcsFolderName = '.vcsgib_test_bc_4';
+        try {
+            await executeInitCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            let err1 = false;
+            try {
+                await executeCheckoutCmd({
+                    branchName: '',
+                    targetDir: testDir,
+                    vcsFolderName,
+                    quiet: true,
+                });
+            }
+            catch (err) {
+                err1 = true;
+                iReckon(lc, err.message).includes('Branch name is required');
+            }
+            iReckon(lc, err1).isGonnaBeTrue();
+            let err2 = false;
+            try {
+                await executeCheckoutCmd({
+                    branchName: 'non-existent-branch',
+                    targetDir: testDir,
+                    vcsFolderName,
+                    quiet: true,
+                });
+            }
+            catch (err) {
+                err2 = true;
+                iReckon(lc, err.message).includes("does not exist");
+            }
+            iReckon(lc, err2).isGonnaBeTrue();
+        }
+        finally {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+    });
+    await ifWe(lc, `lists branches silently on secondary branch without error noise`, async () => {
+        const testDir = path.join(process.cwd(), '.test_branch_checkout_secondary');
+        const vcsFolderName = '.vcsgib_test_bc_sec';
+        try {
+            await executeInitCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            // Create and checkout secondary branch feature-math
+            await executeBranchCmd({
+                branchName: 'feature-math',
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            await executeCheckoutCmd({
+                branchName: 'feature-math',
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            // Run branch list while on secondary branch
+            const listRes = await executeBranchCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, listRes.branches.length).willEqual(2);
+            const mathBranch = listRes.branches.find(b => b.name === 'feature-math');
+            const mainBranch = listRes.branches.find(b => b.name === 'main');
+            iReckon(lc, mathBranch?.isActive).isGonnaBeTrue();
+            iReckon(lc, mainBranch?.isActive).isGonnaBeFalse();
+        }
+        finally {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=branch-checkout-cmd.respec.node.mjs.map