@unbrained/pm-cli 2026.5.1 → 2026.5.3-5

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 (265) hide show
  1. package/AGENTS.md +8 -1
  2. package/CHANGELOG.md +73 -4
  3. package/CONTRIBUTING.md +11 -5
  4. package/PRD.md +17 -1
  5. package/README.md +55 -1099
  6. package/SECURITY.md +6 -11
  7. package/dist/cli/bootstrap-args.d.ts +18 -0
  8. package/dist/cli/bootstrap-args.js +242 -0
  9. package/dist/cli/bootstrap-args.js.map +1 -0
  10. package/dist/cli/commander-usage.d.ts +17 -0
  11. package/dist/cli/commander-usage.js +178 -0
  12. package/dist/cli/commander-usage.js.map +1 -0
  13. package/dist/cli/commands/activity.d.ts +10 -0
  14. package/dist/cli/commands/activity.js +14 -10
  15. package/dist/cli/commands/activity.js.map +1 -1
  16. package/dist/cli/commands/aggregate.js.map +1 -1
  17. package/dist/cli/commands/append.js.map +1 -1
  18. package/dist/cli/commands/calendar.js +19 -34
  19. package/dist/cli/commands/calendar.js.map +1 -1
  20. package/dist/cli/commands/claim.js.map +1 -1
  21. package/dist/cli/commands/close.js.map +1 -1
  22. package/dist/cli/commands/comments-audit.js.map +1 -1
  23. package/dist/cli/commands/comments.js +1 -9
  24. package/dist/cli/commands/comments.js.map +1 -1
  25. package/dist/cli/commands/completion.js.map +1 -1
  26. package/dist/cli/commands/config.d.ts +21 -3
  27. package/dist/cli/commands/config.js +118 -2
  28. package/dist/cli/commands/config.js.map +1 -1
  29. package/dist/cli/commands/context.d.ts +90 -1
  30. package/dist/cli/commands/context.js +496 -12
  31. package/dist/cli/commands/context.js.map +1 -1
  32. package/dist/cli/commands/contracts.js.map +1 -1
  33. package/dist/cli/commands/create.js +2 -2
  34. package/dist/cli/commands/create.js.map +1 -1
  35. package/dist/cli/commands/dedupe-audit.js +2 -11
  36. package/dist/cli/commands/dedupe-audit.js.map +1 -1
  37. package/dist/cli/commands/delete.js.map +1 -1
  38. package/dist/cli/commands/deps.js.map +1 -1
  39. package/dist/cli/commands/docs.js.map +1 -1
  40. package/dist/cli/commands/extension.js.map +1 -1
  41. package/dist/cli/commands/files.js +14 -2
  42. package/dist/cli/commands/files.js.map +1 -1
  43. package/dist/cli/commands/gc.js.map +1 -1
  44. package/dist/cli/commands/get.js.map +1 -1
  45. package/dist/cli/commands/health.js +16 -12
  46. package/dist/cli/commands/health.js.map +1 -1
  47. package/dist/cli/commands/history.js +1 -9
  48. package/dist/cli/commands/history.js.map +1 -1
  49. package/dist/cli/commands/index.js.map +1 -1
  50. package/dist/cli/commands/init.js.map +1 -1
  51. package/dist/cli/commands/learnings.js +1 -9
  52. package/dist/cli/commands/learnings.js.map +1 -1
  53. package/dist/cli/commands/list.d.ts +1 -0
  54. package/dist/cli/commands/list.js +13 -31
  55. package/dist/cli/commands/list.js.map +1 -1
  56. package/dist/cli/commands/normalize.js +14 -23
  57. package/dist/cli/commands/normalize.js.map +1 -1
  58. package/dist/cli/commands/notes.js +1 -9
  59. package/dist/cli/commands/notes.js.map +1 -1
  60. package/dist/cli/commands/reindex.js +2 -7
  61. package/dist/cli/commands/reindex.js.map +1 -1
  62. package/dist/cli/commands/restore.js.map +1 -1
  63. package/dist/cli/commands/search.js +4 -35
  64. package/dist/cli/commands/search.js.map +1 -1
  65. package/dist/cli/commands/stats.js.map +1 -1
  66. package/dist/cli/commands/templates.js.map +1 -1
  67. package/dist/cli/commands/test-all.js.map +1 -1
  68. package/dist/cli/commands/test-runs.js +1 -11
  69. package/dist/cli/commands/test-runs.js.map +1 -1
  70. package/dist/cli/commands/test.js.map +1 -1
  71. package/dist/cli/commands/update-many.js +1 -6
  72. package/dist/cli/commands/update-many.js.map +1 -1
  73. package/dist/cli/commands/update.js +2 -2
  74. package/dist/cli/commands/update.js.map +1 -1
  75. package/dist/cli/commands/validate.js +23 -18
  76. package/dist/cli/commands/validate.js.map +1 -1
  77. package/dist/cli/error-guidance.d.ts +13 -0
  78. package/dist/cli/error-guidance.js +56 -6
  79. package/dist/cli/error-guidance.js.map +1 -1
  80. package/dist/cli/extension-command-help.d.ts +48 -0
  81. package/dist/cli/extension-command-help.js +389 -0
  82. package/dist/cli/extension-command-help.js.map +1 -0
  83. package/dist/cli/extension-command-options.js.map +1 -1
  84. package/dist/cli/help-content.js +9 -3
  85. package/dist/cli/help-content.js.map +1 -1
  86. package/dist/cli/help-json-payload.d.ts +25 -0
  87. package/dist/cli/help-json-payload.js +265 -0
  88. package/dist/cli/help-json-payload.js.map +1 -0
  89. package/dist/cli/main.js +1000 -4456
  90. package/dist/cli/main.js.map +1 -1
  91. package/dist/cli/migration-gates.d.ts +22 -0
  92. package/dist/cli/migration-gates.js +146 -0
  93. package/dist/cli/migration-gates.js.map +1 -0
  94. package/dist/cli/register-list-query.d.ts +2 -0
  95. package/dist/cli/register-list-query.js +317 -0
  96. package/dist/cli/register-list-query.js.map +1 -0
  97. package/dist/cli/register-mutation.d.ts +2 -0
  98. package/dist/cli/register-mutation.js +795 -0
  99. package/dist/cli/register-mutation.js.map +1 -0
  100. package/dist/cli/register-operations.d.ts +2 -0
  101. package/dist/cli/register-operations.js +610 -0
  102. package/dist/cli/register-operations.js.map +1 -0
  103. package/dist/cli/register-setup.d.ts +2 -0
  104. package/dist/cli/register-setup.js +334 -0
  105. package/dist/cli/register-setup.js.map +1 -0
  106. package/dist/cli/registration-helpers.d.ts +53 -0
  107. package/dist/cli/registration-helpers.js +669 -0
  108. package/dist/cli/registration-helpers.js.map +1 -0
  109. package/dist/cli/shared-parsers.d.ts +6 -0
  110. package/dist/cli/shared-parsers.js +40 -0
  111. package/dist/cli/shared-parsers.js.map +1 -0
  112. package/dist/cli.d.ts +1 -1
  113. package/dist/cli.js +3 -1
  114. package/dist/cli.js.map +1 -1
  115. package/dist/core/extensions/extension-types.d.ts +605 -0
  116. package/dist/core/extensions/extension-types.js +22 -0
  117. package/dist/core/extensions/extension-types.js.map +1 -0
  118. package/dist/core/extensions/index.js.map +1 -1
  119. package/dist/core/extensions/item-fields.js.map +1 -1
  120. package/dist/core/extensions/loader.d.ts +2 -586
  121. package/dist/core/extensions/loader.js +3 -21
  122. package/dist/core/extensions/loader.js.map +1 -1
  123. package/dist/core/extensions/runtime-registrations.js.map +1 -1
  124. package/dist/core/fs/fs-utils.js.map +1 -1
  125. package/dist/core/fs/index.js.map +1 -1
  126. package/dist/core/history/history-stream-policy.js.map +1 -1
  127. package/dist/core/history/history.js.map +1 -1
  128. package/dist/core/history/index.js.map +1 -1
  129. package/dist/core/item/id.js.map +1 -1
  130. package/dist/core/item/index.js.map +1 -1
  131. package/dist/core/item/item-format.js.map +1 -1
  132. package/dist/core/item/parent-reference-policy.js.map +1 -1
  133. package/dist/core/item/parse.js +6 -0
  134. package/dist/core/item/parse.js.map +1 -1
  135. package/dist/core/item/sprint-release-format.js.map +1 -1
  136. package/dist/core/item/status.js.map +1 -1
  137. package/dist/core/item/type-registry.js.map +1 -1
  138. package/dist/core/lock/index.js.map +1 -1
  139. package/dist/core/lock/lock.js +1 -6
  140. package/dist/core/lock/lock.js.map +1 -1
  141. package/dist/core/output/command-aware.js.map +1 -1
  142. package/dist/core/output/output.js.map +1 -1
  143. package/dist/core/schema/runtime-field-filters.js.map +1 -1
  144. package/dist/core/schema/runtime-field-values.js.map +1 -1
  145. package/dist/core/schema/runtime-schema.js.map +1 -1
  146. package/dist/core/search/cache.js +1 -7
  147. package/dist/core/search/cache.js.map +1 -1
  148. package/dist/core/search/embedding-batches.js +4 -0
  149. package/dist/core/search/embedding-batches.js.map +1 -1
  150. package/dist/core/search/http-client.d.ts +29 -0
  151. package/dist/core/search/http-client.js +64 -0
  152. package/dist/core/search/http-client.js.map +1 -0
  153. package/dist/core/search/providers.d.ts +3 -13
  154. package/dist/core/search/providers.js +19 -88
  155. package/dist/core/search/providers.js.map +1 -1
  156. package/dist/core/search/semantic-defaults.js +2 -7
  157. package/dist/core/search/semantic-defaults.js.map +1 -1
  158. package/dist/core/search/vector-stores.d.ts +4 -13
  159. package/dist/core/search/vector-stores.js +40 -93
  160. package/dist/core/search/vector-stores.js.map +1 -1
  161. package/dist/core/sentry/helpers.d.ts +27 -0
  162. package/dist/core/sentry/helpers.js +171 -0
  163. package/dist/core/sentry/helpers.js.map +1 -0
  164. package/dist/core/sentry/instrument.d.ts +25 -0
  165. package/dist/core/sentry/instrument.js +204 -0
  166. package/dist/core/sentry/instrument.js.map +1 -0
  167. package/dist/core/shared/command-types.js.map +1 -1
  168. package/dist/core/shared/conflict-markers.js.map +1 -1
  169. package/dist/core/shared/constants.d.ts +3 -0
  170. package/dist/core/shared/constants.js +58 -1
  171. package/dist/core/shared/constants.js.map +1 -1
  172. package/dist/core/shared/errors.js.map +1 -1
  173. package/dist/core/shared/index.d.ts +1 -0
  174. package/dist/core/shared/index.js +1 -0
  175. package/dist/core/shared/index.js.map +1 -1
  176. package/dist/core/shared/primitives.d.ts +13 -0
  177. package/dist/core/shared/primitives.js +33 -0
  178. package/dist/core/shared/primitives.js.map +1 -0
  179. package/dist/core/shared/serialization.js.map +1 -1
  180. package/dist/core/shared/text-normalization.js.map +1 -1
  181. package/dist/core/shared/time.js.map +1 -1
  182. package/dist/core/store/front-matter-cache.d.ts +6 -0
  183. package/dist/core/store/front-matter-cache.js +150 -0
  184. package/dist/core/store/front-matter-cache.js.map +1 -0
  185. package/dist/core/store/index.js.map +1 -1
  186. package/dist/core/store/item-format-migration.js.map +1 -1
  187. package/dist/core/store/item-store.js +46 -36
  188. package/dist/core/store/item-store.js.map +1 -1
  189. package/dist/core/store/paths.js.map +1 -1
  190. package/dist/core/store/settings.js +36 -0
  191. package/dist/core/store/settings.js.map +1 -1
  192. package/dist/core/telemetry/consent.js.map +1 -1
  193. package/dist/core/telemetry/observability.d.ts +24 -0
  194. package/dist/core/telemetry/observability.js +185 -0
  195. package/dist/core/telemetry/observability.js.map +1 -0
  196. package/dist/core/telemetry/runtime.d.ts +29 -3
  197. package/dist/core/telemetry/runtime.js +337 -25
  198. package/dist/core/telemetry/runtime.js.map +1 -1
  199. package/dist/core/test/background-runs.js.map +1 -1
  200. package/dist/core/test/item-test-run-tracking.js.map +1 -1
  201. package/dist/sdk/cli-contracts.js +28 -0
  202. package/dist/sdk/cli-contracts.js.map +1 -1
  203. package/dist/sdk/index.d.ts +1 -1
  204. package/dist/sdk/index.js.map +1 -1
  205. package/dist/types/index.js.map +1 -1
  206. package/dist/types.d.ts +21 -0
  207. package/dist/types.js +11 -0
  208. package/dist/types.js.map +1 -1
  209. package/docs/AGENT_GUIDE.md +125 -0
  210. package/docs/ARCHITECTURE.md +201 -478
  211. package/docs/COMMANDS.md +209 -0
  212. package/docs/CONFIGURATION.md +146 -0
  213. package/docs/EXTENSIONS.md +146 -645
  214. package/docs/QUICKSTART.md +108 -0
  215. package/docs/README.md +70 -0
  216. package/docs/RELEASING.md +92 -50
  217. package/docs/SDK.md +127 -68
  218. package/docs/TESTING.md +125 -0
  219. package/docs/examples/starter-extension/README.md +39 -25
  220. package/package.json +24 -11
  221. package/dist/command-types.d.ts +0 -1
  222. package/dist/command-types.js +0 -2
  223. package/dist/command-types.js.map +0 -1
  224. package/dist/constants.d.ts +0 -1
  225. package/dist/constants.js +0 -2
  226. package/dist/constants.js.map +0 -1
  227. package/dist/errors.d.ts +0 -1
  228. package/dist/errors.js +0 -2
  229. package/dist/errors.js.map +0 -1
  230. package/dist/fs-utils.d.ts +0 -1
  231. package/dist/fs-utils.js +0 -2
  232. package/dist/fs-utils.js.map +0 -1
  233. package/dist/history.d.ts +0 -1
  234. package/dist/history.js +0 -2
  235. package/dist/history.js.map +0 -1
  236. package/dist/id.d.ts +0 -1
  237. package/dist/id.js +0 -2
  238. package/dist/id.js.map +0 -1
  239. package/dist/item-format.d.ts +0 -1
  240. package/dist/item-format.js +0 -2
  241. package/dist/item-format.js.map +0 -1
  242. package/dist/item-store.d.ts +0 -1
  243. package/dist/item-store.js +0 -2
  244. package/dist/item-store.js.map +0 -1
  245. package/dist/lock.d.ts +0 -1
  246. package/dist/lock.js +0 -2
  247. package/dist/lock.js.map +0 -1
  248. package/dist/output.d.ts +0 -1
  249. package/dist/output.js +0 -2
  250. package/dist/output.js.map +0 -1
  251. package/dist/parse.d.ts +0 -1
  252. package/dist/parse.js +0 -2
  253. package/dist/parse.js.map +0 -1
  254. package/dist/paths.d.ts +0 -1
  255. package/dist/paths.js +0 -2
  256. package/dist/paths.js.map +0 -1
  257. package/dist/serialization.d.ts +0 -1
  258. package/dist/serialization.js +0 -2
  259. package/dist/serialization.js.map +0 -1
  260. package/dist/settings.d.ts +0 -1
  261. package/dist/settings.js +0 -2
  262. package/dist/settings.js.map +0 -1
  263. package/dist/time.d.ts +0 -1
  264. package/dist/time.js +0 -2
  265. package/dist/time.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"error-guidance.js","sourceRoot":"","sources":["../../src/cli/error-guidance.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"error-guidance.js","sourceRoot":"/","sources":["cli/error-guidance.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PmCliErrorContext } from \"../core/shared/errors.js\";\n\ninterface GuidanceMessage {\n code: string;\n type: string;\n title: string;\n happened: string;\n required: string;\n why?: string;\n examples?: string[];\n nextSteps?: string[];\n}\n\nexport interface JsonErrorEnvelope {\n type: string;\n code: string;\n title: string;\n detail: string;\n required: string;\n exit_code: number;\n why?: string;\n examples?: string[];\n next_steps?: string[];\n}\n\nexport interface ErrorClassification {\n type: string;\n code: string;\n title: string;\n detail: string;\n required: string;\n why?: string;\n examples?: string[];\n next_steps?: string[];\n}\n\nexport interface CommanderGuidanceContext {\n unknownCommandExamples?: string[];\n unknownCommandNextSteps?: string[];\n}\n\nfunction errorType(code: string): string {\n return `urn:pm-cli:error:${code}`;\n}\n\nfunction makeGuidanceMessage(params: Omit<GuidanceMessage, \"type\">): GuidanceMessage {\n return {\n ...params,\n type: errorType(params.code),\n };\n}\n\nfunction renderList(title: string, entries: string[]): string[] {\n if (entries.length === 0) {\n return [];\n }\n return [title, ...entries.map((entry) => ` - ${entry}`)];\n}\n\nexport function renderGuidanceMessage(message: GuidanceMessage): string {\n const lines: string[] = [\n `Error: ${message.title}`,\n \"\",\n \"What happened:\",\n ` ${message.happened}`,\n \"\",\n \"What is required:\",\n ` ${message.required}`,\n ];\n if (message.why) {\n lines.push(\"\", \"Why:\");\n lines.push(` ${message.why}`);\n }\n if (message.examples && message.examples.length > 0) {\n lines.push(\"\");\n lines.push(...renderList(\"Examples:\", message.examples));\n }\n if (message.nextSteps && message.nextSteps.length > 0) {\n lines.push(\"\");\n lines.push(...renderList(\"Next steps:\", message.nextSteps));\n }\n return lines.join(\"\\n\");\n}\n\nfunction guidanceToJsonEnvelope(message: GuidanceMessage, exitCode: number): JsonErrorEnvelope {\n const payload: JsonErrorEnvelope = {\n type: message.type,\n code: message.code,\n title: message.title,\n detail: message.happened,\n required: message.required,\n exit_code: exitCode,\n };\n if (message.why) {\n payload.why = message.why;\n }\n if (message.examples && message.examples.length > 0) {\n payload.examples = message.examples;\n }\n if (message.nextSteps && message.nextSteps.length > 0) {\n payload.next_steps = message.nextSteps;\n }\n return payload;\n}\n\nfunction guidanceToClassification(message: GuidanceMessage): ErrorClassification {\n const payload: ErrorClassification = {\n type: message.type,\n code: message.code,\n title: message.title,\n detail: message.happened,\n required: message.required,\n };\n if (message.why) {\n payload.why = message.why;\n }\n if (message.examples && message.examples.length > 0) {\n payload.examples = message.examples;\n }\n if (message.nextSteps && message.nextSteps.length > 0) {\n payload.next_steps = message.nextSteps;\n }\n return payload;\n}\n\nfunction normalizeMessage(message: string): string {\n return message.replace(/\\(outputHelp\\)/g, \"\").trim();\n}\n\nfunction normalizeContextList(values: string[] | undefined): string[] | undefined {\n if (!Array.isArray(values)) {\n return undefined;\n }\n const normalized = values.map((value) => value.trim()).filter((value) => value.length > 0);\n return normalized.length > 0 ? normalized : undefined;\n}\n\nfunction buildFallbackTitleFromMessage(message: string): string | undefined {\n const firstLine = message.split(/\\r?\\n/)[0]?.trim() ?? \"\";\n if (firstLine.length === 0) {\n return undefined;\n }\n if (firstLine.length <= 120) {\n return firstLine;\n }\n return `${firstLine.slice(0, 117)}...`;\n}\n\nfunction applyPmCliErrorContext(\n guidance: GuidanceMessage,\n rawMessage: string,\n context: PmCliErrorContext | undefined,\n): GuidanceMessage {\n if (!context) {\n return guidance;\n }\n const normalizedRawMessage = normalizeMessage(rawMessage);\n const code = typeof context.code === \"string\" && context.code.trim().length > 0 ? context.code.trim() : guidance.code;\n const type = typeof context.type === \"string\" && context.type.trim().length > 0 ? context.type.trim() : errorType(code);\n const examples = normalizeContextList(context.examples) ?? guidance.examples;\n const nextSteps = normalizeContextList(context.nextSteps) ?? guidance.nextSteps;\n const fallbackTitle = guidance.code === \"command_failed\" && context.code ? buildFallbackTitleFromMessage(normalizedRawMessage) : undefined;\n return {\n ...guidance,\n code,\n type,\n title: fallbackTitle ?? guidance.title,\n happened: normalizedRawMessage.length > 0 ? normalizedRawMessage : guidance.happened,\n required: typeof context.required === \"string\" && context.required.trim().length > 0 ? context.required.trim() : guidance.required,\n why: typeof context.why === \"string\" && context.why.trim().length > 0 ? context.why.trim() : guidance.why,\n examples,\n nextSteps,\n };\n}\n\nfunction buildPmCliErrorGuidance(rawMessage: string, context?: PmCliErrorContext): GuidanceMessage {\n const message = normalizeMessage(rawMessage);\n\n const trackerNotInitialized = message.match(/^Tracker is not initialized at (.+)\\. Run pm init first\\.$/);\n if (trackerNotInitialized) {\n return applyPmCliErrorContext(\n makeGuidanceMessage({\n code: \"tracker_not_initialized\",\n title: \"Tracker is not initialized\",\n happened: `pm data path does not contain initialized tracker metadata (${trackerNotInitialized[1]}).`,\n required: \"Initialize tracker storage before running this command.\",\n why: \"Most commands require settings and tracker directories created by pm init.\",\n examples: [\"pm init\", \"pm init acme\"],\n nextSteps: ['Run \"pm init\", then rerun your original command.'],\n }),\n rawMessage,\n context,\n );\n }\n\n const itemNotFound = message.match(/^Item ([^ ]+) not found$/);\n if (itemNotFound) {\n const badId = itemNotFound[1];\n const isPlaceholder = /^(undefined|null|<.*>|\\[.*\\]|{.*}|)$/.test(badId);\n const happened = isPlaceholder\n ? `The item ID \"${badId}\" looks like a placeholder or unresolved variable. Ensure the ID argument is resolved before calling pm.`\n : `No item with id \"${badId}\" exists in the active tracker scope.`;\n const nextSteps = isPlaceholder\n ? [\n \"Check that the variable holding the item ID is defined before passing it to pm.\",\n 'Use \"pm list-open --limit 20\" to find valid IDs.',\n ]\n : [\"Confirm the active --path/PM_PATH scope, then retry with a valid id.\"];\n return applyPmCliErrorContext(\n makeGuidanceMessage({\n code: \"item_not_found\",\n title: \"Item ID not found\",\n happened,\n required: \"Use an existing item ID from current tracker data.\",\n why: \"Mutation and read commands operate only on known IDs.\",\n examples: ['pm list-open --limit 20', 'pm search \"<keyword>\" --limit 10'],\n nextSteps,\n }),\n rawMessage,\n context,\n );\n }\n\n if (message.includes(\"is assigned to\") && message.includes(\"Use --force to override\")) {\n return applyPmCliErrorContext(\n makeGuidanceMessage({\n code: \"ownership_conflict\",\n title: \"Ownership conflict\",\n happened: message,\n required:\n \"Run as assigned owner, use audit flags for safe non-owner updates, or use --force only for approved override scenarios.\",\n why: \"Ownership checks prevent accidental concurrent mutations on claimed items and protect against conflicting writes.\",\n examples: [\n 'pm update pm-a1b2 --allow-audit-update --description \"...\" --author \"audit-agent\"',\n 'pm update pm-a1b2 --allow-audit-dep-update --dep \"...\" --author \"audit-agent\"',\n 'pm comments pm-a1b2 \"...\" --allow-audit-comment --author \"audit-agent\"',\n 'pm claim pm-a1b2 --author \"codex-agent\"',\n 'pm release pm-a1b2 --allow-audit-release --author \"reviewer\"',\n 'pm update pm-a1b2 --status in_progress --force',\n ],\n nextSteps: [\n \"Use --allow-audit-update for metadata-only non-owner updates (excludes lifecycle/ownership fields).\",\n \"Use --allow-audit-dep-update for dependency-only non-owner additions.\",\n \"Use --allow-audit-comment on comments/notes/learnings for append-only audit entries.\",\n \"Use --force for PM audits and systematic metadata updates performed by leads/maintainers.\",\n \"Use --force when correcting known stale metadata after coordinating ownership changes.\",\n 'For non-terminal reassignment, prefer \"pm claim <ID> --author <you>\" before running other mutations.',\n 'For assignee handoff release workflows, prefer \"pm release <ID> --allow-audit-release --author <you>\" before using --force.',\n ],\n }),\n rawMessage,\n context,\n );\n }\n\n if (message.includes(\"is locked\")) {\n return applyPmCliErrorContext(\n makeGuidanceMessage({\n code: \"lock_conflict\",\n title: \"Lock conflict\",\n happened: message,\n required: \"Wait for lock release, or use --force where supported if lock is stale and safe to override.\",\n why: \"Locking protects item files from concurrent write races.\",\n examples: ['pm update pm-a1b2 --status in_progress --force --author \"codex-agent\"'],\n }),\n rawMessage,\n context,\n );\n }\n\n const missingRequiredOption = message.match(/^Missing required option /);\n const missingRequiredOptions = message.match(/^Missing required options /);\n if (missingRequiredOption || missingRequiredOptions) {\n const plural = Boolean(missingRequiredOptions);\n const missingOptionFlag = !plural ? message.replace(/^Missing required option\\s+/, \"\").trim() : null;\n const missingOptionRequired = missingOptionFlag\n ? `Pass ${missingOptionFlag} with a valid value before running the command.`\n : \"Provide the required option for this command invocation.\";\n return applyPmCliErrorContext(\n makeGuidanceMessage({\n code: \"missing_required_option\",\n title: plural ? \"Missing required options\" : missingOptionFlag ? `Missing required option ${missingOptionFlag}` : \"Missing required option\",\n happened: message,\n required: plural\n ? \"Provide every required option for this command invocation.\"\n : missingOptionRequired,\n why: \"Required options define command intent and enforce deterministic write contracts.\",\n examples: [\n 'pm create --title \"Task title\" --description \"Task details\" --type Task --create-mode progressive',\n 'pm create --title \"Task title\" --description \"Task details\" --type Task --status open --priority 1 --message \"Create task\" --dep \"id=pm-epic01,kind=parent,author=codex-agent,created_at=now\" --comment \"author=codex-agent,created_at=now,text=Why this task 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/example.ts,scope=project\" --test \"command=node scripts/run-tests.mjs test,scope=project,timeout_seconds=240\" --doc \"path=README.md,scope=project\"',\n ],\n nextSteps: [\n 'Run \"pm <command> --help\" to view required and recommended flags.',\n \"For staged triage without placeholder linkage values, use --create-mode progressive.\",\n ],\n }),\n rawMessage,\n context,\n );\n }\n\n if (message.startsWith(\"No update flags provided\")) {\n return applyPmCliErrorContext(\n makeGuidanceMessage({\n code: \"no_update_fields\",\n title: \"No update fields supplied\",\n happened: \"The update command was called without any field-changing flags.\",\n required:\n \"Provide at least one field-changing flag such as --status, --priority, --title, --tags, --description, or --body. Use --message only to label a real mutation.\",\n why: \"pm update mutates existing item fields; no-op invocations are rejected to avoid ambiguous history.\",\n examples: [\n 'pm update pm-a1b2 --status in_progress --message \"Start implementation\"',\n 'pm update pm-a1b2 --description \"Clarified implementation scope\" --message \"Clarify task intent\"',\n 'pm append pm-a1b2 --body \"Detailed progress notes\" --message \"Append progress notes\"',\n ],\n nextSteps: [\n \"Choose the item field you intend to change, then pair that change with --message for history context.\",\n \"Use pm comments, pm notes, pm learnings, or pm append when you only need to add narrative context.\",\n ],\n }),\n rawMessage,\n context,\n );\n }\n\n if (message.startsWith(\"Invalid \") || message.includes(\" must be \")) {\n return applyPmCliErrorContext(\n makeGuidanceMessage({\n code: \"invalid_argument_value\",\n title: \"Invalid argument value\",\n happened: message,\n required: \"Use values that match documented command constraints.\",\n why: \"Validation protects data consistency and deterministic behavior across commands.\",\n examples: [\"pm create --help\", \"pm update --help\", \"pm calendar --help\"],\n nextSteps: [\"Check allowed values in command help, then rerun with corrected input.\"],\n }),\n rawMessage,\n context,\n );\n }\n\n return applyPmCliErrorContext(\n makeGuidanceMessage({\n code: \"command_failed\",\n title: \"Command failed\",\n happened: message,\n required: \"Adjust command input or tracker state and retry.\",\n why: \"pm enforces explicit, deterministic contracts for data and command semantics.\",\n examples: [\"pm --help\", \"pm <command> --help\"],\n }),\n rawMessage,\n context,\n );\n}\n\nfunction commandExampleForRequiredOption(commandName: string | undefined, optionFlag: string, allowedTypes: string): string[] {\n if (commandName === \"create\" && optionFlag.startsWith(\"--type\")) {\n const firstAllowed = allowedTypes.split(\"|\")[0] || \"Task\";\n return [\n `pm create --title \"Example title\" --description \"Example description\" --type ${firstAllowed} --status open --priority 1 --message \"Create item\" --create-mode progressive`,\n ];\n }\n if (commandName === \"update\") {\n return ['pm update pm-a1b2 --status in_progress --message \"Start implementation\"'];\n }\n return [`pm ${commandName ?? \"<command>\"} --help`];\n}\n\nfunction buildCommanderErrorGuidance(\n rawMessage: string,\n commandName: string | undefined,\n allowedTypes: string,\n context?: CommanderGuidanceContext,\n): GuidanceMessage {\n const message = normalizeMessage(rawMessage);\n\n const requiredOption = message.match(/required option '([^']+)' not specified/);\n if (requiredOption) {\n const optionFlag = requiredOption[1];\n const isType = optionFlag.startsWith(\"--type\");\n return makeGuidanceMessage({\n code: \"missing_required_option\",\n title: `Missing required option ${optionFlag}`,\n happened: `Commander rejected the command because ${optionFlag} was not provided.`,\n required: `Pass ${optionFlag} with a valid value before running the command.`,\n why: isType\n ? \"--type selects item contract and policy routing, including required/disabled option rules.\"\n : \"Required flags define mandatory command intent and prevent ambiguous execution.\",\n examples: commandExampleForRequiredOption(commandName, optionFlag, allowedTypes),\n nextSteps: isType\n ? [`Allowed type values: ${allowedTypes}`, `Run \"pm ${commandName ?? \"create\"} --help --type <value>\" for type-aware policy details.`]\n : [`Run \"pm ${commandName ?? \"<command>\"} --help\" for required option guidance.`],\n });\n }\n\n const missingArgument = message.match(/missing required argument '([^']+)'/);\n if (missingArgument) {\n const argumentName = missingArgument[1];\n return makeGuidanceMessage({\n code: \"missing_required_argument\",\n title: `Missing required argument ${argumentName}`,\n happened: `Command invocation omitted positional argument ${argumentName}.`,\n required: `Provide ${argumentName} in the expected command position.`,\n why: \"Positional arguments identify the target entity or action context for the command.\",\n examples: [`pm ${commandName ?? \"<command>\"} --help`],\n });\n }\n\n const unknownOption = message.match(/unknown option '([^']+)'/);\n if (unknownOption) {\n const optionName = unknownOption[1];\n if (commandName === \"update\" && (optionName === \"--file\" || optionName === \"--doc\")) {\n return makeGuidanceMessage({\n code: \"unsupported_update_option\",\n title: `Unsupported option ${optionName} for update`,\n happened: `pm update does not accept ${optionName} for linked artifact mutations.`,\n required: \"Use dedicated linked-artifact commands instead of pm update for files/docs changes.\",\n why: \"pm update manages scalar item metadata, while linked files/docs are managed by pm files and pm docs.\",\n examples: [\n 'pm files pm-a1b2 --add \"path=src/cli/main.ts,scope=project,note=implementation surface\"',\n 'pm docs pm-a1b2 --add \"path=README.md,scope=project,note=user-facing contract\"',\n ],\n nextSteps: ['Run \"pm files --help\" and \"pm docs --help\" for add/remove payload formats.'],\n });\n }\n return makeGuidanceMessage({\n code: \"unknown_option\",\n title: `Unknown option ${optionName}`,\n happened: `Commander does not recognize option ${optionName} for this command path.`,\n required: \"Use supported options only, or move option to the correct subcommand.\",\n why: \"Option contracts are command-specific and intentionally validated.\",\n examples: [`pm ${commandName ?? \"<command>\"} --help`],\n });\n }\n\n const unknownCommand = message.match(/unknown command '([^']+)'/);\n if (unknownCommand) {\n const commandToken = unknownCommand[1];\n const runtimeExamples = normalizeContextList(context?.unknownCommandExamples);\n const runtimeNextSteps = normalizeContextList(context?.unknownCommandNextSteps);\n return makeGuidanceMessage({\n code: \"unknown_command\",\n title: `Unknown command ${commandToken}`,\n happened: `pm does not expose command path \"${commandToken}\" in current runtime configuration.`,\n required: \"Use a valid command name or subcommand path.\",\n why: \"Command registry includes core commands plus active extension command handlers.\",\n examples: runtimeExamples ?? [\"pm --help\"],\n nextSteps: runtimeNextSteps ?? [\"Verify spelling and active extensions, then rerun.\"],\n });\n }\n\n return makeGuidanceMessage({\n code: \"invalid_command_usage\",\n title: \"Invalid command usage\",\n happened: message,\n required: \"Use the command with valid arguments and options.\",\n why: \"Commander validates CLI contracts before execution.\",\n examples: [\"pm --help\", `pm ${commandName ?? \"<command>\"} --help`],\n });\n}\n\nexport function formatPmCliErrorForDisplay(rawMessage: string, context?: PmCliErrorContext): string {\n return renderGuidanceMessage(buildPmCliErrorGuidance(rawMessage, context));\n}\n\nexport function classifyPmCliError(rawMessage: string, context?: PmCliErrorContext): ErrorClassification {\n return guidanceToClassification(buildPmCliErrorGuidance(rawMessage, context));\n}\n\nexport function formatPmCliErrorForJson(rawMessage: string, exitCode: number, context?: PmCliErrorContext): JsonErrorEnvelope {\n return guidanceToJsonEnvelope(buildPmCliErrorGuidance(rawMessage, context), exitCode);\n}\n\nexport function formatCommanderErrorForDisplay(\n rawMessage: string,\n commandName: string | undefined,\n allowedTypes: string,\n context?: CommanderGuidanceContext,\n): string {\n return renderGuidanceMessage(buildCommanderErrorGuidance(rawMessage, commandName, allowedTypes, context));\n}\n\nexport function classifyCommanderError(\n rawMessage: string,\n commandName: string | undefined,\n allowedTypes: string,\n context?: CommanderGuidanceContext,\n): ErrorClassification {\n return guidanceToClassification(buildCommanderErrorGuidance(rawMessage, commandName, allowedTypes, context));\n}\n\nexport function formatCommanderErrorForJson(\n rawMessage: string,\n commandName: string | undefined,\n allowedTypes: string,\n exitCode: number,\n context?: CommanderGuidanceContext,\n): JsonErrorEnvelope {\n return guidanceToJsonEnvelope(buildCommanderErrorGuidance(rawMessage, commandName, allowedTypes, context), exitCode);\n}\n\nexport function formatUnknownErrorForJson(rawMessage: string, exitCode: number): JsonErrorEnvelope {\n const guidance = buildUnknownErrorGuidance(rawMessage);\n return guidanceToJsonEnvelope(guidance, exitCode);\n}\n\nfunction buildUnknownErrorGuidance(rawMessage: string): GuidanceMessage {\n return makeGuidanceMessage({\n code: \"unknown_error\",\n title: \"Unhandled error\",\n happened: normalizeMessage(rawMessage),\n required: \"Inspect command input and runtime state, then retry.\",\n why: \"Unexpected runtime failures can occur from environment or extension-level issues.\",\n examples: [\"pm --help\", \"pm health --json\"],\n });\n}\n\nexport function classifyUnknownError(rawMessage: string): ErrorClassification {\n return guidanceToClassification(buildUnknownErrorGuidance(rawMessage));\n}\n"]}
