docs(resources): clarify defaultPath launch override

Author: MioYuuIH

dockerfiles/Code/README.md

@@ -86,7 +86,7 @@ images continue to share one package set and the Dockerfile remains small.
 The start script launches:
 
 ```bash
-code-server --auth none --bind-addr 127.0.0.1:8889 --ignore-last-opened "${AUPLC_CODE_WORKDIR:-/home/jovyan}"
+code-server --auth none --bind-addr 127.0.0.1:8889 --ignore-last-opened "${AUPLC_CODE_WORKDIR:-$(pwd)}"
 nginx -c /tmp/auplc-code-server-nginx.conf -g 'daemon off;'
 ```
 

dockerfiles/Code/start-code-server.sh

@@ -10,6 +10,7 @@ export NPM_CONFIG_PREFIX="${NPM_CONFIG_PREFIX:-${HOME:-/home/jovyan}/.local}"
 public_port="${PORT:-8888}"
 code_server_port="${AUPLC_CODE_SERVER_PORT:-8889}"
 service_prefix="${JUPYTERHUB_SERVICE_PREFIX:-/}"
+# Without a Hub-provided launch override, open code-server in the image WORKDIR.
 workdir="${AUPLC_CODE_WORKDIR:-$(pwd)}"
 extensions_list="${AUPLC_CODE_EXTENSIONS_LIST:-/opt/auplc/extensions/extensions.txt}"
 local_extensions_dir="${AUPLC_CODE_LOCAL_EXTENSIONS_DIR:-/opt/auplc/extensions/local}"

runtime/hub/core/spawner/kubernetes.py

@@ -451,6 +451,10 @@ def _resolve_target_path(self, resource_type: str, custom_repo_path: str | None
 
         resource_metadata = self._hub_config.get_resource_metadata(resource_type) if self._hub_config else None
         default_path = str(getattr(resource_metadata, "defaultPath", "") or "").strip()
+
+        # defaultPath is a Hub launch-dir override, not the image WORKDIR.
+        # If it is omitted, preserve the image/application default instead of
+        # guessing a path; this keeps non-standard images in their own WORKDIR.
         return default_path or None
 
     def _apply_target_path_mapping(self, resource_type: str, target_path: str | None) -> None:

runtime/values.yaml

@@ -325,6 +325,10 @@ custom:
 
     # Course Metadata (for spawn UI)
     # Defines display information for each course
+    # defaultPath is an optional Hub launch-directory override, not the image
+    # WORKDIR. Custom Repo launches always open the cloned repository first. If
+    # defaultPath is omitted or null, Hub does not force a landing path and the
+    # image/application default normally follows the image WORKDIR.
     metadata:
       cpu:
         group: "CUSTOM REPOS"