@unbrained/pm-cli 2026.10.14 → 2026.10.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (692) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +54 -2
  3. package/dist/cli/after-command-context-usage.d.ts +7 -7
  4. package/dist/cli/argv-utils.d.ts +4 -4
  5. package/dist/cli/bundle-integrity.d.ts +16 -16
  6. package/dist/cli/command-namespaces.d.ts +1 -1
  7. package/dist/cli/commander-usage.d.ts +34 -34
  8. package/dist/cli/commands/governance/validate.d.ts +1 -1
  9. package/dist/cli/commands/history/history-compact.d.ts +1 -1
  10. package/dist/cli/commands/history/history-redact.d.ts +1 -1
  11. package/dist/cli/commands/history/history-repair.d.ts +1 -1
  12. package/dist/cli/commands/history/restore.d.ts +1 -1
  13. package/dist/cli/commands/lifecycle/close.d.ts +1 -1
  14. package/dist/cli/commands/lifecycle/copy.d.ts +1 -1
  15. package/dist/cli/commands/lifecycle/delete.d.ts +1 -1
  16. package/dist/cli/commands/lifecycle/focus.d.ts +1 -1
  17. package/dist/cli/commands/query/get.d.ts +1 -1
  18. package/dist/cli/commands/workspace/merge.d.ts +1 -1
  19. package/dist/cli/commands/workspace/schema.d.ts +1 -1
  20. package/dist/cli/context-intent-invocation.d.ts +1 -1
  21. package/dist/cli/description-stdin.d.ts +1 -1
  22. package/dist/cli/error-guidance.d.ts +119 -119
  23. package/dist/cli/extension-command-help.d.ts +64 -64
  24. package/dist/cli/extension-command-help.js +2 -2
  25. package/dist/cli/extension-command-options.d.ts +16 -16
  26. package/dist/cli/extension-recovery.d.ts +13 -13
  27. package/dist/cli/help-content.d.ts +22 -22
  28. package/dist/cli/help-content.js +2 -2
  29. package/dist/cli/help-json-payload.d.ts +45 -45
  30. package/dist/cli/invocation-profile.d.ts +5 -5
  31. package/dist/cli/main.d.ts +217 -217
  32. package/dist/cli/migration-gates.d.ts +24 -24
  33. package/dist/cli/option-values.d.ts +1 -1
  34. package/dist/cli/public.d.ts +1 -1
  35. package/dist/cli/register-annotations.d.ts +2 -2
  36. package/dist/cli/register-assurance.d.ts +1 -1
  37. package/dist/cli/register-files-lookup.d.ts +1 -1
  38. package/dist/cli/register-history-activity.d.ts +1 -1
  39. package/dist/cli/register-history-author.d.ts +1 -1
  40. package/dist/cli/register-history-maintenance.d.ts +1 -1
  41. package/dist/cli/register-list-query.d.ts +7 -7
  42. package/dist/cli/register-list-query.js +3 -3
  43. package/dist/cli/register-mutation-options.d.ts +1 -1
  44. package/dist/cli/register-mutation.d.ts +4 -4
  45. package/dist/cli/register-operations.d.ts +75 -75
  46. package/dist/cli/register-setup.d.ts +4 -4
  47. package/dist/cli/register-structured-mutation.d.ts +8 -8
  48. package/dist/cli/runtime/activation.d.ts +23 -23
  49. package/dist/cli/runtime/invocation-options.d.ts +12 -12
  50. package/dist/cli/runtime/projection-retry.d.ts +1 -1
  51. package/dist/cli/runtime/selection.d.ts +16 -16
  52. package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
  53. package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
  54. package/dist/cli/schema/registration.d.ts +1 -1
  55. package/dist/cli/schema-registration-helpers.d.ts +2 -2
  56. package/dist/cli/stats-analytics-json.d.ts +1 -1
  57. package/dist/cli-bundle/bundle-manifest.json +1 -1
  58. package/dist/cli-bundle/chunks/{chunk-5LU6PWA4.js → chunk-52EZH2QQ.js} +2 -2
  59. package/dist/cli-bundle/chunks/chunk-7OEGNA4X.js +20 -0
  60. package/dist/cli-bundle/chunks/{chunk-LKESCZEN.js → chunk-7VHINXZP.js} +2 -2
  61. package/dist/cli-bundle/chunks/chunk-EMEEHV2Y.js +2 -0
  62. package/dist/cli-bundle/chunks/chunk-JGKTOBVB.js +6 -0
  63. package/dist/cli-bundle/chunks/{chunk-PP3BVMFL.js → chunk-JSUJWIHQ.js} +30 -30
  64. package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-LNKLQYBG.js} +2 -2
  65. package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-N56CAQBU.js} +63 -64
  66. package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-NC3QVGDD.js} +2 -2
  67. package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-RJ5N44WY.js} +2 -2
  68. package/dist/cli-bundle/chunks/{chunk-LOSRTNNP.js → chunk-VIMQCFCK.js} +2 -2
  69. package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-WBBW3WQX.js} +4 -4
  70. package/dist/cli-bundle/chunks/chunk-X2H6UR26.js +236 -0
  71. package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-FKKFQ66D.js} +7 -7
  72. package/dist/cli-bundle/chunks/{register-mutation-TNRHNK4N.js → register-mutation-EWMMVZJB.js} +2 -2
  73. package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-GEQ2H7PS.js} +2 -2
  74. package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-PSJTQBBO.js} +2 -2
  75. package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-3RNUMVK4.js} +2 -2
  76. package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-4KQFMOM7.js} +6 -6
  77. package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-52I2SNKJ.js} +2 -2
  78. package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-5KRACGBK.js} +2 -2
  79. package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-5OO54BIV.js} +2 -2
  80. package/dist/cli-bundle/focused-chunks/{chunk-LKWDWER4.js → chunk-5TBAVZDR.js} +14 -14
  81. package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-FQKPOZKS.js} +2 -2
  82. package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-H3P77KVU.js} +2 -2
  83. package/dist/cli-bundle/focused-chunks/chunk-HTA3TNC3.js +26 -0
  84. package/dist/cli-bundle/focused-chunks/{chunk-23ACMPGB.js → chunk-JKBH7YGX.js} +2 -2
  85. package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-KIIFVULU.js} +2 -2
  86. package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-N6FUKTZS.js} +2 -2
  87. package/dist/cli-bundle/focused-chunks/chunk-PDYE7QDX.js +166 -0
  88. package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-Q4VNCTR2.js} +2 -2
  89. package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-THYQR3ON.js} +61 -62
  90. package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-TYLG5VEB.js} +2 -2
  91. package/dist/cli-bundle/main.js +26 -26
  92. package/dist/cli-bundle/sdk-authoring.js +1 -1
  93. package/dist/cli-bundle/sdk-contracts.js +2 -2
  94. package/dist/cli-bundle/sdk-core.js +22 -22
  95. package/dist/cli-bundle/sdk-governance.js +1 -1
  96. package/dist/cli-bundle/sdk-graph.js +1 -1
  97. package/dist/cli-bundle/sdk-merge.js +51 -51
  98. package/dist/cli-bundle/sdk-query.js +1 -1
  99. package/dist/cli-bundle/sdk-runtime.js +1 -1
  100. package/dist/cli-bundle/sdk-testing.js +1 -1
  101. package/dist/cli-bundle/sdk.js +7 -7
  102. package/dist/cli.d.ts +9 -9
  103. package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
  104. package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
  105. package/dist/core/config/nested-settings.d.ts +20 -20
  106. package/dist/core/config/positional-value.d.ts +9 -9
  107. package/dist/core/diagnostics/remediation.d.ts +7 -7
  108. package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
  109. package/dist/core/extensions/activation-summary.d.ts +30 -30
  110. package/dist/core/extensions/activation-transaction.d.ts +9 -9
  111. package/dist/core/extensions/capability-usage.d.ts +25 -25
  112. package/dist/core/extensions/command-hook-context.d.ts +15 -15
  113. package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
  114. package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
  115. package/dist/core/extensions/contribution-inventory.d.ts +24 -24
  116. package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
  117. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  118. package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
  119. package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
  120. package/dist/core/extensions/extension-policy.d.ts +62 -62
  121. package/dist/core/extensions/extension-registries.d.ts +8 -8
  122. package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
  123. package/dist/core/extensions/extension-types.d.ts +702 -702
  124. package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
  125. package/dist/core/extensions/flag-value-types.d.ts +16 -4
  126. package/dist/core/extensions/flag-value-types.js +1 -1
  127. package/dist/core/extensions/index.d.ts +34 -34
  128. package/dist/core/extensions/item-field-types.d.ts +3 -3
  129. package/dist/core/extensions/item-fields.d.ts +6 -6
  130. package/dist/core/extensions/loader.d.ts +66 -66
  131. package/dist/core/extensions/manifest-parser.d.ts +1 -1
  132. package/dist/core/extensions/manifest-schema.d.ts +13 -13
  133. package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
  134. package/dist/core/extensions/preflight-ownership.d.ts +3 -3
  135. package/dist/core/extensions/read-output-contract.d.ts +2 -2
  136. package/dist/core/extensions/registration-contracts.d.ts +12 -12
  137. package/dist/core/extensions/registration-validation.d.ts +6 -6
  138. package/dist/core/extensions/registration-values.d.ts +19 -19
  139. package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
  140. package/dist/core/extensions/runtime-registrations.d.ts +6 -6
  141. package/dist/core/extensions/service-ownership.d.ts +1 -1
  142. package/dist/core/extensions/version-compat.d.ts +9 -9
  143. package/dist/core/fs/atomic-create.d.ts +1 -1
  144. package/dist/core/fs/fs-utils.d.ts +12 -12
  145. package/dist/core/fs/host-environment-errors.d.ts +10 -10
  146. package/dist/core/fs/path-utils.d.ts +1 -1
  147. package/dist/core/governance/content-fields.d.ts +25 -25
  148. package/dist/core/governance/issue-codes.d.ts +16 -16
  149. package/dist/core/governance/metadata-coverage.d.ts +64 -64
  150. package/dist/core/history/digest.d.ts +5 -5
  151. package/dist/core/history/drift-cache.d.ts +2 -2
  152. package/dist/core/history/drift-scan.d.ts +18 -18
  153. package/dist/core/history/event-classification.d.ts +4 -4
  154. package/dist/core/history/event-index.d.ts +33 -33
  155. package/dist/core/history/history-compact-bulk.d.ts +12 -12
  156. package/dist/core/history/history-diff.d.ts +15 -15
  157. package/dist/core/history/history-rewrite.d.ts +43 -43
  158. package/dist/core/history/history-storage-stats.d.ts +20 -20
  159. package/dist/core/history/history-stream-policy.d.ts +12 -12
  160. package/dist/core/history/history.d.ts +45 -45
  161. package/dist/core/history/identity.d.ts +4 -4
  162. package/dist/core/history/operation-contract.d.ts +17 -17
  163. package/dist/core/history/projection.d.ts +16 -16
  164. package/dist/core/history/read.d.ts +4 -4
  165. package/dist/core/history/replay.d.ts +47 -47
  166. package/dist/core/history/tombstone.d.ts +1 -1
  167. package/dist/core/history/version-address.d.ts +2 -2
  168. package/dist/core/history/workspace-history.d.ts +72 -72
  169. package/dist/core/io/body-file.d.ts +2 -2
  170. package/dist/core/io/bulk-ids-input.d.ts +7 -7
  171. package/dist/core/item/actionability.d.ts +30 -30
  172. package/dist/core/item/dependency-reference.d.ts +2 -2
  173. package/dist/core/item/id.d.ts +9 -9
  174. package/dist/core/item/item-format-version.d.ts +17 -15
  175. package/dist/core/item/item-format-version.js +1 -1
  176. package/dist/core/item/item-format.d.ts +54 -54
  177. package/dist/core/item/item-record.d.ts +1 -1
  178. package/dist/core/item/item-type-definition.d.ts +11 -11
  179. package/dist/core/item/parent-reference-policy.d.ts +6 -6
  180. package/dist/core/item/parse.d.ts +37 -37
  181. package/dist/core/item/plan-lifecycle.d.ts +4 -4
  182. package/dist/core/item/priority.d.ts +3 -3
  183. package/dist/core/item/sprint-release-format.d.ts +4 -4
  184. package/dist/core/item/status-filter.d.ts +5 -5
  185. package/dist/core/item/status.d.ts +3 -3
  186. package/dist/core/item/toon-decode.d.ts +10 -10
  187. package/dist/core/item/type-registry.d.ts +35 -35
  188. package/dist/core/item/type-synonyms.d.ts +2 -2
  189. package/dist/core/lock/lock-gc.d.ts +28 -28
  190. package/dist/core/lock/lock.d.ts +53 -53
  191. package/dist/core/output/mutation-projection.d.ts +4 -4
  192. package/dist/core/output/output-control.d.ts +4 -4
  193. package/dist/core/output/output.d.ts +30 -30
  194. package/dist/core/output/query-summary.d.ts +5 -5
  195. package/dist/core/output/tabular.d.ts +3 -3
  196. package/dist/core/packages/manifest.d.ts +30 -30
  197. package/dist/core/packages/root.d.ts +4 -4
  198. package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
  199. package/dist/core/policy/workflow-policy-store.d.ts +15 -15
  200. package/dist/core/policy/workflow-policy.d.ts +56 -56
  201. package/dist/core/profile/profile-describe.d.ts +22 -22
  202. package/dist/core/profile/profile-lint.d.ts +13 -13
  203. package/dist/core/profile/profile-plan.d.ts +45 -45
  204. package/dist/core/profile/profile-presets.d.ts +36 -36
  205. package/dist/core/reproducibility/context.d.ts +9 -9
  206. package/dist/core/schema/fields-file.d.ts +35 -35
  207. package/dist/core/schema/item-types-file.d.ts +29 -29
  208. package/dist/core/schema/runtime-field-filters.d.ts +3 -3
  209. package/dist/core/schema/runtime-field-values.d.ts +7 -7
  210. package/dist/core/schema/runtime-schema.d.ts +59 -59
  211. package/dist/core/schema/status-defs-file.d.ts +29 -29
  212. package/dist/core/schema/status-token.d.ts +1 -1
  213. package/dist/core/schema/type-inference.d.ts +10 -10
  214. package/dist/core/schema/type-presets.d.ts +5 -5
  215. package/dist/core/schema/type-workflows.d.ts +14 -14
  216. package/dist/core/search/background-refresh.d.ts +12 -12
  217. package/dist/core/search/bm25.d.ts +16 -16
  218. package/dist/core/search/cache.d.ts +34 -34
  219. package/dist/core/search/corpus.d.ts +17 -17
  220. package/dist/core/search/embedding-batches.d.ts +25 -25
  221. package/dist/core/search/eval-thresholds.d.ts +4 -4
  222. package/dist/core/search/eval.d.ts +40 -40
  223. package/dist/core/search/http-client.d.ts +24 -24
  224. package/dist/core/search/providers.d.ts +30 -30
  225. package/dist/core/search/relevance.d.ts +17 -17
  226. package/dist/core/search/semantic-defaults.d.ts +5 -5
  227. package/dist/core/search/staleness.d.ts +3 -3
  228. package/dist/core/search/vector-stores.d.ts +51 -51
  229. package/dist/core/search/vectorization-metadata.d.ts +9 -9
  230. package/dist/core/sentry/helpers.d.ts +27 -27
  231. package/dist/core/sentry/instrument.d.ts +51 -51
  232. package/dist/core/sentry/instrument.js +1 -1
  233. package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
  234. package/dist/core/sentry/sensitive-assignments.js +2 -0
  235. package/dist/core/session/session-state.d.ts +37 -37
  236. package/dist/core/shared/agent-session-context.d.ts +14 -14
  237. package/dist/core/shared/author.d.ts +89 -89
  238. package/dist/core/shared/command-line.d.ts +3 -3
  239. package/dist/core/shared/command-types.d.ts +20 -20
  240. package/dist/core/shared/conflict-markers.d.ts +5 -5
  241. package/dist/core/shared/constants.d.ts +30 -30
  242. package/dist/core/shared/errors.d.ts +100 -100
  243. package/dist/core/shared/html-entity-decode.d.ts +2 -2
  244. package/dist/core/shared/item-metadata-contract.d.ts +2 -2
  245. package/dist/core/shared/lazy-module.d.ts +1 -1
  246. package/dist/core/shared/levenshtein.d.ts +1 -1
  247. package/dist/core/shared/memo.d.ts +1 -1
  248. package/dist/core/shared/numeric-parsers.d.ts +1 -1
  249. package/dist/core/shared/option-alias-visibility.d.ts +3 -3
  250. package/dist/core/shared/primitives.d.ts +13 -13
  251. package/dist/core/shared/secret-rules.d.ts +92 -92
  252. package/dist/core/shared/serial-queue.d.ts +6 -6
  253. package/dist/core/shared/serialization.d.ts +4 -4
  254. package/dist/core/shared/split-comma-list.d.ts +4 -4
  255. package/dist/core/shared/text-normalization.d.ts +3 -3
  256. package/dist/core/shared/time.d.ts +27 -27
  257. package/dist/core/store/item-format-migration.d.ts +7 -7
  258. package/dist/core/store/item-metadata-cache.d.ts +30 -30
  259. package/dist/core/store/item-metadata-query-index.d.ts +66 -66
  260. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  261. package/dist/core/store/item-store.d.ts +123 -123
  262. package/dist/core/store/item-store.js +1 -1
  263. package/dist/core/store/paths.d.ts +27 -27
  264. package/dist/core/store/settings-concurrency.d.ts +1 -1
  265. package/dist/core/store/settings-read-cache.d.ts +11 -11
  266. package/dist/core/store/settings-validator.d.ts +117 -117
  267. package/dist/core/store/settings.d.ts +84 -84
  268. package/dist/core/store/sqlite-runtime.d.ts +2 -2
  269. package/dist/core/store/tracker-preflight.d.ts +3 -3
  270. package/dist/core/telemetry/consent.d.ts +1 -1
  271. package/dist/core/telemetry/observability.d.ts +16 -16
  272. package/dist/core/telemetry/policy.d.ts +7 -7
  273. package/dist/core/telemetry/read-sampling.d.ts +1 -1
  274. package/dist/core/telemetry/runtime.d.ts +275 -275
  275. package/dist/core/test/background-runs.d.ts +123 -123
  276. package/dist/core/test/item-test-run-tracking.d.ts +10 -10
  277. package/dist/core/test/run-selectors.d.ts +12 -12
  278. package/dist/core/validate/estimate-defaults.d.ts +3 -3
  279. package/dist/core/validate/fix-planning.d.ts +36 -36
  280. package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
  281. package/dist/core/validate/missing-by-type.d.ts +3 -3
  282. package/dist/core/validate/missing-link-owners.d.ts +17 -17
  283. package/dist/core/validate/stale-file-classification.d.ts +6 -6
  284. package/dist/mcp/http-server.d.ts +26 -26
  285. package/dist/mcp/legacy-adapter.d.ts +18 -18
  286. package/dist/mcp/runtime-capabilities.d.ts +18 -18
  287. package/dist/mcp/server.d.ts +73 -73
  288. package/dist/mcp/tool-definitions.d.ts +27 -27
  289. package/dist/sdk/actionability.d.ts +1 -1
  290. package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
  291. package/dist/sdk/agent/command-recovery.d.ts +5 -5
  292. package/dist/sdk/agent/command-suggestions.d.ts +4 -4
  293. package/dist/sdk/agent/create-option-policy.d.ts +2 -2
  294. package/dist/sdk/agent/identity-config.d.ts +18 -18
  295. package/dist/sdk/agent/item-addressing.d.ts +6 -6
  296. package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
  297. package/dist/sdk/agent/refusal-closure.d.ts +22 -22
  298. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
  299. package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
  300. package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
  301. package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
  302. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
  303. package/dist/sdk/agent-capability-contracts.d.ts +41 -41
  304. package/dist/sdk/agent-session-context.d.ts +1 -1
  305. package/dist/sdk/annotations.d.ts +74 -74
  306. package/dist/sdk/author-attribution.d.ts +47 -47
  307. package/dist/sdk/authoring.d.ts +9 -9
  308. package/dist/sdk/cli-bootstrap.d.ts +65 -65
  309. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
  310. package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
  311. package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
  312. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
  313. package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
  314. package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
  315. package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
  316. package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
  317. package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
  318. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  319. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
  320. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
  321. package/dist/sdk/cli-contracts/registration-helpers.d.ts +56 -56
  322. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
  323. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  324. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
  325. package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
  326. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
  327. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
  328. package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
  329. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
  330. package/dist/sdk/cli-contracts.d.ts +15 -15
  331. package/dist/sdk/cli-program.d.ts +1 -1
  332. package/dist/sdk/cli-program.js +1 -1
  333. package/dist/sdk/command-line.d.ts +3 -3
  334. package/dist/sdk/comments.d.ts +24 -24
  335. package/dist/sdk/compile-cache.d.ts +4 -4
  336. package/dist/sdk/completion/bash.d.ts +1 -1
  337. package/dist/sdk/completion/fish.d.ts +1 -1
  338. package/dist/sdk/completion/shared.d.ts +74 -74
  339. package/dist/sdk/completion/zsh.d.ts +1 -1
  340. package/dist/sdk/completion.d.ts +3 -3
  341. package/dist/sdk/compose.d.ts +94 -94
  342. package/dist/sdk/config.d.ts +105 -105
  343. package/dist/sdk/context/recency.d.ts +1 -1
  344. package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
  345. package/dist/sdk/context/usage-egress.d.ts +1 -1
  346. package/dist/sdk/context/usage-ledger.d.ts +18 -18
  347. package/dist/sdk/context-intent-contracts.d.ts +37 -37
  348. package/dist/sdk/context-intent-runtime.d.ts +10 -10
  349. package/dist/sdk/context-packing.d.ts +44 -44
  350. package/dist/sdk/context-relevance.d.ts +110 -110
  351. package/dist/sdk/context-signal-store.d.ts +52 -52
  352. package/dist/sdk/context-usage.d.ts +78 -78
  353. package/dist/sdk/contracts.d.ts +2 -1
  354. package/dist/sdk/contracts.js +1 -1
  355. package/dist/sdk/core-governance.d.ts +5 -5
  356. package/dist/sdk/core.d.ts +8 -8
  357. package/dist/sdk/corpus-shape.d.ts +60 -60
  358. package/dist/sdk/define.d.ts +36 -36
  359. package/dist/sdk/dependencies.d.ts +70 -70
  360. package/dist/sdk/dependency-flag-validation.d.ts +17 -17
  361. package/dist/sdk/dependency-provenance.d.ts +22 -22
  362. package/dist/sdk/docs.d.ts +17 -17
  363. package/dist/sdk/duplicates.d.ts +14 -14
  364. package/dist/sdk/environment/agent-environment.d.ts +118 -118
  365. package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
  366. package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
  367. package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
  368. package/dist/sdk/environment/source-context.d.ts +4 -4
  369. package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
  370. package/dist/sdk/error-code-catalog.d.ts +33 -33
  371. package/dist/sdk/error-runtime.d.ts +5 -5
  372. package/dist/sdk/errors.d.ts +17 -17
  373. package/dist/sdk/eval.d.ts +27 -27
  374. package/dist/sdk/extension/author-manifest.d.ts +9 -9
  375. package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
  376. package/dist/sdk/extension/concurrency.d.ts +1 -1
  377. package/dist/sdk/extension/copy-scope.d.ts +1 -1
  378. package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
  379. package/dist/sdk/extension/describe.d.ts +21 -21
  380. package/dist/sdk/extension/doctor.d.ts +46 -46
  381. package/dist/sdk/extension/install-plan.d.ts +32 -32
  382. package/dist/sdk/extension/install-receipts.d.ts +4 -4
  383. package/dist/sdk/extension/install-runtime.d.ts +12 -12
  384. package/dist/sdk/extension/install-snapshot.d.ts +10 -10
  385. package/dist/sdk/extension/install-sources.d.ts +106 -106
  386. package/dist/sdk/extension/managed-state.d.ts +42 -42
  387. package/dist/sdk/extension/managed-update-status.d.ts +1 -1
  388. package/dist/sdk/extension/migrations.d.ts +48 -48
  389. package/dist/sdk/extension/output-ownership.d.ts +19 -19
  390. package/dist/sdk/extension/runtime-summary.d.ts +7 -7
  391. package/dist/sdk/extension/scaffold.d.ts +15 -15
  392. package/dist/sdk/extension/shared.d.ts +16 -16
  393. package/dist/sdk/extension/source-resolution.d.ts +16 -16
  394. package/dist/sdk/extension/static-inventory.d.ts +23 -23
  395. package/dist/sdk/extension/update-check.d.ts +9 -9
  396. package/dist/sdk/extension-command-context.d.ts +1 -1
  397. package/dist/sdk/extension-contracts.d.ts +10 -10
  398. package/dist/sdk/extension.d.ts +221 -221
  399. package/dist/sdk/files.d.ts +101 -101
  400. package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
  401. package/dist/sdk/flag-invocation-contracts.js +1 -1
  402. package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
  403. package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
  404. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  405. package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
  406. package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
  407. package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
  408. package/dist/sdk/governance/assurance-action.d.ts +46 -46
  409. package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
  410. package/dist/sdk/governance/assurance-presets.d.ts +25 -25
  411. package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
  412. package/dist/sdk/governance/assurance.d.ts +204 -204
  413. package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
  414. package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
  415. package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
  416. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
  417. package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
  418. package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
  419. package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
  420. package/dist/sdk/governance/extension-host-version.d.ts +9 -9
  421. package/dist/sdk/governance/gc.d.ts +26 -26
  422. package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
  423. package/dist/sdk/governance/health.d.ts +172 -172
  424. package/dist/sdk/governance/health.js +1 -1
  425. package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
  426. package/dist/sdk/governance/linked-file-report.d.ts +15 -15
  427. package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
  428. package/dist/sdk/governance/provenance-health.d.ts +35 -35
  429. package/dist/sdk/governance/reindex.d.ts +102 -102
  430. package/dist/sdk/governance/reliability.d.ts +29 -29
  431. package/dist/sdk/governance/stale-work.d.ts +13 -13
  432. package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
  433. package/dist/sdk/governance/storage-integrity.d.ts +28 -28
  434. package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
  435. package/dist/sdk/governance/upgrade.d.ts +77 -77
  436. package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
  437. package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
  438. package/dist/sdk/governance/validate-normalization.d.ts +4 -4
  439. package/dist/sdk/governance/validate.d.ts +176 -176
  440. package/dist/sdk/governance/validate.js +1 -1
  441. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  442. package/dist/sdk/governance/workflow-policy.d.ts +18 -18
  443. package/dist/sdk/governance/workspace-position.d.ts +40 -40
  444. package/dist/sdk/governance.d.ts +2 -2
  445. package/dist/sdk/graph/adapter.d.ts +45 -45
  446. package/dist/sdk/graph/analytics.d.ts +36 -36
  447. package/dist/sdk/graph/assembly.d.ts +51 -51
  448. package/dist/sdk/graph/cache.d.ts +19 -19
  449. package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
  450. package/dist/sdk/graph/centrality.d.ts +20 -20
  451. package/dist/sdk/graph/conformance.d.ts +21 -21
  452. package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
  453. package/dist/sdk/graph/durable-cache.d.ts +22 -22
  454. package/dist/sdk/graph/governance-contracts.d.ts +1 -1
  455. package/dist/sdk/graph/governance.d.ts +92 -92
  456. package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
  457. package/dist/sdk/graph/index.d.ts +15 -15
  458. package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
  459. package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
  460. package/dist/sdk/graph/query-contracts.d.ts +6 -6
  461. package/dist/sdk/graph/remediation.d.ts +15 -15
  462. package/dist/sdk/graph/run.d.ts +203 -203
  463. package/dist/sdk/graph/scheduling.d.ts +21 -21
  464. package/dist/sdk/graph/traversal.d.ts +18 -18
  465. package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
  466. package/dist/sdk/guide-topics.d.ts +19 -19
  467. package/dist/sdk/guide.d.ts +43 -43
  468. package/dist/sdk/history/attestation-command.d.ts +8 -8
  469. package/dist/sdk/history/attestation-contract.d.ts +43 -43
  470. package/dist/sdk/history/attestation-scan.d.ts +4 -4
  471. package/dist/sdk/history/attestation.d.ts +4 -4
  472. package/dist/sdk/history/maintenance.d.ts +25 -25
  473. package/dist/sdk/history/salvage.d.ts +19 -19
  474. package/dist/sdk/history/subject.d.ts +8 -8
  475. package/dist/sdk/history-analytics.d.ts +64 -64
  476. package/dist/sdk/history-compact.d.ts +67 -67
  477. package/dist/sdk/history-mcp.d.ts +7 -7
  478. package/dist/sdk/history-provenance.d.ts +40 -40
  479. package/dist/sdk/history-read.d.ts +24 -24
  480. package/dist/sdk/history-redact.d.ts +68 -68
  481. package/dist/sdk/history-repair.d.ts +92 -92
  482. package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
  483. package/dist/sdk/improvement-ledger.d.ts +62 -62
  484. package/dist/sdk/index.d.ts +69 -69
  485. package/dist/sdk/init-agent-guidance.d.ts +68 -68
  486. package/dist/sdk/init.d.ts +117 -117
  487. package/dist/sdk/invocation-author.d.ts +1 -1
  488. package/dist/sdk/item-children.d.ts +15 -15
  489. package/dist/sdk/item-metadata-index.d.ts +2 -2
  490. package/dist/sdk/item-schedule.d.ts +9 -9
  491. package/dist/sdk/item-transaction.d.ts +73 -73
  492. package/dist/sdk/learnings.d.ts +23 -23
  493. package/dist/sdk/lifecycle/append.d.ts +8 -8
  494. package/dist/sdk/lifecycle/claim.d.ts +38 -38
  495. package/dist/sdk/lifecycle/close-many.d.ts +71 -71
  496. package/dist/sdk/lifecycle/close.d.ts +18 -18
  497. package/dist/sdk/lifecycle/copy.d.ts +10 -10
  498. package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
  499. package/dist/sdk/lifecycle/create.d.ts +88 -88
  500. package/dist/sdk/lifecycle/delete.d.ts +15 -15
  501. package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
  502. package/dist/sdk/lifecycle/focus.d.ts +6 -6
  503. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
  504. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
  505. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
  506. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  507. package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
  508. package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
  509. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
  510. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
  511. package/dist/sdk/lifecycle/plan.d.ts +127 -127
  512. package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
  513. package/dist/sdk/lifecycle/reopen.d.ts +15 -15
  514. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
  515. package/dist/sdk/lifecycle/restore.d.ts +34 -34
  516. package/dist/sdk/lifecycle/restore.js +1 -1
  517. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
  518. package/dist/sdk/lifecycle/task-composition.d.ts +7 -7
  519. package/dist/sdk/lifecycle/update-many.d.ts +61 -61
  520. package/dist/sdk/lifecycle/update.d.ts +120 -120
  521. package/dist/sdk/lifecycle-completion.d.ts +14 -14
  522. package/dist/sdk/lifecycle-policy.d.ts +31 -31
  523. package/dist/sdk/linked-artifacts.d.ts +58 -58
  524. package/dist/sdk/mcp/apps.d.ts +28 -28
  525. package/dist/sdk/mcp/authorization.d.ts +66 -66
  526. package/dist/sdk/mcp/discovery.d.ts +67 -67
  527. package/dist/sdk/mcp/interactions.d.ts +49 -49
  528. package/dist/sdk/mcp/protocol.d.ts +63 -63
  529. package/dist/sdk/mcp/skills.d.ts +62 -62
  530. package/dist/sdk/mcp/subscriptions.d.ts +26 -26
  531. package/dist/sdk/mcp/tasks.d.ts +51 -51
  532. package/dist/sdk/mcp/transport.d.ts +17 -17
  533. package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
  534. package/dist/sdk/merge/driver.d.ts +38 -38
  535. package/dist/sdk/merge/index.d.ts +5 -5
  536. package/dist/sdk/merge/install.d.ts +48 -48
  537. package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
  538. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  539. package/dist/sdk/merge/receipt-schema.d.ts +11 -11
  540. package/dist/sdk/merge/receipts.d.ts +111 -111
  541. package/dist/sdk/merge/reconcile.d.ts +20 -20
  542. package/dist/sdk/merge/three-way.d.ts +50 -50
  543. package/dist/sdk/merge/three-way.js +2 -2
  544. package/dist/sdk/merge/worktree-config.d.ts +3 -3
  545. package/dist/sdk/mutation-events.d.ts +62 -62
  546. package/dist/sdk/mutation-guard.d.ts +134 -134
  547. package/dist/sdk/notes.d.ts +28 -28
  548. package/dist/sdk/output/table-rows.d.ts +6 -6
  549. package/dist/sdk/output-contracts.d.ts +26 -26
  550. package/dist/sdk/output-projection.d.ts +108 -108
  551. package/dist/sdk/output-token-accounting.d.ts +18 -18
  552. package/dist/sdk/output.d.ts +18 -18
  553. package/dist/sdk/ownership-source.d.ts +1 -1
  554. package/dist/sdk/package-import-adapters.d.ts +51 -51
  555. package/dist/sdk/package-migrations.d.ts +3 -3
  556. package/dist/sdk/package-runtime-options.d.ts +3 -3
  557. package/dist/sdk/pagination.d.ts +28 -28
  558. package/dist/sdk/pagination.js +1 -1
  559. package/dist/sdk/profile.d.ts +72 -72
  560. package/dist/sdk/provenance.d.ts +37 -37
  561. package/dist/sdk/public-surface.json +1 -1
  562. package/dist/sdk/query/activity.d.ts +84 -84
  563. package/dist/sdk/query/aggregate.d.ts +109 -109
  564. package/dist/sdk/query/calendar.d.ts +95 -95
  565. package/dist/sdk/query/complete-list.d.ts +35 -35
  566. package/dist/sdk/query/context.d.ts +300 -300
  567. package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
  568. package/dist/sdk/query/get.d.ts +54 -54
  569. package/dist/sdk/query/history.d.ts +38 -38
  570. package/dist/sdk/query/item-filter-options.d.ts +41 -41
  571. package/dist/sdk/query/light-metadata.d.ts +1 -1
  572. package/dist/sdk/query/list-filter-shared.d.ts +4 -4
  573. package/dist/sdk/query/list.d.ts +167 -167
  574. package/dist/sdk/query/list.js +1 -1
  575. package/dist/sdk/query/multi-value-filters.d.ts +6 -6
  576. package/dist/sdk/query/next-ready-budget.d.ts +8 -8
  577. package/dist/sdk/query/next.d.ts +94 -94
  578. package/dist/sdk/query/parsers.d.ts +3 -3
  579. package/dist/sdk/query/projection-contracts.d.ts +18 -18
  580. package/dist/sdk/query/search/corpus.d.ts +15 -15
  581. package/dist/sdk/query/search/filters.d.ts +15 -15
  582. package/dist/sdk/query/search/input.d.ts +8 -8
  583. package/dist/sdk/query/search/lexical.d.ts +10 -10
  584. package/dist/sdk/query/search/response.d.ts +22 -22
  585. package/dist/sdk/query/search/semantic.d.ts +133 -133
  586. package/dist/sdk/query/search/types.d.ts +65 -65
  587. package/dist/sdk/query/search-contracts.d.ts +53 -53
  588. package/dist/sdk/query/search-pagination.d.ts +21 -21
  589. package/dist/sdk/query/search-rendering.d.ts +30 -30
  590. package/dist/sdk/query/search.d.ts +60 -60
  591. package/dist/sdk/query/workspace-contracts.d.ts +2 -2
  592. package/dist/sdk/query.d.ts +6 -6
  593. package/dist/sdk/read-output/continuation.d.ts +11 -11
  594. package/dist/sdk/read-output/extension.d.ts +3 -3
  595. package/dist/sdk/read-output/options.d.ts +7 -7
  596. package/dist/sdk/read-output/provenance.d.ts +6 -6
  597. package/dist/sdk/read-output-budget.d.ts +11 -11
  598. package/dist/sdk/read-output-contracts.d.ts +112 -112
  599. package/dist/sdk/read-output-contracts.js +1 -1
  600. package/dist/sdk/read-output-rows.d.ts +15 -15
  601. package/dist/sdk/read-output-session.d.ts +29 -29
  602. package/dist/sdk/relationship-analytics.d.ts +46 -46
  603. package/dist/sdk/relationship-context.d.ts +48 -48
  604. package/dist/sdk/relationship-history.d.ts +59 -59
  605. package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
  606. package/dist/sdk/relationship-migration.d.ts +14 -14
  607. package/dist/sdk/relationships.d.ts +46 -46
  608. package/dist/sdk/reproducibility/process.d.ts +9 -9
  609. package/dist/sdk/runtime/actions.d.ts +1 -1
  610. package/dist/sdk/runtime/context.d.ts +15 -15
  611. package/dist/sdk/runtime/schema-preview.d.ts +1 -1
  612. package/dist/sdk/runtime/schema.d.ts +1 -1
  613. package/dist/sdk/runtime-action-aliases.d.ts +3 -3
  614. package/dist/sdk/runtime-extended-actions.d.ts +9 -9
  615. package/dist/sdk/runtime-input.d.ts +29 -29
  616. package/dist/sdk/runtime-primitives.d.ts +53 -53
  617. package/dist/sdk/runtime-primitives.js +1 -1
  618. package/dist/sdk/runtime-public-contracts.d.ts +46 -46
  619. package/dist/sdk/runtime-stats-options.d.ts +1 -1
  620. package/dist/sdk/runtime.d.ts +374 -374
  621. package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
  622. package/dist/sdk/schema-migration.d.ts +79 -79
  623. package/dist/sdk/schema.d.ts +224 -224
  624. package/dist/sdk/search-refresh-worker.d.ts +1 -1
  625. package/dist/sdk/similarity-scoring.d.ts +10 -10
  626. package/dist/sdk/similarity.d.ts +73 -73
  627. package/dist/sdk/start-task-status.d.ts +1 -1
  628. package/dist/sdk/stats.d.ts +72 -72
  629. package/dist/sdk/structured-mutations.d.ts +13 -13
  630. package/dist/sdk/telemetry-flush.d.ts +1 -1
  631. package/dist/sdk/telemetry.d.ts +32 -32
  632. package/dist/sdk/templates.d.ts +35 -35
  633. package/dist/sdk/test/batch.d.ts +50 -50
  634. package/dist/sdk/test/command-args.d.ts +2 -2
  635. package/dist/sdk/test/entry.d.ts +4 -4
  636. package/dist/sdk/test/execution-receipts.d.ts +5 -5
  637. package/dist/sdk/test/execution.d.ts +247 -247
  638. package/dist/sdk/test/json-path.d.ts +4 -4
  639. package/dist/sdk/test/linked-command-detection.d.ts +36 -36
  640. package/dist/sdk/test/measurements.d.ts +10 -10
  641. package/dist/sdk/test/parsers.d.ts +18 -18
  642. package/dist/sdk/test/prerequisites.d.ts +3 -3
  643. package/dist/sdk/test/runs.d.ts +43 -43
  644. package/dist/sdk/test/trust.d.ts +15 -15
  645. package/dist/sdk/test/update.d.ts +23 -23
  646. package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
  647. package/dist/sdk/testing.d.ts +248 -248
  648. package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
  649. package/dist/sdk/traceability/source-traceability.d.ts +50 -50
  650. package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
  651. package/dist/sdk/workspace-contracts.d.ts +20 -20
  652. package/dist/sdk/workspace-memory.d.ts +42 -42
  653. package/dist/sdk/workspace-recipe.d.ts +9 -9
  654. package/dist/sdk/workspace-snapshot.d.ts +60 -60
  655. package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
  656. package/dist/sdk/workspace-transaction.d.ts +26 -26
  657. package/dist/sdk/workspace.d.ts +9 -9
  658. package/dist/types.d.ts +540 -540
  659. package/docs/COMMANDS.md +11 -2
  660. package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
  661. package/docs/LINKED_TEST_EDITS.md +15 -0
  662. package/docs/RELEASING.md +2 -0
  663. package/docs/TESTING.md +21 -1
  664. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +4 -3
  665. package/marketplace.json +1 -1
  666. package/package.json +3 -1
  667. package/packages/pm-beads/package.json +1 -1
  668. package/packages/pm-calendar/package.json +1 -1
  669. package/packages/pm-command-kit/package.json +1 -1
  670. package/packages/pm-digital-twin/package.json +1 -1
  671. package/packages/pm-governance-audit/package.json +1 -1
  672. package/packages/pm-guide-shell/package.json +1 -1
  673. package/packages/pm-kanban/package.json +1 -1
  674. package/packages/pm-lifecycle-hooks/package.json +1 -1
  675. package/packages/pm-linked-test-adapters/package.json +1 -1
  676. package/packages/pm-search-advanced/package.json +1 -1
  677. package/packages/pm-templates/package.json +1 -1
  678. package/packages/pm-todos/package.json +1 -1
  679. package/packages/pm-vcs/package.json +1 -1
  680. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  681. package/plugins/pm-claude/package.json +1 -1
  682. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  683. package/plugins/pm-codex/package.json +1 -1
  684. package/plugins/pm-codex/plugin.json +1 -1
  685. package/runtime-dependencies.json +1 -1
  686. package/scripts/finalize-build.mjs +9 -3
  687. package/dist/cli-bundle/chunks/chunk-66BZVFIK.js +0 -6
  688. package/dist/cli-bundle/chunks/chunk-IDEHMKYZ.js +0 -235
  689. package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
  690. package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
  691. package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
  692. package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
