@unbrained/pm-cli 2026.10.14 → 2026.10.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (753) hide show
  1. package/.agents/skills/pm-developer/references/COMMAND_PLAYBOOK.md +1 -1
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/AGENTS.md +1 -0
  4. package/CHANGELOG.md +74 -2
  5. package/dist/cli/after-command-context-usage.d.ts +7 -7
  6. package/dist/cli/argv-utils.d.ts +4 -4
  7. package/dist/cli/bundle-integrity.d.ts +16 -16
  8. package/dist/cli/command-namespaces.d.ts +1 -1
  9. package/dist/cli/commander-usage.d.ts +34 -34
  10. package/dist/cli/commands/governance/validate.d.ts +1 -1
  11. package/dist/cli/commands/history/history-compact.d.ts +1 -1
  12. package/dist/cli/commands/history/history-redact.d.ts +1 -1
  13. package/dist/cli/commands/history/history-repair.d.ts +1 -1
  14. package/dist/cli/commands/history/restore.d.ts +1 -1
  15. package/dist/cli/commands/lifecycle/close.d.ts +1 -1
  16. package/dist/cli/commands/lifecycle/copy.d.ts +1 -1
  17. package/dist/cli/commands/lifecycle/delete.d.ts +1 -1
  18. package/dist/cli/commands/lifecycle/focus.d.ts +1 -1
  19. package/dist/cli/commands/query/get.d.ts +1 -1
  20. package/dist/cli/commands/workspace/merge.d.ts +1 -1
  21. package/dist/cli/commands/workspace/schema.d.ts +1 -1
  22. package/dist/cli/context-intent-invocation.d.ts +1 -1
  23. package/dist/cli/description-stdin.d.ts +1 -1
  24. package/dist/cli/error-guidance.d.ts +119 -119
  25. package/dist/cli/extension-command-help.d.ts +64 -64
  26. package/dist/cli/extension-command-help.js +2 -2
  27. package/dist/cli/extension-command-options.d.ts +18 -16
  28. package/dist/cli/extension-command-options.js +1 -1
  29. package/dist/cli/extension-recovery.d.ts +13 -13
  30. package/dist/cli/help-content.d.ts +22 -22
  31. package/dist/cli/help-content.js +3 -3
  32. package/dist/cli/help-json-payload.d.ts +45 -45
  33. package/dist/cli/invocation-profile.d.ts +5 -5
  34. package/dist/cli/main.d.ts +217 -217
  35. package/dist/cli/migration-gates.d.ts +24 -24
  36. package/dist/cli/option-values.d.ts +1 -1
  37. package/dist/cli/public.d.ts +1 -1
  38. package/dist/cli/register-annotations.d.ts +2 -2
  39. package/dist/cli/register-assurance.d.ts +1 -1
  40. package/dist/cli/register-files-lookup.d.ts +1 -1
  41. package/dist/cli/register-history-activity.d.ts +1 -1
  42. package/dist/cli/register-history-author.d.ts +1 -1
  43. package/dist/cli/register-history-maintenance.d.ts +1 -1
  44. package/dist/cli/register-list-query.d.ts +7 -7
  45. package/dist/cli/register-list-query.js +3 -3
  46. package/dist/cli/register-mutation-options.d.ts +1 -1
  47. package/dist/cli/register-mutation.d.ts +4 -4
  48. package/dist/cli/register-mutation.js +2 -2
  49. package/dist/cli/register-operations.d.ts +75 -75
  50. package/dist/cli/register-operations.js +1 -1
  51. package/dist/cli/register-setup.d.ts +4 -4
  52. package/dist/cli/register-structured-mutation.d.ts +8 -13
  53. package/dist/cli/register-structured-mutation.js +1 -1
  54. package/dist/cli/runtime/activation.d.ts +23 -23
  55. package/dist/cli/runtime/invocation-options.d.ts +12 -12
  56. package/dist/cli/runtime/invocation-options.js +1 -1
  57. package/dist/cli/runtime/projection-retry.d.ts +1 -1
  58. package/dist/cli/runtime/selection.d.ts +16 -16
  59. package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
  60. package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
  61. package/dist/cli/schema/registration.d.ts +1 -1
  62. package/dist/cli/schema-registration-helpers.d.ts +2 -2
  63. package/dist/cli/stats-analytics-json.d.ts +1 -1
  64. package/dist/cli-bundle/bundle-manifest.json +1 -1
  65. package/dist/cli-bundle/chunks/{chunk-LKESCZEN.js → chunk-3QKI3XNX.js} +2 -2
  66. package/dist/cli-bundle/chunks/chunk-4PNPDT2N.js +236 -0
  67. package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-6ZDKKOKM.js} +28 -28
  68. package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-B5QVGCZX.js} +2 -2
  69. package/dist/cli-bundle/chunks/{chunk-5LU6PWA4.js → chunk-EA2CG7UM.js} +2 -2
  70. package/dist/cli-bundle/chunks/chunk-HY7FQ7QX.js +2 -0
  71. package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-J4LPQCET.js} +2 -2
  72. package/dist/cli-bundle/chunks/chunk-JS3B2M4D.js +6 -0
  73. package/dist/cli-bundle/chunks/chunk-O4YBC3OM.js +30 -0
  74. package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-OZCSXX4D.js} +63 -64
  75. package/dist/cli-bundle/chunks/chunk-VMCSTFSO.js +2 -0
  76. package/dist/cli-bundle/chunks/chunk-W3KZ22DW.js +2 -0
  77. package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-X2ONXFBP.js} +2 -2
  78. package/dist/cli-bundle/chunks/chunk-X53HM753.js +20 -0
  79. package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-RU3QZSAQ.js} +7 -7
  80. package/dist/cli-bundle/chunks/register-mutation-EQYMT32A.js +20 -0
  81. package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-VXBGE4XI.js} +2 -2
  82. package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-UUDEGFRO.js} +2 -2
  83. package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-2IOHHNRT.js} +2 -2
  84. package/dist/cli-bundle/focused-chunks/chunk-5JEFDEL3.js +166 -0
  85. package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-AH6NX6GM.js} +2 -2
  86. package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-E33QA7PK.js} +2 -2
  87. package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-FTUZ3JF2.js} +6 -6
  88. package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-JXR6UKFM.js} +3 -3
  89. package/dist/cli-bundle/focused-chunks/chunk-LDKX4KYJ.js +2 -0
  90. package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-MBQF6HT6.js} +2 -2
  91. package/dist/cli-bundle/focused-chunks/chunk-NZO7GOXD.js +20 -0
  92. package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-PYC7BF6Z.js} +2 -2
  93. package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-QOSVJDOO.js} +61 -62
  94. package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-RBLSY6ML.js} +2 -2
  95. package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-RHTH5ILM.js} +2 -2
  96. package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-SIGIGZCG.js} +3 -3
  97. package/dist/cli-bundle/focused-chunks/chunk-TRFVAWF2.js +26 -0
  98. package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-UNTQE37U.js} +2 -2
  99. package/dist/cli-bundle/main.js +22 -22
  100. package/dist/cli-bundle/sdk-authoring.js +1 -1
  101. package/dist/cli-bundle/sdk-contracts.js +2 -2
  102. package/dist/cli-bundle/sdk-core.js +23 -23
  103. package/dist/cli-bundle/sdk-governance.js +1 -1
  104. package/dist/cli-bundle/sdk-graph.js +1 -1
  105. package/dist/cli-bundle/sdk-merge.js +54 -54
  106. package/dist/cli-bundle/sdk-query.js +1 -1
  107. package/dist/cli-bundle/sdk-runtime.js +1 -1
  108. package/dist/cli-bundle/sdk-testing.js +1 -1
  109. package/dist/cli-bundle/sdk.js +7 -7
  110. package/dist/cli.d.ts +9 -9
  111. package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
  112. package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
  113. package/dist/core/config/nested-settings.d.ts +20 -20
  114. package/dist/core/config/positional-value.d.ts +9 -9
  115. package/dist/core/diagnostics/remediation.d.ts +7 -7
  116. package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
  117. package/dist/core/extensions/activation-summary.d.ts +30 -30
  118. package/dist/core/extensions/activation-transaction.d.ts +9 -9
  119. package/dist/core/extensions/capability-usage.d.ts +25 -25
  120. package/dist/core/extensions/command-hook-context.d.ts +15 -15
  121. package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
  122. package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
  123. package/dist/core/extensions/contribution-inventory.d.ts +24 -24
  124. package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
  125. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  126. package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
  127. package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
  128. package/dist/core/extensions/extension-policy.d.ts +62 -62
  129. package/dist/core/extensions/extension-registries.d.ts +8 -8
  130. package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
  131. package/dist/core/extensions/extension-types.d.ts +717 -702
  132. package/dist/core/extensions/extension-types.js +1 -1
  133. package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
  134. package/dist/core/extensions/flag-value-types.d.ts +32 -4
  135. package/dist/core/extensions/flag-value-types.js +1 -1
  136. package/dist/core/extensions/index.d.ts +34 -34
  137. package/dist/core/extensions/item-field-types.d.ts +3 -3
  138. package/dist/core/extensions/item-fields.d.ts +6 -6
  139. package/dist/core/extensions/loader.d.ts +66 -66
  140. package/dist/core/extensions/manifest-parser.d.ts +1 -1
  141. package/dist/core/extensions/manifest-schema.d.ts +13 -13
  142. package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
  143. package/dist/core/extensions/preflight-ownership.d.ts +3 -3
  144. package/dist/core/extensions/read-output-contract.d.ts +2 -2
  145. package/dist/core/extensions/registration-contracts.d.ts +12 -12
  146. package/dist/core/extensions/registration-contracts.js +1 -1
  147. package/dist/core/extensions/registration-validation.d.ts +6 -6
  148. package/dist/core/extensions/registration-values.d.ts +19 -19
  149. package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
  150. package/dist/core/extensions/runtime-registrations.d.ts +6 -6
  151. package/dist/core/extensions/service-ownership.d.ts +1 -1
  152. package/dist/core/extensions/version-compat.d.ts +9 -9
  153. package/dist/core/fs/atomic-create.d.ts +1 -1
  154. package/dist/core/fs/fs-utils.d.ts +12 -12
  155. package/dist/core/fs/host-environment-errors.d.ts +10 -10
  156. package/dist/core/fs/path-utils.d.ts +1 -1
  157. package/dist/core/governance/content-fields.d.ts +25 -25
  158. package/dist/core/governance/issue-codes.d.ts +16 -16
  159. package/dist/core/governance/metadata-coverage.d.ts +64 -64
  160. package/dist/core/history/digest.d.ts +5 -5
  161. package/dist/core/history/drift-cache.d.ts +2 -2
  162. package/dist/core/history/drift-scan.d.ts +18 -18
  163. package/dist/core/history/event-classification.d.ts +4 -4
  164. package/dist/core/history/event-index.d.ts +33 -33
  165. package/dist/core/history/history-compact-bulk.d.ts +12 -12
  166. package/dist/core/history/history-diff.d.ts +15 -15
  167. package/dist/core/history/history-rewrite.d.ts +43 -43
  168. package/dist/core/history/history-storage-stats.d.ts +20 -20
  169. package/dist/core/history/history-stream-policy.d.ts +12 -12
  170. package/dist/core/history/history.d.ts +45 -45
  171. package/dist/core/history/identity.d.ts +4 -4
  172. package/dist/core/history/operation-contract.d.ts +17 -17
  173. package/dist/core/history/projection.d.ts +16 -16
  174. package/dist/core/history/read.d.ts +4 -4
  175. package/dist/core/history/replay.d.ts +47 -47
  176. package/dist/core/history/tombstone.d.ts +1 -1
  177. package/dist/core/history/version-address.d.ts +2 -2
  178. package/dist/core/history/workspace-history.d.ts +72 -72
  179. package/dist/core/io/body-file.d.ts +2 -2
  180. package/dist/core/io/bulk-ids-input.d.ts +7 -7
  181. package/dist/core/item/actionability.d.ts +30 -30
  182. package/dist/core/item/dependency-reference.d.ts +2 -2
  183. package/dist/core/item/id.d.ts +9 -9
  184. package/dist/core/item/item-format-version.d.ts +17 -15
  185. package/dist/core/item/item-format-version.js +1 -1
  186. package/dist/core/item/item-format.d.ts +54 -54
  187. package/dist/core/item/item-format.js +3 -3
  188. package/dist/core/item/item-record.d.ts +1 -1
  189. package/dist/core/item/item-type-definition.d.ts +11 -11
  190. package/dist/core/item/parent-reference-policy.d.ts +6 -6
  191. package/dist/core/item/parse.d.ts +37 -37
  192. package/dist/core/item/plan-lifecycle.d.ts +4 -4
  193. package/dist/core/item/priority.d.ts +3 -3
  194. package/dist/core/item/sprint-release-format.d.ts +4 -4
  195. package/dist/core/item/status-filter.d.ts +5 -5
  196. package/dist/core/item/status.d.ts +3 -3
  197. package/dist/core/item/toon-decode.d.ts +10 -10
  198. package/dist/core/item/type-registry.d.ts +35 -35
  199. package/dist/core/item/type-synonyms.d.ts +2 -2
  200. package/dist/core/lock/lock-gc.d.ts +28 -28
  201. package/dist/core/lock/lock.d.ts +53 -53
  202. package/dist/core/output/mutation-projection.d.ts +4 -25
  203. package/dist/core/output/mutation-projection.js +1 -1
  204. package/dist/core/output/output-control.d.ts +4 -4
  205. package/dist/core/output/output.d.ts +30 -30
  206. package/dist/core/output/query-summary.d.ts +5 -5
  207. package/dist/core/output/tabular.d.ts +3 -3
  208. package/dist/core/packages/manifest.d.ts +30 -30
  209. package/dist/core/packages/root.d.ts +4 -4
  210. package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
  211. package/dist/core/policy/workflow-policy-store.d.ts +15 -15
  212. package/dist/core/policy/workflow-policy.d.ts +56 -56
  213. package/dist/core/profile/profile-describe.d.ts +22 -22
  214. package/dist/core/profile/profile-lint.d.ts +13 -13
  215. package/dist/core/profile/profile-plan.d.ts +45 -45
  216. package/dist/core/profile/profile-presets.d.ts +36 -36
  217. package/dist/core/reproducibility/context.d.ts +9 -9
  218. package/dist/core/schema/fields-file.d.ts +35 -35
  219. package/dist/core/schema/item-types-file.d.ts +29 -29
  220. package/dist/core/schema/runtime-field-filters.d.ts +3 -3
  221. package/dist/core/schema/runtime-field-values.d.ts +7 -7
  222. package/dist/core/schema/runtime-schema.d.ts +59 -59
  223. package/dist/core/schema/status-defs-file.d.ts +29 -29
  224. package/dist/core/schema/status-token.d.ts +1 -1
  225. package/dist/core/schema/type-inference.d.ts +10 -10
  226. package/dist/core/schema/type-presets.d.ts +5 -5
  227. package/dist/core/schema/type-workflows.d.ts +15 -15
  228. package/dist/core/schema/type-workflows.js +1 -1
  229. package/dist/core/search/background-refresh.d.ts +12 -12
  230. package/dist/core/search/bm25.d.ts +16 -16
  231. package/dist/core/search/cache.d.ts +34 -34
  232. package/dist/core/search/corpus.d.ts +17 -17
  233. package/dist/core/search/embedding-batches.d.ts +25 -25
  234. package/dist/core/search/eval-thresholds.d.ts +4 -4
  235. package/dist/core/search/eval.d.ts +40 -40
  236. package/dist/core/search/http-client.d.ts +24 -24
  237. package/dist/core/search/providers.d.ts +30 -30
  238. package/dist/core/search/relevance.d.ts +17 -17
  239. package/dist/core/search/semantic-defaults.d.ts +5 -5
  240. package/dist/core/search/staleness.d.ts +3 -3
  241. package/dist/core/search/vector-stores.d.ts +51 -51
  242. package/dist/core/search/vectorization-metadata.d.ts +9 -9
  243. package/dist/core/sentry/helpers.d.ts +27 -27
  244. package/dist/core/sentry/instrument.d.ts +51 -51
  245. package/dist/core/sentry/instrument.js +1 -1
  246. package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
  247. package/dist/core/sentry/sensitive-assignments.js +2 -0
  248. package/dist/core/session/session-state.d.ts +37 -37
  249. package/dist/core/shared/agent-session-context.d.ts +14 -14
  250. package/dist/core/shared/author.d.ts +89 -89
  251. package/dist/core/shared/command-line.d.ts +3 -3
  252. package/dist/core/shared/command-types.d.ts +20 -20
  253. package/dist/core/shared/conflict-markers.d.ts +5 -5
  254. package/dist/core/shared/constants.d.ts +30 -30
  255. package/dist/core/shared/errors.d.ts +100 -100
  256. package/dist/core/shared/html-entity-decode.d.ts +2 -2
  257. package/dist/core/shared/item-metadata-contract.d.ts +2 -2
  258. package/dist/core/shared/lazy-module.d.ts +1 -1
  259. package/dist/core/shared/levenshtein.d.ts +1 -1
  260. package/dist/core/shared/memo.d.ts +1 -1
  261. package/dist/core/shared/numeric-parsers.d.ts +1 -1
  262. package/dist/core/shared/option-alias-visibility.d.ts +3 -3
  263. package/dist/core/shared/primitives.d.ts +13 -13
  264. package/dist/core/shared/secret-rules.d.ts +92 -92
  265. package/dist/core/shared/serial-queue.d.ts +6 -6
  266. package/dist/core/shared/serialization.d.ts +4 -4
  267. package/dist/core/shared/split-comma-list.d.ts +4 -4
  268. package/dist/core/shared/text-normalization.d.ts +5 -3
  269. package/dist/core/shared/text-normalization.js +1 -1
  270. package/dist/core/shared/time.d.ts +27 -27
  271. package/dist/core/store/item-format-migration.d.ts +7 -7
  272. package/dist/core/store/item-metadata-cache.d.ts +30 -30
  273. package/dist/core/store/item-metadata-query-index.d.ts +66 -66
  274. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  275. package/dist/core/store/item-mutation-precondition.d.ts +11 -0
  276. package/dist/core/store/item-mutation-precondition.js +2 -0
  277. package/dist/core/store/item-store.d.ts +123 -123
  278. package/dist/core/store/item-store.js +1 -1
  279. package/dist/core/store/paths.d.ts +27 -27
  280. package/dist/core/store/settings-concurrency.d.ts +1 -1
  281. package/dist/core/store/settings-read-cache.d.ts +11 -11
  282. package/dist/core/store/settings-validator.d.ts +117 -117
  283. package/dist/core/store/settings.d.ts +84 -84
  284. package/dist/core/store/sqlite-runtime.d.ts +2 -2
  285. package/dist/core/store/tracker-preflight.d.ts +3 -3
  286. package/dist/core/telemetry/consent.d.ts +1 -1
  287. package/dist/core/telemetry/observability.d.ts +16 -16
  288. package/dist/core/telemetry/policy.d.ts +7 -7
  289. package/dist/core/telemetry/read-sampling.d.ts +1 -1
  290. package/dist/core/telemetry/runtime.d.ts +275 -275
  291. package/dist/core/test/background-runs.d.ts +123 -123
  292. package/dist/core/test/item-test-run-tracking.d.ts +10 -10
  293. package/dist/core/test/run-selectors.d.ts +12 -12
  294. package/dist/core/validate/estimate-defaults.d.ts +3 -3
  295. package/dist/core/validate/fix-planning.d.ts +36 -36
  296. package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
  297. package/dist/core/validate/missing-by-type.d.ts +3 -3
  298. package/dist/core/validate/missing-link-owners.d.ts +17 -17
  299. package/dist/core/validate/stale-file-classification.d.ts +6 -6
  300. package/dist/mcp/http-server.d.ts +26 -26
  301. package/dist/mcp/legacy-adapter.d.ts +18 -18
  302. package/dist/mcp/runtime-capabilities.d.ts +18 -18
  303. package/dist/mcp/server.d.ts +73 -73
  304. package/dist/mcp/server.js +1 -1
  305. package/dist/mcp/tool-definitions.d.ts +27 -27
  306. package/dist/mcp/tool-definitions.js +1 -1
  307. package/dist/sdk/actionability.d.ts +1 -1
  308. package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
  309. package/dist/sdk/agent/command-recovery.d.ts +5 -5
  310. package/dist/sdk/agent/command-suggestions.d.ts +4 -4
  311. package/dist/sdk/agent/create-option-policy.d.ts +2 -2
  312. package/dist/sdk/agent/identity-config.d.ts +18 -18
  313. package/dist/sdk/agent/item-addressing.d.ts +6 -6
  314. package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
  315. package/dist/sdk/agent/refusal-closure.d.ts +22 -22
  316. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
  317. package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
  318. package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
  319. package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
  320. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
  321. package/dist/sdk/agent-capability-contracts.d.ts +41 -41
  322. package/dist/sdk/agent-session-context.d.ts +1 -1
  323. package/dist/sdk/annotations.d.ts +74 -74
  324. package/dist/sdk/author-attribution.d.ts +47 -47
  325. package/dist/sdk/authoring.d.ts +9 -9
  326. package/dist/sdk/cli-bootstrap.d.ts +65 -65
  327. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
  328. package/dist/sdk/cli-contracts/agent-output-contracts.js +1 -1
  329. package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
  330. package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
  331. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
  332. package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
  333. package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
  334. package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
  335. package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
  336. package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
  337. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  338. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
  339. package/dist/sdk/cli-contracts/flag-lexicon-contracts.js +1 -1
  340. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
  341. package/dist/sdk/cli-contracts/registration-helpers.d.ts +57 -57
  342. package/dist/sdk/cli-contracts/registration-helpers.js +1 -1
  343. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
  344. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  345. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
  346. package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
  347. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
  348. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
  349. package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
  350. package/dist/sdk/cli-contracts/tool-schema.js +1 -1
  351. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
  352. package/dist/sdk/cli-contracts.d.ts +15 -15
  353. package/dist/sdk/cli-program.d.ts +1 -1
  354. package/dist/sdk/cli-program.js +1 -1
  355. package/dist/sdk/command-line.d.ts +3 -3
  356. package/dist/sdk/comments.d.ts +24 -24
  357. package/dist/sdk/compile-cache.d.ts +4 -4
  358. package/dist/sdk/completion/bash.d.ts +1 -1
  359. package/dist/sdk/completion/fish.d.ts +1 -1
  360. package/dist/sdk/completion/shared.d.ts +74 -74
  361. package/dist/sdk/completion/zsh.d.ts +1 -1
  362. package/dist/sdk/completion.d.ts +3 -3
  363. package/dist/sdk/compose.d.ts +94 -94
  364. package/dist/sdk/config.d.ts +105 -105
  365. package/dist/sdk/context/recency.d.ts +1 -1
  366. package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
  367. package/dist/sdk/context/usage-egress.d.ts +1 -1
  368. package/dist/sdk/context/usage-ledger.d.ts +18 -18
  369. package/dist/sdk/context-intent-contracts.d.ts +37 -37
  370. package/dist/sdk/context-intent-contracts.js +1 -1
  371. package/dist/sdk/context-intent-runtime.d.ts +10 -10
  372. package/dist/sdk/context-packing.d.ts +44 -44
  373. package/dist/sdk/context-relevance.d.ts +110 -110
  374. package/dist/sdk/context-signal-store.d.ts +52 -52
  375. package/dist/sdk/context-usage.d.ts +78 -78
  376. package/dist/sdk/contracts.d.ts +2 -1
  377. package/dist/sdk/contracts.js +1 -1
  378. package/dist/sdk/core-governance.d.ts +5 -5
  379. package/dist/sdk/core.d.ts +9 -8
  380. package/dist/sdk/core.js +1 -1
  381. package/dist/sdk/corpus-shape.d.ts +60 -60
  382. package/dist/sdk/define.d.ts +36 -36
  383. package/dist/sdk/dependencies.d.ts +70 -70
  384. package/dist/sdk/dependency-flag-validation.d.ts +17 -17
  385. package/dist/sdk/dependency-provenance.d.ts +22 -22
  386. package/dist/sdk/docs.d.ts +17 -17
  387. package/dist/sdk/duplicates.d.ts +14 -14
  388. package/dist/sdk/environment/agent-environment.d.ts +118 -118
  389. package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
  390. package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
  391. package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
  392. package/dist/sdk/environment/source-context.d.ts +4 -4
  393. package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
  394. package/dist/sdk/error-code-catalog.d.ts +33 -33
  395. package/dist/sdk/error-runtime.d.ts +5 -5
  396. package/dist/sdk/errors.d.ts +17 -17
  397. package/dist/sdk/eval.d.ts +27 -27
  398. package/dist/sdk/extension/author-manifest.d.ts +9 -9
  399. package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
  400. package/dist/sdk/extension/concurrency.d.ts +1 -1
  401. package/dist/sdk/extension/copy-scope.d.ts +1 -1
  402. package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
  403. package/dist/sdk/extension/describe.d.ts +21 -21
  404. package/dist/sdk/extension/doctor.d.ts +46 -46
  405. package/dist/sdk/extension/install-plan.d.ts +32 -32
  406. package/dist/sdk/extension/install-receipts.d.ts +4 -4
  407. package/dist/sdk/extension/install-runtime.d.ts +12 -12
  408. package/dist/sdk/extension/install-snapshot.d.ts +10 -10
  409. package/dist/sdk/extension/install-sources.d.ts +106 -106
  410. package/dist/sdk/extension/managed-state.d.ts +42 -42
  411. package/dist/sdk/extension/managed-update-status.d.ts +1 -1
  412. package/dist/sdk/extension/migrations.d.ts +48 -48
  413. package/dist/sdk/extension/output-ownership.d.ts +19 -19
  414. package/dist/sdk/extension/runtime-summary.d.ts +7 -7
  415. package/dist/sdk/extension/scaffold.d.ts +15 -15
  416. package/dist/sdk/extension/shared.d.ts +16 -16
  417. package/dist/sdk/extension/source-resolution.d.ts +16 -16
  418. package/dist/sdk/extension/static-inventory.d.ts +23 -23
  419. package/dist/sdk/extension/update-check.d.ts +9 -9
  420. package/dist/sdk/extension-command-context.d.ts +1 -1
  421. package/dist/sdk/extension-contracts.d.ts +10 -10
  422. package/dist/sdk/extension.d.ts +221 -221
  423. package/dist/sdk/files.d.ts +101 -101
  424. package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
  425. package/dist/sdk/flag-invocation-contracts.js +1 -1
  426. package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
  427. package/dist/sdk/generated/generated-error-code-catalog-part-1.js +1 -1
  428. package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
  429. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  430. package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
  431. package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
  432. package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
  433. package/dist/sdk/governance/assurance-action.d.ts +46 -46
  434. package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
  435. package/dist/sdk/governance/assurance-presets.d.ts +25 -25
  436. package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
  437. package/dist/sdk/governance/assurance.d.ts +204 -204
  438. package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
  439. package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
  440. package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
  441. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
  442. package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
  443. package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
  444. package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
  445. package/dist/sdk/governance/extension-host-version.d.ts +9 -9
  446. package/dist/sdk/governance/gc.d.ts +26 -26
  447. package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
  448. package/dist/sdk/governance/health.d.ts +172 -172
  449. package/dist/sdk/governance/health.js +1 -1
  450. package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
  451. package/dist/sdk/governance/linked-file-report.d.ts +15 -15
  452. package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
  453. package/dist/sdk/governance/provenance-health.d.ts +35 -35
  454. package/dist/sdk/governance/reindex.d.ts +102 -102
  455. package/dist/sdk/governance/reliability.d.ts +29 -29
  456. package/dist/sdk/governance/stale-work.d.ts +13 -13
  457. package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
  458. package/dist/sdk/governance/storage-integrity.d.ts +28 -28
  459. package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
  460. package/dist/sdk/governance/upgrade.d.ts +77 -77
  461. package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
  462. package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
  463. package/dist/sdk/governance/validate-normalization.d.ts +4 -4
  464. package/dist/sdk/governance/validate.d.ts +176 -176
  465. package/dist/sdk/governance/validate.js +1 -1
  466. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  467. package/dist/sdk/governance/workflow-policy.d.ts +18 -18
  468. package/dist/sdk/governance/workspace-position.d.ts +40 -40
  469. package/dist/sdk/governance.d.ts +2 -2
  470. package/dist/sdk/graph/adapter.d.ts +45 -45
  471. package/dist/sdk/graph/analytics.d.ts +36 -36
  472. package/dist/sdk/graph/assembly.d.ts +51 -51
  473. package/dist/sdk/graph/cache.d.ts +19 -19
  474. package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
  475. package/dist/sdk/graph/centrality.d.ts +20 -20
  476. package/dist/sdk/graph/conformance.d.ts +21 -21
  477. package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
  478. package/dist/sdk/graph/durable-cache.d.ts +22 -22
  479. package/dist/sdk/graph/governance-contracts.d.ts +1 -1
  480. package/dist/sdk/graph/governance.d.ts +92 -92
  481. package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
  482. package/dist/sdk/graph/index.d.ts +15 -15
  483. package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
  484. package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
  485. package/dist/sdk/graph/query-contracts.d.ts +6 -6
  486. package/dist/sdk/graph/remediation.d.ts +15 -15
  487. package/dist/sdk/graph/run.d.ts +203 -203
  488. package/dist/sdk/graph/scheduling.d.ts +21 -21
  489. package/dist/sdk/graph/traversal.d.ts +18 -18
  490. package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
  491. package/dist/sdk/guide-topics.d.ts +19 -19
  492. package/dist/sdk/guide-topics.js +1 -1
  493. package/dist/sdk/guide.d.ts +43 -43
  494. package/dist/sdk/history/attestation-command.d.ts +8 -8
  495. package/dist/sdk/history/attestation-contract.d.ts +43 -43
  496. package/dist/sdk/history/attestation-scan.d.ts +4 -4
  497. package/dist/sdk/history/attestation.d.ts +4 -4
  498. package/dist/sdk/history/maintenance.d.ts +25 -25
  499. package/dist/sdk/history/salvage.d.ts +19 -19
  500. package/dist/sdk/history/subject.d.ts +8 -8
  501. package/dist/sdk/history-analytics.d.ts +64 -64
  502. package/dist/sdk/history-compact.d.ts +67 -67
  503. package/dist/sdk/history-mcp.d.ts +7 -7
  504. package/dist/sdk/history-provenance.d.ts +40 -40
  505. package/dist/sdk/history-read.d.ts +24 -24
  506. package/dist/sdk/history-redact.d.ts +68 -68
  507. package/dist/sdk/history-repair.d.ts +92 -92
  508. package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
  509. package/dist/sdk/improvement-ledger.d.ts +62 -62
  510. package/dist/sdk/index.d.ts +70 -69
  511. package/dist/sdk/index.js +1 -1
  512. package/dist/sdk/init-agent-guidance.d.ts +68 -68
  513. package/dist/sdk/init.d.ts +117 -117
  514. package/dist/sdk/invocation-author.d.ts +1 -1
  515. package/dist/sdk/item-children.d.ts +15 -15
  516. package/dist/sdk/item-metadata-index.d.ts +2 -2
  517. package/dist/sdk/item-schedule.d.ts +9 -9
  518. package/dist/sdk/item-transaction.d.ts +139 -76
  519. package/dist/sdk/item-transaction.js +1 -1
  520. package/dist/sdk/learnings.d.ts +23 -23
  521. package/dist/sdk/lifecycle/append.d.ts +8 -8
  522. package/dist/sdk/lifecycle/claim.d.ts +53 -39
  523. package/dist/sdk/lifecycle/claim.js +1 -1
  524. package/dist/sdk/lifecycle/close-many.d.ts +71 -71
  525. package/dist/sdk/lifecycle/close.d.ts +18 -24
  526. package/dist/sdk/lifecycle/close.js +1 -1
  527. package/dist/sdk/lifecycle/copy.d.ts +10 -10
  528. package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
  529. package/dist/sdk/lifecycle/core-item-fields.d.ts +6 -0
  530. package/dist/sdk/lifecycle/core-item-fields.js +2 -0
  531. package/dist/sdk/lifecycle/create.d.ts +88 -88
  532. package/dist/sdk/lifecycle/delete.d.ts +15 -15
  533. package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
  534. package/dist/sdk/lifecycle/focus.d.ts +6 -6
  535. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
  536. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
  537. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
  538. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  539. package/dist/sdk/lifecycle/mcp-actions.js +1 -1
  540. package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
  541. package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
  542. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
  543. package/dist/sdk/lifecycle/mutation-option-validation.d.ts +2 -0
  544. package/dist/sdk/lifecycle/mutation-option-validation.js +2 -0
  545. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
  546. package/dist/sdk/lifecycle/plan.d.ts +127 -127
  547. package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
  548. package/dist/sdk/lifecycle/release-handoff.d.ts +12 -0
  549. package/dist/sdk/lifecycle/release-handoff.js +2 -0
  550. package/dist/sdk/lifecycle/reopen.d.ts +15 -15
  551. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
  552. package/dist/sdk/lifecycle/restore.d.ts +34 -34
  553. package/dist/sdk/lifecycle/restore.js +1 -1
  554. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
  555. package/dist/sdk/lifecycle/structured-mutation-plan.d.ts +33 -0
  556. package/dist/sdk/lifecycle/structured-mutation-plan.js +2 -0
  557. package/dist/sdk/lifecycle/task-composition.d.ts +9 -9
  558. package/dist/sdk/lifecycle/task-composition.js +1 -1
  559. package/dist/sdk/lifecycle/update-many.d.ts +61 -61
  560. package/dist/sdk/lifecycle/update.d.ts +113 -121
  561. package/dist/sdk/lifecycle/update.js +1 -1
  562. package/dist/sdk/lifecycle/workflow-transition.d.ts +13 -0
  563. package/dist/sdk/lifecycle/workflow-transition.js +2 -0
  564. package/dist/sdk/lifecycle-completion.d.ts +14 -14
  565. package/dist/sdk/lifecycle-policy.d.ts +42 -32
  566. package/dist/sdk/lifecycle-policy.js +1 -1
  567. package/dist/sdk/linked-artifacts.d.ts +58 -58
  568. package/dist/sdk/mcp/apps.d.ts +28 -28
  569. package/dist/sdk/mcp/authorization.d.ts +66 -66
  570. package/dist/sdk/mcp/discovery.d.ts +67 -67
  571. package/dist/sdk/mcp/interactions.d.ts +49 -49
  572. package/dist/sdk/mcp/protocol.d.ts +63 -63
  573. package/dist/sdk/mcp/skills.d.ts +62 -62
  574. package/dist/sdk/mcp/subscriptions.d.ts +26 -26
  575. package/dist/sdk/mcp/tasks.d.ts +51 -51
  576. package/dist/sdk/mcp/transport.d.ts +17 -17
  577. package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
  578. package/dist/sdk/merge/driver.d.ts +38 -38
  579. package/dist/sdk/merge/index.d.ts +5 -5
  580. package/dist/sdk/merge/install.d.ts +48 -48
  581. package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
  582. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  583. package/dist/sdk/merge/receipt-schema.d.ts +11 -11
  584. package/dist/sdk/merge/receipts.d.ts +111 -111
  585. package/dist/sdk/merge/reconcile.d.ts +20 -20
  586. package/dist/sdk/merge/three-way.d.ts +50 -50
  587. package/dist/sdk/merge/three-way.js +2 -2
  588. package/dist/sdk/merge/worktree-config.d.ts +3 -3
  589. package/dist/sdk/mutation-events.d.ts +62 -62
  590. package/dist/sdk/mutation-guard.d.ts +134 -134
  591. package/dist/sdk/notes.d.ts +28 -28
  592. package/dist/sdk/output/table-rows.d.ts +6 -6
  593. package/dist/sdk/output-contracts.d.ts +26 -26
  594. package/dist/sdk/output-projection.d.ts +108 -108
  595. package/dist/sdk/output-token-accounting.d.ts +18 -18
  596. package/dist/sdk/output.d.ts +18 -18
  597. package/dist/sdk/ownership-source.d.ts +1 -1
  598. package/dist/sdk/package-import-adapters.d.ts +51 -51
  599. package/dist/sdk/package-migrations.d.ts +3 -3
  600. package/dist/sdk/package-runtime-options.d.ts +3 -3
  601. package/dist/sdk/pagination.d.ts +28 -28
  602. package/dist/sdk/pagination.js +1 -1
  603. package/dist/sdk/profile.d.ts +72 -72
  604. package/dist/sdk/provenance.d.ts +37 -37
  605. package/dist/sdk/public-surface.json +1 -1
  606. package/dist/sdk/query/activity.d.ts +84 -84
  607. package/dist/sdk/query/aggregate.d.ts +109 -109
  608. package/dist/sdk/query/calendar.d.ts +95 -95
  609. package/dist/sdk/query/complete-list.d.ts +35 -35
  610. package/dist/sdk/query/context.d.ts +300 -300
  611. package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
  612. package/dist/sdk/query/get.d.ts +54 -54
  613. package/dist/sdk/query/history.d.ts +38 -38
  614. package/dist/sdk/query/item-filter-options.d.ts +41 -41
  615. package/dist/sdk/query/light-metadata.d.ts +1 -1
  616. package/dist/sdk/query/list-filter-shared.d.ts +4 -4
  617. package/dist/sdk/query/list.d.ts +167 -167
  618. package/dist/sdk/query/list.js +1 -1
  619. package/dist/sdk/query/multi-value-filters.d.ts +6 -6
  620. package/dist/sdk/query/next-ready-budget.d.ts +8 -8
  621. package/dist/sdk/query/next.d.ts +94 -94
  622. package/dist/sdk/query/parsers.d.ts +3 -3
  623. package/dist/sdk/query/projection-contracts.d.ts +18 -18
  624. package/dist/sdk/query/search/corpus.d.ts +15 -15
  625. package/dist/sdk/query/search/filters.d.ts +15 -15
  626. package/dist/sdk/query/search/input.d.ts +8 -8
  627. package/dist/sdk/query/search/lexical.d.ts +10 -10
  628. package/dist/sdk/query/search/response.d.ts +22 -22
  629. package/dist/sdk/query/search/semantic.d.ts +133 -133
  630. package/dist/sdk/query/search/types.d.ts +65 -65
  631. package/dist/sdk/query/search-contracts.d.ts +53 -53
  632. package/dist/sdk/query/search-pagination.d.ts +21 -21
  633. package/dist/sdk/query/search-rendering.d.ts +30 -30
  634. package/dist/sdk/query/search.d.ts +60 -60
  635. package/dist/sdk/query/workspace-contracts.d.ts +2 -2
  636. package/dist/sdk/query.d.ts +6 -6
  637. package/dist/sdk/read-output/continuation.d.ts +11 -11
  638. package/dist/sdk/read-output/extension.d.ts +3 -3
  639. package/dist/sdk/read-output/options.d.ts +7 -7
  640. package/dist/sdk/read-output/provenance.d.ts +6 -6
  641. package/dist/sdk/read-output-budget.d.ts +11 -11
  642. package/dist/sdk/read-output-budget.js +1 -1
  643. package/dist/sdk/read-output-contracts.d.ts +112 -112
  644. package/dist/sdk/read-output-contracts.js +1 -1
  645. package/dist/sdk/read-output-rows.d.ts +15 -15
  646. package/dist/sdk/read-output-session.d.ts +29 -29
  647. package/dist/sdk/relationship-analytics.d.ts +46 -46
  648. package/dist/sdk/relationship-context.d.ts +48 -48
  649. package/dist/sdk/relationship-history.d.ts +59 -59
  650. package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
  651. package/dist/sdk/relationship-migration.d.ts +14 -14
  652. package/dist/sdk/relationships.d.ts +46 -46
  653. package/dist/sdk/reproducibility/process.d.ts +9 -9
  654. package/dist/sdk/runtime/actions.d.ts +1 -1
  655. package/dist/sdk/runtime/context.d.ts +15 -15
  656. package/dist/sdk/runtime/schema-preview.d.ts +1 -1
  657. package/dist/sdk/runtime/schema.d.ts +1 -1
  658. package/dist/sdk/runtime-action-aliases.d.ts +3 -3
  659. package/dist/sdk/runtime-extended-actions.d.ts +9 -9
  660. package/dist/sdk/runtime-input.d.ts +29 -29
  661. package/dist/sdk/runtime-input.js +1 -1
  662. package/dist/sdk/runtime-primitives.d.ts +53 -53
  663. package/dist/sdk/runtime-primitives.js +1 -1
  664. package/dist/sdk/runtime-public-contracts.d.ts +46 -46
  665. package/dist/sdk/runtime-stats-options.d.ts +1 -1
  666. package/dist/sdk/runtime.d.ts +374 -374
  667. package/dist/sdk/runtime.js +1 -1
  668. package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
  669. package/dist/sdk/schema-migration.d.ts +79 -79
  670. package/dist/sdk/schema.d.ts +224 -224
  671. package/dist/sdk/search-refresh-worker.d.ts +1 -1
  672. package/dist/sdk/similarity-scoring.d.ts +10 -10
  673. package/dist/sdk/similarity.d.ts +73 -73
  674. package/dist/sdk/start-task-status.d.ts +1 -1
  675. package/dist/sdk/stats.d.ts +72 -72
  676. package/dist/sdk/structured-mutations.d.ts +64 -13
  677. package/dist/sdk/structured-mutations.js +1 -1
  678. package/dist/sdk/telemetry-flush.d.ts +1 -1
  679. package/dist/sdk/telemetry.d.ts +32 -32
  680. package/dist/sdk/templates.d.ts +35 -35
  681. package/dist/sdk/test/batch.d.ts +50 -50
  682. package/dist/sdk/test/command-args.d.ts +2 -2
  683. package/dist/sdk/test/entry.d.ts +4 -4
  684. package/dist/sdk/test/execution-receipts.d.ts +5 -5
  685. package/dist/sdk/test/execution.d.ts +247 -247
  686. package/dist/sdk/test/json-path.d.ts +4 -4
  687. package/dist/sdk/test/linked-command-detection.d.ts +36 -36
  688. package/dist/sdk/test/measurements.d.ts +10 -10
  689. package/dist/sdk/test/parsers.d.ts +18 -18
  690. package/dist/sdk/test/prerequisites.d.ts +3 -3
  691. package/dist/sdk/test/runs.d.ts +43 -43
  692. package/dist/sdk/test/trust.d.ts +15 -15
  693. package/dist/sdk/test/update.d.ts +23 -23
  694. package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
  695. package/dist/sdk/testing.d.ts +248 -248
  696. package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
  697. package/dist/sdk/traceability/source-traceability.d.ts +50 -50
  698. package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
  699. package/dist/sdk/workspace-contracts.d.ts +20 -20
  700. package/dist/sdk/workspace-memory.d.ts +42 -42
  701. package/dist/sdk/workspace-recipe.d.ts +9 -9
  702. package/dist/sdk/workspace-snapshot.d.ts +60 -60
  703. package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
  704. package/dist/sdk/workspace-transaction.d.ts +26 -26
  705. package/dist/sdk/workspace-transaction.js +2 -2
  706. package/dist/sdk/workspace.d.ts +9 -9
  707. package/dist/types.d.ts +540 -540
  708. package/docs/AGENT_GUIDE.md +33 -4
  709. package/docs/CLOSE_EVIDENCE_RECOVERY.md +16 -7
  710. package/docs/COMMANDS.md +96 -12
  711. package/docs/ECOSYSTEM_PLANNING_REVIEW.md +5 -1
  712. package/docs/EXTENSIONS.md +1 -1
  713. package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
  714. package/docs/LINKED_TEST_EDITS.md +15 -0
  715. package/docs/RELEASING.md +2 -0
  716. package/docs/SDK.md +114 -2
  717. package/docs/TESTING.md +36 -1
  718. package/docs/generated/FLAG_LEXICON_BUDGETS.md +1 -1
  719. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +17 -3
  720. package/marketplace.json +1 -1
  721. package/package.json +4 -1
  722. package/packages/pm-beads/package.json +1 -1
  723. package/packages/pm-calendar/package.json +1 -1
  724. package/packages/pm-command-kit/package.json +1 -1
  725. package/packages/pm-digital-twin/package.json +1 -1
  726. package/packages/pm-governance-audit/package.json +1 -1
  727. package/packages/pm-guide-shell/package.json +1 -1
  728. package/packages/pm-kanban/package.json +1 -1
  729. package/packages/pm-lifecycle-hooks/package.json +1 -1
  730. package/packages/pm-linked-test-adapters/package.json +1 -1
  731. package/packages/pm-search-advanced/package.json +1 -1
  732. package/packages/pm-templates/package.json +1 -1
  733. package/packages/pm-todos/package.json +1 -1
  734. package/packages/pm-vcs/package.json +1 -1
  735. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  736. package/plugins/pm-claude/package.json +1 -1
  737. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  738. package/plugins/pm-codex/package.json +1 -1
  739. package/plugins/pm-codex/plugin.json +1 -1
  740. package/runtime-dependencies.json +1 -1
  741. package/scripts/finalize-build.mjs +9 -3
  742. package/dist/cli-bundle/chunks/chunk-66BZVFIK.js +0 -6
  743. package/dist/cli-bundle/chunks/chunk-IDEHMKYZ.js +0 -235
  744. package/dist/cli-bundle/chunks/chunk-LOSRTNNP.js +0 -2
  745. package/dist/cli-bundle/chunks/chunk-PP3BVMFL.js +0 -30
  746. package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
  747. package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
  748. package/dist/cli-bundle/chunks/register-mutation-TNRHNK4N.js +0 -20
  749. package/dist/cli-bundle/focused-chunks/chunk-23ACMPGB.js +0 -2
  750. package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
  751. package/dist/cli-bundle/focused-chunks/chunk-LKWDWER4.js +0 -20
  752. package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
  753. package/docs/ecosystem-review-2026-09-28.json +0 -1
