@unbrained/pm-cli 2026.10.13 → 2026.10.15

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 (708) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +72 -1
  3. package/dist/cli/after-command-context-usage.d.ts +7 -7
  4. package/dist/cli/argv-utils.d.ts +4 -4
  5. package/dist/cli/bundle-integrity.d.ts +16 -16
  6. package/dist/cli/command-namespaces.d.ts +1 -1
  7. package/dist/cli/commander-usage.d.ts +34 -34
  8. package/dist/cli/commands/governance/validate.d.ts +1 -1
  9. package/dist/cli/commands/history/history-compact.d.ts +1 -1
  10. package/dist/cli/commands/history/history-redact.d.ts +1 -1
  11. package/dist/cli/commands/history/history-repair.d.ts +1 -1
  12. package/dist/cli/commands/history/restore.d.ts +1 -1
  13. package/dist/cli/commands/lifecycle/close.d.ts +1 -1
  14. package/dist/cli/commands/lifecycle/copy.d.ts +1 -1
  15. package/dist/cli/commands/lifecycle/delete.d.ts +1 -1
  16. package/dist/cli/commands/lifecycle/focus.d.ts +1 -1
  17. package/dist/cli/commands/query/get.d.ts +1 -1
  18. package/dist/cli/commands/workspace/merge.d.ts +1 -1
  19. package/dist/cli/commands/workspace/schema.d.ts +1 -1
  20. package/dist/cli/context-intent-invocation.d.ts +1 -1
  21. package/dist/cli/description-stdin.d.ts +1 -1
  22. package/dist/cli/error-guidance.d.ts +119 -119
  23. package/dist/cli/extension-command-help.d.ts +64 -64
  24. package/dist/cli/extension-command-help.js +2 -2
  25. package/dist/cli/extension-command-options.d.ts +16 -16
  26. package/dist/cli/extension-command-options.js +1 -1
  27. package/dist/cli/extension-recovery.d.ts +13 -13
  28. package/dist/cli/help-content.d.ts +22 -22
  29. package/dist/cli/help-content.js +2 -2
  30. package/dist/cli/help-json-payload.d.ts +45 -45
  31. package/dist/cli/invocation-profile.d.ts +5 -5
  32. package/dist/cli/main.d.ts +217 -217
  33. package/dist/cli/main.js +2 -2
  34. package/dist/cli/migration-gates.d.ts +24 -24
  35. package/dist/cli/option-values.d.ts +1 -1
  36. package/dist/cli/public.d.ts +1 -1
  37. package/dist/cli/register-annotations.d.ts +2 -2
  38. package/dist/cli/register-assurance.d.ts +1 -1
  39. package/dist/cli/register-files-lookup.d.ts +1 -1
  40. package/dist/cli/register-history-activity.d.ts +1 -1
  41. package/dist/cli/register-history-author.d.ts +1 -1
  42. package/dist/cli/register-history-maintenance.d.ts +1 -1
  43. package/dist/cli/register-list-query.d.ts +7 -7
  44. package/dist/cli/register-list-query.js +3 -3
  45. package/dist/cli/register-mutation-options.d.ts +1 -1
  46. package/dist/cli/register-mutation.d.ts +4 -4
  47. package/dist/cli/register-operations.d.ts +75 -75
  48. package/dist/cli/register-setup.d.ts +4 -4
  49. package/dist/cli/register-structured-mutation.d.ts +8 -8
  50. package/dist/cli/runtime/activation.d.ts +23 -23
  51. package/dist/cli/runtime/invocation-options.d.ts +12 -12
  52. package/dist/cli/runtime/projection-retry.d.ts +1 -1
  53. package/dist/cli/runtime/selection.d.ts +16 -16
  54. package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
  55. package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
  56. package/dist/cli/schema/registration.d.ts +1 -1
  57. package/dist/cli/schema-registration-helpers.d.ts +2 -2
  58. package/dist/cli/stats-analytics-json.d.ts +1 -1
  59. package/dist/cli-bundle/bundle-manifest.json +1 -1
  60. package/dist/cli-bundle/chunks/{chunk-LBDWFWPK.js → chunk-52EZH2QQ.js} +2 -2
  61. package/dist/cli-bundle/chunks/chunk-7OEGNA4X.js +20 -0
  62. package/dist/cli-bundle/chunks/{chunk-APWPC4ZZ.js → chunk-7VHINXZP.js} +2 -2
  63. package/dist/cli-bundle/chunks/chunk-EMEEHV2Y.js +2 -0
  64. package/dist/cli-bundle/chunks/chunk-JGKTOBVB.js +6 -0
  65. package/dist/cli-bundle/chunks/{chunk-PSNS537F.js → chunk-JSUJWIHQ.js} +30 -30
  66. package/dist/cli-bundle/chunks/{chunk-N5EXRYCZ.js → chunk-LNKLQYBG.js} +2 -2
  67. package/dist/cli-bundle/chunks/{chunk-YH6H3UVE.js → chunk-N56CAQBU.js} +63 -64
  68. package/dist/cli-bundle/chunks/chunk-NC3QVGDD.js +8 -0
  69. package/dist/cli-bundle/chunks/{chunk-AM2XOZKE.js → chunk-RJ5N44WY.js} +2 -2
  70. package/dist/cli-bundle/chunks/{chunk-HXHFKXLV.js → chunk-VIMQCFCK.js} +2 -2
  71. package/dist/cli-bundle/chunks/{chunk-UBTYYZIE.js → chunk-WBBW3WQX.js} +4 -4
  72. package/dist/cli-bundle/chunks/chunk-X2H6UR26.js +236 -0
  73. package/dist/cli-bundle/chunks/{register-list-query-BJ742QOR.js → register-list-query-FKKFQ66D.js} +7 -7
  74. package/dist/cli-bundle/chunks/{register-mutation-GGGBRIH2.js → register-mutation-EWMMVZJB.js} +2 -2
  75. package/dist/cli-bundle/chunks/{register-operations-E6HXYHNM.js → register-operations-GEQ2H7PS.js} +2 -2
  76. package/dist/cli-bundle/chunks/{register-setup-4ZVTVEPY.js → register-setup-PSJTQBBO.js} +2 -2
  77. package/dist/cli-bundle/focused-chunks/{chunk-NNW5BS5L.js → chunk-3RNUMVK4.js} +2 -2
  78. package/dist/cli-bundle/focused-chunks/{chunk-3LQEBXU5.js → chunk-4KQFMOM7.js} +6 -6
  79. package/dist/cli-bundle/focused-chunks/{chunk-RAA7SVRA.js → chunk-52I2SNKJ.js} +2 -2
  80. package/dist/cli-bundle/focused-chunks/{chunk-6BTUISKV.js → chunk-5KRACGBK.js} +2 -2
  81. package/dist/cli-bundle/focused-chunks/chunk-5OO54BIV.js +3 -0
  82. package/dist/cli-bundle/focused-chunks/chunk-5TBAVZDR.js +20 -0
  83. package/dist/cli-bundle/focused-chunks/{chunk-R23T7GFZ.js → chunk-FQKPOZKS.js} +2 -2
  84. package/dist/cli-bundle/focused-chunks/{chunk-IIKFTJVC.js → chunk-H3P77KVU.js} +2 -2
  85. package/dist/cli-bundle/focused-chunks/chunk-HTA3TNC3.js +26 -0
  86. package/dist/cli-bundle/focused-chunks/{chunk-73UNAJHD.js → chunk-JKBH7YGX.js} +2 -2
  87. package/dist/cli-bundle/focused-chunks/{chunk-KGFRQ34R.js → chunk-KIIFVULU.js} +2 -2
  88. package/dist/cli-bundle/focused-chunks/{chunk-SOB7X4FJ.js → chunk-N6FUKTZS.js} +2 -2
  89. package/dist/cli-bundle/focused-chunks/chunk-PDYE7QDX.js +166 -0
  90. package/dist/cli-bundle/focused-chunks/{chunk-RU6GCFN3.js → chunk-Q4VNCTR2.js} +2 -2
  91. package/dist/cli-bundle/focused-chunks/{chunk-QMNAY25P.js → chunk-THYQR3ON.js} +61 -62
  92. package/dist/cli-bundle/focused-chunks/{chunk-DVK7VKZL.js → chunk-TYLG5VEB.js} +2 -2
  93. package/dist/cli-bundle/main.js +27 -27
  94. package/dist/cli-bundle/sdk-authoring.js +1 -1
  95. package/dist/cli-bundle/sdk-contracts.js +2 -2
  96. package/dist/cli-bundle/sdk-core.js +23 -23
  97. package/dist/cli-bundle/sdk-governance.js +1 -1
  98. package/dist/cli-bundle/sdk-graph.js +1 -1
  99. package/dist/cli-bundle/sdk-merge.js +51 -51
  100. package/dist/cli-bundle/sdk-query.js +1 -1
  101. package/dist/cli-bundle/sdk-runtime.js +1 -1
  102. package/dist/cli-bundle/sdk-testing.js +1 -1
  103. package/dist/cli-bundle/sdk.js +7 -7
  104. package/dist/cli.d.ts +9 -9
  105. package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
  106. package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
  107. package/dist/core/config/nested-settings.d.ts +20 -20
  108. package/dist/core/config/positional-value.d.ts +9 -9
  109. package/dist/core/diagnostics/remediation.d.ts +7 -7
  110. package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
  111. package/dist/core/extensions/activation-summary.d.ts +30 -30
  112. package/dist/core/extensions/activation-transaction.d.ts +9 -9
  113. package/dist/core/extensions/capability-usage.d.ts +25 -25
  114. package/dist/core/extensions/command-hook-context.d.ts +15 -15
  115. package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
  116. package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
  117. package/dist/core/extensions/contribution-inventory.d.ts +24 -24
  118. package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
  119. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  120. package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
  121. package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
  122. package/dist/core/extensions/extension-policy.d.ts +62 -62
  123. package/dist/core/extensions/extension-registries.d.ts +8 -8
  124. package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
  125. package/dist/core/extensions/extension-types.d.ts +702 -702
  126. package/dist/core/extensions/flag-definition-validation.d.ts +19 -6
  127. package/dist/core/extensions/flag-definition-validation.js +1 -1
  128. package/dist/core/extensions/flag-value-types.d.ts +16 -4
  129. package/dist/core/extensions/flag-value-types.js +1 -1
  130. package/dist/core/extensions/index.d.ts +34 -34
  131. package/dist/core/extensions/item-field-types.d.ts +3 -3
  132. package/dist/core/extensions/item-fields.d.ts +6 -6
  133. package/dist/core/extensions/loader.d.ts +66 -66
  134. package/dist/core/extensions/manifest-parser.d.ts +1 -1
  135. package/dist/core/extensions/manifest-schema.d.ts +13 -13
  136. package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
  137. package/dist/core/extensions/preflight-ownership.d.ts +3 -3
  138. package/dist/core/extensions/read-output-contract.d.ts +2 -2
  139. package/dist/core/extensions/registration-contracts.d.ts +12 -12
  140. package/dist/core/extensions/registration-validation.d.ts +6 -6
  141. package/dist/core/extensions/registration-values.d.ts +19 -19
  142. package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
  143. package/dist/core/extensions/runtime-registrations.d.ts +6 -6
  144. package/dist/core/extensions/service-ownership.d.ts +1 -1
  145. package/dist/core/extensions/version-compat.d.ts +9 -9
  146. package/dist/core/fs/atomic-create.d.ts +1 -1
  147. package/dist/core/fs/fs-utils.d.ts +12 -12
  148. package/dist/core/fs/host-environment-errors.d.ts +10 -10
  149. package/dist/core/fs/path-utils.d.ts +1 -1
  150. package/dist/core/governance/content-fields.d.ts +25 -25
  151. package/dist/core/governance/issue-codes.d.ts +16 -16
  152. package/dist/core/governance/metadata-coverage.d.ts +64 -64
  153. package/dist/core/history/digest.d.ts +5 -5
  154. package/dist/core/history/drift-cache.d.ts +2 -2
  155. package/dist/core/history/drift-scan.d.ts +18 -18
  156. package/dist/core/history/event-classification.d.ts +4 -4
  157. package/dist/core/history/event-index.d.ts +33 -33
  158. package/dist/core/history/history-compact-bulk.d.ts +12 -12
  159. package/dist/core/history/history-diff.d.ts +15 -15
  160. package/dist/core/history/history-rewrite.d.ts +43 -43
  161. package/dist/core/history/history-storage-stats.d.ts +20 -20
  162. package/dist/core/history/history-stream-policy.d.ts +12 -12
  163. package/dist/core/history/history.d.ts +45 -45
  164. package/dist/core/history/identity.d.ts +4 -4
  165. package/dist/core/history/operation-contract.d.ts +17 -17
  166. package/dist/core/history/projection.d.ts +16 -16
  167. package/dist/core/history/read.d.ts +4 -4
  168. package/dist/core/history/replay.d.ts +47 -47
  169. package/dist/core/history/tombstone.d.ts +1 -1
  170. package/dist/core/history/version-address.d.ts +2 -2
  171. package/dist/core/history/workspace-history.d.ts +72 -72
  172. package/dist/core/io/body-file.d.ts +2 -2
  173. package/dist/core/io/bulk-ids-input.d.ts +7 -7
  174. package/dist/core/item/actionability.d.ts +30 -30
  175. package/dist/core/item/dependency-reference.d.ts +2 -2
  176. package/dist/core/item/id.d.ts +9 -9
  177. package/dist/core/item/item-format-version.d.ts +17 -15
  178. package/dist/core/item/item-format-version.js +1 -1
  179. package/dist/core/item/item-format.d.ts +54 -54
  180. package/dist/core/item/item-record.d.ts +1 -1
  181. package/dist/core/item/item-type-definition.d.ts +11 -11
  182. package/dist/core/item/parent-reference-policy.d.ts +6 -6
  183. package/dist/core/item/parse.d.ts +37 -37
  184. package/dist/core/item/plan-lifecycle.d.ts +4 -4
  185. package/dist/core/item/priority.d.ts +3 -3
  186. package/dist/core/item/sprint-release-format.d.ts +4 -4
  187. package/dist/core/item/status-filter.d.ts +5 -5
  188. package/dist/core/item/status.d.ts +3 -3
  189. package/dist/core/item/toon-decode.d.ts +10 -10
  190. package/dist/core/item/type-registry.d.ts +35 -35
  191. package/dist/core/item/type-synonyms.d.ts +2 -2
  192. package/dist/core/lock/lock-gc.d.ts +28 -28
  193. package/dist/core/lock/lock.d.ts +53 -53
  194. package/dist/core/output/mutation-projection.d.ts +4 -4
  195. package/dist/core/output/output-control.d.ts +4 -4
  196. package/dist/core/output/output.d.ts +30 -30
  197. package/dist/core/output/query-summary.d.ts +5 -5
  198. package/dist/core/output/tabular.d.ts +3 -3
  199. package/dist/core/packages/manifest.d.ts +30 -30
  200. package/dist/core/packages/root.d.ts +4 -4
  201. package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
  202. package/dist/core/policy/workflow-policy-store.d.ts +15 -15
  203. package/dist/core/policy/workflow-policy.d.ts +56 -56
  204. package/dist/core/profile/profile-describe.d.ts +22 -22
  205. package/dist/core/profile/profile-lint.d.ts +13 -13
  206. package/dist/core/profile/profile-plan.d.ts +45 -45
  207. package/dist/core/profile/profile-presets.d.ts +36 -36
  208. package/dist/core/reproducibility/context.d.ts +9 -9
  209. package/dist/core/schema/fields-file.d.ts +35 -35
  210. package/dist/core/schema/item-types-file.d.ts +29 -29
  211. package/dist/core/schema/runtime-field-filters.d.ts +3 -3
  212. package/dist/core/schema/runtime-field-values.d.ts +7 -7
  213. package/dist/core/schema/runtime-schema.d.ts +59 -59
  214. package/dist/core/schema/status-defs-file.d.ts +29 -29
  215. package/dist/core/schema/status-token.d.ts +1 -1
  216. package/dist/core/schema/type-inference.d.ts +10 -10
  217. package/dist/core/schema/type-presets.d.ts +5 -5
  218. package/dist/core/schema/type-workflows.d.ts +14 -14
  219. package/dist/core/search/background-refresh.d.ts +12 -12
  220. package/dist/core/search/bm25.d.ts +16 -16
  221. package/dist/core/search/cache.d.ts +34 -34
  222. package/dist/core/search/corpus.d.ts +17 -17
  223. package/dist/core/search/embedding-batches.d.ts +25 -25
  224. package/dist/core/search/eval-thresholds.d.ts +4 -4
  225. package/dist/core/search/eval.d.ts +40 -40
  226. package/dist/core/search/http-client.d.ts +24 -24
  227. package/dist/core/search/providers.d.ts +30 -30
  228. package/dist/core/search/relevance.d.ts +17 -17
  229. package/dist/core/search/semantic-defaults.d.ts +5 -5
  230. package/dist/core/search/staleness.d.ts +3 -3
  231. package/dist/core/search/vector-stores.d.ts +51 -51
  232. package/dist/core/search/vectorization-metadata.d.ts +9 -9
  233. package/dist/core/sentry/helpers.d.ts +28 -26
  234. package/dist/core/sentry/helpers.js +1 -1
  235. package/dist/core/sentry/instrument.d.ts +52 -50
  236. package/dist/core/sentry/instrument.js +1 -1
  237. package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
  238. package/dist/core/sentry/sensitive-assignments.js +2 -0
  239. package/dist/core/session/session-state.d.ts +37 -37
  240. package/dist/core/shared/agent-session-context.d.ts +14 -14
  241. package/dist/core/shared/author.d.ts +89 -89
  242. package/dist/core/shared/command-line.d.ts +3 -3
  243. package/dist/core/shared/command-types.d.ts +20 -20
  244. package/dist/core/shared/conflict-markers.d.ts +5 -5
  245. package/dist/core/shared/constants.d.ts +30 -30
  246. package/dist/core/shared/errors.d.ts +100 -100
  247. package/dist/core/shared/html-entity-decode.d.ts +2 -2
  248. package/dist/core/shared/item-metadata-contract.d.ts +2 -2
  249. package/dist/core/shared/lazy-module.d.ts +1 -1
  250. package/dist/core/shared/levenshtein.d.ts +1 -1
  251. package/dist/core/shared/memo.d.ts +1 -1
  252. package/dist/core/shared/numeric-parsers.d.ts +1 -1
  253. package/dist/core/shared/option-alias-visibility.d.ts +3 -3
  254. package/dist/core/shared/primitives.d.ts +13 -13
  255. package/dist/core/shared/secret-rules.d.ts +92 -92
  256. package/dist/core/shared/serial-queue.d.ts +6 -6
  257. package/dist/core/shared/serialization.d.ts +4 -4
  258. package/dist/core/shared/split-comma-list.d.ts +4 -4
  259. package/dist/core/shared/text-normalization.d.ts +3 -3
  260. package/dist/core/shared/time.d.ts +27 -27
  261. package/dist/core/store/item-format-migration.d.ts +7 -7
  262. package/dist/core/store/item-metadata-cache.d.ts +30 -30
  263. package/dist/core/store/item-metadata-query-index.d.ts +66 -66
  264. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  265. package/dist/core/store/item-store.d.ts +123 -123
  266. package/dist/core/store/item-store.js +1 -1
  267. package/dist/core/store/paths.d.ts +27 -27
  268. package/dist/core/store/settings-concurrency.d.ts +1 -1
  269. package/dist/core/store/settings-read-cache.d.ts +11 -11
  270. package/dist/core/store/settings-validator.d.ts +117 -117
  271. package/dist/core/store/settings.d.ts +84 -84
  272. package/dist/core/store/sqlite-runtime.d.ts +2 -2
  273. package/dist/core/store/tracker-preflight.d.ts +3 -3
  274. package/dist/core/telemetry/consent.d.ts +1 -1
  275. package/dist/core/telemetry/observability.d.ts +16 -16
  276. package/dist/core/telemetry/policy.d.ts +7 -7
  277. package/dist/core/telemetry/read-sampling.d.ts +1 -1
  278. package/dist/core/telemetry/runtime.d.ts +275 -275
  279. package/dist/core/telemetry/runtime.js +2 -2
  280. package/dist/core/test/background-runs.d.ts +123 -123
  281. package/dist/core/test/item-test-run-tracking.d.ts +10 -10
  282. package/dist/core/test/run-selectors.d.ts +12 -12
  283. package/dist/core/validate/estimate-defaults.d.ts +3 -3
  284. package/dist/core/validate/fix-planning.d.ts +36 -36
  285. package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
  286. package/dist/core/validate/missing-by-type.d.ts +3 -3
  287. package/dist/core/validate/missing-link-owners.d.ts +17 -17
  288. package/dist/core/validate/stale-file-classification.d.ts +6 -6
  289. package/dist/mcp/http-server.d.ts +26 -26
  290. package/dist/mcp/legacy-adapter.d.ts +18 -18
  291. package/dist/mcp/runtime-capabilities.d.ts +18 -18
  292. package/dist/mcp/server.d.ts +73 -73
  293. package/dist/mcp/tool-definitions.d.ts +27 -27
  294. package/dist/sdk/actionability.d.ts +1 -1
  295. package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
  296. package/dist/sdk/agent/command-recovery.d.ts +5 -5
  297. package/dist/sdk/agent/command-suggestions.d.ts +4 -4
  298. package/dist/sdk/agent/create-option-policy.d.ts +2 -2
  299. package/dist/sdk/agent/identity-config.d.ts +18 -18
  300. package/dist/sdk/agent/item-addressing.d.ts +6 -6
  301. package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
  302. package/dist/sdk/agent/refusal-closure.d.ts +22 -22
  303. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
  304. package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
  305. package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
  306. package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
  307. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
  308. package/dist/sdk/agent-capability-contracts.d.ts +41 -41
  309. package/dist/sdk/agent-session-context.d.ts +1 -1
  310. package/dist/sdk/annotations.d.ts +74 -74
  311. package/dist/sdk/author-attribution.d.ts +47 -47
  312. package/dist/sdk/authoring.d.ts +9 -9
  313. package/dist/sdk/cli-bootstrap.d.ts +65 -65
  314. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
  315. package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
  316. package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
  317. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
  318. package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
  319. package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
  320. package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
  321. package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
  322. package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
  323. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  324. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
  325. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
  326. package/dist/sdk/cli-contracts/registration-helpers.d.ts +56 -56
  327. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
  328. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  329. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
  330. package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
  331. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
  332. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
  333. package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
  334. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
  335. package/dist/sdk/cli-contracts.d.ts +15 -15
  336. package/dist/sdk/cli-program.d.ts +1 -1
  337. package/dist/sdk/cli-program.js +1 -1
  338. package/dist/sdk/command-line.d.ts +3 -3
  339. package/dist/sdk/comments.d.ts +24 -24
  340. package/dist/sdk/compile-cache.d.ts +4 -4
  341. package/dist/sdk/completion/bash.d.ts +1 -1
  342. package/dist/sdk/completion/fish.d.ts +1 -1
  343. package/dist/sdk/completion/shared.d.ts +74 -74
  344. package/dist/sdk/completion/zsh.d.ts +1 -1
  345. package/dist/sdk/completion.d.ts +3 -3
  346. package/dist/sdk/compose.d.ts +94 -94
  347. package/dist/sdk/config.d.ts +105 -105
  348. package/dist/sdk/context/recency.d.ts +1 -1
  349. package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
  350. package/dist/sdk/context/usage-egress.d.ts +1 -1
  351. package/dist/sdk/context/usage-ledger.d.ts +18 -18
  352. package/dist/sdk/context-intent-contracts.d.ts +37 -37
  353. package/dist/sdk/context-intent-runtime.d.ts +10 -10
  354. package/dist/sdk/context-packing.d.ts +44 -44
  355. package/dist/sdk/context-relevance.d.ts +110 -110
  356. package/dist/sdk/context-signal-store.d.ts +52 -52
  357. package/dist/sdk/context-usage.d.ts +78 -78
  358. package/dist/sdk/contracts.d.ts +2 -1
  359. package/dist/sdk/contracts.js +1 -1
  360. package/dist/sdk/core-governance.d.ts +5 -5
  361. package/dist/sdk/core.d.ts +8 -8
  362. package/dist/sdk/corpus-shape.d.ts +60 -60
  363. package/dist/sdk/define.d.ts +36 -36
  364. package/dist/sdk/dependencies.d.ts +70 -70
  365. package/dist/sdk/dependency-flag-validation.d.ts +17 -17
  366. package/dist/sdk/dependency-provenance.d.ts +22 -22
  367. package/dist/sdk/docs.d.ts +17 -17
  368. package/dist/sdk/duplicates.d.ts +14 -14
  369. package/dist/sdk/environment/agent-environment.d.ts +118 -118
  370. package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
  371. package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
  372. package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
  373. package/dist/sdk/environment/source-context.d.ts +4 -4
  374. package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
  375. package/dist/sdk/error-code-catalog.d.ts +33 -33
  376. package/dist/sdk/error-runtime.d.ts +5 -5
  377. package/dist/sdk/errors.d.ts +17 -17
  378. package/dist/sdk/eval.d.ts +27 -27
  379. package/dist/sdk/extension/author-manifest.d.ts +9 -9
  380. package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
  381. package/dist/sdk/extension/concurrency.d.ts +1 -1
  382. package/dist/sdk/extension/copy-scope.d.ts +1 -1
  383. package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
  384. package/dist/sdk/extension/describe.d.ts +21 -21
  385. package/dist/sdk/extension/doctor.d.ts +46 -46
  386. package/dist/sdk/extension/install-plan.d.ts +32 -32
  387. package/dist/sdk/extension/install-receipts.d.ts +4 -4
  388. package/dist/sdk/extension/install-runtime.d.ts +12 -12
  389. package/dist/sdk/extension/install-snapshot.d.ts +10 -10
  390. package/dist/sdk/extension/install-sources.d.ts +106 -106
  391. package/dist/sdk/extension/managed-state.d.ts +42 -42
  392. package/dist/sdk/extension/managed-update-status.d.ts +1 -1
  393. package/dist/sdk/extension/migrations.d.ts +48 -48
  394. package/dist/sdk/extension/output-ownership.d.ts +19 -19
  395. package/dist/sdk/extension/runtime-summary.d.ts +7 -7
  396. package/dist/sdk/extension/scaffold.d.ts +15 -15
  397. package/dist/sdk/extension/shared.d.ts +16 -16
  398. package/dist/sdk/extension/source-resolution.d.ts +16 -16
  399. package/dist/sdk/extension/static-inventory.d.ts +23 -23
  400. package/dist/sdk/extension/update-check.d.ts +9 -9
  401. package/dist/sdk/extension-command-context.d.ts +1 -1
  402. package/dist/sdk/extension-contracts.d.ts +10 -10
  403. package/dist/sdk/extension.d.ts +221 -221
  404. package/dist/sdk/files.d.ts +101 -101
  405. package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
  406. package/dist/sdk/flag-invocation-contracts.js +1 -1
  407. package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
  408. package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
  409. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  410. package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
  411. package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
  412. package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
  413. package/dist/sdk/governance/assurance-action.d.ts +46 -46
  414. package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
  415. package/dist/sdk/governance/assurance-presets.d.ts +25 -25
  416. package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
  417. package/dist/sdk/governance/assurance.d.ts +204 -204
  418. package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
  419. package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
  420. package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
  421. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
  422. package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
  423. package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
  424. package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
  425. package/dist/sdk/governance/defect-recurrence.js +2 -1
  426. package/dist/sdk/governance/extension-host-version.d.ts +9 -9
  427. package/dist/sdk/governance/gc.d.ts +26 -26
  428. package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
  429. package/dist/sdk/governance/health.d.ts +172 -172
  430. package/dist/sdk/governance/health.js +1 -1
  431. package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
  432. package/dist/sdk/governance/linked-file-report.d.ts +15 -15
  433. package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
  434. package/dist/sdk/governance/provenance-health.d.ts +35 -35
  435. package/dist/sdk/governance/reindex.d.ts +102 -102
  436. package/dist/sdk/governance/reliability.d.ts +29 -29
  437. package/dist/sdk/governance/stale-work.d.ts +13 -13
  438. package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
  439. package/dist/sdk/governance/storage-integrity.d.ts +28 -28
  440. package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
  441. package/dist/sdk/governance/upgrade.d.ts +77 -77
  442. package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
  443. package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
  444. package/dist/sdk/governance/validate-normalization.d.ts +4 -4
  445. package/dist/sdk/governance/validate.d.ts +176 -176
  446. package/dist/sdk/governance/validate.js +1 -1
  447. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  448. package/dist/sdk/governance/workflow-policy.d.ts +18 -18
  449. package/dist/sdk/governance/workspace-position.d.ts +40 -40
  450. package/dist/sdk/governance.d.ts +2 -2
  451. package/dist/sdk/graph/adapter.d.ts +45 -45
  452. package/dist/sdk/graph/analytics.d.ts +36 -36
  453. package/dist/sdk/graph/assembly.d.ts +51 -51
  454. package/dist/sdk/graph/cache.d.ts +19 -19
  455. package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
  456. package/dist/sdk/graph/centrality.d.ts +20 -20
  457. package/dist/sdk/graph/conformance.d.ts +21 -21
  458. package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
  459. package/dist/sdk/graph/durable-cache.d.ts +22 -22
  460. package/dist/sdk/graph/governance-contracts.d.ts +1 -1
  461. package/dist/sdk/graph/governance.d.ts +92 -92
  462. package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
  463. package/dist/sdk/graph/index.d.ts +15 -15
  464. package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
  465. package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
  466. package/dist/sdk/graph/query-contracts.d.ts +6 -6
  467. package/dist/sdk/graph/remediation.d.ts +15 -15
  468. package/dist/sdk/graph/run.d.ts +203 -203
  469. package/dist/sdk/graph/scheduling.d.ts +21 -21
  470. package/dist/sdk/graph/traversal.d.ts +18 -18
  471. package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
  472. package/dist/sdk/guide-topics.d.ts +19 -19
  473. package/dist/sdk/guide.d.ts +43 -43
  474. package/dist/sdk/history/attestation-command.d.ts +8 -8
  475. package/dist/sdk/history/attestation-contract.d.ts +43 -43
  476. package/dist/sdk/history/attestation-scan.d.ts +4 -4
  477. package/dist/sdk/history/attestation.d.ts +4 -4
  478. package/dist/sdk/history/maintenance.d.ts +25 -25
  479. package/dist/sdk/history/salvage.d.ts +19 -19
  480. package/dist/sdk/history/subject.d.ts +8 -8
  481. package/dist/sdk/history-analytics.d.ts +64 -64
  482. package/dist/sdk/history-compact.d.ts +67 -67
  483. package/dist/sdk/history-mcp.d.ts +7 -7
  484. package/dist/sdk/history-provenance.d.ts +40 -40
  485. package/dist/sdk/history-read.d.ts +24 -24
  486. package/dist/sdk/history-redact.d.ts +68 -68
  487. package/dist/sdk/history-repair.d.ts +92 -92
  488. package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
  489. package/dist/sdk/improvement-ledger.d.ts +62 -62
  490. package/dist/sdk/index.d.ts +69 -69
  491. package/dist/sdk/init-agent-guidance.d.ts +68 -68
  492. package/dist/sdk/init.d.ts +117 -117
  493. package/dist/sdk/invocation-author.d.ts +1 -1
  494. package/dist/sdk/item-children.d.ts +15 -15
  495. package/dist/sdk/item-metadata-index.d.ts +2 -2
  496. package/dist/sdk/item-schedule.d.ts +9 -9
  497. package/dist/sdk/item-transaction.d.ts +73 -73
  498. package/dist/sdk/learnings.d.ts +23 -23
  499. package/dist/sdk/lifecycle/append.d.ts +8 -8
  500. package/dist/sdk/lifecycle/claim.d.ts +38 -38
  501. package/dist/sdk/lifecycle/close-many.d.ts +71 -71
  502. package/dist/sdk/lifecycle/close.d.ts +18 -18
  503. package/dist/sdk/lifecycle/copy.d.ts +10 -10
  504. package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
  505. package/dist/sdk/lifecycle/create.d.ts +88 -88
  506. package/dist/sdk/lifecycle/delete.d.ts +15 -15
  507. package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
  508. package/dist/sdk/lifecycle/focus.d.ts +6 -6
  509. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
  510. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
  511. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
  512. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  513. package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
  514. package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
  515. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
  516. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
  517. package/dist/sdk/lifecycle/plan.d.ts +127 -127
  518. package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
  519. package/dist/sdk/lifecycle/reopen.d.ts +15 -15
  520. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
  521. package/dist/sdk/lifecycle/restore.d.ts +34 -34
  522. package/dist/sdk/lifecycle/restore.js +1 -1
  523. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
  524. package/dist/sdk/lifecycle/task-composition.d.ts +7 -7
  525. package/dist/sdk/lifecycle/update-many.d.ts +61 -61
  526. package/dist/sdk/lifecycle/update.d.ts +120 -120
  527. package/dist/sdk/lifecycle-completion.d.ts +14 -14
  528. package/dist/sdk/lifecycle-policy.d.ts +31 -31
  529. package/dist/sdk/linked-artifacts.d.ts +58 -58
  530. package/dist/sdk/mcp/apps.d.ts +28 -28
  531. package/dist/sdk/mcp/authorization.d.ts +66 -66
  532. package/dist/sdk/mcp/discovery.d.ts +67 -67
  533. package/dist/sdk/mcp/interactions.d.ts +49 -49
  534. package/dist/sdk/mcp/protocol.d.ts +63 -63
  535. package/dist/sdk/mcp/skills.d.ts +62 -62
  536. package/dist/sdk/mcp/subscriptions.d.ts +26 -26
  537. package/dist/sdk/mcp/tasks.d.ts +51 -51
  538. package/dist/sdk/mcp/transport.d.ts +17 -17
  539. package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
  540. package/dist/sdk/merge/driver.d.ts +38 -38
  541. package/dist/sdk/merge/index.d.ts +5 -5
  542. package/dist/sdk/merge/install.d.ts +48 -48
  543. package/dist/sdk/merge/install.js +1 -1
  544. package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
  545. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  546. package/dist/sdk/merge/receipt-schema.d.ts +11 -11
  547. package/dist/sdk/merge/receipts.d.ts +111 -111
  548. package/dist/sdk/merge/reconcile.d.ts +20 -20
  549. package/dist/sdk/merge/three-way.d.ts +50 -50
  550. package/dist/sdk/merge/three-way.js +2 -2
  551. package/dist/sdk/merge/worktree-config.d.ts +3 -3
  552. package/dist/sdk/mutation-events.d.ts +62 -62
  553. package/dist/sdk/mutation-guard.d.ts +134 -134
  554. package/dist/sdk/notes.d.ts +28 -28
  555. package/dist/sdk/output/table-rows.d.ts +6 -6
  556. package/dist/sdk/output-contracts.d.ts +26 -26
  557. package/dist/sdk/output-projection.d.ts +108 -108
  558. package/dist/sdk/output-token-accounting.d.ts +18 -18
  559. package/dist/sdk/output.d.ts +18 -18
  560. package/dist/sdk/ownership-source.d.ts +1 -1
  561. package/dist/sdk/package-import-adapters.d.ts +51 -51
  562. package/dist/sdk/package-migrations.d.ts +3 -3
  563. package/dist/sdk/package-runtime-options.d.ts +3 -3
  564. package/dist/sdk/pagination.d.ts +28 -28
  565. package/dist/sdk/pagination.js +1 -1
  566. package/dist/sdk/profile.d.ts +72 -72
  567. package/dist/sdk/provenance.d.ts +37 -37
  568. package/dist/sdk/public-surface.json +1 -1
  569. package/dist/sdk/query/activity.d.ts +84 -84
  570. package/dist/sdk/query/aggregate.d.ts +109 -109
  571. package/dist/sdk/query/calendar.d.ts +95 -95
  572. package/dist/sdk/query/complete-list.d.ts +35 -35
  573. package/dist/sdk/query/context.d.ts +300 -300
  574. package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
  575. package/dist/sdk/query/get.d.ts +54 -54
  576. package/dist/sdk/query/history.d.ts +38 -38
  577. package/dist/sdk/query/item-filter-options.d.ts +41 -41
  578. package/dist/sdk/query/light-metadata.d.ts +1 -1
  579. package/dist/sdk/query/list-filter-shared.d.ts +4 -4
  580. package/dist/sdk/query/list.d.ts +167 -167
  581. package/dist/sdk/query/list.js +1 -1
  582. package/dist/sdk/query/multi-value-filters.d.ts +6 -6
  583. package/dist/sdk/query/next-ready-budget.d.ts +8 -8
  584. package/dist/sdk/query/next.d.ts +94 -94
  585. package/dist/sdk/query/parsers.d.ts +3 -3
  586. package/dist/sdk/query/projection-contracts.d.ts +18 -18
  587. package/dist/sdk/query/search/corpus.d.ts +15 -15
  588. package/dist/sdk/query/search/filters.d.ts +15 -15
  589. package/dist/sdk/query/search/input.d.ts +8 -8
  590. package/dist/sdk/query/search/lexical.d.ts +10 -10
  591. package/dist/sdk/query/search/response.d.ts +22 -22
  592. package/dist/sdk/query/search/semantic.d.ts +133 -133
  593. package/dist/sdk/query/search/types.d.ts +65 -65
  594. package/dist/sdk/query/search-contracts.d.ts +53 -53
  595. package/dist/sdk/query/search-pagination.d.ts +21 -21
  596. package/dist/sdk/query/search-rendering.d.ts +30 -30
  597. package/dist/sdk/query/search.d.ts +60 -60
  598. package/dist/sdk/query/workspace-contracts.d.ts +2 -2
  599. package/dist/sdk/query.d.ts +6 -6
  600. package/dist/sdk/read-output/continuation.d.ts +11 -11
  601. package/dist/sdk/read-output/extension.d.ts +3 -3
  602. package/dist/sdk/read-output/options.d.ts +7 -7
  603. package/dist/sdk/read-output/provenance.d.ts +6 -6
  604. package/dist/sdk/read-output-budget.d.ts +11 -11
  605. package/dist/sdk/read-output-contracts.d.ts +112 -112
  606. package/dist/sdk/read-output-contracts.js +1 -1
  607. package/dist/sdk/read-output-rows.d.ts +15 -15
  608. package/dist/sdk/read-output-session.d.ts +29 -29
  609. package/dist/sdk/relationship-analytics.d.ts +46 -46
  610. package/dist/sdk/relationship-context.d.ts +48 -48
  611. package/dist/sdk/relationship-history.d.ts +59 -59
  612. package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
  613. package/dist/sdk/relationship-migration.d.ts +14 -14
  614. package/dist/sdk/relationships.d.ts +46 -46
  615. package/dist/sdk/reproducibility/process.d.ts +9 -9
  616. package/dist/sdk/runtime/actions.d.ts +1 -1
  617. package/dist/sdk/runtime/context.d.ts +15 -15
  618. package/dist/sdk/runtime/schema-preview.d.ts +1 -1
  619. package/dist/sdk/runtime/schema.d.ts +1 -1
  620. package/dist/sdk/runtime-action-aliases.d.ts +3 -3
  621. package/dist/sdk/runtime-extended-actions.d.ts +9 -9
  622. package/dist/sdk/runtime-input.d.ts +29 -29
  623. package/dist/sdk/runtime-primitives.d.ts +54 -52
  624. package/dist/sdk/runtime-primitives.js +1 -1
  625. package/dist/sdk/runtime-public-contracts.d.ts +46 -46
  626. package/dist/sdk/runtime-stats-options.d.ts +1 -1
  627. package/dist/sdk/runtime.d.ts +374 -374
  628. package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
  629. package/dist/sdk/schema-migration.d.ts +79 -79
  630. package/dist/sdk/schema.d.ts +224 -224
  631. package/dist/sdk/search-refresh-worker.d.ts +1 -1
  632. package/dist/sdk/similarity-scoring.d.ts +10 -10
  633. package/dist/sdk/similarity.d.ts +73 -73
  634. package/dist/sdk/start-task-status.d.ts +1 -1
  635. package/dist/sdk/stats.d.ts +72 -72
  636. package/dist/sdk/structured-mutations.d.ts +13 -13
  637. package/dist/sdk/telemetry-flush.d.ts +1 -1
  638. package/dist/sdk/telemetry.d.ts +32 -32
  639. package/dist/sdk/templates.d.ts +35 -35
  640. package/dist/sdk/test/batch.d.ts +50 -50
  641. package/dist/sdk/test/command-args.d.ts +2 -2
  642. package/dist/sdk/test/entry.d.ts +4 -4
  643. package/dist/sdk/test/execution-receipts.d.ts +5 -5
  644. package/dist/sdk/test/execution.d.ts +247 -247
  645. package/dist/sdk/test/json-path.d.ts +4 -4
  646. package/dist/sdk/test/linked-command-detection.d.ts +36 -36
  647. package/dist/sdk/test/measurements.d.ts +10 -10
  648. package/dist/sdk/test/parsers.d.ts +18 -18
  649. package/dist/sdk/test/prerequisites.d.ts +3 -3
  650. package/dist/sdk/test/runs.d.ts +43 -43
  651. package/dist/sdk/test/trust.d.ts +15 -15
  652. package/dist/sdk/test/update.d.ts +23 -23
  653. package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
  654. package/dist/sdk/testing.d.ts +250 -246
  655. package/dist/sdk/testing.js +2 -2
  656. package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
  657. package/dist/sdk/traceability/source-traceability.d.ts +50 -50
  658. package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
  659. package/dist/sdk/workspace-contracts.d.ts +20 -20
  660. package/dist/sdk/workspace-memory.d.ts +42 -42
  661. package/dist/sdk/workspace-recipe.d.ts +9 -9
  662. package/dist/sdk/workspace-snapshot.d.ts +60 -60
  663. package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
  664. package/dist/sdk/workspace-transaction.d.ts +26 -26
  665. package/dist/sdk/workspace.d.ts +9 -9
  666. package/dist/types.d.ts +540 -540
  667. package/docs/COMMANDS.md +11 -2
  668. package/docs/CONFIGURATION.md +43 -0
  669. package/docs/DEFECT_RECURRENCE.md +8 -0
  670. package/docs/EXTENSIONS.md +1 -1
  671. package/docs/EXTENSION_AUTHOR_CONTRACTS.md +33 -0
  672. package/docs/LINKED_TEST_EDITS.md +15 -0
  673. package/docs/MERGE_SAFETY.md +8 -0
  674. package/docs/RELEASING.md +2 -0
  675. package/docs/SDK.md +19 -0
  676. package/docs/TESTING.md +21 -1
  677. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +4 -3
  678. package/marketplace.json +1 -1
  679. package/package.json +3 -1
  680. package/packages/pm-beads/package.json +1 -1
  681. package/packages/pm-calendar/package.json +1 -1
  682. package/packages/pm-command-kit/package.json +1 -1
  683. package/packages/pm-digital-twin/package.json +1 -1
  684. package/packages/pm-governance-audit/package.json +1 -1
  685. package/packages/pm-guide-shell/package.json +1 -1
  686. package/packages/pm-kanban/package.json +1 -1
  687. package/packages/pm-lifecycle-hooks/package.json +1 -1
  688. package/packages/pm-linked-test-adapters/package.json +1 -1
  689. package/packages/pm-search-advanced/package.json +1 -1
  690. package/packages/pm-templates/package.json +1 -1
  691. package/packages/pm-todos/package.json +1 -1
  692. package/packages/pm-vcs/package.json +1 -1
  693. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  694. package/plugins/pm-claude/package.json +1 -1
  695. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  696. package/plugins/pm-codex/package.json +1 -1
  697. package/plugins/pm-codex/plugin.json +1 -1
  698. package/runtime-dependencies.json +1 -1
  699. package/scripts/finalize-build.mjs +9 -3
  700. package/dist/cli-bundle/chunks/chunk-DJDRHJBP.js +0 -234
  701. package/dist/cli-bundle/chunks/chunk-DUK5DHI6.js +0 -8
  702. package/dist/cli-bundle/chunks/chunk-IFPJDJUM.js +0 -20
  703. package/dist/cli-bundle/chunks/chunk-RL45OYTL.js +0 -6
  704. package/dist/cli-bundle/chunks/chunk-WYZGZV2M.js +0 -2
  705. package/dist/cli-bundle/focused-chunks/chunk-F5J3ATMV.js +0 -165
  706. package/dist/cli-bundle/focused-chunks/chunk-IOTNG6CN.js +0 -2
  707. package/dist/cli-bundle/focused-chunks/chunk-S6ITXQ5T.js +0 -20
  708. package/dist/cli-bundle/focused-chunks/chunk-UPJA45K7.js +0 -26
