@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
@@ -1,189 +1,189 @@
1
- import { resolveItemTypeRegistry, type RuntimeFieldRegistry, type RuntimeStatusRegistry, type NormalizedTypeWorkflow, type GlobalOptions, PmCliError, getActiveExtensionRegistrations, readSettings } from "../runtime-primitives.js";
2
- import type { Dependency, GovernanceWorkflowEnforcement, ItemDocument } from "../../types/index.js";
3
- import { parseDocs, parseFiles, parseLogSeed, parseTests } from "./create.js";
4
- import type { MutationMetadataCommandOptions, SharedLinkedResourceClearOptions, SharedLinkedResourceOptions } from "./mutation-command-options.js";
1
+ import { resolveItemTypeRegistry,type RuntimeFieldRegistry,type RuntimeStatusRegistry,type NormalizedTypeWorkflow,type GlobalOptions,PmCliError,getActiveExtensionRegistrations,readSettings } from "../runtime-primitives.js";
2
+ import type { Dependency,GovernanceWorkflowEnforcement,ItemDocument } from "../../types/index.js";
3
+ import { parseDocs,parseFiles,parseLogSeed,parseTests } from "./create.js";
4
+ import type { MutationMetadataCommandOptions,SharedLinkedResourceClearOptions,SharedLinkedResourceOptions } from "./mutation-command-options.js";
5
5
  /** Documents the update command options payload exchanged by command, SDK, and package integrations. */
