Make Stage2 RL cache comments portable

Author: intern_nem_dev_3

src/nemotron/recipes/super3/stage2_rl/config/default.yaml

@@ -7,7 +7,7 @@ run:
       container: ""  # Set to nemo-skills-sandbox image path/URI
       port: 6000
       command: "/start-with-nginx.sh"
-    persistent_cache: ""  # Set to shared cache dir (e.g. /lustre/.../cache)
+    persistent_cache: ""  # Set to shared cache dir (e.g. ${NEMO_RUN_DIR:-.}/cache/super3/stage2_rl)
     env_vars:
       NRL_WG_USE_RAY_REF: "1"
       NRL_VLLM_USE_V1: "1"

src/nemotron/recipes/super3/stage2_rl/stage1_rlvr/config/default.yaml

@@ -7,7 +7,7 @@ run:
       container: ""  # Set to nemo-skills-sandbox image path/URI
       port: 6000
       command: "/start-with-nginx.sh"
-    persistent_cache: ""  # Set to shared cache dir (e.g. /lustre/.../cache)
+    persistent_cache: ""  # Set to shared cache dir (e.g. ${NEMO_RUN_DIR:-.}/cache/super3/stage2_rl)
     env_vars:
       NRL_WG_USE_RAY_REF: "1"
       NRL_VLLM_USE_V1: "1"

src/nemotron/recipes/super3/stage2_rl/stage2_swe1/config/default.yaml

@@ -9,7 +9,7 @@ run:
       container: ""  # Set to nemo-skills-sandbox image path/URI
       port: 6000
       command: "/start-with-nginx.sh"
-    persistent_cache: ""  # Set to shared cache dir (e.g. /lustre/.../cache)
+    persistent_cache: ""  # Set to shared cache dir (e.g. ${NEMO_RUN_DIR:-.}/cache/super3/stage2_rl)
     apptainer: true  # Install apptainer inside the container at job start
     env_vars:
       NRL_WG_USE_RAY_REF: "1"

src/nemotron/recipes/super3/stage2_rl/stage2_swe2/config/default.yaml

@@ -9,7 +9,7 @@ run:
       container: ""  # Set to nemo-skills-sandbox image path/URI
       port: 6000
       command: "/start-with-nginx.sh"
-    persistent_cache: ""  # Set to shared cache dir (e.g. /lustre/.../cache)
+    persistent_cache: ""  # Set to shared cache dir (e.g. ${NEMO_RUN_DIR:-.}/cache/super3/stage2_rl)
     apptainer: true  # Install apptainer inside the container at job start
     sif_dir: ""  # Path to directory containing .sif images for SWE-bench environments
     env_vars:

src/nemotron/recipes/super3/stage2_rl/stage3_rlhf/config/default.yaml

@@ -7,7 +7,7 @@ run:
       container: ""  # Set to nemo-skills-sandbox image path/URI
       port: 6000
       command: "/start-with-nginx.sh"
-    persistent_cache: ""  # Set to shared cache dir (e.g. /lustre/.../cache)
+    persistent_cache: ""  # Set to shared cache dir (e.g. ${NEMO_RUN_DIR:-.}/cache/super3/stage2_rl)
     env_vars:
       NRL_WG_USE_RAY_REF: "1"
       NRL_VLLM_USE_V1: "1"

tests/recipes/super3/test_stage2_rl_bridge_data_prep_defaults.py

@@ -71,6 +71,15 @@
     "src/nemotron/recipes/super3/stage2_rl/config/data_prep/data_blend_raw.json"
 )
 
+RUNTIME_CONFIGS = {
+    "default": STAGE2_RL_ROOT / "config/default.yaml",
+    "rlvr": STAGE2_RL_ROOT / "stage1_rlvr/config/default.yaml",
+    "swe1": STAGE2_RL_ROOT / "stage2_swe1/config/default.yaml",
+    "swe2": STAGE2_RL_ROOT / "stage2_swe2/config/default.yaml",
+    "rlhf": STAGE2_RL_ROOT / "stage3_rlhf/config/default.yaml",
+}
+EXPECTED_PERSISTENT_CACHE_GUIDANCE = "${NEMO_RUN_DIR:-.}/cache/super3/stage2_rl"
+
 
 def _load_yaml(path: Path) -> tuple[str, dict[str, object]]:
     text = path.read_text(encoding="utf-8")
@@ -79,6 +88,18 @@ def _load_yaml(path: Path) -> tuple[str, dict[str, object]]:
     return text, data
 
 
+@pytest.mark.parametrize(("profile", "config_path"), sorted(RUNTIME_CONFIGS.items()))
+def test_stage2_rl_runtime_persistent_cache_comment_is_portable(
+    profile: str,
+    config_path: Path,
+) -> None:
+    text, data = _load_yaml(config_path)
+
+    assert "/lustre/" not in text
+    assert data["run"]["env"]["persistent_cache"] == "", profile
+    assert EXPECTED_PERSISTENT_CACHE_GUIDANCE in text
+
+
 @pytest.mark.parametrize("profile", sorted(CORE_BLEND_CONFIGS))
 def test_stage2_rl_core_blend_paths_are_repo_local(profile: str) -> None:
     text, data = _load_yaml(CORE_BLEND_CONFIGS[profile])