package/docs/COMMANDS.md CHANGED
@@ -336,14 +336,23 @@ pm eval --fail-under 0.6 --json # CI gate: exit non-zero when aggregate nDC
336
336
 
337
337
  ### Full results, totals, and bodies
338
338
 
339
- `pm list` returns every matched row when neither `--limit` nor `--offset` is set. Every JSON/TOON result has the same pagination envelope: `total` is the pre-pagination match count, `has_more` and `truncated` are booleans, and `next_cursor` is either the continuation token or `null`. `completeness` reports whether the corpus was `complete`, `partial`, or `unchecked` (derived-index page), with unreadable item/directory counts. Use `--strict-read` when omissions must fail the command. The `filters` object omits unset values instead of emitting null placeholders, keeping long-running agent context stable and lean. Pass `--no-truncate` to force the entire matched set and override any `--limit` in one call. `--all` selects every lifecycle status; combine the flags for an unbounded all-status audit:
339
+ `pm list` selects every matched row when neither `--limit` nor `--offset` is set; the default output budget can still bound delivery. Every JSON/TOON result has the same pagination envelope: `total` is the pre-pagination match count, `has_more` and `truncated` are booleans, and `next_cursor` is either the continuation token or `null`. `completeness` reports whether the corpus was `complete`, `partial`, or `unchecked` (derived-index page), with unreadable item/directory counts. Use `--strict-read` when omissions must fail the command. The `filters` object omits unset values instead of emitting null placeholders, keeping long-running agent context stable and lean. Pass `--no-truncate` to disable the default output budget; an explicit `--limit` still caps rows, and an explicit `--output-budget` still applies. `--all` selects every lifecycle status; combine the flags for an unbounded all-status audit:
340
340
 
