na 1.2.100 → 1.2.102

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 161cff6e82e373cadc9394d29ff0f85370bbf5534e670e92932967d2a0c0b84f
-  data.tar.gz: a12760bc81615804c838e1307d8f2a36540773029d8fe46fab009343c8d4edf8
+  metadata.gz: 3e4ec9be9bb02df547b4d80dda0e81ccf1e33ab1eb31032e49f21012c9cffa1e
+  data.tar.gz: f3229716b013fd13fe48b03586df9bfd2d9cc07925b69c9d72882025a05fe39b
 SHA512:
-  metadata.gz: 2a99a7da6f5bf56c317e97096fdd76b5e6001acf4008f82b8b3fd7e16c3063b15f89c96d32bbab9a630fa221620fb81cba4a48ab1f0ce94e4deb40ad0680049f
-  data.tar.gz: 3347cdfe0edb74a52434cb6efd54a7128f27186f50cf281ca70c112864d49224c4d8b72558058451cb60d25b15613fd117ba5e697c5c5f0eddb9f354d9919021
+  metadata.gz: 0c56a1b6466fbef64e67b09cb11833cc74fbd487f5fdf78173ba092aa0efba062825988db6d60784ddafbc78fd5aefea6a8db77735e162f4620ba80b04ac0a27
+  data.tar.gz: 1b5ba39b700810493e09e684d693cef30a9eb7056e7a4b131afbd4b626cc022a03492272645690b160ab39238ef4921c281acaac57210a0cd66c706d4d2464a8

data/CHANGELOG.md

@@ -1,3 +1,41 @@
+### 1.2.102
+
+2026-04-27 04:36
+
+#### 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.
+
+#### 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.
+
+### 1.2.101
+
+2026-04-26 12:06
+
+#### CHANGED
+
+- Allow next --available with filters to match actions without the default @na tag.
+- Bump the gem version to 1.2.101.
+
+#### 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.
+
 ### 1.2.100
 
 2026-02-27 09:53

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    na (1.2.100)
+    na (1.2.102)
       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.100.
+The current version of `na` is 1.2.102.
 
 
 ### Table of contents
@@ -257,7 +257,7 @@ SYNOPSIS
     na [global options] command [command options] [arguments...]
 
 VERSION
-    1.2.100
+    1.2.102
 
 GLOBAL OPTIONS
     -a, --add               - Add a next action (deprecated, for backwards compatibility)
@@ -522,6 +522,7 @@ DESCRIPTION
     Next actions are actions which contain the next action tag (default @na),   do not contain @done, and are not in the Archive project.   Arguments will target a todo file from history, whether it's in the current   directory or not. Todo file queries can include path components separated by /   or :, and may use wildcards (`*` to match any text, `?` to match a single character). Multiple queries allowed (separate arguments or separated by comma). 
 
 COMMAND OPTIONS
+    -a, --available                        - Show only the first available action per project
     --all                                  - Show next actions from all known todo files (in any directory)
     -d, --depth=DEPTH                      - Recurse to depth (default: none)
     --divider=STRING                       - Divider string for text IO (default: none)

data/bin/commands/next.rb

@@ -25,6 +25,9 @@ class App
     c.desc "Show next actions from all known todo files (in any directory)"
     c.switch %i[all], negatable: false, default_value: false
 
+    c.desc "Show only the first available action per project"
+    c.switch %i[a available], negatable: false
+
     c.desc "Display matches from a known todo file anywhere in history (short name)"
     c.arg_name "TODO"
     c.flag %i[in todo], multiple: true
@@ -169,6 +172,8 @@ class App
         next
       end
 
+      available = options[:available]
+
       if options[:exact] || options[:regex]
         search = options[:search].join(" ")
       else
@@ -288,9 +293,22 @@ class App
       end
 
       NA.na_tag = options[:tag] unless options[:tag].nil?
-      require_na = true
 
