@unbrained/pm-cli 2026.10.11 → 2026.10.13

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 (740) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +45 -0
  3. package/dist/cli/after-command-context-usage.d.ts +8 -8
  4. package/dist/cli/bundle-integrity.d.ts +23 -23
  5. package/dist/cli/commander-usage.d.ts +31 -31
  6. package/dist/cli/commander-usage.js +3 -3
  7. package/dist/cli/error-guidance.d.ts +158 -161
  8. package/dist/cli/error-guidance.js +2 -2
  9. package/dist/cli/extension-command-help.d.ts +68 -68
  10. package/dist/cli/extension-command-options.d.ts +20 -20
  11. package/dist/cli/extension-recovery.d.ts +20 -20
  12. package/dist/cli/help-content.d.ts +16 -16
  13. package/dist/cli/help-content.js +2 -2
  14. package/dist/cli/help-json-payload.d.ts +40 -40
  15. package/dist/cli/help-json-payload.js +1 -1
  16. package/dist/cli/invocation-profile.d.ts +8 -8
  17. package/dist/cli/main.d.ts +166 -165
  18. package/dist/cli/main.js +4 -4
  19. package/dist/cli/migration-gates.d.ts +20 -20
  20. package/dist/cli/register-list-query.d.ts +4 -4
  21. package/dist/cli/register-mutation-options.d.ts +2 -2
  22. package/dist/cli/register-operations.d.ts +68 -63
  23. package/dist/cli/register-operations.js +1 -1
  24. package/dist/cli/register-setup.d.ts +1 -1
  25. package/dist/cli/register-structured-mutation.d.ts +3 -3
  26. package/dist/cli/register-structured-mutation.js +1 -1
  27. package/dist/cli/runtime/activation.d.ts +3 -3
  28. package/dist/cli/runtime/invocation-options.js +1 -1
  29. package/dist/cli/runtime/selection.d.ts +6 -6
  30. package/dist/cli/runtime-compatibility-boundary.d.ts +12 -12
  31. package/dist/cli-bundle/bundle-manifest.json +1 -1
  32. package/dist/cli-bundle/chunks/{chunk-K2UTE75T.js → chunk-AM2XOZKE.js} +2 -2
  33. package/dist/cli-bundle/chunks/{chunk-S445XEYT.js → chunk-APWPC4ZZ.js} +2 -2
  34. package/dist/cli-bundle/chunks/chunk-DJDRHJBP.js +234 -0
  35. package/dist/cli-bundle/chunks/{chunk-RUT3CCAG.js → chunk-DUK5DHI6.js} +2 -2
  36. package/dist/cli-bundle/chunks/chunk-HXHFKXLV.js +2 -0
  37. package/dist/cli-bundle/chunks/chunk-IFPJDJUM.js +20 -0
  38. package/dist/cli-bundle/chunks/{chunk-OBLO45UM.js → chunk-LBDWFWPK.js} +2 -2
  39. package/dist/cli-bundle/chunks/{chunk-ZWRLAOA4.js → chunk-N5EXRYCZ.js} +2 -2
  40. package/dist/cli-bundle/chunks/chunk-PSNS537F.js +30 -0
  41. package/dist/cli-bundle/chunks/{chunk-2JYTSTQP.js → chunk-RL45OYTL.js} +2 -2
  42. package/dist/cli-bundle/chunks/{chunk-ESRACL6K.js → chunk-UBTYYZIE.js} +49 -49
  43. package/dist/cli-bundle/chunks/chunk-WYZGZV2M.js +2 -0
  44. package/dist/cli-bundle/chunks/{chunk-SSY4OSJR.js → chunk-YH6H3UVE.js} +10 -10
  45. package/dist/cli-bundle/chunks/{register-list-query-T6BOR67M.js → register-list-query-BJ742QOR.js} +2 -2
  46. package/dist/cli-bundle/chunks/{register-mutation-6NXR7SAJ.js → register-mutation-GGGBRIH2.js} +3 -3
  47. package/dist/cli-bundle/chunks/register-operations-E6HXYHNM.js +2 -0
  48. package/dist/cli-bundle/chunks/{register-setup-MAYFPKBX.js → register-setup-4ZVTVEPY.js} +2 -2
  49. package/dist/cli-bundle/focused-chunks/{chunk-EIOQNLBQ.js → chunk-3LQEBXU5.js} +12 -12
  50. package/dist/cli-bundle/focused-chunks/{chunk-PLTTMQAW.js → chunk-6BTUISKV.js} +2 -2
  51. package/dist/cli-bundle/focused-chunks/chunk-73UNAJHD.js +2 -0
  52. package/dist/cli-bundle/focused-chunks/{chunk-WAOXID5J.js → chunk-DVK7VKZL.js} +2 -2
  53. package/dist/cli-bundle/focused-chunks/{chunk-SIEGIPNT.js → chunk-F5J3ATMV.js} +16 -16
  54. package/dist/cli-bundle/focused-chunks/chunk-IIKFTJVC.js +2 -0
  55. package/dist/cli-bundle/focused-chunks/chunk-IOTNG6CN.js +2 -0
  56. package/dist/cli-bundle/focused-chunks/{chunk-AU6VJGTY.js → chunk-KGFRQ34R.js} +2 -2
  57. package/dist/cli-bundle/focused-chunks/chunk-NNW5BS5L.js +3 -0
  58. package/dist/cli-bundle/focused-chunks/{chunk-KNJR2WUO.js → chunk-QMNAY25P.js} +62 -62
  59. package/dist/cli-bundle/focused-chunks/{chunk-W5AE7GKZ.js → chunk-R23T7GFZ.js} +2 -2
  60. package/dist/cli-bundle/focused-chunks/chunk-RAA7SVRA.js +8 -0
  61. package/dist/cli-bundle/focused-chunks/{chunk-52UJEHEV.js → chunk-RU6GCFN3.js} +2 -2
  62. package/dist/cli-bundle/focused-chunks/{chunk-JGFSSR3G.js → chunk-S6ITXQ5T.js} +5 -5
  63. package/dist/cli-bundle/focused-chunks/{chunk-DMSADMEU.js → chunk-SOB7X4FJ.js} +2 -2
  64. package/dist/cli-bundle/focused-chunks/chunk-UPJA45K7.js +26 -0
  65. package/dist/cli-bundle/main.js +22 -22
  66. package/dist/cli-bundle/sdk-authoring.js +1 -1
  67. package/dist/cli-bundle/sdk-contracts.js +2 -2
  68. package/dist/cli-bundle/sdk-core.js +31 -31
  69. package/dist/cli-bundle/sdk-governance.js +1 -1
  70. package/dist/cli-bundle/sdk-graph.js +1 -1
  71. package/dist/cli-bundle/sdk-merge.js +51 -51
  72. package/dist/cli-bundle/sdk-query.js +1 -1
  73. package/dist/cli-bundle/sdk-runtime.js +1 -1
  74. package/dist/cli-bundle/sdk-testing.js +1 -1
  75. package/dist/cli-bundle/sdk.js +8 -8
  76. package/dist/cli.d.ts +4 -4
  77. package/dist/core/checkpoint/checkpoint-gc.d.ts +32 -32
  78. package/dist/core/checkpoint/mutation-checkpoint.d.ts +34 -34
  79. package/dist/core/config/nested-settings.d.ts +26 -26
  80. package/dist/core/config/positional-value.d.ts +16 -16
  81. package/dist/core/diagnostics/remediation.d.ts +6 -6
  82. package/dist/core/diagnostics/remediation.js +1 -1
  83. package/dist/core/extensions/activation-summary-markdown.d.ts +6 -6
  84. package/dist/core/extensions/activation-summary.d.ts +54 -54
  85. package/dist/core/extensions/activation-transaction.d.ts +7 -7
  86. package/dist/core/extensions/capability-usage.d.ts +26 -26
  87. package/dist/core/extensions/command-hook-context.d.ts +26 -26
  88. package/dist/core/extensions/contribution-inventory.d.ts +21 -21
  89. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  90. package/dist/core/extensions/extension-capability-aliases.d.ts +2 -2
  91. package/dist/core/extensions/extension-policy.d.ts +80 -80
  92. package/dist/core/extensions/extension-types.d.ts +1294 -1285
  93. package/dist/core/extensions/extension-types.js +1 -1
  94. package/dist/core/extensions/flag-definition-validation.d.ts +4 -4
  95. package/dist/core/extensions/item-fields.d.ts +3 -2
  96. package/dist/core/extensions/item-fields.js +1 -1
  97. package/dist/core/extensions/loader.d.ts +36 -36
  98. package/dist/core/extensions/loader.js +1 -1
  99. package/dist/core/extensions/manifest-schema.d.ts +16 -16
  100. package/dist/core/extensions/module-graph-snapshot.d.ts +8 -8
  101. package/dist/core/extensions/read-output-contract.d.ts +5 -0
  102. package/dist/core/extensions/read-output-contract.js +2 -0
  103. package/dist/core/extensions/registration-values.d.ts +1 -1
  104. package/dist/core/extensions/reserved-host-flags.d.ts +6 -6
  105. package/dist/core/extensions/version-compat.d.ts +10 -10
  106. package/dist/core/fs/fs-utils.d.ts +1 -1
  107. package/dist/core/fs/host-environment-errors.d.ts +14 -14
  108. package/dist/core/governance/content-fields.d.ts +31 -31
  109. package/dist/core/governance/issue-codes.d.ts +27 -27
  110. package/dist/core/governance/metadata-coverage.d.ts +91 -91
  111. package/dist/core/history/drift-scan.d.ts +26 -26
  112. package/dist/core/history/event-classification.d.ts +1 -1
  113. package/dist/core/history/event-classification.js +1 -1
  114. package/dist/core/history/event-index.d.ts +41 -41
  115. package/dist/core/history/history-compact-bulk.d.ts +22 -22
  116. package/dist/core/history/history-diff.d.ts +22 -22
  117. package/dist/core/history/history-rewrite.d.ts +66 -66
  118. package/dist/core/history/history-storage-stats.d.ts +31 -31
  119. package/dist/core/history/history-stream-policy.d.ts +12 -12
  120. package/dist/core/history/history.d.ts +22 -22
  121. package/dist/core/history/identity.d.ts +6 -6
  122. package/dist/core/history/operation-contract.d.ts +9 -9
  123. package/dist/core/history/projection.d.ts +15 -15
  124. package/dist/core/history/read.d.ts +4 -4
  125. package/dist/core/history/replay.d.ts +51 -49
  126. package/dist/core/history/replay.js +1 -1
  127. package/dist/core/history/workspace-history.d.ts +101 -101
  128. package/dist/core/io/bulk-ids-input.d.ts +4 -4
  129. package/dist/core/item/actionability.d.ts +40 -40
  130. package/dist/core/item/id.d.ts +3 -3
  131. package/dist/core/item/item-format-version.d.ts +8 -8
  132. package/dist/core/item/item-format.d.ts +37 -35
  133. package/dist/core/item/item-format.js +2 -2
  134. package/dist/core/item/item-type-definition.d.ts +2 -2
  135. package/dist/core/item/parent-reference-policy.d.ts +1 -1
  136. package/dist/core/item/parse.d.ts +12 -12
  137. package/dist/core/item/sprint-release-format.d.ts +2 -2
  138. package/dist/core/item/status-filter.d.ts +4 -4
  139. package/dist/core/item/toon-decode.d.ts +9 -9
  140. package/dist/core/item/type-registry.d.ts +40 -40
  141. package/dist/core/lock/lock-gc.d.ts +50 -50
  142. package/dist/core/lock/lock.d.ts +37 -37
  143. package/dist/core/output/mutation-projection.d.ts +6 -6
  144. package/dist/core/output/output-control.d.ts +4 -4
  145. package/dist/core/output/output.d.ts +40 -40
  146. package/dist/core/output/query-summary.d.ts +5 -5
  147. package/dist/core/packages/manifest.d.ts +50 -50
  148. package/dist/core/policy/workflow-policy-schema.d.ts +306 -306
  149. package/dist/core/policy/workflow-policy-store.d.ts +7 -7
  150. package/dist/core/policy/workflow-policy.d.ts +81 -81
  151. package/dist/core/profile/profile-describe.d.ts +40 -40
  152. package/dist/core/profile/profile-lint.d.ts +20 -20
  153. package/dist/core/profile/profile-plan.d.ts +84 -84
  154. package/dist/core/profile/profile-presets.d.ts +52 -52
  155. package/dist/core/reproducibility/context.d.ts +6 -6
  156. package/dist/core/schema/fields-file.d.ts +54 -54
  157. package/dist/core/schema/item-types-file.d.ts +36 -36
  158. package/dist/core/schema/runtime-field-values.d.ts +2 -2
  159. package/dist/core/schema/runtime-schema.d.ts +86 -86
  160. package/dist/core/schema/status-defs-file.d.ts +36 -36
  161. package/dist/core/schema/type-inference.d.ts +14 -14
  162. package/dist/core/schema/type-workflows.d.ts +22 -22
  163. package/dist/core/search/background-refresh.d.ts +9 -9
  164. package/dist/core/search/bm25.d.ts +19 -19
  165. package/dist/core/search/cache.d.ts +35 -35
  166. package/dist/core/search/corpus.d.ts +12 -12
  167. package/dist/core/search/embedding-batches.d.ts +48 -48
  168. package/dist/core/search/eval.d.ts +49 -49
  169. package/dist/core/search/http-client.d.ts +38 -38
  170. package/dist/core/search/providers.d.ts +41 -41
  171. package/dist/core/search/relevance.d.ts +20 -20
  172. package/dist/core/search/semantic-defaults.d.ts +8 -8
  173. package/dist/core/search/staleness.d.ts +4 -4
  174. package/dist/core/search/vector-stores.d.ts +78 -78
  175. package/dist/core/search/vectorization-metadata.d.ts +6 -6
  176. package/dist/core/sentry/helpers.d.ts +15 -15
  177. package/dist/core/sentry/instrument.d.ts +40 -40
  178. package/dist/core/session/session-state.d.ts +32 -32
  179. package/dist/core/shared/agent-session-context.d.ts +14 -14
  180. package/dist/core/shared/author.d.ts +128 -128
  181. package/dist/core/shared/command-types.d.ts +40 -40
  182. package/dist/core/shared/conflict-markers.d.ts +6 -6
  183. package/dist/core/shared/constants.d.ts +13 -13
  184. package/dist/core/shared/errors.d.ts +194 -183
  185. package/dist/core/shared/errors.js +1 -1
  186. package/dist/core/shared/secret-rules.d.ts +97 -97
  187. package/dist/core/shared/serial-queue.d.ts +8 -8
  188. package/dist/core/shared/split-comma-list.d.ts +6 -6
  189. package/dist/core/shared/time.d.ts +23 -23
  190. package/dist/core/store/item-format-migration.d.ts +10 -10
  191. package/dist/core/store/item-metadata-cache.d.ts +38 -38
  192. package/dist/core/store/item-metadata-query-index.d.ts +79 -79
  193. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  194. package/dist/core/store/item-store.d.ts +110 -110
  195. package/dist/core/store/paths.d.ts +2 -2
  196. package/dist/core/store/settings-read-cache.d.ts +12 -12
  197. package/dist/core/store/settings-validator.d.ts +165 -165
  198. package/dist/core/store/settings.d.ts +59 -59
  199. package/dist/core/telemetry/observability.d.ts +17 -17
  200. package/dist/core/telemetry/policy.d.ts +3 -3
  201. package/dist/core/telemetry/runtime.d.ts +242 -242
  202. package/dist/core/telemetry/runtime.js +2 -2
  203. package/dist/core/test/background-runs.d.ts +186 -185
  204. package/dist/core/test/background-runs.js +2 -2
  205. package/dist/core/test/item-test-run-tracking.d.ts +6 -6
  206. package/dist/core/test/run-selectors.d.ts +18 -18
  207. package/dist/core/validate/fix-planning.d.ts +50 -50
  208. package/dist/core/validate/missing-by-type.d.ts +4 -4
  209. package/dist/core/validate/missing-link-owners.d.ts +30 -30
  210. package/dist/core/validate/stale-file-classification.d.ts +8 -8
  211. package/dist/mcp/http-server.d.ts +28 -28
  212. package/dist/mcp/legacy-adapter.d.ts +33 -33
  213. package/dist/mcp/runtime-capabilities.d.ts +16 -16
  214. package/dist/mcp/server.d.ts +50 -50
  215. package/dist/mcp/tool-definitions.d.ts +36 -36
  216. package/dist/sdk/agent/closed-domain-contracts.d.ts +18 -18
  217. package/dist/sdk/agent/command-recovery.d.ts +4 -0
  218. package/dist/sdk/agent/command-recovery.js +1 -1
  219. package/dist/sdk/agent/command-suggestions.d.ts +2 -0
  220. package/dist/sdk/agent/command-suggestions.js +1 -1
  221. package/dist/sdk/agent/identity-config.d.ts +32 -32
  222. package/dist/sdk/agent/item-addressing.d.ts +8 -8
  223. package/dist/sdk/agent/refusal-closure-census.d.ts +34 -34
  224. package/dist/sdk/agent/refusal-closure.d.ts +42 -42
  225. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +46 -46
  226. package/dist/sdk/agent/refusal-reachability.d.ts +112 -112
  227. package/dist/sdk/agent/subcommand-recovery.d.ts +25 -25
  228. package/dist/sdk/agent/task-transcript-contracts.d.ts +30 -30
  229. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +38 -38
  230. package/dist/sdk/agent-capability-contracts.d.ts +37 -37
  231. package/dist/sdk/annotations.d.ts +106 -106
  232. package/dist/sdk/author-attribution.d.ts +76 -76
  233. package/dist/sdk/authoring.d.ts +1 -1
  234. package/dist/sdk/authoring.js +1 -1
  235. package/dist/sdk/cli-bootstrap.d.ts +70 -70
  236. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +63 -63
  237. package/dist/sdk/cli-contracts/command-aliases.d.ts +14 -14
  238. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +70 -70
  239. package/dist/sdk/cli-contracts/commander-types.d.ts +17 -17
  240. package/dist/sdk/cli-contracts/completeness.d.ts +26 -26
  241. package/dist/sdk/cli-contracts/enum-contracts.d.ts +5 -5
  242. package/dist/sdk/cli-contracts/flag-contracts.d.ts +32 -32
  243. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  244. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +42 -42
  245. package/dist/sdk/cli-contracts/flag-lexicon-contracts.js +1 -1
  246. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +84 -84
  247. package/dist/sdk/cli-contracts/grammar-contracts.js +1 -1
  248. package/dist/sdk/cli-contracts/registration-helpers.d.ts +37 -40
  249. package/dist/sdk/cli-contracts/registration-helpers.js +1 -1
  250. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +290 -294
  251. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  252. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +793 -793
  253. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +391 -391
  254. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +6 -6
  255. package/dist/sdk/cli-contracts/tool-parameter-tables.js +1 -1
  256. package/dist/sdk/cli-contracts/tool-schema.d.ts +55 -55
  257. package/dist/sdk/cli-contracts/tool-schema.js +1 -1
  258. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +24 -24
  259. package/dist/sdk/comments.d.ts +44 -44
  260. package/dist/sdk/compile-cache.d.ts +4 -4
  261. package/dist/sdk/completion/shared.d.ts +22 -22
  262. package/dist/sdk/compose.d.ts +156 -156
  263. package/dist/sdk/config.d.ts +123 -123
  264. package/dist/sdk/context/semantic-session-attribution.d.ts +14 -14
  265. package/dist/sdk/context/usage-ledger.d.ts +20 -20
  266. package/dist/sdk/context-intent-contracts.d.ts +50 -50
  267. package/dist/sdk/context-intent-contracts.js +1 -1
  268. package/dist/sdk/context-intent-runtime.d.ts +8 -8
  269. package/dist/sdk/context-packing.d.ts +78 -78
  270. package/dist/sdk/context-relevance.d.ts +189 -180
  271. package/dist/sdk/context-relevance.js +1 -1
  272. package/dist/sdk/context-signal-store.d.ts +84 -84
  273. package/dist/sdk/context-usage.d.ts +92 -92
  274. package/dist/sdk/core.d.ts +1 -0
  275. package/dist/sdk/core.js +1 -1
  276. package/dist/sdk/corpus-shape.d.ts +101 -101
  277. package/dist/sdk/define.d.ts +2 -2
  278. package/dist/sdk/dependencies.d.ts +116 -116
  279. package/dist/sdk/dependency-flag-validation.d.ts +14 -12
  280. package/dist/sdk/dependency-flag-validation.js +1 -1
  281. package/dist/sdk/dependency-provenance.d.ts +30 -30
  282. package/dist/sdk/docs.d.ts +32 -32
  283. package/dist/sdk/duplicates.d.ts +21 -21
  284. package/dist/sdk/environment/agent-environment.d.ts +196 -196
  285. package/dist/sdk/environment/project-runtime-compatibility.d.ts +56 -56
  286. package/dist/sdk/environment/source-context.d.ts +6 -6
  287. package/dist/sdk/error-code-catalog.d.ts +40 -40
  288. package/dist/sdk/errors.d.ts +29 -29
  289. package/dist/sdk/eval.d.ts +45 -45
  290. package/dist/sdk/extension/author-manifest.d.ts +14 -14
  291. package/dist/sdk/extension/bundled-catalog.d.ts +7 -7
  292. package/dist/sdk/extension/describe.d.ts +36 -36
  293. package/dist/sdk/extension/doctor.d.ts +29 -29
  294. package/dist/sdk/extension/install-plan.d.ts +55 -55
  295. package/dist/sdk/extension/install-receipts.d.ts +2 -2
  296. package/dist/sdk/extension/install-runtime.d.ts +8 -8
  297. package/dist/sdk/extension/install-snapshot.d.ts +14 -14
  298. package/dist/sdk/extension/install-sources.d.ts +96 -96
  299. package/dist/sdk/extension/managed-state.d.ts +66 -66
  300. package/dist/sdk/extension/migrations.d.ts +82 -82
  301. package/dist/sdk/extension/output-ownership.d.ts +24 -24
  302. package/dist/sdk/extension/runtime-summary.d.ts +5 -5
  303. package/dist/sdk/extension/scaffold.d.ts +12 -12
  304. package/dist/sdk/extension/shared.d.ts +15 -15
  305. package/dist/sdk/extension/source-resolution.d.ts +30 -30
  306. package/dist/sdk/extension/static-inventory.d.ts +42 -42
  307. package/dist/sdk/extension/update-check.d.ts +10 -10
  308. package/dist/sdk/extension.d.ts +320 -320
  309. package/dist/sdk/files.d.ts +157 -157
  310. package/dist/sdk/flag-invocation-contracts.d.ts +44 -44
  311. package/dist/sdk/generated/generated-error-code-catalog-part-1.js +1 -1
  312. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  313. package/dist/sdk/governance/artifact-ledgers.d.ts +35 -35
  314. package/dist/sdk/governance/artifact-ledgers.js +1 -1
  315. package/dist/sdk/governance/assurance-action.d.ts +68 -68
  316. package/dist/sdk/governance/assurance-action.js +1 -1
  317. package/dist/sdk/governance/assurance-mutation-error.d.ts +36 -36
  318. package/dist/sdk/governance/assurance-presets.d.ts +24 -24
  319. package/dist/sdk/governance/assurance-runtime.d.ts +14 -14
  320. package/dist/sdk/governance/assurance.d.ts +353 -353
  321. package/dist/sdk/governance/boundary-fixtures.d.ts +60 -60
  322. package/dist/sdk/governance/closure-timestamps.d.ts +9 -9
  323. package/dist/sdk/governance/coverage-assurance.d.ts +10 -10
  324. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +75 -75
  325. package/dist/sdk/governance/defect-recurrence-graph.d.ts +18 -18
  326. package/dist/sdk/governance/defect-recurrence.d.ts +186 -181
  327. package/dist/sdk/governance/defect-recurrence.js +1 -1
  328. package/dist/sdk/governance/extension-host-version.d.ts +16 -16
  329. package/dist/sdk/governance/gc.d.ts +48 -48
  330. package/dist/sdk/governance/health-merge-evidence.d.ts +5 -5
  331. package/dist/sdk/governance/health.d.ts +188 -188
  332. package/dist/sdk/governance/hierarchy-validation.d.ts +13 -13
  333. package/dist/sdk/governance/linked-file-report.d.ts +26 -26
  334. package/dist/sdk/governance/merge-receipt-history.d.ts +36 -36
  335. package/dist/sdk/governance/provenance-health.d.ts +64 -64
  336. package/dist/sdk/governance/reindex.d.ts +89 -89
  337. package/dist/sdk/governance/reliability.d.ts +56 -56
  338. package/dist/sdk/governance/stale-work.d.ts +22 -22
  339. package/dist/sdk/governance/status-role-diagnostics.d.ts +12 -12
  340. package/dist/sdk/governance/storage-integrity.d.ts +54 -54
  341. package/dist/sdk/governance/tracked-runtime-cache.d.ts +10 -10
  342. package/dist/sdk/governance/upgrade.d.ts +104 -104
  343. package/dist/sdk/governance/validate-history-drift.d.ts +2 -2
  344. package/dist/sdk/governance/validate-item-reader.d.ts +6 -6
  345. package/dist/sdk/governance/validate.d.ts +191 -191
  346. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  347. package/dist/sdk/governance/workflow-policy.d.ts +28 -28
  348. package/dist/sdk/governance/workspace-position.d.ts +46 -46
  349. package/dist/sdk/graph/adapter.d.ts +66 -66
  350. package/dist/sdk/graph/analytics.d.ts +54 -54
  351. package/dist/sdk/graph/assembly.d.ts +80 -80
  352. package/dist/sdk/graph/cache.d.ts +29 -29
  353. package/dist/sdk/graph/cardinality-integrity.d.ts +13 -0
  354. package/dist/sdk/graph/cardinality-integrity.js +2 -0
  355. package/dist/sdk/graph/centrality.d.ts +34 -34
  356. package/dist/sdk/graph/conformance.d.ts +33 -33
  357. package/dist/sdk/graph/deadline-scheduling.d.ts +58 -58
  358. package/dist/sdk/graph/durable-cache.d.ts +26 -26
  359. package/dist/sdk/graph/governance.d.ts +165 -165
  360. package/dist/sdk/graph/hierarchy-integrity.d.ts +52 -52
  361. package/dist/sdk/graph/index.d.ts +1 -0
  362. package/dist/sdk/graph/index.js +1 -1
  363. package/dist/sdk/graph/lifecycle-coverage.d.ts +17 -17
  364. package/dist/sdk/graph/mutation-advisory.d.ts +11 -11
  365. package/dist/sdk/graph/query-contracts.d.ts +10 -10
  366. package/dist/sdk/graph/remediation.d.ts +25 -25
  367. package/dist/sdk/graph/run.d.ts +392 -392
  368. package/dist/sdk/graph/scheduling.d.ts +38 -38
  369. package/dist/sdk/graph/traversal.d.ts +14 -14
  370. package/dist/sdk/guide-topics.d.ts +32 -32
  371. package/dist/sdk/guide.d.ts +62 -62
  372. package/dist/sdk/history/attestation-command.d.ts +12 -12
  373. package/dist/sdk/history/attestation-contract.d.ts +78 -78
  374. package/dist/sdk/history/attestation-scan.d.ts +6 -6
  375. package/dist/sdk/history/maintenance.d.ts +46 -46
  376. package/dist/sdk/history/salvage.d.ts +18 -18
  377. package/dist/sdk/history/subject.d.ts +9 -9
  378. package/dist/sdk/history-analytics.d.ts +84 -84
  379. package/dist/sdk/history-compact.d.ts +103 -103
  380. package/dist/sdk/history-mcp.d.ts +8 -8
  381. package/dist/sdk/history-provenance.d.ts +59 -59
  382. package/dist/sdk/history-read.d.ts +36 -36
  383. package/dist/sdk/history-redact.d.ts +78 -78
  384. package/dist/sdk/history-repair.d.ts +158 -158
  385. package/dist/sdk/history-repair.js +1 -1
  386. package/dist/sdk/improvement-ledger.d.ts +102 -102
  387. package/dist/sdk/index.d.ts +2 -0
  388. package/dist/sdk/index.js +1 -1
  389. package/dist/sdk/init-agent-guidance.d.ts +70 -70
  390. package/dist/sdk/init.d.ts +152 -152
  391. package/dist/sdk/item-children.d.ts +28 -28
  392. package/dist/sdk/item-schedule.d.ts +12 -12
  393. package/dist/sdk/item-transaction.d.ts +100 -100
  394. package/dist/sdk/learnings.d.ts +42 -42
  395. package/dist/sdk/lifecycle/append.d.ts +14 -14
  396. package/dist/sdk/lifecycle/claim.d.ts +60 -60
  397. package/dist/sdk/lifecycle/close-many.d.ts +94 -94
  398. package/dist/sdk/lifecycle/close.d.ts +27 -27
  399. package/dist/sdk/lifecycle/copy.d.ts +18 -18
  400. package/dist/sdk/lifecycle/core-field-recovery.d.ts +7 -0
  401. package/dist/sdk/lifecycle/core-field-recovery.js +2 -0
  402. package/dist/sdk/lifecycle/create.d.ts +82 -82
  403. package/dist/sdk/lifecycle/create.js +1 -1
  404. package/dist/sdk/lifecycle/delete.d.ts +28 -28
  405. package/dist/sdk/lifecycle/focus.d.ts +10 -10
  406. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +10 -10
  407. package/dist/sdk/lifecycle/hierarchy-mutation-lock.js +1 -1
  408. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +54 -54
  409. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +4 -4
  410. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  411. package/dist/sdk/lifecycle/mutation-command-options.d.ts +116 -116
  412. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +6 -0
  413. package/dist/sdk/lifecycle/mutation-facet-contracts.js +2 -0
  414. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +42 -42
  415. package/dist/sdk/lifecycle/plan.d.ts +217 -217
  416. package/dist/sdk/lifecycle/reopen.d.ts +29 -24
  417. package/dist/sdk/lifecycle/reopen.js +1 -1
  418. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +3 -3
  419. package/dist/sdk/lifecycle/restore.d.ts +33 -33
  420. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +19 -19
  421. package/dist/sdk/lifecycle/task-composition.d.ts +4 -4
  422. package/dist/sdk/lifecycle/update-many.d.ts +79 -79
  423. package/dist/sdk/lifecycle/update.d.ts +131 -132
  424. package/dist/sdk/lifecycle/update.js +2 -2
  425. package/dist/sdk/lifecycle-completion.d.ts +22 -22
  426. package/dist/sdk/lifecycle-policy.d.ts +52 -52
  427. package/dist/sdk/linked-artifacts.d.ts +69 -69
  428. package/dist/sdk/mcp/apps.d.ts +32 -32
  429. package/dist/sdk/mcp/authorization.d.ts +76 -76
  430. package/dist/sdk/mcp/discovery.d.ts +111 -111
  431. package/dist/sdk/mcp/interactions.d.ts +61 -61
  432. package/dist/sdk/mcp/protocol.d.ts +78 -78
  433. package/dist/sdk/mcp/skills.d.ts +88 -88
  434. package/dist/sdk/mcp/subscriptions.d.ts +39 -39
  435. package/dist/sdk/mcp/tasks.d.ts +75 -75
  436. package/dist/sdk/mcp/transport.d.ts +11 -11
  437. package/dist/sdk/merge/abandoned-receipts.d.ts +6 -6
  438. package/dist/sdk/merge/driver.d.ts +60 -60
  439. package/dist/sdk/merge/install.d.ts +64 -64
  440. package/dist/sdk/merge/receipt-file-boundary.d.ts +5 -5
  441. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  442. package/dist/sdk/merge/receipt-schema.d.ts +2 -2
  443. package/dist/sdk/merge/receipts.d.ts +156 -156
  444. package/dist/sdk/merge/reconcile.d.ts +36 -36
  445. package/dist/sdk/merge/reconcile.js +1 -1
  446. package/dist/sdk/merge/three-way.d.ts +77 -76
  447. package/dist/sdk/merge/three-way.js +1 -1
  448. package/dist/sdk/mutation-events.d.ts +84 -84
  449. package/dist/sdk/mutation-guard.d.ts +106 -106
  450. package/dist/sdk/notes.d.ts +52 -52
  451. package/dist/sdk/output/table-rows.d.ts +8 -8
  452. package/dist/sdk/output-contracts.d.ts +38 -38
  453. package/dist/sdk/output-projection.d.ts +142 -142
  454. package/dist/sdk/output-token-accounting.d.ts +27 -27
  455. package/dist/sdk/output.d.ts +28 -28
  456. package/dist/sdk/package-import-adapters.d.ts +54 -54
  457. package/dist/sdk/pagination.d.ts +29 -29
  458. package/dist/sdk/profile.d.ts +123 -123
  459. package/dist/sdk/provenance.d.ts +58 -58
  460. package/dist/sdk/public-surface.json +1 -1
  461. package/dist/sdk/query/activity.d.ts +118 -118
  462. package/dist/sdk/query/aggregate.d.ts +140 -140
  463. package/dist/sdk/query/calendar.d.ts +144 -144
  464. package/dist/sdk/query/complete-list.d.ts +53 -53
  465. package/dist/sdk/query/context.d.ts +395 -395
  466. package/dist/sdk/query/duplicate-candidates.d.ts +1 -1
  467. package/dist/sdk/query/get.d.ts +77 -77
  468. package/dist/sdk/query/history.d.ts +72 -72
  469. package/dist/sdk/query/item-filter-options.d.ts +79 -79
  470. package/dist/sdk/query/list-filter-shared.d.ts +1 -1
  471. package/dist/sdk/query/list.d.ts +188 -188
  472. package/dist/sdk/query/multi-value-filters.d.ts +4 -4
  473. package/dist/sdk/query/next-ready-budget.d.ts +14 -14
  474. package/dist/sdk/query/next.d.ts +137 -137
  475. package/dist/sdk/query/projection-contracts.d.ts +8 -8
  476. package/dist/sdk/query/search/corpus.d.ts +8 -8
  477. package/dist/sdk/query/search/filters.d.ts +5 -5
  478. package/dist/sdk/query/search/input.d.ts +4 -4
  479. package/dist/sdk/query/search/response.d.ts +8 -8
  480. package/dist/sdk/query/search/semantic.d.ts +106 -106
  481. package/dist/sdk/query/search/types.d.ts +85 -85
  482. package/dist/sdk/query/search-contracts.d.ts +65 -65
  483. package/dist/sdk/query/search-pagination.d.ts +19 -19
  484. package/dist/sdk/query/search-rendering.d.ts +25 -25
  485. package/dist/sdk/query/search.d.ts +46 -46
  486. package/dist/sdk/read-output/continuation.d.ts +8 -8
  487. package/dist/sdk/read-output/continuation.js +1 -1
  488. package/dist/sdk/read-output/extension.d.ts +7 -0
  489. package/dist/sdk/read-output/extension.js +2 -0
  490. package/dist/sdk/read-output/options.d.ts +6 -4
  491. package/dist/sdk/read-output/options.js +1 -1
  492. package/dist/sdk/read-output/provenance.d.ts +8 -8
  493. package/dist/sdk/read-output-budget.d.ts +10 -10
  494. package/dist/sdk/read-output-contracts.d.ts +192 -186
  495. package/dist/sdk/read-output-contracts.js +1 -1
  496. package/dist/sdk/read-output-rows.d.ts +6 -6
  497. package/dist/sdk/read-output-session.d.ts +50 -50
  498. package/dist/sdk/relationship-analytics.d.ts +78 -78
  499. package/dist/sdk/relationship-context.d.ts +81 -81
  500. package/dist/sdk/relationship-history.d.ts +109 -109
  501. package/dist/sdk/relationship-kinds/contract.d.ts +34 -34
  502. package/dist/sdk/relationship-migration.d.ts +26 -26
  503. package/dist/sdk/relationships.d.ts +78 -78
  504. package/dist/sdk/reproducibility/process.d.ts +3 -3
  505. package/dist/sdk/runtime/context.d.ts +11 -11
  506. package/dist/sdk/runtime-action-aliases.d.ts +2 -2
  507. package/dist/sdk/runtime-extended-actions.d.ts +8 -8
  508. package/dist/sdk/runtime-input.d.ts +3 -3
  509. package/dist/sdk/runtime-public-contracts.d.ts +78 -78
  510. package/dist/sdk/runtime.d.ts +305 -305
  511. package/dist/sdk/runtime.js +1 -1
  512. package/dist/sdk/scheduling-shortcuts.d.ts +32 -32
  513. package/dist/sdk/schema-migration.d.ts +86 -86
  514. package/dist/sdk/schema.d.ts +355 -355
  515. package/dist/sdk/similarity-scoring.d.ts +10 -10
  516. package/dist/sdk/similarity.d.ts +113 -113
  517. package/dist/sdk/stats.d.ts +108 -108
  518. package/dist/sdk/structured-mutations.d.ts +16 -16
  519. package/dist/sdk/structured-mutations.js +1 -1
  520. package/dist/sdk/telemetry.d.ts +53 -53
  521. package/dist/sdk/templates.d.ts +39 -39
  522. package/dist/sdk/test/batch.d.ts +85 -85
  523. package/dist/sdk/test/batch.js +1 -1
  524. package/dist/sdk/test/command-args.d.ts +4 -0
  525. package/dist/sdk/test/command-args.js +2 -0
  526. package/dist/sdk/test/entry.d.ts +3 -0
  527. package/dist/sdk/test/entry.js +1 -1
  528. package/dist/sdk/test/execution-receipts.d.ts +3 -3
  529. package/dist/sdk/test/execution.d.ts +279 -268
  530. package/dist/sdk/test/execution.js +2 -2
  531. package/dist/sdk/test/json-path.d.ts +2 -2
  532. package/dist/sdk/test/linked-command-detection.d.ts +10 -10
  533. package/dist/sdk/test/measurements.d.ts +11 -11
  534. package/dist/sdk/test/parsers.d.ts +1 -1
  535. package/dist/sdk/test/parsers.js +1 -1
  536. package/dist/sdk/test/prerequisites.d.ts +6 -0
  537. package/dist/sdk/test/prerequisites.js +2 -0
  538. package/dist/sdk/test/runs.d.ts +52 -52
  539. package/dist/sdk/test/trust.d.ts +12 -12
  540. package/dist/sdk/test/trust.js +1 -1
  541. package/dist/sdk/test/update.d.ts +55 -0
  542. package/dist/sdk/test/update.js +2 -0
  543. package/dist/sdk/testing.d.ts +319 -319
  544. package/dist/sdk/traceability/source-traceability.d.ts +65 -65
  545. package/dist/sdk/workspace-contracts.d.ts +37 -37
  546. package/dist/sdk/workspace-memory.d.ts +60 -60
  547. package/dist/sdk/workspace-recipe.d.ts +9 -9
  548. package/dist/sdk/workspace-snapshot.d.ts +97 -97
  549. package/dist/sdk/workspace-transaction-gc.d.ts +32 -32
  550. package/dist/sdk/workspace-transaction.d.ts +47 -47
  551. package/dist/sdk/workspace.d.ts +6 -6
  552. package/dist/types.d.ts +978 -974
  553. package/dist/types.js +1 -1
  554. package/docs/BUILD_AND_RELEASE_ACCEPTANCE.md +5 -2
  555. package/docs/DEFECT_RECURRENCE.md +12 -0
  556. package/docs/EXTENSIONS.md +2 -2
  557. package/docs/LINKED_TEST_EDITS.md +79 -0
  558. package/docs/MERGE_SAFETY.md +27 -1
  559. package/docs/RECURRENCE_RECOVERY_CONTRACTS.md +17 -4
  560. package/docs/RELATIONSHIP_GRAPH.md +26 -0
  561. package/docs/RELEASING.md +25 -8
  562. package/docs/SDK.md +204 -637
  563. package/docs/SDK_CONSUMER_RECEIPTS.md +67 -0
  564. package/docs/SDK_EVIDENCE_TRACEABILITY.md +4 -0
  565. package/docs/TESTING.md +13 -0
  566. package/docs/generated/FLAG_LEXICON_BUDGETS.md +2 -2
  567. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +11 -3
  568. package/docs/performance/runner-qualification.md +36 -0
  569. package/marketplace.json +1 -1
  570. package/node_modules/@opentelemetry/core/build/esm/version.d.ts +1 -1
  571. package/node_modules/@opentelemetry/core/build/esm/version.js +1 -1
  572. package/node_modules/@opentelemetry/core/build/esnext/version.d.ts +1 -1
  573. package/node_modules/@opentelemetry/core/build/esnext/version.js +1 -1
  574. package/node_modules/@opentelemetry/core/build/src/version.d.ts +1 -1
  575. package/node_modules/@opentelemetry/core/build/src/version.js +1 -1
  576. package/node_modules/@opentelemetry/core/package.json +2 -2
  577. package/node_modules/@opentelemetry/resources/build/esm/version.d.ts +1 -1
  578. package/node_modules/@opentelemetry/resources/build/esm/version.js +1 -1
  579. package/node_modules/@opentelemetry/resources/build/esnext/version.d.ts +1 -1
  580. package/node_modules/@opentelemetry/resources/build/esnext/version.js +1 -1
  581. package/node_modules/@opentelemetry/resources/build/src/version.d.ts +1 -1
  582. package/node_modules/@opentelemetry/resources/build/src/version.js +1 -1
  583. package/node_modules/@opentelemetry/resources/package.json +3 -3
  584. package/node_modules/@opentelemetry/sdk-trace/build/esm/StackContextManager.d.ts +57 -0
  585. package/node_modules/@opentelemetry/sdk-trace/build/esm/StackContextManager.js +105 -0
  586. package/node_modules/@opentelemetry/sdk-trace/build/esm/index.d.ts +1 -0
  587. package/node_modules/@opentelemetry/sdk-trace/build/esm/index.js +1 -0
  588. package/node_modules/@opentelemetry/sdk-trace/build/esm/version.d.ts +1 -1
  589. package/node_modules/@opentelemetry/sdk-trace/build/esm/version.js +1 -1
  590. package/node_modules/@opentelemetry/sdk-trace/build/esnext/StackContextManager.d.ts +57 -0
  591. package/node_modules/@opentelemetry/sdk-trace/build/esnext/StackContextManager.js +105 -0
  592. package/node_modules/@opentelemetry/sdk-trace/build/esnext/index.d.ts +1 -0
  593. package/node_modules/@opentelemetry/sdk-trace/build/esnext/index.js +1 -0
  594. package/node_modules/@opentelemetry/sdk-trace/build/esnext/version.d.ts +1 -1
  595. package/node_modules/@opentelemetry/sdk-trace/build/esnext/version.js +1 -1
  596. package/node_modules/@opentelemetry/sdk-trace/build/src/StackContextManager.d.ts +57 -0
  597. package/node_modules/@opentelemetry/sdk-trace/build/src/StackContextManager.js +109 -0
  598. package/node_modules/@opentelemetry/sdk-trace/build/src/index.d.ts +1 -0
  599. package/node_modules/@opentelemetry/sdk-trace/build/src/index.js +3 -1
  600. package/node_modules/@opentelemetry/sdk-trace/build/src/version.d.ts +1 -1
  601. package/node_modules/@opentelemetry/sdk-trace/build/src/version.js +1 -1
  602. package/node_modules/@opentelemetry/sdk-trace/package.json +5 -5
  603. package/node_modules/@opentelemetry/sdk-trace-base/build/esm/version.d.ts +1 -1
  604. package/node_modules/@opentelemetry/sdk-trace-base/build/esm/version.js +1 -1
  605. package/node_modules/@opentelemetry/sdk-trace-base/build/esnext/version.d.ts +1 -1
  606. package/node_modules/@opentelemetry/sdk-trace-base/build/esnext/version.js +1 -1
  607. package/node_modules/@opentelemetry/sdk-trace-base/build/src/version.d.ts +1 -1
  608. package/node_modules/@opentelemetry/sdk-trace-base/build/src/version.js +1 -1
  609. package/node_modules/@opentelemetry/sdk-trace-base/package.json +7 -7
  610. package/node_modules/@sentry/core/build/cjs/browser.js +3 -0
  611. package/node_modules/@sentry/core/build/cjs/fetch.js +10 -9
  612. package/node_modules/@sentry/core/build/cjs/index.js +3 -0
  613. package/node_modules/@sentry/core/build/cjs/integrations/http/add-outgoing-request-breadcrumb.js +2 -1
  614. package/node_modules/@sentry/core/build/cjs/integrations/http/get-outgoing-span-data.js +3 -2
  615. package/node_modules/@sentry/core/build/cjs/integrations/http/server-subscription.js +7 -3
  616. package/node_modules/@sentry/core/build/cjs/integrations/requestdata.js +23 -9
  617. package/node_modules/@sentry/core/build/cjs/server.js +3 -0
  618. package/node_modules/@sentry/core/build/cjs/utils/data-collection/filterCollectedUrl.js +24 -0
  619. package/node_modules/@sentry/core/build/cjs/utils/data-collection/filterKeyValueData.js +17 -23
  620. package/node_modules/@sentry/core/build/cjs/utils/data-collection/filterQueryParams.js +8 -15
  621. package/node_modules/@sentry/core/build/cjs/utils/data-collection/filterUrlQuery.js +20 -0
  622. package/node_modules/@sentry/core/build/cjs/utils/url.js +4 -3
  623. package/node_modules/@sentry/core/build/cjs/utils/version.js +1 -1
  624. package/node_modules/@sentry/core/build/esm/browser.js +1 -0
  625. package/node_modules/@sentry/core/build/esm/fetch.js +10 -9
  626. package/node_modules/@sentry/core/build/esm/index.js +1 -0
  627. package/node_modules/@sentry/core/build/esm/integrations/http/add-outgoing-request-breadcrumb.js +2 -1
  628. package/node_modules/@sentry/core/build/esm/integrations/http/get-outgoing-span-data.js +3 -2
  629. package/node_modules/@sentry/core/build/esm/integrations/http/server-subscription.js +7 -3
  630. package/node_modules/@sentry/core/build/esm/integrations/requestdata.js +23 -9
  631. package/node_modules/@sentry/core/build/esm/package.json +1 -1
  632. package/node_modules/@sentry/core/build/esm/server.js +1 -0
  633. package/node_modules/@sentry/core/build/esm/utils/data-collection/filterCollectedUrl.js +21 -0
  634. package/node_modules/@sentry/core/build/esm/utils/data-collection/filterKeyValueData.js +18 -25
  635. package/node_modules/@sentry/core/build/esm/utils/data-collection/filterQueryParams.js +9 -16
  636. package/node_modules/@sentry/core/build/esm/utils/data-collection/filterUrlQuery.js +18 -0
  637. package/node_modules/@sentry/core/build/esm/utils/url.js +4 -3
  638. package/node_modules/@sentry/core/build/esm/utils/version.js +1 -1
  639. package/node_modules/@sentry/core/build/types/shared-exports.d.ts +1 -0
  640. package/node_modules/@sentry/core/build/types/utils/data-collection/filterCollectedUrl.d.ts +21 -0
  641. package/node_modules/@sentry/core/build/types/utils/data-collection/filterKeyValueData.d.ts +1 -0
  642. package/node_modules/@sentry/core/build/types/utils/data-collection/filterQueryParams.d.ts +2 -3
  643. package/node_modules/@sentry/core/build/types/utils/data-collection/filterUrlQuery.d.ts +13 -0
  644. package/node_modules/@sentry/core/build/types/utils/url.d.ts +4 -1
  645. package/node_modules/@sentry/core/build/types-ts3.8/shared-exports.d.ts +1 -0
  646. package/node_modules/@sentry/core/build/types-ts3.8/utils/data-collection/filterCollectedUrl.d.ts +21 -0
  647. package/node_modules/@sentry/core/build/types-ts3.8/utils/data-collection/filterKeyValueData.d.ts +1 -0
  648. package/node_modules/@sentry/core/build/types-ts3.8/utils/data-collection/filterQueryParams.d.ts +2 -3
  649. package/node_modules/@sentry/core/build/types-ts3.8/utils/data-collection/filterUrlQuery.d.ts +13 -0
  650. package/node_modules/@sentry/core/build/types-ts3.8/utils/url.d.ts +4 -1
  651. package/node_modules/@sentry/core/package.json +3 -2
  652. package/node_modules/@sentry/node/build/cjs/integrations/tracing/vercelai/instrumentation.js +3 -0
  653. package/node_modules/@sentry/node/build/esm/integrations/tracing/vercelai/instrumentation.js +3 -0
  654. package/node_modules/@sentry/node/build/esm/package.json +1 -1
  655. package/node_modules/@sentry/node/package.json +7 -6
  656. package/node_modules/@sentry/node-core/build/cjs/integrations/anr/index.js +1 -1
  657. package/node_modules/@sentry/node-core/build/cjs/integrations/http/httpServerSpansIntegration.js +6 -3
  658. package/node_modules/@sentry/node-core/build/cjs/integrations/local-variables/local-variables-async.js +1 -1
  659. package/node_modules/@sentry/node-core/build/cjs/integrations/node-fetch/undici-instrumentation.js +2 -2
  660. package/node_modules/@sentry/node-core/build/cjs/light/client.js +7 -0
  661. package/node_modules/@sentry/node-core/build/cjs/sdk/client.js +7 -0
  662. package/node_modules/@sentry/node-core/build/cjs/utils/outgoingFetchRequest.js +1 -1
  663. package/node_modules/@sentry/node-core/build/esm/integrations/anr/index.js +1 -1
  664. package/node_modules/@sentry/node-core/build/esm/integrations/anr/worker-script.js +2 -2
  665. package/node_modules/@sentry/node-core/build/esm/integrations/http/httpServerSpansIntegration.js +7 -4
  666. package/node_modules/@sentry/node-core/build/esm/integrations/local-variables/local-variables-async.js +1 -1
  667. package/node_modules/@sentry/node-core/build/esm/integrations/local-variables/worker-script.js +1 -1
  668. package/node_modules/@sentry/node-core/build/esm/integrations/node-fetch/undici-instrumentation.js +3 -3
  669. package/node_modules/@sentry/node-core/build/esm/light/client.js +8 -1
  670. package/node_modules/@sentry/node-core/build/esm/package.json +1 -1
  671. package/node_modules/@sentry/node-core/build/esm/sdk/client.js +8 -1
  672. package/node_modules/@sentry/node-core/build/esm/utils/outgoingFetchRequest.js +2 -2
  673. package/node_modules/@sentry/node-core/build/types/light/client.d.ts +1 -0
  674. package/node_modules/@sentry/node-core/build/types/sdk/client.d.ts +1 -0
  675. package/node_modules/@sentry/node-core/build/types-ts3.8/light/client.d.ts +1 -0
  676. package/node_modules/@sentry/node-core/build/types-ts3.8/sdk/client.d.ts +1 -0
  677. package/node_modules/@sentry/node-core/package.json +5 -4
  678. package/node_modules/@sentry/opentelemetry/build/cjs/{asyncContextStrategy-BJ5buq_A.js → asyncContextStrategy-BR-l9zjD.js} +8 -6
  679. package/node_modules/@sentry/opentelemetry/build/cjs/index.browser.js +1 -1
  680. package/node_modules/@sentry/opentelemetry/build/cjs/index.js +1 -1
  681. package/node_modules/@sentry/opentelemetry/build/esm/{asyncContextStrategy-Bx5F5tCX.js → asyncContextStrategy-BQfM_LMv.js} +9 -7
  682. package/node_modules/@sentry/opentelemetry/build/esm/index.browser.js +1 -1
  683. package/node_modules/@sentry/opentelemetry/build/esm/index.js +2 -2
  684. package/node_modules/@sentry/opentelemetry/build/esm/package.json +1 -1
  685. package/node_modules/@sentry/opentelemetry/package.json +4 -3
  686. package/node_modules/@sentry/server-utils/build/cjs/tracing-channel.js +1 -0
  687. package/node_modules/@sentry/server-utils/build/esm/package.json +1 -1
  688. package/node_modules/@sentry/server-utils/build/esm/tracing-channel.js +1 -0
  689. package/node_modules/@sentry/server-utils/build/types/tracing-channel.d.ts +3 -1
  690. package/node_modules/@sentry/server-utils/build/types-ts3.8/tracing-channel.d.ts +3 -1
  691. package/node_modules/@sentry/server-utils/package.json +4 -3
  692. package/node_modules/cjs-module-lexer/README.md +8 -3
  693. package/node_modules/cjs-module-lexer/dist/lexer.js +1 -1
  694. package/node_modules/cjs-module-lexer/dist/lexer.mjs +2 -2
  695. package/node_modules/cjs-module-lexer/lexer.js +48 -9
  696. package/node_modules/cjs-module-lexer/package.json +3 -2
  697. package/node_modules/es-module-lexer/dist/lexer.asm.js +2 -2
  698. package/node_modules/es-module-lexer/dist/lexer.cjs +1 -1
  699. package/node_modules/es-module-lexer/dist/lexer.js +2 -2
  700. package/node_modules/es-module-lexer/dist/lexer.minimal.asm.js +2 -2
  701. package/node_modules/es-module-lexer/dist/lexer.minimal.cjs +1 -1
  702. package/node_modules/es-module-lexer/dist/lexer.minimal.js +2 -2
  703. package/node_modules/es-module-lexer/package.json +1 -1
  704. package/node_modules/import-in-the-middle/CHANGELOG.md +7 -0
  705. package/node_modules/import-in-the-middle/lib/get-esm-exports.mjs +7 -0
  706. package/node_modules/import-in-the-middle/package.json +1 -1
  707. package/package.json +2 -2
  708. package/packages/pm-beads/extensions/beads/runtime.ts +2 -2
  709. package/packages/pm-beads/package.json +1 -1
  710. package/packages/pm-calendar/package.json +1 -1
  711. package/packages/pm-command-kit/package.json +1 -1
  712. package/packages/pm-digital-twin/package.json +1 -1
  713. package/packages/pm-governance-audit/package.json +1 -1
  714. package/packages/pm-guide-shell/package.json +1 -1
  715. package/packages/pm-kanban/package.json +1 -1
  716. package/packages/pm-lifecycle-hooks/package.json +1 -1
  717. package/packages/pm-linked-test-adapters/package.json +1 -1
  718. package/packages/pm-search-advanced/package.json +1 -1
  719. package/packages/pm-templates/package.json +1 -1
  720. package/packages/pm-todos/package.json +1 -1
  721. package/packages/pm-vcs/package.json +1 -1
  722. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  723. package/plugins/pm-claude/package.json +1 -1
  724. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  725. package/plugins/pm-codex/package.json +1 -1
  726. package/plugins/pm-codex/plugin.json +1 -1
  727. package/runtime-dependencies.json +1 -1
  728. package/scripts/finalize-build.mjs +37 -0
  729. package/dist/cli-bundle/chunks/chunk-BXSXT5Z6.js +0 -2
  730. package/dist/cli-bundle/chunks/chunk-KNW3RSLS.js +0 -30
  731. package/dist/cli-bundle/chunks/chunk-MEWBSWE3.js +0 -2
  732. package/dist/cli-bundle/chunks/chunk-RBPOO46D.js +0 -20
  733. package/dist/cli-bundle/chunks/chunk-YMLF6QT7.js +0 -234
  734. package/dist/cli-bundle/chunks/register-operations-PDOBQZUJ.js +0 -2
  735. package/dist/cli-bundle/focused-chunks/chunk-2CJWTLQG.js +0 -2
  736. package/dist/cli-bundle/focused-chunks/chunk-B3YW6H2I.js +0 -26
  737. package/dist/cli-bundle/focused-chunks/chunk-GVGFUD52.js +0 -8
  738. package/dist/cli-bundle/focused-chunks/chunk-MJQ253F3.js +0 -2
  739. package/dist/cli-bundle/focused-chunks/chunk-PBCYGO7X.js +0 -3
  740. package/dist/cli-bundle/focused-chunks/chunk-WOEZJUA2.js +0 -2
