@ibgib/vcs-gib 0.0.6

package/dist/engine/branch/branch-space-helper.d.mts

@@ -0,0 +1,22 @@
+/**
+ * @module branch-space-helper
+ *
+ * Helper for managing dedicated branch spaces (`b2s_...`) in metaspace.
+ */
+import { Metaspace_Nodespace } from '@ibgib/node-gib/dist/witness/space/metaspace/metaspace-nodespace/metaspace-nodespace.mjs';
+import { NodeFilesystemSpace_V1 } from '@ibgib/node-gib/dist/witness/space/node-filesystem-space/node-filesystem-space-v1.mjs';
+export interface GetOrCreateBranchSpaceOpts {
+    metaspace: Metaspace_Nodespace;
+    vcsPath: string;
+    branchName: string;
+}
+export interface GetOrCreateBranchSpaceResult {
+    space: NodeFilesystemSpace_V1;
+    spaceId: string;
+    spaceName: string;
+}
+/**
+ * Gets an existing branch space or creates and registers a new dedicated NodeFilesystemSpace_V1 in metaspace.
+ */
+export declare function getOrCreateBranchSpace({ metaspace, vcsPath, branchName, }: GetOrCreateBranchSpaceOpts): Promise<GetOrCreateBranchSpaceResult>;
+//# sourceMappingURL=branch-space-helper.d.mts.map

package/dist/engine/branch/branch-space-helper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-space-helper.d.mts","sourceRoot":"","sources":["../../../src/engine/branch/branch-space-helper.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0FAA0F,CAAC;AAC/H,OAAO,EAAE,sBAAsB,EAAE,MAAM,uFAAuF,CAAC;AAU/H,MAAM,WAAW,0BAA0B;IACvC,SAAS,EAAE,mBAAmB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,4BAA4B;IACzC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,EACzC,SAAS,EACT,OAAO,EACP,UAAU,GACb,EAAE,0BAA0B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAiEpE"}

package/dist/engine/branch/branch-space-helper.mjs

@@ -0,0 +1,77 @@
+/**
+ * @module branch-space-helper
+ *
+ * Helper for managing dedicated branch spaces (`b2s_...`) in metaspace.
+ */
+import { clone, extractErrorMsg, getUUID } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { getGib } from '@ibgib/ts-gib/dist/V1/transforms/transform-helper.mjs';
+import { NodeFilesystemSpace_V1 } from '@ibgib/node-gib/dist/witness/space/node-filesystem-space/node-filesystem-space-v1.mjs';
+import { DEFAULT_NODE_FILESYSTEM_SPACE_DATA_V1 } from '@ibgib/node-gib/dist/witness/space/node-filesystem-space/node-filesystem-space-types.mjs';
+import { putInSpace } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
+import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
+import { getB2tFSBranchSpaceName } from './branch-helper.mjs';
+const lcFile = `[branch-space-helper]`;
+const logalot = GLOBAL_LOG_A_LOT;
+/**
+ * Gets an existing branch space or creates and registers a new dedicated NodeFilesystemSpace_V1 in metaspace.
+ */
+export async function getOrCreateBranchSpace({ metaspace, vcsPath, branchName, }) {
+    const lc = `${lcFile}[${getOrCreateBranchSpace.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: a1b2c3d4e5f60718293a4b5c6d7e8f9a)`);
+        }
+        if (!metaspace || !vcsPath || !branchName) {
+            throw new Error(`metaspace, vcsPath, and branchName are required (E: b2c3d4e5f60718293a4b5c6d7e8f9a0b)`);
+        }
+        const spaceName = getB2tFSBranchSpaceName(branchName);
+        const localSpaces = await metaspace.getLocalUserSpaces({ lock: false });
+        const existingSpace = localSpaces.find(s => s.data?.name === spaceName || s.ib === spaceName);
+        if (existingSpace) {
+            const spaceId = existingSpace.data?.uuid || existingSpace.data?.spaceId || spaceName;
+            if (logalot) {
+                console.log(`${lc} Found existing branch space ${spaceName} (spaceId: ${spaceId}) (I: c3d4e5f60718293a4b5c6d7e8f9a0b1c)`);
+            }
+            return {
+                space: existingSpace,
+                spaceId,
+                spaceName,
+            };
+        }
+        const spaceUuid = await getUUID();
+        const spaceData = {
+            ...clone(DEFAULT_NODE_FILESYSTEM_SPACE_DATA_V1),
+            uuid: spaceUuid,
+            isTjp: true,
+            name: spaceName,
+            baseDir: vcsPath,
+            spaceSubPath: spaceName,
+        };
+        const space = new NodeFilesystemSpace_V1(spaceData);
+        space.gib = await getGib({ ibGib: space, hasTjp: true });
+        await space.initialized;
+        await putInSpace({ space: metaspace.zeroSpace, ibGib: space });
+        await metaspace.registerNewIbGib({ ibGib: space });
+        if (metaspace.fnUpdateBootstrap) {
+            await metaspace.fnUpdateBootstrap(space);
+        }
+        if (logalot) {
+            console.log(`${lc} Created new branch space ${spaceName} (spaceId: ${spaceUuid}) (I: d4e5f60718293a4b5c6d7e8f9a0b1c2d)`);
+        }
+        return {
+            space,
+            spaceId: spaceUuid,
+            spaceName,
+        };
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)} (E: e5f60718293a4b5c6d7e8f9a0b1c2d3e)`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete. (I: f60718293a4b5c6d7e8f9a0b1c2d3e4f)`);
+        }
+    }
+}
+//# sourceMappingURL=branch-space-helper.mjs.map

