stream_weaver 0.3.0

data/bench/fixtures/ledger.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require_relative "../support"
+
+module StreamWeaverBench
+  module Fixtures
+    module Ledger
+      VARIANTS = %i[legacy_full named_full named_fragments update_filter].freeze
+      INTERACTIONS = %i[create edit validation filter delete].freeze
+
+      module_function
+
+      def build(variant)
+        metrics = Metrics.new
+        people = MemoryStore.new(PEOPLE)
+        named = variant != :legacy_full
+        scoped = %i[named_fragments update_filter].include?(variant)
+        app = StreamWeaver::App.new("Ledger #{variant}") do
+          state[:query] ||= ""
+          state[:error] ||= ""
+          state[:selection] ||= nil
+
+          if named
+            action(:create_person, updates: (scoped ? :people : nil)) { |_s, _| metrics.callback!; people.create(id: 51, name: "New Person", email: "new@example.test", touched: "2026-07-01") }
+            action(:edit_person) { |_s, key| metrics.callback!; people.update(key, name: "Edited Person") }
+            action(:invalid_person) { |s, _| metrics.callback!; s[:error] = "Name is required" }
+            action(:delete_person) { |_s, key| metrics.callback!; people.destroy(key) }
+          end
+
+          toolbar = proc do
+            if named
+              button "Create", action: :create_person, key: "new"
+              button "Invalid", action: :invalid_person, key: "invalid"
+            else
+              button("Create") { |_s| metrics.callback!; people.create(id: 51, name: "New Person", email: "new@example.test", touched: "2026-07-01") }
+              button("Invalid") { |s| metrics.callback!; s[:error] = "Name is required" }
+            end
+            text state[:error]
+            form :quick_edit do
+              text_field :name, default: "Person 01"
+              text_field :email, default: "person01@example.test"
+              submit("Save quick edit") { |_values| metrics.callback! }
+            end
+          end
+          scoped ? fragment(:toolbar, &toolbar) : instance_exec(&toolbar)
+
+          people_view = proc do
+            text_field :query, placeholder: "Search", on_change: ->(_s, _value) { metrics.callback! } if variant == :update_filter
+            shown = people.all.select { |person| person[:name].downcase.include?(state[:query].to_s.downcase) }
+            table shown, row_key: ->(person) { person[:id] } do
+              column :name
+              column :email
+              column :touched
+              column :actions do |person|
+                if named
+                  hstack do
+                    button "Edit", action: :edit_person, key: person[:id]
+                    button "Delete", action: :delete_person, key: person[:id]
+                  end
+                else
+                  hstack do
+                    button("Edit", key: person[:id]) { |_s| metrics.callback!; people.update(person[:id], name: "Edited Person") }
+                    button("Delete", key: person[:id]) { |_s| metrics.callback!; people.destroy(person[:id]) }
+                  end
+                end
+              end
+            end
+          end
+          scoped ? fragment(:people, &people_view) : instance_exec(&people_view)
+        end
+        StreamWeaverBench.instrument(app, metrics)
+        [app.generate, metrics]
+      end
+    end
+  end
+end

data/bench/fixtures/warroom.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require_relative "../support"
+
+module StreamWeaverBench
+  module Fixtures
+    module Warroom
+      VARIANTS = %i[legacy_full named_full named_fragments named_fragments_oob].freeze
+      INTERACTIONS = %i[note_append column_move].freeze
+
+      module_function
+
+      def build(variant)
+        metrics = Metrics.new
+        stories = MemoryStore.new(STORIES)
+        named = variant != :legacy_full
+        app = StreamWeaver::App.new("Warroom #{variant}") do
+          state[:query] ||= ""
+          state[:error] ||= ""
+          state[:selection] ||= stories.all.first[:id]
+          if named
+            action(:append_note) { |_s, key| metrics.callback!; stories.find(key)[:notes] << "Appended note" }
+            action(:move_story) { |_s, key| metrics.callback!; stories.update(key, column: "Active") }
+          end
+
+          board = proc do
+            grid(columns: 3) do
+              %w[Ready Active Done].each do |column|
+                card(title: column) do
+                  stories.all.select { |story| story[:column] == column }.each { |story| text "#{story[:id]} — #{story[:title]}" }
+                end
+              end
+            end
+          end
+          scoped = %i[named_fragments named_fragments_oob].include?(variant)
+          scoped ? fragment(:board, &board) : instance_exec(&board)
+          detail = proc do
+            story = stories.find(state[:selection])
+            text story[:title]
+            story[:notes].each { |note| text note }
+            form :note do
+              text_area :body, default: "Appended note"
+              submit("Add note") { |_values| metrics.callback! }
+            end
+            if named
+              button "Append note", action: :append_note, key: story[:id]
+              button "Move story", action: :move_story, key: story[:id], updates: (variant == :named_fragments_oob ? :board : nil)
+            else
+              button("Append note") { |_s| metrics.callback!; story[:notes] << "Appended note" }
+              button("Move story") { |_s| metrics.callback!; stories.update(story[:id], column: "Active") }
+            end
+          end
+          scoped ? fragment(:detail, &detail) : instance_exec(&detail)
+        end
+        StreamWeaverBench.instrument(app, metrics)
+        [app.generate, metrics]
+      end
+    end
+  end
+end

