@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
@@ -6,9 +6,9 @@
6
6
  import { type ConfigKey } from "../core/config/positional-value.js";
7
7
  import { type NestedSettingDescriptor } from "../core/config/nested-settings.js";
8
8
  import type { GlobalOptions } from "../core/shared/command-types.js";
9
- import { type AgentIdentityVocabularyMutationPreview, type AgentIdentityVocabularySummary } from "./agent/identity-config.js";
10
- import type { GovernanceCloseValidationDefault, GovernanceCreateModeDefault, GovernanceOwnershipEnforcement, GovernancePreset, GovernanceWorkflowEnforcement, ItemFormat, ParentReferencePolicy, SprintReleaseFormatPolicy, ValidateMetadataProfile, ValidateMetadataRequiredField } from "../types/index.js";
11
- declare const CONFIG_SCOPE_VALUES: readonly ["project", "global"];
9
+ import { type AgentIdentityVocabularyMutationPreview,type AgentIdentityVocabularySummary } from "./agent/identity-config.js";
10
+ import type { GovernanceCloseValidationDefault,GovernanceCreateModeDefault,GovernanceOwnershipEnforcement,GovernancePreset,GovernanceWorkflowEnforcement,ItemFormat,ParentReferencePolicy,SprintReleaseFormatPolicy,ValidateMetadataProfile,ValidateMetadataRequiredField } from "../types/index.js";
11
+ declare const CONFIG_SCOPE_VALUES:readonly ["project","global"];
12
12
  type ConfigScope = (typeof CONFIG_SCOPE_VALUES)[number];
13
13
  type ConfigAction = "get" | "set" | "list" | "export";
14
14
  type HistoryMissingStreamPolicy = "auto_create" | "strict_error";
@@ -18,166 +18,166 @@ type GovernanceForceRequiredForStaleLockPolicy = "enabled" | "disabled";
18
18
  type GovernanceRequireCloseReasonPolicy = "enabled" | "disabled";
19
19
  type ConfigValue = string | string[] | ItemFormat | HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceRequireCloseReasonPolicy | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | AgentIdentityVocabularySummary | ContextConfigValue;
20
20
  interface ContextConfigValue {
21
- default_depth: string;
22
- activity_limit: number;
23
- stale_threshold_days: number;
24
- sections: Record<string, boolean>;
21
+ default_depth:string;
22
+ activity_limit:number;
23
+ stale_threshold_days:number;
24
+ sections:Record<string,boolean>;
25
25
  }
26
26
  interface ConfigKeyDescriptor {
27
- key: ConfigKey;
28
- aliases: string[];
29
- value_kind: "string_array" | "enum" | "object";
30
- set_flags: string[];
31
- summary: string;
32
- value: ConfigValue;
27
+ key:ConfigKey;
28
+ aliases:string[];
29
+ value_kind:"string_array" | "enum" | "object";
30
+ set_flags:string[];
31
+ summary:string;
32
+ value:ConfigValue;
33
33
  }
34
34
  /** Documents the config command options payload exchanged by command, SDK, and package integrations. */
35
35
  export interface ConfigCommandOptions {
36
36
  /** Value that configures or reports criterion for this contract. */
37
- criterion?: string[];
37
+ criterion?:string[];
38
38
  /** Value that configures or reports format for this contract. */
39
- format?: string;
39
+ format?:string;
40
40
  /** Value that configures or reports policy for this contract. */
41
- policy?: string;
41
+ policy?:string;
42
42
  /** Value that configures or reports value for this contract. */
43
- value?: string;
43
+ value?:string;
44
44
  /** Value that configures or reports clear criteria for this contract. */
45
- clearCriteria?: boolean;
45
+ clearCriteria?:boolean;
46
46
  /** Fallback depth used when callers do not provide an override. */
47
- defaultDepth?: string;
47
+ defaultDepth?:string;
48
48
  /** Value that configures or reports activity limit for this contract. */
49
- activityLimit?: string;
49
+ activityLimit?:string;
50
50
  /** Value that configures or reports stale threshold days for this contract. */
51
- staleThresholdDays?: string;
51
+ staleThresholdDays?:string;
52
52
  /** Value that configures or reports section hierarchy for this contract. */
53
- sectionHierarchy?: string;
53
+ sectionHierarchy?:string;
54
54
  /** Value that configures or reports section activity for this contract. */
55
- sectionActivity?: string;
55
+ sectionActivity?:string;
56
56
  /** Value that configures or reports section progress for this contract. */
57
- sectionProgress?: string;
57
+ sectionProgress?:string;
58
58
  /** Value that configures or reports section blockers for this contract. */
59
- sectionBlockers?: string;
59
+ sectionBlockers?:string;
60
60
  /** Value that configures or reports section files for this contract. */
61
- sectionFiles?: string;
61
+ sectionFiles?:string;
62
62
  /** Value that configures or reports section workload for this contract. */
63
- sectionWorkload?: string;
63
+ sectionWorkload?:string;
64
64
  /** Value that configures or reports section staleness for this contract. */
65
- sectionStaleness?: string;
65
+ sectionStaleness?:string;
66
66
  /** Value that configures or reports section tests for this contract. */
67
- sectionTests?: string;
67
+ sectionTests?:string;
68
68
  }
