@unbrained/pm-cli 2026.7.11 → 2026.7.12

package/dist/cli-bundle/chunks/{chunk-2HNZKLHV.js → chunk-7SHFQB2A.js}

@@ -2,11 +2,11 @@
 !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]="0293afd9-6db0-5680-83bc-e16c04838b33")}catch(e){}}();
 import {
   lintProjectProfile
-} from "./chunk-6APTSPP5.js";
+} from "./chunk-7SIWW7C3.js";
 import {
   describeExtensionActivation,
   renderExtensionSurfaceMarkdown
-} from "./chunk-RA2LPP6E.js";
+} from "./chunk-JM4Z53DN.js";
 import {
   getMigrationRuntimeDefinition,
   resolveRegisteredSearchProvider,
@@ -36,7 +36,7 @@ import {
   runPreflightOverride,
   runRendererOverride,
   runServiceOverride
-} from "./chunk-QCKPSFII.js";
+} from "./chunk-AHIEDSW2.js";
 
 // dist/sdk/compose.js
 function defineExtension(module) {
@@ -1454,6 +1454,6 @@ export {
   assertExtensionPreflight,
   createExtensionTestHarness
 };
-//# sourceMappingURL=chunk-2HNZKLHV.js.map
+//# sourceMappingURL=chunk-7SHFQB2A.js.map
 
 //# debugId=0293afd9-6db0-5680-83bc-e16c04838b33

package/dist/cli-bundle/chunks/{chunk-6APTSPP5.js → chunk-7SIWW7C3.js}

@@ -11,15 +11,15 @@ import {
   TYPE_PRESET_DEFINITIONS,
   normalizeAddFieldInput,
   normalizeAddStatusInput
-} from "./chunk-VTOQH22Y.js";
+} from "./chunk-A2HZUSEA.js";
 import {
   normalizeAddTypeInput
-} from "./chunk-EEUIIDWF.js";
+} from "./chunk-UGQENMKM.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   DEFAULT_RUNTIME_STATUS_DEFINITIONS,
   toErrorMessage
-} from "./chunk-QCKPSFII.js";
+} from "./chunk-AHIEDSW2.js";
 
 // dist/core/profile/profile-presets.js
 var PROFILE_NAMES = ["agile", "ops", "research"];
@@ -668,6 +668,6 @@ export {
   PROFILE_LINT_CODES,
   lintProjectProfile
 };
-//# sourceMappingURL=chunk-6APTSPP5.js.map
+//# sourceMappingURL=chunk-7SIWW7C3.js.map
 
 //# debugId=7d0a5087-e290-5a6c-9641-82badd28de0c

package/dist/cli-bundle/chunks/{chunk-7HQQT6AT.js → chunk-7TYZTBEV.js}

@@ -4,7 +4,7 @@ import {
   nowIso,
   readSettings,
   writeSettings
-} from "./chunk-NAGOH4YJ.js";
+} from "./chunk-VXUWCJS7.js";
 import {
   EXIT_CODE,
   appendLineAtomic,
@@ -13,7 +13,7 @@ import {
   resolvePmPackageRootFromModule,
   resolveTelemetryErrorCategory,
   writeFileAtomic
-} from "./chunk-QCKPSFII.js";
+} from "./chunk-AHIEDSW2.js";
 
 // dist/core/telemetry/observability.js
 var SETUP_ROOT_COMMANDS = /* @__PURE__ */ new Set([
@@ -1828,6 +1828,6 @@ export {
   finishTelemetryCommand,
   emitTelemetryErrorEvent
 };
-//# sourceMappingURL=chunk-7HQQT6AT.js.map
+//# sourceMappingURL=chunk-7TYZTBEV.js.map
 
 //# debugId=494a8428-0a48-5a0c-b53f-182ebda2ea6d

package/dist/cli-bundle/chunks/{chunk-VTOQH22Y.js → chunk-A2HZUSEA.js}

@@ -1,15 +1,16 @@
 
-!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]="b50a9692-fc32-5944-8b60-b0734ec2b1f2")}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]="530967bb-33df-5861-80bf-b398d42eab3a")}catch(e){}}();
 import {
   normalizeAddTypeInput
-} from "./chunk-EEUIIDWF.js";
+} from "./chunk-UGQENMKM.js";
 import {
   DEFAULT_RUNTIME_STATUS_DEFINITIONS,
+  FRONT_MATTER_KEY_ORDER,
   RUNTIME_FIELD_COMMAND_VALUES,
   RUNTIME_FIELD_TYPE_VALUES,
   RUNTIME_STATUS_ROLE_VALUES,
   evictOldestMemoEntries
-} from "./chunk-QCKPSFII.js";
+} from "./chunk-AHIEDSW2.js";
 
 // dist/core/schema/status-defs-file.js
 var RUNTIME_STATUS_ROLE_SET = new Set(RUNTIME_STATUS_ROLE_VALUES);
