fix: OpenEnv spec_version + app field, stricter grader manifest for Phase2 validators

README.md

@@ -34,6 +34,8 @@ All graders are deterministic and return a float score in `[0.0, 1.0]`.
 | `/step` | POST | Take a step with an action |
 | `/state` | GET | Get the current state |
 | `/tasks` | GET | List all tasks with grader metadata |
+| `/manifest/tasks` | GET | Same manifest as `/tasks` (validator alias) |
+| `/openenv.yaml` | GET | Raw `openenv.yaml` from the repo |
 | `/health` | GET | Health check |
 
 ## Running Locally

openenv.yaml

@@ -1,8 +1,13 @@
-name: "CRA-Environment"
+# OpenEnv manifest — spec_version + app required for strict validators (see openenv-cli templates).
+spec_version: 1
+name: CRA-Environment
+type: space
+runtime: fastapi
+app: src.server:app
+port: 7860
+
 version: "1.0.0"
 description: "Contextual Reinforcement Autocomplete — code completion with KG hints and deterministic per-task graders."
-entrypoint: "src.server:app"
-runtime: fastapi
 tags:
   - openenv
   - code-assist
@@ -10,51 +15,66 @@ tags:
 
 tasks:
   - id: syntax-line
+    task_id: syntax-line
     name: syntax-line
     description: "Finish the line so the module is valid Python (balanced parentheses)."
     difficulty: easy
     max_steps: 100
     score_range: [0.0, 1.0]
+    graded: true
+    programmatic_grader: true
     grader: grade_syntax_line
     graders:
       - id: grade_syntax_line
         type: deterministic
+        enabled: true
         implementation: CodeAssistEnv._grade_syntax_line
 
   - id: import-fix
+    task_id: import-fix
     name: import-fix
     description: "Add the missing import so the file runs."
     difficulty: medium
     max_steps: 100
     score_range: [0.0, 1.0]
+    graded: true
+    programmatic_grader: true
     grader: grade_import_fix
     graders:
       - id: grade_import_fix
         type: deterministic
+        enabled: true
         implementation: CodeAssistEnv._grade_import_fix
 
   - id: docstring-stub
+    task_id: docstring-stub
     name: docstring-stub
     description: "Give the function a docstring and a body with a return statement."
     difficulty: hard
     max_steps: 100
     score_range: [0.0, 1.0]
+    graded: true
+    programmatic_grader: true
     grader: grade_docstring_stub
     graders:
       - id: grade_docstring_stub
         type: deterministic
-        implementation: CodeAssistEnv._grade_docstring
+        enabled: true
+        implementation: CodeAssistEnv._grade_docstring_stub
 
 graders:
   - id: grade_syntax_line
     task_id: syntax-line
     type: deterministic
+    enabled: true
   - id: grade_import_fix
     task_id: import-fix
     type: deterministic
+    enabled: true
   - id: grade_docstring_stub
     task_id: docstring-stub
     type: deterministic
+    enabled: true
 
 observation_space:
   type: CodeObservation
@@ -77,6 +97,8 @@ endpoints:
   step: POST /step
   state: GET /state
   tasks: GET /tasks
+  manifest_tasks: GET /manifest/tasks
+  openenv_yaml: GET /openenv.yaml
 
 infrastructure:
   framework: FastAPI

src/code_assist_env.py

@@ -50,16 +50,20 @@ def graded_tasks_manifest() -> list[dict[str, Any]]:
         out.append(
             {
                 "id": task_id,
+                "task_id": task_id,
                 "name": task_id,
                 "description": cfg["instruction"],
                 "difficulty": cfg["difficulty"],
                 "max_steps": MAX_STEPS,
                 "score_range": [0.0, 1.0],
+                "graded": True,
+                "programmatic_grader": True,
                 "grader": grader,
                 "graders": [
                     {
                         "id": grader,
                         "type": "deterministic",
+                        "enabled": True,
                         "task_id": task_id,
                     }
                 ],
@@ -75,16 +79,19 @@ def graders_registry() -> list[dict[str, Any]]:
             "id": "grade_syntax_line",
             "task_id": "syntax-line",
             "type": "deterministic",
+            "enabled": True,
         },
         {
             "id": "grade_import_fix",
             "task_id": "import-fix",
             "type": "deterministic",
+            "enabled": True,
         },
         {
             "id": "grade_docstring_stub",
             "task_id": "docstring-stub",
             "type": "deterministic",
+            "enabled": True,
         },
     ]
 
@@ -268,6 +275,10 @@ class CodeAssistEnv(Environment[CodeAction, CodeObservation, CodeState]):
             pass
         return min(1.0, score)
 
+    def _grade_docstring(self) -> float:
+        """Alias for YAML `implementation: CodeAssistEnv._grade_docstring` compatibility."""
+        return self._grade_docstring_stub()
+
     def _grade_docstring_stub(self):
         score = 0.0
         try:

src/server.py

@@ -12,7 +12,9 @@ from .code_assist_env import CodeAssistEnv
 from .models import CodeAction, CodeObservation
 
 _root = Path(__file__).parent
-_static = _root.parent / "static"
+_repo_root = _root.parent
+_static = _repo_root / "static"
+_openenv_yaml = _repo_root / "openenv.yaml"
 
 app = create_fastapi_app(
     CodeAssistEnv,
@@ -45,9 +47,7 @@ async def predict(data: IDECpntext):
     return get_completion(data.content, data.cursor_offset)
 
 
-@app.get("/tasks", include_in_schema=True)
-async def list_graded_tasks():
-    """Expose ≥3 graded tasks for automated submission validation."""
+def _tasks_payload() -> dict:
     from .code_assist_env import graded_tasks_manifest, graders_registry
 
     tasks = graded_tasks_manifest()
@@ -57,8 +57,35 @@ async def list_graded_tasks():
         "graders": graders,
         "task_count": len(tasks),
         "grader_count": len(graders),
+        "tasks_with_graders": sum(
+            1
+            for t in tasks
+            if t.get("grader") or (isinstance(t.get("graders"), list) and len(t["graders"]) > 0)
+        ),
     }
 
+
+@app.get("/tasks", include_in_schema=True)
+async def list_graded_tasks():
+    """Expose ≥3 graded tasks for automated submission validation."""
+    return _tasks_payload()
+
+
+@app.get("/manifest/tasks", include_in_schema=True)
+async def manifest_tasks_alias():
+    """Alternate path some validators probe for task/grader manifests."""
+    return _tasks_payload()
+
+
+@app.get("/openenv.yaml", include_in_schema=False)
+async def serve_openenv_yaml():
+    """Serve the repo manifest verbatim (some pipelines fetch this URL)."""
+    if not _openenv_yaml.is_file():
+        from fastapi import HTTPException
+
+        raise HTTPException(status_code=404, detail="openenv.yaml not found")
+    return FileResponse(_openenv_yaml, media_type="application/yaml")
+
 if _static.is_dir():
     app.mount(
         "/static",