@laylzj777/my-apple-apple-eventkit 1.1.0

package/dist/utils/eventCli.js

@@ -0,0 +1,294 @@
+/**
+ * @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.
+ */
+import { execFile } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { findSecureBinaryPath, getEnvironmentBinaryConfig, } from './binaryValidator.js';
+import { FILE_SYSTEM } from './constants.js';
+import { CliUserError } from './errorHandling.js';
+import { bufferToString } from './helpers.js';
+import { findProjectRoot } from './projectUtils.js';
+// A no-shim launch is cached too (`disclaimFingerprint: null`) and stays
+// valid only while the shim's canonical path remains absent — so a shim that
+// appears after a rebuild is picked up on the next call, and the no-shim
+// path doesn't re-run full validation (which hashes the ~50 MB binary when
+// SWIFT_BINARY_HASH is pinned) on every tool call.
+let cachedLaunch = null;
+// Emitted once per process so a missing/invalid shim (which silently reverts
+// EventKit prompts to host-app attribution — the issue #93 failure mode) is
+// diagnosable from the host's MCP server logs.
+let warnedShimUnavailable = false;
+/**
+ * Selects how EventKit permission prompts are attributed, via the
+ * `EVENT_TCC_ATTRIBUTION` env var (case-insensitive):
+ *
+ * - `self` (default): spawn `event` through the `event-disclaim` shim so it
+ *   becomes its own TCC-responsible process. The macOS prompt then shows the
+ *   name embedded in `event`'s signed Info.plist (`CFBundleName`), independent
+ *   of which app launched the MCP server, and one grant covers every host.
+ * - `host`: bypass the shim and spawn `event` directly. macOS attributes the
+ *   prompt to the *host* application that launched the server (e.g. the MCP
+ *   client), so the dialog dynamically shows the current host app's name.
+ *   Requires the host app to declare the relevant EventKit usage strings.
+ *
+ * Any unrecognized value falls back to `self`.
+ */
+function useHostAttribution() {
+    return ((process.env.EVENT_TCC_ATTRIBUTION ?? '').trim().toLowerCase() === 'host');
+}
+/** Clears the cached binary path (for testing). */
+export function clearEventBinaryPathCache() {
+    cachedLaunch = null;
+    warnedShimUnavailable = false;
+}
+const fingerprintFor = (filePath) => {
+    try {
+        const stat = fs.statSync(filePath);
+        return { ino: stat.ino, mtimeMs: stat.mtimeMs, size: stat.size };
+    }
+    catch {
+        return null;
+    }
+};
+const fingerprintMatches = (a, b) => a !== null &&
+    b !== null &&
+    a.ino === b.ino &&
+    a.mtimeMs === b.mtimeMs &&
+    a.size === b.size;
+const execFilePromise = (cliPath, args) => new Promise((resolve) => {
+    execFile(cliPath, args, { maxBuffer: 10 * 1024 * 1024 }, (error, stdout, stderr) => {
+        // Hand both branches to the caller so it can decide based on stderr
+        // content rather than the exit code alone — `event` emits structured
+        // EventCLIError messages on stderr regardless of which exit code path
+        // ArgumentParser chose (1 for app errors, 64 for usage errors).
+        resolve({ result: { stdout, stderr }, error: error ?? null });
+    });
+});
+/**
+ * Detects an `event` permission error and which EventKit domain it belongs to.
+ *
+ * `event`'s error format is `Error: Permission denied: <domain-specific text>`
+ * where the domain word ("Reminders" / "Reminder" or "Calendar"/"Calendars")
+ * always appears in the second half of the message. We match anchored on the
+ * "Permission denied" prefix so we never misclassify the unrelated phrase
+ * "permission" used in normal output.
+ */
+// An ordered array (not a `Record`) because iteration order matters: a
+// defensive message that names both domains is attributed to whichever
+// pattern appears first here, and `Record`/`Object.entries` iteration order
+// isn't guaranteed by the type system even though it happens to match
+// insertion order at runtime.
+const PERMISSION_DOMAIN_PATTERNS = [
+    ['reminders', /Permission denied:[\s\S]*?reminders?/i],
+    ['calendars', /Permission denied:[\s\S]*?calendars?/i],
+];
+function detectPermissionDomain(message) {
+    for (const [domain, pattern] of PERMISSION_DOMAIN_PATTERNS) {
+        if (pattern.test(message)) {
+            return domain;
+        }
+    }
+    return null;
+}
+/** Custom error class for permission-related failures from the `event` CLI. */
+export class CliPermissionError extends Error {
+    constructor(message, domain) {
+        super(message);
+        this.domain = domain;
+        this.name = 'CliPermissionError';
+    }
+}
+/**
+ * Pulls the meaningful message out of `event`'s stderr. ArgumentParser prepends
+ * `Error: ` to every EventCLIError and to its own usage errors, so we strip
+ * that and trim trailing whitespace. The boolean signals whether the stderr
+ * looked like a structured event-emitted error or some other failure mode.
+ */
+function extractStderrMessage(stderr) {
+    const trimmed = stderr.replace(/\r?\n/g, '\n').trim();
+    if (!trimmed)
+        return { message: '', hadErrorPrefix: false };
+    if (trimmed.startsWith('Error: ')) {
+        return {
+            message: trimmed.slice('Error: '.length),
+            hadErrorPrefix: true,
+        };
+    }
+    return { message: trimmed, hadErrorPrefix: false };
+}
+function throwForStderr(stderr) {
+    const { message, hadErrorPrefix } = extractStderrMessage(stderr);
+    if (!message) {
+        throw new Error('event execution failed: unknown error');
+    }
+    // The disclaim shim reports its own spawn failures as
+    // `event-disclaim: <detail>` (no "Error: " prefix). Surface them verbatim
+    // as user-actionable errors — otherwise production error formatting
+    // collapses them into a generic "System error occurred".
+    if (message.startsWith('event-disclaim:')) {
+        throw new CliUserError(message);
+    }
+    // Only structured "Error: ..." stderr is treated as a user-actionable
+    // CliUserError or permission error. Anything else (panics, OS-level
+    // failures, etc.) is wrapped so the host surface mentions the `event`
+    // binary instead of attributing the message to our own code.
+    if (!hadErrorPrefix) {
+        throw new Error(`event execution failed: ${message}`);
+    }
+    const domain = detectPermissionDomain(message);
+    if (domain) {
+        throw new CliPermissionError(message, domain);
+    }
+    throw new CliUserError(message);
+}
+async function runEventCli(launch, args) {
+    // Route through the disclaim shim when it exists: `event-disclaim <event>
+    // <args…>` re-execs `event` with TCC responsibility disclaimed.
+    const file = launch.disclaimPath ?? launch.cliPath;
+    const argv = launch.disclaimPath ? [launch.cliPath, ...args] : args;
+    const { result, error } = await execFilePromise(file, argv);
+    const stderr = bufferToString(result.stderr) ?? '';
+    if (error) {
+        if (stderr) {
+            throwForStderr(stderr);
+        }
+        const msg = error.message || String(error);
+        throw new Error(`event execution failed: ${msg}`);
+    }
+    return result;
+}
+function resolveLaunchOrThrow() {
+    const hostAttribution = useHostAttribution();
+    if (cachedLaunch && cachedLaunch.hostAttribution === hostAttribution) {
+        const { launch } = cachedLaunch;
+        const cliOk = fingerprintMatches(cachedLaunch.cliFingerprint, fingerprintFor(launch.cliPath));
+        const disclaimOk = launch.disclaimPath
+            ? fingerprintMatches(cachedLaunch.disclaimFingerprint, fingerprintFor(launch.disclaimPath))
+            : fingerprintFor(cachedLaunch.disclaimCanonicalPath) === null;
+        if (cliOk && disclaimOk) {
+            return launch;
+        }
+    }
+    cachedLaunch = null;
+    const projectRoot = findProjectRoot();
+    const binaryName = FILE_SYSTEM.SWIFT_BINARY_NAME;
+    const canonicalPath = path.join(projectRoot, 'bin', binaryName);
+    // Restrict the validator's suffix matcher to this one absolute path so a
+    // misconfigured allowlist can't accept `/usr/local/bin/event` or any other
+    // `bin/event` on disk by accident.
+    const config = {
+        ...getEnvironmentBinaryConfig(),
+        allowedPaths: [canonicalPath],
+    };
+    const { path: cliPath } = findSecureBinaryPath([canonicalPath], config);
+    if (!cliPath) {
+        throw new CliUserError(`event CLI binary not found at ${canonicalPath}.
+
+The vendored \`event\` Swift binary is normally built automatically by the
+postinstall script, but that step may have been skipped or failed (for example
+when the package was installed without devDependencies, on a non-macOS host,
+or before Xcode Command Line Tools were available).
+
+To build it manually, clone the repository and run a local build:
+   git clone --recurse-submodules https://github.com/fradser/mcp-server-apple-events.git
+   cd mcp-server-apple-events
+   pnpm install
+   pnpm build
+
+Then use the local path in your Claude Desktop config:
+   "command": "node",
+   "args": ["/absolute/path/to/mcp-server-apple-events/bin/run.cjs"]`);
+    }
+    const disclaimCanonicalPath = path.join(projectRoot, 'bin', FILE_SYSTEM.DISCLAIM_BINARY_NAME);
+    // Host-attribution mode intentionally bypasses the disclaim shim: spawning
+    // `event` directly lets macOS attribute the EventKit prompt to the host app
+    // that launched the MCP server, so the dialog shows that app's name.
+    let disclaimPath = null;
+    if (!hostAttribution) {
+        ({ path: disclaimPath } = findSecureBinaryPath([disclaimCanonicalPath], {
+            ...getEnvironmentBinaryConfig(),
+            // SWIFT_BINARY_HASH pins bin/event, not the shim — carrying it over here
+            // would reject the shim on every strict-mode install and silently revert
+            // to host-attributed prompts. The shim gets its own optional pin.
+            expectedHash: process.env.SWIFT_DISCLAIM_BINARY_HASH,
+            allowedPaths: [disclaimCanonicalPath],
+        }));
+        if (!disclaimPath &&
+            !warnedShimUnavailable &&
+            process.env.NODE_ENV !== 'test') {
+            warnedShimUnavailable = true;
+            console.error(`event-disclaim shim not found or failed validation at ${disclaimCanonicalPath}; ` +
+                'spawning event directly. EventKit permission prompts will be attributed ' +
+                'to the host app instead of event (issue #93). Rebuild with `pnpm build` ' +
+                'to restore the shim.');
+        }
+    }
+    const launch = { cliPath, disclaimPath };
+    const cliFingerprint = fingerprintFor(cliPath);
+    const disclaimFingerprint = disclaimPath
+        ? fingerprintFor(disclaimPath)
+        : null;
+    // A shim that resolved but vanished before fingerprinting (race) leaves
+    // disclaimFingerprint null with disclaimPath set — don't cache that; the
+    // next call re-resolves.
+    if (cliFingerprint && (disclaimPath === null || disclaimFingerprint)) {
+        cachedLaunch = {
+            launch,
+            disclaimCanonicalPath,
+            cliFingerprint,
+            disclaimFingerprint,
+            hostAttribution,
+        };
+    }
+    return launch;
+}
+/**
+ * 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 async function executeEventCliJson(args) {
+    const launch = resolveLaunchOrThrow();
+    const { stdout } = await runEventCli(launch, args);
+    const normalized = bufferToString(stdout);
+    if (!normalized) {
+        throw new Error('event execution failed: Empty CLI output');
+    }
+    try {
+        return JSON.parse(normalized);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`event execution failed: Invalid CLI output - ${detail}`);
+    }
+}
+/**
+ * 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 async function executeEventCliPlain(args) {
+    const launch = resolveLaunchOrThrow();
+    const { stdout } = await runEventCli(launch, args);
+    const normalized = bufferToString(stdout) ?? '';
+    return normalized.trim();
+}
+//# sourceMappingURL=eventCli.js.map

package/dist/utils/eventCli.js.map

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

package/dist/utils/helpers.d.ts

@@ -0,0 +1,35 @@
+/**
+ * helpers.ts
+ * General utility functions for common operations
+ */
+/**
+ * CLI argument building utilities
+ */
+/**
+ * Adds an optional string argument to the args array if the value is defined
+ */
+export declare function addOptionalArg(args: string[], flag: string, value: string | undefined): void;
+/**
+ * Adds an optional number argument to the args array if the value is defined
+ */
+export declare function addOptionalNumberArg(args: string[], flag: string, value: number | undefined): void;
+/**
+ * Type conversion utilities
+ */
+/**
+ * Converts null values to undefined for optional fields
+ * This is useful when converting from JSON (which uses null) to TypeScript types (which use undefined)
+ */
+export declare function nullToUndefined<T>(obj: T, fields: (keyof T)[]): T;
+/**
+ * String manipulation utilities
+ */
+/**
+ * Converts Buffer or string data to string, handling null/undefined values
+ */
+export declare function bufferToString(data?: string | Buffer | null): string | null;
+/**
+ * Formats multiline notes for markdown display by indenting continuation lines
+ * Replaces newlines with newline + indentation to maintain proper formatting
+ */
+export declare function formatMultilineNotes(notes: string): string;

