@unbrained/pm-cli 2026.10.13 → 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 (708) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +72 -1
  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-command-options.js +1 -1
  27. package/dist/cli/extension-recovery.d.ts +13 -13
  28. package/dist/cli/help-content.d.ts +22 -22
  29. package/dist/cli/help-content.js +2 -2
  30. package/dist/cli/help-json-payload.d.ts +45 -45
  31. package/dist/cli/invocation-profile.d.ts +5 -5
  32. package/dist/cli/main.d.ts +217 -217
  33. package/dist/cli/main.js +2 -2
  34. package/dist/cli/migration-gates.d.ts +24 -24
  35. package/dist/cli/option-values.d.ts +1 -1
  36. package/dist/cli/public.d.ts +1 -1
  37. package/dist/cli/register-annotations.d.ts +2 -2
  38. package/dist/cli/register-assurance.d.ts +1 -1
  39. package/dist/cli/register-files-lookup.d.ts +1 -1
  40. package/dist/cli/register-history-activity.d.ts +1 -1
  41. package/dist/cli/register-history-author.d.ts +1 -1
  42. package/dist/cli/register-history-maintenance.d.ts +1 -1
  43. package/dist/cli/register-list-query.d.ts +7 -7
  44. package/dist/cli/register-list-query.js +3 -3
  45. package/dist/cli/register-mutation-options.d.ts +1 -1
  46. package/dist/cli/register-mutation.d.ts +4 -4
  47. package/dist/cli/register-operations.d.ts +75 -75
  48. package/dist/cli/register-setup.d.ts +4 -4
  49. package/dist/cli/register-structured-mutation.d.ts +8 -8
  50. package/dist/cli/runtime/activation.d.ts +23 -23
  51. package/dist/cli/runtime/invocation-options.d.ts +12 -12
  52. package/dist/cli/runtime/projection-retry.d.ts +1 -1
  53. package/dist/cli/runtime/selection.d.ts +16 -16
  54. package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
  55. package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
  56. package/dist/cli/schema/registration.d.ts +1 -1
  57. package/dist/cli/schema-registration-helpers.d.ts +2 -2
  58. package/dist/cli/stats-analytics-json.d.ts +1 -1
  59. package/dist/cli-bundle/bundle-manifest.json +1 -1
  60. package/dist/cli-bundle/chunks/{chunk-LBDWFWPK.js → chunk-52EZH2QQ.js} +2 -2
  61. package/dist/cli-bundle/chunks/chunk-7OEGNA4X.js +20 -0
  62. package/dist/cli-bundle/chunks/{chunk-APWPC4ZZ.js → chunk-7VHINXZP.js} +2 -2
  63. package/dist/cli-bundle/chunks/chunk-EMEEHV2Y.js +2 -0
  64. package/dist/cli-bundle/chunks/chunk-JGKTOBVB.js +6 -0
  65. package/dist/cli-bundle/chunks/{chunk-PSNS537F.js → chunk-JSUJWIHQ.js} +30 -30
  66. package/dist/cli-bundle/chunks/{chunk-N5EXRYCZ.js → chunk-LNKLQYBG.js} +2 -2
  67. package/dist/cli-bundle/chunks/{chunk-YH6H3UVE.js → chunk-N56CAQBU.js} +63 -64
  68. package/dist/cli-bundle/chunks/chunk-NC3QVGDD.js +8 -0
  69. package/dist/cli-bundle/chunks/{chunk-AM2XOZKE.js → chunk-RJ5N44WY.js} +2 -2
  70. package/dist/cli-bundle/chunks/{chunk-HXHFKXLV.js → chunk-VIMQCFCK.js} +2 -2
  71. package/dist/cli-bundle/chunks/{chunk-UBTYYZIE.js → chunk-WBBW3WQX.js} +4 -4
  72. package/dist/cli-bundle/chunks/chunk-X2H6UR26.js +236 -0
  73. package/dist/cli-bundle/chunks/{register-list-query-BJ742QOR.js → register-list-query-FKKFQ66D.js} +7 -7
  74. package/dist/cli-bundle/chunks/{register-mutation-GGGBRIH2.js → register-mutation-EWMMVZJB.js} +2 -2
  75. package/dist/cli-bundle/chunks/{register-operations-E6HXYHNM.js → register-operations-GEQ2H7PS.js} +2 -2
  76. package/dist/cli-bundle/chunks/{register-setup-4ZVTVEPY.js → register-setup-PSJTQBBO.js} +2 -2
  77. package/dist/cli-bundle/focused-chunks/{chunk-NNW5BS5L.js → chunk-3RNUMVK4.js} +2 -2
  78. package/dist/cli-bundle/focused-chunks/{chunk-3LQEBXU5.js → chunk-4KQFMOM7.js} +6 -6
  79. package/dist/cli-bundle/focused-chunks/{chunk-RAA7SVRA.js → chunk-52I2SNKJ.js} +2 -2
  80. package/dist/cli-bundle/focused-chunks/{chunk-6BTUISKV.js → chunk-5KRACGBK.js} +2 -2
  81. package/dist/cli-bundle/focused-chunks/chunk-5OO54BIV.js +3 -0
  82. package/dist/cli-bundle/focused-chunks/chunk-5TBAVZDR.js +20 -0
  83. package/dist/cli-bundle/focused-chunks/{chunk-R23T7GFZ.js → chunk-FQKPOZKS.js} +2 -2
  84. package/dist/cli-bundle/focused-chunks/{chunk-IIKFTJVC.js → chunk-H3P77KVU.js} +2 -2
  85. package/dist/cli-bundle/focused-chunks/chunk-HTA3TNC3.js +26 -0
  86. package/dist/cli-bundle/focused-chunks/{chunk-73UNAJHD.js → chunk-JKBH7YGX.js} +2 -2
  87. package/dist/cli-bundle/focused-chunks/{chunk-KGFRQ34R.js → chunk-KIIFVULU.js} +2 -2
  88. package/dist/cli-bundle/focused-chunks/{chunk-SOB7X4FJ.js → chunk-N6FUKTZS.js} +2 -2
  89. package/dist/cli-bundle/focused-chunks/chunk-PDYE7QDX.js +166 -0
  90. package/dist/cli-bundle/focused-chunks/{chunk-RU6GCFN3.js → chunk-Q4VNCTR2.js} +2 -2
  91. package/dist/cli-bundle/focused-chunks/{chunk-QMNAY25P.js → chunk-THYQR3ON.js} +61 -62
  92. package/dist/cli-bundle/focused-chunks/{chunk-DVK7VKZL.js → chunk-TYLG5VEB.js} +2 -2
  93. package/dist/cli-bundle/main.js +27 -27
  94. package/dist/cli-bundle/sdk-authoring.js +1 -1
  95. package/dist/cli-bundle/sdk-contracts.js +2 -2
  96. package/dist/cli-bundle/sdk-core.js +23 -23
  97. package/dist/cli-bundle/sdk-governance.js +1 -1
  98. package/dist/cli-bundle/sdk-graph.js +1 -1
  99. package/dist/cli-bundle/sdk-merge.js +51 -51
  100. package/dist/cli-bundle/sdk-query.js +1 -1
  101. package/dist/cli-bundle/sdk-runtime.js +1 -1
  102. package/dist/cli-bundle/sdk-testing.js +1 -1
  103. package/dist/cli-bundle/sdk.js +7 -7
  104. package/dist/cli.d.ts +9 -9
  105. package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
  106. package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
  107. package/dist/core/config/nested-settings.d.ts +20 -20
  108. package/dist/core/config/positional-value.d.ts +9 -9
  109. package/dist/core/diagnostics/remediation.d.ts +7 -7
  110. package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
  111. package/dist/core/extensions/activation-summary.d.ts +30 -30
  112. package/dist/core/extensions/activation-transaction.d.ts +9 -9
  113. package/dist/core/extensions/capability-usage.d.ts +25 -25
  114. package/dist/core/extensions/command-hook-context.d.ts +15 -15
  115. package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
  116. package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
  117. package/dist/core/extensions/contribution-inventory.d.ts +24 -24
  118. package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
  119. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  120. package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
  121. package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
  122. package/dist/core/extensions/extension-policy.d.ts +62 -62
  123. package/dist/core/extensions/extension-registries.d.ts +8 -8
  124. package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
  125. package/dist/core/extensions/extension-types.d.ts +702 -702
  126. package/dist/core/extensions/flag-definition-validation.d.ts +19 -6
  127. package/dist/core/extensions/flag-definition-validation.js +1 -1
  128. package/dist/core/extensions/flag-value-types.d.ts +16 -4
  129. package/dist/core/extensions/flag-value-types.js +1 -1
  130. package/dist/core/extensions/index.d.ts +34 -34
  131. package/dist/core/extensions/item-field-types.d.ts +3 -3
  132. package/dist/core/extensions/item-fields.d.ts +6 -6
  133. package/dist/core/extensions/loader.d.ts +66 -66
  134. package/dist/core/extensions/manifest-parser.d.ts +1 -1
  135. package/dist/core/extensions/manifest-schema.d.ts +13 -13
  136. package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
  137. package/dist/core/extensions/preflight-ownership.d.ts +3 -3
  138. package/dist/core/extensions/read-output-contract.d.ts +2 -2
  139. package/dist/core/extensions/registration-contracts.d.ts +12 -12
  140. package/dist/core/extensions/registration-validation.d.ts +6 -6
  141. package/dist/core/extensions/registration-values.d.ts +19 -19
  142. package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
  143. package/dist/core/extensions/runtime-registrations.d.ts +6 -6
  144. package/dist/core/extensions/service-ownership.d.ts +1 -1
  145. package/dist/core/extensions/version-compat.d.ts +9 -9
  146. package/dist/core/fs/atomic-create.d.ts +1 -1
  147. package/dist/core/fs/fs-utils.d.ts +12 -12
  148. package/dist/core/fs/host-environment-errors.d.ts +10 -10
  149. package/dist/core/fs/path-utils.d.ts +1 -1
  150. package/dist/core/governance/content-fields.d.ts +25 -25
  151. package/dist/core/governance/issue-codes.d.ts +16 -16
  152. package/dist/core/governance/metadata-coverage.d.ts +64 -64
  153. package/dist/core/history/digest.d.ts +5 -5
  154. package/dist/core/history/drift-cache.d.ts +2 -2
  155. package/dist/core/history/drift-scan.d.ts +18 -18
  156. package/dist/core/history/event-classification.d.ts +4 -4
  157. package/dist/core/history/event-index.d.ts +33 -33
  158. package/dist/core/history/history-compact-bulk.d.ts +12 -12
  159. package/dist/core/history/history-diff.d.ts +15 -15
  160. package/dist/core/history/history-rewrite.d.ts +43 -43
  161. package/dist/core/history/history-storage-stats.d.ts +20 -20
  162. package/dist/core/history/history-stream-policy.d.ts +12 -12
  163. package/dist/core/history/history.d.ts +45 -45
  164. package/dist/core/history/identity.d.ts +4 -4
  165. package/dist/core/history/operation-contract.d.ts +17 -17
  166. package/dist/core/history/projection.d.ts +16 -16
  167. package/dist/core/history/read.d.ts +4 -4
  168. package/dist/core/history/replay.d.ts +47 -47
  169. package/dist/core/history/tombstone.d.ts +1 -1
  170. package/dist/core/history/version-address.d.ts +2 -2
  171. package/dist/core/history/workspace-history.d.ts +72 -72
  172. package/dist/core/io/body-file.d.ts +2 -2
  173. package/dist/core/io/bulk-ids-input.d.ts +7 -7
  174. package/dist/core/item/actionability.d.ts +30 -30
  175. package/dist/core/item/dependency-reference.d.ts +2 -2
  176. package/dist/core/item/id.d.ts +9 -9
  177. package/dist/core/item/item-format-version.d.ts +17 -15
  178. package/dist/core/item/item-format-version.js +1 -1
  179. package/dist/core/item/item-format.d.ts +54 -54
  180. package/dist/core/item/item-record.d.ts +1 -1
  181. package/dist/core/item/item-type-definition.d.ts +11 -11
  182. package/dist/core/item/parent-reference-policy.d.ts +6 -6
  183. package/dist/core/item/parse.d.ts +37 -37
  184. package/dist/core/item/plan-lifecycle.d.ts +4 -4
  185. package/dist/core/item/priority.d.ts +3 -3
  186. package/dist/core/item/sprint-release-format.d.ts +4 -4
  187. package/dist/core/item/status-filter.d.ts +5 -5
  188. package/dist/core/item/status.d.ts +3 -3
  189. package/dist/core/item/toon-decode.d.ts +10 -10
  190. package/dist/core/item/type-registry.d.ts +35 -35
  191. package/dist/core/item/type-synonyms.d.ts +2 -2
  192. package/dist/core/lock/lock-gc.d.ts +28 -28
  193. package/dist/core/lock/lock.d.ts +53 -53
  194. package/dist/core/output/mutation-projection.d.ts +4 -4
  195. package/dist/core/output/output-control.d.ts +4 -4
  196. package/dist/core/output/output.d.ts +30 -30
  197. package/dist/core/output/query-summary.d.ts +5 -5
  198. package/dist/core/output/tabular.d.ts +3 -3
  199. package/dist/core/packages/manifest.d.ts +30 -30
  200. package/dist/core/packages/root.d.ts +4 -4
  201. package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
  202. package/dist/core/policy/workflow-policy-store.d.ts +15 -15
  203. package/dist/core/policy/workflow-policy.d.ts +56 -56
  204. package/dist/core/profile/profile-describe.d.ts +22 -22
  205. package/dist/core/profile/profile-lint.d.ts +13 -13
  206. package/dist/core/profile/profile-plan.d.ts +45 -45
  207. package/dist/core/profile/profile-presets.d.ts +36 -36
  208. package/dist/core/reproducibility/context.d.ts +9 -9
  209. package/dist/core/schema/fields-file.d.ts +35 -35
  210. package/dist/core/schema/item-types-file.d.ts +29 -29
  211. package/dist/core/schema/runtime-field-filters.d.ts +3 -3
  212. package/dist/core/schema/runtime-field-values.d.ts +7 -7
  213. package/dist/core/schema/runtime-schema.d.ts +59 -59
  214. package/dist/core/schema/status-defs-file.d.ts +29 -29
  215. package/dist/core/schema/status-token.d.ts +1 -1
  216. package/dist/core/schema/type-inference.d.ts +10 -10
  217. package/dist/core/schema/type-presets.d.ts +5 -5
  218. package/dist/core/schema/type-workflows.d.ts +14 -14
  219. package/dist/core/search/background-refresh.d.ts +12 -12
  220. package/dist/core/search/bm25.d.ts +16 -16
  221. package/dist/core/search/cache.d.ts +34 -34
  222. package/dist/core/search/corpus.d.ts +17 -17
  223. package/dist/core/search/embedding-batches.d.ts +25 -25
  224. package/dist/core/search/eval-thresholds.d.ts +4 -4
  225. package/dist/core/search/eval.d.ts +40 -40
  226. package/dist/core/search/http-client.d.ts +24 -24
  227. package/dist/core/search/providers.d.ts +30 -30
  228. package/dist/core/search/relevance.d.ts +17 -17
  229. package/dist/core/search/semantic-defaults.d.ts +5 -5
  230. package/dist/core/search/staleness.d.ts +3 -3
  231. package/dist/core/search/vector-stores.d.ts +51 -51
  232. package/dist/core/search/vectorization-metadata.d.ts +9 -9
  233. package/dist/core/sentry/helpers.d.ts +28 -26
  234. package/dist/core/sentry/helpers.js +1 -1
  235. package/dist/core/sentry/instrument.d.ts +52 -50
  236. package/dist/core/sentry/instrument.js +1 -1
  237. package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
  238. package/dist/core/sentry/sensitive-assignments.js +2 -0
  239. package/dist/core/session/session-state.d.ts +37 -37
  240. package/dist/core/shared/agent-session-context.d.ts +14 -14
  241. package/dist/core/shared/author.d.ts +89 -89
  242. package/dist/core/shared/command-line.d.ts +3 -3
  243. package/dist/core/shared/command-types.d.ts +20 -20
  244. package/dist/core/shared/conflict-markers.d.ts +5 -5
  245. package/dist/core/shared/constants.d.ts +30 -30
  246. package/dist/core/shared/errors.d.ts +100 -100
  247. package/dist/core/shared/html-entity-decode.d.ts +2 -2
  248. package/dist/core/shared/item-metadata-contract.d.ts +2 -2
  249. package/dist/core/shared/lazy-module.d.ts +1 -1
  250. package/dist/core/shared/levenshtein.d.ts +1 -1
  251. package/dist/core/shared/memo.d.ts +1 -1
  252. package/dist/core/shared/numeric-parsers.d.ts +1 -1
  253. package/dist/core/shared/option-alias-visibility.d.ts +3 -3
  254. package/dist/core/shared/primitives.d.ts +13 -13
  255. package/dist/core/shared/secret-rules.d.ts +92 -92
  256. package/dist/core/shared/serial-queue.d.ts +6 -6
  257. package/dist/core/shared/serialization.d.ts +4 -4
  258. package/dist/core/shared/split-comma-list.d.ts +4 -4
  259. package/dist/core/shared/text-normalization.d.ts +3 -3
  260. package/dist/core/shared/time.d.ts +27 -27
  261. package/dist/core/store/item-format-migration.d.ts +7 -7
  262. package/dist/core/store/item-metadata-cache.d.ts +30 -30
  263. package/dist/core/store/item-metadata-query-index.d.ts +66 -66
  264. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  265. package/dist/core/store/item-store.d.ts +123 -123
  266. package/dist/core/store/item-store.js +1 -1
  267. package/dist/core/store/paths.d.ts +27 -27
  268. package/dist/core/store/settings-concurrency.d.ts +1 -1
  269. package/dist/core/store/settings-read-cache.d.ts +11 -11
  270. package/dist/core/store/settings-validator.d.ts +117 -117
  271. package/dist/core/store/settings.d.ts +84 -84
  272. package/dist/core/store/sqlite-runtime.d.ts +2 -2
  273. package/dist/core/store/tracker-preflight.d.ts +3 -3
  274. package/dist/core/telemetry/consent.d.ts +1 -1
  275. package/dist/core/telemetry/observability.d.ts +16 -16
  276. package/dist/core/telemetry/policy.d.ts +7 -7
  277. package/dist/core/telemetry/read-sampling.d.ts +1 -1
  278. package/dist/core/telemetry/runtime.d.ts +275 -275
  279. package/dist/core/telemetry/runtime.js +2 -2
  280. package/dist/core/test/background-runs.d.ts +123 -123
  281. package/dist/core/test/item-test-run-tracking.d.ts +10 -10
  282. package/dist/core/test/run-selectors.d.ts +12 -12
  283. package/dist/core/validate/estimate-defaults.d.ts +3 -3
  284. package/dist/core/validate/fix-planning.d.ts +36 -36
  285. package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
  286. package/dist/core/validate/missing-by-type.d.ts +3 -3
  287. package/dist/core/validate/missing-link-owners.d.ts +17 -17
  288. package/dist/core/validate/stale-file-classification.d.ts +6 -6
  289. package/dist/mcp/http-server.d.ts +26 -26
  290. package/dist/mcp/legacy-adapter.d.ts +18 -18
  291. package/dist/mcp/runtime-capabilities.d.ts +18 -18
  292. package/dist/mcp/server.d.ts +73 -73
  293. package/dist/mcp/tool-definitions.d.ts +27 -27
  294. package/dist/sdk/actionability.d.ts +1 -1
  295. package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
  296. package/dist/sdk/agent/command-recovery.d.ts +5 -5
  297. package/dist/sdk/agent/command-suggestions.d.ts +4 -4
  298. package/dist/sdk/agent/create-option-policy.d.ts +2 -2
  299. package/dist/sdk/agent/identity-config.d.ts +18 -18
  300. package/dist/sdk/agent/item-addressing.d.ts +6 -6
  301. package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
  302. package/dist/sdk/agent/refusal-closure.d.ts +22 -22
  303. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
  304. package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
  305. package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
  306. package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
  307. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
  308. package/dist/sdk/agent-capability-contracts.d.ts +41 -41
  309. package/dist/sdk/agent-session-context.d.ts +1 -1
  310. package/dist/sdk/annotations.d.ts +74 -74
  311. package/dist/sdk/author-attribution.d.ts +47 -47
  312. package/dist/sdk/authoring.d.ts +9 -9
  313. package/dist/sdk/cli-bootstrap.d.ts +65 -65
  314. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
  315. package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
  316. package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
  317. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
  318. package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
  319. package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
  320. package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
  321. package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
  322. package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
  323. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  324. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
  325. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
  326. package/dist/sdk/cli-contracts/registration-helpers.d.ts +56 -56
  327. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
  328. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  329. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
  330. package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
  331. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
  332. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
  333. package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
  334. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
  335. package/dist/sdk/cli-contracts.d.ts +15 -15
  336. package/dist/sdk/cli-program.d.ts +1 -1
  337. package/dist/sdk/cli-program.js +1 -1
  338. package/dist/sdk/command-line.d.ts +3 -3
  339. package/dist/sdk/comments.d.ts +24 -24
  340. package/dist/sdk/compile-cache.d.ts +4 -4
  341. package/dist/sdk/completion/bash.d.ts +1 -1
  342. package/dist/sdk/completion/fish.d.ts +1 -1
  343. package/dist/sdk/completion/shared.d.ts +74 -74
  344. package/dist/sdk/completion/zsh.d.ts +1 -1
  345. package/dist/sdk/completion.d.ts +3 -3
  346. package/dist/sdk/compose.d.ts +94 -94
  347. package/dist/sdk/config.d.ts +105 -105
  348. package/dist/sdk/context/recency.d.ts +1 -1
  349. package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
  350. package/dist/sdk/context/usage-egress.d.ts +1 -1
  351. package/dist/sdk/context/usage-ledger.d.ts +18 -18
  352. package/dist/sdk/context-intent-contracts.d.ts +37 -37
  353. package/dist/sdk/context-intent-runtime.d.ts +10 -10
  354. package/dist/sdk/context-packing.d.ts +44 -44
  355. package/dist/sdk/context-relevance.d.ts +110 -110
  356. package/dist/sdk/context-signal-store.d.ts +52 -52
  357. package/dist/sdk/context-usage.d.ts +78 -78
  358. package/dist/sdk/contracts.d.ts +2 -1
  359. package/dist/sdk/contracts.js +1 -1
  360. package/dist/sdk/core-governance.d.ts +5 -5
  361. package/dist/sdk/core.d.ts +8 -8
  362. package/dist/sdk/corpus-shape.d.ts +60 -60
  363. package/dist/sdk/define.d.ts +36 -36
  364. package/dist/sdk/dependencies.d.ts +70 -70
  365. package/dist/sdk/dependency-flag-validation.d.ts +17 -17
  366. package/dist/sdk/dependency-provenance.d.ts +22 -22
  367. package/dist/sdk/docs.d.ts +17 -17
  368. package/dist/sdk/duplicates.d.ts +14 -14
  369. package/dist/sdk/environment/agent-environment.d.ts +118 -118
  370. package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
  371. package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
  372. package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
  373. package/dist/sdk/environment/source-context.d.ts +4 -4
  374. package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
  375. package/dist/sdk/error-code-catalog.d.ts +33 -33
  376. package/dist/sdk/error-runtime.d.ts +5 -5
  377. package/dist/sdk/errors.d.ts +17 -17
  378. package/dist/sdk/eval.d.ts +27 -27
  379. package/dist/sdk/extension/author-manifest.d.ts +9 -9
  380. package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
  381. package/dist/sdk/extension/concurrency.d.ts +1 -1
  382. package/dist/sdk/extension/copy-scope.d.ts +1 -1
  383. package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
  384. package/dist/sdk/extension/describe.d.ts +21 -21
  385. package/dist/sdk/extension/doctor.d.ts +46 -46
  386. package/dist/sdk/extension/install-plan.d.ts +32 -32
  387. package/dist/sdk/extension/install-receipts.d.ts +4 -4
  388. package/dist/sdk/extension/install-runtime.d.ts +12 -12
  389. package/dist/sdk/extension/install-snapshot.d.ts +10 -10
  390. package/dist/sdk/extension/install-sources.d.ts +106 -106
  391. package/dist/sdk/extension/managed-state.d.ts +42 -42
  392. package/dist/sdk/extension/managed-update-status.d.ts +1 -1
  393. package/dist/sdk/extension/migrations.d.ts +48 -48
  394. package/dist/sdk/extension/output-ownership.d.ts +19 -19
  395. package/dist/sdk/extension/runtime-summary.d.ts +7 -7
  396. package/dist/sdk/extension/scaffold.d.ts +15 -15
  397. package/dist/sdk/extension/shared.d.ts +16 -16
  398. package/dist/sdk/extension/source-resolution.d.ts +16 -16
  399. package/dist/sdk/extension/static-inventory.d.ts +23 -23
  400. package/dist/sdk/extension/update-check.d.ts +9 -9
  401. package/dist/sdk/extension-command-context.d.ts +1 -1
  402. package/dist/sdk/extension-contracts.d.ts +10 -10
  403. package/dist/sdk/extension.d.ts +221 -221
  404. package/dist/sdk/files.d.ts +101 -101
  405. package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
  406. package/dist/sdk/flag-invocation-contracts.js +1 -1
  407. package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
  408. package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
  409. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  410. package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
  411. package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
  412. package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
  413. package/dist/sdk/governance/assurance-action.d.ts +46 -46
  414. package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
  415. package/dist/sdk/governance/assurance-presets.d.ts +25 -25
  416. package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
  417. package/dist/sdk/governance/assurance.d.ts +204 -204
  418. package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
  419. package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
  420. package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
  421. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
  422. package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
  423. package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
  424. package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
  425. package/dist/sdk/governance/defect-recurrence.js +2 -1
  426. package/dist/sdk/governance/extension-host-version.d.ts +9 -9
  427. package/dist/sdk/governance/gc.d.ts +26 -26
  428. package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
  429. package/dist/sdk/governance/health.d.ts +172 -172
  430. package/dist/sdk/governance/health.js +1 -1
  431. package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
  432. package/dist/sdk/governance/linked-file-report.d.ts +15 -15
  433. package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
  434. package/dist/sdk/governance/provenance-health.d.ts +35 -35
  435. package/dist/sdk/governance/reindex.d.ts +102 -102
  436. package/dist/sdk/governance/reliability.d.ts +29 -29
  437. package/dist/sdk/governance/stale-work.d.ts +13 -13
  438. package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
  439. package/dist/sdk/governance/storage-integrity.d.ts +28 -28
  440. package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
  441. package/dist/sdk/governance/upgrade.d.ts +77 -77
  442. package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
  443. package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
  444. package/dist/sdk/governance/validate-normalization.d.ts +4 -4
  445. package/dist/sdk/governance/validate.d.ts +176 -176
  446. package/dist/sdk/governance/validate.js +1 -1
  447. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  448. package/dist/sdk/governance/workflow-policy.d.ts +18 -18
  449. package/dist/sdk/governance/workspace-position.d.ts +40 -40
  450. package/dist/sdk/governance.d.ts +2 -2
  451. package/dist/sdk/graph/adapter.d.ts +45 -45
  452. package/dist/sdk/graph/analytics.d.ts +36 -36
  453. package/dist/sdk/graph/assembly.d.ts +51 -51
  454. package/dist/sdk/graph/cache.d.ts +19 -19
  455. package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
  456. package/dist/sdk/graph/centrality.d.ts +20 -20
  457. package/dist/sdk/graph/conformance.d.ts +21 -21
  458. package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
  459. package/dist/sdk/graph/durable-cache.d.ts +22 -22
  460. package/dist/sdk/graph/governance-contracts.d.ts +1 -1
  461. package/dist/sdk/graph/governance.d.ts +92 -92
  462. package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
  463. package/dist/sdk/graph/index.d.ts +15 -15
  464. package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
  465. package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
  466. package/dist/sdk/graph/query-contracts.d.ts +6 -6
  467. package/dist/sdk/graph/remediation.d.ts +15 -15
  468. package/dist/sdk/graph/run.d.ts +203 -203
  469. package/dist/sdk/graph/scheduling.d.ts +21 -21
  470. package/dist/sdk/graph/traversal.d.ts +18 -18
  471. package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
  472. package/dist/sdk/guide-topics.d.ts +19 -19
  473. package/dist/sdk/guide.d.ts +43 -43
  474. package/dist/sdk/history/attestation-command.d.ts +8 -8
  475. package/dist/sdk/history/attestation-contract.d.ts +43 -43
  476. package/dist/sdk/history/attestation-scan.d.ts +4 -4
  477. package/dist/sdk/history/attestation.d.ts +4 -4
  478. package/dist/sdk/history/maintenance.d.ts +25 -25
  479. package/dist/sdk/history/salvage.d.ts +19 -19
  480. package/dist/sdk/history/subject.d.ts +8 -8
  481. package/dist/sdk/history-analytics.d.ts +64 -64
  482. package/dist/sdk/history-compact.d.ts +67 -67
  483. package/dist/sdk/history-mcp.d.ts +7 -7
  484. package/dist/sdk/history-provenance.d.ts +40 -40
  485. package/dist/sdk/history-read.d.ts +24 -24
  486. package/dist/sdk/history-redact.d.ts +68 -68
  487. package/dist/sdk/history-repair.d.ts +92 -92
  488. package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
  489. package/dist/sdk/improvement-ledger.d.ts +62 -62
  490. package/dist/sdk/index.d.ts +69 -69
  491. package/dist/sdk/init-agent-guidance.d.ts +68 -68
  492. package/dist/sdk/init.d.ts +117 -117
  493. package/dist/sdk/invocation-author.d.ts +1 -1
  494. package/dist/sdk/item-children.d.ts +15 -15
  495. package/dist/sdk/item-metadata-index.d.ts +2 -2
  496. package/dist/sdk/item-schedule.d.ts +9 -9
  497. package/dist/sdk/item-transaction.d.ts +73 -73
  498. package/dist/sdk/learnings.d.ts +23 -23
  499. package/dist/sdk/lifecycle/append.d.ts +8 -8
  500. package/dist/sdk/lifecycle/claim.d.ts +38 -38
  501. package/dist/sdk/lifecycle/close-many.d.ts +71 -71
  502. package/dist/sdk/lifecycle/close.d.ts +18 -18
  503. package/dist/sdk/lifecycle/copy.d.ts +10 -10
  504. package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
  505. package/dist/sdk/lifecycle/create.d.ts +88 -88
  506. package/dist/sdk/lifecycle/delete.d.ts +15 -15
  507. package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
  508. package/dist/sdk/lifecycle/focus.d.ts +6 -6
  509. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
  510. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
  511. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
  512. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  513. package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
  514. package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
  515. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
  516. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
  517. package/dist/sdk/lifecycle/plan.d.ts +127 -127
  518. package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
  519. package/dist/sdk/lifecycle/reopen.d.ts +15 -15
  520. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
  521. package/dist/sdk/lifecycle/restore.d.ts +34 -34
  522. package/dist/sdk/lifecycle/restore.js +1 -1
  523. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
  524. package/dist/sdk/lifecycle/task-composition.d.ts +7 -7
  525. package/dist/sdk/lifecycle/update-many.d.ts +61 -61
  526. package/dist/sdk/lifecycle/update.d.ts +120 -120
  527. package/dist/sdk/lifecycle-completion.d.ts +14 -14
  528. package/dist/sdk/lifecycle-policy.d.ts +31 -31
  529. package/dist/sdk/linked-artifacts.d.ts +58 -58
  530. package/dist/sdk/mcp/apps.d.ts +28 -28
  531. package/dist/sdk/mcp/authorization.d.ts +66 -66
  532. package/dist/sdk/mcp/discovery.d.ts +67 -67
  533. package/dist/sdk/mcp/interactions.d.ts +49 -49
  534. package/dist/sdk/mcp/protocol.d.ts +63 -63
  535. package/dist/sdk/mcp/skills.d.ts +62 -62
  536. package/dist/sdk/mcp/subscriptions.d.ts +26 -26
  537. package/dist/sdk/mcp/tasks.d.ts +51 -51
  538. package/dist/sdk/mcp/transport.d.ts +17 -17
  539. package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
  540. package/dist/sdk/merge/driver.d.ts +38 -38
  541. package/dist/sdk/merge/index.d.ts +5 -5
  542. package/dist/sdk/merge/install.d.ts +48 -48
  543. package/dist/sdk/merge/install.js +1 -1
  544. package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
  545. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  546. package/dist/sdk/merge/receipt-schema.d.ts +11 -11
  547. package/dist/sdk/merge/receipts.d.ts +111 -111
  548. package/dist/sdk/merge/reconcile.d.ts +20 -20
  549. package/dist/sdk/merge/three-way.d.ts +50 -50
  550. package/dist/sdk/merge/three-way.js +2 -2
  551. package/dist/sdk/merge/worktree-config.d.ts +3 -3
  552. package/dist/sdk/mutation-events.d.ts +62 -62
  553. package/dist/sdk/mutation-guard.d.ts +134 -134
  554. package/dist/sdk/notes.d.ts +28 -28
  555. package/dist/sdk/output/table-rows.d.ts +6 -6
  556. package/dist/sdk/output-contracts.d.ts +26 -26
  557. package/dist/sdk/output-projection.d.ts +108 -108
  558. package/dist/sdk/output-token-accounting.d.ts +18 -18
  559. package/dist/sdk/output.d.ts +18 -18
  560. package/dist/sdk/ownership-source.d.ts +1 -1
  561. package/dist/sdk/package-import-adapters.d.ts +51 -51
  562. package/dist/sdk/package-migrations.d.ts +3 -3
  563. package/dist/sdk/package-runtime-options.d.ts +3 -3
  564. package/dist/sdk/pagination.d.ts +28 -28
  565. package/dist/sdk/pagination.js +1 -1
  566. package/dist/sdk/profile.d.ts +72 -72
  567. package/dist/sdk/provenance.d.ts +37 -37
  568. package/dist/sdk/public-surface.json +1 -1
  569. package/dist/sdk/query/activity.d.ts +84 -84
  570. package/dist/sdk/query/aggregate.d.ts +109 -109
  571. package/dist/sdk/query/calendar.d.ts +95 -95
  572. package/dist/sdk/query/complete-list.d.ts +35 -35
  573. package/dist/sdk/query/context.d.ts +300 -300
  574. package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
  575. package/dist/sdk/query/get.d.ts +54 -54
  576. package/dist/sdk/query/history.d.ts +38 -38
  577. package/dist/sdk/query/item-filter-options.d.ts +41 -41
  578. package/dist/sdk/query/light-metadata.d.ts +1 -1
  579. package/dist/sdk/query/list-filter-shared.d.ts +4 -4
  580. package/dist/sdk/query/list.d.ts +167 -167
  581. package/dist/sdk/query/list.js +1 -1
  582. package/dist/sdk/query/multi-value-filters.d.ts +6 -6
  583. package/dist/sdk/query/next-ready-budget.d.ts +8 -8
  584. package/dist/sdk/query/next.d.ts +94 -94
  585. package/dist/sdk/query/parsers.d.ts +3 -3
  586. package/dist/sdk/query/projection-contracts.d.ts +18 -18
  587. package/dist/sdk/query/search/corpus.d.ts +15 -15
  588. package/dist/sdk/query/search/filters.d.ts +15 -15
  589. package/dist/sdk/query/search/input.d.ts +8 -8
  590. package/dist/sdk/query/search/lexical.d.ts +10 -10
  591. package/dist/sdk/query/search/response.d.ts +22 -22
  592. package/dist/sdk/query/search/semantic.d.ts +133 -133
  593. package/dist/sdk/query/search/types.d.ts +65 -65
  594. package/dist/sdk/query/search-contracts.d.ts +53 -53
  595. package/dist/sdk/query/search-pagination.d.ts +21 -21
  596. package/dist/sdk/query/search-rendering.d.ts +30 -30
  597. package/dist/sdk/query/search.d.ts +60 -60
  598. package/dist/sdk/query/workspace-contracts.d.ts +2 -2
  599. package/dist/sdk/query.d.ts +6 -6
  600. package/dist/sdk/read-output/continuation.d.ts +11 -11
  601. package/dist/sdk/read-output/extension.d.ts +3 -3
  602. package/dist/sdk/read-output/options.d.ts +7 -7
  603. package/dist/sdk/read-output/provenance.d.ts +6 -6
  604. package/dist/sdk/read-output-budget.d.ts +11 -11
  605. package/dist/sdk/read-output-contracts.d.ts +112 -112
  606. package/dist/sdk/read-output-contracts.js +1 -1
  607. package/dist/sdk/read-output-rows.d.ts +15 -15
  608. package/dist/sdk/read-output-session.d.ts +29 -29
  609. package/dist/sdk/relationship-analytics.d.ts +46 -46
  610. package/dist/sdk/relationship-context.d.ts +48 -48
  611. package/dist/sdk/relationship-history.d.ts +59 -59
  612. package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
  613. package/dist/sdk/relationship-migration.d.ts +14 -14
  614. package/dist/sdk/relationships.d.ts +46 -46
  615. package/dist/sdk/reproducibility/process.d.ts +9 -9
  616. package/dist/sdk/runtime/actions.d.ts +1 -1
  617. package/dist/sdk/runtime/context.d.ts +15 -15
  618. package/dist/sdk/runtime/schema-preview.d.ts +1 -1
  619. package/dist/sdk/runtime/schema.d.ts +1 -1
  620. package/dist/sdk/runtime-action-aliases.d.ts +3 -3
  621. package/dist/sdk/runtime-extended-actions.d.ts +9 -9
  622. package/dist/sdk/runtime-input.d.ts +29 -29
  623. package/dist/sdk/runtime-primitives.d.ts +54 -52
  624. package/dist/sdk/runtime-primitives.js +1 -1
  625. package/dist/sdk/runtime-public-contracts.d.ts +46 -46
  626. package/dist/sdk/runtime-stats-options.d.ts +1 -1
  627. package/dist/sdk/runtime.d.ts +374 -374
  628. package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
  629. package/dist/sdk/schema-migration.d.ts +79 -79
  630. package/dist/sdk/schema.d.ts +224 -224
  631. package/dist/sdk/search-refresh-worker.d.ts +1 -1
  632. package/dist/sdk/similarity-scoring.d.ts +10 -10
  633. package/dist/sdk/similarity.d.ts +73 -73
  634. package/dist/sdk/start-task-status.d.ts +1 -1
  635. package/dist/sdk/stats.d.ts +72 -72
  636. package/dist/sdk/structured-mutations.d.ts +13 -13
  637. package/dist/sdk/telemetry-flush.d.ts +1 -1
  638. package/dist/sdk/telemetry.d.ts +32 -32
  639. package/dist/sdk/templates.d.ts +35 -35
  640. package/dist/sdk/test/batch.d.ts +50 -50
  641. package/dist/sdk/test/command-args.d.ts +2 -2
  642. package/dist/sdk/test/entry.d.ts +4 -4
  643. package/dist/sdk/test/execution-receipts.d.ts +5 -5
  644. package/dist/sdk/test/execution.d.ts +247 -247
  645. package/dist/sdk/test/json-path.d.ts +4 -4
  646. package/dist/sdk/test/linked-command-detection.d.ts +36 -36
  647. package/dist/sdk/test/measurements.d.ts +10 -10
  648. package/dist/sdk/test/parsers.d.ts +18 -18
  649. package/dist/sdk/test/prerequisites.d.ts +3 -3
  650. package/dist/sdk/test/runs.d.ts +43 -43
  651. package/dist/sdk/test/trust.d.ts +15 -15
  652. package/dist/sdk/test/update.d.ts +23 -23
  653. package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
  654. package/dist/sdk/testing.d.ts +250 -246
  655. package/dist/sdk/testing.js +2 -2
  656. package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
  657. package/dist/sdk/traceability/source-traceability.d.ts +50 -50
  658. package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
  659. package/dist/sdk/workspace-contracts.d.ts +20 -20
  660. package/dist/sdk/workspace-memory.d.ts +42 -42
  661. package/dist/sdk/workspace-recipe.d.ts +9 -9
  662. package/dist/sdk/workspace-snapshot.d.ts +60 -60
  663. package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
  664. package/dist/sdk/workspace-transaction.d.ts +26 -26
  665. package/dist/sdk/workspace.d.ts +9 -9
  666. package/dist/types.d.ts +540 -540
  667. package/docs/COMMANDS.md +11 -2
  668. package/docs/CONFIGURATION.md +43 -0
  669. package/docs/DEFECT_RECURRENCE.md +8 -0
  670. package/docs/EXTENSIONS.md +1 -1
  671. package/docs/EXTENSION_AUTHOR_CONTRACTS.md +33 -0
  672. package/docs/LINKED_TEST_EDITS.md +15 -0
  673. package/docs/MERGE_SAFETY.md +8 -0
  674. package/docs/RELEASING.md +2 -0
  675. package/docs/SDK.md +19 -0
  676. package/docs/TESTING.md +21 -1
  677. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +4 -3
  678. package/marketplace.json +1 -1
  679. package/package.json +3 -1
  680. package/packages/pm-beads/package.json +1 -1
  681. package/packages/pm-calendar/package.json +1 -1
  682. package/packages/pm-command-kit/package.json +1 -1
  683. package/packages/pm-digital-twin/package.json +1 -1
  684. package/packages/pm-governance-audit/package.json +1 -1
  685. package/packages/pm-guide-shell/package.json +1 -1
  686. package/packages/pm-kanban/package.json +1 -1
  687. package/packages/pm-lifecycle-hooks/package.json +1 -1
  688. package/packages/pm-linked-test-adapters/package.json +1 -1
  689. package/packages/pm-search-advanced/package.json +1 -1
  690. package/packages/pm-templates/package.json +1 -1
  691. package/packages/pm-todos/package.json +1 -1
  692. package/packages/pm-vcs/package.json +1 -1
  693. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  694. package/plugins/pm-claude/package.json +1 -1
  695. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  696. package/plugins/pm-codex/package.json +1 -1
  697. package/plugins/pm-codex/plugin.json +1 -1
  698. package/runtime-dependencies.json +1 -1
  699. package/scripts/finalize-build.mjs +9 -3
  700. package/dist/cli-bundle/chunks/chunk-DJDRHJBP.js +0 -234
  701. package/dist/cli-bundle/chunks/chunk-DUK5DHI6.js +0 -8
  702. package/dist/cli-bundle/chunks/chunk-IFPJDJUM.js +0 -20
  703. package/dist/cli-bundle/chunks/chunk-RL45OYTL.js +0 -6
  704. package/dist/cli-bundle/chunks/chunk-WYZGZV2M.js +0 -2
  705. package/dist/cli-bundle/focused-chunks/chunk-F5J3ATMV.js +0 -165
  706. package/dist/cli-bundle/focused-chunks/chunk-IOTNG6CN.js +0 -2
  707. package/dist/cli-bundle/focused-chunks/chunk-S6ITXQ5T.js +0 -20
  708. package/dist/cli-bundle/focused-chunks/chunk-UPJA45K7.js +0 -26
