na 1.2.102 → 1.2.103

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3e4ec9be9bb02df547b4d80dda0e81ccf1e33ab1eb31032e49f21012c9cffa1e
-  data.tar.gz: f3229716b013fd13fe48b03586df9bfd2d9cc07925b69c9d72882025a05fe39b
+  metadata.gz: a397b0b25b7e760071ffdfbb1ce4418f14d8049f0d52af02f653e3d278e714b1
+  data.tar.gz: fb60ff2015ab3989e529b7f857900b8171053fc33e80b5308cd922ff8825430f
 SHA512:
-  metadata.gz: 0c56a1b6466fbef64e67b09cb11833cc74fbd487f5fdf78173ba092aa0efba062825988db6d60784ddafbc78fd5aefea6a8db77735e162f4620ba80b04ac0a27
-  data.tar.gz: 1b5ba39b700810493e09e684d693cef30a9eb7056e7a4b131afbd4b626cc022a03492272645690b160ab39238ef4921c281acaac57210a0cd66c706d4d2464a8
+  metadata.gz: a69a1f8dc42eefad043fa894a644178baa5b567d966b99f941d30f9ab3f5bf9fd753c2f1363acdb1fd5828e618d26c330fc7153c5af52c1929e2343f38b7a88a
+  data.tar.gz: 8d0dd164bae1bfdfdc1323fd7bc9d0e2f41e00ea60304f6cf7a038bd30d60cba82d6d0c254c956e55ba06c9834c8dbd591e98e45db3c46fa4e50f3d591923baf

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-02-27 15:51:35 UTC using RuboCop version 1.81.7.
+# on 2026-05-04 09:11:30 UTC using RuboCop version 1.82.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -40,14 +40,14 @@ Metrics/BlockNesting:
 # Offense count: 6
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ClassLength:
-  Max: 1502
+  Max: 1503
 
-# Offense count: 41
+# Offense count: 42
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/CyclomaticComplexity:
   Max: 97
 
-# Offense count: 63
+# Offense count: 64
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
   Max: 239
@@ -55,7 +55,7 @@ Metrics/MethodLength:
 # Offense count: 5
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ModuleLength:
-  Max: 1504
+  Max: 1505
 
 # Offense count: 5
 # Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
@@ -142,7 +142,7 @@ Style/YAMLFileRead:
 
 # Offense count: 40
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
+# Configuration parameters: AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
   Max: 293

data/CHANGELOG.md

@@ -1,3 +1,26 @@
+### 1.2.103
+
+2026-05-04 04:11
+
+#### CHANGED
+
+- Allow next --available with filters to match actions without the default @na tag.
+- Bump the gem version to 1.2.101.
+- Bump the gem version to 1.2.102.
+- Bump the locked gem version to 1.2.103.
+
+#### NEW
+
+- Add next --available/-a to show the first available action per project.
+
+#### FIXED
+
+- Match unique nested projects by leaf name in add/update
+- Make --color force colored output even when stdout is not a TTY.
+- Make -f FILE --color force colored output when stdout is not a TTY.
+- Make update PATH:LINE use 1-based editor line numbers and update only the requested action.
+- Let update PATH:LINE run without search terms and skip fzf/gum selection prompts.
+
 ### 1.2.102
 
 2026-04-27 04:36

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    na (1.2.102)
+    na (1.2.103)
       chronic (~> 0.10, >= 0.10.2)
       csv (~> 3.2)
       git (~> 3.0.0)

data/README.md

@@ -9,7 +9,7 @@
 _If you're one of the rare people like me who find this useful, feel free to
 [buy me some coffee][donate]._
 
-The current version of `na` is 1.2.102.
+The current version of `na` is 1.2.103.
 
 
 ### Table of contents
@@ -257,7 +257,7 @@ SYNOPSIS
     na [global options] command [command options] [arguments...]
 
 VERSION
-    1.2.102
+    1.2.103
 
 GLOBAL OPTIONS
     -a, --add               - Add a next action (deprecated, for backwards compatibility)

data/bin/commands/update.rb

@@ -202,7 +202,12 @@ class App
           # Verify file exists
           if File.exist?(target_file)
             options[:file] = target_file
