@unbrained/pm-cli 2026.9.7 → 2026.9.8

package/dist/core/item/item-record.js

@@ -1,24 +1,2 @@
-/**
- * Bridge a typed item record into the generic `Record<string, unknown>` shape
- * consumed by formatters, field projections, history canonicalization, and
- * JSON output paths.
- *
- * `ItemMetadata` carries an index signature, but the structural mismatch on its
- * concretely-typed fields means TypeScript still requires a double cast to widen
- * it. Centralizing that `as unknown as Record<string, unknown>` widening here
- * gives the type bridge a single, named, documented home instead of scattering
- * the cast across command and core modules.
- *
- * This is a compile-time-only widening: the returned value is the very same
- * object reference, with no runtime transformation. (It is intentionally
- * distinct from the runtime `asRecord*` guards in `core/shared/primitives.ts`,
- * which validate `typeof` at runtime.) `ItemMetadata` is the canonical type,
- * so item-metadata values are accepted as-is.
- */
-
-!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]="4d71277c-e16c-56f4-a834-5200acfa6d7a")}catch(e){}}();
-export function toItemRecord(item) {
-    return item;
-}
+!(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]="82c79093-2a40-5b4c-8d41-637b0ae03c4f")}catch(e2){}})();function toItemRecord(item){return item}export{toItemRecord};
 //# sourceMappingURL=item-record.js.map
-//# debugId=4d71277c-e16c-56f4-a834-5200acfa6d7a

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

