@ibgib/vcs-gib 0.0.6

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

@@ -0,0 +1,286 @@
+/**
+ * @module status-cmd
+ *
+ * Command handler for `vcs status`.
+ * Compares physical workspace state against active branch snapshot tip and in-band index staging area.
+ */
+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 { 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 } from '../../engine/item/item-helper.mjs';
+import { isPathFiltered, parseFilterFileContent } from '../../engine/filter/glob-helper.mjs';
+import { getB2tFSIndexIbGib } from '../../engine/index/index-helper.mjs';
+import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
+const lcFile = `[status-cmd]`;
+const logalot = GLOBAL_LOG_A_LOT;
+export async function executeStatusCmd({ targetDir = process.cwd(), vcsFolderName = '.vcsgib', quiet = false, } = {}) {
+    const lc = `${lcFile}[${executeStatusCmd.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting executeStatusCmd (I: 7a8b9c10d11e12f13a14b15c16d17e18)`);
+        }
+        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: 4d5e6f7a8b9c10d11e12f13a14b15c6d)`);
+        }
+        // 1. Fetch authoritative B2tFSIndexIbGib_V1 directly from localSpace
+        const indexIbGib = await getB2tFSIndexIbGib({ space: localSpace, vcsPath });
+        const branchName = indexIbGib?.data?.activeBranch || 'main';
+        const activeWorktreeDir = branchName === 'main' ? repoRoot : path.join(repoRoot, 'b', branchName);
+        // Target active branch space b2s_<activeBranch>
+        const { space: activeBranchSpace } = await getOrCreateBranchSpace({
+            metaspace,
+            vcsPath,
+            branchName,
+        });
+        // 2. Extract staged items directly from in-band B2tFSIndexIbGib_V1 data
+        const stagedMap = new Map();
+        const indexStagedPaths = indexIbGib?.data?.stagedPaths || {};
+        for (const [relPath, itemRec] of Object.entries(indexStagedPaths)) {
+            stagedMap.set(relPath, itemRec);
+        }
+        // 3. Find active branch root item address from in-band branch graph node
+        let rootItemAddr;
+        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: activeBranchSpace,
+                    metaspace,
+                });
+                if (bIbGib) {
+                    branchIbGibs.push(bIbGib);
+                }
+            }
+            const activeBranchIbGib = branchIbGibs.find((b) => b?.data?.name === branchName) || branchIbGibs.at(0);
+            rootItemAddr = activeBranchIbGib?.rel8ns?.b2tfs_item?.at(0);
+        }
+        // Read .ibgibignore patterns
+        let filterPatterns = [];
+        const ignorePath = path.join(activeWorktreeDir, '.ibgibignore');
+        try {
+            const ignoreContent = await fs.readFile(ignorePath, 'utf8');
+            filterPatterns = parseFilterFileContent(ignoreContent);
+        }
+        catch {
+            // Ignore file missing is fine
+        }
+        // 4. Walk active branch graph items
+        const branchItemsMap = new Map();
+        if (rootItemAddr) {
+            const rootItem = await getIbGibWithMetaspaceFallback({
+                addr: rootItemAddr,
+                space: activeBranchSpace,
+                metaspace,
+            });
+            if (rootItem) {
+                await statusCmd_walkBranchGraph({
+                    item: rootItem,
+                    space: activeBranchSpace,
+                    metaspace,
+                    currentRelPath: '',
+                    outMap: branchItemsMap,
+                });
+            }
+        }
+        // 5. Scan physical workspace
+        const physicalItemsMap = new Map();
+        await statusCmd_scanPhysicalWorkspace({
+            dirPath: activeWorktreeDir,
+            baseDir: activeWorktreeDir,
+            vcsFolderName,
+            filterPatterns,
+            outMap: physicalItemsMap,
+        });
+        // 6. Categorize items into staged, modified, deleted, untracked
+        const staged = [];
+        const modified = [];
+        const deleted = [];
+        const untracked = [];
+        // Add staged items
+        for (const [relPath, stagedRec] of stagedMap.entries()) {
+            staged.push({
+                path: relPath,
+                fsType: stagedRec.fsType || 'file',
+                status: 'staged',
+            });
+        }
+        // Compare physical items against branch items and staged
+        for (const [relPath, physItem] of physicalItemsMap.entries()) {
+            if (stagedMap.has(relPath)) {
+                continue; // Staged item already reported
+            }
+            const branchItem = branchItemsMap.get(relPath);
+            if (!branchItem) {
+                // Not in active branch snapshot and not staged => untracked
+                untracked.push({
+                    path: relPath,
+                    fsType: physItem.isDirectory ? 'folder' : 'file',
+                    status: 'untracked',
+                });
+            }
+            else {
+                // Tracked in branch -> check if modified
+                if (!physItem.isDirectory && physItem.fileHash && branchItem.fileHash && physItem.fileHash !== branchItem.fileHash) {
+                    modified.push({
+                        path: relPath,
+                        fsType: 'file',
+                        status: 'modified',
+                    });
+                }
+            }
+        }
+        // Check for deleted items (in branch snapshot, but not in physical workspace and not staged)
+        for (const [relPath, branchItem] of branchItemsMap.entries()) {
+            if (!relPath || relPath === '.' || relPath === '') {
+                continue;
+            }
+            if (!physicalItemsMap.has(relPath) && !stagedMap.has(relPath)) {
+                deleted.push({
+                    path: relPath,
+                    fsType: branchItem.fsType,
+                    status: 'deleted',
+                });
+            }
+        }
+        if (!quiet) {
+            console.log(`On branch ${branchName} (I: 9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b)`);
+            if (staged.length > 0) {
+                console.log('\nChanges to be committed:');
+                for (const item of staged) {
+                    console.log(`  staged:   ${item.path}`);
+                }
+            }
+            if (modified.length > 0 || deleted.length > 0) {
+                console.log('\nChanges not staged for commit:');
+                for (const item of modified) {
+                    console.log(`  modified: ${item.path}`);
+                }
+                for (const item of deleted) {
+                    console.log(`  deleted:  ${item.path}`);
+                }
+            }
+            if (untracked.length > 0) {
+                console.log('\nUntracked files:');
+                for (const item of untracked) {
+                    console.log(`  untracked:${item.path}`);
+                }
+            }
+            if (staged.length === 0 && modified.length === 0 && deleted.length === 0 && untracked.length === 0) {
+                console.log('nothing to commit, working tree clean');
+            }
+        }
+        return {
+            branchName,
+            staged,
+            modified,
+            deleted,
+            untracked,
+        };
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)} (E: 5e6f7a8b9c10d11e12f13a14b15c6d7e)`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete. (I: 6f7a8b9c10d11e12f13a14b15c6d7e8f)`);
+        }
+    }
+}
+// #region statusCmd_walkBranchGraph
+async function statusCmd_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 statusCmd_walkBranchGraph({
+                    item: childItem,
+                    space,
+                    metaspace,
+                    currentRelPath: childRelPath,
+                    outMap,
+                });
+            }
+        }
+    }
+}
+// #endregion statusCmd_walkBranchGraph
+// #region statusCmd_scanPhysicalWorkspace
+async function statusCmd_scanPhysicalWorkspace({ dirPath, baseDir, vcsFolderName, filterPatterns, outMap, }) {
+    let entries = [];
+    try {
+        entries = await fs.readdir(dirPath, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const fullEntryPath = path.join(dirPath, entry.name);
+        const relPath = path.relative(baseDir, fullEntryPath).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()) {
+            outMap.set(relPath, { relPath, fullPath: fullEntryPath, isDirectory: true });
+            await statusCmd_scanPhysicalWorkspace({
+                dirPath: fullEntryPath,
+                baseDir,
+                vcsFolderName,
+                filterPatterns,
+                outMap,
+            });
+        }
+        else if (entry.isFile()) {
+            let fileHash;
+            try {
+                const fileData = await fs.readFile(fullEntryPath);
+                fileHash = crypto.createHash('sha256').update(fileData).digest('hex');
+            }
+            catch {
+                // File unreadable
+            }
+            outMap.set(relPath, { relPath, fullPath: fullEntryPath, isDirectory: false, fileHash });
+        }
+    }
+}
+// #endregion statusCmd_scanPhysicalWorkspace
+//# sourceMappingURL=status-cmd.mjs.map

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

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

package/dist/cli/vcs-cli-main.d.mts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * @module vcs-cli-main
+ *
+ * Executable CLI entry point for the `vcs` command line interface.
+ * Parses command line arguments and dispatches execution to subcommand handlers.
+ */
+export interface MainOptions {
+    argv?: string[];
+}
+export declare function showHelp(): void;
+export declare function showVersion(): void;
+export declare function main({ argv, }?: MainOptions): Promise<number>;
+//# sourceMappingURL=vcs-cli-main.d.mts.map

package/dist/cli/vcs-cli-main.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vcs-cli-main.d.mts","sourceRoot":"","sources":["../../src/cli/vcs-cli-main.mts"],"names":[],"mappings":";AACA;;;;;GAKG;AAmBH,MAAM,WAAW,WAAW;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,QAAQ,IAAI,IAAI,CAyB/B;AAED,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED,wBAAsB,IAAI,CAAC,EACvB,IAA4B,GAC/B,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyEpC"}

package/dist/cli/vcs-cli-main.mjs

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+/**
+ * @module vcs-cli-main
+ *
+ * Executable CLI entry point for the `vcs` command line interface.
+ * Parses command line arguments and dispatches execution to subcommand handlers.
+ */
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { parseVcsArgs } from './cli-arg-parser.mjs';
+import { VCS_SUBCOMMANDS } from './cli-constants.mjs';
+import { executeInitCmd } from './commands/init-cmd.mjs';
+import { executeStatusCmd } from './commands/status-cmd.mjs';
+import { executeAddCmd } from './commands/add-cmd.mjs';
+import { executeCommitCmd } from './commands/commit-cmd.mjs';
+import { executeLogCmd } from './commands/log-cmd.mjs';
+import { executeBranchCmd } from './commands/branch-cmd.mjs';
+import { executeCheckoutCmd } from './commands/checkout-cmd.mjs';
+import { AUTO_GENERATED_VERSION } from '../AUTO-GENERATED-version.mjs';
+import { GLOBAL_LOG_A_LOT } from '../vcs-gib-constants.mjs';
+const lcFile = `[vcs-cli-main]`;
+const logalot = GLOBAL_LOG_A_LOT;
+export function showHelp() {
+    const helpText = `
+vcs - Decentralized Version Control System (ibgib)
+
+Usage:
+  vcs <command> [options] [arguments]
+
+Commands:
+  init [dir]            Initialize a new ibgib repository
+  status                Show repository working tree status
+  add <path...>         Stage file/folder changes (-a, --all to stage all)
+  commit -m "message"   Record snapshot changes to the repository
+  log                   Show commit logs
+  branch [name]         List or create branches
+  checkout <branch>     Switch to a specified branch and project worktree
+
+Flags:
+  -h, --help            Show help information
+  -v, --version         Show version information
+  -m <message>          Commit message
+  -b <branch>           Target branch name
+  -a, --all             Stage all tracked/untracked files (for add)
+  -f, --force           Force operation execution
+`;
+    console.log(helpText.trim());
+}
+export function showVersion() {
+    console.log(`@ibgib/vcs-gib v${AUTO_GENERATED_VERSION}`);
+}
+export async function main({ argv = process.argv.slice(2), } = {}) {
+    const lc = `${lcFile}[${main.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d)`);
+        }
+        const parsed = parseVcsArgs(argv);
+        if (parsed.flags.help) {
+            showHelp();
+            return 0;
+        }
+        switch (parsed.command) {
+            case VCS_SUBCOMMANDS.INIT: {
+                const targetDir = parsed.positionals[0] || process.cwd();
+                await executeInitCmd({ targetDir });
+                break;
+            }
+            case VCS_SUBCOMMANDS.STATUS: {
+                const targetDir = parsed.positionals[0] || process.cwd();
+                await executeStatusCmd({ targetDir });
+                break;
+            }
+            case VCS_SUBCOMMANDS.ADD: {
+                await executeAddCmd({
+                    paths: parsed.positionals,
+                    all: parsed.flags.all,
+                });
+                break;
+            }
+            case VCS_SUBCOMMANDS.COMMIT: {
+                await executeCommitCmd({
+                    message: parsed.flags.message,
+                });
+                break;
+            }
+            case VCS_SUBCOMMANDS.LOG: {
+                const targetDir = parsed.positionals[0] || process.cwd();
+                await executeLogCmd({ targetDir });
+                break;
+            }
+            case VCS_SUBCOMMANDS.BRANCH: {
+                const branchName = parsed.positionals[0] || parsed.flags.branchName;
+                await executeBranchCmd({ branchName });
+                break;
+            }
+            case VCS_SUBCOMMANDS.CHECKOUT: {
+                const branchName = parsed.positionals[0] || parsed.flags.branchName;
+                await executeCheckoutCmd({ branchName });
+                break;
+            }
+            case VCS_SUBCOMMANDS.VERSION: {
+                showVersion();
+                break;
+            }
+            case VCS_SUBCOMMANDS.HELP:
+            default: {
+                showHelp();
+                break;
+            }
+        }
+        return 0;
+    }
+    catch (error) {
+        console.error(`Error: ${extractErrorMsg(error)} (E: 8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c)`);
+        return 1;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete. (I: 9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c)`);
+        }
+    }
+}
+// Auto-run if executed directly as entry script
+const isMainScript = process.argv[1] && (process.argv[1].endsWith('vcs-cli-main.mjs') ||
+    process.argv[1].endsWith('vcs-cli-main.mts') ||
+    process.argv[1].endsWith('vcs'));
+if (isMainScript) {
+    main().then((code) => {
+        if (code !== 0) {
+            process.exit(code);
+        }
+    }).catch(() => {
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=vcs-cli-main.mjs.map

package/dist/cli/vcs-cli-main.mjs.map

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

package/dist/engine/branch/branch-graph-helper.d.mts

@@ -0,0 +1,19 @@
+/**
+ * @module branch-graph-helper
+ *
+ * Helper for extracting dependency graphs and populating branch spaces.
+ */
+import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
+import { IbGibSpaceAny } from '@ibgib/core-gib/dist/witness/space/space-base-v1.mjs';
+import { MetaspaceService } from '@ibgib/core-gib/dist/witness/space/metaspace/metaspace-types.mjs';
+export interface PopulateBranchSpaceFromGraphOpts {
+    sourceSpace: IbGibSpaceAny;
+    targetBranchSpace: IbGibSpaceAny;
+    rootItemIbGib: IbGib_V1;
+    metaspace?: MetaspaceService;
+}
+/**
+ * Extracts the live dependency graph of rootItemIbGib from sourceSpace and persists all ibgibs into targetBranchSpace.
+ */
+export declare function populateBranchSpaceFromGraph({ sourceSpace, targetBranchSpace, rootItemIbGib, metaspace, }: PopulateBranchSpaceFromGraphOpts): Promise<void>;
+//# sourceMappingURL=branch-graph-helper.d.mts.map

package/dist/engine/branch/branch-graph-helper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-graph-helper.d.mts","sourceRoot":"","sources":["../../../src/engine/branch/branch-graph-helper.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AAErF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kEAAkE,CAAC;AAOpG,MAAM,WAAW,gCAAgC;IAC7C,WAAW,EAAE,aAAa,CAAC;IAC3B,iBAAiB,EAAE,aAAa,CAAC;IACjC,aAAa,EAAE,QAAQ,CAAC;IACxB,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAAC,EAC/C,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,SAAS,GACZ,EAAE,gCAAgC,GAAG,OAAO,CAAC,IAAI,CAAC,CAmClD"}

package/dist/engine/branch/branch-graph-helper.mjs

@@ -0,0 +1,49 @@
+/**
+ * @module branch-graph-helper
+ *
+ * Helper for extracting dependency graphs and populating branch spaces.
+ */
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { getDependencyGraph } from '@ibgib/core-gib/dist/common/other/graph-helper.mjs';
+import { putInSpace } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
+import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
+const lcFile = `[branch-graph-helper]`;
+const logalot = GLOBAL_LOG_A_LOT;
+/**
+ * Extracts the live dependency graph of rootItemIbGib from sourceSpace and persists all ibgibs into targetBranchSpace.
+ */
+export async function populateBranchSpaceFromGraph({ sourceSpace, targetBranchSpace, rootItemIbGib, metaspace, }) {
+    const lc = `${lcFile}[${populateBranchSpaceFromGraph.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d)`);
+        }
+        if (!sourceSpace || !targetBranchSpace || !rootItemIbGib) {
+            throw new Error(`sourceSpace, targetBranchSpace, and rootItemIbGib are required (E: 2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e)`);
+        }
+        const graph = await getDependencyGraph({
+            ibGib: rootItemIbGib,
+            space: sourceSpace,
+            live: true,
+        });
+        for (const [addr, ibGib] of Object.entries(graph)) {
+            await putInSpace({ space: targetBranchSpace, ibGib });
+            if (metaspace) {
+                await metaspace.registerNewIbGib({ ibGib, space: targetBranchSpace });
+            }
+        }
+        if (logalot) {
+            console.log(`${lc} Populated target branch space with ${Object.keys(graph).length} ibgibs (I: 3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f)`);
+        }
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)} (E: 4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a)`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete. (I: 5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b)`);
+        }
+    }
+}
+//# sourceMappingURL=branch-graph-helper.mjs.map

