inbox-to-md 0.1.0

package/dist/mime.js

@@ -0,0 +1,105 @@
+// MIME body-structure helpers: pick which part of an email to download and
+// decode it. The sync engine fetches BODYSTRUCTURE first and then downloads
+// only the text part it needs, so attachment bytes (base64-encoded and often
+// megabytes) never cross the wire; attachments are described from the
+// structure metadata alone.
+function leafNodes(root) {
+    if (root.childNodes && root.childNodes.length > 0) {
+        return root.childNodes.flatMap((child) => leafNodes(child));
+    }
+    return [root];
+}
+// A non-multipart message has a single unnumbered node; IMAP addresses its
+// body as part "1".
+export function findTextPart(root) {
+    let plain = null;
+    let html = null;
+    for (const node of leafNodes(root)) {
+        const type = (node.type ?? '').toLowerCase();
+        if ((node.disposition ?? '').toLowerCase() === 'attachment')
+            continue;
+        const ref = {
+            part: node.part ?? '1',
+            encoding: (node.encoding ?? '').toLowerCase(),
+            charset: node.parameters?.charset ?? 'utf-8',
+            isHtml: type === 'text/html',
+        };
+        if (type === 'text/plain' && plain === null)
+            plain = ref;
+        else if (type === 'text/html' && html === null)
+            html = ref;
+    }
+    return plain ?? html;
+}
+// Attachments are described from structure metadata only — their bytes are
+// never downloaded. Anything explicitly marked as an attachment counts, as
+// does any named non-text part (inline images and the like).
+export function collectAttachments(root) {
+    const attachments = [];
+    for (const node of leafNodes(root)) {
+        const type = (node.type ?? '').toLowerCase();
+        const name = node.dispositionParameters?.filename ?? node.parameters?.name ?? null;
+        const isAttachment = (node.disposition ?? '').toLowerCase() === 'attachment' ||
+            (name !== null && !type.startsWith('text/'));
+        if (!isAttachment)
+            continue;
+        attachments.push({
+            name: name ?? '(unnamed)',
+            size: node.size ?? 0,
+            contentType: type || 'application/octet-stream',
+        });
+    }
+    return attachments;
+}
+// =XX hex escapes, soft line breaks (=\r\n or =\n) removed; a stray '=' that
+// fits neither form is kept literally, as decoders conventionally do.
+function decodeQuotedPrintable(raw) {
+    const s = raw.toString('latin1');
+    const out = [];
+    for (let i = 0; i < s.length; i++) {
+        if (s[i] !== '=') {
+            out.push(s.charCodeAt(i));
+            continue;
+        }
+        if (s[i + 1] === '\r' && s[i + 2] === '\n') {
+            i += 2;
+            continue;
+        }
+        if (s[i + 1] === '\n') {
+            i += 1;
+            continue;
+        }
+        const hex = s.slice(i + 1, i + 3);
+        if (/^[0-9A-Fa-f]{2}$/.test(hex)) {
+            out.push(parseInt(hex, 16));
+            i += 2;
+            continue;
+        }
+        out.push(0x3d); // '='
+    }
+    return Buffer.from(out);
+}
+// Decodes a raw body part (as stored on the server) to a string: undo the
+// content-transfer-encoding, then the charset. Unknown charsets fall back to
+// UTF-8 rather than failing the whole email — mojibake in one message is
+// recoverable, a sync error is noise on every run.
+export function decodeTextPart(raw, encoding, charset) {
+    let bytes;
+    switch (encoding) {
+        case 'base64':
+            bytes = Buffer.from(raw.toString('latin1'), 'base64'); // Buffer.from skips whitespace
+            break;
+        case 'quoted-printable':
+            bytes = decodeQuotedPrintable(raw);
+            break;
+        default: // 7bit / 8bit / binary
+            bytes = raw;
+    }
+    try {
+        return new TextDecoder(charset).decode(bytes);
+    }
+    catch {
+        return new TextDecoder('utf-8').decode(bytes);
+    }
+}
+//# sourceMappingURL=mime.js.map

package/dist/mime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.js","sourceRoot":"","sources":["../src/mime.ts"],"names":[],"mappings":"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"}

package/dist/prompts.d.ts

@@ -0,0 +1 @@
+export declare const COMPACT_SYSTEM_PROMPT: string;

package/dist/prompts.js