@@ -21,7 +21,7 @@ import type { RawAddStatusInput } from "../schema/status-defs-file.js";
21
21
  import type { RawAddFieldInput } from "../schema/fields-file.js";
22
22
  import type { TypeWorkflowDefinition } from "../../types.js";
23
23
  /** Repeatable create-flag values used to stage a profile template. Mirrors the stored-template option shape (`Record<flag, string | string[]>`) accepted by `pm templates save` without importing the CLI module into core. */
24
- export type ProfileTemplateOptions = Readonly<Record<string, string | readonly string[]>>;
24
+ export type ProfileTemplateOptions = Readonly<Record<string,string | readonly string[]>>;
25
25
  /**
26
26
  * A single nested-settings knob a profile stages during apply. The `key` is a
27
27
  * {@link module:core/config/nested-settings} descriptor key (snake_case) and the
@@ -30,48 +30,48 @@ export type ProfileTemplateOptions = Readonly<Record<string, string | readonly s
30
30
  */
31
31
  export interface ProfileConfigEntry {
32
32
  /** Nested-settings descriptor key, e.g. `search_provider`. */
33
- key: string;
33
+ key:string;
34
34
  /** Raw value parsed by the descriptor (e.g. `"bm25"`, `"20"`). */
35
- value: string;
35
+ value:string;
36
36
  /** Short human-facing rationale surfaced in profile descriptions. */
37
- summary: string;
37
+ summary:string;
38
38
  }
