@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
@@ -32,15 +32,15 @@
32
32
  * non-generic signature lets TypeScript type the handler parameter from the
33
33
  * declared function type.
34
34
  */
35
- import type { AfterCommandHook, BeforeCommandHook, BeforeMutationHook, CommandDefinition, CommandOverride, Exporter, ExtensionManifest, FlagDefinition, Importer, OnIndexHook, OnReadHook, OnWriteHook, ParserOverride, PreflightOverride, ScopedPreflightOverrideDefinition, RendererOverride, ScopedRendererOverrideDefinition, SchemaFieldDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SearchProviderDefinition, ServiceOverride, ServiceOverrideDecision, VectorStoreAdapterDefinition } from "../core/extensions/loader.js";
35
+ import type { AfterCommandHook,BeforeCommandHook,BeforeMutationHook,CommandDefinition,CommandOverride,Exporter,ExtensionManifest,FlagDefinition,Importer,OnIndexHook,OnReadHook,OnWriteHook,ParserOverride,PreflightOverride,ScopedPreflightOverrideDefinition,RendererOverride,ScopedRendererOverrideDefinition,SchemaFieldDefinition,SchemaItemTypeDefinition,SchemaMigrationDefinition,SearchProviderDefinition,ServiceOverride,ServiceOverrideDecision,VectorStoreAdapterDefinition } from "../core/extensions/loader.js";
36
36
  import type { ProjectProfileDefinition } from "../core/profile/profile-presets.js";
37
- type ExactDefinition<TDefinition, TContract> = TDefinition & Record<Exclude<keyof TDefinition, keyof TContract>, never>;
38
- type FlagAuthoringDefinition = Pick<FlagDefinition, "long" | "short" | "value_name" | "description" | "required" | "enabled" | "visible" | "value_type" | "type" | "list" | "default">;
39
- type ItemFieldAuthoringDefinition = Pick<SchemaFieldDefinition, "name" | "type" | "optional" | "default" | "values">;
40
- type ItemTypeAuthoringDefinition = Pick<SchemaItemTypeDefinition, "name" | "folder" | "aliases" | "required_create_fields" | "required_create_repeatables" | "command_option_policies" | "options" | "description" | "default_status" | "execution_role">;
41
- type MigrationAuthoringDefinition = Pick<SchemaMigrationDefinition, "id" | "description" | "status" | "mandatory" | "run">;
42
- type SearchProviderAuthoringDefinition = Pick<SearchProviderDefinition, "name" | "query" | "queryExpansion" | "query_expansion" | "rerank" | "embedBatch" | "embed_batch" | "embed">;
43
- type VectorStoreAdapterAuthoringDefinition = Pick<VectorStoreAdapterDefinition, "name" | "query" | "upsert" | "delete">;
37
+ type ExactDefinition<TDefinition,TContract> = TDefinition & Record<Exclude<keyof TDefinition,keyof TContract>,never>;
38
+ type FlagAuthoringDefinition = Pick<FlagDefinition,"long" | "short" | "value_name" | "description" | "required" | "enabled" | "visible" | "value_type" | "type" | "list" | "default">;
39
+ type ItemFieldAuthoringDefinition = Pick<SchemaFieldDefinition,"name" | "type" | "optional" | "default" | "values">;
40
+ type ItemTypeAuthoringDefinition = Pick<SchemaItemTypeDefinition,"name" | "folder" | "aliases" | "required_create_fields" | "required_create_repeatables" | "command_option_policies" | "options" | "description" | "default_status" | "execution_role">;
41
+ type MigrationAuthoringDefinition = Pick<SchemaMigrationDefinition,"id" | "description" | "status" | "mandatory" | "run">;
42
+ type SearchProviderAuthoringDefinition = Pick<SearchProviderDefinition,"name" | "query" | "queryExpansion" | "query_expansion" | "rerank" | "embedBatch" | "embed_batch" | "embed">;
43
+ type VectorStoreAdapterAuthoringDefinition = Pick<VectorStoreAdapterDefinition,"name" | "query" | "upsert" | "delete">;
44
44
  /**
45
45
  * Type an extension's in-module manifest mirror (the `manifest` export / field).
46
46
  *
@@ -51,7 +51,7 @@ type VectorStoreAdapterAuthoringDefinition = Pick<VectorStoreAdapterDefinition,
51
51
  * {@link ./compose.js#deriveExtensionCapabilities | `deriveExtensionCapabilities`}
52
52
  * to keep `capabilities` matched to the surfaces the extension actually registers.
53
53
  */
54
- export declare function defineExtensionManifest<TManifest extends ExtensionManifest>(manifest: TManifest): TManifest;
54
+ export declare function defineExtensionManifest<TManifest extends ExtensionManifest>(manifest:TManifest):TManifest;
55
55
  /**
56
56
  * Type a project-profile definition for the profile registry.
57
57
  *
@@ -64,7 +64,7 @@ export declare function defineExtensionManifest<TManifest extends ExtensionManif
64
64
  * typed at the definition site, mirroring {@link defineItemType}. It is the
65
65
  * authoring anchor a first-party or third-party profile package builds on.
66
66
  */