341
341
  ```bash
342
- pm list --all --no-truncate --brief # every matched row, ignoring any --limit
342
+ pm list --all --no-truncate --brief # every matched row without the default token ceiling
343
343
  pm list --status open --limit 20 --json # stable total/has_more/truncated/next_cursor envelope
344
344
  pm list --all --strict-read --json # fail if any source item cannot be read
345
345
  ```
346
346
 
347
+ Continuation recovery is tracked by [pm-gh1457](../.agents/pm/issues/pm-gh1457.toon).
348
+ For list, search and context, pass a producer `next_cursor` to `--after`.
349
+ When `continuation_kind=output_cursor` is present, consume `next_cursor` through
350
+ `--output-cursor` instead. An output continuation resumes within the same
351
+ producer page, so retain its original query and any producer `--after` value.
352
+ Passing an output cursor to `--after` returns `invalid_query_cursor` with the
353
+ executable flag substitution in `next_steps`. Changed filters or snapshots
354
+ still refuse rather than silently restarting.
355
+
347
356
  Compatibility note: older responses emitted `total` only when pagination
348
357
  omitted rows, omitted `next_cursor` on a completed page, and emitted unset
349
358
  verbose filter keys as `null`. Integrations should now read `total` as the
@@ -226,8 +226,18 @@ Successful sampled reads defer their start until completion so both lifecycle ev
226
226
 
