huskies: merge 542_refactor_add_doc_comments_to_all_undocumented_source_files_and_generate_source_map_in_readme

server/src/io/fs/files.rs

@@ -1,3 +1,4 @@
+//! Filesystem file operations — read, write, list, and create files and directories.
 use crate::state::SessionState;
 use serde::Serialize;
 use std::fs;

server/src/io/fs/mod.rs

@@ -1,3 +1,4 @@
+//! Filesystem I/O — module declarations and re-exports for file operations.
 pub mod files;
 pub mod paths;
 pub mod preferences;

server/src/io/fs/paths.rs

@@ -1,3 +1,4 @@
+//! Path resolution — resolves CLI and session-relative paths to absolute paths.
 use crate::state::SessionState;
 use std::path::{Path, PathBuf};
 

server/src/io/fs/preferences.rs

@@ -1,3 +1,4 @@
+//! User preferences — reads and writes model selection and other user settings.
 use crate::store::StoreOps;
 use serde_json::json;
 

server/src/io/fs/project.rs

@@ -1,3 +1,4 @@
+//! Project management — tracks known projects and resolves the active project root.
 use crate::state::SessionState;
 use crate::store::StoreOps;
 use serde_json::json;

server/src/io/fs/scaffold.rs

@@ -1,3 +1,4 @@
+//! Project scaffolding — creates the `.huskies/` directory structure and default files.
 use std::fs;
 use std::path::Path;
 

server/src/io/mod.rs

@@ -1,3 +1,4 @@
+//! I/O subsystem — filesystem, shell, search, onboarding, and story metadata operations.
 pub mod fs;
 pub mod onboarding;
 pub mod search;

server/src/io/onboarding.rs

@@ -1,3 +1,4 @@
+//! Onboarding detection — checks whether scaffold templates have been customized.
 use std::path::Path;
 
 /// Sentinel comment injected as the first line of scaffold templates.

server/src/io/search.rs

@@ -1,3 +1,4 @@
+//! Code search — full-text search across project files using the `ignore` crate.
 use crate::slog;
 use crate::state::SessionState;
 use ignore::WalkBuilder;

server/src/io/shell.rs

@@ -1,3 +1,4 @@
+//! Shell command execution — runs commands in the project directory and captures output.
 use crate::state::SessionState;
 use serde::Serialize;
 use std::path::PathBuf;

server/src/io/story_metadata.rs

@@ -1,3 +1,4 @@
+//! Story metadata — parses and modifies YAML front matter in story markdown files.
 use serde::Deserialize;
 use std::fs;
 use std::path::Path;

server/src/io/wizard.rs

@@ -1,3 +1,4 @@
+//! Setup wizard — multi-step project onboarding flow with per-step status tracking.
 use serde::{Deserialize, Serialize};
 use serde_json;
 use std::fs;