Function ensureMuxCoderSSHConfigFile

src/node/runtime/muxSshConfigWriter.ts:222–254

(
  opts: EnsureMuxCoderSSHConfigFileOptions
)

}

export async function ensureMuxCoderSSHConfigFile(
  opts: EnsureMuxCoderSSHConfigFileOptions
): Promise<void> {
  const configuredSSHConfigPath = opts.sshConfigPath ?? path.join(os.homedir(), ".ssh", "config");
  // Preserve users' symlinked ~/.ssh/config setups by writing to the symlink target,
  // rather than replacing the symlink path itself.
  const sshConfigPath = await resolveSSHConfigWritePath(configuredSSHConfigPath);
  const sshConfigDir = path.dirname(sshConfigPath);

  await fs.mkdir(sshConfigDir, { recursive: true, mode: 0o700 });

  const { content: existingContent, mode: existingMode } =
    await loadSSHConfigContent(sshConfigPath);

  const startMarkerCount = countOccurrences(existingContent, MUX_CODER_SSH_BLOCK_START);
  const endMarkerCount = countOccurrences(existingContent, MUX_CODER_SSH_BLOCK_END);

  if (startMarkerCount > 1 || endMarkerCount > 1) {
    throw new Error("Corrupted SSH config: duplicate Mux Coder SSH markers detected.");
  }

  if (startMarkerCount !== endMarkerCount) {
    throw new Error("Corrupted SSH config: mismatched Mux Coder SSH markers detected.");
  }

  const nextMuxBlock = renderMuxBlock(opts.coderBinaryPath);
  const nextContent =
    startMarkerCount === 1
      ? replaceMuxBlock(existingContent, nextMuxBlock)
      : appendMuxBlock(existingContent, nextMuxBlock);

  await writeConfigAtomically(sshConfigPath, nextContent, existingMode);
}