@@ -4,54 +4,54 @@ import { type MergeDriverConfigurationAuditResult, type MergeFenceAuditResult }
4
4
  export type WorkspacePositionState = "ready" | "merge_evidence_invalid" | "history_evidence_invalid" | "merge_reconciliation_required" | "history_repair_required" | "merge_fence_unprepared";
5
5
  /** One deterministic recovery action selected from aggregate workspace evidence. */
6
6
  export interface WorkspacePositionNextAction {
7
- /** Executable pm command, or null when the workspace is ready. */
8
- command: string | null;
9
- /** Stable reason code explaining why this action takes precedence. */
10
- reason: WorkspacePositionState;
7
+ /** Executable pm command, or null when the workspace is ready. */
8
+ command: string | null;
9
+ /** Stable reason code explaining why this action takes precedence. */
10
+ reason: WorkspacePositionState;
11
11
  }
12
12
  /** Bounded SDK result shared by CLI, MCP, and package consumers. */
13
13
  export interface WorkspacePositionResult {
14
- /** Whether all readiness evidence is clean. */
15
- ok: boolean;
16
- /** Highest-priority workspace readiness classification. */
17
- state: WorkspacePositionState;
18
- /** Committed merge-fence and clone-local driver evidence. */
19
- merge_fence: {
20
- committed: MergeFenceAuditResult;
21
- clone_local_drivers: MergeDriverConfigurationAuditResult | null;
22
- };
23
- /** Bounded pending receipt evidence without private merge values. */
24
- merge_receipts: {
25
- pending_decision_count: number;
26
- pending_item_ids: string[];
27
- pending_item_ids_truncated: boolean;
28
- lossless_count: number;
29
- invalid_evidence_count: number;
30
- };
31
- /** Bounded append-only history drift evidence. */
32
- history_drift: {
33
- /** Whether the required history-drift evidence has its expected shape. */
34
- evidence_valid: boolean;
35
- drifted_item_count: number;
36
- drifted_item_ids: string[];
37
- drifted_item_ids_truncated: boolean;
38
- counts: Record<string, unknown>;
39
- };
40
- /** One deterministic next action, avoiding multi-command guesswork. */
41
- next_action: WorkspacePositionNextAction;
42
- /** Non-fatal read warnings retained from the authoritative item scan. */
43
- warnings: string[];
44
- /** ISO timestamp for this aggregate read. */
45
- generated_at: string;
14
+ /** Whether all readiness evidence is clean. */
15
+ ok: boolean;
16
+ /** Highest-priority workspace readiness classification. */
17
+ state: WorkspacePositionState;
18
+ /** Committed merge-fence and clone-local driver evidence. */
19
+ merge_fence: {
20
+ committed: MergeFenceAuditResult;
21
+ clone_local_drivers: MergeDriverConfigurationAuditResult | null;
22
+ };
23
+ /** Bounded pending receipt evidence without private merge values. */
24
+ merge_receipts: {
25
+ pending_decision_count: number;
26
+ pending_item_ids: string[];
27
+ pending_item_ids_truncated: boolean;
28
+ lossless_count: number;
29
+ invalid_evidence_count: number;
30
+ };
31
+ /** Bounded append-only history drift evidence. */
32
+ history_drift: {
33
+ /** Whether the required history-drift evidence has its expected shape. */
34
+ evidence_valid: boolean;
35
+ drifted_item_count: number;
36
+ drifted_item_ids: string[];
37
+ drifted_item_ids_truncated: boolean;
38
+ counts: Record<string, unknown>;
39
+ };
40
+ /** One deterministic next action, avoiding multi-command guesswork. */
41
+ next_action: WorkspacePositionNextAction;
42
+ /** Non-fatal read warnings retained from the authoritative item scan. */
43
+ warnings: string[];
44
+ /** ISO timestamp for this aggregate read. */
45
+ generated_at: string;
46
46
  }
