@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
@@ -1,491 +1,491 @@
1
1
  import type { GlobalOptions } from "../../core/shared/command-types.js";
2
2
  import { type DeadlineScheduleResult } from "./deadline-scheduling.js";
3
3
  import { type GraphCacheMetadata } from "./cache.js";
4
- import { type RelationshipAuditDelta, type RelationshipAuditReport } from "./governance.js";
4
+ import { type RelationshipAuditDelta,type RelationshipAuditReport } from "./governance.js";
5
5
  import type { RelationshipPopulationCoverage } from "./lifecycle-coverage.js";
6
6
  import { type RelationshipRemediationStep } from "./remediation.js";
7
- import { GRAPH_SUBCOMMAND_VALUES, type GraphSubcommand } from "../cli-contracts/enum-contracts.js";
7
+ import { GRAPH_SUBCOMMAND_VALUES,type GraphSubcommand } from "../cli-contracts/enum-contracts.js";
8
8
  import { type OutputProjectionDeclaration } from "../output-projection.js";
9
- export { GRAPH_SUBCOMMAND_VALUES, type GraphSubcommand };
9
+ export { GRAPH_SUBCOMMAND_VALUES,type GraphSubcommand };
10
10
  /** Documents the graph command options payload exchanged by command, SDK, and package integrations. */
11
11
  export interface GraphCommandOptions {
12
12
  /** Restricts traversal to registered relationship kinds (repeatable or comma-separated). */
13
- kind?: string | string[];
13
+ kind?:string | string[];
14
14
  /** Maximum traversal depth as a non-negative integer. */
15
- maxDepth?: string | number;
15
+ maxDepth?:string | number;
16
16
  /** Maximum returned rows per bounded collection. */
17
- limit?: string | number;
17
+ limit?:string | number;
18
18
  /** Resume a traversal after this previously returned node id. */
19
- after?: string;
19
+ after?:string;
20
20
  /** Edge orientation for paths and impact queries (outgoing, incoming, or both). */
21
- direction?: string;
21
+ direction?:string;
22
22
  /** Maximum enumerated paths for the paths subcommand. */
23
- maxPaths?: string | number;
23
+ maxPaths?:string | number;
24
24
  /** Maximum evidence sample entries per audit finding. */
25
- sample?: string | number;
25
+ sample?:string | number;
26
26
  /** Item ids treated as explicitly valid isolates by the audit. */
27
- exemptIsolate?: string | string[];
27
+ exemptIsolate?:string | string[];
28
28
  /** Item types whose active nodes are policy-valid isolates for the audit (repeatable or comma-separated). */
29
- exemptIsolateType?: string | string[];
29
+ exemptIsolateType?:string | string[];
30
30
  /** Persist the audit census as the change-since-baseline comparison point (audit only). */
31
- saveBaseline?: boolean;
31
+ saveBaseline?:boolean;
32
32
  /** Rebuild and warm the durable graph index (index only). */
33
- rebuild?: boolean;
33
+ rebuild?:boolean;
34
34
  /** Delete the durable graph index (index only). */
35
- clear?: boolean;
35
+ clear?:boolean;
36
36
  /** Return counts-first envelopes without row collections. */
37
- summary?: boolean;
37
+ summary?:boolean;
38
38
  /** Explicitly restore the complete row projection after a summary read. */
39
- full?: boolean;
39
+ full?:boolean;
40
40
  }
41
41
  /** Cost metadata attached to every graph query projection. */
42
42
  export interface GraphQueryCost {
43
43
  /** Nodes expanded while answering the query. */
44
- visited_nodes: number;
44
+ visited_nodes:number;
45
45
  /** Edges inspected while answering the query. */
46
- inspected_edges: number;
46
+ inspected_edges:number;
47
47
  }
48
48
  /** Result envelope for the transitive traversal subcommands. */