package/dist/utils/helpers.js

@@ -0,0 +1,61 @@
+/**
+ * helpers.ts
+ * General utility functions for common operations
+ */
+/**
+ * CLI argument building utilities
+ */
+/**
+ * Adds an optional string argument to the args array if the value is defined
+ */
+export function addOptionalArg(args, flag, value) {
+    if (value !== undefined) {
+        args.push(flag, value);
+    }
+}
+/**
+ * Adds an optional number argument to the args array if the value is defined
+ */
+export function addOptionalNumberArg(args, flag, value) {
+    if (value !== undefined) {
+        args.push(flag, String(value));
+    }
+}
+/**
+ * Type conversion utilities
+ */
+/**
+ * Converts null values to undefined for optional fields
+ * This is useful when converting from JSON (which uses null) to TypeScript types (which use undefined)
+ */
+export function nullToUndefined(obj, fields) {
+    const result = { ...obj };
+    for (const field of fields) {
+        const fieldKey = String(field);
+        if (result[fieldKey] === null) {
+            result[fieldKey] = undefined;
+        }
+    }
+    return result;
+}
+/**
+ * String manipulation utilities
+ */
+/**
+ * Converts Buffer or string data to string, handling null/undefined values
+ */
+export function bufferToString(data) {
+    if (typeof data === 'string')
+        return data;
+    if (Buffer.isBuffer(data))
+        return data.toString('utf8');
+    return data ?? null;
+}
+/**
+ * Formats multiline notes for markdown display by indenting continuation lines
+ * Replaces newlines with newline + indentation to maintain proper formatting
+ */
+export function formatMultilineNotes(notes) {
+    return notes.replace(/\n/g, '\n    ');
+}
+//# sourceMappingURL=helpers.js.map

