docs: add JSDoc comments to date.ts and llm-reasoning.ts

Author: dangzitou

src/infra/date.ts

@@ -1,3 +1,9 @@
+/**
+ * Return a `YYYY-MM-DD` date stamp for the given date using local time.
+ *
+ * @param date - The date to format (defaults to now).
+ * @returns A `YYYY-MM-DD` formatted string in local time.
+ */
 export function getLocalDateStamp(date: Date = new Date()): string {
 	const year = date.getFullYear();
 	const month = String(date.getMonth() + 1).padStart(2, '0');
@@ -6,6 +12,12 @@ export function getLocalDateStamp(date: Date = new Date()): string {
 	return `${year}-${month}-${day}`;
 }
 
+/**
+ * Build the daily note markdown filename for the given date.
+ *
+ * @param date - The date to use (defaults to now).
+ * @returns A filename like `openmeta-daily-2026-06-18.md`.
+ */
 export function getDailyNoteFileName(date: Date = new Date()): string {
 	return `openmeta-daily-${getLocalDateStamp(date)}.md`;
 }

src/infra/llm-reasoning.ts

@@ -1,5 +1,6 @@
 import type { LLMReasoningEffort } from '../types/index.js';
 
+/** All supported reasoning effort levels, ordered from least to most intensive. */
 export const LLM_REASONING_EFFORTS = [
 	'none',
 	'minimal',
@@ -8,8 +9,16 @@ export const LLM_REASONING_EFFORTS = [
 	'high',
 	'xhigh',
 ] as const satisfies readonly LLMReasoningEffort[];
+/** Default reasoning effort applied when no override is configured. */
 export const DEFAULT_LLM_REASONING_EFFORT: LLMReasoningEffort = 'none';
 
+/**
+ * Parse a user-supplied string into a valid {@link LLMReasoningEffort}.
+ *
+ * @param value - Raw string input (case-insensitive, whitespace-trimmed).
+ * @returns The matching effort level.
+ * @throws {Error} If the value does not match any known effort level.
+ */
 export function parseLLMReasoningEffort(value: string): LLMReasoningEffort {
 	const normalized = value.trim().toLowerCase();
 	if (LLM_REASONING_EFFORTS.includes(normalized as LLMReasoningEffort)) {