@@ -204,6 +205,7 @@ function assertStatusTokensAvailable(input, resolvedAliasToId) {
 var RUNTIME_FIELD_TYPE_SET = new Set(RUNTIME_FIELD_TYPE_VALUES);
 var RUNTIME_FIELD_COMMAND_SET = new Set(RUNTIME_FIELD_COMMAND_VALUES);
 var BUILTIN_FIELD_KEYS = /* @__PURE__ */ new Set([
+  ...FRONT_MATTER_KEY_ORDER.filter((key) => key !== "severity"),
   "id",
   "title",
   "type",
@@ -287,7 +289,7 @@ 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() : "string";
   if (!RUNTIME_FIELD_TYPE_SET.has(typeCandidate)) {
@@ -526,6 +528,6 @@ export {
   normalizeTypePresetName,
   resolveTypePresetDefinitions
 };
-//# sourceMappingURL=chunk-VTOQH22Y.js.map
+//# sourceMappingURL=chunk-A2HZUSEA.js.map
 
-//# debugId=b50a9692-fc32-5944-8b60-b0734ec2b1f2
+//# debugId=530967bb-33df-5861-80bf-b398d42eab3a

package/dist/cli-bundle/chunks/{chunk-VTOQH22Y.js.map → chunk-A2HZUSEA.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../core/schema/status-defs-file.ts","../../../../../../../../core/schema/fields-file.ts","../../../../../../../../core/schema/type-presets.ts"],"sourcesContent":["/**\n * @module core/schema/status-defs-file\n *\n * Resolves configurable schema, fields, statuses, and workflows for Status Defs File.\n */\nimport { RUNTIME_STATUS_ROLE_VALUES } from \"../../types/index.js\";\nimport type {\n  RuntimeStatusDefinition,\n  RuntimeStatusRole,\n} from \"../../types/index.js\";\nimport { DEFAULT_RUNTIME_STATUS_DEFINITIONS } from \"./runtime-schema.js\";\nimport { evictOldestMemoEntries } from \"../shared/memo.js\";\n\nexport type {\n  RuntimeStatusDefinition,\n  RuntimeStatusRole,\n} from \"../../types/index.js\";\n\n/**\n * Pure logic for the `pm schema add-status` / `pm schema remove-status`\n * commands. The CLI command file (schema.ts) owns IO/governance; everything\n * testable and side-effect-free lives here so it can be coverage-gated to 100%.\n *\n * Statuses persist at `.agents/pm/schema/statuses.json` under the shape\n * `{ statuses: RuntimeStatusDefinition[] }`. When the file is absent the runtime\n * merge layer (src/core/store/settings.ts) still supplies the built-in defaults\n * from DEFAULT_RUNTIME_STATUS_DEFINITIONS, so this module never duplicates them\n * into the persisted file.\n */\n\nconst RUNTIME_STATUS_ROLE_SET = new Set<string>(RUNTIME_STATUS_ROLE_VALUES);\n\n/**\n * Memo for {@link normalizeStatusToken}. Status ranking inside sort comparators\n * normalizes the same handful of status strings O(n log n) times per corpus scan, and\n * the trim/lowercase/regex pipeline shows up in list/next/context profiles. The cap\n * bounds memory in long-lived hosts against unbounded arbitrary inputs; half-eviction keeps the\n * newest-inserted half when the cap is hit. Declared before\n * BUILTIN_STATUS_IDS, whose module-level initializer already normalizes tokens.\n */\nconst STATUS_TOKEN_MEMO_MAX_ENTRIES = 2_000;\nconst statusTokenMemo = new Map<string, string>();\n\n/** The 5 lifecycle status ids that ship as built-in defaults and may never be removed (their normalized ids match DEFAULT_RUNTIME_STATUS_DEFINITIONS: open/in_progress/blocked/closed/canceled). `draft` is also a default but the acceptance criteria enumerate the 5 terminal/active ids explicitly, so the guard derives the full set from the canonical defaults to stay in sync. */\nexport const BUILTIN_STATUS_IDS: ReadonlySet<string> = new Set(\n  DEFAULT_RUNTIME_STATUS_DEFINITIONS.map((definition) =>\n    normalizeStatusToken(definition.id),\n  ).filter((id) => id.length > 0),\n);\n\n/** The shape persisted at `.agents/pm/schema/statuses.json`. */\nexport interface StatusDefsFile {\n  /** Value that configures or reports statuses for this contract. */\n  statuses: RuntimeStatusDefinition[];\n}\n\n/** Documents the raw add status input payload exchanged by command, SDK, and package integrations. */\nexport interface RawAddStatusInput {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string | undefined;\n  /** Value that configures or reports roles for this contract. */\n  roles?: string[];\n  /** Value that configures or reports aliases for this contract. */\n  aliases?: string[];\n  /** Value that configures or reports description for this contract. */\n  description?: string;\n  /** Value that configures or reports order for this contract. */\n  order?: number;\n}\n\n/** Documents the normalized add status input payload exchanged by command, SDK, and package integrations. */\nexport interface NormalizedAddStatusInput {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Normalized roles, or `undefined` when the raw input did not supply a roles field at all. `undefined` means \"leave existing roles untouched\" on upsert; an explicit empty array means \"clear roles\". This distinction is what keeps `add-status review --description x` from wiping a previously-set role. */\n  roles?: RuntimeStatusRole[];\n  /** Same omitted-vs-explicit-empty semantics as `roles`. */\n  aliases?: string[];\n  /** Value that configures or reports description for this contract. */\n  description?: string;\n  /** Value that configures or reports order for this contract. */\n  order?: number;\n}\n\n/** Documents the upsert status def result payload exchanged by command, SDK, and package integrations. */\nexport interface UpsertStatusDefResult {\n  /** Value that configures or reports file for this contract. */\n  file: StatusDefsFile;\n  /** The definition as stored after the upsert (existing fields preserved). */\n  definition: RuntimeStatusDefinition;\n  /** True when an existing definition with the same (normalized) id was replaced. */\n  replaced: boolean;\n}\n\n/** Documents the remove status def result payload exchanged by command, SDK, and package integrations. */\nexport interface RemoveStatusDefResult {\n  /** Value that configures or reports file for this contract. */\n  file: StatusDefsFile;\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 id. */\n  definition?: RuntimeStatusDefinition;\n}\n\n/** Normalizes a status token using the same rules as runtime-schema.ts: lowercase and collapse any run of whitespace/hyphens into a single underscore. */\nexport function normalizeStatusToken(value: unknown): string {\n  if (typeof value !== \"string\") {\n    return \"\";\n  }\n  const memoized = statusTokenMemo.get(value);\n  if (memoized !== undefined) {\n    return memoized;\n  }\n  const normalized = value\n    .trim()\n    .toLowerCase()\n    .replaceAll(/[\\s-]+/g, \"_\");\n  if (statusTokenMemo.size >= STATUS_TOKEN_MEMO_MAX_ENTRIES) {\n    evictOldestMemoEntries(statusTokenMemo);\n  }\n  statusTokenMemo.set(value, normalized);\n  return normalized;\n}\n\nfunction dedupeTokens(values: Iterable<string>): string[] {\n  const seen = new Set<string>();\n  for (const value of values) {\n    const token = normalizeStatusToken(value);\n    if (token.length > 0) {\n      seen.add(token);\n    }\n  }\n  return [...seen].sort((left, right) => left.localeCompare(right));\n}\n\n/**\n * Validates and normalizes raw add-status CLI input. Throws a plain Error with a\n * stable message when the id is missing/empty or a role is not one of\n * RUNTIME_STATUS_ROLE_VALUES; the CLI layer maps these to PmCliError exit codes.\n *\n * Omitted vs explicit-empty is preserved end-to-end: when `raw.roles`/`raw.aliases`\n * is `undefined` (flag not supplied) the normalized field is `undefined` so the\n * upsert leaves the existing value untouched; when supplied (even an empty array)\n * the field is normalized to an array so the upsert can apply an explicit clear.\n */\nexport function normalizeAddStatusInput(\n  raw: RawAddStatusInput,\n): NormalizedAddStatusInput {\n  const id = normalizeStatusToken(raw.id);\n  if (id.length === 0) {\n    throw new Error(\"Status id must not be empty.\");\n  }\n  // Built-in lifecycle statuses are reserved and cannot be overridden: an\n  // add-status override would change reserved metadata yet remove-status refuses\n  // to delete a built-in id, leaving no CLI path to undo it. Reject up front,\n  // symmetric with removeStatusDef.\n  if (BUILTIN_STATUS_IDS.has(id)) {\n    throw new Error(\n      `Cannot add-status the built-in status \"${id}\". Built-in statuses are reserved: ${[...BUILTIN_STATUS_IDS].join(\", \")}.`,\n    );\n  }\n  let roles: RuntimeStatusRole[] | undefined;\n  if (raw.roles !== undefined) {\n    roles = [];\n    const seenRoles = new Set<string>();\n    for (const rawRole of raw.roles) {\n      const role =\n        typeof rawRole === \"string\" ? rawRole.trim().toLowerCase() : \"\";\n      if (role.length === 0) {\n        continue;\n      }\n      if (!RUNTIME_STATUS_ROLE_SET.has(role)) {\n        throw new Error(\n          `Invalid status role \"${rawRole}\". Allowed roles: ${RUNTIME_STATUS_ROLE_VALUES.join(\", \")}.`,\n        );\n      }\n      if (!seenRoles.has(role)) {\n        seenRoles.add(role);\n        roles.push(role as RuntimeStatusRole);\n      }\n    }\n  }\n  const aliases =\n    raw.aliases === undefined\n      ? undefined\n      : dedupeTokens(raw.aliases).filter((alias) => alias !== id);\n  const description = raw.description?.trim();\n  const order =\n    typeof raw.order === \"number\" && Number.isFinite(raw.order)\n      ? Math.trunc(raw.order)\n      : undefined;\n  return {\n    id,\n    roles,\n    aliases,\n    description:\n      description && description.length > 0 ? description : undefined,\n    order,\n  };\n}\n\nfunction selectStatusesArray(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.statuses)) {\n    return record.statuses;\n  }\n  if (Array.isArray(record.definitions)) {\n    return record.definitions;\n  }\n  return undefined;\n}\n\nfunction extractStatusDefinitions(parsed: unknown): RuntimeStatusDefinition[] {\n  const candidate = selectStatusesArray(parsed);\n  if (!candidate) {\n    return [];\n  }\n  const definitions: RuntimeStatusDefinition[] = [];\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.id !== \"string\" || record.id.trim().length === 0) {\n      continue;\n    }\n    definitions.push(record as unknown as RuntimeStatusDefinition);\n  }\n  return definitions;\n}\n\n/** Coerces an arbitrary parsed value from statuses.json into a StatusDefsFile. Accepts the canonical `{ statuses: [...] }` shape, a bare array of definitions, or a `{ definitions: [...] }` form, and tolerates a missing/invalid file by returning an empty statuses list. */\nexport function parseStatusDefsFile(\n  raw: string | null | undefined,\n): StatusDefsFile {\n  if (raw === null || raw === undefined || raw.trim().length === 0) {\n    return { statuses: [] };\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    throw new Error(\"schema/statuses.json contains invalid JSON.\");\n  }\n  return { statuses: extractStatusDefinitions(parsed) };\n}\n\n/** Serializes the status definitions file with a trailing newline (matches the rest of the schema scaffold files written by pm). */\nexport function serializeStatusDefsFile(file: StatusDefsFile): string {\n  return `${JSON.stringify({ statuses: file.statuses }, null, 2)}\\n`;\n}\n\n/** Idempotent UPSERT of a status definition into the parsed file. Matching is by normalized id. When a definition already exists, fields supplied in `input` override the previous values (roles/aliases replace when a non-empty array is given, clear when an explicit empty array is given, and are left UNTOUCHED when the field is `undefined` — i.e. the add-status flag was omitted); description/order override when provided. Fields not addressed by add-status flags are preserved untouched, so `add-status <id> --description x` keeps any previously-set roles/aliases. */\nexport function upsertStatusDef(\n  file: StatusDefsFile,\n  input: NormalizedAddStatusInput,\n  baseDefinition?: RuntimeStatusDefinition,\n): UpsertStatusDefResult {\n  const statuses = file.statuses.slice();\n  const existingIndex = statuses.findIndex(\n    (definition) => normalizeStatusToken(definition.id) === input.id,\n  );\n  // A file-backed definition is the primary seed; when the status is not yet in\n  // statuses.json fall back to `baseDefinition` (the resolved settings-backed\n  // definition) so omitting --role/--alias preserves metadata that lives in\n  // settings.schema.statuses rather than the file.\n  const existing =\n    existingIndex >= 0 ? statuses[existingIndex] : baseDefinition;\n\n  const next: RuntimeStatusDefinition = {\n    ...existing,\n    id: input.id,\n  };\n  if (input.roles !== undefined) {\n    if (input.roles.length > 0) {\n      next.roles = [...input.roles];\n    } else if (next.roles !== undefined) {\n      delete next.roles;\n    }\n  }\n  if (input.aliases !== undefined) {\n    if (input.aliases.length > 0) {\n      next.aliases = [...input.aliases];\n    } else if (next.aliases !== undefined) {\n      delete next.aliases;\n    }\n  }\n  if (input.description !== undefined) {\n    next.description = input.description;\n  }\n  if (input.order !== undefined) {\n    next.order = input.order;\n  }\n\n  if (existingIndex >= 0) {\n    statuses[existingIndex] = next;\n  } else {\n    statuses.push(next);\n  }\n\n  return {\n    file: { statuses },\n    definition: next,\n    // \"replaced\" reflects whether the status already existed effectively (in the\n    // file OR in resolved settings), so the CLI reports \"Updated\" vs \"Registered\"\n    // correctly even when the prior definition lived only in settings.\n    replaced: existing !== undefined,\n  };\n}\n\n/** Removes a status definition from the parsed file by id (normalized). Throws a plain Error when `id` is empty or matches a reserved built-in default status (those are never stored in the file and must never be deletable). Returns `removed: false` when no matching definition exists so the CLI layer can treat the call as an idempotent no-op. */\nexport function removeStatusDef(\n  file: StatusDefsFile,\n  id: string | undefined,\n): RemoveStatusDefResult {\n  const normalizedId = normalizeStatusToken(id);\n  if (normalizedId.length === 0) {\n    throw new Error(\"Status id must not be empty.\");\n  }\n  if (BUILTIN_STATUS_IDS.has(normalizedId)) {\n    throw new Error(\n      `Cannot remove built-in status \"${normalizedId}\". Built-in statuses are reserved: ${[...BUILTIN_STATUS_IDS].join(\", \")}.`,\n    );\n  }\n  const statuses = file.statuses.slice();\n  const existingIndex = statuses.findIndex(\n    (definition) => normalizeStatusToken(definition.id) === normalizedId,\n  );\n  if (existingIndex < 0) {\n    return { file: { statuses }, removed: false };\n  }\n  const [definition] = statuses.splice(existingIndex, 1);\n  return { file: { statuses }, removed: true, definition };\n}\n\n/** Throws when the new status id or any explicitly-supplied alias collides with a DIFFERENT existing status's id/alias. `resolvedAliasToId` maps a normalized token to its owning status id (the runtime status registry's alias_to_id map, which stores ids and aliases in one namespace). Re-adding the same status (matching id) is allowed — only cross-status collisions throw. This prevents a custom status from shadowing a built-in lifecycle token (for example `add-status review --alias open`, or a custom id `cancelled` that aliases the built-in `canceled`), which would make `pm update --status open` resolve to the wrong status. The CLI layer maps the thrown Error to a USAGE exit code. */\nexport function assertStatusTokensAvailable(\n  input: { id: string; aliases?: string[] },\n  resolvedAliasToId: ReadonlyMap<string, string>,\n): void {\n  const candidates = [input.id, ...(input.aliases ?? [])];\n  for (const candidate of candidates) {\n    const token = normalizeStatusToken(candidate);\n    if (token.length === 0) {\n      continue;\n    }\n    const owner = resolvedAliasToId.get(token);\n    if (owner !== undefined && owner !== input.id) {\n      throw new Error(\n        `Status token \"${token}\" already belongs to status \"${owner}\". Choose a different id/alias to avoid shadowing it.`,\n      );\n    }\n  }\n}\n","/**\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","/**\n * @module core/schema/type-presets\n *\n * Resolves configurable schema, fields, statuses, and workflows for Type Presets.\n */\nimport {\n  normalizeAddTypeInput,\n  type NormalizedAddTypeInput,\n  type RawAddTypeInput,\n} from \"./item-types-file.js\";\n\n/** Shared domain item-type presets. These power both `pm init --type-preset` (registered during initialization) and the standalone `pm schema apply-preset` subcommand (adopting a preset into an already-initialized project). Keeping the raw definitions and the preset-name normalizer in one place guarantees init and schema register byte-identical types. */\n\nexport const TYPE_PRESET_NAMES = [\"agile\", \"ops\", \"research\"] as const;\n/** Restricts type preset name values accepted by command, SDK, and storage contracts. */\nexport type TypePresetName = (typeof TYPE_PRESET_NAMES)[number];\n\n/**\n * Raw (pre-normalization) preset definitions keyed by preset name. Each entry is\n * fed through {@link normalizeAddTypeInput} before being upserted so the same\n * validation/normalization the `pm schema add-type` CLI applies governs preset\n * registration too.\n */\nexport const TYPE_PRESET_DEFINITIONS: Record<\n  TypePresetName,\n  RawAddTypeInput[]\n> = {\n  agile: [\n    {\n      name: \"Story\",\n      description:\n        \"User-facing outcome or capability slice expressed from a stakeholder perspective.\",\n      defaultStatus: \"open\",\n      folder: \"stories\",\n      aliases: [\"user-story\"],\n    },\n    {\n      name: \"Spike\",\n      description:\n        \"Time-boxed investigation used to reduce uncertainty before implementation.\",\n      defaultStatus: \"open\",\n      folder: \"spikes\",\n      aliases: [\"research-spike\"],\n    },\n  ],\n  ops: [\n    {\n      name: \"Incident\",\n      description:\n        \"Operational disruption, degradation, or support escalation with recovery tracking.\",\n      defaultStatus: \"open\",\n      folder: \"incidents\",\n      aliases: [\"outage\"],\n    },\n    {\n      name: \"Runbook\",\n      description:\n        \"Repeatable operational procedure, diagnostic path, or response playbook.\",\n      defaultStatus: \"open\",\n      folder: \"runbooks\",\n      aliases: [\"playbook\"],\n    },\n  ],\n  research: [\n    {\n      name: \"Experiment\",\n      description:\n        \"Validated-learning activity with hypothesis, method, and outcome tracking.\",\n      defaultStatus: \"open\",\n      folder: \"experiments\",\n      aliases: [\"study\"],\n    },\n    {\n      name: \"Hypothesis\",\n      description:\n        \"Testable claim or assumption that should be supported, rejected, or refined.\",\n      defaultStatus: \"open\",\n      folder: \"hypotheses\",\n      aliases: [\"assumption\"],\n    },\n  ],\n};\n\n/** Validates and normalizes a raw preset-name CLI value. Returns `undefined` when the value is omitted (no preset requested). Throws a plain Error with a stable message for an empty or unknown preset; CLI layers map it to a USAGE exit code. Accepts hyphen/underscore-insensitive casing for ergonomics. */\nexport function normalizeTypePresetName(\n  rawValue: string | undefined,\n): TypePresetName | undefined {\n  if (rawValue === undefined) {\n    return undefined;\n  }\n  const normalized = rawValue.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  if (normalized.length === 0) {\n    throw new Error(\"Type preset name must not be empty.\");\n  }\n  if (\n    normalized === \"agile\" ||\n    normalized === \"ops\" ||\n    normalized === \"research\"\n  ) {\n    return normalized;\n  }\n  throw new Error(\n    `Invalid type preset \"${rawValue}\". Allowed: ${TYPE_PRESET_NAMES.join(\", \")}.`,\n  );\n}\n\n/** Returns the normalized add-type inputs for a preset, in the order they should be upserted. Each raw definition is run through normalizeAddTypeInput so callers get the same validated shape as an individual `add-type` invocation. */\nexport function resolveTypePresetDefinitions(\n  preset: TypePresetName,\n): NormalizedAddTypeInput[] {\n  return TYPE_PRESET_DEFINITIONS[preset].map((rawDefinition) =>\n    normalizeAddTypeInput(rawDefinition),\n  );\n}\n"],"names":["definition"],"mappings":"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","debugId":"b50a9692-fc32-5944-8b60-b0734ec2b1f2"}
+{"version":3,"sources":["../../../../../../../../core/schema/status-defs-file.ts","../../../../../../../../core/schema/fields-file.ts","../../../../../../../../core/schema/type-presets.ts"],"sourcesContent":["/**\n * @module core/schema/status-defs-file\n *\n * Resolves configurable schema, fields, statuses, and workflows for Status Defs File.\n */\nimport { RUNTIME_STATUS_ROLE_VALUES } from \"../../types/index.js\";\nimport type {\n  RuntimeStatusDefinition,\n  RuntimeStatusRole,\n} from \"../../types/index.js\";\nimport { DEFAULT_RUNTIME_STATUS_DEFINITIONS } from \"./runtime-schema.js\";\nimport { evictOldestMemoEntries } from \"../shared/memo.js\";\n\nexport type {\n  RuntimeStatusDefinition,\n  RuntimeStatusRole,\n} from \"../../types/index.js\";\n\n/**\n * Pure logic for the `pm schema add-status` / `pm schema remove-status`\n * commands. The CLI command file (schema.ts) owns IO/governance; everything\n * testable and side-effect-free lives here so it can be coverage-gated to 100%.\n *\n * Statuses persist at `.agents/pm/schema/statuses.json` under the shape\n * `{ statuses: RuntimeStatusDefinition[] }`. When the file is absent the runtime\n * merge layer (src/core/store/settings.ts) still supplies the built-in defaults\n * from DEFAULT_RUNTIME_STATUS_DEFINITIONS, so this module never duplicates them\n * into the persisted file.\n */\n\nconst RUNTIME_STATUS_ROLE_SET = new Set<string>(RUNTIME_STATUS_ROLE_VALUES);\n\n/**\n * Memo for {@link normalizeStatusToken}. Status ranking inside sort comparators\n * normalizes the same handful of status strings O(n log n) times per corpus scan, and\n * the trim/lowercase/regex pipeline shows up in list/next/context profiles. The cap\n * bounds memory in long-lived hosts against unbounded arbitrary inputs; half-eviction keeps the\n * newest-inserted half when the cap is hit. Declared before\n * BUILTIN_STATUS_IDS, whose module-level initializer already normalizes tokens.\n */\nconst STATUS_TOKEN_MEMO_MAX_ENTRIES = 2_000;\nconst statusTokenMemo = new Map<string, string>();\n\n/** The 5 lifecycle status ids that ship as built-in defaults and may never be removed (their normalized ids match DEFAULT_RUNTIME_STATUS_DEFINITIONS: open/in_progress/blocked/closed/canceled). `draft` is also a default but the acceptance criteria enumerate the 5 terminal/active ids explicitly, so the guard derives the full set from the canonical defaults to stay in sync. */\nexport const BUILTIN_STATUS_IDS: ReadonlySet<string> = new Set(\n  DEFAULT_RUNTIME_STATUS_DEFINITIONS.map((definition) =>\n    normalizeStatusToken(definition.id),\n  ).filter((id) => id.length > 0),\n);\n\n/** The shape persisted at `.agents/pm/schema/statuses.json`. */\nexport interface StatusDefsFile {\n  /** Value that configures or reports statuses for this contract. */\n  statuses: RuntimeStatusDefinition[];\n}\n\n/** Documents the raw add status input payload exchanged by command, SDK, and package integrations. */\nexport interface RawAddStatusInput {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string | undefined;\n  /** Value that configures or reports roles for this contract. */\n  roles?: string[];\n  /** Value that configures or reports aliases for this contract. */\n  aliases?: string[];\n  /** Value that configures or reports description for this contract. */\n  description?: string;\n  /** Value that configures or reports order for this contract. */\n  order?: number;\n}\n\n/** Documents the normalized add status input payload exchanged by command, SDK, and package integrations. */\nexport interface NormalizedAddStatusInput {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Normalized roles, or `undefined` when the raw input did not supply a roles field at all. `undefined` means \"leave existing roles untouched\" on upsert; an explicit empty array means \"clear roles\". This distinction is what keeps `add-status review --description x` from wiping a previously-set role. */\n  roles?: RuntimeStatusRole[];\n  /** Same omitted-vs-explicit-empty semantics as `roles`. */\n  aliases?: string[];\n  /** Value that configures or reports description for this contract. */\n  description?: string;\n  /** Value that configures or reports order for this contract. */\n  order?: number;\n}\n\n/** Documents the upsert status def result payload exchanged by command, SDK, and package integrations. */\nexport interface UpsertStatusDefResult {\n  /** Value that configures or reports file for this contract. */\n  file: StatusDefsFile;\n  /** The definition as stored after the upsert (existing fields preserved). */\n  definition: RuntimeStatusDefinition;\n  /** True when an existing definition with the same (normalized) id was replaced. */\n  replaced: boolean;\n}\n\n/** Documents the remove status def result payload exchanged by command, SDK, and package integrations. */\nexport interface RemoveStatusDefResult {\n  /** Value that configures or reports file for this contract. */\n  file: StatusDefsFile;\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 id. */\n  definition?: RuntimeStatusDefinition;\n}\n\n/** Normalizes a status token using the same rules as runtime-schema.ts: lowercase and collapse any run of whitespace/hyphens into a single underscore. */\nexport function normalizeStatusToken(value: unknown): string {\n  if (typeof value !== \"string\") {\n    return \"\";\n  }\n  const memoized = statusTokenMemo.get(value);\n  if (memoized !== undefined) {\n    return memoized;\n  }\n  const normalized = value\n    .trim()\n    .toLowerCase()\n    .replaceAll(/[\\s-]+/g, \"_\");\n  if (statusTokenMemo.size >= STATUS_TOKEN_MEMO_MAX_ENTRIES) {\n    evictOldestMemoEntries(statusTokenMemo);\n  }\n  statusTokenMemo.set(value, normalized);\n  return normalized;\n}\n\nfunction dedupeTokens(values: Iterable<string>): string[] {\n  const seen = new Set<string>();\n  for (const value of values) {\n    const token = normalizeStatusToken(value);\n    if (token.length > 0) {\n      seen.add(token);\n    }\n  }\n  return [...seen].sort((left, right) => left.localeCompare(right));\n}\n\n/**\n * Validates and normalizes raw add-status CLI input. Throws a plain Error with a\n * stable message when the id is missing/empty or a role is not one of\n * RUNTIME_STATUS_ROLE_VALUES; the CLI layer maps these to PmCliError exit codes.\n *\n * Omitted vs explicit-empty is preserved end-to-end: when `raw.roles`/`raw.aliases`\n * is `undefined` (flag not supplied) the normalized field is `undefined` so the\n * upsert leaves the existing value untouched; when supplied (even an empty array)\n * the field is normalized to an array so the upsert can apply an explicit clear.\n */\nexport function normalizeAddStatusInput(\n  raw: RawAddStatusInput,\n): NormalizedAddStatusInput {\n  const id = normalizeStatusToken(raw.id);\n  if (id.length === 0) {\n    throw new Error(\"Status id must not be empty.\");\n  }\n  // Built-in lifecycle statuses are reserved and cannot be overridden: an\n  // add-status override would change reserved metadata yet remove-status refuses\n  // to delete a built-in id, leaving no CLI path to undo it. Reject up front,\n  // symmetric with removeStatusDef.\n  if (BUILTIN_STATUS_IDS.has(id)) {\n    throw new Error(\n      `Cannot add-status the built-in status \"${id}\". Built-in statuses are reserved: ${[...BUILTIN_STATUS_IDS].join(\", \")}.`,\n    );\n  }\n  let roles: RuntimeStatusRole[] | undefined;\n  if (raw.roles !== undefined) {\n    roles = [];\n    const seenRoles = new Set<string>();\n    for (const rawRole of raw.roles) {\n      const role =\n        typeof rawRole === \"string\" ? rawRole.trim().toLowerCase() : \"\";\n      if (role.length === 0) {\n        continue;\n      }\n      if (!RUNTIME_STATUS_ROLE_SET.has(role)) {\n        throw new Error(\n          `Invalid status role \"${rawRole}\". Allowed roles: ${RUNTIME_STATUS_ROLE_VALUES.join(\", \")}.`,\n        );\n      }\n      if (!seenRoles.has(role)) {\n        seenRoles.add(role);\n        roles.push(role as RuntimeStatusRole);\n      }\n    }\n  }\n  const aliases =\n    raw.aliases === undefined\n      ? undefined\n      : dedupeTokens(raw.aliases).filter((alias) => alias !== id);\n  const description = raw.description?.trim();\n  const order =\n    typeof raw.order === \"number\" && Number.isFinite(raw.order)\n      ? Math.trunc(raw.order)\n      : undefined;\n  return {\n    id,\n    roles,\n    aliases,\n    description:\n      description && description.length > 0 ? description : undefined,\n    order,\n  };\n}\n\nfunction selectStatusesArray(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.statuses)) {\n    return record.statuses;\n  }\n  if (Array.isArray(record.definitions)) {\n    return record.definitions;\n  }\n  return undefined;\n}\n\nfunction extractStatusDefinitions(parsed: unknown): RuntimeStatusDefinition[] {\n  const candidate = selectStatusesArray(parsed);\n  if (!candidate) {\n    return [];\n  }\n  const definitions: RuntimeStatusDefinition[] = [];\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.id !== \"string\" || record.id.trim().length === 0) {\n      continue;\n    }\n    definitions.push(record as unknown as RuntimeStatusDefinition);\n  }\n  return definitions;\n}\n\n/** Coerces an arbitrary parsed value from statuses.json into a StatusDefsFile. Accepts the canonical `{ statuses: [...] }` shape, a bare array of definitions, or a `{ definitions: [...] }` form, and tolerates a missing/invalid file by returning an empty statuses list. */\nexport function parseStatusDefsFile(\n  raw: string | null | undefined,\n): StatusDefsFile {\n  if (raw === null || raw === undefined || raw.trim().length === 0) {\n    return { statuses: [] };\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    throw new Error(\"schema/statuses.json contains invalid JSON.\");\n  }\n  return { statuses: extractStatusDefinitions(parsed) };\n}\n\n/** Serializes the status definitions file with a trailing newline (matches the rest of the schema scaffold files written by pm). */\nexport function serializeStatusDefsFile(file: StatusDefsFile): string {\n  return `${JSON.stringify({ statuses: file.statuses }, null, 2)}\\n`;\n}\n\n/** Idempotent UPSERT of a status definition into the parsed file. Matching is by normalized id. When a definition already exists, fields supplied in `input` override the previous values (roles/aliases replace when a non-empty array is given, clear when an explicit empty array is given, and are left UNTOUCHED when the field is `undefined` — i.e. the add-status flag was omitted); description/order override when provided. Fields not addressed by add-status flags are preserved untouched, so `add-status <id> --description x` keeps any previously-set roles/aliases. */\nexport function upsertStatusDef(\n  file: StatusDefsFile,\n  input: NormalizedAddStatusInput,\n  baseDefinition?: RuntimeStatusDefinition,\n): UpsertStatusDefResult {\n  const statuses = file.statuses.slice();\n  const existingIndex = statuses.findIndex(\n    (definition) => normalizeStatusToken(definition.id) === input.id,\n  );\n  // A file-backed definition is the primary seed; when the status is not yet in\n  // statuses.json fall back to `baseDefinition` (the resolved settings-backed\n  // definition) so omitting --role/--alias preserves metadata that lives in\n  // settings.schema.statuses rather than the file.\n  const existing =\n    existingIndex >= 0 ? statuses[existingIndex] : baseDefinition;\n\n  const next: RuntimeStatusDefinition = {\n    ...existing,\n    id: input.id,\n  };\n  if (input.roles !== undefined) {\n    if (input.roles.length > 0) {\n      next.roles = [...input.roles];\n    } else if (next.roles !== undefined) {\n      delete next.roles;\n    }\n  }\n  if (input.aliases !== undefined) {\n    if (input.aliases.length > 0) {\n      next.aliases = [...input.aliases];\n    } else if (next.aliases !== undefined) {\n      delete next.aliases;\n    }\n  }\n  if (input.description !== undefined) {\n    next.description = input.description;\n  }\n  if (input.order !== undefined) {\n    next.order = input.order;\n  }\n\n  if (existingIndex >= 0) {\n    statuses[existingIndex] = next;\n  } else {\n    statuses.push(next);\n  }\n\n  return {\n    file: { statuses },\n    definition: next,\n    // \"replaced\" reflects whether the status already existed effectively (in the\n    // file OR in resolved settings), so the CLI reports \"Updated\" vs \"Registered\"\n    // correctly even when the prior definition lived only in settings.\n    replaced: existing !== undefined,\n  };\n}\n\n/** Removes a status definition from the parsed file by id (normalized). Throws a plain Error when `id` is empty or matches a reserved built-in default status (those are never stored in the file and must never be deletable). Returns `removed: false` when no matching definition exists so the CLI layer can treat the call as an idempotent no-op. */\nexport function removeStatusDef(\n  file: StatusDefsFile,\n  id: string | undefined,\n): RemoveStatusDefResult {\n  const normalizedId = normalizeStatusToken(id);\n  if (normalizedId.length === 0) {\n    throw new Error(\"Status id must not be empty.\");\n  }\n  if (BUILTIN_STATUS_IDS.has(normalizedId)) {\n    throw new Error(\n      `Cannot remove built-in status \"${normalizedId}\". Built-in statuses are reserved: ${[...BUILTIN_STATUS_IDS].join(\", \")}.`,\n    );\n  }\n  const statuses = file.statuses.slice();\n  const existingIndex = statuses.findIndex(\n    (definition) => normalizeStatusToken(definition.id) === normalizedId,\n  );\n  if (existingIndex < 0) {\n    return { file: { statuses }, removed: false };\n  }\n  const [definition] = statuses.splice(existingIndex, 1);\n  return { file: { statuses }, removed: true, definition };\n}\n\n/** Throws when the new status id or any explicitly-supplied alias collides with a DIFFERENT existing status's id/alias. `resolvedAliasToId` maps a normalized token to its owning status id (the runtime status registry's alias_to_id map, which stores ids and aliases in one namespace). Re-adding the same status (matching id) is allowed — only cross-status collisions throw. This prevents a custom status from shadowing a built-in lifecycle token (for example `add-status review --alias open`, or a custom id `cancelled` that aliases the built-in `canceled`), which would make `pm update --status open` resolve to the wrong status. The CLI layer maps the thrown Error to a USAGE exit code. */\nexport function assertStatusTokensAvailable(\n  input: { id: string; aliases?: string[] },\n  resolvedAliasToId: ReadonlyMap<string, string>,\n): void {\n  const candidates = [input.id, ...(input.aliases ?? [])];\n  for (const candidate of candidates) {\n    const token = normalizeStatusToken(candidate);\n    if (token.length === 0) {\n      continue;\n    }\n    const owner = resolvedAliasToId.get(token);\n    if (owner !== undefined && owner !== input.id) {\n      throw new Error(\n        `Status token \"${token}\" already belongs to status \"${owner}\". Choose a different id/alias to avoid shadowing it.`,\n      );\n    }\n  }\n}\n","/**\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","/**\n * @module core/schema/type-presets\n *\n * Resolves configurable schema, fields, statuses, and workflows for Type Presets.\n */\nimport {\n  normalizeAddTypeInput,\n  type NormalizedAddTypeInput,\n  type RawAddTypeInput,\n} from \"./item-types-file.js\";\n\n/** Shared domain item-type presets. These power both `pm init --type-preset` (registered during initialization) and the standalone `pm schema apply-preset` subcommand (adopting a preset into an already-initialized project). Keeping the raw definitions and the preset-name normalizer in one place guarantees init and schema register byte-identical types. */\n\nexport const TYPE_PRESET_NAMES = [\"agile\", \"ops\", \"research\"] as const;\n/** Restricts type preset name values accepted by command, SDK, and storage contracts. */\nexport type TypePresetName = (typeof TYPE_PRESET_NAMES)[number];\n\n/**\n * Raw (pre-normalization) preset definitions keyed by preset name. Each entry is\n * fed through {@link normalizeAddTypeInput} before being upserted so the same\n * validation/normalization the `pm schema add-type` CLI applies governs preset\n * registration too.\n */\nexport const TYPE_PRESET_DEFINITIONS: Record<\n  TypePresetName,\n  RawAddTypeInput[]\n> = {\n  agile: [\n    {\n      name: \"Story\",\n      description:\n        \"User-facing outcome or capability slice expressed from a stakeholder perspective.\",\n      defaultStatus: \"open\",\n      folder: \"stories\",\n      aliases: [\"user-story\"],\n    },\n    {\n      name: \"Spike\",\n      description:\n        \"Time-boxed investigation used to reduce uncertainty before implementation.\",\n      defaultStatus: \"open\",\n      folder: \"spikes\",\n      aliases: [\"research-spike\"],\n    },\n  ],\n  ops: [\n    {\n      name: \"Incident\",\n      description:\n        \"Operational disruption, degradation, or support escalation with recovery tracking.\",\n      defaultStatus: \"open\",\n      folder: \"incidents\",\n      aliases: [\"outage\"],\n    },\n    {\n      name: \"Runbook\",\n      description:\n        \"Repeatable operational procedure, diagnostic path, or response playbook.\",\n      defaultStatus: \"open\",\n      folder: \"runbooks\",\n      aliases: [\"playbook\"],\n    },\n  ],\n  research: [\n    {\n      name: \"Experiment\",\n      description:\n        \"Validated-learning activity with hypothesis, method, and outcome tracking.\",\n      defaultStatus: \"open\",\n      folder: \"experiments\",\n      aliases: [\"study\"],\n    },\n    {\n      name: \"Hypothesis\",\n      description:\n        \"Testable claim or assumption that should be supported, rejected, or refined.\",\n      defaultStatus: \"open\",\n      folder: \"hypotheses\",\n      aliases: [\"assumption\"],\n    },\n  ],\n};\n\n/** Validates and normalizes a raw preset-name CLI value. Returns `undefined` when the value is omitted (no preset requested). Throws a plain Error with a stable message for an empty or unknown preset; CLI layers map it to a USAGE exit code. Accepts hyphen/underscore-insensitive casing for ergonomics. */\nexport function normalizeTypePresetName(\n  rawValue: string | undefined,\n): TypePresetName | undefined {\n  if (rawValue === undefined) {\n    return undefined;\n  }\n  const normalized = rawValue.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  if (normalized.length === 0) {\n    throw new Error(\"Type preset name must not be empty.\");\n  }\n  if (\n    normalized === \"agile\" ||\n    normalized === \"ops\" ||\n    normalized === \"research\"\n  ) {\n    return normalized;\n  }\n  throw new Error(\n    `Invalid type preset \"${rawValue}\". Allowed: ${TYPE_PRESET_NAMES.join(\", \")}.`,\n  );\n}\n\n/** Returns the normalized add-type inputs for a preset, in the order they should be upserted. Each raw definition is run through normalizeAddTypeInput so callers get the same validated shape as an individual `add-type` invocation. */\nexport function resolveTypePresetDefinitions(\n  preset: TypePresetName,\n): NormalizedAddTypeInput[] {\n  return TYPE_PRESET_DEFINITIONS[preset].map((rawDefinition) =>\n    normalizeAddTypeInput(rawDefinition),\n  );\n}\n"],"names":["definition"],"mappings":"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","debugId":"530967bb-33df-5861-80bf-b398d42eab3a"}

package/dist/cli-bundle/chunks/{chunk-YCHJLOO2.js → chunk-A6AK7W5M.js}

@@ -3,7 +3,7 @@
 import {
   renameArtifactsResultKey,
   runLinkedArtifacts
-} from "./chunk-MRMS62WQ.js";
+} from "./chunk-N4NKVLPY.js";
 
 // dist/cli/commands/docs.js
 async function runDocs(id, options, global) {
@@ -19,6 +19,6 @@ async function runDocs(id, options, global) {
 export {
   runDocs
 };
-//# sourceMappingURL=chunk-YCHJLOO2.js.map
+//# sourceMappingURL=chunk-A6AK7W5M.js.map
 
 //# debugId=44d979f8-f7b4-51e3-8fa9-14deff99d846

package/dist/cli-bundle/chunks/{chunk-WBKZAO3P.js → chunk-A6AVSYRJ.js}

@@ -13,11 +13,11 @@ import {
   readFirstStringFromCommanderOptions,
   readFirstValueFromCommanderOptions,
   readStringArrayFromCommanderOptions
-} from "./chunk-RAC2UXLT.js";
+} from "./chunk-QPWXNK56.js";
 import {
   printError,
   writeStdout
-} from "./chunk-KHQYX2QB.js";
+} from "./chunk-NN57FRRN.js";
 import {
   getActiveExtensionRegistrations,
   locateItem,
@@ -25,7 +25,7 @@ import {
   readLocatedItem,
   readSettings,
   setActiveCommandResult
-} from "./chunk-NAGOH4YJ.js";
+} from "./chunk-VXUWCJS7.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -42,7 +42,7 @@ import {
   toNonEmptyString,
   trimTrailingSlashes,
   writeFileAtomic
-} from "./chunk-QCKPSFII.js";
+} from "./chunk-AHIEDSW2.js";
 
 // dist/cli/registration-helpers.js
 import { Option } from "commander";