69
69
  /** Documents the nested setting result value payload exchanged by command, SDK, and package integrations. */
70
70
  export interface NestedSettingResultValue {
71
71
  /** Value that configures or reports key for this contract. */
72
- key: string;
72
+ key:string;
73
73
  /** Preferred kebab-case CLI spelling for copy/paste-safe configuration. */
74
- canonical_key?: string;
74
+ canonical_key?:string;
75
75
  /** Filesystem path used for path resolution. */
76
- path: string;
76
+ path:string;
77
77
  /** Value that configures or reports kind for this contract. */
78
- kind: NestedSettingDescriptor["kind"];
78
+ kind:NestedSettingDescriptor["kind"];
79
79
  /** Value that configures or reports value for this contract. */
80
- value: string | number | boolean | null;
80
+ value:string | number | boolean | null;
81
81
  /** Short operator-facing explanation of the setting. */
82
- summary?: string;
82
+ summary?:string;
83
83
  /** Closed value domain when the setting accepts a fixed vocabulary. */
84
- choices?: string[];
84
+ choices?:string[];
85
85
  /** Inclusive numeric lower bound when one is declared. */
86
- min?: number;
86
+ min?:number;
87
87
  /** Inclusive numeric upper bound when one is declared. */
88
- max?: number;
88
+ max?:number;
89
89
  }
90
90
  /** Documents the config result payload exchanged by command, SDK, and package integrations. */
