@unbrained/pm-cli 2026.10.14 → 2026.10.17

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 (753) hide show
  1. package/.agents/skills/pm-developer/references/COMMAND_PLAYBOOK.md +1 -1
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/AGENTS.md +1 -0
  4. package/CHANGELOG.md +74 -2
  5. package/dist/cli/after-command-context-usage.d.ts +7 -7
  6. package/dist/cli/argv-utils.d.ts +4 -4
  7. package/dist/cli/bundle-integrity.d.ts +16 -16
  8. package/dist/cli/command-namespaces.d.ts +1 -1
  9. package/dist/cli/commander-usage.d.ts +34 -34
  10. package/dist/cli/commands/governance/validate.d.ts +1 -1
  11. package/dist/cli/commands/history/history-compact.d.ts +1 -1
  12. package/dist/cli/commands/history/history-redact.d.ts +1 -1
  13. package/dist/cli/commands/history/history-repair.d.ts +1 -1
  14. package/dist/cli/commands/history/restore.d.ts +1 -1
  15. package/dist/cli/commands/lifecycle/close.d.ts +1 -1
  16. package/dist/cli/commands/lifecycle/copy.d.ts +1 -1
  17. package/dist/cli/commands/lifecycle/delete.d.ts +1 -1
  18. package/dist/cli/commands/lifecycle/focus.d.ts +1 -1
  19. package/dist/cli/commands/query/get.d.ts +1 -1
  20. package/dist/cli/commands/workspace/merge.d.ts +1 -1
  21. package/dist/cli/commands/workspace/schema.d.ts +1 -1
  22. package/dist/cli/context-intent-invocation.d.ts +1 -1
  23. package/dist/cli/description-stdin.d.ts +1 -1
  24. package/dist/cli/error-guidance.d.ts +119 -119
  25. package/dist/cli/extension-command-help.d.ts +64 -64
  26. package/dist/cli/extension-command-help.js +2 -2
  27. package/dist/cli/extension-command-options.d.ts +18 -16
  28. package/dist/cli/extension-command-options.js +1 -1
  29. package/dist/cli/extension-recovery.d.ts +13 -13
  30. package/dist/cli/help-content.d.ts +22 -22
  31. package/dist/cli/help-content.js +3 -3
  32. package/dist/cli/help-json-payload.d.ts +45 -45
  33. package/dist/cli/invocation-profile.d.ts +5 -5
  34. package/dist/cli/main.d.ts +217 -217
  35. package/dist/cli/migration-gates.d.ts +24 -24
  36. package/dist/cli/option-values.d.ts +1 -1
  37. package/dist/cli/public.d.ts +1 -1
  38. package/dist/cli/register-annotations.d.ts +2 -2
  39. package/dist/cli/register-assurance.d.ts +1 -1
  40. package/dist/cli/register-files-lookup.d.ts +1 -1
  41. package/dist/cli/register-history-activity.d.ts +1 -1
  42. package/dist/cli/register-history-author.d.ts +1 -1
  43. package/dist/cli/register-history-maintenance.d.ts +1 -1
  44. package/dist/cli/register-list-query.d.ts +7 -7
  45. package/dist/cli/register-list-query.js +3 -3
  46. package/dist/cli/register-mutation-options.d.ts +1 -1
  47. package/dist/cli/register-mutation.d.ts +4 -4
  48. package/dist/cli/register-mutation.js +2 -2
  49. package/dist/cli/register-operations.d.ts +75 -75
  50. package/dist/cli/register-operations.js +1 -1
  51. package/dist/cli/register-setup.d.ts +4 -4
  52. package/dist/cli/register-structured-mutation.d.ts +8 -13
  53. package/dist/cli/register-structured-mutation.js +1 -1
  54. package/dist/cli/runtime/activation.d.ts +23 -23
  55. package/dist/cli/runtime/invocation-options.d.ts +12 -12
  56. package/dist/cli/runtime/invocation-options.js +1 -1
  57. package/dist/cli/runtime/projection-retry.d.ts +1 -1
  58. package/dist/cli/runtime/selection.d.ts +16 -16
  59. package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
  60. package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
  61. package/dist/cli/schema/registration.d.ts +1 -1
  62. package/dist/cli/schema-registration-helpers.d.ts +2 -2
  63. package/dist/cli/stats-analytics-json.d.ts +1 -1
  64. package/dist/cli-bundle/bundle-manifest.json +1 -1
  65. package/dist/cli-bundle/chunks/{chunk-LKESCZEN.js → chunk-3QKI3XNX.js} +2 -2
  66. package/dist/cli-bundle/chunks/chunk-4PNPDT2N.js +236 -0
  67. package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-6ZDKKOKM.js} +28 -28
  68. package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-B5QVGCZX.js} +2 -2
  69. package/dist/cli-bundle/chunks/{chunk-5LU6PWA4.js → chunk-EA2CG7UM.js} +2 -2
  70. package/dist/cli-bundle/chunks/chunk-HY7FQ7QX.js +2 -0
  71. package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-J4LPQCET.js} +2 -2
  72. package/dist/cli-bundle/chunks/chunk-JS3B2M4D.js +6 -0
  73. package/dist/cli-bundle/chunks/chunk-O4YBC3OM.js +30 -0
  74. package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-OZCSXX4D.js} +63 -64
  75. package/dist/cli-bundle/chunks/chunk-VMCSTFSO.js +2 -0
  76. package/dist/cli-bundle/chunks/chunk-W3KZ22DW.js +2 -0
  77. package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-X2ONXFBP.js} +2 -2
  78. package/dist/cli-bundle/chunks/chunk-X53HM753.js +20 -0
  79. package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-RU3QZSAQ.js} +7 -7
  80. package/dist/cli-bundle/chunks/register-mutation-EQYMT32A.js +20 -0
  81. package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-VXBGE4XI.js} +2 -2
  82. package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-UUDEGFRO.js} +2 -2
  83. package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-2IOHHNRT.js} +2 -2
  84. package/dist/cli-bundle/focused-chunks/chunk-5JEFDEL3.js +166 -0
  85. package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-AH6NX6GM.js} +2 -2
  86. package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-E33QA7PK.js} +2 -2
  87. package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-FTUZ3JF2.js} +6 -6
  88. package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-JXR6UKFM.js} +3 -3
  89. package/dist/cli-bundle/focused-chunks/chunk-LDKX4KYJ.js +2 -0
  90. package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-MBQF6HT6.js} +2 -2
  91. package/dist/cli-bundle/focused-chunks/chunk-NZO7GOXD.js +20 -0
  92. package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-PYC7BF6Z.js} +2 -2
  93. package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-QOSVJDOO.js} +61 -62
  94. package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-RBLSY6ML.js} +2 -2
  95. package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-RHTH5ILM.js} +2 -2
  96. package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-SIGIGZCG.js} +3 -3
  97. package/dist/cli-bundle/focused-chunks/chunk-TRFVAWF2.js +26 -0
  98. package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-UNTQE37U.js} +2 -2
  99. package/dist/cli-bundle/main.js +22 -22
  100. package/dist/cli-bundle/sdk-authoring.js +1 -1
  101. package/dist/cli-bundle/sdk-contracts.js +2 -2
  102. package/dist/cli-bundle/sdk-core.js +23 -23
  103. package/dist/cli-bundle/sdk-governance.js +1 -1
  104. package/dist/cli-bundle/sdk-graph.js +1 -1
  105. package/dist/cli-bundle/sdk-merge.js +54 -54
  106. package/dist/cli-bundle/sdk-query.js +1 -1
  107. package/dist/cli-bundle/sdk-runtime.js +1 -1
  108. package/dist/cli-bundle/sdk-testing.js +1 -1
  109. package/dist/cli-bundle/sdk.js +7 -7
  110. package/dist/cli.d.ts +9 -9
  111. package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
  112. package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
  113. package/dist/core/config/nested-settings.d.ts +20 -20
  114. package/dist/core/config/positional-value.d.ts +9 -9
  115. package/dist/core/diagnostics/remediation.d.ts +7 -7
  116. package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
  117. package/dist/core/extensions/activation-summary.d.ts +30 -30
  118. package/dist/core/extensions/activation-transaction.d.ts +9 -9
  119. package/dist/core/extensions/capability-usage.d.ts +25 -25
  120. package/dist/core/extensions/command-hook-context.d.ts +15 -15
  121. package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
  122. package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
  123. package/dist/core/extensions/contribution-inventory.d.ts +24 -24
  124. package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
  125. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  126. package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
  127. package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
  128. package/dist/core/extensions/extension-policy.d.ts +62 -62
  129. package/dist/core/extensions/extension-registries.d.ts +8 -8
  130. package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
  131. package/dist/core/extensions/extension-types.d.ts +717 -702
  132. package/dist/core/extensions/extension-types.js +1 -1
  133. package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
  134. package/dist/core/extensions/flag-value-types.d.ts +32 -4
  135. package/dist/core/extensions/flag-value-types.js +1 -1
  136. package/dist/core/extensions/index.d.ts +34 -34
  137. package/dist/core/extensions/item-field-types.d.ts +3 -3
  138. package/dist/core/extensions/item-fields.d.ts +6 -6
  139. package/dist/core/extensions/loader.d.ts +66 -66
  140. package/dist/core/extensions/manifest-parser.d.ts +1 -1
  141. package/dist/core/extensions/manifest-schema.d.ts +13 -13
  142. package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
  143. package/dist/core/extensions/preflight-ownership.d.ts +3 -3
  144. package/dist/core/extensions/read-output-contract.d.ts +2 -2
  145. package/dist/core/extensions/registration-contracts.d.ts +12 -12
  146. package/dist/core/extensions/registration-contracts.js +1 -1
  147. package/dist/core/extensions/registration-validation.d.ts +6 -6
  148. package/dist/core/extensions/registration-values.d.ts +19 -19
  149. package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
  150. package/dist/core/extensions/runtime-registrations.d.ts +6 -6
  151. package/dist/core/extensions/service-ownership.d.ts +1 -1
  152. package/dist/core/extensions/version-compat.d.ts +9 -9
  153. package/dist/core/fs/atomic-create.d.ts +1 -1
  154. package/dist/core/fs/fs-utils.d.ts +12 -12
  155. package/dist/core/fs/host-environment-errors.d.ts +10 -10
  156. package/dist/core/fs/path-utils.d.ts +1 -1
  157. package/dist/core/governance/content-fields.d.ts +25 -25
  158. package/dist/core/governance/issue-codes.d.ts +16 -16
  159. package/dist/core/governance/metadata-coverage.d.ts +64 -64
  160. package/dist/core/history/digest.d.ts +5 -5
  161. package/dist/core/history/drift-cache.d.ts +2 -2
  162. package/dist/core/history/drift-scan.d.ts +18 -18
  163. package/dist/core/history/event-classification.d.ts +4 -4
  164. package/dist/core/history/event-index.d.ts +33 -33
  165. package/dist/core/history/history-compact-bulk.d.ts +12 -12
  166. package/dist/core/history/history-diff.d.ts +15 -15
  167. package/dist/core/history/history-rewrite.d.ts +43 -43
  168. package/dist/core/history/history-storage-stats.d.ts +20 -20
  169. package/dist/core/history/history-stream-policy.d.ts +12 -12
  170. package/dist/core/history/history.d.ts +45 -45
  171. package/dist/core/history/identity.d.ts +4 -4
  172. package/dist/core/history/operation-contract.d.ts +17 -17
  173. package/dist/core/history/projection.d.ts +16 -16
  174. package/dist/core/history/read.d.ts +4 -4
  175. package/dist/core/history/replay.d.ts +47 -47
  176. package/dist/core/history/tombstone.d.ts +1 -1
  177. package/dist/core/history/version-address.d.ts +2 -2
  178. package/dist/core/history/workspace-history.d.ts +72 -72
  179. package/dist/core/io/body-file.d.ts +2 -2
  180. package/dist/core/io/bulk-ids-input.d.ts +7 -7
  181. package/dist/core/item/actionability.d.ts +30 -30
  182. package/dist/core/item/dependency-reference.d.ts +2 -2
  183. package/dist/core/item/id.d.ts +9 -9
  184. package/dist/core/item/item-format-version.d.ts +17 -15
  185. package/dist/core/item/item-format-version.js +1 -1
  186. package/dist/core/item/item-format.d.ts +54 -54
  187. package/dist/core/item/item-format.js +3 -3
  188. package/dist/core/item/item-record.d.ts +1 -1
  189. package/dist/core/item/item-type-definition.d.ts +11 -11
  190. package/dist/core/item/parent-reference-policy.d.ts +6 -6
  191. package/dist/core/item/parse.d.ts +37 -37
  192. package/dist/core/item/plan-lifecycle.d.ts +4 -4
  193. package/dist/core/item/priority.d.ts +3 -3
  194. package/dist/core/item/sprint-release-format.d.ts +4 -4
  195. package/dist/core/item/status-filter.d.ts +5 -5
  196. package/dist/core/item/status.d.ts +3 -3
  197. package/dist/core/item/toon-decode.d.ts +10 -10
  198. package/dist/core/item/type-registry.d.ts +35 -35
  199. package/dist/core/item/type-synonyms.d.ts +2 -2
  200. package/dist/core/lock/lock-gc.d.ts +28 -28
  201. package/dist/core/lock/lock.d.ts +53 -53
  202. package/dist/core/output/mutation-projection.d.ts +4 -25
  203. package/dist/core/output/mutation-projection.js +1 -1
  204. package/dist/core/output/output-control.d.ts +4 -4
  205. package/dist/core/output/output.d.ts +30 -30
  206. package/dist/core/output/query-summary.d.ts +5 -5
  207. package/dist/core/output/tabular.d.ts +3 -3
  208. package/dist/core/packages/manifest.d.ts +30 -30
  209. package/dist/core/packages/root.d.ts +4 -4
  210. package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
  211. package/dist/core/policy/workflow-policy-store.d.ts +15 -15
  212. package/dist/core/policy/workflow-policy.d.ts +56 -56
  213. package/dist/core/profile/profile-describe.d.ts +22 -22
  214. package/dist/core/profile/profile-lint.d.ts +13 -13
  215. package/dist/core/profile/profile-plan.d.ts +45 -45
  216. package/dist/core/profile/profile-presets.d.ts +36 -36
  217. package/dist/core/reproducibility/context.d.ts +9 -9
  218. package/dist/core/schema/fields-file.d.ts +35 -35
  219. package/dist/core/schema/item-types-file.d.ts +29 -29
  220. package/dist/core/schema/runtime-field-filters.d.ts +3 -3
  221. package/dist/core/schema/runtime-field-values.d.ts +7 -7
  222. package/dist/core/schema/runtime-schema.d.ts +59 -59
  223. package/dist/core/schema/status-defs-file.d.ts +29 -29
  224. package/dist/core/schema/status-token.d.ts +1 -1
  225. package/dist/core/schema/type-inference.d.ts +10 -10
  226. package/dist/core/schema/type-presets.d.ts +5 -5
  227. package/dist/core/schema/type-workflows.d.ts +15 -15
  228. package/dist/core/schema/type-workflows.js +1 -1
  229. package/dist/core/search/background-refresh.d.ts +12 -12
  230. package/dist/core/search/bm25.d.ts +16 -16
  231. package/dist/core/search/cache.d.ts +34 -34
  232. package/dist/core/search/corpus.d.ts +17 -17
  233. package/dist/core/search/embedding-batches.d.ts +25 -25
  234. package/dist/core/search/eval-thresholds.d.ts +4 -4
  235. package/dist/core/search/eval.d.ts +40 -40
  236. package/dist/core/search/http-client.d.ts +24 -24
  237. package/dist/core/search/providers.d.ts +30 -30
  238. package/dist/core/search/relevance.d.ts +17 -17
  239. package/dist/core/search/semantic-defaults.d.ts +5 -5
  240. package/dist/core/search/staleness.d.ts +3 -3
  241. package/dist/core/search/vector-stores.d.ts +51 -51
  242. package/dist/core/search/vectorization-metadata.d.ts +9 -9
  243. package/dist/core/sentry/helpers.d.ts +27 -27
  244. package/dist/core/sentry/instrument.d.ts +51 -51
  245. package/dist/core/sentry/instrument.js +1 -1
  246. package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
  247. package/dist/core/sentry/sensitive-assignments.js +2 -0
  248. package/dist/core/session/session-state.d.ts +37 -37
  249. package/dist/core/shared/agent-session-context.d.ts +14 -14
  250. package/dist/core/shared/author.d.ts +89 -89
  251. package/dist/core/shared/command-line.d.ts +3 -3
  252. package/dist/core/shared/command-types.d.ts +20 -20
  253. package/dist/core/shared/conflict-markers.d.ts +5 -5
  254. package/dist/core/shared/constants.d.ts +30 -30
  255. package/dist/core/shared/errors.d.ts +100 -100
  256. package/dist/core/shared/html-entity-decode.d.ts +2 -2
  257. package/dist/core/shared/item-metadata-contract.d.ts +2 -2
  258. package/dist/core/shared/lazy-module.d.ts +1 -1
  259. package/dist/core/shared/levenshtein.d.ts +1 -1
  260. package/dist/core/shared/memo.d.ts +1 -1
  261. package/dist/core/shared/numeric-parsers.d.ts +1 -1
  262. package/dist/core/shared/option-alias-visibility.d.ts +3 -3
  263. package/dist/core/shared/primitives.d.ts +13 -13
  264. package/dist/core/shared/secret-rules.d.ts +92 -92
  265. package/dist/core/shared/serial-queue.d.ts +6 -6
  266. package/dist/core/shared/serialization.d.ts +4 -4
  267. package/dist/core/shared/split-comma-list.d.ts +4 -4
  268. package/dist/core/shared/text-normalization.d.ts +5 -3
  269. package/dist/core/shared/text-normalization.js +1 -1
  270. package/dist/core/shared/time.d.ts +27 -27
  271. package/dist/core/store/item-format-migration.d.ts +7 -7
  272. package/dist/core/store/item-metadata-cache.d.ts +30 -30
  273. package/dist/core/store/item-metadata-query-index.d.ts +66 -66
  274. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  275. package/dist/core/store/item-mutation-precondition.d.ts +11 -0
  276. package/dist/core/store/item-mutation-precondition.js +2 -0
  277. package/dist/core/store/item-store.d.ts +123 -123
  278. package/dist/core/store/item-store.js +1 -1
  279. package/dist/core/store/paths.d.ts +27 -27
  280. package/dist/core/store/settings-concurrency.d.ts +1 -1
  281. package/dist/core/store/settings-read-cache.d.ts +11 -11
  282. package/dist/core/store/settings-validator.d.ts +117 -117
  283. package/dist/core/store/settings.d.ts +84 -84
  284. package/dist/core/store/sqlite-runtime.d.ts +2 -2
  285. package/dist/core/store/tracker-preflight.d.ts +3 -3
  286. package/dist/core/telemetry/consent.d.ts +1 -1
  287. package/dist/core/telemetry/observability.d.ts +16 -16
  288. package/dist/core/telemetry/policy.d.ts +7 -7
  289. package/dist/core/telemetry/read-sampling.d.ts +1 -1
  290. package/dist/core/telemetry/runtime.d.ts +275 -275
  291. package/dist/core/test/background-runs.d.ts +123 -123
  292. package/dist/core/test/item-test-run-tracking.d.ts +10 -10
  293. package/dist/core/test/run-selectors.d.ts +12 -12
  294. package/dist/core/validate/estimate-defaults.d.ts +3 -3
  295. package/dist/core/validate/fix-planning.d.ts +36 -36
  296. package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
  297. package/dist/core/validate/missing-by-type.d.ts +3 -3
  298. package/dist/core/validate/missing-link-owners.d.ts +17 -17
  299. package/dist/core/validate/stale-file-classification.d.ts +6 -6
  300. package/dist/mcp/http-server.d.ts +26 -26
  301. package/dist/mcp/legacy-adapter.d.ts +18 -18
  302. package/dist/mcp/runtime-capabilities.d.ts +18 -18
  303. package/dist/mcp/server.d.ts +73 -73
  304. package/dist/mcp/server.js +1 -1
  305. package/dist/mcp/tool-definitions.d.ts +27 -27
  306. package/dist/mcp/tool-definitions.js +1 -1
  307. package/dist/sdk/actionability.d.ts +1 -1
  308. package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
  309. package/dist/sdk/agent/command-recovery.d.ts +5 -5
  310. package/dist/sdk/agent/command-suggestions.d.ts +4 -4
  311. package/dist/sdk/agent/create-option-policy.d.ts +2 -2
  312. package/dist/sdk/agent/identity-config.d.ts +18 -18
  313. package/dist/sdk/agent/item-addressing.d.ts +6 -6
  314. package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
  315. package/dist/sdk/agent/refusal-closure.d.ts +22 -22
  316. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
  317. package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
  318. package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
  319. package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
  320. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
  321. package/dist/sdk/agent-capability-contracts.d.ts +41 -41
  322. package/dist/sdk/agent-session-context.d.ts +1 -1
  323. package/dist/sdk/annotations.d.ts +74 -74
  324. package/dist/sdk/author-attribution.d.ts +47 -47
  325. package/dist/sdk/authoring.d.ts +9 -9
  326. package/dist/sdk/cli-bootstrap.d.ts +65 -65
  327. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
  328. package/dist/sdk/cli-contracts/agent-output-contracts.js +1 -1
  329. package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
  330. package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
  331. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
  332. package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
  333. package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
  334. package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
  335. package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
  336. package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
  337. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  338. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
  339. package/dist/sdk/cli-contracts/flag-lexicon-contracts.js +1 -1
  340. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
  341. package/dist/sdk/cli-contracts/registration-helpers.d.ts +57 -57
  342. package/dist/sdk/cli-contracts/registration-helpers.js +1 -1
  343. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
  344. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  345. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
  346. package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
  347. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
  348. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
  349. package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
  350. package/dist/sdk/cli-contracts/tool-schema.js +1 -1
  351. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
  352. package/dist/sdk/cli-contracts.d.ts +15 -15
  353. package/dist/sdk/cli-program.d.ts +1 -1
  354. package/dist/sdk/cli-program.js +1 -1
  355. package/dist/sdk/command-line.d.ts +3 -3
  356. package/dist/sdk/comments.d.ts +24 -24
  357. package/dist/sdk/compile-cache.d.ts +4 -4
  358. package/dist/sdk/completion/bash.d.ts +1 -1
  359. package/dist/sdk/completion/fish.d.ts +1 -1
  360. package/dist/sdk/completion/shared.d.ts +74 -74
  361. package/dist/sdk/completion/zsh.d.ts +1 -1
  362. package/dist/sdk/completion.d.ts +3 -3
  363. package/dist/sdk/compose.d.ts +94 -94
  364. package/dist/sdk/config.d.ts +105 -105
  365. package/dist/sdk/context/recency.d.ts +1 -1
  366. package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
  367. package/dist/sdk/context/usage-egress.d.ts +1 -1
  368. package/dist/sdk/context/usage-ledger.d.ts +18 -18
  369. package/dist/sdk/context-intent-contracts.d.ts +37 -37
  370. package/dist/sdk/context-intent-contracts.js +1 -1
  371. package/dist/sdk/context-intent-runtime.d.ts +10 -10
  372. package/dist/sdk/context-packing.d.ts +44 -44
  373. package/dist/sdk/context-relevance.d.ts +110 -110
  374. package/dist/sdk/context-signal-store.d.ts +52 -52
  375. package/dist/sdk/context-usage.d.ts +78 -78
  376. package/dist/sdk/contracts.d.ts +2 -1
  377. package/dist/sdk/contracts.js +1 -1
  378. package/dist/sdk/core-governance.d.ts +5 -5
  379. package/dist/sdk/core.d.ts +9 -8
  380. package/dist/sdk/core.js +1 -1
  381. package/dist/sdk/corpus-shape.d.ts +60 -60
  382. package/dist/sdk/define.d.ts +36 -36
  383. package/dist/sdk/dependencies.d.ts +70 -70
  384. package/dist/sdk/dependency-flag-validation.d.ts +17 -17
  385. package/dist/sdk/dependency-provenance.d.ts +22 -22
  386. package/dist/sdk/docs.d.ts +17 -17
  387. package/dist/sdk/duplicates.d.ts +14 -14
  388. package/dist/sdk/environment/agent-environment.d.ts +118 -118
  389. package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
  390. package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
  391. package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
  392. package/dist/sdk/environment/source-context.d.ts +4 -4
  393. package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
  394. package/dist/sdk/error-code-catalog.d.ts +33 -33
  395. package/dist/sdk/error-runtime.d.ts +5 -5
  396. package/dist/sdk/errors.d.ts +17 -17
  397. package/dist/sdk/eval.d.ts +27 -27
  398. package/dist/sdk/extension/author-manifest.d.ts +9 -9
  399. package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
  400. package/dist/sdk/extension/concurrency.d.ts +1 -1
  401. package/dist/sdk/extension/copy-scope.d.ts +1 -1
  402. package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
  403. package/dist/sdk/extension/describe.d.ts +21 -21
  404. package/dist/sdk/extension/doctor.d.ts +46 -46
  405. package/dist/sdk/extension/install-plan.d.ts +32 -32
  406. package/dist/sdk/extension/install-receipts.d.ts +4 -4
  407. package/dist/sdk/extension/install-runtime.d.ts +12 -12
  408. package/dist/sdk/extension/install-snapshot.d.ts +10 -10
  409. package/dist/sdk/extension/install-sources.d.ts +106 -106
  410. package/dist/sdk/extension/managed-state.d.ts +42 -42
  411. package/dist/sdk/extension/managed-update-status.d.ts +1 -1
  412. package/dist/sdk/extension/migrations.d.ts +48 -48
  413. package/dist/sdk/extension/output-ownership.d.ts +19 -19
  414. package/dist/sdk/extension/runtime-summary.d.ts +7 -7
  415. package/dist/sdk/extension/scaffold.d.ts +15 -15
  416. package/dist/sdk/extension/shared.d.ts +16 -16
  417. package/dist/sdk/extension/source-resolution.d.ts +16 -16
  418. package/dist/sdk/extension/static-inventory.d.ts +23 -23
  419. package/dist/sdk/extension/update-check.d.ts +9 -9
  420. package/dist/sdk/extension-command-context.d.ts +1 -1
  421. package/dist/sdk/extension-contracts.d.ts +10 -10
  422. package/dist/sdk/extension.d.ts +221 -221
  423. package/dist/sdk/files.d.ts +101 -101
  424. package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
  425. package/dist/sdk/flag-invocation-contracts.js +1 -1
  426. package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
  427. package/dist/sdk/generated/generated-error-code-catalog-part-1.js +1 -1
  428. package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
  429. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  430. package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
  431. package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
  432. package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
  433. package/dist/sdk/governance/assurance-action.d.ts +46 -46
  434. package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
  435. package/dist/sdk/governance/assurance-presets.d.ts +25 -25
  436. package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
  437. package/dist/sdk/governance/assurance.d.ts +204 -204
  438. package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
  439. package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
  440. package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
  441. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
  442. package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
  443. package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
  444. package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
  445. package/dist/sdk/governance/extension-host-version.d.ts +9 -9
  446. package/dist/sdk/governance/gc.d.ts +26 -26
  447. package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
  448. package/dist/sdk/governance/health.d.ts +172 -172
  449. package/dist/sdk/governance/health.js +1 -1
  450. package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
  451. package/dist/sdk/governance/linked-file-report.d.ts +15 -15
  452. package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
  453. package/dist/sdk/governance/provenance-health.d.ts +35 -35
  454. package/dist/sdk/governance/reindex.d.ts +102 -102
  455. package/dist/sdk/governance/reliability.d.ts +29 -29
  456. package/dist/sdk/governance/stale-work.d.ts +13 -13
  457. package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
  458. package/dist/sdk/governance/storage-integrity.d.ts +28 -28
  459. package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
  460. package/dist/sdk/governance/upgrade.d.ts +77 -77
  461. package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
  462. package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
  463. package/dist/sdk/governance/validate-normalization.d.ts +4 -4
  464. package/dist/sdk/governance/validate.d.ts +176 -176
  465. package/dist/sdk/governance/validate.js +1 -1
  466. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  467. package/dist/sdk/governance/workflow-policy.d.ts +18 -18
  468. package/dist/sdk/governance/workspace-position.d.ts +40 -40
  469. package/dist/sdk/governance.d.ts +2 -2
  470. package/dist/sdk/graph/adapter.d.ts +45 -45
  471. package/dist/sdk/graph/analytics.d.ts +36 -36
  472. package/dist/sdk/graph/assembly.d.ts +51 -51
  473. package/dist/sdk/graph/cache.d.ts +19 -19
  474. package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
  475. package/dist/sdk/graph/centrality.d.ts +20 -20
  476. package/dist/sdk/graph/conformance.d.ts +21 -21
  477. package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
  478. package/dist/sdk/graph/durable-cache.d.ts +22 -22
  479. package/dist/sdk/graph/governance-contracts.d.ts +1 -1
  480. package/dist/sdk/graph/governance.d.ts +92 -92
  481. package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
  482. package/dist/sdk/graph/index.d.ts +15 -15
  483. package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
  484. package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
  485. package/dist/sdk/graph/query-contracts.d.ts +6 -6
  486. package/dist/sdk/graph/remediation.d.ts +15 -15
  487. package/dist/sdk/graph/run.d.ts +203 -203
  488. package/dist/sdk/graph/scheduling.d.ts +21 -21
  489. package/dist/sdk/graph/traversal.d.ts +18 -18
  490. package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
  491. package/dist/sdk/guide-topics.d.ts +19 -19
  492. package/dist/sdk/guide-topics.js +1 -1
  493. package/dist/sdk/guide.d.ts +43 -43
  494. package/dist/sdk/history/attestation-command.d.ts +8 -8
  495. package/dist/sdk/history/attestation-contract.d.ts +43 -43
  496. package/dist/sdk/history/attestation-scan.d.ts +4 -4
  497. package/dist/sdk/history/attestation.d.ts +4 -4
  498. package/dist/sdk/history/maintenance.d.ts +25 -25
  499. package/dist/sdk/history/salvage.d.ts +19 -19
  500. package/dist/sdk/history/subject.d.ts +8 -8
  501. package/dist/sdk/history-analytics.d.ts +64 -64
  502. package/dist/sdk/history-compact.d.ts +67 -67
  503. package/dist/sdk/history-mcp.d.ts +7 -7
  504. package/dist/sdk/history-provenance.d.ts +40 -40
  505. package/dist/sdk/history-read.d.ts +24 -24
  506. package/dist/sdk/history-redact.d.ts +68 -68
  507. package/dist/sdk/history-repair.d.ts +92 -92
  508. package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
  509. package/dist/sdk/improvement-ledger.d.ts +62 -62
  510. package/dist/sdk/index.d.ts +70 -69
  511. package/dist/sdk/index.js +1 -1
  512. package/dist/sdk/init-agent-guidance.d.ts +68 -68
  513. package/dist/sdk/init.d.ts +117 -117
  514. package/dist/sdk/invocation-author.d.ts +1 -1
  515. package/dist/sdk/item-children.d.ts +15 -15
  516. package/dist/sdk/item-metadata-index.d.ts +2 -2
  517. package/dist/sdk/item-schedule.d.ts +9 -9
  518. package/dist/sdk/item-transaction.d.ts +139 -76
  519. package/dist/sdk/item-transaction.js +1 -1
  520. package/dist/sdk/learnings.d.ts +23 -23
  521. package/dist/sdk/lifecycle/append.d.ts +8 -8
  522. package/dist/sdk/lifecycle/claim.d.ts +53 -39
  523. package/dist/sdk/lifecycle/claim.js +1 -1
  524. package/dist/sdk/lifecycle/close-many.d.ts +71 -71
  525. package/dist/sdk/lifecycle/close.d.ts +18 -24
  526. package/dist/sdk/lifecycle/close.js +1 -1
  527. package/dist/sdk/lifecycle/copy.d.ts +10 -10
  528. package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
  529. package/dist/sdk/lifecycle/core-item-fields.d.ts +6 -0
  530. package/dist/sdk/lifecycle/core-item-fields.js +2 -0
  531. package/dist/sdk/lifecycle/create.d.ts +88 -88
  532. package/dist/sdk/lifecycle/delete.d.ts +15 -15
  533. package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
  534. package/dist/sdk/lifecycle/focus.d.ts +6 -6
  535. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
  536. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
  537. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
  538. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  539. package/dist/sdk/lifecycle/mcp-actions.js +1 -1
  540. package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
  541. package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
  542. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
  543. package/dist/sdk/lifecycle/mutation-option-validation.d.ts +2 -0
  544. package/dist/sdk/lifecycle/mutation-option-validation.js +2 -0
  545. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
  546. package/dist/sdk/lifecycle/plan.d.ts +127 -127
  547. package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
  548. package/dist/sdk/lifecycle/release-handoff.d.ts +12 -0
  549. package/dist/sdk/lifecycle/release-handoff.js +2 -0
  550. package/dist/sdk/lifecycle/reopen.d.ts +15 -15
  551. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
  552. package/dist/sdk/lifecycle/restore.d.ts +34 -34
  553. package/dist/sdk/lifecycle/restore.js +1 -1
  554. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
  555. package/dist/sdk/lifecycle/structured-mutation-plan.d.ts +33 -0
  556. package/dist/sdk/lifecycle/structured-mutation-plan.js +2 -0
  557. package/dist/sdk/lifecycle/task-composition.d.ts +9 -9
  558. package/dist/sdk/lifecycle/task-composition.js +1 -1
  559. package/dist/sdk/lifecycle/update-many.d.ts +61 -61
  560. package/dist/sdk/lifecycle/update.d.ts +113 -121
  561. package/dist/sdk/lifecycle/update.js +1 -1
  562. package/dist/sdk/lifecycle/workflow-transition.d.ts +13 -0
  563. package/dist/sdk/lifecycle/workflow-transition.js +2 -0
  564. package/dist/sdk/lifecycle-completion.d.ts +14 -14
  565. package/dist/sdk/lifecycle-policy.d.ts +42 -32
  566. package/dist/sdk/lifecycle-policy.js +1 -1
  567. package/dist/sdk/linked-artifacts.d.ts +58 -58
  568. package/dist/sdk/mcp/apps.d.ts +28 -28
  569. package/dist/sdk/mcp/authorization.d.ts +66 -66
  570. package/dist/sdk/mcp/discovery.d.ts +67 -67
  571. package/dist/sdk/mcp/interactions.d.ts +49 -49
  572. package/dist/sdk/mcp/protocol.d.ts +63 -63
  573. package/dist/sdk/mcp/skills.d.ts +62 -62
  574. package/dist/sdk/mcp/subscriptions.d.ts +26 -26
  575. package/dist/sdk/mcp/tasks.d.ts +51 -51
  576. package/dist/sdk/mcp/transport.d.ts +17 -17
  577. package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
  578. package/dist/sdk/merge/driver.d.ts +38 -38
  579. package/dist/sdk/merge/index.d.ts +5 -5
  580. package/dist/sdk/merge/install.d.ts +48 -48
  581. package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
  582. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  583. package/dist/sdk/merge/receipt-schema.d.ts +11 -11
  584. package/dist/sdk/merge/receipts.d.ts +111 -111
  585. package/dist/sdk/merge/reconcile.d.ts +20 -20
  586. package/dist/sdk/merge/three-way.d.ts +50 -50
  587. package/dist/sdk/merge/three-way.js +2 -2
  588. package/dist/sdk/merge/worktree-config.d.ts +3 -3
  589. package/dist/sdk/mutation-events.d.ts +62 -62
  590. package/dist/sdk/mutation-guard.d.ts +134 -134
  591. package/dist/sdk/notes.d.ts +28 -28
  592. package/dist/sdk/output/table-rows.d.ts +6 -6
  593. package/dist/sdk/output-contracts.d.ts +26 -26
  594. package/dist/sdk/output-projection.d.ts +108 -108
  595. package/dist/sdk/output-token-accounting.d.ts +18 -18
  596. package/dist/sdk/output.d.ts +18 -18
  597. package/dist/sdk/ownership-source.d.ts +1 -1
  598. package/dist/sdk/package-import-adapters.d.ts +51 -51
  599. package/dist/sdk/package-migrations.d.ts +3 -3
  600. package/dist/sdk/package-runtime-options.d.ts +3 -3
  601. package/dist/sdk/pagination.d.ts +28 -28
  602. package/dist/sdk/pagination.js +1 -1
  603. package/dist/sdk/profile.d.ts +72 -72
  604. package/dist/sdk/provenance.d.ts +37 -37
  605. package/dist/sdk/public-surface.json +1 -1
  606. package/dist/sdk/query/activity.d.ts +84 -84
  607. package/dist/sdk/query/aggregate.d.ts +109 -109
  608. package/dist/sdk/query/calendar.d.ts +95 -95
  609. package/dist/sdk/query/complete-list.d.ts +35 -35
  610. package/dist/sdk/query/context.d.ts +300 -300
  611. package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
  612. package/dist/sdk/query/get.d.ts +54 -54
  613. package/dist/sdk/query/history.d.ts +38 -38
  614. package/dist/sdk/query/item-filter-options.d.ts +41 -41
  615. package/dist/sdk/query/light-metadata.d.ts +1 -1
  616. package/dist/sdk/query/list-filter-shared.d.ts +4 -4
  617. package/dist/sdk/query/list.d.ts +167 -167
  618. package/dist/sdk/query/list.js +1 -1
  619. package/dist/sdk/query/multi-value-filters.d.ts +6 -6
  620. package/dist/sdk/query/next-ready-budget.d.ts +8 -8
  621. package/dist/sdk/query/next.d.ts +94 -94
  622. package/dist/sdk/query/parsers.d.ts +3 -3
  623. package/dist/sdk/query/projection-contracts.d.ts +18 -18
  624. package/dist/sdk/query/search/corpus.d.ts +15 -15
  625. package/dist/sdk/query/search/filters.d.ts +15 -15
  626. package/dist/sdk/query/search/input.d.ts +8 -8
  627. package/dist/sdk/query/search/lexical.d.ts +10 -10
  628. package/dist/sdk/query/search/response.d.ts +22 -22
  629. package/dist/sdk/query/search/semantic.d.ts +133 -133
  630. package/dist/sdk/query/search/types.d.ts +65 -65
  631. package/dist/sdk/query/search-contracts.d.ts +53 -53
  632. package/dist/sdk/query/search-pagination.d.ts +21 -21
  633. package/dist/sdk/query/search-rendering.d.ts +30 -30
  634. package/dist/sdk/query/search.d.ts +60 -60
  635. package/dist/sdk/query/workspace-contracts.d.ts +2 -2
  636. package/dist/sdk/query.d.ts +6 -6
  637. package/dist/sdk/read-output/continuation.d.ts +11 -11
  638. package/dist/sdk/read-output/extension.d.ts +3 -3
  639. package/dist/sdk/read-output/options.d.ts +7 -7
  640. package/dist/sdk/read-output/provenance.d.ts +6 -6
  641. package/dist/sdk/read-output-budget.d.ts +11 -11
  642. package/dist/sdk/read-output-budget.js +1 -1
  643. package/dist/sdk/read-output-contracts.d.ts +112 -112
  644. package/dist/sdk/read-output-contracts.js +1 -1
  645. package/dist/sdk/read-output-rows.d.ts +15 -15
  646. package/dist/sdk/read-output-session.d.ts +29 -29
  647. package/dist/sdk/relationship-analytics.d.ts +46 -46
  648. package/dist/sdk/relationship-context.d.ts +48 -48
  649. package/dist/sdk/relationship-history.d.ts +59 -59
  650. package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
  651. package/dist/sdk/relationship-migration.d.ts +14 -14
  652. package/dist/sdk/relationships.d.ts +46 -46
  653. package/dist/sdk/reproducibility/process.d.ts +9 -9
  654. package/dist/sdk/runtime/actions.d.ts +1 -1
  655. package/dist/sdk/runtime/context.d.ts +15 -15
  656. package/dist/sdk/runtime/schema-preview.d.ts +1 -1
  657. package/dist/sdk/runtime/schema.d.ts +1 -1
  658. package/dist/sdk/runtime-action-aliases.d.ts +3 -3
  659. package/dist/sdk/runtime-extended-actions.d.ts +9 -9
  660. package/dist/sdk/runtime-input.d.ts +29 -29
  661. package/dist/sdk/runtime-input.js +1 -1
  662. package/dist/sdk/runtime-primitives.d.ts +53 -53
  663. package/dist/sdk/runtime-primitives.js +1 -1
  664. package/dist/sdk/runtime-public-contracts.d.ts +46 -46
  665. package/dist/sdk/runtime-stats-options.d.ts +1 -1
  666. package/dist/sdk/runtime.d.ts +374 -374
  667. package/dist/sdk/runtime.js +1 -1
  668. package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
  669. package/dist/sdk/schema-migration.d.ts +79 -79
  670. package/dist/sdk/schema.d.ts +224 -224
  671. package/dist/sdk/search-refresh-worker.d.ts +1 -1
  672. package/dist/sdk/similarity-scoring.d.ts +10 -10
  673. package/dist/sdk/similarity.d.ts +73 -73
  674. package/dist/sdk/start-task-status.d.ts +1 -1
  675. package/dist/sdk/stats.d.ts +72 -72
  676. package/dist/sdk/structured-mutations.d.ts +64 -13
  677. package/dist/sdk/structured-mutations.js +1 -1
  678. package/dist/sdk/telemetry-flush.d.ts +1 -1
  679. package/dist/sdk/telemetry.d.ts +32 -32
  680. package/dist/sdk/templates.d.ts +35 -35
  681. package/dist/sdk/test/batch.d.ts +50 -50
  682. package/dist/sdk/test/command-args.d.ts +2 -2
  683. package/dist/sdk/test/entry.d.ts +4 -4
  684. package/dist/sdk/test/execution-receipts.d.ts +5 -5
  685. package/dist/sdk/test/execution.d.ts +247 -247
  686. package/dist/sdk/test/json-path.d.ts +4 -4
  687. package/dist/sdk/test/linked-command-detection.d.ts +36 -36
  688. package/dist/sdk/test/measurements.d.ts +10 -10
  689. package/dist/sdk/test/parsers.d.ts +18 -18
  690. package/dist/sdk/test/prerequisites.d.ts +3 -3
  691. package/dist/sdk/test/runs.d.ts +43 -43
  692. package/dist/sdk/test/trust.d.ts +15 -15
  693. package/dist/sdk/test/update.d.ts +23 -23
  694. package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
  695. package/dist/sdk/testing.d.ts +248 -248
  696. package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
  697. package/dist/sdk/traceability/source-traceability.d.ts +50 -50
  698. package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
  699. package/dist/sdk/workspace-contracts.d.ts +20 -20
  700. package/dist/sdk/workspace-memory.d.ts +42 -42
  701. package/dist/sdk/workspace-recipe.d.ts +9 -9
  702. package/dist/sdk/workspace-snapshot.d.ts +60 -60
  703. package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
  704. package/dist/sdk/workspace-transaction.d.ts +26 -26
  705. package/dist/sdk/workspace-transaction.js +2 -2
  706. package/dist/sdk/workspace.d.ts +9 -9
  707. package/dist/types.d.ts +540 -540
  708. package/docs/AGENT_GUIDE.md +33 -4
  709. package/docs/CLOSE_EVIDENCE_RECOVERY.md +16 -7
  710. package/docs/COMMANDS.md +96 -12
  711. package/docs/ECOSYSTEM_PLANNING_REVIEW.md +5 -1
  712. package/docs/EXTENSIONS.md +1 -1
  713. package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
  714. package/docs/LINKED_TEST_EDITS.md +15 -0
  715. package/docs/RELEASING.md +2 -0
  716. package/docs/SDK.md +114 -2
  717. package/docs/TESTING.md +36 -1
  718. package/docs/generated/FLAG_LEXICON_BUDGETS.md +1 -1
  719. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +17 -3
  720. package/marketplace.json +1 -1
  721. package/package.json +4 -1
  722. package/packages/pm-beads/package.json +1 -1
  723. package/packages/pm-calendar/package.json +1 -1
  724. package/packages/pm-command-kit/package.json +1 -1
  725. package/packages/pm-digital-twin/package.json +1 -1
  726. package/packages/pm-governance-audit/package.json +1 -1
  727. package/packages/pm-guide-shell/package.json +1 -1
  728. package/packages/pm-kanban/package.json +1 -1
  729. package/packages/pm-lifecycle-hooks/package.json +1 -1
  730. package/packages/pm-linked-test-adapters/package.json +1 -1
  731. package/packages/pm-search-advanced/package.json +1 -1
  732. package/packages/pm-templates/package.json +1 -1
  733. package/packages/pm-todos/package.json +1 -1
  734. package/packages/pm-vcs/package.json +1 -1
  735. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  736. package/plugins/pm-claude/package.json +1 -1
  737. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  738. package/plugins/pm-codex/package.json +1 -1
  739. package/plugins/pm-codex/plugin.json +1 -1
  740. package/runtime-dependencies.json +1 -1
  741. package/scripts/finalize-build.mjs +9 -3
  742. package/dist/cli-bundle/chunks/chunk-66BZVFIK.js +0 -6
  743. package/dist/cli-bundle/chunks/chunk-IDEHMKYZ.js +0 -235
  744. package/dist/cli-bundle/chunks/chunk-LOSRTNNP.js +0 -2
  745. package/dist/cli-bundle/chunks/chunk-PP3BVMFL.js +0 -30
  746. package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
  747. package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
  748. package/dist/cli-bundle/chunks/register-mutation-TNRHNK4N.js +0 -20
  749. package/dist/cli-bundle/focused-chunks/chunk-23ACMPGB.js +0 -2
  750. package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
  751. package/dist/cli-bundle/focused-chunks/chunk-LKWDWER4.js +0 -20
  752. package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
  753. package/docs/ecosystem-review-2026-09-28.json +0 -1
