@unbrained/pm-cli 2026.6.13 → 2026.6.17

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

@@ -0,0 +1 @@
+{"version":3,"file":"fields-file.js","sources":["core/schema/fields-file.ts"],"sourceRoot":"/","sourcesContent":["import {\n  RUNTIME_FIELD_COMMAND_VALUES,\n  RUNTIME_FIELD_TYPE_VALUES,\n} from \"../../types/index.js\";\nimport type { RuntimeFieldCommand, RuntimeFieldDefinition, RuntimeFieldType } from \"../../types/index.js\";\n\nexport type { RuntimeFieldCommand, RuntimeFieldDefinition, RuntimeFieldType } 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/**\n * Built-in front-matter field names a custom field key must never shadow. A\n * custom key that collides with one of these would let `pm create --<key>` write\n * over reserved metadata, so add-field rejects them up front (symmetric with the\n * built-in-type guard in item-types-file.ts).\n */\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/**\n * The default commands a field is wired onto when `--commands` is omitted,\n * matching the runtime default in runtime-schema.ts (normalizeRuntimeFieldDefinition).\n */\nconst DEFAULT_FIELD_COMMANDS: RuntimeFieldCommand[] = [\"create\", \"update\"];\n\n/**\n * The shape persisted at `.agents/pm/schema/fields.json`.\n */\nexport interface FieldsFile {\n  fields: RuntimeFieldDefinition[];\n}\n\nexport interface RawAddFieldInput {\n  key: string | undefined;\n  type?: string;\n  commands?: string[];\n  description?: string;\n  cliFlag?: string;\n  aliases?: string[];\n  required?: boolean;\n  requiredOnCreate?: boolean;\n  allowUnset?: boolean;\n  requiredTypes?: string[];\n}\n\nexport interface NormalizedAddFieldInput {\n  key: string;\n  type: RuntimeFieldType;\n  commands: RuntimeFieldCommand[];\n  description?: string;\n  cliFlag?: string;\n  cliAliases: string[];\n  required: boolean;\n  requiredOnCreate: boolean;\n  allowUnset: boolean;\n  requiredTypes: string[];\n}\n\nexport interface UpsertFieldResult {\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\nexport interface RemoveFieldResult {\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/**\n * Normalizes a field key using the same rule as runtime-schema.ts: lowercase and\n * collapse any run of whitespace/hyphens into a single underscore.\n */\nexport function normalizeFieldKey(value: unknown): string {\n  return typeof value === \"string\" ? value.trim().toLowerCase().replaceAll(/[\\s-]+/g, \"_\") : \"\";\n}\n\n/**\n * Normalizes a CLI flag token: strip a leading `--`, lowercase, and collapse\n * whitespace/underscore runs to a single hyphen (matches normalizeCliToken in\n * runtime-schema.ts).\n */\nfunction normalizeCliToken(value: unknown): string {\n  if (typeof value !== \"string\") {\n    return \"\";\n  }\n  const collapsed = value.trim().toLowerCase().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/**\n * Validates and normalizes raw add-field CLI input. Throws a plain Error with a\n * stable message when the key is missing/empty, collides with a built-in field,\n * or carries an invalid type/command; the CLI layer maps these to PmCliError\n * exit codes. A `string_array` type implies a repeatable field downstream\n * (runtime-schema.ts derives `repeatable`), so no separate repeatable flag is\n * exposed.\n */\nexport function normalizeAddFieldInput(raw: RawAddFieldInput): 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 = typeof raw.type === \"string\" && raw.type.trim().length > 0 ? raw.type.trim().toLowerCase() : \"string\";\n  if (!RUNTIME_FIELD_TYPE_SET.has(typeCandidate)) {\n    throw new Error(`Invalid field type \"${raw.type}\". Allowed: ${RUNTIME_FIELD_TYPE_VALUES.join(\", \")}.`);\n  }\n  const type = typeCandidate as RuntimeFieldType;\n\n  let commands: RuntimeFieldCommand[];\n  if (raw.commands === undefined) {\n    commands = [...DEFAULT_FIELD_COMMANDS];\n  } else {\n    const seen = new Set<string>();\n    const normalized: RuntimeFieldCommand[] = [];\n    for (const rawCommand of raw.commands) {\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(`Invalid field command \"${rawCommand}\". Allowed: ${RUNTIME_FIELD_COMMAND_VALUES.join(\", \")}.`);\n      }\n      if (!seen.has(command)) {\n        seen.add(command);\n        normalized.push(command as RuntimeFieldCommand);\n      }\n    }\n    commands = normalized.length > 0 ? normalized : [...DEFAULT_FIELD_COMMANDS];\n  }\n\n  const cliFlagToken = normalizeCliToken(raw.cliFlag);\n  const cliFlag = cliFlagToken.length > 0 && cliFlagToken !== keyToDefaultCliFlag(key) ? cliFlagToken : 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: 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/**\n * Coerces an arbitrary parsed value from fields.json into a FieldsFile. Accepts\n * the canonical `{ fields: [...] }` shape, a bare array, or a `{ definitions: [...] }`\n * form, and tolerates a missing/invalid file by returning an empty fields list.\n */\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/**\n * Serializes the fields file with a trailing newline (matches the rest of the\n * schema scaffold files written by pm).\n */\nexport function serializeFieldsFile(file: FieldsFile): string {\n  return `${JSON.stringify({ fields: file.fields }, null, 2)}\\n`;\n}\n\n/**\n * Idempotent UPSERT of a custom field into the parsed file. Matching is by\n * normalized key. When a definition already exists, the supplied input fully\n * replaces its add-field-managed attributes (type/commands/description/flags/\n * required flags) while preserving any unrelated keys the file may carry; any\n * `metadata_key` already stored is preserved so existing item data keeps mapping\n * to the same front-matter column.\n */\nexport function upsertField(file: FieldsFile, input: NormalizedAddFieldInput): 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((definition) => normalizeFieldKey(definition.key) === input.key);\n  const replaced = existing !== undefined;\n  const fields = file.fields.filter((definition) => normalizeFieldKey(definition.key) !== input.key);\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) => normalizeFieldKey(left.key).localeCompare(normalizeFieldKey(right.key)));\n\n  return {\n    file: { fields },\n    definition: next,\n    replaced,\n  };\n}\n\n/**\n * Removes a custom field definition from the parsed file by key (normalized).\n * Throws a plain Error when `key` is empty. Returns `removed: false` when no\n * matching definition exists so the CLI layer can treat the call as an\n * idempotent no-op.\n */\nexport function removeField(file: FieldsFile, key: string | undefined): 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(definition: RuntimeFieldDefinition, key: string, value: string | undefined): 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(definition: RuntimeFieldDefinition, key: string, value: boolean): 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":"01bca6b9-49d3-5785-9d18-8399a0aac293"}

package/dist/core/schema/item-types-file.d.ts

@@ -26,6 +26,11 @@ export interface UpsertItemTypeResult {
     definition: ItemTypeDefinition;
     /** True when an existing definition with the same (case-insensitive) name was replaced. */
     replaced: boolean;
+    /**
+     * The canonical name of the replaced definition (only present when `replaced`).
+     * Lets the caller detect a silent recase (e.g. "Spike" -> "spike") and warn.
+     */
+    previousName?: string;
 }
 export interface RemoveItemTypeResult {
     file: ItemTypesFile;
@@ -60,6 +65,21 @@ export declare function normalizeAddTypeInput(raw: RawAddTypeInput): NormalizedA
  * upserted are ignored, keeping re-runs idempotent.
  */
 export declare function assertAliasesAvailable(input: NormalizedAddTypeInput, existing: ItemTypesFile): void;
+/**
+ * Throws when the requested type's storage folder would collide with a
+ * DIFFERENT existing definition's folder. Two distinct type names can slug to
+ * one folder ("Spike"/"Spikes", "code-review"/"code_review"), which would make
+ * their item files share a directory and silently corrupt the taxonomy. The
+ * same-named definition being upserted is ignored (folder reuse on re-run is
+ * expected). Resolving the collision is a matter of passing a distinct
+ * `--folder`, so the error says so.
+ *
+ * `reservedFolders` carries the folders already owned by built-in and extension
+ * types (folder-slug → owner name); a custom type whose slug matches one of
+ * those (e.g. "Tasks" → "tasks", owned by the built-in Task) is just as
+ * corrupting as a custom-vs-custom collision, so both are checked.
+ */
+export declare function assertTypeFolderAvailable(input: NormalizedAddTypeInput, existing: ItemTypesFile, reservedFolders?: ReadonlyMap<string, string>): void;
 /**
  * Coerces an arbitrary parsed value from types.json into an ItemTypesFile.
  * Accepts the canonical `{ definitions: [...] }` shape, a bare array of
@@ -92,9 +112,12 @@ export declare function serializeItemTypesFile(file: ItemTypesFile): string;
  * custom types exist and how to register one. Quotes are chosen so the printed
  * line is copy-pasteable as a shell command.
  */
-export declare function buildInvalidTypeHint(name: string): string;
+export declare function buildInvalidTypeHint(name: string, typesFilePath?: string): string;
 /**
  * Builds the full invalid-type error message used by create/update: the
  * existing "Invalid type ... Allowed: ..." line plus the discoverable hint.
+ * `typesFilePath` should be the resolved schema/types.json path for the active
+ * tracker (see {@link resolveItemTypesFilePath}) so the hint reflects a custom
+ * `--pm-path` instead of the hardcoded `.agents/pm` default.
  */
-export declare function buildInvalidTypeError(name: string, allowedTypes: readonly string[]): string;
+export declare function buildInvalidTypeError(name: string, allowedTypes: readonly string[], typesFilePath?: string): string;

package/dist/core/schema/item-types-file.js

@@ -1,6 +1,7 @@
 
-!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]="77a0faf1-6f19-5f27-9123-f589cf398634")}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]="995e9919-c166-505a-8821-d8a859a60ae8")}catch(e){}}();
 import { BUILTIN_ITEM_TYPE_VALUES } from "../../types/index.js";
