@laylzj777/my-apple-apple-eventkit 1.1.0

package/dist/utils/dateFiltering.d.ts

@@ -0,0 +1,41 @@
+/**
+ * dateFiltering.ts
+ * Reusable utilities for filtering reminders by date criteria
+ */
+import type { Reminder } from '../types/index.js';
+import type { ReminderJSON } from '../types/repository.js';
+/**
+ * Date range filters for reminders
+ */
+export type DateFilter = 'today' | 'tomorrow' | 'this-week' | 'overdue' | 'no-date';
+/**
+ * Priority filter values (string names that map to EventKit integers)
+ */
+export type PriorityFilter = 'high' | 'medium' | 'low' | 'none';
+/**
+ * Filters for reminder search operations
+ */
+export interface ReminderFilters {
+    showCompleted?: boolean;
+    search?: string;
+    dueWithin?: DateFilter;
+    list?: string;
+    priority?: PriorityFilter;
+    recurring?: boolean;
+    locationBased?: boolean;
+    tags?: string[];
+}
+/**
+ * Narrows the raw `event` JSON response by the filter predicates that don't
+ * require `mapReminder`'s notes-field regex scans. Used by the repository to
+ * skip mapping reminders that the caller will discard anyway.
+ *
+ * Notes-dependent filters (tags, full-text search) and date-window filters
+ * stay in {@link applyReminderFilters} for now — date parsing per reminder is
+ * not free, and tag filtering needs the mapped form.
+ */
+export declare function prefilterReminderJsons(reminders: ReminderJSON[], filters: ReminderFilters): ReminderJSON[];
+/**
+ * Applies multiple filters to a list of reminders
+ */
+export declare function applyReminderFilters(reminders: Reminder[], filters: ReminderFilters): Reminder[];

package/dist/utils/dateFiltering.js

@@ -0,0 +1,129 @@
+/**
+ * dateFiltering.ts
+ * Reusable utilities for filtering reminders by date criteria
+ */
+import { getTodayStart, getTomorrowStart, getWeekEnd, getWeekStart, } from './dateUtils.js';
+import { parseReminderDueDate } from './reminderDateParser.js';
+import { hasAllTags } from './tagUtils.js';
+/**
+ * Creates standardized date boundaries for filtering operations
+ */
+function createDateBoundaries() {
+    const today = getTodayStart();
+    const tomorrow = getTomorrowStart();
+    const dayAfterTomorrow = getTomorrowStart();
+    dayAfterTomorrow.setDate(dayAfterTomorrow.getDate() + 1);
+    const weekStart = getWeekStart();
+    const weekEnd = getWeekEnd();
+    return { today, tomorrow, dayAfterTomorrow, weekStart, weekEnd };
+}
+/**
+ * Filters reminders based on due date criteria
+ */
+function filterRemindersByDate(reminders, filter) {
+    if (filter === 'no-date') {
+        return reminders.filter((reminder) => !reminder.dueDate);
+    }
+    const { today, tomorrow, dayAfterTomorrow, weekStart, weekEnd } = createDateBoundaries();
+    return reminders.filter((reminder) => {
+        if (!reminder.dueDate)
+            return false;
+        const dueDate = parseReminderDueDate(reminder.dueDate);
+        if (!dueDate)
+            return false;
+        switch (filter) {
+            case 'overdue':
+                return dueDate.getTime() < today.getTime();
+            case 'today':
+                return (dueDate.getTime() >= today.getTime() &&
+                    dueDate.getTime() < tomorrow.getTime());
+            case 'tomorrow':
+                return (dueDate.getTime() >= tomorrow.getTime() &&
+                    dueDate.getTime() < dayAfterTomorrow.getTime());
+            case 'this-week':
+                return (dueDate.getTime() >= weekStart.getTime() &&
+                    dueDate.getTime() < weekEnd.getTime());
+            default:
+                return true;
+        }
+    });
+}
+/**
+ * Maps priority filter strings to EventKit integer values
+ */
+const PRIORITY_FILTER_MAP = {
+    none: 0,
+    high: 1,
+    medium: 5,
+    low: 9,
+};
+/**
+ * Narrows the raw `event` JSON response by the filter predicates that don't
+ * require `mapReminder`'s notes-field regex scans. Used by the repository to
+ * skip mapping reminders that the caller will discard anyway.
+ *
+ * Notes-dependent filters (tags, full-text search) and date-window filters
+ * stay in {@link applyReminderFilters} for now — date parsing per reminder is
+ * not free, and tag filtering needs the mapped form.
+ */
+export function prefilterReminderJsons(reminders, filters) {
+    let result = reminders;
+    if (filters.priority) {
+        const target = PRIORITY_FILTER_MAP[filters.priority];
+        result = result.filter((reminder) => reminder.priority === target);
+    }
+    if (filters.recurring) {
+        result = result.filter((reminder) => (reminder.recurrenceRules?.length ?? 0) > 0);
+    }
+    if (filters.locationBased) {
+        result = result.filter((reminder) => reminder.locationTrigger != null ||
+            (reminder.alarms?.some((alarm) => alarm?.locationTrigger != null &&
+                alarm.locationTrigger.proximity !== 'none') ??
+                false));
+    }
+    return result;
+}
+/**
+ * Applies multiple filters to a list of reminders
+ */
+export function applyReminderFilters(reminders, filters) {
+    let filteredReminders = [...reminders];
+    // Filter by completion status
+    if (filters.showCompleted !== undefined) {
+        filteredReminders = filteredReminders.filter((reminder) => filters.showCompleted || !reminder.isCompleted);
+    }
+    // Filter by list
+    if (filters.list) {
+        filteredReminders = filteredReminders.filter((reminder) => reminder.list === filters.list);
+    }
+    // Filter by search term
+    if (filters.search) {
+        const searchLower = filters.search.toLowerCase();
+        filteredReminders = filteredReminders.filter((reminder) => reminder.title.toLowerCase().includes(searchLower) ||
+            reminder.notes?.toLowerCase().includes(searchLower));
+    }
+    // Filter by due date
+    if (filters.dueWithin) {
+        filteredReminders = filterRemindersByDate(filteredReminders, filters.dueWithin);
+    }
+    // Filter by priority
+    if (filters.priority) {
+        const priorityValue = PRIORITY_FILTER_MAP[filters.priority];
+        filteredReminders = filteredReminders.filter((reminder) => reminder.priority === priorityValue);
+    }
+    // Filter by recurring status
+    if (filters.recurring !== undefined && filters.recurring) {
+        filteredReminders = filteredReminders.filter((reminder) => (reminder.recurrenceRules?.length ?? 0) > 0);
+    }
+    // Filter by location-based status
+    if (filters.locationBased !== undefined && filters.locationBased) {
+        filteredReminders = filteredReminders.filter((reminder) => reminder.locationTrigger !== undefined);
+    }
+    // Filter by tags (must have ALL specified tags)
+    if (filters.tags && filters.tags.length > 0) {
+        const { tags } = filters;
+        filteredReminders = filteredReminders.filter((reminder) => hasAllTags(reminder.tags, tags));
+    }
+    return filteredReminders;
+}
+//# sourceMappingURL=dateFiltering.js.map

