Add project-folder runtime artifacts

tests/test_sub_mode_runtime_contract.py

@@ -27,6 +27,9 @@ def test_primary_and_compat_runtime_routes_are_registered():
     assert '@compat_router.post("/swarm-events")' in callbacks_source
     assert 'prefix="/api/swarms"' in swarm_router_source
     assert '@swarms_router.post("/{swarm_id}/approvals/{approval_id}")' in swarm_router_source
+    assert '@swarms_router.get("/{swarm_id}/artifacts/{artifact_id}/manifest")' in swarm_router_source
+    assert '@swarms_router.get("/{swarm_id}/artifacts/{artifact_id}/archive.zip")' in swarm_router_source
+    assert '@swarms_router.get("/{swarm_id}/artifacts/{artifact_id}/files/{file_path:path}")' in swarm_router_source
 
 
 def test_projected_statuses_cover_manager_facing_contract():
@@ -64,3 +67,18 @@ def test_runtime_run_projection_remains_sub_mode_compatible():
     assert project_runtime_run_status("completed") == RuntimeDisplayStatus.COMPLETED.value
     assert project_runtime_run_status("failed") == RuntimeDisplayStatus.FAILED.value
     assert project_runtime_run_status("stopped") == RuntimeDisplayStatus.STOPPED.value
+
+
+def test_project_folder_contract_is_documented_and_flagged():
+    """Structural code artifacts should be documented and tagged distinctly."""
+    doc_source = _read("docs/HEICODE_SUB_MODE_RUNTIME_INTEGRATION.md")
+    orchestrator_source = _read("api/swarm/orchestrator.py")
+    swarm_router_source = _read("api/swarm/router.py")
+
+    assert "project_folder artifact（结构性代码强制要求）" in doc_source
+    assert "manifest_uri" in doc_source
+    assert "archive_uri" in doc_source
+    assert "files/{path}" in doc_source
+    assert '"artifact_layout": "project_folder"' in orchestrator_source
+    assert '"primary_read_path": "manifest"' in orchestrator_source
+    assert '"summary_only": True' in swarm_router_source