@unbrained/pm-cli 2026.7.2 → 2026.7.4

package/dist/cli/commands/create.d.ts

@@ -2,11 +2,12 @@ import { type ResolvedItemTypeDefinition } from "../../core/item/type-registry.j
 import { type RuntimeFieldRegistry } from "../../core/schema/runtime-schema.js";
 import type { GlobalOptions } from "../../core/shared/command-types.js";
 import { type LifecycleTransitionSuggestion } from "./lifecycle-transitions.js";
+import type { MutationMetadataCommandOptions, SharedLinkedResourceClearOptions, SharedLinkedResourceOptions } from "./mutation-command-options.js";
 import type { Comment, ItemMetadata, LinkedDoc, LinkedFile, LinkedTest, LogNote } from "../../types/index.js";
 /**
  * Documents the create command options payload exchanged by command, SDK, and package integrations.
  */
-export interface CreateCommandOptions {
+export interface CreateCommandOptions extends MutationMetadataCommandOptions, SharedLinkedResourceOptions, SharedLinkedResourceClearOptions {
     title?: string;
     description?: string;
     type?: string;
@@ -15,68 +16,10 @@ export interface CreateCommandOptions {
     tags?: string;
     addTags?: string[];
     body?: string;
-    deadline?: string;
-    estimatedMinutes?: string;
-    acceptanceCriteria?: string;
-    definitionOfReady?: string;
-    order?: string;
-    rank?: string;
-    goal?: string;
-    objective?: string;
-    value?: string;
-    impact?: string;
-    outcome?: string;
-    whyNow?: string;
-    author?: string;
-    message?: string;
-    assignee?: string;
-    parent?: string;
     allowMissingParent?: boolean;
-    reviewer?: string;
-    risk?: string;
-    confidence?: string;
-    sprint?: string;
-    release?: string;
-    blockedBy?: string;
-    blockedReason?: string;
-    unblockNote?: string;
-    reporter?: string;
-    severity?: string;
-    environment?: string;
-    reproSteps?: string;
-    resolution?: string;
-    expectedResult?: string;
-    actualResult?: string;
-    affectedVersion?: string;
-    fixedVersion?: string;
-    component?: string;
-    regression?: string;
-    customerImpact?: string;
-    dep?: string[];
-    comment?: string[];
-    note?: string[];
-    learning?: string[];
-    file?: string[];
-    test?: string[];
-    doc?: string[];
-    reminder?: string[];
-    event?: string[];
-    typeOption?: string[];
-    field?: string[];
     template?: string;
     createMode?: string;
     schedulePreset?: string;
-    unset?: string[];
-    clearDeps?: boolean;
-    clearComments?: boolean;
-    clearNotes?: boolean;
-    clearLearnings?: boolean;
-    clearFiles?: boolean;
-    clearTests?: boolean;
-    clearDocs?: boolean;
-    clearReminders?: boolean;
-    clearEvents?: boolean;
-    clearTypeOptions?: boolean;
     [key: string]: unknown;
 }
 /**

package/dist/cli/commands/create.js

@@ -4,7 +4,7 @@
  * Implements the pm create 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]="39253884-2bdf-54e5-9cf2-6ac279638287")}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]="c697cd34-7adc-574e-9180-0b0a387ca5e9")}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";
@@ -36,7 +36,7 @@ import { applyLegacyNoneCollectionNormalizers, assertNoLegacyNoneToken, assertNo
 import { suggestNextLifecycleTransition, } from "./lifecycle-transitions.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 { COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR, COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_AUTHOR, resolveRuntimeUnsetFieldDefinition, } from "./shared-unset-fields.js";
+import { COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR, COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_AUTHOR, parseCommandUnsetTargets, resolveRuntimeUnsetFieldDefinition, } from "./shared-unset-fields.js";
 import { ensureEnumValue } from "./recurrence-parsers.js";
 import { parseEventEntries, parseReminderEntries, parseTypeOptionEntries, } from "./repeatable-metadata-parsers.js";
 import { DEPENDENCY_KIND_VALUES, ISSUE_SEVERITY_VALUES, RISK_VALUES, SCOPE_VALUES, } from "../../types/index.js";
@@ -157,27 +157,11 @@ function parseOptionalString(value) {
     return value;
 }
 function parseCreateUnsetTargets(raw, runtimeFieldRegistry) {
-    const frontMatterKeys = new Set();
-    const optionKeys = new Set();
-    if (!raw || raw.length === 0) {
-        return { frontMatterKeys, optionKeys };
-    }
-    for (const entry of raw) {
-        const trimmed = entry.trim().toLowerCase();
-        if (!trimmed) {
-            throw new PmCliError("--unset values must not be empty", EXIT_CODE.USAGE);
-        }
-        if (isLegacyNoneToken(trimmed)) {
-            throw new PmCliError('--unset no longer accepts "none" or "null". Specify concrete field names such as --unset deadline', EXIT_CODE.USAGE);
-        }
-        const definition = CREATE_UNSET_ALIAS_MAP.get(trimmed) ?? resolveRuntimeUnsetFieldDefinition(trimmed, "create", runtimeFieldRegistry);
-        if (!definition) {
-            throw new PmCliError(`Unsupported --unset field "${entry}". Supported fields: ${CREATE_UNSET_SUPPORTED_CANONICAL_FIELDS}`, EXIT_CODE.USAGE);
-        }
-        frontMatterKeys.add(definition.frontMatterKey);
-        optionKeys.add(definition.optionKey);
-    }
-    return { frontMatterKeys, optionKeys };
+    return parseCommandUnsetTargets({
+        raw,
+        supportedFields: CREATE_UNSET_SUPPORTED_CANONICAL_FIELDS,
+        resolveDefinition: (trimmed) => CREATE_UNSET_ALIAS_MAP.get(trimmed) ?? resolveRuntimeUnsetFieldDefinition(trimmed, "create", runtimeFieldRegistry),
+    });
 }
 /** Allowed CSV/markdown keys for the create `--dep` seed (GH-258). */
 const DEP_SEED_KEYS = ["id", "kind", "type", "author", "created_at"];
@@ -641,6 +625,19 @@ function filterNonMissingTypeOptionErrors(errors, typeName) {
         return !match || match[2] !== typeName;
     });
 }