39
39
  /** A named create template a profile stages into `<pmRoot>/templates/<name>.json` so operators can immediately `pm create --template <name>`. */
40
40
  export interface ProfileTemplateEntry {
41
41
  /** Template name (matches the `pm templates` naming rules). */
42
- name: string;
42
+ name:string;
43
43
  /** Create-flag option payload stored for the template. */
44
- options: ProfileTemplateOptions;
44
+ options:ProfileTemplateOptions;
45
45
  }
46
46
  /** A package the profile recommends but never auto-installs. Apply surfaces these as advisory `pm package install` hints, keeping profile application offline and side-effect-free with respect to the package registry. */
47
47
  export interface ProfilePackageRecommendation {
48
48
  /** Catalog alias or install spec, e.g. `templates` or `npm:@unbrained/pm-templates`. */
49
- spec: string;
49
+ spec:string;
50
50
  /** Why this archetype benefits from the package. */
51
- reason: string;
51
+ reason:string;
52
52
  }
53
53
  /** The complete declarative definition of a project profile. Every dimension is optional-by-emptiness: an empty array simply stages nothing for that surface. */
54
54
  export interface ProjectProfileDefinition {
55
55
  /** Stable lowercase profile identifier, e.g. `agile`. */
56
- name: string;
56
+ name:string;
57
57
  /** Human-facing display title. */
58
- title: string;
58
+ title:string;
59
59
  /** One-line description of the archetype the profile tailors the tracker for. */
60
- summary: string;
60
+ summary:string;
61
61
  /** Item types to upsert (shared with the matching type preset). */
62
- types: readonly RawAddTypeInput[];
62
+ types:readonly RawAddTypeInput[];
63
63
  /** Custom statuses to upsert. */
64
- statuses: readonly RawAddStatusInput[];
64
+ statuses:readonly RawAddStatusInput[];
65
65
  /** Custom fields to upsert. */
66
- fields: readonly RawAddFieldInput[];
66
+ fields:readonly RawAddFieldInput[];
67
67
  /** Per-type workflow transition allow-lists to stage into settings. */
68
- workflows: readonly TypeWorkflowDefinition[];
68
+ workflows:readonly TypeWorkflowDefinition[];
69
69
  /** Nested-settings knobs to stage. */
70
- config: readonly ProfileConfigEntry[];
70
+ config:readonly ProfileConfigEntry[];
71
71
  /** Create templates to stage. */
72
- templates: readonly ProfileTemplateEntry[];
72
+ templates:readonly ProfileTemplateEntry[];
73
73
  /** Advisory package recommendations (never auto-installed). */
74
- packages: readonly ProfilePackageRecommendation[];
74
+ packages:readonly ProfilePackageRecommendation[];
75
75
  }
