superthread 0.7.3 → 0.7.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4cf0f4679210af65b63f13141b5c432b8fa2999468842808a58ba2c71d15b7f1
-  data.tar.gz: 922afee485ffb459bb189fcedb92af8649e8422d52baf3230d19c47288cd63bf
+  metadata.gz: 4ff6a32a6f48d0010c39659ee7fca19ff5d136ad8ffdb236a9e44e32108b65c2
+  data.tar.gz: d22ea63399a42dbbb6f79e02ccbb5983ac732c981bfa38af16756a775c037185
 SHA512:
-  metadata.gz: c0e8b5023fd60313bcd7b82cbb650ef3520f11befe1bbef9bf7427feed115003ed3afe287d63c48d5939177a3d689850f9398a3bbf9cb534ac00b021db68f7b7
-  data.tar.gz: b9ceb55ed32d01d2f7010ff234427fbe527f54c749c27f1dc3b03bb17c24d6aed15c82cb010c6a848831c4d0977e232602c3a7c23950cbb8a201a24ab7318897
+  metadata.gz: da133f0ba26e4f5b4b16cac769408133f4cf143965948efb5d933d3cecf32ea478891fc9a1fa93dc590b80acc1be46d30aa3611e6d951c9c636abb5a566a59e2
+  data.tar.gz: c3dfc65b6e9927a9112a33194258c73b239a3238e3446dcba9b929a5b15281d06398d26c86b27dc714a9a9378ff0455280295d33154a4f119628a6a04dfa1208

data/README.md

@@ -328,6 +328,16 @@ Common options have short forms:
 > - Use `me` as a shortcut: `suth cards assigned me`
 > - Priority levels: 1=Urgent, 2=High, 3=Medium, 4=Low
 
+### Mentions
+
+Use `{{@Name}}` to tag workspace members in comments, replies, and checklist items:
+
+```bash
+suth comments create -c CARD --content "{{@Stacey}} Ready for review."
+```
+
+The name is matched case-insensitively against member display names. Unresolved mentions produce a warning.
+
 ## Library Usage
 
 You can also use Superthread as a Ruby gem in your code:

data/lib/superthread/cli/comments.rb

@@ -34,7 +34,7 @@ module Superthread
       end
 
       desc "create", "Create a comment"
-      option :content, type: :string, required: true, desc: "Comment content (HTML)"
+      option :content, type: :string, required: true, desc: "Comment content (HTML). Use {{@Name}} to mention users"
       option :card, type: :string, aliases: "-c", desc: "Parent card ID (required unless --page)"
       option :page, type: :string, aliases: "-p", desc: "Parent page ID (required unless --card)"
       # Create a new comment on a card or page.
@@ -49,7 +49,7 @@ module Superthread
       end
 
       desc "update COMMENT_ID", "Update a comment"
-      option :content, type: :string, desc: "New content"
+      option :content, type: :string, desc: "New content (HTML). Use {{@Name}} to mention users"
       option :status, type: :string, enum: %w[resolved open orphaned], desc: "Comment status"
       # Update an existing comment's content or status.
       #

data/lib/superthread/cli/replies.rb

@@ -44,7 +44,7 @@ module Superthread
 
       desc "create", "Reply to a comment"
       option :comment, type: :string, required: true, desc: "Parent comment ID"
-      option :content, type: :string, required: true, desc: "Reply content"
+      option :content, type: :string, required: true, desc: "Reply content (HTML). Use {{@Name}} to mention users"
       # Add a threaded reply to an existing comment.
       #
       # @return [void]
@@ -57,7 +57,7 @@ module Superthread
 
       desc "update REPLY_ID", "Update a reply"
       option :comment, type: :string, required: true, desc: "Parent comment ID"
-      option :content, type: :string, desc: "New content"
+      option :content, type: :string, desc: "New content (HTML). Use {{@Name}} to mention users"
       option :status, type: :string, enum: %w[resolved open orphaned], desc: "Status"
       # Update an existing reply's content or status.
       #

data/lib/superthread/mention_formatter.rb

@@ -30,6 +30,8 @@ module Superthread
     ESCAPE_PATTERN = /\\\{\{@([^}]+)\}\}/
     # @return [Regexp] pattern matching placeholders used during escape processing
     PLACEHOLDER_PATTERN = /___ESCAPED_MENTION_(.+?)___END___/
+    # @return [Regexp] pattern matching raw HTML mention tags that should use {{@Name}} syntax
+    HTML_MENTION_PATTERN = /<(?:user-mention|mention-user)\b/i
 
     # @param client [Superthread::Client] the API client for fetching members
     # @param workspace_id [String] the workspace to look up members in
@@ -43,6 +45,7 @@ module Superthread
     # @param content [String, nil] text that may contain {{@Name}} patterns
     # @return [String, nil] content with mentions converted to HTML tags
     def format(content)
+      warn_html_mentions(content) if content
       return content if content.nil? || !content.include?("{{@")
 
       member_map = build_member_map
@@ -54,6 +57,7 @@ module Superthread
       result = content.gsub(ESCAPE_PATTERN, '___ESCAPED_MENTION_\1___END___')
 
       # Pass 2: replace {{@Name}} with HTML tags
+      unresolved = []
       result = result.gsub(MENTION_PATTERN) do |match|
         name = Regexp.last_match(1).strip
         member = member_map[name.downcase]
@@ -67,16 +71,34 @@ module Superthread
             "user-value=\"#{safe_name}\" " \
             'denotation-char="@"></user-mention>'
         else
+          unresolved << name
           match
         end
       end
 
+      unresolved.each do |name|
+        warn "Warning: Could not resolve mention: #{name}. " \
+          "Check the display name matches a workspace member."
+      end
+
       # Pass 3: restore escaped mentions as literal {{@Name}} text
       result.gsub(PLACEHOLDER_PATTERN, '{{@\1}}')
     end
 
     private
 
+    # Warns when content contains raw HTML mention tags instead of {{@Name}} syntax.
+    #
+    # @param content [String] text to check for raw HTML mention tags
+    # @return [void]
+    def warn_html_mentions(content)
+      return unless content.match?(HTML_MENTION_PATTERN)
+
+      warn "Warning: Raw HTML mention tags detected in content. " \
+        "Use {{@Name}} syntax to mention users " \
+        "(e.g., '{{@Steve Clarke}} check this')."
+    end
+
     # Fetches workspace members and builds a case-insensitive lookup map.
     #
     # @return [Hash{String => Hash}, nil] map of lowercase names to {id:, name:}, or nil on failure

data/lib/superthread/version.rb

@@ -2,5 +2,5 @@
 
 module Superthread
   # Current version of the Superthread gem.
-  VERSION = "0.7.3"
+  VERSION = "0.7.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: superthread
 version: !ruby/object:Gem::Version
-  version: 0.7.3
+  version: 0.7.4
 platform: ruby
 authors:
 - Steve Clarke