package/dist/engine/branch/branch-graph-helper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-graph-helper.mjs","sourceRoot":"","sources":["../../../src/engine/branch/branch-graph-helper.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAElF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAExF,OAAO,EAAE,UAAU,EAAE,MAAM,qDAAqD,CAAC;AAGjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,MAAM,GAAG,uBAAuB,CAAC;AACvC,MAAM,OAAO,GAAG,gBAAgB,CAAC;AASjC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,EAC/C,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,SAAS,GACsB;IAC/B,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,4BAA4B,CAAC,IAAI,GAAG,CAAC;IAC7D,IAAI,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,oDAAoD,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,CAAC,WAAW,IAAI,CAAC,iBAAiB,IAAI,CAAC,aAAa,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,sGAAsG,CAAC,CAAC;QAC5H,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC;YACnC,KAAK,EAAE,aAAa;YACpB,KAAK,EAAE,WAAW;YAClB,IAAI,EAAE,IAAI;SACb,CAAC,CAAC;QAEH,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,MAAM,UAAU,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC;YACtD,IAAI,SAAS,EAAE,CAAC;gBACZ,MAAM,SAAS,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;YAC1E,CAAC;QACL,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,uCAAuC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,+CAA+C,CAAC,CAAC;QACtI,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,eAAe,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACvF,MAAM,KAAK,CAAC;IAChB,CAAC;YAAS,CAAC;QACP,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,kDAAkD,CAAC,CAAC;QACzE,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/engine/branch/branch-helper.d.mts