76
76
  /**
77
77
  * The shape an extension passes to `api.registerProfile(profile)`.
@@ -85,9 +85,9 @@ packages: readonly ProfilePackageRecommendation[];
85
85
  * while a complete definition (a built-in or `defineProjectProfile`-typed value)
86
86
  * also satisfies it.
87
87
  */
88
- export type ProjectProfileRegistrationInput = Pick<ProjectProfileDefinition, "name" | "title"> & Partial<Omit<ProjectProfileDefinition, "name" | "title">>;
88
+ export type ProjectProfileRegistrationInput = Pick<ProjectProfileDefinition,"name" | "title"> & Partial<Omit<ProjectProfileDefinition,"name" | "title">>;
89
89
  /** Ordered list of first-party profile names. Drives CLI help, completion, contracts, and the `pm profile list` ordering. */
90
- export declare const PROFILE_NAMES: readonly ["agile", "ops", "research"];
90
+ export declare const PROFILE_NAMES:readonly ["agile","ops","research"];
91
91
  /** Restricts profile name values accepted by command, SDK, and storage contracts. */
92
92
  export type ProfileName = (typeof PROFILE_NAMES)[number];
93
93
  /**
@@ -97,34 +97,34 @@ export type ProfileName = (typeof PROFILE_NAMES)[number];
97
97
  * workflow, offline-friendly search config, a starter template, and package
98
98
  * recommendations.
99
99
  */
