npm - @unbrained/pm-cli - Versions diffs - 2026.6.13 → 2026.6.16 - Mend

@unbrained/pm-cli 2026.6.13 → 2026.6.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (770) hide show

package/dist/cli/extension-command-options.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"extension-command-options.js","sources":["cli/extension-command-options.ts"],"sourceRoot":"/","sourcesContent":["import { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport { flattenFlagListValue, resolveFlagValueKind } from \"../core/extensions/flag-value-types.js\";\n\nconst UNSAFE_LOOSE_OPTION_KEYS = new Set([\"__proto__\", \"prototype\", \"constructor\"]);\n\nfunction toLooseOptionKey(rawKey: string): string {\n const key = rawKey.trim().toLowerCase();\n return key.replaceAll(/-([a-z0-9])/g, (_match, group: string) => group.toUpperCase());\n}\n\nfunction setLooseOptionValue(options: Record<string, unknown>, key: string, value: unknown): void {\n const existing = options[key];\n if (existing === undefined) {\n options[key] = value;\n return;\n }\n if (Array.isArray(existing)) {\n existing.push(value);\n options[key] = existing;\n return;\n }\n options[key] = [existing, value];\n}\n\ninterface ParsedLooseOptionToken {\n consumed: number;\n key: string;\n value: unknown;\n}\n\nfunction parseLooseOptionToken(args: string[], index: number): ParsedLooseOptionToken \| null {\n const token = args[index];\n if (!token.startsWith(\"-\") \|\| token === \"-\" \|\| token === \"--\") {\n return null;\n }\n\n if (!token.startsWith(\"--\")) {\n const equalsIndex = token.indexOf(\"=\");\n if (equalsIndex >= 0) {\n return {\n consumed: 1,\n key: token.slice(1, equalsIndex).trim(),\n value: token.slice(equalsIndex + 1),\n };\n }\n const key = token.slice(1).trim();\n const next = args[index + 1];\n if (typeof next === \"string\" && !next.startsWith(\"-\")) {\n return {\n consumed: 2,\n key,\n value: next,\n };\n }\n return {\n consumed: 1,\n key,\n value: true,\n };\n }\n\n const equalsIndex = token.indexOf(\"=\");\n if (equalsIndex >= 0) {\n return {\n consumed: 1,\n key: token.slice(2, equalsIndex).trim(),\n value: token.slice(equalsIndex + 1),\n };\n }\n\n if (token.startsWith(\"--no-\")) {\n return {\n consumed: 1,\n key: token.slice(5).trim(),\n value: false,\n };\n }\n\n const key = token.slice(2).trim();\n const next = args[index + 1];\n if (typeof next === \"string\" && !next.startsWith(\"-\")) {\n return {\n consumed: 2,\n key,\n value: next,\n };\n }\n return {\n consumed: 1,\n key,\n value: true,\n };\n}\n\nfunction isUnsafeLooseOptionKey(key: string): boolean {\n return UNSAFE_LOOSE_OPTION_KEYS.has(key);\n}\n\ntype LooseOptionCoercionKind = \"string\" \| \"number\" \| \"boolean\";\n\nfunction resolveLooseOptionCoercionKind(definition: Record<string, unknown>): LooseOptionCoercionKind \| null {\n // `value_type` is the canonical field; the deprecated `type` alias resolves\n // only when `value_type` is absent (FlagDefinition documents this precedence).\n const raw =\n (typeof definition.value_type === \"string\" ? definition.value_type : undefined) ??\n (typeof definition.type === \"string\" ? definition.type : undefined);\n return resolveFlagValueKind(raw);\n}\n\nfunction collectLooseOptionKeys(definition: Record<string, unknown>): string[] {\n const keys: string[] = [];\n const long = typeof definition.long === \"string\" ? definition.long.trim() : \"\";\n const short = typeof definition.short === \"string\" ? definition.short.trim() : \"\";\n if (long.startsWith(\"--\")) {\n const normalized = toLooseOptionKey(long.slice(2));\n if (normalized.length > 0 && !isUnsafeLooseOptionKey(normalized)) {\n keys.push(normalized);\n }\n }\n if (short.startsWith(\"-\") && !short.startsWith(\"--\")) {\n const normalized = toLooseOptionKey(short.slice(1));\n if (normalized.length > 0 && !isUnsafeLooseOptionKey(normalized)) {\n keys.push(normalized);\n }\n }\n return [...new Set(keys)];\n}\n\nexport function collectLooseCommandOptionKeysForDefinitions(\n definitions: Array<Record<string, unknown>>,\n): Set<string> {\n const keys = new Set<string>();\n for (const definition of definitions) {\n for (const key of collectLooseOptionKeys(definition)) {\n keys.add(key);\n }\n }\n return keys;\n}\n\nfunction resolveCanonicalLooseOptionKey(definition: Record<string, unknown>): string \| null {\n const long = typeof definition.long === \"string\" ? definition.long.trim() : \"\";\n if (long.startsWith(\"--\")) {\n const normalized = toLooseOptionKey(long.slice(2));\n if (normalized.length > 0 && !isUnsafeLooseOptionKey(normalized)) {\n return normalized;\n }\n }\n return collectLooseOptionKeys(definition)[0] ?? null;\n}\n\nfunction formatLooseOptionLabel(definition: Record<string, unknown>): string \| null {\n const long = typeof definition.long === \"string\" ? definition.long.trim() : \"\";\n if (long.startsWith(\"--\") && long.length > 2) {\n return long;\n }\n const short = typeof definition.short === \"string\" ? definition.short.trim() : \"\";\n if (short.startsWith(\"-\") && !short.startsWith(\"--\") && short.length > 1) {\n return short;\n }\n return null;\n}\n\nexport function validateLooseCommandOptionsWithFlagDefinitions(\n options: Record<string, unknown>,\n definitions: Array<Record<string, unknown>>,\n commandPath: string,\n): void {\n if (definitions.length === 0) {\n return;\n }\n const allowed = new Set<string>();\n const disabled = new Map<string, string>();\n const required: Array<{ keys: string[]; label: string }> = [];\n const labels: string[] = [];\n for (const definition of definitions) {\n const keys = collectLooseOptionKeys(definition);\n const label = formatLooseOptionLabel(definition);\n if (label) {\n labels.push(label);\n }\n for (const key of keys) {\n allowed.add(key);\n if (definition.enabled === false) {\n disabled.set(key, label ?? `--${key}`);\n }\n }\n if (definition.required === true && definition.enabled !== false && keys.length > 0) {\n required.push({ keys, label: label ?? `--${keys[0]}` });\n }\n }\n for (const key of Object.keys(options)) {\n if (!allowed.has(key)) {\n const expected = labels.length > 0 ? ` Expected one of: ${[...new Set(labels)].join(\", \")}.` : \"\";\n throw new PmCliError(`Unknown option '--${key}' for extension command '${commandPath}'.${expected}`, EXIT_CODE.USAGE);\n }\n const disabledLabel = disabled.get(key);\n if (disabledLabel) {\n throw new PmCliError(`Option '${disabledLabel}' is disabled for extension command '${commandPath}'.`, EXIT_CODE.USAGE);\n }\n }\n for (const entry of required) {\n if (!entry.keys.some((key) => Object.hasOwn(options, key))) {\n throw new PmCliError(`Missing required option '${entry.label}' for extension command '${commandPath}'.`, EXIT_CODE.USAGE);\n }\n }\n}\n\nfunction coerceLooseOptionValue(value: unknown, kind: LooseOptionCoercionKind): unknown {\n if (Array.isArray(value)) {\n return value.map((entry) => coerceLooseOptionValue(entry, kind));\n }\n if (kind === \"string\") {\n if (typeof value === \"string\") {\n return value;\n }\n if (value === null \|\| value === undefined) {\n return value;\n }\n return String(value);\n }\n if (kind === \"number\") {\n if (typeof value === \"number\") {\n return Number.isFinite(value) ? value : value;\n }\n if (typeof value === \"string\" && value.trim().length > 0) {\n const parsed = Number(value);\n return Number.isFinite(parsed) ? parsed : value;\n }\n return value;\n }\n if (typeof value === \"boolean\") {\n return value;\n }\n if (typeof value === \"string\") {\n const normalized = value.trim().toLowerCase();\n if (normalized === \"true\" \|\| normalized === \"1\") {\n return true;\n }\n if (normalized === \"false\" \|\| normalized === \"0\") {\n return false;\n }\n }\n return value;\n}\n\n/*\n Flatten a (possibly repeated and/or comma-joined) value into a list, applying\n * the declared coercion kind per element. Mirrors how core list flags such as\n * `--tags` split comma values and accumulate repeated occurrences, so an\n * extension flag declared `list: true` behaves identically. Empty segments are\n * dropped and surrounding whitespace is trimmed.\n /\nfunction splitCommaListValue(value: unknown, kind: LooseOptionCoercionKind \| null): unknown[] {\n const entries = flattenFlagListValue(value);\n return kind ? entries.map((entry) => coerceLooseOptionValue(entry, kind)) : entries;\n}\n\n/\n Resolve the value applied when a flag is omitted entirely. List flags wrap the\n * default into an accumulated array; scalar flags coerce by declared kind.\n */\nfunction applyFlagDefault(\n defaultValue: unknown,\n kind: LooseOptionCoercionKind \| null,\n isListFlag: boolean,\n): unknown {\n if (isListFlag) {\n return splitCommaListValue(defaultValue, kind);\n }\n return kind ? coerceLooseOptionValue(defaultValue, kind) : defaultValue;\n}\n\nexport function coerceLooseCommandOptionsWithFlagDefinitions(\n options: Record<string, unknown>,\n definitions: Array<Record<string, unknown>>,\n): Record<string, unknown> {\n if (definitions.length === 0) {\n return options;\n }\n const coerced = Object.create(null) as Record<string, unknown>;\n for (const [key, value] of Object.entries(options)) {\n coerced[key] = value;\n }\n for (const definition of definitions) {\n const canonical = resolveCanonicalLooseOptionKey(definition);\n if (!canonical) {\n continue;\n }\n for (const key of collectLooseOptionKeys(definition)) {\n if (key === canonical \|\| !Object.hasOwn(coerced, key)) {\n continue;\n }\n if (Object.hasOwn(coerced, canonical)) {\n continue;\n }\n coerced[canonical] = coerced[key];\n delete coerced[key];\n }\n const kind = resolveLooseOptionCoercionKind(definition);\n const isListFlag = definition.list === true;\n if (!Object.hasOwn(coerced, canonical)) {\n // Flag was omitted entirely: apply the declared default when present.\n if (definition.default !== undefined) {\n coerced[canonical] = applyFlagDefault(definition.default, kind, isListFlag);\n }\n continue;\n }\n if (isListFlag) {\n coerced[canonical] = splitCommaListValue(coerced[canonical], kind);\n continue;\n }\n if (!kind) {\n continue;\n }\n coerced[canonical] = coerceLooseOptionValue(coerced[canonical], kind);\n }\n return coerced;\n}\n\nexport function parseLooseCommandOptions(args: string[]): Record<string, unknown> {\n const options = Object.create(null) as Record<string, unknown>;\n let index = 0;\n while (index < args.length) {\n const parsed = parseLooseOptionToken(args, index);\n if (!parsed) {\n index += 1;\n continue;\n }\n\n const normalizedKey = toLooseOptionKey(parsed.key);\n if (normalizedKey.length === 0 \|\| isUnsafeLooseOptionKey(normalizedKey)) {\n index += parsed.consumed;\n continue;\n }\n setLooseOptionValue(options, normalizedKey, parsed.value);\n index += parsed.consumed;\n }\n return options;\n}\n\nexport function stripLooseCommandOptionTokens(\n args: string[],\n definitions: Array<Record<string, unknown>>,\n): string[] {\n if (definitions.length === 0) {\n return [...args];\n }\n const knownKeys = new Set<string>();\n const booleanKeys = new Set<string>();\n for (const definition of definitions) {\n const valueKind = resolveLooseOptionCoercionKind(definition);\n for (const key of collectLooseOptionKeys(definition)) {\n knownKeys.add(key);\n if (valueKind === \"boolean\") {\n booleanKeys.add(key);\n }\n }\n }\n if (knownKeys.size === 0) {\n return [...args];\n }\n\n const stripped: string[] = [];\n let index = 0;\n while (index < args.length) {\n if (args[index] === \"--\") {\n stripped.push(...args.slice(index + 1));\n break;\n }\n const parsed = parseLooseOptionToken(args, index);\n if (parsed) {\n const normalizedKey = toLooseOptionKey(parsed.key);\n if (knownKeys.has(normalizedKey)) {\n const token = args[index] ?? \"\";\n const consumed = booleanKeys.has(normalizedKey) && !token.includes(\"=\") ? 1 : parsed.consumed;\n index += consumed;\n continue;\n }\n }\n stripped.push(args[index]);\n index += 1;\n }\n return stripped;\n}\n"],"names":[],"mappings":"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","debugId":"b2a33807-c231-539d-ba55-045ba504f088"}
1	+ {"version":3,"file":"extension-command-options.js","sources":["cli/extension-command-options.ts"],"sourceRoot":"/","sourcesContent":["import { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport { flattenFlagListValue, resolveFlagValueKind } from \"../core/extensions/flag-value-types.js\";\n\nconst UNSAFE_LOOSE_OPTION_KEYS = new Set([\"__proto__\", \"prototype\", \"constructor\"]);\n\nfunction toLooseOptionKey(rawKey: string): string {\n const key = rawKey.trim().toLowerCase();\n return key.replaceAll(/-([a-z0-9])/g, (_match, group: string) => group.toUpperCase());\n}\n\nfunction setLooseOptionValue(options: Record<string, unknown>, key: string, value: unknown): void {\n const existing = options[key];\n if (existing === undefined) {\n options[key] = value;\n return;\n }\n if (Array.isArray(existing)) {\n existing.push(value);\n options[key] = existing;\n return;\n }\n options[key] = [existing, value];\n}\n\ninterface ParsedLooseOptionToken {\n consumed: number;\n key: string;\n value: unknown;\n}\n\nfunction parseLooseOptionToken(args: string[], index: number): ParsedLooseOptionToken \| null {\n const token = args[index];\n if (!token.startsWith(\"-\") \|\| token === \"-\" \|\| token === \"--\") {\n return null;\n }\n\n if (!token.startsWith(\"--\")) {\n const equalsIndex = token.indexOf(\"=\");\n if (equalsIndex >= 0) {\n return {\n consumed: 1,\n key: token.slice(1, equalsIndex).trim(),\n value: token.slice(equalsIndex + 1),\n };\n }\n const key = token.slice(1).trim();\n const next = args[index + 1];\n if (typeof next === \"string\" && !next.startsWith(\"-\")) {\n return {\n consumed: 2,\n key,\n value: next,\n };\n }\n return {\n consumed: 1,\n key,\n value: true,\n };\n }\n\n const equalsIndex = token.indexOf(\"=\");\n if (equalsIndex >= 0) {\n return {\n consumed: 1,\n key: token.slice(2, equalsIndex).trim(),\n value: token.slice(equalsIndex + 1),\n };\n }\n\n if (token.startsWith(\"--no-\")) {\n return {\n consumed: 1,\n key: token.slice(5).trim(),\n value: false,\n };\n }\n\n const key = token.slice(2).trim();\n const next = args[index + 1];\n if (typeof next === \"string\" && !next.startsWith(\"-\")) {\n return {\n consumed: 2,\n key,\n value: next,\n };\n }\n return {\n consumed: 1,\n key,\n value: true,\n };\n}\n\nfunction isUnsafeLooseOptionKey(key: string): boolean {\n return UNSAFE_LOOSE_OPTION_KEYS.has(key);\n}\n\ntype LooseOptionCoercionKind = \"string\" \| \"number\" \| \"boolean\";\n\nfunction resolveLooseOptionCoercionKind(definition: Record<string, unknown>): LooseOptionCoercionKind \| null {\n // `value_type` is the canonical field; the deprecated `type` alias resolves\n // only when `value_type` is absent (FlagDefinition documents this precedence).\n const raw =\n (typeof definition.value_type === \"string\" ? definition.value_type : undefined) ??\n (typeof definition.type === \"string\" ? definition.type : undefined);\n return resolveFlagValueKind(raw);\n}\n\nfunction collectLooseOptionKeys(definition: Record<string, unknown>): string[] {\n const keys: string[] = [];\n const long = typeof definition.long === \"string\" ? definition.long.trim() : \"\";\n const short = typeof definition.short === \"string\" ? definition.short.trim() : \"\";\n if (long.startsWith(\"--\")) {\n const normalized = toLooseOptionKey(long.slice(2));\n if (normalized.length > 0 && !isUnsafeLooseOptionKey(normalized)) {\n keys.push(normalized);\n }\n }\n if (short.startsWith(\"-\") && !short.startsWith(\"--\")) {\n const normalized = toLooseOptionKey(short.slice(1));\n if (normalized.length > 0 && !isUnsafeLooseOptionKey(normalized)) {\n keys.push(normalized);\n }\n }\n return [...new Set(keys)];\n}\n\nexport function collectLooseCommandOptionKeysForDefinitions(\n definitions: Array<Record<string, unknown>>,\n): Set<string> {\n const keys = new Set<string>();\n for (const definition of definitions) {\n for (const key of collectLooseOptionKeys(definition)) {\n keys.add(key);\n }\n }\n return keys;\n}\n\nfunction resolveCanonicalLooseOptionKey(definition: Record<string, unknown>): string \| null {\n const long = typeof definition.long === \"string\" ? definition.long.trim() : \"\";\n if (long.startsWith(\"--\")) {\n const normalized = toLooseOptionKey(long.slice(2));\n if (normalized.length > 0 && !isUnsafeLooseOptionKey(normalized)) {\n return normalized;\n }\n }\n return collectLooseOptionKeys(definition)[0] ?? null;\n}\n\nfunction formatLooseOptionLabel(definition: Record<string, unknown>): string \| null {\n const long = typeof definition.long === \"string\" ? definition.long.trim() : \"\";\n if (long.startsWith(\"--\") && long.length > 2) {\n return long;\n }\n const short = typeof definition.short === \"string\" ? definition.short.trim() : \"\";\n if (short.startsWith(\"-\") && !short.startsWith(\"--\") && short.length > 1) {\n return short;\n }\n return null;\n}\n\nexport function validateLooseCommandOptionsWithFlagDefinitions(\n options: Record<string, unknown>,\n definitions: Array<Record<string, unknown>>,\n commandPath: string,\n): void {\n if (definitions.length === 0) {\n return;\n }\n const allowed = new Set<string>();\n const disabled = new Map<string, string>();\n const required: Array<{ keys: string[]; label: string }> = [];\n const labels: string[] = [];\n for (const definition of definitions) {\n const keys = collectLooseOptionKeys(definition);\n const label = formatLooseOptionLabel(definition);\n const fallbackLabel = keys.length > 0 ? `--${keys[0]}` : null;\n const normalizedLabel = label ?? fallbackLabel;\n if (normalizedLabel) {\n labels.push(normalizedLabel);\n }\n for (const key of keys) {\n allowed.add(key);\n if (definition.enabled === false) {\n disabled.set(key, normalizedLabel as string);\n }\n }\n if (definition.required === true && definition.enabled !== false && keys.length > 0) {\n required.push({ keys, label: normalizedLabel as string });\n }\n }\n for (const key of Object.keys(options)) {\n if (!allowed.has(key)) {\n const expected = labels.length > 0 ? ` Expected one of: ${[...new Set(labels)].join(\", \")}.` : \"\";\n throw new PmCliError(`Unknown option '--${key}' for extension command '${commandPath}'.${expected}`, EXIT_CODE.USAGE);\n }\n const disabledLabel = disabled.get(key);\n if (disabledLabel) {\n throw new PmCliError(`Option '${disabledLabel}' is disabled for extension command '${commandPath}'.`, EXIT_CODE.USAGE);\n }\n }\n for (const entry of required) {\n if (!entry.keys.some((key) => Object.hasOwn(options, key))) {\n throw new PmCliError(`Missing required option '${entry.label}' for extension command '${commandPath}'.`, EXIT_CODE.USAGE);\n }\n }\n}\n\nfunction coerceLooseOptionValue(value: unknown, kind: LooseOptionCoercionKind): unknown {\n if (Array.isArray(value)) {\n return value.map((entry) => coerceLooseOptionValue(entry, kind));\n }\n if (kind === \"string\") {\n if (typeof value === \"string\") {\n return value;\n }\n if (value === null \|\| value === undefined) {\n return value;\n }\n return String(value);\n }\n if (kind === \"number\") {\n if (typeof value === \"number\") {\n return Number.isFinite(value) ? value : value;\n }\n if (typeof value === \"string\" && value.trim().length > 0) {\n const parsed = Number(value);\n return Number.isFinite(parsed) ? parsed : value;\n }\n return value;\n }\n if (typeof value === \"boolean\") {\n return value;\n }\n if (typeof value === \"string\") {\n const normalized = value.trim().toLowerCase();\n if (normalized === \"true\" \|\| normalized === \"1\") {\n return true;\n }\n if (normalized === \"false\" \|\| normalized === \"0\") {\n return false;\n }\n }\n return value;\n}\n\n/*\n Flatten a (possibly repeated and/or comma-joined) value into a list, applying\n * the declared coercion kind per element. Mirrors how core list flags such as\n * `--tags` split comma values and accumulate repeated occurrences, so an\n * extension flag declared `list: true` behaves identically. Empty segments are\n * dropped and surrounding whitespace is trimmed.\n /\nfunction splitCommaListValue(value: unknown, kind: LooseOptionCoercionKind \| null): unknown[] {\n const entries = flattenFlagListValue(value);\n return kind ? entries.map((entry) => coerceLooseOptionValue(entry, kind)) : entries;\n}\n\n/\n Resolve the value applied when a flag is omitted entirely. List flags wrap the\n * default into an accumulated array; scalar flags coerce by declared kind.\n */\nfunction applyFlagDefault(\n defaultValue: unknown,\n kind: LooseOptionCoercionKind \| null,\n isListFlag: boolean,\n): unknown {\n if (isListFlag) {\n return splitCommaListValue(defaultValue, kind);\n }\n return kind ? coerceLooseOptionValue(defaultValue, kind) : defaultValue;\n}\n\nexport function coerceLooseCommandOptionsWithFlagDefinitions(\n options: Record<string, unknown>,\n definitions: Array<Record<string, unknown>>,\n): Record<string, unknown> {\n if (definitions.length === 0) {\n return options;\n }\n const coerced = Object.create(null) as Record<string, unknown>;\n for (const [key, value] of Object.entries(options)) {\n coerced[key] = value;\n }\n for (const definition of definitions) {\n const canonical = resolveCanonicalLooseOptionKey(definition);\n if (!canonical) {\n continue;\n }\n for (const key of collectLooseOptionKeys(definition)) {\n if (key === canonical \|\| !Object.hasOwn(coerced, key)) {\n continue;\n }\n if (Object.hasOwn(coerced, canonical)) {\n continue;\n }\n coerced[canonical] = coerced[key];\n delete coerced[key];\n }\n const kind = resolveLooseOptionCoercionKind(definition);\n const isListFlag = definition.list === true;\n if (!Object.hasOwn(coerced, canonical)) {\n // Flag was omitted entirely: apply the declared default when present.\n if (definition.default !== undefined) {\n coerced[canonical] = applyFlagDefault(definition.default, kind, isListFlag);\n }\n continue;\n }\n if (isListFlag) {\n coerced[canonical] = splitCommaListValue(coerced[canonical], kind);\n continue;\n }\n if (!kind) {\n continue;\n }\n coerced[canonical] = coerceLooseOptionValue(coerced[canonical], kind);\n }\n return coerced;\n}\n\nexport function parseLooseCommandOptions(args: string[]): Record<string, unknown> {\n const options = Object.create(null) as Record<string, unknown>;\n let index = 0;\n while (index < args.length) {\n const parsed = parseLooseOptionToken(args, index);\n if (!parsed) {\n index += 1;\n continue;\n }\n\n const normalizedKey = toLooseOptionKey(parsed.key);\n if (normalizedKey.length === 0 \|\| isUnsafeLooseOptionKey(normalizedKey)) {\n index += parsed.consumed;\n continue;\n }\n setLooseOptionValue(options, normalizedKey, parsed.value);\n index += parsed.consumed;\n }\n return options;\n}\n\nexport function stripLooseCommandOptionTokens(\n args: string[],\n definitions: Array<Record<string, unknown>>,\n): string[] {\n if (definitions.length === 0) {\n return [...args];\n }\n const knownKeys = new Set<string>();\n const booleanKeys = new Set<string>();\n for (const definition of definitions) {\n const valueKind = resolveLooseOptionCoercionKind(definition);\n for (const key of collectLooseOptionKeys(definition)) {\n knownKeys.add(key);\n if (valueKind === \"boolean\") {\n booleanKeys.add(key);\n }\n }\n }\n if (knownKeys.size === 0) {\n return [...args];\n }\n\n const stripped: string[] = [];\n let index = 0;\n while (index < args.length) {\n if (args[index] === \"--\") {\n stripped.push(...args.slice(index + 1));\n break;\n }\n const parsed = parseLooseOptionToken(args, index);\n if (parsed) {\n const normalizedKey = toLooseOptionKey(parsed.key);\n if (knownKeys.has(normalizedKey)) {\n const token = args[index] as string;\n const consumed = booleanKeys.has(normalizedKey) && !token.includes(\"=\") ? 1 : parsed.consumed;\n index += consumed;\n continue;\n }\n }\n stripped.push(args[index]);\n index += 1;\n }\n return stripped;\n}\n"],"names":[],"mappings":"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","debugId":"73a3f15b-1652-55b5-8ca9-6eadaaad6420"}

