hiiro 0.1.383 → 0.1.384

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7d2d48728418d4a6d30a48f702f0aa89ba3d6d7d9552904a4da2bcbdc78ccdde
-  data.tar.gz: 3e14943d3dbbafab65ebc8fc11e763f88af12476d217b67a51f32a02ab1d536b
+  metadata.gz: 308d4ea2a261c3dd45eedd5b40bb0bcf8ada1b6cd2310bd908abac4e4d73c408
+  data.tar.gz: e138d7b8aeed4b9fa598dbe8d0d7dfb45abec78658c338a048d42d8d540a3a27
 SHA512:
-  metadata.gz: 970a8d0e22b46b7a1c20ca873d6ecb1d331c81a887d3bddffc15f743b5d0a9666ff823cdae7dfc03692116f1da77adfd47cc76d82087f0e66fe57a220270e5c4
-  data.tar.gz: 62d1f129d289f5cc3363aaaf69a4766366f26774396f23685aada9dc0115745ad09d9fdd1687004311f58b22e40b827d79cb64b13db7f191afdfd458cda6153e
+  metadata.gz: 9d0e4d5ab790f5c262d7d4c03517c7caf40214ad9e9e2b76e7df84724bdf19f105eff32c935bcdea3f73cc64ec3bdf5e922258ffed5c44cdd9969b2649e313b7
+  data.tar.gz: 74a0868f58e19659707345d4241f08ae0c112f2e925b2c5fe43e6faf008b7eceafdcc914aba27ce5f638ccd7c7c4b55a383ac7f3126cd78cc1e7b26a2daf263c

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.384] - 2026-09-23
+
+### Added
+- `h plist` command for working with property lists
+
+### Fixed
+- publish script now requires hiiro unconditionally at startup instead of only when falling back to local version
+
 ## [0.1.381] - 2026-09-20
 
 ### Added
@@ -14,8 +22,6 @@
 - `h save` subcommands: `ls`/`list`, `dir`, `show`/`cat`, `copy`, `open`, `edit`, `rm`/`remove` for managing saved files
 - `t path`, `t cd`, `t start`, and `t switch` accept optional `APP` argument to select a configured relative directory beneath the task root
 - APP resolves by exact name or unique case-sensitive prefix; fails when ambiguous or missing
-
-### Added
 - `t switch` / `t workspace` and `t cd` accept an optional APP positional (or `--app`) resolving through the apps registry by exact name or unique prefix; the workspace or pane cd targets the app directory under the task worktree, e.g. `t switch aldi cpm` opens `~/work/aldi/main/retailer-tools/content-page-migrator`
 
 ## [0.1.376] - 2026-09-14
@@ -143,14 +149,4 @@
 
 ### Removed
 - Remove tmux paste-buffer, jumplist, task-color, focus-hook, and arbitrary-layout features that Herdr 0.8.2 does not support.
-- Remove the old `Hiiro::Tmux` adapter and tmux-specific command tests.
-
-### Fixed
-- Strip the desktop notifier executable path and run notifications and sounds as detached processes instead of creating persistent Herdr tabs.
-- Preserve `add_cmd` declaration locations and argument metadata in generated help; allow command groups to pass arguments and help through to child commands.
-- Make undeclared `add_cmd opts:` entries boolean flags without consuming positional arguments; preserve explicit options and reserve conflicting short aliases.
-- Show selected command options for `add_cmd -h`/`--help` without executing the command block.
-- Focus the exact Herdr pane through the socket API and read the CLI's plain-text pane output without JSON parsing.
-- Restore the missing `Hiiro::Bins` helper so `require "hiiro"` boots and commands like `h jumplist record` dispatch correctly.
-- Make Hiiro's Ruby requirement explicit as Ruby 3.2+ and have rbenv-wide gem installs skip incompatible Ruby versions.
-- Update the publish script to preserve the Ruby support constant, run only on supported Ruby, and install releases only into compatible rbenv versions.
+- Remove the old `Hiiro::Tmux` adapter and tmux-specific command tests.

data/bin/h-js

@@ -5,6 +5,27 @@ require 'hiiro'
 # sed -n '/scripts.*[{]/,/[}]/p' package.json
 
 Hiiro.run do
