@unbrained/pm-cli 2026.10.14 → 2026.10.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (692) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +54 -2
  3. package/dist/cli/after-command-context-usage.d.ts +7 -7
  4. package/dist/cli/argv-utils.d.ts +4 -4
  5. package/dist/cli/bundle-integrity.d.ts +16 -16
  6. package/dist/cli/command-namespaces.d.ts +1 -1
  7. package/dist/cli/commander-usage.d.ts +34 -34
  8. package/dist/cli/commands/governance/validate.d.ts +1 -1
  9. package/dist/cli/commands/history/history-compact.d.ts +1 -1
  10. package/dist/cli/commands/history/history-redact.d.ts +1 -1
  11. package/dist/cli/commands/history/history-repair.d.ts +1 -1
  12. package/dist/cli/commands/history/restore.d.ts +1 -1
  13. package/dist/cli/commands/lifecycle/close.d.ts +1 -1
  14. package/dist/cli/commands/lifecycle/copy.d.ts +1 -1
  15. package/dist/cli/commands/lifecycle/delete.d.ts +1 -1
  16. package/dist/cli/commands/lifecycle/focus.d.ts +1 -1
  17. package/dist/cli/commands/query/get.d.ts +1 -1
  18. package/dist/cli/commands/workspace/merge.d.ts +1 -1
  19. package/dist/cli/commands/workspace/schema.d.ts +1 -1
  20. package/dist/cli/context-intent-invocation.d.ts +1 -1
  21. package/dist/cli/description-stdin.d.ts +1 -1
  22. package/dist/cli/error-guidance.d.ts +119 -119
  23. package/dist/cli/extension-command-help.d.ts +64 -64
  24. package/dist/cli/extension-command-help.js +2 -2
  25. package/dist/cli/extension-command-options.d.ts +16 -16
  26. package/dist/cli/extension-recovery.d.ts +13 -13
  27. package/dist/cli/help-content.d.ts +22 -22
  28. package/dist/cli/help-content.js +2 -2
  29. package/dist/cli/help-json-payload.d.ts +45 -45
  30. package/dist/cli/invocation-profile.d.ts +5 -5
  31. package/dist/cli/main.d.ts +217 -217
  32. package/dist/cli/migration-gates.d.ts +24 -24
  33. package/dist/cli/option-values.d.ts +1 -1
  34. package/dist/cli/public.d.ts +1 -1
  35. package/dist/cli/register-annotations.d.ts +2 -2
  36. package/dist/cli/register-assurance.d.ts +1 -1
  37. package/dist/cli/register-files-lookup.d.ts +1 -1
  38. package/dist/cli/register-history-activity.d.ts +1 -1
  39. package/dist/cli/register-history-author.d.ts +1 -1
  40. package/dist/cli/register-history-maintenance.d.ts +1 -1
  41. package/dist/cli/register-list-query.d.ts +7 -7
  42. package/dist/cli/register-list-query.js +3 -3
  43. package/dist/cli/register-mutation-options.d.ts +1 -1
  44. package/dist/cli/register-mutation.d.ts +4 -4
  45. package/dist/cli/register-operations.d.ts +75 -75
  46. package/dist/cli/register-setup.d.ts +4 -4
  47. package/dist/cli/register-structured-mutation.d.ts +8 -8
  48. package/dist/cli/runtime/activation.d.ts +23 -23
  49. package/dist/cli/runtime/invocation-options.d.ts +12 -12
  50. package/dist/cli/runtime/projection-retry.d.ts +1 -1
  51. package/dist/cli/runtime/selection.d.ts +16 -16
  52. package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
  53. package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
  54. package/dist/cli/schema/registration.d.ts +1 -1
  55. package/dist/cli/schema-registration-helpers.d.ts +2 -2
  56. package/dist/cli/stats-analytics-json.d.ts +1 -1
  57. package/dist/cli-bundle/bundle-manifest.json +1 -1
  58. package/dist/cli-bundle/chunks/{chunk-5LU6PWA4.js → chunk-52EZH2QQ.js} +2 -2
  59. package/dist/cli-bundle/chunks/chunk-7OEGNA4X.js +20 -0
  60. package/dist/cli-bundle/chunks/{chunk-LKESCZEN.js → chunk-7VHINXZP.js} +2 -2
  61. package/dist/cli-bundle/chunks/chunk-EMEEHV2Y.js +2 -0
  62. package/dist/cli-bundle/chunks/chunk-JGKTOBVB.js +6 -0
  63. package/dist/cli-bundle/chunks/{chunk-PP3BVMFL.js → chunk-JSUJWIHQ.js} +30 -30
  64. package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-LNKLQYBG.js} +2 -2
  65. package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-N56CAQBU.js} +63 -64
  66. package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-NC3QVGDD.js} +2 -2
  67. package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-RJ5N44WY.js} +2 -2
  68. package/dist/cli-bundle/chunks/{chunk-LOSRTNNP.js → chunk-VIMQCFCK.js} +2 -2
  69. package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-WBBW3WQX.js} +4 -4
  70. package/dist/cli-bundle/chunks/chunk-X2H6UR26.js +236 -0
  71. package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-FKKFQ66D.js} +7 -7
  72. package/dist/cli-bundle/chunks/{register-mutation-TNRHNK4N.js → register-mutation-EWMMVZJB.js} +2 -2
  73. package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-GEQ2H7PS.js} +2 -2
  74. package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-PSJTQBBO.js} +2 -2
  75. package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-3RNUMVK4.js} +2 -2
  76. package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-4KQFMOM7.js} +6 -6
  77. package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-52I2SNKJ.js} +2 -2
  78. package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-5KRACGBK.js} +2 -2
  79. package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-5OO54BIV.js} +2 -2
  80. package/dist/cli-bundle/focused-chunks/{chunk-LKWDWER4.js → chunk-5TBAVZDR.js} +14 -14
  81. package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-FQKPOZKS.js} +2 -2
  82. package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-H3P77KVU.js} +2 -2
  83. package/dist/cli-bundle/focused-chunks/chunk-HTA3TNC3.js +26 -0
  84. package/dist/cli-bundle/focused-chunks/{chunk-23ACMPGB.js → chunk-JKBH7YGX.js} +2 -2
  85. package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-KIIFVULU.js} +2 -2
  86. package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-N6FUKTZS.js} +2 -2
  87. package/dist/cli-bundle/focused-chunks/chunk-PDYE7QDX.js +166 -0
  88. package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-Q4VNCTR2.js} +2 -2
  89. package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-THYQR3ON.js} +61 -62
  90. package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-TYLG5VEB.js} +2 -2
  91. package/dist/cli-bundle/main.js +26 -26
  92. package/dist/cli-bundle/sdk-authoring.js +1 -1
  93. package/dist/cli-bundle/sdk-contracts.js +2 -2
  94. package/dist/cli-bundle/sdk-core.js +22 -22
  95. package/dist/cli-bundle/sdk-governance.js +1 -1
  96. package/dist/cli-bundle/sdk-graph.js +1 -1
  97. package/dist/cli-bundle/sdk-merge.js +51 -51
  98. package/dist/cli-bundle/sdk-query.js +1 -1
  99. package/dist/cli-bundle/sdk-runtime.js +1 -1
  100. package/dist/cli-bundle/sdk-testing.js +1 -1
  101. package/dist/cli-bundle/sdk.js +7 -7
  102. package/dist/cli.d.ts +9 -9
  103. package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
  104. package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
  105. package/dist/core/config/nested-settings.d.ts +20 -20
  106. package/dist/core/config/positional-value.d.ts +9 -9
  107. package/dist/core/diagnostics/remediation.d.ts +7 -7
  108. package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
  109. package/dist/core/extensions/activation-summary.d.ts +30 -30
  110. package/dist/core/extensions/activation-transaction.d.ts +9 -9
  111. package/dist/core/extensions/capability-usage.d.ts +25 -25
  112. package/dist/core/extensions/command-hook-context.d.ts +15 -15
  113. package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
  114. package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
  115. package/dist/core/extensions/contribution-inventory.d.ts +24 -24
  116. package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
  117. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  118. package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
  119. package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
  120. package/dist/core/extensions/extension-policy.d.ts +62 -62
  121. package/dist/core/extensions/extension-registries.d.ts +8 -8
  122. package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
  123. package/dist/core/extensions/extension-types.d.ts +702 -702
  124. package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
  125. package/dist/core/extensions/flag-value-types.d.ts +16 -4
  126. package/dist/core/extensions/flag-value-types.js +1 -1
  127. package/dist/core/extensions/index.d.ts +34 -34
  128. package/dist/core/extensions/item-field-types.d.ts +3 -3
  129. package/dist/core/extensions/item-fields.d.ts +6 -6
  130. package/dist/core/extensions/loader.d.ts +66 -66
  131. package/dist/core/extensions/manifest-parser.d.ts +1 -1
  132. package/dist/core/extensions/manifest-schema.d.ts +13 -13
  133. package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
  134. package/dist/core/extensions/preflight-ownership.d.ts +3 -3
  135. package/dist/core/extensions/read-output-contract.d.ts +2 -2
  136. package/dist/core/extensions/registration-contracts.d.ts +12 -12
  137. package/dist/core/extensions/registration-validation.d.ts +6 -6
  138. package/dist/core/extensions/registration-values.d.ts +19 -19
  139. package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
  140. package/dist/core/extensions/runtime-registrations.d.ts +6 -6
  141. package/dist/core/extensions/service-ownership.d.ts +1 -1
  142. package/dist/core/extensions/version-compat.d.ts +9 -9
  143. package/dist/core/fs/atomic-create.d.ts +1 -1
  144. package/dist/core/fs/fs-utils.d.ts +12 -12
  145. package/dist/core/fs/host-environment-errors.d.ts +10 -10
  146. package/dist/core/fs/path-utils.d.ts +1 -1
  147. package/dist/core/governance/content-fields.d.ts +25 -25
  148. package/dist/core/governance/issue-codes.d.ts +16 -16
  149. package/dist/core/governance/metadata-coverage.d.ts +64 -64
  150. package/dist/core/history/digest.d.ts +5 -5
  151. package/dist/core/history/drift-cache.d.ts +2 -2
  152. package/dist/core/history/drift-scan.d.ts +18 -18
  153. package/dist/core/history/event-classification.d.ts +4 -4
  154. package/dist/core/history/event-index.d.ts +33 -33
  155. package/dist/core/history/history-compact-bulk.d.ts +12 -12
  156. package/dist/core/history/history-diff.d.ts +15 -15
  157. package/dist/core/history/history-rewrite.d.ts +43 -43
  158. package/dist/core/history/history-storage-stats.d.ts +20 -20
  159. package/dist/core/history/history-stream-policy.d.ts +12 -12
  160. package/dist/core/history/history.d.ts +45 -45
  161. package/dist/core/history/identity.d.ts +4 -4
  162. package/dist/core/history/operation-contract.d.ts +17 -17
  163. package/dist/core/history/projection.d.ts +16 -16
  164. package/dist/core/history/read.d.ts +4 -4
  165. package/dist/core/history/replay.d.ts +47 -47
  166. package/dist/core/history/tombstone.d.ts +1 -1
  167. package/dist/core/history/version-address.d.ts +2 -2
  168. package/dist/core/history/workspace-history.d.ts +72 -72
  169. package/dist/core/io/body-file.d.ts +2 -2
  170. package/dist/core/io/bulk-ids-input.d.ts +7 -7
  171. package/dist/core/item/actionability.d.ts +30 -30
  172. package/dist/core/item/dependency-reference.d.ts +2 -2
  173. package/dist/core/item/id.d.ts +9 -9
  174. package/dist/core/item/item-format-version.d.ts +17 -15
  175. package/dist/core/item/item-format-version.js +1 -1
  176. package/dist/core/item/item-format.d.ts +54 -54
  177. package/dist/core/item/item-record.d.ts +1 -1
  178. package/dist/core/item/item-type-definition.d.ts +11 -11
  179. package/dist/core/item/parent-reference-policy.d.ts +6 -6
  180. package/dist/core/item/parse.d.ts +37 -37
  181. package/dist/core/item/plan-lifecycle.d.ts +4 -4
  182. package/dist/core/item/priority.d.ts +3 -3
  183. package/dist/core/item/sprint-release-format.d.ts +4 -4
  184. package/dist/core/item/status-filter.d.ts +5 -5
  185. package/dist/core/item/status.d.ts +3 -3
  186. package/dist/core/item/toon-decode.d.ts +10 -10
  187. package/dist/core/item/type-registry.d.ts +35 -35
  188. package/dist/core/item/type-synonyms.d.ts +2 -2
  189. package/dist/core/lock/lock-gc.d.ts +28 -28
  190. package/dist/core/lock/lock.d.ts +53 -53
  191. package/dist/core/output/mutation-projection.d.ts +4 -4
  192. package/dist/core/output/output-control.d.ts +4 -4
  193. package/dist/core/output/output.d.ts +30 -30
  194. package/dist/core/output/query-summary.d.ts +5 -5
  195. package/dist/core/output/tabular.d.ts +3 -3
  196. package/dist/core/packages/manifest.d.ts +30 -30
  197. package/dist/core/packages/root.d.ts +4 -4
  198. package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
  199. package/dist/core/policy/workflow-policy-store.d.ts +15 -15
  200. package/dist/core/policy/workflow-policy.d.ts +56 -56
  201. package/dist/core/profile/profile-describe.d.ts +22 -22
  202. package/dist/core/profile/profile-lint.d.ts +13 -13
  203. package/dist/core/profile/profile-plan.d.ts +45 -45
  204. package/dist/core/profile/profile-presets.d.ts +36 -36
  205. package/dist/core/reproducibility/context.d.ts +9 -9
  206. package/dist/core/schema/fields-file.d.ts +35 -35
  207. package/dist/core/schema/item-types-file.d.ts +29 -29
  208. package/dist/core/schema/runtime-field-filters.d.ts +3 -3
  209. package/dist/core/schema/runtime-field-values.d.ts +7 -7
  210. package/dist/core/schema/runtime-schema.d.ts +59 -59
  211. package/dist/core/schema/status-defs-file.d.ts +29 -29
  212. package/dist/core/schema/status-token.d.ts +1 -1
  213. package/dist/core/schema/type-inference.d.ts +10 -10
  214. package/dist/core/schema/type-presets.d.ts +5 -5
  215. package/dist/core/schema/type-workflows.d.ts +14 -14
  216. package/dist/core/search/background-refresh.d.ts +12 -12
  217. package/dist/core/search/bm25.d.ts +16 -16
  218. package/dist/core/search/cache.d.ts +34 -34
  219. package/dist/core/search/corpus.d.ts +17 -17
  220. package/dist/core/search/embedding-batches.d.ts +25 -25
  221. package/dist/core/search/eval-thresholds.d.ts +4 -4
  222. package/dist/core/search/eval.d.ts +40 -40
  223. package/dist/core/search/http-client.d.ts +24 -24
  224. package/dist/core/search/providers.d.ts +30 -30
  225. package/dist/core/search/relevance.d.ts +17 -17
  226. package/dist/core/search/semantic-defaults.d.ts +5 -5
  227. package/dist/core/search/staleness.d.ts +3 -3
  228. package/dist/core/search/vector-stores.d.ts +51 -51
  229. package/dist/core/search/vectorization-metadata.d.ts +9 -9
  230. package/dist/core/sentry/helpers.d.ts +27 -27
  231. package/dist/core/sentry/instrument.d.ts +51 -51
  232. package/dist/core/sentry/instrument.js +1 -1
  233. package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
  234. package/dist/core/sentry/sensitive-assignments.js +2 -0
  235. package/dist/core/session/session-state.d.ts +37 -37
  236. package/dist/core/shared/agent-session-context.d.ts +14 -14
  237. package/dist/core/shared/author.d.ts +89 -89
  238. package/dist/core/shared/command-line.d.ts +3 -3
  239. package/dist/core/shared/command-types.d.ts +20 -20
  240. package/dist/core/shared/conflict-markers.d.ts +5 -5
  241. package/dist/core/shared/constants.d.ts +30 -30
  242. package/dist/core/shared/errors.d.ts +100 -100
  243. package/dist/core/shared/html-entity-decode.d.ts +2 -2
  244. package/dist/core/shared/item-metadata-contract.d.ts +2 -2
  245. package/dist/core/shared/lazy-module.d.ts +1 -1
  246. package/dist/core/shared/levenshtein.d.ts +1 -1
  247. package/dist/core/shared/memo.d.ts +1 -1
  248. package/dist/core/shared/numeric-parsers.d.ts +1 -1
  249. package/dist/core/shared/option-alias-visibility.d.ts +3 -3
  250. package/dist/core/shared/primitives.d.ts +13 -13
  251. package/dist/core/shared/secret-rules.d.ts +92 -92
  252. package/dist/core/shared/serial-queue.d.ts +6 -6
  253. package/dist/core/shared/serialization.d.ts +4 -4
  254. package/dist/core/shared/split-comma-list.d.ts +4 -4
  255. package/dist/core/shared/text-normalization.d.ts +3 -3
  256. package/dist/core/shared/time.d.ts +27 -27
  257. package/dist/core/store/item-format-migration.d.ts +7 -7
  258. package/dist/core/store/item-metadata-cache.d.ts +30 -30
  259. package/dist/core/store/item-metadata-query-index.d.ts +66 -66
  260. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  261. package/dist/core/store/item-store.d.ts +123 -123
  262. package/dist/core/store/item-store.js +1 -1
  263. package/dist/core/store/paths.d.ts +27 -27
  264. package/dist/core/store/settings-concurrency.d.ts +1 -1
  265. package/dist/core/store/settings-read-cache.d.ts +11 -11
  266. package/dist/core/store/settings-validator.d.ts +117 -117
  267. package/dist/core/store/settings.d.ts +84 -84
  268. package/dist/core/store/sqlite-runtime.d.ts +2 -2
  269. package/dist/core/store/tracker-preflight.d.ts +3 -3
  270. package/dist/core/telemetry/consent.d.ts +1 -1
  271. package/dist/core/telemetry/observability.d.ts +16 -16
  272. package/dist/core/telemetry/policy.d.ts +7 -7
  273. package/dist/core/telemetry/read-sampling.d.ts +1 -1
  274. package/dist/core/telemetry/runtime.d.ts +275 -275
  275. package/dist/core/test/background-runs.d.ts +123 -123
  276. package/dist/core/test/item-test-run-tracking.d.ts +10 -10
  277. package/dist/core/test/run-selectors.d.ts +12 -12
  278. package/dist/core/validate/estimate-defaults.d.ts +3 -3
  279. package/dist/core/validate/fix-planning.d.ts +36 -36
  280. package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
  281. package/dist/core/validate/missing-by-type.d.ts +3 -3
  282. package/dist/core/validate/missing-link-owners.d.ts +17 -17
  283. package/dist/core/validate/stale-file-classification.d.ts +6 -6
  284. package/dist/mcp/http-server.d.ts +26 -26
  285. package/dist/mcp/legacy-adapter.d.ts +18 -18
  286. package/dist/mcp/runtime-capabilities.d.ts +18 -18
  287. package/dist/mcp/server.d.ts +73 -73
  288. package/dist/mcp/tool-definitions.d.ts +27 -27
  289. package/dist/sdk/actionability.d.ts +1 -1
  290. package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
  291. package/dist/sdk/agent/command-recovery.d.ts +5 -5
  292. package/dist/sdk/agent/command-suggestions.d.ts +4 -4
  293. package/dist/sdk/agent/create-option-policy.d.ts +2 -2
  294. package/dist/sdk/agent/identity-config.d.ts +18 -18
  295. package/dist/sdk/agent/item-addressing.d.ts +6 -6
  296. package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
  297. package/dist/sdk/agent/refusal-closure.d.ts +22 -22
  298. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
  299. package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
  300. package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
  301. package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
  302. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
  303. package/dist/sdk/agent-capability-contracts.d.ts +41 -41
  304. package/dist/sdk/agent-session-context.d.ts +1 -1
  305. package/dist/sdk/annotations.d.ts +74 -74
  306. package/dist/sdk/author-attribution.d.ts +47 -47
  307. package/dist/sdk/authoring.d.ts +9 -9
  308. package/dist/sdk/cli-bootstrap.d.ts +65 -65
  309. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
  310. package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
  311. package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
  312. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
  313. package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
  314. package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
  315. package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
  316. package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
  317. package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
  318. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  319. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
  320. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
  321. package/dist/sdk/cli-contracts/registration-helpers.d.ts +56 -56
  322. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
  323. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  324. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
  325. package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
  326. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
  327. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
  328. package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
  329. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
  330. package/dist/sdk/cli-contracts.d.ts +15 -15
  331. package/dist/sdk/cli-program.d.ts +1 -1
  332. package/dist/sdk/cli-program.js +1 -1
  333. package/dist/sdk/command-line.d.ts +3 -3
  334. package/dist/sdk/comments.d.ts +24 -24
  335. package/dist/sdk/compile-cache.d.ts +4 -4
  336. package/dist/sdk/completion/bash.d.ts +1 -1
  337. package/dist/sdk/completion/fish.d.ts +1 -1
  338. package/dist/sdk/completion/shared.d.ts +74 -74
  339. package/dist/sdk/completion/zsh.d.ts +1 -1
  340. package/dist/sdk/completion.d.ts +3 -3
  341. package/dist/sdk/compose.d.ts +94 -94
  342. package/dist/sdk/config.d.ts +105 -105
  343. package/dist/sdk/context/recency.d.ts +1 -1
  344. package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
  345. package/dist/sdk/context/usage-egress.d.ts +1 -1
  346. package/dist/sdk/context/usage-ledger.d.ts +18 -18
  347. package/dist/sdk/context-intent-contracts.d.ts +37 -37
  348. package/dist/sdk/context-intent-runtime.d.ts +10 -10
  349. package/dist/sdk/context-packing.d.ts +44 -44
  350. package/dist/sdk/context-relevance.d.ts +110 -110
  351. package/dist/sdk/context-signal-store.d.ts +52 -52
  352. package/dist/sdk/context-usage.d.ts +78 -78
  353. package/dist/sdk/contracts.d.ts +2 -1
  354. package/dist/sdk/contracts.js +1 -1
  355. package/dist/sdk/core-governance.d.ts +5 -5
  356. package/dist/sdk/core.d.ts +8 -8
  357. package/dist/sdk/corpus-shape.d.ts +60 -60
  358. package/dist/sdk/define.d.ts +36 -36
  359. package/dist/sdk/dependencies.d.ts +70 -70
  360. package/dist/sdk/dependency-flag-validation.d.ts +17 -17
  361. package/dist/sdk/dependency-provenance.d.ts +22 -22
  362. package/dist/sdk/docs.d.ts +17 -17
  363. package/dist/sdk/duplicates.d.ts +14 -14
  364. package/dist/sdk/environment/agent-environment.d.ts +118 -118
  365. package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
  366. package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
  367. package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
  368. package/dist/sdk/environment/source-context.d.ts +4 -4
  369. package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
  370. package/dist/sdk/error-code-catalog.d.ts +33 -33
  371. package/dist/sdk/error-runtime.d.ts +5 -5
  372. package/dist/sdk/errors.d.ts +17 -17
  373. package/dist/sdk/eval.d.ts +27 -27
  374. package/dist/sdk/extension/author-manifest.d.ts +9 -9
  375. package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
  376. package/dist/sdk/extension/concurrency.d.ts +1 -1
  377. package/dist/sdk/extension/copy-scope.d.ts +1 -1
  378. package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
  379. package/dist/sdk/extension/describe.d.ts +21 -21
  380. package/dist/sdk/extension/doctor.d.ts +46 -46
  381. package/dist/sdk/extension/install-plan.d.ts +32 -32
  382. package/dist/sdk/extension/install-receipts.d.ts +4 -4
  383. package/dist/sdk/extension/install-runtime.d.ts +12 -12
  384. package/dist/sdk/extension/install-snapshot.d.ts +10 -10
  385. package/dist/sdk/extension/install-sources.d.ts +106 -106
  386. package/dist/sdk/extension/managed-state.d.ts +42 -42
  387. package/dist/sdk/extension/managed-update-status.d.ts +1 -1
  388. package/dist/sdk/extension/migrations.d.ts +48 -48
  389. package/dist/sdk/extension/output-ownership.d.ts +19 -19
  390. package/dist/sdk/extension/runtime-summary.d.ts +7 -7
  391. package/dist/sdk/extension/scaffold.d.ts +15 -15
  392. package/dist/sdk/extension/shared.d.ts +16 -16
  393. package/dist/sdk/extension/source-resolution.d.ts +16 -16
  394. package/dist/sdk/extension/static-inventory.d.ts +23 -23
  395. package/dist/sdk/extension/update-check.d.ts +9 -9
  396. package/dist/sdk/extension-command-context.d.ts +1 -1
  397. package/dist/sdk/extension-contracts.d.ts +10 -10
  398. package/dist/sdk/extension.d.ts +221 -221
  399. package/dist/sdk/files.d.ts +101 -101
  400. package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
  401. package/dist/sdk/flag-invocation-contracts.js +1 -1
  402. package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
  403. package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
  404. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  405. package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
  406. package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
  407. package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
  408. package/dist/sdk/governance/assurance-action.d.ts +46 -46
  409. package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
  410. package/dist/sdk/governance/assurance-presets.d.ts +25 -25
  411. package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
  412. package/dist/sdk/governance/assurance.d.ts +204 -204
  413. package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
  414. package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
  415. package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
  416. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
  417. package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
  418. package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
  419. package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
  420. package/dist/sdk/governance/extension-host-version.d.ts +9 -9
  421. package/dist/sdk/governance/gc.d.ts +26 -26
  422. package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
  423. package/dist/sdk/governance/health.d.ts +172 -172
  424. package/dist/sdk/governance/health.js +1 -1
  425. package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
  426. package/dist/sdk/governance/linked-file-report.d.ts +15 -15
  427. package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
  428. package/dist/sdk/governance/provenance-health.d.ts +35 -35
  429. package/dist/sdk/governance/reindex.d.ts +102 -102
  430. package/dist/sdk/governance/reliability.d.ts +29 -29
  431. package/dist/sdk/governance/stale-work.d.ts +13 -13
  432. package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
  433. package/dist/sdk/governance/storage-integrity.d.ts +28 -28
  434. package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
  435. package/dist/sdk/governance/upgrade.d.ts +77 -77
  436. package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
  437. package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
  438. package/dist/sdk/governance/validate-normalization.d.ts +4 -4
  439. package/dist/sdk/governance/validate.d.ts +176 -176
  440. package/dist/sdk/governance/validate.js +1 -1
  441. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  442. package/dist/sdk/governance/workflow-policy.d.ts +18 -18
  443. package/dist/sdk/governance/workspace-position.d.ts +40 -40
  444. package/dist/sdk/governance.d.ts +2 -2
  445. package/dist/sdk/graph/adapter.d.ts +45 -45
  446. package/dist/sdk/graph/analytics.d.ts +36 -36
  447. package/dist/sdk/graph/assembly.d.ts +51 -51
  448. package/dist/sdk/graph/cache.d.ts +19 -19
  449. package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
  450. package/dist/sdk/graph/centrality.d.ts +20 -20
  451. package/dist/sdk/graph/conformance.d.ts +21 -21
  452. package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
  453. package/dist/sdk/graph/durable-cache.d.ts +22 -22
  454. package/dist/sdk/graph/governance-contracts.d.ts +1 -1
  455. package/dist/sdk/graph/governance.d.ts +92 -92
  456. package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
  457. package/dist/sdk/graph/index.d.ts +15 -15
  458. package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
  459. package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
  460. package/dist/sdk/graph/query-contracts.d.ts +6 -6
  461. package/dist/sdk/graph/remediation.d.ts +15 -15
  462. package/dist/sdk/graph/run.d.ts +203 -203
  463. package/dist/sdk/graph/scheduling.d.ts +21 -21
  464. package/dist/sdk/graph/traversal.d.ts +18 -18
  465. package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
  466. package/dist/sdk/guide-topics.d.ts +19 -19
  467. package/dist/sdk/guide.d.ts +43 -43
  468. package/dist/sdk/history/attestation-command.d.ts +8 -8
  469. package/dist/sdk/history/attestation-contract.d.ts +43 -43
  470. package/dist/sdk/history/attestation-scan.d.ts +4 -4
  471. package/dist/sdk/history/attestation.d.ts +4 -4
  472. package/dist/sdk/history/maintenance.d.ts +25 -25
  473. package/dist/sdk/history/salvage.d.ts +19 -19
  474. package/dist/sdk/history/subject.d.ts +8 -8
  475. package/dist/sdk/history-analytics.d.ts +64 -64
  476. package/dist/sdk/history-compact.d.ts +67 -67
  477. package/dist/sdk/history-mcp.d.ts +7 -7
  478. package/dist/sdk/history-provenance.d.ts +40 -40
  479. package/dist/sdk/history-read.d.ts +24 -24
  480. package/dist/sdk/history-redact.d.ts +68 -68
  481. package/dist/sdk/history-repair.d.ts +92 -92
  482. package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
  483. package/dist/sdk/improvement-ledger.d.ts +62 -62
  484. package/dist/sdk/index.d.ts +69 -69
  485. package/dist/sdk/init-agent-guidance.d.ts +68 -68
  486. package/dist/sdk/init.d.ts +117 -117
  487. package/dist/sdk/invocation-author.d.ts +1 -1
  488. package/dist/sdk/item-children.d.ts +15 -15
  489. package/dist/sdk/item-metadata-index.d.ts +2 -2
  490. package/dist/sdk/item-schedule.d.ts +9 -9
  491. package/dist/sdk/item-transaction.d.ts +73 -73
  492. package/dist/sdk/learnings.d.ts +23 -23
  493. package/dist/sdk/lifecycle/append.d.ts +8 -8
  494. package/dist/sdk/lifecycle/claim.d.ts +38 -38
  495. package/dist/sdk/lifecycle/close-many.d.ts +71 -71
  496. package/dist/sdk/lifecycle/close.d.ts +18 -18
  497. package/dist/sdk/lifecycle/copy.d.ts +10 -10
  498. package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
  499. package/dist/sdk/lifecycle/create.d.ts +88 -88
  500. package/dist/sdk/lifecycle/delete.d.ts +15 -15
  501. package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
  502. package/dist/sdk/lifecycle/focus.d.ts +6 -6
  503. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
  504. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
  505. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
  506. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  507. package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
  508. package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
  509. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
  510. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
  511. package/dist/sdk/lifecycle/plan.d.ts +127 -127
  512. package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
  513. package/dist/sdk/lifecycle/reopen.d.ts +15 -15
  514. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
  515. package/dist/sdk/lifecycle/restore.d.ts +34 -34
  516. package/dist/sdk/lifecycle/restore.js +1 -1
  517. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
  518. package/dist/sdk/lifecycle/task-composition.d.ts +7 -7
  519. package/dist/sdk/lifecycle/update-many.d.ts +61 -61
  520. package/dist/sdk/lifecycle/update.d.ts +120 -120
  521. package/dist/sdk/lifecycle-completion.d.ts +14 -14
  522. package/dist/sdk/lifecycle-policy.d.ts +31 -31
  523. package/dist/sdk/linked-artifacts.d.ts +58 -58
  524. package/dist/sdk/mcp/apps.d.ts +28 -28
  525. package/dist/sdk/mcp/authorization.d.ts +66 -66
  526. package/dist/sdk/mcp/discovery.d.ts +67 -67
  527. package/dist/sdk/mcp/interactions.d.ts +49 -49
  528. package/dist/sdk/mcp/protocol.d.ts +63 -63
  529. package/dist/sdk/mcp/skills.d.ts +62 -62
  530. package/dist/sdk/mcp/subscriptions.d.ts +26 -26
  531. package/dist/sdk/mcp/tasks.d.ts +51 -51
  532. package/dist/sdk/mcp/transport.d.ts +17 -17
  533. package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
  534. package/dist/sdk/merge/driver.d.ts +38 -38
  535. package/dist/sdk/merge/index.d.ts +5 -5
  536. package/dist/sdk/merge/install.d.ts +48 -48
  537. package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
  538. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  539. package/dist/sdk/merge/receipt-schema.d.ts +11 -11
  540. package/dist/sdk/merge/receipts.d.ts +111 -111
  541. package/dist/sdk/merge/reconcile.d.ts +20 -20
  542. package/dist/sdk/merge/three-way.d.ts +50 -50
  543. package/dist/sdk/merge/three-way.js +2 -2
  544. package/dist/sdk/merge/worktree-config.d.ts +3 -3
  545. package/dist/sdk/mutation-events.d.ts +62 -62
  546. package/dist/sdk/mutation-guard.d.ts +134 -134
  547. package/dist/sdk/notes.d.ts +28 -28
  548. package/dist/sdk/output/table-rows.d.ts +6 -6
  549. package/dist/sdk/output-contracts.d.ts +26 -26
  550. package/dist/sdk/output-projection.d.ts +108 -108
  551. package/dist/sdk/output-token-accounting.d.ts +18 -18
  552. package/dist/sdk/output.d.ts +18 -18
  553. package/dist/sdk/ownership-source.d.ts +1 -1
  554. package/dist/sdk/package-import-adapters.d.ts +51 -51
  555. package/dist/sdk/package-migrations.d.ts +3 -3
  556. package/dist/sdk/package-runtime-options.d.ts +3 -3
  557. package/dist/sdk/pagination.d.ts +28 -28
  558. package/dist/sdk/pagination.js +1 -1
  559. package/dist/sdk/profile.d.ts +72 -72
  560. package/dist/sdk/provenance.d.ts +37 -37
  561. package/dist/sdk/public-surface.json +1 -1
  562. package/dist/sdk/query/activity.d.ts +84 -84
  563. package/dist/sdk/query/aggregate.d.ts +109 -109
  564. package/dist/sdk/query/calendar.d.ts +95 -95
  565. package/dist/sdk/query/complete-list.d.ts +35 -35
  566. package/dist/sdk/query/context.d.ts +300 -300
  567. package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
  568. package/dist/sdk/query/get.d.ts +54 -54
  569. package/dist/sdk/query/history.d.ts +38 -38
  570. package/dist/sdk/query/item-filter-options.d.ts +41 -41
  571. package/dist/sdk/query/light-metadata.d.ts +1 -1
  572. package/dist/sdk/query/list-filter-shared.d.ts +4 -4
  573. package/dist/sdk/query/list.d.ts +167 -167
  574. package/dist/sdk/query/list.js +1 -1
  575. package/dist/sdk/query/multi-value-filters.d.ts +6 -6
  576. package/dist/sdk/query/next-ready-budget.d.ts +8 -8
  577. package/dist/sdk/query/next.d.ts +94 -94
  578. package/dist/sdk/query/parsers.d.ts +3 -3
  579. package/dist/sdk/query/projection-contracts.d.ts +18 -18
  580. package/dist/sdk/query/search/corpus.d.ts +15 -15
  581. package/dist/sdk/query/search/filters.d.ts +15 -15
  582. package/dist/sdk/query/search/input.d.ts +8 -8
  583. package/dist/sdk/query/search/lexical.d.ts +10 -10
  584. package/dist/sdk/query/search/response.d.ts +22 -22
  585. package/dist/sdk/query/search/semantic.d.ts +133 -133
  586. package/dist/sdk/query/search/types.d.ts +65 -65
  587. package/dist/sdk/query/search-contracts.d.ts +53 -53
  588. package/dist/sdk/query/search-pagination.d.ts +21 -21
  589. package/dist/sdk/query/search-rendering.d.ts +30 -30
  590. package/dist/sdk/query/search.d.ts +60 -60
  591. package/dist/sdk/query/workspace-contracts.d.ts +2 -2
  592. package/dist/sdk/query.d.ts +6 -6
  593. package/dist/sdk/read-output/continuation.d.ts +11 -11
  594. package/dist/sdk/read-output/extension.d.ts +3 -3
  595. package/dist/sdk/read-output/options.d.ts +7 -7
  596. package/dist/sdk/read-output/provenance.d.ts +6 -6
  597. package/dist/sdk/read-output-budget.d.ts +11 -11
  598. package/dist/sdk/read-output-contracts.d.ts +112 -112
  599. package/dist/sdk/read-output-contracts.js +1 -1
  600. package/dist/sdk/read-output-rows.d.ts +15 -15
  601. package/dist/sdk/read-output-session.d.ts +29 -29
  602. package/dist/sdk/relationship-analytics.d.ts +46 -46
  603. package/dist/sdk/relationship-context.d.ts +48 -48
  604. package/dist/sdk/relationship-history.d.ts +59 -59
  605. package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
  606. package/dist/sdk/relationship-migration.d.ts +14 -14
  607. package/dist/sdk/relationships.d.ts +46 -46
  608. package/dist/sdk/reproducibility/process.d.ts +9 -9
  609. package/dist/sdk/runtime/actions.d.ts +1 -1
  610. package/dist/sdk/runtime/context.d.ts +15 -15
  611. package/dist/sdk/runtime/schema-preview.d.ts +1 -1
  612. package/dist/sdk/runtime/schema.d.ts +1 -1
  613. package/dist/sdk/runtime-action-aliases.d.ts +3 -3
  614. package/dist/sdk/runtime-extended-actions.d.ts +9 -9
  615. package/dist/sdk/runtime-input.d.ts +29 -29
  616. package/dist/sdk/runtime-primitives.d.ts +53 -53
  617. package/dist/sdk/runtime-primitives.js +1 -1
  618. package/dist/sdk/runtime-public-contracts.d.ts +46 -46
  619. package/dist/sdk/runtime-stats-options.d.ts +1 -1
  620. package/dist/sdk/runtime.d.ts +374 -374
  621. package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
  622. package/dist/sdk/schema-migration.d.ts +79 -79
  623. package/dist/sdk/schema.d.ts +224 -224
  624. package/dist/sdk/search-refresh-worker.d.ts +1 -1
  625. package/dist/sdk/similarity-scoring.d.ts +10 -10
  626. package/dist/sdk/similarity.d.ts +73 -73
  627. package/dist/sdk/start-task-status.d.ts +1 -1
  628. package/dist/sdk/stats.d.ts +72 -72
  629. package/dist/sdk/structured-mutations.d.ts +13 -13
  630. package/dist/sdk/telemetry-flush.d.ts +1 -1
  631. package/dist/sdk/telemetry.d.ts +32 -32
  632. package/dist/sdk/templates.d.ts +35 -35
  633. package/dist/sdk/test/batch.d.ts +50 -50
  634. package/dist/sdk/test/command-args.d.ts +2 -2
  635. package/dist/sdk/test/entry.d.ts +4 -4
  636. package/dist/sdk/test/execution-receipts.d.ts +5 -5
  637. package/dist/sdk/test/execution.d.ts +247 -247
  638. package/dist/sdk/test/json-path.d.ts +4 -4
  639. package/dist/sdk/test/linked-command-detection.d.ts +36 -36
  640. package/dist/sdk/test/measurements.d.ts +10 -10
  641. package/dist/sdk/test/parsers.d.ts +18 -18
  642. package/dist/sdk/test/prerequisites.d.ts +3 -3
  643. package/dist/sdk/test/runs.d.ts +43 -43
  644. package/dist/sdk/test/trust.d.ts +15 -15
  645. package/dist/sdk/test/update.d.ts +23 -23
  646. package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
  647. package/dist/sdk/testing.d.ts +248 -248
  648. package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
  649. package/dist/sdk/traceability/source-traceability.d.ts +50 -50
  650. package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
  651. package/dist/sdk/workspace-contracts.d.ts +20 -20
  652. package/dist/sdk/workspace-memory.d.ts +42 -42
  653. package/dist/sdk/workspace-recipe.d.ts +9 -9
  654. package/dist/sdk/workspace-snapshot.d.ts +60 -60
  655. package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
  656. package/dist/sdk/workspace-transaction.d.ts +26 -26
  657. package/dist/sdk/workspace.d.ts +9 -9
  658. package/dist/types.d.ts +540 -540
  659. package/docs/COMMANDS.md +11 -2
  660. package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
  661. package/docs/LINKED_TEST_EDITS.md +15 -0
  662. package/docs/RELEASING.md +2 -0
  663. package/docs/TESTING.md +21 -1
  664. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +4 -3
  665. package/marketplace.json +1 -1
  666. package/package.json +3 -1
  667. package/packages/pm-beads/package.json +1 -1
  668. package/packages/pm-calendar/package.json +1 -1
  669. package/packages/pm-command-kit/package.json +1 -1
  670. package/packages/pm-digital-twin/package.json +1 -1
  671. package/packages/pm-governance-audit/package.json +1 -1
  672. package/packages/pm-guide-shell/package.json +1 -1
  673. package/packages/pm-kanban/package.json +1 -1
  674. package/packages/pm-lifecycle-hooks/package.json +1 -1
  675. package/packages/pm-linked-test-adapters/package.json +1 -1
  676. package/packages/pm-search-advanced/package.json +1 -1
  677. package/packages/pm-templates/package.json +1 -1
  678. package/packages/pm-todos/package.json +1 -1
  679. package/packages/pm-vcs/package.json +1 -1
  680. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  681. package/plugins/pm-claude/package.json +1 -1
  682. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  683. package/plugins/pm-codex/package.json +1 -1
  684. package/plugins/pm-codex/plugin.json +1 -1
  685. package/runtime-dependencies.json +1 -1
  686. package/scripts/finalize-build.mjs +9 -3
  687. package/dist/cli-bundle/chunks/chunk-66BZVFIK.js +0 -6
  688. package/dist/cli-bundle/chunks/chunk-IDEHMKYZ.js +0 -235
  689. package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
  690. package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
  691. package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
  692. package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
