@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
@@ -3,96 +3,96 @@ import type { ExtensionScope } from "../extension.js";
3
3
  /** Documents the managed extension source payload exchanged by command, SDK, and package integrations. */
4
4
  export interface ManagedExtensionSource {
5
5
  /** Value that configures or reports kind for this contract. */
6
- kind: "local" | "github" | "npm" | "builtin";
6
+ kind:"local" | "github" | "npm" | "builtin";
7
7
  /** Value that configures or reports input for this contract. */
8
- input: string;
8
+ input:string;
9
9
  /** Value that configures or reports location for this contract. */
10
- location: string;
10
+ location:string;
11
11
  /** Value that configures or reports name for this contract. */
12
- name?: string;
12
+ name?:string;
13
13
  /** Value that configures or reports package for this contract. */
14
- package?: string;
14
+ package?:string;
15
15
  /** Value that configures or reports version for this contract. */
16
- version?: string;
16
+ version?:string;
17
17
  /** Value that configures or reports repository for this contract. */
18
- repository?: string;
18
+ repository?:string;
19
19
  /** Value that configures or reports owner for this contract. */
20
- owner?: string;
20
+ owner?:string;
21
21
  /** Value that configures or reports repo for this contract. */
22
- repo?: string;
22
+ repo?:string;
23
23
  /** Value that configures or reports ref for this contract. */
24
- ref?: string;
24
+ ref?:string;
25
25
  /** Value that configures or reports subpath for this contract. */
26
- subpath?: string;
26
+ subpath?:string;
27
27
  /** Value that configures or reports commit for this contract. */
28
- commit?: string;
28
+ commit?:string;
29
29
  }
30
30
  /** Documents the managed extension record payload exchanged by command, SDK, and package integrations. */
31
31
  export interface ManagedExtensionRecord {
32
32
  /** Value that configures or reports name for this contract. */
33
- name: string;
33
+ name:string;
34
34
  /** Value that configures or reports directory for this contract. */
35
- directory: string;
35
+ directory:string;
36
36
  /** Value that configures or reports scope for this contract. */
37
- scope: ExtensionScope;
37
+ scope:ExtensionScope;
38
38
  /** Value that configures or reports manifest version for this contract. */
39
- manifest_version: string;
39
+ manifest_version:string;
40
40
  /** Value that configures or reports manifest entry for this contract. */
41
- manifest_entry: string;
41
+ manifest_entry:string;
42
42
  /** Value that configures or reports capabilities for this contract. */
43
- capabilities: string[];
43
+ capabilities:string[];
44
44
  /** Install-time snapshot of every registered extension surface. */
45
- contributions?: ExtensionContributionInventory;
45
+ contributions?:ExtensionContributionInventory;
46
46
  /** ISO 8601 timestamp recording when installed occurred. */
47
- installed_at: string;
47
+ installed_at:string;
48
48
  /** ISO 8601 timestamp recording when updated occurred. */
49
- updated_at: string;
49
+ updated_at:string;
50
50
  /** Value that configures or reports source for this contract. */
51
- source: ManagedExtensionSource;
51
+ source:ManagedExtensionSource;
52
52
  /** ISO 8601 timestamp recording when last update check occurred. */
53
- last_update_check_at?: string;
53
+ last_update_check_at?:string;
54
54
  /** Value that configures or reports last update remote commit for this contract. */
55
- last_update_remote_commit?: string;
55
+ last_update_remote_commit?:string;
56
56
  /** Latest registry version observed by a diagnostic check; diagnostics never persist this field. */
57
- last_update_remote_version?: string;
57
+ last_update_remote_version?:string;
58
58
  /** Value that configures or reports update available for this contract. */
59
- update_available?: boolean | null;
59
+ update_available?:boolean | null;
60
60
  /** Value that configures or reports update error for this contract. */
61
- update_error?: string;
61
+ update_error?:string;
62
62
  }
63
63
  /** Documents the managed extension state payload exchanged by command, SDK, and package integrations. */
64
64
  export interface ManagedExtensionState {
65
65
  /** Value that configures or reports version for this contract. */
66
- version: number;
66
+ version:number;
67
67
  /** ISO 8601 timestamp recording when updated occurred. */
68
- updated_at: string;
68
+ updated_at:string;
69
69
  /** Value that configures or reports entries for this contract. */
70
- entries: ManagedExtensionRecord[];
70
+ entries:ManagedExtensionRecord[];
71
71
  }
