@unbrained/pm-cli 2026.10.14 → 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 (692) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +54 -2
  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-recovery.d.ts +13 -13
  27. package/dist/cli/help-content.d.ts +22 -22
  28. package/dist/cli/help-content.js +2 -2
  29. package/dist/cli/help-json-payload.d.ts +45 -45
  30. package/dist/cli/invocation-profile.d.ts +5 -5
  31. package/dist/cli/main.d.ts +217 -217
  32. package/dist/cli/migration-gates.d.ts +24 -24
  33. package/dist/cli/option-values.d.ts +1 -1
  34. package/dist/cli/public.d.ts +1 -1
  35. package/dist/cli/register-annotations.d.ts +2 -2
  36. package/dist/cli/register-assurance.d.ts +1 -1
  37. package/dist/cli/register-files-lookup.d.ts +1 -1
  38. package/dist/cli/register-history-activity.d.ts +1 -1
  39. package/dist/cli/register-history-author.d.ts +1 -1
  40. package/dist/cli/register-history-maintenance.d.ts +1 -1
  41. package/dist/cli/register-list-query.d.ts +7 -7
  42. package/dist/cli/register-list-query.js +3 -3
  43. package/dist/cli/register-mutation-options.d.ts +1 -1
  44. package/dist/cli/register-mutation.d.ts +4 -4
  45. package/dist/cli/register-operations.d.ts +75 -75
  46. package/dist/cli/register-setup.d.ts +4 -4
  47. package/dist/cli/register-structured-mutation.d.ts +8 -8
  48. package/dist/cli/runtime/activation.d.ts +23 -23
  49. package/dist/cli/runtime/invocation-options.d.ts +12 -12
  50. package/dist/cli/runtime/projection-retry.d.ts +1 -1
  51. package/dist/cli/runtime/selection.d.ts +16 -16
  52. package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
  53. package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
  54. package/dist/cli/schema/registration.d.ts +1 -1
  55. package/dist/cli/schema-registration-helpers.d.ts +2 -2
  56. package/dist/cli/stats-analytics-json.d.ts +1 -1
  57. package/dist/cli-bundle/bundle-manifest.json +1 -1
  58. package/dist/cli-bundle/chunks/{chunk-5LU6PWA4.js → chunk-52EZH2QQ.js} +2 -2
  59. package/dist/cli-bundle/chunks/chunk-7OEGNA4X.js +20 -0
  60. package/dist/cli-bundle/chunks/{chunk-LKESCZEN.js → chunk-7VHINXZP.js} +2 -2
  61. package/dist/cli-bundle/chunks/chunk-EMEEHV2Y.js +2 -0
  62. package/dist/cli-bundle/chunks/chunk-JGKTOBVB.js +6 -0
  63. package/dist/cli-bundle/chunks/{chunk-PP3BVMFL.js → chunk-JSUJWIHQ.js} +30 -30
  64. package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-LNKLQYBG.js} +2 -2
  65. package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-N56CAQBU.js} +63 -64
  66. package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-NC3QVGDD.js} +2 -2
  67. package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-RJ5N44WY.js} +2 -2
  68. package/dist/cli-bundle/chunks/{chunk-LOSRTNNP.js → chunk-VIMQCFCK.js} +2 -2
  69. package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-WBBW3WQX.js} +4 -4
  70. package/dist/cli-bundle/chunks/chunk-X2H6UR26.js +236 -0
  71. package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-FKKFQ66D.js} +7 -7
  72. package/dist/cli-bundle/chunks/{register-mutation-TNRHNK4N.js → register-mutation-EWMMVZJB.js} +2 -2
  73. package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-GEQ2H7PS.js} +2 -2
  74. package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-PSJTQBBO.js} +2 -2
  75. package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-3RNUMVK4.js} +2 -2
  76. package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-4KQFMOM7.js} +6 -6
  77. package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-52I2SNKJ.js} +2 -2
  78. package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-5KRACGBK.js} +2 -2
  79. package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-5OO54BIV.js} +2 -2
  80. package/dist/cli-bundle/focused-chunks/{chunk-LKWDWER4.js → chunk-5TBAVZDR.js} +14 -14
  81. package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-FQKPOZKS.js} +2 -2
  82. package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-H3P77KVU.js} +2 -2
  83. package/dist/cli-bundle/focused-chunks/chunk-HTA3TNC3.js +26 -0
  84. package/dist/cli-bundle/focused-chunks/{chunk-23ACMPGB.js → chunk-JKBH7YGX.js} +2 -2
  85. package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-KIIFVULU.js} +2 -2
  86. package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-N6FUKTZS.js} +2 -2
  87. package/dist/cli-bundle/focused-chunks/chunk-PDYE7QDX.js +166 -0
  88. package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-Q4VNCTR2.js} +2 -2
  89. package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-THYQR3ON.js} +61 -62
  90. package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-TYLG5VEB.js} +2 -2
  91. package/dist/cli-bundle/main.js +26 -26
  92. package/dist/cli-bundle/sdk-authoring.js +1 -1
  93. package/dist/cli-bundle/sdk-contracts.js +2 -2
  94. package/dist/cli-bundle/sdk-core.js +22 -22
  95. package/dist/cli-bundle/sdk-governance.js +1 -1
  96. package/dist/cli-bundle/sdk-graph.js +1 -1
  97. package/dist/cli-bundle/sdk-merge.js +51 -51
  98. package/dist/cli-bundle/sdk-query.js +1 -1
  99. package/dist/cli-bundle/sdk-runtime.js +1 -1
  100. package/dist/cli-bundle/sdk-testing.js +1 -1
  101. package/dist/cli-bundle/sdk.js +7 -7
  102. package/dist/cli.d.ts +9 -9
  103. package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
  104. package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
  105. package/dist/core/config/nested-settings.d.ts +20 -20
  106. package/dist/core/config/positional-value.d.ts +9 -9
  107. package/dist/core/diagnostics/remediation.d.ts +7 -7
  108. package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
  109. package/dist/core/extensions/activation-summary.d.ts +30 -30
  110. package/dist/core/extensions/activation-transaction.d.ts +9 -9
  111. package/dist/core/extensions/capability-usage.d.ts +25 -25
  112. package/dist/core/extensions/command-hook-context.d.ts +15 -15
  113. package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
  114. package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
  115. package/dist/core/extensions/contribution-inventory.d.ts +24 -24
  116. package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
  117. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  118. package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
  119. package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
  120. package/dist/core/extensions/extension-policy.d.ts +62 -62
  121. package/dist/core/extensions/extension-registries.d.ts +8 -8
  122. package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
  123. package/dist/core/extensions/extension-types.d.ts +702 -702
  124. package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
  125. package/dist/core/extensions/flag-value-types.d.ts +16 -4
  126. package/dist/core/extensions/flag-value-types.js +1 -1
  127. package/dist/core/extensions/index.d.ts +34 -34
  128. package/dist/core/extensions/item-field-types.d.ts +3 -3
  129. package/dist/core/extensions/item-fields.d.ts +6 -6
  130. package/dist/core/extensions/loader.d.ts +66 -66
  131. package/dist/core/extensions/manifest-parser.d.ts +1 -1
  132. package/dist/core/extensions/manifest-schema.d.ts +13 -13
  133. package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
  134. package/dist/core/extensions/preflight-ownership.d.ts +3 -3
  135. package/dist/core/extensions/read-output-contract.d.ts +2 -2
  136. package/dist/core/extensions/registration-contracts.d.ts +12 -12
  137. package/dist/core/extensions/registration-validation.d.ts +6 -6
  138. package/dist/core/extensions/registration-values.d.ts +19 -19
  139. package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
  140. package/dist/core/extensions/runtime-registrations.d.ts +6 -6
  141. package/dist/core/extensions/service-ownership.d.ts +1 -1
  142. package/dist/core/extensions/version-compat.d.ts +9 -9
  143. package/dist/core/fs/atomic-create.d.ts +1 -1
  144. package/dist/core/fs/fs-utils.d.ts +12 -12
  145. package/dist/core/fs/host-environment-errors.d.ts +10 -10
  146. package/dist/core/fs/path-utils.d.ts +1 -1
  147. package/dist/core/governance/content-fields.d.ts +25 -25
  148. package/dist/core/governance/issue-codes.d.ts +16 -16
  149. package/dist/core/governance/metadata-coverage.d.ts +64 -64
  150. package/dist/core/history/digest.d.ts +5 -5
  151. package/dist/core/history/drift-cache.d.ts +2 -2
  152. package/dist/core/history/drift-scan.d.ts +18 -18
  153. package/dist/core/history/event-classification.d.ts +4 -4
  154. package/dist/core/history/event-index.d.ts +33 -33
  155. package/dist/core/history/history-compact-bulk.d.ts +12 -12
  156. package/dist/core/history/history-diff.d.ts +15 -15
  157. package/dist/core/history/history-rewrite.d.ts +43 -43
  158. package/dist/core/history/history-storage-stats.d.ts +20 -20
  159. package/dist/core/history/history-stream-policy.d.ts +12 -12
  160. package/dist/core/history/history.d.ts +45 -45
  161. package/dist/core/history/identity.d.ts +4 -4
  162. package/dist/core/history/operation-contract.d.ts +17 -17
  163. package/dist/core/history/projection.d.ts +16 -16
  164. package/dist/core/history/read.d.ts +4 -4
  165. package/dist/core/history/replay.d.ts +47 -47
  166. package/dist/core/history/tombstone.d.ts +1 -1
  167. package/dist/core/history/version-address.d.ts +2 -2
  168. package/dist/core/history/workspace-history.d.ts +72 -72
  169. package/dist/core/io/body-file.d.ts +2 -2
  170. package/dist/core/io/bulk-ids-input.d.ts +7 -7
  171. package/dist/core/item/actionability.d.ts +30 -30
  172. package/dist/core/item/dependency-reference.d.ts +2 -2
  173. package/dist/core/item/id.d.ts +9 -9
  174. package/dist/core/item/item-format-version.d.ts +17 -15
  175. package/dist/core/item/item-format-version.js +1 -1
  176. package/dist/core/item/item-format.d.ts +54 -54
  177. package/dist/core/item/item-record.d.ts +1 -1
  178. package/dist/core/item/item-type-definition.d.ts +11 -11
  179. package/dist/core/item/parent-reference-policy.d.ts +6 -6
  180. package/dist/core/item/parse.d.ts +37 -37
  181. package/dist/core/item/plan-lifecycle.d.ts +4 -4
  182. package/dist/core/item/priority.d.ts +3 -3
  183. package/dist/core/item/sprint-release-format.d.ts +4 -4
  184. package/dist/core/item/status-filter.d.ts +5 -5
  185. package/dist/core/item/status.d.ts +3 -3
  186. package/dist/core/item/toon-decode.d.ts +10 -10
  187. package/dist/core/item/type-registry.d.ts +35 -35
  188. package/dist/core/item/type-synonyms.d.ts +2 -2
  189. package/dist/core/lock/lock-gc.d.ts +28 -28
  190. package/dist/core/lock/lock.d.ts +53 -53
  191. package/dist/core/output/mutation-projection.d.ts +4 -4
  192. package/dist/core/output/output-control.d.ts +4 -4
  193. package/dist/core/output/output.d.ts +30 -30
  194. package/dist/core/output/query-summary.d.ts +5 -5
  195. package/dist/core/output/tabular.d.ts +3 -3
  196. package/dist/core/packages/manifest.d.ts +30 -30
  197. package/dist/core/packages/root.d.ts +4 -4
  198. package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
  199. package/dist/core/policy/workflow-policy-store.d.ts +15 -15
  200. package/dist/core/policy/workflow-policy.d.ts +56 -56
  201. package/dist/core/profile/profile-describe.d.ts +22 -22
  202. package/dist/core/profile/profile-lint.d.ts +13 -13
  203. package/dist/core/profile/profile-plan.d.ts +45 -45
  204. package/dist/core/profile/profile-presets.d.ts +36 -36
  205. package/dist/core/reproducibility/context.d.ts +9 -9
  206. package/dist/core/schema/fields-file.d.ts +35 -35
  207. package/dist/core/schema/item-types-file.d.ts +29 -29
  208. package/dist/core/schema/runtime-field-filters.d.ts +3 -3
  209. package/dist/core/schema/runtime-field-values.d.ts +7 -7
  210. package/dist/core/schema/runtime-schema.d.ts +59 -59
  211. package/dist/core/schema/status-defs-file.d.ts +29 -29
  212. package/dist/core/schema/status-token.d.ts +1 -1
  213. package/dist/core/schema/type-inference.d.ts +10 -10
  214. package/dist/core/schema/type-presets.d.ts +5 -5
  215. package/dist/core/schema/type-workflows.d.ts +14 -14
  216. package/dist/core/search/background-refresh.d.ts +12 -12
  217. package/dist/core/search/bm25.d.ts +16 -16
  218. package/dist/core/search/cache.d.ts +34 -34
  219. package/dist/core/search/corpus.d.ts +17 -17
  220. package/dist/core/search/embedding-batches.d.ts +25 -25
  221. package/dist/core/search/eval-thresholds.d.ts +4 -4
  222. package/dist/core/search/eval.d.ts +40 -40
  223. package/dist/core/search/http-client.d.ts +24 -24
  224. package/dist/core/search/providers.d.ts +30 -30
  225. package/dist/core/search/relevance.d.ts +17 -17
  226. package/dist/core/search/semantic-defaults.d.ts +5 -5
  227. package/dist/core/search/staleness.d.ts +3 -3
  228. package/dist/core/search/vector-stores.d.ts +51 -51
  229. package/dist/core/search/vectorization-metadata.d.ts +9 -9
  230. package/dist/core/sentry/helpers.d.ts +27 -27
  231. package/dist/core/sentry/instrument.d.ts +51 -51
  232. package/dist/core/sentry/instrument.js +1 -1
  233. package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
  234. package/dist/core/sentry/sensitive-assignments.js +2 -0
  235. package/dist/core/session/session-state.d.ts +37 -37
  236. package/dist/core/shared/agent-session-context.d.ts +14 -14
  237. package/dist/core/shared/author.d.ts +89 -89
  238. package/dist/core/shared/command-line.d.ts +3 -3
  239. package/dist/core/shared/command-types.d.ts +20 -20
  240. package/dist/core/shared/conflict-markers.d.ts +5 -5
  241. package/dist/core/shared/constants.d.ts +30 -30
  242. package/dist/core/shared/errors.d.ts +100 -100
  243. package/dist/core/shared/html-entity-decode.d.ts +2 -2
  244. package/dist/core/shared/item-metadata-contract.d.ts +2 -2
  245. package/dist/core/shared/lazy-module.d.ts +1 -1
  246. package/dist/core/shared/levenshtein.d.ts +1 -1
  247. package/dist/core/shared/memo.d.ts +1 -1
  248. package/dist/core/shared/numeric-parsers.d.ts +1 -1
  249. package/dist/core/shared/option-alias-visibility.d.ts +3 -3
  250. package/dist/core/shared/primitives.d.ts +13 -13
  251. package/dist/core/shared/secret-rules.d.ts +92 -92
  252. package/dist/core/shared/serial-queue.d.ts +6 -6
  253. package/dist/core/shared/serialization.d.ts +4 -4
  254. package/dist/core/shared/split-comma-list.d.ts +4 -4
  255. package/dist/core/shared/text-normalization.d.ts +3 -3
  256. package/dist/core/shared/time.d.ts +27 -27
  257. package/dist/core/store/item-format-migration.d.ts +7 -7
  258. package/dist/core/store/item-metadata-cache.d.ts +30 -30
  259. package/dist/core/store/item-metadata-query-index.d.ts +66 -66
  260. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  261. package/dist/core/store/item-store.d.ts +123 -123
  262. package/dist/core/store/item-store.js +1 -1
  263. package/dist/core/store/paths.d.ts +27 -27
  264. package/dist/core/store/settings-concurrency.d.ts +1 -1
  265. package/dist/core/store/settings-read-cache.d.ts +11 -11
  266. package/dist/core/store/settings-validator.d.ts +117 -117
  267. package/dist/core/store/settings.d.ts +84 -84
  268. package/dist/core/store/sqlite-runtime.d.ts +2 -2
  269. package/dist/core/store/tracker-preflight.d.ts +3 -3
  270. package/dist/core/telemetry/consent.d.ts +1 -1
  271. package/dist/core/telemetry/observability.d.ts +16 -16
  272. package/dist/core/telemetry/policy.d.ts +7 -7
  273. package/dist/core/telemetry/read-sampling.d.ts +1 -1
  274. package/dist/core/telemetry/runtime.d.ts +275 -275
  275. package/dist/core/test/background-runs.d.ts +123 -123
  276. package/dist/core/test/item-test-run-tracking.d.ts +10 -10
  277. package/dist/core/test/run-selectors.d.ts +12 -12
  278. package/dist/core/validate/estimate-defaults.d.ts +3 -3
  279. package/dist/core/validate/fix-planning.d.ts +36 -36
  280. package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
  281. package/dist/core/validate/missing-by-type.d.ts +3 -3
  282. package/dist/core/validate/missing-link-owners.d.ts +17 -17
  283. package/dist/core/validate/stale-file-classification.d.ts +6 -6
  284. package/dist/mcp/http-server.d.ts +26 -26
  285. package/dist/mcp/legacy-adapter.d.ts +18 -18
  286. package/dist/mcp/runtime-capabilities.d.ts +18 -18
  287. package/dist/mcp/server.d.ts +73 -73
  288. package/dist/mcp/tool-definitions.d.ts +27 -27
  289. package/dist/sdk/actionability.d.ts +1 -1
  290. package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
  291. package/dist/sdk/agent/command-recovery.d.ts +5 -5
  292. package/dist/sdk/agent/command-suggestions.d.ts +4 -4
  293. package/dist/sdk/agent/create-option-policy.d.ts +2 -2
  294. package/dist/sdk/agent/identity-config.d.ts +18 -18
  295. package/dist/sdk/agent/item-addressing.d.ts +6 -6
  296. package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
  297. package/dist/sdk/agent/refusal-closure.d.ts +22 -22
  298. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
  299. package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
  300. package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
  301. package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
  302. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
  303. package/dist/sdk/agent-capability-contracts.d.ts +41 -41
  304. package/dist/sdk/agent-session-context.d.ts +1 -1
  305. package/dist/sdk/annotations.d.ts +74 -74
  306. package/dist/sdk/author-attribution.d.ts +47 -47
  307. package/dist/sdk/authoring.d.ts +9 -9
  308. package/dist/sdk/cli-bootstrap.d.ts +65 -65
  309. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
  310. package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
  311. package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
  312. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
  313. package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
  314. package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
  315. package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
  316. package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
  317. package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
  318. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  319. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
  320. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
  321. package/dist/sdk/cli-contracts/registration-helpers.d.ts +56 -56
  322. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
  323. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  324. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
  325. package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
  326. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
  327. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
  328. package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
  329. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
  330. package/dist/sdk/cli-contracts.d.ts +15 -15
  331. package/dist/sdk/cli-program.d.ts +1 -1
  332. package/dist/sdk/cli-program.js +1 -1
  333. package/dist/sdk/command-line.d.ts +3 -3
  334. package/dist/sdk/comments.d.ts +24 -24
  335. package/dist/sdk/compile-cache.d.ts +4 -4
  336. package/dist/sdk/completion/bash.d.ts +1 -1
  337. package/dist/sdk/completion/fish.d.ts +1 -1
  338. package/dist/sdk/completion/shared.d.ts +74 -74
  339. package/dist/sdk/completion/zsh.d.ts +1 -1
  340. package/dist/sdk/completion.d.ts +3 -3
  341. package/dist/sdk/compose.d.ts +94 -94
  342. package/dist/sdk/config.d.ts +105 -105
  343. package/dist/sdk/context/recency.d.ts +1 -1
  344. package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
  345. package/dist/sdk/context/usage-egress.d.ts +1 -1
  346. package/dist/sdk/context/usage-ledger.d.ts +18 -18
  347. package/dist/sdk/context-intent-contracts.d.ts +37 -37
  348. package/dist/sdk/context-intent-runtime.d.ts +10 -10
  349. package/dist/sdk/context-packing.d.ts +44 -44
  350. package/dist/sdk/context-relevance.d.ts +110 -110
  351. package/dist/sdk/context-signal-store.d.ts +52 -52
  352. package/dist/sdk/context-usage.d.ts +78 -78
  353. package/dist/sdk/contracts.d.ts +2 -1
  354. package/dist/sdk/contracts.js +1 -1
  355. package/dist/sdk/core-governance.d.ts +5 -5
  356. package/dist/sdk/core.d.ts +8 -8
  357. package/dist/sdk/corpus-shape.d.ts +60 -60
  358. package/dist/sdk/define.d.ts +36 -36
  359. package/dist/sdk/dependencies.d.ts +70 -70
  360. package/dist/sdk/dependency-flag-validation.d.ts +17 -17
  361. package/dist/sdk/dependency-provenance.d.ts +22 -22
  362. package/dist/sdk/docs.d.ts +17 -17
  363. package/dist/sdk/duplicates.d.ts +14 -14
  364. package/dist/sdk/environment/agent-environment.d.ts +118 -118
  365. package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
  366. package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
  367. package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
  368. package/dist/sdk/environment/source-context.d.ts +4 -4
  369. package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
  370. package/dist/sdk/error-code-catalog.d.ts +33 -33
  371. package/dist/sdk/error-runtime.d.ts +5 -5
  372. package/dist/sdk/errors.d.ts +17 -17
  373. package/dist/sdk/eval.d.ts +27 -27
  374. package/dist/sdk/extension/author-manifest.d.ts +9 -9
  375. package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
  376. package/dist/sdk/extension/concurrency.d.ts +1 -1
  377. package/dist/sdk/extension/copy-scope.d.ts +1 -1
  378. package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
  379. package/dist/sdk/extension/describe.d.ts +21 -21
  380. package/dist/sdk/extension/doctor.d.ts +46 -46
  381. package/dist/sdk/extension/install-plan.d.ts +32 -32
  382. package/dist/sdk/extension/install-receipts.d.ts +4 -4
  383. package/dist/sdk/extension/install-runtime.d.ts +12 -12
  384. package/dist/sdk/extension/install-snapshot.d.ts +10 -10
  385. package/dist/sdk/extension/install-sources.d.ts +106 -106
  386. package/dist/sdk/extension/managed-state.d.ts +42 -42
  387. package/dist/sdk/extension/managed-update-status.d.ts +1 -1
  388. package/dist/sdk/extension/migrations.d.ts +48 -48
  389. package/dist/sdk/extension/output-ownership.d.ts +19 -19
  390. package/dist/sdk/extension/runtime-summary.d.ts +7 -7
  391. package/dist/sdk/extension/scaffold.d.ts +15 -15
  392. package/dist/sdk/extension/shared.d.ts +16 -16
  393. package/dist/sdk/extension/source-resolution.d.ts +16 -16
  394. package/dist/sdk/extension/static-inventory.d.ts +23 -23
  395. package/dist/sdk/extension/update-check.d.ts +9 -9
  396. package/dist/sdk/extension-command-context.d.ts +1 -1
  397. package/dist/sdk/extension-contracts.d.ts +10 -10
  398. package/dist/sdk/extension.d.ts +221 -221
  399. package/dist/sdk/files.d.ts +101 -101
  400. package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
  401. package/dist/sdk/flag-invocation-contracts.js +1 -1
  402. package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
  403. package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
  404. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  405. package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
  406. package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
  407. package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
  408. package/dist/sdk/governance/assurance-action.d.ts +46 -46
  409. package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
  410. package/dist/sdk/governance/assurance-presets.d.ts +25 -25
  411. package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
  412. package/dist/sdk/governance/assurance.d.ts +204 -204
  413. package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
  414. package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
  415. package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
  416. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
  417. package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
  418. package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
  419. package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
  420. package/dist/sdk/governance/extension-host-version.d.ts +9 -9
  421. package/dist/sdk/governance/gc.d.ts +26 -26
  422. package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
  423. package/dist/sdk/governance/health.d.ts +172 -172
  424. package/dist/sdk/governance/health.js +1 -1
  425. package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
  426. package/dist/sdk/governance/linked-file-report.d.ts +15 -15
  427. package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
  428. package/dist/sdk/governance/provenance-health.d.ts +35 -35
  429. package/dist/sdk/governance/reindex.d.ts +102 -102
  430. package/dist/sdk/governance/reliability.d.ts +29 -29
  431. package/dist/sdk/governance/stale-work.d.ts +13 -13
  432. package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
  433. package/dist/sdk/governance/storage-integrity.d.ts +28 -28
  434. package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
  435. package/dist/sdk/governance/upgrade.d.ts +77 -77
  436. package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
  437. package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
  438. package/dist/sdk/governance/validate-normalization.d.ts +4 -4
  439. package/dist/sdk/governance/validate.d.ts +176 -176
  440. package/dist/sdk/governance/validate.js +1 -1
  441. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  442. package/dist/sdk/governance/workflow-policy.d.ts +18 -18
  443. package/dist/sdk/governance/workspace-position.d.ts +40 -40
  444. package/dist/sdk/governance.d.ts +2 -2
  445. package/dist/sdk/graph/adapter.d.ts +45 -45
  446. package/dist/sdk/graph/analytics.d.ts +36 -36
  447. package/dist/sdk/graph/assembly.d.ts +51 -51
  448. package/dist/sdk/graph/cache.d.ts +19 -19
  449. package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
  450. package/dist/sdk/graph/centrality.d.ts +20 -20
  451. package/dist/sdk/graph/conformance.d.ts +21 -21
  452. package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
  453. package/dist/sdk/graph/durable-cache.d.ts +22 -22
  454. package/dist/sdk/graph/governance-contracts.d.ts +1 -1
  455. package/dist/sdk/graph/governance.d.ts +92 -92
  456. package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
  457. package/dist/sdk/graph/index.d.ts +15 -15
  458. package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
  459. package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
  460. package/dist/sdk/graph/query-contracts.d.ts +6 -6
  461. package/dist/sdk/graph/remediation.d.ts +15 -15
  462. package/dist/sdk/graph/run.d.ts +203 -203
  463. package/dist/sdk/graph/scheduling.d.ts +21 -21
  464. package/dist/sdk/graph/traversal.d.ts +18 -18
  465. package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
  466. package/dist/sdk/guide-topics.d.ts +19 -19
  467. package/dist/sdk/guide.d.ts +43 -43
  468. package/dist/sdk/history/attestation-command.d.ts +8 -8
  469. package/dist/sdk/history/attestation-contract.d.ts +43 -43
  470. package/dist/sdk/history/attestation-scan.d.ts +4 -4
  471. package/dist/sdk/history/attestation.d.ts +4 -4
  472. package/dist/sdk/history/maintenance.d.ts +25 -25
  473. package/dist/sdk/history/salvage.d.ts +19 -19
  474. package/dist/sdk/history/subject.d.ts +8 -8
  475. package/dist/sdk/history-analytics.d.ts +64 -64
  476. package/dist/sdk/history-compact.d.ts +67 -67
  477. package/dist/sdk/history-mcp.d.ts +7 -7
  478. package/dist/sdk/history-provenance.d.ts +40 -40
  479. package/dist/sdk/history-read.d.ts +24 -24
  480. package/dist/sdk/history-redact.d.ts +68 -68
  481. package/dist/sdk/history-repair.d.ts +92 -92
  482. package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
  483. package/dist/sdk/improvement-ledger.d.ts +62 -62
  484. package/dist/sdk/index.d.ts +69 -69
  485. package/dist/sdk/init-agent-guidance.d.ts +68 -68
  486. package/dist/sdk/init.d.ts +117 -117
  487. package/dist/sdk/invocation-author.d.ts +1 -1
  488. package/dist/sdk/item-children.d.ts +15 -15
  489. package/dist/sdk/item-metadata-index.d.ts +2 -2
  490. package/dist/sdk/item-schedule.d.ts +9 -9
  491. package/dist/sdk/item-transaction.d.ts +73 -73
  492. package/dist/sdk/learnings.d.ts +23 -23
  493. package/dist/sdk/lifecycle/append.d.ts +8 -8
  494. package/dist/sdk/lifecycle/claim.d.ts +38 -38
  495. package/dist/sdk/lifecycle/close-many.d.ts +71 -71
  496. package/dist/sdk/lifecycle/close.d.ts +18 -18
  497. package/dist/sdk/lifecycle/copy.d.ts +10 -10
  498. package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
  499. package/dist/sdk/lifecycle/create.d.ts +88 -88
  500. package/dist/sdk/lifecycle/delete.d.ts +15 -15
  501. package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
  502. package/dist/sdk/lifecycle/focus.d.ts +6 -6
  503. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
  504. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
  505. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
  506. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  507. package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
  508. package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
  509. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
  510. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
  511. package/dist/sdk/lifecycle/plan.d.ts +127 -127
  512. package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
  513. package/dist/sdk/lifecycle/reopen.d.ts +15 -15
  514. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
  515. package/dist/sdk/lifecycle/restore.d.ts +34 -34
  516. package/dist/sdk/lifecycle/restore.js +1 -1
  517. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
  518. package/dist/sdk/lifecycle/task-composition.d.ts +7 -7
  519. package/dist/sdk/lifecycle/update-many.d.ts +61 -61
  520. package/dist/sdk/lifecycle/update.d.ts +120 -120
  521. package/dist/sdk/lifecycle-completion.d.ts +14 -14
  522. package/dist/sdk/lifecycle-policy.d.ts +31 -31
  523. package/dist/sdk/linked-artifacts.d.ts +58 -58
  524. package/dist/sdk/mcp/apps.d.ts +28 -28
  525. package/dist/sdk/mcp/authorization.d.ts +66 -66
  526. package/dist/sdk/mcp/discovery.d.ts +67 -67
  527. package/dist/sdk/mcp/interactions.d.ts +49 -49
  528. package/dist/sdk/mcp/protocol.d.ts +63 -63
  529. package/dist/sdk/mcp/skills.d.ts +62 -62
  530. package/dist/sdk/mcp/subscriptions.d.ts +26 -26
  531. package/dist/sdk/mcp/tasks.d.ts +51 -51
  532. package/dist/sdk/mcp/transport.d.ts +17 -17
  533. package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
  534. package/dist/sdk/merge/driver.d.ts +38 -38
  535. package/dist/sdk/merge/index.d.ts +5 -5
  536. package/dist/sdk/merge/install.d.ts +48 -48
  537. package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
  538. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  539. package/dist/sdk/merge/receipt-schema.d.ts +11 -11
  540. package/dist/sdk/merge/receipts.d.ts +111 -111
  541. package/dist/sdk/merge/reconcile.d.ts +20 -20
  542. package/dist/sdk/merge/three-way.d.ts +50 -50
  543. package/dist/sdk/merge/three-way.js +2 -2
  544. package/dist/sdk/merge/worktree-config.d.ts +3 -3
  545. package/dist/sdk/mutation-events.d.ts +62 -62
  546. package/dist/sdk/mutation-guard.d.ts +134 -134
  547. package/dist/sdk/notes.d.ts +28 -28
  548. package/dist/sdk/output/table-rows.d.ts +6 -6
  549. package/dist/sdk/output-contracts.d.ts +26 -26
  550. package/dist/sdk/output-projection.d.ts +108 -108
  551. package/dist/sdk/output-token-accounting.d.ts +18 -18
  552. package/dist/sdk/output.d.ts +18 -18
  553. package/dist/sdk/ownership-source.d.ts +1 -1
  554. package/dist/sdk/package-import-adapters.d.ts +51 -51
  555. package/dist/sdk/package-migrations.d.ts +3 -3
  556. package/dist/sdk/package-runtime-options.d.ts +3 -3
  557. package/dist/sdk/pagination.d.ts +28 -28
  558. package/dist/sdk/pagination.js +1 -1
  559. package/dist/sdk/profile.d.ts +72 -72
  560. package/dist/sdk/provenance.d.ts +37 -37
  561. package/dist/sdk/public-surface.json +1 -1
  562. package/dist/sdk/query/activity.d.ts +84 -84
  563. package/dist/sdk/query/aggregate.d.ts +109 -109
  564. package/dist/sdk/query/calendar.d.ts +95 -95
  565. package/dist/sdk/query/complete-list.d.ts +35 -35
  566. package/dist/sdk/query/context.d.ts +300 -300
  567. package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
  568. package/dist/sdk/query/get.d.ts +54 -54
  569. package/dist/sdk/query/history.d.ts +38 -38
  570. package/dist/sdk/query/item-filter-options.d.ts +41 -41
  571. package/dist/sdk/query/light-metadata.d.ts +1 -1
  572. package/dist/sdk/query/list-filter-shared.d.ts +4 -4
  573. package/dist/sdk/query/list.d.ts +167 -167
  574. package/dist/sdk/query/list.js +1 -1
  575. package/dist/sdk/query/multi-value-filters.d.ts +6 -6
  576. package/dist/sdk/query/next-ready-budget.d.ts +8 -8
  577. package/dist/sdk/query/next.d.ts +94 -94
  578. package/dist/sdk/query/parsers.d.ts +3 -3
  579. package/dist/sdk/query/projection-contracts.d.ts +18 -18
  580. package/dist/sdk/query/search/corpus.d.ts +15 -15
  581. package/dist/sdk/query/search/filters.d.ts +15 -15
  582. package/dist/sdk/query/search/input.d.ts +8 -8
  583. package/dist/sdk/query/search/lexical.d.ts +10 -10
  584. package/dist/sdk/query/search/response.d.ts +22 -22
  585. package/dist/sdk/query/search/semantic.d.ts +133 -133
  586. package/dist/sdk/query/search/types.d.ts +65 -65
  587. package/dist/sdk/query/search-contracts.d.ts +53 -53
  588. package/dist/sdk/query/search-pagination.d.ts +21 -21
  589. package/dist/sdk/query/search-rendering.d.ts +30 -30
  590. package/dist/sdk/query/search.d.ts +60 -60
  591. package/dist/sdk/query/workspace-contracts.d.ts +2 -2
  592. package/dist/sdk/query.d.ts +6 -6
  593. package/dist/sdk/read-output/continuation.d.ts +11 -11
  594. package/dist/sdk/read-output/extension.d.ts +3 -3
  595. package/dist/sdk/read-output/options.d.ts +7 -7
  596. package/dist/sdk/read-output/provenance.d.ts +6 -6
  597. package/dist/sdk/read-output-budget.d.ts +11 -11
  598. package/dist/sdk/read-output-contracts.d.ts +112 -112
  599. package/dist/sdk/read-output-contracts.js +1 -1
  600. package/dist/sdk/read-output-rows.d.ts +15 -15
  601. package/dist/sdk/read-output-session.d.ts +29 -29
  602. package/dist/sdk/relationship-analytics.d.ts +46 -46
  603. package/dist/sdk/relationship-context.d.ts +48 -48
  604. package/dist/sdk/relationship-history.d.ts +59 -59
  605. package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
  606. package/dist/sdk/relationship-migration.d.ts +14 -14
  607. package/dist/sdk/relationships.d.ts +46 -46
  608. package/dist/sdk/reproducibility/process.d.ts +9 -9
  609. package/dist/sdk/runtime/actions.d.ts +1 -1
  610. package/dist/sdk/runtime/context.d.ts +15 -15
  611. package/dist/sdk/runtime/schema-preview.d.ts +1 -1
  612. package/dist/sdk/runtime/schema.d.ts +1 -1
  613. package/dist/sdk/runtime-action-aliases.d.ts +3 -3
  614. package/dist/sdk/runtime-extended-actions.d.ts +9 -9
  615. package/dist/sdk/runtime-input.d.ts +29 -29
  616. package/dist/sdk/runtime-primitives.d.ts +53 -53
  617. package/dist/sdk/runtime-primitives.js +1 -1
  618. package/dist/sdk/runtime-public-contracts.d.ts +46 -46
  619. package/dist/sdk/runtime-stats-options.d.ts +1 -1
  620. package/dist/sdk/runtime.d.ts +374 -374
  621. package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
  622. package/dist/sdk/schema-migration.d.ts +79 -79
  623. package/dist/sdk/schema.d.ts +224 -224
  624. package/dist/sdk/search-refresh-worker.d.ts +1 -1
  625. package/dist/sdk/similarity-scoring.d.ts +10 -10
  626. package/dist/sdk/similarity.d.ts +73 -73
  627. package/dist/sdk/start-task-status.d.ts +1 -1
  628. package/dist/sdk/stats.d.ts +72 -72
  629. package/dist/sdk/structured-mutations.d.ts +13 -13
  630. package/dist/sdk/telemetry-flush.d.ts +1 -1
  631. package/dist/sdk/telemetry.d.ts +32 -32
  632. package/dist/sdk/templates.d.ts +35 -35
  633. package/dist/sdk/test/batch.d.ts +50 -50
  634. package/dist/sdk/test/command-args.d.ts +2 -2
  635. package/dist/sdk/test/entry.d.ts +4 -4
  636. package/dist/sdk/test/execution-receipts.d.ts +5 -5
  637. package/dist/sdk/test/execution.d.ts +247 -247
  638. package/dist/sdk/test/json-path.d.ts +4 -4
  639. package/dist/sdk/test/linked-command-detection.d.ts +36 -36
  640. package/dist/sdk/test/measurements.d.ts +10 -10
  641. package/dist/sdk/test/parsers.d.ts +18 -18
  642. package/dist/sdk/test/prerequisites.d.ts +3 -3
  643. package/dist/sdk/test/runs.d.ts +43 -43
  644. package/dist/sdk/test/trust.d.ts +15 -15
  645. package/dist/sdk/test/update.d.ts +23 -23
  646. package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
  647. package/dist/sdk/testing.d.ts +248 -248
  648. package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
  649. package/dist/sdk/traceability/source-traceability.d.ts +50 -50
  650. package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
  651. package/dist/sdk/workspace-contracts.d.ts +20 -20
  652. package/dist/sdk/workspace-memory.d.ts +42 -42
  653. package/dist/sdk/workspace-recipe.d.ts +9 -9
  654. package/dist/sdk/workspace-snapshot.d.ts +60 -60
  655. package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
  656. package/dist/sdk/workspace-transaction.d.ts +26 -26
  657. package/dist/sdk/workspace.d.ts +9 -9
  658. package/dist/types.d.ts +540 -540
  659. package/docs/COMMANDS.md +11 -2
  660. package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
  661. package/docs/LINKED_TEST_EDITS.md +15 -0
  662. package/docs/RELEASING.md +2 -0
  663. package/docs/TESTING.md +21 -1
  664. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +4 -3
  665. package/marketplace.json +1 -1
  666. package/package.json +3 -1
  667. package/packages/pm-beads/package.json +1 -1
  668. package/packages/pm-calendar/package.json +1 -1
  669. package/packages/pm-command-kit/package.json +1 -1
  670. package/packages/pm-digital-twin/package.json +1 -1
  671. package/packages/pm-governance-audit/package.json +1 -1
  672. package/packages/pm-guide-shell/package.json +1 -1
  673. package/packages/pm-kanban/package.json +1 -1
  674. package/packages/pm-lifecycle-hooks/package.json +1 -1
  675. package/packages/pm-linked-test-adapters/package.json +1 -1
  676. package/packages/pm-search-advanced/package.json +1 -1
  677. package/packages/pm-templates/package.json +1 -1
  678. package/packages/pm-todos/package.json +1 -1
  679. package/packages/pm-vcs/package.json +1 -1
  680. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  681. package/plugins/pm-claude/package.json +1 -1
  682. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  683. package/plugins/pm-codex/package.json +1 -1
  684. package/plugins/pm-codex/plugin.json +1 -1
  685. package/runtime-dependencies.json +1 -1
  686. package/scripts/finalize-build.mjs +9 -3
  687. package/dist/cli-bundle/chunks/chunk-66BZVFIK.js +0 -6
  688. package/dist/cli-bundle/chunks/chunk-IDEHMKYZ.js +0 -235
  689. package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
  690. package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
  691. package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
  692. package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
