@unbrained/pm-cli 2026.5.18 → 2026.5.27

package/dist/cli/commands/create.js

@@ -1,5 +1,5 @@
 
-!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]="f593bc8f-51a3-5004-8373-9eb6a695b553")}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]="10f962f6-810b-5b40-a073-b763d0b0d8b0")}catch(e){}}();
 import { pathExists, removeFileIfExists, writeFileAtomic } from "../../core/fs/fs-utils.js";
 import { appendHistoryEntry, createHistoryEntry } from "../../core/history/history.js";
 import { generateItemId, normalizeItemId } from "../../core/item/id.js";
@@ -7,9 +7,11 @@ import { canonicalDocument, normalizeFrontMatter, serializeItemDocument } from "
 import { normalizeParentReferenceValue, validateMissingParentReference, } from "../../core/item/parent-reference-policy.js";
 import { validateSprintOrReleaseValue } from "../../core/item/sprint-release-format.js";
 import { createStdinTokenResolver, parseCsvKv, parseOptionalNumber, parseTags } from "../../core/item/parse.js";
+import { resolvePriority } from "../../core/item/priority.js";
 import { normalizeStatusInput } from "../../core/item/status.js";
 import { canonicalizeCommandOptionKey, commandOptionFlagLabel, resolveItemTypeRegistry, resolveCommandOptionPolicyState, resolveTypeDefinition, resolveTypeName, validateTypeOptions, } from "../../core/item/type-registry.js";
 import { acquireLock } from "../../core/lock/lock.js";
+import { buildInvalidTypeError } from "../../core/schema/item-types-file.js";
 import { collectRuntimeCreateFieldValues } from "../../core/schema/runtime-field-values.js";
 import { resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, } from "../../core/schema/runtime-schema.js";
 import { EXIT_CODE, FRONT_MATTER_KEY_ORDER } from "../../core/shared/constants.js";
