Merge branch 'core/CSMDict' into feature/#916_build-csm-with-pagination

Author: SingTheCode

packages/analysis-engine/src/csm.const.ts

@@ -63,12 +63,12 @@ describe("csm", () => {
   // Set mergedIntoStem flags based on merge structure
   // Node 8 (parents=[7, 13]) is merged into master at node 2
   // Node 11 (parents=[10, 16]) is merged into master at node 3
-  fakeCommitNodeDict.get("8")!.mergedIntoStem = "master";
-  fakeCommitNodeDict.get("11")!.mergedIntoStem = "master";
+  fakeCommitNodeDict.get("8")!.mergedIntoBaseStem = "master";
+  fakeCommitNodeDict.get("11")!.mergedIntoBaseStem = "master";
   // Node 13 is merged into sub1 at node 8
-  fakeCommitNodeDict.get("13")!.mergedIntoStem = "sub1";
+  fakeCommitNodeDict.get("13")!.mergedIntoBaseStem = "sub1";
   // Node 16 is merged into sub1 at node 11
-  fakeCommitNodeDict.get("16")!.mergedIntoStem = "sub1";
+  fakeCommitNodeDict.get("16")!.mergedIntoBaseStem = "sub1";
 
   describe("buildCSM", () => {
     let csmDict: CSMDictionary;
@@ -150,12 +150,12 @@ describe("csm", () => {
     // Set mergedIntoStem flags for sub1 as base branch
     // Node 8 (parents=[7, 13]) is merged into sub1 at itself
     // Node 11 (parents=[10, 16]) is merged into sub1 at itself
-    fakeCommitNodeDictWithSub1.get("8")!.mergedIntoStem = "sub1";
-    fakeCommitNodeDictWithSub1.get("11")!.mergedIntoStem = "sub1";
+    fakeCommitNodeDictWithSub1.get("8")!.mergedIntoBaseStem = "sub1";
+    fakeCommitNodeDictWithSub1.get("11")!.mergedIntoBaseStem = "sub1";
     // Node 13 is merged into sub1 at node 8
-    fakeCommitNodeDictWithSub1.get("13")!.mergedIntoStem = "sub1";
+    fakeCommitNodeDictWithSub1.get("13")!.mergedIntoBaseStem = "sub1";
     // Node 16 is merged into sub1 at node 11
-    fakeCommitNodeDictWithSub1.get("16")!.mergedIntoStem = "sub1";
+    fakeCommitNodeDictWithSub1.get("16")!.mergedIntoBaseStem = "sub1";
 
     beforeAll(() => {
       csmDict = buildCSMDict(fakeCommitNodeDictWithSub1, fakeStemDictWithSub1, "sub1");
@@ -180,6 +180,262 @@ describe("csm", () => {
     });
   });
 
+  describe("octopus merge (multiple parents)", () => {
+    // Test scenario: 3-way merge (octopus merge)
+    // master = [0, 1, 100]
+    // branch1 = [2, 3]
+    // branch2 = [4, 5]
+    // branch3 = [6, 7]
+    // 100 = merge(1, 3, 5, 7) - 4 parents octopus merge
+
+    const octopusCommitDict: Map<string, CommitRaw> = new Map<
+      string,
+      Pick<CommitRaw, "id" | "parents" | "branches" | "sequence">
+    >([
+      ["0", { id: "0", parents: [], branches: [], sequence: 9 }],
+      ["1", { id: "1", parents: ["0"], branches: [], sequence: 8 }],
+      ["2", { id: "2", parents: ["1"], branches: [], sequence: 7 }],
+      ["3", { id: "3", parents: ["2"], branches: ["branch1"], sequence: 6 }],
+      ["4", { id: "4", parents: ["1"], branches: [], sequence: 5 }],
+      ["5", { id: "5", parents: ["4"], branches: ["branch2"], sequence: 4 }],
+      ["6", { id: "6", parents: ["1"], branches: [], sequence: 3 }],
+      ["7", { id: "7", parents: ["6"], branches: ["branch3"], sequence: 2 }],
+      ["100", { id: "100", parents: ["1", "3", "5", "7"], branches: ["master"], sequence: 0 }],
+    ]) as Map<string, CommitRaw>;
+
+    const octopusStemDict: Map<string, Stem> = new Map([
+      [
+        "master",
+        {
+          nodes: ["100", "1", "0"]
+            .map((id) => octopusCommitDict.get(id))
+            .filter((commit): commit is CommitRaw => Boolean(commit))
+            .map((commit) => ({ stemId: "master", commit })),
+        },
+      ],
+      [
+        "branch1",
+        {
+          nodes: ["3", "2"]
+            .map((id) => octopusCommitDict.get(id))
+            .filter((commit): commit is CommitRaw => Boolean(commit))
+            .map((commit) => ({ stemId: "branch1", commit })),
+        },
+      ],
+      [
+        "branch2",
+        {
+          nodes: ["5", "4"]
+            .map((id) => octopusCommitDict.get(id))
+            .filter((commit): commit is CommitRaw => Boolean(commit))
+            .map((commit) => ({ stemId: "branch2", commit })),
+        },
+      ],
+      [
+        "branch3",
+        {
+          nodes: ["7", "6"]
+            .map((id) => octopusCommitDict.get(id))
+            .filter((commit): commit is CommitRaw => Boolean(commit))
+            .map((commit) => ({ stemId: "branch3", commit })),
+        },
+      ],
+    ]);
+
+    const octopusCommitNodeDict: Map<string, CommitNode> = Array.from(octopusStemDict.entries()).reduce(
+      (dict, [, stem]) => {
+        stem.nodes.forEach((commitNode) => {
+          dict.set(commitNode.commit.id, commitNode);
+        });
+        return dict;
+      },
+      new Map<string, CommitNode>()
+    );
+
+    // Set mergedIntoStem flags
+    octopusCommitNodeDict.get("3")!.mergedIntoBaseStem = "master";
+    octopusCommitNodeDict.get("5")!.mergedIntoBaseStem = "master";
+    octopusCommitNodeDict.get("7")!.mergedIntoBaseStem = "master";
+
+    it("should handle octopus merge with 4 parents", () => {
+      const csmDict = buildCSMDict(octopusCommitNodeDict, octopusStemDict, "master");
+
+      expect(csmDict.master).toBeDefined();
+      expect(csmDict.master.length).toBe(3); // 100, 1, 0
+
+      const octopusMergeNode = csmDict.master.find((node) => node.base.commit.id === "100");
+      expect(octopusMergeNode).toBeDefined();
+      expect(octopusMergeNode!.source.length).toBeGreaterThan(0);
+
+      // Should include all commits from all 3 branches: 3,2 + 5,4 + 7,6
+      const sourceIds = octopusMergeNode!.source.map((node) => node.commit.id);
+      expect(sourceIds).toContain("3");
+      expect(sourceIds).toContain("2");
+      expect(sourceIds).toContain("5");
+      expect(sourceIds).toContain("4");
+      expect(sourceIds).toContain("7");
+      expect(sourceIds).toContain("6");
+
+      // Should be sorted by sequence
+      const sequences = octopusMergeNode!.source.map((node) => node.commit.sequence);
+      const sortedSequences = [...sequences].sort((a, b) => a - b);
+      expect(sequences).toEqual(sortedSequences);
+    });
+  });
+
+  describe("single parent commits (early return)", () => {
+    const singleParentCommitDict: Map<string, CommitRaw> = new Map<
+      string,
+      Pick<CommitRaw, "id" | "parents" | "branches" | "sequence">
+    >([
+      ["initial", { id: "initial", parents: [], branches: [], sequence: 2 }],
+      ["normal", { id: "normal", parents: ["initial"], branches: [], sequence: 1 }],
+      ["latest", { id: "latest", parents: ["normal"], branches: ["master"], sequence: 0 }],
+    ]) as Map<string, CommitRaw>;
+
+    const singleParentStemDict: Map<string, Stem> = new Map([
+      [
+        "master",
+        {
+          nodes: ["latest", "normal", "initial"]
+            .map((id) => singleParentCommitDict.get(id))
+            .filter((commit): commit is CommitRaw => Boolean(commit))
+            .map((commit) => ({ stemId: "master", commit })),
+        },
+      ],
+    ]);
+
+    const singleParentCommitNodeDict: Map<string, CommitNode> = Array.from(singleParentStemDict.entries()).reduce(
+      (dict, [, stem]) => {
+        stem.nodes.forEach((commitNode) => {
+          dict.set(commitNode.commit.id, commitNode);
+        });
+        return dict;
+      },
+      new Map<string, CommitNode>()
+    );
+
+    it("should return empty source for initial commit (0 parents)", () => {
+      const csmDict = buildCSMDict(singleParentCommitNodeDict, singleParentStemDict, "master");
+
+      const initialNode = csmDict.master.find((node) => node.base.commit.id === "initial");
+      expect(initialNode).toBeDefined();
+      expect(initialNode!.source).toEqual([]);
+    });
+
+    it("should return empty source for normal commit (1 parent)", () => {
+      const csmDict = buildCSMDict(singleParentCommitNodeDict, singleParentStemDict, "master");
+
+      const normalNode = csmDict.master.find((node) => node.base.commit.id === "normal");
+      expect(normalNode).toBeDefined();
+      expect(normalNode!.source).toEqual([]);
+
+      const latestNode = csmDict.master.find((node) => node.base.commit.id === "latest");
+      expect(latestNode).toBeDefined();
+      expect(latestNode!.source).toEqual([]);
+    });
+  });
+
+  describe("edge case: non-existent parent commits", () => {
+    const edgeCaseCommitDict: Map<string, CommitRaw> = new Map<
+      string,
+      Pick<CommitRaw, "id" | "parents" | "branches" | "sequence">
+    >([
+      ["0", { id: "0", parents: [], branches: [], sequence: 4 }],
+      ["1", { id: "1", parents: ["0"], branches: [], sequence: 3 }],
+      ["2", { id: "2", parents: ["1"], branches: ["branch1"], sequence: 2 }],
+      // "phantom" is not in commitDict
+      ["merge", { id: "merge", parents: ["1", "2", "phantom"], branches: ["master"], sequence: 0 }],
+    ]) as Map<string, CommitRaw>;
+
+    const edgeCaseStemDict: Map<string, Stem> = new Map([
+      [
+        "master",
+        {
+          nodes: ["merge", "1", "0"]
+            .map((id) => edgeCaseCommitDict.get(id))
+            .filter((commit): commit is CommitRaw => Boolean(commit))
+            .map((commit) => ({ stemId: "master", commit })),
+        },
+      ],
+      [
+        "branch1",
+        {
+          nodes: ["2"]
+            .map((id) => edgeCaseCommitDict.get(id))
+            .filter((commit): commit is CommitRaw => Boolean(commit))
+            .map((commit) => ({ stemId: "branch1", commit })),
+        },
+      ],
+    ]);
+
+    const edgeCaseCommitNodeDict: Map<string, CommitNode> = Array.from(edgeCaseStemDict.entries()).reduce(
+      (dict, [, stem]) => {
+        stem.nodes.forEach((commitNode) => {
+          dict.set(commitNode.commit.id, commitNode);
+        });
+        return dict;
+      },
+      new Map<string, CommitNode>()
+    );
+
+    edgeCaseCommitNodeDict.get("2")!.mergedIntoBaseStem = "master";
+
+    it("should filter out non-existent parent commits", () => {
+      const csmDict = buildCSMDict(edgeCaseCommitNodeDict, edgeCaseStemDict, "master");
+
+      const mergeNode = csmDict.master.find((node) => node.base.commit.id === "merge");
+      expect(mergeNode).toBeDefined();
+
+      // Should only include commit "2", not "phantom"
+      const sourceIds = mergeNode!.source.map((node) => node.commit.id);
+      expect(sourceIds).toContain("2");
+      expect(sourceIds).not.toContain("phantom");
+    });
+  });
+
+  describe("edge case: all parents are invalid", () => {
+    const allInvalidCommitDict: Map<string, CommitRaw> = new Map<
+      string,
+      Pick<CommitRaw, "id" | "parents" | "branches" | "sequence">
+    >([
+      ["0", { id: "0", parents: [], branches: [], sequence: 2 }],
+      ["1", { id: "1", parents: ["0"], branches: [], sequence: 1 }],
+      // All merge parents are phantoms
+      ["merge", { id: "merge", parents: ["1", "phantom1", "phantom2"], branches: ["master"], sequence: 0 }],
+    ]) as Map<string, CommitRaw>;
+
+    const allInvalidStemDict: Map<string, Stem> = new Map([
+      [
+        "master",
+        {
+          nodes: ["merge", "1", "0"]
+            .map((id) => allInvalidCommitDict.get(id))
+            .filter((commit): commit is CommitRaw => Boolean(commit))
+            .map((commit) => ({ stemId: "master", commit })),
+        },
+      ],
+    ]);
+
+    const allInvalidCommitNodeDict: Map<string, CommitNode> = Array.from(allInvalidStemDict.entries()).reduce(
+      (dict, [, stem]) => {
+        stem.nodes.forEach((commitNode) => {
+          dict.set(commitNode.commit.id, commitNode);
+        });
+        return dict;
+      },
+      new Map<string, CommitNode>()
+    );
+
+    it("should return empty source when all merge parents are invalid", () => {
+      const csmDict = buildCSMDict(allInvalidCommitNodeDict, allInvalidStemDict, "master");
+
+      const mergeNode = csmDict.master.find((node) => node.base.commit.id === "merge");
+      expect(mergeNode).toBeDefined();
+      expect(mergeNode!.source).toEqual([]);
+    });
+  });
+
   describe("buildPaginatedCSMDict", () => {
     it("should load first page when lastCommitId is not provided", () => {
       const perPage = 2;

packages/analysis-engine/src/csm.spec.ts

@@ -3,7 +3,7 @@ import {
   extractNestedMergeParents,
   findSquashEndIndex,
   findSquashStartNodeIndex,
-  getMergeParentCommit,
+  getParentCommits,
 } from "./csm.util";
 import { convertPRCommitsToCommitNodes, convertPRDetailToCommitRaw } from "./pullRequest";
 import type { CommitDict, CommitNode, CSMDictionary, CSMNode, PullRequest, PullRequestDict, StemDict } from "./types";
@@ -13,19 +13,25 @@ import type { CommitDict, CommitNode, CSMDictionary, CSMNode, PullRequest, PullR
  * For merge commits, collects squashed commits using DFS traversal.
  */
 const buildCSMNode = (baseCommitNode: CommitNode, commitDict: CommitDict, stemDict: StemDict): CSMNode => {
+  if (baseCommitNode.commit.parents.length <= 1) {
+    return {
+      base: baseCommitNode,
+      source: [],
+    };
+  }
+
   // Return empty source for non-merge commits
-  const mergeParentCommit = getMergeParentCommit(baseCommitNode, commitDict);
-  if (!mergeParentCommit) {
+  const mergeParentCommits = getParentCommits(baseCommitNode, commitDict);
+  if (mergeParentCommits.length === 0) {
     return {
       base: baseCommitNode,
       source: [],
     };
   }
 
   const squashCommitNodes: CommitNode[] = [];
-  const squashTaskQueue: CommitNode[] = [mergeParentCommit];
 
-  // Collect commits to be squashed using DFS
+  const squashTaskQueue: CommitNode[] = [...mergeParentCommits];
   while (squashTaskQueue.length > 0) {
     const squashStartNode = squashTaskQueue.shift();
     if (!squashStartNode?.stemId) {

packages/analysis-engine/src/csm.ts

@@ -1,9 +1,11 @@
-import { MERGE_PARENT_INDEX } from "./csm.const";
 import type { CommitDict, CommitNode, Stem } from "./types";
 
 /** Gets the second parent (starting point of merged branch) of a merge commit. */
-export const getMergeParentCommit = (baseCommitNode: CommitNode, commitDict: CommitDict): CommitNode | undefined => {
-  return commitDict.get(baseCommitNode.commit.parents[MERGE_PARENT_INDEX]);
+export const getParentCommits = (baseCommitNode: CommitNode, commitDict: CommitDict): CommitNode[] => {
+  return baseCommitNode.commit.parents
+    .slice(1)
+    .map((parentId) => commitDict.get(parentId))
+    .filter((commit): commit is CommitNode => !!commit);
 };
 
 /** Finds the index of a specific commit node in a stem. */
@@ -19,7 +21,7 @@ export const findSquashEndIndex = (stem: Stem, startIndex: number): number => {
   let endIndex = stem.nodes.length - 1;
 
   for (let i = startIndex + 1; i < stem.nodes.length; i++) {
-    if (stem.nodes[i].mergedIntoStem) {
+    if (stem.nodes[i].mergedIntoBaseStem) {
       endIndex = i - 1;
       break;
     }

packages/analysis-engine/src/csm.util.ts

@@ -19,7 +19,7 @@ export function getStemNodes(
         if (idx === 0) return;
         const parentNode = commitDict.get(parent);
         if (parentNode) {
-          parentNode.mergedIntoStem = stemId;
+          parentNode.mergedIntoBaseStem = stemId;
           q.push(parentNode);
         }
       }, q);

packages/analysis-engine/src/stem.ts

@@ -4,7 +4,7 @@ export interface CommitNode {
   // stemId does not exist before traversal.
   stemId?: string;
   // ID of the stem this node was merged into (for merge parents)
-  mergedIntoStem?: string;
+  mergedIntoBaseStem?: string;
   commit: CommitRaw;
 }