@unbrained/pm-cli 2026.10.14 → 2026.10.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (692) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +54 -2
  3. package/dist/cli/after-command-context-usage.d.ts +7 -7
  4. package/dist/cli/argv-utils.d.ts +4 -4
  5. package/dist/cli/bundle-integrity.d.ts +16 -16
  6. package/dist/cli/command-namespaces.d.ts +1 -1
  7. package/dist/cli/commander-usage.d.ts +34 -34
  8. package/dist/cli/commands/governance/validate.d.ts +1 -1
  9. package/dist/cli/commands/history/history-compact.d.ts +1 -1
  10. package/dist/cli/commands/history/history-redact.d.ts +1 -1
  11. package/dist/cli/commands/history/history-repair.d.ts +1 -1
  12. package/dist/cli/commands/history/restore.d.ts +1 -1
  13. package/dist/cli/commands/lifecycle/close.d.ts +1 -1
  14. package/dist/cli/commands/lifecycle/copy.d.ts +1 -1
  15. package/dist/cli/commands/lifecycle/delete.d.ts +1 -1
  16. package/dist/cli/commands/lifecycle/focus.d.ts +1 -1
  17. package/dist/cli/commands/query/get.d.ts +1 -1
  18. package/dist/cli/commands/workspace/merge.d.ts +1 -1
  19. package/dist/cli/commands/workspace/schema.d.ts +1 -1
  20. package/dist/cli/context-intent-invocation.d.ts +1 -1
  21. package/dist/cli/description-stdin.d.ts +1 -1
  22. package/dist/cli/error-guidance.d.ts +119 -119
  23. package/dist/cli/extension-command-help.d.ts +64 -64
  24. package/dist/cli/extension-command-help.js +2 -2
  25. package/dist/cli/extension-command-options.d.ts +16 -16
  26. package/dist/cli/extension-recovery.d.ts +13 -13
  27. package/dist/cli/help-content.d.ts +22 -22
  28. package/dist/cli/help-content.js +2 -2
  29. package/dist/cli/help-json-payload.d.ts +45 -45
  30. package/dist/cli/invocation-profile.d.ts +5 -5
  31. package/dist/cli/main.d.ts +217 -217
  32. package/dist/cli/migration-gates.d.ts +24 -24
  33. package/dist/cli/option-values.d.ts +1 -1
  34. package/dist/cli/public.d.ts +1 -1
  35. package/dist/cli/register-annotations.d.ts +2 -2
  36. package/dist/cli/register-assurance.d.ts +1 -1
  37. package/dist/cli/register-files-lookup.d.ts +1 -1
  38. package/dist/cli/register-history-activity.d.ts +1 -1
  39. package/dist/cli/register-history-author.d.ts +1 -1
  40. package/dist/cli/register-history-maintenance.d.ts +1 -1
  41. package/dist/cli/register-list-query.d.ts +7 -7
  42. package/dist/cli/register-list-query.js +3 -3
  43. package/dist/cli/register-mutation-options.d.ts +1 -1
  44. package/dist/cli/register-mutation.d.ts +4 -4
  45. package/dist/cli/register-operations.d.ts +75 -75
  46. package/dist/cli/register-setup.d.ts +4 -4
  47. package/dist/cli/register-structured-mutation.d.ts +8 -8
  48. package/dist/cli/runtime/activation.d.ts +23 -23
  49. package/dist/cli/runtime/invocation-options.d.ts +12 -12
  50. package/dist/cli/runtime/projection-retry.d.ts +1 -1
  51. package/dist/cli/runtime/selection.d.ts +16 -16
  52. package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
  53. package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
  54. package/dist/cli/schema/registration.d.ts +1 -1
  55. package/dist/cli/schema-registration-helpers.d.ts +2 -2
  56. package/dist/cli/stats-analytics-json.d.ts +1 -1
  57. package/dist/cli-bundle/bundle-manifest.json +1 -1
  58. package/dist/cli-bundle/chunks/{chunk-5LU6PWA4.js → chunk-52EZH2QQ.js} +2 -2
  59. package/dist/cli-bundle/chunks/chunk-7OEGNA4X.js +20 -0
  60. package/dist/cli-bundle/chunks/{chunk-LKESCZEN.js → chunk-7VHINXZP.js} +2 -2
  61. package/dist/cli-bundle/chunks/chunk-EMEEHV2Y.js +2 -0
  62. package/dist/cli-bundle/chunks/chunk-JGKTOBVB.js +6 -0
  63. package/dist/cli-bundle/chunks/{chunk-PP3BVMFL.js → chunk-JSUJWIHQ.js} +30 -30
  64. package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-LNKLQYBG.js} +2 -2
  65. package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-N56CAQBU.js} +63 -64
  66. package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-NC3QVGDD.js} +2 -2
  67. package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-RJ5N44WY.js} +2 -2
  68. package/dist/cli-bundle/chunks/{chunk-LOSRTNNP.js → chunk-VIMQCFCK.js} +2 -2
  69. package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-WBBW3WQX.js} +4 -4
  70. package/dist/cli-bundle/chunks/chunk-X2H6UR26.js +236 -0
  71. package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-FKKFQ66D.js} +7 -7
  72. package/dist/cli-bundle/chunks/{register-mutation-TNRHNK4N.js → register-mutation-EWMMVZJB.js} +2 -2
  73. package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-GEQ2H7PS.js} +2 -2
  74. package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-PSJTQBBO.js} +2 -2
  75. package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-3RNUMVK4.js} +2 -2
  76. package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-4KQFMOM7.js} +6 -6
  77. package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-52I2SNKJ.js} +2 -2
  78. package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-5KRACGBK.js} +2 -2
  79. package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-5OO54BIV.js} +2 -2
  80. package/dist/cli-bundle/focused-chunks/{chunk-LKWDWER4.js → chunk-5TBAVZDR.js} +14 -14
  81. package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-FQKPOZKS.js} +2 -2
  82. package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-H3P77KVU.js} +2 -2
  83. package/dist/cli-bundle/focused-chunks/chunk-HTA3TNC3.js +26 -0
  84. package/dist/cli-bundle/focused-chunks/{chunk-23ACMPGB.js → chunk-JKBH7YGX.js} +2 -2
  85. package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-KIIFVULU.js} +2 -2
  86. package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-N6FUKTZS.js} +2 -2
  87. package/dist/cli-bundle/focused-chunks/chunk-PDYE7QDX.js +166 -0
  88. package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-Q4VNCTR2.js} +2 -2
  89. package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-THYQR3ON.js} +61 -62
  90. package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-TYLG5VEB.js} +2 -2
  91. package/dist/cli-bundle/main.js +26 -26
  92. package/dist/cli-bundle/sdk-authoring.js +1 -1
  93. package/dist/cli-bundle/sdk-contracts.js +2 -2
  94. package/dist/cli-bundle/sdk-core.js +22 -22
  95. package/dist/cli-bundle/sdk-governance.js +1 -1
  96. package/dist/cli-bundle/sdk-graph.js +1 -1
  97. package/dist/cli-bundle/sdk-merge.js +51 -51
  98. package/dist/cli-bundle/sdk-query.js +1 -1
  99. package/dist/cli-bundle/sdk-runtime.js +1 -1
  100. package/dist/cli-bundle/sdk-testing.js +1 -1
  101. package/dist/cli-bundle/sdk.js +7 -7
  102. package/dist/cli.d.ts +9 -9
  103. package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
  104. package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
  105. package/dist/core/config/nested-settings.d.ts +20 -20
  106. package/dist/core/config/positional-value.d.ts +9 -9
  107. package/dist/core/diagnostics/remediation.d.ts +7 -7
  108. package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
  109. package/dist/core/extensions/activation-summary.d.ts +30 -30
  110. package/dist/core/extensions/activation-transaction.d.ts +9 -9
  111. package/dist/core/extensions/capability-usage.d.ts +25 -25
  112. package/dist/core/extensions/command-hook-context.d.ts +15 -15
  113. package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
  114. package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
  115. package/dist/core/extensions/contribution-inventory.d.ts +24 -24
  116. package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
  117. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  118. package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
  119. package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
  120. package/dist/core/extensions/extension-policy.d.ts +62 -62
  121. package/dist/core/extensions/extension-registries.d.ts +8 -8
  122. package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
  123. package/dist/core/extensions/extension-types.d.ts +702 -702
  124. package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
  125. package/dist/core/extensions/flag-value-types.d.ts +16 -4
  126. package/dist/core/extensions/flag-value-types.js +1 -1
  127. package/dist/core/extensions/index.d.ts +34 -34
  128. package/dist/core/extensions/item-field-types.d.ts +3 -3
  129. package/dist/core/extensions/item-fields.d.ts +6 -6
  130. package/dist/core/extensions/loader.d.ts +66 -66
  131. package/dist/core/extensions/manifest-parser.d.ts +1 -1
  132. package/dist/core/extensions/manifest-schema.d.ts +13 -13
  133. package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
  134. package/dist/core/extensions/preflight-ownership.d.ts +3 -3
  135. package/dist/core/extensions/read-output-contract.d.ts +2 -2
  136. package/dist/core/extensions/registration-contracts.d.ts +12 -12
  137. package/dist/core/extensions/registration-validation.d.ts +6 -6
  138. package/dist/core/extensions/registration-values.d.ts +19 -19
  139. package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
  140. package/dist/core/extensions/runtime-registrations.d.ts +6 -6
  141. package/dist/core/extensions/service-ownership.d.ts +1 -1
  142. package/dist/core/extensions/version-compat.d.ts +9 -9
  143. package/dist/core/fs/atomic-create.d.ts +1 -1
  144. package/dist/core/fs/fs-utils.d.ts +12 -12
  145. package/dist/core/fs/host-environment-errors.d.ts +10 -10
  146. package/dist/core/fs/path-utils.d.ts +1 -1
  147. package/dist/core/governance/content-fields.d.ts +25 -25
  148. package/dist/core/governance/issue-codes.d.ts +16 -16
  149. package/dist/core/governance/metadata-coverage.d.ts +64 -64
  150. package/dist/core/history/digest.d.ts +5 -5
  151. package/dist/core/history/drift-cache.d.ts +2 -2
  152. package/dist/core/history/drift-scan.d.ts +18 -18
  153. package/dist/core/history/event-classification.d.ts +4 -4
  154. package/dist/core/history/event-index.d.ts +33 -33
  155. package/dist/core/history/history-compact-bulk.d.ts +12 -12
  156. package/dist/core/history/history-diff.d.ts +15 -15
  157. package/dist/core/history/history-rewrite.d.ts +43 -43
  158. package/dist/core/history/history-storage-stats.d.ts +20 -20
  159. package/dist/core/history/history-stream-policy.d.ts +12 -12
  160. package/dist/core/history/history.d.ts +45 -45
  161. package/dist/core/history/identity.d.ts +4 -4
  162. package/dist/core/history/operation-contract.d.ts +17 -17
  163. package/dist/core/history/projection.d.ts +16 -16
  164. package/dist/core/history/read.d.ts +4 -4
  165. package/dist/core/history/replay.d.ts +47 -47
  166. package/dist/core/history/tombstone.d.ts +1 -1
  167. package/dist/core/history/version-address.d.ts +2 -2
  168. package/dist/core/history/workspace-history.d.ts +72 -72
  169. package/dist/core/io/body-file.d.ts +2 -2
  170. package/dist/core/io/bulk-ids-input.d.ts +7 -7
  171. package/dist/core/item/actionability.d.ts +30 -30
  172. package/dist/core/item/dependency-reference.d.ts +2 -2
  173. package/dist/core/item/id.d.ts +9 -9
  174. package/dist/core/item/item-format-version.d.ts +17 -15
  175. package/dist/core/item/item-format-version.js +1 -1
  176. package/dist/core/item/item-format.d.ts +54 -54
  177. package/dist/core/item/item-record.d.ts +1 -1
  178. package/dist/core/item/item-type-definition.d.ts +11 -11
  179. package/dist/core/item/parent-reference-policy.d.ts +6 -6
  180. package/dist/core/item/parse.d.ts +37 -37
  181. package/dist/core/item/plan-lifecycle.d.ts +4 -4
  182. package/dist/core/item/priority.d.ts +3 -3
  183. package/dist/core/item/sprint-release-format.d.ts +4 -4
  184. package/dist/core/item/status-filter.d.ts +5 -5
  185. package/dist/core/item/status.d.ts +3 -3
  186. package/dist/core/item/toon-decode.d.ts +10 -10
  187. package/dist/core/item/type-registry.d.ts +35 -35
  188. package/dist/core/item/type-synonyms.d.ts +2 -2
  189. package/dist/core/lock/lock-gc.d.ts +28 -28
  190. package/dist/core/lock/lock.d.ts +53 -53
  191. package/dist/core/output/mutation-projection.d.ts +4 -4
  192. package/dist/core/output/output-control.d.ts +4 -4
  193. package/dist/core/output/output.d.ts +30 -30
  194. package/dist/core/output/query-summary.d.ts +5 -5
  195. package/dist/core/output/tabular.d.ts +3 -3
  196. package/dist/core/packages/manifest.d.ts +30 -30
  197. package/dist/core/packages/root.d.ts +4 -4
  198. package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
  199. package/dist/core/policy/workflow-policy-store.d.ts +15 -15
  200. package/dist/core/policy/workflow-policy.d.ts +56 -56
  201. package/dist/core/profile/profile-describe.d.ts +22 -22
  202. package/dist/core/profile/profile-lint.d.ts +13 -13
  203. package/dist/core/profile/profile-plan.d.ts +45 -45
  204. package/dist/core/profile/profile-presets.d.ts +36 -36
  205. package/dist/core/reproducibility/context.d.ts +9 -9
  206. package/dist/core/schema/fields-file.d.ts +35 -35
  207. package/dist/core/schema/item-types-file.d.ts +29 -29
  208. package/dist/core/schema/runtime-field-filters.d.ts +3 -3
  209. package/dist/core/schema/runtime-field-values.d.ts +7 -7
  210. package/dist/core/schema/runtime-schema.d.ts +59 -59
  211. package/dist/core/schema/status-defs-file.d.ts +29 -29
  212. package/dist/core/schema/status-token.d.ts +1 -1
  213. package/dist/core/schema/type-inference.d.ts +10 -10
  214. package/dist/core/schema/type-presets.d.ts +5 -5
  215. package/dist/core/schema/type-workflows.d.ts +14 -14
  216. package/dist/core/search/background-refresh.d.ts +12 -12
  217. package/dist/core/search/bm25.d.ts +16 -16
  218. package/dist/core/search/cache.d.ts +34 -34
  219. package/dist/core/search/corpus.d.ts +17 -17
  220. package/dist/core/search/embedding-batches.d.ts +25 -25
  221. package/dist/core/search/eval-thresholds.d.ts +4 -4
  222. package/dist/core/search/eval.d.ts +40 -40
  223. package/dist/core/search/http-client.d.ts +24 -24
  224. package/dist/core/search/providers.d.ts +30 -30
  225. package/dist/core/search/relevance.d.ts +17 -17
  226. package/dist/core/search/semantic-defaults.d.ts +5 -5
  227. package/dist/core/search/staleness.d.ts +3 -3
  228. package/dist/core/search/vector-stores.d.ts +51 -51
  229. package/dist/core/search/vectorization-metadata.d.ts +9 -9
  230. package/dist/core/sentry/helpers.d.ts +27 -27
  231. package/dist/core/sentry/instrument.d.ts +51 -51
  232. package/dist/core/sentry/instrument.js +1 -1
  233. package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
  234. package/dist/core/sentry/sensitive-assignments.js +2 -0
  235. package/dist/core/session/session-state.d.ts +37 -37
  236. package/dist/core/shared/agent-session-context.d.ts +14 -14
  237. package/dist/core/shared/author.d.ts +89 -89
  238. package/dist/core/shared/command-line.d.ts +3 -3
  239. package/dist/core/shared/command-types.d.ts +20 -20
  240. package/dist/core/shared/conflict-markers.d.ts +5 -5
  241. package/dist/core/shared/constants.d.ts +30 -30
  242. package/dist/core/shared/errors.d.ts +100 -100
  243. package/dist/core/shared/html-entity-decode.d.ts +2 -2
  244. package/dist/core/shared/item-metadata-contract.d.ts +2 -2
  245. package/dist/core/shared/lazy-module.d.ts +1 -1
  246. package/dist/core/shared/levenshtein.d.ts +1 -1
  247. package/dist/core/shared/memo.d.ts +1 -1
  248. package/dist/core/shared/numeric-parsers.d.ts +1 -1
  249. package/dist/core/shared/option-alias-visibility.d.ts +3 -3
  250. package/dist/core/shared/primitives.d.ts +13 -13
  251. package/dist/core/shared/secret-rules.d.ts +92 -92
  252. package/dist/core/shared/serial-queue.d.ts +6 -6
  253. package/dist/core/shared/serialization.d.ts +4 -4
  254. package/dist/core/shared/split-comma-list.d.ts +4 -4
  255. package/dist/core/shared/text-normalization.d.ts +3 -3
  256. package/dist/core/shared/time.d.ts +27 -27
  257. package/dist/core/store/item-format-migration.d.ts +7 -7
  258. package/dist/core/store/item-metadata-cache.d.ts +30 -30
  259. package/dist/core/store/item-metadata-query-index.d.ts +66 -66
  260. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  261. package/dist/core/store/item-store.d.ts +123 -123
  262. package/dist/core/store/item-store.js +1 -1
  263. package/dist/core/store/paths.d.ts +27 -27
  264. package/dist/core/store/settings-concurrency.d.ts +1 -1
  265. package/dist/core/store/settings-read-cache.d.ts +11 -11
  266. package/dist/core/store/settings-validator.d.ts +117 -117
  267. package/dist/core/store/settings.d.ts +84 -84
  268. package/dist/core/store/sqlite-runtime.d.ts +2 -2
  269. package/dist/core/store/tracker-preflight.d.ts +3 -3
  270. package/dist/core/telemetry/consent.d.ts +1 -1
  271. package/dist/core/telemetry/observability.d.ts +16 -16
  272. package/dist/core/telemetry/policy.d.ts +7 -7
  273. package/dist/core/telemetry/read-sampling.d.ts +1 -1
  274. package/dist/core/telemetry/runtime.d.ts +275 -275
  275. package/dist/core/test/background-runs.d.ts +123 -123
  276. package/dist/core/test/item-test-run-tracking.d.ts +10 -10
  277. package/dist/core/test/run-selectors.d.ts +12 -12
  278. package/dist/core/validate/estimate-defaults.d.ts +3 -3
  279. package/dist/core/validate/fix-planning.d.ts +36 -36
  280. package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
  281. package/dist/core/validate/missing-by-type.d.ts +3 -3
  282. package/dist/core/validate/missing-link-owners.d.ts +17 -17
  283. package/dist/core/validate/stale-file-classification.d.ts +6 -6
  284. package/dist/mcp/http-server.d.ts +26 -26
  285. package/dist/mcp/legacy-adapter.d.ts +18 -18
  286. package/dist/mcp/runtime-capabilities.d.ts +18 -18
  287. package/dist/mcp/server.d.ts +73 -73
  288. package/dist/mcp/tool-definitions.d.ts +27 -27
  289. package/dist/sdk/actionability.d.ts +1 -1
  290. package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
  291. package/dist/sdk/agent/command-recovery.d.ts +5 -5
  292. package/dist/sdk/agent/command-suggestions.d.ts +4 -4
  293. package/dist/sdk/agent/create-option-policy.d.ts +2 -2
  294. package/dist/sdk/agent/identity-config.d.ts +18 -18
  295. package/dist/sdk/agent/item-addressing.d.ts +6 -6
  296. package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
  297. package/dist/sdk/agent/refusal-closure.d.ts +22 -22
  298. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
  299. package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
  300. package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
  301. package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
  302. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
  303. package/dist/sdk/agent-capability-contracts.d.ts +41 -41
  304. package/dist/sdk/agent-session-context.d.ts +1 -1
  305. package/dist/sdk/annotations.d.ts +74 -74
  306. package/dist/sdk/author-attribution.d.ts +47 -47
  307. package/dist/sdk/authoring.d.ts +9 -9
  308. package/dist/sdk/cli-bootstrap.d.ts +65 -65
  309. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
  310. package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
  311. package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
  312. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
  313. package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
  314. package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
  315. package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
  316. package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
  317. package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
  318. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  319. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
  320. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
  321. package/dist/sdk/cli-contracts/registration-helpers.d.ts +56 -56
  322. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
  323. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  324. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
  325. package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
  326. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
  327. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
  328. package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
  329. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
  330. package/dist/sdk/cli-contracts.d.ts +15 -15
  331. package/dist/sdk/cli-program.d.ts +1 -1
  332. package/dist/sdk/cli-program.js +1 -1
  333. package/dist/sdk/command-line.d.ts +3 -3
  334. package/dist/sdk/comments.d.ts +24 -24
  335. package/dist/sdk/compile-cache.d.ts +4 -4
  336. package/dist/sdk/completion/bash.d.ts +1 -1
  337. package/dist/sdk/completion/fish.d.ts +1 -1
  338. package/dist/sdk/completion/shared.d.ts +74 -74
  339. package/dist/sdk/completion/zsh.d.ts +1 -1
  340. package/dist/sdk/completion.d.ts +3 -3
  341. package/dist/sdk/compose.d.ts +94 -94
  342. package/dist/sdk/config.d.ts +105 -105
  343. package/dist/sdk/context/recency.d.ts +1 -1
  344. package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
  345. package/dist/sdk/context/usage-egress.d.ts +1 -1
  346. package/dist/sdk/context/usage-ledger.d.ts +18 -18
  347. package/dist/sdk/context-intent-contracts.d.ts +37 -37
  348. package/dist/sdk/context-intent-runtime.d.ts +10 -10
  349. package/dist/sdk/context-packing.d.ts +44 -44
  350. package/dist/sdk/context-relevance.d.ts +110 -110
  351. package/dist/sdk/context-signal-store.d.ts +52 -52
  352. package/dist/sdk/context-usage.d.ts +78 -78
  353. package/dist/sdk/contracts.d.ts +2 -1
  354. package/dist/sdk/contracts.js +1 -1
  355. package/dist/sdk/core-governance.d.ts +5 -5
  356. package/dist/sdk/core.d.ts +8 -8
  357. package/dist/sdk/corpus-shape.d.ts +60 -60
  358. package/dist/sdk/define.d.ts +36 -36
  359. package/dist/sdk/dependencies.d.ts +70 -70
  360. package/dist/sdk/dependency-flag-validation.d.ts +17 -17
  361. package/dist/sdk/dependency-provenance.d.ts +22 -22
  362. package/dist/sdk/docs.d.ts +17 -17
  363. package/dist/sdk/duplicates.d.ts +14 -14
  364. package/dist/sdk/environment/agent-environment.d.ts +118 -118
  365. package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
  366. package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
  367. package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
  368. package/dist/sdk/environment/source-context.d.ts +4 -4
  369. package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
  370. package/dist/sdk/error-code-catalog.d.ts +33 -33
  371. package/dist/sdk/error-runtime.d.ts +5 -5
  372. package/dist/sdk/errors.d.ts +17 -17
  373. package/dist/sdk/eval.d.ts +27 -27
  374. package/dist/sdk/extension/author-manifest.d.ts +9 -9
  375. package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
  376. package/dist/sdk/extension/concurrency.d.ts +1 -1
  377. package/dist/sdk/extension/copy-scope.d.ts +1 -1
  378. package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
  379. package/dist/sdk/extension/describe.d.ts +21 -21
  380. package/dist/sdk/extension/doctor.d.ts +46 -46
  381. package/dist/sdk/extension/install-plan.d.ts +32 -32
  382. package/dist/sdk/extension/install-receipts.d.ts +4 -4
  383. package/dist/sdk/extension/install-runtime.d.ts +12 -12
  384. package/dist/sdk/extension/install-snapshot.d.ts +10 -10
  385. package/dist/sdk/extension/install-sources.d.ts +106 -106
  386. package/dist/sdk/extension/managed-state.d.ts +42 -42
  387. package/dist/sdk/extension/managed-update-status.d.ts +1 -1
  388. package/dist/sdk/extension/migrations.d.ts +48 -48
  389. package/dist/sdk/extension/output-ownership.d.ts +19 -19
  390. package/dist/sdk/extension/runtime-summary.d.ts +7 -7
  391. package/dist/sdk/extension/scaffold.d.ts +15 -15
  392. package/dist/sdk/extension/shared.d.ts +16 -16
  393. package/dist/sdk/extension/source-resolution.d.ts +16 -16
  394. package/dist/sdk/extension/static-inventory.d.ts +23 -23
  395. package/dist/sdk/extension/update-check.d.ts +9 -9
  396. package/dist/sdk/extension-command-context.d.ts +1 -1
  397. package/dist/sdk/extension-contracts.d.ts +10 -10
  398. package/dist/sdk/extension.d.ts +221 -221
  399. package/dist/sdk/files.d.ts +101 -101
  400. package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
  401. package/dist/sdk/flag-invocation-contracts.js +1 -1
  402. package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
  403. package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
  404. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  405. package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
  406. package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
  407. package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
  408. package/dist/sdk/governance/assurance-action.d.ts +46 -46
  409. package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
  410. package/dist/sdk/governance/assurance-presets.d.ts +25 -25
  411. package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
  412. package/dist/sdk/governance/assurance.d.ts +204 -204
  413. package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
  414. package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
  415. package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
  416. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
  417. package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
  418. package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
  419. package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
  420. package/dist/sdk/governance/extension-host-version.d.ts +9 -9
  421. package/dist/sdk/governance/gc.d.ts +26 -26
  422. package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
  423. package/dist/sdk/governance/health.d.ts +172 -172
  424. package/dist/sdk/governance/health.js +1 -1
  425. package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
  426. package/dist/sdk/governance/linked-file-report.d.ts +15 -15
  427. package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
  428. package/dist/sdk/governance/provenance-health.d.ts +35 -35
  429. package/dist/sdk/governance/reindex.d.ts +102 -102
  430. package/dist/sdk/governance/reliability.d.ts +29 -29
  431. package/dist/sdk/governance/stale-work.d.ts +13 -13
  432. package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
  433. package/dist/sdk/governance/storage-integrity.d.ts +28 -28
  434. package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
  435. package/dist/sdk/governance/upgrade.d.ts +77 -77
  436. package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
  437. package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
  438. package/dist/sdk/governance/validate-normalization.d.ts +4 -4
  439. package/dist/sdk/governance/validate.d.ts +176 -176
  440. package/dist/sdk/governance/validate.js +1 -1
  441. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  442. package/dist/sdk/governance/workflow-policy.d.ts +18 -18
  443. package/dist/sdk/governance/workspace-position.d.ts +40 -40
  444. package/dist/sdk/governance.d.ts +2 -2
  445. package/dist/sdk/graph/adapter.d.ts +45 -45
  446. package/dist/sdk/graph/analytics.d.ts +36 -36
  447. package/dist/sdk/graph/assembly.d.ts +51 -51
  448. package/dist/sdk/graph/cache.d.ts +19 -19
  449. package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
  450. package/dist/sdk/graph/centrality.d.ts +20 -20
  451. package/dist/sdk/graph/conformance.d.ts +21 -21
  452. package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
  453. package/dist/sdk/graph/durable-cache.d.ts +22 -22
  454. package/dist/sdk/graph/governance-contracts.d.ts +1 -1
  455. package/dist/sdk/graph/governance.d.ts +92 -92
  456. package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
  457. package/dist/sdk/graph/index.d.ts +15 -15
  458. package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
  459. package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
  460. package/dist/sdk/graph/query-contracts.d.ts +6 -6
  461. package/dist/sdk/graph/remediation.d.ts +15 -15
  462. package/dist/sdk/graph/run.d.ts +203 -203
  463. package/dist/sdk/graph/scheduling.d.ts +21 -21
  464. package/dist/sdk/graph/traversal.d.ts +18 -18
  465. package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
  466. package/dist/sdk/guide-topics.d.ts +19 -19
  467. package/dist/sdk/guide.d.ts +43 -43
  468. package/dist/sdk/history/attestation-command.d.ts +8 -8
  469. package/dist/sdk/history/attestation-contract.d.ts +43 -43
  470. package/dist/sdk/history/attestation-scan.d.ts +4 -4
  471. package/dist/sdk/history/attestation.d.ts +4 -4
  472. package/dist/sdk/history/maintenance.d.ts +25 -25
  473. package/dist/sdk/history/salvage.d.ts +19 -19
  474. package/dist/sdk/history/subject.d.ts +8 -8
  475. package/dist/sdk/history-analytics.d.ts +64 -64
  476. package/dist/sdk/history-compact.d.ts +67 -67
  477. package/dist/sdk/history-mcp.d.ts +7 -7
  478. package/dist/sdk/history-provenance.d.ts +40 -40
  479. package/dist/sdk/history-read.d.ts +24 -24
  480. package/dist/sdk/history-redact.d.ts +68 -68
  481. package/dist/sdk/history-repair.d.ts +92 -92
  482. package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
  483. package/dist/sdk/improvement-ledger.d.ts +62 -62
  484. package/dist/sdk/index.d.ts +69 -69
  485. package/dist/sdk/init-agent-guidance.d.ts +68 -68
  486. package/dist/sdk/init.d.ts +117 -117
  487. package/dist/sdk/invocation-author.d.ts +1 -1
  488. package/dist/sdk/item-children.d.ts +15 -15
  489. package/dist/sdk/item-metadata-index.d.ts +2 -2
  490. package/dist/sdk/item-schedule.d.ts +9 -9
  491. package/dist/sdk/item-transaction.d.ts +73 -73
  492. package/dist/sdk/learnings.d.ts +23 -23
  493. package/dist/sdk/lifecycle/append.d.ts +8 -8
  494. package/dist/sdk/lifecycle/claim.d.ts +38 -38
  495. package/dist/sdk/lifecycle/close-many.d.ts +71 -71
  496. package/dist/sdk/lifecycle/close.d.ts +18 -18
  497. package/dist/sdk/lifecycle/copy.d.ts +10 -10
  498. package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
  499. package/dist/sdk/lifecycle/create.d.ts +88 -88
  500. package/dist/sdk/lifecycle/delete.d.ts +15 -15
  501. package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
  502. package/dist/sdk/lifecycle/focus.d.ts +6 -6
  503. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
  504. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
  505. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
  506. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  507. package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
  508. package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
  509. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
  510. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
  511. package/dist/sdk/lifecycle/plan.d.ts +127 -127
  512. package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
  513. package/dist/sdk/lifecycle/reopen.d.ts +15 -15
  514. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
  515. package/dist/sdk/lifecycle/restore.d.ts +34 -34
  516. package/dist/sdk/lifecycle/restore.js +1 -1
  517. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
  518. package/dist/sdk/lifecycle/task-composition.d.ts +7 -7
  519. package/dist/sdk/lifecycle/update-many.d.ts +61 -61
  520. package/dist/sdk/lifecycle/update.d.ts +120 -120
  521. package/dist/sdk/lifecycle-completion.d.ts +14 -14
  522. package/dist/sdk/lifecycle-policy.d.ts +31 -31
  523. package/dist/sdk/linked-artifacts.d.ts +58 -58
  524. package/dist/sdk/mcp/apps.d.ts +28 -28
  525. package/dist/sdk/mcp/authorization.d.ts +66 -66
  526. package/dist/sdk/mcp/discovery.d.ts +67 -67
  527. package/dist/sdk/mcp/interactions.d.ts +49 -49
  528. package/dist/sdk/mcp/protocol.d.ts +63 -63
  529. package/dist/sdk/mcp/skills.d.ts +62 -62
  530. package/dist/sdk/mcp/subscriptions.d.ts +26 -26
  531. package/dist/sdk/mcp/tasks.d.ts +51 -51
  532. package/dist/sdk/mcp/transport.d.ts +17 -17
  533. package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
  534. package/dist/sdk/merge/driver.d.ts +38 -38
  535. package/dist/sdk/merge/index.d.ts +5 -5
  536. package/dist/sdk/merge/install.d.ts +48 -48
  537. package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
  538. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  539. package/dist/sdk/merge/receipt-schema.d.ts +11 -11
  540. package/dist/sdk/merge/receipts.d.ts +111 -111
  541. package/dist/sdk/merge/reconcile.d.ts +20 -20
  542. package/dist/sdk/merge/three-way.d.ts +50 -50
  543. package/dist/sdk/merge/three-way.js +2 -2
  544. package/dist/sdk/merge/worktree-config.d.ts +3 -3
  545. package/dist/sdk/mutation-events.d.ts +62 -62
  546. package/dist/sdk/mutation-guard.d.ts +134 -134
  547. package/dist/sdk/notes.d.ts +28 -28
  548. package/dist/sdk/output/table-rows.d.ts +6 -6
  549. package/dist/sdk/output-contracts.d.ts +26 -26
  550. package/dist/sdk/output-projection.d.ts +108 -108
  551. package/dist/sdk/output-token-accounting.d.ts +18 -18
  552. package/dist/sdk/output.d.ts +18 -18
  553. package/dist/sdk/ownership-source.d.ts +1 -1
  554. package/dist/sdk/package-import-adapters.d.ts +51 -51
  555. package/dist/sdk/package-migrations.d.ts +3 -3
  556. package/dist/sdk/package-runtime-options.d.ts +3 -3
  557. package/dist/sdk/pagination.d.ts +28 -28
  558. package/dist/sdk/pagination.js +1 -1
  559. package/dist/sdk/profile.d.ts +72 -72
  560. package/dist/sdk/provenance.d.ts +37 -37
  561. package/dist/sdk/public-surface.json +1 -1
  562. package/dist/sdk/query/activity.d.ts +84 -84
  563. package/dist/sdk/query/aggregate.d.ts +109 -109
  564. package/dist/sdk/query/calendar.d.ts +95 -95
  565. package/dist/sdk/query/complete-list.d.ts +35 -35
  566. package/dist/sdk/query/context.d.ts +300 -300
  567. package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
  568. package/dist/sdk/query/get.d.ts +54 -54
  569. package/dist/sdk/query/history.d.ts +38 -38
  570. package/dist/sdk/query/item-filter-options.d.ts +41 -41
  571. package/dist/sdk/query/light-metadata.d.ts +1 -1
  572. package/dist/sdk/query/list-filter-shared.d.ts +4 -4
  573. package/dist/sdk/query/list.d.ts +167 -167
  574. package/dist/sdk/query/list.js +1 -1
  575. package/dist/sdk/query/multi-value-filters.d.ts +6 -6
  576. package/dist/sdk/query/next-ready-budget.d.ts +8 -8
  577. package/dist/sdk/query/next.d.ts +94 -94
  578. package/dist/sdk/query/parsers.d.ts +3 -3
  579. package/dist/sdk/query/projection-contracts.d.ts +18 -18
  580. package/dist/sdk/query/search/corpus.d.ts +15 -15
  581. package/dist/sdk/query/search/filters.d.ts +15 -15
  582. package/dist/sdk/query/search/input.d.ts +8 -8
  583. package/dist/sdk/query/search/lexical.d.ts +10 -10
  584. package/dist/sdk/query/search/response.d.ts +22 -22
  585. package/dist/sdk/query/search/semantic.d.ts +133 -133
  586. package/dist/sdk/query/search/types.d.ts +65 -65
  587. package/dist/sdk/query/search-contracts.d.ts +53 -53
  588. package/dist/sdk/query/search-pagination.d.ts +21 -21
  589. package/dist/sdk/query/search-rendering.d.ts +30 -30
  590. package/dist/sdk/query/search.d.ts +60 -60
  591. package/dist/sdk/query/workspace-contracts.d.ts +2 -2
  592. package/dist/sdk/query.d.ts +6 -6
  593. package/dist/sdk/read-output/continuation.d.ts +11 -11
  594. package/dist/sdk/read-output/extension.d.ts +3 -3
  595. package/dist/sdk/read-output/options.d.ts +7 -7
  596. package/dist/sdk/read-output/provenance.d.ts +6 -6
  597. package/dist/sdk/read-output-budget.d.ts +11 -11
  598. package/dist/sdk/read-output-contracts.d.ts +112 -112
  599. package/dist/sdk/read-output-contracts.js +1 -1
  600. package/dist/sdk/read-output-rows.d.ts +15 -15
  601. package/dist/sdk/read-output-session.d.ts +29 -29
  602. package/dist/sdk/relationship-analytics.d.ts +46 -46
  603. package/dist/sdk/relationship-context.d.ts +48 -48
  604. package/dist/sdk/relationship-history.d.ts +59 -59
  605. package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
  606. package/dist/sdk/relationship-migration.d.ts +14 -14
  607. package/dist/sdk/relationships.d.ts +46 -46
  608. package/dist/sdk/reproducibility/process.d.ts +9 -9
  609. package/dist/sdk/runtime/actions.d.ts +1 -1
  610. package/dist/sdk/runtime/context.d.ts +15 -15
  611. package/dist/sdk/runtime/schema-preview.d.ts +1 -1
  612. package/dist/sdk/runtime/schema.d.ts +1 -1
  613. package/dist/sdk/runtime-action-aliases.d.ts +3 -3
  614. package/dist/sdk/runtime-extended-actions.d.ts +9 -9
  615. package/dist/sdk/runtime-input.d.ts +29 -29
  616. package/dist/sdk/runtime-primitives.d.ts +53 -53
  617. package/dist/sdk/runtime-primitives.js +1 -1
  618. package/dist/sdk/runtime-public-contracts.d.ts +46 -46
  619. package/dist/sdk/runtime-stats-options.d.ts +1 -1
  620. package/dist/sdk/runtime.d.ts +374 -374
  621. package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
  622. package/dist/sdk/schema-migration.d.ts +79 -79
  623. package/dist/sdk/schema.d.ts +224 -224
  624. package/dist/sdk/search-refresh-worker.d.ts +1 -1
  625. package/dist/sdk/similarity-scoring.d.ts +10 -10
  626. package/dist/sdk/similarity.d.ts +73 -73
  627. package/dist/sdk/start-task-status.d.ts +1 -1
  628. package/dist/sdk/stats.d.ts +72 -72
  629. package/dist/sdk/structured-mutations.d.ts +13 -13
  630. package/dist/sdk/telemetry-flush.d.ts +1 -1
  631. package/dist/sdk/telemetry.d.ts +32 -32
  632. package/dist/sdk/templates.d.ts +35 -35
  633. package/dist/sdk/test/batch.d.ts +50 -50
  634. package/dist/sdk/test/command-args.d.ts +2 -2
  635. package/dist/sdk/test/entry.d.ts +4 -4
  636. package/dist/sdk/test/execution-receipts.d.ts +5 -5
  637. package/dist/sdk/test/execution.d.ts +247 -247
  638. package/dist/sdk/test/json-path.d.ts +4 -4
  639. package/dist/sdk/test/linked-command-detection.d.ts +36 -36
  640. package/dist/sdk/test/measurements.d.ts +10 -10
  641. package/dist/sdk/test/parsers.d.ts +18 -18
  642. package/dist/sdk/test/prerequisites.d.ts +3 -3
  643. package/dist/sdk/test/runs.d.ts +43 -43
  644. package/dist/sdk/test/trust.d.ts +15 -15
  645. package/dist/sdk/test/update.d.ts +23 -23
  646. package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
  647. package/dist/sdk/testing.d.ts +248 -248
  648. package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
  649. package/dist/sdk/traceability/source-traceability.d.ts +50 -50
  650. package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
  651. package/dist/sdk/workspace-contracts.d.ts +20 -20
  652. package/dist/sdk/workspace-memory.d.ts +42 -42
  653. package/dist/sdk/workspace-recipe.d.ts +9 -9
  654. package/dist/sdk/workspace-snapshot.d.ts +60 -60
  655. package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
  656. package/dist/sdk/workspace-transaction.d.ts +26 -26
  657. package/dist/sdk/workspace.d.ts +9 -9
  658. package/dist/types.d.ts +540 -540
  659. package/docs/COMMANDS.md +11 -2
  660. package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
  661. package/docs/LINKED_TEST_EDITS.md +15 -0
  662. package/docs/RELEASING.md +2 -0
  663. package/docs/TESTING.md +21 -1
  664. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +4 -3
  665. package/marketplace.json +1 -1
  666. package/package.json +3 -1
  667. package/packages/pm-beads/package.json +1 -1
  668. package/packages/pm-calendar/package.json +1 -1
  669. package/packages/pm-command-kit/package.json +1 -1
  670. package/packages/pm-digital-twin/package.json +1 -1
  671. package/packages/pm-governance-audit/package.json +1 -1
  672. package/packages/pm-guide-shell/package.json +1 -1
  673. package/packages/pm-kanban/package.json +1 -1
  674. package/packages/pm-lifecycle-hooks/package.json +1 -1
  675. package/packages/pm-linked-test-adapters/package.json +1 -1
  676. package/packages/pm-search-advanced/package.json +1 -1
  677. package/packages/pm-templates/package.json +1 -1
  678. package/packages/pm-todos/package.json +1 -1
  679. package/packages/pm-vcs/package.json +1 -1
  680. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  681. package/plugins/pm-claude/package.json +1 -1
  682. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  683. package/plugins/pm-codex/package.json +1 -1
  684. package/plugins/pm-codex/plugin.json +1 -1
  685. package/runtime-dependencies.json +1 -1
  686. package/scripts/finalize-build.mjs +9 -3
  687. package/dist/cli-bundle/chunks/chunk-66BZVFIK.js +0 -6
  688. package/dist/cli-bundle/chunks/chunk-IDEHMKYZ.js +0 -235
  689. package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
  690. package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
  691. package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
  692. package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