@@ -2,70 +2,70 @@ import { type VerifiedHistoryRewriteState } from "../../core/history/history-rew
2
2
  import { verifyHistoryChain } from "../../core/history/replay.js";
3
3
  import type { ItemTypeRegistry } from "../../core/item/type-registry.js";
4
4
  import { readLocatedItem } from "../../core/store/item-store.js";
5
- import type { HistoryEntry, PmSettings } from "../../types/index.js";
5
+ import type { HistoryEntry,PmSettings } from "../../types/index.js";
6
6
  import type { HistorySubject } from "./subject.js";
7
7
  /** Built-in maintenance policies; each keeps its established diagnostics and hook names. */
8
8
  export type HistoryMaintenanceOperation = "history-redact" | "history-repair" | "history-compact";
9
9
  /** Shared execution controls for a preview or audited stream rewrite. */
10
10
  export interface HistoryMaintenanceOptions {
11
11
  /** Compute and verify the plan without acquiring a write lock or persisting it. */
12
- dryRun?: boolean;
12
+ dryRun?:boolean;
13
13
  /** Explicit principal override; otherwise use the workspace identity policy. */
14
- author?: string;
14
+ author?:string;
15
15
  /** Explicit ownership or stale-lock override passed through the existing governance checks. */
16
- force?: boolean;
16
+ force?:boolean;
17
17
  }