@@ -0,0 +1,11 @@
+// All model prompts, kept in one place so they can be reviewed and tuned
+// without digging through the call sites.
+// System prompt for `npm run compact` window compaction (compact.ts).
+export const COMPACT_SYSTEM_PROMPT = 'You compact email archives. Rewrite the given emails as a dense markdown digest: ' +
+    'keep every sender, date, decision, commitment, number, and open question; drop ' +
+    'signatures, quoted reply chains, and boilerplate. Each email is preceded by a ' +
+    '<!-- source: ... --> comment naming its source file; ALWAYS cite that source next ' +
+    'to every fact as [<source>], e.g. [2026-05-20-re]. When the input is already a ' +
+    'digest, preserve its existing [...] citations on every fact you keep. ' +
+    'Respond with the digest only.';
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,0CAA0C;AAE1C,sEAAsE;AACtE,MAAM,CAAC,MAAM,qBAAqB,GAChC,mFAAmF;IACnF,iFAAiF;IACjF,gFAAgF;IAChF,oFAAoF;IACpF,iFAAiF;IACjF,wEAAwE;IACxE,+BAA+B,CAAC"}

package/dist/ref-emails.d.ts

@@ -0,0 +1,6 @@
+export interface SyncedEmail {
+    path: string;
+    citationKey: string;
+}
+export declare function listSyncedEmails(syncPath: string): SyncedEmail[];
+export declare function readSyncedEmail(email: SyncedEmail): string;

package/dist/ref-emails.js

@@ -0,0 +1,16 @@
+// Read-only access to the synced email markdown files of one sync directory.
+// Filenames start with a YYYY-MM-DD stamp (see markdown.ts buildFilename), so
+// a lexicographic sort on the basename is chronological.
+import { readFileSync, readdirSync } from 'fs';
+import { basename, join } from 'path';
+// Emails in syncPath, oldest first.
+export function listSyncedEmails(syncPath) {
+    return readdirSync(syncPath)
+        .filter((name) => name.endsWith('.md'))
+        .sort((a, b) => a.localeCompare(b))
+        .map((name) => ({ path: join(syncPath, name), citationKey: basename(name, '.md') }));
+}
+export function readSyncedEmail(email) {
+    return readFileSync(email.path, 'utf8');
+}
+//# sourceMappingURL=ref-emails.js.map

package/dist/ref-emails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-emails.js","sourceRoot":"","sources":["../src/ref-emails.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8EAA8E;AAC9E,yDAAyD;AAEzD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAStC,oCAAoC;AACpC,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,WAAW,CAAC,QAAQ,CAAC;SACzB,MAAM,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SAC9C,IAAI,CAAC,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SAClD,GAAG,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAkB;IAChD,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/dist/sync.d.ts

@@ -0,0 +1,10 @@
+import type { Config } from './config.js';
+interface ExistingFile {
+    name: string;
+    date: Date | null;
+    mailbox: string | null;
+}
+export declare function computeSinceDate(now?: Date): Date;
+export declare function collectExistingFiles(dir: string): Map<string, ExistingFile>;
+export declare function runSync(config: Config, since?: Date, forceRewrite?: boolean): Promise<boolean>;
+export {};

package/dist/sync.js

