Parse new access paths query BQRS output

Author: koesie10

extensions/ql-vscode/src/model-editor/languages/ruby/suggestions.ts

@@ -1,33 +1,58 @@
 import type { BaseLogger } from "../../../common/logging";
-import type { DecodedBqrsChunk } from "../../../common/bqrs-cli-types";
+import type {
+  BqrsCellValue,
+  BqrsEntityValue,
+  DecodedBqrsChunk,
+} from "../../../common/bqrs-cli-types";
 import type { ModelsAsDataLanguage } from "../models-as-data";
 import type { AccessPathSuggestionRow } from "../../suggestions";
 import { isDefinitionType } from "../../suggestions";
 import { parseRubyMethodFromPath, rubyMethodSignature } from "./access-paths";
 
+function checkTupleFormat(
+  tuple: BqrsCellValue[],
+): tuple is [string, string, string, BqrsEntityValue, string] {
+  if (tuple.length !== 5) {
+    return false;
+  }
+
+  const [type, methodName, value, node, definitionType] = tuple;
+  if (
+    typeof type !== "string" ||
+    typeof methodName !== "string" ||
+    typeof value !== "string" ||
+    typeof node !== "object" ||
+    typeof definitionType !== "string"
+  ) {
+    return false;
+  }
+
+  if (Array.isArray(node)) {
+    return false;
+  }
+
+  return true;
+}
+
 export function parseAccessPathSuggestionsResults(
   bqrs: DecodedBqrsChunk,
   _modelsAsDataLanguage: ModelsAsDataLanguage,
   logger: BaseLogger,
 ): AccessPathSuggestionRow[] {
   return bqrs.tuples
     .map((tuple, index): AccessPathSuggestionRow | null => {
-      const row = tuple.filter(
-        (value): value is string => typeof value === "string",
-      );
-
-      if (row.length !== 5) {
+      if (!checkTupleFormat(tuple)) {
         void logger.log(
-          `Skipping result ${index} because it has the wrong length`,
+          `Skipping result ${index} because it has the wrong format`,
         );
         return null;
       }
 
-      const type = row[0];
-      const methodName = parseRubyMethodFromPath(row[1]);
-      const value = row[2];
-      const details = row[3];
-      const definitionType = row[4];
+      const type = tuple[0];
+      const methodName = parseRubyMethodFromPath(tuple[1]);
+      const value = tuple[2];
+      const node = tuple[3];
+      const definitionType = tuple[4];
 
       if (!isDefinitionType(definitionType)) {
         void logger.log(
@@ -45,7 +70,7 @@ export function parseAccessPathSuggestionsResults(
           signature: rubyMethodSignature(type, methodName),
         },
         value,
-        details,
+        details: node.label ?? "",
         definitionType,
       };
     })

extensions/ql-vscode/test/unit-tests/model-editor/languages/ruby/suggestions.test.ts

@@ -20,8 +20,8 @@ describe("parseAccessPathSuggestionsResults", () => {
           kind: "String",
         },
         {
-          name: "details",
-          kind: "String",
+          name: "node",
+          kind: "Entity",
         },
         {
           name: "defType",
@@ -33,7 +33,9 @@ describe("parseAccessPathSuggestionsResults", () => {
           "Correctness",
           "Method[assert!]",
           "Argument[self]",
-          "self in assert!",
+          {
+            label: "self in assert!",
+          },
           "parameter",
         ],
       ],
@@ -60,4 +62,53 @@ describe("parseAccessPathSuggestionsResults", () => {
       },
     ]);
   });
+
+  it("should not parse an incorrect result format", async () => {
+    const bqrsChunk: DecodedBqrsChunk = {
+      columns: [
+        {
+          name: "type",
+          kind: "String",
+        },
+        {
+          name: "path",
+          kind: "String",
+        },
+        {
+          name: "value",
+          kind: "String",
+        },
+        {
+          name: "details",
+          kind: "String",
+        },
+        {
+          name: "defType",
+          kind: "String",
+        },
+      ],
+      tuples: [
+        [
+          "Correctness",
+          "Method[assert!]",
+          "Argument[self]",
+          "self in assert!",
+          "parameter",
+        ],
+        ["Correctness", "Method[assert!]", "Argument[self]", "parameter"],
+      ],
+    };
+
+    const logger = createMockLogger();
+    expect(parseAccessPathSuggestionsResults(bqrsChunk, ruby, logger)).toEqual(
+      [],
+    );
+    expect(logger.log).toHaveBeenCalledTimes(2);
+    expect(logger.log).toHaveBeenCalledWith(
+      "Skipping result 0 because it has the wrong format",
+    );
+    expect(logger.log).toHaveBeenCalledWith(
+      "Skipping result 1 because it has the wrong format",
+    );
+  });
 });

extensions/ql-vscode/test/vscode-tests/no-workspace/model-editor/suggestion-queries.test.ts

@@ -29,8 +29,8 @@ describe("runSuggestionsQuery", () => {
           kind: "String",
         },
         {
-          name: "details",
-          kind: "String",
+          name: "node",
+          kind: "Entity",
         },
         {
           name: "defType",
@@ -42,7 +42,9 @@ describe("runSuggestionsQuery", () => {
           "Correctness",
           "Method[assert!]",
           "Argument[self]",
-          "self in assert!",
+          {
+            label: "self in assert!",
+          },
           "parameter",
         ],
       ],
@@ -62,8 +64,8 @@ describe("runSuggestionsQuery", () => {
           kind: "String",
         },
         {
-          name: "details",
-          kind: "String",
+          name: "node",
+          kind: "Entity",
         },
         {
           name: "defType",
@@ -75,14 +77,18 @@ describe("runSuggestionsQuery", () => {
           "Correctness",
           "Method[assert!]",
           "ReturnValue",
-          "call to puts",
+          {
+            label: "call to puts",
+          },
           "return",
         ],
         [
           "Correctness",
           "Method[assert!]",
           "Argument[self]",
-          "self in assert!",
+          {
+            label: "self in assert!",
+          },
           "parameter",
         ],
       ],