package/dist/types.d.ts CHANGED
@@ -4,951 +4,951 @@
4
4
  * Defines the shared project-management data model used by CLI, SDK, MCP, and packages.
5
5
  */
6
6
  /** Supported values accepted by the builtin item type contract. */
7
- export declare const BUILTIN_ITEM_TYPE_VALUES: readonly ["Epic", "Feature", "Task", "Chore", "Issue", "Decision", "Event", "Reminder", "Milestone", "Meeting", "Plan"];
7
+ export declare const BUILTIN_ITEM_TYPE_VALUES:readonly ["Epic","Feature","Task","Chore","Issue","Decision","Event","Reminder","Milestone","Meeting","Plan"];
8
8
  /** Supported values accepted by the item type contract. */
9
- export declare const ITEM_TYPE_VALUES: readonly ["Epic", "Feature", "Task", "Chore", "Issue", "Decision", "Event", "Reminder", "Milestone", "Meeting", "Plan"];
9
+ export declare const ITEM_TYPE_VALUES:readonly ["Epic","Feature","Task","Chore","Issue","Decision","Event","Reminder","Milestone","Meeting","Plan"];
10
10
  /** Restricts builtin item type values accepted by command, SDK, and storage contracts. */
11
11
  export type BuiltinItemType = (typeof BUILTIN_ITEM_TYPE_VALUES)[number];
