@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/sdk/lifecycle/recurrence-parsers.js

@@ -1,148 +1,2 @@
-/**
- * @module sdk/lifecycle/recurrence-parsers
- *
- * Implements the pm recurrence parsers 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]="2fcfbe50-039b-5031-8b18-a208908a0d87")}catch(e){}}();
-import { parseOptionalNumber, EXIT_CODE, PmCliError, resolveIsoOrRelative, } from "../runtime-primitives.js";
-import { RECURRENCE_FREQUENCY_VALUES, RECURRENCE_WEEKDAY_VALUES, weekdayOrderIndex, } from "../../types/index.js";
-/**
- * Shared calendar recurrence/event parsing helpers used by the `create` and
- * `update` commands. Extracted verbatim from create.ts and update.ts (pm-why9).
- *
- * `parseEventBoolean`, `parseDelimitedList`, and `ensureEnumValue` were
- * byte-identical between the two commands (update spelled `ensureEnumValue` as
- * `ensureEnum`).
- *
- * `parseRecurrenceRule` was identical apart from the recur_interval/recur_count
- * "provided" guard: create used `intervalRaw !== undefined` (an empty
- * `recur_interval=` is parsed and rejected), while update used the truthy
- * `intervalRaw ?` (an empty value is skipped). That distinction is preserved
- * via the `emptyNumericGuard` option so both call sites keep their exact
- * behaviour, including error strings.
- */
-export function parseEventBoolean(value, flag) {
-    const normalized = value.trim().toLowerCase();
-    if (normalized === "true" || normalized === "1" || normalized === "yes") {
-        return true;
-    }
-    if (normalized === "false" || normalized === "0" || normalized === "no") {
-        return false;
-    }
-    throw new PmCliError(`${flag} must be one of true|false|1|0|yes|no`, EXIT_CODE.USAGE);
-}
-/** Implements parse delimited list for the public runtime surface of this module. */
-export function parseDelimitedList(raw) {
-    if (!raw) {
-        return [];
-    }
-    return raw
-        .split("|")
-        .map((value) => value.trim())
-        .filter((value) => value.length > 0);
-}
-/** Implements ensure enum value for the public runtime surface of this module. */
-export function ensureEnumValue(value, allowed, label) {
-    if (!allowed.includes(value)) {
-        throw new PmCliError(`Invalid ${label} value "${value}". Allowed: ${allowed.join(", ")}`, EXIT_CODE.USAGE);
-    }
-    return value;
-}
-/**
- * Authoritative list of the CSV/markdown recurrence keys this parser reads.
- * Co-located with {@link parseRecurrenceRule} so adding a recurrence field
- * updates the reads AND the strict unknown-key allow-list in one place — the
- * `--event` validator (repeatable-metadata-parsers EVENT_KEYS) spreads this, so
- * a new recur key can never be silently rejected (GH-258). Keep in sync with
- * the `kv.recur_*` reads below.
- */
-export const RECURRENCE_CSV_KEYS = [
-    "recur_freq",
-    "recur_interval",
-    "recur_count",
-    "recur_until",
-    "recur_by_weekday",
-    "recur_by_month_day",
-    "recur_exdates",
-];
-function numericRecurrenceValueProvided(raw, guard) {
-    return guard === "defined" ? raw !== undefined : Boolean(raw);
-}
-function parsePositiveRecurrenceInteger(raw, label, guard) {
-    if (!numericRecurrenceValueProvided(raw, guard)) {
-        return undefined;
-    }
-    const parsed = parseOptionalNumber(raw, `event ${label}`);
-    if (!Number.isInteger(parsed) || parsed < 1) {
-        throw new PmCliError(`--event ${label} must be an integer >= 1`, EXIT_CODE.USAGE);
-    }
-    return parsed;
-}
-function parseRecurrenceUntil(untilRaw, startAt, nowValue) {
-    const until = untilRaw
-        ? resolveIsoOrRelative(untilRaw, nowValue, "event.recur_until")
-        : undefined;
-    if (until && until < startAt) {
-        throw new PmCliError("--event recur_until must be at or after start", EXIT_CODE.USAGE);
-    }
-    return until;
-}
-function parseRecurrenceWeekdays(raw) {
-    return Array.from(new Set(parseDelimitedList(raw).map((value) => ensureEnumValue(value.toLowerCase(), RECURRENCE_WEEKDAY_VALUES, "event weekday")))).sort((left, right) => weekdayOrderIndex(left) - weekdayOrderIndex(right));
-}
-function parseRecurrenceMonthDays(raw) {
-    return Array.from(new Set(parseDelimitedList(raw).map((value) => {
-        const day = parseOptionalNumber(value, "event recur_by_month_day");
-        if (!Number.isInteger(day) || day < 1 || day > 31) {
-            throw new PmCliError("--event recur_by_month_day values must be integers 1..31", EXIT_CODE.USAGE);
-        }
-        return day;
-    }))).sort((left, right) => left - right);
-}
-function parseRecurrenceExdates(raw, nowValue) {
-    return Array.from(new Set(parseDelimitedList(raw).map((value) => resolveIsoOrRelative(value, nowValue, "event.recur_exdates")))).sort((left, right) => left.localeCompare(right));
-}
-/** Implements parse recurrence rule for the public runtime surface of this module. */
-export function parseRecurrenceRule(kv, startAt, nowValue, emptyNumericGuard) {
-    const freqRaw = kv.recur_freq?.trim();
-    const intervalRaw = kv.recur_interval?.trim();
-    const countRaw = kv.recur_count?.trim();
-    const untilRaw = kv.recur_until?.trim();
-    const byWeekdayRaw = kv.recur_by_weekday?.trim();
-    const byMonthDayRaw = kv.recur_by_month_day?.trim();
-    const exdatesRaw = kv.recur_exdates?.trim();
-    const recurrenceInputsProvided = [
-        freqRaw,
-        intervalRaw,
-        countRaw,
-        untilRaw,
-        byWeekdayRaw,
-        byMonthDayRaw,
-        exdatesRaw,
-    ].some((value) => value !== undefined);
-    if (!recurrenceInputsProvided) {
-        return undefined;
-    }
-    if (!freqRaw) {
-        throw new PmCliError("--event recurrence fields require recur_freq=<daily|weekly|monthly|yearly>", EXIT_CODE.USAGE);
-    }
-    const freq = ensureEnumValue(freqRaw.toLowerCase(), RECURRENCE_FREQUENCY_VALUES, "event recurrence frequency");
-    const interval = parsePositiveRecurrenceInteger(intervalRaw, "recur_interval", emptyNumericGuard);
-    const count = parsePositiveRecurrenceInteger(countRaw, "recur_count", emptyNumericGuard);
-    const until = parseRecurrenceUntil(untilRaw, startAt, nowValue);
-    const byWeekday = parseRecurrenceWeekdays(byWeekdayRaw);
-    const byMonthDay = parseRecurrenceMonthDays(byMonthDayRaw);
-    const exdates = parseRecurrenceExdates(exdatesRaw, nowValue);
-    return {
-        freq,
-        interval,
-        count,
-        until,
-        by_weekday: byWeekday.length > 0 ? byWeekday : undefined,
-        by_month_day: byMonthDay.length > 0 ? byMonthDay : undefined,
-        exdates: exdates.length > 0 ? exdates : undefined,
-    };
-}
+!(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]="4cf64466-2612-5a12-a1ba-79fa2ed7c50d")}catch(e2){}})();import{parseOptionalNumber,EXIT_CODE,PmCliError,resolveIsoOrRelative}from"../runtime-primitives.js";import{RECURRENCE_FREQUENCY_VALUES,RECURRENCE_WEEKDAY_VALUES,weekdayOrderIndex}from"../../types/index.js";function parseEventBoolean(value,flag){const normalized=value.trim().toLowerCase();if(normalized==="true"||normalized==="1"||normalized==="yes"){return true}if(normalized==="false"||normalized==="0"||normalized==="no"){return false}throw new PmCliError(`${flag} must be one of true|false|1|0|yes|no`,EXIT_CODE.USAGE)}function parseDelimitedList(raw){if(!raw){return[]}return raw.split("|").map(value=>value.trim()).filter(value=>value.length>0)}function ensureEnumValue(value,allowed,label){if(!allowed.includes(value)){throw new PmCliError(`Invalid ${label} value "${value}". Allowed: ${allowed.join(", ")}`,EXIT_CODE.USAGE)}return value}const RECURRENCE_CSV_KEYS=["recur_freq","recur_interval","recur_count","recur_until","recur_by_weekday","recur_by_month_day","recur_exdates"];function numericRecurrenceValueProvided(raw,guard){return guard==="defined"?raw!==void 0:Boolean(raw)}function parsePositiveRecurrenceInteger(raw,label,guard){if(!numericRecurrenceValueProvided(raw,guard)){return void 0}const parsed=parseOptionalNumber(raw,`event ${label}`);if(!Number.isInteger(parsed)||parsed<1){throw new PmCliError(`--event ${label} must be an integer >= 1`,EXIT_CODE.USAGE)}return parsed}function parseRecurrenceUntil(untilRaw,startAt,nowValue){const until=untilRaw?resolveIsoOrRelative(untilRaw,nowValue,"event.recur_until"):void 0;if(until&&until<startAt){throw new PmCliError("--event recur_until must be at or after start",EXIT_CODE.USAGE)}return until}function parseRecurrenceWeekdays(raw){return Array.from(new Set(parseDelimitedList(raw).map(value=>ensureEnumValue(value.toLowerCase(),RECURRENCE_WEEKDAY_VALUES,"event weekday")))).sort((left,right)=>weekdayOrderIndex(left)-weekdayOrderIndex(right))}function parseRecurrenceMonthDays(raw){return Array.from(new Set(parseDelimitedList(raw).map(value=>{const day=parseOptionalNumber(value,"event recur_by_month_day");if(!Number.isInteger(day)||day<1||day>31){throw new PmCliError("--event recur_by_month_day values must be integers 1..31",EXIT_CODE.USAGE)}return day}))).sort((left,right)=>left-right)}function parseRecurrenceExdates(raw,nowValue){return Array.from(new Set(parseDelimitedList(raw).map(value=>resolveIsoOrRelative(value,nowValue,"event.recur_exdates")))).sort((left,right)=>left.localeCompare(right))}function parseRecurrenceRule(kv,startAt,nowValue,emptyNumericGuard){const freqRaw=kv.recur_freq?.trim();const intervalRaw=kv.recur_interval?.trim();const countRaw=kv.recur_count?.trim();const untilRaw=kv.recur_until?.trim();const byWeekdayRaw=kv.recur_by_weekday?.trim();const byMonthDayRaw=kv.recur_by_month_day?.trim();const exdatesRaw=kv.recur_exdates?.trim();const recurrenceInputsProvided=[freqRaw,intervalRaw,countRaw,untilRaw,byWeekdayRaw,byMonthDayRaw,exdatesRaw].some(value=>value!==void 0);if(!recurrenceInputsProvided){return void 0}if(!freqRaw){throw new PmCliError("--event recurrence fields require recur_freq=<daily|weekly|monthly|yearly>",EXIT_CODE.USAGE)}const freq=ensureEnumValue(freqRaw.toLowerCase(),RECURRENCE_FREQUENCY_VALUES,"event recurrence frequency");const interval=parsePositiveRecurrenceInteger(intervalRaw,"recur_interval",emptyNumericGuard);const count=parsePositiveRecurrenceInteger(countRaw,"recur_count",emptyNumericGuard);const until=parseRecurrenceUntil(untilRaw,startAt,nowValue);const byWeekday=parseRecurrenceWeekdays(byWeekdayRaw);const byMonthDay=parseRecurrenceMonthDays(byMonthDayRaw);const exdates=parseRecurrenceExdates(exdatesRaw,nowValue);return{freq,interval,count,until,by_weekday:byWeekday.length>0?byWeekday:void 0,by_month_day:byMonthDay.length>0?byMonthDay:void 0,exdates:exdates.length>0?exdates:void 0}}export{RECURRENCE_CSV_KEYS,ensureEnumValue,parseDelimitedList,parseEventBoolean,parseRecurrenceRule};
 //# sourceMappingURL=recurrence-parsers.js.map
