@laylzj777/my-apple-apple-eventkit 1.1.0

package/dist/utils/projectUtils.js

@@ -0,0 +1,92 @@
+/**
+ * projectUtils.ts
+ * Shared utilities for project-related operations
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { FILE_SYSTEM } from './constants.js';
+// Project root is immutable for the lifetime of the process. Cache the first
+// resolved path so subsequent MCP tool calls skip the up-to-10-level walk +
+// package.json reads. Cleared by tests via `__clearProjectRootCache`.
+let cachedProjectRoot = null;
+/**
+ * Finds the project root directory by looking for package.json
+ * @param maxDepth - Maximum directory levels to traverse upward
+ * @returns Project root directory path
+ * @throws Error if project root cannot be found
+ */
+export function findProjectRoot(maxDepth = FILE_SYSTEM.MAX_DIRECTORY_SEARCH_DEPTH) {
+    if (cachedProjectRoot) {
+        return cachedProjectRoot;
+    }
+    const currentDir = getCurrentModuleDir();
+    const root = locateProjectRoot(currentDir, maxDepth);
+    if (root) {
+        cachedProjectRoot = root;
+        return root;
+    }
+    throw new Error(`Project root not found within ${maxDepth} directory levels`);
+}
+/** Test helper — drops the cached project root so a fresh resolve happens. */
+export function __clearProjectRootCache() {
+    cachedProjectRoot = null;
+}
+/**
+ * Attempts to find the project root starting from the provided directory.
+ * @param startDir - Directory to begin the search from
+ * @param maxDepth - Maximum directory levels to traverse upward
+ * @returns The project root when found, otherwise `undefined`
+ */
+function locateProjectRoot(startDir, maxDepth = FILE_SYSTEM.MAX_DIRECTORY_SEARCH_DEPTH) {
+    let currentDir = startDir;
+    let depth = 0;
+    while (depth < maxDepth) {
+        if (isCorrectProjectRoot(currentDir)) {
+            return currentDir;
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            break; // Reached filesystem root
+        }
+        currentDir = parentDir;
+        depth++;
+    }
+    return undefined;
+}
+/**
+ * Checks if a directory contains the correct package.json for this project
+ */
+function isCorrectProjectRoot(dir) {
+    const packageJsonPath = path.join(dir, FILE_SYSTEM.PACKAGE_JSON_FILENAME);
+    if (!fs.existsSync(packageJsonPath)) {
+        return false;
+    }
+    try {
+        const packageContent = fs.readFileSync(packageJsonPath, 'utf8');
+        const packageData = JSON.parse(packageContent);
+        // Accept both this package name and the upstream name: test fixtures and
+        // future upstream merges share the same detection logic.
+        return (packageData.name === '@laylzj777/my-apple-apple-eventkit' ||
+            packageData.name === 'mcp-server-apple-events');
+    }
+    catch {
+        // Silently return false for any read/parse errors during project root discovery
+        // This allows the search to continue up the directory tree
+        return false;
+    }
+}
+/**
+ * Get the current module's directory
+ * Handles both production and test environments
+ */
+function getCurrentModuleDir() {
+    if (process.env.NODE_ENV === 'test') {
+        return path.join(process.cwd(), 'src', 'utils');
+    }
+    // In production, use import.meta.url
+    // This line is excluded from coverage due to Jest ESM limitations
+    /* istanbul ignore next */
+    return path.dirname(fileURLToPath(import.meta.url));
+}
+//# sourceMappingURL=projectUtils.js.map