@@ -0,0 +1,48 @@
1
+ import { Command } from "commander";
2
+ import type { RegisteredExtensionCommandDefinition, RegisteredExtensionFlagDefinitions } from "../core/extensions/index.js";
3
+ export interface ExtensionCommandArgumentHelpDescriptor {
4
+ name: string;
5
+ required: boolean;
6
+ variadic: boolean;
7
+ description?: string;
8
+ }
9
+ export interface ExtensionCommandHelpDescriptor {
10
+ command: string;
11
+ action: string;
12
+ description?: string;
13
+ intent?: string;
14
+ examples: string[];
15
+ failure_hints: string[];
16
+ arguments: ExtensionCommandArgumentHelpDescriptor[];
17
+ flags: Array<Record<string, unknown>>;
18
+ source?: {
19
+ layer: "global" | "project";
20
+ name: string;
21
+ };
22
+ }
23
+ export interface HelpOptionSummary {
24
+ flags: string;
25
+ long: string | null;
26
+ short: string | null;
27
+ description: string;
28
+ takes_value: boolean;
29
+ value_required: boolean;
30
+ value_name: string | null;
31
+ variadic: boolean;
32
+ required: boolean;
33
+ aliases: string[];
34
+ alias_for: string | null;
35
+ default_value?: unknown;
36
+ }
37
+ export declare function normalizeExtensionCommandPath(commandPath: string): string;
38
+ export declare function collectDynamicExtensionFlagHelpByCommand(registrations: RegisteredExtensionFlagDefinitions[]): Map<string, string>;
39
+ export declare function collectExtensionCommandHelpDescriptors(commandHandlers: string[], commandDefinitions: RegisteredExtensionCommandDefinition[], flagRegistrations: RegisteredExtensionFlagDefinitions[]): Map<string, ExtensionCommandHelpDescriptor>;
40
+ export declare function applyDynamicExtensionArguments(command: Command, descriptor: ExtensionCommandHelpDescriptor): void;
41
+ export declare function applyDynamicExtensionOptions(command: Command, descriptor: ExtensionCommandHelpDescriptor): void;
42
+ export declare function buildDynamicExtensionHelpOptionSummaries(descriptor: ExtensionCommandHelpDescriptor | undefined): HelpOptionSummary[];
43
+ export declare function mergeHelpOptionSummaries(base: HelpOptionSummary[], extension: HelpOptionSummary[]): HelpOptionSummary[];
44
+ export declare function buildDynamicExtensionCommandMetadataHelp(descriptor: ExtensionCommandHelpDescriptor): string | null;
45
+ export declare function commandAliases(command: Command): string[];
46
+ export declare function findDirectChildCommand(parent: Command, name: string): Command | null;
47
+ export declare function findCommandByPath(root: Command, pathParts: string[]): Command | null;
48
+ export declare function ensureCommandPath(root: Command, pathParts: string[]): Command | null;
@@ -0,0 +1,389 @@
1
+ export function normalizeExtensionCommandPath(commandPath) {
2
+ return commandPath
3
+ .trim()
4
+ .toLowerCase()
5
+ .split(/\s+/)
6
+ .filter((part) => part.length > 0)
7
+ .join(" ");
8
+ }
9
+ function toNonEmptyFlagString(value) {
10
+ if (typeof value !== "string") {
11
+ return null;
12
+ }
13
+ const trimmed = value.trim();
14
+ return trimmed.length > 0 ? trimmed : null;
15
+ }
16
+ function toOptionalBoolean(value) {
17
+ return typeof value === "boolean" ? value : undefined;
18
+ }
19
+ function formatDynamicExtensionFlagHelpLine(definition) {
20
+ const visible = toOptionalBoolean(definition.visible);
21
+ if (visible === false) {
22
+ return null;
23
+ }
24
+ const longName = toNonEmptyFlagString(definition.long);
25
+ if (!longName || !longName.startsWith("--") || longName.length < 3) {
26
+ return null;
27
+ }
28
+ const shortName = toNonEmptyFlagString(definition.short);
29
+ const shortPrefix = shortName && shortName.startsWith("-") && !shortName.startsWith("--") ? `${shortName}, ` : "";
30
+ const valueName = toNonEmptyFlagString(definition.value_name);
31
+ const valueSuffix = valueName ? ` <${valueName}>` : "";
32
+ const description = toNonEmptyFlagString(definition.description) ?? "Extension-provided option.";
33
+ const markers = [];
34
+ if (toOptionalBoolean(definition.required) === true) {
35
+ markers.push("required");
36
+ }
37
+ if (toOptionalBoolean(definition.enabled) === false) {
38
+ markers.push("disabled");
39
+ }
40
+ const markerSuffix = markers.length > 0 ? ` [${markers.join(", ")}]` : "";
41
+ return `${shortPrefix}${longName}${valueSuffix} ${description}${markerSuffix}`;
42
+ }
43
+ function buildDynamicExtensionFlagHelp(definitions) {
44
+ const lines = [
45
+ ...new Set(definitions
46
+ .map(formatDynamicExtensionFlagHelpLine)
47
+ .filter((line) => line !== null)),
48
+ ].sort((left, right) => left.localeCompare(right));
49
+ if (lines.length === 0) {
50
+ return null;
51
+ }
52
+ return `\nExtension-provided flags:\n ${lines.join("\n ")}`;
53
+ }
54
+ export function collectDynamicExtensionFlagHelpByCommand(registrations) {
55
+ const grouped = new Map();
56
+ for (const registration of registrations) {
57
+ const commandPath = normalizeExtensionCommandPath(registration.target_command);
58
+ if (commandPath.length === 0) {
59
+ continue;
60
+ }
61
+ const existing = grouped.get(commandPath) ?? [];
62
+ existing.push(...registration.flags);
63
+ grouped.set(commandPath, existing);
64
+ }
65
+ const entries = [...grouped.entries()].sort(([left], [right]) => left.localeCompare(right));
66
+ const helpByCommand = new Map();
67
+ for (const [commandPath, definitions] of entries) {
68
+ const helpText = buildDynamicExtensionFlagHelp(definitions);
69
+ if (!helpText) {
70
+ continue;
71
+ }
72
+ helpByCommand.set(commandPath, helpText);
73
+ }
74
+ return helpByCommand;
75
+ }
76
+ function normalizeExtensionCommandAction(commandPath, action) {
77
+ if (typeof action !== "string" || action.trim().length === 0) {
78
+ return commandPath.replace(/\s+/g, "-");
79
+ }
80
+ return action.trim().toLowerCase();
81
+ }
82
+ function normalizeExtensionCommandStringList(values) {
83
+ if (!Array.isArray(values)) {
84
+ return [];
85
+ }
86
+ const normalized = [];
87
+ const seen = new Set();
88
+ for (const value of values) {
89
+ if (typeof value !== "string") {
90
+ continue;
91
+ }
92
+ const trimmed = value.trim();
93
+ if (trimmed.length === 0 || seen.has(trimmed)) {
94
+ continue;
95
+ }
96
+ seen.add(trimmed);
97
+ normalized.push(trimmed);
98
+ }
99
+ return normalized;
100
+ }
101
+ function normalizeExtensionCommandArguments(values) {
102
+ if (!Array.isArray(values)) {
103
+ return [];
104
+ }
105
+ return values
106
+ .map((value) => {
107
+ const name = typeof value.name === "string" ? value.name.trim() : "";
108
+ if (name.length === 0) {
109
+ return null;
110
+ }
111
+ const normalized = {
112
+ name,
113
+ required: value.required === true,
114
+ variadic: value.variadic === true,
115
+ };
116
+ if (typeof value.description === "string" && value.description.trim().length > 0) {
117
+ normalized.description = value.description.trim();
118
+ }
119
+ return normalized;
120
+ })
121
+ .filter((entry) => entry !== null);
122
+ }
123
+ export function collectExtensionCommandHelpDescriptors(commandHandlers, commandDefinitions, flagRegistrations) {
124
+ const definitionsByCommand = new Map();
125
+ for (const definition of commandDefinitions) {
126
+ const commandPath = normalizeExtensionCommandPath(definition.command);
127
+ if (commandPath.length === 0) {
128
+ continue;
129
+ }
130
+ const description = typeof definition.description === "string" && definition.description.trim().length > 0
131
+ ? definition.description.trim()
132
+ : undefined;
133
+ const intent = typeof definition.intent === "string" && definition.intent.trim().length > 0
134
+ ? definition.intent.trim()
135
+ : undefined;
136
+ definitionsByCommand.set(commandPath, {
137
+ command: commandPath,
138
+ action: normalizeExtensionCommandAction(commandPath, definition.action),
139
+ description,
140
+ intent,
141
+ examples: normalizeExtensionCommandStringList(definition.examples),
142
+ failure_hints: normalizeExtensionCommandStringList(definition.failure_hints),
143
+ arguments: normalizeExtensionCommandArguments(definition.arguments),
144
+ flags: [],
145
+ source: {
146
+ layer: definition.layer,
147
+ name: definition.name,
148
+ },
149
+ });
150
+ }
151
+ const flagsByCommand = new Map();
152
+ for (const registration of flagRegistrations) {
153
+ const commandPath = normalizeExtensionCommandPath(registration.target_command);
154
+ if (commandPath.length === 0) {
155
+ continue;
156
+ }
157
+ const existing = flagsByCommand.get(commandPath) ?? [];
158
+ existing.push(...registration.flags);
159
+ flagsByCommand.set(commandPath, existing);
160
+ }
161
+ const commandSet = new Set();
162
+ for (const commandPath of commandHandlers) {
163
+ const normalized = normalizeExtensionCommandPath(commandPath);
164
+ if (normalized.length > 0) {
165
+ commandSet.add(normalized);
166
+ }
167
+ }
168
+ for (const commandPath of definitionsByCommand.keys()) {
169
+ commandSet.add(commandPath);
170
+ }
171
+ for (const commandPath of flagsByCommand.keys()) {
172
+ commandSet.add(commandPath);
173
+ }
174
+ const descriptors = new Map();
175
+ const sortedCommands = [...commandSet].sort((left, right) => left.localeCompare(right));
176
+ for (const commandPath of sortedCommands) {
177
+ const definition = definitionsByCommand.get(commandPath);
178
+ const flags = flagsByCommand.get(commandPath) ?? [];
179
+ if (definition) {
180
+ descriptors.set(commandPath, {
181
+ ...definition,
182
+ flags,
183
+ });
184
+ continue;
185
+ }
186
+ descriptors.set(commandPath, {
187
+ command: commandPath,
188
+ action: normalizeExtensionCommandAction(commandPath, undefined),
189
+ examples: [],
190
+ failure_hints: [],
191
+ arguments: [],
192
+ flags,
193
+ });
194
+ }
195
+ return descriptors;
196
+ }
197
+ function buildExtensionArgumentToken(argument) {
198
+ const variadicSuffix = argument.variadic ? "..." : "";
199
+ if (argument.required) {
200
+ return `<${argument.name}${variadicSuffix}>`;
201
+ }
202
+ return `[${argument.name}${variadicSuffix}]`;
203
+ }
204
+ export function applyDynamicExtensionArguments(command, descriptor) {
205
+ for (const argument of descriptor.arguments) {
206
+ command.argument(buildExtensionArgumentToken(argument), argument.description ?? "Extension argument.");
207
+ }
208
+ }
209
+ function formatDynamicExtensionOptionFlags(definition) {
210
+ const visible = toOptionalBoolean(definition.visible);
211
+ if (visible === false) {
212
+ return null;
213
+ }
214
+ const longName = toNonEmptyFlagString(definition.long);
215
+ const shortName = toNonEmptyFlagString(definition.short);
216
+ const normalizedShort = shortName && shortName.startsWith("-") && !shortName.startsWith("--") ? shortName : null;
217
+ const normalizedLong = longName && longName.startsWith("--") && longName.length > 2 ? longName : null;
218
+ if (!normalizedLong && !normalizedShort) {
219
+ return null;
220
+ }
221
+ const optionValueName = toNonEmptyFlagString(definition.value_name);
222
+ const optionValueSuffix = optionValueName ? ` <${optionValueName}>` : "";
223
+ const optionNames = [normalizedShort, normalizedLong].filter((entry) => entry !== null);
224
+ return `${optionNames.join(", ")}${optionValueSuffix}`;
225
+ }
226
+ function formatDynamicExtensionOptionDescription(definition) {
227
+ const description = toNonEmptyFlagString(definition.description) ?? "Extension-provided option.";
228
+ const markers = [];
229
+ if (toOptionalBoolean(definition.required) === true) {
230
+ markers.push("required");
231
+ }
232
+ if (toOptionalBoolean(definition.enabled) === false) {
233
+ markers.push("disabled");
234
+ }
235
+ const markerSuffix = markers.length > 0 ? ` [${markers.join(", ")}]` : "";
236
+ return `${description}${markerSuffix}`;
237
+ }
238
+ export function applyDynamicExtensionOptions(command, descriptor) {
239
+ const seen = new Set();
240
+ for (const definition of descriptor.flags) {
241
+ const optionFlags = formatDynamicExtensionOptionFlags(definition);
242
+ if (!optionFlags || seen.has(optionFlags)) {
243
+ continue;
244
+ }
245
+ seen.add(optionFlags);
246
+ command.option(optionFlags, formatDynamicExtensionOptionDescription(definition));
247
+ }
248
+ }
249
+ function buildDynamicExtensionHelpOptionSummary(definition) {
250
+ const flags = formatDynamicExtensionOptionFlags(definition);
251
+ if (!flags) {
252
+ return null;
253
+ }
254
+ const longName = toNonEmptyFlagString(definition.long);
255
+ const shortName = toNonEmptyFlagString(definition.short);
256
+ const normalizedLong = longName && longName.startsWith("--") && longName.length > 2 ? longName : null;
257
+ const normalizedShort = shortName && shortName.startsWith("-") && !shortName.startsWith("--") ? shortName : null;
258
+ const valueName = toNonEmptyFlagString(definition.value_name);
259
+ const required = toOptionalBoolean(definition.required) === true;
260
+ return {
261
+ flags,
262
+ long: normalizedLong,
263
+ short: normalizedShort,
264
+ description: formatDynamicExtensionOptionDescription(definition),
265
+ takes_value: valueName !== null,
266
+ value_required: valueName !== null,
267
+ value_name: valueName,
268
+ variadic: false,
269
+ required,
270
+ aliases: [],
271
+ alias_for: null,
272
+ };
273
+ }
274
+ export function buildDynamicExtensionHelpOptionSummaries(descriptor) {
275
+ if (!descriptor) {
276
+ return [];
277
+ }
278
+ const summaries = [];
279
+ const seen = new Set();
280
+ for (const definition of descriptor.flags) {
281
+ const summary = buildDynamicExtensionHelpOptionSummary(definition);
282
+ if (!summary || seen.has(summary.flags)) {
283
+ continue;
284
+ }
285
+ seen.add(summary.flags);
286
+ summaries.push(summary);
287
+ }
288
+ return summaries;
289
+ }
290
+ export function mergeHelpOptionSummaries(base, extension) {
291
+ if (extension.length === 0) {
292
+ return base;
293
+ }
294
+ const merged = [...base];
295
+ const seen = new Set(base.map((entry) => entry.flags));
296
+ for (const entry of extension) {
297
+ if (seen.has(entry.flags)) {
298
+ continue;
299
+ }
300
+ seen.add(entry.flags);
301
+ merged.push(entry);
302
+ }
303
+ return merged;
304
+ }
305
+ export function buildDynamicExtensionCommandMetadataHelp(descriptor) {
306
+ const lines = [];
307
+ if (descriptor.intent) {
308
+ lines.push(`Intent: ${descriptor.intent}`);
309
+ }
310
+ if (descriptor.action) {
311
+ lines.push(`Action contract: ${descriptor.action}`);
312
+ }
313
+ if (descriptor.examples.length > 0) {
314
+ lines.push("Examples:");
315
+ for (const example of descriptor.examples) {
316
+ lines.push(` - ${example}`);
317
+ }
318
+ }
319
+ if (descriptor.failure_hints.length > 0) {
320
+ lines.push("Common failure hints:");
321
+ for (const hint of descriptor.failure_hints) {
322
+ lines.push(` - ${hint}`);
323
+ }
324
+ }
325
+ if (lines.length === 0) {
326
+ return null;
327
+ }
328
+ return `\nExtension command metadata:\n ${lines.join("\n ")}`;
329
+ }
330
+ export function commandAliases(command) {
331
+ const commandRecord = command;
332
+ if (typeof commandRecord.aliases === "function") {
333
+ return commandRecord.aliases().map((value) => value.trim().toLowerCase()).filter((value) => value.length > 0);
334
+ }
335
+ if (typeof commandRecord.alias === "function") {
336
+ const alias = commandRecord.alias();
337
+ if (typeof alias === "string" && alias.trim().length > 0) {
338
+ return [alias.trim().toLowerCase()];
339
+ }
340
+ }
341
+ if (Array.isArray(commandRecord._aliases)) {
342
+ return commandRecord._aliases.map((value) => value.trim().toLowerCase()).filter((value) => value.length > 0);
343
+ }
344
+ return [];
345
+ }
346
+ export function findDirectChildCommand(parent, name) {
347
+ const normalizedTarget = name.trim().toLowerCase();
348
+ return (parent.commands.find((entry) => {
349
+ if (entry.name().trim().toLowerCase() === normalizedTarget) {
350
+ return true;
351
+ }
352
+ return commandAliases(entry).includes(normalizedTarget);
353
+ }) ?? null);
354
+ }
355
+ export function findCommandByPath(root, pathParts) {
356
+ let current = root;
357
+ for (const part of pathParts) {
358
+ const next = findDirectChildCommand(current, part);
359
+ if (!next) {
360
+ return null;
361
+ }
362
+ current = next;
363
+ }
364
+ return current;
365
+ }
366
+ export function ensureCommandPath(root, pathParts) {
367
+ if (pathParts.length === 0) {
368
+ return null;
369
+ }
370
+ let current = root;
371
+ for (let index = 0; index < pathParts.length; index += 1) {
372
+ const part = pathParts[index];
373
+ const existing = findDirectChildCommand(current, part);
374
+ if (existing) {
375
+ current = existing;
376
+ continue;
377
+ }
378
+ const created = current.command(part);
379
+ if (index < pathParts.length - 1) {
380
+ created.description("Extension-provided command group.");
381
+ }
382
+ else {
383
+ created.description("Extension-provided command path.");
384
+ }
385
+ current = created;
386
+ }
387
+ return current;
388
+ }
389
+ //# sourceMappingURL=extension-command-help.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extension-command-help.js","sourceRoot":"/","sources":["cli/extension-command-help.ts"],"names":[],"mappings":"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","sourcesContent":["import { Command } from \"commander\";\nimport type {\n RegisteredExtensionCommandDefinition,\n RegisteredExtensionFlagDefinitions,\n} from \"../core/extensions/index.js\";\n\nexport interface ExtensionCommandArgumentHelpDescriptor {\n name: string;\n required: boolean;\n variadic: boolean;\n description?: string;\n}\n\nexport interface ExtensionCommandHelpDescriptor {\n command: string;\n action: string;\n description?: string;\n intent?: string;\n examples: string[];\n failure_hints: string[];\n arguments: ExtensionCommandArgumentHelpDescriptor[];\n flags: Array<Record<string, unknown>>;\n source?: {\n layer: \"global\" | \"project\";\n name: string;\n };\n}\n\nexport interface HelpOptionSummary {\n flags: string;\n long: string | null;\n short: string | null;\n description: string;\n takes_value: boolean;\n value_required: boolean;\n value_name: string | null;\n variadic: boolean;\n required: boolean;\n aliases: string[];\n alias_for: string | null;\n default_value?: unknown;\n}\n\nexport function normalizeExtensionCommandPath(commandPath: string): string {\n return commandPath\n .trim()\n .toLowerCase()\n .split(/\\s+/)\n .filter((part) => part.length > 0)\n .join(\" \");\n}\n\nfunction toNonEmptyFlagString(value: unknown): string | null {\n if (typeof value !== \"string\") {\n return null;\n }\n const trimmed = value.trim();\n return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction toOptionalBoolean(value: unknown): boolean | undefined {\n return typeof value === \"boolean\" ? value : undefined;\n}\n\nfunction formatDynamicExtensionFlagHelpLine(definition: Record<string, unknown>): string | null {\n const visible = toOptionalBoolean(definition.visible);\n if (visible === false) {\n return null;\n }\n const longName = toNonEmptyFlagString(definition.long);\n if (!longName || !longName.startsWith(\"--\") || longName.length < 3) {\n return null;\n }\n\n const shortName = toNonEmptyFlagString(definition.short);\n const shortPrefix = shortName && shortName.startsWith(\"-\") && !shortName.startsWith(\"--\") ? `${shortName}, ` : \"\";\n const valueName = toNonEmptyFlagString(definition.value_name);\n const valueSuffix = valueName ? ` <${valueName}>` : \"\";\n const description = toNonEmptyFlagString(definition.description) ?? \"Extension-provided option.\";\n const markers: string[] = [];\n if (toOptionalBoolean(definition.required) === true) {\n markers.push(\"required\");\n }\n if (toOptionalBoolean(definition.enabled) === false) {\n markers.push(\"disabled\");\n }\n const markerSuffix = markers.length > 0 ? ` [${markers.join(\", \")}]` : \"\";\n return `${shortPrefix}${longName}${valueSuffix} ${description}${markerSuffix}`;\n}\n\nfunction buildDynamicExtensionFlagHelp(definitions: Array<Record<string, unknown>>): string | null {\n const lines = [\n ...new Set(\n definitions\n .map(formatDynamicExtensionFlagHelpLine)\n .filter((line): line is string => line !== null),\n ),\n ].sort((left, right) => left.localeCompare(right));\n if (lines.length === 0) {\n return null;\n }\n return `\\nExtension-provided flags:\\n ${lines.join(\"\\n \")}`;\n}\n\nexport function collectDynamicExtensionFlagHelpByCommand(\n registrations: RegisteredExtensionFlagDefinitions[],\n): Map<string, string> {\n const grouped = new Map<string, Array<Record<string, unknown>>>();\n for (const registration of registrations) {\n const commandPath = normalizeExtensionCommandPath(registration.target_command);\n if (commandPath.length === 0) {\n continue;\n }\n const existing = grouped.get(commandPath) ?? [];\n existing.push(...registration.flags);\n grouped.set(commandPath, existing);\n }\n\n const entries = [...grouped.entries()].sort(([left], [right]) => left.localeCompare(right));\n const helpByCommand = new Map<string, string>();\n for (const [commandPath, definitions] of entries) {\n const helpText = buildDynamicExtensionFlagHelp(definitions);\n if (!helpText) {\n continue;\n }\n helpByCommand.set(commandPath, helpText);\n }\n return helpByCommand;\n}\n\nfunction normalizeExtensionCommandAction(commandPath: string, action: string | undefined): string {\n if (typeof action !== \"string\" || action.trim().length === 0) {\n return commandPath.replace(/\\s+/g, \"-\");\n }\n return action.trim().toLowerCase();\n}\n\nfunction normalizeExtensionCommandStringList(values: string[] | undefined): string[] {\n if (!Array.isArray(values)) {\n return [];\n }\n const normalized: string[] = [];\n const seen = new Set<string>();\n for (const value of values) {\n if (typeof value !== \"string\") {\n continue;\n }\n const trimmed = value.trim();\n if (trimmed.length === 0 || seen.has(trimmed)) {\n continue;\n }\n seen.add(trimmed);\n normalized.push(trimmed);\n }\n return normalized;\n}\n\nfunction normalizeExtensionCommandArguments(\n values: Array<{ name?: unknown; required?: unknown; variadic?: unknown; description?: unknown }> | undefined,\n): ExtensionCommandArgumentHelpDescriptor[] {\n if (!Array.isArray(values)) {\n return [];\n }\n return values\n .map((value) => {\n const name = typeof value.name === \"string\" ? value.name.trim() : \"\";\n if (name.length === 0) {\n return null;\n }\n const normalized: ExtensionCommandArgumentHelpDescriptor = {\n name,\n required: value.required === true,\n variadic: value.variadic === true,\n };\n if (typeof value.description === \"string\" && value.description.trim().length > 0) {\n normalized.description = value.description.trim();\n }\n return normalized;\n })\n .filter((entry): entry is ExtensionCommandArgumentHelpDescriptor => entry !== null);\n}\n\nexport function collectExtensionCommandHelpDescriptors(\n commandHandlers: string[],\n commandDefinitions: RegisteredExtensionCommandDefinition[],\n flagRegistrations: RegisteredExtensionFlagDefinitions[],\n): Map<string, ExtensionCommandHelpDescriptor> {\n const definitionsByCommand = new Map<string, ExtensionCommandHelpDescriptor>();\n for (const definition of commandDefinitions) {\n const commandPath = normalizeExtensionCommandPath(definition.command);\n if (commandPath.length === 0) {\n continue;\n }\n const description =\n typeof definition.description === \"string\" && definition.description.trim().length > 0\n ? definition.description.trim()\n : undefined;\n const intent =\n typeof definition.intent === \"string\" && definition.intent.trim().length > 0\n ? definition.intent.trim()\n : undefined;\n definitionsByCommand.set(commandPath, {\n command: commandPath,\n action: normalizeExtensionCommandAction(commandPath, definition.action),\n description,\n intent,\n examples: normalizeExtensionCommandStringList(definition.examples),\n failure_hints: normalizeExtensionCommandStringList(definition.failure_hints),\n arguments: normalizeExtensionCommandArguments(definition.arguments),\n flags: [],\n source: {\n layer: definition.layer,\n name: definition.name,\n },\n });\n }\n\n const flagsByCommand = new Map<string, Array<Record<string, unknown>>>();\n for (const registration of flagRegistrations) {\n const commandPath = normalizeExtensionCommandPath(registration.target_command);\n if (commandPath.length === 0) {\n continue;\n }\n const existing = flagsByCommand.get(commandPath) ?? [];\n existing.push(...registration.flags);\n flagsByCommand.set(commandPath, existing);\n }\n\n const commandSet = new Set<string>();\n for (const commandPath of commandHandlers) {\n const normalized = normalizeExtensionCommandPath(commandPath);\n if (normalized.length > 0) {\n commandSet.add(normalized);\n }\n }\n for (const commandPath of definitionsByCommand.keys()) {\n commandSet.add(commandPath);\n }\n for (const commandPath of flagsByCommand.keys()) {\n commandSet.add(commandPath);\n }\n\n const descriptors = new Map<string, ExtensionCommandHelpDescriptor>();\n const sortedCommands = [...commandSet].sort((left, right) => left.localeCompare(right));\n for (const commandPath of sortedCommands) {\n const definition = definitionsByCommand.get(commandPath);\n const flags = flagsByCommand.get(commandPath) ?? [];\n if (definition) {\n descriptors.set(commandPath, {\n ...definition,\n flags,\n });\n continue;\n }\n descriptors.set(commandPath, {\n command: commandPath,\n action: normalizeExtensionCommandAction(commandPath, undefined),\n examples: [],\n failure_hints: [],\n arguments: [],\n flags,\n });\n }\n\n return descriptors;\n}\n\nfunction buildExtensionArgumentToken(argument: ExtensionCommandArgumentHelpDescriptor): string {\n const variadicSuffix = argument.variadic ? \"...\" : \"\";\n if (argument.required) {\n return `<${argument.name}${variadicSuffix}>`;\n }\n return `[${argument.name}${variadicSuffix}]`;\n}\n\nexport function applyDynamicExtensionArguments(command: Command, descriptor: ExtensionCommandHelpDescriptor): void {\n for (const argument of descriptor.arguments) {\n command.argument(buildExtensionArgumentToken(argument), argument.description ?? \"Extension argument.\");\n }\n}\n\nfunction formatDynamicExtensionOptionFlags(definition: Record<string, unknown>): string | null {\n const visible = toOptionalBoolean(definition.visible);\n if (visible === false) {\n return null;\n }\n const longName = toNonEmptyFlagString(definition.long);\n const shortName = toNonEmptyFlagString(definition.short);\n const normalizedShort = shortName && shortName.startsWith(\"-\") && !shortName.startsWith(\"--\") ? shortName : null;\n const normalizedLong = longName && longName.startsWith(\"--\") && longName.length > 2 ? longName : null;\n if (!normalizedLong && !normalizedShort) {\n return null;\n }\n const optionValueName = toNonEmptyFlagString(definition.value_name);\n const optionValueSuffix = optionValueName ? ` <${optionValueName}>` : \"\";\n const optionNames = [normalizedShort, normalizedLong].filter((entry): entry is string => entry !== null);\n return `${optionNames.join(\", \")}${optionValueSuffix}`;\n}\n\nfunction formatDynamicExtensionOptionDescription(definition: Record<string, unknown>): string {\n const description = toNonEmptyFlagString(definition.description) ?? \"Extension-provided option.\";\n const markers: string[] = [];\n if (toOptionalBoolean(definition.required) === true) {\n markers.push(\"required\");\n }\n if (toOptionalBoolean(definition.enabled) === false) {\n markers.push(\"disabled\");\n }\n const markerSuffix = markers.length > 0 ? ` [${markers.join(\", \")}]` : \"\";\n return `${description}${markerSuffix}`;\n}\n\nexport function applyDynamicExtensionOptions(command: Command, descriptor: ExtensionCommandHelpDescriptor): void {\n const seen = new Set<string>();\n for (const definition of descriptor.flags) {\n const optionFlags = formatDynamicExtensionOptionFlags(definition);\n if (!optionFlags || seen.has(optionFlags)) {\n continue;\n }\n seen.add(optionFlags);\n command.option(optionFlags, formatDynamicExtensionOptionDescription(definition));\n }\n}\n\nfunction buildDynamicExtensionHelpOptionSummary(definition: Record<string, unknown>): HelpOptionSummary | null {\n const flags = formatDynamicExtensionOptionFlags(definition);\n if (!flags) {\n return null;\n }\n const longName = toNonEmptyFlagString(definition.long);\n const shortName = toNonEmptyFlagString(definition.short);\n const normalizedLong = longName && longName.startsWith(\"--\") && longName.length > 2 ? longName : null;\n const normalizedShort = shortName && shortName.startsWith(\"-\") && !shortName.startsWith(\"--\") ? shortName : null;\n const valueName = toNonEmptyFlagString(definition.value_name);\n const required = toOptionalBoolean(definition.required) === true;\n return {\n flags,\n long: normalizedLong,\n short: normalizedShort,\n description: formatDynamicExtensionOptionDescription(definition),\n takes_value: valueName !== null,\n value_required: valueName !== null,\n value_name: valueName,\n variadic: false,\n required,\n aliases: [],\n alias_for: null,\n };\n}\n\nexport function buildDynamicExtensionHelpOptionSummaries(descriptor: ExtensionCommandHelpDescriptor | undefined): HelpOptionSummary[] {\n if (!descriptor) {\n return [];\n }\n const summaries: HelpOptionSummary[] = [];\n const seen = new Set<string>();\n for (const definition of descriptor.flags) {\n const summary = buildDynamicExtensionHelpOptionSummary(definition);\n if (!summary || seen.has(summary.flags)) {\n continue;\n }\n seen.add(summary.flags);\n summaries.push(summary);\n }\n return summaries;\n}\n\nexport function mergeHelpOptionSummaries(base: HelpOptionSummary[], extension: HelpOptionSummary[]): HelpOptionSummary[] {\n if (extension.length === 0) {\n return base;\n }\n const merged = [...base];\n const seen = new Set(base.map((entry) => entry.flags));\n for (const entry of extension) {\n if (seen.has(entry.flags)) {\n continue;\n }\n seen.add(entry.flags);\n merged.push(entry);\n }\n return merged;\n}\n\nexport function buildDynamicExtensionCommandMetadataHelp(descriptor: ExtensionCommandHelpDescriptor): string | null {\n const lines: string[] = [];\n if (descriptor.intent) {\n lines.push(`Intent: ${descriptor.intent}`);\n }\n if (descriptor.action) {\n lines.push(`Action contract: ${descriptor.action}`);\n }\n if (descriptor.examples.length > 0) {\n lines.push(\"Examples:\");\n for (const example of descriptor.examples) {\n lines.push(` - ${example}`);\n }\n }\n if (descriptor.failure_hints.length > 0) {\n lines.push(\"Common failure hints:\");\n for (const hint of descriptor.failure_hints) {\n lines.push(` - ${hint}`);\n }\n }\n if (lines.length === 0) {\n return null;\n }\n return `\\nExtension command metadata:\\n ${lines.join(\"\\n \")}`;\n}\n\nexport function commandAliases(command: Command): string[] {\n const commandRecord = command as unknown as {\n aliases?: () => string[];\n alias?: () => string | undefined;\n _aliases?: string[];\n };\n if (typeof commandRecord.aliases === \"function\") {\n return commandRecord.aliases().map((value) => value.trim().toLowerCase()).filter((value) => value.length > 0);\n }\n if (typeof commandRecord.alias === \"function\") {\n const alias = commandRecord.alias();\n if (typeof alias === \"string\" && alias.trim().length > 0) {\n return [alias.trim().toLowerCase()];\n }\n }\n if (Array.isArray(commandRecord._aliases)) {\n return commandRecord._aliases.map((value) => value.trim().toLowerCase()).filter((value) => value.length > 0);\n }\n return [];\n}\n\nexport function findDirectChildCommand(parent: Command, name: string): Command | null {\n const normalizedTarget = name.trim().toLowerCase();\n return (\n parent.commands.find((entry) => {\n if (entry.name().trim().toLowerCase() === normalizedTarget) {\n return true;\n }\n return commandAliases(entry).includes(normalizedTarget);\n }) ?? null\n );\n}\n\nexport function findCommandByPath(root: Command, pathParts: string[]): Command | null {\n let current: Command = root;\n for (const part of pathParts) {\n const next = findDirectChildCommand(current, part);\n if (!next) {\n return null;\n }\n current = next;\n }\n return current;\n}\n\nexport function ensureCommandPath(root: Command, pathParts: string[]): Command | null {\n if (pathParts.length === 0) {\n return null;\n }\n\n let current: Command = root;\n for (let index = 0; index < pathParts.length; index += 1) {\n const part = pathParts[index];\n const existing = findDirectChildCommand(current, part);\n if (existing) {\n current = existing;\n continue;\n }\n\n const created = current.command(part);\n if (index < pathParts.length - 1) {\n created.description(\"Extension-provided command group.\");\n } else {\n created.description(\"Extension-provided command path.\");\n }\n current = created;\n }\n\n return current;\n}\n"]}