data/bench/results/6daf8b8.md

@@ -0,0 +1,102 @@
+# Phase-1 dispatch benchmark
+
+Rack end-to-end time is the in-process request duration; server time excludes Rack::Test response handling.
+
+## ledger: create
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.072 | 0.160 | 0.072 | 0.160 | 140 | 0 | 0 | 1 | 7 / 356 | 1.00 |
+| legacy_full | 3.463 | 8.082 | 3.464 | 8.083 | 75444 | 0 | 2 | 1 | 430 / 442 | 538.89 |
+| named_full | 5.603 | 8.759 | 5.604 | 8.760 | 96075 | 0 | 1 | 1 | 430 / 442 | 686.25 |
+| named_fragments | 7.309 | 16.644 | 7.310 | 16.645 | 99327 | 0 | 1 | 1 | 431 / 444 | 709.48 |
+| update_filter | 7.304 | 15.314 | 7.306 | 15.316 | 99680 | 0 | 1 | 1 | 432 / 445 | 712.00 |
+
+**FAIL** — `named_fragments` response 99327 B <= 1.20 × baseline 140 B (168.0 B).
+
+**FAIL** — `update_filter` response 99680 B <= 1.20 × baseline 140 B (168.0 B).
+
+## ledger: edit
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.074 | 0.099 | 0.074 | 0.099 | 147 | 0 | 0 | 1 | 7 / 356 | 1.00 |
+| legacy_full | 5.166 | 7.880 | 5.168 | 7.881 | 74037 | 0 | 2 | 1 | 422 / 442 | 503.65 |
+| named_full | 7.925 | 10.217 | 7.926 | 10.218 | 94271 | 0 | 1 | 1 | 422 / 442 | 641.30 |
+| named_fragments | 9.109 | 13.200 | 9.110 | 13.202 | 95467 | 0 | 1 | 1 | 414 / 444 | 649.44 |
+| update_filter | 9.437 | 11.729 | 9.438 | 11.730 | 95820 | 0 | 1 | 1 | 415 / 445 | 651.84 |
+
+**FAIL** — `named_fragments` response 95467 B <= 1.20 × baseline 147 B (176.4 B).
+
+**FAIL** — `update_filter` response 95820 B <= 1.20 × baseline 147 B (176.4 B).
+
+## ledger: validation
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.068 | 0.075 | 0.068 | 0.075 | 100 | 0 | 0 | 1 | 4 / 356 | 1.00 |
+| legacy_full | 5.987 | 10.311 | 5.987 | 10.313 | 74061 | 0 | 2 | 1 | 422 / 442 | 740.61 |
+| named_full | 10.815 | 16.052 | 10.816 | 16.053 | 94295 | 0 | 1 | 1 | 422 / 442 | 942.95 |
+| named_fragments | 9.625 | 13.420 | 9.625 | 13.420 | 2083 | 0 | 1 | 1 | 9 / 444 | 20.83 |
+| update_filter | 10.424 | 15.887 | 10.425 | 15.888 | 2083 | 0 | 1 | 1 | 9 / 445 | 20.83 |
+
+**FAIL** — `named_fragments` response 2083 B <= 1.20 × baseline 100 B (120.0 B).
+
+**FAIL** — `update_filter` response 2083 B <= 1.20 × baseline 100 B (120.0 B).
+
+## ledger: filter
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.093 | 0.137 | 0.093 | 0.137 | 175 | 15 | 0 | 1 | 8 / 356 | 1.00 |
+| legacy_full | 5.587 | 8.797 | 5.588 | 8.798 | 8427 | 15 | 1 | 0 | 30 / 442 | 48.15 |
+| named_full | 6.568 | 10.267 | 6.569 | 10.268 | 9110 | 15 | 1 | 0 | 30 / 442 | 52.06 |
+| named_fragments | 6.447 | 9.268 | 6.448 | 9.269 | 9412 | 15 | 1 | 0 | 32 / 444 | 53.78 |
+| update_filter | 7.679 | 15.253 | 7.681 | 15.253 | 9774 | 15 | 1 | 1 | 33 / 445 | 55.85 |
+
+**FAIL** — `named_fragments` response 9412 B <= 1.20 × baseline 175 B (210.0 B).
+
+**FAIL** — `update_filter` response 9774 B <= 1.20 × baseline 175 B (210.0 B).
+
+## ledger: delete
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.064 | 0.068 | 0.064 | 0.069 | 0 | 0 | 0 | 1 | 0 / 356 | Inf |
+| legacy_full | 9.806 | 13.792 | 9.808 | 13.793 | 72607 | 0 | 2 | 1 | 414 / 442 | Inf |
+| named_full | 15.270 | 20.859 | 15.271 | 20.861 | 92447 | 0 | 1 | 1 | 414 / 442 | Inf |
+| named_fragments | 15.908 | 23.024 | 15.910 | 23.026 | 93583 | 0 | 1 | 1 | 406 / 444 | Inf |
+| update_filter | 17.374 | 26.321 | 17.375 | 26.322 | 93936 | 0 | 1 | 1 | 407 / 445 | Inf |
+
+**FAIL** — `named_fragments` response 93583 B <= 1.20 × baseline 0 B (0.0 B).
+
+**FAIL** — `update_filter` response 93936 B <= 1.20 × baseline 0 B (0.0 B).
+
+## warroom: note_append
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.067 | 0.074 | 0.067 | 0.074 | 147 | 0 | 0 | 1 | 6 / 23 | 1.00 |
+| legacy_full | 10.135 | 17.264 | 10.136 | 17.266 | 2549 | 0 | 2 | 1 | 26 / 45 | 17.34 |
+| named_full | 14.052 | 19.983 | 14.053 | 19.985 | 2928 | 0 | 1 | 1 | 26 / 45 | 19.92 |
+| named_fragments | 16.454 | 47.339 | 16.455 | 47.342 | 2635 | 0 | 1 | 1 | 10 / 47 | 17.93 |
+| named_fragments_oob | 15.482 | 22.797 | 15.483 | 22.799 | 2654 | 0 | 1 | 1 | 10 / 47 | 18.05 |
+
+**FAIL** — `named_fragments` response 2635 B <= 1.20 × baseline 147 B (176.4 B).
+
+**FAIL** — `named_fragments_oob` response 2654 B <= 1.20 × baseline 147 B (176.4 B).
+
+## warroom: column_move
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.075 | 0.082 | 0.075 | 0.082 | 370 | 0 | 0 | 1 | 12 / 23 | 1.00 |
+| legacy_full | 11.041 | 16.529 | 11.041 | 16.530 | 2514 | 0 | 2 | 1 | 25 / 45 | 6.79 |
+| named_full | 15.912 | 21.876 | 15.913 | 21.877 | 2893 | 0 | 1 | 1 | 25 / 45 | 7.82 |
+| named_fragments | 17.256 | 23.950 | 17.258 | 23.952 | 2600 | 0 | 1 | 1 | 9 / 47 | 7.03 |
+| named_fragments_oob | 18.317 | 28.865 | 18.318 | 28.866 | 3107 | 0 | 1 | 1 | 26 / 47 | 8.40 |
+
+**FAIL** — `named_fragments` response 2600 B <= 1.20 × baseline 370 B (444.0 B).
+
+**FAIL** — `named_fragments_oob` response 3107 B <= 1.20 × baseline 370 B (444.0 B).
+

