Sample

Configure root directories with Zeitwerk and handle default top-level Object namespace and directory-filtering defaults in push_dir and dirs without name collisions or missing constant errors

sha256:3ebbd02c22c5e7760ba293cd6b0f6fa1467e5f31a76221f26d619502c4e54873

Case

Goal

Configure root directories with Zeitwerk and handle default top-level Object namespace and directory-filtering defaults in push_dir and dirs without name collisions or missing constant errors HOW

Packages

zeitwerk 2.8.3

Environment

ruby

Created

2026-08-17T02:49:39Z

Commonly assumed

push_dir without an explicit namespace parameter scopes autoloaded constants under a module matching the directory name.

The sample's author recorded this as what a developer or model would expect here. The contract below is what actually ran.

Contract

• assert push_dir with namespace left unset defaults the root namespace to Object rather than inferring a namespace from the directory name, mapping the directory to Object in all_expected_cpaths and expecting unprefixed top-level constants
• assert a file that defines its class nested inside a directory-named module raises Zeitwerk::NameError under default push_dir because Zeitwerk expects the unprefixed top-level constant name
• assert scoping files under a custom parent module requires explicitly passing namespace: Module to push_dir, which expects prefixed constant paths and autovivifies subdirectories under that module
• assert push_dir validates the namespace argument strictly, rejecting strings, symbols, and anonymous modules with Zeitwerk::Error
• assert loader.dirs with default arguments returns an Array of paths and silently filters out ignored root directories, while passing namespaces: true returns a Hash of dir to Module and ignored: true includes ignored roots
• assert loader.eager_load with default force: false skips files configured with do_not_eager_load leaving their autoloads pending, whereas force: true forces them to load while still ignoring paths in loader.ignore

Files

• Gemfile
• Gemfile.lock
• NOTES.md
• csx.json
• src/loader_defaults.rb
• src/trees/custom_namespace/gateways/stripe.rb
• src/trees/custom_namespace/invoice.rb
• src/trees/default_root/gateways/stripe.rb
• src/trees/default_root/invoice.rb
• src/trees/eager_exclusions/eager_excluded.rb
• src/trees/eager_exclusions/eager_ignored.rb
• src/trees/eager_exclusions/eager_normal.rb
• src/trees/ignored_root/dummy.rb
• src/trees/mismatch_namespace/invoice.rb
• test/contract.rb

Download the verified artifact (tar.gz) — the exact bytes the contract ran against

Origin Seeder

csx-seed

Verification receipts

• ruby 3 · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · rubygems@1 · 2026-08-17 · ed25519:d91480838ac982c9