tasker-rb 0.1.7 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8c5ed3385bea52ede9378bb4cd2f35c4fb03e285a0b811698fa34042b2a0c8a
-  data.tar.gz: a9ce3c0d4d390ae8f0263ca60794c8a0997d99ca6272c52ccd7a8cea579de6ae
+  metadata.gz: c64517e396343d773d80bbf3c16e3112b267f9fe80c9106db6173a6f11b5c5c1
+  data.tar.gz: f80efaa7a98180794f55115d1bb566d8145de6a2bd3c87df06345d4e888f2f65
 SHA512:
-  metadata.gz: d7957c47e7f5403a0adc3cbfc917b49196e44e21438276f806809662b0bd3abaa2ff14408e69233dd06e1521fece83cc0f320d3601d152e8ee69730212f3ca58
-  data.tar.gz: e7844fe1ee414c7f3887db916b084c15ac44768885516792964bce9afff6cd807a8b847335428cb367fb7e0042730b8bc95a098e89cc7a24851ca0b96bc8b5db
+  metadata.gz: 4278e7281d156515822863927b49e5503d14f29aa29d817341bfa2466c7593fa430d1df90c740bb1cfae4dddf1135ada7618f3fd678fdb9d5ac3c03c80a40168
+  data.tar.gz: df8e4974bc9bdb55862aed084319e7082a21c0916217c250dc03ddbf33ed7705f73a3ae5d23ba09f7b77388c76b7445228c4e3731b9078a7cc059f3ab9b69a17

data/DEVELOPMENT.md

@@ -11,7 +11,7 @@ cd /path/to/tasker-core
 docker compose -f docker/docker-compose.test.yml up --build -d
 
 # 2. Run Ruby tests
-cd workers/ruby
+cd crates/tasker-rb
 bundle install
 bundle exec rspec --format documentation
 
@@ -27,7 +27,7 @@ cd /path/to/tasker-core
 docker compose -f docker/docker-compose.test.yml up postgres -d
 
 # 2. Setup Ruby environment
-cd workers/ruby
+cd crates/tasker-rb
 bundle install
 bundle exec rake compile
 
@@ -36,7 +36,7 @@ cd ../..
 cargo build --all-features
 
 # 4. Run tests locally
-cd workers/ruby
+cd crates/tasker-rb
 export DATABASE_URL="postgresql://tasker:tasker@localhost:5432/tasker_rust_test"
 bundle exec rspec --format documentation
 ```
@@ -53,7 +53,7 @@ export DATABASE_URL="postgresql://localhost/tasker_rust_test"
 cargo sqlx migrate run
 
 # 3. Setup Ruby
-cd workers/ruby
+cd crates/tasker-rb
 bundle install
 bundle exec rake compile
 
@@ -70,7 +70,7 @@ bundle exec rake compile
 
 ### Ruby Dependencies
 ```bash
-cd workers/ruby
+cd crates/tasker-rb
 bundle install
 
 # Key dependencies installed:
@@ -156,7 +156,7 @@ export MAGNUS_DEBUG="true"
 
 #### Unit Tests (Ruby)
 ```bash
-cd workers/ruby
+cd crates/tasker-rb
 
 # Run all unit tests
 bundle exec rspec spec/ffi/ spec/types/ spec/worker/ --format documentation
@@ -172,7 +172,7 @@ bundle exec rspec spec/ffi/ spec/types/ spec/worker/ --format documentation --re
 
 #### Integration Tests (Docker-based)
 ```bash
-cd workers/ruby
+cd crates/tasker-rb
 
 # Prerequisites: Start Docker services first
 docker compose -f ../../docker/docker-compose.test.yml up --build -d
@@ -261,7 +261,7 @@ cargo build --all-features --bin tasker-server
 
 ### 3. Start Ruby Worker Service
 ```bash
-cd workers/ruby
+cd crates/tasker-rb
 export DATABASE_URL="postgresql://localhost/tasker_rust_dev"
 export TASKER_TEMPLATE_PATH="$(pwd)/spec/fixtures/templates"
 export RUBY_HANDLER_PATH="$(pwd)/spec/handlers/examples"
@@ -357,7 +357,7 @@ ruby -v
 gem list ffi
 
 # Clean and rebuild
-cd workers/ruby
+cd crates/tasker-rb
 bundle exec rake clean
 bundle exec rake compile
 
@@ -443,7 +443,7 @@ bundle exec ruby benchmarks/workflow_performance_benchmark.rb
 ### Local CI Simulation
 ```bash
 # Run the same commands as CI