@@ -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 {};
@@ -1,8 +1,8 @@
1
1
  import { type PmOutputEnvelopeKind } from "../output-contracts.js";
2
2
  /** Stable schema version for replayable agent-task transcript corpora. */
3
- export declare const PM_AGENT_TASK_TRANSCRIPT_VERSION: 2;
3
+ export declare const PM_AGENT_TASK_TRANSCRIPT_VERSION:2;
4
4
  /** Supported strategies for measuring one transcript step's output cost. */
5
- export declare const PM_AGENT_TASK_ACCOUNTING_MODES: readonly ["self_reported", "independent_transport"];
5
+ export declare const PM_AGENT_TASK_ACCOUNTING_MODES:readonly ["self_reported","independent_transport"];
6
6
  /** Token-accounting strategy a replayed transcript step must preserve. */
7
7
  export type PmAgentTaskAccountingMode = (typeof PM_AGENT_TASK_ACCOUNTING_MODES)[number];
8
8
  /** Scalar value that a replayed transcript must observe at one output path. */
@@ -12,41 +12,41 @@ export type PmAgentTaskStepOutputKind = PmOutputEnvelopeKind | "refusal";
12
12
  /** Declares one real CLI invocation within a replayable agent task. */
13
13
  export interface PmAgentTaskTranscriptStep {
14
14
  /** Stable step identifier unique within its task. */
15
- id: string;
15
+ id:string;
16
16
  /** Shell-free CLI arguments, excluding the pm executable, preserved exactly. */
17
- args: readonly string[];
17
+ args:readonly string[];
18
18
  /** Process status required for the step to satisfy the transcript. */
19
- expected_exit_code: number;
19
+ expected_exit_code:number;
20
20
  /** Semantic output family required from the transport. */
21
- expected_output_kind: PmAgentTaskStepOutputKind;
21
+ expected_output_kind:PmAgentTaskStepOutputKind;
22
22
  /** Accounting strategy required from the measured transport. */
23
- expected_accounting_mode: PmAgentTaskAccountingMode;
23
+ expected_accounting_mode:PmAgentTaskAccountingMode;
24
24
  /** Dot-separated own-property paths proving required context was consumed. */
25
- required_fields: readonly string[];
25
+ required_fields:readonly string[];
26
26
  /** Exact terminal scalar values required at selected output paths. */
27
- expected_field_values?: Readonly<Record<string, PmAgentTaskExpectedFieldValue>>;
27
+ expected_field_values?:Readonly<Record<string,PmAgentTaskExpectedFieldValue>>;
28
28
  /** Stable diagnostic code required from a refusal step. */
29
- expected_error_code?: string;
29
+ expected_error_code?:string;
30
30
  /** Exact command or flag required in a refusal identity. */
31
- expected_refusal_surface?: string;
31
+ expected_refusal_surface?:string;
32
32
  /** Earlier refusal step whose recovery this successful step executes. */
33
- recovery_for?: string;
33
+ recovery_for?:string;
34
34
  }
