@xopcai/xopc 0.0.90 → 0.0.92

package/dist/src/notes/store.js

@@ -0,0 +1,342 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
+import { buildNoteIndexMeta, notePlainText } from "./note-index-meta.js";
+import { resolveNoteHistoryDir, resolveNoteItemPath, resolveNoteMediaDir, resolveNotesDir, resolveNotesIndexPath } from "./paths.js";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+import { access, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
+//#region src/notes/store.ts
+init_write_file_atomic();
+init_logger();
+const log = createLogger("NotesStore");
+const DEFAULT_INDEX = {
+	version: 3,
+	notes: []
+};
+const INDEX_VERSION = 3;
+const DEBOUNCE_MS = 500;
+function noteToIndexEntry(note) {
+	const { snippet, coverAttachmentId, voiceAttachmentId, voiceDurationSec, attachmentNames } = buildNoteIndexMeta(note);
+	return {
+		id: note.id,
+		title: note.title || void 0,
+		kind: note.kind,
+		status: note.status,
+		createdAt: note.createdAt,
+		updatedAt: note.updatedAt,
+		pinned: note.pinned || void 0,
+		tags: note.tags?.length ? note.tags : void 0,
+		snippet,
+		coverAttachmentId,
+		voiceAttachmentId,
+		voiceDurationSec,
+		attachmentNames,
+		groupId: note.groupId || void 0,
+		lastOpenedAt: note.lastOpenedAt || void 0,
+		taskDone: note.taskMeta?.done,
+		taskDueAt: note.taskMeta?.dueAt
+	};
+}
+var NotesStore = class {
+	indexCache = null;
+	dirty = false;
+	saveTimeout = null;
+	initialized = false;
+	async initialize() {
+		if (this.initialized) return;
+		const indexPath = resolveNotesIndexPath();
+		try {
+			await access(indexPath);
+			await this.loadIndex();
+			if ((this.indexCache?.version ?? 0) < INDEX_VERSION) await this.rebuildIndexFromItems();
+		} catch {
+			await this.writeIndex(DEFAULT_INDEX);
+			this.indexCache = DEFAULT_INDEX;
+		}
+		this.initialized = true;
+		log.debug("NotesStore initialized");
+	}
+	async addNote(note) {
+		const index = await this.loadIndex();
+		await this.writeNoteItem(note);
+		index.notes.push(noteToIndexEntry(note));
+		index.version++;
+		this.scheduleIndexSave(index);
+	}
+	async getNote(id) {
+		const itemPath = resolveNoteItemPath(id);
+		try {
+			const content = await readFile(itemPath, "utf-8");
+			return JSON.parse(content);
+		} catch (err) {
+			if ((err && typeof err === "object" && "code" in err ? err.code : "") !== "ENOENT") log.debug({
+				err,
+				id
+			}, "Failed to read note item");
+			return null;
+		}
+	}
+	async updateNote(id, patch) {
+		const existing = await this.getNote(id);
+		if (!existing) return null;
+		const updated = {
+			...existing,
+			...patch,
+			id: existing.id,
+			createdAt: existing.createdAt,
+			updatedAt: Date.now()
+		};
+		await this.writeNoteItem(updated);
+		const index = await this.loadIndex();
+		const idx = index.notes.findIndex((n) => n.id === id);
+		if (idx !== -1) index.notes[idx] = noteToIndexEntry(updated);
+		index.version++;
+		this.scheduleIndexSave(index);
+		return updated;
+	}
+	async deleteNote(id) {
+		if (!await this.getNote(id)) return false;
+		await rm(resolveNoteItemPath(id), { force: true }).catch((err) => {
+			log.warn({
+				err,
+				id
+			}, "Failed to remove note item file");
+		});
+		await rm(resolveNoteMediaDir(id), {
+			recursive: true,
+			force: true
+		}).catch(() => void 0);
+		const index = await this.loadIndex();
+		const before = index.notes.length;
+		index.notes = index.notes.filter((n) => n.id !== id);
+		if (index.notes.length === before) log.debug({ id }, "Deleted note file but index entry was missing");
+		index.version++;
+		this.scheduleIndexSave(index);
+		return true;
+	}
+	async listNotes(query = {}) {
+		let results = (await this.loadIndex()).notes;
+		if (query.status) results = results.filter((n) => n.status === query.status);
+		else results = results.filter((n) => n.status !== "trashed");
+		if (query.kind) results = results.filter((n) => n.kind === query.kind);
+		if (query.tag) results = results.filter((n) => n.tags?.includes(query.tag));
+		if (query.pinned !== void 0) results = results.filter((n) => Boolean(n.pinned) === query.pinned);
+		if (query.groupId !== void 0) if (query.groupId === "ungrouped") results = results.filter((n) => !n.groupId);
+		else results = results.filter((n) => n.groupId === query.groupId);
+		if (query.pendingTasksOnly) results = results.filter((n) => n.kind === "task" && !n.taskDone);
+		if (query.search) {
+			const term = query.search.toLowerCase();
+			const indexMatches = results.filter((n) => this.noteIndexEntryMatchesSearch(n, term));
+			const indexMatchedIds = new Set(indexMatches.map((n) => n.id));
+			const contentMatches = [];
+			const candidates = results.filter((n) => !indexMatchedIds.has(n.id));
+			for (const candidate of candidates) {
+				const note = await this.getNote(candidate.id);
+				if (!note) continue;
+				if ([
+					note.title,
+					notePlainText(note),
+					note.attachments?.map((a) => a.transcript).join(" ")
+				].filter(Boolean).join(" ").toLowerCase().includes(term)) contentMatches.push(candidate);
+			}
+			results = [...indexMatches, ...contentMatches];
+		}
+		const sortField = query.sortBy || "createdAt";
+		const sortDir = query.sortOrder === "asc" ? 1 : -1;
+		results = [...results].sort((a, b) => {
+			return ((a[sortField] ?? 0) - (b[sortField] ?? 0)) * sortDir;
+		});
+		const total = results.length;
+		const offset = query.offset || 0;
+		const limit = Math.min(query.limit || 50, 200);
+		return {
+			items: results.slice(offset, offset + limit),
+			total
+		};
+	}
+	noteIndexEntryMatchesSearch(entry, term) {
+		return Boolean(entry.title?.toLowerCase().includes(term) || entry.snippet?.toLowerCase().includes(term) || entry.tags?.some((tag) => tag.toLowerCase().includes(term)) || entry.attachmentNames?.some((name) => name.toLowerCase().includes(term)));
+	}
+	async saveAttachment(noteId, fileName, buffer) {
+		const mediaDir = resolveNoteMediaDir(noteId);
+		await mkdir(mediaDir, { recursive: true });
+		const safeName = `${randomUUID().slice(0, 8)}_${fileName.replace(/[^a-zA-Z0-9._-]/g, "_")}`;
+		await writeFile(join(mediaDir, safeName), buffer);
+		return {
+			relativePath: safeName,
+			size: buffer.length
+		};
+	}
+	resolveAttachmentPath(noteId, relativePath) {
+		return join(resolveNoteMediaDir(noteId), relativePath);
+	}
+	async deleteAttachmentFile(noteId, relativePath) {
+		await rm(this.resolveAttachmentPath(noteId, relativePath), { force: true }).catch((err) => {
+			log.warn({
+				err,
+				noteId,
+				relativePath
+			}, "Failed to remove note attachment file");
+		});
+	}
+	async saveSnapshot(note, trigger) {
+		const historyDir = resolveNoteHistoryDir(note.id);
+		await mkdir(historyDir, { recursive: true });
+		const snapshot = {
+			noteId: note.id,
+			timestamp: Date.now(),
+			trigger,
+			title: note.title,
+			text: note.text,
+			blocks: note.blocks,
+			tags: note.tags,
+			kind: note.kind,
+			status: note.status
+		};
+		await writeTextAtomic(join(historyDir, `${snapshot.timestamp}.json`), JSON.stringify(snapshot, null, 2));
+		log.debug({
+			noteId: note.id,
+			trigger,
+			timestamp: snapshot.timestamp
+		}, "Snapshot saved");
+	}
+	async listSnapshots(noteId) {
+		const historyDir = resolveNoteHistoryDir(noteId);
+		let files;
+		try {
+			files = await readdir(historyDir);
+		} catch {
+			return [];
+		}
+		const entries = [];
+		for (const file of files) {
+			if (!file.endsWith(".json")) continue;
+			const timestamp = parseInt(file.slice(0, -5), 10);
+			if (!Number.isFinite(timestamp)) continue;
+			try {
+				const content = await readFile(join(historyDir, file), "utf-8");
+				const snapshot = JSON.parse(content);
+				const rawText = snapshot.text ?? "";
+				entries.push({
+					timestamp: snapshot.timestamp,
+					trigger: snapshot.trigger,
+					snippet: rawText.slice(0, 80) || void 0
+				});
+			} catch {
+				log.debug({
+					noteId,
+					file
+				}, "Skipped unreadable snapshot");
+			}
+		}
+		entries.sort((a, b) => b.timestamp - a.timestamp);
+		return entries;
+	}
+	async getSnapshot(noteId, timestamp) {
+		const filePath = join(resolveNoteHistoryDir(noteId), `${timestamp}.json`);
+		try {
+			const content = await readFile(filePath, "utf-8");
+			return JSON.parse(content);
+		} catch {
+			return null;
+		}
+	}
+	async pruneSnapshots(noteId, maxCount) {
+		const historyDir = resolveNoteHistoryDir(noteId);
+		let files;
+		try {
+			files = await readdir(historyDir);
+		} catch {
+			return;
+		}
+		const jsonFiles = files.filter((f) => f.endsWith(".json")).sort();
+		if (jsonFiles.length <= maxCount) return;
+		const toDelete = jsonFiles.slice(0, jsonFiles.length - maxCount);
+		for (const file of toDelete) await rm(join(historyDir, file), { force: true }).catch(() => void 0);
+		log.debug({
+			noteId,
+			deleted: toDelete.length
+		}, "Pruned old snapshots");
+	}
+	async deleteAllSnapshots(noteId) {
+		await rm(resolveNoteHistoryDir(noteId), {
+			recursive: true,
+			force: true
+		}).catch(() => void 0);
+	}
+	async flush() {
+		if (!this.dirty || !this.indexCache) return;
+		if (this.saveTimeout) {
+			clearTimeout(this.saveTimeout);
+			this.saveTimeout = null;
+		}
+		await this.writeIndex(this.indexCache);
+		this.dirty = false;
+	}
+	async loadIndex() {
+		if (this.indexCache) return this.indexCache;
+		const indexPath = resolveNotesIndexPath();
+		try {
+			const content = await readFile(indexPath, "utf-8");
+			const data = JSON.parse(content);
+			if (!data.notes || !Array.isArray(data.notes)) {
+				log.warn("Notes index invalid, resetting");
+				this.indexCache = DEFAULT_INDEX;
+				return this.indexCache;
+			}
+			this.indexCache = data;
+			return data;
+		} catch {
+			this.indexCache = DEFAULT_INDEX;
+			return this.indexCache;
+		}
+	}
+	async writeIndex(data) {
+		await writeTextAtomic(resolveNotesIndexPath(), JSON.stringify(data, null, 2));
+		log.debug({ count: data.notes.length }, "Notes index saved");
+	}
+	async writeNoteItem(note) {
+		await writeTextAtomic(resolveNoteItemPath(note.id), JSON.stringify(note, null, 2));
+	}
+	scheduleIndexSave(data) {
+		this.indexCache = data;
+		this.dirty = true;
+		if (this.saveTimeout) clearTimeout(this.saveTimeout);
+		this.saveTimeout = setTimeout(() => {
+			this.flush().catch((err) => {
+				log.error({ err }, "Failed to flush notes index");
+			});
+		}, DEBOUNCE_MS);
+	}
+	async rebuildIndexFromItems() {
+		const itemsDir = join(resolveNotesDir(), "items");
+		let files;
+		try {
+			files = await readdir(itemsDir);
+		} catch {
+			this.indexCache = DEFAULT_INDEX;
+			await this.writeIndex(DEFAULT_INDEX);
+			return;
+		}
+		const entries = [];
+		for (const file of files) {
+			if (!file.endsWith(".json")) continue;
+			const noteId = file.slice(0, -5);
+			const note = await this.getNote(noteId);
+			if (note) entries.push(noteToIndexEntry(note));
+		}
+		entries.sort((a, b) => b.createdAt - a.createdAt);
+		const index = {
+			version: INDEX_VERSION,
+			notes: entries
+		};
+		this.indexCache = index;
+		await this.writeIndex(index);
+		log.debug({ count: entries.length }, "Notes index rebuilt");
+	}
+};
+//#endregion
+export { NotesStore };
+
+//# sourceMappingURL=store.js.map

package/dist/src/notes/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","names":[],"sources":["../../../src/notes/store.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { readFile, access, mkdir, writeFile, rm, readdir } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { writeTextAtomic } from '../infra/write-file-atomic.js';\nimport { createLogger } from '../utils/logger.js';\nimport { buildNoteIndexMeta, notePlainText } from './note-index-meta.js';\nimport { resolveNotesDir, resolveNotesIndexPath, resolveNoteItemPath, resolveNoteMediaDir, resolveNoteHistoryDir } from './paths.js';\nimport type {\n  Note,\n  NoteIndexEntry,\n  NoteSnapshot,\n  NoteSnapshotEntry,\n  NotesIndexFile,\n  NotesListQuery,\n  SnapshotTrigger,\n} from './types.js';\n\nconst log = createLogger('NotesStore');\n\nconst DEFAULT_INDEX: NotesIndexFile = { version: 3, notes: [] };\nconst INDEX_VERSION = 3;\nconst DEBOUNCE_MS = 500;\n\nfunction noteToIndexEntry(note: Note): NoteIndexEntry {\n  const { snippet, coverAttachmentId, voiceAttachmentId, voiceDurationSec, attachmentNames } = buildNoteIndexMeta(note);\n  return {\n    id: note.id,\n    title: note.title || undefined,\n    kind: note.kind,\n    status: note.status,\n    createdAt: note.createdAt,\n    updatedAt: note.updatedAt,\n    pinned: note.pinned || undefined,\n    tags: note.tags?.length ? note.tags : undefined,\n    snippet,\n    coverAttachmentId,\n    voiceAttachmentId,\n    voiceDurationSec,\n    attachmentNames,\n    groupId: note.groupId || undefined,\n    lastOpenedAt: note.lastOpenedAt || undefined,\n    taskDone: note.taskMeta?.done,\n    taskDueAt: note.taskMeta?.dueAt,\n  };\n}\n\nexport class NotesStore {\n  private indexCache: NotesIndexFile | null = null;\n  private dirty = false;\n  private saveTimeout: ReturnType<typeof setTimeout> | null = null;\n  private initialized = false;\n\n  async initialize(): Promise<void> {\n    if (this.initialized) return;\n    const indexPath = resolveNotesIndexPath();\n    try {\n      await access(indexPath);\n      await this.loadIndex();\n      if ((this.indexCache?.version ?? 0) < INDEX_VERSION) {\n        await this.rebuildIndexFromItems();\n      }\n    } catch {\n      await this.writeIndex(DEFAULT_INDEX);\n      this.indexCache = DEFAULT_INDEX;\n    }\n    this.initialized = true;\n    log.debug('NotesStore initialized');\n  }\n\n  async addNote(note: Note): Promise<void> {\n    const index = await this.loadIndex();\n    await this.writeNoteItem(note);\n    index.notes.push(noteToIndexEntry(note));\n    index.version++;\n    this.scheduleIndexSave(index);\n  }\n\n  async getNote(id: string): Promise<Note | null> {\n    const itemPath = resolveNoteItemPath(id);\n    try {\n      const content = await readFile(itemPath, 'utf-8');\n      return JSON.parse(content) as Note;\n    } catch (err) {\n      const code = err && typeof err === 'object' && 'code' in err\n        ? (err as NodeJS.ErrnoException).code : '';\n      if (code !== 'ENOENT') {\n        log.debug({ err, id }, 'Failed to read note item');\n      }\n      return null;\n    }\n  }\n\n  async updateNote(id: string, patch: Partial<Note>): Promise<Note | null> {\n    const existing = await this.getNote(id);\n    if (!existing) return null;\n\n    const updated: Note = {\n      ...existing,\n      ...patch,\n      id: existing.id,\n      createdAt: existing.createdAt,\n      updatedAt: Date.now(),\n    };\n\n    await this.writeNoteItem(updated);\n\n    const index = await this.loadIndex();\n    const idx = index.notes.findIndex((n) => n.id === id);\n    if (idx !== -1) {\n      index.notes[idx] = noteToIndexEntry(updated);\n    }\n    index.version++;\n    this.scheduleIndexSave(index);\n\n    return updated;\n  }\n\n  async deleteNote(id: string): Promise<boolean> {\n    const existing = await this.getNote(id);\n    if (!existing) return false;\n\n    const itemPath = resolveNoteItemPath(id);\n    await rm(itemPath, { force: true }).catch((err) => {\n      log.warn({ err, id }, 'Failed to remove note item file');\n    });\n\n    const mediaDir = resolveNoteMediaDir(id);\n    await rm(mediaDir, { recursive: true, force: true }).catch(() => undefined);\n\n    const index = await this.loadIndex();\n    const before = index.notes.length;\n    index.notes = index.notes.filter((n) => n.id !== id);\n    if (index.notes.length === before) {\n      log.debug({ id }, 'Deleted note file but index entry was missing');\n    }\n    index.version++;\n    this.scheduleIndexSave(index);\n\n    return true;\n  }\n\n  async listNotes(query: NotesListQuery = {}): Promise<{ items: NoteIndexEntry[]; total: number }> {\n    const index = await this.loadIndex();\n    let results = index.notes;\n\n    if (query.status) {\n      results = results.filter((n) => n.status === query.status);\n    } else {\n      results = results.filter((n) => n.status !== 'trashed');\n    }\n    if (query.kind) {\n      results = results.filter((n) => n.kind === query.kind);\n    }\n    if (query.tag) {\n      results = results.filter((n) => n.tags?.includes(query.tag!));\n    }\n    if (query.pinned !== undefined) {\n      results = results.filter((n) => Boolean(n.pinned) === query.pinned);\n    }\n    if (query.groupId !== undefined) {\n      if (query.groupId === 'ungrouped') {\n        results = results.filter((n) => !n.groupId);\n      } else {\n        results = results.filter((n) => n.groupId === query.groupId);\n      }\n    }\n    if (query.pendingTasksOnly) {\n      results = results.filter((n) => n.kind === 'task' && !n.taskDone);\n    }\n    if (query.search) {\n      const term = query.search.toLowerCase();\n      const indexMatches = results.filter((n) => this.noteIndexEntryMatchesSearch(n, term));\n      const indexMatchedIds = new Set(indexMatches.map((n) => n.id));\n      const contentMatches: NoteIndexEntry[] = [];\n      const candidates = results.filter((n) => !indexMatchedIds.has(n.id));\n      for (const candidate of candidates) {\n        const note = await this.getNote(candidate.id);\n        if (!note) continue;\n        const content = [note.title, notePlainText(note), note.attachments?.map((a) => a.transcript).join(' ')]\n          .filter(Boolean)\n          .join(' ')\n          .toLowerCase();\n        if (content.includes(term)) {\n          contentMatches.push(candidate);\n        }\n      }\n      results = [...indexMatches, ...contentMatches];\n    }\n\n    const sortField = query.sortBy || 'createdAt';\n    const sortDir = query.sortOrder === 'asc' ? 1 : -1;\n    results = [...results].sort((a, b) => {\n      const aVal = a[sortField] ?? 0;\n      const bVal = b[sortField] ?? 0;\n      return (aVal - bVal) * sortDir;\n    });\n\n    const total = results.length;\n    const offset = query.offset || 0;\n    const limit = Math.min(query.limit || 50, 200);\n    const items = results.slice(offset, offset + limit);\n\n    return { items, total };\n  }\n\n  private noteIndexEntryMatchesSearch(entry: NoteIndexEntry, term: string): boolean {\n    return Boolean(\n      entry.title?.toLowerCase().includes(term) ||\n      entry.snippet?.toLowerCase().includes(term) ||\n      entry.tags?.some((tag) => tag.toLowerCase().includes(term)) ||\n      entry.attachmentNames?.some((name) => name.toLowerCase().includes(term)),\n    );\n  }\n\n  async saveAttachment(\n    noteId: string,\n    fileName: string,\n    buffer: Buffer,\n  ): Promise<{ relativePath: string; size: number }> {\n    const mediaDir = resolveNoteMediaDir(noteId);\n    await mkdir(mediaDir, { recursive: true });\n    const safeName = `${randomUUID().slice(0, 8)}_${fileName.replace(/[^a-zA-Z0-9._-]/g, '_')}`;\n    const filePath = join(mediaDir, safeName);\n    await writeFile(filePath, buffer);\n    return { relativePath: safeName, size: buffer.length };\n  }\n\n  resolveAttachmentPath(noteId: string, relativePath: string): string {\n    return join(resolveNoteMediaDir(noteId), relativePath);\n  }\n\n  async deleteAttachmentFile(noteId: string, relativePath: string): Promise<void> {\n    const filePath = this.resolveAttachmentPath(noteId, relativePath);\n    await rm(filePath, { force: true }).catch((err) => {\n      log.warn({ err, noteId, relativePath }, 'Failed to remove note attachment file');\n    });\n  }\n\n  async saveSnapshot(note: Note, trigger: SnapshotTrigger): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(note.id);\n    await mkdir(historyDir, { recursive: true });\n    const snapshot: NoteSnapshot = {\n      noteId: note.id,\n      timestamp: Date.now(),\n      trigger,\n      title: note.title,\n      text: note.text,\n      blocks: note.blocks,\n      tags: note.tags,\n      kind: note.kind,\n      status: note.status,\n    };\n    const filePath = join(historyDir, `${snapshot.timestamp}.json`);\n    await writeTextAtomic(filePath, JSON.stringify(snapshot, null, 2));\n    log.debug({ noteId: note.id, trigger, timestamp: snapshot.timestamp }, 'Snapshot saved');\n  }\n\n  async listSnapshots(noteId: string): Promise<NoteSnapshotEntry[]> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    let files: string[];\n    try {\n      files = await readdir(historyDir);\n    } catch {\n      return [];\n    }\n    const entries: NoteSnapshotEntry[] = [];\n    for (const file of files) {\n      if (!file.endsWith('.json')) continue;\n      const timestamp = parseInt(file.slice(0, -'.json'.length), 10);\n      if (!Number.isFinite(timestamp)) continue;\n      try {\n        const content = await readFile(join(historyDir, file), 'utf-8');\n        const snapshot = JSON.parse(content) as NoteSnapshot;\n        const rawText = snapshot.text ?? '';\n        entries.push({\n          timestamp: snapshot.timestamp,\n          trigger: snapshot.trigger,\n          snippet: rawText.slice(0, 80) || undefined,\n        });\n      } catch {\n        log.debug({ noteId, file }, 'Skipped unreadable snapshot');\n      }\n    }\n    entries.sort((a, b) => b.timestamp - a.timestamp);\n    return entries;\n  }\n\n  async getSnapshot(noteId: string, timestamp: number): Promise<NoteSnapshot | null> {\n    const filePath = join(resolveNoteHistoryDir(noteId), `${timestamp}.json`);\n    try {\n      const content = await readFile(filePath, 'utf-8');\n      return JSON.parse(content) as NoteSnapshot;\n    } catch {\n      return null;\n    }\n  }\n\n  async pruneSnapshots(noteId: string, maxCount: number): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    let files: string[];\n    try {\n      files = await readdir(historyDir);\n    } catch {\n      return;\n    }\n    const jsonFiles = files\n      .filter((f) => f.endsWith('.json'))\n      .sort();\n    if (jsonFiles.length <= maxCount) return;\n    const toDelete = jsonFiles.slice(0, jsonFiles.length - maxCount);\n    for (const file of toDelete) {\n      await rm(join(historyDir, file), { force: true }).catch(() => undefined);\n    }\n    log.debug({ noteId, deleted: toDelete.length }, 'Pruned old snapshots');\n  }\n\n  async deleteAllSnapshots(noteId: string): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    await rm(historyDir, { recursive: true, force: true }).catch(() => undefined);\n  }\n\n  async flush(): Promise<void> {\n    if (!this.dirty || !this.indexCache) return;\n    if (this.saveTimeout) {\n      clearTimeout(this.saveTimeout);\n      this.saveTimeout = null;\n    }\n    await this.writeIndex(this.indexCache);\n    this.dirty = false;\n  }\n\n  private async loadIndex(): Promise<NotesIndexFile> {\n    if (this.indexCache) return this.indexCache;\n    const indexPath = resolveNotesIndexPath();\n    try {\n      const content = await readFile(indexPath, 'utf-8');\n      const data = JSON.parse(content) as NotesIndexFile;\n      if (!data.notes || !Array.isArray(data.notes)) {\n        log.warn('Notes index invalid, resetting');\n        this.indexCache = DEFAULT_INDEX;\n        return this.indexCache;\n      }\n      this.indexCache = data;\n      return data;\n    } catch {\n      this.indexCache = DEFAULT_INDEX;\n      return this.indexCache;\n    }\n  }\n\n  private async writeIndex(data: NotesIndexFile): Promise<void> {\n    const indexPath = resolveNotesIndexPath();\n    await writeTextAtomic(indexPath, JSON.stringify(data, null, 2));\n    log.debug({ count: data.notes.length }, 'Notes index saved');\n  }\n\n  private async writeNoteItem(note: Note): Promise<void> {\n    const itemPath = resolveNoteItemPath(note.id);\n    await writeTextAtomic(itemPath, JSON.stringify(note, null, 2));\n  }\n\n  private scheduleIndexSave(data: NotesIndexFile): void {\n    this.indexCache = data;\n    this.dirty = true;\n    if (this.saveTimeout) {\n      clearTimeout(this.saveTimeout);\n    }\n    this.saveTimeout = setTimeout(() => {\n      this.flush().catch((err) => {\n        log.error({ err }, 'Failed to flush notes index');\n      });\n    }, DEBOUNCE_MS);\n  }\n\n  private async rebuildIndexFromItems(): Promise<void> {\n    const itemsDir = join(resolveNotesDir(), 'items');\n    let files: string[];\n    try {\n      files = await readdir(itemsDir);\n    } catch {\n      this.indexCache = DEFAULT_INDEX;\n      await this.writeIndex(DEFAULT_INDEX);\n      return;\n    }\n\n    const entries: NoteIndexEntry[] = [];\n    for (const file of files) {\n      if (!file.endsWith('.json')) continue;\n      const noteId = file.slice(0, -'.json'.length);\n      const note = await this.getNote(noteId);\n      if (note) {\n        entries.push(noteToIndexEntry(note));\n      }\n    }\n\n    entries.sort((a, b) => b.createdAt - a.createdAt);\n    const index: NotesIndexFile = { version: INDEX_VERSION, notes: entries };\n    this.indexCache = index;\n    await this.writeIndex(index);\n    log.debug({ count: entries.length }, 'Notes index rebuilt');\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,199 @@
+export type NoteKind = 'thought' | 'todo' | 'voice' | 'media' | 'bookmark' | 'mixed' | 'task';
+export type NoteStatus = 'inbox' | 'processed' | 'archived' | 'trashed';
+export type CaptureChannel = 'app' | 'web' | 'electron' | 'tui' | 'telegram' | 'wechat' | 'feishu';
+export type NoteBlockType = 'paragraph' | 'heading' | 'todo' | 'bulletList' | 'numberedList' | 'quote' | 'code' | 'divider' | 'image' | 'aiSuggestion';
+export interface BaseNoteBlock {
+    id: string;
+    type: NoteBlockType;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface TextNoteBlock extends BaseNoteBlock {
+    type: 'paragraph' | 'heading' | 'bulletList' | 'numberedList' | 'quote' | 'code' | 'aiSuggestion';
+    text: string;
+    level?: 1 | 2 | 3;
+    indent?: number;
+}
+export interface TodoNoteBlock extends BaseNoteBlock {
+    type: 'todo';
+    text: string;
+    checked: boolean;
+}
+export interface DividerNoteBlock extends BaseNoteBlock {
+    type: 'divider';
+}
+export interface ImageNoteBlock extends BaseNoteBlock {
+    type: 'image';
+    attachmentId: string;
+    alt?: string;
+    width?: number;
+}
+export type NoteBlock = TextNoteBlock | TodoNoteBlock | DividerNoteBlock | ImageNoteBlock;
+export type NotePatchOperation = {
+    type: 'replaceBlocks';
+    blocks: NoteBlock[];
+} | {
+    type: 'insertBlocksAfter';
+    afterBlockId: string;
+    blocks: NoteBlock[];
+} | {
+    type: 'updateBlock';
+    blockId: string;
+    patch: Partial<NoteBlock>;
+} | {
+    type: 'updateMetadata';
+    title?: string;
+    tags?: string[];
+    status?: NoteStatus;
+};
+export interface NoteAiPatch {
+    id: string;
+    summary: string;
+    operations: NotePatchOperation[];
+}
+export interface NoteAttachment {
+    id: string;
+    type: 'image' | 'video' | 'audio' | 'file';
+    mimeType: string;
+    fileName: string;
+    size: number;
+    relativePath: string;
+    transcript?: string;
+    duration?: number;
+}
+export interface NoteAiMeta {
+    summary?: string;
+    intent?: 'action_item' | 'idea' | 'reference' | 'question' | 'log';
+    extractedTodos?: Array<{
+        text: string;
+        deadline?: string;
+        done: boolean;
+    }>;
+    suggestedTags?: string[];
+}
+export interface NoteAiDeepMeta {
+    processedAt: number;
+    priority?: 'high' | 'medium' | 'low';
+    relatedNoteIds?: string[];
+    relatedGoalId?: string;
+    insights?: string;
+}
+export interface CaptureSource {
+    channel: CaptureChannel;
+    platform?: 'ios' | 'android';
+}
+export interface NoteTaskMeta {
+    done: boolean;
+    dueAt?: number;
+    priority?: 'high' | 'medium' | 'low';
+    /** Session key of the thread that created this task. */
+    sourceSessionKey?: string;
+    /** Note id of the page this task was extracted from. */
+    sourceNoteId?: string;
+}
+export interface Note {
+    id: string;
+    title?: string;
+    kind: NoteKind;
+    status: NoteStatus;
+    text?: string;
+    blocks?: NoteBlock[];
+    attachments?: NoteAttachment[];
+    createdAt: number;
+    updatedAt: number;
+    capturedVia: CaptureSource;
+    ai?: NoteAiMeta;
+    aiDeep?: NoteAiDeepMeta;
+    tags?: string[];
+    pinned?: boolean;
+    localVersion?: number;
+    remoteVersion?: number;
+    /** Space grouping — null means ungrouped (appears in root). */
+    groupId?: string;
+    /** Last time the user explicitly opened this note. */
+    lastOpenedAt?: number;
+    /** Task lifecycle metadata (only when kind === 'task'). */
+    taskMeta?: NoteTaskMeta;
+}
+export interface NoteIndexEntry {
+    id: string;
+    title?: string;
+    kind: NoteKind;
+    status: NoteStatus;
+    createdAt: number;
+    updatedAt: number;
+    pinned?: boolean;
+    tags?: string[];
+    snippet?: string;
+    /** First image attachment id for list thumbnails. */
+    coverAttachmentId?: string;
+    /** First audio attachment id for inline voice playback. */
+    voiceAttachmentId?: string;
+    /** Duration in seconds of the voice attachment (when available). */
+    voiceDurationSec?: number;
+    /** Lowercased attachment file names for list search. */
+    attachmentNames?: string[];
+    /** Space group id. */
+    groupId?: string;
+    /** Last opened timestamp for "continue" rail. */
+    lastOpenedAt?: number;
+    /** Task done flag (only when kind === 'task'). */
+    taskDone?: boolean;
+    /** Task due timestamp (only when kind === 'task'). */
+    taskDueAt?: number;
+}
+export interface NotesIndexFile {
+    version: number;
+    notes: NoteIndexEntry[];
+}
+export type SnapshotTrigger = 'edit' | 'ai_edit' | 'sync' | 'restore';
+export interface NoteSnapshot {
+    noteId: string;
+    timestamp: number;
+    trigger: SnapshotTrigger;
+    title?: string;
+    text?: string;
+    blocks?: NoteBlock[];
+    tags?: string[];
+    kind: NoteKind;
+    status: NoteStatus;
+}
+export interface NoteSnapshotEntry {
+    timestamp: number;
+    trigger: SnapshotTrigger;
+    snippet?: string;
+}
+export interface NotesListQuery {
+    status?: NoteStatus;
+    kind?: NoteKind;
+    tag?: string;
+    pinned?: boolean;
+    search?: string;
+    limit?: number;
+    offset?: number;
+    sortBy?: 'createdAt' | 'updatedAt' | 'lastOpenedAt';
+    sortOrder?: 'asc' | 'desc';
+    /** Filter by space group id. Use `'ungrouped'` for root-level notes. */
+    groupId?: string;
+    /** Filter to only task notes with done === false. */
+    pendingTasksOnly?: boolean;
+}
+export interface CreateNoteParams {
+    title?: string;
+    text?: string;
+    blocks?: NoteBlock[];
+    kind?: NoteKind;
+    tags?: string[];
+    capturedVia: CaptureSource;
+    pinned?: boolean;
+    groupId?: string;
+    taskMeta?: NoteTaskMeta;
+}
+/** A lightweight space group (persisted as a note with kind='mixed', used for grouping). */
+export interface NoteGroup {
+    id: string;
+    name: string;
+    icon?: string;
+    createdAt: number;
+    updatedAt: number;
+}

package/dist/src/notes/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/providers/auth-runtime/auth-profile-store.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 //#region src/providers/auth-runtime/auth-profile-store.ts
 /**
 * {@link AuthProfileStore} implementations.

package/dist/src/providers/index.js

@@ -1,8 +1,8 @@
 import { __esmMin, __exportAll } from "../../_virtual/_rolldown/runtime.js";
-import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
-import { CredentialResolver, hasCredentials, init_credentials, resolveApiKey } from "../auth/credentials.js";
 import { hasProviderAuthOnDiskSync, init_sync_provider_auth } from "../auth/sync-provider-auth.js";
+import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { ModelRegistry, getModelRegistry, init_model_registry, prewarmModelRegistry, resetModelRegistry } from "./model-registry.js";
+import { CredentialResolver, hasCredentials, init_credentials, resolveApiKey } from "../auth/credentials.js";
 import { getProviderRegistry, init_plugin_registry } from "./plugin-registry.js";
 import { getModel, getModels, getProviders } from "@earendil-works/pi-ai";
 //#region src/providers/index.ts

package/dist/src/providers/model-registry.js

@@ -1,10 +1,10 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { resolveModelsJsonPath } from "../config/paths.js";
 import { init_resolve_config_value, resolveConfigValue, resolveHeaders } from "../config/resolve-config-value.js";
 import { getDefaultModelValues, init_models_json, validateModelsConfig } from "../config/models-json.js";
+import { getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { existsSync, readFileSync } from "fs";
 import { getModels, getProviders } from "@earendil-works/pi-ai";
 //#region src/providers/model-registry.ts

package/dist/src/session/config-store.js

@@ -1,9 +1,9 @@
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { mkdir, readFile } from "fs/promises";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { join } from "path";
 import { existsSync } from "fs";
+import { mkdir, readFile } from "fs/promises";
 //#region src/session/config-store.ts
 /**
 * Session Config Store

package/dist/src/session/init-session-turn.js

@@ -1,7 +1,7 @@
-import { createLogger } from "../utils/logger/index.js";
-import { init_logger } from "../utils/logger.js";
 import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { init_session_key, parseSessionKey } from "../routing/session-key.js";
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
 import { evaluateSessionFreshness, resolveSessionResetPolicy } from "./reset-policy.js";
 import { resolveChannelResetConfig, resolveSessionResetType } from "./reset-type.js";
 import { resolveSessionLifecycleTimestamps } from "./lifecycle-timestamps.js";

package/dist/src/session/parity/jsonl-transcript-io.js

@@ -3,9 +3,9 @@ import { loadEntriesFromFile } from "./load-jsonl-entries.js";
 import { withTranscriptFileLock } from "./transcript-file-lock.js";
 import { emitSessionTranscriptUpdate } from "../transcript-events.js";
 import { buildSessionContextForLlm, isTranscriptContextEntry } from "../session-context-for-llm.js";
-import { randomUUID } from "node:crypto";
-import { existsSync } from "node:fs";
 import path from "node:path";
+import { existsSync } from "node:fs";
+import { randomUUID } from "node:crypto";
 import { CURRENT_SESSION_VERSION, SessionManager } from "@earendil-works/pi-coding-agent";
 //#region src/session/parity/jsonl-transcript-io.ts
 init_write_file_atomic();

package/dist/src/session/parity/sessions-json-file.js

@@ -1,9 +1,9 @@
 import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
 import { readSessionsJsonFileRaw } from "./sessions-json-file-read.js";
 import { commitSessionsJsonWrite, getSessionsJsonWriteStats, invalidateSessionsJsonCache, noteSessionsJsonWritten, readSessionsJsonCached, resetSessionsJsonCacheForTest } from "./sessions-json-cache.js";
+import { dirname } from "node:path";
 import { existsSync } from "node:fs";
 import { mkdir } from "node:fs/promises";
-import { dirname } from "node:path";
 import lockfile from "proper-lockfile";
 //#region src/session/parity/sessions-json-file.ts
 init_write_file_atomic();