@@ -0,0 +1,26 @@
+/**
+ * @module branch-helper
+ *
+ * B2tFS Branch Helper functions: dedicated branch spaces (`b2s_...`), branch creation,
+ * and branch timeline tracking.
+ */
+import { MetaspaceService } from '@ibgib/core-gib/dist/witness/space/metaspace/metaspace-types.mjs';
+import { IbGibSpaceAny } from '@ibgib/core-gib/dist/witness/space/space-base-v1.mjs';
+import { B2tFSBranchIbGib_V1 } from './branch-types.mjs';
+import { B2tFSItemIbGib_V1 } from '../item/item-types.mjs';
+export declare const B2TFS_BRANCH_SPACE_PREFIX = "b2s_";
+/**
+ * Generates a dedicated branch space name.
+ * Example: 'main' -> 'b2s_main'
+ */
+export declare function getB2tFSBranchSpaceName(branchName: string): string;
+/**
+ * Creates a new B2tFSBranchIbGib pointing to a root folder item.
+ */
+export declare function createB2tFSBranchIbGib(opts: {
+    branchName: string;
+    rootItem: B2tFSItemIbGib_V1;
+    space: IbGibSpaceAny;
+    metaspace: MetaspaceService;
+}): Promise<B2tFSBranchIbGib_V1>;
+//# sourceMappingURL=branch-helper.d.mts.map