91
91
  export interface ConfigResult {
92
92
  /** Value that configures or reports scope for this contract. */
93
- scope: ConfigScope;
93
+ scope:ConfigScope;
94
94
  /** Value that configures or reports key for this contract. */
95
- key?: ConfigKey | string;
95
+ key?:ConfigKey | string;
96
96
  /** Value that configures or reports criteria for this contract. */
97
- criteria?: string[];
97
+ criteria?:string[];
98
98
  /** Value that configures or reports format for this contract. */
99
- format?: ItemFormat;
99
+ format?:ItemFormat;
100
100
  /** Value that configures or reports policy for this contract. */
101
- policy?: HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceRequireCloseReasonPolicy | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | string;
101
+ policy?:HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceRequireCloseReasonPolicy | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | string;
102
102
  /** Value that configures or reports nested setting for this contract. */
103
- nested_setting?: NestedSettingResultValue;
103
+ nested_setting?:NestedSettingResultValue;
104
104
  /** Configuration controlling nested behavior. */
105
- nested_settings?: NestedSettingResultValue[];
105
+ nested_settings?:NestedSettingResultValue[];
106
106
  /** Value that configures or reports keys for this contract. */
107
- keys?: ConfigKeyDescriptor[];
107
+ keys?:ConfigKeyDescriptor[];
108
108
  /** Value that configures or reports values for this contract. */
109
- values?: Record<ConfigKey, ConfigValue>;
109
+ values?:Record<ConfigKey,ConfigValue>;
110
110
  /** Value that configures or reports count for this contract. */
111
- count?: number;
111
+ count?:number;
112
112
  /** Configuration controlling context behavior. */
113
- context_settings?: ContextConfigValue;
113
+ context_settings?:ContextConfigValue;
114
114
  /** Privacy-safe revision/count projection for legacy author interpretation. */
115
- identity_vocabulary?: AgentIdentityVocabularySummary;
115
+ identity_vocabulary?:AgentIdentityVocabularySummary;
116
116
  /** Dry-run or committed vocabulary mutation receipt without alias spellings. */
117
- vocabulary_mutation?: AgentIdentityVocabularyMutationPreview;
117
+ vocabulary_mutation?:AgentIdentityVocabularyMutationPreview;
118
118
  /** Whether explicit item format applies to this operation. */
119
- has_explicit_item_format?: boolean;
119
+ has_explicit_item_format?:boolean;
120
120
  /** Value that configures or reports migration for this contract. */
121
- migration?: {
122
- target_format: ItemFormat;
123
- scanned: number;
124
- migrated: string[];
125
- removed: string[];
126
- warnings: string[];
121
+ migration?:{
122
+ target_format:ItemFormat;
123
+ scanned:number;
124
+ migrated:string[];
125
+ removed:string[];
126
+ warnings:string[];
127
127
  };
128
128
  /** Filesystem path used for settings resolution. */
129
- settings_path: string;
129
+ settings_path:string;
130
130
  /** Value that configures or reports changed for this contract. */
131
- changed: boolean;
131
+ changed:boolean;
132
132
  /** Value that configures or reports warnings for this contract. */
133
- warnings?: string[];
133
+ warnings?:string[];
134
134
  }
135
- declare function normalizeScope(value: string): ConfigScope;
136
- declare function normalizeAction(value: string): ConfigAction;
137
- declare function normalizeKey(value: string): ConfigKey;
138
- declare function normalizeCriteria(values: string[] | undefined, clearCriteria: boolean | undefined): string[];
139
- declare function normalizeItemFormat(value: string | undefined): ItemFormat;
140
- declare function normalizeHistoryMissingStreamPolicy(value: string | undefined): HistoryMissingStreamPolicy;
141
- declare function normalizeTestResultTrackingPolicy(value: string | undefined): TestResultTrackingPolicy;
142
- declare function normalizeTelemetryTrackingPolicy(value: string | undefined): TelemetryTrackingPolicy;
143
- declare function normalizeValidateMetadataProfile(value: string | undefined): ValidateMetadataProfile;
144
- declare function normalizeGovernancePreset(value: string | undefined): GovernancePreset;
145
- declare function normalizeGovernanceOwnershipEnforcement(value: string | undefined): GovernanceOwnershipEnforcement;
146
- declare function normalizeGovernanceCreateModeDefault(value: string | undefined): GovernanceCreateModeDefault;
147
- declare function normalizeGovernanceCloseValidationDefault(value: string | undefined): GovernanceCloseValidationDefault;
148
- declare function normalizeGovernanceWorkflowEnforcement(value: unknown): GovernanceWorkflowEnforcement;
149
- declare function normalizeGovernanceForceRequiredForStaleLockPolicy(value: string | undefined): GovernanceForceRequiredForStaleLockPolicy;
150
- declare function normalizeGovernanceRequireCloseReasonPolicy(value: string | undefined): GovernanceRequireCloseReasonPolicy;
151
- declare function normalizePolicyForConflict(key: ConfigKey | undefined, value: string): string;
152
- declare function normalizeMetadataRequiredFields(values: string[] | undefined, clearCriteria: boolean | undefined): ValidateMetadataRequiredField[];
153
- declare function normalizeWarnings(values: string[]): string[];
135
+ declare function normalizeScope(value:string):ConfigScope;
136
+ declare function normalizeAction(value:string):ConfigAction;
137
+ declare function normalizeKey(value:string):ConfigKey;
138
+ declare function normalizeCriteria(values:string[] | undefined,clearCriteria:boolean | undefined):string[];
139
+ declare function normalizeItemFormat(value:string | undefined):ItemFormat;
140
+ declare function normalizeHistoryMissingStreamPolicy(value:string | undefined):HistoryMissingStreamPolicy;
141
+ declare function normalizeTestResultTrackingPolicy(value:string | undefined):TestResultTrackingPolicy;
142
+ declare function normalizeTelemetryTrackingPolicy(value:string | undefined):TelemetryTrackingPolicy;
143
+ declare function normalizeValidateMetadataProfile(value:string | undefined):ValidateMetadataProfile;
144
+ declare function normalizeGovernancePreset(value:string | undefined):GovernancePreset;
145
+ declare function normalizeGovernanceOwnershipEnforcement(value:string | undefined):GovernanceOwnershipEnforcement;
146
+ declare function normalizeGovernanceCreateModeDefault(value:string | undefined):GovernanceCreateModeDefault;
147
+ declare function normalizeGovernanceCloseValidationDefault(value:string | undefined):GovernanceCloseValidationDefault;
148
+ declare function normalizeGovernanceWorkflowEnforcement(value:unknown):GovernanceWorkflowEnforcement;
149
+ declare function normalizeGovernanceForceRequiredForStaleLockPolicy(value:string | undefined):GovernanceForceRequiredForStaleLockPolicy;
150
+ declare function normalizeGovernanceRequireCloseReasonPolicy(value:string | undefined):GovernanceRequireCloseReasonPolicy;
151
+ declare function normalizePolicyForConflict(key:ConfigKey | undefined,value:string):string;
152
+ declare function normalizeMetadataRequiredFields(values:string[] | undefined,clearCriteria:boolean | undefined):ValidateMetadataRequiredField[];
153
+ declare function normalizeWarnings(values:string[]):string[];
154
154
  /** Route an intuitive `pm config set <key> <value>` positional value onto the typed flag it belongs to (--format/--policy/--criterion), applying enabled/disabled synonyms. Returns the (possibly augmented) options. The typed-flag forms keep working exactly as before: a positional value is only injected when its flag was not already supplied, and a conflicting explicit flag is a clear error. */
155
- declare function applyPositionalValue(action: ConfigAction, keyValue: string | undefined, normalizedKey: ConfigKey | undefined, nestedSetting: NestedSettingDescriptor | undefined, valueValue: string | undefined, options: ConfigCommandOptions): ConfigCommandOptions;
156
- declare function hasGovernanceValidationMirrorChange<T extends ParentReferencePolicy | ValidateMetadataProfile>(governanceValue: T, validationValue: T, nextPolicy: T): boolean;
155
+ declare function applyPositionalValue(action:ConfigAction,keyValue:string | undefined,normalizedKey:ConfigKey | undefined,nestedSetting:NestedSettingDescriptor | undefined,valueValue:string | undefined,options:ConfigCommandOptions):ConfigCommandOptions;
156
+ declare function hasGovernanceValidationMirrorChange<T extends ParentReferencePolicy | ValidateMetadataProfile>(governanceValue:T,validationValue:T,nextPolicy:T):boolean;
157
157
  /** Implements run config for the public runtime surface of this module. */
158
- export declare function runConfig(scopeValue: string, actionValue: string, keyValue: string | undefined, options: ConfigCommandOptions, global: GlobalOptions, valueValue?: string): Promise<ConfigResult>;
158
+ export declare function runConfig(scopeValue:string,actionValue:string,keyValue:string | undefined,options:ConfigCommandOptions,global:GlobalOptions,valueValue?:string):Promise<ConfigResult>;
159
159
  /** Public contract for test only config command, shared by SDK and presentation-layer consumers. */
160
- export declare const _testOnlyConfigCommand: {
161
- hasGovernanceValidationMirrorChange: typeof hasGovernanceValidationMirrorChange;
162
- applyPositionalValue: typeof applyPositionalValue;
163
- normalizeAction: typeof normalizeAction;
164
- normalizeCriteria: typeof normalizeCriteria;
165
- normalizeGovernanceCloseValidationDefault: typeof normalizeGovernanceCloseValidationDefault;
166
- normalizeGovernanceCreateModeDefault: typeof normalizeGovernanceCreateModeDefault;
167
- normalizeGovernanceForceRequiredForStaleLockPolicy: typeof normalizeGovernanceForceRequiredForStaleLockPolicy;
168
- normalizeGovernanceOwnershipEnforcement: typeof normalizeGovernanceOwnershipEnforcement;
169
- normalizeGovernancePreset: typeof normalizeGovernancePreset;
170
- normalizeGovernanceRequireCloseReasonPolicy: typeof normalizeGovernanceRequireCloseReasonPolicy;
171
- normalizeGovernanceWorkflowEnforcement: typeof normalizeGovernanceWorkflowEnforcement;
172
- normalizeHistoryMissingStreamPolicy: typeof normalizeHistoryMissingStreamPolicy;
173
- normalizeItemFormat: typeof normalizeItemFormat;
174
- normalizeKey: typeof normalizeKey;
175
- normalizeMetadataRequiredFields: typeof normalizeMetadataRequiredFields;
176
- normalizePolicyForConflict: typeof normalizePolicyForConflict;
177
- normalizeScope: typeof normalizeScope;
178
- normalizeTelemetryTrackingPolicy: typeof normalizeTelemetryTrackingPolicy;
179
- normalizeTestResultTrackingPolicy: typeof normalizeTestResultTrackingPolicy;
180
- normalizeValidateMetadataProfile: typeof normalizeValidateMetadataProfile;
181
- normalizeWarnings: typeof normalizeWarnings;
160
+ export declare const _testOnlyConfigCommand:{
161
+ hasGovernanceValidationMirrorChange:typeof hasGovernanceValidationMirrorChange;
162
+ applyPositionalValue:typeof applyPositionalValue;
163
+ normalizeAction:typeof normalizeAction;
164
+ normalizeCriteria:typeof normalizeCriteria;
165
+ normalizeGovernanceCloseValidationDefault:typeof normalizeGovernanceCloseValidationDefault;
166
+ normalizeGovernanceCreateModeDefault:typeof normalizeGovernanceCreateModeDefault;
167
+ normalizeGovernanceForceRequiredForStaleLockPolicy:typeof normalizeGovernanceForceRequiredForStaleLockPolicy;
168
+ normalizeGovernanceOwnershipEnforcement:typeof normalizeGovernanceOwnershipEnforcement;
169
+ normalizeGovernancePreset:typeof normalizeGovernancePreset;
170
+ normalizeGovernanceRequireCloseReasonPolicy:typeof normalizeGovernanceRequireCloseReasonPolicy;
171
+ normalizeGovernanceWorkflowEnforcement:typeof normalizeGovernanceWorkflowEnforcement;
172
+ normalizeHistoryMissingStreamPolicy:typeof normalizeHistoryMissingStreamPolicy;
173
+ normalizeItemFormat:typeof normalizeItemFormat;
174
+ normalizeKey:typeof normalizeKey;
175
+ normalizeMetadataRequiredFields:typeof normalizeMetadataRequiredFields;
176
+ normalizePolicyForConflict:typeof normalizePolicyForConflict;
177
+ normalizeScope:typeof normalizeScope;
178
+ normalizeTelemetryTrackingPolicy:typeof normalizeTelemetryTrackingPolicy;
179
+ normalizeTestResultTrackingPolicy:typeof normalizeTestResultTrackingPolicy;
180
+ normalizeValidateMetadataProfile:typeof normalizeValidateMetadataProfile;
181
+ normalizeWarnings:typeof normalizeWarnings;
182
182
  };
183
183
  export {};
@@ -6,4 +6,4 @@ export declare const CONTEXT_RECENCY_EPOCH = "1970-01-01T00:00:00.000Z";
6
6
  * rejected because they cannot round-trip through the strict timestamp contract
7
7
  * losslessly and deterministically.
8
8
  */
9
- export declare function canonicalizeContextRecencyCoordinate(value: unknown): string | null;
9
+ export declare function canonicalizeContextRecencyCoordinate(value:unknown):string | null;
@@ -1,32 +1,32 @@
1
1
  import { type AgentSemanticAttribution } from "../../core/session/session-state.js";
2
2
  import { readSettings } from "../../core/store/settings.js";
3
3
  /** Resolve an item's canonical parent lineage under a strict depth bound. */
4
- export declare function resolveSemanticLineageIds(pmRoot: string, settings: Awaited<ReturnType<typeof readSettings>>, itemId: string): Promise<string[]>;
4
+ export declare function resolveSemanticLineageIds(pmRoot:string,settings:Awaited<ReturnType<typeof readSettings>>,itemId:string):Promise<string[]>;
5
5
  /** Record one successful claim and its bounded canonical lineage. */
6
- export declare function recordClaimSemanticAttribution(params: {
7
- pmRoot: string;
8
- settings: Awaited<ReturnType<typeof readSettings>>;
9
- principal: string;
10
- itemId: string;
11
- }): Promise<void>;
6
+ export declare function recordClaimSemanticAttribution(params:{
7
+ pmRoot:string;
8
+ settings:Awaited<ReturnType<typeof readSettings>>;
9
+ principal:string;
10
+ itemId:string;
11
+ }):Promise<void>;
12
12
  /** Remove one released claim from the active semantic workset. */
13
- export declare function recordReleaseSemanticAttribution(params: {
14
- pmRoot: string;
15
- principal: string;
16
- itemId: string;
17
- }): Promise<void>;
13
+ export declare function recordReleaseSemanticAttribution(params:{
14
+ pmRoot:string;
15
+ principal:string;
16
+ itemId:string;
17
+ }):Promise<void>;
18
18
  /** Set or clear focused semantic work with canonical lineage evidence. */
19
- export declare function recordFocusSemanticAttribution(params: {
20
- pmRoot: string;
21
- settings: Awaited<ReturnType<typeof readSettings>>;
22
- principal: string;
23
- itemId?: string;
24
- }): Promise<void>;
19
+ export declare function recordFocusSemanticAttribution(params:{
20
+ pmRoot:string;
21
+ settings:Awaited<ReturnType<typeof readSettings>>;
22
+ principal:string;
23
+ itemId?:string;
24
+ }):Promise<void>;
25
25
  /** Public constants used by scale and negative-control tests. */
26
- export declare const SEMANTIC_ATTRIBUTION_LIMITS: {
27
- readonly lineage_depth: 16;
28
- readonly active_items: 64;
29
- readonly evidence_rows: 32;
26
+ export declare const SEMANTIC_ATTRIBUTION_LIMITS:{
27
+ readonly lineage_depth:16;
28
+ readonly active_items:64;
29
+ readonly evidence_rows:32;
30
30
  };
31
31
  /** Convert bounded claim/focus evidence into normalized context affinity. */
32
- export declare function semanticAttributionAffinity(attribution: AgentSemanticAttribution | undefined): Readonly<Record<string, number>> | undefined;
32
+ export declare function semanticAttributionAffinity(attribution:AgentSemanticAttribution | undefined):Readonly<Record<string,number>> | undefined;
@@ -6,4 +6,4 @@
6
6
  */
7
7
  import { finalizeContextUsageDelivery } from "../context-usage.js";
8
8
  /** Finalize derived usage feedback and attach a stable warning on failure. */
9
- export declare function finalizeContextUsageEgress(pmRoot: string, projected: unknown, finalize?: typeof finalizeContextUsageDelivery): Promise<void>;
9
+ export declare function finalizeContextUsageEgress(pmRoot:string,projected:unknown,finalize?:typeof finalizeContextUsageDelivery):Promise<void>;
@@ -1,41 +1,41 @@
1
- import type { ContextUsageEvent, ContextUsageLedgerOptions } from "../context-usage.js";
1
+ import type { ContextUsageEvent,ContextUsageLedgerOptions } from "../context-usage.js";
2
2
  /** Public storage and sampling ceilings shared by every feedback producer. */
3
- export declare const CONTEXT_USAGE_LIMITS: {
4
- readonly max_serving_rows: 256;
5
- readonly max_bytes: 262144;
6
- readonly max_event_bytes: 32768;
7
- readonly retained_byte_fraction: 0.5;
8
- readonly max_events: 2048;
9
- readonly retention_days: 30;
3
+ export declare const CONTEXT_USAGE_LIMITS:{
4
+ readonly max_serving_rows:256;
5
+ readonly max_bytes:262144;
6
+ readonly max_event_bytes:32768;
7
+ readonly retained_byte_fraction:0.5;
8
+ readonly max_events:2048;
9
+ readonly retention_days:30;
10
10
  };
11
11
  /** Measured persistence work for one lock-protected feedback write. */
12
12
  export interface ContextUsageWriteReceipt {
13
13
  /** Bytes written to the append or replacement file; excludes lock metadata. */
14
- written_bytes: number;
14
+ written_bytes:number;
15
15
  /** Physical ledger size at the end of the protected write. */
16
- ledger_bytes: number;
16
+ ledger_bytes:number;
17
17
  /** Whether this write replaced the ledger with a retained suffix. */
18
- compacted: boolean;
18
+ compacted:boolean;
19
19
  /** Wall-clock time waiting to acquire the cross-process ledger lock. */
20
- lock_wait_ms: number;
20
+ lock_wait_ms:number;
21
21
  }
22
22
  /** Named validation failure emitted by context-usage SDK inputs. */
23
23
  export declare class ContextUsageValidationError extends TypeError {
24
24
  /** Stable code for package and CLI hosts. */
25
25
  readonly code = "context_usage_validation_failed";
26
26
  /** Reject invalid feedback controls without exposing ledger contents. */
27
- constructor(message: string);
27
+ constructor(message:string);
28
28
  }
29
29
  /** Normalize one timestamp so filtering and serialization share the same clock. */
30
- export declare function resolveNow(options: ContextUsageLedgerOptions): {
31
- iso: string;
32
- ms: number;
30
+ export declare function resolveNow(options:ContextUsageLedgerOptions):{
31
+ iso:string;
32
+ ms:number;
33
33
  };
34
34
  /** Read only a bounded file suffix, dropping a partial first JSONL row. */
35
- export declare function readEvents(options: ContextUsageLedgerOptions): Promise<ContextUsageEvent[]>;
35
+ export declare function readEvents(options:ContextUsageLedgerOptions):Promise<ContextUsageEvent[]>;
36
36
  /**
37
37
  * Append once, or compact atomically to a half-full suffix at the high-water mark.
38
38
  * Requires trusted, stable workspace directory entries and ancestors; the lock
39
39
  * coordinates cooperating writers and cannot constrain hostile path replacement.
40
40
  */
41
- export declare function appendEvents(options: ContextUsageLedgerOptions, events: readonly ContextUsageEvent[], deliveryServeId?: string): Promise<ContextUsageWriteReceipt>;
41
+ export declare function appendEvents(options:ContextUsageLedgerOptions,events:readonly ContextUsageEvent[],deliveryServeId?:string):Promise<ContextUsageWriteReceipt>;
@@ -5,83 +5,83 @@ export type PmContextIntentSource = "core" | "package" | "workspace";
5
5
  /** One named, bounded projection of a command's context. */
6
6
  export interface PmContextIntentContract {
7
7
  /** Command that accepts the intent. */
8
- command: PmContextIntentCommand;
8
+ command:PmContextIntentCommand;
9
9
  /** Stable intent identifier used by CLI, SDK, and MCP callers. */
10
- intent: string;
10
+ intent:string;
11
11
  /** Agent-facing explanation of the projection's purpose. */
12
- description: string;
12
+ description:string;
13
13
  /** Declared output field groups retained by the projection. */
14
- included_field_groups: string[];
14
+ included_field_groups:string[];
15
15
  /** Default maximum estimated tokens before normal degradation applies. */
16
- token_budget: number;
16
+ token_budget:number;
17
17
  /** Layer that supplied the resolved declaration. */
18
- source?: PmContextIntentSource;
18
+ source?:PmContextIntentSource;
19
19
  }
20
20
  /** Machine-readable proof of the intent projection resolved for one read result. */
21
21
  export interface PmContextIntentReceipt {
22
22
  /** Canonical read command that resolved the intent. */
23
- command: string;
23
+ command:string;
24
24
  /** Stable selected intent name. */
25
- intent: string;
25
+ intent:string;
26
26
  /** Layer that supplied the resolved declaration. */
27
- source: PmContextIntentSource;
27
+ source:PmContextIntentSource;
28
28
  /** Field groups the selected intent promises to retain. */
29
- included_field_groups: string[];
29
+ included_field_groups:string[];
30
30
  /** Effective token ceiling after an explicit caller override is applied. */
31
- token_budget: number;
31
+ token_budget:number;
32
32
  /** Ceiling declared by the selected intent before caller overrides. */
33
- declared_token_budget: number;
33
+ declared_token_budget:number;
34
34
  /** Signed difference between the effective and declared ceilings. */
35
- token_budget_override: number;
35
+ token_budget_override:number;
36
36
  /** Deterministic JSON-size estimate for the useful result before any receipt-only omission. */
37
- estimated_tokens: number;
37
+ estimated_tokens:number;
38
38
  /** Whether the measured result fits the effective ceiling after caller overrides. */
39
- within_budget: boolean;
39
+ within_budget:boolean;
40
40
  /** Projection strategy applied before the result was measured. */
41
- degradation: "bounded_fields_and_rows" | "bounded_ranked_rows" | "bounded_sections" | "budget_row_compaction" | "recursive_budget_compaction" | "budget_receipt_only" | "standard_item" | "none";
41
+ degradation:"bounded_fields_and_rows" | "bounded_ranked_rows" | "bounded_sections" | "budget_row_compaction" | "recursive_budget_compaction" | "budget_receipt_only" | "standard_item" | "none";
42
42
  /** Whether the declared ceiling can carry the measured useful projection, independent of an override. */
43
- declaration_feasible: boolean;
43
+ declaration_feasible:boolean;
44
44
  /** True only when no useful result survived the effective ceiling. */
45
- result_omitted: boolean;
45
+ result_omitted:boolean;
46
46
  /** Row ceiling calculated from the selected intent's effective token budget. */
47
- budget_derived_limit?: number;
47
+ budget_derived_limit?:number;
48
48
  /** Constraint that selected the effective page size for row-oriented reads. */
49
- binding_constraint?: "explicit_limit" | "token_budget";
49
+ binding_constraint?:"explicit_limit" | "token_budget";
50
50
  /** Machine-readable explanation for the selected row ceiling. */
51
- limit_reason?: string;
51
+ limit_reason?:string;
52
52
  }
53
53
  /** Built-in intent projections shared by CLI, SDK, MCP, and package authors. */
54
- export declare const PM_CONTEXT_INTENT_CONTRACTS: readonly PmContextIntentContract[];
54
+ export declare const PM_CONTEXT_INTENT_CONTRACTS:readonly PmContextIntentContract[];
55
55
  /** Runtime declaration layers applied to one asynchronous SDK or CLI execution. */
56
56
  export interface PmContextIntentRuntimeLayers {
57
57
  /** Workspace declarations, which may override a core or package declaration. */
58
- workspaceContracts?: readonly PmContextIntentContract[];
58
+ workspaceContracts?:readonly PmContextIntentContract[];
59
59
  /** Package declarations, which may add but not replace earlier declarations. */
60
- packageContracts?: readonly PmContextIntentContract[];
60
+ packageContracts?:readonly PmContextIntentContract[];
61
61
  }
62
62
  /** Return the request-scoped intent registry, or the immutable built-in registry outside a configured scope. */
63
- export declare function getActiveContextIntentContracts(): readonly PmContextIntentContract[];
63
+ export declare function getActiveContextIntentContracts():readonly PmContextIntentContract[];
64
64
  /** Execute asynchronous work with isolated workspace and package intent declarations. */
65
- export declare function runWithContextIntentContracts<T>(layers: PmContextIntentRuntimeLayers, run: () => T): T;
65
+ export declare function runWithContextIntentContracts<T>(layers:PmContextIntentRuntimeLayers,run:() => T):T;
66
66
  /** Validate and compose core, package, and workspace intent declarations. Later layers override earlier layers by command and intent. */
67
- export declare function composeContextIntentContracts(workspaceContracts?: readonly PmContextIntentContract[], packageContracts?: readonly PmContextIntentContract[]): PmContextIntentContract[];
67
+ export declare function composeContextIntentContracts(workspaceContracts?:readonly PmContextIntentContract[],packageContracts?:readonly PmContextIntentContract[]):PmContextIntentContract[];
68
68
  /** Resolve one intent declaration or fail with the nearest command-local intent. */
69
- export declare function resolveContextIntentContract(command: string, intent: string, contracts?: readonly PmContextIntentContract[], positionalArguments?: readonly string[]): PmContextIntentContract | undefined;
69
+ export declare function resolveContextIntentContract(command:string,intent:string,contracts?:readonly PmContextIntentContract[],positionalArguments?:readonly string[]):PmContextIntentContract | undefined;
70
70
  /** Apply one declared read intent's defaults while preserving explicit caller options. */
71
- export declare function applyContextIntentProjection(command: "context" | "get" | "list" | "next" | "search", options: Record<string, unknown>, positionalArguments?: readonly string[]): Record<string, unknown>;
71
+ export declare function applyContextIntentProjection(command:"context" | "get" | "list" | "next" | "search",options:Record<string,unknown>,positionalArguments?:readonly string[]):Record<string,unknown>;
72
72
  interface ContextIntentCursorEnvelope {
73
- fingerprint: string;
74
- after_index: number;
75
- snapshot?: string;
73
+ fingerprint:string;
74
+ after_index:number;
75
+ snapshot?:string;
76
76
  }
77
77
  /** Decode the cursor fields required to preserve a row-compacted continuation. */
78
- export declare function decodeContextIntentCursor(cursor: string): ContextIntentCursorEnvelope | undefined;
78
+ export declare function decodeContextIntentCursor(cursor:string):ContextIntentCursorEnvelope | undefined;
79
79
  /** Resolve the stable item id carried by list rows and nested search hits. */
80
- export declare function contextIntentRowId(row: unknown): string | undefined;
80
+ export declare function contextIntentRowId(row:unknown):string | undefined;
81
81
  /** Attach budget and degradation evidence for a selected built-in read intent. */
82
- export declare function attachContextIntentReceipt<Result extends Record<string, unknown>>(command: string, options: Record<string, unknown>, result: Result): Result & {
83
- context_intent?: PmContextIntentReceipt;
82
+ export declare function attachContextIntentReceipt<Result extends Record<string,unknown>>(command:string,options:Record<string,unknown>,result:Result):Result & {
83
+ context_intent?:PmContextIntentReceipt;
84
84
  };
85
85
  /** Attach universal row, omission, and optional intent-budget contracts in rendering order. */
86
- export declare function attachReadOutputContracts(command: string | undefined, options: Record<string, unknown>, result: unknown): unknown;
86
+ export declare function attachReadOutputContracts(command:string | undefined,options:Record<string,unknown>,result:unknown):unknown;
87
87
  export {};