wiki-fetch-mail

name	wiki-fetch-mail
description	Use when the user asks to fetch mail, sync email inbox, or process emails into the knowledge base.

Wiki — Mail Fetch

Fetch email files from the configured OneDrive inbox and copy them to raw/emails/ for ingestion.

Step 1: Read config

Read config/personal_info.md. Find the # Email section and parse the Markdown table:

Setting	Value
Inbox	/path/to/inbox

Extract the Inbox value. If the # Email section is missing or the Inbox row cannot be found, report:

"No email inbox configured. Add an # Email table with an Inbox row to config/personal_info.md."

Then stop.

Step 2: Verify inbox

Check that the inbox path exists and is accessible:

ls "<inbox_path>"

If the path does not exist or is inaccessible, report:

"Email inbox not found or not accessible: "

Then stop.

Step 3: Scan inbox

List all .html and .eml files in the inbox (flat directory, no recursion):

find "<inbox_path>" -maxdepth 1 \( -name "*.html" -o -name "*.eml" \) | sort

If no files are found, report:

"Nothing to fetch — inbox is empty."

Then stop.

Step 4: Copy and drain

For each file in the list:

1. If a file with the same name already exists in raw/emails/, skip the copy (count as skipped) but still delete the original from the inbox — it is already safe in raw/emails/.
2. Otherwise, copy the file to raw/emails/ first, then delete the original:

cp "<inbox_path>/<filename>" "raw/emails/<filename>" && rm "<inbox_path>/<filename>"

If the copy fails, warn ("Could not copy — skipping") and leave the original in the inbox. Do not delete a file whose copy failed.

In all cases where the file ends up in raw/emails/ (whether copied now or already present), delete it from the inbox.

Step 5: Log

Append one line to wiki/log.jsonl (replace N with actual counts and use local time):

{"date": "YYYY-MM-DD HH:mm:ss", "type": "email-fetch", "inbox": "<path>", "files_copied": N, "files_skipped": N}

Step 6: Report and hand off

Report a summary:

Mail fetch complete:
  N files copied to raw/emails/
  N files skipped (already present)

Then tell the user:

"Email files written to raw/emails/. Use the wiki-ingest skill (or say ingest new notes) to ingest them — or run scripts/wiki-ingest.sh for unattended bulk ingestion."