35
35
  /** Versioned multi-step agent workflow suitable for deterministic replay. */
36
36
  export interface PmAgentTaskTranscript {
37
37
  /** Stable task identifier used by baselines and reports. */
38
- id: string;
38
+ id:string;
39
39
  /** Human-readable task outcome represented by the transcript. */
40
- description: string;
40
+ description:string;
41
41
  /** Ordered invocations whose shared workspace state completes the task. */
42
- steps: readonly PmAgentTaskTranscriptStep[];
42
+ steps:readonly PmAgentTaskTranscriptStep[];
43
43
  }
44
44
  /** Published collection of replayable agent workflows. */
45
45
  export interface PmAgentTaskTranscriptCorpus {
46
46
  /** Schema version governing every transcript in the corpus. */
47
- version: typeof PM_AGENT_TASK_TRANSCRIPT_VERSION;
47
+ version:typeof PM_AGENT_TASK_TRANSCRIPT_VERSION;
48
48
  /** Complete ordered task set evaluated by the release gate. */
49
- tasks: readonly PmAgentTaskTranscript[];
49
+ tasks:readonly PmAgentTaskTranscript[];
50
50
  }
51
51
  /** Parse and fail closed on malformed or internally inconsistent transcripts. */
52
- export declare function parsePmAgentTaskTranscriptCorpus(value: unknown): PmAgentTaskTranscriptCorpus;
52
+ export declare function parsePmAgentTaskTranscriptCorpus(value:unknown):PmAgentTaskTranscriptCorpus;
@@ -10,54 +10,54 @@ export type PmTrackerPreflightRecoveryKind = "initialize" | "select_directory" |
10
10
  /** Static refusal and recovery obligation for one tracker filesystem state. */
