@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,19 +1,19 @@
1
1
  /** Result of normalizing one item-addressed invocation. */
2
2
  export interface ItemAddressInvocationResult {
3
3
  /** Canonical argv with an `--id` value moved into positional-id location. */
4
- argv: string[];
4
+ argv:string[];
5
5
  /** Whether argv changed. */
6
- changed: boolean;
6
+ changed:boolean;
7
7
  /** Whether both positional and named item ids were supplied. */
8
- conflict: boolean;
8
+ conflict:boolean;
9
9
  /** Resolved named item id when one was present. */
10
- itemId?: string;
10
+ itemId?:string;
11
11
  }
12
12
  /** Return whether a command participates in the shared item-id alias contract. */
13
- export declare function supportsItemIdAlias(commandName: string | undefined): boolean;
13
+ export declare function supportsItemIdAlias(commandName:string | undefined):boolean;
14
14
  /**
15
15
  * Normalize `pm <command> --id <value>` to the command's positional id form.
16
16
  * The transformation is lossless for every other argument and reports a
17
17
  * conflict instead of guessing when both forms are present.
18
18
  */
19
- export declare function normalizeItemAddressInvocation(argv: string[]): ItemAddressInvocationResult;
19
+ export declare function normalizeItemAddressInvocation(argv:string[]):ItemAddressInvocationResult;
@@ -13,58 +13,58 @@ export type PmRefusalEvidenceKind = "owned_state" | "closed_domain" | "grammar";
13
13
  /** One complete-catalog closure row. */
14
14
  export interface PmRefusalClosureCensusRow {
15
15
  /** Declared machine-readable error code. */
16
- code: string;
16
+ code:string;
17
17
  /** Canonical compatibility-group code. */
18
- canonical_code: string;
18
+ canonical_code:string;
19
19
  /** Whether at least one executable probe reaches the compatibility group. */
20
- disposition: "executable" | "uncovered";
20
+ disposition:"executable" | "uncovered";
21
21
  /** Evidence families contributing executable probes. */
22
- evidence_kinds: PmRefusalEvidenceKind[];
22
+ evidence_kinds:PmRefusalEvidenceKind[];
23
23
  /** Stable executable probe identities. */
24
- probe_ids: string[];
24
+ probe_ids:string[];
25
25
  }
26
26
  /** Full emitted-vocabulary refusal closure receipt. */
27
27
  export interface PmRefusalClosureCensusReport {
28
28
  /** True only when every catalog code belongs to a probed compatibility group. */
29
- ok: boolean;
29
+ ok:boolean;
30
30
  /** Number of emitted codes in the catalog. */
31
- catalog_error_code_count: number;
31
+ catalog_error_code_count:number;
32
32
  /** Number of codes backed by executable evidence. */
33
- executable_error_code_count: number;
33
+ executable_error_code_count:number;
34
34
  /** Number of codes still lacking executable evidence. */
35
- uncovered_error_code_count: number;
35
+ uncovered_error_code_count:number;
36
36
  /** Executable codes divided by all catalog codes. */
37
- coverage_fraction: number;
37
+ coverage_fraction:number;
38
38
  /** Number of closed-domain probes joined into the census. */
39
- closed_domain_probe_count: number;
39
+ closed_domain_probe_count:number;
40
40
  /** Number of grammar-derived probes joined into the census. */
41
- grammar_probe_count: number;
41
+ grammar_probe_count:number;
42
42
  /** Stable complete list of codes without executable evidence. */
43
- uncovered_error_codes: string[];
43
+ uncovered_error_codes:string[];
44
44
  /** Exactly one row for every catalog code. */
45
- rows: PmRefusalClosureCensusRow[];
45
+ rows:PmRefusalClosureCensusRow[];
46
46
  }
47
47
  /** @deprecated Historical v1 floor retained for SDK compatibility. */
48
48
  export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE = 16;
49
49
  /** @deprecated Historical v1 identities retained for SDK compatibility. */
50
- export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE: readonly ["bulk_ids_input_empty", "bulk_ids_input_missing_path", "bulk_ids_input_unreadable", "invalid_argument_value", "missing_lifecycle_target", "missing_required_argument", "projection_options_mutually_exclusive", "tracker_not_initialized", "tracker_root_missing", "tracker_root_not_directory", "tracker_root_unreadable", "unknown_context_intent", "unknown_field_projection", "unknown_option", "unknown_subcommand"];
50
+ export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE:readonly ["bulk_ids_input_empty","bulk_ids_input_missing_path","bulk_ids_input_unreadable","invalid_argument_value","missing_lifecycle_target","missing_required_argument","projection_options_mutually_exclusive","tracker_not_initialized","tracker_root_missing","tracker_root_not_directory","tracker_root_unreadable","unknown_context_intent","unknown_field_projection","unknown_option","unknown_subcommand"];
51
51
  /** Reviewed v2 floor of 18 catalog rows across 17 canonical groups. */
