howzit 2.1.23 → 2.1.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6fc52d90b2a71d349a14e77f6e313baed51003a43ce2ca615a31f0b070f0681e
-  data.tar.gz: fa0fa63742822ef396b45abc56b6ae7dfbc7acb72a4c896a9e6570cc9e13b1c3
+  metadata.gz: 330829109ccbd73e32ce82690327d2776c1a2f4e60004165fbcde80bdb2b68d6
+  data.tar.gz: 402805ec02154f4ed0f219bc8975be8b1f24e5ca8726e2eb6040f905f32854c7
 SHA512:
-  metadata.gz: d7e01306310519e4454960b5246740572a7731aa4946fa3d4d455ee3f9a3c30b1415eabdf91a58dca48d0123a0b78332754d7e4d86bd112692574b517a328072
-  data.tar.gz: 99ab41b0612da8c5a0e456c5a5006e9dc6cf5e679726b461cba170622d3aa615fe6a259c50dec67b2b4c7151afff200af8d8cf2c3dfe1d775b0dea83e3975fba
+  metadata.gz: 6f6f3ad81b25dc520f43a4ba1ca063a093dece43129c5ba86ed4364ecc4de5d9222f86ba64dbc91220d73197586846d92ff7f7b98251739881a3d140f453c0ea
+  data.tar.gz: 7b5eef5eb1cca9c57e3f7fa7af222911d43790b15bfb30b682c1c6f521cd1c54f8995a357141f1533830c888b91d79b107f3ec295b6238360719e1a6f2bb6032

data/CHANGELOG.md

@@ -1,3 +1,29 @@
+### 2.1.25
+
+2025-12-19 07:41
+
+#### NEW
+
+- Added default metadata support to automatically run topics when executing `howzit --run` with no arguments. Supports multiple comma-separated topics with optional bracketed arguments (e.g., `default: Build Project, Run Tests[verbose]`).
+
+#### FIXED
+
+- Task titles are now correctly displayed in run reports and "Running" messages instead of showing the command. When a title is provided after @run or @include directives (e.g., `@run(ls) List directory`), the title is used throughout.
+- Fixed color code interpretation issues when task or topic names contain dollar signs or braces. These characters are now properly escaped to prevent them from being interpreted as color template codes.
+- Fixed issue where task titles containing braces would show literal `{x}` in output due to color template parsing.
+
+### 2.1.24
+
+2025-12-13 07:11
+
+#### CHANGED
+
+- Run summary now displays as simple list with emoji status indicators
+
+#### IMPROVED
+
+- Use horizontal rule (***) as separator instead of box borders
+
 ### 2.1.23
 
 2025-12-13 06:38

data/lib/howzit/buildnote.rb

@@ -955,18 +955,32 @@ module Howzit
         titles.each { |title| topic_matches.push(find_topic(title)[0]) }
         process_topic_matches(topic_matches, output)
       elsif !Howzit.cli_args.empty?
-        # Collect all topic matches first (showing menus as needed)
-        search = topic_search_terms_from_cli
-        topic_matches = collect_topic_matches(search, output)
-        process_topic_matches(topic_matches, output)
+        # Check if first arg is "default"
+        if Howzit.options[:run] && Howzit.cli_args[0].downcase == 'default'
+          process_default_metadata(output)
+        else
+          # Collect all topic matches first (showing menus as needed)
+          search = topic_search_terms_from_cli
+          topic_matches = collect_topic_matches(search, output)
+          process_topic_matches(topic_matches, output)
+        end
       else
-        # No arguments - show all topics
+        # No arguments
         if Howzit.options[:run]
-          Howzit.run_log = []
-          Howzit.multi_topic_run = topics.length > 1
+          # Check for default metadata when running with no args
+          if @metadata.key?('default')
+            process_default_metadata(output)
+          else
+            Howzit.run_log = []
+            Howzit.multi_topic_run = topics.length > 1
+            topics.each { |k| output.push(process_topic(k, false, single: false)) }
+            finalize_output(output)
+          end
+        else
+          # Show all topics
+          topics.each { |k| output.push(process_topic(k, false, single: false)) }
+          finalize_output(output)
         end
-        topics.each { |k| output.push(process_topic(k, false, single: false)) }
-        finalize_output(output)
       end
     end
 
@@ -1060,6 +1074,77 @@ module Howzit
       finalize_output(output)
     end
 
