@ibgib/vcs-gib 0.0.32 → 0.0.34

package/dist/cli/vcs-repo-helper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vcs-repo-helper.d.mts","sourceRoot":"","sources":["../../src/cli/vcs-repo-helper.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,aAAa,EAAmC,MAAM,6CAA6C,CAAC;AAY7G,MAAM,WAAW,qBAAqB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAsB,iBAAiB,CAAC,EACpC,SAAyB,EACzB,aAAyB,EACzB,UAAU,GACb,GAAE,qBAA0B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAyE/D"}

package/dist/cli/vcs-repo-helper.mjs

@@ -0,0 +1,84 @@
+/**
+ * @module vcs-repo-helper
+ *
+ * Helper to bootstrap Node environment and open a VcsRepository session.
+ */
+import path from 'node:path';
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { VcsRepository } from '@ibgib/core-gib/dist/vcs/vcs-repository.mjs';
+import { resolveContextualBranchName } from '@ibgib/core-gib/dist/vcs/branch/branch-helper.mjs';
+import { getB2tFSIndexIbGib } from '@ibgib/core-gib/dist/vcs/index/index-helper.mjs';
+import { getOrCreateBranchSpace } from '@ibgib/core-gib/dist/vcs/branch/branch-helper.mjs';
+import { getOrCreateWorkspaceProjectionSpace } from '@ibgib/node-gib/dist/vcs/workspace-space-helper.mjs';
+import { GLOBAL_LOG_A_LOT } from '../vcs-gib-constants.mjs';
+import { bootstrapVcsMetaspace } from '../bootstrap/node-bootstrap.mjs';
+import { B2TFS_BRANCH_DEFAULT_NAME } from '@ibgib/core-gib/dist/vcs/branch/branch-constants.mjs';
+const logalot = GLOBAL_LOG_A_LOT;
+export async function openVcsRepository({ targetDir = process.cwd(), vcsFolderName = '.vcsgib', branchName, } = {}) {
+    const lc = `[${openVcsRepository.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 4a621eb5576a3064f85177c6de80a826)`);
+        }
+        const absTargetDir = path.resolve(targetDir);
+        // 1. Locate repository root and bootstrap Node localSpace
+        const { metaspace, localSpace, vcsPath, repoRoot } = await bootstrapVcsMetaspace({
+            repoPath: absTargetDir,
+            vcsFolderName,
+        });
+        // 2. Fetch authoritative in-band index from localSpace
+        const indexIbGib = await getB2tFSIndexIbGib({ space: localSpace, metaspace });
+        if (!indexIbGib) {
+            throw new Error(`Not an ibgib repository (index not found in ${vcsPath})`);
+        }
+        // 3. Determine active branch and worktree directory
+        const activeBranchName = branchName || resolveContextualBranchName({
+            targetDir: absTargetDir,
+            repoRoot,
+            indexIbGib,
+        });
+        const activeWorktreeDir = activeBranchName === B2TFS_BRANCH_DEFAULT_NAME
+            ? repoRoot
+            : path.join(repoRoot, 'b', activeBranchName);
+        // 4. Resolve branch space & create Node workspace projection space
+        const { space: activeSpace } = await getOrCreateBranchSpace({
+            metaspace,
+            branchName: activeBranchName,
+        });
+        const { space: workspaceSpace } = await getOrCreateWorkspaceProjectionSpace({
+            metaspace,
+            workspaceRoot: activeWorktreeDir,
+            vcsFolderName,
+            backingSpace: activeSpace,
+        });
+        const fnGetWorkspaceProjectionSpace = async ({ worktreeDir, backingSpace, }) => {
+            const { space } = await getOrCreateWorkspaceProjectionSpace({
+                metaspace,
+                workspaceRoot: worktreeDir,
+                vcsFolderName,
+                backingSpace,
+            });
+            return space;
+        };
+        // 5. Construct domain facade
+        const repo = new VcsRepository({
+            metaspace,
+            localSpace,
+            workspaceSpace,
+            fnGetWorkspaceProjectionSpace,
+            repoRoot,
+            vcsFolderName,
+        });
+        return { repo, repoRoot, activeWorktreeDir, vcsPath };
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+//# sourceMappingURL=vcs-repo-helper.mjs.map