12
12
  /** Restricts item type values accepted by command, SDK, and storage contracts. */
13
13
  export type ItemType = string;
14
14
  /** Supported values accepted by the status contract. */
15
- export declare const STATUS_VALUES: readonly ["draft", "open", "in_progress", "blocked", "closed", "canceled"];
15
+ export declare const STATUS_VALUES:readonly ["draft","open","in_progress","blocked","closed","canceled"];
16
16
  /** Restricts item status values accepted by command, SDK, and storage contracts. */
17
17
  export type ItemStatus = string;
18
18
  /** Supported values accepted by the runtime status role contract. */
19
- export declare const RUNTIME_STATUS_ROLE_VALUES: readonly ["draft", "active", "blocked", "terminal", "terminal_done", "terminal_canceled", "default_open", "default_close", "default_cancel"];
19
+ export declare const RUNTIME_STATUS_ROLE_VALUES:readonly ["draft","active","blocked","terminal","terminal_done","terminal_canceled","default_open","default_close","default_cancel"];
20
20
  /** Restricts runtime status role values accepted by command, SDK, and storage contracts. */
21
21
  export type RuntimeStatusRole = (typeof RUNTIME_STATUS_ROLE_VALUES)[number];
22
22
  /** Supported values accepted by the runtime field type contract. */
23
- export declare const RUNTIME_FIELD_TYPE_VALUES: readonly ["string", "number", "boolean", "string_array", "array", "object"];
23
+ export declare const RUNTIME_FIELD_TYPE_VALUES:readonly ["string","number","boolean","string_array","array","object"];
24
24
  /** Restricts runtime field type values accepted by command, SDK, and storage contracts. */
25
25
  export type RuntimeFieldType = (typeof RUNTIME_FIELD_TYPE_VALUES)[number];
26
26
  /** Supported values accepted by the runtime field command contract. */
27
- export declare const RUNTIME_FIELD_COMMAND_VALUES: readonly ["create", "update", "update_many", "list", "search", "calendar", "context"];
27
+ export declare const RUNTIME_FIELD_COMMAND_VALUES:readonly ["create","update","update_many","list","search","calendar","context"];
28
28
  /** Restricts runtime field command values accepted by command, SDK, and storage contracts. */
29
29
  export type RuntimeFieldCommand = (typeof RUNTIME_FIELD_COMMAND_VALUES)[number];
30
30
  /** Supported values accepted by the runtime unknown field policy contract. */
31
- export declare const RUNTIME_UNKNOWN_FIELD_POLICY_VALUES: readonly ["allow", "warn", "reject"];
31
+ export declare const RUNTIME_UNKNOWN_FIELD_POLICY_VALUES:readonly ["allow","warn","reject"];
32
32
  /** Restricts runtime unknown field policy values accepted by command, SDK, and storage contracts. */
33
33
  export type RuntimeUnknownFieldPolicy = (typeof RUNTIME_UNKNOWN_FIELD_POLICY_VALUES)[number];
34
34
  /** Built-in dependency spellings; active extensions may register additional kinds and aliases. */
35
- export declare const DEPENDENCY_KIND_VALUES: readonly ["blocks", "parent", "child", "parent_child", "child_of", "related", "related_to", "discovered_from", "blocked_by", "incident_from", "epic", "implements", "recurs_from", "supersedes", "task", "verifies"];
35
+ export declare const DEPENDENCY_KIND_VALUES:readonly ["blocks","parent","child","parent_child","child_of","related","related_to","discovered_from","blocked_by","incident_from","epic","implements","recurs_from","supersedes","task","verifies"];
36
36
  /** Relationship identifier admitted by the active built-in and extension registry. */
37
37
  export type DependencyKind = string;
38
38
  /** Supported values accepted by the scope contract. */
39
- export declare const SCOPE_VALUES: readonly ["project", "global"];
39
+ export declare const SCOPE_VALUES:readonly ["project","global"];
40
40
  /** Restricts link scope values accepted by command, SDK, and storage contracts. */
41
41
  export type LinkScope = (typeof SCOPE_VALUES)[number];
42
42
  /** Supported values accepted by the risk contract. */
43
- export declare const RISK_VALUES: readonly ["low", "medium", "high", "critical"];
43
+ export declare const RISK_VALUES:readonly ["low","medium","high","critical"];
44
44
  /** Restricts risk level values accepted by command, SDK, and storage contracts. */
45
45
  export type RiskLevel = (typeof RISK_VALUES)[number];
46
46
  /** Supported values accepted by the issue severity contract. */
47
- export declare const ISSUE_SEVERITY_VALUES: readonly ["low", "medium", "high", "critical"];
47
+ export declare const ISSUE_SEVERITY_VALUES:readonly ["low","medium","high","critical"];
48
48
  /** Restricts issue severity values accepted by command, SDK, and storage contracts. */
49
49
  export type IssueSeverity = (typeof ISSUE_SEVERITY_VALUES)[number];
50
50
  /** Supported values accepted by the confidence text contract. */
51
- export declare const CONFIDENCE_TEXT_VALUES: readonly ["low", "medium", "high"];
51
+ export declare const CONFIDENCE_TEXT_VALUES:readonly ["low","medium","high"];
52
52
  /** Restricts confidence text level values accepted by command, SDK, and storage contracts. */
53
53
  export type ConfidenceTextLevel = (typeof CONFIDENCE_TEXT_VALUES)[number];
54
54
  /** Restricts confidence value values accepted by command, SDK, and storage contracts. */
55
55
  export type ConfidenceValue = number | ConfidenceTextLevel;
56
56
  /** Supported values accepted by the item format contract. */
57
- export declare const ITEM_FORMAT_VALUES: readonly ["toon", "json_markdown"];
57
+ export declare const ITEM_FORMAT_VALUES:readonly ["toon","json_markdown"];
58
58
  /** Restricts item format values accepted by command, SDK, and storage contracts. */
59
59
  export type ItemFormat = (typeof ITEM_FORMAT_VALUES)[number];
60
60
  /** Supported values accepted by the sprint release format policy contract. */
61
- export declare const SPRINT_RELEASE_FORMAT_POLICY_VALUES: readonly ["warn", "strict_error"];
61
+ export declare const SPRINT_RELEASE_FORMAT_POLICY_VALUES:readonly ["warn","strict_error"];
62
62
  /** Restricts sprint release format policy values accepted by command, SDK, and storage contracts. */
63
63
  export type SprintReleaseFormatPolicy = (typeof SPRINT_RELEASE_FORMAT_POLICY_VALUES)[number];
64
64
  /** Supported values accepted by the parent reference policy contract. */
65
- export declare const PARENT_REFERENCE_POLICY_VALUES: readonly ["warn", "strict_error"];
65
+ export declare const PARENT_REFERENCE_POLICY_VALUES:readonly ["warn","strict_error"];
66
66
  /** Restricts parent reference policy values accepted by command, SDK, and storage contracts. */