72
72
  /** Documents the managed extension state read result payload exchanged by command, SDK, and package integrations. */
73
73
  export interface ManagedExtensionStateReadResult {
74
74
  /** Filesystem path used for path resolution. */
75
- path: string;
75
+ path:string;
76
76
  /** Value that configures or reports state for this contract. */
77
- state: ManagedExtensionState;
77
+ state:ManagedExtensionState;
78
78
  /** Value that configures or reports warnings for this contract. */
79
- warnings: string[];
79
+ warnings:string[];
80
80
  }
81
81
  /** Implements resolve managed extension state path for the public runtime surface of this module. */
82
- export declare function resolveManagedExtensionStatePath(extensionsRoot: string): string;
82
+ export declare function resolveManagedExtensionStatePath(extensionsRoot:string):string;
83
83
  /** Implements create empty managed extension state for the public runtime surface of this module. */
84
- export declare function createEmptyManagedExtensionState(): ManagedExtensionState;
84
+ export declare function createEmptyManagedExtensionState():ManagedExtensionState;
85
85
  /** Implements sort managed entries for the public runtime surface of this module. */
86
- export declare function sortManagedEntries(entries: ManagedExtensionRecord[]): ManagedExtensionRecord[];
86
+ export declare function sortManagedEntries(entries:ManagedExtensionRecord[]):ManagedExtensionRecord[];
87
87
  /** Implements managed extension sources equivalent for the public runtime surface of this module. */
88
- export declare function managedExtensionSourcesEquivalent(left: ManagedExtensionSource, right: ManagedExtensionSource): boolean;
88
+ export declare function managedExtensionSourcesEquivalent(left:ManagedExtensionSource,right:ManagedExtensionSource):boolean;
89
89
  /** Implements normalize managed state for the public runtime surface of this module. */
90
- export declare function normalizeManagedState(raw: unknown): ManagedExtensionState | null;
90
+ export declare function normalizeManagedState(raw:unknown):ManagedExtensionState | null;
91
91
  /** Implements read managed extension state for the public runtime surface of this module. */
92
- export declare function readManagedExtensionState(extensionsRoot: string): Promise<ManagedExtensionStateReadResult>;
92
+ export declare function readManagedExtensionState(extensionsRoot:string):Promise<ManagedExtensionStateReadResult>;
93
93
  /** Implements write managed extension state for the public runtime surface of this module. */
94
- export declare function writeManagedExtensionState(extensionsRoot: string, state: ManagedExtensionState): Promise<void>;
94
+ export declare function writeManagedExtensionState(extensionsRoot:string,state:ManagedExtensionState):Promise<void>;
95
95
  /** Implements upsert managed entry for the public runtime surface of this module. */
96
- export declare function upsertManagedEntry(state: ManagedExtensionState, entry: ManagedExtensionRecord): ManagedExtensionState;
96
+ export declare function upsertManagedEntry(state:ManagedExtensionState,entry:ManagedExtensionRecord):ManagedExtensionState;
97
97
  /** Persist a verified install-time contribution inventory on its managed record. */
98
- export declare function persistManagedContributionInventory(extensionsRoot: string, state: ManagedExtensionState, extensionName: string, contributions: ExtensionContributionInventory): Promise<ManagedExtensionState>;
98
+ export declare function persistManagedContributionInventory(extensionsRoot:string,state:ManagedExtensionState,extensionName:string,contributions:ExtensionContributionInventory):Promise<ManagedExtensionState>;
@@ -1,3 +1,3 @@
1
1
  import { type ManagedExtensionState } from "./managed-state.js";
2
2
  /** Return transient provider evidence while preserving the caller's recorded installation state. */
3
- export declare function refreshManagedExtensionUpdates(state: ManagedExtensionState, offline?: boolean): Promise<ManagedExtensionState>;
3
+ export declare function refreshManagedExtensionUpdates(state:ManagedExtensionState,offline?:boolean):Promise<ManagedExtensionState>;
@@ -1,114 +1,114 @@
1
1
  import type { RegisteredExtensionSchemaMigrationDefinition } from "../../core/extensions/extension-types.js";