6
- export interface UpdateCommandOptions extends MutationMetadataCommandOptions, SharedLinkedResourceOptions, SharedLinkedResourceClearOptions {
6
+ export interface UpdateCommandOptions extends MutationMetadataCommandOptions,SharedLinkedResourceOptions,SharedLinkedResourceClearOptions {
7
7
  /** Value that configures or reports title for this contract. */
8
- title?: string;
8
+ title?:string;
9
9
  /** Value that configures or reports description for this contract. */
10
- description?: string;
10
+ description?:string;
11
11
  /** Value that configures or reports body for this contract. */
12
- body?: string;
12
+ body?:string;
13
13
  /** Persisted annotations in a full-item JSON round trip, checked under the item lock. */
14
- documentAnnotationSnapshot?: Partial<Record<"comments" | "notes" | "learnings", unknown[]>>;
14
+ documentAnnotationSnapshot?:Partial<Record<"comments" | "notes" | "learnings",unknown[]>>;
15
15
  /** Lifecycle state reported for status. */
16
- status?: string;
16
+ status?:string;
17
17
  /** Value that configures or reports close reason for this contract. */
18
- closeReason?: string;
18
+ closeReason?:string;
19
19
  /** Correct the actual completion time on a terminal item. */
20
- completedAt?: string;
20
+ completedAt?:string;
21
21
  /** Value that configures or reports priority for this contract. */
22
- priority?: string | number;
22
+ priority?:string | number;
23
23
  /** Schema type that determines the shape and validation rules for this value. */
24
- type?: string;
24
+ type?:string;
25
25
  /** Value that configures or reports tags for this contract. */
26
- tags?: string;
26
+ tags?:string;
27
27
  /** Value that configures or reports add tags for this contract. */
28
- addTags?: string[];
28
+ addTags?:string[];
29
29
  /** Value that configures or reports remove tags for this contract. */
30
- removeTags?: string[];
30
+ removeTags?:string[];
31
31
  /** Acceptance criteria appended individually without replacing the existing list. */
32
- addAc?: string[];
32
+ addAc?:string[];
33
33
  /** Acceptance criteria removed individually by exact text match. */
34
- removeAc?: string[];
34
+ removeAc?:string[];
35
35
  /** Value that configures or reports force for this contract. */
36
- force?: boolean;
36
+ force?:boolean;
37
37
  /** Permit an intentional unresolved parent reference under strict validation. */
38
- allowMissingParent?: boolean;
38
+ allowMissingParent?:boolean;
39
39
  /** Explicitly permit unresolved local dependency targets with warning receipts. */
40
- allowUnresolvedDeps?: boolean;
40
+ allowUnresolvedDeps?:boolean;
41
41
  /** Value that configures or reports dep remove for this contract. */
42
- depRemove?: string[];
42
+ depRemove?:string[];
43
43
  /** Value that configures or reports replace deps for this contract. */
44
- replaceDeps?: boolean;
44
+ replaceDeps?:boolean;
45
45
  /** Value that configures or reports replace tests for this contract. */
46
- replaceTests?: boolean;
46
+ replaceTests?:boolean;
47
47
  /** Atomically replace linked files with the supplied file entries. */
48
- replaceFiles?: boolean;
48
+ replaceFiles?:boolean;
49
49
  /** Atomically replace linked docs with the supplied doc entries. */
50
- replaceDocs?: boolean;
50
+ replaceDocs?:boolean;
51
51
  /** Value that configures or reports runtime field commands for this contract. */
52
- runtimeFieldCommands?: Array<"update" | "update_many">;
53
- [key: string]: unknown;
52
+ runtimeFieldCommands?:Array<"update" | "update_many">;
53
+ [key:string]:unknown;
54
54
  }
55
55
  /** Presentation-neutral input accepted by the SDK-owned update operation. */
56
56
  export type UpdateOperationOptions = UpdateCommandOptions;
57
57
  /** Documents the update result payload exchanged by command, SDK, and package integrations. */
58
58
  export interface UpdateResult {
59
59
  /** Value that configures or reports item for this contract. */
60
- item: Record<string, unknown>;
60
+ item:Record<string,unknown>;
61
61
  /** Value that configures or reports changed fields for this contract. */
62
- changed_fields: string[];
62
+ changed_fields:string[];
63
63
  /** Value that configures or reports warnings for this contract. */
64
- warnings: string[];
64
+ warnings:string[];
65
65
  }
66
66
  /** Terminal evidence captured atomically before a recurrence transition. */
67
67
  export interface PreviousTerminalEvidence {
68
68
  /** Prior close reason, when recorded. */
69
- close_reason?: string;
69
+ close_reason?:string;
70
70
  /** Prior structured resolution, when recorded. */
71
- resolution?: string;
71
+ resolution?:string;
72
72
  /** Prior expected result, when recorded. */
73
- expected_result?: string;
73
+ expected_result?:string;
74
74
  /** Prior actual result, when recorded. */
75
- actual_result?: string;
75
+ actual_result?:string;
76
76
  /** Prior fixed version, when recorded. */
77
- fixed_version?: string;
77
+ fixed_version?:string;
78
78
  }
79
79
  /** Internal update-path receipt consumed by the public recurrence primitive. */
80
80
  export interface ReopenUpdateReceipt {
81
81
  /** Recurrence reason stored in immutable history context. */
82
- reason: string;
82
+ reason:string;
83
83
  /** Terminal status observed while holding the item lock. */
84
- from_status: string;
84
+ from_status:string;
85
85
  /** Active status written by the update path. */
86
- to_status: string;
86
+ to_status:string;
87
87
  /** Terminal evidence removed from active metadata but retained in history. */
88
- previous_terminal: PreviousTerminalEvidence;
88
+ previous_terminal:PreviousTerminalEvidence;
89
89
  }
90
90
  /** Update result carrying the recurrence receipt produced by the locked transition. */
91
91
  export interface ReopenUpdateResult extends UpdateResult {
92
92
  /** Lifecycle-specific receipt populated by the recurrence primitive. */
93
- lifecycle_transition: ReopenUpdateReceipt;
93
+ lifecycle_transition:ReopenUpdateReceipt;
94
94
  }
95
- declare function normalizeLegacyNoneUpdateOptions(options: UpdateCommandOptions): UpdateCommandOptions;
96
- declare function parseUpdateUnsetTargets(raw: string[] | undefined, runtimeFieldRegistry?: RuntimeFieldRegistry, extensionFieldNames?: readonly string[]): {
97
- metadataKeys: Set<string>;
98
- optionKeys: Set<string>;
95
+ declare function normalizeLegacyNoneUpdateOptions(options:UpdateCommandOptions):UpdateCommandOptions;
96
+ declare function parseUpdateUnsetTargets(raw:string[] | undefined,runtimeFieldRegistry?:RuntimeFieldRegistry,extensionFieldNames?:readonly string[]):{
97
+ metadataKeys:Set<string>;
98
+ optionKeys:Set<string>;
99
99
  };
100
- declare function buildOwnershipBypassRestrictedOptionsError(params: {
101
- id: string;
102
- code: string;
103
- message: string;
104
- required: string;
105
- why: string;
106
- disallowedFlags: string[];
107
- }): PmCliError;
108
- declare function enforceOwnershipBypassScope(id: string, options: UpdateCommandOptions, clearItemMetadataKeys: Set<string>): void;
100
+ declare function buildOwnershipBypassRestrictedOptionsError(params:{
101
+ id:string;
102
+ code:string;
103
+ message:string;
104
+ required:string;
105
+ why:string;
106
+ disallowedFlags:string[];
107
+ }):PmCliError;
108
+ declare function enforceOwnershipBypassScope(id:string,options:UpdateCommandOptions,clearItemMetadataKeys:Set<string>):void;
109
109
  /** Enforce per-type allowed-transition rules (governance.workflow_enforcement). `off` (default) or an unrestricted type is a no-op. `strict` throws on a disallowed transition; `warn` returns a warning string surfaced on the update result. The target status is the raw `--status` value (resolved case-insensitively through the registry inside evaluateTransition). */
110
- declare function enforceTypeWorkflowTransition(params: {
111
- enforcement: GovernanceWorkflowEnforcement;
112
- typeWorkflows: NormalizedTypeWorkflow[];
113
- statusRegistry: RuntimeStatusRegistry;
114
- typeName: string;
115
- fromStatus: string;
116
- toStatus: string;
117
- }): string | undefined;
110
+ declare function enforceTypeWorkflowTransition(params:{
111
+ enforcement:GovernanceWorkflowEnforcement;
112
+ typeWorkflows:NormalizedTypeWorkflow[];
113
+ statusRegistry:RuntimeStatusRegistry;
114
+ typeName:string;
115
+ fromStatus:string;
116
+ toStatus:string;
117
+ }):string | undefined;
118
118
  interface ParsedDependencyUpdates {
119
- additions: Dependency[];
119
+ additions:Dependency[];
120
120
  }
121
121
  interface DependencyRemovalSelector {
122
- id: string;
123
- kind?: string;
124
- source_kind?: string;
125
- author?: string;
126
- created_at?: string;
122
+ id:string;
123
+ kind?:string;
124
+ source_kind?:string;
125
+ author?:string;
126
+ created_at?:string;
127
127
  }
128
128
  /** Parse dependency additions into their canonical storage representation. */
129
- export declare function parseDependencyAdditions(raw: string[] | undefined, prefix: string, nowIso: string, fallbackAuthor: string): ParsedDependencyUpdates;
130
- declare function parseDependencyRemovals(raw: string[] | undefined, prefix: string): DependencyRemovalSelector[];
131
- declare function reconcileBlockedByDependency(current: Dependency[] | undefined, nextBlockedById: string | undefined, nowIsoValue: string, author: string): {
132
- dependencies: Dependency[] | undefined;
133
- changed: boolean;
129
+ export declare function parseDependencyAdditions(raw:string[] | undefined,prefix:string,nowIso:string,fallbackAuthor:string):ParsedDependencyUpdates;
130
+ declare function parseDependencyRemovals(raw:string[] | undefined,prefix:string):DependencyRemovalSelector[];
131
+ declare function reconcileBlockedByDependency(current:Dependency[] | undefined,nextBlockedById:string | undefined,nowIsoValue:string,author:string):{
132
+ dependencies:Dependency[] | undefined;
133
+ changed:boolean;
134
134
  };
135
- declare function matchesDependencySelector(value: Dependency, selector: DependencyRemovalSelector): boolean;
136
- declare function normalizeUpdatePolicyOptionKey(raw: string, typeName: string): string;
137
- declare function collectProvidedUpdatePolicyOptions(options: UpdateCommandOptions, runtimeFieldRegistry: RuntimeFieldRegistry, extensionFieldNames: readonly string[]): Set<string>;
135
+ declare function matchesDependencySelector(value:Dependency,selector:DependencyRemovalSelector):boolean;
136
+ declare function normalizeUpdatePolicyOptionKey(raw:string,typeName:string):string;
137
+ declare function collectProvidedUpdatePolicyOptions(options:UpdateCommandOptions,runtimeFieldRegistry:RuntimeFieldRegistry,extensionFieldNames:readonly string[]):Set<string>;
138
138
  interface UpdateMutationContext {
139
- options: UpdateCommandOptions;
140
- settings: Awaited<ReturnType<typeof readSettings>>;
141
- typeRegistry: ReturnType<typeof resolveItemTypeRegistry>;
142
- statusRegistry: RuntimeStatusRegistry;
143
- runtimeFieldRegistry: RuntimeFieldRegistry;
144
- extensionRegistrations: ReturnType<typeof getActiveExtensionRegistrations>;
145
- extensionFieldNames: readonly string[];
146
- clearItemMetadataKeys: ReadonlySet<string>;
147
- dependencyUpdates: ParsedDependencyUpdates;
148
- dependencyRemovals: DependencyRemovalSelector[];
149
- commentUpdates: ReturnType<typeof parseLogSeed>;
150
- noteUpdates: ReturnType<typeof parseLogSeed>;
151
- learningUpdates: ReturnType<typeof parseLogSeed>;
152
- fileUpdates: ReturnType<typeof parseFiles>;
153
- testUpdates: ReturnType<typeof parseTests>;
154
- docUpdates: ReturnType<typeof parseDocs>;
155
- resolvedParentValue: string | undefined;
156
- resolvedBlockedByDependencyId: string | undefined;
157
- runtimeFieldUpdates: Record<string, unknown>;
158
- nowValue: Date;
159
- nowIso: string;
160
- author: string;
161
- pmRoot: string;
139
+ options:UpdateCommandOptions;
140
+ settings:Awaited<ReturnType<typeof readSettings>>;
141
+ typeRegistry:ReturnType<typeof resolveItemTypeRegistry>;
142
+ statusRegistry:RuntimeStatusRegistry;
143
+ runtimeFieldRegistry:RuntimeFieldRegistry;
144
+ extensionRegistrations:ReturnType<typeof getActiveExtensionRegistrations>;
145
+ extensionFieldNames:readonly string[];
146
+ clearItemMetadataKeys:ReadonlySet<string>;
147
+ dependencyUpdates:ParsedDependencyUpdates;
148
+ dependencyRemovals:DependencyRemovalSelector[];
149
+ commentUpdates:ReturnType<typeof parseLogSeed>;
150
+ noteUpdates:ReturnType<typeof parseLogSeed>;
151
+ learningUpdates:ReturnType<typeof parseLogSeed>;
152
+ fileUpdates:ReturnType<typeof parseFiles>;
153
+ testUpdates:ReturnType<typeof parseTests>;
154
+ docUpdates:ReturnType<typeof parseDocs>;
155
+ resolvedParentValue:string | undefined;
156
+ resolvedBlockedByDependencyId:string | undefined;
157
+ runtimeFieldUpdates:Record<string,unknown>;
158
+ nowValue:Date;
159
+ nowIso:string;
160
+ author:string;
161
+ pmRoot:string;
162
162
  }
163
163
  /** Resolve update stdin tokens once while preserving transport-marked literals. */
164
- export declare function resolveUpdateTransportOptions(options: UpdateCommandOptions): Promise<UpdateCommandOptions>;
164
+ export declare function resolveUpdateTransportOptions(options:UpdateCommandOptions):Promise<UpdateCommandOptions>;
165
165
  /** Validate mutually exclusive and required update mutation option combinations. */
166
- export declare function assertUpdateMutationOptionCombinations(options: UpdateCommandOptions): void;
167
- type UpdateStatusMutationContext = Pick<UpdateMutationContext, "options" | "statusRegistry" | "clearItemMetadataKeys" | "nowIso">;
168
- declare function applyStatusAndCloseReasonMutations(document: ItemDocument, context: UpdateStatusMutationContext, previousStatusNormalized: string, changedFields: string[]): void;
166
+ export declare function assertUpdateMutationOptionCombinations(options:UpdateCommandOptions):void;
167
+ type UpdateStatusMutationContext = Pick<UpdateMutationContext,"options" | "statusRegistry" | "clearItemMetadataKeys" | "nowIso">;
168
+ declare function applyStatusAndCloseReasonMutations(document:ItemDocument,context:UpdateStatusMutationContext,previousStatusNormalized:string,changedFields:string[]):void;
169
169
  /** Implements run update for the public runtime surface of this module. */
170
- export declare function runUpdate(id: string, options: UpdateCommandOptions, global: GlobalOptions): Promise<UpdateResult>;
170
+ export declare function runUpdate(id:string,options:UpdateCommandOptions,global:GlobalOptions):Promise<UpdateResult>;
171
171
  /** Execute a recurrence transition through the exact atomic update pipeline. */
172
- export declare function runReopenUpdate(id: string, options: UpdateCommandOptions, global: GlobalOptions, recurrenceReason: string): Promise<ReopenUpdateResult>;
172
+ export declare function runReopenUpdate(id:string,options:UpdateCommandOptions,global:GlobalOptions,recurrenceReason:string):Promise<ReopenUpdateResult>;
173
173
  /** Public contract for test only update command, shared by SDK and presentation-layer consumers. */
174
- export declare const _testOnlyUpdateCommand: {
175
- applyStatusAndCloseReasonMutations: typeof applyStatusAndCloseReasonMutations;
176
- collectProvidedUpdatePolicyOptions: typeof collectProvidedUpdatePolicyOptions;
177
- buildOwnershipBypassRestrictedOptionsError: typeof buildOwnershipBypassRestrictedOptionsError;
178
- enforceOwnershipBypassScope: typeof enforceOwnershipBypassScope;
179
- enforceTypeWorkflowTransition: typeof enforceTypeWorkflowTransition;
180
- matchesDependencySelector: typeof matchesDependencySelector;
181
- normalizeLegacyNoneUpdateOptions: typeof normalizeLegacyNoneUpdateOptions;
182
- normalizeUpdatePolicyOptionKey: typeof normalizeUpdatePolicyOptionKey;
183
- parseDependencyAdditions: typeof parseDependencyAdditions;
184
- parseDependencyRemovals: typeof parseDependencyRemovals;
185
- parseUpdateUnsetTargets: typeof parseUpdateUnsetTargets;
186
- reconcileBlockedByDependency: typeof reconcileBlockedByDependency;
187
- resolveRuntimeUnsetDefinition: (token: string, registry: RuntimeFieldRegistry | undefined) => import("./shared-unset-fields.js").RuntimeUnsetFieldDefinition | undefined;
174
+ export declare const _testOnlyUpdateCommand:{
175
+ applyStatusAndCloseReasonMutations:typeof applyStatusAndCloseReasonMutations;
176
+ collectProvidedUpdatePolicyOptions:typeof collectProvidedUpdatePolicyOptions;
177
+ buildOwnershipBypassRestrictedOptionsError:typeof buildOwnershipBypassRestrictedOptionsError;
178
+ enforceOwnershipBypassScope:typeof enforceOwnershipBypassScope;
179
+ enforceTypeWorkflowTransition:typeof enforceTypeWorkflowTransition;
180
+ matchesDependencySelector:typeof matchesDependencySelector;
181
+ normalizeLegacyNoneUpdateOptions:typeof normalizeLegacyNoneUpdateOptions;
182
+ normalizeUpdatePolicyOptionKey:typeof normalizeUpdatePolicyOptionKey;
183
+ parseDependencyAdditions:typeof parseDependencyAdditions;
184
+ parseDependencyRemovals:typeof parseDependencyRemovals;
185
+ parseUpdateUnsetTargets:typeof parseUpdateUnsetTargets;
186
+ reconcileBlockedByDependency:typeof reconcileBlockedByDependency;
187
+ resolveRuntimeUnsetDefinition:(token:string,registry:RuntimeFieldRegistry | undefined) => import("./shared-unset-fields.js").RuntimeUnsetFieldDefinition | undefined;
188
188
  };
189
189
  export {};
@@ -3,43 +3,43 @@
3
3
  *
4
4
  * Resolves actual-completion timestamps and plans evidence-only legacy backfills.
5
5
  */
6
- import type { HistoryEntry, ItemMetadata } from "../types/index.js";
6
+ import type { HistoryEntry,ItemMetadata } from "../types/index.js";
7
7
  /** Provenance of the timestamp selected for completion-aware reporting. */
8
8
  export type CompletionTimestampSource = "completed_at" | "closed_at" | "updated_at";
9
9
  /** A resolved completion timestamp together with its explicit compatibility source. */
10
10
  export interface ResolvedCompletionTimestamp {
11
11
  /** Discriminator proving that timestamp and source are present. */
12
- resolved: true;
12
+ resolved:true;
13
13
  /** ISO timestamp selected for reporting. */
14
- timestamp: string;
14
+ timestamp:string;
15
15
  /** Metadata field that supplied the timestamp. */
16
- source: CompletionTimestampSource;
16
+ source:CompletionTimestampSource;
17
17
  /** Whether a legacy fallback was required. */
18
- fallback: boolean;
18
+ fallback:boolean;
19
19
  }
20
20
  /** Explicit outcome when legacy metadata contains no completion timestamp. */
21
21
  export interface UnresolvedCompletionTimestamp {
22
22
  /** Discriminator proving that no metadata field supplied a timestamp. */
23
- resolved: false;
23
+ resolved:false;
24
24
  /** Resolved-only timestamp is impossible on this branch. */
25
- timestamp?: never;
25
+ timestamp?:never;
26
26
  /** Resolved-only provenance is impossible on this branch. */
27
- source?: never;
27
+ source?:never;
28
28
  /** Fallback disclosure is meaningful only after a field supplied a value. */
29
- fallback?: never;
29
+ fallback?:never;
30
30
  }
31
31
  /** Exhaustive completion-time resolution result. */
32
32
  export type CompletionTimestampResolution = ResolvedCompletionTimestamp | UnresolvedCompletionTimestamp;
33
33
  /** One lossless backfill supported by terminal-transition history evidence. */
34
34
  export interface CompletedAtBackfillCandidate {
35
35
  /** Item whose missing completed_at can be corrected. */
36
- id: string;
36
+ id:string;
37
37
  /** Evidence-backed timestamp proposed for completed_at. */
38
- completed_at: string;
38
+ completed_at:string;
39
39
  /** History operation that recorded the terminal transition. */
40
- history_op: string;
40
+ history_op:string;
41
41
  }
42
42
  /** Resolve reporting time while disclosing every legacy fallback. */
43
- export declare function resolveCompletionTimestamp(item: Partial<Pick<ItemMetadata, "completed_at" | "closed_at" | "updated_at">>): CompletionTimestampResolution;
43
+ export declare function resolveCompletionTimestamp(item:Partial<Pick<ItemMetadata,"completed_at" | "closed_at" | "updated_at">>):CompletionTimestampResolution;
44
44
  /** Plan only backfills proven by a transition into a terminal status. */
45
- export declare function planCompletedAtBackfill(items: readonly ItemMetadata[], historyById: ReadonlyMap<string, readonly HistoryEntry[]>, terminalStatuses: ReadonlySet<string>): CompletedAtBackfillCandidate[];
45
+ export declare function planCompletedAtBackfill(items:readonly ItemMetadata[],historyById:ReadonlyMap<string,readonly HistoryEntry[]>,terminalStatuses:ReadonlySet<string>):CompletedAtBackfillCandidate[];
@@ -5,87 +5,87 @@ export type TerminalReasonSource = "explicit" | "duplicate" | "resolution" | "me
5
5
  /** Controls lifecycle semantics independently of CLI flag parsing. */
6
6
  export interface TerminalTransitionPolicy {
7
7
  /** Refuse terminal transitions that do not carry an author-controlled reason. */
8
- requireCloseReason: boolean;
8
+ requireCloseReason:boolean;
9
9
  /** Decide whether predecessor edges remain queryable after terminal transition. */
10
- orderingEdges: "preserve" | "remove";
10
+ orderingEdges:"preserve" | "remove";
11
11
  }
12
12
  /** Presentation-independent options for the public close-item operation. */
13
13
  export interface CloseOperationOptions {
14
14
  /** Author recorded in immutable history. */
15
- author?: string;
15
+ author?:string;
16
16
  /** Human-readable history message. */
17
- message?: string;
17
+ message?:string;
18
18
  /** Closure validation mode. */
19
- validateClose?: string;
19
+ validateClose?:string;
20
20
  /** Permit an intentional repeat terminal transition. */
21
- force?: boolean;
21
+ force?:boolean;
22
22
  /** Structured resolution evidence. */
23
- resolution?: string;
23
+ resolution?:string;
24
24
  /** Expected outcome evidence. */
25
- expectedResult?: string;
25
+ expectedResult?:string;
26
26
  /** Actual outcome evidence. */
27
- actualResult?: string;
27
+ actualResult?:string;
28
28
  /** Canonical item when closing a duplicate. */
29
- duplicateOf?: string;
29
+ duplicateOf?:string;
30
30
  /** Actual completion time, distinct from tracker mutation time. */
31
- completedAt?: string;
31
+ completedAt?:string;
32
32
  /** SDK-only lifecycle overrides; CLI and MCP use workspace defaults. */
33
- lifecyclePolicy?: Partial<TerminalTransitionPolicy>;
33
+ lifecyclePolicy?:Partial<TerminalTransitionPolicy>;
34
34
  }
35
35
  /** Result returned by the public close-item operation. */
36
36
  export interface CloseOperationResult {
37
37
  /** Closed item projected as a stable record. */
38
- item: Record<string, unknown>;
38
+ item:Record<string,unknown>;
39
39
  /** Metadata fields changed by the transition. */
40
- changed_fields: string[];
40
+ changed_fields:string[];
41
41
  /** Evidence-only update guidance when a successful warning close leaves acceptance fields missing. */
42
- recovery?: PmCliErrorRecoveryPayload;
42
+ recovery?:PmCliErrorRecoveryPayload;
43
43
  /** Validation and lifecycle policy receipts. */
44
- warnings: string[];
44
+ warnings:string[];
45
45
  }
46
46
  /** Candidate author-controlled sources for one terminal transition reason. */
47
47
  export interface TerminalReasonInput {
48
48
  /** Explicit reason supplied by the operation caller. */
49
- explicit?: string;
49
+ explicit?:string;
50
50
  /** Canonical item id when this transition closes a duplicate. */
51
- duplicateOf?: string;
51
+ duplicateOf?:string;
52
52
  /** Structured resolution supplied by the caller. */
53
- resolution?: string;
53
+ resolution?:string;
54
54
  /** History message supplied by the caller. */
55
- message?: string;
55
+ message?:string;
56
56
  }
57
57
  /** Resolved terminal reason together with durable source provenance. */
58
58
  export interface TerminalReasonResolution {
59
59
  /** Normalized author-controlled reason, if one was supplied. */
60
- closeReason?: string;
60
+ closeReason?:string;
61
61
  /** Field that supplied the resolved reason. */
62
- source: TerminalReasonSource;
62
+ source:TerminalReasonSource;
63
63
  }
64
64
  /** Presentation context used to make terminal-policy recovery actionable. */
65
65
  export interface TerminalReasonRecoveryContext {
66
66
  /** Operation whose input failed terminal-reason governance. */
67
- operation: "close" | "create";
67
+ operation:"close" | "create";
68
68
  /** Terminal status requested by a create operation. */
69
- status?: string;
69
+ status?:string;
70
70
  }
71
71
  /** Result of applying ordering-edge lifecycle policy to mutable item metadata. */
72
72
  export interface TerminalOrderingMutation {
73
73
  /** Metadata fields changed by the policy. */
74
- changedFields: string[];
74
+ changedFields:string[];
75
75
  /** Agent-readable policy receipts emitted by the operation. */
76
- warnings: string[];
76
+ warnings:string[];
77
77
  }
78
78
  /** Default terminal policy shared by CLI, SDK, and MCP operations. */
79
- export declare const DEFAULT_TERMINAL_TRANSITION_POLICY: Readonly<TerminalTransitionPolicy>;
79
+ export declare const DEFAULT_TERMINAL_TRANSITION_POLICY:Readonly<TerminalTransitionPolicy>;
80
80
  /** Resolve the first author-controlled terminal reason in canonical precedence order. */
81
- export declare function resolveTerminalReason(input: TerminalReasonInput): TerminalReasonResolution;
81
+ export declare function resolveTerminalReason(input:TerminalReasonInput):TerminalReasonResolution;
82
82
  /** Enforce close-reason governance without inventing immutable history content. */
83
- export declare function requireTerminalReason(input: TerminalReasonInput, required: boolean): TerminalReasonResolution;
83
+ export declare function requireTerminalReason(input:TerminalReasonInput,required:boolean):TerminalReasonResolution;
84
84
  /** Enforce close-reason governance with recovery for a specific operation. */
85
- export declare function requireTerminalReasonWithRecovery(input: TerminalReasonInput, required: boolean, recovery: TerminalReasonRecoveryContext): TerminalReasonResolution;
85
+ export declare function requireTerminalReasonWithRecovery(input:TerminalReasonInput,required:boolean,recovery:TerminalReasonRecoveryContext):TerminalReasonResolution;
86
86
  /**
87
87
  * Apply terminal ordering policy while clearing only transient blocked-state
88
88
  * scalars. Preserving `blocked_by` dependency rows keeps predecessor history
89
89
  * available to graph traversal after the dependent item closes.
90
90
  */
91
- export declare function applyTerminalOrderingPolicy(metadata: ItemMetadata, policy: Pick<TerminalTransitionPolicy, "orderingEdges">): TerminalOrderingMutation;
91
+ export declare function applyTerminalOrderingPolicy(metadata:ItemMetadata,policy:Pick<TerminalTransitionPolicy,"orderingEdges">):TerminalOrderingMutation;