100
- export declare const BUILTIN_PROFILES: Record<ProfileName, ProjectProfileDefinition>;
100
+ export declare const BUILTIN_PROFILES:Record<ProfileName,ProjectProfileDefinition>;
101
101
  /**
102
102
  * Validates and normalizes a raw profile-name value. Returns `undefined` when the
103
103
  * value is omitted. Throws a plain Error with a stable message for an empty or
104
104
  * unknown name; CLI layers map it to a USAGE exit code. Accepts hyphen/underscore
105
105
  * and casing variations for ergonomics, mirroring {@link normalizeTypePresetName}.
106
106
  */
107
- export declare function normalizeProfileName(rawValue: string | undefined): ProfileName | undefined;
107
+ export declare function normalizeProfileName(rawValue:string | undefined):ProfileName | undefined;
108
108
  /**
109
109
  * Resolves a built-in profile definition by validated name. Throws (via
110
110
  * {@link normalizeProfileName}) when the name is missing or unknown.
111
111
  */
112
- export declare function resolveProfile(rawValue: string | undefined): ProjectProfileDefinition;
112
+ export declare function resolveProfile(rawValue:string | undefined):ProjectProfileDefinition;
113
113
  /**
114
114
  * Returns all built-in profile definitions in {@link PROFILE_NAMES} order. Used by
115
115
  * `pm profile list` and SDK consumers enumerating available archetypes.
116
116
  */