-//# debugId=2fcfbe50-039b-5031-8b18-a208908a0d87

package/dist/sdk/lifecycle/reopen.js

@@ -1,69 +1,2 @@
-
-!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]="08dcee99-5572-5133-b76a-6a50e4e292e7")}catch(e){}}();
-import { EXIT_CODE } from "../../core/shared/constants.js";
-import { PmCliError } from "../../core/shared/errors.js";
-import { normalizeStatusInput } from "../../core/item/status.js";
-import { resolveRuntimeStatusRegistry } from "../../core/schema/runtime-schema.js";
-import { resolvePmRoot } from "../../core/store/paths.js";
-import { readSettings } from "../../core/store/settings.js";
-import { resolveStartTaskInProgressStatus } from "../start-task-status.js";
-import { runReopenUpdate, } from "./update.js";
-/** Reopen terminal work through the canonical update mutation and history path. */
-export async function runReopen(id, reason, options, global) {
-    const normalizedReason = reason.trim();
-    if (normalizedReason.length === 0) {
-        throw new PmCliError("pm item reopen requires a non-empty recurrence reason.", EXIT_CODE.USAGE, {
-            code: "reopen_reason_required",
-            required: "Describe why the terminal work became active again.",
-            recovery: {
-                suggested_retry: `pm item reopen ${id} "<recurrence reason>"`,
-                suggested_retry_args: ["item", "reopen", id, "<recurrence reason>"],
-            },
-        });
-    }
-    const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    const statusRegistry = resolveRuntimeStatusRegistry((await readSettings(pmRoot)).schema);
-    const openStatus = statusRegistry.open_status;
-    const inProgressStatus = resolveStartTaskInProgressStatus(statusRegistry);
-    const requestedStatus = options.status ?? openStatus;
-    const targetStatus = normalizeStatusInput(requestedStatus, statusRegistry) ?? requestedStatus;
-    if (targetStatus !== openStatus && targetStatus !== inProgressStatus) {
-        throw new PmCliError(`Reopen target status must be ${openStatus} or ${inProgressStatus}; received ${requestedStatus}.`, EXIT_CODE.USAGE, {
-            code: "reopen_target_status_invalid",
-            required: "Choose the workspace open or in-progress lifecycle status.",
-            recovery: {
-                allowed_values: [...new Set([openStatus, inProgressStatus])],
-                suggested_retry: `pm item reopen ${id} "${normalizedReason}" --status ${openStatus}`,
-                suggested_retry_args: [
-                    "item",
-                    "reopen",
-                    id,
-                    normalizedReason,
-                    "--status",
-                    openStatus,
-                ],
-            },
-        });
-    }
-    const update = await runReopenUpdate(id, {
-        status: targetStatus,
-        unset: [
-            "close-reason",
-            "resolution",
-            "expected-result",
-            "actual-result",
-            "fixed-version",
-        ],
-        author: options.author,
-        message: options.message,
-        force: options.force,
-    }, global, normalizedReason);
-    return {
-        item: update.item,
-        changed_fields: update.changed_fields,
-        warnings: update.warnings,
-        recurrence: update.lifecycle_transition,
-    };
-}
+!(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]="cd0e532e-0f27-5786-8216-c17132f6e784")}catch(e2){}})();import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{normalizeStatusInput}from"../../core/item/status.js";import{resolveRuntimeStatusRegistry}from"../../core/schema/runtime-schema.js";import{resolvePmRoot}from"../../core/store/paths.js";import{readSettings}from"../../core/store/settings.js";import{resolveStartTaskInProgressStatus}from"../start-task-status.js";import{runReopenUpdate}from"./update.js";async function runReopen(id,reason,options,global2){const normalizedReason=reason.trim();if(normalizedReason.length===0){throw new PmCliError("pm item reopen requires a non-empty recurrence reason.",EXIT_CODE.USAGE,{code:"reopen_reason_required",required:"Describe why the terminal work became active again.",recovery:{suggested_retry:`pm item reopen ${id} "<recurrence reason>"`,suggested_retry_args:["item","reopen",id,"<recurrence reason>"]}})}const pmRoot=resolvePmRoot(process.cwd(),global2.path);const statusRegistry=resolveRuntimeStatusRegistry((await readSettings(pmRoot)).schema);const openStatus=statusRegistry.open_status;const inProgressStatus=resolveStartTaskInProgressStatus(statusRegistry);const requestedStatus=options.status??openStatus;const targetStatus=normalizeStatusInput(requestedStatus,statusRegistry)??requestedStatus;if(targetStatus!==openStatus&&targetStatus!==inProgressStatus){throw new PmCliError(`Reopen target status must be ${openStatus} or ${inProgressStatus}; received ${requestedStatus}.`,EXIT_CODE.USAGE,{code:"reopen_target_status_invalid",required:"Choose the workspace open or in-progress lifecycle status.",recovery:{allowed_values:[...new Set([openStatus,inProgressStatus])],suggested_retry:`pm item reopen ${id} "${normalizedReason}" --status ${openStatus}`,suggested_retry_args:["item","reopen",id,normalizedReason,"--status",openStatus]}})}const update=await runReopenUpdate(id,{status:targetStatus,unset:["close-reason","resolution","expected-result","actual-result","fixed-version"],author:options.author,message:options.message,force:options.force},global2,normalizedReason);return{item:update.item,changed_fields:update.changed_fields,warnings:update.warnings,recurrence:update.lifecycle_transition}}export{runReopen};
 //# sourceMappingURL=reopen.js.map
