[refactor] rename and simplify ProgressManager to FileProgress, enhance caching logic, update Hugging Face API integration, and clean up unused comments

crates/polyscribe-core/src/ui.rs

@@ -1,62 +1,46 @@
 // SPDX-License-Identifier: MIT
-// Copyright (c) 2025 <COPYRIGHT HOLDER>. All rights reserved.
 
-//! UI helpers powered by cliclack for interactive console experiences.
-//! Centralizes prompts, logging, and progress primitives.
-
-/// Progress indicators and reporting tools for displaying task completion.
 pub mod progress;
 
 use std::io;
 use std::io::IsTerminal;
 
-/// Log an informational message.
 pub fn info(msg: impl AsRef<str>) {
     let m = msg.as_ref();
     let _ = cliclack::log::info(m);
 }
 
-/// Log a warning message.
 pub fn warn(msg: impl AsRef<str>) {
     let m = msg.as_ref();
     let _ = cliclack::log::warning(m);
 }
 
-/// Log an error message.
 pub fn error(msg: impl AsRef<str>) {
     let m = msg.as_ref();
     let _ = cliclack::log::error(m);
 }
 
-/// Log a success message.
 pub fn success(msg: impl AsRef<str>) {
     let m = msg.as_ref();
     let _ = cliclack::log::success(m);
 }
 
-/// Log a note message with a prompt and a message.
 pub fn note(prompt: impl AsRef<str>, message: impl AsRef<str>) {
     let _ = cliclack::note(prompt.as_ref(), message.as_ref());
 }
 
-/// Print a short intro header.
 pub fn intro(title: impl AsRef<str>) {
     let _ = cliclack::intro(title.as_ref());
 }
 
-/// Print a short outro footer.
 pub fn outro(msg: impl AsRef<str>) {
     let _ = cliclack::outro(msg.as_ref());
 }
 
-/// Print a line that should appear above any progress indicators.
 pub fn println_above_bars(line: impl AsRef<str>) {
     let _ = cliclack::log::info(line.as_ref());
 }
 
-/// Prompt for input on stdin using cliclack's input component.
-/// Returns default if provided and user enters empty string.
-/// In non-interactive workflows, callers should skip prompt based on their flags.
 pub fn prompt_input(prompt: &str, default: Option<&str>) -> io::Result<String> {
     if crate::is_no_interaction() || !crate::stdin_is_tty() {
         return Ok(default.unwrap_or("").to_string());
@@ -68,7 +52,6 @@ pub fn prompt_input(prompt: &str, default: Option<&str>) -> io::Result<String> {
     q.interact().map_err(|e| io::Error::other(e.to_string()))
 }
 
-/// Present a single-choice selector and return the selected index.
 pub fn prompt_select(prompt: &str, items: &[&str]) -> io::Result<usize> {
     if crate::is_no_interaction() || !crate::stdin_is_tty() {
         return Err(io::Error::other("interactive prompt disabled"));
@@ -80,7 +63,6 @@ pub fn prompt_select(prompt: &str, items: &[&str]) -> io::Result<usize> {
     sel.interact().map_err(|e| io::Error::other(e.to_string()))
 }
 
-/// Present a multi-choice selector and return indices of selected items.
 pub fn prompt_multi_select(
     prompt: &str,
     items: &[&str],
@@ -106,17 +88,14 @@ pub fn prompt_multi_select(
     ms.interact().map_err(|e| io::Error::other(e.to_string()))
 }
 
-/// Confirm prompt with default, respecting non-interactive mode.
 pub fn prompt_confirm(prompt: &str, default: bool) -> io::Result<bool> {
     if crate::is_no_interaction() || !crate::stdin_is_tty() {
         return Ok(default);
     }
     let mut q = cliclack::confirm(prompt);
-    // If `cliclack::confirm` lacks default, we simply ask; caller can handle ESC/cancel if needed.
     q.interact().map_err(|e| io::Error::other(e.to_string()))
 }
 
-/// Read a secret/password without echoing, respecting non-interactive mode.
 pub fn prompt_password(prompt: &str) -> io::Result<String> {
     if crate::is_no_interaction() || !crate::stdin_is_tty() {
         return Err(io::Error::other(
@@ -127,7 +106,6 @@ pub fn prompt_password(prompt: &str) -> io::Result<String> {
     q.interact().map_err(|e| io::Error::other(e.to_string()))
 }
 
-/// Input with validation closure; on non-interactive returns default or error when no default.
 pub fn prompt_input_validated<F>(
     prompt: &str,
     default: Option<&str>,
@@ -151,18 +129,12 @@ where
         .map_err(|e| io::Error::other(e.to_string()))
 }
 
-/// A simple spinner wrapper built on top of `cliclack::spinner()`.
-///
-/// This wrapper provides a minimal API with start/stop/success/error methods
-/// to standardize spinner usage across the project.
 pub struct Spinner(cliclack::ProgressBar);
 
 impl Spinner {
-    /// Creates and starts a new spinner with the provided status text.
     pub fn start(text: impl AsRef<str>) -> Self {
         if crate::is_no_progress() || crate::is_no_interaction() || !std::io::stderr().is_terminal()
         {
-            // Fallback: no spinner, but log start
             let _ = cliclack::log::info(text.as_ref());
             let s = cliclack::spinner();
             Self(s)
@@ -172,7 +144,6 @@ impl Spinner {
             Self(s)
         }
     }
-    /// Stops the spinner with a submitted/completed style and message.
     pub fn stop(self, text: impl AsRef<str>) {
         let s = self.0;
         if crate::is_no_progress() {
@@ -181,17 +152,14 @@ impl Spinner {
             s.stop(text.as_ref());
         }
     }
-    /// Marks the spinner as successfully finished (alias for `stop`).
     pub fn success(self, text: impl AsRef<str>) {
         let s = self.0;
-        // cliclack progress bar uses `stop` for successful completion styling
         if crate::is_no_progress() {
             let _ = cliclack::log::success(text.as_ref());
         } else {
             s.stop(text.as_ref());
         }
     }
-    /// Marks the spinner as failed with an error style and message.
     pub fn error(self, text: impl AsRef<str>) {
         let s = self.0;
         if crate::is_no_progress() {
@@ -202,11 +170,9 @@ impl Spinner {
     }
 }
 
-/// Byte-count progress bar that respects `--no-progress` and TTY state.
 pub struct BytesProgress(Option<cliclack::ProgressBar>);
 
 impl BytesProgress {
-    /// Start a new progress bar with a total and initial position.
     pub fn start(total: u64, text: &str, initial: u64) -> Self {
         if crate::is_no_progress()
             || crate::is_no_interaction()
@@ -224,14 +190,12 @@ impl BytesProgress {
         Self(Some(b))
     }
 
-    /// Increment by delta bytes.
     pub fn inc(&mut self, delta: u64) {
         if let Some(b) = self.0.as_mut() {
             b.inc(delta);
         }
     }
 
-    /// Stop with a message.
     pub fn stop(mut self, text: &str) {
         if let Some(b) = self.0.take() {
             b.stop(text);
@@ -240,7 +204,6 @@ impl BytesProgress {
         }
     }
 
-    /// Mark as error with a message.
     pub fn error(mut self, text: &str) {
         if let Some(b) = self.0.take() {
             b.error(text);