@unbrained/pm-cli 2026.7.11 → 2026.7.12

package/dist/core/schema/fields-file.js

@@ -4,8 +4,9 @@
  * Resolves configurable schema, fields, statuses, and workflows for Fields File.
  */
 
-!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]="d385bfd4-56bb-5b73-9769-b443473e139a")}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]="5b67948f-d13c-52e4-8e6a-6ba23768d589")}catch(e){}}();
 import { RUNTIME_FIELD_COMMAND_VALUES, RUNTIME_FIELD_TYPE_VALUES, } from "../../types/index.js";
+import { FRONT_MATTER_KEY_ORDER } from "../shared/constants.js";
 /**
  * Pure logic for the `pm schema add-field` / `pm schema remove-field` commands
  * and the `list-fields` / `show-field` inspectors. The CLI command file
@@ -22,6 +23,7 @@ const RUNTIME_FIELD_TYPE_SET = new Set(RUNTIME_FIELD_TYPE_VALUES);
 const RUNTIME_FIELD_COMMAND_SET = new Set(RUNTIME_FIELD_COMMAND_VALUES);
 /** Built-in front-matter field names a custom field key must never shadow. A custom key that collides with one of these would let `pm create --<key>` write over reserved metadata, so add-field rejects them up front (symmetric with the built-in-type guard in item-types-file.ts). */
 export const BUILTIN_FIELD_KEYS = new Set([
+    ...FRONT_MATTER_KEY_ORDER.filter((key) => key !== "severity"),
     "id",
     "title",
     "type",
@@ -120,7 +122,7 @@ export function normalizeAddFieldInput(raw) {
         throw new Error("Field key must not be empty.");
     }
     if (BUILTIN_FIELD_KEYS.has(key)) {
-        throw new Error(`Cannot define custom field "${key}": it shadows a built-in field. Built-in fields are reserved.`);
+        throw new Error(`Cannot define custom field "${key}": custom schema field "${key}" collides with built-in item metadata "${key}". Rename the custom field with a project-specific prefix. Reserved fields: ${[...BUILTIN_FIELD_KEYS].sort((left, right) => left.localeCompare(right)).join(", ")}.`);
     }
     const typeCandidate = typeof raw.type === "string" && raw.type.trim().length > 0
         ? raw.type.trim().toLowerCase()
@@ -290,4 +292,4 @@ function applyBooleanFlag(definition, key, value) {
     }
 }
 //# sourceMappingURL=fields-file.js.map
-//# debugId=d385bfd4-56bb-5b73-9769-b443473e139a
+//# debugId=5b67948f-d13c-52e4-8e6a-6ba23768d589

package/dist/core/schema/fields-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields-file.js","sources":["core/schema/fields-file.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/schema/fields-file\n *\n * Resolves configurable schema, fields, statuses, and workflows for Fields File.\n */\nimport {\n  RUNTIME_FIELD_COMMAND_VALUES,\n  RUNTIME_FIELD_TYPE_VALUES,\n} from \"../../types/index.js\";\nimport type {\n  RuntimeFieldCommand,\n  RuntimeFieldDefinition,\n  RuntimeFieldType,\n} from \"../../types/index.js\";\n\nexport type {\n  RuntimeFieldCommand,\n  RuntimeFieldDefinition,\n  RuntimeFieldType,\n} from \"../../types/index.js\";\n\n/**\n * Pure logic for the `pm schema add-field` / `pm schema remove-field` commands\n * and the `list-fields` / `show-field` inspectors. The CLI command file\n * (schema.ts) owns IO/governance; everything testable and side-effect-free lives\n * here so it can be coverage-gated to 100%.\n *\n * Custom fields persist at `.agents/pm/schema/fields.json` under the shape\n * `{ fields: RuntimeFieldDefinition[] }`. The runtime merge layer\n * (loadRuntimeSchemaFromOptionalFiles) reads that file and dynamically registers\n * a CLI flag per field on create/update/list/search/context, so this module only\n * has to manage the persisted entries; it never duplicates the registration.\n */\n\nconst RUNTIME_FIELD_TYPE_SET = new Set<string>(RUNTIME_FIELD_TYPE_VALUES);\nconst RUNTIME_FIELD_COMMAND_SET = new Set<string>(RUNTIME_FIELD_COMMAND_VALUES);\n\n/** Built-in front-matter field names a custom field key must never shadow. A custom key that collides with one of these would let `pm create --<key>` write over reserved metadata, so add-field rejects them up front (symmetric with the built-in-type guard in item-types-file.ts). */\nexport const BUILTIN_FIELD_KEYS: ReadonlySet<string> = new Set([\n  \"id\",\n  \"title\",\n  \"type\",\n  \"status\",\n  \"priority\",\n  \"tags\",\n  \"assignee\",\n  \"parent\",\n  \"description\",\n  \"body\",\n  \"created_at\",\n  \"updated_at\",\n  \"closed_at\",\n  \"author\",\n  \"deadline\",\n  \"estimate\",\n  \"sprint\",\n  \"release\",\n  \"risk\",\n  \"confidence\",\n  \"reviewer\",\n  \"resolution\",\n  \"expected\",\n  \"actual\",\n]);\n\n/** The default commands a field is wired onto when `--commands` is omitted, matching the runtime default in runtime-schema.ts (normalizeRuntimeFieldDefinition). */\nconst DEFAULT_FIELD_COMMANDS: RuntimeFieldCommand[] = [\"create\", \"update\"];\n\n/** The shape persisted at `.agents/pm/schema/fields.json`. */\nexport interface FieldsFile {\n  /** Value that configures or reports fields for this contract. */\n  fields: RuntimeFieldDefinition[];\n}\n\n/** Documents the raw add field input payload exchanged by command, SDK, and package integrations. */\nexport interface RawAddFieldInput {\n  /** Value that configures or reports key for this contract. */\n  key: string | undefined;\n  /** Schema type that determines the shape and validation rules for this value. */\n  type?: string;\n  /** Value that configures or reports commands for this contract. */\n  commands?: string[];\n  /** Value that configures or reports description for this contract. */\n  description?: string;\n  /** Value that configures or reports cli flag for this contract. */\n  cliFlag?: string;\n  /** Value that configures or reports aliases for this contract. */\n  aliases?: string[];\n  /** Value that configures or reports required for this contract. */\n  required?: boolean;\n  /** Value that configures or reports required on create for this contract. */\n  requiredOnCreate?: boolean;\n  /** Value that configures or reports allow unset for this contract. */\n  allowUnset?: boolean;\n  /** Value that configures or reports required types for this contract. */\n  requiredTypes?: string[];\n}\n\n/** Documents the normalized add field input payload exchanged by command, SDK, and package integrations. */\nexport interface NormalizedAddFieldInput {\n  /** Value that configures or reports key for this contract. */\n  key: string;\n  /** Schema type that determines the shape and validation rules for this value. */\n  type: RuntimeFieldType;\n  /** Value that configures or reports commands for this contract. */\n  commands: RuntimeFieldCommand[];\n  /** Value that configures or reports description for this contract. */\n  description?: string;\n  /** Value that configures or reports cli flag for this contract. */\n  cliFlag?: string;\n  /** Value that configures or reports cli aliases for this contract. */\n  cliAliases: string[];\n  /** Value that configures or reports required for this contract. */\n  required: boolean;\n  /** Value that configures or reports required on create for this contract. */\n  requiredOnCreate: boolean;\n  /** Value that configures or reports allow unset for this contract. */\n  allowUnset: boolean;\n  /** Value that configures or reports required types for this contract. */\n  requiredTypes: string[];\n}\n\n/** Documents the upsert field result payload exchanged by command, SDK, and package integrations. */\nexport interface UpsertFieldResult {\n  /** Value that configures or reports file for this contract. */\n  file: FieldsFile;\n  /** The definition as stored after the upsert. */\n  definition: RuntimeFieldDefinition;\n  /** True when an existing definition with the same (normalized) key was replaced. */\n  replaced: boolean;\n}\n\n/** Documents the remove field result payload exchanged by command, SDK, and package integrations. */\nexport interface RemoveFieldResult {\n  /** Value that configures or reports file for this contract. */\n  file: FieldsFile;\n  /** True when a matching definition existed and was dropped from the file. */\n  removed: boolean;\n  /** The removed definition, when one matched the requested key. */\n  definition?: RuntimeFieldDefinition;\n}\n\n/** Normalizes a field key using the same rule as runtime-schema.ts: lowercase and collapse any run of whitespace/hyphens into a single underscore. */\nexport function normalizeFieldKey(value: unknown): string {\n  return typeof value === \"string\"\n    ? value\n        .trim()\n        .toLowerCase()\n        .replaceAll(/[\\s-]+/g, \"_\")\n    : \"\";\n}\n\n/** Normalizes a CLI flag token: strip a leading `--`, lowercase, and collapse whitespace/underscore runs to a single hyphen (matches normalizeCliToken in runtime-schema.ts). */\nfunction normalizeCliToken(value: unknown): string {\n  if (typeof value !== \"string\") {\n    return \"\";\n  }\n  const collapsed = value\n    .trim()\n    .toLowerCase()\n    .replaceAll(/[\\s_]+/g, \"-\");\n  return collapsed.startsWith(\"--\") ? collapsed.slice(2) : collapsed;\n}\n\nfunction keyToDefaultCliFlag(key: string): string {\n  return key.replaceAll(\"_\", \"-\");\n}\n\nfunction dedupeCliTokens(values: Iterable<string>, exclude: string): string[] {\n  const seen = new Set<string>();\n  for (const value of values) {\n    const token = normalizeCliToken(value);\n    if (token.length > 0 && token !== exclude) {\n      seen.add(token);\n    }\n  }\n  return [...seen].sort((left, right) => left.localeCompare(right));\n}\n\nfunction dedupeStringList(values: string[] | undefined): string[] {\n  const seen = new Set<string>();\n  for (const value of values ?? []) {\n    const trimmed = value.trim();\n    if (trimmed.length > 0) {\n      seen.add(trimmed);\n    }\n  }\n  return [...seen].sort((left, right) => left.localeCompare(right));\n}\n\n/** Normalizes the command allow-list stored for a custom field definition. */\nfunction normalizeFieldCommands(\n  rawCommands: string[] | undefined,\n): RuntimeFieldCommand[] {\n  const seen = new Set<string>();\n  const normalized: RuntimeFieldCommand[] = [];\n  for (const rawCommand of rawCommands ?? []) {\n    const command = rawCommand.trim().toLowerCase();\n    if (command.length === 0) {\n      continue;\n    }\n    if (!RUNTIME_FIELD_COMMAND_SET.has(command)) {\n      throw new Error(\n        `Invalid field command \"${rawCommand}\". Allowed: ${RUNTIME_FIELD_COMMAND_VALUES.join(\", \")}.`,\n      );\n    }\n    if (!seen.has(command)) {\n      seen.add(command);\n      normalized.push(command as RuntimeFieldCommand);\n    }\n  }\n  return rawCommands === undefined || normalized.length === 0\n    ? [...DEFAULT_FIELD_COMMANDS]\n    : normalized;\n}\n\n/** Validates and normalizes raw add-field CLI input. Throws a plain Error with a stable message when the key is missing/empty, collides with a built-in field, or carries an invalid type/command; the CLI layer maps these to PmCliError exit codes. A `string_array` type implies a repeatable field downstream (runtime-schema.ts derives `repeatable`), so no separate repeatable flag is exposed. */\nexport function normalizeAddFieldInput(\n  raw: RawAddFieldInput,\n): NormalizedAddFieldInput {\n  const key = normalizeFieldKey(raw.key);\n  if (key.length === 0) {\n    throw new Error(\"Field key must not be empty.\");\n  }\n  if (BUILTIN_FIELD_KEYS.has(key)) {\n    throw new Error(\n      `Cannot define custom field \"${key}\": it shadows a built-in field. Built-in fields are reserved.`,\n    );\n  }\n\n  const typeCandidate =\n    typeof raw.type === \"string\" && raw.type.trim().length > 0\n      ? raw.type.trim().toLowerCase()\n      : \"string\";\n  if (!RUNTIME_FIELD_TYPE_SET.has(typeCandidate)) {\n    throw new Error(\n      `Invalid field type \"${raw.type}\". Allowed: ${RUNTIME_FIELD_TYPE_VALUES.join(\", \")}.`,\n    );\n  }\n  const type = typeCandidate as RuntimeFieldType;\n\n  const commands = normalizeFieldCommands(raw.commands);\n\n  const cliFlagToken = normalizeCliToken(raw.cliFlag);\n  const cliFlag =\n    cliFlagToken.length > 0 && cliFlagToken !== keyToDefaultCliFlag(key)\n      ? cliFlagToken\n      : undefined;\n  const effectiveFlag = cliFlag ?? keyToDefaultCliFlag(key);\n  const cliAliases = dedupeCliTokens(raw.aliases ?? [], effectiveFlag);\n\n  const description = raw.description?.trim();\n  return {\n    key,\n    type,\n    commands,\n    description:\n      description && description.length > 0 ? description : undefined,\n    cliFlag,\n    cliAliases,\n    required: raw.required === true,\n    requiredOnCreate: raw.requiredOnCreate === true,\n    // allow_unset defaults to true (omitted) and is only persisted when an\n    // operator explicitly disables it with --no-allow-unset (allowUnset === false).\n    allowUnset: raw.allowUnset !== false,\n    requiredTypes: dedupeStringList(raw.requiredTypes),\n  };\n}\n\nfunction selectFieldsArray(parsed: unknown): unknown[] | undefined {\n  if (Array.isArray(parsed)) {\n    return parsed;\n  }\n  if (typeof parsed !== \"object\" || parsed === null) {\n    return undefined;\n  }\n  const record = parsed as Record<string, unknown>;\n  if (Array.isArray(record.fields)) {\n    return record.fields;\n  }\n  if (Array.isArray(record.definitions)) {\n    return record.definitions;\n  }\n  return undefined;\n}\n\nfunction extractFieldDefinitions(parsed: unknown): RuntimeFieldDefinition[] {\n  const candidate = selectFieldsArray(parsed);\n  if (!candidate) {\n    return [];\n  }\n  const definitions: RuntimeFieldDefinition[] = [];\n  for (const entry of candidate) {\n    if (typeof entry !== \"object\" || entry === null || Array.isArray(entry)) {\n      continue;\n    }\n    const record = entry as Record<string, unknown>;\n    if (typeof record.key !== \"string\" || record.key.trim().length === 0) {\n      continue;\n    }\n    definitions.push(record as unknown as RuntimeFieldDefinition);\n  }\n  return definitions;\n}\n\n/** Coerces an arbitrary parsed value from fields.json into a FieldsFile. Accepts the canonical `{ fields: [...] }` shape, a bare array, or a `{ definitions: [...] }` form, and tolerates a missing/invalid file by returning an empty fields list. */\nexport function parseFieldsFile(raw: string | null | undefined): FieldsFile {\n  if (raw === null || raw === undefined || raw.trim().length === 0) {\n    return { fields: [] };\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    throw new Error(\"schema/fields.json contains invalid JSON.\");\n  }\n  return { fields: extractFieldDefinitions(parsed) };\n}\n\n/** Serializes the fields file with a trailing newline (matches the rest of the schema scaffold files written by pm). */\nexport function serializeFieldsFile(file: FieldsFile): string {\n  return `${JSON.stringify({ fields: file.fields }, null, 2)}\\n`;\n}\n\n/** Idempotent UPSERT of a custom field into the parsed file. Matching is by normalized key. When a definition already exists, the supplied input fully replaces its add-field-managed attributes (type/commands/description/flags/ required flags) while preserving any unrelated keys the file may carry; any `metadata_key` already stored is preserved so existing item data keeps mapping to the same front-matter column. */\nexport function upsertField(\n  file: FieldsFile,\n  input: NormalizedAddFieldInput,\n): UpsertFieldResult {\n  // Match by normalized key. A hand-authored file may carry more than one entry\n  // for the same key, so drop ALL matches and re-insert a single merged result\n  // (collapsing duplicates) rather than only rewriting the first occurrence. The\n  // first existing match seeds preserved attributes (e.g. metadata_key).\n  const existing = file.fields.find(\n    (definition) => normalizeFieldKey(definition.key) === input.key,\n  );\n  const replaced = existing !== undefined;\n  const fields = file.fields.filter(\n    (definition) => normalizeFieldKey(definition.key) !== input.key,\n  );\n\n  const next: RuntimeFieldDefinition = {\n    ...existing,\n    key: input.key,\n    type: input.type,\n    commands: [...input.commands],\n  };\n  applyOptionalString(next, \"description\", input.description);\n  applyOptionalString(next, \"cli_flag\", input.cliFlag);\n  if (input.cliAliases.length > 0) {\n    next.cli_aliases = [...input.cliAliases];\n  } else {\n    delete next.cli_aliases;\n  }\n  applyBooleanFlag(next, \"required\", input.required);\n  applyBooleanFlag(next, \"required_on_create\", input.requiredOnCreate);\n  // allow_unset defaults true; only persist the explicit false override.\n  if (input.allowUnset === false) {\n    next.allow_unset = false;\n  } else {\n    delete next.allow_unset;\n  }\n  if (input.requiredTypes.length > 0) {\n    next.required_types = [...input.requiredTypes];\n  } else {\n    delete next.required_types;\n  }\n\n  fields.push(next);\n  fields.sort((left, right) =>\n    normalizeFieldKey(left.key).localeCompare(normalizeFieldKey(right.key)),\n  );\n\n  return {\n    file: { fields },\n    definition: next,\n    replaced,\n  };\n}\n\n/** Removes a custom field definition from the parsed file by key (normalized). Throws a plain Error when `key` is empty. Returns `removed: false` when no matching definition exists so the CLI layer can treat the call as an idempotent no-op. */\nexport function removeField(\n  file: FieldsFile,\n  key: string | undefined,\n): RemoveFieldResult {\n  const normalizedKey = normalizeFieldKey(key);\n  if (normalizedKey.length === 0) {\n    throw new Error(\"Field key must not be empty.\");\n  }\n  // Remove ALL matches (a hand-authored file may carry duplicate entries for the\n  // same normalized key) so no stale duplicate survives the removal.\n  const removed: RuntimeFieldDefinition[] = [];\n  const fields = file.fields.filter((definition) => {\n    if (normalizeFieldKey(definition.key) === normalizedKey) {\n      removed.push(definition);\n      return false;\n    }\n    return true;\n  });\n  if (removed.length === 0) {\n    return { file: { fields }, removed: false };\n  }\n  return { file: { fields }, removed: true, definition: removed[0] };\n}\n\nfunction applyOptionalString(\n  definition: RuntimeFieldDefinition,\n  key: string,\n  value: string | undefined,\n): void {\n  const record = definition as unknown as Record<string, unknown>;\n  if (value !== undefined && value.length > 0) {\n    record[key] = value;\n  } else {\n    delete record[key];\n  }\n}\n\nfunction applyBooleanFlag(\n  definition: RuntimeFieldDefinition,\n  key: string,\n  value: boolean,\n): void {\n  const record = definition as unknown as Record<string, unknown>;\n  if (value) {\n    record[key] = true;\n  } else {\n    delete record[key];\n  }\n}\n"],"names":[],"mappings":"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","debugId":"d385bfd4-56bb-5b73-9769-b443473e139a"}
+{"version":3,"file":"fields-file.js","sources":["core/schema/fields-file.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/schema/fields-file\n *\n * Resolves configurable schema, fields, statuses, and workflows for Fields File.\n */\nimport {\n  RUNTIME_FIELD_COMMAND_VALUES,\n  RUNTIME_FIELD_TYPE_VALUES,\n} from \"../../types/index.js\";\nimport type {\n  RuntimeFieldCommand,\n  RuntimeFieldDefinition,\n  RuntimeFieldType,\n} from \"../../types/index.js\";\nimport { FRONT_MATTER_KEY_ORDER } from \"../shared/constants.js\";\n\nexport type {\n  RuntimeFieldCommand,\n  RuntimeFieldDefinition,\n  RuntimeFieldType,\n} from \"../../types/index.js\";\n\n/**\n * Pure logic for the `pm schema add-field` / `pm schema remove-field` commands\n * and the `list-fields` / `show-field` inspectors. The CLI command file\n * (schema.ts) owns IO/governance; everything testable and side-effect-free lives\n * here so it can be coverage-gated to 100%.\n *\n * Custom fields persist at `.agents/pm/schema/fields.json` under the shape\n * `{ fields: RuntimeFieldDefinition[] }`. The runtime merge layer\n * (loadRuntimeSchemaFromOptionalFiles) reads that file and dynamically registers\n * a CLI flag per field on create/update/list/search/context, so this module only\n * has to manage the persisted entries; it never duplicates the registration.\n */\n\nconst RUNTIME_FIELD_TYPE_SET = new Set<string>(RUNTIME_FIELD_TYPE_VALUES);\nconst RUNTIME_FIELD_COMMAND_SET = new Set<string>(RUNTIME_FIELD_COMMAND_VALUES);\n\n/** Built-in front-matter field names a custom field key must never shadow. A custom key that collides with one of these would let `pm create --<key>` write over reserved metadata, so add-field rejects them up front (symmetric with the built-in-type guard in item-types-file.ts). */\nexport const BUILTIN_FIELD_KEYS: ReadonlySet<string> = new Set([\n  ...FRONT_MATTER_KEY_ORDER.filter((key) => key !== \"severity\"),\n  \"id\",\n  \"title\",\n  \"type\",\n  \"status\",\n  \"priority\",\n  \"tags\",\n  \"assignee\",\n  \"parent\",\n  \"description\",\n  \"body\",\n  \"created_at\",\n  \"updated_at\",\n  \"closed_at\",\n  \"author\",\n  \"deadline\",\n  \"estimate\",\n  \"sprint\",\n  \"release\",\n  \"risk\",\n  \"confidence\",\n  \"reviewer\",\n  \"resolution\",\n  \"expected\",\n  \"actual\",\n]);\n\n/** The default commands a field is wired onto when `--commands` is omitted, matching the runtime default in runtime-schema.ts (normalizeRuntimeFieldDefinition). */\nconst DEFAULT_FIELD_COMMANDS: RuntimeFieldCommand[] = [\"create\", \"update\"];\n\n/** The shape persisted at `.agents/pm/schema/fields.json`. */\nexport interface FieldsFile {\n  /** Value that configures or reports fields for this contract. */\n  fields: RuntimeFieldDefinition[];\n}\n\n/** Documents the raw add field input payload exchanged by command, SDK, and package integrations. */\nexport interface RawAddFieldInput {\n  /** Value that configures or reports key for this contract. */\n  key: string | undefined;\n  /** Schema type that determines the shape and validation rules for this value. */\n  type?: string;\n  /** Value that configures or reports commands for this contract. */\n  commands?: string[];\n  /** Value that configures or reports description for this contract. */\n  description?: string;\n  /** Value that configures or reports cli flag for this contract. */\n  cliFlag?: string;\n  /** Value that configures or reports aliases for this contract. */\n  aliases?: string[];\n  /** Value that configures or reports required for this contract. */\n  required?: boolean;\n  /** Value that configures or reports required on create for this contract. */\n  requiredOnCreate?: boolean;\n  /** Value that configures or reports allow unset for this contract. */\n  allowUnset?: boolean;\n  /** Value that configures or reports required types for this contract. */\n  requiredTypes?: string[];\n}\n\n/** Documents the normalized add field input payload exchanged by command, SDK, and package integrations. */\nexport interface NormalizedAddFieldInput {\n  /** Value that configures or reports key for this contract. */\n  key: string;\n  /** Schema type that determines the shape and validation rules for this value. */\n  type: RuntimeFieldType;\n  /** Value that configures or reports commands for this contract. */\n  commands: RuntimeFieldCommand[];\n  /** Value that configures or reports description for this contract. */\n  description?: string;\n  /** Value that configures or reports cli flag for this contract. */\n  cliFlag?: string;\n  /** Value that configures or reports cli aliases for this contract. */\n  cliAliases: string[];\n  /** Value that configures or reports required for this contract. */\n  required: boolean;\n  /** Value that configures or reports required on create for this contract. */\n  requiredOnCreate: boolean;\n  /** Value that configures or reports allow unset for this contract. */\n  allowUnset: boolean;\n  /** Value that configures or reports required types for this contract. */\n  requiredTypes: string[];\n}\n\n/** Documents the upsert field result payload exchanged by command, SDK, and package integrations. */\nexport interface UpsertFieldResult {\n  /** Value that configures or reports file for this contract. */\n  file: FieldsFile;\n  /** The definition as stored after the upsert. */\n  definition: RuntimeFieldDefinition;\n  /** True when an existing definition with the same (normalized) key was replaced. */\n  replaced: boolean;\n}\n\n/** Documents the remove field result payload exchanged by command, SDK, and package integrations. */\nexport interface RemoveFieldResult {\n  /** Value that configures or reports file for this contract. */\n  file: FieldsFile;\n  /** True when a matching definition existed and was dropped from the file. */\n  removed: boolean;\n  /** The removed definition, when one matched the requested key. */\n  definition?: RuntimeFieldDefinition;\n}\n\n/** Normalizes a field key using the same rule as runtime-schema.ts: lowercase and collapse any run of whitespace/hyphens into a single underscore. */\nexport function normalizeFieldKey(value: unknown): string {\n  return typeof value === \"string\"\n    ? value\n        .trim()\n        .toLowerCase()\n        .replaceAll(/[\\s-]+/g, \"_\")\n    : \"\";\n}\n\n/** Normalizes a CLI flag token: strip a leading `--`, lowercase, and collapse whitespace/underscore runs to a single hyphen (matches normalizeCliToken in runtime-schema.ts). */\nfunction normalizeCliToken(value: unknown): string {\n  if (typeof value !== \"string\") {\n    return \"\";\n  }\n  const collapsed = value\n    .trim()\n    .toLowerCase()\n    .replaceAll(/[\\s_]+/g, \"-\");\n  return collapsed.startsWith(\"--\") ? collapsed.slice(2) : collapsed;\n}\n\nfunction keyToDefaultCliFlag(key: string): string {\n  return key.replaceAll(\"_\", \"-\");\n}\n\nfunction dedupeCliTokens(values: Iterable<string>, exclude: string): string[] {\n  const seen = new Set<string>();\n  for (const value of values) {\n    const token = normalizeCliToken(value);\n    if (token.length > 0 && token !== exclude) {\n      seen.add(token);\n    }\n  }\n  return [...seen].sort((left, right) => left.localeCompare(right));\n}\n\nfunction dedupeStringList(values: string[] | undefined): string[] {\n  const seen = new Set<string>();\n  for (const value of values ?? []) {\n    const trimmed = value.trim();\n    if (trimmed.length > 0) {\n      seen.add(trimmed);\n    }\n  }\n  return [...seen].sort((left, right) => left.localeCompare(right));\n}\n\n/** Normalizes the command allow-list stored for a custom field definition. */\nfunction normalizeFieldCommands(\n  rawCommands: string[] | undefined,\n): RuntimeFieldCommand[] {\n  const seen = new Set<string>();\n  const normalized: RuntimeFieldCommand[] = [];\n  for (const rawCommand of rawCommands ?? []) {\n    const command = rawCommand.trim().toLowerCase();\n    if (command.length === 0) {\n      continue;\n    }\n    if (!RUNTIME_FIELD_COMMAND_SET.has(command)) {\n      throw new Error(\n        `Invalid field command \"${rawCommand}\". Allowed: ${RUNTIME_FIELD_COMMAND_VALUES.join(\", \")}.`,\n      );\n    }\n    if (!seen.has(command)) {\n      seen.add(command);\n      normalized.push(command as RuntimeFieldCommand);\n    }\n  }\n  return rawCommands === undefined || normalized.length === 0\n    ? [...DEFAULT_FIELD_COMMANDS]\n    : normalized;\n}\n\n/** Validates and normalizes raw add-field CLI input. Throws a plain Error with a stable message when the key is missing/empty, collides with a built-in field, or carries an invalid type/command; the CLI layer maps these to PmCliError exit codes. A `string_array` type implies a repeatable field downstream (runtime-schema.ts derives `repeatable`), so no separate repeatable flag is exposed. */\nexport function normalizeAddFieldInput(\n  raw: RawAddFieldInput,\n): NormalizedAddFieldInput {\n  const key = normalizeFieldKey(raw.key);\n  if (key.length === 0) {\n    throw new Error(\"Field key must not be empty.\");\n  }\n  if (BUILTIN_FIELD_KEYS.has(key)) {\n    throw new Error(\n      `Cannot define custom field \"${key}\": custom schema field \"${key}\" collides with built-in item metadata \"${key}\". Rename the custom field with a project-specific prefix. Reserved fields: ${[...BUILTIN_FIELD_KEYS].sort((left, right) => left.localeCompare(right)).join(\", \")}.`,\n    );\n  }\n\n  const typeCandidate =\n    typeof raw.type === \"string\" && raw.type.trim().length > 0\n      ? raw.type.trim().toLowerCase()\n      : \"string\";\n  if (!RUNTIME_FIELD_TYPE_SET.has(typeCandidate)) {\n    throw new Error(\n      `Invalid field type \"${raw.type}\". Allowed: ${RUNTIME_FIELD_TYPE_VALUES.join(\", \")}.`,\n    );\n  }\n  const type = typeCandidate as RuntimeFieldType;\n\n  const commands = normalizeFieldCommands(raw.commands);\n\n  const cliFlagToken = normalizeCliToken(raw.cliFlag);\n  const cliFlag =\n    cliFlagToken.length > 0 && cliFlagToken !== keyToDefaultCliFlag(key)\n      ? cliFlagToken\n      : undefined;\n  const effectiveFlag = cliFlag ?? keyToDefaultCliFlag(key);\n  const cliAliases = dedupeCliTokens(raw.aliases ?? [], effectiveFlag);\n\n  const description = raw.description?.trim();\n  return {\n    key,\n    type,\n    commands,\n    description:\n      description && description.length > 0 ? description : undefined,\n    cliFlag,\n    cliAliases,\n    required: raw.required === true,\n    requiredOnCreate: raw.requiredOnCreate === true,\n    // allow_unset defaults to true (omitted) and is only persisted when an\n    // operator explicitly disables it with --no-allow-unset (allowUnset === false).\n    allowUnset: raw.allowUnset !== false,\n    requiredTypes: dedupeStringList(raw.requiredTypes),\n  };\n}\n\nfunction selectFieldsArray(parsed: unknown): unknown[] | undefined {\n  if (Array.isArray(parsed)) {\n    return parsed;\n  }\n  if (typeof parsed !== \"object\" || parsed === null) {\n    return undefined;\n  }\n  const record = parsed as Record<string, unknown>;\n  if (Array.isArray(record.fields)) {\n    return record.fields;\n  }\n  if (Array.isArray(record.definitions)) {\n    return record.definitions;\n  }\n  return undefined;\n}\n\nfunction extractFieldDefinitions(parsed: unknown): RuntimeFieldDefinition[] {\n  const candidate = selectFieldsArray(parsed);\n  if (!candidate) {\n    return [];\n  }\n  const definitions: RuntimeFieldDefinition[] = [];\n  for (const entry of candidate) {\n    if (typeof entry !== \"object\" || entry === null || Array.isArray(entry)) {\n      continue;\n    }\n    const record = entry as Record<string, unknown>;\n    if (typeof record.key !== \"string\" || record.key.trim().length === 0) {\n      continue;\n    }\n    definitions.push(record as unknown as RuntimeFieldDefinition);\n  }\n  return definitions;\n}\n\n/** Coerces an arbitrary parsed value from fields.json into a FieldsFile. Accepts the canonical `{ fields: [...] }` shape, a bare array, or a `{ definitions: [...] }` form, and tolerates a missing/invalid file by returning an empty fields list. */\nexport function parseFieldsFile(raw: string | null | undefined): FieldsFile {\n  if (raw === null || raw === undefined || raw.trim().length === 0) {\n    return { fields: [] };\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    throw new Error(\"schema/fields.json contains invalid JSON.\");\n  }\n  return { fields: extractFieldDefinitions(parsed) };\n}\n\n/** Serializes the fields file with a trailing newline (matches the rest of the schema scaffold files written by pm). */\nexport function serializeFieldsFile(file: FieldsFile): string {\n  return `${JSON.stringify({ fields: file.fields }, null, 2)}\\n`;\n}\n\n/** Idempotent UPSERT of a custom field into the parsed file. Matching is by normalized key. When a definition already exists, the supplied input fully replaces its add-field-managed attributes (type/commands/description/flags/ required flags) while preserving any unrelated keys the file may carry; any `metadata_key` already stored is preserved so existing item data keeps mapping to the same front-matter column. */\nexport function upsertField(\n  file: FieldsFile,\n  input: NormalizedAddFieldInput,\n): UpsertFieldResult {\n  // Match by normalized key. A hand-authored file may carry more than one entry\n  // for the same key, so drop ALL matches and re-insert a single merged result\n  // (collapsing duplicates) rather than only rewriting the first occurrence. The\n  // first existing match seeds preserved attributes (e.g. metadata_key).\n  const existing = file.fields.find(\n    (definition) => normalizeFieldKey(definition.key) === input.key,\n  );\n  const replaced = existing !== undefined;\n  const fields = file.fields.filter(\n    (definition) => normalizeFieldKey(definition.key) !== input.key,\n  );\n\n  const next: RuntimeFieldDefinition = {\n    ...existing,\n    key: input.key,\n    type: input.type,\n    commands: [...input.commands],\n  };\n  applyOptionalString(next, \"description\", input.description);\n  applyOptionalString(next, \"cli_flag\", input.cliFlag);\n  if (input.cliAliases.length > 0) {\n    next.cli_aliases = [...input.cliAliases];\n  } else {\n    delete next.cli_aliases;\n  }\n  applyBooleanFlag(next, \"required\", input.required);\n  applyBooleanFlag(next, \"required_on_create\", input.requiredOnCreate);\n  // allow_unset defaults true; only persist the explicit false override.\n  if (input.allowUnset === false) {\n    next.allow_unset = false;\n  } else {\n    delete next.allow_unset;\n  }\n  if (input.requiredTypes.length > 0) {\n    next.required_types = [...input.requiredTypes];\n  } else {\n    delete next.required_types;\n  }\n\n  fields.push(next);\n  fields.sort((left, right) =>\n    normalizeFieldKey(left.key).localeCompare(normalizeFieldKey(right.key)),\n  );\n\n  return {\n    file: { fields },\n    definition: next,\n    replaced,\n  };\n}\n\n/** Removes a custom field definition from the parsed file by key (normalized). Throws a plain Error when `key` is empty. Returns `removed: false` when no matching definition exists so the CLI layer can treat the call as an idempotent no-op. */\nexport function removeField(\n  file: FieldsFile,\n  key: string | undefined,\n): RemoveFieldResult {\n  const normalizedKey = normalizeFieldKey(key);\n  if (normalizedKey.length === 0) {\n    throw new Error(\"Field key must not be empty.\");\n  }\n  // Remove ALL matches (a hand-authored file may carry duplicate entries for the\n  // same normalized key) so no stale duplicate survives the removal.\n  const removed: RuntimeFieldDefinition[] = [];\n  const fields = file.fields.filter((definition) => {\n    if (normalizeFieldKey(definition.key) === normalizedKey) {\n      removed.push(definition);\n      return false;\n    }\n    return true;\n  });\n  if (removed.length === 0) {\n    return { file: { fields }, removed: false };\n  }\n  return { file: { fields }, removed: true, definition: removed[0] };\n}\n\nfunction applyOptionalString(\n  definition: RuntimeFieldDefinition,\n  key: string,\n  value: string | undefined,\n): void {\n  const record = definition as unknown as Record<string, unknown>;\n  if (value !== undefined && value.length > 0) {\n    record[key] = value;\n  } else {\n    delete record[key];\n  }\n}\n\nfunction applyBooleanFlag(\n  definition: RuntimeFieldDefinition,\n  key: string,\n  value: boolean,\n): void {\n  const record = definition as unknown as Record<string, unknown>;\n  if (value) {\n    record[key] = true;\n  } else {\n    delete record[key];\n  }\n}\n"],"names":[],"mappings":"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","debugId":"5b67948f-d13c-52e4-8e6a-6ba23768d589"}