package/dist/utils/projectUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectUtils.js","sourceRoot":"","sources":["../../src/utils/projectUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,6EAA6E;AAC7E,4EAA4E;AAC5E,sEAAsE;AACtE,IAAI,iBAAiB,GAAkB,IAAI,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAQ,GAAG,WAAW,CAAC,0BAA0B;IAEjD,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAErD,IAAI,IAAI,EAAE,CAAC;QACT,iBAAiB,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAQ,mBAAmB,CAAC,CAAC;AAChF,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,uBAAuB;IACrC,iBAAiB,GAAG,IAAI,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CACxB,QAAgB,EAChB,QAAQ,GAAG,WAAW,CAAC,0BAA0B;IAEjD,IAAI,UAAU,GAAG,QAAQ,CAAC;IAC1B,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,OAAO,KAAK,GAAG,QAAQ,EAAE,CAAC;QACxB,IAAI,oBAAoB,CAAC,UAAU,CAAC,EAAE,CAAC;YACrC,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,CAAC,0BAA0B;QACnC,CAAC;QAED,UAAU,GAAG,SAAS,CAAC;QACvB,KAAK,EAAE,CAAC;IACV,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,GAAW;IACvC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAC1E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;QAChE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC/C,yEAAyE;QACzE,yDAAyD;QACzD,OAAO,CACL,WAAW,CAAC,IAAI,KAAK,oCAAoC;YACzD,WAAW,CAAC,IAAI,KAAK,yBAAyB,CAC/C,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,gFAAgF;QAChF,2DAA2D;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB;IAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,qCAAqC;IACrC,kEAAkE;IAClE,0BAA0B;IAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/utils/reminderDateParser.d.ts

@@ -0,0 +1,8 @@
+/**
+ * reminderDateParser.ts
+ * Helper utilities for parsing reminder dueDate strings safely across timezones.
+ */
+/**
+ * Parses reminder dueDate strings into Date objects without losing local timezone semantics.
+ */
+export declare const parseReminderDueDate: (dueDate?: string | null) => Date | undefined;

package/dist/utils/reminderDateParser.js

