diff options
| author | Craig Jennings <c@cjennings.net> | 2026-02-22 23:20:56 -0600 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-02-22 23:20:56 -0600 |
| commit | 5e6877e8f3fb552fce3367ff273167d2cf6af75f (patch) | |
| tree | 909f98edbbb940aafb95de02457d4d6f7db3cba4 /docs/workflows/find-email.org | |
| parent | b104dde43fcc717681a8733a977eb528c60eb13f (diff) | |
| download | archangel-5e6877e8f3fb552fce3367ff273167d2cf6af75f.tar.gz archangel-5e6877e8f3fb552fce3367ff273167d2cf6af75f.zip | |
chore: add docs/ to .gitignore and untrack personal files
docs/ contains session history, personal workflows, and private
protocols that shouldn't be in a public repository.
Diffstat (limited to 'docs/workflows/find-email.org')
| -rw-r--r-- | docs/workflows/find-email.org | 122 |
1 files changed, 0 insertions, 122 deletions
diff --git a/docs/workflows/find-email.org b/docs/workflows/find-email.org deleted file mode 100644 index 0ef9615..0000000 --- a/docs/workflows/find-email.org +++ /dev/null @@ -1,122 +0,0 @@ -#+TITLE: Find Email Workflow -#+AUTHOR: Craig Jennings & Claude -#+DATE: 2026-02-01 - -* Overview - -This workflow searches local maildir to find and identify emails matching specific criteria. Uses mu (maildir indexer) for fast searching. - -* Problem We're Solving - -Craig needs to find specific emails - shipping confirmations, receipts, correspondence with specific people, or messages about specific topics. Manually browsing mail folders is slow and error-prone. mu provides powerful search capabilities over the local maildir. - -* Exit Criteria - -Search is complete when: -1. Matching emails are identified (or confirmed none exist) -2. Relevant information is reported (subject, date, from, message path) -3. Craig has what they need to proceed (info extracted, or path for further action) - -* When to Use This Workflow - -When Craig says: -- "find email about [topic]" -- "search for emails from [person]" -- "do I have an email about [subject]?" -- "look for [shipping/receipt/confirmation] email" -- Before extract-email workflow (to locate the target email) - -* The Workflow -** Step 0: Context Hygiene - -Before starting, write out the session context file and check with Craig whether we could compact the context. This might be a long process. If the context window collapses, we may forget important details. Writing out the session context prevents this data loss. - -** Step 1: Ensure Mail is Current (Optional) - -If searching for recent emails, run sync-email workflow first: - -#+begin_src bash -mbsync -a && mu index -#+end_src - -Skip if Craig confirms mail is already synced. - -** Step 2: Construct Search Query - -mu supports powerful search syntax: - -#+begin_src bash -# By sender -mu find from:jdslabs.com - -# By subject -mu find subject:shipped - -# By date range -mu find date:2w..now # last 2 weeks -mu find date:2026-01-01.. # since Jan 1 - -# Combined queries -mu find from:fedex subject:tracking date:1w..now - -# In specific folder -mu find maildir:/gmail/INBOX from:amazon - -# Full text search -mu find "order confirmation" -#+end_src - -** Step 3: Run Search - -#+begin_src bash -mu find [query] -#+end_src - -Default output shows: date, from, subject, path - -For more detail: -#+begin_src bash -mu find --fields="d f s l" [query] # date, from, subject, path -mu find --sortfield=date --reverse [query] # newest first -#+end_src - -** Step 4: Report Results - -Report to Craig: -- Number of matches found -- Key details (date, from, subject) for relevant matches -- Message path if Craig needs to extract or read it - -If no matches: -- Confirm the search was correct -- Suggest alternative search terms -- Consider if mail needs syncing first - -* Search Query Reference - -| Field | Example | Notes | -|----------+------------------------------+--------------------------| -| from: | from:amazon.com | Sender address/domain | -| to: | to:c@cjennings.net | Recipient | -| subject: | subject:"order shipped" | Subject line | -| body: | body:tracking | Message body | -| date: | date:1w..now | Relative or absolute | -| flag: | flag:unread | unread, flagged, etc. | -| maildir: | maildir:/gmail/INBOX | Specific folder | -| mime: | mime:application/pdf | Has attachment type | - -Combine with AND (space), OR (or), NOT (not): -#+begin_src bash -mu find from:amazon subject:shipped not subject:delayed -#+end_src - -* Principles - -- **Sync first if needed** - Searching stale mail misses recent messages -- **Start broad, narrow down** - Better to find too many than miss the target -- **Use date ranges** - Dramatically speeds up searches for recent mail -- **Report paths** - Message paths enable extract-email workflow - -* Living Document - -Update this workflow as we discover useful search patterns. |
