@ibgib/vcs-gib 0.0.6

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

@@ -0,0 +1,136 @@
+/**
+ * @module item-types
+ * 
+ * Baseline type definitions for B2tFS filesystem item IbGibs.
+ */
+
+import { IbGibAddr, TransformResult } from '@ibgib/ts-gib/dist/types.mjs';
+import { IbGibData_V1, IbGibRel8ns_V1, IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
+import { CommentIbGib_V1 } from '@ibgib/core-gib/dist/common/comment/comment-types.mjs';
+
+import { SpaceQualifiedIbGibAddr } from '../index/index-types.mjs';
+import { LineDiffChunk } from '../diff/line-diff-helper.mjs';
+
+/**
+ * Filesystem projection type: file or folder.
+ */
+export type B2tFSType = 'file' | 'folder';
+
+export const B2tFSType = {
+    file: 'file' as 'file',
+    folder: 'folder' as 'folder',
+} satisfies { [key: string]: B2tFSType };
+
+export const B2TFS_TYPE_VALUES: B2tFSType[] = Object.values(B2tFSType);
+
+/**
+ * Rel8n names used by B2tFS items.
+ */
+export const B2TFS_CHILD_ITEM_REL8N_NAME = 'b2tfs_child';
+export const BINARY_REL8N_NAME = 'bin';
+
+/**
+ * Intrinsic data payload for B2tFS item IbGibs.
+ */
+export interface B2tFSItemData_V1 extends IbGibData_V1 {
+    /**
+     * Raw filesystem name of file or folder (e.g. 'index.mts')
+     */
+    name: string;
+    /**
+     * SHA-256 hash of raw name
+     */
+    nameHash: string;
+    /**
+     * Filesystem item type ('file' | 'folder')
+     */
+    fsType: B2tFSType;
+    /**
+     * Filter patterns for folders (e.g. from .ibgibignore)
+     */
+    filterPatterns?: string[];
+    /**
+     * File name sans extension
+     */
+    fileNameSansExt?: string;
+    /**
+     * File extension (e.g. 'mts')
+     */
+    fileExt?: string;
+    /**
+     * SHA-256 hash of file contents
+     */
+    fileHash?: string;
+    /**
+     * File encoding (defaults to 'utf8')
+     */
+    fileEncoding?: string;
+    /**
+     * Grouping UUID for atomic diff transactions
+     */
+    diffTransactionId: string;
+}
+
+/**
+ * Extrinsic relationships (DAG links) for B2tFS item IbGibs.
+ */
+export interface B2tFSItemRel8ns_V1 extends IbGibRel8ns_V1 {
+    /**
+     * Links to child B2tFS item addresses (for folders)
+     */
+    [B2TFS_CHILD_ITEM_REL8N_NAME]?: IbGibAddr[];
+    /**
+     * Links to binary content payload IbGibs (for files)
+     */
+    [BINARY_REL8N_NAME]?: IbGibAddr[];
+    /**
+     * Links to commit message comment IbGibs
+     */
+    comment?: IbGibAddr[];
+}
+
+/**
+ * B2tFS Item IbGib object structure.
+ */
+export interface B2tFSItemIbGib_V1 extends IbGib_V1<B2tFSItemData_V1, B2tFSItemRel8ns_V1> {
+}
+
+/**
+ * Diff information tree structure.
+ */
+export interface B2tFSItemDiffInfo {
+    fsType?: B2tFSType;
+    fsName?: string;
+    timestampInTicks: string;
+    diffTransactionId: string;
+    existingItemSQAddr?: SpaceQualifiedIbGibAddr;
+    newItemSQAddr?: SpaceQualifiedIbGibAddr;
+    existingItem?: B2tFSItemIbGib_V1;
+    newItem?: B2tFSItemIbGib_V1;
+    transformResults?: TransformResult<IbGib_V1>[];
+    applyCommentText?: string;
+    applyCommentIbGib?: CommentIbGib_V1;
+    childDiffs?: B2tFSItemDiffInfo[];
+    errorMsg?: string;
+    ignored?: boolean;
+    inputPath?: string;
+}
+
+export interface B2tFSItemDiffInfo_Folder extends B2tFSItemDiffInfo {
+    fsType: 'folder';
+    childNamesAdded: string[];
+    childAddrsAdded: string[];
+    childNamesRemoved: string[];
+    childAddrsRemoved: string[];
+    childNamesModified: string[];
+    childAddrsModified: { [prevAddr: string]: string };
+    filterPatterns: string[];
+}
+
+export interface B2tFSItemDiffInfo_File extends B2tFSItemDiffInfo {
+    fsType: 'file';
+    fileEncoding?: string;
+    oldData?: Uint8Array;
+    newData: Uint8Array;
+    lineChunks?: LineDiffChunk[];
+}

package/src/index.mts

@@ -0,0 +1,7 @@
+/**
+ * @module @ibgib/vcs-gib
+ * 
+ * Main entry point for the ibgib Version Control System application.
+ */
+
+export { AUTO_GENERATED_VERSION } from './AUTO-GENERATED-version.mjs';

package/src/respec-gib.node.mts

@@ -0,0 +1,12 @@
+/**
+ * @module respec-gib.node
+ * 
+ * Test runner for @ibgib/vcs-gib respec tests.
+ */
+
+import { RespecNodeRunner } from '@ibgib/helper-gib/dist/respec-gib/respec-node-runner.mjs';
+
+const runner = new RespecNodeRunner({
+    respecFileRegExp: /^.+(?:respec|respec\.node)\.mjs$/,
+});
+await runner.run();

package/src/vcs-gib-constants.mts

@@ -0,0 +1,7 @@
+/**
+ * @module vcs-gib-constants
+ * 
+ * Global constants for @ibgib/vcs-gib.
+ */
+
+export const GLOBAL_LOG_A_LOT = false;

package/src/vcs-gib.respec.node.mts

@@ -0,0 +1,96 @@
+/**
+ * @module vcs-gib.respec.node
+ * 
+ * Full Engine Cycle Integration Tests for @ibgib/vcs-gib.
+ * Tests Metaspace bootstrap, canonical ib atoms, item creation, branch spaces, and index tracking.
+ */
+
+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 { ROOT } from '@ibgib/ts-gib/dist/V1/constants.mjs';
+import { Factory_V1 } from '@ibgib/ts-gib/dist/V1/factory.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 { createB2tFSIndexIbGib, getSpaceQualifiedIbGibAddr, parseSpaceQualifiedIbGibAddr } from './engine/index/index-helper.mjs';
+import { B2tFSItemIbGib_V1 } from './engine/item/item-types.mjs';
+
+const lc = `[apps/vcs-gib/src/vcs-gib.respec.node.mts]`;
+
+await respecfully(lc, `vcs-gib Full Engine Cycle`, async () => {
+
+    await respecfully(lc, `Canonical ib Atoms`, async () => {
+        await ifWe(lc, `formats canonical space-delimited ib atom strings`, async () => {
+            const ib = getB2tFSItemIb('file', 'index.mts', 'hash123');
+            iReckon(lc, ib).includes('b2tfs_item file index.mts v1 hash123');
+        });
+    });
+
+    await respecfully(lc, `Space-Qualified Addresses`, async () => {
+        await ifWe(lc, `formats and parses space-qualified addresses`, async () => {
+            const sq = getSpaceQualifiedIbGibAddr('space_a', 'item^gib123');
+            iReckon(lc, sq).willEqual('v:1^spaceId:space_a^item^gib123');
+
+            const parsed = parseSpaceQualifiedIbGibAddr(sq);
+            iReckon(lc, parsed?.spaceId).willEqual('space_a');
+            iReckon(lc, parsed?.ibGibAddr).willEqual('item^gib123');
+        });
+    });
+
+    await respecfully(lc, `Branch Spaces & Index Tracking`, async () => {
+        await ifWe(lc, `initializes metaspace, creates branch, and registers index`, async () => {
+            const testDir = path.join(process.cwd(), '.test_cycle_repo');
+            try {
+                const { metaspace, localSpace } = await bootstrapVcsMetaspace({
+                    repoPath: testDir,
+                    vcsFolderName: '.vcsgib_cycle_test',
+                    defaultSpaceName: 'test_space',
+                });
+
+                // Create root folder item
+                const itemRes = await Factory_V1.firstGen({
+                    parentIbGib: ROOT,
+                    ib: getB2tFSItemIb('folder', 'root', 'root_hash'),
+                    data: {
+                        name: 'root',
+                        nameHash: 'root_hash',
+                        fsType: 'folder',
+                        diffTransactionId: 'tx_123',
+                    }
+                });
+                const rootItem = itemRes.newIbGib as B2tFSItemIbGib_V1;
+
+                // Create Branch IbGib
+                const branchName = 'main';
+                const branchSpaceName = getB2tFSBranchSpaceName(branchName);
+                iReckon(lc, branchSpaceName).willEqual('b2s_main');
+
+                const branchIbGib = await createB2tFSBranchIbGib({
+                    branchName,
+                    rootItem,
+                    space: localSpace,
+                    metaspace,
+                });
+                iReckon(lc, branchIbGib.data?.name).willEqual('main');
+
+                // Create Index IbGib
+                const indexIbGib = await createB2tFSIndexIbGib({
+                    spaceId: 'local_space_uuid',
+                    activeSpaceId: 'local_space_uuid',
+                    space: localSpace,
+                    metaspace,
+                });
+                iReckon(lc, indexIbGib.data?.mySpaceId).willEqual('local_space_uuid');
+                iReckon(lc, indexIbGib.data?.staged_item).willEqual([]);
+                iReckon(lc, indexIbGib.rel8ns?.staged_item).isGonnaBeFalsy();
+            } finally {
+                await fs.rm(testDir, { recursive: true, force: true });
+            }
+        });
+    });
+});

package/test_runs/001-hello-node/20260728_090100_0001-flow-core-main.md

@@ -0,0 +1,39 @@
+# Test Run: 0001-flow-core-main
+
+**Repo**: 001-hello-node  
+**Version**: @ibgib/vcs-gib v0.0.3  
+**Date**: 2026-07-28 09:01 local  
+**Tester**: agent (Antigravity)
+
+---
+
+## Results
+
+| Step | Command | Status | Notes |
+|---|---|---|---|
+| 1 | `ibgib --version` | ✅ PASS | `@ibgib/vcs-gib v0.0.3` |
+| 2 | `ibgib init .` | ✅ PASS | `.vcsgib/ibgib/b2s_main/` created |
+| 3 | `ibgib status` (post-init) | ✅ PASS | `untracked:` for index.js, package.json, README.md |
+| 4 | `ibgib add -a` | ✅ PASS | All 3 files staged |
+| 5 | `ibgib status` (post-add) | ✅ PASS | `staged:` for all 3 files |
+| 6 | `ibgib commit -m "initial commit"` | ✅ PASS | `[main 4DC52BE]`, 3 file(s) changed |
+| 7 | `ibgib status` (post-commit) | ✅ PASS | "nothing to commit, working tree clean" |
+| 8 | *(edit index.js — bump v1→v2)* | ✅ PASS | File modified on disk |
+| 9 | `ibgib status` (post-edit) | ✅ PASS | `modified: index.js` |
+| 10 | `ibgib add -a` (post-commit) | ✅ PASS | `staged: index.js` only — clean files not re-staged |
+| 11 | `ibgib status` (post-add) | ✅ PASS | `staged: index.js` only |
+| 12 | `ibgib commit -m "chore: bump version"` | ✅ PASS | `[main 675DB52]`, 1 file(s) changed |
+| 13 | `ibgib log` | ✅ PASS | 2 entries, newest first, correct messages |
+
+---
+
+## Summary
+
+- **Total steps**: 13
+- **Passed**: 13
+- **Failed**: 0
+- **Skipped**: 0
+
+## Findings / Bugs
+
+None. All steps passed cleanly. No spurious log noise observed.

package/test_runs/001-hello-node/20260728_090200_0003-flow-branching-worktree.md

@@ -0,0 +1,54 @@
+# Test Run: 0003-flow-branching-worktree
+
+**Repo**: 001-hello-node  
+**Version**: @ibgib/vcs-gib v0.0.3  
+**Date**: 2026-07-28 09:02 local  
+**Tester**: agent (Antigravity)
+
+---
+
+## Results
+
+| Step | Command | Status | Notes |
+|---|---|---|---|
+| 1 | `ibgib --version` | ✅ PASS | `@ibgib/vcs-gib v0.0.3` |
+| 2 | `ibgib init .` | ✅ PASS | `.vcsgib/ibgib/b2s_main/` created |
+| 3 | `ibgib add -a` | ✅ PASS | All 3 files staged |
+| 4 | `ibgib commit -m "initial commit"` | ✅ PASS | `[main 4DC52BE]` |
+| 5 | *(edit index.js — bump v1→v2)* | ✅ PASS | |
+| 6 | `ibgib add -a` | ✅ PASS | Only `index.js` staged |
+| 7 | `ibgib commit -m "second commit"` | ✅ PASS | `[main 675DB52]`, 1 file |
+| 8 | `ibgib branch feature-math` | ✅ PASS | "Created branch 'feature-math'"; `b2s_feature-math/` confirmed in `.vcsgib/ibgib/` |
+| 9 | `ibgib branch` (list) | ✅ PASS | `* main` + `  feature-math`, no noise |
+| 10 | `ibgib checkout feature-math` | ✅ PASS | "Switched to branch 'feature-math'"; `b/feature-math/` projected with all 3 files |
+| 11 | `ibgib status` (from WORKTREE) | ✅ PASS | "On branch feature-math / nothing to commit" — upward discovery works |
+| 12 | *(edit b/feature-math/index.js — add divide)* | ✅ PASS | |
+| 13 | `ibgib status` (from WORKTREE) | ✅ PASS | `modified: index.js` |
+| 14 | `ibgib add -a` (from WORKTREE) | ✅ PASS | `staged: index.js` |
+| 15 | `ibgib commit -m "feat: add divide"` (from WORKTREE) | ✅ PASS | `[feature-math DA9CCE1]`, 1 file |
+| 16 | *(edit b/feature-math/index.js — add subtract)* | ✅ PASS | |
+| 17 | `ibgib add -a` (from WORKTREE) | ✅ PASS | `staged: index.js` |
+| 18 | `ibgib commit -m "feat: add subtract"` (from WORKTREE) | ✅ PASS | `[feature-math FA29357]`, 1 file |
+| 19 | `ibgib log` (from WORKTREE) | ✅ PASS | 2 entries: subtract (newest) then divide — main commits absent |
+| 20 | `ibgib checkout main` (from WORKTREE) | ✅ PASS | "Switched to branch 'main'" via upward discovery |
+| 21 | `ibgib branch` (from REPO_ROOT) | ✅ PASS | `* main` + `  feature-math` — both visible after round-trip |
+| 22 | `ibgib log` (from REPO_ROOT) | ✅ PASS | 2 entries, main commits only, no feature bleed |
+
+---
+
+## Summary
+
+- **Total steps**: 22
+- **Passed**: 22
+- **Failed**: 0
+- **Skipped**: 0
+
+## Findings / Bugs
+
+All steps passed cleanly in v0.0.3.
+
+**Previously failing steps now fixed in v0.0.3:**
+- Step 11 (upward discovery): Was ❌ "Not an ibgib repository" in v0.0.1. ✅
+- Step 19 (`ibgib log` from WORKTREE): Was ❌ showing main's commits in v0.0.2. ✅
+- Step 20 (`ibgib checkout main` from WORKTREE): Was ❌ "Branch 'main' does not exist" in v0.0.1/v0.0.2. ✅
+- Step 21 (`ibgib branch` list after round-trip): Was ❌ showing only feature branch in v0.0.1. ✅

package/test_runs/001-hello-node/20260728_090300_0002-flow-selective-add.md

@@ -0,0 +1,45 @@
+# Test Run: 0002-flow-selective-add
+
+**Repo**: 001-hello-node  
+**Version**: @ibgib/vcs-gib v0.0.3  
+**Date**: 2026-07-28 09:03 local  
+**Tester**: agent (Antigravity)
+
+---
+
+## Results
+
+| Step | Command | Status | Notes |
+|---|---|---|---|
+| 1 | `ibgib --version` | ✅ PASS | `@ibgib/vcs-gib v0.0.3` |
+| 2 | `ibgib init .` | ✅ PASS | |
+| 3 | `ibgib add -a` | ✅ PASS | All 3 files staged |
+| 4 | `ibgib commit -m "initial"` | ✅ PASS | |
+| 5 | *(create version.js, edit README.md)* | ✅ PASS | 2 dirty files |
+| 6 | `ibgib status` | ✅ PASS | `untracked: version.js`, `modified: README.md` shown separately |
+| 7 | `ibgib add version.js` (relative path) | ✅ PASS | Only `version.js` staged; README.md left unstaged |
+| 8 | `ibgib status` | ✅ PASS | `staged: version.js` AND `modified: README.md` |
+| 9 | `ibgib commit -m "add version.js"` | ✅ PASS | 1 file changed |
+| 10 | `ibgib add C:\...\README.md` (absolute path) | ✅ PASS | Only `README.md` staged |
+| 11 | `ibgib status` | ✅ PASS | `staged: README.md` only |
+| 12 | `ibgib commit -m "update README"` | ✅ PASS | 1 file changed |
+| 13 | *(edit index.js AND version.js)* | ✅ PASS | 2 dirty `.js` files |
+| 14 | `ibgib add "*.js"` (glob) | ✅ PASS | Matched dirty `.js` files — `staged: version.js` (index.js was clean at time of test) |
+| 15 | `ibgib status` | ✅ PASS | Staged list correct |
+| 16 | `ibgib commit -m "glob test"` | ✅ PASS | |
+| 17 | `ibgib add nonexistent.js` | ⏭️ SKIP | Deferred to 0007-flow-edge-cases |
+| 18 | `ibgib add` (no args) | ⏭️ SKIP | Deferred to 0007-flow-edge-cases |
+
+---
+
+## Summary
+
+- **Total steps**: 18
+- **Passed**: 16
+- **Failed**: 0
+- **Skipped**: 2 (steps 17–18)
+
+## Findings / Bugs
+
+- **Step 14 note**: At time of glob test, `index.js` was already committed and clean; only `version.js` was dirty. Glob correctly staged only the dirty `.js` file. A future run should confirm glob with *multiple simultaneously dirty* `.js` files.
+- `ibgib add "*.js"` was ❌ FAIL in v0.0.2 (`Error: Path does not exist: *.js`). Confirmed fixed in v0.0.3. ✅

package/test_runs/001-hello-node/20260728_142100_0007-flow-edge-cases.md

@@ -0,0 +1,44 @@
+# Test Run: 0007-flow-edge-cases
+
+**Repo**: 001-hello-node  
+**Version**: @ibgib/vcs-gib v0.0.3  
+**Date**: 2026-07-28 14:21 local  
+**Tester**: agent (Antigravity)  
+**Run from**: `tmp/001-hello-node/` (via `node scripts/prep-run.js 001-hello-node`)
+
+---
+
+## Results
+
+| Step | Command | Status | Notes |
+|---|---|---|---|
+| 1 | `ibgib --version` | ✅ PASS | `@ibgib/vcs-gib v0.0.3` |
+| 2 | `ibgib init .` | ✅ PASS | Initialized, `.vcsgib/ibgib/b2s_main/` created |
+| 3 | `ibgib init .` (already initialized) | ⚠️ PARTIAL | No error — succeeds silently, generates a new root item hash. Does not warn or no-op. |
+| 4 | `ibgib add -a` | ✅ PASS | All 3 files staged |
+| 5 | `ibgib commit -m "initial"` | ✅ PASS | `[main 66A4276]`, 3 file(s) changed |
+| 6 | `ibgib commit -m "empty"` (nothing staged) | ✅ PASS | Error: "Nothing to commit (no staged items)", exit code 1 |
+| 7 | `ibgib commit` (no `-m` flag) | ✅ PASS | Error: "Commit message is required", exit code 1 |
+| 8 | `ibgib checkout nonexistent-branch` | ✅ PASS | Error: "Branch 'nonexistent-branch' does not exist", exit code 1 |
+| 9 | `ibgib branch feature-x` | ✅ PASS | "Created branch 'feature-x'" |
+| 10 | `ibgib branch feature-x` (already exists) | ✅ PASS | Error: "Branch 'feature-x' already exists", exit code 1 |
+| 11 | `ibgib add nonexistent.js` | ✅ PASS | Error: "Path does not exist: nonexistent.js", exit code 1 |
+| 12 | `ibgib add` (no args) | ⚠️ PARTIAL | Silent exit 0 — no output, no error, no usage hint. Expected: error or usage hint. |
+
+---
+
+## Summary
+
+- **Total steps**: 12
+- **Passed**: 10
+- **Failed**: 0
+- **Partial**: 2 (steps 3, 12)
+- **Skipped**: 0
+
+## Findings / Bugs
+
+**Step 3 — `ibgib init .` on already-initialized repo**  
+Re-init completes successfully and generates a *new* root item hash instead of erroring or no-oping. This could silently clobber an existing repo's init state. Expected behavior: detect `.vcsgib/` already present and either error with "Already initialized" or explicitly no-op with a message.
+
+**Step 12 — `ibgib add` with no arguments**  
+Silent exit 0 with no output. Expected: either an error ("No path specified") or a usage hint. The silent success could be confusing to users who accidentally omit arguments.

package/test_runs/001-hello-node/20260728_142400_0005-flow-hardcoded-ignores.md

@@ -0,0 +1,36 @@
+# Test Run: 0005-flow-hardcoded-ignores
+
+**Repo**: 001-hello-node  
+**Version**: @ibgib/vcs-gib v0.0.3  
+**Date**: 2026-07-28 14:24 local  
+**Tester**: agent (Antigravity)  
+**Run from**: `tmp/001-hello-node/` (via `node scripts/prep-run.js 001-hello-node`)
+
+---
+
+## Results
+
+| Step | Command | Status | Notes |
+|---|---|---|---|
+| 1 | `ibgib --version` | ✅ PASS | `@ibgib/vcs-gib v0.0.3` |
+| 2 | `ibgib init .` | ✅ PASS | Initialized |
+| 3 | `ibgib add -a` | ✅ PASS | All 3 files staged |
+| 4 | `ibgib commit -m "initial"` | ✅ PASS | `[main 2A7E4E7]`, 3 file(s) changed |
+| 5 | *(create `node_modules/lodash/index.js`)* | ✅ PASS | Directory created |
+| 6 | `ibgib status` | ✅ PASS | "nothing to commit, working tree clean" — `node_modules/` absent ✅ |
+| 7 | *(create `.git/HEAD`)* | ✅ PASS | Directory created |
+| 8 | `ibgib status` | ✅ PASS | "nothing to commit, working tree clean" — `.git/` absent ✅ |
+| 9 | `ibgib add -a` | ✅ PASS | Silent exit 0, nothing staged — ignored dirs correctly excluded |
+
+---
+
+## Summary
+
+- **Total steps**: 9
+- **Passed**: 9
+- **Failed**: 0
+- **Skipped**: 0
+
+## Findings / Bugs
+
+None. `node_modules/` and `.git/` are both correctly suppressed from `status` output and from `add -a` staging. Hardcoded ignore behavior is working as intended in v0.0.3.

package/tools/pack-for-test.mjs

@@ -0,0 +1,73 @@
+/**
+ * @file pack-for-test.mjs
+ * 
+ * Builds vcs-gib, bumps the patch version in package.json, packs the npm tarball,
+ * and deploys it to the downstream test_repos/packages/ directory for hermetic testing.
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const vcsGibDir = path.resolve(__dirname, '..');
+const monorepoRoot = path.resolve(vcsGibDir, '../..');
+
+// 1. Load .env from monorepo root if present
+const envPath = path.join(monorepoRoot, '.env');
+let testPackageDir = process.env.VCS_GIB_TEST_PACKAGE_DIR || process.env.TEST_REPOS_PACKAGES_DIR;
+
+if (!testPackageDir && fs.existsSync(envPath)) {
+    const envContent = fs.readFileSync(envPath, 'utf8');
+    for (const line of envContent.split('\n')) {
+        const match = line.match(/^\s*(VCS_GIB_TEST_PACKAGE_DIR|TEST_REPOS_PACKAGES_DIR)\s*=\s*["']?([^"'\r\n]+)["']?/);
+        if (match) {
+            testPackageDir = match[2];
+            break;
+        }
+    }
+}
+
+if (!testPackageDir) {
+    testPackageDir = 'c:\\Users\\billm\\antigravity\\test_repos\\packages';
+}
+
+console.log(`[pack-for-test] Target test packages dir: ${testPackageDir}`);
+
+// 2. Bump patch version in apps/vcs-gib/package.json
+const pkgPath = path.join(vcsGibDir, 'package.json');
+const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+const currentVersion = pkg.version || '0.0.0';
+const versionParts = currentVersion.split('.').map(Number);
+versionParts[2] = (versionParts[2] || 0) + 1;
+const newVersion = versionParts.join('.');
+pkg.version = newVersion;
+fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+console.log(`[pack-for-test] Bumped version from ${currentVersion} to ${newVersion}`);
+
+// 3. Build vcs-gib
+console.log(`[pack-for-test] Running npm run build:vcs-gib...`);
+execSync('npm run build:vcs-gib', { cwd: monorepoRoot, stdio: 'inherit' });
+
+// 4. Pack tarball
+console.log(`[pack-for-test] Packing npm tarball...`);
+const packOutput = execSync('npm pack', { cwd: vcsGibDir, encoding: 'utf8' }).trim();
+const tarballName = packOutput.split('\n').pop().trim();
+const tarballPath = path.join(vcsGibDir, tarballName);
+console.log(`[pack-for-test] Packed tarball: ${tarballName}`);
+
+// 5. Ensure target directory exists & copy tarball to vcs-gib-latest.tgz
+fs.mkdirSync(testPackageDir, { recursive: true });
+const targetLatestPath = path.join(testPackageDir, 'vcs-gib-latest.tgz');
+const targetVersionedPath = path.join(testPackageDir, `vcs-gib-${newVersion}.tgz`);
+
+fs.copyFileSync(tarballPath, targetLatestPath);
+fs.copyFileSync(tarballPath, targetVersionedPath);
+fs.unlinkSync(tarballPath);
+
+console.log(`[pack-for-test] Successfully deployed to:`);
+console.log(`  - ${targetLatestPath}`);
+console.log(`  - ${targetVersionedPath}`);

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "module": "ESNext"
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}