auto-sync 2026-07-04T05:22:54Z workspace (part 4)

workspace/scripts/train_utility_energy.py

@@ -49,6 +49,11 @@ def main(argv: list[str] | None = None) -> int:
         default="base",
         help="Deployment-visible chart feature family used by ChartEncoder.",
     )
+    parser.add_argument(
+        "--no-markdown-report",
+        action="store_true",
+        help="Do not write report.md; persistent prose is consolidated in README.md.",
+    )
     args = parser.parse_args(argv)
 
     random.seed(args.seed)
@@ -151,7 +156,7 @@ def main(argv: list[str] | None = None) -> int:
         json.dumps(_group_means(rows, "seed", metric_names), indent=2, sort_keys=True) + "\n"
     )
     (out_dir / "table.tex").write_text(_table(summary) + "\n")
-    (out_dir / "report.md").write_text(_report(summary) + "\n")
+    _write_markdown_report(out_dir, summary, no_markdown_report=args.no_markdown_report)
     print(json.dumps({"out_dir": str(out_dir), "num_charts": len(charts)}, indent=2))
     return 0
 
@@ -243,6 +248,19 @@ def _report(summary: dict[str, Any]) -> str:
     return "\n".join(lines)
 
 
+def _write_markdown_report(
+    out_dir: Path,
+    summary: dict[str, Any],
+    *,
+    no_markdown_report: bool,
+) -> None:
+    report_path = out_dir / "report.md"
+    if no_markdown_report:
+        report_path.unlink(missing_ok=True)
+        return
+    report_path.write_text(_report(summary) + "\n")
+
+
 def _fmt(value: Any) -> str:
     return "n/a" if not isinstance(value, (int, float)) or not math.isfinite(value) else f"{value:.4f}"
 

workspace/tests/test_readme_only_markdown_flags.py

@@ -0,0 +1,82 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from scripts import audit_action_bounds
+from scripts import audit_chart_feature_sources
+from scripts import audit_cil_charts
+from scripts import build_action_scale_vector
+from scripts import build_data_accounting
+from scripts import calibrate_dominance
+from scripts import check_tangent_reconstruction
+from scripts import eval_chart_positive_memory_proxy
+from scripts import export_chart_object_embeddings
+from scripts import export_chart_observation_embeddings
+from scripts import train_utility_energy
+
+
+def test_readme_only_report_helpers_remove_stale_markdown(tmp_path: Path) -> None:
+    writers = [
+        lambda out: build_data_accounting._write_markdown_report(
+            out,
+            {},
+            no_markdown_report=True,
+        ),
+        lambda out: audit_cil_charts._write_markdown_report(out, {}, no_markdown_report=True),
+        lambda out: check_tangent_reconstruction._write_markdown_report(
+            out,
+            {},
+            no_markdown_report=True,
+        ),
+        lambda out: audit_chart_feature_sources._write_markdown_report(
+            out,
+            {},
+            no_markdown_report=True,
+        ),
+        lambda out: audit_action_bounds._write_markdown_report(
+            out,
+            {},
+            no_markdown_report=True,
+        ),
+        lambda out: export_chart_observation_embeddings._write_markdown_report(
+            out,
+            {},
+            no_markdown_report=True,
+        ),
+        lambda out: export_chart_object_embeddings._write_markdown_report(
+            out,
+            {},
+            no_markdown_report=True,
+        ),
+        lambda out: eval_chart_positive_memory_proxy._write_markdown_report(
+            out,
+            "local_atlas",
+            1,
+            {},
+            no_markdown_report=True,
+        ),
+        lambda out: build_action_scale_vector._write_markdown_report(
+            out,
+            {},
+            no_markdown_report=True,
+        ),
+        lambda out: calibrate_dominance._write_markdown_report(
+            out,
+            {},
+            no_markdown_report=True,
+        ),
+        lambda out: train_utility_energy._write_markdown_report(
+            out,
+            {},
+            no_markdown_report=True,
+        ),
+    ]
+    for index, writer in enumerate(writers):
+        out_dir = tmp_path / f"run_{index}"
+        out_dir.mkdir()
+        report_path = out_dir / "report.md"
+        report_path.write_text("stale\n")
+
+        writer(out_dir)
+
+        assert not report_path.exists()