docs: surface training package cli help

2026-05-02 03:14:33 -04:00
parent 39bcb6b3ef
commit 427a444ba6
5 changed files with 104 additions and 12 deletions
@@ -94,9 +94,20 @@ def main(argv=None) -> int:


 def _build_parser() -> argparse.ArgumentParser:
-    parser = argparse.ArgumentParser(description="Smoke-check a Training Case package with local files.")
-    parser.add_argument("--input", default=str(DEFAULT_FIXTURE), help="Training Case package JSON path.")
-    parser.add_argument("--output", help="Optional public export JSON path.")
+    parser = argparse.ArgumentParser(
+        prog="scripts/run_training_case_package.py",
+        description="Offline package smoke: Training Case import/export smoke with local files.",
+        epilog=(
+            "Imports a public package from --input and writes public export/public output "
+            "to --output when set. On public errors, stdout is one-line JSON with "
+            "passed, input, output, and error. Stable public error codes include "
+            "input_file_not_found, input_path_is_directory, output_path_is_directory, "
+            "and output_path_unwritable."
+        ),
+    )
+    input_help = f"Public package JSON path to import (default: {DEFAULT_FIXTURE.relative_to(ROOT)})."
+    parser.add_argument("--input", default=str(DEFAULT_FIXTURE), help=input_help)
+    parser.add_argument("--output", help="Optional public export JSON path; writes public output only.")
    return parser