huskies: merge 542_refactor_add_doc_comments_to_all_undocumented_source_files_and_generate_source_map_in_readme

server/src/llm/chat.rs

@@ -1,3 +1,4 @@
+//! LLM chat — orchestrates multi-turn conversations with tool-calling LLM providers.
 use crate::slog;
 use crate::io::onboarding;
 use crate::llm::prompts::{ONBOARDING_PROMPT, SYSTEM_PROMPT};

server/src/llm/mod.rs

@@ -1,3 +1,4 @@
+//! LLM subsystem — chat orchestration, prompts, OAuth, and provider integrations.
 pub mod chat;
 pub mod oauth;
 pub mod prompts;

server/src/llm/oauth.rs

@@ -1,3 +1,4 @@
+//! Anthropic OAuth — token refresh and credential management for Claude API access.
 use crate::slog;
 use serde::{Deserialize, Serialize};
 use std::path::PathBuf;

server/src/llm/prompts.rs

@@ -1,3 +1,4 @@
+//! System prompts — static prompt templates for the LLM chat and onboarding flows.
 pub const SYSTEM_PROMPT: &str = r#"You are an AI Agent with direct access to the user's filesystem and development environment.
 
 CRITICAL INSTRUCTIONS:

server/src/llm/providers/anthropic.rs

@@ -1,3 +1,4 @@
+//! Anthropic provider — streaming completion client for the Claude Messages API.
 use crate::llm::types::{
     CompletionResponse, FunctionCall, Message, Role, ToolCall, ToolDefinition,
 };

server/src/llm/providers/claude_code.rs

@@ -1,3 +1,4 @@
+//! Claude Code provider — runs Claude Code CLI in a PTY and parses structured output.
 use crate::slog;
 use portable_pty::{CommandBuilder, PtySize, native_pty_system};
 use std::io::{BufRead, BufReader};

server/src/llm/providers/mod.rs

@@ -1,3 +1,4 @@
+//! LLM providers — module declarations for Anthropic, Claude Code, and Ollama backends.
 pub mod anthropic;
 pub mod claude_code;
 pub mod ollama;

server/src/llm/providers/ollama.rs

@@ -1,3 +1,4 @@
+//! Ollama provider — streaming completion client for locally-hosted Ollama models.
 use crate::llm::types::{
     CompletionResponse, FunctionCall, Message, ModelProvider, Role, ToolCall, ToolDefinition,
 };

server/src/llm/types.rs

@@ -1,3 +1,4 @@
+//! LLM types — `Message`, `Role`, `ToolCall`, `ModelProvider`, and related data structures.
 use async_trait::async_trait;
 use serde::{Deserialize, Serialize};
 use std::fmt::Debug;