granola-toolkit 0.42.0 → 0.43.0

package/README.md

@@ -25,6 +25,7 @@ granola sync
 granola sync --watch
 granola automation rules
 granola automation runs
+granola search customer onboarding
 granola folder list
 granola meeting list --limit 10
 granola notes --folder Team

package/dist/cli.js

@@ -2626,6 +2626,7 @@ function defaultGranolaToolkitPersistenceLayout(options = {}) {
 		dataDirectory,
 		exportJobsFile: join(dataDirectory, "export-jobs.json"),
 		meetingIndexFile: join(dataDirectory, "meeting-index.json"),
+		searchIndexFile: join(dataDirectory, "search-index.json"),
 		sessionFile: join(dataDirectory, "session.json"),
 		sessionStoreKind: targetPlatform === "darwin" ? "keychain" : "file",
 		syncEventsFile: join(dataDirectory, "sync-events.jsonl"),
@@ -4352,6 +4353,128 @@ function buildSyncEvents(runId, occurredAt, changes, previousMeetings, nextMeeti
 	}));
 }
 //#endregion
+//#region src/search-index.ts
+const SEARCH_INDEX_VERSION = 1;
+function cloneEntry(entry) {
+	return {
+		...entry,
+		folderIds: [...entry.folderIds],
+		folderNames: [...entry.folderNames],
+		tags: [...entry.tags]
+	};
+}
+function noteText(document) {
+	const notes = document.notesPlain.trim();
+	if (notes) return notes;
+	const panel = document.lastViewedPanel?.originalContent?.trim();
+	if (panel) return panel;
+	return document.content.trim();
+}
+function transcriptText(documentId, cacheData) {
+	return (cacheData?.transcripts[documentId] ?? []).filter((segment) => segment.isFinal).map((segment) => segment.text.trim()).filter(Boolean).join("\n");
+}
+function buildSearchIndex(documents, options = {}) {
+	return documents.map((document) => {
+		const folders = options.foldersByDocumentId?.get(document.id) ?? [];
+		const transcript = transcriptText(document.id, options.cacheData);
+		return {
+			createdAt: document.createdAt,
+			folderIds: folders.map((folder) => folder.id),
+			folderNames: folders.map((folder) => folder.name || folder.id),
+			id: document.id,
+			noteText: noteText(document),
+			tags: [...document.tags],
+			title: document.title,
+			transcriptLoaded: transcript.length > 0,
+			transcriptText: transcript,
+			updatedAt: document.updatedAt
+		};
+	}).sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+}
+function searchFieldScore(value, term) {
+	const lower = value.toLowerCase();
+	if (!lower || !term) return 0;
+	if (lower === term) return 8;
+	if (lower.startsWith(term)) return 5;
+	if (lower.includes(term)) return 3;
+	return 0;
+}
+function combinedText(entry) {
+	return [
+		entry.id,
+		entry.title,
+		...entry.tags,
+		...entry.folderNames,
+		entry.noteText,
+		entry.transcriptText
+	].join("\n").toLowerCase();
+}
+function searchEntryScore(entry, term) {
+	const scoredFields = [
+		searchFieldScore(entry.id, term) * 5,
+		searchFieldScore(entry.title, term) * 8,
+		...entry.tags.map((tag) => searchFieldScore(tag, term) * 6),
+		...entry.folderNames.map((folderName) => searchFieldScore(folderName, term) * 4)
+	].filter((score) => score > 0);
+	if (scoredFields.length > 0) return Math.max(...scoredFields);
+	if (combinedText(entry).includes(term)) return 1;
+}
+function searchSearchIndex(entries, query) {
+	const terms = query.trim().toLowerCase().split(/\s+/).filter(Boolean);
+	if (terms.length === 0) return [];
+	return entries.map((entry) => {
+		let score = 0;
+		for (const term of terms) {
+			const termScore = searchEntryScore(entry, term);
+			if (termScore == null) return;
+			score += termScore;
+		}
+		return {
+			id: entry.id,
+			score,
+			updatedAt: entry.updatedAt
+		};
+	}).filter((entry) => Boolean(entry)).sort((left, right) => right.score - left.score || right.updatedAt.localeCompare(left.updatedAt) || left.id.localeCompare(right.id)).map(({ id, score }) => ({
+		id,
+		score
+	}));
+}
+var FileSearchIndexStore = class {
+	constructor(filePath = defaultSearchIndexFilePath()) {
+		this.filePath = filePath;
+	}
+	async readIndex() {
+		try {
+			const parsed = parseJsonString(await readFile(this.filePath, "utf8"));
+			if (!parsed || parsed.version !== SEARCH_INDEX_VERSION || !Array.isArray(parsed.entries)) return [];
+			return parsed.entries.map(cloneEntry);
+		} catch {
+			return [];
+		}
+	}
+	async writeIndex(entries) {
+		await mkdir(dirname(this.filePath), { recursive: true });
+		const payload = {
+			entries: entries.map(cloneEntry),
+			updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			version: SEARCH_INDEX_VERSION
+		};
+		await writeFile(this.filePath, `${JSON.stringify(payload, null, 2)}\n`, {
+			encoding: "utf8",
+			mode: 384
+		});
+	}
+};
+function defaultSearchIndexFilePath() {
+	return defaultGranolaToolkitPersistenceLayout().searchIndexFile;
+}
+function createDefaultSearchIndexStore() {
+	return new FileSearchIndexStore();
+}
+function meetingIdsFromSearchResults(results) {
+	return results.map((result) => result.id);
+}
+//#endregion
 //#region src/app/core.ts
 function transcriptCount(cacheData) {
 	return Object.values(cacheData.transcripts).filter((segments) => segments.length > 0).length;
@@ -4477,6 +4600,7 @@ var GranolaApp = class {
 	#granolaClient;
 	#documents;
 	#meetingIndex;
+	#searchIndex;
 	#listeners = /* @__PURE__ */ new Set();
 	#refreshingMeetingIndex;
 	#state;
@@ -4505,6 +4629,12 @@ var GranolaApp = class {
 			runsFile: defaultAutomationRunsFilePath()
 		};
 		this.#meetingIndex = (deps.meetingIndex ?? []).map((meeting) => cloneMeetingSummary(meeting));
+		this.#searchIndex = (deps.searchIndex ?? []).map((entry) => ({
+			...entry,
+			folderIds: [...entry.folderIds],
+			folderNames: [...entry.folderNames],
+			tags: [...entry.tags]
+		}));
 		this.#state.index = {
 			available: this.#meetingIndex.length > 0,
 			filePath: defaultMeetingIndexFilePath(),
