Merge branch 'develop'

* develop:
  chore: prepare release 0.3.11
  fix: fix typo in Strategizable#strategize
  refactor: rename Strategyable to Strategizable
  docs: refine English in README.md
  build: rename build job to test
  chore: generate .rubocop_todo.yml to silence existing offenses
  style: apply rubocop -A (unsafe auto-correct)
  style: apply rubocop -a (safe auto-correct)
  chore: set TargetRubyVersion to 2.4 in .rubocop.yml
  build: add lint job to workflow
  build: add conditional rubocop dependency
  docs: add project guidelines

Author: jsmmr

.github/workflows/build.yml

@@ -1,7 +1,21 @@
 name: build
 on: [push]
 jobs:
-  build:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 4.0
+          bundler-cache: true
+      - name: Run bundle install
+        run: |
+          bundle config path vendor/bundle
+          bundle install --jobs 4 --retry 3
+      - run: bundle exec rubocop
+
+  test:
     runs-on: ubuntu-latest
     strategy:
       matrix:

.rubocop.yml

@@ -1,5 +1,8 @@
+inherit_from: .rubocop_todo.yml
+
 AllCops:
   NewCops: enable
+  TargetRubyVersion: 2.4
 Style/HashSyntax:
   EnforcedShorthandSyntax: never
 Naming/BlockForwarding:

.rubocop_todo.yml

@@ -0,0 +1,120 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2026-01-02 20:06:51 UTC using RuboCop version 1.82.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 2
+# Configuration parameters: AllowedMethods.
+# AllowedMethods: enums
+Lint/ConstantDefinitionInBlock:
+  Exclude:
+    - 'spec/callable_tree/node/external_spec.rb'
+    - 'spec/callable_tree/node/internal/strategizable_spec.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedParentClasses.
+Lint/MissingSuper:
+  Exclude:
+    - 'lib/callable_tree/node/root.rb'
+
+# Offense count: 10
+# Configuration parameters: AllowKeywordBlockArguments.
+Lint/UnderscorePrefixedVariableName:
+  Exclude:
+    - 'examples/builder/identity.rb'
+    - 'examples/builder/logging.rb'
+    - 'examples/class/logging.rb'
+
+# Offense count: 8
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
+# NotImplementedExceptions: NotImplementedError
+Lint/UnusedMethodArgument:
+  Exclude:
+    - 'lib/callable_tree/node/builder.rb'
+    - 'lib/callable_tree/node/external/builder.rb'
+    - 'spec/callable_tree/node/builder_spec.rb'
+
+# Offense count: 7
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
+Metrics/AbcSize:
+  Max: 25
+
+# Offense count: 38
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Max: 798
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/CyclomaticComplexity:
+  Max: 8
+
+# Offense count: 14
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 45
+
+# Offense count: 8
+# Configuration parameters: ExpectMatchingDefinition, CheckDefinitionPathHierarchy, CheckDefinitionPathHierarchyRoots, Regex, IgnoreExecutableScripts, AllowedAcronyms.
+# CheckDefinitionPathHierarchyRoots: lib, spec, test, src
+# AllowedAcronyms: CLI, DSL, ACL, API, ASCII, CPU, CSS, DNS, EOF, GUID, HTML, HTTP, HTTPS, ID, IP, JSON, LHS, QPS, RAM, RHS, RPC, SLA, SMTP, SQL, SSH, TCP, TLS, TTL, UDP, UI, UID, UUID, URI, URL, UTF8, VM, XML, XMPP, XSRF, XSS
+Naming/FileName:
+  Exclude:
+    - 'Rakefile.rb'
+    - 'examples/builder/external-verbosify.rb'
+    - 'examples/builder/internal-broadcastable.rb'
+    - 'examples/builder/internal-composable.rb'
+    - 'examples/builder/internal-seekable.rb'
+    - 'examples/class/external-verbosify.rb'
+    - 'examples/class/internal-broadcastable.rb'
+    - 'examples/class/internal-composable.rb'
+    - 'examples/class/internal-seekable.rb'
+
+# Offense count: 1
+# Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
+# AllowedMethods: call
+# WaywardPredicates: nonzero?
+Naming/PredicateMethod:
+  Exclude:
+    - 'spec/callable_tree/node/builder_spec.rb'
+
+# Offense count: 1
+Style/ClassVars:
+  Exclude:
+    - 'lib/callable_tree/node/internal/strategizable.rb'
+
+# Offense count: 40
+# Configuration parameters: AllowedConstants.
+Style/Documentation:
+  Enabled: false
+
+# Offense count: 45
+Style/MultilineBlockChain:
+  Exclude:
+    - 'examples/builder/external-verbosify.rb'
+    - 'examples/builder/hooks.rb'
+    - 'examples/builder/identity.rb'
+    - 'examples/builder/internal-seekable.rb'
+    - 'examples/builder/logging.rb'
+    - 'examples/class/hooks.rb'
+    - 'examples/class/logging.rb'
+    - 'lib/callable_tree/node/internal/strategy/seek.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods.
+# AllowedMethods: respond_to_missing?
+Style/OptionalBooleanParameter:
+  Exclude:
+    - 'lib/callable_tree/node/builder.rb'
+
+# Offense count: 5
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 210