11
11
  export interface PmTrackerPreflightRecoveryContract {
12
12
  /** Stable probe identifier used by repository gates and evidence. */
13
- probe_id: string;
13
+ probe_id:string;
14
14
  /** Filesystem state created by the executable probe. */
15
- failure_kind: PmTrackerPreflightFailureKind;
15
+ failure_kind:PmTrackerPreflightFailureKind;
16
16
  /** Stable structured error code required from CLI and SDK transports. */
17
- expected_error_code: string;
17
+ expected_error_code:string;
18
18
  /** Process exit code required from the CLI transport. */
19
- expected_exit_code: 1 | 2 | 3;
19
+ expected_exit_code:1 | 2 | 3;
20
20
  /** Safe recovery behavior for this filesystem state. */
21
- recovery_kind: PmTrackerPreflightRecoveryKind;
21
+ recovery_kind:PmTrackerPreflightRecoveryKind;
22
22
  }
23
23
  /** Runtime evidence captured from one executable tracker preflight probe. */
24
24
  export interface PmTrackerPreflightRecoveryObservation {
25
25
  /** Stable probe identifier from the corresponding contract. */
26
- probe_id: string;
26
+ probe_id:string;
27
27
  /** Structured error code emitted by the refusal. */
28
- error_code: string;
28
+ error_code:string;
29
29
  /** Process exit code emitted by the refusal. */
30
- exit_code: number;
30
+ exit_code:number;
31
31
  /** Recovery behavior exercised by the probe driver. */
32
- recovery_kind: PmTrackerPreflightRecoveryKind;
32
+ recovery_kind:PmTrackerPreflightRecoveryKind;
33
33
  /** Tokenized retry emitted by the refusal, or an empty list when no deterministic retry is safe. */
34
- suggested_retry_args: string[];
34
+ suggested_retry_args:string[];
35
35
  /** Whether the emitted retry or safe alternate-root retry executed successfully. */
36
- retry_succeeded: boolean;
36
+ retry_succeeded:boolean;
37
37
  /** Whether a file-path refusal incorrectly recommended tracker initialization. */
38
- unsafe_init_recommended: boolean;
38
+ unsafe_init_recommended:boolean;
39
39
  }
