@unbrained/pm-cli 2026.6.23 → 2026.6.30

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

@@ -94,12 +94,7 @@ export interface UpdateResult {
     warnings: string[];
     audit_update?: boolean;
 }
-interface UpdateUnsetFieldDefinition {
-    optionKey: string;
-    frontMatterKey: string;
-}
 declare function normalizeLegacyNoneUpdateOptions(options: UpdateCommandOptions): UpdateCommandOptions;
-declare function resolveRuntimeUnsetDefinition(token: string, runtimeFieldRegistry: RuntimeFieldRegistry | undefined): UpdateUnsetFieldDefinition | undefined;
 declare function parseUpdateUnsetTargets(raw: string[] | undefined, runtimeFieldRegistry?: RuntimeFieldRegistry, extensionFieldNames?: readonly string[]): {
     frontMatterKeys: Set<string>;
     optionKeys: Set<string>;
@@ -161,6 +156,6 @@ export declare const _testOnlyUpdateCommand: {
     parseDependencyRemovals: typeof parseDependencyRemovals;
     parseUpdateUnsetTargets: typeof parseUpdateUnsetTargets;
     reconcileBlockedByDependency: typeof reconcileBlockedByDependency;
-    resolveRuntimeUnsetDefinition: typeof resolveRuntimeUnsetDefinition;
+    resolveRuntimeUnsetDefinition: (token: string, registry: RuntimeFieldRegistry | undefined) => import("./shared-unset-fields.js").RuntimeUnsetFieldDefinition | undefined;
 };
 export {};

package/dist/cli/commands/update.js

@@ -4,7 +4,7 @@
  * Implements the pm update 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]="d2ccc413-72f7-567b-b533-3bfa002cf260")}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]="87aa6b2c-8735-58a6-b263-b310f37494b9")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { canonicalizeCommandOptionKey, commandOptionFlagLabel, resolveItemTypeRegistry, resolveCommandOptionPolicyState, resolveTypeDefinition, resolveTypeName, validateTypeOptions, } from "../../core/item/type-registry.js";
 import { normalizeItemId } from "../../core/item/id.js";