-      tag = [{ tag: NA.na_tag, value: nil, required: true, negate: false }]
+      # When -a/--available is combined with --all or any filtering flags,
+      # relax the implicit NA_TAG requirement and show the first available
+      # action that matches the filters instead.
+      filtered_mode = options[:all] ||
+                      options[:save] ||
+                      !options[:tag].nil? ||
+                      options[:project] ||
+                      options[:tagged].any? ||
+                      options[:priority].any? ||
+                      (options[:search].respond_to?(:any?) && options[:search].any?)
+
+      require_na = !(available && filtered_mode)
+
+      tag = []
+      tag << { tag: NA.na_tag, value: nil, required: true, negate: false } if require_na
       tag << { tag: "done", value: nil, negate: true } unless options[:done]
       tag.concat(tags)
 
@@ -378,17 +396,24 @@ class App
           end
         end
       end
-      todo.actions.output(depth,
-                          { files: todo.files,
-                            nest: options[:nest],
-                            nest_projects: options[:omnifocus],
-                            notes: options[:notes],
-                            no_files: options[:no_file],
-                            times: options[:times],
-                            human: options[:human],
-                            only_timed: options[:only_timed],
-                            json_times: options[:json_times],
-                            only_times: options[:only_times] })
+
+      actions = if available
+                  todo.actions.first_available_per_project(require_na: require_na)
+                else
+                  todo.actions
+                end
+
+      actions.output(depth,
+                     { files: todo.files,
+                       nest: options[:nest],
+                       nest_projects: options[:omnifocus],
+                       notes: options[:notes],
+                       no_files: options[:no_file],
+                       times: options[:times],
+                       human: options[:human],
+                       only_timed: options[:only_timed],
+                       json_times: options[:json_times],
+                       only_times: options[:only_times] })
     end
   end
 end

data/bin/na

@@ -9,6 +9,8 @@ require 'na/benchmark'
 require 'fcntl'
 require 'tempfile'
 
+ORIGINAL_ARGV = ARGV.dup
+
 NA::Benchmark.init
 NA::Benchmark.measure('Gem loading') { nil } # Measures time up to this point
 
@@ -116,7 +118,7 @@ class App
     NA::Plugins.ensure_plugins_home
     NA.verbose = global[:debug]
     NA::Pager.paginate = global[:pager] && $stdout.isatty
-    NA::Color.coloring = global[:color] && $stdout.isatty
+    NA::Color.coloring = global[:color] && ($stdout.isatty || ORIGINAL_ARGV.include?('--color'))
     NA.extension = global[:ext]
     NA.include_ext = global[:include_ext]
     NA.na_tag = global[:na_tag]
@@ -175,7 +177,7 @@ class App
   on_error do |exception|
     case exception
     when GLI::UnknownCommand
-      if NA.command_line.count == 1
+      if NA.command_line.one?
         cmd = ['saved']
         cmd.concat(ARGV.unshift(NA.command_line[0]))
 

data/lib/na/actions.rb

@@ -7,6 +7,30 @@ module NA
       super
     end
 
+    # Return the first available action per project path.
+    #
+    # @param require_na [Boolean] If true, only consider actions with the NA tag
+    # @return [NA::Actions] A new Actions collection with at most one action per project
+    def first_available_per_project(require_na: true)
+      NA::Benchmark.measure('Actions.first_available_per_project') do
+        seen = {}
+        selected = NA::Actions.new
+
+        each do |action|
+          next if require_na && !action.respond_to?(:na?) ? false : (require_na && !action.na?)
+
+          project_path = Array(action.parent).join(':')
+          next if project_path.empty?
+          next if seen.key?(project_path)
+
+          seen[project_path] = true
+          selected << action
+        end
+
+        selected
+      end
+    end
+
     # Pretty print a list of actions
     #
     # @param depth [Integer] The depth of the action

data/lib/na/version.rb

@@ -5,5 +5,5 @@
 module Na
   ##
   # Current version of the na gem.
-  VERSION = '1.2.100'
+  VERSION = '1.2.102'
 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.98<!--END VER-->.
+The current version of `na` is <!--VER-->1.2.101<!--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.100
+  version: 1.2.102
 platform: ruby
 authors:
 - Brett Terpstra
@@ -360,7 +360,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 3.6.7
 specification_version: 4
 summary: A command line tool for adding and listing project todos
 test_files: []