+import { toDefaultFolder } from "../item/type-registry.js";
 /**
  * Pure logic for the `pm schema add-type` command and the create/update
  * invalid-type discoverability hint. The CLI command file (schema.ts) handles
@@ -8,6 +9,21 @@ import { BUILTIN_ITEM_TYPE_VALUES } from "../../types/index.js";
  * be coverage-gated to 100%.
  */
 const BUILTIN_NAME_LOOKUP = new Map(BUILTIN_ITEM_TYPE_VALUES.map((name) => [name.toLowerCase(), name]));
+/**
+ * Custom item type names (and aliases) must be a single letter-led identifier
+ * token: letters, digits, hyphen, or underscore — no whitespace or other
+ * punctuation. This keeps names copy-pasteable as shell arguments and folder
+ * slugs deterministic, matching the single-token PascalCase shape of every
+ * built-in type. Folder/slug overlap between two distinct valid tokens (e.g.
+ * "Spike"/"Spikes", "code-review"/"code_review") is rejected separately by
+ * assertTypeFolderAvailable.
+ */
+const TYPE_NAME_TOKEN_PATTERN = /^[A-Za-z][A-Za-z0-9_-]*$/;
+function assertValidTypeToken(value, label) {
+    if (!TYPE_NAME_TOKEN_PATTERN.test(value)) {
+        throw new Error(`${label} "${value}" is not a valid identifier. Use a single letter-led token of letters, digits, hyphen, or underscore with no spaces or punctuation (e.g. "Spike" or "code-review").`);
+    }
+}
 /**
  * Returns the canonical built-in name when `name` collides (case-insensitively)
  * with a reserved built-in item type, otherwise undefined.
@@ -55,6 +71,7 @@ export function normalizeAddTypeInput(raw) {
     if (name.length === 0) {
         throw new Error("Type name must not be empty.");
     }
+    assertValidTypeToken(name, "Type name");
     const builtinMatch = matchBuiltinTypeName(name);
     if (builtinMatch) {
         throw new Error(`Cannot redefine built-in item type "${builtinMatch}". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(", ")}.`);
@@ -64,6 +81,7 @@ export function normalizeAddTypeInput(raw) {
     const folder = raw.folder?.trim();
     const aliases = dedupeAliases(raw.aliases ?? []);
     for (const alias of aliases) {
+        assertValidTypeToken(alias, "Alias");
         const aliasBuiltin = matchBuiltinTypeName(alias);
         if (aliasBuiltin) {
             throw new Error(`Alias "${alias}" collides with built-in item type "${aliasBuiltin}". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(", ")}.`);
@@ -114,6 +132,55 @@ export function assertAliasesAvailable(input, existing) {
         }
     }
 }
+/**
+ * Resolves the storage folder a definition would use: an explicit non-empty
+ * `folder` wins, otherwise the deterministic slug derived from the name (the
+ * same derivation the runtime registry applies, single-sourced from
+ * type-registry.toDefaultFolder).
+ */
+function resolveDefinitionFolder(name, folder) {
+    if (typeof folder === "string" && folder.trim().length > 0) {
+        return folder.trim().toLowerCase();
+    }
+    return toDefaultFolder(name).toLowerCase();
+}
+/**
+ * Throws when the requested type's storage folder would collide with a
+ * DIFFERENT existing definition's folder. Two distinct type names can slug to
+ * one folder ("Spike"/"Spikes", "code-review"/"code_review"), which would make
+ * their item files share a directory and silently corrupt the taxonomy. The
+ * same-named definition being upserted is ignored (folder reuse on re-run is
+ * expected). Resolving the collision is a matter of passing a distinct
+ * `--folder`, so the error says so.
+ *
+ * `reservedFolders` carries the folders already owned by built-in and extension
+ * types (folder-slug → owner name); a custom type whose slug matches one of
+ * those (e.g. "Tasks" → "tasks", owned by the built-in Task) is just as
+ * corrupting as a custom-vs-custom collision, so both are checked.
+ */
+export function assertTypeFolderAvailable(input, existing, reservedFolders) {
+    const selfLower = input.name.toLowerCase();
+    const inputFolder = resolveDefinitionFolder(input.name, input.folder);
+    const fail = (ownerName) => {
+        throw new Error(`Item type "${input.name}" would store items in folder "${inputFolder}", which already belongs to existing item type "${ownerName}". Pass a distinct --folder to keep their storage separate.`);
+    };
+    for (const definition of existing.definitions) {
+        if (typeof definition.name !== "string") {
+            continue;
+        }
+        const definitionName = definition.name.trim();
+        if (definitionName.length === 0 || definitionName.toLowerCase() === selfLower) {
+            continue;
+        }
+        if (resolveDefinitionFolder(definitionName, definition.folder) === inputFolder) {
+            fail(definitionName);
+        }
+    }
+    const reservedOwner = reservedFolders?.get(inputFolder);
+    if (reservedOwner !== undefined && reservedOwner.toLowerCase() !== selfLower) {
+        fail(reservedOwner);
+    }
+}
 /**
  * Coerces an arbitrary parsed value from types.json into an ItemTypesFile.
  * Accepts the canonical `{ definitions: [...] }` shape, a bare array of
@@ -208,6 +275,7 @@ export function upsertItemType(file, input) {
         file: { definitions },
         definition: next,
         replaced: existingIndex >= 0,
+        ...(existing && typeof existing.name === "string" ? { previousName: existing.name } : {}),
     };
 }
 /**
@@ -253,16 +321,20 @@ export function serializeItemTypesFile(file) {
  * custom types exist and how to register one. Quotes are chosen so the printed
  * line is copy-pasteable as a shell command.
  */