@@ -1,25 +1,25 @@
1
1
  /** Classify plaintext as structured key/value input using an explicit accepted-key vocabulary. */
2
- export declare function looksLikeStructuredKeyValueEntry(raw: string, keys: readonly string[]): boolean;
2
+ export declare function looksLikeStructuredKeyValueEntry(raw:string,keys:readonly string[]):boolean;
3
3
  /** Implements parse tags for the public runtime surface of this module. */
4
- export declare function parseTags(raw: string): string[];
4
+ export declare function parseTags(raw:string):string[];
5
5
  /** Merge repeated `--add-tags` / `--remove-tags` values into a single normalized tag list. Each entry can itself be CSV or a JSON array, mirroring the format accepted by `--tags`. Returns a deterministically sorted, deduped list. */
6
- export declare function collectTagFlagValues(values: readonly string[] | undefined): string[];
6
+ export declare function collectTagFlagValues(values:readonly string[] | undefined):string[];
7
7
  /** Split a stored `acceptance_criteria` value into its individual criteria. Criteria are stored as one string joined with `"; "` (repeated `--ac` values accumulate that way), so the semicolon is the criterion boundary and cannot appear inside one criterion; entries are trimmed and blanks dropped. Non-string/absent values yield an empty list. */
8
- export declare function splitAcceptanceCriteria(value: unknown): string[];
8
+ export declare function splitAcceptanceCriteria(value:unknown):string[];
9
9
  /** Apply additive/subtractive acceptance-criteria mutations to a base criteria list. Used by `pm update --add-ac/--remove-ac` so individual semicolon-free criteria can be edited without replacing the whole `acceptance_criteria` value (tag-API parity; disjoint additions merge cleanly across branches). Additions append in argv order and dedupe on exact trimmed text; removals match exact trimmed text and report unmatched selectors so a typo never becomes a silent no-op. */