@@ -2952,6 +2952,6 @@ export {
   normalizeNextOptions,
   invalidateSearchCachesForMutation
 };
-//# sourceMappingURL=chunk-WBKZAO3P.js.map
+//# sourceMappingURL=chunk-A6AVSYRJ.js.map
 
 //# debugId=032faa13-18ae-5f7a-857d-2fdaae69e061

package/dist/cli-bundle/chunks/{chunk-L7C6RTGH.js → chunk-ACDIA6NP.js}

@@ -18,7 +18,7 @@ import {
   serializeStatusDefsFile,
   upsertField,
   upsertStatusDef
-} from "./chunk-VTOQH22Y.js";
+} from "./chunk-A2HZUSEA.js";
 import {
   assertAliasesAvailable,
   assertTypeFolderAvailable,
@@ -29,7 +29,7 @@ import {
   removeItemType,
   serializeItemTypesFile,
   upsertItemType
-} from "./chunk-EEUIIDWF.js";
+} from "./chunk-UGQENMKM.js";
 import {
   acquireLock,
   getActiveExtensionRegistrations,
@@ -38,7 +38,7 @@ import {
   readSettings,
   resolveGovernanceKnobs,
   runActiveOnWriteHooks
-} from "./chunk-NAGOH4YJ.js";
+} from "./chunk-VXUWCJS7.js";
 import {
   DEFAULT_RUNTIME_SCHEMA_FILE_PATHS,
   EXIT_CODE,
@@ -54,7 +54,7 @@ import {
   resolveRuntimeStatusRegistry,
   toDefaultFolder,
   writeFileAtomic
-} from "./chunk-QCKPSFII.js";
+} from "./chunk-AHIEDSW2.js";
 
 // dist/cli/commands/schema.js
 import path from "node:path";
