@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/cli/extension-command-options.js

@@ -1,428 +1,2 @@
-/**
- * @module cli/extension-command-options
- *
- * Provides CLI runtime support for Extension Command Options.
- */
-
-!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]="8eca3029-0d1f-569a-84ce-5ccd0b92a272")}catch(e){}}();
-import { EXIT_CODE, PmCliError, flattenFlagListValue, resolveFlagValueKind, } from "../sdk/runtime-primitives.js";
-const UNSAFE_LOOSE_OPTION_KEYS = new Set([
-    "__proto__",
-    "prototype",
-    "constructor",
-]);
-const LOOSE_OPTION_OCCURRENCES = Symbol("looseOptionOccurrences");
-function toLooseOptionKey(rawKey) {
-    const key = rawKey.trim().toLowerCase();
-    return key.replaceAll(/-([a-z0-9])/g, (_match, group) => group.toUpperCase());
-}
-function setLooseOptionValue(options, key, value) {
-    const existing = options[key];
-    if (existing === undefined) {
-        options[key] = value;
-        return;
-    }
-    if (Array.isArray(existing)) {
-        existing.push(value);
-        options[key] = existing;
-        return;
-    }
-    options[key] = [existing, value];
-}
-function parseLooseOptionToken(args, index) {
-    const token = args[index];
-    if (!token.startsWith("-") || token === "-" || token === "--") {
-        return null;
-    }
-    if (!token.startsWith("--")) {
-        const equalsIndex = token.indexOf("=");
-        if (equalsIndex >= 0) {
-            return {
-                consumed: 1,
-                key: token.slice(1, equalsIndex).trim(),
-                value: token.slice(equalsIndex + 1),
-            };
-        }
-        const key = token.slice(1).trim();
-        const next = args[index + 1];
-        if (typeof next === "string" && !next.startsWith("-")) {
-            return {
-                consumed: 2,
-                key,
-                value: next,
-            };
-        }
-        return {
-            consumed: 1,
-            key,
-            value: true,
-        };
-    }
-    const equalsIndex = token.indexOf("=");
-    if (equalsIndex >= 0) {
-        return {
-            consumed: 1,
-            key: token.slice(2, equalsIndex).trim(),
-            value: token.slice(equalsIndex + 1),
-        };
-    }
-    if (token.startsWith("--no-")) {
-        return {
-            consumed: 1,
-            key: token.slice(5).trim(),
-            value: false,
-        };
-    }
-    const key = token.slice(2).trim();
-    const next = args[index + 1];
-    if (typeof next === "string" && !next.startsWith("-")) {
-        return {
-            consumed: 2,
-            key,
-            value: next,
-        };
-    }
-    return {
-        consumed: 1,
-        key,
-        value: true,
-    };
-}
-function isUnsafeLooseOptionKey(key) {
-    return UNSAFE_LOOSE_OPTION_KEYS.has(key);
-}
-function resolveLooseOptionCoercionKind(definition) {
-    // `value_type` is the canonical field; the deprecated `type` alias resolves
-    // only when `value_type` is absent (FlagDefinition documents this precedence).
-    const raw = (typeof definition.value_type === "string"
-        ? definition.value_type
-        : undefined) ??
-        (typeof definition.type === "string" ? definition.type : undefined);
-    return resolveFlagValueKind(raw);
-}
-function collectLooseOptionKeys(definition) {
-    const keys = [];
-    const long = typeof definition.long === "string" ? definition.long.trim() : "";
-    const short = typeof definition.short === "string" ? definition.short.trim() : "";
-    if (long.startsWith("--")) {
-        const normalized = toLooseOptionKey(long.slice(2));
-        if (normalized.length > 0 && !isUnsafeLooseOptionKey(normalized)) {
-            keys.push(normalized);
-        }
-    }
-    if (short.startsWith("-") && !short.startsWith("--")) {
-        const normalized = toLooseOptionKey(short.slice(1));
-        if (normalized.length > 0 && !isUnsafeLooseOptionKey(normalized)) {
-            keys.push(normalized);
-        }
-    }
-    return [...new Set(keys)];
-}
-/** Implements collect loose command option keys for definitions for the public runtime surface of this module. */
-export function collectLooseCommandOptionKeysForDefinitions(definitions) {
-    const keys = new Set();
-    for (const definition of definitions) {
-        for (const key of collectLooseOptionKeys(definition)) {
-            keys.add(key);
-        }
-    }
-    return keys;
-}
-function resolveCanonicalLooseOptionKey(definition) {
-    const long = typeof definition.long === "string" ? definition.long.trim() : "";
-    if (long.startsWith("--")) {
-        const normalized = toLooseOptionKey(long.slice(2));
-        if (normalized.length > 0 && !isUnsafeLooseOptionKey(normalized)) {
-            return normalized;
-        }
-    }
-    return collectLooseOptionKeys(definition)[0] ?? null;
-}
-function formatLooseOptionLabel(definition) {
-    const long = typeof definition.long === "string" ? definition.long.trim() : "";
-    if (long.startsWith("--") && long.length > 2) {
-        return long;
-    }
-    const short = typeof definition.short === "string" ? definition.short.trim() : "";
-    if (short.startsWith("-") && !short.startsWith("--") && short.length > 1) {
-        return short;
-    }
-    return null;
-}
-/** Implements validate loose command options with flag definitions for the public runtime surface of this module. */
-export function validateLooseCommandOptionsWithFlagDefinitions(options, definitions, commandPath) {
-    if (definitions.length === 0) {
-        return;
-    }
-    const allowed = new Set();
-    const disabled = new Map();
-    const required = [];
-    const labels = [];
-    for (const definition of definitions) {
-        const keys = collectLooseOptionKeys(definition);
-        const normalizedLabel = formatLooseOptionLabel(definition);
-        if (normalizedLabel !== null) {
-            labels.push(normalizedLabel);
-        }
-        for (const key of keys) {
-            allowed.add(key);
-            if (definition.enabled === false) {
-                disabled.set(key, normalizedLabel);
-            }
-        }
-        if (definition.required === true &&
-            definition.enabled !== false &&
-            keys.length > 0) {
-            required.push({ keys, label: normalizedLabel });
-        }
-    }
-    for (const key of Object.keys(options)) {
-        if (!allowed.has(key)) {
-            const expected = labels.length > 0
-                ? ` Expected one of: ${[...new Set(labels)].join(", ")}.`
-                : "";
-            throw new PmCliError(`Unknown option '--${key}' for extension command '${commandPath}'.${expected}`, EXIT_CODE.USAGE);
-        }
-        const disabledLabel = disabled.get(key);
-        if (disabledLabel) {
-            throw new PmCliError(`Option '${disabledLabel}' is disabled for extension command '${commandPath}'.`, EXIT_CODE.USAGE);
-        }
-    }
-    for (const entry of required) {
-        if (!entry.keys.some((key) => Object.hasOwn(options, key))) {
-            throw new PmCliError(`Missing required option '${entry.label}' for extension command '${commandPath}'.`, EXIT_CODE.USAGE);
-        }
-    }
-}
-/** Coerce a scalar value to a string. Existing strings pass through untouched and the `null`/`undefined` sentinels are preserved so an explicitly-cleared flag stays distinguishable from an omitted one; every other primitive is stringified. */
-function coerceLooseStringOptionValue(value) {
-    if (typeof value === "string") {
-        return value;
-    }
-    if (value === null || value === undefined) {
-        return value;
-    }
-    return String(value);
-}
-/** Coerce a scalar value to a number. Existing numbers pass through; a non-blank numeric string is parsed and adopted only when it yields a finite number, otherwise the original value is returned unchanged so malformed input reaches validation rather than silently degrading to `NaN`. */
-function coerceLooseNumberOptionValue(value) {
-    if (typeof value === "number") {
-        return value;
-    }
-    if (typeof value === "string" && value.trim().length > 0) {
-        const parsed = Number(value);
-        return Number.isFinite(parsed) ? parsed : value;
-    }
-    return value;
-}
-/** Coerce a scalar value to a boolean. Booleans pass through; the case-insensitive tokens `true`/`1` and `false`/`0` map to their boolean values and any other input is returned unchanged for validation to reject. */
-function coerceLooseBooleanOptionValue(value) {
-    if (typeof value === "boolean") {
-        return value;
-    }
-    if (typeof value === "string") {
-        const normalized = value.trim().toLowerCase();
-        if (normalized === "true" || normalized === "1") {
-            return true;
-        }
-        if (normalized === "false" || normalized === "0") {
-            return false;
-        }
-    }
-    return value;
-}
-// Per-kind scalar coercers dispatched by the declared flag value type. The table
-// keeps `coerceLooseOptionValue` a flat array-or-scalar branch instead of a
-// per-kind `if` ladder.
-const LOOSE_OPTION_VALUE_COERCERS = {
-    string: coerceLooseStringOptionValue,
-    number: coerceLooseNumberOptionValue,
-    boolean: coerceLooseBooleanOptionValue,
-};
-function coerceLooseOptionValue(value, kind) {
-    if (Array.isArray(value)) {
-        return value.map((entry) => coerceLooseOptionValue(entry, kind));
-    }
-    return LOOSE_OPTION_VALUE_COERCERS[kind](value);
-}
-/**
- * Normalize an accumulated extension flag while preserving the semantic
- * difference between the canonical CSV-friendly `list` form and the
- * package-author `repeatable` alias. Both accumulate occurrences in order;
- * `repeatable` additionally preserves commas inside each occurrence so
- * structured values such as `id=pm-a,kind=related` remain atomic.
- */
-function normalizeAccumulatedFlagValue(value, kind, preserveOccurrenceCommas) {
-    const entries = preserveOccurrenceCommas
-        ? (Array.isArray(value) ? value.flat(Infinity) : [value]).filter((entry) => entry !== undefined && entry !== null && entry !== "")
-        : flattenFlagListValue(value);
-    return kind
-        ? entries.map((entry) => coerceLooseOptionValue(entry, kind))
-        : entries;
-}
-/** Resolve the value applied when a flag is omitted entirely. List flags wrap the default into an accumulated array; scalar flags coerce by declared kind. */
-function applyFlagDefault(defaultValue, kind, isListFlag, preserveOccurrenceCommas) {
-    if (isListFlag) {
-        return normalizeAccumulatedFlagValue(defaultValue, kind, preserveOccurrenceCommas);
-    }
-    return kind ? coerceLooseOptionValue(defaultValue, kind) : defaultValue;
-}
-/** Preserve parse-time value order for list flags whose long and short aliases are interleaved. */
-function readOrderedLooseListValues(occurrenceSource, optionKeys, fallback) {
-    const occurrences = occurrenceSource[LOOSE_OPTION_OCCURRENCES];
-    if (!occurrences || occurrences.length === 0) {
-        return fallback;
-    }
-    const acceptedKeys = new Set(optionKeys);
-    return occurrences
-        .filter((occurrence) => acceptedKeys.has(occurrence.key))
-        .map((occurrence) => occurrence.value);
-}
-/** Implements coerce loose command options with flag definitions for the public runtime surface of this module. */
-export function coerceLooseCommandOptionsWithFlagDefinitions(options, definitions, occurrenceSource = options) {
-    if (definitions.length === 0) {
-        return options;
-    }
-    const coerced = Object.create(null);
-    for (const [key, value] of Object.entries(options)) {
-        coerced[key] = value;
-    }
-    for (const definition of definitions) {
-        const canonical = resolveCanonicalLooseOptionKey(definition);
-        if (!canonical) {
-            continue;
-        }
-        const isListFlag = definition.list === true;
-        const optionKeys = collectLooseOptionKeys(definition);
-        for (const key of optionKeys) {
-            if (key === canonical || !Object.hasOwn(coerced, key)) {
-                continue;
-            }
-            if (Object.hasOwn(coerced, canonical)) {
-                if (!isListFlag) {
-                    delete coerced[key];
-                    continue;
-                }
-                const canonicalValue = coerced[canonical];
-                const aliasValue = coerced[key];
-                coerced[canonical] = [
-                    ...(Array.isArray(canonicalValue)
-                        ? canonicalValue
-                        : [canonicalValue]),
-                    ...(Array.isArray(aliasValue) ? aliasValue : [aliasValue]),
-                ].filter((value) => value != null);
-                delete coerced[key];
-                continue;
-            }
-            coerced[canonical] = coerced[key];
-            delete coerced[key];
-        }
-        const kind = resolveLooseOptionCoercionKind(definition);
-        const preserveOccurrenceCommas = definition.repeatable === true;
-        if (!Object.hasOwn(coerced, canonical)) {
-            // Flag was omitted entirely: apply the declared default when present.
-            if (definition.default !== undefined) {
-                coerced[canonical] = applyFlagDefault(definition.default, kind, isListFlag, preserveOccurrenceCommas);
-            }
-            continue;
-        }
-        if (isListFlag) {
-            coerced[canonical] = normalizeAccumulatedFlagValue(readOrderedLooseListValues(occurrenceSource, optionKeys, coerced[canonical]), kind, preserveOccurrenceCommas);
-            continue;
-        }
-        if (!kind) {
-            continue;
-        }
-        coerced[canonical] = coerceLooseOptionValue(coerced[canonical], kind);
-    }
-    return coerced;
-}
-/** Implements parse loose command options for the public runtime surface of this module. */
-export function parseLooseCommandOptions(args) {
-    const options = Object.create(null);
-    const occurrences = [];
-    Object.defineProperty(options, LOOSE_OPTION_OCCURRENCES, {
-        value: occurrences,
-    });
-    let index = 0;
-    while (index < args.length) {
-        const parsed = parseLooseOptionToken(args, index);
-        if (!parsed) {
-            index += 1;
-            continue;
-        }
-        const normalizedKey = toLooseOptionKey(parsed.key);
-        if (normalizedKey.length === 0 || isUnsafeLooseOptionKey(normalizedKey)) {
-            index += parsed.consumed;
-            continue;
-        }
-        setLooseOptionValue(options, normalizedKey, parsed.value);
-        occurrences.push({ ...parsed, key: normalizedKey });
-        index += parsed.consumed;
-    }
-    return options;
-}
-/** Returns the positional operands in `args`, skipping option tokens and the values they consume (`--flag value`, `--flag=value`, `-f value`, and boolean flags). Tokens after a bare `--` separator are all positional. Used to count genuinely unexpected positionals for extension commands that declare no arguments without miscounting leaked/undeclared option tokens as operands. */
-export function collectLoosePositionalArgs(args) {
-    const positionals = [];
-    let index = 0;
-    while (index < args.length) {
-        if (args[index] === "--") {
-            positionals.push(...args.slice(index + 1));
-            break;
-        }
-        const parsed = parseLooseOptionToken(args, index);
-        if (parsed) {
-            index += Math.max(1, parsed.consumed);
-            continue;
-        }
-        positionals.push(args[index]);
-        index += 1;
-    }
-    return positionals;
-}
-/** Implements strip loose command option tokens for the public runtime surface of this module. */
-export function stripLooseCommandOptionTokens(args, definitions) {
-    if (definitions.length === 0) {
-        return [...args];
-    }
-    const knownKeys = new Set();
-    const booleanKeys = new Set();
-    for (const definition of definitions) {
-        const valueKind = resolveLooseOptionCoercionKind(definition);
-        for (const key of collectLooseOptionKeys(definition)) {
-            knownKeys.add(key);
-            if (valueKind === "boolean") {
-                booleanKeys.add(key);
-            }
-        }
-    }
-    if (knownKeys.size === 0) {
-        return [...args];
-    }
-    const stripped = [];
-    let index = 0;
-    while (index < args.length) {
-        if (args[index] === "--") {
-            stripped.push(...args.slice(index + 1));
-            break;
-        }
-        const parsed = parseLooseOptionToken(args, index);
-        if (parsed) {
-            const normalizedKey = toLooseOptionKey(parsed.key);
-            if (knownKeys.has(normalizedKey)) {
-                const token = args[index];
-                const consumed = booleanKeys.has(normalizedKey) && !token.includes("=")
-                    ? 1
-                    : parsed.consumed;
-                index += consumed;
-                continue;
-            }
-        }
-        stripped.push(args[index]);
-        index += 1;
-    }
-    return stripped;
-}
+!(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]="93ca07c1-857b-57ae-8530-a315a24d0fe5")}catch(e2){}})();import{EXIT_CODE,PmCliError,flattenFlagListValue,resolveFlagValueKind}from"../sdk/runtime-primitives.js";const UNSAFE_LOOSE_OPTION_KEYS=new Set(["__proto__","prototype","constructor"]);const LOOSE_OPTION_OCCURRENCES=Symbol("looseOptionOccurrences");function toLooseOptionKey(rawKey){const key=rawKey.trim().toLowerCase();return key.replaceAll(/-([a-z0-9])/g,(_match,group)=>group.toUpperCase())}function setLooseOptionValue(options,key,value){const existing=options[key];if(existing===void 0){options[key]=value;return}if(Array.isArray(existing)){existing.push(value);options[key]=existing;return}options[key]=[existing,value]}function parseLooseOptionToken(args,index){const token=args[index];if(!token.startsWith("-")||token==="-"||token==="--"){return null}if(!token.startsWith("--")){const equalsIndex2=token.indexOf("=");if(equalsIndex2>=0){return{consumed:1,key:token.slice(1,equalsIndex2).trim(),value:token.slice(equalsIndex2+1)}}const key2=token.slice(1).trim();const next2=args[index+1];if(typeof next2==="string"&&!next2.startsWith("-")){return{consumed:2,key:key2,value:next2}}return{consumed:1,key:key2,value:true}}const equalsIndex=token.indexOf("=");if(equalsIndex>=0){return{consumed:1,key:token.slice(2,equalsIndex).trim(),value:token.slice(equalsIndex+1)}}if(token.startsWith("--no-")){return{consumed:1,key:token.slice(5).trim(),value:false}}const key=token.slice(2).trim();const next=args[index+1];if(typeof next==="string"&&!next.startsWith("-")){return{consumed:2,key,value:next}}return{consumed:1,key,value:true}}function isUnsafeLooseOptionKey(key){return UNSAFE_LOOSE_OPTION_KEYS.has(key)}function resolveLooseOptionCoercionKind(definition){const raw=(typeof definition.value_type==="string"?definition.value_type:void 0)??(typeof definition.type==="string"?definition.type:void 0);return resolveFlagValueKind(raw)}function collectLooseOptionKeys(definition){const keys=[];const long=typeof definition.long==="string"?definition.long.trim():"";const short=typeof definition.short==="string"?definition.short.trim():"";if(long.startsWith("--")){const normalized=toLooseOptionKey(long.slice(2));if(normalized.length>0&&!isUnsafeLooseOptionKey(normalized)){keys.push(normalized)}}if(short.startsWith("-")&&!short.startsWith("--")){const normalized=toLooseOptionKey(short.slice(1));if(normalized.length>0&&!isUnsafeLooseOptionKey(normalized)){keys.push(normalized)}}return[...new Set(keys)]}function collectLooseCommandOptionKeysForDefinitions(definitions){const keys=new Set;for(const definition of definitions){for(const key of collectLooseOptionKeys(definition)){keys.add(key)}}return keys}function resolveCanonicalLooseOptionKey(definition){const long=typeof definition.long==="string"?definition.long.trim():"";if(long.startsWith("--")){const normalized=toLooseOptionKey(long.slice(2));if(normalized.length>0&&!isUnsafeLooseOptionKey(normalized)){return normalized}}return collectLooseOptionKeys(definition)[0]??null}function formatLooseOptionLabel(definition){const long=typeof definition.long==="string"?definition.long.trim():"";if(long.startsWith("--")&&long.length>2){return long}const short=typeof definition.short==="string"?definition.short.trim():"";if(short.startsWith("-")&&!short.startsWith("--")&&short.length>1){return short}return null}function validateLooseCommandOptionsWithFlagDefinitions(options,definitions,commandPath){if(definitions.length===0){return}const allowed=new Set;const disabled=new Map;const required=[];const labels=[];for(const definition of definitions){const keys=collectLooseOptionKeys(definition);const normalizedLabel=formatLooseOptionLabel(definition);if(normalizedLabel!==null){labels.push(normalizedLabel)}for(const key of keys){allowed.add(key);if(definition.enabled===false){disabled.set(key,normalizedLabel)}}if(definition.required===true&&definition.enabled!==false&&keys.length>0){required.push({keys,label:normalizedLabel})}}for(const key of Object.keys(options)){if(!allowed.has(key)){const expected=labels.length>0?` Expected one of: ${[...new Set(labels)].join(", ")}.`:"";throw new PmCliError(`Unknown option '--${key}' for extension command '${commandPath}'.${expected}`,EXIT_CODE.USAGE)}const disabledLabel=disabled.get(key);if(disabledLabel){throw new PmCliError(`Option '${disabledLabel}' is disabled for extension command '${commandPath}'.`,EXIT_CODE.USAGE)}}for(const entry of required){if(!entry.keys.some(key=>Object.hasOwn(options,key))){throw new PmCliError(`Missing required option '${entry.label}' for extension command '${commandPath}'.`,EXIT_CODE.USAGE)}}}function coerceLooseStringOptionValue(value){if(typeof value==="string"){return value}if(value===null||value===void 0){return value}return String(value)}function coerceLooseNumberOptionValue(value){if(typeof value==="number"){return value}if(typeof value==="string"&&value.trim().length>0){const parsed=Number(value);return Number.isFinite(parsed)?parsed:value}return value}function coerceLooseBooleanOptionValue(value){if(typeof value==="boolean"){return value}if(typeof value==="string"){const normalized=value.trim().toLowerCase();if(normalized==="true"||normalized==="1"){return true}if(normalized==="false"||normalized==="0"){return false}}return value}const LOOSE_OPTION_VALUE_COERCERS={string:coerceLooseStringOptionValue,number:coerceLooseNumberOptionValue,boolean:coerceLooseBooleanOptionValue};function coerceLooseOptionValue(value,kind){if(Array.isArray(value)){return value.map(entry=>coerceLooseOptionValue(entry,kind))}return LOOSE_OPTION_VALUE_COERCERS[kind](value)}function normalizeAccumulatedFlagValue(value,kind,preserveOccurrenceCommas){const entries=preserveOccurrenceCommas?(Array.isArray(value)?value.flat(Infinity):[value]).filter(entry=>entry!==void 0&&entry!==null&&entry!==""):flattenFlagListValue(value);return kind?entries.map(entry=>coerceLooseOptionValue(entry,kind)):entries}function applyFlagDefault(defaultValue,kind,isListFlag,preserveOccurrenceCommas){if(isListFlag){return normalizeAccumulatedFlagValue(defaultValue,kind,preserveOccurrenceCommas)}return kind?coerceLooseOptionValue(defaultValue,kind):defaultValue}function readOrderedLooseListValues(occurrenceSource,optionKeys,fallback){const occurrences=occurrenceSource[LOOSE_OPTION_OCCURRENCES];if(!occurrences||occurrences.length===0){return fallback}const acceptedKeys=new Set(optionKeys);return occurrences.filter(occurrence=>acceptedKeys.has(occurrence.key)).map(occurrence=>occurrence.value)}function coerceLooseCommandOptionsWithFlagDefinitions(options,definitions,occurrenceSource=options){if(definitions.length===0){return options}const coerced=Object.create(null);for(const[key,value]of Object.entries(options)){coerced[key]=value}for(const definition of definitions){const canonical=resolveCanonicalLooseOptionKey(definition);if(!canonical){continue}const isListFlag=definition.list===true;const optionKeys=collectLooseOptionKeys(definition);for(const key of optionKeys){if(key===canonical||!Object.hasOwn(coerced,key)){continue}if(Object.hasOwn(coerced,canonical)){if(!isListFlag){delete coerced[key];continue}const canonicalValue=coerced[canonical];const aliasValue=coerced[key];coerced[canonical]=[...Array.isArray(canonicalValue)?canonicalValue:[canonicalValue],...Array.isArray(aliasValue)?aliasValue:[aliasValue]].filter(value=>value!=null);delete coerced[key];continue}coerced[canonical]=coerced[key];delete coerced[key]}const kind=resolveLooseOptionCoercionKind(definition);const preserveOccurrenceCommas=definition.repeatable===true;if(!Object.hasOwn(coerced,canonical)){if(definition.default!==void 0){coerced[canonical]=applyFlagDefault(definition.default,kind,isListFlag,preserveOccurrenceCommas)}continue}if(isListFlag){coerced[canonical]=normalizeAccumulatedFlagValue(readOrderedLooseListValues(occurrenceSource,optionKeys,coerced[canonical]),kind,preserveOccurrenceCommas);continue}if(!kind){continue}coerced[canonical]=coerceLooseOptionValue(coerced[canonical],kind)}return coerced}function parseLooseCommandOptions(args){const options=Object.create(null);const occurrences=[];Object.defineProperty(options,LOOSE_OPTION_OCCURRENCES,{value:occurrences});let index=0;while(index<args.length){const parsed=parseLooseOptionToken(args,index);if(!parsed){index+=1;continue}const normalizedKey=toLooseOptionKey(parsed.key);if(normalizedKey.length===0||isUnsafeLooseOptionKey(normalizedKey)){index+=parsed.consumed;continue}setLooseOptionValue(options,normalizedKey,parsed.value);occurrences.push({...parsed,key:normalizedKey});index+=parsed.consumed}return options}function collectLoosePositionalArgs(args){const positionals=[];let index=0;while(index<args.length){if(args[index]==="--"){positionals.push(...args.slice(index+1));break}const parsed=parseLooseOptionToken(args,index);if(parsed){index+=Math.max(1,parsed.consumed);continue}positionals.push(args[index]);index+=1}return positionals}function stripLooseCommandOptionTokens(args,definitions){if(definitions.length===0){return[...args]}const knownKeys=new Set;const booleanKeys=new Set;for(const definition of definitions){const valueKind=resolveLooseOptionCoercionKind(definition);for(const key of collectLooseOptionKeys(definition)){knownKeys.add(key);if(valueKind==="boolean"){booleanKeys.add(key)}}}if(knownKeys.size===0){return[...args]}const stripped=[];let index=0;while(index<args.length){if(args[index]==="--"){stripped.push(...args.slice(index+1));break}const parsed=parseLooseOptionToken(args,index);if(parsed){const normalizedKey=toLooseOptionKey(parsed.key);if(knownKeys.has(normalizedKey)){const token=args[index];const consumed=booleanKeys.has(normalizedKey)&&!token.includes("=")?1:parsed.consumed;index+=consumed;continue}}stripped.push(args[index]);index+=1}return stripped}export{coerceLooseCommandOptionsWithFlagDefinitions,collectLooseCommandOptionKeysForDefinitions,collectLoosePositionalArgs,parseLooseCommandOptions,stripLooseCommandOptionTokens,validateLooseCommandOptionsWithFlagDefinitions};
 //# sourceMappingURL=extension-command-options.js.map