@@ -14,13 +14,13 @@ export * from "./governance/assurance-runtime.js";
14
14
  export * from "./governance/boundary-fixtures.js";
15
15
  export * from "./governance/defect-recurrence.js";
16
16
  export * from "./governance/defect-recurrence-coverage.js";
17
- export { runReindex, type ReindexOptions, type ReindexResult, } from "./governance/reindex.js";
17
+ export { runReindex,type ReindexOptions,type ReindexResult,} from "./governance/reindex.js";
18
18
  export * from "./governance/stale-work.js";
19
19
  export * from "./governance/storage-integrity.js";
20
20
  export * from "./governance/status-role-diagnostics.js";
21
21
  export * from "./governance/workspace-position.js";
22
22
  export * from "./governance/workflow-policy.js";
23
- export { runUpgrade, type UpgradeCliResult, type UpgradeCommandOptions, type UpgradeCommandRunner, type UpgradeCommandRunnerResult, type UpgradePackageResult, type UpgradeResult, } from "./governance/upgrade.js";
23
+ export { runUpgrade,type UpgradeCliResult,type UpgradeCommandOptions,type UpgradeCommandRunner,type UpgradeCommandRunnerResult,type UpgradePackageResult,type UpgradeResult,} from "./governance/upgrade.js";
24
24
  export * from "./governance/validate.js";
