squared 0.9.0 → 0.9.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 41f1d82942dcd7279ec182d1fc0bdc8f90ccc2e476860c6ca70bc89286417598
-  data.tar.gz: e6b7773f70fd0d2867fe13bdae57324dd6c90048c8bea3b27937738edf4df78c
+  metadata.gz: 7bc8d196a7c5068373757f7bbb9ba037cafd30500875d924628690f57451b927
+  data.tar.gz: '00078ddc57f3f357cc9833a679c42d636936d0db91e75a327a07ba19dedd0165'
 SHA512:
-  metadata.gz: cc02b93ac5fbfd34e23ff87cda66a3665fca3490c942e7a5942edb9ba6540eb6b95e1c87d8273444ec4bbac6d56841b7b3213295ce9ee856c15383794ecac97a
-  data.tar.gz: ee1c5b726339754ee878ff97cd9994983cbc5ca4822d2ffa25170c2f3512414966f367dcc5c4f0f2bc1eb8156667b88fcffc294ccbab1468c57ef465bb387243
+  metadata.gz: c5b85d626962791e9da8355f82999b0ab8bcd1e63f88605c6a3dfecb8b5b515469373acb8f7d79eab4887b3b3f826e1d540133361b74e5c3e3160545215b3641
+  data.tar.gz: ee09108c1abea47c45ae2a931e01a9b1e42097dd597537796543321aaca03b9825d9942a26274c7fbca344f748b1d4b8765102dcd7b74f54489e7dc2115b5a97

data/CHANGELOG.md

@@ -1,5 +1,81 @@
 # Changelog
 
+## [0.9.2] - 2026-11-04
+
+### Added
+
+- sqd: Option --no-gemfile for undoing bundle exec project wrapper.
+- sqd: Option --commit for pushing files to remote branch.
+- sqd: Option --mulitline for writing messages with newlines.
+- sqd: Option --amend[-orig] for replacing current commit.
+- sqd: Option --project can match common subtasks.
+
+### Changed
+
+- Logger warn statements from project misconfiguration were downgraded.
+- sqd: Task creation from joins are validated before consuming arguments.
+
+### Fixed
+
+- sqd: Option --project did not support multiple patterns.
+
+## [0.8.8]
+
+- See `0.7.15`.
+
+## [0.7.15]
+
+### Added
+
+- Git command commit action pathspec was implemented.
+- Common base argument TAB for column alignment was created.
+- Node command package action deny can modify currently approved scripts.
+
+### Changed
+
+- Node command package action [approve|deny] uses install-scripts ls.
+
+### Fixed
+
+- Bundle exec wrapper as a Hash did not support using alternate Gemfile.
+- Common base ARG data objects were not frozen with __freeze__.
+
+## [0.9.1] - 2026-10-22
+
+### Added
+
+- sqd: Option --gemfile for rerouting commands through bundle exec.
+- Python install manager for Windows is supported.
+- sqd: Option --sync for running threads in a series was implemented.
+
+## [0.8.7]
+
+### Added
+
+- OptionPartition can be initialized with enum and pattern options.
+
+### Fixed
+
+- Python venv creation did not run post-install for package managers.
+
+## [0.7.14]
+
+### Changed
+
+- Python program meson prefix options use local path resolution.
+- Bundle exec wrapper can be configured per application.
+
+### Fixed
+
+- Bundle exec wrapper did not accept boolean values.
+
+## [0.6.21]
+
+### Fixed
+
+- RuboCop did not resolve config to project directory.
+- Python program did not use correct separator for double dash options.
+
 ## [0.9.0] - 2026-10-12
 
 ### Added
@@ -63,7 +139,7 @@
 
 - OptionPartition did not parse quoted option values.
 
-## [0.6.20] - 2026-09-25
+## [0.6.20]
 
 ### Added
 
@@ -2198,7 +2274,11 @@
 
 - Changelog was created.
 
+[0.9.2]: https://github.com/anpham6/squared-ruby/releases/tag/v0.9.2
+[0.9.1]: https://github.com/anpham6/squared-ruby/releases/tag/v0.9.1
 [0.9.0]: https://github.com/anpham6/squared-ruby/releases/tag/v0.9.0