18
18
  /** Inputs captured before a transform, bound to the later under-lock drift checks. */
19
19
  export interface HistoryMaintenanceSnapshot {
20
20
  /** Original bytes used to decode `entries`, never a second independent read. */
21
- raw: string;
21
+ raw:string;
22
22
  /** Original stream, including historical anchors and immutable record evidence. */
23
- entries: HistoryEntry[];
23
+ entries:HistoryEntry[];
24
24
  /** Chain verdict for the original entries; repair may deliberately accept drift. */
25
- verification: ReturnType<typeof verifyHistoryChain>;
25
+ verification:ReturnType<typeof verifyHistoryChain>;
26
26
  /** Current item bytes and document, or null for a deleted item's retained history. */
27
- loadedItem: Awaited<ReturnType<typeof readLocatedItem>> | null;
27
+ loadedItem:Awaited<ReturnType<typeof readLocatedItem>> | null;
28
28
  /** Resolved identity shared by audit entry construction and lock ownership. */
29
- author: string;
29
+ author:string;
30
30
  }
31
31
  /** Verified outcome supplied to the operation's existing public result renderer. */
32
32
  export interface HistoryMaintenanceOutcome {
33
33
  /** Verification of the exact planned entries before persistence. */
34
- verification: ReturnType<typeof verifyHistoryChain>;
34
+ verification:ReturnType<typeof verifyHistoryChain>;
35
35
  /** Governance and write-hook warnings, empty for a preview or unchanged plan. */
36
- warnings: string[];
36
+ warnings:string[];
37
37
  }