package/dist/cli/help-content.d.ts CHANGED Viewed

@@ -11,9 +11,17 @@ export interface HelpNarrative {
     detail_mode: HelpDetailMode;
 }
 export type HelpDetailMode = "compact" | "detailed";
+export declare function firstExampleOrEmpty(examples: string[]): string[];
+declare function renderCompactHelpBundle(bundle: HelpBundle): string;
+declare function renderDetailedHelpBundle(bundle: HelpBundle): string;
 export declare function normalizeHelpCommandPath(commandPath: string): string;
 export declare function resolveHelpDetailMode(argv: string[]): HelpDetailMode;
 export declare const ROOT_HELP_BUNDLE: HelpBundle;
 export declare function resolveHelpBundleForPath(commandPath: string | undefined): HelpBundle;
 export declare function resolveHelpNarrative(commandPath: string | undefined, detailMode: HelpDetailMode): HelpNarrative;
 export declare function attachRichHelpText(program: Command, argv?: string[]): void;
+export declare const _testOnly: {
+    renderCompactHelpBundle: typeof renderCompactHelpBundle;
+    renderDetailedHelpBundle: typeof renderDetailedHelpBundle;
+};
+export {};

package/dist/cli/help-content.js CHANGED Viewed

@@ -1,14 +1,21 @@
+// Compact help/narrative surfaces show at most the first example. Centralizing this
+// keeps the empty-examples guard in one place for renderCompactHelpBundle and
+// resolveHelpNarrative (both must degrade to an empty list rather than [undefined]).
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a1d00ac8-e750-598f-a4ec-20581735dc84")}catch(e){}}();
+!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]="0ae19066-4ac9-55c8-bb28-0204a184caba")}catch(e){}}();
+export function firstExampleOrEmpty(examples) {
+    return examples.length > 0 ? [examples[0]] : [];
+}
 function renderCompactHelpBundle(bundle) {
     const lines = [
         "",
         "Intent:",
         `  ${bundle.why}`,
     ];
-    if (bundle.examples.length > 0) {
+    const compactExamples = firstExampleOrEmpty(bundle.examples);
+    if (compactExamples.length > 0) {
         lines.push("", "Example:");
-        lines.push(`  ${bundle.examples[0]}`);
+        lines.push(`  ${compactExamples[0]}`);
     }
     lines.push("", "Need deeper rationale and more examples?");
     lines.push("  Re-run with --explain.");
@@ -246,6 +253,19 @@ const HELP_BY_COMMAND_PATH = {
             "Use --type <value> to load type-aware policy guidance in --help output.",
         ],
     },
+    focus: {
+        why: "Sets a session focused item so new pm create items default their --parent to it (project management = context management).",
+        examples: [
+            "pm focus pm-epic1",
+            "pm focus",
+            "pm focus --clear",
+        ],
+        tips: [
+            "Focus is session-local (stored in .agents/pm/runtime/session.json, gitignored) — it never affects teammates.",
+            "An explicit --parent on pm create always overrides the focused item; use --parent \"\" to create with no parent.",
+            "A stale focused item produces the same missing-parent validation as an explicit stale --parent.",
+        ],
+    },
     update: {
         why: "Mutates existing item fields while preserving history and lock safety.",
         examples: [
@@ -453,7 +473,7 @@ const HELP_BY_COMMAND_PATH = {
         tips: [
             "Default depth is standard for body plus linked artifacts without append-only logs; use brief for metadata-only checks or --full for complete history-heavy metadata.",
             "Use --fields for the smallest deterministic item metadata payload when an agent only needs specific fields.",
-            "JSON output shape is { item, body, linked, claim_state }; body is top-level (not item.body).",
+            "JSON output shape is { item, linked, claim_state, children }; body is nested at item.body (parity with list --include-body), and children appears for requested/container rollups.",
         ],
     },
     history: {
@@ -720,7 +740,7 @@ export function resolveHelpNarrative(commandPath, detailMode) {
     const bundle = resolveHelpBundleForPath(commandPath);
     return {
         intent: bundle.why,
-        examples: detailMode === "detailed" ? [...bundle.examples] : bundle.examples.length > 0 ? [bundle.examples[0]] : [],
+        examples: detailMode === "detailed" ? [...bundle.examples] : firstExampleOrEmpty(bundle.examples),
         tips: detailMode === "detailed" ? [...(bundle.tips ?? [])] : [],
         detail_mode: detailMode,
     };
@@ -732,5 +752,9 @@ export function attachRichHelpText(program, argv = process.argv.slice(2)) {
         attachBundleByPath(program, commandPath, bundle, detailMode);
     }
 }
+export const _testOnly = {
+    renderCompactHelpBundle,
+    renderDetailedHelpBundle,
+};
 //# sourceMappingURL=help-content.js.map
-//# debugId=a1d00ac8-e750-598f-a4ec-20581735dc84
+//# debugId=0ae19066-4ac9-55c8-bb28-0204a184caba

package/dist/cli/help-content.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"help-content.js","sources":["cli/help-content.ts"],"sourceRoot":"/","sourcesContent":["import { Command } from \"commander\";\n\nexport interface HelpBundle {\n why: string;\n examples: string[];\n tips?: string[];\n}\n\nexport interface HelpNarrative {\n intent: string;\n examples: string[];\n tips: string[];\n detail_mode: HelpDetailMode;\n}\n\nexport type HelpDetailMode = \"compact\" \| \"detailed\";\n\nfunction renderCompactHelpBundle(bundle: HelpBundle): string {\n const lines: string[] = [\n \"\",\n \"Intent:\",\n ` ${bundle.why}`,\n ];\n if (bundle.examples.length > 0) {\n lines.push(\"\", \"Example:\");\n lines.push(` ${bundle.examples[0]}`);\n }\n lines.push(\"\", \"Need deeper rationale and more examples?\");\n lines.push(\" Re-run with --explain.\");\n return lines.join(\"\\n\");\n}\n\nfunction renderDetailedHelpBundle(bundle: HelpBundle): string {\n const lines: string[] = [\n \"\",\n \"Why use this command:\",\n ` ${bundle.why}`,\n \"\",\n \"Examples:\",\n ...bundle.examples.map((example) => ` ${example}`),\n ];\n if (bundle.tips && bundle.tips.length > 0) {\n lines.push(\"\", \"Tips:\");\n lines.push(...bundle.tips.map((tip) => ` - ${tip}`));\n }\n return lines.join(\"\\n\");\n}\n\nfunction renderHelpBundle(bundle: HelpBundle, detailMode: HelpDetailMode): string {\n if (detailMode === \"detailed\") {\n return renderDetailedHelpBundle(bundle);\n }\n return renderCompactHelpBundle(bundle);\n}\n\nexport function normalizeHelpCommandPath(commandPath: string): string {\n return commandPath\n .trim()\n .toLowerCase()\n .split(/\\s+/)\n .filter((part) => part.length > 0)\n .join(\" \");\n}\n\nconst HELP_PATH_ALIASES: Record<string, string> = {\n cal: \"calendar\",\n ctx: \"context\",\n};\n\nfunction findDirectChildCommand(parent: Command, name: string): Command \| null {\n return parent.commands.find((entry) => entry.name() === name) ?? null;\n}\n\nfunction 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\nfunction attachBundleByPath(root: Command, commandPath: string, bundle: HelpBundle, detailMode: HelpDetailMode): void {\n const command = findCommandByPath(root, commandPath.split(\" \").filter((part) => part.length > 0));\n if (!command) {\n return;\n }\n command.addHelpText(\"after\", renderHelpBundle(bundle, detailMode));\n}\n\nexport function resolveHelpDetailMode(argv: string[]): HelpDetailMode {\n if (argv.includes(\"--explain\")) {\n return \"detailed\";\n }\n return \"compact\";\n}\n\nconst HELP_BY_COMMAND_PATH: Record<string, HelpBundle> = {\n init: {\n why: \"Bootstraps tracker storage and settings so all other commands can run safely.\",\n examples: [\n \"pm init\",\n \"pm init acme\",\n \"pm init --preset minimal\",\n \"pm init --agent-guidance add\",\n \"pm init --defaults --with-packages\",\n ],\n tips: [\n \"Run this once per repository before create/list/update commands.\",\n \"Use --preset for non-interactive automation; omit it in a TTY to use the setup wizard.\",\n \"Use --agent-guidance add to inject compact AGENTS/CLAUDE workflow guidance, or --agent-guidance status to inspect missing guidance without modifying files.\",\n \"Use --with-packages when agents need bundled commands such as calendar and templates available immediately.\",\n ],\n },\n config: {\n why: \"Reads or updates project/global settings such as definition-of-done, item format, telemetry, and policy toggles.\",\n examples: [\n 'pm config project get definition-of-done',\n 'pm config project set definition-of-done --criterion \"tests pass\"',\n \"pm config project set item-format --format toon\",\n \"pm config project set sprint-release-format-policy --policy strict_error\",\n \"pm config project set governance-preset --policy minimal\",\n \"pm config project set governance-ownership-enforcement --policy none\",\n \"pm config project set test-result-tracking --policy enabled\",\n \"pm config global set telemetry-tracking --policy disabled\",\n ],\n },\n extension: {\n why:\n \"Compatibility command for package-backed runtime extension lifecycle operations across project or global scope.\",\n examples: [\n \"pm install ./my-package --project\",\n \"pm install '' --project\",\n \"pm package doctor --project --detail summary\",\n \"pm package manage --global\",\n \"pm package activate sample-ext --project\",\n \"pm package deactivate sample-ext --project\",\n \"pm package uninstall sample-ext --global\",\n \"pm extension explore --project\",\n \"pm extension manage --global\",\n \"pm extension doctor --detail deep\",\n ],\n tips: [\n \"Prefer pm install and pm package in new user-facing automation.\",\n \"Use pm extension when maintaining existing extension-specific scripts or debugging the compatibility runtime directly.\",\n \"Bundled aliases beads and todos resolve to package-shipped extension sources.\",\n \"Use --gh/--github shorthand for GitHub sources and --ref to pin a branch, tag, or ref.\",\n \"Install updates settings activation state automatically unless extension allowlist mode is unchanged.\",\n \"Use --adopt for single-extension adoption and --adopt-all to bulk-register unmanaged installs as managed without reinstalling.\",\n \"Use --manage for concise triage summaries and remediation-oriented diagnostics alongside full extension details.\",\n \"Use --doctor for consolidated diagnostics with warning codes, remediation hints, and optional deep detail payloads.\",\n ],\n },\n package: {\n why:\n \"Installs, explores, manages, diagnoses, adopts, activates, deactivates, and refreshes package-backed pm runtime extensions.\",\n examples: [\n \"pm install npm:@scope/pm-package --project\",\n \"pm package install ./my-package --project\",\n \"pm package doctor --project --detail deep\",\n \"pm package manage --project --runtime-probe\",\n \"pm package activate sample-ext --project\",\n \"pm upgrade --packages-only --dry-run\",\n ],\n tips: [\n \"Prefer package vocabulary for user-facing workflows; extension vocabulary remains available for compatibility.\",\n \"Use pm upgrade to refresh the CLI/SDK and managed packages from their recorded sources.\",\n \"Use --dry-run before upgrade when automation needs a deterministic plan.\",\n ],\n },\n \"package init\": {\n why: \"Generates an installable starter pm package with package metadata and a root extension entrypoint.\",\n examples: [\n \"pm package init ./my-package\",\n \"pm install ./my-package --project\",\n \"pm package doctor --project --detail summary\",\n ],\n tips: [\n \"The generated package is local-install safe; add SDK runtime imports only after declaring dependencies and validating with package doctor.\",\n \"Use package doctor after changes to verify activation, policy, and collision diagnostics.\",\n ],\n },\n \"package install\": {\n why: \"Installs pm packages from local paths, npm sources, GitHub sources, bundled aliases, or wildcard/all aliases.\",\n examples: [\n \"pm package install ./my-package --project\",\n \"pm install npm:pm-changelog --project\",\n \"pm package install --github org/repo/packages/my-pm-package --ref main\",\n ],\n tips: [\n \"Prefer the top-level pm install alias in scripts when only installation is needed.\",\n \"Run pm package manage or pm package doctor after installing external packages.\",\n ],\n },\n \"package catalog\": {\n why: \"Lists bundled first-party package catalog metadata and compact field projections.\",\n examples: [\n \"pm package catalog --project\",\n \"pm package catalog --project --fields alias,installed,install_command\",\n \"pm package list --project --fields alias,package_name,category\",\n ],\n tips: [\n \"Use --fields for low-token package discovery in agent loops.\",\n \"External npm package discovery still belongs to npm search.\",\n ],\n },\n \"extension init\": {\n why: \"Generates an installable starter runtime extension with manifest and entrypoint files.\",\n examples: [\n \"pm extension init ./my-extension\",\n \"pm extension --install --project ./my-extension\",\n \"pm extension --doctor --project --detail summary\",\n ],\n tips: [\n \"Use package init for new distributable package workflows; extension init is the compatibility-level runtime scaffold.\",\n ],\n },\n \"extension install\": {\n why: \"Installs a compatibility runtime extension from local, npm, GitHub, bundled alias, or wildcard sources.\",\n examples: [\n \"pm extension install ./my-extension --project\",\n \"pm extension --install --project ./my-extension\",\n \"pm extension doctor --project --detail summary\",\n ],\n tips: [\"Prefer pm install or pm package install for new package-first automation.\"],\n },\n \"extension catalog\": {\n why: \"Compatibility view of bundled package catalog metadata.\",\n examples: [\n \"pm extension catalog --project\",\n \"pm extension catalog --project --fields alias,installed,install_command\",\n ],\n tips: [\"Prefer pm package catalog in new user-facing workflows.\"],\n },\n install: {\n why: \"Installs a pm package into project scope by default, using local, npm, GitHub, or bundled alias sources.\",\n examples: [\n \"pm install '' --project\",\n \"pm install ./packages/pm-todos --project\",\n \"pm install npm:@scope/pm-package --global\",\n \"pm install --github org/repo/packages/my-pm-package --ref main\",\n ],\n tips: [\"Installed packages are recorded in managed state and can be inspected with pm package manage.\"],\n },\n upgrade: {\n why: \"Updates the global pm CLI/SDK and refreshes managed pm packages from recorded install sources.\",\n examples: [\n \"pm upgrade --dry-run\",\n \"pm upgrade --packages-only --project\",\n \"pm upgrade todos --dry-run\",\n \"pm upgrade --cli-only --repair\",\n \"pm upgrade --tag next --dry-run\",\n ],\n tips: [\n \"Omit target to include the CLI/SDK plus all managed packages in the selected scope.\",\n \"Pass a target to refresh one managed package by name, directory, package name, or source.\",\n \"Use --packages-only in repository automation when the global CLI should not be changed.\",\n ],\n },\n create: {\n why: \"Creates a new planning item with deterministic metadata and history.\",\n examples: [\n 'pm create --title \"Harden lock flow\" --description \"Improve stale lock handling\" --type Task --status open --priority 1 --message \"Create lock hardening task\" --create-mode progressive',\n 'pm create --title \"Weekly planning sync\" --description \"Recurring coordination meeting\" --type Meeting --schedule-preset lightweight',\n 'pm create --title \"Asset: Hero model\" --description \"Track playable model asset\" --type Asset --status open --priority 1 --message \"Create asset item\" --type-option category=Character --dep \"id=pm-epic01,kind=parent,author=codex-agent,created_at=now\" --comment \"author=codex-agent,created_at=now,text=Why this asset item exists.\" --note \"author=codex-agent,created_at=now,text=Initial implementation note.\" --learning \"author=codex-agent,created_at=now,text=Durable lesson placeholder.\" --file \"path=src/assets/hero.glb,note=tracked asset\" --test \"command=node scripts/run-tests.mjs test,timeout_seconds=240\" --doc \"path=README.md,note=asset docs\"',\n ],\n tips: [\n \"Use --schedule-preset lightweight for Reminder/Meeting/Event when you want minimal required create inputs.\",\n \"Use --type <value> to load type-aware policy guidance in --help output.\",\n ],\n },\n update: {\n why: \"Mutates existing item fields while preserving history and lock safety.\",\n examples: [\n 'pm update pm-a1b2 --status in_progress --message \"Start implementation\"',\n 'pm update pm-a1b2 --unset close-reason --message \"Clear stale close reason after reopen\"',\n 'pm update pm-a1b2 --unset assignee --deadline +2d --message \"Replan ownership and deadline\"',\n 'pm update pm-a1b2 --body \"Backfilled body text for legacy item\" --message \"Normalize missing body\"',\n ],\n tips: [\n 'Use \"pm close <ID> <TEXT>\" to close items instead of --status closed.',\n \"When reopening from closed to a non-terminal status, update clears stale close_reason unless explicitly set via --close-reason.\",\n 'Use \"pm append <ID> --body <text>\" for additive notes; use update --body to replace body content.',\n ],\n },\n \"update-many\": {\n why: \"Bulk-updates matched item sets with dry-run previews and rollback checkpoints for safe large-scale metadata changes.\",\n examples: [\n \"pm update-many --filter-status open --status in_progress --dry-run\",\n 'pm update-many --filter-tag wave:7 --replace-tests --test \"command=node scripts/run-tests.mjs test -- tests/core/history.spec.ts,timeout_seconds=240\"',\n 'pm update-many --filter-tag governance --reviewer maintainer-review --message \"Normalize reviewer metadata\"',\n \"pm update-many --rollback ckpt-abc123\",\n ],\n tips: [\n \"Use --dry-run first to inspect proposed changes before apply mode.\",\n \"Linked-array mutation flags mirror pm update semantics (for example --replace-tests, --clear-files, and repeatable --doc/--note seeds).\",\n \"Checkpoints are enabled by default for apply mode and can be restored with --rollback.\",\n ],\n },\n \"close-many\": {\n why: \"Bulk-closes matched items with a shared reason routed through full pm close semantics (close validation, active-child orphan checks, blocked-edge cleanup) plus dry-run previews and rollback checkpoints — unlike update-many --status closed, which bypasses close validation.\",\n examples: [\n 'pm close-many --filter-sprint S-12 --reason \"Sprint S-12 acceptance criteria met\" --dry-run',\n 'pm close-many --filter-tag wave:7 --reason \"Superseded by redesign\" --validate-close warn',\n 'pm close-many --ids pm-a,pm-b,pm-c --reason \"Closed in batch\" --resolution \"Verified by integration suite\"',\n \"pm close-many --rollback close-many-20260604-abc123\",\n ],\n tips: [\n \"At least one filter (--filter-* or --ids) is required so close-many never matches every item.\",\n \"Already-terminal matches are skipped by default; pass --force to re-close them.\",\n \"Use --dry-run to preview matches plus per-item skip reasons and active-child orphan warnings before applying.\",\n \"Checkpoints are enabled by default for apply mode; restore with --rollback <checkpoint-id>.\",\n ],\n },\n normalize: {\n why:\n \"Scans items for low-signal lifecycle metadata drift, emits deterministic per-item plans, and optionally applies normalized metadata updates with update-style safety checks.\",\n examples: [\n \"pm normalize --dry-run\",\n \"pm normalize --filter-status in_progress --dry-run\",\n 'pm normalize --filter-status closed --apply --author \"codex-agent\" --message \"Normalize closure metadata\"',\n ],\n tips: [\n \"Dry-run mode is the default; pass --apply only after reviewing planned changes.\",\n \"Apply mode honors ownership/audit constraints and supports --allow-audit-update with optional --force override.\",\n ],\n },\n templates: {\n why: \"Saves, lists, and inspects reusable create option bundles for repeatable workflows.\",\n examples: [\n 'pm templates save triage-default --title \"Triage item\" --description \"...\" --type Task --status open --priority 2 --message \"Seed triage template\"',\n \"pm templates list\",\n \"pm templates show triage-default\",\n ],\n tips: [\n \"Template names are positional arguments (`pm templates save <name>` and `pm templates show <name>`), not --name flags.\",\n \"Combine templates with explicit create flags; explicit flags always override template defaults.\",\n ],\n },\n deps: {\n why: \"Inspects an item dependency graph as a tree or graph payload to understand blockers and hierarchy links.\",\n examples: [\n \"pm deps pm-a1b2\",\n \"pm deps pm-a1b2 --format graph\",\n \"pm deps pm-a1b2 --max-depth 2 --collapse repeated --summary\",\n ],\n tips: [\"Use --summary for lightweight counts when full graph payloads are unnecessary.\"],\n },\n list: {\n why: \"Lists active items with deterministic filtering and ordering.\",\n examples: [\n \"pm list --limit 20\",\n \"pm list --type Task --priority 0 --tag release --assignee codex-agent\",\n \"pm list --compact --sort deadline --order asc\",\n \"pm list --fields id,title,parent,type --sort parent --order asc\",\n ],\n },\n \"list-all\": {\n why: \"Lists all item states (including terminal states) when you need full visibility.\",\n examples: [\"pm list-all --limit 50\", \"pm list-all --type Issue --include-body\"],\n },\n \"list-open\": {\n why: \"Shows work that is ready to claim and start.\",\n examples: [\"pm list-open --priority 0 --limit 10\"],\n },\n \"list-in-progress\": {\n why: \"Tracks active execution and owner progress.\",\n examples: [\"pm list-in-progress --assignee codex-agent --limit 20\"],\n },\n \"list-blocked\": {\n why: \"Surfaces blocked work that needs intervention.\",\n examples: [\"pm list-blocked --limit 20\"],\n },\n \"list-closed\": {\n why: \"Reviews completed work and closure outcomes.\",\n examples: [\"pm list-closed --limit 20 --type Task\"],\n },\n \"list-canceled\": {\n why: \"Audits intentionally discontinued work.\",\n examples: [\"pm list-canceled --limit 20\"],\n },\n \"list-draft\": {\n why: \"Finds incompletely defined items that need refinement before execution.\",\n examples: [\"pm list-draft --limit 20\"],\n },\n aggregate: {\n why: \"Runs grouped aggregation queries for governance checks such as decomposition by parent/type or triage by status/priority.\",\n examples: [\n \"pm aggregate --group-by parent,type --count\",\n \"pm aggregate --group-by type,status --count\",\n \"pm aggregate --group-by parent,type --count --status open --parent pm-feature01\",\n ],\n tips: [\"Current aggregate mode is grouped counts only, so pass --count explicitly.\"],\n },\n \"dedupe-audit\": {\n why: \"Audits potential duplicate items and emits deterministic merge suggestions before any mutation.\",\n examples: [\n \"pm dedupe-audit --mode title_exact\",\n \"pm dedupe-audit --mode title_fuzzy --threshold 0.8 --limit 20\",\n \"pm dedupe-audit --mode parent_scope --status open\",\n ],\n tips: [\"Use title_exact for strict collisions, title_fuzzy for near-duplicates, and parent_scope for child-level collisions.\"],\n },\n guide: {\n why: \"Routes local progressive-disclosure documentation so agents can fetch only the context they need.\",\n examples: [\n \"pm install guide-shell --project\",\n \"pm guide\",\n \"pm guide quickstart\",\n \"pm guide commands --depth standard\",\n \"pm guide skills --depth deep --format markdown\",\n \"pm guide release --json\",\n ],\n tips: [\n \"Use brief depth for minimal token footprint, standard for excerpted docs, and deep for full local document rendering.\",\n \"Use --list to force topic index output even when topic parsing is ambiguous.\",\n ],\n },\n calendar: {\n why: \"Provides deadline/reminder/event scheduling views for planning and coordination.\",\n examples: [\n \"pm calendar\",\n \"pm calendar --view agenda --from +0d --to +7d --assignee codex-agent\",\n \"pm calendar --view week --date 2026-04-06 --full-period --include deadlines,events\",\n \"pm calendar --view month --tag release --format json\",\n ],\n tips: [\n \"Day/week/month views are anchored period windows; default mode clips the start to now unless --past or --full-period is set.\",\n \"--full-period applies only to day/week/month views; use --from/--to to bound agenda windows.\",\n ],\n },\n context: {\n why: \"Builds an agent-optimized snapshot of critical active work plus near-term agenda context with progressive depth levels.\",\n examples: [\n \"pm context\",\n \"pm ctx --depth standard --limit 10\",\n \"pm ctx --depth deep --assignee codex-agent\",\n \"pm ctx --section hierarchy --section progress --section blockers\",\n \"pm context --depth standard --activity-limit 20 --stale-threshold 14d\",\n \"pm context --from +0d --to +7d --format markdown --depth deep\",\n ],\n tips: [\n \"High-level focus contains Epics/Features and low-level focus contains Tasks/Issues/Chores/Decisions/Event/Reminder/Milestone/Meeting/Plan.\",\n \"When no open or in-progress work exists, blocked items are shown as fallback context.\",\n \"--depth brief (default) shows focus+agenda; standard adds hierarchy/activity/progress/workload; deep adds blockers/files/staleness/tests.\",\n \"--section overrides --depth and selects specific sections: hierarchy, activity, progress, blockers, files, workload, staleness, tests.\",\n \"Configure defaults via pm config project set context --default-depth standard --activity-limit 15.\",\n ],\n },\n search: {\n why: \"Finds relevant items by keyword, semantic, or hybrid retrieval modes.\",\n examples: [\n 'pm search \"lock stale retry\" --mode keyword --limit 10',\n 'pm search \"extension migration blockers\" --mode hybrid --type Task --priority 0',\n 'pm search \"Cross-Epic Realism Dependency Council\" --mode keyword --title-exact',\n ],\n tips: [\n \"Use --title-exact to require exact normalized title parity, or --phrase-exact to require full-phrase matches in item text fields.\",\n \"Use --include-linked when linked docs/files/tests should influence scoring.\",\n ],\n },\n reindex: {\n why: \"Rebuilds search artifacts after large changes to item corpus or provider/vector config.\",\n examples: [\"pm reindex --mode keyword\", \"pm reindex --mode hybrid --progress --json\"],\n tips: [\n \"Use --progress for non-interactive visibility during local embedding runs.\",\n \"JSON output includes semantic stale/unchanged/embed/upsert counts so agents can gate long reindex work without parsing stderr.\",\n ],\n },\n get: {\n why: \"Shows details for one item by ID, with optional lower-token projections for agent loops.\",\n examples: [\n \"pm get pm-a1b2\",\n \"pm get pm-a1b2 --depth brief --json\",\n \"pm get pm-a1b2 --fields id,title,status,parent,type --json\",\n ],\n tips: [\n \"Default depth is standard for body plus linked artifacts without append-only logs; use brief for metadata-only checks or --full for complete history-heavy metadata.\",\n \"Use --fields for the smallest deterministic item metadata payload when an agent only needs specific fields.\",\n \"JSON output shape is { item, body, linked, claim_state }; body is top-level (not item.body).\",\n ],\n },\n history: {\n why: \"Inspects item mutation timeline and audit trail.\",\n examples: [\"pm history pm-a1b2 --limit 20\", \"pm history pm-a1b2 --full --verify\"],\n },\n \"history-compact\": {\n why: \"Compacts long history streams into a synthetic checkpoint while preserving replay integrity.\",\n examples: [\n \"pm history-compact pm-a1b2 --dry-run\",\n \"pm history-compact pm-a1b2 --before 25 --author codex-agent --message \\\"Compact early history\\\"\",\n \"pm history-compact pm-a1b2 --before 2026-06-01T00:00:00.000Z\",\n ],\n },\n activity: {\n why: \"Reviews recent tracker-wide activity across items.\",\n examples: [\n \"pm activity --limit 50\",\n \"pm activity --full --id pm-a1b2 --limit 50\",\n \"pm activity --id pm-a1b2 --op update --author codex-agent --from -7d --to now\",\n \"pm activity --json --stream rows --limit 200\",\n ],\n tips: [\"Use --stream with --json for line-delimited automation output; --from is inclusive and --to is exclusive.\"],\n },\n restore: {\n why: \"Restores an item to a prior timestamp/version with history replay safety.\",\n examples: ['pm restore pm-a1b2 2026-04-01T00:00:00.000Z --author \"codex-agent\" --message \"Rollback to known-good state\"'],\n },\n close: {\n why: \"Transitions work to terminal closed state with explicit rationale.\",\n examples: [\n 'pm close pm-a1b2 \"All acceptance criteria met\" --author \"codex-agent\" --message \"Close after verification\"',\n 'pm close pm-a1b2 \"Done\" --validate-close',\n 'pm close pm-a1b2 \"Done\" --validate-close off',\n 'pm close pm-a1b2 \"Done\" --validate-close strict',\n ],\n },\n delete: {\n why: \"Removes an item while preserving history evidence and lock/ownership checks.\",\n examples: ['pm delete pm-a1b2 --author \"codex-agent\" --message \"Remove duplicate item\"'],\n },\n append: {\n why: \"Adds implementation notes to body without replacing existing content.\",\n examples: ['pm append pm-a1b2 --body \"Implemented retry with bounded backoff.\" --message \"Record implementation detail\"'],\n },\n comments: {\n why: \"Adds or reviews lightweight status updates linked to an item.\",\n examples: [\n 'pm comments pm-a1b2 \"Verified fix on Linux and macOS\"',\n 'pm comments pm-a1b2 --add \"Verified fix on Linux and macOS\"',\n 'printf \"%s\\\\n\" \"## Verification\" \"- linux pass\" \"- mac pass\" \| pm comments pm-a1b2 --stdin',\n 'pm comments pm-a1b2 --file docs/release-evidence.md --author \"codex-agent\"',\n 'pm comments pm-a1b2 --add \"text: verification note with commas, key-like words, and parser details\"',\n 'pm comments pm-a1b2 --add \"Follow-up needed after review\" --author \"codex-agent\" --force',\n \"pm comments pm-a1b2 --limit 10\",\n ],\n tips: [\n \"Use exactly one comment source at a time: positional [text], --add, --stdin, or --file.\",\n \"Use --force when adding comments to items currently assigned to a different owner.\",\n \"When --add payload resembles CSV-like key fragments (for example text=hello,scope:project), plain-text fallback is intentional; use explicit text=..., markdown text: ..., or stdin token - for structured intent.\",\n ],\n },\n \"comments-audit\": {\n why: \"Audits latest comments or full history rows across filtered item sets.\",\n examples: [\n \"pm comments-audit --status open --latest 1\",\n \"pm comments-audit --status open --latest 0\",\n \"pm comments-audit --parent pm-feature01 --tag governance --sprint sprint-12 --release vnext --priority 0\",\n \"pm comments-audit --full-history --limit 50\",\n ],\n tips: [\n \"Use either --latest or --full-history (not both). --latest 0 returns item summaries without comment rows. --limit is an alias for --limit-items.\",\n ],\n },\n notes: {\n why: \"Adds or reviews durable implementation notes linked to an item.\",\n examples: [\n 'pm notes pm-a1b2 --add \"Investigated parser edge case and documented fallback logic.\"',\n 'pm notes pm-a1b2 --add \"text: parser rationale with commas, colons, and key-like wording\"',\n 'pm notes pm-a1b2 --add \"Audit note\" --author \"reviewer\" --allow-audit-note',\n \"pm notes pm-a1b2 --limit 10\",\n ],\n tips: [\n \"Use --allow-audit-note for append-only non-owner audits; --allow-audit-comment remains supported as a legacy alias.\",\n \"CSV-like add payloads with extra key fragments are treated as plain text by design; use explicit text keys (text= or text:) when structured parsing is required.\",\n ],\n },\n learnings: {\n why: \"Adds or reviews post-implementation learnings for future work.\",\n examples: [\n 'pm learnings pm-a1b2 --add \"Avoid direct test-runner commands in linked tests; use sandbox runner.\"',\n 'pm learnings pm-a1b2 --add \"text: lesson with commas, key-like words, and punctuation-safe context\"',\n 'pm learnings pm-a1b2 --add \"Audit learning\" --author \"reviewer\" --allow-audit-learning',\n \"pm learnings pm-a1b2 --limit 10\",\n ],\n tips: [\n \"Use --allow-audit-learning for append-only non-owner audits; --allow-audit-comment remains supported as a legacy alias.\",\n \"If you intended structured parsing for a key-like payload, prefer explicit text=..., markdown text: ..., or stdin token -; ambiguous CSV-like forms intentionally remain plain text.\",\n ],\n },\n files: {\n why: \"Associates changed source files with tracker items for reproducibility.\",\n examples: [\n 'pm files pm-a1b2 --add \"path=src/cli/main.ts,note=help orchestration\"',\n 'pm files pm-a1b2 --add src/cli/main.ts --note \"help orchestration\"',\n \"pm files discover pm-a1b2\",\n 'pm files discover pm-a1b2 --apply --note \"discovered from item text\"',\n ],\n },\n docs: {\n why: \"Associates relevant documentation paths with tracker items.\",\n examples: [\n 'pm docs pm-a1b2 --add \"path=README.md,note=user-facing command guidance\"',\n 'pm docs pm-a1b2 --add README.md --note \"user-facing command guidance\"',\n ],\n },\n test: {\n why: \"Links test commands/paths and optionally executes them for one item.\",\n examples: [\n 'pm test pm-a1b2 --add \"command=node scripts/run-tests.mjs test -- tests/unit/output.spec.ts,timeout_seconds=2400\"',\n 'pm test pm-a1b2 --add \"command=pm list-all --type Task --limit 200,assert_stdout_contains=count:,assert_stdout_regex=count:\\\\s+\\\\d+\"',\n 'pm test pm-a1b2 --add \"command=pm list-all --type Task --limit 200,pm_context_mode=auto\"',\n \"pm test pm-a1b2 --run --timeout 2400 --env-set PORT=0 --env-clear PLAYWRIGHT_BASE_URL --shared-host-safe --pm-context tracker --fail-on-context-mismatch --fail-on-skipped\",\n \"pm test pm-a1b2 --run --timeout 2400 --pm-context auto\",\n \"pm test pm-a1b2 --run --background --timeout 2400 --progress\",\n ],\n },\n \"test-all\": {\n why: \"Runs linked tests in bulk for release/readiness sweeps.\",\n examples: [\n \"pm test-all --status in_progress --limit 5 --offset 10 --timeout 2400\",\n \"pm test-all --status closed --timeout 3600 --progress --env-set PORT=0 --shared-host-safe --fail-on-skipped\",\n \"pm test-all --status in_progress --pm-context tracker --fail-on-context-mismatch --require-assertions-for-pm\",\n \"pm test-all --status in_progress --pm-context auto --fail-on-context-mismatch\",\n \"pm test-all --status in_progress --background --timeout 3600\",\n ],\n },\n \"test-runs\": {\n why: \"Manages background linked-test runs with lifecycle controls and log/status inspection.\",\n examples: [\n \"pm test-runs list --status running --limit 20\",\n \"pm test-runs status tr-abc123\",\n \"pm test-runs logs tr-abc123 --stream stderr --tail 200\",\n \"pm test-runs stop tr-abc123\",\n \"pm test-runs resume tr-abc123\",\n ],\n },\n stats: {\n why: \"Reports tracker-level totals and distribution by type/status.\",\n examples: [\"pm stats\", \"pm stats --json\"],\n },\n telemetry: {\n why: \"Inspects and manages local telemetry queue/runtime state for observability diagnostics.\",\n examples: [\n \"pm telemetry status\",\n \"pm telemetry stats --limit 10\",\n \"pm telemetry flush\",\n \"pm telemetry clear\",\n ],\n },\n health: {\n why: \"Validates tracker/runtime health including extension triage, migration, and integrity diagnostics.\",\n examples: [\n \"pm health\",\n \"pm health --check-only --summary --json\",\n \"pm health --brief --json\",\n \"pm health --no-refresh\",\n \"pm health --refresh-vectors\",\n ],\n },\n validate: {\n why:\n \"Runs standalone metadata, resolution, lifecycle (including dependency-cycle diagnostics), linked-file, linked-command reference, and history drift checks with default remediation hints for resolution gaps.\",\n examples: [\n \"pm validate\",\n \"pm validate --check-resolution --json\",\n \"pm validate --check-lifecycle --dependency-cycle-severity error\",\n \"pm validate --check-files --scan-mode tracked-all\",\n \"pm validate --check-files --scan-mode tracked-all-strict --include-pm-internals\",\n \"pm validate --check-command-references\",\n \"pm validate --check-resolution --fail-on-warn --json\",\n ],\n tips: [\"Resolution-gap warnings include default `pm update <id> ...` remediation hint templates in check details.\"],\n },\n gc: {\n why: \"Deletes optional cache artifacts by default to keep local tracker state tidy; use --dry-run to preview targets without deleting files.\",\n examples: [\"pm gc --dry-run\", \"pm gc\"],\n },\n claim: {\n why: \"Claims an item to signal active ownership and reduce conflicts.\",\n examples: [\n 'pm claim pm-a1b2 --author \"codex-agent\" --message \"Claim for implementation\"',\n 'pm claim pm-a1b2 --force --author \"codex-agent\" --message \"Take over terminal item\"',\n ],\n tips: [\"Claim takeover for non-terminal items does not require --force; --force is reserved for terminal/lock overrides.\"],\n },\n release: {\n why: \"Releases an active claim when paused, handed off, or completed.\",\n examples: [\n 'pm release pm-a1b2 --author \"codex-agent\" --message \"Release after closure\"',\n 'pm release pm-a1b2 --allow-audit-release --author \"reviewer\" --message \"Audit handoff release\"',\n ],\n tips: [\"Use --allow-audit-release for non-owner handoffs that only clear assignee metadata.\"],\n },\n \"start-task\": {\n why: \"Lifecycle alias that claims an item and sets status to in_progress.\",\n examples: ['pm start-task pm-a1b2 --author \"codex-agent\" --message \"Start implementation\"'],\n },\n \"pause-task\": {\n why: \"Lifecycle alias that sets status to open and releases active assignment.\",\n examples: ['pm pause-task pm-a1b2 --author \"codex-agent\" --message \"Pause for dependency unblock\"'],\n },\n \"close-task\": {\n why: \"Lifecycle alias that closes with reason text and clears assignment metadata.\",\n examples: ['pm close-task pm-a1b2 \"All acceptance criteria met\" --author \"codex-agent\" --message \"Close and handoff\"'],\n },\n completion: {\n why: \"Generates shell completion scripts for faster and more reliable command entry.\",\n examples: [\"pm completion bash\", \"pm completion zsh\", \"pm completion fish\", \"pm completion bash --eager-tags\"],\n tips: [\"Default scripts resolve tag suggestions lazily at completion time; use --eager-tags to embed current tags directly.\"],\n },\n contracts: {\n why: \"Exposes machine-readable CLI command and tool schema contracts for agent integrations.\",\n examples: [\n \"pm contracts\",\n \"pm contracts --command list --runtime-only\",\n \"pm contracts --command update --flags-only\",\n \"pm contracts --availability-only --runtime-only\",\n \"pm contracts --action create\",\n \"pm contracts --schema-only\",\n ],\n tips: [\"Use --command to narrow actions/schema to one CLI surface; combine with --flags-only or --availability-only for lighter payloads.\"],\n },\n};\n\nexport const ROOT_HELP_BUNDLE: HelpBundle = {\n why: \"Provides deterministic project management workflows for humans and coding agents.\",\n examples: [\n \"pm init\",\n \"pm install guide-shell --project\",\n \"pm list-open --limit 10\",\n 'pm create --title \"...\" --description \"...\" --type Task --status open --priority 1 --message \"...\" --create-mode progressive',\n ],\n tips: [\n \"Use <command> --help for command-specific guidance and examples.\",\n \"Install guide-shell before using pm guide for local docs and skills routing.\",\n \"Use --json for machine parsing and integration flows.\",\n \"Use --no-pager to force direct help output in CI and other non-interactive shells.\",\n ],\n};\n\nfunction resolveCanonicalHelpPath(commandPath: string \| undefined): string {\n const normalized = normalizeHelpCommandPath(commandPath ?? \"\");\n if (!normalized) {\n return \"\";\n }\n return HELP_PATH_ALIASES[normalized] ?? normalized;\n}\n\nexport function resolveHelpBundleForPath(commandPath: string \| undefined): HelpBundle {\n const canonicalPath = resolveCanonicalHelpPath(commandPath);\n if (!canonicalPath) {\n return ROOT_HELP_BUNDLE;\n }\n return HELP_BY_COMMAND_PATH[canonicalPath] ?? ROOT_HELP_BUNDLE;\n}\n\nexport function resolveHelpNarrative(commandPath: string \| undefined, detailMode: HelpDetailMode): HelpNarrative {\n const bundle = resolveHelpBundleForPath(commandPath);\n return {\n intent: bundle.why,\n examples: detailMode === \"detailed\" ? [...bundle.examples] : bundle.examples.length > 0 ? [bundle.examples[0]] : [],\n tips: detailMode === \"detailed\" ? [...(bundle.tips ?? [])] : [],\n detail_mode: detailMode,\n };\n}\n\nexport function attachRichHelpText(program: Command, argv: string[] = process.argv.slice(2)): void {\n const detailMode = resolveHelpDetailMode(argv);\n program.addHelpText(\"after\", renderHelpBundle(ROOT_HELP_BUNDLE, detailMode));\n for (const [commandPath, bundle] of Object.entries(HELP_BY_COMMAND_PATH)) {\n attachBundleByPath(program, commandPath, bundle, detailMode);\n }\n}\n"],"names":[],"mappings":"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","debugId":"a1d00ac8-e750-598f-a4ec-20581735dc84"}
1	+ {"version":3,"file":"help-content.js","sources":["cli/help-content.ts"],"sourceRoot":"/","sourcesContent":["import { Command } from \"commander\";\n\nexport interface HelpBundle {\n why: string;\n examples: string[];\n tips?: string[];\n}\n\nexport interface HelpNarrative {\n intent: string;\n examples: string[];\n tips: string[];\n detail_mode: HelpDetailMode;\n}\n\nexport type HelpDetailMode = \"compact\" \| \"detailed\";\n\n// Compact help/narrative surfaces show at most the first example. Centralizing this\n// keeps the empty-examples guard in one place for renderCompactHelpBundle and\n// resolveHelpNarrative (both must degrade to an empty list rather than [undefined]).\nexport function firstExampleOrEmpty(examples: string[]): string[] {\n return examples.length > 0 ? [examples[0]] : [];\n}\n\nfunction renderCompactHelpBundle(bundle: HelpBundle): string {\n const lines: string[] = [\n \"\",\n \"Intent:\",\n ` ${bundle.why}`,\n ];\n const compactExamples = firstExampleOrEmpty(bundle.examples);\n if (compactExamples.length > 0) {\n lines.push(\"\", \"Example:\");\n lines.push(` ${compactExamples[0]}`);\n }\n lines.push(\"\", \"Need deeper rationale and more examples?\");\n lines.push(\" Re-run with --explain.\");\n return lines.join(\"\\n\");\n}\n\nfunction renderDetailedHelpBundle(bundle: HelpBundle): string {\n const lines: string[] = [\n \"\",\n \"Why use this command:\",\n ` ${bundle.why}`,\n \"\",\n \"Examples:\",\n ...bundle.examples.map((example) => ` ${example}`),\n ];\n if (bundle.tips && bundle.tips.length > 0) {\n lines.push(\"\", \"Tips:\");\n lines.push(...bundle.tips.map((tip) => ` - ${tip}`));\n }\n return lines.join(\"\\n\");\n}\n\nfunction renderHelpBundle(bundle: HelpBundle, detailMode: HelpDetailMode): string {\n if (detailMode === \"detailed\") {\n return renderDetailedHelpBundle(bundle);\n }\n return renderCompactHelpBundle(bundle);\n}\n\nexport function normalizeHelpCommandPath(commandPath: string): string {\n return commandPath\n .trim()\n .toLowerCase()\n .split(/\\s+/)\n .filter((part) => part.length > 0)\n .join(\" \");\n}\n\nconst HELP_PATH_ALIASES: Record<string, string> = {\n cal: \"calendar\",\n ctx: \"context\",\n};\n\nfunction findDirectChildCommand(parent: Command, name: string): Command \| null {\n return parent.commands.find((entry) => entry.name() === name) ?? null;\n}\n\nfunction 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\nfunction attachBundleByPath(root: Command, commandPath: string, bundle: HelpBundle, detailMode: HelpDetailMode): void {\n const command = findCommandByPath(root, commandPath.split(\" \").filter((part) => part.length > 0));\n if (!command) {\n return;\n }\n command.addHelpText(\"after\", renderHelpBundle(bundle, detailMode));\n}\n\nexport function resolveHelpDetailMode(argv: string[]): HelpDetailMode {\n if (argv.includes(\"--explain\")) {\n return \"detailed\";\n }\n return \"compact\";\n}\n\nconst HELP_BY_COMMAND_PATH: Record<string, HelpBundle> = {\n init: {\n why: \"Bootstraps tracker storage and settings so all other commands can run safely.\",\n examples: [\n \"pm init\",\n \"pm init acme\",\n \"pm init --preset minimal\",\n \"pm init --agent-guidance add\",\n \"pm init --defaults --with-packages\",\n ],\n tips: [\n \"Run this once per repository before create/list/update commands.\",\n \"Use --preset for non-interactive automation; omit it in a TTY to use the setup wizard.\",\n \"Use --agent-guidance add to inject compact AGENTS/CLAUDE workflow guidance, or --agent-guidance status to inspect missing guidance without modifying files.\",\n \"Use --with-packages when agents need bundled commands such as calendar and templates available immediately.\",\n ],\n },\n config: {\n why: \"Reads or updates project/global settings such as definition-of-done, item format, telemetry, and policy toggles.\",\n examples: [\n 'pm config project get definition-of-done',\n 'pm config project set definition-of-done --criterion \"tests pass\"',\n \"pm config project set item-format --format toon\",\n \"pm config project set sprint-release-format-policy --policy strict_error\",\n \"pm config project set governance-preset --policy minimal\",\n \"pm config project set governance-ownership-enforcement --policy none\",\n \"pm config project set test-result-tracking --policy enabled\",\n \"pm config global set telemetry-tracking --policy disabled\",\n ],\n },\n extension: {\n why:\n \"Compatibility command for package-backed runtime extension lifecycle operations across project or global scope.\",\n examples: [\n \"pm install ./my-package --project\",\n \"pm install '' --project\",\n \"pm package doctor --project --detail summary\",\n \"pm package manage --global\",\n \"pm package activate sample-ext --project\",\n \"pm package deactivate sample-ext --project\",\n \"pm package uninstall sample-ext --global\",\n \"pm extension explore --project\",\n \"pm extension manage --global\",\n \"pm extension doctor --detail deep\",\n ],\n tips: [\n \"Prefer pm install and pm package in new user-facing automation.\",\n \"Use pm extension when maintaining existing extension-specific scripts or debugging the compatibility runtime directly.\",\n \"Bundled aliases beads and todos resolve to package-shipped extension sources.\",\n \"Use --gh/--github shorthand for GitHub sources and --ref to pin a branch, tag, or ref.\",\n \"Install updates settings activation state automatically unless extension allowlist mode is unchanged.\",\n \"Use --adopt for single-extension adoption and --adopt-all to bulk-register unmanaged installs as managed without reinstalling.\",\n \"Use --manage for concise triage summaries and remediation-oriented diagnostics alongside full extension details.\",\n \"Use --doctor for consolidated diagnostics with warning codes, remediation hints, and optional deep detail payloads.\",\n ],\n },\n package: {\n why:\n \"Installs, explores, manages, diagnoses, adopts, activates, deactivates, and refreshes package-backed pm runtime extensions.\",\n examples: [\n \"pm install npm:@scope/pm-package --project\",\n \"pm package install ./my-package --project\",\n \"pm package doctor --project --detail deep\",\n \"pm package manage --project --runtime-probe\",\n \"pm package activate sample-ext --project\",\n \"pm upgrade --packages-only --dry-run\",\n ],\n tips: [\n \"Prefer package vocabulary for user-facing workflows; extension vocabulary remains available for compatibility.\",\n \"Use pm upgrade to refresh the CLI/SDK and managed packages from their recorded sources.\",\n \"Use --dry-run before upgrade when automation needs a deterministic plan.\",\n ],\n },\n \"package init\": {\n why: \"Generates an installable starter pm package with package metadata and a root extension entrypoint.\",\n examples: [\n \"pm package init ./my-package\",\n \"pm install ./my-package --project\",\n \"pm package doctor --project --detail summary\",\n ],\n tips: [\n \"The generated package is local-install safe; add SDK runtime imports only after declaring dependencies and validating with package doctor.\",\n \"Use package doctor after changes to verify activation, policy, and collision diagnostics.\",\n ],\n },\n \"package install\": {\n why: \"Installs pm packages from local paths, npm sources, GitHub sources, bundled aliases, or wildcard/all aliases.\",\n examples: [\n \"pm package install ./my-package --project\",\n \"pm install npm:pm-changelog --project\",\n \"pm package install --github org/repo/packages/my-pm-package --ref main\",\n ],\n tips: [\n \"Prefer the top-level pm install alias in scripts when only installation is needed.\",\n \"Run pm package manage or pm package doctor after installing external packages.\",\n ],\n },\n \"package catalog\": {\n why: \"Lists bundled first-party package catalog metadata and compact field projections.\",\n examples: [\n \"pm package catalog --project\",\n \"pm package catalog --project --fields alias,installed,install_command\",\n \"pm package list --project --fields alias,package_name,category\",\n ],\n tips: [\n \"Use --fields for low-token package discovery in agent loops.\",\n \"External npm package discovery still belongs to npm search.\",\n ],\n },\n \"extension init\": {\n why: \"Generates an installable starter runtime extension with manifest and entrypoint files.\",\n examples: [\n \"pm extension init ./my-extension\",\n \"pm extension --install --project ./my-extension\",\n \"pm extension --doctor --project --detail summary\",\n ],\n tips: [\n \"Use package init for new distributable package workflows; extension init is the compatibility-level runtime scaffold.\",\n ],\n },\n \"extension install\": {\n why: \"Installs a compatibility runtime extension from local, npm, GitHub, bundled alias, or wildcard sources.\",\n examples: [\n \"pm extension install ./my-extension --project\",\n \"pm extension --install --project ./my-extension\",\n \"pm extension doctor --project --detail summary\",\n ],\n tips: [\"Prefer pm install or pm package install for new package-first automation.\"],\n },\n \"extension catalog\": {\n why: \"Compatibility view of bundled package catalog metadata.\",\n examples: [\n \"pm extension catalog --project\",\n \"pm extension catalog --project --fields alias,installed,install_command\",\n ],\n tips: [\"Prefer pm package catalog in new user-facing workflows.\"],\n },\n install: {\n why: \"Installs a pm package into project scope by default, using local, npm, GitHub, or bundled alias sources.\",\n examples: [\n \"pm install '' --project\",\n \"pm install ./packages/pm-todos --project\",\n \"pm install npm:@scope/pm-package --global\",\n \"pm install --github org/repo/packages/my-pm-package --ref main\",\n ],\n tips: [\"Installed packages are recorded in managed state and can be inspected with pm package manage.\"],\n },\n upgrade: {\n why: \"Updates the global pm CLI/SDK and refreshes managed pm packages from recorded install sources.\",\n examples: [\n \"pm upgrade --dry-run\",\n \"pm upgrade --packages-only --project\",\n \"pm upgrade todos --dry-run\",\n \"pm upgrade --cli-only --repair\",\n \"pm upgrade --tag next --dry-run\",\n ],\n tips: [\n \"Omit target to include the CLI/SDK plus all managed packages in the selected scope.\",\n \"Pass a target to refresh one managed package by name, directory, package name, or source.\",\n \"Use --packages-only in repository automation when the global CLI should not be changed.\",\n ],\n },\n create: {\n why: \"Creates a new planning item with deterministic metadata and history.\",\n examples: [\n 'pm create --title \"Harden lock flow\" --description \"Improve stale lock handling\" --type Task --status open --priority 1 --message \"Create lock hardening task\" --create-mode progressive',\n 'pm create --title \"Weekly planning sync\" --description \"Recurring coordination meeting\" --type Meeting --schedule-preset lightweight',\n 'pm create --title \"Asset: Hero model\" --description \"Track playable model asset\" --type Asset --status open --priority 1 --message \"Create asset item\" --type-option category=Character --dep \"id=pm-epic01,kind=parent,author=codex-agent,created_at=now\" --comment \"author=codex-agent,created_at=now,text=Why this asset item exists.\" --note \"author=codex-agent,created_at=now,text=Initial implementation note.\" --learning \"author=codex-agent,created_at=now,text=Durable lesson placeholder.\" --file \"path=src/assets/hero.glb,note=tracked asset\" --test \"command=node scripts/run-tests.mjs test,timeout_seconds=240\" --doc \"path=README.md,note=asset docs\"',\n ],\n tips: [\n \"Use --schedule-preset lightweight for Reminder/Meeting/Event when you want minimal required create inputs.\",\n \"Use --type <value> to load type-aware policy guidance in --help output.\",\n ],\n },\n focus: {\n why: \"Sets a session focused item so new pm create items default their --parent to it (project management = context management).\",\n examples: [\n \"pm focus pm-epic1\",\n \"pm focus\",\n \"pm focus --clear\",\n ],\n tips: [\n \"Focus is session-local (stored in .agents/pm/runtime/session.json, gitignored) — it never affects teammates.\",\n \"An explicit --parent on pm create always overrides the focused item; use --parent \\\"\\\" to create with no parent.\",\n \"A stale focused item produces the same missing-parent validation as an explicit stale --parent.\",\n ],\n },\n update: {\n why: \"Mutates existing item fields while preserving history and lock safety.\",\n examples: [\n 'pm update pm-a1b2 --status in_progress --message \"Start implementation\"',\n 'pm update pm-a1b2 --unset close-reason --message \"Clear stale close reason after reopen\"',\n 'pm update pm-a1b2 --unset assignee --deadline +2d --message \"Replan ownership and deadline\"',\n 'pm update pm-a1b2 --body \"Backfilled body text for legacy item\" --message \"Normalize missing body\"',\n ],\n tips: [\n 'Use \"pm close <ID> <TEXT>\" to close items instead of --status closed.',\n \"When reopening from closed to a non-terminal status, update clears stale close_reason unless explicitly set via --close-reason.\",\n 'Use \"pm append <ID> --body <text>\" for additive notes; use update --body to replace body content.',\n ],\n },\n \"update-many\": {\n why: \"Bulk-updates matched item sets with dry-run previews and rollback checkpoints for safe large-scale metadata changes.\",\n examples: [\n \"pm update-many --filter-status open --status in_progress --dry-run\",\n 'pm update-many --filter-tag wave:7 --replace-tests --test \"command=node scripts/run-tests.mjs test -- tests/core/history.spec.ts,timeout_seconds=240\"',\n 'pm update-many --filter-tag governance --reviewer maintainer-review --message \"Normalize reviewer metadata\"',\n \"pm update-many --rollback ckpt-abc123\",\n ],\n tips: [\n \"Use --dry-run first to inspect proposed changes before apply mode.\",\n \"Linked-array mutation flags mirror pm update semantics (for example --replace-tests, --clear-files, and repeatable --doc/--note seeds).\",\n \"Checkpoints are enabled by default for apply mode and can be restored with --rollback.\",\n ],\n },\n \"close-many\": {\n why: \"Bulk-closes matched items with a shared reason routed through full pm close semantics (close validation, active-child orphan checks, blocked-edge cleanup) plus dry-run previews and rollback checkpoints — unlike update-many --status closed, which bypasses close validation.\",\n examples: [\n 'pm close-many --filter-sprint S-12 --reason \"Sprint S-12 acceptance criteria met\" --dry-run',\n 'pm close-many --filter-tag wave:7 --reason \"Superseded by redesign\" --validate-close warn',\n 'pm close-many --ids pm-a,pm-b,pm-c --reason \"Closed in batch\" --resolution \"Verified by integration suite\"',\n \"pm close-many --rollback close-many-20260604-abc123\",\n ],\n tips: [\n \"At least one filter (--filter-* or --ids) is required so close-many never matches every item.\",\n \"Already-terminal matches are skipped by default; pass --force to re-close them.\",\n \"Use --dry-run to preview matches plus per-item skip reasons and active-child orphan warnings before applying.\",\n \"Checkpoints are enabled by default for apply mode; restore with --rollback <checkpoint-id>.\",\n ],\n },\n normalize: {\n why:\n \"Scans items for low-signal lifecycle metadata drift, emits deterministic per-item plans, and optionally applies normalized metadata updates with update-style safety checks.\",\n examples: [\n \"pm normalize --dry-run\",\n \"pm normalize --filter-status in_progress --dry-run\",\n 'pm normalize --filter-status closed --apply --author \"codex-agent\" --message \"Normalize closure metadata\"',\n ],\n tips: [\n \"Dry-run mode is the default; pass --apply only after reviewing planned changes.\",\n \"Apply mode honors ownership/audit constraints and supports --allow-audit-update with optional --force override.\",\n ],\n },\n templates: {\n why: \"Saves, lists, and inspects reusable create option bundles for repeatable workflows.\",\n examples: [\n 'pm templates save triage-default --title \"Triage item\" --description \"...\" --type Task --status open --priority 2 --message \"Seed triage template\"',\n \"pm templates list\",\n \"pm templates show triage-default\",\n ],\n tips: [\n \"Template names are positional arguments (`pm templates save <name>` and `pm templates show <name>`), not --name flags.\",\n \"Combine templates with explicit create flags; explicit flags always override template defaults.\",\n ],\n },\n deps: {\n why: \"Inspects an item dependency graph as a tree or graph payload to understand blockers and hierarchy links.\",\n examples: [\n \"pm deps pm-a1b2\",\n \"pm deps pm-a1b2 --format graph\",\n \"pm deps pm-a1b2 --max-depth 2 --collapse repeated --summary\",\n ],\n tips: [\"Use --summary for lightweight counts when full graph payloads are unnecessary.\"],\n },\n list: {\n why: \"Lists active items with deterministic filtering and ordering.\",\n examples: [\n \"pm list --limit 20\",\n \"pm list --type Task --priority 0 --tag release --assignee codex-agent\",\n \"pm list --compact --sort deadline --order asc\",\n \"pm list --fields id,title,parent,type --sort parent --order asc\",\n ],\n },\n \"list-all\": {\n why: \"Lists all item states (including terminal states) when you need full visibility.\",\n examples: [\"pm list-all --limit 50\", \"pm list-all --type Issue --include-body\"],\n },\n \"list-open\": {\n why: \"Shows work that is ready to claim and start.\",\n examples: [\"pm list-open --priority 0 --limit 10\"],\n },\n \"list-in-progress\": {\n why: \"Tracks active execution and owner progress.\",\n examples: [\"pm list-in-progress --assignee codex-agent --limit 20\"],\n },\n \"list-blocked\": {\n why: \"Surfaces blocked work that needs intervention.\",\n examples: [\"pm list-blocked --limit 20\"],\n },\n \"list-closed\": {\n why: \"Reviews completed work and closure outcomes.\",\n examples: [\"pm list-closed --limit 20 --type Task\"],\n },\n \"list-canceled\": {\n why: \"Audits intentionally discontinued work.\",\n examples: [\"pm list-canceled --limit 20\"],\n },\n \"list-draft\": {\n why: \"Finds incompletely defined items that need refinement before execution.\",\n examples: [\"pm list-draft --limit 20\"],\n },\n aggregate: {\n why: \"Runs grouped aggregation queries for governance checks such as decomposition by parent/type or triage by status/priority.\",\n examples: [\n \"pm aggregate --group-by parent,type --count\",\n \"pm aggregate --group-by type,status --count\",\n \"pm aggregate --group-by parent,type --count --status open --parent pm-feature01\",\n ],\n tips: [\"Current aggregate mode is grouped counts only, so pass --count explicitly.\"],\n },\n \"dedupe-audit\": {\n why: \"Audits potential duplicate items and emits deterministic merge suggestions before any mutation.\",\n examples: [\n \"pm dedupe-audit --mode title_exact\",\n \"pm dedupe-audit --mode title_fuzzy --threshold 0.8 --limit 20\",\n \"pm dedupe-audit --mode parent_scope --status open\",\n ],\n tips: [\"Use title_exact for strict collisions, title_fuzzy for near-duplicates, and parent_scope for child-level collisions.\"],\n },\n guide: {\n why: \"Routes local progressive-disclosure documentation so agents can fetch only the context they need.\",\n examples: [\n \"pm install guide-shell --project\",\n \"pm guide\",\n \"pm guide quickstart\",\n \"pm guide commands --depth standard\",\n \"pm guide skills --depth deep --format markdown\",\n \"pm guide release --json\",\n ],\n tips: [\n \"Use brief depth for minimal token footprint, standard for excerpted docs, and deep for full local document rendering.\",\n \"Use --list to force topic index output even when topic parsing is ambiguous.\",\n ],\n },\n calendar: {\n why: \"Provides deadline/reminder/event scheduling views for planning and coordination.\",\n examples: [\n \"pm calendar\",\n \"pm calendar --view agenda --from +0d --to +7d --assignee codex-agent\",\n \"pm calendar --view week --date 2026-04-06 --full-period --include deadlines,events\",\n \"pm calendar --view month --tag release --format json\",\n ],\n tips: [\n \"Day/week/month views are anchored period windows; default mode clips the start to now unless --past or --full-period is set.\",\n \"--full-period applies only to day/week/month views; use --from/--to to bound agenda windows.\",\n ],\n },\n context: {\n why: \"Builds an agent-optimized snapshot of critical active work plus near-term agenda context with progressive depth levels.\",\n examples: [\n \"pm context\",\n \"pm ctx --depth standard --limit 10\",\n \"pm ctx --depth deep --assignee codex-agent\",\n \"pm ctx --section hierarchy --section progress --section blockers\",\n \"pm context --depth standard --activity-limit 20 --stale-threshold 14d\",\n \"pm context --from +0d --to +7d --format markdown --depth deep\",\n ],\n tips: [\n \"High-level focus contains Epics/Features and low-level focus contains Tasks/Issues/Chores/Decisions/Event/Reminder/Milestone/Meeting/Plan.\",\n \"When no open or in-progress work exists, blocked items are shown as fallback context.\",\n \"--depth brief (default) shows focus+agenda; standard adds hierarchy/activity/progress/workload; deep adds blockers/files/staleness/tests.\",\n \"--section overrides --depth and selects specific sections: hierarchy, activity, progress, blockers, files, workload, staleness, tests.\",\n \"Configure defaults via pm config project set context --default-depth standard --activity-limit 15.\",\n ],\n },\n search: {\n why: \"Finds relevant items by keyword, semantic, or hybrid retrieval modes.\",\n examples: [\n 'pm search \"lock stale retry\" --mode keyword --limit 10',\n 'pm search \"extension migration blockers\" --mode hybrid --type Task --priority 0',\n 'pm search \"Cross-Epic Realism Dependency Council\" --mode keyword --title-exact',\n ],\n tips: [\n \"Use --title-exact to require exact normalized title parity, or --phrase-exact to require full-phrase matches in item text fields.\",\n \"Use --include-linked when linked docs/files/tests should influence scoring.\",\n ],\n },\n reindex: {\n why: \"Rebuilds search artifacts after large changes to item corpus or provider/vector config.\",\n examples: [\"pm reindex --mode keyword\", \"pm reindex --mode hybrid --progress --json\"],\n tips: [\n \"Use --progress for non-interactive visibility during local embedding runs.\",\n \"JSON output includes semantic stale/unchanged/embed/upsert counts so agents can gate long reindex work without parsing stderr.\",\n ],\n },\n get: {\n why: \"Shows details for one item by ID, with optional lower-token projections for agent loops.\",\n examples: [\n \"pm get pm-a1b2\",\n \"pm get pm-a1b2 --depth brief --json\",\n \"pm get pm-a1b2 --fields id,title,status,parent,type --json\",\n ],\n tips: [\n \"Default depth is standard for body plus linked artifacts without append-only logs; use brief for metadata-only checks or --full for complete history-heavy metadata.\",\n \"Use --fields for the smallest deterministic item metadata payload when an agent only needs specific fields.\",\n \"JSON output shape is { item, linked, claim_state, children }; body is nested at item.body (parity with list --include-body), and children appears for requested/container rollups.\",\n ],\n },\n history: {\n why: \"Inspects item mutation timeline and audit trail.\",\n examples: [\"pm history pm-a1b2 --limit 20\", \"pm history pm-a1b2 --full --verify\"],\n },\n \"history-compact\": {\n why: \"Compacts long history streams into a synthetic checkpoint while preserving replay integrity.\",\n examples: [\n \"pm history-compact pm-a1b2 --dry-run\",\n \"pm history-compact pm-a1b2 --before 25 --author codex-agent --message \\\"Compact early history\\\"\",\n \"pm history-compact pm-a1b2 --before 2026-06-01T00:00:00.000Z\",\n ],\n },\n activity: {\n why: \"Reviews recent tracker-wide activity across items.\",\n examples: [\n \"pm activity --limit 50\",\n \"pm activity --full --id pm-a1b2 --limit 50\",\n \"pm activity --id pm-a1b2 --op update --author codex-agent --from -7d --to now\",\n \"pm activity --json --stream rows --limit 200\",\n ],\n tips: [\"Use --stream with --json for line-delimited automation output; --from is inclusive and --to is exclusive.\"],\n },\n restore: {\n why: \"Restores an item to a prior timestamp/version with history replay safety.\",\n examples: ['pm restore pm-a1b2 2026-04-01T00:00:00.000Z --author \"codex-agent\" --message \"Rollback to known-good state\"'],\n },\n close: {\n why: \"Transitions work to terminal closed state with explicit rationale.\",\n examples: [\n 'pm close pm-a1b2 \"All acceptance criteria met\" --author \"codex-agent\" --message \"Close after verification\"',\n 'pm close pm-a1b2 \"Done\" --validate-close',\n 'pm close pm-a1b2 \"Done\" --validate-close off',\n 'pm close pm-a1b2 \"Done\" --validate-close strict',\n ],\n },\n delete: {\n why: \"Removes an item while preserving history evidence and lock/ownership checks.\",\n examples: ['pm delete pm-a1b2 --author \"codex-agent\" --message \"Remove duplicate item\"'],\n },\n append: {\n why: \"Adds implementation notes to body without replacing existing content.\",\n examples: ['pm append pm-a1b2 --body \"Implemented retry with bounded backoff.\" --message \"Record implementation detail\"'],\n },\n comments: {\n why: \"Adds or reviews lightweight status updates linked to an item.\",\n examples: [\n 'pm comments pm-a1b2 \"Verified fix on Linux and macOS\"',\n 'pm comments pm-a1b2 --add \"Verified fix on Linux and macOS\"',\n 'printf \"%s\\\\n\" \"## Verification\" \"- linux pass\" \"- mac pass\" \| pm comments pm-a1b2 --stdin',\n 'pm comments pm-a1b2 --file docs/release-evidence.md --author \"codex-agent\"',\n 'pm comments pm-a1b2 --add \"text: verification note with commas, key-like words, and parser details\"',\n 'pm comments pm-a1b2 --add \"Follow-up needed after review\" --author \"codex-agent\" --force',\n \"pm comments pm-a1b2 --limit 10\",\n ],\n tips: [\n \"Use exactly one comment source at a time: positional [text], --add, --stdin, or --file.\",\n \"Use --force when adding comments to items currently assigned to a different owner.\",\n \"When --add payload resembles CSV-like key fragments (for example text=hello,scope:project), plain-text fallback is intentional; use explicit text=..., markdown text: ..., or stdin token - for structured intent.\",\n ],\n },\n \"comments-audit\": {\n why: \"Audits latest comments or full history rows across filtered item sets.\",\n examples: [\n \"pm comments-audit --status open --latest 1\",\n \"pm comments-audit --status open --latest 0\",\n \"pm comments-audit --parent pm-feature01 --tag governance --sprint sprint-12 --release vnext --priority 0\",\n \"pm comments-audit --full-history --limit 50\",\n ],\n tips: [\n \"Use either --latest or --full-history (not both). --latest 0 returns item summaries without comment rows. --limit is an alias for --limit-items.\",\n ],\n },\n notes: {\n why: \"Adds or reviews durable implementation notes linked to an item.\",\n examples: [\n 'pm notes pm-a1b2 --add \"Investigated parser edge case and documented fallback logic.\"',\n 'pm notes pm-a1b2 --add \"text: parser rationale with commas, colons, and key-like wording\"',\n 'pm notes pm-a1b2 --add \"Audit note\" --author \"reviewer\" --allow-audit-note',\n \"pm notes pm-a1b2 --limit 10\",\n ],\n tips: [\n \"Use --allow-audit-note for append-only non-owner audits; --allow-audit-comment remains supported as a legacy alias.\",\n \"CSV-like add payloads with extra key fragments are treated as plain text by design; use explicit text keys (text= or text:) when structured parsing is required.\",\n ],\n },\n learnings: {\n why: \"Adds or reviews post-implementation learnings for future work.\",\n examples: [\n 'pm learnings pm-a1b2 --add \"Avoid direct test-runner commands in linked tests; use sandbox runner.\"',\n 'pm learnings pm-a1b2 --add \"text: lesson with commas, key-like words, and punctuation-safe context\"',\n 'pm learnings pm-a1b2 --add \"Audit learning\" --author \"reviewer\" --allow-audit-learning',\n \"pm learnings pm-a1b2 --limit 10\",\n ],\n tips: [\n \"Use --allow-audit-learning for append-only non-owner audits; --allow-audit-comment remains supported as a legacy alias.\",\n \"If you intended structured parsing for a key-like payload, prefer explicit text=..., markdown text: ..., or stdin token -; ambiguous CSV-like forms intentionally remain plain text.\",\n ],\n },\n files: {\n why: \"Associates changed source files with tracker items for reproducibility.\",\n examples: [\n 'pm files pm-a1b2 --add \"path=src/cli/main.ts,note=help orchestration\"',\n 'pm files pm-a1b2 --add src/cli/main.ts --note \"help orchestration\"',\n \"pm files discover pm-a1b2\",\n 'pm files discover pm-a1b2 --apply --note \"discovered from item text\"',\n ],\n },\n docs: {\n why: \"Associates relevant documentation paths with tracker items.\",\n examples: [\n 'pm docs pm-a1b2 --add \"path=README.md,note=user-facing command guidance\"',\n 'pm docs pm-a1b2 --add README.md --note \"user-facing command guidance\"',\n ],\n },\n test: {\n why: \"Links test commands/paths and optionally executes them for one item.\",\n examples: [\n 'pm test pm-a1b2 --add \"command=node scripts/run-tests.mjs test -- tests/unit/output.spec.ts,timeout_seconds=2400\"',\n 'pm test pm-a1b2 --add \"command=pm list-all --type Task --limit 200,assert_stdout_contains=count:,assert_stdout_regex=count:\\\\s+\\\\d+\"',\n 'pm test pm-a1b2 --add \"command=pm list-all --type Task --limit 200,pm_context_mode=auto\"',\n \"pm test pm-a1b2 --run --timeout 2400 --env-set PORT=0 --env-clear PLAYWRIGHT_BASE_URL --shared-host-safe --pm-context tracker --fail-on-context-mismatch --fail-on-skipped\",\n \"pm test pm-a1b2 --run --timeout 2400 --pm-context auto\",\n \"pm test pm-a1b2 --run --background --timeout 2400 --progress\",\n ],\n },\n \"test-all\": {\n why: \"Runs linked tests in bulk for release/readiness sweeps.\",\n examples: [\n \"pm test-all --status in_progress --limit 5 --offset 10 --timeout 2400\",\n \"pm test-all --status closed --timeout 3600 --progress --env-set PORT=0 --shared-host-safe --fail-on-skipped\",\n \"pm test-all --status in_progress --pm-context tracker --fail-on-context-mismatch --require-assertions-for-pm\",\n \"pm test-all --status in_progress --pm-context auto --fail-on-context-mismatch\",\n \"pm test-all --status in_progress --background --timeout 3600\",\n ],\n },\n \"test-runs\": {\n why: \"Manages background linked-test runs with lifecycle controls and log/status inspection.\",\n examples: [\n \"pm test-runs list --status running --limit 20\",\n \"pm test-runs status tr-abc123\",\n \"pm test-runs logs tr-abc123 --stream stderr --tail 200\",\n \"pm test-runs stop tr-abc123\",\n \"pm test-runs resume tr-abc123\",\n ],\n },\n stats: {\n why: \"Reports tracker-level totals and distribution by type/status.\",\n examples: [\"pm stats\", \"pm stats --json\"],\n },\n telemetry: {\n why: \"Inspects and manages local telemetry queue/runtime state for observability diagnostics.\",\n examples: [\n \"pm telemetry status\",\n \"pm telemetry stats --limit 10\",\n \"pm telemetry flush\",\n \"pm telemetry clear\",\n ],\n },\n health: {\n why: \"Validates tracker/runtime health including extension triage, migration, and integrity diagnostics.\",\n examples: [\n \"pm health\",\n \"pm health --check-only --summary --json\",\n \"pm health --brief --json\",\n \"pm health --no-refresh\",\n \"pm health --refresh-vectors\",\n ],\n },\n validate: {\n why:\n \"Runs standalone metadata, resolution, lifecycle (including dependency-cycle diagnostics), linked-file, linked-command reference, and history drift checks with default remediation hints for resolution gaps.\",\n examples: [\n \"pm validate\",\n \"pm validate --check-resolution --json\",\n \"pm validate --check-lifecycle --dependency-cycle-severity error\",\n \"pm validate --check-files --scan-mode tracked-all\",\n \"pm validate --check-files --scan-mode tracked-all-strict --include-pm-internals\",\n \"pm validate --check-command-references\",\n \"pm validate --check-resolution --fail-on-warn --json\",\n ],\n tips: [\"Resolution-gap warnings include default `pm update <id> ...` remediation hint templates in check details.\"],\n },\n gc: {\n why: \"Deletes optional cache artifacts by default to keep local tracker state tidy; use --dry-run to preview targets without deleting files.\",\n examples: [\"pm gc --dry-run\", \"pm gc\"],\n },\n claim: {\n why: \"Claims an item to signal active ownership and reduce conflicts.\",\n examples: [\n 'pm claim pm-a1b2 --author \"codex-agent\" --message \"Claim for implementation\"',\n 'pm claim pm-a1b2 --force --author \"codex-agent\" --message \"Take over terminal item\"',\n ],\n tips: [\"Claim takeover for non-terminal items does not require --force; --force is reserved for terminal/lock overrides.\"],\n },\n release: {\n why: \"Releases an active claim when paused, handed off, or completed.\",\n examples: [\n 'pm release pm-a1b2 --author \"codex-agent\" --message \"Release after closure\"',\n 'pm release pm-a1b2 --allow-audit-release --author \"reviewer\" --message \"Audit handoff release\"',\n ],\n tips: [\"Use --allow-audit-release for non-owner handoffs that only clear assignee metadata.\"],\n },\n \"start-task\": {\n why: \"Lifecycle alias that claims an item and sets status to in_progress.\",\n examples: ['pm start-task pm-a1b2 --author \"codex-agent\" --message \"Start implementation\"'],\n },\n \"pause-task\": {\n why: \"Lifecycle alias that sets status to open and releases active assignment.\",\n examples: ['pm pause-task pm-a1b2 --author \"codex-agent\" --message \"Pause for dependency unblock\"'],\n },\n \"close-task\": {\n why: \"Lifecycle alias that closes with reason text and clears assignment metadata.\",\n examples: ['pm close-task pm-a1b2 \"All acceptance criteria met\" --author \"codex-agent\" --message \"Close and handoff\"'],\n },\n completion: {\n why: \"Generates shell completion scripts for faster and more reliable command entry.\",\n examples: [\"pm completion bash\", \"pm completion zsh\", \"pm completion fish\", \"pm completion bash --eager-tags\"],\n tips: [\"Default scripts resolve tag suggestions lazily at completion time; use --eager-tags to embed current tags directly.\"],\n },\n contracts: {\n why: \"Exposes machine-readable CLI command and tool schema contracts for agent integrations.\",\n examples: [\n \"pm contracts\",\n \"pm contracts --command list --runtime-only\",\n \"pm contracts --command update --flags-only\",\n \"pm contracts --availability-only --runtime-only\",\n \"pm contracts --action create\",\n \"pm contracts --schema-only\",\n ],\n tips: [\"Use --command to narrow actions/schema to one CLI surface; combine with --flags-only or --availability-only for lighter payloads.\"],\n },\n};\n\nexport const ROOT_HELP_BUNDLE: HelpBundle = {\n why: \"Provides deterministic project management workflows for humans and coding agents.\",\n examples: [\n \"pm init\",\n \"pm install guide-shell --project\",\n \"pm list-open --limit 10\",\n 'pm create --title \"...\" --description \"...\" --type Task --status open --priority 1 --message \"...\" --create-mode progressive',\n ],\n tips: [\n \"Use <command> --help for command-specific guidance and examples.\",\n \"Install guide-shell before using pm guide for local docs and skills routing.\",\n \"Use --json for machine parsing and integration flows.\",\n \"Use --no-pager to force direct help output in CI and other non-interactive shells.\",\n ],\n};\n\nfunction resolveCanonicalHelpPath(commandPath: string \| undefined): string {\n const normalized = normalizeHelpCommandPath(commandPath ?? \"\");\n if (!normalized) {\n return \"\";\n }\n return HELP_PATH_ALIASES[normalized] ?? normalized;\n}\n\nexport function resolveHelpBundleForPath(commandPath: string \| undefined): HelpBundle {\n const canonicalPath = resolveCanonicalHelpPath(commandPath);\n if (!canonicalPath) {\n return ROOT_HELP_BUNDLE;\n }\n return HELP_BY_COMMAND_PATH[canonicalPath] ?? ROOT_HELP_BUNDLE;\n}\n\nexport function resolveHelpNarrative(commandPath: string \| undefined, detailMode: HelpDetailMode): HelpNarrative {\n const bundle = resolveHelpBundleForPath(commandPath);\n return {\n intent: bundle.why,\n examples: detailMode === \"detailed\" ? [...bundle.examples] : firstExampleOrEmpty(bundle.examples),\n tips: detailMode === \"detailed\" ? [...(bundle.tips ?? [])] : [],\n detail_mode: detailMode,\n };\n}\n\nexport function attachRichHelpText(program: Command, argv: string[] = process.argv.slice(2)): void {\n const detailMode = resolveHelpDetailMode(argv);\n program.addHelpText(\"after\", renderHelpBundle(ROOT_HELP_BUNDLE, detailMode));\n for (const [commandPath, bundle] of Object.entries(HELP_BY_COMMAND_PATH)) {\n attachBundleByPath(program, commandPath, bundle, detailMode);\n }\n}\n\nexport const _testOnly = {\n renderCompactHelpBundle,\n renderDetailedHelpBundle,\n};\n"],"names":[],"mappings":"AAiBA,oFAAoF;AACpF,8EAA8E;AAC9E,qFAAqF;;;AACrF,MAAM,UAAU,mBAAmB,CAAC,QAAkB;IACpD,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAkB;IACjD,MAAM,KAAK,GAAa;QACtB,EAAE;QACF,SAAS;QACT,KAAK,MAAM,CAAC,GAAG,EAAE;KAClB,CAAC;IACF,MAAM,eAAe,GAAG,mBAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7D,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,0CAA0C,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAkB;IAClD,MAAM,KAAK,GAAa;QACtB,EAAE;QACF,uBAAuB;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE;QACjB,EAAE;QACF,WAAW;QACX,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC;KACpD,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAkB,EAAE,UAA0B;IACtE,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;QAC9B,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,OAAO,WAAW;SACf,IAAI,EAAE;SACN,WAAW,EAAE;SACb,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,iBAAiB,GAA2B;IAChD,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,SAAS;CACf,CAAC;AAEF,SAAS,sBAAsB,CAAC,MAAe,EAAE,IAAY;IAC3D,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC;AACxE,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAa,EAAE,SAAmB;IAC3D,IAAI,OAAO,GAAY,IAAI,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAa,EAAE,WAAmB,EAAE,MAAkB,EAAE,UAA0B;IAC5G,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAClG,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IACD,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAc;IAClD,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,oBAAoB,GAA+B;IACvD,IAAI,EAAE;QACJ,GAAG,EAAE,+EAA+E;QACpF,QAAQ,EAAE;YACR,SAAS;YACT,cAAc;YACd,0BAA0B;YAC1B,8BAA8B;YAC9B,oCAAoC;SACrC;QACD,IAAI,EAAE;YACJ,kEAAkE;YAClE,wFAAwF;YACxF,6JAA6J;YAC7J,6GAA6G;SAC9G;KACF;IACD,MAAM,EAAE;QACN,GAAG,EAAE,kHAAkH;QACvH,QAAQ,EAAE;YACR,0CAA0C;YAC1C,mEAAmE;YACnE,iDAAiD;YACjD,0EAA0E;YAC1E,0DAA0D;YAC1D,sEAAsE;YACtE,6DAA6D;YAC7D,2DAA2D;SAC5D;KACF;IACD,SAAS,EAAE;QACT,GAAG,EACD,iHAAiH;QACnH,QAAQ,EAAE;YACR,mCAAmC;YACnC,0BAA0B;YAC1B,8CAA8C;YAC9C,4BAA4B;YAC5B,0CAA0C;YAC1C,4CAA4C;YAC5C,0CAA0C;YAC1C,gCAAgC;YAChC,8BAA8B;YAC9B,mCAAmC;SACpC;QACD,IAAI,EAAE;YACJ,iEAAiE;YACjE,wHAAwH;YACxH,+EAA+E;YAC/E,wFAAwF;YACxF,uGAAuG;YACvG,gIAAgI;YAChI,kHAAkH;YAClH,qHAAqH;SACtH;KACF;IACD,OAAO,EAAE;QACP,GAAG,EACD,6HAA6H;QAC/H,QAAQ,EAAE;YACR,4CAA4C;YAC5C,2CAA2C;YAC3C,2CAA2C;YAC3C,6CAA6C;YAC7C,0CAA0C;YAC1C,sCAAsC;SACvC;QACD,IAAI,EAAE;YACJ,gHAAgH;YAChH,yFAAyF;YACzF,0EAA0E;SAC3E;KACF;IACD,cAAc,EAAE;QACd,GAAG,EAAE,oGAAoG;QACzG,QAAQ,EAAE;YACR,8BAA8B;YAC9B,mCAAmC;YACnC,8CAA8C;SAC/C;QACD,IAAI,EAAE;YACJ,4IAA4I;YAC5I,2FAA2F;SAC5F;KACF;IACD,iBAAiB,EAAE;QACjB,GAAG,EAAE,+GAA+G;QACpH,QAAQ,EAAE;YACR,2CAA2C;YAC3C,uCAAuC;YACvC,wEAAwE;SACzE;QACD,IAAI,EAAE;YACJ,oFAAoF;YACpF,gFAAgF;SACjF;KACF;IACD,iBAAiB,EAAE;QACjB,GAAG,EAAE,mFAAmF;QACxF,QAAQ,EAAE;YACR,8BAA8B;YAC9B,uEAAuE;YACvE,gEAAgE;SACjE;QACD,IAAI,EAAE;YACJ,8DAA8D;YAC9D,6DAA6D;SAC9D;KACF;IACD,gBAAgB,EAAE;QAChB,GAAG,EAAE,wFAAwF;QAC7F,QAAQ,EAAE;YACR,kCAAkC;YAClC,iDAAiD;YACjD,kDAAkD;SACnD;QACD,IAAI,EAAE;YACJ,uHAAuH;SACxH;KACF;IACD,mBAAmB,EAAE;QACnB,GAAG,EAAE,yGAAyG;QAC9G,QAAQ,EAAE;YACR,+CAA+C;YAC/C,iDAAiD;YACjD,gDAAgD;SACjD;QACD,IAAI,EAAE,CAAC,2EAA2E,CAAC;KACpF;IACD,mBAAmB,EAAE;QACnB,GAAG,EAAE,yDAAyD;QAC9D,QAAQ,EAAE;YACR,gCAAgC;YAChC,yEAAyE;SAC1E;QACD,IAAI,EAAE,CAAC,yDAAyD,CAAC;KAClE;IACD,OAAO,EAAE;QACP,GAAG,EAAE,0GAA0G;QAC/G,QAAQ,EAAE;YACR,0BAA0B;YAC1B,0CAA0C;YAC1C,2CAA2C;YAC3C,gEAAgE;SACjE;QACD,IAAI,EAAE,CAAC,+FAA+F,CAAC;KACxG;IACD,OAAO,EAAE;QACP,GAAG,EAAE,gGAAgG;QACrG,QAAQ,EAAE;YACR,sBAAsB;YACtB,sCAAsC;YACtC,4BAA4B;YAC5B,gCAAgC;YAChC,iCAAiC;SAClC;QACD,IAAI,EAAE;YACJ,qFAAqF;YACrF,2FAA2F;YAC3F,yFAAyF;SAC1F;KACF;IACD,MAAM,EAAE;QACN,GAAG,EAAE,sEAAsE;QAC3E,QAAQ,EAAE;YACR,0LAA0L;YAC1L,sIAAsI;YACtI,yoBAAyoB;SAC1oB;QACD,IAAI,EAAE;YACJ,4GAA4G;YAC5G,yEAAyE;SAC1E;KACF;IACD,KAAK,EAAE;QACL,GAAG,EAAE,4HAA4H;QACjI,QAAQ,EAAE;YACR,mBAAmB;YACnB,UAAU;YACV,kBAAkB;SACnB;QACD,IAAI,EAAE;YACJ,8GAA8G;YAC9G,kHAAkH;YAClH,iGAAiG;SAClG;KACF;IACD,MAAM,EAAE;QACN,GAAG,EAAE,wEAAwE;QAC7E,QAAQ,EAAE;YACR,yEAAyE;YACzE,0FAA0F;YAC1F,6FAA6F;YAC7F,oGAAoG;SACrG;QACD,IAAI,EAAE;YACJ,uEAAuE;YACvE,iIAAiI;YACjI,mGAAmG;SACpG;KACF;IACD,aAAa,EAAE;QACb,GAAG,EAAE,sHAAsH;QAC3H,QAAQ,EAAE;YACR,oEAAoE;YACpE,uJAAuJ;YACvJ,6GAA6G;YAC7G,uCAAuC;SACxC;QACD,IAAI,EAAE;YACJ,oEAAoE;YACpE,yIAAyI;YACzI,wFAAwF;SACzF;KACF;IACD,YAAY,EAAE;QACZ,GAAG,EAAE,kRAAkR;QACvR,QAAQ,EAAE;YACR,6FAA6F;YAC7F,2FAA2F;YAC3F,4GAA4G;YAC5G,qDAAqD;SACtD;QACD,IAAI,EAAE;YACJ,+FAA+F;YAC/F,iFAAiF;YACjF,+GAA+G;YAC/G,6FAA6F;SAC9F;KACF;IACD,SAAS,EAAE;QACT,GAAG,EACD,8KAA8K;QAChL,QAAQ,EAAE;YACR,wBAAwB;YACxB,oDAAoD;YACpD,2GAA2G;SAC5G;QACD,IAAI,EAAE;YACJ,iFAAiF;YACjF,iHAAiH;SAClH;KACF;IACD,SAAS,EAAE;QACT,GAAG,EAAE,qFAAqF;QAC1F,QAAQ,EAAE;YACR,oJAAoJ;YACpJ,mBAAmB;YACnB,kCAAkC;SACnC;QACD,IAAI,EAAE;YACJ,wHAAwH;YACxH,iGAAiG;SAClG;KACF;IACD,IAAI,EAAE;QACJ,GAAG,EAAE,0GAA0G;QAC/G,QAAQ,EAAE;YACR,iBAAiB;YACjB,gCAAgC;YAChC,6DAA6D;SAC9D;QACD,IAAI,EAAE,CAAC,gFAAgF,CAAC;KACzF;IACD,IAAI,EAAE;QACJ,GAAG,EAAE,+DAA+D;QACpE,QAAQ,EAAE;YACR,oBAAoB;YACpB,uEAAuE;YACvE,+CAA+C;YAC/C,iEAAiE;SAClE;KACF;IACD,UAAU,EAAE;QACV,GAAG,EAAE,kFAAkF;QACvF,QAAQ,EAAE,CAAC,wBAAwB,EAAE,yCAAyC,CAAC;KAChF;IACD,WAAW,EAAE;QACX,GAAG,EAAE,8CAA8C;QACnD,QAAQ,EAAE,CAAC,sCAAsC,CAAC;KACnD;IACD,kBAAkB,EAAE;QAClB,GAAG,EAAE,6CAA6C;QAClD,QAAQ,EAAE,CAAC,uDAAuD,CAAC;KACpE;IACD,cAAc,EAAE;QACd,GAAG,EAAE,gDAAgD;QACrD,QAAQ,EAAE,CAAC,4BAA4B,CAAC;KACzC;IACD,aAAa,EAAE;QACb,GAAG,EAAE,8CAA8C;QACnD,QAAQ,EAAE,CAAC,uCAAuC,CAAC;KACpD;IACD,eAAe,EAAE;QACf,GAAG,EAAE,yCAAyC;QAC9C,QAAQ,EAAE,CAAC,6BAA6B,CAAC;KAC1C;IACD,YAAY,EAAE;QACZ,GAAG,EAAE,yEAAyE;QAC9E,QAAQ,EAAE,CAAC,0BAA0B,CAAC;KACvC;IACD,SAAS,EAAE;QACT,GAAG,EAAE,2HAA2H;QAChI,QAAQ,EAAE;YACR,6CAA6C;YAC7C,6CAA6C;YAC7C,iFAAiF;SAClF;QACD,IAAI,EAAE,CAAC,4EAA4E,CAAC;KACrF;IACD,cAAc,EAAE;QACd,GAAG,EAAE,iGAAiG;QACtG,QAAQ,EAAE;YACR,oCAAoC;YACpC,+DAA+D;YAC/D,mDAAmD;SACpD;QACD,IAAI,EAAE,CAAC,sHAAsH,CAAC;KAC/H;IACD,KAAK,EAAE;QACL,GAAG,EAAE,mGAAmG;QACxG,QAAQ,EAAE;YACR,kCAAkC;YAClC,UAAU;YACV,qBAAqB;YACrB,oCAAoC;YACpC,gDAAgD;YAChD,yBAAyB;SAC1B;QACD,IAAI,EAAE;YACJ,uHAAuH;YACvH,8EAA8E;SAC/E;KACF;IACD,QAAQ,EAAE;QACR,GAAG,EAAE,kFAAkF;QACvF,QAAQ,EAAE;YACR,aAAa;YACb,sEAAsE;YACtE,oFAAoF;YACpF,sDAAsD;SACvD;QACD,IAAI,EAAE;YACJ,8HAA8H;YAC9H,8FAA8F;SAC/F;KACF;IACD,OAAO,EAAE;QACP,GAAG,EAAE,yHAAyH;QAC9H,QAAQ,EAAE;YACR,YAAY;YACZ,oCAAoC;YACpC,4CAA4C;YAC5C,kEAAkE;YAClE,uEAAuE;YACvE,+DAA+D;SAChE;QACD,IAAI,EAAE;YACJ,4IAA4I;YAC5I,uFAAuF;YACvF,2IAA2I;YAC3I,wIAAwI;YACxI,oGAAoG;SACrG;KACF;IACD,MAAM,EAAE;QACN,GAAG,EAAE,uEAAuE;QAC5E,QAAQ,EAAE;YACR,wDAAwD;YACxD,iFAAiF;YACjF,gFAAgF;SACjF;QACD,IAAI,EAAE;YACJ,mIAAmI;YACnI,6EAA6E;SAC9E;KACF;IACD,OAAO,EAAE;QACP,GAAG,EAAE,yFAAyF;QAC9F,QAAQ,EAAE,CAAC,2BAA2B,EAAE,4CAA4C,CAAC;QACrF,IAAI,EAAE;YACJ,4EAA4E;YAC5E,gIAAgI;SACjI;KACF;IACD,GAAG,EAAE;QACH,GAAG,EAAE,0FAA0F;QAC/F,QAAQ,EAAE;YACR,gBAAgB;YAChB,qCAAqC;YACrC,4DAA4D;SAC7D;QACD,IAAI,EAAE;YACJ,sKAAsK;YACtK,6GAA6G;YAC7G,oLAAoL;SACrL;KACF;IACD,OAAO,EAAE;QACP,GAAG,EAAE,kDAAkD;QACvD,QAAQ,EAAE,CAAC,+BAA+B,EAAE,oCAAoC,CAAC;KAClF;IACD,iBAAiB,EAAE;QACjB,GAAG,EAAE,8FAA8F;QACnG,QAAQ,EAAE;YACR,sCAAsC;YACtC,iGAAiG;YACjG,8DAA8D;SAC/D;KACF;IACD,QAAQ,EAAE;QACR,GAAG,EAAE,oDAAoD;QACzD,QAAQ,EAAE;YACR,wBAAwB;YACxB,4CAA4C;YAC5C,+EAA+E;YAC/E,8CAA8C;SAC/C;QACD,IAAI,EAAE,CAAC,2GAA2G,CAAC;KACpH;IACD,OAAO,EAAE;QACP,GAAG,EAAE,2EAA2E;QAChF,QAAQ,EAAE,CAAC,6GAA6G,CAAC;KAC1H;IACD,KAAK,EAAE;QACL,GAAG,EAAE,oEAAoE;QACzE,QAAQ,EAAE;YACR,4GAA4G;YAC5G,0CAA0C;YAC1C,8CAA8C;YAC9C,iDAAiD;SAClD;KACF;IACD,MAAM,EAAE;QACN,GAAG,EAAE,8EAA8E;QACnF,QAAQ,EAAE,CAAC,4EAA4E,CAAC;KACzF;IACD,MAAM,EAAE;QACN,GAAG,EAAE,uEAAuE;QAC5E,QAAQ,EAAE,CAAC,6GAA6G,CAAC;KAC1H;IACD,QAAQ,EAAE;QACR,GAAG,EAAE,+DAA+D;QACpE,QAAQ,EAAE;YACR,uDAAuD;YACvD,6DAA6D;YAC7D,4FAA4F;YAC5F,4EAA4E;YAC5E,qGAAqG;YACrG,0FAA0F;YAC1F,gCAAgC;SACjC;QACD,IAAI,EAAE;YACJ,yFAAyF;YACzF,oFAAoF;YACpF,oNAAoN;SACrN;KACF;IACD,gBAAgB,EAAE;QAChB,GAAG,EAAE,wEAAwE;QAC7E,QAAQ,EAAE;YACR,4CAA4C;YAC5C,4CAA4C;YAC5C,0GAA0G;YAC1G,6CAA6C;SAC9C;QACD,IAAI,EAAE;YACJ,kJAAkJ;SACnJ;KACF;IACD,KAAK,EAAE;QACL,GAAG,EAAE,iEAAiE;QACtE,QAAQ,EAAE;YACR,uFAAuF;YACvF,2FAA2F;YAC3F,4EAA4E;YAC5E,6BAA6B;SAC9B;QACD,IAAI,EAAE;YACJ,qHAAqH;YACrH,kKAAkK;SACnK;KACF;IACD,SAAS,EAAE;QACT,GAAG,EAAE,gEAAgE;QACrE,QAAQ,EAAE;YACR,qGAAqG;YACrG,qGAAqG;YACrG,wFAAwF;YACxF,iCAAiC;SAClC;QACD,IAAI,EAAE;YACJ,yHAAyH;YACzH,sLAAsL;SACvL;KACF;IACD,KAAK,EAAE;QACL,GAAG,EAAE,yEAAyE;QAC9E,QAAQ,EAAE;YACR,uEAAuE;YACvE,oEAAoE;YACpE,2BAA2B;YAC3B,sEAAsE;SACvE;KACF;IACD,IAAI,EAAE;QACJ,GAAG,EAAE,6DAA6D;QAClE,QAAQ,EAAE;YACR,0EAA0E;YAC1E,uEAAuE;SACxE;KACF;IACD,IAAI,EAAE;QACJ,GAAG,EAAE,sEAAsE;QAC3E,QAAQ,EAAE;YACR,mHAAmH;YACnH,sIAAsI;YACtI,0FAA0F;YAC1F,4KAA4K;YAC5K,wDAAwD;YACxD,8DAA8D;SAC/D;KACF;IACD,UAAU,EAAE;QACV,GAAG,EAAE,yDAAyD;QAC9D,QAAQ,EAAE;YACR,uEAAuE;YACvE,6GAA6G;YAC7G,8GAA8G;YAC9G,+EAA+E;YAC/E,8DAA8D;SAC/D;KACF;IACD,WAAW,EAAE;QACX,GAAG,EAAE,wFAAwF;QAC7F,QAAQ,EAAE;YACR,+CAA+C;YAC/C,+BAA+B;YAC/B,wDAAwD;YACxD,6BAA6B;YAC7B,+BAA+B;SAChC;KACF;IACD,KAAK,EAAE;QACL,GAAG,EAAE,+DAA+D;QACpE,QAAQ,EAAE,CAAC,UAAU,EAAE,iBAAiB,CAAC;KAC1C;IACD,SAAS,EAAE;QACT,GAAG,EAAE,yFAAyF;QAC9F,QAAQ,EAAE;YACR,qBAAqB;YACrB,+BAA+B;YAC/B,oBAAoB;YACpB,oBAAoB;SACrB;KACF;IACD,MAAM,EAAE;QACN,GAAG,EAAE,oGAAoG;QACzG,QAAQ,EAAE;YACR,WAAW;YACX,yCAAyC;YACzC,0BAA0B;YAC1B,wBAAwB;YACxB,6BAA6B;SAC9B;KACF;IACD,QAAQ,EAAE;QACR,GAAG,EACD,+MAA+M;QACjN,QAAQ,EAAE;YACR,aAAa;YACb,uCAAuC;YACvC,iEAAiE;YACjE,mDAAmD;YACnD,iFAAiF;YACjF,wCAAwC;YACxC,sDAAsD;SACvD;QACD,IAAI,EAAE,CAAC,2GAA2G,CAAC;KACpH;IACD,EAAE,EAAE;QACF,GAAG,EAAE,wIAAwI;QAC7I,QAAQ,EAAE,CAAC,iBAAiB,EAAE,OAAO,CAAC;KACvC;IACD,KAAK,EAAE;QACL,GAAG,EAAE,iEAAiE;QACtE,QAAQ,EAAE;YACR,8EAA8E;YAC9E,qFAAqF;SACtF;QACD,IAAI,EAAE,CAAC,kHAAkH,CAAC;KAC3H;IACD,OAAO,EAAE;QACP,GAAG,EAAE,iEAAiE;QACtE,QAAQ,EAAE;YACR,6EAA6E;YAC7E,gGAAgG;SACjG;QACD,IAAI,EAAE,CAAC,qFAAqF,CAAC;KAC9F;IACD,YAAY,EAAE;QACZ,GAAG,EAAE,qEAAqE;QAC1E,QAAQ,EAAE,CAAC,+EAA+E,CAAC;KAC5F;IACD,YAAY,EAAE;QACZ,GAAG,EAAE,0EAA0E;QAC/E,QAAQ,EAAE,CAAC,uFAAuF,CAAC;KACpG;IACD,YAAY,EAAE;QACZ,GAAG,EAAE,8EAA8E;QACnF,QAAQ,EAAE,CAAC,0GAA0G,CAAC;KACvH;IACD,UAAU,EAAE;QACV,GAAG,EAAE,gFAAgF;QACrF,QAAQ,EAAE,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,iCAAiC,CAAC;QAC9G,IAAI,EAAE,CAAC,qHAAqH,CAAC;KAC9H;IACD,SAAS,EAAE;QACT,GAAG,EAAE,wFAAwF;QAC7F,QAAQ,EAAE;YACR,cAAc;YACd,4CAA4C;YAC5C,4CAA4C;YAC5C,iDAAiD;YACjD,8BAA8B;YAC9B,4BAA4B;SAC7B;QACD,IAAI,EAAE,CAAC,mIAAmI,CAAC;KAC5I;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,GAAG,EAAE,mFAAmF;IACxF,QAAQ,EAAE;QACR,SAAS;QACT,kCAAkC;QAClC,yBAAyB;QACzB,8HAA8H;KAC/H;IACD,IAAI,EAAE;QACJ,kEAAkE;QAClE,8EAA8E;QAC9E,uDAAuD;QACvD,oFAAoF;KACrF;CACF,CAAC;AAEF,SAAS,wBAAwB,CAAC,WAA+B;IAC/D,MAAM,UAAU,GAAG,wBAAwB,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAC/D,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,iBAAiB,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,WAA+B;IACtE,MAAM,aAAa,GAAG,wBAAwB,CAAC,WAAW,CAAC,CAAC;IAC5D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,OAAO,oBAAoB,CAAC,aAAa,CAAC,IAAI,gBAAgB,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,WAA+B,EAAE,UAA0B;IAC9F,MAAM,MAAM,GAAG,wBAAwB,CAAC,WAAW,CAAC,CAAC;IACrD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,GAAG;QAClB,QAAQ,EAAE,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC;QACjG,IAAI,EAAE,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;QAC/D,WAAW,EAAE,UAAU;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,OAAiB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzF,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,gBAAgB,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC,CAAC;IAC7E,KAAK,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC;QACzE,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,uBAAuB;IACvB,wBAAwB;CACzB,CAAC","debugId":"0ae19066-4ac9-55c8-bb28-0204a184caba"}

package/dist/cli/help-json-payload.d.ts CHANGED Viewed

@@ -1,6 +1,6 @@
 import { Command } from "commander";
 import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
-import { type ExtensionCommandHelpDescriptor } from "./extension-command-help.js";
+import { type HelpOptionSummary, type ExtensionCommandHelpDescriptor } from "./extension-command-help.js";
 export interface HelpArgumentSummary {
     name: string;
     required: boolean;
@@ -12,5 +12,23 @@ export interface HelpSubcommandSummary {
     aliases: string[];
     description: string;
 }
+declare function readOptionAttributeName(option: unknown): string | null;
+declare function buildOptionAliasMap(options: unknown[]): Map<string, string[]>;
+declare function buildHelpOptionSummaries(command: Command): HelpOptionSummary[];
+declare function compactHelpOptionAliases(options: HelpOptionSummary[]): HelpOptionSummary[];
+declare function buildHelpArgumentSummaries(command: Command): HelpArgumentSummary[];
+declare function buildHelpSubcommandSummaries(command: Command): HelpSubcommandSummary[];
 export declare function maybeRenderBootstrapJsonHelp(rootProgram: Command, argv: string[], extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>): Promise<boolean>;
+declare function buildCreateUpdatePolicyHelpText(commandName: "create" | "update", typeRegistry: ReturnType<typeof resolveItemTypeRegistry>, argv: string[]): string;
 export declare function attachCreateUpdatePolicyHelpText(rootProgram: Command, typeRegistry: ReturnType<typeof resolveItemTypeRegistry>, argv: string[]): void;
+export declare const _testOnly: {
+    attachCreateUpdatePolicyHelpText: typeof attachCreateUpdatePolicyHelpText;
+    buildCreateUpdatePolicyHelpText: typeof buildCreateUpdatePolicyHelpText;
+    buildHelpArgumentSummaries: typeof buildHelpArgumentSummaries;
+    buildHelpOptionSummaries: typeof buildHelpOptionSummaries;
+    buildHelpSubcommandSummaries: typeof buildHelpSubcommandSummaries;
+    buildOptionAliasMap: typeof buildOptionAliasMap;
+    compactHelpOptionAliases: typeof compactHelpOptionAliases;
+    readOptionAttributeName: typeof readOptionAttributeName;
+};
+export {};

package/dist/cli/help-json-payload.js CHANGED Viewed

@@ -1,5 +1,5 @@
-!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]="878a1569-b6af-5522-8c4a-458db8c0cbf4")}catch(e){}}();
+!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]="9cd6003e-01d2-51de-9fbd-aa1d49d03e68")}catch(e){}}();
 import { commandOptionFlagLabel, resolveCommandOptionPolicyState, resolveTypeDefinition, } from "../core/item/type-registry.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { printError, writeStdout } from "../core/output/output.js";
