Merge pull request #174 from 2-Coatl/feature/implement-project-setup-for-node.js-and-python-13-30-41

Document runtime entrypoints for workspace agent

Author: 2-Coatl

infrastructure/workspace/README.md

@@ -39,6 +39,41 @@ contributors.
    npm run vpn:health
    ```
 
+## Ejecución del agente
+
+Este workspace no utiliza Django, por lo que el patrón `manage.py` **no aplica**.
+En su lugar, el agente se orquesta mediante el servidor MCP y los playbooks de
+Codex. Tienes dos maneras de ejecutarlo:
+
+1. **Modo directo (Python)**
+   ```bash
+   cd infrastructure/workspace
+   source .venv/bin/activate  # si aún no lo hiciste
+   python -m infrastructure.workspace.vpn_proxy_agent.mcp_server
+   ```
+   El proceso abre un servidor MCP por `stdin/stdout` que puede ser consumido
+   por cualquier cliente compatible.
+
+2. **Modo asistido (NPM + Codex)**
+   ```bash
+   cd infrastructure/workspace
+   npm run vpn:setup-dev     # configura dependencias simuladas y túnel
+   npm run vpn:setup-tunnel  # únicamente el túnel SOCKS5
+   npm run vpn:health        # chequeos de estado
+   ```
+   Estos comandos envuelven llamadas a `codex mcp run <playbook>` y permiten
+   validar el flujo end-to-end con parámetros declarados en `.env`.
+
+Si deseas invocar manualmente un playbook específico, también puedes ejecutar:
+
+```bash
+codex mcp run setup-dev-environment
+```
+
+La ausencia de `manage.py` no impide la ejecución del agente: todos los
+componentes se inician a través del servidor MCP y los scripts definidos en
+`package.json`.
+
 ## Validación del agente
 
 Para demostrar que el agente VPN/Proxy funciona sin depender de

infrastructure/workspace/tests/test_documentation_validation.py

@@ -30,3 +30,16 @@ def test_workspace_readme_clarifies_mise_is_optional() -> None:
 
     assert "mise ~/.config/mise/config.toml tools" in readme_content
     assert "no es necesario" in readme_content.lower()
+
+
+def test_workspace_readme_explains_how_to_run_the_agent_without_manage_py() -> None:
+    if not README_PATH.exists():
+        raise AssertionError(f"Expected {README_PATH} to exist")
+
+    readme_content = README_PATH.read_text(encoding="utf-8")
+
+    assert "## Ejecución del agente" in readme_content
+    assert "python -m infrastructure.workspace.vpn_proxy_agent.mcp_server" in readme_content
+    assert "npm run vpn:setup-dev" in readme_content
+    assert "manage.py" in readme_content
+    assert "no aplica" in readme_content.lower()