package/dist/engine/branch/branch-space-helper.mjs.map

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

package/dist/engine/branch/branch-space.respec.node.d.mts

@@ -0,0 +1,8 @@
+/**
+ * @module branch-space.respec.node
+ *
+ * Unit tests for branch space helper, space-qualified address formatting/parsing,
+ * and graph population into branch spaces.
+ */
+export {};
+//# sourceMappingURL=branch-space.respec.node.d.mts.map

package/dist/engine/branch/branch-space.respec.node.d.mts.map

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

package/dist/engine/branch/branch-space.respec.node.mjs

@@ -0,0 +1,138 @@
+/**
+ * @module branch-space.respec.node
+ *
+ * Unit tests for branch space helper, space-qualified address formatting/parsing,
+ * and graph population into branch spaces.
+ */
+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 { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
+import { getFromSpace, persistTransformResult } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
+import { bootstrapVcsMetaspace } from '../../bootstrap/node-bootstrap.mjs';
+import { getB2tFSItemIb } from '../item/item-atom-helper.mjs';
+import { getOrCreateBranchSpace } from './branch-space-helper.mjs';
+import { populateBranchSpaceFromGraph } from './branch-graph-helper.mjs';
+import { getSpaceQualifiedIbGibAddr, parseSpaceQualifiedIbGibAddr } from '../index/index-helper.mjs';
+const lc = `[apps/vcs-gib/src/engine/branch/branch-space.respec.node.mts]`;
+await respecfully(lc, `Branch Space & Graph Helper Respecs`, async () => {
+    await respecfully(lc, `Space-Qualified Address Parsing & Formatting`, async () => {
+        await ifWe(lc, `formats space-qualified address using options object`, async () => {
+            const sq = getSpaceQualifiedIbGibAddr({ spaceId: 'sp_alpha', ibGibAddr: 'item_a^gib123' });
+            iReckon(lc, sq).willEqual('v:1^spaceId:sp_alpha^item_a^gib123');
+        });
+        await ifWe(lc, `parses space-qualified address using options object`, async () => {
+            const parsed = parseSpaceQualifiedIbGibAddr({ spaceQualifiedAddr: 'v:1^spaceId:sp_alpha^item_a^gib123' });
+            iReckon(lc, parsed).isGonnaBeTruthy();
+            iReckon(lc, parsed.version).willEqual(1);
+            iReckon(lc, parsed.spaceId).willEqual('sp_alpha');
+            iReckon(lc, parsed.ibGibAddr).willEqual('item_a^gib123');
+            iReckon(lc, parsed.ib).willEqual('item_a');
+            iReckon(lc, parsed.gib).willEqual('gib123');
+        });
+        await ifWe(lc, `returns null for invalid space-qualified address string`, async () => {
+            const parsed = parseSpaceQualifiedIbGibAddr({ spaceQualifiedAddr: 'invalid_address_string' });
+            iReckon(lc, parsed).isGonnaBeFalsy();
+        });
+    });
+    await respecfully(lc, `Branch Space Lifecycle (getOrCreateBranchSpace)`, async () => {
+        await ifWe(lc, `creates a new dedicated branch space and retrieves existing space on second call`, async () => {
+            const testDir = path.join(process.cwd(), '.test_branch_space_repo');
+            try {
+                const { metaspace, vcsPath } = await bootstrapVcsMetaspace({
+                    repoPath: testDir,
+                    vcsFolderName: '.vcsgib_branch_test',
+                    defaultSpaceName: 'test_space',
+                });
+                const branchName = 'feature_alpha';
+                const result1 = await getOrCreateBranchSpace({
+                    metaspace,
+                    vcsPath,
+                    branchName,
+                });
+                iReckon(lc, result1.spaceName).willEqual('b2s_feature_alpha');
+                iReckon(lc, result1.spaceId).isGonnaBeTruthy();
+                iReckon(lc, result1.space).isGonnaBeTruthy();
+                const result2 = await getOrCreateBranchSpace({
+                    metaspace,
+                    vcsPath,
+                    branchName,
+                });
+                iReckon(lc, result2.spaceName).willEqual('b2s_feature_alpha');
+                iReckon(lc, result2.spaceId).willEqual(result1.spaceId);
+            }
+            finally {
+                await fs.rm(testDir, { recursive: true, force: true });
+            }
+        });
+    });
+    await respecfully(lc, `Graph Population (populateBranchSpaceFromGraph)`, async () => {
+        await ifWe(lc, `populates target branch space with full dependency graph of root item`, async () => {
+            const testDir = path.join(process.cwd(), '.test_populate_graph_repo');
+            try {
+                const { metaspace, localSpace, vcsPath } = await bootstrapVcsMetaspace({
+                    repoPath: testDir,
+                    vcsFolderName: '.vcsgib_populate_test',
+                    defaultSpaceName: 'test_space',
+                });
+                // Create child file item
+                const childRes = await Factory_V1.firstGen({
+                    parentIbGib: ROOT,
+                    ib: getB2tFSItemIb('file', 'file.txt', 'file_hash'),
+                    data: {
+                        name: 'file.txt',
+                        nameHash: 'file_hash',
+                        fsType: 'file',
+                        diffTransactionId: 'tx_child',
+                    },
+                });
+                const childItem = childRes.newIbGib;
+                const childAddr = getIbGibAddr({ ibGib: childItem });
+                await persistTransformResult({ resTransform: childRes, space: localSpace });
+                await metaspace.registerNewIbGib({ ibGib: childItem });
+                // Create root folder item referencing child
+                const rootRes = await Factory_V1.firstGen({
+                    parentIbGib: ROOT,
+                    ib: getB2tFSItemIb('folder', 'root', 'root_hash'),
+                    data: {
+                        name: 'root',
+                        nameHash: 'root_hash',
+                        fsType: 'folder',
+                        diffTransactionId: 'tx_root',
+                    },
+                    rel8ns: {
+                        b2tfs_item: [childAddr],
+                    },
+                });
+                const rootItem = rootRes.newIbGib;
+                const rootAddr = getIbGibAddr({ ibGib: rootItem });
+                await persistTransformResult({ resTransform: rootRes, space: localSpace });
+                await metaspace.registerNewIbGib({ ibGib: rootItem });
+                // Create target branch space
+                const { space: targetBranchSpace } = await getOrCreateBranchSpace({
+                    metaspace,
+                    vcsPath,
+                    branchName: 'main',
+                });
+                // Populate target branch space from source localSpace graph
+                await populateBranchSpaceFromGraph({
+                    sourceSpace: localSpace,
+                    targetBranchSpace,
+                    rootItemIbGib: rootItem,
+                    metaspace,
+                });
+                // Verify items exist in targetBranchSpace
+                const rootGet = await getFromSpace({ space: targetBranchSpace, addr: rootAddr });
+                iReckon(lc, rootGet).isGonnaBeTruthy();
+                const childGet = await getFromSpace({ space: targetBranchSpace, addr: childAddr });
+                iReckon(lc, childGet).isGonnaBeTruthy();
+            }
+            finally {
+                await fs.rm(testDir, { recursive: true, force: true });
+            }
+        });
+    });
+});
+//# sourceMappingURL=branch-space.respec.node.mjs.map

package/dist/engine/branch/branch-space.respec.node.mjs.map

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

package/dist/engine/branch/branch-types.d.mts

@@ -0,0 +1,26 @@
+/**
+ * @module branch-types
+ *
+ * B2tFS Branch 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';
+export interface B2tFSBranchData_V1 extends IbGibData_V1 {
+    /**
+     * Branch name (e.g. 'main', 'feature/login')
+     */
+    name: string;
+    /**
+     * Relative path from repository root to working directory
+     */
+    relativePathFromMetaspaceToFSPath?: string;
+}
+export interface B2tFSBranchRel8ns_V1 extends IbGibRel8ns_V1 {
+    /**
+     * Link pointing to the root folder B2tFSItemIbGib_V1
+     */
+    b2tfs_item?: IbGibAddr[];
+}
+export interface B2tFSBranchIbGib_V1 extends IbGib_V1<B2tFSBranchData_V1, B2tFSBranchRel8ns_V1> {
+}
+//# sourceMappingURL=branch-types.d.mts.map