+  add_cmd :add, args: ['NAME', 'COMMAND...'] do
+    abort 'Usage: h-js add NAME COMMAND... (use -- before command flags)' unless opts.args.length >= 2
+    name, *command_args = opts.args
+    abort 'Script name cannot be blank' if name.strip.empty?
+    command = command_args.length == 1 ? command_args.first : Shellwords.join(command_args)
+    abort 'Script command cannot be blank' if command.strip.empty?
+    abort 'No package.json in the current directory' unless File.file?('package.json')
+
+    package = JSON.parse(File.read('package.json'))
+    abort 'package.json must contain an object' unless package.is_a?(Hash)
+    package['scripts'] = {} unless package.key?('scripts')
+    abort 'package.json scripts must be an object' unless package['scripts'].is_a?(Hash)
+    abort "Script #{name.inspect} already exists" if package['scripts'].key?(name)
+
+    package['scripts'][name] = command
+    File.write('package.json', JSON.pretty_generate(package) + "\n")
+    puts "Added script #{name.inspect} to package.json"
+  rescue JSON::ParserError => error
+    abort "Invalid package.json: #{error.message}"
+  end
+
   add_cmd :pkg do
     file, *_other = Dir.glob('package.json')
 

data/bin/h-plist

@@ -0,0 +1,214 @@
+#!/usr/bin/env ruby
+
+require 'hiiro'
+require 'open3'
+require 'json'
+
+PLIST_TYPES = %w[bool integer float date string data xml json dictionary array].freeze
+PLIST_FORMATS = %w[xml1 binary1 json swift objc].freeze
+
+def require_plist(path)
+  unless path && !path.empty?
+    STDERR.puts 'A plist path is required.'
+    exit 1
+  end
+  expanded = File.expand_path(path)
+  unless File.file?(expanded)
+    STDERR.puts "Plist not found: #{expanded}"
+    exit 1
+  end
+  expanded
+end
+
+def run_plutil(*arguments, allow_failure: false)
+  stdout, stderr, status = Open3.capture3('plutil', *arguments)
+  unless status.success? || allow_failure
+    STDERR.print(stderr.empty? ? stdout : stderr)
+    exit status.exitstatus
+  end
+  [stdout, stderr, status]
+end
+
+def print_plutil(*arguments)
+  stdout, stderr, = run_plutil(*arguments)
+  STDOUT.print(stdout)
+  STDERR.print(stderr)
+end
+
+def validate_type(type)
+  return type if PLIST_TYPES.include?(type)
+  STDERR.puts "Unknown type #{type.inspect}. Use: #{PLIST_TYPES.join(', ')}"
+  exit 1
+end
+
+def mutation_arguments(verb, key, type, values)
+  args = [verb, key, "-#{validate_type(type)}"]
+  unless %w[dictionary array].include?(type)
+    if values.empty?
+      STDERR.puts "A value is required for type #{type}."
+      exit 1
+    end
+    args << values.join(' ')
+  end
+  args
+end
+
+Hiiro.run(*ARGV) do
+  add_subcmd(:show, :print) do |path=nil|
+    print_plutil('-p', '--', require_plist(path))
+  end
+
+  add_subcmd(:get) do |path=nil, key=nil, format='raw'|
+    unless key
+      STDERR.puts 'Usage: h plist get <file> <keypath> [raw|json|xml1|binary1]'
+      exit 1
+    end
+    unless %w[raw json xml1 binary1].include?(format)
+      STDERR.puts 'Format must be raw, json, xml1, or binary1.'
+      exit 1
+    end
+    print_plutil('-extract', key, format, '-o', '-', '--', require_plist(path))
+  end
+
+  add_subcmd(:keys) do |path=nil, key=nil|
+    plist = require_plist(path)
+    stdout, = if key
+                run_plutil('-extract', key, 'json', '-expect', 'dictionary', '-o', '-', '--', plist)
+              else
+                run_plutil('-convert', 'json', '-o', '-', '--', plist)
+              end
+    value = JSON.parse(stdout)
+    unless value.is_a?(Hash)
+      STDERR.puts(key ? "Not a dictionary: #{key}" : 'The plist root is not a dictionary.')
+      exit 1
+    end
+    puts value.keys.sort
+  end
+
+  add_subcmd(:type) do |path=nil, key=nil|
+    unless key
+      STDERR.puts 'Usage: h plist type <file> <keypath>'
+      exit 1
+    end
+    print_plutil('-type', key, '--', require_plist(path))
+  end
+
+  add_subcmd(:lint) do |*paths|
+    if paths.empty?
+      STDERR.puts 'Usage: h plist lint <file...>'
+      exit 1
+    end
+    expanded = paths.map { |path| require_plist(path) }
+    print_plutil('-lint', '--', *expanded)
+  end
+
+  add_subcmd(:set) do |path=nil, key=nil, *arguments|
+    unless key
+      STDERR.puts 'Usage: h plist set <file> <keypath> [type] <value>'
+      exit 1
+    end
+    type = PLIST_TYPES.include?(arguments.first) ? arguments.shift : 'string'
+    values = arguments
+    plist = require_plist(path)
+    _, _, status = run_plutil('-type', key, '--', plist, allow_failure: true)
+    verb = status.success? ? '-replace' : '-insert'
+    print_plutil(*mutation_arguments(verb, key, type, values), '--', plist)
+  end
+
+  add_subcmd(:add, :insert) do |path=nil, key=nil, *arguments|
+    unless key
+      STDERR.puts 'Usage: h plist add <file> <keypath> [type] <value>'
+      exit 1
+    end
+    type = PLIST_TYPES.include?(arguments.first) ? arguments.shift : 'string'
+    values = arguments
+    print_plutil(*mutation_arguments('-insert', key, type, values), '--', require_plist(path))
+  end
+
+  add_subcmd(:rm, :remove, :delete) do |path=nil, key=nil|
+    unless key
+      STDERR.puts 'Usage: h plist rm <file> <keypath>'
+      exit 1
+    end
+    print_plutil('-remove', key, '--', require_plist(path))
+  end
+
+  add_subcmd(:convert) do |path=nil, format=nil, output=nil|
+    plist = require_plist(path)
+    unless PLIST_FORMATS.include?(format)
+      STDERR.puts "Usage: h plist convert <file> <#{PLIST_FORMATS.join('|')}> [output]"
+      exit 1
+    end
+    args = ['-convert', format]
+    args.concat(['-o', File.expand_path(output)]) if output
+    print_plutil(*args, '--', plist)
+  end
+
+  add_subcmd(:json) do |path=nil|
+    print_plutil('-convert', 'json', '-r', '-o', '-', '--', require_plist(path))
+  end
+
+  add_subcmd(:xml) do |path=nil|
+    print_plutil('-convert', 'xml1', '-o', '-', '--', require_plist(path))
+  end
+
+  add_subcmd(:create) do |path=nil, format='xml1'|
+    unless path
+      STDERR.puts 'Usage: h plist create <file> [xml1|binary1|json]'
+      exit 1
+    end
+    unless %w[xml1 binary1 json].include?(format)
+      STDERR.puts 'Create format must be xml1, binary1, or json.'
+      exit 1
+    end
+    expanded = File.expand_path(path)
+    if File.exist?(expanded)
+      STDERR.puts "Refusing to overwrite existing file: #{expanded}"
+      exit 1
+    end
+    print_plutil('-create', format, expanded)
+  end
+
+  add_subcmd(:edit) do |path=nil|
+    exec('safe_nvim', require_plist(path))
+  end
+
+  add_subcmd(:help) do
+    puts <<~HELP
+      h-plist — inspect and modify Apple property lists with plutil
+
+      READ:
+        h plist <file>                         Pretty-print a plist
+        h plist show <file>                    Pretty-print a plist
+        h plist get <file> <keypath> [format]  Extract a value
+        h plist keys <file> [dict-keypath]     List dictionary keys
+        h plist type <file> <keypath>          Print a value's type
+        h plist lint <file...>                 Validate plist syntax
+        h plist json <file>                    Emit readable JSON
+        h plist xml <file>                     Emit XML
+
+      WRITE:
+        h plist set <file> <keypath> [type] <value>  Insert or replace
+        h plist add <file> <keypath> [type] <value>  Insert only
+        h plist rm <file> <keypath>                  Remove a value
+        h plist convert <file> <format> [output]     Convert in place or copy
+        h plist create <file> [format]               Create without overwrite
+        h plist edit <file>                          Open with safe_nvim
+
+      TYPES:
+        bool, integer, float, date, string (default), data, xml, json,
+        dictionary, array
+
+      Key paths use plutil syntax. Numeric components address array indexes.
+      Quote values containing spaces. Mutating commands edit the file in place.
+    HELP
+  end
+
+  add_default do |path=nil|
+    if path
+      print_plutil('-p', '--', require_plist(path))
+    else
+      run_subcmd(:help)
+    end
+  end
+end