25
25
  export * from "./governance/closure-timestamps.js";
26
26
  export * from "./governance/linked-file-report.js";
@@ -1,106 +1,106 @@
1
- import { RelationshipGraph, RelationshipKindRegistry, type RelationshipEdge, type RelationshipKindDefinition } from "../relationships.js";
1
+ import { RelationshipGraph,RelationshipKindRegistry,type RelationshipEdge,type RelationshipKindDefinition } from "../relationships.js";
2
2
  /** Current portable relationship-graph snapshot format. */
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
6
  /** Snapshot format version. */
7
- version: number;
7
+ version:number;
8
8
  /** SHA-256 digest of nodes, edges, and relationship semantics. */
9
- fingerprint: string;
9
+ fingerprint:string;
10
10
  /** ISO timestamp describing when this portable projection was created. */
11
- created_at: string;
11
+ created_at:string;
12
12
  /** Deterministically ordered node identifiers. */
13
- nodes: readonly string[];
13
+ nodes:readonly string[];
14
14
  /** Deterministically ordered normalized relationship edges. */
15
- edges: readonly RelationshipEdge[];
15
+ edges:readonly RelationshipEdge[];
16
16
  /** Complete relationship ontology required to interpret the edges. */
17
- kinds: readonly RelationshipKindDefinition[];
17
+ kinds:readonly RelationshipKindDefinition[];
18
18
  }
