@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
@@ -3,14 +3,14 @@ import { type RelationshipKindRegistry } from "../relationships.js";
3
3
  import type { WorkspaceRelationshipAssembly, WorkspaceRelationshipItem } from "./assembly.js";
4
4
  /** Cache observability attached to graph result envelopes. */
5
5
  export interface GraphCacheMetadata {
6
- /** Truncated workspace graph fingerprint identifying the snapshot answered from. */
7
- fingerprint: string;
8
- /** Whether the workspace assembly was reused from cache. */
9
- assembly: "hit" | "miss";
10
- /** Whether the full query result was reused from cache. */
11
- result: "hit" | "miss";
12
- /** Durable cross-process index disposition: answered from it, missed it, or persistence disabled for this workspace. Absent on surfaces that never consult the durable index. */
13
- durable?: "hit" | "miss" | "off";
6
+ /** Truncated workspace graph fingerprint identifying the snapshot answered from. */
7
+ fingerprint: string;
8
+ /** Whether the workspace assembly was reused from cache. */
9
+ assembly: "hit" | "miss";
10
+ /** Whether the full query result was reused from cache. */
11
+ result: "hit" | "miss";
12
+ /** Durable cross-process index disposition: answered from it, missed it, or persistence disabled for this workspace. Absent on surfaces that never consult the durable index. */
13
+ durable?: "hit" | "miss" | "off";
14
14
  }
15
15
  /**
16
16
  * Compute the deterministic workspace graph fingerprint for one item snapshot.
@@ -22,23 +22,23 @@ export interface GraphCacheMetadata {
22
22
  export declare function computeWorkspaceGraphFingerprint(items: readonly WorkspaceRelationshipItem[], isTerminal?: (status: ItemStatus) => boolean, registry?: RelationshipKindRegistry): string;
23
23
  /** One resolved cache lookup bound to a workspace snapshot. */
24
24
  export interface WorkspaceGraphCacheLookup {
25
- /** The (possibly reused) workspace assembly. */
26
- assembly: WorkspaceRelationshipAssembly;
27
- /** Whether the assembly came from cache instead of being rebuilt. */
28
- assemblyReused: boolean;
29
- /** Full fingerprint of the snapshot this lookup is bound to. */
30
- fingerprint: string;
31
- /**
25
+ /** The (possibly reused) workspace assembly. */
26
+ assembly: WorkspaceRelationshipAssembly;
27
+ /** Whether the assembly came from cache instead of being rebuilt. */
28
+ assemblyReused: boolean;
29
+ /** Full fingerprint of the snapshot this lookup is bound to. */
30
+ fingerprint: string;
31
+ /**
32
32
  * Memoize one deterministic query result under this snapshot. On a miss the
33
33
  * freshly computed value is returned as-is while an independent clone is
34
34
  * stored, so mutating a miss result never corrupts the cache; every hit
35
35
  * returns a fresh clone of the stored entry. Callers must not rely on the
36
36
  * miss and hit paths returning the same object identity.
37
37
  */
38
- memoize<T>(queryKey: string, compute: () => T): {
39
- value: T;
40
- reused: boolean;
41
- };
38
+ memoize<T>(queryKey: string, compute: () => T): {
39
+ value: T;
40
+ reused: boolean;
41
+ };
42
42
  }
43
43
  /**
44
44
  * Fingerprint-keyed cache of workspace relationship assemblies and memoized
@@ -48,20 +48,20 @@ export interface WorkspaceGraphCacheLookup {
48
48
  * neither the producer nor any consumer can mutate cached state.
49
49
  */