AGENTS.md

@@ -0,0 +1,44 @@
+# Agent Guide for callable_tree
+
+## Project Overview
+`callable_tree` is a Ruby gem that builds a tree of callable nodes. It allows for complex logic flow (like nested `if`/`case`) to be represented as a tree of objects. Nodes are traversed based on matching conditions (`match?`), and executed (`call`).
+
+## Core Concepts
+- **Nodes**:
+  - `Root`: The entry point of the tree.
+  - `Internal`: Branch nodes that contain child nodes. Strategies:
+    - `seekable`: Calls the first matching child (like `case`).
+    - `broadcastable`: Calls all matching children.
+    - `composable`: Pipes output from one child to the next.
+  - `External`: Leaf nodes that perform actual work.
+- **Traversal**:
+  - `match?(input)`: Determines if a node should process the input.
+  - `call(input)`: Executes the node logic.
+  - `terminate?`: Controls when to stop traversal (mostly for `seekable`).
+
+## Directory Structure
+- `lib/`: Source code.
+- `spec/`: RSpec tests.
+- `examples/`: Usage examples (Class-style and Builder-style).
+
+## Development
+- **Tool Version Manager**: mise
+- **Language**: Ruby (>= 2.4.0)
+- **Dependency Management**: Bundler
+  - Execute `bundle` commands via `mise` (e.g., `mise x -- bundle exec ...`)
+- **Testing**: RSpec
+  - Run all tests: `mise x -- bundle exec rake` or `mise x -- bundle exec rake spec`
+- **Commit Messages**: Follow the convention in [CONTRIBUTING.md](CONTRIBUTING.md).
+- **Linter/Formatter**:
+  - Uses `rubocop`.
+  - Run checks: `mise x -- bundle exec rubocop`
+- **CI/CD**:
+  - GitHub Actions: `.github/workflows/build.yml` runs tests and linter on push/PR.
+- **Release Process**:
+  - Version: `lib/callable_tree/version.rb`
+  - Tagging: Create a git tag (e.g., `v0.4.0`) and push.
+
+## Architecture
+- **Composite Pattern**: Used for `Internal` nodes to treat individual objects and compositions uniformly.
+- **Builder Pattern**: `CallableTree::Node::Internal::Builder` and `CallableTree::Node::External::Builder` provide a fluent interface for constructing complex trees.
+

CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.3.11] - 2026-01-03
+
+- Fix a typo in `Strategizable#strategize` where it incorrectly called `strategy!` instead of `strategize!`.`
+
 ## [0.3.10] - 2022-12-30
 
 - Change `CallableTree::Node::Internal#broadcastable` to take `matchable` keyword parameter as boolean. It defaults to `true`, which is the same behavior as before.

CONTRIBUTING.md

@@ -0,0 +1,68 @@
+# Commit Message Convention
+
+We follow the [Conventional Commits](https://www.conventionalcommits.org/) specification.
+
+## Format
+
+```
+<type>(<scope>): <subject>
+
+<body>
+
+<footer>
+```
+
+## Header
+
+The header is mandatory and must not exceed 72 characters.
+
+### Type
+
+Must be one of the following:
+
+- **feat**: A new feature
+- **fix**: A bug fix
+- **docs**: Documentation only changes
+- **style**: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
+- **refactor**: A code change that neither fixes a bug nor adds a feature
+- **perf**: A code change that improves performance
+- **test**: Adding missing tests or correcting existing tests
+- **build**: Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)
+- **ci**: Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs)
+- **chore**: Other changes that don't modify src or test files
+- **revert**: Reverts a previous commit
+
+### Scope
+
+The scope is optional and should be a phrase describing the section of the codebase affected.
+
+### Subject
+
+The subject contains a succinct description of the change:
+
+- Use the imperative, present tense: "change" not "changed" nor "changes"
+- Don't capitalize the first letter
+- No dot (.) at the end
+
+## Body
+
+The body is optional and should include the motivation for the change and contrast this with previous behavior.
+
+## Footer
+
+The footer is optional and should contain any information about **Breaking Changes** and is also the place to reference GitHub issues that this commit closes.
+
+## Branch Naming
+
+We generally use the following prefixes for branch names:
+
+- `feature/`: New features (e.g., `feature/login-screen`)
+- `fix/`: Bug fixes (e.g., `fix/memory-leak`)
+- `docs/`: Documentation only changes (e.g., `docs/update-readme`)
+- `style/`: Changes that do not affect the meaning of the code (e.g., `style/rubocop-fixes`)
+- `refactor/`: Code changes that neither fix a bug nor add a feature (e.g., `refactor/extract-method`)
+- `test/`: Adding or correcting tests (e.g., `test/add-rspec-cases`)
+- `chore/`: Changes to the build process or auxiliary tools and libraries (e.g., `chore/update-gems`)
+
+Use kebab-case for the branch name (e.g., `feature/my-new-feature`).
+