19
19
  /** Common adapter operation context. */
20
20
  export interface RelationshipGraphAdapterContext {
21
21
  /** Adapter-owned workspace key; it need not be a filesystem path. */
22
- workspace: string;
22
+ workspace:string;
23
23
  /** Cooperative cancellation signal. */
24
- signal?: AbortSignal;
24
+ signal?:AbortSignal;
25
25
  }
26
26
  /** Compare-and-swap replacement context for one complete snapshot. */
27
27
  export interface RelationshipGraphAdapterReplaceContext extends RelationshipGraphAdapterContext {
28
28
  /** Validated snapshot that becomes the complete visible graph state. */
29
- snapshot: RelationshipGraphSnapshot;
29
+ snapshot:RelationshipGraphSnapshot;
30
30
  /** Expected prior fingerprint; null requires an empty workspace. */
31
- expected_fingerprint?: string | null;
31
+ expected_fingerprint?:string | null;
32
32
  }
33
33
  /** Storage-neutral graph snapshot adapter implemented by SDK packages. */
34
34
  export interface RelationshipGraphAdapter {
35
35
  /** Stable adapter identifier used in diagnostics. */
36
- readonly name: string;
36
+ readonly name:string;
37
37
  /** Read the current portable snapshot, or null when absent. */
38
- read(context: RelationshipGraphAdapterContext): Promise<unknown | null>;
38
+ read(context:RelationshipGraphAdapterContext):Promise<unknown | null>;
39
39
  /** Atomically replace the complete snapshot with optional CAS protection. */
40
- replace(context: RelationshipGraphAdapterReplaceContext): Promise<void>;
40
+ replace(context:RelationshipGraphAdapterReplaceContext):Promise<void>;
41
41
  /** Optionally clear a workspace with the same CAS semantics. */
42
- clear?(context: RelationshipGraphAdapterContext & {
43
- expected_fingerprint?: string | null;
44
- }): Promise<void>;
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
48
  /** Portable immutable snapshot. */
49
- snapshot: RelationshipGraphSnapshot;
49
+ snapshot:RelationshipGraphSnapshot;
50
50
  /** Registry reconstructed from the snapshot ontology. */
51
- registry: RelationshipKindRegistry;
51
+ registry:RelationshipKindRegistry;
52
52
  /** Executable graph reconstructed through the public kernel. */
53
- graph: RelationshipGraph;
53
+ graph:RelationshipGraph;
54
54
  }
