@unbrained/pm-cli 2026.9.7 → 2026.9.8

package/dist/core/item/type-registry.js

@@ -1,716 +1,2 @@
-/**
- * @module core/item/type-registry
- *
- * Defines item parsing, formatting, and lifecycle helpers for Type Registry.
- */
-
-!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]="506efdc7-b04e-5023-ab59-57ede87558f9")}catch(e){}}();
-import path from "node:path";
-import { TYPE_TO_FOLDER } from "../shared/constants.js";
-import { ITEM_TYPE_VALUES } from "../../types/index.js";
-import { normalizeItemTypeDefinition as normalizeSharedItemTypeDefinition, normalizeItemTypeStringList, strictPolicyCommand, parseItemExecutionRole, } from "./item-type-definition.js";
-/** Default dispatch roles for built-in types whose work requires human input or outcome verification. Custom definitions can override these through the same registry. */
-export const BUILTIN_ITEM_EXECUTION_ROLES = Object.freeze({ decision: "human", milestone: "gate" });
-/** Fallback required create fields used when callers do not provide an override. */
-export const DEFAULT_REQUIRED_CREATE_FIELDS = [
-    "title",
-    "description",
-    "status",
-    "priority",
-    "tags",
-    "body",
-    "deadline",
-    "estimatedMinutes",
-    "acceptanceCriteria",
-    "author",
-    "message",
-    "assignee",
-];
-/** Fallback required create repeatables used when callers do not provide an override. */
-export const DEFAULT_REQUIRED_CREATE_REPEATABLES = [
-    "dep",
-    "comment",
-    "note",
-    "learning",
-    "file",
-    "test",
-    "doc",
-];
-// Keep aligned with cli/commands/shared-unset-fields.ts. This core registry
-// cannot import CLI unset metadata without creating a core -> CLI dependency.
-/** Public contract for common mutation command option keys, shared by SDK and presentation-layer consumers. */
-export const COMMON_MUTATION_COMMAND_OPTION_KEYS = [
-    "deadline",
-    "estimatedMinutes",
-    "acceptanceCriteria",
-    "definitionOfReady",
-    "order",
-    "goal",
-    "objective",
-    "value",
-    "impact",
-    "outcome",
-    "whyNow",
-    "assignee",
-    "parent",
-    "reviewer",
-    "risk",
-    "confidence",
-    "sprint",
-    "release",
-    "blockedBy",
-    "blockedReason",
-    "unblockNote",
-    "reporter",
-    "severity",
-    "environment",
-    "reproSteps",
-    "resolution",
-    "expectedResult",
-    "actualResult",
-    "affectedVersion",
-    "fixedVersion",
-    "component",
-    "regression",
-    "customerImpact",
-];
-const CREATE_COMMAND_OPTION_KEYS = [
-    "title",
-    "description",
-    "type",
-    "status",
-    "priority",
-    "tags",
-    "body",
-    ...COMMON_MUTATION_COMMAND_OPTION_KEYS,
-    "author",
-    "message",
-    "dep",
-    "comment",
-    "note",
-    "learning",
-    "file",
-    "test",
-    "doc",
-    "reminder",
-    "event",
-    "typeOption",
-    "field",
-];
-const UPDATE_COMMAND_OPTION_KEYS = [
-    "title",
-    "description",
-    "body",
-    "status",
-    "closeReason",
-    "priority",
-    "type",
-    "tags",
-    ...COMMON_MUTATION_COMMAND_OPTION_KEYS,
-    "author",
-    "message",
-    "comment",
-    "note",
-    "learning",
-    "file",
-    "test",
-    "doc",
-    "reminder",
-    "event",
-    "typeOption",
-    "field",
-    "ownershipMetadataBypass",
-    "ownershipDependencyBypass",
-    "force",
-];
-const SHARED_COMMAND_OPTION_ALIASES = {
-    "close-reason": "closeReason",
-    close_reason: "closeReason",
-    "estimated-minutes": "estimatedMinutes",
-    estimated_minutes: "estimatedMinutes",
-    estimate: "estimatedMinutes",
-    "acceptance-criteria": "acceptanceCriteria",
-    acceptance_criteria: "acceptanceCriteria",
-    ac: "acceptanceCriteria",
-    "definition-of-ready": "definitionOfReady",
-    definition_of_ready: "definitionOfReady",
-    rank: "order",
-    "why-now": "whyNow",
-    why_now: "whyNow",
-    "blocked-by": "blockedBy",
-    blocked_by: "blockedBy",
-    "blocked-reason": "blockedReason",
-    blocked_reason: "blockedReason",
-    "unblock-note": "unblockNote",
-    unblock_note: "unblockNote",
-    "repro-steps": "reproSteps",
-    repro_steps: "reproSteps",
-    "expected-result": "expectedResult",
-    expected_result: "expectedResult",
-    "actual-result": "actualResult",
-    actual_result: "actualResult",
-    "affected-version": "affectedVersion",
-    affected_version: "affectedVersion",
-    "fixed-version": "fixedVersion",
-    fixed_version: "fixedVersion",
-    "customer-impact": "customerImpact",
-    customer_impact: "customerImpact",
-    "type-option": "typeOption",
-    type_option: "typeOption",
-    type_options: "typeOption",
-};
-const CREATE_COMMAND_OPTION_ALIASES = {
-    ...SHARED_COMMAND_OPTION_ALIASES,
-};
-const UPDATE_COMMAND_OPTION_ALIASES = {
-    ...SHARED_COMMAND_OPTION_ALIASES,
-};
-const COMMON_MUTATION_COMMAND_OPTION_FLAG_LABEL_ENTRIES = [
-    ["deadline", "--deadline"],
-    ["estimatedMinutes", "--estimate/--estimated-minutes"],
-    ["acceptanceCriteria", "--acceptance-criteria/--ac"],
-    ["definitionOfReady", "--definition-of-ready"],
-    ["order", "--order/--rank"],
-    ["goal", "--goal"],
-    ["objective", "--objective"],
-    ["value", "--value"],
-    ["impact", "--impact"],
-    ["outcome", "--outcome"],
-    ["whyNow", "--why-now"],
-    ["assignee", "--assignee"],
-    ["parent", "--parent"],
-    ["reviewer", "--reviewer"],
-    ["risk", "--risk"],
-    ["confidence", "--confidence"],
-    ["sprint", "--sprint"],
-    ["release", "--release"],
-    ["blockedBy", "--blocked-by"],
-    ["blockedReason", "--blocked-reason"],
-    ["unblockNote", "--unblock-note"],
-    ["reporter", "--reporter"],
-    ["severity", "--severity"],
-    ["environment", "--environment"],
-    ["reproSteps", "--repro-steps"],
-    ["resolution", "--resolution"],
-    ["expectedResult", "--expected-result"],
-    ["actualResult", "--actual-result"],
-    ["affectedVersion", "--affected-version"],
-    ["fixedVersion", "--fixed-version"],
-    ["component", "--component"],
-    ["regression", "--regression"],
-    ["customerImpact", "--customer-impact"],
-];
-const LINKED_RESOURCE_COMMAND_OPTION_FLAG_LABEL_ENTRIES = [
-    ["comment", "--comment"],
-    ["note", "--note"],
-    ["learning", "--learning"],
-    ["file", "--file"],
-    ["test", "--test"],
-    ["doc", "--doc"],
-    ["reminder", "--reminder"],
-    ["event", "--event"],
-    ["typeOption", "--type-option"],
-];
-function commandOptionLabelMap(entries) {
-    return Object.fromEntries(entries);
-}
-const CREATE_COMMAND_OPTION_FLAG_LABELS = commandOptionLabelMap([
-    ["title", "--title"],
-    ["description", "--description"],
-    ["type", "--type"],
-    ["status", "--status"],
-    ["priority", "--priority"],
-    ["tags", "--tags"],
-    ["body", "--body"],
-    ...COMMON_MUTATION_COMMAND_OPTION_FLAG_LABEL_ENTRIES,
-    ["author", "--author"],
-    ["message", "--message"],
-    ["dep", "--dep"],
-    ...LINKED_RESOURCE_COMMAND_OPTION_FLAG_LABEL_ENTRIES,
-]);
-const UPDATE_COMMAND_OPTION_FLAG_LABELS = commandOptionLabelMap([
-    ["title", "--title"],
-    ["description", "--description"],
-    ["body", "--body"],
-    ["status", "--status"],
-    ["closeReason", "--close-reason"],
-    ["priority", "--priority"],
-    ["type", "--type"],
-    ["tags", "--tags"],
-    ...COMMON_MUTATION_COMMAND_OPTION_FLAG_LABEL_ENTRIES,
-    ...LINKED_RESOURCE_COMMAND_OPTION_FLAG_LABEL_ENTRIES,
-    ["author", "--author"],
-    ["message", "--message"],
-    ["force", "--force"],
-]);
-function normalizeCommandOptionToken(value) {
-    return value.trim().replace(/^--+/, "").toLowerCase();
-}
-function commandOptionKeys(command) {
-    return command === "create"
-        ? CREATE_COMMAND_OPTION_KEYS
-        : UPDATE_COMMAND_OPTION_KEYS;
-}
-function commandOptionAliases(command) {
-    return command === "create"
-        ? CREATE_COMMAND_OPTION_ALIASES
-        : UPDATE_COMMAND_OPTION_ALIASES;
-}
-/** Implements canonicalize command option key for the public runtime surface of this module. */
-export function canonicalizeCommandOptionKey(command, rawOption) {
-    const normalizedToken = normalizeCommandOptionToken(rawOption);
-    if (normalizedToken.length === 0) {
-        return undefined;
-    }
-    const aliased = commandOptionAliases(command)[normalizedToken];
-    if (aliased) {
-        return aliased;
-    }
-    return commandOptionKeys(command).find((candidate) => candidate.toLowerCase() === normalizedToken);
-}
-/** Implements command option flag label for the public runtime surface of this module. */
-export function commandOptionFlagLabel(command, optionKey) {
-    const labels = command === "create"
-        ? CREATE_COMMAND_OPTION_FLAG_LABELS
-        : UPDATE_COMMAND_OPTION_FLAG_LABELS;
-    return (labels[optionKey] ??
-        `--${optionKey.replace(/([A-Z])/g, "-$1").toLowerCase()}`);
-}
-/** Implements to default folder for the public runtime surface of this module. */
-export function toDefaultFolder(name) {
-    const normalized = toSlugToken(name);
-    if (normalized.length === 0) {
-        return "items";
-    }
-    return normalized.endsWith("s") ? normalized : `${normalized}s`;
-}
-/**
- * Canonicalizes a custom item-type folder as a portable tracker-relative path.
- *
- * Leading separators retain the historical CLI meaning of "relative to the pm
- * tracker", while Windows separators are normalized so definitions behave
- * identically on every host. Traversal, drive-prefixed, empty, and NUL-bearing
- * values fail closed before callers can resolve an item or history path.
- */
-export function normalizeItemTypeFolder(folder) {
-    const trimmed = folder.trim();
-    const portable = trimmed.replaceAll("\\", "/");
-    const trackerRelative = portable.replace(/^\/+/, "");
-    const normalized = path.posix.normalize(trackerRelative);
-    if (trimmed.includes("\0") ||
-        /^[A-Za-z]:/.test(normalized) ||
-        normalized === "." ||
-        normalized === ".." ||
-        normalized.startsWith("../")) {
-        throw new Error(`Item type folder "${folder}" must stay inside the pm tracker root.`);
-    }
-    return normalized;
-}
-function toSlugToken(value) {
-    const trimmed = value.trim().toLowerCase();
-    let slug = "";
-    let pendingDash = false;
-    for (const character of trimmed) {
-        const code = character.charCodeAt(0);
-        const isAlpha = code >= 97 && code <= 122;
-        const isDigit = code >= 48 && code <= 57;
-        if (isAlpha || isDigit) {
-            if (pendingDash && slug.length > 0) {
-                slug += "-";
-            }
-            slug += character;
-            pendingDash = false;
-            continue;
-        }
-        if (slug.length > 0) {
-            pendingDash = true;
-        }
-    }
-    return slug;
-}
-// Runtime registry consumes untrusted extension/file definitions, so it uses the
-// strict policy-command resolver (trim + lowercase, reject non-create/update). All
-// other normalization is single-sourced from ./item-type-definition.ts (pm-v798).
-function normalizeTypeDefinition(definition) {
-    return normalizeSharedItemTypeDefinition(definition, {
-        resolvePolicyCommand: strictPolicyCommand,
-    });
-}
-function readStringArray(record, key) {
-    const value = record[key];
-    return Array.isArray(value)
-        ? value.filter((entry) => typeof entry === "string")
-        : undefined;
-}
-function coerceOptionDefinitionFromUnknown(raw) {
-    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-        return null;
-    }
-    const optionRecord = raw;
-    if (typeof optionRecord.key !== "string") {
-        return null;
-    }
-    return {
-        key: optionRecord.key,
-        values: readStringArray(optionRecord, "values") ?? [],
-        required: optionRecord.required === undefined
-            ? undefined
-            : Boolean(optionRecord.required),
-        aliases: readStringArray(optionRecord, "aliases"),
-        description: typeof optionRecord.description === "string"
-            ? optionRecord.description
-            : undefined,
-    };
-}
-function coerceCommandOptionPolicyFromUnknown(raw) {
-    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-        return null;
-    }
-    const policyRecord = raw;
-    if (typeof policyRecord.command !== "string" ||
-        typeof policyRecord.option !== "string") {
-        return null;
-    }
-    const normalizedCommand = policyRecord.command.trim().toLowerCase();
-    if (normalizedCommand !== "create" && normalizedCommand !== "update") {
-        return null;
-    }
-    return {
-        command: normalizedCommand,
-        option: policyRecord.option,
-        required: policyRecord.required === undefined
-            ? undefined
-            : Boolean(policyRecord.required),
-        visible: policyRecord.visible === undefined
-            ? undefined
-            : Boolean(policyRecord.visible),
-        enabled: policyRecord.enabled === undefined
-            ? undefined
-            : Boolean(policyRecord.enabled),
-    };
-}
-function coerceOptionDefinitionsFromRecord(record) {
-    if (!Array.isArray(record.options)) {
-        return undefined;
-    }
-    return record.options
-        .map((entry) => coerceOptionDefinitionFromUnknown(entry))
-        .filter((entry) => entry !== null);
-}
-function coerceCommandOptionPoliciesFromRecord(record) {
-    if (!Array.isArray(record.command_option_policies)) {
-        return undefined;
-    }
-    return record.command_option_policies
-        .map((entry) => coerceCommandOptionPolicyFromUnknown(entry))
-        .filter((entry) => entry !== null);
-}
-function coerceTypeDefinitionFromUnknown(raw) {
-    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-        return null;
-    }
-    const record = raw;
-    const name = typeof record.name === "string" ? record.name : "";
-    if (name.trim().length === 0) {
-        return null;
-    }
-    const folder = typeof record.folder === "string" ? record.folder : undefined;
-    const description = typeof record.description === "string" ? record.description : undefined;
-    const defaultStatus = typeof record.default_status === "string"
-        ? record.default_status
-        : undefined;
-    return {
-        name,
-        description,
-        default_status: defaultStatus,
-        execution_role: parseItemExecutionRole(record.execution_role),
-        folder,
-        aliases: readStringArray(record, "aliases"),
-        required_create_fields: readStringArray(record, "required_create_fields"),
-        required_create_repeatables: readStringArray(record, "required_create_repeatables"),
-        options: coerceOptionDefinitionsFromRecord(record),
-        command_option_policies: coerceCommandOptionPoliciesFromRecord(record),
-    };
-}
-function resolveDefinitionRequiredCreateFields(normalizedDefinition, existing) {
-    return normalizedDefinition.required_create_fields
-        ? normalizeItemTypeStringList(normalizedDefinition.required_create_fields)
-        : (existing?.required_create_fields ?? []);
-}
-function resolveDefinitionRequiredCreateRepeatables(normalizedDefinition, existing) {
-    return normalizedDefinition.required_create_repeatables
-        ? normalizeItemTypeStringList(normalizedDefinition.required_create_repeatables)
-        : (existing?.required_create_repeatables ?? []);
-}
-function resolveDefinitionOptions(normalizedDefinition, existing) {
-    return normalizedDefinition.options
-        ? normalizedDefinition.options
-        : existing?.options
-            ? [...existing.options]
-            : [];
-}
-function resolveDefinitionCommandOptionPolicies(normalizedDefinition, existing) {
-    return normalizedDefinition.command_option_policies
-        ? normalizedDefinition.command_option_policies
-        : existing?.command_option_policies
-            ? [...existing.command_option_policies]
-            : [];
-}
-function buildResolvedTypeDefinition(normalizedDefinition, existing) {
-    const keepName = existing?.name ?? normalizedDefinition.name;
-    const description = normalizedDefinition.description ?? existing?.description;
-    const defaultStatus = normalizedDefinition.default_status ?? existing?.default_status;
-    const folder = normalizeItemTypeFolder(normalizedDefinition.folder ??
-        existing?.folder ??
-        toDefaultFolder(keepName));
-    const resolvedDefinition = {
-        name: keepName,
-        execution_role: normalizedDefinition.execution_role,
-        folder,
-        aliases: normalizeItemTypeStringList([
-            ...(existing?.aliases ?? []),
-            ...(normalizedDefinition.aliases ?? []),
-        ]),
-        required_create_fields: resolveDefinitionRequiredCreateFields(normalizedDefinition, existing),
-        required_create_repeatables: resolveDefinitionRequiredCreateRepeatables(normalizedDefinition, existing),
-        options: resolveDefinitionOptions(normalizedDefinition, existing),
-        command_option_policies: resolveDefinitionCommandOptionPolicies(normalizedDefinition, existing),
-    };
-    if (description) {
-        resolvedDefinition.description = description;
-    }
-    if (defaultStatus) {
-        resolvedDefinition.default_status = defaultStatus;
-    }
-    return resolvedDefinition;
-}
-function applyTypeDefinitions(source, target) {
-    for (const rawDefinition of source) {
-        const normalizedDefinition = normalizeTypeDefinition(rawDefinition);
-        if (!normalizedDefinition) {
-            continue;
-        }
-        const lowerName = normalizedDefinition.name.toLowerCase();
-        const existing = target.get(lowerName);
-        target.set(lowerName, buildResolvedTypeDefinition({ ...normalizedDefinition, execution_role: normalizedDefinition.execution_role ?? existing?.execution_role }, existing));
-    }
-}
-function collectExtensionTypeDefinitions(registrations) {
-    if (!registrations) {
-        return [];
-    }
-    const definitions = [];
-    for (const registration of registrations.item_types ?? []) {
-        const typeDefinitionsRaw = registration.types;
-        if (!Array.isArray(typeDefinitionsRaw)) {
-            continue;
-        }
-        for (const rawDefinition of typeDefinitionsRaw) {
-            const normalized = coerceTypeDefinitionFromUnknown(rawDefinition);
-            if (normalized) {
-                definitions.push(normalized);
-            }
-        }
-    }
-    return definitions;
-}
-/** Implements resolve item type registry for the public runtime surface of this module. */
-export function resolveItemTypeRegistry(settings, extensionRegistrations = null) {
-    const byLowerName = new Map();
-    for (const builtin of ITEM_TYPE_VALUES) {
-        byLowerName.set(builtin.toLowerCase(), {
-            name: builtin,
-            execution_role: BUILTIN_ITEM_EXECUTION_ROLES[builtin.toLowerCase()] ?? "agent",
-            folder: TYPE_TO_FOLDER[builtin],
-            aliases: [],
-            required_create_fields: [...DEFAULT_REQUIRED_CREATE_FIELDS],
-            required_create_repeatables: [...DEFAULT_REQUIRED_CREATE_REPEATABLES],
-            options: [],
-            command_option_policies: [],
-        });
-    }
-    applyTypeDefinitions(settings.item_types?.definitions ?? [], byLowerName);
-    applyTypeDefinitions(collectExtensionTypeDefinitions(extensionRegistrations), byLowerName);
-    const definitions = [...byLowerName.values()].sort((left, right) => left.name.localeCompare(right.name));
-    const byType = {};
-    const aliasToType = {};
-    const typeToFolder = {};
-    for (const definition of definitions) {
-        byType[definition.name] = definition;
-        typeToFolder[definition.name] = definition.folder;
-        aliasToType[definition.name.toLowerCase()] = definition.name;
-        for (const alias of definition.aliases) {
-            aliasToType[alias.toLowerCase()] = definition.name;
-        }
-    }
-    const folders = [
-        ...new Set(definitions.map((definition) => definition.folder)),
-    ].sort((left, right) => left.localeCompare(right));
-    return {
-        types: definitions.map((definition) => definition.name),
-        folders,
-        type_to_folder: typeToFolder,
-        by_type: byType,
-        alias_to_type: aliasToType,
-    };
-}
-/** Implements resolve type name for the public runtime surface of this module. */
-export function resolveTypeName(rawType, registry) {
-    if (rawType === undefined) {
-        return undefined;
-    }
-    return registry.alias_to_type[rawType.trim().toLowerCase()];
-}
-/** Implements resolve type definition for the public runtime surface of this module. */
-export function resolveTypeDefinition(typeName, registry) {
-    const resolvedName = resolveTypeName(typeName, registry);
-    if (!resolvedName) {
-        return undefined;
-    }
-    return registry.by_type[resolvedName];
-}
-function applyBaseRequiredCommandOptions(state, typeDefinition, command, baseRequiredOptions) {
-    for (const rawBase of baseRequiredOptions) {
-        const canonical = canonicalizeCommandOptionKey(command, rawBase);
-        if (canonical) {
-            state.required.add(canonical);
-            continue;
-        }
-        state.errors.push(`Unsupported base required option "${rawBase}" for command "${command}" on type "${typeDefinition.name}"`);
-    }
-}
-function applyBooleanPolicySet(target, option, enabled) {
-    if (enabled) {
-        target.add(option);
-        return;
-    }
-    target.delete(option);
-}
-function applyCommandOptionPolicy(state, typeDefinition, command, policy) {
-    const canonical = canonicalizeCommandOptionKey(command, policy.option);
-    if (!canonical) {
-        state.errors.push(`Unsupported command_option_policies option "${policy.option}" for command "${command}" on type "${typeDefinition.name}"`);
-        return;
-    }
-    if (policy.required !== undefined) {
-        applyBooleanPolicySet(state.required, canonical, policy.required);
-    }
-    if (policy.visible !== undefined) {
-        applyBooleanPolicySet(state.hidden, canonical, !policy.visible);
-    }
-    if (policy.enabled !== undefined) {
-        applyBooleanPolicySet(state.disabled, canonical, !policy.enabled);
-    }
-}
-function applyCommandOptionPolicies(state, typeDefinition, command) {
-    for (const policy of typeDefinition.command_option_policies) {
-        if (policy.command === command) {
-            applyCommandOptionPolicy(state, typeDefinition, command, policy);
-        }
-    }
-}
-function appendRequiredDisabledPolicyErrors(state, typeDefinition, command) {
-    for (const option of state.required) {
-        if (state.disabled.has(option)) {
-            state.errors.push(`Option "${option}" cannot be both required and disabled for command "${command}" on type "${typeDefinition.name}"`);
-        }
-    }
-}
-/** Implements resolve command option policy state for the public runtime surface of this module. */
-export function resolveCommandOptionPolicyState(typeDefinition, command, baseRequiredOptions) {
-    const errors = [];
-    const required = new Set();
-    const hidden = new Set();
-    const disabled = new Set();
-    const state = { required, hidden, disabled, errors };
-    applyBaseRequiredCommandOptions(state, typeDefinition, command, baseRequiredOptions);
-    applyCommandOptionPolicies(state, typeDefinition, command);
-    appendRequiredDisabledPolicyErrors(state, typeDefinition, command);
-    return {
-        required: [...required],
-        hidden: [...hidden].sort((left, right) => left.localeCompare(right)),
-        disabled: [...disabled].sort((left, right) => left.localeCompare(right)),
-        errors,
-    };
-}
-function buildTypeOptionAliasMap(typeDefinition) {
-    const optionByAlias = new Map();
-    for (const option of typeDefinition.options) {
-        optionByAlias.set(option.key.toLowerCase(), option);
-        for (const alias of option.aliases ?? []) {
-            optionByAlias.set(alias.toLowerCase(), option);
-        }
-    }
-    return optionByAlias;
-}
-function resolveTypeOptionValue(optionDefinition, trimmedValue, errors) {
-    const allowedValues = optionDefinition.values;
-    if (allowedValues.length === 0) {
-        return trimmedValue;
-    }
-    const valueLookup = new Map(allowedValues.map((value) => [value.toLowerCase(), value]));
-    const canonical = valueLookup.get(trimmedValue.toLowerCase());
-    if (!canonical) {
-        errors.push(`Invalid value "${trimmedValue}" for type option "${optionDefinition.key}". Allowed: ${allowedValues.join(", ")}`);
-        return undefined;
-    }
-    return canonical;
-}
-/** Implements validate type options for the public runtime surface of this module. */
-export function validateTypeOptions(typeName, rawTypeOptions, registry) {
-    const typeDefinition = resolveTypeDefinition(typeName, registry);
-    if (!typeDefinition) {
-        return {
-            normalized: undefined,
-            errors: [`Unknown type "${typeName}"`],
-        };
-    }
-    const errors = [];
-    const optionByAlias = buildTypeOptionAliasMap(typeDefinition);
-    const normalized = {};
-    for (const [rawKey, rawValue] of Object.entries(rawTypeOptions ?? {})) {
-        const trimmedKey = rawKey.trim();
-        const trimmedValue = rawValue.trim();
-        if (trimmedKey.length === 0) {
-            errors.push("type option keys must not be empty");
-            continue;
-        }
-        if (trimmedValue.length === 0) {
-            errors.push(`type option "${trimmedKey}" must not be empty`);
-            continue;
-        }
-        const optionDefinition = optionByAlias.get(trimmedKey.toLowerCase());
-        if (!optionDefinition) {
-            const allowed = typeDefinition.options
-                .map((option) => option.key)
-                .join(", ");
-            errors.push(typeDefinition.options.length > 0
-                ? `Unknown type option "${trimmedKey}" for type "${typeDefinition.name}". Allowed: ${allowed}`
-                : `Type "${typeDefinition.name}" does not define any configurable type options`);
-            continue;
-        }
-        const resolvedValue = resolveTypeOptionValue(optionDefinition, trimmedValue, errors);
-        if (resolvedValue === undefined) {
-            continue;
-        }
-        normalized[optionDefinition.key] = resolvedValue;
-    }
-    for (const option of typeDefinition.options) {
-        if (option.required && !(option.key in normalized)) {
-            errors.push(`Missing required type option "${option.key}" for type "${typeDefinition.name}"`);
-        }
-    }
-    const sortedKeys = Object.keys(normalized).sort((left, right) => left.localeCompare(right));
-    if (sortedKeys.length === 0) {
-        return {
-            normalized: undefined,
-            errors,
-        };
-    }
-    return {
-        normalized: Object.fromEntries(sortedKeys.map((key) => [key, normalized[key]])),
-        errors,
-    };
-}
+!(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]="69ea08ca-3793-51d7-a971-95abf442028f")}catch(e2){}})();import path from"node:path";import{TYPE_TO_FOLDER}from"../shared/constants.js";import{ITEM_TYPE_VALUES}from"../../types/index.js";import{normalizeItemTypeDefinition as normalizeSharedItemTypeDefinition,normalizeItemTypeStringList,strictPolicyCommand,parseItemExecutionRole}from"./item-type-definition.js";const BUILTIN_ITEM_EXECUTION_ROLES=Object.freeze({decision:"human",milestone:"gate"});const DEFAULT_REQUIRED_CREATE_FIELDS=["title","description","status","priority","tags","body","deadline","estimatedMinutes","acceptanceCriteria","author","message","assignee"];const DEFAULT_REQUIRED_CREATE_REPEATABLES=["dep","comment","note","learning","file","test","doc"];const COMMON_MUTATION_COMMAND_OPTION_KEYS=["deadline","estimatedMinutes","acceptanceCriteria","definitionOfReady","order","goal","objective","value","impact","outcome","whyNow","assignee","parent","reviewer","risk","confidence","sprint","release","blockedBy","blockedReason","unblockNote","reporter","severity","environment","reproSteps","resolution","expectedResult","actualResult","affectedVersion","fixedVersion","component","regression","customerImpact"];const CREATE_COMMAND_OPTION_KEYS=["title","description","type","status","priority","tags","body",...COMMON_MUTATION_COMMAND_OPTION_KEYS,"author","message","dep","comment","note","learning","file","test","doc","reminder","event","typeOption","field"];const UPDATE_COMMAND_OPTION_KEYS=["title","description","body","status","closeReason","priority","type","tags",...COMMON_MUTATION_COMMAND_OPTION_KEYS,"author","message","comment","note","learning","file","test","doc","reminder","event","typeOption","field","ownershipMetadataBypass","ownershipDependencyBypass","force"];const SHARED_COMMAND_OPTION_ALIASES={"close-reason":"closeReason",close_reason:"closeReason","estimated-minutes":"estimatedMinutes",estimated_minutes:"estimatedMinutes",estimate:"estimatedMinutes","acceptance-criteria":"acceptanceCriteria",acceptance_criteria:"acceptanceCriteria",ac:"acceptanceCriteria","definition-of-ready":"definitionOfReady",definition_of_ready:"definitionOfReady",rank:"order","why-now":"whyNow",why_now:"whyNow","blocked-by":"blockedBy",blocked_by:"blockedBy","blocked-reason":"blockedReason",blocked_reason:"blockedReason","unblock-note":"unblockNote",unblock_note:"unblockNote","repro-steps":"reproSteps",repro_steps:"reproSteps","expected-result":"expectedResult",expected_result:"expectedResult","actual-result":"actualResult",actual_result:"actualResult","affected-version":"affectedVersion",affected_version:"affectedVersion","fixed-version":"fixedVersion",fixed_version:"fixedVersion","customer-impact":"customerImpact",customer_impact:"customerImpact","type-option":"typeOption",type_option:"typeOption",type_options:"typeOption"};const CREATE_COMMAND_OPTION_ALIASES={...SHARED_COMMAND_OPTION_ALIASES};const UPDATE_COMMAND_OPTION_ALIASES={...SHARED_COMMAND_OPTION_ALIASES};const COMMON_MUTATION_COMMAND_OPTION_FLAG_LABEL_ENTRIES=[["deadline","--deadline"],["estimatedMinutes","--estimate/--estimated-minutes"],["acceptanceCriteria","--acceptance-criteria/--ac"],["definitionOfReady","--definition-of-ready"],["order","--order/--rank"],["goal","--goal"],["objective","--objective"],["value","--value"],["impact","--impact"],["outcome","--outcome"],["whyNow","--why-now"],["assignee","--assignee"],["parent","--parent"],["reviewer","--reviewer"],["risk","--risk"],["confidence","--confidence"],["sprint","--sprint"],["release","--release"],["blockedBy","--blocked-by"],["blockedReason","--blocked-reason"],["unblockNote","--unblock-note"],["reporter","--reporter"],["severity","--severity"],["environment","--environment"],["reproSteps","--repro-steps"],["resolution","--resolution"],["expectedResult","--expected-result"],["actualResult","--actual-result"],["affectedVersion","--affected-version"],["fixedVersion","--fixed-version"],["component","--component"],["regression","--regression"],["customerImpact","--customer-impact"]];const LINKED_RESOURCE_COMMAND_OPTION_FLAG_LABEL_ENTRIES=[["comment","--comment"],["note","--note"],["learning","--learning"],["file","--file"],["test","--test"],["doc","--doc"],["reminder","--reminder"],["event","--event"],["typeOption","--type-option"]];function commandOptionLabelMap(entries){return Object.fromEntries(entries)}const CREATE_COMMAND_OPTION_FLAG_LABELS=commandOptionLabelMap([["title","--title"],["description","--description"],["type","--type"],["status","--status"],["priority","--priority"],["tags","--tags"],["body","--body"],...COMMON_MUTATION_COMMAND_OPTION_FLAG_LABEL_ENTRIES,["author","--author"],["message","--message"],["dep","--dep"],...LINKED_RESOURCE_COMMAND_OPTION_FLAG_LABEL_ENTRIES]);const UPDATE_COMMAND_OPTION_FLAG_LABELS=commandOptionLabelMap([["title","--title"],["description","--description"],["body","--body"],["status","--status"],["closeReason","--close-reason"],["priority","--priority"],["type","--type"],["tags","--tags"],...COMMON_MUTATION_COMMAND_OPTION_FLAG_LABEL_ENTRIES,...LINKED_RESOURCE_COMMAND_OPTION_FLAG_LABEL_ENTRIES,["author","--author"],["message","--message"],["force","--force"]]);function normalizeCommandOptionToken(value){return value.trim().replace(/^--+/,"").toLowerCase()}function commandOptionKeys(command){return command==="create"?CREATE_COMMAND_OPTION_KEYS:UPDATE_COMMAND_OPTION_KEYS}function commandOptionAliases(command){return command==="create"?CREATE_COMMAND_OPTION_ALIASES:UPDATE_COMMAND_OPTION_ALIASES}function canonicalizeCommandOptionKey(command,rawOption){const normalizedToken=normalizeCommandOptionToken(rawOption);if(normalizedToken.length===0){return void 0}const aliased=commandOptionAliases(command)[normalizedToken];if(aliased){return aliased}return commandOptionKeys(command).find(candidate=>candidate.toLowerCase()===normalizedToken)}function commandOptionFlagLabel(command,optionKey){const labels=command==="create"?CREATE_COMMAND_OPTION_FLAG_LABELS:UPDATE_COMMAND_OPTION_FLAG_LABELS;return labels[optionKey]??`--${optionKey.replace(/([A-Z])/g,"-$1").toLowerCase()}`}function toDefaultFolder(name){const normalized=toSlugToken(name);if(normalized.length===0){return"items"}return normalized.endsWith("s")?normalized:`${normalized}s`}function normalizeItemTypeFolder(folder){const trimmed=folder.trim();const portable=trimmed.replaceAll("\\","/");const trackerRelative=portable.replace(/^\/+/,"");const normalized=path.posix.normalize(trackerRelative);if(trimmed.includes("\0")||/^[A-Za-z]:/.test(normalized)||normalized==="."||normalized===".."||normalized.startsWith("../")){throw new Error(`Item type folder "${folder}" must stay inside the pm tracker root.`)}return normalized}function toSlugToken(value){const trimmed=value.trim().toLowerCase();let slug="";let pendingDash=false;for(const character of trimmed){const code=character.charCodeAt(0);const isAlpha=code>=97&&code<=122;const isDigit=code>=48&&code<=57;if(isAlpha||isDigit){if(pendingDash&&slug.length>0){slug+="-"}slug+=character;pendingDash=false;continue}if(slug.length>0){pendingDash=true}}return slug}function normalizeTypeDefinition(definition){return normalizeSharedItemTypeDefinition(definition,{resolvePolicyCommand:strictPolicyCommand})}function readStringArray(record,key){const value=record[key];return Array.isArray(value)?value.filter(entry=>typeof entry==="string"):void 0}function coerceOptionDefinitionFromUnknown(raw){if(typeof raw!=="object"||raw===null||Array.isArray(raw)){return null}const optionRecord=raw;if(typeof optionRecord.key!=="string"){return null}return{key:optionRecord.key,values:readStringArray(optionRecord,"values")??[],required:optionRecord.required===void 0?void 0:Boolean(optionRecord.required),aliases:readStringArray(optionRecord,"aliases"),description:typeof optionRecord.description==="string"?optionRecord.description:void 0}}function coerceCommandOptionPolicyFromUnknown(raw){if(typeof raw!=="object"||raw===null||Array.isArray(raw)){return null}const policyRecord=raw;if(typeof policyRecord.command!=="string"||typeof policyRecord.option!=="string"){return null}const normalizedCommand=policyRecord.command.trim().toLowerCase();if(normalizedCommand!=="create"&&normalizedCommand!=="update"){return null}return{command:normalizedCommand,option:policyRecord.option,required:policyRecord.required===void 0?void 0:Boolean(policyRecord.required),visible:policyRecord.visible===void 0?void 0:Boolean(policyRecord.visible),enabled:policyRecord.enabled===void 0?void 0:Boolean(policyRecord.enabled)}}function coerceOptionDefinitionsFromRecord(record){if(!Array.isArray(record.options)){return void 0}return record.options.map(entry=>coerceOptionDefinitionFromUnknown(entry)).filter(entry=>entry!==null)}function coerceCommandOptionPoliciesFromRecord(record){if(!Array.isArray(record.command_option_policies)){return void 0}return record.command_option_policies.map(entry=>coerceCommandOptionPolicyFromUnknown(entry)).filter(entry=>entry!==null)}function coerceTypeDefinitionFromUnknown(raw){if(typeof raw!=="object"||raw===null||Array.isArray(raw)){return null}const record=raw;const name=typeof record.name==="string"?record.name:"";if(name.trim().length===0){return null}const folder=typeof record.folder==="string"?record.folder:void 0;const description=typeof record.description==="string"?record.description:void 0;const defaultStatus=typeof record.default_status==="string"?record.default_status:void 0;return{name,description,default_status:defaultStatus,execution_role:parseItemExecutionRole(record.execution_role),folder,aliases:readStringArray(record,"aliases"),required_create_fields:readStringArray(record,"required_create_fields"),required_create_repeatables:readStringArray(record,"required_create_repeatables"),options:coerceOptionDefinitionsFromRecord(record),command_option_policies:coerceCommandOptionPoliciesFromRecord(record)}}function resolveDefinitionRequiredCreateFields(normalizedDefinition,existing){return normalizedDefinition.required_create_fields?normalizeItemTypeStringList(normalizedDefinition.required_create_fields):existing?.required_create_fields??[]}function resolveDefinitionRequiredCreateRepeatables(normalizedDefinition,existing){return normalizedDefinition.required_create_repeatables?normalizeItemTypeStringList(normalizedDefinition.required_create_repeatables):existing?.required_create_repeatables??[]}function resolveDefinitionOptions(normalizedDefinition,existing){return normalizedDefinition.options?normalizedDefinition.options:existing?.options?[...existing.options]:[]}function resolveDefinitionCommandOptionPolicies(normalizedDefinition,existing){return normalizedDefinition.command_option_policies?normalizedDefinition.command_option_policies:existing?.command_option_policies?[...existing.command_option_policies]:[]}function buildResolvedTypeDefinition(normalizedDefinition,existing){const keepName=existing?.name??normalizedDefinition.name;const description=normalizedDefinition.description??existing?.description;const defaultStatus=normalizedDefinition.default_status??existing?.default_status;const folder=normalizeItemTypeFolder(normalizedDefinition.folder??existing?.folder??toDefaultFolder(keepName));const resolvedDefinition={name:keepName,execution_role:normalizedDefinition.execution_role,folder,aliases:normalizeItemTypeStringList([...existing?.aliases??[],...normalizedDefinition.aliases??[]]),required_create_fields:resolveDefinitionRequiredCreateFields(normalizedDefinition,existing),required_create_repeatables:resolveDefinitionRequiredCreateRepeatables(normalizedDefinition,existing),options:resolveDefinitionOptions(normalizedDefinition,existing),command_option_policies:resolveDefinitionCommandOptionPolicies(normalizedDefinition,existing)};if(description){resolvedDefinition.description=description}if(defaultStatus){resolvedDefinition.default_status=defaultStatus}return resolvedDefinition}function applyTypeDefinitions(source,target){for(const rawDefinition of source){const normalizedDefinition=normalizeTypeDefinition(rawDefinition);if(!normalizedDefinition){continue}const lowerName=normalizedDefinition.name.toLowerCase();const existing=target.get(lowerName);target.set(lowerName,buildResolvedTypeDefinition({...normalizedDefinition,execution_role:normalizedDefinition.execution_role??existing?.execution_role},existing))}}function collectExtensionTypeDefinitions(registrations){if(!registrations){return[]}const definitions=[];for(const registration of registrations.item_types??[]){const typeDefinitionsRaw=registration.types;if(!Array.isArray(typeDefinitionsRaw)){continue}for(const rawDefinition of typeDefinitionsRaw){const normalized=coerceTypeDefinitionFromUnknown(rawDefinition);if(normalized){definitions.push(normalized)}}}return definitions}function resolveItemTypeRegistry(settings,extensionRegistrations=null){const byLowerName=new Map;for(const builtin of ITEM_TYPE_VALUES){byLowerName.set(builtin.toLowerCase(),{name:builtin,execution_role:BUILTIN_ITEM_EXECUTION_ROLES[builtin.toLowerCase()]??"agent",folder:TYPE_TO_FOLDER[builtin],aliases:[],required_create_fields:[...DEFAULT_REQUIRED_CREATE_FIELDS],required_create_repeatables:[...DEFAULT_REQUIRED_CREATE_REPEATABLES],options:[],command_option_policies:[]})}applyTypeDefinitions(settings.item_types?.definitions??[],byLowerName);applyTypeDefinitions(collectExtensionTypeDefinitions(extensionRegistrations),byLowerName);const definitions=[...byLowerName.values()].sort((left,right)=>left.name.localeCompare(right.name));const byType={};const aliasToType={};const typeToFolder={};for(const definition of definitions){byType[definition.name]=definition;typeToFolder[definition.name]=definition.folder;aliasToType[definition.name.toLowerCase()]=definition.name;for(const alias of definition.aliases){aliasToType[alias.toLowerCase()]=definition.name}}const folders=[...new Set(definitions.map(definition=>definition.folder))].sort((left,right)=>left.localeCompare(right));return{types:definitions.map(definition=>definition.name),folders,type_to_folder:typeToFolder,by_type:byType,alias_to_type:aliasToType}}function resolveTypeName(rawType,registry){if(rawType===void 0){return void 0}return registry.alias_to_type[rawType.trim().toLowerCase()]}function resolveTypeDefinition(typeName,registry){const resolvedName=resolveTypeName(typeName,registry);if(!resolvedName){return void 0}return registry.by_type[resolvedName]}function applyBaseRequiredCommandOptions(state,typeDefinition,command,baseRequiredOptions){for(const rawBase of baseRequiredOptions){const canonical=canonicalizeCommandOptionKey(command,rawBase);if(canonical){state.required.add(canonical);continue}state.errors.push(`Unsupported base required option "${rawBase}" for command "${command}" on type "${typeDefinition.name}"`)}}function applyBooleanPolicySet(target,option,enabled){if(enabled){target.add(option);return}target.delete(option)}function applyCommandOptionPolicy(state,typeDefinition,command,policy){const canonical=canonicalizeCommandOptionKey(command,policy.option);if(!canonical){state.errors.push(`Unsupported command_option_policies option "${policy.option}" for command "${command}" on type "${typeDefinition.name}"`);return}if(policy.required!==void 0){applyBooleanPolicySet(state.required,canonical,policy.required)}if(policy.visible!==void 0){applyBooleanPolicySet(state.hidden,canonical,!policy.visible)}if(policy.enabled!==void 0){applyBooleanPolicySet(state.disabled,canonical,!policy.enabled)}}function applyCommandOptionPolicies(state,typeDefinition,command){for(const policy of typeDefinition.command_option_policies){if(policy.command===command){applyCommandOptionPolicy(state,typeDefinition,command,policy)}}}function appendRequiredDisabledPolicyErrors(state,typeDefinition,command){for(const option of state.required){if(state.disabled.has(option)){state.errors.push(`Option "${option}" cannot be both required and disabled for command "${command}" on type "${typeDefinition.name}"`)}}}function resolveCommandOptionPolicyState(typeDefinition,command,baseRequiredOptions){const errors=[];const required=new Set;const hidden=new Set;const disabled=new Set;const state={required,hidden,disabled,errors};applyBaseRequiredCommandOptions(state,typeDefinition,command,baseRequiredOptions);applyCommandOptionPolicies(state,typeDefinition,command);appendRequiredDisabledPolicyErrors(state,typeDefinition,command);return{required:[...required],hidden:[...hidden].sort((left,right)=>left.localeCompare(right)),disabled:[...disabled].sort((left,right)=>left.localeCompare(right)),errors}}function buildTypeOptionAliasMap(typeDefinition){const optionByAlias=new Map;for(const option of typeDefinition.options){optionByAlias.set(option.key.toLowerCase(),option);for(const alias of option.aliases??[]){optionByAlias.set(alias.toLowerCase(),option)}}return optionByAlias}function resolveTypeOptionValue(optionDefinition,trimmedValue,errors){const allowedValues=optionDefinition.values;if(allowedValues.length===0){return trimmedValue}const valueLookup=new Map(allowedValues.map(value=>[value.toLowerCase(),value]));const canonical=valueLookup.get(trimmedValue.toLowerCase());if(!canonical){errors.push(`Invalid value "${trimmedValue}" for type option "${optionDefinition.key}". Allowed: ${allowedValues.join(", ")}`);return void 0}return canonical}function validateTypeOptions(typeName,rawTypeOptions,registry){const typeDefinition=resolveTypeDefinition(typeName,registry);if(!typeDefinition){return{normalized:void 0,errors:[`Unknown type "${typeName}"`]}}const errors=[];const optionByAlias=buildTypeOptionAliasMap(typeDefinition);const normalized={};for(const[rawKey,rawValue]of Object.entries(rawTypeOptions??{})){const trimmedKey=rawKey.trim();const trimmedValue=rawValue.trim();if(trimmedKey.length===0){errors.push("type option keys must not be empty");continue}if(trimmedValue.length===0){errors.push(`type option "${trimmedKey}" must not be empty`);continue}const optionDefinition=optionByAlias.get(trimmedKey.toLowerCase());if(!optionDefinition){const allowed=typeDefinition.options.map(option=>option.key).join(", ");errors.push(typeDefinition.options.length>0?`Unknown type option "${trimmedKey}" for type "${typeDefinition.name}". Allowed: ${allowed}`:`Type "${typeDefinition.name}" does not define any configurable type options`);continue}const resolvedValue=resolveTypeOptionValue(optionDefinition,trimmedValue,errors);if(resolvedValue===void 0){continue}normalized[optionDefinition.key]=resolvedValue}for(const option of typeDefinition.options){if(option.required&&!(option.key in normalized)){errors.push(`Missing required type option "${option.key}" for type "${typeDefinition.name}"`)}}const sortedKeys=Object.keys(normalized).sort((left,right)=>left.localeCompare(right));if(sortedKeys.length===0){return{normalized:void 0,errors}}return{normalized:Object.fromEntries(sortedKeys.map(key=>[key,normalized[key]])),errors}}export{BUILTIN_ITEM_EXECUTION_ROLES,COMMON_MUTATION_COMMAND_OPTION_KEYS,DEFAULT_REQUIRED_CREATE_FIELDS,DEFAULT_REQUIRED_CREATE_REPEATABLES,canonicalizeCommandOptionKey,commandOptionFlagLabel,normalizeItemTypeFolder,resolveCommandOptionPolicyState,resolveItemTypeRegistry,resolveTypeDefinition,resolveTypeName,toDefaultFolder,validateTypeOptions};
 //# sourceMappingURL=type-registry.js.map
-//# debugId=506efdc7-b04e-5023-ab59-57ede87558f9