117
- export declare function listProfiles(): ProjectProfileDefinition[];
117
+ export declare function listProfiles():ProjectProfileDefinition[];
118
118
  /** Whether a resolved profile is core-baked or contributed by an active extension. */
119
119
  export type ProfileSourceKind = "builtin" | "extension";
120
120
  /** A profile definition paired with where it came from, returned by the merged `pm profile` resolution so callers can label a profile's origin. */
121
121
  export interface ResolvedProfile {
122
122
  /** The profile definition. */
123
- definition: ProjectProfileDefinition;
123
+ definition:ProjectProfileDefinition;
124
124
  /** Whether the profile is core-baked or contributed by an active extension. */
125
- source: ProfileSourceKind;
125
+ source:ProfileSourceKind;
126
126
  /** For an extension profile, the owning package/extension name; absent for builtins. */
127
- package?: string;
127
+ package?:string;
128
128
  }
129
129
  /**
130
130
  * A profile contributed by an active extension, fed into the merge resolver.
@@ -136,9 +136,9 @@ package?: string;
136
136
  */
137
137
  export interface ExtensionProfileContribution {
138
138
  /** Owning extension/package name, surfaced as the resolved profile's source. */
139
- name: string;
139
+ name:string;
140
140
  /** The profile definition the extension registered. */
141
- profile: ProjectProfileDefinition;
141
+ profile:ProjectProfileDefinition;
142
142
  }
143
143
  /**
144
144
  * Result of {@link resolveProfileCatalog}: the merged profile list plus any
@@ -146,9 +146,9 @@ profile: ProjectProfileDefinition;
146
146
  */
147
147
  export interface ResolveProfileCatalogResult {
148
148
  /** Builtins first (in {@link PROFILE_NAMES} order), then accepted extension profiles in contribution order. */
149
- profiles: ResolvedProfile[];
149
+ profiles:ResolvedProfile[];
150
150
  /** Non-fatal merge warnings (built-in shadowing attempts, duplicate names). */
151
- warnings: string[];
151
+ warnings:string[];
152
152
  }
153
153
  /**
154
154
  * Result of {@link resolveProfileEntry}: the single resolved profile plus the
@@ -158,9 +158,9 @@ warnings: string[];
158
158
  */
159
159
  export interface ResolveProfileEntryResult {
160
160
  /** The resolved profile and its source. */
161
- resolved: ResolvedProfile;
161
+ resolved:ResolvedProfile;
162
162
  /** Non-fatal merge warnings from building the catalog the entry was resolved against. */
163
- warnings: string[];
163
+ warnings:string[];
164
164
  }
165
165
  /**
166
166
  * Canonical lookup key for a profile name: trimmed, lowercased, with hyphens
@@ -169,7 +169,7 @@ warnings: string[];
169
169
  * `my_flow ` interchangeably. Interior spaces are preserved — only the
170
170
  * hyphen/underscore distinction and surrounding whitespace/casing are folded.
171
171
  */
172
- export declare function normalizeProfileLookupKey(rawValue: string): string;
172
+ export declare function normalizeProfileLookupKey(rawValue:string):string;
173
173
  /**
174
174
  * Merges the core-baked {@link BUILTIN_PROFILES} with profiles contributed by
175
175
  * active extensions into one resolvable catalog.
@@ -183,7 +183,7 @@ export declare function normalizeProfileLookupKey(rawValue: string): string;
183
183
  * `registerProfile` validation rejects an empty `name` before it can reach the
184
184
  * registry that feeds this resolver.
185
185
  */
186
- export declare function resolveProfileCatalog(contributions?: readonly ExtensionProfileContribution[]): ResolveProfileCatalogResult;
186
+ export declare function resolveProfileCatalog(contributions?:readonly ExtensionProfileContribution[]):ResolveProfileCatalogResult;
187
187
  /**
188
188
  * Resolves a single profile by name from the merged catalog (builtins +
189
189
  * extension contributions), returning it alongside the catalog's merge warnings.
@@ -191,4 +191,4 @@ export declare function resolveProfileCatalog(contributions?: readonly Extension
191
191
  * missing or unknown, so CLI layers map it to a USAGE exit code — the
192
192
  * extension-aware counterpart to {@link resolveProfile}.
193
193
  */
194
- export declare function resolveProfileEntry(rawValue: string | undefined, contributions?: readonly ExtensionProfileContribution[]): ResolveProfileEntryResult;
194
+ export declare function resolveProfileEntry(rawValue:string | undefined,contributions?:readonly ExtensionProfileContribution[]):ResolveProfileEntryResult;
@@ -1,21 +1,21 @@
1
1
  /** Low-level deterministic execution settings shared by SDK recipes. */
2
2
  export interface ReproducibleExecutionSettings {
3
3
  /** Stable seed used to derive identifier entropy. */
4
- seed: string;
4
+ seed:string;
5
5
  /** ISO timestamp returned for the first clock read. */
6
- clock: string;
6
+ clock:string;
7
7
  /** Milliseconds advanced after each clock read. */
8
- tickMs: number;
8
+ tickMs:number;
9
9
  }
10
10
  /** Runs async operations against one shared deterministic sequence. */
11
- export type ReproducibleExecutionRunner = <T>(operation: () => Promise<T>) => Promise<T>;
11
+ export type ReproducibleExecutionRunner = <T>(operation:() => Promise<T>) => Promise<T>;
12
12
  /** Validate and normalize deterministic execution settings before work starts. */
13
- export declare function validateReproducibleExecutionSettings(settings: ReproducibleExecutionSettings): ReproducibleExecutionSettings;
13
+ export declare function validateReproducibleExecutionSettings(settings:ReproducibleExecutionSettings):ReproducibleExecutionSettings;
14
14
  /** Create a runner whose serial operations share deterministic clock and entropy state. */
15
- export declare function createReproducibleExecutionRunner(settings: ReproducibleExecutionSettings): ReproducibleExecutionRunner;
15
+ export declare function createReproducibleExecutionRunner(settings:ReproducibleExecutionSettings):ReproducibleExecutionRunner;
16
16
  /** Run an isolated async operation with deterministic clock and entropy state. */
17
- export declare function runWithReproducibleExecution<T>(settings: ReproducibleExecutionSettings, operation: () => Promise<T>): Promise<T>;
17
+ export declare function runWithReproducibleExecution<T>(settings:ReproducibleExecutionSettings,operation:() => Promise<T>):Promise<T>;
18
18
  /** Return the next deterministic clock value, or undefined outside a recipe. */
