fix(scaffold): make generated projects pass tests out of the box

act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/.pre-commit-config.yaml

@@ -5,14 +5,14 @@ repos:
     rev: 0.9.2
     hooks:
       - id: uv-lock
-        # 의존성 락 파일 동기화
+        # Keep the dependency lock file in sync
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: v0.12.0
     hooks:
       - id: ruff-check
-        # 코드 품질 점검 및 임포트 정리
+        # Lint and tidy imports
         types_or: [python, pyi]
         args: [--fix]
       - id: ruff-format
-        # 코드 포맷팅
+        # Format code
         types_or: [python, pyi]

act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/modules/agents.py

@@ -1,4 +1,4 @@
-"""[Optional] Construct agents required by the Sample Cast graph.
+"""[Optional] Construct agents required by the {{ cookiecutter.cast_name }} graph.
 
 Guidelines:
     - Create agents using the `langchain.agents` module.

act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/modules/middlewares.py

@@ -1,4 +1,4 @@
-"""[Optional] Middleware Classes for Sam graphs.
+"""[Optional] Middleware Classes for the {{ cookiecutter.cast_name }} graph.
 
 Guidelines:
     - Use built-in middleware (e.g., PIIMiddleware) for common use cases.

act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/modules/nodes.py

@@ -37,9 +37,15 @@ def execute(self, state):
             state: Current graph state.
 
         Returns:
-            dict: State updates (must be a dict)
+            dict: State updates (must be a dict). Writes both ``result``
+            (exposed by OutputState) and ``messages`` (accumulated via
+            MessagesState's ``add_messages`` reducer).
         """
-        return {"messages": [AIMessage(content="Welcome to the Act! by Sync Node")]}
+        welcome = "Welcome to the Act!"
+        return {
+            "result": welcome,
+            "messages": [AIMessage(content=f"{welcome} by Sync Node")],
+        }
 
 
 class AsyncSampleNode(AsyncBaseNode):
@@ -60,6 +66,12 @@ async def execute(self, state):
             state: Current graph state.
 
         Returns:
-            dict: State updates (must be a dict)
+            dict: State updates (must be a dict). Writes both ``result``
+            (exposed by OutputState) and ``messages`` (accumulated via
+            MessagesState's ``add_messages`` reducer).
         """
-        return {"messages": [AIMessage(content="Welcome to the Act! by Async Node")]}
+        welcome = "Welcome to the Act!"
+        return {
+            "result": welcome,
+            "messages": [AIMessage(content=f"{welcome} by Async Node")],
+        }

act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/modules/state.py

@@ -1,4 +1,4 @@
-"""[Required] State definition shared across sam graphs.
+"""[Required] State definition for the {{ cookiecutter.cast_name }} graph.
 
 Guidelines:
     - Create TypedDict classes for input, output, overall state, and any other state you need.

act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/pyproject.toml

@@ -12,6 +12,7 @@ dependencies = [
 [dependency-groups]
 test = [
     "pytest",
+    "pytest-asyncio",
     "langgraph-cli[inmem]",
 ]
 lint = [
@@ -27,11 +28,16 @@ dev = [
 [tool.pyright]
 include = ["casts", "tests"]
 exclude = [
-    "**/__pycache__/*", 
-    ".venv", 
+    "**/__pycache__/*",
+    ".venv",
     "**/.venv"
 ]
 
+[tool.pytest.ini_options]
+pythonpath = ["."]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
 [tool.uv.workspace]
 members = ["casts/*"]
 exclude = [

act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/tests/cast_tests/{{ cookiecutter.cast_snake }}_test.py

@@ -11,9 +11,9 @@
 def test_graph_produces_message() -> None:
     graph = {{ cookiecutter.cast_snake }}_graph()
 
-    # 최소 상태로 그래프 실행
+    # Invoke with minimal state — OutputState filter exposes only the ``result`` key.
     result = graph.invoke({"query": "I'm joining Act"})
 
-    # SampleNode가 message 키를 생성하는지 확인
-    assert "messages" in result
-    assert result["messages"] == "Welcome to the Act!"
+    # Verify SampleNode populated ``result``.
+    assert "result" in result
+    assert result["result"] == "Welcome to the Act!"

act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/tests/node_tests/test_node.py

@@ -1,4 +1,4 @@
-"""Test the nodes for the Sam graph.
+"""Test the nodes for the {{ cookiecutter.cast_name }} graph.
 
 Official document URL: https://docs.langchain.com/oss/python/langgraph/test"""
 
@@ -10,10 +10,16 @@
 def test_base_node_calls_execute() -> None:
     node = SampleNode()
     result = node.execute({"query": "I'm joining Act"})
-    assert result == {"message": "Welcome to the Act!"}
+
+    assert result["result"] == "Welcome to the Act!"
+    assert len(result["messages"]) == 1
+    assert result["messages"][0].content == "Welcome to the Act! by Sync Node"
 
 
 async def test_async_base_node_calls_execute() -> None:
     node = AsyncSampleNode()
     result = await node.execute({"query": "I'm joining Act"})
-    assert result == {"message": "Welcome to the Act!"}
+
+    assert result["result"] == "Welcome to the Act!"
+    assert len(result["messages"]) == 1
+    assert result["messages"][0].content == "Welcome to the Act! by Async Node"