40
40
  /** Actionable failure emitted by the tracker preflight closure scorer. */
41
41
  export interface PmTrackerPreflightRecoveryFinding {
42
42
  /** Stable finding code for automation and ratchets. */
43
- code: "missing_probe" | "error_code_mismatch" | "exit_code_mismatch" | "recovery_kind_mismatch" | "missing_init_recovery" | "unsafe_init_recovery" | "retry_failed";
43
+ code:"missing_probe" | "error_code_mismatch" | "exit_code_mismatch" | "recovery_kind_mismatch" | "missing_init_recovery" | "unsafe_init_recovery" | "retry_failed";
44
44
  /** Probe that failed its recovery obligation. */
45
- probe_id: string;
45
+ probe_id:string;
46
46
  /** Human-readable explanation of the failed obligation. */
47
- detail: string;
47
+ detail:string;
48
48
  }
49
49
  /** Aggregate executable-closure report for the tracker preflight corpus. */
50
50
  export interface PmTrackerPreflightRecoveryReport {
51
51
  /** Whether every declared probe met its refusal and recovery contract. */
52
- ok: boolean;
52
+ ok:boolean;
53
53
  /** Number of declared tracker preflight probes. */
54
- probe_count: number;
54
+ probe_count:number;
55
55
  /** Number of probes with no findings. */
56
- closed_probe_count: number;
56
+ closed_probe_count:number;
57
57
  /** Deterministically ordered failed obligations. */
58
- findings: PmTrackerPreflightRecoveryFinding[];
58
+ findings:PmTrackerPreflightRecoveryFinding[];
59
59
  }
