@unbrained/pm-cli 2026.11.3 → 2026.11.5

package/dist/sdk/lifecycle/shared-unset-fields.d.ts

@@ -18,13 +18,637 @@ metadataKey:string;
 /** `--unset` spellings that clear `close_reason`, shared by the update parser and the routed-close governance guard. */
 export declare const CLOSE_REASON_UNSET_ALIASES:readonly string[];
 /** Public contract for common unset field definitions before close reason, shared by SDK and presentation-layer consumers. */
-export declare const COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON:readonly CommandUnsetFieldDefinition[];
+export declare const COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON:readonly [{
+readonly canonical:"tags";
+readonly aliases:readonly ["tags"];
+readonly optionKey:"tags";
+readonly metadataKey:"tags";
+}];
 /** Public contract for common unset field definitions after close reason before author, shared by SDK and presentation-layer consumers. */
-export declare const COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR:readonly CommandUnsetFieldDefinition[];
+export declare const COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR:readonly [{
+readonly canonical:"deadline";
+readonly aliases:readonly ["deadline"];
+readonly optionKey:"deadline";
+readonly metadataKey:"deadline";
+},{
+readonly canonical:"estimate";
+readonly aliases:readonly ["estimate","estimated_minutes","estimated-minutes"];
+readonly optionKey:"estimatedMinutes";
+readonly metadataKey:"estimated_minutes";
+},{
+readonly canonical:"acceptance-criteria";
+readonly aliases:readonly ["acceptance_criteria","acceptance-criteria","ac"];
+readonly optionKey:"acceptanceCriteria";
+readonly metadataKey:"acceptance_criteria";
+},{
+readonly canonical:"definition-of-ready";
+readonly aliases:readonly ["definition_of_ready","definition-of-ready"];
+readonly optionKey:"definitionOfReady";
+readonly metadataKey:"definition_of_ready";
+},{
+readonly canonical:"order";
+readonly aliases:readonly ["order","rank"];
+readonly optionKey:"order";
+readonly metadataKey:"order";
+},{
+readonly canonical:"goal";
+readonly aliases:readonly ["goal"];
+readonly optionKey:"goal";
+readonly metadataKey:"goal";
+},{
+readonly canonical:"objective";
+readonly aliases:readonly ["objective"];
+readonly optionKey:"objective";
+readonly metadataKey:"objective";
+},{
+readonly canonical:"value";
+readonly aliases:readonly ["value"];
+readonly optionKey:"value";
+readonly metadataKey:"value";
+},{
+readonly canonical:"impact";
+readonly aliases:readonly ["impact"];
+readonly optionKey:"impact";
+readonly metadataKey:"impact";
+},{
+readonly canonical:"outcome";
+readonly aliases:readonly ["outcome"];
+readonly optionKey:"outcome";
+readonly metadataKey:"outcome";
+},{
+readonly canonical:"why-now";
+readonly aliases:readonly ["why_now","why-now"];
+readonly optionKey:"whyNow";
+readonly metadataKey:"why_now";
+}];
 /** Public contract for common unset field definitions before author, shared by SDK and presentation-layer consumers. */
-export declare const COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_AUTHOR:readonly CommandUnsetFieldDefinition[];
+export declare const COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_AUTHOR:readonly [{
+readonly canonical:"tags";
+readonly aliases:readonly ["tags"];
+readonly optionKey:"tags";
+readonly metadataKey:"tags";
+},{
+readonly canonical:"deadline";
+readonly aliases:readonly ["deadline"];
+readonly optionKey:"deadline";
+readonly metadataKey:"deadline";
+},{
+readonly canonical:"estimate";
+readonly aliases:readonly ["estimate","estimated_minutes","estimated-minutes"];
+readonly optionKey:"estimatedMinutes";
+readonly metadataKey:"estimated_minutes";
+},{
+readonly canonical:"acceptance-criteria";
+readonly aliases:readonly ["acceptance_criteria","acceptance-criteria","ac"];
+readonly optionKey:"acceptanceCriteria";
+readonly metadataKey:"acceptance_criteria";
+},{
+readonly canonical:"definition-of-ready";
+readonly aliases:readonly ["definition_of_ready","definition-of-ready"];
+readonly optionKey:"definitionOfReady";
+readonly metadataKey:"definition_of_ready";
+},{
+readonly canonical:"order";
+readonly aliases:readonly ["order","rank"];
+readonly optionKey:"order";
+readonly metadataKey:"order";
+},{
+readonly canonical:"goal";
+readonly aliases:readonly ["goal"];
+readonly optionKey:"goal";
+readonly metadataKey:"goal";
+},{
+readonly canonical:"objective";
+readonly aliases:readonly ["objective"];
+readonly optionKey:"objective";
+readonly metadataKey:"objective";
+},{
+readonly canonical:"value";
+readonly aliases:readonly ["value"];
+readonly optionKey:"value";
+readonly metadataKey:"value";
+},{
+readonly canonical:"impact";
+readonly aliases:readonly ["impact"];
+readonly optionKey:"impact";
+readonly metadataKey:"impact";
+},{
+readonly canonical:"outcome";
+readonly aliases:readonly ["outcome"];
+readonly optionKey:"outcome";
+readonly metadataKey:"outcome";
+},{
+readonly canonical:"why-now";
+readonly aliases:readonly ["why_now","why-now"];
+readonly optionKey:"whyNow";
+readonly metadataKey:"why_now";
+}];
 /** Public contract for common unset field definitions after author, shared by SDK and presentation-layer consumers. */