package/dist/cli/vcs-repo-helper.mjs.map

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

package/dist/test/test-helpers.d.mts

@@ -48,4 +48,13 @@ export declare function logAddr(label: string, addr: IbGibAddr | undefined): voi
  * Logs a set of addrs with short formatting.
  */
 export declare function logAddrs(label: string, addrs: IbGibAddr[] | undefined): void;
+/**
+ * Recursively logs the b2tfs item hierarchy from a rootItemAddr within a space.
+ */
+export declare function logTreeHierarchy({ label, rootItemAddr, space, metaspace, }: {
+    label: string;
+    rootItemAddr?: string;
+    space: any;
+    metaspace?: any;
+}): Promise<void>;
 //# sourceMappingURL=test-helpers.d.mts.map

package/dist/test/test-helpers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"test-helpers.d.mts","sourceRoot":"","sources":["../../src/test/test-helpers.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AAErF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAgCjF;;;GAGG;AACH,wBAAsB,cAAc,CAAC,EACjC,KAAK,EACL,WAAW,EACX,KAAK,GACR,EAAE;IACC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,mBAAmB,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxD,KAAK,CAAC,EAAE,aAAa,CAAC;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,EAC/B,KAAK,EACL,SAAS,EACT,KAAK,GACR,EAAE;IACC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,iBAAiB,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpD,KAAK,CAAC,EAAE,aAAa,CAAC;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGjD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAExE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,CAE5E"}
+{"version":3,"file":"test-helpers.d.mts","sourceRoot":"","sources":["../../src/test/test-helpers.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AAErF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAA+B,MAAM,8CAA8C,CAAC;AAiC9G;;;GAGG;AACH,wBAAsB,cAAc,CAAC,EACjC,KAAK,EACL,WAAW,EACX,KAAK,GACR,EAAE;IACC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,mBAAmB,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxD,KAAK,CAAC,EAAE,aAAa,CAAC;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,EAC/B,KAAK,EACL,SAAS,EACT,KAAK,GACR,EAAE;IACC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,iBAAiB,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpD,KAAK,CAAC,EAAE,aAAa,CAAC;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGjD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAExE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,CAE5E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,EACnC,KAAK,EACL,YAAY,EACZ,KAAK,EACL,SAAS,GACZ,EAAE;IACC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,GAAG,CAAC;IACX,SAAS,CAAC,EAAE,GAAG,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhB"}

package/dist/test/test-helpers.mjs

@@ -15,6 +15,8 @@
  */
 import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
 import { getLatestAddrs } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
+import { B2TFS_CHILD_ITEM_REL8N_NAME } from '@ibgib/core-gib/dist/vcs/item/item-types.mjs';
+import { getIbGibFromSpace } from '@ibgib/core-gib/dist/common/other/ibgib-helper.mjs';
 // ─────────────────────────────────────────────────────────────────────────────
 // Internal helpers
 // ─────────────────────────────────────────────────────────────────────────────
@@ -132,4 +134,37 @@ export function logAddr(label, addr) {
 export function logAddrs(label, addrs) {
     console.log(`[ADDRS][${label}]: ${shortAddrs(addrs)}`);
 }
+/**
+ * Recursively logs the b2tfs item hierarchy from a rootItemAddr within a space.
+ */
+export async function logTreeHierarchy({ label, rootItemAddr, space, metaspace, }) {
+    const lc = `[TRACE_B2TFS][${label}]`;
+    const spaceName = space?.data?.name || space?.data?.spaceSubPath || space?.ib || 'unknown';
+    console.log(`${lc} === Hierarchy for root: ${shortAddr(rootItemAddr)} in space: ${spaceName} ===`);
+    if (!rootItemAddr) {
+        console.log(`${lc} rootItemAddr is falsy`);
+        return;
+    }
+    async function walk(addr, depth, currentPath) {
+        const indent = '  '.repeat(depth);
+        const item = await getIbGibFromSpace({ addr, space, metaspace });
+        if (!item) {
+            console.log(`${lc}${indent} ❌ MISSING item at ${shortAddr(addr)} (path: ${currentPath})`);
+            return;
+        }
+        const name = item.data?.name || '(root)';
+        const fsType = item.data?.fsType || 'unknown';
+        const comments = item.rel8ns?.comment || [];
+        const children = item.rel8ns?.[B2TFS_CHILD_ITEM_REL8N_NAME] || [];
+        console.log(`${lc}${indent} 📁 ${name} (${fsType}) addr: ${shortAddr(addr)} comments: ${comments.length} children: ${children.length}`);
+        for (const cAddr of comments) {
+            const comment = await getIbGibFromSpace({ addr: cAddr, space, metaspace });
+            console.log(`${lc}${indent}   💬 comment: "${comment?.data?.text?.slice(0, 50)}"`);
+        }
+        for (const childAddr of children) {
+            await walk(childAddr, depth + 1, currentPath ? `${currentPath}/${name}` : name);
+        }
+    }
+    await walk(rootItemAddr, 1, '');
+}
 //# sourceMappingURL=test-helpers.mjs.map

package/dist/test/test-helpers.mjs.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibgib/vcs-gib",
-  "version": "0.0.32",
+  "version": "0.0.34",
   "private": false,
   "type": "module",
   "main": "dist/index.mjs",
@@ -19,10 +19,10 @@
     "prepare:publish": "npm version patch && node ../../build/dist/concrete-build/build-vcs-gib.mjs --prod && npm run pack"
   },
   "dependencies": {
-    "@ibgib/helper-gib": "^0.0.37",
-    "@ibgib/ts-gib": "^0.5.34",
-    "@ibgib/encrypt-gib": "^0.3.1",
-    "@ibgib/core-gib": "^0.1.78",
-    "@ibgib/node-gib": "^0.0.23"
+    "@ibgib/helper-gib": "^0.0.39",
+    "@ibgib/ts-gib": "^0.5.36",
+    "@ibgib/encrypt-gib": "^0.3.3",
+    "@ibgib/core-gib": "^0.1.80",
+    "@ibgib/node-gib": "^0.0.25"
   }
 }