package/dist/utils/dateFiltering.js.map

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

package/dist/utils/dateUtils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * dateUtils.ts
+ * Shared date calculation utilities
+ */
+/**
+ * Creates a date object representing the start of today (midnight)
+ */
+export declare function getTodayStart(): Date;
+/**
+ * Creates a date object representing the start of tomorrow (midnight)
+ */
+export declare function getTomorrowStart(): Date;
+/**
+ * Creates a date object representing the start of the current calendar week.
+ * Uses Intl.Locale.weekInfo for locale-aware week start when available.
+ * Falls back to Sunday for environments without Intl.Locale support.
+ */
+export declare function getWeekStart(): Date;
+/**
+ * Creates a date object representing the end of the current calendar week
+ * (start of next week). Matches Swift's Calendar.current.dateInterval(of: .weekOfYear).
+ */
+export declare function getWeekEnd(): Date;
+/**
+ * Creates a date object representing the start of a specific date (midnight)
+ */
+export declare function getDateStart(date: Date): Date;

package/dist/utils/dateUtils.js

@@ -0,0 +1,71 @@
+/**
+ * dateUtils.ts
+ * Shared date calculation utilities
+ */
+/**
+ * Creates a date object representing the start of today (midnight)
+ */
+export function getTodayStart() {
+    const now = new Date();
+    return new Date(now.getFullYear(), now.getMonth(), now.getDate());
+}
+/**
+ * Creates a date object representing the start of tomorrow (midnight)
+ */
+export function getTomorrowStart() {
+    const today = getTodayStart();
+    const tomorrow = new Date(today);
+    tomorrow.setDate(tomorrow.getDate() + 1);
+    return tomorrow;
+}
+/**
+ * Gets the first day of the week for the current locale using Intl.Locale API.
+ * @returns 0-6 where 0=Sunday, 1=Monday, ..., 6=Saturday
+ */
+function getLocaleFirstDay() {
+    try {
+        // Get the default locale from the system
+        const defaultLocale = Intl.DateTimeFormat().resolvedOptions().locale || 'en-US';
+        const locale = new Intl.Locale(defaultLocale);
+        const weekInfo = locale.weekInfo;
+        if (weekInfo?.firstDay !== undefined) {
+            // Intl returns 1-7 where 1=Monday, 7=Sunday
+            // Convert to JS format 0-6 where 0=Sunday
+            return weekInfo.firstDay === 7 ? 0 : weekInfo.firstDay;
+        }
+    }
+    catch {
+        // Fallback to Sunday if Intl.Locale is unavailable
+    }
+    return 0; // Default: Sunday
+}
+/**
+ * Creates a date object representing the start of the current calendar week.
+ * Uses Intl.Locale.weekInfo for locale-aware week start when available.
+ * Falls back to Sunday for environments without Intl.Locale support.
+ */
+export function getWeekStart() {
+    const today = getTodayStart();
+    const dayOfWeek = today.getDay(); // 0=Sunday, 6=Saturday
+    const firstDay = getLocaleFirstDay();
+    const weekStart = new Date(today);
+    weekStart.setDate(today.getDate() - ((dayOfWeek - firstDay + 7) % 7));
+    return weekStart;
+}
+/**
+ * Creates a date object representing the end of the current calendar week
+ * (start of next week). Matches Swift's Calendar.current.dateInterval(of: .weekOfYear).
+ */
+export function getWeekEnd() {
+    const weekStart = getWeekStart();
+    const weekEnd = new Date(weekStart);
+    weekEnd.setDate(weekStart.getDate() + 7);
+    return weekEnd;
+}
+/**
+ * Creates a date object representing the start of a specific date (midnight)
+ */
+export function getDateStart(date) {
+    return new Date(date.getFullYear(), date.getMonth(), date.getDate());
+}
+//# sourceMappingURL=dateUtils.js.map