67
67
  export type ParentReferencePolicy = (typeof PARENT_REFERENCE_POLICY_VALUES)[number];
68
68
  /** Supported values accepted by the validate metadata profile contract. */
69
- export declare const VALIDATE_METADATA_PROFILE_VALUES: readonly ["core", "strict", "custom"];
69
+ export declare const VALIDATE_METADATA_PROFILE_VALUES:readonly ["core","strict","custom"];
70
70
  /** Restricts validate metadata profile values accepted by command, SDK, and storage contracts. */
71
71
  export type ValidateMetadataProfile = (typeof VALIDATE_METADATA_PROFILE_VALUES)[number];
72
72
  /** Supported values accepted by the governance preset contract. */
73
- export declare const GOVERNANCE_PRESET_VALUES: readonly ["minimal", "default", "strict", "custom"];
73
+ export declare const GOVERNANCE_PRESET_VALUES:readonly ["minimal","default","strict","custom"];
74
74
  /** Restricts governance preset values accepted by command, SDK, and storage contracts. */
75
75
  export type GovernancePreset = (typeof GOVERNANCE_PRESET_VALUES)[number];
76
76
  /** Supported values accepted by the governance ownership enforcement contract. */
77
- export declare const GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES: readonly ["none", "warn", "strict"];
77
+ export declare const GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES:readonly ["none","warn","strict"];
78
78
  /** Restricts governance ownership enforcement values accepted by command, SDK, and storage contracts. */
79
79
  export type GovernanceOwnershipEnforcement = (typeof GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES)[number];
80
80
  /** Supported values accepted by the governance create mode default contract. */
81
- export declare const GOVERNANCE_CREATE_MODE_DEFAULT_VALUES: readonly ["progressive", "strict"];
81
+ export declare const GOVERNANCE_CREATE_MODE_DEFAULT_VALUES:readonly ["progressive","strict"];
82
82
  /** Restricts governance create mode default values accepted by command, SDK, and storage contracts. */
83
83
  export type GovernanceCreateModeDefault = (typeof GOVERNANCE_CREATE_MODE_DEFAULT_VALUES)[number];
84
84
  /** Supported values accepted by the governance close validation default contract. */
85
- export declare const GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES: readonly ["off", "warn", "strict"];
85
+ export declare const GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES:readonly ["off","warn","strict"];
86
86
  /** Restricts governance close validation default values accepted by command, SDK, and storage contracts. */
87
87
  export type GovernanceCloseValidationDefault = (typeof GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES)[number];
88
88
  /** Supported values accepted by the governance workflow enforcement contract. */
89
- export declare const GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES: readonly ["off", "warn", "strict"];
89
+ export declare const GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES:readonly ["off","warn","strict"];
90
90
  /** Restricts governance workflow enforcement values accepted by command, SDK, and storage contracts. */
91
91
  export type GovernanceWorkflowEnforcement = (typeof GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES)[number];
92
92
  /** Supported create/copy near-duplicate governance modes. */
93
- export declare const GOVERNANCE_DUPLICATE_DETECTION_MODE_VALUES: readonly ["off", "advisory", "strict"];
93
+ export declare const GOVERNANCE_DUPLICATE_DETECTION_MODE_VALUES:readonly ["off","advisory","strict"];
94
94
  /** Restricts create/copy near-duplicate governance behavior. */
95
95
  export type GovernanceDuplicateDetectionMode = (typeof GOVERNANCE_DUPLICATE_DETECTION_MODE_VALUES)[number];
96
96
  /** Supported values accepted by the validate metadata required field contract. */
97
- export declare const VALIDATE_METADATA_REQUIRED_FIELD_VALUES: readonly ["author", "acceptance_criteria", "estimated_minutes", "close_reason", "reviewer", "risk", "confidence", "sprint", "release"];
97
+ export declare const VALIDATE_METADATA_REQUIRED_FIELD_VALUES:readonly ["author","acceptance_criteria","estimated_minutes","close_reason","reviewer","risk","confidence","sprint","release"];
98
98
  /** Restricts validate metadata required field values accepted by command, SDK, and storage contracts. */
99
99
  export type ValidateMetadataRequiredField = (typeof VALIDATE_METADATA_REQUIRED_FIELD_VALUES)[number];
100
100
  /** Supported values accepted by the recurrence frequency contract. */
101
- export declare const RECURRENCE_FREQUENCY_VALUES: readonly ["daily", "weekly", "monthly", "yearly"];
101
+ export declare const RECURRENCE_FREQUENCY_VALUES:readonly ["daily","weekly","monthly","yearly"];
102
102
  /** Restricts recurrence frequency values accepted by command, SDK, and storage contracts. */
103
103
  export type RecurrenceFrequency = (typeof RECURRENCE_FREQUENCY_VALUES)[number];
104
104
  /** Supported values accepted by the recurrence weekday contract. */
105
- export declare const RECURRENCE_WEEKDAY_VALUES: readonly ["mon", "tue", "wed", "thu", "fri", "sat", "sun"];
105
+ export declare const RECURRENCE_WEEKDAY_VALUES:readonly ["mon","tue","wed","thu","fri","sat","sun"];
106
106
  /** Restricts recurrence weekday values accepted by command, SDK, and storage contracts. */
107
107
  export type RecurrenceWeekday = (typeof RECURRENCE_WEEKDAY_VALUES)[number];
108
108
  /** Canonical week-order index for a recurrence weekday (mon=0 .. sun=6). Shared by item serialization, create/update parsing, and calendar expansion so weekday ordering cannot drift between those modules. */
109
- export declare function weekdayOrderIndex(value: RecurrenceWeekday): number;
109
+ export declare function weekdayOrderIndex(value:RecurrenceWeekday):number;
110
110
  /** Documents the dependency payload exchanged by command, SDK, and package integrations. */
111
111
  export interface Dependency {
112
112
  /** Stable identifier used to reference this record across commands and storage. */
113
- id: string;
113
+ id:string;
114
114
  /** Value that configures or reports kind for this contract. */
115
- kind: DependencyKind;
115
+ kind:DependencyKind;
116
116
  /** ISO 8601 timestamp recording when created occurred. */
117
- created_at: string;
117
+ created_at:string;
118
118
  /** Value that configures or reports author for this contract. */
119
- author?: string;
119
+ author?:string;
120
120
  /** Value that configures or reports source kind for this contract. */
121
- source_kind?: string;
121
+ source_kind?:string;
122
122
  /** Whether the recorded edge author was explicitly asserted or automatically detected. */
123
- author_source?: "asserted" | "detected" | "legacy";
123
+ author_source?:"asserted" | "detected" | "legacy";
124
124
  }
125
125
  /** Documents the comment payload exchanged by command, SDK, and package integrations. */
126
126
  export interface Comment {
127
127
  /** ISO 8601 timestamp recording when created occurred. */
128
- created_at: string;
128
+ created_at:string;
129
129
  /** Value that configures or reports author for this contract. */
130
- author: string;
130
+ author:string;
131
131
  /** Value that configures or reports text for this contract. */
132
- text: string;
132
+ text:string;
133
133
  }
134
134
  /** Documents the log note payload exchanged by command, SDK, and package integrations. */
135
135
  export interface LogNote {
136
136
  /** ISO 8601 timestamp recording when created occurred. */
137
- created_at: string;
137
+ created_at:string;
138
138
  /** Value that configures or reports author for this contract. */
139
- author: string;
139
+ author:string;
140
140
  /** Value that configures or reports text for this contract. */
141
- text: string;
141
+ text:string;
142
142
  /** Structured payload format marker; absent entries remain ordinary text notes. */
143
- format?: "json";
143
+ format?:"json";
144
144
  /** Validated JSON payload for merge-safe machine-authored context events. */
145
- data?: StructuredJsonValue;
145
+ data?:StructuredJsonValue;
146
146
  /** Optional event discriminator projected from a top-level `type` property. */
147
- event_type?: string;
147
+ event_type?:string;
148
148
  }
149
149
  /** JSON value accepted by structured context-event annotations. */
150
150
  export type StructuredJsonValue = null | boolean | number | string | StructuredJsonValue[] | {
151
- [key: string]: StructuredJsonValue;
151
+ [key:string]:StructuredJsonValue;
152
152
  };
153
153
  /** Machine-readable, append-only context event stored in the union-merged notes collection. */
154
154
  export interface StructuredLogEvent extends LogNote {
155
155
  /** Discriminates structured events from free-text notes. */
156
- format: "json";
156
+ format:"json";
157
157
  /** Validated JSON payload. */
158
- data: StructuredJsonValue;
158
+ data:StructuredJsonValue;
159
159
  }
160
160
  /** Documents the linked file payload exchanged by command, SDK, and package integrations. */
161
161
  export interface LinkedFile {
162
162
  /** Filesystem path used for path resolution. */
163
- path: string;
163
+ path:string;
164
164
  /** Value that configures or reports scope for this contract. */
165
- scope: LinkScope;
165
+ scope:LinkScope;
166
166
  /** Value that configures or reports note for this contract. */
167
- note?: string;
167
+ note?:string;
168
168
  }
169
169
  /** Valid immutable provenance captured when a linked command enters tracker data. */
170
170
  export interface LinkedTestProvenance {
171
171
  /** Author identity recorded by the originating mutation. */
172
- author: string;
172
+ author:string;
173
173
  /** ISO 8601 time at which the command entered tracker data. */
174
- created_at: string;
174
+ created_at:string;
175
175
  /** Mutation path that introduced the command. */
176
- source_kind: "local_mutation" | "merge_union";
176
+ source_kind:"local_mutation" | "merge_union";
177
177
  /** Best-effort Git branch or hosted head ref of the originating mutation. */
178
- source_ref?: string;
178
+ source_ref?:string;
179
179
  }
180
180
  /** Documents the linked test payload exchanged by command, SDK, and package integrations. */
181
181
  export interface LinkedTest {
182
182
  /** Value that configures or reports command for this contract. */
183
- command?: string;
183
+ command?:string;
184
184
  /** Filesystem path used for path resolution. */
185
- path?: string;
185
+ path?:string;
186
186
  /** Value that configures or reports scope for this contract. */
187
- scope: LinkScope;
187
+ scope:LinkScope;
188
188
  /** Value that configures or reports timeout seconds for this contract. */
189
- timeout_seconds?: number;
189
+ timeout_seconds?:number;
190
190
  /** Strategy used to control pm context behavior. */
191
- pm_context_mode?: "schema" | "tracker" | "auto" | "none";
191
+ pm_context_mode?:"schema" | "tracker" | "auto" | "none";
192
192
  /** Strategy used for source-workspace visibility and command working directory. */
193
- workspace_context_mode?: "source" | "isolated" | "snapshot";
193
+ workspace_context_mode?:"source" | "isolated" | "snapshot";
194
194
  /** Immutable provenance captured when the linked command enters tracker data. */
195
- provenance?: LinkedTestProvenance;
195
+ provenance?:LinkedTestProvenance;
196
196
  /** Explicit fail-closed marker retained when stored provenance is malformed. */
197
- provenance_invalid?: true;
197
+ provenance_invalid?:true;
198
198
  /** Author of the most recent explicit metadata edit; creation provenance is retained. */
199
- updated_by?: string;
199
+ updated_by?:string;
200
200
  /** ISO timestamp of the most recent explicit metadata edit. */
201
- updated_at?: string;
201
+ updated_at?:string;
202
202
  /** Value that configures or reports env set for this contract. */
203
- env_set?: Record<string, string>;
203
+ env_set?:Record<string,string>;
204
204
  /** Value that configures or reports env clear for this contract. */
205
- env_clear?: string[];
205
+ env_clear?:string[];
206
206
  /** Value that configures or reports shared host safe for this contract. */
207
- shared_host_safe?: boolean;
207
+ shared_host_safe?:boolean;
208
208
  /** Value that configures or reports assert stdout contains for this contract. */
209
- assert_stdout_contains?: string[];
209
+ assert_stdout_contains?:string[];
210
210
  /** Value that configures or reports assert stdout regex for this contract. */
211
- assert_stdout_regex?: string[];
211
+ assert_stdout_regex?:string[];
212
212
  /** Value that configures or reports assert stderr contains for this contract. */
213
- assert_stderr_contains?: string[];
213
+ assert_stderr_contains?:string[];
214
214
  /** Value that configures or reports assert stderr regex for this contract. */
215
- assert_stderr_regex?: string[];
215
+ assert_stderr_regex?:string[];
216
216
  /** Value that configures or reports assert stdout min lines for this contract. */
217
- assert_stdout_min_lines?: number;
217
+ assert_stdout_min_lines?:number;
218
218
  /** Value that configures or reports assert json field equals for this contract. */
219
- assert_json_field_equals?: Record<string, string>;
219
+ assert_json_field_equals?:Record<string,string>;
220
220
  /** Value that configures or reports assert json field gte for this contract. */
221
- assert_json_field_gte?: Record<string, number>;
221
+ assert_json_field_gte?:Record<string,number>;
222
222
  /** Value that configures or reports note for this contract. */
223
- note?: string;
223
+ note?:string;
224
224
  }
225
225
  /** Documents the linked doc payload exchanged by command, SDK, and package integrations. */
226
226
  export interface LinkedDoc {
227
227
  /** Filesystem path used for path resolution. */
228
- path: string;
228
+ path:string;
229
229
  /** Value that configures or reports scope for this contract. */
230
- scope: LinkScope;
230
+ scope:LinkScope;
231
231
  /** Value that configures or reports note for this contract. */
232
- note?: string;
232
+ note?:string;
233
233
  }
234
234
  /** Documents the reminder payload exchanged by command, SDK, and package integrations. */
235
235
  export interface Reminder {
236
236
  /** Value that configures or reports at for this contract. */
237
- at: string;
237
+ at:string;
238
238
  /** Value that configures or reports text for this contract. */
239
- text: string;
239
+ text:string;
240
240
  }
241
241
  /** Documents the recurrence rule payload exchanged by command, SDK, and package integrations. */
242
242
  export interface RecurrenceRule {
243
243
  /** Value that configures or reports freq for this contract. */
244
- freq: RecurrenceFrequency;
244
+ freq:RecurrenceFrequency;
245
245
  /** Value that configures or reports interval for this contract. */
246
- interval?: number;
246
+ interval?:number;
247
247
  /** Value that configures or reports count for this contract. */
248
- count?: number;
248
+ count?:number;
249
249
  /** Value that configures or reports until for this contract. */
250
- until?: string;
250
+ until?:string;
251
251
  /** Value that configures or reports by weekday for this contract. */
252
- by_weekday?: RecurrenceWeekday[];
252
+ by_weekday?:RecurrenceWeekday[];
253
253
  /** Value that configures or reports by month day for this contract. */
254
- by_month_day?: number[];
254
+ by_month_day?:number[];
255
255
  /** Value that configures or reports exdates for this contract. */
256
- exdates?: string[];
256
+ exdates?:string[];
257
257
  }
258
258
  /** Documents the calendar event payload exchanged by command, SDK, and package integrations. */
259
259
  export interface CalendarEvent {
260
260
  /** ISO 8601 timestamp recording when start occurred. */
261
- start_at: string;
261
+ start_at:string;
262
262
  /** ISO 8601 timestamp recording when end occurred. */
263
- end_at?: string;
263
+ end_at?:string;
264
264
  /** Value that configures or reports title for this contract. */
265
- title?: string;
265
+ title?:string;
266
266
  /** Value that configures or reports description for this contract. */
267
- description?: string;
267
+ description?:string;
268
268
  /** Value that configures or reports location for this contract. */
269
- location?: string;
269
+ location?:string;
270
270
  /** Value that configures or reports all day for this contract. */
271
- all_day?: boolean;
271
+ all_day?:boolean;
272
272
  /** Value that configures or reports timezone for this contract. */
273
- timezone?: string;
273
+ timezone?:string;
274
274
  /** Value that configures or reports recurrence for this contract. */
275
- recurrence?: RecurrenceRule;
275
+ recurrence?:RecurrenceRule;
276
276
  }
277
277
  /** Supported values accepted by the plan mode contract. */
278
- export declare const PLAN_MODE_VALUES: readonly ["draft", "research", "review", "approved", "executing", "paused", "completed", "superseded"];
278
+ export declare const PLAN_MODE_VALUES:readonly ["draft","research","review","approved","executing","paused","completed","superseded"];
279
279
  /** Restricts plan mode values accepted by command, SDK, and storage contracts. */
280
280
  export type PlanMode = (typeof PLAN_MODE_VALUES)[number];
281
281
  /** Supported values accepted by the plan step status contract. */
282
- export declare const PLAN_STEP_STATUS_VALUES: readonly ["pending", "in_progress", "completed", "blocked", "skipped", "superseded"];
282
+ export declare const PLAN_STEP_STATUS_VALUES:readonly ["pending","in_progress","completed","blocked","skipped","superseded"];
283
283
  /** Restricts plan step status values accepted by command, SDK, and storage contracts. */
284
284
  export type PlanStepStatus = (typeof PLAN_STEP_STATUS_VALUES)[number];
285
285
  /** Supported values accepted by the plan harness contract. */