10
- export declare function applyAcceptanceCriteriaMutations(baseCriteria: readonly string[], add: readonly string[] | undefined, remove: readonly string[] | undefined): {
11
- criteria: string[];
12
- unmatchedRemovals: string[];
10
+ export declare function applyAcceptanceCriteriaMutations(baseCriteria:readonly string[],add:readonly string[] | undefined,remove:readonly string[] | undefined):{
11
+ criteria:string[];
12
+ unmatchedRemovals:string[];
13
13
  };
14
14
  /** Apply an additive tag mutation to a base tag list. Used by `pm create` and `pm update` so `--add-tags` extends `--tags` (or the existing tags) without replacing them. Output is sorted + deduped lowercase, matching `parseTags`. */
15
- export declare function mergeAdditiveTags(baseTags: readonly string[], add: readonly string[] | undefined): string[];
15
+ export declare function mergeAdditiveTags(baseTags:readonly string[],add:readonly string[] | undefined):string[];
16
16
  /** Apply a subtractive tag mutation to a base tag list. Used by `pm update` so `--remove-tags x,y` prunes those entries without rewriting the full set. Removal is case-insensitive: both the base list and the removal selectors are normalized to canonical lowercase before matching. */
17
- export declare function applyTagRemovals(baseTags: readonly string[], remove: readonly string[] | undefined): string[];
18
- declare function coerceJsonTagArray(trimmed: string): string[] | null;
19
- declare function stripCodeFenceEnvelope(value: string): string;
20
- declare function parseMarkdownKeyValueLines(raw: string): Record<string, string> | null;
17
+ export declare function applyTagRemovals(baseTags:readonly string[],remove:readonly string[] | undefined):string[];
18
+ declare function coerceJsonTagArray(trimmed:string):string[] | null;
19
+ declare function stripCodeFenceEnvelope(value:string):string;
20
+ declare function parseMarkdownKeyValueLines(raw:string):Record<string,string> | null;
21
21
  /** Implements parse csv kv for the public runtime surface of this module. */
22
- export declare function parseCsvKv(raw: string, optionName: string): Record<string, string>;
22
+ export declare function parseCsvKv(raw:string,optionName:string):Record<string,string>;
23
23
  /**
24
24
  * Detect a CSV/markdown entry that opens with a generic `key=` token even when
25
25
  * that key is unknown (e.g. a typo like `lable=main,path=README.md`). Callers
@@ -30,9 +30,9 @@ export declare function parseCsvKv(raw: string, optionName: string): Record<stri
30
30
  * Windows absolute paths (`C:\…`) are excluded so a drive-lettered bare path is
31
31
  * never misread as a `C=…` key/value entry.
32
32
  */
33
- export declare function looksLikeGenericKeyValueEntry(raw: string): boolean;
33
+ export declare function looksLikeGenericKeyValueEntry(raw:string):boolean;
34
34
  /** Refuse a comma-bearing bare value whose meaning depends on guessing whether the comma separates values or belongs to one value. */
35
- export declare function assertNoAmbiguousBareCommaEntry(raw: string, optionName: string, noun: string, structured: boolean): void;
35
+ export declare function assertNoAmbiguousBareCommaEntry(raw:string,optionName:string,noun:string,structured:boolean):void;
36
36
  /**
37
37
  * Reject any key in a parsed CSV/markdown key/value map that is not part of the
38
38
  * caller's allowed-key contract, mirroring the strict `test --add` behavior
@@ -53,44 +53,44 @@ export declare function assertNoAmbiguousBareCommaEntry(raw: string, optionName:
53
53
  * `--learning`, annotation `--add`) deliberately do NOT call this — there an
54
54
  * unrecognized key means "treat the whole entry as plaintext", not an error.
55
55
  */
56
- export declare function assertNoUnknownCsvKeys(kv: Record<string, string>, optionName: string, allowedKeys: readonly string[]): void;
56
+ export declare function assertNoUnknownCsvKeys(kv:Record<string,string>,optionName:string,allowedKeys:readonly string[]):void;
57
57
  /** Documents the stdin token resolver payload exchanged by command, SDK, and package integrations. */
58
58
  export interface StdinTokenResolver {
59
59
  /** Value that configures or reports resolve value for this contract. */
60
- resolveValue(value: string | undefined, optionName: string, resolveToken?: boolean): Promise<string | undefined>;
60
+ resolveValue(value:string | undefined,optionName:string,resolveToken?:boolean):Promise<string | undefined>;
61
61
  /** Value that configures or reports resolve list for this contract. */
62
- resolveList(values: string[] | undefined, optionName: string, resolveToken?: boolean): Promise<string[] | undefined>;
62
+ resolveList(values:string[] | undefined,optionName:string,resolveToken?:boolean):Promise<string[] | undefined>;
63
63
  }
64
64
  /** Mark transport-decoded options whose dash values are data, not stdin tokens. */
65
- export declare function preserveMutationStdinTokenLiterals<T extends object>(options: T): T;
65
+ export declare function preserveMutationStdinTokenLiterals<T extends object>(options:T):T;
66
66
  /** Mark selected mutation fields whose dash values are literal transport data. */
67
- export declare function preserveMutationStdinTokenFields<T extends object>(options: T, fields: readonly PropertyKey[]): T;
67
+ export declare function preserveMutationStdinTokenFields<T extends object>(options:T,fields:readonly PropertyKey[]):T;
68
68
  /** Copy the complete mutation stdin-token policy across an option clone. */
69
- export declare function transferMutationStdinTokenPolicy<T extends object>(source: object, target: T): T;
69
+ export declare function transferMutationStdinTokenPolicy<T extends object>(source:object,target:T):T;
70
70
  /** Add a source mutation stdin-token policy without weakening the target. */
71
- export declare function overlayMutationStdinTokenPolicy<T extends object>(source: object, target: T): T;
71
+ export declare function overlayMutationStdinTokenPolicy<T extends object>(source:object,target:T):T;
72
72
  /** Report whether lifecycle input should interpret dash values as stdin tokens. */
73
- export declare function shouldResolveMutationStdinTokens(options: object): boolean;
73
+ export declare function shouldResolveMutationStdinTokens(options:object):boolean;
74
74
  /** Report whether one mutation field should interpret dash as a stdin token. */
75
- export declare function shouldResolveMutationStdinTokenField(options: object, field: PropertyKey): boolean;
75
+ export declare function shouldResolveMutationStdinTokenField(options:object,field:PropertyKey):boolean;
76
76
  /** Refuse competing stdin-token fields before any resolver starts reading. */
77
- export declare function assertSingleStdinTokenConsumer(candidates: readonly {
78
- value: string | readonly string[] | undefined;
79
- optionName: string;
80
- resolveToken?: boolean;
81
- }[]): void;
77
+ export declare function assertSingleStdinTokenConsumer(candidates:readonly {
78
+ value:string | readonly string[] | undefined;
79
+ optionName:string;
80
+ resolveToken?:boolean;
81
+ }[]):void;
82
82
  /** Resolve a typed mutation option bag only after its complete stdin plan is conflict-free. */
83
- export declare function resolveMutationStdinTokenFields<T extends object>(options: T, scalarFields: readonly (readonly [keyof T & string, string])[], listFields: readonly (readonly [keyof T & string, string])[]): Promise<T>;
83
+ export declare function resolveMutationStdinTokenFields<T extends object>(options:T,scalarFields:readonly (readonly [keyof T & string,string])[],listFields:readonly (readonly [keyof T & string,string])[]):Promise<T>;
84
84
  /** Implements create stdin token resolver for the public runtime surface of this module. */
85
- export declare function createStdinTokenResolver(): StdinTokenResolver;
85
+ export declare function createStdinTokenResolver():StdinTokenResolver;
86
86
  /** Implements parse optional number for the public runtime surface of this module. */
87
- export declare function parseOptionalNumber(raw: string, optionName: string): number;
87
+ export declare function parseOptionalNumber(raw:string,optionName:string):number;
88
88
  /** Parse a non-negative integer option such as an item duration estimate. */
89
- export declare function parseOptionalNonNegativeInteger(raw: string, optionName: string): number;
89
+ export declare function parseOptionalNonNegativeInteger(raw:string,optionName:string):number;
90
90
  /** Public contract for test only, shared by SDK and presentation-layer consumers. */
91
- export declare const _testOnly: {
92
- coerceJsonTagArray: typeof coerceJsonTagArray;
93
- stripCodeFenceEnvelope: typeof stripCodeFenceEnvelope;
94
- parseMarkdownKeyValueLines: typeof parseMarkdownKeyValueLines;
91
+ export declare const _testOnly:{
92
+ coerceJsonTagArray:typeof coerceJsonTagArray;
93
+ stripCodeFenceEnvelope:typeof stripCodeFenceEnvelope;
94
+ parseMarkdownKeyValueLines:typeof parseMarkdownKeyValueLines;
95
95
  };
96
96
  export {};
@@ -4,10 +4,10 @@
4
4
  * Defines the terminal lifecycle semantics shared by Plan command mutations
5
5
  * and generic item closure.
6
6
  */
7
- import type { ItemMetadata, PlanMode } from "../../types/index.js";
7
+ import type { ItemMetadata,PlanMode } from "../../types/index.js";
8
8
  /** Plan modes that intentionally prevent any further Plan mutation. */
9
- export declare const TERMINAL_PLAN_MODES: ReadonlySet<PlanMode>;
9
+ export declare const TERMINAL_PLAN_MODES:ReadonlySet<PlanMode>;
10
10
  /** Return whether a Plan mode represents a terminal planning state. */
11
- export declare function isTerminalPlanMode(mode: PlanMode | undefined): boolean;
11
+ export declare function isTerminalPlanMode(mode:PlanMode | undefined):boolean;
12
12
  /** Return whether closing this item should complete its Plan lifecycle in the same mutation. */
13
- export declare function shouldCompletePlanOnClose(item: ItemMetadata): boolean;
13
+ export declare function shouldCompletePlanOnClose(item:ItemMetadata):boolean;
@@ -1,9 +1,9 @@
1
1
  /** Restricts priority values accepted by command, SDK, and storage contracts. */
2
2
  export type Priority = 0 | 1 | 2 | 3 | 4;
3
3
  /** Canonical mapping from named priority levels to numeric values. Agents and humans frequently write words ("high") instead of numbers, so both create and update accept either form. This single map is the source of truth so the two commands cannot drift apart. */
4
- export declare const PRIORITY_NAME_TO_VALUE: Readonly<Record<string, Priority>>;
4
+ export declare const PRIORITY_NAME_TO_VALUE:Readonly<Record<string,Priority>>;
5
5
  /** Human-readable description of every accepted priority form. Reused in error messages so the wording stays consistent across commands. */
6
- export declare const PRIORITY_ACCEPTED_FORMS_HINT: string;
6
+ export declare const PRIORITY_ACCEPTED_FORMS_HINT:string;
7
7
  /**
8
8
  * Resolve a raw `--priority` option value to a numeric 0..4 priority.
9
9
  *
@@ -14,4 +14,4 @@ export declare const PRIORITY_ACCEPTED_FORMS_HINT: string;
14
14
  *
15
15
  * Throws a USAGE error listing BOTH accepted forms for anything else.
16
16
  */
17
- export declare function resolvePriority(raw: string | number): Priority;
17
+ export declare function resolvePriority(raw:string | number):Priority;
@@ -5,9 +5,9 @@
5
5
  */
6
6
  import type { SprintReleaseFormatPolicy } from "../../types/index.js";
7
7
  /** Implements normalize sprint release format policy for the public runtime surface of this module. */
8
- export declare function normalizeSprintReleaseFormatPolicy(value: string | undefined): SprintReleaseFormatPolicy;
8
+ export declare function normalizeSprintReleaseFormatPolicy(value:string | undefined):SprintReleaseFormatPolicy;
9
9
  /** Implements validate sprint or release value for the public runtime surface of this module. */
10
- export declare function validateSprintOrReleaseValue(field: "sprint" | "release", rawValue: string, policy: SprintReleaseFormatPolicy): {
11
- value: string;
12
- warnings: string[];
10
+ export declare function validateSprintOrReleaseValue(field:"sprint" | "release",rawValue:string,policy:SprintReleaseFormatPolicy):{
11
+ value:string;
12
+ warnings:string[];
13
13
  };
@@ -1,7 +1,7 @@
1
1
  import type { RuntimeStatusRegistry } from "../schema/runtime-schema.js";
2
2
  import type { ItemStatus } from "../../types/index.js";
3
3
  /** Return true when a status-filter input is the standalone all-status sentinel. */
4
- export declare function isStatusAllFilterInput(raw: unknown): boolean;
4
+ export declare function isStatusAllFilterInput(raw:unknown):boolean;
5
5
  /**
6
6
  * Resolve a single status-filter token to a concrete runtime status id.
7
7
  *
@@ -10,13 +10,13 @@ export declare function isStatusAllFilterInput(raw: unknown): boolean;
10
10
  * Callers decide whether an unrecognized token is an error (strict mode) or is
11
11
  * passed through verbatim (lenient mode) — see {@link parseStatusFilterCsv}.
12
12
  */
13
- export declare function resolveStatusFilterToken(token: string, registry: RuntimeStatusRegistry): ItemStatus | undefined;
13
+ export declare function resolveStatusFilterToken(token:string,registry:RuntimeStatusRegistry):ItemStatus | undefined;
14
14
  /** Documents the parse status filter options payload exchanged by command, SDK, and package integrations. */
15
15
  export interface ParseStatusFilterOptions {
16
16
  /** When true, an unrecognized token throws a USAGE error with a did-you-mean hint. When false (default), an unrecognized token is passed through verbatim so custom/unknown statuses still compare against item values by their raw string — preserving the long-standing lenient `pm list` behavior. */
17
- strict?: boolean;
17
+ strict?:boolean;
18
18
  /** Flag label used in error messages (default: "--status"). */
19
- flagLabel?: string;
19
+ flagLabel?:string;
20
20
  }
21
21
  /** Parse a comma-separated status filter into a de-duplicated list of concrete status ids. A standalone `all` sentinel intentionally resolves to no filter so duplicate-discovery loops can search every lifecycle bucket with the same `--status` flag shape. Shared by `pm list` (lenient) and `pm search` (strict, with a did-you-mean hint on typos) so both surfaces resolve the open/closed/canceled workflow-group aliases identically. */
22
- export declare function parseStatusFilterCsv(raw: unknown, registry: RuntimeStatusRegistry, options?: ParseStatusFilterOptions): ItemStatus[] | undefined;
22
+ export declare function parseStatusFilterCsv(raw:unknown,registry:RuntimeStatusRegistry,options?:ParseStatusFilterOptions):ItemStatus[] | undefined;
@@ -1,8 +1,8 @@
1
1
  import type { ItemStatus } from "../../types/index.js";
2
2
  import { type RuntimeStatusRegistry } from "../schema/runtime-schema.js";
3
3
  /** Implements normalize status input for the public runtime surface of this module. */
4
- export declare function normalizeStatusInput(value: unknown, registry?: RuntimeStatusRegistry): ItemStatus | undefined;
4
+ export declare function normalizeStatusInput(value:unknown,registry?:RuntimeStatusRegistry):ItemStatus | undefined;
5
5
  /** Normalize a status against the runtime registry, falling back to the original value when normalization does not resolve to a known status. This preserves the long-standing `normalizeStatusInput(status, registry) ?? status` pattern used by query commands so that unknown/custom statuses still compare against registry sets by their raw value. */
6
- export declare function normalizeStatusForRegistry(status: ItemStatus, registry: RuntimeStatusRegistry): ItemStatus;
6
+ export declare function normalizeStatusForRegistry(status:ItemStatus,registry:RuntimeStatusRegistry):ItemStatus;
7
7
  /** Determine whether a status is terminal according to the runtime status registry, applying registry-aware normalization first (with raw fallback). */
8
- export declare function isTerminalStatus(status: ItemStatus, registry: RuntimeStatusRegistry): boolean;
8
+ export declare function isTerminalStatus(status:ItemStatus,registry:RuntimeStatusRegistry):boolean;
@@ -1,19 +1,19 @@
1
1
  /** Public contract for toon scalar bracket escape upstream pr, shared by SDK and presentation-layer consumers. */
2
- export declare const TOON_SCALAR_BRACKET_ESCAPE_UPSTREAM_PR: "https://github.com/toon-format/toon/pull/314";
2
+ export declare const TOON_SCALAR_BRACKET_ESCAPE_UPSTREAM_PR:"https://github.com/toon-format/toon/pull/314";
3
3
  /** Historical tracking for the scalar-bracket decoder defect fixed upstream in TOON 2.3.1. */
4
- export declare const TOON_SCALAR_BRACKET_ESCAPE_TRACKING: {
5
- readonly dependency: "@toon-format/toon";
6
- readonly affected_versions: "<=2.3.0";
7
- readonly resolved_version: "2.3.1";
8
- readonly upstream_pr: "https://github.com/toon-format/toon/pull/314";
9
- readonly workaround_status: "removed";
4
+ export declare const TOON_SCALAR_BRACKET_ESCAPE_TRACKING:{
5
+ readonly dependency:"@toon-format/toon";
6
+ readonly affected_versions:"<=2.3.0";
7
+ readonly resolved_version:"2.3.1";
8
+ readonly upstream_pr:"https://github.com/toon-format/toon/pull/314";
9
+ readonly workaround_status:"removed";
10
10
  };
11
11
  /** Documents the toon decode result payload exchanged by command, SDK, and package integrations. */
12
12
  export interface ToonDecodeResult {
13
13
  /** The decoded TOON document. */
14
- value: unknown;
14
+ value:unknown;
15
15
  /** Always false since TOON 2.3.1 fixed strict scalar-bracket decoding upstream. */
16
- usedScalarBracketEscape: boolean;
16
+ usedScalarBracketEscape:boolean;
17
17
  }
18
18
  /**
19
19
  * Decode a TOON item document with the dependency's strict parser.
@@ -22,4 +22,4 @@ usedScalarBracketEscape: boolean;
22
22
  * local retry. Keeping one strict decode path avoids masking malformed input and
23
23
  * records `usedScalarBracketEscape: false` for result-shape compatibility.
24
24
  */
25
- export declare function decodeToonItemContent(content: string): ToonDecodeResult;
25
+ export declare function decodeToonItemContent(content:string):ToonDecodeResult;
@@ -1,68 +1,68 @@
1
1
  import type { ExtensionRegistrationRegistry } from "../extensions/loader.js";
2
- import type { ItemTypeCommandOptionPolicy, ItemTypeDefinition, ItemTypeOptionDefinition, PmSettings } from "../../types/index.js";
2
+ import type { ItemTypeCommandOptionPolicy,ItemTypeDefinition,ItemTypeOptionDefinition,PmSettings } from "../../types/index.js";
3
3
  /** Default dispatch roles for built-in types whose work requires human input or outcome verification. Custom definitions can override these through the same registry. */
4
- export declare const BUILTIN_ITEM_EXECUTION_ROLES: Readonly<Record<string, "human" | "gate">>;
4
+ export declare const BUILTIN_ITEM_EXECUTION_ROLES:Readonly<Record<string,"human" | "gate">>;
5
5
  /** Fallback required create fields used when callers do not provide an override. */
6
- export declare const DEFAULT_REQUIRED_CREATE_FIELDS: readonly ["title", "description", "status", "priority", "tags", "body", "deadline", "estimatedMinutes", "acceptanceCriteria", "author", "message", "assignee"];
6
+ export declare const DEFAULT_REQUIRED_CREATE_FIELDS:readonly ["title","description","status","priority","tags","body","deadline","estimatedMinutes","acceptanceCriteria","author","message","assignee"];
7
7
  /** Fallback required create repeatables used when callers do not provide an override. */
8
- export declare const DEFAULT_REQUIRED_CREATE_REPEATABLES: readonly ["dep", "comment", "note", "learning", "file", "test", "doc"];
8
+ export declare const DEFAULT_REQUIRED_CREATE_REPEATABLES:readonly ["dep","comment","note","learning","file","test","doc"];
9
9
  /** Restricts command option policy command values accepted by command, SDK, and storage contracts. */
10
10
  export type CommandOptionPolicyCommand = "create" | "update";
11
11
  /** Public contract for common mutation command option keys, shared by SDK and presentation-layer consumers. */
12
- export declare const COMMON_MUTATION_COMMAND_OPTION_KEYS: readonly ["deadline", "estimatedMinutes", "acceptanceCriteria", "definitionOfReady", "order", "goal", "objective", "value", "impact", "outcome", "whyNow", "assignee", "parent", "reviewer", "risk", "confidence", "sprint", "release", "blockedBy", "blockedReason", "unblockNote", "reporter", "severity", "environment", "reproSteps", "resolution", "expectedResult", "actualResult", "affectedVersion", "fixedVersion", "component", "regression", "customerImpact"];
12
+ export declare const COMMON_MUTATION_COMMAND_OPTION_KEYS:readonly ["deadline","estimatedMinutes","acceptanceCriteria","definitionOfReady","order","goal","objective","value","impact","outcome","whyNow","assignee","parent","reviewer","risk","confidence","sprint","release","blockedBy","blockedReason","unblockNote","reporter","severity","environment","reproSteps","resolution","expectedResult","actualResult","affectedVersion","fixedVersion","component","regression","customerImpact"];
13
13
  /** Documents the command option policy state payload exchanged by command, SDK, and package integrations. */
14
14
  export interface CommandOptionPolicyState {
15
15
  /** Value that configures or reports required for this contract. */
16
- required: string[];
16
+ required:string[];
17
17
  /** Value that configures or reports hidden for this contract. */
18
- hidden: string[];
18
+ hidden:string[];
19
19
  /** Whether disabled applies to this operation. */
20
- disabled: string[];
20
+ disabled:string[];
21
21
  /** Value that configures or reports errors for this contract. */
22
- errors: string[];
22
+ errors:string[];
23
23
  }
24
24
  /** Documents the resolved item type definition payload exchanged by command, SDK, and package integrations. */
25
25
  export interface ResolvedItemTypeDefinition {
26
26
  /** Value that configures or reports name for this contract. */
27
- name: string;
27
+ name:string;
28
28
  /** Optional human description carried from the type definition. */
29
- description?: string;
29
+ description?:string;
30
30
  /** Value that configures or reports folder for this contract. */
31
- folder: string;
31
+ folder:string;
32
32
  /** Value that configures or reports aliases for this contract. */
33
- aliases: string[];
33
+ aliases:string[];
34
34
  /** Optional per-type status applied at create time when `--status` is omitted. */
35
- default_status?: string;
35
+ default_status?:string;
36
36
  /** Effective dispatch role; absent legacy definitions are resolved through the built-in defaults. */
37
- execution_role?: ItemTypeDefinition["execution_role"];
37
+ execution_role?:ItemTypeDefinition["execution_role"];
38
38
  /** Value that configures or reports required create fields for this contract. */
39
- required_create_fields: string[];
39
+ required_create_fields:string[];
40
40
  /** Value that configures or reports required create repeatables for this contract. */
41
- required_create_repeatables: string[];
41
+ required_create_repeatables:string[];
42
42
  /** Value that configures or reports options for this contract. */
43
- options: ItemTypeOptionDefinition[];
43
+ options:ItemTypeOptionDefinition[];
44
44
  /** Value that configures or reports command option policies for this contract. */
45
- command_option_policies: ItemTypeCommandOptionPolicy[];
45
+ command_option_policies:ItemTypeCommandOptionPolicy[];
46
46
  }
47
47
  /** Documents the item type registry payload exchanged by command, SDK, and package integrations. */
48
48
  export interface ItemTypeRegistry {
49
49
  /** Value that configures or reports types for this contract. */
50
- types: string[];
50
+ types:string[];
51
51
  /** Value that configures or reports folders for this contract. */
52
- folders: string[];
52
+ folders:string[];
53
53
  /** Value that configures or reports type to folder for this contract. */
54
- type_to_folder: Record<string, string>;
54
+ type_to_folder:Record<string,string>;
55
55
  /** Schema type that determines the shape and validation rules for this value. */
56
- by_type: Record<string, ResolvedItemTypeDefinition>;
56
+ by_type:Record<string,ResolvedItemTypeDefinition>;
57
57
  /** Schema type that determines the shape and validation rules for this value. */
58
- alias_to_type: Record<string, string>;
58
+ alias_to_type:Record<string,string>;
59
59
  }
60
60
  /** Implements canonicalize command option key for the public runtime surface of this module. */
61
- export declare function canonicalizeCommandOptionKey(command: CommandOptionPolicyCommand, rawOption: string): string | undefined;
61
+ export declare function canonicalizeCommandOptionKey(command:CommandOptionPolicyCommand,rawOption:string):string | undefined;
62
62
  /** Implements command option flag label for the public runtime surface of this module. */
63
- export declare function commandOptionFlagLabel(command: CommandOptionPolicyCommand, optionKey: string): string;
63
+ export declare function commandOptionFlagLabel(command:CommandOptionPolicyCommand,optionKey:string):string;
64
64
  /** Implements to default folder for the public runtime surface of this module. */
65
- export declare function toDefaultFolder(name: string): string;
65
+ export declare function toDefaultFolder(name:string):string;
66
66
  /**
67
67
  * Canonicalizes a custom item-type folder as a portable tracker-relative path.
68
68
  *
@@ -71,17 +71,17 @@ export declare function toDefaultFolder(name: string): string;
71
71
  * identically on every host. Traversal, drive-prefixed, empty, and NUL-bearing
72
72
  * values fail closed before callers can resolve an item or history path.
73
73
  */
74
- export declare function normalizeItemTypeFolder(folder: string): string;
74
+ export declare function normalizeItemTypeFolder(folder:string):string;
75
75
  /** Implements resolve item type registry for the public runtime surface of this module. */
76
- export declare function resolveItemTypeRegistry(settings: PmSettings, extensionRegistrations?: ExtensionRegistrationRegistry | null | undefined): ItemTypeRegistry;
76
+ export declare function resolveItemTypeRegistry(settings:PmSettings,extensionRegistrations?:ExtensionRegistrationRegistry | null | undefined):ItemTypeRegistry;
77
77
  /** Implements resolve type name for the public runtime surface of this module. */
78
- export declare function resolveTypeName(rawType: string | undefined, registry: ItemTypeRegistry): string | undefined;
78
+ export declare function resolveTypeName(rawType:string | undefined,registry:ItemTypeRegistry):string | undefined;
79
79
  /** Implements resolve type definition for the public runtime surface of this module. */
80
- export declare function resolveTypeDefinition(typeName: string | undefined, registry: ItemTypeRegistry): ResolvedItemTypeDefinition | undefined;
80
+ export declare function resolveTypeDefinition(typeName:string | undefined,registry:ItemTypeRegistry):ResolvedItemTypeDefinition | undefined;
81
81
  /** Implements resolve command option policy state for the public runtime surface of this module. */
82
- export declare function resolveCommandOptionPolicyState(typeDefinition: ResolvedItemTypeDefinition, command: CommandOptionPolicyCommand, baseRequiredOptions: Iterable<string>): CommandOptionPolicyState;
82
+ export declare function resolveCommandOptionPolicyState(typeDefinition:ResolvedItemTypeDefinition,command:CommandOptionPolicyCommand,baseRequiredOptions:Iterable<string>):CommandOptionPolicyState;
83
83
  /** Implements validate type options for the public runtime surface of this module. */
84
- export declare function validateTypeOptions(typeName: string, rawTypeOptions: Record<string, string> | undefined, registry: ItemTypeRegistry): {
85
- normalized: Record<string, string> | undefined;
86
- errors: string[];
84
+ export declare function validateTypeOptions(typeName:string,rawTypeOptions:Record<string,string> | undefined,registry:ItemTypeRegistry):{
85
+ normalized:Record<string,string> | undefined;
86
+ errors:string[];
87
87
  };
@@ -12,6 +12,6 @@
12
12
  * type names (resolved through the registry, never written verbatim).
13
13
  */
14
14
  /** Public contract for type synonyms, shared by SDK and presentation-layer consumers. */
15
- export declare const TYPE_SYNONYMS: Readonly<Record<string, string>>;
15
+ export declare const TYPE_SYNONYMS:Readonly<Record<string,string>>;
16
16
  /** Map a free-form type token to its canonical built-in type synonym, or `undefined` when there is no synonym. The caller must still confirm the canonical target exists in the active type registry before using it. */
17
- export declare function resolveTypeSynonym(rawType: string | undefined): string | undefined;
17
+ export declare function resolveTypeSynonym(rawType:string | undefined):string | undefined;
@@ -11,76 +11,76 @@
11
11
  /** Documents the stale lock scan entry payload exchanged by command, SDK, and package integrations. */
12
12
  export interface StaleLockScanEntry {
13
13
  /** e.g. "pm-abc1.lock" */
14
- file: string;
14
+ file:string;
15
15
  /** parsed id, or null if unparseable */
16
- id: string | null;
16
+ id:string | null;
17
17
  /** Value that configures or reports owner for this contract. */
18
- owner: string | null;
18
+ owner:string | null;
19
19
  /** ISO 8601 timestamp recording when created occurred. */
20
- created_at: string | null;
20
+ created_at:string | null;
21
21
  /** Value that configures or reports ttl seconds for this contract. */
22
- ttl_seconds: number | null;
22
+ ttl_seconds:number | null;
23
23
  /** floor((now - created_at)/1000), null if unparseable */
24
- age_seconds: number | null;
24
+ age_seconds:number | null;
25
25
  /** true only when classified expired */
26
- stale: boolean;
26
+ stale:boolean;
27
27
  /** Value that configures or reports reason for this contract. */
28
- reason: "expired" | "active" | "unparseable";
28
+ reason:"expired" | "active" | "unparseable";
29
29
  }
30
30
  /** Documents the lock gc hooks payload exchanged by command, SDK, and package integrations. */
31
31
  export interface LockGcHooks {
32
32
  /** Value that configures or reports on read for this contract. */
33
- onRead?: (lockPath: string) => Promise<string[]> | string[];
33
+ onRead?:(lockPath:string) => Promise<string[]> | string[];
34
34
  /** Value that configures or reports on write for this contract. */
35
- onWrite?: (lockPath: string) => Promise<string[]> | string[];
35
+ onWrite?:(lockPath:string) => Promise<string[]> | string[];
36
36
  }
37
37
  /** Documents the lock gc options payload exchanged by command, SDK, and package integrations. */
38
38
  export interface LockGcOptions {
39
39
  /** Value that configures or reports dry run for this contract. */
40
- dryRun: boolean;
40
+ dryRun:boolean;
41
41
  /** epoch ms; defaults to Date.now() — injectable for deterministic tests */
42
- now?: number;
42
+ now?:number;
43
43
  /** Value that configures or reports hooks for this contract. */
44
- hooks?: LockGcHooks;
44
+ hooks?:LockGcHooks;
45
45
  }
46
46
  /** Documents the lock gc result payload exchanged by command, SDK, and package integrations. */
47
47
  export interface LockGcResult {
48
48
  /** number of *.lock files examined */
49
- scanned: number;
49
+ scanned:number;
50
50
  /** relative paths like "locks/pm-abc1.lock" (removed, or would-remove under dryRun) */
51
- removed: string[];
51
+ removed:string[];
52
52
  /** relative paths retained (active OR unparseable — never delete what we can't reason about) */
53
- retained: string[];
53
+ retained:string[];
54
54
  /** Value that configures or reports warnings for this contract. */
55
- warnings: string[];
55
+ warnings:string[];
56
56
  /** one per scanned *.lock file, sorted by file name asc */
57
- entries: StaleLockScanEntry[];
57
+ entries:StaleLockScanEntry[];
58
58
  }
59
59
  /** Fine-grained classification outcome for one readable lock file's content. `unparseable_json` and `invalid_timestamp` both surface as the coarse `reason: "unparseable"` on the scan entry (gc retains both), but stay distinct here so callers can emit precise warnings. */
60
60
  export type LockClassificationDetail = "active" | "expired" | "unparseable_json" | "invalid_timestamp";
61
61
  /** Documents the lock content classification payload exchanged by command, SDK, and package integrations. */
62
62
  export interface LockContentClassification {
63
63
  /** Value that configures or reports detail for this contract. */
64
- detail: LockClassificationDetail;
64
+ detail:LockClassificationDetail;
65
65
  /** Value that configures or reports entry for this contract. */
66
- entry: StaleLockScanEntry;
66
+ entry:StaleLockScanEntry;
67
67
  }
68
68
  /** Pure classification of one lock file's raw content against `nowMs`. This is the single staleness/parse policy shared by `pm gc --scope locks` (which acts on it) and the `pm health` locks check (which only reports it). */
69
- export declare function classifyLockContent(file: string, raw: string, nowMs: number): LockContentClassification;
69
+ export declare function classifyLockContent(file:string,raw:string,nowMs:number):LockContentClassification;
70
70
  /** Documents the lock health scan payload exchanged by command, SDK, and package integrations. */
71
71
  export interface LockHealthScan {
72
72
  /** number of *.lock files examined (ghost files that vanish mid-scan are skipped) */
73
- scanned: number;
73
+ scanned:number;
74
74
  /** Number of active lock entries represented by this result. */
75
- active_lock_count: number;
75
+ active_lock_count:number;
76
76
  /** Number of stale lock entries represented by this result. */
77
- stale_lock_count: number;
77
+ stale_lock_count:number;
78
78
  /** Number of unreadable lock entries represented by this result. */
79
- unreadable_lock_count: number;
79
+ unreadable_lock_count:number;
80
80
  /** invalid JSON, wrong shape, or an unparseable created_at timestamp */
81
- unparseable_lock_count: number;
81
+ unparseable_lock_count:number;
82
82
  }
83
83
  /** Read-only locks scan for `pm health`: classifies every lock file with the same policy `pm gc --scope locks` uses but never removes anything. */
84
- export declare function scanLockHealth(pmRoot: string, now?: number): Promise<LockHealthScan>;
84
+ export declare function scanLockHealth(pmRoot:string,now?:number):Promise<LockHealthScan>;
85
85
  /** Implements run lock gc for the public runtime surface of this module. */
86
- export declare function runLockGc(pmRoot: string, options: LockGcOptions): Promise<LockGcResult>;
86
+ export declare function runLockGc(pmRoot:string,options:LockGcOptions):Promise<LockGcResult>;