47
47
  declare function selectWorkspacePositionState(params: {
48
- invalidEvidenceCount: number;
49
- pendingDecisionCount: number;
50
- losslessCount: number;
51
- historyEvidenceValid: boolean;
52
- driftedItemCount: number;
53
- fence: MergeFenceAuditResult;
54
- drivers: MergeDriverConfigurationAuditResult | null;
48
+ invalidEvidenceCount: number;
49
+ pendingDecisionCount: number;
50
+ losslessCount: number;
51
+ historyEvidenceValid: boolean;
52
+ driftedItemCount: number;
53
+ fence: MergeFenceAuditResult;
54
+ drivers: MergeDriverConfigurationAuditResult | null;
55
55
  }): WorkspacePositionState;
56
56
  declare function commandForWorkspacePositionState(state: WorkspacePositionState, pmRoot: string, platform?: NodeJS.Platform): string | null;
57
57
  /** Normalize defensive history-check evidence into the bounded position shape. */
@@ -62,8 +62,8 @@ export declare function readWorkspacePosition(global: GlobalOptions): Promise<Wo
62
62
  export declare function formatWorkspacePositionHuman(result: WorkspacePositionResult): string;
63
63
  /** Public contract for focused unit verification. */
64
64
  export declare const _testOnlyWorkspacePosition: {
65
- commandForWorkspacePositionState: typeof commandForWorkspacePositionState;
66
- normalizeWorkspaceHistoryDrift: typeof normalizeWorkspaceHistoryDrift;
67
- selectWorkspacePositionState: typeof selectWorkspacePositionState;
65
+ commandForWorkspacePositionState: typeof commandForWorkspacePositionState;
66
+ normalizeWorkspaceHistoryDrift: typeof normalizeWorkspaceHistoryDrift;
67
+ selectWorkspacePositionState: typeof selectWorkspacePositionState;
68
68
  };