67
- export declare function defineProjectProfile<TProfile extends ProjectProfileDefinition>(profile: TProfile): TProfile;
67
+ export declare function defineProjectProfile<TProfile extends ProjectProfileDefinition>(profile:TProfile):TProfile;
68
68
  /**
69
69
  * Type a command definition for `api.registerCommand(definition)`.
70
70
  *
@@ -73,7 +73,7 @@ export declare function defineProjectProfile<TProfile extends ProjectProfileDefi
73
73
  * types. Pass the result straight to `registerCommand`, or export it so the
74
74
  * command can be invoked in tests via `runRegisteredCommandForTest`.
75
75
  */
76
- export declare function defineCommand<TDefinition extends CommandDefinition>(definition: TDefinition): TDefinition;
76
+ export declare function defineCommand<TDefinition extends CommandDefinition>(definition:TDefinition):TDefinition;
77
77
  /**
78
78
  * Type a single flag definition for a `api.registerFlags(command, flags)` array.
79
79
  *
@@ -82,14 +82,14 @@ export declare function defineCommand<TDefinition extends CommandDefinition>(def
82
82
  * per-flag contract checking — `value_type`, `list`, and `default` included —
83
83
  * instead of validating a loosely-typed literal array all at once.
84
84
  */
85
- export declare function defineFlag<TFlag extends FlagAuthoringDefinition>(flag: ExactDefinition<TFlag, FlagAuthoringDefinition>): TFlag;
85
+ export declare function defineFlag<TFlag extends FlagAuthoringDefinition>(flag:ExactDefinition<TFlag,FlagAuthoringDefinition>):TFlag;
86
86
  /**
87
87
  * Type a custom item-type definition for `api.registerItemTypes([...])`.
88
88
  *
89
89
  * Preserves the literal `name`/`folder`/`aliases` so a project archetype's
90
90
  * domain types stay strongly typed where the definition is declared and reused.
91
91
  */
92
- export declare function defineItemType<TType extends ItemTypeAuthoringDefinition>(type: ExactDefinition<TType, ItemTypeAuthoringDefinition>): TType;
92
+ export declare function defineItemType<TType extends ItemTypeAuthoringDefinition>(type:ExactDefinition<TType,ItemTypeAuthoringDefinition>):TType;
93
93
  /**
94
94
  * Type a custom item-metadata field definition for `api.registerItemFields([...])`.
95
95
  *
@@ -97,7 +97,7 @@ export declare function defineItemType<TType extends ItemTypeAuthoringDefinition
97
97
  * keeping the field's extra metadata (the contract carries an index signature)
98
98
  * intact.
99
99
  */
100
- export declare function defineItemField<TField extends ItemFieldAuthoringDefinition>(field: ExactDefinition<TField, ItemFieldAuthoringDefinition>): TField;
100
+ export declare function defineItemField<TField extends ItemFieldAuthoringDefinition>(field:ExactDefinition<TField,ItemFieldAuthoringDefinition>):TField;
101
101
  /**
102
102
  * Type a schema migration definition for `api.registerMigration(definition)`.
103
103
  *
@@ -105,7 +105,7 @@ export declare function defineItemField<TField extends ItemFieldAuthoringDefinit
105
105
  * runner's context, so the same definition can be registered and later exercised
106
106
  * through `runRegisteredMigrationForTest`.
107
107
  */
108
- export declare function defineMigration<TMigration extends MigrationAuthoringDefinition>(migration: ExactDefinition<TMigration, MigrationAuthoringDefinition>): TMigration;
108
+ export declare function defineMigration<TMigration extends MigrationAuthoringDefinition>(migration:ExactDefinition<TMigration,MigrationAuthoringDefinition>):TMigration;
109
109
  /**
110
110
  * Type a search-provider definition for `api.registerSearchProvider(provider)`.
111
111
  *
@@ -113,7 +113,7 @@ export declare function defineMigration<TMigration extends MigrationAuthoringDef
113
113
  * so a custom retrieval backend is type-checked at the definition site and
114
114
  * reusable in `runRegisteredSearchProviderForTest`.
115
115
  */
116
- export declare function defineSearchProvider<TProvider extends SearchProviderAuthoringDefinition>(provider: ExactDefinition<TProvider, SearchProviderAuthoringDefinition>): TProvider;
116
+ export declare function defineSearchProvider<TProvider extends SearchProviderAuthoringDefinition>(provider:ExactDefinition<TProvider,SearchProviderAuthoringDefinition>):TProvider;
117
117
  /**
118
118
  * Type a vector-store adapter definition for `api.registerVectorStoreAdapter(adapter)`.
119
119
  *
@@ -121,7 +121,7 @@ export declare function defineSearchProvider<TProvider extends SearchProviderAut
121
121
  * its own semantic index storage gets contract checking before activation and a
122
122
  * definition it can drive through `runRegisteredVectorStoreAdapterForTest`.
123
123
  */
