Model line-comment expectation syntax

Expose whether each expectation comment uses line-comment syntax so learning can distinguish comments that the current renderer can safely replace. Implement the classification in every inline-expectation adapter, including mixed line/block-comment languages.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 1adfa307-c48e-43f5-94e3-8286e4a8c083

Author: d10c

actions/ql/lib/codeql/actions/test/internal/InlineExpectationsTestImpl.qll

@@ -8,6 +8,9 @@ module Impl implements InlineExpectationsTestSig {
   class ExpectationComment extends Yaml::YamlComment {
     /** Gets the contents of this comment. */
     string getContents() { result = this.getText() }
+
+    /** YAML comments use line-comment syntax. */
+    predicate isLineComment() { any() }
   }
 
   class Location = L::Location;

actions/ql/test/utils/ActionsInlineExpectationsTestQuery.ql

@@ -28,6 +28,8 @@ private module Impl implements T::InlineExpectationsTestSig {
 
   class ExpectationComment extends Yaml::YamlComment {
     string getContents() { result = this.getText() }
+
+    predicate isLineComment() { any() }
   }
 }
 

cpp/ql/lib/utils/test/internal/InlineExpectationsTestImpl.qll

@@ -17,6 +17,9 @@ module Impl implements InlineExpectationsTestSig {
     /** Returns the contents of the given comment, _without_ the preceding comment marker (`//`). */
     string getContents() { result = comment.getContents().suffix(2) }
 
+    /** C++ expectation comments use line-comment syntax. */
+    predicate isLineComment() { any() }
+
     /** Gets a textual representation of this element. */
     string toString() { result = comment.toString() }
 

csharp/ql/lib/utils/test/internal/InlineExpectationsTestImpl.qll

@@ -29,6 +29,9 @@ module Impl implements InlineExpectationsTestSig {
       result = this.asAspComment().getBody()
     }
 
+    /** Holds if this is a C# `//` comment. */
+    predicate isLineComment() { exists(this.asCSharpComment()) }
+
     /** Gets the location of this comment. */
     Location getLocation() {
       result = this.asCSharpComment().getLocation()

go/ql/lib/utils/test/internal/InlineExpectationsTestImpl.qll

@@ -15,6 +15,9 @@ module Impl implements InlineExpectationsTestSig {
     /** Returns the contents of the given comment, _without_ the preceding comment marker (`//`). */
     string getContents() { result = this.getText() }
 
+    /** Holds if this comment uses `//` syntax. */
+    predicate isLineComment() { this instanceof G::LineComment }
+
     /** Gets this element's location. */
     G::Location getLocation() { result = super.getLocation() }
   }

java/ql/lib/utils/test/internal/InlineExpectationsTestImpl.qll

@@ -12,6 +12,9 @@ module Impl implements InlineExpectationsTestSig {
   abstract class ExpectationComment extends J::Top {
     /** Gets the contents of the given comment, _without_ the preceding comment marker (`//`). */
     abstract string getContents();
+
+    /** Java expectation comments use line-comment syntax. */
+    predicate isLineComment() { any() }
   }
 
   private class JavadocExpectationComment extends J::Javadoc, ExpectationComment {

java/ql/test-kotlin1/TestUtilities/internal/InlineExpectationsTestImpl.qll

@@ -9,6 +9,9 @@ module Impl implements InlineExpectationsTestSig {
   abstract class ExpectationComment extends J::Top {
     /** Gets the contents of the given comment, _without_ the preceding comment marker (`//`). */
     abstract string getContents();
+
+    /** Java and Kotlin expectation comments use line-comment syntax. */
+    predicate isLineComment() { any() }
   }
 
   private class JavadocExpectationComment extends J::Javadoc, ExpectationComment {

java/ql/test-kotlin2/TestUtilities/internal/InlineExpectationsTestImpl.qll

@@ -9,6 +9,9 @@ module Impl implements InlineExpectationsTestSig {
   abstract class ExpectationComment extends J::Top {
     /** Gets the contents of the given comment, _without_ the preceding comment marker (`//`). */
     abstract string getContents();
+
+    /** Java and Kotlin expectation comments use line-comment syntax. */
+    predicate isLineComment() { any() }
   }
 
   private class JavadocExpectationComment extends J::Javadoc, ExpectationComment {

javascript/ql/lib/utils/test/internal/InlineExpectationsTestImpl.qll

@@ -29,6 +29,9 @@ module Impl implements InlineExpectationsTestSig {
   abstract private class ExpectationCommentImpl extends Locatable {
     abstract string getContents();
 
+    /** Holds if this comment uses line-comment syntax. */
+    predicate isLineComment() { this instanceof LineComment }
+
     /** Gets this element's location. */
     Location getLocation() { result = super.getLocation() }
   }

python/ql/lib/utils/test/internal/InlineExpectationsTestImpl.qll

@@ -6,7 +6,10 @@ module Impl implements InlineExpectationsTestSig {
    * A class representing line comments in Python. As this is the only form of comment Python
    * permits, we simply reuse the `Comment` class.
    */
-  class ExpectationComment = PY::Comment;
+  class ExpectationComment extends PY::Comment {
+    /** Python comments use line-comment syntax. */
+    predicate isLineComment() { any() }
+  }
 
   class Location = PY::Location;