@ibgib/vcs-gib 0.0.30 → 0.0.33

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

@@ -1,174 +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 { putInSpace, getLatestAddrs } from '@ibgib/core-gib/dist/witness/space/space-helper.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 { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
-const lcFile = `[checkout-cmd]`;
-const logalot = GLOBAL_LOG_A_LOT;
-export async function executeCheckoutCmd({ branchName, targetDir = process.cwd(), vcsFolderName = '.vcsgib', quiet = false, } = {}) {
-    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 = [];
-        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>
-        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,
-            metaspace,
-        });
-        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,
-                        });
-                    }
-                }
-            }
-        }
-        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)`);
-        }
-    }
-}
-//# sourceMappingURL=checkout-cmd.mjs.map

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

@@ -1 +0,0 @@
-{"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 +0,0 @@
-/**
- * @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.
- */
-export interface CommitCmdOpts {
-    message?: string;
-    targetDir?: string;
-    vcsFolderName?: string;
-    quiet?: boolean;
-}
-export interface CommitCmdResult {
-    commitAddr: string;
-    commentAddr?: string;
-    branchName: string;
-    committedPaths: string[];
-    rootItemAddr: string;
-}
-export declare function executeCommitCmd({ message, targetDir, vcsFolderName, quiet, }?: CommitCmdOpts): Promise<CommitCmdResult>;
-//# sourceMappingURL=commit-cmd.d.mts.map

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

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

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

@@ -1,449 +0,0 @@
-/**
- * @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.
- */
-import path from 'node:path';
-import fs from 'node:fs/promises';
-import crypto from 'node:crypto';
-import { getUUID, extractErrorMsg, delay } 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 { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
-import { putInSpace, persistTransformResult } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
-import { createCommentIbGib } from '@ibgib/core-gib/dist/common/comment/comment-helper.mjs';
-import { bootstrapVcsMetaspace } from '../../bootstrap/node-bootstrap.mjs';
-import { getOrCreateBranchSpace } from '../../engine/branch/branch-space-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 { getB2tFSBranchSpaceName, resolveContextualBranchName } from '../../engine/branch/branch-helper.mjs';
-import { getB2tFSIndexIbGib, updateB2tFSIndexIbGib, getSpaceQualifiedIbGibAddr } from '../../engine/index/index-helper.mjs';
-import { isCommentMetadataFilename, extractCommentTopicName } from '../../engine/status/status-helper.mjs';
-import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
-const lcFile = `[commit-cmd]`;
-const logalot = GLOBAL_LOG_A_LOT;
-export async function executeCommitCmd({ message = '', targetDir = process.cwd(), vcsFolderName = '.vcsgib', quiet = false, } = {}) {
-    const lc = `${lcFile}[${executeCommitCmd.name}]`;
-    try {
-        if (logalot) {
-            console.log(`${lc} starting executeCommitCmd (I: 9a8b7c6d5e4f3a2b1c0d9e8f7a6b5c4d)`);
-        }
-        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: 1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d)`);
-        }
-        // 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: 3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f)`);
-        }
-        const branchName = resolveContextualBranchName({
-            targetDir: absTargetDir,
-            repoRoot,
-            indexIbGib,
-        });
-        const activeWorktreeDir = branchName === 'main' ? repoRoot : path.join(repoRoot, 'b', branchName);
-        // Target active branch space b2s_<activeBranch>
-        const { space: activeSpace } = await getOrCreateBranchSpace({
-            metaspace,
-            vcsPath,
-            branchName,
-        });
-        // Verify there are staged items
-        const stagedPathsMap = { ...(indexIbGib.data?.stagedPaths || {}) };
-        const committedPaths = Object.keys(stagedPathsMap);
-        if (committedPaths.length === 0) {
-            throw new Error(`Nothing to commit (no staged items found in index) (E: 4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a)`);
-        }
-        // Find active branch node
-        let currentBranchIbGib;
-        let currentBranchAddr;
-        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);
-                }
-            }
-            currentBranchIbGib = branchIbGibs.findLast((b) => b?.data?.name === branchName) || branchIbGibs.at(-1);
-            if (currentBranchIbGib) {
-                currentBranchAddr = getIbGibAddr({ ibGib: currentBranchIbGib });
-            }
-        }
-        const currentRootAddr = currentBranchIbGib?.rel8ns?.b2tFS_item?.at(-1) || currentBranchIbGib?.rel8ns?.b2tfs_item?.at(-1);
-        // 1. Evolve root item graph with staged items and ingest co-located .ib.*.md comment files
-        const repoName = path.basename(repoRoot) || 'root';
-        let { newRootItem, newRootAddr, ingestedCommentCount } = await commitCmd_buildEvolvedRootItem({
-            currentRootAddr,
-            stagedPathsMap,
-            space: activeSpace,
-            metaspace,
-            repoName,
-            worktreeDir: activeWorktreeDir,
-        });
-        if ((!message || message.trim().length === 0) && ingestedCommentCount === 0) {
-            throw new Error(`Commit message is required (-m "message" or companion comment files) (E: 2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e)`);
-        }
-        // 2. If CLI message is provided, attach CommentIbGib to the root b2tfs item
-        let commentAddr;
-        if (message && message.trim().length > 0) {
-            const commentRes = await createCommentIbGib({
-                text: message.trim(),
-                saveInSpace: true,
-                space: activeSpace,
-            });
-            const commentIbGib = commentRes.newIbGib;
-            commentAddr = getIbGibAddr({ ibGib: commentIbGib });
-            await metaspace.registerNewIbGib({ ibGib: commentIbGib, space: activeSpace });
-            const existingComments = newRootItem.rel8ns?.comment || [];
-            const evolveRootRes = await evolveB2tFSItemIbGib({
-                existingItem: newRootItem,
-                rel8nsToUpdate: {
-                    comment: [...existingComments, commentAddr],
-                },
-            });
-            await persistTransformResult({ resTransform: evolveRootRes, space: activeSpace });
-            await metaspace.registerNewIbGib({ ibGib: evolveRootRes.newIbGib, space: activeSpace });
-            newRootItem = evolveRootRes.newIbGib;
-            newRootAddr = getIbGibAddr({ ibGib: newRootItem });
-        }
-        // 3. Advance B2tFSBranchIbGib_V1 node inside activeSpace
-        const branchUuid = currentBranchIbGib?.data?.uuid || (await getUUID());
-        const newBranchRes = await Factory_V1.firstGen({
-            parentIbGib: currentBranchIbGib || ROOT,
-            ib: `b2tfs_branch ${branchName} v1 ${branchUuid}`,
-            data: {
-                ...(currentBranchIbGib?.data || {}),
-                name: branchName,
-                uuid: branchUuid,
-                classname: 'B2tFSBranchIbGib_V1',
-                committedAt: new Date().toISOString(),
-                committedPaths,
-            },
-            rel8ns: {
-                b2tfs_item: [newRootAddr],
-                ...(commentAddr ? { comment: [commentAddr] } : {}),
-            },
-        });
-        const newBranchIbGib = newBranchRes.newIbGib;
-        const newBranchAddr = getIbGibAddr({ ibGib: newBranchIbGib });
-        await persistTransformResult({ resTransform: newBranchRes, space: activeSpace });
-        await metaspace.registerNewIbGib({ ibGib: newBranchIbGib, space: activeSpace });
-        const sqBranchAddr = getSpaceQualifiedIbGibAddr({
-            spaceId: activeSpace.data?.spaceSubPath || activeSpace.data?.name || getB2tFSBranchSpaceName(branchName),
-            ibGibAddr: newBranchAddr,
-        });
-        // 4. Update B2tFSIndexIbGib_V1 in activeSpace & localSpace
-        const updatedIndex = await updateB2tFSIndexIbGib({
-            space: activeSpace,
-            metaspace,
-            indexIbGib,
-            dataToUpdate: {
-                stagedPaths: {},
-                staged_item: [],
-            },
-            rel8nsToUpdate: {
-                branch: [sqBranchAddr],
-                branch_tjp: [sqBranchAddr],
-            },
-            vcsPath,
-        });
-        if (localSpace !== activeSpace) {
-            await putInSpace({ space: localSpace, ibGib: updatedIndex });
-        }
-        if (!quiet) {
-            const shortGib = newBranchIbGib.gib ? newBranchIbGib.gib.slice(0, 7) : 'commit';
-            const logMsg = message ? message.trim() : '(committed)';
-            console.log(`[${branchName} ${shortGib}] ${logMsg} (I: 5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b)`);
-            console.log(` ${committedPaths.length} file(s) changed`);
-        }
-        return {
-            commitAddr: newBranchAddr,
-            commentAddr,
-            branchName,
-            committedPaths,
-            rootItemAddr: newRootAddr,
-        };
-    }
-    catch (error) {
-        console.error(`${lc} ${extractErrorMsg(error)} (E: 6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c)`);
-        throw error;
-    }
-    finally {
-        await delay(50);
-        if (logalot) {
-            console.log(`${lc} complete. (I: 7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d)`);
-        }
-    }
-}
-// #region commitCmd_buildEvolvedRootItem
-async function commitCmd_buildEvolvedRootItem({ currentRootAddr, stagedPathsMap, space, metaspace, repoName, worktreeDir, }) {
-    let ingestedCommentCount = 0;
-    const itemsByRelPath = new Map();
-    if (currentRootAddr) {
-        const currentRootItem = await getIbGibWithMetaspaceFallback({
-            addr: currentRootAddr,
-            space,
-            metaspace,
-        });
-        if (currentRootItem) {
-            await commitCmd_walkBranchGraph({
-                item: currentRootItem,
-                space,
-                metaspace,
-                currentRelPath: '',
-                outMap: itemsByRelPath,
-            });
-        }
-    }
-    // Overlay staged items
-    for (const [relPath, stagedRec] of Object.entries(stagedPathsMap)) {
-        itemsByRelPath.set(relPath, {
-            itemAddr: stagedRec.itemAddr,
-            fsType: stagedRec.fsType || 'file',
-        });
-    }
-    // 1. Ingest co-located .ib.<filename>.md comment files for staged files
-    for (const [relPath, itemRec] of itemsByRelPath.entries()) {
-        if (itemRec.fsType !== 'file') {
-            continue;
-        }
-        const dir = path.dirname(relPath);
-        const base = path.basename(relPath);
-        const commentDir = dir === '.' ? worktreeDir : path.join(worktreeDir, dir);
-        const commentFullPath = path.join(commentDir, `.ib.${base}.md`);
-        let commentText = '';
-        try {
-            commentText = await fs.readFile(commentFullPath, 'utf8');
-        }
-        catch {
-            // No comment file for this file
-            continue;
-        }
-        if (commentText.trim().length > 0) {
-            const commentRes = await createCommentIbGib({
-                text: commentText.trim(),
-                saveInSpace: true,
-                space,
-            });
-            const commentIbGib = commentRes.newIbGib;
-            const commentAddr = getIbGibAddr({ ibGib: commentIbGib });
-            await metaspace.registerNewIbGib({ ibGib: commentIbGib, space });
-            ingestedCommentCount++;
-            const currentItem = itemRec.item || await getIbGibWithMetaspaceFallback({
-                addr: itemRec.itemAddr,
-                space,
-                metaspace,
-            });
-            if (currentItem) {
-                const existingComments = currentItem.rel8ns?.comment || [];
-                const evolvedItemRes = await evolveB2tFSItemIbGib({
-                    existingItem: currentItem,
-                    rel8nsToUpdate: {
-                        comment: [...existingComments, commentAddr],
-                    },
-                });
-                await persistTransformResult({ resTransform: evolvedItemRes, space });
-                await metaspace.registerNewIbGib({ ibGib: evolvedItemRes.newIbGib, space });
-                itemRec.itemAddr = getIbGibAddr({ ibGib: evolvedItemRes.newIbGib });
-                itemRec.item = evolvedItemRes.newIbGib;
-            }
-            try {
-                await fs.unlink(commentFullPath);
-            }
-            catch {
-                // Delete failed / ignore
-            }
-        }
-    }
-    // Ensure parent folder entries exist for all items
-    const allRelPaths = Array.from(itemsByRelPath.keys());
-    for (const relPath of allRelPaths) {
-        const parts = relPath.split('/');
-        parts.pop(); // Remove file/folder name to get parent path
-        let currentFolderRel = '';
-        for (const part of parts) {
-            currentFolderRel = currentFolderRel ? `${currentFolderRel}/${part}` : part;
-            if (!itemsByRelPath.has(currentFolderRel)) {
-                itemsByRelPath.set(currentFolderRel, { itemAddr: '', fsType: 'folder' });
-            }
-        }
-    }
-    // Collect all folder paths (including root '')
-    const folderPathsSet = new Set();
-    folderPathsSet.add('');
-    for (const [relPath, itemRec] of itemsByRelPath.entries()) {
-        if (itemRec.fsType === 'folder' || relPath === '') {
-            folderPathsSet.add(relPath);
-        }
-    }
-    // Sort folders deepest path first so children folders are built before parents
-    const sortedFolders = Array.from(folderPathsSet).sort((a, b) => {
-        const depthA = a ? a.split('/').length : 0;
-        const depthB = b ? b.split('/').length : 0;
-        return depthB - depthA;
-    });
-    const createdFolderAddrs = new Map();
-    let rootFolderItem;
-    let rootFolderAddr = '';
-    for (const folderRelPath of sortedFolders) {
-        const childAddrs = [];
-        for (const [itemRelPath, itemRec] of itemsByRelPath.entries()) {
-            if (!itemRelPath || itemRelPath === folderRelPath) {
-                continue;
-            }
-            const parentRelPath = commitCmd_getParentRelPath(itemRelPath);
-            if (parentRelPath === folderRelPath) {
-                if (itemRec.fsType === 'folder') {
-                    const folderAddr = createdFolderAddrs.get(itemRelPath);
-                    if (folderAddr && !childAddrs.includes(folderAddr)) {
-                        childAddrs.push(folderAddr);
-                    }
-                }
-                else {
-                    if (itemRec.itemAddr && !childAddrs.includes(itemRec.itemAddr)) {
-                        childAddrs.push(itemRec.itemAddr);
-                    }
-                }
-            }
-        }
-        // Check for folder-level .ib.<topic>.md files in this folder
-        const folderDiskPath = folderRelPath ? path.join(worktreeDir, folderRelPath) : worktreeDir;
-        const folderCommentAddrs = [];
-        try {
-            const dirents = await fs.readdir(folderDiskPath, { withFileTypes: true });
-            for (const dirent of dirents) {
-                if (dirent.isFile() && isCommentMetadataFilename(dirent.name)) {
-                    const topicName = extractCommentTopicName(dirent.name);
-                    const isCoLocatedFileComment = itemsByRelPath.has(folderRelPath ? `${folderRelPath}/${topicName}` : topicName);
-                    if (!isCoLocatedFileComment) {
-                        const fullCommentPath = path.join(folderDiskPath, dirent.name);
-                        const commentContent = await fs.readFile(fullCommentPath, 'utf8');
-                        if (commentContent.trim().length > 0) {
-                            const commentRes = await createCommentIbGib({
-                                text: commentContent.trim(),
-                                saveInSpace: true,
-                                space,
-                            });
-                            const commentIbGib = commentRes.newIbGib;
-                            const cAddr = getIbGibAddr({ ibGib: commentIbGib });
-                            await metaspace.registerNewIbGib({ ibGib: commentIbGib, space });
-                            folderCommentAddrs.push(cAddr);
-                            ingestedCommentCount++;
-                        }
-                        try {
-                            await fs.unlink(fullCommentPath);
-                        }
-                        catch {
-                            // ignore delete error
-                        }
-                    }
-                }
-            }
-        }
-        catch {
-            // Folder may not exist on disk
-        }
-        const folderName = folderRelPath ? path.basename(folderRelPath) : repoName;
-        const nameHash = crypto.createHash('sha256').update(folderName).digest('hex');
-        const existingFolderRec = itemsByRelPath.get(folderRelPath);
-        let folderRes;
-        if (existingFolderRec && existingFolderRec.item) {
-            const oldChildAddrs = existingFolderRec.item.rel8ns?.[B2TFS_CHILD_ITEM_REL8N_NAME] || [];
-            const toRemoveChildAddrs = oldChildAddrs.filter(a => !childAddrs.includes(a));
-            const existingComments = existingFolderRec.item.rel8ns?.comment || [];
-            folderRes = await evolveB2tFSItemIbGib({
-                existingItem: existingFolderRec.item,
-                dataToUpdate: {
-                    nameHash,
-                },
-                rel8nsToUpdate: {
-                    ...(childAddrs.length > 0 ? { [B2TFS_CHILD_ITEM_REL8N_NAME]: childAddrs } : {}),
-                    ...(folderCommentAddrs.length > 0 ? { comment: [...existingComments, ...folderCommentAddrs] } : {}),
-                },
-                rel8nsToRemove: toRemoveChildAddrs.length > 0 ? { [B2TFS_CHILD_ITEM_REL8N_NAME]: toRemoveChildAddrs } : undefined,
-            });
-        }
-        else {
-            folderRes = await createB2tFSItemIbGib({
-                fsType: 'folder',
-                name: folderName,
-                data: {
-                    nameHash,
-                },
-                rel8ns: {
-                    ...(childAddrs.length > 0 ? { [B2TFS_CHILD_ITEM_REL8N_NAME]: childAddrs } : {}),
-                    ...(folderCommentAddrs.length > 0 ? { comment: folderCommentAddrs } : {}),
-                },
-            });
-        }
-        const folderItem = folderRes.newIbGib;
-        const folderAddr = getIbGibAddr({ ibGib: folderItem });
-        await persistTransformResult({ resTransform: folderRes, space });
-        await metaspace.registerNewIbGib({ ibGib: folderItem, space });
-        createdFolderAddrs.set(folderRelPath, folderAddr);
-        if (folderRelPath === '') {
-            rootFolderItem = folderItem;
-            rootFolderAddr = folderAddr;
-        }
-    }
-    return { newRootItem: rootFolderItem, newRootAddr: rootFolderAddr, ingestedCommentCount };
-}
-function commitCmd_getParentRelPath(relPath) {
-    const parts = relPath.split('/');
-    parts.pop();
-    return parts.join('/');
-}
-async function commitCmd_walkBranchGraph({ item, space, metaspace, currentRelPath, outMap, }) {
-    if (!item || !item.data) {
-        return;
-    }
-    const { fsType } = item.data;
-    const itemAddr = getIbGibAddr({ ibGib: item });
-    outMap.set(currentRelPath, { itemAddr, 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 commitCmd_walkBranchGraph({
-                    item: childItem,
-                    space,
-                    metaspace,
-                    currentRelPath: childRelPath,
-                    outMap,
-                });
-            }
-        }
-    }
-}
-// #endregion commitCmd_buildEvolvedRootItem
-//# sourceMappingURL=commit-cmd.mjs.map