Feat: cleanup

crates/forth/src/compiler.rs

@@ -1,3 +1,5 @@
+//! Single-pass compiler from Forth source text to Op sequences.
+
 use std::borrow::Cow;
 use std::sync::Arc;
 

crates/forth/src/lib.rs

@@ -1,3 +1,5 @@
+//! Forth virtual machine for the Cagire music sequencer.
+
 mod compiler;
 mod ops;
 mod theory;

crates/forth/src/ops.rs

@@ -1,3 +1,5 @@
+//! Compiled operation variants for the Forth VM instruction set.
+
 use std::sync::Arc;
 
 use super::types::SourceSpan;

crates/forth/src/types.rs

@@ -1,3 +1,5 @@
+//! Core types for the Forth VM: values, execution context, and shared state.
+
 use arc_swap::ArcSwap;
 use parking_lot::Mutex;
 use rand::rngs::StdRng;

crates/forth/src/vm.rs

@@ -1,3 +1,5 @@
+//! Stack-based Forth interpreter with audio command generation.
+
 use parking_lot::Mutex;
 use rand::rngs::StdRng;
 use rand::{Rng as RngTrait, SeedableRng};
@@ -29,12 +31,10 @@ impl Forth {
         }
     }
 
-    #[allow(dead_code)]
     pub fn stack(&self) -> Vec<Value> {
         self.stack.lock().clone()
     }
 
-    #[allow(dead_code)]
     pub fn clear_stack(&self) {
         self.stack.lock().clear();
     }

crates/project/src/lib.rs

@@ -1,3 +1,5 @@
+//! Project data model: banks, patterns, and steps for the Cagire sequencer.
+
 mod file;
 mod project;
 

crates/project/src/project.rs

@@ -1,3 +1,5 @@
+//! Project, Bank, Pattern, and Step structs with serialization.
+
 use std::path::PathBuf;
 
 use serde::{Deserialize, Deserializer, Serialize, Serializer};

crates/ratatui/src/lib.rs

@@ -1,3 +1,5 @@
+//! Reusable TUI widgets for the Cagire sequencer interface.
+
 mod category_list;
 mod confirm;
 mod editor;