50
50
  export declare class WorkspaceGraphCache {
51
- #private;
52
- /** Create a cache, optionally bounding workspaces and memoized results. */
53
- constructor(options?: {
54
- maxResultsPerWorkspace?: number;
55
- maxWorkspaces?: number;
56
- });
57
- /**
51
+ #private;
52
+ /** Create a cache, optionally bounding workspaces and memoized results. */
53
+ constructor(options?: {
54
+ maxResultsPerWorkspace?: number;
55
+ maxWorkspaces?: number;
56
+ });
57
+ /**
58
58
  * Resolve the cached assembly for one workspace key and fingerprint,
59
59
  * building and storing it on miss. The returned lookup exposes snapshot-
60
60
  * scoped memoization for query results derived from the same assembly.
61
61
  */
62
- lookup(key: string, fingerprint: string, build: () => WorkspaceRelationshipAssembly): WorkspaceGraphCacheLookup;
63
- /** Drop every cached workspace entry and memoized result. */
64
- clear(): void;
62
+ lookup(key: string, fingerprint: string, build: () => WorkspaceRelationshipAssembly): WorkspaceGraphCacheLookup;
63
+ /** Drop every cached workspace entry and memoized result. */
64
+ clear(): void;
65
65
  }
66
66
  /** Return the process-wide shared workspace graph cache. */
67
67
  export declare function workspaceGraphCache(): WorkspaceGraphCache;