package/dist/engine/branch/branch-helper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-helper.d.mts","sourceRoot":"","sources":["../../../src/engine/branch/branch-helper.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kEAAkE,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AAIrF,OAAO,EAAE,mBAAmB,EAA4C,MAAM,oBAAoB,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAK3D,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,gBAAgB,CAAC;CAC/B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqC/B"}

package/dist/engine/branch/branch-helper.mjs

@@ -0,0 +1,57 @@
+/**
+ * @module branch-helper
+ *
+ * B2tFS Branch Helper functions: dedicated branch spaces (`b2s_...`), branch creation,
+ * and branch timeline tracking.
+ */
+import { getUUID } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { ROOT } from '@ibgib/ts-gib/dist/V1/constants.mjs';
+import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
+import { Factory_V1 } from '@ibgib/ts-gib/dist/V1/factory.mjs';
+import { persistTransformResult } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
+import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
+const lcFile = `[branch-helper]`;
+const logalot = GLOBAL_LOG_A_LOT;
+export const B2TFS_BRANCH_SPACE_PREFIX = 'b2s_';
+/**
+ * Generates a dedicated branch space name.
+ * Example: 'main' -> 'b2s_main'
+ */
+export function getB2tFSBranchSpaceName(branchName) {
+    const safeName = branchName.replace(/[^a-zA-Z0-9_\-]/g, '_');
+    return `${B2TFS_BRANCH_SPACE_PREFIX}${safeName}`;
+}
+/**
+ * Creates a new B2tFSBranchIbGib pointing to a root folder item.
+ */
+export async function createB2tFSBranchIbGib(opts) {
+    const lc = `${lcFile}[${createB2tFSBranchIbGib.name}]`;
+    const { branchName, rootItem, space, metaspace } = opts;
+    if (!branchName || !rootItem) {
+        throw new Error(`branchName and rootItem required (E: 9012a472c9104b2d)`);
+    }
+    const uuid = await getUUID();
+    const rootAddr = getIbGibAddr({ ibGib: rootItem });
+    const data = {
+        name: branchName,
+        uuid,
+        classname: 'B2tFSBranchIbGib_V1',
+    };
+    const rel8ns = {
+        b2tfs_item: [rootAddr],
+    };
+    const res = await Factory_V1.firstGen({
+        parentIbGib: ROOT,
+        ib: `b2tfs_branch ${branchName} v1 ${uuid}`,
+        data,
+        rel8ns,
+    });
+    const branchIbGib = res.newIbGib;
+    await persistTransformResult({ resTransform: res, space });
+    await metaspace.registerNewIbGib({ ibGib: branchIbGib });
+    if (logalot) {
+        console.log(`${lc} Created branch IbGib: ${branchIbGib.ib}`);
+    }
+    return branchIbGib;
+}
+//# sourceMappingURL=branch-helper.mjs.map