@@ -1,134 +1,2 @@
-/**
- * Shared, pure normalization for {@link ItemTypeDefinition} objects, single-sourced
- * across the runtime item-type registry and settings persistence (pm-v798).
- *
- * The only genuine difference between the two callers is how a command-option
- * policy's `command` field is resolved:
- *  - the runtime registry consumes untrusted extension/file definitions, so it
- *    must trim+lowercase and reject anything that is not "create"/"update";
- *  - settings persistence operates on already-validated definitions, so it keeps
- *    the typed `command` value verbatim.
- *
- * That single difference is injected via {@link NormalizeItemTypeDefinitionOptions.resolvePolicyCommand};
- * everything else (name trim, optional folder, aliases, required_create_* fields,
- * options normalization, policy dedupe key + stable sort) is shared.
- */
-/** Dedupe + sort a string list: trim, drop blanks, unique, locale-sorted. */
-
-!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]="f02cb2e7-2d5f-5cc8-8a60-18db78b50da0")}catch(e){}}();
-export function normalizeItemTypeStringList(values) {
-    return [
-        ...new Set((values ?? [])
-            .map((value) => value.trim())
-            .filter((value) => value.length > 0)),
-    ].sort((left, right) => left.localeCompare(right));
-}
-/** Normalize one type-option definition, or null when its key is blank. */
-export function normalizeItemTypeOption(option) {
-    const key = option.key.trim();
-    if (key.length === 0) {
-        return null;
-    }
-    const aliases = normalizeItemTypeStringList(option.aliases);
-    const description = option.description?.trim();
-    return {
-        key,
-        values: normalizeItemTypeStringList(option.values),
-        required: option.required === true ? true : undefined,
-        aliases: aliases.length > 0 ? aliases : undefined,
-        description: description && description.length > 0 ? description : undefined,
-    };
-}
-/** Pass-through resolver used by settings persistence: the value is already typed "create" | "update" by the settings validator, so it is kept verbatim. */
-export const keepPolicyCommand = (command) => command;
-/** Strict resolver used by the runtime registry: trims + lowercases and rejects anything other than "create"/"update". */
-export const strictPolicyCommand = (command) => {
-    const normalized = command.trim().toLowerCase();
-    return normalized === "create" || normalized === "update" ? normalized : null;
-};
-/** Normalize one command-option policy, or null when invalid (blank option / rejected command). */
-export function normalizeItemTypeCommandOptionPolicy(policy, resolvePolicyCommand) {
-    const command = resolvePolicyCommand(policy.command);
-    if (command === null) {
-        return null;
-    }
-    const option = policy.option.trim();
-    if (option.length === 0) {
-        return null;
-    }
-    return {
-        command,
-        option,
-        required: policy.required,
-        visible: policy.visible,
-        enabled: policy.enabled,
-    };
-}
-/** Dedupe by `${command}:${option-lowercased}` and stable-sort by command then option. */
-export function normalizeItemTypeCommandOptionPolicies(policies, resolvePolicyCommand) {
-    const dedupedByKey = new Map();
-    for (const policy of policies ?? []) {
-        const normalized = normalizeItemTypeCommandOptionPolicy(policy, resolvePolicyCommand);
-        if (!normalized) {
-            continue;
-        }
-        dedupedByKey.set(`${normalized.command}:${normalized.option.toLowerCase()}`, normalized);
-    }
-    return [...dedupedByKey.values()].sort((left, right) => left.command === right.command
-        ? left.option.localeCompare(right.option)
-        : left.command.localeCompare(right.command));
-}
-function normalizeOptionalStringList(values, preservePresence) {
-    return preservePresence ? normalizeItemTypeStringList(values) : undefined;
-}
-function optionalNonEmptyString(value) {
-    const normalized = value?.trim();
-    return normalized && normalized.length > 0 ? normalized : undefined;
-}
-/** Validate an execution role before a settings or extension definition enters scheduling. Unknown values fail instead of silently enabling dispatch. */
-export function parseItemExecutionRole(value) {
-    if (value === undefined || value === "agent" || value === "human" || value === "gate")
-        return value;
-    throw new Error("Item type execution_role must be agent, human, or gate.");
-}
-/**
- * Normalize a full {@link ItemTypeDefinition}, returning null when the name is blank.
- *
- * Optional collection fields (`folder`, `aliases`, `required_create_fields`,
- * `required_create_repeatables`, `options`, `command_option_policies`) are only
- * emitted when present on the input (presence-preserving) so the distinction
- * between "unset" and "set-but-empty" survives the round-trip.
- */
-export function normalizeItemTypeDefinition(definition, options = {}) {
-    const resolvePolicyCommand = options.resolvePolicyCommand ?? keepPolicyCommand;
-    const name = definition.name.trim();
-    if (name.length === 0) {
-        return null;
-    }
-    const hasRequiredCreateFields = definition.required_create_fields !== undefined;
-    const hasRequiredCreateRepeatables = definition.required_create_repeatables !== undefined;
-    const hasOptions = definition.options !== undefined;
-    const hasCommandOptionPolicies = definition.command_option_policies !== undefined;
-    const aliases = normalizeItemTypeStringList(definition.aliases);
-    const normalizedOptions = (definition.options ?? [])
-        .map((option) => normalizeItemTypeOption(option))
-        .filter((option) => option !== null)
-        .sort((left, right) => left.key.localeCompare(right.key));
-    const commandOptionPolicies = normalizeItemTypeCommandOptionPolicies(definition.command_option_policies, resolvePolicyCommand);
-    return {
-        name,
-        description: optionalNonEmptyString(definition.description),
-        default_status: optionalNonEmptyString(definition.default_status),
-        ...(definition.execution_role === undefined ? {} : { execution_role: parseItemExecutionRole(definition.execution_role) }),
-        folder: optionalNonEmptyString(definition.folder),
-        aliases: aliases.length > 0 ? aliases : undefined,
-        required_create_fields: normalizeOptionalStringList(definition.required_create_fields, hasRequiredCreateFields),
-        required_create_repeatables: normalizeOptionalStringList(definition.required_create_repeatables, hasRequiredCreateRepeatables),
-        options: hasOptions ? normalizedOptions : undefined,
-        command_option_policies: hasCommandOptionPolicies
-            ? commandOptionPolicies
-            : undefined,
-    };
-}
+!(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]="7647d826-e562-5f8e-86b2-2e40d8714b4d")}catch(e2){}})();function normalizeItemTypeStringList(values){return[...new Set((values??[]).map(value=>value.trim()).filter(value=>value.length>0))].sort((left,right)=>left.localeCompare(right))}function normalizeItemTypeOption(option){const key=option.key.trim();if(key.length===0){return null}const aliases=normalizeItemTypeStringList(option.aliases);const description=option.description?.trim();return{key,values:normalizeItemTypeStringList(option.values),required:option.required===true?true:void 0,aliases:aliases.length>0?aliases:void 0,description:description&&description.length>0?description:void 0}}const keepPolicyCommand=command=>command;const strictPolicyCommand=command=>{const normalized=command.trim().toLowerCase();return normalized==="create"||normalized==="update"?normalized:null};function normalizeItemTypeCommandOptionPolicy(policy,resolvePolicyCommand){const command=resolvePolicyCommand(policy.command);if(command===null){return null}const option=policy.option.trim();if(option.length===0){return null}return{command,option,required:policy.required,visible:policy.visible,enabled:policy.enabled}}function normalizeItemTypeCommandOptionPolicies(policies,resolvePolicyCommand){const dedupedByKey=new Map;for(const policy of policies??[]){const normalized=normalizeItemTypeCommandOptionPolicy(policy,resolvePolicyCommand);if(!normalized){continue}dedupedByKey.set(`${normalized.command}:${normalized.option.toLowerCase()}`,normalized)}return[...dedupedByKey.values()].sort((left,right)=>left.command===right.command?left.option.localeCompare(right.option):left.command.localeCompare(right.command))}function normalizeOptionalStringList(values,preservePresence){return preservePresence?normalizeItemTypeStringList(values):void 0}function optionalNonEmptyString(value){const normalized=value?.trim();return normalized&&normalized.length>0?normalized:void 0}function parseItemExecutionRole(value){if(value===void 0||value==="agent"||value==="human"||value==="gate")return value;throw new Error("Item type execution_role must be agent, human, or gate.")}function normalizeItemTypeDefinition(definition,options={}){const resolvePolicyCommand=options.resolvePolicyCommand??keepPolicyCommand;const name=definition.name.trim();if(name.length===0){return null}const hasRequiredCreateFields=definition.required_create_fields!==void 0;const hasRequiredCreateRepeatables=definition.required_create_repeatables!==void 0;const hasOptions=definition.options!==void 0;const hasCommandOptionPolicies=definition.command_option_policies!==void 0;const aliases=normalizeItemTypeStringList(definition.aliases);const normalizedOptions=(definition.options??[]).map(option=>normalizeItemTypeOption(option)).filter(option=>option!==null).sort((left,right)=>left.key.localeCompare(right.key));const commandOptionPolicies=normalizeItemTypeCommandOptionPolicies(definition.command_option_policies,resolvePolicyCommand);return{name,description:optionalNonEmptyString(definition.description),default_status:optionalNonEmptyString(definition.default_status),...definition.execution_role===void 0?{}:{execution_role:parseItemExecutionRole(definition.execution_role)},folder:optionalNonEmptyString(definition.folder),aliases:aliases.length>0?aliases:void 0,required_create_fields:normalizeOptionalStringList(definition.required_create_fields,hasRequiredCreateFields),required_create_repeatables:normalizeOptionalStringList(definition.required_create_repeatables,hasRequiredCreateRepeatables),options:hasOptions?normalizedOptions:void 0,command_option_policies:hasCommandOptionPolicies?commandOptionPolicies:void 0}}export{keepPolicyCommand,normalizeItemTypeCommandOptionPolicies,normalizeItemTypeCommandOptionPolicy,normalizeItemTypeDefinition,normalizeItemTypeOption,normalizeItemTypeStringList,parseItemExecutionRole,strictPolicyCommand};
 //# sourceMappingURL=item-type-definition.js.map