@@ -21,12 +23,16 @@ import { locateItem } from "../../core/store/item-store.js";
 import { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
 import { readSettings } from "../../core/store/settings.js";
 import { normalizeRiskInput, normalizeSeverityInput, parseConfidenceInput, parseRegressionInput, } from "./metadata-normalizers.js";
-import { DEPENDENCY_KIND_VALUES, ISSUE_SEVERITY_VALUES, RECURRENCE_FREQUENCY_VALUES, RECURRENCE_WEEKDAY_VALUES, RISK_VALUES, SCOPE_VALUES, } from "../../types/index.js";
+import { resolveEventEndAt } from "./event-validation-messages.js";
+import { assertNoLegacyNoneToken, assertNoLegacyNoneTokens, isLegacyNoneToken } from "./legacy-none-tokens.js";
+import { parseLinkedTestAssertionEqualsMap, parseLinkedTestAssertionGteMap, parseLinkedTestBoolean, parseLinkedTestContextMode, parseLinkedTestEnvClear, parseLinkedTestEnvSet, parseLinkedTestMinLines, parseLinkedTestRegexList, parseLinkedTestStringList, } from "./linked-test-parsers.js";
+import { looksLikeStructuredLinkedTestEntry, normalizeStructuredLinkedTestEntry } from "./linked-test-entry.js";
+import { ensureEnumValue, parseEventBoolean, parseRecurrenceRule } from "./recurrence-parsers.js";
+import { DEPENDENCY_KIND_VALUES, ISSUE_SEVERITY_VALUES, RISK_VALUES, SCOPE_VALUES, } from "../../types/index.js";
 const CREATE_MODE_VALUES = ["strict", "progressive"];
 const SCHEDULE_CREATE_PRESET_VALUES = ["lightweight"];
 const SCHEDULE_CREATE_PRESET_TYPES = new Set(["Reminder", "Meeting", "Event"]);
 const LOG_SEED_ALLOWED_KEYS = new Set(["author", "created_at", "text"]);
-const LEGACY_NONE_TOKENS = new Set(["none", "null"]);
 const CREATE_UNSET_FIELD_DEFINITIONS = [
     { canonical: "tags", aliases: ["tags"], optionKey: "tags", frontMatterKey: "tags" },
     { canonical: "deadline", aliases: ["deadline"], optionKey: "deadline", frontMatterKey: "deadline" },
@@ -159,12 +165,6 @@ function buildInvalidLogSeedKeysMessage(optionName, unsupportedKeys) {
         '(for example text="first,scope:project"), use markdown-style key/value input, ' +
         `or pass ${optionName} - with piped stdin.`);
 }
-function ensureEnumValue(value, allowed, label) {
-    if (!allowed.includes(value)) {
-        throw new PmCliError(`Invalid ${label} value "${value}". Allowed: ${allowed.join(", ")}`, EXIT_CODE.USAGE);
-    }
-    return value;
-}
 function parseStatusValue(value, statusRegistry) {
     const normalized = normalizeStatusInput(value, statusRegistry);
     if (!normalized) {
@@ -183,30 +183,6 @@ function parseCreatedAt(value, currentIso) {
     }
     return new Date(parsed).toISOString();
 }
-function isLegacyNoneToken(value) {
-    if (value === undefined) {
-        return false;
-    }
-    return LEGACY_NONE_TOKENS.has(value.trim().toLowerCase());
-}
-function assertNoLegacyNoneToken(value, flag, replacementHint) {
-    if (!isLegacyNoneToken(value)) {
-        return;
-    }
-    const suffix = replacementHint ? ` ${replacementHint}` : "";
-    throw new PmCliError(`${flag} no longer accepts "none" or "null".${suffix}`.trim(), EXIT_CODE.USAGE);
-}
-function assertNoLegacyNoneTokens(values, flag, replacementHint) {
-    if (!values || values.length === 0) {
-        return;
-    }
-    const hasLegacyToken = values.some((value) => isLegacyNoneToken(value));
-    if (!hasLegacyToken) {
-        return;
-    }
-    const suffix = replacementHint ? ` ${replacementHint}` : "";
-    throw new PmCliError(`${flag} no longer accepts "none" or "null".${suffix}`.trim(), EXIT_CODE.USAGE);
-}
 const CREATE_LEGACY_NONE_COLLECTION_NORMALIZERS = [
     { optionKey: "dep", clearFlagKey: "clearDeps", valueFlag: "--dep", clearFlag: "--clear-deps" },
     { optionKey: "comment", clearFlagKey: "clearComments", valueFlag: "--comment", clearFlag: "--clear-comments" },
@@ -316,9 +292,6 @@ function parseCreateUnsetTargets(raw, runtimeFieldRegistry) {
     }
     return { frontMatterKeys, optionKeys };
 }
-function weekdayOrderIndex(value) {
-    return RECURRENCE_WEEKDAY_VALUES.indexOf(value);
-}
 function parseDependencies(raw, nowValue, prefix) {
     if (!raw || raw.length === 0)
         return { values: undefined, explicitEmpty: false };
@@ -423,202 +396,14 @@ export function parseFiles(raw) {
     });
     return { values, explicitEmpty: false };
 }
-const LINKED_TEST_PROTECTED_ENV_KEYS = new Set(["PM_PATH", "PM_GLOBAL_PATH", "FORCE_COLOR"]);
-const LINKED_TEST_ENV_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
-const LINKED_TEST_PM_CONTEXT_MODE_VALUES = ["schema", "tracker", "auto"];
-function parseLinkedTestEnvSet(raw, optionName) {
-    const normalized = parseOptionalString(raw);
-    if (!normalized) {
-        return undefined;
-    }
-    const assignments = normalized
-        .split(/[;\n]/)
-        .map((entry) => entry.trim())
-        .filter((entry) => entry.length > 0);
-    if (assignments.length === 0) {
-        throw new PmCliError(`${optionName} env_set must include at least one KEY=VALUE assignment`, EXIT_CODE.USAGE);
-    }
-    const envSet = {};
-    for (const assignment of assignments) {
-        const separatorIndex = assignment.indexOf("=");
-        if (separatorIndex <= 0) {
-            throw new PmCliError(`${optionName} env_set entries must use KEY=VALUE and be separated by semicolons. Example: env_set=PORT=0;PLAYWRIGHT_BASE_URL=http://127.0.0.1:4173`, EXIT_CODE.USAGE);
-        }
-        const key = assignment.slice(0, separatorIndex).trim();
-        const value = assignment.slice(separatorIndex + 1);
-        if (!LINKED_TEST_ENV_NAME_PATTERN.test(key)) {
-            throw new PmCliError(`${optionName} env_set key "${key}" is invalid`, EXIT_CODE.USAGE);
-        }
-        if (LINKED_TEST_PROTECTED_ENV_KEYS.has(key.toUpperCase())) {
-            throw new PmCliError(`${optionName} env_set key "${key}" is reserved for sandbox safety`, EXIT_CODE.USAGE);
-        }
-        envSet[key] = value;
-    }
-    return Object.keys(envSet).length > 0 ? envSet : undefined;
-}
-function parseLinkedTestEnvClear(raw, optionName) {
-    const normalized = parseOptionalString(raw);
-    if (!normalized) {
-        return undefined;
-    }
-    const keys = [...new Set(normalized.split(/[;,\n]/).map((entry) => entry.trim()).filter((entry) => entry.length > 0))];
-    if (keys.length === 0) {
-        throw new PmCliError(`${optionName} env_clear must include at least one environment variable name`, EXIT_CODE.USAGE);
-    }
-    for (const key of keys) {
-        if (!LINKED_TEST_ENV_NAME_PATTERN.test(key)) {
-            throw new PmCliError(`${optionName} env_clear key "${key}" is invalid`, EXIT_CODE.USAGE);
-        }
-        if (LINKED_TEST_PROTECTED_ENV_KEYS.has(key.toUpperCase())) {
-            throw new PmCliError(`${optionName} env_clear key "${key}" is reserved for sandbox safety`, EXIT_CODE.USAGE);
-        }
-    }
-    return keys;
-}
-function parseLinkedTestBoolean(raw, optionName, fieldLabel) {
-    const normalized = parseOptionalString(raw);
-    if (!normalized) {
-        return undefined;
-    }
-    const value = normalized.trim().toLowerCase();
-    if (value === "true" || value === "1" || value === "yes") {
-        return true;
-    }
-    if (value === "false" || value === "0" || value === "no") {
-        return false;
-    }
-    throw new PmCliError(`${optionName} ${fieldLabel} must be one of true|false|1|0|yes|no`, EXIT_CODE.USAGE);
-}
-function parseLinkedTestContextMode(raw, optionName) {
-    const normalized = parseOptionalString(raw);
-    if (!normalized) {
-        return undefined;
-    }
-    const value = normalized.trim().toLowerCase();
-    if (LINKED_TEST_PM_CONTEXT_MODE_VALUES.includes(value)) {
-        return value;
-    }
-    throw new PmCliError(`${optionName} pm_context_mode must be one of: ${LINKED_TEST_PM_CONTEXT_MODE_VALUES.join(", ")}`, EXIT_CODE.USAGE);
-}
-function parseLinkedTestStringList(raw) {
-    const normalized = parseOptionalString(raw);
-    if (!normalized) {
-        return undefined;
-    }
-    const values = [...new Set(normalized.split(/[;\n]/).map((entry) => entry.trim()).filter((entry) => entry.length > 0))];
-    return values.length > 0 ? values : undefined;
-}
-function parseLinkedTestRegexList(raw, optionName, fieldLabel) {
-    const values = parseLinkedTestStringList(raw);
-    if (!values || values.length === 0) {
-        return undefined;
-    }
-    for (const pattern of values) {
-        try {
-            // Validate syntax early so malformed assertions fail at mutation time.
-            new RegExp(pattern, "m");
-        }
-        catch (error) {
-            throw new PmCliError(`${optionName} ${fieldLabel} includes invalid regex "${pattern}": ${error instanceof Error ? error.message : String(error)}`, EXIT_CODE.USAGE);
-        }
-    }
-    return values;
-}
-function parseLinkedTestMinLines(raw, optionName) {
-    const normalized = parseOptionalString(raw);
-    if (!normalized) {
-        return undefined;
-    }
-    const parsed = parseOptionalNumber(normalized, "assert_stdout_min_lines");
-    if (!Number.isInteger(parsed) || parsed < 0) {
-        throw new PmCliError(`${optionName} assert_stdout_min_lines must be an integer >= 0`, EXIT_CODE.USAGE);
-    }
-    return parsed;
-}
-function parseLinkedTestAssertionEqualsMap(raw, optionName) {
-    const normalized = parseOptionalString(raw);
-    if (!normalized) {
-        return undefined;
-    }
-    const assignments = normalized
-        .split(/[;\n]/)
-        .map((entry) => entry.trim())
-        .filter((entry) => entry.length > 0);
-    if (assignments.length === 0) {
-        throw new PmCliError(`${optionName} assert_json_field_equals must include at least one path=value assignment`, EXIT_CODE.USAGE);
-    }
-    const values = {};
-    for (const assignment of assignments) {
-        const separatorIndex = assignment.indexOf("=");
-        if (separatorIndex <= 0) {
-            throw new PmCliError(`${optionName} assert_json_field_equals entries must use path=value and be separated by semicolons`, EXIT_CODE.USAGE);
-        }
-        const key = assignment.slice(0, separatorIndex).trim();
-        const value = assignment.slice(separatorIndex + 1).trim();
-        if (key.length === 0 || value.length === 0) {
-            throw new PmCliError(`${optionName} assert_json_field_equals entries must include non-empty path and value`, EXIT_CODE.USAGE);
-        }
-        values[key] = value;
-    }
-    return Object.keys(values).length > 0 ? values : undefined;
-}
-function parseLinkedTestAssertionGteMap(raw, optionName) {
-    const normalized = parseOptionalString(raw);
-    if (!normalized) {
-        return undefined;
-    }
-    const assignments = normalized
-        .split(/[;\n]/)
-        .map((entry) => entry.trim())
-        .filter((entry) => entry.length > 0);
-    if (assignments.length === 0) {
-        throw new PmCliError(`${optionName} assert_json_field_gte must include at least one path=value assignment`, EXIT_CODE.USAGE);
-    }
-    const values = {};
-    for (const assignment of assignments) {
-        const separatorIndex = assignment.indexOf("=");
-        if (separatorIndex <= 0) {
-            throw new PmCliError(`${optionName} assert_json_field_gte entries must use path=value and be separated by semicolons`, EXIT_CODE.USAGE);
-        }
-        const key = assignment.slice(0, separatorIndex).trim();
-        const valueRaw = assignment.slice(separatorIndex + 1).trim();
-        if (key.length === 0 || valueRaw.length === 0) {
-            throw new PmCliError(`${optionName} assert_json_field_gte entries must include non-empty path and value`, EXIT_CODE.USAGE);
-        }
-        const value = Number.parseFloat(valueRaw);
-        if (!Number.isFinite(value)) {
-            throw new PmCliError(`${optionName} assert_json_field_gte value for "${key}" must be numeric`, EXIT_CODE.USAGE);
-        }
-        values[key] = value;
-    }
-    return Object.keys(values).length > 0 ? values : undefined;
-}
 export function parseTests(raw) {
     if (!raw || raw.length === 0)
         return { values: undefined, explicitEmpty: false };
     assertNoLegacyNoneTokens(raw, "--test", "Use --clear-tests to clear linked tests.");
     const values = raw.map((entry) => {
         const trimmedEntry = entry.trim();
-        const kv = looksLikeStructuredEntry(trimmedEntry, [
-            "command",
-            "path",
-            "scope",
-            "timeout",
-            "timeout_seconds",
-            "pm_context_mode",
-            "env_set",
-            "env_clear",
-            "shared_host_safe",
-            "assert_stdout_contains",
-            "assert_stdout_regex",
-            "assert_stderr_contains",
-            "assert_stderr_regex",
-            "assert_stdout_min_lines",
-            "assert_json_field_equals",
-            "assert_json_field_gte",
-            "note",
-        ])
-            ? parseCsvKv(entry, "--test")
+        const kv = looksLikeStructuredLinkedTestEntry(trimmedEntry)
+            ? normalizeStructuredLinkedTestEntry(parseCsvKv(entry, "--test"), "--test")
             : { command: trimmedEntry };
         const command = parseOptionalString(kv.command);
         const filePath = parseOptionalString(kv.path);
@@ -678,10 +463,10 @@ function parseReminders(raw, nowValue) {
     assertNoLegacyNoneTokens(raw, "--reminder", "Use --clear-reminders to clear reminders.");
     const values = raw.map((entry) => {
         const kv = parseCsvKv(entry, "--reminder");
-        const atRaw = parseOptionalString(kv.at);
-        const textRaw = parseOptionalString(kv.text);
+        const atRaw = parseOptionalString(kv.at ?? kv.date);
+        const textRaw = parseOptionalString(kv.text ?? kv.title);
         if (!atRaw || !textRaw) {
-            throw new PmCliError("--reminder requires at=<iso|relative> and text=<value>", EXIT_CODE.USAGE);
+            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) {
@@ -694,73 +479,6 @@ function parseReminders(raw, nowValue) {
     });
     return { values, explicitEmpty: false };
 }
-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 parseRecurrenceRule(kv, startAt, nowValue) {
-    const freqRaw = parseOptionalString(kv.recur_freq)?.trim();
-    const intervalRaw = parseOptionalString(kv.recur_interval)?.trim();
-    const countRaw = parseOptionalString(kv.recur_count)?.trim();
-    const untilRaw = parseOptionalString(kv.recur_until)?.trim();
-    const byWeekdayRaw = parseOptionalString(kv.recur_by_weekday)?.trim();
-    const byMonthDayRaw = parseOptionalString(kv.recur_by_month_day)?.trim();
-    const exdatesRaw = parseOptionalString(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 = intervalRaw !== undefined ? parseOptionalNumber(intervalRaw, "event recur_interval") : undefined;
-    if (interval !== undefined && (!Number.isInteger(interval) || interval < 1)) {
-        throw new PmCliError("--event recur_interval must be an integer >= 1", EXIT_CODE.USAGE);
-    }
-    const count = countRaw !== undefined ? parseOptionalNumber(countRaw, "event recur_count") : undefined;
-    if (count !== undefined && (!Number.isInteger(count) || count < 1)) {
-        throw new PmCliError("--event recur_count must be an integer >= 1", EXIT_CODE.USAGE);
-    }
-    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);
-    }
-    const byWeekday = Array.from(new Set(parseDelimitedList(byWeekdayRaw).map((value) => ensureEnumValue(value.toLowerCase(), RECURRENCE_WEEKDAY_VALUES, "event weekday")))).sort((left, right) => weekdayOrderIndex(left) -
-        weekdayOrderIndex(right));
-    const byMonthDay = Array.from(new Set(parseDelimitedList(byMonthDayRaw).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);
-    const exdates = Array.from(new Set(parseDelimitedList(exdatesRaw).map((value) => resolveIsoOrRelative(value, nowValue, "event.recur_exdates")))).sort((left, right) => left.localeCompare(right));
-    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 parseEvents(raw, nowValue) {
     if (!raw || raw.length === 0)
         return { values: undefined, explicitEmpty: false };
@@ -774,10 +492,8 @@ function parseEvents(raw, nowValue) {
         }
         const startAt = resolveIsoOrRelative(startRaw, referenceDate, "event.start");
         const endRaw = parseOptionalString(kv.end)?.trim();
-        const endAt = endRaw ? resolveIsoOrRelative(endRaw, referenceDate, "event.end") : undefined;
-        if (endAt && endAt <= startAt) {
-            throw new PmCliError("--event end must be after start", EXIT_CODE.USAGE);
-        }
+        const durationRaw = parseOptionalString(kv.duration)?.trim();
+        const endAt = resolveEventEndAt(startAt, endRaw, durationRaw, referenceDate);
         const titleRaw = parseOptionalString(kv.title);
         const descriptionRaw = parseOptionalString(kv.description);
         const locationRaw = parseOptionalString(kv.location);
@@ -799,7 +515,7 @@ function parseEvents(raw, nowValue) {
             throw new PmCliError("--event timezone must not be empty", EXIT_CODE.USAGE);
         }
         const allDayRaw = parseOptionalString(kv.all_day)?.trim();
-        const recurrence = parseRecurrenceRule(kv, startAt, referenceDate);
+        const recurrence = parseRecurrenceRule(kv, startAt, referenceDate, "defined");
         return {
             start_at: startAt,
             end_at: endAt,
@@ -813,10 +529,10 @@ function parseEvents(raw, nowValue) {
     });
     return { values, explicitEmpty: false };
 }
-function buildChangedFields(frontMatter, explicitUnsets) {
+function buildChangedFields(frontMatter, body, explicitUnsets) {
     const changed = [
         ...FRONT_MATTER_KEY_ORDER.filter((key) => frontMatter[key] !== undefined),
-        "body",
+        ...(body.length > 0 ? ["body"] : []),
         ...explicitUnsets.map((key) => `unset:${key}`),
     ];
     return Array.from(new Set(changed));
@@ -1127,11 +843,7 @@ function selectAuthor(explicitAuthor, settingsAuthor) {
     return trimmed || "unknown";
 }
 function ensurePriority(rawPriority) {
-    const parsed = parseOptionalNumber(rawPriority, "priority (expected 0..4: 0=critical, 1=high, 2=medium, 3=low, 4=minimal)");
-    if (![0, 1, 2, 3, 4].includes(parsed)) {
-        throw new PmCliError("Priority must be 0..4 (0=critical, 1=high, 2=medium, 3=low, 4=minimal)", EXIT_CODE.USAGE);
-    }
-    return parsed;
+    return resolvePriority(rawPriority);
 }
 function mergeCreateOptionsWithTemplate(templateOptions, explicitOptions) {
     const merged = {};
@@ -1244,7 +956,7 @@ export async function runCreate(options, global) {
     }
     const resolvedTypeName = resolveTypeName(resolvedOptions.type, typeRegistry);
     if (!resolvedTypeName) {
-        throw new PmCliError(`Invalid type value "${resolvedOptions.type}". Allowed: ${typeRegistry.types.join(", ")}`, EXIT_CODE.USAGE);
+        throw new PmCliError(buildInvalidTypeError(resolvedOptions.type, typeRegistry.types), EXIT_CODE.USAGE);
     }
     const typeDefinition = resolveTypeDefinition(resolvedTypeName, typeRegistry);
     if (!typeDefinition) {
@@ -1498,7 +1210,7 @@ export async function runCreate(options, global) {
         });
     }
     const id = await generateItemId(pmRoot, settings.id_prefix);
-    const status = resolvedOptions.status !== undefined ? parseStatusValue(resolvedOptions.status, statusRegistry) : statusRegistry.open_status;
+    let status = resolvedOptions.status !== undefined ? parseStatusValue(resolvedOptions.status, statusRegistry) : statusRegistry.open_status;
     const priority = resolvedOptions.priority !== undefined ? ensurePriority(resolvedOptions.priority) : 2;
     const tags = unsetTargets.frontMatterKeys.has("tags")
         ? []
@@ -1572,6 +1284,10 @@ export async function runCreate(options, global) {
     const parentReferencePolicy = settings.validation.parent_reference;
     const sprintReleasePolicy = settings.validation.sprint_release_format;
     const validationWarnings = [];
+    // Event-type items with no attached schedule never surface on the calendar; warn (never block).
+    if (type.toLowerCase() === "event" && (events.values === undefined || events.values.length === 0)) {
+        validationWarnings.push(`event_without_schedule:${id}:no_time_set`);
+    }
     if (parent !== undefined) {
         parent = normalizeParentReferenceValue(parent);
         const parentLocated = await locateItem(pmRoot, parent, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);
@@ -1599,6 +1315,30 @@ export async function runCreate(options, global) {
     const blockedBy = unsetTargets.frontMatterKeys.has("blocked_by") || resolvedOptions.blockedBy === undefined
         ? undefined
         : parseOptionalString(resolvedOptions.blockedBy);
+    let dependencyValues = dependencies.values;
+    if (blockedBy !== undefined) {
+        const normalizedBlockedBy = normalizeItemId(blockedBy, settings.id_prefix);
+        const blockedByLocated = await locateItem(pmRoot, normalizedBlockedBy, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);
+        if (blockedByLocated) {
+            const hasBlockedByDependency = (dependencyValues ?? []).some((dependency) => dependency.id === blockedByLocated.id && dependency.kind === "blocked_by");
+            if (!hasBlockedByDependency) {
+                dependencyValues = [
+                    ...(dependencyValues ?? []),
+                    {
+                        id: blockedByLocated.id,
+                        kind: "blocked_by",
+                        created_at: nowValue,
+                        author,
+                    },
+                ];
+            }
+            if (resolvedOptions.status === undefined) {
+                status = statusRegistry.blocked_statuses.has("blocked")
+                    ? "blocked"
+                    : [...statusRegistry.blocked_statuses].sort((left, right) => left.localeCompare(right))[0] ?? statusRegistry.open_status;
+            }
+        }
+    }
     const blockedReason = unsetTargets.frontMatterKeys.has("blocked_reason") || resolvedOptions.blockedReason === undefined
         ? undefined
         : parseOptionalString(resolvedOptions.blockedReason);
@@ -1691,7 +1431,7 @@ export async function runCreate(options, global) {
         component,
         regression,
         customer_impact: customerImpact,
-        dependencies: dependencies.values,
+        dependencies: dependencyValues,
         comments: comments.values,
         notes: notes.values,
         learnings: learnings.values,
@@ -1755,7 +1495,7 @@ export async function runCreate(options, global) {
     finally {
         await lockRelease();
     }
-    const changedFields = buildChangedFields(frontMatter, explicitUnsetKeys);
+    const changedFields = buildChangedFields(frontMatter, body, explicitUnsetKeys);
     const outputItem = structuredClone(frontMatter);
     return {
         item: outputItem,
@@ -1764,4 +1504,4 @@ export async function runCreate(options, global) {
     };
 }
 //# sourceMappingURL=create.js.map
-//# debugId=f593bc8f-51a3-5004-8373-9eb6a695b553
+//# debugId=10f962f6-810b-5b40-a073-b763d0b0d8b0