@ibgib/vcs-gib 0.0.6

package/dist/engine/filter/glob-helper.d.mts

@@ -0,0 +1,51 @@
+/**
+ * @module glob-helper
+ *
+ * Native, zero-dependency glob pattern matching engine for .ibgibignore and path filtering.
+ *
+ * Supports:
+ * - Basic wildcards: '*' (single path segment), '**' (recursive path matching), '?' (single char)
+ * - Negation/Inclusion: '!' prefix (negable matching, last match wins)
+ * - Directory matching: trailing '/' (matches directory paths only)
+ * - JS RegExp fallback: 'regexp js <pattern>' prefix
+ * - Ignore file parsing: stripping '#' comments and blank lines
+ * - Hardcoded reserved repository paths: '.vcsgib', 'b', 'ibgib', 'node_modules', '.git'
+ */
+/**
+ * Hardcoded internal repository paths that are ALWAYS ignored during workspace scans
+ * regardless of user .ibgibignore settings.
+ */
+export declare const HARDCODED_IGNORED_PATHS: string[];
+/**
+ * Converts a glob pattern string into a JavaScript RegExp.
+ */
+export declare function globToRegExp(glob: string): RegExp;
+/**
+ * Parses raw .ibgibignore file text into an array of active pattern strings.
+ * Strips blank lines and '#' comments.
+ */
+export declare function parseFilterFileContent(content: string): string[];
+/**
+ * Options passed to path filtering check.
+ */
+export interface IsPathFilteredOpts {
+    /**
+     * Relative path from repository root (e.g. 'src/utils/helper.mts' or 'b/feature-auth')
+     */
+    relativePath: string;
+    /**
+     * Whether the target path is a directory
+     */
+    isDirectory?: boolean;
+    /**
+     * Active filter patterns (e.g. from .ibgibignore)
+     */
+    filterPatterns?: string[];
+}
+/**
+ * Determines whether a relative path is filtered (ignored) based on active pattern rules.
+ * Reserved repository paths ('.vcsgib', 'b', 'ibgib') are ALWAYS ignored.
+ * Last matching rule wins for user rules (standard gitignore semantics).
+ */
+export declare function isPathFiltered({ relativePath, isDirectory, filterPatterns, }: IsPathFilteredOpts): boolean;
+//# sourceMappingURL=glob-helper.d.mts.map

package/dist/engine/filter/glob-helper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob-helper.d.mts","sourceRoot":"","sources":["../../../src/engine/filter/glob-helper.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH;;;GAGG;AACH,eAAO,MAAM,uBAAuB,UAAoD,CAAC;AAEzF;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAejD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAOhE;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAC3B,YAAY,EACZ,WAAmB,EACnB,cAAmB,GACtB,EAAE,kBAAkB,GAAG,OAAO,CA+E9B"}

package/dist/engine/filter/glob-helper.mjs

