Function runInitHook

src/node/runtime/LocalBaseRuntime.ts:424–513

* Helper to run .mux/init hook if it exists and is executable. * Shared between WorktreeRuntime and LocalRuntime. * @param workspacePath - Path to the workspace directory * @param muxEnv - MUX_ environment variables (from getMuxEnv) * @param initLogger - Logger for streaming output *

(
    workspacePath: string,
    muxEnv: Record<string, string>,
    initLogger: InitLogger,
    abortSignal?: AbortSignal
  )

   * @param abortSignal - Optional abort signal
   */
  protected async runInitHook(
    workspacePath: string,
    muxEnv: Record<string, string>,
    initLogger: InitLogger,
    abortSignal?: AbortSignal
  ): Promise<void> {
    // Hook path is derived from MUX_PROJECT_PATH in muxEnv
    const projectPath = muxEnv.MUX_PROJECT_PATH;
    const hookPath = getInitHookPath(projectPath);
    initLogger.logStep(`Running init hook: ${hookPath}`);

    if (abortSignal?.aborted) {
      initLogger.logComplete(EXIT_CODE_ABORTED);
      return;
    }

    // Create line-buffered loggers
    const loggers = createLineBufferedLoggers(initLogger);

    return new Promise<void>((resolve) => {
      const bashPath = getBashPath();
      const proc = spawn(bashPath, ["-c", shellQuote(hookPath)], {
        cwd: workspacePath,
        stdio: ["ignore", "pipe", "pipe"],
        env: {
          ...process.env,
          ...muxEnv,
        },
        // Prevent console window from appearing on Windows
        windowsHide: true,
        // Spawn as a detached process group leader so we can reliably cancel the hook.
        detached: true,
      });

      let aborted = false;

      const onAbort = () => {
        aborted = true;

        if (proc.pid !== undefined) {
          killProcessTree(proc.pid);
          return;
        }

        try {
          proc.kill("SIGKILL");
        } catch {
          // ignore
        }
      };

      abortSignal?.addEventListener("abort", onAbort, { once: true });
      if (abortSignal?.aborted) {
        onAbort();
      }

      proc.stdout.on("data", (data: Buffer) => {
        loggers.stdout.append(data.toString());