55
55
  /** Result of synchronizing one snapshot into an adapter. */
56
56
  export interface RelationshipGraphAdapterSyncResult {
57
57
  /** Adapter identifier. */
58
- adapter: string;
58
+ adapter:string;
59
59
  /** Adapter-owned workspace key. */
60
- workspace: string;
60
+ workspace:string;
61
61
  /** Whether a write was required. */
62
- disposition: "current" | "written";
62
+ disposition:"current" | "written";
63
63
  /** New canonical snapshot fingerprint. */
64
- fingerprint: string;
64
+ fingerprint:string;
65
65
  /** Prior fingerprint when a snapshot existed. */
66
- previous_fingerprint?: string;
66
+ previous_fingerprint?:string;
67
67
  /** Portable node count. */
68
- node_count: number;
68
+ node_count:number;
69
69
  /** Portable edge count. */
70
- edge_count: number;
70
+ edge_count:number;
71
71
  }
72
72
  /** Build an immutable portable snapshot from a validated graph and registry. */
73
- export declare function createRelationshipGraphSnapshot(graph: RelationshipGraph, registry: RelationshipKindRegistry, options?: {
74
- createdAt?: string;
75
- }): RelationshipGraphSnapshot;
73
+ export declare function createRelationshipGraphSnapshot(graph:RelationshipGraph,registry:RelationshipKindRegistry,options?:{
74
+ createdAt?:string;
75
+ }):RelationshipGraphSnapshot;
76
76
  /** Decode and fully validate a portable graph snapshot. */
