@unbrained/pm-cli 2026.10.14 → 2026.10.17

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 (753) hide show
  1. package/.agents/skills/pm-developer/references/COMMAND_PLAYBOOK.md +1 -1
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/AGENTS.md +1 -0
  4. package/CHANGELOG.md +74 -2
  5. package/dist/cli/after-command-context-usage.d.ts +7 -7
  6. package/dist/cli/argv-utils.d.ts +4 -4
  7. package/dist/cli/bundle-integrity.d.ts +16 -16
  8. package/dist/cli/command-namespaces.d.ts +1 -1
  9. package/dist/cli/commander-usage.d.ts +34 -34
  10. package/dist/cli/commands/governance/validate.d.ts +1 -1
  11. package/dist/cli/commands/history/history-compact.d.ts +1 -1
  12. package/dist/cli/commands/history/history-redact.d.ts +1 -1
  13. package/dist/cli/commands/history/history-repair.d.ts +1 -1
  14. package/dist/cli/commands/history/restore.d.ts +1 -1
  15. package/dist/cli/commands/lifecycle/close.d.ts +1 -1
  16. package/dist/cli/commands/lifecycle/copy.d.ts +1 -1
  17. package/dist/cli/commands/lifecycle/delete.d.ts +1 -1
  18. package/dist/cli/commands/lifecycle/focus.d.ts +1 -1
  19. package/dist/cli/commands/query/get.d.ts +1 -1
  20. package/dist/cli/commands/workspace/merge.d.ts +1 -1
  21. package/dist/cli/commands/workspace/schema.d.ts +1 -1
  22. package/dist/cli/context-intent-invocation.d.ts +1 -1
  23. package/dist/cli/description-stdin.d.ts +1 -1
  24. package/dist/cli/error-guidance.d.ts +119 -119
  25. package/dist/cli/extension-command-help.d.ts +64 -64
  26. package/dist/cli/extension-command-help.js +2 -2
  27. package/dist/cli/extension-command-options.d.ts +18 -16
  28. package/dist/cli/extension-command-options.js +1 -1
  29. package/dist/cli/extension-recovery.d.ts +13 -13
  30. package/dist/cli/help-content.d.ts +22 -22
  31. package/dist/cli/help-content.js +3 -3
  32. package/dist/cli/help-json-payload.d.ts +45 -45
  33. package/dist/cli/invocation-profile.d.ts +5 -5
  34. package/dist/cli/main.d.ts +217 -217
  35. package/dist/cli/migration-gates.d.ts +24 -24
  36. package/dist/cli/option-values.d.ts +1 -1
  37. package/dist/cli/public.d.ts +1 -1
  38. package/dist/cli/register-annotations.d.ts +2 -2
  39. package/dist/cli/register-assurance.d.ts +1 -1
  40. package/dist/cli/register-files-lookup.d.ts +1 -1
  41. package/dist/cli/register-history-activity.d.ts +1 -1
  42. package/dist/cli/register-history-author.d.ts +1 -1
  43. package/dist/cli/register-history-maintenance.d.ts +1 -1
  44. package/dist/cli/register-list-query.d.ts +7 -7
  45. package/dist/cli/register-list-query.js +3 -3
  46. package/dist/cli/register-mutation-options.d.ts +1 -1
  47. package/dist/cli/register-mutation.d.ts +4 -4
  48. package/dist/cli/register-mutation.js +2 -2
  49. package/dist/cli/register-operations.d.ts +75 -75
  50. package/dist/cli/register-operations.js +1 -1
  51. package/dist/cli/register-setup.d.ts +4 -4
  52. package/dist/cli/register-structured-mutation.d.ts +8 -13
  53. package/dist/cli/register-structured-mutation.js +1 -1
  54. package/dist/cli/runtime/activation.d.ts +23 -23
  55. package/dist/cli/runtime/invocation-options.d.ts +12 -12
  56. package/dist/cli/runtime/invocation-options.js +1 -1
  57. package/dist/cli/runtime/projection-retry.d.ts +1 -1
  58. package/dist/cli/runtime/selection.d.ts +16 -16
  59. package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
  60. package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
  61. package/dist/cli/schema/registration.d.ts +1 -1
  62. package/dist/cli/schema-registration-helpers.d.ts +2 -2
  63. package/dist/cli/stats-analytics-json.d.ts +1 -1
  64. package/dist/cli-bundle/bundle-manifest.json +1 -1
  65. package/dist/cli-bundle/chunks/{chunk-LKESCZEN.js → chunk-3QKI3XNX.js} +2 -2
  66. package/dist/cli-bundle/chunks/chunk-4PNPDT2N.js +236 -0
  67. package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-6ZDKKOKM.js} +28 -28
  68. package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-B5QVGCZX.js} +2 -2
  69. package/dist/cli-bundle/chunks/{chunk-5LU6PWA4.js → chunk-EA2CG7UM.js} +2 -2
  70. package/dist/cli-bundle/chunks/chunk-HY7FQ7QX.js +2 -0
  71. package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-J4LPQCET.js} +2 -2
  72. package/dist/cli-bundle/chunks/chunk-JS3B2M4D.js +6 -0
  73. package/dist/cli-bundle/chunks/chunk-O4YBC3OM.js +30 -0
  74. package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-OZCSXX4D.js} +63 -64
  75. package/dist/cli-bundle/chunks/chunk-VMCSTFSO.js +2 -0
  76. package/dist/cli-bundle/chunks/chunk-W3KZ22DW.js +2 -0
  77. package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-X2ONXFBP.js} +2 -2
  78. package/dist/cli-bundle/chunks/chunk-X53HM753.js +20 -0
  79. package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-RU3QZSAQ.js} +7 -7
  80. package/dist/cli-bundle/chunks/register-mutation-EQYMT32A.js +20 -0
  81. package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-VXBGE4XI.js} +2 -2
  82. package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-UUDEGFRO.js} +2 -2
  83. package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-2IOHHNRT.js} +2 -2
  84. package/dist/cli-bundle/focused-chunks/chunk-5JEFDEL3.js +166 -0
  85. package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-AH6NX6GM.js} +2 -2
  86. package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-E33QA7PK.js} +2 -2
  87. package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-FTUZ3JF2.js} +6 -6
  88. package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-JXR6UKFM.js} +3 -3
  89. package/dist/cli-bundle/focused-chunks/chunk-LDKX4KYJ.js +2 -0
  90. package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-MBQF6HT6.js} +2 -2
  91. package/dist/cli-bundle/focused-chunks/chunk-NZO7GOXD.js +20 -0
  92. package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-PYC7BF6Z.js} +2 -2
  93. package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-QOSVJDOO.js} +61 -62
  94. package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-RBLSY6ML.js} +2 -2
  95. package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-RHTH5ILM.js} +2 -2
  96. package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-SIGIGZCG.js} +3 -3
  97. package/dist/cli-bundle/focused-chunks/chunk-TRFVAWF2.js +26 -0
  98. package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-UNTQE37U.js} +2 -2
  99. package/dist/cli-bundle/main.js +22 -22
  100. package/dist/cli-bundle/sdk-authoring.js +1 -1
  101. package/dist/cli-bundle/sdk-contracts.js +2 -2
  102. package/dist/cli-bundle/sdk-core.js +23 -23
  103. package/dist/cli-bundle/sdk-governance.js +1 -1
  104. package/dist/cli-bundle/sdk-graph.js +1 -1
  105. package/dist/cli-bundle/sdk-merge.js +54 -54
  106. package/dist/cli-bundle/sdk-query.js +1 -1
  107. package/dist/cli-bundle/sdk-runtime.js +1 -1
  108. package/dist/cli-bundle/sdk-testing.js +1 -1
  109. package/dist/cli-bundle/sdk.js +7 -7
  110. package/dist/cli.d.ts +9 -9
  111. package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
  112. package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
  113. package/dist/core/config/nested-settings.d.ts +20 -20
  114. package/dist/core/config/positional-value.d.ts +9 -9
  115. package/dist/core/diagnostics/remediation.d.ts +7 -7
  116. package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
  117. package/dist/core/extensions/activation-summary.d.ts +30 -30
  118. package/dist/core/extensions/activation-transaction.d.ts +9 -9
  119. package/dist/core/extensions/capability-usage.d.ts +25 -25
  120. package/dist/core/extensions/command-hook-context.d.ts +15 -15
  121. package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
  122. package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
  123. package/dist/core/extensions/contribution-inventory.d.ts +24 -24
  124. package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
  125. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  126. package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
  127. package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
  128. package/dist/core/extensions/extension-policy.d.ts +62 -62
  129. package/dist/core/extensions/extension-registries.d.ts +8 -8
  130. package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
  131. package/dist/core/extensions/extension-types.d.ts +717 -702
  132. package/dist/core/extensions/extension-types.js +1 -1
  133. package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
  134. package/dist/core/extensions/flag-value-types.d.ts +32 -4
  135. package/dist/core/extensions/flag-value-types.js +1 -1
  136. package/dist/core/extensions/index.d.ts +34 -34
  137. package/dist/core/extensions/item-field-types.d.ts +3 -3
  138. package/dist/core/extensions/item-fields.d.ts +6 -6
  139. package/dist/core/extensions/loader.d.ts +66 -66
  140. package/dist/core/extensions/manifest-parser.d.ts +1 -1
  141. package/dist/core/extensions/manifest-schema.d.ts +13 -13
  142. package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
  143. package/dist/core/extensions/preflight-ownership.d.ts +3 -3
  144. package/dist/core/extensions/read-output-contract.d.ts +2 -2
  145. package/dist/core/extensions/registration-contracts.d.ts +12 -12
  146. package/dist/core/extensions/registration-contracts.js +1 -1
  147. package/dist/core/extensions/registration-validation.d.ts +6 -6
  148. package/dist/core/extensions/registration-values.d.ts +19 -19
  149. package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
  150. package/dist/core/extensions/runtime-registrations.d.ts +6 -6
  151. package/dist/core/extensions/service-ownership.d.ts +1 -1
  152. package/dist/core/extensions/version-compat.d.ts +9 -9
  153. package/dist/core/fs/atomic-create.d.ts +1 -1
  154. package/dist/core/fs/fs-utils.d.ts +12 -12
  155. package/dist/core/fs/host-environment-errors.d.ts +10 -10
  156. package/dist/core/fs/path-utils.d.ts +1 -1
  157. package/dist/core/governance/content-fields.d.ts +25 -25
  158. package/dist/core/governance/issue-codes.d.ts +16 -16
  159. package/dist/core/governance/metadata-coverage.d.ts +64 -64
  160. package/dist/core/history/digest.d.ts +5 -5
  161. package/dist/core/history/drift-cache.d.ts +2 -2
  162. package/dist/core/history/drift-scan.d.ts +18 -18
  163. package/dist/core/history/event-classification.d.ts +4 -4
  164. package/dist/core/history/event-index.d.ts +33 -33
  165. package/dist/core/history/history-compact-bulk.d.ts +12 -12
  166. package/dist/core/history/history-diff.d.ts +15 -15
  167. package/dist/core/history/history-rewrite.d.ts +43 -43
  168. package/dist/core/history/history-storage-stats.d.ts +20 -20
  169. package/dist/core/history/history-stream-policy.d.ts +12 -12
  170. package/dist/core/history/history.d.ts +45 -45
  171. package/dist/core/history/identity.d.ts +4 -4
  172. package/dist/core/history/operation-contract.d.ts +17 -17
  173. package/dist/core/history/projection.d.ts +16 -16
  174. package/dist/core/history/read.d.ts +4 -4
  175. package/dist/core/history/replay.d.ts +47 -47
  176. package/dist/core/history/tombstone.d.ts +1 -1
  177. package/dist/core/history/version-address.d.ts +2 -2
  178. package/dist/core/history/workspace-history.d.ts +72 -72
  179. package/dist/core/io/body-file.d.ts +2 -2
  180. package/dist/core/io/bulk-ids-input.d.ts +7 -7
  181. package/dist/core/item/actionability.d.ts +30 -30
  182. package/dist/core/item/dependency-reference.d.ts +2 -2
  183. package/dist/core/item/id.d.ts +9 -9
  184. package/dist/core/item/item-format-version.d.ts +17 -15
  185. package/dist/core/item/item-format-version.js +1 -1
  186. package/dist/core/item/item-format.d.ts +54 -54
  187. package/dist/core/item/item-format.js +3 -3
  188. package/dist/core/item/item-record.d.ts +1 -1
  189. package/dist/core/item/item-type-definition.d.ts +11 -11
  190. package/dist/core/item/parent-reference-policy.d.ts +6 -6
  191. package/dist/core/item/parse.d.ts +37 -37
  192. package/dist/core/item/plan-lifecycle.d.ts +4 -4
  193. package/dist/core/item/priority.d.ts +3 -3
  194. package/dist/core/item/sprint-release-format.d.ts +4 -4
  195. package/dist/core/item/status-filter.d.ts +5 -5
  196. package/dist/core/item/status.d.ts +3 -3
  197. package/dist/core/item/toon-decode.d.ts +10 -10
  198. package/dist/core/item/type-registry.d.ts +35 -35
  199. package/dist/core/item/type-synonyms.d.ts +2 -2
  200. package/dist/core/lock/lock-gc.d.ts +28 -28
  201. package/dist/core/lock/lock.d.ts +53 -53
  202. package/dist/core/output/mutation-projection.d.ts +4 -25
  203. package/dist/core/output/mutation-projection.js +1 -1
  204. package/dist/core/output/output-control.d.ts +4 -4
  205. package/dist/core/output/output.d.ts +30 -30
  206. package/dist/core/output/query-summary.d.ts +5 -5
  207. package/dist/core/output/tabular.d.ts +3 -3
  208. package/dist/core/packages/manifest.d.ts +30 -30
  209. package/dist/core/packages/root.d.ts +4 -4
  210. package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
  211. package/dist/core/policy/workflow-policy-store.d.ts +15 -15
  212. package/dist/core/policy/workflow-policy.d.ts +56 -56
  213. package/dist/core/profile/profile-describe.d.ts +22 -22
  214. package/dist/core/profile/profile-lint.d.ts +13 -13
  215. package/dist/core/profile/profile-plan.d.ts +45 -45
  216. package/dist/core/profile/profile-presets.d.ts +36 -36
  217. package/dist/core/reproducibility/context.d.ts +9 -9
  218. package/dist/core/schema/fields-file.d.ts +35 -35
  219. package/dist/core/schema/item-types-file.d.ts +29 -29
  220. package/dist/core/schema/runtime-field-filters.d.ts +3 -3
  221. package/dist/core/schema/runtime-field-values.d.ts +7 -7
  222. package/dist/core/schema/runtime-schema.d.ts +59 -59
  223. package/dist/core/schema/status-defs-file.d.ts +29 -29
  224. package/dist/core/schema/status-token.d.ts +1 -1
  225. package/dist/core/schema/type-inference.d.ts +10 -10
  226. package/dist/core/schema/type-presets.d.ts +5 -5
  227. package/dist/core/schema/type-workflows.d.ts +15 -15
  228. package/dist/core/schema/type-workflows.js +1 -1
  229. package/dist/core/search/background-refresh.d.ts +12 -12
  230. package/dist/core/search/bm25.d.ts +16 -16
  231. package/dist/core/search/cache.d.ts +34 -34
  232. package/dist/core/search/corpus.d.ts +17 -17
  233. package/dist/core/search/embedding-batches.d.ts +25 -25
  234. package/dist/core/search/eval-thresholds.d.ts +4 -4
  235. package/dist/core/search/eval.d.ts +40 -40
  236. package/dist/core/search/http-client.d.ts +24 -24
  237. package/dist/core/search/providers.d.ts +30 -30
  238. package/dist/core/search/relevance.d.ts +17 -17
  239. package/dist/core/search/semantic-defaults.d.ts +5 -5
  240. package/dist/core/search/staleness.d.ts +3 -3
  241. package/dist/core/search/vector-stores.d.ts +51 -51
  242. package/dist/core/search/vectorization-metadata.d.ts +9 -9
  243. package/dist/core/sentry/helpers.d.ts +27 -27
  244. package/dist/core/sentry/instrument.d.ts +51 -51
  245. package/dist/core/sentry/instrument.js +1 -1
  246. package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
  247. package/dist/core/sentry/sensitive-assignments.js +2 -0
  248. package/dist/core/session/session-state.d.ts +37 -37
  249. package/dist/core/shared/agent-session-context.d.ts +14 -14
  250. package/dist/core/shared/author.d.ts +89 -89
  251. package/dist/core/shared/command-line.d.ts +3 -3
  252. package/dist/core/shared/command-types.d.ts +20 -20
  253. package/dist/core/shared/conflict-markers.d.ts +5 -5
  254. package/dist/core/shared/constants.d.ts +30 -30
  255. package/dist/core/shared/errors.d.ts +100 -100
  256. package/dist/core/shared/html-entity-decode.d.ts +2 -2
  257. package/dist/core/shared/item-metadata-contract.d.ts +2 -2
  258. package/dist/core/shared/lazy-module.d.ts +1 -1
  259. package/dist/core/shared/levenshtein.d.ts +1 -1
  260. package/dist/core/shared/memo.d.ts +1 -1
  261. package/dist/core/shared/numeric-parsers.d.ts +1 -1
  262. package/dist/core/shared/option-alias-visibility.d.ts +3 -3
  263. package/dist/core/shared/primitives.d.ts +13 -13
  264. package/dist/core/shared/secret-rules.d.ts +92 -92
  265. package/dist/core/shared/serial-queue.d.ts +6 -6
  266. package/dist/core/shared/serialization.d.ts +4 -4
  267. package/dist/core/shared/split-comma-list.d.ts +4 -4
  268. package/dist/core/shared/text-normalization.d.ts +5 -3
  269. package/dist/core/shared/text-normalization.js +1 -1
  270. package/dist/core/shared/time.d.ts +27 -27
  271. package/dist/core/store/item-format-migration.d.ts +7 -7
  272. package/dist/core/store/item-metadata-cache.d.ts +30 -30
  273. package/dist/core/store/item-metadata-query-index.d.ts +66 -66
  274. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  275. package/dist/core/store/item-mutation-precondition.d.ts +11 -0
  276. package/dist/core/store/item-mutation-precondition.js +2 -0
  277. package/dist/core/store/item-store.d.ts +123 -123
  278. package/dist/core/store/item-store.js +1 -1
  279. package/dist/core/store/paths.d.ts +27 -27
  280. package/dist/core/store/settings-concurrency.d.ts +1 -1
  281. package/dist/core/store/settings-read-cache.d.ts +11 -11
  282. package/dist/core/store/settings-validator.d.ts +117 -117
  283. package/dist/core/store/settings.d.ts +84 -84
  284. package/dist/core/store/sqlite-runtime.d.ts +2 -2
  285. package/dist/core/store/tracker-preflight.d.ts +3 -3
  286. package/dist/core/telemetry/consent.d.ts +1 -1
  287. package/dist/core/telemetry/observability.d.ts +16 -16
  288. package/dist/core/telemetry/policy.d.ts +7 -7
  289. package/dist/core/telemetry/read-sampling.d.ts +1 -1
  290. package/dist/core/telemetry/runtime.d.ts +275 -275
  291. package/dist/core/test/background-runs.d.ts +123 -123
  292. package/dist/core/test/item-test-run-tracking.d.ts +10 -10
  293. package/dist/core/test/run-selectors.d.ts +12 -12
  294. package/dist/core/validate/estimate-defaults.d.ts +3 -3
  295. package/dist/core/validate/fix-planning.d.ts +36 -36
  296. package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
  297. package/dist/core/validate/missing-by-type.d.ts +3 -3
  298. package/dist/core/validate/missing-link-owners.d.ts +17 -17
  299. package/dist/core/validate/stale-file-classification.d.ts +6 -6
  300. package/dist/mcp/http-server.d.ts +26 -26
  301. package/dist/mcp/legacy-adapter.d.ts +18 -18
  302. package/dist/mcp/runtime-capabilities.d.ts +18 -18
  303. package/dist/mcp/server.d.ts +73 -73
  304. package/dist/mcp/server.js +1 -1
  305. package/dist/mcp/tool-definitions.d.ts +27 -27
  306. package/dist/mcp/tool-definitions.js +1 -1
  307. package/dist/sdk/actionability.d.ts +1 -1
  308. package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
  309. package/dist/sdk/agent/command-recovery.d.ts +5 -5
  310. package/dist/sdk/agent/command-suggestions.d.ts +4 -4
  311. package/dist/sdk/agent/create-option-policy.d.ts +2 -2
  312. package/dist/sdk/agent/identity-config.d.ts +18 -18
  313. package/dist/sdk/agent/item-addressing.d.ts +6 -6
  314. package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
  315. package/dist/sdk/agent/refusal-closure.d.ts +22 -22
  316. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
  317. package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
  318. package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
  319. package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
  320. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
  321. package/dist/sdk/agent-capability-contracts.d.ts +41 -41
  322. package/dist/sdk/agent-session-context.d.ts +1 -1
  323. package/dist/sdk/annotations.d.ts +74 -74
  324. package/dist/sdk/author-attribution.d.ts +47 -47
  325. package/dist/sdk/authoring.d.ts +9 -9
  326. package/dist/sdk/cli-bootstrap.d.ts +65 -65
  327. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
  328. package/dist/sdk/cli-contracts/agent-output-contracts.js +1 -1
  329. package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
  330. package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
  331. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
  332. package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
  333. package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
  334. package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
  335. package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
  336. package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
  337. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  338. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
  339. package/dist/sdk/cli-contracts/flag-lexicon-contracts.js +1 -1
  340. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
  341. package/dist/sdk/cli-contracts/registration-helpers.d.ts +57 -57
  342. package/dist/sdk/cli-contracts/registration-helpers.js +1 -1
  343. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
  344. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  345. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
  346. package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
  347. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
  348. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
  349. package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
  350. package/dist/sdk/cli-contracts/tool-schema.js +1 -1
  351. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
  352. package/dist/sdk/cli-contracts.d.ts +15 -15
  353. package/dist/sdk/cli-program.d.ts +1 -1
  354. package/dist/sdk/cli-program.js +1 -1
  355. package/dist/sdk/command-line.d.ts +3 -3
  356. package/dist/sdk/comments.d.ts +24 -24
  357. package/dist/sdk/compile-cache.d.ts +4 -4
  358. package/dist/sdk/completion/bash.d.ts +1 -1
  359. package/dist/sdk/completion/fish.d.ts +1 -1
  360. package/dist/sdk/completion/shared.d.ts +74 -74
  361. package/dist/sdk/completion/zsh.d.ts +1 -1
  362. package/dist/sdk/completion.d.ts +3 -3
  363. package/dist/sdk/compose.d.ts +94 -94
  364. package/dist/sdk/config.d.ts +105 -105
  365. package/dist/sdk/context/recency.d.ts +1 -1
  366. package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
  367. package/dist/sdk/context/usage-egress.d.ts +1 -1
  368. package/dist/sdk/context/usage-ledger.d.ts +18 -18
  369. package/dist/sdk/context-intent-contracts.d.ts +37 -37
  370. package/dist/sdk/context-intent-contracts.js +1 -1
  371. package/dist/sdk/context-intent-runtime.d.ts +10 -10
  372. package/dist/sdk/context-packing.d.ts +44 -44
  373. package/dist/sdk/context-relevance.d.ts +110 -110
  374. package/dist/sdk/context-signal-store.d.ts +52 -52
  375. package/dist/sdk/context-usage.d.ts +78 -78
  376. package/dist/sdk/contracts.d.ts +2 -1
  377. package/dist/sdk/contracts.js +1 -1
  378. package/dist/sdk/core-governance.d.ts +5 -5
  379. package/dist/sdk/core.d.ts +9 -8
  380. package/dist/sdk/core.js +1 -1
  381. package/dist/sdk/corpus-shape.d.ts +60 -60
  382. package/dist/sdk/define.d.ts +36 -36
  383. package/dist/sdk/dependencies.d.ts +70 -70
  384. package/dist/sdk/dependency-flag-validation.d.ts +17 -17
  385. package/dist/sdk/dependency-provenance.d.ts +22 -22
  386. package/dist/sdk/docs.d.ts +17 -17
  387. package/dist/sdk/duplicates.d.ts +14 -14
  388. package/dist/sdk/environment/agent-environment.d.ts +118 -118
  389. package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
  390. package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
  391. package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
  392. package/dist/sdk/environment/source-context.d.ts +4 -4
  393. package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
  394. package/dist/sdk/error-code-catalog.d.ts +33 -33
  395. package/dist/sdk/error-runtime.d.ts +5 -5
  396. package/dist/sdk/errors.d.ts +17 -17
  397. package/dist/sdk/eval.d.ts +27 -27
  398. package/dist/sdk/extension/author-manifest.d.ts +9 -9
  399. package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
  400. package/dist/sdk/extension/concurrency.d.ts +1 -1
  401. package/dist/sdk/extension/copy-scope.d.ts +1 -1
  402. package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
  403. package/dist/sdk/extension/describe.d.ts +21 -21
  404. package/dist/sdk/extension/doctor.d.ts +46 -46
  405. package/dist/sdk/extension/install-plan.d.ts +32 -32
  406. package/dist/sdk/extension/install-receipts.d.ts +4 -4
  407. package/dist/sdk/extension/install-runtime.d.ts +12 -12
  408. package/dist/sdk/extension/install-snapshot.d.ts +10 -10
  409. package/dist/sdk/extension/install-sources.d.ts +106 -106
  410. package/dist/sdk/extension/managed-state.d.ts +42 -42
  411. package/dist/sdk/extension/managed-update-status.d.ts +1 -1
  412. package/dist/sdk/extension/migrations.d.ts +48 -48
  413. package/dist/sdk/extension/output-ownership.d.ts +19 -19
  414. package/dist/sdk/extension/runtime-summary.d.ts +7 -7
  415. package/dist/sdk/extension/scaffold.d.ts +15 -15
  416. package/dist/sdk/extension/shared.d.ts +16 -16
  417. package/dist/sdk/extension/source-resolution.d.ts +16 -16
  418. package/dist/sdk/extension/static-inventory.d.ts +23 -23
  419. package/dist/sdk/extension/update-check.d.ts +9 -9
  420. package/dist/sdk/extension-command-context.d.ts +1 -1
  421. package/dist/sdk/extension-contracts.d.ts +10 -10
  422. package/dist/sdk/extension.d.ts +221 -221
  423. package/dist/sdk/files.d.ts +101 -101
  424. package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
  425. package/dist/sdk/flag-invocation-contracts.js +1 -1
  426. package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
  427. package/dist/sdk/generated/generated-error-code-catalog-part-1.js +1 -1
  428. package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
  429. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  430. package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
  431. package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
  432. package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
  433. package/dist/sdk/governance/assurance-action.d.ts +46 -46
  434. package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
  435. package/dist/sdk/governance/assurance-presets.d.ts +25 -25
  436. package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
  437. package/dist/sdk/governance/assurance.d.ts +204 -204
  438. package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
  439. package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
  440. package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
  441. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
  442. package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
  443. package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
  444. package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
  445. package/dist/sdk/governance/extension-host-version.d.ts +9 -9
  446. package/dist/sdk/governance/gc.d.ts +26 -26
  447. package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
  448. package/dist/sdk/governance/health.d.ts +172 -172
  449. package/dist/sdk/governance/health.js +1 -1
  450. package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
  451. package/dist/sdk/governance/linked-file-report.d.ts +15 -15
  452. package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
  453. package/dist/sdk/governance/provenance-health.d.ts +35 -35
  454. package/dist/sdk/governance/reindex.d.ts +102 -102
  455. package/dist/sdk/governance/reliability.d.ts +29 -29
  456. package/dist/sdk/governance/stale-work.d.ts +13 -13
  457. package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
  458. package/dist/sdk/governance/storage-integrity.d.ts +28 -28
  459. package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
  460. package/dist/sdk/governance/upgrade.d.ts +77 -77
  461. package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
  462. package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
  463. package/dist/sdk/governance/validate-normalization.d.ts +4 -4
  464. package/dist/sdk/governance/validate.d.ts +176 -176
  465. package/dist/sdk/governance/validate.js +1 -1
  466. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  467. package/dist/sdk/governance/workflow-policy.d.ts +18 -18
  468. package/dist/sdk/governance/workspace-position.d.ts +40 -40
  469. package/dist/sdk/governance.d.ts +2 -2
  470. package/dist/sdk/graph/adapter.d.ts +45 -45
  471. package/dist/sdk/graph/analytics.d.ts +36 -36
  472. package/dist/sdk/graph/assembly.d.ts +51 -51
  473. package/dist/sdk/graph/cache.d.ts +19 -19
  474. package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
  475. package/dist/sdk/graph/centrality.d.ts +20 -20
  476. package/dist/sdk/graph/conformance.d.ts +21 -21
  477. package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
  478. package/dist/sdk/graph/durable-cache.d.ts +22 -22
  479. package/dist/sdk/graph/governance-contracts.d.ts +1 -1
  480. package/dist/sdk/graph/governance.d.ts +92 -92
  481. package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
  482. package/dist/sdk/graph/index.d.ts +15 -15
  483. package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
  484. package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
  485. package/dist/sdk/graph/query-contracts.d.ts +6 -6
  486. package/dist/sdk/graph/remediation.d.ts +15 -15
  487. package/dist/sdk/graph/run.d.ts +203 -203
  488. package/dist/sdk/graph/scheduling.d.ts +21 -21
  489. package/dist/sdk/graph/traversal.d.ts +18 -18
  490. package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
  491. package/dist/sdk/guide-topics.d.ts +19 -19
  492. package/dist/sdk/guide-topics.js +1 -1
  493. package/dist/sdk/guide.d.ts +43 -43
  494. package/dist/sdk/history/attestation-command.d.ts +8 -8
  495. package/dist/sdk/history/attestation-contract.d.ts +43 -43
  496. package/dist/sdk/history/attestation-scan.d.ts +4 -4
  497. package/dist/sdk/history/attestation.d.ts +4 -4
  498. package/dist/sdk/history/maintenance.d.ts +25 -25
  499. package/dist/sdk/history/salvage.d.ts +19 -19
  500. package/dist/sdk/history/subject.d.ts +8 -8
  501. package/dist/sdk/history-analytics.d.ts +64 -64
  502. package/dist/sdk/history-compact.d.ts +67 -67
  503. package/dist/sdk/history-mcp.d.ts +7 -7
  504. package/dist/sdk/history-provenance.d.ts +40 -40
  505. package/dist/sdk/history-read.d.ts +24 -24
  506. package/dist/sdk/history-redact.d.ts +68 -68
  507. package/dist/sdk/history-repair.d.ts +92 -92
  508. package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
  509. package/dist/sdk/improvement-ledger.d.ts +62 -62
  510. package/dist/sdk/index.d.ts +70 -69
  511. package/dist/sdk/index.js +1 -1
  512. package/dist/sdk/init-agent-guidance.d.ts +68 -68
  513. package/dist/sdk/init.d.ts +117 -117
  514. package/dist/sdk/invocation-author.d.ts +1 -1
  515. package/dist/sdk/item-children.d.ts +15 -15
  516. package/dist/sdk/item-metadata-index.d.ts +2 -2
  517. package/dist/sdk/item-schedule.d.ts +9 -9
  518. package/dist/sdk/item-transaction.d.ts +139 -76
  519. package/dist/sdk/item-transaction.js +1 -1
  520. package/dist/sdk/learnings.d.ts +23 -23
  521. package/dist/sdk/lifecycle/append.d.ts +8 -8
  522. package/dist/sdk/lifecycle/claim.d.ts +53 -39
  523. package/dist/sdk/lifecycle/claim.js +1 -1
  524. package/dist/sdk/lifecycle/close-many.d.ts +71 -71
  525. package/dist/sdk/lifecycle/close.d.ts +18 -24
  526. package/dist/sdk/lifecycle/close.js +1 -1
  527. package/dist/sdk/lifecycle/copy.d.ts +10 -10
  528. package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
  529. package/dist/sdk/lifecycle/core-item-fields.d.ts +6 -0
  530. package/dist/sdk/lifecycle/core-item-fields.js +2 -0
  531. package/dist/sdk/lifecycle/create.d.ts +88 -88
  532. package/dist/sdk/lifecycle/delete.d.ts +15 -15
  533. package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
  534. package/dist/sdk/lifecycle/focus.d.ts +6 -6
  535. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
  536. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
  537. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
  538. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  539. package/dist/sdk/lifecycle/mcp-actions.js +1 -1
  540. package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
  541. package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
  542. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
  543. package/dist/sdk/lifecycle/mutation-option-validation.d.ts +2 -0
  544. package/dist/sdk/lifecycle/mutation-option-validation.js +2 -0
  545. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
  546. package/dist/sdk/lifecycle/plan.d.ts +127 -127
  547. package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
  548. package/dist/sdk/lifecycle/release-handoff.d.ts +12 -0
  549. package/dist/sdk/lifecycle/release-handoff.js +2 -0
  550. package/dist/sdk/lifecycle/reopen.d.ts +15 -15
  551. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
  552. package/dist/sdk/lifecycle/restore.d.ts +34 -34
  553. package/dist/sdk/lifecycle/restore.js +1 -1
  554. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
  555. package/dist/sdk/lifecycle/structured-mutation-plan.d.ts +33 -0
  556. package/dist/sdk/lifecycle/structured-mutation-plan.js +2 -0
  557. package/dist/sdk/lifecycle/task-composition.d.ts +9 -9
  558. package/dist/sdk/lifecycle/task-composition.js +1 -1
  559. package/dist/sdk/lifecycle/update-many.d.ts +61 -61
  560. package/dist/sdk/lifecycle/update.d.ts +113 -121
  561. package/dist/sdk/lifecycle/update.js +1 -1
  562. package/dist/sdk/lifecycle/workflow-transition.d.ts +13 -0
  563. package/dist/sdk/lifecycle/workflow-transition.js +2 -0
  564. package/dist/sdk/lifecycle-completion.d.ts +14 -14
  565. package/dist/sdk/lifecycle-policy.d.ts +42 -32
  566. package/dist/sdk/lifecycle-policy.js +1 -1
  567. package/dist/sdk/linked-artifacts.d.ts +58 -58
  568. package/dist/sdk/mcp/apps.d.ts +28 -28
  569. package/dist/sdk/mcp/authorization.d.ts +66 -66
  570. package/dist/sdk/mcp/discovery.d.ts +67 -67
  571. package/dist/sdk/mcp/interactions.d.ts +49 -49
  572. package/dist/sdk/mcp/protocol.d.ts +63 -63
  573. package/dist/sdk/mcp/skills.d.ts +62 -62
  574. package/dist/sdk/mcp/subscriptions.d.ts +26 -26
  575. package/dist/sdk/mcp/tasks.d.ts +51 -51
  576. package/dist/sdk/mcp/transport.d.ts +17 -17
  577. package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
  578. package/dist/sdk/merge/driver.d.ts +38 -38
  579. package/dist/sdk/merge/index.d.ts +5 -5
  580. package/dist/sdk/merge/install.d.ts +48 -48
  581. package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
  582. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  583. package/dist/sdk/merge/receipt-schema.d.ts +11 -11
  584. package/dist/sdk/merge/receipts.d.ts +111 -111
  585. package/dist/sdk/merge/reconcile.d.ts +20 -20
  586. package/dist/sdk/merge/three-way.d.ts +50 -50
  587. package/dist/sdk/merge/three-way.js +2 -2
  588. package/dist/sdk/merge/worktree-config.d.ts +3 -3
  589. package/dist/sdk/mutation-events.d.ts +62 -62
  590. package/dist/sdk/mutation-guard.d.ts +134 -134
  591. package/dist/sdk/notes.d.ts +28 -28
  592. package/dist/sdk/output/table-rows.d.ts +6 -6
  593. package/dist/sdk/output-contracts.d.ts +26 -26
  594. package/dist/sdk/output-projection.d.ts +108 -108
  595. package/dist/sdk/output-token-accounting.d.ts +18 -18
  596. package/dist/sdk/output.d.ts +18 -18
  597. package/dist/sdk/ownership-source.d.ts +1 -1
  598. package/dist/sdk/package-import-adapters.d.ts +51 -51
  599. package/dist/sdk/package-migrations.d.ts +3 -3
  600. package/dist/sdk/package-runtime-options.d.ts +3 -3
  601. package/dist/sdk/pagination.d.ts +28 -28
  602. package/dist/sdk/pagination.js +1 -1
  603. package/dist/sdk/profile.d.ts +72 -72
  604. package/dist/sdk/provenance.d.ts +37 -37
  605. package/dist/sdk/public-surface.json +1 -1
  606. package/dist/sdk/query/activity.d.ts +84 -84
  607. package/dist/sdk/query/aggregate.d.ts +109 -109
  608. package/dist/sdk/query/calendar.d.ts +95 -95
  609. package/dist/sdk/query/complete-list.d.ts +35 -35
  610. package/dist/sdk/query/context.d.ts +300 -300
  611. package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
  612. package/dist/sdk/query/get.d.ts +54 -54
  613. package/dist/sdk/query/history.d.ts +38 -38
  614. package/dist/sdk/query/item-filter-options.d.ts +41 -41
  615. package/dist/sdk/query/light-metadata.d.ts +1 -1
  616. package/dist/sdk/query/list-filter-shared.d.ts +4 -4
  617. package/dist/sdk/query/list.d.ts +167 -167
  618. package/dist/sdk/query/list.js +1 -1
  619. package/dist/sdk/query/multi-value-filters.d.ts +6 -6
  620. package/dist/sdk/query/next-ready-budget.d.ts +8 -8
  621. package/dist/sdk/query/next.d.ts +94 -94
  622. package/dist/sdk/query/parsers.d.ts +3 -3
  623. package/dist/sdk/query/projection-contracts.d.ts +18 -18
  624. package/dist/sdk/query/search/corpus.d.ts +15 -15
  625. package/dist/sdk/query/search/filters.d.ts +15 -15
  626. package/dist/sdk/query/search/input.d.ts +8 -8
  627. package/dist/sdk/query/search/lexical.d.ts +10 -10
  628. package/dist/sdk/query/search/response.d.ts +22 -22
  629. package/dist/sdk/query/search/semantic.d.ts +133 -133
  630. package/dist/sdk/query/search/types.d.ts +65 -65
  631. package/dist/sdk/query/search-contracts.d.ts +53 -53
  632. package/dist/sdk/query/search-pagination.d.ts +21 -21
  633. package/dist/sdk/query/search-rendering.d.ts +30 -30
  634. package/dist/sdk/query/search.d.ts +60 -60
  635. package/dist/sdk/query/workspace-contracts.d.ts +2 -2
  636. package/dist/sdk/query.d.ts +6 -6
  637. package/dist/sdk/read-output/continuation.d.ts +11 -11
  638. package/dist/sdk/read-output/extension.d.ts +3 -3
  639. package/dist/sdk/read-output/options.d.ts +7 -7
  640. package/dist/sdk/read-output/provenance.d.ts +6 -6
  641. package/dist/sdk/read-output-budget.d.ts +11 -11
  642. package/dist/sdk/read-output-budget.js +1 -1
  643. package/dist/sdk/read-output-contracts.d.ts +112 -112
  644. package/dist/sdk/read-output-contracts.js +1 -1
  645. package/dist/sdk/read-output-rows.d.ts +15 -15
  646. package/dist/sdk/read-output-session.d.ts +29 -29
  647. package/dist/sdk/relationship-analytics.d.ts +46 -46
  648. package/dist/sdk/relationship-context.d.ts +48 -48
  649. package/dist/sdk/relationship-history.d.ts +59 -59
  650. package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
  651. package/dist/sdk/relationship-migration.d.ts +14 -14
  652. package/dist/sdk/relationships.d.ts +46 -46
  653. package/dist/sdk/reproducibility/process.d.ts +9 -9
  654. package/dist/sdk/runtime/actions.d.ts +1 -1
  655. package/dist/sdk/runtime/context.d.ts +15 -15
  656. package/dist/sdk/runtime/schema-preview.d.ts +1 -1
  657. package/dist/sdk/runtime/schema.d.ts +1 -1
  658. package/dist/sdk/runtime-action-aliases.d.ts +3 -3
  659. package/dist/sdk/runtime-extended-actions.d.ts +9 -9
  660. package/dist/sdk/runtime-input.d.ts +29 -29
  661. package/dist/sdk/runtime-input.js +1 -1
  662. package/dist/sdk/runtime-primitives.d.ts +53 -53
  663. package/dist/sdk/runtime-primitives.js +1 -1
  664. package/dist/sdk/runtime-public-contracts.d.ts +46 -46
  665. package/dist/sdk/runtime-stats-options.d.ts +1 -1
  666. package/dist/sdk/runtime.d.ts +374 -374
  667. package/dist/sdk/runtime.js +1 -1
  668. package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
  669. package/dist/sdk/schema-migration.d.ts +79 -79
  670. package/dist/sdk/schema.d.ts +224 -224
  671. package/dist/sdk/search-refresh-worker.d.ts +1 -1
  672. package/dist/sdk/similarity-scoring.d.ts +10 -10
  673. package/dist/sdk/similarity.d.ts +73 -73
  674. package/dist/sdk/start-task-status.d.ts +1 -1
  675. package/dist/sdk/stats.d.ts +72 -72
  676. package/dist/sdk/structured-mutations.d.ts +64 -13
  677. package/dist/sdk/structured-mutations.js +1 -1
  678. package/dist/sdk/telemetry-flush.d.ts +1 -1
  679. package/dist/sdk/telemetry.d.ts +32 -32
  680. package/dist/sdk/templates.d.ts +35 -35
  681. package/dist/sdk/test/batch.d.ts +50 -50
  682. package/dist/sdk/test/command-args.d.ts +2 -2
  683. package/dist/sdk/test/entry.d.ts +4 -4
  684. package/dist/sdk/test/execution-receipts.d.ts +5 -5
  685. package/dist/sdk/test/execution.d.ts +247 -247
  686. package/dist/sdk/test/json-path.d.ts +4 -4
  687. package/dist/sdk/test/linked-command-detection.d.ts +36 -36
  688. package/dist/sdk/test/measurements.d.ts +10 -10
  689. package/dist/sdk/test/parsers.d.ts +18 -18
  690. package/dist/sdk/test/prerequisites.d.ts +3 -3
  691. package/dist/sdk/test/runs.d.ts +43 -43
  692. package/dist/sdk/test/trust.d.ts +15 -15
  693. package/dist/sdk/test/update.d.ts +23 -23
  694. package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
  695. package/dist/sdk/testing.d.ts +248 -248
  696. package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
  697. package/dist/sdk/traceability/source-traceability.d.ts +50 -50
  698. package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
  699. package/dist/sdk/workspace-contracts.d.ts +20 -20
  700. package/dist/sdk/workspace-memory.d.ts +42 -42
  701. package/dist/sdk/workspace-recipe.d.ts +9 -9
  702. package/dist/sdk/workspace-snapshot.d.ts +60 -60
  703. package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
  704. package/dist/sdk/workspace-transaction.d.ts +26 -26
  705. package/dist/sdk/workspace-transaction.js +2 -2
  706. package/dist/sdk/workspace.d.ts +9 -9
  707. package/dist/types.d.ts +540 -540
  708. package/docs/AGENT_GUIDE.md +33 -4
  709. package/docs/CLOSE_EVIDENCE_RECOVERY.md +16 -7
  710. package/docs/COMMANDS.md +96 -12
  711. package/docs/ECOSYSTEM_PLANNING_REVIEW.md +5 -1
  712. package/docs/EXTENSIONS.md +1 -1
  713. package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
  714. package/docs/LINKED_TEST_EDITS.md +15 -0
  715. package/docs/RELEASING.md +2 -0
  716. package/docs/SDK.md +114 -2
  717. package/docs/TESTING.md +36 -1
  718. package/docs/generated/FLAG_LEXICON_BUDGETS.md +1 -1
  719. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +17 -3
  720. package/marketplace.json +1 -1
  721. package/package.json +4 -1
  722. package/packages/pm-beads/package.json +1 -1
  723. package/packages/pm-calendar/package.json +1 -1
  724. package/packages/pm-command-kit/package.json +1 -1
  725. package/packages/pm-digital-twin/package.json +1 -1
  726. package/packages/pm-governance-audit/package.json +1 -1
  727. package/packages/pm-guide-shell/package.json +1 -1
  728. package/packages/pm-kanban/package.json +1 -1
  729. package/packages/pm-lifecycle-hooks/package.json +1 -1
  730. package/packages/pm-linked-test-adapters/package.json +1 -1
  731. package/packages/pm-search-advanced/package.json +1 -1
  732. package/packages/pm-templates/package.json +1 -1
  733. package/packages/pm-todos/package.json +1 -1
  734. package/packages/pm-vcs/package.json +1 -1
  735. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  736. package/plugins/pm-claude/package.json +1 -1
  737. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  738. package/plugins/pm-codex/package.json +1 -1
  739. package/plugins/pm-codex/plugin.json +1 -1
  740. package/runtime-dependencies.json +1 -1
  741. package/scripts/finalize-build.mjs +9 -3
  742. package/dist/cli-bundle/chunks/chunk-66BZVFIK.js +0 -6
  743. package/dist/cli-bundle/chunks/chunk-IDEHMKYZ.js +0 -235
  744. package/dist/cli-bundle/chunks/chunk-LOSRTNNP.js +0 -2
  745. package/dist/cli-bundle/chunks/chunk-PP3BVMFL.js +0 -30
  746. package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
  747. package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
  748. package/dist/cli-bundle/chunks/register-mutation-TNRHNK4N.js +0 -20
  749. package/dist/cli-bundle/focused-chunks/chunk-23ACMPGB.js +0 -2
  750. package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
  751. package/dist/cli-bundle/focused-chunks/chunk-LKWDWER4.js +0 -20
  752. package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
  753. package/docs/ecosystem-review-2026-09-28.json +0 -1
