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/workflow/script.rs

@@ -1,16 +1,27 @@
+//! Script primitives for the workflow engine: agent invocation, parallel
+//! execution, pipelines, and phases.
+
 use serde::{Deserialize, Serialize};
 
+/// A workflow script primitive — can be a single agent, a parallel fan-out,
+/// a sequential pipeline, or a named phase.
 #[derive(Debug, Clone, Serialize, Deserialize)]
 pub enum ScriptPrimitive {
+    /// Run a single agent with the given prompt template.
     Agent(String),
+    /// Execute several primitives concurrently.
     Parallel(Vec<ScriptPrimitive>),
+    /// Execute several primitives sequentially, each waiting for the
+    /// previous to complete.
     Pipeline(Vec<ScriptPrimitive>),
+    /// A named wrapper around another primitive (used for display/tracing).
     Phase {
         name: String,
         script: Box<ScriptPrimitive>,
     },
 }
 
+/// Runtime options for a workflow execution.
 #[derive(Debug, Clone, Serialize, Deserialize)]
 pub struct ScriptOptions {
     pub max_concurrency: usize,
@@ -28,6 +39,7 @@ impl Default for ScriptOptions {
     }
 }
 
+/// A named, versioned workflow script with its primitives and options.
 #[derive(Debug, Clone, Serialize, Deserialize)]
 pub struct WorkflowScript {
     pub name: String,