package/dist/engine/branch/branch-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-types.d.mts","sourceRoot":"","sources":["../../../src/engine/branch/branch-types.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEzF,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACpD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,iCAAiC,CAAC,EAAE,MAAM,CAAC;CAC9C;AAED,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IACxD;;OAEG;IACH,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAoB,SAAQ,QAAQ,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;CAC9F"}

package/dist/engine/branch/branch-types.mjs

@@ -0,0 +1,7 @@
+/**
+ * @module branch-types
+ *
+ * B2tFS Branch type definitions.
+ */
+export {};
+//# sourceMappingURL=branch-types.mjs.map

package/dist/engine/branch/branch-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-types.mjs","sourceRoot":"","sources":["../../../src/engine/branch/branch-types.mts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/engine/diff/line-diff-helper.d.mts

@@ -0,0 +1,76 @@
+/**
+ * @module line-diff-helper
+ *
+ * Native, zero-dependency Myers / LCS line-diffing engine for text files.
+ *
+ * Computes precise line-by-line diff chunks between text files without external libraries.
+ */
+export interface LineDiffChunk {
+    /**
+     * Line index in old text where the chunk starts (0-indexed)
+     */
+    old_i: number;
+    /**
+     * Deleted lines from old text
+     */
+    oldLines: string[];
+    /**
+     * Inserted lines in new text
+     */
+    newLines: string[];
+}
+export interface LineDiffResult {
+    /**
+     * Array of line diff chunks
+     */
+    chunks: LineDiffChunk[];
+    /**
+     * Set if total lines exceed max limit and force flag was false
+     */
+    tooBig?: boolean;
+    /**
+     * Set if binary data was detected and force flag was false
+     */
+    treatedAsBinary?: boolean;
+}
+export interface LineDiffOpts {
+    /**
+     * Old file data buffer (optional if new file addition)
+     */
+    oldData?: Uint8Array;
+    /**
+     * New file data buffer
+     */
+    newData: Uint8Array;
+    /**
+     * File encoding (defaults to 'utf8')
+     */
+    fileEncoding?: string;
+    /**
+     * Max line count limit before requiring force flag (defaults to 10000)
+     */
+    maxLines?: number;
+    /**
+     * Force diff computation even if file is large or binary
+     */
+    force?: boolean;
+}
+/**
+ * Basic binary detection check.
+ * Checks for null bytes (0x00) within the first 1024 bytes.
+ */
+export declare function isBinaryBuffer(data: Uint8Array): boolean;
+/**
+ * Decodes Uint8Array buffer into array of text lines.
+ */
+export declare function decodeToLines(data?: Uint8Array, encoding?: string): string[];
+/**
+ * Computes Longest Common Subsequence (LCS) edit script between two arrays of lines.
+ * Returns array of LineDiffChunk structures.
+ */
+export declare function computeLineLcsDiff(oldLines: string[], newLines: string[]): LineDiffChunk[];
+/**
+ * Main line diff helper function for text files.
+ */
+export declare function getLineDiffChunks(opts: LineDiffOpts): LineDiffResult;
+//# sourceMappingURL=line-diff-helper.d.mts.map