+    ##
+    ## Process default metadata and run the specified topics
+    ##
+    ## @param      output  [Array] Output array
+    ##
+    def process_default_metadata(output)
+      default_value = @metadata['default']
+      return if default_value.nil? || default_value.strip.empty?
+
+      Howzit.run_log = []
+      default_topics = parse_default_metadata(default_value)
+      Howzit.multi_topic_run = default_topics.length > 1
+
+      topic_specs = []
+      default_topics.each do |topic_spec|
+        topic_name, args = parse_topic_with_args(topic_spec)
+        matches = find_topic(topic_name)
+        if matches.empty?
+          output.push(%({bR}ERROR:{xr} No topic match found for {bw}#{topic_name}{x}\n).c)
+        else
+          # Store topic and its arguments together (take first match, like @include does)
+          topic_specs << [matches[0], args]
+        end
+      end
+
+      if topic_specs.empty?
+        Util.show(output.join("\n"), { color: true, highlight: false, paginate: false, wrap: 0 })
+        Process.exit 1
+      end
+
+      # Run each topic with its specific arguments
+      topic_specs.each do |topic_match, args|
+        # Set arguments if provided, otherwise clear them
+        if args && !args.empty?
+          Howzit.arguments = args.split(/ *, */).map(&:render_arguments)
+        else
+          Howzit.arguments = []
+        end
+        output.push(process_topic(topic_match, Howzit.options[:run], single: true))
+      end
+      finalize_output(output)
+    end
+
+    ##
+    ## Parse default metadata value into individual topic specifications
+    ##
+    ## @param      default_value  [String] The default metadata value
+    ##
+    ## @return     [Array] Array of topic specification strings
+    ##
+    def parse_default_metadata(default_value)
+      default_value.strip.split(/\s*,\s*/).map(&:strip).reject(&:empty?)
+    end
+
+    ##
+    ## Parse a topic specification that may include bracketed arguments
+    ##
+    ## @param      topic_spec  [String] Topic specification like "Run Snippet[document.md]"
+    ##
+    ## @return     [Array] [topic_name, args_string]
+    ##
+    def parse_topic_with_args(topic_spec)
+      if topic_spec =~ /\[(.*?)\]$/
+        args = Regexp.last_match(1)
+        topic_name = topic_spec.sub(/\[.*?\]$/, '').strip
+        [topic_name, args]
+      else
+        [topic_spec.strip, nil]
+      end
+    end
+
     ##
     ## Finalize and display output with run summary if applicable
     ##

data/lib/howzit/colors.rb

@@ -272,7 +272,7 @@ module Howzit
       def template(input)
         input = input.join(' ') if input.is_a? Array
         fmt = input.gsub(/%/, '%%')
-        fmt = fmt.gsub(/(?<!\\u|\$)\{(\w+)\}/i) do
+        fmt = fmt.gsub(/(?<!\\u|\$|\\\\)\{(\w+)\}/i) do
           m = Regexp.last_match(1)
           if m =~ /^[wkglycmrWKGLYCMRdbuix]+$/
             m.split('').map { |c| "%<#{c}>s" }.join('')
@@ -287,7 +287,9 @@ module Howzit
                    Y: bgyellow, C: bgcyan, M: bgmagenta, R: bgred,
                    d: dark, b: bold, u: underline, i: italic, x: reset }
 
-        fmt.empty? ? input : format(fmt, colors)
+        result = fmt.empty? ? input : format(fmt, colors)
+        # Unescape braces that were escaped to prevent color code interpretation
+        result.gsub(/\\\{/, '{').gsub(/\\\}/, '}')
       end
     end
 

data/lib/howzit/run_report.rb

@@ -21,16 +21,43 @@ module Howzit
     def format
       return '' if entries.empty?
 
+      lines = entries.map { |entry| format_line(entry, Howzit.multi_topic_run) }
+      output_lines = ["\n\n***\n"] + lines
+      output_lines.join("\n")
+    end
+
+    def format_line(entry, prefix_topic)
+      symbol = entry[:success] ? '✅' : '❌'
+      parts = ["#{symbol} "]
+      if prefix_topic && entry[:topic] && !entry[:topic].empty?
+        # Escape braces in topic name to prevent color code interpretation
+        topic_escaped = entry[:topic].gsub(/\{/, '\\{').gsub(/\}/, '\\}')
+        parts << "{bw}#{topic_escaped}{x}: "
+      end
+      # Escape braces in task name to prevent color code interpretation
+      task_escaped = entry[:task].gsub(/\{/, '\\{').gsub(/\}/, '\\}')
+      parts << "{by}#{task_escaped}{x}"
+      unless entry[:success]
+        reason = entry[:exit_status] ? "exit code #{entry[:exit_status]}" : 'failed'
+        parts << " {br}(#{reason}){x}"
+      end
+      parts.join.c
+    end
+
+    # Table formatting methods kept for possible future use
+    def format_as_table
+      return '' if entries.empty?
+
       rows = entries.map { |entry| format_row(entry, Howzit.multi_topic_run) }
 
-      # Status column: emoji + 1 space on each side = 3 chars wide visually
-      # But emojis are 2-width in terminal, so we need width of 4 for " ✅ "
-      status_width = 4
+      # Status column width: " :--: " = 6 chars (4 for :--: plus 1 space each side)
+      # Emoji is 2-width in terminal, so we need 2 spaces on each side to center it
+      status_width = 6
       task_width = [4, rows.map { |r| r[:task_plain].length }.max].max
 
-      # Build the table with emoji header
-      header = "| 🚥 | #{'Task'.ljust(task_width)} |"
-      separator = "| #{':' + '-' * 2 + ':'} | #{':' + '-' * (task_width - 2)} |"
+      # Build the table with emoji header - center emoji in 6-char column
+      header = "|  🚥  | #{'Task'.ljust(task_width)} |"
+      separator = "| :--: | #{':' + '-' * (task_width - 1)} |"
 
       table_lines = [header, separator]
       rows.each do |row|
@@ -40,25 +67,30 @@ module Howzit
       table_lines.join("\n")
     end
 
-    def table_row_colored(status, task, task_plain, status_width, task_width)
+    def table_row_colored(status, task, task_plain, _status_width, task_width)
       task_padding = task_width - task_plain.length
 
-      "| #{status} | #{task}#{' ' * task_padding} |"
+      "|  #{status}  | #{task}#{' ' * task_padding} |"
     end
 
     def format_row(entry, prefix_topic)
+      # Use plain emoji without color codes - the emoji itself provides visual meaning
+      # and complex ANSI codes interfere with mdless table rendering
       symbol = entry[:success] ? '✅' : '❌'
-      symbol_colored = entry[:success] ? '{bg}✅{x}'.c : '{br}❌{x}'.c
 
       task_parts = []
       task_parts_plain = []
 
       if prefix_topic && entry[:topic] && !entry[:topic].empty?
-        task_parts << "{bw}#{entry[:topic]}{x}: "
+        # Escape braces in topic name to prevent color code interpretation
+        topic_escaped = entry[:topic].gsub(/\{/, '\\{').gsub(/\}/, '\\}')
+        task_parts << "{bw}#{topic_escaped}{x}: "
         task_parts_plain << "#{entry[:topic]}: "
       end
 
-      task_parts << "{by}#{entry[:task]}{x}"
+      # Escape braces in task name to prevent color code interpretation
+      task_escaped = entry[:task].gsub(/\{/, '\\{').gsub(/\}/, '\\}')
+      task_parts << "{by}#{task_escaped}{x}"
       task_parts_plain << entry[:task]
 
       unless entry[:success]
@@ -68,7 +100,7 @@ module Howzit
       end
 
       {
-        status: symbol_colored,
+        status: symbol,
         status_plain: symbol,
         task: task_parts.join.c,
         task_plain: task_parts_plain.join

data/lib/howzit/task.rb

@@ -26,7 +26,7 @@ module Howzit
       @arguments = attributes[:arguments] || []
 
       @type = attributes[:type] || :run
-      @title = attributes[:title] || nil
+      @title = attributes[:title].nil? ? nil : attributes[:title].to_s
       @parent = attributes[:parent] || nil
 
       @action = attributes[:action].render_arguments || nil
@@ -98,8 +98,19 @@ module Howzit
     ## Execute a run task
     ##
     def run_run
-      title = Howzit.options[:show_all_code] ? @action : @title
-      Howzit.console.info("#{@prefix}{bg}Running {bw}#{title}{x}".c)
+      # If a title was explicitly provided (different from action), always use it
+      # Otherwise, use action (or respect show_all_code if no title)
+      display_title = if @title && !@title.empty? && @title != @action
+                        # Title was explicitly provided, use it
+                        @title
+                      elsif Howzit.options[:show_all_code]
+                        # No explicit title, show code if requested
+                        @action
+                      else
+                        # No explicit title, use title if available (might be same as action), otherwise action
+                        @title && !@title.empty? ? @title : @action
+                      end
+      Howzit.console.info("#{@prefix}{bg}Running {bw}#{display_title}{x}".c)
       ENV['HOWZIT_SCRIPTS'] = File.expand_path('~/.config/howzit/scripts')
       res = system(@action)
       update_last_status(res ? 0 : 1)
@@ -110,8 +121,19 @@ module Howzit
     ## Execute a copy task
     ##
     def run_copy
-      title = Howzit.options[:show_all_code] ? @action : @title
-      Howzit.console.info("#{@prefix}{bg}Copied {bw}#{title}{bg} to clipboard{x}".c)
+      # If a title was explicitly provided (different from action), always use it
+      # Otherwise, use action (or respect show_all_code if no title)
+      display_title = if @title && !@title.empty? && @title != @action
+                        # Title was explicitly provided, use it
+                        @title
+                      elsif Howzit.options[:show_all_code]
+                        # No explicit title, show code if requested
+                        @action
+                      else
+                        # No explicit title, use title if available (might be same as action), otherwise action
+                        @title && !@title.empty? ? @title : @action
+                      end
+      Howzit.console.info("#{@prefix}{bg}Copied {bw}#{display_title}{bg} to clipboard{x}".c)
       Util.os_copy(@action)
       @last_status = 0
       true

data/lib/howzit/topic.rb

@@ -288,11 +288,18 @@ module Howzit
     def define_task_args(keys)
       cmd = keys[:cmd]
       obj = keys[:action]
-      title = keys[:title].nil? ? obj : keys[:title].strip
-      title = Howzit.options[:show_all_code] ? obj : title
+      # Extract and clean the title
+      raw_title = keys[:title]
+      # Determine the title: use provided title if available, otherwise use action
+      title = if raw_title.nil? || raw_title.to_s.strip.empty?
+                obj
+              else
+                raw_title.to_s.strip
+              end
+      # Store the actual title (not overridden by show_all_code - that's only for display)
       task_args = { type: :include,
                     arguments: nil,
-                    title: title,
+                    title: title.dup,  # Make a copy to avoid reference issues
                     action: obj,
                     parent: self }
       case cmd
@@ -303,6 +310,7 @@ module Howzit
           Howzit.arguments = args
           arguments
           title.sub!(/ *\[.*?\] *$/, '')
+          task_args[:title] = title
         end
 
         task_args[:type] = :include

data/lib/howzit/version.rb

@@ -3,5 +3,5 @@
 # Primary module for this gem.
 module Howzit
   # Current Howzit version.
-  VERSION = '2.1.23'
+  VERSION = '2.1.25'
 end

data/spec/run_report_spec.rb

@@ -13,11 +13,10 @@ describe Howzit::RunReport do
     Howzit.multi_topic_run = false
   end
 
-  it 'renders a markdown table for single topic runs' do
+  it 'renders a simple list for single topic runs' do
     Howzit::RunReport.log({ topic: 'Git: Config', task: 'Run Git Origin', success: true, exit_status: 0 })
     plain = Howzit::RunReport.format.uncolor
-    expect(plain).to include('| 🚥 |')
-    expect(plain).to include('| Task')
+    expect(plain).to include('***')
     expect(plain).to include('✅')
     expect(plain).to include('Run Git Origin')
     expect(plain).not_to include('Git: Config:')
@@ -35,10 +34,10 @@ describe Howzit::RunReport do
     expect(plain).to include('exit code 12')
   end
 
-  it 'formats as a proper markdown table with aligned columns' do
+  it 'formats as a proper markdown table with aligned columns using format_as_table' do
     Howzit::RunReport.log({ topic: 'Test', task: 'Short', success: true, exit_status: 0 })
     Howzit::RunReport.log({ topic: 'Test', task: 'A much longer task name', success: true, exit_status: 0 })
-    plain = Howzit::RunReport.format.uncolor
+    plain = Howzit::RunReport.format_as_table.uncolor
     lines = plain.split("\n")
     # All lines should start and end with pipe
     lines.each do |line|

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: howzit
 version: !ruby/object:Gem::Version
-  version: 2.1.23
+  version: 2.1.25
 platform: ruby
 authors:
 - Brett Terpstra