@@ -2,25 +2,25 @@
2
2
  * @module sdk/query/search/types
3
3
  * Shared search result and pipeline state contracts; no runtime dependencies.
4
4
  */
5
- import { type QueryExpansionConfig, type RerankConfig } from "../../../core/search/relevance.js";
5
+ import { type QueryExpansionConfig,type RerankConfig } from "../../../core/search/relevance.js";
6
6
  import type { ItemMetadata } from "../../../types/index.js";
7
7
  import { type WorkspaceMemoryRollup } from "../../workspace-memory.js";
8
- import { type SearchMatchMode, type SearchModeSource, type SearchOptions, type SearchProjectionConfig, type SearchProjectionMode } from "../search-contracts.js";
8
+ import { type SearchMatchMode,type SearchModeSource,type SearchOptions,type SearchProjectionConfig,type SearchProjectionMode } from "../search-contracts.js";
9
9
  import { type SearchMode } from "../search-rendering.js";
10
10
  /** Documents the search hit payload exchanged by command, SDK, and package integrations. */
11
11
  export interface SearchHit {
12
12
  /** Value that configures or reports item for this contract. */
13
- item: ItemMetadata;
13
+ item:ItemMetadata;
14
14
  /** Value that configures or reports score for this contract. */
15
- score: number;
15
+ score:number;
16
16
  /** Value that configures or reports matched fields for this contract. */
17
- matched_fields: string[];
17
+ matched_fields:string[];
18
18
  /** Value that configures or reports matched all terms for this contract. */
19
- matched_all_terms?: boolean;
19
+ matched_all_terms?:boolean;
20
20
  /** Value that configures or reports exact id match for this contract. */
21
- exact_id_match?: boolean;
21
+ exact_id_match?:boolean;
22
22
  /** Value that configures or reports highlights for this contract. */
23
- highlights?: SearchHitHighlight[];
23
+ highlights?:SearchHitHighlight[];
24
24
  }