@@ -1234,6 +1234,6 @@ export {
   formatSchemaInferTypesHuman,
   _testOnlySchemaCommand
 };
-//# sourceMappingURL=chunk-L7C6RTGH.js.map
+//# sourceMappingURL=chunk-ACDIA6NP.js.map
 
 //# debugId=fc95baf3-54c2-5083-a7ff-1d7109f317f7

package/dist/cli-bundle/chunks/{chunk-AX3BJLPV.js → chunk-ACRC3HI4.js}

@@ -3,7 +3,7 @@
 import {
   getRuntimePath,
   writeFileAtomic
-} from "./chunk-QCKPSFII.js";
+} from "./chunk-AHIEDSW2.js";
 
 // dist/core/session/session-state.js
 import { promises as fs } from "node:fs";
@@ -53,6 +53,6 @@ export {
   setFocusedItem,
   clearFocusedItem
 };
-//# sourceMappingURL=chunk-AX3BJLPV.js.map
+//# sourceMappingURL=chunk-ACRC3HI4.js.map
 
 //# debugId=fe0c58a0-d285-583a-abd6-66aa25b9b668

package/dist/cli-bundle/chunks/{chunk-QCKPSFII.js → chunk-AHIEDSW2.js}

@@ -1,6 +1,6 @@
 // dist/core/fs/fs-utils.js
 
