na 1.2.86 → 1.2.88

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 05b84c85234711e95bc6fae91b279577d0908ba7bc0b1fb254729d65c2823f99
-  data.tar.gz: acf70b87b92d32a81ae7802397e3f72fd72b28410c50556c680ad0f05c6ea21f
+  metadata.gz: b06708529c5a33331a67f4295783bee29e559343ff3e2aa097f0802efac04ca6
+  data.tar.gz: 4bf4437737504d54b4cd018c339a4643ca1d108d94e407624040905c0fa5e9f8
 SHA512:
-  metadata.gz: 627981de849f31ca58ba38ff7e40915baf7cbf32f4a78d005f35a2590b853a477e28e71c209b5974cb9f4eae311d3f9e4c14c4fd690a253c16584bcac7d48fb1
-  data.tar.gz: 362e2719a19069a27cad8937d3ed7cabd81a7fd57a2b9f6a1dfa72ff439adf3fd64e691f651ad46020cdd4cdd08d0b6161b93adfcaf75c96040cf75451397a2f
+  metadata.gz: b3aac3037d6a51782dad07a452e4fc3e987ef4b3165dfc718119a7b9b5afc23ad42c069243769bf160cd6852f65a239ab655300e465524d03e9480fbef853282
+  data.tar.gz: 67aa8edd664f3023a9cef4478c1ef607aba7f8b435413579d51110fdeeddbd9786674ad9320c65a3b7ef3d3b00b34860510fcae089fba37843fc010253306a92

data/.cursor/commands/changelog.md

@@ -0,0 +1,4 @@
+Write a commmit message that uses @ labels to specify what type of change each line is. Apply @new, @fixed, @changed, @improved, and @breaking as appropriate to each line. Only add @ labels to changes that affect the user, not technical details. Technical details can be included in the commit, just don't add @ labels to those lines. Be sure to include a general description (< 60 characters) as the first line, followed by a line break.
+
+
+Save this commit message to commit_message.txt. Overwrite existing contents.

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-10-27 21:36:52 UTC using RuboCop version 1.75.7.
+# on 2025-10-28 13:13:50 UTC using RuboCop version 1.75.7.
 # 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
@@ -21,46 +21,51 @@ Lint/UnusedMethodArgument:
   Exclude:
     - 'lib/na/string.rb'
 
-# Offense count: 36
+# Offense count: 45
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
 Metrics/AbcSize:
-  Max: 243
+  Max: 276
 
-# Offense count: 9
+# Offense count: 11
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 # AllowedMethods: refine
 Metrics/BlockLength:
-  Max: 144
+  Max: 158
 
 # Offense count: 5
+# Configuration parameters: CountBlocks, CountModifierForms.
+Metrics/BlockNesting:
+  Max: 4
+
+# Offense count: 6
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ClassLength:
-  Max: 777
+  Max: 904
 
-# Offense count: 25
+# Offense count: 34
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/CyclomaticComplexity:
-  Max: 70
+  Max: 82
 
-# Offense count: 40
+# Offense count: 53
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 146
+  Max: 183
 
-# Offense count: 3
+# Offense count: 5
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ModuleLength:
-  Max: 779
+  Max: 906
 
-# Offense count: 4
+# Offense count: 5
 # Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
 Metrics/ParameterLists:
-  Max: 19
+  Max: 22
 
-# Offense count: 24
+# Offense count: 33
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/PerceivedComplexity:
-  Max: 81
+  Max: 94
 
 # Offense count: 1
 # Configuration parameters: ForbiddenDelimiters.
@@ -91,6 +96,14 @@ Style/ModuleFunction:
   Exclude:
     - 'lib/na/colors.rb'
 
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, ConsistentQuotesInMultiline.
+# SupportedStyles: single_quotes, double_quotes
+Style/StringLiterals:
+  Exclude:
+    - 'lib/na/next_action.rb'
+
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyle.
@@ -105,7 +118,7 @@ Style/YAMLFileRead:
   Exclude:
     - 'lib/na/theme.rb'
 
-# Offense count: 22
+# Offense count: 30
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https

data/2025-10-29-one-more-na-update.md

