bugfix: Multi-item

tests/test_multi_item_documentation.py

@@ -0,0 +1,51 @@
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+
+
+def test_multi_item_guide_documents_runtime_contract():
+    text = (ROOT / "docs" / "MCP_MULTI_ITEM_DEVELOPER_GUIDE.md").read_text(encoding="utf-8")
+    for token in (
+        "type: array",
+        "resolved_arguments",
+        "results[]",
+        "PARTIAL_SUCCESS",
+        "workflow.output[tool_name].results",
+        "eligible: false",
+        "Não faça loop de negócio no agente.",
+    ):
+        assert token in text
+
+
+def test_multi_item_guide_is_discoverable_from_main_entry_points():
+    for path in (
+        ROOT / "README.md",
+        ROOT / "Documentacao" / "README_MCP.md",
+        ROOT / "docs" / "developer" / "pt" / "INDEX_DEVELOPER_GUIDE.md",
+        ROOT / "templates" / "agent_template_backend" / "README.md",
+    ):
+        assert "MCP_MULTI_ITEM" in path.read_text(encoding="utf-8") or "MCP multi-item" in path.read_text(encoding="utf-8") or "MCP Multi-item" in path.read_text(encoding="utf-8")
+
+
+def test_multi_item_is_discoverable_from_tuning_performance():
+    tuning_index = (ROOT / "Tuning-Performance" / "README.md").read_text(encoding="utf-8")
+    tuning_readme = (ROOT / "Tuning-Performance" / "Multi_Item_MCP" / "README.md").read_text(encoding="utf-8")
+    implementation = (ROOT / "Tuning-Performance" / "Multi_Item_MCP" / "IMPLEMENTACAO_MULTI_ITEM_MCP.md").read_text(encoding="utf-8")
+
+    assert "Multi_Item_MCP" in tuning_index
+    for token in (
+        "tools.yaml",
+        "tool_policies.yaml",
+        "results[]",
+        "PARTIAL_SUCCESS",
+        "NÃO cria motor multi-item",
+    ):
+        assert token in tuning_readme
+
+    for token in (
+        "MCP Server ou workflow",
+        "success",
+        "PARTIAL_SUCCESS",
+        "Checklist do desenvolvedor",
+    ):
+        assert token in implementation