-export function buildInvalidTypeHint(name) {
+export function buildInvalidTypeHint(name, typesFilePath) {
     const safeName = name.trim().length > 0 ? name.trim() : name;
-    return `To register a custom type, run: pm schema add-type "${escapeForDoubleQuotes(safeName)}" (writes .agents/pm/schema/types.json).`;
+    const target = typesFilePath?.trim() || ".agents/pm/schema/types.json";
+    return `To register a custom type, run: pm schema add-type "${escapeForDoubleQuotes(safeName)}" (writes ${target}).`;
 }
 /**
  * Builds the full invalid-type error message used by create/update: the
  * existing "Invalid type ... Allowed: ..." line plus the discoverable hint.
+ * `typesFilePath` should be the resolved schema/types.json path for the active
+ * tracker (see {@link resolveItemTypesFilePath}) so the hint reflects a custom
+ * `--pm-path` instead of the hardcoded `.agents/pm` default.
  */
-export function buildInvalidTypeError(name, allowedTypes) {
-    return `Invalid type value "${name}". Allowed: ${allowedTypes.join(", ")}. ${buildInvalidTypeHint(name)}`;
+export function buildInvalidTypeError(name, allowedTypes, typesFilePath) {
+    return `Invalid type value "${name}". Allowed: ${allowedTypes.join(", ")}. ${buildInvalidTypeHint(name, typesFilePath)}`;
 }
 //# sourceMappingURL=item-types-file.js.map
-//# debugId=77a0faf1-6f19-5f27-9123-f589cf398634
+//# debugId=995e9919-c166-505a-8821-d8a859a60ae8

package/dist/core/schema/item-types-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"item-types-file.js","sources":["core/schema/item-types-file.ts"],"sourceRoot":"/","sourcesContent":["import { BUILTIN_ITEM_TYPE_VALUES } from \"../../types/index.js\";\nimport type { ItemTypeDefinition } from \"../../types/index.js\";\n\nexport type { ItemTypeDefinition } from \"../../types/index.js\";\n\n/**\n * Pure logic for the `pm schema add-type` command and the create/update\n * invalid-type discoverability hint. The CLI command file (schema.ts) handles\n * IO/governance; everything testable and side-effect-free lives here so it can\n * be coverage-gated to 100%.\n */\n\nconst BUILTIN_NAME_LOOKUP = new Map<string, string>(\n  BUILTIN_ITEM_TYPE_VALUES.map((name) => [name.toLowerCase(), name]),\n);\n\n/**\n * The shape persisted at `.agents/pm/schema/types.json`.\n */\nexport interface ItemTypesFile {\n  definitions: ItemTypeDefinition[];\n}\n\nexport interface NormalizedAddTypeInput {\n  name: string;\n  description?: string;\n  defaultStatus?: string;\n  folder?: string;\n  aliases: string[];\n}\n\nexport interface RawAddTypeInput {\n  name: string | undefined;\n  description?: string;\n  defaultStatus?: string;\n  folder?: string;\n  aliases?: string[];\n}\n\nexport interface UpsertItemTypeResult {\n  file: ItemTypesFile;\n  /** The definition as stored after the upsert (existing fields preserved). */\n  definition: ItemTypeDefinition;\n  /** True when an existing definition with the same (case-insensitive) name was replaced. */\n  replaced: boolean;\n}\n\nexport interface RemoveItemTypeResult {\n  file: ItemTypesFile;\n  /** True when a matching definition existed and was dropped from the file. */\n  removed: boolean;\n  /** The removed definition, when one matched (case-insensitively) the requested name. */\n  definition?: ItemTypeDefinition;\n}\n\n/**\n * Returns the canonical built-in name when `name` collides (case-insensitively)\n * with a reserved built-in item type, otherwise undefined.\n */\nexport function matchBuiltinTypeName(name: string): string | undefined {\n  return BUILTIN_NAME_LOOKUP.get(name.trim().toLowerCase());\n}\n\n/**\n * Coerces a persisted `aliases` value into a string array, tolerating malformed\n * data (a non-array, or an array containing non-string entries) without throwing\n * or exploding a stray string into character aliases.\n */\nfunction coerceAliasArray(value: unknown): string[] {\n  return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === \"string\") : [];\n}\n\n/**\n * Escapes a value for safe interpolation inside a double-quoted shell string so\n * suggested copy-pasteable commands stay well-formed for names containing\n * `\"`, `` ` ``, `$`, or `\\`.\n */\nexport function escapeForDoubleQuotes(value: string): string {\n  return value.replace(/[\\\\\"`$]/g, (char) => `\\\\${char}`);\n}\n\nfunction dedupeAliases(values: Iterable<string>): string[] {\n  const seen = new Map<string, string>();\n  for (const value of values) {\n    const trimmed = value.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    const key = trimmed.toLowerCase();\n    if (!seen.has(key)) {\n      seen.set(key, trimmed);\n    }\n  }\n  return [...seen.values()].sort((left, right) => left.localeCompare(right));\n}\n\n/**\n * Validates and normalizes raw add-type CLI input. Throws a plain Error with a\n * stable message when the name is missing/empty or collides with a built-in;\n * the CLI layer maps these to PmCliError exit codes.\n */\nexport function normalizeAddTypeInput(raw: RawAddTypeInput): NormalizedAddTypeInput {\n  const name = (raw.name ?? \"\").trim();\n  if (name.length === 0) {\n    throw new Error(\"Type name must not be empty.\");\n  }\n  const builtinMatch = matchBuiltinTypeName(name);\n  if (builtinMatch) {\n    throw new Error(\n      `Cannot redefine built-in item type \"${builtinMatch}\". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(\", \")}.`,\n    );\n  }\n  const description = raw.description?.trim();\n  const defaultStatus = raw.defaultStatus?.trim();\n  const folder = raw.folder?.trim();\n  const aliases = dedupeAliases(raw.aliases ?? []);\n  for (const alias of aliases) {\n    const aliasBuiltin = matchBuiltinTypeName(alias);\n    if (aliasBuiltin) {\n      throw new Error(\n        `Alias \"${alias}\" collides with built-in item type \"${aliasBuiltin}\". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(\", \")}.`,\n      );\n    }\n  }\n  return {\n    name,\n    description: description && description.length > 0 ? description : undefined,\n    defaultStatus: defaultStatus && defaultStatus.length > 0 ? defaultStatus : undefined,\n    folder: folder && folder.length > 0 ? folder : undefined,\n    aliases,\n  };\n}\n\n/**\n * Throws when the requested name or any alias collides (case-insensitively)\n * with the canonical name or an alias of a DIFFERENT existing definition.\n * Such collisions would make `pm create`/`pm update --type` resolve\n * ambiguously (the runtime registry keys a single lowercase alias map), so\n * they are rejected. Tokens belonging to the same-named definition being\n * upserted are ignored, keeping re-runs idempotent.\n */\nexport function assertAliasesAvailable(input: NormalizedAddTypeInput, existing: ItemTypesFile): void {\n  const selfLower = input.name.toLowerCase();\n  const taken = new Map<string, string>();\n  for (const definition of existing.definitions) {\n    if (typeof definition.name !== \"string\") {\n      continue;\n    }\n    const definitionName = definition.name.trim();\n    if (definitionName.length === 0 || definitionName.toLowerCase() === selfLower) {\n      continue;\n    }\n    taken.set(definitionName.toLowerCase(), definitionName);\n    for (const alias of coerceAliasArray(definition.aliases)) {\n      if (alias.trim().length > 0) {\n        taken.set(alias.trim().toLowerCase(), definitionName);\n      }\n    }\n  }\n  const nameOwner = taken.get(selfLower);\n  if (nameOwner) {\n    throw new Error(`Type name \"${input.name}\" collides with an alias of existing item type \"${nameOwner}\".`);\n  }\n  for (const alias of input.aliases) {\n    const owner = taken.get(alias.toLowerCase());\n    if (owner) {\n      throw new Error(`Alias \"${alias}\" already maps to existing item type \"${owner}\".`);\n    }\n  }\n}\n\n/**\n * Coerces an arbitrary parsed value from types.json into an ItemTypesFile.\n * Accepts the canonical `{ definitions: [...] }` shape, a bare array of\n * definitions, or a nested `{ item_types: { definitions: [...] } }` form, and\n * tolerates a missing/invalid file by returning an empty definitions list.\n */\nexport function parseItemTypesFile(raw: string | null | undefined): ItemTypesFile {\n  if (raw === null || raw === undefined || raw.trim().length === 0) {\n    return { definitions: [] };\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    throw new Error(\"schema/types.json contains invalid JSON.\");\n  }\n  return { definitions: extractDefinitions(parsed) };\n}\n\nfunction extractDefinitions(parsed: unknown): ItemTypeDefinition[] {\n  const candidate = selectDefinitionsArray(parsed);\n  if (!candidate) {\n    return [];\n  }\n  const definitions: ItemTypeDefinition[] = [];\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.name !== \"string\" || record.name.trim().length === 0) {\n      continue;\n    }\n    definitions.push(record as unknown as ItemTypeDefinition);\n  }\n  return definitions;\n}\n\nfunction selectDefinitionsArray(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.definitions)) {\n    return record.definitions;\n  }\n  if (typeof record.item_types === \"object\" && record.item_types !== null) {\n    const nested = record.item_types as Record<string, unknown>;\n    if (Array.isArray(nested.definitions)) {\n      return nested.definitions;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Idempotent UPSERT of a custom item type into the parsed file. Matching is\n * case-insensitive by name. When a definition already exists, fields supplied\n * in `input` override the previous values; aliases are merged (deduped); other\n * fields not addressed by add-type flags are preserved untouched.\n */\nexport function upsertItemType(file: ItemTypesFile, input: NormalizedAddTypeInput): UpsertItemTypeResult {\n  const lowerName = input.name.toLowerCase();\n  const definitions = file.definitions.slice();\n  const existingIndex = definitions.findIndex(\n    (definition) => typeof definition.name === \"string\" && definition.name.trim().toLowerCase() === lowerName,\n  );\n  const existing = existingIndex >= 0 ? definitions[existingIndex] : undefined;\n\n  const mergedAliases = dedupeAliases([...coerceAliasArray(existing?.aliases), ...input.aliases]);\n\n  const next: ItemTypeDefinition = {\n    ...(existing ?? {}),\n    name: input.name,\n  };\n  if (input.folder !== undefined) {\n    next.folder = input.folder;\n  }\n  if (mergedAliases.length > 0) {\n    next.aliases = mergedAliases;\n  } else if (next.aliases !== undefined) {\n    delete next.aliases;\n  }\n  applyAttribute(next, \"description\", input.description);\n  applyAttribute(next, \"default_status\", input.defaultStatus);\n\n  if (existingIndex >= 0) {\n    definitions[existingIndex] = next;\n  } else {\n    definitions.push(next);\n  }\n  definitions.sort((left, right) => left.name.localeCompare(right.name));\n\n  return {\n    file: { definitions },\n    definition: next,\n    replaced: existingIndex >= 0,\n  };\n}\n\n/**\n * Removes a custom item type definition from the parsed file by name\n * (case-insensitive). Throws a plain Error when `name` is empty or collides\n * with a reserved built-in type (built-ins are not stored in the file and must\n * never be deletable). Returns `removed: false` when no matching custom\n * definition exists so the CLI layer can treat the call as an idempotent no-op.\n */\nexport function removeItemType(file: ItemTypesFile, name: string | undefined): RemoveItemTypeResult {\n  const trimmed = (name ?? \"\").trim();\n  if (trimmed.length === 0) {\n    throw new Error(\"Type name must not be empty.\");\n  }\n  const builtinMatch = matchBuiltinTypeName(trimmed);\n  if (builtinMatch) {\n    throw new Error(\n      `Cannot remove built-in item type \"${builtinMatch}\". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(\", \")}.`,\n    );\n  }\n  const lowerName = trimmed.toLowerCase();\n  const definitions = file.definitions.slice();\n  const existingIndex = definitions.findIndex(\n    (definition) => typeof definition.name === \"string\" && definition.name.trim().toLowerCase() === lowerName,\n  );\n  if (existingIndex < 0) {\n    return { file: { definitions }, removed: false };\n  }\n  const [definition] = definitions.splice(existingIndex, 1);\n  return { file: { definitions }, removed: true, definition };\n}\n\nfunction applyAttribute(definition: ItemTypeDefinition, key: string, value: string | undefined): void {\n  const record = definition as unknown as Record<string, unknown>;\n  if (value !== undefined) {\n    record[key] = value;\n  }\n}\n\n/**\n * Serializes the item types file with a trailing newline (matches the rest of\n * the schema scaffold files written by pm).\n */\nexport function serializeItemTypesFile(file: ItemTypesFile): string {\n  return `${JSON.stringify({ definitions: file.definitions }, null, 2)}\\n`;\n}\n\n/**\n * Appends a discoverable hint to the \"Invalid type\" error so agents learn that\n * custom types exist and how to register one. Quotes are chosen so the printed\n * line is copy-pasteable as a shell command.\n */\nexport function buildInvalidTypeHint(name: string): string {\n  const safeName = name.trim().length > 0 ? name.trim() : name;\n  return `To register a custom type, run: pm schema add-type \"${escapeForDoubleQuotes(safeName)}\" (writes .agents/pm/schema/types.json).`;\n}\n\n/**\n * Builds the full invalid-type error message used by create/update: the\n * existing \"Invalid type ... Allowed: ...\" line plus the discoverable hint.\n */\nexport function buildInvalidTypeError(name: string, allowedTypes: readonly string[]): string {\n  return `Invalid type value \"${name}\". Allowed: ${allowedTypes.join(\", \")}. ${buildInvalidTypeHint(name)}`;\n}\n"],"names":[],"mappings":"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","debugId":"77a0faf1-6f19-5f27-9123-f589cf398634"}
+{"version":3,"file":"item-types-file.js","sources":["core/schema/item-types-file.ts"],"sourceRoot":"/","sourcesContent":["import { BUILTIN_ITEM_TYPE_VALUES } from \"../../types/index.js\";\nimport type { ItemTypeDefinition } from \"../../types/index.js\";\nimport { toDefaultFolder } from \"../item/type-registry.js\";\n\nexport type { ItemTypeDefinition } from \"../../types/index.js\";\n\n/**\n * Pure logic for the `pm schema add-type` command and the create/update\n * invalid-type discoverability hint. The CLI command file (schema.ts) handles\n * IO/governance; everything testable and side-effect-free lives here so it can\n * be coverage-gated to 100%.\n */\n\nconst BUILTIN_NAME_LOOKUP = new Map<string, string>(\n  BUILTIN_ITEM_TYPE_VALUES.map((name) => [name.toLowerCase(), name]),\n);\n\n/**\n * The shape persisted at `.agents/pm/schema/types.json`.\n */\nexport interface ItemTypesFile {\n  definitions: ItemTypeDefinition[];\n}\n\nexport interface NormalizedAddTypeInput {\n  name: string;\n  description?: string;\n  defaultStatus?: string;\n  folder?: string;\n  aliases: string[];\n}\n\nexport interface RawAddTypeInput {\n  name: string | undefined;\n  description?: string;\n  defaultStatus?: string;\n  folder?: string;\n  aliases?: string[];\n}\n\nexport interface UpsertItemTypeResult {\n  file: ItemTypesFile;\n  /** The definition as stored after the upsert (existing fields preserved). */\n  definition: ItemTypeDefinition;\n  /** True when an existing definition with the same (case-insensitive) name was replaced. */\n  replaced: boolean;\n  /**\n   * The canonical name of the replaced definition (only present when `replaced`).\n   * Lets the caller detect a silent recase (e.g. \"Spike\" -> \"spike\") and warn.\n   */\n  previousName?: string;\n}\n\n/**\n * Custom item type names (and aliases) must be a single letter-led identifier\n * token: letters, digits, hyphen, or underscore — no whitespace or other\n * punctuation. This keeps names copy-pasteable as shell arguments and folder\n * slugs deterministic, matching the single-token PascalCase shape of every\n * built-in type. Folder/slug overlap between two distinct valid tokens (e.g.\n * \"Spike\"/\"Spikes\", \"code-review\"/\"code_review\") is rejected separately by\n * assertTypeFolderAvailable.\n */\nconst TYPE_NAME_TOKEN_PATTERN = /^[A-Za-z][A-Za-z0-9_-]*$/;\n\nfunction assertValidTypeToken(value: string, label: string): void {\n  if (!TYPE_NAME_TOKEN_PATTERN.test(value)) {\n    throw new Error(\n      `${label} \"${value}\" is not a valid identifier. Use a single letter-led token of letters, digits, hyphen, or underscore with no spaces or punctuation (e.g. \"Spike\" or \"code-review\").`,\n    );\n  }\n}\n\nexport interface RemoveItemTypeResult {\n  file: ItemTypesFile;\n  /** True when a matching definition existed and was dropped from the file. */\n  removed: boolean;\n  /** The removed definition, when one matched (case-insensitively) the requested name. */\n  definition?: ItemTypeDefinition;\n}\n\n/**\n * Returns the canonical built-in name when `name` collides (case-insensitively)\n * with a reserved built-in item type, otherwise undefined.\n */\nexport function matchBuiltinTypeName(name: string): string | undefined {\n  return BUILTIN_NAME_LOOKUP.get(name.trim().toLowerCase());\n}\n\n/**\n * Coerces a persisted `aliases` value into a string array, tolerating malformed\n * data (a non-array, or an array containing non-string entries) without throwing\n * or exploding a stray string into character aliases.\n */\nfunction coerceAliasArray(value: unknown): string[] {\n  return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === \"string\") : [];\n}\n\n/**\n * Escapes a value for safe interpolation inside a double-quoted shell string so\n * suggested copy-pasteable commands stay well-formed for names containing\n * `\"`, `` ` ``, `$`, or `\\`.\n */\nexport function escapeForDoubleQuotes(value: string): string {\n  return value.replace(/[\\\\\"`$]/g, (char) => `\\\\${char}`);\n}\n\nfunction dedupeAliases(values: Iterable<string>): string[] {\n  const seen = new Map<string, string>();\n  for (const value of values) {\n    const trimmed = value.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    const key = trimmed.toLowerCase();\n    if (!seen.has(key)) {\n      seen.set(key, trimmed);\n    }\n  }\n  return [...seen.values()].sort((left, right) => left.localeCompare(right));\n}\n\n/**\n * Validates and normalizes raw add-type CLI input. Throws a plain Error with a\n * stable message when the name is missing/empty or collides with a built-in;\n * the CLI layer maps these to PmCliError exit codes.\n */\nexport function normalizeAddTypeInput(raw: RawAddTypeInput): NormalizedAddTypeInput {\n  const name = (raw.name ?? \"\").trim();\n  if (name.length === 0) {\n    throw new Error(\"Type name must not be empty.\");\n  }\n  assertValidTypeToken(name, \"Type name\");\n  const builtinMatch = matchBuiltinTypeName(name);\n  if (builtinMatch) {\n    throw new Error(\n      `Cannot redefine built-in item type \"${builtinMatch}\". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(\", \")}.`,\n    );\n  }\n  const description = raw.description?.trim();\n  const defaultStatus = raw.defaultStatus?.trim();\n  const folder = raw.folder?.trim();\n  const aliases = dedupeAliases(raw.aliases ?? []);\n  for (const alias of aliases) {\n    assertValidTypeToken(alias, \"Alias\");\n    const aliasBuiltin = matchBuiltinTypeName(alias);\n    if (aliasBuiltin) {\n      throw new Error(\n        `Alias \"${alias}\" collides with built-in item type \"${aliasBuiltin}\". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(\", \")}.`,\n      );\n    }\n  }\n  return {\n    name,\n    description: description && description.length > 0 ? description : undefined,\n    defaultStatus: defaultStatus && defaultStatus.length > 0 ? defaultStatus : undefined,\n    folder: folder && folder.length > 0 ? folder : undefined,\n    aliases,\n  };\n}\n\n/**\n * Throws when the requested name or any alias collides (case-insensitively)\n * with the canonical name or an alias of a DIFFERENT existing definition.\n * Such collisions would make `pm create`/`pm update --type` resolve\n * ambiguously (the runtime registry keys a single lowercase alias map), so\n * they are rejected. Tokens belonging to the same-named definition being\n * upserted are ignored, keeping re-runs idempotent.\n */\nexport function assertAliasesAvailable(input: NormalizedAddTypeInput, existing: ItemTypesFile): void {\n  const selfLower = input.name.toLowerCase();\n  const taken = new Map<string, string>();\n  for (const definition of existing.definitions) {\n    if (typeof definition.name !== \"string\") {\n      continue;\n    }\n    const definitionName = definition.name.trim();\n    if (definitionName.length === 0 || definitionName.toLowerCase() === selfLower) {\n      continue;\n    }\n    taken.set(definitionName.toLowerCase(), definitionName);\n    for (const alias of coerceAliasArray(definition.aliases)) {\n      if (alias.trim().length > 0) {\n        taken.set(alias.trim().toLowerCase(), definitionName);\n      }\n    }\n  }\n  const nameOwner = taken.get(selfLower);\n  if (nameOwner) {\n    throw new Error(`Type name \"${input.name}\" collides with an alias of existing item type \"${nameOwner}\".`);\n  }\n  for (const alias of input.aliases) {\n    const owner = taken.get(alias.toLowerCase());\n    if (owner) {\n      throw new Error(`Alias \"${alias}\" already maps to existing item type \"${owner}\".`);\n    }\n  }\n}\n\n/**\n * Resolves the storage folder a definition would use: an explicit non-empty\n * `folder` wins, otherwise the deterministic slug derived from the name (the\n * same derivation the runtime registry applies, single-sourced from\n * type-registry.toDefaultFolder).\n */\nfunction resolveDefinitionFolder(name: string, folder: unknown): string {\n  if (typeof folder === \"string\" && folder.trim().length > 0) {\n    return folder.trim().toLowerCase();\n  }\n  return toDefaultFolder(name).toLowerCase();\n}\n\n/**\n * Throws when the requested type's storage folder would collide with a\n * DIFFERENT existing definition's folder. Two distinct type names can slug to\n * one folder (\"Spike\"/\"Spikes\", \"code-review\"/\"code_review\"), which would make\n * their item files share a directory and silently corrupt the taxonomy. The\n * same-named definition being upserted is ignored (folder reuse on re-run is\n * expected). Resolving the collision is a matter of passing a distinct\n * `--folder`, so the error says so.\n *\n * `reservedFolders` carries the folders already owned by built-in and extension\n * types (folder-slug → owner name); a custom type whose slug matches one of\n * those (e.g. \"Tasks\" → \"tasks\", owned by the built-in Task) is just as\n * corrupting as a custom-vs-custom collision, so both are checked.\n */\nexport function assertTypeFolderAvailable(\n  input: NormalizedAddTypeInput,\n  existing: ItemTypesFile,\n  reservedFolders?: ReadonlyMap<string, string>,\n): void {\n  const selfLower = input.name.toLowerCase();\n  const inputFolder = resolveDefinitionFolder(input.name, input.folder);\n  const fail = (ownerName: string): never => {\n    throw new Error(\n      `Item type \"${input.name}\" would store items in folder \"${inputFolder}\", which already belongs to existing item type \"${ownerName}\". Pass a distinct --folder to keep their storage separate.`,\n    );\n  };\n  for (const definition of existing.definitions) {\n    if (typeof definition.name !== \"string\") {\n      continue;\n    }\n    const definitionName = definition.name.trim();\n    if (definitionName.length === 0 || definitionName.toLowerCase() === selfLower) {\n      continue;\n    }\n    if (resolveDefinitionFolder(definitionName, definition.folder) === inputFolder) {\n      fail(definitionName);\n    }\n  }\n  const reservedOwner = reservedFolders?.get(inputFolder);\n  if (reservedOwner !== undefined && reservedOwner.toLowerCase() !== selfLower) {\n    fail(reservedOwner);\n  }\n}\n\n/**\n * Coerces an arbitrary parsed value from types.json into an ItemTypesFile.\n * Accepts the canonical `{ definitions: [...] }` shape, a bare array of\n * definitions, or a nested `{ item_types: { definitions: [...] } }` form, and\n * tolerates a missing/invalid file by returning an empty definitions list.\n */\nexport function parseItemTypesFile(raw: string | null | undefined): ItemTypesFile {\n  if (raw === null || raw === undefined || raw.trim().length === 0) {\n    return { definitions: [] };\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    throw new Error(\"schema/types.json contains invalid JSON.\");\n  }\n  return { definitions: extractDefinitions(parsed) };\n}\n\nfunction extractDefinitions(parsed: unknown): ItemTypeDefinition[] {\n  const candidate = selectDefinitionsArray(parsed);\n  if (!candidate) {\n    return [];\n  }\n  const definitions: ItemTypeDefinition[] = [];\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.name !== \"string\" || record.name.trim().length === 0) {\n      continue;\n    }\n    definitions.push(record as unknown as ItemTypeDefinition);\n  }\n  return definitions;\n}\n\nfunction selectDefinitionsArray(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.definitions)) {\n    return record.definitions;\n  }\n  if (typeof record.item_types === \"object\" && record.item_types !== null) {\n    const nested = record.item_types as Record<string, unknown>;\n    if (Array.isArray(nested.definitions)) {\n      return nested.definitions;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Idempotent UPSERT of a custom item type into the parsed file. Matching is\n * case-insensitive by name. When a definition already exists, fields supplied\n * in `input` override the previous values; aliases are merged (deduped); other\n * fields not addressed by add-type flags are preserved untouched.\n */\nexport function upsertItemType(file: ItemTypesFile, input: NormalizedAddTypeInput): UpsertItemTypeResult {\n  const lowerName = input.name.toLowerCase();\n  const definitions = file.definitions.slice();\n  const existingIndex = definitions.findIndex(\n    (definition) => typeof definition.name === \"string\" && definition.name.trim().toLowerCase() === lowerName,\n  );\n  const existing = existingIndex >= 0 ? definitions[existingIndex] : undefined;\n\n  const mergedAliases = dedupeAliases([...coerceAliasArray(existing?.aliases), ...input.aliases]);\n\n  const next: ItemTypeDefinition = {\n    ...(existing ?? {}),\n    name: input.name,\n  };\n  if (input.folder !== undefined) {\n    next.folder = input.folder;\n  }\n  if (mergedAliases.length > 0) {\n    next.aliases = mergedAliases;\n  } else if (next.aliases !== undefined) {\n    delete next.aliases;\n  }\n  applyAttribute(next, \"description\", input.description);\n  applyAttribute(next, \"default_status\", input.defaultStatus);\n\n  if (existingIndex >= 0) {\n    definitions[existingIndex] = next;\n  } else {\n    definitions.push(next);\n  }\n  definitions.sort((left, right) => left.name.localeCompare(right.name));\n\n  return {\n    file: { definitions },\n    definition: next,\n    replaced: existingIndex >= 0,\n    ...(existing && typeof existing.name === \"string\" ? { previousName: existing.name } : {}),\n  };\n}\n\n/**\n * Removes a custom item type definition from the parsed file by name\n * (case-insensitive). Throws a plain Error when `name` is empty or collides\n * with a reserved built-in type (built-ins are not stored in the file and must\n * never be deletable). Returns `removed: false` when no matching custom\n * definition exists so the CLI layer can treat the call as an idempotent no-op.\n */\nexport function removeItemType(file: ItemTypesFile, name: string | undefined): RemoveItemTypeResult {\n  const trimmed = (name ?? \"\").trim();\n  if (trimmed.length === 0) {\n    throw new Error(\"Type name must not be empty.\");\n  }\n  const builtinMatch = matchBuiltinTypeName(trimmed);\n  if (builtinMatch) {\n    throw new Error(\n      `Cannot remove built-in item type \"${builtinMatch}\". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(\", \")}.`,\n    );\n  }\n  const lowerName = trimmed.toLowerCase();\n  const definitions = file.definitions.slice();\n  const existingIndex = definitions.findIndex(\n    (definition) => typeof definition.name === \"string\" && definition.name.trim().toLowerCase() === lowerName,\n  );\n  if (existingIndex < 0) {\n    return { file: { definitions }, removed: false };\n  }\n  const [definition] = definitions.splice(existingIndex, 1);\n  return { file: { definitions }, removed: true, definition };\n}\n\nfunction applyAttribute(definition: ItemTypeDefinition, key: string, value: string | undefined): void {\n  const record = definition as unknown as Record<string, unknown>;\n  if (value !== undefined) {\n    record[key] = value;\n  }\n}\n\n/**\n * Serializes the item types file with a trailing newline (matches the rest of\n * the schema scaffold files written by pm).\n */\nexport function serializeItemTypesFile(file: ItemTypesFile): string {\n  return `${JSON.stringify({ definitions: file.definitions }, null, 2)}\\n`;\n}\n\n/**\n * Appends a discoverable hint to the \"Invalid type\" error so agents learn that\n * custom types exist and how to register one. Quotes are chosen so the printed\n * line is copy-pasteable as a shell command.\n */\nexport function buildInvalidTypeHint(name: string, typesFilePath?: string): string {\n  const safeName = name.trim().length > 0 ? name.trim() : name;\n  const target = typesFilePath?.trim() || \".agents/pm/schema/types.json\";\n  return `To register a custom type, run: pm schema add-type \"${escapeForDoubleQuotes(safeName)}\" (writes ${target}).`;\n}\n\n/**\n * Builds the full invalid-type error message used by create/update: the\n * existing \"Invalid type ... Allowed: ...\" line plus the discoverable hint.\n * `typesFilePath` should be the resolved schema/types.json path for the active\n * tracker (see {@link resolveItemTypesFilePath}) so the hint reflects a custom\n * `--pm-path` instead of the hardcoded `.agents/pm` default.\n */\nexport function buildInvalidTypeError(name: string, allowedTypes: readonly string[], typesFilePath?: string): string {\n  return `Invalid type value \"${name}\". Allowed: ${allowedTypes.join(\", \")}. ${buildInvalidTypeHint(name, typesFilePath)}`;\n}\n"],"names":[],"mappings":"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","debugId":"995e9919-c166-505a-8821-d8a859a60ae8"}

package/dist/core/schema/runtime-schema.d.ts

@@ -60,6 +60,13 @@ export interface LoadedRuntimeSchemaSections {
 }
 export declare function normalizeRuntimeSchemaSettings(schema: Partial<RuntimeSchemaSettings> | undefined): RuntimeSchemaSettings;
 export declare function filePathForSchemaSection(pmRoot: string, configuredPath: string | undefined, fallbackPath: string): string;
+/**
+ * Resolves the active tracker's `schema/types.json` path so user-facing hints
+ * (e.g. the invalid-type error) point at the real `--pm-path` location instead
+ * of the hardcoded `.agents/pm` default. Mirrors how `pm schema add/remove-type`
+ * report their target path.
+ */
+export declare function resolveItemTypesFilePath(pmRoot: string, schema: RuntimeSchemaSettings): string;
 export declare function ensureRuntimeSchemaFileScaffold(pmRoot: string, schema: RuntimeSchemaSettings): Promise<RuntimeSchemaFileBootstrapResult>;
 export declare function loadRuntimeSchemaFromOptionalFiles(pmRoot: string, schema: RuntimeSchemaSettings): Promise<LoadedRuntimeSchemaSections>;
 export declare function resolveRuntimeStatusRegistry(schema: RuntimeSchemaSettings): RuntimeStatusRegistry;

package/dist/core/schema/runtime-schema.js

@@ -1,5 +1,5 @@
 
-!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]="221fcd13-8553-5c32-a2d8-2845d0f71047")}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]="b2eb7998-c31b-5482-a06a-702127583881")}catch(e){}}();
 import path from "node:path";
 import { pathExists, readFileIfExists, writeFileAtomic } from "../fs/fs-utils.js";
 import { DEFAULT_STATUS_DEFINITIONS, DEFAULT_WORKFLOW_DEFINITION } from "../shared/constants.js";