@@ -3,4 +3,4 @@
3
3
  *
4
4
  * Exposes tracker initialization and filesystem preflight primitives to SDK consumers.
5
5
  */
6
- export { assertInitializedTracker, assertReadableTrackerRoot, buildTrackerInitializationRecovery, } from "../../core/store/tracker-preflight.js";
6
+ export { assertInitializedTracker,assertReadableTrackerRoot,buildTrackerInitializationRecovery,} from "../../core/store/tracker-preflight.js";
@@ -11,59 +11,59 @@ export type PmErrorCodeClass = "generic_failure" | "usage" | "not_found" | "conf
11
11
  /** One externally observable refusal state and its executable entrypoint probe. */
12
12
  export interface PmRefusalStateContract {
13
13
  /** Stable semantic state owned by the error code. */
14
- state: string;
14
+ state:string;
15
15
  /** Stable probe identifier implemented by the entrypoint conformance suite. */
16
- probe_id: string;
16
+ probe_id:string;
17
17
  /** Public command roots through which the state must remain reachable. */
18
- entrypoints: string[];
18
+ entrypoints:string[];
19
19
  /** Exit class expected when the probe reaches the state. */
20
- expected_exit_class: PmErrorCodeClass;
20
+ expected_exit_class:PmErrorCodeClass;
21
21
  }
