@ibgib/vcs-gib 0.0.6

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

@@ -0,0 +1,119 @@
+/**
+ * @module init-cmd
+ *
+ * Command handler for `vcs init [targetDir]`.
+ * Initializes local repository space, root B2tFS folder item, default branch, and in-band space index.
+ */
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { extractErrorMsg, getUUID } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { Factory_V1 } from '@ibgib/ts-gib/dist/V1/factory.mjs';
+import { ROOT } from '@ibgib/ts-gib/dist/V1/constants.mjs';
+import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
+import { persistTransformResult } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
+import { bootstrapVcsMetaspace } from '../../bootstrap/node-bootstrap.mjs';
+import { getB2tFSItemIb } from '../../engine/item/item-atom-helper.mjs';
+import { createB2tFSBranchIbGib, getB2tFSBranchSpaceName } from '../../engine/branch/branch-helper.mjs';
+import { getOrCreateBranchSpace } from '../../engine/branch/branch-space-helper.mjs';
+import { createB2tFSIndexIbGib, writeVcsIndexProjection } from '../../engine/index/index-helper.mjs';
+import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
+const lcFile = `[init-cmd]`;
+const logalot = GLOBAL_LOG_A_LOT;
+export async function executeInitCmd({ targetDir = process.cwd(), vcsFolderName = '.vcsgib', defaultBranchName = 'main', quiet = false, } = {}) {
+    const lc = `${lcFile}[${executeInitCmd.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 8a9b10c11d12e13f14a15b16c17d18e1)`);
+        }
+        const absTargetDir = path.resolve(targetDir);
+        const vcsPath = path.join(absTargetDir, vcsFolderName);
+        // Create target repository folder if it doesn't exist
+        await fs.mkdir(absTargetDir, { recursive: true });
+        // Bootstrap Metaspace
+        const { metaspace } = await bootstrapVcsMetaspace({
+            repoPath: absTargetDir,
+            vcsFolderName,
+            defaultSpaceName: `vcs_${path.basename(absTargetDir).replace(/[^a-zA-Z0-9_\-]/g, '_')}`,
+        });
+        // Initialize b2s_main branch space
+        const { space: branchSpace, spaceId } = await getOrCreateBranchSpace({
+            metaspace,
+            vcsPath,
+            branchName: defaultBranchName,
+        });
+        const folderName = path.basename(absTargetDir) || 'root';
+        const rootNameHash = await getUUID();
+        // 1. Create root folder B2tFS item inside b2s_main space
+        const rootItemRes = await Factory_V1.firstGen({
+            parentIbGib: ROOT,
+            ib: getB2tFSItemIb('folder', folderName, rootNameHash),
+            data: {
+                name: folderName,
+                nameHash: rootNameHash,
+                fsType: 'folder',
+                diffTransactionId: await getUUID(),
+                uuid: await getUUID(),
+                classname: 'B2tFSItemIbGib_V1',
+            },
+        });
+        const rootItem = rootItemRes.newIbGib;
+        await persistTransformResult({ resTransform: rootItemRes, space: branchSpace });
+        await metaspace.registerNewIbGib({ ibGib: rootItem, space: branchSpace });
+        // 2. Create default branch pointing to root folder inside b2s_main space
+        const branchIbGib = await createB2tFSBranchIbGib({
+            branchName: defaultBranchName,
+            rootItem,
+            space: branchSpace,
+            metaspace,
+        });
+        const branchAddr = getIbGibAddr({ ibGib: branchIbGib });
+        // 3. Create space index meta object stored inside b2s_main space
+        const indexIbGib = await createB2tFSIndexIbGib({
+            spaceId,
+            activeSpaceId: getB2tFSBranchSpaceName(defaultBranchName),
+            activeBranch: defaultBranchName,
+            space: branchSpace,
+            metaspace,
+            branchAddr,
+        });
+        // 4. Write read-only projection file in .vcsgib/
+        await writeVcsIndexProjection({
+            vcsPath,
+            indexIbGib,
+        });
+        // Clean up legacy out-of-band state files if present
+        try {
+            await fs.rm(path.join(vcsPath, 'vcs_state.json'), { force: true });
+        }
+        catch {
+            // Ignore if missing
+        }
+        try {
+            await fs.rm(path.join(vcsPath, 'staging.json'), { force: true });
+        }
+        catch {
+            // Ignore if missing
+        }
+        if (!quiet) {
+            console.log(`Initialized empty ibgib repository in ${vcsPath} (I: 6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f)`);
+            console.log(`  Branch: ${defaultBranchName}`);
+            console.log(`  Root Item: ${rootItem.ib}`);
+        }
+        return {
+            vcsPath,
+            spaceId,
+            branchName: defaultBranchName,
+            rootItemIb: rootItem.ib,
+        };
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)} (E: 9b10c11d12e13f14a15b16c17d18e19f)`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete. (I: 0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d)`);
+        }
+    }
+}
+//# sourceMappingURL=init-cmd.mjs.map

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

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

