smart_message 0.0.10 → 0.0.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8485ad851b6868c57b813977a4b2be3b1e06fe2843510a5b64c79468da3a65cf
-  data.tar.gz: 1c2345c52d1dd57202a83a49d3d4e7769f14b2855d0a08745d3ed4c970ef0f0e
+  metadata.gz: 38b75aa70a9ab79b0fd9ac311d7e5634491789e5813161630ff7e04f17d61373
+  data.tar.gz: 8196665b3a660cfaad1c30753697f020c4a54b50c25d23be6f6c3c6ad9149e38
 SHA512:
-  metadata.gz: 26cfdd1030e880074e557f7bc315220995b3267ec0a11fd4d0f621933e2101f40f35da425649388b83bf8055246934e6c9f8e60a281246e04e5cd89763c33e07
-  data.tar.gz: 25d66186e9ebe3f3fcf595e7093ec08c50db83d84205fcb4567b0c69804e44b80496693c40e36a0ea30b9f315a36d2070e701977bec6a0660f3c3bda327f1d88
+  metadata.gz: 876f94f732eb022c568a200747438ab6a0938602735f89601fc7c9e48f34bf21791c75608b2d877475d9190a9629974a63448f5ceb6eeb24bf073b0cc1e4ee19
+  data.tar.gz: 310150522f4d6561c40e7322072a75778867b643b5eb6b79364b750a39689e27cbfd7c7022ae0f0c8a44ae9a850549c02e94005930d4b878ba75cb1eb1192a58

data/.github/workflows/deploy-github-pages.yml

@@ -0,0 +1,38 @@
+name: Deploy Documentation to GitHub Pages
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - ".github/workflows/deploy-github-pages.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+
+      - name: Install dependencies
+        run: |
+          pip install mkdocs
+          pip install mkdocs-material
+          pip install mkdocs-macros-plugin
+
+      - name: Deploy to GitHub Pages
+        run: mkdocs gh-deploy --force

data/.gitignore

@@ -8,3 +8,8 @@
 /pkg/
 /spec/reports/
 /tmp/
+/.aigcm_msg/
+site
+.aigcm_msg
+/log/
+/logs/

data/CHANGELOG.md