69
69
  export {};
@@ -3,75 +3,75 @@ import { RelationshipGraph, RelationshipKindRegistry, type RelationshipEdge, typ
3
3
  export declare const RELATIONSHIP_GRAPH_SNAPSHOT_VERSION = 1;
4
4
  /** Immutable, content-addressed graph state exchanged with an adapter. */
5
5
  export interface RelationshipGraphSnapshot {
6
- /** Snapshot format version. */
7
- version: number;
8
- /** SHA-256 digest of nodes, edges, and relationship semantics. */
9
- fingerprint: string;
10
- /** ISO timestamp describing when this portable projection was created. */
11
- created_at: string;
12
- /** Deterministically ordered node identifiers. */
13
- nodes: readonly string[];
14
- /** Deterministically ordered normalized relationship edges. */
15
- edges: readonly RelationshipEdge[];
16
- /** Complete relationship ontology required to interpret the edges. */
17
- kinds: readonly RelationshipKindDefinition[];
6
+ /** Snapshot format version. */
7
+ version: number;
8
+ /** SHA-256 digest of nodes, edges, and relationship semantics. */
9
+ fingerprint: string;
10
+ /** ISO timestamp describing when this portable projection was created. */
11
+ created_at: string;
12
+ /** Deterministically ordered node identifiers. */
13
+ nodes: readonly string[];
14
+ /** Deterministically ordered normalized relationship edges. */
15
+ edges: readonly RelationshipEdge[];
16
+ /** Complete relationship ontology required to interpret the edges. */
17
+ kinds: readonly RelationshipKindDefinition[];
18
18
  }
19
19
  /** Common adapter operation context. */
20
20
  export interface RelationshipGraphAdapterContext {
21
- /** Adapter-owned workspace key; it need not be a filesystem path. */
22
- workspace: string;
23
- /** Cooperative cancellation signal. */
24
- signal?: AbortSignal;
21
+ /** Adapter-owned workspace key; it need not be a filesystem path. */
22
+ workspace: string;
23
+ /** Cooperative cancellation signal. */
24
+ signal?: AbortSignal;
25
25
  }
26
26
  /** Compare-and-swap replacement context for one complete snapshot. */
27
27
  export interface RelationshipGraphAdapterReplaceContext extends RelationshipGraphAdapterContext {
28
- /** Validated snapshot that becomes the complete visible graph state. */
29
- snapshot: RelationshipGraphSnapshot;
30
- /** Expected prior fingerprint; null requires an empty workspace. */
31
- expected_fingerprint?: string | null;
28
+ /** Validated snapshot that becomes the complete visible graph state. */
29
+ snapshot: RelationshipGraphSnapshot;
30
+ /** Expected prior fingerprint; null requires an empty workspace. */
31
+ expected_fingerprint?: string | null;
32
32
  }
33
33
  /** Storage-neutral graph snapshot adapter implemented by SDK packages. */
34
34
  export interface RelationshipGraphAdapter {
35
- /** Stable adapter identifier used in diagnostics. */
36
- readonly name: string;
37
- /** Read the current portable snapshot, or null when absent. */
38
- read(context: RelationshipGraphAdapterContext): Promise<unknown | null>;
39
- /** Atomically replace the complete snapshot with optional CAS protection. */
40
- replace(context: RelationshipGraphAdapterReplaceContext): Promise<void>;
41
- /** Optionally clear a workspace with the same CAS semantics. */
42
- clear?(context: RelationshipGraphAdapterContext & {
43
- expected_fingerprint?: string | null;
44
- }): Promise<void>;
35
+ /** Stable adapter identifier used in diagnostics. */
36
+ readonly name: string;
37
+ /** Read the current portable snapshot, or null when absent. */
38
+ read(context: RelationshipGraphAdapterContext): Promise<unknown | null>;
39
+ /** Atomically replace the complete snapshot with optional CAS protection. */
40
+ replace(context: RelationshipGraphAdapterReplaceContext): Promise<void>;
41
+ /** Optionally clear a workspace with the same CAS semantics. */
42
+ clear?(context: RelationshipGraphAdapterContext & {
43
+ expected_fingerprint?: string | null;
44
+ }): Promise<void>;
45
45
  }
46
46
  /** Validated snapshot paired with executable registry and graph views. */
47
47
  export interface LoadedRelationshipGraphSnapshot {
48
- /** Portable immutable snapshot. */
49
- snapshot: RelationshipGraphSnapshot;
50
- /** Registry reconstructed from the snapshot ontology. */
51
- registry: RelationshipKindRegistry;
52
- /** Executable graph reconstructed through the public kernel. */
53
- graph: RelationshipGraph;
48
+ /** Portable immutable snapshot. */
49
+ snapshot: RelationshipGraphSnapshot;
50
+ /** Registry reconstructed from the snapshot ontology. */
51
+ registry: RelationshipKindRegistry;
52
+ /** Executable graph reconstructed through the public kernel. */
53
+ graph: RelationshipGraph;
54
54
  }
55
55
  /** Result of synchronizing one snapshot into an adapter. */
56
56
  export interface RelationshipGraphAdapterSyncResult {
57
- /** Adapter identifier. */
58
- adapter: string;
59
- /** Adapter-owned workspace key. */
60
- workspace: string;
61
- /** Whether a write was required. */
62
- disposition: "current" | "written";
63
- /** New canonical snapshot fingerprint. */
64
- fingerprint: string;
65
- /** Prior fingerprint when a snapshot existed. */
66
- previous_fingerprint?: string;
67
- /** Portable node count. */
68
- node_count: number;
69
- /** Portable edge count. */
70
- edge_count: number;
57
+ /** Adapter identifier. */
58
+ adapter: string;
59
+ /** Adapter-owned workspace key. */
60
+ workspace: string;
61
+ /** Whether a write was required. */
62
+ disposition: "current" | "written";
63
+ /** New canonical snapshot fingerprint. */
64
+ fingerprint: string;
65
+ /** Prior fingerprint when a snapshot existed. */
66
+ previous_fingerprint?: string;
67
+ /** Portable node count. */
68
+ node_count: number;
69
+ /** Portable edge count. */
70
+ edge_count: number;
71
71
  }
72
72
  /** Build an immutable portable snapshot from a validated graph and registry. */
73
73
  export declare function createRelationshipGraphSnapshot(graph: RelationshipGraph, registry: RelationshipKindRegistry, options?: {
74
- createdAt?: string;
74
+ createdAt?: string;
75
75
  }): RelationshipGraphSnapshot;
76
76
  /** Decode and fully validate a portable graph snapshot. */
77
77
  export declare function parseRelationshipGraphSnapshot(value: unknown): LoadedRelationshipGraphSnapshot;
@@ -82,25 +82,25 @@ export declare function loadRelationshipGraphAdapter(adapter: RelationshipGraphA
82
82
  * verify the adapter's visible read after replacement.
83
83
  */
84
84
  export declare function syncRelationshipGraphAdapter(adapter: RelationshipGraphAdapter, context: RelationshipGraphAdapterContext & {
85
- snapshot: RelationshipGraphSnapshot;
85
+ snapshot: RelationshipGraphSnapshot;
86
86
  }): Promise<RelationshipGraphAdapterSyncResult>;
87
87
  /** Merge portable snapshots while rejecting semantic kind collisions. */
88
88
  export declare function federateRelationshipGraphSnapshots(values: readonly unknown[], options?: {
89
- createdAt?: string;
89
+ createdAt?: string;
90
90
  }): RelationshipGraphSnapshot;
91
91
  /** In-memory reference adapter with atomic CAS behavior for tests and packages. */
92
92
  export declare class MemoryRelationshipGraphAdapter implements RelationshipGraphAdapter {
93
- #private;
94
- /** Stable adapter identifier used in diagnostics and conformance reports. */
95
- readonly name: string;
96
- /** Create a reference adapter with a stable diagnostic name. */
97
- constructor(name?: string);
98
- /** Read an isolated clone of the current workspace snapshot. */
99
- read(context: RelationshipGraphAdapterContext): Promise<RelationshipGraphSnapshot | null>;
100
- /** Atomically replace one workspace after enforcing its expected fingerprint. */
101
- replace(context: RelationshipGraphAdapterReplaceContext): Promise<void>;
102
- /** Clear one workspace after enforcing its expected fingerprint. */
103
- clear(context: RelationshipGraphAdapterContext & {
104
- expected_fingerprint?: string | null;
105
- }): Promise<void>;
93
+ #private;
94
+ /** Stable adapter identifier used in diagnostics and conformance reports. */
95
+ readonly name: string;
96
+ /** Create a reference adapter with a stable diagnostic name. */
97
+ constructor(name?: string);
98
+ /** Read an isolated clone of the current workspace snapshot. */
99
+ read(context: RelationshipGraphAdapterContext): Promise<RelationshipGraphSnapshot | null>;
100
+ /** Atomically replace one workspace after enforcing its expected fingerprint. */
101
+ replace(context: RelationshipGraphAdapterReplaceContext): Promise<void>;
102
+ /** Clear one workspace after enforcing its expected fingerprint. */
103
+ clear(context: RelationshipGraphAdapterContext & {
104
+ expected_fingerprint?: string | null;
105
+ }): Promise<void>;
106
106
  }
@@ -12,79 +12,79 @@
12
12
  import { RelationshipGraph, type RelationshipEdge, type RelationshipKindDefinition, type RelationshipQueryResult, type RelationshipTraversalDirection } from "../relationships.js";
13
13
  /** One detected relationship community. */
14
14
  export interface RelationshipCommunity {
15
- /** Lexicographically smallest member id, naming the community. */
16
- representative: string;
17
- /** Total member count. */
18
- size: number;
19
- /** Sorted member node ids. */
20
- members: string[];
15
+ /** Lexicographically smallest member id, naming the community. */
16
+ representative: string;
17
+ /** Total member count. */
18
+ size: number;
19
+ /** Sorted member node ids. */
20
+ members: string[];
21
21
  }
22
22
  /** Bounded community-detection controls. */
23
23
  export interface GraphCommunityOptions {
24
- /** Registered relationship kinds whose edges define adjacency. */
25
- kinds?: readonly string[];
26
- /** Maximum label-propagation sweeps before reporting non-convergence; defaults to 16. */
27
- maxIterations?: number;
28
- /** Minimum member count for a reported community; defaults to 2. */
29
- minSize?: number;
30
- /** Abort signal checked once per sweep. */
31
- signal?: AbortSignal;
24
+ /** Registered relationship kinds whose edges define adjacency. */
25
+ kinds?: readonly string[];
26
+ /** Maximum label-propagation sweeps before reporting non-convergence; defaults to 16. */
27
+ maxIterations?: number;
28
+ /** Minimum member count for a reported community; defaults to 2. */
29
+ minSize?: number;
30
+ /** Abort signal checked once per sweep. */
31
+ signal?: AbortSignal;
32
32
  }
33
33
  /** Deterministic label-propagation community analysis. */
34
34
  export interface RelationshipCommunityAnalysis {
35
- /** Detected communities, largest first and by representative within equal size. */
36
- communities: RelationshipCommunity[];
37
- /** Label-propagation sweeps executed. */
38
- iterations: number;
39
- /** Whether labels stabilized before the iteration bound stopped the sweep. */
40
- converged: boolean;
35
+ /** Detected communities, largest first and by representative within equal size. */
36
+ communities: RelationshipCommunity[];
37
+ /** Label-propagation sweeps executed. */
38
+ iterations: number;
39
+ /** Whether labels stabilized before the iteration bound stopped the sweep. */
40
+ converged: boolean;
41
41
  }
42
42
  /** One stored edge implied by a longer same-family witness path. */
43
43
  export interface RedundantRelationshipEdge {
44
- /** The stored redundant edge in its original spelling. */
45
- edge: RelationshipEdge;
46
- /** Semantic-orientation witness node path proving the implication, endpoints inclusive. */
47
- witness: string[];
44
+ /** The stored redundant edge in its original spelling. */
45
+ edge: RelationshipEdge;
46
+ /** Semantic-orientation witness node path proving the implication, endpoints inclusive. */
47
+ witness: string[];
48
48
  }
49
49
  /** Bounded redundancy-scan controls. */
50
50
  export interface GraphRedundancyOptions {
51
- /** Directed ordering or hierarchy kinds to scan; defaults to every eligible registered kind. */
52
- kinds?: readonly string[];
53
- /** Maximum witness-path depth searched per edge; defaults to 8. */
54
- maxDepth?: number;
55
- /** Maximum reported redundant edges. */
56
- limit?: number;
57
- /** Abort signal checked once per scanned edge. */
58
- signal?: AbortSignal;
51
+ /** Directed ordering or hierarchy kinds to scan; defaults to every eligible registered kind. */
52
+ kinds?: readonly string[];
53
+ /** Maximum witness-path depth searched per edge; defaults to 8. */
54
+ maxDepth?: number;
55
+ /** Maximum reported redundant edges. */
56
+ limit?: number;
57
+ /** Abort signal checked once per scanned edge. */
58
+ signal?: AbortSignal;
59
59
  }
60
60
  /** One reachable node with its immediate dominator and gating weight. */
61
61
  export interface RelationshipDominatorRow {
62
- /** Reachable node id. */
63
- id: string;
64
- /** Immediate dominator appearing on every root-to-node path. */
65
- idom: string;
66
- /** Nodes strictly dominated by this node — its dominator-subtree size minus itself. */
67
- dominatedCount: number;
62
+ /** Reachable node id. */
63
+ id: string;
64
+ /** Immediate dominator appearing on every root-to-node path. */
65
+ idom: string;
66
+ /** Nodes strictly dominated by this node — its dominator-subtree size minus itself. */
67
+ dominatedCount: number;
68
68
  }
69
69
  /** Bounded dominator-analysis controls. */
70
70
  export interface GraphDominatorOptions {
71
- /** Registered relationship kinds whose edges define reachability. */
72
- kinds?: readonly string[];
73
- /** Traversal direction relative to each visited node; defaults to "outgoing". */
74
- direction?: RelationshipTraversalDirection;
75
- /** Maximum reachability depth from the root as a non-negative integer. */
76
- maxDepth?: number;
77
- /** Abort signal checked once per processed node. */
78
- signal?: AbortSignal;
71
+ /** Registered relationship kinds whose edges define reachability. */
72
+ kinds?: readonly string[];
73
+ /** Traversal direction relative to each visited node; defaults to "outgoing". */
74
+ direction?: RelationshipTraversalDirection;
75
+ /** Maximum reachability depth from the root as a non-negative integer. */
76
+ maxDepth?: number;
77
+ /** Abort signal checked once per processed node. */
78
+ signal?: AbortSignal;
79
79
  }
80
80
  /** Dominator-tree analysis of one node's reachable subgraph. */
81
81
  export interface RelationshipDominatorAnalysis {
82
- /** Analyzed root id. */
83
- root: string;
84
- /** Reachable node count including the root. */
85
- reachableCount: number;
86
- /** Non-root reachable rows sorted by gating weight, then id. */
87
- rows: RelationshipDominatorRow[];
82
+ /** Analyzed root id. */
83
+ root: string;
84
+ /** Reachable node count including the root. */
85
+ reachableCount: number;
86
+ /** Non-root reachable rows sorted by gating weight, then id. */
87
+ rows: RelationshipDominatorRow[];
88
88
  }
89
89
  /**
90
90
  * Invoke `visit` once per canonical-kind-matched edge, skipping self-loops.
@@ -110,8 +110,8 @@ export declare function isTransitiveKind(definition: RelationshipKindDefinition)
110
110
  export declare function transitiveFamilyKey(definition: RelationshipKindDefinition): string;
111
111
  /** Orient one transitive edge into its semantic forward direction. */
112
112
  export declare function orientTransitiveEdge(edge: RelationshipEdge, definition: RelationshipKindDefinition): {
113
- from: string;
114
- to: string;
113
+ from: string;
114
+ to: string;
115
115
  };
116
116
  /**
117
117
  * Find stored edges implied by a longer path of the same semantic family —
@@ -15,44 +15,44 @@ import { type HierarchyIntegrityAnalysis } from "./hierarchy-integrity.js";
15
15
  export { resolveWorkspaceRelationshipKindRegistry } from "./workspace-relationship-kind-registry.js";
16
16
  /** Minimal item shape inspected by dependency-reference governance. */
17
17
  export interface DependencyReferenceHolder {
18
- /** Stable item identifier. */
19
- id: string;
20
- /** Lifecycle status used to separate actionable work from historical debt. */
21
- status: ItemStatus;
22
- /** Optional hierarchy parent reference. */
23
- parent?: string;
24
- /** Optional legacy scalar blocker reference. */
25
- blocked_by?: string;
26
- /** Structured dependency edges. */
27
- dependencies?: Dependency[];
18
+ /** Stable item identifier. */
19
+ id: string;
20
+ /** Lifecycle status used to separate actionable work from historical debt. */
21
+ status: ItemStatus;
22
+ /** Optional hierarchy parent reference. */
23
+ parent?: string;
24
+ /** Optional legacy scalar blocker reference. */
25
+ blocked_by?: string;
26
+ /** Structured dependency edges. */
27
+ dependencies?: Dependency[];
28
28
  }
29
29
  /** Storage surface that contributed a normalized dependency reference. */
30
30
  export type DependencyReferenceSource = "parent" | "blocked_by" | "dependency";
31
31
  /** One normalized dependency reference whose target is absent from the tracker. */
32
32
  export interface DanglingDependencyReference {
33
- /** Item that owns the reference. */
34
- holder_id: string;
35
- /** Missing referenced item id or legacy sentinel. */
36
- target_id: string;
37
- /** Relationship field or dependency kind. */
38
- kind: string;
39
- /** Storage surface that owns the reference and determines its remediation. */
40
- source: DependencyReferenceSource;
41
- /** Current lifecycle status of the holder. */
42
- holder_status: ItemStatus;
43
- /** Whether the holder is terminal and therefore historical, non-actionable debt. */
44
- legacy_terminal: boolean;
45
- /** Whether the target is the pre-structured-dependency `no-active-blocker` sentinel. */
46
- no_active_blocker_sentinel: boolean;
33
+ /** Item that owns the reference. */
34
+ holder_id: string;
35
+ /** Missing referenced item id or legacy sentinel. */
36
+ target_id: string;
37
+ /** Relationship field or dependency kind. */
38
+ kind: string;
39
+ /** Storage surface that owns the reference and determines its remediation. */
40
+ source: DependencyReferenceSource;
41
+ /** Current lifecycle status of the holder. */
42
+ holder_status: ItemStatus;
43
+ /** Whether the holder is terminal and therefore historical, non-actionable debt. */
44
+ legacy_terminal: boolean;
45
+ /** Whether the target is the pre-structured-dependency `no-active-blocker` sentinel. */
46
+ no_active_blocker_sentinel: boolean;
47
47
  }
48
48
  /** Actionable and historical partitions returned by dependency-reference governance. */
49
49
  export interface DanglingDependencyReferenceSummary {
50
- /** Missing references held by active items; these may affect scheduling and should gate validation. */
51
- active: DanglingDependencyReference[];
52
- /** Missing references held only by terminal items; retained as informational history debt. */
53
- legacy_terminal: DanglingDependencyReference[];
54
- /** Legacy sentinel rows across active and terminal holders, called out separately from typo-like ids. */
55
- no_active_blocker_sentinels: DanglingDependencyReference[];
50
+ /** Missing references held by active items; these may affect scheduling and should gate validation. */
51
+ active: DanglingDependencyReference[];
52
+ /** Missing references held only by terminal items; retained as informational history debt. */
53
+ legacy_terminal: DanglingDependencyReference[];
54
+ /** Legacy sentinel rows across active and terminal holders, called out separately from typo-like ids. */
55
+ no_active_blocker_sentinels: DanglingDependencyReference[];
56
56
  }
57
57
  /** Normalize a graph target while removing the historical no-blocker marker. */
58
58
  export declare function normalizeDependencyGraphTarget(target: unknown): string | undefined;
@@ -65,31 +65,31 @@ export declare function normalizeDependencyGraphTarget(target: unknown): string
65
65
  */
66
66
  /** One raw stored dependency row duplicated verbatim on a single holder. */
67
67
  export interface DuplicateDependencyRow {
68
- /** Item that stores the duplicated row. */
69
- holder_id: string;
70
- /** Referenced target id in its first stored spelling. */
71
- target_id: string;
72
- /** Stored relationship kind shared by every duplicate occurrence. */
73
- kind: string;
74
- /** Total stored occurrences of the identical row (always >= 2). */
75
- occurrences: number;
76
- /** Current lifecycle status of the holder. */
77
- holder_status: ItemStatus;
78
- /** Whether the holder is terminal and the duplication is historical debt. */
79
- legacy_terminal: boolean;
68
+ /** Item that stores the duplicated row. */
69
+ holder_id: string;
70
+ /** Referenced target id in its first stored spelling. */
71
+ target_id: string;
72
+ /** Stored relationship kind shared by every duplicate occurrence. */
73
+ kind: string;
74
+ /** Total stored occurrences of the identical row (always >= 2). */
75
+ occurrences: number;
76
+ /** Current lifecycle status of the holder. */
77
+ holder_status: ItemStatus;
78
+ /** Whether the holder is terminal and the duplication is historical debt. */
79
+ legacy_terminal: boolean;
80
80
  }
81
81
  /** One holder whose scalar blocker and structured ordering row assert opposite precedence. */
82
82
  export interface OrderingStorageContradiction {
83
- /** Item storing both contradictory representations. */
84
- holder_id: string;
85
- /** Target named by both the scalar blocker and structured dependency row. */
86
- target_id: string;
87
- /** Structured ordering kind that places the holder before the target. */
88
- dependency_kind: string;
89
- /** Current lifecycle status of the holder. */
90
- holder_status: ItemStatus;
91
- /** Whether the holder is terminal and the contradiction is historical debt. */
92
- legacy_terminal: boolean;
83
+ /** Item storing both contradictory representations. */
84
+ holder_id: string;
85
+ /** Target named by both the scalar blocker and structured dependency row. */
86
+ target_id: string;
87
+ /** Structured ordering kind that places the holder before the target. */
88
+ dependency_kind: string;
89
+ /** Current lifecycle status of the holder. */
90
+ holder_status: ItemStatus;
91
+ /** Whether the holder is terminal and the contradiction is historical debt. */
92
+ legacy_terminal: boolean;
93
93
  }
94
94
  /**
95
95
  * Collect raw stored dependency rows whose exact identity — holder, kind, and
@@ -121,40 +121,40 @@ export declare function collectMissingDependencyTargetIds(dangling: DanglingDepe
121
121
  export declare function collectExternalDependencyTargetIds(items: readonly DependencyReferenceHolder[]): string[];
122
122
  /** Item shape accepted by workspace relationship-graph assembly. */
123
123
  export interface WorkspaceRelationshipItem extends DependencyReferenceHolder {
124
- /** Human-readable title projected into per-node details. */
125
- title: string;
126
- /** Optional item type powering per-type coverage profiles and policies. */
127
- type?: string;
124
+ /** Human-readable title projected into per-node details. */
125
+ title: string;
126
+ /** Optional item type powering per-type coverage profiles and policies. */
127
+ type?: string;
128
128
  }
129
129
  /** Compact node projection paired with the assembled graph. */
130
130
  export interface WorkspaceRelationshipNodeDetails {
131
- /** Stable node identifier. */
132
- id: string;
133
- /** Human-readable node title, or a `[missing]` marker for absent endpoints. */
134
- title: string;
135
- /** Lifecycle status, or the `missing` marker status for absent endpoints. */
136
- status: string;
137
- /** Item type when the source item declared one; absent on missing placeholders. */
138
- type?: string;
131
+ /** Stable node identifier. */
132
+ id: string;
133
+ /** Human-readable node title, or a `[missing]` marker for absent endpoints. */
134
+ title: string;
135
+ /** Lifecycle status, or the `missing` marker status for absent endpoints. */
136
+ status: string;
137
+ /** Item type when the source item declared one; absent on missing placeholders. */
138
+ type?: string;
139
139
  }
140
140
  /** Assembled workspace relationship graph with governance side-products. */
141
141
  export interface WorkspaceRelationshipAssembly {
142
- /** Deterministic relationship graph including missing placeholder nodes. */
143
- graph: RelationshipGraph;
144
- /** Per-node compact details covering real and missing nodes. */
145
- details: WorkspaceRelationshipNodeDetails[];
146
- /** Lowercased identifiers of materialized missing endpoints. */
147
- missingIdSet: Set<string>;
148
- /** Dangling-reference classification computed during assembly. */
149
- dangling: DanglingDependencyReferenceSummary;
150
- /** Raw same-identity duplicated dependency rows found before graph dedup. */
151
- duplicateRows: DuplicateDependencyRow[];
152
- /** Scalar-versus-structured ordering contradictions found before graph normalization. */
153
- orderingContradictions?: OrderingStorageContradiction[];
154
- /** Raw legacy alias rows grouped by accepted spelling before graph canonicalization. */
155
- legacyAliasCounts: Record<string, number>;
156
- /** Shared hierarchy analysis retained across ordinary object spread copies. */
157
- hierarchyIntegrity?: HierarchyIntegrityAnalysis;
142
+ /** Deterministic relationship graph including missing placeholder nodes. */
143
+ graph: RelationshipGraph;
144
+ /** Per-node compact details covering real and missing nodes. */
145
+ details: WorkspaceRelationshipNodeDetails[];
146
+ /** Lowercased identifiers of materialized missing endpoints. */
147
+ missingIdSet: Set<string>;
148
+ /** Dangling-reference classification computed during assembly. */
149
+ dangling: DanglingDependencyReferenceSummary;
150
+ /** Raw same-identity duplicated dependency rows found before graph dedup. */
151
+ duplicateRows: DuplicateDependencyRow[];
152
+ /** Scalar-versus-structured ordering contradictions found before graph normalization. */
153
+ orderingContradictions?: OrderingStorageContradiction[];
154
+ /** Raw legacy alias rows grouped by accepted spelling before graph canonicalization. */
155
+ legacyAliasCounts: Record<string, number>;
156
+ /** Shared hierarchy analysis retained across ordinary object spread copies. */
157
+ hierarchyIntegrity?: HierarchyIntegrityAnalysis;
158
158
  }
159
159
  /** Read the hierarchy analysis paired with an assembly created by this module. */
160
160
  export declare function getWorkspaceHierarchyIntegrity(assembly: WorkspaceRelationshipAssembly): HierarchyIntegrityAnalysis | undefined;