@@ -29,117 +29,17 @@ import { getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
 import { readSettings } from "../../core/store/settings.js";
 import { runClose } from "./close.js";
 import { normalizeRiskInput, normalizeSeverityInput, parseConfidenceInput, parseRegressionInput, } from "./metadata-normalizers.js";
-import { assertNoLegacyNoneToken, assertNoLegacyNoneTokens, isLegacyNoneToken } from "./legacy-none-tokens.js";
+import { applyLegacyNoneCollectionNormalizers, assertNoLegacyNoneToken, assertNoLegacyNoneTokens, isLegacyNoneToken, } from "./legacy-none-tokens.js";
 import { ensureEnumValue as ensureEnum } from "./recurrence-parsers.js";
 import { parseEventEntries, parseReminderEntries, parseTypeOptionEntries, } from "./repeatable-metadata-parsers.js";
 import { DEPENDENCY_KIND_VALUES, ISSUE_SEVERITY_VALUES, RISK_VALUES, } from "../../types/index.js";
 import { parseDocs, parseFiles, parseLogSeed, parseTests } from "./create.js";
+import { COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR, COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR, COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON, resolveRuntimeUnsetFieldDefinition, } from "./shared-unset-fields.js";
 const UPDATE_UNSET_FIELD_DEFINITIONS = [
-    { canonical: "tags", aliases: ["tags"], optionKey: "tags", frontMatterKey: "tags" },
+    ...COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON,
     { canonical: "close-reason", aliases: ["close_reason", "close-reason"], optionKey: "closeReason", frontMatterKey: "close_reason" },
-    { canonical: "deadline", aliases: ["deadline"], optionKey: "deadline", frontMatterKey: "deadline" },
-    {
-        canonical: "estimate",
-        aliases: ["estimate", "estimated_minutes", "estimated-minutes"],
-        optionKey: "estimatedMinutes",
-        frontMatterKey: "estimated_minutes",
-    },
-    {
-        canonical: "acceptance-criteria",
-        aliases: ["acceptance_criteria", "acceptance-criteria", "ac"],
-        optionKey: "acceptanceCriteria",
-        frontMatterKey: "acceptance_criteria",
-    },
-    {
-        canonical: "definition-of-ready",
-        aliases: ["definition_of_ready", "definition-of-ready"],
-        optionKey: "definitionOfReady",
-        frontMatterKey: "definition_of_ready",
-    },
-    { canonical: "order", aliases: ["order", "rank"], optionKey: "order", frontMatterKey: "order" },
-    { canonical: "goal", aliases: ["goal"], optionKey: "goal", frontMatterKey: "goal" },
-    { canonical: "objective", aliases: ["objective"], optionKey: "objective", frontMatterKey: "objective" },
-    { canonical: "value", aliases: ["value"], optionKey: "value", frontMatterKey: "value" },
-    { canonical: "impact", aliases: ["impact"], optionKey: "impact", frontMatterKey: "impact" },
-    { canonical: "outcome", aliases: ["outcome"], optionKey: "outcome", frontMatterKey: "outcome" },
-    { canonical: "why-now", aliases: ["why_now", "why-now"], optionKey: "whyNow", frontMatterKey: "why_now" },
-    { canonical: "assignee", aliases: ["assignee"], optionKey: "assignee", frontMatterKey: "assignee" },
-    { canonical: "parent", aliases: ["parent"], optionKey: "parent", frontMatterKey: "parent" },
-    { canonical: "reviewer", aliases: ["reviewer"], optionKey: "reviewer", frontMatterKey: "reviewer" },
-    { canonical: "risk", aliases: ["risk"], optionKey: "risk", frontMatterKey: "risk" },
-    { canonical: "confidence", aliases: ["confidence"], optionKey: "confidence", frontMatterKey: "confidence" },
-    { canonical: "sprint", aliases: ["sprint"], optionKey: "sprint", frontMatterKey: "sprint" },
-    { canonical: "release", aliases: ["release"], optionKey: "release", frontMatterKey: "release" },
-    {
-        canonical: "blocked-by",
-        aliases: ["blocked_by", "blocked-by"],
-        optionKey: "blockedBy",
-        frontMatterKey: "blocked_by",
-    },
-    {
-        canonical: "blocked-reason",
-        aliases: ["blocked_reason", "blocked-reason"],
-        optionKey: "blockedReason",
-        frontMatterKey: "blocked_reason",
-    },
-    {
-        canonical: "unblock-note",
-        aliases: ["unblock_note", "unblock-note"],
-        optionKey: "unblockNote",
-        frontMatterKey: "unblock_note",
-    },
-    { canonical: "reporter", aliases: ["reporter"], optionKey: "reporter", frontMatterKey: "reporter" },
-    { canonical: "severity", aliases: ["severity"], optionKey: "severity", frontMatterKey: "severity" },
-    {
-        canonical: "environment",
-        aliases: ["environment"],
-        optionKey: "environment",
-        frontMatterKey: "environment",
-    },
-    {
-        canonical: "repro-steps",
-        aliases: ["repro_steps", "repro-steps"],
-        optionKey: "reproSteps",
-        frontMatterKey: "repro_steps",
-    },
-    {
-        canonical: "resolution",
-        aliases: ["resolution"],
-        optionKey: "resolution",
-        frontMatterKey: "resolution",
-    },
-    {
-        canonical: "expected-result",
-        aliases: ["expected_result", "expected-result"],
-        optionKey: "expectedResult",
-        frontMatterKey: "expected_result",
-    },
-    {
-        canonical: "actual-result",
-        aliases: ["actual_result", "actual-result"],
-        optionKey: "actualResult",
-        frontMatterKey: "actual_result",
-    },
-    {
-        canonical: "affected-version",
-        aliases: ["affected_version", "affected-version"],
-        optionKey: "affectedVersion",
-        frontMatterKey: "affected_version",
-    },
-    {
-        canonical: "fixed-version",
-        aliases: ["fixed_version", "fixed-version"],
-        optionKey: "fixedVersion",
-        frontMatterKey: "fixed_version",
-    },
-    { canonical: "component", aliases: ["component"], optionKey: "component", frontMatterKey: "component" },
-    { canonical: "regression", aliases: ["regression"], optionKey: "regression", frontMatterKey: "regression" },
-    {
-        canonical: "customer-impact",
-        aliases: ["customer_impact", "customer-impact"],
-        optionKey: "customerImpact",
-        frontMatterKey: "customer_impact",
-    },
+    ...COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR,
+    ...COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR,
 ];
 const UPDATE_UNSET_ALIAS_MAP = (() => {
     const map = new Map();
@@ -180,12 +80,12 @@ function toAuthor(candidate, defaultAuthor) {
     return trimmed || "unknown";
 }
 const UPDATE_LEGACY_NONE_COLLECTION_NORMALIZERS = [
-    { optionKey: "dep", clearFlagKey: "clearDeps", valueFlag: "--dep", clearFlag: "--clear-deps", disableReplaceFlagKey: "replaceDeps" },
+    { optionKey: "dep", clearFlagKey: "clearDeps", valueFlag: "--dep", clearFlag: "--clear-deps", disableFlagKey: "replaceDeps" },
     { optionKey: "comment", clearFlagKey: "clearComments", valueFlag: "--comment", clearFlag: "--clear-comments" },
     { optionKey: "note", clearFlagKey: "clearNotes", valueFlag: "--note", clearFlag: "--clear-notes" },
     { optionKey: "learning", clearFlagKey: "clearLearnings", valueFlag: "--learning", clearFlag: "--clear-learnings" },
     { optionKey: "file", clearFlagKey: "clearFiles", valueFlag: "--file", clearFlag: "--clear-files" },
-    { optionKey: "test", clearFlagKey: "clearTests", valueFlag: "--test", clearFlag: "--clear-tests", disableReplaceFlagKey: "replaceTests" },
+    { optionKey: "test", clearFlagKey: "clearTests", valueFlag: "--test", clearFlag: "--clear-tests", disableFlagKey: "replaceTests" },
     { optionKey: "doc", clearFlagKey: "clearDocs", valueFlag: "--doc", clearFlag: "--clear-docs" },
     { optionKey: "reminder", clearFlagKey: "clearReminders", valueFlag: "--reminder", clearFlag: "--clear-reminders" },
     { optionKey: "event", clearFlagKey: "clearEvents", valueFlag: "--event", clearFlag: "--clear-events" },
@@ -217,52 +117,7 @@ function normalizeLegacyNoneUpdateOptions(options) {
         normalized[optionKey] = undefined;
         /* c8 ignore stop */
     }
-    for (const definition of UPDATE_LEGACY_NONE_COLLECTION_NORMALIZERS) {
-        const entries = normalized[definition.optionKey];
-        if (!Array.isArray(entries) || entries.length === 0) {
-            continue;
-        }
-        const hasLegacy = entries.some((entry) => isLegacyNoneToken(entry));
-        if (!hasLegacy) {
-            continue;
-        }
-        const concreteEntries = entries.filter((entry) => !isLegacyNoneToken(entry));
-        if (concreteEntries.length > 0) {
-            throw new PmCliError(`Cannot mix legacy clear token "none"/"null" with concrete ${definition.valueFlag} entries. Use ${definition.clearFlag} to clear or provide explicit entries.`, EXIT_CODE.USAGE);
-        }
-        normalized[definition.optionKey] = undefined;
-        normalized[definition.clearFlagKey] = true;
-        if (definition.disableReplaceFlagKey) {
-            normalized[definition.disableReplaceFlagKey] = false;
-        }
-    }
-    return normalized;
-}
-function resolveRuntimeUnsetDefinition(token, runtimeFieldRegistry) {
-    if (!runtimeFieldRegistry) {
-        return undefined;
-    }
-    for (const definition of runtimeFieldRegistry.definitions) {
-        if (definition.allow_unset === false) {
-            continue;
-        }
-        const candidates = new Set([
-            definition.key,
-            definition.metadata_key,
-            definition.cli_flag.replaceAll("-", "_"),
-            definition.cli_flag,
-            ...definition.cli_aliases.map((alias) => alias.replaceAll("-", "_")),
-            ...definition.cli_aliases,
-        ]);
-        if (!candidates.has(token)) {
-            continue;
-        }
-        return {
-            optionKey: definition.key,
-            frontMatterKey: definition.metadata_key,
-        };
-    }
-    return undefined;
+    return applyLegacyNoneCollectionNormalizers(normalized, UPDATE_LEGACY_NONE_COLLECTION_NORMALIZERS);
 }
 function parseUpdateUnsetTargets(raw, runtimeFieldRegistry, extensionFieldNames = []) {
     const frontMatterKeys = new Set();
@@ -285,7 +140,7 @@ function parseUpdateUnsetTargets(raw, runtimeFieldRegistry, extensionFieldNames
                 normalizedFieldName.replaceAll("-", "_") === trimmed);
         });
         const definition = UPDATE_UNSET_ALIAS_MAP.get(trimmed) ??
-            resolveRuntimeUnsetDefinition(trimmed, runtimeFieldRegistry) ??
+            resolveRuntimeUnsetFieldDefinition(trimmed, "update", runtimeFieldRegistry) ??
             (extensionFieldName ? { optionKey: "field", frontMatterKey: extensionFieldName } : undefined);
         if (!definition) {
             throw new PmCliError(`Unsupported --unset field "${entry}". Supported fields: ${UPDATE_UNSET_SUPPORTED_CANONICAL_FIELDS}`, EXIT_CODE.USAGE);
@@ -1803,7 +1658,7 @@ export const _testOnlyUpdateCommand = {
     parseDependencyRemovals,
     parseUpdateUnsetTargets,
     reconcileBlockedByDependency,
-    resolveRuntimeUnsetDefinition,
+    resolveRuntimeUnsetDefinition: (token, registry) => resolveRuntimeUnsetFieldDefinition(token, "update", registry),
 };
 //# sourceMappingURL=update.js.map
-//# debugId=d2ccc413-72f7-567b-b533-3bfa002cf260
+//# debugId=87aa6b2c-8735-58a6-b263-b310f37494b9