superthread 0.8.0 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb38a8ab1c8ba081e66e8bda3bc4fabcb8aa9732e1e8cfc5ce1bdff0b14f94b2
-  data.tar.gz: e97e7bffe8dc9bfbd86b424a6762455d1d9979b07a60651b3997ad5feaedddf5
+  metadata.gz: 05edf5da03e7cda08cca6e16f9813bb8f464b7847f3717a669eeb69802a67208
+  data.tar.gz: bdb2593ece548e526dfd602ca061e40541d09a062b633919133bf5ab6cc672c7
 SHA512:
-  metadata.gz: b2c5dfabc604f08c7aae0eedb7a94fb8f702912c5ccc2730c9d388d6f404dbdff8aa9f3fa835288732612f84d7755e4a2a5283f1d266747b3e9727aa09fdbe5f
-  data.tar.gz: 847b4c2868387c94b08bbbffab9db1d80dac9b4991884941258eb801347996f11257cdc1079d192848ae5208936352da2b894f95a1288914403279395b50cf61
+  metadata.gz: 7800b583a4a5b07062e460c1b053e593b3c344037d0a6dbf84e576097be4dfdb67594d61f021eaf46aa1bf9ec6b16b93ce5c9c31633331dfa5ef13b1742e82f6
+  data.tar.gz: 0d547f6b5c884715da432f8fdfa68593435f85c20cd06786c0f6594f33381ee661f30058c86912595124d3b113fd91978861146e578c3bf8513213d5cd33e269

data/lib/superthread/cli/cards.rb

@@ -173,7 +173,7 @@ module Superthread
       option :board, type: :string, aliases: "-b", desc: "Board (ID or name, required unless --sprint)"
       option :space, type: :string, aliases: "-s", desc: "Space (required for --sprint, helps resolve board name)"
       option :sprint, type: :string, desc: "Sprint (ID or name, required unless --board)"
-      option :content, type: :string, desc: "Card content (HTML)"
+      option :content, type: :string, desc: "Card content (HTML). Use {{@Name}} to mention users"
       option :project, type: :string, desc: "Project ID"
       option :start_date, type: :numeric, desc: "Start date (Unix timestamp)"
       option :due_date, type: :numeric, desc: "Due date (Unix timestamp)"

data/lib/superthread/cli/checklists.rb

@@ -116,7 +116,7 @@ module Superthread
 
       desc "add-item CHECKLIST", "Add item to a checklist"
       option :card, type: :string, required: true, aliases: "-c", desc: "Parent card ID"
-      option :title, type: :string, required: true, desc: "Item title"
+      option :title, type: :string, required: true, desc: "Item title. Use {{@Name}} to mention users"
       option :checked, type: :boolean, default: false, desc: "Create as checked"
       # Add a new item to an existing checklist.
       #
@@ -139,7 +139,7 @@ module Superthread
       desc "update-item ITEM_ID", "Update a checklist item"
       option :card, type: :string, required: true, aliases: "-c", desc: "Parent card ID"
       option :checklist, type: :string, required: true, desc: "Parent checklist ID"
-      option :title, type: :string, desc: "New item title"
+      option :title, type: :string, desc: "New item title. Use {{@Name}} to mention users"
       option :checked, type: :boolean, desc: "Mark as checked/unchecked"
       # Update the title or checked state of a checklist item.
       #

data/lib/superthread/mention_formatter.rb

@@ -32,6 +32,8 @@ module Superthread
     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
+    # @return [Regexp] pattern matching plain @Word that is not inside {{@...}} delimiters
+    PLAIN_MENTION_PATTERN = /(?<!\{\{)@(\w+)/
 
     # @param client [Superthread::Client] the API client for fetching members
     # @param workspace_id [String] the workspace to look up members in
@@ -46,6 +48,7 @@ module Superthread
     # @return [String, nil] content with mentions converted to HTML tags
     def format(content)
       warn_html_mentions(content) if content
+      warn_plain_mentions(content) if content
       return content if content.nil? || !content.include?("{{@")
 
       member_map = build_member_map
@@ -99,6 +102,36 @@ module Superthread
         "(e.g., '{{@Steve Clarke}} check this')."
     end
 
+    # Warns when content contains plain @Name mentions that match workspace members.
+    # This catches the common mistake of using @Name instead of {{@Name}}.
+    #
+    # @param content [String] text to check for plain @mentions
+    # @return [void]
+    def warn_plain_mentions(content)
+      return if content.include?("{{@")
+
+      names = content.scan(PLAIN_MENTION_PATTERN).flatten
+      return if names.empty?
+
+      member_map = build_member_map
+      return if member_map.nil?
+
+      # Also index by first name for multi-word display names
+      first_name_map = {}
+      member_map.each_value do |info|
+        first = info[:name].split.first&.downcase
+        first_name_map[first] = info[:name] if first
+      end
+
+      names.each do |name|
+        match = member_map[name.downcase]&.fetch(:name) || first_name_map[name.downcase]
+        if match
+          warn "Warning: Found @#{name} — did you mean {{@#{match}}}? " \
+            "Use {{@Name}} syntax to mention users and trigger notifications."
+        end
+      end
+    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.8.0"
+  VERSION = "0.8.1"
 end

metadata

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