Function cleanup

src/app.js:573–599

(reason, err, { exit = false } = {})

}

async function cleanup(reason, err, { exit = false } = {}) {
  if (quitting && exit) {
    DEBUG.verbose && console.log(chalk.cyan(`Cleanup already in progress for exit. Reason: ${reason}`));
    return;
  }
  console.log(chalk.cyan(`\nInitiating shutdown sequence. Reason: ${reason}`));
  if (err) {
    console.error(chalk.red('Error during operation or shutdown:'), err instanceof Error ? err.stack : err);
  }

  if (exit) quitting = true;

  DEBUG.verbose && console.log(chalk.yellow(`Cleanup called. Reason: ${reason}`));

  Archivist.shutdown(); // Signal archivist to stop its work
  LibraryServer.stop(); // Stop the HTTP server

  // Note: We don't explicitly kill the browser here if it was launched by us.
  // Its 'exit' handler calls cleanup. If the user chose 'connect', we don't own the process.
  // If 'shutdown_all_and_exit' was chosen, browsers were killed before this.

  if (exit) {
    console.log(chalk.cyan(`All components signaled to stop. Exiting in 3 seconds...`));
    await sleep(3000);
    process.exit(err instanceof Error ? 1 : 0);
  }
}