Upload folder using huggingface_hub

core/validation/parser.py

@@ -10,12 +10,13 @@ from typing import Optional
 
 @dataclass
 class ParsedCommand:
-    type: str  # "cat" | "echo_append" | "sed" | "pipeline_run" | "pipeline_logs" | "pipeline_status" | "unknown"
+    type: str  # "cat" | "echo_append" | "sed" | "pipeline_run" | "pipeline_logs" | "pipeline_status" | "diagnose" | "unknown"
     filename: Optional[str] = None
     content: Optional[str] = None    # for echo >>
     pattern: Optional[str] = None    # for sed: old value
     replacement: Optional[str] = None  # for sed: new value
     stage: Optional[str] = None
+    diagnosis: Optional[str] = None  # for diagnose: agent's theory about the bug
 
 
 def parse_command(command: str) -> ParsedCommand:
@@ -61,4 +62,8 @@ def parse_command(command: str) -> ParsedCommand:
     if re.fullmatch(r"pipeline\s+status", command):
         return ParsedCommand(type="pipeline_status")
 
+    m = re.match(r'diagnose\s+([\'"])(.*?)\1\s*$', command, re.DOTALL)
+    if m:
+        return ParsedCommand(type="diagnose", diagnosis=m.group(2))
+
     return ParsedCommand(type="unknown")

server/app.py

@@ -8,7 +8,7 @@ served via openenv's create_app() infrastructure.
 try:
     from openenv.core.env_server.http_server import create_app
     from openenv.core.env_server.interfaces import Environment
-    from openenv.core.env_server.types import Action, Observation, State
+    from openenv.core.env_server.types import Action, Observation, State, EnvironmentMetadata
 except Exception as e:  # pragma: no cover
     raise ImportError(
         "openenv is required for the web interface. Install dependencies with '\n    uv sync\n'"
@@ -23,13 +23,11 @@ from .environment import PipelineEnvironment
 
 from fastapi.responses import PlainTextResponse
 from pathlib import Path
+import os
 
-# OpenEnv-compatible action — wraps the agent's raw command string
 class CiCdDoctorAction(Action):
     command: str = Field(..., description="Shell-like command the agent issues")
 
-
-# OpenEnv-compatible observation — extends base Observation with pipeline fields
 class CiCdDoctorObservation(Observation):
     stdout: str = Field(default="", description="Command output / logs seen by agent")
     exit_code: int = Field(default=0, description="0 = success, 1 = error")
@@ -77,9 +75,23 @@ class CiCdDoctorEnvironment(Environment):
     def state(self) -> State:
         return self._state_obj
 
-def load_readme():
-    path = Path("../docs/README.md")
-    return path.read_text() if path.exists() else "No README found"
+    def get_metadata(self) -> EnvironmentMetadata:
+        return EnvironmentMetadata(
+            name="CI_CD_Doctor",
+            description="An interactive environment where agents diagnose and fix broken CI/CD pipelines.",
+            version="1.0.0",
+            readme_content=_load_readme() or None,
+        )
+
+_README_DIR = Path(__file__).resolve().parent.parent / "docs"
+_README_PATH = _README_DIR / "README.md"
+
+if _README_PATH.exists() and not os.environ.get("ENV_README_PATH"):
+    os.environ["ENV_README_PATH"] = str(_README_PATH)
+
+
+def _load_readme() -> str:
+    return _README_PATH.read_text() if _README_PATH.exists() else ""
 
 app = create_app(
     CiCdDoctorEnvironment,
@@ -91,7 +103,7 @@ app = create_app(
 
 @app.get("/instructions", response_class=PlainTextResponse)
 def instructions():
-    return load_readme()
+    return _load_readme()
 
 def main():
     import uvicorn