77
- export declare function parseRelationshipGraphSnapshot(value: unknown): LoadedRelationshipGraphSnapshot;
77
+ export declare function parseRelationshipGraphSnapshot(value:unknown):LoadedRelationshipGraphSnapshot;
78
78
  /** Read and validate one adapter workspace. */
79
- export declare function loadRelationshipGraphAdapter(adapter: RelationshipGraphAdapter, context: RelationshipGraphAdapterContext): Promise<LoadedRelationshipGraphSnapshot | null>;
79
+ export declare function loadRelationshipGraphAdapter(adapter:RelationshipGraphAdapter,context:RelationshipGraphAdapterContext):Promise<LoadedRelationshipGraphSnapshot | null>;
80
80
  /**
81
81
  * Synchronize a complete graph snapshot with compare-and-swap protection and
82
82
  * verify the adapter's visible read after replacement.
83
83
  */
84
- export declare function syncRelationshipGraphAdapter(adapter: RelationshipGraphAdapter, context: RelationshipGraphAdapterContext & {
85
- snapshot: RelationshipGraphSnapshot;
86
- }): Promise<RelationshipGraphAdapterSyncResult>;
84
+ export declare function syncRelationshipGraphAdapter(adapter:RelationshipGraphAdapter,context:RelationshipGraphAdapterContext & {
85
+ snapshot:RelationshipGraphSnapshot;
86
+ }):Promise<RelationshipGraphAdapterSyncResult>;
87
87
  /** Merge portable snapshots while rejecting semantic kind collisions. */
88
- export declare function federateRelationshipGraphSnapshots(values: readonly unknown[], options?: {
89
- createdAt?: string;
90
- }): RelationshipGraphSnapshot;
88
+ export declare function federateRelationshipGraphSnapshots(values:readonly unknown[],options?:{
89
+ createdAt?:string;
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
93
  #private;
94
94
  /** Stable adapter identifier used in diagnostics and conformance reports. */
95
- readonly name: string;
95
+ readonly name:string;
96
96
  /** Create a reference adapter with a stable diagnostic name. */
97
- constructor(name?: string);
97
+ constructor(name?:string);
98
98
  /** Read an isolated clone of the current workspace snapshot. */
99
- read(context: RelationshipGraphAdapterContext): Promise<RelationshipGraphSnapshot | null>;
99
+ read(context:RelationshipGraphAdapterContext):Promise<RelationshipGraphSnapshot | null>;
100
100
  /** Atomically replace one workspace after enforcing its expected fingerprint. */
101
- replace(context: RelationshipGraphAdapterReplaceContext): Promise<void>;
101
+ replace(context:RelationshipGraphAdapterReplaceContext):Promise<void>;
102
102
  /** Clear one workspace after enforcing its expected fingerprint. */
103
- clear(context: RelationshipGraphAdapterContext & {
104
- expected_fingerprint?: string | null;
105
- }): Promise<void>;
103
+ clear(context:RelationshipGraphAdapterContext & {
104
+ expected_fingerprint?:string | null;
105
+ }):Promise<void>;
106
106
  }
@@ -9,82 +9,82 @@
9
9
  * and reports exact cost metadata so agents can budget follow-up reads
10
10
  * without re-scanning the workspace.
11
11
  */
12
- import { RelationshipGraph, type RelationshipEdge, type RelationshipKindDefinition, type RelationshipQueryResult, type RelationshipTraversalDirection } from "../relationships.js";
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
15
  /** Lexicographically smallest member id, naming the community. */
16
- representative: string;
16
+ representative:string;
17
17
  /** Total member count. */
18
- size: number;
18
+ size:number;
19
19
  /** Sorted member node ids. */
20
- members: string[];
20
+ members:string[];
21
21
  }
22
22
  /** Bounded community-detection controls. */
23
23
  export interface GraphCommunityOptions {
24
24
  /** Registered relationship kinds whose edges define adjacency. */
25
- kinds?: readonly string[];
25
+ kinds?:readonly string[];
26
26
  /** Maximum label-propagation sweeps before reporting non-convergence; defaults to 16. */
27
- maxIterations?: number;
27
+ maxIterations?:number;
28
28
  /** Minimum member count for a reported community; defaults to 2. */
29
- minSize?: number;
29
+ minSize?:number;
30
30
  /** Abort signal checked once per sweep. */
31
- signal?: AbortSignal;
31
+ signal?:AbortSignal;
32
32
  }
33
33
  /** Deterministic label-propagation community analysis. */
34
34
  export interface RelationshipCommunityAnalysis {
35
35
  /** Detected communities, largest first and by representative within equal size. */
36
- communities: RelationshipCommunity[];
36
+ communities:RelationshipCommunity[];
37
37
  /** Label-propagation sweeps executed. */
38
- iterations: number;
38
+ iterations:number;
39
39
  /** Whether labels stabilized before the iteration bound stopped the sweep. */
40
- converged: boolean;
40
+ converged:boolean;
41
41
  }
42
42
  /** One stored edge implied by a longer same-family witness path. */
43
43
  export interface RedundantRelationshipEdge {
44
44
  /** The stored redundant edge in its original spelling. */
45
- edge: RelationshipEdge;
45
+ edge:RelationshipEdge;
46
46
  /** Semantic-orientation witness node path proving the implication, endpoints inclusive. */
47
- witness: string[];
47
+ witness:string[];
48
48
  }
49
49
  /** Bounded redundancy-scan controls. */
50
50
  export interface GraphRedundancyOptions {
51
51
  /** Directed ordering or hierarchy kinds to scan; defaults to every eligible registered kind. */
52
- kinds?: readonly string[];
52
+ kinds?:readonly string[];
53
53
  /** Maximum witness-path depth searched per edge; defaults to 8. */
54
- maxDepth?: number;
54
+ maxDepth?:number;
55
55
  /** Maximum reported redundant edges. */
56
- limit?: number;
56
+ limit?:number;
57
57
  /** Abort signal checked once per scanned edge. */
58
- signal?: AbortSignal;
58
+ signal?:AbortSignal;
59
59
  }
60
60
  /** One reachable node with its immediate dominator and gating weight. */
61
61
  export interface RelationshipDominatorRow {
62
62
  /** Reachable node id. */
63
- id: string;
63
+ id:string;
64
64
  /** Immediate dominator appearing on every root-to-node path. */
65
- idom: string;
65
+ idom:string;
66
66
  /** Nodes strictly dominated by this node — its dominator-subtree size minus itself. */
67
- dominatedCount: number;
67
+ dominatedCount:number;
68
68
  }
69
69
  /** Bounded dominator-analysis controls. */
70
70
  export interface GraphDominatorOptions {
71
71
  /** Registered relationship kinds whose edges define reachability. */
72
- kinds?: readonly string[];
72
+ kinds?:readonly string[];
73
73
  /** Traversal direction relative to each visited node; defaults to "outgoing". */
74
- direction?: RelationshipTraversalDirection;
74
+ direction?:RelationshipTraversalDirection;
75
75
  /** Maximum reachability depth from the root as a non-negative integer. */
76
- maxDepth?: number;
76
+ maxDepth?:number;
77
77
  /** Abort signal checked once per processed node. */
78
- signal?: AbortSignal;
78
+ signal?:AbortSignal;
79
79
  }
80
80
  /** Dominator-tree analysis of one node's reachable subgraph. */
81
81
  export interface RelationshipDominatorAnalysis {
82
82
  /** Analyzed root id. */
83
- root: string;
83
+ root:string;
84
84
  /** Reachable node count including the root. */
85
- reachableCount: number;
85
+ reachableCount:number;
86
86
  /** Non-root reachable rows sorted by gating weight, then id. */
87
- rows: RelationshipDominatorRow[];
87
+ rows:RelationshipDominatorRow[];
88
88
  }
89
89
  /**
90
90
  * Invoke `visit` once per canonical-kind-matched edge, skipping self-loops.
@@ -94,7 +94,7 @@ rows: RelationshipDominatorRow[];
94
94
  * directed and undirected families. This is the single edge-selection primitive
95
95
  * shared by community, centrality, cut-structure, and degree builders.
96
96
  */
97
- export declare function forEachMatchedRelationshipEdge(graph: RelationshipGraph, kinds: readonly string[] | undefined, visit: (edge: RelationshipEdge, definition: RelationshipKindDefinition) => void): void;
97
+ export declare function forEachMatchedRelationshipEdge(graph:RelationshipGraph,kinds:readonly string[] | undefined,visit:(edge:RelationshipEdge,definition:RelationshipKindDefinition) => void):void;
98
98
  /**
99
99
  * Detect communities with deterministic asynchronous label propagation: nodes
100
100
  * are swept in sorted order, each adopting the most frequent label among its
@@ -103,15 +103,15 @@ export declare function forEachMatchedRelationshipEdge(graph: RelationshipGraph,
103
103
  * participating edge connects both endpoints symmetrically and parallel edges
104
104
  * weight their neighbor. `meta.truncated` reports non-convergence.
105
105
  */
