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/subagent/context.rs

@@ -1,8 +1,14 @@
+//! Construction of a `SubagentContext` from an `AgentDefinition`,
+//! including the default read-only tool set for reviewer agents.
+
 use std::path::PathBuf;
 use super::spawn::AgentDefinition;
 
+/// Default read-only tool names granted to `role == "reviewer"` agents.
 pub const REVIEWER_ALLOWED: &[&str] = &["read", "grep", "glob", "recall", "remember"];
 
+/// Per-invocation configuration for a subagent: prompt, allowed tools,
+/// step budget, and the session directory it should operate against.
 pub struct SubagentContext {
     pub system_prompt: String,
     pub allowed_tools: Vec<String>,
@@ -10,6 +16,14 @@ pub struct SubagentContext {
     pub session_dir: PathBuf,
 }
 
+/// Build a `SubagentContext` from an `AgentDefinition`.
+///
+/// Flow: copy optional `allowed_tools` from the def -> fall back to the
+/// reviewer-allowlist when the def has none and the role is "reviewer" ->
+/// fall back to an empty list (i.e. "all tools allowed") for other roles.
+///
+/// Return: a context with empty `system_prompt` and `session_dir`,
+/// `max_steps = 25`, and the resolved allowed-tool list.
 pub fn build_subagent_context(def: AgentDefinition) -> SubagentContext {
     let allowed_tools = def.allowed_tools.clone().unwrap_or_else(|| {
         if def.role == "reviewer" {