@wirecat/cli-memo 0.0.0-stage → 0.5.0

package/dist/notes/dialects/obsidian.js.map

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

package/dist/notes/dialects/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * What a note says, in no editor's syntax. A dialect turns a file into this and back; nothing above
+ * the dialect ever sees `[[…]]` or `[…](…)`.
+ */
+export interface NoteLink {
+    /**
+     * A note as written, extension dropped (`People/Rin`, `../Rin`), or a typed reference
+     * (`person:…`, `msg:…`) when the link names a record instead of a file.
+     */
+    target: string;
+    /** `#Heading` or `#^block`, when the link points inside the note. */
+    anchor: string | null;
+    label: string | null;
+}
+export interface ParsedNote {
+    title: string;
+    aliases: string[];
+    /** As written, without `#`; a nested Obsidian tag keeps its `/`. */
+    tags: string[];
+    links: NoteLink[];
+    frontMatter: Record<string, unknown>;
+}
+export interface NoteForExport {
+    title: string;
+    text: string;
+    aliases: string[];
+    tags: string[];
+    /** Links the text does not already carry; written after it. */
+    links: NoteLink[];
+    frontMatter: Record<string, unknown>;
+}
+export declare const DIALECTS: readonly ["obsidian", "markdown"];
+export type DialectName = (typeof DIALECTS)[number];
+export interface NoteDialect {
+    name: DialectName;
+    parse(text: string, path: string): ParsedNote;
+    render(note: NoteForExport): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/notes/dialects/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/notes/dialects/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,qEAAqE;IACrE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,oEAAoE;IACpE,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,+DAA+D;IAC/D,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED,eAAO,MAAM,QAAQ,YAAI,UAAU,EAAE,UAAU,CAAU,CAAA;AACzD,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAA;IAC7C,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAA;CACpC"}

package/dist/notes/dialects/types.js

@@ -0,0 +1,2 @@
+export const DIALECTS = ["obsidian", "markdown"];
+//# sourceMappingURL=types.js.map

package/dist/notes/dialects/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/notes/dialects/types.ts"],"names":[],"mappings":"AAkCA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,UAAU,EAAE,UAAU,CAAU,CAAA"}

package/dist/notes/embed.d.ts

@@ -0,0 +1,51 @@
+import type { AccountKey, MessageStore } from "@wirecat/cli-messaging/store";
+/** About three chunks a second with e5-small on this laptop (2026-10-06): a run stays near three minutes, under a five-minute timer, and the next resumes. */
+export declare const EMBED_PER_RUN = 600;
+export interface NotesEmbedded {
+    chats: number;
+    chunks: number;
+    /** Chunks left for the next run, when the run's bound stopped it. */
+    left: boolean;
+    /** Why nothing was embedded, when nothing could be. */
+    notEmbedded?: string;
+    pendingChats?: string[];
+}
+/**
+ * Builds each chat's conversations (one per note) — what search by words and by meaning both read — and,
+ * unless `embed` is off, embeds the chunks that have no vector yet. Chunks are
+ * keyed by their text's hash, so an unchanged note is never embedded twice. A missing model is reported,
+ * never downloaded.
+ */
+export declare const embedNotes: (store: MessageStore, key: AccountKey, chats: string[], { maxChunks, embed, env, }?: {
+    maxChunks?: number;
+    embed?: boolean;
+    env?: NodeJS.ProcessEnv;
+}) => Promise<NotesEmbedded>;
+/**
+ * Embeds what changed since the last run, and whatever an earlier run left. The folders waiting are kept in
+ * the store's sync state, so a run stopped by its bound, or a missing model, picks up next time; the first run
+ * after embedding exists takes every folder already stored.
+ */
+export declare const embedChanged: (store: MessageStore, key: AccountKey, changed: string[], options?: {
+    maxChunks?: number;
+    maxChats?: number;
+    embed?: boolean;
+    env?: NodeJS.ProcessEnv;
+}) => Promise<NotesEmbedded>;
+export interface NoteChunksEmbedded {
+    chunks: number;
+    /** Chunks left for the next run, when the run's bound stopped it. */
+    left: boolean;
+    /** Why nothing was embedded, when nothing could be. */
+    notEmbedded?: string;
+}
+/**
+ * Embeds the notes' chunks that have no vector yet, for search by meaning. Bounded like mail, so a
+ * timer run stays short and the next continues. A missing model is reported, never downloaded.
+ */
+export declare const embedNoteChunks: (store: MessageStore, { maxChunks, embed, env, }?: {
+    maxChunks?: number;
+    embed?: boolean;
+    env?: NodeJS.ProcessEnv;
+}) => Promise<NoteChunksEmbedded>;
+//# sourceMappingURL=embed.d.ts.map

package/dist/notes/embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../src/notes/embed.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAG5E,8JAA8J;AAC9J,eAAO,MAAM,aAAa,MAAM,CAAA;AAEhC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,qEAAqE;IACrE,IAAI,EAAE,OAAO,CAAA;IACb,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB;AAKD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,UACd,YAAY,OACd,UAAU,SACR,MAAM,EAAE,+BAKZ;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAClE,OAAO,CAAC,aAAa,CA4CvB,CAAA;AAID;;;;GAIG;AACH,eAAO,MAAM,YAAY,UAChB,YAAY,OACd,UAAU,WACN,MAAM,EAAE,YACR;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAC3F,OAAO,CAAC,aAAa,CAoBvB,CAAA;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,qEAAqE;IACrE,IAAI,EAAE,OAAO,CAAA;IACb,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,UACnB,YAAY,+BAKhB;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAClE,OAAO,CAAC,kBAAkB,CAa5B,CAAA"}

package/dist/notes/embed.js

@@ -0,0 +1,109 @@
+import { CliError } from "@wirecat/cli-core";
+import { conversationsService, embeddingsService, embedNotes as embedNoteChunksOf, storeOnlyDeps, } from "@wirecat/cli-messaging/services";
+import { APP } from "../app.js";
+/** About three chunks a second with e5-small on this laptop (2026-10-06): a run stays near three minutes, under a five-minute timer, and the next resumes. */
+export const EMBED_PER_RUN = 600;
+const isMissingModel = (error) => error instanceof CliError && error.code === "not_found" && /is not downloaded/.test(error.message);
+/**
+ * Builds each chat's conversations (one per note) — what search by words and by meaning both read — and,
+ * unless `embed` is off, embeds the chunks that have no vector yet. Chunks are
+ * keyed by their text's hash, so an unchanged note is never embedded twice. A missing model is reported,
+ * never downloaded.
+ */
+export const embedNotes = async (store, key, chats, { maxChunks = EMBED_PER_RUN, embed = true, env, } = {}) => {
+    const deps = storeOnlyDeps(store, key, { app: APP, ...(env === undefined ? {} : { env }) });
+    const conversations = conversationsService(deps);
+    const embeddings = embeddingsService(deps);
+    for (const chat of chats) {
+        await conversations.build(chat).catch((error) => {
+            // A folder whose every note was deleted has nothing left to build.
+            if (!(error instanceof CliError && error.code === "not_found"))
+                throw error;
+        });
+    }
+    let chunks = 0;
+    let left = false;
+    const pendingChats = [];
+    for (const [index, chat] of (embed ? chats : []).entries()) {
+        if (chunks >= maxChunks) {
+            left = true;
+            pendingChats.push(...chats.slice(index));
+            break;
+        }
+        try {
+            const done = await embeddings.embed(chat, { maxChunks: maxChunks - chunks });
+            chunks += done.embedded;
+            if ((await embeddings.status(chat)).left > 0) {
+                left = true;
+                pendingChats.push(chat);
+            }
+        }
+        catch (error) {
+            if (!isMissingModel(error))
+                throw error;
+            return {
+                chats: chats.length,
+                chunks,
+                left: true,
+                notEmbedded: "the e5-small model is not downloaded — tg models text download e5-small",
+                pendingChats: [...pendingChats, ...chats.slice(index)],
+            };
+        }
+    }
+    return {
+        chats: chats.length,
+        chunks,
+        left,
+        ...(pendingChats.length ? { pendingChats } : {}),
+        ...(embed ? {} : { notEmbedded: "embedding is off", pendingChats: chats }),
+    };
+};
+const PENDING = "embed_pending";
+/**
+ * Embeds what changed since the last run, and whatever an earlier run left. The folders waiting are kept in
+ * the store's sync state, so a run stopped by its bound, or a missing model, picks up next time; the first run
+ * after embedding exists takes every folder already stored.
+ */
+export const embedChanged = async (store, key, changed, options = {}) => {
+    const saved = await store.syncState(key, PENDING);
+    const waiting = saved === undefined
+        ? (await store.chats(key, { limit: 10_000 })).items.map(({ id }) => id)
+        : JSON.parse(saved.value);
+    // A build under older rules, or one a change made stale, is rebuilt even when no note changed since.
+    const deps = storeOnlyDeps(store, key, { app: APP, ...(options.env === undefined ? {} : { env: options.env }) });
+    const behind = (await embeddingsService(deps).readiness({})).chats
+        .filter(({ state, graph, vectors }) => state === "stale" || graph?.outdatedRules === true || vectors.missing > 0)
+        .map(({ chat }) => chat);
+    const chats = [...new Set([...changed, ...waiting, ...behind])];
+    if (chats.length === 0)
+        return { chats: 0, chunks: 0, left: false };
+    const selected = chats.slice(0, options.maxChats ?? 100);
+    const result = await embedNotes(store, key, selected, options);
+    const pending = [...chats.slice(selected.length), ...(result.pendingChats ?? (result.left ? selected : []))];
+    result.left ||= pending.length > 0;
+    // Embedding off leaves every chat waiting, so turning it on later embeds them.
+    await store.setSyncState(key, PENDING, JSON.stringify(pending));
+    return result;
+};
+/**
+ * Embeds the notes' chunks that have no vector yet, for search by meaning. Bounded like mail, so a
+ * timer run stays short and the next continues. A missing model is reported, never downloaded.
+ */
+export const embedNoteChunks = async (store, { maxChunks = EMBED_PER_RUN, embed = true, env, } = {}) => {
+    if (!embed)
+        return { chunks: 0, left: true, notEmbedded: "embedding is off" };
+    try {
+        const done = await embedNoteChunksOf(store, { maxChunks, command: "tg", ...(env === undefined ? {} : { env }) });
+        return { chunks: done.embedded, left: done.left };
+    }
+    catch (error) {
+        if (!isMissingModel(error))
+            throw error;
+        return {
+            chunks: 0,
+            left: true,
+            notEmbedded: "the e5-small model is not downloaded — tg models text download e5-small",
+        };
+    }
+};
+//# sourceMappingURL=embed.js.map

package/dist/notes/embed.js.map

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

package/dist/notes/export.d.ts

@@ -0,0 +1,27 @@
+import type { NoteDialect, NoteForExport } from "./dialects/index.js";
+export interface ExportedNote extends NoteForExport {
+    /** The note's id in the store; written as `memo-id` so import skips the file. */
+    id: string;
+}
+export interface ExportResult {
+    dir: string;
+    written: string[];
+    unchanged: string[];
+    /** Files memo wrote that were edited since: left as they are, so the edit is not lost. */
+    edited: {
+        path: string;
+        id: string;
+    }[];
+}
+export declare const editedSinceExport: (content: string) => boolean;
+/**
+ * Writes each note to `dir` in `dialect`'s format. A file keeps its name across exports (found by its
+ * `memo-id`), is rewritten only while it is still what memo wrote, and a file memo did not write is never
+ * touched. Nothing is deleted.
+ */
+export declare const exportNotes: ({ dir, dialect, notes, }: {
+    dir: string;
+    dialect: NoteDialect;
+    notes: ExportedNote[];
+}) => ExportResult;
+//# sourceMappingURL=export.d.ts.map

package/dist/notes/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/notes/export.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGrE,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,0FAA0F;IAC1F,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACvC;AAkBD,eAAO,MAAM,iBAAiB,YAAa,MAAM,KAAG,OAGnD,CAAA;AAkBD;;;;GAIG;AACH,eAAO,MAAM,WAAW,6BAIrB;IACD,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,WAAW,CAAA;IACpB,KAAK,EAAE,YAAY,EAAE,CAAA;CACtB,KAAG,YAkCH,CAAA"}

package/dist/notes/export.js

@@ -0,0 +1,76 @@
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { readMemoId } from "./files.js";
+const HASH_LINE = /^memo-hash: .*\r?\n/m;
+const PLACEHOLDER = "f".repeat(64);
+const UNSAFE = /[\\/:*?"<>|#^[\]\p{Cc}]/gu;
+const MAX_NAME = 120;
+const sha256 = (text) => createHash("sha256").update(text).digest("hex");
+/**
+ * The hash covers the file minus its own `memo-hash` line, so a file can prove it is still what memo
+ * wrote without memo keeping any record of its own.
+ */
+const withHash = (content) => {
+    const hash = sha256(content.replace(HASH_LINE, ""));
+    return content.replace(`memo-hash: ${PLACEHOLDER}`, `memo-hash: ${hash}`);
+};
+export const editedSinceExport = (content) => {
+    const stored = /^memo-hash: ([0-9a-f]{64})$/m.exec(content)?.[1];
+    return stored === undefined || sha256(content.replace(HASH_LINE, "")) !== stored;
+};
+const fileName = (title, id, taken) => {
+    const base = title.replace(UNSAFE, " ").replace(/\s+/g, " ").trim().slice(0, MAX_NAME) || id;
+    const plain = `${base}.md`;
+    return taken(plain) ? `${base} (${id.slice(-8)}).md` : plain;
+};
+const exportedIn = (dir) => {
+    const found = new Map();
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        if (!entry.isFile() || !/\.(md|markdown)$/i.test(entry.name))
+            continue;
+        const id = readMemoId(join(dir, entry.name));
+        if (id !== null)
+            found.set(id, entry.name);
+    }
+    return found;
+};
+/**
+ * Writes each note to `dir` in `dialect`'s format. A file keeps its name across exports (found by its
+ * `memo-id`), is rewritten only while it is still what memo wrote, and a file memo did not write is never
+ * touched. Nothing is deleted.
+ */
+export const exportNotes = ({ dir, dialect, notes, }) => {
+    mkdirSync(dir, { recursive: true });
+    const existing = exportedIn(dir);
+    const claimed = new Set(existing.values());
+    const result = { dir, written: [], unchanged: [], edited: [] };
+    for (const { id, ...note } of notes) {
+        const frontMatter = { "memo-id": id, "memo-hash": PLACEHOLDER, ...note.frontMatter };
+        frontMatter["memo-id"] = id;
+        frontMatter["memo-hash"] = PLACEHOLDER;
+        const content = withHash(dialect.render({ ...note, frontMatter }));
+        const known = existing.get(id);
+        const name = known ?? fileName(note.title, id, (candidate) => claimed.has(candidate) || existsSync(join(dir, candidate)));
+        claimed.add(name);
+        const path = join(dir, name);
+        if (known !== undefined) {
+            const current = readFileSync(path, "utf8");
+            if (editedSinceExport(current)) {
+                result.edited.push({ path, id });
+                continue;
+            }
+            if (current === content) {
+                result.unchanged.push(path);
+                continue;
+            }
+        }
+        // Hidden, so an import running meanwhile never lists a half-written file.
+        const partial = join(dir, `.${name}.memo-tmp`);
+        writeFileSync(partial, content);
+        renameSync(partial, path);
+        result.written.push(path);
+    }
+    return result;
+};
+//# sourceMappingURL=export.js.map

package/dist/notes/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/notes/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACrG,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAevC,MAAM,SAAS,GAAG,sBAAsB,CAAA;AACxC,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AAClC,MAAM,MAAM,GAAG,2BAA2B,CAAA;AAC1C,MAAM,QAAQ,GAAG,GAAG,CAAA;AAEpB,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAEhF;;;GAGG;AACH,MAAM,QAAQ,GAAG,CAAC,OAAe,EAAU,EAAE;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAA;IACnD,OAAO,OAAO,CAAC,OAAO,CAAC,cAAc,WAAW,EAAE,EAAE,cAAc,IAAI,EAAE,CAAC,CAAA;AAC3E,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAW,EAAE;IAC5D,MAAM,MAAM,GAAG,8BAA8B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAChE,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAA;AAClF,CAAC,CAAA;AAED,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,EAAU,EAAE,KAAgC,EAAU,EAAE;IACvF,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAA;IAC5F,MAAM,KAAK,GAAG,GAAG,IAAI,KAAK,CAAA;IAC1B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAA;AAC9D,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,CAAC,GAAW,EAAuB,EAAE;IACtD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IACvC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAQ;QACtE,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;QAC5C,IAAI,EAAE,KAAK,IAAI;YAAE,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;IAC5C,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAC1B,GAAG,EACH,OAAO,EACP,KAAK,GAKN,EAAgB,EAAE;IACjB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACnC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;IAChC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAiB,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IAE5E,KAAK,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;QACpC,MAAM,WAAW,GAA4B,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QAC7G,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE,CAAA;QAC3B,WAAW,CAAC,WAAW,CAAC,GAAG,WAAW,CAAA;QACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAA;QAClE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC9B,MAAM,IAAI,GACR,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;QAC9G,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YAC1C,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;gBAChC,SAAQ;YACV,CAAC;YACD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;gBACxB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAC3B,SAAQ;YACV,CAAC;QACH,CAAC;QACD,0EAA0E;QAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,WAAW,CAAC,CAAA;QAC9C,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC/B,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QACzB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/dist/notes/files.d.ts

@@ -0,0 +1,14 @@
+export declare const NOTE_EXTENSIONS: string[];
+/** The `memo-id` of a file memo exported, read from the front matter at its start; `null` for any other file. */
+export declare const readMemoId: (path: string) => string | null;
+export declare const isExported: (path: string) => boolean;
+/**
+ * Note files under `folder`, as absolute paths. Hidden entries (`.obsidian`, `.trash`) are skipped, and
+ * so is whatever an `ignore` rule names — a path inside the folder (`Psychology/Personal Notes.md`,
+ * `Archive`) or a glob (`**\/Private*`, `*.txt`). A note memo exported is skipped too: it is already in
+ * the store, and importing it would make it a second note.
+ */
+export declare const noteFiles: (folder: string, ignore?: string[], extensions?: string[], { skipExported }?: {
+    skipExported?: boolean;
+}) => string[];
+//# sourceMappingURL=files.d.ts.map

package/dist/notes/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/notes/files.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,UAe3B,CAAA;AAKD,iHAAiH;AACjH,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,MAAM,GAAG,IAUlD,CAAA;AAID,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,OAA4D,CAAA;AAoBtG;;;;;GAKG;AACH,eAAO,MAAM,SAAS,WACZ,MAAM,WACN,MAAM,EAAE,4CAES;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,KAClD,MAAM,EAgBR,CAAA"}

package/dist/notes/files.js

@@ -0,0 +1,77 @@
+import { closeSync, openSync, readdirSync, readSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+export const NOTE_EXTENSIONS = [
+    ".md",
+    ".markdown",
+    ".txt",
+    ".csv",
+    ".tsv",
+    ".pdf",
+    ".docx",
+    ".xlsx",
+    ".odt",
+    ".ods",
+    ".pptx",
+    ".epub",
+    ".doc",
+    ".xls",
+];
+const MEMO_ID = /^---\r?\n(?:[^\n]*\n)*?memo-id:[ \t]*["']?([^"'\s]+)/;
+const HEAD = 1024;
+/** The `memo-id` of a file memo exported, read from the front matter at its start; `null` for any other file. */
+export const readMemoId = (path) => {
+    const buffer = Buffer.alloc(HEAD);
+    const descriptor = openSync(path, "r");
+    try {
+        const head = buffer.subarray(0, readSync(descriptor, buffer, 0, HEAD, 0)).toString("utf8");
+        const end = head.indexOf("\n---", 3);
+        return MEMO_ID.exec(end < 0 ? head : head.slice(0, end + 1))?.[1] ?? null;
+    }
+    finally {
+        closeSync(descriptor);
+    }
+};
+const TEXT_NOTE = /\.(md|markdown)$/i;
+export const isExported = (path) => TEXT_NOTE.test(path) && readMemoId(path) !== null;
+const pattern = (rule) => {
+    const glob = rule.replace(/\\/g, "/").replace(/^\/+|\/+$/g, "");
+    const body = glob
+        .split(/(\*\*\/?|\*|\?)/)
+        .map((part) => part === "**/" || part === "**"
+        ? ".*"
+        : part === "*"
+            ? "[^/]*"
+            : part === "?"
+                ? "[^/]"
+                : part.replace(/[.+^${}()|[\]\\]/g, "\\$&"))
+        .join("");
+    // A rule names a path inside the folder, and everything under it when it is a folder.
+    return new RegExp(`^${body}(/.*)?$`, "i");
+};
+/**
+ * Note files under `folder`, as absolute paths. Hidden entries (`.obsidian`, `.trash`) are skipped, and
+ * so is whatever an `ignore` rule names — a path inside the folder (`Psychology/Personal Notes.md`,
+ * `Archive`) or a glob (`**\/Private*`, `*.txt`). A note memo exported is skipped too: it is already in
+ * the store, and importing it would make it a second note.
+ */
+export const noteFiles = (folder, ignore = [], extensions = NOTE_EXTENSIONS, { skipExported = true } = {}) => {
+    const rules = ignore.map(pattern);
+    const ignored = (path) => {
+        const inside = relative(folder, path).split(sep).join("/");
+        return rules.some((rule) => rule.test(inside));
+    };
+    const walk = (dir) => readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {
+        if (entry.name.startsWith("."))
+            return [];
+        const path = join(dir, entry.name);
+        if (ignored(path))
+            return [];
+        if (entry.isDirectory())
+            return walk(path);
+        if (!entry.isFile() || !extensions.some((ext) => entry.name.toLowerCase().endsWith(ext)))
+            return [];
+        return skipExported && isExported(path) ? [] : [path];
+    });
+    return walk(folder);
+};
+//# sourceMappingURL=files.js.map

package/dist/notes/files.js.map

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

package/dist/notes/folders-command.d.ts

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

package/dist/notes/folders-command.d.ts.map

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

package/dist/notes/folders-command.js

@@ -0,0 +1,113 @@
+import { statSync } from "node:fs";
+import { basename, resolve } from "node:path";
+import { CliError, createRenderer } from "@wirecat/cli-core";
+import { openStore } from "@wirecat/cli-messaging/store";
+import { InvalidArgumentError } from "commander";
+import { loadConfig, updateConfig } from "../config.js";
+import { claimPendingFolders } from "./bound.js";
+import { DIALECTS } from "./dialects/index.js";
+import { attachFolder, bindFolder, noteFolders } from "./folders.js";
+const formatOf = (value) => {
+    if (!DIALECTS.includes(value))
+        throw new InvalidArgumentError(`choose ${DIALECTS.join(", ")}`);
+    return value;
+};
+const directory = (path) => {
+    const at = resolve(path);
+    let isDirectory = false;
+    try {
+        isDirectory = statSync(at).isDirectory();
+    }
+    catch { }
+    if (!isDirectory)
+        throw new CliError("not_found", `${at} is not a folder`);
+    return at;
+};
+const line = (folder) => `${folder.id ?? "(no id — memo folders add <path>)"}  ${folder.format}  ${folder.path}`;
+export const foldersCommand = (program, streams, env) => {
+    const print = (json, value, text) => {
+        if (json)
+            createRenderer({ format: "json", color: false, streams }).result(value);
+        else
+            streams.data(`${text}\n`);
+    };
+    const withStore = async (work) => {
+        const store = await openStore({ env });
+        try {
+            await claimPendingFolders(store, env);
+            return await work(store);
+        }
+        finally {
+            await store.close();
+        }
+    };
+    const folders = program
+        .command("folders")
+        .description("Folders of notes: an id that links and the store use, and where the folder is on this computer");
+    folders
+        .command("add")
+        .description("Give a folder of notes an id, or show the one it has")
+        .argument("<path>", "the folder on this computer")
+        .option("--format <format>", `how its notes are written: ${DIALECTS.join(", ")} (default: obsidian)`, formatOf)
+        .option("--json", "print JSON")
+        .action(async (path, options) => {
+        const at = directory(path);
+        const answer = await withStore(async (store) => {
+            const known = new Set((await store.notes.folders()).map(({ id }) => id));
+            const current = noteFolders(loadConfig(env).notes).find((folder) => folder.path === at);
+            if (current?.id && known.has(current.id)) {
+                const folder = { ...current, id: current.id, format: options.format ?? current.format };
+                if (folder.format !== current.format)
+                    updateConfig((config) => bindFolder(config, folder), env);
+                return { ...folder, created: false };
+            }
+            const format = options.format ?? current?.format ?? "obsidian";
+            const made = await store.notes.addFolder({ name: basename(at) || at, format });
+            const folder = { id: made.id, path: at, format };
+            updateConfig((config) => bindFolder(config, folder), env);
+            return { ...folder, created: true };
+        });
+        print(options.json, answer, answer.id);
+    });
+    folders
+        .command("attach")
+        .description("Bind a folder id from another computer to the folder's path on this one")
+        .argument("<id>", "the folder's id, as memo folders add printed it")
+        .argument("<path>", "the same folder on this computer")
+        .option("--format <format>", `how its notes are written: ${DIALECTS.join(", ")}`, formatOf)
+        .option("--json", "print JSON")
+        .action(async (id, path, options) => {
+        const at = directory(path);
+        const folder = await withStore(async (store) => {
+            const stored = (await store.notes.folders()).find((candidate) => candidate.id === id);
+            if (!stored)
+                throw new CliError("not_found", `the store has no folder ${id} — memo folders list shows those it has`);
+            let bound;
+            updateConfig((config) => {
+                const result = attachFolder(config, id, at, options.format ?? stored.format);
+                bound = result.folder;
+                return result.config;
+            }, env);
+            return bound;
+        });
+        print(options.json, folder, line(folder));
+    });
+    folders
+        .command("list")
+        .description("The folders of notes: those on this computer, and those the store has from another")
+        .option("--json", "print JSON")
+        .action(async (options) => {
+        const answer = await withStore(async (store) => {
+            const here = noteFolders(loadConfig(env).notes);
+            const elsewhere = (await store.notes.folders())
+                .filter((folder) => !here.some((entry) => entry.id === folder.id))
+                .map(({ id, name, format }) => ({ id, name, format }));
+            return { items: here, elsewhere };
+        });
+        print(options.json, answer, [
+            ...answer.items.map(line),
+            ...answer.elsewhere.map(({ id, name }) => `${id}  not on this computer (${name}) — memo folders attach ${id} <path>`),
+        ].join("\n") || "no folders: memo folders add <path>");
+    });
+};
+//# sourceMappingURL=folders-command.js.map

package/dist/notes/folders-command.js.map

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

package/dist/notes/folders.d.ts

@@ -0,0 +1,27 @@
+import type { Config } from "../config.js";
+import type { DialectName } from "./dialects/index.js";
+/**
+ * A folder of notes on this computer. The id is what the store and every link use; the path is only
+ * where the folder is here, so the same folder can live elsewhere on another computer.
+ */
+export interface NoteFolder {
+    /** `null` for a folder still written as a bare path, until `memo folders add` gives it an id. */
+    id: string | null;
+    path: string;
+    format: DialectName;
+}
+export declare const noteFolders: (notes: Config["notes"]) => NoteFolder[];
+export declare const folderPaths: (notes: Config["notes"]) => string[];
+/** Writes `folder` at its path, in place of whatever entry had that path or that id. */
+export declare const bindFolder: (config: Config, folder: NoteFolder & {
+    id: string;
+}) => Config;
+/**
+ * Binds a folder id made elsewhere to its path on this computer. An id already here moves to the new
+ * path; a path already bound to another id is refused, since its notes would change identity.
+ */
+export declare const attachFolder: (config: Config, id: string, path: string, format?: DialectName) => {
+    config: Config;
+    folder: NoteFolder;
+};
+//# sourceMappingURL=folders.d.ts.map

package/dist/notes/folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/notes/folders.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,iGAAiG;IACjG,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,WAAW,CAAA;CACpB;AASD,eAAO,MAAM,WAAW,UAAW,MAAM,CAAC,OAAO,CAAC,KAAG,UAAU,EAAyC,CAAA;AAExG,eAAO,MAAM,WAAW,UAAW,MAAM,CAAC,OAAO,CAAC,KAAG,MAAM,EAAgD,CAAA;AAgB3G,wFAAwF;AACxF,eAAO,MAAM,UAAU,WAAY,MAAM,UAAU,UAAU,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,KAAG,MAShF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,WACf,MAAM,MACV,MAAM,QACJ,MAAM,WACH,WAAW,KACnB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAatC,CAAA"}