@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,262 +1,262 @@
1
1
  import { type GlobalOptions } from "../runtime-primitives.js";
2
- import type { DependencyKind, ItemMetadata, PlanDecision, PlanDiscovery, PlanHarness, PlanMode, PlanStep, PlanStepStatus, PlanValidationCheck } from "../../types/index.js";
3
- import type { MutationMetadataCommandOptions, SharedLinkedResourceOptions } from "./mutation-command-options.js";
2
+ import type { DependencyKind,ItemMetadata,PlanDecision,PlanDiscovery,PlanHarness,PlanMode,PlanStep,PlanStepStatus,PlanValidationCheck } from "../../types/index.js";
3
+ import type { MutationMetadataCommandOptions,SharedLinkedResourceOptions } from "./mutation-command-options.js";
4
4
  import { type PlanMutationReceipt } from "./plan-mutation-receipt.js";
5
5
  /** Public contract for plan subcommands, shared by SDK and presentation-layer consumers. */
6
- export declare const PLAN_SUBCOMMANDS: readonly ["create", "show", "add-step", "update-step", "complete-step", "block-step", "reorder-step", "remove-step", "link", "unlink", "decision", "discovery", "validation", "resume", "approve", "materialize"];
6
+ export declare const PLAN_SUBCOMMANDS:readonly ["create","show","add-step","update-step","complete-step","block-step","reorder-step","remove-step","link","unlink","decision","discovery","validation","resume","approve","materialize"];
7
7
  /** Restricts plan subcommand values accepted by command, SDK, and storage contracts. */
8
8
  export type PlanSubcommand = (typeof PLAN_SUBCOMMANDS)[number];
9
9
  /** Supported values accepted by the plan show depth contract. */
10
- export declare const PLAN_SHOW_DEPTH_VALUES: readonly ["brief", "standard", "deep"];
10
+ export declare const PLAN_SHOW_DEPTH_VALUES:readonly ["brief","standard","deep"];
11
11
  /** Restricts plan show depth values accepted by command, SDK, and storage contracts. */
12
12
  export type PlanShowDepth = (typeof PLAN_SHOW_DEPTH_VALUES)[number];
13
13
  /** Documents the plan command options payload exchanged by command, SDK, and package integrations. */