19
- export declare function nextReproducibleTimestamp(): string | undefined;
19
+ export declare function nextReproducibleTimestamp():string | undefined;
20
20
  /** Return a deterministic base36 token, or undefined outside a recipe. */
21
- export declare function nextReproducibleToken(length: number): string | undefined;
21
+ export declare function nextReproducibleToken(length:number):string | undefined;
@@ -1,84 +1,84 @@
1
- import type { RuntimeFieldCommand, RuntimeFieldDefinition, RuntimeFieldType } from "../../types/index.js";
1
+ import type { RuntimeFieldCommand,RuntimeFieldDefinition,RuntimeFieldType } from "../../types/index.js";
2
2
  export { normalizeStatusToken as normalizeFieldKey } from "./status-token.js";
3
- export type { RuntimeFieldCommand, RuntimeFieldDefinition, RuntimeFieldValueSchema, RuntimeFieldType, } from "../../types/index.js";
3
+ export type { RuntimeFieldCommand,RuntimeFieldDefinition,RuntimeFieldValueSchema,RuntimeFieldType,} from "../../types/index.js";
4
4
  /** Built-in item-metadata field names a custom field key must never shadow. A custom key that collides with one of these would let `pm create --<key>` write over reserved metadata, so add-field rejects them up front (symmetric with the built-in-type guard in item-types-file.ts). */
5
- export declare const BUILTIN_FIELD_KEYS: ReadonlySet<string>;
5
+ export declare const BUILTIN_FIELD_KEYS:ReadonlySet<string>;
6
6
  /** The shape persisted at `.agents/pm/schema/fields.json`. */
7
7
  export interface FieldsFile {
8
8
  /** Value that configures or reports fields for this contract. */
9
- fields: RuntimeFieldDefinition[];
9
+ fields:RuntimeFieldDefinition[];
10
10
  }
11
11
  /** Documents the raw add field input payload exchanged by command, SDK, and package integrations. */
12
12
  export interface RawAddFieldInput {
13
13
  /** Value that configures or reports key for this contract. */
14
- key: string | undefined;
14
+ key:string | undefined;
15
15
  /** Schema type that determines the shape and validation rules for this value. */
16
- type?: string;
16
+ type?:string;
17
17
  /** Value that configures or reports commands for this contract. */
18
- commands?: string[];
18
+ commands?:string[];
19
19
  /** Value that configures or reports description for this contract. */
20
- description?: string;
20
+ description?:string;
21
21
  /** Value that configures or reports cli flag for this contract. */
22
- cliFlag?: string;
22
+ cliFlag?:string;
23
23
  /** Value that configures or reports aliases for this contract. */
24
- aliases?: string[];
24
+ aliases?:string[];
25
25
  /** Value that configures or reports required for this contract. */
26
- required?: boolean;
26
+ required?:boolean;
27
27
  /** Value that configures or reports required on create for this contract. */
28
- requiredOnCreate?: boolean;
28
+ requiredOnCreate?:boolean;
29
29
  /** Value that configures or reports allow unset for this contract. */
30
- allowUnset?: boolean;
30
+ allowUnset?:boolean;
31
31
  /** Value that configures or reports required types for this contract. */
32
- requiredTypes?: string[];
32
+ requiredTypes?:string[];
33
33
  }
34
34
  /** Documents the normalized add field input payload exchanged by command, SDK, and package integrations. */
35
35
  export interface NormalizedAddFieldInput {
36
36
  /** Value that configures or reports key for this contract. */
37
- key: string;
37
+ key:string;
38
38
  /** Schema type that determines the shape and validation rules for this value. */
39
- type: RuntimeFieldType;
39
+ type:RuntimeFieldType;
40
40
  /** Value that configures or reports commands for this contract. */
41
- commands: RuntimeFieldCommand[];
41
+ commands:RuntimeFieldCommand[];
42
42
  /** Value that configures or reports description for this contract. */
43
- description?: string;
43
+ description?:string;
44
44
  /** Value that configures or reports cli flag for this contract. */
45
- cliFlag?: string;
45
+ cliFlag?:string;
46
46
  /** Value that configures or reports cli aliases for this contract. */
47
- cliAliases: string[];
47
+ cliAliases:string[];
48
48
  /** Value that configures or reports required for this contract. */
49
- required: boolean;
49
+ required:boolean;
50
50
  /** Value that configures or reports required on create for this contract. */
51
- requiredOnCreate: boolean;
51
+ requiredOnCreate:boolean;
52
52
  /** Value that configures or reports allow unset for this contract. */
53
- allowUnset: boolean;
53
+ allowUnset:boolean;
54
54
  /** Value that configures or reports required types for this contract. */
55
- requiredTypes: string[];
55
+ requiredTypes:string[];
56
56
  }
57
57
  /** Documents the upsert field result payload exchanged by command, SDK, and package integrations. */
58
58
  export interface UpsertFieldResult {
59
59
  /** Value that configures or reports file for this contract. */
60
- file: FieldsFile;
60
+ file:FieldsFile;
61
61
  /** The definition as stored after the upsert. */
62
- definition: RuntimeFieldDefinition;
62
+ definition:RuntimeFieldDefinition;
63
63
  /** True when an existing definition with the same (normalized) key was replaced. */
64
- replaced: boolean;
64
+ replaced:boolean;
65
65
  }
66
66
  /** Documents the remove field result payload exchanged by command, SDK, and package integrations. */
67
67
  export interface RemoveFieldResult {
68
68
  /** Value that configures or reports file for this contract. */
69
- file: FieldsFile;
69
+ file:FieldsFile;
70
70
  /** True when a matching definition existed and was dropped from the file. */
71
- removed: boolean;
71
+ removed:boolean;
72
72
  /** The removed definition, when one matched the requested key. */
73
- definition?: RuntimeFieldDefinition;
73
+ definition?:RuntimeFieldDefinition;
74
74
  }
75
75
  /** Validates and normalizes raw add-field CLI input. Throws a plain Error with a stable message when the key is missing/empty, collides with a built-in field, or carries an invalid type/command; the CLI layer maps these to PmCliError exit codes. A `string_array` type implies a repeatable field downstream (runtime-schema.ts derives `repeatable`), so no separate repeatable flag is exposed. */
76
- export declare function normalizeAddFieldInput(raw: RawAddFieldInput): NormalizedAddFieldInput;
76
+ export declare function normalizeAddFieldInput(raw:RawAddFieldInput):NormalizedAddFieldInput;
77
77
  /** Coerces an arbitrary parsed value from fields.json into a FieldsFile. Accepts the canonical `{ fields: [...] }` shape, a bare array, or a `{ definitions: [...] }` form, and tolerates a missing/invalid file by returning an empty fields list. */
78
- export declare function parseFieldsFile(raw: string | null | undefined): FieldsFile;
78
+ export declare function parseFieldsFile(raw:string | null | undefined):FieldsFile;
79
79
  /** Serializes the fields file with a trailing newline (matches the rest of the schema scaffold files written by pm). */
80
- export declare function serializeFieldsFile(file: FieldsFile): string;
80
+ export declare function serializeFieldsFile(file:FieldsFile):string;
81
81
  /** Idempotent UPSERT of a custom field into the parsed file. Matching is by normalized key. When a definition already exists, the supplied input fully replaces its add-field-managed attributes (type/commands/description/flags/ required flags) while preserving any unrelated keys the file may carry; any `metadata_key` already stored is preserved so existing item data keeps mapping to the same item-metadata column. */
82
- export declare function upsertField(file: FieldsFile, input: NormalizedAddFieldInput): UpsertFieldResult;
82
+ export declare function upsertField(file:FieldsFile,input:NormalizedAddFieldInput):UpsertFieldResult;
83
83
  /** Removes a custom field definition from the parsed file by key (normalized). Throws a plain Error when `key` is empty. Returns `removed: false` when no matching definition exists so the CLI layer can treat the call as an idempotent no-op. */
84
- export declare function removeField(file: FieldsFile, key: string | undefined): RemoveFieldResult;
84
+ export declare function removeField(file:FieldsFile,key:string | undefined):RemoveFieldResult;
@@ -3,62 +3,62 @@ export type { ItemTypeDefinition } from "../../types/index.js";
3
3
  /** The shape persisted at `.agents/pm/schema/types.json`. */
4
4
  export interface ItemTypesFile {
5
5
  /** Value that configures or reports definitions for this contract. */
6
- definitions: ItemTypeDefinition[];
6
+ definitions:ItemTypeDefinition[];
7
7
  }
8
8
  /** Documents the normalized add type input payload exchanged by command, SDK, and package integrations. */
9
9
  export interface NormalizedAddTypeInput {
10
10
  /** Value that configures or reports name for this contract. */
11
- name: string;
11
+ name:string;
12
12
  /** Value that configures or reports description for this contract. */
13
- description?: string;
13
+ description?:string;
14
14
  /** Default status id newly created items of this type receive. */
15
- defaultStatus?: string;
15
+ defaultStatus?:string;
16
16
  /** Value that configures or reports folder for this contract. */
17
- folder?: string;
17
+ folder?:string;
18
18
  /** Value that configures or reports aliases for this contract. */
19
- aliases: string[];
19
+ aliases:string[];
20
20
  }
21
21
  /** Documents the raw add type input payload exchanged by command, SDK, and package integrations. */
22
22
  export interface RawAddTypeInput {
23
23
  /** Value that configures or reports name for this contract. */
24
- name: string | undefined;
24
+ name:string | undefined;
25
25
  /** Value that configures or reports description for this contract. */
26
- description?: string;
26
+ description?:string;
27
27
  /** Default status id newly created items of this type receive. */
28
- defaultStatus?: string;
28
+ defaultStatus?:string;
29
29
  /** Value that configures or reports folder for this contract. */
30
- folder?: string;
30
+ folder?:string;
31
31
  /** Value that configures or reports aliases for this contract. */
32
- aliases?: string[];
32
+ aliases?:string[];
33
33
  }
34
34
  /** Documents the upsert item type result payload exchanged by command, SDK, and package integrations. */
