@unbrained/pm-cli 2026.6.30 → 2026.7.2

package/dist/cli/commands/calendar.js

@@ -4,7 +4,7 @@
  * Implements the pm calendar command surface and its agent-facing runtime behavior.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="6c196179-0593-5629-926f-6e0143fb9da2")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="16039cc1-59c0-510f-9ae1-d452ba30096c")}catch(e){}}();
 import { encode as encodeToon } from "@toon-format/toon";
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
@@ -265,123 +265,131 @@ function buildRecurringEventWindow(start, end, nowValue, lookbackDays, lookahead
         end: compareTimestampStrings(windowEnd, windowStart) > 0 ? windowEnd : addUtcDays(windowStart, 1),
     };
 }
-function expandRecurringOccurrences(startAt, recurrence, window, occurrenceLimit) {
-    const maxOccurrences = occurrenceLimit ?? MAX_RECURRENCE_OCCURRENCES;
-    const interval = recurrence.interval ?? 1;
-    const countLimit = recurrence.count ?? Number.POSITIVE_INFINITY;
-    const until = recurrence.until;
-    const excluded = buildExcludedInstantSet(recurrence.exdates);
-    const recurrenceWeekdays = recurrence.by_weekday && recurrence.by_weekday.length > 0 ? [...recurrence.by_weekday] : [weekdayToken(startAt)];
-    const recurrenceMonthDays = recurrence.by_month_day && recurrence.by_month_day.length > 0 ? [...recurrence.by_month_day] : [new Date(startAt).getUTCDate()];
-    const weekdayFilter = recurrence.by_weekday ? new Set(recurrence.by_weekday) : undefined;
-    const monthDayFilter = recurrence.by_month_day ? new Set(recurrence.by_month_day) : undefined;
-    const sortedWeekdays = [...new Set(recurrenceWeekdays)].sort((left, right) => weekdayOrderIndex(left) -
-        weekdayOrderIndex(right));
-    const sortedMonthDays = [...new Set(recurrenceMonthDays)].sort((left, right) => left - right);
-    const occurrences = [];
-    let produced = 0;
-    const consumeCandidate = (candidateAt) => {
-        if (compareTimestampStrings(candidateAt, startAt) < 0) {
-            return "continue";
-        }
-        if (until && compareTimestampStrings(candidateAt, until) > 0) {
-            return "stop";
-        }
-        if (compareTimestampStrings(candidateAt, window.end) >= 0) {
-            return "stop";
-        }
-        if (excluded.has(candidateAt)) {
-            return "continue";
-        }
-        produced += 1;
-        if (compareTimestampStrings(candidateAt, window.start) >= 0) {
-            occurrences.push(candidateAt);
-        }
-        if (produced >= countLimit) {
-            return "stop";
-        }
-        return "continue";
+function buildRecurrenceExpansionContext(startAt, recurrence, window, occurrenceLimit) {
+    // Omitted filters default to the series start; explicit empty filters intentionally match no occurrences.
+    const recurrenceWeekdays = recurrence.by_weekday !== undefined ? [...recurrence.by_weekday] : [weekdayToken(startAt)];
+    const recurrenceMonthDays = recurrence.by_month_day !== undefined ? [...recurrence.by_month_day] : [new Date(startAt).getUTCDate()];
+    return {
+        startAt,
+        startDate: new Date(startAt),
+        window,
+        maxOccurrences: occurrenceLimit ?? MAX_RECURRENCE_OCCURRENCES,
+        interval: recurrence.interval ?? 1,
+        countLimit: recurrence.count ?? Number.POSITIVE_INFINITY,
+        until: recurrence.until,
+        excluded: buildExcludedInstantSet(recurrence.exdates),
+        weekdayFilter: recurrence.by_weekday !== undefined ? new Set(recurrence.by_weekday) : undefined,
+        monthDayFilter: recurrence.by_month_day !== undefined ? new Set(recurrence.by_month_day) : undefined,
+        sortedWeekdays: [...new Set(recurrenceWeekdays)].sort((left, right) => weekdayOrderIndex(left) - weekdayOrderIndex(right)),
+        sortedMonthDays: [...new Set(recurrenceMonthDays)].sort((left, right) => left - right),
+        occurrences: [],
+        produced: 0,
     };
-    const startDate = new Date(startAt);
-    if (recurrence.freq === "daily") {
-        let candidateAt = startAt;
-        for (let iteration = 0; iteration < maxOccurrences; iteration += 1) {
-            const candidateWeekday = weekdayToken(candidateAt);
-            const candidateMonthDay = new Date(candidateAt).getUTCDate();
-            const weekdayMatches = !weekdayFilter || weekdayFilter.has(candidateWeekday);
-            const monthDayMatches = !monthDayFilter || monthDayFilter.has(candidateMonthDay);
-            if (weekdayMatches && monthDayMatches && consumeCandidate(candidateAt) === "stop") {
-                break;
-            }
-            candidateAt = addUtcDays(candidateAt, interval);
-        }
-        return occurrences;
+}
+function consumeRecurrenceCandidate(context, candidateAt) {
+    if (compareTimestampStrings(candidateAt, context.startAt) < 0) {
+        return "continue";
     }
-    if (recurrence.freq === "weekly") {
-        const weekStart = startOfUtcWeekMonday(startAt);
-        for (let step = 0; step < maxOccurrences; step += 1) {
-            const candidateWeekStart = addUtcDays(weekStart, step * interval * 7);
-            for (const weekday of sortedWeekdays) {
-                const dayOffset = weekdayOrderIndex(weekday);
-                const candidateDay = addUtcDays(candidateWeekStart, dayOffset);
-                const dayDate = new Date(candidateDay);
-                const candidateAt = new Date(Date.UTC(dayDate.getUTCFullYear(), dayDate.getUTCMonth(), dayDate.getUTCDate(), startDate.getUTCHours(), startDate.getUTCMinutes(), startDate.getUTCSeconds(), startDate.getUTCMilliseconds())).toISOString();
-                const candidateMonthDay = dayDate.getUTCDate();
-                if (monthDayFilter && !monthDayFilter.has(candidateMonthDay)) {
-                    continue;
-                }
-                const consumed = consumeCandidate(candidateAt);
-                if (consumed === "stop") {
-                    return occurrences;
-                }
-            }
-        }
-        return occurrences;
+    if (context.until && compareTimestampStrings(candidateAt, context.until) > 0) {
+        return "stop";
     }
-    if (recurrence.freq === "monthly") {
-        const startYear = startDate.getUTCFullYear();
-        const startMonth = startDate.getUTCMonth();
-        for (let step = 0; step < maxOccurrences; step += 1) {
-            const monthAnchor = new Date(Date.UTC(startYear, startMonth + step * interval, 1, 0, 0, 0, 0));
-            const year = monthAnchor.getUTCFullYear();
-            const month = monthAnchor.getUTCMonth();
-            for (const monthDay of sortedMonthDays) {
-                const candidateAt = buildUtcTimestamp(year, month, monthDay, startDate);
-                if (!candidateAt) {
-                    continue;
-                }
-                const candidateWeekday = weekdayToken(candidateAt);
-                if (weekdayFilter && !weekdayFilter.has(candidateWeekday)) {
-                    continue;
-                }
-                const consumed = consumeCandidate(candidateAt);
-                if (consumed === "stop") {
-                    return occurrences;
-                }
+    if (compareTimestampStrings(candidateAt, context.window.end) >= 0) {
+        return "stop";
+    }
+    if (context.excluded.has(candidateAt)) {
+        return "continue";
+    }
+    context.produced += 1;
+    if (compareTimestampStrings(candidateAt, context.window.start) >= 0) {
+        context.occurrences.push(candidateAt);
+    }
+    return context.produced >= context.countLimit || context.occurrences.length >= context.maxOccurrences ? "stop" : "continue";
+}
+function recurrenceDayMatchesFilters(context, candidateAt) {
+    const candidateWeekday = weekdayToken(candidateAt);
+    const candidateMonthDay = new Date(candidateAt).getUTCDate();
+    const weekdayMatches = !context.weekdayFilter || context.weekdayFilter.has(candidateWeekday);
+    const monthDayMatches = !context.monthDayFilter || context.monthDayFilter.has(candidateMonthDay);
+    return weekdayMatches && monthDayMatches;
+}
+function expandDailyOccurrences(context) {
+    let candidateAt = context.startAt;
+    for (let iteration = 0; iteration < context.maxOccurrences; iteration += 1) {
+        if (recurrenceDayMatchesFilters(context, candidateAt) && consumeRecurrenceCandidate(context, candidateAt) === "stop") {
+            break;
+        }
+        candidateAt = addUtcDays(candidateAt, context.interval);
+    }
+    return context.occurrences;
+}
+function buildWeeklyCandidateAt(context, candidateWeekStart, weekday) {
+    const dayOffset = weekdayOrderIndex(weekday);
+    const candidateDay = addUtcDays(candidateWeekStart, dayOffset);
+    const dayDate = new Date(candidateDay);
+    return new Date(Date.UTC(dayDate.getUTCFullYear(), dayDate.getUTCMonth(), dayDate.getUTCDate(), context.startDate.getUTCHours(), context.startDate.getUTCMinutes(), context.startDate.getUTCSeconds(), context.startDate.getUTCMilliseconds())).toISOString();
+}
+function expandWeeklyOccurrences(context) {
+    const weekStart = startOfUtcWeekMonday(context.startAt);
+    for (let step = 0; step < context.maxOccurrences; step += 1) {
+        const candidateWeekStart = addUtcDays(weekStart, step * context.interval * 7);
+        for (const weekday of context.sortedWeekdays) {
+            const candidateAt = buildWeeklyCandidateAt(context, candidateWeekStart, weekday);
+            if (!recurrenceDayMatchesFilters(context, candidateAt)) {
+                continue;
+            }
+            if (consumeRecurrenceCandidate(context, candidateAt) === "stop") {
+                return context.occurrences;
             }
         }
-        return occurrences;
-    }
-    const year = startDate.getUTCFullYear();
-    const month = startDate.getUTCMonth();
-    for (let step = 0; step < maxOccurrences; step += 1) {
-        const candidateYear = year + step * interval;
-        for (const monthDay of sortedMonthDays) {
-            const candidateAt = buildUtcTimestamp(candidateYear, month, monthDay, startDate);
-            if (!candidateAt) {
+    }
+    return context.occurrences;
+}
+function expandMonthlyOccurrences(context) {
+    const startYear = context.startDate.getUTCFullYear();
+    const startMonth = context.startDate.getUTCMonth();
+    for (let step = 0; step < context.maxOccurrences; step += 1) {
+        const monthAnchor = new Date(Date.UTC(startYear, startMonth + step * context.interval, 1, 0, 0, 0, 0));
+        for (const monthDay of context.sortedMonthDays) {
+            const candidateAt = buildUtcTimestamp(monthAnchor.getUTCFullYear(), monthAnchor.getUTCMonth(), monthDay, context.startDate);
+            if (!candidateAt || !recurrenceDayMatchesFilters(context, candidateAt)) {
                 continue;
             }
-            const candidateWeekday = weekdayToken(candidateAt);
-            if (weekdayFilter && !weekdayFilter.has(candidateWeekday)) {
+            if (consumeRecurrenceCandidate(context, candidateAt) === "stop") {
+                return context.occurrences;
+            }
+        }
+    }
+    return context.occurrences;
+}
+function expandYearlyOccurrences(context) {
+    const year = context.startDate.getUTCFullYear();
+    const month = context.startDate.getUTCMonth();
+    for (let step = 0; step < context.maxOccurrences; step += 1) {
+        const candidateYear = year + step * context.interval;
+        for (const monthDay of context.sortedMonthDays) {
+            const candidateAt = buildUtcTimestamp(candidateYear, month, monthDay, context.startDate);
+            if (!candidateAt || !recurrenceDayMatchesFilters(context, candidateAt)) {
                 continue;
             }
-            const consumed = consumeCandidate(candidateAt);
-            if (consumed === "stop") {
-                return occurrences;
+            if (consumeRecurrenceCandidate(context, candidateAt) === "stop") {
+                return context.occurrences;
             }
         }
     }
-    return occurrences;
+    return context.occurrences;
+}
+function expandRecurringOccurrences(startAt, recurrence, window, occurrenceLimit) {
+    const context = buildRecurrenceExpansionContext(startAt, recurrence, window, occurrenceLimit);
+    if (recurrence.freq === "daily") {
+        return expandDailyOccurrences(context);
+    }
+    if (recurrence.freq === "weekly") {
+        return expandWeeklyOccurrences(context);
+    }
+    if (recurrence.freq === "monthly") {
+        return expandMonthlyOccurrences(context);
+    }
+    return expandYearlyOccurrences(context);
 }
 function sortEvents(values) {
     return [...values].sort((a, b) => {
@@ -403,98 +411,102 @@ function sortEvents(values) {
         return String(a.reminder_text).localeCompare(String(b.reminder_text));
     });
 }
+function buildItemCalendarRowBase(item) {
+    return {
+        item_id: item.id,
+        item_title: item.title,
+        item_type: item.type,
+        item_status: item.status,
+        item_priority: item.priority,
+        item_assignee: item.assignee ?? null,
+        item_deadline: item.deadline ?? null,
+        item_tags: item.tags,
+    };
+}
+function buildDeadlineRow(item) {
+    if (!item.deadline) {
+        return null;
+    }
+    return {
+        at: item.deadline,
+        date: toUtcDayKey(item.deadline),
+        kind: "deadline",
+        reminder_text: null,
+        event_title: null,
+        event_end: null,
+        event_location: null,
+        event_all_day: null,
+        event_timezone: null,
+        event_recurring: null,
+        event_recurrence_rule: null,
+        ...buildItemCalendarRowBase(item),
+        item_deadline: item.deadline,
+    };
+}
+function buildReminderRows(item) {
+    return (item.reminders ?? []).map((reminder) => ({
+        at: reminder.at,
+        date: toUtcDayKey(reminder.at),
+        kind: "reminder",
+        reminder_text: reminder.text,
+        event_title: null,
+        event_end: null,
+        event_location: null,
+        event_all_day: null,
+        event_timezone: null,
+        event_recurring: null,
+        event_recurrence_rule: null,
+        ...buildItemCalendarRowBase(item),
+    }));
+}
+function recurringDurationMs(startAt, endAt) {
+    if (!endAt) {
+        return null;
+    }
+    const duration = Date.parse(endAt) - Date.parse(startAt);
+    return Number.isFinite(duration) && duration > 0 ? duration : null;
+}
+function eventOccurrenceEnd(occurrenceAt, event, durationMs) {
+    return event.recurrence && durationMs !== null
+        ? new Date(new Date(occurrenceAt).getTime() + durationMs).toISOString()
+        : (event.end_at ?? null);
+}
+function buildScheduledEventRows(item, event, recurringWindow, occurrenceLimit) {
+    const recurrenceRuleSummary = formatRecurrenceRuleForSummary(event.recurrence);
+    const durationMs = recurringDurationMs(event.start_at, event.end_at);
+    const occurrences = event.recurrence
+        ? expandRecurringOccurrences(event.start_at, event.recurrence, recurringWindow, occurrenceLimit)
+        : [event.start_at];
+    return occurrences.map((occurrenceAt) => ({
+        at: occurrenceAt,
+        // All-day events are timezone-agnostic calendar dates: bucket by the
+        // literal start date. Timed events bucket by their local day in the
+        // event's timezone (defaults to UTC when unset).
+        date: event.all_day === true ? occurrenceAt.slice(0, 10) : toLocalDayKey(occurrenceAt, event.timezone),
+        kind: "event",
+        reminder_text: event.description ?? null,
+        event_title: event.title ?? item.title,
+        event_end: eventOccurrenceEnd(occurrenceAt, event, durationMs),
+        event_location: event.location ?? null,
+        event_all_day: event.all_day ?? null,
+        event_timezone: event.timezone ?? null,
+        event_recurring: event.recurrence ? true : false,
+        event_recurrence_rule: recurrenceRuleSummary,
+        ...buildItemCalendarRowBase(item),
+    }));
+}
 function buildEventSeed(items, recurringWindow, includeSources, occurrenceLimit) {
     const events = [];
     for (const item of items) {
-        if (includeSources.has("deadlines") && item.deadline) {
-            events.push({
-                at: item.deadline,
-                date: toUtcDayKey(item.deadline),
-                kind: "deadline",
-                reminder_text: null,
-                event_title: null,
-                event_end: null,
-                event_location: null,
-                event_all_day: null,
-                event_timezone: null,
-                event_recurring: null,
-                event_recurrence_rule: null,
-                item_id: item.id,
-                item_title: item.title,
-                item_type: item.type,
-                item_status: item.status,
-                item_priority: item.priority,
-                item_assignee: item.assignee ?? null,
-                item_deadline: item.deadline,
-                item_tags: item.tags,
-            });
+        const deadlineRow = includeSources.has("deadlines") ? buildDeadlineRow(item) : null;
+        if (deadlineRow) {
+            events.push(deadlineRow);
         }
-        for (const reminder of includeSources.has("reminders") ? (item.reminders ?? []) : []) {
-            events.push({
-                at: reminder.at,
-                date: toUtcDayKey(reminder.at),
-                kind: "reminder",
-                reminder_text: reminder.text,
-                event_title: null,
-                event_end: null,
-                event_location: null,
-                event_all_day: null,
-                event_timezone: null,
-                event_recurring: null,
-                event_recurrence_rule: null,
-                item_id: item.id,
-                item_title: item.title,
-                item_type: item.type,
-                item_status: item.status,
-                item_priority: item.priority,
-                item_assignee: item.assignee ?? null,
-                item_deadline: item.deadline ?? null,
-                item_tags: item.tags,
-            });
+        if (includeSources.has("reminders")) {
+            events.push(...buildReminderRows(item));
         }
         for (const event of includeSources.has("events") ? (item.events ?? []) : []) {
-            const recurrenceRuleSummary = formatRecurrenceRuleForSummary(event.recurrence);
-            const recurringDurationMs = (() => {
-                if (!event.end_at) {
-                    return null;
-                }
-                const duration = Date.parse(event.end_at) - Date.parse(event.start_at);
-                return Number.isFinite(duration) && duration > 0 ? duration : null;
-            })();
-            const occurrences = event.recurrence
-                ? expandRecurringOccurrences(event.start_at, event.recurrence, recurringWindow, occurrenceLimit)
-                : [event.start_at];
-            for (const occurrenceAt of occurrences) {
-                const occurrenceEnd = event.recurrence && recurringDurationMs !== null
-                    ? new Date(new Date(occurrenceAt).getTime() + recurringDurationMs).toISOString()
-                    : (event.end_at ?? null);
-                events.push({
-                    at: occurrenceAt,
-                    // All-day events are timezone-agnostic calendar dates: bucket by the
-                    // literal start date. Timed events bucket by their local day in the
-                    // event's timezone (defaults to UTC when unset).
-                    date: event.all_day === true
-                        ? occurrenceAt.slice(0, 10)
-                        : toLocalDayKey(occurrenceAt, event.timezone),
-                    kind: "event",
-                    reminder_text: event.description ?? null,
-                    event_title: event.title ?? item.title,
-                    event_end: occurrenceEnd,
-                    event_location: event.location ?? null,
-                    event_all_day: event.all_day ?? null,
-                    event_timezone: event.timezone ?? null,
-                    event_recurring: event.recurrence ? true : false,
-                    event_recurrence_rule: recurrenceRuleSummary,
-                    item_id: item.id,
-                    item_title: item.title,
-                    item_type: item.type,
-                    item_status: item.status,
-                    item_priority: item.priority,
-                    item_assignee: item.assignee ?? null,
-                    item_deadline: item.deadline ?? null,
-                    item_tags: item.tags,
-                });
-            }
+            events.push(...buildScheduledEventRows(item, event, recurringWindow, occurrenceLimit));
         }
     }
     return sortEvents(events);
@@ -514,30 +526,46 @@ function filterItems(items, options, typeRegistry, statusRegistry, runtimeFieldF
     if (assigneeFilter !== undefined && assigneeModeFilter === "unassigned") {
         throw new PmCliError("Cannot combine --assignee with --assignee-filter unassigned", EXIT_CODE.USAGE);
     }
-    return items.filter((item) => {
-        if (typeFilter && item.type !== typeFilter)
-            return false;
-        if (tagFilter && !item.tags.some((tag) => tag.trim().toLowerCase() === tagFilter))
-            return false;
-        if (priorityFilter !== undefined && item.priority !== priorityFilter)
-            return false;
-        if (statusFilter && item.status !== statusFilter)
-            return false;
-        if (assigneeModeFilter === "assigned" && !item.assignee)
-            return false;
-        if (assigneeModeFilter === "unassigned" && item.assignee)
-            return false;
-        if (assigneeFilter !== undefined && item.assignee !== assigneeFilter) {
-            return false;
-        }
-        if (sprintFilter !== undefined && item.sprint !== sprintFilter)
-            return false;
-        if (releaseFilter !== undefined && item.release !== releaseFilter)
-            return false;
-        if (!matchesRuntimeFilters(item, runtimeFieldFilters))
-            return false;
-        return true;
-    });
+    return items.filter((item) => itemMatchesCalendarFilters(item, {
+        typeFilter,
+        tagFilter,
+        priorityFilter,
+        statusFilter,
+        assigneeFilter,
+        assigneeModeFilter,
+        sprintFilter,
+        releaseFilter,
+        runtimeFieldFilters,
+    }));
+}
+function itemMatchesCalendarFilters(item, filters) {
+    return (itemMatchesCalendarIdentityFilters(item, filters) &&
+        itemMatchesCalendarOwnerFilters(item, filters) &&
+        matchesRuntimeFilters(item, filters.runtimeFieldFilters));
+}
+function itemMatchesCalendarIdentityFilters(item, filters) {
+    if (filters.typeFilter && item.type !== filters.typeFilter)
+        return false;
+    if (filters.tagFilter && !item.tags.some((tag) => tag.trim().toLowerCase() === filters.tagFilter))
+        return false;
+    if (filters.priorityFilter !== undefined && item.priority !== filters.priorityFilter)
+        return false;
+    if (filters.statusFilter && item.status !== filters.statusFilter)
+        return false;
+    return true;
+}
+function itemMatchesCalendarOwnerFilters(item, filters) {
+    if (filters.assigneeModeFilter === "assigned" && !item.assignee)
+        return false;
+    if (filters.assigneeModeFilter === "unassigned" && item.assignee)
+        return false;
+    if (filters.assigneeFilter !== undefined && item.assignee !== filters.assigneeFilter)
+        return false;
+    if (filters.sprintFilter !== undefined && item.sprint !== filters.sprintFilter)
+        return false;
+    if (filters.releaseFilter !== undefined && item.release !== filters.releaseFilter)
+        return false;
+    return true;
 }
 function includeEventInWindow(event, start, end) {
     if (start && compareTimestampStrings(event.at, start) < 0) {
@@ -567,53 +595,38 @@ function buildRange(view, options, nowValue) {
         throw new PmCliError("--from and --to are only supported for --view agenda", EXIT_CODE.USAGE);
     }
     if (view === "agenda") {
-        if (fullPeriodRequested) {
-            throw new PmCliError("--full-period is only supported for --view day|week|month. For agenda windows, use --from and --to.", EXIT_CODE.USAGE);
-        }
-        const start = from ?? (options.date ? anchor : includePast ? undefined : nowValue);
-        return {
-            anchor,
-            start,
-            end: to,
-            fullPeriod: false,
-        };
+        return buildAgendaRange(anchor, options, nowValue, includePast, fullPeriodRequested, from, to);
     }
     if (view === "day") {
         const dayStart = startOfUtcDay(anchor);
-        const fullPeriod = includePast || fullPeriodRequested;
-        const start = fullPeriod ? dayStart : maxTimestamp(dayStart, nowValue);
-        return {
-            anchor,
-            start,
-            end: addUtcDays(dayStart, 1),
-            periodStart: dayStart,
-            periodEnd: addUtcDays(dayStart, 1),
-            fullPeriod,
-        };
+        return buildFixedPeriodRange(anchor, nowValue, includePast, fullPeriodRequested, dayStart, addUtcDays(dayStart, 1));
     }
     if (view === "week") {
         const weekStart = startOfUtcWeekMonday(anchor);
-        const fullPeriod = includePast || fullPeriodRequested;
-        const start = fullPeriod ? weekStart : maxTimestamp(weekStart, nowValue);
-        return {
-            anchor,
-            start,
-            end: addUtcDays(weekStart, 7),
-            periodStart: weekStart,
-            periodEnd: addUtcDays(weekStart, 7),
-            fullPeriod,
-        };
+        return buildFixedPeriodRange(anchor, nowValue, includePast, fullPeriodRequested, weekStart, addUtcDays(weekStart, 7));
     }
     const monthStart = startOfUtcMonth(anchor);
-    const monthEnd = startOfNextUtcMonth(anchor);
+    return buildFixedPeriodRange(anchor, nowValue, includePast, fullPeriodRequested, monthStart, startOfNextUtcMonth(anchor));
+}
+function buildAgendaRange(anchor, options, nowValue, includePast, fullPeriodRequested, from, to) {
+    if (fullPeriodRequested) {
+        throw new PmCliError("--full-period is only supported for --view day|week|month. For agenda windows, use --from and --to.", EXIT_CODE.USAGE);
+    }
+    return {
+        anchor,
+        start: from ?? (options.date ? anchor : includePast ? undefined : nowValue),
+        end: to,
+        fullPeriod: false,
+    };
+}
+function buildFixedPeriodRange(anchor, nowValue, includePast, fullPeriodRequested, periodStart, periodEnd) {
     const fullPeriod = includePast || fullPeriodRequested;
-    const start = fullPeriod ? monthStart : maxTimestamp(monthStart, nowValue);
     return {
         anchor,
-        start,
-        end: monthEnd,
-        periodStart: monthStart,
-        periodEnd: monthEnd,
+        start: fullPeriod ? periodStart : maxTimestamp(periodStart, nowValue),
+        end: periodEnd,
+        periodStart,
+        periodEnd,
         fullPeriod,
     };
 }
@@ -818,14 +831,7 @@ function trimTrailingNewlines(value) {
     }
     return value.slice(0, end);
 }
-/**
- * Implements run calendar for the public runtime surface of this module.
- */
-export async function runCalendar(options, global) {
-    const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-    }
+function resolveCalendarExecutionInputs(options) {
     const nowValue = nowIso();
     const view = parseView(options.view);
     const rangeBounds = buildRange(view, options, nowValue);
@@ -838,61 +844,91 @@ export async function runCalendar(options, global) {
         throw new PmCliError("Calendar occurrence limit must be >= 1", EXIT_CODE.USAGE);
     }
     const eventsOnly = includeSources.has("events") && !includeSources.has("deadlines") && !includeSources.has("reminders");
-    const hasExplicitBounds = options.to !== undefined || explicitLookahead !== undefined || occurrenceLimit !== undefined;
+    const hasExplicitBounds = options.to !== undefined ||
+        explicitLookahead !== undefined ||
+        recurrenceLookbackDays !== undefined ||
+        occurrenceLimit !== undefined;
     const eventsOnlyCapApplied = eventsOnly && !hasExplicitBounds;
-    const recurrenceLookaheadDays = eventsOnlyCapApplied ? DEFAULT_EVENTS_ONLY_LOOKAHEAD_DAYS : explicitLookahead;
-    const recurrenceLookbackWindowDays = eventsOnlyCapApplied && recurrenceLookbackDays === undefined
-        ? 0
-        : recurrenceLookbackDays;
+    return {
+        nowValue,
+        view,
+        rangeBounds,
+        limit,
+        includeSources,
+        occurrenceLimit,
+        recurrenceLookaheadDays: eventsOnlyCapApplied ? DEFAULT_EVENTS_ONLY_LOOKAHEAD_DAYS : explicitLookahead,
+        recurrenceLookbackWindowDays: eventsOnlyCapApplied && recurrenceLookbackDays === undefined ? 0 : recurrenceLookbackDays,
+        eventsOnlyCapApplied,
+    };
+}
+function appendCalendarCapWarning(warnings, capApplied) {
+    if (!capApplied) {
+        return;
+    }
+    warnings.push(`recurring_events_default_cap_applied:lookback=0d,lookahead=${DEFAULT_EVENTS_ONLY_LOOKAHEAD_DAYS}d -- use --recurrence-lookback-days/--recurrence-lookahead-days or --to for wider range`);
+}
+function buildCalendarFiltersResult(options, runtimeFieldFilters) {
+    return {
+        type: options.type ?? null,
+        tag: options.tag ?? null,
+        priority: options.priority ?? null,
+        status: options.status ?? null,
+        assignee: options.assignee ?? null,
+        assignee_filter: options.assigneeFilter ?? null,
+        sprint: options.sprint ?? null,
+        release: options.release ?? null,
+        runtime_filters: runtimeFieldFilters,
+        limit: options.limit ?? null,
+        include: options.include ?? null,
+        full_period: options.fullPeriod === true ? "true" : null,
+        recurrence_lookahead_days: options.recurrenceLookaheadDays ?? null,
+        recurrence_lookback_days: options.recurrenceLookbackDays ?? null,
+        occurrence_limit: options.occurrenceLimit ?? null,
+    };
+}
+function buildCalendarRangeResult(options, rangeBounds) {
+    return {
+        start: rangeBounds.start ?? null,
+        end: rangeBounds.end ?? null,
+        period_start: rangeBounds.periodStart ?? null,
+        period_end: rangeBounds.periodEnd ?? null,
+        full_period: rangeBounds.fullPeriod,
+        past: options.past === true,
+        from: options.from ?? null,
+        to: options.to ?? null,
+    };
+}
+/**
+ * Implements run calendar for the public runtime surface of this module.
+ */
+export async function runCalendar(options, global) {
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
+    if (!(await pathExists(getSettingsPath(pmRoot)))) {
+        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+    }
+    const inputs = resolveCalendarExecutionInputs(options);
     const settings = await readSettings(pmRoot);
     const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
     const runtimeFieldRegistry = resolveRuntimeFieldRegistry(settings.schema);
     const runtimeFieldFilters = collectRuntimeFilterValues(options, runtimeFieldRegistry, "calendar");
     const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
     const listWarnings = [];
-    if (eventsOnlyCapApplied) {
-        listWarnings.push(`recurring_events_default_cap_applied:lookback=0d,lookahead=${DEFAULT_EVENTS_ONLY_LOOKAHEAD_DAYS}d -- use --recurrence-lookback-days/--recurrence-lookahead-days or --to for wider range`);
-    }
+    appendCalendarCapWarning(listWarnings, inputs.eventsOnlyCapApplied);
     const items = await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, listWarnings, settings.schema);
     const filteredItems = filterItems(items, options, typeRegistry, statusRegistry, runtimeFieldFilters);
-    const recurringWindow = buildRecurringEventWindow(rangeBounds.start, rangeBounds.end, nowValue, recurrenceLookbackWindowDays, recurrenceLookaheadDays);
-    const seededEvents = buildEventSeed(filteredItems, recurringWindow, includeSources, occurrenceLimit);
-    const rangedEvents = seededEvents.filter((event) => includeEventInWindow(event, rangeBounds.start, rangeBounds.end));
-    const limitedEvents = limit === undefined ? rangedEvents : rangedEvents.slice(0, limit);
+    const recurringWindow = buildRecurringEventWindow(inputs.rangeBounds.start, inputs.rangeBounds.end, inputs.nowValue, inputs.recurrenceLookbackWindowDays, inputs.recurrenceLookaheadDays);
+    const seededEvents = buildEventSeed(filteredItems, recurringWindow, inputs.includeSources, inputs.occurrenceLimit);
+    const rangedEvents = seededEvents.filter((event) => includeEventInWindow(event, inputs.rangeBounds.start, inputs.rangeBounds.end));
+    const limitedEvents = inputs.limit === undefined ? rangedEvents : rangedEvents.slice(0, inputs.limit);
     const days = bucketEventsByDay(limitedEvents);
     const warnings = [...new Set(listWarnings)].sort((left, right) => left.localeCompare(right));
     return {
-        view,
+        view: inputs.view,
         output_default: "markdown",
-        now: nowValue,
-        anchor: rangeBounds.anchor,
-        range: {
-            start: rangeBounds.start ?? null,
-            end: rangeBounds.end ?? null,
-            period_start: rangeBounds.periodStart ?? null,
-            period_end: rangeBounds.periodEnd ?? null,
-            full_period: rangeBounds.fullPeriod,
-            past: options.past === true,
-            from: options.from ?? null,
-            to: options.to ?? null,
-        },
-        filters: {
-            type: options.type ?? null,
-            tag: options.tag ?? null,
-            priority: options.priority ?? null,
-            status: options.status ?? null,
-            assignee: options.assignee ?? null,
-            assignee_filter: options.assigneeFilter ?? null,
-            sprint: options.sprint ?? null,
-            release: options.release ?? null,
-            runtime_filters: runtimeFieldFilters,
-            limit: options.limit ?? null,
-            include: options.include ?? null,
-            full_period: options.fullPeriod === true ? "true" : null,
-            recurrence_lookahead_days: options.recurrenceLookaheadDays ?? null,
-            recurrence_lookback_days: options.recurrenceLookbackDays ?? null,
-            occurrence_limit: options.occurrenceLimit ?? null,
-        },
+        now: inputs.nowValue,
+        anchor: inputs.rangeBounds.anchor,
+        range: buildCalendarRangeResult(options, inputs.rangeBounds),
+        filters: buildCalendarFiltersResult(options, runtimeFieldFilters),
         summary: summarize(limitedEvents),
         events: limitedEvents,
         days,
@@ -900,4 +936,4 @@ export async function runCalendar(options, global) {
     };
 }
 //# sourceMappingURL=calendar.js.map
-//# debugId=6c196179-0593-5629-926f-6e0143fb9da2
+//# debugId=16039cc1-59c0-510f-9ae1-d452ba30096c