@unbrained/pm-cli 2026.5.2 → 2026.5.3-6

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

@@ -0,0 +1,389 @@
+export function normalizeExtensionCommandPath(commandPath) {
+    return commandPath
+        .trim()
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((part) => part.length > 0)
+        .join(" ");
+}
+function toNonEmptyFlagString(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function toOptionalBoolean(value) {
+    return typeof value === "boolean" ? value : undefined;
+}
+function formatDynamicExtensionFlagHelpLine(definition) {
+    const visible = toOptionalBoolean(definition.visible);
+    if (visible === false) {
+        return null;
+    }
+    const longName = toNonEmptyFlagString(definition.long);
+    if (!longName || !longName.startsWith("--") || longName.length < 3) {
+        return null;
+    }
+    const shortName = toNonEmptyFlagString(definition.short);
+    const shortPrefix = shortName && shortName.startsWith("-") && !shortName.startsWith("--") ? `${shortName}, ` : "";
+    const valueName = toNonEmptyFlagString(definition.value_name);
+    const valueSuffix = valueName ? ` <${valueName}>` : "";
+    const description = toNonEmptyFlagString(definition.description) ?? "Extension-provided option.";
+    const markers = [];
+    if (toOptionalBoolean(definition.required) === true) {
+        markers.push("required");
+    }
+    if (toOptionalBoolean(definition.enabled) === false) {
+        markers.push("disabled");
+    }
+    const markerSuffix = markers.length > 0 ? ` [${markers.join(", ")}]` : "";
+    return `${shortPrefix}${longName}${valueSuffix}  ${description}${markerSuffix}`;
+}
+function buildDynamicExtensionFlagHelp(definitions) {
+    const lines = [
+        ...new Set(definitions
+            .map(formatDynamicExtensionFlagHelpLine)
+            .filter((line) => line !== null)),
+    ].sort((left, right) => left.localeCompare(right));
+    if (lines.length === 0) {
+        return null;
+    }
+    return `\nExtension-provided flags:\n  ${lines.join("\n  ")}`;
+}
+export function collectDynamicExtensionFlagHelpByCommand(registrations) {
+    const grouped = new Map();
+    for (const registration of registrations) {
+        const commandPath = normalizeExtensionCommandPath(registration.target_command);
+        if (commandPath.length === 0) {
+            continue;
+        }
+        const existing = grouped.get(commandPath) ?? [];
+        existing.push(...registration.flags);
+        grouped.set(commandPath, existing);
+    }
+    const entries = [...grouped.entries()].sort(([left], [right]) => left.localeCompare(right));
+    const helpByCommand = new Map();
+    for (const [commandPath, definitions] of entries) {
+        const helpText = buildDynamicExtensionFlagHelp(definitions);
+        if (!helpText) {
+            continue;
+        }
+        helpByCommand.set(commandPath, helpText);
+    }
+    return helpByCommand;
+}
+function normalizeExtensionCommandAction(commandPath, action) {
+    if (typeof action !== "string" || action.trim().length === 0) {
+        return commandPath.replace(/\s+/g, "-");
+    }
+    return action.trim().toLowerCase();
+}
+function normalizeExtensionCommandStringList(values) {
+    if (!Array.isArray(values)) {
+        return [];
+    }
+    const normalized = [];
+    const seen = new Set();
+    for (const value of values) {
+        if (typeof value !== "string") {
+            continue;
+        }
+        const trimmed = value.trim();
+        if (trimmed.length === 0 || seen.has(trimmed)) {
+            continue;
+        }
+        seen.add(trimmed);
+        normalized.push(trimmed);
+    }
+    return normalized;
+}
+function normalizeExtensionCommandArguments(values) {
+    if (!Array.isArray(values)) {
+        return [];
+    }
+    return values
+        .map((value) => {
+        const name = typeof value.name === "string" ? value.name.trim() : "";
+        if (name.length === 0) {
+            return null;
+        }
+        const normalized = {
+            name,
+            required: value.required === true,
+            variadic: value.variadic === true,
+        };
+        if (typeof value.description === "string" && value.description.trim().length > 0) {
+            normalized.description = value.description.trim();
+        }
+        return normalized;
+    })
+        .filter((entry) => entry !== null);
+}
+export function collectExtensionCommandHelpDescriptors(commandHandlers, commandDefinitions, flagRegistrations) {
+    const definitionsByCommand = new Map();
+    for (const definition of commandDefinitions) {
+        const commandPath = normalizeExtensionCommandPath(definition.command);
+        if (commandPath.length === 0) {
+            continue;
+        }
+        const description = typeof definition.description === "string" && definition.description.trim().length > 0
+            ? definition.description.trim()
+            : undefined;
+        const intent = typeof definition.intent === "string" && definition.intent.trim().length > 0
+            ? definition.intent.trim()
+            : undefined;
+        definitionsByCommand.set(commandPath, {
+            command: commandPath,
+            action: normalizeExtensionCommandAction(commandPath, definition.action),
+            description,
+            intent,
+            examples: normalizeExtensionCommandStringList(definition.examples),
+            failure_hints: normalizeExtensionCommandStringList(definition.failure_hints),
+            arguments: normalizeExtensionCommandArguments(definition.arguments),
+            flags: [],
+            source: {
+                layer: definition.layer,
+                name: definition.name,
+            },
+        });
+    }
+    const flagsByCommand = new Map();
+    for (const registration of flagRegistrations) {
+        const commandPath = normalizeExtensionCommandPath(registration.target_command);
+        if (commandPath.length === 0) {
+            continue;
+        }
+        const existing = flagsByCommand.get(commandPath) ?? [];
+        existing.push(...registration.flags);
+        flagsByCommand.set(commandPath, existing);
+    }
+    const commandSet = new Set();
+    for (const commandPath of commandHandlers) {
+        const normalized = normalizeExtensionCommandPath(commandPath);
+        if (normalized.length > 0) {
+            commandSet.add(normalized);
+        }
+    }
+    for (const commandPath of definitionsByCommand.keys()) {
+        commandSet.add(commandPath);
+    }
+    for (const commandPath of flagsByCommand.keys()) {
+        commandSet.add(commandPath);
+    }
+    const descriptors = new Map();
+    const sortedCommands = [...commandSet].sort((left, right) => left.localeCompare(right));
+    for (const commandPath of sortedCommands) {
+        const definition = definitionsByCommand.get(commandPath);
+        const flags = flagsByCommand.get(commandPath) ?? [];
+        if (definition) {
+            descriptors.set(commandPath, {
+                ...definition,
+                flags,
+            });
+            continue;
+        }
+        descriptors.set(commandPath, {
+            command: commandPath,
+            action: normalizeExtensionCommandAction(commandPath, undefined),
+            examples: [],
+            failure_hints: [],
+            arguments: [],
+            flags,
+        });
+    }
+    return descriptors;
+}
+function buildExtensionArgumentToken(argument) {
+    const variadicSuffix = argument.variadic ? "..." : "";
+    if (argument.required) {
+        return `<${argument.name}${variadicSuffix}>`;
+    }
+    return `[${argument.name}${variadicSuffix}]`;
+}
+export function applyDynamicExtensionArguments(command, descriptor) {
+    for (const argument of descriptor.arguments) {
+        command.argument(buildExtensionArgumentToken(argument), argument.description ?? "Extension argument.");
+    }
+}
+function formatDynamicExtensionOptionFlags(definition) {
+    const visible = toOptionalBoolean(definition.visible);
+    if (visible === false) {
+        return null;
+    }
+    const longName = toNonEmptyFlagString(definition.long);
+    const shortName = toNonEmptyFlagString(definition.short);
+    const normalizedShort = shortName && shortName.startsWith("-") && !shortName.startsWith("--") ? shortName : null;
+    const normalizedLong = longName && longName.startsWith("--") && longName.length > 2 ? longName : null;
+    if (!normalizedLong && !normalizedShort) {
+        return null;
+    }
+    const optionValueName = toNonEmptyFlagString(definition.value_name);
+    const optionValueSuffix = optionValueName ? ` <${optionValueName}>` : "";
+    const optionNames = [normalizedShort, normalizedLong].filter((entry) => entry !== null);
+    return `${optionNames.join(", ")}${optionValueSuffix}`;
+}
+function formatDynamicExtensionOptionDescription(definition) {
+    const description = toNonEmptyFlagString(definition.description) ?? "Extension-provided option.";
+    const markers = [];
+    if (toOptionalBoolean(definition.required) === true) {
+        markers.push("required");
+    }
+    if (toOptionalBoolean(definition.enabled) === false) {
+        markers.push("disabled");
+    }
+    const markerSuffix = markers.length > 0 ? ` [${markers.join(", ")}]` : "";
+    return `${description}${markerSuffix}`;
+}
+export function applyDynamicExtensionOptions(command, descriptor) {
+    const seen = new Set();
+    for (const definition of descriptor.flags) {
+        const optionFlags = formatDynamicExtensionOptionFlags(definition);
+        if (!optionFlags || seen.has(optionFlags)) {
+            continue;
+        }
+        seen.add(optionFlags);
+        command.option(optionFlags, formatDynamicExtensionOptionDescription(definition));
+    }
+}
+function buildDynamicExtensionHelpOptionSummary(definition) {
+    const flags = formatDynamicExtensionOptionFlags(definition);
+    if (!flags) {
+        return null;
+    }
+    const longName = toNonEmptyFlagString(definition.long);
+    const shortName = toNonEmptyFlagString(definition.short);
+    const normalizedLong = longName && longName.startsWith("--") && longName.length > 2 ? longName : null;
+    const normalizedShort = shortName && shortName.startsWith("-") && !shortName.startsWith("--") ? shortName : null;
+    const valueName = toNonEmptyFlagString(definition.value_name);
+    const required = toOptionalBoolean(definition.required) === true;
+    return {
+        flags,
+        long: normalizedLong,
+        short: normalizedShort,
+        description: formatDynamicExtensionOptionDescription(definition),
+        takes_value: valueName !== null,
+        value_required: valueName !== null,
+        value_name: valueName,
+        variadic: false,
+        required,
+        aliases: [],
+        alias_for: null,
+    };
+}
+export function buildDynamicExtensionHelpOptionSummaries(descriptor) {
+    if (!descriptor) {
+        return [];
+    }
+    const summaries = [];
+    const seen = new Set();
+    for (const definition of descriptor.flags) {
+        const summary = buildDynamicExtensionHelpOptionSummary(definition);
+        if (!summary || seen.has(summary.flags)) {
+            continue;
+        }
+        seen.add(summary.flags);
+        summaries.push(summary);
+    }
+    return summaries;
+}
+export function mergeHelpOptionSummaries(base, extension) {
+    if (extension.length === 0) {
+        return base;
+    }
+    const merged = [...base];
+    const seen = new Set(base.map((entry) => entry.flags));
+    for (const entry of extension) {
+        if (seen.has(entry.flags)) {
+            continue;
+        }
+        seen.add(entry.flags);
+        merged.push(entry);
+    }
+    return merged;
+}
+export function buildDynamicExtensionCommandMetadataHelp(descriptor) {
+    const lines = [];
+    if (descriptor.intent) {
+        lines.push(`Intent: ${descriptor.intent}`);
+    }
+    if (descriptor.action) {
+        lines.push(`Action contract: ${descriptor.action}`);
+    }
+    if (descriptor.examples.length > 0) {
+        lines.push("Examples:");
+        for (const example of descriptor.examples) {
+            lines.push(`  - ${example}`);
+        }
+    }
+    if (descriptor.failure_hints.length > 0) {
+        lines.push("Common failure hints:");
+        for (const hint of descriptor.failure_hints) {
+            lines.push(`  - ${hint}`);
+        }
+    }
+    if (lines.length === 0) {
+        return null;
+    }
+    return `\nExtension command metadata:\n  ${lines.join("\n  ")}`;
+}
+export function commandAliases(command) {
+    const commandRecord = command;
+    if (typeof commandRecord.aliases === "function") {
+        return commandRecord.aliases().map((value) => value.trim().toLowerCase()).filter((value) => value.length > 0);
+    }
+    if (typeof commandRecord.alias === "function") {
+        const alias = commandRecord.alias();
+        if (typeof alias === "string" && alias.trim().length > 0) {
+            return [alias.trim().toLowerCase()];
+        }
+    }
+    if (Array.isArray(commandRecord._aliases)) {
+        return commandRecord._aliases.map((value) => value.trim().toLowerCase()).filter((value) => value.length > 0);
+    }
+    return [];
+}
+export function findDirectChildCommand(parent, name) {
+    const normalizedTarget = name.trim().toLowerCase();
+    return (parent.commands.find((entry) => {
+        if (entry.name().trim().toLowerCase() === normalizedTarget) {
+            return true;
+        }
+        return commandAliases(entry).includes(normalizedTarget);
+    }) ?? null);
+}
+export function findCommandByPath(root, pathParts) {
+    let current = root;
+    for (const part of pathParts) {
+        const next = findDirectChildCommand(current, part);
+        if (!next) {
+            return null;
+        }
+        current = next;
+    }
+    return current;
+}
+export function ensureCommandPath(root, pathParts) {
+    if (pathParts.length === 0) {
+        return null;
+    }
+    let current = root;
+    for (let index = 0; index < pathParts.length; index += 1) {
+        const part = pathParts[index];
+        const existing = findDirectChildCommand(current, part);
+        if (existing) {
+            current = existing;
+            continue;
+        }
+        const created = current.command(part);
+        if (index < pathParts.length - 1) {
+            created.description("Extension-provided command group.");
+        }
+        else {
+            created.description("Extension-provided command path.");
+        }
+        current = created;
+    }
+    return current;
+}
+//# sourceMappingURL=extension-command-help.js.map

package/dist/cli/extension-command-help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-command-help.js","sourceRoot":"/","sources":["cli/extension-command-help.ts"],"names":[],"mappings":"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","sourcesContent":["import { Command } from \"commander\";\nimport type {\n  RegisteredExtensionCommandDefinition,\n  RegisteredExtensionFlagDefinitions,\n} from \"../core/extensions/index.js\";\n\nexport interface ExtensionCommandArgumentHelpDescriptor {\n  name: string;\n  required: boolean;\n  variadic: boolean;\n  description?: string;\n}\n\nexport interface ExtensionCommandHelpDescriptor {\n  command: string;\n  action: string;\n  description?: string;\n  intent?: string;\n  examples: string[];\n  failure_hints: string[];\n  arguments: ExtensionCommandArgumentHelpDescriptor[];\n  flags: Array<Record<string, unknown>>;\n  source?: {\n    layer: \"global\" | \"project\";\n    name: string;\n  };\n}\n\nexport interface HelpOptionSummary {\n  flags: string;\n  long: string | null;\n  short: string | null;\n  description: string;\n  takes_value: boolean;\n  value_required: boolean;\n  value_name: string | null;\n  variadic: boolean;\n  required: boolean;\n  aliases: string[];\n  alias_for: string | null;\n  default_value?: unknown;\n}\n\nexport function normalizeExtensionCommandPath(commandPath: string): string {\n  return commandPath\n    .trim()\n    .toLowerCase()\n    .split(/\\s+/)\n    .filter((part) => part.length > 0)\n    .join(\" \");\n}\n\nfunction toNonEmptyFlagString(value: unknown): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction toOptionalBoolean(value: unknown): boolean | undefined {\n  return typeof value === \"boolean\" ? value : undefined;\n}\n\nfunction formatDynamicExtensionFlagHelpLine(definition: Record<string, unknown>): string | null {\n  const visible = toOptionalBoolean(definition.visible);\n  if (visible === false) {\n    return null;\n  }\n  const longName = toNonEmptyFlagString(definition.long);\n  if (!longName || !longName.startsWith(\"--\") || longName.length < 3) {\n    return null;\n  }\n\n  const shortName = toNonEmptyFlagString(definition.short);\n  const shortPrefix = shortName && shortName.startsWith(\"-\") && !shortName.startsWith(\"--\") ? `${shortName}, ` : \"\";\n  const valueName = toNonEmptyFlagString(definition.value_name);\n  const valueSuffix = valueName ? ` <${valueName}>` : \"\";\n  const description = toNonEmptyFlagString(definition.description) ?? \"Extension-provided option.\";\n  const markers: string[] = [];\n  if (toOptionalBoolean(definition.required) === true) {\n    markers.push(\"required\");\n  }\n  if (toOptionalBoolean(definition.enabled) === false) {\n    markers.push(\"disabled\");\n  }\n  const markerSuffix = markers.length > 0 ? ` [${markers.join(\", \")}]` : \"\";\n  return `${shortPrefix}${longName}${valueSuffix}  ${description}${markerSuffix}`;\n}\n\nfunction buildDynamicExtensionFlagHelp(definitions: Array<Record<string, unknown>>): string | null {\n  const lines = [\n    ...new Set(\n      definitions\n        .map(formatDynamicExtensionFlagHelpLine)\n        .filter((line): line is string => line !== null),\n    ),\n  ].sort((left, right) => left.localeCompare(right));\n  if (lines.length === 0) {\n    return null;\n  }\n  return `\\nExtension-provided flags:\\n  ${lines.join(\"\\n  \")}`;\n}\n\nexport function collectDynamicExtensionFlagHelpByCommand(\n  registrations: RegisteredExtensionFlagDefinitions[],\n): Map<string, string> {\n  const grouped = new Map<string, Array<Record<string, unknown>>>();\n  for (const registration of registrations) {\n    const commandPath = normalizeExtensionCommandPath(registration.target_command);\n    if (commandPath.length === 0) {\n      continue;\n    }\n    const existing = grouped.get(commandPath) ?? [];\n    existing.push(...registration.flags);\n    grouped.set(commandPath, existing);\n  }\n\n  const entries = [...grouped.entries()].sort(([left], [right]) => left.localeCompare(right));\n  const helpByCommand = new Map<string, string>();\n  for (const [commandPath, definitions] of entries) {\n    const helpText = buildDynamicExtensionFlagHelp(definitions);\n    if (!helpText) {\n      continue;\n    }\n    helpByCommand.set(commandPath, helpText);\n  }\n  return helpByCommand;\n}\n\nfunction normalizeExtensionCommandAction(commandPath: string, action: string | undefined): string {\n  if (typeof action !== \"string\" || action.trim().length === 0) {\n    return commandPath.replace(/\\s+/g, \"-\");\n  }\n  return action.trim().toLowerCase();\n}\n\nfunction normalizeExtensionCommandStringList(values: string[] | undefined): string[] {\n  if (!Array.isArray(values)) {\n    return [];\n  }\n  const normalized: string[] = [];\n  const seen = new Set<string>();\n  for (const value of values) {\n    if (typeof value !== \"string\") {\n      continue;\n    }\n    const trimmed = value.trim();\n    if (trimmed.length === 0 || seen.has(trimmed)) {\n      continue;\n    }\n    seen.add(trimmed);\n    normalized.push(trimmed);\n  }\n  return normalized;\n}\n\nfunction normalizeExtensionCommandArguments(\n  values: Array<{ name?: unknown; required?: unknown; variadic?: unknown; description?: unknown }> | undefined,\n): ExtensionCommandArgumentHelpDescriptor[] {\n  if (!Array.isArray(values)) {\n    return [];\n  }\n  return values\n    .map((value) => {\n      const name = typeof value.name === \"string\" ? value.name.trim() : \"\";\n      if (name.length === 0) {\n        return null;\n      }\n      const normalized: ExtensionCommandArgumentHelpDescriptor = {\n        name,\n        required: value.required === true,\n        variadic: value.variadic === true,\n      };\n      if (typeof value.description === \"string\" && value.description.trim().length > 0) {\n        normalized.description = value.description.trim();\n      }\n      return normalized;\n    })\n    .filter((entry): entry is ExtensionCommandArgumentHelpDescriptor => entry !== null);\n}\n\nexport function collectExtensionCommandHelpDescriptors(\n  commandHandlers: string[],\n  commandDefinitions: RegisteredExtensionCommandDefinition[],\n  flagRegistrations: RegisteredExtensionFlagDefinitions[],\n): Map<string, ExtensionCommandHelpDescriptor> {\n  const definitionsByCommand = new Map<string, ExtensionCommandHelpDescriptor>();\n  for (const definition of commandDefinitions) {\n    const commandPath = normalizeExtensionCommandPath(definition.command);\n    if (commandPath.length === 0) {\n      continue;\n    }\n    const description =\n      typeof definition.description === \"string\" && definition.description.trim().length > 0\n        ? definition.description.trim()\n        : undefined;\n    const intent =\n      typeof definition.intent === \"string\" && definition.intent.trim().length > 0\n        ? definition.intent.trim()\n        : undefined;\n    definitionsByCommand.set(commandPath, {\n      command: commandPath,\n      action: normalizeExtensionCommandAction(commandPath, definition.action),\n      description,\n      intent,\n      examples: normalizeExtensionCommandStringList(definition.examples),\n      failure_hints: normalizeExtensionCommandStringList(definition.failure_hints),\n      arguments: normalizeExtensionCommandArguments(definition.arguments),\n      flags: [],\n      source: {\n        layer: definition.layer,\n        name: definition.name,\n      },\n    });\n  }\n\n  const flagsByCommand = new Map<string, Array<Record<string, unknown>>>();\n  for (const registration of flagRegistrations) {\n    const commandPath = normalizeExtensionCommandPath(registration.target_command);\n    if (commandPath.length === 0) {\n      continue;\n    }\n    const existing = flagsByCommand.get(commandPath) ?? [];\n    existing.push(...registration.flags);\n    flagsByCommand.set(commandPath, existing);\n  }\n\n  const commandSet = new Set<string>();\n  for (const commandPath of commandHandlers) {\n    const normalized = normalizeExtensionCommandPath(commandPath);\n    if (normalized.length > 0) {\n      commandSet.add(normalized);\n    }\n  }\n  for (const commandPath of definitionsByCommand.keys()) {\n    commandSet.add(commandPath);\n  }\n  for (const commandPath of flagsByCommand.keys()) {\n    commandSet.add(commandPath);\n  }\n\n  const descriptors = new Map<string, ExtensionCommandHelpDescriptor>();\n  const sortedCommands = [...commandSet].sort((left, right) => left.localeCompare(right));\n  for (const commandPath of sortedCommands) {\n    const definition = definitionsByCommand.get(commandPath);\n    const flags = flagsByCommand.get(commandPath) ?? [];\n    if (definition) {\n      descriptors.set(commandPath, {\n        ...definition,\n        flags,\n      });\n      continue;\n    }\n    descriptors.set(commandPath, {\n      command: commandPath,\n      action: normalizeExtensionCommandAction(commandPath, undefined),\n      examples: [],\n      failure_hints: [],\n      arguments: [],\n      flags,\n    });\n  }\n\n  return descriptors;\n}\n\nfunction buildExtensionArgumentToken(argument: ExtensionCommandArgumentHelpDescriptor): string {\n  const variadicSuffix = argument.variadic ? \"...\" : \"\";\n  if (argument.required) {\n    return `<${argument.name}${variadicSuffix}>`;\n  }\n  return `[${argument.name}${variadicSuffix}]`;\n}\n\nexport function applyDynamicExtensionArguments(command: Command, descriptor: ExtensionCommandHelpDescriptor): void {\n  for (const argument of descriptor.arguments) {\n    command.argument(buildExtensionArgumentToken(argument), argument.description ?? \"Extension argument.\");\n  }\n}\n\nfunction formatDynamicExtensionOptionFlags(definition: Record<string, unknown>): string | null {\n  const visible = toOptionalBoolean(definition.visible);\n  if (visible === false) {\n    return null;\n  }\n  const longName = toNonEmptyFlagString(definition.long);\n  const shortName = toNonEmptyFlagString(definition.short);\n  const normalizedShort = shortName && shortName.startsWith(\"-\") && !shortName.startsWith(\"--\") ? shortName : null;\n  const normalizedLong = longName && longName.startsWith(\"--\") && longName.length > 2 ? longName : null;\n  if (!normalizedLong && !normalizedShort) {\n    return null;\n  }\n  const optionValueName = toNonEmptyFlagString(definition.value_name);\n  const optionValueSuffix = optionValueName ? ` <${optionValueName}>` : \"\";\n  const optionNames = [normalizedShort, normalizedLong].filter((entry): entry is string => entry !== null);\n  return `${optionNames.join(\", \")}${optionValueSuffix}`;\n}\n\nfunction formatDynamicExtensionOptionDescription(definition: Record<string, unknown>): string {\n  const description = toNonEmptyFlagString(definition.description) ?? \"Extension-provided option.\";\n  const markers: string[] = [];\n  if (toOptionalBoolean(definition.required) === true) {\n    markers.push(\"required\");\n  }\n  if (toOptionalBoolean(definition.enabled) === false) {\n    markers.push(\"disabled\");\n  }\n  const markerSuffix = markers.length > 0 ? ` [${markers.join(\", \")}]` : \"\";\n  return `${description}${markerSuffix}`;\n}\n\nexport function applyDynamicExtensionOptions(command: Command, descriptor: ExtensionCommandHelpDescriptor): void {\n  const seen = new Set<string>();\n  for (const definition of descriptor.flags) {\n    const optionFlags = formatDynamicExtensionOptionFlags(definition);\n    if (!optionFlags || seen.has(optionFlags)) {\n      continue;\n    }\n    seen.add(optionFlags);\n    command.option(optionFlags, formatDynamicExtensionOptionDescription(definition));\n  }\n}\n\nfunction buildDynamicExtensionHelpOptionSummary(definition: Record<string, unknown>): HelpOptionSummary | null {\n  const flags = formatDynamicExtensionOptionFlags(definition);\n  if (!flags) {\n    return null;\n  }\n  const longName = toNonEmptyFlagString(definition.long);\n  const shortName = toNonEmptyFlagString(definition.short);\n  const normalizedLong = longName && longName.startsWith(\"--\") && longName.length > 2 ? longName : null;\n  const normalizedShort = shortName && shortName.startsWith(\"-\") && !shortName.startsWith(\"--\") ? shortName : null;\n  const valueName = toNonEmptyFlagString(definition.value_name);\n  const required = toOptionalBoolean(definition.required) === true;\n  return {\n    flags,\n    long: normalizedLong,\n    short: normalizedShort,\n    description: formatDynamicExtensionOptionDescription(definition),\n    takes_value: valueName !== null,\n    value_required: valueName !== null,\n    value_name: valueName,\n    variadic: false,\n    required,\n    aliases: [],\n    alias_for: null,\n  };\n}\n\nexport function buildDynamicExtensionHelpOptionSummaries(descriptor: ExtensionCommandHelpDescriptor | undefined): HelpOptionSummary[] {\n  if (!descriptor) {\n    return [];\n  }\n  const summaries: HelpOptionSummary[] = [];\n  const seen = new Set<string>();\n  for (const definition of descriptor.flags) {\n    const summary = buildDynamicExtensionHelpOptionSummary(definition);\n    if (!summary || seen.has(summary.flags)) {\n      continue;\n    }\n    seen.add(summary.flags);\n    summaries.push(summary);\n  }\n  return summaries;\n}\n\nexport function mergeHelpOptionSummaries(base: HelpOptionSummary[], extension: HelpOptionSummary[]): HelpOptionSummary[] {\n  if (extension.length === 0) {\n    return base;\n  }\n  const merged = [...base];\n  const seen = new Set(base.map((entry) => entry.flags));\n  for (const entry of extension) {\n    if (seen.has(entry.flags)) {\n      continue;\n    }\n    seen.add(entry.flags);\n    merged.push(entry);\n  }\n  return merged;\n}\n\nexport function buildDynamicExtensionCommandMetadataHelp(descriptor: ExtensionCommandHelpDescriptor): string | null {\n  const lines: string[] = [];\n  if (descriptor.intent) {\n    lines.push(`Intent: ${descriptor.intent}`);\n  }\n  if (descriptor.action) {\n    lines.push(`Action contract: ${descriptor.action}`);\n  }\n  if (descriptor.examples.length > 0) {\n    lines.push(\"Examples:\");\n    for (const example of descriptor.examples) {\n      lines.push(`  - ${example}`);\n    }\n  }\n  if (descriptor.failure_hints.length > 0) {\n    lines.push(\"Common failure hints:\");\n    for (const hint of descriptor.failure_hints) {\n      lines.push(`  - ${hint}`);\n    }\n  }\n  if (lines.length === 0) {\n    return null;\n  }\n  return `\\nExtension command metadata:\\n  ${lines.join(\"\\n  \")}`;\n}\n\nexport function commandAliases(command: Command): string[] {\n  const commandRecord = command as unknown as {\n    aliases?: () => string[];\n    alias?: () => string | undefined;\n    _aliases?: string[];\n  };\n  if (typeof commandRecord.aliases === \"function\") {\n    return commandRecord.aliases().map((value) => value.trim().toLowerCase()).filter((value) => value.length > 0);\n  }\n  if (typeof commandRecord.alias === \"function\") {\n    const alias = commandRecord.alias();\n    if (typeof alias === \"string\" && alias.trim().length > 0) {\n      return [alias.trim().toLowerCase()];\n    }\n  }\n  if (Array.isArray(commandRecord._aliases)) {\n    return commandRecord._aliases.map((value) => value.trim().toLowerCase()).filter((value) => value.length > 0);\n  }\n  return [];\n}\n\nexport function findDirectChildCommand(parent: Command, name: string): Command | null {\n  const normalizedTarget = name.trim().toLowerCase();\n  return (\n    parent.commands.find((entry) => {\n      if (entry.name().trim().toLowerCase() === normalizedTarget) {\n        return true;\n      }\n      return commandAliases(entry).includes(normalizedTarget);\n    }) ?? null\n  );\n}\n\nexport function findCommandByPath(root: Command, pathParts: string[]): Command | null {\n  let current: Command = root;\n  for (const part of pathParts) {\n    const next = findDirectChildCommand(current, part);\n    if (!next) {\n      return null;\n    }\n    current = next;\n  }\n  return current;\n}\n\nexport function ensureCommandPath(root: Command, pathParts: string[]): Command | null {\n  if (pathParts.length === 0) {\n    return null;\n  }\n\n  let current: Command = root;\n  for (let index = 0; index < pathParts.length; index += 1) {\n    const part = pathParts[index];\n    const existing = findDirectChildCommand(current, part);\n    if (existing) {\n      current = existing;\n      continue;\n    }\n\n    const created = current.command(part);\n    if (index < pathParts.length - 1) {\n      created.description(\"Extension-provided command group.\");\n    } else {\n      created.description(\"Extension-provided command path.\");\n    }\n    current = created;\n  }\n\n  return current;\n}\n"]}