-//# debugId=08dcee99-5572-5133-b76a-6a50e4e292e7

package/dist/sdk/lifecycle/repeatable-metadata-parsers.js

@@ -1,144 +1,2 @@
-/**
- * @module sdk/lifecycle/repeatable-metadata-parsers
- *
- * Implements the pm repeatable metadata parsers 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]="fd41d2bf-7be0-55ee-9048-a9d5092a9a21")}catch(e){}}();
-import { assertNoUnknownCsvKeys, parseCsvKv, EXIT_CODE, PmCliError, resolveIsoOrRelative, } from "../runtime-primitives.js";
-import { resolveEventEndAt } from "./event-validation-messages.js";
-import { parseEventBoolean, parseRecurrenceRule, RECURRENCE_CSV_KEYS, } from "./recurrence-parsers.js";
-/** Allowed CSV/markdown keys for `--reminder` (GH-258). */
-const REMINDER_KEYS = ["at", "date", "text", "title"];
-/** Allowed CSV/markdown keys for `--event` (GH-258). Recurrence keys are spread from the authoritative RECURRENCE_CSV_KEYS next to parseRecurrenceRule so the allow-list can never drift from what the recurrence parser actually reads. */
-const EVENT_KEYS = [
-    "start",
-    "date",
-    "end",
-    "duration",
-    "title",
-    "description",
-    "location",
-    "timezone",
-    "all_day",
-    ...RECURRENCE_CSV_KEYS,
-];
-/** Allowed CSV/markdown keys for the `--type-option` structured form (GH-258). */
-const TYPE_OPTION_KEYS = ["key", "value"];
-function optionalString(value, mode) {
-    return mode === "trimmed" ? value?.trim() : value;
-}
-function isProvided(value, guard) {
-    return guard === "defined" ? value !== undefined : Boolean(value);
-}
-/** Implements parse reminder entries for the public runtime surface of this module. */
-export function parseReminderEntries(raw, nowValue, options) {
-    return raw.map((entry) => {
-        const kv = parseCsvKv(entry, "--reminder");
-        assertNoUnknownCsvKeys(kv, "--reminder", REMINDER_KEYS);
-        const atRaw = optionalString(kv.at ?? kv.date, options.valueMode);
-        const textRaw = optionalString(kv.text ?? kv.title, options.valueMode);
-        if (!atRaw || !textRaw) {
-            throw new PmCliError("--reminder requires at=<iso|relative> or date=<iso|relative>, plus text=<value> or title=<value>", EXIT_CODE.USAGE);
-        }
-        const text = textRaw.trim();
-        if (!text) {
-            throw new PmCliError("--reminder text must not be empty", EXIT_CODE.USAGE);
-        }
-        return {
-            at: resolveIsoOrRelative(atRaw, nowValue, "reminder.at"),
-            text,
-        };
-    });
-}
-/** Implements parse event entries for the public runtime surface of this module. */
-export function parseEventEntries(raw, nowValue, options) {
-    return raw.map((entry) => {
-        const kv = parseCsvKv(entry, "--event");
-        assertNoUnknownCsvKeys(kv, "--event", EVENT_KEYS);
-        const startRaw = (kv.start ?? kv.date)?.trim();
-        if (!startRaw) {
-            throw new PmCliError("--event requires start=<iso|relative> or date=<iso|relative>", EXIT_CODE.USAGE);
-        }
-        const startAt = resolveIsoOrRelative(startRaw, nowValue, "event.start");
-        const endRaw = kv.end?.trim();
-        const durationRaw = kv.duration?.trim();
-        const endAt = resolveEventEndAt(startAt, endRaw, durationRaw, nowValue);
-        const titleRaw = kv.title;
-        const descriptionRaw = kv.description;
-        const locationRaw = kv.location;
-        const timezoneRaw = kv.timezone;
-        const title = titleRaw?.trim();
-        const description = descriptionRaw?.trim();
-        const location = locationRaw?.trim();
-        const timezone = timezoneRaw?.trim();
-        const optionalTextFields = [
-            ["title", titleRaw, title],
-            ["description", descriptionRaw, description],
-            ["location", locationRaw, location],
-            ["timezone", timezoneRaw, timezone],
-        ];
-        for (const [fieldLabel, rawValue, trimmedValue] of optionalTextFields) {
-            if (rawValue !== undefined && !trimmedValue) {
-                throw new PmCliError(`--event ${fieldLabel} must not be empty`, EXIT_CODE.USAGE);
-            }
-        }
-        const allDayRaw = kv.all_day?.trim();
-        const recurrence = parseRecurrenceRule(kv, startAt, nowValue, options.recurrenceEmptyNumericGuard);
-        const allDay = isProvided(allDayRaw, options.allDayEmptyGuard)
-            ? parseEventBoolean(allDayRaw, "--event all_day")
-            : undefined;
-        return {
-            start_at: startAt,
-            end_at: endAt,
-            title,
-            description,
-            location,
-            all_day: allDay,
-            timezone,
-            recurrence,
-        };
-    });
-}
-/** Implements parse type option entries for the public runtime surface of this module. */
-export function parseTypeOptionEntries(raw) {
-    const values = {};
-    for (const entry of raw) {
-        const trimmedEntry = entry.trim();
-        if (trimmedEntry.length === 0) {
-            throw new PmCliError("--type-option values must not be empty", EXIT_CODE.USAGE);
-        }
-        let key;
-        let value;
-        const prefersStructuredKv = trimmedEntry.includes(",") ||
-            trimmedEntry.includes("\n") ||
-            trimmedEntry.startsWith("```") ||
-            /^(?:[-*+]\s+)?(?:key|value)\s*[:=]/i.test(trimmedEntry);
-        if (prefersStructuredKv) {
-            const kv = parseCsvKv(trimmedEntry, "--type-option");
-            assertNoUnknownCsvKeys(kv, "--type-option", TYPE_OPTION_KEYS);
-            key = kv.key?.trim();
-            value = kv.value?.trim();
-        }
-        else {
-            const equalsIndex = trimmedEntry.indexOf("=");
-            const colonIndex = trimmedEntry.indexOf(":");
-            let separatorIndex = equalsIndex;
-            if (equalsIndex <= 0 && colonIndex > 0) {
-                separatorIndex = colonIndex;
-            }
-            if (separatorIndex <= 0 || separatorIndex === trimmedEntry.length - 1) {
-                throw new PmCliError("--type-option requires key=value or key=<name>,value=<value> entries", EXIT_CODE.USAGE);
-            }
-            key = trimmedEntry.slice(0, separatorIndex).trim();
-            value = trimmedEntry.slice(separatorIndex + 1).trim();
-        }
-        if (!key || !value) {
-            throw new PmCliError("--type-option requires key and value", EXIT_CODE.USAGE);
-        }
-        values[key] = value;
-    }
-    return Object.fromEntries(Object.entries(values).sort((left, right) => left[0].localeCompare(right[0])));
-}
+!(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]="dfce9924-8453-5ded-a5df-47477caa9fe7")}catch(e2){}})();import{assertNoUnknownCsvKeys,parseCsvKv,EXIT_CODE,PmCliError,resolveIsoOrRelative}from"../runtime-primitives.js";import{resolveEventEndAt}from"./event-validation-messages.js";import{parseEventBoolean,parseRecurrenceRule,RECURRENCE_CSV_KEYS}from"./recurrence-parsers.js";const REMINDER_KEYS=["at","date","text","title"];const EVENT_KEYS=["start","date","end","duration","title","description","location","timezone","all_day",...RECURRENCE_CSV_KEYS];const TYPE_OPTION_KEYS=["key","value"];function optionalString(value,mode){return mode==="trimmed"?value?.trim():value}function isProvided(value,guard){return guard==="defined"?value!==void 0:Boolean(value)}function parseReminderEntries(raw,nowValue,options){return raw.map(entry=>{const kv=parseCsvKv(entry,"--reminder");assertNoUnknownCsvKeys(kv,"--reminder",REMINDER_KEYS);const atRaw=optionalString(kv.at??kv.date,options.valueMode);const textRaw=optionalString(kv.text??kv.title,options.valueMode);if(!atRaw||!textRaw){throw new PmCliError("--reminder requires at=<iso|relative> or date=<iso|relative>, plus text=<value> or title=<value>",EXIT_CODE.USAGE)}const text=textRaw.trim();if(!text){throw new PmCliError("--reminder text must not be empty",EXIT_CODE.USAGE)}return{at:resolveIsoOrRelative(atRaw,nowValue,"reminder.at"),text}})}function parseEventEntries(raw,nowValue,options){return raw.map(entry=>{const kv=parseCsvKv(entry,"--event");assertNoUnknownCsvKeys(kv,"--event",EVENT_KEYS);const startRaw=(kv.start??kv.date)?.trim();if(!startRaw){throw new PmCliError("--event requires start=<iso|relative> or date=<iso|relative>",EXIT_CODE.USAGE)}const startAt=resolveIsoOrRelative(startRaw,nowValue,"event.start");const endRaw=kv.end?.trim();const durationRaw=kv.duration?.trim();const endAt=resolveEventEndAt(startAt,endRaw,durationRaw,nowValue);const titleRaw=kv.title;const descriptionRaw=kv.description;const locationRaw=kv.location;const timezoneRaw=kv.timezone;const title=titleRaw?.trim();const description=descriptionRaw?.trim();const location=locationRaw?.trim();const timezone=timezoneRaw?.trim();const optionalTextFields=[["title",titleRaw,title],["description",descriptionRaw,description],["location",locationRaw,location],["timezone",timezoneRaw,timezone]];for(const[fieldLabel,rawValue,trimmedValue]of optionalTextFields){if(rawValue!==void 0&&!trimmedValue){throw new PmCliError(`--event ${fieldLabel} must not be empty`,EXIT_CODE.USAGE)}}const allDayRaw=kv.all_day?.trim();const recurrence=parseRecurrenceRule(kv,startAt,nowValue,options.recurrenceEmptyNumericGuard);const allDay=isProvided(allDayRaw,options.allDayEmptyGuard)?parseEventBoolean(allDayRaw,"--event all_day"):void 0;return{start_at:startAt,end_at:endAt,title,description,location,all_day:allDay,timezone,recurrence}})}function parseTypeOptionEntries(raw){const values={};for(const entry of raw){const trimmedEntry=entry.trim();if(trimmedEntry.length===0){throw new PmCliError("--type-option values must not be empty",EXIT_CODE.USAGE)}let key;let value;const prefersStructuredKv=trimmedEntry.includes(",")||trimmedEntry.includes("\n")||trimmedEntry.startsWith("```")||/^(?:[-*+]\s+)?(?:key|value)\s*[:=]/i.test(trimmedEntry);if(prefersStructuredKv){const kv=parseCsvKv(trimmedEntry,"--type-option");assertNoUnknownCsvKeys(kv,"--type-option",TYPE_OPTION_KEYS);key=kv.key?.trim();value=kv.value?.trim()}else{const equalsIndex=trimmedEntry.indexOf("=");const colonIndex=trimmedEntry.indexOf(":");let separatorIndex=equalsIndex;if(equalsIndex<=0&&colonIndex>0){separatorIndex=colonIndex}if(separatorIndex<=0||separatorIndex===trimmedEntry.length-1){throw new PmCliError("--type-option requires key=value or key=<name>,value=<value> entries",EXIT_CODE.USAGE)}key=trimmedEntry.slice(0,separatorIndex).trim();value=trimmedEntry.slice(separatorIndex+1).trim()}if(!key||!value){throw new PmCliError("--type-option requires key and value",EXIT_CODE.USAGE)}values[key]=value}return Object.fromEntries(Object.entries(values).sort((left,right)=>left[0].localeCompare(right[0])))}export{parseEventEntries,parseReminderEntries,parseTypeOptionEntries};
 //# sourceMappingURL=repeatable-metadata-parsers.js.map
-//# debugId=fd41d2bf-7be0-55ee-9048-a9d5092a9a21

package/dist/sdk/lifecycle/restore.d.ts

@@ -37,6 +37,7 @@ export interface RestoreResult {
 /** Resolve restore targets with the command's established wording and at-or-before timestamp semantics. */
 declare function ensureReplayTarget(target: string, history: readonly HistoryEntry[]): import("../../core/history/projection.js").ResolvedHistoryTarget;
 declare function replayCurrentDocument(history: HistoryEntry[]): ItemDocument;
+/** Resolve live or deleted history and enforce the current item's stream policy before restoring a historical version. */
 declare function resolveRestoreSubject(pmRoot: string, id: string, settings: Awaited<ReturnType<typeof readSettings>>, typeToFolder: Record<string, string>): Promise<ResolvedRestoreSubject>;
 declare function changedFields(beforeDocument: ItemDocument, afterDocument: ItemDocument): string[];
 /** Implements run restore for the public runtime surface of this module. */