From 3bd2039cdddb9a945d1acbf22410852b9605d5e4 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 2 Sep 2026 06:20:47 +0000
Subject: [PATCH 1/2] fix(#1336): report exact physical line of too-wide line
 in multi-line comments

comment-is-too-wide.xsl now computes each offending line's real line
number as the comment's start @line plus its offset within the
tokenized text, instead of always reporting the comment block's start
line. This also removes the duplicated multi-line/single-line branches
in favor of one loop.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BtgvknNrK4TEQvMPqP7E7p
---
 .../lints/comments/comment-is-too-wide.xsl    | 90 ++++++++-----------
 .../catches-multiline-wide-comment.yaml       |  2 +-
 2 files changed, 37 insertions(+), 55 deletions(-)

diff --git a/src/main/resources/org/eolang/lints/comments/comment-is-too-wide.xsl b/src/main/resources/org/eolang/lints/comments/comment-is-too-wide.xsl
index 95d1498aa..0802be338 100644
--- a/src/main/resources/org/eolang/lints/comments/comment-is-too-wide.xsl
+++ b/src/main/resources/org/eolang/lints/comments/comment-is-too-wide.xsl
@@ -7,67 +7,49 @@
   <xsl:import href="/org/eolang/funcs/lineno.xsl"/>
   <xsl:import href="/org/eolang/funcs/defect-context.xsl"/>
   <xsl:output encoding="UTF-8" method="xml"/>
-  <!--
-  @todo #1046:30min Report the exact physical line of the too-wide line
-  inside a multi-line comment. Right now every offending line is reported
-  with the comment block's own start @line, since the XSL has no way to
-  compute the offset of a line within the tokenized comment text. Add a
-  $pos-based offset (comment @line + position() - 1) so
-  catches-multiline-wide-comment.yaml can assert on line 2 (the actual
-  offending line) instead of line 1.
-  -->
   <xsl:template match="/">
     <xsl:variable name="max" select="100"/>
     <defects>
       <xsl:for-each select="/object/comments/comment">
         <xsl:variable name="line" select="if (@line) then @line else '0'"/>
         <xsl:variable name="lines" select="tokenize(replace(., '\\n', '&#10;'), '&#10;')"/>
-        <xsl:choose>
-          <xsl:when test="count($lines) &gt; 1">
-            <xsl:for-each select="$lines[string-length(.) &gt; $max]">
-              <xsl:element name="defect">
-                <xsl:attribute name="line">
-                  <xsl:value-of select="$line"/>
+        <xsl:for-each select="$lines">
+          <xsl:variable name="offset" select="position() - 1"/>
+          <xsl:if test="string-length(.) &gt; $max">
+            <xsl:element name="defect">
+              <xsl:attribute name="line">
+                <xsl:choose>
+                  <xsl:when test="$line = '0'">
+                    <xsl:value-of select="$line"/>
+                  </xsl:when>
+                  <xsl:otherwise>
+                    <xsl:value-of select="format-number(number($line) + $offset, '0')"/>
+                  </xsl:otherwise>
+                </xsl:choose>
+              </xsl:attribute>
+              <xsl:if test="$line = '0'">
+                <xsl:attribute name="context">
+                  <xsl:value-of select="eo:defect-context(.)"/>
                 </xsl:attribute>
-                <xsl:if test="$line = '0'">
-                  <xsl:attribute name="context">
-                    <xsl:value-of select="eo:defect-context(.)"/>
-                  </xsl:attribute>
-                </xsl:if>
-                <xsl:attribute name="severity">
-                  <xsl:text>warning</xsl:text>
-                </xsl:attribute>
-                <xsl:text>The comment line width is </xsl:text>
-                <xsl:value-of select="string-length(.)"/>
-                <xsl:text>, while </xsl:text>
-                <xsl:value-of select="$max"/>
-                <xsl:text> is max allowed</xsl:text>
-              </xsl:element>
-            </xsl:for-each>
-          </xsl:when>
-          <xsl:otherwise>
-            <xsl:if test="string-length(.) &gt; $max">
-              <xsl:element name="defect">
-                <xsl:attribute name="line">
-                  <xsl:value-of select="$line"/>
-                </xsl:attribute>
-                <xsl:if test="$line = '0'">
-                  <xsl:attribute name="context">
-                    <xsl:value-of select="eo:defect-context(.)"/>
-                  </xsl:attribute>
-                </xsl:if>
-                <xsl:attribute name="severity">
-                  <xsl:text>warning</xsl:text>
-                </xsl:attribute>
-                <xsl:text>The comment width is </xsl:text>
-                <xsl:value-of select="string-length(.)"/>
-                <xsl:text>, while </xsl:text>
-                <xsl:value-of select="$max"/>
-                <xsl:text> is max allowed</xsl:text>
-              </xsl:element>
-            </xsl:if>
-          </xsl:otherwise>
-        </xsl:choose>
+              </xsl:if>
+              <xsl:attribute name="severity">
+                <xsl:text>warning</xsl:text>
+              </xsl:attribute>
+              <xsl:choose>
+                <xsl:when test="count($lines) &gt; 1">
+                  <xsl:text>The comment line width is </xsl:text>
+                </xsl:when>
+                <xsl:otherwise>
+                  <xsl:text>The comment width is </xsl:text>
+                </xsl:otherwise>
+              </xsl:choose>
+              <xsl:value-of select="string-length(.)"/>
+              <xsl:text>, while </xsl:text>
+              <xsl:value-of select="$max"/>
+              <xsl:text> is max allowed</xsl:text>
+            </xsl:element>
+          </xsl:if>
+        </xsl:for-each>
       </xsl:for-each>
     </defects>
   </xsl:template>
diff --git a/src/test/resources/org/eolang/lints/packs/single/comment-is-too-wide/catches-multiline-wide-comment.yaml b/src/test/resources/org/eolang/lints/packs/single/comment-is-too-wide/catches-multiline-wide-comment.yaml
index c4edddc7e..4a8f6c35a 100644
--- a/src/test/resources/org/eolang/lints/packs/single/comment-is-too-wide/catches-multiline-wide-comment.yaml
+++ b/src/test/resources/org/eolang/lints/packs/single/comment-is-too-wide/catches-multiline-wide-comment.yaml
@@ -6,7 +6,7 @@ sheets:
   - /org/eolang/lints/comments/comment-is-too-wide.xsl
 asserts:
   - /defects[count(defect[@severity='warning'])=1]
-  - /defects/defect[@line='1']
+  - /defects/defect[@line='2']
 input: |
   # This is good line.
   # This is a very long line that contains more than 100 characters and should be flagged by the lint as too wide.

From f64784c8a683f59a876110e5c6ef9fe7ec82392a Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 2 Sep 2026 06:36:16 +0000
Subject: [PATCH 2/2] fix(#1336): use shared eo:lineno helper and preserve
 comment node for defect-context

Address Copilot review feedback on PR #1339: use the shared
eo:lineno(@line) helper (consistent with comment-too-short.xsl and
others) instead of a manual '0'-fallback that doesn't guard against a
non-numeric @line, and pass the original <comment> node to
eo:defect-context instead of the tokenized line string so the
serialized context stays consistent with other lints.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BtgvknNrK4TEQvMPqP7E7p
---
 .../org/eolang/lints/comments/comment-is-too-wide.xsl        | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/main/resources/org/eolang/lints/comments/comment-is-too-wide.xsl b/src/main/resources/org/eolang/lints/comments/comment-is-too-wide.xsl
index 0802be338..f3e7d0658 100644
--- a/src/main/resources/org/eolang/lints/comments/comment-is-too-wide.xsl
+++ b/src/main/resources/org/eolang/lints/comments/comment-is-too-wide.xsl
@@ -11,7 +11,8 @@
     <xsl:variable name="max" select="100"/>
     <defects>
       <xsl:for-each select="/object/comments/comment">
-        <xsl:variable name="line" select="if (@line) then @line else '0'"/>
+        <xsl:variable name="comment" select="."/>
+        <xsl:variable name="line" select="eo:lineno(@line)"/>
         <xsl:variable name="lines" select="tokenize(replace(., '\\n', '&#10;'), '&#10;')"/>
         <xsl:for-each select="$lines">
           <xsl:variable name="offset" select="position() - 1"/>
@@ -29,7 +30,7 @@
               </xsl:attribute>
               <xsl:if test="$line = '0'">
                 <xsl:attribute name="context">
-                  <xsl:value-of select="eo:defect-context(.)"/>
+                  <xsl:value-of select="eo:defect-context($comment)"/>
                 </xsl:attribute>
               </xsl:if>
               <xsl:attribute name="severity">