@@ -0,0 +1,13 @@
1
+ import type { Dependency } from "../../types/index.js";
2
+ import type { RelationshipKindRegistry } from "../relationships.js";
3
+ /** Minimal immutable item projection needed to compare relationship cardinality. */
4
+ export interface RelationshipCardinalityItem {
5
+ /** Canonical workspace item identity. */
6
+ id: string;
7
+ /** Stored relationship rows, including their canonical kind and endpoint. */
8
+ dependencies?: readonly Pick<Dependency, "id" | "kind">[];
9
+ }
10
+ /** Share the workspace integrity lock for every kind that constrains edge multiplicity. */
11
+ export declare function relationshipKindNeedsIntegrityLock(kind: string, registry: RelationshipKindRegistry): boolean;
12
+ /** Reject newly introduced non-hierarchy cardinality debt while allowing unchanged debt and repairs. */
13
+ export declare function assertNonHierarchyCardinalityMutationAllowed(before: readonly RelationshipCardinalityItem[], after: readonly RelationshipCardinalityItem[], registry?: RelationshipKindRegistry): void;
@@ -0,0 +1,2 @@
1
+ (function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5f2ca18e-450d-5b6e-9e07-7bbf080764f9")}catch{}})();import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{resolveWorkspaceRelationshipKindRegistry}from"./workspace-relationship-kind-registry.js";function relationshipKindNeedsIntegrityLock(kind,registry){const definition=registry.resolve(kind);return definition?.hierarchy===!0||definition?.outgoing==="one"||definition?.incoming==="one"}function addEndpoint(groups,kind,direction,node,endpoint){const key=JSON.stringify([kind,direction,node]);let group=groups.get(key);group===void 0&&(group={kind,direction,node_id:node,endpoints:new Set},groups.set(key,group)),group.endpoints.add(endpoint)}function cardinalityGroups(items,registry){const groups=new Map;for(const item of items)for(const dependency of item.dependencies??[]){const definition=registry.resolve(dependency.kind);definition===void 0||definition.hierarchy||(definition.outgoing==="one"&&addEndpoint(groups,definition.kind,"outgoing",item.id,dependency.id),definition.incoming==="one"&&addEndpoint(groups,definition.kind,"incoming",dependency.id,item.id))}return groups}function assertNonHierarchyCardinalityMutationAllowed(before,after,registry=resolveWorkspaceRelationshipKindRegistry()){const prior=cardinalityGroups(before,registry),prospective=cardinalityGroups(after,registry);for(const key of[...prospective.keys()].sort()){const group=prospective.get(key);if(group.endpoints.size<=1)continue;const old=prior.get(key);if(![...group.endpoints].every(endpoint=>old?.endpoints.has(endpoint)))throw new PmCliError(`Relationship ${group.kind} permits only one ${group.direction} endpoint for ${group.node_id}.`,EXIT_CODE.USAGE,{code:"dependency_cardinality_created",field:"dependencies",value:group.kind,relationship_cardinality:{kind:group.kind,direction:group.direction,node_id:group.node_id,endpoint_ids:[...group.endpoints].sort()},required:"The final dependency set must satisfy the active relationship kind's one-edge cardinality.",nextSteps:["Drop extra --dep seeds, or remove conflicting rows with update --dep-remove before adding another edge.","Choose another kind only when its declared semantics match the intended relationship."]})}}export{assertNonHierarchyCardinalityMutationAllowed,relationshipKindNeedsIntegrityLock};
2
+ //# sourceMappingURL=cardinality-integrity.js.map
@@ -14,55 +14,55 @@
14
14
  import { RelationshipGraph, type RelationshipQueryResult } from "../relationships.js";
15
15
  /** One node ranked by structural centrality with directed fan-in/fan-out. */
16
16
  export interface RelationshipCentralityRow {
17
- /** Node id. */
18
- id: string;
19
- /** Undirected unique-neighbor degree over selected kinds. */
20
- degree: number;
21
- /** Distinct ordering predecessors that gate this node (dependency fan-in). */
22
- inDegree: number;
23
- /** Distinct ordering successors this node gates (dependency fan-out). */
24
- outDegree: number;
25
- /** Shortest-path betweenness centrality, rounded to six decimals. */
26
- betweenness: number;
27
- /** Wasserman–Faust closeness centrality, rounded to six decimals. */
28
- closeness: number;
17
+ /** Node id. */
18
+ id: string;
19
+ /** Undirected unique-neighbor degree over selected kinds. */
20
+ degree: number;
21
+ /** Distinct ordering predecessors that gate this node (dependency fan-in). */
22
+ inDegree: number;
23
+ /** Distinct ordering successors this node gates (dependency fan-out). */
24
+ outDegree: number;
25
+ /** Shortest-path betweenness centrality, rounded to six decimals. */
26
+ betweenness: number;
27
+ /** Wasserman–Faust closeness centrality, rounded to six decimals. */
28
+ closeness: number;
29
29
  }
30
30
  /** Bounded centrality-analysis controls. */
31
31
  export interface GraphCentralityOptions {
32
- /** Registered relationship kinds whose edges define adjacency. */
33
- kinds?: readonly string[];
34
- /** Abort signal checked once per source sweep. */
35
- signal?: AbortSignal;
32
+ /** Registered relationship kinds whose edges define adjacency. */
33
+ kinds?: readonly string[];
34
+ /** Abort signal checked once per source sweep. */
35
+ signal?: AbortSignal;
36
36
  }
37
37
  /** Deterministic centrality ranking over the undirected knowledge graph. */
38
38
  export interface RelationshipCentralityAnalysis {
39
- /** Total indexed graph nodes. */
40
- nodeCount: number;
41
- /** Simple undirected edge count over selected kinds. */
42
- edgeCount: number;
43
- /** Node rows ranked by betweenness, then degree, then id. */
44
- rows: RelationshipCentralityRow[];
39
+ /** Total indexed graph nodes. */
40
+ nodeCount: number;
41
+ /** Simple undirected edge count over selected kinds. */
42
+ edgeCount: number;
43
+ /** Node rows ranked by betweenness, then degree, then id. */
44
+ rows: RelationshipCentralityRow[];
45
45
  }
46
46
  /** One undirected bridge edge whose removal disconnects its endpoints. */
47
47
  export interface RelationshipBridge {
48
- /** Lexicographically smaller endpoint. */
49
- source: string;
50
- /** Lexicographically larger endpoint. */
51
- target: string;
48
+ /** Lexicographically smaller endpoint. */
49
+ source: string;
50
+ /** Lexicographically larger endpoint. */
51
+ target: string;
52
52
  }
53
53
  /** Bounded cut-structure controls. */
54
54
  export interface GraphCutStructureOptions {
55
- /** Registered relationship kinds whose edges define adjacency. */
56
- kinds?: readonly string[];
57
- /** Abort signal checked once per depth-first step. */
58
- signal?: AbortSignal;
55
+ /** Registered relationship kinds whose edges define adjacency. */
56
+ kinds?: readonly string[];
57
+ /** Abort signal checked once per depth-first step. */
58
+ signal?: AbortSignal;
59
59
  }
60
60
  /** Articulation points and bridges of the undirected knowledge graph. */
61
61
  export interface RelationshipCutStructure {
62
- /** Sorted articulation-point ids — nodes whose removal adds components. */
63
- articulationPoints: string[];
64
- /** Bridge edges sorted by source then target. */
65
- bridges: RelationshipBridge[];
62
+ /** Sorted articulation-point ids — nodes whose removal adds components. */
63
+ articulationPoints: string[];
64
+ /** Bridge edges sorted by source then target. */
65
+ bridges: RelationshipBridge[];
66
66
  }
67
67
  /**
68
68
  * Compute exact shortest-path betweenness (Brandes), Wasserman–Faust closeness,
@@ -11,56 +11,56 @@ import { type RelationshipEdge } from "../relationships.js";
11
11
  export type RelationshipGraphScaleTopology = "chain" | "star" | "disconnected";
12
12
  /** Controls for a lazy deterministic graph scale fixture. */
13
13
  export interface RelationshipGraphScaleFixtureOptions {
14
- /** Number of nodes yielded by the fixture. */
15
- nodeCount: number;
16
- /** Shape of generated edges. */
17
- topology?: RelationshipGraphScaleTopology;
18
- /** Registered relationship kind used by generated edges. */
19
- kind?: string;
20
- /** Emit one edge per stride; large values model sparse million-node graphs. */
21
- edgeStride?: number;
22
- /** Stable node-id prefix. */
23
- idPrefix?: string;
14
+ /** Number of nodes yielded by the fixture. */
15
+ nodeCount: number;
16
+ /** Shape of generated edges. */
17
+ topology?: RelationshipGraphScaleTopology;
18
+ /** Registered relationship kind used by generated edges. */
19
+ kind?: string;
20
+ /** Emit one edge per stride; large values model sparse million-node graphs. */
21
+ edgeStride?: number;
22
+ /** Stable node-id prefix. */
23
+ idPrefix?: string;
24
24
  }
25
25
  /** Reusable lazy node/edge fixture plus exact cardinalities. */
26
26
  export interface RelationshipGraphScaleFixture {
27
- /** Exact node count. */
28
- node_count: number;
29
- /** Exact generated edge count. */
30
- edge_count: number;
31
- /** Counting convention used by edge_count. */
32
- edge_basis: "fixture_generated";
33
- /** Reiterable lazy node identifiers. */
34
- nodes: Iterable<string>;
35
- /** Reiterable lazy relationship edges. */
36
- edges: Iterable<RelationshipEdge>;
27
+ /** Exact node count. */
28
+ node_count: number;
29
+ /** Exact generated edge count. */
30
+ edge_count: number;
31
+ /** Counting convention used by edge_count. */
32
+ edge_basis: "fixture_generated";
33
+ /** Reiterable lazy node identifiers. */
34
+ nodes: Iterable<string>;
35
+ /** Reiterable lazy relationship edges. */
36
+ edges: Iterable<RelationshipEdge>;
37
37
  }
38
38
  /** Create a lazy deterministic scale fixture without touching tracker storage. */
39
39
  export declare function createRelationshipGraphScaleFixture(options: RelationshipGraphScaleFixtureOptions): RelationshipGraphScaleFixture;
40
40
  /** One named conformance assertion completed against an adapter. */
41
41
  export interface RelationshipGraphAdapterConformanceCase {
42
- /** Stable assertion identifier. */
43
- name: string;
44
- /** Successful case status. */
45
- passed: true;
42
+ /** Stable assertion identifier. */
43
+ name: string;
44
+ /** Successful case status. */
45
+ passed: true;
46
46
  }
47
47
  /** Compact successful adapter-conformance report. */
48
48
  export interface RelationshipGraphAdapterConformanceReport {
49
- /** Adapter identifier. */
50
- adapter: string;
51
- /** Isolated workspace key exercised by the run. */
52
- workspace: string;
53
- /** Completed semantic assertions. */
54
- cases: readonly RelationshipGraphAdapterConformanceCase[];
55
- /** Whether optional clear semantics were tested. */
56
- clear_supported: boolean;
49
+ /** Adapter identifier. */
50
+ adapter: string;
51
+ /** Isolated workspace key exercised by the run. */
52
+ workspace: string;
53
+ /** Completed semantic assertions. */
54
+ cases: readonly RelationshipGraphAdapterConformanceCase[];
55
+ /** Whether optional clear semantics were tested. */
56
+ clear_supported: boolean;
57
57
  }
58
58
  /**
59
59
  * Exercise empty reads, atomic replacement, isolated reads, idempotent sync,
60
60
  * compare-and-swap conflicts, replacement visibility, and optional clearing.
61
61
  */
62
62
  export declare function assertRelationshipGraphAdapterConformance(adapter: RelationshipGraphAdapter, options?: {
63
- workspace?: string;
63
+ workspace?: string;
64
64
  }): Promise<RelationshipGraphAdapterConformanceReport>;
65
65
  /** Run the public conformance contract against the built-in reference adapter. */
66
66
  export declare function assertMemoryRelationshipGraphAdapterConformance(workspace?: string): Promise<RelationshipGraphAdapterConformanceReport>;
@@ -7,79 +7,79 @@
7
7
  import type { RelationshipGraph } from "../relationships.js";
8
8
  /** Recorded inputs; absent estimates never imply zero duration. */
9
9
  export interface DeadlineScheduleItem {
10
- /** Canonical graph identifier. */
11
- id: string;
12
- /** Recorded elapsed-minute duration. */
13
- estimated_minutes?: number;
14
- /** Authored ISO deadline interpreted as a finish constraint. */
15
- deadline?: string;
10
+ /** Canonical graph identifier. */
11
+ id: string;
12
+ /** Recorded elapsed-minute duration. */
13
+ estimated_minutes?: number;
14
+ /** Authored ISO deadline interpreted as a finish constraint. */
15
+ deadline?: string;
16
16
  }
17
17
  /** Deterministic analysis controls and hard work/output bounds. */
18
18
  export interface DeadlineScheduleOptions {
19
- /** Explicit clock instant; defaults to the invocation time. */
20
- now?: string;
21
- /** Input nodes plus edges plus items ceiling; also caps total retained path identifiers. */
22
- maxWork?: number;
23
- /** Maximum rows, residual samples, findings, and identifiers per finding path. */
24
- limit?: number;
25
- /** Cooperative cancellation checked during graph passes. */
26
- signal?: AbortSignal;
19
+ /** Explicit clock instant; defaults to the invocation time. */
20
+ now?: string;
21
+ /** Input nodes plus edges plus items ceiling; also caps total retained path identifiers. */
22
+ maxWork?: number;
23
+ /** Maximum rows, residual samples, findings, and identifiers per finding path. */
24
+ limit?: number;
25
+ /** Cooperative cancellation checked during graph passes. */
26
+ signal?: AbortSignal;
27
27
  }
28
28
  /** One derived finish constraint and its estimated temporal slack. */
29
29
  export interface DeadlineScheduleRow {
30
- /** Constrained item identifier. */
31
- id: string;
32
- /** Controlling authored deadline's item identifier. */
33
- deadline_id: string;
34
- /** Derived latest start; never written to the authored item. */
35
- latest_start: string;
36
- /** Latest start minus earliest possible start, or null for unknown prerequisites. */
37
- slack_minutes: number | null;
30
+ /** Constrained item identifier. */
31
+ id: string;
32
+ /** Controlling authored deadline's item identifier. */
33
+ deadline_id: string;
34
+ /** Derived latest start; never written to the authored item. */
35
+ latest_start: string;
36
+ /** Latest start minus earliest possible start, or null for unknown prerequisites. */
37
+ slack_minutes: number | null;
38
38
  }
39
39
  /** Explicit evidence that this item's schedule could not be established. */
40
40
  export interface DeadlineScheduleResidual {
41
- /** Unscheduled or incompletely scheduled item. */
42
- id: string;
43
- /** Why no feasibility assertion is possible. */
44
- reason: "unknown_estimate" | "unknown_predecessor_estimate" | "cycle_or_gated_by_cycle" | "invalid_deadline" | "date_range_exceeded";
41
+ /** Unscheduled or incompletely scheduled item. */
42
+ id: string;
43
+ /** Why no feasibility assertion is possible. */
44
+ reason: "unknown_estimate" | "unknown_predecessor_estimate" | "cycle_or_gated_by_cycle" | "invalid_deadline" | "date_range_exceeded";
45
45
  }
46
46
  /** One authored deadline that cannot accommodate its longest prerequisite chain. */
47
47
  export interface DeadlineOvercommitment {
48
- /** Item carrying the authored deadline. */
49
- deadline_id: string;
50
- /** Authored finish constraint. */
51
- deadline: string;
52
- /** Positive duration by which earliest finish exceeds the deadline. */
53
- shortfall_minutes: number;
54
- /** Bounded suffix of the controlling prerequisite chain, in execution order. */
55
- path: string[];
56
- /** Whether the chain exceeds the path output bound. */
57
- path_truncated: boolean;
48
+ /** Item carrying the authored deadline. */
49
+ deadline_id: string;
50
+ /** Authored finish constraint. */
51
+ deadline: string;
52
+ /** Positive duration by which earliest finish exceeds the deadline. */
53
+ shortfall_minutes: number;
54
+ /** Bounded suffix of the controlling prerequisite chain, in execution order. */
55
+ path: string[];
56
+ /** Whether the chain exceeds the path output bound. */
57
+ path_truncated: boolean;
58
58
  }
59
59
  /** Bounded derived schedule, with completeness separate from output truncation. */
60
60
  export interface DeadlineScheduleResult {
61
- /** Reproducible clock used for earliest starts. */
62
- as_of: string;
63
- /** Explicit provenance distinguishing computed constraints from authored dates. */
64
- basis: "derived_elapsed_minutes";
65
- /** Whether all inputs could be scheduled within the work bound. */
66
- complete: boolean;
67
- /** Whether output collections omit computed entries. */
68
- truncated: boolean;
69
- /** True when the work bound prevented the graph pass. */
70
- work_limit_exceeded: boolean;
71
- /** Number of derived rows before output bounding. */
72
- scheduled_count: number;
73
- /** Number of explicit residuals before output bounding. */
74
- residual_count: number;
75
- /** Number of infeasible authored deadlines before output bounding. */
76
- overcommitted_count: number;
77
- /** Derived latest starts in graph identifier order. */
78
- rows: DeadlineScheduleRow[];
79
- /** Bounded incomplete-input and cycle samples. */
80
- residuals: DeadlineScheduleResidual[];
81
- /** Bounded deadline shortfall evidence. */
82
- overcommitted: DeadlineOvercommitment[];
61
+ /** Reproducible clock used for earliest starts. */
62
+ as_of: string;
63
+ /** Explicit provenance distinguishing computed constraints from authored dates. */
64
+ basis: "derived_elapsed_minutes";
65
+ /** Whether all inputs could be scheduled within the work bound. */
66
+ complete: boolean;
67
+ /** Whether output collections omit computed entries. */
68
+ truncated: boolean;
69
+ /** True when the work bound prevented the graph pass. */
70
+ work_limit_exceeded: boolean;
71
+ /** Number of derived rows before output bounding. */
72
+ scheduled_count: number;
73
+ /** Number of explicit residuals before output bounding. */
74
+ residual_count: number;
75
+ /** Number of infeasible authored deadlines before output bounding. */
76
+ overcommitted_count: number;
77
+ /** Derived latest starts in graph identifier order. */
78
+ rows: DeadlineScheduleRow[];
79
+ /** Bounded incomplete-input and cycle samples. */
80
+ residuals: DeadlineScheduleResidual[];
81
+ /** Bounded deadline shortfall evidence. */
82
+ overcommitted: DeadlineOvercommitment[];
83
83
  }
84
84
  /**
85
85
  * Derive estimated latest starts and deadline shortfalls without mutating inputs.
@@ -5,29 +5,29 @@ export declare const GRAPH_DURABLE_CACHE_VERSION = 2;
5
5
  export declare const GRAPH_DURABLE_CACHE_MIN_ITEMS = 500;
6
6
  /** Persisted durable graph cache envelope keyed by one workspace fingerprint. */
7
7
  export interface DurableGraphCacheEnvelope {
8
- /** Envelope format version guarding decode compatibility. */
9
- version: number;
10
- /** Full workspace graph fingerprint every entry answers for. */
11
- fingerprint: string;
12
- /** ISO timestamp of the last persisted write. */
13
- saved_at: string;
14
- /** Deterministic query results keyed by their canonical query key. */
15
- results: Record<string, unknown>;
8
+ /** Envelope format version guarding decode compatibility. */
9
+ version: number;
10
+ /** Full workspace graph fingerprint every entry answers for. */
11
+ fingerprint: string;
12
+ /** ISO timestamp of the last persisted write. */
13
+ saved_at: string;
14
+ /** Deterministic query results keyed by their canonical query key. */
15
+ results: Record<string, unknown>;
16
16
  }
17
17
  /** Compact durable index status projection for observability surfaces. */
18
18
  export interface DurableGraphCacheStatus {
19
- /** Whether an envelope file exists on disk. */
20
- exists: boolean;
21
- /** Whether the stored fingerprint matches the current workspace snapshot. */
22
- fresh: boolean;
23
- /** Stored entry count, 0 when absent. */
24
- entry_count: number;
25
- /** Truncated stored fingerprint, absent when no envelope exists. */
26
- fingerprint?: string;
27
- /** ISO timestamp of the last persisted write, absent when no envelope exists. */
28
- saved_at?: string;
29
- /** Envelope file size in bytes, absent when no envelope exists. */
30
- bytes?: number;
19
+ /** Whether an envelope file exists on disk. */
20
+ exists: boolean;
21
+ /** Whether the stored fingerprint matches the current workspace snapshot. */
22
+ fresh: boolean;
23
+ /** Stored entry count, 0 when absent. */
24
+ entry_count: number;
25
+ /** Truncated stored fingerprint, absent when no envelope exists. */
26
+ fingerprint?: string;
27
+ /** ISO timestamp of the last persisted write, absent when no envelope exists. */
28
+ saved_at?: string;
29
+ /** Envelope file size in bytes, absent when no envelope exists. */
30
+ bytes?: number;
31
31
  }
32
32
  /** Resolve the durable graph cache file path for one workspace root. */
33
33
  export declare function durableGraphCachePath(pmRoot: string): string;
@@ -35,12 +35,12 @@ export declare function durableGraphCachePath(pmRoot: string): string;
35
35
  export declare function graphAuditBaselinePath(pmRoot: string): string;
36
36
  /** One opened durable index view bound to the current workspace fingerprint. */
37
37
  export interface DurableGraphCacheView {
38
- /** Whether any envelope file exists on disk, fresh or not. */
39
- exists: boolean;
40
- /** Whether the stored envelope answers for the current fingerprint. */
41
- fresh: boolean;
42
- /** Fingerprint-fresh persisted query results; empty when absent or stale. */
43
- results: Record<string, unknown>;
38
+ /** Whether any envelope file exists on disk, fresh or not. */
39
+ exists: boolean;
40
+ /** Whether the stored envelope answers for the current fingerprint. */
41
+ fresh: boolean;
42
+ /** Fingerprint-fresh persisted query results; empty when absent or stale. */
43
+ results: Record<string, unknown>;
44
44
  }
45
45
  /**
46
46
  * Open the persisted envelope against the current workspace fingerprint. A