60
60
  /** Return defensive copies of every core tracker preflight recovery contract. */
61
- export declare function listTrackerPreflightRecoveryContracts(): PmTrackerPreflightRecoveryContract[];
61
+ export declare function listTrackerPreflightRecoveryContracts():PmTrackerPreflightRecoveryContract[];
62
62
  /** Score runtime observations against the complete tracker preflight recovery corpus. */
63
- export declare function scoreTrackerPreflightRecoveryClosure(observations: readonly PmTrackerPreflightRecoveryObservation[]): PmTrackerPreflightRecoveryReport;
63
+ export declare function scoreTrackerPreflightRecoveryClosure(observations:readonly PmTrackerPreflightRecoveryObservation[]):PmTrackerPreflightRecoveryReport;
@@ -6,24 +6,24 @@ export type PmCommandCapabilityFamily = ExtensionCommandCapabilityFamily;
6
6
  /** One command's canonical agent-surface visibility declaration. */
7
7
  export interface PmCommandVisibilityContract {
8
8
  /** Canonical command path. */
9
- command: string;
9
+ command:string;
10
10
  /** Minimum surface tier that advertises the command. */
11
- tier: PmCommandVisibilityTier;
11
+ tier:PmCommandVisibilityTier;
12
12
  }
13
13
  /** Complete command capability contract with visibility and family ownership. */