workspace/interns/intern_nem_dev_3/status.md

@@ -1,12 +1,12 @@
 # intern_nem_dev_3 - 状态
 
-<!-- METADATA:STATUS=Working,TASK=task156_embed_sdg_hf_corpus_revision_guard_s1,SESSION=1 -->
+<!-- METADATA:STATUS=Working,TASK=task159_super3_stage2_rl_persistent_cache_comment_portability_s1,SESSION=1 -->
 
 | 字段 | 值 |
 |------|-----|
 | Name | intern_nem_dev_3 |
 | Status | Working |
-| Current Task | task156_embed_sdg_hf_corpus_revision_guard_s1 |
-| PR | https://github.com/songCNMS/Nemotron/pull/263 |
+| Current Task | task159_super3_stage2_rl_persistent_cache_comment_portability_s1 |
+| PR | pending |
 | Session | 1 |
-| Recent Progress | Opened PR #263 for Embed SDG hf:// pinned SHA guard after focused pytest, py_compile, Ruff, structured mock probe, and diff checks passed |
+| Recent Progress | Implemented Stage2 RL persistent_cache comment portability; focused pytest, py_compile, Ruff, static grep/probe, live-surface scan, and diff check passed |

workspace/tasks/task159_super3_stage2_rl_persistent_cache_comment_portability_s1/README.md

@@ -0,0 +1,34 @@
+# task159_super3_stage2_rl_persistent_cache_comment_portability_s1
+
+<!-- METADATA:STATUS=InProgress,ASSIGNEE=intern_nem_dev_3 -->
+
+## Summary
+
+Make Super3 Stage2 RL runtime config `persistent_cache` example comments
+portable by replacing scoped `/lustre/.../cache` guidance with
+`${NEMO_RUN_DIR:-.}/cache/super3/stage2_rl`, while preserving empty
+`persistent_cache` values and runtime semantics.
+
+## Scope
+
+- `src/nemotron/recipes/super3/stage2_rl/config/default.yaml`
+- `src/nemotron/recipes/super3/stage2_rl/stage1_rlvr/config/default.yaml`
+- `src/nemotron/recipes/super3/stage2_rl/stage2_swe1/config/default.yaml`
+- `src/nemotron/recipes/super3/stage2_rl/stage2_swe2/config/default.yaml`
+- `src/nemotron/recipes/super3/stage2_rl/stage3_rlhf/config/default.yaml`
+- Focused Super3 Stage2 RL config tests.
+- Task/status docs for `intern_nem_dev_3`.
+
+## Acceptance
+
+- The five scoped YAML files contain no `/lustre/` example.
+- The five scoped YAML files keep `run.env.persistent_cache` as an empty
+  string.
+- The five scoped YAML files include portable cache guidance using
+  `${NEMO_RUN_DIR:-.}/cache/super3/stage2_rl`.
+
+## Boundaries
+
+- No live Stage2 RL data prep, bridge prep, training, eval, endpoint calls,
+  W&B, cluster jobs, deploy, artifact upload/download, direct `main`/`master`
+  push, or self-merge.

workspace/tasks/task159_super3_stage2_rl_persistent_cache_comment_portability_s1/history_log.md

@@ -0,0 +1,18 @@
+# task159_super3_stage2_rl_persistent_cache_comment_portability_s1 history
+
+<!-- METADATA:SESSION=1 -->
+
+## Session 1 - 2026-05-29
+
+- Accepted PM assignment and created branch
+  `intern_nem_dev_3/task159_super3_stage2_rl_persistent_cache_comment_portability_s1`
+  from `origin/main` at `0b31358436c38e698c7c2bc3a89871df273df21c`.
+- Replaced `/lustre/.../cache` examples in five Super3 Stage2 RL
+  `persistent_cache` comments with
+  `${NEMO_RUN_DIR:-.}/cache/super3/stage2_rl`.
+- Added a focused static config test proving the five runtime configs keep
+  `persistent_cache: ""`, include portable cache guidance, and have no
+  `/lustre/` text.
+- Verified focused pytest, `py_compile`, Ruff, scoped `/lustre/` grep,
+  structured YAML/text probe, added-line live-surface scan, and
+  `git diff --check` before staging.

workspace/tasks/task159_super3_stage2_rl_persistent_cache_comment_portability_s1/task_knowledge.md

@@ -0,0 +1,10 @@
+# task159_super3_stage2_rl_persistent_cache_comment_portability_s1 knowledge
+
+<!-- METADATA:SESSION=1 -->
+
+## Working Notes
+
+- The Stage2 RL portable cache comment contract is
+  `${NEMO_RUN_DIR:-.}/cache/super3/stage2_rl`.
+- This task is comment/static-test only; runtime `persistent_cache` values and
+  RL behavior are intentionally unchanged.