+function assertNoInvalidTypeOptions(errors, type, typeDefinition, statusRegistry) {
+    const nonMissingTypeOptionErrors = filterNonMissingTypeOptionErrors(errors, type);
+    if (nonMissingTypeOptionErrors.length === 0) {
+        return;
+    }
+    const nextValidExample = buildTypeSpecificCreateExample(typeDefinition, [], [], statusRegistry.open_status);
+    throw new PmCliError(nonMissingTypeOptionErrors.join("; "), EXIT_CODE.USAGE, {
+        code: "invalid_argument_value",
+        required: `Provide valid --type-option key/value pairs for type "${type}".`,
+        examples: [nextValidExample],
+        nextSteps: [`Run "pm create --help --type ${type}" to review allowed type-option keys and values.`],
+    });
+}
 function typeOptionExampleValue(typeDefinition, key) {
     const optionDefinition = typeDefinition.options.find((option) => option.key === key);
     const firstAllowed = optionDefinition?.values[0];
@@ -876,6 +873,13 @@ async function validateCreateParentReference(pmRoot, settings, typeRegistry, par
     const normalizedParentId = normalizeItemId(normalized, settings.id_prefix);
     return { parent: normalized, warnings: validateMissingParentReference(normalizedParentId, policy).warnings };
 }
+async function resolveCreateParentWithWarnings(params) {
+    if (params.parent === undefined) {
+        return { parent: undefined, warnings: [] };
+    }
+    const parentValidation = await validateCreateParentReference(params.pmRoot, params.settings, params.typeRegistry, params.parent, params.policy);
+    return parentValidation;
+}
 /**
  * Resolve a sprint or release field: `undefined` when cleared/absent, otherwise
  * the format-validated value plus any never-blocking format warnings from the
@@ -1368,16 +1372,7 @@ export async function runCreate(options, global) {
         type,
         createMode,
     });
-    const nonMissingTypeOptionErrors = filterNonMissingTypeOptionErrors(validatedTypeOptions.errors, type);
-    if (nonMissingTypeOptionErrors.length > 0) {
-        const nextValidExample = buildTypeSpecificCreateExample(typeDefinition, [], [], statusRegistry.open_status);
-        throw new PmCliError(nonMissingTypeOptionErrors.join("; "), EXIT_CODE.USAGE, {
-            code: "invalid_argument_value",
-            required: `Provide valid --type-option key/value pairs for type "${type}".`,
-            examples: [nextValidExample],
-            nextSteps: [`Run "pm create --help --type ${type}" to review allowed type-option keys and values.`],
-        });
-    }
+    assertNoInvalidTypeOptions(validatedTypeOptions.errors, type, typeDefinition, statusRegistry);
     const id = await generateItemId(pmRoot, settings.id_prefix);
     let status = resolvedOptions.status !== undefined
         ? parseStatusValue(resolvedOptions.status, statusRegistry)
@@ -1414,11 +1409,15 @@ export async function runCreate(options, global) {
         : settings.validation.parent_reference;
     const sprintReleasePolicy = settings.validation.sprint_release_format;
     const validationWarnings = collectCreateScheduleWarnings(type, id, deadline, reminders.values, events.values);
-    if (parent !== undefined) {
-        const parentValidation = await validateCreateParentReference(pmRoot, settings, typeRegistry, parent, parentReferencePolicy);
-        parent = parentValidation.parent;
-        validationWarnings.push(...parentValidation.warnings);
-    }
+    const parentValidation = await resolveCreateParentWithWarnings({
+        parent,
+        pmRoot,
+        settings,
+        typeRegistry,
+        policy: parentReferencePolicy,
+    });
+    parent = parentValidation.parent;
+    validationWarnings.push(...parentValidation.warnings);
     const sprintResolved = resolveCreateSprintOrRelease(unsetKeys, "sprint", resolvedOptions.sprint, "sprint", sprintReleasePolicy);
     const sprint = sprintResolved.value;
     validationWarnings.push(...sprintResolved.warnings);
@@ -1601,4 +1600,4 @@ export const _testOnlyCreateCommand = {
     typeOptionExampleValue,
 };
 //# sourceMappingURL=create.js.map
-//# debugId=39253884-2bdf-54e5-9cf2-6ac279638287
+//# debugId=c697cd34-7adc-574e-9180-0b0a387ca5e9