25
25
  /**
26
26
  * Pairs a matched field name with a snippet of its text where every matching
@@ -29,95 +29,95 @@ highlights?: SearchHitHighlight[];
29
29
  */
30
30
  export interface SearchHitHighlight {
31
31
  /** Value that configures or reports field for this contract. */
32
- field: string;
32
+ field:string;
33
33
  /** Value that configures or reports snippet for this contract. */
34
- snippet: string;
34
+ snippet:string;
35
35
  }
36
36
  /** Restricts search result item values accepted by command, SDK, and storage contracts. */
37
- export type SearchResultItem = SearchHit | Record<string, unknown>;
37
+ export type SearchResultItem = SearchHit | Record<string,unknown>;
38
38
  interface SearchResultBase {
39
- query: string;
40
- mode: SearchMode;
39
+ query:string;
40
+ mode:SearchMode;
41
41
  /** Which layer chose `mode` before any runtime fallback: the caller, `search.default_mode`, or the workspace-state default. */
42
- mode_source?: SearchModeSource;
43
- items: SearchResultItem[];
44
- count: number;
45
- total?: number;
42
+ mode_source?:SearchModeSource;
43
+ items:SearchResultItem[];
44
+ count:number;
45
+ total?:number;
46
46
  /** Whether additional ranked hits remain after this page. */
47
- has_more?: boolean;
47
+ has_more?:boolean;
48
48
  /** Opaque continuation cursor when additional hits remain. */
49
- next_cursor?: string;
49
+ next_cursor?:string;
50
50
  /** Effective page size for this response. */
51
- applied_limit?: number;
51
+ applied_limit?:number;
52
52
  /** Explicit marker that the response is a bounded page. */
53
- truncated?: true;
54
- count_only?: boolean;
55
- warnings?: string[];
53
+ truncated?:true;
54
+ count_only?:boolean;
55
+ warnings?:string[];
56
56
  /** Historical epoch and epic rollups matching the query in large workspaces. */
57
- workspace_memory?: {
57
+ workspace_memory?:{
58
58
  /** Persistence freshness for the derived projection. */
59
- cache_status: "fresh" | "rebuilt";
59
+ cache_status:"fresh" | "rebuilt";
60
60
  /** Matching bounded rollups, ordered by term coverage and recency. */
61
- matches: WorkspaceMemoryRollup[];
61
+ matches:WorkspaceMemoryRollup[];
62
62
  };
63
63
  }
64
64
  /** Documents the search compact result payload exchanged by command, SDK, and package integrations. */
65
65
  export interface SearchCompactResult extends SearchResultBase {
66
66
  /** Value that configures or reports filters for this contract. */
67
- filters: Record<string, unknown>;
67
+ filters:Record<string,unknown>;
68
68
  /** Value that configures or reports projection for this contract. */
69
- projection?: undefined;
69
+ projection?:undefined;
70
70
  /** Value that configures or reports now for this contract. */
71
- now?: undefined;
71
+ now?:undefined;
72
72
  }
73
73
  /** Documents the search verbose result payload exchanged by command, SDK, and package integrations. */
74
74
  export interface SearchVerboseResult extends SearchResultBase {
75
75
  /** Value that configures or reports filters for this contract. */
76
- filters: Record<string, unknown>;
76
+ filters:Record<string,unknown>;
77
77
  /** Value that configures or reports projection for this contract. */
78
- projection: {
79
- mode: SearchProjectionMode;
80
- fields: string[] | null;
78
+ projection:{
79
+ mode:SearchProjectionMode;
80
+ fields:string[] | null;
81
81
  };
82
82
  /** Value that configures or reports now for this contract. */
83
- now: string;
83
+ now:string;
84
84
  }
85
85
  /** Restricts search result values accepted by command, SDK, and storage contracts. */
86
86
  export type SearchResult = SearchCompactResult | SearchVerboseResult;
87
87
  /** Validated search input shared by corpus selection, retrieval and result construction. */
88
88
  interface PreparedSearchInput {
89
- query: string;
90
- options: SearchOptions;
91
- inlineWarnings: string[];
92
- highlight: boolean;
93
- includeLinked: boolean;
94
- titleExact: boolean;
95
- phraseExact: boolean;
96
- matchMode: SearchMatchMode;
97
- minScoreOverride: number | undefined;
98
- countOnly: boolean;
99
- tokens: string[];
100
- normalizedQuery: string;
101
- limit: number | undefined;
102
- projection: SearchProjectionConfig;
103
- modeWasExplicit: boolean;
89
+ query:string;
90
+ options:SearchOptions;
91
+ inlineWarnings:string[];
92
+ highlight:boolean;
93
+ includeLinked:boolean;
94
+ titleExact:boolean;
95
+ phraseExact:boolean;
96
+ matchMode:SearchMatchMode;
97
+ minScoreOverride:number | undefined;
98
+ countOnly:boolean;
99
+ tokens:string[];
100
+ normalizedQuery:string;
101
+ limit:number | undefined;
102
+ projection:SearchProjectionConfig;
103
+ modeWasExplicit:boolean;
104
104
  }
105
105
  /** Resolved query settings and evidence retained while shaping the final response. */
106
106
  interface SearchResponseContext {
107
- query: string;
108
- effectiveMode: SearchMode;
109
- modeSource: SearchModeSource;
110
- matchMode: SearchMatchMode;
111
- options: SearchOptions;
112
- includeLinked: boolean;
113
- titleExact: boolean;
114
- phraseExact: boolean;
115
- scoreThreshold: number;
116
- hybridSemanticWeight: number;
117
- queryExpansion: QueryExpansionConfig;
118
- rerank: RerankConfig;
119
- projection: SearchProjectionConfig;
120
- warnings: string[];
121
- runtimeFieldFilters: Record<string, unknown>;
107
+ query:string;
108
+ effectiveMode:SearchMode;
109
+ modeSource:SearchModeSource;
110
+ matchMode:SearchMatchMode;
111
+ options:SearchOptions;
112
+ includeLinked:boolean;
113
+ titleExact:boolean;
114
+ phraseExact:boolean;
115
+ scoreThreshold:number;
116
+ hybridSemanticWeight:number;
117
+ queryExpansion:QueryExpansionConfig;
118
+ rerank:RerankConfig;
119
+ projection:SearchProjectionConfig;
120
+ warnings:string[];
121
+ runtimeFieldFilters:Record<string,unknown>;
122
122
  }
123
- export { PreparedSearchInput, SearchResponseContext };
123
+ export { PreparedSearchInput,SearchResponseContext };
@@ -4,33 +4,33 @@ import type { SearchMode } from "./search-rendering.js";
4
4
  /** Documents the search options payload exchanged by command, SDK, and package integrations. */
5
5
  export interface SearchOptions extends SharedItemFilterOptions {
6
6
  /** Value that configures or reports mode for this contract. */
7
- mode?: string;
7
+ mode?:string;
8
8
  /** Strategy used to control match behavior. */
9
- matchMode?: string;
9
+ matchMode?:string;
10
10
  /** Value that configures or reports min score for this contract. */
11
- minScore?: string | number;
11
+ minScore?:string | number;
12
12
  /** Value that configures or reports count for this contract. */
13
- count?: boolean;
13
+ count?:boolean;
14
14
  /** Value that configures or reports semantic weight for this contract. */
15
- semanticWeight?: string | number;
15
+ semanticWeight?:string | number;
16
16
  /** Value that configures or reports include linked for this contract. */
17
- includeLinked?: boolean;
17
+ includeLinked?:boolean;
18
18
  /** Value that configures or reports title exact for this contract. */
19
- titleExact?: boolean;
19
+ titleExact?:boolean;
20
20
  /** Value that configures or reports phrase exact for this contract. */
21
- phraseExact?: boolean;
21
+ phraseExact?:boolean;
22
22
  /** Value that configures or reports limit for this contract. */
23
- limit?: string;
23
+ limit?:string;
24
24
  /** Opaque cursor returned by a previous search page. */
25
- after?: string;
25
+ after?:string;
26
26
  /** Value that configures or reports compact for this contract. */
27
- compact?: boolean;
27
+ compact?:boolean;
28
28
  /** Value that configures or reports full for this contract. */
29
- full?: boolean;
29
+ full?:boolean;
30
30
  /** Value that configures or reports fields for this contract. */
31
- fields?: string;
31
+ fields?:string;
32
32
  /** Whether matched-text snippets are included on each hit. */
33
- highlight?: boolean;
33
+ highlight?:boolean;
34
34
  }
35
35
  /** Restricts search match mode values accepted by command, SDK, and storage contracts. */
36
36
  export type SearchMatchMode = "and" | "or" | "exact";
@@ -39,78 +39,78 @@ export type SearchProjectionMode = "compact" | "full" | "fields";
39
39
  /** Validated search result projection. */
40
40
  export interface SearchProjectionConfig {
41
41
  /** Selected projection mode. */
42
- mode: SearchProjectionMode;
42
+ mode:SearchProjectionMode;
43
43
  /** Explicit fields for compact or fields mode. */
44
- fields: string[];
44
+ fields:string[];
45
45
  }
46
46
  /** Parse the configured search execution mode. */
47
- export declare function parseSearchMode(raw: string | undefined): SearchMode;
47
+ export declare function parseSearchMode(raw:string | undefined):SearchMode;
48
48
  /** Normalize an opt-in boolean search flag. */
49
- export declare function parseSearchBoolean(raw: boolean | undefined): boolean;
49
+ export declare function parseSearchBoolean(raw:boolean | undefined):boolean;
50
50
  /** Parse a per-query semantic weight override. */
51
- export declare function parseSemanticWeightOverride(raw: unknown): number | undefined;
51
+ export declare function parseSemanticWeightOverride(raw:unknown):number | undefined;
52
52
  /** Parse the lexical match strategy. */
53
- export declare function parseSearchMatchMode(raw: string | undefined): SearchMatchMode;
53
+ export declare function parseSearchMatchMode(raw:string | undefined):SearchMatchMode;
54
54
  /** Parse a non-negative per-query score threshold. */
55
- export declare function parseMinScoreOverride(raw: unknown): number | undefined;
55
+ export declare function parseMinScoreOverride(raw:unknown):number | undefined;
56
56
  /** Parse an ISO or signed-relative timestamp window. */
57
- export declare function parseTimestampWindow(raw: unknown, fieldLabel: string): string | undefined;
57
+ export declare function parseTimestampWindow(raw:unknown,fieldLabel:string):string | undefined;
58
58
  /** Normalize a phrase for case-insensitive matching. */
59
- export declare function normalizeSearchPhrase(value: string): string;
59
+ export declare function normalizeSearchPhrase(value:string):string;
60
60
  /** Parse an optional deadline filter. */
61
- export declare function parseSearchDeadline(raw: string | undefined, fieldLabel: string): string | undefined;
61
+ export declare function parseSearchDeadline(raw:string | undefined,fieldLabel:string):string | undefined;
62
62
  /** Resolve mutually exclusive compact, full, or explicit-field projection. */
63
- export declare function parseSearchProjection(options: SearchOptions, query?: string): SearchProjectionConfig;
63
+ export declare function parseSearchProjection(options:SearchOptions,query?:string):SearchProjectionConfig;
64
64
  /** Validate explicit projection fields against core and runtime metadata. */
65
- export declare function validateSearchProjectionFields(projection: SearchProjectionConfig, runtimeFieldRegistry: RuntimeFieldRegistry, query?: string): void;
65
+ export declare function validateSearchProjectionFields(projection:SearchProjectionConfig,runtimeFieldRegistry:RuntimeFieldRegistry,query?:string):void;
66
66
  /** Parse a non-empty normalized query into lexical tokens. */
67
- export declare function parseSearchTokens(query: string): string[];
67
+ export declare function parseSearchTokens(query:string):string[];
68
68
  /** Documents the search tuning payload exchanged by command, SDK, and package integrations. */
69
69
  export interface SearchTuning {
70
70
  /** Exact-title ranking bonus. */
71
- title_exact_bonus: number;
71
+ title_exact_bonus:number;
72
72
  /** Title field weight. */
73
- title_weight: number;
73
+ title_weight:number;
74
74
  /** Description field weight. */
75
- description_weight: number;
75
+ description_weight:number;
76
76
  /** Tag field weight. */
77
- tags_weight: number;
77
+ tags_weight:number;
78
78
  /** Status field weight. */
79
- status_weight: number;
79
+ status_weight:number;
80
80
  /** Body field weight. */
81
- body_weight: number;
81
+ body_weight:number;
82
82
  /** Comment field weight. */
83
- comments_weight: number;
83
+ comments_weight:number;
84
84
  /** Note field weight. */
85
- notes_weight: number;
85
+ notes_weight:number;
86
86
  /** Learning field weight. */
87
- learnings_weight: number;
87
+ learnings_weight:number;
88
88
  /** Reminder field weight. */
89
- reminders_weight: number;
89
+ reminders_weight:number;
90
90
  /** Event field weight. */
91
- events_weight: number;
91
+ events_weight:number;
92
92
  /** Dependency field weight. */
93
- dependencies_weight: number;
93
+ dependencies_weight:number;
94
94
  /** Linked-content field weight. */
95
- linked_content_weight: number;
95
+ linked_content_weight:number;
96
96
  }
97
97
  /** Resolve the bounded default maximum result count. */
98
- export declare function resolveSearchMaxResults(settings: unknown): number;
98
+ export declare function resolveSearchMaxResults(settings:unknown):number;
99
99
  /** Restricts the declared default search mode: a concrete mode pins it, `auto` derives it from workspace state. */
100
100
  export type SearchDefaultMode = "auto" | SearchMode;
101
101
  /** Every value `search.default_mode` accepts, in declaration order. */
102
- export declare const SEARCH_DEFAULT_MODE_VALUES: readonly SearchDefaultMode[];
102
+ export declare const SEARCH_DEFAULT_MODE_VALUES:readonly SearchDefaultMode[];
103
103
  /** Names which layer chose the effective search mode for one query. Verbose responses always carry it; compact responses carry it only for `settings`, since `explicit` is the caller's own choice and `auto` is the documented default. */
104
104
  export type SearchModeSource = "explicit" | "settings" | "auto";
105
105
  /** Documents the effective search mode together with the layer that chose it. */
106
106
  export interface SearchModeResolution {
107
107
  /** The mode the query will execute in before any runtime fallback. */
108
- mode: SearchMode;
108
+ mode:SearchMode;
109
109
  /** `explicit` when the caller passed a mode, `settings` when `search.default_mode` pins one, `auto` when derived from workspace state. */
110
- source: SearchModeSource;
110
+ source:SearchModeSource;
111
111
  }
112
112
  /** Resolve the declared `search.default_mode` setting, falling back to `auto` for absent or invalid values. */
113
- export declare function resolveSearchDefaultModeSetting(settings: unknown): SearchDefaultMode;
113
+ export declare function resolveSearchDefaultModeSetting(settings:unknown):SearchDefaultMode;
114
114
  /**
115
115
  * Resolve the mode a search executes in. An explicit request always wins and is
116
116
  * validated by {@link parseSearchMode}; otherwise a concrete `search.default_mode`
@@ -118,14 +118,14 @@ export declare function resolveSearchDefaultModeSetting(settings: unknown): Sear
118
118
  * is explicitly configured and runnable, and `keyword` in every other case, so a
119
119
  * workspace that built a vector index is searched with it without any flag.
120
120
  */
121
- export declare function resolveEffectiveSearchMode(params: {
122
- requested: unknown;
123
- settings: unknown;
124
- semanticRunnable: boolean;
125
- }): SearchModeResolution;
121
+ export declare function resolveEffectiveSearchMode(params:{
122
+ requested:unknown;
123
+ settings:unknown;
124
+ semanticRunnable:boolean;
125
+ }):SearchModeResolution;
126
126
  /** Resolve the configured minimum result score. */
127
- export declare function resolveSearchScoreThreshold(settings: unknown): number;
127
+ export declare function resolveSearchScoreThreshold(settings:unknown):number;
128
128
  /** Resolve the configured hybrid semantic weighting. */
129
- export declare function resolveHybridSemanticWeight(settings: unknown): number;
129
+ export declare function resolveHybridSemanticWeight(settings:unknown):number;
130
130
  /** Resolve non-negative field weights over stable defaults. */
131
- export declare function resolveSearchTuning(settings: unknown): SearchTuning;
131
+ export declare function resolveSearchTuning(settings:unknown):SearchTuning;
@@ -1,28 +1,28 @@
1
- import type { SearchHit, SearchOptions } from "./search.js";
1
+ import type { SearchHit,SearchOptions } from "./search.js";
2
2
  import type { SearchMode } from "./search-rendering.js";
3
3
  /** Build the query-only fingerprint shared by search retrieval and paging. */
4
- export declare function createSearchCursorFingerprint(options: {
5
- query: string;
6
- mode: SearchMode;
7
- searchOptions: SearchOptions;
4
+ export declare function createSearchCursorFingerprint(options:{
5
+ query:string;
6
+ mode:SearchMode;
7
+ searchOptions:SearchOptions;
8
8
  /** Tracker scope, resolved before hashing so callers share native path identity. */
9
- pmRoot?: string;
10
- }): string;
9
+ pmRoot?:string;
10
+ }):string;
11
11
  /** Page ranked search hits without coupling cursor mechanics to search scoring. */
12
- export declare function resolveSearchPage(options: {
13
- sorted: SearchHit[];
14
- query: string;
15
- mode: SearchMode;
16
- searchOptions: SearchOptions;
17
- limit: number;
12
+ export declare function resolveSearchPage(options:{
13
+ sorted:SearchHit[];
14
+ query:string;
15
+ mode:SearchMode;
16
+ searchOptions:SearchOptions;
17
+ limit:number;
18
18
  /** Resolved tracker scope when invoked by the query runtime. */
19
- pmRoot?: string;
20
- }): {
21
- limited: SearchHit[];
22
- pageExtras: {
23
- has_more?: boolean;
24
- next_cursor?: string;
25
- applied_limit: number;
26
- truncated?: true;
19
+ pmRoot?:string;
20
+ }):{
21
+ limited:SearchHit[];
22
+ pageExtras:{
23
+ has_more?:boolean;
24
+ next_cursor?:string;
25
+ applied_limit:number;
26
+ truncated?:true;
27
27
  };
28
28
  };
@@ -1,39 +1,39 @@
1
- import type { SearchMatchMode, SearchOptions } from "./search.js";
1
+ import type { SearchMatchMode,SearchOptions } from "./search.js";
2
2
  /** Search execution modes represented in response metadata. */
3
3
  export type SearchMode = "keyword" | "semantic" | "hybrid";
4
4
  interface SearchRenderingQueryExpansion {
5
- enabled: boolean;
6
- provider: string | null;
5
+ enabled:boolean;
6
+ provider:string | null;
7
7
  }
8
8
  interface SearchRenderingRerank {
9
- enabled: boolean;
10
- model: string;
11
- top_k: number;
9
+ enabled:boolean;
10
+ model:string;
11
+ top_k:number;
12
12
  }
13
13
  /** Builds the token-efficient filter echo used by compact search results. */
14
- export declare function buildCompactSearchFilterSummary(params: {
15
- mode: SearchMode;
16
- matchMode: SearchMatchMode;
17
- options: SearchOptions;
18
- includeLinked: boolean;
19
- titleExact: boolean;
20
- phraseExact: boolean;
21
- scoreThreshold: number;
22
- hybridSemanticWeight: number;
23
- runtimeFieldFilters?: Record<string, unknown>;
24
- }): Record<string, unknown>;
14
+ export declare function buildCompactSearchFilterSummary(params:{
15
+ mode:SearchMode;
16
+ matchMode:SearchMatchMode;
17
+ options:SearchOptions;
18
+ includeLinked:boolean;
19
+ titleExact:boolean;
20
+ phraseExact:boolean;
21
+ scoreThreshold:number;
22
+ hybridSemanticWeight:number;
23
+ runtimeFieldFilters?:Record<string,unknown>;
24
+ }):Record<string,unknown>;
25
25
  /** Builds the complete filter echo shared by verbose search response paths. */
26
- export declare function buildVerboseSearchFilters(params: {
27
- effectiveMode: SearchMode;
28
- matchMode: SearchMatchMode;
29
- options: SearchOptions;
30
- includeLinked: boolean;
31
- titleExact: boolean;
32
- phraseExact: boolean;
33
- scoreThreshold: number;
34
- hybridSemanticWeight: number;
35
- queryExpansion: SearchRenderingQueryExpansion;
36
- rerank: SearchRenderingRerank;
37
- runtimeFieldFilters: Record<string, unknown>;
38
- }): Record<string, unknown>;
26
+ export declare function buildVerboseSearchFilters(params:{
27
+ effectiveMode:SearchMode;
28
+ matchMode:SearchMatchMode;
29
+ options:SearchOptions;
30
+ includeLinked:boolean;
31
+ titleExact:boolean;
32
+ phraseExact:boolean;
33
+ scoreThreshold:number;
34
+ hybridSemanticWeight:number;
35
+ queryExpansion:SearchRenderingQueryExpansion;
36
+ rerank:SearchRenderingRerank;
37
+ runtimeFieldFilters:Record<string,unknown>;
38
+ }):Record<string,unknown>;
39
39
  export {};
@@ -1,65 +1,65 @@
1
1
  import type { GlobalOptions } from "../../core/shared/command-types.js";
2
- import { parseSearchProjection, parseSearchTokens, parseTimestampWindow, validateSearchProjectionFields, type SearchOptions } from "./search-contracts.js";
3
- import { buildCompactSearchFilterSummary, buildVerboseSearchFilters } from "./search-rendering.js";
4
- import { collectLinkedPaths, loadDocuments, loadLinkedCorpus, resolveLinkedCorpusRoots } from "./search/corpus.js";
5
- import { applyExactQueryFilters, applyFilters, collectExactPhraseFields, dependencyEntries, documentContainsExactPhrase, stringArray, textEntries } from "./search/filters.js";
6
- import { applyInlineQueryFilters, parseInlineQueryFilters } from "./search/input.js";
7
- import { buildHitHighlights, buildHybridLexicalScore, countOccurrences, highlightFieldSnippet, markTokenRuns, normalizeScoreMap, scoreDocument, sortHits } from "./search/lexical.js";
8
- import { emptySearchResult, projectSearchHits, readSearchFieldValue } from "./search/response.js";
9
- import { buildExplicitSemanticFallbackWarning, buildRerankCorpus, buildSemanticHits, classifyImplicitSemanticFallbackReason, collectErrorCauseCodes, combineHybridHits, computeBuiltInBm25Hits, computeSemanticOrHybridHits, maybeEmitVectorIndexStaleWarning, mergeVectorHitsById, normalizeExtensionProviderHits, requireSemanticDependencies, resolveBuiltInBm25Mode, resolveExtensionSearchProvider, resolveExtensionSearchProviderByName, resolveExtensionVectorAdapter } from "./search/semantic.js";
2
+ import { parseSearchProjection,parseSearchTokens,parseTimestampWindow,validateSearchProjectionFields,type SearchOptions } from "./search-contracts.js";
3
+ import { buildCompactSearchFilterSummary,buildVerboseSearchFilters } from "./search-rendering.js";
4
+ import { collectLinkedPaths,loadDocuments,loadLinkedCorpus,resolveLinkedCorpusRoots } from "./search/corpus.js";
5
+ import { applyExactQueryFilters,applyFilters,collectExactPhraseFields,dependencyEntries,documentContainsExactPhrase,stringArray,textEntries } from "./search/filters.js";
6
+ import { applyInlineQueryFilters,parseInlineQueryFilters } from "./search/input.js";
7
+ import { buildHitHighlights,buildHybridLexicalScore,countOccurrences,highlightFieldSnippet,markTokenRuns,normalizeScoreMap,scoreDocument,sortHits } from "./search/lexical.js";
8
+ import { emptySearchResult,projectSearchHits,readSearchFieldValue } from "./search/response.js";
9
+ import { buildExplicitSemanticFallbackWarning,buildRerankCorpus,buildSemanticHits,classifyImplicitSemanticFallbackReason,collectErrorCauseCodes,combineHybridHits,computeBuiltInBm25Hits,computeSemanticOrHybridHits,maybeEmitVectorIndexStaleWarning,mergeVectorHitsById,normalizeExtensionProviderHits,requireSemanticDependencies,resolveBuiltInBm25Mode,resolveExtensionSearchProvider,resolveExtensionSearchProviderByName,resolveExtensionVectorAdapter } from "./search/semantic.js";
10
10
  import type { SearchResult } from "./search/types.js";
11
- export type { SearchDefaultMode, SearchMatchMode, SearchModeResolution, SearchModeSource, SearchOptions, SearchTuning } from "./search-contracts.js";
12
- export { resolveEffectiveSearchMode, resolveHybridSemanticWeight, resolveSearchMaxResults, resolveSearchScoreThreshold, resolveSearchTuning } from "./search-contracts.js";
13
- export { classifyImplicitSemanticFallbackReason, collectErrorCauseCodes, formatVectorIndexRecoveryWarnings, resolveVectorIndexRecovery } from "./search/semantic.js";
14
- export type { SearchCompactResult, SearchHit, SearchHitHighlight, SearchResult, SearchResultItem, SearchVerboseResult } from "./search/types.js";
11
+ export type { SearchDefaultMode,SearchMatchMode,SearchModeResolution,SearchModeSource,SearchOptions,SearchTuning } from "./search-contracts.js";
12
+ export { resolveEffectiveSearchMode,resolveHybridSemanticWeight,resolveSearchMaxResults,resolveSearchScoreThreshold,resolveSearchTuning } from "./search-contracts.js";
13
+ export { classifyImplicitSemanticFallbackReason,collectErrorCauseCodes,formatVectorIndexRecoveryWarnings,resolveVectorIndexRecovery } from "./search/semantic.js";
14
+ export type { SearchCompactResult,SearchHit,SearchHitHighlight,SearchResult,SearchResultItem,SearchVerboseResult } from "./search/types.js";
15
15
  /** Public contract for test only search command, shared by SDK and presentation-layer consumers. */
16
- export declare const _testOnlySearchCommand: {
17
- applyFilters: typeof applyFilters;
18
- applyExactQueryFilters: typeof applyExactQueryFilters;
19
- applyInlineQueryFilters: typeof applyInlineQueryFilters;
20
- buildHitHighlights: typeof buildHitHighlights;
21
- buildVerboseSearchFilters: typeof buildVerboseSearchFilters;
22
- buildExplicitSemanticFallbackWarning: typeof buildExplicitSemanticFallbackWarning;
23
- buildCompactSearchFilterSummary: typeof buildCompactSearchFilterSummary;
24
- buildHybridLexicalScore: typeof buildHybridLexicalScore;
25
- buildRerankCorpus: typeof buildRerankCorpus;
26
- buildSemanticHits: typeof buildSemanticHits;
27
- classifyImplicitSemanticFallbackReason: typeof classifyImplicitSemanticFallbackReason;
28
- collectErrorCauseCodes: typeof collectErrorCauseCodes;
29
- collectExactPhraseFields: typeof collectExactPhraseFields;
30
- collectLinkedPaths: typeof collectLinkedPaths;
31
- combineHybridHits: typeof combineHybridHits;
32
- computeBuiltInBm25Hits: typeof computeBuiltInBm25Hits;
33
- computeSemanticOrHybridHits: typeof computeSemanticOrHybridHits;
34
- resolveBuiltInBm25Mode: typeof resolveBuiltInBm25Mode;
35
- countOccurrences: typeof countOccurrences;
36
- dependencyEntries: typeof dependencyEntries;
37
- documentContainsExactPhrase: typeof documentContainsExactPhrase;
38
- emptySearchResult: typeof emptySearchResult;
39
- highlightFieldSnippet: typeof highlightFieldSnippet;
40
- loadDocuments: typeof loadDocuments;
41
- markTokenRuns: typeof markTokenRuns;
42
- parseInlineQueryFilters: typeof parseInlineQueryFilters;
43
- maybeEmitVectorIndexStaleWarning: typeof maybeEmitVectorIndexStaleWarning;
44
- loadLinkedCorpus: typeof loadLinkedCorpus;
45
- mergeVectorHitsById: typeof mergeVectorHitsById;
46
- normalizeExtensionProviderHits: typeof normalizeExtensionProviderHits;
47
- normalizeScoreMap: typeof normalizeScoreMap;
48
- parseProjectionConfig: typeof parseSearchProjection;
49
- parseTimestampWindow: typeof parseTimestampWindow;
50
- parseTokens: typeof parseSearchTokens;
51
- projectSearchHits: typeof projectSearchHits;
52
- readSearchFieldValue: typeof readSearchFieldValue;
53
- requireSemanticDependencies: typeof requireSemanticDependencies;
54
- resolveExtensionSearchProvider: typeof resolveExtensionSearchProvider;
55
- resolveExtensionSearchProviderByName: typeof resolveExtensionSearchProviderByName;
56
- resolveExtensionVectorAdapter: typeof resolveExtensionVectorAdapter;
57
- resolveLinkedCorpusRoots: typeof resolveLinkedCorpusRoots;
58
- scoreDocument: typeof scoreDocument;
59
- sortHits: typeof sortHits;
60
- stringArray: typeof stringArray;
61
- textEntries: typeof textEntries;
62
- validateSearchProjectionFields: typeof validateSearchProjectionFields;
16
+ export declare const _testOnlySearchCommand:{
17
+ applyFilters:typeof applyFilters;
18
+ applyExactQueryFilters:typeof applyExactQueryFilters;
19
+ applyInlineQueryFilters:typeof applyInlineQueryFilters;
20
+ buildHitHighlights:typeof buildHitHighlights;
21
+ buildVerboseSearchFilters:typeof buildVerboseSearchFilters;
22
+ buildExplicitSemanticFallbackWarning:typeof buildExplicitSemanticFallbackWarning;
23
+ buildCompactSearchFilterSummary:typeof buildCompactSearchFilterSummary;
24
+ buildHybridLexicalScore:typeof buildHybridLexicalScore;
25
+ buildRerankCorpus:typeof buildRerankCorpus;
26
+ buildSemanticHits:typeof buildSemanticHits;
27
+ classifyImplicitSemanticFallbackReason:typeof classifyImplicitSemanticFallbackReason;
28
+ collectErrorCauseCodes:typeof collectErrorCauseCodes;
29
+ collectExactPhraseFields:typeof collectExactPhraseFields;
30
+ collectLinkedPaths:typeof collectLinkedPaths;
31
+ combineHybridHits:typeof combineHybridHits;
32
+ computeBuiltInBm25Hits:typeof computeBuiltInBm25Hits;
33
+ computeSemanticOrHybridHits:typeof computeSemanticOrHybridHits;
34
+ resolveBuiltInBm25Mode:typeof resolveBuiltInBm25Mode;
35
+ countOccurrences:typeof countOccurrences;
36
+ dependencyEntries:typeof dependencyEntries;
37
+ documentContainsExactPhrase:typeof documentContainsExactPhrase;
38
+ emptySearchResult:typeof emptySearchResult;
39
+ highlightFieldSnippet:typeof highlightFieldSnippet;
40
+ loadDocuments:typeof loadDocuments;
41
+ markTokenRuns:typeof markTokenRuns;
42
+ parseInlineQueryFilters:typeof parseInlineQueryFilters;
43
+ maybeEmitVectorIndexStaleWarning:typeof maybeEmitVectorIndexStaleWarning;
44
+ loadLinkedCorpus:typeof loadLinkedCorpus;
45
+ mergeVectorHitsById:typeof mergeVectorHitsById;
46
+ normalizeExtensionProviderHits:typeof normalizeExtensionProviderHits;
47
+ normalizeScoreMap:typeof normalizeScoreMap;
48
+ parseProjectionConfig:typeof parseSearchProjection;
49
+ parseTimestampWindow:typeof parseTimestampWindow;
50
+ parseTokens:typeof parseSearchTokens;
51
+ projectSearchHits:typeof projectSearchHits;
52
+ readSearchFieldValue:typeof readSearchFieldValue;
53
+ requireSemanticDependencies:typeof requireSemanticDependencies;
54
+ resolveExtensionSearchProvider:typeof resolveExtensionSearchProvider;
55
+ resolveExtensionSearchProviderByName:typeof resolveExtensionSearchProviderByName;
56
+ resolveExtensionVectorAdapter:typeof resolveExtensionVectorAdapter;
57
+ resolveLinkedCorpusRoots:typeof resolveLinkedCorpusRoots;
58
+ scoreDocument:typeof scoreDocument;
59
+ sortHits:typeof sortHits;
60
+ stringArray:typeof stringArray;
61
+ textEntries:typeof textEntries;
62
+ validateSearchProjectionFields:typeof validateSearchProjectionFields;
63
63
  };
64
64
  /** Implements run search for the public runtime surface of this module. */
65
- export declare function runSearch(rawQuery: string, rawOptions: SearchOptions, global: GlobalOptions): Promise<SearchResult>;
65
+ export declare function runSearch(rawQuery:string,rawOptions:SearchOptions,global:GlobalOptions):Promise<SearchResult>;
@@ -1,3 +1,3 @@
1
- import type { WorkspaceContracts, WorkspaceContractsOptions } from "../runtime-public-contracts.js";
1
+ import type { WorkspaceContracts,WorkspaceContractsOptions } from "../runtime-public-contracts.js";
2
2
  /** Read current types, statuses, fields, and activated extension commands for a workspace. */
3
- export declare function getWorkspaceContracts(pmRoot: string, options?: WorkspaceContractsOptions): Promise<WorkspaceContracts>;
3
+ export declare function getWorkspaceContracts(pmRoot:string,options?:WorkspaceContractsOptions):Promise<WorkspaceContracts>;