package/dist/cli/help-content.js

@@ -267,15 +267,21 @@ const HELP_BY_COMMAND_PATH = {
         ],
     },
     context: {
-        why: "Builds an agent-optimized snapshot of critical active work plus near-term agenda context.",
+        why: "Builds an agent-optimized snapshot of critical active work plus near-term agenda context with progressive depth levels.",
         examples: [
             "pm context",
-            "pm ctx --limit 5 --assignee codex-agent",
-            "pm context --from +0d --to +7d --format markdown",
+            "pm ctx --depth standard --limit 10",
+            "pm ctx --depth deep --assignee codex-agent",
+            "pm ctx --section hierarchy --section progress --section blockers",
+            "pm context --depth standard --activity-limit 20 --stale-threshold 14d",
+            "pm context --from +0d --to +7d --format markdown --depth deep",
         ],
         tips: [
             "High-level focus contains Epics/Features and low-level focus contains Tasks/Issues/Chores/Event/Reminder/Milestone/Meeting.",
             "When no open or in-progress work exists, blocked items are shown as fallback context.",
+            "--depth brief (default) shows focus+agenda; standard adds hierarchy/activity/progress/workload; deep adds blockers/files/staleness/tests.",
+            "--section overrides --depth and selects specific sections: hierarchy, activity, progress, blockers, files, workload, staleness, tests.",
+            "Configure defaults via pm config project set context --default-depth standard --activity-limit 15.",
         ],
     },
     search: {