35
35
  export interface UpsertItemTypeResult {
36
36
  /** Value that configures or reports file for this contract. */
37
- file: ItemTypesFile;
37
+ file:ItemTypesFile;
38
38
  /** The definition as stored after the upsert (existing fields preserved). */
39
- definition: ItemTypeDefinition;
39
+ definition:ItemTypeDefinition;
40
40
  /** True when an existing definition with the same (case-insensitive) name was replaced. */
41
- replaced: boolean;
41
+ replaced:boolean;
42
42
  /** The canonical name of the replaced definition (only present when `replaced`). Lets the caller detect a silent recase (e.g. "Spike" -> "spike") and warn. */
43
- previousName?: string;
43
+ previousName?:string;
44
44
  }
45
45
  /** Documents the remove item type result payload exchanged by command, SDK, and package integrations. */
46
46
  export interface RemoveItemTypeResult {
47
47
  /** Value that configures or reports file for this contract. */
48
- file: ItemTypesFile;
48
+ file:ItemTypesFile;
49
49
  /** True when a matching definition existed and was dropped from the file. */
50
- removed: boolean;
50
+ removed:boolean;
51
51
  /** The removed definition, when one matched (case-insensitively) the requested name. */
52
- definition?: ItemTypeDefinition;
52
+ definition?:ItemTypeDefinition;
53
53
  }
54
54
  /** Returns the canonical built-in name when `name` collides (case-insensitively) with a reserved built-in item type, otherwise undefined. */
55
- export declare function matchBuiltinTypeName(name: string): string | undefined;
55
+ export declare function matchBuiltinTypeName(name:string):string | undefined;
56
56
  /** Escapes a value for safe interpolation inside a double-quoted shell string so suggested copy-pasteable commands stay well-formed for names containing `"`, `` ` ``, `$`, or `\`. */
57
- export declare function escapeForDoubleQuotes(value: string): string;
57
+ export declare function escapeForDoubleQuotes(value:string):string;
58
58
  /** Validates and normalizes raw add-type CLI input. Throws a plain Error with a stable message when the name is missing/empty or collides with a built-in; the CLI layer maps these to PmCliError exit codes. */
59
- export declare function normalizeAddTypeInput(raw: RawAddTypeInput): NormalizedAddTypeInput;
59
+ export declare function normalizeAddTypeInput(raw:RawAddTypeInput):NormalizedAddTypeInput;
60
60
  /** Throws when the requested name or any alias collides (case-insensitively) with the canonical name or an alias of a DIFFERENT existing definition. Such collisions would make `pm create`/`pm update --type` resolve ambiguously (the runtime registry keys a single lowercase alias map), so they are rejected. Tokens belonging to the same-named definition being upserted are ignored, keeping re-runs idempotent. */
61
- export declare function assertAliasesAvailable(input: NormalizedAddTypeInput, existing: ItemTypesFile): void;
61
+ export declare function assertAliasesAvailable(input:NormalizedAddTypeInput,existing:ItemTypesFile):void;
62
62
  /**
63
63
  * Throws when the requested type's storage folder would collide with a
64
64
  * DIFFERENT existing definition's folder. Two distinct type names can slug to
@@ -73,17 +73,17 @@ export declare function assertAliasesAvailable(input: NormalizedAddTypeInput, ex
73
73
  * those (e.g. "Tasks" → "tasks", owned by the built-in Task) is just as
74
74
  * corrupting as a custom-vs-custom collision, so both are checked.
75
75
  */
76
- export declare function assertTypeFolderAvailable(input: NormalizedAddTypeInput, existing: ItemTypesFile, reservedFolders?: ReadonlyMap<string, string>): void;
76
+ export declare function assertTypeFolderAvailable(input:NormalizedAddTypeInput,existing:ItemTypesFile,reservedFolders?:ReadonlyMap<string,string>):void;
77
77
  /** Coerces an arbitrary parsed value from types.json into an ItemTypesFile. Accepts the canonical `{ definitions: [...] }` shape, a bare array of definitions, or a nested `{ item_types: { definitions: [...] } }` form, and tolerates a missing/invalid file by returning an empty definitions list. */
78
- export declare function parseItemTypesFile(raw: string | null | undefined): ItemTypesFile;
78
+ export declare function parseItemTypesFile(raw:string | null | undefined):ItemTypesFile;
79
79
  /** Idempotent UPSERT of a custom item type into the parsed file. Matching is case-insensitive by name. When a definition already exists, fields supplied in `input` override the previous values; aliases are merged (deduped); other fields not addressed by add-type flags are preserved untouched. */
80
- export declare function upsertItemType(file: ItemTypesFile, input: NormalizedAddTypeInput): UpsertItemTypeResult;
80
+ export declare function upsertItemType(file:ItemTypesFile,input:NormalizedAddTypeInput):UpsertItemTypeResult;
81
81
  /** Removes a custom item type definition from the parsed file by name (case-insensitive). Throws a plain Error when `name` is empty or collides with a reserved built-in type (built-ins are not stored in the file and must never be deletable). Returns `removed: false` when no matching custom definition exists so the CLI layer can treat the call as an idempotent no-op. */
82
- export declare function removeItemType(file: ItemTypesFile, name: string | undefined): RemoveItemTypeResult;
82
+ export declare function removeItemType(file:ItemTypesFile,name:string | undefined):RemoveItemTypeResult;
83
83
  /** Serializes the item types file with a trailing newline (matches the rest of the schema scaffold files written by pm). */
84
- export declare function serializeItemTypesFile(file: ItemTypesFile): string;
84
+ export declare function serializeItemTypesFile(file:ItemTypesFile):string;
85
85
  /** Appends a discoverable hint to the "Invalid type" error so agents learn that custom types exist and how to register one. Quotes are chosen so the printed line is copy-pasteable as a shell command. */
86
- export declare function buildInvalidTypeHint(name: string, typesFilePath?: string): string;
86
+ export declare function buildInvalidTypeHint(name:string,typesFilePath?:string):string;
87
87
  /**
88
88
  * Builds the full invalid-type error message used by create/update: the
89
89
  * existing "Invalid type ... Allowed: ..." line plus the discoverable hint.
@@ -91,4 +91,4 @@ export declare function buildInvalidTypeHint(name: string, typesFilePath?: strin
91
91
  * tracker (see {@link resolveItemTypesFilePath}) so the hint reflects a custom
92
92
  * `--pm-path` instead of the hardcoded `.agents/pm` default.
93
93
  */
94
- export declare function buildInvalidTypeError(name: string, allowedTypes: readonly string[], typesFilePath?: string): string;
94
+ export declare function buildInvalidTypeError(name:string,allowedTypes:readonly string[],typesFilePath?:string):string;
@@ -1,5 +1,5 @@
1
- import type { RuntimeFieldCommand, RuntimeFieldRegistry } from "./runtime-schema.js";
1
+ import type { RuntimeFieldCommand,RuntimeFieldRegistry } from "./runtime-schema.js";
2
2
  /** Implements collect runtime filter values for the public runtime surface of this module. */
3
- export declare function collectRuntimeFilterValues(options: Record<string, unknown>, fieldRegistry: RuntimeFieldRegistry, command: RuntimeFieldCommand): Record<string, unknown>;
3
+ export declare function collectRuntimeFilterValues(options:Record<string,unknown>,fieldRegistry:RuntimeFieldRegistry,command:RuntimeFieldCommand):Record<string,unknown>;
4
4
  /** Implements matches runtime filters for the public runtime surface of this module. */
5
- export declare function matchesRuntimeFilters(item: Record<string, unknown>, filters: Record<string, unknown>): boolean;
5
+ export declare function matchesRuntimeFilters(item:Record<string,unknown>,filters:Record<string,unknown>):boolean;
@@ -1,12 +1,12 @@
1
- import { type RuntimeFieldDefinitionResolved, type RuntimeFieldRegistry } from "./runtime-schema.js";
1
+ import { type RuntimeFieldDefinitionResolved,type RuntimeFieldRegistry } from "./runtime-schema.js";
2
2
  /** Implements read runtime field option value for the public runtime surface of this module. */
3
- export declare function readRuntimeFieldOptionValue(options: Record<string, unknown>, definition: RuntimeFieldDefinitionResolved): unknown;
3
+ export declare function readRuntimeFieldOptionValue(options:Record<string,unknown>,definition:RuntimeFieldDefinitionResolved):unknown;
4
4
  /** Validate a declared field; option arrays represent repeated flags, while metadata containers retain their exact shape. */
5
- export declare function coerceRuntimeFieldValue(definition: RuntimeFieldDefinitionResolved, rawValue: unknown, labelOverride?: string, inputKind?: "option" | "metadata"): unknown;
5
+ export declare function coerceRuntimeFieldValue(definition:RuntimeFieldDefinitionResolved,rawValue:unknown,labelOverride?:string,inputKind?:"option" | "metadata"):unknown;
6
6
  /** Implements collect runtime create field values for the public runtime surface of this module. */
7
- export declare function collectRuntimeCreateFieldValues(options: Record<string, unknown>, fieldRegistry: RuntimeFieldRegistry, itemTypeName: string | undefined): {
8
- values: Record<string, unknown>;
9
- missing_required_flags: string[];
7
+ export declare function collectRuntimeCreateFieldValues(options:Record<string,unknown>,fieldRegistry:RuntimeFieldRegistry,itemTypeName:string | undefined):{
8
+ values:Record<string,unknown>;
9
+ missing_required_flags:string[];
10
10
  };
11
11
  /** Implements collect runtime update field values for the public runtime surface of this module. */
12
- export declare function collectRuntimeUpdateFieldValues(options: Record<string, unknown>, fieldRegistry: RuntimeFieldRegistry, commands?: Array<"update" | "update_many"> | null | undefined): Record<string, unknown>;
12
+ export declare function collectRuntimeUpdateFieldValues(options:Record<string,unknown>,fieldRegistry:RuntimeFieldRegistry,commands?:Array<"update" | "update_many"> | null | undefined):Record<string,unknown>;