@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/sdk/runtime-input.js

@@ -1,615 +1,2 @@
-/**
- * @module sdk/runtime-input
- *
- * Normalizes untyped action payload values at the SDK runtime boundary. These
- * primitives are shared by native action dispatchers and MCP-specific adapters.
- */
-
-!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]="d42d5fb1-eebc-5549-ae88-dc923d9d3696")}catch(e){}}();
-import { EXIT_CODE } from "../core/shared/constants.js";
-import { PmCliError } from "../core/shared/errors.js";
-import { asRecordClone } from "../core/shared/primitives.js";
-import { normalizeListOptions, normalizeUpdateOptions, } from "./cli-contracts/registration-helpers.js";
-import { UPDATE_COMMANDER_STRING_OPTION_CONTRACTS } from "./cli-contracts/commander-mutation-options.js";
-import { normalizeBulkIdsValue, } from "../core/io/bulk-ids-input.js";
-import { overlayMutationStdinTokenPolicy, preserveMutationStdinTokenLiterals, transferMutationStdinTokenPolicy, } from "../core/item/parse.js";
-const MCP_MUTATION_TRANSPORT = Symbol("pm.mcp-mutation-transport");
-const WORKSPACE_CONTRACTS_CACHE_PRESERVING_ACTIONS = new Set([
-    "activity",
-    "aggregate",
-    "context",
-    "contracts",
-    "deps",
-    "files-discover",
-    "files-lookup",
-    "get",
-    "graph",
-    "health",
-    "history",
-    "list",
-    "next",
-    "search",
-    "stats",
-    "telemetry",
-    "validate",
-]);
-/** Mark an action object decoded from the MCP JSON-RPC transport. */
-export function markMcpMutationTransportInput(input) {
-    Object.defineProperty(input, MCP_MUTATION_TRANSPORT, {
-        value: true,
-        enumerable: true,
-    });
-    return input;
-}
-function isMcpMutationTransportInput(input) {
-    return MCP_MUTATION_TRANSPORT in input;
-}
-function preserveTransportLiteralOptions(source, options) {
-    return isMcpMutationTransportInput(source)
-        ? preserveMutationStdinTokenLiterals(options)
-        : transferMutationStdinTokenPolicy(source, options);
-}
-/** Clone mutation options with overrides while retaining stdin provenance. */
-export function mutationOptionsWithOverrides(source, overrides, omittedKeys = []) {
-    const options = transferMutationStdinTokenPolicy(source, {
-        ...source,
-        ...overrides,
-    });
-    for (const key of omittedKeys)
-        Reflect.deleteProperty(options, key);
-    return options;
-}
-/** Read a non-empty string without altering its caller-provided whitespace. */
-export function readRuntimeString(args, key) {
-    const value = args[key];
-    return typeof value === "string" && value.trim().length > 0
-        ? value
-        : undefined;
-}
-/** Normalize a non-empty string or finite number into a scalar string. */
-export function readRuntimeScalarString(args, key) {
-    const value = args[key];
-    if (typeof value === "string") {
-        return value.trim().length > 0 ? value : undefined;
-    }
-    return typeof value === "number" && Number.isFinite(value)
-        ? String(value)
-        : undefined;
-}
-/** Normalize a string, including blank text, or a finite number into text. */
-export function readRuntimeScalarStringAllowBlank(args, key) {
-    const value = args[key];
-    if (typeof value === "string") {
-        return value;
-    }
-    return typeof value === "number" && Number.isFinite(value)
-        ? String(value)
-        : undefined;
-}
-/** Narrow unknown values to plain record-shaped action payloads. */
-export function isRuntimeRecord(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-/** Parse an integer-valued MCP option while retaining a caller-specific label. */
-export function parseRuntimeInteger(value, label) {
-    if (typeof value === "number") {
-        if (!Number.isInteger(value)) {
-            throw new PmCliError(`${label} must be a finite integer.`, EXIT_CODE.USAGE);
-        }
-        return value;
-    }
-    if (typeof value === "string" && value.trim().length > 0) {
-        const parsed = Number(value);
-        if (!Number.isInteger(parsed)) {
-            throw new PmCliError(`${label} must be a finite integer.`, EXIT_CODE.USAGE);
-        }
-        return parsed;
-    }
-    return undefined;
-}
-/** Resolve a numeric-or-string limit from top-level and nested action inputs. */
-export function resolveRuntimeLimit(args, options) {
-    if (typeof args.limit === "number" && Number.isFinite(args.limit)) {
-        return args.limit;
-    }
-    if (typeof options.limit === "number" && Number.isFinite(options.limit)) {
-        return options.limit;
-    }
-    return (readRuntimeString(args, "limit") ?? readRuntimeString(options, "limit"));
-}
-/** Fixed SDK-runtime global options derived from one untyped action payload. */
-export function actionGlobalOptions(args) {
-    const outputFormat = readRuntimeString(args, "outputFormat");
-    return {
-        json: true,
-        quiet: true,
-        author: readRuntimeString(args, "author"),
-        path: readRuntimeString(args, "path"),
-        noExtensions: args.noExtensions === true || args.no_extensions === true,
-        noPager: true,
-        outputInclude: readRuntimeString(args, "outputInclude"),
-        outputLimit: readRuntimeScalarString(args, "outputLimit"),
-        outputBudget: readRuntimeScalarString(args, "outputBudget"),
-        outputSession: readRuntimeString(args, "outputSession"),
-        outputCursor: readRuntimeString(args, "outputCursor"),
-        outputFormat: outputFormat === "json" || outputFormat === "toon"
-            ? outputFormat
-            : undefined,
-    };
-}
-/** Fields whose MCP array values collapse into the CLI's CSV spelling. */
-const ARRAY_TO_CSV_FIELDS = new Set([
-    "tags",
-    "blockedBy",
-    "blocked_by",
-    "skills",
-    "fields",
-]);
-/** Fields whose scalar MCP values promote into the CLI's repeatable arrays. */
-const SCALAR_TO_ARRAY_FIELDS = new Set([
-    "comment",
-    "note",
-    "learning",
-    "reminder",
-    "event",
-    "dep",
-    "depRemove",
-    "dep_remove",
-    "file",
-    "doc",
-    "test",
-    "unset",
-    "addGlob",
-    "add_glob",
-    "migrate",
-    "envSet",
-    "env_set",
-    "envClear",
-    "env_clear",
-]);
-const ANNOTATION_SCALAR_TO_ARRAY_FIELDS = new Set([...SCALAR_TO_ARRAY_FIELDS].filter((field) => field !== "file"));
-// Actions where the linked-resource fields `add` and `remove` are string[] arrays.
-// For other actions (comments/notes/learnings) `add` and `remove` are scalar strings
-// and must NOT be auto-promoted.
-const ARRAY_ADD_REMOVE_ACTIONS = new Set([
-    "files",
-    "files-discover",
-    "docs",
-    "test",
-    "test-all",
-]);
-const SCALAR_ANNOTATION_SOURCE_ACTIONS = new Set([
-    "comments",
-    "notes",
-    "learnings",
-]);
-function assertMcpAnnotationFileUnavailable(action, options) {
-    if (!SCALAR_ANNOTATION_SOURCE_ACTIONS.has(action) ||
-        !Object.prototype.hasOwnProperty.call(options, "file")) {
-        return;
-    }
-    throw new PmCliError(`MCP ${action} does not accept options.file. Pass annotation text in options.add instead.`, EXIT_CODE.USAGE, {
-        code: "mcp_annotation_file_unavailable",
-        required: "Pass annotation text as JSON data; MCP annotation actions cannot read server-local files.",
-    });
-}
-/** Lifecycle actions where a top-level assignee argument aliases the author. */
-const LIFECYCLE_AUTHOR_ALIAS_ACTIONS = new Set([
-    "claim",
-    "release",
-    "start-task",
-    "pause-task",
-    "close-task",
-]);
-const HOISTED_ACTION_OPTION_KEYS = {
-    list: ["status", "type", "tag", "priority", "limit", "offset"],
-    search: ["mode", "status", "type", "tag", "priority", "limit"],
-    create: [
-        "title",
-        "type",
-        "status",
-        "description",
-        "body",
-        "priority",
-        "tags",
-        "parent",
-        "createMode",
-        "create_mode",
-        "allowMissingParent",
-        "allowDuplicate",
-    ],
-    update: ["parent", "allowMissingParent", "completedAt"],
-    copy: ["allowDuplicate"],
-    close: ["duplicateOf", "completedAt"],
-    comments: ["ifAbsent"],
-    notes: ["ifAbsent"],
-    learnings: ["ifAbsent"],
-    upgrade: [
-        "scope",
-        "dryRun",
-        "cliOnly",
-        "packagesOnly",
-        "repair",
-        "tag",
-        "packageName",
-    ],
-    // pm-7u9j: the narrow pm_append tool declares `body` top-level; runAppend
-    // reads it from options, while schema/config consume their top-level values
-    // directly in runAction and therefore need no hoisting.
-    append: ["body"],
-};
-const UNIVERSAL_READ_OUTPUT_OPTION_KEYS = [
-    "outputInclude",
-    "outputLimit",
-    "outputBudget",
-    "outputFormat",
-    "outputSession",
-    "outputCursor",
-];
-/** Reconcile MCP array/scalar option spellings with CLI flag expectations. */
-export function normalizeMcpOptionsArrays(options, action = "") {
-    const result = {};
-    const promoteAddRemove = ARRAY_ADD_REMOVE_ACTIONS.has(action);
-    const preserveStandaloneNote = action === "files" || action === "files-discover" || action === "docs";
-    const scalarToArrayFields = SCALAR_ANNOTATION_SOURCE_ACTIONS.has(action)
-        ? ANNOTATION_SCALAR_TO_ARRAY_FIELDS
-        : SCALAR_TO_ARRAY_FIELDS;
-    for (const [key, value] of Object.entries(options)) {
-        if (Array.isArray(value) && ARRAY_TO_CSV_FIELDS.has(key)) {
-            result[key] = value.join(",");
-            continue;
-        }
-        if (key === "note" && preserveStandaloneNote) {
-            result[key] = value;
-            continue;
-        }
-        if (typeof value === "string" && scalarToArrayFields.has(key)) {
-            result[key] = [value];
-            continue;
-        }
-        if (typeof value === "string" &&
-            promoteAddRemove &&
-            (key === "add" || key === "remove")) {
-            result[key] = [value];
-            continue;
-        }
-        result[key] = value;
-    }
-    return result;
-}
-/** Resolve the explicit or lifecycle-assignee author accepted by MCP actions. */
-function resolveMcpActionAuthor(args, options, action) {
-    const author = readRuntimeString(args, "author");
-    if (author !== undefined) {
-        return author;
-    }
-    return action !== undefined && LIFECYCLE_AUTHOR_ALIAS_ACTIONS.has(action)
-        ? (readRuntimeString(args, "assignee") ??
-            readRuntimeString(options, "assignee"))
-        : undefined;
-}
-/** Add a resolved author only when the normalized options do not provide one. */
-function withResolvedAuthor(options, author) {
-    return author !== undefined && options.author === undefined
-        ? { ...options, author }
-        : options;
-}
-/** Merge hoisted top-level action arguments and author aliases into options. */
-export function optionsWithAuthor(args, action) {
-    const sourceOptions = isRuntimeRecord(args.options)
-        ? args.options
-        : undefined;
-    const baseOptions = asRecordClone(args.options);
-    const hoistedTopLevel = {};
-    const hoistKey = (key) => {
-        if (baseOptions[key] !== undefined || args[key] === undefined) {
-            return;
-        }
-        hoistedTopLevel[key] = args[key];
-    };
-    for (const key of HOISTED_ACTION_OPTION_KEYS[action ?? ""] ?? []) {
-        hoistKey(key);
-    }
-    for (const key of UNIVERSAL_READ_OUTPUT_OPTION_KEYS) {
-        hoistKey(key);
-    }
-    if (action !== undefined && isMcpMutationTransportInput(args)) {
-        assertMcpAnnotationFileUnavailable(action, baseOptions);
-    }
-    const options = normalizeMcpOptionsArrays({ ...hoistedTopLevel, ...baseOptions }, action);
-    const stdinPolicySource = isMcpMutationTransportInput(args)
-        ? args
-        : (sourceOptions ?? args);
-    return preserveTransportLiteralOptions(stdinPolicySource, withResolvedAuthor(options, resolveMcpActionAuthor(args, options, action)));
-}
-// GH-170 (pm-pfnx): the narrow pm_files/pm_docs tools spell the CLI --note flag
-// as `addNote` (the shared `note` parameter is the array-typed create/update
-// note seed). Translate it onto the runner's `note` option; an explicit
-// options.note (pm_run callers) wins.
-/** Translate the MCP-only addNote spelling onto the runner note option. */
-export function withAddNoteOption(options) {
-    if (options.addNote === undefined) {
-        return options;
-    }
-    const next = { ...options };
-    if (next.note === undefined && typeof next.addNote === "string") {
-        next.note = next.addNote;
-    }
-    delete next.addNote;
-    return next;
-}
-/** Map files-discover MCP controls onto the files runner's option shape. */
-export function withFilesDiscoveryOptions(options) {
-    const next = { ...options };
-    if (next.discoveryNote !== undefined &&
-        next.note === undefined &&
-        typeof next.discoveryNote === "string") {
-        next.note = next.discoveryNote;
-    }
-    delete next.discover;
-    delete next.discoveryNote;
-    return next;
-}
-/** Canonicalize one action name into lower-kebab-case tokens. */
-export function normalizeActionName(value) {
-    const chunks = [];
-    let lastWasSeparator = true;
-    for (const character of value.trim().toLowerCase()) {
-        const isAlphaNumeric = (character >= "a" && character <= "z") ||
-            (character >= "0" && character <= "9");
-        if (isAlphaNumeric) {
-            chunks.push(character);
-            lastWasSeparator = false;
-            continue;
-        }
-        if (!lastWasSeparator) {
-            chunks.push("-");
-            lastWasSeparator = true;
-        }
-    }
-    if (chunks.at(-1) === "-") {
-        chunks.pop();
-    }
-    return chunks.join("");
-}
-/** Return whether an action can change workspace extension contracts. */
-export function shouldInvalidateWorkspaceContractsCacheAfterAction(action) {
-    return !WORKSPACE_CONTRACTS_CACHE_PRESERVING_ACTIONS.has(normalizeActionName(action));
-}
-/** Canonicalize one space-separated command path for lookup comparisons. */
-export function normalizeCommandPath(value) {
-    return value.trim().toLowerCase().split(/\s+/).filter(Boolean).join(" ");
-}
-/** Coerce an unknown payload value into a non-empty string array. */
-export function readRuntimeStringArray(value) {
-    if (!Array.isArray(value)) {
-        return [];
-    }
-    return value
-        .map((entry) => String(entry))
-        .filter((entry) => entry.length > 0);
-}
-/** Merge non-reserved top-level extension arguments into the options record. */
-export function extensionOptionsFromArgs(args, options) {
-    const reserved = new Set([
-        "action",
-        "args",
-        "author",
-        "cwd",
-        "fullChangedFields",
-        "id",
-        "options",
-        "path",
-        "query",
-        "reason",
-        "target",
-    ]);
-    const passthrough = {};
-    for (const [key, value] of Object.entries(args)) {
-        if (!reserved.has(key)) {
-            passthrough[key] = value;
-        }
-    }
-    const normalizedOptions = { ...passthrough, ...options };
-    delete normalizedOptions.args;
-    return normalizedOptions;
-}
-/** Mutation tools (create/update/close/append/update-many) return a verbose `changed_fields` array. On the agent path we drop it to a `changed_field_count` by default for token efficiency, restoring the full array only when the caller explicitly passes the MCP-level fullChangedFields=true control. Mutation options are forwarded unchanged so runtime fields named `full` remain valid user data. */
-export function withMutationCompaction(args, options) {
-    const runnerOptions = preserveTransportLiteralOptions(options ?? {}, {
-        ...options,
-    });
-    return {
-        changedFields: args.fullChangedFields === true ? "full" : "compact",
-        idOnly: args.idOnly === true,
-        runnerOptions,
-    };
-}
-/** Translate flat MCP filter parameters into the shared list-option shape. */
-export function mutationListOptions(options) {
-    return {
-        type: readRuntimeScalarString(options, "filterType"),
-        tag: readRuntimeScalarString(options, "filterTag"),
-        priority: readRuntimeScalarString(options, "filterPriority"),
-        deadlineBefore: readRuntimeScalarString(options, "filterDeadlineBefore"),
-        deadlineAfter: readRuntimeScalarString(options, "filterDeadlineAfter"),
-        updatedAfter: readRuntimeScalarString(options, "filterUpdatedAfter"),
-        updatedBefore: readRuntimeScalarString(options, "filterUpdatedBefore"),
-        createdAfter: readRuntimeScalarString(options, "filterCreatedAfter"),
-        createdBefore: readRuntimeScalarString(options, "filterCreatedBefore"),
-        ids: normalizeBulkIdsValue(options.ids),
-        assignee: readRuntimeScalarString(options, "filterAssignee"),
-        assigneeFilter: readRuntimeScalarString(options, "filterAssigneeFilter") ??
-            readRuntimeScalarString(options, "filterAssignee_filter"),
-        parent: readRuntimeScalarString(options, "filterParent"),
-        sprint: readRuntimeScalarString(options, "filterSprint"),
-        release: readRuntimeScalarString(options, "filterRelease"),
-        limit: readRuntimeScalarString(options, "limit"),
-        offset: readRuntimeScalarString(options, "offset"),
-    };
-}
-/** Read one graph option that accepts scalar strings or repeatable arrays. */
-function readGraphIdListOption(value) {
-    if (typeof value === "string" && value.trim().length > 0)
-        return value;
-    if (Array.isArray(value))
-        return readRuntimeStringArray(value);
-    return undefined;
-}
-/** Read one graph bound that accepts integer numbers or numeric strings. */
-function readGraphBoundOption(value) {
-    if (typeof value === "number" && Number.isFinite(value))
-        return value;
-    if (typeof value === "string" && value.trim().length > 0)
-        return value;
-    return undefined;
-}
-/** Build graph command options from one flat MCP parameter payload. */
-export function graphOptionsFromFlat(options) {
-    const kind = readGraphIdListOption(options.kind);
-    const exemptIsolate = readGraphIdListOption(options.exemptIsolate);
-    const exemptIsolateType = readGraphIdListOption(options.exemptIsolateType);
-    return {
-        ...(kind === undefined ? {} : { kind }),
-        maxDepth: readGraphBoundOption(options.maxDepth),
-        limit: readGraphBoundOption(options.limit),
-        after: readRuntimeString(options, "after"),
-        direction: readRuntimeString(options, "direction"),
-        maxPaths: readGraphBoundOption(options.maxPaths),
-        sample: readGraphBoundOption(options.sample),
-        ...(exemptIsolate === undefined ? {} : { exemptIsolate }),
-        ...(exemptIsolateType === undefined ? {} : { exemptIsolateType }),
-        saveBaseline: options.saveBaseline === true,
-        rebuild: options.rebuild === true,
-        clear: options.clear === true,
-        summary: options.summary === true,
-        ...(options.full === true ? { full: true } : {}),
-    };
-}
-function normalizeBulkMutationListOptions(options) {
-    const normalized = normalizeListOptions(options);
-    if (options.ids !== undefined) {
-        normalized.ids = normalizeBulkIdsValue(options.ids);
-    }
-    return normalized;
-}
-/** Build close-many command options from one flat MCP parameter payload. */
-export function closeManyOptionsFromFlat(options) {
-    return {
-        status: readRuntimeString(options, "filterStatus"),
-        list: isRuntimeRecord(options.list)
-            ? normalizeBulkMutationListOptions(options.list)
-            : mutationListOptions(options),
-        reason: readRuntimeString(options, "reason"),
-        resolution: readRuntimeString(options, "resolution"),
-        expectedResult: readRuntimeString(options, "expectedResult") ??
-            readRuntimeString(options, "expected_result") ??
-            readRuntimeString(options, "expected"),
-        actualResult: readRuntimeString(options, "actualResult") ??
-            readRuntimeString(options, "actual_result") ??
-            readRuntimeString(options, "actual"),
-        validateClose: readRuntimeString(options, "validateClose") ??
-            readRuntimeString(options, "validate_close"),
-        author: readRuntimeString(options, "author"),
-        message: readRuntimeString(options, "message"),
-        force: options.force === true ? true : undefined,
-        dryRun: options.dryRun === true || options.dry_run === true ? true : undefined,
-        rollback: readRuntimeString(options, "rollback"),
-        checkpoint: options.checkpoint === false ||
-            options.noCheckpoint === true ||
-            options.no_checkpoint === true
-            ? false
-            : undefined,
-    };
-}
-/** Flat update-many parameters that steer batching instead of item fields. */
-const UPDATE_MANY_FLAT_CONTROL_KEYS = new Set([
-    "filterStatus",
-    "filterType",
-    "filterTag",
-    "filterPriority",
-    "filterDeadlineBefore",
-    "filterDeadlineAfter",
-    "filterUpdatedAfter",
-    "filterUpdatedBefore",
-    "filterCreatedAfter",
-    "filterCreatedBefore",
-    "filterAssignee",
-    "filterAssigneeFilter",
-    "filterAssignee_filter",
-    "filterParent",
-    "filterSprint",
-    "filterRelease",
-    "ids",
-    "list",
-    "update",
-    "limit",
-    "offset",
-    "dryRun",
-    "dry_run",
-    "rollback",
-    "checkpoint",
-    "noCheckpoint",
-    "no_checkpoint",
-]);
-/** Extract per-item update fields from one flat update-many payload. */
-export function updateManyUpdateOptionsFromFlat(options) {
-    const update = {};
-    for (const [key, value] of Object.entries(options)) {
-        if (UPDATE_MANY_FLAT_CONTROL_KEYS.has(key)) {
-            continue;
-        }
-        update[key] = value;
-    }
-    return normalizeMcpUpdateOptions(update);
-}
-/** Normalize MCP update fields onto the CLI update option contract. */
-export function normalizeMcpUpdateOptions(options) {
-    const normalizedInput = normalizeMcpOptionsArrays(options, "update-many");
-    for (const contract of UPDATE_COMMANDER_STRING_OPTION_CONTRACTS) {
-        for (const key of contract.keys) {
-            const value = normalizedInput[key];
-            if (typeof value === "number" && Number.isFinite(value)) {
-                normalizedInput[key] = String(value);
-            }
-        }
-    }
-    return normalizeUpdateOptions(normalizedInput);
-}
-/** Build update-many command options from one flat MCP parameter payload. */
-export function updateManyOptionsFromFlat(options) {
-    if (isRuntimeRecord(options.list) || isRuntimeRecord(options.update)) {
-        const updateSource = isRuntimeRecord(options.update)
-            ? options.update
-            : updateManyUpdateOptionsFromFlat(options);
-        const normalizedUpdate = preserveTransportLiteralOptions(options, normalizeMcpUpdateOptions(updateSource));
-        return {
-            status: readRuntimeScalarString(options, "filterStatus"),
-            list: isRuntimeRecord(options.list)
-                ? normalizeBulkMutationListOptions(options.list)
-                : mutationListOptions(options),
-            update: overlayMutationStdinTokenPolicy(updateSource, normalizedUpdate),
-            dryRun: options.dryRun === true || options.dry_run === true ? true : undefined,
-            rollback: readRuntimeString(options, "rollback"),
-            checkpoint: options.checkpoint === false ||
-                options.noCheckpoint === true ||
-                options.no_checkpoint === true
-                ? false
-                : undefined,
-        };
-    }
-    return {
-        status: readRuntimeScalarString(options, "filterStatus"),
-        list: mutationListOptions(options),
-        update: preserveTransportLiteralOptions(options, updateManyUpdateOptionsFromFlat(options)),
-        dryRun: options.dryRun === true || options.dry_run === true ? true : undefined,
-        rollback: readRuntimeString(options, "rollback"),
-        checkpoint: options.checkpoint === false ||
-            options.noCheckpoint === true ||
-            options.no_checkpoint === true
-            ? false
-            : 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]="6264e2f2-1b58-513b-b32d-54a89919de5d")}catch(e2){}})();import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{asRecordClone}from"../core/shared/primitives.js";import{normalizeListOptions,normalizeUpdateOptions}from"./cli-contracts/registration-helpers.js";import{UPDATE_COMMANDER_STRING_OPTION_CONTRACTS}from"./cli-contracts/commander-mutation-options.js";import{normalizeBulkIdsValue}from"../core/io/bulk-ids-input.js";import{overlayMutationStdinTokenPolicy,preserveMutationStdinTokenLiterals,transferMutationStdinTokenPolicy}from"../core/item/parse.js";const MCP_MUTATION_TRANSPORT=Symbol("pm.mcp-mutation-transport");const WORKSPACE_CONTRACTS_CACHE_PRESERVING_ACTIONS=new Set(["activity","aggregate","context","contracts","deps","files-discover","files-lookup","get","graph","health","history","list","next","search","stats","telemetry","validate"]);function markMcpMutationTransportInput(input){Object.defineProperty(input,MCP_MUTATION_TRANSPORT,{value:true,enumerable:true});return input}function isMcpMutationTransportInput(input){return MCP_MUTATION_TRANSPORT in input}function preserveTransportLiteralOptions(source,options){return isMcpMutationTransportInput(source)?preserveMutationStdinTokenLiterals(options):transferMutationStdinTokenPolicy(source,options)}function mutationOptionsWithOverrides(source,overrides,omittedKeys=[]){const options=transferMutationStdinTokenPolicy(source,{...source,...overrides});for(const key of omittedKeys)Reflect.deleteProperty(options,key);return options}function readRuntimeString(args,key){const value=args[key];return typeof value==="string"&&value.trim().length>0?value:void 0}function readRuntimeScalarString(args,key){const value=args[key];if(typeof value==="string"){return value.trim().length>0?value:void 0}return typeof value==="number"&&Number.isFinite(value)?String(value):void 0}function readRuntimeScalarStringAllowBlank(args,key){const value=args[key];if(typeof value==="string"){return value}return typeof value==="number"&&Number.isFinite(value)?String(value):void 0}function isRuntimeRecord(value){return value!==null&&typeof value==="object"&&!Array.isArray(value)}function parseRuntimeInteger(value,label){if(typeof value==="number"){if(!Number.isInteger(value)){throw new PmCliError(`${label} must be a finite integer.`,EXIT_CODE.USAGE)}return value}if(typeof value==="string"&&value.trim().length>0){const parsed=Number(value);if(!Number.isInteger(parsed)){throw new PmCliError(`${label} must be a finite integer.`,EXIT_CODE.USAGE)}return parsed}return void 0}function resolveRuntimeLimit(args,options){if(typeof args.limit==="number"&&Number.isFinite(args.limit)){return args.limit}if(typeof options.limit==="number"&&Number.isFinite(options.limit)){return options.limit}return readRuntimeString(args,"limit")??readRuntimeString(options,"limit")}function actionGlobalOptions(args){const outputFormat=readRuntimeString(args,"outputFormat");return{json:true,quiet:true,author:readRuntimeString(args,"author"),path:readRuntimeString(args,"path"),noExtensions:args.noExtensions===true||args.no_extensions===true,noPager:true,outputInclude:readRuntimeString(args,"outputInclude"),outputLimit:readRuntimeScalarString(args,"outputLimit"),outputBudget:readRuntimeScalarString(args,"outputBudget"),outputSession:readRuntimeString(args,"outputSession"),outputCursor:readRuntimeString(args,"outputCursor"),outputFormat:outputFormat==="json"||outputFormat==="toon"?outputFormat:void 0}}const ARRAY_TO_CSV_FIELDS=new Set(["tags","blockedBy","blocked_by","skills","fields"]);const SCALAR_TO_ARRAY_FIELDS=new Set(["comment","note","learning","reminder","event","dep","depRemove","dep_remove","file","doc","test","unset","addGlob","add_glob","migrate","envSet","env_set","envClear","env_clear"]);const ANNOTATION_SCALAR_TO_ARRAY_FIELDS=new Set([...SCALAR_TO_ARRAY_FIELDS].filter(field=>field!=="file"));const ARRAY_ADD_REMOVE_ACTIONS=new Set(["files","files-discover","docs","test","test-all"]);const SCALAR_ANNOTATION_SOURCE_ACTIONS=new Set(["comments","notes","learnings"]);function assertMcpAnnotationFileUnavailable(action,options){if(!SCALAR_ANNOTATION_SOURCE_ACTIONS.has(action)||!Object.prototype.hasOwnProperty.call(options,"file")){return}throw new PmCliError(`MCP ${action} does not accept options.file. Pass annotation text in options.add instead.`,EXIT_CODE.USAGE,{code:"mcp_annotation_file_unavailable",required:"Pass annotation text as JSON data; MCP annotation actions cannot read server-local files."})}const LIFECYCLE_AUTHOR_ALIAS_ACTIONS=new Set(["claim","release","start-task","pause-task","close-task"]);const HOISTED_ACTION_OPTION_KEYS={list:["status","type","tag","priority","limit","offset"],search:["mode","status","type","tag","priority","limit"],create:["title","type","status","description","body","priority","tags","parent","createMode","create_mode","allowMissingParent","allowDuplicate"],update:["parent","allowMissingParent","completedAt"],copy:["allowDuplicate"],close:["duplicateOf","completedAt"],comments:["ifAbsent"],notes:["ifAbsent"],learnings:["ifAbsent"],extension:["dryRun"],package:["dryRun"],install:["dryRun"],upgrade:["scope","dryRun","cliOnly","packagesOnly","repair","tag","packageName"],append:["body"]};const UNIVERSAL_READ_OUTPUT_OPTION_KEYS=["outputInclude","outputLimit","outputBudget","outputFormat","outputSession","outputCursor"];function normalizeMcpOptionsArrays(options,action=""){const result={};const promoteAddRemove=ARRAY_ADD_REMOVE_ACTIONS.has(action);const preserveStandaloneNote=action==="files"||action==="files-discover"||action==="docs";const scalarToArrayFields=SCALAR_ANNOTATION_SOURCE_ACTIONS.has(action)?ANNOTATION_SCALAR_TO_ARRAY_FIELDS:SCALAR_TO_ARRAY_FIELDS;for(const[key,value]of Object.entries(options)){if(Array.isArray(value)&&ARRAY_TO_CSV_FIELDS.has(key)){result[key]=value.join(",");continue}if(key==="note"&&preserveStandaloneNote){result[key]=value;continue}if(typeof value==="string"&&scalarToArrayFields.has(key)){result[key]=[value];continue}if(typeof value==="string"&&promoteAddRemove&&(key==="add"||key==="remove")){result[key]=[value];continue}result[key]=value}return result}function resolveMcpActionAuthor(args,options,action){const author=readRuntimeString(args,"author");if(author!==void 0){return author}return action!==void 0&&LIFECYCLE_AUTHOR_ALIAS_ACTIONS.has(action)?readRuntimeString(args,"assignee")??readRuntimeString(options,"assignee"):void 0}function withResolvedAuthor(options,author){return author!==void 0&&options.author===void 0?{...options,author}:options}function optionsWithAuthor(args,action){const sourceOptions=isRuntimeRecord(args.options)?args.options:void 0;const baseOptions=asRecordClone(args.options);const hoistedTopLevel={};const hoistKey=key=>{if(baseOptions[key]!==void 0||args[key]===void 0){return}hoistedTopLevel[key]=args[key]};for(const key of HOISTED_ACTION_OPTION_KEYS[action??""]??[]){hoistKey(key)}for(const key of UNIVERSAL_READ_OUTPUT_OPTION_KEYS){hoistKey(key)}if(action!==void 0&&isMcpMutationTransportInput(args)){assertMcpAnnotationFileUnavailable(action,baseOptions)}const options=normalizeMcpOptionsArrays({...hoistedTopLevel,...baseOptions},action);const stdinPolicySource=isMcpMutationTransportInput(args)?args:sourceOptions??args;return preserveTransportLiteralOptions(stdinPolicySource,withResolvedAuthor(options,resolveMcpActionAuthor(args,options,action)))}function withAddNoteOption(options){if(options.addNote===void 0){return options}const next={...options};if(next.note===void 0&&typeof next.addNote==="string"){next.note=next.addNote}delete next.addNote;return next}function withFilesDiscoveryOptions(options){const next={...options};if(next.discoveryNote!==void 0&&next.note===void 0&&typeof next.discoveryNote==="string"){next.note=next.discoveryNote}delete next.discover;delete next.discoveryNote;return next}function normalizeActionName(value){const chunks=[];let lastWasSeparator=true;for(const character of value.trim().toLowerCase()){const isAlphaNumeric=character>="a"&&character<="z"||character>="0"&&character<="9";if(isAlphaNumeric){chunks.push(character);lastWasSeparator=false;continue}if(!lastWasSeparator){chunks.push("-");lastWasSeparator=true}}if(chunks.at(-1)==="-"){chunks.pop()}return chunks.join("")}function shouldInvalidateWorkspaceContractsCacheAfterAction(action){return!WORKSPACE_CONTRACTS_CACHE_PRESERVING_ACTIONS.has(normalizeActionName(action))}function normalizeCommandPath(value){return value.trim().toLowerCase().split(/\s+/).filter(Boolean).join(" ")}function readRuntimeStringArray(value){if(!Array.isArray(value)){return[]}return value.map(entry=>String(entry)).filter(entry=>entry.length>0)}function extensionOptionsFromArgs(args,options){const reserved=new Set(["action","args","author","cwd","fullChangedFields","id","options","path","query","reason","target"]);const passthrough={};for(const[key,value]of Object.entries(args)){if(!reserved.has(key)){passthrough[key]=value}}const normalizedOptions={...passthrough,...options};delete normalizedOptions.args;return normalizedOptions}function withMutationCompaction(args,options){const runnerOptions=preserveTransportLiteralOptions(options??{},{...options});return{changedFields:args.fullChangedFields===true?"full":"compact",idOnly:args.idOnly===true,runnerOptions}}function mutationListOptions(options){return{type:readRuntimeScalarString(options,"filterType"),tag:readRuntimeScalarString(options,"filterTag"),priority:readRuntimeScalarString(options,"filterPriority"),deadlineBefore:readRuntimeScalarString(options,"filterDeadlineBefore"),deadlineAfter:readRuntimeScalarString(options,"filterDeadlineAfter"),updatedAfter:readRuntimeScalarString(options,"filterUpdatedAfter"),updatedBefore:readRuntimeScalarString(options,"filterUpdatedBefore"),createdAfter:readRuntimeScalarString(options,"filterCreatedAfter"),createdBefore:readRuntimeScalarString(options,"filterCreatedBefore"),ids:normalizeBulkIdsValue(options.ids),assignee:readRuntimeScalarString(options,"filterAssignee"),assigneeFilter:readRuntimeScalarString(options,"filterAssigneeFilter")??readRuntimeScalarString(options,"filterAssignee_filter"),parent:readRuntimeScalarString(options,"filterParent"),sprint:readRuntimeScalarString(options,"filterSprint"),release:readRuntimeScalarString(options,"filterRelease"),limit:readRuntimeScalarString(options,"limit"),offset:readRuntimeScalarString(options,"offset")}}function readGraphIdListOption(value){if(typeof value==="string"&&value.trim().length>0)return value;if(Array.isArray(value))return readRuntimeStringArray(value);return void 0}function readGraphBoundOption(value){if(typeof value==="number"&&Number.isFinite(value))return value;if(typeof value==="string"&&value.trim().length>0)return value;return void 0}function graphOptionsFromFlat(options){const kind=readGraphIdListOption(options.kind);const exemptIsolate=readGraphIdListOption(options.exemptIsolate);const exemptIsolateType=readGraphIdListOption(options.exemptIsolateType);return{...kind===void 0?{}:{kind},maxDepth:readGraphBoundOption(options.maxDepth),limit:readGraphBoundOption(options.limit),after:readRuntimeString(options,"after"),direction:readRuntimeString(options,"direction"),maxPaths:readGraphBoundOption(options.maxPaths),sample:readGraphBoundOption(options.sample),...exemptIsolate===void 0?{}:{exemptIsolate},...exemptIsolateType===void 0?{}:{exemptIsolateType},saveBaseline:options.saveBaseline===true,rebuild:options.rebuild===true,clear:options.clear===true,summary:options.summary===true,...options.full===true?{full:true}:{}}}function normalizeBulkMutationListOptions(options){const normalized=normalizeListOptions(options);if(options.ids!==void 0){normalized.ids=normalizeBulkIdsValue(options.ids)}return normalized}function closeManyOptionsFromFlat(options){return{status:readRuntimeString(options,"filterStatus"),list:isRuntimeRecord(options.list)?normalizeBulkMutationListOptions(options.list):mutationListOptions(options),reason:readRuntimeString(options,"reason"),resolution:readRuntimeString(options,"resolution"),expectedResult:readRuntimeString(options,"expectedResult")??readRuntimeString(options,"expected_result")??readRuntimeString(options,"expected"),actualResult:readRuntimeString(options,"actualResult")??readRuntimeString(options,"actual_result")??readRuntimeString(options,"actual"),validateClose:readRuntimeString(options,"validateClose")??readRuntimeString(options,"validate_close"),author:readRuntimeString(options,"author"),message:readRuntimeString(options,"message"),force:options.force===true?true:void 0,dryRun:options.dryRun===true||options.dry_run===true?true:void 0,rollback:readRuntimeString(options,"rollback"),checkpoint:options.checkpoint===false||options.noCheckpoint===true||options.no_checkpoint===true?false:void 0}}const UPDATE_MANY_FLAT_CONTROL_KEYS=new Set(["filterStatus","filterType","filterTag","filterPriority","filterDeadlineBefore","filterDeadlineAfter","filterUpdatedAfter","filterUpdatedBefore","filterCreatedAfter","filterCreatedBefore","filterAssignee","filterAssigneeFilter","filterAssignee_filter","filterParent","filterSprint","filterRelease","ids","list","update","limit","offset","dryRun","dry_run","rollback","checkpoint","noCheckpoint","no_checkpoint"]);function updateManyUpdateOptionsFromFlat(options){const update={};for(const[key,value]of Object.entries(options)){if(UPDATE_MANY_FLAT_CONTROL_KEYS.has(key)){continue}update[key]=value}return normalizeMcpUpdateOptions(update)}function normalizeMcpUpdateOptions(options){const normalizedInput=normalizeMcpOptionsArrays(options,"update-many");for(const contract of UPDATE_COMMANDER_STRING_OPTION_CONTRACTS){for(const key of contract.keys){const value=normalizedInput[key];if(typeof value==="number"&&Number.isFinite(value)){normalizedInput[key]=String(value)}}}return normalizeUpdateOptions(normalizedInput)}function updateManyOptionsFromFlat(options){if(isRuntimeRecord(options.list)||isRuntimeRecord(options.update)){const updateSource=isRuntimeRecord(options.update)?options.update:updateManyUpdateOptionsFromFlat(options);const normalizedUpdate=preserveTransportLiteralOptions(options,normalizeMcpUpdateOptions(updateSource));return{status:readRuntimeScalarString(options,"filterStatus"),list:isRuntimeRecord(options.list)?normalizeBulkMutationListOptions(options.list):mutationListOptions(options),update:overlayMutationStdinTokenPolicy(updateSource,normalizedUpdate),dryRun:options.dryRun===true||options.dry_run===true?true:void 0,rollback:readRuntimeString(options,"rollback"),checkpoint:options.checkpoint===false||options.noCheckpoint===true||options.no_checkpoint===true?false:void 0}}return{status:readRuntimeScalarString(options,"filterStatus"),list:mutationListOptions(options),update:preserveTransportLiteralOptions(options,updateManyUpdateOptionsFromFlat(options)),dryRun:options.dryRun===true||options.dry_run===true?true:void 0,rollback:readRuntimeString(options,"rollback"),checkpoint:options.checkpoint===false||options.noCheckpoint===true||options.no_checkpoint===true?false:void 0}}export{actionGlobalOptions,closeManyOptionsFromFlat,extensionOptionsFromArgs,graphOptionsFromFlat,isRuntimeRecord,markMcpMutationTransportInput,mutationListOptions,mutationOptionsWithOverrides,normalizeActionName,normalizeCommandPath,normalizeMcpOptionsArrays,normalizeMcpUpdateOptions,optionsWithAuthor,parseRuntimeInteger,readRuntimeScalarString,readRuntimeScalarStringAllowBlank,readRuntimeString,readRuntimeStringArray,resolveRuntimeLimit,shouldInvalidateWorkspaceContractsCacheAfterAction,updateManyOptionsFromFlat,updateManyUpdateOptionsFromFlat,withAddNoteOption,withFilesDiscoveryOptions,withMutationCompaction};
 //# sourceMappingURL=runtime-input.js.map
-//# debugId=d42d5fb1-eebc-5549-ae88-dc923d9d3696