granola-toolkit 0.40.0 → 0.41.0

package/README.md

@@ -23,6 +23,7 @@ The published package exposes both `granola` and `granola-toolkit` as executable
 granola auth login --api-key grn_...
 granola sync
 granola sync --watch
+granola automation rules
 granola folder list
 granola meeting list --limit 10
 granola notes --folder Team

package/dist/cli.js

@@ -18,6 +18,8 @@ const granolaTransportPaths = {
 	authRefresh: "/auth/refresh",
 	authStatus: "/auth/status",
 	authUnlock: "/auth/unlock",
+	automationMatches: "/automation/matches",
+	automationRules: "/automation/rules",
 	events: "/events",
 	exportJobs: "/exports/jobs",
 	exportNotes: "/exports/notes",
@@ -179,6 +181,13 @@ var GranolaServerClient = class GranolaServerClient {
 	async inspectAuth() {
 		return await this.requestJson(granolaTransportPaths.authStatus);
 	}
+	async listAutomationRules() {
+		return await this.requestJson(granolaTransportPaths.automationRules);
+	}
+	async listAutomationMatches(options = {}) {
+		const path = options.limit ? `${granolaTransportPaths.automationMatches}?limit=${encodeURIComponent(String(options.limit))}` : granolaTransportPaths.automationMatches;
+		return await this.requestJson(path);
+	}
 	async inspectSync() {
 		return cloneValue(this.#state.sync);
 	}
@@ -420,7 +429,7 @@ function asRecord(value) {
 function stringValue(value) {
 	return typeof value === "string" ? value : "";
 }
-function stringArray(value) {
+function stringArray$1(value) {
 	if (!Array.isArray(value)) return [];
 	return value.filter((item) => typeof item === "string");
 }
@@ -2341,6 +2350,168 @@ const attachCommand = {
 	}
 };
 //#endregion
+//#region src/persistence/layout.ts
+function defaultGranolaToolkitDataDirectory(targetPlatform = platform(), homeDirectory = homedir()) {
+	return targetPlatform === "darwin" ? join(homeDirectory, "Library", "Application Support", "granola-toolkit") : join(homeDirectory, ".config", "granola-toolkit");
+}
+function defaultGranolaToolkitPersistenceLayout(options = {}) {
+	const targetPlatform = options.platform ?? platform();
+	const dataDirectory = defaultGranolaToolkitDataDirectory(targetPlatform, options.homeDirectory ?? homedir());
+	return {
+		automationMatchesFile: join(dataDirectory, "automation-matches.jsonl"),
+		automationRulesFile: join(dataDirectory, "automation-rules.json"),
+		apiKeyFile: join(dataDirectory, "api-key.txt"),
+		dataDirectory,
+		exportJobsFile: join(dataDirectory, "export-jobs.json"),
+		meetingIndexFile: join(dataDirectory, "meeting-index.json"),
+		sessionFile: join(dataDirectory, "session.json"),
+		sessionStoreKind: targetPlatform === "darwin" ? "keychain" : "file",
+		syncEventsFile: join(dataDirectory, "sync-events.jsonl"),
+		syncStateFile: join(dataDirectory, "sync-state.json")
+	};
+}
+//#endregion
+//#region src/automation-matches.ts
+function cloneMatch(match) {
+	return {
+		...match,
+		folders: match.folders.map((folder) => ({ ...folder })),
+		tags: [...match.tags]
+	};
+}
+var FileAutomationMatchStore = class {
+	constructor(filePath = defaultAutomationMatchesFilePath()) {
+		this.filePath = filePath;
+	}
+	async appendMatches(matches) {
+		if (matches.length === 0) return;
+		await mkdir(dirname(this.filePath), { recursive: true });
+		const payload = matches.map((match) => JSON.stringify(match)).join("\n");
+		await appendFile(this.filePath, `${payload}\n`, {
+			encoding: "utf8",
+			mode: 384
+		});
+	}
+	async readMatches(limit = 50) {
+		try {
+			const matches = (await readFile(this.filePath, "utf8")).split("\n").map((line) => line.trim()).filter(Boolean).map((line) => parseJsonString(line)).filter((match) => Boolean(match)).map(cloneMatch);
+			return (limit > 0 ? matches.slice(-limit) : matches).reverse();
+		} catch {
+			return [];
+		}
+	}
+};
+function defaultAutomationMatchesFilePath() {
+	return defaultGranolaToolkitPersistenceLayout().automationMatchesFile;
+}
+function createDefaultAutomationMatchStore(filePath) {
+	return new FileAutomationMatchStore(filePath);
+}
+//#endregion
+//#region src/automation-rules.ts
+function cloneRule(rule) {
+	return {
+		...rule,
+		when: {
+			...rule.when,
+			eventKinds: rule.when.eventKinds ? [...rule.when.eventKinds] : void 0,
+			folderIds: rule.when.folderIds ? [...rule.when.folderIds] : void 0,
+			folderNames: rule.when.folderNames ? [...rule.when.folderNames] : void 0,
+			meetingIds: rule.when.meetingIds ? [...rule.when.meetingIds] : void 0,
+			tags: rule.when.tags ? [...rule.when.tags] : void 0,
+			titleIncludes: rule.when.titleIncludes ? [...rule.when.titleIncludes] : void 0
+		}
+	};
+}
+function stringArray(value) {
+	if (!Array.isArray(value)) return;
+	const values = value.filter((item) => typeof item === "string" && item.trim().length > 0);
+	return values.length > 0 ? [...new Set(values.map((item) => item.trim()))] : void 0;
+}
+function parseRule(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return;
+	const record = value;
+	const id = typeof record.id === "string" && record.id.trim() ? record.id.trim() : void 0;
+	const name = typeof record.name === "string" && record.name.trim() ? record.name.trim() : void 0;
+	const whenValue = record.when && typeof record.when === "object" && !Array.isArray(record.when) ? record.when : void 0;
+	if (!id || !name || !whenValue) return;
+	return {
+		enabled: typeof record.enabled === "boolean" ? record.enabled : void 0,
+		id,
+		name,
+		when: {
+			eventKinds: stringArray(whenValue.eventKinds),
+			folderIds: stringArray(whenValue.folderIds),
+			folderNames: stringArray(whenValue.folderNames),
+			meetingIds: stringArray(whenValue.meetingIds),
+			tags: stringArray(whenValue.tags),
+			titleIncludes: stringArray(whenValue.titleIncludes),
+			titleMatches: typeof whenValue.titleMatches === "string" && whenValue.titleMatches.trim() ? whenValue.titleMatches.trim() : void 0,
+			transcriptLoaded: typeof whenValue.transcriptLoaded === "boolean" ? whenValue.transcriptLoaded : void 0
+		}
+	};
+}
+var FileAutomationRuleStore = class {
+	constructor(filePath = defaultAutomationRulesFilePath()) {
+		this.filePath = filePath;
+	}
+	async readRules() {
+		try {
+			const parsed = parseJsonString(await readFile(this.filePath, "utf8"));
+			return (Array.isArray(parsed) ? parsed : parsed && typeof parsed === "object" && Array.isArray(parsed.rules) ? parsed.rules : []).map((rule) => parseRule(rule)).filter((rule) => Boolean(rule)).map(cloneRule);
+		} catch {
+			return [];
+		}
+	}
+};
+function defaultAutomationRulesFilePath() {
+	return defaultGranolaToolkitPersistenceLayout().automationRulesFile;
+}
+function includesIgnoreCase(candidate, values) {
+	const lowerCandidate = candidate.toLowerCase();
+	return values.some((value) => lowerCandidate.includes(value.toLowerCase()));
+}
+function matchesRule(rule, event) {
+	if (rule.enabled === false) return false;
+	const { when } = rule;
+	if (when.eventKinds?.length && !when.eventKinds.includes(event.kind)) return false;
+	if (when.meetingIds?.length && !when.meetingIds.includes(event.meetingId)) return false;
+	if (when.folderIds?.length && !event.folders.some((folder) => when.folderIds?.includes(folder.id))) return false;
+	if (when.folderNames?.length && !event.folders.some((folder) => when.folderNames?.includes(folder.name))) return false;
+	if (when.tags?.length && !event.tags.some((tag) => when.tags?.includes(tag))) return false;
+	if (when.titleIncludes?.length && !includesIgnoreCase(event.title, when.titleIncludes)) return false;
+	if (when.titleMatches) try {
+		if (!new RegExp(when.titleMatches, "i").test(event.title)) return false;
+	} catch {
+		return false;
+	}
+	if (typeof when.transcriptLoaded === "boolean" && when.transcriptLoaded !== event.transcriptLoaded) return false;
+	return true;
+}
+function matchAutomationRules(rules, events, matchedAt) {
+	const matches = [];
+	for (const event of events) for (const rule of rules) {
+		if (!matchesRule(rule, event)) continue;
+		matches.push({
+			eventId: event.id,
+			eventKind: event.kind,
+			folders: event.folders.map((folder) => ({ ...folder })),
+			id: `${event.id}:${rule.id}`,
+			matchedAt,
+			meetingId: event.meetingId,
+			ruleId: rule.id,
+			ruleName: rule.name,
+			tags: [...event.tags],
+			title: event.title,
+			transcriptLoaded: event.transcriptLoaded
+		});
+	}
+	return matches;
+}
+function createDefaultAutomationRuleStore(filePath) {
+	return new FileAutomationRuleStore(filePath);
+}
+//#endregion
 //#region src/cache.ts
 function parseCacheDocument(id, value) {
 	const record = asRecord(value);
@@ -2395,25 +2566,6 @@ function parseCacheContents(contents) {
 	};
 }
 //#endregion
-//#region src/persistence/layout.ts
-function defaultGranolaToolkitDataDirectory(targetPlatform = platform(), homeDirectory = homedir()) {
-	return targetPlatform === "darwin" ? join(homeDirectory, "Library", "Application Support", "granola-toolkit") : join(homeDirectory, ".config", "granola-toolkit");
-}
-function defaultGranolaToolkitPersistenceLayout(options = {}) {
-	const targetPlatform = options.platform ?? platform();
-	const dataDirectory = defaultGranolaToolkitDataDirectory(targetPlatform, options.homeDirectory ?? homedir());
-	return {
-		apiKeyFile: join(dataDirectory, "api-key.txt"),
-		dataDirectory,
-		exportJobsFile: join(dataDirectory, "export-jobs.json"),
-		meetingIndexFile: join(dataDirectory, "meeting-index.json"),
-		sessionFile: join(dataDirectory, "session.json"),
-		sessionStoreKind: targetPlatform === "darwin" ? "keychain" : "file",
-		syncEventsFile: join(dataDirectory, "sync-events.jsonl"),
-		syncStateFile: join(dataDirectory, "sync-state.json")
-	};
-}
-//#endregion
 //#region src/client/auth.ts
 const execFileAsync$1 = promisify(execFile);
 const DEFAULT_CLIENT_ID = "client_GranolaMac";
@@ -2911,7 +3063,7 @@ function parseDocument(value) {
 		lastViewedPanel: parseLastViewedPanel(record.last_viewed_panel),
 		notes: parseProseMirrorDoc(record.notes),
 		notesPlain: stringValue(record.notes_plain),
-		tags: stringArray(record.tags),
+		tags: stringArray$1(record.tags),
 		title: stringValue(record.title),
 		updatedAt: stringValue(record.updated_at)
 	};
@@ -3684,6 +3836,16 @@ function normaliseMeeting(meeting) {
 function meetingChanged(previous, next) {
 	return JSON.stringify(normaliseMeeting(previous)) !== JSON.stringify(normaliseMeeting(next));
 }
+function cloneFolderSummary$1(folder) {
+	return { ...folder };
+}
+function cloneMeetingSummary$1(meeting) {
+	return {
+		...meeting,
+		folders: meeting.folders.map((folder) => cloneFolderSummary$1(folder)),
+		tags: [...meeting.tags]
+	};
+}
 function diffMeetingSummaries(previous, next, folderCount) {
 	const previousById = new Map(previous.map((meeting) => [meeting.id, meeting]));
 	const nextById = new Map(next.map((meeting) => [meeting.id, meeting]));
@@ -3756,15 +3918,20 @@ function diffMeetingSummaries(previous, next, folderCount) {
 		}
 	};
 }
-function buildSyncEvents(runId, occurredAt, changes) {
+function buildSyncEvents(runId, occurredAt, changes, previousMeetings, nextMeetings) {
+	const previousById = new Map(previousMeetings.map((meeting) => [meeting.id, cloneMeetingSummary$1(meeting)]));
+	const nextById = new Map(nextMeetings.map((meeting) => [meeting.id, cloneMeetingSummary$1(meeting)]));
 	return changes.map((change, index) => ({
+		folders: (change.kind === "removed" ? previousById.get(change.meetingId) : nextById.get(change.meetingId))?.folders.map((folder) => cloneFolderSummary$1(folder)) ?? [],
 		id: `${runId}:${index + 1}`,
 		kind: change.kind === "created" ? "meeting.created" : change.kind === "changed" ? "meeting.changed" : change.kind === "removed" ? "meeting.removed" : "transcript.ready",
 		meetingId: change.meetingId,
 		occurredAt,
 		previousUpdatedAt: change.previousUpdatedAt,
 		runId,
+		tags: (change.kind === "removed" ? previousById.get(change.meetingId) : nextById.get(change.meetingId))?.tags.slice() ?? [],
 		title: change.title,
+		transcriptLoaded: (change.kind === "removed" ? previousById.get(change.meetingId) : nextById.get(change.meetingId))?.transcriptLoaded ?? false,
 		updatedAt: change.updatedAt
 	}));
 }
@@ -3811,9 +3978,11 @@ function cloneMeetingSummary(meeting) {
 function cloneState(state) {
 	return {
 		auth: { ...state.auth },
+		automation: { ...state.automation },
 		cache: { ...state.cache },
 		config: {
 			...state.config,
+			automation: state.config.automation ? { ...state.config.automation } : void 0,
 			notes: { ...state.config.notes },
 			transcripts: { ...state.config.transcripts }
 		},
@@ -3832,6 +4001,13 @@ function cloneState(state) {
 function defaultState(config, auth, surface) {
 	return {
 		auth: { ...auth },
+		automation: {
+			loaded: false,
+			matchCount: 0,
+			matchesFile: defaultAutomationMatchesFilePath(),
+			ruleCount: 0,
+			rulesFile: config.automation?.rulesFile ?? defaultAutomationRulesFilePath()
+		},
 		cache: {
 			configured: Boolean(config.transcripts.cacheFile),
 			documentCount: 0,
@@ -3873,6 +4049,8 @@ function defaultState(config, auth, surface) {
 	};
 }
 var GranolaApp = class {
+	#automationMatches;
+	#automationRules;
 	#cacheData;
 	#cacheResolved = false;
 	#folders;
@@ -3886,7 +4064,32 @@ var GranolaApp = class {
 		this.config = config;
 		this.deps = deps;
 		this.#state = defaultState(config, deps.auth, options.surface ?? "cli");
+		this.#automationMatches = (deps.automationMatches ?? []).map((match) => ({
+			...match,
+			folders: match.folders.map((folder) => ({ ...folder })),
+			tags: [...match.tags]
+		}));
+		this.#automationRules = (deps.automationRules ?? []).map((rule) => ({
+			...rule,
+			when: {
+				...rule.when,
+				eventKinds: rule.when.eventKinds ? [...rule.when.eventKinds] : void 0,
+				folderIds: rule.when.folderIds ? [...rule.when.folderIds] : void 0,
+				folderNames: rule.when.folderNames ? [...rule.when.folderNames] : void 0,
+				meetingIds: rule.when.meetingIds ? [...rule.when.meetingIds] : void 0,
+				tags: rule.when.tags ? [...rule.when.tags] : void 0,
+				titleIncludes: rule.when.titleIncludes ? [...rule.when.titleIncludes] : void 0
+			}
+		}));
 		this.#state.exports.jobs = (deps.exportJobs ?? []).map((job) => cloneExportJob(job));
+		this.#state.automation = {
+			lastMatchedAt: this.#automationMatches[0]?.matchedAt,
+			loaded: true,
+			matchCount: this.#automationMatches.length,
+			matchesFile: defaultAutomationMatchesFilePath(),
+			ruleCount: this.#automationRules.length,
+			rulesFile: config.automation?.rulesFile ?? defaultAutomationRulesFilePath()
+		};
 		this.#meetingIndex = (deps.meetingIndex ?? []).map((meeting) => cloneMeetingSummary(meeting));
 		this.#state.index = {
 			available: this.#meetingIndex.length > 0,
@@ -3959,6 +4162,51 @@ var GranolaApp = class {
 		if (!this.deps.syncStateStore) return;
 		await this.deps.syncStateStore.writeState(this.#state.sync);
 	}
+	cloneAutomationRule(rule) {
+		return {
+			...rule,
+			when: {
+				...rule.when,
+				eventKinds: rule.when.eventKinds ? [...rule.when.eventKinds] : void 0,
+				folderIds: rule.when.folderIds ? [...rule.when.folderIds] : void 0,
+				folderNames: rule.when.folderNames ? [...rule.when.folderNames] : void 0,
+				meetingIds: rule.when.meetingIds ? [...rule.when.meetingIds] : void 0,
+				tags: rule.when.tags ? [...rule.when.tags] : void 0,
+				titleIncludes: rule.when.titleIncludes ? [...rule.when.titleIncludes] : void 0
+			}
+		};
+	}
+	cloneAutomationMatch(match) {
+		return {
+			...match,
+			folders: match.folders.map((folder) => ({ ...folder })),
+			tags: [...match.tags]
+		};
+	}
+	async loadAutomationRules(options = {}) {
+		if (this.#automationRules.length > 0 && !options.forceRefresh) return this.#automationRules.map((rule) => this.cloneAutomationRule(rule));
+		if (!this.deps.automationRuleStore) return [];
+		this.#automationRules = (await this.deps.automationRuleStore.readRules()).map((rule) => this.cloneAutomationRule(rule));
+		this.#state.automation = {
+			...this.#state.automation,
+			loaded: true,
+			ruleCount: this.#automationRules.length,
+			rulesFile: this.config.automation?.rulesFile ?? defaultAutomationRulesFilePath()
+		};
+		this.emitStateUpdate();
+		return this.#automationRules.map((rule) => this.cloneAutomationRule(rule));
+	}
+	async appendAutomationMatches(matches) {
+		if (matches.length === 0) return;
+		if (this.deps.automationMatchStore) await this.deps.automationMatchStore.appendMatches(matches);
+		this.#automationMatches.push(...matches.map((match) => this.cloneAutomationMatch(match)));
+		this.#state.automation = {
+			...this.#state.automation,
+			lastMatchedAt: matches.at(-1)?.matchedAt ?? this.#state.automation.lastMatchedAt,
+			loaded: true,
+			matchCount: this.#automationMatches.length
+		};
+	}
 	createSyncRunId() {
 		return `sync-${this.nowIso().replaceAll(/[-:.]/g, "").replace("T", "").replace("Z", "")}`;
 	}
@@ -4190,6 +4438,17 @@ var GranolaApp = class {
 		if (!this.deps.syncEventStore) return { events: [] };
 		return { events: (await this.deps.syncEventStore.readEvents(options.limit)).map(cloneSyncEvent) };
 	}
+	async listAutomationRules() {
+		const rules = await this.loadAutomationRules({ forceRefresh: true });
+		this.setUiState({ view: "idle" });
+		return { rules: rules.map((rule) => this.cloneAutomationRule(rule)) };
+	}
+	async listAutomationMatches(options = {}) {
+		const limit = options.limit ?? 20;
+		const matches = this.deps.automationMatchStore ? await this.deps.automationMatchStore.readMatches(limit) : this.#automationMatches.slice(-limit).reverse();
+		this.setUiState({ view: "idle" });
+		return { matches: matches.map((match) => this.cloneAutomationMatch(match)) };
+	}
 	async loginAuth(options = {}) {
 		const controller = this.requireAuthController();
 		try {
@@ -4255,8 +4514,10 @@ var GranolaApp = class {
 			const { changes, summary } = diffMeetingSummaries(previousMeetings, snapshot.meetings, snapshot.folders?.length ?? 0);
 			const completedAt = this.nowIso();
 			const runId = this.createSyncRunId();
-			const events = buildSyncEvents(runId, completedAt, changes);
+			const events = buildSyncEvents(runId, completedAt, changes, previousMeetings, snapshot.meetings);
 			if (events.length > 0 && this.deps.syncEventStore) await this.deps.syncEventStore.appendEvents(events);
+			const automationMatches = matchAutomationRules(await this.loadAutomationRules(), events, completedAt);
+			await this.appendAutomationMatches(automationMatches);
 			this.#state.sync = {
 				...this.#state.sync,
 				eventCount: this.#state.sync.eventCount + events.length,
@@ -4607,6 +4868,10 @@ var GranolaApp = class {
 };
 async function createGranolaApp(config, options = {}) {
 	const auth = await inspectDefaultGranolaAuth(config);
+	const automationMatchStore = createDefaultAutomationMatchStore();
+	const automationMatches = await automationMatchStore.readMatches(0);
+	const automationRuleStore = createDefaultAutomationRuleStore(config.automation?.rulesFile ?? defaultAutomationRulesFilePath());
+	const automationRules = await automationRuleStore.readRules();
 	const authController = createDefaultGranolaAuthController(config);
 	const exportJobStore = createDefaultExportJobStore();
 	const exportJobs = await exportJobStore.readJobs();
@@ -4618,6 +4883,10 @@ async function createGranolaApp(config, options = {}) {
 	return new GranolaApp(config, {
 		auth,
 		authController,
+		automationMatches,
+		automationMatchStore,
+		automationRules,
+		automationRuleStore,
 		cacheLoader: loadOptionalGranolaCache,
 		createGranolaClient: async (mode) => await createDefaultGranolaRuntime(config, options.logger, { preferredMode: mode }),
 		exportJobs,
@@ -4692,6 +4961,7 @@ async function loadConfig(options) {
 	const defaultCache = firstExistingPath(granolaCacheCandidates());
 	const timeoutValue = pickString(options.subcommandFlags.timeout) ?? pickString(env.TIMEOUT) ?? pickString(configValues.timeout) ?? "2m";
 	return {
+		automation: { rulesFile: pickString(options.globalFlags.rules) ?? pickString(env.GRANOLA_AUTOMATION_RULES_FILE) ?? pickString(configValues["automation-rules-file"]) ?? pickString(configValues.automationRulesFile) ?? defaultGranolaToolkitPersistenceLayout().automationRulesFile },
 		apiKey: pickString(options.globalFlags["api-key"]) ?? pickString(env.GRANOLA_API_KEY) ?? pickString(configValues["api-key"]) ?? pickString(configValues.apiKey),
 		configFileUsed: config.path,
 		debug: pickBoolean(options.globalFlags.debug) ?? envFlag(env.DEBUG_MODE) ?? pickBoolean(configValues.debug) ?? false,
@@ -4771,6 +5041,104 @@ async function waitForShutdown(close) {
 	});
 }
 //#endregion
+//#region src/commands/automation.ts
+function automationHelp() {
+	return `Granola automation
+
+Usage:
+  granola automation <rules|matches> [options]
+
+Subcommands:
+  rules               List configured automation rules
+  matches             Show recent rule matches from sync events
+
+Options:
+  --format <value>    text, json, yaml (default: text)
+  --limit <n>         Number of matches to show (default: 20)
+  --rules <path>      Path to automation rules JSON
+  --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 automation format: expected text, json, or yaml");
+	}
+}
+function parseLimit$3(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);
+}
+function renderRules(rules, format) {
+	if (format === "json") return toJson({ rules });
+	if (format === "yaml") return toYaml({ rules });
+	if (rules.length === 0) return "No automation rules configured\n";
+	return `${["ID                      ENABLED  EVENTS                 FILTERS", ...rules.map((rule) => {
+		const filters = [
+			rule.when.folderIds?.length ? `folderIds=${rule.when.folderIds.join(",")}` : "",
+			rule.when.folderNames?.length ? `folderNames=${rule.when.folderNames.join(",")}` : "",
+			rule.when.tags?.length ? `tags=${rule.when.tags.join(",")}` : "",
+			rule.when.titleIncludes?.length ? `title~=${rule.when.titleIncludes.join(",")}` : "",
+			rule.when.transcriptLoaded === true ? "transcriptLoaded=true" : ""
+		].filter(Boolean).join(" ");
+		return `${rule.id.padEnd(23).slice(0, 23)} ${(rule.enabled === false ? "no" : "yes").padEnd(8)} ${(rule.when.eventKinds?.join(",") || "any").padEnd(22).slice(0, 22)} ${filters || "-"}`;
+	})].join("\n")}\n`;
+}
+function renderMatches(matches, format) {
+	if (format === "json") return toJson({ matches });
+	if (format === "yaml") return toYaml({ matches });
+	if (matches.length === 0) return "No automation matches yet\n";
+	return `${["MATCHED AT            RULE                    EVENT               TITLE", ...matches.map((match) => {
+		return `${match.matchedAt.slice(0, 19).padEnd(21)} ${match.ruleName.padEnd(23).slice(0, 23)} ${match.eventKind.padEnd(18).slice(0, 18)} ${match.title} (${match.meetingId})`;
+	})].join("\n")}\n`;
+}
+const automationCommand = {
+	description: "Inspect automation rules and rule matches",
+	flags: {
+		format: { type: "string" },
+		help: { type: "boolean" },
+		limit: { type: "string" },
+		timeout: { type: "string" }
+	},
+	help: automationHelp,
+	name: "automation",
+	async run({ commandArgs, commandFlags, globalFlags }) {
+		const [action] = commandArgs;
+		const format = resolveFormat(commandFlags.format);
+		const config = await loadConfig({
+			globalFlags,
+			subcommandFlags: commandFlags
+		});
+		debug(config.debug, "using config", config.configFileUsed ?? "(none)");
+		debug(config.debug, "automationRules", config.automation?.rulesFile ?? "(default)");
+		const app = await createGranolaApp(config);
+		switch (action) {
+			case "rules": {
+				const result = await app.listAutomationRules();
+				console.log(renderRules(result.rules, format).trimEnd());
+				return 0;
+			}
+			case "matches": {
+				const result = await app.listAutomationMatches({ limit: parseLimit$3(commandFlags.limit) });
+				console.log(renderMatches(result.matches, format).trimEnd());
+				return 0;
+			}
+			case void 0:
+				console.log(automationHelp());
+				return 1;
+			default: throw new Error("invalid automation command: expected rules or matches");
+		}
+	}
+};
+//#endregion
 //#region src/commands/auth.ts
 function authHelp() {
 	return `Granola auth
@@ -6719,6 +7087,8 @@ var granolaTransportPaths = {
 	authRefresh: "/auth/refresh",
 	authStatus: "/auth/status",
 	authUnlock: "/auth/unlock",
+	automationMatches: "/automation/matches",
+	automationRules: "/automation/rules",
 	events: "/events",
 	exportJobs: "/exports/jobs",
 	exportNotes: "/exports/notes",
@@ -6952,6 +7322,13 @@ var GranolaServerClient = class GranolaServerClient {
 	async inspectAuth() {
 		return await this.requestJson(granolaTransportPaths.authStatus);
 	}
+	async listAutomationRules() {
+		return await this.requestJson(granolaTransportPaths.automationRules);
+	}
+	async listAutomationMatches(options = {}) {
+		const path = options.limit ? \`\${granolaTransportPaths.automationMatches}?limit=\${encodeURIComponent(String(options.limit))}\` : granolaTransportPaths.automationMatches;
+		return await this.requestJson(path);
+	}
 	async inspectSync() {
 		return cloneValue(_classPrivateFieldGet2(_state, this).sync);
 	}
@@ -8508,6 +8885,14 @@ async function startGranolaServer(app, options = {}) {
 				sendJson(response, await app.inspectAuth(), { headers: originHeaders });
 				return;
 			}
+			if (method === "GET" && path === granolaTransportPaths.automationRules) {
+				sendJson(response, await app.listAutomationRules(), { headers: originHeaders });
+				return;
+			}
+			if (method === "GET" && path === granolaTransportPaths.automationMatches) {
+				sendJson(response, await app.listAutomationMatches({ limit: parseInteger(url.searchParams.get("limit")) }), { headers: originHeaders });
+				return;
+			}
 			if (method === "POST" && path === granolaTransportPaths.syncRun) {
 				const body = await readJsonBody(request);
 				sendJson(response, await app.sync({
@@ -9515,6 +9900,7 @@ Options:
 //#region src/commands/index.ts
 const commands = [
 	attachCommand,
+	automationCommand,
 	authCommand,
 	exportsCommand,
 	folderCommand,
@@ -9645,6 +10031,7 @@ Global options:
   --api-key <token>   Granola Personal API key
   --config <path>     Path to .granola.toml
   --debug             Enable debug logging
+  --rules <path>      Path to automation rules JSON
   --supabase <path>   Path to supabase.json
   -h, --help          Show help
 
@@ -9664,6 +10051,7 @@ async function runCli(argv) {
 			config: { type: "string" },
 			debug: { type: "boolean" },
 			help: { type: "boolean" },
+			rules: { type: "string" },
 			supabase: { type: "string" }
 		});
 		if (global.values.help && !command) {

package/package.json

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