feat:org-config: Add function to clear org-element cache

Introduce `cj/org-clear-element-cache` to clear the org-element
cache for the current buffer or all buffers. This is useful for
resolving parsing errors encountered during agenda generation, such
as 'wrong-type-argument stringp nil'. The function can be triggered
with a prefix argument to clear the cache for all org buffers, or
without it to clear only the current buffer's cache.

1 files changed, 18 insertions, 0 deletions

diff --git a/modules/org-config.el b/modules/org-config.el
index 8fe8ed6d..0249973f 100644
--- a/modules/org-config.el
+++ b/modules/org-config.el
@@ -248,5 +248,23 @@ with a file, the function will throw an error."
         (message "Copied Org link to current file to clipboard: %s" link))
     (user-error "Buffer isn't associated with a file, so no link sent to clipboard")))
 
+;; ----------------------- Org Element Cache Management ------------------------
+
+(defun cj/org-clear-element-cache ()
+  "Clear the org-element cache for the current buffer or all buffers.
+With prefix argument, clear cache for all org buffers. Otherwise, clear only
+the current buffer's cache. Useful when encountering parsing errors like
+'wrong-type-argument stringp nil' during agenda generation."
+  (interactive)
+  (if current-prefix-arg
+      (progn
+        (org-element-cache-reset 'all)
+        (message "Cleared org-element cache for all buffers"))
+    (if (derived-mode-p 'org-mode)
+        (progn
+          (org-element-cache-reset)
+          (message "Cleared org-element cache for current buffer"))
+      (user-error "Current buffer is not in org-mode"))))
+
 (provide 'org-config)
 ;;; org-config.el ends here