227
227
  `pm telemetry stats` reads the local queue and reports, per command bucket, latency percentiles (`duration_p50_ms`/`duration_p95_ms`/`duration_max_ms`, nearest-rank over `command_finish` `duration_ms`), outcome rates (`ok_count`/`error_count`/`error_rate`; a finish event whose `ok` is missing or not strictly `true` is counted conservatively as an error), and `command_resolution_counts`. These are an always-available, zero-network performance and reliability signal for the most recent queued window.
228
228
 
229
+ Background completion delivery is tracked by [pm-j8spis](../.agents/pm/issues/pm-j8spis.toon).
230
+ The detached uploader continues draining due events and OTLP spans appended
231
+ during an upload, so completion delivery does not require another command.
232
+ It releases the upload lock between batches and rechecks consent and identity.
233
+ Future retries remain queued, and unchanged eligible work stops the drain;
234
+ foreground commands still perform no export network I/O.
235
+
229
236
  ### Sentry environment variables
230
237
 
238
+ Tracing and privacy delivery: [pm-58yzil](../.agents/pm/features/pm-58yzil.toon) and
239
+ [pm-geywoc](../.agents/pm/issues/pm-geywoc.toon).
240
+
231
241
  Crash and error diagnostics are reported to Sentry only when telemetry is enabled and the process is not opted out. These environment variables tune the Sentry client.