package/dist/cli/commands/init-cmd.respec.node.d.mts

@@ -0,0 +1,7 @@
+/**
+ * @module init-cmd.respec
+ *
+ * Unit tests for `vcs init` command handler.
+ */
+export {};
+//# sourceMappingURL=init-cmd.respec.node.d.mts.map

package/dist/cli/commands/init-cmd.respec.node.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-cmd.respec.node.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/init-cmd.respec.node.mts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/cli/commands/init-cmd.respec.node.mjs

@@ -0,0 +1,40 @@
+/**
+ * @module init-cmd.respec
+ *
+ * Unit tests for `vcs init` command handler.
+ */
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { respecfully, ifWe, iReckon } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+import { executeInitCmd } from './init-cmd.mjs';
+const lc = `[apps/vcs-gib/src/cli/commands/init-cmd.respec.node.mts]`;
+await respecfully(lc, `vcs init Command Handler`, async () => {
+    await ifWe(lc, `initializes repository space, branch, and index in target folder`, async () => {
+        const testDir = path.join(process.cwd(), '.test_init_repo');
+        const vcsFolderName = '.vcsgib_init_test';
+        try {
+            const res = await executeInitCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, res.branchName).willEqual('main');
+            iReckon(lc, res.rootItemIb).includes('b2tfs_item folder');
+            iReckon(lc, res.vcsPath).includes(vcsFolderName);
+            // Strict Repository Location Isolation Assertions:
+            // 1. Storage MUST be inside vcsPath (.vcsgib_init_test)
+            const ibgibInsideVcsFolder = existsSync(path.join(res.vcsPath, 'ibgib')) || existsSync(path.join(res.vcsPath, 'space'));
+            iReckon(lc, ibgibInsideVcsFolder).isGonnaBeTrue();
+            // 2. Storage MUST NOT spill into testDir root or process.cwd() as stray 'ibgib' folder
+            const strayInTestDir = existsSync(path.join(testDir, 'ibgib'));
+            const strayInCwd = existsSync(path.join(process.cwd(), 'ibgib'));
+            iReckon(lc, strayInTestDir).isGonnaBeFalse();
+            iReckon(lc, strayInCwd).isGonnaBeFalse();
+        }
+        finally {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=init-cmd.respec.node.mjs.map

package/dist/cli/commands/init-cmd.respec.node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-cmd.respec.node.mjs","sourceRoot":"","sources":["../../../src/cli/commands/init-cmd.respec.node.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EACH,WAAW,EAAE,IAAI,EAAE,OAAO,EAC7B,MAAM,kDAAkD,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,EAAE,GAAG,0DAA0D,CAAC;AAEtE,MAAM,WAAW,CAAC,EAAE,EAAE,0BAA0B,EAAE,KAAK,IAAI,EAAE;IAEzD,MAAM,IAAI,CAAC,EAAE,EAAE,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,iBAAiB,CAAC,CAAC;QAC5D,MAAM,aAAa,GAAG,mBAAmB,CAAC;QAC1C,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC;gBAC7B,SAAS,EAAE,OAAO;gBAClB,aAAa;gBACb,KAAK,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC9C,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;YAC1D,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;YAEjD,mDAAmD;YACnD,wDAAwD;YACxD,MAAM,oBAAoB,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YACxH,OAAO,CAAC,EAAE,EAAE,oBAAoB,CAAC,CAAC,aAAa,EAAE,CAAC;YAElD,uFAAuF;YACvF,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YAC/D,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;YACjE,OAAO,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC,cAAc,EAAE,CAAC;YAC7C,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,cAAc,EAAE,CAAC;QAC7C,CAAC;gBAAS,CAAC;YACP,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/cli/commands/log-cmd.d.mts

@@ -0,0 +1,27 @@
+/**
+ * @module log-cmd
+ *
+ * Command handler for `vcs log`.
+ * Reads active branch timeline from B2tFSIndexIbGib_V1 in localSpace,
+ * walks branch timeline history backward, and displays formatted commit history.
+ */
+export interface VcsLogItem {
+    branchAddr: string;
+    commitAddr: string;
+    commentAddr?: string;
+    message: string;
+    timestamp: string;
+    author: string;
+    rootItemAddr?: string;
+}
+export interface LogCmdOpts {
+    targetDir?: string;
+    vcsFolderName?: string;
+    quiet?: boolean;
+}
+export interface LogCmdResult {
+    branchName: string;
+    commits: VcsLogItem[];
+}
+export declare function executeLogCmd({ targetDir, vcsFolderName, quiet, }?: LogCmdOpts): Promise<LogCmdResult>;
+//# sourceMappingURL=log-cmd.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log-cmd.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/log-cmd.mts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,MAAM,WAAW,UAAU;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,UAAU,EAAE,CAAC;CACzB;AAED,wBAAsB,aAAa,CAAC,EAChC,SAAyB,EACzB,aAAyB,EACzB,KAAa,GAChB,GAAE,UAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAiJzC"}

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

@@ -0,0 +1,146 @@
+/**
+ * @module log-cmd
+ *
+ * Command handler for `vcs log`.
+ * Reads active branch timeline from B2tFSIndexIbGib_V1 in localSpace,
+ * walks branch timeline history backward, and displays formatted commit history.
+ */
+import path from 'node:path';
+import fs from 'node:fs/promises';
+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 { getIbGibWithMetaspaceFallback } from '../../engine/item/item-helper.mjs';
+import { getB2tFSIndexIbGib, extractBranchNameFromAddr } from '../../engine/index/index-helper.mjs';
+import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
+const lcFile = `[log-cmd]`;
+const logalot = GLOBAL_LOG_A_LOT;
+export async function executeLogCmd({ targetDir = process.cwd(), vcsFolderName = '.vcsgib', quiet = false, } = {}) {
+    const lc = `${lcFile}[${executeLogCmd.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting executeLogCmd (I: 1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e)`);
+        }
+        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: 2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f)`);
+        }
+        // 1. Fetch authoritative B2tFSIndexIbGib_V1 directly from localSpace
+        const indexIbGib = await getB2tFSIndexIbGib({ space: localSpace, vcsPath });
+        if (!indexIbGib) {
+            throw new Error(`Repository index B2tFSIndexIbGib_V1 not found in localSpace (E: 3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a)`);
+        }
+        const branchName = indexIbGib.data?.activeBranch || 'main';
+        // Target active branch space b2s_<activeBranch>
+        const { space: activeSpace } = await getOrCreateBranchSpace({
+            metaspace,
+            vcsPath,
+            branchName,
+        });
+        // 2. Fetch active branch node address matching active branchName
+        const branchAddrs = [
+            ...(indexIbGib.rel8ns?.branch || []),
+            ...(indexIbGib.rel8ns?.branch_tjp || []),
+        ];
+        let currBranchAddr;
+        // Match branchName against branchAddrs by space-qualified address or raw atom ib string
+        for (const addr of branchAddrs) {
+            const parsedName = extractBranchNameFromAddr(addr);
+            if (parsedName === branchName) {
+                currBranchAddr = addr;
+                break;
+            }
+        }
+        // Fallback: fetch branch nodes via getIbGibWithMetaspaceFallback to match b.data?.name === branchName
+        if (!currBranchAddr) {
+            for (const addr of branchAddrs) {
+                const bIbGib = await getIbGibWithMetaspaceFallback({
+                    addr,
+                    space: activeSpace,
+                    metaspace,
+                });
+                if (bIbGib?.data?.name === branchName) {
+                    currBranchAddr = addr;
+                    break;
+                }
+            }
+        }
+        // Ultimate fallback if no match found
+        if (!currBranchAddr) {
+            currBranchAddr = branchAddrs.at(0);
+        }
+        const visitedAddrs = new Set();
+        const commits = [];
+        // 3. Walk timeline history backward
+        while (currBranchAddr && !visitedAddrs.has(currBranchAddr)) {
+            visitedAddrs.add(currBranchAddr);
+            const branchIbGib = await getIbGibWithMetaspaceFallback({
+                addr: currBranchAddr,
+                space: activeSpace,
+                metaspace,
+            });
+            if (!branchIbGib) {
+                break;
+            }
+            const commentAddr = branchIbGib.rel8ns?.comment?.at(0);
+            const rootItemAddr = branchIbGib.rel8ns?.b2tfs_item?.at(0);
+            if (commentAddr) {
+                const commentIbGib = await getIbGibWithMetaspaceFallback({
+                    addr: commentAddr,
+                    space: activeSpace,
+                    metaspace,
+                });
+                const message = commentIbGib?.data?.text || '';
+                const timestamp = commentIbGib?.data?.textTimestamp || commentIbGib?.data?.timestamp || branchIbGib.data?.committedAt || '';
+                const author = 'vcs-user';
+                commits.push({
+                    branchAddr: currBranchAddr,
+                    commitAddr: commentAddr,
+                    commentAddr,
+                    message,
+                    timestamp,
+                    author,
+                    rootItemAddr,
+                });
+            }
+            // Move to previous branch node in timeline
+            currBranchAddr = branchIbGib.rel8ns?.past?.at(0) || branchIbGib.rel8ns?.ancestor?.at(0);
+        }
+        if (!quiet) {
+            console.log(`Branch: ${branchName} (I: 4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b)`);
+            if (commits.length === 0) {
+                console.log('No commits yet.');
+            }
+            else {
+                for (const commit of commits) {
+                    console.log(`\ncommit ${commit.commitAddr}`);
+                    console.log(`Author: ${commit.author}`);
+                    console.log(`Date:   ${commit.timestamp}`);
+                    console.log(`\n    ${commit.message}\n`);
+                }
+            }
+        }
+        return {
+            branchName,
+            commits,
+        };
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)} (E: 5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c)`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete. (I: 6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d)`);
+        }
+    }
+}
+//# sourceMappingURL=log-cmd.mjs.map

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

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

package/dist/cli/commands/status-add-cmd.respec.node.d.mts

@@ -0,0 +1,7 @@
+/**
+ * @module status-add-cmd.respec
+ *
+ * Unit tests for `vcs status` and `vcs add` command handlers.
+ */
+export {};
+//# sourceMappingURL=status-add-cmd.respec.node.d.mts.map

package/dist/cli/commands/status-add-cmd.respec.node.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-add-cmd.respec.node.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/status-add-cmd.respec.node.mts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/cli/commands/status-add-cmd.respec.node.mjs

@@ -0,0 +1,215 @@
+/**
+ * @module status-add-cmd.respec
+ *
+ * Unit tests for `vcs status` and `vcs add` command handlers.
+ */
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { respecfully, ifWe, iReckon } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+import { executeInitCmd } from './init-cmd.mjs';
+import { executeStatusCmd } from './status-cmd.mjs';
+import { executeAddCmd } from './add-cmd.mjs';
+import { executeCommitCmd } from './commit-cmd.mjs';
+import { bootstrapVcsMetaspace } from '../../bootstrap/node-bootstrap.mjs';
+import { getB2tFSIndexIbGib } from '../../engine/index/index-helper.mjs';
+const lc = `[apps/vcs-gib/src/cli/commands/status-add-cmd.respec.node.mts]`;
+await respecfully(lc, `vcs status and vcs add Command Handlers`, async () => {
+    await ifWe(lc, `detects untracked files in fresh repository`, async () => {
+        const testDir = path.join(process.cwd(), '.test_status_add_1');
+        const vcsFolderName = '.vcsgib_test_1';
+        try {
+            await executeInitCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            await fs.writeFile(path.join(testDir, 'hello.txt'), 'Hello ibgib!', 'utf8');
+            const statusRes = await executeStatusCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, statusRes.branchName).willEqual('main');
+            iReckon(lc, statusRes.untracked.map(x => x.path)).includes('hello.txt');
+            iReckon(lc, statusRes.staged.length).willEqual(0);
+        }
+        finally {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+    });
+    await ifWe(lc, `discovers .vcsgib via upward discovery when executed from a subfolder`, async () => {
+        const testDir = path.join(process.cwd(), '.test_status_add_subfolder');
+        const vcsFolderName = '.vcsgib_test_subfolder';
+        try {
+            await executeInitCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            const subDir = path.join(testDir, 'src', 'components');
+            await fs.mkdir(subDir, { recursive: true });
+            await fs.writeFile(path.join(subDir, 'Button.tsx'), 'export const Button = () => null;', 'utf8');
+            const statusRes = await executeStatusCmd({
+                targetDir: subDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, statusRes.branchName).willEqual('main');
+            iReckon(lc, statusRes.untracked.map(x => x.path)).includes('src/components/Button.tsx');
+        }
+        finally {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+    });
+    await ifWe(lc, `skips re-staging unmodified committed files during executeAddCmd with all flag`, async () => {
+        const testDir = path.join(process.cwd(), '.test_status_add_unmodified');
+        const vcsFolderName = '.vcsgib_test_unmodified';
+        try {
+            await executeInitCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            await fs.writeFile(path.join(testDir, 'file.txt'), 'Initial Content', 'utf8');
+            await executeAddCmd({
+                paths: ['file.txt'],
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            await executeCommitCmd({
+                message: 'Initial commit',
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            // Run add -a again when file is unmodified
+            const addRes = await executeAddCmd({
+                all: true,
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, addRes.stagedCount).willEqual(0);
+            iReckon(lc, addRes.stagedPaths.length).willEqual(0);
+        }
+        finally {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+    });
+    await ifWe(lc, `stages untracked file via executeAddCmd`, async () => {
+        const testDir = path.join(process.cwd(), '.test_status_add_2');
+        const vcsFolderName = '.vcsgib_test_2';
+        try {
+            await executeInitCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            await fs.writeFile(path.join(testDir, 'file1.txt'), 'Content 1', 'utf8');
+            await fs.writeFile(path.join(testDir, 'file2.txt'), 'Content 2', 'utf8');
+            const addRes = await executeAddCmd({
+                paths: ['file1.txt'],
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, addRes.stagedPaths).includes('file1.txt');
+            const { localSpace, vcsPath } = await bootstrapVcsMetaspace({
+                repoPath: testDir,
+                vcsFolderName,
+            });
+            const indexIbGib = await getB2tFSIndexIbGib({ space: localSpace, vcsPath });
+            iReckon(lc, Boolean(indexIbGib?.data?.staged_item && indexIbGib.data.staged_item.length > 0)).isGonnaBeTrue();
+            iReckon(lc, indexIbGib?.rel8ns?.staged_item).isGonnaBeFalsy();
+            const statusRes = await executeStatusCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, statusRes.staged.map(x => x.path)).includes('file1.txt');
+            iReckon(lc, statusRes.untracked.map(x => x.path)).includes('file2.txt');
+            iReckon(lc, statusRes.untracked.map(x => x.path)).not.includes('file1.txt');
+        }
+        finally {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+    });
+    await ifWe(lc, `respects .ibgibignore patterns during status and add`, async () => {
+        const testDir = path.join(process.cwd(), '.test_status_add_3');
+        const vcsFolderName = '.vcsgib_test_3';
+        try {
+            await executeInitCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            await fs.writeFile(path.join(testDir, '.ibgibignore'), 'ignored.txt\ntemp/\n', 'utf8');
+            await fs.writeFile(path.join(testDir, 'ignored.txt'), 'Secrets', 'utf8');
+            await fs.writeFile(path.join(testDir, 'tracked.txt'), 'Public', 'utf8');
+            await fs.mkdir(path.join(testDir, 'temp'), { recursive: true });
+            await fs.writeFile(path.join(testDir, 'temp/cache.dat'), 'Cache', 'utf8');
+            const statusRes = await executeStatusCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, statusRes.untracked.map(x => x.path)).includes('tracked.txt');
+            iReckon(lc, statusRes.untracked.map(x => x.path)).not.includes('ignored.txt');
+            iReckon(lc, statusRes.untracked.map(x => x.path)).not.includes('temp/cache.dat');
+            const addRes = await executeAddCmd({
+                all: true,
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, addRes.stagedPaths).includes('tracked.txt');
+            iReckon(lc, addRes.stagedPaths).not.includes('ignored.txt');
+            iReckon(lc, addRes.stagedPaths).not.includes('temp/cache.dat');
+        }
+        finally {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+    });
+    await ifWe(lc, `stages files matching glob pattern with executeAddCmd`, async () => {
+        const testDir = path.join(process.cwd(), '.test_status_add_glob');
+        const vcsFolderName = '.vcsgib_test_glob';
+        try {
+            await executeInitCmd({
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            await fs.writeFile(path.join(testDir, 'app.js'), 'console.log("app");', 'utf8');
+            await fs.writeFile(path.join(testDir, 'utils.js'), 'console.log("utils");', 'utf8');
+            await fs.writeFile(path.join(testDir, 'index.html'), '<html></html>', 'utf8');
+            const addRes = await executeAddCmd({
+                paths: ['*.js'],
+                targetDir: testDir,
+                vcsFolderName,
+                quiet: true,
+            });
+            iReckon(lc, addRes.stagedPaths).includes('app.js');
+            iReckon(lc, addRes.stagedPaths).includes('utils.js');
+            iReckon(lc, addRes.stagedPaths).not.includes('index.html');
+            let errorThrown = false;
+            try {
+                await executeAddCmd({
+                    paths: ['*.xyz'],
+                    targetDir: testDir,
+                    vcsFolderName,
+                    quiet: true,
+                });
+            }
+            catch (err) {
+                errorThrown = true;
+                iReckon(lc, err.message).includes('No files matched glob pattern: *.xyz');
+            }
+            iReckon(lc, errorThrown).isGonnaBeTrue();
+        }
+        finally {
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=status-add-cmd.respec.node.mjs.map

package/dist/cli/commands/status-add-cmd.respec.node.mjs.map

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

package/dist/cli/commands/status-cmd.d.mts

@@ -0,0 +1,25 @@
+/**
+ * @module status-cmd
+ *
+ * Command handler for `vcs status`.
+ * Compares physical workspace state against active branch snapshot tip and in-band index staging area.
+ */
+export interface VcsStatusItem {
+    path: string;
+    fsType: 'file' | 'folder';
+    status: 'untracked' | 'modified' | 'deleted' | 'staged';
+}
+export interface StatusCmdResult {
+    branchName: string;
+    staged: VcsStatusItem[];
+    modified: VcsStatusItem[];
+    deleted: VcsStatusItem[];
+    untracked: VcsStatusItem[];
+}
+export interface StatusCmdOpts {
+    targetDir?: string;
+    vcsFolderName?: string;
+    quiet?: boolean;
+}
+export declare function executeStatusCmd({ targetDir, vcsFolderName, quiet, }?: StatusCmdOpts): Promise<StatusCmdResult>;
+//# sourceMappingURL=status-cmd.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status-cmd.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/status-cmd.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuBH,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC3D;AAED,MAAM,WAAW,eAAe;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,SAAS,EAAE,aAAa,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,gBAAgB,CAAC,EACnC,SAAyB,EACzB,aAAyB,EACzB,KAAa,GAChB,GAAE,aAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CA8M/C"}