@unbrained/pm-cli 2026.9.7 → 2026.9.8

package/dist/sdk/cli-bootstrap.js

@@ -1,839 +1,2 @@
-/**
- * @module sdk/cli-bootstrap
- *
- * Provides public bootstrap argument normalization for embedded CLI hosts.
- */
-
-!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]="3d35c0f5-e1b8-5fd8-8fd7-c754a21784a1")}catch(e){}}();
-import { EXECUTABLE_COMMAND_ALIASES, PM_COMMAND_ALIAS_CONTRACTS, renderPmCommandAliasMigrationHint, resolvePmCommandAlias, resolveSubcommandFlagContractsForCommand, } from "./cli-contracts.js";
-export { EXECUTABLE_COMMAND_ALIASES, PM_COMMAND_ALIAS_CONTRACTS, renderPmCommandAliasMigrationHint, resolvePmCommandAlias, };
-import { levenshteinDistanceWithinLimit } from "../core/shared/levenshtein.js";
-import { EXIT_CODE } from "../core/shared/constants.js";
-import { PmCliError } from "../core/shared/errors.js";
-import { normalizeItemAddressInvocation } from "./agent/item-addressing.js";
-import { BOOTSTRAP_BOOLEAN_FLAGS, GLOBAL_VALUE_CONSUMING_FLAGS, consumesBootstrapValue, findBootstrapCommandTokenIndex as findContractBootstrapCommandTokenIndex, isInlineGlobalValueToken, parseBootstrapCommandName as parseContractBootstrapCommandName, } from "./cli-contracts/bootstrap-command-scanner.js";
-const OUTPUT_VALUE_FLAGS = new Set([
-    "--output-include",
-    "--output-limit",
-    "--output-budget",
-    "--output-format",
-    "--output-session",
-    "--output-cursor",
-]);
-/** Consume one bootstrap-global token and update the accumulated parse state. */
-function consumeBootstrapGlobalToken(argv, index, state) {
-    const token = argv[index];
-    if (BOOTSTRAP_BOOLEAN_FLAGS.has(token)) {
-        state.booleanFlags.add(token);
-        return 1;
-    }
-    const equalsIndex = token.indexOf("=");
-    const canonicalFlag = equalsIndex > 0 ? token.slice(0, equalsIndex) : token;
-    if (!GLOBAL_VALUE_CONSUMING_FLAGS.has(canonicalFlag))
-        return 1;
-    const inlineValue = equalsIndex > 0 ? token.slice(equalsIndex + 1) : undefined;
-    const consumesValue = inlineValue === undefined &&
-        consumesBootstrapValue(canonicalFlag, argv[index + 1]);
-    const value = inlineValue ?? (consumesValue ? argv[index + 1] : undefined);
-    if (canonicalFlag === "--author") {
-        state.author = value ?? "";
-    }
-    else if (typeof value === "string" && value.length > 0) {
-        const target = OUTPUT_VALUE_FLAGS.has(canonicalFlag)
-            ? state.outputValues
-            : state.pathValues;
-        target.set(canonicalFlag, value);
-    }
-    return consumesValue ? 2 : 1;
-}
-/** Implements parse bootstrap global options for the public runtime surface of this module. */
-export function parseBootstrapGlobalOptions(argv) {
-    const state = {
-        booleanFlags: new Set(),
-        outputValues: new Map(),
-        pathValues: new Map(),
-    };
-    let index = 0;
-    while (index < argv.length) {
-        if (argv[index] === "--")
-            break;
-        index += consumeBootstrapGlobalToken(argv, index, state);
-    }
-    return {
-        path: state.pathValues.get("--pm-path") ?? state.pathValues.get("--path"),
-        noExtensions: state.booleanFlags.has("--no-extensions"),
-        noPager: state.booleanFlags.has("--no-pager"),
-        json: state.booleanFlags.has("--json"),
-        quiet: state.booleanFlags.has("--quiet"),
-        lean: state.booleanFlags.has("--lean"),
-        tokenAccounting: state.booleanFlags.has("--token-accounting"),
-        ...(state.booleanFlags.has("--output-row-contract")
-            ? { outputRowContract: true }
-            : {}),
-        ...(state.outputValues.get("--output-include") === undefined
-            ? {}
-            : { outputInclude: state.outputValues.get("--output-include") }),
-        ...(state.outputValues.get("--output-limit") === undefined
-            ? {}
-            : { outputLimit: state.outputValues.get("--output-limit") }),
-        ...(state.outputValues.get("--output-budget") === undefined
-            ? {}
-            : { outputBudget: state.outputValues.get("--output-budget") }),
-        ...(state.outputValues.get("--output-format") === "toon" ||
-            state.outputValues.get("--output-format") === "json"
-            ? {
-                outputFormat: state.outputValues.get("--output-format"),
-            }
-            : {}),
-        ...(state.outputValues.get("--output-session") === undefined
-            ? {}
-            : { outputSession: state.outputValues.get("--output-session") }),
-        ...(state.outputValues.get("--output-cursor") === undefined
-            ? {}
-            : { outputCursor: state.outputValues.get("--output-cursor") }),
-        ...(state.author === ""
-            ? { authorMissingValue: true }
-            : state.author !== undefined
-                ? { author: state.author }
-                : {}),
-    };
-}
-/** Implements strip global bootstrap tokens for the public runtime surface of this module. */
-export function stripGlobalBootstrapTokens(argv) {
-    const remaining = [];
-    let index = 0;
-    while (index < argv.length) {
-        const token = argv[index];
-        if (token === "--") {
-            break;
-        }
-        if (BOOTSTRAP_BOOLEAN_FLAGS.has(token) ||
-            token === "--profile" ||
-            token === "--id-only" ||
-            token === "--full-changed-fields" ||
-            token === "--explain") {
-            index += 1;
-            continue;
-        }
-        if (GLOBAL_VALUE_CONSUMING_FLAGS.has(token)) {
-            index += consumesBootstrapValue(token, argv[index + 1]) ? 2 : 1;
-            continue;
-        }
-        if (isInlineGlobalValueToken(token)) {
-            index += 1;
-            continue;
-        }
-        remaining.push(token);
-        index += 1;
-    }
-    return remaining;
-}
-/** Implements parse bootstrap help request for the public runtime surface of this module. */
-export function parseBootstrapHelpRequest(argv) {
-    const stripped = stripGlobalBootstrapTokens(argv);
-    const first = stripped[0]?.trim().toLowerCase();
-    if (first === "help") {
-        const commandPathTokens = [];
-        for (let index = 1; index < stripped.length; index += 1) {
-            const token = stripped[index];
-            if (token.startsWith("-")) {
-                break;
-            }
-            commandPathTokens.push(token.trim().toLowerCase());
-        }
-        return {
-            requested: true,
-            commandPathTokens,
-        };
-    }
-    const helpFlagIndex = stripped.findIndex((token) => token === "--help" || token === "-h");
-    if (helpFlagIndex < 0) {
-        return {
-            requested: false,
-            commandPathTokens: [],
-        };
-    }
-    const commandPathTokens = [];
-    for (const token of stripped) {
-        if (token.startsWith("-")) {
-            break;
-        }
-        commandPathTokens.push(token.trim().toLowerCase());
-    }
-    return {
-        requested: true,
-        commandPathTokens,
-    };
-}
-/** Locate the command token after global bootstrap flags and their values. */
-export function findBootstrapCommandTokenIndex(argv) {
-    return findContractBootstrapCommandTokenIndex(argv);
-}
-/** Resolve the normalized command name from bootstrap invocation arguments. */
-export function parseBootstrapCommandName(argv) {
-    return parseContractBootstrapCommandName(argv);
-}
-function shouldDisablePagerForInvocation(argv, bootstrapGlobal) {
-    if (bootstrapGlobal.noPager) {
-        return true;
-    }
-    if (process.stdout.isTTY === true) {
-        return false;
-    }
-    const helpRequest = parseBootstrapHelpRequest(argv);
-    return helpRequest.requested;
-}
-/** Implements apply bootstrap pager policy for the public runtime surface of this module. */
-export function applyBootstrapPagerPolicy(argv) {
-    const pagerEnvironmentKeys = [
-        "PAGER",
-        "MANPAGER",
-        "GIT_PAGER",
-        "LESS",
-    ];
-    const previousValues = pagerEnvironmentKeys.map((key) => process.env[key]);
-    const restore = () => {
-        for (const [index, key] of pagerEnvironmentKeys.entries()) {
-            const value = previousValues[index];
-            if (value === undefined) {
-                delete process.env[key];
-            }
-            else {
-                process.env[key] = value;
-            }
-        }
-    };
-    const bootstrapGlobal = parseBootstrapGlobalOptions(argv);
-    if (!shouldDisablePagerForInvocation(argv, bootstrapGlobal)) {
-        return restore;
-    }
-    process.env.PAGER = "cat";
-    process.env.MANPAGER = "cat";
-    process.env.GIT_PAGER = "cat";
-    if (typeof process.env.LESS !== "string" ||
-        process.env.LESS.trim().length === 0) {
-        process.env.LESS = "FRX";
-    }
-    return restore;
-}
-const EXTENSION_ACTION_SYNTAX_TOKENS = new Set([
-    "install",
-    "uninstall",
-    "explore",
-    "manage",
-    "doctor",
-    "adopt",
-    "adopt-all",
-    "activate",
-    "deactivate",
-]);
-/** Implements normalize legacy extension action syntax for the public runtime surface of this module. */
-export function normalizeLegacyExtensionActionSyntax(argv) {
-    const extensionIndex = findBootstrapCommandTokenIndex(argv);
-    if (extensionIndex === undefined || argv[extensionIndex] !== "extension") {
-        return [...argv];
-    }
-    const actionToken = argv[extensionIndex + 1];
-    if (!actionToken || actionToken.startsWith("-")) {
-        return [...argv];
-    }
-    if (!EXTENSION_ACTION_SYNTAX_TOKENS.has(actionToken)) {
-        return [...argv];
-    }
-    if (argv.includes("--help") || argv.includes("-h")) {
-        return [...argv];
-    }
-    const forcedActionFlag = `--${actionToken}`;
-    if (argv.includes(forcedActionFlag)) {
-        return [...argv];
-    }
-    return [
-        ...argv.slice(0, extensionIndex + 1),
-        forcedActionFlag,
-        ...argv.slice(extensionIndex + 2),
-    ];
-}
-const CLI_EXECUTABLE_ALIASES = new Set(["pm", "pm-cli"]);
-/**
- * Remove a package-runner-injected executable token from the command position.
- * Both published CLI bin names are accepted so `npx <package> pm init` and
- * `bunx <package> pm-cli init` behave like direct executable invocations.
- */
-function stripLeadingExecutableAlias(argv, trace) {
-    const index = findBootstrapCommandTokenIndex(argv);
-    if (index === undefined) {
-        return argv;
-    }
-    const token = argv[index];
-    if (!CLI_EXECUTABLE_ALIASES.has(token.trim().toLowerCase())) {
-        return argv;
-    }
-    trace.push({
-        from: token,
-        to: [],
-        reason: "executable_alias",
-        confidence: "high",
-    });
-    return [...argv.slice(0, index), ...argv.slice(index + 1)];
-}
-/** Executable command aliases: a leading command token here is rewritten to its canonical command BEFORE commander parses, so the alias actually runs instead of merely being suggested. These are the highest-frequency aliases real agents type (telemetry: `pm show <id>` alone is the single most common unknown-command) and each target takes the same positional/flags as the alias (with `--comment`/ `--note`/`--learning` flag-aliased to `--add` on the target command). Keeping this in one place means the alias is consistent across registration, commander dispatch, telemetry, and error handling — all of which read the normalized argv. */
-/**
- * Rewrite a leading command-alias token (e.g. `show` -> `get`) in place. Only the
- * command position is considered — the same token appearing later as an argument
- * (`pm get show`) is left untouched — and only when it is not preceded by `--` or a
- * value-consuming global flag, mirroring {@link parseBootstrapCommandName}.
- */
-function rewriteCommandAlias(argv, trace) {
-    const index = findBootstrapCommandTokenIndex(argv);
-    if (index === undefined) {
-        return argv;
-    }
-    const token = argv[index];
-    const canonical = EXECUTABLE_COMMAND_ALIASES[token.trim().toLowerCase()];
-    if (!canonical) {
-        return argv;
-    }
-    const rewritten = [...argv];
-    rewritten[index] = canonical;
-    trace.push({
-        from: token,
-        to: [canonical],
-        reason: "command_alias",
-        confidence: "high",
-    });
-    return rewritten;
-}
-function normalizeFlagKeyToken(raw) {
-    const withoutPrefix = raw.replace(/^--?/, "");
-    return withoutPrefix
-        .replace(/_/g, "-")
-        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
-        .toLowerCase();
-}
-function toComparableFlagKey(raw) {
-    return normalizeFlagKeyToken(raw).replace(/-/g, "");
-}
-function markUnambiguousFlag(map, key, canonicalFlag) {
-    const existing = map.get(key);
-    if (existing === undefined) {
-        map.set(key, canonicalFlag);
-        return;
-    }
-    if (existing !== canonicalFlag) {
-        map.set(key, null);
-    }
-}
-function collectLongFlagCandidates(contract) {
-    const candidates = [];
-    const pushLongFlag = (value) => {
-        if (typeof value !== "string") {
-            return;
-        }
-        if (!value.startsWith("--")) {
-            return;
-        }
-        candidates.push(value);
-    };
-    pushLongFlag(contract.flag);
-    for (const alias of contract.aliases ?? []) {
-        pushLongFlag(alias);
-    }
-    return candidates;
-}
-function buildFlagLookup(commandName, contractsOverride) {
-    const contracts = contractsOverride ?? resolveSubcommandFlagContractsForCommand(commandName);
-    const canonicalByNormalized = new Map();
-    const canonicalByCompact = new Map();
-    const canonicalComparablesMap = new Map();
-    const listCanonicalFlags = new Set();
-    for (const contract of contracts) {
-        const longCandidates = collectLongFlagCandidates(contract);
-        if (longCandidates.length === 0) {
-            continue;
-        }
-        const canonicalFlag = `--${normalizeFlagKeyToken(longCandidates[0])}`;
-        for (const candidate of longCandidates) {
-            markUnambiguousFlag(canonicalByNormalized, normalizeFlagKeyToken(candidate), canonicalFlag);
-            markUnambiguousFlag(canonicalByCompact, toComparableFlagKey(candidate), canonicalFlag);
-        }
-        const comparable = toComparableFlagKey(canonicalFlag);
-        if (!canonicalComparablesMap.has(canonicalFlag)) {
-            canonicalComparablesMap.set(canonicalFlag, comparable);
-        }
-        if (contract.list === true) {
-            listCanonicalFlags.add(canonicalFlag);
-        }
-    }
-    return {
-        canonicalByNormalized,
-        canonicalByCompact,
-        canonicalComparables: [...canonicalComparablesMap.entries()].map(([canonicalFlag, comparable]) => ({
-            canonicalFlag,
-            comparable,
-        })),
-        listCanonicalFlags,
-    };
-}
-function resolveCanonicalFlag(rawKey, lookup) {
-    const normalizedKey = normalizeFlagKeyToken(rawKey);
-    const direct = lookup.canonicalByNormalized.get(normalizedKey);
-    if (typeof direct === "string") {
-        return {
-            flag: direct,
-            reason: "flag_alias",
-            confidence: "high",
-        };
-    }
-    const comparableKey = normalizedKey.replace(/-/g, "");
-    const compactMatch = lookup.canonicalByCompact.get(comparableKey);
-    if (typeof compactMatch === "string") {
-        return {
-            flag: compactMatch,
-            reason: "flag_alias",
-            confidence: "high",
-        };
-    }
-    const maxDistance = comparableKey.length >= 8 ? 2 : 1;
-    let bestDistance = Number.POSITIVE_INFINITY;
-    let bestFlag;
-    let tied = false;
-    for (const candidate of lookup.canonicalComparables) {
-        const distance = levenshteinDistanceWithinLimit(comparableKey, candidate.comparable, maxDistance);
-        if (distance === null) {
-            continue;
-        }
-        if (distance < bestDistance) {
-            bestDistance = distance;
-            bestFlag = candidate.canonicalFlag;
-            tied = false;
-            continue;
-        }
-        if (distance === bestDistance && bestFlag !== candidate.canonicalFlag) {
-            tied = true;
-        }
-    }
-    if (!bestFlag ||
-        tied ||
-        !Number.isFinite(bestDistance) ||
-        bestDistance <= 0) {
-        return null;
-    }
-    return {
-        flag: bestFlag,
-        reason: "flag_typo",
-        confidence: bestDistance >= 2 ? "medium" : "high",
-    };
-}
-/** Implements list alias plural keys for the public runtime surface of this module. */
-export function listAliasPluralKeys(normalizedKey) {
-    const candidates = [`${normalizedKey}s`];
-    if (normalizedKey.endsWith("y") && normalizedKey.length > 1) {
-        candidates.push(`${normalizedKey.slice(0, -1)}ies`);
-    }
-    return candidates;
-}
-function parseBareKeyValueToken(token, preserve = false) {
-    if (preserve || token.includes("://")) {
-        return null;
-    }
-    const match = token.match(/^([A-Za-z][A-Za-z0-9_-]{1,63})([:=])(.*)$/);
-    if (!match) {
-        return null;
-    }
-    const key = match[1];
-    const value = match[3];
-    if (value.length === 0) {
-        return null;
-    }
-    return {
-        key,
-        value,
-    };
-}
-function normalizeLongOptionToken(token, lookup, preserve = false) {
-    if (preserve || !token.startsWith("--")) {
-        return { tokens: [token] };
-    }
-    const equalsIndex = token.indexOf("=");
-    const key = equalsIndex >= 0 ? token.slice(0, equalsIndex) : token;
-    const inlineValue = equalsIndex >= 0 ? token.slice(equalsIndex + 1) : undefined;
-    const resolution = resolveCanonicalFlag(key, lookup);
-    if (!resolution) {
-        return { tokens: [token] };
-    }
-    const normalizedToken = inlineValue === undefined
-        ? resolution.flag
-        : `${resolution.flag}=${inlineValue}`;
-    if (normalizedToken === token) {
-        return { tokens: [token] };
-    }
-    return {
-        tokens: [normalizedToken],
-        event: {
-            from: token,
-            to: [normalizedToken],
-            reason: resolution.reason,
-            confidence: resolution.confidence,
-        },
-    };
-}
-/** Locate global path-value tokens that normalization must preserve literally. */
-function collectBootstrapPathValueIndices(argv) {
-    const indices = new Set();
-    let expectsValue = false;
-    for (let index = 0; index < argv.length; index += 1) {
-        if (expectsValue) {
-            indices.add(index);
-            expectsValue = false;
-            continue;
-        }
-        const token = argv[index];
-        expectsValue = token === "--path" || token === "--pm-path";
-    }
-    return indices;
-}
-// Global option flags whose value may legitimately begin with "--" (commander
-// accepts such values). Their value token must not be reinterpreted as a list
-// flag during coalescing. `--pm-path <dir>` and its legacy `--path <dir>`
-// alias are the documented cases; other globals
-// (--json/--quiet/--no-extensions/--no-pager/--profile) are boolean.
-function splitCanonicalListToken(token) {
-    if (!token.startsWith("--")) {
-        return null;
-    }
-    const equalsIndex = token.indexOf("=");
-    if (equalsIndex < 0) {
-        return { flag: token };
-    }
-    return {
-        flag: token.slice(0, equalsIndex),
-        inlineValue: token.slice(equalsIndex + 1),
-    };
-}
-function copyValueConsumingFlag(argv, index, result) {
-    result.push(argv[index]);
-    const next = argv[index + 1];
-    if (typeof next === "string" && next !== "--") {
-        result.push(next);
-        return index + 2;
-    }
-    return index + 1;
-}
-function readListFlagOccurrence(argv, index, parsed, multiValueListFlags) {
-    if (parsed.inlineValue !== undefined) {
-        return {
-            originalTokens: [argv[index]],
-            value: parsed.inlineValue,
-            consumed: 1,
-        };
-    }
-    const values = [];
-    let valueIndex = index + 1;
-    while (valueIndex < argv.length &&
-        argv[valueIndex] !== "--" &&
-        !argv[valueIndex].startsWith("-") &&
-        (values.length === 0 || multiValueListFlags.has(parsed.flag))) {
-        values.push(argv[valueIndex]);
-        valueIndex += 1;
-    }
-    const consumed = values.length === 0 ? 1 : 1 + values.length;
-    return {
-        originalTokens: argv.slice(index, index + consumed),
-        value: values.length === 0 ? undefined : values.join(","),
-        consumed,
-    };
-}
-function recordListFlagOccurrence(slots, result, flag, occurrence) {
-    const existing = slots.get(flag);
-    if (existing) {
-        existing.values.push(occurrence.value);
-        existing.occurrences += 1;
-        return;
-    }
-    slots.set(flag, {
-        outputIndex: result.length,
-        originalTokens: occurrence.originalTokens,
-        values: [occurrence.value],
-        occurrences: 1,
-    });
-    // Reserve the anchor position; finalized after the walk so we know the full
-    // merged value or can restore the original token form for single uses.
-    result.push(null);
-}
-function buildListFlagCoalescingSplices(slots, multiValueListFlags) {
-    const events = [];
-    const splices = [];
-    for (const [flag, slot] of slots) {
-        const shouldMerge = slot.occurrences >= 2 ||
-            (multiValueListFlags.has(flag) && slot.originalTokens.length > 2);
-        if (!shouldMerge) {
-            splices.push({
-                outputIndex: slot.outputIndex,
-                tokens: slot.originalTokens,
-            });
-            continue;
-        }
-        const mergedToken = `${flag}=${slot.values.join(",")}`;
-        splices.push({ outputIndex: slot.outputIndex, tokens: [mergedToken] });
-        events.push({
-            from: `${flag} (x${slot.occurrences})`,
-            to: [mergedToken],
-            reason: "list_merge",
-            confidence: "high",
-        });
-    }
-    return { events, splices };
-}
-function applyListFlagSplices(result, splices) {
-    splices.sort((a, b) => b.outputIndex - a.outputIndex);
-    for (const splice of splices) {
-        result.splice(splice.outputIndex, 1, ...splice.tokens);
-    }
-}
-/**
- * Coalesce repeated occurrences of comma-separated list flags into a single
- * `--flag=v1,v2,v3` token anchored at the FIRST occurrence. Without this,
- * Commander treats these flags as scalars and silently keeps only the last
- * value (data loss). Both `--flag value` and `--flag=value` forms are merged;
- * a value-less occurrence is preserved untouched, and a `--` terminator stops
- * coalescing (remainder is passed through verbatim).
- *
- * `valueConsumingFlags` lists option flags (e.g. global `--pm-path`) whose value
- * may itself begin with `--`. Their value token is emitted verbatim so a
- * list-flag-looking value (`--path --tags`) is never reinterpreted as a flag
- * nor allowed to swallow the following command/positional token.
- */
-export function coalesceRepeatedListFlags(argv, listFlags, valueConsumingFlags = new Set(), multiValueListFlags = new Set()) {
-    if (listFlags.size === 0) {
-        return { argv: [...argv], events: [] };
-    }
-    const result = [];
-    const slots = new Map();
-    let index = 0;
-    while (index < argv.length) {
-        const token = argv[index];
-        if (token === "--") {
-            result.push(...argv.slice(index));
-            break;
-        }
-        // A value-consuming option in space form owns the next token as its value,
-        // even when that value begins with "--". Emit both verbatim so the value is
-        // never misread as a list-flag occurrence.
-        if (valueConsumingFlags.has(token)) {
-            index = copyValueConsumingFlag(argv, index, result);
-            continue;
-        }
-        const parsed = splitCanonicalListToken(token);
-        if (!parsed || !listFlags.has(parsed.flag)) {
-            result.push(token);
-            index += 1;
-            continue;
-        }
-        const occurrence = readListFlagOccurrence(argv, index, parsed, multiValueListFlags);
-        if (occurrence.value === undefined) {
-            // Value-less occurrence: leave untouched, do not coalesce.
-            result.push(token);
-            index += occurrence.consumed;
-            continue;
-        }
-        recordListFlagOccurrence(slots, result, parsed.flag, {
-            originalTokens: occurrence.originalTokens,
-            value: occurrence.value,
-        });
-        index += occurrence.consumed;
-    }
-    // Apply anchor splices from the end so earlier indices stay valid when a
-    // single-occurrence anchor expands back into two tokens.
-    const { events, splices } = buildListFlagCoalescingSplices(slots, multiValueListFlags);
-    applyListFlagSplices(result, splices);
-    return { argv: result, events };
-}
-/** Linked-test entry keys accepted in the two-token form `pm test <id> --add command "npm test -- parser"` (GH-191). Only entry-identity keys are merged: `command`/`cmd` name the shell command and `path` names the test file, so a single key=value entry is meaningful for them. Other structured keys (scope, env_set, assertions, ...) cannot form a valid standalone entry and are left for the normal parser to reject. `--remove` matches existing entries by `command=`/`path=` only, so `cmd` is excluded there. Key names mirror STRUCTURED_LINKED_TEST_KEYS in src/cli/commands/linked-test-entry.ts. */
-const LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG = new Map([
-    ["--add", new Set(["command", "cmd", "path"])],
-    ["--remove", new Set(["command", "path"])],
-]);
-/** Sandbox-safe linked-test commands legitimately start with env assignments (`PM_PATH=... PM_GLOBAL_PATH=... vitest run -- parser`), which look like bare key=value settings tokens. When the two preceding tokens are a linked-test flag plus a bare two-token key (`--add command <value>`), the value must be left intact for mergeLinkedTestTwoTokenEntries instead of being rewritten into a canonical flag (e.g. PM_PATH= -> --pm-path), which would silently corrupt the command into `--add command --pm-path ...`. */
-function isLinkedTestTwoTokenValuePosition(commandName, emittedTokens) {
-    if (commandName !== "test" || emittedTokens.length < 2) {
-        return false;
-    }
-    const key = emittedTokens[emittedTokens.length - 1];
-    const flag = emittedTokens[emittedTokens.length - 2];
-    const keys = LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG.get(flag);
-    return keys !== undefined && keys.has(key);
-}
-function shouldPreserveBareKeyValueToken(commandName, emittedTokens) {
-    return (commandName === "search" ||
-        isLinkedTestTwoTokenValuePosition(commandName, emittedTokens));
-}
-/** Accept the two-token linked-test form `pm test <id> --add command "npm test -- parser"` by merging the bare key token and its single quoted value into the documented `--add command=...` shape. Without this merge Commander binds the bare key as the option value and treats the quoted command as an excess positional, failing with "too many arguments" (GH-191). The merge only fires when EXACTLY ONE non-flag token follows the bare key, i.e. the value was quoted into one shell token — an unquoted multi-token value stays ambiguous (it may swallow the item id), still fails fast, and is routed to targeted quoting guidance by the commander error classifier instead. */
-export function mergeLinkedTestTwoTokenEntries(argv, commandName, trace) {
-    if (commandName !== "test") {
-        return argv;
-    }
-    const result = [];
-    let index = 0;
-    while (index < argv.length) {
-        const token = argv[index];
-        if (token === "--") {
-            result.push(...argv.slice(index));
-            return result;
-        }
-        const keys = LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG.get(token);
-        const key = keys ? argv[index + 1] : undefined;
-        if (!keys || typeof key !== "string" || !keys.has(key)) {
-            result.push(token);
-            index += 1;
-            continue;
-        }
-        let runEnd = index + 2;
-        while (runEnd < argv.length && !argv[runEnd].startsWith("-")) {
-            runEnd += 1;
-        }
-        if (runEnd - (index + 2) !== 1) {
-            result.push(token);
-            index += 1;
-            continue;
-        }
-        const value = argv[index + 2];
-        const mergedValue = `${key}=${value}`;
-        result.push(token, mergedValue);
-        trace.push({
-            from: `${token} ${key} ${value}`,
-            to: [token, mergedValue],
-            reason: "bare_key_value",
-            confidence: "high",
-        });
-        index += 3;
-    }
-    return result;
-}
-/** Normalize option spellings and bare key-value tokens before list coalescing. */
-function normalizeBootstrapTokens(argv, lookup, commandName, trace) {
-    const normalizedArgv = [];
-    const pathValueIndices = collectBootstrapPathValueIndices(argv);
-    for (let index = 0; index < argv.length; index += 1) {
-        const token = argv[index];
-        if (token === "--") {
-            normalizedArgv.push(...argv.slice(index));
-            break;
-        }
-        const preserveCurrentToken = pathValueIndices.has(index);
-        const previous = normalizedArgv[normalizedArgv.length - 1];
-        if (token.startsWith("--")) {
-            const normalizedToken = normalizeLongOptionToken(token, lookup, preserveCurrentToken);
-            normalizedArgv.push(...normalizedToken.tokens);
-            if (normalizedToken.event)
-                trace.push(normalizedToken.event);
-            continue;
-        }
-        const bareKeyValue = parseBareKeyValueToken(token, preserveCurrentToken);
-        if (bareKeyValue &&
-            !(typeof previous === "string" && previous.startsWith("-")) &&
-            !shouldPreserveBareKeyValueToken(commandName, normalizedArgv)) {
-            const resolution = resolveCanonicalFlag(bareKeyValue.key, lookup);
-            if (resolution) {
-                const replacement = [resolution.flag, bareKeyValue.value];
-                normalizedArgv.push(...replacement);
-                trace.push({
-                    from: token,
-                    to: replacement,
-                    reason: "bare_key_value",
-                    confidence: resolution.confidence,
-                });
-                continue;
-            }
-        }
-        normalizedArgv.push(token);
-    }
-    return normalizedArgv;
-}
-/** Implements normalize bootstrap invocation for the public runtime surface of this module. */
-export function normalizeBootstrapInvocation(argv) {
-    const trace = [];
-    const executableNormalized = stripLeadingExecutableAlias(argv, trace);
-    const legacyNormalized = normalizeLegacyExtensionActionSyntax(executableNormalized);
-    if (legacyNormalized.length !== executableNormalized.length ||
-        legacyNormalized.some((token, index) => token !== executableNormalized[index])) {
-        trace.push({
-            from: executableNormalized.join(" "),
-            to: [...legacyNormalized],
-            reason: "legacy_extension_action",
-            confidence: "high",
-        });
-    }
-    const aliasNormalized = rewriteCommandAlias(legacyNormalized, trace);
-    const itemAddress = normalizeItemAddressInvocation(aliasNormalized);
-    if (itemAddress.conflict) {
-        throw new PmCliError("Provide the item id either positionally or with --id, not both.", EXIT_CODE.USAGE);
-    }
-    if (itemAddress.changed) {
-        trace.push({
-            from: `--id ${itemAddress.itemId}`,
-            to: [itemAddress.itemId],
-            reason: "item_id_alias",
-            confidence: "high",
-        });
-    }
-    const commandName = parseBootstrapCommandName(itemAddress.argv);
-    const commandPathName = parseBootstrapCommandPathName(itemAddress.argv);
-    const lookup = buildFlagLookup(commandPathName ?? commandName);
-    const normalizedArgv = normalizeBootstrapTokens(itemAddress.argv, lookup, commandName, trace);
-    const linkedTestNormalized = mergeLinkedTestTwoTokenEntries(normalizedArgv, commandName, trace);
-    const coalesced = coalesceRepeatedListFlags(linkedTestNormalized, lookup.listCanonicalFlags, GLOBAL_VALUE_CONSUMING_FLAGS, commandName === "create" ? new Set(["--tags"]) : new Set());
-    for (const event of coalesced.events) {
-        trace.push(event);
-    }
-    return {
-        argv: coalesced.argv,
-        commandName,
-        trace,
-    };
-}
-function parseBootstrapCommandPathName(argv) {
-    const stripped = stripGlobalBootstrapTokens(argv);
-    const first = stripped[0]?.trim().toLowerCase();
-    const second = stripped[1]?.trim().toLowerCase();
-    if ((first === "extension" || first === "package" || first === "packages") &&
-        typeof second === "string" &&
-        second.length > 0 &&
-        !second.startsWith("-")) {
-        return `${first} ${second}`;
-    }
-    return first;
-}
-/** Implements parse bootstrap type value for the public runtime surface of this module. */
-export function parseBootstrapTypeValue(argv) {
-    for (let index = 0; index < argv.length; index += 1) {
-        const token = argv[index];
-        if (token === "--") {
-            break;
-        }
-        if (token === "--type") {
-            const candidate = argv[index + 1];
-            if (typeof candidate === "string" && candidate.trim().length > 0) {
-                return candidate.trim();
-            }
-            continue;
-        }
-        if (token.startsWith("--type=")) {
-            const candidate = token.slice("--type=".length).trim();
-            if (candidate.length > 0) {
-                return candidate;
-            }
-        }
-    }
-    return undefined;
-}
-/** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export const _testOnly = {
-    buildFlagLookup,
-    collectBootstrapPathValueIndices,
-    collectLongFlagCandidates,
-    markUnambiguousFlag,
-    normalizeLongOptionToken,
-    resolveCanonicalFlag,
-};
+!(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]="fcffdf9d-a396-5ee2-b170-31cba062fee4")}catch(e2){}})();import{EXECUTABLE_COMMAND_ALIASES,PM_COMMAND_ALIAS_CONTRACTS,renderPmCommandAliasMigrationHint,resolvePmCommandAlias,resolveSubcommandFlagContractsForCommand}from"./cli-contracts.js";import{levenshteinDistanceWithinLimit}from"../core/shared/levenshtein.js";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{resolvePmHistoryOperation}from"./cli-contracts/command-aliases.js";import{normalizeItemAddressInvocation}from"./agent/item-addressing.js";import{BOOTSTRAP_BOOLEAN_FLAGS,GLOBAL_VALUE_CONSUMING_FLAGS,consumesBootstrapValue,findBootstrapCommandTokenIndex as findContractBootstrapCommandTokenIndex,isInlineGlobalValueToken,parseBootstrapCommandName as parseContractBootstrapCommandName}from"./cli-contracts/bootstrap-command-scanner.js";const OUTPUT_VALUE_FLAGS=new Set(["--output-include","--output-limit","--output-budget","--output-format","--output-session","--output-cursor"]);function consumeBootstrapGlobalToken(argv,index,state){const token=argv[index];if(BOOTSTRAP_BOOLEAN_FLAGS.has(token)){state.booleanFlags.add(token);return 1}const equalsIndex=token.indexOf("=");const canonicalFlag=equalsIndex>0?token.slice(0,equalsIndex):token;if(!GLOBAL_VALUE_CONSUMING_FLAGS.has(canonicalFlag))return 1;const inlineValue=equalsIndex>0?token.slice(equalsIndex+1):void 0;const consumesValue=inlineValue===void 0&&consumesBootstrapValue(canonicalFlag,argv[index+1]);const value=inlineValue??(consumesValue?argv[index+1]:void 0);if(canonicalFlag==="--author"){state.author=value??""}else if(typeof value==="string"&&value.length>0){const target=OUTPUT_VALUE_FLAGS.has(canonicalFlag)?state.outputValues:state.pathValues;target.set(canonicalFlag,value)}return consumesValue?2:1}function parseBootstrapGlobalOptions(argv){const state={booleanFlags:new Set,outputValues:new Map,pathValues:new Map};let index=0;while(index<argv.length){if(argv[index]==="--")break;index+=consumeBootstrapGlobalToken(argv,index,state)}return{path:state.pathValues.get("--pm-path")??state.pathValues.get("--path"),noExtensions:state.booleanFlags.has("--no-extensions"),noPager:state.booleanFlags.has("--no-pager"),json:state.booleanFlags.has("--json"),quiet:state.booleanFlags.has("--quiet"),lean:state.booleanFlags.has("--lean"),tokenAccounting:state.booleanFlags.has("--token-accounting"),...state.booleanFlags.has("--output-row-contract")?{outputRowContract:true}:{},...state.outputValues.get("--output-include")===void 0?{}:{outputInclude:state.outputValues.get("--output-include")},...state.outputValues.get("--output-limit")===void 0?{}:{outputLimit:state.outputValues.get("--output-limit")},...state.outputValues.get("--output-budget")===void 0?{}:{outputBudget:state.outputValues.get("--output-budget")},...state.outputValues.get("--output-format")==="toon"||state.outputValues.get("--output-format")==="json"?{outputFormat:state.outputValues.get("--output-format")}:{},...state.outputValues.get("--output-session")===void 0?{}:{outputSession:state.outputValues.get("--output-session")},...state.outputValues.get("--output-cursor")===void 0?{}:{outputCursor:state.outputValues.get("--output-cursor")},...state.author===""?{authorMissingValue:true}:state.author!==void 0?{author:state.author}:{}}}function stripGlobalBootstrapTokens(argv){const remaining=[];let index=0;while(index<argv.length){const token=argv[index];if(token==="--"){break}if(BOOTSTRAP_BOOLEAN_FLAGS.has(token)||token==="--profile"||token==="--id-only"||token==="--full-changed-fields"||token==="--explain"){index+=1;continue}if(GLOBAL_VALUE_CONSUMING_FLAGS.has(token)){index+=consumesBootstrapValue(token,argv[index+1])?2:1;continue}if(isInlineGlobalValueToken(token)){index+=1;continue}remaining.push(token);index+=1}return remaining}function parseBootstrapHelpRequest(argv){const stripped=stripGlobalBootstrapTokens(argv);const first=stripped[0]?.trim().toLowerCase();if(first==="help"){const commandPathTokens2=[];for(let index=1;index<stripped.length;index+=1){const token=stripped[index];if(token.startsWith("-")){break}commandPathTokens2.push(token.trim().toLowerCase())}return{requested:true,commandPathTokens:commandPathTokens2}}const helpFlagIndex=stripped.findIndex(token=>token==="--help"||token==="-h");if(helpFlagIndex<0){return{requested:false,commandPathTokens:[]}}const commandPathTokens=[];for(const token of stripped){if(token.startsWith("-")){break}commandPathTokens.push(token.trim().toLowerCase())}return{requested:true,commandPathTokens}}function findBootstrapCommandTokenIndex(argv){return findContractBootstrapCommandTokenIndex(argv)}function parseBootstrapCommandName(argv){return parseContractBootstrapCommandName(argv)}function shouldDisablePagerForInvocation(argv,bootstrapGlobal){if(bootstrapGlobal.noPager){return true}if(process.stdout.isTTY===true){return false}const helpRequest=parseBootstrapHelpRequest(argv);return helpRequest.requested}function applyBootstrapPagerPolicy(argv){const pagerEnvironmentKeys=["PAGER","MANPAGER","GIT_PAGER","LESS"];const previousValues=pagerEnvironmentKeys.map(key=>process.env[key]);const restore=()=>{for(const[index,key]of pagerEnvironmentKeys.entries()){const value=previousValues[index];if(value===void 0){delete process.env[key]}else{process.env[key]=value}}};const bootstrapGlobal=parseBootstrapGlobalOptions(argv);if(!shouldDisablePagerForInvocation(argv,bootstrapGlobal)){return restore}process.env.PAGER="cat";process.env.MANPAGER="cat";process.env.GIT_PAGER="cat";if(typeof process.env.LESS!=="string"||process.env.LESS.trim().length===0){process.env.LESS="FRX"}return restore}const EXTENSION_ACTION_SYNTAX_TOKENS=new Set(["install","uninstall","explore","manage","doctor","adopt","adopt-all","activate","deactivate"]);function normalizeLegacyExtensionActionSyntax(argv){const extensionIndex=findBootstrapCommandTokenIndex(argv);if(extensionIndex===void 0||argv[extensionIndex]!=="extension"){return[...argv]}const actionToken=argv[extensionIndex+1];if(!actionToken||actionToken.startsWith("-")){return[...argv]}if(!EXTENSION_ACTION_SYNTAX_TOKENS.has(actionToken)){return[...argv]}if(argv.includes("--help")||argv.includes("-h")){return[...argv]}const forcedActionFlag=`--${actionToken}`;if(argv.includes(forcedActionFlag)){return[...argv]}return[...argv.slice(0,extensionIndex+1),forcedActionFlag,...argv.slice(extensionIndex+2)]}const CLI_EXECUTABLE_ALIASES=new Set(["pm","pm-cli"]);function stripLeadingExecutableAlias(argv,trace){const index=findBootstrapCommandTokenIndex(argv);if(index===void 0){return argv}const token=argv[index];if(!CLI_EXECUTABLE_ALIASES.has(token.trim().toLowerCase())){return argv}trace.push({from:token,to:[],reason:"executable_alias",confidence:"high"});return[...argv.slice(0,index),...argv.slice(index+1)]}function rewriteCommandAlias(argv,trace){const index=findBootstrapCommandTokenIndex(argv);if(index===void 0){return argv}const token=argv[index];const canonical=EXECUTABLE_COMMAND_ALIASES[token.trim().toLowerCase()];if(!canonical){return argv}const rewritten=[...argv];rewritten[index]=canonical;trace.push({from:token,to:[canonical],reason:"command_alias",confidence:"high"});return rewritten}function normalizeFlagKeyToken(raw){const withoutPrefix=raw.replace(/^--?/,"");return withoutPrefix.replace(/_/g,"-").replace(/([a-z0-9])([A-Z])/g,"$1-$2").toLowerCase()}function toComparableFlagKey(raw){return normalizeFlagKeyToken(raw).replace(/-/g,"")}function markUnambiguousFlag(map,key,canonicalFlag){const existing=map.get(key);if(existing===void 0){map.set(key,canonicalFlag);return}if(existing!==canonicalFlag){map.set(key,null)}}function collectLongFlagCandidates(contract){const candidates=[];const pushLongFlag=value=>{if(typeof value!=="string"){return}if(!value.startsWith("--")){return}candidates.push(value)};pushLongFlag(contract.flag);for(const alias of contract.aliases??[]){pushLongFlag(alias)}return candidates}function buildFlagLookup(commandName,contractsOverride){const contracts=contractsOverride??resolveSubcommandFlagContractsForCommand(commandName);const canonicalByNormalized=new Map;const canonicalByCompact=new Map;const canonicalComparablesMap=new Map;const listCanonicalFlags=new Set;for(const contract of contracts){const longCandidates=collectLongFlagCandidates(contract);if(longCandidates.length===0){continue}const canonicalFlag=`--${normalizeFlagKeyToken(longCandidates[0])}`;for(const candidate of longCandidates){markUnambiguousFlag(canonicalByNormalized,normalizeFlagKeyToken(candidate),canonicalFlag);markUnambiguousFlag(canonicalByCompact,toComparableFlagKey(candidate),canonicalFlag)}const comparable=toComparableFlagKey(canonicalFlag);if(!canonicalComparablesMap.has(canonicalFlag)){canonicalComparablesMap.set(canonicalFlag,comparable)}if(contract.list===true){listCanonicalFlags.add(canonicalFlag)}}return{canonicalByNormalized,canonicalByCompact,canonicalComparables:[...canonicalComparablesMap.entries()].map(([canonicalFlag,comparable])=>({canonicalFlag,comparable})),listCanonicalFlags}}function resolveCanonicalFlag(rawKey,lookup){const normalizedKey=normalizeFlagKeyToken(rawKey);const direct=lookup.canonicalByNormalized.get(normalizedKey);if(typeof direct==="string"){return{flag:direct,reason:"flag_alias",confidence:"high"}}const comparableKey=normalizedKey.replace(/-/g,"");const compactMatch=lookup.canonicalByCompact.get(comparableKey);if(typeof compactMatch==="string"){return{flag:compactMatch,reason:"flag_alias",confidence:"high"}}const maxDistance=comparableKey.length>=8?2:1;let bestDistance=Number.POSITIVE_INFINITY;let bestFlag;let tied=false;for(const candidate of lookup.canonicalComparables){const distance=levenshteinDistanceWithinLimit(comparableKey,candidate.comparable,maxDistance);if(distance===null){continue}if(distance<bestDistance){bestDistance=distance;bestFlag=candidate.canonicalFlag;tied=false;continue}if(distance===bestDistance&&bestFlag!==candidate.canonicalFlag){tied=true}}if(!bestFlag||tied||!Number.isFinite(bestDistance)||bestDistance<=0){return null}return{flag:bestFlag,reason:"flag_typo",confidence:bestDistance>=2?"medium":"high"}}function listAliasPluralKeys(normalizedKey){const candidates=[`${normalizedKey}s`];if(normalizedKey.endsWith("y")&&normalizedKey.length>1){candidates.push(`${normalizedKey.slice(0,-1)}ies`)}return candidates}function parseBareKeyValueToken(token,preserve=false){if(preserve||token.includes("://")){return null}const match=token.match(/^([A-Za-z][A-Za-z0-9_-]{1,63})([:=])(.*)$/);if(!match){return null}const key=match[1];const value=match[3];if(value.length===0){return null}return{key,value}}function normalizeLongOptionToken(token,lookup,preserve=false){if(preserve||!token.startsWith("--")){return{tokens:[token]}}const equalsIndex=token.indexOf("=");const key=equalsIndex>=0?token.slice(0,equalsIndex):token;const inlineValue=equalsIndex>=0?token.slice(equalsIndex+1):void 0;const resolution=resolveCanonicalFlag(key,lookup);if(!resolution){return{tokens:[token]}}const normalizedToken=inlineValue===void 0?resolution.flag:`${resolution.flag}=${inlineValue}`;if(normalizedToken===token){return{tokens:[token]}}return{tokens:[normalizedToken],event:{from:token,to:[normalizedToken],reason:resolution.reason,confidence:resolution.confidence}}}function collectBootstrapPathValueIndices(argv){const indices=new Set;let expectsValue=false;for(let index=0;index<argv.length;index+=1){if(expectsValue){indices.add(index);expectsValue=false;continue}const token=argv[index];expectsValue=token==="--path"||token==="--pm-path"}return indices}function splitCanonicalListToken(token){if(!token.startsWith("--")){return null}const equalsIndex=token.indexOf("=");if(equalsIndex<0){return{flag:token}}return{flag:token.slice(0,equalsIndex),inlineValue:token.slice(equalsIndex+1)}}function copyValueConsumingFlag(argv,index,result){result.push(argv[index]);const next=argv[index+1];if(typeof next==="string"&&next!=="--"){result.push(next);return index+2}return index+1}function readListFlagOccurrence(argv,index,parsed,multiValueListFlags){if(parsed.inlineValue!==void 0){return{originalTokens:[argv[index]],value:parsed.inlineValue,consumed:1}}const values=[];let valueIndex=index+1;while(valueIndex<argv.length&&argv[valueIndex]!=="--"&&!argv[valueIndex].startsWith("-")&&(values.length===0||multiValueListFlags.has(parsed.flag))){values.push(argv[valueIndex]);valueIndex+=1}const consumed=values.length===0?1:1+values.length;return{originalTokens:argv.slice(index,index+consumed),value:values.length===0?void 0:values.join(","),consumed}}function recordListFlagOccurrence(slots,result,flag,occurrence){const existing=slots.get(flag);if(existing){existing.values.push(occurrence.value);existing.occurrences+=1;return}slots.set(flag,{outputIndex:result.length,originalTokens:occurrence.originalTokens,values:[occurrence.value],occurrences:1});result.push(null)}function buildListFlagCoalescingSplices(slots,multiValueListFlags){const events=[];const splices=[];for(const[flag,slot]of slots){const shouldMerge=slot.occurrences>=2||multiValueListFlags.has(flag)&&slot.originalTokens.length>2;if(!shouldMerge){splices.push({outputIndex:slot.outputIndex,tokens:slot.originalTokens});continue}const mergedToken=`${flag}=${slot.values.join(",")}`;splices.push({outputIndex:slot.outputIndex,tokens:[mergedToken]});events.push({from:`${flag} (x${slot.occurrences})`,to:[mergedToken],reason:"list_merge",confidence:"high"})}return{events,splices}}function applyListFlagSplices(result,splices){splices.sort((a,b)=>b.outputIndex-a.outputIndex);for(const splice of splices){result.splice(splice.outputIndex,1,...splice.tokens)}}function coalesceRepeatedListFlags(argv,listFlags,valueConsumingFlags=new Set,multiValueListFlags=new Set){if(listFlags.size===0){return{argv:[...argv],events:[]}}const result=[];const slots=new Map;let index=0;while(index<argv.length){const token=argv[index];if(token==="--"){result.push(...argv.slice(index));break}if(valueConsumingFlags.has(token)){index=copyValueConsumingFlag(argv,index,result);continue}const parsed=splitCanonicalListToken(token);if(!parsed||!listFlags.has(parsed.flag)){result.push(token);index+=1;continue}const occurrence=readListFlagOccurrence(argv,index,parsed,multiValueListFlags);if(occurrence.value===void 0){result.push(token);index+=occurrence.consumed;continue}recordListFlagOccurrence(slots,result,parsed.flag,{originalTokens:occurrence.originalTokens,value:occurrence.value});index+=occurrence.consumed}const{events,splices}=buildListFlagCoalescingSplices(slots,multiValueListFlags);applyListFlagSplices(result,splices);return{argv:result,events}}const LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG=new Map([["--add",new Set(["command","cmd","path"])],["--remove",new Set(["command","path"])]]);function isLinkedTestTwoTokenValuePosition(commandName,emittedTokens){if(commandName!=="test"||emittedTokens.length<2){return false}const key=emittedTokens[emittedTokens.length-1];const flag=emittedTokens[emittedTokens.length-2];const keys=LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG.get(flag);return keys!==void 0&&keys.has(key)}function shouldPreserveBareKeyValueToken(commandName,emittedTokens){return commandName==="search"||isLinkedTestTwoTokenValuePosition(commandName,emittedTokens)}function mergeLinkedTestTwoTokenEntries(argv,commandName,trace){if(commandName!=="test"){return argv}const result=[];let index=0;while(index<argv.length){const token=argv[index];if(token==="--"){result.push(...argv.slice(index));return result}const keys=LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG.get(token);const key=keys?argv[index+1]:void 0;if(!keys||typeof key!=="string"||!keys.has(key)){result.push(token);index+=1;continue}let runEnd=index+2;while(runEnd<argv.length&&!argv[runEnd].startsWith("-")){runEnd+=1}if(runEnd-(index+2)!==1){result.push(token);index+=1;continue}const value=argv[index+2];const mergedValue=`${key}=${value}`;result.push(token,mergedValue);trace.push({from:`${token} ${key} ${value}`,to:[token,mergedValue],reason:"bare_key_value",confidence:"high"});index+=3}return result}function normalizeBootstrapTokens(argv,lookup,commandName,trace){const normalizedArgv=[];const pathValueIndices=collectBootstrapPathValueIndices(argv);for(let index=0;index<argv.length;index+=1){const token=argv[index];if(token==="--"){normalizedArgv.push(...argv.slice(index));break}const preserveCurrentToken=pathValueIndices.has(index);const previous=normalizedArgv[normalizedArgv.length-1];if(token.startsWith("--")){const normalizedToken=normalizeLongOptionToken(token,lookup,preserveCurrentToken);normalizedArgv.push(...normalizedToken.tokens);if(normalizedToken.event)trace.push(normalizedToken.event);continue}const bareKeyValue=parseBareKeyValueToken(token,preserveCurrentToken);if(bareKeyValue&&!(typeof previous==="string"&&previous.startsWith("-"))&&!shouldPreserveBareKeyValueToken(commandName,normalizedArgv)){const resolution=resolveCanonicalFlag(bareKeyValue.key,lookup);if(resolution){const replacement=[resolution.flag,bareKeyValue.value];normalizedArgv.push(...replacement);trace.push({from:token,to:replacement,reason:"bare_key_value",confidence:resolution.confidence});continue}}normalizedArgv.push(token)}return normalizedArgv}function normalizeBootstrapInvocation(argv){const trace=[];const executableNormalized=stripLeadingExecutableAlias(argv,trace);const legacyNormalized=normalizeLegacyExtensionActionSyntax(executableNormalized);if(legacyNormalized.length!==executableNormalized.length||legacyNormalized.some((token,index)=>token!==executableNormalized[index])){trace.push({from:executableNormalized.join(" "),to:[...legacyNormalized],reason:"legacy_extension_action",confidence:"high"})}const aliasNormalized=rewriteCommandAlias(legacyNormalized,trace);const itemAddress=normalizeItemAddressInvocation(aliasNormalized);if(itemAddress.conflict){throw new PmCliError("Provide the item id either positionally or with --id, not both.",EXIT_CODE.USAGE)}if(itemAddress.changed){trace.push({from:`--id ${itemAddress.itemId}`,to:[itemAddress.itemId],reason:"item_id_alias",confidence:"high"})}const commandName=parseBootstrapCommandName(itemAddress.argv);const commandPathName=parseBootstrapCommandPathName(itemAddress.argv);const lookup=buildFlagLookup(commandPathName??commandName);const normalizedArgv=normalizeBootstrapTokens(itemAddress.argv,lookup,commandName,trace);const linkedTestNormalized=mergeLinkedTestTwoTokenEntries(normalizedArgv,commandName,trace);const coalesced=coalesceRepeatedListFlags(linkedTestNormalized,lookup.listCanonicalFlags,GLOBAL_VALUE_CONSUMING_FLAGS,commandName==="create"?new Set(["--tags"]):new Set);for(const event of coalesced.events){trace.push(event)}return{argv:coalesced.argv,commandName,trace}}function parseBootstrapCommandPathName(argv){const stripped=stripGlobalBootstrapTokens(argv);const first=stripped[0]?.trim().toLowerCase();const second=stripped[1]?.trim().toLowerCase();const historyPath=`${first} ${second}`;if(first==="history"&&resolvePmHistoryOperation(historyPath)!==historyPath)return historyPath;if((first==="extension"||first==="package"||first==="packages")&&typeof second==="string"&&second.length>0&&!second.startsWith("-")){return`${first} ${second}`}return first}function parseBootstrapTypeValue(argv){for(let index=0;index<argv.length;index+=1){const token=argv[index];if(token==="--"){break}if(token==="--type"){const candidate=argv[index+1];if(typeof candidate==="string"&&candidate.trim().length>0){return candidate.trim()}continue}if(token.startsWith("--type=")){const candidate=token.slice("--type=".length).trim();if(candidate.length>0){return candidate}}}return void 0}const _testOnly={buildFlagLookup,collectBootstrapPathValueIndices,collectLongFlagCandidates,markUnambiguousFlag,normalizeLongOptionToken,resolveCanonicalFlag};export{EXECUTABLE_COMMAND_ALIASES,PM_COMMAND_ALIAS_CONTRACTS,_testOnly,applyBootstrapPagerPolicy,coalesceRepeatedListFlags,findBootstrapCommandTokenIndex,listAliasPluralKeys,mergeLinkedTestTwoTokenEntries,normalizeBootstrapInvocation,normalizeLegacyExtensionActionSyntax,parseBootstrapCommandName,parseBootstrapGlobalOptions,parseBootstrapHelpRequest,parseBootstrapTypeValue,renderPmCommandAliasMigrationHint,resolvePmCommandAlias,stripGlobalBootstrapTokens};
 //# sourceMappingURL=cli-bootstrap.js.map
-//# debugId=3d35c0f5-e1b8-5fd8-8fd7-c754a21784a1