Function createAndSaveSnapshot

src/utils/bash/ShellSnapshot.ts:414–610

(
  binShell: string,
)

 * @returns Promise that resolves to the snapshot file path or undefined if creation failed
 */
export const createAndSaveSnapshot = async (
  binShell: string,
): Promise<string | undefined> => {
  const shellType = binShell.includes('zsh')
    ? 'zsh'
    : binShell.includes('bash')
      ? 'bash'
      : 'sh'

  logForDebugging(`Creating shell snapshot for ${shellType} (${binShell})`)

  return new Promise(async resolve => {
    try {
      const configFile = getConfigFile(binShell)
      logForDebugging(`Looking for shell config file: ${configFile}`)
      const configFileExists = await pathExists(configFile)

      if (!configFileExists) {
        logForDebugging(
          `Shell config file not found: ${configFile}, creating snapshot with NCode defaults only`,
        )
      }

      // Create unique snapshot path with timestamp and random ID
      const timestamp = Date.now()
      const randomId = Math.random().toString(36).substring(2, 8)
      const snapshotsDir = join(getClaudeConfigHomeDir(), 'shell-snapshots')
      logForDebugging(`Snapshots directory: ${snapshotsDir}`)
      const shellSnapshotPath = join(
        snapshotsDir,
        `snapshot-${shellType}-${timestamp}-${randomId}.sh`,
      )

      // Ensure snapshots directory exists
      try {
        await mkdir(snapshotsDir, { recursive: true })
      } catch (error) {
        if (isFsInaccessible(error)) {
          logForDebugging(
            `Skipping shell snapshot creation: snapshots dir unavailable (${String(error)})`,
            { level: 'warn' },
          )
          resolve(undefined)
          return
        }
        throw error
      }

      try {
        await writeFile(shellSnapshotPath, '', { mode: 0o600, flag: 'wx' })
        await unlink(shellSnapshotPath)
      } catch (error) {
        if (isFsInaccessible(error)) {
          logForDebugging(
            `Skipping shell snapshot creation: snapshot path unavailable (${String(error)})`,
            { level: 'warn' },
          )
          resolve(undefined)