-export declare const COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR:readonly CommandUnsetFieldDefinition[];
+export declare const COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR:readonly [{
+readonly canonical:"assignee";
+readonly aliases:readonly ["assignee"];
+readonly optionKey:"assignee";
+readonly metadataKey:"assignee";
+},{
+readonly canonical:"parent";
+readonly aliases:readonly ["parent"];
+readonly optionKey:"parent";
+readonly metadataKey:"parent";
+},{
+readonly canonical:"reviewer";
+readonly aliases:readonly ["reviewer"];
+readonly optionKey:"reviewer";
+readonly metadataKey:"reviewer";
+},{
+readonly canonical:"risk";
+readonly aliases:readonly ["risk"];
+readonly optionKey:"risk";
+readonly metadataKey:"risk";
+},{
+readonly canonical:"confidence";
+readonly aliases:readonly ["confidence"];
+readonly optionKey:"confidence";
+readonly metadataKey:"confidence";
+},{
+readonly canonical:"sprint";
+readonly aliases:readonly ["sprint"];
+readonly optionKey:"sprint";
+readonly metadataKey:"sprint";
+},{
+readonly canonical:"release";
+readonly aliases:readonly ["release"];
+readonly optionKey:"release";
+readonly metadataKey:"release";
+},{
+readonly canonical:"blocked-by";
+readonly aliases:readonly ["blocked_by","blocked-by"];
+readonly optionKey:"blockedBy";
+readonly metadataKey:"blocked_by";
+},{
+readonly canonical:"blocked-reason";
+readonly aliases:readonly ["blocked_reason","blocked-reason"];
+readonly optionKey:"blockedReason";
+readonly metadataKey:"blocked_reason";
+},{
+readonly canonical:"unblock-note";
+readonly aliases:readonly ["unblock_note","unblock-note"];
+readonly optionKey:"unblockNote";
+readonly metadataKey:"unblock_note";
+},{
+readonly canonical:"reporter";
+readonly aliases:readonly ["reporter"];
+readonly optionKey:"reporter";
+readonly metadataKey:"reporter";
+},{
+readonly canonical:"severity";
+readonly aliases:readonly ["severity"];
+readonly optionKey:"severity";
+readonly metadataKey:"severity";
+},{
+readonly canonical:"environment";
+readonly aliases:readonly ["environment"];
+readonly optionKey:"environment";
+readonly metadataKey:"environment";
+},{
+readonly canonical:"repro-steps";
+readonly aliases:readonly ["repro_steps","repro-steps"];
+readonly optionKey:"reproSteps";
+readonly metadataKey:"repro_steps";
+},{
+readonly canonical:"resolution";
+readonly aliases:readonly ["resolution"];
+readonly optionKey:"resolution";
+readonly metadataKey:"resolution";
+},{
+readonly canonical:"expected-result";
+readonly aliases:readonly ["expected_result","expected-result"];
+readonly optionKey:"expectedResult";
+readonly metadataKey:"expected_result";
+},{
+readonly canonical:"actual-result";
+readonly aliases:readonly ["actual_result","actual-result"];
+readonly optionKey:"actualResult";
+readonly metadataKey:"actual_result";
+},{
+readonly canonical:"affected-version";
+readonly aliases:readonly ["affected_version","affected-version"];
+readonly optionKey:"affectedVersion";
+readonly metadataKey:"affected_version";
+},{
+readonly canonical:"fixed-version";
+readonly aliases:readonly ["fixed_version","fixed-version"];
+readonly optionKey:"fixedVersion";
+readonly metadataKey:"fixed_version";
+},{
+readonly canonical:"component";
+readonly aliases:readonly ["component"];
+readonly optionKey:"component";
+readonly metadataKey:"component";
+},{
+readonly canonical:"regression";
+readonly aliases:readonly ["regression"];
+readonly optionKey:"regression";
+readonly metadataKey:"regression";
+},{
+readonly canonical:"customer-impact";
+readonly aliases:readonly ["customer_impact","customer-impact"];
+readonly optionKey:"customerImpact";
+readonly metadataKey:"customer_impact";
+}];
+/** Every field `pm create --unset` (and the SDK `unset` option on create) can clear. */
+export declare const CREATE_UNSET_FIELD_DEFINITIONS:readonly [{
+readonly canonical:"tags";
+readonly aliases:readonly ["tags"];
+readonly optionKey:"tags";
+readonly metadataKey:"tags";
+},{
+readonly canonical:"deadline";
+readonly aliases:readonly ["deadline"];
+readonly optionKey:"deadline";
+readonly metadataKey:"deadline";
+},{
+readonly canonical:"estimate";
+readonly aliases:readonly ["estimate","estimated_minutes","estimated-minutes"];
+readonly optionKey:"estimatedMinutes";
+readonly metadataKey:"estimated_minutes";
+},{
+readonly canonical:"acceptance-criteria";
+readonly aliases:readonly ["acceptance_criteria","acceptance-criteria","ac"];
+readonly optionKey:"acceptanceCriteria";
+readonly metadataKey:"acceptance_criteria";
+},{
+readonly canonical:"definition-of-ready";
+readonly aliases:readonly ["definition_of_ready","definition-of-ready"];
+readonly optionKey:"definitionOfReady";
+readonly metadataKey:"definition_of_ready";
+},{
+readonly canonical:"order";
+readonly aliases:readonly ["order","rank"];
+readonly optionKey:"order";
+readonly metadataKey:"order";
+},{
+readonly canonical:"goal";
+readonly aliases:readonly ["goal"];
+readonly optionKey:"goal";
+readonly metadataKey:"goal";
+},{
+readonly canonical:"objective";
+readonly aliases:readonly ["objective"];
+readonly optionKey:"objective";
+readonly metadataKey:"objective";
+},{
+readonly canonical:"value";
+readonly aliases:readonly ["value"];
+readonly optionKey:"value";
+readonly metadataKey:"value";
+},{
+readonly canonical:"impact";
+readonly aliases:readonly ["impact"];
+readonly optionKey:"impact";
+readonly metadataKey:"impact";
+},{
+readonly canonical:"outcome";
+readonly aliases:readonly ["outcome"];
+readonly optionKey:"outcome";
+readonly metadataKey:"outcome";
+},{
+readonly canonical:"why-now";
+readonly aliases:readonly ["why_now","why-now"];
+readonly optionKey:"whyNow";
+readonly metadataKey:"why_now";
+},{
+readonly canonical:"author";
+readonly aliases:readonly ["author"];
+readonly optionKey:"author";
+readonly metadataKey:"author";
+},{
+readonly canonical:"assignee";
+readonly aliases:readonly ["assignee"];
+readonly optionKey:"assignee";
+readonly metadataKey:"assignee";
+},{
+readonly canonical:"parent";
+readonly aliases:readonly ["parent"];
+readonly optionKey:"parent";
+readonly metadataKey:"parent";
+},{
+readonly canonical:"reviewer";
+readonly aliases:readonly ["reviewer"];
+readonly optionKey:"reviewer";
+readonly metadataKey:"reviewer";
+},{
+readonly canonical:"risk";
+readonly aliases:readonly ["risk"];
+readonly optionKey:"risk";
+readonly metadataKey:"risk";
+},{
+readonly canonical:"confidence";
+readonly aliases:readonly ["confidence"];
+readonly optionKey:"confidence";
+readonly metadataKey:"confidence";
+},{
+readonly canonical:"sprint";
+readonly aliases:readonly ["sprint"];
+readonly optionKey:"sprint";
+readonly metadataKey:"sprint";
+},{
+readonly canonical:"release";
+readonly aliases:readonly ["release"];
+readonly optionKey:"release";
+readonly metadataKey:"release";
+},{
+readonly canonical:"blocked-by";
+readonly aliases:readonly ["blocked_by","blocked-by"];
+readonly optionKey:"blockedBy";
+readonly metadataKey:"blocked_by";
+},{
+readonly canonical:"blocked-reason";
+readonly aliases:readonly ["blocked_reason","blocked-reason"];
+readonly optionKey:"blockedReason";
+readonly metadataKey:"blocked_reason";
+},{
+readonly canonical:"unblock-note";
+readonly aliases:readonly ["unblock_note","unblock-note"];
+readonly optionKey:"unblockNote";
+readonly metadataKey:"unblock_note";
+},{
+readonly canonical:"reporter";
+readonly aliases:readonly ["reporter"];
+readonly optionKey:"reporter";
+readonly metadataKey:"reporter";
+},{
+readonly canonical:"severity";
+readonly aliases:readonly ["severity"];
+readonly optionKey:"severity";
+readonly metadataKey:"severity";
+},{
+readonly canonical:"environment";
+readonly aliases:readonly ["environment"];
+readonly optionKey:"environment";
+readonly metadataKey:"environment";
+},{
+readonly canonical:"repro-steps";
+readonly aliases:readonly ["repro_steps","repro-steps"];
+readonly optionKey:"reproSteps";
+readonly metadataKey:"repro_steps";
+},{
+readonly canonical:"resolution";
+readonly aliases:readonly ["resolution"];
+readonly optionKey:"resolution";
+readonly metadataKey:"resolution";
+},{
+readonly canonical:"expected-result";
+readonly aliases:readonly ["expected_result","expected-result"];
+readonly optionKey:"expectedResult";
+readonly metadataKey:"expected_result";
+},{
+readonly canonical:"actual-result";
+readonly aliases:readonly ["actual_result","actual-result"];
+readonly optionKey:"actualResult";
+readonly metadataKey:"actual_result";
+},{
+readonly canonical:"affected-version";
+readonly aliases:readonly ["affected_version","affected-version"];
+readonly optionKey:"affectedVersion";
+readonly metadataKey:"affected_version";
+},{
+readonly canonical:"fixed-version";
+readonly aliases:readonly ["fixed_version","fixed-version"];
+readonly optionKey:"fixedVersion";
+readonly metadataKey:"fixed_version";
+},{
+readonly canonical:"component";
+readonly aliases:readonly ["component"];
+readonly optionKey:"component";
+readonly metadataKey:"component";
+},{
+readonly canonical:"regression";
+readonly aliases:readonly ["regression"];
+readonly optionKey:"regression";
+readonly metadataKey:"regression";
+},{
+readonly canonical:"customer-impact";
+readonly aliases:readonly ["customer_impact","customer-impact"];
+readonly optionKey:"customerImpact";
+readonly metadataKey:"customer_impact";
+}];
+/** Every field `pm update --unset` (and the SDK `unset` option on update) can clear. */
+export declare const UPDATE_UNSET_FIELD_DEFINITIONS:readonly [{
+readonly canonical:"tags";
+readonly aliases:readonly ["tags"];
+readonly optionKey:"tags";
+readonly metadataKey:"tags";
+},{
+readonly canonical:"close-reason";
+readonly aliases:readonly string[];
+readonly optionKey:"closeReason";
+readonly metadataKey:"close_reason";
+},{
+readonly canonical:"deadline";
+readonly aliases:readonly ["deadline"];
+readonly optionKey:"deadline";
+readonly metadataKey:"deadline";
+},{
+readonly canonical:"estimate";
+readonly aliases:readonly ["estimate","estimated_minutes","estimated-minutes"];
+readonly optionKey:"estimatedMinutes";
+readonly metadataKey:"estimated_minutes";
+},{
+readonly canonical:"acceptance-criteria";
+readonly aliases:readonly ["acceptance_criteria","acceptance-criteria","ac"];
+readonly optionKey:"acceptanceCriteria";
+readonly metadataKey:"acceptance_criteria";
+},{
+readonly canonical:"definition-of-ready";
+readonly aliases:readonly ["definition_of_ready","definition-of-ready"];
+readonly optionKey:"definitionOfReady";
+readonly metadataKey:"definition_of_ready";
+},{
+readonly canonical:"order";
+readonly aliases:readonly ["order","rank"];
+readonly optionKey:"order";
+readonly metadataKey:"order";
+},{
+readonly canonical:"goal";
+readonly aliases:readonly ["goal"];
+readonly optionKey:"goal";
+readonly metadataKey:"goal";
+},{
+readonly canonical:"objective";
+readonly aliases:readonly ["objective"];
+readonly optionKey:"objective";
+readonly metadataKey:"objective";
+},{
+readonly canonical:"value";
+readonly aliases:readonly ["value"];
+readonly optionKey:"value";
+readonly metadataKey:"value";
+},{
+readonly canonical:"impact";
+readonly aliases:readonly ["impact"];
+readonly optionKey:"impact";
+readonly metadataKey:"impact";
+},{
+readonly canonical:"outcome";
+readonly aliases:readonly ["outcome"];
+readonly optionKey:"outcome";
+readonly metadataKey:"outcome";
+},{
+readonly canonical:"why-now";
+readonly aliases:readonly ["why_now","why-now"];
+readonly optionKey:"whyNow";
+readonly metadataKey:"why_now";
+},{
+readonly canonical:"assignee";
+readonly aliases:readonly ["assignee"];
+readonly optionKey:"assignee";
+readonly metadataKey:"assignee";
+},{
+readonly canonical:"parent";
+readonly aliases:readonly ["parent"];
+readonly optionKey:"parent";
+readonly metadataKey:"parent";
+},{
+readonly canonical:"reviewer";
+readonly aliases:readonly ["reviewer"];
+readonly optionKey:"reviewer";
+readonly metadataKey:"reviewer";
+},{
+readonly canonical:"risk";
+readonly aliases:readonly ["risk"];
+readonly optionKey:"risk";
+readonly metadataKey:"risk";
+},{
+readonly canonical:"confidence";
+readonly aliases:readonly ["confidence"];
+readonly optionKey:"confidence";
+readonly metadataKey:"confidence";
+},{
+readonly canonical:"sprint";
+readonly aliases:readonly ["sprint"];
+readonly optionKey:"sprint";
+readonly metadataKey:"sprint";
+},{
+readonly canonical:"release";
+readonly aliases:readonly ["release"];
+readonly optionKey:"release";
+readonly metadataKey:"release";
+},{
+readonly canonical:"blocked-by";
+readonly aliases:readonly ["blocked_by","blocked-by"];
+readonly optionKey:"blockedBy";
+readonly metadataKey:"blocked_by";
+},{
+readonly canonical:"blocked-reason";
+readonly aliases:readonly ["blocked_reason","blocked-reason"];
+readonly optionKey:"blockedReason";
+readonly metadataKey:"blocked_reason";
+},{
+readonly canonical:"unblock-note";
+readonly aliases:readonly ["unblock_note","unblock-note"];
+readonly optionKey:"unblockNote";
+readonly metadataKey:"unblock_note";
+},{
+readonly canonical:"reporter";
+readonly aliases:readonly ["reporter"];
+readonly optionKey:"reporter";
+readonly metadataKey:"reporter";
+},{
+readonly canonical:"severity";
+readonly aliases:readonly ["severity"];
+readonly optionKey:"severity";
+readonly metadataKey:"severity";
+},{
+readonly canonical:"environment";
+readonly aliases:readonly ["environment"];
+readonly optionKey:"environment";
+readonly metadataKey:"environment";
+},{
+readonly canonical:"repro-steps";
+readonly aliases:readonly ["repro_steps","repro-steps"];
+readonly optionKey:"reproSteps";
+readonly metadataKey:"repro_steps";
+},{
+readonly canonical:"resolution";
+readonly aliases:readonly ["resolution"];
+readonly optionKey:"resolution";
+readonly metadataKey:"resolution";
+},{
+readonly canonical:"expected-result";
+readonly aliases:readonly ["expected_result","expected-result"];
+readonly optionKey:"expectedResult";
+readonly metadataKey:"expected_result";
+},{
+readonly canonical:"actual-result";
+readonly aliases:readonly ["actual_result","actual-result"];
+readonly optionKey:"actualResult";
+readonly metadataKey:"actual_result";
+},{
+readonly canonical:"affected-version";
+readonly aliases:readonly ["affected_version","affected-version"];
+readonly optionKey:"affectedVersion";
+readonly metadataKey:"affected_version";
+},{
+readonly canonical:"fixed-version";
+readonly aliases:readonly ["fixed_version","fixed-version"];
+readonly optionKey:"fixedVersion";
+readonly metadataKey:"fixed_version";
+},{
+readonly canonical:"component";
+readonly aliases:readonly ["component"];
+readonly optionKey:"component";
+readonly metadataKey:"component";
+},{
+readonly canonical:"regression";
+readonly aliases:readonly ["regression"];
+readonly optionKey:"regression";
+readonly metadataKey:"regression";
+},{
+readonly canonical:"customer-impact";
+readonly aliases:readonly ["customer_impact","customer-impact"];
+readonly optionKey:"customerImpact";
+readonly metadataKey:"customer_impact";
+}];
+/**
+ * Option keys a typed caller may clear with `null` (GH-1655): every option the
+ * command's `unset` table covers, derived from that table, except the `author`
+ * attribution, which names who performs the write.
+ */
+export type NullClearableOptionKey<Table extends readonly {
+optionKey:string;
+}[]> = Exclude<Table[number]["optionKey"],"author">;
+/** Let the listed keys also take `null`, the typed clear, while every other key keeps its exact value type and optionality. */
+export type WithNullClears<Shape,Keys extends PropertyKey> = {
+[Key in keyof Shape]:Key extends Keys ? Shape[Key] | null :Shape[Key];
+};
+/**
+ * Create option keys that accept the typed `null` clear, spelled out so the SDK
+ * surface snapshot records the set (it prints alias text, not resolved types).
+ * tests/types/typed-action-inputs.test-d.ts keeps it equal to
+ * `NullClearableOptionKey<typeof CREATE_UNSET_FIELD_DEFINITIONS>`.
+ */
+export type CreateNullClearableOptionKey = "acceptanceCriteria" | "actualResult" | "affectedVersion" | "assignee" | "blockedBy" | "blockedReason" | "component" | "confidence" | "customerImpact" | "deadline" | "definitionOfReady" | "environment" | "estimatedMinutes" | "expectedResult" | "fixedVersion" | "goal" | "impact" | "objective" | "order" | "outcome" | "parent" | "regression" | "release" | "reporter" | "reproSteps" | "resolution" | "reviewer" | "risk" | "severity" | "sprint" | "tags" | "unblockNote" | "value" | "whyNow";
+/** Update option keys that accept the typed `null` clear: the create set plus `closeReason`, kept equal to the update unset table by the same type test. */
+export type UpdateNullClearableOptionKey = CreateNullClearableOptionKey | "closeReason";
+/**
+ * Treat a typed `null` on a clearable option as an explicit clear (GH-1655):
+ * `{ parent: null }` becomes `unset: ["parent"]`. Options `unset` cannot clear
+ * keep their `null`, so value validation refuses them by name, and so does
+ * `author`: on the SDK it names who performs the write, not a stored field.
+ * Mutates the bag, which must be a caller-private copy; an `unset` that is
+ * neither absent, a string nor an array is left for value validation to refuse.
+ */
+export declare function foldNullClearsIntoUnset(action:"create" | "update",options:Record<string,unknown>):void;
+/**
+ * Advisory warnings for typed input that stored a former clear sentinel
+ * literally (GH-1614 keeps `assignee: "none"` as a person called none). Each
+ * names the field and the clear form: `literal_sentinel_stored:<field>:<value>`,
+ * cleared with `unset: ["<field>"]` or `null`. A field is advised only when the
+ * resulting `stored` item still holds that sentinel, so a value a lifecycle
+ * transition removed is never reported as stored. CLI input is never advised:
+ * its adapter still maps the sentinels to clears.
+ */
+export declare function literalSentinelAdvisories(action:"create" | "update",options:Record<string,unknown>,literal:boolean,stored:Record<string,unknown>):string[];
 /** Result of matching a runtime schema field against a command `--unset` token. */
 export interface RuntimeUnsetFieldDefinition {
 /** Value that configures or reports option key for this contract. */

package/dist/sdk/lifecycle/shared-unset-fields.js

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="528a6201-58cb-544b-a831-5ce3bff3bbc2")}catch{}})();import{EXIT_CODE,PmCliError}from"../runtime-primitives.js";import{isLegacyNoneToken}from"./legacy-none-tokens.js";const CLOSE_REASON_UNSET_ALIASES=["close_reason","close-reason"],COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON=[{canonical:"tags",aliases:["tags"],optionKey:"tags",metadataKey:"tags"}],COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR=[{canonical:"deadline",aliases:["deadline"],optionKey:"deadline",metadataKey:"deadline"},{canonical:"estimate",aliases:["estimate","estimated_minutes","estimated-minutes"],optionKey:"estimatedMinutes",metadataKey:"estimated_minutes"},{canonical:"acceptance-criteria",aliases:["acceptance_criteria","acceptance-criteria","ac"],optionKey:"acceptanceCriteria",metadataKey:"acceptance_criteria"},{canonical:"definition-of-ready",aliases:["definition_of_ready","definition-of-ready"],optionKey:"definitionOfReady",metadataKey:"definition_of_ready"},{canonical:"order",aliases:["order","rank"],optionKey:"order",metadataKey:"order"},{canonical:"goal",aliases:["goal"],optionKey:"goal",metadataKey:"goal"},{canonical:"objective",aliases:["objective"],optionKey:"objective",metadataKey:"objective"},{canonical:"value",aliases:["value"],optionKey:"value",metadataKey:"value"},{canonical:"impact",aliases:["impact"],optionKey:"impact",metadataKey:"impact"},{canonical:"outcome",aliases:["outcome"],optionKey:"outcome",metadataKey:"outcome"},{canonical:"why-now",aliases:["why_now","why-now"],optionKey:"whyNow",metadataKey:"why_now"}],COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_AUTHOR=[...COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON,...COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR],COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR=[{canonical:"assignee",aliases:["assignee"],optionKey:"assignee",metadataKey:"assignee"},{canonical:"parent",aliases:["parent"],optionKey:"parent",metadataKey:"parent"},{canonical:"reviewer",aliases:["reviewer"],optionKey:"reviewer",metadataKey:"reviewer"},{canonical:"risk",aliases:["risk"],optionKey:"risk",metadataKey:"risk"},{canonical:"confidence",aliases:["confidence"],optionKey:"confidence",metadataKey:"confidence"},{canonical:"sprint",aliases:["sprint"],optionKey:"sprint",metadataKey:"sprint"},{canonical:"release",aliases:["release"],optionKey:"release",metadataKey:"release"},{canonical:"blocked-by",aliases:["blocked_by","blocked-by"],optionKey:"blockedBy",metadataKey:"blocked_by"},{canonical:"blocked-reason",aliases:["blocked_reason","blocked-reason"],optionKey:"blockedReason",metadataKey:"blocked_reason"},{canonical:"unblock-note",aliases:["unblock_note","unblock-note"],optionKey:"unblockNote",metadataKey:"unblock_note"},{canonical:"reporter",aliases:["reporter"],optionKey:"reporter",metadataKey:"reporter"},{canonical:"severity",aliases:["severity"],optionKey:"severity",metadataKey:"severity"},{canonical:"environment",aliases:["environment"],optionKey:"environment",metadataKey:"environment"},{canonical:"repro-steps",aliases:["repro_steps","repro-steps"],optionKey:"reproSteps",metadataKey:"repro_steps"},{canonical:"resolution",aliases:["resolution"],optionKey:"resolution",metadataKey:"resolution"},{canonical:"expected-result",aliases:["expected_result","expected-result"],optionKey:"expectedResult",metadataKey:"expected_result"},{canonical:"actual-result",aliases:["actual_result","actual-result"],optionKey:"actualResult",metadataKey:"actual_result"},{canonical:"affected-version",aliases:["affected_version","affected-version"],optionKey:"affectedVersion",metadataKey:"affected_version"},{canonical:"fixed-version",aliases:["fixed_version","fixed-version"],optionKey:"fixedVersion",metadataKey:"fixed_version"},{canonical:"component",aliases:["component"],optionKey:"component",metadataKey:"component"},{canonical:"regression",aliases:["regression"],optionKey:"regression",metadataKey:"regression"},{canonical:"customer-impact",aliases:["customer_impact","customer-impact"],optionKey:"customerImpact",metadataKey:"customer_impact"}];function expandUnsetFieldTokens(raw,resolvesWhole){return raw.flatMap(entry=>entry.includes(",")&&resolvesWhole(entry)?[entry]:entry.split(","))}function parseCommandUnsetTargets(options){const metadataKeys=new Set,optionKeys=new Set;if(!options.raw||options.raw.length===0)return{metadataKeys,optionKeys};const tokens=expandUnsetFieldTokens(options.raw,entry=>options.resolveDefinition(entry.trim().toLowerCase())!==void 0);for(const entry of tokens){const trimmed=entry.trim().toLowerCase();if(!trimmed)throw new PmCliError("--unset values must not be empty; name each field once, for example --unset parent,release",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=options.resolveDefinition(trimmed);if(!definition)throw new PmCliError(`Unsupported --unset field "${entry}". Supported fields: ${options.supportedFields}`,EXIT_CODE.USAGE);metadataKeys.add(definition.metadataKey),optionKeys.add(definition.optionKey)}return{metadataKeys,optionKeys}}function resolveRuntimeUnsetFieldDefinition(token,command,runtimeFieldRegistry){const normalizedToken=token.trim().toLowerCase();if(!runtimeFieldRegistry)return;const definitions=runtimeFieldRegistry.command_to_fields?.get(command)??[];for(const definition of definitions){if(definition.allow_unset===!1)continue;const candidates=new Set;if(typeof definition.key=="string"&&definition.key.length>0&&candidates.add(definition.key.toLowerCase()),typeof definition.metadata_key=="string"&&definition.metadata_key.length>0&&candidates.add(definition.metadata_key.toLowerCase()),typeof definition.cli_flag=="string"&&definition.cli_flag.length>0&&(candidates.add(definition.cli_flag.replaceAll("-","_").toLowerCase()),candidates.add(definition.cli_flag.toLowerCase())),Array.isArray(definition.cli_aliases))for(const alias of definition.cli_aliases)typeof alias!="string"||alias.length===0||(candidates.add(alias.replaceAll("-","_").toLowerCase()),candidates.add(alias.toLowerCase()));if(candidates.has(normalizedToken))return{optionKey:definition.key,metadataKey:definition.metadata_key}}}export{CLOSE_REASON_UNSET_ALIASES,COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR,COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR,COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_AUTHOR,COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON,expandUnsetFieldTokens,parseCommandUnsetTargets,resolveRuntimeUnsetFieldDefinition};
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="cfab194a-06fd-5536-9572-d33a34b94065")}catch{}})();import{EXIT_CODE,PmCliError}from"../runtime-primitives.js";import{isLegacyNoneToken}from"./legacy-none-tokens.js";const CLOSE_REASON_UNSET_ALIASES=["close_reason","close-reason"],COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON=[{canonical:"tags",aliases:["tags"],optionKey:"tags",metadataKey:"tags"}],COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR=[{canonical:"deadline",aliases:["deadline"],optionKey:"deadline",metadataKey:"deadline"},{canonical:"estimate",aliases:["estimate","estimated_minutes","estimated-minutes"],optionKey:"estimatedMinutes",metadataKey:"estimated_minutes"},{canonical:"acceptance-criteria",aliases:["acceptance_criteria","acceptance-criteria","ac"],optionKey:"acceptanceCriteria",metadataKey:"acceptance_criteria"},{canonical:"definition-of-ready",aliases:["definition_of_ready","definition-of-ready"],optionKey:"definitionOfReady",metadataKey:"definition_of_ready"},{canonical:"order",aliases:["order","rank"],optionKey:"order",metadataKey:"order"},{canonical:"goal",aliases:["goal"],optionKey:"goal",metadataKey:"goal"},{canonical:"objective",aliases:["objective"],optionKey:"objective",metadataKey:"objective"},{canonical:"value",aliases:["value"],optionKey:"value",metadataKey:"value"},{canonical:"impact",aliases:["impact"],optionKey:"impact",metadataKey:"impact"},{canonical:"outcome",aliases:["outcome"],optionKey:"outcome",metadataKey:"outcome"},{canonical:"why-now",aliases:["why_now","why-now"],optionKey:"whyNow",metadataKey:"why_now"}],COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_AUTHOR=[...COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON,...COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR],COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR=[{canonical:"assignee",aliases:["assignee"],optionKey:"assignee",metadataKey:"assignee"},{canonical:"parent",aliases:["parent"],optionKey:"parent",metadataKey:"parent"},{canonical:"reviewer",aliases:["reviewer"],optionKey:"reviewer",metadataKey:"reviewer"},{canonical:"risk",aliases:["risk"],optionKey:"risk",metadataKey:"risk"},{canonical:"confidence",aliases:["confidence"],optionKey:"confidence",metadataKey:"confidence"},{canonical:"sprint",aliases:["sprint"],optionKey:"sprint",metadataKey:"sprint"},{canonical:"release",aliases:["release"],optionKey:"release",metadataKey:"release"},{canonical:"blocked-by",aliases:["blocked_by","blocked-by"],optionKey:"blockedBy",metadataKey:"blocked_by"},{canonical:"blocked-reason",aliases:["blocked_reason","blocked-reason"],optionKey:"blockedReason",metadataKey:"blocked_reason"},{canonical:"unblock-note",aliases:["unblock_note","unblock-note"],optionKey:"unblockNote",metadataKey:"unblock_note"},{canonical:"reporter",aliases:["reporter"],optionKey:"reporter",metadataKey:"reporter"},{canonical:"severity",aliases:["severity"],optionKey:"severity",metadataKey:"severity"},{canonical:"environment",aliases:["environment"],optionKey:"environment",metadataKey:"environment"},{canonical:"repro-steps",aliases:["repro_steps","repro-steps"],optionKey:"reproSteps",metadataKey:"repro_steps"},{canonical:"resolution",aliases:["resolution"],optionKey:"resolution",metadataKey:"resolution"},{canonical:"expected-result",aliases:["expected_result","expected-result"],optionKey:"expectedResult",metadataKey:"expected_result"},{canonical:"actual-result",aliases:["actual_result","actual-result"],optionKey:"actualResult",metadataKey:"actual_result"},{canonical:"affected-version",aliases:["affected_version","affected-version"],optionKey:"affectedVersion",metadataKey:"affected_version"},{canonical:"fixed-version",aliases:["fixed_version","fixed-version"],optionKey:"fixedVersion",metadataKey:"fixed_version"},{canonical:"component",aliases:["component"],optionKey:"component",metadataKey:"component"},{canonical:"regression",aliases:["regression"],optionKey:"regression",metadataKey:"regression"},{canonical:"customer-impact",aliases:["customer_impact","customer-impact"],optionKey:"customerImpact",metadataKey:"customer_impact"}],CREATE_UNSET_FIELD_DEFINITIONS=[...COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_AUTHOR,{canonical:"author",aliases:["author"],optionKey:"author",metadataKey:"author"},...COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR],UPDATE_UNSET_FIELD_DEFINITIONS=[...COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON,{canonical:"close-reason",aliases:CLOSE_REASON_UNSET_ALIASES,optionKey:"closeReason",metadataKey:"close_reason"},...COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR,...COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR],FORMER_CLEAR_SENTINELS=new Set(["none","null","-"]);function unsetDefinitionsFor(action){return action==="create"?CREATE_UNSET_FIELD_DEFINITIONS:UPDATE_UNSET_FIELD_DEFINITIONS}function foldNullClearsIntoUnset(action,options){const current=options.unset;if(current!==void 0&&typeof current!="string"&&!Array.isArray(current))return;const tokens=[];for(const definition of unsetDefinitionsFor(action))definition.optionKey==="author"||!Object.hasOwn(options,definition.optionKey)||options[definition.optionKey]!==null||(Reflect.deleteProperty(options,definition.optionKey),tokens.push(definition.canonical));tokens.length!==0&&(options.unset=[...current===void 0?[]:typeof current=="string"?[current]:current,...tokens])}function isFormerClearSentinel(value){return typeof value=="string"&&FORMER_CLEAR_SENTINELS.has(value.trim().toLowerCase())}function literalSentinelAdvisories(action,options,literal,stored){return literal?unsetDefinitionsFor(action).flatMap(definition=>{const value=options[definition.optionKey],kept=stored[definition.metadataKey];return isFormerClearSentinel(value)&&(isFormerClearSentinel(kept)||Array.isArray(kept)&&kept.some(isFormerClearSentinel))?[`literal_sentinel_stored:${definition.canonical}:${value.trim()}`]:[]}):[]}function expandUnsetFieldTokens(raw,resolvesWhole){return raw.flatMap(entry=>entry.includes(",")&&resolvesWhole(entry)?[entry]:entry.split(","))}function parseCommandUnsetTargets(options){const metadataKeys=new Set,optionKeys=new Set;if(!options.raw||options.raw.length===0)return{metadataKeys,optionKeys};const tokens=expandUnsetFieldTokens(options.raw,entry=>options.resolveDefinition(entry.trim().toLowerCase())!==void 0);for(const entry of tokens){const trimmed=entry.trim().toLowerCase();if(!trimmed)throw new PmCliError("--unset values must not be empty; name each field once, for example --unset parent,release",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=options.resolveDefinition(trimmed);if(!definition)throw new PmCliError(`Unsupported --unset field "${entry}". Supported fields: ${options.supportedFields}`,EXIT_CODE.USAGE);metadataKeys.add(definition.metadataKey),optionKeys.add(definition.optionKey)}return{metadataKeys,optionKeys}}function resolveRuntimeUnsetFieldDefinition(token,command,runtimeFieldRegistry){const normalizedToken=token.trim().toLowerCase();if(!runtimeFieldRegistry)return;const definitions=runtimeFieldRegistry.command_to_fields?.get(command)??[];for(const definition of definitions){if(definition.allow_unset===!1)continue;const candidates=new Set;if(typeof definition.key=="string"&&definition.key.length>0&&candidates.add(definition.key.toLowerCase()),typeof definition.metadata_key=="string"&&definition.metadata_key.length>0&&candidates.add(definition.metadata_key.toLowerCase()),typeof definition.cli_flag=="string"&&definition.cli_flag.length>0&&(candidates.add(definition.cli_flag.replaceAll("-","_").toLowerCase()),candidates.add(definition.cli_flag.toLowerCase())),Array.isArray(definition.cli_aliases))for(const alias of definition.cli_aliases)typeof alias!="string"||alias.length===0||(candidates.add(alias.replaceAll("-","_").toLowerCase()),candidates.add(alias.toLowerCase()));if(candidates.has(normalizedToken))return{optionKey:definition.key,metadataKey:definition.metadata_key}}}export{CLOSE_REASON_UNSET_ALIASES,COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR,COMMON_UNSET_FIELD_DEFINITIONS_AFTER_CLOSE_REASON_BEFORE_AUTHOR,COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_AUTHOR,COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON,CREATE_UNSET_FIELD_DEFINITIONS,UPDATE_UNSET_FIELD_DEFINITIONS,expandUnsetFieldTokens,foldNullClearsIntoUnset,literalSentinelAdvisories,parseCommandUnsetTargets,resolveRuntimeUnsetFieldDefinition};
 //# sourceMappingURL=shared-unset-fields.js.map