fix: CLI・Runner境界とテスト基盤を包括修正

.github/workflows/test.yml

@@ -0,0 +1,55 @@
+name: Test
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Ruby ${{ matrix.ruby }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby:
+          - "3.0"
+          - "3.2"
+          - "3.4"
+          - "4.0"
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+      - name: Install Ruby 3.0 test compatibility
+        if: matrix.ruby == '3.0'
+        run: gem install minitest --version 5.26.1 --no-document
+      - name: Install Ruby 4 test compatibility
+        if: matrix.ruby == '4.0'
+        run: gem install minitest-mock --version 5.27.0 --no-document
+      - name: Run tests
+        run: ruby -Ilib:test -e 'Dir["test/*_test.rb"].sort.each { |file| require File.expand_path(file) }'
+
+  coverage:
+    name: Coverage
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+        with:
+          fetch-depth: 0
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1
+        with:
+          ruby-version: "3.4"
+      - name: Enforce coverage thresholds
+        run: ruby -Ilib:test test/coverage_runner.rb
+        env:
+          COVERAGE_BASE_REF: ${{ github.event_name == 'push' && github.event.created == false && github.event.deleted == false && github.event.before || format('origin/{0}', github.base_ref || github.event.repository.default_branch) }}

CHANGELOG.md

@@ -1,6 +1,38 @@
 # Changelog
 
-# Changelog
+## [Unreleased]
+
+### Fixed
+- Parameterless commands now reject unexpected arguments without invoking the target method or attempting implicit return-value traversal.
+- Required options now report a missing value instead of consuming the following option token, while explicit values such as `true` remain valid.
+- Required options accept negative exponent, digit-separated decimal, and radix notation such as `-1e3`, `-1_000`, and `-0x10` without mistaking them for another option.
+- Required options in eval mode accept space-separated lambda and unary expressions without consuming known option tokens as values.
+- Constant discovery now includes classes and modules assigned with `Class.new` / `Module.new` during the target file load.
+- Repeated loads retain assigned constant aliases when the source file is unchanged.
+- Repeated loads retain aliases from completed direct, multiple, and `const_set` assignments or matching fully qualified existence guards, including loop initializers and receivers found by Ruby's lexical constant fallback, without reviving failed assignments or aliases behind disabled conditions.
+- Constant discovery analyzes the preloaded source without triggering autoloads, so inactive autoload branches and self-removing target files do not add side effects or fail after a successful load.
+- Constructor arity errors raised by `--new` are now wrapped in Rubycli's user-facing runner error.
+- Framework argument errors raised by constructors are also wrapped in the same user-facing runner error.
+- Positional type conversion now waits for JSON/eval coercion, matching keyword-option behavior and preserving `--new` JSON/eval inputs.
+- Runner tests now execute without terminating the Minitest process and assert converted command arguments instead of stubbed targets.
+- `--check --new` now inspects exposed instance/class commands without running constructors, while `--check` rejects pre-scripts instead of evaluating them.
+- `--check` now inspects explicitly selected commands even when their methods or defining procs come from required files.
+- Explicit nested constant names no longer fall back to inherited top-level constants, and malformed pre-scripts now produce contextual Rubycli errors.
+- Rest, optional-before-required, and trailing-required positional arguments now follow Ruby's argument binding rules for conversion, validation, and help output.
+- Documented scalar/list conversions now preserve numeric-, boolean-, and null-looking strings, handle repeated booleans, return real `DateTime` values, accept JSON arrays, and reject scalar/array values where `JSON`/`Hash` shapes do not allow them.
+- Positional `Symbol` annotations preserve colon-prefixed symbol literals instead of embedding the colon in the symbol name.
+- Assignment-like positional values remain positional unless they match a keyword, while matching assignments use the same documented conversion as long options.
+- YARD positional tags are aligned by parameter name instead of comment order.
+- Eval-mode local variables and command-line strict/check/result-output flags no longer leak across separate programmatic runs.
+- Constructor and command eval arguments share one binding per Runner execution without enabling eval mode while the target file loads.
+- Required options accept a lone `-` value, bare rest placeholders render with an ellipsis, and quoted positional/option `String[]` elements remain strings.
+- Invalid Ruby syntax passed through strict eval mode now produces a user-facing Rubycli argument error instead of leaking a `SyntaxError` backtrace.
+- Circular arrays/hashes returned by commands now fall back to inspected output instead of raising a JSON nesting error.
+
+### Testing
+- Added dependency-free overall line, branch, and changed-line coverage gates plus GitHub Actions checks spanning the supported Ruby range.
+- Changed-line coverage now treats new library files that were never loaded by the test suite as uncovered, including non-ASCII paths quoted by Git.
+- Push coverage compares against the previous commit and falls back to the default branch when a new ref has no previous commit or a ref is deleted.
 
 ## [0.1.7] - 2025-11-12