@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,185 +1,185 @@
1
1
  /** One field group that a richer output projection can restore. */
2
2
  export interface OutputProjectionFieldGroup {
3
3
  /** Stable machine-readable field-group name. */
4
- name: string;
4
+ name:string;
5
5
  /** Exact CLI flag or flag/value pair that restores the group. */
6
- restore_with: string;
6
+ restore_with:string;
7
7
  }
8
8
  /** Bounded disclosure that distinguishes complete output from silent omission. */
9
9
  export interface OutputOmissionReceipt {
10
10
  /** Whether the active projection withheld at least one declared field group. */
11
- has_omissions: boolean;
11
+ has_omissions:boolean;
12
12
  /** Constant-size count of withheld field groups. */
13
- omitted_field_group_count: number;
13
+ omitted_field_group_count:number;
14
14
  /** Withheld groups and the exact opt-in that restores each one. */
15
- omitted_field_groups: OutputProjectionFieldGroup[];
15
+ omitted_field_groups:OutputProjectionFieldGroup[];
16
16
  /** Population counted by context summary regardless of bounded focus rows. */
17
- summary_scope?: "matching_items";
17
+ summary_scope?:"matching_items";
18
18
  }
19
19
  /** Self-describing projection metadata that built-ins and extensions can use to derive receipts without command-specific code. */
20
20
  export interface OutputProjectionDeclaration {
21
21
  /** Active projection name. */
22
- mode: string;
22
+ mode:string;
23
23
  /** Every optional field group supported by this result shape. */
24
- declared_field_groups: OutputProjectionFieldGroup[];
24
+ declared_field_groups:OutputProjectionFieldGroup[];
25
25
  /** Names of declared groups present in this result. */
26
- included_field_groups: string[];
26
+ included_field_groups:string[];
27
27
  }
28
28
  /** Register non-serialized materiality evidence used to keep omission receipts token-proportional. */
29
- export declare function registerOutputMaterialFieldGroups(result: object, fieldGroups: readonly string[]): void;
29
+ export declare function registerOutputMaterialFieldGroups(result:object,fieldGroups:readonly string[]):void;
30
30
  /** Machine-readable location and field-projection support for read-result rows. */
31
31
  export interface ReadRowContract {
32
32
  /** Canonical read command that owns the result. */
33
- command: string;
33
+ command:string;
34
34
  /** Whether the result exposes iterable collections or intentionally has none. */
35
- row_kind: "collection" | "none";
35
+ row_kind:"collection" | "none";
36
36
  /** Dot-delimited paths to array or object-map collections containing iterable result rows. */
37
- row_keys: string[];
37
+ row_keys:string[];
38
38
  /** Optional nested collections that are independently resumable without redefining primary result rows. */
39
- continuation_row_keys?: string[];
39
+ continuation_row_keys?:string[];
40
40
  /** Whether the command accepts an explicit row-field projection. */
41
- fields: "supported" | "unsupported";
41
+ fields:"supported" | "unsupported";
42
42
  /** Universal jq expression that iterates every declared collection path. */
43
- jq_selector?: string;
43
+ jq_selector?:string;
44
44
  /** TOON row encoding selected whenever every row is a flat object with one shared key set. */
45
- toon_encoding?: "tabular_when_uniform";
45
+ toon_encoding?:"tabular_when_uniform";
46
46
  }
47
47
  /** Universal selector for results carrying a {@link ReadRowContract}. */
48
48
  export declare const PM_READ_ROW_JQ_SELECTOR = ".row_contract.row_keys[] as $key | getpath($key | split(\".\")) | if type == \"array\" then .[] else if type == \"object\" then to_entries[] else empty end end";
49
49
  /** Static row declarations shared by CLI, SDK, MCP, and package consumers. */