@@ -0,0 +1,142 @@
+---
+layout: post
+title: One more na update
+categories:
+- Code
+- Blog
+tags:
+- scripting
+- zsh
+- tagging
+- na
+- cli
+- ruby
+- productivity
+- taskpaper
+date: 2025-10-29 08:00
+slug: one-more-na-update
+post_class: code
+keywords: [next action]
+---
+This week I pushed a set of focused improvements to [NA](https://brettterpstra.com/projects/na) that make interactive workflows a lot smoother and the codebase a little more robust — including first‑class time tracking.
+
+If you run `na update` without arguments you'll now get an interactive menu that helps you pick the file(s) and actions to operate on, with multiple selection and small but important quality-of-life fixes across parsing, move/edit behavior, and documentation.
+
+## TL;DR
+
+- `na update` (no args) now launches an interactive, consistent selection flow for files and actions.
+- The update submenu supports multi-select, edit, move, and direct action modes more reliably.
+- Fixed many edge cases: nil-safe string helpers, clearer YARD docs, and better tests for helper code.
+- Under-the-hood improvements to file selection, action movement, and tagging logic.
+
+### New: Time tracking
+
+- Add start/finish times right from the CLI:
+  - `--started TIME` on `add`, `complete`/`finish`, and `update`
+  - `--end TIME` (alias `--finished`) on `add`, `complete`/`finish`, and `update`
+  - `--duration DURATION` to backfill a start time from the finish
+- Natural language and shorthand supported everywhere: `30m ago`, `-2h`, `2h30m`, `2:30 ago`, `yesterday 5pm`
+- Durations aren’t stored; they’re computed from `@started(...)` and `@done(...)` when displayed.
+- Display enhancements in `next`/`tagged`:
+  - `--times` shows per‑action durations and a grand total (implies `--done`)
+  - `--human` switches durations to friendly text
+  - `--only_timed` filters to actions with both `@started` and `@done` (implies `--times --done`)
+  - `--only_times` outputs only the totals (no action list; implies `--times --done`)
+  - `--json_times` emits a JSON object with timed actions, per‑tag totals, and overall totals (implies `--times --done`)
+  - Per‑tag totals are shown as a Markdown table with aligned columns and a footer row for the grand total
+  - Duration color is theme‑configurable via a `duration` key (default `{y}`)
+
+Example:
+
+```bash
+na add --started "30 minutes ago" "Investigate bug"
+na complete --finished now --duration 2h30m "Investigate bug"
+na next --times --human
+na next --only_times
+na tagged bug --json_times | jq
+```
+
+## What triggered this
+
+A number of small UX issues had crept in over time: the interactive menu sometimes re-prompted or skipped expected options, move/edit operations wouldn't always update a project's indexes correctly, and a few helper methods could raise when given `nil` paths or values. I wanted to make the interactive flow predictable and to harden the helpers so the command-line experience is less brittle.
+
+## Interactive `na update` flow
+
+Run `na update` with no arguments and you'll see a consistent selection flow:
+
+- Choose one or more todo files (fuzzy search / [fzf](https://github.com/junegunn/fzf) / [gum](https://github.com/charmbracelet/gum) used when available).
+- Pick which actions to update (multi-selection supported).
+- Choose an operation: edit, move, add tag, remove tag, mark done, delete.
+
+Examples:
+
+```bash
+$ na update
+Select files: (interactive list)
+Select actions (multi):
+  [x] 23 % Inbox/Work : - Fix X
+  [x] 45 % Inbox/Personal : - Call Y
+Choose operation: (edit / move / done / delete / tag)
+```
+
+The menu now behaves consistently whether you pick a single file or multiple files; if you choose multi-select the update command applies as you'd expect to the set of chosen actions.
+
+There's a direct action mode when you know the file and action: `na update PATH -l 23` still works as before. The interactive flow only kicks in when no explicit target is provided.
+
+## Notable fixes
+
+A lot of the work was small but important:
+
+- Nil-safe string helpers: `trunc_middle`, `highlight_filename`, and friends were guarded against `nil` inputs so tests and UI code don't explode when a file is missing or the database contains a stray blank line.
+- Action move/edit correctness: moving an action to a different project now updates parent indexes and project line numbers properly, avoiding off-by-one bugs that could leave the file in a strange state.
+- `select_file` and fuzzy matching: the fuzzy and database-driven file selection was made more robust — the code handles directories that have a `file.na` or `file/file.na` pattern and falls back to a clear error instead of failing silently.
+- YARD docs: cleaned up a number of `@!method` directives and added top-level `@example` blocks for the main classes and helpers so the docs are friendlier and generate without warnings.
+- Tests: added and fixed unit tests for `Array`, `Hash`, and `String` helpers. TTY screen and color-related test stubs were improved for reliability on CI.
+  - New tests for time features: JSON output, totals‑only output, timed‑only filtering.
+
+## Try it
+
+You can update to the latest version with:
+
+{% iterm "gem install na" %}
+
+That should give you v1.2.85 or higher.
+
+If you're on a recent development build or want to try the updates locally:
+
+```bash
+# From the gem checkout
+bundle exec bin/na update
+
+# Or after building the gem and installing
+na update
+```
+
+If you run into anything odd, please open an issue with the command you ran and a short description of what you expected vs what happened. Small, reproducible steps are the fastest way to a fix.
+
+If you hit an error and want to include a backtrace, run the command with debug enabled and paste the output:
+
+```bash
+GLI_DEBUG=true na [COMMAND]
+```
+
+## Other updates
+
+I last wrote about 1.2.80. Here are a few highlights from the subsequent releases:
+
+- 1.2.85 (2025-10-26)
+  - YARD docs polish — coverage is now effectively complete
+  - Nil-safety: guards for `trunc_middle` and `highlight_filename`
+- 1.2.84 (2025-10-25)
+  - Fix: handle nil input when traversing depth
+- 1.2.83 (2025-10-25)
+  - Fix: ignore `-d X` values that exceed existing structure depth
+  - Allow depth > 9 for `-d`
+- 1.2.82 (2025-10-25)
+  - New: multi‑select menu when using `na update`
+- 1.2.81 (2025-10-25)
+  - New: `na scan` to find untracked todo files (thanks @rhsev)
+  - Improvements: RuboCop cleanup, YARD docs, and test coverage
+  - Fixes: color reset in parent display; subdirectory traversal with `na next -d X`
+
+Thanks for playing with it and for the helpful feedback you've been sending. Check out the [NA project page](https://brettterpstra.com/projects/na) for more info.

data/CHANGELOG.md

@@ -1,6 +1,102 @@
+### 1.2.88
+
+2025-10-28 08:22
+
+#### CHANGED
+
+- Update command interactive menu lists available plugins
+- README: add detailed Plugins section with examples and schema
+- CHANGELOG: add 1.2.88 entry for plugins feature
+
+#### NEW
+
+- Plugin system with scripts in ~/.local/share/na/plugins
+- Na plugin command to run plugins on selected actions
+- --plugin/--input/--output/--divider flags on update/next/tagged/find
+- Plugin IO supports json, yaml, csv, and text formats
+- ACTION support in plugin IO (UPDATE/DELETE/COMPLETE/RESTORE/ARCHIVE/ADD_TAG/DELETE_TAG/MOVE)
+- Auto-create plugins dir with README and sample plugins (Add Foo.py, Add Bar.sh)
+- Display commands can pipe through plugins (STDOUT-only, no writes)
+- Add --json_times to next/tagged (JSON of timed actions, tags, total)
+- Add --only_times to next/tagged (show only totals, no action list)
+
+#### IMPROVED
+
+- Duration/time docs and output clarifications in README
+- Internal plugin README with metadata, IO, and examples
+- --only_timed, --times, and --json_times imply --done automatically
+- Per-tag duration totals rendered as aligned Markdown table with footer
+- Duration color configurable via theme key `duration` (default {y})
+
+#### FIXED
+
+- Plugin update path writing duplicate actions; now in-place by line
+- Plugin apply finds action via target_line, avoids Symbol->Integer error
+- String#wrap indentation and width handling for multi-line wrapping
+- Lint/DuplicateBranch in plugin parse_actions
+- Style/MapToHash in apply_plugin_result
+- String wrapping now wraps at requested widths (e.g., 60 cols) and indents
+
+### 1.2.87
+
+2025-10-28 06:21
+
+#### CHANGED
+
+- Default theme/templates include `%line`; users with custom theme may need to regenerate to see line numbers
+
+#### NEW
+
+- Display line numbers with actions across `na next` and selection
+- Support `PATH:LINE` targeting in `na update` and `na edit`
+- Multi-action editing in external editor using `# ------ PATH:LINE` markers; notes supported beneath each action
+- Add --started flag on add/complete(update) to set @started
+- Add --finished alias to --end on add/complete/update to set @done
+- Add --duration (add/complete/update); backfills @started from --end
+- Add --times (next/tagged) to show per-action durations and totals
+- Add --human (next/tagged) for human-friendly duration format
+- Add --only_timed (next/tagged) to show only items with @started/@done
+- Add --json_times to next/tagged (JSON of timed actions, tags, total)
+- Add --only_times to next/tagged (show only totals, no action list)
+
+#### IMPROVED
+
+- --times and --only_timed imply --done for next/tagged
+- Duration annotations render with theme colors in output
+- Natural-language dates for @started/@done normalized automatically
+- Support shorthand: 2h30m, 30m ago, -2:30, 2:05 ago
+- --only_timed, --times, and --json_times imply --done automatically
+- Per-tag duration totals rendered as aligned Markdown table with footer
+- Duration color configurable via theme key `duration` (default {y})
+
+#### FIXED
+
+- Incorrect colorization (unexpected bright green) in action output
+- Search highlighting no longer corrupts ANSI color codes or numbers in escape sequences
+- Multi-action editor now only includes the specifically selected lines (no duplicates)
+- Delete in update menu removes the correct lines
+- Multi-select updates process bottom-to-top to avoid line shifts
+- String wrapping now wraps at requested widths (e.g., 60 cols) and indents
+
 ### 1.2.86
 
-2025-10-27 17:16
+2025-10-28 02:29
+
+#### CHANGED
+
+- Default theme/templates include `%line`; users with custom theme may need to regenerate to see line numbers
+
+#### NEW
+
+- Display line numbers with actions across `na next` and selection
+- Support `PATH:LINE` targeting in `na update` and `na edit`
+- Multi-action editing in external editor using `# ------ PATH:LINE` markers; notes supported beneath each action
+
+#### FIXED
+
+- Incorrect colorization (unexpected bright green) in action output
+- Search highlighting no longer corrupts ANSI color codes or numbers in escape sequences
+- Multi-action editor now only includes the specifically selected lines (no duplicates)
 
 ### 1.2.85
 

data/Gemfile

@@ -4,4 +4,11 @@ source 'https://rubygems.org'
 gemspec
 gem 'rake'
 
-gem "simplecov", "~> 0.22.0", group: :development
+gem 'simplecov', '~> 0.22.0', group: :development
+
+group :development do
+  gem 'rubocop', '~> 1.66'
+  gem 'rubocop-performance', '~> 1.21'
+end
+gem 'chronic'
+gem 'csv'

data/Gemfile.lock

@@ -1,8 +1,9 @@
 PATH
   remote: .
   specs:
-    na (1.2.86)
+    na (1.2.88)
       chronic (~> 0.10, >= 0.10.2)
+      csv (>= 3.2)
       git (~> 3.0.0)
       gli (~> 2.21.0)
       mdless (~> 1.0, >= 1.0.32)
@@ -29,12 +30,14 @@ GEM
       uri (>= 0.13.1)
     addressable (2.8.7)
       public_suffix (>= 2.0.2, < 7.0)
+    ast (2.4.3)
     base64 (0.3.0)
     bigdecimal (3.3.1)
     bump (0.6.1)
     chronic (0.10.2)
     concurrent-ruby (1.3.5)
     connection_pool (2.5.4)
+    csv (3.3.5)
     diff-lcs (1.6.2)
     docile (1.4.1)
     drb (2.2.3)
@@ -47,15 +50,25 @@ GEM
     i18n (1.14.7)
       concurrent-ruby (~> 1.0)
     json (2.15.2)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
     logger (1.7.0)
     mdless (1.0.37)
     minitest (5.26.0)
     ostruct (0.6.3)
+    parallel (1.27.0)
+    parser (3.3.8.0)
+      ast (~> 2.4.1)
+      racc
+    prism (1.6.0)
     process_executer (1.3.0)
     public_suffix (6.0.2)
+    racc (1.8.1)
+    rainbow (3.1.1)
     rake (13.3.0)
     rchardet (1.10.0)
     rdoc (4.3.0)
+    regexp_parser (2.10.0)
     rspec (3.13.0)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
@@ -69,6 +82,25 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.6)
+    rubocop (1.75.7)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.44.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.44.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-performance (1.25.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    ruby-progressbar (1.13.0)
     securerandom (0.4.1)
     simplecov (0.22.0)
       docile (~> 1.1)
@@ -87,6 +119,9 @@ GEM
     tty-which (0.5.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
     uri (1.0.4)
     wisper (2.0.1)
 
@@ -105,11 +140,15 @@ PLATFORMS
 
 DEPENDENCIES
   bump (~> 0.6.0)
+  chronic
+  csv
   minitest (~> 5.14)
   na!
   rake
   rdoc (~> 4.3)
   rspec (~> 3.0)
+  rubocop (~> 1.66)
+  rubocop-performance (~> 1.21)
   simplecov (~> 0.22.0)
   tty-spinner (~> 0.9, >= 0.9.0)