@unbrained/pm-cli 2026.5.1 → 2026.5.2

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 (201) hide show
  1. package/CHANGELOG.md +20 -4
  2. package/CONTRIBUTING.md +11 -5
  3. package/PRD.md +17 -1
  4. package/README.md +49 -1101
  5. package/SECURITY.md +6 -11
  6. package/dist/cli/commands/activity.d.ts +10 -0
  7. package/dist/cli/commands/activity.js +13 -1
  8. package/dist/cli/commands/activity.js.map +1 -1
  9. package/dist/cli/commands/aggregate.js.map +1 -1
  10. package/dist/cli/commands/append.js.map +1 -1
  11. package/dist/cli/commands/calendar.js +16 -5
  12. package/dist/cli/commands/calendar.js.map +1 -1
  13. package/dist/cli/commands/claim.js.map +1 -1
  14. package/dist/cli/commands/close.js.map +1 -1
  15. package/dist/cli/commands/comments-audit.js.map +1 -1
  16. package/dist/cli/commands/comments.js.map +1 -1
  17. package/dist/cli/commands/completion.js.map +1 -1
  18. package/dist/cli/commands/config.js.map +1 -1
  19. package/dist/cli/commands/context.js +22 -0
  20. package/dist/cli/commands/context.js.map +1 -1
  21. package/dist/cli/commands/contracts.js.map +1 -1
  22. package/dist/cli/commands/create.js +2 -2
  23. package/dist/cli/commands/create.js.map +1 -1
  24. package/dist/cli/commands/dedupe-audit.js.map +1 -1
  25. package/dist/cli/commands/delete.js.map +1 -1
  26. package/dist/cli/commands/deps.js.map +1 -1
  27. package/dist/cli/commands/docs.js.map +1 -1
  28. package/dist/cli/commands/extension.js.map +1 -1
  29. package/dist/cli/commands/files.js +14 -2
  30. package/dist/cli/commands/files.js.map +1 -1
  31. package/dist/cli/commands/gc.js.map +1 -1
  32. package/dist/cli/commands/get.js.map +1 -1
  33. package/dist/cli/commands/health.js +16 -12
  34. package/dist/cli/commands/health.js.map +1 -1
  35. package/dist/cli/commands/history.js.map +1 -1
  36. package/dist/cli/commands/index.js.map +1 -1
  37. package/dist/cli/commands/init.js.map +1 -1
  38. package/dist/cli/commands/learnings.js.map +1 -1
  39. package/dist/cli/commands/list.d.ts +1 -0
  40. package/dist/cli/commands/list.js +10 -2
  41. package/dist/cli/commands/list.js.map +1 -1
  42. package/dist/cli/commands/normalize.js +5 -17
  43. package/dist/cli/commands/normalize.js.map +1 -1
  44. package/dist/cli/commands/notes.js.map +1 -1
  45. package/dist/cli/commands/reindex.js.map +1 -1
  46. package/dist/cli/commands/restore.js.map +1 -1
  47. package/dist/cli/commands/search.js.map +1 -1
  48. package/dist/cli/commands/stats.js.map +1 -1
  49. package/dist/cli/commands/templates.js.map +1 -1
  50. package/dist/cli/commands/test-all.js.map +1 -1
  51. package/dist/cli/commands/test-runs.js.map +1 -1
  52. package/dist/cli/commands/test.js.map +1 -1
  53. package/dist/cli/commands/update-many.js +1 -6
  54. package/dist/cli/commands/update-many.js.map +1 -1
  55. package/dist/cli/commands/update.js +2 -2
  56. package/dist/cli/commands/update.js.map +1 -1
  57. package/dist/cli/commands/validate.js +23 -18
  58. package/dist/cli/commands/validate.js.map +1 -1
  59. package/dist/cli/error-guidance.js +13 -2
  60. package/dist/cli/error-guidance.js.map +1 -1
  61. package/dist/cli/extension-command-options.js.map +1 -1
  62. package/dist/cli/help-content.js.map +1 -1
  63. package/dist/cli/main.js +29 -13
  64. package/dist/cli/main.js.map +1 -1
  65. package/dist/cli.d.ts +1 -1
  66. package/dist/cli.js +3 -1
  67. package/dist/cli.js.map +1 -1
  68. package/dist/core/extensions/extension-types.d.ts +605 -0
  69. package/dist/core/extensions/extension-types.js +22 -0
  70. package/dist/core/extensions/extension-types.js.map +1 -0
  71. package/dist/core/extensions/index.js.map +1 -1
  72. package/dist/core/extensions/item-fields.js.map +1 -1
  73. package/dist/core/extensions/loader.d.ts +2 -586
  74. package/dist/core/extensions/loader.js +3 -21
  75. package/dist/core/extensions/loader.js.map +1 -1
  76. package/dist/core/extensions/runtime-registrations.js.map +1 -1
  77. package/dist/core/fs/fs-utils.js.map +1 -1
  78. package/dist/core/fs/index.js.map +1 -1
  79. package/dist/core/history/history-stream-policy.js.map +1 -1
  80. package/dist/core/history/history.js.map +1 -1
  81. package/dist/core/history/index.js.map +1 -1
  82. package/dist/core/item/id.js.map +1 -1
  83. package/dist/core/item/index.js.map +1 -1
  84. package/dist/core/item/item-format.js.map +1 -1
  85. package/dist/core/item/parent-reference-policy.js.map +1 -1
  86. package/dist/core/item/parse.js +6 -0
  87. package/dist/core/item/parse.js.map +1 -1
  88. package/dist/core/item/sprint-release-format.js.map +1 -1
  89. package/dist/core/item/status.js.map +1 -1
  90. package/dist/core/item/type-registry.js.map +1 -1
  91. package/dist/core/lock/index.js.map +1 -1
  92. package/dist/core/lock/lock.js +1 -6
  93. package/dist/core/lock/lock.js.map +1 -1
  94. package/dist/core/output/command-aware.js.map +1 -1
  95. package/dist/core/output/output.js.map +1 -1
  96. package/dist/core/schema/runtime-field-filters.js.map +1 -1
  97. package/dist/core/schema/runtime-field-values.js.map +1 -1
  98. package/dist/core/schema/runtime-schema.js.map +1 -1
  99. package/dist/core/search/cache.js +1 -7
  100. package/dist/core/search/cache.js.map +1 -1
  101. package/dist/core/search/embedding-batches.js +4 -0
  102. package/dist/core/search/embedding-batches.js.map +1 -1
  103. package/dist/core/search/providers.js +1 -20
  104. package/dist/core/search/providers.js.map +1 -1
  105. package/dist/core/search/semantic-defaults.js.map +1 -1
  106. package/dist/core/search/vector-stores.d.ts +1 -0
  107. package/dist/core/search/vector-stores.js +23 -27
  108. package/dist/core/search/vector-stores.js.map +1 -1
  109. package/dist/core/sentry/helpers.d.ts +6 -0
  110. package/dist/core/sentry/helpers.js +73 -0
  111. package/dist/core/sentry/helpers.js.map +1 -0
  112. package/dist/core/sentry/instrument.d.ts +4 -0
  113. package/dist/core/sentry/instrument.js +173 -0
  114. package/dist/core/sentry/instrument.js.map +1 -0
  115. package/dist/core/shared/command-types.js.map +1 -1
  116. package/dist/core/shared/conflict-markers.js.map +1 -1
  117. package/dist/core/shared/constants.js.map +1 -1
  118. package/dist/core/shared/errors.js.map +1 -1
  119. package/dist/core/shared/index.d.ts +1 -0
  120. package/dist/core/shared/index.js +1 -0
  121. package/dist/core/shared/index.js.map +1 -1
  122. package/dist/core/shared/primitives.d.ts +13 -0
  123. package/dist/core/shared/primitives.js +33 -0
  124. package/dist/core/shared/primitives.js.map +1 -0
  125. package/dist/core/shared/serialization.js.map +1 -1
  126. package/dist/core/shared/text-normalization.js.map +1 -1
  127. package/dist/core/shared/time.js.map +1 -1
  128. package/dist/core/store/index.js.map +1 -1
  129. package/dist/core/store/item-format-migration.js.map +1 -1
  130. package/dist/core/store/item-store.js +44 -35
  131. package/dist/core/store/item-store.js.map +1 -1
  132. package/dist/core/store/paths.js.map +1 -1
  133. package/dist/core/store/settings.js.map +1 -1
  134. package/dist/core/telemetry/consent.js.map +1 -1
  135. package/dist/core/telemetry/runtime.d.ts +2 -0
  136. package/dist/core/telemetry/runtime.js +40 -13
  137. package/dist/core/telemetry/runtime.js.map +1 -1
  138. package/dist/core/test/background-runs.js.map +1 -1
  139. package/dist/core/test/item-test-run-tracking.js.map +1 -1
  140. package/dist/sdk/cli-contracts.js.map +1 -1
  141. package/dist/sdk/index.d.ts +1 -1
  142. package/dist/sdk/index.js.map +1 -1
  143. package/dist/types/index.js.map +1 -1
  144. package/dist/types.js.map +1 -1
  145. package/docs/AGENT_GUIDE.md +125 -0
  146. package/docs/ARCHITECTURE.md +195 -478
  147. package/docs/COMMANDS.md +199 -0
  148. package/docs/CONFIGURATION.md +146 -0
  149. package/docs/EXTENSIONS.md +146 -645
  150. package/docs/QUICKSTART.md +108 -0
  151. package/docs/README.md +70 -0
  152. package/docs/RELEASING.md +51 -36
  153. package/docs/SDK.md +127 -68
  154. package/docs/TESTING.md +125 -0
  155. package/docs/examples/starter-extension/README.md +39 -25
  156. package/package.json +17 -9
  157. package/dist/command-types.d.ts +0 -1
  158. package/dist/command-types.js +0 -2
  159. package/dist/command-types.js.map +0 -1
  160. package/dist/constants.d.ts +0 -1
  161. package/dist/constants.js +0 -2
  162. package/dist/constants.js.map +0 -1
  163. package/dist/errors.d.ts +0 -1
  164. package/dist/errors.js +0 -2
  165. package/dist/errors.js.map +0 -1
  166. package/dist/fs-utils.d.ts +0 -1
  167. package/dist/fs-utils.js +0 -2
  168. package/dist/fs-utils.js.map +0 -1
  169. package/dist/history.d.ts +0 -1
  170. package/dist/history.js +0 -2
  171. package/dist/history.js.map +0 -1
  172. package/dist/id.d.ts +0 -1
  173. package/dist/id.js +0 -2
  174. package/dist/id.js.map +0 -1
  175. package/dist/item-format.d.ts +0 -1
  176. package/dist/item-format.js +0 -2
  177. package/dist/item-format.js.map +0 -1
  178. package/dist/item-store.d.ts +0 -1
  179. package/dist/item-store.js +0 -2
  180. package/dist/item-store.js.map +0 -1
  181. package/dist/lock.d.ts +0 -1
  182. package/dist/lock.js +0 -2
  183. package/dist/lock.js.map +0 -1
  184. package/dist/output.d.ts +0 -1
  185. package/dist/output.js +0 -2
  186. package/dist/output.js.map +0 -1
  187. package/dist/parse.d.ts +0 -1
  188. package/dist/parse.js +0 -2
  189. package/dist/parse.js.map +0 -1
  190. package/dist/paths.d.ts +0 -1
  191. package/dist/paths.js +0 -2
  192. package/dist/paths.js.map +0 -1
  193. package/dist/serialization.d.ts +0 -1
  194. package/dist/serialization.js +0 -2
  195. package/dist/serialization.js.map +0 -1
  196. package/dist/settings.d.ts +0 -1
  197. package/dist/settings.js +0 -2
  198. package/dist/settings.js.map +0 -1
  199. package/dist/time.d.ts +0 -1
  200. package/dist/time.js +0 -2
  201. package/dist/time.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"extension-command-options.js","sourceRoot":"","sources":["../../src/cli/extension-command-options.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"extension-command-options.js","sourceRoot":"/","sources":["cli/extension-command-options.ts"],"names":[],"mappings":"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","sourcesContent":["const 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 === \"--\") {\n return null;\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 const explicitType = typeof definition.type === \"string\" ? definition.type.trim().toLowerCase() : undefined;\n const valueType = typeof definition.value_type === \"string\" ? definition.value_type.trim().toLowerCase() : undefined;\n const kind = explicitType ?? valueType;\n if (kind === \"string\") {\n return \"string\";\n }\n if (kind === \"number\" || kind === \"int\" || kind === \"integer\" || kind === \"float\") {\n return \"number\";\n }\n if (kind === \"boolean\" || kind === \"bool\") {\n return \"boolean\";\n }\n return null;\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\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\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 kind = resolveLooseOptionCoercionKind(definition);\n if (!kind) {\n continue;\n }\n for (const key of collectLooseOptionKeys(definition)) {\n if (!Object.hasOwn(coerced, key)) {\n continue;\n }\n coerced[key] = coerceLooseOptionValue(coerced[key], kind);\n }\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"]}
