Add better help description for entrypoint override

Author: christian-stephen

cmd/orchestrator/main.go

@@ -39,7 +39,7 @@ type initCmd struct {
 }
 
 type overrideCmd struct {
-	Entrypoint []string `help:"Alternative entrypoint to run instead of GOAT. Must bootstrap GOAT."`
+	Entrypoint []string `help:"Custom init process to execute as PID 1, overriding orchestrator. Must accept and execute the orchestrator command/arguments (e.g., exec \"$@\"), propagate signals, and handle standard init responsibilities like reaping zombie processes."`
 
 	runTaskCmd
 }

cmd/orchestrator/testdata/override.txt

@@ -3,8 +3,11 @@ Usage: test-app [flags]
 Flags:
   -h, --help    Show context-sensitive help.
       --entrypoint=ENTRYPOINT,...
-                Alternative entrypoint to run instead of GOAT. Must bootstrap
-                GOAT ($CIRCLECI_GOAT_ENTRYPOINT).
+                Custom init process to execute as PID 1, overriding
+                orchestrator. Must accept and execute the orchestrator
+                command/arguments (e.g., exec "$@"), propagate signals,
+                and handle standard init responsibilities like reaping zombie
+                processes ($CIRCLECI_GOAT_ENTRYPOINT).
       --termination-grace-period=10s
                 How long the agent will wait for the task to complete if
                 interrupted ($CIRCLECI_GOAT_TERMINATION_GRACE_PERIOD).