49
49
  export interface GraphTraversalResult {
50
50
  /** Executed graph subcommand. */
51
- subcommand: "ancestors" | "descendants" | "predecessors" | "successors";
51
+ subcommand:"ancestors" | "descendants" | "predecessors" | "successors";
52
52
  /** Canonical root item id. */
53
- root: string;
53
+ root:string;
54
54
  /** Total emitted node ids before summary suppression. */
55
- count: number;
55
+ count:number;
56
56
  /** Whether configured bounds omitted reachable work. */
57
- truncated: boolean;
57
+ truncated:boolean;
58
58
  /** Cursor resuming emission after the last returned node. */
59
- next_cursor?: string;
59
+ next_cursor?:string;
60
60
  /** Query cost metadata. */
61
- cost: GraphQueryCost;
61
+ cost:GraphQueryCost;
62
62
  /** Emitted node ids in deterministic breadth-first order; absent with summary. */
63
- ids?: string[];
63
+ ids?:string[];
64
64
  /** Cache observability for this invocation. */
65
- cache?: GraphCacheMetadata;
65
+ cache?:GraphCacheMetadata;
66
66
  }
67
67
  /** One enumerated path projected with relationship kinds instead of raw edges. */
68
68
  export interface GraphPathRow {
69
69
  /** Ordered node ids from source to target inclusive. */
70
- nodes: string[];
70
+ nodes:string[];
71
71
  /** Relationship kind of each traversed edge, in path order. */
72
- kinds: string[];
72
+ kinds:string[];
73
73
  /** Number of edges in the path. */
74
- length: number;
74
+ length:number;
75
75
  }
76
76
  /** Result envelope for the paths subcommand. */
77
77
  export interface GraphPathsResult {
78
78
  /** Executed graph subcommand. */
79
- subcommand: "paths";
79
+ subcommand:"paths";
80
80
  /** Canonical source item id. */
81
- root: string;
81
+ root:string;
82
82
  /** Canonical target item id. */
83
- target: string;
83
+ target:string;
84
84
  /** Traversal orientation used for the enumeration. */
85
- direction: string;
85
+ direction:string;
86
86
  /** Total enumerated paths before summary suppression. */
87
- count: number;
87
+ count:number;
88
88
  /** Whether depth, path-count, or safety bounds stopped the search early. */
89
- truncated: boolean;
89
+ truncated:boolean;
90
90
  /** Query cost metadata. */
91
- cost: GraphQueryCost;
91
+ cost:GraphQueryCost;
92
92
  /** Enumerated paths, shortest first; absent with summary. */
93
- paths?: GraphPathRow[];
93
+ paths?:GraphPathRow[];
94
94
  /** Cache observability for this invocation. */
95
- cache?: GraphCacheMetadata;
95
+ cache?:GraphCacheMetadata;
96
96
  }
97
97
  /** One affected item row in an impact projection. */
98
98
  export interface GraphImpactRow {
99
99
  /** Affected item id. */
100
- id: string;
100
+ id:string;
101
101
  /** Shortest relationship distance from the root. */
102
- distance: number;
102
+ distance:number;
103
103
  /** Exact node path explaining why the item is affected. */
104
- path: string[];
104
+ path:string[];
105
105
  }
106
106
  /** Result envelope for the impact subcommand. */
107
107
  export interface GraphImpactResult {
108
108
  /** Executed graph subcommand. */
109
- subcommand: "impact";
109
+ subcommand:"impact";
110
110
  /** Canonical impact-origin item id. */
111
- root: string;
111
+ root:string;
112
112
  /** Traversal orientation used for the blast-radius walk. */
113
- direction: string;
113
+ direction:string;
114
114
  /** Total affected items before summary suppression. */
115
- count: number;
115
+ count:number;
116
116
  /** Whether configured bounds omitted reachable work. */
117
- truncated: boolean;
117
+ truncated:boolean;
118
118
  /** Cursor resuming after the final returned affected item. */
119
- next_cursor?: string;
119
+ next_cursor?:string;
120
120
  /** Query cost metadata. */
121
- cost: GraphQueryCost;
121
+ cost:GraphQueryCost;
122
122
  /** Affected item rows ordered by discovery; absent with summary. */
123
- affected?: GraphImpactRow[];
123
+ affected?:GraphImpactRow[];
124
124
  /** Cache observability for this invocation. */
125
- cache?: GraphCacheMetadata;
125
+ cache?:GraphCacheMetadata;
126
126
  }
127
127
  /** Bounded execution-graph projection inside an analyze result. */
