Codex-generated pull request (#890)

Co-authored-by: will brown <willccbb@users.noreply.github.com>
Co-authored-by: Cursor Agent <cursoragent@cursor.com>

Author: willccbb

docs/overview.md

@@ -100,7 +100,7 @@ In the TUI, press `c` to open Copy Mode for prompt/completion text; highlight an
 
 To publish the environment to the [Environments Hub](https://app.primeintellect.ai/dashboard/environments?ex_sort=most_stars), do:
 ```bash
-prime env push --path ./environments/my_env
+prime env push my-env # equivalent to --path ./environments/my_env
 ```
 
 To run an evaluation directly from the Environments Hub, do:

skills/create-environments/SKILL.md

@@ -88,11 +88,11 @@ prime eval run my-env -m gpt-4.1-mini -n 30 -r 3 -s
 2. Ask the user explicitly whether visibility should be `PUBLIC` or `PRIVATE`.
 3. Use:
 ```bash
-prime env push --path ./environments/my_env --visibility PUBLIC
+prime env push my-env --visibility PUBLIC
 ```
 or
 ```bash
-prime env push --path ./environments/my_env --visibility PRIVATE
+prime env push my-env --visibility PRIVATE
 ```
 4. For hosted or large-scale workflows, prefer running with the Hub slug after push:
 ```bash

skills/evaluate-environments/SKILL.md

@@ -49,11 +49,11 @@ key = "PRIME_API_KEY"
 2. Ask the user explicitly: should visibility be `PUBLIC` or `PRIVATE`?
 3. Push with chosen visibility:
 ```bash
-prime env push --path ./environments/my_env --visibility PUBLIC
+prime env push my-env --visibility PUBLIC
 ```
 or
 ```bash
-prime env push --path ./environments/my_env --visibility PRIVATE
+prime env push my-env --visibility PRIVATE
 ```
 4. For hosted eval workflows, prefer running large jobs against the Hub slug:
 ```bash

skills/train-with-environments/SKILL.md

@@ -44,11 +44,11 @@ prime eval run my-env -m gpt-4.1-mini -n 20 -r 3 -s
 2. Ask the user explicitly whether visibility should be `PUBLIC` or `PRIVATE`.
 3. Push with chosen visibility:
 ```bash
-prime env push --path ./environments/my_env --visibility PUBLIC
+prime env push my-env --visibility PUBLIC
 ```
 or
 ```bash
-prime env push --path ./environments/my_env --visibility PRIVATE
+prime env push my-env --visibility PRIVATE
 ```
 4. For hosted RL and shared workflows, prefer Hub IDs after push (for example `owner/my-env` in config `[[env]].id`).
 

tests/test_build_script.py

@@ -0,0 +1,29 @@
+from pathlib import Path
+
+from verifiers.scripts import build
+
+
+def test_resolve_env_push_target_defaults_to_environments_dir(tmp_path: Path):
+    base_dir = tmp_path / "workspace" / "environments"
+    env_name, env_path = build._resolve_env_push_target("my-env", str(base_dir))
+
+    assert env_name == "my-env"
+    assert env_path == (base_dir / "my_env").resolve()
+
+
+def test_resolve_env_push_target_appends_env_id_to_custom_base_path(tmp_path: Path):
+    base_dir = tmp_path / "workspace" / "custom_envs"
+    env_name, env_path = build._resolve_env_push_target("env-name", str(base_dir))
+
+    assert env_name == "env-name"
+    assert env_path == (base_dir / "env_name").resolve()
+
+
+def test_resolve_env_push_target_uses_explicit_environment_path_when_env_id_missing(
+    tmp_path: Path,
+):
+    explicit_env_path = tmp_path / "workspace" / "environments" / "already_normalized"
+    env_name, env_path = build._resolve_env_push_target(None, str(explicit_env_path))
+
+    assert env_name == "already-normalized"
+    assert env_path == explicit_env_path.resolve()

verifiers/scripts/build.py

@@ -317,6 +317,22 @@ def _wait_for_ready(
     return last_status
 
 
+def _resolve_env_push_target(raw_env_id: str | None, raw_path: str) -> tuple[str, Path]:
+    base_path = Path(raw_path).expanduser().resolve()
+
+    if raw_env_id is None:
+        env_dir = base_path
+        env_id_underscore = env_dir.name
+        if not env_id_underscore:
+            raise ValueError("Could not infer environment id from --path.")
+    else:
+        _, env_id_underscore = _normalize_env_id(raw_env_id)
+        env_dir = base_path / env_id_underscore
+
+    env_id_dash = env_id_underscore.replace("_", "-")
+    return env_id_dash, env_dir
+
+
 def main(argv: list[str] | None = None) -> int:
     parser = argparse.ArgumentParser(
         description=(
@@ -326,29 +342,38 @@ def main(argv: list[str] | None = None) -> int:
     )
     parser.add_argument(
         "env",
-        help="Environment id (hyphenated, e.g. openenv-echo).",
+        nargs="?",
+        help=(
+            "Optional environment id (hyphenated, e.g. openenv-echo). "
+            "When provided, it is appended to --path as the final directory name "
+            "after converting hyphens to underscores."
+        ),
     )
     parser.add_argument(
         "-p",
         "--path",
         default="./environments",
-        help="Path to the environments directory (default: ./environments).",
+        help=(
+            "Base path for environments (default: ./environments). "
+            "When env id is omitted, this should point directly to the target "
+            "environment directory."
+        ),
     )
     args = parser.parse_args(argv)
 
     try:
-        env_id_dash, env_id_underscore = _normalize_env_id(args.env)
+        env_id_dash, env_path = _resolve_env_push_target(args.env, args.path)
+        env_id_underscore = env_path.name
     except ValueError as e:
         print(str(e), file=sys.stderr)
         return 2
 
-    environments_root = Path(args.path).expanduser().resolve()
-    if not environments_root.exists() or not environments_root.is_dir():
-        print(f"Environments path not found: {environments_root}", file=sys.stderr)
+    if not env_path.exists() or not env_path.is_dir():
+        print(f"Environment path not found: {env_path}", file=sys.stderr)
         return 2
 
     try:
-        project_dir = _resolve_project_dir(environments_root, env_id_underscore)
+        project_dir = _resolve_project_dir(env_path.parent, env_id_underscore)
         dockerfile = _find_dockerfile(project_dir)
     except FileNotFoundError as e:
         print(str(e), file=sys.stderr)