refactor: move executable logic into gem binaries

Author: zah

.gitignore

@@ -13,5 +13,3 @@ pkg/
 # Offline dependency sources
 .codex/deps_src/
 .codex/internet_resources/
-
-agents-workflow/

README.md

@@ -36,7 +36,7 @@ recorder.flush_trace(Dir.pwd)
 you can currently use it directly with
 
 ```bash
-ruby gems/codetracer-pure-ruby-recorder/lib/trace.rb [--out-dir DIR] <path to ruby file>
+ruby gems/codetracer-pure-ruby-recorder/bin/codetracer-pure-ruby-recorder [--out-dir DIR] <path to ruby file>
 # produces several trace json files in DIR,
 # or in `$CODETRACER_RUBY_RECORDER_OUT_DIR` if DIR is not provided.
 # Defaults to the current directory.
@@ -47,7 +47,7 @@ You can also invoke a lightweight CLI that loads the native tracer extension
 directly:
 
 ```bash
-ruby gems/codetracer-ruby-recorder/lib/native_trace.rb [--out-dir DIR] <path to ruby file>
+ruby gems/codetracer-ruby-recorder/bin/codetracer-ruby-recorder [--out-dir DIR] <path to ruby file>
 # Uses DIR or `$CODETRACER_RUBY_RECORDER_OUT_DIR` to choose where traces are saved.
 ```
 

examples/selective_tracing.rb

@@ -2,12 +2,12 @@
 
 # Load the native extension only if RubyRecorder is not already available
 # (e.g., when running directly without the codetracer wrapper)
-unless defined?(RubyRecorder)
+unless defined?(CodeTracerNativeRecorder)
   ext_base = File.expand_path('../gems/codetracer-ruby-recorder/ext/native_tracer/target/release/libcodetracer_ruby_recorder', __dir__)
   require ext_base
 end
 
-recorder = RubyRecorder.new
+recorder = CodeTracerNativeRecorder.new
 
 puts 'start trace'
 recorder.disable_tracing

examples/selective_tracing_pure.rb

@@ -1,12 +1,12 @@
 #!/usr/bin/env ruby
 
 # Load the pure Ruby tracer library if RubyRecorder is not already defined
-unless defined?(RubyRecorder)
+unless defined?(CodeTracerNativeRecorder)
   lib_base = File.expand_path('../gems/codetracer-pure-ruby-recorder/lib/codetracer_pure_ruby_recorder', __dir__)
   require lib_base
 end
 
-recorder = RubyRecorder.new
+recorder = CodeTracerNativeRecorder.new
 
 puts 'start trace'
 recorder.disable_tracing

gems/codetracer-pure-ruby-recorder/bin/codetracer-pure-ruby-recorder

@@ -1,4 +1,9 @@
 #!/usr/bin/env ruby
-require 'rbconfig'
-script = File.expand_path('../lib/trace.rb', __dir__)
-exec RbConfig.ruby, script, *ARGV
+# SPDX-License-Identifier: MIT
+# CLI for the pure Ruby tracer
+
+lib_dir = File.expand_path('../lib', __dir__)
+$LOAD_PATH.unshift(lib_dir) unless $LOAD_PATH.include?(lib_dir)
+require 'trace'
+
+exit Codetracer::PureRubyRecorder.parse_argv_and_trace_ruby_file(ARGV)