Merge branch 'master' into conv1d_perf

Author: Oslomayor

.gitignore

@@ -40,3 +40,6 @@ tests/*.json
 
 # Generated benchmark data (lives in gh-pages only)
 docs/benchmark/
+
+# Local outputs from FlagTune
+/flagtune*/

pyproject.toml

@@ -261,11 +261,15 @@ flaggems-setup = "flaggems_setup:main"
 # Package discovery (including shipping the tests/ and benchmark/ suites under
 # collision-safe names) is defined in setup.py, so it is intentionally omitted
 # here — declaring `packages` in both places is an error.
+flaggems-flagtune-pretune = "flag_gems.flagtune.cli.pretune:main"
+flaggems-flagtune-train = "flag_gems.flagtune.cli.train:main"
+flaggems-flagtune-compare = "flag_gems.flagtune.cli.compare:main"
 
 [tool.setuptools.package-data]
 
 "flag_gems" = ["backends.yaml"]
 "flag_gems.runtime" = ["*/**/*.yaml"]
+"flag_gems.flagtune.contracts" = ["configs/*.yaml"]
 
 [tool.setuptools_scm]
 write_to = "src/flag_gems/_version.py"

src/flag_gems/flagtune/__init__.py

@@ -0,0 +1,7 @@
+"""Offline FlagTune collection, training, and reporting for FlagGems.
+
+This package is intentionally separate from :mod:`flag_gems.utils`: it owns a
+complete offline workflow rather than a reusable low-level helper.  Import the
+library API from :mod:`flag_gems.flagtune.collection`; invoke user-facing
+commands through the three ``flaggems-flagtune-*`` console scripts.
+"""

src/flag_gems/flagtune/cli/__init__.py

@@ -0,0 +1,5 @@
+"""Thin console-command entry points for FlagGems FlagTune workflows.
+
+Each module owns argument parsing and process exit behavior for exactly one
+command: Pretune collection, ranker training, or run comparison.
+"""