package/dist/utils/dateUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateUtils.js","sourceRoot":"","sources":["../../src/utils/dateUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IACzC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,yCAAyC;QACzC,MAAM,aAAa,GACjB,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,MAAM,IAAI,OAAO,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAC9C,MAAM,QAAQ,GACZ,MACD,CAAC,QAAQ,CAAC;QACX,IAAI,QAAQ,EAAE,QAAQ,KAAK,SAAS,EAAE,CAAC;YACrC,4CAA4C;YAC5C,0CAA0C;YAC1C,OAAO,QAAQ,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACzD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;IACrD,CAAC;IACD,OAAO,CAAC,CAAC,CAAC,kBAAkB;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,uBAAuB;IACzD,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,SAAS,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACtE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;IACpC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IACzC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/dist/utils/errorHandling.d.ts

@@ -0,0 +1,27 @@
+/**
+ * errorHandling.ts
+ * Centralized error handling utilities for consistent error responses
+ */
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Custom error class for user-facing CLI failures (e.g., not found, invalid
+ * input). Lives in this leaf module so it's importable from both repository
+ * and handler layers without circular imports.
+ */
+export declare class CliUserError extends Error {
+    constructor(message: string);
+}
+/**
+ * Determines if the application is running in development mode.
+ * Development mode is enabled when:
+ * - NODE_ENV is set to 'development', OR
+ * - DEBUG environment variable is set to any truthy value
+ *
+ * This allows detailed error messages to be shown in development
+ * while keeping production error messages generic for security.
+ */
+export declare function isDevelopmentMode(): boolean;
+/**
+ * Utility for handling async operations with consistent error handling
+ */
+export declare function handleAsyncOperation(operation: () => Promise<string>, operationName: string): Promise<CallToolResult>;

package/dist/utils/errorHandling.js