106
- export declare function detectRelationshipCommunities(graph: RelationshipGraph, options?: GraphCommunityOptions): RelationshipQueryResult<RelationshipCommunityAnalysis>;
106
+ export declare function detectRelationshipCommunities(graph:RelationshipGraph,options?:GraphCommunityOptions):RelationshipQueryResult<RelationshipCommunityAnalysis>;
107
107
  /** Decide whether a kind carries transitive semantics eligible for redundancy and duplicate analysis. */
108
- export declare function isTransitiveKind(definition: RelationshipKindDefinition): boolean;
108
+ export declare function isTransitiveKind(definition:RelationshipKindDefinition):boolean;
109
109
  /** Family grouping key joining a directed kind with its inverse spelling. */
110
- export declare function transitiveFamilyKey(definition: RelationshipKindDefinition): string;
110
+ export declare function transitiveFamilyKey(definition:RelationshipKindDefinition):string;
111
111
  /** Orient one transitive edge into its semantic forward direction. */
112
- export declare function orientTransitiveEdge(edge: RelationshipEdge, definition: RelationshipKindDefinition): {
113
- from: string;
114
- to: string;
112
+ export declare function orientTransitiveEdge(edge:RelationshipEdge,definition:RelationshipKindDefinition):{
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 —
@@ -121,7 +121,7 @@ to: string;
121
121
  * search is breadth-first, shortest and lexicographic first, bounded by
122
122
  * `maxDepth` per edge; `meta.truncated` reports only the `limit` bound.
123
123
  */
124
- export declare function findRedundantRelationshipEdges(graph: RelationshipGraph, options?: GraphRedundancyOptions): RelationshipQueryResult<RedundantRelationshipEdge[]>;
124
+ export declare function findRedundantRelationshipEdges(graph:RelationshipGraph,options?:GraphRedundancyOptions):RelationshipQueryResult<RedundantRelationshipEdge[]>;
125
125
  /**
126
126
  * Compute immediate dominators and gating weights over one node's reachable
127
127
  * subgraph using the Cooper–Harvey–Kennedy fixed-point. A node dominates the
@@ -130,4 +130,4 @@ export declare function findRedundantRelationshipEdges(graph: RelationshipGraph,
130
130
  * root's blast radius. Rows sort by gating weight, then id; `meta.truncated`
131
131
  * reports when the `maxDepth` bound excluded reachable nodes.
132
132
  */
133
- export declare function computeRelationshipDominators(graph: RelationshipGraph, root: string, options?: GraphDominatorOptions): RelationshipQueryResult<RelationshipDominatorAnalysis>;
133
+ export declare function computeRelationshipDominators(graph:RelationshipGraph,root:string,options?:GraphDominatorOptions):RelationshipQueryResult<RelationshipDominatorAnalysis>;
@@ -9,53 +9,53 @@
9
9
  * endpoints as placeholder nodes so bounded traversals can explain absent work
10
10
  * instead of silently dropping it.
11
11
  */
12
- import type { Dependency, ItemStatus } from "../../types/index.js";
13
- import { RelationshipGraph, type RelationshipKindRegistry } from "../relationships.js";
12
+ import type { Dependency,ItemStatus } from "../../types/index.js";
13
+ import { RelationshipGraph,type RelationshipKindRegistry } from "../relationships.js";
14
14
  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
18
  /** Stable item identifier. */
19
- id: string;
19
+ id:string;
20
20
  /** Lifecycle status used to separate actionable work from historical debt. */
21
- status: ItemStatus;
21
+ status:ItemStatus;
22
22
  /** Optional hierarchy parent reference. */
23
- parent?: string;
23
+ parent?:string;
24
24
  /** Optional legacy scalar blocker reference. */
25
- blocked_by?: string;
25
+ blocked_by?:string;
26
26
  /** Structured dependency edges. */
27
- dependencies?: Dependency[];
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
33
  /** Item that owns the reference. */
34
- holder_id: string;
34
+ holder_id:string;
35
35
  /** Missing referenced item id or legacy sentinel. */
36
- target_id: string;
36
+ target_id:string;
37
37
  /** Relationship field or dependency kind. */
38
- kind: string;
38
+ kind:string;
39
39
  /** Storage surface that owns the reference and determines its remediation. */
40
- source: DependencyReferenceSource;
40
+ source:DependencyReferenceSource;
41
41
  /** Current lifecycle status of the holder. */
42
- holder_status: ItemStatus;
42
+ holder_status:ItemStatus;
43
43
  /** Whether the holder is terminal and therefore historical, non-actionable debt. */
44
- legacy_terminal: boolean;
44
+ legacy_terminal:boolean;
45
45
  /** Whether the target is the pre-structured-dependency `no-active-blocker` sentinel. */
46
- no_active_blocker_sentinel: boolean;
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
50
  /** Missing references held by active items; these may affect scheduling and should gate validation. */
51
- active: DanglingDependencyReference[];
51
+ active:DanglingDependencyReference[];
52
52
  /** Missing references held only by terminal items; retained as informational history debt. */
53
- legacy_terminal: DanglingDependencyReference[];
53
+ legacy_terminal:DanglingDependencyReference[];
54
54
  /** Legacy sentinel rows across active and terminal holders, called out separately from typo-like ids. */
55
- no_active_blocker_sentinels: DanglingDependencyReference[];
55
+ no_active_blocker_sentinels:DanglingDependencyReference[];
56
56
  }
57
57
  /** Normalize a graph target while removing the historical no-blocker marker. */
58
- export declare function normalizeDependencyGraphTarget(target: unknown): string | undefined;
58
+ export declare function normalizeDependencyGraphTarget(target:unknown):string | undefined;
59
59
  /**
60
60
  * Resolve the default workspace relationship-kind registry: the built-in kinds
61
61
  * merged with every active extension-contributed relationship-kind
@@ -66,30 +66,30 @@ export declare function normalizeDependencyGraphTarget(target: unknown): string
66
66
  /** One raw stored dependency row duplicated verbatim on a single holder. */
67
67
  export interface DuplicateDependencyRow {
68
68
  /** Item that stores the duplicated row. */
69
- holder_id: string;
69
+ holder_id:string;
70
70
  /** Referenced target id in its first stored spelling. */
71
- target_id: string;
71
+ target_id:string;
72
72
  /** Stored relationship kind shared by every duplicate occurrence. */
73
- kind: string;
73
+ kind:string;
74
74
  /** Total stored occurrences of the identical row (always >= 2). */
75
- occurrences: number;
75
+ occurrences:number;
76
76
  /** Current lifecycle status of the holder. */
77
- holder_status: ItemStatus;
77
+ holder_status:ItemStatus;
78
78
  /** Whether the holder is terminal and the duplication is historical debt. */
79
- legacy_terminal: boolean;
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
83
  /** Item storing both contradictory representations. */
84
- holder_id: string;
84
+ holder_id:string;
85
85
  /** Target named by both the scalar blocker and structured dependency row. */
86
- target_id: string;
86
+ target_id:string;
87
87
  /** Structured ordering kind that places the holder before the target. */
88
- dependency_kind: string;
88
+ dependency_kind:string;
89
89
  /** Current lifecycle status of the holder. */
90
- holder_status: ItemStatus;
90
+ holder_status:ItemStatus;
91
91
  /** Whether the holder is terminal and the contradiction is historical debt. */
92
- legacy_terminal: boolean;
92
+ legacy_terminal:boolean;
93
93
  }
94
94
  /**
95
95
  * Collect raw stored dependency rows whose exact identity — holder, kind, and
@@ -98,7 +98,7 @@ legacy_terminal: boolean;
98
98
  * every projection built on it cannot see them; this pre-assembly scan is the
99
99
  * only surface that reports the storage-layer defect.
100
100
  */
101
- export declare function collectDuplicateDependencyRows(items: readonly DependencyReferenceHolder[], isTerminal?: (status: ItemStatus) => boolean): DuplicateDependencyRow[];
101
+ export declare function collectDuplicateDependencyRows(items:readonly DependencyReferenceHolder[],isTerminal?:(status:ItemStatus) => boolean):DuplicateDependencyRow[];
102
102
  /**
103
103
  * Collect storage rows where `blocked_by: target` places the target before the
104
104
  * holder while a same-target structured ordering dependency places the holder
@@ -106,7 +106,7 @@ export declare function collectDuplicateDependencyRows(items: readonly Dependenc
106
106
  * after graph assembly, so this pre-assembly evidence identifies the exact row
107
107
  * to remove instead of reporting only strongly connected component members.
108
108
  */
109
- export declare function collectOrderingStorageContradictions(items: readonly DependencyReferenceHolder[], isTerminal?: (status: ItemStatus) => boolean, registry?: RelationshipKindRegistry): OrderingStorageContradiction[];
109
+ export declare function collectOrderingStorageContradictions(items:readonly DependencyReferenceHolder[],isTerminal?:(status:ItemStatus) => boolean,registry?:RelationshipKindRegistry):OrderingStorageContradiction[];
110
110
  /**
111
111
  * Classify missing hierarchy and dependency targets without mutating their holders.
112
112
  *
@@ -114,52 +114,52 @@ export declare function collectOrderingStorageContradictions(items: readonly Dep
114
114
  * schemas receive the same active-versus-historical behavior as the built-in
115
115
  * closed/canceled statuses.
116
116
  */
117
- export declare function collectDanglingDependencyReferences(items: readonly DependencyReferenceHolder[], isTerminal?: (status: ItemStatus) => boolean): DanglingDependencyReferenceSummary;
117
+ export declare function collectDanglingDependencyReferences(items:readonly DependencyReferenceHolder[],isTerminal?:(status:ItemStatus) => boolean):DanglingDependencyReferenceSummary;
118
118
  /** Return unique real missing targets while excluding the legacy no-blocker sentinel. */
119
- export declare function collectMissingDependencyTargetIds(dangling: DanglingDependencyReferenceSummary): string[];
119
+ export declare function collectMissingDependencyTargetIds(dangling:DanglingDependencyReferenceSummary):string[];
120
120
  /** Return unique explicitly external dependency targets in deterministic order. */
121
- export declare function collectExternalDependencyTargetIds(items: readonly DependencyReferenceHolder[]): string[];
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
124
  /** Human-readable title projected into per-node details. */
125
- title: string;
125
+ title:string;
126
126
  /** Optional item type powering per-type coverage profiles and policies. */
127
- type?: string;
127
+ type?:string;
128
128
  }