data/bench/results/c8d749b.md

@@ -0,0 +1,102 @@
+# Phase-1 dispatch benchmark
+
+Rack end-to-end time is the in-process request duration; server time excludes Rack::Test response handling.
+
+## ledger: create
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.069 | 0.185 | 0.069 | 0.186 | 140 | 0 | 0 | 1 | 7 / 356 | 1.00 |
+| legacy_full | 3.343 | 10.680 | 3.344 | 10.681 | 71179 | 0 | 2 | 1 | 430 / 442 | 508.42 |
+| named_full | 5.424 | 7.052 | 5.425 | 7.052 | 91810 | 0 | 1 | 1 | 430 / 442 | 655.79 |
+| named_fragments | 7.190 | 11.612 | 7.191 | 11.614 | 95062 | 0 | 1 | 1 | 431 / 444 | 679.01 |
+| update_filter | 7.456 | 14.048 | 7.457 | 14.049 | 95415 | 0 | 1 | 1 | 432 / 445 | 681.54 |
+
+**FAIL** — `named_fragments` response 95062 B <= 1.20 × baseline 140 B (168.0 B).
+
+**FAIL** — `update_filter` response 95415 B <= 1.20 × baseline 140 B (168.0 B).
+
+## ledger: edit
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.072 | 0.154 | 0.072 | 0.154 | 147 | 0 | 0 | 1 | 7 / 356 | 1.00 |
+| legacy_full | 5.223 | 16.443 | 5.225 | 16.445 | 69848 | 0 | 2 | 1 | 422 / 442 | 475.16 |
+| named_full | 7.716 | 13.097 | 7.717 | 13.099 | 90082 | 0 | 1 | 1 | 422 / 442 | 612.80 |
+| named_fragments | 9.392 | 12.408 | 9.394 | 12.409 | 91278 | 0 | 1 | 1 | 414 / 444 | 620.94 |
+| update_filter | 9.289 | 12.532 | 9.290 | 12.534 | 91631 | 0 | 1 | 1 | 415 / 445 | 623.34 |
+
+**FAIL** — `named_fragments` response 91278 B <= 1.20 × baseline 147 B (176.4 B).
+
+**FAIL** — `update_filter` response 91631 B <= 1.20 × baseline 147 B (176.4 B).
+
+## ledger: validation
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.072 | 0.179 | 0.072 | 0.180 | 100 | 0 | 0 | 1 | 4 / 356 | 1.00 |
+| legacy_full | 6.742 | 10.122 | 6.743 | 10.124 | 69876 | 0 | 2 | 1 | 422 / 442 | 698.76 |
+| named_full | 10.619 | 15.149 | 10.621 | 15.151 | 90110 | 0 | 1 | 1 | 422 / 442 | 901.10 |
+| named_fragments | 9.460 | 15.436 | 9.462 | 15.438 | 2100 | 0 | 1 | 1 | 9 / 444 | 21.00 |
+| update_filter | 9.434 | 12.735 | 9.434 | 12.736 | 2100 | 0 | 1 | 1 | 9 / 445 | 21.00 |
+
+**FAIL** — `named_fragments` response 2100 B <= 1.20 × baseline 100 B (120.0 B).
+
+**FAIL** — `update_filter` response 2100 B <= 1.20 × baseline 100 B (120.0 B).
+
+## ledger: filter
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.105 | 0.294 | 0.105 | 0.295 | 175 | 15 | 0 | 1 | 8 / 356 | 1.00 |
+| legacy_full | 7.487 | 13.387 | 7.487 | 13.390 | 4242 | 15 | 1 | 0 | 30 / 442 | 24.24 |
+| named_full | 7.067 | 12.082 | 7.069 | 12.082 | 4925 | 15 | 1 | 0 | 30 / 442 | 28.14 |
+| named_fragments | 6.660 | 9.655 | 6.661 | 9.655 | 5227 | 15 | 1 | 0 | 32 / 444 | 29.87 |
+| update_filter | 7.808 | 12.616 | 7.810 | 12.618 | 5589 | 15 | 1 | 1 | 33 / 445 | 31.94 |
+
+**FAIL** — `named_fragments` response 5227 B <= 1.20 × baseline 175 B (210.0 B).
+
+**FAIL** — `update_filter` response 5589 B <= 1.20 × baseline 175 B (210.0 B).
+
+## ledger: delete
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.066 | 0.081 | 0.066 | 0.082 | 0 | 0 | 0 | 1 | 0 / 356 | Inf |
+| legacy_full | 10.433 | 16.797 | 10.434 | 16.798 | 68505 | 0 | 2 | 1 | 414 / 442 | Inf |
+| named_full | 14.991 | 21.514 | 14.994 | 21.515 | 88345 | 0 | 1 | 1 | 414 / 442 | Inf |
+| named_fragments | 16.332 | 23.606 | 16.334 | 23.607 | 89481 | 0 | 1 | 1 | 406 / 444 | Inf |
+| update_filter | 16.146 | 23.649 | 16.147 | 23.650 | 89834 | 0 | 1 | 1 | 407 / 445 | Inf |
+
+**FAIL** — `named_fragments` response 89481 B <= 1.20 × baseline 0 B (0.0 B).
+
+**FAIL** — `update_filter` response 89834 B <= 1.20 × baseline 0 B (0.0 B).
+
+## warroom: note_append
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.069 | 0.425 | 0.069 | 0.425 | 147 | 0 | 0 | 1 | 6 / 23 | 1.00 |
+| legacy_full | 10.179 | 17.379 | 10.181 | 17.380 | 1723 | 0 | 2 | 1 | 26 / 45 | 11.72 |
+| named_full | 14.862 | 22.651 | 14.863 | 22.652 | 2102 | 0 | 1 | 1 | 26 / 45 | 14.30 |
+| named_fragments | 15.308 | 26.121 | 15.310 | 26.123 | 1795 | 0 | 1 | 1 | 10 / 47 | 12.21 |
+| named_fragments_oob | 15.934 | 23.927 | 15.936 | 23.927 | 1814 | 0 | 1 | 1 | 10 / 47 | 12.34 |
+
+**FAIL** — `named_fragments` response 1795 B <= 1.20 × baseline 147 B (176.4 B).
+
+**FAIL** — `named_fragments_oob` response 1814 B <= 1.20 × baseline 147 B (176.4 B).
+
+## warroom: column_move
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.074 | 0.400 | 0.075 | 0.400 | 370 | 0 | 0 | 1 | 12 / 23 | 1.00 |
+| legacy_full | 11.895 | 17.866 | 11.897 | 17.867 | 1703 | 0 | 2 | 1 | 25 / 45 | 4.60 |
+| named_full | 16.398 | 21.608 | 16.398 | 21.610 | 2082 | 0 | 1 | 1 | 25 / 45 | 5.63 |
+| named_fragments | 17.878 | 23.662 | 17.879 | 23.662 | 1775 | 0 | 1 | 1 | 9 / 47 | 4.80 |
+| named_fragments_oob | 17.959 | 25.112 | 17.961 | 25.113 | 2282 | 0 | 1 | 1 | 26 / 47 | 6.17 |
+
+**FAIL** — `named_fragments` response 1775 B <= 1.20 × baseline 370 B (444.0 B).
+
+**FAIL** — `named_fragments_oob` response 2282 B <= 1.20 × baseline 370 B (444.0 B).
+