2
- import type { ExtensionCommandResult, ExtensionScope } from "../extension.js";
2
+ import type { ExtensionCommandResult,ExtensionScope } from "../extension.js";
3
3
  /** Durable lifecycle state of one extension migration in one workspace. */
4
4
  export type ExtensionMigrationOutcomeStatus = "applied" | "failed";
5
5
  /** One durable extension-migration outcome. */
6
6
  export interface ExtensionMigrationStateEntry {
7
7
  /** Stable layer/name/id identity. */
8
- key: string;
8
+ key:string;
9
9
  /** Extension installation layer. */
10
- layer: "global" | "project";
10
+ layer:"global" | "project";
11
11
  /** Owning extension name. */
12
- extension: string;
12
+ extension:string;
13
13
  /** Migration identifier declared by the extension. */
14
- id: string;
14
+ id:string;
15
15
  /** Last durable outcome. */
16
- status: ExtensionMigrationOutcomeStatus;
16
+ status:ExtensionMigrationOutcomeStatus;
17
17
  /** ISO timestamp for the last attempt. */
18
- attempted_at: string;
18
+ attempted_at:string;
19
19
  /** Failure text retained only for failed outcomes. */
20
- error?: string;
20
+ error?:string;
21
21
  }
22
22
  /** Versioned workspace state for extension migrations. */
23
23
  export interface ExtensionMigrationState {
24
24
  /** Storage schema version. */
25
- version: 1;
25
+ version:1;
26
26
  /** Last state change timestamp. */
27
- updated_at: string;
27
+ updated_at:string;
28
28
  /** Deterministically sorted outcomes. */
29
- entries: ExtensionMigrationStateEntry[];
29
+ entries:ExtensionMigrationStateEntry[];
30
30
  }
31
31
  /** Planned or executed row returned for one registered migration. */
32
32
  export interface ExtensionMigrationReceipt {
33
33
  /** Stable layer/name/id identity. */
34
- key: string;
34
+ key:string;
35
35
  /** Extension installation layer. */
36
- layer: "global" | "project";
36
+ layer:"global" | "project";
37
37
  /** Owning extension name. */
38
- extension: string;
38
+ extension:string;
39
39
  /** Migration identifier. */
40
- id: string;
40
+ id:string;
41
41
  /** State observed before this invocation. */
42
- before: "pending" | ExtensionMigrationOutcomeStatus;
42
+ before:"pending" | ExtensionMigrationOutcomeStatus;
43
43
  /** Invocation outcome. */
44
- outcome: "pending" | "applied" | "skipped" | "failed";
44
+ outcome:"pending" | "applied" | "skipped" | "failed";
45
45
  /** Failure text for failed execution. */
46
- error?: string;
46
+ error?:string;
47
47
  }
48
48
  /** Structured plan/application envelope for extension migrations. */
49
49
  export interface ExtensionMigrationRunResult {
50
50
  /** Whether the invocation executed no failing migration. */
51
- ok: boolean;
51
+ ok:boolean;
52
52
  /** Whether execution was suppressed. */
53
- dry_run: boolean;
53
+ dry_run:boolean;
54
54
  /** Durable state path. */
55
- state_path: string;
55
+ state_path:string;
56
56
  /** Total registered migrations in scope. */
57
- total: number;
57
+ total:number;
58
58
  /** Pending rows in the returned receipt. */
59
- pending_count: number;
59
+ pending_count:number;
60
60
  /** Applied rows in the returned receipt. */
61
- applied_count: number;
61
+ applied_count:number;
62
62
  /** Already-applied rows skipped idempotently. */
63
- skipped_count: number;
63
+ skipped_count:number;
64
64
  /** Failed rows in the returned receipt. */
65
- failed_count: number;
65
+ failed_count:number;
66
66
  /** Deterministically ordered per-migration receipts. */
67
- migrations: ExtensionMigrationReceipt[];
67
+ migrations:ExtensionMigrationReceipt[];
68
68
  }
69
69
  /** Options for planning or applying active extension migrations. */
