Skip to content

Action Outcome Operational Placement 012 - Raw Research Artifact

Generated at: 2026-06-21T10:56:16Z Coordinator endpoint: http://127.0.0.1:19241/ SQL seed: docs/research/results/action_outcome_sql_replay_006.sql Node IDs: 1, 8

  • Explicit placement policy status: pass
  • Seed row-count status: pass
  • Vendor table row-count status: pass
  • Distributed ingest status: pass
  • Full SQL/JOIN/window status: pass
  • Small-table JOIN telemetry status: pass
  • Prometheus telemetry status: pass
  • Overall Experiment 012 status: pass

Classification: experimental runtime path.

This result validates the bounded Action-Outcome operational-table placement and JOIN replay hypothesis. It does not promote runtime table placement, bounded small-table JOIN, or full-data window materialization into broad product contracts. Devlog 217 adds persisted placement metadata and coordinator restart re-apply. Promotion still requires rebalance semantics, explicit limits, and operator guidance as defined in docs/research/EXPERIMENT_GOVERNANCE.md.

TablePolicyNodePurposeAPI Status
action_outcome_vendor_queries_010pinned_node8query controls co-located with recommendations200 / {"node_id": 8, "ok": true, "policy": "pinned_node", "table": "action_outcome_vendor_queries_010"}
action_outcome_vendor_recommendations_010pinned_node8action priors and recommendations200 / {"node_id": 8, "ok": true, "policy": "pinned_node", "table": "action_outcome_vendor_recommendations_010"}
action_outcome_vendor_retrieval_010pinned_node8retrieval evidence200 / {"node_id": 8, "ok": true, "policy": "pinned_node", "table": "action_outcome_vendor_retrieval_010"}
action_outcome_vendor_suppressions_010pinned_node1bounded suppression/control table200 / {"node_id": 1, "ok": true, "policy": "pinned_node", "table": "action_outcome_vendor_suppressions_010"}
Node IDStats URLticks_ingestedticks_storedticks_droppedpartitions_created
1http://127.0.0.1:19241/stats16116104
8http://127.0.0.1:19242/stats20820805
TableStable table_idOwner nodeRows
action_outcome_episode_metrics571721101
action_outcome_episodes3679832
action_outcome_gate_suppressions16692121
action_outcome_replay_recommendations9749118
action_outcome_retrieval_quality_labels37786826
action_outcome_vendor_queries_0105887986
action_outcome_vendor_recommendations_01032465872
action_outcome_vendor_retrieval_01052359872
action_outcome_vendor_suppressions_01058120121
CheckLeft/table ownerRight ownerRowsExpectedStatus
failed_repeat_joinaction_outcome_vendor_recommendations_010 -> 8action_outcome_vendor_queries_010 -> 855pass
context_top_action_joinaction_outcome_vendor_recommendations_010 -> 8action_outcome_vendor_queries_010 -> 866pass
suppression_joinaction_outcome_vendor_suppressions_010 -> 1action_outcome_vendor_recommendations_010 -> 82121pass
misleading_retrieval_joinaction_outcome_vendor_retrieval_010 -> 8action_outcome_vendor_queries_010 -> 82323pass
row_number_windowaction_outcome_vendor_recommendations_010 -> 8n/a7272pass
lag_windowaction_outcome_vendor_recommendations_010 -> 8n/a7272pass
Counter/GaugeBeforeAfterDelta
accepted044
candidates044
errors000
last_left_rows07272
last_right_rows066
rejected_row_cap000
rows_materialized0327327
MetricValue
zepto_small_table_join_candidates_total4
zepto_small_table_join_accepted_total4
zepto_small_table_join_row_cap_rejections_total0
zepto_small_table_join_errors_total0
zepto_small_table_join_rows_materialized_total327
zepto_small_table_join_last_left_rows72
zepto_small_table_join_last_right_rows6

Experiment 012 turns operational-table distribution from an implicit table-id hash side effect into an explicit control-plane policy. The Action-Outcome query, recommendation, and retrieval tables are pinned to node 8 while the bounded suppression/control table is pinned to node 1. This deliberately keeps the suppression JOIN cross-node while preserving correctness through the bounded small-table hash JOIN path.

The commercial value is observability plus a narrow guarantee: operators can place small Action-Outcome control tables intentionally, then verify that coordinator-local JOIN replay stayed inside the row cap and did not silently fall back to an unbounded distributed planner.

Devlog 217 promotes placement policy from an admin-only runtime knob to a persisted table option/catalog record. The next best step is a row-cap alerting example for zepto_small_table_join_row_cap_rejections_total.