package/src/AUTO-GENERATED-version.mts

@@ -2,4 +2,4 @@
  * @module AUTO-GENERATED-version
  * Auto-generated version constant. Do NOT edit directly.
  */
-export const AUTO_GENERATED_VERSION = '0.0.32';
+export const AUTO_GENERATED_VERSION = '0.0.34';

package/src/bootstrap/node-bootstrap.mts

@@ -56,7 +56,7 @@ export async function bootstrapVcsMetaspace(
 ): Promise<BootstrapVcsMetaspaceResult> {
     const lc = `${lcFile}[${bootstrapVcsMetaspace.name}]`;
     try {
-        if (logalot) { console.log(`${lc} starting... (I: 9f8a0b1c2d3e4f5a6b7c8d9e0f1a2b3c)`); }
+        if (logalot) { console.log(`${lc} starting... (I: genuuid)`); }
 
         GraftStrategyService.instance.registerStrategy(new B2tFS3WayGraftStrategy());
 
@@ -102,20 +102,7 @@ export async function bootstrapVcsMetaspace(
         const safeRepoDir = path.basename(repoRoot).replace(/[^a-zA-Z0-9_\-]/g, '_');
         const defaultSpaceName = opts.defaultSpaceName || `vcs_${safeRepoDir}`;
 
-        if (logalot) { console.log(`${lc} initializing vcsMetaspace at vcsPath: ${vcsPath}, repoRoot: ${repoRoot} (I: 4a3b2c1d0e9f8a7b6c5d4e3f2a1b0c9d)`); }
-
-        // Read localSpaceId from index projection if repository has been initialized
-        let localSpaceId: string | undefined;
-        try {
-            const projFile = path.join(vcsPath, 'vcs_index_projection.json');
-            const projRaw = await fs.readFile(projFile, 'utf8');
-            const projData = JSON.parse(projRaw);
-            if (projData && projData.spaceId) {
-                localSpaceId = projData.spaceId;
-            }
-        } catch {
-            // Projection file missing before init
-        }
+        if (logalot) { console.log(`${lc} initializing vcsMetaspace at vcsPath: ${vcsPath}, repoRoot: ${repoRoot} (I: genuuid)`); }
 
         // Instantiate Metaspace_Nodespace
         const metaspace = new Metaspace_Nodespace(undefined);
@@ -157,7 +144,7 @@ export async function bootstrapVcsMetaspace(
                 if (logalot) { console.log(`${lc} [Alert] ${title}: ${msg} (I: 7e6f5d4c3b2a1f0e9d8c7b6a5f4e3d2c)`); }
             },
             getFnPrompt: () => async ({ title, msg }) => {
-                if (logalot) { console.log(`${lc} [Prompt] ${title}: ${msg} (I: 2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e)`); }
+                if (logalot) { console.log(`${lc} [Prompt] ${title}: ${msg} (I: genuuid)`); }
                 return defaultSpaceName;
             },
             getFnPromptPassword: () => async (title, msg) => {
@@ -171,7 +158,6 @@ export async function bootstrapVcsMetaspace(
         }
 
         const localSpace = await metaspace.getLocalUserSpace({
-            localSpaceId,
             lock: false,
         });
 
@@ -187,7 +173,7 @@ export async function bootstrapVcsMetaspace(
 
         if (logalot) {
             const spaceName = localSpace.data?.name || localSpace.ib;
-            console.log(`${lc} Metaspace ready. LocalSpace name/ib: ${spaceName} (I: 1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f)`);
+            console.log(`${lc} Metaspace ready. LocalSpace name/ib: ${spaceName} (I: genuuid)`);
         }
 
         return {
@@ -197,9 +183,9 @@ export async function bootstrapVcsMetaspace(
             repoRoot,
         };
     } catch (error: any) {
-        console.error(`${lc} ${error?.message || error} (E: 8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d)`);
+        console.error(`${lc} ${error?.message || error} (E: genuuid)`);
         throw error;
     } finally {
-        if (logalot) { console.log(`${lc} complete. (I: 3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a)`); }
+        if (logalot) { console.log(`${lc} complete. (I: genuuid)`); }
     }
 }

package/src/bootstrap/node-bootstrap.respec.mts

@@ -1,6 +1,6 @@
 /**
  * @module node-bootstrap.respec
- * 
+ *
  * Unit tests for rapid Node Metaspace bootstrap helper.
  */
 
@@ -13,7 +13,7 @@ import {
 
 import { bootstrapVcsMetaspace } from './node-bootstrap.mjs';
 
-const lc = `[apps/vcs-gib/src/bootstrap/node-bootstrap.respec.node.mts]`;
+const lc = `[apps/vcs-gib/src/bootstrap/node-bootstrap.respec.mts]`;
 
 await respecfully(lc, `Node Metaspace Bootstrap`, async () => {
 

package/src/cli/cli-arg-parser.respec.mts

@@ -1,6 +1,6 @@
 /**
  * @module cli-arg-parser.respec
- * 
+ *
  * Unit tests for zero-dependency vcs CLI argument parser.
  */
 
@@ -10,7 +10,7 @@ import {
 
 import { parseVcsArgs } from './cli-arg-parser.mjs';
 
-const lc = `[apps/vcs-gib/src/cli/cli-arg-parser.respec.node.mts]`;
+const lc = `[apps/vcs-gib/src/cli/cli-arg-parser.respec.mts]`;
 
 await respecfully(lc, `Zero-Dependency CLI Argument Parser`, async () => {
 

package/src/cli/cli-e2e.respec.mts

@@ -2,6 +2,7 @@
  * @module cli-e2e.respec
  *
  * End-to-End CLI Integration Spec for @ibgib/vcs-gib.
+ *
  * Executes full lifecycle: vcs init -> vcs status -> vcs add -> vcs commit -> vcs log -> vcs branch -> vcs checkout.
  */
 
@@ -9,21 +10,21 @@ import path from 'node:path';
 import fs from 'node:fs/promises';
 
 import {
-    respecfully, ifWe, ifWeMight, iReckon
+    respecfully, ifWe, ifWeMight, iReckon, // don't remove ifWe/ifWeMight even if unused
 } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
 
 import { main } from './vcs-cli-main.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 { executeInitCmd } from './commands/cli-init-cmd.mjs';
+import { executeStatusCmd } from './commands/cli-status-cmd.mjs';
+import { executeAddCmd } from './commands/cli-add-cmd.mjs';
+import { executeCommitCmd } from './commands/cli-commit-cmd.mjs';
+import { executeLogCmd } from './commands/cli-log-cmd.mjs';
+import { executeBranchCmd } from './commands/cli-branch-cmd.mjs';
+import { executeCheckoutCmd } from './commands/cli-checkout-cmd.mjs';
 import { bootstrapVcsMetaspace } from '../bootstrap/node-bootstrap.mjs';
-import { readVcsIndexProjectionFromDisk } from './vcs-projection-helper.mjs';
+import { getB2tFSIndexIbGib } from '@ibgib/core-gib/dist/vcs/index/index-helper.mjs';
 
-const lc = `[apps/vcs-gib/src/cli/cli-e2e.respec.node.mts]`;
+const lc = `[apps/vcs-gib/src/cli/cli-e2e.respec.mts]`;
 
 await respecfully(lc, `Full E2E CLI Integration Spec`, async () => {
 
@@ -107,11 +108,11 @@ await respecfully(lc, `Full E2E CLI Integration Spec`, async () => {
 
             iReckon(lc, addRes.stagedCount >= 2).isGonnaBeTrue();
 
-            const { localSpace: e2eSpaceAdd, vcsPath: e2eVcsPathAdd } = await bootstrapVcsMetaspace({
+            const { localSpace: e2eSpaceAdd, metaspace: e2eMetaspaceAdd } = await bootstrapVcsMetaspace({
                 repoPath: testDir,
                 vcsFolderName,
             });
-            const e2eIndexAdd = await readVcsIndexProjectionFromDisk({ space: e2eSpaceAdd, vcsPath: e2eVcsPathAdd });
+            const e2eIndexAdd = await getB2tFSIndexIbGib({ space: e2eSpaceAdd, metaspace: e2eMetaspaceAdd });
             iReckon(lc, Boolean(e2eIndexAdd?.data?.staged_item && e2eIndexAdd.data.staged_item.length >= 2)).isGonnaBeTrue();
             iReckon(lc, e2eIndexAdd?.rel8ns?.staged_item).isGonnaBeFalsy();
 
@@ -130,11 +131,11 @@ await respecfully(lc, `Full E2E CLI Integration Spec`, async () => {
                 quiet: true,
             });
 
-            const { localSpace: e2eSpaceCommit, vcsPath: e2eVcsPathCommit } = await bootstrapVcsMetaspace({
+            const { localSpace: e2eSpaceCommit, metaspace: e2eMetaspaceCommit } = await bootstrapVcsMetaspace({
                 repoPath: testDir,
                 vcsFolderName,
             });
-            const e2eIndexCommit = await readVcsIndexProjectionFromDisk({ space: e2eSpaceCommit, vcsPath: e2eVcsPathCommit });
+            const e2eIndexCommit = await getB2tFSIndexIbGib({ space: e2eSpaceCommit, metaspace: e2eMetaspaceCommit });
             iReckon(lc, e2eIndexCommit?.data?.staged_item).willEqual([]);
             iReckon(lc, e2eIndexCommit?.rel8ns?.staged_item).isGonnaBeFalsy();
 

package/src/cli/commands/branch-checkout-cmd.respec.mts

@@ -8,21 +8,22 @@ import path from 'node:path';
 import fs from 'node:fs/promises';
 
 import {
-    respecfully, ifWe, iReckon,
-    ifWeMight
+    respecfully, ifWe, iReckon, ifWeMight, // don't remove ifWe/ifWeMight even if unused
 } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
 
-import { executeInitCmd } from './init-cmd.mjs';
-import { executeAddCmd } from './add-cmd.mjs';
-import { executeCommitCmd } from './commit-cmd.mjs';
-import { executeBranchCmd } from './branch-cmd.mjs';
-import { executeCheckoutCmd } from './checkout-cmd.mjs';
-import { executeMergeCmd } from './merge-cmd.mjs';
-import { executeStatusCmd } from './status-cmd.mjs';
-import { executeLogCmd } from './log-cmd.mjs';
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+
+import { executeInitCmd } from './cli-init-cmd.mjs';
+import { executeAddCmd } from './cli-add-cmd.mjs';
+import { executeCommitCmd } from './cli-commit-cmd.mjs';
+import { executeBranchCmd } from './cli-branch-cmd.mjs';
+import { executeCheckoutCmd } from './cli-checkout-cmd.mjs';
+import { executeMergeCmd } from './cli-merge-cmd.mjs';
+import { executeStatusCmd } from './cli-status-cmd.mjs';
+import { executeLogCmd } from './cli-log-cmd.mjs';
 import { logCheckpoint } from '../../test/test-helpers.mjs';
 
-const lc = `[apps/vcs-gib/src/cli/commands/branch-checkout-cmd.respec.node.mts]`;
+const lc = `[apps/vcs-gib/src/cli/commands/branch-checkout-cmd.respec.mts]`;
 
 await respecfully(lc, `vcs branch, checkout, and merge Command Handlers`, async () => {
 
@@ -61,6 +62,7 @@ await respecfully(lc, `vcs branch, checkout, and merge Command Handlers`, async
             });
 
             // Create feature branch
+            debugger; // walk through branch exec
             const createRes = await executeBranchCmd({
                 branchName: 'feature-auth',
                 targetDir: testDir,
@@ -77,6 +79,7 @@ await respecfully(lc, `vcs branch, checkout, and merge Command Handlers`, async
                 vcsFolderName,
                 quiet: true,
             });
+            console.dir(listRes)
 
             iReckon(lc, listRes.branches.length).willEqual(2);
             const featureBranch = listRes.branches.find(b => b.name === 'feature-auth');
@@ -147,6 +150,7 @@ await respecfully(lc, `vcs branch, checkout, and merge Command Handlers`, async
                 quiet: true,
             });
 
+            debugger; // 3
             // Checkout feature-ui
             const checkoutRes = await executeCheckoutCmd({
                 branchName: 'feature-ui',
@@ -166,6 +170,7 @@ await respecfully(lc, `vcs branch, checkout, and merge Command Handlers`, async
             const fileContent = await fs.readFile(projectedFile, 'utf8');
             iReckon(lc, fileContent).willEqual('console.log("Main");');
 
+            debugger; // 4
             // Verify active branch in status
             const statusRes = await executeStatusCmd({
                 targetDir: testDir,
@@ -174,6 +179,7 @@ await respecfully(lc, `vcs branch, checkout, and merge Command Handlers`, async
             });
             iReckon(lc, statusRes.branchName).willEqual('feature-ui');
 
+            debugger; // 5
             // Verify branch list displays ALL branches while on feature-ui
             const branchListOnFeature = await executeBranchCmd({
                 targetDir: testDir,
@@ -184,6 +190,7 @@ await respecfully(lc, `vcs branch, checkout, and merge Command Handlers`, async
             iReckon(lc, branchListOnFeature.branches.map(b => b.name)).includes('main');
             iReckon(lc, branchListOnFeature.branches.map(b => b.name)).includes('feature-ui');
 
+            debugger; // 6
             // Make a commit on feature-ui branch
             await fs.writeFile(path.join(expectedWorktree, 'ui.ts'), 'export const ui = 1;', 'utf8');
             await executeAddCmd({
@@ -192,6 +199,7 @@ await respecfully(lc, `vcs branch, checkout, and merge Command Handlers`, async
                 vcsFolderName,
                 quiet: true,
             });
+            debugger; // 7
             await executeCommitCmd({
                 message: 'Add ui.ts on feature-ui',
                 targetDir: expectedWorktree,
@@ -199,6 +207,7 @@ await respecfully(lc, `vcs branch, checkout, and merge Command Handlers`, async
                 quiet: true,
             });
 
+            debugger; // 8
             // Verify branch list after commit on feature-ui still displays ALL branches
             const branchListAfterCommit = await executeBranchCmd({
                 targetDir: expectedWorktree,
@@ -207,6 +216,7 @@ await respecfully(lc, `vcs branch, checkout, and merge Command Handlers`, async
             });
             iReckon(lc, branchListAfterCommit.branches.length).willEqual(2);
 
+            debugger; // 9
             // Switch back to main
             const switchBackRes = await executeCheckoutCmd({
                 branchName: 'main',
@@ -217,6 +227,8 @@ await respecfully(lc, `vcs branch, checkout, and merge Command Handlers`, async
             iReckon(lc, switchBackRes.currentBranch).willEqual('main');
             iReckon(lc, switchBackRes.worktreePath).willEqual(testDir);
 
+            debugger; // 10
+
             // Verify branch list displays ALL branches while on main after feature-ui commit
             const branchListOnMain = await executeBranchCmd({
                 targetDir: testDir,
@@ -235,6 +247,8 @@ await respecfully(lc, `vcs branch, checkout, and merge Command Handlers`, async
                 quiet: true,
             });
             iReckon(lc, switchAgainRes.currentBranch).willEqual('feature-ui');
+        } catch (error) {
+            iReckon(lc, true).asTo(extractErrorMsg(error)).isGonnaBeFalse();
         } finally {
             await fs.rm(testDir, { recursive: true, force: true });
         }
@@ -274,7 +288,7 @@ await respecfully(lc, `vcs branch, checkout, and merge Command Handlers`, async
                 });
             } catch (err: any) {
                 err2 = true;
-                iReckon(lc, err.message).includes("does not exist");
+                iReckon(lc, err.message).includes("not found");
             }
             iReckon(lc, err2).isGonnaBeTrue();
         } finally {
@@ -376,7 +390,7 @@ await respecfully(lc, `vcs branch, checkout, and merge Command Handlers`, async
                 });
             } catch (err: any) {
                 uncommittedErr = true;
-                iReckon(lc, err.message).includes("not found in active branch snapshot");
+                iReckon(lc, err.message).includes("not found in active branch");
             }
             iReckon(lc, uncommittedErr).isGonnaBeTrue();
 
@@ -541,7 +555,7 @@ await respecfully(lc, `vcs branch, checkout, and merge Command Handlers`, async
             const featureLogRes = await executeLogCmd({ targetDir: featureWorktree!, vcsFolderName, quiet: true });
             iReckon(lc, featureLogRes.branchName).willEqual('feature-calc');
             const featureMessages = featureLogRes.commits.map(c => c.message);
-            iReckon(lc, featureMessages.some(m => m.includes('Add calc on feature-calc'))).isGonnaBeTrue();
+            iReckon(lc, featureMessages.some(m => m.includes('Add calc on feature-calc'))).asTo('featureMessages has Add calc on feature-calc').isGonnaBeTrue();
 
             // Query status from inside featureWorktree
             const featureStatusRes = await executeStatusCmd({ targetDir: featureWorktree!, vcsFolderName, quiet: true });

package/src/cli/commands/cli-add-cmd.mts

@@ -0,0 +1,65 @@
+/**
+ * @module add-cmd
+ *
+ * CLI command handler for `vcs add <path...>`.
+ * Bootstraps workspace projection space and delegates to executeVcsAdd.
+ */
+
+import path from 'node:path';
+
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { openVcsRepository } from '../vcs-repo-helper.mjs';
+import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
+
+const lcFile = `[add-cmd]`;
+const logalot = GLOBAL_LOG_A_LOT;
+
+export interface AddCmdOpts {
+    paths?: string[];
+    targetDir?: string;
+    vcsFolderName?: string;
+    all?: boolean;
+    quiet?: boolean;
+}
+
+export interface AddCmdResult {
+    stagedPaths: string[];
+    stagedCount: number;
+}
+
+export async function executeAddCmd({
+    paths = [],
+    targetDir = process.cwd(),
+    vcsFolderName = '.vcsgib',
+    all = false,
+    quiet = false,
+}: AddCmdOpts = {}): Promise<AddCmdResult> {
+    const lc = `${lcFile}[${executeAddCmd.name}]`;
+    try {
+        if (logalot) { console.log(`${lc} starting... (I: genuuid)`); }
+
+        const absTargetDir = path.resolve(targetDir);
+        const { repo } = await openVcsRepository({ targetDir: absTargetDir, vcsFolderName });
+
+        const addRes = await repo.add(paths, {
+            all,
+            targetDir: absTargetDir,
+        });
+
+        if (!quiet) {
+            for (const stagedPath of addRes.stagedPaths) {
+                console.log(`staged: ${stagedPath}`);
+            }
+        }
+
+        return {
+            stagedPaths: addRes.stagedPaths,
+            stagedCount: addRes.stagedCount,
+        };
+    } catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)} (E: genuuid)`);
+        throw error;
+    } finally {
+        if (logalot) { console.log(`${lc} complete. (I: genuuid)`); }
+    }
+}