smart_message 0.0.9 → 0.0.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5f02a7e60919734663addbef7ae2b5582bc142993654ef33fe17c90e1a70d138
-  data.tar.gz: 50e7250d3e217faba23eb2a1d995b6edff0d9e0d7935bf2ea31602aff483a092
+  metadata.gz: 2e7bd096698c7b656fc3800dcbbd88366dccb0ae36be0a9a1f50240c944a6de3
+  data.tar.gz: 13235c27c12c4f76bdae091b0a432b505f0cfe49cd571fde387358aba98cf7da
 SHA512:
-  metadata.gz: 7c157a60a127d4bd7a86742ccee8dff5385f11110d1449bc859742c497cc79d9a0e528dd39645d66a8e2b413602c31c4c79f73c9c560b5aacb37acc9610d3183
-  data.tar.gz: 31fc0e365c549326e9a9314f435d50715c4c980e7380311e19a7428638198d2ce499f8acd104381a631b2a40cd66d2deb8bb7fa3e16c59a61a443cc980698b56
+  metadata.gz: 2b9b74f2203c1c6cd95a981e4f7c89d9fb6e1aad112c99b61420521ce95e89b4f3c378936ba9f435f67ee548b88e2e2ea28d70216856eaf898c028f1058f5d04
+  data.tar.gz: f7a9636706cb07e2b8df17e0e25b13128a2aed8a4ddd3d80ab28fadee3e27fc1ac52fafa9593f9854ffa54fb5920fe93334fb7f361c3394929c1fe4ea9be2adb

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,59 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### 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
+  - Handler-only DDQ scoping using `"MessageClass:HandlerMethod"` key format for natural isolation
+  - Automatic subscriber identification eliminates need for explicit `me:` parameter in API
+  - Cross-process deduplication support with independent DDQ instances per handler
+  - Memory and Redis storage backends with O(1) performance using hybrid Array + Set data structure
+  - Seamless integration with dispatcher - no changes required to existing subscription code
+  - Per-handler statistics and monitoring capabilities with DDQ utilization tracking
+  - Thread-safe circular buffer implementation with automatic eviction of oldest entries
+  - Configuration DSL: `ddq_size`, `ddq_storage`, `enable_deduplication!`, `disable_deduplication!`
+  - Comprehensive documentation and examples demonstrating distributed message processing scenarios
+
+### Fixed
+- **Message Filtering Logic**: Fixed critical bug in subscription filtering where nil broadcast filters caused incorrect behavior
+  - **Root Cause**: `filters.key?(:broadcast)` returned true even when broadcast value was nil
+  - **Solution**: Changed condition to check for non-nil values: `filters[:to] || filters[:broadcast]`
+  - **Impact**: Subscription filtering now works correctly with nil filter values and maintains backward compatibility
+- **Circuit Breaker Test Compatibility**: Added error handling for non-existent message classes in DDQ initialization
+  - Added rescue blocks around `constantize` calls to gracefully handle fake test classes
+  - DDQ initialization now skips gracefully for test classes that cannot be constantized
+  - Maintains proper DDQ functionality for real message classes while supporting test scenarios
+
 ## [0.0.9] 2025-08-20
 ### Added
 - **Advanced Logging Configuration System**: Comprehensive logger configuration with multiple output formats and options

data/Gemfile.lock

@@ -1,8 +1,10 @@
 PATH
   remote: .
   specs:
-    smart_message (0.0.9)
+    smart_message (0.0.12)
       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.29.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.13.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.0)
     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.1)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     uri (1.0.3)