-cd workers/ruby
+cd crates/tasker-rb
 
 # Install dependencies (like CI)
 bundle install
@@ -518,7 +518,7 @@ export RUBY_HANDLER_PATH="$(pwd)/spec/handlers/examples"
 #### "Ruby worker FFI bootstrap failed"
 ```bash
 # Solution: Check Ruby extension compilation
-cd workers/ruby
+cd crates/tasker-rb
 bundle exec rake clean
 bundle exec rake compile
 

data/ext/tasker_core/Cargo.toml

@@ -1,9 +1,9 @@
 [package]
 name = "tasker-rb"
-version = "0.1.5"
+version = "0.1.7"
 edition = "2021"
 description = "Ruby bindings for tasker-core: High-performance workflow orchestration"
-readme = "../../../../README.md"
+readme = "../../../README.md"
 repository = "https://github.com/tasker-systems/tasker-core"
 license = "MIT"
 keywords = ["bindings", "ffi", "magnus", "ruby", "worker"]
@@ -34,7 +34,7 @@ anyhow = "1.0"
 # Async trait support for FrameworkIntegration
 async-trait = "0.1"
 # Time handling for Ruby Time ↔ Rust DateTime conversion
-chrono = { version = "0.4.43", features = ["serde"] }
+chrono = { version = "0.4.44", features = ["serde"] }
 # Environment variable loading
 dotenvy = "0.15"
 # Ruby FFI
@@ -49,7 +49,7 @@ once_cell = "1.19"
 serde = { version = "=1.0.228", features = ["derive", "std"] }
 # Serialization for Ruby ↔ Rust data conversion
 serde_json = "1.0"
-serde_magnus = "0.10"
+serde_magnus = "0.11"
 serde_yaml = "0.9"
 # Database (needed for PgPool)
 sqlx = { version = "0.8", features = [
@@ -66,21 +66,21 @@ sqlx = { version = "0.8", features = [
 # Both path (for workspace builds) and version (for standalone/published builds).
 # cargo publish strips the path field, leaving only the version for crates.io resolution.
 # Version pins are updated by scripts/release/update-versions.sh during release-prepare.
-tasker-shared = { path = "../../../../tasker-shared", version = "=0.1.5" }
-tasker-worker = { path = "../../../../tasker-worker", version = "=0.1.5" }
+tasker-shared = { path = "../../../tasker-shared", version = "=0.1.7" }
+tasker-worker = { path = "../../../tasker-worker", version = "=0.1.7" }
 # Error handling
 thiserror = "2.0"
 # Async runtime for blocking on futures in FFI
-tokio = { version = "1.49", features = ["rt-multi-thread"] }
+tokio = { version = "1.50", features = ["rt-multi-thread"] }
 # Logging
 tracing = "0.1"
 # UUID generation for event bridge
-uuid = { version = "1.11", features = ["serde", "v4", "v7"] }
+uuid = { version = "1.22", features = ["serde", "v4", "v7"] }
 # Project root detection
 workspace_tools = { version = "0.11.0", features = ["full"] }
 
 [dev-dependencies]
-tasker-core = { package = "tasker-core", path = "../../../../", version = "=0.1.5" }
+tasker-core = { package = "tasker-core", path = "../../../../", version = "=0.1.7" }
 
 [features]
 default = []

data/ext/tasker_core/src/bootstrap.rs

@@ -1,6 +1,6 @@
 //! # Ruby Worker Bootstrap
 //!
-//! TAS-67: Follows the same patterns as workers/rust/src/bootstrap.rs but adapted
+//! TAS-67: Follows the same patterns as crates/tasker-example-rs/src/bootstrap.rs but adapted
 //! for Ruby FFI integration with magnus. Uses FfiDispatchChannel for step event
 //! dispatch instead of the legacy RubyEventHandler.
 //!

data/lib/tasker_core/event_bridge.rb

@@ -194,21 +194,54 @@ module TaskerCore
 
       # Send completion event back to Rust
       # Called by StepExecutionSubscriber after handler execution
+      #
+      # serde_magnus requires string keys for deserialization into Rust structs.
+      # Ruby hashes built with symbol literals (e.g. { success: true }) must be
+      # deep-stringified before crossing the FFI boundary.
+      #
+      # If the FFI call still fails (e.g. unexpected nil, type mismatch), the
+      # fallback path constructs a guaranteed-safe failure result so the step is
+      # marked as permanently failed rather than silently lost.
       def publish_step_completion(completion_data)
         return unless active?
 
-        logger.debug "Sending step completion to Rust: #{completion_data[:event_id]}"
+        event_id_str = completion_data[:event_id].to_s
+        logger.debug "Sending step completion to Rust: #{event_id_str}"
 
         # Validate completion data
         validate_completion!(completion_data)
 
-        # Send to Rust via FFI (TAS-67: complete_step_event takes event_id and completion_data)
-        TaskerCore::FFI.complete_step_event(completion_data[:event_id].to_s, completion_data)
-
-        # Also publish locally for monitoring/debugging
-        publish('step.completion.sent', completion_data)
-
-        logger.debug 'Step completion sent to Rust'
+        # serde_magnus expects string keys — convert symbol keys at the FFI boundary
+        stringified = completion_data.deep_stringify_keys
+
+        begin
+          TaskerCore::FFI.complete_step_event(event_id_str, stringified)
+          # Only publish monitoring event after successful primary FFI
+          publish('step.completion.sent', completion_data)
+          logger.debug 'Step completion sent to Rust'
+        rescue StandardError => e
+          logger.error "FFI serialization failed for event #{event_id_str}: #{e.message}"
+          logger.error e.backtrace&.first(5)&.join("\n")
+
+          # Submit a minimal failure result that is guaranteed to deserialize
+          fallback = build_ffi_safe_failure(completion_data, e)
+          begin
+            TaskerCore::FFI.complete_step_event(event_id_str, fallback)
+            logger.warn "FFI fallback failure submitted for event #{event_id_str}"
+            begin
+              publish('step.completion.sent', fallback)
+            rescue StandardError => pub_err
+              logger.warn "Monitoring publish failed after fallback: #{pub_err.message}"
+            end
+          rescue StandardError => fallback_error
+            logger.error "FFI fallback also failed for event #{event_id_str}: " \
+                         "#{fallback_error.message} (original error: #{e.message})"
+            raise fallback_error
+          end
+        end
+      rescue ArgumentError
+        # Validation errors from validate_completion! should propagate
+        raise
       rescue StandardError => e
         logger.error "Failed to send step completion: #{e.message}"
         logger.error e.backtrace.join("\n")
@@ -246,10 +279,13 @@ module TaskerCore
         # Validate checkpoint data
         validate_checkpoint_yield!(checkpoint_data)
 
+        # serde_magnus expects string keys — convert symbol keys at the FFI boundary
+        stringified = checkpoint_data.deep_stringify_keys
+
         # Send to Rust via FFI (TAS-125)
         success = TaskerCore::FFI.checkpoint_yield_step_event(
           checkpoint_data[:event_id].to_s,
-          checkpoint_data
+          stringified
         )
 
         if success
@@ -311,6 +347,34 @@ module TaskerCore
         completion_data[:completed_at] ||= Time.now.utc.iso8601
       end
 
+      # Build a minimal StepExecutionResult-shaped hash that is guaranteed to
+      # deserialize through serde_magnus. Uses only string keys and primitive
+      # values so there is zero chance of a secondary serialization failure.
+      def build_ffi_safe_failure(original_data, error)
+        {
+          'step_uuid' => original_data[:step_uuid].to_s,
+          'task_uuid' => original_data[:task_uuid].to_s,
+          'success' => false,
+          'result' => {},
+          'status' => 'error',
+          'metadata' => {
+            'execution_time_ms' => 0,
+            'retryable' => false,
+            'completed_at' => Time.now.utc.iso8601,
+            'worker_id' => 'ruby_worker',
+            'custom' => {
+              'ffi_serialization_error' => error.message.to_s[0, 500],
+              'original_success' => original_data[:success].to_s
+            }
+          },
+          'error' => {
+            'message' => "FFI serialization failed: #{error.message}"[0, 500],
+            'error_type' => 'FFI_SERIALIZATION_ERROR',
+            'retryable' => false
+          }
+        }
+      end
+
       # TAS-125: Validate checkpoint yield data before sending to Rust
       def validate_checkpoint_yield!(checkpoint_data)
         required_fields = %i[event_id step_uuid cursor items_processed]

data/lib/tasker_core/version.rb

@@ -3,7 +3,7 @@
 module TaskerCore
   # Version synchronization with the core Rust crate
   # This should be kept in sync with the Cargo.toml version
-  VERSION = '0.1.7'
+  VERSION = '0.1.9'
 
   def self.version_info
     {

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tasker-rb
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.9
 platform: ruby
 authors:
 - Pete Taylor
@@ -201,7 +201,7 @@ description: |
   Ruby FFI bindings for tasker-core, providing 10-100x performance improvements
   for workflow orchestration, dependency resolution, and state management.
 
-  This gem enables Rails applications using the Tasker engine to leverage
+  This gem enables Ruby applications using the Tasker engine to leverage
   Rust's performance for computationally intensive orchestration operations
   while maintaining Ruby's flexibility for business logic.
 email:
@@ -216,7 +216,6 @@ files:
 - ext/tasker_core/Cargo.lock
 - ext/tasker_core/Cargo.toml
 - ext/tasker_core/extconf.rb
-- ext/tasker_core/src/CLAUDE.md
 - ext/tasker_core/src/bootstrap.rs
 - ext/tasker_core/src/bridge.rs
 - ext/tasker_core/src/client_ffi.rs
@@ -240,7 +239,6 @@ files:
 - lib/tasker_core/domain_events/publisher_registry.rb
 - lib/tasker_core/domain_events/subscriber_registry.rb
 - lib/tasker_core/errors.rb
-- lib/tasker_core/errors/CLAUDE.md
 - lib/tasker_core/errors/common.rb
 - lib/tasker_core/errors/error_classifier.rb
 - lib/tasker_core/event_bridge.rb
@@ -284,7 +282,6 @@ files:
 - lib/tasker_core/types/task_template.rb
 - lib/tasker_core/types/task_types.rb
 - lib/tasker_core/version.rb
-- lib/tasker_core/worker/CLAUDE.md
 - lib/tasker_core/worker/event_poller.rb
 - lib/tasker_core/worker/in_process_domain_event_poller.rb
 homepage: https://github.com/tasker-systems/tasker-core
@@ -292,16 +289,15 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/tasker-systems/tasker-core
-  source_code_uri: https://github.com/tasker-systems/tasker-core/tree/main/workers/ruby
-  changelog_uri: https://github.com/tasker-systems/tasker-core/blob/main/workers/ruby/CHANGELOG.md
-  documentation_uri: https://github.com/tasker-systems/tasker-core/blob/main/docs/RUBY.md
+  source_code_uri: https://github.com/tasker-systems/tasker-core/tree/main/crates/tasker-rb
+  changelog_uri: https://github.com/tasker-systems/tasker-core/blob/main/CHANGELOG.md
+  documentation_uri: https://docs.tasker.systems
   bug_tracker_uri: https://github.com/tasker-systems/tasker-core/issues
   allowed_push_host: https://rubygems.org
   rubygems_mfa_required: 'true'
 post_install_message: "\n\U0001F980 tasker-rb successfully installed!\n\nThis gem
   provides high-performance Rust-powered workflow orchestration.\n\nDocumentation:
-  https://github.com/tasker-systems/tasker-core/blob/main/docs/workers/ruby.md\n\nFor
-  Rails integration, see the tasker-engine gem documentation.\n\n"
+  https://docs.tasker.systems\n\n"
 rdoc_options: []
 require_paths:
 - lib

data/ext/tasker_core/src/CLAUDE.md

@@ -1,7 +0,0 @@
-<claude-mem-context>
-# Recent Activity
-
-<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
-
-*No recent activity*
-</claude-mem-context>

data/lib/tasker_core/errors/CLAUDE.md

@@ -1,7 +0,0 @@
-<claude-mem-context>
-# Recent Activity
-
-<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
-
-*No recent activity*
-</claude-mem-context>

data/lib/tasker_core/worker/CLAUDE.md

@@ -1,7 +0,0 @@
-<claude-mem-context>
-# Recent Activity
-
-<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
-
-*No recent activity*
-</claude-mem-context>