[task154][intern_nem_dev_1] Make Super3 RL data-prep doc output portable (#261)

* Make Super3 RL data-prep doc output portable

* Record task154 PR status

---------

Co-authored-by: intern_nem_dev_1 <intern_nem_dev_1@intern.local>

Author: songCNMS

docs/nemotron/super3/rl/data-prep.md

@@ -100,7 +100,7 @@ with `responses_create_params.input`, `question`, `expected_answer`,
 ```bash
 source /work-agents/.venv/bin/activate
 python src/nemotron/recipes/super3/milestones/m0_data_env/prepare_m0_assets.py \
-  --output-dir /mnt/3fs/data/lei.song/nemotron/m0_data_env_foundation/smoke-20260516 \
+  --output-dir "${NEMO_RUN_DIR:-.}/output/super3/m0_data_env_foundation/smoke-20260516" \
   --max-train-per-dataset 100 \
   --max-val-per-dataset 25
 ```

tests/recipes/super3/test_m0_data_env.py

@@ -40,8 +40,12 @@
 )
 RL_RAW_BLEND_PATH = REPO_ROOT / "src/nemotron/recipes/super3/stage2_rl/config/data_prep/data_blend_raw.json"
 M0_DATA_ENV_README_PATH = REPO_ROOT / "src/nemotron/recipes/super3/milestones/m0_data_env/README.md"
+SUPER3_RL_DATA_PREP_DOC_PATH = REPO_ROOT / "docs/nemotron/super3/rl/data-prep.md"
 OLD_SUPER3_RL_BLEND_SLUG = "nvidia/Nemotron-3-Super-RL-Training-Blends"
 LIVE_SUPER3_RL_BLEND_SLUG = "nvidia/Nemotron-RL-Super-Training-Blends"
+PORTABLE_M0_SMOKE_OUTPUT_DIR = (
+    '"${NEMO_RUN_DIR:-.}/output/super3/m0_data_env_foundation/smoke-20260516"'
+)
 
 
 def _require_live_hf_tests() -> None:
@@ -103,8 +107,15 @@ def test_m0_data_env_readme_uses_portable_output_examples() -> None:
     readme = M0_DATA_ENV_README_PATH.read_text()
 
     assert "/mnt/3fs/data/lei.song/nemotron" not in readme
-    assert '--output-dir "${NEMO_RUN_DIR:-.}/output/super3/m0_data_env_foundation/smoke-20260516"' in readme
-    assert '--input-dir "${NEMO_RUN_DIR:-.}/output/super3/m0_data_env_foundation/smoke-20260516"' in readme
+    assert f"--output-dir {PORTABLE_M0_SMOKE_OUTPUT_DIR}" in readme
+    assert f"--input-dir {PORTABLE_M0_SMOKE_OUTPUT_DIR}" in readme
+
+
+def test_super3_rl_data_prep_doc_uses_portable_m0_output_example() -> None:
+    doc = SUPER3_RL_DATA_PREP_DOC_PATH.read_text()
+
+    assert "/mnt/3fs/data/lei.song/nemotron" not in doc
+    assert f"--output-dir {PORTABLE_M0_SMOKE_OUTPUT_DIR}" in doc
 
 
 def test_super3_rl_blend_slug_resolves_on_hf_when_network_available() -> None:

workspace/interns/intern_nem_dev_1/status.md

@@ -1,12 +1,12 @@
 # intern_nem_dev_1 - 状态
 
-<!-- METADATA:STATUS=Working,TASK=task150_super3_stage1_sft_tiny_blend_contract_s1,ROLE=independent,SESSION=1 -->
+<!-- METADATA:STATUS=Working,TASK=task154_super3_rl_data_prep_doc_output_portability_s1,ROLE=independent,SESSION=1 -->
 
 | 字段 | 值 |
 |------|-----|
 | Name | intern_nem_dev_1 |
 | Status | Working |
-| Current Task | task150_super3_stage1_sft_tiny_blend_contract_s1 |
-| PR | https://github.com/songCNMS/Nemotron/pull/258 |
+| Current Task | task154_super3_rl_data_prep_doc_output_portability_s1 |
+| PR | https://github.com/songCNMS/Nemotron/pull/261 |
 | Session | 1 |
-| Recent Progress | Opened PR #258 for task150; Super3 Stage1 SFT tiny uses Super3-owned non-empty blend and null used_in_filter; focused checks passed |
+| Recent Progress | Opened PR #261 for task154; Super3 RL data-prep doc M0 output example now uses NEMO_RUN_DIR-relative path and focused docs checks passed |

workspace/tasks/task154_super3_rl_data_prep_doc_output_portability_s1/README.md

@@ -0,0 +1,24 @@
+# task154_super3_rl_data_prep_doc_output_portability_s1
+
+<!-- METADATA:STATUS=InProgress,ASSIGNEE=intern_nem_dev_1 -->
+
+## Scope
+
+- Update `docs/nemotron/super3/rl/data-prep.md` so the M0 data-env
+  `--output-dir` example uses a portable `${NEMO_RUN_DIR:-.}`-relative
+  Super3 output path instead of a developer-local `/mnt/3fs/...` path.
+- Add focused static test coverage proving the stale named-user path is absent
+  and the portable example is present.
+
+## Boundaries
+
+- Static docs/test/docs-only.
+- No live M0 data prep, HF/dataset download, health baseline, train/eval,
+  endpoint, W&B, cluster, deploy, artifact download, direct `main`/`master`
+  push, or self-merge.
+
+## Status
+
+- Branch: `intern_nem_dev_1/task154_super3_rl_data_prep_doc_output_portability_s1`
+- Base: `795eb92359257ed82816a8685db0f9cae1c751ae`
+- PR: https://github.com/songCNMS/Nemotron/pull/261

workspace/tasks/task154_super3_rl_data_prep_doc_output_portability_s1/history_log.md

@@ -0,0 +1,18 @@
+# task154_super3_rl_data_prep_doc_output_portability_s1 history
+
+<!-- METADATA:SESSION=1 -->
+
+## Session 1 - 2026-05-29
+
+- Accepted PM assignment for task154 from peer message.
+- Created branch
+  `intern_nem_dev_1/task154_super3_rl_data_prep_doc_output_portability_s1`
+  from `origin/main` at `795eb92359257ed82816a8685db0f9cae1c751ae`.
+- Updated `docs/nemotron/super3/rl/data-prep.md` to use
+  `"${NEMO_RUN_DIR:-.}/output/super3/m0_data_env_foundation/smoke-20260516"`
+  for the M0 `--output-dir` example.
+- Extended focused M0 docs static coverage in
+  `tests/recipes/super3/test_m0_data_env.py`.
+- Ran focused docs pytest, py_compile, Ruff, scoped product-doc grep,
+  added-line live-surface scan, and diff checks.
+- Opened PR #261 to `main`: https://github.com/songCNMS/Nemotron/pull/261.

workspace/tasks/task154_super3_rl_data_prep_doc_output_portability_s1/task_knowledge.md

@@ -0,0 +1,11 @@
+# task154_super3_rl_data_prep_doc_output_portability_s1 knowledge
+
+<!-- METADATA:SESSION=1 -->
+
+## Working Notes
+
+- Super3 RL product docs should not include named-user `/mnt/3fs` output
+  examples.
+- M0 data-env examples should use
+  `"${NEMO_RUN_DIR:-.}/output/super3/m0_data_env_foundation/smoke-20260516"`
+  so they work outside a specific developer workspace.