286
- export declare const PLAN_HARNESS_VALUES: readonly ["codex", "claude-code", "cursor", "generic"];
286
+ export declare const PLAN_HARNESS_VALUES:readonly ["codex","claude-code","cursor","generic"];
287
287
  /** Restricts plan harness values accepted by command, SDK, and storage contracts. */
288
288
  export type PlanHarness = (typeof PLAN_HARNESS_VALUES)[number];
289
289
  /** Supported values accepted by the plan step link kind contract. */
290
- export declare const PLAN_STEP_LINK_KIND_VALUES: readonly ["related", "blocks", "blocked_by", "depends_on", "discovered_from", "implements", "recurs_from", "verifies", "supersedes"];
290
+ export declare const PLAN_STEP_LINK_KIND_VALUES:readonly ["related","blocks","blocked_by","depends_on","discovered_from","implements","recurs_from","verifies","supersedes"];
291
291
  /** Restricts plan step link kind values accepted by command, SDK, and storage contracts. */
292
292
  export type PlanStepLinkKind = (typeof PLAN_STEP_LINK_KIND_VALUES)[number];
293
293
  /** Documents the plan step link payload exchanged by command, SDK, and package integrations. */
294
294
  export interface PlanStepLink {
295
295
  /** Stable identifier used to reference this record across commands and storage. */
296
- id: string;
296
+ id:string;
297
297
  /** Value that configures or reports kind for this contract. */
298
- kind: PlanStepLinkKind;
298
+ kind:PlanStepLinkKind;
299
299
  /** Value that configures or reports note for this contract. */
300
- note?: string;
300
+ note?:string;
301
301
  /** Value that configures or reports required before step for this contract. */
302
- required_before_step?: boolean;
302
+ required_before_step?:boolean;
303
303
  }
304
304
  /** Documents the plan step file payload exchanged by command, SDK, and package integrations. */
305
305
  export interface PlanStepFile {
306
306
  /** Filesystem path used for path resolution. */
307
- path: string;
307
+ path:string;
308
308
  /** Value that configures or reports scope for this contract. */
309
- scope?: LinkScope;
309
+ scope?:LinkScope;
310
310
  /** Value that configures or reports note for this contract. */
311
- note?: string;
311
+ note?:string;
312
312
  }
313
313
  /** Documents the plan step test payload exchanged by command, SDK, and package integrations. */
314
314
  export interface PlanStepTest {
315
315
  /** Value that configures or reports command for this contract. */
316
- command?: string;
316
+ command?:string;
317
317
  /** Filesystem path used for path resolution. */
318
- path?: string;
318
+ path?:string;
319
319
  /** Value that configures or reports note for this contract. */
320
- note?: string;
320
+ note?:string;
321
321
  }
322
322
  /** Documents the plan step doc payload exchanged by command, SDK, and package integrations. */
323
323
  export interface PlanStepDoc {
324
324
  /** Filesystem path used for path resolution. */
325
- path: string;
325
+ path:string;
326
326
  /** Value that configures or reports scope for this contract. */
327
- scope?: LinkScope;
327
+ scope?:LinkScope;
328
328
  /** Value that configures or reports note for this contract. */
329
- note?: string;
329
+ note?:string;
330
330
  }
331
331
  /** Documents the plan step payload exchanged by command, SDK, and package integrations. */
332
332
  export interface PlanStep {
333
333
  /** Stable identifier used to reference this record across commands and storage. */
334
- id: string;
334
+ id:string;
335
335
  /** Value that configures or reports order for this contract. */
336
- order: number;
336
+ order:number;
337
337
  /** Value that configures or reports title for this contract. */
338
- title: string;
338
+ title:string;
339
339
  /** Value that configures or reports body for this contract. */
340
- body?: string;
340
+ body?:string;
341
341
  /** Lifecycle state reported for status. */
342
- status: PlanStepStatus;
342
+ status:PlanStepStatus;
343
343
  /** Value that configures or reports owner for this contract. */
344
- owner?: string;
344
+ owner?:string;
345
345
  /** Value that configures or reports evidence for this contract. */
346
- evidence?: string;
346
+ evidence?:string;
347
347
  /** Value that configures or reports blocked reason for this contract. */
348
- blocked_reason?: string;
348
+ blocked_reason?:string;
349
349
  /** Value that configures or reports superseded by for this contract. */
350
- superseded_by?: string;
350
+ superseded_by?:string;
351
351
  /** Value that configures or reports linked items for this contract. */
352
- linked_items?: PlanStepLink[];
352
+ linked_items?:PlanStepLink[];
353
353
  /** Value that configures or reports files for this contract. */
354
- files?: PlanStepFile[];
354
+ files?:PlanStepFile[];
355
355
  /** Value that configures or reports tests for this contract. */
356
- tests?: PlanStepTest[];
356
+ tests?:PlanStepTest[];
357
357
  /** Value that configures or reports docs for this contract. */
358
- docs?: PlanStepDoc[];
358
+ docs?:PlanStepDoc[];
359
359
  /** ISO 8601 timestamp recording when created occurred. */
360
- created_at: string;
360
+ created_at:string;
361
361
  /** ISO 8601 timestamp recording when updated occurred. */
362
- updated_at: string;
362
+ updated_at:string;
363
363
  /** ISO 8601 timestamp recording when completed occurred. */
364
- completed_at?: string;
364
+ completed_at?:string;
365
365
  }
366
366
  /** Documents the plan decision payload exchanged by command, SDK, and package integrations. */
367
367
  export interface PlanDecision {
368
368
  /** Value that configures or reports ts for this contract. */
369
- ts: string;
369
+ ts:string;
370
370
  /** Value that configures or reports author for this contract. */
371
- author: string;
371
+ author:string;
372
372
  /** Value that configures or reports decision for this contract. */
373
- decision: string;
373
+ decision:string;
374
374
  /** Value that configures or reports rationale for this contract. */
375
- rationale?: string;
375
+ rationale?:string;
376
376
  /** Value that configures or reports evidence for this contract. */
377
- evidence?: string;
377
+ evidence?:string;
378
378
  /** Value that configures or reports step id for this contract. */
379
- step_id?: string;
379
+ step_id?:string;
380
380
  }
381
381
  /** Documents the plan discovery payload exchanged by command, SDK, and package integrations. */
382
382
  export interface PlanDiscovery {
383
383
  /** Value that configures or reports ts for this contract. */
384
- ts: string;
384
+ ts:string;
385
385
  /** Value that configures or reports author for this contract. */
386
- author: string;
386
+ author:string;
387
387
  /** Value that configures or reports text for this contract. */
388
- text: string;
388
+ text:string;
389
389
  /** Value that configures or reports step id for this contract. */
390
- step_id?: string;
390
+ step_id?:string;
391
391
  }
392
392
  /** Documents the plan validation check payload exchanged by command, SDK, and package integrations. */
393
393
  export interface PlanValidationCheck {
394
394
  /** Value that configures or reports text for this contract. */
395
- text: string;
395
+ text:string;
396
396
  /** Value that configures or reports command for this contract. */
397
- command?: string;
397
+ command?:string;
398
398
  /** Value that configures or reports expected for this contract. */
399
- expected?: string;
399
+ expected?:string;
400
400
  }
401
401
  /** Documents the item type option definition payload exchanged by command, SDK, and package integrations. */
402
402
  export interface ItemTypeOptionDefinition {
403
403
  /** Value that configures or reports key for this contract. */
404
- key: string;
404
+ key:string;
405
405
  /** Value that configures or reports values for this contract. */
406
- values: string[];
406
+ values:string[];
407
407
  /** Value that configures or reports required for this contract. */
408
- required?: boolean;
408
+ required?:boolean;
409
409
  /** Value that configures or reports aliases for this contract. */
410
- aliases?: string[];
410
+ aliases?:string[];
411
411
  /** Value that configures or reports description for this contract. */
412
- description?: string;
412
+ description?:string;
413
413
  }
414
414
  /** Documents the item type command option policy payload exchanged by command, SDK, and package integrations. */
415
415
  export interface ItemTypeCommandOptionPolicy {
416
416
  /** Value that configures or reports command for this contract. */
417
- command: "create" | "update";
417
+ command:"create" | "update";
418
418
  /** Value that configures or reports option for this contract. */
419
- option: string;
419
+ option:string;
420
420
  /** Value that configures or reports required for this contract. */
421
- required?: boolean;
421
+ required?:boolean;
422
422
  /** Value that configures or reports visible for this contract. */
423
- visible?: boolean;
423
+ visible?:boolean;
424
424
  /** Whether enabled applies to this operation. */
425
- enabled?: boolean;
425
+ enabled?:boolean;
426
426
  }
427
427
  /** Documents the item type definition payload exchanged by command, SDK, and package integrations. */
428
428
  export interface ItemTypeDefinition {
429
429
  /** Value that configures or reports name for this contract. */
430
- name: string;
430
+ name:string;
431
431
  /** Value that configures or reports description for this contract. */
432
- description?: string;
432
+ description?:string;
433
433
  /** Status assigned to newly created items of this type when `--status` is not provided. Falls back to the workflow's open status when unset or invalid. */
434
- default_status?: string;
434
+ default_status?:string;
435
435
  /** Agent work can be dispatched automatically; human work needs a decision, and gates track outcomes. Omission inherits the built-in role or defaults custom types to agent work. */
436
- execution_role?: "agent" | "human" | "gate";
436
+ execution_role?:"agent" | "human" | "gate";
437
437
  /** Value that configures or reports folder for this contract. */
438
- folder?: string;
438
+ folder?:string;
439
439
  /** Value that configures or reports aliases for this contract. */
440
- aliases?: string[];
440
+ aliases?:string[];
441
441
  /** Value that configures or reports required create fields for this contract. */
442
- required_create_fields?: string[];
442
+ required_create_fields?:string[];
443
443
  /** Value that configures or reports required create repeatables for this contract. */
444
- required_create_repeatables?: string[];
444
+ required_create_repeatables?:string[];
445
445
  /** Value that configures or reports options for this contract. */
446
- options?: ItemTypeOptionDefinition[];
446
+ options?:ItemTypeOptionDefinition[];
447
447
  /** Value that configures or reports command option policies for this contract. */
448
- command_option_policies?: ItemTypeCommandOptionPolicy[];
448
+ command_option_policies?:ItemTypeCommandOptionPolicy[];
449
449
  }
450
450
  /** Documents the runtime status definition payload exchanged by command, SDK, and package integrations. */
451
451
  export interface RuntimeStatusDefinition {
452
452
  /** Stable identifier used to reference this record across commands and storage. */
453
- id: string;
453
+ id:string;
454
454
  /** Value that configures or reports aliases for this contract. */
455
- aliases?: string[];
455
+ aliases?:string[];
456
456
  /** Value that configures or reports roles for this contract. */
457
- roles?: RuntimeStatusRole[];
457
+ roles?:RuntimeStatusRole[];
458
458
  /** Value that configures or reports description for this contract. */
459
- description?: string;
459
+ description?:string;
460
460
  /** Value that configures or reports order for this contract. */
461
- order?: number;
461
+ order?:number;
462
462
  }
463
463
  /** Declarative JSON-value constraints enforced before custom-field persistence. */
464
464
  export interface RuntimeFieldValueSchema {
465
465
  /** Optional JSON value type constraint. */
466
- type?: "string" | "number" | "boolean" | "array" | "object";
466
+ type?:"string" | "number" | "boolean" | "array" | "object";
467
467
  /** Exact JSON value required by this schema branch. */
468
- const?: StructuredJsonValue;
468
+ const?:StructuredJsonValue;
469
469
  /** Complete allowed JSON value set. */
470
- enum?: StructuredJsonValue[];
470
+ enum?:StructuredJsonValue[];
471
471
  /** Minimum accepted string length. */
472
- min_length?: number;
472
+ min_length?:number;
473
473
  /** Minimum accepted array length. */
474
- min_items?: number;
474
+ min_items?:number;
475
475
  /** Optional semantic string format. */
476
- format?: "date-time";
476
+ format?:"date-time";
477
477
  /** Object-property schemas keyed by the persisted property name. */
478
- properties?: Record<string, RuntimeFieldValueSchema>;
478
+ properties?:Record<string,RuntimeFieldValueSchema>;
479
479
  /** Object properties that must be present. */
480
- required?: string[];
480
+ required?:string[];
481
481
  /** Whether properties absent from `properties` are accepted. */
482
- additional_properties?: boolean;
482
+ additional_properties?:boolean;
483
483
  /** Schema applied to every array element. */
484
- items?: RuntimeFieldValueSchema;
484
+ items?:RuntimeFieldValueSchema;
485
485
  /** Alternative schemas of which exactly one must match. */
486
- one_of?: RuntimeFieldValueSchema[];
486
+ one_of?:RuntimeFieldValueSchema[];
487
487
  }
488
488
  /** Documents the runtime field definition payload exchanged by command, SDK, and package integrations. */
489
489
  export interface RuntimeFieldDefinition {
490
490
  /** Value that configures or reports key for this contract. */
491
- key: string;
491
+ key:string;
492
492
  /** Value that configures or reports metadata key for this contract. */
493
- metadata_key?: string;
493
+ metadata_key?:string;
494
494
  /**
495
495
  * @deprecated Use metadata_key.
496
496
  */
497
- front_matter_key?: string;
497
+ front_matter_key?:string;
498
498
  /** Value that configures or reports cli flag for this contract. */
499
- cli_flag?: string;
499
+ cli_flag?:string;
500
500
  /** Value that configures or reports cli aliases for this contract. */
501
- cli_aliases?: string[];
501
+ cli_aliases?:string[];
502
502
  /** Value that configures or reports description for this contract. */
503
- description?: string;
503
+ description?:string;
504
504
  /** Schema type that determines the shape and validation rules for this value. */
505
- type?: RuntimeFieldType;
505
+ type?:RuntimeFieldType;
506
506
  /** Value that configures or reports commands for this contract. */
507
- commands?: RuntimeFieldCommand[];
507
+ commands?:RuntimeFieldCommand[];
508
508
  /** Value that configures or reports repeatable for this contract. */
509
- repeatable?: boolean;
509
+ repeatable?:boolean;
510
510
  /** Value that configures or reports required for this contract. */
511
- required?: boolean;
511
+ required?:boolean;
512
512
  /** Value that configures or reports required on create for this contract. */
513
- required_on_create?: boolean;
513
+ required_on_create?:boolean;
514
514
  /** Value that configures or reports required types for this contract. */
515
- required_types?: string[];
515
+ required_types?:string[];
516
516
  /** Value that configures or reports allow unset for this contract. */
517
- allow_unset?: boolean;
517
+ allow_unset?:boolean;
518
518
  /** Optional semantic JSON-value constraints enforced on create and update. */
519
- value_schema?: RuntimeFieldValueSchema;
519
+ value_schema?:RuntimeFieldValueSchema;
520
520
  }
521
521
  /** Documents the runtime workflow definition payload exchanged by command, SDK, and package integrations. */
522
522
  export interface RuntimeWorkflowDefinition {
523
523
  /** Configured status id representing the draft lifecycle state. */
524
- draft_status?: string;
524
+ draft_status?:string;
525
525
  /** Configured status id representing the open lifecycle state. */
526
- open_status?: string;
526
+ open_status?:string;
527
527
  /** Configured status id representing the in-progress lifecycle state. */
528
- in_progress_status?: string;
528
+ in_progress_status?:string;
529
529
  /** Configured status id representing the blocked lifecycle state. */
530
- blocked_status?: string;
530
+ blocked_status?:string;
531
531
  /** Configured status id representing the closed lifecycle state. */
532
- close_status?: string;
532
+ close_status?:string;
533
533
  /** Configured status id representing the canceled lifecycle state. */
534
- canceled_status?: string;
534
+ canceled_status?:string;
535
535
  }
536
536
  /** Documents the runtime schema file config payload exchanged by command, SDK, and package integrations. */
537
537
  export interface RuntimeSchemaFileConfig {
538
538
  /** Value that configures or reports types for this contract. */
539
- types?: string;
539
+ types?:string;
540
540
  /** Value that configures or reports statuses for this contract. */
541
- statuses?: string;
541
+ statuses?:string;
542
542
  /** Value that configures or reports fields for this contract. */
543
- fields?: string;
543
+ fields?:string;
544
544
  /** Value that configures or reports workflows for this contract. */
545
- workflows?: string;
545
+ workflows?:string;
546
546
  }
547
547
  /** Per-type allowed-transition rule. A type with no matching entry is unrestricted; a type with an entry allows only the listed [from, to] status pairs (status tokens are resolved case-insensitively through the status registry alias map; a same-status no-op is always allowed). */
548
548
  export interface TypeWorkflowDefinition {
549
549
  /** Schema type that determines the shape and validation rules for this value. */
550
- type: string;
550
+ type:string;
551
551
  /** Value that configures or reports allowed transitions for this contract. */
552
- allowed_transitions: [string, string][];
552
+ allowed_transitions:[string,string][];
553
553
  }
554
554
  /** Documents the runtime schema settings payload exchanged by command, SDK, and package integrations. */