@@ -1 +1 @@
1
- {"version":3,"file":"help-content.js","sourceRoot":"","sources":["../../src/cli/help-content.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"help-content.js","sourceRoot":"/","sources":["cli/help-content.ts"],"names":[],"mappings":"AAiBA,SAAS,uBAAuB,CAAC,MAAkB;IACjD,MAAM,KAAK,GAAa;QACtB,EAAE;QACF,SAAS;QACT,KAAK,MAAM,CAAC,GAAG,EAAE;KAClB,CAAC;IACF,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,QAAQ,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,CAAC,SAAS,EAAE,cAAc,EAAE,0BAA0B,EAAE,yBAAyB,CAAC;QAC5F,IAAI,EAAE;YACJ,kEAAkE;YAClE,wFAAwF;SACzF;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,8IAA8I;QAChJ,QAAQ,EAAE;YACR,kCAAkC;YAClC,sCAAsC;YACtC,qCAAqC;YACrC,6DAA6D;YAC7D,qGAAqG;YACrG,wDAAwD;YACxD,gCAAgC;YAChC,8BAA8B;YAC9B,mCAAmC;YACnC,yCAAyC;YACzC,kCAAkC;YAClC,yEAAyE;YACzE,4CAA4C;YAC5C,8CAA8C;YAC9C,4CAA4C;YAC5C,wCAAwC;SACzC;QACD,IAAI,EAAE;YACJ,8IAA8I;YAC9I,yEAAyE;YACzE,+EAA+E;YAC/E,wFAAwF;YACxF,uGAAuG;YACvG,gIAAgI;YAChI,kHAAkH;YAClH,qHAAqH;SACtH;KACF;IACD,MAAM,EAAE;QACN,GAAG,EAAE,sEAAsE;QAC3E,QAAQ,EAAE;YACR,0LAA0L;YAC1L,sIAAsI;YACtI,mrBAAmrB;SACprB;QACD,IAAI,EAAE;YACJ,4GAA4G;YAC5G,yEAAyE;SAC1E;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,qKAAqK;YACrK,6GAA6G;YAC7G,uCAAuC;SACxC;QACD,IAAI,EAAE;YACJ,oEAAoE;YACpE,yIAAyI;YACzI,wFAAwF;SACzF;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,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,2FAA2F;QAChG,QAAQ,EAAE;YACR,YAAY;YACZ,yCAAyC;YACzC,kDAAkD;SACnD;QACD,IAAI,EAAE;YACJ,6HAA6H;YAC7H,uFAAuF;SACxF;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,0BAA0B,CAAC;KACpE;IACD,GAAG,EAAE;QACH,GAAG,EAAE,4CAA4C;QACjD,QAAQ,EAAE,CAAC,gBAAgB,EAAE,uBAAuB,CAAC;QACrD,IAAI,EAAE,CAAC,8FAA8F,CAAC;KACvG;IACD,OAAO,EAAE;QACP,GAAG,EAAE,kDAAkD;QACvD,QAAQ,EAAE,CAAC,+BAA+B,CAAC;KAC5C;IACD,QAAQ,EAAE;QACR,GAAG,EAAE,oDAAoD;QACzD,QAAQ,EAAE;YACR,wBAAwB;YACxB,+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,6DAA6D;YAC7D,qGAAqG;YACrG,0FAA0F;YAC1F,gCAAgC;SACjC;QACD,IAAI,EAAE;YACJ,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,qFAAqF;YACrF,2BAA2B;YAC3B,sEAAsE;SACvE;KACF;IACD,IAAI,EAAE;QACJ,GAAG,EAAE,6DAA6D;QAClE,QAAQ,EAAE,CAAC,wFAAwF,CAAC;KACrG;IACD,IAAI,EAAE;QACJ,GAAG,EAAE,sEAAsE;QAC3E,QAAQ,EAAE;YACR,iIAAiI;YACjI,oJAAoJ;YACpJ,wGAAwG;YACxG,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,MAAM,EAAE;QACN,GAAG,EAAE,oGAAoG;QACzG,QAAQ,EAAE,CAAC,WAAW,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,6BAA6B,CAAC;KAC/H;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,mEAAmE;QACxE,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;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,CAAC,SAAS,EAAE,yBAAyB,EAAE,8HAA8H,CAAC;IAChL,IAAI,EAAE;QACJ,kEAAkE;QAClE,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,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;QACnH,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,uBAAuB;IACrC,OAAO,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5F,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","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: ['pm init', 'pm init acme', \"pm init --preset minimal\", \"pm init --preset strict\"],\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 ],\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 \"Installs, explores, manages, diagnoses, adopts (single or bulk), and activates/deactivates custom extensions across project or global scope.\",\n examples: [\n \"pm extension init ./my-extension\",\n \"pm extension install beads --project\",\n \"pm extension install todos --global\",\n \"pm extension install .agents/pm/extensions/sample --project\",\n \"pm extension install https://github.com/unbraind/pm-cli/tree/main/.agents/pm/extensions/pi --global\",\n \"pm extension install --gh unbraind/pm-cli/pi --project\",\n \"pm extension explore --project\",\n \"pm extension manage --global\",\n \"pm extension doctor --detail deep\",\n \"pm extension adopt sample-ext --project\",\n \"pm extension adopt-all --project\",\n \"pm extension adopt sample-ext --project --gh owner/repo/path --ref main\",\n \"pm extension activate sample-ext --project\",\n \"pm extension deactivate sample-ext --project\",\n \"pm extension uninstall sample-ext --global\",\n \"pm extension --install beads --project\",\n ],\n tips: [\n \"Prefer explicit subcommands (init/scaffold/install/uninstall/explore/manage/doctor/adopt/adopt-all/activate/deactivate) for discoverability.\",\n \"Legacy lifecycle flags remain supported as backward-compatible aliases.\",\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 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,scope=project,note=tracked asset\" --test \"command=node scripts/run-tests.mjs test,scope=project,timeout_seconds=240\" --doc \"path=README.md,scope=project,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,scope=project,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 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 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.\",\n examples: [\n \"pm context\",\n \"pm ctx --limit 5 --assignee codex-agent\",\n \"pm context --from +0d --to +7d --format markdown\",\n ],\n tips: [\n \"High-level focus contains Epics/Features and low-level focus contains Tasks/Issues/Chores/Event/Reminder/Milestone/Meeting.\",\n \"When no open or in-progress work exists, blocked items are shown as fallback context.\",\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\"],\n },\n get: {\n why: \"Shows complete details for one item by ID.\",\n examples: [\"pm get pm-a1b2\", \"pm get pm-a1b2 --json\"],\n tips: [\"JSON output shape is { item, body, linked, claim_state }; body is top-level (not item.body).\"],\n },\n history: {\n why: \"Inspects item mutation timeline and audit trail.\",\n examples: [\"pm history pm-a1b2 --limit 20\"],\n },\n activity: {\n why: \"Reviews recent tracker-wide activity across items.\",\n examples: [\n \"pm activity --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 --add \"Verified fix on Linux and macOS\"',\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 --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,scope=project,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: ['pm docs pm-a1b2 --add \"path=README.md,scope=project,note=user-facing command guidance\"'],\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,scope=project,timeout_seconds=2400\"',\n 'pm test pm-a1b2 --add \"command=pm list-all --type Task --limit 200,scope=project,assert_stdout_contains=count:,assert_stdout_regex=count:\\\\s+\\\\d+\"',\n 'pm test pm-a1b2 --add \"command=pm list-all --type Task --limit 200,scope=project,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 health: {\n why: \"Validates tracker/runtime health including extension triage, migration, and integrity diagnostics.\",\n examples: [\"pm health\", \"pm health --json\", \"pm health --check-only\", \"pm health --no-refresh\", \"pm health --refresh-vectors\"],\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: \"Cleans optional cache artifacts to keep local tracker state tidy.\",\n examples: [\"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: [\"pm init\", \"pm list-open --limit 10\", 'pm create --title \"...\" --description \"...\" --type Task --status open --priority 1 --message \"...\" --create-mode progressive'],\n tips: [\n \"Use <command> --help for command-specific guidance and examples.\",\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 listDocumentedHelpPaths(): string[] {\n return Object.keys(HELP_BY_COMMAND_PATH).sort((left, right) => left.localeCompare(right));\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"]}
package/dist/cli/main.js CHANGED
@@ -12,9 +12,11 @@ import { resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, } from "../c
12
12
  import { refreshSearchArtifactsForMutation } from "../core/search/cache.js";
13
13
  import { EXIT_CODE } from "../core/shared/constants.js";
14
14
  import { PmCliError } from "../core/shared/errors.js";
15
+ import { toNonEmptyStringOrUndefined } from "../core/shared/primitives.js";
15
16
  import { printError, printResult, writeStdout } from "../core/output/output.js";
16
17
  import { maybeRunFirstUseTelemetryPrompt } from "../core/telemetry/consent.js";
17
18
  import { finishTelemetryCommand, startTelemetryCommand, } from "../core/telemetry/runtime.js";
19
+ import { sentryCaptureCliError, sentryFinishCommandSpan, sentryFlush, sentrySetCommandContext, sentryStartCommandSpan, } from "../core/sentry/helpers.js";
18
20
  import { migrateItemFilesToFormat } from "../core/store/item-format-migration.js";
19
21
  import { listAllFrontMatter } from "../core/store/item-store.js";
20
22
  import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
@@ -1044,22 +1046,15 @@ let activeRuntimeExtensionCommandDescriptors = new Map();
1044
1046
  function formatHookWarnings(warnings) {
1045
1047
  return warnings.join(",");
1046
1048
  }
1047
- function toNonEmptyString(value) {
1048
- if (typeof value !== "string") {
1049
- return undefined;
1050
- }
1051
- const trimmed = value.trim();
1052
- return trimmed.length > 0 ? trimmed : undefined;
1053
- }
1054
1049
  function resolveMigrationId(definition, fallbackIndex) {
1055
- const explicit = toNonEmptyString(definition.id);
1050
+ const explicit = toNonEmptyStringOrUndefined(definition.id);
1056
1051
  if (explicit) {
1057
1052
  return explicit;
1058
1053
  }
1059
1054
  return `migration-${String(fallbackIndex + 1).padStart(3, "0")}`;
1060
1055
  }
1061
1056
  function resolveNormalizedMigrationStatus(definition) {
1062
- const normalized = toNonEmptyString(definition.status)?.toLowerCase();
1057
+ const normalized = toNonEmptyStringOrUndefined(definition.status)?.toLowerCase();
1063
1058
  return normalized ?? "pending";
1064
1059
  }
1065
1060
  function isMandatoryMigrationDefinition(definition) {
@@ -2097,7 +2092,8 @@ function printActivityJsonStream(result, options, globalOptions) {
2097
2092
  if (!writeStdout(`${JSON.stringify(metaPayload)}\n`)) {
2098
2093
  return;
2099
2094
  }
2100
- for (const entry of result.activity) {
2095
+ const entries = result.compact && result.compact_activity ? result.compact_activity : result.activity;
2096
+ for (const entry of entries) {
2101
2097
  if (!writeStdout(`${JSON.stringify({ type: "entry", command: "activity", entry })}\n`)) {
2102
2098
  return;
2103
2099
  }
@@ -2193,6 +2189,7 @@ function normalizeActivityOptions(options) {
2193
2189
  from: readActivityString("from"),
2194
2190
  to: readActivityString("to"),
2195
2191
  limit: readActivityString("limit"),
2192
+ compact: options.compact === true ? true : undefined,
2196
2193
  };
2197
2194
  }
2198
2195
  function resolveActivityStreamMode(raw) {
@@ -2306,6 +2303,8 @@ program.hook("preAction", async (_thisCommand, actionCommand) => {
2306
2303
  global: globalOptions,
2307
2304
  pm_root: fallbackPmRoot,
2308
2305
  });
2306
+ sentrySetCommandContext(commandPath, commandArgs, commandOptions);
2307
+ sentryStartCommandSpan(commandPath);
2309
2308
  await enforceItemFormatWriteGateAndPreflightMigration(commandPath, commandOptions, fallbackPmRoot, defaultPreflightDecision());
2310
2309
  return;
2311
2310
  }
@@ -2380,6 +2379,8 @@ program.hook("preAction", async (_thisCommand, actionCommand) => {
2380
2379
  global: globalOptions,
2381
2380
  pm_root: runtimeExtensions.pmRoot,
2382
2381
  });
2382
+ sentrySetCommandContext(commandPath, commandArgs, commandOptions);
2383
+ sentryStartCommandSpan(commandPath);
2383
2384
  const hookWarnings = await runBeforeCommandHooks(runtimeExtensions.hooks, {
2384
2385
  command: commandPath,
2385
2386
  args: commandArgs,
@@ -2395,6 +2396,7 @@ program.hook("preAction", async (_thisCommand, actionCommand) => {
2395
2396
  }
2396
2397
  });
2397
2398
  program.hook("postAction", async () => {
2399
+ sentryFinishCommandSpan(true);
2398
2400
  await runAndClearAfterCommandHooks({ ok: true });
2399
2401
  });
2400
2402
  program
@@ -2588,7 +2590,14 @@ addExtensionScopeOptions(extensionCommand.command("activate").argument("<target>
2588
2590
  addExtensionScopeOptions(extensionCommand.command("deactivate").argument("<target>", "Extension name").description("Deactivate an extension in selected scope settings.")).action(async (target, _options, command) => {
2589
2591
  await executeExtensionCommand(target, command.opts(), command, "deactivate");
2590
2592
  });
2591
- const templatesCommand = program.command("templates").description("Manage reusable create templates.");
2593
+ const templatesCommand = program
2594
+ .command("templates")
2595
+ .description("Manage reusable create templates.")
2596
+ .action(async () => {
2597
+ const globalOptions = program.opts();
2598
+ const result = await runTemplatesList(globalOptions);
2599
+ printResult(result, globalOptions);
2600
+ });
2592
2601
  templatesCommand
2593
2602
  .command("save")
2594
2603
  .argument("<name>", "Template name")
@@ -2814,8 +2823,9 @@ function registerListCommand(name, description, status, excludeTerminal, allowSt
2814
2823
  .option("--limit <n>", "Limit returned item count")
2815
2824
  .option("--offset <n>", "Skip the first n matching rows before limit is applied")
2816
2825
  .option("--include-body", "Include item body in each returned list row")
2817
- .option("--compact", "Render compact list projection fields (mutually exclusive with --fields)")
2818
- .option("--fields <value>", "Render custom comma-separated list fields (mutually exclusive with --compact; valid: --fields id,title; invalid: --compact --fields id,title)")
2826
+ .option("--compact", "Render compact list projection fields (mutually exclusive with --brief/--fields)")
2827
+ .option("--brief", "Ultra-compact output: id, status, type, title only (agent-optimized, mutually exclusive with --compact/--fields)")
2828
+ .option("--fields <value>", "Render custom comma-separated list fields (mutually exclusive with --compact/--brief; valid: --fields id,title)")
2819
2829
  .option("--sort <value>", "Sort field: priority|deadline|updated_at|created_at|title|parent")
2820
2830
  .option("--order <value>", "Sort order: asc|desc (requires --sort)")
2821
2831
  .option("--stream", "Emit line-delimited JSON rows (requires --json)")
@@ -3083,6 +3093,7 @@ program
3083
3093
  .option("--from <value>", "Lower timestamp bound (ISO/date string or relative)")
3084
3094
  .option("--to <value>", "Upper timestamp bound (ISO/date string or relative)")
3085
3095
  .option("--limit <n>", "Return only the latest n activity entries")
3096
+ .option("--compact", "Condensed output: show only id, op, ts, author, msg per entry")
3086
3097
  .option("--stream [mode]", "Emit line-delimited JSON rows (requires --json). Optional mode: rows|ndjson|jsonl")
3087
3098
  .description("Show recent activity across items.")
3088
3099
  .action(async (options, command) => {
@@ -4604,6 +4615,7 @@ async function main() {
4604
4615
  await program.parseAsync(invocationProcessArgv);
4605
4616
  }
4606
4617
  catch (error) {
4618
+ sentryFinishCommandSpan(false, describeUnknownError(error));
4607
4619
  await runAndClearAfterCommandHooks({
4608
4620
  ok: false,
4609
4621
  error: describeUnknownError(error),
@@ -4616,12 +4628,14 @@ async function main() {
4616
4628
  setActiveExtensionServices(bootstrapSnapshot?.services ?? { overrides: [] });
4617
4629
  }
4618
4630
  if (error instanceof PmCliError) {
4631
+ sentryCaptureCliError(error);
4619
4632
  if (jsonErrors) {
4620
4633
  printError(JSON.stringify(formatPmCliErrorForJson(error.message, error.exitCode, error.context), null, 2));
4621
4634
  }
4622
4635
  else {
4623
4636
  printError(formatPmCliErrorForDisplay(error.message, error.context));
4624
4637
  }
4638
+ await sentryFlush();
4625
4639
  process.exitCode = error.exitCode;
4626
4640
  return;
4627
4641
  }
@@ -4661,6 +4675,7 @@ async function main() {
4661
4675
  return;
4662
4676
  }
4663
4677
  }
4678
+ sentryCaptureCliError(error);
4664
4679
  const message = describeUnknownError(error);
4665
4680
  if (jsonErrors) {
4666
4681
  printError(JSON.stringify(formatUnknownErrorForJson(message, EXIT_CODE.GENERIC_FAILURE), null, 2));
@@ -4668,6 +4683,7 @@ async function main() {
4668
4683
  else {
4669
4684
  printError(message);
4670
4685
  }
4686
+ await sentryFlush();
4671
4687
  process.exitCode = EXIT_CODE.GENERIC_FAILURE;
4672
4688
  }
4673
4689
  }