Feature request: Notifications for approval prompts, job completion, and file saves #3052

// codex config
{
  "notify": {
    // enable/disable globally; default: true if previously enabled
    "enabled": true,

    // events to notify on (default: ["sessionComplete"])
    "on": [
      "sessionComplete",      // existing behavior
      "approvalPending",      // NEW: user approval required
      "jobCompleted",         // NEW: tool/task finished
      "fileWrite"             // NEW: file create/modify/move/delete
    ],

    // channels to use (any subset)
    "channels": [
      "systemNotification",   // native system notification (current)
      "sound",                // short chime
      "command"               // run a shell command
    ],

    // optional sound + command payloads
    "sound": {
      "enabled": true,
      "path": "/System/Library/Sounds/Glass.aiff", // macOS example
      "volume": 1.0
    },
    "command": {
      "enabled": false,
      "cmd": "afplay /System/Library/Sounds/Glass.aiff"
    },

    // allow per-event customization (overrides top-level)
    "overrides": {
      "approvalPending": { "channels": ["systemNotification","sound"] },
      "jobCompleted":    { "channels": ["sound"] },
      "fileWrite":       { "channels": ["systemNotification"] }
    }
  }
}

// notificationBus.ts
export type NotifyEvent = "sessionComplete" | "approvalPending" | "jobCompleted" | "fileWrite";
export function notify(event: NotifyEvent, payload?: any) {
  if (!cfg.notify.enabled) return;
  const spec = resolveChannelsFor(event, cfg.notify);
  if (spec.systemNotification) systemNotify(event, payload);
  if (spec.sound) playSound(spec.sound.path);
  if (spec.command) run(spec.command.cmd);
}

// approval flow
if (requiresApproval) {
  notify("approvalPending", { kind: "command", text: cmdPreview });
  await showApprovalUI(...);
}

// tool run completion
const result = await runTool(step);
notify("jobCompleted", { step, ok: result.ok, ms: result.ms });

// after file operations succeed
const stats = await applyFileChanges(changes);
notify("fileWrite", { stats });  // e.g., {created:1, modified:3, deleted:0}