-            options[:target_line] = target_line
+            # PATH:LINE uses 1-based editor line numbers; find_actions matches Action#line (0-based index).
+            user_line = target_line
+            if user_line < 1
+              NA.notify("#{NA.theme[:error]}Invalid line number (use 1-based line like file.taskpaper:3)", exit_code: 1)
+            end
+            options[:target_line] = user_line - 1
             action = nil  # Skip search processing
           else
             NA.notify("#{NA.theme[:error]}File not found: #{target_file}", exit_code: 1)
@@ -240,366 +245,368 @@ class App
         tokens = nil # No search, list all
       end
 
-      # Gather all candidate actions for selection
-      candidate_actions = []
-      targets_for_selection = []
-      files = NA.find_files_matching({
-        depth: options[:depth],
-        done: options[:done],
-        project: options[:project],
-        regex: options[:regex],
-        require_na: false,
-        search: tokens,
-        tag: tags
-      })
-      files.each do |file|
-        safe_search = (tokens.is_a?(String) || tokens.is_a?(Array) || tokens.is_a?(Regexp)) ? tokens : nil
-        todo = NA::Todo.new({
-          search: safe_search,
-          search_note: options[:search_notes],
-          require_na: false,
-          file_path: file,
+      unless options[:target_line] && options[:file]
+        # Gather all candidate actions for selection
+        candidate_actions = []
+        targets_for_selection = []
+        files = NA.find_files_matching({
+          depth: options[:depth],
+          done: options[:done],
           project: options[:project],
-          tag: tags,
-          done: options[:done]
+          regex: options[:regex],
+          require_na: false,
+          search: tokens,
+          tag: tags
         })
-        todo.actions.each do |action_obj|
-          # Format: filename:LINENUM:parent > action
-          # Include line number in display for unique matching
-          display = "#{File.basename(action_obj.file_path)}:#{action_obj.file_line}:#{action_obj.parent.join('>')} | #{action_obj.action}"
-          candidate_actions << display
-          targets_for_selection << { file: action_obj.file_path, line: action_obj.file_line, action: action_obj }
+        files.each do |file|
+          safe_search = (tokens.is_a?(String) || tokens.is_a?(Array) || tokens.is_a?(Regexp)) ? tokens : nil
+          todo = NA::Todo.new({
+            search: safe_search,
+            search_note: options[:search_notes],
+            require_na: false,
+            file_path: file,
+            project: options[:project],
+            tag: tags,
+            done: options[:done]
+          })
+          todo.actions.each do |action_obj|
+            # Format: filename:LINENUM:parent > action
+            # Include line number in display for unique matching
+            display = "#{File.basename(action_obj.file_path)}:#{action_obj.file_line}:#{action_obj.parent.join('>')} | #{action_obj.action}"
+            candidate_actions << display
+            targets_for_selection << { file: action_obj.file_path, line: action_obj.file_line, action: action_obj }
+          end
         end
-      end
 
-      # Multi-select using fzf or gum if available
-      selected_indices = []
-      if candidate_actions.any?
-        selector = nil
-        if TTY::Which.exist?('fzf')
-          selector = 'fzf --multi --prompt="Select tasks> "'
-        elsif TTY::Which.exist?('gum')
-          selector = 'gum choose --no-limit'
-        end
-        if selector
-          require 'open3'
-          input = candidate_actions.join("\n")
+        # Multi-select using fzf or gum if available
+        selected_indices = []
+        if candidate_actions.any?
+          selector = nil
+          if TTY::Which.exist?('fzf')
+            selector = 'fzf --multi --prompt="Select tasks> "'
+          elsif TTY::Which.exist?('gum')
+            selector = 'gum choose --no-limit'
+          end
+          if selector
+            require 'open3'
+            input = candidate_actions.join("\n")
 
-          # Use popen3 to properly handle stdin for fzf
-          Open3.popen3(selector) do |stdin, stdout, stderr, wait_thr|
-            stdin.write(input)
-            stdin.close
+            # Use popen3 to properly handle stdin for fzf
+            Open3.popen3(selector) do |stdin, stdout, stderr, wait_thr|
+              stdin.write(input)
+              stdin.close
 
-            output = stdout.read
+              output = stdout.read
 
-            selected = output.split("\n").map(&:strip).reject(&:empty?)
+              selected = output.split("\n").map(&:strip).reject(&:empty?)
 
-            # Track which candidates have been matched to avoid duplicates
-            selected_indices = []
-            candidate_actions.each_index do |i|
-              if selected.include?(candidate_actions[i])
-                selected_indices << i unless selected_indices.include?(i)
+              # Track which candidates have been matched to avoid duplicates
+              selected_indices = []
+              candidate_actions.each_index do |i|
+                if selected.include?(candidate_actions[i])
+                  selected_indices << i unless selected_indices.include?(i)
+                end
               end
             end
+          else
+            # Fallback: select all or prompt for search string
+            selected_indices = (0...candidate_actions.size).to_a
           end
-        else
-          # Fallback: select all or prompt for search string
-          selected_indices = (0...candidate_actions.size).to_a
         end
-      end
-
-      # If no actions found, notify and exit
-      if selected_indices.empty?
-        NA.notify("#{NA.theme[:error]}No matching actions found for selection", exit_code: 1)
-      end
 
-      # Apply update to selected actions
-      actionable = [
-        options[:note],
-        (options[:priority].to_i if options[:priority]).to_i.positive?,
-        !options[:move].to_s.empty?,
-        !(options[:tag].nil? || options[:tag].empty?),
-        !(options[:remove].nil? || options[:remove].empty?),
-        !options[:replace].to_s.empty?,
-        options[:finish],
-        options[:archive],
-        options[:restore],
-        options[:delete],
-        options[:edit],
-        options[:started],
-        (options[:end] || options[:finished]),
-        options[:duration],
-        !options[:plugin].to_s.empty?
-      ].any?
-      unless actionable
-        # Interactive menu for actions
-        actions_menu = [
-          { key: :add_tag, label: 'Add Tag', param: 'Tag' },
-          { key: :remove_tag, label: 'Remove Tag', param: 'Tag' },
-          { key: :delete, label: 'Delete', param: nil },
-          { key: :finish, label: 'Finish (mark done)', param: nil },
-          { key: :edit, label: 'Edit', param: nil },
-          { key: :priority, label: 'Set Priority', param: 'Priority (1-5)' },
-          { key: :move, label: 'Move to Project', param: 'Project' },
-          { key: :restore, label: 'Restore', param: nil },
-          { key: :archive, label: 'Archive', param: nil },
-          { key: :note, label: 'Add Note', param: 'Note' }
-        ]
-        # Add plugin options directly to the actions menu if there are enabled plugins with metadata
-        begin
-          available_plugins = []
-          NA::Plugins.ensure_plugins_home
-          NA::Plugins.list_plugins.each_value do |path|
-            meta = NA::Plugins.parse_plugin_metadata(path)
-            # Only include plugins with both input and output metadata
-            next unless meta['input'] && meta['output']
-
-            disp = meta['name'] || File.basename(path, File.extname(path))
-            available_plugins << { label: disp, plugin_path: path }
-          end
-          available_plugins.each do |plugin|
-            actions_menu << {
-              key: :_plugin,
-              label: "Plugin: #{plugin[:label]}",
-              param: nil,
-              plugin_path: plugin[:plugin_path]
-            }
-          end
-        rescue StandardError
-          # ignore plugin discovery errors in menu
-        end
-        selector = nil
-        if TTY::Which.exist?('fzf')
-          selector = 'fzf --prompt="Select action> "'
-        elsif TTY::Which.exist?('gum')
-          selector = 'gum choose'
-        end
-        menu_labels = actions_menu.map { |a| a[:label] }
-        selected_action = nil
-        if selector
-          require 'open3'
-          input = menu_labels.join("\n")
-          output, = Open3.capture2("echo \"#{input.gsub('"', '\"')}\" | #{selector}")
-          selected_action = output.strip
-        else
-          puts 'Select an action:'
-          menu_labels.each_with_index { |label, i| puts "#{i + 1}. #{label}" }
-          idx = ($stdin.gets || '').strip.to_i - 1
-          selected_action = menu_labels[idx] if idx >= 0 && idx < menu_labels.size
+        # If no actions found, notify and exit
+        if selected_indices.empty?
+          NA.notify("#{NA.theme[:error]}No matching actions found for selection", exit_code: 1)
         end
-        action_obj = actions_menu.find { |a| a[:label] == selected_action }
-        NA.notify("#{NA.theme[:error]}No action selected, cancelled", exit_code: 1) if action_obj.nil?
 
-        if action_obj[:key] == :_plugin
-          # Plugin selected directly from the main actions menu
-          options[:plugin] = action_obj[:plugin_path]
-        else
-          # Prompt for parameter if needed
-          param_value = nil
-          # Only prompt for param if not :move (which has custom menu logic)
-          if action_obj[:param] && action_obj[:key] != :move
-            if TTY::Which.exist?('gum')
-              gum = TTY::Which.which('gum')
-              prompt = "Enter #{action_obj[:param]}: "
-              param_value = `#{gum} input --placeholder "#{prompt}"`.strip
-            else
-              print "Enter #{action_obj[:param]}: "
-              param_value = (STDIN.gets || '').strip
+        # Apply update to selected actions
+        actionable = [
+          options[:note],
+          (options[:priority].to_i if options[:priority]).to_i.positive?,
+          !options[:move].to_s.empty?,
+          !(options[:tag].nil? || options[:tag].empty?),
+          !(options[:remove].nil? || options[:remove].empty?),
+          !options[:replace].to_s.empty?,
+          options[:finish],
+          options[:archive],
+          options[:restore],
+          options[:delete],
+          options[:edit],
+          options[:started],
+          (options[:end] || options[:finished]),
+          options[:duration],
+          !options[:plugin].to_s.empty?
+        ].any?
+        unless actionable
+          # Interactive menu for actions
+          actions_menu = [
+            { key: :add_tag, label: 'Add Tag', param: 'Tag' },
+            { key: :remove_tag, label: 'Remove Tag', param: 'Tag' },
+            { key: :delete, label: 'Delete', param: nil },
+            { key: :finish, label: 'Finish (mark done)', param: nil },
+            { key: :edit, label: 'Edit', param: nil },
+            { key: :priority, label: 'Set Priority', param: 'Priority (1-5)' },
+            { key: :move, label: 'Move to Project', param: 'Project' },
+            { key: :restore, label: 'Restore', param: nil },
+            { key: :archive, label: 'Archive', param: nil },
+            { key: :note, label: 'Add Note', param: 'Note' }
+          ]
+          # Add plugin options directly to the actions menu if there are enabled plugins with metadata
+          begin
+            available_plugins = []
+            NA::Plugins.ensure_plugins_home
+            NA::Plugins.list_plugins.each_value do |path|
+              meta = NA::Plugins.parse_plugin_metadata(path)
+              # Only include plugins with both input and output metadata
+              next unless meta['input'] && meta['output']
+
+              disp = meta['name'] || File.basename(path, File.extname(path))
+              available_plugins << { label: disp, plugin_path: path }
+            end
+            available_plugins.each do |plugin|
+              actions_menu << {
+                key: :_plugin,
+                label: "Plugin: #{plugin[:label]}",
+                param: nil,
+                plugin_path: plugin[:plugin_path]
+              }
             end
+          rescue StandardError
+            # ignore plugin discovery errors in menu
+          end
+          selector = nil
+          if TTY::Which.exist?('fzf')
+            selector = 'fzf --prompt="Select action> "'
+          elsif TTY::Which.exist?('gum')
+            selector = 'gum choose'
+          end
+          menu_labels = actions_menu.map { |a| a[:label] }
+          selected_action = nil
+          if selector
+            require 'open3'
+            input = menu_labels.join("\n")
+            output, = Open3.capture2("echo \"#{input.gsub('"', '\"')}\" | #{selector}")
+            selected_action = output.strip
+          else
+            puts 'Select an action:'
+            menu_labels.each_with_index { |label, i| puts "#{i + 1}. #{label}" }
+            idx = ($stdin.gets || '').strip.to_i - 1
+            selected_action = menu_labels[idx] if idx >= 0 && idx < menu_labels.size
           end
-          # Set options for update
-          case action_obj[:key]
-          when :add_tag
-            options[:tag] = [param_value]
-          when :remove_tag
-            options[:remove] = [param_value]
-          when :delete
-            options[:delete] = true
-          when :finish
-            options[:finish] = true
-            # Timed finish? Prompt user for optional start/date inputs
-            if NA.yn(NA::Color.template("#{NA.theme[:prompt]}Timed?"), default: false)
-              # Ask for start date expression
-              start_expr = nil
+          action_obj = actions_menu.find { |a| a[:label] == selected_action }
+          NA.notify("#{NA.theme[:error]}No action selected, cancelled", exit_code: 1) if action_obj.nil?
+
+          if action_obj[:key] == :_plugin
+            # Plugin selected directly from the main actions menu
+            options[:plugin] = action_obj[:plugin_path]
+          else
+            # Prompt for parameter if needed
+            param_value = nil
+            # Only prompt for param if not :move (which has custom menu logic)
+            if action_obj[:param] && action_obj[:key] != :move
               if TTY::Which.exist?('gum')
                 gum = TTY::Which.which('gum')
-                prompt = 'Enter start date/time (e.g. "30 minutes ago" or "3pm"):'
-                start_expr = `#{gum} input --placeholder "#{prompt}"`.strip
+                prompt = "Enter #{action_obj[:param]}: "
+                param_value = `#{gum} input --placeholder "#{prompt}"`.strip
               else
-                print 'Enter start date/time (e.g. "30 minutes ago" or "3pm"): '
-                start_expr = (STDIN.gets || '').strip
+                print "Enter #{action_obj[:param]}: "
+                param_value = (STDIN.gets || '').strip
               end
-              start_time = NA::Types.parse_date_begin(start_expr)
-              options[:started] = start_time if start_time
-            end
-          when :edit
-            # Just set the flag - multi-action editor will handle it below
-            options[:edit] = true
-          when :priority
-            options[:priority] = param_value
-          when :move
-            # Gather projects from the same file as the selected action
-            selected_file = targets_for_selection[selected_indices.first][:file]
-            todo = NA::Todo.new(file_path: selected_file)
-            project_names = todo.projects.map { |proj| proj.project }
-            project_menu = project_names + ['New project']
-            move_selector = nil
-            if TTY::Which.exist?('fzf')
-              move_selector = 'fzf --prompt="Select project> "'
-            elsif TTY::Which.exist?('gum')
-              move_selector = 'gum choose'
             end
-            selected_project = nil
-            if move_selector
-              require 'open3'
-              input = project_menu.join("\n")
-              output, _ = Open3.capture2("echo \"#{input.gsub('"', '\"')}\" | #{move_selector}")
-              selected_project = output.strip
-            else
-              puts 'Select a project:'
-              project_menu.each_with_index { |label, i| puts "#{i+1}. #{label}" }
-              idx = (STDIN.gets || '').strip.to_i - 1
-              selected_project = project_menu[idx] if idx >= 0 && idx < project_menu.size
-            end
-            if selected_project == 'New project'
-              if TTY::Which.exist?('gum')
-                gum = TTY::Which.which('gum')
-                prompt = 'Enter new project name: '
-                new_proj_name = `#{gum} input --placeholder "#{prompt}"`.strip
+            # Set options for update
+            case action_obj[:key]
+            when :add_tag
+              options[:tag] = [param_value]
+            when :remove_tag
+              options[:remove] = [param_value]
+            when :delete
+              options[:delete] = true
+            when :finish
+              options[:finish] = true
+              # Timed finish? Prompt user for optional start/date inputs
+              if NA.yn(NA::Color.template("#{NA.theme[:prompt]}Timed?"), default: false)
+                # Ask for start date expression
+                start_expr = nil
+                if TTY::Which.exist?('gum')
+                  gum = TTY::Which.which('gum')
+                  prompt = 'Enter start date/time (e.g. "30 minutes ago" or "3pm"):'
+                  start_expr = `#{gum} input --placeholder "#{prompt}"`.strip
+                else
+                  print 'Enter start date/time (e.g. "30 minutes ago" or "3pm"): '
+                  start_expr = (STDIN.gets || '').strip
+                end
+                start_time = NA::Types.parse_date_begin(start_expr)
+                options[:started] = start_time if start_time
+              end
+            when :edit
+              # Just set the flag - multi-action editor will handle it below
+              options[:edit] = true
+            when :priority
+              options[:priority] = param_value
+            when :move
+              # Gather projects from the same file as the selected action
+              selected_file = targets_for_selection[selected_indices.first][:file]
+              todo = NA::Todo.new(file_path: selected_file)
+              project_names = todo.projects.map { |proj| proj.project }
+              project_menu = project_names + ['New project']
+              move_selector = nil
+              if TTY::Which.exist?('fzf')
+                move_selector = 'fzf --prompt="Select project> "'
+              elsif TTY::Which.exist?('gum')
+                move_selector = 'gum choose'
+              end
+              selected_project = nil
+              if move_selector
+                require 'open3'
+                input = project_menu.join("\n")
+                output, _ = Open3.capture2("echo \"#{input.gsub('"', '\"')}\" | #{move_selector}")
+                selected_project = output.strip
+              else
+                puts 'Select a project:'
+                project_menu.each_with_index { |label, i| puts "#{i+1}. #{label}" }
+                idx = (STDIN.gets || '').strip.to_i - 1
+                selected_project = project_menu[idx] if idx >= 0 && idx < project_menu.size
+              end
+              if selected_project == 'New project'
+                if TTY::Which.exist?('gum')
+                  gum = TTY::Which.which('gum')
+                  prompt = 'Enter new project name: '
+                  new_proj_name = `#{gum} input --placeholder "#{prompt}"`.strip
+                else
+                  print 'Enter new project name: '
+                  new_proj_name = (STDIN.gets || '').strip
+                end
+                # Create the new project in the file
+                NA.insert_project(selected_file, new_proj_name)
+                options[:move] = new_proj_name
               else
-                print 'Enter new project name: '
-                new_proj_name = (STDIN.gets || '').strip
+                options[:move] = selected_project
               end
-              # Create the new project in the file
-              NA.insert_project(selected_file, new_proj_name)
-              options[:move] = new_proj_name
-            else
-              options[:move] = selected_project
+            when :restore
+              options[:restore] = true
+            when :archive
+              options[:archive] = true
+            when :note
+              options[:note] = true
+              note = [param_value]
             end
-          when :restore
-            options[:restore] = true
-          when :archive
-            options[:archive] = true
-          when :note
-            options[:note] = true
-            note = [param_value]
           end
         end
-      end
-      did_direct_update = false
-
-      # Group selected actions by file for batch processing
-      actions_by_file = {}
-      selected_indices.each do |idx|
-        file = targets_for_selection[idx][:file]
-        actions_by_file[file] ||= []
-        actions_by_file[file] << targets_for_selection[idx][:action]
-      end
-
-      # If a plugin is specified, run it on all selected actions and apply results
-      if options[:plugin]
-        plugin_path = options[:plugin]
-        unless File.exist?(plugin_path)
-          # Resolve by name via registry
-          resolved = NA::Plugins.resolve_plugin(plugin_path)
-          plugin_path = resolved if resolved
+        did_direct_update = false
+
+        # Group selected actions by file for batch processing
+        actions_by_file = {}
+        selected_indices.each do |idx|
+          file = targets_for_selection[idx][:file]
+          actions_by_file[file] ||= []
+          actions_by_file[file] << targets_for_selection[idx][:action]
         end
-        meta = NA::Plugins.parse_plugin_metadata(plugin_path)
-        input_fmt = (options[:input] || meta['input'] || 'json').to_s
-        output_fmt = (options[:output] || meta['output'] || input_fmt).to_s
-        divider = (options[:divider] || '||')
-
-        all_actions = []
-        actions_by_file.each_value { |list| all_actions.concat(list) }
-        io_actions = all_actions.map(&:to_plugin_io_hash)
-        stdin_str = NA::Plugins.serialize_actions(io_actions, format: input_fmt, divider: divider)
-        stdout = NA::Plugins.run_plugin(plugin_path, stdin_str)
-        returned = NA::Plugins.parse_actions(stdout, format: output_fmt, divider: divider)
-        Array(returned).each { |h| NA.apply_plugin_result(h) }
-        did_direct_update = true
-        next
-      end
 
-      # Process each file's actions (non-plugin paths)
-      actions_by_file.each do |file, action_list|
-        # Rebuild all derived variables from options after menu-driven assignment
-        add_tags = options[:tag] ? options[:tag].join(',').split(/ *, */).map { |t| t.sub(/^@/, '') } : []
-        remove_tags = options[:remove] ? options[:remove].join(',').split(/ *, */).map { |t| t.sub(/^@/, '') } : []
-        remove_tags << 'done' if options[:restore]
-        priority = options[:priority].to_i if options[:priority]&.to_i&.positive?
-        target_proj = if options[:move]
-                        options[:move]
-                      elsif NA.respond_to?(:cwd_is) && NA.cwd_is == :project
-                        NA.cwd
-                      end
-        note_val = note
-        if options[:note] && defined?(param_value) && param_value
-          note_val = [param_value]
+        # If a plugin is specified, run it on all selected actions and apply results
+        if options[:plugin]
+          plugin_path = options[:plugin]
+          unless File.exist?(plugin_path)
+            # Resolve by name via registry
+            resolved = NA::Plugins.resolve_plugin(plugin_path)
+            plugin_path = resolved if resolved
+          end
+          meta = NA::Plugins.parse_plugin_metadata(plugin_path)
+          input_fmt = (options[:input] || meta['input'] || 'json').to_s
+          output_fmt = (options[:output] || meta['output'] || input_fmt).to_s
+          divider = (options[:divider] || '||')
+
+          all_actions = []
+          actions_by_file.each_value { |list| all_actions.concat(list) }
+          io_actions = all_actions.map(&:to_plugin_io_hash)
+          stdin_str = NA::Plugins.serialize_actions(io_actions, format: input_fmt, divider: divider)
+          stdout = NA::Plugins.run_plugin(plugin_path, stdin_str)
+          returned = NA::Plugins.parse_actions(stdout, format: output_fmt, divider: divider)
+          Array(returned).each { |h| NA.apply_plugin_result(h) }
+          did_direct_update = true
+          next
         end
 
-        # Handle edit with multiple actions
-        if options[:edit]
-          # Open editor once with all actions for this file
-          editor_content = NA::Editor.format_multi_action_input(action_list)
-          edited_content = NA::Editor.fork_editor(editor_content)
-          edited_actions = NA::Editor.parse_multi_action_output(edited_content)
-
-          # If markers were removed but we have the same number of actions, match by position
-          if edited_actions.empty? && action_list.size > 0
-            # Parse content line by line, skipping comments and blanks
-            non_comment_lines = edited_content.lines.map(&:strip).reject { |l| l.empty? || l.start_with?('#') }
-
-            # Match each non-comment line to an action by position
-            action_list.each_with_index do |action_obj, idx|
-              if non_comment_lines[idx]
-                # Split into action and notes
-                lines = non_comment_lines[idx..-1]
-                action_text = lines[0]
-                note_lines = lines[1..-1] || []
-
-                # Store by file:line key
-                key = "#{action_obj.file_path}:#{action_obj.file_line}"
-                edited_actions[key] = [action_text, note_lines]
+        # Process each file's actions (non-plugin paths)
+        actions_by_file.each do |file, action_list|
+          # Rebuild all derived variables from options after menu-driven assignment
+          add_tags = options[:tag] ? options[:tag].join(',').split(/ *, */).map { |t| t.sub(/^@/, '') } : []
+          remove_tags = options[:remove] ? options[:remove].join(',').split(/ *, */).map { |t| t.sub(/^@/, '') } : []
+          remove_tags << 'done' if options[:restore]
+          priority = options[:priority].to_i if options[:priority]&.to_i&.positive?
+          target_proj = if options[:move]
+                          options[:move]
+                        elsif NA.respond_to?(:cwd_is) && NA.cwd_is == :project
+                          NA.cwd
+                        end
+          note_val = note
+          if options[:note] && defined?(param_value) && param_value
+            note_val = [param_value]
+          end
+
+          # Handle edit with multiple actions
+          if options[:edit]
+            # Open editor once with all actions for this file
+            editor_content = NA::Editor.format_multi_action_input(action_list)
+            edited_content = NA::Editor.fork_editor(editor_content)
+            edited_actions = NA::Editor.parse_multi_action_output(edited_content)
+
+            # If markers were removed but we have the same number of actions, match by position
+            if edited_actions.empty? && action_list.size > 0
+              # Parse content line by line, skipping comments and blanks
+              non_comment_lines = edited_content.lines.map(&:strip).reject { |l| l.empty? || l.start_with?('#') }
+
+              # Match each non-comment line to an action by position
+              action_list.each_with_index do |action_obj, idx|
+                if non_comment_lines[idx]
+                  # Split into action and notes
+                  lines = non_comment_lines[idx..-1]
+                  action_text = lines[0]
+                  note_lines = lines[1..-1] || []
+
+                  # Store by file:line key
+                  key = "#{action_obj.file_path}:#{action_obj.file_line}"
+                  edited_actions[key] = [action_text, note_lines]
+                end
               end
             end
-          end
 
-          # Update each action with edited content
-          action_list.each do |action_obj|
-            key = "#{action_obj.file_path}:#{action_obj.file_line}"
-            if edited_actions[key]
-              action_obj.action, action_obj.note = edited_actions[key]
+            # Update each action with edited content
+            action_list.each do |action_obj|
+              key = "#{action_obj.file_path}:#{action_obj.file_line}"
+              if edited_actions[key]
+                action_obj.action, action_obj.note = edited_actions[key]
+              end
             end
           end
-        end
 
-        # Update each action (process from bottom to top to avoid line shifts)
-        action_list.sort_by(&:file_line).reverse.each do |action_obj|
-          NA.update_action(file, nil,
-            add: action_obj,
-            add_tag: add_tags,
-            all: true,
-            append: append,
-            delete: options[:delete],
-            done: options[:done],
-            edit: false,  # Already handled above
-            finish: options[:finish],
-            move: target_proj,
-            note: note_val,
-            overwrite: options[:overwrite],
-            priority: priority,
-            project: options[:project],
-            remove_tag: remove_tags,
-            replace: options[:replace],
-            search_note: options[:search_notes],
-            tagged: nil)
+          # Update each action (process from bottom to top to avoid line shifts)
+          action_list.sort_by(&:file_line).reverse.each do |action_obj|
+            NA.update_action(file, nil,
+              add: action_obj,
+              add_tag: add_tags,
+              all: true,
+              append: append,
+              delete: options[:delete],
+              done: options[:done],
+              edit: false,  # Already handled above
+              finish: options[:finish],
+              move: target_proj,
+              note: note_val,
+              overwrite: options[:overwrite],
+              priority: priority,
+              project: options[:project],
+              remove_tag: remove_tags,
+              replace: options[:replace],
+              search_note: options[:search_notes],
+              tagged: nil)
+          end
+          did_direct_update = true
+        end
+        if did_direct_update
+          next
         end
-        did_direct_update = true
-      end
-      if did_direct_update
-        next
-      end
 
+      end
       all_req = options[:tagged].join(' ') !~ /[+!-]/ && !options[:or]
       tags = []
       options[:tagged].join(',').split(/ *, */).each do |arg|
@@ -709,7 +716,7 @@ class App
         options[:move] = 'Archive'
       end
 
-      NA.notify("#{NA.theme[:error]}No search terms provided", exit_code: 1) if tokens.nil? && options[:tagged].empty?
+      NA.notify("#{NA.theme[:error]}No search terms provided", exit_code: 1) if tokens.nil? && options[:tagged].empty? && !options[:target_line]
 
       # Handle target_line if provided (from PATH:LINE format)
       search_tokens = if options[:target_line]

data/lib/na/next_action.rb

@@ -264,7 +264,9 @@ module NA
     # @param target_line [Integer] Specific line number to target
     # @return [Array] Projects and actions
     def find_actions(target, search, tagged = nil, all: false, done: false, project: nil, search_note: true, target_line: nil)
-      todo = NA::Todo.new({ search: search,
+      # PATH:LINE passes search as { target_line: n }; Todo expects string/array/regexp for :search.
+      search_for_todo = target_line ? nil : search
+      todo = NA::Todo.new({ search: search_for_todo,
                             search_note: search_note,
                             require_na: false,
                             file_path: target,
@@ -278,9 +280,9 @@ module NA
         return [todo.projects, NA::Actions.new]
       end
 
-      return [todo.projects, todo.actions] if todo.actions.one? || all
-
-      # If target_line is specified, find the action at that specific line
+      # If target_line is specified, find the action at that specific line (must run before
+      # the `all` shortcut below, otherwise --all would return every action and skip this filter).
+      # target_line is Action#line (0-based file line index). PATH:LINE on the CLI converts to 0-based in update.rb.
       if target_line
         matching_action = todo.actions.find { |a| a.line == target_line }
         return [todo.projects, NA::Actions.new([matching_action])] if matching_action
@@ -290,6 +292,8 @@ module NA
 
       end
 
+      return [todo.projects, todo.actions] if todo.actions.one? || all
+
       options = todo.actions.map { |action| "#{action.file} : #{action.action}" }
       res = choose_from(options, prompt: 'Make a selection: ', multiple: true, sorted: true)
 

data/lib/na/version.rb

@@ -5,5 +5,5 @@
 module Na
   ##
   # Current version of the na gem.
-  VERSION = '1.2.102'
+  VERSION = '1.2.103'
 end

data/src/_README.md

@@ -9,7 +9,7 @@
 _If you're one of the rare people like me who find this useful, feel free to
 [buy me some coffee][donate]._
 
-The current version of `na` is <!--VER-->1.2.101<!--END VER-->.
+The current version of `na` is <!--VER-->1.2.102<!--END VER-->.
 
 <!--GITHUB-->
 ### Table of contents

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: na
 version: !ruby/object:Gem::Version
-  version: 1.2.102
+  version: 1.2.103
 platform: ruby
 authors:
 - Brett Terpstra