@@ -0,0 +1,88 @@
+/**
+ * errorHandling.ts
+ * Centralized error handling utilities for consistent error responses
+ */
+import { ValidationError } from '../validation/schemas.js';
+const USER_ACTIONABLE_PERMISSION_PATTERNS = [
+    /permission denied/i,
+    /permission is write-only/i,
+    /access denied/i,
+    /not authorized.*(calendar|reminders)/i,
+    /System Settings > Privacy & Security/i,
+    /full calendar access/i,
+    /full reminder access/i,
+    // The disclaim shim's own spawn failures (`event-disclaim: …`) are
+    // classified upstream in eventCli.ts as CliUserError; no broad
+    // subprocess/responsible-process patterns here — they would leak
+    // unrelated internal errors past production sanitization.
+];
+function isUserActionablePermissionError(message) {
+    return USER_ACTIONABLE_PERMISSION_PATTERNS.some((pattern) => pattern.test(message));
+}
+/**
+ * Custom error class for user-facing CLI failures (e.g., not found, invalid
+ * input). Lives in this leaf module so it's importable from both repository
+ * and handler layers without circular imports.
+ */
+export class CliUserError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CliUserError';
+    }
+}
+/**
+ * Determines if the application is running in development mode.
+ * Development mode is enabled when:
+ * - NODE_ENV is set to 'development', OR
+ * - DEBUG environment variable is set to any truthy value
+ *
+ * This allows detailed error messages to be shown in development
+ * while keeping production error messages generic for security.
+ */
+export function isDevelopmentMode() {
+    return (process.env.NODE_ENV === 'development' ||
+        (!!process.env.DEBUG && process.env.DEBUG !== ''));
+}
+/**
+ * Creates a descriptive error message, showing validation details in dev mode.
+ */
+function createErrorMessage(operation, error) {
+    const message = error instanceof Error ? error.message : 'System error occurred';
+    const isDev = isDevelopmentMode();
+    // For validation and CLI user errors, always return the detailed message.
+    if (error instanceof ValidationError || error instanceof CliUserError) {
+        return message;
+    }
+    // Permission failures are user-actionable and should stay visible in production.
+    if (isUserActionablePermissionError(message)) {
+        return `Failed to ${operation}: ${message}`;
+    }
+    // For other errors, be generic in production.
+    return isDev
+        ? `Failed to ${operation}: ${message}`
+        : `Failed to ${operation}: System error occurred`;
+}
+/**
+ * Utility for handling async operations with consistent error handling
+ */
+export async function handleAsyncOperation(operation, operationName) {
+    try {
+        const result = await operation();
+        return {
+            content: [{ type: 'text', text: result }],
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: createErrorMessage(operationName, error),
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=errorHandling.js.map

package/dist/utils/errorHandling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandling.js","sourceRoot":"","sources":["../../src/utils/errorHandling.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,mCAAmC,GAAG;IAC1C,oBAAoB;IACpB,2BAA2B;IAC3B,gBAAgB;IAChB,uCAAuC;IACvC,uCAAuC;IACvC,uBAAuB;IACvB,uBAAuB;IACvB,mEAAmE;IACnE,+DAA+D;IAC/D,iEAAiE;IACjE,0DAA0D;CAClD,CAAC;AAEX,SAAS,+BAA+B,CAAC,OAAe;IACtD,OAAO,mCAAmC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAC1D,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CACtB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;QACtC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAClD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,SAAiB,EAAE,KAAc;IAC3D,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC;IACnE,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;IAElC,0EAA0E;IAC1E,IAAI,KAAK,YAAY,eAAe,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QACtE,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,iFAAiF;IACjF,IAAI,+BAA+B,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,OAAO,aAAa,SAAS,KAAK,OAAO,EAAE,CAAC;IAC9C,CAAC;IAED,8CAA8C;IAC9C,OAAO,KAAK;QACV,CAAC,CAAC,aAAa,SAAS,KAAK,OAAO,EAAE;QACtC,CAAC,CAAC,aAAa,SAAS,yBAAyB,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAgC,EAChC,aAAqB;IAErB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YACzC,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kBAAkB,CAAC,aAAa,EAAE,KAAK,CAAC;iBAC/C;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/utils/eventCli.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview `event` CLI execution wrapper
+ * @module utils/eventCli
+ * @description Spawns the vendored `event` Swift binary (FradSer/event) and
+ * translates its stdout / stderr / exit code into JSON results, plain-text
+ * results, or domain-specific errors. `event` outputs raw JSON to stdout and
+ * writes `Error: <message>` to stderr with a non-zero exit code on failure.
+ */
+/** Clears the cached binary path (for testing). */
+export declare function clearEventBinaryPathCache(): void;
+export type PermissionDomain = 'reminders' | 'calendars';
+/** Custom error class for permission-related failures from the `event` CLI. */
+export declare class CliPermissionError extends Error {
+    readonly domain: PermissionDomain;
+    constructor(message: string, domain: PermissionDomain);
+}
+/**
+ * Executes the `event` binary and parses its stdout as raw JSON.
+ *
+ * @template T - Expected JSON type emitted by `event`
+ * @param args - Full argv (including subcommand and `--json` where supported)
+ * @returns Parsed JSON value
+ * @throws {CliPermissionError} on EventKit permission failure (domain-typed)
+ * @throws {CliUserError} on application errors surfaced by `event` (Not found,
+ *   Invalid input, ArgumentParser usage errors)
+ * @throws {Error} when stdout is empty or unparseable
+ *
+ * @security
+ * - Uses `execFile` (not `exec`) so shell metacharacters in argv are inert.
+ * - Argv is passed as an array; each token is delivered to the binary verbatim
+ *   via `execve()`, preventing argument-boundary injection.
+ * - Binary path is validated against an allowlist tied to the project root.
+ */
+export declare function executeEventCliJson<T>(args: string[]): Promise<T>;
+/**
+ * Executes the `event` binary and returns its trimmed stdout as plain text.
+ * Used for commands that emit a success message instead of JSON (e.g.
+ * `event reminders delete` returns "Reminder deleted successfully").
+ */
+export declare function executeEventCliPlain(args: string[]): Promise<string>;