Function runWorkspaceInitHook

src/node/runtime/initHook.ts:217–252

(
  options: WorkspaceInitHookOptions
)

 * plus any runtime-specific preparation that must happen before hook gating.
 */
export async function runWorkspaceInitHook(
  options: WorkspaceInitHookOptions
): Promise<WorkspaceInitResult> {
  const { params, runtimeType, hookCheckPath, beforeHook, runHook } = options;
  const { projectPath, branchName, initLogger, abortSignal, env } = params;

  try {
    // skipInitHook only disables repo-controlled hook execution; provisioning/materialization
    // that makes the workspace usable still belongs in beforeHook().
    await beforeHook?.();

    if (shouldSkipInitHook(params, initLogger)) {
      initLogger.logComplete(0);
      return { success: true };
    }

    const hookExists = await checkInitHookExists(hookCheckPath);
    if (!hookExists) {
      initLogger.logComplete(0);
      return { success: true };
    }

    initLogger.enterHookPhase?.();
    const muxEnv = { ...env, ...getMuxEnv(projectPath, runtimeType, branchName) };
    await runHook({ muxEnv, initLogger, abortSignal });
    return { success: true };
  } catch (error) {
    const errorMsg = error instanceof Error ? error.message : String(error);
    initLogger.logStderr(`Initialization failed: ${errorMsg}`);
    initLogger.logComplete(-1);
    return {
      success: false,
      error: errorMsg,
    };
  }
}

/**
 * Run .mux/init hook on a runtime and stream output to logger.