diff --git a/apps/ui/src/components/views/ideation-view/components/ideation-settings-popover.tsx b/apps/ui/src/components/views/ideation-view/components/ideation-settings-popover.tsx
index a96becdd..a5dc3195 100644
--- a/apps/ui/src/components/views/ideation-view/components/ideation-settings-popover.tsx
+++ b/apps/ui/src/components/views/ideation-view/components/ideation-settings-popover.tsx
@@ -53,6 +53,10 @@ const IDEATION_CONTEXT_OPTIONS: Array<{
   },
 ];
 
+/**
+ * Renders a settings popover to toggle per-project ideation context sources.
+ * Merges defaults with stored overrides and persists changes via the ideation store.
+ */
 export function IdeationSettingsPopover({ projectPath }: IdeationSettingsPopoverProps) {
   const { projectOverrides, setContextSource } = useIdeationStore(
     useShallow((state) => ({
diff --git a/apps/ui/src/store/ideation-store.ts b/apps/ui/src/store/ideation-store.ts
index dde9bdf6..9e4f135b 100644
--- a/apps/ui/src/store/ideation-store.ts
+++ b/apps/ui/src/store/ideation-store.ts
@@ -116,7 +116,14 @@ interface IdeationActions {
   setFilterStatus: (status: IdeaStatus | 'all') => void;
 
   // Context sources
+  /**
+   * Returns the effective context-source settings for a project,
+   * merging defaults with any stored overrides.
+   */
   getContextSources: (projectPath: string) => IdeationContextSources;
+  /**
+   * Updates a single context-source flag for a project.
+   */
   setContextSource: (
     projectPath: string,
     key: keyof IdeationContextSources,