52
52
  export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE_V2 = 18;
53
53
  /** V2 canonical identities that must retain executable evidence. */
54
- export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE_V2: readonly string[];
54
+ export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE_V2:readonly string[];
55
55
  /** Ratchet receipt that prevents catalog growth from erasing proven closure. */
56
- export declare function verifyPmRefusalClosureRatchet(report: PmRefusalClosureCensusReport, baseline?: number): {
57
- ok: boolean;
58
- baseline: number;
59
- actual: number;
56
+ export declare function verifyPmRefusalClosureRatchet(report:PmRefusalClosureCensusReport,baseline?:number):{
57
+ ok:boolean;
58
+ baseline:number;
59
+ actual:number;
60
60
  };
61
61
  /** Ratchet canonical compatibility-group identities independently from counts. */
62
- export declare function verifyPmRefusalClosureIdentityRatchet(report: PmRefusalClosureCensusReport, requiredCanonicalCodes?: readonly string[]): {
63
- ok: boolean;
64
- required_canonical_codes: string[];
65
- missing_required_canonical_codes: string[];
62
+ export declare function verifyPmRefusalClosureIdentityRatchet(report:PmRefusalClosureCensusReport,requiredCanonicalCodes?:readonly string[]):{
63
+ ok:boolean;
64
+ required_canonical_codes:string[];
65
+ missing_required_canonical_codes:string[];
66
66
  };
67
67
  /** Build the complete closure join without silently omitting uncovered codes. */
68
- export declare function buildPmRefusalClosureCensus(catalog: readonly PmErrorCodeContract[], closedDomains: readonly PmClosedDomainContract[], grammar: readonly PmGrammarRefusalContract[]): PmRefusalClosureCensusReport;
68
+ export declare function buildPmRefusalClosureCensus(catalog:readonly PmErrorCodeContract[],closedDomains:readonly PmClosedDomainContract[],grammar:readonly PmGrammarRefusalContract[]):PmRefusalClosureCensusReport;
69
69
  /** Render the complete census for generated documentation and review evidence. */
70
- export declare function renderPmRefusalClosureCensusMarkdown(report: PmRefusalClosureCensusReport): string;
70
+ export declare function renderPmRefusalClosureCensusMarkdown(report:PmRefusalClosureCensusReport):string;
@@ -1,53 +1,53 @@
1
1
  /** One real refusal and the outcome of executing its advertised retry. */
2
2
  export interface PmRefusalClosureObservation {
3
3
  /** Stable corpus identifier. */
4
- probe_id: string;
4
+ probe_id:string;
5
5
  /** Public entrypoint that refused the invocation. */
6
- entrypoint: string;
6
+ entrypoint:string;
7
7
  /** Process exit code returned by the refusal. */
8
- exit_code: number;
8
+ exit_code:number;
9
9
  /** Rejected closed-domain token. */
10
- rejected_value: string;
10
+ rejected_value:string;
11
11
  /** Complete accepted domain emitted by the refusal. */
12
- allowed_values: readonly string[];
12
+ allowed_values:readonly string[];
13
13
  /** Stable error code emitted by the refusal. */
14
- error_code?: string;
14
+ error_code?:string;
15
15
  /** Contract-owned error code required for this refusal. */
16
- expected_error_code?: string;
16
+ expected_error_code?:string;
17
17
  /** Contract-owned complete accepted domain. */
18
- expected_allowed_values?: readonly string[];
18
+ expected_allowed_values?:readonly string[];
19
19
  /** Whether an accepted-value domain is required for this refusal class. */
20
- allowed_values_required?: boolean;
20
+ allowed_values_required?:boolean;
21
21
  /** Exact command emitted for recovery. */
22
- suggested_retry: string;
22
+ suggested_retry:string;
23
23
  /** Shell-free argv emitted for safe programmatic recovery. */
24
- suggested_retry_args?: readonly string[];
24
+ suggested_retry_args?:readonly string[];
25
25
  /** Contract-owned argv required for deterministic recovery. */
26
- expected_suggested_retry_args?: readonly string[];
26
+ expected_suggested_retry_args?:readonly string[];
27
27
  /** Whether executing the advertised retry succeeded. */
28
- retry_succeeded: boolean;
28
+ retry_succeeded:boolean;
29
29
  }
30
30
  /** One missing or contradictory recovery primitive. */
31
31
  export interface PmRefusalClosureFinding {
32
32
  /** Stable finding code. */
33
- code: "accepted_rejected_value" | "duplicate_probe" | "error_code_mismatch" | "empty_corpus" | "incomplete_allowed_values" | "missing_allowed_values" | "missing_suggested_retry_args" | "missing_suggested_retry" | "non_refusal_exit" | "suggested_retry_args_mismatch" | "retry_failed";
33
+ code:"accepted_rejected_value" | "duplicate_probe" | "error_code_mismatch" | "empty_corpus" | "incomplete_allowed_values" | "missing_allowed_values" | "missing_suggested_retry_args" | "missing_suggested_retry" | "non_refusal_exit" | "suggested_retry_args_mismatch" | "retry_failed";
34
34
  /** Stable corpus identifier. */
35
- probe_id: string;
35
+ probe_id:string;
36
36
  /** Actionable mismatch detail. */
37
- detail: string;
37
+ detail:string;
38
38
  }
39
39
  /** Complete recovery-closure score and its fail-closed findings. */
40
40
  export interface PmRefusalClosureReport {
41
41
  /** Whether every refusal was self-contained and executable. */
42
- ok: boolean;
42
+ ok:boolean;
43
43
  /** Number of unique probes scored. */
44
- probe_count: number;
44
+ probe_count:number;
45
45
  /** Number of probes with complete successful closure. */
46
- closed_probe_count: number;
46
+ closed_probe_count:number;
47
47
  /** Closed probes divided by unique probes. */
48
- closure_fraction: number;
48
+ closure_fraction:number;
49
49
  /** Stable ordered findings. */
50
- findings: readonly PmRefusalClosureFinding[];
50
+ findings:readonly PmRefusalClosureFinding[];
51
51
  }
52
52
  /** Score structured closed-domain refusals and executable retries. */
53
- export declare function scorePmRefusalClosure(observations: readonly PmRefusalClosureObservation[]): PmRefusalClosureReport;
53
+ export declare function scorePmRefusalClosure(observations:readonly PmRefusalClosureObservation[]):PmRefusalClosureReport;
@@ -2,75 +2,75 @@ import { type PmCommandPositionalContract } from "../cli-contracts/grammar-contr
2
2
  /** Shared executable shape for a refusal that must not mutate tracker state. */
3
3
  export interface PmGrammarRefusalContract {
4
4
  /** Stable probe identity used by ratchets and evidence. */
5
- probe_id: string;
5
+ probe_id:string;
6
6
  /** Canonical command path under test. */
7
- command: string;
7
+ command:string;
8
8
  /** Exact argv expected to refuse. */
9
- refusal_args: readonly string[];
9
+ refusal_args:readonly string[];
10
10
  /** Exact help argv that must execute successfully after the refusal. */
11
- recovery_args: readonly string[];
11
+ recovery_args:readonly string[];
12
12
  /** Stable problem-envelope code expected from the refusal. */
13
- error_code: "invalid_argument_value" | "missing_lifecycle_target" | "missing_required_argument" | "unknown_subcommand";
13
+ error_code:"invalid_argument_value" | "missing_lifecycle_target" | "missing_required_argument" | "unknown_subcommand";
14
14
  }
15
15
  /** One required positional omission derived from the grammar declaration. */
16
16
  export interface PmRequiredArgumentRefusalContract extends PmGrammarRefusalContract {
17
17
  /** Stable positional name deliberately omitted by the probe. */
18
- missing_argument: string;
18
+ missing_argument:string;
19
19
  /** Zero-based slot index in the command's declared positional signature. */
20
- missing_argument_index: number;
20
+ missing_argument_index:number;
21
21
  }
22
22
  /** One invalid action probe for a closed positional subcommand family. */
23
23
  export interface PmSubcommandRefusalContract extends PmGrammarRefusalContract {
24
24
  /** Invalid action token used to reach the refusal. */
25
- rejected_value: string;
25
+ rejected_value:string;
26
26
  /** Complete authoritative action domain expected in recovery. */
27
- allowed_values: readonly string[];
27
+ allowed_values:readonly string[];
28
28
  }
29
29
  /** Runtime evidence for one grammar-derived refusal probe. */
30
30
  export interface PmGrammarRefusalObservation {
31
31
  /** Probe identity matching a declared contract. */
32
- probe_id: string;
32
+ probe_id:string;
33
33
  /** Machine-readable code emitted by the refusal. */
34
- error_code: string;
34
+ error_code:string;
35
35
  /** Process exit code emitted by the refusal. */
36
- exit_code: number;
36
+ exit_code:number;
37
37
  /** Allowed values emitted for a closed action family. */
38
- allowed_values: readonly string[];
38
+ allowed_values:readonly string[];
39
39
  /** Whether the advertised help recovery exited successfully. */
40
- recovery_succeeded: boolean;
40
+ recovery_succeeded:boolean;
41
41
  /** Whether any tracker state changed while executing the refusal. */
42
- refusal_mutated_state: boolean;
42
+ refusal_mutated_state:boolean;
43
43
  /** Repository-relative tracker paths changed by the refusal, when measured. */
44
- mutated_paths?: readonly string[];
44
+ mutated_paths?:readonly string[];
45
45
  }
46
46
  /** Stable reason a grammar-derived refusal failed closure. */
47
47
  export type PmGrammarRefusalFindingCode = "refusal_allowed_values_mismatch" | "refusal_error_code_mismatch" | "refusal_exit_code_mismatch" | "refusal_mutated_state" | "refusal_probe_missing" | "refusal_recovery_failed" | "unexpected_refusal_probe";
48
48
  /** One actionable grammar-derived refusal closure failure. */
49
49
  export interface PmGrammarRefusalFinding {
50
50
  /** Stable machine-readable failure category. */
51
- code: PmGrammarRefusalFindingCode;
51
+ code:PmGrammarRefusalFindingCode;
52
52
  /** Probe associated with the finding. */
53
- probe_id: string;
53
+ probe_id:string;
54
54
  /** Human-readable failure detail. */
55
- detail: string;
55
+ detail:string;
56
56
  }
57
57
  /** Aggregate closure receipt for the grammar-derived refusal corpus. */
58
58
  export interface PmGrammarRefusalClosureReport {
59
59
  /** Whether every declared probe refused safely and recovered. */
60
- ok: boolean;
60
+ ok:boolean;
61
61
  /** Number of declared probes. */
62
- probe_count: number;
62
+ probe_count:number;
63
63
  /** Number of probes without findings. */
64
- closed_probe_count: number;
64
+ closed_probe_count:number;
65
65
  /** Stable actionable failures. */
66
- findings: PmGrammarRefusalFinding[];
66
+ findings:PmGrammarRefusalFinding[];
67
67
  }
68
68
  /**
69
69
  * Return one omission probe for every required slot in the declared grammar.
70
70
  * Earlier positionals receive deterministic, non-mutating placeholder values.
71
71
  */
72
- export declare function listPmRequiredArgumentRefusalContracts(contracts?: readonly PmCommandPositionalContract[]): PmRequiredArgumentRefusalContract[];
72
+ export declare function listPmRequiredArgumentRefusalContracts(contracts?:readonly PmCommandPositionalContract[]):PmRequiredArgumentRefusalContract[];
73
73
  /** Return one invalid-action probe for every required positional action family. */
74
- export declare function listPmSubcommandRefusalContracts(contracts?: readonly PmCommandPositionalContract[]): PmSubcommandRefusalContract[];
74
+ export declare function listPmSubcommandRefusalContracts(contracts?:readonly PmCommandPositionalContract[]):PmSubcommandRefusalContract[];
75
75
  /** Score exact code, exit, domain, state-safety, and recovery closure. */
76
- export declare function scorePmGrammarRefusalClosure(contracts: readonly (PmRequiredArgumentRefusalContract | PmSubcommandRefusalContract)[], observations: readonly PmGrammarRefusalObservation[]): PmGrammarRefusalClosureReport;
76
+ export declare function scorePmGrammarRefusalClosure(contracts:readonly (PmRequiredArgumentRefusalContract | PmSubcommandRefusalContract)[],observations:readonly PmGrammarRefusalObservation[]):PmGrammarRefusalClosureReport;
@@ -1,175 +1,175 @@
1
- import type { PmErrorCodeContract, PmErrorCodeClass } from "../error-code-catalog.js";
1
+ import type { PmErrorCodeContract,PmErrorCodeClass } from "../error-code-catalog.js";
2
2
  /** One recorded result from driving a real public entrypoint into a refusal. */
3
3
  export interface PmRefusalProbeObservation {
4
4
  /** Stable probe identifier from the owning error-code contract. */
5
- probe_id: string;
5
+ probe_id:string;
6
6
  /** Public command entrypoint exercised by the probe. */
7
- entrypoint: string;
7
+ entrypoint:string;
8
8
  /** Machine-readable code observed at the transport boundary. */
9
- code: string;
9
+ code:string;
10
10
  /** Semantic exit class observed at the transport boundary. */
11
- exit_class: PmErrorCodeClass;
11
+ exit_class:PmErrorCodeClass;
12
12
  }
13
13
  /** One actionable conformance failure. */
14
14
  export interface PmRefusalReachabilityFinding {
15
15
  /** Stable finding kind for automation. */
16
- kind: "duplicate_probe" | "missing_probe" | "wrong_entrypoint" | "wrong_error_code" | "wrong_exit_class" | "undeclared_probe";
16
+ kind:"duplicate_probe" | "missing_probe" | "wrong_entrypoint" | "wrong_error_code" | "wrong_exit_class" | "undeclared_probe";
17
17
  /** Probe whose declaration or observation failed. */
18
- probe_id: string;
18
+ probe_id:string;
19
19
  /** Human-readable mismatch summary. */
20
- detail: string;
20
+ detail:string;
21
21
  }
22
22
  /** Complete refusal-reachability conformance receipt. */
23
23
  export interface PmRefusalReachabilityReport {
24
24
  /** Whether every declaration and observation agreed. */
25
- ok: boolean;
25
+ ok:boolean;
26
26
  /** Number of declared probes evaluated. */
27
- declared_probe_count: number;
27
+ declared_probe_count:number;
28
28
  /** Number of real-entrypoint observations supplied. */
29
- observed_probe_count: number;
29
+ observed_probe_count:number;
30
30
  /** Stable, sorted conformance findings. */
31
- findings: PmRefusalReachabilityFinding[];
31
+ findings:PmRefusalReachabilityFinding[];
32
32
  }
33
33
  /** Recovery-reference kinds emitted by structured refusal envelopes. */
34
- export declare const PM_RECOVERY_REFERENCE_KINDS: readonly ["suggested_retry", "candidate_command", "example", "next_step", "migration_hint", "restore_with"];
34
+ export declare const PM_RECOVERY_REFERENCE_KINDS:readonly ["suggested_retry","candidate_command","example","next_step","migration_hint","restore_with"];
35
35
  /** Recovery-reference kind emitted by a refusal. */
36
36
  export type PmRecoveryReferenceKind = (typeof PM_RECOVERY_REFERENCE_KINDS)[number];
37
37
  /** Behavioral promise attached to a recovery reference. */
38
38
  export type PmRecoveryReferenceSemantics = "recovery" | "replacement" | "behavior_preserving";
39
39
  /** Literal envelope fields recognized as recovery-reference producers. */
40
- export declare const PM_RECOVERY_REFERENCE_FIELDS: readonly ("suggested_retry" | "restore_with" | "next_best_command" | "candidate_commands" | "next_steps" | "examples" | "migration_hint" | "migration_hints" | "fallback_candidates" | "suggested_next_steps" | "example" | "candidate_command" | "next_step" | "retry_command")[];
40
+ export declare const PM_RECOVERY_REFERENCE_FIELDS:readonly ("suggested_retry" | "restore_with" | "next_best_command" | "candidate_commands" | "next_steps" | "examples" | "migration_hint" | "migration_hints" | "fallback_candidates" | "suggested_next_steps" | "example" | "candidate_command" | "next_step" | "retry_command")[];
41
41
  /** One source file supplied to the producer-census analyzer. */
42
42
  export interface PmRecoveryProducerSource {
43
43
  /** Repository-relative source path. */
44
- path: string;
44
+ path:string;
45
45
  /** Complete source text. */
46
- content: string;
46
+ content:string;
47
47
  }
48
48
  /** One literal recovery field emitted from a source location. */
49
49
  export interface PmRecoveryProducerLocation {
50
50
  /** Repository-relative producer source path. */
51
- path: string;
51
+ path:string;
52
52
  /** One-based source line. */
53
- line: number;
53
+ line:number;
54
54
  /** Literal structured-envelope field. */
55
- field: (typeof PM_RECOVERY_REFERENCE_FIELDS)[number];
55
+ field:(typeof PM_RECOVERY_REFERENCE_FIELDS)[number];
56
56
  /** Normalized recovery kind. */
57
- kind: PmRecoveryReferenceKind;
57
+ kind:PmRecoveryReferenceKind;
58
58
  }
59
59
  /** Producer-census failure that requires a new field contract or producer. */
60
60
  export interface PmRecoveryProducerCensusFinding {
61
61
  /** Stable finding kind. */
62
- kind: "invalid_source" | "missing_kind_producer" | "unknown_recovery_field";
62
+ kind:"invalid_source" | "missing_kind_producer" | "unknown_recovery_field";
63
63
  /** Source path or normalized kind. */
64
- subject: string;
64
+ subject:string;
65
65
  /** Actionable explanation. */
66
- detail: string;
66
+ detail:string;
67
67
  }
68
68
  /** Complete literal producer-table census for recovery references. */
69
69
  export interface PmRecoveryProducerCensusReport {
70
70
  /** Whether every recovery kind has a producer and no unknown fields exist. */
71
- ok: boolean;
71
+ ok:boolean;
72
72
  /** Source files inspected. */
73
- scanned_file_count: number;
73
+ scanned_file_count:number;
74
74
  /** Literal producer locations. */
75
- producer_count: number;
75
+ producer_count:number;
76
76
  /** Stable counts by normalized recovery kind. */
77
- producer_count_by_kind: Record<PmRecoveryReferenceKind, number>;
77
+ producer_count_by_kind:Record<PmRecoveryReferenceKind,number>;
78
78
  /** Stable producer locations. */
79
- producers: PmRecoveryProducerLocation[];
79
+ producers:PmRecoveryProducerLocation[];
80
80
  /** Missing-kind or unknown-field findings. */
81
- findings: PmRecoveryProducerCensusFinding[];
81
+ findings:PmRecoveryProducerCensusFinding[];
82
82
  }
83
83
  /** One derived promise that another invocation or command path is reachable. */
84
84
  export interface PmRecoveryReferenceObligation {
85
85
  /** Stable reference identifier derived from its emitting envelope. */
86
- id: string;
86
+ id:string;
87
87
  /** Refusal probe that emitted the reference. */
88
- probe_id: string;
88
+ probe_id:string;
89
89
  /** Typed recovery vocabulary rather than prose inference. */
90
- kind: PmRecoveryReferenceKind;
90
+ kind:PmRecoveryReferenceKind;
91
91
  /** Whether the reference recovers, replaces, or preserves the original behavior. */
92
- semantics: PmRecoveryReferenceSemantics;
92
+ semantics:PmRecoveryReferenceSemantics;
93
93
  /** Exact emitted command or recovery text. */
94
- value: string;
94
+ value:string;
95
95
  }
96
96
  /** Result of executing or resolving one derived recovery obligation. */
97
97
  export interface PmRecoveryReferenceObservation {
98
98
  /** Stable obligation identifier. */
99
- id: string;
99
+ id:string;
100
100
  /** Whether the promised recovery or command path was reachable. */
101
- reachable: boolean;
101
+ reachable:boolean;
102
102
  /** How the promise was discharged. */
103
- proof: "executed" | "declared_command_path" | "linked_execution";
103
+ proof:"executed" | "declared_command_path" | "linked_execution";
104
104
  /** Semantics actually demonstrated by the proof. */
105
- semantics: PmRecoveryReferenceSemantics;
105
+ semantics:PmRecoveryReferenceSemantics;
106
106
  }
107
107
  /** Coverage totals for one emitted recovery-reference kind. */
108
108
  export interface PmRecoveryReferenceKindCoverage {
109
109
  /** Typed reference kind. */
110
- kind: PmRecoveryReferenceKind;
110
+ kind:PmRecoveryReferenceKind;
111
111
  /** Derived obligations of this kind. */
112
- declared: number;
112
+ declared:number;
113
113
  /** Obligations with one observation. */
114
- observed: number;
114
+ observed:number;
115
115
  /** Obligations proven reachable. */
116
- passed: number;
116
+ passed:number;
117
117
  }
118
118
  /** One recovery-reference coverage failure. */
119
119
  export interface PmRecoveryReferenceFinding {
120
120
  /** Stable finding kind for assurance and CI. */
121
- kind: "duplicate_obligation" | "duplicate_observation" | "missing_observation" | "unreachable_reference" | "wrong_semantics" | "undeclared_observation";
121
+ kind:"duplicate_obligation" | "duplicate_observation" | "missing_observation" | "unreachable_reference" | "wrong_semantics" | "undeclared_observation";
122
122
  /** Obligation or observation identifier. */
123
- reference_id: string;
123
+ reference_id:string;
124
124
  /** Human-readable mismatch summary. */
125
- detail: string;
125
+ detail:string;
126
126
  }
127
127
  /** Complete cross-kind recovery-reference coverage receipt. */
128
128
  export interface PmRecoveryReferenceReport {
129
129
  /** Whether every derived reference was uniquely proven reachable. */
130
- ok: boolean;
130
+ ok:boolean;
131
131
  /** Total references derived from real refusal envelopes. */
132
- declared_reference_count: number;
132
+ declared_reference_count:number;
133
133
  /** Total reference observations supplied. */
134
- observed_reference_count: number;
134
+ observed_reference_count:number;
135
135
  /** Reachable fraction across the declared obligation set. */
136
- pass_fraction: number;
136
+ pass_fraction:number;
137
137
  /** Stable coverage buckets, including zero-population kinds. */
138
- coverage_by_kind: PmRecoveryReferenceKindCoverage[];
138
+ coverage_by_kind:PmRecoveryReferenceKindCoverage[];
139
139
  /** Stable, sorted conformance findings. */
140
- findings: PmRecoveryReferenceFinding[];
140
+ findings:PmRecoveryReferenceFinding[];
141
141
  }
142
142
  /** Per-kind runtime evidence; counts do not claim one observation per source location. */
143
143
  export interface PmRecoveryProducerRuntimeCoverage {
144
144
  /** Typed recovery-reference kind. */
145
- kind: PmRecoveryReferenceKind;
145
+ kind:PmRecoveryReferenceKind;
146
146
  /** Literal source producers discovered for the kind. */
147
- source_producers: number;
147
+ source_producers:number;
148
148
  /** Distinct runtime values observed for the kind. */
149
- runtime_values: number;
149
+ runtime_values:number;
150
150
  }
151
151
  /** Unified per-kind source-census and runtime-value coverage receipt. */
152
152
  export interface PmRecoveryProducerRuntimeReport {
153
153
  /** Whether every source-declared kind emitted at least one runtime value. */
154
- ok: boolean;
154
+ ok:boolean;
155
155
  /** Source producer denominator. */
156
- source_producer_count: number;
156
+ source_producer_count:number;
157
157
  /** Distinct runtime-value denominator. */
158
- runtime_value_count: number;
158
+ runtime_value_count:number;
159
159
  /** Stable per-kind source and runtime coverage. */
160
- coverage_by_kind: PmRecoveryProducerRuntimeCoverage[];
160
+ coverage_by_kind:PmRecoveryProducerRuntimeCoverage[];
161
161
  /** Kinds with source producers but no runtime evidence. */
162
- missing_runtime_kinds: PmRecoveryReferenceKind[];
162
+ missing_runtime_kinds:PmRecoveryReferenceKind[];
163
163
  }
164
164
  /** Census syntax-parsed structured-envelope producers without executing source code. */
165
- export declare function censusPmRecoveryReferenceProducers(sources: readonly PmRecoveryProducerSource[]): PmRecoveryProducerCensusReport;
165
+ export declare function censusPmRecoveryReferenceProducers(sources:readonly PmRecoveryProducerSource[]):PmRecoveryProducerCensusReport;
166
166
  /** Derive typed obligations from every recognized recovery field in an emitted envelope. */
167
- export declare function derivePmRecoveryReferenceObligations(probeId: string, envelope: unknown): PmRecoveryReferenceObligation[];
167
+ export declare function derivePmRecoveryReferenceObligations(probeId:string,envelope:unknown):PmRecoveryReferenceObligation[];
168
168
  /** Compare declared refusal states with real-entrypoint observations. */
169
- export declare function verifyPmRefusalReachability(catalog: readonly PmErrorCodeContract[], observations: readonly PmRefusalProbeObservation[]): PmRefusalReachabilityReport;
169
+ export declare function verifyPmRefusalReachability(catalog:readonly PmErrorCodeContract[],observations:readonly PmRefusalProbeObservation[]):PmRefusalReachabilityReport;
170
170
  /** Verify executable and declared-path proof for emitted recovery references. */
171
- export declare function verifyPmRecoveryReferences(obligations: readonly PmRecoveryReferenceObligation[], observations: readonly PmRecoveryReferenceObservation[]): PmRecoveryReferenceReport;
171
+ export declare function verifyPmRecoveryReferences(obligations:readonly PmRecoveryReferenceObligation[],observations:readonly PmRecoveryReferenceObservation[]):PmRecoveryReferenceReport;
172
172
  /** Join source-census counts to distinct emitted runtime values by typed kind. */
173
- export declare function verifyPmRecoveryProducerRuntimeCoverage(census: PmRecoveryProducerCensusReport, obligations: readonly PmRecoveryReferenceObligation[]): PmRecoveryProducerRuntimeReport;
173
+ export declare function verifyPmRecoveryProducerRuntimeCoverage(census:PmRecoveryProducerCensusReport,obligations:readonly PmRecoveryReferenceObligation[]):PmRecoveryProducerRuntimeReport;
174
174
  /** Honest kind-level name for the compatibility implementation above. */
175
- export declare const verifyPmRecoveryKindRuntimeCoverage: typeof verifyPmRecoveryProducerRuntimeCoverage;
175
+ export declare const verifyPmRecoveryKindRuntimeCoverage:typeof verifyPmRecoveryProducerRuntimeCoverage;
@@ -1,40 +1,40 @@
1
- import { PmCliError, type PmCliErrorRecoveryPayload } from "../../core/shared/errors.js";
1
+ import { PmCliError,type PmCliErrorRecoveryPayload } from "../../core/shared/errors.js";
2
2
  /** Catalog-only alias retained for consumers of the former package lifecycle code. */
3
- export declare const UNKNOWN_SUBCOMMAND_COMPATIBILITY_CODES: readonly [{
4
- readonly code: "unknown_lifecycle_action";
3
+ export declare const UNKNOWN_SUBCOMMAND_COMPATIBILITY_CODES:readonly [{
4
+ readonly code:"unknown_lifecycle_action";
5
5
  }];
6
6
  /** Inputs for constructing a portable unknown-subcommand refusal. */
7
7
  export interface UnknownSubcommandErrorOptions {
8
8
  /** Command family path without the rejected token. */
9
- command_path: string;
9
+ command_path:string;
10
10
  /** Rejected positional token. */
11
- token: string;
11
+ token:string;
12
12
  /** Complete declared subcommand vocabulary for the family. */
13
- allowed: readonly string[];
13
+ allowed:readonly string[];
14
14
  /** Human-readable command family, defaulting to `pm <command_path>`. */
15
- display_name?: string;
15
+ display_name?:string;
16
16
  /** Positional token role used in the compatibility message. */
17
- token_kind?: "subcommand" | "action" | "path";
17
+ token_kind?:"subcommand" | "action" | "path";
18
18
  /** Arguments that follow the rejected token and should survive a retry. */
19
- trailing_args?: readonly string[];
19
+ trailing_args?:readonly string[];
20
20
  /** Family-aware retry that takes precedence over edit-distance recovery. */
21
- retry_command?: string;
21
+ retry_command?:string;
22
22
  /** Compatibility suffix appended after the allowed-value sentence. */
23
- message_suffix?: string;
23
+ message_suffix?:string;
24
24
  /** Additional ranked recovery candidates supplied by the command family. */
25
- fallback_candidates?: PmCliErrorRecoveryPayload["fallback_candidates"];
25
+ fallback_candidates?:PmCliErrorRecoveryPayload["fallback_candidates"];
26
26
  /** Transport exit used by non-CLI protocol adapters. */
27
- exit_code?: number;
27
+ exit_code?:number;
28
28
  /** Additional family-specific examples. */
29
- examples?: readonly string[];
29
+ examples?:readonly string[];
30
30
  }
31
- declare function nearestSubcommand(token: string, allowed: readonly string[]): string | undefined;
32
- declare function renderCommand(tokens: readonly string[]): string;
31
+ declare function nearestSubcommand(token:string,allowed:readonly string[]):string | undefined;
32
+ declare function renderCommand(tokens:readonly string[]):string;
33
33
  /** Build the shared typed refusal used by CLI, SDK, MCP, and packages. */
34
- export declare function createUnknownSubcommandError(options: UnknownSubcommandErrorOptions): PmCliError;
34
+ export declare function createUnknownSubcommandError(options:UnknownSubcommandErrorOptions):PmCliError;
35
35
  /** Test-only access to deterministic nearest-match behavior. */
36
- export declare const _testOnly: {
37
- nearestSubcommand: typeof nearestSubcommand;
38
- renderCommand: typeof renderCommand;
36
+ export declare const _testOnly:{
37
+ nearestSubcommand:typeof nearestSubcommand;
38
+ renderCommand:typeof renderCommand;
39
39
  };
40
40
  export {};