nested state path

tests/authoring/test_ops.py

@@ -268,7 +268,10 @@ def test_project_fields_selects_named_keys() -> None:
     registry = build_registry(project_fields)
 
     result = registry["authoring.project_fields"](
-        {"mapping": {"status": "done", "message": "ok", "debug": True}, "fields": ["status", "message"]},
+        {
+            "mapping": {"status": "done", "message": "ok", "debug": True},
+            "fields": ["status", "message"],
+        },
         RuntimeContext(current_node_id="project_fields"),
     )
 
@@ -282,7 +285,10 @@ def test_rename_fields_remaps_existing_keys() -> None:
     registry = build_registry(rename_fields)
 
     result = registry["authoring.rename_fields"](
-        {"mapping": {"provider_status": "done", "provider_message": "ok"}, "renames": {"provider_status": "status", "provider_message": "message"}},
+        {
+            "mapping": {"provider_status": "done", "provider_message": "ok"},
+            "renames": {"provider_status": "status", "provider_message": "message"},
+        },
         RuntimeContext(current_node_id="rename_fields"),
     )
 

tests/core/test_mapping_validation.py

@@ -21,7 +21,9 @@ def test_validation_rejects_overlapping_node_input_destinations() -> None:
         out_map={},
     ).validate_structure()
 
-    assert any("overlapping node-local input paths" in issue.message for issue in report.errors)
+    assert any(
+        "overlapping node-local input paths" in issue.message for issue in report.errors
+    )
 
 
 def test_validation_rejects_overlapping_state_write_destinations() -> None:
@@ -33,7 +35,10 @@ def test_validation_rejects_overlapping_state_write_destinations() -> None:
         },
     ).validate_structure()
 
-    assert any("overlapping state destination paths" in issue.message for issue in report.errors)
+    assert any(
+        "overlapping state destination paths" in issue.message
+        for issue in report.errors
+    )
 
 
 def _workflow(*, in_map: dict[str, str], out_map: dict[str, str]) -> Workflow:

tests/core/test_nested_state_paths.py

@@ -0,0 +1,48 @@
+from __future__ import annotations
+
+from wf_core import SchemaRef, StateField, StateSchema, Workflow
+from wf_core.runtime.ops.state import write_state_value
+
+
+def test_exact_nested_state_path_uses_declared_merge_strategy() -> None:
+    workflow = _workflow(
+        fields={"person.tags": StateField(type="array", merge_strategy="append")}
+    )
+    state = {"person": {"tags": ["seed"]}}
+
+    write_state_value(workflow, state, "state.person.tags", ["next"])
+
+    assert state["person"]["tags"] == ["seed", "next"]
+
+
+def test_parent_state_declaration_does_not_apply_to_nested_write() -> None:
+    workflow = _workflow(
+        fields={"person": StateField(type="object", merge_strategy="merge_object")}
+    )
+    state = {"person": {"tags": ["seed"]}}
+
+    write_state_value(workflow, state, "state.person.tags", ["next"])
+
+    assert state["person"]["tags"] == ["next"]
+
+
+def test_undeclared_nested_state_path_defaults_to_replace() -> None:
+    workflow = _workflow(fields={})
+    state = {"person": {"tags": ["seed"]}}
+
+    write_state_value(workflow, state, "state.person.tags", ["next"])
+
+    assert state["person"]["tags"] == ["next"]
+
+
+def _workflow(*, fields: dict[str, StateField]) -> Workflow:
+    return Workflow(
+        name="nested_state_paths",
+        input_schema=SchemaRef(type="object", properties={}),
+        state_schema=StateSchema(fields=fields),
+        output_schema=SchemaRef(type="object", properties={}),
+        node_defs=[],
+        start="unused",
+        nodes=[],
+        edges=[],
+    )