feat(deploy): finalize MVP deployment and file transfer approach

tests/test_deploy_handoff.py

@@ -39,6 +39,21 @@ def test_dockerfile_production_build_does_not_require_local_external_tree():
     assert "uv pip install --system --ignore-requires-python" not in dockerfile
 
 
+def test_dockerfile_installs_agent_api_after_final_uv_sync():
+    dockerfile = (ROOT / "Dockerfile").read_text(encoding="utf-8")
+    development = dockerfile.split("FROM base AS development", maxsplit=1)[1].split(
+        "FROM base AS production", maxsplit=1
+    )[0]
+    production = dockerfile.split("FROM base AS production", maxsplit=1)[1]
+
+    assert development.index("RUN uv sync --no-dev --frozen") < development.index(
+        "pip install --no-cache-dir --ignore-requires-python -e /agent_api/"
+    )
+    assert production.index("RUN uv sync --no-dev --frozen") < production.index(
+        "git+https://git.lambda.coredump.ru/platform/agent_api.git"
+    )
+
+
 def test_dockerignore_excludes_local_only_and_runtime_artifacts():
     dockerignore = (ROOT / ".dockerignore").read_text(encoding="utf-8")
 
@@ -60,3 +75,28 @@ def test_agent_registry_example_documents_multi_agent_volume_contract():
     for index, agent in enumerate(agents):
         assert agent["base_url"].endswith(f"/agent_{index}/")
         assert agent["workspace_path"] == f"/agents/{index}"
+
+
+def test_smoke_compose_models_deploy_like_proxy_and_surface_checker():
+    smoke = _compose("docker-compose.smoke.yml")
+
+    assert set(smoke["services"]) >= {"surface-smoke", "agent-proxy", "agent-0", "agent-1"}
+    assert "tools.check_matrix_agents" in smoke["services"]["surface-smoke"]["command"]
+    assert smoke["services"]["agent-proxy"]["ports"] == ["${SMOKE_PROXY_PORT:-7000}:7000"]
+
+
+def test_smoke_timeout_override_routes_one_agent_to_no_status_stub():
+    smoke_timeout = _compose("docker-compose.smoke.timeout.yml")
+
+    assert set(smoke_timeout["services"]) >= {"agent-proxy", "agent-no-status"}
+
+
+def test_smoke_registry_targets_local_proxy_routes():
+    registry = yaml.safe_load(
+        (ROOT / "config" / "matrix-agents.smoke.yaml").read_text(encoding="utf-8")
+    )
+
+    assert [agent["base_url"] for agent in registry["agents"]] == [
+        "http://agent-proxy:7000/agent_0/",
+        "http://agent-proxy:7000/agent_1/",
+    ]