-//# debugId=f02cb2e7-2d5f-5cc8-8a60-18db78b50da0

package/dist/core/item/parent-reference-policy.js

@@ -1,58 +1,2 @@
-
-!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]="4a376062-2e23-5991-80a5-27183909caf3")}catch(e){}}();
-import { normalizeItemId } from "./id.js";
-import { EXIT_CODE } from "../shared/constants.js";
-import { PmCliError } from "../shared/errors.js";
-const PLACEHOLDER_REFERENCE_TOKENS = new Set(["none", "null", "undefined"]);
-/** Implements normalize parent reference policy for the public runtime surface of this module. */
-export function normalizeParentReferencePolicy(value) {
-    const normalized = value?.trim().toLowerCase().replaceAll("-", "_");
-    if (normalized === "warn" || normalized === "strict_error") {
-        return normalized;
-    }
-    if (normalized === "strict") {
-        return "strict_error";
-    }
-    throw new PmCliError("Config set parent-reference-policy requires --policy with one of: warn, strict_error (alias: strict)", EXIT_CODE.USAGE);
-}
-/** Implements normalize parent reference value for the public runtime surface of this module. */
-export function normalizeParentReferenceValue(rawValue) {
-    if (typeof rawValue !== "string") {
-        throw new PmCliError("--parent must be a string. Use --unset parent to clear this field.", EXIT_CODE.USAGE);
-    }
-    const value = rawValue.trim();
-    if (value.length === 0) {
-        throw new PmCliError("--parent must not be empty. Use --parent none to unset.", EXIT_CODE.USAGE);
-    }
-    if (isPlaceholderReferenceToken(value)) {
-        throw new PmCliError(`--parent must not use placeholder token "${value}". Use --unset parent to clear this field.`, EXIT_CODE.USAGE);
-    }
-    return value;
-}
-/** Detects parent-style placeholder tokens that should never become stored ids. */
-export function isPlaceholderReferenceToken(value) {
-    return PLACEHOLDER_REFERENCE_TOKENS.has(value.trim().toLowerCase());
-}
-/** Implements validate missing parent reference for the public runtime surface of this module. */
-export function validateMissingParentReference(parentId, policy) {
-    if (policy === "strict_error") {
-        throw new PmCliError(`Parent item "${parentId}" was not found. Create it first or use --parent none.`, EXIT_CODE.USAGE);
-    }
-    return {
-        warnings: [`validation_warning:parent_reference_missing:${parentId}`],
-    };
-}
-/** Rejects the one-node hierarchy cycle where an item points at itself. */
-export function assertParentReferenceIsNotSelf(itemId, parentId, prefix) {
-    const normalizedItemId = normalizeItemId(itemId, prefix);
-    const normalizedParentId = normalizeItemId(parentId, prefix);
-    if (normalizedItemId !== normalizedParentId) {
-        return;
-    }
-    const normalizationDetail = parentId !== normalizedParentId || itemId !== normalizedItemId
-        ? ` (normalized from parent "${parentId}" and item "${itemId}")`
-        : "";
-    throw new PmCliError(`Parent item "${normalizedParentId}" cannot be the same as item "${normalizedItemId}"${normalizationDetail}. Use --unset parent to clear this field.`, EXIT_CODE.USAGE);
-}
+!(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]="91874535-458b-5a33-a68a-96f44bd2e1f8")}catch(e2){}})();import{normalizeItemId}from"./id.js";import{EXIT_CODE}from"../shared/constants.js";import{PmCliError}from"../shared/errors.js";const PLACEHOLDER_REFERENCE_TOKENS=new Set(["none","null","undefined"]);function normalizeParentReferencePolicy(value){const normalized=value?.trim().toLowerCase().replaceAll("-","_");if(normalized==="warn"||normalized==="strict_error"){return normalized}if(normalized==="strict"){return"strict_error"}throw new PmCliError("Config set parent-reference-policy requires --policy with one of: warn, strict_error (alias: strict)",EXIT_CODE.USAGE)}function normalizeParentReferenceValue(rawValue){if(typeof rawValue!=="string"){throw new PmCliError("--parent must be a string. Use --unset parent to clear this field.",EXIT_CODE.USAGE)}const value=rawValue.trim();if(value.length===0){throw new PmCliError("--parent must not be empty. Use --parent none to unset.",EXIT_CODE.USAGE)}if(isPlaceholderReferenceToken(value)){throw new PmCliError(`--parent must not use placeholder token "${value}". Use --unset parent to clear this field.`,EXIT_CODE.USAGE)}return value}function isPlaceholderReferenceToken(value){return PLACEHOLDER_REFERENCE_TOKENS.has(value.trim().toLowerCase())}function validateMissingParentReference(parentId,policy){if(policy==="strict_error"){throw new PmCliError(`Parent item "${parentId}" was not found. Create it first or use --parent none.`,EXIT_CODE.USAGE)}return{warnings:[`validation_warning:parent_reference_missing:${parentId}`]}}function assertParentReferenceIsNotSelf(itemId,parentId,prefix){const normalizedItemId=normalizeItemId(itemId,prefix);const normalizedParentId=normalizeItemId(parentId,prefix);if(normalizedItemId!==normalizedParentId){return}const normalizationDetail=parentId!==normalizedParentId||itemId!==normalizedItemId?` (normalized from parent "${parentId}" and item "${itemId}")`:"";throw new PmCliError(`Parent item "${normalizedParentId}" cannot be the same as item "${normalizedItemId}"${normalizationDetail}. Use --unset parent to clear this field.`,EXIT_CODE.USAGE)}export{assertParentReferenceIsNotSelf,isPlaceholderReferenceToken,normalizeParentReferencePolicy,normalizeParentReferenceValue,validateMissingParentReference};
 //# sourceMappingURL=parent-reference-policy.js.map
-//# debugId=4a376062-2e23-5991-80a5-27183909caf3