data/bench/results/eb06ab9.md

@@ -0,0 +1,102 @@
+# Phase-1 dispatch benchmark
+
+Rack end-to-end time is the in-process request duration; server time excludes Rack::Test response handling.
+
+## ledger: create
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.077 | 0.141 | 0.077 | 0.142 | 140 | 0 | 0 | 1 | 7 / 356 | 1.00 |
+| legacy_full | 3.287 | 9.863 | 3.288 | 9.864 | 72463 | 0 | 2 | 1 | 430 / 442 | 517.59 |
+| named_full | 4.837 | 7.102 | 4.838 | 7.102 | 93094 | 0 | 1 | 1 | 430 / 442 | 664.96 |
+| named_fragments | 3.795 | 5.566 | 3.795 | 5.568 | 3945 | 0 | 1 | 1 | 17 / 444 | 28.18 |
+| update_filter | 4.274 | 6.624 | 4.275 | 6.624 | 3945 | 0 | 1 | 1 | 17 / 445 | 28.18 |
+
+**PASS** — `named_fragments` response 3945 B <= 1.20 × baseline 140 B (168.0 B) or <= 8192 B floor.
+
+**PASS** — `update_filter` response 3945 B <= 1.20 × baseline 140 B (168.0 B) or <= 8192 B floor.
+
+## ledger: edit
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.074 | 0.109 | 0.075 | 0.110 | 147 | 0 | 0 | 1 | 7 / 356 | 1.00 |
+| legacy_full | 4.771 | 7.026 | 4.772 | 7.027 | 71107 | 0 | 2 | 1 | 422 / 442 | 483.72 |
+| named_full | 7.445 | 10.962 | 7.446 | 10.963 | 91341 | 0 | 1 | 1 | 422 / 442 | 621.37 |
+| named_fragments | 6.711 | 10.778 | 6.711 | 10.778 | 1999 | 0 | 1 | 1 | 9 / 444 | 13.60 |
+| update_filter | 7.403 | 10.551 | 7.404 | 10.552 | 1999 | 0 | 1 | 1 | 9 / 445 | 13.60 |
+
+**PASS** — `named_fragments` response 1999 B <= 1.20 × baseline 147 B (176.4 B) or <= 8192 B floor.
+
+**PASS** — `update_filter` response 1999 B <= 1.20 × baseline 147 B (176.4 B) or <= 8192 B floor.
+
+## ledger: validation
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.070 | 0.096 | 0.070 | 0.096 | 100 | 0 | 0 | 1 | 4 / 356 | 1.00 |
+| legacy_full | 5.332 | 8.063 | 5.332 | 8.065 | 71135 | 0 | 2 | 1 | 422 / 442 | 711.35 |
+| named_full | 9.938 | 16.164 | 9.939 | 16.166 | 91369 | 0 | 1 | 1 | 422 / 442 | 913.69 |
+| named_fragments | 10.268 | 16.219 | 10.269 | 16.220 | 2100 | 0 | 1 | 1 | 9 / 444 | 21.00 |
+| update_filter | 12.519 | 20.038 | 12.520 | 20.040 | 2100 | 0 | 1 | 1 | 9 / 445 | 21.00 |
+
+**PASS** — `named_fragments` response 2100 B <= 1.20 × baseline 100 B (120.0 B) or <= 8192 B floor.
+
+**PASS** — `update_filter` response 2100 B <= 1.20 × baseline 100 B (120.0 B) or <= 8192 B floor.
+
+## ledger: filter
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.094 | 0.223 | 0.094 | 0.223 | 175 | 15 | 0 | 1 | 8 / 356 | 1.00 |
+| legacy_full | 5.048 | 10.228 | 5.049 | 10.230 | 4284 | 15 | 1 | 0 | 30 / 442 | 24.48 |
+| named_full | 5.947 | 9.940 | 5.947 | 9.941 | 4967 | 15 | 1 | 0 | 30 / 442 | 28.38 |
+| named_fragments | 6.432 | 10.047 | 6.433 | 10.047 | 5289 | 15 | 1 | 0 | 32 / 444 | 30.22 |
+| update_filter | 6.812 | 12.296 | 6.814 | 12.298 | 5651 | 15 | 1 | 1 | 33 / 445 | 32.29 |
+
+**PASS** — `named_fragments` response 5289 B <= 1.20 × baseline 175 B (210.0 B) or <= 8192 B floor.
+
+**PASS** — `update_filter` response 5651 B <= 1.20 × baseline 175 B (210.0 B) or <= 8192 B floor.
+
+## ledger: delete
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.072 | 0.114 | 0.072 | 0.115 | 0 | 0 | 0 | 1 | 0 / 356 | Inf |
+| legacy_full | 9.727 | 16.812 | 9.729 | 16.814 | 69740 | 0 | 2 | 1 | 414 / 442 | Inf |
+| named_full | 17.151 | 21.766 | 17.152 | 21.768 | 89580 | 0 | 1 | 1 | 414 / 442 | Inf |
+| named_fragments | 16.349 | 21.140 | 16.351 | 21.141 | 172 | 0 | 1 | 1 | 1 / 444 | Inf |
+| update_filter | 14.547 | 19.288 | 14.548 | 19.289 | 172 | 0 | 1 | 1 | 1 / 445 | Inf |
+
+**PASS** — `named_fragments` response 172 B <= 1.20 × baseline 0 B (0.0 B) or <= 8192 B floor.
+
+**PASS** — `update_filter` response 172 B <= 1.20 × baseline 0 B (0.0 B) or <= 8192 B floor.
+
+## warroom: note_append
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.068 | 0.138 | 0.068 | 0.138 | 147 | 0 | 0 | 1 | 6 / 23 | 1.00 |
+| legacy_full | 9.103 | 14.929 | 9.103 | 14.931 | 1723 | 0 | 2 | 1 | 26 / 45 | 11.72 |
+| named_full | 14.339 | 18.781 | 14.340 | 18.782 | 2102 | 0 | 1 | 1 | 26 / 45 | 14.30 |
+| named_fragments | 16.124 | 22.015 | 16.126 | 22.016 | 1795 | 0 | 1 | 1 | 10 / 47 | 12.21 |
+| named_fragments_oob | 16.704 | 25.253 | 16.705 | 25.255 | 1814 | 0 | 1 | 1 | 10 / 47 | 12.34 |
+
+**PASS** — `named_fragments` response 1795 B <= 1.20 × baseline 147 B (176.4 B) or <= 8192 B floor.
+
+**PASS** — `named_fragments_oob` response 1814 B <= 1.20 × baseline 147 B (176.4 B) or <= 8192 B floor.
+
+## warroom: column_move
+
+| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| phlex_baseline | 0.077 | 0.163 | 0.077 | 0.164 | 370 | 0 | 0 | 1 | 12 / 23 | 1.00 |
+| legacy_full | 10.802 | 17.991 | 10.804 | 17.993 | 1703 | 0 | 2 | 1 | 25 / 45 | 4.60 |
+| named_full | 16.677 | 22.323 | 16.679 | 22.324 | 2082 | 0 | 1 | 1 | 25 / 45 | 5.63 |
+| named_fragments | 17.006 | 24.690 | 17.006 | 24.692 | 1775 | 0 | 1 | 1 | 9 / 47 | 4.80 |
+| named_fragments_oob | 18.229 | 26.563 | 18.231 | 26.564 | 2282 | 0 | 1 | 1 | 26 / 47 | 6.17 |
+
+**PASS** — `named_fragments` response 1775 B <= 1.20 × baseline 370 B (444.0 B) or <= 8192 B floor.
+
+**PASS** — `named_fragments_oob` response 2282 B <= 1.20 × baseline 370 B (444.0 B) or <= 8192 B floor.
+

