hiiro 0.1.392 → 0.1.393

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad2d60d5740dd8e55e05cb747b2bd6b5e29a04e0afea78044d27b8bd07d89d4b
-  data.tar.gz: edbb5719e7e2e7fca15751c62140f1c1ef8eb25f62d52a8d3e4d9369e86d400c
+  metadata.gz: ead58a6f2c9467256f546afcf8ef417f755717c6f6c346a31f7ae44290fd9d44
+  data.tar.gz: c5d4759a675c8f464bc8c6efda43e24abeb8945ef782ca7890365f3bfadbd66a
 SHA512:
-  metadata.gz: 3b77ec5fd8c0035039f265df261e982d7e02d730292fdf91196322cce5dba1ce66683e058cbd5816c02d1dc9f5cb1392e32ff8a4638f3766413b8ed28f57db75
-  data.tar.gz: 1dfc40943e3a3dcd494eae3f0f9ca642b4cbf926db55a5a64ff256003a1fc7b2bb556677c47cdb1b0a2058b8fab42c836424e6b363cf586cae76e6b8190805f5
+  metadata.gz: db0fca7b6671893efcb5d6636c49b87cdca6ef0af063ef27be6cb67e1b6b02c5bd36646499adbcdad6b9318a489c51fd6fa8765b3868b7d490b09634442110c8
+  data.tar.gz: 6eb79e4d02b4ce0c2d3bf50770b0ed5ad8410ad035d90ae27f5df85039ded7d3491c3ee0e355a92680219ec73825c6cff531dae858d5634608012248aa304a6b

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [0.1.393] - 2026-10-12
+
+### Added
+- `h json` subcommand (`bin/h-json`)
+
 ## [0.1.392] - 2026-10-12
 
 ### Changed
@@ -24,6 +29,9 @@
 
 ## Unreleased
 
+### Changed
+- `h strip ctrl` replaces bare `h strip` for stripping ASCII terminal escapes and C0/DEL controls from files, stdin, or text. Tabs, line feeds, UTF-8 text, and raw invalid bytes are preserved.
+
 ### Fixed
 - Fix `PsProcess::Snapshot.capture` constant lookup, which raised `NameError` in `h ps byport`, `h ps indir`, and parent/child process lookups.
 

data/README.md

