@unbrained/pm-cli 2026.9.6 → 2026.9.8

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

@@ -1,289 +1,3 @@
-/**
- * @module core/schema/fields-file
- *
- * Resolves configurable schema, fields, statuses, and workflows for Fields File.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2b5a573e-1e36-58b9-b93b-4a4088f71e9a")}catch(e){}}();
-import { RUNTIME_FIELD_COMMAND_VALUES, RUNTIME_FIELD_TYPE_VALUES, } from "../../types/index.js";
-import { ITEM_METADATA_KEY_ORDER } from "../shared/constants.js";
-import { normalizeStatusToken as normalizeFieldKey } from "./status-token.js";
-export { normalizeStatusToken as normalizeFieldKey } from "./status-token.js";
-/**
- * Pure logic for the `pm schema add-field` / `pm schema remove-field` commands
- * and the `list-fields` / `show-field` inspectors. The CLI command file
- * (schema.ts) owns IO/governance; everything testable and side-effect-free lives
- * here so it can be coverage-gated to 100%.
- *
- * Custom fields persist at `.agents/pm/schema/fields.json` under the shape
- * `{ fields: RuntimeFieldDefinition[] }`. The runtime merge layer
- * (loadRuntimeSchemaFromOptionalFiles) reads that file and dynamically registers
- * a CLI flag per field on create/update/list/search/context, so this module only
- * has to manage the persisted entries; it never duplicates the registration.
- */
-const RUNTIME_FIELD_TYPE_SET = new Set(RUNTIME_FIELD_TYPE_VALUES);
-const RUNTIME_FIELD_COMMAND_SET = new Set(RUNTIME_FIELD_COMMAND_VALUES);
-/** Built-in item-metadata field names a custom field key must never shadow. A custom key that collides with one of these would let `pm create --<key>` write over reserved metadata, so add-field rejects them up front (symmetric with the built-in-type guard in item-types-file.ts). */
-export const BUILTIN_FIELD_KEYS = new Set([
-    ...ITEM_METADATA_KEY_ORDER.filter((key) => key !== "severity"),
-    "id",
-    "title",
-    "type",
-    "status",
-    "priority",
-    "tags",
-    "assignee",
-    "parent",
-    "description",
-    "body",
-    "created_at",
-    "updated_at",
-    "closed_at",
-    "completed_at",
-    "author",
-    "deadline",
-    "estimate",
-    "sprint",
-    "release",
-    "risk",
-    "confidence",
-    "reviewer",
-    "resolution",
-    "expected",
-    "actual",
-]);
-/** The default commands a field is wired onto when `--commands` is omitted, matching the runtime default in runtime-schema.ts (normalizeRuntimeFieldDefinition). */
-const DEFAULT_FIELD_COMMANDS = ["create", "update"];
-/** Normalizes a CLI flag token: strip a leading `--`, lowercase, and collapse whitespace/underscore runs to a single hyphen (matches normalizeCliToken in runtime-schema.ts). */
-function normalizeCliToken(value) {
-    if (typeof value !== "string") {
-        return "";
-    }
-    const collapsed = value
-        .trim()
-        .toLowerCase()
-        .replaceAll(/[\s_]+/g, "-");
-    return collapsed.startsWith("--") ? collapsed.slice(2) : collapsed;
-}
-function keyToDefaultCliFlag(key) {
-    return key.replaceAll("_", "-");
-}
-function dedupeCliTokens(values, exclude) {
-    const seen = new Set();
-    for (const value of values) {
-        const token = normalizeCliToken(value);
-        if (token.length > 0 && token !== exclude) {
-            seen.add(token);
-        }
-    }
-    return [...seen].sort((left, right) => left.localeCompare(right));
-}
-function dedupeStringList(values) {
-    const seen = new Set();
-    for (const value of values ?? []) {
-        const trimmed = value.trim();
-        if (trimmed.length > 0) {
-            seen.add(trimmed);
-        }
-    }
-    return [...seen].sort((left, right) => left.localeCompare(right));
-}
-/** Normalizes the command allow-list stored for a custom field definition. */
-function normalizeFieldCommands(rawCommands) {
-    const seen = new Set();
-    const normalized = [];
-    for (const rawCommand of rawCommands ?? []) {
-        const command = rawCommand.trim().toLowerCase();
-        if (command.length === 0) {
-            continue;
-        }
-        if (!RUNTIME_FIELD_COMMAND_SET.has(command)) {
-            throw new Error(`Invalid field command "${rawCommand}". Allowed: ${RUNTIME_FIELD_COMMAND_VALUES.join(", ")}.`);
-        }
-        if (!seen.has(command)) {
-            seen.add(command);
-            normalized.push(command);
-        }
-    }
-    return rawCommands === undefined || normalized.length === 0
-        ? [...DEFAULT_FIELD_COMMANDS]
-        : normalized;
-}
-/** 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. */
-export function normalizeAddFieldInput(raw) {
-    const key = normalizeFieldKey(raw.key);
-    if (key.length === 0) {
-        throw new Error("Field key must not be empty.");
-    }
-    if (BUILTIN_FIELD_KEYS.has(key)) {
-        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)) {
-        throw new Error(`Invalid field type "${raw.type}". Allowed: ${RUNTIME_FIELD_TYPE_VALUES.join(", ")}.`);
-    }
-    const type = typeCandidate;
-    const commands = normalizeFieldCommands(raw.commands);
-    const cliFlagToken = normalizeCliToken(raw.cliFlag);
-    const cliFlag = cliFlagToken.length > 0 && cliFlagToken !== keyToDefaultCliFlag(key)
-        ? cliFlagToken
-        : undefined;
-    const effectiveFlag = cliFlag ?? keyToDefaultCliFlag(key);
-    const cliAliases = dedupeCliTokens(raw.aliases ?? [], effectiveFlag);
-    const description = raw.description?.trim();
-    return {
-        key,
-        type,
-        commands,
-        description: description && description.length > 0 ? description : undefined,
-        cliFlag,
-        cliAliases,
-        required: raw.required === true,
-        requiredOnCreate: raw.requiredOnCreate === true,
-        // allow_unset defaults to true (omitted) and is only persisted when an
-        // operator explicitly disables it with --no-allow-unset (allowUnset === false).
-        allowUnset: raw.allowUnset !== false,
-        requiredTypes: dedupeStringList(raw.requiredTypes),
-    };
-}
-function selectFieldsArray(parsed) {
-    if (Array.isArray(parsed)) {
-        return parsed;
-    }
-    if (typeof parsed !== "object" || parsed === null) {
-        return undefined;
-    }
-    const record = parsed;
-    if (Array.isArray(record.fields)) {
-        return record.fields;
-    }
-    if (Array.isArray(record.definitions)) {
-        return record.definitions;
-    }
-    return undefined;
-}
-function extractFieldDefinitions(parsed) {
-    const candidate = selectFieldsArray(parsed);
-    if (!candidate) {
-        return [];
-    }
-    const definitions = [];
-    for (const entry of candidate) {
-        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
-            continue;
-        }
-        const record = entry;
-        if (typeof record.key !== "string" || record.key.trim().length === 0) {
-            continue;
-        }
-        definitions.push(record);
-    }
-    return definitions;
-}
-/** 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. */
-export function parseFieldsFile(raw) {
-    if (raw === null || raw === undefined || raw.trim().length === 0) {
-        return { fields: [] };
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        throw new Error("schema/fields.json contains invalid JSON.");
-    }
-    return { fields: extractFieldDefinitions(parsed) };
-}
-/** Serializes the fields file with a trailing newline (matches the rest of the schema scaffold files written by pm). */
-export function serializeFieldsFile(file) {
-    return `${JSON.stringify({ fields: file.fields }, null, 2)}\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 item-metadata column. */
-export function upsertField(file, input) {
-    // Match by normalized key. A hand-authored file may carry more than one entry
-    // for the same key, so drop ALL matches and re-insert a single merged result
-    // (collapsing duplicates) rather than only rewriting the first occurrence. The
-    // first existing match seeds preserved attributes (e.g. metadata_key).
-    const existing = file.fields.find((definition) => normalizeFieldKey(definition.key) === input.key);
-    const replaced = existing !== undefined;
-    const fields = file.fields.filter((definition) => normalizeFieldKey(definition.key) !== input.key);
-    const next = {
-        ...existing,
-        key: input.key,
-        type: input.type,
-        commands: [...input.commands],
-    };
-    applyOptionalString(next, "description", input.description);
-    applyOptionalString(next, "cli_flag", input.cliFlag);
-    if (input.cliAliases.length > 0) {
-        next.cli_aliases = [...input.cliAliases];
-    }
-    else {
-        delete next.cli_aliases;
-    }
-    applyBooleanFlag(next, "required", input.required);
-    applyBooleanFlag(next, "required_on_create", input.requiredOnCreate);
-    // allow_unset defaults true; only persist the explicit false override.
-    if (input.allowUnset === false) {
-        next.allow_unset = false;
-    }
-    else {
-        delete next.allow_unset;
-    }
-    if (input.requiredTypes.length > 0) {
-        next.required_types = [...input.requiredTypes];
-    }
-    else {
-        delete next.required_types;
-    }
-    fields.push(next);
-    fields.sort((left, right) => normalizeFieldKey(left.key).localeCompare(normalizeFieldKey(right.key)));
-    return {
-        file: { fields },
-        definition: next,
-        replaced,
-    };
-}
-/** 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. */
-export function removeField(file, key) {
-    const normalizedKey = normalizeFieldKey(key);
-    if (normalizedKey.length === 0) {
-        throw new Error("Field key must not be empty.");
-    }
-    // Remove ALL matches (a hand-authored file may carry duplicate entries for the
-    // same normalized key) so no stale duplicate survives the removal.
-    const removed = [];
-    const fields = file.fields.filter((definition) => {
-        if (normalizeFieldKey(definition.key) === normalizedKey) {
-            removed.push(definition);
-            return false;
-        }
-        return true;
-    });
-    if (removed.length === 0) {
-        return { file: { fields }, removed: false };
-    }
-    return { file: { fields }, removed: true, definition: removed[0] };
-}
-function applyOptionalString(definition, key, value) {
-    const record = definition;
-    if (value !== undefined && value.length > 0) {
-        record[key] = value;
-    }
-    else {
-        delete record[key];
-    }
-}
-function applyBooleanFlag(definition, key, value) {
-    const record = definition;
-    if (value) {
-        record[key] = true;
-    }
-    else {
-        delete record[key];
-    }
-}
+!(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]="f9535c02-9214-5d5e-bac0-2dabbe5d395e")}catch(e2){}})();import{RUNTIME_FIELD_COMMAND_VALUES,RUNTIME_FIELD_TYPE_VALUES}from"../../types/index.js";import{ITEM_METADATA_KEY_ORDER}from"../shared/constants.js";import{normalizeStatusToken as normalizeFieldKey}from"./status-token.js";import{normalizeStatusToken}from"./status-token.js";const RUNTIME_FIELD_TYPE_SET=new Set(RUNTIME_FIELD_TYPE_VALUES);const RUNTIME_FIELD_COMMAND_SET=new Set(RUNTIME_FIELD_COMMAND_VALUES);const BUILTIN_FIELD_KEYS=new Set([...ITEM_METADATA_KEY_ORDER.filter(key=>key!=="severity"),"id","title","type","status","priority","tags","assignee","parent","description","body","created_at","updated_at","closed_at","completed_at","author","deadline","estimate","sprint","release","risk","confidence","reviewer","resolution","expected","actual"]);const DEFAULT_FIELD_COMMANDS=["create","update"];function normalizeCliToken(value){if(typeof value!=="string"){return""}const collapsed=value.trim().toLowerCase().replaceAll(/[\s_]+/g,"-");return collapsed.startsWith("--")?collapsed.slice(2):collapsed}function keyToDefaultCliFlag(key){return key.replaceAll("_","-")}function dedupeCliTokens(values,exclude){const seen=new Set;for(const value of values){const token=normalizeCliToken(value);if(token.length>0&&token!==exclude){seen.add(token)}}return[...seen].sort((left,right)=>left.localeCompare(right))}function dedupeStringList(values){const seen=new Set;for(const value of values??[]){const trimmed=value.trim();if(trimmed.length>0){seen.add(trimmed)}}return[...seen].sort((left,right)=>left.localeCompare(right))}function normalizeFieldCommands(rawCommands){const seen=new Set;const normalized=[];for(const rawCommand of rawCommands??[]){const command=rawCommand.trim().toLowerCase();if(command.length===0){continue}if(!RUNTIME_FIELD_COMMAND_SET.has(command)){throw new Error(`Invalid field command "${rawCommand}". Allowed: ${RUNTIME_FIELD_COMMAND_VALUES.join(", ")}.`)}if(!seen.has(command)){seen.add(command);normalized.push(command)}}return rawCommands===void 0||normalized.length===0?[...DEFAULT_FIELD_COMMANDS]:normalized}function normalizeAddFieldInput(raw){const key=normalizeFieldKey(raw.key);if(key.length===0){throw new Error("Field key must not be empty.")}if(BUILTIN_FIELD_KEYS.has(key)){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)){throw new Error(`Invalid field type "${raw.type}". Allowed: ${RUNTIME_FIELD_TYPE_VALUES.join(", ")}.`)}const type=typeCandidate;const commands=normalizeFieldCommands(raw.commands);const cliFlagToken=normalizeCliToken(raw.cliFlag);const cliFlag=cliFlagToken.length>0&&cliFlagToken!==keyToDefaultCliFlag(key)?cliFlagToken:void 0;const effectiveFlag=cliFlag??keyToDefaultCliFlag(key);const cliAliases=dedupeCliTokens(raw.aliases??[],effectiveFlag);const description=raw.description?.trim();return{key,type,commands,description:description&&description.length>0?description:void 0,cliFlag,cliAliases,required:raw.required===true,requiredOnCreate:raw.requiredOnCreate===true,allowUnset:raw.allowUnset!==false,requiredTypes:dedupeStringList(raw.requiredTypes)}}function selectFieldsArray(parsed){if(Array.isArray(parsed)){return parsed}if(typeof parsed!=="object"||parsed===null){return void 0}const record=parsed;if(Array.isArray(record.fields)){return record.fields}if(Array.isArray(record.definitions)){return record.definitions}return void 0}function extractFieldDefinitions(parsed){const candidate=selectFieldsArray(parsed);if(!candidate){return[]}const definitions=[];for(const entry of candidate){if(typeof entry!=="object"||entry===null||Array.isArray(entry)){continue}const record=entry;if(typeof record.key!=="string"||record.key.trim().length===0){continue}definitions.push(record)}return definitions}function parseFieldsFile(raw){if(raw===null||raw===void 0||raw.trim().length===0){return{fields:[]}}let parsed;try{parsed=JSON.parse(raw)}catch{throw new Error("schema/fields.json contains invalid JSON.")}return{fields:extractFieldDefinitions(parsed)}}function serializeFieldsFile(file){return`${JSON.stringify({fields:file.fields},null,2)}
+`}function upsertField(file,input){const existing=file.fields.find(definition=>normalizeFieldKey(definition.key)===input.key);const replaced=existing!==void 0;const fields=file.fields.filter(definition=>normalizeFieldKey(definition.key)!==input.key);const next={...existing,key:input.key,type:input.type,commands:[...input.commands]};applyOptionalString(next,"description",input.description);applyOptionalString(next,"cli_flag",input.cliFlag);if(input.cliAliases.length>0){next.cli_aliases=[...input.cliAliases]}else{delete next.cli_aliases}applyBooleanFlag(next,"required",input.required);applyBooleanFlag(next,"required_on_create",input.requiredOnCreate);if(input.allowUnset===false){next.allow_unset=false}else{delete next.allow_unset}if(input.requiredTypes.length>0){next.required_types=[...input.requiredTypes]}else{delete next.required_types}fields.push(next);fields.sort((left,right)=>normalizeFieldKey(left.key).localeCompare(normalizeFieldKey(right.key)));return{file:{fields},definition:next,replaced}}function removeField(file,key){const normalizedKey=normalizeFieldKey(key);if(normalizedKey.length===0){throw new Error("Field key must not be empty.")}const removed=[];const fields=file.fields.filter(definition=>{if(normalizeFieldKey(definition.key)===normalizedKey){removed.push(definition);return false}return true});if(removed.length===0){return{file:{fields},removed:false}}return{file:{fields},removed:true,definition:removed[0]}}function applyOptionalString(definition,key,value){const record=definition;if(value!==void 0&&value.length>0){record[key]=value}else{delete record[key]}}function applyBooleanFlag(definition,key,value){const record=definition;if(value){record[key]=true}else{delete record[key]}}export{BUILTIN_FIELD_KEYS,normalizeAddFieldInput,normalizeStatusToken as normalizeFieldKey,parseFieldsFile,removeField,serializeFieldsFile,upsertField};
 //# sourceMappingURL=fields-file.js.map
-//# debugId=2b5a573e-1e36-58b9-b93b-4a4088f71e9a

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

@@ -1,297 +1,3 @@
-/**
- * @module core/schema/item-types-file
- *
- * Resolves configurable schema, fields, statuses, and workflows for Item Types File.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="989b570c-112e-5ee3-8731-ab34f215ba45")}catch(e){}}();
-import { BUILTIN_ITEM_TYPE_VALUES } from "../../types/index.js";
-import { normalizeItemTypeFolder, 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 IO/governance; everything testable and side-effect-free lives here so it can 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. */
-export function matchBuiltinTypeName(name) {
-    return BUILTIN_NAME_LOOKUP.get(name.trim().toLowerCase());
-}
-/** Coerces a persisted `aliases` value into a string array, tolerating malformed data (a non-array, or an array containing non-string entries) without throwing or exploding a stray string into character aliases. */
-function coerceAliasArray(value) {
-    return Array.isArray(value)
-        ? value.filter((entry) => typeof entry === "string")
-        : [];
-}
-/** Escapes a value for safe interpolation inside a double-quoted shell string so suggested copy-pasteable commands stay well-formed for names containing `"`, `` ` ``, `$`, or `\`. */
-export function escapeForDoubleQuotes(value) {
-    return value.replace(/[\\"`$]/g, (char) => `\\${char}`);
-}
-function dedupeAliases(values) {
-    const seen = new Map();
-    for (const value of values) {
-        const trimmed = value.trim();
-        if (trimmed.length === 0) {
-            continue;
-        }
-        const key = trimmed.toLowerCase();
-        if (!seen.has(key)) {
-            seen.set(key, trimmed);
-        }
-    }
-    return [...seen.values()].sort((left, right) => left.localeCompare(right));
-}
-/** Validates and normalizes raw add-type CLI input. Throws a plain Error with a stable message when the name is missing/empty or collides with a built-in; the CLI layer maps these to PmCliError exit codes. */
-export function normalizeAddTypeInput(raw) {
-    const name = (raw.name ?? "").trim();
-    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(", ")}.`);
-    }
-    const description = raw.description?.trim();
-    const defaultStatus = raw.defaultStatus?.trim();
-    const rawFolder = raw.folder?.trim();
-    const folder = rawFolder && rawFolder.length > 0
-        ? normalizeItemTypeFolder(rawFolder)
-        : undefined;
-    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(", ")}.`);
-        }
-    }
-    return {
-        name,
-        description: description && description.length > 0 ? description : undefined,
-        defaultStatus: defaultStatus && defaultStatus.length > 0 ? defaultStatus : undefined,
-        folder,
-        aliases,
-    };
-}
-/** Throws when the requested name or any alias collides (case-insensitively) with the canonical name or an alias of a DIFFERENT existing definition. Such collisions would make `pm create`/`pm update --type` resolve ambiguously (the runtime registry keys a single lowercase alias map), so they are rejected. Tokens belonging to the same-named definition being upserted are ignored, keeping re-runs idempotent. */
-export function assertAliasesAvailable(input, existing) {
-    const selfLower = input.name.toLowerCase();
-    const taken = new Map();
-    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;
-        }
-        taken.set(definitionName.toLowerCase(), definitionName);
-        for (const alias of coerceAliasArray(definition.aliases)) {
-            if (alias.trim().length > 0) {
-                taken.set(alias.trim().toLowerCase(), definitionName);
-            }
-        }
-    }
-    const nameOwner = taken.get(selfLower);
-    if (nameOwner) {
-        throw new Error(`Type name "${input.name}" collides with an alias of existing item type "${nameOwner}".`);
-    }
-    for (const alias of input.aliases) {
-        const owner = taken.get(alias.toLowerCase());
-        if (owner) {
-            throw new Error(`Alias "${alias}" already maps to existing item type "${owner}".`);
-        }
-    }
-}
-/** 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 normalizeItemTypeFolder(folder).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 definitions, or a nested `{ item_types: { definitions: [...] } }` form, and tolerates a missing/invalid file by returning an empty definitions list. */
-export function parseItemTypesFile(raw) {
-    if (raw === null || raw === undefined || raw.trim().length === 0) {
-        return { definitions: [] };
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        throw new Error("schema/types.json contains invalid JSON.");
-    }
-    return { definitions: extractDefinitions(parsed) };
-}
-function extractDefinitions(parsed) {
-    const candidate = selectDefinitionsArray(parsed);
-    if (!candidate) {
-        return [];
-    }
-    const definitions = [];
-    for (const entry of candidate) {
-        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
-            continue;
-        }
-        const record = entry;
-        if (typeof record.name !== "string" || record.name.trim().length === 0) {
-            continue;
-        }
-        definitions.push(record);
-    }
-    return definitions;
-}
-function selectDefinitionsArray(parsed) {
-    if (Array.isArray(parsed)) {
-        return parsed;
-    }
-    if (typeof parsed !== "object" || parsed === null) {
-        return undefined;
-    }
-    const record = parsed;
-    if (Array.isArray(record.definitions)) {
-        return record.definitions;
-    }
-    if (typeof record.item_types === "object" && record.item_types !== null) {
-        const nested = record.item_types;
-        if (Array.isArray(nested.definitions)) {
-            return nested.definitions;
-        }
-    }
-    return undefined;
-}
-/** Idempotent UPSERT of a custom item type into the parsed file. Matching is case-insensitive by name. When a definition already exists, fields supplied in `input` override the previous values; aliases are merged (deduped); other fields not addressed by add-type flags are preserved untouched. */
-export function upsertItemType(file, input) {
-    const lowerName = input.name.toLowerCase();
-    const definitions = file.definitions.slice();
-    const existingIndex = definitions.findIndex((definition) => typeof definition.name === "string" &&
-        definition.name.trim().toLowerCase() === lowerName);
-    const existing = existingIndex >= 0 ? definitions[existingIndex] : undefined;
-    const mergedAliases = dedupeAliases([
-        ...coerceAliasArray(existing?.aliases),
-        ...input.aliases,
-    ]);
-    const next = {
-        ...existing,
-        name: input.name,
-    };
-    if (input.folder !== undefined) {
-        next.folder = input.folder;
-    }
-    if (mergedAliases.length > 0) {
-        next.aliases = mergedAliases;
-    }
-    else if (next.aliases !== undefined) {
-        delete next.aliases;
-    }
-    applyAttribute(next, "description", input.description);
-    applyAttribute(next, "default_status", input.defaultStatus);
-    if (existingIndex >= 0) {
-        definitions[existingIndex] = next;
-    }
-    else {
-        definitions.push(next);
-    }
-    definitions.sort((left, right) => left.name.localeCompare(right.name));
-    return {
-        file: { definitions },
-        definition: next,
-        replaced: existingIndex >= 0,
-        ...(existing && typeof existing.name === "string"
-            ? { previousName: existing.name }
-            : {}),
-    };
-}
-/** Removes a custom item type definition from the parsed file by name (case-insensitive). Throws a plain Error when `name` is empty or collides with a reserved built-in type (built-ins are not stored in the file and must never be deletable). Returns `removed: false` when no matching custom definition exists so the CLI layer can treat the call as an idempotent no-op. */
-export function removeItemType(file, name) {
-    const trimmed = (name ?? "").trim();
-    if (trimmed.length === 0) {
-        throw new Error("Type name must not be empty.");
-    }
-    const builtinMatch = matchBuiltinTypeName(trimmed);
-    if (builtinMatch) {
-        throw new Error(`Cannot remove built-in item type "${builtinMatch}". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(", ")}.`);
-    }
-    const lowerName = trimmed.toLowerCase();
-    const definitions = file.definitions.slice();
-    const existingIndex = definitions.findIndex((definition) => typeof definition.name === "string" &&
-        definition.name.trim().toLowerCase() === lowerName);
-    if (existingIndex < 0) {
-        return { file: { definitions }, removed: false };
-    }
-    const [definition] = definitions.splice(existingIndex, 1);
-    return { file: { definitions }, removed: true, definition };
-}
-function applyAttribute(definition, key, value) {
-    const record = definition;
-    if (value !== undefined) {
-        record[key] = value;
-    }
-}
-/** Serializes the item types file with a trailing newline (matches the rest of the schema scaffold files written by pm). */
-export function serializeItemTypesFile(file) {
-    return `${JSON.stringify({ definitions: file.definitions }, null, 2)}\n`;
-}
-/** Appends a discoverable hint to the "Invalid type" error so agents learn that 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, typesFilePath) {
-    const safeName = name.trim().length > 0 ? name.trim() : name;
-    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, typesFilePath) {
-    return `Invalid type value "${name}". Allowed: ${allowedTypes.join(", ")}. ${buildInvalidTypeHint(name, typesFilePath)}`;
-}
+!(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]="24688724-53cd-5375-ae7e-cfe098cd0dc8")}catch(e2){}})();import{BUILTIN_ITEM_TYPE_VALUES}from"../../types/index.js";import{normalizeItemTypeFolder,toDefaultFolder}from"../item/type-registry.js";const BUILTIN_NAME_LOOKUP=new Map(BUILTIN_ITEM_TYPE_VALUES.map(name=>[name.toLowerCase(),name]));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").`)}}function matchBuiltinTypeName(name){return BUILTIN_NAME_LOOKUP.get(name.trim().toLowerCase())}function coerceAliasArray(value){return Array.isArray(value)?value.filter(entry=>typeof entry==="string"):[]}function escapeForDoubleQuotes(value){return value.replace(/[\\"`$]/g,char=>`\\${char}`)}function dedupeAliases(values){const seen=new Map;for(const value of values){const trimmed=value.trim();if(trimmed.length===0){continue}const key=trimmed.toLowerCase();if(!seen.has(key)){seen.set(key,trimmed)}}return[...seen.values()].sort((left,right)=>left.localeCompare(right))}function normalizeAddTypeInput(raw){const name=(raw.name??"").trim();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(", ")}.`)}const description=raw.description?.trim();const defaultStatus=raw.defaultStatus?.trim();const rawFolder=raw.folder?.trim();const folder=rawFolder&&rawFolder.length>0?normalizeItemTypeFolder(rawFolder):void 0;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(", ")}.`)}}return{name,description:description&&description.length>0?description:void 0,defaultStatus:defaultStatus&&defaultStatus.length>0?defaultStatus:void 0,folder,aliases}}function assertAliasesAvailable(input,existing){const selfLower=input.name.toLowerCase();const taken=new Map;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}taken.set(definitionName.toLowerCase(),definitionName);for(const alias of coerceAliasArray(definition.aliases)){if(alias.trim().length>0){taken.set(alias.trim().toLowerCase(),definitionName)}}}const nameOwner=taken.get(selfLower);if(nameOwner){throw new Error(`Type name "${input.name}" collides with an alias of existing item type "${nameOwner}".`)}for(const alias of input.aliases){const owner=taken.get(alias.toLowerCase());if(owner){throw new Error(`Alias "${alias}" already maps to existing item type "${owner}".`)}}}function resolveDefinitionFolder(name,folder){if(typeof folder==="string"&&folder.trim().length>0){return normalizeItemTypeFolder(folder).toLowerCase()}return toDefaultFolder(name).toLowerCase()}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!==void 0&&reservedOwner.toLowerCase()!==selfLower){fail(reservedOwner)}}function parseItemTypesFile(raw){if(raw===null||raw===void 0||raw.trim().length===0){return{definitions:[]}}let parsed;try{parsed=JSON.parse(raw)}catch{throw new Error("schema/types.json contains invalid JSON.")}return{definitions:extractDefinitions(parsed)}}function extractDefinitions(parsed){const candidate=selectDefinitionsArray(parsed);if(!candidate){return[]}const definitions=[];for(const entry of candidate){if(typeof entry!=="object"||entry===null||Array.isArray(entry)){continue}const record=entry;if(typeof record.name!=="string"||record.name.trim().length===0){continue}definitions.push(record)}return definitions}function selectDefinitionsArray(parsed){if(Array.isArray(parsed)){return parsed}if(typeof parsed!=="object"||parsed===null){return void 0}const record=parsed;if(Array.isArray(record.definitions)){return record.definitions}if(typeof record.item_types==="object"&&record.item_types!==null){const nested=record.item_types;if(Array.isArray(nested.definitions)){return nested.definitions}}return void 0}function upsertItemType(file,input){const lowerName=input.name.toLowerCase();const definitions=file.definitions.slice();const existingIndex=definitions.findIndex(definition=>typeof definition.name==="string"&&definition.name.trim().toLowerCase()===lowerName);const existing=existingIndex>=0?definitions[existingIndex]:void 0;const mergedAliases=dedupeAliases([...coerceAliasArray(existing?.aliases),...input.aliases]);const next={...existing,name:input.name};if(input.folder!==void 0){next.folder=input.folder}if(mergedAliases.length>0){next.aliases=mergedAliases}else if(next.aliases!==void 0){delete next.aliases}applyAttribute(next,"description",input.description);applyAttribute(next,"default_status",input.defaultStatus);if(existingIndex>=0){definitions[existingIndex]=next}else{definitions.push(next)}definitions.sort((left,right)=>left.name.localeCompare(right.name));return{file:{definitions},definition:next,replaced:existingIndex>=0,...existing&&typeof existing.name==="string"?{previousName:existing.name}:{}}}function removeItemType(file,name){const trimmed=(name??"").trim();if(trimmed.length===0){throw new Error("Type name must not be empty.")}const builtinMatch=matchBuiltinTypeName(trimmed);if(builtinMatch){throw new Error(`Cannot remove built-in item type "${builtinMatch}". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(", ")}.`)}const lowerName=trimmed.toLowerCase();const definitions=file.definitions.slice();const existingIndex=definitions.findIndex(definition2=>typeof definition2.name==="string"&&definition2.name.trim().toLowerCase()===lowerName);if(existingIndex<0){return{file:{definitions},removed:false}}const[definition]=definitions.splice(existingIndex,1);return{file:{definitions},removed:true,definition}}function applyAttribute(definition,key,value){const record=definition;if(value!==void 0){record[key]=value}}function serializeItemTypesFile(file){return`${JSON.stringify({definitions:file.definitions},null,2)}
+`}function buildInvalidTypeHint(name,typesFilePath){const safeName=name.trim().length>0?name.trim():name;const target=typesFilePath?.trim()||".agents/pm/schema/types.json";return`To register a custom type, run: pm schema add-type "${escapeForDoubleQuotes(safeName)}" (writes ${target}).`}function buildInvalidTypeError(name,allowedTypes,typesFilePath){return`Invalid type value "${name}". Allowed: ${allowedTypes.join(", ")}. ${buildInvalidTypeHint(name,typesFilePath)}`}export{assertAliasesAvailable,assertTypeFolderAvailable,buildInvalidTypeError,buildInvalidTypeHint,escapeForDoubleQuotes,matchBuiltinTypeName,normalizeAddTypeInput,parseItemTypesFile,removeItemType,serializeItemTypesFile,upsertItemType};
 //# sourceMappingURL=item-types-file.js.map
-//# debugId=989b570c-112e-5ee3-8731-ab34f215ba45