data/bench/run.rb

@@ -0,0 +1,151 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+
+require "benchmark"
+require "fileutils"
+require "optparse"
+require_relative "fixtures/ledger"
+require_relative "fixtures/warroom"
+require_relative "baselines/ledger"
+require_relative "baselines/warroom"
+
+module StreamWeaverBench
+  Sample = Data.define(:server_ms, :rack_ms, :response_bytes, :request_bytes, :rebuilds, :callbacks, :changed_nodes, :full_nodes)
+
+  class Runner
+    ABSOLUTE_FLOOR_BYTES = 8_192
+
+    BASELINE_PATHS = {
+      ledger: { create: "/create", edit: "/edit", validation: "/invalid", filter: "/filter", delete: "/delete" },
+      warroom: { note_append: "/note", column_move: "/move" }
+    }.freeze
+    LABELS = { create: "Create", edit: "Edit", validation: "Invalid", delete: "Delete", note_append: "Append note", column_move: "Move story" }.freeze
+
+    def initialize(iterations:, warmups:, write: true)
+      @iterations = iterations
+      @warmups = warmups
+      @write = write
+    end
+
+    def run
+      lines = ["# Phase-1 dispatch benchmark", "", "Rack end-to-end time is the in-process request duration; server time excludes Rack::Test response handling.", ""]
+      run_fixture(:ledger, Fixtures::Ledger, Baselines::Ledger, lines)
+      run_fixture(:warroom, Fixtures::Warroom, Baselines::Warroom, lines)
+      report = lines.join("\n") + "\n"
+      puts report
+      write_report(report) if @write
+      report
+    end
+
+    private
+
+    def run_fixture(name, fixture, baseline, lines)
+      fixture::INTERACTIONS.each do |interaction|
+        baseline_samples = samples { measure_baseline(name, baseline, interaction) }
+        baseline_bytes = median(baseline_samples.map(&:response_bytes))
+        lines << "## #{name}: #{interaction}"
+        lines << ""
+        lines << "| variant | median server ms | p95 server ms | median rack ms | p95 rack ms | response bytes | request bytes | rebuilds | callbacks | changed nodes / full | vs-baseline ratio |"
+        lines << "|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|"
+        append_row(lines, "phlex_baseline", baseline_samples, baseline_bytes)
+        fixture::VARIANTS.each do |variant|
+          measured = samples { measure_streamweaver(fixture, variant, interaction) }
+          append_row(lines, variant, measured, baseline_bytes)
+        end
+        scoped_variants = fixture::VARIANTS.select { |variant| variant.to_s.include?("fragment") || variant == :update_filter }
+        scoped_variants.each do |variant|
+          measured = samples { measure_streamweaver(fixture, variant, interaction) }
+          bytes = median(measured.map(&:response_bytes))
+          lines << ""
+          # Gate: ratio <= 1.20x OR absolute floor 8KB. Sub-floor responses are below
+          # perceptual/network significance; ratios vs sub-200B surgical baselines
+          # measure granularity, not slowness (plan intent: kill whole-tree payloads).
+          passed = bytes <= baseline_bytes * 1.20 || bytes <= ABSOLUTE_FLOOR_BYTES
+          lines << "**#{passed ? 'PASS' : 'FAIL'}** — `#{variant}` response #{bytes} B <= 1.20 × baseline #{baseline_bytes} B (#{(baseline_bytes * 1.20).round(1)} B) or <= #{ABSOLUTE_FLOOR_BYTES} B floor."
+        end
+        lines << ""
+      end
+    end
+
+    def samples
+      @warmups.times { yield }
+      Array.new(@iterations) { yield }
+    end
+
+    def measure_baseline(name, baseline, interaction)
+      app, metrics = baseline.build
+      session = Rack::Test::Session.new(Rack::MockSession.new(app))
+      full_nodes = Html.node_count(session.get("/").body)
+      params = interaction == :filter ? { query: "Person 01" } : {}
+      path = BASELINE_PATHS.fetch(name).fetch(interaction)
+      metrics.reset!
+      response, rack_ms, server_ms = timed_request(session, path, params)
+      Sample.new(server_ms:, rack_ms:, response_bytes: response.body.bytesize,
+        request_bytes: Rack::Utils.build_nested_query(params).bytesize, rebuilds: 0,
+        callbacks: metrics.callbacks, changed_nodes: Html.node_count(response.body), full_nodes: full_nodes)
+    end
+
+    def measure_streamweaver(fixture, variant, interaction)
+      app, metrics = fixture.build(variant)
+      session = Rack::Test::Session.new(Rack::MockSession.new(app))
+      setup = session.get("/")
+      full_nodes = Html.node_count(setup.body)
+      params = {}
+      path = if interaction == :filter
+        params = { query: "Person 01" }
+        if variant == :update_filter
+          params[:_sw_fragment] = Html.fragment_token(setup.body) if Html.fragment_token(setup.body)
+          "/event/query"
+        else
+          "/update"
+        end
+      else
+        Html.action_path(setup.body, LABELS.fetch(interaction))
+      end
+      metrics.reset!
+      response, rack_ms, server_ms = timed_request(session, path, params)
+      raise "#{variant} #{interaction}: HTTP #{response.status}" unless response.ok?
+      Sample.new(server_ms:, rack_ms:, response_bytes: response.body.bytesize,
+        request_bytes: Rack::Utils.build_nested_query(params).bytesize, rebuilds: metrics.rebuilds,
+        callbacks: metrics.callbacks, changed_nodes: Html.node_count(response.body), full_nodes: full_nodes)
+    end
+
+    def timed_request(session, path, params)
+      started = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      response = nil
+      server_started = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      response = session.post(path, params, "HTTP_HX_REQUEST" => "true")
+      server_ms = (Process.clock_gettime(Process::CLOCK_MONOTONIC) - server_started) * 1000
+      rack_ms = (Process.clock_gettime(Process::CLOCK_MONOTONIC) - started) * 1000
+      [response, rack_ms, server_ms]
+    end
+
+    def append_row(lines, variant, values, baseline_bytes)
+      response_bytes = median(values.map(&:response_bytes))
+      lines << format("| %s | %.3f | %.3f | %.3f | %.3f | %d | %d | %d | %d | %d / %d | %.2f |",
+        variant, median(values.map(&:server_ms)), percentile(values.map(&:server_ms), 0.95),
+        median(values.map(&:rack_ms)), percentile(values.map(&:rack_ms), 0.95), response_bytes,
+        median(values.map(&:request_bytes)), median(values.map(&:rebuilds)), median(values.map(&:callbacks)),
+        median(values.map(&:changed_nodes)), median(values.map(&:full_nodes)), baseline_bytes.zero? ? Float::INFINITY : response_bytes.fdiv(baseline_bytes))
+    end
+
+    def median(values) = percentile(values, 0.50)
+    def percentile(values, fraction) = values.sort.fetch([(values.length * fraction).ceil - 1, 0].max)
+    def write_report(report)
+      sha = `git rev-parse --short HEAD`.strip
+      FileUtils.mkdir_p(File.expand_path("results", __dir__))
+      File.write(File.expand_path("results/#{sha}.md", __dir__), report)
+    end
+  end
+end
+
+options = { iterations: 30, warmups: 5, write: true }
+OptionParser.new do |parser|
+  parser.on("--iterations N", Integer) { |value| options[:iterations] = value }
+  parser.on("--warmups N", Integer) { |value| options[:warmups] = value }
+  parser.on("--no-write") { options[:write] = false }
+end.parse!
+abort "iterations must be positive" unless options[:iterations].positive?
+StreamWeaverBench::Runner.new(**options).run