50
- export declare const PM_READ_ROW_CONTRACTS: {
51
- readonly context: {
52
- readonly row_keys: readonly ["high_level", "low_level"];
53
- readonly fields: "supported";
50
+ export declare const PM_READ_ROW_CONTRACTS:{
51
+ readonly context:{
52
+ readonly row_keys:readonly ["high_level","low_level"];
53
+ readonly fields:"supported";
54
54
  };
55
- readonly get: {
56
- readonly row_keys: readonly ["children"];
57
- readonly fields: "supported";
55
+ readonly get:{
56
+ readonly row_keys:readonly ["children"];
57
+ readonly fields:"supported";
58
58
  };
59
- readonly list: {
60
- readonly row_keys: readonly ["items"];
61
- readonly fields: "supported";
59
+ readonly list:{
60
+ readonly row_keys:readonly ["items"];
61
+ readonly fields:"supported";
62
62
  };
63
- readonly next: {
64
- readonly row_keys: readonly ["recommended", "ready", "decision_needed", "gate_needed", "containers", "blocked", "held_by_others"];
65
- readonly fields: "unsupported";
63
+ readonly next:{
64
+ readonly row_keys:readonly ["recommended","ready","decision_needed","gate_needed","containers","blocked","held_by_others"];
65
+ readonly fields:"unsupported";
66
66
  };
67
- readonly search: {
68
- readonly row_keys: readonly ["items"];
69
- readonly fields: "supported";
67
+ readonly search:{
68
+ readonly row_keys:readonly ["items"];
69
+ readonly fields:"supported";
70
70
  };
71
- readonly activity: {
72
- readonly row_keys: readonly ["activity_digest", "compact_activity", "provenance_activity", "activity"];
73
- readonly fields: "unsupported";
71
+ readonly activity:{
72
+ readonly row_keys:readonly ["activity_digest","compact_activity","provenance_activity","activity"];
73
+ readonly fields:"unsupported";
74
74
  };
75
- readonly history: {
76
- readonly row_keys: readonly ["compact_history", "provenance_history", "history", "diff"];
77
- readonly fields: "unsupported";
75
+ readonly history:{
76
+ readonly row_keys:readonly ["compact_history","provenance_history","history","diff"];
77
+ readonly fields:"unsupported";
78
78
  };
79
- readonly deps: {
80
- readonly row_keys: readonly ["graph.nodes", "graph.edges", "context.nodes", "context.edges"];
81
- readonly fields: "unsupported";
79
+ readonly deps:{
80
+ readonly row_keys:readonly ["graph.nodes","graph.edges","context.nodes","context.edges"];
81
+ readonly fields:"unsupported";
82
82
  };
83
- readonly health: {
84
- readonly row_keys: readonly ["checks"];
85
- readonly fields: "unsupported";
83
+ readonly health:{
84
+ readonly row_keys:readonly ["checks"];
85
+ readonly fields:"unsupported";
86
86
  };
87
- readonly aggregate: {
88
- readonly row_keys: readonly ["groups"];
89
- readonly fields: "unsupported";
87
+ readonly aggregate:{
88
+ readonly row_keys:readonly ["groups"];
89
+ readonly fields:"unsupported";
90
90
  };
91
- readonly duplicates: {
92
- readonly row_keys: readonly ["clusters"];
93
- readonly fields: "unsupported";
91
+ readonly duplicates:{
92
+ readonly row_keys:readonly ["clusters"];
93
+ readonly fields:"unsupported";
94
94
  };
95
- readonly stats: {
96
- readonly row_keys: readonly ["by_type", "by_status"];
97
- readonly fields: "unsupported";
95
+ readonly stats:{
96
+ readonly row_keys:readonly ["by_type","by_status"];
97
+ readonly fields:"unsupported";
98
98
  };
99
- readonly comments: {
100
- readonly row_keys: readonly ["comments"];
101
- readonly fields: "unsupported";
99
+ readonly comments:{
100
+ readonly row_keys:readonly ["comments"];
101
+ readonly fields:"unsupported";
102
102
  };
103
- readonly notes: {
104
- readonly row_keys: readonly ["notes"];
105
- readonly fields: "unsupported";
103
+ readonly notes:{
104
+ readonly row_keys:readonly ["notes"];
105
+ readonly fields:"unsupported";
106
106
  };
107
- readonly learnings: {
108
- readonly row_keys: readonly ["learnings"];
109
- readonly fields: "unsupported";
107
+ readonly learnings:{
108
+ readonly row_keys:readonly ["learnings"];
109
+ readonly fields:"unsupported";
110
110
  };
111
- readonly files: {
112
- readonly row_keys: readonly ["files"];
113
- readonly fields: "unsupported";
111
+ readonly files:{
112
+ readonly row_keys:readonly ["files"];
113
+ readonly fields:"unsupported";
114
114
  };
115
- readonly docs: {
116
- readonly row_keys: readonly ["docs"];
117
- readonly fields: "unsupported";
115
+ readonly docs:{
116
+ readonly row_keys:readonly ["docs"];
117
+ readonly fields:"unsupported";
118
118
  };
119
- readonly validate: {
120
- readonly row_keys: readonly ["checks", "warnings"];
121
- readonly fields: "unsupported";
119
+ readonly validate:{
120
+ readonly row_keys:readonly ["checks","warnings"];
121
+ readonly fields:"unsupported";
122
122
  };
123
- readonly contracts: {
124
- readonly row_keys: readonly ["command_summaries", "commands"];
125
- readonly fields: "unsupported";
123
+ readonly contracts:{
124
+ readonly row_keys:readonly ["command_summaries","commands"];
125
+ readonly fields:"unsupported";
126
126
  };
127
127
  };
128
128
  /** Contract for a command whose output modes expose mutually exclusive row shapes. */
129
129
  export interface ModePairedOutputProjectionContract {
130
130
  /** Stable command name. */
131
- command: string;
131
+ command:string;
132
132
  /** Mode that contains the complete authoritative row shape. */
133
- complete_mode: string;
133
+ complete_mode:string;
134
134
  /** Field groups withheld by each non-complete mode. */
135
- omissions_by_mode: Readonly<Record<string, readonly OutputProjectionFieldGroup[]>>;
135
+ omissions_by_mode:Readonly<Record<string,readonly OutputProjectionFieldGroup[]>>;
136
136
  }
137
137
  /** Shared activity/history contract used by CLI, SDK, MCP, and conformance tests. */
138
- export declare const PM_MODE_PAIRED_OUTPUT_PROJECTION_CONTRACTS: readonly [{
139
- readonly command: "activity";
140
- readonly complete_mode: "full";
141
- readonly omissions_by_mode: {
142
- readonly digest: readonly [{
143
- readonly name: "event_rows";
144
- readonly restore_with: "--raw";
138
+ export declare const PM_MODE_PAIRED_OUTPUT_PROJECTION_CONTRACTS:readonly [{
139
+ readonly command:"activity";
140
+ readonly complete_mode:"full";
141
+ readonly omissions_by_mode:{
142
+ readonly digest:readonly [{
143
+ readonly name:"event_rows";
144
+ readonly restore_with:"--raw";
145
145
  }];
146
- readonly compact: readonly [{
147
- readonly name: "provenance";
148
- readonly restore_with: "--full";
146
+ readonly compact:readonly [{
147
+ readonly name:"provenance";
148
+ readonly restore_with:"--full";
149
149
  }];
150
- readonly provenance: readonly [{
151
- readonly name: "patch_and_hashes";
152
- readonly restore_with: "--full";
150
+ readonly provenance:readonly [{
151
+ readonly name:"patch_and_hashes";
152
+ readonly restore_with:"--full";
153
153
  }];
154
154
  };
155
- }, {
156
- readonly command: "history";
157
- readonly complete_mode: "full";
158
- readonly omissions_by_mode: {
159
- readonly compact: readonly [{
160
- readonly name: "raw_history";
161
- readonly restore_with: "--full";
155
+ },{
156
+ readonly command:"history";
157
+ readonly complete_mode:"full";
158
+ readonly omissions_by_mode:{
159
+ readonly compact:readonly [{
160
+ readonly name:"raw_history";
161
+ readonly restore_with:"--full";
162
162
  }];
163
- readonly provenance: readonly [{
164
- readonly name: "patch_and_hashes";
165
- readonly restore_with: "--full";
163
+ readonly provenance:readonly [{
164
+ readonly name:"patch_and_hashes";
165
+ readonly restore_with:"--full";
166
166
  }];
167
167
  };
168
168
  }];
169
169
  /** Reject a compact projection and its explicit full restoration when callers request both. */
170
- export declare function assertProjectionModeChoice(compactRequested: boolean, fullRequested: boolean, compactFlag: string): void;
170
+ export declare function assertProjectionModeChoice(compactRequested:boolean,fullRequested:boolean,compactFlag:string):void;
171
171
  /** Build an explicit constant-size receipt from declared and included groups. */
172
- export declare function createOutputOmissionReceipt(declaredGroups: readonly OutputProjectionFieldGroup[], includedGroupNames?: ReadonlySet<string>): OutputOmissionReceipt;
172
+ export declare function createOutputOmissionReceipt(declaredGroups:readonly OutputProjectionFieldGroup[],includedGroupNames?:ReadonlySet<string>):OutputOmissionReceipt;
173
173
  /** Resolve the receipt declared for one mode-paired command result. */
174
- export declare function resolveModePairedOutputOmissionReceipt(command: string, mode: string): OutputOmissionReceipt;
174
+ export declare function resolveModePairedOutputOmissionReceipt(command:string,mode:string):OutputOmissionReceipt;
175
175
  /** Return whether an unknown value is a structurally valid row declaration. */
176
- export declare function isReadRowContract(value: unknown): value is ReadRowContract;
176
+ export declare function isReadRowContract(value:unknown):value is ReadRowContract;
177
177
  /** Resolve one command's canonical row collection declaration. */
178
- export declare function resolveReadRowContract(command: string, result: Record<string, unknown>): ReadRowContract | undefined;
178
+ export declare function resolveReadRowContract(command:string,result:Record<string,unknown>):ReadRowContract | undefined;
179
179
  /** Derive a receipt from one built-in read result without changing its rows. */
180
- export declare function resolveOutputOmissionReceipt(command: string, result: Record<string, unknown>): OutputOmissionReceipt | undefined;
180
+ export declare function resolveOutputOmissionReceipt(command:string,result:Record<string,unknown>):OutputOmissionReceipt | undefined;
181
181
  /**
182
182
  * Attach a receipt to built-in read results that already expose enough
183
183
  * projection state to derive omissions without repeating command logic.
184
184
  */
185
- export declare function attachOutputOmissionReceipt(command: string | undefined, result: unknown): unknown;
185
+ export declare function attachOutputOmissionReceipt(command:string | undefined,result:unknown):unknown;
@@ -3,39 +3,39 @@ export type PmOutputTokenSection = "result_rows" | "envelope" | "diagnostics" |
3
3
  /** Byte and token estimate attributed to one output section. */
4
4
  export interface PmOutputTokenSectionAccounting {
5
5
  /** Exact share of emitted pre-receipt bytes allocated to this section. */
6
- bytes: number;
6
+ bytes:number;
7
7
  /** Token estimate derived with pm's canonical UTF-8 byte estimator. */
8
- estimated_tokens: number;
8
+ estimated_tokens:number;
9
9
  }
10
10
  /** Bounded accounting receipt attached only when explicitly requested. */
11
11
  export interface PmOutputTokenAccounting {
12
12
  /** Receipt schema version. */
13
- version: 1;
13
+ version:1;
14
14
  /** Scope measured by this receipt. */
15
- measurement_scope: "output_before_token_accounting";
15
+ measurement_scope:"output_before_token_accounting";
16
16
  /** Canonical estimator shared with declared output budgets. */
17
- estimator: "ceil(utf8_bytes / 4)";
17
+ estimator:"ceil(utf8_bytes / 4)";
18
18
  /** Exact UTF-8 byte count of the emitted output before this receipt. */
19
- total_bytes: number;
19
+ total_bytes:number;
20
20
  /** Canonical token estimate for {@link total_bytes}. */
21
- total_estimated_tokens: number;
21
+ total_estimated_tokens:number;
22
22
  /** Deterministic attribution whose byte values sum exactly to total_bytes. */
23
- sections: Record<PmOutputTokenSection, PmOutputTokenSectionAccounting>;
23
+ sections:Record<PmOutputTokenSection,PmOutputTokenSectionAccounting>;
24
24
  /** Exact UTF-8 bytes added by the accounting receipt itself. */
25
- accounting_receipt_bytes: number;
25
+ accounting_receipt_bytes:number;
26
26
  /** Token estimate for the excluded receipt overhead. */
27
- accounting_receipt_estimated_tokens: number;
27
+ accounting_receipt_estimated_tokens:number;
28
28
  /** Fields intentionally excluded from the accounted total. */
29
- excluded_fields: readonly ["token_accounting"];
29
+ excluded_fields:readonly ["token_accounting"];
30
30
  /** Describes how structural transport bytes are assigned to sections. */
31
- section_allocation: "proportional_canonical_json";
31
+ section_allocation:"proportional_canonical_json";
32
32
  }
33
33
  /** Result enriched by opt-in token accounting without weakening its input type. */
34
- export type PmTokenAccountedResult<Result> = Result extends Record<string, unknown> ? Result & {
35
- token_accounting: PmOutputTokenAccounting;
36
- } : {
37
- result: Result;
38
- token_accounting: PmOutputTokenAccounting;
34
+ export type PmTokenAccountedResult<Result> = Result extends Record<string,unknown> ? Result & {
35
+ token_accounting:PmOutputTokenAccounting;
36
+ } :{
37
+ result:Result;
38
+ token_accounting:PmOutputTokenAccounting;
39
39
  };
40
40
  /**
41
41
  * Attach a deterministic receipt for exactly the bytes produced by
@@ -43,4 +43,4 @@ token_accounting: PmOutputTokenAccounting;
43
43
  * so CLI TOON/JSON, MCP JSON, and package-defined hosts all measure their real
44
44
  * representation rather than a guessed intermediate shape.
45
45
  */
46
- export declare function attachOutputTokenAccounting<Result>(result: Result, render: (value: unknown) => string): PmTokenAccountedResult<Result>;
46
+ export declare function attachOutputTokenAccounting<Result>(result:Result,render:(value:unknown) => string):PmTokenAccountedResult<Result>;
@@ -4,8 +4,8 @@
4
4
  * Defines public output-control primitives for extension commands, exporters,
5
5
  * renderers, and custom SDK-built hosts.
6
6
  */
7
- export { SUPPRESS_HOST_OUTPUT_MARKER, isHostOutputSuppressed, suppressHostOutput, type SuppressedHostOutput, } from "../core/output/output-control.js";
8
- export { encodePmTableRows, decodePmTableRows, type PmTableCellEncoding, type PmEncodedTableRows, } from "./output/table-rows.js";
7
+ export { SUPPRESS_HOST_OUTPUT_MARKER,isHostOutputSuppressed,suppressHostOutput,type SuppressedHostOutput,} from "../core/output/output-control.js";
8
+ export { encodePmTableRows,decodePmTableRows,type PmTableCellEncoding,type PmEncodedTableRows,} from "./output/table-rows.js";
9
9
  /**
10
10
  * Serialize object rows as newline-delimited JSON without adding a trailing
11
11
  * newline. CLI hosts can append their final newline while SDK consumers can
@@ -14,40 +14,40 @@ export { encodePmTableRows, decodePmTableRows, type PmTableCellEncoding, type Pm
14
14
  * @throws {TypeError} When a row or its `toJSON` projection is not a non-null,
15
15
  * non-array object.
16
16
  */
17
- export declare function serializeNdjsonRows(rows: readonly unknown[]): string;
17
+ export declare function serializeNdjsonRows(rows:readonly unknown[]):string;
18
18
  /** Terminal metadata that makes an NDJSON batch independently resumable. */
19
19
  export interface PmNdjsonStreamTrailer {
20
20
  /** Producer-owned constant-size fields may extend the shared trailer. */
21
- readonly [key: string]: unknown;
21
+ readonly [key:string]:unknown;
22
22
  /** Stable discriminator that cannot be confused with a domain row. */
23
- record_type: "pm.stream.trailer";
23
+ record_type:"pm.stream.trailer";
24
24
  /** Number of domain rows preceding this trailer in the batch. */
25
- count: number;
25
+ count:number;
26
26
  /** Whether another row was available when the batch was read. */
27
- has_more: boolean;
27
+ has_more:boolean;
28
28
  /** Opaque cursor that resumes strictly after this batch. */
29
- next_cursor: string | null;
29
+ next_cursor:string | null;
30
30
  /** Name of the authoritative or derived source that produced the batch. */
31
- source: string;
31
+ source:string;
32
32
  /** Optional constant-size metadata owned by the stream producer. */
33
- metadata?: Readonly<Record<string, unknown>>;
33
+ metadata?:Readonly<Record<string,unknown>>;
34
34
  }
35
35
  /** Metadata accepted by {@link serializeNdjsonStream}. */
36
36
  export interface PmNdjsonStreamTrailerInput {
37
37
  /** Producer-owned constant-size fields may extend the shared trailer. */
38
- readonly [key: string]: unknown;
38
+ readonly [key:string]:unknown;
39
39
  /** The serializer owns the discriminator and callers cannot override it. */
40
- readonly record_type?: never;
40
+ readonly record_type?:never;
41
41
  /** Number of domain rows preceding the terminal trailer. */
42
- count: number;
42
+ count:number;
43
43
  /** Whether another row was available when the batch was read. */
44
- has_more: boolean;
44
+ has_more:boolean;
45
45
  /** Opaque cursor that resumes strictly after this batch. */
46
- next_cursor: string | null;
46
+ next_cursor:string | null;
47
47
  /** Name of the authoritative or derived source that produced the batch. */
48
- source: string;
48
+ source:string;
49
49
  /** Optional constant-size metadata owned by the stream producer. */
50
- metadata?: Readonly<Record<string, unknown>>;
50
+ metadata?:Readonly<Record<string,unknown>>;
51
51
  }
52
52
  /**
53
53
  * Serialize a bounded NDJSON batch followed by exactly one typed terminal
@@ -58,4 +58,4 @@ metadata?: Readonly<Record<string, unknown>>;
58
58
  * @throws {TypeError} When the trailer count differs from the number of domain
59
59
  * rows or a domain row uses the reserved terminal discriminator.
60
60
  */
61
- export declare function serializeNdjsonStream(rows: readonly unknown[], trailer: PmNdjsonStreamTrailerInput): string;
61
+ export declare function serializeNdjsonStream(rows:readonly unknown[],trailer:PmNdjsonStreamTrailerInput):string;
@@ -1,2 +1,2 @@
1
1
  /** Describe the current ownership source for an atomic claim conflict. */
2
- export declare function describeItemOwnershipConflict(pmRoot: string, itemId: string, assignee: string): Promise<string>;
2
+ export declare function describeItemOwnershipConflict(pmRoot:string,itemId:string,assignee:string):Promise<string>;
@@ -12,7 +12,7 @@
12
12
  * at runtime via `PM_CLI_PACKAGE_ROOT`). Centralizing them here removes copy-pasted
13
13
  * helper bodies while keeping each package's explicit field mapping in the package.
14
14
  */
15
- import type { ConfidenceTextLevel, ItemDocument, ItemMetadata, ItemStatus, LinkedDoc, LinkedFile, LinkedTest, LogNote, PmSettings } from "../types/index.js";
15
+ import type { ConfidenceTextLevel,ItemDocument,ItemMetadata,ItemStatus,LinkedDoc,LinkedFile,LinkedTest,LogNote,PmSettings } from "../types/index.js";
16
16
  /** Restricts shared import priority values accepted by import adapters. */
17
17
  export type ImportPriorityValue = 0 | 1 | 2 | 3 | 4;
18
18
  /** Restricts import linked-artifact scopes accepted by bundled package adapters. */
@@ -20,112 +20,112 @@ export type ImportLinkedScope = "project" | "global";
20
20
  /** Configures conversion of loosely shaped source comments into pm log entries. */
21
21
  export interface ToImportLogEntriesOptions {
22
22
  /** ISO 8601 timestamp recording when fallback created occurred. */
23
- fallbackCreatedAt: string;
23
+ fallbackCreatedAt:string;
24
24
  /** Value that configures or reports fallback author for this contract. */
25
- fallbackAuthor: string;
25
+ fallbackAuthor:string;
26
26
  /** Value that configures or reports allow scalar for this contract. */
27
- allowScalar?: boolean;
27
+ allowScalar?:boolean;
28
28
  /** Value that configures or reports text keys for this contract. */
29
- textKeys?: readonly string[];
29
+ textKeys?:readonly string[];
30
30
  /** Value that configures or reports created at key for this contract. */
31
- createdAtKey?: string;
31
+ createdAtKey?:string;
32
32
  /** Value that configures or reports author key for this contract. */
33
- authorKey?: string;
33
+ authorKey?:string;
34
34
  /** Value that configures or reports to iso string for this contract. */
35
- toIsoString?: (value: unknown) => string | undefined;
35
+ toIsoString?:(value:unknown) => string | undefined;
36
36
  }
37
37
  /** Configures conversion of loosely shaped source file/doc arrays into pm linked artifacts. */
38
38
  export interface ToImportLinkedArtifactsOptions {
39
39
  /** Value that configures or reports allow scalar for this contract. */
40
- allowScalar?: boolean;
40
+ allowScalar?:boolean;
41
41
  /** Value that configures or reports path keys for this contract. */
42
- pathKeys?: readonly string[];
42
+ pathKeys?:readonly string[];
43
43
  }
44
44
  /** Configures conversion of loosely shaped source test arrays into pm linked tests. */
45
45
  export interface ToImportLinkedTestsOptions {
46
46
  /** Value that configures or reports allow scalar for this contract. */
47
- allowScalar?: boolean;
47
+ allowScalar?:boolean;
48
48
  /** Value that configures or reports command keys for this contract. */
49
- commandKeys?: readonly string[];
49
+ commandKeys?:readonly string[];
50
50
  /** Value that configures or reports path keys for this contract. */
51
- pathKeys?: readonly string[];
51
+ pathKeys?:readonly string[];
52
52
  /** Value that configures or reports require command for this contract. */
53
- requireCommand?: boolean;
53
+ requireCommand?:boolean;
54
54
  /** Value that configures or reports include extended assertions for this contract. */
55
- includeExtendedAssertions?: boolean;
55
+ includeExtendedAssertions?:boolean;
56
56
  /** Value that configures or reports integer timeout for this contract. */
57
- integerTimeout?: boolean;
57
+ integerTimeout?:boolean;
58
58
  /** Value that configures or reports timeout minimum for this contract. */
59
- timeoutMinimum?: number;
59
+ timeoutMinimum?:number;
60
60
  /** Value that configures or reports timeout exclusive minimum for this contract. */
61
- timeoutExclusiveMinimum?: boolean;
61
+ timeoutExclusiveMinimum?:boolean;
62
62
  }
63
63
  /** Returns the trimmed string when `value` is a non-empty string, else undefined. */
64
- export declare function toNonEmptyImportString(value: unknown): string | undefined;
64
+ export declare function toNonEmptyImportString(value:unknown):string | undefined;
65
65
  /** Coerces a non-negative finite numeric estimate (number or numeric string). */
66
- export declare function toEstimatedMinutesValue(value: unknown): number | undefined;
66
+ export declare function toEstimatedMinutesValue(value:unknown):number | undefined;
67
67
  /** Coerces a priority into the 0..4 range, defaulting to 2. */
68
- export declare function toImportPriority(value: unknown): ImportPriorityValue;
68
+ export declare function toImportPriority(value:unknown):ImportPriorityValue;
69
69
  /** Normalizes tags from an array of strings or a comma-separated string. */
70
- export declare function toImportTags(value: unknown): string[];
70
+ export declare function toImportTags(value:unknown):string[];
71
71
  /** Maps a raw status value to a canonical pm status, defaulting to "open". */
72
- export declare function toImportStatus(value: unknown): ItemStatus;
72
+ export declare function toImportStatus(value:unknown):ItemStatus;
73
73
  /** Coerces a finite integer from a number or non-empty numeric string. */
74
- export declare function toImportInteger(value: unknown): number | undefined;
74
+ export declare function toImportInteger(value:unknown):number | undefined;
75
75
  /** Coerces common boolean representations used by external package formats. */
76
- export declare function toImportBoolean(value: unknown): boolean | undefined;
76
+ export declare function toImportBoolean(value:unknown):boolean | undefined;
77
77
  /** Coerces an array of non-empty strings. */
78
- export declare function toImportStringList(value: unknown): string[] | undefined;
78
+ export declare function toImportStringList(value:unknown):string[] | undefined;
79
79
  /** Coerces a record of non-empty string values. */
80
- export declare function toImportStringMap(value: unknown): Record<string, string> | undefined;
80
+ export declare function toImportStringMap(value:unknown):Record<string,string> | undefined;
81
81
  /** Coerces a record of finite numeric values. */
82
- export declare function toImportNumberMap(value: unknown): Record<string, number> | undefined;
82
+ export declare function toImportNumberMap(value:unknown):Record<string,number> | undefined;
83
83
  /** Maps a loose source confidence value onto pm's confidence field. */
84
- export declare function toImportConfidence(value: unknown, allowedTextValues: readonly ConfidenceTextLevel[]): ItemMetadata["confidence"] | undefined;
84
+ export declare function toImportConfidence(value:unknown,allowedTextValues:readonly ConfidenceTextLevel[]):ItemMetadata["confidence"] | undefined;
85
85
  /** Maps a string onto an allowed enum value, including the common "med" alias. */
86
- export declare function toImportNormalizedEnum<T extends readonly string[]>(value: unknown, allowed: T): T[number] | undefined;
86
+ export declare function toImportNormalizedEnum<T extends readonly string[]>(value:unknown,allowed:T):T[number] | undefined;
87
87
  /** Resolves pm linked-artifact scope values, defaulting to project scope. */
88
- export declare function toImportLinkScope(value: unknown): ImportLinkedScope;
88
+ export declare function toImportLinkScope(value:unknown):ImportLinkedScope;
89
89
  /** Converts source comments, notes, or learnings into pm log notes. */
90
- export declare function toImportLogEntries(value: unknown, options: ToImportLogEntriesOptions): LogNote[] | undefined;
90
+ export declare function toImportLogEntries(value:unknown,options:ToImportLogEntriesOptions):LogNote[] | undefined;
91
91
  /** Converts source file artifacts into pm linked files. */
92
- export declare function toImportLinkedFiles(value: unknown, options?: ToImportLinkedArtifactsOptions): LinkedFile[] | undefined;
92
+ export declare function toImportLinkedFiles(value:unknown,options?:ToImportLinkedArtifactsOptions):LinkedFile[] | undefined;
93
93
  /** Converts source doc artifacts into pm linked docs. */
94
- export declare function toImportLinkedDocs(value: unknown, options?: ToImportLinkedArtifactsOptions): LinkedDoc[] | undefined;
94
+ export declare function toImportLinkedDocs(value:unknown,options?:ToImportLinkedArtifactsOptions):LinkedDoc[] | undefined;
95
95
  /** Converts source test artifacts into pm linked tests. */
96
- export declare function toImportLinkedTests(value: unknown, options?: ToImportLinkedTestsOptions): LinkedTest[] | undefined;
96
+ export declare function toImportLinkedTests(value:unknown,options?:ToImportLinkedTestsOptions):LinkedTest[] | undefined;
97
97
  /** Resolves the effective import author through the canonical CLI and SDK precedence contract. */
98
- export declare function selectImportAuthor(explicitAuthor: string | undefined, settingsAuthor: string): string;
98
+ export declare function selectImportAuthor(explicitAuthor:string | undefined,settingsAuthor:string):string;
99
99
  /** Throws a NOT_FOUND PmCliError when the tracker has not been initialized. */
100
- export declare function ensureTrackerInitialized(pmRoot: string): Promise<void>;
100
+ export declare function ensureTrackerInitialized(pmRoot:string):Promise<void>;
101
101
  /** Returns an empty item document used as the `before` state on import. */
102
- export declare function emptyImportedDocument(): ItemDocument;
102
+ export declare function emptyImportedDocument():ItemDocument;
103
103
  /** Documents the commit imported item params payload exchanged by command, SDK, and package integrations. */
104
104
  export interface CommitImportedItemParams {
105
105
  /** Value that configures or reports pm root for this contract. */
106
- pmRoot: string;
106
+ pmRoot:string;
107
107
  /** Stable identifier used to reference this record across commands and storage. */
108
- id: string;
108
+ id:string;
109
109
  /** Filesystem path used for item resolution. */
110
- itemPath: string;
110
+ itemPath:string;
111
111
  /** Value that configures or reports document for this contract. */
112
- document: ItemDocument;
112
+ document:ItemDocument;
113
113
  /** Value that configures or reports author for this contract. */
114
- author: string;
114
+ author:string;
115
115
  /** Human-readable explanation suitable for logs and agent-facing output. */
116
- message: string;
116
+ message:string;
117
117
  /** Value that configures or reports settings for this contract. */
118
- settings: PmSettings;
118
+ settings:PmSettings;
119
119
  /** Warning prefix emitted on a lock conflict, e.g. "beads_import_lock_conflict". */
120
- conflictWarningPrefix: string;
120
+ conflictWarningPrefix:string;
121
121
  }
122
122
  /** Restricts commit imported item result values accepted by command, SDK, and storage contracts. */
123
123
  export type CommitImportedItemResult = {
124
- committed: true;
125
- writeWarnings: string[];
124
+ committed:true;
125
+ writeWarnings:string[];
126
126
  } | {
127
- committed: false;
128
- conflictWarning: string;
127
+ committed:false;
128
+ conflictWarning:string;
129
129
  };
130
130
  /** Performs the shared item write/commit sequence: acquire the per-item lock, atomically write the TOON document, append the import history entry, and run on-write hooks. On a lock CONFLICT it returns a `conflictWarning` (using the caller-supplied prefix) instead of throwing; any other error removes the partially written file and rethrows. */
131
- export declare function commitImportedItem(params: CommitImportedItemParams): Promise<CommitImportedItemResult>;
131
+ export declare function commitImportedItem(params:CommitImportedItemParams):Promise<CommitImportedItemResult>;
@@ -3,8 +3,8 @@
3
3
  *
4
4
  * Provides one-shot SDK helpers for extension and package migration lifecycle.
5
5
  */
6
- import { type ExtensionCommandOptions, type ExtensionCommandResult, type PackageCommandOptions, type PackageCommandResult, type PmClientOptions } from "./runtime.js";
6
+ import { type ExtensionCommandOptions,type ExtensionCommandResult,type PackageCommandOptions,type PackageCommandResult,type PmClientOptions } from "./runtime.js";
7
7
  /** Plan or apply active extension migrations without constructing a reusable client. */
8
- export declare function extensionMigrate(options?: ExtensionCommandOptions, clientOptions?: PmClientOptions): Promise<ExtensionCommandResult>;
8
+ export declare function extensionMigrate(options?:ExtensionCommandOptions,clientOptions?:PmClientOptions):Promise<ExtensionCommandResult>;
9
9
  /** Plan or apply active package migrations without constructing a reusable client. */
10
- export declare function packageMigrate(options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
10
+ export declare function packageMigrate(options?:PackageCommandOptions,clientOptions?:PmClientOptions):Promise<PackageCommandResult>;