Gemfile

@@ -8,3 +8,5 @@ gemspec
 gem 'rake', '~> 13.3'
 
 gem 'rspec', '~> 3.13'
+
+gem 'rubocop', require: false if Gem::Version.new(RUBY_VERSION) >= Gem::Version.new('4.0')

README.md

@@ -21,22 +21,22 @@ Or install it yourself as:
 
 ## Usage
 
-Builds a tree by linking `CallableTree` node instances. The `call` methods of the nodes where the `match?` method returns a truthy value are called in a chain from the root node to the leaf node.
+Builds a tree of `CallableTree` nodes. Invokes the `call` method on nodes where `match?` returns a truthy value, chaining execution from root to leaf.
 
 - `CallableTree::Node::Internal`
-  - This `module` is used to define a node that can have child nodes. This node has several strategies (`seekable`, `broadcastable`, `composable`).
+  - Defines a node that can have child nodes. Supports several strategies (`seekable`, `broadcastable`, `composable`).
 - `CallableTree::Node::External`
-  - This `module` is used to define a leaf node that cannot have child nodes.
+  - Defines a leaf node, which cannot have child nodes.
 - `CallableTree::Node::Root`
-  - This `class` includes `CallableTree::Node::Internal`. When there is no need to customize the internal node, use this `class`.
+  - Includes `CallableTree::Node::Internal`. Use this class when customization of the internal node is not required.
 
 ### Basic
 
 There are two ways to define the nodes: class style and builder style.
 
 #### `CallableTree::Node::Internal#seekable` (default strategy)
 
-This strategy does not call the next sibling node if the `call` method of the current node returns a value other than `nil`. This behavior is changeable by overriding the `terminate?` method.
+This strategy stops processing subsequent sibling nodes if the current node's `call` method returns a non-nil value. This behavior is changeable by overriding the `terminate?` method.
 
 ##### Class style
 
@@ -51,18 +51,15 @@ module Node
         File.extname(input) == '.json'
       end
 
-      # If there is need to convert the input values for
-      # child nodes, override the `call` method.
+      # Override `call` if you need to transform input values for child nodes.
       def call(input, **options)
         File.open(input) do |file|
           json = ::JSON.load(file)
           super(json, **options)
         end
       end
 
-      # If a returned value of the `call` method is `nil`,
-      # but there is no need to call the sibling nodes,
-      # override the `terminate?` method to return `true`.
+      # Override `terminate?` to return `true` to stop processing sibling nodes even if `call` returns `nil`.
       def terminate?(_output, *_inputs, **_options)
         true
       end
@@ -94,17 +91,14 @@ module Node
         File.extname(input) == '.xml'
       end
 
-      # If there is need to convert the input values for
-      # child nodes, override the `call` method.
+      # Override `call` if you need to transform input values for child nodes.
       def call(input, **options)
         File.open(input) do |file|
           super(REXML::Document.new(file), **options)
         end
       end
 
-      # If a returned value of the `call` method is `nil`,
-      # but there is no need to call the sibling nodes,
-      # override the `terminate?` method to return `true`.
+      # Override `terminate?` to return `true` to stop processing sibling nodes even if `call` returns `nil`.
       def terminate?(_output, *_inputs, **_options)
         true
       end
@@ -131,7 +125,7 @@ module Node
   end
 end
 
-# The `seekable` method call can be omitted since it is the default strategy.
+# The `seekable` call can be omitted as it is the default strategy.
 tree = CallableTree::Node::Root.new.seekable.append(
   Node::JSON::Parser.new.seekable.append(
     Node::JSON::Scraper.new(type: :animals),
@@ -265,7 +259,7 @@ Run `examples/builder/internal-seekable.rb`:
 
 #### `CallableTree::Node::Internal#broadcastable`
 
-This strategy broadcasts to output a result of the child nodes as array. It also ignores their `terminate?` methods by default.
+This strategy broadcasts input to all child nodes and returns their results as an array. It ignores child `terminate?` methods by default.
 
 ##### Class style
 
@@ -411,7 +405,7 @@ Run `examples/builder/internal-broadcastable.rb`:
 
 #### `CallableTree::Node::Internal#composable`
 
-This strategy composes the child nodes to input the output of the previous node into the next node and to output a result.
+This strategy chains child nodes, passing the output of the previous node as input to the next.
 It also ignores their `terminate?` methods by default.
 
 ##### Class style
@@ -560,7 +554,7 @@ Run `examples/builder/internal-composable.rb`:
 
 #### `CallableTree::Node::External#verbosify`
 
-If you want verbose output results, call this method.
+Use this method to enable verbose output.
 
 `examples/builder/external-verbosify.rb`:
 ```ruby
@@ -739,7 +733,7 @@ Run `examples/builder/logging.rb`:
 
 #### `CallableTree::Node#identity`
 
-If you want to customize the node identity, specify identifier.
+Specify an identifier to customize the node identity.
 
 `examples/builder/identity.rb`:
 ```ruby