@@ -7,6 +7,70 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.13] 2025-09-10
+
+### Changed
+- **BREAKING: Transport-Level Serialization Architecture**: Major architectural rework moving serializer responsibility from message classes to transport layer
+  - **Core Change**: Serializers now associated with transports instead of message classes, enabling different transports to use different serialization formats
+  - **Message Structure**: Eliminated wrapper objects in favor of flat message structure with `_sm_header` routing metadata
+  - **Serialization Format**: Messages now serialized as single JSON objects containing both header and payload data (e.g., `{"_sm_header": {...}, "content": "value", "property": "data"}`)
+  - **Transport Flexibility**: Each transport can now use its own serializer (JSON, MessagePack, etc.) independently
+  - **Backward Compatibility**: Added `_sm_payload` and `split` methods to maintain compatibility with existing proc handlers
+  - **Performance**: Simplified message processing pipeline with direct message instance passing instead of complex wrapper handling
+
+### Fixed
+- **Message Reconstruction**: Fixed critical bug in `SmartMessage::Base#initialize` where payload properties were not properly extracted from flat serialized structure
+  - **Root Cause**: Initialization logic looked for `props[:_sm_payload]` but flat structure stores properties directly in `props`
+  - **Solution**: Changed to `payload_props = props.except(:_sm_header)` to extract all non-header properties
+  - **Impact**: Proc handlers now receive correct message content, resolving nil property values in `_sm_payload`
+- **Circuit Breaker Test Compatibility**: Updated circuit breaker tests to use new transport method signatures
+  - **Issue**: Tests were calling `transport.publish(header, payload)` with two arguments
+  - **Fix**: Updated to `transport.publish(message_instance)` with single message parameter
+  - **Result**: All circuit breaker tests now pass with new architecture
+- **Deduplication Test Format**: Updated deduplication tests from old wrapper format to new flat structure
+  - **Changed**: `_sm_payload: { content: "value" }` → `content: "value"`
+  - **Maintained**: Full deduplication functionality with handler-scoped DDQ system
+
+### Enhanced
+- **Transport Serialization Control**: Each transport implementation can now specify its preferred serializer
+  - **Memory Transport**: Returns message objects directly without serialization for performance
+  - **STDOUT Transport**: Uses JSON serializer with pretty printing for human readability
+  - **Redis Transport**: Uses MessagePack with JSON fallback for efficient network transmission
+- **Message Processing Pipeline**: Streamlined architecture with direct message instance routing
+  - **Eliminated**: Complex wrapper object creation and management overhead
+  - **Simplified**: Transport `receive` method now directly reconstructs message instances from flat data
+  - **Improved**: Cleaner separation between transport concerns and message processing logic
+
+### Added
+- **Emergency Services Multi-Program Demo**: Complete emergency dispatch simulation system
+  - Added comprehensive emergency services message definitions with validation
+  - Emergency Dispatch Center (911) routing calls to appropriate departments
+  - Fire Department, Police Department, and Health Department service implementations
+  - AI-powered visitor generating realistic emergency scenarios with retry logic
+  - Health monitoring system across all city services with status reporting
+  - Continuous observation generation with diverse emergency scenarios every 15 seconds
+
+### Enhanced
+- **Message Definition Property System**: Improved DRY principles and AI integration
+  - Extracted inline array validations into VALID_* constants (VALID_SEVERITY, VALID_EMERGENCY_TYPES, etc.)
+  - Updated property descriptions to use constants dynamically (#{VALID_SEVERITY.join(', ')})
+  - Enhanced property descriptions to include valid values for better AI prompting
+  - Standardized validation message format using constant interpolation across all message types
+- **SmartMessage Class-Level Addressing**: Added setter method support for flexible syntax
+  - Added from=, to=, reply_to= setter methods to complement existing getter methods
+  - Enables both ClassName.from(value) and ClassName.from = value syntax patterns
+  - Maintains backward compatibility while improving developer experience
+
+### Added
+- **Documentation Website**: MkDocs-based documentation site with GitHub Pages deployment
+  - Added `mkdocs.yml` configuration with Material theme and SmartMessage branding
+  - Created GitHub Actions workflow (`.github/workflows/deploy-github-pages.yml`) for automatic documentation deployment
+  - Reorganized documentation structure into logical sections: Getting Started, Core Concepts, Reference, and Development
+  - Added custom CSS styling for improved header visibility and readability
+  - Integrated SmartMessage logo and branding throughout the documentation
+  - Documentation now automatically deploys to GitHub Pages on push to master branch
+  - Live documentation available at: https://madbomber.github.io/smart_message/
+
 ## [0.0.10] 2025-08-20
 ### Added
 - **Handler-Scoped Message Deduplication**: Advanced DDQ (Deduplication Queue) system with automatic handler isolation

data/Gemfile.lock

@@ -1,8 +1,10 @@
 PATH
   remote: .
   specs:
-    smart_message (0.0.10)
+    smart_message (0.0.13)
       activesupport
+      async
+      async-redis
       breaker_machines
       colorize
       concurrent-ruby
@@ -28,9 +30,23 @@ GEM
       tzinfo (~> 2.0, >= 2.0.5)
       uri (>= 0.13.1)
     amazing_print (1.8.1)
+    async (2.31.0)
+      console (~> 1.29)
+      fiber-annotation
+      io-event (~> 1.11)
+      metrics (~> 0.12)
+      traces (~> 0.18)
+    async-pool (0.11.0)
+      async (>= 2.0)
+    async-redis (0.12.0)
+      async (~> 2.10)
+      async-pool (~> 0.2)
+      io-endpoint (~> 0.10)
+      io-stream (~> 0.4)
+      protocol-redis (~> 0.11)
     base64 (0.3.0)
     benchmark (0.4.1)
-    bigdecimal (3.2.2)
+    bigdecimal (3.2.3)
     breaker_machines (0.4.0)
       activesupport (>= 7.2)
       concurrent-ruby (~> 1.3)
@@ -38,20 +54,34 @@ GEM
       zeitwerk (~> 2.7)
     colorize (1.1.0)
     concurrent-ruby (1.3.5)
-    connection_pool (2.5.3)
+    connection_pool (2.5.4)
+    console (1.34.0)
+      fiber-annotation
+      fiber-local (~> 1.1)
+      json
     debug_me (1.1.1)
     drb (2.2.3)
+    fiber-annotation (0.2.0)
+    fiber-local (1.1.0)
+      fiber-storage
+    fiber-storage (1.0.1)
     hashie (5.0.0)
     i18n (1.14.7)
       concurrent-ruby (~> 1.0)
+    io-endpoint (0.15.2)
+    io-event (1.14.0)
+    io-stream (0.10.0)
+    json (2.13.2)
     logger (1.7.0)
-    lumberjack (1.4.0)
+    lumberjack (1.4.1)
+    metrics (0.14.1)
     minitest (5.25.5)
     minitest-power_assert (0.3.1)
       minitest
       power_assert (>= 1.1)
     mutex_m (0.3.0)
     power_assert (2.0.5)
+    protocol-redis (0.12.0)
     rake (13.3.0)
     redis (5.4.1)
       redis-client (>= 0.22.0)
@@ -65,6 +95,7 @@ GEM
     shoulda-matchers (4.5.1)
       activesupport (>= 4.2.0)
     state_machines (0.100.1)
+    traces (0.18.2)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     uri (1.0.3)