@@ -0,0 +1,89 @@
+/**
+ * reminderDateParser.ts
+ * Helper utilities for parsing reminder dueDate strings safely across timezones.
+ */
+const DATE_ONLY_REGEX = /^(\d{4})-(\d{2})-(\d{2})$/;
+const DATE_ONLY_WITH_TZ_REGEX = /^(\d{4}-\d{2}-\d{2})(Z|[+-]\d{2}:?\d{2})$/i;
+const DATE_TIME_NO_TZ_REGEX = /^(\d{4})-(\d{2})-(\d{2})[ T]+(\d{2}):(\d{2})(?::(\d{2}))?(?:\.\d+)?$/;
+const TIMEZONE_SUFFIX_REGEX = /(Z|[+-]\d{2}(?::?\d{2})?)$/i;
+const toNumber = (value) => Number.parseInt(value, 10);
+const createLocalDate = (year, month, day, hour = 0, minute = 0, second = 0) => {
+    if ([year, month, day, hour, minute, second].some(Number.isNaN)) {
+        return undefined;
+    }
+    const date = new Date(year, month - 1, day, hour, minute, second, 0);
+    // Validate that the date wasn't auto-corrected by JavaScript
+    if (date.getFullYear() !== year ||
+        date.getMonth() !== month - 1 ||
+        date.getDate() !== day ||
+        date.getHours() !== hour ||
+        date.getMinutes() !== minute ||
+        date.getSeconds() !== second) {
+        return undefined;
+    }
+    return date;
+};
+const normalizeTimezoneSegment = (segment) => {
+    if (!segment)
+        return segment;
+    if (segment === 'Z' || segment === 'z')
+        return 'Z';
+    const clean = segment.replace(':', '').replace(' ', '');
+    if (clean.length === 3) {
+        return `${clean}:00`;
+    }
+    if (clean.length === 5) {
+        return `${clean.slice(0, 3)}:${clean.slice(3)}`;
+    }
+    return segment.includes(':')
+        ? segment
+        : `${segment.slice(0, 3)}:${segment.slice(3)}`;
+};
+const normalizeIsoString = (value) => {
+    let normalized = value.trim();
+    if (normalized.includes(' ') && normalized.indexOf(' ') === 10) {
+        normalized = `${normalized.slice(0, 10)}T${normalized.slice(11)}`;
+    }
+    normalized = normalized.replace(TIMEZONE_SUFFIX_REGEX, (match) => normalizeTimezoneSegment(match));
+    return normalized;
+};
+const parseWithNative = (value) => {
+    const normalized = normalizeIsoString(value);
+    const parsed = new Date(normalized);
+    return Number.isNaN(parsed.getTime()) ? undefined : parsed;
+};
+/**
+ * Parses reminder dueDate strings into Date objects without losing local timezone semantics.
+ */
+export const parseReminderDueDate = (dueDate) => {
+    if (!dueDate)
+        return undefined;
+    const trimmed = dueDate.trim();
+    if (!trimmed)
+        return undefined;
+    const dateOnlyMatch = trimmed.match(DATE_ONLY_REGEX);
+    if (dateOnlyMatch) {
+        // Groups 1-3 are mandatory in DATE_ONLY_REGEX, so they are always defined.
+        return createLocalDate(toNumber(dateOnlyMatch[1]), toNumber(dateOnlyMatch[2]), toNumber(dateOnlyMatch[3]));
+    }
+    const dateWithTzMatch = trimmed.match(DATE_ONLY_WITH_TZ_REGEX);
+    if (dateWithTzMatch) {
+        return parseWithNative(`${dateWithTzMatch[1]}T00:00:00${normalizeTimezoneSegment(dateWithTzMatch[2])}`);
+    }
+    const localDateTimeMatch = trimmed.match(DATE_TIME_NO_TZ_REGEX);
+    if (localDateTimeMatch) {
+        // Groups 1-5 are mandatory; group 6 (seconds) is optional.
+        const secondStr = localDateTimeMatch[6];
+        return createLocalDate(toNumber(localDateTimeMatch[1]), toNumber(localDateTimeMatch[2]), toNumber(localDateTimeMatch[3]), toNumber(localDateTimeMatch[4]), toNumber(localDateTimeMatch[5]), secondStr ? toNumber(secondStr) : 0);
+    }
+    if (TIMEZONE_SUFFIX_REGEX.test(trimmed)) {
+        return parseWithNative(trimmed);
+    }
+    // Reject strings that don't match expected date format patterns
+    // Valid formats should only contain: digits, hyphens, colons, spaces, T, Z, +, -, and dots
+    if (!/^[\d\-:T\s.Z+]+$/.test(trimmed)) {
+        return undefined;
+    }
+    return parseWithNative(trimmed);
+};
+//# sourceMappingURL=reminderDateParser.js.map

package/dist/utils/reminderDateParser.js.map

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

package/dist/utils/reminderRepository.d.ts

@@ -0,0 +1,33 @@
+/**
+ * reminderRepository.ts
+ * Repository for reminder data access via the vendored `event` CLI.
+ *
+ * Tags and subtasks are TS-managed in the notes field (`[#tag]` and
+ * `---SUBTASKS---` blocks); the `event --tags` / `--parentTitle` flags are
+ * not used so the AdvancedReminderEdit Shortcut is not required.
+ */
+import type { Reminder, ReminderList } from '../types/index.js';
+import type { CreateReminderData, IReminderRepository, ReminderJSON, UpdateReminderData } from '../types/repository.js';
+import type { ReminderFilters } from './dateFiltering.js';
+declare class ReminderRepository implements IReminderRepository {
+    private mapReminder;
+    private mapReminders;
+    private readAllRemindersIncludingCompleted;
+    findReminderById(id: string): Promise<Reminder>;
+    findReminders(filters?: ReminderFilters): Promise<Reminder[]>;
+    findAllLists(): Promise<ReminderList[]>;
+    createReminder(data: CreateReminderData): Promise<ReminderJSON>;
+    updateReminder(data: UpdateReminderData): Promise<ReminderJSON>;
+    deleteReminder(id: string): Promise<void>;
+    createReminderList(name: string): Promise<ReminderList>;
+    /**
+     * Resolves a list name to its EventKit identifier. `event reminders lists
+     * update|delete` are keyed by id, not name, so we have to round-trip
+     * through `lists list` whenever a caller targets a list by name.
+     */
+    private resolveListIdByName;
+    updateReminderList(currentName: string, newName: string): Promise<ReminderList>;
+    deleteReminderList(name: string): Promise<void>;
+}
+export declare const reminderRepository: ReminderRepository;
+export { ReminderRepository };