555
555
  export interface RuntimeSchemaSettings {
556
556
  /** Value that configures or reports version for this contract. */
557
- version: number;
557
+ version:number;
558
558
  /** Value that configures or reports files for this contract. */
559
- files: RuntimeSchemaFileConfig;
559
+ files:RuntimeSchemaFileConfig;
560
560
  /** Value that configures or reports statuses for this contract. */
561
- statuses: RuntimeStatusDefinition[];
561
+ statuses:RuntimeStatusDefinition[];
562
562
  /** Value that configures or reports fields for this contract. */
563
- fields: RuntimeFieldDefinition[];
563
+ fields:RuntimeFieldDefinition[];
564
564
  /** Value that configures or reports workflow for this contract. */
565
- workflow: RuntimeWorkflowDefinition;
565
+ workflow:RuntimeWorkflowDefinition;
566
566
  /** Value that configures or reports type workflows for this contract. */
567
- type_workflows?: TypeWorkflowDefinition[];
567
+ type_workflows?:TypeWorkflowDefinition[];
568
568
  /** Value that configures or reports unknown field policy for this contract. */
569
- unknown_field_policy: RuntimeUnknownFieldPolicy;
569
+ unknown_field_policy:RuntimeUnknownFieldPolicy;
570
570
  }
571
571
  /** Documents the item test run summary payload exchanged by command, SDK, and package integrations. */
572
572
  export interface TestRunMeasurement {
573
573
  /** Stable metric name, such as coverage or p95_latency. */
574
- name: string;
574
+ name:string;
575
575
  /** Numeric value recorded by the producing verification run. */
576
- value: number;
576
+ value:number;
577
577
  /** Optional domain-specific unit, such as percent, ms, bytes, or count. */
578
- unit?: string;
578
+ unit?:string;
579
579
  /** Optional pass/fail or budget threshold associated with the measurement. */
580
- threshold?: number;
580
+ threshold?:number;
581
581
  /** ISO 8601 timestamp binding the measurement to its producing run. */
582
- recorded_at: string;
582
+ recorded_at:string;
583
583
  }
584
584
  /** Bounded command and tracker-context provenance for one linked-test execution. */
585
585
  export interface ItemTestRunExecution {
586
586
  /** Exact linked command selected for execution. */
587
- command: string;
587
+ command:string;
588
588
  /** Context mode requested before linked-test overrides or auto-remediation. */
589
- requested_pm_context_mode?: "schema" | "tracker" | "auto" | "none";
589
+ requested_pm_context_mode?:"schema" | "tracker" | "auto" | "none";
590
590
  /** Effective context mode used by the linked command. */
591
- pm_context_mode?: "schema" | "tracker" | "auto" | "none";
591
+ pm_context_mode?:"schema" | "tracker" | "auto" | "none";
592
592
  /** Effective source-workspace mode used by the linked command. */
593
- workspace_context_mode?: "source" | "isolated" | "snapshot";
593
+ workspace_context_mode?:"source" | "isolated" | "snapshot";
594
594
  /** Trust classification applied before execution. */
595
- trust_reason?: "legacy" | "local_mutation" | "local_source_ref" | "acknowledged" | "invalid_provenance" | "foreign_source_ref";
595
+ trust_reason?:"legacy" | "local_mutation" | "local_source_ref" | "acknowledged" | "invalid_provenance" | "foreign_source_ref";
596
596
  }
597
597
  /** Documents the item test run summary payload exchanged by command, SDK, and package integrations. */
598
598
  export interface ItemTestRunSummary {
599
599
  /** Executes the id operation through the package runtime. */
600
- run_id: string;
600
+ run_id:string;
601
601
  /** Value that configures or reports kind for this contract. */
602
- kind: "test" | "test-all";
602
+ kind:"test" | "test-all";
603
603
  /** Lifecycle state reported for status. */
604
- status: "passed" | "failed" | "stopped" | "canceled";
604
+ status:"passed" | "failed" | "stopped" | "canceled";
605
605
  /** ISO 8601 timestamp recording when started occurred. */
606
- started_at: string;
606
+ started_at:string;
607
607
  /** ISO 8601 timestamp recording when finished occurred. */
608
- finished_at: string;
608
+ finished_at:string;
609
609
  /** ISO 8601 timestamp recording when recorded occurred. */
610
- recorded_at: string;
610
+ recorded_at:string;
611
611
  /** Value that configures or reports attempt for this contract. */
612
- attempt?: number;
612
+ attempt?:number;
613
613
  /** Value that configures or reports resumed from for this contract. */
614
- resumed_from?: string;
614
+ resumed_from?:string;
615
615
  /** Value that configures or reports passed for this contract. */
616
- passed: number;
616
+ passed:number;
617
617
  /** Value that configures or reports failed for this contract. */
618
- failed: number;
618
+ failed:number;
619
619
  /** Value that configures or reports skipped for this contract. */
620
- skipped: number;
620
+ skipped:number;
621
621
  /** Value that configures or reports items for this contract. */
622
- items?: number;
622
+ items?:number;
623
623
  /** Value that configures or reports linked tests for this contract. */
624
- linked_tests?: number;
624
+ linked_tests?:number;
625
625
  /** Value that configures or reports fail on skipped triggered for this contract. */
626
- fail_on_skipped_triggered?: boolean;
626
+ fail_on_skipped_triggered?:boolean;
627
627
  /** Bounded, deterministic quantitative evidence produced by this run. */
628
- measurements?: TestRunMeasurement[];
628
+ measurements?:TestRunMeasurement[];
629
629
  /** Commands and effective tracker contexts bound to this recorded run. */
630
- executions?: ItemTestRunExecution[];
630
+ executions?:ItemTestRunExecution[];
631
631
  }
632
632
  /** Documents the item metadata payload exchanged by command, SDK, and package integrations. */
633
633
  export interface ItemMetadata {
634
634
  /** Stable identifier used to reference this record across commands and storage. */
635
- id: string;
635
+ id:string;
636
636
  /** Value that configures or reports title for this contract. */
637
- title: string;
637
+ title:string;
638
638
  /** Value that configures or reports description for this contract. */
639
- description: string;
639
+ description:string;
640
640
  /** Schema type that determines the shape and validation rules for this value. */
641
- type: ItemType;
641
+ type:ItemType;
642
642
  /** On-disk item-metadata format version. Absent means the implicit baseline (version 1) and is never serialized; populated only once an item advances past the baseline via a future storage migration. See core/item/item-format-version. */
643
- pm_format_version?: number;
643
+ pm_format_version?:number;
644
644
  /** Schema type that determines the shape and validation rules for this value. */
645
- source_type?: string;
645
+ source_type?:string;
646
646
  /** Inputs that customize the type operation. */
647
- type_options?: Record<string, string>;
647
+ type_options?:Record<string,string>;
648
648
  /** Lifecycle state reported for status. */
649
- status: ItemStatus;
649
+ status:ItemStatus;
650
650
  /** Value that configures or reports priority for this contract. */
651
- priority: 0 | 1 | 2 | 3 | 4;
651
+ priority:0 | 1 | 2 | 3 | 4;
652
652
  /** Value that configures or reports tags for this contract. */
653
- tags: string[];
653
+ tags:string[];
654
654
  /** ISO 8601 timestamp recording when created occurred. */
655
- created_at: string;
655
+ created_at:string;
656
656
  /** ISO 8601 timestamp recording when updated occurred. */
657
- updated_at: string;
657
+ updated_at:string;
658
658
  /** Value that configures or reports deadline for this contract. */
659
- deadline?: string;
659
+ deadline?:string;
660
660
  /** Value that configures or reports reminders for this contract. */
661
- reminders?: Reminder[];
661
+ reminders?:Reminder[];
662
662
  /** Value that configures or reports events for this contract. */
663
- events?: CalendarEvent[];
663
+ events?:CalendarEvent[];
664
664
  /** ISO 8601 timestamp recording when closed occurred. */
665
- closed_at?: string;
665
+ closed_at?:string;
666
666
  /** ISO 8601 timestamp recording when the work actually completed. */
667
- completed_at?: string;
667
+ completed_at?:string;
668
668
  /** Value that configures or reports assignee for this contract. */
669
- assignee?: string;
669
+ assignee?:string;
670
670
  /** Internal privacy-safe ownership principal for concurrent agent sessions. */
671
- claim_principal?: string;
671
+ claim_principal?:string;
672
672
  /** Value that configures or reports source owner for this contract. */
673
- source_owner?: string;
673
+ source_owner?:string;
674
674
  /** Value that configures or reports author for this contract. */
675
- author?: string;
675
+ author?:string;
676
676
  /** Value that configures or reports estimated minutes for this contract. */
677
- estimated_minutes?: number;
677
+ estimated_minutes?:number;
678
678
  /** Value that configures or reports acceptance criteria for this contract. */
679
- acceptance_criteria?: string;
679
+ acceptance_criteria?:string;
680
680
  /** Value that configures or reports design for this contract. */
681
- design?: string;
681
+ design?:string;
682
682
  /** Value that configures or reports external ref for this contract. */
683
- external_ref?: string;
683
+ external_ref?:string;
684
684
  /** Value that configures or reports definition of ready for this contract. */
685
- definition_of_ready?: string;
685
+ definition_of_ready?:string;
686
686
  /** Value that configures or reports order for this contract. */
687
- order?: number;
687
+ order?:number;
688
688
  /** Value that configures or reports goal for this contract. */
689
- goal?: string;
689
+ goal?:string;
690
690
  /** Value that configures or reports objective for this contract. */
691
- objective?: string;
691
+ objective?:string;
692
692
  /** Value that configures or reports value for this contract. */
693
- value?: string;
693
+ value?:string;
694
694
  /** Value that configures or reports impact for this contract. */
695
- impact?: string;
695
+ impact?:string;
696
696
  /** Value that configures or reports outcome for this contract. */
697
- outcome?: string;
697
+ outcome?:string;
698
698
  /** Value that configures or reports why now for this contract. */
699
- why_now?: string;
699
+ why_now?:string;
700
700
  /** Value that configures or reports parent for this contract. */
701
- parent?: string;
701
+ parent?:string;
702
702
  /** Value that configures or reports reviewer for this contract. */
703
- reviewer?: string;
703
+ reviewer?:string;
704
704
  /** Value that configures or reports risk for this contract. */
705
- risk?: RiskLevel;
705
+ risk?:RiskLevel;
706
706
  /** Value that configures or reports confidence for this contract. */
707
- confidence?: ConfidenceValue;
707
+ confidence?:ConfidenceValue;
708
708
  /** Value that configures or reports sprint for this contract. */
709
- sprint?: string;
709
+ sprint?:string;
710
710
  /** Value that configures or reports release for this contract. */
711
- release?: string;
711
+ release?:string;
712
712
  /** Value that configures or reports blocked by for this contract. */
713
- blocked_by?: string;
713
+ blocked_by?:string;
714
714
  /** Value that configures or reports blocked reason for this contract. */
715
- blocked_reason?: string;
715
+ blocked_reason?:string;
716
716
  /** Value that configures or reports unblock note for this contract. */
717
- unblock_note?: string;
717
+ unblock_note?:string;
718
718
  /** Value that configures or reports reporter for this contract. */
719
- reporter?: string;
719
+ reporter?:string;
720
720
  /** Value that configures or reports severity for this contract. */
721
- severity?: IssueSeverity;
721
+ severity?:IssueSeverity;
722
722
  /** Value that configures or reports environment for this contract. */
723
- environment?: string;
723
+ environment?:string;
724
724
  /** Value that configures or reports repro steps for this contract. */
725
- repro_steps?: string;
725
+ repro_steps?:string;
726
726
  /** Value that configures or reports resolution for this contract. */
727
- resolution?: string;
727
+ resolution?:string;
728
728
  /** Structured result returned by the expected operation. */
729
- expected_result?: string;
729
+ expected_result?:string;
730
730
  /** Structured result returned by the actual operation. */
731
- actual_result?: string;
731
+ actual_result?:string;
732
732
  /** Value that configures or reports affected version for this contract. */
733
- affected_version?: string;
733
+ affected_version?:string;
734
734
  /** Value that configures or reports fixed version for this contract. */
735
- fixed_version?: string;
735
+ fixed_version?:string;
736
736
  /** Value that configures or reports component for this contract. */
737
- component?: string;
737
+ component?:string;
738
738
  /** Value that configures or reports regression for this contract. */
739
- regression?: boolean;
739
+ regression?:boolean;
740
740
  /** Value that configures or reports customer impact for this contract. */
741
- customer_impact?: string;
741
+ customer_impact?:string;
742
742
  /** Value that configures or reports dependencies for this contract. */
743
- dependencies?: Dependency[];
743
+ dependencies?:Dependency[];
744
744
  /** Value that configures or reports comments for this contract. */
745
- comments?: Comment[];
745
+ comments?:Comment[];
746
746
  /** Value that configures or reports notes for this contract. */
747
- notes?: LogNote[];
747
+ notes?:LogNote[];
748
748
  /** Value that configures or reports learnings for this contract. */
749
- learnings?: LogNote[];
749
+ learnings?:LogNote[];
750
750
  /** Value that configures or reports files for this contract. */
751
- files?: LinkedFile[];
751
+ files?:LinkedFile[];
752
752
  /** Value that configures or reports tests for this contract. */
753
- tests?: LinkedTest[];
753
+ tests?:LinkedTest[];
754
754
  /** Value that configures or reports test runs for this contract. */
755
- test_runs?: ItemTestRunSummary[];
755
+ test_runs?:ItemTestRunSummary[];
756
756
  /** Value that configures or reports docs for this contract. */
757
- docs?: LinkedDoc[];
757
+ docs?:LinkedDoc[];
758
758
  /** Value that configures or reports close reason for this contract. */
759
- close_reason?: string;
759
+ close_reason?:string;
760
760
  /** Value that configures or reports duplicate of for this contract. */
761
- duplicate_of?: string;
761
+ duplicate_of?:string;
762
762
  /** Strategy used to control plan behavior. */
763
- plan_mode?: PlanMode;
763
+ plan_mode?:PlanMode;
764
764
  /** Value that configures or reports plan scope for this contract. */
765
- plan_scope?: string;
765
+ plan_scope?:string;
766
766
  /** Value that configures or reports plan harness for this contract. */
767
- plan_harness?: PlanHarness;
767
+ plan_harness?:PlanHarness;
768
768
  /** Value that configures or reports plan steps for this contract. */
769
- plan_steps?: PlanStep[];
769
+ plan_steps?:PlanStep[];
770
770
  /** Value that configures or reports plan decisions for this contract. */
771
- plan_decisions?: PlanDecision[];
771
+ plan_decisions?:PlanDecision[];
772
772
  /** Value that configures or reports plan discoveries for this contract. */
773
- plan_discoveries?: PlanDiscovery[];
773
+ plan_discoveries?:PlanDiscovery[];
774
774
  /** Value that configures or reports plan validation for this contract. */
775
- plan_validation?: PlanValidationCheck[];
775
+ plan_validation?:PlanValidationCheck[];
776
776
  /** Value that configures or reports plan resume context for this contract. */
777
- plan_resume_context?: string;
778
- [key: string]: unknown;
777
+ plan_resume_context?:string;
778
+ [key:string]:unknown;
779
779
  }
780
780
  /** Documents the item document payload exchanged by command, SDK, and package integrations. */
781
781
  export interface ItemDocument {
782
782
  /** Value that configures or reports metadata for this contract. */
783
- metadata: ItemMetadata;
783
+ metadata:ItemMetadata;
784
784
  /** Value that configures or reports body for this contract. */
785
- body: string;
785
+ body:string;
786
786
  }
787
787
  /** Documents the history patch op payload exchanged by command, SDK, and package integrations. */
788
788
  export interface HistoryPatchOp {
789
789
  /** Value that configures or reports op for this contract. */
790
- op: "add" | "remove" | "replace" | "move" | "copy" | "test";
790
+ op:"add" | "remove" | "replace" | "move" | "copy" | "test";
791
791
  /** Filesystem path used for path resolution. */
792
- path: string;
792
+ path:string;
793
793
  /** Value that configures or reports from for this contract. */
794
- from?: string;
794
+ from?:string;
795
795
  /** Value that configures or reports value for this contract. */
796
- value?: unknown;
796
+ value?:unknown;
797
797
  }
798
798
  /** Immutable evidence retained whenever history maintenance replaces anchors or patch operations. */
799
799
  export interface HistoryReanchorEvidence {
800
800
  /** Algorithm of the retained item and record anchors; absent means SHA-256. */
801
- hash_algorithm?: string;
801
+ hash_algorithm?:string;
802
802
  /** Before-state anchor present on the record before re-anchoring. */
803
- before_hash: string;
803
+ before_hash:string;
804
804
  /** After-state anchor present on the record before re-anchoring. */
805
- after_hash: string;
805
+ after_hash:string;
806
806
  /** Item hash epoch present before re-anchoring. */
807
- item_hash_version?: number;
807
+ item_hash_version?:number;
808
808
  /** Hash of the original patch, retained even when redaction forbids retaining its values. */
809
- patch_hash: string;
809
+ patch_hash:string;
810
810
  /** Original patch operations when repair replaced or skipped recorded intent. */
811
- patch?: HistoryPatchOp[];
811
+ patch?:HistoryPatchOp[];
812
812
  /** Record-integrity epoch protecting the pre-re-anchor record. */
813
- record_hash_version?: number;
813
+ record_hash_version?:number;
814
814
  /** Record hash protecting the pre-re-anchor attribution and operation metadata. */
815
- record_hash?: string;
815
+ record_hash?:string;
816
816
  /** Exact prior sealed record when maintenance can retain its non-sensitive payload. */
817
- record?: HistoryEntry;
817
+ record?:HistoryEntry;
818
818
  }