@@ -123,6 +123,23 @@ printf '%s\n' '"src/my file.rb:12:3"' | h extract files --no-check
 printf '%s\n' 'missing/output/' | h extract dirs --no-check
 ```
 
+### Strip terminal escapes and controls
+
+`h strip ctrl` removes terminal escape sequences and control characters from
+files, piped stdin, or literal text. Tabs, newlines, and UTF-8 text are preserved.
+
+```sh
+h strip ctrl terminal.log > clean.log
+printf '\033[31mhello\033[0m\n' | h strip ctrl
+h strip ctrl hello world
+h strip ctrl --help
+```
+
+The command writes to stdout without adding a newline and reads the whole input
+into memory. Redirect to a different file, not the input file. The command does
+not reconstruct a terminal screen. See [the strip reference](docs/h-misc.md#h-strip-ctrl)
+for input selection and supported escape sequences.
+
 ### Task CLI
 
 `t` and `tt` are gem executables in `exe/`, installed alongside `h`. They are thin
@@ -230,6 +247,7 @@ See the [task command reference](docs/t.md) for all commands and the [workflow i
 | `h run` | Run dev tools (lint/test/format) against changed files |
 | `h session` | Compatibility commands for Herdr workspaces |
 | `h sha` | Extract short SHA from git log |
+| [`h strip ctrl`](docs/h-misc.md#h-strip-ctrl) | Strip terminal escapes and controls from files, stdin, or text |
 | [`h table`](docs/h-table.md) | TUI and scriptable CLI over registry tables (links, sounds, pins, ...) with task scope, tags, and per-table actions |
 | `h todo` | Todo list management with tags and task association |
 | `h window` | Compatibility commands for Herdr tabs |

data/bin/h-json

@@ -0,0 +1,28 @@
+#!/usr/bin/env ruby
+
+require 'hiiro'
+
+Hiiro.run do
+  add_cmd :structure, args: ['[FILE...]'] do
+    if opts.args.empty? && $stdin.tty?
+      abort 'Usage: h-json structure [FILE...] (or pipe JSON into stdin)'
+    end
+
+    filter = <<~JQ
+      def structure:
+        if type == "object" then
+          with_entries(.value |= structure)
+        elif type == "array" then
+          map(structure) | unique
+        else
+          type
+        end;
+
+      structure
+    JQ
+
+    exec('jq', '--', filter, *opts.args)
+  rescue Errno::ENOENT
+    abort 'h-json structure requires jq on PATH'
+  end
+end

data/bin/h-strip

@@ -1,39 +1,28 @@
 #!/usr/bin/env ruby
 
-USAGE = <<~TEXT
-  Usage:
-    command | h strip
-    h strip TEXT...
-    h strip FILE...
-
-  Removes ANSI escape sequences and control characters, preserving tabs and newlines.
-  Existing file arguments are concatenated; other arguments are joined with spaces.
-TEXT
+require 'hiiro'
 
 ANSI = /
   (?:
-    (?:\x1B\[|\x9B)[\x30-\x3F]*[\x20-\x2F]*[\x40-\x7E] |
-    (?:\x1B\]|\x9D)[^\x07\x1B\x9C]*(?:\x07|\x1B\\|\x9C) |
-    (?:\x1B[P^_]|[\x90\x98\x9E\x9F])[^\x1B\x9C]*(?:\x1B\\|\x9C) |
+    \x1B\[[\x30-\x3F]*[\x20-\x2F]*[\x40-\x7E] |
+    \x1B\][^\x07\x1B]*(?:\x07|\x1B\\) |
+    \x1B[P^_][^\x1B]*(?:\x1B\\) |
     \x1B[\x20-\x2F]*[\x30-\x7E]
   )
 /nx
-CONTROL = /[\x00-\x08\x0B-\x1F\x7F-\x9F]/n
-
-def input_bytes(arguments)
-  if arguments.empty?
-    abort USAGE if STDIN.tty?
-    return STDIN.binmode.read
-  end
+CONTROL = /[\x00-\x08\x0B-\x1F\x7F]/n
 
-  paths = arguments.map { |argument| File.expand_path(argument) }
-  return paths.map { |path| File.binread(path) }.join if paths.all? { |path| File.file?(path) }
+Hiiro.run do
+  add_cmd :ctrl, args: ['[FILE...|TEXT...]'] do
+    arguments = opts.args
+    paths = arguments.map { |argument| File.expand_path(argument) }
+    input = if arguments.empty? || paths.all? { |path| File.file?(path) }
+      Hiiro::Shell.read_input(*paths)
+    else
+      arguments.join(' ')
+    end
 
-  arguments.join(' ')
-end
-
-if %w[-h --help help].include?(ARGV.first)
-  puts USAGE
-  exit
+    STDOUT.binmode.write(input.b.gsub(ANSI, '').gsub(CONTROL, ''))
+    nil
+  end
 end
-STDOUT.binmode.write(input_bytes(ARGV).gsub(ANSI, '').gsub(CONTROL, ''))

data/docs/h-misc.md

@@ -30,3 +30,43 @@ Walk one or more directories and list all symlinks whose destinations fall outsi
 h misc symlink_destinations packages/
 h misc symlink_destinations packages/ apps/ --root /path/to/repo
 ```
+
+## h strip ctrl
+
+`h strip ctrl` is a separate external command, not an `h misc` subcommand. It
+removes terminal escape sequences and control characters from input bytes.
+
+```bash
+h strip ctrl FILE...
+command | h strip ctrl
+h strip ctrl TEXT...
+h strip ctrl --help
+```
+
+When every argument names an existing file, the command concatenates their bytes
+in argument order, without separators. Otherwise, it treats all arguments as
+literal text and joins them with spaces. With no arguments, it reads piped stdin.
+
+Output goes to stdout without an added newline. Tabs, line feeds, UTF-8 text, and
+raw invalid bytes are preserved. The command removes:
+
+- ASCII ESC sequences, including CSI color, cursor, and erase commands.
+- OSC sequences terminated by BEL or ESC followed by a backslash.
+- DCS, APC, and PM sequences terminated by ESC followed by a backslash.
+- C0 controls and DEL, except tab and line feed.
+
+Bytes from `0x80` through `0x9F` are not interpreted as C1 terminal controls.
+Stripping does not reconstruct a terminal screen or apply cursor movements.
+The command reads the whole input into memory.
+
+### Examples
+
+```bash
+h strip ctrl terminal.log > clean.log
+h strip ctrl first.log second.log > combined-clean.log
+printf '\033[31mhello\033[0m\n' | h strip ctrl
+h strip ctrl $'\033[31mhello\033[0m' world
+```
+
+Redirect to a different file. Redirecting stdout to an input file truncates that
+file before the command reads it.

data/lib/hiiro/version.rb

@@ -1,4 +1,4 @@
 class Hiiro
-  VERSION = "0.1.392"
+  VERSION = "0.1.393"
   SUPPORTED_RUBY_VERSION = ">= 3.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hiiro
 version: !ruby/object:Gem::Version
-  version: 0.1.392
+  version: 0.1.393
 platform: ruby
 authors:
 - Joshua Toyota
@@ -176,6 +176,7 @@ files:
 - bin/h-html
 - bin/h-img
 - bin/h-js
+- bin/h-json
 - bin/h-jsonl
 - bin/h-jumplist
 - bin/h-link