@@ -361,6 +361,15 @@ export function filePathForSchemaSection(pmRoot, configuredPath, fallbackPath) {
     }
     return path.join(pmRoot, normalized);
 }
+/**
+ * Resolves the active tracker's `schema/types.json` path so user-facing hints
+ * (e.g. the invalid-type error) point at the real `--pm-path` location instead
+ * of the hardcoded `.agents/pm` default. Mirrors how `pm schema add/remove-type`
+ * report their target path.
+ */
+export function resolveItemTypesFilePath(pmRoot, schema) {
+    return filePathForSchemaSection(pmRoot, schema.files.types, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types);
+}
 export async function ensureRuntimeSchemaFileScaffold(pmRoot, schema) {
     const normalizedSchema = normalizeRuntimeSchemaSettings(schema);
     const specs = [
@@ -465,11 +474,10 @@ function preferredStatusForRole(definitions, role, fallbackValues) {
     if (withRole.length > 0) {
         return withRole[0].id;
     }
-    for (const value of fallbackValues) {
-        const normalized = normalizeStatusId(value);
-        if (!normalized) {
-            continue;
-        }
+    const normalizedFallbacks = fallbackValues
+        .map((value) => normalizeStatusId(value))
+        .filter((value) => typeof value === "string");
+    for (const normalized of normalizedFallbacks) {
         if (definitions.some((definition) => definition.id === normalized)) {
             return normalized;
         }
@@ -521,7 +529,7 @@ export function resolveRuntimeStatusRegistry(schema) {
     }
     const workflow = normalizedSchema.workflow;
     const openStatus = normalizeStatusId(workflow.open_status) ??
-        preferredStatusForRole(definitions, "default_open", ["open", "in_progress", STATUS_VALUES[0] ?? "open"]);
+        preferredStatusForRole(definitions, "default_open", ["open", "in_progress", STATUS_VALUES[0]]);
     const closeStatus = normalizeStatusId(workflow.close_status) ??
         preferredStatusForRole(definitions, "default_close", ["closed", "done", "complete"]);
     const canceledStatus = normalizeStatusId(workflow.canceled_status) ??
@@ -536,9 +544,9 @@ export function resolveRuntimeStatusRegistry(schema) {
         active_statuses: activeStatuses,
         blocked_statuses: blockedStatuses,
         draft_statuses: draftStatuses,
-        open_status: openStatus ?? definitions[0]?.id ?? "open",
-        close_status: closeStatus ?? definitions[0]?.id ?? "closed",
-        canceled_status: canceledStatus ?? definitions[0]?.id ?? "canceled",
+        open_status: openStatus,
+        close_status: closeStatus,
+        canceled_status: canceledStatus,
     };
 }
 export function normalizeStatusInputWithRegistry(value, registry) {
@@ -551,11 +559,10 @@ export function normalizeStatusInputWithRegistry(value, registry) {
 export function resolveRuntimeFieldRegistry(schema) {
     const normalizedSchema = normalizeRuntimeSchemaSettings(schema);
     const dedupedByKey = new Map();
-    for (const definition of normalizedSchema.fields) {
-        const normalized = normalizeRuntimeFieldDefinition(definition);
-        if (!normalized) {
-            continue;
-        }
+    const normalizedFields = normalizedSchema.fields
+        .map((definition) => normalizeRuntimeFieldDefinition(definition))
+        .filter((definition) => definition !== null);
+    for (const normalized of normalizedFields) {
         dedupedByKey.set(normalized.key, normalized);
     }
     const definitions = [...dedupedByKey.values()].sort((left, right) => left.key.localeCompare(right.key));
@@ -596,4 +603,4 @@ export function statusIsTerminal(status, registry) {
     return registry.terminal_statuses.has(normalized);
 }
 //# sourceMappingURL=runtime-schema.js.map
-//# debugId=221fcd13-8553-5c32-a2d8-2845d0f71047
+//# debugId=b2eb7998-c31b-5482-a06a-702127583881