howzit 2.1.39 → 2.1.40

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a934719a022ca2f6713474e797eb1a9662dc884a750c93648d4151506ae41571
-  data.tar.gz: f261e5e733bd2d695cc76ce36e74096d357983301156c6b5b2ce5757aa3637eb
+  metadata.gz: c8f040ba3e136aeb10470c40de3cc8272209d176841686aa242dffee1b9fb33f
+  data.tar.gz: a0e263004a627de3104cb52bb47a04aecacb7eab2389b34819d2ece891331c42
 SHA512:
-  metadata.gz: 9d928971e7280979fbfba50eedadedfadcf10ee31a26a4f94169c2cfe987706342fd3b826d781d89f4e3882fd87885e38b070352eae4b5e7a38c7fe06828046c
-  data.tar.gz: 72cc6fcc43c31a8d1827a5e421ebe41f06120d1fb0c428bb0339daa3e5c39b8477e769830fc302552723804033502aea5354b62b2e914a4d2e2a8bca9ac7421b
+  metadata.gz: 3d1ce1e58eb28518b0c977f5012436909100cc48fa56dfbf1cedf01389fb02a1ef32823d99b74f065456c07d105f54a1a9dc236a6c73050251ec6180f935af0b
+  data.tar.gz: e9197120a0dd16ca9aefae85f4dde9f09f06efe56d034faf65eee180aeb5fad02fbe158d8a59b17b007622acfaa44da9aa82312159bc488d49c2f61e5a57568c

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+### 2.1.40
+
+2026-02-04 07:53
+
+#### NEW
+
+- Added a --test-search flag that exits 0 when a search term matches at least one topic and 1 otherwise, with no normal output, allowing shells and scripts to probe for howzit topics programmatically
+
+#### IMPROVED
+
+- Build note processing in test-search mode now short-circuits without auto-creating buildnotes and treats the absence of any note file as a clean non-match instead of an error
+
 ### 2.1.39
 
 2026-01-25 07:39

data/bin/howzit

@@ -31,6 +31,10 @@ OptionParser.new do |opts|
 
   opts.on('-f', '--force', 'Continue executing after an error') { Howzit.options[:force] = true }
 
+  opts.on('--test-search TERM', 'Exit 0 if TERM matches any topic, 1 otherwise (no output)') do |term|
+    Howzit.options[:test_search] = term
+  end
+
   opts.on('-m', '--matching TYPE', MATCHING_OPTIONS,
           'Topics matching type', "(#{MATCHING_OPTIONS.join(', ').sub(/#{Howzit.options[:matching]}/, "*#{Howzit.options[:matching]}")})") do |c|
     Howzit.options[:matching] = c

data/fish/functions/howzit_command_not_found.fish

@@ -0,0 +1,15 @@
+function fish_command_not_found --description "Use howzit topics for unknown commands when available"
+    set cmd $argv[1]
+    set args $argv[2..-1]
+
+    # If a howzit topic matches the command name, run it instead
+    if howzit --test-search $cmd >/dev/null 2>&1
+        howzit -r $cmd $args
+        return $status
+    end
+
+    # Fall back to the default unknown-command message
+    echo "fish: Unknown command '$cmd'"
+    return 127
+end
+

data/lib/howzit/buildnote.rb

@@ -1126,6 +1126,15 @@ module Howzit
         Howzit.multi_topic_run = false
       end
 
+      # Test-search mode: do not auto-create a build note; just check for a match
+      if Howzit.options[:test_search]
+        term = Howzit.options[:test_search]
+        # If no note file can be found at all, treat as no match
+        Process.exit(1) unless note_file
+        matches = find_topic(term)
+        Process.exit(matches.any? ? 0 : 1)
+      end
+
       unless note_file
         Process.exit 0 if Howzit.options[:list_runnable_titles] || Howzit.options[:list_topic_titles]
 

data/lib/howzit/version.rb

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

data/zsh/howzit-command-not-found.zsh

@@ -0,0 +1,22 @@
+# howzit command-not-found handler for zsh
+#
+# When an unknown command is entered, this handler will check to see
+# if there is a howzit topic matching the command name. If so, it
+# runs `howzit -r <command> [args...]`. Otherwise, it falls back to
+# the standard "command not found" behavior.
+
+command_not_found_handler() {
+  local cmd="$1"
+  shift
+
+  # If a howzit topic matches the command name, run it instead
+  if howzit --test-search "$cmd" >/dev/null 2>&1; then
+    howzit -r "$cmd" "$@"
+    return $?
+  fi
+
+  # Fall back to the default unknown-command message
+  print "zsh: command not found: $cmd" >&2
+  return 127
+}
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: howzit
 version: !ruby/object:Gem::Version
-  version: 2.1.39
+  version: 2.1.40
 platform: ruby
 authors:
 - Brett Terpstra
@@ -294,6 +294,7 @@ files:
 - fish/completions/fisher.fish
 - fish/completions/howzit.fish
 - fish/functions/bld.fish
+- fish/functions/howzit_command_not_found.fish
 - howzit.gemspec
 - lib/howzit.rb
 - lib/howzit/buildnote.rb
@@ -334,6 +335,7 @@ files:
 - spec/util_spec.rb
 - src/_README.md
 - update_readmes.rb
+- zsh/howzit-command-not-found.zsh
 homepage: https://github.com/ttscoff/howzit
 licenses:
 - MIT