124
- export declare function defineVectorStoreAdapter<TAdapter extends VectorStoreAdapterAuthoringDefinition>(adapter: ExactDefinition<TAdapter, VectorStoreAdapterAuthoringDefinition>): TAdapter;
124
+ export declare function defineVectorStoreAdapter<TAdapter extends VectorStoreAdapterAuthoringDefinition>(adapter:ExactDefinition<TAdapter,VectorStoreAdapterAuthoringDefinition>):TAdapter;
125
125
  /**
126
126
  * Type a command-override handler for `api.registerCommand(command, override)`.
127
127
  *
@@ -129,7 +129,7 @@ export declare function defineVectorStoreAdapter<TAdapter extends VectorStoreAda
129
129
  * `context` parameter from {@link CommandOverride}, so a bare arrow authored in
130
130
  * a `.js` package still gets a fully-typed argument.
131
131
  */
132
- export declare function defineCommandOverride(override: CommandOverride): CommandOverride;
132
+ export declare function defineCommandOverride(override:CommandOverride):CommandOverride;
133
133
  /**
134
134
  * Type a parser-override handler for `api.registerParser(command, override)`.
135
135
  *
@@ -137,16 +137,16 @@ export declare function defineCommandOverride(override: CommandOverride): Comman
137
137
  * {@link ParserOverride} delta so an argument-rewriting override is checked
138
138
  * where it is written.
139
139
  */
140
- export declare function defineParserOverride(override: ParserOverride): ParserOverride;
140
+ export declare function defineParserOverride(override:ParserOverride):ParserOverride;
141
141
  /**
142
142
  * Type a preflight-override handler for `api.registerPreflight(override)`.
143
143
  *
144
144
  * Contextually types the `context` parameter and the returned gate decision so a
145
145
  * package's pre-run validation override is checked at the definition site.
146
146
  */
147
- export declare function definePreflightOverride(override: PreflightOverride): PreflightOverride;
147
+ export declare function definePreflightOverride(override:PreflightOverride):PreflightOverride;
148
148
  /** Type a scoped preflight definition while preserving literal command ownership. */
149
- export declare function definePreflightOverride<TDefinition extends ScopedPreflightOverrideDefinition>(override: ExactDefinition<TDefinition, ScopedPreflightOverrideDefinition>): TDefinition;
149
+ export declare function definePreflightOverride<TDefinition extends ScopedPreflightOverrideDefinition>(override:ExactDefinition<TDefinition,ScopedPreflightOverrideDefinition>):TDefinition;
150
150
  /**
151
151
  * Type a service-override handler for `api.registerService(service, override)`.
152
152
  *
@@ -154,26 +154,26 @@ export declare function definePreflightOverride<TDefinition extends ScopedPrefli
154
154
  * package overriding a built-in service (output formatting, embeddings, and the
155
155
  * like) keeps its handler argument typed without an explicit annotation.
156
156
  */
157
- export declare function defineServiceOverride(override: ServiceOverride): ServiceOverride;
157
+ export declare function defineServiceOverride(override:ServiceOverride):ServiceOverride;
158
158
  /** Explicitly claim a service payload and publish its replacement result. */