14
14
  export interface PmCommandCapabilityContract extends PmCommandVisibilityContract {
15
15
  /** Exactly one stable capability family used to group the command. */
16
- family: PmCommandCapabilityFamily;
16
+ family:PmCommandCapabilityFamily;
17
17
  }
18
18
  /** One generated family route shared by guides, skills, and documentation. */
19
19
  export interface PmCommandCapabilityGroup {
20
20
  /** Stable capability family. */
21
- family: PmCommandCapabilityFamily;
21
+ family:PmCommandCapabilityFamily;
22
22
  /** Non-internal commands owned by the family. */
23
- commands: readonly string[];
23
+ commands:readonly string[];
24
24
  }
25
25
  /** Resolve one command's stable capability family. */
26
- export declare function resolvePmCommandCapabilityFamily(command: string): PmCommandCapabilityFamily;
26
+ export declare function resolvePmCommandCapabilityFamily(command:string):PmCommandCapabilityFamily;
27
27
  /**
28
28
  * Canonical visibility contract for every built-in command.
29
29
  *
@@ -31,80 +31,80 @@ export declare function resolvePmCommandCapabilityFamily(command: string): PmCom
31
31
  * surface. Internal worker/helper paths are appended below and never advertised
32
32
  * by normal help or completion projections.
33
33
  */
34
- export declare const PM_COMMAND_CAPABILITY_CONTRACTS: readonly PmCommandCapabilityContract[];
34
+ export declare const PM_COMMAND_CAPABILITY_CONTRACTS:readonly PmCommandCapabilityContract[];
35
35
  /** Backward-compatible tier-only projection of the capability contract. */
36
- export declare const PM_COMMAND_VISIBILITY_CONTRACTS: readonly PmCommandVisibilityContract[];
36
+ export declare const PM_COMMAND_VISIBILITY_CONTRACTS:readonly PmCommandVisibilityContract[];
37
37
  /** Bounded compact-help contract: one conventional terminal screen. */
