@ibgib/vcs-gib 0.0.30 → 0.0.32

package/src/engine/index/index-types.mts

@@ -1,66 +0,0 @@
-/**
- * @module index-types
- * 
- * Space-qualified address and B2tFS index type definitions.
- */
-
-import { IbGibAddr } from '@ibgib/ts-gib/dist/types.mjs';
-import { IbGibData_V1, IbGibRel8ns_V1, IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
-
-/**
- * Format: v:1^spaceId:<spaceId>^<ibGibAddr>
- */
-export type SpaceQualifiedIbGibAddr = string;
-
-export interface B2tFSStagedItemRecord {
-    itemAddr: string;
-    binAddr?: string;
-    fileHash?: string;
-    fsType: 'file' | 'folder';
-    stagedAt: string;
-}
-
-export interface B2tFSIndexData_V1 extends IbGibData_V1 {
-    /**
-     * Space UUID containing this index
-     */
-    mySpaceId: string;
-    /**
-     * Currently active branch space UUID
-     */
-    activeSpaceId: string;
-    /**
-     * Active branch name (e.g. 'main')
-     */
-    activeBranch?: string;
-    /**
-     * Space UUID from which this space forked
-     */
-    ancestorSpaceId?: string;
-    /**
-     * Soft references to branch TJPs: $@branch = [SpaceQualifiedIbGibAddr, ...]
-     */
-    '$@branch'?: SpaceQualifiedIbGibAddr[];
-    /**
-     * Staged paths lookup table
-     */
-    stagedPaths?: { [relPath: string]: B2tFSStagedItemRecord };
-    /**
-     * Staged candidate item addresses
-     */
-    staged_item?: IbGibAddr[];
-}
-
-export interface B2tFSIndexRel8ns_V1 extends IbGibRel8ns_V1 {
-    /**
-     * Local branch TJP address for this space
-     */
-    branch_tjp?: IbGibAddr[];
-    /**
-     * Active or registered branch IbGib addresses
-     */
-    branch?: IbGibAddr[];
-}
-
-export interface B2tFSIndexIbGib_V1 extends IbGib_V1<B2tFSIndexData_V1, B2tFSIndexRel8ns_V1> {
-}

package/src/engine/item/item-atom-helper.mts

@@ -1,30 +0,0 @@
-/**
- * @module item-atom-helper
- * 
- * Helper functions enforcing canonical space-delimited `ib` atom formulas.
- * 
- * Formula: `[atom] [fsType] [saferName] [saferNameVersion] [nameHash]`
- * Example: `b2tfs_item file index_mts v1 a745323851634de188beaebdcb85cbb9`
- */
-
-export const B2TFS_ITEM_ATOM = 'b2tfs_item';
-export const B2TFS_ITEM_SAFER_NAME_VERSION_V1 = 'v1';
-
-export function getB2tFSItemSaferName(rawName: string): string {
-    if (!rawName) { return 'unnamed'; }
-    // Clean to alphanumeric and underscores/dashes/dots
-    const safe = rawName.replace(/[^a-zA-Z0-9_\-\.]/g, '_');
-    return safe.slice(0, 32);
-}
-
-/**
- * Returns canonical `ib` metadata string for a B2tFS item.
- * 
- * @param fsType 'file' or 'folder'
- * @param name raw file/folder name
- * @param nameHash SHA-256 hash of name
- */
-export function getB2tFSItemIb(fsType: 'file' | 'folder', name: string, nameHash: string): string {
-    const saferName = getB2tFSItemSaferName(name);
-    return `${B2TFS_ITEM_ATOM} ${fsType} ${saferName} ${B2TFS_ITEM_SAFER_NAME_VERSION_V1} ${nameHash}`;
-}

package/src/engine/item/item-helper.mts

@@ -1,544 +0,0 @@
-/**
- * @module item-helper
- *
- * B2tFS Item Helper functions: graph diff generation, filesystem projection materialization,
- * and two-pass transform application.
- */
-
-import fs from 'node:fs/promises';
-import path from 'node:path';
-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 { mut8 } from '@ibgib/ts-gib/dist/V1/transforms/mut8.mjs';
-import { rel8 } from '@ibgib/ts-gib/dist/V1/transforms/rel8.mjs';
-import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
-import { TransformResult, IbGibAddr } from '@ibgib/ts-gib/dist/types.mjs';
-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 { isIbGib } from '@ibgib/core-gib/dist/common/other/ibgib-helper.mjs';
-import { persistTransformResult, getFromSpace } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
-import { reifyDependencyGraph } from '@ibgib/core-gib/dist/common/other/graph-helper.mjs';
-
-import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
-import { parseSpaceQualifiedIbGibAddr } from '../index/index-helper.mjs';
-import { B2TFS_ITEM_ATOM, getB2tFSItemIb } from './item-atom-helper.mjs';
-import {
-    B2tFSItemIbGib_V1, B2tFSItemData_V1, B2tFSItemRel8ns_V1,
-    B2TFS_CHILD_ITEM_REL8N_NAME, BINARY_REL8N_NAME, B2tFSItemDiffInfo
-} from './item-types.mjs';
-
-const logalot = GLOBAL_LOG_A_LOT;
-const lcFile = `[item-helper]`;
-
-export function isB2tFSItemIbGib(x: any): x is B2tFSItemIbGib_V1 {
-    if (!x) { return false; }
-    if (!isIbGib(x)) { return false; }
-    return x.ib.startsWith(B2TFS_ITEM_ATOM) || x.data?.classname === 'B2tFSItemIbGib_V1';
-}
-
-export interface CreateB2tFSItemIbGibOpts {
-    fsType: 'file' | 'folder';
-    name: string;
-    data?: Partial<B2tFSItemData_V1>;
-    rel8ns?: Partial<B2tFSItemRel8ns_V1>;
-}
-
-export interface EvolveB2tFSItemIbGibOpts {
-    existingItem: B2tFSItemIbGib_V1;
-    dataToUpdate?: Partial<B2tFSItemData_V1>;
-    rel8nsToUpdate?: Partial<B2tFSItemRel8ns_V1>;
-    rel8nsToRemove?: Partial<B2tFSItemRel8ns_V1>;
-}
-
-/**
- * Creates a brand-new B2tFSItemIbGib_V1 node using Factory_V1.firstGen with TJP, DNA, and nCounter.
- * Used ONLY for brand-new files or folders.
- */
-export async function createB2tFSItemIbGib({
-    fsType,
-    name,
-    data,
-    rel8ns,
-}: CreateB2tFSItemIbGibOpts): Promise<TransformResult<IbGib_V1>> {
-    const lc = `${lcFile}[${createB2tFSItemIbGib.name}]`;
-    try {
-        if (logalot) {
-            console.log(`${lc} starting... (I: 8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d)`);
-        }
-
-        if (!fsType || !name) {
-            throw new Error(`fsType and name are required (E: 9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e)`);
-        }
-
-        const nameHash = data?.nameHash || crypto.createHash('sha256').update(name).digest('hex');
-        const uuid = data?.uuid || (await getUUID());
-        const diffTransactionId = data?.diffTransactionId || (await getUUID());
-
-        let fileNameSansExt: string | undefined;
-        let fileExt: string | undefined;
-        if (fsType === 'file') {
-            fileNameSansExt = path.parse(name).name;
-            fileExt = path.parse(name).ext.replace(/^\./, '');
-        }
-
-        const itemData: B2tFSItemData_V1 = {
-            name,
-            nameHash,
-            fsType,
-            diffTransactionId,
-            uuid,
-            classname: 'B2tFSItemIbGib_V1',
-            ...(fsType === 'file' ? { fileNameSansExt, fileExt } : {}),
-            ...data,
-        };
-
-        const ib = getB2tFSItemIb(fsType, name, nameHash);
-
-        const res = await Factory_V1.firstGen({
-            parentIbGib: Factory_V1.primitive({ ib: B2TFS_ITEM_ATOM }),
-            ib,
-            data: itemData,
-            rel8ns: rel8ns as any,
-            tjp: { timestamp: true, uuid: true },
-            dna: true,
-            nCounter: true,
-        });
-
-        if (logalot) {
-            console.log(`${lc} Created new B2tFSItemIbGib: ${res.newIbGib.ib}^${res.newIbGib.gib} (I: 0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f)`);
-        }
-
-        return res;
-    } catch (error) {
-        console.error(`${lc} ${extractErrorMsg(error)} (E: 1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a)`);
-        throw error;
-    } finally {
-        if (logalot) {
-            console.log(`${lc} complete. (I: 2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b)`);
-        }
-    }
-}
-
-/**
- * Evolves an existing B2tFSItemIbGib_V1 node using mut8 (for data/hash updates)
- * and rel8 (for binary/child link updates) with DNA, nCounter, and timeline tracking.
- * Populates rel8ns.past and rel8ns.ancestor, preserving the item's TJP to generate
- * composite two-part timeline gib addresses (<tjpGib>^<punctiliarGib>).
- */
-export async function evolveB2tFSItemIbGib({
-    existingItem,
-    dataToUpdate,
-    rel8nsToUpdate,
-    rel8nsToRemove,
-}: EvolveB2tFSItemIbGibOpts): Promise<TransformResult<IbGib_V1>> {
-    const lc = `${lcFile}[${evolveB2tFSItemIbGib.name}]`;
-    try {
-        if (logalot) {
-            console.log(`${lc} starting... (I: 3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c)`);
-        }
-
-        if (!existingItem || !existingItem.ib || !existingItem.gib) {
-            throw new Error(`existingItem with valid ib and gib is required (E: 4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d)`);
-        }
-
-        let currentItem: B2tFSItemIbGib_V1 = existingItem;
-        const dnas: IbGib_V1[] = [];
-        const intermediateIbGibs: IbGib_V1[] = [];
-
-        // Ensure rel8ns.ancestor is populated if missing
-        if (!currentItem.rel8ns?.ancestor || currentItem.rel8ns.ancestor.length === 0) {
-            currentItem = {
-                ...currentItem,
-                rel8ns: {
-                    ...(currentItem.rel8ns || {}),
-                    ancestor: [`${B2TFS_ITEM_ATOM}^gib`],
-                },
-            };
-        }
-
-        const hasDataChanges = dataToUpdate && Object.keys(dataToUpdate).length > 0;
-        const hasRel8nsChanges = (rel8nsToUpdate && Object.keys(rel8nsToUpdate).length > 0) ||
-            (rel8nsToRemove && Object.keys(rel8nsToRemove).length > 0);
-
-        // If neither data nor rel8ns explicitly specified, update diffTransactionId to evolve timeline
-        const patchData: Partial<B2tFSItemData_V1> = {
-            ...(dataToUpdate || {}),
-            diffTransactionId: dataToUpdate?.diffTransactionId || (await getUUID()),
-        };
-
-        // Pass 1: mut8 for data/hash updates
-        const resMut8 = await mut8({
-            src: currentItem,
-            dataToAddOrPatch: patchData,
-            dna: true,
-            nCounter: patchData.n ? false : true, // if we manually set data.n, turn nCounter off
-        });
-
-        currentItem = resMut8.newIbGib as B2tFSItemIbGib_V1;
-        if (resMut8.dnas) { dnas.push(...resMut8.dnas); }
-
-        // Pass 2: rel8 for binary/child link updates if rel8ns specified
-        if (hasRel8nsChanges) {
-            intermediateIbGibs.push(currentItem);
-
-            const resRel8 = await rel8({
-                src: currentItem,
-                rel8nsToAddByAddr: rel8nsToUpdate as any,
-                rel8nsToRemoveByAddr: rel8nsToRemove as any,
-                dna: true,
-                nCounter: true,
-            });
-
-            currentItem = resRel8.newIbGib as B2tFSItemIbGib_V1;
-            if (resRel8.dnas) { dnas.push(...resRel8.dnas); }
-        }
-
-        // Verify rel8ns.ancestor exists on evolved item
-        if (!currentItem.rel8ns?.ancestor || currentItem.rel8ns.ancestor.length === 0) {
-            currentItem.rel8ns = {
-                ...(currentItem.rel8ns || {}),
-                ancestor: [`${B2TFS_ITEM_ATOM}^gib`],
-            };
-        }
-
-        if (logalot) {
-            console.log(`${lc} Evolved B2tFSItemIbGib: ${currentItem.ib}^${currentItem.gib} (I: 5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e)`);
-        }
-
-        return {
-            newIbGib: currentItem,
-            intermediateIbGibs: intermediateIbGibs.length > 0 ? intermediateIbGibs : undefined,
-            dnas: dnas.length > 0 ? dnas : undefined,
-        };
-    } catch (error) {
-        console.error(`${lc} ${extractErrorMsg(error)} (E: 6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f)`);
-        throw error;
-    } finally {
-        if (logalot) {
-            console.log(`${lc} complete. (I: 7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a)`);
-        }
-    }
-}
-
-
-function getSpacesArray(metaAny: any): IbGibSpaceAny[] {
-    if (!metaAny || !metaAny.spaces) {
-        return [];
-    }
-    if (metaAny.spaces instanceof Map) {
-        return Array.from(metaAny.spaces.values());
-    }
-    if (Array.isArray(metaAny.spaces)) {
-        return metaAny.spaces;
-    }
-    if (typeof metaAny.spaces === 'object') {
-        return Object.values(metaAny.spaces);
-    }
-    return [];
-}
-
-async function fetchFromSpaceSilently(spaceToQuery: IbGibSpaceAny, addrToGet: string): Promise<any> {
-    try {
-        const resGet = await getFromSpace({ space: spaceToQuery, addrs: [addrToGet] });
-        if (resGet) {
-            const found = resGet.ibGibs?.find(x => !!x) || (resGet.rawResultIbGib as any)?.ibGibs?.find((x: any) => !!x);
-            if (found) {
-                return found;
-            }
-        }
-    } catch {
-        // Suppress missing address error
-    }
-    return undefined;
-}
-
-/**
- * Retrieves an ibgib node by address, searching space first, then falling back to metaspace spaces if available.
- */
-export async function getIbGibWithMetaspaceFallback({
-    addr,
-    space,
-    metaspace,
-}: {
-    addr: string;
-    space: IbGibSpaceAny;
-    metaspace?: MetaspaceService;
-}): Promise<any> {
-    const parsedSq = parseSpaceQualifiedIbGibAddr(addr);
-    const targetAddr = parsedSq ? parsedSq.ibGibAddr : addr;
-
-    if (parsedSq && metaspace) {
-        try {
-            const spaceList = (await metaspace.getLocalUserSpaces({ lock: false })) || [];
-            let targetSpace = spaceList.find(s =>
-                s?.data?.uuid === parsedSq.spaceId ||
-                s?.data?.spaceId === parsedSq.spaceId ||
-                s?.data?.name === parsedSq.spaceId ||
-                s?.ib === parsedSq.spaceId ||
-                s?.data?.spaceSubPath === parsedSq.spaceId
-            );
-
-            if (!targetSpace) {
-                try {
-                    targetSpace = await metaspace.getLocalUserSpace({ localSpaceId: parsedSq.spaceId, lock: false });
-                } catch {
-                    // Suppress lookup error
-                }
-            }
-
-            if (targetSpace) {
-                const found = await fetchFromSpaceSilently(targetSpace, targetAddr);
-                if (found) {
-                    return found;
-                }
-            }
-        } catch {
-            // Suppress space lookup errors
-        }
-    }
-
-    const primaryFound = await fetchFromSpaceSilently(space, targetAddr);
-    if (primaryFound) {
-        return primaryFound;
-    }
-
-    if (metaspace) {
-        let spaceList: IbGibSpaceAny[] = [];
-        try {
-            spaceList = (await metaspace.getLocalUserSpaces({ lock: false })) || [];
-        } catch {
-            // Ignore bootstrap lookup error
-        }
-
-        const metaAny = metaspace as any;
-
-        // Try zero space if distinct
-        if (metaspace.zeroSpace && metaspace.zeroSpace !== space) {
-            const zeroFound = await fetchFromSpaceSilently(metaspace.zeroSpace, targetAddr);
-            if (zeroFound) {
-                return zeroFound;
-            }
-        }
-
-        if (metaAny.activeSpace && metaAny.activeSpace !== space && metaAny.activeSpace !== metaspace.zeroSpace) {
-            const activeFound = await fetchFromSpaceSilently(metaAny.activeSpace, targetAddr);
-            if (activeFound) {
-                return activeFound;
-            }
-        }
-
-        for (const s of spaceList) {
-            if (s && s !== space && s !== metaAny.activeSpace && s !== metaspace.zeroSpace) {
-                const sFound = await fetchFromSpaceSilently(s, targetAddr);
-                if (sFound) {
-                    return sFound;
-                }
-            }
-        }
-    }
-
-    return undefined;
-}
-
-/**
- * Projects a B2tFS item graph back onto the physical filesystem directory.
- */
-export async function writeB2tFSItemToFS({
-    item,
-    destPath,
-    space,
-    metaspace,
-}: {
-    item: B2tFSItemIbGib_V1;
-    destPath: string;
-    space: IbGibSpaceAny;
-    metaspace: MetaspaceService;
-}): Promise<void> {
-    const lc = `${lcFile}[${writeB2tFSItemToFS.name}]`;
-    try {
-        if (logalot) {
-            console.log(`${lc} starting... (I: 7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d)`);
-        }
-
-        if (!item || !item.data) {
-            throw new Error(`Invalid B2tFS item provided (E: 32a09c81b29e4d5867198204b12541a5)`);
-        }
-
-        const { fsType, name } = item.data;
-        const targetPath = path.join(destPath, name);
-
-        if (fsType === 'folder') {
-            await fs.mkdir(targetPath, { recursive: true });
-            const childAddrs = item.rel8ns?.[B2TFS_CHILD_ITEM_REL8N_NAME] || [];
-
-            for (const childAddr of childAddrs) {
-                const childItem = await getIbGibWithMetaspaceFallback({
-                    addr: childAddr,
-                    space,
-                    metaspace,
-                }) as B2tFSItemIbGib_V1;
-
-                if (childItem) {
-                    await writeB2tFSItemToFS({
-                        item: childItem,
-                        destPath: targetPath,
-                        space,
-                        metaspace,
-                    });
-                }
-            }
-        } else if (fsType === 'file') {
-            await fs.mkdir(path.dirname(targetPath), { recursive: true });
-            const binAddrs = item.rel8ns?.[BINARY_REL8N_NAME] || [];
-            const latestBinAddr = binAddrs.at(-1);
-
-            if (latestBinAddr) {
-                const binIbGib = await getIbGibWithMetaspaceFallback({
-                    addr: latestBinAddr,
-                    space,
-                    metaspace,
-                });
-
-                if (binIbGib && binIbGib.data) {
-                    let fileData: Uint8Array;
-                    if (typeof binIbGib.data === 'string') {
-                        fileData = Buffer.from(binIbGib.data, 'base64');
-                    } else if (binIbGib.data instanceof Uint8Array || Buffer.isBuffer(binIbGib.data)) {
-                        fileData = binIbGib.data as Uint8Array;
-                    } else if (typeof binIbGib.data === 'object') {
-                        const vals = Object.values(binIbGib.data as object);
-                        fileData = new Uint8Array(vals);
-                    } else {
-                        fileData = new Uint8Array(0);
-                    }
-
-                    await fs.writeFile(targetPath, fileData);
-                }
-            }
-        }
-    } catch (error) {
-        console.error(`${lc} ${extractErrorMsg(error)} (E: 8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d)`);
-        throw error;
-    } finally {
-        if (logalot) {
-            console.log(`${lc} complete. (I: 9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e)`);
-        }
-    }
-}
-
-/**
- * Executes two-pass application of diff transform results:
- * 1. Persists all child and parent transform results to space.
- * 2. Registers new IbGib pointers with metaspace to advance timeline tips.
- */
-export async function applyB2tFSItemDiff({
-    diff,
-    space,
-    metaspace,
-}: {
-    diff: B2tFSItemDiffInfo;
-    space: IbGibSpaceAny;
-    metaspace: MetaspaceService;
-}): Promise<void> {
-    const lc = `${lcFile}[${applyB2tFSItemDiff.name}]`;
-    try {
-        if (logalot) {
-            console.log(`${lc} starting... (I: 0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d)`);
-        }
-
-        if (diff.childDiffs && diff.childDiffs.length > 0) {
-            for (const childDiff of diff.childDiffs) {
-                await applyB2tFSItemDiff({ diff: childDiff, space, metaspace });
-            }
-        }
-
-        const results = diff.transformResults || [];
-        for (const tr of results) {
-            await persistTransformResult({ resTransform: tr, space });
-        }
-
-        for (const tr of results) {
-            if (tr.newIbGib) {
-                await metaspace.registerNewIbGib({ ibGib: tr.newIbGib });
-            }
-        }
-    } catch (error) {
-        console.error(`${lc} ${extractErrorMsg(error)} (E: 1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e)`);
-        throw error;
-    } finally {
-        if (logalot) {
-            console.log(`${lc} complete. (I: 2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f)`);
-        }
-    }
-}
-
-// #region reifyB2tFSHierarchy
-
-export interface ReifyB2tFSHierarchyOpts {
-    /** Root B2tFS item (folder or file). Either rootItem or rootItemAddr required. */
-    rootItem?: B2tFSItemIbGib_V1;
-    /** Address of root B2tFS item. Either rootItem or rootItemAddr required. */
-    rootItemAddr?: IbGibAddr;
-    /** Space containing the branch items and updated timeline tips. */
-    space: IbGibSpaceAny;
-    /** Metaspace service instance for lookups and registrations. */
-    metaspace: MetaspaceService;
-}
-
-export interface ReifyB2tFSHierarchyResult {
-    /** The reified root B2tFS item (evolved if any descendants changed, or unchanged if no descendants changed). */
-    reifiedRootItem: B2tFSItemIbGib_V1;
-    /** True if one or more folder/file nodes in the hierarchy evolved to new tips. */
-    hasChanges: boolean;
-    /** Map of old address -> new address for every node that evolved in this reification run. */
-    reifiedAddrsMap: { [oldAddr: string]: string };
-    /** All newly evolved and persisted intermediate/root folder items created during reification. */
-    evolvedItems: B2tFSItemIbGib_V1[];
-}
-
-/**
- * Reifies a B2tFS filesystem item hierarchy (folders and files) bottom-up.
- *
- * Traverses `b2tfs_child` relationship edges. If any child timeline advanced
- * in `space` (e.g. during a 3-way merge or parallel commit), the parent folders
- * are evolved in-place using `rel8` with the updated child tip addresses.
- */
-export async function reifyB2tFSHierarchy({
-    rootItem,
-    rootItemAddr,
-    space,
-    metaspace,
-}: ReifyB2tFSHierarchyOpts): Promise<ReifyB2tFSHierarchyResult> {
-    const lc = `${lcFile}[${reifyB2tFSHierarchy.name}]`;
-    try {
-        if (logalot) {
-            console.log(`${lc} starting... (I: 3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a)`);
-        }
-
-        const res = await reifyDependencyGraph({
-            ibGib: rootItem,
-            ibGibAddr: rootItemAddr,
-            onlyRel8nNames: [B2TFS_CHILD_ITEM_REL8N_NAME],
-            space,
-            metaspace,
-        });
-
-        return {
-            reifiedRootItem: res.reifiedIbGib as B2tFSItemIbGib_V1,
-            hasChanges: res.hasChanges,
-            reifiedAddrsMap: res.reifiedAddrsMap,
-            evolvedItems: res.evolvedIbGibs as B2tFSItemIbGib_V1[],
-        };
-    } catch (error) {
-        console.error(`${lc} ${extractErrorMsg(error)} (E: 4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b)`);
-        throw error;
-    } finally {
-        if (logalot) {
-            console.log(`${lc} complete. (I: 5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c)`);
-        }
-    }
-}
-
-// #endregion reifyB2tFSHierarchy