Liam0205 · Liam0205 · Jul 16, 2026 · Jul 15, 2026 · Jul 15, 2026 · Jul 15, 2026
diff --git a/apple/_version.py b/apple/_version.py
@@ -1 +1 @@
-__version__ = "0.10.11"
+__version__ = "0.10.12"
diff --git a/apple_generated/operators.py b/apple_generated/operators.py
@@ -231,12 +231,14 @@ class RecallStaticOp(BaseOp):
     _name = "recall_static"
     _params_schema = {
         "items": {"type": "any", "required": True},
+        "set_common": {"type": "any", "required": False},
     }
 
     def __call__(
         self,
         *,
         items: Any = ...,
+        set_common: Any = None,
         common_input: list[str] | None = None,
         common_output: list[str] | None = None,
         item_input: list[str] | None = None,
@@ -250,6 +252,8 @@ def __call__(
         _params = {
             "items": items,
         }
+        if set_common is not None:
+            _params["set_common"] = set_common
         return self._apply(
             params=_params,
             common_input=common_input,

diff --git a/doc/operators/recall_static.md b/doc/operators/recall_static.md
@@ -9,6 +9,7 @@ Emits a configurable static set of items for testing and validation.
 | Name | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
 | items | any | Yes | - | JSON array of item maps to emit as candidates. |
+| set_common | any | No | - | JSON object of common fields the recall writes. |
 
 ## Metadata Contract
 
@@ -24,6 +25,7 @@ Emits a configurable static set of items for testing and validation.
 ```python
 flow.recall_static(
     items=...,
+    set_common=...,
     common_input=[...],
     item_input=[...],
     item_output=[...],

diff --git a/fixtures/benchmarks/large_0100_config.json b/fixtures/benchmarks/large_0100_config.json
@@ -1,5 +1,5 @@
 {
-  "_PINEAPPLE_VERSION": "0.10.11",
+  "_PINEAPPLE_VERSION": "0.10.12",
   "pipeline_config": {
     "operators": {
       "recall_a": {

diff --git a/fixtures/benchmarks/large_0500_config.json b/fixtures/benchmarks/large_0500_config.json
@@ -1,5 +1,5 @@
 {
-  "_PINEAPPLE_VERSION": "0.10.11",
+  "_PINEAPPLE_VERSION": "0.10.12",
   "pipeline_config": {
     "operators": {
       "recall_a": {

diff --git a/fixtures/benchmarks/large_1000_config.json b/fixtures/benchmarks/large_1000_config.json
@@ -1,5 +1,5 @@
 {
-  "_PINEAPPLE_VERSION": "0.10.11",
+  "_PINEAPPLE_VERSION": "0.10.12",
   "pipeline_config": {
     "operators": {
       "recall_a": {

diff --git a/fixtures/benchmarks/large_5000_config.json b/fixtures/benchmarks/large_5000_config.json
@@ -1,5 +1,5 @@
 {
-  "_PINEAPPLE_VERSION": "0.10.11",
+  "_PINEAPPLE_VERSION": "0.10.12",
   "pipeline_config": {
     "operators": {
       "recall_a": {

diff --git a/fixtures/benchmarks/medium_0100_config.json b/fixtures/benchmarks/medium_0100_config.json
@@ -1,5 +1,5 @@
 {
-  "_PINEAPPLE_VERSION": "0.10.11",
+  "_PINEAPPLE_VERSION": "0.10.12",
   "pipeline_config": {
     "operators": {
       "recall_a": {

diff --git a/fixtures/benchmarks/medium_0500_config.json b/fixtures/benchmarks/medium_0500_config.json
@@ -1,5 +1,5 @@
 {
-  "_PINEAPPLE_VERSION": "0.10.11",
+  "_PINEAPPLE_VERSION": "0.10.12",
   "pipeline_config": {
     "operators": {
       "recall_a": {

diff --git a/fixtures/benchmarks/medium_1000_config.json b/fixtures/benchmarks/medium_1000_config.json
@@ -1,5 +1,5 @@
 {
-  "_PINEAPPLE_VERSION": "0.10.11",
+  "_PINEAPPLE_VERSION": "0.10.12",
   "pipeline_config": {
     "operators": {
       "recall_a": {

diff --git a/fixtures/benchmarks/realistic_for_you_calibrated_2c4g_config.json b/fixtures/benchmarks/realistic_for_you_calibrated_2c4g_config.json
@@ -1,5 +1,5 @@
 {
-  "_PINEAPPLE_VERSION": "0.10.11",
+  "_PINEAPPLE_VERSION": "0.10.12",
   "_PINEAPPLE_CREATE_TIME": "2026-05-28T11:31:47Z",
   "pipeline_config": {
     "operators": {

diff --git a/fixtures/benchmarks/realistic_for_you_calibrated_config.json b/fixtures/benchmarks/realistic_for_you_calibrated_config.json
@@ -1,5 +1,5 @@
 {
-  "_PINEAPPLE_VERSION": "0.10.11",
+  "_PINEAPPLE_VERSION": "0.10.12",
   "_PINEAPPLE_CREATE_TIME": "2026-05-28T11:31:47Z",
   "pipeline_config": {
     "operators": {

diff --git a/fixtures/benchmarks/realistic_for_you_calibrated_itemlua_config.json b/fixtures/benchmarks/realistic_for_you_calibrated_itemlua_config.json
@@ -1,5 +1,5 @@
 {
-  "_PINEAPPLE_VERSION": "0.10.11",
+  "_PINEAPPLE_VERSION": "0.10.12",
   "_PINEAPPLE_CREATE_TIME": "2026-05-28T11:31:47Z",
   "pipeline_config": {
     "operators": {

diff --git a/fixtures/benchmarks/realistic_for_you_config.json b/fixtures/benchmarks/realistic_for_you_config.json
@@ -1,5 +1,5 @@
 {
-  "_PINEAPPLE_VERSION": "0.10.11",
+  "_PINEAPPLE_VERSION": "0.10.12",
   "_PINEAPPLE_CREATE_TIME": "2026-05-28T11:31:47Z",
   "pipeline_config": {
     "operators": {

diff --git a/fixtures/benchmarks/realistic_for_you_latency_config.json b/fixtures/benchmarks/realistic_for_you_latency_config.json
@@ -1,5 +1,5 @@
 {
-  "_PINEAPPLE_VERSION": "0.10.11",
+  "_PINEAPPLE_VERSION": "0.10.12",
   "_PINEAPPLE_CREATE_TIME": "2026-05-28T11:31:47Z",
   "pipeline_config": {
     "operators": {

diff --git a/fixtures/benchmarks/small_010_config.json b/fixtures/benchmarks/small_010_config.json
@@ -1,5 +1,5 @@
 {
-  "_PINEAPPLE_VERSION": "0.10.11",
+  "_PINEAPPLE_VERSION": "0.10.12",
   "pipeline_config": {
     "operators": {
       "recall": {

diff --git a/fixtures/benchmarks/small_050_config.json b/fixtures/benchmarks/small_050_config.json
@@ -1,5 +1,5 @@
 {
-  "_PINEAPPLE_VERSION": "0.10.11",
+  "_PINEAPPLE_VERSION": "0.10.12",
   "pipeline_config": {
     "operators": {
       "recall": {

diff --git a/fixtures/benchmarks/small_100_config.json b/fixtures/benchmarks/small_100_config.json
@@ -1,5 +1,5 @@
 {
-  "_PINEAPPLE_VERSION": "0.10.11",
+  "_PINEAPPLE_VERSION": "0.10.12",
   "pipeline_config": {
     "operators": {
       "recall": {

diff --git a/fixtures/pipelines/barrier_transform_reorder.json b/fixtures/pipelines/barrier_transform_reorder.json
@@ -1,7 +1,7 @@
 {
   "name": "barrier semantics (transform before reorder)",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "normalize_score": {

diff --git a/fixtures/pipelines/bench_cpu_work_parity.json b/fixtures/pipelines/bench_cpu_work_parity.json
@@ -1,7 +1,7 @@
 {
   "name": "transform_bench_cpu byte-identical work output across runtimes (M12)",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "bench": {

diff --git a/fixtures/pipelines/control_op_nil_field_no_crash.json b/fixtures/pipelines/control_op_nil_field_no_crash.json
@@ -1,7 +1,7 @@
 {
   "name": "control operator nil field does not crash — branch skipped",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "ctrl_if": {

diff --git a/fixtures/pipelines/data_parallel.json b/fixtures/pipelines/data_parallel.json
@@ -1,7 +1,7 @@
 {
   "name": "data_parallel transform (sharded item execution)",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "copy_tag": {

diff --git a/fixtures/pipelines/data_parallel_lua.json b/fixtures/pipelines/data_parallel_lua.json
@@ -1,7 +1,7 @@
 {
   "name": "data_parallel Lua transform (verify shard-independent computation)",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "recall_items": {

diff --git a/fixtures/pipelines/deeply_nested_subflow.json b/fixtures/pipelines/deeply_nested_subflow.json
@@ -1,7 +1,7 @@
 {
   "name": "deeply nested SubFlow (depth-3 expansion)",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "copy_tag": {

diff --git a/fixtures/pipelines/field_mode_nullable_vs_defaulted.json b/fixtures/pipelines/field_mode_nullable_vs_defaulted.json
@@ -1,7 +1,7 @@
 {
   "name": "three field modes — strict vs nullable vs defaulted",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "write_nil": {

diff --git a/fixtures/pipelines/field_mode_strict_nil_error.json b/fixtures/pipelines/field_mode_strict_nil_error.json
@@ -1,7 +1,7 @@
 {
   "name": "strict field mode — nil triggers error",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "write_nil": {

diff --git a/fixtures/pipelines/filter_removes_all.json b/fixtures/pipelines/filter_removes_all.json
@@ -1,7 +1,7 @@
 {
   "name": "filter_condition removes all items — empty result",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "remove_banned": {

diff --git a/fixtures/pipelines/implicit_row_set_filter_common_then_item.json b/fixtures/pipelines/implicit_row_set_filter_common_then_item.json
@@ -1,7 +1,7 @@
 {
   "name": "implicit row-set: filter → common-only → item-field transform",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "recall_items": {

diff --git a/fixtures/pipelines/implicit_row_set_filter_then_common_only.json b/fixtures/pipelines/implicit_row_set_filter_then_common_only.json
@@ -1,7 +1,7 @@
 {
   "name": "implicit row-set: filter then common-only transform (no dependency needed)",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "recall_items": {

diff --git a/fixtures/pipelines/implicit_row_set_filter_then_item.json b/fixtures/pipelines/implicit_row_set_filter_then_item.json
@@ -1,7 +1,7 @@
 {
   "name": "implicit row-set: filter then item-field transform (no field overlap)",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "recall_items": {

diff --git a/fixtures/pipelines/lua_e2e_conditional_sort.json b/fixtures/pipelines/lua_e2e_conditional_sort.json
@@ -1,7 +1,7 @@
 {
   "name": "Lua E2E: recall → discount → stats → conditional sort",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "recall_items": {

diff --git a/fixtures/pipelines/multi_recall_row_set_ordering.json b/fixtures/pipelines/multi_recall_row_set_ordering.json
@@ -2,7 +2,7 @@
   "name": "multi-recall row-set ordering (ConsumesRowSet semantics)",
   "description": "Regression test for differential fuzz divergence #945: operators between recalls must wait for preceding recall via ConsumesRowSet before iterating items.",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "recall_a": {

diff --git a/fixtures/pipelines/multi_skip.json b/fixtures/pipelines/multi_skip.json
@@ -1,7 +1,7 @@
 {
   "name": "multiple independent skip flags",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "copy_tag": {

diff --git a/fixtures/pipelines/nested_subflow.json b/fixtures/pipelines/nested_subflow.json
@@ -1,7 +1,7 @@
 {
   "name": "nested SubFlow pipeline",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "copy_tag": {

diff --git a/fixtures/pipelines/nullable_field_pass_through.json b/fixtures/pipelines/nullable_field_pass_through.json
@@ -1,7 +1,7 @@
 {
   "name": "nullable field mode — explicit nil pass-through vs missing error",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "set_nil": {

diff --git a/fixtures/pipelines/recall_merge_filter_sort.json b/fixtures/pipelines/recall_merge_filter_sort.json
@@ -1,7 +1,7 @@
 {
   "name": "recall → merge → filter → sort (full pipeline)",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "recall_hot": {

diff --git a/fixtures/pipelines/recall_rank_truncate.json b/fixtures/pipelines/recall_rank_truncate.json
@@ -1,7 +1,7 @@
 {
   "name": "recall → lua scoring → sort → truncate (recommendation pipeline)",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "recall_candidates": {

diff --git a/fixtures/pipelines/reorder_topn_boost_parity.json b/fixtures/pipelines/reorder_topn_boost_parity.json
@@ -2,7 +2,7 @@
   "name": "reorder_topn_boost byte-identical reorder output across runtimes (H8)",
   "requires": ["bench"],
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "boost": {

diff --git a/fixtures/pipelines/resource_operators.json b/fixtures/pipelines/resource_operators.json
@@ -13,7 +13,7 @@
     ]
   },
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "recall_hot": {

diff --git a/fixtures/pipelines/size_dispatch_truncate.json b/fixtures/pipelines/size_dispatch_truncate.json
@@ -1,7 +1,7 @@
 {
   "name": "transform_size → dispatch → truncate (common↔item interaction)",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "count_items": {

diff --git a/fixtures/pipelines/skip_branch.json b/fixtures/pipelines/skip_branch.json
@@ -1,7 +1,7 @@
 {
   "name": "skip/branch via Lua control flag",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "set_flag": {

diff --git a/fixtures/pipelines/subflow_if_else_control_flow.json b/fixtures/pipelines/subflow_if_else_control_flow.json
@@ -1,7 +1,7 @@
 {
   "name": "SubFlow if/else control flow with namespaced fields",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "my_sf::if_1": {

diff --git a/fixtures/pipelines/transform_then_filter.json b/fixtures/pipelines/transform_then_filter.json
@@ -1,7 +1,7 @@
 {
   "name": "transform_copy then filter_truncate",
   "config": {
-    "_PINEAPPLE_VERSION": "0.10.11",
+    "_PINEAPPLE_VERSION": "0.10.12",
     "pipeline_config": {
       "operators": {
         "copy_score": {

diff --git a/llmdoc/architecture/dag-engine.md b/llmdoc/architecture/dag-engine.md
@@ -538,7 +538,7 @@ RowFrame 与 ColumnFrame 必须保持稀疏字段语义一致：某一 item 未
 
 | 算子类型 | 运行时角色 | 允许的输出方法 | 行集标记 |
 |---|---|---|---|
-| Recall | 产生新 item | 仅 `AddItem` | AdditiveWritesRowSet |
+| Recall | 产生新 item，可选写 common | `AddItem`、`SetCommon` | AdditiveWritesRowSet |
 | Transform | 变异字段值 | `SetCommon`、`SetItem` | 有 item 字段时自动注入 `_row_set_` 读；仅当 metadata 中 item 字段为空但仍结构性访问行集时需显式 ConsumesRowSet |
 | Filter | 移除行 | 仅 `RemoveItem` | ConsumesRowSet + MutatesRowSet |
 | Merge | 合并或去重行集 | `SetItem`、`RemoveItem` | ConsumesRowSet + MutatesRowSet |

diff --git a/llmdoc/reference/operator-contract.md b/llmdoc/reference/operator-contract.md
@@ -389,7 +389,7 @@ C++ 侧 `OperatorInput`（`include/pine/operator_input.hpp`）是 Frame + InputF
 - **整列或全无**：`len(vals)` 必须等于 frame 当时的 item 数，不匹配报 `SetItemColumnFloat64 "f" length N does not match item count M`（跨引擎字节一致）
 - **NaN/Inf 批量校验**先于任何写入（单次列写全有或全无），首错消息与逐元素路径相同：`item[i] write: field "f": NaN/Inf is not a valid JSON value`
 - **所有权转移**：apply 时列存 frame 直接 adopt 底层数组为列存储（零拷贝，全槽位 present，typed 读快路径可命中）；行存 frame 在一个锁窗口内逐行 scatter（装箱不可避免）。算子交出后**不得再读写该数组**
-- 对 `ValidateOutput` 计为 `SetItem`（Transform/Filter 可用，Recall 违规）；debug 快照折叠进 `item_writes` 视图；data_parallel 分片的列写由 merge 折叠为带 offset 的逐元素写（分片是窗口，无法 adopt）
+- 对 `ValidateOutput` 计为 `SetItem`（Transform 可用，Recall/Filter/Observe 等非 item-write 类型违规）；debug 快照折叠进 `item_writes` 视图；data_parallel 分片的列写由 merge 折叠为带 offset 的逐元素写（分片是窗口，无法 adopt）
 
 算子作者指引：整列计算型算子（normalize 等）优先用批量写；稀疏/条件写仍用 `SetItem`。Go 侧校验注意：不要用 `validateValue(field, any(v))` 逐元素校验——`any` 转换每元素装箱一次，吃掉批量写的收益；直接内联 `math.IsNaN/IsInf`。
 
@@ -399,7 +399,7 @@ C++ 侧 `OperatorInput`（`include/pine/operator_input.hpp`）是 Frame + InputF
 
 | 类型 | 预期角色 | 允许的输出方法 |
 |---|---|---|
-| Recall | 产生新行/item | `AddItem` |
+| Recall | 产生新行/item，可选写 common | `AddItem`、`SetCommon` |
 | Transform | 变异 common 或 item 字段值 | `SetCommon`、`SetItem` |
 | Filter | 移除行/item | `RemoveItem` |
 | Merge | 合并/去重行集 | `SetItem`、`RemoveItem` |