[loop-cycle] refactor: add docstrings to 20 undocumented classes (#1130) (#1166)

src/dashboard/models/calm.py

@@ -8,6 +8,7 @@ from .database import Base  # Assuming a shared Base in models/database.py
 
 
 class TaskState(StrEnum):
+    """Enumeration of possible task lifecycle states."""
     LATER = "LATER"
     NEXT = "NEXT"
     NOW = "NOW"
@@ -16,12 +17,14 @@ class TaskState(StrEnum):
 
 
 class TaskCertainty(StrEnum):
+    """Enumeration of task time-certainty levels."""
     FUZZY = "FUZZY"  # An intention without a time
     SOFT = "SOFT"  # A flexible task with a time
     HARD = "HARD"  # A fixed meeting/appointment
 
 
 class Task(Base):
+    """SQLAlchemy model representing a CALM task."""
     __tablename__ = "tasks"
 
     id = Column(Integer, primary_key=True, index=True)
@@ -52,6 +55,7 @@ class Task(Base):
 
 
 class JournalEntry(Base):
+    """SQLAlchemy model for a daily journal entry with MITs and reflections."""
     __tablename__ = "journal_entries"
 
     id = Column(Integer, primary_key=True, index=True)