@leemour/cli-memo 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Viacheslav Ptsarev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,122 @@
-# Temporary Holding Version
+# cli-memo
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`memo` answers "what do I need to know about this person": who they are in each messenger, the
+newest messages each way, the notes about them, and the newest mail threads — each item with a link
+to its source.
+
+It reads the local message store that [tg-cli](https://github.com/leemour/tg-cli) and
+[max-cli](https://github.com/leemour/max-cli) share, Markdown notes such as an Obsidian vault, and mail
+through [Himalaya](https://github.com/pimalaya/himalaya). Everything stays on your machine; nothing is
+sent or changed at the source.
+
+**Status:** early. Person context, notes search, Gmail import and timed incremental import work.
+
+## Context about a person
+
+```sh
+memo context telegram:"Rin Example"     # or max:<name or id>, email:<address>
+```
+
+One answer from the shared store: every identity linked to the person (`tg|max contacts link`), the
+last message each way, recent messages in direct chats and groups, chats in common — mail included once
+an address is linked — then the note about them (`memo note`) and the stored notes naming them in full,
+each with its locator. What gave nothing is listed with the reason. `--json` for agents, `--limit` for more.
+
+## Notes
+
+```sh
+memo notes import                          # load the notes into the shared store; run again after edits
+memo notes search "lighthouse budget"      # notes by their words, and the people they name
+memo notes about "Rin Example"             # notes about a person, read straight from the folders
+```
+
+`import` stores each Markdown or text note as one entry of provider `notes` in the shared store (the
+folder is the account, each subfolder a chat), so `memo notes search`, `tg messages search "in:notes …"`
+and agents find notes beside messages and mail. An edited note keeps its old text as a revision; a note
+deleted from the folder loses its text on the next import.
+
+`import` also builds each folder's notes for search and embeds them for search by meaning with the local
+e5-small model (shared with tg and max: `tg models text download e5-small`), only what changed, at most
+600 chunks a run — the next run continues. `--no-embed`, or `notes.embed: false` in the config, skips the
+embedding. `search` ranks notes by meaning and by words together and says which found each; without the
+model it searches words alone and says so. It then lists who they name: `[[Name]]` links, and people the
+store knows from tg, MAX or mail whose full name appears in the text — by name only, so a guess.
+
+`about` lists the notes *about* the person (file name or `aliases` in the front matter), the notes that
+*link* them, and lines that only say the name (weak). Hidden folders such as `.obsidian` are skipped,
+and nothing is ever written to a notes folder.
+
+Folders and what to skip go in `~/.config/cli-memo/config.json`; `--folder` and `--ignore` add to them
+for one run. An ignore rule is a path inside the folder — a file, or a folder and everything under it —
+or a glob (`**/Private*`, `*.txt`):
+
+```json
+{ "notes": { "folders": ["/path/to/vault"], "ignore": ["Journal/Private.md", "Archive"] } }
+```
+
+## Keeping it current
+
+```sh
+memo import                  # notes and mail, only what changed since the last run
+memo auto on --every 5m      # run memo import on a systemd user timer (default 5m, a minute or more)
+memo auto status             # on/off, interval, next and last run
+memo auto off                # stop and remove the timer
+```
+
+The config is the one source: `memo auto on/off` write `auto: { enabled, every }` to
+`~/.config/cli-memo/config.json`, and a hand edit there takes effect at the next timer run, which
+rewrites or removes its own timer to match. The timer runs `memo import` from the place it was set up
+from, with the `PATH` of that shell, so Himalaya and the keyring helper are found.
+
+`memo import` is incremental. A note whose size and change time are as last stored is not read; one
+whose content hash is the same is not saved. Mail reads bodies only of messages not stored yet. A lock
+keeps two imports from running at once, and one failing source does not stop the others.
+
+## Mail
+
+```sh
+memo mail import --since 2026-09-01
+```
+
+Reads a Gmail account's All Mail through [Himalaya](https://github.com/pimalaya/himalaya) into the
+shared message store as provider `email`: one chat per Gmail thread, the mailbox address as the
+account, senders and recipients as people. Messenger search and person context then see mail too.
+
+- Read only: the mailbox is opened read-only, nothing is sent, and no mail is marked read.
+- Run it again any time: what is stored is skipped; `--max` (default 200) bounds the new mails read
+  per run, and the next run continues.
+- A mail deleted at the source loses its text in the store. The first two days of the window are left
+  alone, and a run that finds an unusually large share missing deletes nothing and says so. Mail moved
+  to Spam leaves All Mail and counts as deleted.
+
+Set the account up in Himalaya first (an IMAP account with a Gmail
+[app password](https://myaccount.google.com/apppasswords); `bin/mail-password <name>` stores it in the
+keyring), then name it in `~/.config/cli-memo/config.json`:
+
+```json
+{ "mail": { "accounts": [{ "name": "gmail", "address": "you@example.com" }] } }
+```
+
+## People
+
+Who is who is decided in messaging: `tg contacts link <person> email:<address>` (or `max contacts link`)
+records that a messenger identity and a mail address are one person, in the shared store. A same name
+is never enough. `memo` only adds the note that is about the person:
+
+```sh
+memo note telegram:"Rin Example" ~/Notes/people/Rin.md
+```
+
+An identity is `<messenger>:<name or id>`; a name two people share is refused, with their ids to
+choose from. The note path lives in `~/.config/cli-memo/people-notes.json`.
+
+## Development
+
+```sh
+pnpm install
+pnpm lint && pnpm typecheck && pnpm test
+```
+
+## License
+
+MIT

package/dist/app.d.ts

@@ -0,0 +1,9 @@
+/** How memo names itself to the shared services: in their hints and their files. */
+export declare const APP: {
+    command: string;
+    appName: string;
+    envPrefix: string;
+    description: string;
+    version: string;
+};
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAEA,oFAAoF;AACpF,eAAO,MAAM,GAAG;;;;;;CAMf,CAAA"}

package/dist/app.js

@@ -0,0 +1,10 @@
+import { VERSION } from "./version.js";
+/** How memo names itself to the shared services: in their hints and their files. */
+export const APP = {
+    command: "memo",
+    appName: "cli-memo",
+    envPrefix: "MEMO",
+    description: "Context about people across messengers, notes and mail",
+    version: VERSION,
+};
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,oFAAoF;AACpF,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,wDAAwD;IACrE,OAAO,EAAE,OAAO;CACjB,CAAA"}

package/dist/bin/memo.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=memo.d.ts.map

package/dist/bin/memo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo.d.ts","sourceRoot":"","sources":["../../src/bin/memo.ts"],"names":[],"mappings":""}

package/dist/bin/memo.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { exitCodeFor, GENERIC_FAILURE, isCliError } from "@leemour/cli-core";
+import { ensureSqlite } from "@leemour/cli-messaging/sqlite-runtime";
+await ensureSqlite();
+// A static import would load the store's SQLite before ensureSqlite could swap it.
+const { createProgram } = await import("../program.js");
+try {
+    await createProgram().parseAsync(process.argv);
+}
+catch (error) {
+    process.stderr.write(`memo: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = isCliError(error) ? exitCodeFor(error.code) : GENERIC_FAILURE;
+}
+//# sourceMappingURL=memo.js.map

package/dist/bin/memo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo.js","sourceRoot":"","sources":["../../src/bin/memo.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAA;AAEpE,MAAM,YAAY,EAAE,CAAA;AACpB,mFAAmF;AACnF,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAA;AACvD,IAAI,CAAC;IACH,MAAM,aAAa,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AAChD,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACzF,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,CAAA;AAClF,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,25 @@
+import * as v from "valibot";
+declare const ConfigSchema: v.ObjectSchema<{
+    readonly notes: v.OptionalSchema<v.ObjectSchema<{
+        readonly folders: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        readonly ignore: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly embed: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly auto: v.OptionalSchema<v.ObjectSchema<{
+        readonly enabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly every: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly mail: v.OptionalSchema<v.ObjectSchema<{
+        readonly accounts: v.ArraySchema<v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly address: v.StringSchema<undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type Config = v.InferOutput<typeof ConfigSchema>;
+export declare const configPath: (env?: NodeJS.ProcessEnv) => string;
+export declare const loadConfig: (env?: NodeJS.ProcessEnv) => Config;
+/** Changes one part of the config and keeps the rest as written. */
+export declare const updateConfig: (change: (config: Config) => Config, env?: NodeJS.ProcessEnv) => Config;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;aAUhB,CAAA;AAEF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,YAAY,CAAC,CAAA;AAEvD,eAAO,MAAM,UAAU,SAAS,MAAM,CAAC,UAAU,KAAiB,MACiB,CAAA;AAEnF,eAAO,MAAM,UAAU,SAAS,MAAM,CAAC,UAAU,KAAiB,MACP,CAAA;AAE3D,oEAAoE;AACpE,eAAO,MAAM,YAAY,WAAY,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,QAAO,MAAM,CAAC,UAAU,KAAiB,MAIvG,CAAA"}

package/dist/config.js

@@ -0,0 +1,20 @@
+import { configFilePath, loadConfigFile, resolvePaths, saveConfigFile } from "@leemour/cli-core";
+import * as v from "valibot";
+const ConfigSchema = v.object({
+    notes: v.optional(v.object({
+        folders: v.array(v.string()),
+        ignore: v.optional(v.array(v.string())),
+        embed: v.optional(v.boolean()),
+    })),
+    auto: v.optional(v.object({ enabled: v.optional(v.boolean()), every: v.optional(v.string()) })),
+    mail: v.optional(v.object({ accounts: v.array(v.object({ name: v.string(), address: v.string() })) })),
+});
+export const configPath = (env = process.env) => configFilePath(resolvePaths({ appName: "cli-memo", prefix: "MEMO", env }).config);
+export const loadConfig = (env = process.env) => loadConfigFile(configPath(env), ConfigSchema, () => ({}));
+/** Changes one part of the config and keeps the rest as written. */
+export const updateConfig = (change, env = process.env) => {
+    const next = change(loadConfig(env));
+    saveConfigFile(configPath(env), next);
+    return next;
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAChG,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,QAAQ,CACf,CAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACvC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;KAC/B,CAAC,CACH;IACD,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/F,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;CACvG,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG,EAAU,EAAE,CACzE,cAAc,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG,EAAU,EAAE,CACzE,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAE3D,oEAAoE;AACpE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAkC,EAAE,GAAG,GAAsB,OAAO,CAAC,GAAG,EAAU,EAAE;IAC/G,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;IACpC,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAA;IACrC,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}

package/dist/context/command.d.ts

@@ -0,0 +1,6 @@
+import { type Streams } from "@leemour/cli-core";
+import type { Command } from "commander";
+import { type MemoContext } from "./context.js";
+export declare const contextText: ({ messages, notes, notRead }: MemoContext) => string;
+export declare const contextCommand: (program: Command, streams: Streams, env: NodeJS.ProcessEnv) => void;
+//# sourceMappingURL=command.d.ts.map

package/dist/context/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/context/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAGhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,cAAc,CAAA;AAU5D,eAAO,MAAM,WAAW,iCAAkC,WAAW,KAAG,MAuBvE,CAAA;AAED,eAAO,MAAM,cAAc,YAAa,OAAO,WAAW,OAAO,OAAO,MAAM,CAAC,UAAU,KAAG,IAiB3F,CAAA"}

package/dist/context/command.js

@@ -0,0 +1,56 @@
+import { createRenderer } from "@leemour/cli-core";
+import { openStore } from "@leemour/cli-messaging/store";
+import { positive } from "../options.js";
+import { loadNotesMap } from "../people/notes-map.js";
+import { memoContext } from "./context.js";
+const MAX_TEXT = 160;
+const one = (message) => message === null
+    ? "—"
+    : `${message.timestamp.slice(0, 16).replace("T", " ")}  ${message.provider}  ${message.chatTitle ?? message.chatId}: ` +
+        message.text.replace(/\s+/g, " ").slice(0, MAX_TEXT);
+export const contextText = ({ messages, notes, notRead }) => {
+    const { person, last, recent, shared } = messages;
+    return [
+        `${person.name ?? person.uid}`,
+        ...person.identities.map(({ provider, id, name }) => `  ${provider}:${id}  ${name ?? ""}`),
+        "",
+        `Last from them   ${one(last.fromThemAnywhere ?? last.fromThem)}`,
+        `Last from me     ${one(last.fromMe)}`,
+        `In common        ${shared.length} chats`,
+        ...(recent.direct.length === 0 ? [] : ["", "Recent, direct", ...recent.direct.map((m) => `  ${one(m)}`)]),
+        ...(recent.groups.length === 0 ? [] : ["", "Recent, in groups", ...recent.groups.map((m) => `  ${one(m)}`)]),
+        "",
+        `Note about them  ${notes.about ?? "none — memo note <identity> <path>"}`,
+        ...(notes.mentions.length === 0
+            ? []
+            : [
+                "Notes naming them (by name — may be someone else)",
+                ...notes.mentions.map(({ path, line }) => `  ${path}  ${line}`),
+                ...(notes.hasMore ? ["  more — raise --limit"] : []),
+            ]),
+        ...(messages.complete ? [] : ["", `Not read in full: ${messages.notRead.length} chats — store fetch <chat>`]),
+        ...notRead.map(({ source, reason }) => `Not read: ${source} — ${reason}`),
+    ].join("\n");
+};
+export const contextCommand = (program, streams, env) => {
+    program
+        .command("context")
+        .description("What the store holds about a person — messages, mail and notes — with a link to each source")
+        .argument("<person>", "<messenger>:<name or id>, e.g. telegram:Ana or email:ana@example.com")
+        .option("--limit <n>", "most messages and notes of each kind", positive, 20)
+        .option("--json", "print JSON")
+        .action(async (person, options) => {
+        const store = await openStore({ env });
+        try {
+            const answer = await memoContext(store, person, { limit: options.limit, notesMap: loadNotesMap(env) });
+            if (options.json)
+                createRenderer({ format: "json", color: false, streams }).result(answer);
+            else
+                streams.data(`${contextText(answer)}\n`);
+        }
+        finally {
+            await store.close();
+        }
+    });
+};
+//# sourceMappingURL=command.js.map

package/dist/context/command.js.map

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

package/dist/context/context.d.ts

@@ -0,0 +1,34 @@
+import { type PersonContext } from "@leemour/cli-messaging/services";
+import type { MessageStore } from "@leemour/cli-messaging/store";
+import type { NotesMap } from "../people/notes-map.js";
+export interface NoteMention {
+    locator: string;
+    path: string;
+    /** The first line naming them. */
+    line: string;
+}
+export interface MemoContext {
+    /** Messages and mail, from the store: every identity linked to the person, by id. */
+    messages: PersonContext;
+    notes: {
+        /** The note about them, as `memo note` named it. */
+        about: string | null;
+        /** Stored notes naming them in full — by name, so possibly someone else. */
+        mentions: NoteMention[];
+        hasMore: boolean;
+    };
+    /** Sources that gave nothing, and why. */
+    notRead: {
+        source: string;
+        reason: string;
+    }[];
+}
+/**
+ * One answer about a person: what the store holds of them across messengers and mail (cli-messaging's
+ * person context), the note about them, and the notes that name them.
+ */
+export declare const memoContext: (store: MessageStore, reference: string, { limit, notesMap }?: {
+    limit?: number;
+    notesMap?: NotesMap;
+}) => Promise<MemoContext>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,iCAAiC,CAAA;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEtD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,qFAAqF;IACrF,QAAQ,EAAE,aAAa,CAAA;IACvB,KAAK,EAAE;QACL,oDAAoD;QACpD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,4EAA4E;QAC5E,QAAQ,EAAE,WAAW,EAAE,CAAA;QACvB,OAAO,EAAE,OAAO,CAAA;KACjB,CAAA;IACD,0CAA0C;IAC1C,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC9C;AAQD;;;GAGG;AACH,eAAO,MAAM,WAAW,UACf,YAAY,aACR,MAAM,wBACc;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,KACrE,OAAO,CAAC,WAAW,CAyCrB,CAAA"}

package/dist/context/context.js

@@ -0,0 +1,50 @@
+import { CliError } from "@leemour/cli-core";
+import { personContext } from "@leemour/cli-messaging/services";
+const MAX_LINE = 200;
+/** Shorter names, or a single word, match too much ordinary text to mean anyone. */
+const MIN_NAME = 5;
+const literal = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/**
+ * One answer about a person: what the store holds of them across messengers and mail (cli-messaging's
+ * person context), the note about them, and the notes that name them.
+ */
+export const memoContext = async (store, reference, { limit = 20, notesMap = {} } = {}) => {
+    const [, provider, who] = /^([a-z][a-z0-9-]*):(.+)$/.exec(reference.trim()) ?? [];
+    if (provider === undefined || who === undefined)
+        throw new CliError("validation_error", `"${reference}" names no messenger — write it as <messenger>:<name or id>`);
+    const accounts = await store.accounts();
+    const asked = accounts.find((account) => account.provider === provider);
+    if (asked === undefined)
+        throw new CliError("not_found", `the store holds no ${provider} account`);
+    const messages = await personContext(store, asked, who, { messages: limit });
+    const about = notesMap[messages.person.uid] ?? null;
+    const names = [
+        ...new Set([messages.person.name, ...messages.person.identities.map(({ name }) => name)].map((name) => name?.trim())),
+    ].filter((name) => !!name && name.length >= MIN_NAME && /\s/.test(name));
+    const notRead = [];
+    let mentions = [];
+    let hasMore = false;
+    if (!accounts.some((account) => account.provider === "notes")) {
+        notRead.push({ source: "notes", reason: "no notes imported — memo notes import" });
+    }
+    else if (names.length > 0) {
+        const pattern = new RegExp(`(?<![\\p{L}\\p{N}])(${names.map(literal).join("|")})(?![\\p{L}\\p{N}])`, "iu");
+        const found = await store.find({ provider: "notes", pattern, limit: limit + 1 });
+        hasMore = found.items.length > limit || found.hasMore;
+        mentions = found.items
+            .slice(0, limit)
+            .filter(({ id }) => about === null || !about.endsWith(`/${id}`))
+            .map((hit) => ({
+            locator: hit.locator,
+            path: hit.id,
+            line: (hit.text.split("\n").find((line) => pattern.test(line)) ?? "").trim().slice(0, MAX_LINE),
+        }));
+    }
+    if (!messages.person.identities.some((identity) => identity.provider === "email"))
+        notRead.push({
+            source: "mail",
+            reason: "no mail address linked to them — tg contacts link <person> email:<address>",
+        });
+    return { messages, notes: { about, mentions, hasMore }, notRead };
+};
+//# sourceMappingURL=context.js.map

package/dist/context/context.js.map

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

package/dist/mail/command.d.ts

@@ -0,0 +1,4 @@
+import { type Streams } from "@leemour/cli-core";
+import { type Command } from "commander";
+export declare const mailCommand: (program: Command, streams: Streams, env: NodeJS.ProcessEnv) => void;
+//# sourceMappingURL=command.d.ts.map

package/dist/mail/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/mail/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAE1E,OAAO,EAAE,KAAK,OAAO,EAAwB,MAAM,WAAW,CAAA;AAuB9D,eAAO,MAAM,WAAW,YAAa,OAAO,WAAW,OAAO,OAAO,MAAM,CAAC,UAAU,KAAG,IAoCxF,CAAA"}

package/dist/mail/command.js

@@ -0,0 +1,56 @@
+import { CliError, createRenderer } from "@leemour/cli-core";
+import { openStore } from "@leemour/cli-messaging/store";
+import { InvalidArgumentError } from "commander";
+import { loadConfig } from "../config.js";
+import { positive } from "../options.js";
+import { himalaya } from "./himalaya.js";
+import { importMail } from "./import.js";
+const DAY = 86_400_000;
+const day = (value) => {
+    const date = new Date(`${value}T00:00:00Z`);
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value) || Number.isNaN(date.getTime()))
+        throw new InvalidArgumentError("a date as YYYY-MM-DD");
+    return date;
+};
+const text = (result) => [
+    `${result.account}: ${result.listed} in All Mail since ${result.since.slice(0, 10)}, ` +
+        `${result.saved} saved, ${result.alreadyStored} already stored, ${result.deleted} marked deleted.`,
+    ...(result.complete ? [] : ["Not every new message was read — run it again to continue."]),
+    ...(result.deletionsSkipped === undefined ? [] : [`Deletions skipped: ${result.deletionsSkipped}`]),
+].join("\n");
+export const mailCommand = (program, streams, env) => {
+    const mail = program.command("mail").description("Mail, read through Himalaya into the shared message store");
+    mail
+        .command("import")
+        .description("Read a Gmail account's All Mail into the store, and drop the text of mail deleted at the source")
+        .option("--account <name>", "the account's name in Himalaya's config (default: the first in mail.accounts)")
+        .option("--since <date>", "first day to read, YYYY-MM-DD (default: 30 days ago)", day)
+        .option("--max <n>", "most new messages to read in this run", positive, 200)
+        .option("--json", "print JSON")
+        .action(async (options) => {
+        const accounts = loadConfig(env).mail?.accounts ?? [];
+        const account = options.account === undefined ? accounts[0] : accounts.find(({ name }) => name === options.account);
+        if (account === undefined)
+            throw new CliError("configuration_error", options.account === undefined
+                ? "no mail account: add mail.accounts [{ name, address }] to the config"
+                : `no mail account "${options.account}" in mail.accounts of the config`);
+        const store = await openStore({ env });
+        try {
+            const result = await importMail({
+                store,
+                run: himalaya(env),
+                account,
+                since: options.since ?? new Date(Date.now() - 30 * DAY),
+                max: options.max,
+            });
+            if (options.json)
+                createRenderer({ format: "json", color: false, streams }).result(result);
+            else
+                streams.data(`${text(result)}\n`);
+        }
+        finally {
+            await store.close();
+        }
+    });
+};
+//# sourceMappingURL=command.js.map

package/dist/mail/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/mail/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAgB,MAAM,mBAAmB,CAAA;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AACxD,OAAO,EAAgB,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAqB,UAAU,EAAE,MAAM,aAAa,CAAA;AAE3D,MAAM,GAAG,GAAG,UAAU,CAAA;AAEtB,MAAM,GAAG,GAAG,CAAC,KAAa,EAAQ,EAAE;IAClC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,KAAK,YAAY,CAAC,CAAA;IAC3C,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACpE,MAAM,IAAI,oBAAoB,CAAC,sBAAsB,CAAC,CAAA;IACxD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED,MAAM,IAAI,GAAG,CAAC,MAAoB,EAAU,EAAE,CAC5C;IACE,GAAG,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,MAAM,sBAAsB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI;QACpF,GAAG,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,aAAa,oBAAoB,MAAM,CAAC,OAAO,kBAAkB;IACpG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,4DAA4D,CAAC,CAAC;IAC1F,GAAG,CAAC,MAAM,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,sBAAsB,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;CACpG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEd,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAgB,EAAE,OAAgB,EAAE,GAAsB,EAAQ,EAAE;IAC9F,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,2DAA2D,CAAC,CAAA;IAE7G,IAAI;SACD,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,iGAAiG,CAAC;SAC9G,MAAM,CAAC,kBAAkB,EAAE,+EAA+E,CAAC;SAC3G,MAAM,CAAC,gBAAgB,EAAE,sDAAsD,EAAE,GAAG,CAAC;SACrF,MAAM,CAAC,WAAW,EAAE,uCAAuC,EAAE,QAAQ,EAAE,GAAG,CAAC;SAC3E,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC;SAC9B,MAAM,CAAC,KAAK,EAAE,OAAwE,EAAE,EAAE;QACzF,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAA;QACrD,MAAM,OAAO,GACX,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;QACrG,IAAI,OAAO,KAAK,SAAS;YACvB,MAAM,IAAI,QAAQ,CAChB,qBAAqB,EACrB,OAAO,CAAC,OAAO,KAAK,SAAS;gBAC3B,CAAC,CAAC,sEAAsE;gBACxE,CAAC,CAAC,oBAAoB,OAAO,CAAC,OAAO,kCAAkC,CAC1E,CAAA;QACH,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;gBAC9B,KAAK;gBACL,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC;gBAClB,OAAO;gBACP,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;gBACvD,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC,CAAA;YACF,IAAI,OAAO,CAAC,IAAI;gBAAE,cAAc,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;;gBACrF,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACxC,CAAC;gBAAS,CAAC;YACT,MAAM,KAAK,CAAC,KAAK,EAAE,CAAA;QACrB,CAAC;IACH,CAAC,CAAC,CAAA;AACN,CAAC,CAAA"}

package/dist/mail/gmail.d.ts

@@ -0,0 +1,14 @@
+import type { Himalaya } from "./himalaya.js";
+export interface Listed {
+    uid: string;
+    /** Gmail's own ids: the same in every folder, and they survive a UID reset. */
+    messageId: string;
+    threadId: string;
+    receivedAt: string;
+}
+/**
+ * Every message in All Mail received since `since`, read with EXAMINE so nothing can change a flag.
+ * All Mail rather than INBOX: an archived message leaves INBOX but is not deleted.
+ */
+export declare const listAllMail: (run: Himalaya, account: string, since: Date) => Promise<Listed[]>;
+//# sourceMappingURL=gmail.d.ts.map

package/dist/mail/gmail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail.d.ts","sourceRoot":"","sources":["../../src/mail/gmail.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAmCD;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAe,QAAQ,WAAW,MAAM,SAAS,IAAI,KAAG,OAAO,CAAC,MAAM,EAAE,CAkC/F,CAAA"}

package/dist/mail/gmail.js

@@ -0,0 +1,57 @@
+import { CliError } from "@leemour/cli-core";
+const ALL_MAIL = '"[Gmail]/All Mail"';
+const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
+const FETCH_BATCH = 500;
+const imapDate = (day) => `${day.getUTCDate()}-${MONTHS[day.getUTCMonth()]}-${day.getUTCFullYear()}`;
+/** IMAP's `INTERNALDATE`: `"04-Oct-2026 19:51:09 +0000"`. */
+const isoOf = (internal) => {
+    const match = /^\s*(\d{1,2})-(\w{3})-(\d{4}) (\d{2}):(\d{2}):(\d{2}) ([+-])(\d{2})(\d{2})$/.exec(internal);
+    if (match === null)
+        throw new CliError("invalid_response", `unexpected IMAP date "${internal}"`);
+    const [, day, month, year, hour, minute, second, sign, offsetHours, offsetMinutes] = match;
+    const local = Date.UTC(Number(year), MONTHS.indexOf(month ?? ""), Number(day), Number(hour), Number(minute), Number(second));
+    const offset = (Number(offsetHours) * 60 + Number(offsetMinutes)) * 60_000 * (sign === "-" ? -1 : 1);
+    return new Date(local - offset).toISOString();
+};
+/** A tagged NO or BAD comes back as output, not as an error, so every tag must end in OK. */
+const assertCompleted = (output, tags) => {
+    for (const tag of tags) {
+        if (!new RegExp(`^${tag} OK`, "m").test(output)) {
+            const line = output.split(/\r?\n/).find((text) => text.startsWith(`${tag} `)) ?? "no answer";
+            throw new CliError("provider_error", `IMAP command ${tag} did not complete: ${line}`);
+        }
+    }
+};
+/**
+ * Every message in All Mail received since `since`, read with EXAMINE so nothing can change a flag.
+ * All Mail rather than INBOX: an archived message leaves INBOX but is not deleted.
+ */
+export const listAllMail = async (run, account, since) => {
+    const search = await run(["imap", "raw", "-a", account], `a EXAMINE ${ALL_MAIL}\r\nb UID SEARCH SINCE ${imapDate(since)}\r\n`);
+    assertCompleted(search, ["a", "b"]);
+    const uids = (/^\* SEARCH(.*)$/m.exec(search)?.[1] ?? "").trim().split(/\s+/).filter(Boolean);
+    if (uids.length === 0)
+        return [];
+    const batches = [];
+    for (let start = 0; start < uids.length; start += FETCH_BATCH)
+        batches.push(uids.slice(start, start + FETCH_BATCH).join(","));
+    const tags = batches.map((_, index) => `f${index}`);
+    const fetched = await run(["imap", "raw", "-a", account], `a EXAMINE ${ALL_MAIL}\r\n${batches
+        .map((set, index) => `${tags[index]} UID FETCH ${set} (UID X-GM-MSGID X-GM-THRID INTERNALDATE)\r\n`)
+        .join("")}`);
+    assertCompleted(fetched, ["a", ...tags]);
+    const listed = [...fetched.matchAll(/^\* \d+ FETCH \((.*)\)\s*$/gm)].map(([, items = ""]) => {
+        const item = (name) => new RegExp(`${name} (\\d+)`).exec(items)?.[1];
+        const internal = /INTERNALDATE "([^"]+)"/.exec(items)?.[1];
+        const uid = item("UID");
+        const messageId = item("X-GM-MSGID");
+        const threadId = item("X-GM-THRID");
+        if (!uid || !messageId || !threadId || !internal)
+            throw new CliError("invalid_response", `IMAP FETCH answer without the Gmail ids: ${items}`);
+        return { uid, messageId, threadId, receivedAt: isoOf(internal) };
+    });
+    if (listed.length !== uids.length)
+        throw new CliError("invalid_response", `IMAP listed ${uids.length} messages but fetched ${listed.length}`);
+    return listed;
+};
+//# sourceMappingURL=gmail.js.map

package/dist/mail/gmail.js.map

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

package/dist/mail/himalaya.d.ts

@@ -0,0 +1,4 @@
+export type Himalaya = (args: string[], input?: string) => Promise<string>;
+/** `MEMO_HIMALAYA` names the program, so the test sandbox can point it at a fake. */
+export declare const himalaya: (env?: NodeJS.ProcessEnv) => Himalaya;
+//# sourceMappingURL=himalaya.d.ts.map

package/dist/mail/himalaya.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"himalaya.d.ts","sourceRoot":"","sources":["../../src/mail/himalaya.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAE1E,qFAAqF;AACrF,eAAO,MAAM,QAAQ,SACb,MAAM,CAAC,UAAU,KAAiB,QAgBpC,CAAA"}

package/dist/mail/himalaya.js

@@ -0,0 +1,13 @@
+import { execFile } from "node:child_process";
+import { CliError } from "@leemour/cli-core";
+/** `MEMO_HIMALAYA` names the program, so the test sandbox can point it at a fake. */
+export const himalaya = (env = process.env) => (args, input) => new Promise((resolve, reject) => {
+    const child = execFile(env.MEMO_HIMALAYA ?? "himalaya", args, { env, maxBuffer: 64 * 1024 * 1024 }, (error, stdout, stderr) => {
+        if (error === null)
+            resolve(stdout);
+        else
+            reject(new CliError("provider_error", `himalaya ${args[0] ?? ""} failed: ${stderr.trim() || error.message}`));
+    });
+    child.stdin?.end(input ?? "");
+});
+//# sourceMappingURL=himalaya.js.map