128
128
  export interface GraphExecutionSummary {
129
129
  /** Whether the order-bearing graph is acyclic. */
130
- acyclic: boolean;
130
+ acyclic:boolean;
131
131
  /** Nodes participating in the topological order. */
132
- ordered_node_count: number;
132
+ ordered_node_count:number;
133
133
  /** Number of parallelizable topological layers. */
134
- layer_count: number;
134
+ layer_count:number;
135
135
  /** Total items with no open prerequisites. */
136
- frontier_count: number;
136
+ frontier_count:number;
137
137
  /** Bounded prerequisite-free sample; absent with summary. */
138
- frontier?: string[];
138
+ frontier?:string[];
139
139
  /** Edge count of the longest execution path. */
140
- critical_path_length: number;
140
+ critical_path_length:number;
141
141
  /** Longest deterministic execution path; absent with summary. */
142
- critical_path?: string[];
142
+ critical_path?:string[];
143
143
  /** Total genuine ordering cycles. */
144
- cycle_count: number;
144
+ cycle_count:number;
145
145
  /** Bounded ordering-cycle sample; absent with summary. */
146
- cycles?: string[][];
146
+ cycles?:string[][];
147
147
  }
148
148
  /** Bounded knowledge-graph projection inside an analyze result. */
149
149
  export interface GraphKnowledgeSummary {
150
150
  /** Total weakly connected components. */
151
- component_count: number;
151
+ component_count:number;
152
152
  /** Node count of the largest component. */
153
- largest_component_size: number;
153
+ largest_component_size:number;
154
154
  /** Total nodes without any relationship edges. */
155
- orphan_count: number;
155
+ orphan_count:number;
156
156
  /** Bounded orphan sample; absent with summary. */
157
- orphans?: string[];
157
+ orphans?:string[];
158
158
  /** Bounded maximum-degree hubs; absent with summary. */
159
- hubs?: {
160
- id: string;
161
- degree: number;
159
+ hubs?:{
160
+ id:string;
161
+ degree:number;
162
162
  }[];
163
163
  }
164
164
  /** Unified hierarchy-integrity projection inside an analyze result. */
165
165
  export interface GraphHierarchySummary {
166
166
  /** Whether the structural hierarchy is acyclic. */
167
- acyclic: boolean;
167
+ acyclic:boolean;
168
168
  /** Total canonical parent-child evidence rows. */
169
- relation_count: number;
169
+ relation_count:number;
170
170
  /** Total strongly connected hierarchy components. */
171
- cycle_count: number;
171
+ cycle_count:number;
172
172
  /** Active hierarchy cycles that require remediation. */
173
- active_cycle_count?: number;
173
+ active_cycle_count?:number;
174
174
  /** Terminal-only hierarchy cycles retained as historical debt. */
175
- legacy_cycle_count?: number;
175
+ legacy_cycle_count?:number;
176
176
  /** Total children that resolve to more than one logical parent. */
177
- cardinality_violation_count: number;
177
+ cardinality_violation_count:number;
178
178
  /** Active one-parent cardinality violations. */
179
- active_cardinality_violation_count?: number;
179
+ active_cardinality_violation_count?:number;
180
180
  /** Terminal-only one-parent cardinality violations. */
181
- legacy_cardinality_violation_count?: number;
181
+ legacy_cardinality_violation_count?:number;
182
182
  /** Total scalar/dependency parent disagreements. */
183
- parent_divergence_count: number;
183
+ parent_divergence_count:number;
184
184
  /** Active scalar/dependency parent disagreements. */
185
- active_parent_divergence_count?: number;
185
+ active_parent_divergence_count?:number;
186
186
  /** Terminal-only scalar/dependency parent disagreements. */
187
- legacy_parent_divergence_count?: number;
187
+ legacy_parent_divergence_count?:number;
188
188
  /** Bounded hierarchy-cycle sample; absent with summary. */
189
- cycles?: string[][];
189
+ cycles?:string[][];
190
190
  }
191
191
  /** Result envelope for the analyze subcommand. */
192
192
  export interface GraphAnalyzeResult {
193
193
  /** Executed graph subcommand. */
194
- subcommand: "analyze";
194
+ subcommand:"analyze";
195
195
  /** Total indexed graph nodes. */
196
- node_count: number;
196
+ node_count:number;
197
197
  /** Total deduplicated graph edges. */
198
- edge_count: number;
198
+ edge_count:number;
199
199
  /** Counting convention used by edge_count. */
200
- edge_basis: "deduplicated_directed";
200
+ edge_basis:"deduplicated_directed";
201
201
  /** Bound applied to every sample collection. */
202
- sample_limit: number;
202
+ sample_limit:number;
203
203
  /** Execution-order analytics over registered ordering kinds. */
204
- execution: GraphExecutionSummary;
204
+ execution:GraphExecutionSummary;
205
205
  /** Structural analytics over every stored edge. */
206
- knowledge: GraphKnowledgeSummary;
206
+ knowledge:GraphKnowledgeSummary;
207
207
  /** Registry-driven structural hierarchy integrity across all storage surfaces. */
208
- hierarchy?: GraphHierarchySummary;
208
+ hierarchy?:GraphHierarchySummary;
209
209
  /** Cache observability for this invocation. */
210
- cache?: GraphCacheMetadata;
210
+ cache?:GraphCacheMetadata;
211
211
  }
212
212
  /** Result envelope for the audit subcommand. */
213
213
  export interface GraphAuditResult {
214
214
  /** Whether the row bound omitted findings; counts still describe the complete audit. */
215
- truncated?: boolean;
215
+ truncated?:boolean;
216
216
  /** Executed graph subcommand. */
217
- subcommand: "audit";
217
+ subcommand:"audit";
218
218
  /** Total audit findings. */
219
- finding_count: number;
219
+ finding_count:number;
220
220
  /** Finding counts keyed by severity. */
221
- findings_by_severity: Record<string, number>;
221
+ findings_by_severity:Record<string,number>;
222
222
  /** Finding-row counts keyed by finding code. Before 2026.7.19 this field incorrectly accumulated affected subjects; consumers of that unit must migrate to affected_subjects_by_code. */
223
- findings_by_code: Record<string, number>;
223
+ findings_by_code:Record<string,number>;
224
224
  /** Affected-subject counts keyed by severity. */
225
- affected_subjects_by_severity: Record<string, number>;
225
+ affected_subjects_by_severity:Record<string,number>;
226
226
  /** Affected-subject counts keyed by finding code. */
227
- affected_subjects_by_code: Record<string, number>;
227
+ affected_subjects_by_code:Record<string,number>;
228
228
  /** Structural coverage metrics; the duplicated finding census is absent with summary. */
229
- profile: Omit<RelationshipAuditReport["profile"], "finding_subjects_by_code"> & Partial<Pick<RelationshipAuditReport["profile"], "finding_subjects_by_code">>;
229
+ profile:Omit<RelationshipAuditReport["profile"],"finding_subjects_by_code"> & Partial<Pick<RelationshipAuditReport["profile"],"finding_subjects_by_code">>;
230
230
  /** Stored legacy relationship aliases grouped by spelling; canonical graph counts remain in profile. */
231
- legacy_alias_counts?: Record<string, number>;
231
+ legacy_alias_counts?:Record<string,number>;
232
232
  /** Ordered findings with bounded evidence samples; absent with summary. */
233
- findings?: RelationshipAuditReport["findings"];
233
+ findings?:RelationshipAuditReport["findings"];
234
234
  /** Signed change since the persisted census baseline; absent when no baseline exists. */
235
- baseline?: RelationshipAuditDelta;
235
+ baseline?:RelationshipAuditDelta;
236
236
  /** Cache observability for this invocation. */
237
- cache?: GraphCacheMetadata;
237
+ cache?:GraphCacheMetadata;
238
238
  }
239
239
  /** Result envelope for the durable-index maintenance subcommand. */
240
240
  export interface GraphIndexResult {
241
241
  /** Executed graph subcommand. */
242
- subcommand: "index";
242
+ subcommand:"index";
243
243
  /** Maintenance action performed by this invocation. */
244
- action: "status" | "rebuilt" | "cleared";
244
+ action:"status" | "rebuilt" | "cleared";
245
245
  /** Durable index disposition against the current workspace snapshot. */
246
- state: "fresh" | "stale" | "absent";
246
+ state:"fresh" | "stale" | "absent";
247
247
  /** Persisted deterministic query results in the envelope. */
248
- entry_count: number;
248
+ entry_count:number;
249
249
  /** Items in the current workspace snapshot. */
250
- item_count: number;
250
+ item_count:number;
251
251
  /** Item threshold above which implicit persistence activates. */
252
- min_items_threshold: number;
252
+ min_items_threshold:number;
253
253
  /** Whether queries on this workspace will persist results right now. */
254
- persist_enabled: boolean;
254
+ persist_enabled:boolean;
255
255
  /** Truncated fingerprint of the current workspace snapshot. */
256
- current_fingerprint: string;
256
+ current_fingerprint:string;
257
257
  /** ISO timestamp of the last persisted write, absent without an envelope. */
258
- saved_at?: string;
258
+ saved_at?:string;
259
259
  /** Envelope size in bytes, absent without an envelope. */
260
- bytes?: number;
260
+ bytes?:number;
261
261
  /** Cache observability; maintenance invocations never populate it. */
262
- cache?: GraphCacheMetadata;
262
+ cache?:GraphCacheMetadata;
263
263
  }
264
264
  /** One bounded community row projected by the communities subcommand. */
265
265
  export interface GraphCommunityRow {
266
266
  /** Lexicographically smallest member id, naming the community. */
267
- representative: string;
267
+ representative:string;
268
268
  /** Total member count before sampling. */
269
- size: number;
269
+ size:number;
270
270
  /** Bounded sorted member sample. */
271
- members: string[];
271
+ members:string[];
272
272
  }
273
273
  /** Result envelope for the communities subcommand. */
274
274
  export interface GraphCommunitiesResult {
275
275
  /** Executed graph subcommand. */
276
- subcommand: "communities";
276
+ subcommand:"communities";
277
277
  /** Total detected communities meeting the size floor. */
278
- community_count: number;
278
+ community_count:number;
279
279
  /** Member count of the largest community. */
280
- largest_community_size: number;
280
+ largest_community_size:number;
281
281
  /** Label-propagation sweeps executed. */
282
- iterations: number;
282
+ iterations:number;
283
283
  /** Whether labels stabilized before the iteration bound. */
284
- converged: boolean;
284
+ converged:boolean;
285
285
  /** Whether the iteration bound stopped propagation early or the sample bound omitted rows. */
286
- truncated: boolean;
286
+ truncated:boolean;
287
287
  /** Query cost metadata. */
288
- cost: GraphQueryCost;
288
+ cost:GraphQueryCost;
289
289
  /** Bounded community rows, largest first; absent with summary. */
290
- communities?: GraphCommunityRow[];
290
+ communities?:GraphCommunityRow[];
291
291
  /** Cache observability for this invocation. */
292
- cache?: GraphCacheMetadata;
292
+ cache?:GraphCacheMetadata;
293
293
  }
294
294
  /** One redundant stored edge projected with its witness path. */
295
295
  export interface GraphRedundancyRow {
296
296
  /** Stored edge source id. */
297
- source: string;
297
+ source:string;
298
298
  /** Stored edge target id. */
299
- target: string;
299
+ target:string;
300
300
  /** Stored relationship kind. */
301
- kind: string;
301
+ kind:string;
302
302
  /** Semantic-orientation node path proving the edge is implied. */
303
- witness: string[];
303
+ witness:string[];
304
304
  }
305
305
  /** Result envelope for the redundancy subcommand. */
306
306
  export interface GraphRedundancyResult {
307
307
  /** Executed graph subcommand. */
308
- subcommand: "redundancy";
308
+ subcommand:"redundancy";
309
309
  /** Total redundant edges found within configured bounds. */
310
- redundant_count: number;
310
+ redundant_count:number;
311
311
  /** Whether the row limit omitted further redundant edges. */
312
- truncated: boolean;
312
+ truncated:boolean;
313
313
  /** Query cost metadata. */
314
- cost: GraphQueryCost;
314
+ cost:GraphQueryCost;
315
315
  /** Redundant edge rows in deterministic scan order; absent with summary. */
316
- redundant?: GraphRedundancyRow[];
316
+ redundant?:GraphRedundancyRow[];
317
317
  /** Cache observability for this invocation. */
318
- cache?: GraphCacheMetadata;
318
+ cache?:GraphCacheMetadata;
319
319
  }
320
320
  /** One structural bottleneck row projected by the dominators subcommand. */
321
321
  export interface GraphDominatorRow {
322
322
  /** Bottleneck node id. */
323
- id: string;
323
+ id:string;
324
324
  /** Immediate dominator appearing on every root-to-node path. */
325
- idom: string;
325
+ idom:string;
326
326
  /** Reachable nodes strictly gated by this node. */
327
- dominated_count: number;
327
+ dominated_count:number;
328
328
  }
329
329
  /** Result envelope for the dominators subcommand. */
330
330
  export interface GraphDominatorsResult {
331
331
  /** Executed graph subcommand. */
332
- subcommand: "dominators";
332
+ subcommand:"dominators";
333
333
  /** Canonical analyzed root id. */
334
- root: string;
334
+ root:string;
335
335
  /** Traversal orientation used for reachability. */
336
- direction: string;
336
+ direction:string;
337
337
  /** Reachable node count including the root. */
338
- reachable_count: number;
338
+ reachable_count:number;
339
339
  /** Total nodes gating at least one other reachable node. */
340
- bottleneck_count: number;
340
+ bottleneck_count:number;
341
341
  /** Whether the depth bound cut reachability or the row limit omitted bottleneck rows. */
342
- truncated: boolean;
342
+ truncated:boolean;
343
343
  /** Query cost metadata. */
344
- cost: GraphQueryCost;
344
+ cost:GraphQueryCost;
345
345
  /** Bounded bottleneck rows, most-gating first; absent with summary. */
346
- bottlenecks?: GraphDominatorRow[];
346
+ bottlenecks?:GraphDominatorRow[];
347
347
  /** Cache observability for this invocation. */
348
- cache?: GraphCacheMetadata;
348
+ cache?:GraphCacheMetadata;
349
349
  }
350
350
  /** One scheduled task row projected by the slack subcommand. */
351
351
  export interface GraphScheduleRow {
352
352
  /** Scheduled task id. */
353
- id: string;
353
+ id:string;
354
354
  /** Earliest start (longest prerequisite distance). */
355
- earliest_start: number;
355
+ earliest_start:number;
356
356
  /** Latest start preserving the makespan. */
357
- latest_start: number;
357
+ latest_start:number;
358
358
  /** Total float: latest start minus earliest start. */
359
- slack: number;
359
+ slack:number;
360
360
  /** Whether the task lies on a critical path. */
361
- critical: boolean;
361
+ critical:boolean;
362
362
  }
363
363
  /** Result envelope for the critical-path slack subcommand. */
364
364
  export interface GraphSlackResult {
365
365
  /** Fresh estimate-based deadline constraints; computed outside topology caches. */
366
- deadline_schedule?: {
367
- population: "active";
368
- } & Omit<DeadlineScheduleResult, "rows" | "residuals" | "overcommitted"> & Partial<Pick<DeadlineScheduleResult, "rows" | "residuals" | "overcommitted">>;
366
+ deadline_schedule?:{
367
+ population:"active";
368
+ } & Omit<DeadlineScheduleResult,"rows" | "residuals" | "overcommitted"> & Partial<Pick<DeadlineScheduleResult,"rows" | "residuals" | "overcommitted">>;
369
369
  /** Executed graph subcommand. */
370
- subcommand: "slack";
370
+ subcommand:"slack";
371
371
  /** Whether the order-bearing graph is acyclic. */
372
- acyclic: boolean;
372
+ acyclic:boolean;
373
373
  /** Total makespan in unit task durations. */
374
- makespan: number;
374
+ makespan:number;
375
375
  /** Tasks participating in the order-bearing DAG. */
376
- scheduled_count: number;
376
+ scheduled_count:number;
377
377
  /** Tasks with zero slack. */
378
- critical_count: number;
378
+ critical_count:number;
379
379
  /** Edge count of the longest execution path. */
380
- critical_path_length: number;
380
+ critical_path_length:number;
381
381
  /** Genuine ordering cycles excluded from scheduling. */
382
- cycle_count: number;
382
+ cycle_count:number;
383
383
  /** Whether the row limit omitted scheduled tasks. */
384
- truncated: boolean;
384
+ truncated:boolean;
385
385
  /** Longest deterministic execution path; absent with summary. */
386
- critical_path?: string[];
386
+ critical_path?:string[];
387
387
  /** Bounded scheduled rows, lowest slack first; absent with summary. */
388
- rows?: GraphScheduleRow[];
388
+ rows?:GraphScheduleRow[];
389
389
  /** Cache observability for this invocation. */
390
- cache?: GraphCacheMetadata;
390
+ cache?:GraphCacheMetadata;
391
391
  }
392
392
  /** Compact lifecycle census returned by audit summary; detailed distributions restore with --full. */
393
- export interface GraphAuditSummaryResult extends Omit<GraphAuditResult, "profile"> {
393
+ export interface GraphAuditSummaryResult extends Omit<GraphAuditResult,"profile"> {
394
394
  /** Recorded population totals, structural verdicts, and lifecycle connectivity counts. */
395
- profile: Pick<GraphAuditResult["profile"], "nodes" | "recorded_nodes" | "edges" | "active_nodes" | "terminal_nodes" | "missing_nodes" | "ordering_acyclic" | "active_ordering_acyclic"> & {
395
+ profile:Pick<GraphAuditResult["profile"],"nodes" | "recorded_nodes" | "edges" | "active_nodes" | "terminal_nodes" | "missing_nodes" | "ordering_acyclic" | "active_ordering_acyclic"> & {
396
396
  /** Exact lifecycle counts; degree histograms and status/type distributions require full output. */
397
- coverage_by_lifecycle: Record<"all" | "active" | "terminal", Omit<RelationshipPopulationCoverage, "degree_histogram">>;
397
+ coverage_by_lifecycle:Record<"all" | "active" | "terminal",Omit<RelationshipPopulationCoverage,"degree_histogram">>;
398
398
  };
399
399
  }
400
400
  /** One node ranked by structural centrality with directed fan-in/fan-out. */
401
401
  export interface GraphCentralityRow {
402
402
  /** Node id. */
403
- id: string;
403
+ id:string;
404
404
  /** Undirected unique-neighbor degree. */
405
- degree: number;
405
+ degree:number;
406
406
  /** Distinct ordering predecessors that gate this node (dependency fan-in). */
407
- in_degree: number;
407
+ in_degree:number;
408
408
  /** Distinct ordering successors this node gates (dependency fan-out). */
409
- out_degree: number;
409
+ out_degree:number;
410
410
  /** Shortest-path betweenness centrality. */
411
- betweenness: number;
411
+ betweenness:number;
412
412
  /** Wasserman–Faust closeness centrality. */
413
- closeness: number;
413
+ closeness:number;
414
414
  }
415
415
  /** Result envelope for the centrality subcommand. */
416
416
  export interface GraphCentralityResult {
417
417
  /** Executed graph subcommand. */
418
- subcommand: "centrality";
418
+ subcommand:"centrality";
419
419
  /** Total indexed graph nodes. */
420
- node_count: number;
420
+ node_count:number;
421
421
  /** Simple undirected edge count over selected kinds. */
422
- edge_count: number;
422
+ edge_count:number;
423
423
  /** Counting convention used by edge_count. */
424
- edge_basis: "simple_undirected";
424
+ edge_basis:"simple_undirected";
425
425
  /** Whether the row limit omitted ranked nodes. */
426
- truncated: boolean;
426
+ truncated:boolean;
427
427
  /** Query cost metadata. */
428
- cost: GraphQueryCost;
428
+ cost:GraphQueryCost;
429
429
  /** Bounded ranked node rows, highest betweenness first; absent with summary. */
430
- rows?: GraphCentralityRow[];
430
+ rows?:GraphCentralityRow[];
431
431
  /** Cache observability for this invocation. */
432
- cache?: GraphCacheMetadata;
432
+ cache?:GraphCacheMetadata;
433
433
  }
434
434
  /** One bridge edge projected by the articulation subcommand. */
435
435
  export interface GraphBridgeRow {
436
436
  /** Lexicographically smaller endpoint. */
437
- source: string;
437
+ source:string;
438
438
  /** Lexicographically larger endpoint. */
439
- target: string;
439
+ target:string;
440
440
  }
441
441
  /** Result envelope for the articulation subcommand. */
442
442
  export interface GraphArticulationResult {
443
443
  /** Executed graph subcommand. */
444
- subcommand: "articulation";
444
+ subcommand:"articulation";
445
445
  /** Total articulation points (cut vertices). */
446
- articulation_count: number;
446
+ articulation_count:number;
447
447
  /** Total bridge edges (cut edges). */
448
- bridge_count: number;
448
+ bridge_count:number;
449
449
  /** Whether the row limit omitted articulation points or bridges. */
450
- truncated: boolean;
450
+ truncated:boolean;
451
451
  /** Query cost metadata. */
452
- cost: GraphQueryCost;
452
+ cost:GraphQueryCost;
453
453
  /** Bounded sorted articulation-point ids; absent with summary. */
454
- articulation_points?: string[];
454
+ articulation_points?:string[];
455
455
  /** Bounded sorted bridge edges; absent with summary. */
456
- bridges?: GraphBridgeRow[];
456
+ bridges?:GraphBridgeRow[];
457
457
  /** Cache observability for this invocation. */
458
- cache?: GraphCacheMetadata;
458
+ cache?:GraphCacheMetadata;
459
459
  }
460
460
  /** Result envelope for the dry-run remediation planning subcommand. */
461
461
  export interface GraphPlanResult {
462
462
  /** Executed graph subcommand. */
463
- subcommand: "plan";
463
+ subcommand:"plan";
464
464
  /** Total derived remediation proposals before row bounding. */
465
- step_count: number;
465
+ step_count:number;
466
466
  /** Proposal counts keyed by operation family. */
467
- steps_by_op: Record<string, number>;
467
+ steps_by_op:Record<string,number>;
468
468
  /** Proposal counts keyed by policy code. */
469
- steps_by_code: Record<string, number>;
469
+ steps_by_code:Record<string,number>;
470
470
  /** Total governance-audit findings the plan was derived from. */
471
- finding_count: number;
471
+ finding_count:number;
472
472
  /** Whether sample, scan, or row bounds omitted derivable proposals. */
473
- truncated: boolean;
473
+ truncated:boolean;
474
474
  /** Query cost metadata. */
475
- cost: GraphQueryCost;
475
+ cost:GraphQueryCost;
476
476
  /** Bounded proposal rows in audit severity order; absent with summary. */
477
- steps?: RelationshipRemediationStep[];
477
+ steps?:RelationshipRemediationStep[];
478
478
  /** Cache observability for this invocation. */
479
- cache?: GraphCacheMetadata;
479
+ cache?:GraphCacheMetadata;
480
480
  }
481
481
  /** Union of every graph subcommand result envelope. */
482
482
  export type GraphResult = GraphTraversalResult | GraphPathsResult | GraphImpactResult | GraphAnalyzeResult | GraphAuditResult | GraphCommunitiesResult | GraphRedundancyResult | GraphDominatorsResult | GraphSlackResult | GraphCentralityResult | GraphArticulationResult | GraphPlanResult | GraphIndexResult;
483
483
  /** Graph result with an explicit complete-or-summary row declaration. */
484
484
  export type ProjectedGraphResult = (GraphResult | GraphAuditSummaryResult) & {
485
485
  /** Self-describing row projection used to derive a bounded omission receipt. */
486
- projection: OutputProjectionDeclaration;
486
+ projection:OutputProjectionDeclaration;
487
487
  };
488
488
  /** Validate the graph subcommand and its positional-id requirements. */
489
- export declare function parseGraphSubcommand(raw: string, id: string | undefined, target: string | undefined): GraphSubcommand;
489
+ export declare function parseGraphSubcommand(raw:string,id:string | undefined,target:string | undefined):GraphSubcommand;
490
490
  /** Implements run graph for the public runtime surface of this module. */
491
- export declare function runGraph(subcommandRaw: string, id: string | undefined, target: string | undefined, options: GraphCommandOptions, global: GlobalOptions): Promise<ProjectedGraphResult>;
491
+ export declare function runGraph(subcommandRaw:string,id:string | undefined,target:string | undefined,options:GraphCommandOptions,global:GlobalOptions):Promise<ProjectedGraphResult>;