38
- export declare const PM_CORE_HELP_BUDGET: Readonly<{
39
- max_lines: 50;
40
- max_utf8_bytes: 6000;
38
+ export declare const PM_CORE_HELP_BUDGET:Readonly<{
39
+ max_lines:50;
40
+ max_utf8_bytes:6000;
41
41
  }>;
42
42
  /** Root options retained in the compact progressive-disclosure help screen. */
43
- export declare const PM_CORE_HELP_OPTION_FLAGS: readonly string[];
43
+ export declare const PM_CORE_HELP_OPTION_FLAGS:readonly string[];
44
44
  /** Measure rendered core help against its line and byte ceilings. */
45
- export declare function measurePmCoreHelp(text: string): {
46
- lines: number;
47
- utf8_bytes: number;
48
- within_budget: boolean;
45
+ export declare function measurePmCoreHelp(text:string):{
46
+ lines:number;
47
+ utf8_bytes:number;
48
+ within_budget:boolean;
49
49
  };
50
50
  /** Resolve one command's declared tier; extension commands default to standard. */
51
- export declare function resolvePmCommandVisibilityTier(command: string, extensionTier?: PmCommandVisibilityTier): PmCommandVisibilityTier;
51
+ export declare function resolvePmCommandVisibilityTier(command:string,extensionTier?:PmCommandVisibilityTier):PmCommandVisibilityTier;
52
52
  /** Return commands visible at a requested tier, preserving contract order. */
53
- export declare function listPmCommandsForTier(tier: Exclude<PmCommandVisibilityTier, "internal">): string[];
53
+ export declare function listPmCommandsForTier(tier:Exclude<PmCommandVisibilityTier,"internal">):string[];
54
54
  /** Project an explicit command registry into one visibility tier. */
55
- export declare function listPmCommandsForTierFromContracts(tier: Exclude<PmCommandVisibilityTier, "internal">, contracts: readonly PmCommandCapabilityContract[]): string[];
55
+ export declare function listPmCommandsForTierFromContracts(tier:Exclude<PmCommandVisibilityTier,"internal">,contracts:readonly PmCommandCapabilityContract[]):string[];
56
56
  /** Return commands in one capability family, preserving contract order. */
57
- export declare function listPmCommandsForFamily(family: PmCommandCapabilityFamily): string[];
57
+ export declare function listPmCommandsForFamily(family:PmCommandCapabilityFamily):string[];
58
58
  /** Project an explicit command registry into one capability family. */
59
- export declare function listPmCommandsForFamilyFromContracts(family: PmCommandCapabilityFamily, contracts: readonly PmCommandCapabilityContract[]): string[];
59
+ export declare function listPmCommandsForFamilyFromContracts(family:PmCommandCapabilityFamily,contracts:readonly PmCommandCapabilityContract[]):string[];
60
60
  /** Group the command registry for progressive-disclosure routing surfaces. */
61
- export declare function listPmCommandCapabilityGroups(contracts?: readonly PmCommandCapabilityContract[]): PmCommandCapabilityGroup[];
61
+ export declare function listPmCommandCapabilityGroups(contracts?:readonly PmCommandCapabilityContract[]):PmCommandCapabilityGroup[];
62
62
  /** MCP profile names accepted by the server and embedding hosts. */
63
63
  export type PmMcpToolProfile = "core" | "standard" | "full" | "custom";
64
64
  /** Mapping from one narrow MCP tool to the command contract that tiers it. */
65
- export declare const PM_MCP_TOOL_COMMAND_CONTRACTS: Readonly<Record<string, string>>;
65
+ export declare const PM_MCP_TOOL_COMMAND_CONTRACTS:Readonly<Record<string,string>>;
66
66
  /** Resolve the tools visible in a named MCP profile from command tiers. */
67
- export declare function listPmMcpToolsForProfile(availableTools: readonly string[], profile: Exclude<PmMcpToolProfile, "custom">): string[];
67
+ export declare function listPmMcpToolsForProfile(availableTools:readonly string[],profile:Exclude<PmMcpToolProfile,"custom">):string[];
68
68
  /** Project an explicit command registry into one MCP tool profile. */
69
- export declare function listPmMcpToolsForProfileFromContracts(availableTools: readonly string[], profile: Exclude<PmMcpToolProfile, "custom">, contracts: readonly PmCommandCapabilityContract[]): string[];
69
+ export declare function listPmMcpToolsForProfileFromContracts(availableTools:readonly string[],profile:Exclude<PmMcpToolProfile,"custom">,contracts:readonly PmCommandCapabilityContract[]):string[];
70
70
  /** Stable MCP resource contract generated from the same agent surface table. */
71
71
  export interface PmMcpResourceContract {
72
72
  /** Stable resource URI. */
73
- uri: string;
73
+ uri:string;
74
74
  /** Human-readable resource name. */
75
- name: string;
75
+ name:string;
76
76
  /** Agent-facing resource description. */
77
- description: string;
77
+ description:string;
78
78
  /** Resource MIME type. */
79
- mimeType: "application/json" | "text/markdown";
79
+ mimeType:"application/json" | "text/markdown";
80
80
  }
81
81
  /** Addressable, bounded workspace context resources. */
82
- export declare const PM_MCP_RESOURCE_CONTRACTS: readonly PmMcpResourceContract[];
82
+ export declare const PM_MCP_RESOURCE_CONTRACTS:readonly PmMcpResourceContract[];
83
83
  /** One parameter accepted by a canonical MCP workflow prompt. */
84
84
  export interface PmMcpPromptArgumentContract {
85
85
  /** Stable prompt argument name. */
86
- name: string;
86
+ name:string;
87
87
  /** Argument description shown by the MCP host. */
88
- description: string;
88
+ description:string;
89
89
  /** Whether the host must provide the argument. */
90
- required: boolean;
90
+ required:boolean;
91
91
  }
92
92
  /** Canonical MCP workflow prompt generated from the agent operating contract. */
93
93
  export interface PmMcpPromptContract {
94
94
  /** Stable prompt name. */
95
- name: string;
95
+ name:string;
96
96
  /** Agent-facing workflow description. */
97
- description: string;
97
+ description:string;
98
98
  /** Parameters accepted by the workflow. */
99
- arguments: readonly PmMcpPromptArgumentContract[];
99
+ arguments:readonly PmMcpPromptArgumentContract[];
100
100
  /** Template rendered into a user message after argument substitution. */
101
- template: string;
101
+ template:string;
102
102
  }
103
103
  /** Canonical orient, start, and evidence-close workflows. */
104
- export declare const PM_MCP_PROMPT_CONTRACTS: readonly PmMcpPromptContract[];
104
+ export declare const PM_MCP_PROMPT_CONTRACTS:readonly PmMcpPromptContract[];
105
105
  /** Render the generated command visibility reference used by docs drift gates. */
106
- export declare function renderPmCommandVisibilityMarkdown(): string;
106
+ export declare function renderPmCommandVisibilityMarkdown():string;
107
107
  /** Render an explicit registry for mutation-sensitivity and host tooling. */
108
- export declare function renderPmCommandVisibilityMarkdownFromContracts(contracts: readonly PmCommandCapabilityContract[]): string;
108
+ export declare function renderPmCommandVisibilityMarkdownFromContracts(contracts:readonly PmCommandCapabilityContract[]):string;
109
109
  /** Render family routing for generated docs and skill progressive disclosure. */
110
- export declare function renderPmCapabilityRoutingMarkdown(contracts?: readonly PmCommandCapabilityContract[]): string;
110
+ export declare function renderPmCapabilityRoutingMarkdown(contracts?:readonly PmCommandCapabilityContract[]):string;
@@ -3,4 +3,4 @@
3
3
  *
4
4
  * Public SDK entrypoint for session-scoped provenance and episode identity.
5
5
  */
6
- export { agentSessionEnvironment, boundAgentEpisodeIdentity, runWithAgentSessionContext, resolveAgentSessionContextFromSignals, type AgentEpisodeIdentity, type AgentSessionContext, } from "../core/shared/agent-session-context.js";
6
+ export { agentSessionEnvironment,boundAgentEpisodeIdentity,runWithAgentSessionContext,resolveAgentSessionContextFromSignals,type AgentEpisodeIdentity,type AgentSessionContext,} from "../core/shared/agent-session-context.js";