@unbrained/pm-cli 2026.7.1 → 2026.7.3

package/dist/cli-bundle/chunks/{contracts-HN7ABKLP.js → contracts-L6ODXNUM.js}

@@ -90,7 +90,7 @@ import {
   UPGRADE_FLAG_CONTRACTS,
   VALIDATE_FLAG_CONTRACTS,
   compactFlagAliasContracts
-} from "./chunk-MDPEOIGN.js";
+} from "./chunk-RAHINBVP.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -108,7 +108,7 @@ import {
   resolvePmRoot,
   resolveRuntimeFieldRegistry,
   resolveRuntimeStatusRegistry
-} from "./chunk-RVUALSJF.js";
+} from "./chunk-KHVGM5CS.js";
 
 // dist/mcp/tool-definitions.js
 !(function() {
@@ -493,7 +493,7 @@ function buildMcpToolContracts() {
 !(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] = "98b192d1-a27b-513e-8089-5626e03f2be1");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "24d15738-45bd-5dd2-95e1-699f9c6061bd");
   } catch (e2) {
   }
 })();
@@ -844,6 +844,11 @@ function normalizeStringList(values) {
   }
   return normalized;
 }
+function assignExtensionFlagBoolean(contract, key, enabled) {
+  if (enabled) {
+    contract[key] = true;
+  }
+}
 function toExtensionFlagContract(definition) {
   const longName = toOptionalTrimmedString(definition.long);
   const shortName = toOptionalTrimmedString(definition.short);
@@ -857,16 +862,13 @@ function toExtensionFlagContract(definition) {
   if (normalizedShort && normalizedLong) {
     contract.short = normalizedShort;
   }
+  assignExtensionFlagBoolean(contract, "required", definition.required === true);
+  assignExtensionFlagBoolean(contract, "repeatable", definition.repeatable === true);
+  assignExtensionFlagBoolean(contract, "list", definition.list === true);
   const description = toOptionalTrimmedString(definition.description);
   if (description) {
     contract.description = description;
   }
-  if (definition.required === true) {
-    contract.required = true;
-  }
-  if (definition.repeatable === true) {
-    contract.repeatable = true;
-  }
   const valueName = toOptionalTrimmedString(definition.value_name);
   if (valueName) {
     contract.value_name = valueName;
@@ -1010,6 +1012,29 @@ function extensionSchemaPropertyNameFromFlag(flag) {
   const cleaned = camelCased.replace(/[^a-zA-Z0-9]/g, "");
   return cleaned.length > 0 ? cleaned : null;
 }
+function buildExtensionArgumentSchema(argument, action) {
+  if (argument.variadic) {
+    return {
+      type: "array",
+      items: { type: "string" },
+      description: argument.description ?? `Variadic argument '${argument.name}' for extension action '${action}'.`
+    };
+  }
+  return {
+    type: "string",
+    description: argument.description ?? `Argument '${argument.name}' for extension action '${action}'.`
+  };
+}
+function buildExtensionFlagSchema(flag, action) {
+  const valueType = flag.value_type ?? "boolean";
+  const schemaType = valueType === "boolean" ? "boolean" : valueType === "number" ? ["number", "string"] : "string";
+  const acceptsMultipleValues = flag.repeatable === true || flag.list === true;
+  return {
+    type: acceptsMultipleValues ? "array" : schemaType,
+    ...acceptsMultipleValues ? { items: { type: schemaType } } : {},
+    description: flag.description ?? `Extension option '${flag.flag}' for action '${action}'.`
+  };
+}
 function buildExtensionActionSchemaBranch(contract) {
   const commands = contract.command.split("|").map((command) => command.trim()).filter((command) => command.length > 0);
   const properties = {
@@ -1021,18 +1046,7 @@ function buildExtensionActionSchemaBranch(contract) {
   };
   const required = ["action"];
   for (const argument of contract.arguments) {
-    if (argument.variadic) {
-      properties[argument.name] = {
-        type: "array",
-        items: { type: "string" },
-        description: argument.description ?? `Variadic argument '${argument.name}' for extension action '${contract.action}'.`
-      };
-    } else {
-      properties[argument.name] = {
-        type: "string",
-        description: argument.description ?? `Argument '${argument.name}' for extension action '${contract.action}'.`
-      };
-    }
+    properties[argument.name] = buildExtensionArgumentSchema(argument, contract.action);
     if (argument.required) {
       required.push(argument.name);
     }
@@ -1042,13 +1056,7 @@ function buildExtensionActionSchemaBranch(contract) {
     if (!propertyName || properties[propertyName] !== void 0) {
       continue;
     }
-    const valueType = flag.value_type ?? "boolean";
-    const schemaType = valueType === "boolean" ? "boolean" : valueType === "number" ? ["number", "string"] : "string";
-    properties[propertyName] = {
-      type: flag.repeatable ? "array" : schemaType,
-      ...flag.repeatable ? { items: { type: schemaType } } : {},
-      description: flag.description ?? `Extension option '${flag.flag}' for action '${contract.action}'.`
-    };
+    properties[propertyName] = buildExtensionFlagSchema(flag, contract.action);
     if (flag.required === true) {
       required.push(propertyName);
     }
@@ -1470,57 +1478,89 @@ function attachCreateRequiredOptionContracts(schema, metadata) {
     oneOf: enrichedBranches
   };
 }
-async function runContracts(options, global2) {
-  const selectedAction = normalizeToken(options.action);
-  const selectedCommand = normalizeToken(options.command);
+function resolveContractsSelection(options) {
   const schemaOnly = options.schemaOnly === true;
   const flagsOnly = options.flagsOnly === true;
   const availabilityOnly = options.availabilityOnly === true;
   const runtimeOnly = options.runtimeOnly === true;
   const fullOutput = options.full === true;
+  const selectedAction = normalizeToken(options.action);
+  const selectedCommand = normalizeToken(options.command);
   const unfilteredDefaultBriefMode = !fullOutput && !schemaOnly && !flagsOnly && !availabilityOnly && !selectedAction && !selectedCommand;
-  const omitUnfilteredSchema = unfilteredDefaultBriefMode;
-  const omitUnfilteredCommandFlags = unfilteredDefaultBriefMode;
-  const omitUnfilteredCommanderAliases = unfilteredDefaultBriefMode;
-  const projectionFlagsEnabled = [
+  return {
+    selectedAction,
+    selectedCommand,
     schemaOnly,
     flagsOnly,
-    availabilityOnly
+    availabilityOnly,
+    runtimeOnly,
+    fullOutput,
+    omitUnfilteredSchema: unfilteredDefaultBriefMode,
+    omitUnfilteredCommandFlags: unfilteredDefaultBriefMode,
+    omitUnfilteredCommanderAliases: unfilteredDefaultBriefMode
+  };
+}
+function assertSingleContractsProjection(selection) {
+  const projectionFlagsEnabled = [
+    selection.schemaOnly,
+    selection.flagsOnly,
+    selection.availabilityOnly
   ].filter((value) => value).length;
   if (projectionFlagsEnabled > 1) {
     throw new PmCliError("Choose only one projection flag: --schema-only, --flags-only, or --availability-only.", EXIT_CODE.USAGE);
   }
-  const pmRoot = resolvePmRoot(process.cwd(), global2.path);
-  let settings = structuredClone(SETTINGS_DEFAULTS);
+}
+async function readContractsSettings(pmRoot) {
   try {
-    settings = await readSettings(pmRoot);
+    return await readSettings(pmRoot);
   } catch {
-    settings = structuredClone(SETTINGS_DEFAULTS);
+    return structuredClone(SETTINGS_DEFAULTS);
   }
+}
+async function resolveContractsRuntimeContext(global2, pmRoot) {
+  const settings = await readContractsSettings(pmRoot);
   const runtimeProbe = await resolveRuntimeExtensionActionProbe(global2);
   const typeRegistry = resolveItemTypeRegistry(settings, runtimeProbe.registrations ?? getActiveExtensionRegistrations());
-  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
   const runtimeFieldRegistry = resolveRuntimeFieldRegistry(settings.schema);
-  const runtimeFieldFlagMap = buildRuntimeFieldFlagContracts(runtimeFieldRegistry);
-  const createRequiredOptionContracts = buildCreateRequiredOptionContracts(typeRegistry);
   const extensionContracts = collectExtensionCommandContracts(runtimeProbe);
-  const mergedExtensionContracts = mergeExtensionContractsByAction(extensionContracts);
-  const extensionFlagMap = collectExtensionFlagContractsByCommand(runtimeProbe.flagRegistrations);
-  const includePackageOwnedActions = selectedAction !== void 0 && PACKAGE_OWNED_ACTIONS.has(selectedAction) && availabilityOnly || selectedCommand !== void 0 && PACKAGE_OWNED_COMMANDS.has(selectedCommand) && availabilityOnly;
-  const actionDescriptors = collectActionContractDescriptors(mergedExtensionContracts, { includePackageOwnedActions });
-  if (includePackageOwnedActions && selectedCommand !== void 0 && PACKAGE_OWNED_COMMANDS.has(selectedCommand) && !actionDescriptors.some((entry) => entry.command_path === selectedCommand)) {
+  return {
+    settings,
+    runtimeProbe,
+    typeRegistry,
+    statusRegistry: resolveRuntimeStatusRegistry(settings.schema),
+    runtimeFieldRegistry,
+    runtimeFieldFlagMap: buildRuntimeFieldFlagContracts(runtimeFieldRegistry),
+    createRequiredOptionContracts: buildCreateRequiredOptionContracts(typeRegistry),
+    extensionContracts,
+    mergedExtensionContracts: mergeExtensionContractsByAction(extensionContracts),
+    extensionFlagMap: collectExtensionFlagContractsByCommand(runtimeProbe.flagRegistrations)
+  };
+}
+function shouldIncludePackageOwnedActions(selection) {
+  return selection.availabilityOnly && (selection.selectedAction !== void 0 && PACKAGE_OWNED_ACTIONS.has(selection.selectedAction) || selection.selectedCommand !== void 0 && PACKAGE_OWNED_COMMANDS.has(selection.selectedCommand));
+}
+function collectContractsActionDescriptors(selection, mergedExtensionContracts) {
+  const actionDescriptors = collectActionContractDescriptors(mergedExtensionContracts, {
+    includePackageOwnedActions: shouldIncludePackageOwnedActions(selection)
+  });
+  if (shouldIncludePackageOwnedActions(selection) && selection.selectedCommand !== void 0 && PACKAGE_OWNED_COMMANDS.has(selection.selectedCommand) && !actionDescriptors.some((entry) => entry.command_path === selection.selectedCommand)) {
     actionDescriptors.push({
-      action: packageOwnedActionForCommand(selectedCommand),
+      action: packageOwnedActionForCommand(selection.selectedCommand),
       provider: "extension",
       requires_extension: true,
-      command_path: selectedCommand
+      command_path: selection.selectedCommand
     });
   }
+  return actionDescriptors;
+}
+function assertKnownContractsAction(selection, actionDescriptors) {
   const actionNames = new Set(actionDescriptors.map((entry) => entry.action));
-  if (selectedAction && !actionNames.has(selectedAction)) {
-    throw new PmCliError(`Unknown action: "${options.action}".`, EXIT_CODE.USAGE);
+  if (selection.selectedAction && !actionNames.has(selection.selectedAction)) {
+    throw new PmCliError(`Unknown action: "${selection.selectedAction}".`, EXIT_CODE.USAGE);
   }
-  const commandCatalog = [
+}
+function buildContractsCommandCatalog(actionDescriptors, mergedExtensionContracts) {
+  return [
     .../* @__PURE__ */ new Set([
       ...PM_CORE_COMMAND_NAMES.filter((entry) => !PACKAGE_OWNED_COMMANDS.has(entry)),
       ...[...CORE_COMMAND_FLAG_CONTRACTS_BY_COMMAND.keys()].filter((entry) => !PACKAGE_OWNED_COMMANDS.has(entry)),
@@ -1529,66 +1569,103 @@ async function runContracts(options, global2) {
       ...mergedExtensionContracts.flatMap((entry) => entry.command.split("|"))
     ])
   ].map((entry) => normalizeCommandPath(entry)).filter((entry) => entry.length > 0).sort((left, right) => left.localeCompare(right));
-  const commandNames = new Set(commandCatalog);
-  if (selectedCommand && !commandNames.has(selectedCommand)) {
-    const namespaceChildren = commandCatalog.filter((command) => command.startsWith(`${selectedCommand} `));
-    if (namespaceChildren.length > 0) {
-      const displayedNamespaceChildren = namespaceChildren.slice(0, COMMAND_NAMESPACE_DISPLAY_LIMIT);
-      const hiddenNamespaceChildCount = namespaceChildren.length - displayedNamespaceChildren.length;
-      const displayedChildCommandList = hiddenNamespaceChildCount > 0 ? `${displayedNamespaceChildren.join(", ")}, and ${hiddenNamespaceChildCount} more` : displayedNamespaceChildren.join(", ");
-      const fallbackCandidates = namespaceChildren.slice(0, COMMAND_NAMESPACE_FALLBACK_LIMIT);
-      const childCommandExamples = namespaceChildren.slice(0, 5).map((command) => `pm contracts --command "${command}" --flags-only --json`);
-      const suggestedChildCommand = namespaceChildren[0];
-      throw new PmCliError(`Command "${options.command}" is a command namespace. Choose a concrete child command: ${displayedChildCommandList}.`, EXIT_CODE.USAGE, {
-        code: "command_namespace",
-        required: "Use a concrete child command path listed under this namespace.",
-        why: "Command groups expose help at the namespace root, but command flag contracts belong to executable child commands.",
-        examples: childCommandExamples,
-        nextSteps: [
-          `Retry with a child command, for example: ${childCommandExamples[0]}`
-        ],
-        recovery: {
-          suggested_retry: `pm contracts --command "${suggestedChildCommand}" --flags-only --json`,
-          fallback_candidates: fallbackCandidates.map((command) => ({
-            source: "command_namespace",
-            command: `pm contracts --command "${command}" --flags-only --json`,
-            reason: `Child command under ${selectedCommand}`
-          }))
-        }
-      });
+}
+function buildCommandNamespaceError(command, namespaceChildren) {
+  const displayedNamespaceChildren = namespaceChildren.slice(0, COMMAND_NAMESPACE_DISPLAY_LIMIT);
+  const hiddenNamespaceChildCount = namespaceChildren.length - displayedNamespaceChildren.length;
+  const displayedChildCommandList = hiddenNamespaceChildCount > 0 ? `${displayedNamespaceChildren.join(", ")}, and ${hiddenNamespaceChildCount} more` : displayedNamespaceChildren.join(", ");
+  const fallbackCandidates = namespaceChildren.slice(0, COMMAND_NAMESPACE_FALLBACK_LIMIT);
+  const childCommandExamples = namespaceChildren.slice(0, 5).map((childCommand) => `pm contracts --command "${childCommand}" --flags-only --json`);
+  const suggestedChildCommand = namespaceChildren[0];
+  return new PmCliError(`Command "${command}" is a command namespace. Choose a concrete child command: ${displayedChildCommandList}.`, EXIT_CODE.USAGE, {
+    code: "command_namespace",
+    required: "Use a concrete child command path listed under this namespace.",
+    why: "Command groups expose help at the namespace root, but command flag contracts belong to executable child commands.",
+    examples: childCommandExamples,
+    nextSteps: [`Retry with a child command, for example: ${childCommandExamples[0]}`],
+    recovery: {
+      suggested_retry: `pm contracts --command "${suggestedChildCommand}" --flags-only --json`,
+      fallback_candidates: fallbackCandidates.map((childCommand) => ({
+        source: "command_namespace",
+        command: `pm contracts --command "${childCommand}" --flags-only --json`,
+        reason: `Child command under ${command}`
+      }))
     }
-    const packageHint = PACKAGE_OWNED_COMMAND_INSTALL_HINTS.get(selectedCommand);
-    if (packageHint) {
-      throw new PmCliError(`Unknown command: "${options.command}". Command "${selectedCommand}" is provided by the optional "${packageHint}" package. Run "pm install ${packageHint} --project" and retry.`, EXIT_CODE.USAGE, {
-        code: "unknown_command",
-        required: `Install the optional "${packageHint}" package, or choose a command from pm contracts --flags-only --json.`,
-        why: "Command contracts include core commands plus commands registered by active packages and extensions.",
-        examples: [`pm install ${packageHint} --project`, `pm contracts --command ${selectedCommand} --flags-only --json`],
-        nextSteps: [`Install the optional package first: pm install ${packageHint} --project`],
-        recovery: {
-          suggested_retry: `pm install ${packageHint} --project`
-        }
-      });
+  });
+}
+function buildPackageOwnedCommandError(command, packageHint) {
+  return new PmCliError(`Unknown command: "${command}". Command "${command}" is provided by the optional "${packageHint}" package. Run "pm install ${packageHint} --project" and retry.`, EXIT_CODE.USAGE, {
+    code: "unknown_command",
+    required: `Install the optional "${packageHint}" package, or choose a command from pm contracts --flags-only --json.`,
+    why: "Command contracts include core commands plus commands registered by active packages and extensions.",
+    examples: [`pm install ${packageHint} --project`, `pm contracts --command ${command} --flags-only --json`],
+    nextSteps: [`Install the optional package first: pm install ${packageHint} --project`],
+    recovery: {
+      suggested_retry: `pm install ${packageHint} --project`
     }
-    throw new PmCliError(`Unknown command: "${options.command}".`, EXIT_CODE.USAGE, {
-      code: "unknown_command",
-      required: "Use a command path listed by pm contracts --flags-only --json.",
-      why: "Command contracts are generated from the active core, package, and extension command registry.",
-      examples: ["pm contracts --flags-only --json", "pm --help"],
-      nextSteps: ["Verify spelling and active packages/extensions, then rerun with a known command path."],
-      recovery: {
-        suggested_retry: "pm contracts --flags-only --json"
-      }
-    });
+  });
+}
+function buildUnknownCommandError(command) {
+  return new PmCliError(`Unknown command: "${command}".`, EXIT_CODE.USAGE, {
+    code: "unknown_command",
+    required: "Use a command path listed by pm contracts --flags-only --json.",
+    why: "Command contracts are generated from the active core, package, and extension command registry.",
+    examples: ["pm contracts --flags-only --json", "pm --help"],
+    nextSteps: ["Verify spelling and active packages/extensions, then rerun with a known command path."],
+    recovery: {
+      suggested_retry: "pm contracts --flags-only --json"
+    }
+  });
+}
+function assertKnownContractsCommand(selection, commandCatalog) {
+  if (!selection.selectedCommand) {
+    return;
   }
-  const selectedPackageOwnedAction = selectedCommand ? PACKAGE_OWNED_COMMAND_ACTIONS.get(selectedCommand) : void 0;
-  const commandScopedDescriptors = selectedCommand ? actionDescriptors.filter((descriptor) => selectedPackageOwnedAction ? descriptor.action === selectedPackageOwnedAction : actionDescriptorMatchesSelectedCommand(descriptor, selectedCommand)) : actionDescriptors;
-  if (selectedCommand && selectedAction && !commandScopedDescriptors.some((descriptor) => descriptor.action === selectedAction)) {
-    throw new PmCliError(`Action "${options.action}" is not mapped to command "${options.command}" in contracts output.`, EXIT_CODE.USAGE);
+  const commandNames = new Set(commandCatalog);
+  if (commandNames.has(selection.selectedCommand)) {
+    return;
   }
-  const schema = PM_TOOL_PARAMETERS_SCHEMA;
-  const schemaBranches = extractActionBranches(schema);
-  const schemaActionSet = new Set(schemaBranches.map((entry) => {
+  const namespaceChildren = commandCatalog.filter((command) => command.startsWith(`${selection.selectedCommand} `));
+  if (namespaceChildren.length > 0) {
+    throw buildCommandNamespaceError(selection.selectedCommand, namespaceChildren);
+  }
+  const packageHint = PACKAGE_OWNED_COMMAND_INSTALL_HINTS.get(selection.selectedCommand);
+  if (packageHint) {
+    throw buildPackageOwnedCommandError(selection.selectedCommand, packageHint);
+  }
+  throw buildUnknownCommandError(selection.selectedCommand);
+}
+function resolveContractsActionContext(selection, runtime) {
+  const actionDescriptors = collectContractsActionDescriptors(selection, runtime.mergedExtensionContracts);
+  assertKnownContractsAction(selection, actionDescriptors);
+  const commandCatalog = buildContractsCommandCatalog(actionDescriptors, runtime.mergedExtensionContracts);
+  assertKnownContractsCommand(selection, commandCatalog);
+  const selectedPackageOwnedAction = selection.selectedCommand ? PACKAGE_OWNED_COMMAND_ACTIONS.get(selection.selectedCommand) : void 0;
+  const commandScopedDescriptors = selection.selectedCommand ? actionDescriptors.filter((descriptor) => selectedPackageOwnedAction ? descriptor.action === selectedPackageOwnedAction : actionDescriptorMatchesSelectedCommand(descriptor, selection.selectedCommand)) : actionDescriptors;
+  if (selection.selectedCommand && selection.selectedAction && !commandScopedDescriptors.some((descriptor) => descriptor.action === selection.selectedAction)) {
+    throw new PmCliError(`Action "${selection.selectedAction}" is not mapped to command "${selection.selectedCommand}" in contracts output.`, EXIT_CODE.USAGE);
+  }
+  const scopedActionDescriptors = selection.selectedAction ? commandScopedDescriptors.filter((descriptor) => descriptor.action === selection.selectedAction) : commandScopedDescriptors;
+  const allActionAvailability = [
+    ...new Map(scopedActionDescriptors.map((descriptor) => resolveActionAvailability(descriptor, runtime.runtimeProbe)).map((entry) => [
+      /* c8 ignore next -- keyed dedupe by action|path is covered by runtime policy integration tests. */
+      selectedPackageOwnedAction ? entry.action : `${entry.action}|${entry.command_path ?? ""}`,
+      entry
+    ])).values()
+  ];
+  const actionAvailability = selection.runtimeOnly && !selection.selectedAction && !selection.availabilityOnly ? allActionAvailability.filter((entry) => entry.invocable) : allActionAvailability;
+  return {
+    actionDescriptors,
+    commandCatalog,
+    commandScopedDescriptors,
+    scopedActionDescriptors,
+    selectedPackageOwnedAction,
+    actionAvailability,
+    actions: [...new Set(actionAvailability.map((entry) => entry.action))]
+  };
+}
+function buildSchemaActionSet(schema) {
+  return new Set(extractActionBranches(schema).map((entry) => {
     const properties = entry.properties;
     if (typeof properties !== "object" || properties === null) {
       return null;
@@ -1600,113 +1677,157 @@ async function runContracts(options, global2) {
     const actionConst = actionProperty.const;
     return typeof actionConst === "string" ? actionConst : null;
   }).filter((entry) => entry !== null));
+}
+function buildMergedContractsSchema(mergedExtensionContracts) {
+  const schema = PM_TOOL_PARAMETERS_SCHEMA;
+  const schemaBranches = extractActionBranches(schema);
+  const schemaActionSet = buildSchemaActionSet(schema);
   const extensionBranches = mergedExtensionContracts.filter((contract) => !schemaActionSet.has(contract.action)).map((contract) => buildExtensionActionSchemaBranch(contract));
-  const mergedSchema = extensionBranches.length > 0 ? {
+  return extensionBranches.length > 0 ? {
     ...schema,
     oneOf: [...schemaBranches, ...extensionBranches]
   } : schema;
-  const scopedActionDescriptors = selectedAction ? commandScopedDescriptors.filter((descriptor) => descriptor.action === selectedAction) : commandScopedDescriptors;
-  const allActionAvailability = [
-    ...new Map(scopedActionDescriptors.map((descriptor) => resolveActionAvailability(descriptor, runtimeProbe)).map((entry) => [
-      /* c8 ignore next -- keyed dedupe by action|path is covered by runtime policy integration tests. */
-      selectedPackageOwnedAction ? entry.action : `${entry.action}|${entry.command_path ?? ""}`,
-      entry
-    ])).values()
-  ];
-  const actionAvailability = runtimeOnly && !selectedAction && !availabilityOnly ? allActionAvailability.filter((entry) => entry.invocable) : allActionAvailability;
-  const actions = [...new Set(actionAvailability.map((entry) => entry.action))];
-  const descriptorActionSet = new Set(actionDescriptors.map((descriptor) => descriptor.action));
-  let filteredSchema = selectedAction ? filterSchemaByAction(mergedSchema, selectedAction) : selectedCommand ? filterSchemaByActions(mergedSchema, new Set(scopedActionDescriptors.map((descriptor) => descriptor.action))) : filterSchemaByActions(mergedSchema, descriptorActionSet);
-  if (runtimeOnly && !selectedAction) {
-    filteredSchema = filterSchemaByActions(filteredSchema, new Set(actions));
-  }
-  const includeSchemaSurface = !flagsOnly && !availabilityOnly;
-  if (includeSchemaSurface) {
-    filteredSchema = attachCreateRequiredOptionContracts(filteredSchema, createRequiredOptionContracts);
-  }
-  const commands = selectedCommand !== void 0 ? [selectedCommand] : selectedAction ? resolveScopedCommandsFromActionDescriptors(scopedActionDescriptors, commandCatalog) : commandCatalog;
-  const outputCommands = flagsOnly && selectedCommand === void 0 && selectedAction === void 0 ? compactCommandAliasSurface(commands) : commands;
-  const commandAliases = buildCommandAliasSurface(commands);
-  const extensionCommandContracts = selectedCommand ? extensionContracts.filter((entry) => entry.command === selectedCommand) : selectedAction ? extensionContracts.filter((entry) => outputCommands.includes(normalizeCommandPath(entry.command))) : extensionContracts;
-  const includeRuntimeContractSections = !(flagsOnly && !fullOutput);
-  const result = {
+}
+function filterContractsSchema(selection, actionContext, mergedSchema) {
+  const descriptorActionSet = new Set(actionContext.actionDescriptors.map((descriptor) => descriptor.action));
+  const filteredSchema = selection.selectedAction ? filterSchemaByAction(mergedSchema, selection.selectedAction) : selection.selectedCommand ? filterSchemaByActions(mergedSchema, new Set(actionContext.scopedActionDescriptors.map((descriptor) => descriptor.action))) : filterSchemaByActions(mergedSchema, descriptorActionSet);
+  return selection.runtimeOnly && !selection.selectedAction ? filterSchemaByActions(filteredSchema, new Set(actionContext.actions)) : filteredSchema;
+}
+function resolveContractsSchemaContext(selection, runtime, actionContext) {
+  const mergedSchema = buildMergedContractsSchema(runtime.mergedExtensionContracts);
+  const includeSchemaSurface = !selection.flagsOnly && !selection.availabilityOnly;
+  const filteredSchema = includeSchemaSurface ? attachCreateRequiredOptionContracts(filterContractsSchema(selection, actionContext, mergedSchema), runtime.createRequiredOptionContracts) : filterContractsSchema(selection, actionContext, mergedSchema);
+  return { mergedSchema, filteredSchema };
+}
+function resolveContractsCommands(selection, actionContext) {
+  if (selection.selectedCommand !== void 0) {
+    return [selection.selectedCommand];
+  }
+  if (selection.selectedAction) {
+    return resolveScopedCommandsFromActionDescriptors(actionContext.scopedActionDescriptors, actionContext.commandCatalog);
+  }
+  return actionContext.commandCatalog;
+}
+function resolveOutputCommands(selection, commands) {
+  return selection.flagsOnly && selection.selectedCommand === void 0 && selection.selectedAction === void 0 ? compactCommandAliasSurface(commands) : commands;
+}
+function resolveExtensionCommandContracts(selection, runtime, outputCommands) {
+  if (selection.selectedCommand) {
+    return runtime.extensionContracts.filter((entry) => splitCommandPathAliases(entry.command).includes(selection.selectedCommand));
+  }
+  if (selection.selectedAction) {
+    const outputCommandSet = new Set(outputCommands);
+    return runtime.extensionContracts.filter((entry) => splitCommandPathAliases(entry.command).some((command) => outputCommandSet.has(command)));
+  }
+  return runtime.extensionContracts;
+}
+function createContractsResult(selection, schemaContext, actionContext, outputCommands) {
+  return {
     schema_version: (
       /* c8 ignore next -- schema version/id fallbacks are exercised by schema snapshot tests. */
-      typeof mergedSchema["x-schema-version"] === "string" ? mergedSchema["x-schema-version"] : null
+      typeof schemaContext.mergedSchema["x-schema-version"] === "string" ? schemaContext.mergedSchema["x-schema-version"] : null
     ),
     schema_id: (
       /* c8 ignore next -- schema version/id fallbacks are exercised by schema snapshot tests. */
-      typeof mergedSchema.$id === "string" ? mergedSchema.$id : null
+      typeof schemaContext.mergedSchema.$id === "string" ? schemaContext.mergedSchema.$id : null
     ),
     selected: {
-      action: selectedAction ?? null,
-      command: selectedCommand ?? null,
-      schema_only: schemaOnly,
-      flags_only: flagsOnly,
-      availability_only: availabilityOnly,
-      runtime_only: runtimeOnly,
-      command_scoped: selectedCommand !== void 0
+      action: selection.selectedAction ?? null,
+      command: selection.selectedCommand ?? null,
+      schema_only: selection.schemaOnly,
+      flags_only: selection.flagsOnly,
+      availability_only: selection.availabilityOnly,
+      runtime_only: selection.runtimeOnly,
+      command_scoped: selection.selectedCommand !== void 0
     },
-    commands: outputCommands
+    commands: outputCommands,
+    ...!selection.flagsOnly ? {
+      actions: actionContext.actions,
+      action_availability: actionContext.actionAvailability
+    } : {}
   };
-  if (includeRuntimeContractSections) {
-    result.runtime_schema = {
-      statuses: statusRegistry.definitions.map((definition) => definition.id),
-      open_status: statusRegistry.open_status,
-      close_status: statusRegistry.close_status,
-      canceled_status: statusRegistry.canceled_status,
-      types: [...typeRegistry.types],
-      fields_by_command: Object.fromEntries([...runtimeFieldRegistry.command_to_fields.entries()].map(([command, definitions]) => [
-        command,
-        [
-          ...new Set(definitions.map((definition) => `--${definition.cli_flag}`))
-        ].sort((left, right) => left.localeCompare(right))
-      ]))
-    };
-    result.extension_contracts = {
-      capabilities: [...PM_EXTENSION_CAPABILITY_CONTRACTS],
-      services: [...PM_EXTENSION_SERVICE_NAME_CONTRACTS],
-      policy_modes: [...PM_EXTENSION_POLICY_MODE_CONTRACTS],
-      policy_surfaces: [...PM_EXTENSION_POLICY_SURFACE_CONTRACTS],
-      trust_modes: [...PM_EXTENSION_TRUST_MODE_CONTRACTS],
-      sandbox_profiles: [...PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS],
-      manifest_versions: [1, 2],
-      compatibility: {
-        current: "v2",
-        previous: ["v1"],
-        breaking_strategy: "versioned_breaking"
-      }
-    };
-  }
-  if (!flagsOnly) {
-    result.actions = actions;
-    result.action_availability = actionAvailability;
+}
+function attachRuntimeContractsResult(result, runtime) {
+  result.runtime_schema = {
+    statuses: runtime.statusRegistry.definitions.map((definition) => definition.id),
+    open_status: runtime.statusRegistry.open_status,
+    close_status: runtime.statusRegistry.close_status,
+    canceled_status: runtime.statusRegistry.canceled_status,
+    types: [...runtime.typeRegistry.types],
+    fields_by_command: Object.fromEntries([...runtime.runtimeFieldRegistry.command_to_fields.entries()].map(([command, definitions]) => [
+      command,
+      [...new Set(definitions.map((definition) => `--${definition.cli_flag}`))].sort((left, right) => left.localeCompare(right))
+    ]))
+  };
+  result.extension_contracts = {
+    capabilities: [...PM_EXTENSION_CAPABILITY_CONTRACTS],
+    services: [...PM_EXTENSION_SERVICE_NAME_CONTRACTS],
+    policy_modes: [...PM_EXTENSION_POLICY_MODE_CONTRACTS],
+    policy_surfaces: [...PM_EXTENSION_POLICY_SURFACE_CONTRACTS],
+    trust_modes: [...PM_EXTENSION_TRUST_MODE_CONTRACTS],
+    sandbox_profiles: [...PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS],
+    manifest_versions: [1, 2],
+    compatibility: {
+      current: "v2",
+      previous: ["v1"],
+      breaking_strategy: "versioned_breaking"
+    }
+  };
+}
+function attachSchemaContractsResult(result, selection, schemaContext, extensionCommandContracts) {
+  if (selection.flagsOnly || selection.availabilityOnly) {
+    return;
   }
-  if (includeSchemaSurface && !omitUnfilteredSchema) {
-    result.schema = filteredSchema;
-    result.extension_commands = extensionCommandContracts;
-  } else if (includeSchemaSurface && omitUnfilteredSchema) {
-    result.schema_omitted_reason = "unfiltered_default_brief";
+  if (!selection.omitUnfilteredSchema) {
+    result.schema = schemaContext.filteredSchema;
     result.extension_commands = extensionCommandContracts;
+    return;
   }
-  if (!schemaOnly && !availabilityOnly) {
-    if (!omitUnfilteredCommandFlags) {
-      result.command_flags = buildCommandFlagSurface(outputCommands, extensionFlagMap, runtimeFieldFlagMap);
-    } else {
-      result.command_flags_omitted_reason = "unfiltered_default_brief";
-    }
-    if (commandAliases.length > 0) {
-      result.command_aliases = commandAliases;
-    }
+  result.schema_omitted_reason = "unfiltered_default_brief";
+  result.extension_commands = extensionCommandContracts;
+}
+function attachFlagContractsResult(result, selection, runtime, outputCommands, commandAliases) {
+  if (selection.schemaOnly || selection.availabilityOnly) {
+    return;
   }
-  if (!schemaOnly && !flagsOnly && !availabilityOnly) {
-    if (!omitUnfilteredCommanderAliases) {
-      result.commander_aliases = buildCommanderAliasSurface();
-    } else {
-      result.commander_aliases_omitted_reason = "unfiltered_default_brief";
-    }
+  if (!selection.omitUnfilteredCommandFlags) {
+    result.command_flags = buildCommandFlagSurface(outputCommands, runtime.extensionFlagMap, runtime.runtimeFieldFlagMap);
+  } else {
+    result.command_flags_omitted_reason = "unfiltered_default_brief";
+  }
+  if (commandAliases.length > 0) {
+    result.command_aliases = commandAliases;
   }
-  if (fullOutput && !schemaOnly && !flagsOnly && !availabilityOnly) {
+}
+function attachCommanderAliasContractsResult(result, selection) {
+  if (selection.schemaOnly || selection.flagsOnly || selection.availabilityOnly) {
+    return;
+  }
+  if (!selection.omitUnfilteredCommanderAliases) {
+    result.commander_aliases = buildCommanderAliasSurface();
+    return;
+  }
+  result.commander_aliases_omitted_reason = "unfiltered_default_brief";
+}
+async function runContracts(options, global2) {
+  const selection = resolveContractsSelection(options);
+  assertSingleContractsProjection(selection);
+  const pmRoot = resolvePmRoot(process.cwd(), global2.path);
+  const runtime = await resolveContractsRuntimeContext(global2, pmRoot);
+  const actionContext = resolveContractsActionContext(selection, runtime);
+  const schemaContext = resolveContractsSchemaContext(selection, runtime, actionContext);
+  const commands = resolveContractsCommands(selection, actionContext);
+  const outputCommands = resolveOutputCommands(selection, commands);
+  const commandAliases = buildCommandAliasSurface(commands);
+  const extensionCommandContracts = resolveExtensionCommandContracts(selection, runtime, outputCommands);
+  const result = createContractsResult(selection, schemaContext, actionContext, outputCommands);
+  if (!(selection.flagsOnly && !selection.fullOutput)) {
+    attachRuntimeContractsResult(result, runtime);
+  }
+  attachSchemaContractsResult(result, selection, schemaContext, extensionCommandContracts);
+  attachFlagContractsResult(result, selection, runtime, outputCommands, commandAliases);
+  attachCommanderAliasContractsResult(result, selection);
+  if (selection.fullOutput && !selection.schemaOnly && !selection.flagsOnly && !selection.availabilityOnly) {
     result.mcp_tools = buildMcpToolContracts();
   }
   return result;
@@ -1741,4 +1862,4 @@ export {
   _testOnlyContractsCommand,
   runContracts
 };
-//# sourceMappingURL=contracts-HN7ABKLP.js.map
+//# sourceMappingURL=contracts-L6ODXNUM.js.map