70
70
  export interface RunExtensionMigrationsOptions {
71
71
  /** Tracker root that owns durable migration state. */
72
- pmRoot: string;
72
+ pmRoot:string;
73
73
  /** Active runtime registrations. */
74
- migrations: RegisteredExtensionSchemaMigrationDefinition[];
74
+ migrations:RegisteredExtensionSchemaMigrationDefinition[];
75
75
  /** Audit author written to workspace history. */
76
- author: string;
76
+ author:string;
77
77
  /** Report pending work without invoking extension code. */
78
- dryRun?: boolean;
78
+ dryRun?:boolean;
79
79
  /** Limit execution and receipts to one installation layer. */
80
- scope?: "global" | "project";
80
+ scope?:"global" | "project";
81
81
  }
82
82
  /** Minimal lifecycle context required by the migration action dispatcher. */
83
83
  export interface ExtensionMigrationActionContext {
84
84
  /** Selected package scope. */
85
- scope: ExtensionScope;
85
+ scope:ExtensionScope;
86
86
  /** Tracker and settings roots for the invocation. */
87
- resolvedRoots: {
88
- pm_root: string;
89
- settings_root: string;
87
+ resolvedRoots:{
88
+ pm_root:string;
89
+ settings_root:string;
90
90
  };
91
91
  /** Mutable warning collection shared with the lifecycle result. */
92
- warnings: string[];
92
+ warnings:string[];
93
93
  /** Migration-specific command options. */
94
- options: {
95
- dryRun?: boolean;
94
+ options:{
95
+ dryRun?:boolean;
96
96
  };
97
97
  /** Relevant global runtime options. */
98
- global: {
99
- noExtensions?: boolean;
100
- author?: string;
98
+ global:{
99
+ noExtensions?:boolean;
100
+ author?:string;
101
101
  };
102
102
  /** Construct the standard extension lifecycle result envelope. */
103
- withResult: (details: Record<string, unknown>, ok?: boolean) => ExtensionCommandResult;
103
+ withResult:(details:Record<string,unknown>,ok?:boolean) => ExtensionCommandResult;
104
104
  }
105
105
  /** Return the durable workspace path for extension migration state. */
106
- export declare function resolveExtensionMigrationStatePath(pmRoot: string): string;
106
+ export declare function resolveExtensionMigrationStatePath(pmRoot:string):string;
107
107
  /** Read durable extension migration outcomes, degrading absent state to empty. */
108
- export declare function readExtensionMigrationState(pmRoot: string): Promise<ExtensionMigrationState>;
108
+ export declare function readExtensionMigrationState(pmRoot:string):Promise<ExtensionMigrationState>;
109
109
  /** Overlay durable outcomes onto freshly activated migration definitions. */
110
- export declare function applyStoredExtensionMigrationState(pmRoot: string, migrations: RegisteredExtensionSchemaMigrationDefinition[]): Promise<ExtensionMigrationState>;
110
+ export declare function applyStoredExtensionMigrationState(pmRoot:string,migrations:RegisteredExtensionSchemaMigrationDefinition[]):Promise<ExtensionMigrationState>;
111
111
  /** Plan or apply active extension migrations with durable idempotency receipts. */
112
- export declare function runExtensionMigrations(options: RunExtensionMigrationsOptions): Promise<ExtensionMigrationRunResult>;
112
+ export declare function runExtensionMigrations(options:RunExtensionMigrationsOptions):Promise<ExtensionMigrationRunResult>;
113
113
  /** Load active registrations and execute the extension lifecycle migrate action. */
114
- export declare function runExtensionMigrateAction(context: ExtensionMigrationActionContext): Promise<ExtensionCommandResult>;
114
+ export declare function runExtensionMigrateAction(context:ExtensionMigrationActionContext):Promise<ExtensionCommandResult>;
@@ -1,31 +1,31 @@
1
1
  interface OutputActivationSummary {
2
- services: {
3
- overrides: Array<{
4
- service: string;
5
- layer: string;
6
- name: string;
7
- passThrough?: boolean;
2
+ services:{
3
+ overrides:Array<{
4
+ service:string;
5
+ layer:string;
6
+ name:string;
7
+ passThrough?:boolean;
8
8
  }>;
9
9
  };
10
- renderers: {
11
- overrides: Array<{
12
- format: string;
13
- layer: string;
14
- name: string;
15
- commands?: string[];
16
- resultDiscriminator?: (result: unknown) => boolean;
10
+ renderers:{
11
+ overrides:Array<{
12
+ format:string;
13
+ layer:string;
14
+ name:string;
15
+ commands?:string[];
16
+ resultDiscriminator?:(result:unknown) => boolean;
17
17
  }>;
18
18
  };
19
19
  }
20
20
  interface OutputLoadSummary {
21
- loaded: Array<{
22
- layer: string;
23
- name: string;
24
- activation?: {
25
- commands?: string[];
21
+ loaded:Array<{
22
+ layer:string;
23
+ name:string;
24
+ activation?:{
25
+ commands?:string[];
26
26
  };
27
27
  }>;
28
28
  }
29
29
  /** Collect doctor warnings for output overrides without an explicit command or result ownership boundary. */
30
- export declare function collectGlobalOutputOverrideDoctorWarnings(activationResult: OutputActivationSummary, loadResult?: OutputLoadSummary): string[];
30
+ export declare function collectGlobalOutputOverrideDoctorWarnings(activationResult:OutputActivationSummary,loadResult?:OutputLoadSummary):string[];
31
31
  export {};
@@ -1,9 +1,9 @@
1
1
  /** Return stable runtime command and action paths registered by one extension. */
2
- export declare function summarizeRuntimeCommandPathsForExtension(extensionName: string, installed: ReadonlyArray<{
3
- name: string;
4
- command_paths?: string[];
5
- action_paths?: string[];
6
- }>): {
7
- command_paths: string[];
8
- action_paths: string[];
2
+ export declare function summarizeRuntimeCommandPathsForExtension(extensionName:string,installed:ReadonlyArray<{
3
+ name:string;
4
+ command_paths?:string[];
5
+ action_paths?:string[];
6
+ }>):{
7
+ command_paths:string[];
8
+ action_paths:string[];
9
9
  };
@@ -1,26 +1,26 @@
1
1
  /** Public contract for scaffold pm min version, shared by SDK and presentation-layer consumers. */
2
2
  export declare const SCAFFOLD_PM_MIN_VERSION = "2026.6.24";
3
3
  /** Capability shapes the package/extension scaffolder can target via the `--capability` selector — one per SDK extension capability, so every registration surface has a runnable starter. `commands` emits the default command-only starter; `hooks` additionally wires an `after_command` lifecycle reactor; `search` wires an in-memory provider/adapter pair; `importers` wires importer and exporter command primitives so authors can customize project context movement; `schema` registers a custom item type, item field, and migration so authors can model their own project domain; `profile` registers a complete project-profile archetype (item types, statuses, fields, a workflow, config, a template, and package recommendations) via `api.registerProfile` so `pm profile apply` can tailor a tracker in one shot; `renderers` overrides how a command's output is serialized for a format; `parser` rewrites a command's parsed options before its handler runs; `preflight` adjusts pm's pre-run migration/format gate decision; and `services` overrides a built-in pm service (e.g. output formatting) — without starting from a blank extension. */
4
- export declare const SCAFFOLD_CAPABILITIES: readonly ["commands", "hooks", "search", "importers", "schema", "profile", "renderers", "parser", "preflight", "services"];
4
+ export declare const SCAFFOLD_CAPABILITIES:readonly ["commands","hooks","search","importers","schema","profile","renderers","parser","preflight","services"];
5
5
  /**
6
6
  * Restricts the `--capability` selector to a {@link SCAFFOLD_CAPABILITIES} value.
7
7
  */
8
8
  export type ExtensionScaffoldCapability = (typeof SCAFFOLD_CAPABILITIES)[number];
9
9
  interface ExtensionScaffoldFileResult {
10
- path: string;
11
- status: "created" | "unchanged";
10
+ path:string;
11
+ status:"created" | "unchanged";
12
12
  }
13
13
  interface ExtensionScaffoldResult {
14
- extension_name: string;
15
- package_name: string;
16
- command_name: string;
17
- invocation_command: string;
18
- capability: ExtensionScaffoldCapability;
14
+ extension_name:string;
15
+ package_name:string;
16
+ command_name:string;
17
+ invocation_command:string;
18
+ capability:ExtensionScaffoldCapability;
19
19
  /** Authoring style of the generated entrypoint: `"imperative"` (a hand-written `activate` body, the default) or `"declarative"` (a `composeExtension` blueprint). The declarative style is package-mode only (any capability). */
20
- style: ExtensionScaffoldStyle;
21
- target_path: string;
22
- created_directory: boolean;
23
- files: ExtensionScaffoldFileResult[];
20
+ style:ExtensionScaffoldStyle;
21
+ target_path:string;
22
+ created_directory:boolean;
23
+ files:ExtensionScaffoldFileResult[];
24
24
  }
25
25
  /**
26
26
  * Authoring style the scaffolder targets for the generated entrypoint. The
@@ -30,9 +30,9 @@ files: ExtensionScaffoldFileResult[];
30
30
  */
31
31
  export type ExtensionScaffoldStyle = "imperative" | "declarative";
32
32
  /** Builds the starter command path from the normalized package/extension name. Names that start with a built-in pm command or executable alias are prefixed with `starter` so the generated command dispatches to the package instead of being consumed by core command parsing. */
33
- export declare function buildScaffoldCommandName(extensionName: string): string;
33
+ export declare function buildScaffoldCommandName(extensionName:string):string;
34
34
  /** Implements build starter extension scaffold files for the public runtime surface of this module. */
35
- export declare function buildStarterExtensionScaffoldFiles(extensionName: string, commandName: string, _vocabulary: "extension" | "package", capability?: ExtensionScaffoldCapability, declarative?: boolean): Record<string, string>;
35
+ export declare function buildStarterExtensionScaffoldFiles(extensionName:string,commandName:string,_vocabulary:"extension" | "package",capability?:ExtensionScaffoldCapability,declarative?:boolean):Record<string,string>;
36
36
  /** Implements scaffold extension project for the public runtime surface of this module. */
37
- export declare function scaffoldExtensionProject(target: string, vocabulary?: "extension" | "package", capability?: string, declarative?: boolean): Promise<ExtensionScaffoldResult>;
37
+ export declare function scaffoldExtensionProject(target:string,vocabulary?:"extension" | "package",capability?:string,declarative?:boolean):Promise<ExtensionScaffoldResult>;
38
38
  export {};
@@ -1,37 +1,37 @@
1
- import { isCanonicalPathWithinDirectory, type ExtensionManifest } from "../../core/extensions/loader.js";
1
+ import { isCanonicalPathWithinDirectory,type ExtensionManifest } from "../../core/extensions/loader.js";
2
2
  export { isCanonicalPathWithinDirectory };
3
3
  /** Documents the validated extension directory payload exchanged by command, SDK, and package integrations. */
4
4
  export interface ValidatedExtensionDirectory {
5
5
  /** Value that configures or reports directory for this contract. */
6
- directory: string;
6
+ directory:string;
7
7
  /** Filesystem path used for manifest resolution. */
8
- manifest_path: string;
8
+ manifest_path:string;
9
9
  /** Filesystem path used for entry resolution. */
10
- entry_path: string;
10
+ entry_path:string;
11
11
  /** Declarative package manifest consumed by the extension loader. */
12
- manifest: ExtensionManifest;
12
+ manifest:ExtensionManifest;
13
13
  }
14
14
  /** Optional install-source evidence used to make validation failures actionable. */
15
15
  export interface ExtensionDirectoryValidationContext {
16
16
  /** Source kind whose behavior explains a missing built artifact. */
17
- source_kind?: "github" | "local" | "npm";
17
+ source_kind?:"github" | "local" | "npm";
18
18
  /** Original source spelling shown in recovery guidance. */
19
- source_input?: string;
19
+ source_input?:string;
20
20
  /** Package root containing package.json for source-aware diagnostics. */
21
- source_root?: string;
21
+ source_root?:string;
22
22
  }
23
23
  /** Implements normalize string list for the public runtime surface of this module. */
24
- export declare function normalizeStringList(values: readonly string[]): string[];
24
+ export declare function normalizeStringList(values:readonly string[]):string[];
25
25
  /** Implements normalize extension name for match for the public runtime surface of this module. */
26
- export declare function normalizeExtensionNameForMatch(value: string): string;
26
+ export declare function normalizeExtensionNameForMatch(value:string):string;
27
27
  /** Implements normalize managed directory name for the public runtime surface of this module. */
28
- export declare function normalizeManagedDirectoryName(name: string): string;
28
+ export declare function normalizeManagedDirectoryName(name:string):string;
29
29
  /** Implements parse extension manifest for the public runtime surface of this module. */
30
- export declare function parseExtensionManifest(raw: unknown): ExtensionManifest | null;
30
+ export declare function parseExtensionManifest(raw:unknown):ExtensionManifest | null;
31
31
  /** Implements validate extension directory for the public runtime surface of this module. */
32
- export declare function validateExtensionDirectory(directory: string, context?: ExtensionDirectoryValidationContext): Promise<ValidatedExtensionDirectory>;
33
- declare function formatManifestReadError(error: unknown): string;
32
+ export declare function validateExtensionDirectory(directory:string,context?:ExtensionDirectoryValidationContext):Promise<ValidatedExtensionDirectory>;
33
+ declare function formatManifestReadError(error:unknown):string;
34
34
  /** Public contract for test only extension shared, shared by SDK and presentation-layer consumers. */
35
- export declare const _testOnlyExtensionShared: {
36
- formatManifestReadError: typeof formatManifestReadError;
35
+ export declare const _testOnlyExtensionShared:{
36
+ formatManifestReadError:typeof formatManifestReadError;
37
37
  };
@@ -3,44 +3,44 @@ import type { ManagedExtensionRecord } from "./managed-state.js";
3
3
  /** Selected install-source identity. */
4
4
  export interface ExtensionInstallSourceSelection {
5
5
  /** Selected source family. */
6
- kind: "builtin" | "local" | "github" | "npm";
6
+ kind:"builtin" | "local" | "github" | "npm";
7
7
  /** Canonical source input used for resolution. */
8
- input: string;
8
+ input:string;
9
9
  /** Canonical package name when known. */
10
- package?: string;
10
+ package?:string;
11
11
  }
12
12
  /** One source candidate and the explicit command that selects it. */
13
13
  export interface ExtensionInstallSourceCandidate extends ExtensionInstallSourceSelection {
14
14
  /** Installed candidate version when known. */
15
- version?: string;
15
+ version?:string;
16
16
  /** Installed candidate directory when relevant. */
17
- directory?: string;
17
+ directory?:string;
18
18
  /** Unambiguous CLI command that selects this candidate. */
19
- command: string;
19
+ command:string;
20
20
  }
21
21
  /** Machine-readable explanation of how one install target resolved. */
22
22
  export interface ExtensionInstallSourceResolution {
23
23
  /** Exact target supplied by the caller. */
24
- requested: string;
24
+ requested:string;
25
25
  /** Source selected by the deterministic resolver. */
26
- selected: ExtensionInstallSourceSelection;
26
+ selected:ExtensionInstallSourceSelection;
27
27
  /** Whether another locally available source could satisfy the same bare name. */
28
- ambiguous: boolean;
28
+ ambiguous:boolean;
29
29
  /** Stable precedence rule used for the selection. */
30
- precedence: "bundled_alias_before_installed_npm";
30
+ precedence:"bundled_alias_before_installed_npm";
31
31
  /** Every matching candidate and its explicit install command. */
32
- candidates: ExtensionInstallSourceCandidate[];
32
+ candidates:ExtensionInstallSourceCandidate[];
33
33
  }
34
34
  /** Complete result of resolving one extension install target. */
35
35
  export interface ResolvedExtensionInstallSource {
36
36
  /** Normalized bundled alias, or null for non-bundled sources. */
37
- bundledAliasName: string | null;
37
+ bundledAliasName:string | null;
38
38
  /** Bundled package name, or null when unavailable. */
39
- bundledPackageName: string | null;
39
+ bundledPackageName:string | null;
40
40
  /** Parsed source passed to the install resolver. */
41
- installSource: InstallSource;
41
+ installSource:InstallSource;
42
42
  /** Observable source-selection decision. */
43
- sourceResolution: ExtensionInstallSourceResolution;
43
+ sourceResolution:ExtensionInstallSourceResolution;
44
44
  }
45
45
  /** Resolve bundled-alias provenance and competing installed npm identity. */
46
- export declare function resolveExtensionInstallSourceIdentity(explicitSourceInput: string, githubOption: string | undefined, ref: string | undefined, managedEntries?: readonly ManagedExtensionRecord[]): Promise<ResolvedExtensionInstallSource>;
46
+ export declare function resolveExtensionInstallSourceIdentity(explicitSourceInput:string,githubOption:string | undefined,ref:string | undefined,managedEntries?:readonly ManagedExtensionRecord[]):Promise<ResolvedExtensionInstallSource>;
@@ -1,54 +1,54 @@
1
1
  /** One read failure or malformed document that prevents a complete inventory. */
2
2
  export interface StaticExtensionInventoryError {
3
3
  /** Stable machine-readable reason. */
4
- code: "settings_invalid" | "settings_unreadable" | "managed_state_invalid" | "managed_state_unreadable" | "extensions_unreadable" | "manifest_invalid" | "manifest_unreadable";
4
+ code:"settings_invalid" | "settings_unreadable" | "managed_state_invalid" | "managed_state_unreadable" | "extensions_unreadable" | "manifest_invalid" | "manifest_unreadable";
5
5
  /** File or directory whose read failed. */
6
- path: string;
6
+ path:string;
7
7
  }
8
8
  /** A configured package; runtime activation has deliberately not been tested. */
9
9
  export interface StaticExtensionInventoryEntry {
10
10
  /** Manifest name, or directory name when the manifest is malformed. */
11
- name: string;
11
+ name:string;
12
12
  /** Extension directory basename. */
13
- directory: string | null;
13
+ directory:string | null;
14
14
  /** Selected storage scope. */
15
- scope: "project" | "global";
15
+ scope:"project" | "global";
16
16
  /** Whether an installed directory was found. */
17
- installed: boolean;
17
+ installed:boolean;
18
18
  /** Installed, disabled, absent, or unreadable manifest outcome. */
19
- status: "installed" | "inactive" | "absent" | "malformed_manifest";
19
+ status:"installed" | "inactive" | "absent" | "malformed_manifest";
20
20
  /** Effective configured state; null when settings cannot be trusted. */
21
- configured_enabled: boolean | null;
21
+ configured_enabled:boolean | null;
22
22
  /** Whether managed metadata identifies this install; null when that metadata is invalid. */
23
- managed: boolean | null;
23
+ managed:boolean | null;
24
24
  /** Runtime state is never inferred from configuration. */
25
- runtime_active: null;
25
+ runtime_active:null;
26
26
  /** Manifest version when available. */
27
- version?: string;
27
+ version?:string;
28
28
  }
29
29
  /** A read-only inventory with explicit completeness and source receipts. */
30
30
  export interface StaticExtensionInventoryResult {
31
31
  /** Selected storage scope. */
32
- scope: "project" | "global";
32
+ scope:"project" | "global";
33
33
  /** False if any source could not be read or parsed completely. */
34
- complete: boolean;
34
+ complete:boolean;
35
35
  /** Status of the two configuration sources. */
36
- settings_status: "ok" | "absent" | "invalid" | "unreadable";
36
+ settings_status:"ok" | "absent" | "invalid" | "unreadable";
37
37
  /** Status of the managed install metadata. */
38
- managed_state_status: "ok" | "absent" | "invalid" | "unreadable";
38
+ managed_state_status:"ok" | "absent" | "invalid" | "unreadable";
39
39
  /** Installed entries, or one absent entry for a missing requested name. */
40
- extensions: StaticExtensionInventoryEntry[];
40
+ extensions:StaticExtensionInventoryEntry[];
41
41
  /** Every failure that affected completeness. */
42
- errors: StaticExtensionInventoryError[];
42
+ errors:StaticExtensionInventoryError[];
43
43
  }
44
44
  /** Read configured extension state through filesystem reads only. */
45
- export declare function inspectStaticExtensionInventory(options: {
45
+ export declare function inspectStaticExtensionInventory(options:{
46
46
  /** Tracker root for the project scope. */
47
- pmRoot: string;
47
+ pmRoot:string;
48
48
  /** Storage scope; project is the default. */
49
- scope?: "project" | "global";
49
+ scope?:"project" | "global";
50
50
  /** Optional name or directory to inspect, including absent installs. */
51
- name?: string;
51
+ name?:string;
52
52
  /** Base directory used to resolve the global PM root. */
53
- cwd?: string;
54
- }): Promise<StaticExtensionInventoryResult>;
53
+ cwd?:string;
54
+ }):Promise<StaticExtensionInventoryResult>;