package/dist/utils/reminderRepository.js

@@ -0,0 +1,262 @@
+/**
+ * reminderRepository.ts
+ * Repository for reminder data access via the vendored `event` CLI.
+ *
+ * Tags and subtasks are TS-managed in the notes field (`[#tag]` and
+ * `---SUBTASKS---` blocks); the `event --tags` / `--parentTitle` flags are
+ * not used so the AdvancedReminderEdit Shortcut is not required.
+ */
+import { applyReminderFilters, prefilterReminderJsons, } from './dateFiltering.js';
+import { CliUserError } from './errorHandling.js';
+import { executeEventCliJson, executeEventCliPlain } from './eventCli.js';
+import { addOptionalArg, addOptionalNumberArg, nullToUndefined, } from './helpers.js';
+import { getSubtaskProgress, parseSubtasks } from './subtaskUtils.js';
+import { extractTags } from './tagUtils.js';
+const VALID_ALARM_TYPES = ['display', 'audio', 'procedure', 'email'];
+const isValidAlarmType = (value) => VALID_ALARM_TYPES.includes(value);
+const mapAlarmType = (alarmType) => alarmType && isValidAlarmType(alarmType) ? alarmType : undefined;
+/**
+ * `event` returns reminders without a top-level `locationTrigger` field —
+ * geofence triggers live inside the `alarms[].locationTrigger` shape. The
+ * downstream formatter / icon logic still keys off `reminder.locationTrigger`
+ * to render 📍, so derive the first alarm's location trigger here to preserve
+ * the existing read-side rendering. Alarms whose proximity is `'none'`
+ * (`EKAlarmProximityNone` — geofence configured but no fire condition) are
+ * skipped so they don't show up as misleading "Arriving at..." entries.
+ */
+const deriveTopLevelLocationTrigger = (alarms) => {
+    if (!alarms || alarms.length === 0)
+        return null;
+    for (const alarm of alarms) {
+        if (alarm?.locationTrigger && alarm.locationTrigger.proximity !== 'none') {
+            return alarm.locationTrigger;
+        }
+    }
+    return null;
+};
+// Maps the wire-level proximity union (event emits 'enter' / 'leave' / 'none')
+// onto the domain union ('enter' / 'leave'). 'none' returns undefined so the
+// caller can skip surfacing an unconfigured trigger.
+const mapProximity = (proximity) => proximity === 'leave' ? 'leave' : proximity === 'enter' ? 'enter' : undefined;
+const mapList = (list) => ({
+    id: list.id,
+    title: list.title,
+    color: list.color ?? undefined,
+});
+class ReminderRepository {
+    mapReminder(reminder) {
+        const normalizedReminder = nullToUndefined(reminder, [
+            'notes',
+            'url',
+            'dueDate',
+            'startDate',
+            'completionDate',
+            'location',
+            'timeZone',
+            'creationDate',
+            'lastModifiedDate',
+            'externalId',
+        ]);
+        const mapRecurrenceRule = (rule) => ({
+            frequency: rule.frequency,
+            interval: rule.interval ?? 1,
+            endDate: rule.endDate ?? undefined,
+            occurrenceCount: rule.occurrenceCount ?? undefined,
+            daysOfWeek: rule.daysOfWeek ?? undefined,
+            daysOfMonth: rule.daysOfMonth ?? undefined,
+            monthsOfYear: rule.monthsOfYear ?? undefined,
+        });
+        if (reminder.recurrenceRules && reminder.recurrenceRules.length > 0) {
+            normalizedReminder.recurrenceRules =
+                reminder.recurrenceRules.map(mapRecurrenceRule);
+        }
+        const derivedLocationTrigger = reminder.locationTrigger ??
+            deriveTopLevelLocationTrigger(reminder.alarms);
+        if (derivedLocationTrigger) {
+            const proximity = mapProximity(derivedLocationTrigger.proximity);
+            if (proximity) {
+                normalizedReminder.locationTrigger = {
+                    title: derivedLocationTrigger.title,
+                    latitude: derivedLocationTrigger.latitude,
+                    longitude: derivedLocationTrigger.longitude,
+                    radius: derivedLocationTrigger.radius,
+                    proximity,
+                };
+            }
+        }
+        if (reminder.alarms && reminder.alarms.length > 0) {
+            normalizedReminder.alarms = reminder.alarms
+                .filter((alarm) => alarm !== null)
+                .map((alarm) => {
+                const alarmProximity = alarm.locationTrigger
+                    ? mapProximity(alarm.locationTrigger.proximity)
+                    : undefined;
+                return {
+                    relativeOffset: alarm.relativeOffset ?? undefined,
+                    absoluteDate: alarm.absoluteDate ?? undefined,
+                    alarmType: mapAlarmType(alarm.alarmType),
+                    locationTrigger: alarm.locationTrigger && alarmProximity
+                        ? {
+                            title: alarm.locationTrigger.title,
+                            latitude: alarm.locationTrigger.latitude,
+                            longitude: alarm.locationTrigger.longitude,
+                            radius: alarm.locationTrigger.radius,
+                            proximity: alarmProximity,
+                        }
+                        : undefined,
+                };
+            });
+        }
+        const tags = extractTags(reminder.notes);
+        if (tags.length > 0) {
+            normalizedReminder.tags = tags;
+        }
+        const subtasks = parseSubtasks(reminder.notes);
+        if (subtasks.length > 0) {
+            normalizedReminder.subtasks = subtasks;
+            normalizedReminder.subtaskProgress = getSubtaskProgress(subtasks);
+        }
+        return normalizedReminder;
+    }
+    mapReminders(reminders) {
+        return reminders.map((reminder) => this.mapReminder(reminder));
+    }
+    // Reads every reminder (including completed) once so we can `.find` by id.
+    // `event reminders list` is the only event command that surfaces a reminder
+    // by id, since there's no equivalent of the old `read-by-id` action.
+    async readAllRemindersIncludingCompleted() {
+        return executeEventCliJson([
+            'reminders',
+            'list',
+            '--completed',
+            '--json',
+        ]);
+    }
+    async findReminderById(id) {
+        const all = await this.readAllRemindersIncludingCompleted();
+        const match = all.find((r) => r.id === id);
+        if (!match) {
+            throw new CliUserError(`Reminder with ID '${id}' not found.`);
+        }
+        return this.mapReminder(match);
+    }
+    async findReminders(filters = {}) {
+        const args = ['reminders', 'list'];
+        addOptionalArg(args, '--list', filters.list);
+        if (filters.showCompleted) {
+            args.push('--completed');
+        }
+        args.push('--json');
+        const reminders = await executeEventCliJson(args);
+        // Apply the cheap structural filters on raw JSON before `mapReminder`'s
+        // regex scans for tags / subtasks — important when the result set is
+        // large and the user wants a narrow slice (e.g. priority='high').
+        const preFiltered = prefilterReminderJsons(reminders, filters);
+        const normalized = this.mapReminders(preFiltered);
+        return applyReminderFilters(normalized, {
+            ...filters,
+            // `event` filters out completed reminders unless `--completed` is set;
+            // list filtering is done by event too. Priority/recurring/locationBased
+            // were already applied to JSON. Leave only search/dueWithin/tags for
+            // the post-map pass.
+            showCompleted: undefined,
+            list: undefined,
+            priority: undefined,
+            recurring: undefined,
+            locationBased: undefined,
+        });
+    }
+    async findAllLists() {
+        const lists = await executeEventCliJson([
+            'reminders',
+            'lists',
+            'list',
+            '--json',
+        ]);
+        return lists.map(mapList);
+    }
+    async createReminder(data) {
+        const args = ['reminders', 'create', '--title', data.title];
+        addOptionalArg(args, '--list', data.list);
+        addOptionalArg(args, '--notes', data.notes);
+        addOptionalArg(args, '--url', data.url);
+        addOptionalArg(args, '--due', data.dueDate);
+        addOptionalNumberArg(args, '--priority', data.priority);
+        // Skip the AdvancedReminderEdit Shortcut path — tags / subtasks live in
+        // the notes field (see tagUtils / subtaskUtils).
+        args.push('--no-shortcuts', '--json');
+        return executeEventCliJson(args);
+    }
+    async updateReminder(data) {
+        // Cross-list moves and `isCompleted: false` rejected by the handler so
+        // we share its `findReminderById` fetch with the notes-rebuild path.
+        const args = ['reminders', 'update', '--id', data.id];
+        addOptionalArg(args, '--title', data.newTitle);
+        addOptionalArg(args, '--notes', data.notes);
+        addOptionalArg(args, '--url', data.url);
+        addOptionalArg(args, '--due', data.dueDate);
+        addOptionalArg(args, '--start', data.startDate);
+        addOptionalNumberArg(args, '--priority', data.priority);
+        if (data.isCompleted !== undefined) {
+            args.push('--completed', data.isCompleted ? 'true' : 'false');
+        }
+        args.push('--no-shortcuts', '--json');
+        return executeEventCliJson(args);
+    }
+    async deleteReminder(id) {
+        // `event reminders delete` prints a status line ("Reminder deleted
+        // successfully") instead of JSON. Use the plain-text executor so we don't
+        // attempt to JSON.parse the success message.
+        await executeEventCliPlain(['reminders', 'delete', '--id', id]);
+    }
+    async createReminderList(name) {
+        const listJson = await executeEventCliJson([
+            'reminders',
+            'lists',
+            'create',
+            '--name',
+            name,
+            '--json',
+        ]);
+        return mapList(listJson);
+    }
+    /**
+     * Resolves a list name to its EventKit identifier. `event reminders lists
+     * update|delete` are keyed by id, not name, so we have to round-trip
+     * through `lists list` whenever a caller targets a list by name.
+     */
+    async resolveListIdByName(name) {
+        const lists = await executeEventCliJson([
+            'reminders',
+            'lists',
+            'list',
+            '--json',
+        ]);
+        const match = lists.find((list) => list.title === name);
+        if (!match) {
+            throw new CliUserError(`List '${name}' not found.`);
+        }
+        return match.id;
+    }
+    async updateReminderList(currentName, newName) {
+        const id = await this.resolveListIdByName(currentName);
+        const listJson = await executeEventCliJson([
+            'reminders',
+            'lists',
+            'update',
+            '--id',
+            id,
+            '--name',
+            newName,
+            '--json',
+        ]);
+        return mapList(listJson);
+    }
+    async deleteReminderList(name) {
+        const id = await this.resolveListIdByName(name);
+        await executeEventCliPlain(['reminders', 'lists', 'delete', '--id', id]);
+    }
+}
+export const reminderRepository = new ReminderRepository();
+export { ReminderRepository };
+//# sourceMappingURL=reminderRepository.js.map