38
38
  /** Operation-owned transform with optional transactional item changes and receipt checks. */
39
39
  export interface HistoryMaintenancePlan<Result> {
40
40
  /** Whether the transformation warrants persistence when not previewing. */
41
- changed: boolean;
41
+ changed:boolean;
42
42
  /** Final stream including any operation-specific baseline or audit marker. */
43
- rewrittenEntries: HistoryEntry[];
43
+ rewrittenEntries:HistoryEntry[];
44
44
  /** Additional evidence check executed under the lock before any write. */
45
- beforeWrite?: () => Promise<void>;
45
+ beforeWrite?:() => Promise<void>;
46
46
  /** Override only when history and item bytes must share a rollback transaction. */
47
- applyRewrite?: (verified: VerifiedHistoryRewriteState) => Promise<void>;
47
+ applyRewrite?:(verified:VerifiedHistoryRewriteState) => Promise<void>;
48
48
  /** Override when the operation must also dispatch item hooks or derived-index warnings. */
49
- afterWrite?: () => Promise<string[]>;
49
+ afterWrite?:() => Promise<string[]>;
50
50
  /** Preserve the operation's public report shape after preview or application completes. */
51
- report: (outcome: HistoryMaintenanceOutcome) => Result;
51
+ report:(outcome:HistoryMaintenanceOutcome) => Result;
52
52
  }