@@ -0,0 +1,296 @@
+// `npm start` — sync engine. For each configured account, fetches mail from
+// INBOX and the Sent mailbox (received this month or last month by default)
+// and writes one markdown file per email into the account's sync path.
+// Idempotent: emails already on disk (matched by message-id in the files'
+// frontmatter) are skipped without re-downloading their bodies — unless
+// --force-rewrite, which re-downloads them and overwrites the files in place
+// (e.g. to pick up frontmatter added by a newer version of renderEmail). Mirrors
+// deletions too: a file whose email has vanished from the server (and whose
+// date is safely inside the sync window) is deleted after a clean sync.
+import { existsSync, mkdirSync, readdirSync, renameSync, rmSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { bold, dim, green, red } from './ansi.js';
+import { closeImapClient, createImapClient, describeImapError } from './imap.js';
+import { buildFilename, extractFrontmatterValue, extractMessageId, fallbackHash, readFrontmatterHead, renderEmail } from './markdown.js';
+import { collectAttachments, decodeTextPart, findTextPart } from './mime.js';
+// SEARCH SINCE works on the server's internal date at day granularity in the
+// server's timezone, while our frontmatter stores the email's header date —
+// the two can disagree around the boundary. Only prune files comfortably
+// inside the window so a boundary mismatch can't delete a still-live email.
+const PRUNE_BOUNDARY_MARGIN_MS = 24 * 60 * 60 * 1000;
+// In-place progress line, TTY only: piped output stays clean (matching the
+// ansi.ts helpers, which also degrade to plain text off-TTY). Overwrites
+// itself with \r and is cleared before any real line is printed.
+class ProgressLine {
+    active = false;
+    update(text) {
+        if (!process.stdout.isTTY)
+            return;
+        process.stdout.write(`\r\x1b[2K  ${dim(text)}`);
+        this.active = true;
+    }
+    clear() {
+        if (!this.active)
+            return;
+        process.stdout.write('\r\x1b[2K');
+        this.active = false;
+    }
+}
+export function computeSinceDate(now = new Date()) {
+    // Month -1 in January normalizes to December of the prior year.
+    return new Date(now.getFullYear(), now.getMonth() - 1, 1);
+}
+// The files on disk are the only dedupe state — no sidecar index, which would
+// drift the moment the user deletes or moves a file and then silently skip
+// re-syncing it.
+export function collectExistingFiles(dir) {
+    const existing = new Map();
+    for (const name of readdirSync(dir)) {
+        if (!name.endsWith('.md'))
+            continue;
+        const head = readFrontmatterHead(join(dir, name));
+        if (head === null)
+            continue; // vanished between readdir and open; nothing to dedupe against
+        const id = extractMessageId(head);
+        if (!id)
+            continue;
+        const dateRaw = extractFrontmatterValue(head, 'date');
+        const date = dateRaw === null ? null : new Date(dateRaw);
+        existing.set(id, {
+            name,
+            date: date !== null && !Number.isNaN(date.getTime()) ? date : null,
+            mailbox: extractFrontmatterValue(head, 'mailbox'),
+        });
+    }
+    return existing;
+}
+// Deletes files whose email is no longer on the server. Only files we can
+// positively rule dead are removed: the email's date must sit safely inside
+// the sync window (older mail was never searched, so its absence from
+// serverIds means nothing) and its mailbox must be one we actually synced
+// this run. Everything else — including files with unparseable frontmatter —
+// is left alone.
+function pruneDeletedEmails(dir, existing, serverIds, syncedMailboxes, since) {
+    const cutoff = since.getTime() + PRUNE_BOUNDARY_MARGIN_MS;
+    let deleted = 0;
+    for (const [id, file] of existing) {
+        if (serverIds.has(id))
+            continue;
+        if (!file.date || file.date.getTime() < cutoff)
+            continue;
+        if (!file.mailbox || !syncedMailboxes.includes(file.mailbox))
+            continue;
+        rmSync(join(dir, file.name), { force: true });
+        deleted++;
+    }
+    return deleted;
+}
+// A truncated file whose frontmatter already contains the message-id would
+// make every future run skip a half-written email — so write to a tmp name
+// (not *.md, invisible to the scanner) and rename into place.
+function writeFileAtomic(path, content) {
+    const tmp = path + '.tmp';
+    rmSync(tmp, { force: true });
+    writeFileSync(tmp, content);
+    renameSync(tmp, path);
+}
+function chooseTargetPath(dir, email, fetchDate, existing, forceRewrite) {
+    const date = email.date ?? fetchDate;
+    const subject = email.subject;
+    const messageId = email.messageId;
+    if (messageId === '') {
+        // No message-id to dedupe on, so the filename itself is the identity:
+        // deterministic hash of from/date/subject means existsSync === synced.
+        const name = buildFilename(date, subject, fallbackHash(email.from, date.toISOString(), subject));
+        const path = join(dir, name);
+        return { path, alreadySynced: !forceRewrite && existsSync(path) };
+    }
+    // Force-rewrite overwrites the file this email already lives in, keeping
+    // its name stable rather than minting a duplicate under a fresh suffix.
+    if (forceRewrite) {
+        const prior = existing.get(messageId);
+        if (prior)
+            return { path: join(dir, prior.name), alreadySynced: false };
+    }
+    // Message-id dedupe already ran (phase A), so an existing file here is a
+    // different email that happens to share date + subject — pick a free name.
+    // The counter goes in the suffix slot, after the slug: appending it to the
+    // subject doesn't work because slugify truncates long subjects to 80 chars,
+    // slicing the counter off and looping forever on the same name.
+    let path = join(dir, buildFilename(date, subject));
+    for (let n = 2; existsSync(path); n++) {
+        path = join(dir, buildFilename(date, subject, String(n)));
+    }
+    return { path, alreadySynced: false };
+}
+function formatAddressList(list) {
+    return (list ?? [])
+        .map((a) => (a.name ? `${a.name} <${a.address ?? ''}>` : (a.address ?? '')))
+        .join(', ');
+}
+// Downloads and assembles one email using body structure instead of full
+// source: the envelope covers the headers, the structure describes the
+// attachments, and only the single text part is actually fetched — so
+// attachment bytes never leave the server.
+async function downloadEmail(client, uid) {
+    const msg = await client.fetchOne(uid, { envelope: true, bodyStructure: true }, { uid: true });
+    if (!msg || !msg.envelope || !msg.bodyStructure)
+        throw new Error('server returned no envelope/body structure');
+    let text = '';
+    let html = '';
+    const textRef = findTextPart(msg.bodyStructure);
+    if (textRef) {
+        const partMsg = await client.fetchOne(uid, { bodyParts: [textRef.part] }, { uid: true });
+        const raw = partMsg ? partMsg.bodyParts?.get(textRef.part) : undefined;
+        if (!raw)
+            throw new Error(`server returned no body part ${textRef.part}`);
+        const decoded = decodeTextPart(raw, textRef.encoding, textRef.charset);
+        if (textRef.isHtml)
+            html = decoded;
+        else
+            text = decoded;
+    }
+    return {
+        from: formatAddressList(msg.envelope.from),
+        to: formatAddressList(msg.envelope.to),
+        subject: msg.envelope.subject ?? '',
+        date: msg.envelope.date ?? null,
+        messageId: (msg.envelope.messageId ?? '').trim(),
+        text,
+        html,
+        attachments: collectAttachments(msg.bodyStructure),
+    };
+}
+// Locates the account's Sent mailbox: the RFC 6154 special-use flag when the
+// server provides it, else the usual names (Sent, Sent Mail, Sent Items, …).
+// Returns null when nothing matches — some servers simply have no Sent box.
+async function findSentMailbox(client) {
+    const boxes = await client.list();
+    const bySpecialUse = boxes.find((b) => b.specialUse === '\\Sent');
+    if (bySpecialUse)
+        return bySpecialUse.path;
+    const byName = boxes.find((b) => /^sent( messages| items| mail)?$/i.test(b.name));
+    return byName ? byName.path : null;
+}
+async function syncMailbox(client, mailbox, since, dir, seen, serverIds, existing, forceRewrite, counts) {
+    const lock = await client.getMailboxLock(mailbox);
+    const progress = new ProgressLine();
+    try {
+        const uids = await client.search({ since }, { uid: true });
+        if (!uids || uids.length === 0)
+            return;
+        // Phase A: envelopes only. Filter out already-synced message-ids before
+        // downloading anything heavy — on re-runs (the common case) this means
+        // an unchanged mailbox costs envelopes, never full bodies.
+        const newUids = [];
+        let checked = 0;
+        for await (const msg of client.fetch(uids, { envelope: true }, { uid: true })) {
+            progress.update(`${mailbox}: checking ${++checked}/${uids.length}`);
+            const messageId = (msg.envelope?.messageId ?? '').trim();
+            if (messageId !== '')
+                serverIds.add(messageId); // still alive on the server — protect from pruning
+            if (messageId !== '' && seen.has(messageId)) {
+                counts.skipped++;
+                continue;
+            }
+            if (messageId !== '')
+                seen.add(messageId); // dedupes duplicates within this run too
+            newUids.push(msg.uid);
+        }
+        if (newUids.length === 0)
+            return; // imapflow rejects an empty fetch range
+        // Phase B: body text for new mail only (attachments stay on the server —
+        // see downloadEmail). One message at a time rather than a single bulk
+        // FETCH: the progress line can update before each download, and one bad
+        // message can't stall the entire pipeline.
+        for (const [i, uid] of newUids.entries()) {
+            progress.update(`${mailbox}: downloading ${i + 1}/${newUids.length}`);
+            try {
+                const email = await downloadEmail(client, uid);
+                const { path, alreadySynced } = chooseTargetPath(dir, email, new Date(), existing, forceRewrite);
+                if (alreadySynced) {
+                    counts.skipped++;
+                    continue;
+                }
+                writeFileAtomic(path, renderEmail(email, new Date(), mailbox));
+                counts.written++;
+            }
+            catch (err) {
+                counts.errors++;
+                const detail = err instanceof Error ? err.message : String(err);
+                progress.clear(); // don't let the error line splice into the progress line
+                console.error(red(`  error on ${mailbox} uid ${uid}: ${detail}`));
+            }
+        }
+    }
+    finally {
+        progress.clear();
+        lock.release();
+    }
+}
+async function syncAccount(account, since, forceRewrite) {
+    const counts = { written: 0, skipped: 0, deleted: 0, errors: 0 };
+    const dir = account.syncPath;
+    mkdirSync(dir, { recursive: true });
+    const existing = collectExistingFiles(dir);
+    // Shared across mailboxes, so a message that lives in both INBOX and Sent
+    // (e.g. mail to yourself) is written once. INBOX is synced first, so the
+    // received copy wins. Force-rewrite starts empty so files on disk don't
+    // suppress re-downloading, but still dedupes across mailboxes within the run.
+    const seen = forceRewrite ? new Set() : new Set(existing.keys());
+    // Every message-id observed on the server this run, whether or not it was
+    // already synced — the ground truth pruning compares against.
+    const serverIds = new Set();
+    const client = createImapClient(account);
+    await client.connect();
+    try {
+        const mailboxes = ['INBOX'];
+        const sent = await findSentMailbox(client);
+        if (sent)
+            mailboxes.push(sent);
+        else
+            console.error(`${account.label}: no Sent mailbox found — syncing INBOX only`);
+        for (const mailbox of mailboxes) {
+            await syncMailbox(client, mailbox, since, dir, seen, serverIds, existing, forceRewrite, counts);
+        }
+        // Runs only after every mailbox listed its messages without throwing —
+        // an aborted sync leaves serverIds incomplete and must not delete anything
+        // (a mid-run failure propagates out of the loop above and skips this).
+        counts.deleted = pruneDeletedEmails(dir, existing, serverIds, mailboxes, since);
+        return counts;
+    }
+    finally {
+        await closeImapClient(client);
+    }
+}
+// Syncs every account, isolating failures: one broken account logs loudly and
+// the rest still run. Returns true only when everything was fully clean.
+export async function runSync(config, since = computeSinceDate(), forceRewrite = false) {
+    if (config.accounts.length === 0) {
+        console.error('No accounts configured. Run `npm run auth` to add one.');
+        return false;
+    }
+    console.log(dim(`Syncing INBOX + Sent mail since ${since.toDateString()}${forceRewrite ? ' (force-rewrite: overwriting already-synced files)' : ''}`));
+    let allOk = true;
+    const totals = { written: 0, skipped: 0, deleted: 0, errors: 0 };
+    for (const account of config.accounts) {
+        try {
+            const counts = await syncAccount(account, since, forceRewrite);
+            totals.written += counts.written;
+            totals.skipped += counts.skipped;
+            totals.deleted += counts.deleted;
+            totals.errors += counts.errors;
+            const errorPart = counts.errors > 0 ? red(`${counts.errors} errors`) : green('0 errors');
+            console.log(`${bold(account.label)}: ${counts.written} new · ${counts.skipped} skipped · ${counts.deleted} deleted · ${errorPart} → ${account.syncPath}`);
+            if (counts.errors > 0)
+                allOk = false;
+        }
+        catch (err) {
+            allOk = false;
+            console.error(`${bold(account.label)}: ${red(`FAILED — ${describeImapError(err, account.host, account.port)}`)}`);
+        }
+    }
+    console.log(dim(`Total: ${totals.written} new · ${totals.skipped} skipped · ${totals.deleted} deleted · ${totals.errors} errors`));
+    return allOk;
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"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"}

package/dist/tui.d.ts

@@ -0,0 +1,42 @@
+export type Key = {
+    name: 'up' | 'down' | 'left' | 'right' | 'enter' | 'backspace' | 'ctrl-c' | 'ctrl-x' | 'escape';
+} | {
+    name: 'char';
+    ch: string;
+};
+export declare function readKey(): Promise<Key>;
+export declare function enterTui(): void;
+export declare function exitTui(): void;
+export interface MenuOption<V extends string = string> {
+    label: string;
+    value: V;
+}
+export type MenuResult<V extends string> = {
+    kind: 'pick';
+    value: V;
+} | {
+    kind: 'ctrl-x';
+    value: V;
+} | {
+    kind: 'escape';
+};
+export declare function pickFromMenu<V extends string>(title: string, options: MenuOption<V>[], footer?: string | null, opts?: {
+    enableCtrlX?: boolean;
+}): Promise<MenuResult<V>>;
+export type FieldKind = 'text' | 'secret' | 'number' | 'select';
+export interface FormField {
+    key: string;
+    label: string;
+    kind: FieldKind;
+    value: string;
+    options?: string[];
+    hint?: string;
+}
+export interface FormSpec {
+    title: string;
+    hint?: string;
+    fields: FormField[];
+    submitLabel?: string;
+    verify?: (values: Record<string, string>) => Promise<string | null>;
+}
+export declare function runForm(spec: FormSpec): Promise<Record<string, string> | 'back'>;