package/dist/sdk/cli-contracts/flag-contracts.js

@@ -7,7 +7,7 @@
  * flag surface stays single-sourced across the CLI, SDK, and MCP boundaries.
  */
 
-!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]="74cc7aa4-edb9-57ae-88c3-f647aa0ea552")}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]="e26b7593-5802-5d28-9e65-f7437a3c6c65")}catch(e){}}();
 import { normalizeUniqueStringList } from "./string-lists.js";
 function normalizeFlagAliasKey(flag) {
     if (!flag.startsWith("--")) {
@@ -435,6 +435,7 @@ export const PLAN_FLAG_CONTRACTS = [
     { flag: "--validation-command", aliases: ["--validation_command"] },
     { flag: "--validation-expected", aliases: ["--validation_expected"] },
     { flag: "--depth" },
+    { flag: "--field" },
     { flag: "--fields", list: true },
     { flag: "--steps" },
     { flag: "--materialize-type", aliases: ["--materialize_type"] },
@@ -685,6 +686,15 @@ export const CLAIM_FLAG_CONTRACTS = [
     { flag: "--force" },
     { flag: "--if-available" },
     { flag: "--next" },
+    { flag: "--type" },
+    { flag: "--tag" },
+    { flag: "--priority" },
+    { flag: "--assignee-filter" },
+    { flag: "--parent" },
+    { flag: "--sprint" },
+    { flag: "--release" },
+    { flag: "--max-attempts" },
+    { flag: "--include-decisions" },
 ];
 /** Public contract for restore flag contracts, shared by SDK and presentation-layer consumers. */
 export const RESTORE_FLAG_CONTRACTS = [
@@ -1563,4 +1573,4 @@ export function toCompletionFlagString(flagContracts, includeGlobal = true) {
     return normalizeUniqueStringList(all).join(" ");
 }
 //# sourceMappingURL=flag-contracts.js.map
-//# debugId=74cc7aa4-edb9-57ae-88c3-f647aa0ea552
+//# debugId=e26b7593-5802-5d28-9e65-f7437a3c6c65