-!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]="8b0bcf40-ba69-5567-9b6e-bdb3f26a7310")}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]="4f2ff373-1138-591c-a14c-08dc453352cc")}catch(e){}}();
 import * as fs from "node:fs/promises";
 import path from "node:path";
 import crypto from "node:crypto";
@@ -4714,28 +4714,38 @@ var ExtensionApiRegistrar = class {
     });
   }
   applyImportExportCommandMetadata(method, commandPath, options) {
-    if (options === void 0) {
-      return;
-    }
-    if (typeof options !== "object" || options === null || Array.isArray(options)) {
+    if (options !== void 0 && (typeof options !== "object" || options === null || Array.isArray(options))) {
       throw new TypeError(`${method} options must be an object when provided`);
     }
-    assertOptionalStringField(`${method} options.action`, options.action);
-    assertOptionalStringField(`${method} options.description`, options.description);
-    assertOptionalStringField(`${method} options.intent`, options.intent);
-    const action = resolveCommandDefinitionAction(commandPath, options.action);
-    const examples = normalizeOptionalStringArrayField(`${method} options.examples`, options.examples);
-    const failureHints = normalizeOptionalStringArrayField(`${method} options.failure_hints`, options.failure_hints);
-    const argumentsDefinition = normalizeCommandDefinitionArguments(options.arguments);
-    if (options.flags !== void 0) {
+    const defaultDescription = `${method === "registerImporter" ? "Import" : "Export"} items with the registered extension adapter.`;
+    const defaultArguments = [
+      {
+        name: "file",
+        required: false,
+        description: "Optional input or output file path."
+      }
+    ];
+    const resolvedOptions = {
+      ...options,
+      description: options?.description ?? defaultDescription,
+      arguments: options?.arguments ?? defaultArguments
+    };
+    assertOptionalStringField(`${method} options.action`, resolvedOptions.action);
+    assertOptionalStringField(`${method} options.description`, resolvedOptions.description);
+    assertOptionalStringField(`${method} options.intent`, resolvedOptions.intent);
+    const action = resolveCommandDefinitionAction(commandPath, resolvedOptions.action);
+    const examples = normalizeOptionalStringArrayField(`${method} options.examples`, resolvedOptions.examples);
+    const failureHints = normalizeOptionalStringArrayField(`${method} options.failure_hints`, resolvedOptions.failure_hints);
+    const argumentsDefinition = normalizeCommandDefinitionArguments(resolvedOptions.arguments);
+    if (resolvedOptions.flags !== void 0) {
       assertExtensionCapability(this.#loadedExtension, "schema", `${method} options.flags`);
       if (this.allowRegistration("schema.flags", `${method} options.flags`, "schema")) {
-        validateFlagDefinitions(options.flags);
+        validateFlagDefinitions(resolvedOptions.flags);
         this.#registrationRegistry.flags.push({
           layer: this.#loadedExtension.layer,
           name: this.#loadedExtension.name,
           target_command: commandPath,
-          flags: normalizeRegistrationRecordList(`${method} options.flags`, options.flags)
+          flags: normalizeRegistrationRecordList(`${method} options.flags`, resolvedOptions.flags)
         });
       }
     }
@@ -4749,11 +4759,11 @@ var ExtensionApiRegistrar = class {
       failure_hints: failureHints,
       arguments: argumentsDefinition
     };
-    const description = options.description?.trim();
+    const description = resolvedOptions.description?.trim();
     if (description) {
       registration.description = description;
     }
-    const intent = options.intent?.trim();
+    const intent = resolvedOptions.intent?.trim();
     if (intent) {
       registration.intent = intent;
     }
@@ -5964,7 +5974,7 @@ function assertNotReservedItemFieldName(fieldName) {
   if (!RESERVED_ITEM_FIELD_NAMES.has(fieldName)) {
     return;
   }
-  throw new PmCliError(`Extension item field "${fieldName}" collides with reserved item metadata`, EXIT_CODE.USAGE, {
+  throw new PmCliError(`Extension item field "${fieldName}" collides with built-in item metadata "${fieldName}"; rename the extension field with an extension-specific prefix. Reserved fields: ${[...RESERVED_ITEM_FIELD_NAMES].sort((left, right) => left.localeCompare(right)).join(", ")}.`, EXIT_CODE.USAGE, {
     code: "extension_item_field_reserved",
     nextSteps: [
       "Rename the extension item field, preferably with an extension-specific prefix."
@@ -6219,6 +6229,6 @@ export {
   parseRegisteredItemFieldAssignments,
   applyRegisteredItemFieldDefaultsAndValidation
 };
-//# sourceMappingURL=chunk-QCKPSFII.js.map
+//# sourceMappingURL=chunk-AHIEDSW2.js.map
 
-//# debugId=8b0bcf40-ba69-5567-9b6e-bdb3f26a7310
+//# debugId=4f2ff373-1138-591c-a14c-08dc453352cc