smart_message 0.0.10 → 0.0.12

data/docs/assets/images/redis-queue-architecture.svg

@@ -0,0 +1,101 @@
+<svg width="900" height="400" xmlns="http://www.w3.org/2000/svg" style="background: transparent;">
+  <defs>
+    <style>
+      .title { font: bold 18px sans-serif; fill: #e1e5e9; text-anchor: middle; }
+      .label { font: 14px sans-serif; fill: #c9d1d9; text-anchor: middle; }
+      .small-label { font: 12px sans-serif; fill: #8b949e; text-anchor: middle; }
+      .box { fill: #21262d; stroke: #30363d; stroke-width: 2; rx: 8; }
+      .highlight-box { fill: #0d1117; stroke: #f85149; stroke-width: 2; rx: 8; }
+      .queue-box { fill: #0d1117; stroke: #56d364; stroke-width: 2; rx: 8; }
+      .async-box { fill: #161b22; stroke: #a5a5ff; stroke-width: 2; rx: 6; }
+      .consumer-box { fill: #161b22; stroke: #ffa657; stroke-width: 2; rx: 6; }
+      .arrow { stroke: #58a6ff; stroke-width: 2; fill: none; marker-end: url(#arrowhead); }
+      .queue-flow { stroke: #56d364; stroke-width: 3; fill: none; marker-end: url(#arrowhead-green); }
+      .async-flow { stroke: #a5a5ff; stroke-width: 2; fill: none; marker-end: url(#arrowhead-purple); }
+    </style>
+    <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#58a6ff" />
+    </marker>
+    <marker id="arrowhead-green" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#56d364" />
+    </marker>
+    <marker id="arrowhead-purple" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#a5a5ff" />
+    </marker>
+  </defs>
+  
+  <!-- Title -->
+  <text x="450" y="30" class="title">Redis Queue Transport Architecture</text>
+  
+  <!-- Publisher -->
+  <rect x="50" y="80" width="120" height="80" class="box"/>
+  <text x="110" y="105" class="label">Publisher</text>
+  <text x="110" y="125" class="small-label">OrderMessage</text>
+  <text x="110" y="140" class="small-label">Async context</text>
+  <text x="110" y="155" class="small-label">Fiber-based</text>
+  
+  <!-- Routing Engine -->
+  <rect x="220" y="80" width="140" height="80" class="highlight-box"/>
+  <text x="290" y="105" class="label">Routing Engine</text>
+  <text x="290" y="125" class="small-label">Pattern matching:</text>
+  <text x="290" y="140" class="small-label">#.*.payment</text>
+  <text x="290" y="155" class="small-label">order.#.*.*</text>
+  
+  <!-- Redis Lists (Queues) -->
+  <rect x="410" y="60" width="130" height="50" class="queue-box"/>
+  <text x="475" y="80" class="small-label">Redis List (FIFO)</text>
+  <text x="475" y="95" class="small-label">LPUSH/BRPOP</text>
+  
+  <rect x="410" y="120" width="130" height="50" class="queue-box"/>
+  <text x="475" y="140" class="small-label">Persistent Queue</text>
+  <text x="475" y="155" class="small-label">Message ordering</text>
+  
+  <!-- Consumer Group -->
+  <rect x="590" y="80" width="140" height="80" class="consumer-box"/>
+  <text x="660" y="105" class="label">Consumer Group</text>
+  <text x="660" y="125" class="small-label">"workers"</text>
+  <text x="660" y="140" class="small-label">Load balancing</text>
+  <text x="660" y="155" class="small-label">Fault tolerance</text>
+  
+  <!-- Async Workers -->
+  <rect x="780" y="60" width="100" height="40" class="async-box"/>
+  <text x="830" y="80" class="small-label">Worker 1</text>
+  <text x="830" y="95" class="small-label">Fiber</text>
+  
+  <rect x="780" y="110" width="100" height="40" class="async-box"/>
+  <text x="830" y="130" class="small-label">Worker 2</text>
+  <text x="830" y="145" class="small-label">Fiber</text>
+  
+  <rect x="780" y="160" width="100" height="40" class="async-box"/>
+  <text x="830" y="180" class="small-label">Worker N</text>
+  <text x="830" y="195" class="small-label">Fiber</text>
+  
+  <!-- Flow Arrows -->
+  <line x1="170" y1="120" x2="220" y2="120" class="arrow"/>
+  <line x1="360" y1="100" x2="410" y2="85" class="queue-flow"/>
+  <line x1="360" y1="140" x2="410" y2="145" class="queue-flow"/>
+  <line x1="540" y1="120" x2="590" y2="120" class="queue-flow"/>
+  <line x1="730" y1="100" x2="780" y2="80" class="async-flow"/>
+  <line x1="730" y1="120" x2="780" y2="130" class="async-flow"/>
+  <line x1="730" y1="140" x2="780" y2="180" class="async-flow"/>
+  
+  <!-- Performance Stats -->
+  <rect x="50" y="220" width="800" height="120" class="async-box"/>
+  <text x="450" y="245" class="label">Performance &amp; Features</text>
+  
+  <text x="200" y="270" class="small-label">Latency: ~0.5ms</text>
+  <text x="200" y="285" class="small-label">Throughput: 100K+ msg/sec</text>
+  <text x="200" y="300" class="small-label">10x faster than RabbitMQ</text>
+  
+  <text x="450" y="270" class="small-label">Concurrent Consumers: 1000+</text>
+  <text x="450" y="285" class="small-label">Memory per Consumer: ~2KB</text>
+  <text x="450" y="300" class="small-label">1000x less than RabbitMQ</text>
+  
+  <text x="700" y="270" class="small-label">• Message Persistence</text>
+  <text x="700" y="285" class="small-label">• Load Balancing</text>
+  <text x="700" y="300" class="small-label">• Dead Letter Queues</text>
+  
+  <!-- Key Benefits -->
+  <text x="450" y="360" class="label">Enterprise messaging with Redis performance: RabbitMQ features + 10x speed + Async scalability</text>
+  <text x="450" y="380" class="small-label">Perfect for production systems requiring message persistence, load balancing, and maximum throughput</text>
+</svg>

data/docs/assets/images/smartmessage_architecture_overview.svg

@@ -0,0 +1,173 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="900" height="700" viewBox="0 0 900 700" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <style>
+      .bg { fill: transparent; }
+      .core-group { fill: #1a2a3a; stroke: #4a9eff; stroke-width: 2; rx: 10; }
+      .plugin-group { fill: #2a1a3a; stroke: #aa4aff; stroke-width: 2; rx: 10; }
+      .processing-group { fill: #1a3a2a; stroke: #4aff4a; stroke-width: 2; rx: 10; }
+      .reliability-group { fill: #3a1a1a; stroke: #ff4a4a; stroke-width: 2; rx: 10; }
+      .monitoring-group { fill: #3a3a1a; stroke: #ffaa4a; stroke-width: 2; rx: 10; }
+      .component { fill: #2a2a2a; stroke: #ffffff; stroke-width: 1; rx: 5; }
+      .flow { stroke: #4a9eff; stroke-width: 2; fill: none; marker-end: url(#arrowhead-blue); }
+      .plugin-flow { stroke: #aa4aff; stroke-width: 2; fill: none; marker-end: url(#arrowhead-purple); }
+      .process-flow { stroke: #4aff4a; stroke-width: 2; fill: none; marker-end: url(#arrowhead-green); }
+      .reliability-flow { stroke: #ff4a4a; stroke-width: 2; fill: none; marker-end: url(#arrowhead-red); }
+      .monitor-flow { stroke: #ffaa4a; stroke-width: 2; fill: none; stroke-dasharray: 4,4; }
+      .text { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 11px; }
+      .title { fill: #4a9eff; font-family: 'Arial', sans-serif; font-size: 18px; font-weight: bold; }
+      .group-title { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 13px; font-weight: bold; }
+      .component-title { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 12px; font-weight: bold; }
+    </style>
+    <marker id="arrowhead-blue" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#4a9eff" />
+    </marker>
+    <marker id="arrowhead-purple" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#aa4aff" />
+    </marker>
+    <marker id="arrowhead-green" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#4aff4a" />
+    </marker>
+    <marker id="arrowhead-red" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#ff4a4a" />
+    </marker>
+  </defs>
+  
+  <!-- Background -->
+  <rect class="bg" width="900" height="700"/>
+  
+  <!-- Title -->
+  <text x="450" y="25" text-anchor="middle" class="title">SmartMessage Architecture Overview</text>
+  
+  <!-- SmartMessage Core Group -->
+  <rect x="50" y="60" width="250" height="180" class="core-group"/>
+  <text x="175" y="80" text-anchor="middle" class="group-title">SmartMessage Core</text>
+  
+  <rect x="70" y="95" width="210" height="35" class="component"/>
+  <text x="175" y="115" text-anchor="middle" class="component-title">SmartMessage::Base</text>
+  
+  <rect x="70" y="140" width="100" height="45" class="component"/>
+  <text x="120" y="157" text-anchor="middle" class="component-title">Message Header</text>
+  <text x="120" y="172" text-anchor="middle" class="text">• UUID</text>
+  <text x="120" y="182" text-anchor="middle" class="text">• Timestamps • Addressing</text>
+  
+  <rect x="180" y="140" width="100" height="45" class="component"/>
+  <text x="230" y="157" text-anchor="middle" class="component-title">Message Properties</text>
+  <text x="230" y="172" text-anchor="middle" class="text">• Business Data</text>
+  <text x="230" y="182" text-anchor="middle" class="text">• Validation • Versioning</text>
+  
+  <!-- Plugin System Group -->
+  <rect x="350" y="60" width="200" height="180" class="plugin-group"/>
+  <text x="450" y="80" text-anchor="middle" class="group-title">Plugin System</text>
+  
+  <rect x="370" y="95" width="160" height="40" class="component"/>
+  <text x="450" y="110" text-anchor="middle" class="component-title">Transport Plugin</text>
+  <text x="450" y="122" text-anchor="middle" class="text">• publish • subscribe</text>
+  <text x="450" y="132" text-anchor="middle" class="text">• Memory/Redis/STDOUT</text>
+  
+  <rect x="370" y="145" width="160" height="40" class="component"/>
+  <text x="450" y="160" text-anchor="middle" class="component-title">Serializer Plugin</text>
+  <text x="450" y="172" text-anchor="middle" class="text">• encode • decode</text>
+  <text x="450" y="182" text-anchor="middle" class="text">• JSON/Custom</text>
+  
+  <rect x="370" y="195" width="160" height="40" class="component"/>
+  <text x="450" y="210" text-anchor="middle" class="component-title">Logger Plugin</text>
+  <text x="450" y="222" text-anchor="middle" class="text">• Structured logging</text>
+  <text x="450" y="232" text-anchor="middle" class="text">• Multiple outputs • Colorization</text>
+  
+  <!-- Message Processing Group -->
+  <rect x="50" y="260" width="500" height="180" class="processing-group"/>
+  <text x="300" y="280" text-anchor="middle" class="group-title">Message Processing</text>
+  
+  <rect x="70" y="295" width="140" height="50" class="component"/>
+  <text x="140" y="315" text-anchor="middle" class="component-title">Dispatcher</text>
+  <text x="140" y="327" text-anchor="middle" class="text">• Route messages • Thread pool</text>
+  <text x="140" y="337" text-anchor="middle" class="text">• Subscriptions • DDQ management</text>
+  
+  <rect x="230" y="295" width="140" height="50" class="component"/>
+  <text x="300" y="315" text-anchor="middle" class="component-title">Deduplication Queue</text>
+  <text x="300" y="327" text-anchor="middle" class="text">• Handler-scoped • Memory/Redis</text>
+  <text x="300" y="337" text-anchor="middle" class="text">• O(1) performance • Circular buffer</text>
+  
+  <rect x="390" y="295" width="140" height="50" class="component"/>
+  <text x="460" y="315" text-anchor="middle" class="component-title">Message Handlers</text>
+  <text x="460" y="327" text-anchor="middle" class="text">• Default handler • Block handlers</text>
+  <text x="460" y="337" text-anchor="middle" class="text">• Proc handlers • Method handlers</text>
+  
+  <rect x="70" y="365" width="140" height="50" class="component"/>
+  <text x="140" y="385" text-anchor="middle" class="component-title">Statistics</text>
+  <text x="140" y="397" text-anchor="middle" class="text">• Message counts • Processing metrics</text>
+  <text x="140" y="407" text-anchor="middle" class="text">• Thread pool status</text>
+  
+  <rect x="230" y="365" width="140" height="50" class="component"/>
+  <text x="300" y="385" text-anchor="middle" class="component-title">Message Filtering</text>
+  <text x="300" y="397" text-anchor="middle" class="text">• Entity-aware routing</text>
+  <text x="300" y="407" text-anchor="middle" class="text">• Regex patterns • Broadcast handling</text>
+  
+  <!-- Reliability Layer Group -->
+  <rect x="600" y="60" width="250" height="180" class="reliability-group"/>
+  <text x="725" y="80" text-anchor="middle" class="group-title">Reliability Layer</text>
+  
+  <rect x="620" y="95" width="210" height="50" class="component"/>
+  <text x="725" y="115" text-anchor="middle" class="component-title">Circuit Breaker</text>
+  <text x="725" y="127" text-anchor="middle" class="text">• Failure thresholds • Automatic fallback</text>
+  <text x="725" y="137" text-anchor="middle" class="text">• Recovery detection</text>
+  
+  <rect x="620" y="165" width="210" height="50" class="component"/>
+  <text x="725" y="185" text-anchor="middle" class="component-title">Dead Letter Queue</text>
+  <text x="725" y="197" text-anchor="middle" class="text">• Failed messages • Replay mechanism</text>
+  <text x="725" y="207" text-anchor="middle" class="text">• JSON Lines format</text>
+  
+  <!-- Core connections -->
+  <path d="M 175 130 L 175 140" class="flow"/>
+  <path d="M 175 130 L 230 140" class="flow"/>
+  <path d="M 175 130 L 120 140" class="flow"/>
+  
+  <!-- Plugin connections -->
+  <path d="M 300 112 L 370 115" class="plugin-flow"/>
+  <path d="M 300 112 L 370 165" class="plugin-flow"/>
+  <path d="M 300 112 L 370 215" class="plugin-flow"/>
+  
+  <!-- Transport to Processing -->
+  <path d="M 450 135 L 450 250 L 140 295" class="process-flow"/>
+  
+  <!-- Processing internal flows -->
+  <path d="M 210 320 L 230 320" class="process-flow"/>
+  <path d="M 370 320 L 390 320" class="process-flow"/>
+  <path d="M 140 345 L 140 365" class="process-flow"/>
+  <path d="M 300 345 L 300 365" class="process-flow"/>
+  
+  <!-- Reliability connections -->
+  <path d="M 550 115 L 620 120" class="reliability-flow"/>
+  <path d="M 725 145 L 725 165" class="reliability-flow"/>
+  
+  <!-- Monitoring connections (dashed)-->
+  <path d="M 300 345 L 140 365" class="monitor-flow"/>
+  <path d="M 460 345 L 140 365" class="monitor-flow"/>
+  
+  <!-- Legend -->
+  <rect x="600" y="480" width="280" height="200" fill="#1a1a1a" stroke="#4a9eff" rx="8"/>
+  <text x="740" y="505" text-anchor="middle" class="group-title">Component Legend</text>
+  
+  <rect x="620" y="520" width="15" height="10" class="core-group"/>
+  <text x="645" y="530" class="text">SmartMessage Core Components</text>
+  
+  <rect x="620" y="540" width="15" height="10" class="plugin-group"/>
+  <text x="645" y="550" class="text">Plugin System Architecture</text>
+  
+  <rect x="620" y="560" width="15" height="10" class="processing-group"/>
+  <text x="645" y="570" class="text">Message Processing Engine</text>
+  
+  <rect x="620" y="580" width="15" height="10" class="reliability-group"/>
+  <text x="645" y="590" class="text">Reliability &amp; Fault Tolerance</text>
+  
+  <line x1="620" y1="610" x2="635" y2="610" class="monitor-flow"/>
+  <text x="645" y="615" class="text">Monitoring &amp; Statistics</text>
+  
+  <text x="740" y="645" text-anchor="middle" class="text">Dark Theme Architecture Diagram</text>
+  <text x="740" y="660" text-anchor="middle" class="text">SmartMessage Framework v1.0</text>
+</svg>

data/docs/assets/images/transport-comparison-matrix.svg

@@ -0,0 +1,171 @@
+<svg width="1000" height="600" xmlns="http://www.w3.org/2000/svg" style="background: transparent;">
+  <defs>
+    <style>
+      .title { font: bold 20px sans-serif; fill: #e1e5e9; text-anchor: middle; }
+      .header { font: bold 16px sans-serif; fill: #c9d1d9; text-anchor: middle; }
+      .label { font: 14px sans-serif; fill: #c9d1d9; }
+      .small-label { font: 12px sans-serif; fill: #8b949e; }
+      .feature-label { font: 14px sans-serif; fill: #f0f6fc; }
+      .yes { fill: #56d364; font: bold 14px sans-serif; text-anchor: middle; }
+      .no { fill: #f85149; font: bold 14px sans-serif; text-anchor: middle; }
+      .partial { fill: #ffa657; font: bold 14px sans-serif; text-anchor: middle; }
+      .value { fill: #a5a5ff; font: 14px sans-serif; text-anchor: middle; }
+      .table-border { fill: none; stroke: #30363d; stroke-width: 1; }
+      .header-bg { fill: #161b22; stroke: #30363d; stroke-width: 1; }
+      .row-bg-1 { fill: #0d1117; stroke: #21262d; stroke-width: 1; }
+      .row-bg-2 { fill: #161b22; stroke: #21262d; stroke-width: 1; }
+      .basic-col { fill: #21262d; stroke: #30363d; stroke-width: 1; }
+      .enhanced-col { fill: #1a1d2e; stroke: #a5a5ff; stroke-width: 1; }
+      .queue-col { fill: #1a2e1a; stroke: #56d364; stroke-width: 1; }
+    </style>
+  </defs>
+  
+  <!-- Title -->
+  <text x="500" y="30" class="title">Redis Transport Feature Comparison</text>
+  
+  <!-- Table Headers -->
+  <rect x="50" y="60" width="250" height="40" class="header-bg"/>
+  <rect x="300" y="60" width="200" height="40" class="basic-col"/>
+  <rect x="500" y="60" width="200" height="40" class="enhanced-col"/>
+  <rect x="700" y="60" width="200" height="40" class="queue-col"/>
+  
+  <text x="175" y="85" class="header">Feature</text>
+  <text x="400" y="85" class="header">Basic Redis</text>
+  <text x="600" y="85" class="header">Enhanced Redis</text>
+  <text x="800" y="85" class="header">Redis Queue</text>
+  
+  <!-- Feature Rows -->
+  <g id="row1">
+    <rect x="50" y="100" width="250" height="30" class="row-bg-1"/>
+    <rect x="300" y="100" width="200" height="30" class="row-bg-1"/>
+    <rect x="500" y="100" width="200" height="30" class="row-bg-1"/>
+    <rect x="700" y="100" width="200" height="30" class="row-bg-1"/>
+    <text x="60" y="120" class="feature-label">Message Persistence</text>
+    <text x="400" y="120" class="no">✗ No</text>
+    <text x="600" y="120" class="no">✗ No</text>
+    <text x="800" y="120" class="yes">✓ Yes</text>
+  </g>
+  
+  <g id="row2">
+    <rect x="50" y="130" width="250" height="30" class="row-bg-2"/>
+    <rect x="300" y="130" width="200" height="30" class="row-bg-2"/>
+    <rect x="500" y="130" width="200" height="30" class="row-bg-2"/>
+    <rect x="700" y="130" width="200" height="30" class="row-bg-2"/>
+    <text x="60" y="150" class="feature-label">Pattern Matching</text>
+    <text x="400" y="150" class="no">✗ None</text>
+    <text x="600" y="150" class="yes">✓ Wildcards</text>
+    <text x="800" y="150" class="yes">✓ RabbitMQ-style</text>
+  </g>
+  
+  <g id="row3">
+    <rect x="50" y="160" width="250" height="30" class="row-bg-1"/>
+    <rect x="300" y="160" width="200" height="30" class="row-bg-1"/>
+    <rect x="500" y="160" width="200" height="30" class="row-bg-1"/>
+    <rect x="700" y="160" width="200" height="30" class="row-bg-1"/>
+    <text x="60" y="180" class="feature-label">Load Balancing</text>
+    <text x="400" y="180" class="no">✗ No</text>
+    <text x="600" y="180" class="no">✗ No</text>
+    <text x="800" y="180" class="yes">✓ Consumer Groups</text>
+  </g>
+  
+  <g id="row4">
+    <rect x="50" y="190" width="250" height="30" class="row-bg-2"/>
+    <rect x="300" y="190" width="200" height="30" class="row-bg-2"/>
+    <rect x="500" y="190" width="200" height="30" class="row-bg-2"/>
+    <rect x="700" y="190" width="200" height="30" class="row-bg-2"/>
+    <text x="60" y="210" class="feature-label">Backwards Compatible</text>
+    <text x="400" y="210" class="value">N/A</text>
+    <text x="600" y="210" class="yes">✓ Dual Publishing</text>
+    <text x="800" y="210" class="no">✗ No</text>
+  </g>
+  
+  <g id="row5">
+    <rect x="50" y="220" width="250" height="30" class="row-bg-1"/>
+    <rect x="300" y="220" width="200" height="30" class="row-bg-1"/>
+    <rect x="500" y="220" width="200" height="30" class="row-bg-1"/>
+    <rect x="700" y="220" width="200" height="30" class="row-bg-1"/>
+    <text x="60" y="240" class="feature-label">Fluent API</text>
+    <text x="400" y="240" class="no">✗ No</text>
+    <text x="600" y="240" class="yes">✓ Yes</text>
+    <text x="800" y="240" class="yes">✓ Yes</text>
+  </g>
+  
+  <g id="row6">
+    <rect x="50" y="250" width="250" height="30" class="row-bg-2"/>
+    <rect x="300" y="250" width="200" height="30" class="row-bg-2"/>
+    <rect x="500" y="250" width="200" height="30" class="row-bg-2"/>
+    <rect x="700" y="250" width="200" height="30" class="row-bg-2"/>
+    <text x="60" y="270" class="feature-label">Latency</text>
+    <text x="400" y="270" class="value">~1ms</text>
+    <text x="600" y="270" class="value">~1.2ms</text>
+    <text x="800" y="270" class="value">~0.5ms</text>
+  </g>
+  
+  <g id="row7">
+    <rect x="50" y="280" width="250" height="30" class="row-bg-1"/>
+    <rect x="300" y="280" width="200" height="30" class="row-bg-1"/>
+    <rect x="500" y="280" width="200" height="30" class="row-bg-1"/>
+    <rect x="700" y="280" width="200" height="30" class="row-bg-1"/>
+    <text x="60" y="300" class="feature-label">Concurrent Consumers</text>
+    <text x="400" y="300" class="value">~100s</text>
+    <text x="600" y="300" class="value">~100s</text>
+    <text x="800" y="300" class="value">~1000s</text>
+  </g>
+  
+  <g id="row8">
+    <rect x="50" y="310" width="250" height="30" class="row-bg-2"/>
+    <rect x="300" y="310" width="200" height="30" class="row-bg-2"/>
+    <rect x="500" y="310" width="200" height="30" class="row-bg-2"/>
+    <rect x="700" y="310" width="200" height="30" class="row-bg-2"/>
+    <text x="60" y="330" class="feature-label">Setup Complexity</text>
+    <text x="400" y="330" class="yes">Low</text>
+    <text x="600" y="330" class="partial">Medium</text>
+    <text x="800" y="330" class="no">High</text>
+  </g>
+  
+  <g id="row9">
+    <rect x="50" y="340" width="250" height="30" class="row-bg-1"/>
+    <rect x="300" y="340" width="200" height="30" class="row-bg-1"/>
+    <rect x="500" y="340" width="200" height="30" class="row-bg-1"/>
+    <rect x="700" y="340" width="200" height="30" class="row-bg-1"/>
+    <text x="60" y="360" class="feature-label">Memory Overhead</text>
+    <text x="400" y="360" class="yes">Low</text>
+    <text x="600" y="360" class="partial">Medium</text>
+    <text x="800" y="360" class="partial">Medium-High</text>
+  </g>
+  
+  <g id="row10">
+    <rect x="50" y="370" width="250" height="30" class="row-bg-2"/>
+    <rect x="300" y="370" width="200" height="30" class="row-bg-2"/>
+    <rect x="500" y="370" width="200" height="30" class="row-bg-2"/>
+    <rect x="700" y="370" width="200" height="30" class="row-bg-2"/>
+    <text x="60" y="390" class="feature-label">Message Ordering</text>
+    <text x="400" y="390" class="no">No guarantees</text>
+    <text x="600" y="390" class="no">No guarantees</text>
+    <text x="800" y="390" class="yes">✓ FIFO</text>
+  </g>
+  
+  <!-- Use Case Recommendations -->
+  <text x="500" y="440" class="header">Recommended Use Cases</text>
+  
+  <rect x="50" y="460" width="280" height="100" class="basic-col"/>
+  <text x="190" y="480" class="header">Basic Redis</text>
+  <text x="60" y="500" class="small-label">• Simple pub/sub scenarios</text>
+  <text x="60" y="515" class="small-label">• Development/testing</text>
+  <text x="60" y="530" class="small-label">• Legacy compatibility</text>
+  <text x="60" y="545" class="small-label">• Maximum performance</text>
+  
+  <rect x="360" y="460" width="280" height="100" class="enhanced-col"/>
+  <text x="500" y="480" class="header">Enhanced Redis</text>
+  <text x="370" y="500" class="small-label">• Microservices architecture</text>
+  <text x="370" y="515" class="small-label">• Pattern-based routing</text>
+  <text x="370" y="530" class="small-label">• Migration scenarios</text>
+  <text x="370" y="545" class="small-label">• Intelligent filtering</text>
+  
+  <rect x="670" y="460" width="280" height="100" class="queue-col"/>
+  <text x="810" y="480" class="header">Redis Queue</text>
+  <text x="680" y="500" class="small-label">• Production systems</text>
+  <text x="680" y="515" class="small-label">• Message persistence</text>
+  <text x="680" y="530" class="small-label">• Load balancing</text>
+  <text x="680" y="545" class="small-label">• Enterprise features</text>
+</svg>

data/docs/assets/javascripts/mathjax.js

@@ -0,0 +1,17 @@
+// MathJax configuration for SmartMessage documentation
+window.MathJax = {
+  tex: {
+    inlineMath: [["\\(", "\\)"]],
+    displayMath: [["\\[", "\\]"]],
+    processEscapes: true,
+    processEnvironments: true
+  },
+  options: {
+    ignoreHtmlClass: ".*|",
+    processHtmlClass: "arithmatex"
+  }
+};
+
+document$.subscribe(() => { 
+  MathJax.typesetPromise()
+})

data/docs/assets/stylesheets/extra.css

@@ -0,0 +1,51 @@
+/* Custom styles for SmartMessage documentation */
+
+/* Make header/navigation text more prominent */
+.md-header__title {
+  font-size: 1.2rem !important;
+  font-weight: 700 !important;
+}
+
+.md-header__topic {
+  font-weight: 600 !important;
+}
+
+/* Make navigation tabs larger and bolder */
+.md-tabs__link {
+  font-size: 0.9rem !important;
+  font-weight: 600 !important;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+}
+
+/* Active tab styling */
+.md-tabs__link--active {
+  font-weight: 700 !important;
+}
+
+/* Navigation drawer items */
+.md-nav__link {
+  font-size: 0.85rem !important;
+}
+
+.md-nav__link--active {
+  font-weight: 600 !important;
+}
+
+/* Section headers in navigation */
+.md-nav__title {
+  font-weight: 700 !important;
+  font-size: 0.9rem !important;
+}
+
+/* Search bar text */
+.md-search__input {
+  font-size: 0.9rem !important;
+}
+
+/* Make the site name in header extra prominent */
+.md-header__title .md-header__ellipsis {
+  font-size: 1.3rem !important;
+  font-weight: 800 !important;
+  letter-spacing: 0.5px;
+}

data/docs/{addressing.md → core-concepts/addressing.md}

@@ -256,19 +256,17 @@ request.publish
 
 # In user-service handler:
 class UserLookupRequest
-  def self.process(header, payload)
-    request_data = JSON.parse(payload)
-    
+  def self.process(decoded_message)
     # Process lookup...
-    user_data = UserService.find(request_data['user_id'])
+    user_data = UserService.find(decoded_message.user_id)
     
     # Send response back to reply_to address
     response = UserLookupResponse.new(
-      user_id: request_data['user_id'],
-      request_id: request_data['request_id'],
+      user_id: decoded_message.user_id,
+      request_id: decoded_message.request_id,
       user_data: user_data
     )
-    response.to(header.reply_to)  # Send to original reply_to
+    response.to(decoded_message._sm_header.reply_to)  # Send to original reply_to
     response.publish
   end
 end