232
242
 
233
243
  | Variable | Values | Use |
@@ -235,10 +245,43 @@ Crash and error diagnostics are reported to Sentry only when telemetry is enable
235
245
  | `PM_SENTRY_DISABLED` | boolean | Disable Sentry error reporting for this process (the Sentry SDK is not even imported). `PM_TELEMETRY_DISABLED` / `PM_NO_TELEMETRY` also disable it. |
236
246
  | `SENTRY_DSN` | URL | Override the destination DSN. Defaults to the bundled pm-cli project DSN. |
237
247
  | `SENTRY_ENVIRONMENT` | string | Override the reported environment tag. Defaults to `test` under Vitest, `ci` when `CI` is set, otherwise `production`. |
248
+ | `PM_SENTRY_TRACE_COMMANDS` | boolean | Explicitly initialize Sentry for successful commands. Defaults to off, preserving lazy startup. All consent opt-outs and test isolation still apply; a zero trace sample rate avoids initialization. |
238
249
  | `SENTRY_TRACES_SAMPLE_RATE` | number `0`–`1` | Fraction of command spans sampled for performance tracing. Defaults to `0.2` (20%). Set to `1` for full-trace performance debugging or `0` to disable tracing. Non-numeric or out-of-range values fall back to the default. |
239
250
 
240
251
  > Sentry is hard-disabled under Vitest (`VITEST` / `VITEST_WORKER_ID`), so these knobs are no-ops inside the test suite.
241
252
 
253
+ For a bounded diagnostic invocation use
254
+ `PM_SENTRY_TRACE_COMMANDS=1 SENTRY_TRACES_SAMPLE_RATE=1 pm context --limit 3`.
255
+ Completion flushes buffered spans within the existing three-second SDK timeout.
256
+ The sample-rate variable alone does not enable successful-command initialization.
257
+ Configured telemetry opt-outs also prevent it. The CLI skips command context and
258
+ span creation when consent is disabled, including when an embedding caller has
259
+ already initialized Sentry. SDK callers use
260
+ `ensureSentryCommandTracing(telemetryEnabled)` from `@unbrained/pm-cli/sdk`,
261
+ passing an explicit `true` only after confirming effective consent. Start a
262
+ command span only when the returned permission is `true`; an existing client
263
+ also requires the current opt-in, sampling and process policy. Other runtime
264
+ values keep initialization disabled.
265
+ Consent is checked again at command completion. A command that disables
266
+ telemetry discards its span; SDK callers can use `sentryDiscardCommandSpan()`
267
+ to clear a pending span without exporting it.
268
+ A failed completion-time settings read also discards the span, so optional
269
+ diagnostics cannot turn a successful command into a failure.
270
+ If the SDK loader or initializer fails, tracing remains unavailable for that
271
+ process and the command continues. The partial client is cleared and the
272
+ failed initialization is not retried.
273
+ Sentry sends streamed spans; its span and log hooks apply the same scrubbing
274
+ as errors and breadcrumbs. A final envelope hook scrubs serialized log attributes
275
+ after the SDK merges current and isolation scopes, preserving safe typed values
276
+ without changing shared scopes. Template parameter attributes are always redacted.
277
+ Command context retains option keys and redacted
278
+ argument slots, including text that resembles a flag. Automatic user, cookie, HTTP header/body/query, AI, database,
279
+ GraphQL, local-variable and source-context collection is explicitly
280
+ disabled. Command taxonomy and outcome attributes remain available on spans.
281
+
282
+ The separate local event and OTLP queues retain their existing formats. Turning
283
+ off command tracing does not require deleting or rewriting those queues.
284
+
242
285
  Linked commands launched by `pm test --run` default
243
286
  `SENTRY_ENVIRONMENT=test`, even when the parent process is classified as
244
287
  production. This keeps sandbox failures out of production diagnostics. An
@@ -47,6 +47,14 @@ The index and report are deterministic. `policy_fingerprint` identifies the vers
47
47
 
48
48
  Each report explains its exact matching signals, returns deduplicated local and hosted checks, and includes a small cost receipt. Package authors may keep their own recurrence policy and feed the same SDK from a custom command, extension, CI adapter, or application.
49
49
 
50
+ File-pattern evaluation is tracked by [pm-0vqbl5](../.agents/pm/tasks/pm-0vqbl5.toon).
51
+ Patterns treat punctuation and literal NUL characters literally, `*` matches any characters except `/`, and
52
+ `**` also crosses separators while excluding line terminators. Matching covers
53
+ the complete trimmed path; `**/` still requires its slash. A finite-state matcher
54
+ uses at most pattern length times path length work and memory proportional to
55
+ pattern length. The existing 256-character policy limit and bounded compiled
56
+ pattern cache remain in force, including for custom SDK policy consumers.
57
+
50
58
  ## CLI and MCP Action
51
59
 
52
60
  `assurance risk` accepts one JSON request through the same `definition` transport already used by SDK and MCP hosts:
@@ -325,7 +325,7 @@ Use the public SDK barrel. Do not deep-import from `src/core` or `dist/core`.
325
325
 
326
326
  The bundled `pm-lifecycle-hooks` package is the hook exemplar: it declares only `hooks` and registers a default-inert `afterCommand` hook so authors can copy a safe lifecycle pattern without changing command output.
327
327
  If a package calls a `register*` API without declaring the required manifest capability, `pm package doctor --project --detail deep --trace` reports `extension_capability_missing:<name>:<capability>` and shows the exact capability to add before publishing.