package/dist/engine/diff/line-diff-helper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-diff-helper.d.mts","sourceRoot":"","sources":["../../../src/engine/diff/line-diff-helper.mts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,WAAW,aAAa;IAC1B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC3B;;OAEG;IACH,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB;;OAEG;IACH,OAAO,EAAE,UAAU,CAAC;IACpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAMxD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,QAAQ,GAAE,MAAe,GAAG,MAAM,EAAE,CASpF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CA8E1F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CA8BpE"}

package/dist/engine/diff/line-diff-helper.mjs

@@ -0,0 +1,144 @@
+/**
+ * @module line-diff-helper
+ *
+ * Native, zero-dependency Myers / LCS line-diffing engine for text files.
+ *
+ * Computes precise line-by-line diff chunks between text files without external libraries.
+ */
+import { GLOBAL_LOG_A_LOT } from '../../vcs-gib-constants.mjs';
+const lcFile = `[line-diff-helper]`;
+const logalot = GLOBAL_LOG_A_LOT;
+/**
+ * Basic binary detection check.
+ * Checks for null bytes (0x00) within the first 1024 bytes.
+ */
+export function isBinaryBuffer(data) {
+    const sampleSize = Math.min(data.length, 1024);
+    for (let i = 0; i < sampleSize; i++) {
+        if (data[i] === 0) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Decodes Uint8Array buffer into array of text lines.
+ */
+export function decodeToLines(data, encoding = 'utf8') {
+    if (!data || data.length === 0) {
+        return [];
+    }
+    try {
+        const textDecoder = new TextDecoder(encoding || 'utf8', { fatal: false });
+        const text = textDecoder.decode(data);
+        return text.split(/\r?\n/);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Computes Longest Common Subsequence (LCS) edit script between two arrays of lines.
+ * Returns array of LineDiffChunk structures.
+ */
+export function computeLineLcsDiff(oldLines, newLines) {
+    const M = oldLines.length;
+    const N = newLines.length;
+    // Fast path: identical lines
+    if (M === N && oldLines.every((line, idx) => line === newLines[idx])) {
+        return [];
+    }
+    // Build LCS DP matrix
+    const dp = Array.from({ length: M + 1 }, () => new Array(N + 1).fill(0));
+    for (let i = 1; i <= M; i++) {
+        for (let j = 1; j <= N; j++) {
+            if (oldLines[i - 1] === newLines[j - 1]) {
+                dp[i][j] = dp[i - 1][j - 1] + 1;
+            }
+            else {
+                dp[i][j] = Math.max(dp[i - 1][j], dp[i][j - 1]);
+            }
+        }
+    }
+    // Backtrack to build edit script
+    let i = M;
+    let j = N;
+    const rawEdits = [];
+    while (i > 0 || j > 0) {
+        if (i > 0 && j > 0 && oldLines[i - 1] === newLines[j - 1]) {
+            rawEdits.push({ type: 'equal', oldIdx: i - 1, line: oldLines[i - 1] });
+            i--;
+            j--;
+        }
+        else if (j > 0 && (i === 0 || dp[i][j - 1] >= dp[i - 1][j])) {
+            rawEdits.push({ type: 'insert', line: newLines[j - 1] });
+            j--;
+        }
+        else if (i > 0 && (j === 0 || dp[i][j - 1] < dp[i - 1][j])) {
+            rawEdits.push({ type: 'delete', oldIdx: i - 1, line: oldLines[i - 1] });
+            i--;
+        }
+    }
+    rawEdits.reverse();
+    // Group edit operations into chunks
+    const chunks = [];
+    let currentChunk = null;
+    let oldLineCursor = 0;
+    for (const edit of rawEdits) {
+        if (edit.type === 'equal') {
+            if (currentChunk) {
+                chunks.push(currentChunk);
+                currentChunk = null;
+            }
+            oldLineCursor++;
+        }
+        else {
+            if (!currentChunk) {
+                currentChunk = {
+                    old_i: oldLineCursor,
+                    oldLines: [],
+                    newLines: [],
+                };
+            }
+            if (edit.type === 'delete') {
+                currentChunk.oldLines.push(edit.line);
+                oldLineCursor++;
+            }
+            else if (edit.type === 'insert') {
+                currentChunk.newLines.push(edit.line);
+            }
+        }
+    }
+    if (currentChunk) {
+        chunks.push(currentChunk);
+    }
+    return chunks;
+}
+/**
+ * Main line diff helper function for text files.
+ */
+export function getLineDiffChunks(opts) {
+    const lc = `${lcFile}[${getLineDiffChunks.name}]`;
+    const { oldData, newData, fileEncoding = 'utf8', maxLines = 10000, force = false, } = opts;
+    // Check for binary data
+    const oldIsBin = oldData ? isBinaryBuffer(oldData) : false;
+    const newIsBin = isBinaryBuffer(newData);
+    if ((oldIsBin || newIsBin) && !force) {
+        if (logalot) {
+            console.log(`${lc} Binary data detected, skipping line diff.`);
+        }
+        return { chunks: [], treatedAsBinary: true };
+    }
+    const oldLines = decodeToLines(oldData, fileEncoding);
+    const newLines = decodeToLines(newData, fileEncoding);
+    // Check max lines threshold
+    if ((oldLines.length > maxLines || newLines.length > maxLines) && !force) {
+        if (logalot) {
+            console.log(`${lc} Line count exceeds limit (${maxLines}), skipping line diff.`);
+        }
+        return { chunks: [], tooBig: true };
+    }
+    const chunks = computeLineLcsDiff(oldLines, newLines);
+    return { chunks };
+}
+//# sourceMappingURL=line-diff-helper.mjs.map

package/dist/engine/diff/line-diff-helper.mjs.map

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

package/dist/engine/diff/line-diff-helper.respec.node.d.mts

@@ -0,0 +1,7 @@
+/**
+ * @module line-diff-helper.respec
+ *
+ * Unit tests for native zero-dependency Myers / LCS line-diffing engine.
+ */
+export {};
+//# sourceMappingURL=line-diff-helper.respec.node.d.mts.map

package/dist/engine/diff/line-diff-helper.respec.node.d.mts.map

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

package/dist/engine/diff/line-diff-helper.respec.node.mjs

@@ -0,0 +1,66 @@
+/**
+ * @module line-diff-helper.respec
+ *
+ * Unit tests for native zero-dependency Myers / LCS line-diffing engine.
+ */
+import { respecfully, ifWe, iReckon } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+import { isBinaryBuffer, computeLineLcsDiff, getLineDiffChunks } from './line-diff-helper.mjs';
+const lc = `[apps/vcs-gib/src/engine/diff/line-diff-helper.respec.node.mts]`;
+const encoder = new TextEncoder();
+await respecfully(lc, `Native Line Diff Engine (Zero-Dependency)`, async () => {
+    await respecfully(lc, `isBinaryBuffer`, async () => {
+        await ifWe(lc, `detects text buffer as non-binary`, async () => {
+            const buf = encoder.encode('Hello World\nLine 2');
+            iReckon(lc, isBinaryBuffer(buf)).isGonnaBeFalse();
+        });
+        await ifWe(lc, `detects null byte buffer as binary`, async () => {
+            const buf = new Uint8Array([0x48, 0x65, 0x00, 0x6c, 0x6f]);
+            iReckon(lc, isBinaryBuffer(buf)).isGonnaBeTrue();
+        });
+    });
+    await respecfully(lc, `computeLineLcsDiff`, async () => {
+        await ifWe(lc, `returns empty chunks for identical lines`, async () => {
+            const lines = ['line 1', 'line 2', 'line 3'];
+            const chunks = computeLineLcsDiff(lines, lines);
+            iReckon(lc, chunks.length).willEqual(0);
+        });
+        await ifWe(lc, `computes single line insertion chunk`, async () => {
+            const oldLines = ['line 1', 'line 3'];
+            const newLines = ['line 1', 'line 2', 'line 3'];
+            const chunks = computeLineLcsDiff(oldLines, newLines);
+            iReckon(lc, chunks.length).willEqual(1);
+            iReckon(lc, chunks[0].old_i).willEqual(1);
+            iReckon(lc, chunks[0].oldLines.length).willEqual(0);
+            iReckon(lc, chunks[0].newLines.length).willEqual(1);
+            iReckon(lc, chunks[0].newLines[0]).willEqual('line 2');
+        });
+        await ifWe(lc, `computes line replacement chunk`, async () => {
+            const oldLines = ['const x = 1;', 'const y = 2;'];
+            const newLines = ['const x = 1;', 'const y = 20;'];
+            const chunks = computeLineLcsDiff(oldLines, newLines);
+            iReckon(lc, chunks.length).willEqual(1);
+            iReckon(lc, chunks[0].old_i).willEqual(1);
+            iReckon(lc, chunks[0].oldLines[0]).willEqual('const y = 2;');
+            iReckon(lc, chunks[0].newLines[0]).willEqual('const y = 20;');
+        });
+    });
+    await respecfully(lc, `getLineDiffChunks`, async () => {
+        await ifWe(lc, `computes line diff for text buffers`, async () => {
+            const oldData = encoder.encode('alpha\nbeta\ngamma');
+            const newData = encoder.encode('alpha\nbeta_updated\ngamma');
+            const result = getLineDiffChunks({ oldData, newData });
+            iReckon(lc, result.treatedAsBinary).isGonnaBeUndefined();
+            iReckon(lc, result.chunks.length).willEqual(1);
+            iReckon(lc, result.chunks[0].oldLines[0]).willEqual('beta');
+            iReckon(lc, result.chunks[0].newLines[0]).willEqual('beta_updated');
+        });
+        await ifWe(lc, `flags binary data without force`, async () => {
+            const oldData = new Uint8Array([0x00, 0x01, 0x02]);
+            const newData = encoder.encode('hello');
+            const result = getLineDiffChunks({ oldData, newData });
+            iReckon(lc, result.treatedAsBinary).isGonnaBeTrue();
+            iReckon(lc, result.chunks.length).willEqual(0);
+        });
+    });
+});
+//# sourceMappingURL=line-diff-helper.respec.node.mjs.map

package/dist/engine/diff/line-diff-helper.respec.node.mjs.map

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