@@ -0,0 +1,132 @@
+/**
+ * @module glob-helper
+ *
+ * Native, zero-dependency glob pattern matching engine for .ibgibignore and path filtering.
+ *
+ * Supports:
+ * - Basic wildcards: '*' (single path segment), '**' (recursive path matching), '?' (single char)
+ * - Negation/Inclusion: '!' prefix (negable matching, last match wins)
+ * - Directory matching: trailing '/' (matches directory paths only)
+ * - JS RegExp fallback: 'regexp js <pattern>' prefix
+ * - Ignore file parsing: stripping '#' comments and blank lines
+ * - Hardcoded reserved repository paths: '.vcsgib', 'b', 'ibgib', 'node_modules', '.git'
+ */
+import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
+const lcFile = `[glob-helper]`;
+const logalot = GLOBAL_LOG_A_LOT;
+/**
+ * Hardcoded internal repository paths that are ALWAYS ignored during workspace scans
+ * regardless of user .ibgibignore settings.
+ */
+export const HARDCODED_IGNORED_PATHS = ['.vcsgib', 'b', 'ibgib', 'node_modules', '.git'];
+/**
+ * Converts a glob pattern string into a JavaScript RegExp.
+ */
+export function globToRegExp(glob) {
+    const raw = glob.replace(/\\/g, '/');
+    let p = raw
+        .replace(/\./g, '\\.')
+        .replace(/\?/g, '[^/]')
+        .replace(/\/\*\*\//g, '(?:/|/.+/)')
+        .replace(/\/\*\*/g, '(?:/.*)?')
+        .replace(/\*\*\//g, '(?:.*/)?')
+        .replace(/\*/g, '[^/]*');
+    if (!raw.endsWith('/')) {
+        p += '(?:/.*)?';
+    }
+    return new RegExp(`^${p}$`);
+}
+/**
+ * Parses raw .ibgibignore file text into an array of active pattern strings.
+ * Strips blank lines and '#' comments.
+ */
+export function parseFilterFileContent(content) {
+    if (!content) {
+        return [];
+    }
+    return content
+        .split(/\r?\n/)
+        .map(line => line.trim())
+        .filter(line => line.length > 0 && !line.startsWith('#'));
+}
+/**
+ * Determines whether a relative path is filtered (ignored) based on active pattern rules.
+ * Reserved repository paths ('.vcsgib', 'b', 'ibgib') are ALWAYS ignored.
+ * Last matching rule wins for user rules (standard gitignore semantics).
+ */
+export function isPathFiltered({ relativePath, isDirectory = false, filterPatterns = [], }) {
+    const lc = `${lcFile}[${isPathFiltered.name}]`;
+    if (!relativePath) {
+        return false;
+    }
+    // Normalize path separators to forward slashes
+    const normalizedPath = relativePath.replace(/\\/g, '/').replace(/^\.\//, '').replace(/\/$/, '');
+    const pathBasename = normalizedPath.split('/')[0] || normalizedPath;
+    // 0. Hardcoded reserved repository paths (ALWAYS ignored)
+    if (HARDCODED_IGNORED_PATHS.includes(pathBasename) || HARDCODED_IGNORED_PATHS.includes(normalizedPath)) {
+        return true;
+    }
+    if (filterPatterns.length === 0) {
+        return false;
+    }
+    let isIgnored = false;
+    for (const rawPattern of filterPatterns) {
+        if (!rawPattern || rawPattern.trim() === '') {
+            continue;
+        }
+        const pattern = rawPattern.trim();
+        // 1. JS RegExp fallback
+        if (pattern.startsWith('regexp js ')) {
+            const regexText = pattern.substring('regexp js '.length);
+            try {
+                const rx = new RegExp(regexText);
+                if (rx.test(normalizedPath) || rx.test(pathBasename)) {
+                    isIgnored = true;
+                }
+            }
+            catch (err) {
+                console.error(`${lc} Error evaluating regex pattern (${pattern}):`, err);
+            }
+            continue;
+        }
+        // 2. Negation / Inclusion rule ('!')
+        let isNegated = false;
+        let p = pattern;
+        if (p.startsWith('!')) {
+            isNegated = true;
+            p = p.substring(1).trim();
+        }
+        else if (p.startsWith('include ')) {
+            isNegated = true;
+            p = p.substring('include '.length).trim();
+        }
+        // 3. Directory-only pattern check
+        const directoryOnly = p.endsWith('/');
+        if (directoryOnly && !isDirectory) {
+            continue; // Skip directory-only rule for non-directories
+        }
+        const cleanPattern = directoryOnly ? p.slice(0, -1) : p;
+        // 4. Exact basename or path match check
+        let matches = false;
+        if (cleanPattern === pathBasename || normalizedPath === cleanPattern) {
+            matches = true;
+        }
+        else if (cleanPattern.includes('*') || cleanPattern.includes('?')) {
+            const rx = globToRegExp(cleanPattern);
+            matches = rx.test(normalizedPath) || rx.test(pathBasename);
+        }
+        else {
+            // Substring directory segment match (e.g., 'node_modules' matches 'a/b/node_modules/c')
+            const segments = normalizedPath.split('/');
+            matches = segments.includes(cleanPattern) || normalizedPath.endsWith('/' + cleanPattern);
+        }
+        if (matches) {
+            isIgnored = !isNegated;
+        }
+    }
+    if (logalot) {
+        console.log(`${lc} relativePath: ${relativePath}, isIgnored: ${isIgnored}`);
+    }
+    return isIgnored;
+}
+//# sourceMappingURL=glob-helper.mjs.map

package/dist/engine/filter/glob-helper.mjs.map

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

package/dist/engine/filter/glob-helper.respec.node.d.mts

@@ -0,0 +1,7 @@
+/**
+ * @module glob-helper.respec
+ *
+ * Unit tests for native zero-dependency glob pattern matching engine.
+ */
+export {};
+//# sourceMappingURL=glob-helper.respec.node.d.mts.map

package/dist/engine/filter/glob-helper.respec.node.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob-helper.respec.node.d.mts","sourceRoot":"","sources":["../../../src/engine/filter/glob-helper.respec.node.mts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/engine/filter/glob-helper.respec.node.mjs

@@ -0,0 +1,78 @@
+/**
+ * @module glob-helper.respec
+ *
+ * Unit tests for native zero-dependency glob pattern matching engine.
+ */
+import { respecfully, ifWe, iReckon } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+import { globToRegExp, parseFilterFileContent, isPathFiltered } from './glob-helper.mjs';
+const lc = `[apps/vcs-gib/src/engine/filter/glob-helper.respec.node.mts]`;
+await respecfully(lc, `Native Glob Engine (Zero-Dependency)`, async () => {
+    await respecfully(lc, `parseFilterFileContent`, async () => {
+        await ifWe(lc, `parses filter file and strips comments & blank lines`, async () => {
+            const raw = `
+            # This is a comment
+            node_modules/
+            *.log
+
+            # Another comment
+            !important.log
+            `;
+            const patterns = parseFilterFileContent(raw);
+            iReckon(lc, patterns.length).willEqual(3);
+            iReckon(lc, patterns[0]).willEqual('node_modules/');
+            iReckon(lc, patterns[1]).willEqual('*.log');
+            iReckon(lc, patterns[2]).willEqual('!important.log');
+        });
+    });
+    await respecfully(lc, `globToRegExp`, async () => {
+        await ifWe(lc, `converts wildcard pattern to RegExp`, async () => {
+            const rx = globToRegExp('*.ts');
+            iReckon(lc, rx.test('index.ts')).isGonnaBeTrue();
+            iReckon(lc, rx.test('index.js')).isGonnaBeFalse();
+        });
+        await ifWe(lc, `handles recursive double asterisk **`, async () => {
+            const rx = globToRegExp('src/**/*.ts');
+            iReckon(lc, rx.test('src/index.ts')).isGonnaBeTrue();
+            iReckon(lc, rx.test('src/engine/item/item.ts')).isGonnaBeTrue();
+            iReckon(lc, rx.test('test/index.ts')).isGonnaBeFalse();
+        });
+    });
+    await respecfully(lc, `isPathFiltered`, async () => {
+        await ifWe(lc, `filters node_modules directory`, async () => {
+            const patterns = ['node_modules/', '*.log'];
+            iReckon(lc, isPathFiltered({
+                relativePath: 'node_modules',
+                isDirectory: true,
+                filterPatterns: patterns
+            })).isGonnaBeTrue();
+            iReckon(lc, isPathFiltered({
+                relativePath: 'src/node_modules/pkg',
+                isDirectory: true,
+                filterPatterns: patterns
+            })).isGonnaBeTrue();
+        });
+        await ifWe(lc, `honors negation rule ! prefix (last match wins)`, async () => {
+            const patterns = ['*.log', '!important.log'];
+            iReckon(lc, isPathFiltered({
+                relativePath: 'debug.log',
+                filterPatterns: patterns
+            })).isGonnaBeTrue();
+            iReckon(lc, isPathFiltered({
+                relativePath: 'important.log',
+                filterPatterns: patterns
+            })).isGonnaBeFalse();
+        });
+        await ifWe(lc, `handles JS regex pattern fallback`, async () => {
+            const patterns = ['regexp js ^test_.*\\.json$'];
+            iReckon(lc, isPathFiltered({
+                relativePath: 'test_data.json',
+                filterPatterns: patterns
+            })).isGonnaBeTrue();
+            iReckon(lc, isPathFiltered({
+                relativePath: 'prod_data.json',
+                filterPatterns: patterns
+            })).isGonnaBeFalse();
+        });
+    });
+});
+//# sourceMappingURL=glob-helper.respec.node.mjs.map

package/dist/engine/filter/glob-helper.respec.node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob-helper.respec.node.mjs","sourceRoot":"","sources":["../../../src/engine/filter/glob-helper.respec.node.mts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,78 @@
+/**
+ * @module index-helper
+ *
+ * B2tFS Index Helper functions: space-qualified address formatting and branch index 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 { SpaceQualifiedIbGibAddr, B2tFSIndexIbGib_V1, B2tFSIndexData_V1, B2tFSIndexRel8ns_V1 } from './index-types.mjs';
+export declare const SOFT_ADDR_DATA_KEY_PREFIX = "@";
+export declare const SOFT_ADDR_DATA_KEY_PREFIX_SPACE_QUALIFIED = "$@";
+/**
+ * Returns a space-qualified address string.
+ * Format: `v:1^spaceId:<spaceId>^<ibGibAddr>`
+ */
+export declare function getSpaceQualifiedIbGibAddr(optsOrSpaceId: {
+    spaceId: string;
+    ibGibAddr: string;
+} | string, rawIbGibAddr?: string): SpaceQualifiedIbGibAddr;
+/**
+ * Parses a space-qualified address string into version, spaceId, ibGibAddr, ib, and gib.
+ */
+export declare function parseSpaceQualifiedIbGibAddr(optsOrSqAddr: {
+    spaceQualifiedAddr: string;
+} | {
+    sqAddr: string;
+} | string): {
+    version: number;
+    spaceId: string;
+    ibGibAddr: string;
+    ib: string;
+    gib: string;
+} | null;
+/**
+ * Helper to extract branch name from space-qualified address or raw atom ib string.
+ */
+export declare function extractBranchNameFromAddr(addr: string): string | null;
+/**
+ * Deduplicates branch entries by branch name and merges new branch addresses into existing addresses
+ * without dropping other registered branches.
+ */
+export declare function mergeBranchAddrs(existingAddrs?: string[], newAddrs?: string[]): string[];
+/**
+ * Creates a new B2tFSIndexIbGib special meta object for a space.
+ */
+export declare function createB2tFSIndexIbGib({ spaceId, activeSpaceId, activeBranch, space, metaspace, branchAddr, }: {
+    spaceId: string;
+    activeSpaceId: string;
+    activeBranch?: string;
+    space: IbGibSpaceAny;
+    metaspace: MetaspaceService;
+    branchAddr?: string;
+}): Promise<B2tFSIndexIbGib_V1>;
+/**
+ * Retrieves authoritative B2tFSIndexIbGib_V1 from space.
+ */
+export declare function getB2tFSIndexIbGib({ space, vcsPath, }: {
+    space: IbGibSpaceAny;
+    vcsPath?: string;
+}): Promise<B2tFSIndexIbGib_V1 | undefined>;
+/**
+ * Updates B2tFSIndexIbGib_V1 in space and updates local projection cache.
+ */
+export declare function updateB2tFSIndexIbGib({ space, metaspace, indexIbGib, dataToUpdate, rel8nsToUpdate, vcsPath, }: {
+    space: IbGibSpaceAny;
+    metaspace: MetaspaceService;
+    indexIbGib: B2tFSIndexIbGib_V1;
+    dataToUpdate?: Partial<B2tFSIndexData_V1>;
+    rel8nsToUpdate?: Partial<B2tFSIndexRel8ns_V1>;
+    vcsPath?: string;
+}): Promise<B2tFSIndexIbGib_V1>;
+/**
+ * Writes read-only JSON projection cache of repository index.
+ */
+export declare function writeVcsIndexProjection({ vcsPath, indexIbGib, }: {
+    vcsPath: string;
+    indexIbGib: B2tFSIndexIbGib_V1;
+}): Promise<void>;
+//# sourceMappingURL=index-helper.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index-helper.d.mts","sourceRoot":"","sources":["../../../src/engine/index/index-helper.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kEAAkE,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AAIrF,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAKxH,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,yCAAyC,OAAO,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,0BAA0B,CACtC,aAAa,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAC9D,YAAY,CAAC,EAAE,MAAM,GACtB,uBAAuB,CAKzB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CACxC,YAAY,EAAE;IAAE,kBAAkB,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAC3E;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAwCzF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAarE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC5B,aAAa,GAAE,MAAM,EAAO,EAC5B,QAAQ,GAAE,MAAM,EAAO,GACxB,MAAM,EAAE,CAiBV;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,EACxC,OAAO,EACP,aAAa,EACb,YAAY,EACZ,KAAK,EACL,SAAS,EACT,UAAU,GACb,EAAE;IACC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAuD9B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,EACrC,KAAK,EACL,OAAO,GACV,EAAE;IACC,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAwC1C;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,EACxC,KAAK,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,cAAc,EACd,OAAO,GACV,EAAE;IACC,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC1C,cAAc,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6D9B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,EAC1C,OAAO,EACP,UAAU,GACb,EAAE;IACC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,kBAAkB,CAAC;CAClC,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhB"}

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

@@ -0,0 +1,289 @@
+/**
+ * @module index-helper
+ *
+ * B2tFS Index Helper functions: space-qualified address formatting and branch index tracking.
+ */
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { getUUID, extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { ROOT } from '@ibgib/ts-gib/dist/V1/constants.mjs';
+import { Factory_V1 } from '@ibgib/ts-gib/dist/V1/factory.mjs';
+import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
+import { getIbGibsFromCache_fallbackToSpaces } from '@ibgib/core-gib/dist/common/other/ibgib-helper.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 = `[index-helper]`;
+const logalot = GLOBAL_LOG_A_LOT;
+export const SOFT_ADDR_DATA_KEY_PREFIX = '@';
+export const SOFT_ADDR_DATA_KEY_PREFIX_SPACE_QUALIFIED = '$@';
+/**
+ * Returns a space-qualified address string.
+ * Format: `v:1^spaceId:<spaceId>^<ibGibAddr>`
+ */
+export function getSpaceQualifiedIbGibAddr(optsOrSpaceId, rawIbGibAddr) {
+    if (typeof optsOrSpaceId === 'object' && optsOrSpaceId !== null) {
+        return `v:1^spaceId:${optsOrSpaceId.spaceId}^${optsOrSpaceId.ibGibAddr}`;
+    }
+    return `v:1^spaceId:${optsOrSpaceId}^${rawIbGibAddr}`;
+}
+/**
+ * Parses a space-qualified address string into version, spaceId, ibGibAddr, ib, and gib.
+ */
+export function parseSpaceQualifiedIbGibAddr(optsOrSqAddr) {
+    let sqAddr;
+    if (typeof optsOrSqAddr === 'string') {
+        sqAddr = optsOrSqAddr;
+    }
+    else if (typeof optsOrSqAddr === 'object' && optsOrSqAddr !== null) {
+        sqAddr = optsOrSqAddr.spaceQualifiedAddr || optsOrSqAddr.sqAddr;
+    }
+    if (!sqAddr || typeof sqAddr !== 'string') {
+        return null;
+    }
+    const match = sqAddr.match(/^v:(\d+)\^spaceId:([^\^]+)\^(.+)$/);
+    if (!match) {
+        return null;
+    }
+    const version = parseInt(match[1], 10);
+    const spaceId = match[2];
+    const ibGibAddr = match[3];
+    const lastCaretIndex = ibGibAddr.lastIndexOf('^');
+    if (lastCaretIndex === -1) {
+        return null;
+    }
+    const ib = ibGibAddr.substring(0, lastCaretIndex);
+    const gib = ibGibAddr.substring(lastCaretIndex + 1);
+    if (!ib || !gib) {
+        return null;
+    }
+    return {
+        version,
+        spaceId,
+        ibGibAddr,
+        ib,
+        gib,
+    };
+}
+/**
+ * Helper to extract branch name from space-qualified address or raw atom ib string.
+ */
+export function extractBranchNameFromAddr(addr) {
+    if (!addr) {
+        return null;
+    }
+    const sq = parseSpaceQualifiedIbGibAddr(addr);
+    const ib = sq ? sq.ib : (addr.includes('^') ? addr.substring(0, addr.lastIndexOf('^')) : addr);
+    if (ib && ib.startsWith('b2tfs_branch ')) {
+        const parts = ib.split(' ');
+        if (parts.length >= 2 && parts[1]) {
+            return parts[1];
+        }
+    }
+    return null;
+}
+/**
+ * Deduplicates branch entries by branch name and merges new branch addresses into existing addresses
+ * without dropping other registered branches.
+ */
+export function mergeBranchAddrs(existingAddrs = [], newAddrs = []) {
+    const map = new Map();
+    for (const addr of existingAddrs) {
+        if (!addr) {
+            continue;
+        }
+        const bName = extractBranchNameFromAddr(addr) || addr;
+        map.set(bName, addr);
+    }
+    for (const addr of newAddrs) {
+        if (!addr) {
+            continue;
+        }
+        const bName = extractBranchNameFromAddr(addr) || addr;
+        map.set(bName, addr);
+    }
+    return Array.from(map.values());
+}
+/**
+ * Creates a new B2tFSIndexIbGib special meta object for a space.
+ */
+export async function createB2tFSIndexIbGib({ spaceId, activeSpaceId, activeBranch, space, metaspace, branchAddr, }) {
+    const lc = `${lcFile}[${createB2tFSIndexIbGib.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d)`);
+        }
+        const uuid = await getUUID();
+        const data = {
+            mySpaceId: spaceId,
+            activeSpaceId,
+            activeBranch,
+            uuid,
+            classname: 'B2tFSIndexIbGib_V1',
+            '$@branch': [],
+            stagedPaths: {},
+            staged_item: [],
+        };
+        const rel8ns = {};
+        if (branchAddr) {
+            const sqBranchAddr = branchAddr.startsWith('v:1^spaceId:')
+                ? branchAddr
+                : getSpaceQualifiedIbGibAddr({
+                    spaceId: space.data?.spaceSubPath || space.data?.name || spaceId,
+                    ibGibAddr: branchAddr,
+                });
+            rel8ns.branch = [sqBranchAddr];
+            rel8ns.branch_tjp = [sqBranchAddr];
+        }
+        const res = await Factory_V1.firstGen({
+            parentIbGib: ROOT,
+            ib: `meta special b2tfs_index ${uuid}`,
+            data,
+            rel8ns: Object.keys(rel8ns).length > 0 ? rel8ns : undefined,
+        });
+        const indexIbGib = res.newIbGib;
+        await persistTransformResult({ resTransform: res, space });
+        await metaspace.registerNewIbGib({ ibGib: indexIbGib });
+        if (logalot) {
+            console.log(`${lc} Created index IbGib: ${indexIbGib.ib} (I: 4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e)`);
+        }
+        return indexIbGib;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)} (E: 5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f)`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete. (I: 6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a)`);
+        }
+    }
+}
+/**
+ * Retrieves authoritative B2tFSIndexIbGib_V1 from space.
+ */
+export async function getB2tFSIndexIbGib({ space, vcsPath, }) {
+    const lc = `${lcFile}[${getB2tFSIndexIbGib.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b)`);
+        }
+        if (!vcsPath) {
+            return undefined;
+        }
+        const projPath = path.join(vcsPath, 'vcs_index_projection.json');
+        let indexAddr;
+        try {
+            const raw = await fs.readFile(projPath, 'utf8');
+            const parsed = JSON.parse(raw);
+            indexAddr = parsed.indexAddr;
+        }
+        catch {
+            return undefined;
+        }
+        if (!indexAddr) {
+            return undefined;
+        }
+        const ibgibs = await getIbGibsFromCache_fallbackToSpaces({
+            addrs: [indexAddr],
+            space,
+        });
+        const indexIbGib = ibgibs?.at(0);
+        return indexIbGib;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)} (E: 8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c)`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete. (I: 9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d)`);
+        }
+    }
+}
+/**
+ * Updates B2tFSIndexIbGib_V1 in space and updates local projection cache.
+ */
+export async function updateB2tFSIndexIbGib({ space, metaspace, indexIbGib, dataToUpdate, rel8nsToUpdate, vcsPath, }) {
+    const lc = `${lcFile}[${updateB2tFSIndexIbGib.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e)`);
+        }
+        const mergedData = {
+            ...(indexIbGib.data || {
+                mySpaceId: space.data?.uuid || '',
+                activeSpaceId: '',
+                uuid: await getUUID(),
+            }),
+            ...dataToUpdate,
+        };
+        const mergedRel8ns = {
+            ...(indexIbGib.rel8ns || {}),
+            ...rel8nsToUpdate,
+        };
+        if (rel8nsToUpdate?.branch || indexIbGib.rel8ns?.branch) {
+            mergedRel8ns.branch = mergeBranchAddrs(indexIbGib.rel8ns?.branch || [], rel8nsToUpdate?.branch || []);
+        }
+        if (rel8nsToUpdate?.branch_tjp || indexIbGib.rel8ns?.branch_tjp) {
+            mergedRel8ns.branch_tjp = mergeBranchAddrs(indexIbGib.rel8ns?.branch_tjp || [], rel8nsToUpdate?.branch_tjp || []);
+        }
+        delete mergedRel8ns.past;
+        const res = await Factory_V1.firstGen({
+            parentIbGib: ROOT,
+            ib: indexIbGib.ib,
+            data: mergedData,
+            rel8ns: mergedRel8ns,
+        });
+        const newIndexIbGib = res.newIbGib;
+        await persistTransformResult({ resTransform: res, space });
+        await metaspace.registerNewIbGib({ ibGib: newIndexIbGib });
+        if (vcsPath) {
+            await writeVcsIndexProjection({ vcsPath, indexIbGib: newIndexIbGib });
+        }
+        return newIndexIbGib;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)} (E: 1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f)`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete. (I: 2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a)`);
+        }
+    }
+}
+/**
+ * Writes read-only JSON projection cache of repository index.
+ */
+export async function writeVcsIndexProjection({ vcsPath, indexIbGib, }) {
+    const lc = `${lcFile}[${writeVcsIndexProjection.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b)`);
+        }
+        await fs.mkdir(vcsPath, { recursive: true });
+        const indexAddr = getIbGibAddr({ ibGib: indexIbGib });
+        const projectionObj = {
+            _isReadOnlyProjection: true,
+            _comment: 'STRICTLY READ-ONLY PROJECTION GENERATED FROM B2TFSINDEXIBGIB_V1 IN LOCALSPACE',
+            indexAddr,
+            spaceId: indexIbGib.data?.mySpaceId,
+            activeBranch: indexIbGib.data?.activeBranch || 'main',
+            stagedCount: (indexIbGib.data?.staged_item || []).length,
+            stagedPaths: indexIbGib.data?.stagedPaths || {},
+            updatedAt: new Date().toISOString(),
+        };
+        const projFile = path.join(vcsPath, 'vcs_index_projection.json');
+        await fs.writeFile(projFile, JSON.stringify(projectionObj, null, 2), 'utf8');
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)} (E: 4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c)`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete. (I: 5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d)`);
+        }
+    }
+}
+//# sourceMappingURL=index-helper.mjs.map