328
- Inline command flags require both `commands` and `schema` capabilities. Runtime schema changes should be verified with:
328
+ Inline command flags require both `commands` and `schema` capabilities. See [Extension author contracts](EXTENSION_AUTHOR_CONTRACTS.md) for canonical flag spelling ([pm-gh1461](../.agents/pm/issues/pm-gh1461.toon)) and [SDK testing helpers](SDK.md#testing-helpers) for TOON output assertions ([pm-gh1462](../.agents/pm/features/pm-gh1462.toon)). Verify runtime schema changes and flag contracts with:
329
329
 
330
330
  ```bash
331
331
  pm schema list
@@ -4,6 +4,39 @@ Tracker: pm-at83
4
4
 
5
5
  This page records runtime contracts package authors need when they build on the public SDK. For the install, manifest, lifecycle, and troubleshooting overview, see [Packages and Extensions](EXTENSIONS.md).
6
6
 
7
+ ## Flag Spelling and Output Assertions
8
+
9
+ Tracked by [pm-gh1461](../.agents/pm/issues/pm-gh1461.toon) and
10
+ [pm-gh1462](../.agents/pm/features/pm-gh1462.toon).
11
+ Value grammar corrections are tracked by [pm-gh1466](../.agents/pm/issues/pm-gh1466.toon)
12
+ and [pm-gh1467](../.agents/pm/issues/pm-gh1467.toon).
13
+ Prefer `{ long: "--repo", value_name: "project", value_type: "string" }`.
14
+ Legacy `--repo <project>`, `--repo=<project>` and `--label [name]` declarations
15
+ retain one canonical identity, one value placeholder and one help listing.
16
+ Optional brackets permit presence without a value. Explicit `value_name` wins
17
+ over the inline label. Canonical `boolean` flags are switches, including when an
18
+ inline label is present. Legacy `bool` declarations retain their value grammar:
19
+ `--enabled false`, `--enabled 0`, and their short forms consume and coerce the
20
+ value. A bare legacy `bool` permits presence without a value, preserving the
21
+ published switch form too. An explicit `--enabled <value>` still requires its
22
+ operand; `--enabled [value]` permits omission. A canonical
23
+ boolean switch leaves subsequent positional values intact. Existing equals and
24
+ negated forms remain supported; loose negated flags remain in `context.args`.
25
+ Use `--` to distinguish a positional operand immediately after an optional-valued
26
+ legacy `bool`, for example `--enabled -- operand`.
27
+ The SDK's explicit `value_arity` distinguishes `none`, `required`, and `optional`
28
+ from the scalar `value_type`. `required` describes flag presence: an optional
29
+ value remains optional even when the flag itself is required. Help, Commander,
30
+ recovery and machine contracts consume the shared SDK value declaration.
31
+ Explicit legacy `value_name` metadata remains discoverable on switches for
32
+ compatibility; `value_arity: "none"` still means that no value token is consumed.
33
+ Typed authors should use canonical `value_type` names (`boolean`, `number`, `string`).
34
+
35
+ Use `decodeToon` from `@unbrained/pm-cli/sdk/testing` to assert on host output
36
+ semantically; `encodeToon` and the native codec option types are available from
37
+ that subpath and `/sdk`. They use the host's pinned implementation, so a package
38
+ does not need a separate TOON dependency or a private `dist/` import.
39
+
7
40
  ## Telemetry Capture Level
8
41
 
9
42
  Every `pm` command records a telemetry event. Extension commands use the same telemetry pipeline as core commands and inherit `telemetry.capture_level` from the active settings.
@@ -77,3 +77,18 @@ gate, and display its recovery message; `exit_code: null` means no subprocess ra
77
77
  Context mismatches and a missing required PM assertion also use this result.
78
78
  The `TestRunResult.exit_code` type now allows null, and `TestCommandOptions` and
79
79
  `TestResult` include the optional editor flags and receipt fields described above.
80
+
81
+ ## Mixed host versions
82
+
83
+ Tracked by [pm-gh1458](../.agents/pm/issues/pm-gh1458.toon).
84
+ Editor stamps require item format 2. Ordinary records retain format 1, while
85
+ existing unstamped or legacy format-1 records advance only on a real write that
86
+ needs the new fields. Upgrade the CLI, pinned SDK, CI and clone-local merge
87
+ driver together before editing guarded records. Hosts from 2026.10.10 refuse
88
+ with `item_format_version_unsupported`; preserve item/history bytes and upgrade
89
+ instead of lowering the marker or re-anchoring valid history. Inspection of
90
+ legacy 2026.10.12–13 records retains their original history commitments.
91
+ Restoration retains the format requirement even when selecting a pre-edit state.
92
+ The SDK refuses a guarded write when the owning project's declared or resolved
93
+ runtime pins still select a pre-2026.10.10 host. Such hosts predate format
94
+ admission and must be upgraded before they read guarded records.
@@ -111,6 +111,14 @@ incompatible commands. A dry run changes neither configuration nor attributes.
111
111
 
112
112
  ### Fence coverage contract
113
113
 
114
+ Extension assets are tracked by [pm-gh1460](../.agents/pm/issues/pm-gh1460.toon).
115
+ Files under `extensions/**` use Git's built-in `merge=text` driver, so separate
116
+ text edits combine and overlapping edits retain normal conflict markers.
117
+ Git still detects binary content and preserves its conflicted stages. The later
118
+ `.managed-extensions.json` rule keeps the structured `pm-json` driver.
119
+ The v2 fence grammar remains stable; `pm merge install` refreshes stale patterns
120
+ without discarding sibling fences or restoring legacy unversioned markers.
121
+
114
122
  The fenced block is generated by one shared coverage contract (`buildMergeAttributePatterns`) covering every mergeable artifact class: tracker-wide `**/*.toon` and `**/*.md` item patterns, explicit per-type diagnostic patterns, all tracker `**/*.jsonl` paths under the relationship-event driver with the more-specific `history/*.jsonl` rule overriding history streams, root `settings.json`, and every nested `**/*.json` document. The tracker-wide item rules protect extension-defined type folders even when a receiving branch has not installed the package that registered them; explicit type rows still make active-registry drift diagnosable. The broad JSON rules automatically cover schema, managed-extension, evaluation-corpus, and future package-owned authoritative JSON without another hand-maintained allowlist. The broad JSONL rule is required because `RelationshipEventStore` supports package-owned custom relative paths anywhere below the tracker root. Two mechanisms keep the committed fence from drifting out of that contract:
115
123
 
116
124
  - `pm schema add-type` / `pm schema remove-type` refresh the fence automatically when it is installed (warning `merge_fence_refreshed`); repos inside git that never installed it get the actionable `merge_fence_not_installed` hint instead.
package/docs/RELEASING.md CHANGED
@@ -486,6 +486,8 @@ never move a published tag or mint a second automatic version for the same UTC d
486
486
  - static quality gate (shared complexity, duplication, dead/orphan module, file/folder hygiene, source/exported docstring coverage profile)
487
487
  - temporary-project compatibility gate against latest published tracker data
488
488
  - reliability threshold gate (Sentry severity threshold, bounded to a recent-activity window via `--sentry-window-days` (default `14`, `0` = unbounded) so a stale benign unresolved issue cannot block every scheduled release; Sentry requests use the fail-closed bounded `--sentry-request-timeout-ms` contract (default `120000`, maximum `300000`); `--telemetry-mode` gate policy: `off` | `best-effort` | `required`). Scheduled `auto-release.yml` failures open/update an `Auto Release blocked` GitHub issue so blocked daily releases are never silently skipped.
489
+ - extension grammar acceptance ([pm-gh1466](../.agents/pm/issues/pm-gh1466.toon), [pm-gh1467](../.agents/pm/issues/pm-gh1467.toon)): the existing flag parity gate includes a synthetic extension population, and packed smoke runs the same independent echo oracle on Node and Bun. Immediately before publication, `extension-flag-acceptance.mjs` extracts the exact tarball passed to `npm publish`, resolves its public SDK exports and manifest executable, and checks help, machine contracts, handler options, remaining arguments and refusals. Any failed or missing case stops publication. The retained receipt records executed case identities, runtime, resolved entrypoints, fixture digest and tarball SHA-256. This proves candidate behavior; published-installed acceptance remains a separate claim. Exact-tag recovery preserves both the reviewed runner and its fixture outside the tagged checkout.
490
+ - diagnostic privacy acceptance ([pm-geywoc](../.agents/pm/issues/pm-geywoc.toon)): the same candidate runner requires the independent synthetic diagnostic fixture through the installed public SDK. A disposable loopback collector verifies real serialized error events, streamed spans, and finalized logs, including scope attributes. Quoted keys, Unicode escapes in keys/delimiters/separators, nested serialized JSON, containers and incomplete values must lose their sensitive markers; safe text, numeric/boolean attributes and caller scope must remain intact. Opaque encoded boundaries redact the remaining text, and a long backslash control bounds scanning cost. Missing, failed or duplicate case receipts block acceptance. Recovery preserves the diagnostic fixture with the runner. This local export proof is separate from hosted Sentry ingestion and does not change user consent.
489
491
  - sandboxed `pm` coverage
490
492
  - a base npm pack dry run, optional Sentry debug-ID injection, a second
491
493
  `sentry-injected` packlist budget over the exact publishable bytes, and only
package/docs/SDK.md CHANGED
@@ -2670,6 +2670,22 @@ missing. Named expectations use `{ name }`; historical surface-specific aliases
2670
2670
  remain supported. Optional `extensionName` limits a match to one extension.
2671
2671
  The published surface snapshot contains the complete helper signatures.
2672
2672
 
2673
+ Output codecs are tracked by [pm-gh1462](../.agents/pm/features/pm-gh1462.toon).
2674
+ `decodeToon` and `encodeToon` use the exact TOON implementation shipped by the
2675
+ host. They are exported from `/sdk/testing` and `/sdk`, with `ToonDecodeOptions`,
2676
+ `ToonEncodeOptions` and `ToonJsonValue` types. Compare decoded values instead of
2677
+ matching spaces or quoted scalars, and retain strict decoder errors for malformed
2678
+ output:
2679
+
2680
+ ```ts
2681
+ import assert from "node:assert/strict";
2682
+ import { decodeToon, encodeToon } from "@unbrained/pm-cli/sdk/testing";
2683
+
2684
+ const stdout = "status: open\n"; // Replace with captured host output.
2685
+ assert.deepEqual(decodeToon(stdout), { status: "open" });
2686
+ assert.deepEqual(decodeToon(encodeToon({ enabled: false })), { enabled: false });
2687
+ ```
2688
+
2673
2689
  Prefer `createExtensionTestHarness` when testing a package. Its bound methods
2674
2690
  select the correct registry, preventing accidental use of a command registry for
2675
2691
  hooks or services:
@@ -3127,6 +3143,9 @@ tracker and extension policy from any working directory.
3127
3143
  In-process callers of `runPmCli(args)` do not need to replace `process.argv`:
3128
3144
  usage and help recovery use the supplied invocation for command selection,
3129
3145
  tracker scope, extension policy and both text and JSON formatting.
3146
+ Eval hosts with no `process.argv[1]` also work: the CLI supplies an internal
3147
+ script label and preserves the host's argument array and exit status
3148
+ ([pm-mor9pl](../.agents/pm/issues/pm-mor9pl.toon)).
3130
3149
 
3131
3150
  `runTest(id, { measure: [...] }, global)` requires `run: true`. A missing run
3132
3151
  returns `test_measure_requires_run` before linked-test mutation, with an executable
package/docs/TESTING.md CHANGED
@@ -144,7 +144,7 @@ only after the pushed reviewed head's hosted analyzers are terminal.
144
144
 
145
145
  ## Published Workspace Compatibility
146
146
 
147
- Tracked by [pm-pae3wo](../.agents/pm/tasks/pm-pae3wo.toon).
147
+ Tracked by [pm-pae3wo](../.agents/pm/tasks/pm-pae3wo.toon) and [pm-gh1458](../.agents/pm/issues/pm-gh1458.toon).
148
148
  Run `node scripts/release/workspace-compatibility.mjs --json` after building.
149
149
  The policy in `scripts/release/workspace-compatibility-policy.json` requires
150
150
  the two immediately preceding stable calendar releases. Each installed release
@@ -172,6 +172,26 @@ entrypoint from their own consumer directory. Raw parsers still preserve future
172
172
  markers for integrity inspection; inventory diagnostics are not permission to
173
173
  rewrite an unsupported item.
174
174
 
175
+ Format 1 remains readable and is still used for ordinary records. Persisting
176
+ linked-test editor stamps requires format 2. The same mutation records that
177
+ marker in history; ordinary subsequent writes, restoration and current-runtime
178
+ merges retain it. Restoring an older state does not lower the reader requirement
179
+ while newer history remains. Existing format-1 editor records written by
180
+ 2026.10.12–13 keep their original hashes during inspection and acquire the
181
+ format-2 guard on the next real write. Upgrade every reader, CI runtime and Git
182
+ merge driver before operating on guarded records. Never re-anchor history or
183
+ remove the marker to make an older verifier pass.
184
+
185
+ The additional published-artifact matrix pins the reported 2026.10.9, 10 and 13
186
+ hosts. It proves original history-prefix preservation, exact nested stamps,
187
+ write refusal when the project still pins 2026.10.9, and CLI/public SDK format
188
+ refusal by 2026.10.10 and 13 without byte changes, ordinary
189
+ current writes, restored states, and native Git merge/reconciliation with the
190
+ upgraded driver. Baseline records still pass the two-prior-release matrix.
191
+ The 2026.10.9 host predates format admission and is not a supported reader of
192
+ guarded records; update project pins and resolved dependencies before writing
193
+ them. That host's mutation bootstrap can then reject the newer project pin.
194
+
175
195
  Run the matrix from the built workspace root. Exact-tag release recovery retains
176
196
  the reviewed matrix controls, policy and static fixtures outside the checkout,
177
197
  then tests the selected tagged runtime through its manifest and public SDK. A
@@ -4,12 +4,12 @@ Tracker: `pm-f05lsg`.
4
4
 
5
5
  Every catalog code is listed. An `uncovered` row is an explicit closure obligation, never an omission or implied approval.
6
6
 
7
- - Catalog error codes: 405
7
+ - Catalog error codes: 406
8
8
  - Executable error codes: 19
9
9
  - Executable-code ratchet floor: 18
10
10
  - Required executable canonical codes: `bulk_ids_input_empty`, `bulk_ids_input_missing_path`, `bulk_ids_input_unreadable`, `invalid_argument_value`, `manifest_unknown_key`, `missing_lifecycle_target`, `missing_required_argument`, `no_version_bounds_declared`, `projection_options_mutually_exclusive`, `tracker_not_initialized`, `tracker_root_missing`, `tracker_root_not_directory`, `tracker_root_unreadable`, `unknown_context_intent`, `unknown_field_projection`, `unknown_option`, `unknown_subcommand`
11
- - Uncovered error codes: 386
12
- - Coverage fraction: 0.046914
11
+ - Uncovered error codes: 387
12
+ - Coverage fraction: 0.046798
13
13
  - Closed-domain probes: 19
14
14
  - Grammar probes: 117
15
15
 
@@ -265,6 +265,7 @@ Every catalog code is listed. An `uncovered` row is an explicit closure obligati
265
265
  | `profile_summary_empty` | `profile_summary_empty` | uncovered | none | 0 |
266
266
  | `profile_title_empty` | `profile_title_empty` | uncovered | none | 0 |
267
267
  | `project_runtime_history_epoch_incompatible` | `project_runtime_history_epoch_incompatible` | uncovered | none | 0 |
268
+ | `project_runtime_item_format_incompatible` | `project_runtime_item_format_incompatible` | uncovered | none | 0 |
268
269
  | `project_runtime_stale_mutation` | `project_runtime_stale_mutation` | uncovered | none | 0 |
269
270
  | `project_runtime_stale_read` | `project_runtime_stale_read` | uncovered | none | 0 |
270
271
  | `projection_options_mutually_exclusive` | `projection_options_mutually_exclusive` | executable | closed_domain | 3 |
package/marketplace.json CHANGED
@@ -1 +1 @@
1
- {"name":"pm","owner":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"description":"Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.","version":"2026.10.13","plugins":[{"name":"pm-claude","source":"./plugins/pm-claude","description":"Native pm CLI integration for Claude Code — 32 MCP tools, 14 workflow skills with slash invocations, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.","version":"2026.10.13","author":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"homepage":"https://github.com/unbraind/pm-cli","repository":"https://github.com/unbraind/pm-cli","license":"MIT","keywords":["pm-cli","project-management","mcp","tasks","agents","workflows","git-native","task-tracker","ai"],"category":"productivity"}]}
1
+ {"name":"pm","owner":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"description":"Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.","version":"2026.10.15","plugins":[{"name":"pm-claude","source":"./plugins/pm-claude","description":"Native pm CLI integration for Claude Code — 32 MCP tools, 14 workflow skills with slash invocations, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.","version":"2026.10.15","author":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"homepage":"https://github.com/unbraind/pm-cli","repository":"https://github.com/unbraind/pm-cli","license":"MIT","keywords":["pm-cli","project-management","mcp","tasks","agents","workflows","git-native","task-tracker","ai"],"category":"productivity"}]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@unbrained/pm-cli",
3
- "version": "2026.10.13",
3
+ "version": "2026.10.15",
4
4
  "description": "Git-native project management CLI for humans and agents.",
5
5
  "type": "module",
6
6
  "packageManager": "pnpm@11.10.0",
@@ -133,6 +133,7 @@
133
133
  "commander": "^15.0.0",
134
134
  "fast-json-patch": "^3.1.1",
135
135
  "npm-package-arg": "^13.0.2",
136
+ "semver": "7.8.5",
136
137
  "tar": "7.5.22",
137
138
  "tinyglobby": "^0.2.17",
138
139
  "yaml": "^2.9.1"
@@ -151,6 +152,7 @@
151
152
  "commander",
152
153
  "fast-json-patch",
153
154
  "npm-package-arg",
155
+ "semver",
154
156
  "tar",
155
157
  "tinyglobby",
156
158
  "yaml"
@@ -1 +1 @@
1
- {"name":"@unbrained/pm-beads","version":"2026.10.13","private":true,"type":"module","description":"First-party pm package for importing Beads JSONL records.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-beads#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-beads"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","beads"],"pm":{"aliases":["beads"],"extensions":["extensions/beads"],"catalog":{"display_name":"Beads Import","category":"migration","summary":"Import Beads JSONL records into pm while preserving source IDs.","tags":["migration","beads","import"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-beads#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-beads","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
1
+ {"name":"@unbrained/pm-beads","version":"2026.10.15","private":true,"type":"module","description":"First-party pm package for importing Beads JSONL records.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-beads#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-beads"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","beads"],"pm":{"aliases":["beads"],"extensions":["extensions/beads"],"catalog":{"display_name":"Beads Import","category":"migration","summary":"Import Beads JSONL records into pm while preserving source IDs.","tags":["migration","beads","import"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-beads#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-beads","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
@@ -1 +1 @@
1
- {"name":"@unbrained/pm-calendar","version":"2026.10.13","private":true,"type":"module","description":"First-party pm package for calendar and agenda views.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-calendar#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-calendar"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","calendar","agenda"],"pm":{"aliases":["calendar"],"extensions":["extensions/calendar"],"catalog":{"display_name":"Calendar Views","category":"workflow","summary":"Show agenda, day, week, and month views for deadlines, reminders, and scheduled events.","tags":["calendar","agenda","workflow"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-calendar#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-calendar","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
1
+ {"name":"@unbrained/pm-calendar","version":"2026.10.15","private":true,"type":"module","description":"First-party pm package for calendar and agenda views.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-calendar#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-calendar"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","calendar","agenda"],"pm":{"aliases":["calendar"],"extensions":["extensions/calendar"],"catalog":{"display_name":"Calendar Views","category":"workflow","summary":"Show agenda, day, week, and month views for deadlines, reminders, and scheduled events.","tags":["calendar","agenda","workflow"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-calendar#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-calendar","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
@@ -1 +1 @@
1
- {"name":"@unbrained/pm-command-kit","version":"2026.10.13","private":true,"type":"module","description":"First-party pm exemplar package for the commands capability: registerCommand, registerFlags, and registerParser.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-command-kit#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-command-kit"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","sdk","commands","exemplar"],"pm":{"aliases":["command-kit"],"extensions":["extensions/command-kit"],"catalog":{"display_name":"Command Kit Exemplar","category":"sdk","summary":"Copy-paste-able exemplar for registerCommand, registerFlags, and registerParser.","tags":["sdk","commands","parser","exemplar"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-command-kit#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-command-kit","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
1
+ {"name":"@unbrained/pm-command-kit","version":"2026.10.15","private":true,"type":"module","description":"First-party pm exemplar package for the commands capability: registerCommand, registerFlags, and registerParser.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-command-kit#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-command-kit"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","sdk","commands","exemplar"],"pm":{"aliases":["command-kit"],"extensions":["extensions/command-kit"],"catalog":{"display_name":"Command Kit Exemplar","category":"sdk","summary":"Copy-paste-able exemplar for registerCommand, registerFlags, and registerParser.","tags":["sdk","commands","parser","exemplar"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-command-kit#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-command-kit","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
@@ -1 +1 @@
1
- {"name":"@unbrained/pm-digital-twin","version":"2026.10.13","private":true,"type":"module","description":"Beyond-PM exemplar: a temporal production-facility digital twin built entirely on public pm SDK and extension primitives.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-digital-twin#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-digital-twin"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","sdk","digital-twin","event-sourcing","temporal-graph","exemplar"],"pm":{"aliases":["digital-twin","twin"],"extensions":["extensions/digital-twin"],"catalog":{"display_name":"Digital Twin SDK Exemplar","category":"sdk","summary":"Temporal facility graph proving event replay, point-in-time state, invariants, federation, checkpoints, and compact exports through public SDK contracts.","tags":["sdk","digital-twin","event-sourcing","graph","offline-first","exemplar"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-digital-twin#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-digital-twin","report":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-digital-twin/GAP_REPORT.md"}},"docs":["README.md","GAP_REPORT.md"],"examples":["README.md"]}}
1
+ {"name":"@unbrained/pm-digital-twin","version":"2026.10.15","private":true,"type":"module","description":"Beyond-PM exemplar: a temporal production-facility digital twin built entirely on public pm SDK and extension primitives.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-digital-twin#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-digital-twin"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","sdk","digital-twin","event-sourcing","temporal-graph","exemplar"],"pm":{"aliases":["digital-twin","twin"],"extensions":["extensions/digital-twin"],"catalog":{"display_name":"Digital Twin SDK Exemplar","category":"sdk","summary":"Temporal facility graph proving event replay, point-in-time state, invariants, federation, checkpoints, and compact exports through public SDK contracts.","tags":["sdk","digital-twin","event-sourcing","graph","offline-first","exemplar"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-digital-twin#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-digital-twin","report":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-digital-twin/GAP_REPORT.md"}},"docs":["README.md","GAP_REPORT.md"],"examples":["README.md"]}}
@@ -1 +1 @@
1
- {"name":"@unbrained/pm-governance-audit","version":"2026.10.13","private":true,"type":"module","description":"First-party pm package for governance audit and normalization workflows.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-governance-audit#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-governance-audit"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","governance","audit","normalize","hooks"],"pm":{"aliases":["governance-audit","audit"],"extensions":["extensions/governance-audit"],"catalog":{"display_name":"Governance Audit","category":"governance","summary":"Run dedupe audits, comments audits, and normalize sweeps as package-owned workflows.","tags":["governance","audit","normalize","hooks"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-governance-audit#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-governance-audit","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
1
+ {"name":"@unbrained/pm-governance-audit","version":"2026.10.15","private":true,"type":"module","description":"First-party pm package for governance audit and normalization workflows.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-governance-audit#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-governance-audit"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","governance","audit","normalize","hooks"],"pm":{"aliases":["governance-audit","audit"],"extensions":["extensions/governance-audit"],"catalog":{"display_name":"Governance Audit","category":"governance","summary":"Run dedupe audits, comments audits, and normalize sweeps as package-owned workflows.","tags":["governance","audit","normalize","hooks"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-governance-audit#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-governance-audit","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
@@ -1 +1 @@
1
- {"name":"@unbrained/pm-guide-shell","version":"2026.10.13","private":true,"type":"module","description":"First-party pm package for guide and shell completion workflows.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-guide-shell#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-guide-shell"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","guide","completion","shell"],"pm":{"aliases":["guide-shell"],"extensions":["extensions/guide-shell"],"catalog":{"display_name":"Guide + Shell UX","category":"workflow","summary":"Restore guide documentation and shell completion commands as package-owned UX surfaces.","tags":["guide","completion","shell"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-guide-shell#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-guide-shell","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
1
+ {"name":"@unbrained/pm-guide-shell","version":"2026.10.15","private":true,"type":"module","description":"First-party pm package for guide and shell completion workflows.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-guide-shell#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-guide-shell"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","guide","completion","shell"],"pm":{"aliases":["guide-shell"],"extensions":["extensions/guide-shell"],"catalog":{"display_name":"Guide + Shell UX","category":"workflow","summary":"Restore guide documentation and shell completion commands as package-owned UX surfaces.","tags":["guide","completion","shell"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-guide-shell#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-guide-shell","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
@@ -1 +1 @@
1
- {"name":"@unbrained/pm-kanban","version":"2026.10.13","private":true,"type":"module","description":"First-party pm archetype package: a complete Kanban continuous-flow profile built on public SDK primitives.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-kanban#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-kanban"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","sdk","profile","archetype","kanban","exemplar"],"pm":{"aliases":["kanban"],"extensions":["extensions/kanban"],"catalog":{"display_name":"Kanban Archetype","category":"sdk","summary":"Installable Kanban continuous-flow archetype: Card item type, flow fields, and a ProjectProfileDefinition built on public SDK primitives.","tags":["sdk","profile","archetype","kanban","schema","exemplar"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-kanban#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-kanban","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
1
+ {"name":"@unbrained/pm-kanban","version":"2026.10.15","private":true,"type":"module","description":"First-party pm archetype package: a complete Kanban continuous-flow profile built on public SDK primitives.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-kanban#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-kanban"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","sdk","profile","archetype","kanban","exemplar"],"pm":{"aliases":["kanban"],"extensions":["extensions/kanban"],"catalog":{"display_name":"Kanban Archetype","category":"sdk","summary":"Installable Kanban continuous-flow archetype: Card item type, flow fields, and a ProjectProfileDefinition built on public SDK primitives.","tags":["sdk","profile","archetype","kanban","schema","exemplar"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-kanban#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-kanban","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
@@ -1 +1 @@
1
- {"name":"@unbrained/pm-lifecycle-hooks","version":"2026.10.13","private":true,"type":"module","description":"First-party pm package demonstrating safe lifecycle hook registration.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-lifecycle-hooks#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-lifecycle-hooks"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","hooks","lifecycle","sdk"],"pm":{"aliases":["lifecycle-hooks"],"extensions":["extensions/lifecycle-hooks"],"catalog":{"display_name":"Lifecycle Hooks","category":"sdk","summary":"Default-inert lifecycle hook exemplar for package authors.","tags":["hooks","lifecycle","sdk"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-lifecycle-hooks#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-lifecycle-hooks","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
1
+ {"name":"@unbrained/pm-lifecycle-hooks","version":"2026.10.15","private":true,"type":"module","description":"First-party pm package demonstrating safe lifecycle hook registration.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-lifecycle-hooks#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-lifecycle-hooks"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","hooks","lifecycle","sdk"],"pm":{"aliases":["lifecycle-hooks"],"extensions":["extensions/lifecycle-hooks"],"catalog":{"display_name":"Lifecycle Hooks","category":"sdk","summary":"Default-inert lifecycle hook exemplar for package authors.","tags":["hooks","lifecycle","sdk"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-lifecycle-hooks#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-lifecycle-hooks","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
@@ -1 +1 @@
1
- {"name":"@unbrained/pm-linked-test-adapters","version":"2026.10.13","private":true,"type":"module","description":"First-party pm package for optional linked-test run management adapters and reporters.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-linked-test-adapters#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-linked-test-adapters"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","linked-tests","background-runs","test-runs"],"pm":{"aliases":["linked-test-adapters"],"extensions":["extensions/linked-test-adapters"],"catalog":{"display_name":"Linked Test Adapters","category":"testing","summary":"Restore optional linked-test run management/reporting command surfaces.","tags":["tests","linked-tests","background","reporting"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-linked-test-adapters#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-linked-test-adapters","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
1
+ {"name":"@unbrained/pm-linked-test-adapters","version":"2026.10.15","private":true,"type":"module","description":"First-party pm package for optional linked-test run management adapters and reporters.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-linked-test-adapters#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-linked-test-adapters"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","linked-tests","background-runs","test-runs"],"pm":{"aliases":["linked-test-adapters"],"extensions":["extensions/linked-test-adapters"],"catalog":{"display_name":"Linked Test Adapters","category":"testing","summary":"Restore optional linked-test run management/reporting command surfaces.","tags":["tests","linked-tests","background","reporting"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-linked-test-adapters#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-linked-test-adapters","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
@@ -1 +1 @@
1
- {"name":"@unbrained/pm-search-advanced","version":"2026.10.13","private":true,"type":"module","description":"First-party pm package for semantic, hybrid, and reindex search workflows.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-search-advanced#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-search-advanced"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","search","reindex","semantic","hybrid"],"pm":{"aliases":["search-advanced"],"extensions":["extensions/search-advanced"],"catalog":{"display_name":"Advanced Search","category":"search","summary":"Enable semantic/hybrid search modes and reindex workflows.","tags":["search","semantic","hybrid","reindex"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-search-advanced#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-search-advanced","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
1
+ {"name":"@unbrained/pm-search-advanced","version":"2026.10.15","private":true,"type":"module","description":"First-party pm package for semantic, hybrid, and reindex search workflows.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-search-advanced#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-search-advanced"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","search","reindex","semantic","hybrid"],"pm":{"aliases":["search-advanced"],"extensions":["extensions/search-advanced"],"catalog":{"display_name":"Advanced Search","category":"search","summary":"Enable semantic/hybrid search modes and reindex workflows.","tags":["search","semantic","hybrid","reindex"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-search-advanced#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-search-advanced","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
@@ -1 +1 @@
1
- {"name":"@unbrained/pm-templates","version":"2026.10.13","private":true,"type":"module","description":"First-party pm package for reusable create templates.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-templates#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-templates"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","templates"],"pm":{"aliases":["templates"],"extensions":["extensions/templates"],"catalog":{"display_name":"Create Templates","category":"workflow","summary":"Save, list, show, and apply reusable pm create option templates.","tags":["templates","create","workflow"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-templates#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-templates","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
1
+ {"name":"@unbrained/pm-templates","version":"2026.10.15","private":true,"type":"module","description":"First-party pm package for reusable create templates.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-templates#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-templates"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","templates"],"pm":{"aliases":["templates"],"extensions":["extensions/templates"],"catalog":{"display_name":"Create Templates","category":"workflow","summary":"Save, list, show, and apply reusable pm create option templates.","tags":["templates","create","workflow"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-templates#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-templates","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
@@ -1 +1 @@
1
- {"name":"@unbrained/pm-todos","version":"2026.10.13","private":true,"type":"module","description":"First-party pm package for Todo markdown import and export.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-todos"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","todos"],"pm":{"aliases":["todos"],"extensions":["extensions/todos"],"catalog":{"display_name":"Todos Import/Export","category":"migration","summary":"Import and export Todo markdown tasks through pm package commands.","tags":["migration","todos","import","export"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
1
+ {"name":"@unbrained/pm-todos","version":"2026.10.15","private":true,"type":"module","description":"First-party pm package for Todo markdown import and export.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-todos"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","todos"],"pm":{"aliases":["todos"],"extensions":["extensions/todos"],"catalog":{"display_name":"Todos Import/Export","category":"migration","summary":"Import and export Todo markdown tasks through pm package commands.","tags":["migration","todos","import","export"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
@@ -1 +1 @@
1
- {"name":"@unbrained/pm-vcs-sdk-exemplar","version":"2026.10.13","private":true,"type":"module","description":"Beyond-PM exemplar: a VCS-style changeset workflow built entirely on public pm SDK and extension primitives.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-vcs#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-vcs"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","sdk","vcs","event-sourcing","exemplar"],"pm":{"aliases":["vcs-exemplar"],"extensions":["extensions/vcs"],"catalog":{"display_name":"VCS SDK Exemplar","category":"sdk","summary":"Non-PM changeset/ref workflow proving custom schema, domain commands, hooks, history replay, and typed relationship events through public SDK contracts.","tags":["sdk","vcs","event-sourcing","graph","exemplar"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-vcs#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-vcs","report":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-vcs/GAP_REPORT.md"}},"docs":["README.md","GAP_REPORT.md"],"examples":["README.md"]}}
1
+ {"name":"@unbrained/pm-vcs-sdk-exemplar","version":"2026.10.15","private":true,"type":"module","description":"Beyond-PM exemplar: a VCS-style changeset workflow built entirely on public pm SDK and extension primitives.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-vcs#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-vcs"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","sdk","vcs","event-sourcing","exemplar"],"pm":{"aliases":["vcs-exemplar"],"extensions":["extensions/vcs"],"catalog":{"display_name":"VCS SDK Exemplar","category":"sdk","summary":"Non-PM changeset/ref workflow proving custom schema, domain commands, hooks, history replay, and typed relationship events through public SDK contracts.","tags":["sdk","vcs","event-sourcing","graph","exemplar"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-vcs#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-vcs","report":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-vcs/GAP_REPORT.md"}},"docs":["README.md","GAP_REPORT.md"],"examples":["README.md"]}}
@@ -1 +1 @@
1
- {"$schema":"https://json.schemastore.org/claude-code-plugin-manifest.json","name":"pm-claude","displayName":"pm CLI","description":"Native pm CLI integration for Claude Code — 32 MCP tools, 14 skills with slash invocations, 4 subagents (coordinator, delivery-chain, triage, verification), hybrid TUI task tracking (pm as persistent store + Claude Code task panel as live view), session context injection, and full git-based project management without leaving Claude Code.","version":"2026.10.13","author":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"homepage":"https://github.com/unbraind/pm-cli","repository":"https://github.com/unbraind/pm-cli","license":"MIT","keywords":["pm-cli","project-management","mcp","tasks","agents","workflows","git-native","task-tracker","ai"]}
1
+ {"$schema":"https://json.schemastore.org/claude-code-plugin-manifest.json","name":"pm-claude","displayName":"pm CLI","description":"Native pm CLI integration for Claude Code — 32 MCP tools, 14 skills with slash invocations, 4 subagents (coordinator, delivery-chain, triage, verification), hybrid TUI task tracking (pm as persistent store + Claude Code task panel as live view), session context injection, and full git-based project management without leaving Claude Code.","version":"2026.10.15","author":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"homepage":"https://github.com/unbraind/pm-cli","repository":"https://github.com/unbraind/pm-cli","license":"MIT","keywords":["pm-cli","project-management","mcp","tasks","agents","workflows","git-native","task-tracker","ai"]}
@@ -1 +1 @@
1
- {"name":"pm-claude-runtime","private":true,"type":"module","version":"2026.10.13","dependencies":{"@unbrained/pm-cli":"2026.10.13"}}
1
+ {"name":"pm-claude-runtime","private":true,"type":"module","version":"2026.10.15","dependencies":{"@unbrained/pm-cli":"2026.10.15"}}
@@ -1 +1 @@
1
- {"name":"pm-codex","version":"2026.10.13","description":"Native Codex integration for pm-cli with bundled MCP tools, skills, commands, and agent workflows.","author":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"homepage":"https://github.com/unbraind/pm-cli/tree/main/plugins/pm-codex","repository":"https://github.com/unbraind/pm-cli","license":"MIT","keywords":["pm-cli","codex","mcp","project-management","agents","tasks","workflows"],"skills":"./skills/","mcpServers":"./.mcp.json","interface":{"displayName":"pm CLI","shortDescription":"Native pm tracker tools and agent workflows","longDescription":"Use pm CLI from Codex through native MCP tools instead of shelling out to the pm command. The plugin bundles tracker operations, skills, command prompts, and subagent workflow guidance for planning, execution, validation, release, and audit work.","developerName":"unbrained","category":"Coding","capabilities":["Interactive","Read","Write"],"websiteURL":"https://github.com/unbraind/pm-cli","privacyPolicyURL":"https://github.com/unbraind/pm-cli/blob/main/SECURITY.md","termsOfServiceURL":"https://github.com/unbraind/pm-cli/blob/main/LICENSE","defaultPrompt":["Use pm CLI to orient, claim, track, verify, and close this repository task"],"composerIcon":"./assets/pm-cli-small.svg","logo":"./assets/pm-cli-small.svg","screenshots":[],"brandColor":"#2563EB"}}
1
+ {"name":"pm-codex","version":"2026.10.15","description":"Native Codex integration for pm-cli with bundled MCP tools, skills, commands, and agent workflows.","author":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"homepage":"https://github.com/unbraind/pm-cli/tree/main/plugins/pm-codex","repository":"https://github.com/unbraind/pm-cli","license":"MIT","keywords":["pm-cli","codex","mcp","project-management","agents","tasks","workflows"],"skills":"./skills/","mcpServers":"./.mcp.json","interface":{"displayName":"pm CLI","shortDescription":"Native pm tracker tools and agent workflows","longDescription":"Use pm CLI from Codex through native MCP tools instead of shelling out to the pm command. The plugin bundles tracker operations, skills, command prompts, and subagent workflow guidance for planning, execution, validation, release, and audit work.","developerName":"unbrained","category":"Coding","capabilities":["Interactive","Read","Write"],"websiteURL":"https://github.com/unbraind/pm-cli","privacyPolicyURL":"https://github.com/unbraind/pm-cli/blob/main/SECURITY.md","termsOfServiceURL":"https://github.com/unbraind/pm-cli/blob/main/LICENSE","defaultPrompt":["Use pm CLI to orient, claim, track, verify, and close this repository task"],"composerIcon":"./assets/pm-cli-small.svg","logo":"./assets/pm-cli-small.svg","screenshots":[],"brandColor":"#2563EB"}}
@@ -1 +1 @@
1
- {"name":"pm-codex-runtime","private":true,"type":"module","version":"2026.10.13","dependencies":{"@unbrained/pm-cli":"2026.10.13"}}
1
+ {"name":"pm-codex-runtime","private":true,"type":"module","version":"2026.10.15","dependencies":{"@unbrained/pm-cli":"2026.10.15"}}
@@ -1 +1 @@
1
- {"$schema":"https://agent-plugins.org/schemas/1.0.0/plugin.schema.json","name":"pm-codex","version":"2026.10.13","description":"Repository-native project context workflows and a version-pinned pm MCP server for Codex.","author":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"homepage":"https://github.com/unbraind/pm-cli/tree/main/plugins/pm-codex","repository":"https://github.com/unbraind/pm-cli","license":"MIT","keywords":["pm-cli","codex","mcp","project-management","agents"],"extensions":{"com.openai":{"interface":{"displayName":"pm CLI","shortDescription":"Track project context with pm","longDescription":"Orient, plan, implement, verify, and hand off work with repository-native pm records and a bundled MCP server.","developerName":"unbrained","category":"Coding","capabilities":["Interactive","Read","Write"],"websiteURL":"https://github.com/unbraind/pm-cli","privacyPolicyURL":"https://github.com/unbraind/pm-cli/blob/main/SECURITY.md","termsOfServiceURL":"https://github.com/unbraind/pm-cli/blob/main/LICENSE","defaultPrompt":["Use pm to orient, track, verify, and hand off this repository task."],"composerIcon":"./assets/pm-cli-small.svg","logo":"./assets/pm-cli-small.svg","brandColor":"#2563EB"}}}}
1
+ {"$schema":"https://agent-plugins.org/schemas/1.0.0/plugin.schema.json","name":"pm-codex","version":"2026.10.15","description":"Repository-native project context workflows and a version-pinned pm MCP server for Codex.","author":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"homepage":"https://github.com/unbraind/pm-cli/tree/main/plugins/pm-codex","repository":"https://github.com/unbraind/pm-cli","license":"MIT","keywords":["pm-cli","codex","mcp","project-management","agents"],"extensions":{"com.openai":{"interface":{"displayName":"pm CLI","shortDescription":"Track project context with pm","longDescription":"Orient, plan, implement, verify, and hand off work with repository-native pm records and a bundled MCP server.","developerName":"unbrained","category":"Coding","capabilities":["Interactive","Read","Write"],"websiteURL":"https://github.com/unbraind/pm-cli","privacyPolicyURL":"https://github.com/unbraind/pm-cli/blob/main/SECURITY.md","termsOfServiceURL":"https://github.com/unbraind/pm-cli/blob/main/LICENSE","defaultPrompt":["Use pm to orient, track, verify, and hand off this repository task."],"composerIcon":"./assets/pm-cli-small.svg","logo":"./assets/pm-cli-small.svg","brandColor":"#2563EB"}}}}