package/dist/utils/reminderRepository.js.map

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

package/dist/utils/subtaskUtils.d.ts

@@ -0,0 +1,103 @@
+/**
+ * subtaskUtils.ts
+ * Utilities for handling subtasks stored in reminder notes
+ *
+ * Subtasks are stored in the notes field with a human-readable format:
+ * ---SUBTASKS---
+ * [ ] {id} Task title
+ * [x] {id} Completed task title
+ * ---END SUBTASKS---
+ *
+ * This format:
+ * - Is human-readable in the native Reminders app
+ * - Allows programmatic parsing and manipulation
+ * - Coexists with tags ([#tag] format) and user notes
+ */
+import type { Subtask, SubtaskProgress } from '../types/index.js';
+/**
+ * Generates a short unique ID (8 hex characters)
+ */
+export declare function generateSubtaskId(): string;
+/**
+ * Parses subtasks from notes content
+ * @param notes - The notes string that may contain subtasks
+ * @returns Array of subtasks in order
+ */
+export declare function parseSubtasks(notes: string | null | undefined): Subtask[];
+/**
+ * Serializes subtasks into the notes format
+ * @param subtasks - Array of subtasks to serialize
+ * @returns Formatted subtask section string (empty string if no subtasks)
+ */
+export declare function serializeSubtasks(subtasks: Subtask[]): string;
+/**
+ * Removes the subtask section from notes, returning clean content
+ * @param notes - The notes string with potential subtasks
+ * @returns Notes content without subtask section
+ */
+export declare function stripSubtasks(notes: string | null | undefined): string;
+/**
+ * Combines subtasks with notes content
+ * Tags are preserved and subtasks are appended at the end
+ * @param subtasks - Array of subtasks
+ * @param notes - Existing notes content (may have tags and/or existing subtasks)
+ * @returns Combined notes with subtasks appended
+ */
+export declare function combineSubtasksAndNotes(subtasks: Subtask[], notes: string | undefined): string;
+/**
+ * Adds a subtask to existing notes
+ * @param title - Title of the new subtask
+ * @param notes - Existing notes content
+ * @returns Updated notes with new subtask added
+ */
+export declare function addSubtask(title: string, notes: string | undefined): {
+    notes: string;
+    subtask: Subtask;
+};
+/**
+ * Updates a subtask in existing notes
+ * @param subtaskId - ID of the subtask to update
+ * @param updates - Partial subtask updates
+ * @param notes - Existing notes content
+ * @returns Updated notes with subtask modified
+ */
+export declare function updateSubtask(subtaskId: string, updates: {
+    title?: string;
+    isCompleted?: boolean;
+}, notes: string | undefined): string;
+/**
+ * Removes a subtask from existing notes
+ * @param subtaskId - ID of the subtask to remove
+ * @param notes - Existing notes content
+ * @returns Updated notes with subtask removed
+ */
+export declare function removeSubtask(subtaskId: string, notes: string | undefined): string;
+/**
+ * Toggles a subtask's completion status
+ * @param subtaskId - ID of the subtask to toggle
+ * @param notes - Existing notes content
+ * @returns Updated notes with subtask toggled
+ */
+export declare function toggleSubtask(subtaskId: string, notes: string | undefined): {
+    notes: string;
+    subtask: Subtask;
+};
+/**
+ * Reorders subtasks based on provided ID order
+ * @param order - Array of subtask IDs in desired order
+ * @param notes - Existing notes content
+ * @returns Updated notes with subtasks reordered
+ */
+export declare function reorderSubtasks(order: string[], notes: string | undefined): string;
+/**
+ * Creates subtasks from an array of titles
+ * @param titles - Array of subtask titles
+ * @returns Array of new subtasks
+ */
+export declare function createSubtasksFromTitles(titles: string[]): Subtask[];
+/**
+ * Calculates subtask completion progress
+ * @param subtasks - Array of subtasks
+ * @returns Progress object with completed count, total, and percentage
+ */
+export declare function getSubtaskProgress(subtasks: Subtask[]): SubtaskProgress;