ace-support-cli 0.6.3 → 0.6.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c45ddfd0f8690753b1f61d0bd7edd9b7a0b6f2061ee5bb1d8956a3e856578da
-  data.tar.gz: 110e674c92fa17291934c47baec9f8e1296f86263f3b6c4e14e07f0a6a8830a8
+  metadata.gz: dffb8ed525e3e2a4e8c779b1c320cb3d9445c10bd9f2c5587f681b743dc54e66
+  data.tar.gz: 284d72fb8c5de3ceaebde702ce3dd5dee21740174d7f4a19055b306cad08ac9c
 SHA512:
-  metadata.gz: 220feda7572bad571d6a6afd12762a9d97dd312554fb43a530fa7a1c0038847769d90422bddd27f570fdbf5bc20c882739670db5fbe3ee3ae6182ad24433e86a
-  data.tar.gz: 65f4679717750db4105ecde69012680d2125344f441b8188036827089c2561f73577cd2b59e431edece55abbcd807c21d073919541ee88027854c535df5fab12
+  metadata.gz: e11affb46f531af49fe99bc27394cac530ff53b4de1c42085c70ab0dcb7eb0284d3cca0c1c08a5efdd99b15f3084e0ce58efb593bd72222035ad1e86bcfa4a67
+  data.tar.gz: 101c391ba4b4088c530a6da9f467123cfa073a63d2ebeb6a693bdf5d0be99dc2b606c704b1c63ef7ac5ec1753922008928c14cbafb9f51b470f1f956e0e0370a

data/CHANGELOG.md

@@ -4,6 +4,32 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.6.7] - 2026-04-16
+
+### Fixed
+- Hid misleading rich-help `(default: false)` output for optional-value flags so shorthand CLI forms like bare `--capture` and `--wait` are documented accurately.
+
+## [0.6.6] - 2026-04-16
+
+### Fixed
+- Added optional-value string flag parsing so ACE CLIs can accept shorthand forms like bare `--capture` without breaking existing option and positional parsing behavior.
+
+## [0.6.5] - 2026-04-13
+
+### Changed
+- **ace-support-cli v0.6.5**: Standardized shared package tests to the fast-only layout and updated testing flow defaults.
+
+## [0.6.4] - 2026-04-11
+
+### Fixed
+- **ace-support-cli v0.6.4**: Corrected top-level `--help` usage output formatting so usage is rendered consistently as `Usage: <program> [COMMAND]`, and aligned help tests to validate this contract.
+
+### Changed
+- Migrated deterministic test layout to `test/fast/` for fast-only package coverage.
+- Documented fast-only testing contract in README and retained package verification commands:
+  - `ace-test ace-support-cli`
+  - `ace-test ace-support-cli all`
+
 ## [0.6.3] - 2026-03-29
 
 ### Technical

data/README.md

@@ -30,6 +30,18 @@
 
 **Keep agent invocations safe** - preserve a stable CLI contract so coding agents can call `ace-*` tools reliably in mixed human/agent workflows.
 