-//# debugId=8eca3029-0d1f-569a-84ce-5ccd0b92a272

package/dist/cli/extension-recovery.js

@@ -1,127 +1,2 @@
-/**
- * @module cli/extension-recovery
- *
- * Recovers bounded extension activation failures for parse-time diagnostics.
- */
-
-!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]="f3543bab-fa67-5e91-a700-0cbee84f2dc8")}catch(e){}}();
-import path from "node:path";
-import { normalizeHelpCommandPath } from "./help-content.js";
-import { activateExtensions, loadExtensions, readSettings, resolveImplicitPmRoot, } from "../sdk/runtime-primitives.js";
-/** Reload extensions and return bounded load plus activation failures. */
-export async function loadExtensionRecoveryFailures(pmRoot, overrides = {}, attemptedCommandPaths = []) {
-    const dependencies = {
-        readSettings,
-        loadExtensions,
-        activateExtensions,
-        resolveImplicitPmRoot,
-        ...overrides,
-    };
-    try {
-        const settings = await dependencies.readSettings(pmRoot);
-        const loaded = await dependencies.loadExtensions({
-            pmRoot,
-            settings,
-            cwd: process.cwd(),
-            noExtensions: false,
-        });
-        const activated = await dependencies.activateExtensions(loaded);
-        return [...loaded.failed, ...activated.failed].map((entry) => {
-            const discovered = (loaded.effective ?? []).find((candidate) => candidate.layer === entry.layer && candidate.name === entry.name);
-            const declaredCommands = [
-                ...(discovered?.contributions?.commands ?? []),
-                ...(discovered?.contributions?.command_handlers ?? []),
-                ...(discovered?.activation?.commands ?? []),
-            ]
-                .map(normalizeHelpCommandPath)
-                .filter((command, index, commands) => command.length > 0 && commands.indexOf(command) === index)
-                .sort((left, right) => left.localeCompare(right));
-            const normalizedAttempts = attemptedCommandPaths.map(normalizeHelpCommandPath);
-            const declaredCommandMatch = declaredCommands.some((command) => normalizedAttempts.some((attempt) => attempt === command || attempt.startsWith(`${command} `)));
-            return {
-                layer: entry.layer,
-                name: entry.name,
-                error: entry.error,
-                ...(declaredCommands.length > 0
-                    ? { declared_commands: declaredCommands }
-                    : {}),
-                ...(declaredCommandMatch
-                    ? {
-                        declared_command_match: true,
-                        recovery_commands: [
-                            "pm package doctor --project --detail deep",
-                            "pm package install <package-or-path> --project",
-                        ],
-                    }
-                    : {}),
-            };
-        });
-    }
-    catch (error) {
-        return [
-            {
-                layer: "runtime",
-                name: "extension-loader",
-                error: error instanceof Error ? error.message : String(error),
-            },
-        ];
-    }
-}
-/** Loads recovery details only for unknown-command failures. */
-export async function loadUnknownCommandRecoveryFailures(classificationCode, pmRoot, overrides = {}, attemptedCommandPaths = []) {
-    if (classificationCode !== "unknown_command")
-        return [];
-    const failures = await loadExtensionRecoveryFailures(pmRoot, overrides, attemptedCommandPaths);
-    const dependencies = {
-        readSettings,
-        loadExtensions,
-        activateExtensions,
-        resolveImplicitPmRoot,
-        ...overrides,
-    };
-    try {
-        const workspacePmRoot = dependencies.resolveImplicitPmRoot(process.cwd());
-        if (path.resolve(workspacePmRoot) === path.resolve(pmRoot))
-            return failures;
-        const [selectedSettings, workspaceSettings] = await Promise.all([
-            dependencies.readSettings(pmRoot),
-            dependencies.readSettings(workspacePmRoot),
-        ]);
-        const [selected, workspace] = await Promise.all([
-            dependencies.loadExtensions({
-                pmRoot,
-                settings: selectedSettings,
-                cwd: process.cwd(),
-                noExtensions: false,
-            }),
-            dependencies.loadExtensions({
-                pmRoot: workspacePmRoot,
-                settings: workspaceSettings,
-                cwd: process.cwd(),
-                noExtensions: false,
-            }),
-        ]);
-        const selectedCommands = new Set(selected.loaded.flatMap((entry) => entry.activation?.commands ?? []));
-        const missingCommands = [
-            ...new Set(workspace.loaded.flatMap((entry) => entry.activation?.commands ?? [])),
-        ]
-            .filter((command) => !selectedCommands.has(command))
-            .sort((left, right) => left.localeCompare(right));
-        if (missingCommands.length === 0)
-            return failures;
-        failures.push({
-            layer: "runtime",
-            name: "extension-root-relocation",
-            error: `storage_root=${path.resolve(pmRoot)} extension_discovery_root=${selected.roots.project}; ` +
-                `cwd_storage_root=${path.resolve(workspacePmRoot)} cwd_extension_discovery_root=${workspace.roots.project}; ` +
-                `the selected --pm-path runtime is missing ${missingCommands.length} workspace command path(s): ${missingCommands.slice(0, 8).join(", ")}${missingCommands.length > 8 ? ", ..." : ""}. ` +
-                `--pm-path selects extension discovery as well as item storage; omit it, point --pm-path at ${path.resolve(workspacePmRoot)}, or install the extension into the selected tracker with "pm --pm-path ${path.resolve(pmRoot)} install <package> --project".`,
-        });
-    }
-    catch {
-        // The ordinary extension failures remain useful when comparison is unavailable.
-    }
-    return failures;
-}
+!(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]="989fc265-7deb-5456-8a83-0f1fa8d2d9b2")}catch(e2){}})();import path from"node:path";import{normalizeHelpCommandPath}from"./help-content.js";import{activateExtensions,loadExtensions,readSettings,resolveImplicitPmRoot}from"../sdk/runtime-primitives.js";async function loadExtensionRecoveryFailures(pmRoot,overrides={},attemptedCommandPaths=[]){const dependencies={readSettings,loadExtensions,activateExtensions,resolveImplicitPmRoot,...overrides};try{const settings=await dependencies.readSettings(pmRoot);const loaded=await dependencies.loadExtensions({pmRoot,settings,cwd:process.cwd(),noExtensions:false});const activated=await dependencies.activateExtensions(loaded);return[...loaded.failed,...activated.failed].map(entry=>{const discovered=(loaded.effective??[]).find(candidate=>candidate.layer===entry.layer&&candidate.name===entry.name);const declaredCommands=[...discovered?.contributions?.commands??[],...discovered?.contributions?.command_handlers??[],...discovered?.activation?.commands??[]].map(normalizeHelpCommandPath).filter((command,index,commands)=>command.length>0&&commands.indexOf(command)===index).sort((left,right)=>left.localeCompare(right));const normalizedAttempts=attemptedCommandPaths.map(normalizeHelpCommandPath);const declaredCommandMatch=declaredCommands.some(command=>normalizedAttempts.some(attempt=>attempt===command||attempt.startsWith(`${command} `)));return{layer:entry.layer,name:entry.name,error:entry.error,...declaredCommands.length>0?{declared_commands:declaredCommands}:{},...declaredCommandMatch?{declared_command_match:true,recovery_commands:["pm package doctor --project --detail deep","pm package install <package-or-path> --project"]}:{}}})}catch(error){return[{layer:"runtime",name:"extension-loader",error:error instanceof Error?error.message:String(error)}]}}async function loadUnknownCommandRecoveryFailures(classificationCode,pmRoot,overrides={},attemptedCommandPaths=[]){if(classificationCode!=="unknown_command")return[];const failures=await loadExtensionRecoveryFailures(pmRoot,overrides,attemptedCommandPaths);const dependencies={readSettings,loadExtensions,activateExtensions,resolveImplicitPmRoot,...overrides};try{const workspacePmRoot=dependencies.resolveImplicitPmRoot(process.cwd());if(path.resolve(workspacePmRoot)===path.resolve(pmRoot))return failures;const[selectedSettings,workspaceSettings]=await Promise.all([dependencies.readSettings(pmRoot),dependencies.readSettings(workspacePmRoot)]);const[selected,workspace]=await Promise.all([dependencies.loadExtensions({pmRoot,settings:selectedSettings,cwd:process.cwd(),noExtensions:false}),dependencies.loadExtensions({pmRoot:workspacePmRoot,settings:workspaceSettings,cwd:process.cwd(),noExtensions:false})]);const selectedCommands=new Set(selected.loaded.flatMap(entry=>entry.activation?.commands??[]));const missingCommands=[...new Set(workspace.loaded.flatMap(entry=>entry.activation?.commands??[]))].filter(command=>!selectedCommands.has(command)).sort((left,right)=>left.localeCompare(right));if(missingCommands.length===0)return failures;failures.push({layer:"runtime",name:"extension-root-relocation",error:`storage_root=${path.resolve(pmRoot)} extension_discovery_root=${selected.roots.project}; cwd_storage_root=${path.resolve(workspacePmRoot)} cwd_extension_discovery_root=${workspace.roots.project}; the selected --pm-path runtime is missing ${missingCommands.length} workspace command path(s): ${missingCommands.slice(0,8).join(", ")}${missingCommands.length>8?", ...":""}. --pm-path selects extension discovery as well as item storage; omit it, point --pm-path at ${path.resolve(workspacePmRoot)}, or install the extension into the selected tracker with "pm --pm-path ${path.resolve(pmRoot)} install <package> --project".`})}catch{}return failures}export{loadExtensionRecoveryFailures,loadUnknownCommandRecoveryFailures};
 //# sourceMappingURL=extension-recovery.js.map
-//# debugId=f3543bab-fa67-5e91-a700-0cbee84f2dc8