fix: raise CodeBundleError for include paths outside the bundle root

An Environment.include path that resolves outside the bundle root (or matches
no file) raised a bare ValueError that leaked as a crash report (FLYTE-SDK-5M),
even though the message is already user-actionable ("Pass --root-dir ...").
Convert these to CodeBundleError (a RuntimeUserError), which keeps the same
helpful message but is filtered from Sentry as a user configuration error.

fixes FLYTE-SDK-5M

Signed-off-by: Haytham Abuelfutuh <haytham@afutuh.com>

Author: EngHabu

src/flyte/_code_bundle/_utils.py

@@ -141,7 +141,9 @@ def ls_files(
             else:
                 matched = glob.glob(str(p))
                 if not matched:
-                    raise ValueError(f"include path {entry!r} is not a file, directory, or matching glob pattern.")
+                    from flyte.errors import CodeBundleError
+
+                    raise CodeBundleError(f"include path {entry!r} is not a file, directory, or matching glob pattern.")
                 extra_paths.extend(m for m in matched if pathlib.Path(m).is_file())
 
         existing = set(all_files)
@@ -153,7 +155,13 @@ def ls_files(
             try:
                 rel = resolved.relative_to(resolved_source)
             except ValueError as exc:
-                raise ValueError(
+                from flyte.errors import CodeBundleError
+
+                # An include path that resolves outside the bundle root is a user
+                # configuration problem (the message tells them how to fix it), not an SDK
+                # bug. Raise a typed user error so it is filtered from crash reporting instead
+                # of leaking as a raw ValueError (FLYTE-SDK-5M).
+                raise CodeBundleError(
                     f"include path {extra!r} is outside the bundle root {source_path!s}. "
                     f"Pass --root-dir (or configure it) one level up so every include lives under the root."
                 ) from exc

tests/flyte/code_bundle/test_includes.py

@@ -25,6 +25,7 @@
 from flyte._code_bundle._includes import collect_env_include_files
 from flyte._code_bundle._utils import ls_files
 from flyte._code_bundle.bundle import build_code_bundle
+from flyte.errors import CodeBundleError
 
 
 def _make_env_at(tmp_dir: Path, name: str, include: tuple[str, ...]) -> flyte.TaskEnvironment:
@@ -96,7 +97,7 @@ def test_ls_files_rejects_path_outside_source():
         outside_file.write_text("nope")
 
         with tempfile.TemporaryDirectory() as inside:
-            with pytest.raises(ValueError, match="outside the bundle root"):
+            with pytest.raises(CodeBundleError, match="outside the bundle root"):
                 ls_files(
                     Path(inside),
                     copy_file_detection="all",