14
- export interface PlanCommandOptions extends Omit<MutationMetadataCommandOptions, "author" | "blockedBy" | "message" | "parent">, Omit<SharedLinkedResourceOptions, "dep" | "doc" | "field" | "file" | "test"> {
14
+ export interface PlanCommandOptions extends Omit<MutationMetadataCommandOptions,"author" | "blockedBy" | "message" | "parent">,Omit<SharedLinkedResourceOptions,"dep" | "doc" | "field" | "file" | "test"> {
15
15
  /** Value that configures or reports title for this contract. */
16
- title?: string;
16
+ title?:string;
17
17
  /** Value that configures or reports description for this contract. */
18
- description?: string;
18
+ description?:string;
19
19
  /** Value that configures or reports scope for this contract. */
20
- scope?: string;
20
+ scope?:string;
21
21
  /** Value that configures or reports parent for this contract. */
22
- parent?: string;
22
+ parent?:string;
23
23
  /** Value that configures or reports related for this contract. */
24
- related?: string | string[];
24
+ related?:string | string[];
25
25
  /** Value that configures or reports blocks for this contract. */
26
- blocks?: string | string[];
26
+ blocks?:string | string[];
27
27
  /** Value that configures or reports blocked by for this contract. */
28
- blockedBy?: string | string[];
28
+ blockedBy?:string | string[];
29
29
  /** Value that configures or reports harness for this contract. */
30
- harness?: string;
30
+ harness?:string;
31
31
  /** Value that configures or reports mode for this contract. */
32
- mode?: string;
32
+ mode?:string;
33
33
  /** Value that configures or reports resume context for this contract. */
34
- resumeContext?: string;
34
+ resumeContext?:string;
35
35
  /** Value that configures or reports tags for this contract. */
36
- tags?: string;
36
+ tags?:string;
37
37
  /** Value that configures or reports priority for this contract. */
38
- priority?: string;
38
+ priority?:string;
39
39
  /** Lifecycle status used when creating the Plan item. */
40
- status?: string;
40
+ status?:string;
41
41
  /** Required-option policy used when creating the Plan item. */
42
- createMode?: string;
42
+ createMode?:string;
43
43
  /** Value that configures or reports body for this contract. */
44
- body?: string;
44
+ body?:string;
45
45
  /** Value that configures or reports claim for this contract. */
46
- claim?: boolean;
46
+ claim?:boolean;
47
47
  /** Value that configures or reports from search for this contract. */
48
- fromSearch?: string;
48
+ fromSearch?:string;
49
49
  /** Value that configures or reports step title for this contract. */
50
- stepTitle?: string;
50
+ stepTitle?:string;
51
51
  /** pm-6mit: repeatable --step values. On create each value seeds one ordered step (argv order; values are never comma-split so titles may contain commas). On other subcommands a single value aliases stepTitle. */
52
- step?: string | string[];
52
+ step?:string | string[];
53
53
  /** Value that configures or reports step body for this contract. */
54
- stepBody?: string;
54
+ stepBody?:string;
55
55
  /** Value that configures or reports step owner for this contract. */
56
- stepOwner?: string;
56
+ stepOwner?:string;
57
57
  /** Lifecycle status of the referenced plan step. */
58
- stepStatus?: string;
58
+ stepStatus?:string;
59
59
  /** Value that configures or reports step evidence for this contract. */
60
- stepEvidence?: string;
60
+ stepEvidence?:string;
61
61
  /** Value that configures or reports step blocked reason for this contract. */
62
- stepBlockedReason?: string;
62
+ stepBlockedReason?:string;
63
63
  /** Value that configures or reports step replacement for this contract. */
64
- stepReplacement?: string;
64
+ stepReplacement?:string;
65
65
  /** Value that configures or reports depends on for this contract. */
66
- dependsOn?: string | string[];
66
+ dependsOn?:string | string[];
67
67
  /** Value that configures or reports link for this contract. */
68
- link?: string | string[];
68
+ link?:string | string[];
69
69
  /** Value that configures or reports link kind for this contract. */
70
- linkKind?: string;
70
+ linkKind?:string;
71
71
  /** Value that configures or reports link note for this contract. */
72
- linkNote?: string;
72
+ linkNote?:string;
73
73
  /** Value that configures or reports promote to item dep for this contract. */
74
- promoteToItemDep?: boolean;
74
+ promoteToItemDep?:boolean;
75
75
  /** Value that configures or reports allow multiple active for this contract. */
76
- allowMultipleActive?: boolean;
76
+ allowMultipleActive?:boolean;
77
77
  /** Value that configures or reports file for this contract. */
78
- file?: string | string[];
78
+ file?:string | string[];
79
79
  /** Value that configures or reports test for this contract. */
80
- test?: string | string[];
80
+ test?:string | string[];
81
81
  /** Value that configures or reports doc for this contract. */
82
- doc?: string | string[];
82
+ doc?:string | string[];
83
83
  /** Value that configures or reports decision text for this contract. */
84
- decisionText?: string;
84
+ decisionText?:string;
85
85
  /** Value that configures or reports decision for this contract. */
86
- decision?: string;
86
+ decision?:string;
87
87
  /** Value that configures or reports decision rationale for this contract. */
88
- decisionRationale?: string;
88
+ decisionRationale?:string;
89
89
  /** Value that configures or reports decision evidence for this contract. */
90
- decisionEvidence?: string;
90
+ decisionEvidence?:string;
91
91
  /** Value that configures or reports discovery text for this contract. */
92
- discoveryText?: string;
92
+ discoveryText?:string;
93
93
  /** Value that configures or reports discovery for this contract. */
94
- discovery?: string;
94
+ discovery?:string;
95
95
  /** Value that configures or reports validation text for this contract. */
96
- validationText?: string;
96
+ validationText?:string;
97
97
  /** Value that configures or reports validation for this contract. */
98
- validation?: string;
98
+ validation?:string;
99
99
  /** Value that configures or reports validation command for this contract. */
100
- validationCommand?: string;
100
+ validationCommand?:string;
101
101
  /** Value that configures or reports validation expected for this contract. */
102
- validationExpected?: string;
102
+ validationExpected?:string;
103
103
  /** Value that configures or reports depth for this contract. */
104
- depth?: string;
104
+ depth?:string;
105
105
  /** Value that configures or reports fields for this contract. */
106
- fields?: string;
106
+ fields?:string;
107
107
  /** Value that configures or reports steps for this contract. */
108
- steps?: string;
108
+ steps?:string;
109
109
  /** Value that configures or reports template for this contract. */
110
- template?: string;
110
+ template?:string;
111
111
  /** Schema type that determines the shape and validation rules for this value. */
112
- materializeType?: string;
112
+ materializeType?:string;
113
113
  /** Value that configures or reports materialize parent for this contract. */
114
- materializeParent?: string;
114
+ materializeParent?:string;
115
115
  /** Value that configures or reports materialize tags for this contract. */
116
- materializeTags?: string;
116
+ materializeTags?:string;
117
117
  /** Custom field values forwarded to every materialized item as `name=value` pairs. */
118
- field?: string | string[];
118
+ field?:string | string[];
119
119
  /** Value that configures or reports author for this contract. */
120
- author?: string;
120
+ author?:string;
121
121
  /** Human-readable explanation suitable for logs and agent-facing output. */
122
- message?: string;
122
+ message?:string;
123
123
  /** Value that configures or reports force for this contract. */
124
- force?: boolean;
124
+ force?:boolean;
125
125
  }
126
126
  /** Presentation-neutral input accepted by SDK-owned planning operations. */
127
127
  export type PlanOperationOptions = PlanCommandOptions;
128
128
  /** Documents the plan command result payload exchanged by command, SDK, and package integrations. */
129
129
  export interface PlanCommandResult {
130
130
  /** Bounded acknowledgement for mutations; full typed Plan state remains available alongside it. */
131
- mutation_receipt?: PlanMutationReceipt;
131
+ mutation_receipt?:PlanMutationReceipt;
132
132
  /** Value that configures or reports action for this contract. */
133
- action: PlanSubcommand;
133
+ action:PlanSubcommand;
134
134
  /** Value that configures or reports plan for this contract. */
135
- plan: PlanResultPlan;
135
+ plan:PlanResultPlan;
136
136
  /** Value that configures or reports step for this contract. */
137
- step?: PlanStep;
137
+ step?:PlanStep;
138
138
  /** Value that configures or reports current step for this contract. */
139
- current_step?: PlanStep | undefined;
139
+ current_step?:PlanStep | undefined;
140
140
  /** Value that configures or reports next actions for this contract. */
141
- next_actions?: string[];
141
+ next_actions?:string[];
142
142
  /** Value that configures or reports materialized for this contract. */
143
- materialized?: {
144
- id: string;
145
- title: string;
146
- type: string;
147
- parent?: string;
148
- tags: string[];
149
- from_step: string;
143
+ materialized?:{
144
+ id:string;
145
+ title:string;
146
+ type:string;
147
+ parent?:string;
148
+ tags:string[];
149
+ from_step:string;
150
150
  }[];
151
151
  /** Value that configures or reports materialize skipped for this contract. */
152
- materialize_skipped?: {
153
- from_step: string;
154
- reason: "already_completed" | "already_materialized";
155
- existing_id?: string;
152
+ materialize_skipped?:{
153
+ from_step:string;
154
+ reason:"already_completed" | "already_materialized";
155
+ existing_id?:string;
156
156
  }[];
157
157
  /** Value that configures or reports warnings for this contract. */
158
- warnings: string[];
158
+ warnings:string[];
159
159
  /** ISO 8601 timestamp recording when generated occurred. */
160
- generated_at: string;
160
+ generated_at:string;
161
161
  }
162
162
  /** Documents the plan result plan payload exchanged by command, SDK, and package integrations. */
163
163
  export interface PlanResultPlan {
164
164
  /** Stable identifier used to reference this record across commands and storage. */
165
- id: string;
165
+ id:string;
166
166
  /** Value that configures or reports title for this contract. */
167
- title: string;
167
+ title:string;
168
168
  /** Lifecycle state reported for status. */
169
- status: string;
169
+ status:string;
170
170
  /** Value that configures or reports mode for this contract. */
171
- mode: PlanMode;
171
+ mode:PlanMode;
172
172
  /** Value that configures or reports scope for this contract. */
173
- scope?: string;
173
+ scope?:string;
174
174
  /** Value that configures or reports harness for this contract. */
175
- harness?: PlanHarness;
175
+ harness?:PlanHarness;
176
176
  /** Value that configures or reports parent for this contract. */
177
- parent?: string;
177
+ parent?:string;
178
178
  /** Value that configures or reports resume context for this contract. */
179
- resume_context?: string;
179
+ resume_context?:string;
180
180
  /** Value that configures or reports steps summary for this contract. */
181
- steps_summary: PlanStepSummary;
181
+ steps_summary:PlanStepSummary;
182
182
  /** Value that configures or reports current step for this contract. */
183
- current_step?: {
184
- id: string;
185
- order: number;
186
- title: string;
187
- status: PlanStepStatus;
183
+ current_step?:{
184
+ id:string;
185
+ order:number;
186
+ title:string;
187
+ status:PlanStepStatus;
188
188
  } | undefined;
189
189
  /** Value that configures or reports blocked steps for this contract. */
190
- blocked_steps?: {
191
- id: string;
192
- order: number;
193
- title: string;
194
- blocked_reason?: string;
190
+ blocked_steps?:{
191
+ id:string;
192
+ order:number;
193
+ title:string;
194
+ blocked_reason?:string;
195
195
  }[];
196
196
  /** Value that configures or reports steps for this contract. */
197
- steps?: PlanStep[];
197
+ steps?:PlanStep[];
198
198
  /** Value that configures or reports decisions for this contract. */
199
- decisions?: PlanDecision[];
199
+ decisions?:PlanDecision[];
200
200
  /** Value that configures or reports discoveries for this contract. */
201
- discoveries?: PlanDiscovery[];
201
+ discoveries?:PlanDiscovery[];
202
202
  /** Value that configures or reports validation for this contract. */
203
- validation?: PlanValidationCheck[];
203
+ validation?:PlanValidationCheck[];
204
204
  /** Value that configures or reports linked items for this contract. */
205
- linked_items?: {
206
- id: string;
207
- kind: DependencyKind;
205
+ linked_items?:{
206
+ id:string;
207
+ kind:DependencyKind;
208
208
  }[];
209
209
  }
210
210
  /** Documents the plan step summary payload exchanged by command, SDK, and package integrations. */
211
211
  export interface PlanStepSummary {
212
212
  /** Value that configures or reports total for this contract. */
213
- total: number;
213
+ total:number;
214
214
  /** Value that configures or reports pending for this contract. */
215
- pending: number;
215
+ pending:number;
216
216
  /** Value that configures or reports in progress for this contract. */
217
- in_progress: number;
217
+ in_progress:number;
218
218
  /** Value that configures or reports blocked for this contract. */
219
- blocked: number;
219
+ blocked:number;
220
220
  /** Value that configures or reports completed for this contract. */
221
- completed: number;
221
+ completed:number;
222
222
  /** Value that configures or reports skipped for this contract. */
223
- skipped: number;
223
+ skipped:number;
224
224
  /** Value that configures or reports superseded for this contract. */
225
- superseded: number;
225
+ superseded:number;
226
226
  /** Whole-percent step-completion progress (`round(completed / total * 100)`), surfaced so agents see plan progress without recomputing it (GH-158 #5). */
227
- completion_pct: number;
227
+ completion_pct:number;
228
228
  }
229
229
  /** Public contract for plan template names, shared by SDK and presentation-layer consumers. */
230
- export declare const PLAN_TEMPLATE_NAMES: readonly ["bug-investigation", "feature-implementation", "refactoring-sprint"];
230
+ export declare const PLAN_TEMPLATE_NAMES:readonly ["bug-investigation","feature-implementation","refactoring-sprint"];
231
231
  /** Restricts plan template names accepted by `pm plan create --template` (GH-158 #2). */
232
232
  export type PlanTemplateName = (typeof PLAN_TEMPLATE_NAMES)[number];
233
233
  interface PlanTemplateStepSeed {
234
- title: string;
235
- body: string;
234
+ title:string;
235
+ body:string;
236
236
  }
237
237
  /** Resolves the ordered step seeds for a built-in plan template, rejecting unknown names with the allowed set so agents can self-correct. */
238
- export declare function resolvePlanTemplateSteps(raw: string): PlanTemplateStepSeed[];
238
+ export declare function resolvePlanTemplateSteps(raw:string):PlanTemplateStepSeed[];
239
239
  /** Compare the union of persisted Plan metadata keys so additions, updates, and removals are all audited. */
240
- declare function changedPlanMetadataFields(beforePlanFields: ReadonlyMap<string, string | undefined>, metadata: ItemMetadata): string[];
240
+ declare function changedPlanMetadataFields(beforePlanFields:ReadonlyMap<string,string | undefined>,metadata:ItemMetadata):string[];
241
241
  /** Documents the plan dispatch input payload exchanged by command, SDK, and package integrations. */
242
242
  export interface PlanDispatchInput {
243
243
  /** Value that configures or reports subcommand for this contract. */
244
- subcommand: PlanSubcommand;
244
+ subcommand:PlanSubcommand;
245
245
  /** Stable identifier used to reference this record across commands and storage. */
246
- id?: string;
246
+ id?:string;
247
247
  /** Value that configures or reports step ref for this contract. */
248
- stepRef?: string;
248
+ stepRef?:string;
249
249
  /** Value that configures or reports reorder to for this contract. */
250
- reorderTo?: number;
250
+ reorderTo?:number;
251
251
  /** Value that configures or reports options for this contract. */
252
- options: PlanCommandOptions;
252
+ options:PlanCommandOptions;
253
253
  /** Value that configures or reports global for this contract. */
254
- global: GlobalOptions;
254
+ global:GlobalOptions;
255
255
  }
256
256
  /** Implements run plan for the public runtime surface of this module. */
257
- export declare function runPlan(input: PlanDispatchInput): Promise<PlanCommandResult>;
257
+ export declare function runPlan(input:PlanDispatchInput):Promise<PlanCommandResult>;
258
258
  /** Internal Plan mutation helpers exposed only for branch-complete regression coverage. */
259
- export declare const _testOnlyPlanCommand: {
260
- changedPlanMetadataFields: typeof changedPlanMetadataFields;
259
+ export declare const _testOnlyPlanCommand:{
260
+ changedPlanMetadataFields:typeof changedPlanMetadataFields;
261
261
  };
262
262
  export {};
@@ -14,11 +14,11 @@ import type { RecurrenceRule } from "../../types/index.js";
14
14
  * via the `emptyNumericGuard` option so both call sites keep their exact
15
15
  * behaviour, including error strings.
16
16
  */
17
- export declare function parseEventBoolean(value: string, flag: string): boolean;
17
+ export declare function parseEventBoolean(value:string,flag:string):boolean;
18
18
  /** Implements parse delimited list for the public runtime surface of this module. */
19
- export declare function parseDelimitedList(raw: string | undefined): string[];
19
+ export declare function parseDelimitedList(raw:string | undefined):string[];
20
20
  /** Implements ensure enum value for the public runtime surface of this module. */
21
- export declare function ensureEnumValue<T extends string>(value: string, allowed: readonly T[], label: string, field?: string): T;
21
+ export declare function ensureEnumValue<T extends string>(value:string,allowed:readonly T[],label:string,field?:string):T;
22
22
  /** `"defined"` parses `recur_interval=`/`recur_count=` (empty values), matching the historical `create` behaviour. `"truthy"` skips empty values, matching the historical `update` behaviour. */
23
23
  export type RecurrenceEmptyNumericGuard = "defined" | "truthy";
24
24
  /**
@@ -29,6 +29,6 @@ export type RecurrenceEmptyNumericGuard = "defined" | "truthy";
29
29
  * a new recur key can never be silently rejected (GH-258). Keep in sync with
30
30
  * the `kv.recur_*` reads below.
31
31
  */
32
- export declare const RECURRENCE_CSV_KEYS: readonly ["recur_freq", "recur_interval", "recur_count", "recur_until", "recur_by_weekday", "recur_by_month_day", "recur_exdates"];
32
+ export declare const RECURRENCE_CSV_KEYS:readonly ["recur_freq","recur_interval","recur_count","recur_until","recur_by_weekday","recur_by_month_day","recur_exdates"];
33
33
  /** Implements parse recurrence rule for the public runtime surface of this module. */
34
- export declare function parseRecurrenceRule(kv: Record<string, string>, startAt: string, nowValue: Date, emptyNumericGuard: RecurrenceEmptyNumericGuard): RecurrenceRule | undefined;
34
+ export declare function parseRecurrenceRule(kv:Record<string,string>,startAt:string,nowValue:Date,emptyNumericGuard:RecurrenceEmptyNumericGuard):RecurrenceRule | undefined;
@@ -11,39 +11,39 @@ export type { PreviousTerminalEvidence } from "./update.js";
11
11
  /** Options accepted by the SDK and `pm item reopen` recurrence primitive. */
12
12
  export interface ReopenCommandOptions {
13
13
  /** Active target status; only the workspace open or in-progress status is allowed. */
14
- status?: string;
14
+ status?:string;
15
15
  /** Current active planning expectation, replacing the archived terminal expectation. */
16
- expectedResult?: string;
16
+ expectedResult?:string;
17
17
  /** Explicit mutation author override. */
18
- author?: string;
18
+ author?:string;
19
19
  /** Optional human-readable history message in addition to structured recurrence context. */
20
- message?: string;
20
+ message?:string;
21
21
  /** Override an ownership or stale-lock conflict. */
22
- force?: boolean;
22
+ force?:boolean;
23
23
  }
24
24
  /** Structured recurrence receipt returned by every presentation surface. */
25
25
  export interface RecurrenceReceipt {
26
26
  /** Required reason that the terminal work became active again. */
27
- reason: string;
27
+ reason:string;
28
28
  /** Terminal status observed while holding the item lock. */
29
- from_status: string;
29
+ from_status:string;
30
30
  /** Active status written through the update pipeline. */
31
- to_status: string;
31
+ to_status:string;
32
32
  /** Prior terminal evidence retained in immutable history. */
33
- previous_terminal: PreviousTerminalEvidence;
33
+ previous_terminal:PreviousTerminalEvidence;
34
34
  }
35
35
  /** Result returned after a terminal item is reopened. */
36
36
  export interface ReopenResult {
37
37
  /** Reopened item metadata. */
38
- item: Record<string, unknown>;
38
+ item:Record<string,unknown>;
39
39
  /** Fields changed by the canonical update pipeline. */
40
- changed_fields: string[];
40
+ changed_fields:string[];
41
41
  /** Non-fatal mutation and extension warnings. */
42
- warnings: string[];
42
+ warnings:string[];
43
43
  /** Immutable recurrence transition receipt. */
44
- recurrence: RecurrenceReceipt;
44
+ recurrence:RecurrenceReceipt;
45
45
  /** Executable planning recovery when the caller has not supplied a current expectation. */
46
- recovery?: PmCliErrorRecoveryPayload;
46
+ recovery?:PmCliErrorRecoveryPayload;
47
47
  }
48
48
  /** Reopen terminal work through the canonical update mutation and history path. */
49
- export declare function runReopen(id: string, reason: string, options: ReopenCommandOptions, global: GlobalOptions): Promise<ReopenResult>;
49
+ export declare function runReopen(id:string,reason:string,options:ReopenCommandOptions,global:GlobalOptions):Promise<ReopenResult>;
@@ -1,18 +1,18 @@
1
- import type { CalendarEvent, Reminder } from "../../types/index.js";
1
+ import type { CalendarEvent,Reminder } from "../../types/index.js";
2
2
  import { type RecurrenceEmptyNumericGuard } from "./recurrence-parsers.js";
3
3
  type EmptyValueGuard = "defined" | "truthy";
4
4
  type ReminderValueMode = "raw" | "trimmed";
5
5
  interface ParseReminderEntriesOptions {
6
- valueMode: ReminderValueMode;
6
+ valueMode:ReminderValueMode;
7
7
  }
8
8
  interface ParseEventEntriesOptions {
9
- allDayEmptyGuard: EmptyValueGuard;
10
- recurrenceEmptyNumericGuard: RecurrenceEmptyNumericGuard;
9
+ allDayEmptyGuard:EmptyValueGuard;
10
+ recurrenceEmptyNumericGuard:RecurrenceEmptyNumericGuard;
11
11
  }
12
12
  /** Implements parse reminder entries for the public runtime surface of this module. */
13
- export declare function parseReminderEntries(raw: string[], nowValue: Date, options: ParseReminderEntriesOptions): Reminder[];
13
+ export declare function parseReminderEntries(raw:string[],nowValue:Date,options:ParseReminderEntriesOptions):Reminder[];
14
14
  /** Implements parse event entries for the public runtime surface of this module. */
15
- export declare function parseEventEntries(raw: string[], nowValue: Date, options: ParseEventEntriesOptions): CalendarEvent[];
15
+ export declare function parseEventEntries(raw:string[],nowValue:Date,options:ParseEventEntriesOptions):CalendarEvent[];
16
16
  /** Implements parse type option entries for the public runtime surface of this module. */
17
- export declare function parseTypeOptionEntries(raw: string[]): Record<string, string>;
17
+ export declare function parseTypeOptionEntries(raw:string[]):Record<string,string>;
18
18
  export {};
@@ -1,56 +1,56 @@
1
- import { type GlobalOptions, locateItem, readSettings } from "../runtime-primitives.js";
2
- import { applyHistoryPatch, ensureMaterializedHistoryTarget as ensureMaterializedRestoreTarget, extractPatchFailureContext, replayHistoryToTarget as replayToTarget } from "../history-read.js";
3
- import type { HistoryEntry, ItemDocument, ItemMetadata } from "../../types/index.js";
1
+ import { type GlobalOptions,locateItem,readSettings } from "../runtime-primitives.js";
2
+ import { applyHistoryPatch,ensureMaterializedHistoryTarget as ensureMaterializedRestoreTarget,extractPatchFailureContext,replayHistoryToTarget as replayToTarget } from "../history-read.js";
3
+ import type { HistoryEntry,ItemDocument,ItemMetadata } from "../../types/index.js";
4
4
  interface ResolvedRestoreSubject {
5
- id: string;
6
- historyPath: string;
7
- located: Awaited<ReturnType<typeof locateItem>>;
8
- historyPolicyWarnings: string[];
5
+ id:string;
6
+ historyPath:string;
7
+ located:Awaited<ReturnType<typeof locateItem>>;
8
+ historyPolicyWarnings:string[];
9
9
  }
10
10
  /** Documents the restore command options payload exchanged by command, SDK, and package integrations. */
11
11
  export interface RestoreCommandOptions {
12
12
  /** Value that configures or reports author for this contract. */
13
- author?: string;
13
+ author?:string;
14
14
  /** Human-readable explanation suitable for logs and agent-facing output. */
15
- message?: string;
15
+ message?:string;
16
16
  /** Value that configures or reports force for this contract. */
17
- force?: boolean;
17
+ force?:boolean;
18
18
  }
19
19
  /** Documents the restore result payload exchanged by command, SDK, and package integrations. */
20
20
  export interface RestoreResult {
21
21
  /** Value that configures or reports item for this contract. */
22
- item: ItemMetadata;
22
+ item:ItemMetadata;
23
23
  /** Value that configures or reports restored from for this contract. */
24
- restored_from: {
25
- kind: "version" | "timestamp";
26
- target: string;
27
- history_index: number;
28
- version: number | null;
29
- entry_ts: string;
30
- entry_op: string;
24
+ restored_from:{
25
+ kind:"version" | "timestamp";
26
+ target:string;
27
+ history_index:number;
28
+ version:number | null;
29
+ entry_ts:string;
30
+ entry_op:string;
31
31
  };
32
32
  /** Value that configures or reports changed fields for this contract. */
33
- changed_fields: string[];
33
+ changed_fields:string[];
34
34
  /** Value that configures or reports warnings for this contract. */
35
- warnings: string[];
35
+ warnings:string[];
36
36
  }
37
37
  /** Resolve restore targets with the command's established wording and at-or-before timestamp semantics. */
38
- declare function ensureReplayTarget(target: string, history: readonly HistoryEntry[]): import("../../core/history/projection.js").ResolvedHistoryTarget;
39
- declare function replayCurrentDocument(history: HistoryEntry[]): ItemDocument;
38
+ declare function ensureReplayTarget(target:string,history:readonly HistoryEntry[]):import("../../core/history/projection.js").ResolvedHistoryTarget;
39
+ declare function replayCurrentDocument(history:HistoryEntry[]):ItemDocument;
40
40
  /** Resolve live or deleted history and enforce the current item's stream policy before restoring a historical version. */
41
- declare function resolveRestoreSubject(pmRoot: string, id: string, settings: Awaited<ReturnType<typeof readSettings>>, typeToFolder: Record<string, string>): Promise<ResolvedRestoreSubject>;
42
- declare function changedFields(beforeDocument: ItemDocument, afterDocument: ItemDocument): string[];
41
+ declare function resolveRestoreSubject(pmRoot:string,id:string,settings:Awaited<ReturnType<typeof readSettings>>,typeToFolder:Record<string,string>):Promise<ResolvedRestoreSubject>;
42
+ declare function changedFields(beforeDocument:ItemDocument,afterDocument:ItemDocument):string[];
43
43
  /** Implements run restore for the public runtime surface of this module. */
44
- export declare function runRestore(id: string, target: string, options: RestoreCommandOptions, global: GlobalOptions): Promise<RestoreResult>;
44
+ export declare function runRestore(id:string,target:string,options:RestoreCommandOptions,global:GlobalOptions):Promise<RestoreResult>;
45
45
  /** Public contract for test only restore command, shared by SDK and presentation-layer consumers. */
46
- export declare const _testOnlyRestoreCommand: {
47
- applyHistoryPatch: typeof applyHistoryPatch;
48
- changedFields: typeof changedFields;
49
- ensureMaterializedRestoreTarget: typeof ensureMaterializedRestoreTarget;
50
- ensureReplayTarget: typeof ensureReplayTarget;
51
- extractPatchFailureContext: typeof extractPatchFailureContext;
52
- replayCurrentDocument: typeof replayCurrentDocument;
53
- replayToTarget: typeof replayToTarget;
54
- resolveRestoreSubject: typeof resolveRestoreSubject;
46
+ export declare const _testOnlyRestoreCommand:{
47
+ applyHistoryPatch:typeof applyHistoryPatch;
48
+ changedFields:typeof changedFields;
49
+ ensureMaterializedRestoreTarget:typeof ensureMaterializedRestoreTarget;
50
+ ensureReplayTarget:typeof ensureReplayTarget;
51
+ extractPatchFailureContext:typeof extractPatchFailureContext;
52
+ replayCurrentDocument:typeof replayCurrentDocument;
53
+ replayToTarget:typeof replayToTarget;
54
+ resolveRestoreSubject:typeof resolveRestoreSubject;
55
55
  };
56
56
  export {};