159
- export declare function handleServiceOverride<const TResult>(result: TResult): {
160
- handled: true;
161
- result: TResult;
159
+ export declare function handleServiceOverride<const TResult>(result:TResult):{
160
+ handled:true;
161
+ result:TResult;
162
162
  };
163
163
  /** Explicitly decline a service payload so the next override or host handles it. */
164
- export declare function declineServiceOverride(): ServiceOverrideDecision;
164
+ export declare function declineServiceOverride():ServiceOverrideDecision;
165
165
  /**
166
166
  * Type a renderer-override handler for `api.registerRenderer(format, renderer)`.
167
167
  *
168
168
  * Contextually types the `context` parameter and the `string | null | undefined`
169
169
  * return contract so a custom output renderer is checked where it is authored.
170
170
  */
171
- export declare function defineRendererOverride(renderer: RendererOverride): RendererOverride;
171
+ export declare function defineRendererOverride(renderer:RendererOverride):RendererOverride;
172
172
  /**
173
173
  * Type a scoped renderer definition while preserving its command/result
174
174
  * ownership literals for declarative composition and static introspection.
175
175
  */
176
- export declare function defineRendererOverride<TDefinition extends ScopedRendererOverrideDefinition>(renderer: ExactDefinition<TDefinition, ScopedRendererOverrideDefinition>): TDefinition;
176
+ export declare function defineRendererOverride<TDefinition extends ScopedRendererOverrideDefinition>(renderer:ExactDefinition<TDefinition,ScopedRendererOverrideDefinition>):TDefinition;
177
177
  /**
178
178
  * Type an importer handler for `api.registerImporter(name, importer, options)`.
179
179
  *
@@ -181,7 +181,7 @@ export declare function defineRendererOverride<TDefinition extends ScopedRendere
181
181
  * options, pm root) so the bridge from an external system into the pm context
182
182
  * graph is type-checked and reusable in `runRegisteredImporterForTest`.
183
183
  */
184
- export declare function defineImporter(importer: Importer): Importer;
184
+ export declare function defineImporter(importer:Importer):Importer;
185
185
  /**
186
186
  * Type an exporter handler for `api.registerExporter(name, exporter, options)`.
187
187
  *
@@ -189,7 +189,7 @@ export declare function defineImporter(importer: Importer): Importer;
189
189
  * context graph out to an external system is checked at the definition site and
190
190
  * reusable in `runRegisteredExporterForTest`.
191
191
  */
192
- export declare function defineExporter(exporter: Exporter): Exporter;
192
+ export declare function defineExporter(exporter:Exporter):Exporter;
193
193
  /**
194
194
  * Type a `before_command` hook for `api.hooks.beforeCommand(hook)`.
195
195
  *
@@ -197,9 +197,9 @@ export declare function defineExporter(exporter: Exporter): Exporter;
197
197
  * inspects or annotates a command before it runs keeps its argument typed when
198
198
  * authored as a standalone, exportable, testable value.
199
199
  */
200
- export declare function defineBeforeCommandHook(hook: BeforeCommandHook): BeforeCommandHook;
200
+ export declare function defineBeforeCommandHook(hook:BeforeCommandHook):BeforeCommandHook;
201
201
  /** Type a fail-closed `before_mutation` guard for `api.hooks.beforeMutation(hook)`. */
202
- export declare function defineBeforeMutationHook(hook: BeforeMutationHook): BeforeMutationHook;
202
+ export declare function defineBeforeMutationHook(hook:BeforeMutationHook):BeforeMutationHook;
203
203
  /**
204
204
  * Type an `after_command` hook for `api.hooks.afterCommand(hook)`.
205
205
  *
@@ -207,21 +207,21 @@ export declare function defineBeforeMutationHook(hook: BeforeMutationHook): Befo
207
207
  * `affected` items pm mutated — so the natural place to react to every change
208
208
  * ("project management = context management") is checked where it is written.
209
209
  */
210
- export declare function defineAfterCommandHook(hook: AfterCommandHook): AfterCommandHook;
210
+ export declare function defineAfterCommandHook(hook:AfterCommandHook):AfterCommandHook;
211
211
  /**
212
212
  * Type an `on_write` hook for `api.hooks.onWrite(hook)`.
213
213
  *
214
214
  * Contextually types the {@link OnWriteHook} `context` so a hook reacting to
215
215
  * item persistence keeps its argument typed without an explicit annotation.
216
216
  */
217
- export declare function defineOnWriteHook(hook: OnWriteHook): OnWriteHook;
217
+ export declare function defineOnWriteHook(hook:OnWriteHook):OnWriteHook;
218
218
  /**
219
219
  * Type an `on_read` hook for `api.hooks.onRead(hook)`.
220
220
  *
221
221
  * Contextually types the {@link OnReadHook} `context` so a hook augmenting items
222
222
  * as they are read is type-checked at the definition site.
223
223
  */
224
- export declare function defineOnReadHook(hook: OnReadHook): OnReadHook;
224
+ export declare function defineOnReadHook(hook:OnReadHook):OnReadHook;
225
225
  /**
226
226
  * Type an `on_index` hook for `api.hooks.onIndex(hook)`.
227
227
  *
@@ -229,5 +229,5 @@ export declare function defineOnReadHook(hook: OnReadHook): OnReadHook;
229
229
  * in index/search refresh keeps its argument typed even without TypeScript
230
230
  * annotations.
231
231
  */
232
- export declare function defineOnIndexHook(hook: OnIndexHook): OnIndexHook;
232
+ export declare function defineOnIndexHook(hook:OnIndexHook):OnIndexHook;
233
233
  export {};
@@ -1,116 +1,116 @@
1
1
  import type { GlobalOptions } from "../core/shared/command-types.js";
2
- import type { ItemMetadata, ItemStatus, ItemType } from "../types/index.js";
2
+ import type { ItemMetadata,ItemStatus,ItemType } from "../types/index.js";
3
3
  import { type OutputProjectionDeclaration } from "./output-projection.js";
4
4
  import { type DanglingDependencyReference } from "./graph/assembly.js";
5
5
  import { type RelationshipContextResult } from "./relationship-context.js";
6
6
  import { type RelationshipKindRegistry } from "./relationships.js";
7
7
  /** Supported values accepted by the deps format contract. */
8
- export declare const DEPS_FORMAT_VALUES: readonly ["tree", "graph", "context"];
8
+ export declare const DEPS_FORMAT_VALUES:readonly ["tree","graph","context"];
9
9
  /** Restricts deps format values accepted by command, SDK, and storage contracts. */
10
10
  export type DepsFormat = (typeof DEPS_FORMAT_VALUES)[number];
11
11
  /** Supported values accepted by the deps collapse contract. */
12
- export declare const DEPS_COLLAPSE_VALUES: readonly ["none", "repeated"];
12
+ export declare const DEPS_COLLAPSE_VALUES:readonly ["none","repeated"];
13
13
  /** Restricts deps collapse mode values accepted by command, SDK, and storage contracts. */
14
14
  export type DepsCollapseMode = (typeof DEPS_COLLAPSE_VALUES)[number];
15
15
  /** Supported values accepted by the deps graph-context direction contract. */
16
- export declare const DEPS_DIRECTION_VALUES: readonly ["outgoing", "incoming", "both"];
16
+ export declare const DEPS_DIRECTION_VALUES:readonly ["outgoing","incoming","both"];
17
17
  /** Restricts deps traversal-direction values accepted by command, SDK, and storage contracts. */
18
18
  export type DepsDirection = (typeof DEPS_DIRECTION_VALUES)[number];
19
19
  /** Documents the deps command options payload exchanged by command, SDK, and package integrations. */
20
20
  export interface DepsCommandOptions {
21
21
  /** Value that configures or reports format for this contract. */
22
- format?: string;
22
+ format?:string;
23
23
  /** Value that configures or reports max depth for this contract. */
24
- maxDepth?: string | number;
24
+ maxDepth?:string | number;
25
25
  /** Value that configures or reports collapse for this contract. */
26
- collapse?: string;
26
+ collapse?:string;
27
27
  /** Value that configures or reports summary for this contract. */
28
- summary?: boolean;
28
+ summary?:boolean;
29
29
  /** Explicitly restore the complete row projection after a summary read. */
30
- full?: boolean;
30
+ full?:boolean;
31
31
  /** Maximum graph-context nodes returned. */
32
- nodeLimit?: string | number;
32
+ nodeLimit?:string | number;
33
33
  /** Maximum graph-context edges and enumerated missing-reference rows returned. */
34
- edgeLimit?: string | number;
34
+ edgeLimit?:string | number;
35
35
  /** Maximum estimated graph-context output tokens. */
36
- tokenBudget?: string | number;
36
+ tokenBudget?:string | number;
37
37
  /** Opaque continuation cursor for graph-context output. */
38
- cursor?: string;
38
+ cursor?:string;
39
39
  /** Graph-context traversal direction relative to each visited node. */
40
- direction?: string;
40
+ direction?:string;
41
41
  /** Registered relationship kinds narrowing graph-context traversal. */
42
- kind?: string | string[];
42
+ kind?:string | string[];
43
43
  }
44
44
  /** Documents the deps tree node payload exchanged by command, SDK, and package integrations. */
45
45
  export interface DepsTreeNode {
46
46
  /** Stable identifier used to reference this record across commands and storage. */
47
- id: string;
47
+ id:string;
48
48
  /** Value that configures or reports title for this contract. */
49
- title?: string;
49
+ title?:string;
50
50
  /** Schema type that determines the shape and validation rules for this value. */
51
- type?: ItemType;
51
+ type?:ItemType;
52
52
  /** Lifecycle state reported for status. */
53
- status?: ItemStatus;
53
+ status?:ItemStatus;
54
54
  /** Value that configures or reports via for this contract. */
55
- via?: string;
55
+ via?:string;
56
56
  /** Value that configures or reports missing for this contract. */
57
- missing: boolean;
57
+ missing:boolean;
58
58
  /** Value that configures or reports cycle for this contract. */
59
- cycle: boolean;
59
+ cycle:boolean;
60
60
  /** Value that configures or reports truncated for this contract. */
61
- truncated?: boolean;
61
+ truncated?:boolean;
62
62
  /** Value that configures or reports collapsed for this contract. */
63
- collapsed?: boolean;
63
+ collapsed?:boolean;
64
64
  /** Value that configures or reports dependencies for this contract. */
65
- dependencies: DepsTreeNode[];
65
+ dependencies:DepsTreeNode[];
66
66
  }
67
67
  /** Documents the deps graph node payload exchanged by command, SDK, and package integrations. */
68
68
  export interface DepsGraphNode {
69
69
  /** Stable identifier used to reference this record across commands and storage. */
70
- id: string;
70
+ id:string;
71
71
  /** Value that configures or reports title for this contract. */
72
- title?: string;
72
+ title?:string;
73
73
  /** Schema type that determines the shape and validation rules for this value. */
74
- type?: ItemType;
74
+ type?:ItemType;
75
75
  /** Lifecycle state reported for status. */
76
- status?: ItemStatus;
76
+ status?:ItemStatus;
77
77
  /** Value that configures or reports missing for this contract. */
78
- missing: boolean;
78
+ missing:boolean;
79
79
  }
80
80
  /** Documents the deps graph edge payload exchanged by command, SDK, and package integrations. */
81
81
  export interface DepsGraphEdge {
82
82
  /** Value that configures or reports from for this contract. */
83
- from: string;
83
+ from:string;
84
84
  /** Value that configures or reports to for this contract. */
85
- to: string;
85
+ to:string;
86
86
  /** Value that configures or reports kind for this contract. */
87
- kind: string;
87
+ kind:string;
88
88
  }
89
89
  /** Documents the deps graph result payload exchanged by command, SDK, and package integrations. */
90
90
  export interface DepsGraphResult {
91
91
  /** Value that configures or reports root id for this contract. */
92
- root_id: string;
92
+ root_id:string;
93
93
  /** Value that configures or reports nodes for this contract. */
94
- nodes: DepsGraphNode[];
94
+ nodes:DepsGraphNode[];
95
95
  /** Value that configures or reports edges for this contract. */
96
- edges: DepsGraphEdge[];
96
+ edges:DepsGraphEdge[];
97
97
  /** Value that configures or reports missing ids for this contract. */
98
- missing_ids: string[];
98
+ missing_ids:string[];
99
99
  }
100
100
  /** Documents the deps result payload exchanged by command, SDK, and package integrations. */
101
101
  export interface DepsResult {
102
102
  /** Stable identifier used to reference this record across commands and storage. */
103
- id: string;
103
+ id:string;
104
104
  /** Value that configures or reports format for this contract. */
105
- format: DepsFormat;
105
+ format:DepsFormat;
106
106
  /** Number of node entries represented by this result. */
107
- node_count: number;
107
+ node_count:number;
108
108
  /** Number of edge entries represented by this result. */
109
- edge_count: number;
109
+ edge_count:number;
110
110
  /** Counting convention used by edge_count. */
111
- edge_basis: "deduplicated_directed";
111
+ edge_basis:"deduplicated_directed";
112
112
  /** Stored legacy relationship aliases grouped by spelling across the workspace. */
113
- legacy_alias_counts?: Record<string, number>;
113
+ legacy_alias_counts?:Record<string,number>;
114
114
  /**
115
115
  * Number of missing entries represented by this result.
116
116
  *
@@ -120,60 +120,60 @@ legacy_alias_counts?: Record<string, number>;
120
120
  * packet, independent of node or token pagination, so the two formats agree
121
121
  * for equal traversal parameters over the dependency edge family.
122
122
  */
123
- missing_count: number;
123
+ missing_count:number;
124
124
  /** Traversal scope documenting the missing_count semantics for context format. */
125
- missing_scope?: "traversal";
125
+ missing_scope?:"traversal";
126
126
  /** Total dangling references declared into the traversed missing nodes. */
127
- missing_reference_count?: number;
127
+ missing_reference_count?:number;
128
128
  /** Bounded enumeration of dangling references, capped by the context edge limit. */
129
- missing_references?: DanglingDependencyReference[];
129
+ missing_references?:DanglingDependencyReference[];
130
130
  /** Explicit bounded-projection metadata when tree or graph rows were omitted. */
131
- truncation?: {
131
+ truncation?:{
132
132
  /** Stable reasons explaining which bounds stopped expansion. */
133
- reasons: Array<"max_depth" | "node_limit" | "edge_limit" | "token_budget">;
133
+ reasons:Array<"max_depth" | "node_limit" | "edge_limit" | "token_budget">;
134
134
  /** Effective bounds applied to this projection. */
135
- limits: {
136
- max_depth: number;
137
- node_limit: number;
138
- edge_limit: number;
139
- token_budget: number;
135
+ limits:{
136
+ max_depth:number;
137
+ node_limit:number;
138
+ edge_limit:number;
139
+ token_budget:number;
140
140
  };
141
141
  /** Conservative token estimate consumed by emitted tree rows and edges. */
142
- estimated_tokens: number;
142
+ estimated_tokens:number;
143
143
  /** Full unique-node census reachable without projection bounds. */
144
- total_node_count: number;
144
+ total_node_count:number;
145
145
  /** Full unique-edge census reachable without projection bounds. */
146
- total_edge_count: number;
146
+ total_edge_count:number;
147
147
  /** Unique nodes omitted from the returned projection. */
148
- omitted_node_count: number;
148
+ omitted_node_count:number;
149
149
  /** Unique edges omitted from the returned projection. */
150
- omitted_edge_count: number;
150
+ omitted_edge_count:number;
151
151
  };
152
152
  /** Value that configures or reports tree for this contract. */
153
- tree?: DepsTreeNode;
153
+ tree?:DepsTreeNode;
154
154
  /** Value that configures or reports graph for this contract. */
155
- graph?: DepsGraphResult;
155
+ graph?:DepsGraphResult;
156
156
  /** Explainable bounded graph-context projection. */
157
- context?: RelationshipContextResult;
157
+ context?:RelationshipContextResult;
158
158
  /** Self-describing row projection used to derive a bounded omission receipt. */
159
- projection: OutputProjectionDeclaration;
159
+ projection:OutputProjectionDeclaration;
160
160
  }
161
161
  /** Parse one positive-integer graph bound, failing fast with the offending flag name. */
162
- export declare function parsePositiveInteger(raw: string | number | undefined, flag: string): number | undefined;
162
+ export declare function parsePositiveInteger(raw:string | number | undefined,flag:string):number | undefined;
163
163
  /** Parse the shared non-negative --max-depth traversal bound. */
164
- export declare function parseMaxDepth(raw: string | number | undefined): number | undefined;
164
+ export declare function parseMaxDepth(raw:string | number | undefined):number | undefined;
165
165
  /** Parse the shared graph traversal --direction value, defaulting to "both". */
166
- export declare function parseDirection(raw: string | undefined): DepsDirection;
166
+ export declare function parseDirection(raw:string | undefined):DepsDirection;
167
167
  /**
168
168
  * Normalize repeatable and comma-separated --kind values against one
169
169
  * relationship ontology, failing fast on unknown kinds instead of silently
170
170
  * matching nothing (the multi-value filter-grammar trap tracked by pm-gknu).
171
171
  */
172
- export declare function parseKinds(raw: string | string[] | undefined, registry?: RelationshipKindRegistry): string[] | undefined;
172
+ export declare function parseKinds(raw:string | string[] | undefined,registry?:RelationshipKindRegistry):string[] | undefined;
173
173
  /** Options subset consumed by the deps graph-context projection. */
174
- type DepsContextOptions = Pick<DepsCommandOptions, "maxDepth" | "nodeLimit" | "edgeLimit" | "tokenBudget" | "cursor" | "direction" | "kind">;
174
+ type DepsContextOptions = Pick<DepsCommandOptions,"maxDepth" | "nodeLimit" | "edgeLimit" | "tokenBudget" | "cursor" | "direction" | "kind">;
175
175
  /** Build the SDK-backed bounded relationship-context projection for deps. */
176
- export declare function buildDepsRelationshipContext(rootId: string, items: readonly ItemMetadata[], options: DepsContextOptions, rootEvidence?: readonly string[]): RelationshipContextResult;
176
+ export declare function buildDepsRelationshipContext(rootId:string,items:readonly ItemMetadata[],options:DepsContextOptions,rootEvidence?:readonly string[]):RelationshipContextResult;
177
177
  /** Implements run deps for the public runtime surface of this module. */
178
- export declare function runDeps(id: string, options: DepsCommandOptions, global: GlobalOptions): Promise<DepsResult>;
178
+ export declare function runDeps(id:string,options:DepsCommandOptions,global:GlobalOptions):Promise<DepsResult>;
179
179
  export {};
@@ -1,14 +1,14 @@
1
- import type { Dependency, ItemFormat, RuntimeSchemaSettings } from "../types/index.js";
1
+ import type { Dependency,ItemFormat,RuntimeSchemaSettings } from "../types/index.js";
2
2
  import { type RelationshipKindRegistry } from "./relationships.js";
3
3
  /** Resolve mutation spellings through the active ontology and advertise its vocabulary on refusal. */
4
- export declare function requireDependencyKind(value: string, registry?: RelationshipKindRegistry): string;
4
+ export declare function requireDependencyKind(value:string,registry?:RelationshipKindRegistry):string;
5
5
  /** Reject malformed shorthand before item-id prefix normalization can create a dangling graph node. */
6
- export declare function assertValidBareDependencyFlagValue(value: string, structured: boolean, flag?: string): void;
6
+ export declare function assertValidBareDependencyFlagValue(value:string,structured:boolean,flag?:string):void;
7
7
  /**
8
8
  * Validate prospective stored dependencies against the active relationship
9
9
  * ontology before a create or update mutation writes item or history state.
10
10
  */
11
- export declare function assertDependencyEdgesAllowed(holderId: string, dependencies: readonly Dependency[] | undefined, registry?: RelationshipKindRegistry): void;
11
+ export declare function assertDependencyEdgesAllowed(holderId:string,dependencies:readonly Dependency[] | undefined,registry?:RelationshipKindRegistry):void;
12
12
  /**
13
13
  * Resolve every newly supplied local dependency and enforce declared endpoint
14
14
  * chronology before a mutation commits.
@@ -16,17 +16,17 @@ export declare function assertDependencyEdgesAllowed(holderId: string, dependenc
16
16
  * unresolved mode returns durable warning tokens instead of pretending that
17
17
  * the graph edge resolved successfully.
18
18
  */
19
- export declare function assertDependencyTargetsResolvable(params: {
20
- pmRoot: string;
21
- dependencies: readonly Dependency[] | undefined;
22
- idPrefix: string;
23
- itemFormat: ItemFormat;
24
- typeToFolder: Record<string, string>;
25
- allowUnresolved?: boolean;
26
- holders?: readonly {
27
- id: string;
28
- createdAt?: string;
19
+ export declare function assertDependencyTargetsResolvable(params:{
20
+ pmRoot:string;
21
+ dependencies:readonly Dependency[] | undefined;
22
+ idPrefix:string;
23
+ itemFormat:ItemFormat;
24
+ typeToFolder:Record<string,string>;
25
+ allowUnresolved?:boolean;
26
+ holders?:readonly {
27
+ id:string;
28
+ createdAt?:string;
29
29
  }[];
30
- schema?: RuntimeSchemaSettings;
31
- registry?: RelationshipKindRegistry;
32
- }): Promise<string[]>;
30
+ schema?:RuntimeSchemaSettings;
31
+ registry?:RelationshipKindRegistry;
32
+ }):Promise<string[]>;
@@ -1,70 +1,70 @@
1
- export { isExternalDependencyReference, isExternalDependencySourceKind, } from "../core/item/dependency-reference.js";
1
+ export { isExternalDependencyReference,isExternalDependencySourceKind,} from "../core/item/dependency-reference.js";
2
2
  /** Provenance value declaring that a dependency id belongs to another workspace. */
3
3
  export declare const EXTERNAL_DEPENDENCY_SOURCE_KIND = "global";
4
4
  /** Human-facing alias accepted wherever external dependency provenance is parsed. */
5
5
  export declare const EXTERNAL_DEPENDENCY_SOURCE_KIND_ALIAS = "external";
6
6
  /** Stable external lifecycle values understood without coupling core to a provider. */
7
- export declare const EXTERNAL_DEPENDENCY_RESOLUTION_STATUSES: readonly ["open", "closed", "unknown"];
7
+ export declare const EXTERNAL_DEPENDENCY_RESOLUTION_STATUSES:readonly ["open","closed","unknown"];
8
8
  /** External lifecycle value returned by a registered dependency resolver. */
9
9
  export type ExternalDependencyResolutionStatus = (typeof EXTERNAL_DEPENDENCY_RESOLUTION_STATUSES)[number];
10
10
  /** Provider-owned external dependency data before the SDK applies output bounds. */
11
11
  export interface ExternalDependencyResolverResult {
12
12
  /** Provider lifecycle state normalized to the universal external status vocabulary. */
13
- status: ExternalDependencyResolutionStatus;
13
+ status:ExternalDependencyResolutionStatus;
14
14
  /** Optional bounded human context for the remote dependency. */
15
- title?: string;
15
+ title?:string;
16
16
  /** Optional canonical provider URL or locator used as evidence. */
17
- source?: string;
17
+ source?:string;
18
18
  /** Optional provider observation timestamp; invalid timestamps are replaced by SDK time. */
19
- checkedAt?: string;
19
+ checkedAt?:string;
20
20
  }
21
21
  /** Package-provided resolver contract for one or more external dependency locator families. */
22
22
  export interface ExternalDependencyResolver {
23
23
  /** Stable resolver identity surfaced in agent-facing evidence. */
24
- name: string;
24
+ name:string;
25
25
  /** Return whether this resolver owns the supplied external locator. */
26
- supports(reference: string): boolean;
26
+ supports(reference:string):boolean;
27
27
  /** Resolve the locator without exposing provider credentials or unbounded response data. */
28
- resolve(reference: string): Promise<ExternalDependencyResolverResult | null>;
28
+ resolve(reference:string):Promise<ExternalDependencyResolverResult | null>;
29
29
  }
30
30
  /** Bounded provider-neutral evidence returned by the public resolver registry. */
31
31
  export interface ExternalDependencyResolution {
32
32
  /** Original normalized dependency locator. */
33
- id: string;
33
+ id:string;
34
34
  /** Provider lifecycle state. */
35
- status: ExternalDependencyResolutionStatus;
35
+ status:ExternalDependencyResolutionStatus;
36
36
  /** Whether trusted provider evidence proves the blocker terminal. */
37
- resolved: boolean;
37
+ resolved:boolean;
38
38
  /** Bounded remote title, or null when the provider did not supply one. */
39
- title: string | null;
39
+ title:string | null;
40
40
  /** Bounded evidence locator. */
41
- source: string;
41
+ source:string;
42
42
  /** Observation timestamp supplied by the provider or SDK clock. */
43
- checked_at: string;
43
+ checked_at:string;
44
44
  /** Registered resolver identity that produced this evidence. */
45
- resolver: string;
45
+ resolver:string;
46
46
  }
47
47
  /** Deterministic clock override for external resolver acceptance and tests. */
48
48
  export interface ExternalDependencyResolutionOptions {
49
49
  /** Return the timestamp used when provider evidence omits or corrupts checkedAt. */
50
- now?: () => string;
50
+ now?:() => string;
51
51
  }
52
52
  /** Register a package-owned external dependency resolver and return its idempotent disposer. */
53
- export declare function registerExternalDependencyResolver(resolver: ExternalDependencyResolver): () => void;
53
+ export declare function registerExternalDependencyResolver(resolver:ExternalDependencyResolver):() => void;
54
54
  /** Resolve one external locator through registered package providers with bounded provider-neutral evidence. */
55
- export declare function resolveExternalDependencyReference(reference: string, options?: ExternalDependencyResolutionOptions): Promise<ExternalDependencyResolution | null>;
55
+ export declare function resolveExternalDependencyReference(reference:string,options?:ExternalDependencyResolutionOptions):Promise<ExternalDependencyResolution | null>;
56
56
  /** Canonicalize external provenance while preserving other named source kinds. */
57
- export declare function normalizeDependencySourceKind(sourceKind: string | undefined): string | undefined;
57
+ export declare function normalizeDependencySourceKind(sourceKind:string | undefined):string | undefined;
58
58
  /**
59
59
  * Normalize a dependency seed id without corrupting cross-workspace identity.
60
60
  * Local and legacy seeds retain normal workspace-prefix behavior; explicitly
61
61
  * global seeds preserve the caller-provided id verbatim (apart from trimming).
62
62
  */
63
- export declare function normalizeDependencySeedId(id: string, prefix: string, sourceKind: string | undefined): string;
63
+ export declare function normalizeDependencySeedId(id:string,prefix:string,sourceKind:string | undefined):string;
64
64
  /**
65
65
  * Canonicalize a local relationship target using the workspace prefix. Explicit
66
66
  * provider locators and externally sourced identities retain case and spelling;
67
67
  * only surrounding whitespace is removed. Resolution and parent policy remain
68
68
  * the caller's responsibility, so dangling local ids are never guessed remote.
69
69
  */
70
- export declare function normalizeItemReference(reference: string, prefix: string, sourceKind?: string): string;
70
+ export declare function normalizeItemReference(reference:string,prefix:string,sourceKind?:string):string;