+## Testing
+
+This package is **fast-only** in the ACE testing model.
+
+- Deterministic test coverage lives under `test/fast/`.
+- This migration does not introduce `test/feat/` or `test/e2e/` for this package.
+
+Verification commands:
+
+- `ace-test ace-support-cli`
+- `ace-test ace-support-cli all`
+
 ---
 
 Part of [ACE](https://github.com/cs3b/ace)

data/lib/ace/support/cli/command.rb

@@ -22,7 +22,7 @@ module Ace
             @description = text
           end
 
-          def option(name, type: :string, default: nil, desc: "", aliases: [], values: nil, required: false, repeat: false, **_extra)
+          def option(name, type: :string, default: nil, desc: "", aliases: [], values: nil, required: false, repeat: false, optional_value: false, **_extra)
             @options ||= []
             @options << Models::Option.new(
               name: name,
@@ -32,7 +32,8 @@ module Ace
               aliases: aliases,
               values: values,
               required: required,
-              repeat: repeat
+              repeat: repeat,
+              optional_value: optional_value
             )
           end
 

data/lib/ace/support/cli/help/banner.rb

@@ -103,7 +103,7 @@ module Ace
             values = option_values(option)
             details << "(values: #{Array(values).join(", ")})" if values && !Array(values).empty?
             default = option_default(option)
-            details << "(default: #{default.inspect})" unless default.nil?
+            details << "(default: #{default.inspect})" unless suppress_default_display?(option, default)
             details << "(required)" if option_required?(option)
 
             return label if details.empty?
@@ -204,6 +204,19 @@ module Ace
             false
           end
 
+          def self.option_optional_value?(option)
+            return option.optional_value if option.respond_to?(:optional_value)
+
+            false
+          end
+
+          def self.suppress_default_display?(option, default)
+            return true if default.nil?
+            return true if option_optional_value?(option) && default == false
+
+            false
+          end
+
           def self.option_boolean?(option)
             return option.boolean? if option.respond_to?(:boolean?)
 

data/lib/ace/support/cli/help/usage.rb

@@ -13,13 +13,14 @@ module Ace
           end
 
           def render
+            usage = "Usage: #{resolved_program_name} [COMMAND]"
             commands = visible_commands
             groups = command_groups
-            output = if groups && !groups.empty?
+            output = [usage, if groups && !groups.empty?
               format_grouped(commands, groups)
             else
               format_flat(commands, header: "COMMANDS")
-            end
+            end].join("\n\n")
 
             examples = help_examples
             output += "\n\n#{format_examples(examples)}" if examples && !examples.empty?

data/lib/ace/support/cli/models/option.rb

@@ -7,9 +7,9 @@ module Ace
         class Option
           VALID_TYPES = %i[string integer float boolean array hash].freeze
 
-          attr_reader :name, :type, :default, :desc, :aliases, :values, :required, :repeat
+          attr_reader :name, :type, :default, :desc, :aliases, :values, :required, :repeat, :optional_value
 
-          def initialize(name:, type: :string, default: nil, desc: "", aliases: [], values: nil, required: false, repeat: false)
+          def initialize(name:, type: :string, default: nil, desc: "", aliases: [], values: nil, required: false, repeat: false, optional_value: false)
             @name = name.to_sym
             @type = type.to_sym
             @default = default
@@ -18,6 +18,7 @@ module Ace
             @values = values
             @required = required
             @repeat = repeat
+            @optional_value = optional_value
             validate!
           end
 

data/lib/ace/support/cli/parser.rb

@@ -115,7 +115,7 @@ module Ace
                 options[option.name] = current.merge(key => parsed_value)
               end
             else
-              switches = value_switches(option, "VALUE")
+              switches = option.optional_value ? optional_value_switches(option, "VALUE") : value_switches(option, "VALUE")
               parser.on(*switches, String, desc) { |value| assign_option_value(options, option, value) }
             end
           end
@@ -136,6 +136,12 @@ module Ace
           end
         end
 
+        def optional_value_switches(option, value_label)
+          (option.aliases + [option.long_switch]).map do |switch|
+            "#{switch} [#{value_label}]"
+          end
+        end
+
         def parse_hash_pair(value, option)
           parts = value.split(/[=:]/, 2)
           raise ArgumentError, "Invalid value for #{option.long_switch}: expected key=value" if parts.length < 2

data/lib/ace/support/cli/version.rb

@@ -3,7 +3,7 @@
 module Ace
   module Support
     module Cli
-      VERSION = "0.6.3"
+      VERSION = "0.6.7"
     end
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-support-cli
 version: !ruby/object:Gem::Version
-  version: 0.6.3
+  version: 0.6.7
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-03-29 00:00:00.000000000 Z
+date: 2026-04-26 00:00:00.000000000 Z
 dependencies: []
 description: Provides command DSL, option parsing, registry routing, and runner primitives
   for ACE CLI tools.