package/dist/utils/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAc,EACd,IAAY,EACZ,KAAyB;IAEzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAc,EACd,IAAY,EACZ,KAAyB;IAEzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAI,GAAM,EAAE,MAAmB;IAC5D,MAAM,MAAM,GAAG,EAAE,GAAG,GAAG,EAA6B,CAAC;IACrD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9B,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,MAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAA6B;IAC1D,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxD,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AACxC,CAAC"}

package/dist/utils/looseDateParser.d.ts

@@ -0,0 +1,19 @@
+/**
+ * looseDateParser.ts
+ * 宽容日期输入归一化（fork 增量）。
+ *
+ * 上游 schema 只接受 'YYYY-MM-DD'、'YYYY-MM-DD HH:mm:ss'、ISO 8601。实际会话里模型
+ * （尤其从旧日历 MCP 的工具习惯迁移过来时）还会给出英文自然语言（"15 March 2025 at
+ * 2:00 PM"）或中文日期（"2026年7月11日 下午2点"）。旧包对这类输入把时刻静默归零，
+ * 事件落在 00:00——本模块在 zod 校验前把这些写法归一成严格格式，归一不了的原样
+ * 返回，让 zod 用统一的格式报错引导模型改写。
+ *
+ * 归一始终产出**本地时间**（'YYYY-MM-DD[ HH:mm:ss]'）；已符合严格格式的输入
+ * （含带时区的 ISO）原样透传，不做二次加工。
+ */
+export declare const STRICT_DATE_PATTERN: RegExp;
+/**
+ * 归一化宽松日期输入。返回严格格式字符串；无法归一时返回 trim 后的原输入
+ * （由下游 zod 统一报格式错误）。
+ */
+export declare function normalizeLooseDateInput(raw: string): string;