53
53
  /** Resolved workspace and transform supplied by built-ins or SDK integrations. */
54
54
  export interface HistoryMaintenanceParams<Result> {
55
55
  /** Initialized tracker root whose settings and subject were resolved by the caller. */
56
- pmRoot: string;
56
+ pmRoot:string;
57
57
  /** Live item or retained deleted-item history selected for maintenance. */
58
- subject: HistorySubject;
58
+ subject:HistorySubject;
59
59
  /** Workspace policy used consistently for the snapshot and locked write. */
60
- settings: PmSettings;
60
+ settings:PmSettings;
61
61
  /** Active item-folder mapping, including package-provided types. */
62
- typeRegistry: ItemTypeRegistry;
62
+ typeRegistry:ItemTypeRegistry;
63
63
  /** Maintenance policy whose diagnostic and hook compatibility must be preserved. */
64
- operation: HistoryMaintenanceOperation;
64
+ operation:HistoryMaintenanceOperation;
65
65
  /** Preview and ownership controls. */
66
- options: HistoryMaintenanceOptions;
66
+ options:HistoryMaintenanceOptions;
67
67
  /** Pure planning or evidence reads; persistence belongs in the returned transaction callbacks. */
68
- transform: (snapshot: HistoryMaintenanceSnapshot) => HistoryMaintenancePlan<Result> | Promise<HistoryMaintenancePlan<Result>>;
68
+ transform:(snapshot:HistoryMaintenanceSnapshot) => HistoryMaintenancePlan<Result> | Promise<HistoryMaintenancePlan<Result>>;
69
69
  }
70
70
  /** Verify every transform before writing and reject concurrent item or stream changes under the lock. */
71
- export declare function runHistoryMaintenance<Result>(params: HistoryMaintenanceParams<Result>): Promise<Result>;
71
+ export declare function runHistoryMaintenance<Result>(params:HistoryMaintenanceParams<Result>):Promise<Result>;
@@ -1,35 +1,35 @@
1
1
  import { type HistoryItemHashVersion } from "../../core/history/history.js";
2
2
  import type { ItemTypeRegistry } from "../../core/item/type-registry.js";
3
- import type { HistoryEntry, PmSettings } from "../../types/index.js";
3
+ import type { HistoryEntry,PmSettings } from "../../types/index.js";
4
4
  import type { HistorySubject } from "../history-redact.js";
5
- import type { HistoryRepairCommandOptions, HistoryRepairResult } from "../history-repair.js";
5
+ import type { HistoryRepairCommandOptions,HistoryRepairResult } from "../history-repair.js";
6
6
  /** Evidence describing only the discarded suffix, without retaining its contents. */