@@ -105,14 +105,13 @@ function compactHelpOptionAliases(options) {
         }
     }
     for (const aliasOption of aliasOptions) {
-        if (!aliasOption.alias_for || !aliasOption.long) {
-            continue;
-        }
-        const canonical = canonicalByLong.get(aliasOption.alias_for);
+        const aliasFor = aliasOption.alias_for;
+        const canonical = canonicalByLong.get(aliasFor);
         if (!canonical) {
             continue;
         }
-        const aliases = new Set([...(canonical.aliases ?? []), aliasOption.long]);
+        const aliasLong = aliasOption.long;
+        const aliases = new Set([...(canonical.aliases ?? []), aliasLong]);
         canonical.aliases = [...aliases].sort((left, right) => left.localeCompare(right));
     }
     return options.filter((option) => {
@@ -304,5 +303,15 @@ export function attachCreateUpdatePolicyHelpText(rootProgram, typeRegistry, argv
     }
     command.addHelpText("after", buildCreateUpdatePolicyHelpText(bootstrapCommand, typeRegistry, argv));
 }
+export const _testOnly = {
+    attachCreateUpdatePolicyHelpText,
+    buildCreateUpdatePolicyHelpText,
+    buildHelpArgumentSummaries,
+    buildHelpOptionSummaries,
+    buildHelpSubcommandSummaries,
+    buildOptionAliasMap,
+    compactHelpOptionAliases,
+    readOptionAttributeName,
+};
 //# sourceMappingURL=help-json-payload.js.map
-//# debugId=878a1569-b6af-5522-8c4a-458db8c0cbf4
+//# debugId=9cd6003e-01d2-51de-9fbd-aa1d49d03e68