package/dist/utils/looseDateParser.js

@@ -0,0 +1,149 @@
+/**
+ * looseDateParser.ts
+ * 宽容日期输入归一化（fork 增量）。
+ *
+ * 上游 schema 只接受 'YYYY-MM-DD'、'YYYY-MM-DD HH:mm:ss'、ISO 8601。实际会话里模型
+ * （尤其从旧日历 MCP 的工具习惯迁移过来时）还会给出英文自然语言（"15 March 2025 at
+ * 2:00 PM"）或中文日期（"2026年7月11日 下午2点"）。旧包对这类输入把时刻静默归零，
+ * 事件落在 00:00——本模块在 zod 校验前把这些写法归一成严格格式，归一不了的原样
+ * 返回，让 zod 用统一的格式报错引导模型改写。
+ *
+ * 归一始终产出**本地时间**（'YYYY-MM-DD[ HH:mm:ss]'）；已符合严格格式的输入
+ * （含带时区的 ISO）原样透传，不做二次加工。
+ */
+// 与 validation/schemas.ts 的 DATE_PATTERN 保持一致（schemas.ts 从这里导入，单一真源）。
+export const STRICT_DATE_PATTERN = /^(\d{4})-(\d{2})-(\d{2})(?:[ T](\d{2}):(\d{2})(?::(\d{2}))?(?:\.\d{1,9})?(?:Z|[+-]\d{2}:?\d{2})?)?$/;
+const ENGLISH_WEEKDAY_PREFIX = /^(?:monday|tuesday|wednesday|thursday|friday|saturday|sunday),?\s+/i;
+const pad = (n) => String(n).padStart(2, '0');
+/** 中文时段词 → 是否按 PM 语义换算（凌晨/早上/上午按 AM）。 */
+const CHINESE_PM_WORDS = new Set(['下午', '晚上', '傍晚', '中午']);
+function applyMeridiem(hour, isPm) {
+    if (isPm && hour < 12)
+        return hour + 12;
+    if (!isPm && hour === 12)
+        return 0;
+    return hour;
+}
+/**
+ * 从字符串里抽取时刻。按可信度顺序尝试：
+ *  1. 英文 "at 2:00 PM" / "at 14:00" / "at 2 PM"
+ *  2. 中文 "下午2点" / "下午2:30" / "14点30分" / "14点"
+ *  3. 裸 "HH:mm(:ss)"（AM/PM 可选）
+ */
+function extractTime(input) {
+    // 1. "at 2:00 PM" / "at 14:00"
+    let m = input.match(/\bat\s+(\d{1,2}):(\d{2})(?::(\d{2}))?\s*(am|pm)?/i);
+    if (m?.[1] !== undefined && m[2] !== undefined) {
+        const meridiem = m[4]?.toLowerCase();
+        return {
+            hour: meridiem === undefined
+                ? Number(m[1])
+                : applyMeridiem(Number(m[1]), meridiem === 'pm'),
+            minute: Number(m[2]),
+            second: m[3] === undefined ? 0 : Number(m[3]),
+            matched: m[0],
+        };
+    }
+    // 1b. "at 2 PM"（无分钟，必须带 AM/PM 才可信）
+    m = input.match(/\bat\s+(\d{1,2})\s*(am|pm)\b/i);
+    if (m?.[1] !== undefined && m[2] !== undefined) {
+        return {
+            hour: applyMeridiem(Number(m[1]), m[2].toLowerCase() === 'pm'),
+            minute: 0,
+            second: 0,
+            matched: m[0],
+        };
+    }
+    // 2. 中文时段 + 时刻："下午2点" / "下午2:30" / "晚上8点15分"
+    // 分钟数字在分隔符（点/时/:）之后可缺省——"下午2点"须整体命中并消费掉"点"。
+    m = input.match(/(凌晨|早上|上午|中午|下午|傍晚|晚上)\s*(\d{1,2})(?:[点时:：](\d{1,2})?)?分?/);
+    if (m?.[1] !== undefined && m[2] !== undefined) {
+        return {
+            hour: applyMeridiem(Number(m[2]), CHINESE_PM_WORDS.has(m[1])),
+            minute: m[3] === undefined ? 0 : Number(m[3]),
+            second: 0,
+            matched: m[0],
+        };
+    }
+    // 2b. 24 小时制中文："14点30分" / "14点"
+    m = input.match(/(\d{1,2})[点时](?:(\d{1,2})分?)?/);
+    if (m?.[1] !== undefined) {
+        return {
+            hour: Number(m[1]),
+            minute: m[2] === undefined ? 0 : Number(m[2]),
+            second: 0,
+            matched: m[0],
+        };
+    }
+    // 3. 裸 "HH:mm(:ss)"，AM/PM 可选（"11 July 2026 14:30" / "2:00 PM"）
+    m = input.match(/(\d{1,2}):(\d{2})(?::(\d{2}))?\s*(am|pm)?\b/i);
+    if (m?.[1] !== undefined && m[2] !== undefined) {
+        const meridiem = m[4]?.toLowerCase();
+        return {
+            hour: meridiem === undefined
+                ? Number(m[1])
+                : applyMeridiem(Number(m[1]), meridiem === 'pm'),
+            minute: Number(m[2]),
+            second: m[3] === undefined ? 0 : Number(m[3]),
+            matched: m[0],
+        };
+    }
+    return undefined;
+}
+/** 解析纯日期部分 → [year, month, day]。不做溢出自纠（2月30日返回 undefined）。 */
+function parseDateOnly(input) {
+    const s = input.trim().replace(/[,，]\s*$/, '');
+    if (!s)
+        return undefined;
+    // 中文："2026年7月11日" / "2026年7月11号"
+    let m = s.match(/^(\d{4})年(\d{1,2})月(\d{1,2})[日号]?$/);
+    // 数字分隔："2026-7-11" / "2026/7/11" / "2026.7.11"
+    m = m ?? s.match(/^(\d{4})[-/.](\d{1,2})[-/.](\d{1,2})$/);
+    if (m?.[1] !== undefined && m[2] !== undefined && m[3] !== undefined) {
+        return validateYmd(Number(m[1]), Number(m[2]), Number(m[3]));
+    }
+    // 英文自然语言："15 March 2025" / "March 15, 2025"——交给 Date 解析，
+    // 但要求字符串里含英文月份词，避免 Date 对任意数字串的宽松误解析。
+    if (/\b(january|february|march|april|may|june|july|august|september|october|november|december)\b/i.test(s)) {
+        const parsed = new Date(s);
+        if (!Number.isNaN(parsed.getTime())) {
+            return [parsed.getFullYear(), parsed.getMonth() + 1, parsed.getDate()];
+        }
+    }
+    return undefined;
+}
+/** 用本地 Date 构造校验年月日真实存在（拒绝 JS 自动进位，如 2 月 30 日）。 */
+function validateYmd(year, month, day) {
+    const d = new Date(year, month - 1, day);
+    if (d.getFullYear() !== year ||
+        d.getMonth() !== month - 1 ||
+        d.getDate() !== day) {
+        return undefined;
+    }
+    return [year, month, day];
+}
+/**
+ * 归一化宽松日期输入。返回严格格式字符串；无法归一时返回 trim 后的原输入
+ * （由下游 zod 统一报格式错误）。
+ */
+export function normalizeLooseDateInput(raw) {
+    const trimmed = raw.trim();
+    if (STRICT_DATE_PATTERN.test(trimmed))
+        return trimmed;
+    let rest = trimmed.replace(ENGLISH_WEEKDAY_PREFIX, '');
+    const time = extractTime(rest);
+    if (time) {
+        if (time.hour > 23 || time.minute > 59 || time.second > 59)
+            return trimmed;
+        rest = rest.replace(time.matched, ' ');
+    }
+    const ymd = parseDateOnly(rest.replace(/\s+/g, ' ').trim());
+    if (!ymd)
+        return trimmed;
+    const [year, month, day] = ymd;
+    const datePart = `${year}-${pad(month)}-${pad(day)}`;
+    if (!time)
+        return datePart;
+    return `${datePart} ${pad(time.hour)}:${pad(time.minute)}:${pad(time.second)}`;
+}
+//# sourceMappingURL=looseDateParser.js.map

package/dist/utils/looseDateParser.js.map

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

package/dist/utils/projectUtils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * projectUtils.ts
+ * Shared utilities for project-related operations
+ */
+/**
+ * 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 declare function findProjectRoot(maxDepth?: 10): string;
+/** Test helper — drops the cached project root so a fresh resolve happens. */
+export declare function __clearProjectRootCache(): void;