package/dist/engine/branch/branch-helper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-helper.mjs","sourceRoot":"","sources":["../../../src/engine/branch/branch-helper.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,iDAAiD,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,qCAAqC,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAG/D,OAAO,EAAc,sBAAsB,EAAE,MAAM,qDAAqD,CAAC;AAEzG,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAI/D,MAAM,MAAM,GAAG,iBAAiB,CAAC;AACjC,MAAM,OAAO,GAAG,gBAAgB,CAAC;AAEjC,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAkB;IACtD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAC7D,OAAO,GAAG,yBAAyB,GAAG,QAAQ,EAAE,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAK5C;IACG,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,sBAAsB,CAAC,IAAI,GAAG,CAAC;IACvD,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAExD,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEnD,MAAM,IAAI,GAAuB;QAC7B,IAAI,EAAE,UAAU;QAChB,IAAI;QACJ,SAAS,EAAE,qBAAqB;KACnC,CAAC;IAEF,MAAM,MAAM,GAAyB;QACjC,UAAU,EAAE,CAAC,QAAQ,CAAC;KACzB,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC;QAClC,WAAW,EAAE,IAAI;QACjB,EAAE,EAAE,gBAAgB,UAAU,OAAO,IAAI,EAAE;QAC3C,IAAI;QACJ,MAAM;KACT,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,GAAG,CAAC,QAA+B,CAAC;IACxD,MAAM,sBAAsB,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,MAAM,SAAS,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IAEzD,IAAI,OAAO,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,0BAA0B,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,WAAW,CAAC;AACvB,CAAC"}