22
22
  /** Stable shell exit-code taxonomy shared by every structured error. */
23
- export declare const PM_ERROR_CODE_EXIT_CLASS_CONTRACTS: readonly [{
24
- readonly exit_code: 1;
25
- readonly class: "generic_failure";
26
- }, {
27
- readonly exit_code: 2;
28
- readonly class: "usage";
29
- }, {
30
- readonly exit_code: 3;
31
- readonly class: "not_found";
32
- }, {
33
- readonly exit_code: 4;
34
- readonly class: "conflict";
35
- }, {
36
- readonly exit_code: 5;
37
- readonly class: "dependency_failed";
23
+ export declare const PM_ERROR_CODE_EXIT_CLASS_CONTRACTS:readonly [{
24
+ readonly exit_code:1;
25
+ readonly class:"generic_failure";
26
+ },{
27
+ readonly exit_code:2;
28
+ readonly class:"usage";
29
+ },{
30
+ readonly exit_code:3;
31
+ readonly class:"not_found";
32
+ },{
33
+ readonly exit_code:4;
34
+ readonly class:"conflict";
35
+ },{
36
+ readonly exit_code:5;
37
+ readonly class:"dependency_failed";
38
38
  }];
39
39
  /** One machine-readable error and its portable recovery contract. */
40
40
  export interface PmErrorCodeContract {
41
41
  /** Stable snake_case identifier. */
42
- code: string;
42
+ code:string;
43
43
  /** Concise description of the failed condition. */
44
- meaning: string;
44
+ meaning:string;
45
45
  /** Compatibility tier for package consumers. */
46
- stability: PmErrorCodeStability;
46
+ stability:PmErrorCodeStability;
47
47
  /** Process exit code emitted by the CLI transport. */
48
- exit_code: 1 | 2 | 3 | 4 | 5;
48
+ exit_code:1 | 2 | 3 | 4 | 5;
49
49
  /** Semantic class represented by the process exit code. */
50
- class: PmErrorCodeClass;
50
+ class:PmErrorCodeClass;
51
51
  /** Actionable caller recovery guidance. */
52
- recovery: string;
52
+ recovery:string;
53
53
  /** Subsystems that can emit the code. */
54
- sources: string[];
54
+ sources:string[];
55
55
  /** CLI command roots inferred from executable declaration ownership. */
56
- emitting_commands: string[];
56
+ emitting_commands:string[];
57
57
  /** Canonical machine identifier for this compatibility group. */
58
- canonical_code?: string;
58
+ canonical_code?:string;
59
59
  /** Stable compatibility spellings that resolve to this canonical code. */
60
- aliases?: string[];
60
+ aliases?:string[];
61
61
  /** Observable states this code claims, each backed by a real-entrypoint probe. */
62
- owned_states?: PmRefusalStateContract[];
62
+ owned_states?:PmRefusalStateContract[];
63
63
  }
64
64
  /** Validate, normalize, sort, and freeze an error-code catalog. */
65
- export declare function definePmErrorCodeCatalog(declarations: readonly PmErrorCodeContract[]): readonly PmErrorCodeContract[];
65
+ export declare function definePmErrorCodeCatalog(declarations:readonly PmErrorCodeContract[]):readonly PmErrorCodeContract[];
66
66
  /** Resolve an emitted code through its stable compatibility alias group. */
67
- export declare function resolveCanonicalPmErrorCodeContract(code: string, catalog: readonly PmErrorCodeContract[]): PmErrorCodeContract;
67
+ export declare function resolveCanonicalPmErrorCodeContract(code:string,catalog:readonly PmErrorCodeContract[]):PmErrorCodeContract;
68
68
  /** Resolve one declared error contract and fail closed for unknown vocabulary. */
69
- export declare function resolvePmErrorCodeContract(code: string, catalog: readonly PmErrorCodeContract[]): PmErrorCodeContract;
69
+ export declare function resolvePmErrorCodeContract(code:string,catalog:readonly PmErrorCodeContract[]):PmErrorCodeContract;
@@ -1,10 +1,10 @@
1
1
  /** Returns a stable message for errors and unknown thrown values. */
2
- export declare function describeUnknownError(error: unknown): string;
2
+ export declare function describeUnknownError(error:unknown):string;
3
3
  /** Reads a finite numeric exit code from an arbitrary thrown value. */
4
- export declare function readThrownExitCode(error: unknown): number | undefined;
4
+ export declare function readThrownExitCode(error:unknown):number | undefined;
5
5
  /** Normalizes thrown exit codes to a positive integer failure status. */
6
- export declare function normalizeThrownExitCode(exitCode: number): number;
6
+ export declare function normalizeThrownExitCode(exitCode:number):number;
7
7
  /** Identifies errors emitted by Commander without importing its private classes. */
8
- export declare function isCommanderError(error: unknown): boolean;
8
+ export declare function isCommanderError(error:unknown):boolean;
9
9
  /** Converts non-Error thrown values into errors suitable for Sentry capture. */
10
- export declare function wrapThrownErrorForSentry(error: unknown, message: string): Error;
10
+ export declare function wrapThrownErrorForSentry(error:unknown,message:string):Error;
@@ -21,30 +21,30 @@ export declare const PM_CLI_EXPECTED_ERROR_NAME = "PmCliError";
21
21
  */
22
22
  export interface PmCliExpectedError extends Error {
23
23
  /** Discriminant tag; always {@link PM_CLI_EXPECTED_ERROR_NAME}. */
24
- name: typeof PM_CLI_EXPECTED_ERROR_NAME;
24
+ name:typeof PM_CLI_EXPECTED_ERROR_NAME;
25
25
  /** Positive process exit code the CLI should terminate with for this failure. */
26
- exitCode: number;
26
+ exitCode:number;
27
27
  /** Stable producer-owned error code, mirrored from context when available. */
28
- code?: string;
28
+ code?:string;
29
29
  /** Structured, secret-free metadata attached for diagnostics and error guidance. */
30
- context: PmCliErrorContext;
30
+ context:PmCliErrorContext;
31
31
  /** Optional underlying error that triggered this one, preserved for cause chaining. */
32
- cause?: unknown;
32
+ cause?:unknown;
33
33
  }
34
34
  /** A refused create operation whose canonical ID already names a persisted item. */
35
35
  export interface PmItemAlreadyExistsError extends PmCliExpectedError {
36
36
  /** Stable discriminator independent of the diagnostic message. */
37
- code: "item_already_exists";
37
+ code:"item_already_exists";
38
38
  /** Creation conflicts preserve the existing conflict exit-code contract. */
39
- exitCode: typeof EXIT_CODE.CONFLICT;
39
+ exitCode:typeof EXIT_CODE.CONFLICT;
40
40
  /** Canonical identity and actual persisted path for a safe subsequent read. */
41
- context: PmCliErrorContext & {
41
+ context:PmCliErrorContext & {
42
42
  /** Producer-owned existing-item discriminator. */
43
- code: "item_already_exists";
43
+ code:"item_already_exists";
44
44
  /** Normalized ID of the preserved existing item. */
45
- id: string;
45
+ id:string;
46
46
  /** Actual document path of the preserved existing item. */
47
- path: string;
47
+ path:string;
48
48
  };
49
49
  }
50
50
  /**
@@ -52,7 +52,7 @@ path: string;
52
52
  * Requires the producer code, conflict exit code and usable existing-item
53
53
  * coordinates; ownership conflicts and message lookalikes do not qualify.
54
54
  */
55
- export declare function isItemAlreadyExistsError(error: unknown): error is PmItemAlreadyExistsError;
55
+ export declare function isItemAlreadyExistsError(error:unknown):error is PmItemAlreadyExistsError;
56
56
  /**
57
57
  * Options accepted by {@link createPmCliExpectedError}. Every field is optional;
58
58
  * omitted values default to the CLI usage exit code, an empty context, and no
@@ -60,11 +60,11 @@ export declare function isItemAlreadyExistsError(error: unknown): error is PmIte
60
60
  */
61
61
  export interface CreatePmCliExpectedErrorOptions {
62
62
  /** Positive exit code to assign; defaults to the usage-error code. Non-finite or non-positive values throw. */
63
- exitCode?: number;
63
+ exitCode?:number;
64
64
  /** Structured, secret-free diagnostic metadata to attach to the error. */
65
- context?: PmCliErrorContext;
65
+ context?:PmCliErrorContext;
66
66
  /** Underlying error to retain as a non-enumerable `cause` when provided. */
67
- cause?: unknown;
67
+ cause?:unknown;
68
68
  }
69
69
  /**
70
70
  * Create a package-safe expected CLI error.
@@ -73,6 +73,6 @@ cause?: unknown;
73
73
  * shared class identity, so package authors can throw this from bundled,
74
74
  * linked, or separately installed extension code.
75
75
  */
76
- export declare function createPmCliExpectedError(message: string, options?: CreatePmCliExpectedErrorOptions): PmCliExpectedError;
76
+ export declare function createPmCliExpectedError(message:string,options?:CreatePmCliExpectedErrorOptions):PmCliExpectedError;
77
77
  /** Implements check whether pm cli expected error for the public runtime surface of this module. */
78
- export declare function isPmCliExpectedError(error: unknown): error is PmCliExpectedError;
78
+ export declare function isPmCliExpectedError(error:unknown):error is PmCliExpectedError;
@@ -1,61 +1,61 @@
1
1
  import { type EvalSearchMode } from "../core/search/eval.js";
2
2
  import type { GlobalOptions } from "../core/shared/command-types.js";
3
- export { EVAL_QUERY_SET_CONTRACT, EVAL_QUERY_SET_EXAMPLE, EVAL_QUERY_SET_SCHEMA_ID, parseEvalQuerySet, } from "../core/search/eval.js";
3
+ export { EVAL_QUERY_SET_CONTRACT,EVAL_QUERY_SET_EXAMPLE,EVAL_QUERY_SET_SCHEMA_ID,parseEvalQuerySet,} from "../core/search/eval.js";
4
4
  /** Relative location (under the pm root) of the default golden-query set. A git-tracked, human-curated file so relevance ground truth lives alongside the tracker it evaluates. */
5
- export declare const DEFAULT_EVAL_QUERIES_RELATIVE_PATH: string;
5
+ export declare const DEFAULT_EVAL_QUERIES_RELATIVE_PATH:string;
6
6
  /** Evaluation inputs shared by SDK hosts and the CLI adapter. */
7
7
  export interface EvalOptions {
8
8
  /** Default retrieval mode for queries that do not set their own (keyword|semantic|hybrid). */
9
- mode?: string;
9
+ mode?:string;
10
10
  /** Metric cutoff (`@k`); positive integer, defaults to {@link DEFAULT_EVAL_K}. */
11
- k?: string | number;
11
+ k?:string | number;
12
12
  /** Gate threshold: exit non-zero when the aggregate nDCG@k falls below this `[0,1]` value. */
13
- failUnder?: string | number;
13
+ failUnder?:string | number;
14
14
  /** Override path to the golden-query JSON file (defaults to `<pmRoot>/search/eval-queries.json`). */
15
- queries?: string;
15
+ queries?:string;
16
16
  /** Output format override: json|toon. */
17
- format?: string;
17
+ format?:string;
18
18
  }
19
19
  /** Per-query relevance report row emitted by {@link runEval}. */
20
20
  export interface EvalQueryReport {
21
21
  /** Original golden-query text used for retrieval. */
22
- query: string;
22
+ query:string;
23
23
  /** Resolved retrieval mode after applying query and run defaults. */
24
- mode: EvalSearchMode;
24
+ mode:EvalSearchMode;
25
25
  /** Number of unique items judged relevant to this query. */
26
- relevant_total: number;
26
+ relevant_total:number;
27
27
  /** Relevant items found within the ranking cutoff. */
28
- retrieved_relevant: number;
28
+ retrieved_relevant:number;
29
29
  /** Normalized discounted cumulative gain at the selected cutoff. */
30
- ndcg: number;
30
+ ndcg:number;
31
31
  /** Reciprocal rank of the first relevant result, or zero when absent. */
32
- mrr: number;
32
+ mrr:number;
33
33
  /** Fraction of positions at the selected cutoff containing relevant items. */
34
- precision: number;
34
+ precision:number;
35
35
  /** Fraction of judged relevant items retrieved at the selected cutoff. */
36
- recall: number;
36
+ recall:number;
37
37
  /** Failed per-query floors, compared against unrounded scores. */
38
- violations?: string[];
38
+ violations?:string[];
39
39
  }
40
40
  /** Rounded ranking evidence and the verdict computed from unrounded metrics. */
41
41
  export interface EvalResult {
42
42
  /** Maximum ranking positions scored for each query. */
43
- k: number;
43
+ k:number;
44
44
  /** Number of query entries represented by this result. */
45
- query_count: number;
45
+ query_count:number;
46
46
  /** Equal-weight macro averages across all evaluated queries. */
47
- aggregate: {
48
- ndcg: number;
49
- mrr: number;
50
- precision: number;
51
- recall: number;
47
+ aggregate:{
48
+ ndcg:number;
49
+ mrr:number;
50
+ precision:number;
51
+ recall:number;
52
52
  };
53
53
  /** Individual query scores and any failed declared floors. */
54
- queries: EvalQueryReport[];
54
+ queries:EvalQueryReport[];
55
55
  /** Present only when `--fail-under` was supplied. */
56
- fail_under?: number;
56
+ fail_under?:number;
57
57
  /** Whether every declared per-query floor and optional aggregate nDCG threshold passed. */
58
- passed: boolean;
58
+ passed:boolean;
59
59
  }
60
60
  /**
61
61
  * Run the search-relevance evaluation (pm-u8n5). Loads the golden-query set
@@ -66,4 +66,4 @@ passed: boolean;
66
66
  * supplied, the aggregate `--fail-under` threshold. The CLI maps any failed
67
67
  * threshold to a non-zero exit code.
68
68
  */
69
- export declare const runEval: (options: EvalOptions, global: GlobalOptions) => Promise<EvalResult>;
69
+ export declare const runEval:(options:EvalOptions,global:GlobalOptions) => Promise<EvalResult>;
@@ -2,21 +2,21 @@ import { type ExtensionManifestSchemaFinding } from "../../core/extensions/manif
2
2
  /** Read-only author-workspace manifest diagnostic shared by health and doctor. */
3
3
  export interface ExtensionAuthorManifestDiagnostic {
4
4
  /** Absolute path inspected for the extension runtime manifest. */
5
- path: string;
5
+ path:string;
6
6
  /** Whether the workspace declares a root extension manifest. */
7
- present: boolean;
7
+ present:boolean;
8
8
  /** Parse state for absent, valid, or malformed manifest content. */
9
- parse_status: "absent" | "valid" | "invalid_json" | "invalid_shape";
9
+ parse_status:"absent" | "valid" | "invalid_json" | "invalid_shape";
10
10
  /** Canonical package catalog metadata location, distinct from manifest.json. */
11
- package_metadata_location: "package.json#pm";
11
+ package_metadata_location:"package.json#pm";
12
12
  /** Public schema findings when the file is a JSON object. */
13
- schema_findings: ExtensionManifestSchemaFinding[];
13
+ schema_findings:ExtensionManifestSchemaFinding[];
14
14
  /** Runtime warning tokens incorporated into health/doctor status. */
15
- warnings: string[];
15
+ warnings:string[];
16
16
  /** Direct author correction for every reported state. */
17
- remediation: string[];
17
+ remediation:string[];
18
18
  }
19
19
  /** Inspect `<workspace>/manifest.json` without loading extension code. */
20
- export declare function inspectExtensionAuthorManifest(workspaceRoot: string): Promise<ExtensionAuthorManifestDiagnostic>;
20
+ export declare function inspectExtensionAuthorManifest(workspaceRoot:string):Promise<ExtensionAuthorManifestDiagnostic>;
21
21
  /** Inspect the author manifest for a resolved project tracker root. */
22
- export declare function inspectExtensionAuthorManifestAtPmRoot(pmRoot: string): Promise<ExtensionAuthorManifestDiagnostic>;
22
+ export declare function inspectExtensionAuthorManifestAtPmRoot(pmRoot:string):Promise<ExtensionAuthorManifestDiagnostic>;
@@ -1,35 +1,35 @@
1
1
  import type { GlobalOptions } from "../../core/shared/command-types.js";
2
- import type { ExtensionCommandOptions, ExtensionScope } from "../extension.js";
2
+ import type { ExtensionCommandOptions,ExtensionScope } from "../extension.js";
3
3
  /** Implements resolve bundled extension alias source for the public runtime surface of this module. */
4
- export declare function resolveBundledExtensionAliasSource(input: string): Promise<string | null>;
4
+ export declare function resolveBundledExtensionAliasSource(input:string):Promise<string | null>;
5
5
  /** Implements check whether bundled package install all target for the public runtime surface of this module. */
6
- export declare function isBundledPackageInstallAllTarget(input: string): boolean;
6
+ export declare function isBundledPackageInstallAllTarget(input:string):boolean;
7
7
  /** Implements list bundled package aliases for the public runtime surface of this module. */
8
- export declare function listBundledPackageAliases(): Promise<string[]>;
8
+ export declare function listBundledPackageAliases():Promise<string[]>;
9
9
  /**
10
10
  * Implements resolve bundled package root for the public runtime surface of this module.
11
11
  * Accepts every spelling agents naturally reach for: the catalog alias
12
12
  * ("kanban"), the package directory ("pm-kanban"), and the published npm name
13
13
  * ("@unbrained/pm-kanban").
14
14
  */
15
- export declare function resolveBundledPackageRoot(alias: string): Promise<string | null>;
15
+ export declare function resolveBundledPackageRoot(alias:string):Promise<string | null>;
16
16
  /** Resolve the published npm package name for a bundled alias so install flows can persist it as managed-source provenance (`source.package`). Returns null when the alias is unknown or the bundled package manifest lacks a name. */
17
- export declare function resolveBundledPackageNpmName(alias: string): Promise<string | null>;
17
+ export declare function resolveBundledPackageNpmName(alias:string):Promise<string | null>;
18
18
  /** Implements resolve bundled alias manifest name for the public runtime surface of this module. */
19
- export declare function resolveBundledAliasManifestName(input: string): Promise<string | null>;
19
+ export declare function resolveBundledAliasManifestName(input:string):Promise<string | null>;
20
20
  /** Implements build bundled package catalog for the public runtime surface of this module. */
21
- export declare function buildBundledPackageCatalog(scope: ExtensionScope, global: GlobalOptions, options?: ExtensionCommandOptions): Promise<{
22
- total: number;
23
- scope: ExtensionScope;
24
- installable_resource_kinds: string[];
25
- metadata_only_resource_kinds: string[];
26
- packages: Array<Record<string, unknown>>;
21
+ export declare function buildBundledPackageCatalog(scope:ExtensionScope,global:GlobalOptions,options?:ExtensionCommandOptions):Promise<{
22
+ total:number;
23
+ scope:ExtensionScope;
24
+ installable_resource_kinds:string[];
25
+ metadata_only_resource_kinds:string[];
26
+ packages:Array<Record<string,unknown>>;
27
27
  }>;
28
- declare function parsePackageCatalogFields(raw: string | undefined): string[] | undefined;
29
- declare function projectPackageCatalogEntry(entry: Record<string, unknown>, fields: string[]): Record<string, unknown>;
28
+ declare function parsePackageCatalogFields(raw:string | undefined):string[] | undefined;
29
+ declare function projectPackageCatalogEntry(entry:Record<string,unknown>,fields:string[]):Record<string,unknown>;
30
30
  /** Public contract for test only bundled catalog, shared by SDK and presentation-layer consumers. */
31
- export declare const _testOnlyBundledCatalog: {
32
- parsePackageCatalogFields: typeof parsePackageCatalogFields;
33
- projectPackageCatalogEntry: typeof projectPackageCatalogEntry;
31
+ export declare const _testOnlyBundledCatalog:{
32
+ parsePackageCatalogFields:typeof parsePackageCatalogFields;
33
+ projectPackageCatalogEntry:typeof projectPackageCatalogEntry;
34
34
  };
35
35
  export {};
@@ -4,4 +4,4 @@
4
4
  * Provides resource-bounded asynchronous collection transforms for extension workflows.
5
5
  */
6
6
  /** Map inputs with a fixed worker pool so remote checks cannot exhaust process resources. */
7
- export declare const mapWithFixedConcurrency: <Input, Output>(inputs: Input[], concurrency: number, mapper: (input: Input) => Promise<Output>) => Promise<Output[]>;
7
+ export declare const mapWithFixedConcurrency:<Input,Output>(inputs:Input[],concurrency:number,mapper:(input:Input) => Promise<Output>) => Promise<Output[]>;
@@ -1,2 +1,2 @@
1
1
  /** Decide whether a lexical source path belongs in an extension snapshot. Git metadata is always excluded; symlinks remain links. */
2
- export declare function includesExtensionCopyPath(source: string, destination: string, candidate: string, nestedDestination: boolean): boolean;
2
+ export declare function includesExtensionCopyPath(source:string,destination:string,candidate:string,nestedDestination:boolean):boolean;
@@ -3,4 +3,4 @@
3
3
  */
4
4
  import type { activateExtensions } from "../../core/extensions/index.js";
5
5
  /** Report extension and extension-profile fields shadowed by canonical MCP inputs. */
6
- export declare const collectMcpCustomFieldCollisionDoctorWarnings: (activationResult: Awaited<ReturnType<typeof activateExtensions>>) => string[];
6
+ export declare const collectMcpCustomFieldCollisionDoctorWarnings:(activationResult:Awaited<ReturnType<typeof activateExtensions>>) => string[];
@@ -17,7 +17,7 @@
17
17
  * builder is trivially unit-testable against synthetic activations.
18
18
  */
19
19
  import { type ExtensionActivationSummary } from "../../core/extensions/activation-summary.js";
20
- import type { ExtensionActivationResult, ExtensionLayer, ExtensionLoadResult } from "../../core/extensions/loader.js";
20
+ import type { ExtensionActivationResult,ExtensionLayer,ExtensionLoadResult } from "../../core/extensions/loader.js";
21
21
  /** Runtime state of a described extension. `ok` loaded and activated cleanly, `failed` loaded but threw during `activate`, and `not_loaded` failed to import at all -- the latter two register nothing, so their `surfaces` are empty and the status explains why (rather than implying the extension contributes nothing). */
22
22
  export type ExtensionDescribeActivationStatus = "ok" | "failed" | "not_loaded";
23
23
  /**
@@ -32,15 +32,15 @@ export type ExtensionDescribeActivationStatus = "ok" | "failed" | "not_loaded";
32
32
  */
33
33
  export interface ExtensionSurfaceDescription {
34
34
  /** Value that configures or reports name for this contract. */
35
- name: string;
35
+ name:string;
36
36
  /** Value that configures or reports layer for this contract. */
37
- layer: ExtensionLayer;
37
+ layer:ExtensionLayer;
38
38
  /** Value that configures or reports version for this contract. */
39
- version: string;
39
+ version:string;
40
40
  /** Activation outcome reported for this extension. */
41
- activation_status: ExtensionDescribeActivationStatus;
41
+ activation_status:ExtensionDescribeActivationStatus;
42
42
  /** Value that configures or reports surfaces for this contract. */
43
- surfaces: ExtensionActivationSummary;
43
+ surfaces:ExtensionActivationSummary;
44
44
  }
45
45
  /**
46
46
  * Result of {@link buildExtensionDescribeResult}: the per-extension surface maps
@@ -50,37 +50,37 @@ surfaces: ExtensionActivationSummary;
50
50
  */
51
51
  export interface ExtensionDescribeResult {
52
52
  /** Value that configures or reports target for this contract. */
53
- target: string | null;
53
+ target:string | null;
54
54
  /** Value that configures or reports total for this contract. */
55
- total: number;
55
+ total:number;
56
56
  /** Value that configures or reports extensions for this contract. */
57
- extensions: ExtensionSurfaceDescription[];
57
+ extensions:ExtensionSurfaceDescription[];
58
58
  /** Value that configures or reports union for this contract. */
59
- union: ExtensionActivationSummary;
59
+ union:ExtensionActivationSummary;
60
60
  /** Deterministic ownership table for every registered command handler or override in scope. */
61
- command_ownership: ExtensionCommandOwnership[];
61
+ command_ownership:ExtensionCommandOwnership[];
62
62
  }
63
63
  /** One package claim on a command path, including whether runtime precedence selects it. */
64
64
  export interface ExtensionCommandClaimant {
65
65
  /** Extension manifest name. */
66
- name: string;
66
+ name:string;
67
67
  /** Extension discovery layer. */
68
- layer: ExtensionLayer;
68
+ layer:ExtensionLayer;
69
69
  /** Whether this claimant is the effective owner under the declared policy. */
70
- winner: boolean;
70
+ winner:boolean;
71
71
  }
72
72
  /** Inspectable ownership and collision state for one command registry surface. */
73
73
  export interface ExtensionCommandOwnership {
74
74
  /** Full command path. */
75
- command: string;
75
+ command:string;
76
76
  /** Registry surface that owns dispatch behavior. */
77
- surface: "handler" | "override";
77
+ surface:"handler" | "override";
78
78
  /** Stable runtime precedence policy. */
79
- policy: "last_activated_wins";
79
+ policy:"last_activated_wins";
80
80
  /** Whether more than one extension claims this path on the same surface. */
81
- collision: boolean;
81
+ collision:boolean;
82
82
  /** Every claimant in activation order; exactly the final claimant is the winner. */
83
- claimants: ExtensionCommandClaimant[];
83
+ claimants:ExtensionCommandClaimant[];
84
84
  }
85
85
  /**
86
86
  * Summarize, by name, every registration surface the loaded extensions exercised.
@@ -97,7 +97,7 @@ claimants: ExtensionCommandClaimant[];
97
97
  * to install without a second lookup. An unmatched `target` yields an empty
98
98
  * `extensions` array -- the caller decides whether that is a not-found error.
99
99
  */
100
- export declare function buildExtensionDescribeResult(target: string | undefined, loadResult: ExtensionLoadResult, activationResult: ExtensionActivationResult): ExtensionDescribeResult;
100
+ export declare function buildExtensionDescribeResult(target:string | undefined,loadResult:ExtensionLoadResult,activationResult:ExtensionActivationResult):ExtensionDescribeResult;
101
101
  /**
102
102
  * Render an {@link ExtensionDescribeResult} as a Markdown reference document: a
103
103
  * top-level title and scope line, one section per described extension (titled
@@ -112,4 +112,4 @@ export declare function buildExtensionDescribeResult(target: string | undefined,
112
112
  * target is already a not-found error upstream, so this is the "nothing loaded"
113
113
  * case) the document is the title plus a single explanatory note.
114
114
  */
115
- export declare function renderExtensionDescribeMarkdown(result: ExtensionDescribeResult, noun: string): string;
115
+ export declare function renderExtensionDescribeMarkdown(result:ExtensionDescribeResult,noun:string):string;
@@ -3,39 +3,39 @@
3
3
  *
4
4
  * Implements extension package-management support for Doctor.
5
5
  */
6
- import { activateExtensions, loadExtensions } from "../../core/extensions/index.js";
6
+ import { activateExtensions,loadExtensions } from "../../core/extensions/index.js";
7
7
  import { type UnknownExtensionCapabilityWarningDetails } from "../../core/extensions/loader.js";
8
- import type { ExtensionCommandOptions, ExtensionDoctorDetailMode, ExtensionScope, ExtensionTriageSummary, ManagedExtensionSummary } from "../extension.js";
8
+ import type { ExtensionCommandOptions,ExtensionDoctorDetailMode,ExtensionScope,ExtensionTriageSummary,ManagedExtensionSummary } from "../extension.js";
9
9
  /** Project loader and activation failures into bounded doctor output. */
10
- export declare function summarizeExtensionFailures(failures: Array<{
11
- layer: string;
12
- name: string;
13
- error: string;
14
- }>): Array<{
15
- layer: string;
16
- name: string;
17
- error: string;
10
+ export declare function summarizeExtensionFailures(failures:Array<{
11
+ layer:string;
12
+ name:string;
13
+ error:string;
14
+ }>):Array<{
15
+ layer:string;
16
+ name:string;
17
+ error:string;
18
18
  }>;
19
19
  /** Implements apply doctor runtime activation state for the public runtime surface of this module. */
20
- export declare function applyDoctorRuntimeActivationState(extensions: ManagedExtensionSummary[], loadResult: Awaited<ReturnType<typeof loadExtensions>>, activationResult: Awaited<ReturnType<typeof activateExtensions>>): ManagedExtensionSummary[];
20
+ export declare function applyDoctorRuntimeActivationState(extensions:ManagedExtensionSummary[],loadResult:Awaited<ReturnType<typeof loadExtensions>>,activationResult:Awaited<ReturnType<typeof activateExtensions>>):ManagedExtensionSummary[];
21
21
  /** Implements build registration collision remediation for the public runtime surface of this module. */
22
- export declare function buildRegistrationCollisionRemediation(warnings: string[], commands: {
23
- deactivate: string;
24
- doctor: string;
25
- }): string | null;
22
+ export declare function buildRegistrationCollisionRemediation(warnings:string[],commands:{
23
+ deactivate:string;
24
+ doctor:string;
25
+ }):string | null;
26
26
  /** Implements classify doctor load failure warnings for the public runtime surface of this module. */
27
- export declare function classifyDoctorLoadFailureWarnings(loadFailures: Array<{
28
- name: string;
29
- error: string;
30
- }>): string[];
27
+ export declare function classifyDoctorLoadFailureWarnings(loadFailures:Array<{
28
+ name:string;
29
+ error:string;
30
+ }>):string[];
31
31
  /** Implements classify doctor activation failure warnings for the public runtime surface of this module. */
32
- export declare function classifyDoctorActivationFailureWarnings(activationFailures?: Array<{
33
- name: string;
34
- trace?: {
35
- missing_capability?: string;
36
- capability?: string;
32
+ export declare function classifyDoctorActivationFailureWarnings(activationFailures?:Array<{
33
+ name:string;
34
+ trace?:{
35
+ missing_capability?:string;
36
+ capability?:string;
37
37
  };
38
- }>): string[];
38
+ }>):string[];
39
39
  /**
40
40
  * Classify advisory least-privilege warnings for capabilities each loaded
41
41
  * extension declares in its manifest but never registers against.
@@ -46,32 +46,32 @@ capability?: string;
46
46
  * inverse failure (registering a surface whose capability is undeclared) is the
47
47
  * blocking `extension_capability_missing` warning emitted during activation.
48
48
  */
49
- export declare function classifyUnusedCapabilityWarnings(loadResult: Awaited<ReturnType<typeof loadExtensions>>, activationResult: Awaited<ReturnType<typeof activateExtensions>>): string[];
49
+ export declare function classifyUnusedCapabilityWarnings(loadResult:Awaited<ReturnType<typeof loadExtensions>>,activationResult:Awaited<ReturnType<typeof activateExtensions>>):string[];
50
50
  /** Implements build extension triage summary for the public runtime surface of this module. */
51
- export declare function buildExtensionTriageSummary(scope: ExtensionScope, warnings: string[], extensions: ManagedExtensionSummary[], options?: ExtensionCommandOptions): ExtensionTriageSummary;
51
+ export declare function buildExtensionTriageSummary(scope:ExtensionScope,warnings:string[],extensions:ManagedExtensionSummary[],options?:ExtensionCommandOptions):ExtensionTriageSummary;
52
52
  /** Implements parse doctor detail mode for the public runtime surface of this module. */
53
- export declare function parseDoctorDetailMode(raw: string | undefined): ExtensionDoctorDetailMode;
53
+ export declare function parseDoctorDetailMode(raw:string | undefined):ExtensionDoctorDetailMode;
54
54
  /** Implements collect unknown capability guidance for the public runtime surface of this module. */
55
- export declare function collectUnknownCapabilityGuidance(warnings: string[]): UnknownExtensionCapabilityWarningDetails[];
55
+ export declare function collectUnknownCapabilityGuidance(warnings:string[]):UnknownExtensionCapabilityWarningDetails[];
56
56
  /** Implements build capability contract metadata for the public runtime surface of this module. */
57
- export declare function buildCapabilityContractMetadata(): {
58
- version: number;
59
- capabilities: string[];
60
- legacy_aliases: Record<string, string>;
57
+ export declare function buildCapabilityContractMetadata():{
58
+ version:number;
59
+ capabilities:string[];
60
+ legacy_aliases:Record<string,string>;
61
61
  };
62
62
  /** Implements build doctor consistency summary for the public runtime surface of this module. */
63
- export declare function buildDoctorConsistencySummary(scope: ExtensionScope, installedExtensions: ManagedExtensionSummary[], loadedExtensions: Array<{
64
- layer: string;
65
- name: string;
66
- }>, failedLoads: Array<{
67
- name: string;
68
- }>, disabledByFlag: boolean): {
69
- warnings: string[];
70
- summary: {
71
- active_project_count: number;
72
- loaded_project_count: number;
73
- active_project_names: string[];
74
- loaded_project_names: string[];
75
- missing_active_project_names: string[];
63
+ export declare function buildDoctorConsistencySummary(scope:ExtensionScope,installedExtensions:ManagedExtensionSummary[],loadedExtensions:Array<{
64
+ layer:string;
65
+ name:string;
66
+ }>,failedLoads:Array<{
67
+ name:string;
68
+ }>,disabledByFlag:boolean):{
69
+ warnings:string[];
70
+ summary:{
71
+ active_project_count:number;
72
+ loaded_project_count:number;
73
+ active_project_names:string[];
74
+ loaded_project_names:string[];
75
+ missing_active_project_names:string[];
76
76
  };
77
77
  };