Enhance tool documentation and add new features

- Added module-level documentation for memory tools (`remember`, `recall`, `forget`) to clarify their purpose.
- Improved documentation in `recall.rs` and `remember.rs` to describe the functionality and flow of memory entry operations.
- Updated `mod.rs` to include descriptions for the tool trait and execution context.
- Enhanced `plan.rs` with detailed comments on plan-mode signaling tools.
- Documented text search tools in `search.rs` to explain their functionality.
- Improved sequential-thinking tool documentation in `seqthink.rs`.
- Added safety filter documentation in `shell_filter` for credential and git operations.
- Enhanced utility tools documentation, including `cd`, `dir_cache_update`, and `todowrite`.
- Improved rendering documentation in view modules (`chat`, `markdown`, `status`, `workflow`) to clarify rendering flows and purposes.

src/app/mode/effort.rs

@@ -1,3 +1,6 @@
+//! Effort mode: cycles the agent's reasoning effort level, which scales the
+//! LLM's temperature and max_tokens for subsequent turns.
+
 use crate::app::state::rest::AppStateRest;
 
 pub const EFFORT_LEVELS: &[&str] = &["low", "medium", "high", "xhigh", "max"];
@@ -17,15 +20,24 @@ pub fn generation_params(level: usize, base_max_tokens: u32) -> (f32, u32) {
     (temperature, max_tokens.max(256))
 }
 
+/// Return the current effort level index, clamped to a valid `EFFORT_LEVELS` slot.
+///
+/// Why: clamping guards against a stale/out-of-range value in loaded state
+/// (e.g. after `EFFORT_LEVELS` shrinks between versions).
 pub fn current_effort(state: &AppStateRest) -> usize {
     state.misc.effort_level.min(EFFORT_LEVELS.len() - 1)
 }
 
+/// Return the current effort level's display name (e.g. "medium").
 pub fn current_effort_str(state: &AppStateRest) -> &'static str {
     let idx = current_effort(state);
     EFFORT_LEVELS[idx]
 }
 
+/// Advance to the next effort level, wrapping around, and toast the new value.
+///
+/// Flow: compute `(current + 1) % len` → store it → push an info toast with
+/// the new level's label → mark state dirty.
 pub fn cycle_effort(state: &mut AppStateRest) {
     let current = current_effort(state);
     state.misc.effort_level = (current + 1) % EFFORT_LEVELS.len();