7
7
  export interface HistorySalvageReceipt {
8
8
  /** One-based physical line where invalid trailing bytes begin. */
9
- first_invalid_line: number;
9
+ first_invalid_line:number;
10
10
  /** UTF-8 bytes removed from the suffix. */
11
- discarded_bytes: number;
11
+ discarded_bytes:number;
12
12
  /** SHA-256 of the removed bytes for local backup comparison. */
13
- discarded_sha256: string;
13
+ discarded_sha256:string;
14
14
  /** Number of complete verified records retained. */
15
- retained_entries: number;
15
+ retained_entries:number;
16
16
  }
17
17
  /**
18
18
  * Select a hash-verified prefix. Any parseable JSON after the first invalid
19
19
  * line makes the corruption interior and therefore unsalvageable by truncation.
20
20
  */
21
- export declare function inspectHistoryTail(raw: string): {
22
- entries: HistoryEntry[];
23
- prefix: string;
24
- receipt: HistorySalvageReceipt | null;
25
- itemHashVersion: HistoryItemHashVersion;
21
+ export declare function inspectHistoryTail(raw:string):{
22
+ entries:HistoryEntry[];
23
+ prefix:string;
24
+ receipt:HistorySalvageReceipt | null;
25
+ itemHashVersion:HistoryItemHashVersion;
26
26
  };
27
27
  /** Salvage one explicitly selected stream under its normal ownership and lock policy. */
28
- export declare function salvageHistoryTail(params: {
29
- pmRoot: string;
30
- subject: HistorySubject;
31
- settings: PmSettings;
32
- typeRegistry: ItemTypeRegistry;
33
- options: HistoryRepairCommandOptions;
34
- author: string;
35
- }): Promise<HistoryRepairResult>;
28
+ export declare function salvageHistoryTail(params:{
29
+ pmRoot:string;
30
+ subject:HistorySubject;
31
+ settings:PmSettings;
32
+ typeRegistry:ItemTypeRegistry;
33
+ options:HistoryRepairCommandOptions;
34
+ author:string;
35
+ }):Promise<HistoryRepairResult>;
@@ -1,19 +1,19 @@
1
1
  import { locateItem } from "../../core/store/item-store.js";
2
2
  import type { PmSettings } from "../../types/index.js";
3
3
  /** Resolve initialized workspace policy once for single-stream and bulk maintenance. */
4
- export declare function resolveHistoryWorkspace(pmPath: string | undefined): Promise<{
5
- pmRoot: string;
6
- settings: PmSettings;
7
- typeRegistry: import("../../core/item/type-registry.js").ItemTypeRegistry;
4
+ export declare function resolveHistoryWorkspace(pmPath:string | undefined):Promise<{
5
+ pmRoot:string;
6
+ settings:PmSettings;
7
+ typeRegistry:import("../../core/item/type-registry.js").ItemTypeRegistry;
8
8
  }>;
9
9
  /** Canonical stream address, retaining item location only when the current item exists. */
10
10
  export interface HistorySubject {
11
11
  /** Stable identifier used to reference this record across commands and storage. */
12
- id: string;
12
+ id:string;
13
13
  /** Filesystem path used for history resolution. */
14
- historyPath: string;
14
+ historyPath:string;
15
15
  /** Current item location, or null when only a deleted item's history remains. */
16
- located: Awaited<ReturnType<typeof locateItem>>;
16
+ located:Awaited<ReturnType<typeof locateItem>>;
17
17
  }
18
18
  /** Resolve a current item first, then retained streams under normalized and raw legacy IDs. */
19
- export declare function resolveHistorySubject(pmRoot: string, id: string, settings: PmSettings, typeToFolder: Record<string, string>): Promise<HistorySubject>;
19
+ export declare function resolveHistorySubject(pmRoot:string,id:string,settings:PmSettings,typeToFolder:Record<string,string>):Promise<HistorySubject>;
@@ -5,137 +5,137 @@
5
5
  * immutable history event index without introducing telemetry-owned state.
6
6
  */
7
7
  import { type HarnessSignalDescriptor } from "../core/shared/author.js";
8
- import type { HistoryEntry, ItemMetadata } from "../types/index.js";
9
- import { type AgentProvenanceDescriptorCoverage, type AgentProvenanceDimensionCoverage } from "./provenance.js";
8
+ import type { HistoryEntry,ItemMetadata } from "../types/index.js";
9
+ import { type AgentProvenanceDescriptorCoverage,type AgentProvenanceDimensionCoverage } from "./provenance.js";
10
10
  /** Bounded immutable-history window controls shared by analytics surfaces. */
11
11
  export interface HistoryAnalyticsWindowOptions {
12
12
  /** Inclusive ISO timestamp or negative day/hour duration such as -30d. */
13
- since?: string;
13
+ since?:string;
14
14
  /** Maximum indexed events consumed across all pages. */
15
- eventLimit?: number;
15
+ eventLimit?:number;
16
16
  /** Minimum denominator required before a rate is reported. */
17
- minimumSample?: number;
17
+ minimumSample?:number;
18
18
  }
19
19
  /** Read receipt proving how much immutable history contributed. */
20
20
  export interface HistoryAnalyticsWindowReceipt {
21
21
  /** Inclusive lower bound used for the scan. */
22
- since: string;
22
+ since:string;
23
23
  /** Number of indexed immutable events inspected. */
24
- events: number;
24
+ events:number;
25
25
  /** Whether the configured event ceiling omitted matching rows. */
26
- truncated: boolean;
26
+ truncated:boolean;
27
27
  /** Cursor that resumes after the last inspected event when truncated. */
28
- next_cursor?: string;
28
+ next_cursor?:string;
29
29
  /** Derived read source. */
30
- source: "history_event_index";
30
+ source:"history_event_index";
31
31
  }
32
32
  /** Live declared-versus-observed provenance report. */
33
33
  export interface ProvenanceCoverageAnalytics {
34
34
  /** Descriptor coverage for every declared dimension. */
35
- descriptors: AgentProvenanceDescriptorCoverage[];
35
+ descriptors:AgentProvenanceDescriptorCoverage[];
36
36
  /** Per-harness availability over the bounded event window. */
37
- observations: AgentProvenanceDimensionCoverage[];
37
+ observations:AgentProvenanceDimensionCoverage[];
38
38
  /** Declared dimensions with enough explicit samples but no observations. */
39
- inert: Array<{
40
- harness: string;
41
- dimension: string;
42
- explicit_samples: number;
39
+ inert:Array<{
40
+ harness:string;
41
+ dimension:string;
42
+ explicit_samples:number;
43
43
  }>;
44
44
  /** Dimensions no configured harness declares. */
45
- undeclared: string[];
45
+ undeclared:string[];
46
46
  /** Stable warning codes suitable for health/gate adapters. */
47
- warnings: string[];
47
+ warnings:string[];
48
48
  /** Bounded source receipt. */
49
- window: HistoryAnalyticsWindowReceipt;
49
+ window:HistoryAnalyticsWindowReceipt;
50
50
  }
51
51
  /** One bounded attribution bucket with honest denominator states. */
52
52
  export interface FleetAttributionRow {
53
53
  /** Recorded grouping value. */
54
- value: string;
54
+ value:string;
55
55
  /** Immutable events attributed to the bucket. */
56
- events: number;
56
+ events:number;
57
57
  /** State-changing events attributed to the bucket. */
58
- state_events: number;
58
+ state_events:number;
59
59
  /** Annotation/evidence events attributed to the bucket. */
60
- annotation_events: number;
60
+ annotation_events:number;
61
61
  /** Terminal transitions attributed to the bucket. */
62
- closes: number;
62
+ closes:number;
63
63
  /** Active transitions after a terminal transition in the observed window. */
64
- reopens: number;
64
+ reopens:number;
65
65
  /** Issue items linked discovered_from to work closed by this bucket. */
66
- defect_escapes: number;
66
+ defect_escapes:number;
67
67
  /** Terminal transitions per observed day, or null for insufficient samples. */
68
- throughput_per_day: number | null;
68
+ throughput_per_day:number | null;
69
69
  /** Reopens divided by closes, or null for insufficient samples. */
70
- rework_rate: number | null;
70
+ rework_rate:number | null;
71
71
  /** Defect escapes divided by closes, or null for insufficient samples. */
72
- defect_escape_rate: number | null;
72
+ defect_escape_rate:number | null;
73
73
  /** Denominator state preventing tiny samples from masquerading as rates. */
74
- sample_status: "available" | "insufficient";
74
+ sample_status:"available" | "insufficient";
75
75
  }
76
76
  /** One supported fleet grouping dimension. */
77
77
  export interface FleetAttributionDimension {
78
78
  /** Stable dimension name. */
79
- dimension: "harness" | "model" | "author_source";
79
+ dimension:"harness" | "model" | "author_source";
80
80
  /** Whether at least one event supplied this dimension. */
81
- status: "available" | "unavailable";
81
+ status:"available" | "unavailable";
82
82
  /** Deterministically sorted bounded aggregate rows. */
83
- rows: FleetAttributionRow[];
83
+ rows:FleetAttributionRow[];
84
84
  }
85
85
  /** Observational fleet analytics derived only from immutable history. */
86
86
  export interface FleetAttributionAnalytics {
87
87
  /** Grouped analytics for every supported provenance dimension. */
88
- dimensions: FleetAttributionDimension[];
88
+ dimensions:FleetAttributionDimension[];
89
89
  /** Minimum close denominator required for rates. */
90
- minimum_sample: number;
90
+ minimum_sample:number;
91
91
  /** Safety statement retained in every transport. */
92
- policy: "observational_only_not_for_authorization_or_routing";
92
+ policy:"observational_only_not_for_authorization_or_routing";
93
93
  /** Bounded source receipt. */
94
- window: HistoryAnalyticsWindowReceipt;
94
+ window:HistoryAnalyticsWindowReceipt;
95
95
  }
96
96
  /** One immutable history entry paired with its owning tracked item. */
97
97
  export interface HistoryAnalyticsEvent {
98
98
  /** Tracked item owning the immutable event. */
99
- item_id: string;
99
+ item_id:string;
100
100
  /** Immutable history entry consumed by analytics. */
101
- entry: HistoryEntry;
101
+ entry:HistoryEntry;
102
102
  }
103
103
  /** Reusable bounded history read shared across multiple analytics projections. */
104
104
  export interface HistoryAnalyticsWindow {
105
105
  /** Immutable events retained by the configured bound. */
106
- events: HistoryAnalyticsEvent[];
106
+ events:HistoryAnalyticsEvent[];
107
107
  /** Receipt describing the bounded source read. */
108
- receipt: HistoryAnalyticsWindowReceipt;
108
+ receipt:HistoryAnalyticsWindowReceipt;
109
109
  }
110
- declare function parseHistoryAnalyticsLimit(value: number | undefined): number;
111
- declare function parseMinimumSample(value: number | undefined): number;
112
- declare function resolveHistoryAnalyticsSince(value: string | undefined): string;
110
+ declare function parseHistoryAnalyticsLimit(value:number | undefined):number;
111
+ declare function parseMinimumSample(value:number | undefined):number;
112
+ declare function resolveHistoryAnalyticsSince(value:string | undefined):string;
113
113
  /** Read one reusable bounded immutable-history window. */
114
- export declare function readHistoryAnalyticsWindow(pmRoot: string, options: HistoryAnalyticsWindowOptions): Promise<HistoryAnalyticsWindow>;
115
- declare function provenanceValue(entry: HistoryEntry, dimension: FleetAttributionDimension["dimension"]): string | undefined;
116
- declare function statusFromEntry(entry: HistoryEntry): string | undefined;
117
- declare function annotationOperation(op: string): boolean;
118
- declare function buildFleetDimension(dimension: FleetAttributionDimension["dimension"], events: readonly HistoryAnalyticsEvent[], items: readonly Pick<ItemMetadata, "id" | "type" | "dependencies">[], terminalStatuses: ReadonlySet<string>, minimumSample: number, windowDays: number): FleetAttributionDimension;
119
- declare function resolveHistoryWindowDays(events: readonly HistoryAnalyticsEvent[], since: string): number;
114
+ export declare function readHistoryAnalyticsWindow(pmRoot:string,options:HistoryAnalyticsWindowOptions):Promise<HistoryAnalyticsWindow>;
115
+ declare function provenanceValue(entry:HistoryEntry,dimension:FleetAttributionDimension["dimension"]):string | undefined;
116
+ declare function statusFromEntry(entry:HistoryEntry):string | undefined;
117
+ declare function annotationOperation(op:string):boolean;
118
+ declare function buildFleetDimension(dimension:FleetAttributionDimension["dimension"],events:readonly HistoryAnalyticsEvent[],items:readonly Pick<ItemMetadata,"id" | "type" | "dependencies">[],terminalStatuses:ReadonlySet<string>,minimumSample:number,windowDays:number):FleetAttributionDimension;
119
+ declare function resolveHistoryWindowDays(events:readonly HistoryAnalyticsEvent[],since:string):number;
120
120
  /** Evaluate a negative-control-friendly declared-versus-observed coverage gate. */
121
- export declare function evaluateProvenanceCoverage(entries: readonly HistoryEntry[], descriptors: readonly HarnessSignalDescriptor[], minimumSample: number): Omit<ProvenanceCoverageAnalytics, "window">;
121
+ export declare function evaluateProvenanceCoverage(entries:readonly HistoryEntry[],descriptors:readonly HarnessSignalDescriptor[],minimumSample:number):Omit<ProvenanceCoverageAnalytics,"window">;
122
122
  /** Read live, bounded provenance coverage from authoritative history. */
123
- export declare function runProvenanceCoverageAnalytics(pmRoot: string, descriptors?: readonly HarnessSignalDescriptor[], options?: HistoryAnalyticsWindowOptions): Promise<ProvenanceCoverageAnalytics>;
123
+ export declare function runProvenanceCoverageAnalytics(pmRoot:string,descriptors?:readonly HarnessSignalDescriptor[],options?:HistoryAnalyticsWindowOptions):Promise<ProvenanceCoverageAnalytics>;
124
124
  /** Project provenance coverage from an already-read immutable-history window. */
125
- export declare function projectProvenanceCoverageAnalytics(window: HistoryAnalyticsWindow, descriptors?: readonly HarnessSignalDescriptor[], options?: Pick<HistoryAnalyticsWindowOptions, "minimumSample">): ProvenanceCoverageAnalytics;
125
+ export declare function projectProvenanceCoverageAnalytics(window:HistoryAnalyticsWindow,descriptors?:readonly HarnessSignalDescriptor[],options?:Pick<HistoryAnalyticsWindowOptions,"minimumSample">):ProvenanceCoverageAnalytics;
126
126
  /** Derive bounded fleet rates grouped by harness, model, and author source. */
127
- export declare function runFleetAttributionAnalytics(pmRoot: string, items: readonly Pick<ItemMetadata, "id" | "type" | "dependencies">[], terminalStatuses: ReadonlySet<string>, options?: HistoryAnalyticsWindowOptions): Promise<FleetAttributionAnalytics>;
127
+ export declare function runFleetAttributionAnalytics(pmRoot:string,items:readonly Pick<ItemMetadata,"id" | "type" | "dependencies">[],terminalStatuses:ReadonlySet<string>,options?:HistoryAnalyticsWindowOptions):Promise<FleetAttributionAnalytics>;
128
128
  /** Project fleet attribution from an already-read immutable-history window. */
129
- export declare function projectFleetAttributionAnalytics(window: HistoryAnalyticsWindow, items: readonly Pick<ItemMetadata, "id" | "type" | "dependencies">[], terminalStatuses: ReadonlySet<string>, options?: Pick<HistoryAnalyticsWindowOptions, "minimumSample">): FleetAttributionAnalytics;
129
+ export declare function projectFleetAttributionAnalytics(window:HistoryAnalyticsWindow,items:readonly Pick<ItemMetadata,"id" | "type" | "dependencies">[],terminalStatuses:ReadonlySet<string>,options?:Pick<HistoryAnalyticsWindowOptions,"minimumSample">):FleetAttributionAnalytics;
130
130
  /** Pure seams for deterministic analytics and negative-control tests. */
131
- export declare const _testOnlyHistoryAnalytics: {
132
- annotationOperation: typeof annotationOperation;
133
- buildFleetDimension: typeof buildFleetDimension;
134
- parseHistoryAnalyticsLimit: typeof parseHistoryAnalyticsLimit;
135
- parseMinimumSample: typeof parseMinimumSample;
136
- provenanceValue: typeof provenanceValue;
137
- resolveHistoryAnalyticsSince: typeof resolveHistoryAnalyticsSince;
138
- resolveHistoryWindowDays: typeof resolveHistoryWindowDays;
139
- statusFromEntry: typeof statusFromEntry;
131
+ export declare const _testOnlyHistoryAnalytics:{
132
+ annotationOperation:typeof annotationOperation;
133
+ buildFleetDimension:typeof buildFleetDimension;
134
+ parseHistoryAnalyticsLimit:typeof parseHistoryAnalyticsLimit;
135
+ parseMinimumSample:typeof parseMinimumSample;
136
+ provenanceValue:typeof provenanceValue;
137
+ resolveHistoryAnalyticsSince:typeof resolveHistoryAnalyticsSince;
138
+ resolveHistoryWindowDays:typeof resolveHistoryWindowDays;
139
+ statusFromEntry:typeof statusFromEntry;
140
140
  };
141
141
  export {};
@@ -1,132 +1,132 @@
1
- import { type HistoryCompactBulkSkipReason, type HistoryCompactScope } from "../core/history/history-compact-bulk.js";
1
+ import { type HistoryCompactBulkSkipReason,type HistoryCompactScope } from "../core/history/history-compact-bulk.js";
2
2
  import { type BulkIdsValue } from "../core/io/bulk-ids-input.js";
3
3
  import type { GlobalOptions } from "../core/shared/command-types.js";
4
4
  /** Documents the history compact command options payload exchanged by command, SDK, and package integrations. */
5
5
  export interface HistoryCompactCommandOptions {
6
6
  /** Value that configures or reports before for this contract. */
7
- before?: string;
7
+ before?:string;
8
8
  /** Value that configures or reports dry run for this contract. */
9
- dryRun?: boolean;
9
+ dryRun?:boolean;
10
10
  /** Value that configures or reports author for this contract. */
11
- author?: string;
11
+ author?:string;
12
12
  /** Human-readable explanation suitable for logs and agent-facing output. */
13
- message?: string;
13
+ message?:string;
14
14
  /** Value that configures or reports force for this contract. */
15
- force?: boolean;
15
+ force?:boolean;
16
16
  }
17
17
  type HistoryCompactBoundaryKind = "default" | "version" | "timestamp";
18
18
  /** Documents the history compact result payload exchanged by command, SDK, and package integrations. */
19
19
  export interface HistoryCompactResult {
20
20
  /** Stable identifier used to reference this record across commands and storage. */
21
- id: string;
21
+ id:string;
22
22
  /** Value that configures or reports dry run for this contract. */
23
- dry_run: boolean;
23
+ dry_run:boolean;
24
24
  /** Value that configures or reports changed for this contract. */
25
- changed: boolean;
25
+ changed:boolean;
26
26
  /** Value that configures or reports compact boundary for this contract. */
27
- compact_boundary: {
28
- kind: HistoryCompactBoundaryKind;
29
- before: string | null;
30
- entries_compacted: number;
31
- entries_retained: number;
32
- first_retained_entry: number | null;
27
+ compact_boundary:{
28
+ kind:HistoryCompactBoundaryKind;
29
+ before:string | null;
30
+ entries_compacted:number;
31
+ entries_retained:number;
32
+ first_retained_entry:number | null;
33
33
  };
34
34
  /** Value that configures or reports history for this contract. */
35
- history: {
36
- path: string;
37
- entries_scanned: number;
38
- entries_after: number;
39
- baseline_entry_added: boolean;
40
- audit_entry_added: boolean;
41
- verify_ok: boolean;
42
- verify_errors: string[];
35
+ history:{
36
+ path:string;
37
+ entries_scanned:number;
38
+ entries_after:number;
39
+ baseline_entry_added:boolean;
40
+ audit_entry_added:boolean;
41
+ verify_ok:boolean;
42
+ verify_errors:string[];
43
43
  };
44
44
  /** Value that configures or reports item for this contract. */
45
- item: {
46
- exists: boolean;
47
- path: string | null;
48
- matched_chain_before: boolean | null;
45
+ item:{
46
+ exists:boolean;
47
+ path:string | null;
48
+ matched_chain_before:boolean | null;
49
49
  };
50
50
  /** Value that configures or reports warnings for this contract. */
51
- warnings: string[];
51
+ warnings:string[];
52
52
  /** ISO 8601 timestamp recording when generated occurred. */
53
- generated_at: string;
53
+ generated_at:string;
54
54
  }
55
55
  /** Implements run history compact for the public runtime surface of this module. */
56
- export declare function runHistoryCompact(id: string, options: HistoryCompactCommandOptions, global: GlobalOptions): Promise<HistoryCompactResult>;
56
+ export declare function runHistoryCompact(id:string,options:HistoryCompactCommandOptions,global:GlobalOptions):Promise<HistoryCompactResult>;
57
57
  /** Default entry floor below which a stream is treated as already compact. */
58
58
  export declare const HISTORY_COMPACT_BULK_DEFAULT_MIN_ENTRIES = 3;
59
59
  /** Documents the bulk history compact command options payload exchanged by command, SDK, and package integrations. */
60
60
  export interface HistoryCompactBulkCommandOptions {
61
61
  /** Value that configures or reports ids for this contract. */
62
- ids?: BulkIdsValue;
62
+ ids?:BulkIdsValue;
63
63
  /** Value that configures or reports scope for this contract. */
64
- scope?: HistoryCompactScope;
64
+ scope?:HistoryCompactScope;
65
65
  /** Value that configures or reports all over for this contract. */
66
- allOver?: number;
66
+ allOver?:number;
67
67
  /** Value that configures or reports min entries for this contract. */
68
- minEntries?: number;
68
+ minEntries?:number;
69
69
  /** Value that configures or reports dry run for this contract. */
70
- dryRun?: boolean;
70
+ dryRun?:boolean;
71
71
  /** Value that configures or reports author for this contract. */
72
- author?: string;
72
+ author?:string;
73
73
  /** Human-readable explanation suitable for logs and agent-facing output. */
74
- message?: string;
74
+ message?:string;
75
75
  /** Value that configures or reports force for this contract. */
76
- force?: boolean;
76
+ force?:boolean;
77
77
  }
78
78
  /** Per-item outcome row in a bulk compaction pass. */
79
79
  export interface HistoryCompactBulkItemResult {
80
80
  /** Stable identifier used to reference this record across commands and storage. */
81
- id: string;
81
+ id:string;
82
82
  /** Value that configures or reports outcome for this contract. */
83
- outcome: "compacted" | "skipped" | "errored";
83
+ outcome:"compacted" | "skipped" | "errored";
84
84
  /** Value that configures or reports entries before for this contract. */
85
- entries_before: number;
85
+ entries_before:number;
86
86
  /** Value that configures or reports entries after for this contract. */
87
- entries_after: number | null;
87
+ entries_after:number | null;
88
88
  /** Value that configures or reports skip reason for this contract. */
89
- skip_reason: HistoryCompactBulkSkipReason | null;
89
+ skip_reason:HistoryCompactBulkSkipReason | null;
90
90
  /** Value that configures or reports changed for this contract. */
91
- changed: boolean;
91
+ changed:boolean;
92
92
  /** Value that configures or reports error for this contract. */
93
- error: string | null;
93
+ error:string | null;
94
94
  }
95
95
  /** Documents the bulk history compact result payload exchanged by command, SDK, and package integrations. */
96
96
  export interface HistoryCompactBulkResult {
97
97
  /** Value that configures or reports bulk for this contract. */
98
- bulk: true;
98
+ bulk:true;
99
99
  /** Value that configures or reports dry run for this contract. */
100
- dry_run: boolean;
100
+ dry_run:boolean;
101
101
  /** Value that configures or reports mode for this contract. */
102
- mode: "ids" | "scan";
102
+ mode:"ids" | "scan";
103
103
  /** Value that configures or reports scope for this contract. */
104
- scope: HistoryCompactScope | null;
104
+ scope:HistoryCompactScope | null;
105
105
  /** Value that configures or reports criteria for this contract. */
106
- criteria: {
107
- min_entries: number;
108
- all_over: number | null;
109
- policy_threshold_applied: boolean;
106
+ criteria:{
107
+ min_entries:number;
108
+ all_over:number | null;
109
+ policy_threshold_applied:boolean;
110
110
  };
111
111
  /** Value that configures or reports totals for this contract. */
112
- totals: {
113
- streams_considered: number;
114
- selected: number;
115
- items_compacted: number;
116
- items_skipped: number;
117
- items_errored: number;
112
+ totals:{
113
+ streams_considered:number;
114
+ selected:number;
115
+ items_compacted:number;
116
+ items_skipped:number;
117
+ items_errored:number;
118
118
  };
119
119
  /** Value that configures or reports results for this contract. */
120
- results: HistoryCompactBulkItemResult[];
120
+ results:HistoryCompactBulkItemResult[];
121
121
  /** ISO 8601 timestamp recording when generated occurred. */
122
- generated_at: string;
122
+ generated_at:string;
123
123
  }
124
124
  /** Enforce the `pm history-compact` target contract shared by the CLI and MCP surfaces: exactly one selection mode — a single item `<id>`, an explicit `--ids` list, or a scan selector (`--all-over` / `--closed` / `--all-streams`). */
125
- export declare function assertHistoryCompactTarget(id: string | undefined, bulk: {
126
- ids?: string[];
127
- allOver?: number;
128
- scope?: HistoryCompactScope;
129
- }): void;
125
+ export declare function assertHistoryCompactTarget(id:string | undefined,bulk:{
126
+ ids?:string[];
127
+ allOver?:number;
128
+ scope?:HistoryCompactScope;
129
+ }):void;
130
130
  /**
131
131
  * Bulk history compaction: compact every history stream matching the requested
132
132
  * selection (explicit `--ids`, a `--scope` lifecycle filter, and/or an
@@ -139,5 +139,5 @@ scope?: HistoryCompactScope;
139
139
  * given, the policy's `max_entries` is used as the scan threshold so the
140
140
  * configured policy drives the sweep.
141
141
  */
142
- export declare function runHistoryCompactBulk(options: HistoryCompactBulkCommandOptions, global: GlobalOptions): Promise<HistoryCompactBulkResult>;
142
+ export declare function runHistoryCompactBulk(options:HistoryCompactBulkCommandOptions,global:GlobalOptions):Promise<HistoryCompactBulkResult>;
143
143
  export {};
@@ -1,17 +1,17 @@
1
1
  import type { GlobalOptions } from "../core/shared/command-types.js";
2
- import { type HistoryCompactBulkResult, type HistoryCompactResult } from "./history-compact.js";
2
+ import { type HistoryCompactBulkResult,type HistoryCompactResult } from "./history-compact.js";
3
3
  /** Minimal action context required by MCP history maintenance adapters. */
4
4
  export interface HistoryMcpActionContext {
5
5
  /** Optional positional item id used by single-stream mode. */
6
- id?: string;
6
+ id?:string;
7
7
  /** Alias-rich MCP options normalized by the selected history adapter. */
8
- options: Record<string, unknown>;
8
+ options:Record<string,unknown>;
9
9
  /** Force flag forwarded to integrity-sensitive maintenance engines. */
10
- force?: boolean;
10
+ force?:boolean;
11
11
  /** Global tracker and output controls shared with native command handlers. */
12
- global: GlobalOptions;
12
+ global:GlobalOptions;
13
13
  }
14
14
  /** Dispatch single-stream or all-stream history repair from an MCP payload. */
15
- export declare function runMcpHistoryRepairAction(context: HistoryMcpActionContext): Promise<unknown>;
15
+ export declare function runMcpHistoryRepairAction(context:HistoryMcpActionContext):Promise<unknown>;
16
16
  /** Dispatch single or bounded bulk history compaction from an MCP payload. */
17
- export declare function runMcpHistoryCompactAction(context: HistoryMcpActionContext): Promise<HistoryCompactResult | HistoryCompactBulkResult>;
17
+ export declare function runMcpHistoryCompactAction(context:HistoryMcpActionContext):Promise<HistoryCompactResult | HistoryCompactBulkResult>;