129
129
  /** Compact node projection paired with the assembled graph. */
130
130
  export interface WorkspaceRelationshipNodeDetails {
131
131
  /** Stable node identifier. */
132
- id: string;
132
+ id:string;
133
133
  /** Human-readable node title, or a `[missing]` marker for absent endpoints. */
134
- title: string;
134
+ title:string;
135
135
  /** Lifecycle status, or the `missing` marker status for absent endpoints. */
136
- status: string;
136
+ status:string;
137
137
  /** Item type when the source item declared one; absent on missing placeholders. */
138
- type?: string;
138
+ type?:string;
139
139
  }
140
140
  /** Assembled workspace relationship graph with governance side-products. */
141
141
  export interface WorkspaceRelationshipAssembly {
142
142
  /** Deterministic relationship graph including missing placeholder nodes. */
143
- graph: RelationshipGraph;
143
+ graph:RelationshipGraph;
144
144
  /** Per-node compact details covering real and missing nodes. */
145
- details: WorkspaceRelationshipNodeDetails[];
145
+ details:WorkspaceRelationshipNodeDetails[];
146
146
  /** Lowercased identifiers of materialized missing endpoints. */
147
- missingIdSet: Set<string>;
147
+ missingIdSet:Set<string>;
148
148
  /** Dangling-reference classification computed during assembly. */
149
- dangling: DanglingDependencyReferenceSummary;
149
+ dangling:DanglingDependencyReferenceSummary;
150
150
  /** Raw same-identity duplicated dependency rows found before graph dedup. */
151
- duplicateRows: DuplicateDependencyRow[];
151
+ duplicateRows:DuplicateDependencyRow[];
152
152
  /** Scalar-versus-structured ordering contradictions found before graph normalization. */
153
- orderingContradictions?: OrderingStorageContradiction[];
153
+ orderingContradictions?:OrderingStorageContradiction[];
154
154
  /** Raw legacy alias rows grouped by accepted spelling before graph canonicalization. */
155
- legacyAliasCounts: Record<string, number>;
155
+ legacyAliasCounts:Record<string,number>;
156
156
  /** Shared hierarchy analysis retained across ordinary object spread copies. */
157
- hierarchyIntegrity?: HierarchyIntegrityAnalysis;
157
+ hierarchyIntegrity?:HierarchyIntegrityAnalysis;
158
158
  }
159
159
  /** Read the hierarchy analysis paired with an assembly created by this module. */
160
- export declare function getWorkspaceHierarchyIntegrity(assembly: WorkspaceRelationshipAssembly): HierarchyIntegrityAnalysis | undefined;
160
+ export declare function getWorkspaceHierarchyIntegrity(assembly:WorkspaceRelationshipAssembly):HierarchyIntegrityAnalysis | undefined;
161
161
  /** Count raw dependency rows that use a registered compatibility alias instead of its canonical kind. */
162
- export declare function collectLegacyDependencyAliasCounts(items: readonly DependencyReferenceHolder[], registry?: RelationshipKindRegistry): Record<string, number>;
162
+ export declare function collectLegacyDependencyAliasCounts(items:readonly DependencyReferenceHolder[],registry?:RelationshipKindRegistry):Record<string,number>;
163
163
  /**
164
164
  * Build the shared workspace relationship graph including missing placeholder
165
165
  * nodes. One assembly serves every bounded query in an invocation — dependency
@@ -167,4 +167,4 @@ export declare function collectLegacyDependencyAliasCounts(items: readonly Depen
167
167
  * audits — so the full-workspace normalization cost is paid once instead of
168
168
  * once per query surface.
169
169
  */
170
- export declare function assembleWorkspaceRelationshipGraph(items: readonly WorkspaceRelationshipItem[], isTerminal?: (status: ItemStatus) => boolean, registry?: RelationshipKindRegistry): WorkspaceRelationshipAssembly;
170
+ export declare function assembleWorkspaceRelationshipGraph(items:readonly WorkspaceRelationshipItem[],isTerminal?:(status:ItemStatus) => boolean,registry?:RelationshipKindRegistry):WorkspaceRelationshipAssembly;
@@ -1,16 +1,16 @@
1
1
  import type { ItemStatus } from "../../types/index.js";
2
2
  import { type RelationshipKindRegistry } from "../relationships.js";
3
- import type { WorkspaceRelationshipAssembly, WorkspaceRelationshipItem } from "./assembly.js";
3
+ import type { WorkspaceRelationshipAssembly,WorkspaceRelationshipItem } from "./assembly.js";
4
4
  /** Cache observability attached to graph result envelopes. */
5
5
  export interface GraphCacheMetadata {
6
6
  /** Truncated workspace graph fingerprint identifying the snapshot answered from. */
7
- fingerprint: string;
7
+ fingerprint:string;
8
8
  /** Whether the workspace assembly was reused from cache. */
9
- assembly: "hit" | "miss";
9
+ assembly:"hit" | "miss";
10
10
  /** Whether the full query result was reused from cache. */
11
- result: "hit" | "miss";
11
+ result:"hit" | "miss";
12
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";
13
+ durable?:"hit" | "miss" | "off";
14
14
  }
15
15
  /**
16
16
  * Compute the deterministic workspace graph fingerprint for one item snapshot.
@@ -19,15 +19,15 @@ durable?: "hit" | "miss" | "off";
19
19
  * folded in so schema changes to lifecycle semantics invalidate cached
20
20
  * assemblies even when raw statuses are unchanged.
21
21
  */
22
- export declare function computeWorkspaceGraphFingerprint(items: readonly WorkspaceRelationshipItem[], isTerminal?: (status: ItemStatus) => boolean, registry?: RelationshipKindRegistry): string;
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
25
  /** The (possibly reused) workspace assembly. */
26
- assembly: WorkspaceRelationshipAssembly;
26
+ assembly:WorkspaceRelationshipAssembly;
27
27
  /** Whether the assembly came from cache instead of being rebuilt. */
28
- assemblyReused: boolean;
28
+ assemblyReused:boolean;
29
29
  /** Full fingerprint of the snapshot this lookup is bound to. */
30
- fingerprint: string;
30
+ fingerprint:string;
31
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
@@ -35,9 +35,9 @@ fingerprint: string;
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;
38
+ memoize<T>(queryKey:string,compute:() => T):{
39
+ value:T;
40
+ reused:boolean;
41
41
  };
42
42
  }
43
43
  /**
@@ -50,20 +50,20 @@ reused: boolean;
50
50
  export declare class WorkspaceGraphCache {
51
51
  #private;
52
52
  /** Create a cache, optionally bounding workspaces and memoized results. */
53
- constructor(options?: {
54
- maxResultsPerWorkspace?: number;
55
- maxWorkspaces?: number;
53
+ constructor(options?:{
54
+ maxResultsPerWorkspace?:number;
55
+ maxWorkspaces?:number;
56
56
  });
57
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;
62
+ lookup(key:string,fingerprint:string,build:() => WorkspaceRelationshipAssembly):WorkspaceGraphCacheLookup;
63
63
  /** Drop every cached workspace entry and memoized result. */
64
- clear(): void;
64
+ clear():void;
65
65
  }
66
66
  /** Return the process-wide shared workspace graph cache. */
67
- export declare function workspaceGraphCache(): WorkspaceGraphCache;
67
+ export declare function workspaceGraphCache():WorkspaceGraphCache;
68
68
  /** Reset the process-wide shared workspace graph cache (tests and long-lived hosts). */
69
- export declare function resetWorkspaceGraphCache(): void;
69
+ export declare function resetWorkspaceGraphCache():void;
@@ -3,11 +3,11 @@ import type { RelationshipKindRegistry } from "../relationships.js";
3
3
  /** Minimal immutable item projection needed to compare relationship cardinality. */
4
4
  export interface RelationshipCardinalityItem {
5
5
  /** Canonical workspace item identity. */
6
- id: string;
6
+ id:string;
7
7
  /** Stored relationship rows, including their canonical kind and endpoint. */
8
- dependencies?: readonly Pick<Dependency, "id" | "kind">[];
8
+ dependencies?:readonly Pick<Dependency,"id" | "kind">[];
9
9
  }
10
10
  /** Share the workspace integrity lock for every kind that constrains edge multiplicity. */
11
- export declare function relationshipKindNeedsIntegrityLock(kind: string, registry: RelationshipKindRegistry): boolean;
11
+ export declare function relationshipKindNeedsIntegrityLock(kind:string,registry:RelationshipKindRegistry):boolean;
12
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;
13
+ export declare function assertNonHierarchyCardinalityMutationAllowed(before:readonly RelationshipCardinalityItem[],after:readonly RelationshipCardinalityItem[],registry?:RelationshipKindRegistry):void;