+[0.8.8]: https://github.com/anpham6/squared-ruby/releases/tag/v0.8.8
+[0.8.7]: https://github.com/anpham6/squared-ruby/releases/tag/v0.8.7
 [0.8.6]: https://github.com/anpham6/squared-ruby/releases/tag/v0.8.6
 [0.8.5]: https://github.com/anpham6/squared-ruby/releases/tag/v0.8.5
 [0.8.4]: https://github.com/anpham6/squared-ruby/releases/tag/v0.8.4
@@ -2206,6 +2286,8 @@
 [0.8.2]: https://github.com/anpham6/squared-ruby/releases/tag/v0.8.2
 [0.8.1]: https://github.com/anpham6/squared-ruby/releases/tag/v0.8.1
 [0.8.0]: https://github.com/anpham6/squared-ruby/releases/tag/v0.8.0
+[0.7.15]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.15
+[0.7.14]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.14
 [0.7.13]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.13
 [0.7.12]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.12
 [0.7.11]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.11
@@ -2220,6 +2302,7 @@
 [0.7.2]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.2
 [0.7.1]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.1
 [0.7.0]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.0
+[0.6.21]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.21
 [0.6.20]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.20
 [0.6.19]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.19
 [0.6.18]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.18

data/README.md

@@ -32,7 +32,7 @@ gem install squared
 There is an additional program wrapper for ``rake`` to be used when running batch commands and to enable global settings more easily.
 
 ```xml
-Usage: sqd [options] [rake options] [global...] [:targets...] -- [rake targets...]
+Usage: sqd [options] [rake options] [pathspec...] -- [global...] [:targets...] -- [rake targets...]
 
     -R, --ref STR,STR                Run global commands by class reference
     -G, --group STR,STR              Run global commands by project group
@@ -43,18 +43,25 @@ Usage: sqd [options] [rake options] [global...] [:targets...] -- [rake targets..
 
     -s, --[no-]strict                Do not run commands with invalid arguments
         --update                     Use update strategy for applicable commands
-        --parallel STR,PAT           Run standard tasks with multi-task threads
+    -u, --parallel STR,PAT           Run standard tasks with multi-task threads
+    -U, --sync STR,PAT               Run parallel tasks in a series sequentially
     -F, --force [STR,STR]            Enable force through ENV by application
     -y, --yes [STR,STR]              Enable auto-approve through ENV by application
     -d, --dry-run                    Run commands without any modifying actions
 
-    -S, --select PAGE[:CHOICE]       Prompt menu selection pagination display (e.g. 15:75)
+    -S, --select PAGE[:CHOICE]       Prompt menu selection pagination display (e.g. 20:60)
+    -M, --multiline STR              Use advanced editor with custom message terminator (e.g. EOF)
 
+    -g, --[no-]gemfile               Execute commands using bundle exec and nearest Gemfile
     -p, --pipe 0|1|2                 Set file descriptor for communication
     -o, --pipe-out FILE              Write command data stream to a file
         --fail 0..4                  Set application exception level
         --log-level SEVERITY         Set logger and exception state (debug, info, warn, error, fatal)
 
+    -c, --commit                     Push files remotely on active branch from current directory
+        --amend                      Replace the tip of the active branch remotely with a force push
+        --amend-orig                 Perform an amend commit without changing the message
+
         --[no-]banner                Display executing command attributes
     -x, --[no-]color                 Use enhanced styling for terminal output
     -X, --plain                      Disable banner and styling for all commands
@@ -102,11 +109,11 @@ Workspace::Application
   .clean("rake clean", group: "default")
   .clean(["build/"], group: "app")
   .log({ file: "tmp/%Y-%m-%d.log", level: "debug" }, group: "app")
-  .add("pathname", run: "rake compile", copy: "rake install", test: "rake test", group: "default", env: { # Ruby (with C extensions)
+  .add("pathname", run: "rake compile", copy: "rake install", test: "rake test", exec: true, group: "default", env: { # Ruby (with C extensions)
     "CFLAGS" => "-fPIC -O1"
   })
-  .add("optparse", doc: "rake rdoc", gemspec: "optparse.gemspec", group: "default") # Uses bundler/gem_tasks (without C extensions)
-  .add("logger", copy: { from: "lib", glob: "**/*.rb", into: "/home/user/.local/gem/ruby/4.0.0/gems/logger-1.7.0" }, clean: ["tmp/"]) do # autodetect: true | "rvm" | "rbenv" | "asdf" | "mise" | bundler"
+  .add("optparse", doc: "rake rdoc", gemspec: "optparse.gemspec", exec: { rake: true, ruby: '../Gemfile', rbs: false }, group: "default") # Uses bundler/gem_tasks (without C extensions)
+  .add("logger", copy: { from: "lib", glob: "**/*.rb", into: "/home/user/.local/gem/ruby/4.0.0/gems/logger-1.7.0" }, clean: ["tmp/"]) do  # autodetect: true | "rvm" | "rbenv" | "asdf" | "mise" | bundler"
     self.gemdir = "/home/user/.local/gem/ruby/4.0.0/gems/logger-1.7.0" # Default for "into"
   end
   .add("e-mc", "emc", copy: { from: "publish", scope: "@e-mc", also: [:pir, "squared-express/"] }, ref: :node)

data/exe/sqd

@@ -6,36 +6,41 @@ require 'rake'
 require 'optparse'
 
 class SqdParser < OptionParser
-  include Squared::Common::Format
+  include Squared
+  include Common::Format
   include Utils
 
+  OPT_DASH = /^--?[^-]/.freeze
+
   attr_reader :options, :global
+  attr_accessor :argv
 
   def initialize(*)
-    super
     @options = { 'project-args': [], 'project-env': [] }
     @global = []
+    @argv = ARGV.dup
+    super
     @program_name = 'squared'
     @raise_unknown = false
     @require_exact = true
   end
 
   def parse_global(list, assert:)
-    raise ArgumentError, "cannot be used with --#{assert}" if options.key?(assert)
-
-    ARGV.each_with_index do |val, index|
+    error_exit "cannot be used with --#{assert}" if options.key?(assert)
+    each_with_index do |val, index|
       if val == '--'
         separator!(index: index)
         break
       end
-      next if val.start_with?('-') || val.include?(':') || val.empty?
+      found = list.map { |name| "#{val}:#{name}" }.select { |name| tasks.include?(name) }
+      next if found.empty?
 
-      global.concat(list.map { |name| "#{val}:#{name}" })
+      global.concat(found)
       ARGV[index] = ''
     end
   end
 
-  def parse_common(list, session:, arg:)
+  def parse_common(list, arg:)
     if list && !list.include?('*')
       session[arg].merge!(list.to_h { |key| [key, 'true'] })
     else
@@ -43,18 +48,159 @@ class SqdParser < OptionParser
     end
   end
 
-  def banner_set(val, session:)
+  def parse_series(list, flag:)
+    pattern, parallel = list.partition do |val|
+      next false if val.match?(%r{^[\w~`!@#%&\-=:;"'<>/]+$})
+
+      Regexp.new(val)
+    rescue RegexpError
+      false
+    end
+    s = flag == :sync ? '!' : ''
+    (session[:APP][:"build_pattern#{s}"] ||= []).concat(pattern.map { |pat| Regexp.new(pat) }) unless pattern.empty?
+    (session[:APP][:"build_parallel#{s}"] ||= []).concat(parallel) unless parallel.empty?
+  end
+
+  def parse_range(val, max:, arg:, min: 0)
+    error_exit('out of range', hint: val) unless val.between?(min, max)
+    session[arg] = val
+  end
+
+  def parse_rakefile
+    OptionParser.new do |opts|
+      opts.raise_unknown = false
+      opts.on('--rakefile', '-f [FILENAME]', '') do |val|
+        return val || ''
+      end
+    end.parse(ARGV.dup)
+    nil
+  end
+
+  def option_select(val)
+    page, choice = val.split(/\D/, 2).map(&:to_i)
+    error_exit('not an integer', hint: val) if choice.nil? ? page == 0 : choice == 0
+    session[:PAGE] = page if page > 0
+    session[:CHOICE] = choice if choice.to_i > 0
+    ENV['SELECT'] = "#{page}:#{choice}"
+  end
+
+  def option_multiline(val)
+    Common::Prompt.multiline = val
+  rescue NotImplementedError => e
+    warn log_warn(e, hint: argv.find { |val| multilineopts.include?(val) })
+  end
+
+  def option_gemfile(val)
+    require 'pathname'
+    session[:APP][:ruby_gemfile] = val
+    return unless val
+    return if ENV['RUBYOPT']&.match?(/(^|\b)-r.+#{File::SEPARATOR}bundler#{File::SEPARATOR}setup\b/)
+
+    gemfile = Pathname.pwd.ascend { |path| break path if path.join('Gemfile').file? } || ENV['BUNDLE_GEMFILE']
+    return unless gemfile && (argv.delete('--gemfile') || argv.delete('-g'))
+
+    argv.unshift('sqd')
+    if gemfile.is_a?(String)
+      gemfile = Common::Shell.shell_escape(Pathname.new(gemfile).relative_path_from(Dir.pwd), quote: true)
+      argv.unshift("--gemfile=#{gemfile}")
+      gemfile = Dir.pwd
+    end
+    ENV['BUNDLE_GEMFILE'] = nil
+    exec(Common::Shell.shell_bin('bundle'), 'exec', *argv, chdir: gemfile)
+  end
+
+  def option_loglevel(val)
+    require 'logger'
+    severity = case val
+               when :debug then Logger::DEBUG
+               when :info then Logger::INFO
+               when :warn then Logger::WARN
+               when :error then Logger::ERROR
+               when :fatal then Logger::FATAL
+               else
+                 val.to_i
+               end
+    session[:LEVEL] = severity
+    ENV['LOG_LEVEL'] = severity.to_s
+  end
+
+  def option_commit(*opts, flag:)
+    require 'squared/workspace'
+    c = argv.index { |val| opts.include?(val) } || error_exit('option was not found', hint: opts.last)
+    check_exclusive('-c', '--commit', '--amend', '--amend-orig', flag: argv[c])
+    first = lambda do
+      if ARGV.empty?
+        m = argv.index { |val| multilineopts.include?(val) }
+        t = argv.index { |val| !val.match?(OPT_DASH) } || -1
+        return true if c == 0 || (m == 0 && c == 2) || t > c
+      end
+      !rakefile?
+    end
+    refs = []
+    found = argv[c.succ]
+    j = -1
+    each_with_index do |pat, i|
+      found = nil if pat == found
+      if i == j
+        ARGV[i.pred] = ''
+        ARGV[i] = ''
+        option_multiline pat
+        next
+      end
+      next if found
+
+      case pat
+      when '--'
+        ARGV[i] = ''
+        break
+      when *multilineopts
+        j = i.succ
+        next
+      when OPT_DASH
+        next if refs.empty? || Dir[pat].empty?
+      else
+        next if refs.empty? && Dir[pat].empty?
+      end
+      refs << pat
+      ARGV[i] = ''
+    end
+    if refs.empty?
+      if !`git status -s --ignore-submodules=all --ignored=no`.empty?
+        refs << '*'
+      elsif first.call
+        warn 'No files to commit.'
+        exit 1
+      else
+        return
+      end
+    end
+    Workspace::Application
+      .new
+      .add(File.basename(Dir.pwd), ref: :git) { commit(flag, refs: refs.uniq, pass: nil) }
+    exit if first.call
+    self.argv = ARGV.dup
+  end
+
+  def option_verbose
+    unless session[:VERBOSE]
+      session[:VERBOSE] = $VERBOSE ? 1 : 0
+      global.unshift('--verbose')
+    end
+    ENV['VERBOSE'] = (session[:VERBOSE] += 1).to_s
+  end
+
+  def banner_set(val)
     session[:BANNER] = val
     ENV['BANNER'] = val ? 'true' : 'false'
   end
 
-  def color_set(val, session:)
+  def color_set(val)
     if (session[:COLOR] = val)
       enable_aixterm
       enable_drawing
     else
       enable_drawing false
-      Squared::Common.const_get(:VAR)[:colors].freeze
+      Common.const_get(:VAR)[:colors].freeze
     end
     ENV['NO_COLOR'] = val ? nil : '1'
     ENV['FORCE_COLOR'] = val ? '2' : '0'
@@ -71,68 +217,111 @@ class SqdParser < OptionParser
       rescue RegexpError
         false
       end
+      subtasks = []
       pattern.each do |val|
         val = if val == '*'
                 '[^:]+'
               else
                 val.sub(/^\*/, '.*')
                    .sub(/(?<!\.)\*$/, '.*')
-                   .gsub(/\.([*+])/, '[^:]\1?')
+                   .gsub(/(?<!\\)\.([*+])(?!\?)/, '[^:]\1?')
               end
-        IO.popen("rake -T \"^#{val}:\"").each { |line| project << $1 if line =~ /\Arake (#{val}):/o }
+        pat = /^(#{val.chomp(':')}):/
+        tasks.each do |task|
+          next unless task =~ pat
+
+          subtasks << $1
+          name = task.split(':', 2).first
+          project << name unless project.include?(name)
+        end
       end
       exit 1 if project.empty? && !pattern.empty?
-      project.uniq!
+      subtasks.uniq!
       options[:'project-env'].each do |val|
         n = val.index('=')
-        key = val[...n]
-        val = val[n.succ..].stripquote
+        key = val[0...n]
+        val = val[n.succ..-1].stripquote
         project.each { |name| ENV["#{key}_#{env_key(name.split(':').first)}"] = val }
       end
-      ARGV.each_with_index do |val, index|
+      each_with_index do |val, index|
         if val == '--'
           separator!(index: index)
           break
         end
         next unless val.start_with?(':')
 
-        args = options[:'project-args'].shift
-        global.concat(project.map { |name| "#{name}#{val}#{"[#{args}]" if args}" })
+        found = subtasks.map { |name| "#{name}#{val}" }.select { |name| tasks.include?(name) }
+        if (args = options[:'project-args'].shift)
+          found.map! { |name| "#{name}[#{args}]" }
+        end
+        global.concat(found)
         ARGV[index] = ''
       end
     end
-    if options[:parallel]
-      pattern, parallel = options[:parallel].partition do |val|
-        next false if val.match?(%r{^[\w~`!@#%&\-=:;"'<>/]+$})
+    Rake.application.run(global.concat(ARGV))
+  end
 
-        Regexp.new(val)
-      rescue RegexpError
-        false
+  def tasks
+    @tasks ||= Rake.with_application do |rake|
+      if (rakefile = parse_rakefile)
+        rakefiles = rake.instance_variable_get(:@rakefiles)
+        rakefiles.clear
+        rakefiles << rakefile
       end
-      session = Squared::Common::ARG
-      session[:APP][:build_pattern] = pattern.map { |pat| Regexp.new(pat) } unless pattern.empty?
-      session[:APP][:build_parallel] = parallel unless parallel.empty?
-    end
-    ARGV.reject!(&:empty?)
-    Rake.application.run(global.concat(ARGV))
+      rake.raw_load_rakefile
+    end.tasks.map(&:name)
   end
 
   def separator!(index:)
     ARGV[index] = '' if ARGV.grep('--').size > 1
   end
 
-  def error_exit(*val, hint)
+  def check_exclusive(*args, flag:)
+    args.delete(flag)
+    return unless (n = index(*args))
+
+    error_exit "cannot be used with #{argv[n]}"
+  end
+
+  def error_exit(*val, hint: nil)
     raise OptionParser::InvalidArgument, message(*val, hint: hint), caller(1)
   end
+
+  def session
+    Common::ARG
+  end
+
+  def multilineopts
+    %w[-M --multiline]
+  end
+
+  def each_with_index(&blk)
+    ARGV.each_with_index(&blk)
+    ARGV.reject!(&:empty?)
+  end
+
+  def index(*args)
+    argv.each_with_index do |val, i|
+      return i if args.any? { |s| val == s || (s.start_with?('--') && val.start_with?("#{s}=")) }
+    end
+    nil
+  end
+
+  def warn(*args)
+    $stderr.puts(*args)
+  end
+
+  def rakefile?
+    Rake.application.find_rakefile_location || parse_rakefile ? true : false
+  end
 end
 
 SqdParser.new do |sqd|
-  session = Squared::Common::ARG
-  sqd.banner = 'Usage: sqd [options] [rake options] [global...] [:targets...] -- [rake targets...]'
+  sqd.banner = 'Usage: sqd [options] [rake options] [pathspec...] -- [global...] [:targets...] -- [rake targets...]'
   sqd.separator ''
   sqd.on('-R', '--ref STR,STR', Array, 'Run global commands by class reference') do |val|
     sqd.parse_global(val, assert: :group)
-    session[:APP][:series_ref_min] = 1
+    sqd.session[:APP][:series_ref_min] = 1
   end
   sqd.on('-G', '--group STR,STR', Array, 'Run global commands by project group') do |val|
     sqd.parse_global(val, assert: :ref)
@@ -143,82 +332,84 @@ SqdParser.new do |sqd|
     sqd.options[:'project-args'] << val
   end
   sqd.on('-e', '--project-env KEY=STR', 'Provide command ENV variables for :targets (multiple)') do |val|
-    sqd.error_exit('missing value', "#{val}=") unless val.include?('=')
+    sqd.error_exit('missing value', hint: "#{val}=") unless val.include?('=')
     sqd.options[:'project-env'] << val
   end
   sqd.separator ''
   sqd.on('-s', '--[no-]strict', 'Do not run commands with invalid arguments') do |val|
-    session[:STRICT] = val
+    sqd.session[:STRICT] = val
     ENV['STRICT'] = val ? 'true' : 'false'
   end
   sqd.on('--update', 'Use update strategy for applicable commands') do
     ENV['UPDATE'] = 'true'
   end
-  sqd.on('--parallel STR,PAT', Array, 'Run standard tasks with multi-task threads')
+  sqd.on('-u', '--parallel STR,PAT', Array, 'Run standard tasks with multi-task threads') do |val|
+    sqd.parse_series(val, flag: :parallel)
+  end
+  sqd.on('-U', '--sync STR,PAT', Array, 'Run parallel tasks in a series sequentially') do |val|
+    sqd.parse_series(val, flag: :sync)
+  end
   sqd.on('-F', '--force [STR,STR]', Array, 'Enable force through ENV by application') do |val|
-    sqd.parse_common(val, session: session, arg: :FORCE)
+    sqd.parse_common(val, arg: :FORCE)
   end
   sqd.on('-y', '--yes [STR,STR]', Array, 'Enable auto-approve through ENV by application') do |val|
-    sqd.parse_common(val, session: session, arg: :YES)
+    sqd.parse_common(val, arg: :YES)
   end
   sqd.on('-d', '--dry-run', 'Run commands without any modifying actions') do
     ENV['DRY_RUN'] = 'true'
   end
   sqd.separator ''
-  sqd.on('-S', '--select PAGE[:CHOICE]', 'Prompt menu selection pagination display (e.g. 15:75)') do |val|
-    page, choice = val.split(/\D/, 2).map(&:to_i)
-    sqd.error_exit('not an integer', val) if choice.nil? ? page == 0 : choice == 0
-    session[:PAGE] = page if page > 0
-    session[:CHOICE] = choice if choice.to_i > 0
-    ENV['SELECT'] = "#{page}:#{choice}"
+  sqd.on('-S', '--select PAGE[:CHOICE]', 'Prompt menu selection pagination display (e.g. 20:60)') do |val|
+    sqd.option_select(val)
+  end
+  sqd.on('-M', '--multiline STR', 'Use advanced editor with custom message terminator (e.g. EOF)') do |val|
+    sqd.option_multiline(val)
   end
   sqd.separator ''
+  sqd.on('-g', '--[no-]gemfile', 'Execute commands using bundle exec and nearest Gemfile') do |val|
+    sqd.option_gemfile(val)
+  end
   sqd.on('-p', '--pipe 0|1|2', Integer, 'Set file descriptor for communication') do |val|
-    sqd.error_exit('out of range', val) unless val.between?(0, 2)
-    session[:PIPE] = val
+    sqd.parse_range(val, max: 2, arg: :PIPE)
   end
   sqd.on('-o', '--pipe-out FILE', 'Write command data stream to a file') do |val|
-    sqd.error_exit("missing an explicit \".#{File::SEPARATOR}\"", val) unless val.include?(File::SEPARATOR)
-    session[:OUT] = val
+    sqd.error_exit("missing an explicit \".#{File::SEPARATOR}\"", hint: val) unless val.include?(File::SEPARATOR)
+    sqd.session[:OUT] = val
   end
   sqd.on('--fail 0..4', Integer, 'Set application exception level') do |val|
-    sqd.error_exit('out of range', val) unless val.between?(0, 4)
-    session[:FAIL] = val
+    sqd.parse_range(val, max: 4, arg: :FAIL)
   end
   %i[debug info warn error fatal].then do |state|
     values = state + (0..4).map(&:to_s)
     sqd.on('--log-level SEVERITY', values, "Set logger and exception state (#{state.join(', ')})") do |val|
-      require 'logger'
-      severity = case val
-                 when :debug then Logger::DEBUG
-                 when :info then Logger::INFO
-                 when :warn then Logger::WARN
-                 when :error then Logger::ERROR
-                 when :fatal then Logger::FATAL
-                 else
-                   val.to_i
-                 end
-      session[:LEVEL] = severity
-      ENV['LOG_LEVEL'] = severity.to_s
+      sqd.option_loglevel(val)
+    end
+  end
+  if Pathname.pwd.join('.git').directory?
+    sqd.separator ''
+    sqd.on('-c', '--commit', 'Push files remotely on active branch from current directory') do
+      sqd.option_commit('-c', '--commit', flag: :pathspec)
+    end
+    sqd.on('--amend', 'Replace the tip of the active branch remotely with a force push') do
+      sqd.option_commit('--amend', flag: :amend)
+    end
+    sqd.on('--amend-orig', 'Perform an amend commit without changing the message') do
+      sqd.option_commit('--amend-orig', flag: :'amend-orig')
     end
   end
   sqd.separator ''
   sqd.on('--[no-]banner', 'Display executing command attributes') do |val|
-    sqd.banner_set(val, session: session)
+    sqd.banner_set(val)
   end
   sqd.on('-x', '--[no-]color', 'Use enhanced styling for terminal output') do |val|
-    sqd.color_set(val, session: session)
+    sqd.color_set(val)
   end
   sqd.on('-X', '--plain', 'Disable banner and styling for all commands') do
-    sqd.banner_set(false, session: session)
-    sqd.color_set(false, session: session)
+    sqd.banner_set(false)
+    sqd.color_set(false)
   end
   sqd.on('-v', '--verbose', 'Increase output verbosity (multiple)') do
-    unless session[:VERBOSE]
-      session[:VERBOSE] = $VERBOSE ? 1 : 0
-      sqd.global.unshift('--verbose')
-    end
-    ENV['VERBOSE'] = (session[:VERBOSE] += 1).to_s
+    sqd.option_verbose
   end
   sqd.on('--version', 'Print the current version') do
     puts Squared::VERSION

data/lib/squared/common/base.rb

@@ -17,6 +17,7 @@ module Squared
       BANNER: true,
       PAGE: 20,
       CHOICE: 100,
+      TAB: 4,
       QUOTE: "'",
       SPACE: ' => ',
       SUCCESS: 'Success',
@@ -105,6 +106,7 @@ module Squared
 
     def __freeze__
       PATH.freeze
+      ARG.each_value { |val| val.freeze if val.is_a?(::Hash) || val.is_a?(::Array) }
       ARG.freeze
       VAR.each_value(&:freeze)
       VAR[:theme].each_value { |val| val.freeze.each_value(&:freeze) }