819
819
  /** Documents the history entry payload exchanged by command, SDK, and package integrations. */
820
820
  export interface HistoryEntry {
821
821
  /** Algorithm for before_hash, after_hash and record_hash; absent means legacy SHA-256. */
822
- hash_algorithm?: string;
822
+ hash_algorithm?:string;
823
823
  /** Value that configures or reports ts for this contract. */
824
- ts: string;
824
+ ts:string;
825
825
  /** Value that configures or reports author for this contract. */
826
- author: string;
826
+ author:string;
827
827
  /** Provenance of the author selected for this event. Absent only on legacy entries. */
828
- author_source?: "asserted" | "configured" | "detected" | "unknown";
828
+ author_source?:"asserted" | "configured" | "detected" | "unknown";
829
829
  /** Observed agent harness, independent from the effective author precedence. */
830
- agent_harness?: string;
830
+ agent_harness?:string;
831
831
  /** Observed agent model identifier, retained in local history. */
832
- agent_model?: string;
832
+ agent_model?:string;
833
833
  /** Bounded signal class that supplied `agent_model`. */
834
- agent_model_source?: "override" | "environment" | "mcp_client" | "argv" | "host" | "session" | "probe" | "inferred";
834
+ agent_model_source?:"override" | "environment" | "mcp_client" | "argv" | "host" | "session" | "probe" | "inferred";
835
835
  /** Privacy-safe fingerprint distinguishing concurrent harness invocations. */
836
- agent_instance?: string;
836
+ agent_instance?:string;
837
837
  /** Extensible local-only descriptive agent provenance; null means declared but unavailable. */
838
- agent_provenance?: Readonly<Record<string, {
838
+ agent_provenance?:Readonly<Record<string,{
839
839
  /** Bounded descriptive value observed for this dimension. */
840
- value: string;
840
+ value:string;
841
841
  /** Bounded signal class that supplied the value. */
842
- source: "override" | "environment" | "mcp_client" | "argv" | "host" | "session" | "probe" | "inferred";
842
+ source:"override" | "environment" | "mcp_client" | "argv" | "host" | "session" | "probe" | "inferred";
843
843
  /** Confidence attached to a semantic inference. */
844
- confidence?: "high" | "medium" | "low";
844
+ confidence?:"high" | "medium" | "low";
845
845
  /** Versioned semantic inference rule. */
846
- rule_version?: "v2";
846
+ rule_version?:"v2";
847
847
  /** Bounded item and lineage references supporting the inference. */
848
- evidence?: readonly string[];
848
+ evidence?:readonly string[];
849
849
  } | null>>;
850
850
  /** Stable declared episode identity; absent on legacy or undeclared events. */
851
- agent_episode?: {
851
+ agent_episode?:{
852
852
  /** Stable caller-declared episode join key. */
853
- id: string;
853
+ id:string;
854
854
  /** Human-readable episode purpose retained in local history. */
855
- label?: string;
855
+ label?:string;
856
856
  /** Parent episode key for delegated or nested work. */
857
- parent_id?: string;
857
+ parent_id?:string;
858
858
  };
859
859
  /** Value that configures or reports op for this contract. */
860
- op: string;
860
+ op:string;
861
861
  /** Declared semantic effect used by recency consumers. Absent on legacy entries. */
862
- event_class?: "substantive" | "maintenance";
862
+ event_class?:"substantive" | "maintenance";
863
863
  /** Value that configures or reports patch for this contract. */
864
- patch: HistoryPatchOp[];
864
+ patch:HistoryPatchOp[];
865
865
  /** Value that configures or reports before hash for this contract. */
866
- before_hash: string;
866
+ before_hash:string;
867
867
  /** Value that configures or reports after hash for this contract. */
868
- after_hash: string;
868
+ after_hash:string;
869
869
  /** Version of the item canonicalization used by before_hash and after_hash. Absent on legacy streams. */
870
- item_hash_version?: number;
870
+ item_hash_version?:number;
871
871
  /** Version of the canonical immutable-record envelope. Absent on legacy entries whose coverage is item-state-only. */
872
- record_hash_version?: number;
872
+ record_hash_version?:number;
873
873
  /** Digest covering immutable metadata, patch and anchors under hash_algorithm. */
874
- record_hash?: string;
874
+ record_hash?:string;
875
875
  /** Append-only evidence for every prior anchor or patch representation replaced by maintenance. */
876
- reanchor_evidence?: HistoryReanchorEvidence[];
876
+ reanchor_evidence?:HistoryReanchorEvidence[];
877
877
  /** Human-readable explanation suitable for logs and agent-facing output. */
878
- message?: string;
878
+ message?:string;
879
879
  /** Structured audit metadata that does not alter replayed item state. */
880
- context?: Record<string, unknown>;
880
+ context?:Record<string,unknown>;
881
881
  }
882
882
  /** Supported values accepted by the context depth contract. */
883
- export declare const CONTEXT_DEPTH_VALUES: readonly ["brief", "standard", "deep", "full"];
883
+ export declare const CONTEXT_DEPTH_VALUES:readonly ["brief","standard","deep","full"];
884
884
  /** Restricts context depth values accepted by command, SDK, and storage contracts. */
885
885
  export type ContextDepth = (typeof CONTEXT_DEPTH_VALUES)[number];
886
886
  /** Supported values accepted by the context section contract. */
887
- export declare const CONTEXT_SECTION_VALUES: readonly ["hierarchy", "activity", "progress", "recently_created", "unparented", "blockers", "files", "workload", "staleness", "tests"];
887
+ export declare const CONTEXT_SECTION_VALUES:readonly ["hierarchy","activity","progress","recently_created","unparented","blockers","files","workload","staleness","tests"];
888
888
  /** Restricts context section name values accepted by command, SDK, and storage contracts. */
889
889
  export type ContextSectionName = (typeof CONTEXT_SECTION_VALUES)[number];
890
890
  /** Documents the context section settings payload exchanged by command, SDK, and package integrations. */
891
891
  export interface ContextSectionSettings {
892
892
  /** Value that configures or reports hierarchy for this contract. */
893
- hierarchy: boolean;
893
+ hierarchy:boolean;
894
894
  /** Value that configures or reports activity for this contract. */
895
- activity: boolean;
895
+ activity:boolean;
896
896
  /** Value that configures or reports progress for this contract. */
897
- progress: boolean;
897
+ progress:boolean;
898
898
  /** Value that configures or reports recently created for this contract. */
899
- recently_created: boolean;
899
+ recently_created:boolean;
900
900
  /** Value that configures or reports unparented for this contract. */
901
- unparented: boolean;
901
+ unparented:boolean;
902
902
  /** Value that configures or reports blockers for this contract. */
903
- blockers: boolean;
903
+ blockers:boolean;
904
904
  /** Value that configures or reports files for this contract. */
905
- files: boolean;
905
+ files:boolean;
906
906
  /** Value that configures or reports workload for this contract. */
907
- workload: boolean;
907
+ workload:boolean;
908
908
  /** Value that configures or reports staleness for this contract. */
909
- staleness: boolean;
909
+ staleness:boolean;
910
910
  /** Value that configures or reports tests for this contract. */
911
- tests: boolean;
911
+ tests:boolean;
912
912
  }
913
913
  /** Documents the context settings payload exchanged by command, SDK, and package integrations. */
914
914
  export interface ContextSettings {
915
915
  /** Fallback depth used when callers do not provide an override. */
916
- default_depth: ContextDepth;
916
+ default_depth:ContextDepth;
917
917
  /** Value that configures or reports activity limit for this contract. */
918
- activity_limit: number;
918
+ activity_limit:number;
919
919
  /** Value that configures or reports stale threshold days for this contract. */
920
- stale_threshold_days: number;
920
+ stale_threshold_days:number;
921
921
  /** Value that configures or reports sections for this contract. */
922
- sections: ContextSectionSettings;
922
+ sections:ContextSectionSettings;
923
923
  }
924
924
  /** Documents the governance settings payload exchanged by command, SDK, and package integrations. */
925
925
  export interface GovernanceSettings {
926
926
  /** Value that configures or reports preset for this contract. */
927
- preset: GovernancePreset;
927
+ preset:GovernancePreset;
928
928
  /** Value that configures or reports ownership enforcement for this contract. */
929
- ownership_enforcement: GovernanceOwnershipEnforcement;
929
+ ownership_enforcement:GovernanceOwnershipEnforcement;
930
930
  /** Creates mode default using the validated operation inputs. */
931
- create_mode_default: GovernanceCreateModeDefault;
931
+ create_mode_default:GovernanceCreateModeDefault;
932
932
  /** Value that configures or reports close validation default for this contract. */
933
- close_validation_default: GovernanceCloseValidationDefault;
933
+ close_validation_default:GovernanceCloseValidationDefault;
934
934
  /** Value that configures or reports require close reason for this contract. */
935
- require_close_reason: boolean;
935
+ require_close_reason:boolean;
936
936
  /** Value that configures or reports parent reference for this contract. */
937
- parent_reference: ParentReferencePolicy;
937
+ parent_reference:ParentReferencePolicy;
938
938
  /** Value that configures or reports metadata profile for this contract. */
939
- metadata_profile: ValidateMetadataProfile;
939
+ metadata_profile:ValidateMetadataProfile;
940
940
  /** Value that configures or reports force required for stale lock for this contract. */
941
- force_required_for_stale_lock: boolean;
941
+ force_required_for_stale_lock:boolean;
942
942
  /** Schema type that determines the shape and validation rules for this value. */
943
- create_default_type?: string;
943
+ create_default_type?:string;
944
944
  /** Per-type allowed-transition enforcement mode for `pm update --status`. Read raw from settings (not preset-derived) so existing projects are unaffected when unset; defaults to "off". */
945
- workflow_enforcement?: GovernanceWorkflowEnforcement;
945
+ workflow_enforcement?:GovernanceWorkflowEnforcement;
946
946
  /** Create/copy near-duplicate enforcement mode. */
947
- duplicate_detection_mode: GovernanceDuplicateDetectionMode;
947
+ duplicate_detection_mode:GovernanceDuplicateDetectionMode;
948
948
  /** Inclusive similarity floor on the zero-to-one scale. */
949
- duplicate_detection_threshold: number;
949
+ duplicate_detection_threshold:number;
950
950
  /** Maximum advisory candidates attached to a mutation result. */
951
- duplicate_detection_limit: number;
951
+ duplicate_detection_limit:number;
952
952
  }
953
953
  /** Restricts extension policy mode values accepted by command, SDK, and storage contracts. */
954
954
  export type ExtensionPolicyMode = "off" | "warn" | "enforce";
@@ -959,87 +959,87 @@ export type ExtensionSandboxProfile = "none" | "restricted" | "strict";
959
959
  /** Documents the extension policy override settings payload exchanged by command, SDK, and package integrations. */
960
960
  export interface ExtensionPolicyOverrideSettings {
961
961
  /** Value that configures or reports name for this contract. */
962
- name: string;
962
+ name:string;
963
963
  /** Whether disabled applies to this operation. */
964
- disabled?: boolean;
964
+ disabled?:boolean;
965
965
  /** Value that configures or reports require trusted for this contract. */
966
- require_trusted?: boolean;
966
+ require_trusted?:boolean;
967
967
  /** Value that configures or reports require provenance for this contract. */
968
- require_provenance?: boolean;
968
+ require_provenance?:boolean;
969
969
  /** Value that configures or reports sandbox profile for this contract. */
970
- sandbox_profile?: ExtensionSandboxProfile;
970
+ sandbox_profile?:ExtensionSandboxProfile;
971
971
  /** Value that configures or reports allowed capabilities for this contract. */
972
- allowed_capabilities?: string[];
972
+ allowed_capabilities?:string[];
973
973
  /** Value that configures or reports blocked capabilities for this contract. */
974
- blocked_capabilities?: string[];
974
+ blocked_capabilities?:string[];
975
975
  /** Value that configures or reports allowed surfaces for this contract. */
976
- allowed_surfaces?: string[];
976
+ allowed_surfaces?:string[];
977
977
  /** Value that configures or reports blocked surfaces for this contract. */
978
- blocked_surfaces?: string[];
978
+ blocked_surfaces?:string[];
979
979
  /** Value that configures or reports allowed commands for this contract. */
980
- allowed_commands?: string[];
980
+ allowed_commands?:string[];
981
981
  /** Value that configures or reports blocked commands for this contract. */
982
- blocked_commands?: string[];
982
+ blocked_commands?:string[];
983
983
  /** Value that configures or reports allowed actions for this contract. */
984
- allowed_actions?: string[];
984
+ allowed_actions?:string[];
985
985
  /** Value that configures or reports blocked actions for this contract. */
986
- blocked_actions?: string[];
986
+ blocked_actions?:string[];
987
987
  /** Value that configures or reports allowed services for this contract. */
988
- allowed_services?: string[];
988
+ allowed_services?:string[];
989
989
  /** Value that configures or reports blocked services for this contract. */
990
- blocked_services?: string[];
990
+ blocked_services?:string[];
991
991
  }
992
992
  /** Documents the extension policy settings payload exchanged by command, SDK, and package integrations. */
993
993
  export interface ExtensionPolicySettings {
994
994
  /** Value that configures or reports mode for this contract. */
995
- mode: ExtensionPolicyMode;
995
+ mode:ExtensionPolicyMode;
996
996
  /** Strategy used to control trust behavior. */
997
- trust_mode: ExtensionTrustMode;
997
+ trust_mode:ExtensionTrustMode;
998
998
  /** Value that configures or reports require provenance for this contract. */
999
- require_provenance: boolean;
999
+ require_provenance:boolean;
1000
1000
  /** Value that configures or reports trusted extensions for this contract. */
1001
- trusted_extensions: string[];
1001
+ trusted_extensions:string[];
1002
1002
  /** Fallback sandbox profile used when callers do not provide an override. */
1003
- default_sandbox_profile: ExtensionSandboxProfile;
1003
+ default_sandbox_profile:ExtensionSandboxProfile;
1004
1004
  /** Value that configures or reports allowed extensions for this contract. */
1005
- allowed_extensions: string[];
1005
+ allowed_extensions:string[];
1006
1006
  /** Value that configures or reports blocked extensions for this contract. */
1007
- blocked_extensions: string[];
1007
+ blocked_extensions:string[];
1008
1008
  /** Value that configures or reports allowed capabilities for this contract. */
1009
- allowed_capabilities: string[];
1009
+ allowed_capabilities:string[];
1010
1010
  /** Value that configures or reports blocked capabilities for this contract. */
1011
- blocked_capabilities: string[];
1011
+ blocked_capabilities:string[];
1012
1012
  /** Value that configures or reports allowed surfaces for this contract. */
1013
- allowed_surfaces: string[];
1013
+ allowed_surfaces:string[];
1014
1014
  /** Value that configures or reports blocked surfaces for this contract. */
1015
- blocked_surfaces: string[];
1015
+ blocked_surfaces:string[];
1016
1016
  /** Value that configures or reports allowed commands for this contract. */
1017
- allowed_commands: string[];
1017
+ allowed_commands:string[];
1018
1018
  /** Value that configures or reports blocked commands for this contract. */
1019
- blocked_commands: string[];
1019
+ blocked_commands:string[];
1020
1020
  /** Value that configures or reports allowed actions for this contract. */
1021
- allowed_actions: string[];
1021
+ allowed_actions:string[];
1022
1022
  /** Value that configures or reports blocked actions for this contract. */
1023
- blocked_actions: string[];
1023
+ blocked_actions:string[];
1024
1024
  /** Value that configures or reports allowed services for this contract. */
1025
- allowed_services: string[];
1025
+ allowed_services:string[];
1026
1026
  /** Value that configures or reports blocked services for this contract. */
1027
- blocked_services: string[];
1027
+ blocked_services:string[];
1028
1028
  /** Value that configures or reports extension overrides for this contract. */
1029
- extension_overrides: ExtensionPolicyOverrideSettings[];
1029
+ extension_overrides:ExtensionPolicyOverrideSettings[];
1030
1030
  }
1031
1031
  /** Documents the agent guidance settings payload exchanged by command, SDK, and package integrations. */
1032
1032
  export interface AgentGuidanceSettings {
1033
1033
  /** Value that configures or reports prompt completed for this contract. */
1034
- prompt_completed: boolean;
1034
+ prompt_completed:boolean;
1035
1035
  /** Value that configures or reports declined for this contract. */
1036
- declined: boolean;
1036
+ declined:boolean;
1037
1037
  /** ISO 8601 timestamp recording when declined occurred. */
1038
- declined_at: string;
1038
+ declined_at:string;
1039
1039
  /** Value that configures or reports template version for this contract. */
1040
- template_version: number;
1040
+ template_version:number;
1041
1041
  /** Value that configures or reports last checked files for this contract. */
1042
- last_checked_files: string[];
1042
+ last_checked_files:string[];
1043
1043
  }
1044
1044
  /** Restricts search mutation refresh policy values accepted by command, SDK, and storage contracts. */
1045
1045
  export type SearchMutationRefreshPolicy = "cache_only" | "semantic_configured" | "semantic_auto";
@@ -1048,18 +1048,18 @@ export type SearchDefaultMode = "auto" | "keyword" | "semantic" | "hybrid";
1048
1048
  /** Documents the search query expansion settings payload exchanged by command, SDK, and package integrations. */
1049
1049
  export interface SearchQueryExpansionSettings {
1050
1050
  /** Whether enabled applies to this operation. */
1051
- enabled: boolean;
1051
+ enabled:boolean;
1052
1052
  /** Value that configures or reports provider for this contract. */
1053
- provider: string;
1053
+ provider:string;
1054
1054
  }
1055
1055
  /** Documents the search rerank settings payload exchanged by command, SDK, and package integrations. */
1056
1056
  export interface SearchRerankSettings {
1057
1057
  /** Whether enabled applies to this operation. */
1058
- enabled: boolean;
1058
+ enabled:boolean;
1059
1059
  /** Value that configures or reports model for this contract. */
1060
- model: string;
1060
+ model:string;
1061
1061
  /** Value that configures or reports top k for this contract. */
1062
- top_k: number;
1062
+ top_k:number;
1063
1063
  }
1064
1064
  /**
1065
1065
  * Config-driven policy for automatic history-stream compaction triage.
@@ -1073,201 +1073,201 @@ top_k: number;
1073
1073
  */
1074
1074
  export interface HistoryCompactPolicy {
1075
1075
  /** Whether enabled applies to this operation. */
1076
- enabled: boolean;
1076
+ enabled:boolean;
1077
1077
  /** Value that configures or reports max entries for this contract. */
1078
- max_entries: number;
1078
+ max_entries:number;
1079
1079
  /** Value that configures or reports trigger for this contract. */
1080
- trigger: "health_warn" | "auto";
1080
+ trigger:"health_warn" | "auto";
1081
1081
  }
1082
1082
  /** Documents the pm settings payload exchanged by command, SDK, and package integrations. */
1083
1083
  export interface PmSettings {
1084
1084
  /** Value that configures or reports version for this contract. */
1085
- version: number;
1085
+ version:number;
1086
1086
  /** Value that configures or reports id prefix for this contract. */
1087
- id_prefix: string;
1087
+ id_prefix:string;
1088
1088
  /** Item id allocation policy: `token_length` is the number of random base36 characters appended to `id_prefix` when minting ids (4–12). Longer tokens shrink cross-branch collision odds for concurrent multi-agent workflows: 4 chars ≈ 1.68M ids (~1% birthday-collision at ~184 items), 6 chars ≈ 2.18B (~1% at ~6.6k items), 8 chars ≈ 2.8T (~1% at ~238k items). */
1089
- ids: {
1090
- token_length: number;
1089
+ ids:{
1090
+ token_length:number;
1091
1091
  };
1092
1092
  /** Value that configures or reports author default for this contract. */
1093
- author_default: string;
1093
+ author_default:string;
1094
1094
  /** Declarative workspace additions to the built-in agent identity registry. */
1095
- agent_identity?: {
1095
+ agent_identity?:{
1096
1096
  /** Whether bounded local harness-owned provenance probes may run. */
1097
- probes_enabled?: boolean;
1097
+ probes_enabled?:boolean;
1098
1098
  /** Versioned read-time interpretation for legacy free-text authors. */
1099
- identity_vocabulary?: {
1099
+ identity_vocabulary?:{
1100
1100
  /** Reproducible vocabulary revision recorded in read projections. */
1101
- version: number;
1101
+ version:number;
1102
1102
  /** Exact literal author spellings mapped to canonical harness namespaces. */
1103
- aliases: Record<string, string>;
1103
+ aliases:Record<string,string>;
1104
1104
  };
1105
1105
  /** Pure, bounded harness signal descriptors evaluated after built-ins. */
1106
- harness_signals: Array<{
1106
+ harness_signals:Array<{
1107
1107
  /** Stable lowercase harness namespace. */
1108
- harness: string;
1108
+ harness:string;
1109
1109
  /** Environment keys whose non-blank presence identifies the harness. */
1110
- environment_keys?: string[];
1110
+ environment_keys?:string[];
1111
1111
  /** Environment keys checked in order for a model identifier. */
1112
- model_environment_keys?: string[];
1112
+ model_environment_keys?:string[];
1113
1113
  /** Environment keys checked in order for a session identifier. */
1114
- session_environment_keys?: string[];
1114
+ session_environment_keys?:string[];
1115
1115
  /** Extensible provenance dimensions mapped to ordered environment keys. */
1116
- provenance_environment_keys?: Record<string, string[]>;
1116
+ provenance_environment_keys?:Record<string,string[]>;
1117
1117
  /** Provenance dimensions mapped to audited built-in local resolvers. */
1118
- provenance_resolvers?: Record<string, "ai_agent_version" | "claude_session_file">;
1118
+ provenance_resolvers?:Record<string,"ai_agent_version" | "claude_session_file">;
1119
1119
  /** Dimensions intentionally unavailable from this harness environment. */
1120
- provenance_unavailable_dimensions?: string[];
1120
+ provenance_unavailable_dimensions?:string[];
1121
1121
  /** Literal executable or argument markers. */
1122
- argv_markers?: string[];
1122
+ argv_markers?:string[];
1123
1123
  /** Literal MCP client-name markers. */
1124
- client_names?: string[];
1124
+ client_names?:string[];
1125
1125
  }>;
1126
1126
  };
1127
1127
  /** Shared pre-write provenance, secret, and stale-work policy. */
1128
- mutation_guard: {
1128
+ mutation_guard:{
1129
1129
  /** Reject mutations whose resolved author is `unknown`. */
1130
- require_attributed_author: boolean;
1130
+ require_attributed_author:boolean;
1131
1131
  /** Credential-shaped content policy applied before CLI/MCP mutation dispatch. */
1132
- secret_guard: "off" | "advise" | "block";
1132
+ secret_guard:"off" | "advise" | "block";
1133
1133
  /** Age threshold for unclaimed in-progress work surfaced by health. */
1134
- stale_in_progress_hours: number;
1134
+ stale_in_progress_hours:number;
1135
1135
  };
1136
1136
  /** Value that configures or reports item format for this contract. */
1137
- item_format: ItemFormat;
1137
+ item_format:ItemFormat;
1138
1138
  /** Value that configures or reports locks for this contract. */
1139
- locks: {
1140
- ttl_seconds: number;
1139
+ locks:{
1140
+ ttl_seconds:number;
1141
1141
  /** Bounded wait budget (milliseconds) for acquiring a contended item lock before surfacing lock_conflict. 0 disables waiting (fail-fast). Overridable per invocation via PM_LOCK_WAIT_MS. */
1142
- wait_ms: number;
1142
+ wait_ms:number;
1143
1143
  };
1144
1144
  /** Retention policy for local crash-recovery receipts: bulk-mutation rollback checkpoints written by `update-many`/`close-many` AND terminal SDK workspace-transaction journals under `transactions/sdk/`. `pm gc --scope checkpoints` prunes checkpoint files older than `retention_days`; `pm gc --scope transactions` prunes committed/compensated journals older than the same window. Unparseable receipts and in-flight journals are always retained (safety-first, mirroring the stale-lock sweep). */
1145
- checkpoints: {
1146
- retention_days: number;
1145
+ checkpoints:{
1146
+ retention_days:number;
1147
1147
  };
1148
1148
  /** Value that configures or reports output for this contract. */
1149
- output: {
1150
- default_format: "toon" | "json";
1149
+ output:{
1150
+ default_format:"toon" | "json";
1151
1151
  };
1152
1152
  /** Agent and human interaction preferences that do not change command semantics. */
1153
- ux?: {
1153
+ ux?:{
1154
1154
  /** Emit one stderr migration hint when a deprecated command alias is invoked. */
1155
- deprecation_hints?: boolean;
1155
+ deprecation_hints?:boolean;
1156
1156
  };
1157
1157
  /** Value that configures or reports history for this contract. */
1158
- history: {
1159
- missing_stream: "auto_create" | "strict_error";
1160
- compact_policy: HistoryCompactPolicy;
1158
+ history:{
1159
+ missing_stream:"auto_create" | "strict_error";
1160
+ compact_policy:HistoryCompactPolicy;
1161
1161
  };
1162
1162
  /** Value that configures or reports validation for this contract. */
1163
- validation: {
1164
- sprint_release_format: SprintReleaseFormatPolicy;
1165
- parent_reference: ParentReferencePolicy;
1166
- metadata_profile: ValidateMetadataProfile;
1167
- metadata_required_fields: ValidateMetadataRequiredField[];
1168
- lifecycle_stale_blocker_reason_patterns: string[];
1169
- lifecycle_closure_like_blocked_reason_patterns: string[];
1170
- lifecycle_closure_like_resolution_patterns: string[];
1171
- lifecycle_closure_like_actual_result_patterns: string[];
1163
+ validation:{
1164
+ sprint_release_format:SprintReleaseFormatPolicy;
1165
+ parent_reference:ParentReferencePolicy;
1166
+ metadata_profile:ValidateMetadataProfile;
1167
+ metadata_required_fields:ValidateMetadataRequiredField[];
1168
+ lifecycle_stale_blocker_reason_patterns:string[];
1169
+ lifecycle_closure_like_blocked_reason_patterns:string[];
1170
+ lifecycle_closure_like_resolution_patterns:string[];
1171
+ lifecycle_closure_like_actual_result_patterns:string[];
1172
1172
  /** Per-type default estimates (minutes) used by `pm validate --auto-fix --fix-scope estimates` to backfill missing `estimated_minutes` (GH-212). Keys are item type names (case-insensitive); values are positive minutes that override the built-in defaults. Empty by default. */
1173
- estimate_defaults_by_type: Record<string, number>;
1173
+ estimate_defaults_by_type:Record<string,number>;
1174
1174
  };
1175
1175
  /** Value that configures or reports governance for this contract. */
1176
- governance: GovernanceSettings;
1176
+ governance:GovernanceSettings;
1177
1177
  /** Value that configures or reports workflow for this contract. */
1178
- workflow: {
1179
- definition_of_done: string[];
1178
+ workflow:{
1179
+ definition_of_done:string[];
1180
1180
  };
1181
1181
  /** Value that configures or reports testing for this contract. */
1182
- testing: {
1183
- record_results_to_items: boolean;
1182
+ testing:{
1183
+ record_results_to_items:boolean;
1184
1184
  /** Permit explicit one-shot execution of commands not yet trusted by this clone. */
1185
- allow_untrusted_linked_tests: boolean;
1185
+ allow_untrusted_linked_tests:boolean;
1186
1186
  };
1187
1187
  /** Value that configures or reports telemetry for this contract. */
1188
- telemetry: {
1189
- enabled: boolean;
1190
- first_run_prompt_completed: boolean;
1191
- capture_level: "minimal" | "redacted" | "max";
1192
- endpoint: string;
1193
- installation_id: string;
1194
- retention_days: number;
1188
+ telemetry:{
1189
+ enabled:boolean;
1190
+ first_run_prompt_completed:boolean;
1191
+ capture_level:"minimal" | "redacted" | "max";
1192
+ endpoint:string;
1193
+ installation_id:string;
1194
+ retention_days:number;
1195
1195
  };
1196
1196
  /** Value that configures or reports agent guidance for this contract. */
1197
- agent_guidance: AgentGuidanceSettings;
1197
+ agent_guidance:AgentGuidanceSettings;
1198
1198
  /** Value that configures or reports item types for this contract. */
1199
- item_types: {
1200
- definitions: ItemTypeDefinition[];
1199
+ item_types:{
1200
+ definitions:ItemTypeDefinition[];
1201
1201
  };
1202
1202
  /** Value that configures or reports schema for this contract. */
1203
- schema: RuntimeSchemaSettings;
1203
+ schema:RuntimeSchemaSettings;
1204
1204
  /** Value that configures or reports extensions for this contract. */
1205
- extensions: {
1206
- enabled: string[];
1207
- disabled: string[];
1208
- policy: ExtensionPolicySettings;
1205
+ extensions:{
1206
+ enabled:string[];
1207
+ disabled:string[];
1208
+ policy:ExtensionPolicySettings;
1209
1209
  };
1210
1210
  /** Value that configures or reports search for this contract. */
1211
- search: {
1212
- score_threshold: number;
1213
- hybrid_semantic_weight: number;
1214
- max_results: number;
1215
- embedding_model: string;
1216
- embedding_corpus_max_characters?: number;
1217
- embedding_batch_size: number;
1218
- embedding_timeout_ms: number;
1219
- scanner_max_batch_retries: number;
1220
- provider?: string;
1211
+ search:{
1212
+ score_threshold:number;
1213
+ hybrid_semantic_weight:number;
1214
+ max_results:number;
1215
+ embedding_model:string;
1216
+ embedding_corpus_max_characters?:number;
1217
+ embedding_batch_size:number;
1218
+ embedding_timeout_ms:number;
1219
+ scanner_max_batch_retries:number;
1220
+ provider?:string;
1221
1221
  /** Mode a search runs in when the caller passes none: `auto` (default) resolves to hybrid when semantic search is explicitly configured and runnable, keyword otherwise; a concrete mode pins it. Optional on the type so existing settings literals stay valid; readers always normalize it. */
1222
- default_mode?: SearchDefaultMode;
1222
+ default_mode?:SearchDefaultMode;
1223
1223
  /** Optional allow-list of corpus field names embedded for semantic search (see DEFAULT_SEARCH_CORPUS_FIELDS in core/search/corpus.ts). When unset or empty, the full default field set is used (backward compatible). When set, only the named fields are embedded — letting teams opt structured signals (priority, assignee, risk, acceptance_criteria, etc.) in/out for token efficiency. Changing this re-flags items stale on the next refresh. */
1224
- corpus_fields?: string[];
1225
- mutation_refresh_policy: SearchMutationRefreshPolicy;
1226
- query_expansion: SearchQueryExpansionSettings;
1227
- rerank: SearchRerankSettings;
1224
+ corpus_fields?:string[];
1225
+ mutation_refresh_policy:SearchMutationRefreshPolicy;
1226
+ query_expansion:SearchQueryExpansionSettings;
1227
+ rerank:SearchRerankSettings;
1228
1228
  /** Offline BM25 lexical-ranking parameters (pm-75k9), applied when `search.provider` is `bm25` (or auto-selected as the offline fallback) for semantic/hybrid queries. `k1` controls term-frequency saturation, `b` controls document-length normalization. Unset → Lucene defaults (1.2/0.75). */
1229
- bm25?: {
1230
- k1?: number;
1231
- b?: number;
1229
+ bm25?:{
1230
+ k1?:number;
1231
+ b?:number;
1232
1232
  };
1233
- tuning?: {
1234
- title_exact_bonus?: number;
1235
- title_weight?: number;
1236
- description_weight?: number;
1237
- tags_weight?: number;
1238
- status_weight?: number;
1239
- body_weight?: number;
1240
- comments_weight?: number;
1241
- notes_weight?: number;
1242
- learnings_weight?: number;
1243
- dependencies_weight?: number;
1244
- linked_content_weight?: number;
1233
+ tuning?:{
1234
+ title_exact_bonus?:number;
1235
+ title_weight?:number;
1236
+ description_weight?:number;
1237
+ tags_weight?:number;
1238
+ status_weight?:number;
1239
+ body_weight?:number;
1240
+ comments_weight?:number;
1241
+ notes_weight?:number;
1242
+ learnings_weight?:number;
1243
+ dependencies_weight?:number;
1244
+ linked_content_weight?:number;
1245
1245
  };
1246
1246
  };
1247
1247
  /** Value that configures or reports providers for this contract. */
1248
- providers: {
1249
- openai: {
1250
- base_url: string;
1251
- api_key: string;
1252
- model: string;
1248
+ providers:{
1249
+ openai:{
1250
+ base_url:string;
1251
+ api_key:string;
1252
+ model:string;
1253
1253
  };
1254
- ollama: {
1255
- base_url: string;
1256
- model: string;
1254
+ ollama:{
1255
+ base_url:string;
1256
+ model:string;
1257
1257
  };
1258
1258
  };
1259
1259
  /** Value that configures or reports context for this contract. */
1260
- context: ContextSettings;
1260
+ context:ContextSettings;
1261
1261
  /** Value that configures or reports vector store for this contract. */
1262
- vector_store: {
1263
- adapter?: string;
1264
- collection_name: string;
1265
- qdrant: {
1266
- url: string;
1267
- api_key: string;
1262
+ vector_store:{
1263
+ adapter?:string;
1264
+ collection_name:string;
1265
+ qdrant:{
1266
+ url:string;
1267
+ api_key:string;
1268
1268
  };
1269
- lancedb: {
1270
- path: string;
1269
+ lancedb:{
1270
+ path:string;
1271
1271
  };
1272
1272
  };
1273
1273
  }