@@ -4688,6 +4818,15 @@ var GranolaApp = class {
 		if (this.deps.meetingIndexStore) await this.deps.meetingIndexStore.writeIndex(this.#meetingIndex);
 		this.emitStateUpdate();
 	}
+	async persistSearchIndex(entries) {
+		this.#searchIndex = entries.map((entry) => ({
+			...entry,
+			folderIds: [...entry.folderIds],
+			folderNames: [...entry.folderNames],
+			tags: [...entry.tags]
+		}));
+		if (this.deps.searchIndexStore) await this.deps.searchIndexStore.writeIndex(this.#searchIndex);
+	}
 	async liveMeetingSnapshot(options = {}) {
 		const cacheData = await this.loadCache({ forceRefresh: options.forceRefresh });
 		const documents = await this.listDocuments({ forceRefresh: options.forceRefresh });
@@ -5155,6 +5294,10 @@ var GranolaApp = class {
 		try {
 			const snapshot = await this.liveMeetingSnapshot({ forceRefresh: options.forceRefresh ?? true });
 			await this.persistMeetingIndex(snapshot.meetings);
+			await this.persistSearchIndex(buildSearchIndex(snapshot.documents, {
+				cacheData: snapshot.cacheData,
+				foldersByDocumentId: this.buildFoldersByDocumentId(snapshot.folders)
+			}));
 			const { changes, summary } = diffMeetingSummaries(previousMeetings, snapshot.meetings, snapshot.folders?.length ?? 0);
 			const completedAt = this.nowIso();
 			const runId = this.createSyncRunId();
@@ -5285,10 +5428,34 @@ var GranolaApp = class {
 		const summary = resolveFolderQuery((await this.loadFolders({ required: true }) ?? []).map((folder) => buildFolderSummary(folder)), query);
 		return await this.getFolder(summary.id);
 	}
+	indexedMeetingsForSearch(options) {
+		const rankedIds = meetingIdsFromSearchResults(searchSearchIndex(this.#searchIndex, options.search));
+		const rankById = new Map(rankedIds.map((id, index) => [id, index]));
+		return filterMeetingSummaries([...this.#meetingIndex.filter((meeting) => rankById.has(meeting.id))].sort((left, right) => {
+			const leftRank = rankById.get(left.id) ?? Number.MAX_SAFE_INTEGER;
+			const rightRank = rankById.get(right.id) ?? Number.MAX_SAFE_INTEGER;
+			if (leftRank !== rightRank) return leftRank - rightRank;
+			return right.updatedAt.localeCompare(left.updatedAt);
+		}), {
+			folderId: options.folderId,
+			limit: options.limit,
+			sort: options.sort,
+			updatedFrom: options.updatedFrom,
+			updatedTo: options.updatedTo
+		});
+	}
 	async listMeetings(options = {}) {
 		const preferIndex = options.preferIndex ?? (this.#state.ui.surface === "web" || this.#state.ui.surface === "server");
-		if (!options.forceRefresh && preferIndex && !this.#documents && this.#meetingIndex.length > 0) {
-			const meetings = filterMeetingSummaries(this.#meetingIndex, options);
+		const canUseSearchIndex = Boolean(options.search?.trim()) && !options.forceRefresh && this.#searchIndex.length > 0;
+		if (!options.forceRefresh && preferIndex && this.#meetingIndex.length > 0 && (canUseSearchIndex || !this.#documents)) {
+			const meetings = canUseSearchIndex ? this.indexedMeetingsForSearch({
+				folderId: options.folderId,
+				limit: options.limit,
+				search: options.search,
+				sort: options.sort,
+				updatedFrom: options.updatedFrom,
+				updatedTo: options.updatedTo
+			}) : filterMeetingSummaries(this.#meetingIndex, options);
 			this.setUiState({
 				folderSearch: void 0,
 				meetingListSource: "index",
@@ -5367,7 +5534,14 @@ var GranolaApp = class {
 		return bundle;
 	}
 	async findMeeting(query, options = {}) {
-		const bundle = await this.readMeetingBundleByQuery(query, options);
+		let bundle;
+		try {
+			bundle = await this.readMeetingBundleByQuery(query, options);
+		} catch (error) {
+			const fallbackId = meetingIdsFromSearchResults(searchSearchIndex(this.#searchIndex, query))[0];
+			if (!fallbackId) throw error;
+			bundle = await this.readMeetingBundleById(fallbackId, options);
+		}
 		this.setUiState({
 			selectedFolderId: bundle.meeting.meeting.folders[0]?.id,
 			selectedMeetingId: bundle.document.id,
@@ -5531,6 +5705,8 @@ async function createGranolaApp(config, options = {}) {
 	const exportJobs = await exportJobStore.readJobs();
 	const meetingIndexStore = createDefaultMeetingIndexStore();
 	const meetingIndex = await meetingIndexStore.readIndex();
+	const searchIndexStore = createDefaultSearchIndexStore();
+	const searchIndex = await searchIndexStore.readIndex();
 	const syncEventStore = createDefaultSyncEventStore();
 	const syncStateStore = createDefaultSyncStateStore();
 	const syncState = await syncStateStore.readState();
@@ -5550,6 +5726,8 @@ async function createGranolaApp(config, options = {}) {
 		meetingIndex,
 		meetingIndexStore,
 		now: options.now,
+		searchIndex,
+		searchIndexStore,
 		syncEventStore,
 		syncState,
 		syncStateStore
@@ -5724,7 +5902,7 @@ Options:
   -h, --help          Show help
 `;
 }
-function resolveFormat(value) {
+function resolveFormat$1(value) {
 	switch (value) {
 		case void 0: return "text";
 		case "json":
@@ -5733,7 +5911,7 @@ function resolveFormat(value) {
 		default: throw new Error("invalid automation format: expected text, json, or yaml");
 	}
 }
-function parseLimit$3(value) {
+function parseLimit$4(value) {
 	if (value === void 0) return 20;
 	if (typeof value !== "string" || !/^\d+$/.test(value)) throw new Error("invalid automation limit: expected a positive integer");
 	return Number(value);
@@ -5793,7 +5971,7 @@ const automationCommand = {
 	name: "automation",
 	async run({ commandArgs, commandFlags, globalFlags }) {
 		const [action] = commandArgs;
-		const format = resolveFormat(commandFlags.format);
+		const format = resolveFormat$1(commandFlags.format);
 		const config = await loadConfig({
 			globalFlags,
 			subcommandFlags: commandFlags
@@ -5808,13 +5986,13 @@ const automationCommand = {
 				return 0;
 			}
 			case "matches": {
-				const result = await app.listAutomationMatches({ limit: parseLimit$3(commandFlags.limit) });
+				const result = await app.listAutomationMatches({ limit: parseLimit$4(commandFlags.limit) });
 				console.log(renderMatches(result.matches, format).trimEnd());
 				return 0;
 			}
 			case "runs": {
 				const result = await app.listAutomationRuns({
-					limit: parseLimit$3(commandFlags.limit),
+					limit: parseLimit$4(commandFlags.limit),
 					status: parseRunStatus(commandFlags.status)
 				});
 				console.log(renderRuns(result.runs, format).trimEnd());
@@ -5976,7 +6154,7 @@ function resolveListFormat$1(value) {
 		default: throw new Error("invalid exports format: expected text, json, or yaml");
 	}
 }
-function parseLimit$2(value) {
+function parseLimit$3(value) {
 	if (value === void 0) return 20;
 	if (typeof value !== "string" || !/^\d+$/.test(value)) throw new Error("invalid exports limit: expected a positive integer");
 	const limit = Number(value);
@@ -6018,7 +6196,7 @@ const exportsCommand = {
 };
 async function list$2(commandFlags, globalFlags) {
 	const format = resolveListFormat$1(commandFlags.format);
-	const limit = parseLimit$2(commandFlags.limit);
+	const limit = parseLimit$3(commandFlags.limit);
 	const config = await loadConfig({
 		globalFlags,
 		subcommandFlags: commandFlags
@@ -6079,7 +6257,7 @@ function resolveFolderListFormat(value) {
 function resolveFolderDetailFormat(value) {
 	return resolveFolderListFormat(value);
 }
-function parseLimit$1(value) {
+function parseLimit$2(value) {
 	if (value === void 0) return 20;
 	if (typeof value !== "string" || !/^\d+$/.test(value)) throw new Error("invalid folder limit: expected a positive integer");
 	const limit = Number(value);
@@ -6113,7 +6291,7 @@ const folderCommand = {
 };
 async function list$1(commandFlags, globalFlags) {
 	const format = resolveFolderListFormat(commandFlags.format);
-	const limit = parseLimit$1(commandFlags.limit);
+	const limit = parseLimit$2(commandFlags.limit);
 	const search = typeof commandFlags.search === "string" ? commandFlags.search : void 0;
 	const config = await loadConfig({
 		globalFlags,
@@ -10182,7 +10360,7 @@ function resolveTranscriptFormat$1(value) {
 		default: throw new Error("invalid meeting transcript format: expected text, json, yaml, or raw");
 	}
 }
-function parseLimit(value) {
+function parseLimit$1(value) {
 	if (value === void 0) return 20;
 	if (typeof value !== "string" || !/^\d+$/.test(value)) throw new Error("invalid meeting limit: expected a positive integer");
 	const limit = Number(value);
@@ -10236,7 +10414,7 @@ const meetingCommand = {
 };
 async function list(commandFlags, globalFlags) {
 	const format = resolveListFormat(commandFlags.format);
-	const limit = parseLimit(commandFlags.limit);
+	const limit = parseLimit$1(commandFlags.limit);
 	const folderQuery = typeof commandFlags.folder === "string" ? commandFlags.folder : void 0;
 	const search = typeof commandFlags.search === "string" ? commandFlags.search : void 0;
 	const config = await loadConfig({
@@ -10417,6 +10595,77 @@ function resolveNoteFormat(value) {
 	}
 }
 //#endregion
+//#region src/commands/search.ts
+function searchHelp() {
+	return `Granola search
+
+Usage:
+  granola search <query> [options]
+
+Options:
+  --folder <query>    Filter search results to one folder id or name
+  --format <value>    text, json, yaml (default: text)
+  --limit <n>         Number of meetings to show (default: 20)
+  --timeout <value>   Request timeout, e.g. 2m, 30s, 120000 (default: 2m)
+  --supabase <path>   Path to supabase.json
+  --debug             Enable debug logging
+  --config <path>     Path to .granola.toml
+  -h, --help          Show help
+`;
+}
+function resolveFormat(value) {
+	switch (value) {
+		case void 0: return "text";
+		case "json":
+		case "text":
+		case "yaml": return value;
+		default: throw new Error("invalid search format: expected text, json, or yaml");
+	}
+}
+function parseLimit(value) {
+	if (value === void 0) return 20;
+	if (typeof value !== "string" || !/^\d+$/.test(value)) throw new Error("invalid search limit: expected a positive integer");
+	return Number(value);
+}
+const searchCommand = {
+	description: "Search meetings across titles, notes, transcripts, folders, and tags",
+	flags: {
+		folder: { type: "string" },
+		format: { type: "string" },
+		help: { type: "boolean" },
+		limit: { type: "string" },
+		timeout: { type: "string" }
+	},
+	help: searchHelp,
+	name: "search",
+	async run({ commandArgs, commandFlags, globalFlags }) {
+		const query = commandArgs.join(" ").trim();
+		if (!query) {
+			console.log(searchHelp());
+			return 1;
+		}
+		const format = resolveFormat(commandFlags.format);
+		const limit = parseLimit(commandFlags.limit);
+		const folderQuery = typeof commandFlags.folder === "string" ? commandFlags.folder : void 0;
+		const config = await loadConfig({
+			globalFlags,
+			subcommandFlags: commandFlags
+		});
+		debug(config.debug, "using config", config.configFileUsed ?? "(none)");
+		const app = await createGranolaApp(config);
+		const folder = folderQuery ? await app.findFolder(folderQuery) : void 0;
+		const result = await app.listMeetings({
+			folderId: folder?.id,
+			limit,
+			preferIndex: true,
+			search: query
+		});
+		console.log(result.source === "index" ? "Searched the local index" : "Search index unavailable, fell back to live meeting metadata");
+		console.log(renderMeetingList(result.meetings, format).trimEnd());
+		return 0;
+	}
+};
+//#endregion
 //#region src/commands/serve.ts
 function serveHelp() {
 	return `Granola serve
@@ -10771,6 +11020,7 @@ const commands = [
 	folderCommand,
 	meetingCommand,
 	notesCommand,
+	searchCommand,
 	serveCommand,
 	syncCommand,
 	tuiCommand,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "granola-toolkit",
-  "version": "0.42.0",
+  "version": "0.43.0",
   "description": "Toolkit for exporting and working with Granola meetings, notes, and transcripts",
   "keywords": [
     "cli",