@unbrained/pm-cli 2026.10.13 → 2026.10.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +1 -1
- package/CHANGELOG.md +72 -1
- package/dist/cli/after-command-context-usage.d.ts +7 -7
- package/dist/cli/argv-utils.d.ts +4 -4
- package/dist/cli/bundle-integrity.d.ts +16 -16
- package/dist/cli/command-namespaces.d.ts +1 -1
- package/dist/cli/commander-usage.d.ts +34 -34
- package/dist/cli/commands/governance/validate.d.ts +1 -1
- package/dist/cli/commands/history/history-compact.d.ts +1 -1
- package/dist/cli/commands/history/history-redact.d.ts +1 -1
- package/dist/cli/commands/history/history-repair.d.ts +1 -1
- package/dist/cli/commands/history/restore.d.ts +1 -1
- package/dist/cli/commands/lifecycle/close.d.ts +1 -1
- package/dist/cli/commands/lifecycle/copy.d.ts +1 -1
- package/dist/cli/commands/lifecycle/delete.d.ts +1 -1
- package/dist/cli/commands/lifecycle/focus.d.ts +1 -1
- package/dist/cli/commands/query/get.d.ts +1 -1
- package/dist/cli/commands/workspace/merge.d.ts +1 -1
- package/dist/cli/commands/workspace/schema.d.ts +1 -1
- package/dist/cli/context-intent-invocation.d.ts +1 -1
- package/dist/cli/description-stdin.d.ts +1 -1
- package/dist/cli/error-guidance.d.ts +119 -119
- package/dist/cli/extension-command-help.d.ts +64 -64
- package/dist/cli/extension-command-help.js +2 -2
- package/dist/cli/extension-command-options.d.ts +16 -16
- package/dist/cli/extension-command-options.js +1 -1
- package/dist/cli/extension-recovery.d.ts +13 -13
- package/dist/cli/help-content.d.ts +22 -22
- package/dist/cli/help-content.js +2 -2
- package/dist/cli/help-json-payload.d.ts +45 -45
- package/dist/cli/invocation-profile.d.ts +5 -5
- package/dist/cli/main.d.ts +217 -217
- package/dist/cli/main.js +2 -2
- package/dist/cli/migration-gates.d.ts +24 -24
- package/dist/cli/option-values.d.ts +1 -1
- package/dist/cli/public.d.ts +1 -1
- package/dist/cli/register-annotations.d.ts +2 -2
- package/dist/cli/register-assurance.d.ts +1 -1
- package/dist/cli/register-files-lookup.d.ts +1 -1
- package/dist/cli/register-history-activity.d.ts +1 -1
- package/dist/cli/register-history-author.d.ts +1 -1
- package/dist/cli/register-history-maintenance.d.ts +1 -1
- package/dist/cli/register-list-query.d.ts +7 -7
- package/dist/cli/register-list-query.js +3 -3
- package/dist/cli/register-mutation-options.d.ts +1 -1
- package/dist/cli/register-mutation.d.ts +4 -4
- package/dist/cli/register-operations.d.ts +75 -75
- package/dist/cli/register-setup.d.ts +4 -4
- package/dist/cli/register-structured-mutation.d.ts +8 -8
- package/dist/cli/runtime/activation.d.ts +23 -23
- package/dist/cli/runtime/invocation-options.d.ts +12 -12
- package/dist/cli/runtime/projection-retry.d.ts +1 -1
- package/dist/cli/runtime/selection.d.ts +16 -16
- package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
- package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
- package/dist/cli/schema/registration.d.ts +1 -1
- package/dist/cli/schema-registration-helpers.d.ts +2 -2
- package/dist/cli/stats-analytics-json.d.ts +1 -1
- package/dist/cli-bundle/bundle-manifest.json +1 -1
- package/dist/cli-bundle/chunks/{chunk-LBDWFWPK.js → chunk-52EZH2QQ.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-7OEGNA4X.js +20 -0
- package/dist/cli-bundle/chunks/{chunk-APWPC4ZZ.js → chunk-7VHINXZP.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-EMEEHV2Y.js +2 -0
- package/dist/cli-bundle/chunks/chunk-JGKTOBVB.js +6 -0
- package/dist/cli-bundle/chunks/{chunk-PSNS537F.js → chunk-JSUJWIHQ.js} +30 -30
- package/dist/cli-bundle/chunks/{chunk-N5EXRYCZ.js → chunk-LNKLQYBG.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-YH6H3UVE.js → chunk-N56CAQBU.js} +63 -64
- package/dist/cli-bundle/chunks/chunk-NC3QVGDD.js +8 -0
- package/dist/cli-bundle/chunks/{chunk-AM2XOZKE.js → chunk-RJ5N44WY.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-HXHFKXLV.js → chunk-VIMQCFCK.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-UBTYYZIE.js → chunk-WBBW3WQX.js} +4 -4
- package/dist/cli-bundle/chunks/chunk-X2H6UR26.js +236 -0
- package/dist/cli-bundle/chunks/{register-list-query-BJ742QOR.js → register-list-query-FKKFQ66D.js} +7 -7
- package/dist/cli-bundle/chunks/{register-mutation-GGGBRIH2.js → register-mutation-EWMMVZJB.js} +2 -2
- package/dist/cli-bundle/chunks/{register-operations-E6HXYHNM.js → register-operations-GEQ2H7PS.js} +2 -2
- package/dist/cli-bundle/chunks/{register-setup-4ZVTVEPY.js → register-setup-PSJTQBBO.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-NNW5BS5L.js → chunk-3RNUMVK4.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-3LQEBXU5.js → chunk-4KQFMOM7.js} +6 -6
- package/dist/cli-bundle/focused-chunks/{chunk-RAA7SVRA.js → chunk-52I2SNKJ.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-6BTUISKV.js → chunk-5KRACGBK.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-5OO54BIV.js +3 -0
- package/dist/cli-bundle/focused-chunks/chunk-5TBAVZDR.js +20 -0
- package/dist/cli-bundle/focused-chunks/{chunk-R23T7GFZ.js → chunk-FQKPOZKS.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-IIKFTJVC.js → chunk-H3P77KVU.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-HTA3TNC3.js +26 -0
- package/dist/cli-bundle/focused-chunks/{chunk-73UNAJHD.js → chunk-JKBH7YGX.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-KGFRQ34R.js → chunk-KIIFVULU.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-SOB7X4FJ.js → chunk-N6FUKTZS.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-PDYE7QDX.js +166 -0
- package/dist/cli-bundle/focused-chunks/{chunk-RU6GCFN3.js → chunk-Q4VNCTR2.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-QMNAY25P.js → chunk-THYQR3ON.js} +61 -62
- package/dist/cli-bundle/focused-chunks/{chunk-DVK7VKZL.js → chunk-TYLG5VEB.js} +2 -2
- package/dist/cli-bundle/main.js +27 -27
- package/dist/cli-bundle/sdk-authoring.js +1 -1
- package/dist/cli-bundle/sdk-contracts.js +2 -2
- package/dist/cli-bundle/sdk-core.js +23 -23
- package/dist/cli-bundle/sdk-governance.js +1 -1
- package/dist/cli-bundle/sdk-graph.js +1 -1
- package/dist/cli-bundle/sdk-merge.js +51 -51
- package/dist/cli-bundle/sdk-query.js +1 -1
- package/dist/cli-bundle/sdk-runtime.js +1 -1
- package/dist/cli-bundle/sdk-testing.js +1 -1
- package/dist/cli-bundle/sdk.js +7 -7
- package/dist/cli.d.ts +9 -9
- package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
- package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
- package/dist/core/config/nested-settings.d.ts +20 -20
- package/dist/core/config/positional-value.d.ts +9 -9
- package/dist/core/diagnostics/remediation.d.ts +7 -7
- package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
- package/dist/core/extensions/activation-summary.d.ts +30 -30
- package/dist/core/extensions/activation-transaction.d.ts +9 -9
- package/dist/core/extensions/capability-usage.d.ts +25 -25
- package/dist/core/extensions/command-hook-context.d.ts +15 -15
- package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
- package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
- package/dist/core/extensions/contribution-inventory.d.ts +24 -24
- package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
- package/dist/core/extensions/extension-candidate.d.ts +14 -14
- package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
- package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
- package/dist/core/extensions/extension-policy.d.ts +62 -62
- package/dist/core/extensions/extension-registries.d.ts +8 -8
- package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
- package/dist/core/extensions/extension-types.d.ts +702 -702
- package/dist/core/extensions/flag-definition-validation.d.ts +19 -6
- package/dist/core/extensions/flag-definition-validation.js +1 -1
- package/dist/core/extensions/flag-value-types.d.ts +16 -4
- package/dist/core/extensions/flag-value-types.js +1 -1
- package/dist/core/extensions/index.d.ts +34 -34
- package/dist/core/extensions/item-field-types.d.ts +3 -3
- package/dist/core/extensions/item-fields.d.ts +6 -6
- package/dist/core/extensions/loader.d.ts +66 -66
- package/dist/core/extensions/manifest-parser.d.ts +1 -1
- package/dist/core/extensions/manifest-schema.d.ts +13 -13
- package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
- package/dist/core/extensions/preflight-ownership.d.ts +3 -3
- package/dist/core/extensions/read-output-contract.d.ts +2 -2
- package/dist/core/extensions/registration-contracts.d.ts +12 -12
- package/dist/core/extensions/registration-validation.d.ts +6 -6
- package/dist/core/extensions/registration-values.d.ts +19 -19
- package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
- package/dist/core/extensions/runtime-registrations.d.ts +6 -6
- package/dist/core/extensions/service-ownership.d.ts +1 -1
- package/dist/core/extensions/version-compat.d.ts +9 -9
- package/dist/core/fs/atomic-create.d.ts +1 -1
- package/dist/core/fs/fs-utils.d.ts +12 -12
- package/dist/core/fs/host-environment-errors.d.ts +10 -10
- package/dist/core/fs/path-utils.d.ts +1 -1
- package/dist/core/governance/content-fields.d.ts +25 -25
- package/dist/core/governance/issue-codes.d.ts +16 -16
- package/dist/core/governance/metadata-coverage.d.ts +64 -64
- package/dist/core/history/digest.d.ts +5 -5
- package/dist/core/history/drift-cache.d.ts +2 -2
- package/dist/core/history/drift-scan.d.ts +18 -18
- package/dist/core/history/event-classification.d.ts +4 -4
- package/dist/core/history/event-index.d.ts +33 -33
- package/dist/core/history/history-compact-bulk.d.ts +12 -12
- package/dist/core/history/history-diff.d.ts +15 -15
- package/dist/core/history/history-rewrite.d.ts +43 -43
- package/dist/core/history/history-storage-stats.d.ts +20 -20
- package/dist/core/history/history-stream-policy.d.ts +12 -12
- package/dist/core/history/history.d.ts +45 -45
- package/dist/core/history/identity.d.ts +4 -4
- package/dist/core/history/operation-contract.d.ts +17 -17
- package/dist/core/history/projection.d.ts +16 -16
- package/dist/core/history/read.d.ts +4 -4
- package/dist/core/history/replay.d.ts +47 -47
- package/dist/core/history/tombstone.d.ts +1 -1
- package/dist/core/history/version-address.d.ts +2 -2
- package/dist/core/history/workspace-history.d.ts +72 -72
- package/dist/core/io/body-file.d.ts +2 -2
- package/dist/core/io/bulk-ids-input.d.ts +7 -7
- package/dist/core/item/actionability.d.ts +30 -30
- package/dist/core/item/dependency-reference.d.ts +2 -2
- package/dist/core/item/id.d.ts +9 -9
- package/dist/core/item/item-format-version.d.ts +17 -15
- package/dist/core/item/item-format-version.js +1 -1
- package/dist/core/item/item-format.d.ts +54 -54
- package/dist/core/item/item-record.d.ts +1 -1
- package/dist/core/item/item-type-definition.d.ts +11 -11
- package/dist/core/item/parent-reference-policy.d.ts +6 -6
- package/dist/core/item/parse.d.ts +37 -37
- package/dist/core/item/plan-lifecycle.d.ts +4 -4
- package/dist/core/item/priority.d.ts +3 -3
- package/dist/core/item/sprint-release-format.d.ts +4 -4
- package/dist/core/item/status-filter.d.ts +5 -5
- package/dist/core/item/status.d.ts +3 -3
- package/dist/core/item/toon-decode.d.ts +10 -10
- package/dist/core/item/type-registry.d.ts +35 -35
- package/dist/core/item/type-synonyms.d.ts +2 -2
- package/dist/core/lock/lock-gc.d.ts +28 -28
- package/dist/core/lock/lock.d.ts +53 -53
- package/dist/core/output/mutation-projection.d.ts +4 -4
- package/dist/core/output/output-control.d.ts +4 -4
- package/dist/core/output/output.d.ts +30 -30
- package/dist/core/output/query-summary.d.ts +5 -5
- package/dist/core/output/tabular.d.ts +3 -3
- package/dist/core/packages/manifest.d.ts +30 -30
- package/dist/core/packages/root.d.ts +4 -4
- package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
- package/dist/core/policy/workflow-policy-store.d.ts +15 -15
- package/dist/core/policy/workflow-policy.d.ts +56 -56
- package/dist/core/profile/profile-describe.d.ts +22 -22
- package/dist/core/profile/profile-lint.d.ts +13 -13
- package/dist/core/profile/profile-plan.d.ts +45 -45
- package/dist/core/profile/profile-presets.d.ts +36 -36
- package/dist/core/reproducibility/context.d.ts +9 -9
- package/dist/core/schema/fields-file.d.ts +35 -35
- package/dist/core/schema/item-types-file.d.ts +29 -29
- package/dist/core/schema/runtime-field-filters.d.ts +3 -3
- package/dist/core/schema/runtime-field-values.d.ts +7 -7
- package/dist/core/schema/runtime-schema.d.ts +59 -59
- package/dist/core/schema/status-defs-file.d.ts +29 -29
- package/dist/core/schema/status-token.d.ts +1 -1
- package/dist/core/schema/type-inference.d.ts +10 -10
- package/dist/core/schema/type-presets.d.ts +5 -5
- package/dist/core/schema/type-workflows.d.ts +14 -14
- package/dist/core/search/background-refresh.d.ts +12 -12
- package/dist/core/search/bm25.d.ts +16 -16
- package/dist/core/search/cache.d.ts +34 -34
- package/dist/core/search/corpus.d.ts +17 -17
- package/dist/core/search/embedding-batches.d.ts +25 -25
- package/dist/core/search/eval-thresholds.d.ts +4 -4
- package/dist/core/search/eval.d.ts +40 -40
- package/dist/core/search/http-client.d.ts +24 -24
- package/dist/core/search/providers.d.ts +30 -30
- package/dist/core/search/relevance.d.ts +17 -17
- package/dist/core/search/semantic-defaults.d.ts +5 -5
- package/dist/core/search/staleness.d.ts +3 -3
- package/dist/core/search/vector-stores.d.ts +51 -51
- package/dist/core/search/vectorization-metadata.d.ts +9 -9
- package/dist/core/sentry/helpers.d.ts +28 -26
- package/dist/core/sentry/helpers.js +1 -1
- package/dist/core/sentry/instrument.d.ts +52 -50
- package/dist/core/sentry/instrument.js +1 -1
- package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
- package/dist/core/sentry/sensitive-assignments.js +2 -0
- package/dist/core/session/session-state.d.ts +37 -37
- package/dist/core/shared/agent-session-context.d.ts +14 -14
- package/dist/core/shared/author.d.ts +89 -89
- package/dist/core/shared/command-line.d.ts +3 -3
- package/dist/core/shared/command-types.d.ts +20 -20
- package/dist/core/shared/conflict-markers.d.ts +5 -5
- package/dist/core/shared/constants.d.ts +30 -30
- package/dist/core/shared/errors.d.ts +100 -100
- package/dist/core/shared/html-entity-decode.d.ts +2 -2
- package/dist/core/shared/item-metadata-contract.d.ts +2 -2
- package/dist/core/shared/lazy-module.d.ts +1 -1
- package/dist/core/shared/levenshtein.d.ts +1 -1
- package/dist/core/shared/memo.d.ts +1 -1
- package/dist/core/shared/numeric-parsers.d.ts +1 -1
- package/dist/core/shared/option-alias-visibility.d.ts +3 -3
- package/dist/core/shared/primitives.d.ts +13 -13
- package/dist/core/shared/secret-rules.d.ts +92 -92
- package/dist/core/shared/serial-queue.d.ts +6 -6
- package/dist/core/shared/serialization.d.ts +4 -4
- package/dist/core/shared/split-comma-list.d.ts +4 -4
- package/dist/core/shared/text-normalization.d.ts +3 -3
- package/dist/core/shared/time.d.ts +27 -27
- package/dist/core/store/item-format-migration.d.ts +7 -7
- package/dist/core/store/item-metadata-cache.d.ts +30 -30
- package/dist/core/store/item-metadata-query-index.d.ts +66 -66
- package/dist/core/store/item-metadata-read-work.d.ts +6 -6
- package/dist/core/store/item-store.d.ts +123 -123
- package/dist/core/store/item-store.js +1 -1
- package/dist/core/store/paths.d.ts +27 -27
- package/dist/core/store/settings-concurrency.d.ts +1 -1
- package/dist/core/store/settings-read-cache.d.ts +11 -11
- package/dist/core/store/settings-validator.d.ts +117 -117
- package/dist/core/store/settings.d.ts +84 -84
- package/dist/core/store/sqlite-runtime.d.ts +2 -2
- package/dist/core/store/tracker-preflight.d.ts +3 -3
- package/dist/core/telemetry/consent.d.ts +1 -1
- package/dist/core/telemetry/observability.d.ts +16 -16
- package/dist/core/telemetry/policy.d.ts +7 -7
- package/dist/core/telemetry/read-sampling.d.ts +1 -1
- package/dist/core/telemetry/runtime.d.ts +275 -275
- package/dist/core/telemetry/runtime.js +2 -2
- package/dist/core/test/background-runs.d.ts +123 -123
- package/dist/core/test/item-test-run-tracking.d.ts +10 -10
- package/dist/core/test/run-selectors.d.ts +12 -12
- package/dist/core/validate/estimate-defaults.d.ts +3 -3
- package/dist/core/validate/fix-planning.d.ts +36 -36
- package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
- package/dist/core/validate/missing-by-type.d.ts +3 -3
- package/dist/core/validate/missing-link-owners.d.ts +17 -17
- package/dist/core/validate/stale-file-classification.d.ts +6 -6
- package/dist/mcp/http-server.d.ts +26 -26
- package/dist/mcp/legacy-adapter.d.ts +18 -18
- package/dist/mcp/runtime-capabilities.d.ts +18 -18
- package/dist/mcp/server.d.ts +73 -73
- package/dist/mcp/tool-definitions.d.ts +27 -27
- package/dist/sdk/actionability.d.ts +1 -1
- package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
- package/dist/sdk/agent/command-recovery.d.ts +5 -5
- package/dist/sdk/agent/command-suggestions.d.ts +4 -4
- package/dist/sdk/agent/create-option-policy.d.ts +2 -2
- package/dist/sdk/agent/identity-config.d.ts +18 -18
- package/dist/sdk/agent/item-addressing.d.ts +6 -6
- package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
- package/dist/sdk/agent/refusal-closure.d.ts +22 -22
- package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
- package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
- package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
- package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
- package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
- package/dist/sdk/agent-capability-contracts.d.ts +41 -41
- package/dist/sdk/agent-session-context.d.ts +1 -1
- package/dist/sdk/annotations.d.ts +74 -74
- package/dist/sdk/author-attribution.d.ts +47 -47
- package/dist/sdk/authoring.d.ts +9 -9
- package/dist/sdk/cli-bootstrap.d.ts +65 -65
- package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
- package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
- package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
- package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
- package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
- package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
- package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
- package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
- package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
- package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
- package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
- package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
- package/dist/sdk/cli-contracts/registration-helpers.d.ts +56 -56
- package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
- package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
- package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
- package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
- package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
- package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
- package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
- package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
- package/dist/sdk/cli-contracts.d.ts +15 -15
- package/dist/sdk/cli-program.d.ts +1 -1
- package/dist/sdk/cli-program.js +1 -1
- package/dist/sdk/command-line.d.ts +3 -3
- package/dist/sdk/comments.d.ts +24 -24
- package/dist/sdk/compile-cache.d.ts +4 -4
- package/dist/sdk/completion/bash.d.ts +1 -1
- package/dist/sdk/completion/fish.d.ts +1 -1
- package/dist/sdk/completion/shared.d.ts +74 -74
- package/dist/sdk/completion/zsh.d.ts +1 -1
- package/dist/sdk/completion.d.ts +3 -3
- package/dist/sdk/compose.d.ts +94 -94
- package/dist/sdk/config.d.ts +105 -105
- package/dist/sdk/context/recency.d.ts +1 -1
- package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
- package/dist/sdk/context/usage-egress.d.ts +1 -1
- package/dist/sdk/context/usage-ledger.d.ts +18 -18
- package/dist/sdk/context-intent-contracts.d.ts +37 -37
- package/dist/sdk/context-intent-runtime.d.ts +10 -10
- package/dist/sdk/context-packing.d.ts +44 -44
- package/dist/sdk/context-relevance.d.ts +110 -110
- package/dist/sdk/context-signal-store.d.ts +52 -52
- package/dist/sdk/context-usage.d.ts +78 -78
- package/dist/sdk/contracts.d.ts +2 -1
- package/dist/sdk/contracts.js +1 -1
- package/dist/sdk/core-governance.d.ts +5 -5
- package/dist/sdk/core.d.ts +8 -8
- package/dist/sdk/corpus-shape.d.ts +60 -60
- package/dist/sdk/define.d.ts +36 -36
- package/dist/sdk/dependencies.d.ts +70 -70
- package/dist/sdk/dependency-flag-validation.d.ts +17 -17
- package/dist/sdk/dependency-provenance.d.ts +22 -22
- package/dist/sdk/docs.d.ts +17 -17
- package/dist/sdk/duplicates.d.ts +14 -14
- package/dist/sdk/environment/agent-environment.d.ts +118 -118
- package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
- package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
- package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
- package/dist/sdk/environment/source-context.d.ts +4 -4
- package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
- package/dist/sdk/error-code-catalog.d.ts +33 -33
- package/dist/sdk/error-runtime.d.ts +5 -5
- package/dist/sdk/errors.d.ts +17 -17
- package/dist/sdk/eval.d.ts +27 -27
- package/dist/sdk/extension/author-manifest.d.ts +9 -9
- package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
- package/dist/sdk/extension/concurrency.d.ts +1 -1
- package/dist/sdk/extension/copy-scope.d.ts +1 -1
- package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
- package/dist/sdk/extension/describe.d.ts +21 -21
- package/dist/sdk/extension/doctor.d.ts +46 -46
- package/dist/sdk/extension/install-plan.d.ts +32 -32
- package/dist/sdk/extension/install-receipts.d.ts +4 -4
- package/dist/sdk/extension/install-runtime.d.ts +12 -12
- package/dist/sdk/extension/install-snapshot.d.ts +10 -10
- package/dist/sdk/extension/install-sources.d.ts +106 -106
- package/dist/sdk/extension/managed-state.d.ts +42 -42
- package/dist/sdk/extension/managed-update-status.d.ts +1 -1
- package/dist/sdk/extension/migrations.d.ts +48 -48
- package/dist/sdk/extension/output-ownership.d.ts +19 -19
- package/dist/sdk/extension/runtime-summary.d.ts +7 -7
- package/dist/sdk/extension/scaffold.d.ts +15 -15
- package/dist/sdk/extension/shared.d.ts +16 -16
- package/dist/sdk/extension/source-resolution.d.ts +16 -16
- package/dist/sdk/extension/static-inventory.d.ts +23 -23
- package/dist/sdk/extension/update-check.d.ts +9 -9
- package/dist/sdk/extension-command-context.d.ts +1 -1
- package/dist/sdk/extension-contracts.d.ts +10 -10
- package/dist/sdk/extension.d.ts +221 -221
- package/dist/sdk/files.d.ts +101 -101
- package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
- package/dist/sdk/flag-invocation-contracts.js +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
- package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
- package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
- package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
- package/dist/sdk/governance/assurance-action.d.ts +46 -46
- package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
- package/dist/sdk/governance/assurance-presets.d.ts +25 -25
- package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
- package/dist/sdk/governance/assurance.d.ts +204 -204
- package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
- package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
- package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
- package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
- package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
- package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
- package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
- package/dist/sdk/governance/defect-recurrence.js +2 -1
- package/dist/sdk/governance/extension-host-version.d.ts +9 -9
- package/dist/sdk/governance/gc.d.ts +26 -26
- package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
- package/dist/sdk/governance/health.d.ts +172 -172
- package/dist/sdk/governance/health.js +1 -1
- package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
- package/dist/sdk/governance/linked-file-report.d.ts +15 -15
- package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
- package/dist/sdk/governance/provenance-health.d.ts +35 -35
- package/dist/sdk/governance/reindex.d.ts +102 -102
- package/dist/sdk/governance/reliability.d.ts +29 -29
- package/dist/sdk/governance/stale-work.d.ts +13 -13
- package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
- package/dist/sdk/governance/storage-integrity.d.ts +28 -28
- package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
- package/dist/sdk/governance/upgrade.d.ts +77 -77
- package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
- package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
- package/dist/sdk/governance/validate-normalization.d.ts +4 -4
- package/dist/sdk/governance/validate.d.ts +176 -176
- package/dist/sdk/governance/validate.js +1 -1
- package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
- package/dist/sdk/governance/workflow-policy.d.ts +18 -18
- package/dist/sdk/governance/workspace-position.d.ts +40 -40
- package/dist/sdk/governance.d.ts +2 -2
- package/dist/sdk/graph/adapter.d.ts +45 -45
- package/dist/sdk/graph/analytics.d.ts +36 -36
- package/dist/sdk/graph/assembly.d.ts +51 -51
- package/dist/sdk/graph/cache.d.ts +19 -19
- package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
- package/dist/sdk/graph/centrality.d.ts +20 -20
- package/dist/sdk/graph/conformance.d.ts +21 -21
- package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
- package/dist/sdk/graph/durable-cache.d.ts +22 -22
- package/dist/sdk/graph/governance-contracts.d.ts +1 -1
- package/dist/sdk/graph/governance.d.ts +92 -92
- package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
- package/dist/sdk/graph/index.d.ts +15 -15
- package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
- package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
- package/dist/sdk/graph/query-contracts.d.ts +6 -6
- package/dist/sdk/graph/remediation.d.ts +15 -15
- package/dist/sdk/graph/run.d.ts +203 -203
- package/dist/sdk/graph/scheduling.d.ts +21 -21
- package/dist/sdk/graph/traversal.d.ts +18 -18
- package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
- package/dist/sdk/guide-topics.d.ts +19 -19
- package/dist/sdk/guide.d.ts +43 -43
- package/dist/sdk/history/attestation-command.d.ts +8 -8
- package/dist/sdk/history/attestation-contract.d.ts +43 -43
- package/dist/sdk/history/attestation-scan.d.ts +4 -4
- package/dist/sdk/history/attestation.d.ts +4 -4
- package/dist/sdk/history/maintenance.d.ts +25 -25
- package/dist/sdk/history/salvage.d.ts +19 -19
- package/dist/sdk/history/subject.d.ts +8 -8
- package/dist/sdk/history-analytics.d.ts +64 -64
- package/dist/sdk/history-compact.d.ts +67 -67
- package/dist/sdk/history-mcp.d.ts +7 -7
- package/dist/sdk/history-provenance.d.ts +40 -40
- package/dist/sdk/history-read.d.ts +24 -24
- package/dist/sdk/history-redact.d.ts +68 -68
- package/dist/sdk/history-repair.d.ts +92 -92
- package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
- package/dist/sdk/improvement-ledger.d.ts +62 -62
- package/dist/sdk/index.d.ts +69 -69
- package/dist/sdk/init-agent-guidance.d.ts +68 -68
- package/dist/sdk/init.d.ts +117 -117
- package/dist/sdk/invocation-author.d.ts +1 -1
- package/dist/sdk/item-children.d.ts +15 -15
- package/dist/sdk/item-metadata-index.d.ts +2 -2
- package/dist/sdk/item-schedule.d.ts +9 -9
- package/dist/sdk/item-transaction.d.ts +73 -73
- package/dist/sdk/learnings.d.ts +23 -23
- package/dist/sdk/lifecycle/append.d.ts +8 -8
- package/dist/sdk/lifecycle/claim.d.ts +38 -38
- package/dist/sdk/lifecycle/close-many.d.ts +71 -71
- package/dist/sdk/lifecycle/close.d.ts +18 -18
- package/dist/sdk/lifecycle/copy.d.ts +10 -10
- package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
- package/dist/sdk/lifecycle/create.d.ts +88 -88
- package/dist/sdk/lifecycle/delete.d.ts +15 -15
- package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
- package/dist/sdk/lifecycle/focus.d.ts +6 -6
- package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
- package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
- package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
- package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
- package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
- package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
- package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
- package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
- package/dist/sdk/lifecycle/plan.d.ts +127 -127
- package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
- package/dist/sdk/lifecycle/reopen.d.ts +15 -15
- package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
- package/dist/sdk/lifecycle/restore.d.ts +34 -34
- package/dist/sdk/lifecycle/restore.js +1 -1
- package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
- package/dist/sdk/lifecycle/task-composition.d.ts +7 -7
- package/dist/sdk/lifecycle/update-many.d.ts +61 -61
- package/dist/sdk/lifecycle/update.d.ts +120 -120
- package/dist/sdk/lifecycle-completion.d.ts +14 -14
- package/dist/sdk/lifecycle-policy.d.ts +31 -31
- package/dist/sdk/linked-artifacts.d.ts +58 -58
- package/dist/sdk/mcp/apps.d.ts +28 -28
- package/dist/sdk/mcp/authorization.d.ts +66 -66
- package/dist/sdk/mcp/discovery.d.ts +67 -67
- package/dist/sdk/mcp/interactions.d.ts +49 -49
- package/dist/sdk/mcp/protocol.d.ts +63 -63
- package/dist/sdk/mcp/skills.d.ts +62 -62
- package/dist/sdk/mcp/subscriptions.d.ts +26 -26
- package/dist/sdk/mcp/tasks.d.ts +51 -51
- package/dist/sdk/mcp/transport.d.ts +17 -17
- package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
- package/dist/sdk/merge/driver.d.ts +38 -38
- package/dist/sdk/merge/index.d.ts +5 -5
- package/dist/sdk/merge/install.d.ts +48 -48
- package/dist/sdk/merge/install.js +1 -1
- package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
- package/dist/sdk/merge/receipt-operation.d.ts +6 -6
- package/dist/sdk/merge/receipt-schema.d.ts +11 -11
- package/dist/sdk/merge/receipts.d.ts +111 -111
- package/dist/sdk/merge/reconcile.d.ts +20 -20
- package/dist/sdk/merge/three-way.d.ts +50 -50
- package/dist/sdk/merge/three-way.js +2 -2
- package/dist/sdk/merge/worktree-config.d.ts +3 -3
- package/dist/sdk/mutation-events.d.ts +62 -62
- package/dist/sdk/mutation-guard.d.ts +134 -134
- package/dist/sdk/notes.d.ts +28 -28
- package/dist/sdk/output/table-rows.d.ts +6 -6
- package/dist/sdk/output-contracts.d.ts +26 -26
- package/dist/sdk/output-projection.d.ts +108 -108
- package/dist/sdk/output-token-accounting.d.ts +18 -18
- package/dist/sdk/output.d.ts +18 -18
- package/dist/sdk/ownership-source.d.ts +1 -1
- package/dist/sdk/package-import-adapters.d.ts +51 -51
- package/dist/sdk/package-migrations.d.ts +3 -3
- package/dist/sdk/package-runtime-options.d.ts +3 -3
- package/dist/sdk/pagination.d.ts +28 -28
- package/dist/sdk/pagination.js +1 -1
- package/dist/sdk/profile.d.ts +72 -72
- package/dist/sdk/provenance.d.ts +37 -37
- package/dist/sdk/public-surface.json +1 -1
- package/dist/sdk/query/activity.d.ts +84 -84
- package/dist/sdk/query/aggregate.d.ts +109 -109
- package/dist/sdk/query/calendar.d.ts +95 -95
- package/dist/sdk/query/complete-list.d.ts +35 -35
- package/dist/sdk/query/context.d.ts +300 -300
- package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
- package/dist/sdk/query/get.d.ts +54 -54
- package/dist/sdk/query/history.d.ts +38 -38
- package/dist/sdk/query/item-filter-options.d.ts +41 -41
- package/dist/sdk/query/light-metadata.d.ts +1 -1
- package/dist/sdk/query/list-filter-shared.d.ts +4 -4
- package/dist/sdk/query/list.d.ts +167 -167
- package/dist/sdk/query/list.js +1 -1
- package/dist/sdk/query/multi-value-filters.d.ts +6 -6
- package/dist/sdk/query/next-ready-budget.d.ts +8 -8
- package/dist/sdk/query/next.d.ts +94 -94
- package/dist/sdk/query/parsers.d.ts +3 -3
- package/dist/sdk/query/projection-contracts.d.ts +18 -18
- package/dist/sdk/query/search/corpus.d.ts +15 -15
- package/dist/sdk/query/search/filters.d.ts +15 -15
- package/dist/sdk/query/search/input.d.ts +8 -8
- package/dist/sdk/query/search/lexical.d.ts +10 -10
- package/dist/sdk/query/search/response.d.ts +22 -22
- package/dist/sdk/query/search/semantic.d.ts +133 -133
- package/dist/sdk/query/search/types.d.ts +65 -65
- package/dist/sdk/query/search-contracts.d.ts +53 -53
- package/dist/sdk/query/search-pagination.d.ts +21 -21
- package/dist/sdk/query/search-rendering.d.ts +30 -30
- package/dist/sdk/query/search.d.ts +60 -60
- package/dist/sdk/query/workspace-contracts.d.ts +2 -2
- package/dist/sdk/query.d.ts +6 -6
- package/dist/sdk/read-output/continuation.d.ts +11 -11
- package/dist/sdk/read-output/extension.d.ts +3 -3
- package/dist/sdk/read-output/options.d.ts +7 -7
- package/dist/sdk/read-output/provenance.d.ts +6 -6
- package/dist/sdk/read-output-budget.d.ts +11 -11
- package/dist/sdk/read-output-contracts.d.ts +112 -112
- package/dist/sdk/read-output-contracts.js +1 -1
- package/dist/sdk/read-output-rows.d.ts +15 -15
- package/dist/sdk/read-output-session.d.ts +29 -29
- package/dist/sdk/relationship-analytics.d.ts +46 -46
- package/dist/sdk/relationship-context.d.ts +48 -48
- package/dist/sdk/relationship-history.d.ts +59 -59
- package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
- package/dist/sdk/relationship-migration.d.ts +14 -14
- package/dist/sdk/relationships.d.ts +46 -46
- package/dist/sdk/reproducibility/process.d.ts +9 -9
- package/dist/sdk/runtime/actions.d.ts +1 -1
- package/dist/sdk/runtime/context.d.ts +15 -15
- package/dist/sdk/runtime/schema-preview.d.ts +1 -1
- package/dist/sdk/runtime/schema.d.ts +1 -1
- package/dist/sdk/runtime-action-aliases.d.ts +3 -3
- package/dist/sdk/runtime-extended-actions.d.ts +9 -9
- package/dist/sdk/runtime-input.d.ts +29 -29
- package/dist/sdk/runtime-primitives.d.ts +54 -52
- package/dist/sdk/runtime-primitives.js +1 -1
- package/dist/sdk/runtime-public-contracts.d.ts +46 -46
- package/dist/sdk/runtime-stats-options.d.ts +1 -1
- package/dist/sdk/runtime.d.ts +374 -374
- package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
- package/dist/sdk/schema-migration.d.ts +79 -79
- package/dist/sdk/schema.d.ts +224 -224
- package/dist/sdk/search-refresh-worker.d.ts +1 -1
- package/dist/sdk/similarity-scoring.d.ts +10 -10
- package/dist/sdk/similarity.d.ts +73 -73
- package/dist/sdk/start-task-status.d.ts +1 -1
- package/dist/sdk/stats.d.ts +72 -72
- package/dist/sdk/structured-mutations.d.ts +13 -13
- package/dist/sdk/telemetry-flush.d.ts +1 -1
- package/dist/sdk/telemetry.d.ts +32 -32
- package/dist/sdk/templates.d.ts +35 -35
- package/dist/sdk/test/batch.d.ts +50 -50
- package/dist/sdk/test/command-args.d.ts +2 -2
- package/dist/sdk/test/entry.d.ts +4 -4
- package/dist/sdk/test/execution-receipts.d.ts +5 -5
- package/dist/sdk/test/execution.d.ts +247 -247
- package/dist/sdk/test/json-path.d.ts +4 -4
- package/dist/sdk/test/linked-command-detection.d.ts +36 -36
- package/dist/sdk/test/measurements.d.ts +10 -10
- package/dist/sdk/test/parsers.d.ts +18 -18
- package/dist/sdk/test/prerequisites.d.ts +3 -3
- package/dist/sdk/test/runs.d.ts +43 -43
- package/dist/sdk/test/trust.d.ts +15 -15
- package/dist/sdk/test/update.d.ts +23 -23
- package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
- package/dist/sdk/testing.d.ts +250 -246
- package/dist/sdk/testing.js +2 -2
- package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
- package/dist/sdk/traceability/source-traceability.d.ts +50 -50
- package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
- package/dist/sdk/workspace-contracts.d.ts +20 -20
- package/dist/sdk/workspace-memory.d.ts +42 -42
- package/dist/sdk/workspace-recipe.d.ts +9 -9
- package/dist/sdk/workspace-snapshot.d.ts +60 -60
- package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
- package/dist/sdk/workspace-transaction.d.ts +26 -26
- package/dist/sdk/workspace.d.ts +9 -9
- package/dist/types.d.ts +540 -540
- package/docs/COMMANDS.md +11 -2
- package/docs/CONFIGURATION.md +43 -0
- package/docs/DEFECT_RECURRENCE.md +8 -0
- package/docs/EXTENSIONS.md +1 -1
- package/docs/EXTENSION_AUTHOR_CONTRACTS.md +33 -0
- package/docs/LINKED_TEST_EDITS.md +15 -0
- package/docs/MERGE_SAFETY.md +8 -0
- package/docs/RELEASING.md +2 -0
- package/docs/SDK.md +19 -0
- package/docs/TESTING.md +21 -1
- package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +4 -3
- package/marketplace.json +1 -1
- package/package.json +3 -1
- package/packages/pm-beads/package.json +1 -1
- package/packages/pm-calendar/package.json +1 -1
- package/packages/pm-command-kit/package.json +1 -1
- package/packages/pm-digital-twin/package.json +1 -1
- package/packages/pm-governance-audit/package.json +1 -1
- package/packages/pm-guide-shell/package.json +1 -1
- package/packages/pm-kanban/package.json +1 -1
- package/packages/pm-lifecycle-hooks/package.json +1 -1
- package/packages/pm-linked-test-adapters/package.json +1 -1
- package/packages/pm-search-advanced/package.json +1 -1
- package/packages/pm-templates/package.json +1 -1
- package/packages/pm-todos/package.json +1 -1
- package/packages/pm-vcs/package.json +1 -1
- package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
- package/plugins/pm-claude/package.json +1 -1
- package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
- package/plugins/pm-codex/package.json +1 -1
- package/plugins/pm-codex/plugin.json +1 -1
- package/runtime-dependencies.json +1 -1
- package/scripts/finalize-build.mjs +9 -3
- package/dist/cli-bundle/chunks/chunk-DJDRHJBP.js +0 -234
- package/dist/cli-bundle/chunks/chunk-DUK5DHI6.js +0 -8
- package/dist/cli-bundle/chunks/chunk-IFPJDJUM.js +0 -20
- package/dist/cli-bundle/chunks/chunk-RL45OYTL.js +0 -6
- package/dist/cli-bundle/chunks/chunk-WYZGZV2M.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-F5J3ATMV.js +0 -165
- package/dist/cli-bundle/focused-chunks/chunk-IOTNG6CN.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-S6ITXQ5T.js +0 -20
- package/dist/cli-bundle/focused-chunks/chunk-UPJA45K7.js +0 -26
|
@@ -11,30 +11,30 @@ export type LinkedTestSelectorKind = "match" | "only-index" | "only-last";
|
|
|
11
11
|
/** Documents the linked test run selector payload exchanged by command, SDK, and package integrations. */
|
|
12
12
|
export interface LinkedTestRunSelector {
|
|
13
13
|
/** Value that configures or reports match for this contract. */
|
|
14
|
-
match?:
|
|
14
|
+
match?:string;
|
|
15
15
|
/** Value that configures or reports only index for this contract. */
|
|
16
|
-
onlyIndex?:
|
|
16
|
+
onlyIndex?:number;
|
|
17
17
|
/** Value that configures or reports only last for this contract. */
|
|
18
|
-
onlyLast?:
|
|
18
|
+
onlyLast?:boolean;
|
|
19
19
|
}
|
|
20
20
|
/** Documents the linked test run selection payload exchanged by command, SDK, and package integrations. */
|
|
21
21
|
export interface LinkedTestRunSelection {
|
|
22
22
|
/** Value that configures or reports selector for this contract. */
|
|
23
|
-
selector:
|
|
23
|
+
selector:LinkedTestSelectorKind | null;
|
|
24
24
|
/** Value that configures or reports requested for this contract. */
|
|
25
|
-
requested:
|
|
25
|
+
requested:string | null;
|
|
26
26
|
/** Value that configures or reports selected for this contract. */
|
|
27
|
-
selected:
|
|
27
|
+
selected:LinkedTest[];
|
|
28
28
|
/** 1-based positions of selected entries in the original `--list` order. */
|
|
29
|
-
selected_indexes:
|
|
29
|
+
selected_indexes:number[];
|
|
30
30
|
/** Number of selected entries represented by this result. */
|
|
31
|
-
selected_count:
|
|
31
|
+
selected_count:number;
|
|
32
32
|
/** Number of skipped entries represented by this result. */
|
|
33
|
-
skipped_count:
|
|
33
|
+
skipped_count:number;
|
|
34
34
|
}
|
|
35
35
|
/** Implements parse only index value for the public runtime surface of this module. */
|
|
36
|
-
export declare function parseOnlyIndexValue(raw:
|
|
36
|
+
export declare function parseOnlyIndexValue(raw:string | number,optionName?:string):number;
|
|
37
37
|
/** Implements describe linked test entries for the public runtime surface of this module. */
|
|
38
|
-
export declare function describeLinkedTestEntries(tests:
|
|
38
|
+
export declare function describeLinkedTestEntries(tests:LinkedTest[]):string;
|
|
39
39
|
/** Implements resolve linked test run selection for the public runtime surface of this module. */
|
|
40
|
-
export declare function resolveLinkedTestRunSelection(tests:
|
|
40
|
+
export declare function resolveLinkedTestRunSelection(tests:LinkedTest[],selector:LinkedTestRunSelector):LinkedTestRunSelection;
|
|
@@ -12,10 +12,10 @@
|
|
|
12
12
|
* deterministic, non-throwing style of stale-file-classification.ts).
|
|
13
13
|
*/
|
|
14
14
|
/** Built-in per-type default estimates in MINUTES used by `pm validate --auto-fix` (GH-212) to backfill missing `estimated_minutes`. Keys are canonical built-in type names. Lookups are case-insensitive (see resolveEstimateDefaultMinutes). */
|
|
15
|
-
export declare const DEFAULT_ESTIMATE_MINUTES_BY_TYPE:
|
|
15
|
+
export declare const DEFAULT_ESTIMATE_MINUTES_BY_TYPE:Readonly<Record<string,number>>;
|
|
16
16
|
/** Fallback when neither overrides nor the built-in map have the type. */
|
|
17
17
|
export declare const FALLBACK_ESTIMATE_MINUTES = 120;
|
|
18
18
|
/** Resolve the default estimated-minutes for an item type. Precedence: overrides (case-insensitive key match) > DEFAULT_ESTIMATE_MINUTES_BY_TYPE (case-insensitive) > FALLBACK_ESTIMATE_MINUTES. - `type` undefined/empty -> FALLBACK. - Only finite values > 0 are honored from overrides/defaults; a non-positive or non-finite override value is ignored and resolution continues to the next tier. - Returned value is a positive integer (floor of the resolved value). */
|
|
19
|
-
export declare function resolveEstimateDefaultMinutes(type:
|
|
19
|
+
export declare function resolveEstimateDefaultMinutes(type:string | undefined,overrides?:Readonly<Record<string,number>>):number;
|
|
20
20
|
/** Validate + normalize a raw `validation.estimate_defaults_by_type` settings object into a clean Record<string, number> of positive integers, dropping invalid entries. Used so the pure resolver always receives a sane override map. Returns {} for undefined/null/non-object input. Trims keys; ignores empty keys and non-positive / non-finite / non-number values. Floors values to integers. */
|
|
21
|
-
export declare function normalizeEstimateDefaultOverrides(raw:
|
|
21
|
+
export declare function normalizeEstimateDefaultOverrides(raw:unknown):Record<string,number>;
|
|
@@ -22,91 +22,91 @@ export type ValidateFixKind = "set_resolution" | "set_close_reason" | "set_estim
|
|
|
22
22
|
/** Restricts validate fix scope values accepted by command, SDK, and storage contracts. */
|
|
23
23
|
export type ValidateFixScope = "metadata" | "resolution" | "estimates" | "timestamps" | "lifecycle";
|
|
24
24
|
/** Scopes auto-applied without an explicit `--fix-scope` (safe field backfills). */
|
|
25
|
-
export declare const DEFAULT_GRANTED_FIX_SCOPES:
|
|
25
|
+
export declare const DEFAULT_GRANTED_FIX_SCOPES:readonly ValidateFixScope[];
|
|
26
26
|
/** Scopes accepted by `--fix-scope`. Estimates are heuristic, timestamps require verified historical replay, and lifecycle changes are structural; all three require explicit opt-in. */
|
|
27
|
-
export declare const SUPPORTED_FIX_SCOPES:
|
|
27
|
+
export declare const SUPPORTED_FIX_SCOPES:readonly ValidateFixScope[];
|
|
28
28
|
/** Documents the validate fix record payload exchanged by command, SDK, and package integrations. */
|
|
29
29
|
export interface ValidateFixRecord {
|
|
30
30
|
/** Item the fix targets. */
|
|
31
|
-
item_id:
|
|
31
|
+
item_id:string;
|
|
32
32
|
/** Validate check the finding came from. */
|
|
33
|
-
check:
|
|
33
|
+
check:ValidateFixCheck;
|
|
34
34
|
/** Item-metadata field (or link list) the fix changes. */
|
|
35
|
-
field:
|
|
35
|
+
field:string;
|
|
36
36
|
/** Declarative fix kind the applier dispatches on. */
|
|
37
|
-
kind:
|
|
37
|
+
kind:ValidateFixKind;
|
|
38
38
|
/** Equivalent standalone `pm` command for the fix. */
|
|
39
|
-
command:
|
|
39
|
+
command:string;
|
|
40
40
|
/** New value for set-field fixes. */
|
|
41
|
-
value?:
|
|
41
|
+
value?:string;
|
|
42
42
|
/** Stale link path for prune fixes. */
|
|
43
|
-
path?:
|
|
43
|
+
path?:string;
|
|
44
44
|
/** Target parent id for reparent fixes. */
|
|
45
|
-
parent_id?:
|
|
45
|
+
parent_id?:string;
|
|
46
46
|
/** Fix scope the `--fix-scope` allowlist must grant for the fix to be applied. Every `--auto-fix` record carries one (the granted default is metadata+resolution; lifecycle must be named explicitly). Absent only on `--prune-missing` records, which are governed by their own flag. */
|
|
47
|
-
gate?:
|
|
47
|
+
gate?:ValidateFixScope;
|
|
48
48
|
}
|
|
49
49
|
/** Documents the resolution backfill row payload exchanged by command, SDK, and package integrations. */
|
|
50
50
|
export interface ResolutionBackfillRow {
|
|
51
51
|
/** Stable identifier used to reference this record across commands and storage. */
|
|
52
|
-
id:
|
|
52
|
+
id:string;
|
|
53
53
|
/** Resolution-check missing field keys for this closed item. */
|
|
54
|
-
missing_fields:
|
|
54
|
+
missing_fields:readonly string[];
|
|
55
55
|
/** The item's close_reason, when present (preferred derivation source). */
|
|
56
|
-
close_reason?:
|
|
56
|
+
close_reason?:string;
|
|
57
57
|
}
|
|
58
58
|
/** Plan resolution backfills for closed items flagged by the resolution check. Only the `resolution` field is mechanical enough to auto-fix: it derives from the item's own `close_reason` when present and falls back to the `"completed"` default. `expected_result` / `actual_result` stay hint-only — no deterministic source text exists for them. */
|
|
59
|
-
export declare function planResolutionBackfillFixes(rows:
|
|
59
|
+
export declare function planResolutionBackfillFixes(rows:readonly ResolutionBackfillRow[]):ValidateFixRecord[];
|
|
60
60
|
/** Documents the close reason backfill row payload exchanged by command, SDK, and package integrations. */
|
|
61
61
|
export interface CloseReasonBackfillRow {
|
|
62
62
|
/** Stable identifier used to reference this record across commands and storage. */
|
|
63
|
-
id:
|
|
63
|
+
id:string;
|
|
64
64
|
/** The item's resolution, when present (the only derivation source). */
|
|
65
|
-
resolution?:
|
|
65
|
+
resolution?:string;
|
|
66
66
|
}
|
|
67
67
|
/** Plan close_reason backfills for closed items flagged by the metadata check. Only derivable when the item already carries a resolution; items missing both stay hint-only (any synthesized reason would be fabricated, not derived). */
|
|
68
|
-
export declare function planCloseReasonBackfillFixes(rows:
|
|
68
|
+
export declare function planCloseReasonBackfillFixes(rows:readonly CloseReasonBackfillRow[]):ValidateFixRecord[];
|
|
69
69
|
/** Documents the estimate backfill row payload exchanged by command, SDK, and package integrations. */
|
|
70
70
|
export interface EstimateBackfillRow {
|
|
71
71
|
/** Stable identifier used to reference this record across commands and storage. */
|
|
72
|
-
id:
|
|
72
|
+
id:string;
|
|
73
73
|
/** Item type, used to resolve the per-type default estimate. */
|
|
74
|
-
type?:
|
|
74
|
+
type?:string;
|
|
75
75
|
}
|
|
76
76
|
/** Plan estimate backfills for items flagged by the metadata check as missing `estimated_minutes` (GH-212). The value is a config-driven per-type default (overrides > built-in map > fallback), never a derived fact — so these fixes carry `gate: "estimates"`, an opt-in scope that is NOT granted by default. `overrides` is the already-normalized `validation.estimate_defaults_by_type` map; pass `undefined`/`{}` to use the built-in defaults. */
|
|
77
|
-
export declare function planEstimateBackfillFixes(rows:
|
|
77
|
+
export declare function planEstimateBackfillFixes(rows:readonly EstimateBackfillRow[],overrides?:Readonly<Record<string,number>>):ValidateFixRecord[];
|
|
78
78
|
/** Documents the terminal parent fix row payload exchanged by command, SDK, and package integrations. */
|
|
79
79
|
export interface TerminalParentFixRow {
|
|
80
80
|
/** Stable identifier used to reference this record across commands and storage. */
|
|
81
|
-
id:
|
|
81
|
+
id:string;
|
|
82
82
|
/** Value that configures or reports parent id for this contract. */
|
|
83
|
-
parent_id:
|
|
83
|
+
parent_id:string;
|
|
84
84
|
/** The terminal parent's own parent, when one exists. */
|
|
85
|
-
grandparent_id?:
|
|
85
|
+
grandparent_id?:string;
|
|
86
86
|
/** True when the grandparent exists and is NOT terminal (safe reparent target). */
|
|
87
|
-
grandparent_active?:
|
|
87
|
+
grandparent_active?:boolean;
|
|
88
88
|
}
|
|
89
89
|
/** Plan lifecycle fixes for active items whose parent is terminal (pm-8jss / GH-168). When the terminal parent has an active grandparent, the child is reparented one level up (it stays inside the same hierarchy); otherwise the parent link is cleared so the item surfaces as unparented active work. Either way the item itself is never closed or mutated beyond `parent` — and every fix carries `gate: "lifecycle"` so it is only applied under an explicit `--fix-scope lifecycle`. */
|
|
90
|
-
export declare function planTerminalParentFixes(rows:
|
|
90
|
+
export declare function planTerminalParentFixes(rows:readonly TerminalParentFixRow[]):ValidateFixRecord[];
|
|
91
91
|
/** Documents the stale link prune row payload exchanged by command, SDK, and package integrations. */
|
|
92
92
|
export interface StaleLinkPruneRow {
|
|
93
93
|
/** Value that configures or reports item id for this contract. */
|
|
94
|
-
item_id:
|
|
94
|
+
item_id:string;
|
|
95
95
|
/** Filesystem path used for path resolution. */
|
|
96
|
-
path:
|
|
96
|
+
path:string;
|
|
97
97
|
/** Value that configures or reports link kind for this contract. */
|
|
98
|
-
link_kind:
|
|
98
|
+
link_kind:"files" | "docs";
|
|
99
99
|
/** Value that configures or reports classification for this contract. */
|
|
100
|
-
classification:
|
|
100
|
+
classification:"moved" | "deleted" | "malformed";
|
|
101
101
|
}
|
|
102
102
|
/** Plan link prunes for `--prune-missing` (pm-0v2m / GH-184). Only links whose stale path classified as `deleted` are pruned; `moved` links keep their relink candidates in the files-check details instead of being dropped, so recoverable link information is never destroyed. Link removal only — real files are never touched. */
|
|
103
|
-
export declare function planStaleLinkPruneFixes(rows:
|
|
103
|
+
export declare function planStaleLinkPruneFixes(rows:readonly StaleLinkPruneRow[]):ValidateFixRecord[];
|
|
104
104
|
/** Resolve the granted `--fix-scope` set (repeatable and/or comma-separated). With no explicit scopes the safe field-backfill scopes (metadata, resolution) are granted; lifecycle must always be named explicitly. Unknown values fail fast with the supported list. */
|
|
105
|
-
export declare function resolveGrantedFixScopes(rawScopes:
|
|
105
|
+
export declare function resolveGrantedFixScopes(rawScopes:readonly string[] | undefined):Set<ValidateFixScope>;
|
|
106
106
|
/** Split a fix plan into the records that may be applied under the granted scopes and the gated records that were withheld. `--fix-scope` is an exact allowlist: every `--auto-fix` record requires its gate scope in `granted`. Ungated records (`--prune-missing` link prunes, governed by their own flag) are always applicable. */
|
|
107
|
-
export declare function partitionFixesByGrant(fixes:
|
|
108
|
-
applicable:
|
|
109
|
-
gated:
|
|
107
|
+
export declare function partitionFixesByGrant(fixes:readonly ValidateFixRecord[],granted:ReadonlySet<ValidateFixScope>):{
|
|
108
|
+
applicable:ValidateFixRecord[];
|
|
109
|
+
gated:ValidateFixRecord[];
|
|
110
110
|
};
|
|
111
111
|
/** Compact serialization of a fix for planned/applied output rows. */
|
|
112
|
-
export declare function toFixOutputRow(fix:
|
|
112
|
+
export declare function toFixOutputRow(fix:ValidateFixRecord):Record<string,unknown>;
|
|
@@ -17,4 +17,4 @@
|
|
|
17
17
|
* string and branch on the boolean result.
|
|
18
18
|
*/
|
|
19
19
|
/** Return `true` when a linked-artifact path is a remote reference (a URL with a `scheme://` authority) rather than a local filesystem path. Whitespace is trimmed before matching so a stored `" https://…"` is still recognized. */
|
|
20
|
-
export declare function isRemoteLinkedArtifactReference(path:
|
|
20
|
+
export declare function isRemoteLinkedArtifactReference(path:string):boolean;
|
|
@@ -10,9 +10,9 @@
|
|
|
10
10
|
/** One missing required metadata field observed on an item of a specific type. */
|
|
11
11
|
export interface MissingFieldOccurrence {
|
|
12
12
|
/** Item type name as stored in item metadata (e.g. "Task"). */
|
|
13
|
-
item_type:
|
|
13
|
+
item_type:string;
|
|
14
14
|
/** Required metadata field that is missing on the item. */
|
|
15
|
-
field:
|
|
15
|
+
field:string;
|
|
16
16
|
}
|
|
17
17
|
/** Aggregate missing-field occurrences into `{ type: { field: count } }` with both levels sorted lexicographically for stable, diff-friendly output. Zero counts never appear (only observed occurrences are aggregated). */
|
|
18
|
-
export declare function buildMissingByTypeCounts(occurrences:
|
|
18
|
+
export declare function buildMissingByTypeCounts(occurrences:Iterable<MissingFieldOccurrence>):Record<string,Record<string,number>>;
|
|
@@ -17,44 +17,44 @@ export type StaleLinkClassification = "moved" | "deleted" | "malformed";
|
|
|
17
17
|
/** Documents the stale link owner input payload exchanged by command, SDK, and package integrations. */
|
|
18
18
|
export interface StaleLinkOwnerInput {
|
|
19
19
|
/** Value that configures or reports item id for this contract. */
|
|
20
|
-
item_id:
|
|
20
|
+
item_id:string;
|
|
21
21
|
/** Normalized workspace-relative path that no longer resolves. */
|
|
22
|
-
path:
|
|
22
|
+
path:string;
|
|
23
23
|
/** Which link list of the owning item the path lives in. */
|
|
24
|
-
link_kind:
|
|
24
|
+
link_kind:"files" | "docs";
|
|
25
25
|
/** Value that configures or reports classification for this contract. */
|
|
26
|
-
classification:
|
|
26
|
+
classification:StaleLinkClassification;
|
|
27
27
|
}
|
|
28
28
|
/** Documents the missing linked path owner payload exchanged by command, SDK, and package integrations. */
|
|
29
29
|
export interface MissingLinkedPathOwner {
|
|
30
30
|
/** Stable identifier used to reference this record across commands and storage. */
|
|
31
|
-
id:
|
|
31
|
+
id:string;
|
|
32
32
|
/** Owning item type, `"Unknown"` if metadata is absent. */
|
|
33
|
-
type:
|
|
33
|
+
type:string;
|
|
34
34
|
/** Owning item title, `""` if absent. */
|
|
35
|
-
title:
|
|
35
|
+
title:string;
|
|
36
36
|
/** Owning item status, `""` if absent. */
|
|
37
|
-
status:
|
|
37
|
+
status:string;
|
|
38
38
|
/** The link list the path lives in (= the input `link_kind`). */
|
|
39
|
-
field:
|
|
39
|
+
field:"files" | "docs";
|
|
40
40
|
}
|
|
41
41
|
/** Documents the missing linked path row payload exchanged by command, SDK, and package integrations. */
|
|
42
42
|
export interface MissingLinkedPathRow {
|
|
43
43
|
/** Filesystem path used for path resolution. */
|
|
44
|
-
path:
|
|
44
|
+
path:string;
|
|
45
45
|
/** Value that configures or reports classification for this contract. */
|
|
46
|
-
classification:
|
|
46
|
+
classification:StaleLinkClassification;
|
|
47
47
|
/** Value that configures or reports items for this contract. */
|
|
48
|
-
items:
|
|
48
|
+
items:MissingLinkedPathOwner[];
|
|
49
49
|
}
|
|
50
50
|
/** Documents the owner item metadata payload exchanged by command, SDK, and package integrations. */
|
|
51
51
|
export interface OwnerItemMetadata {
|
|
52
52
|
/** Schema type that determines the shape and validation rules for this value. */
|
|
53
|
-
type?:
|
|
53
|
+
type?:string;
|
|
54
54
|
/** Value that configures or reports title for this contract. */
|
|
55
|
-
title?:
|
|
55
|
+
title?:string;
|
|
56
56
|
/** Lifecycle state reported for status. */
|
|
57
|
-
status?:
|
|
57
|
+
status?:string;
|
|
58
58
|
}
|
|
59
59
|
/**
|
|
60
60
|
* Group stale-link owner inputs by linked path and attach owning-item metadata.
|
|
@@ -65,7 +65,7 @@ status?: string;
|
|
|
65
65
|
* - `classification` per path follows {@link preferClassification} (moved wins).
|
|
66
66
|
* - Missing metadata falls back: type `"Unknown"`, title `""`, status `""`.
|
|
67
67
|
*/
|
|
68
|
-
export declare function buildMissingLinkedPathRows(rows:
|
|
68
|
+
export declare function buildMissingLinkedPathRows(rows:readonly StaleLinkOwnerInput[],lookup:(itemId:string) => OwnerItemMetadata | undefined):MissingLinkedPathRow[];
|
|
69
69
|
/**
|
|
70
70
|
* Token-efficient one-line-per-owner serialization for the files-check details
|
|
71
71
|
* (compact text counterpart to the full {@link MissingLinkedPathRow} objects).
|
|
@@ -75,4 +75,4 @@ export declare function buildMissingLinkedPathRows(rows: readonly StaleLinkOwner
|
|
|
75
75
|
* render (`status=` and `title=""`). Order follows
|
|
76
76
|
* {@link buildMissingLinkedPathRows} output order.
|
|
77
77
|
*/
|
|
78
|
-
export declare function summarizeMissingLinkedPathRows(rows:
|
|
78
|
+
export declare function summarizeMissingLinkedPathRows(rows:readonly MissingLinkedPathRow[]):string[];
|
|
@@ -18,17 +18,17 @@ export type StaleLinkedPathClassification = "moved" | "deleted" | "malformed";
|
|
|
18
18
|
/** Documents the classified stale linked path payload exchanged by command, SDK, and package integrations. */
|
|
19
19
|
export interface ClassifiedStaleLinkedPath {
|
|
20
20
|
/** Normalized workspace-relative stale linked path. */
|
|
21
|
-
path:
|
|
21
|
+
path:string;
|
|
22
22
|
/** Value that configures or reports classification for this contract. */
|
|
23
|
-
classification:
|
|
23
|
+
classification:StaleLinkedPathClassification;
|
|
24
24
|
/** Candidate new locations (same basename, different path), sorted and capped at `candidateLimit`. Empty for `deleted` and `malformed`. */
|
|
25
|
-
candidates:
|
|
25
|
+
candidates:string[];
|
|
26
26
|
/** True when more candidates existed than `candidateLimit` allowed. */
|
|
27
|
-
candidates_truncated:
|
|
27
|
+
candidates_truncated:boolean;
|
|
28
28
|
}
|
|
29
29
|
/** Fallback stale path candidate limit used when callers do not provide an override. */
|
|
30
30
|
export declare const DEFAULT_STALE_PATH_CANDIDATE_LIMIT = 3;
|
|
31
31
|
/** Classify each stale (missing) linked path as `moved`, `deleted`, or `malformed` by matching its basename against the candidate file list. Output preserves the input order of `stalePaths` (callers pass an already-sorted unique list). A candidate equal to the stale path itself never matches (the path is known missing; an identical candidate would be self-referential noise). */
|
|
32
|
-
export declare function classifyStaleLinkedPaths(stalePaths:
|
|
32
|
+
export declare function classifyStaleLinkedPaths(stalePaths:readonly string[],candidateFiles:readonly string[],candidateLimit?:number):ClassifiedStaleLinkedPath[];
|
|
33
33
|
/** Render compact `<path>:moved:<top-candidate>` / `<path>:deleted` rows for the files check details (token-efficient counterpart to the full classification objects). */
|
|
34
|
-
export declare function summarizeStaleLinkedPathClassifications(classified:
|
|
34
|
+
export declare function summarizeStaleLinkedPathClassifications(classified:readonly ClassifiedStaleLinkedPath[]):string[];
|
|
@@ -5,56 +5,56 @@
|
|
|
5
5
|
* Serves the pm MCP dispatcher through the sessionless 2026-07-28 Streamable
|
|
6
6
|
* HTTP POST binding with request-scoped JSON/SSE responses.
|
|
7
7
|
*/
|
|
8
|
-
import { type IncomingMessage,
|
|
9
|
-
import { type PmMcpHttpAuthorizationPolicy,
|
|
8
|
+
import { type IncomingMessage,type Server,type ServerResponse } from "node:http";
|
|
9
|
+
import { type PmMcpHttpAuthorizationPolicy,type PmMcpProtectedResourceMetadata } from "../sdk/mcp/authorization.js";
|
|
10
10
|
import { type JsonRpcRequest } from "./server.js";
|
|
11
11
|
/** Runtime options for one real Streamable HTTP server. */
|
|
12
12
|
export interface PmMcpHttpServerOptions {
|
|
13
13
|
/** Local bind host. Defaults to the DNS-rebinding-safe loopback address. */
|
|
14
|
-
host?:
|
|
14
|
+
host?:string;
|
|
15
15
|
/** TCP port. Zero requests an ephemeral port. */
|
|
16
|
-
port?:
|
|
16
|
+
port?:number;
|
|
17
17
|
/** Single modern MCP POST endpoint. */
|
|
18
|
-
endpointPath?:
|
|
18
|
+
endpointPath?:string;
|
|
19
19
|
/** Exact browser origins permitted when an Origin header is present. */
|
|
20
|
-
allowedOrigins?:
|
|
20
|
+
allowedOrigins?:readonly string[];
|
|
21
21
|
/** Optional RFC 9728/OAuth resource-server policy. */
|
|
22
|
-
authorization?:
|
|
22
|
+
authorization?:PmMcpHttpAuthorizationPolicy;
|
|
23
23
|
/** Metadata served at RFC 9728 well-known paths. */
|
|
24
|
-
protectedResourceMetadata?:
|
|
24
|
+
protectedResourceMetadata?:PmMcpProtectedResourceMetadata;
|
|
25
25
|
/** Maximum accepted JSON request bytes. */
|
|
26
|
-
maximumBodyBytes?:
|
|
26
|
+
maximumBodyBytes?:number;
|
|
27
27
|
/** SSE comment interval; zero disables keep-alives. */
|
|
28
|
-
keepAliveMs?:
|
|
28
|
+
keepAliveMs?:number;
|
|
29
29
|
/** Optional embedding dispatcher; defaults to the canonical pm MCP handler. */
|
|
30
|
-
requestHandler?:
|
|
30
|
+
requestHandler?:(request:JsonRpcRequest) => unknown | Promise<unknown>;
|
|
31
31
|
}
|
|
32
32
|
/** Write one SSE event and wait for transport backpressure to clear. */
|
|
33
|
-
export declare function writePmMcpSseEvent(response:
|
|
34
|
-
declare function writeMcpHttpDispatchError(response:
|
|
35
|
-
declare function destroyFailedMcpHttpResponse(response:
|
|
33
|
+
export declare function writePmMcpSseEvent(response:ServerResponse,payload:unknown):Promise<void>;
|
|
34
|
+
declare function writeMcpHttpDispatchError(response:ServerResponse,rpcRequest:JsonRpcRequest | undefined,error:unknown):void;
|
|
35
|
+
declare function destroyFailedMcpHttpResponse(response:ServerResponse,error:unknown):void;
|
|
36
36
|
/** Create a configured HTTP server without binding it. */
|
|
37
|
-
export declare function createPmMcpHttpServer(options?:
|
|
37
|
+
export declare function createPmMcpHttpServer(options?:PmMcpHttpServerOptions):Server<typeof IncomingMessage,typeof ServerResponse>;
|
|
38
38
|
/** Gracefully close subscriptions before stopping a Streamable HTTP server. */
|
|
39
|
-
export declare function closePmMcpHttpServer(server:
|
|
39
|
+
export declare function closePmMcpHttpServer(server:Server):Promise<void>;
|
|
40
40
|
/** Bind the configured Streamable HTTP server and return its actual address. */
|
|
41
|
-
export declare function startPmMcpHttpServer(options?:
|
|
41
|
+
export declare function startPmMcpHttpServer(options?:PmMcpHttpServerOptions):Promise<ReturnType<typeof createPmMcpHttpServer>>;
|
|
42
42
|
/** Resolve loopback-safe bind defaults without opening a socket. */
|
|
43
|
-
export declare function resolvePmMcpHttpListenAddress(options?:
|
|
44
|
-
host:
|
|
45
|
-
port:
|
|
43
|
+
export declare function resolvePmMcpHttpListenAddress(options?:Pick<PmMcpHttpServerOptions,"host" | "port">):{
|
|
44
|
+
host:string;
|
|
45
|
+
port:number;
|
|
46
46
|
};
|
|
47
47
|
/** Resolve and harden executable HTTP options from an environment map. */
|
|
48
|
-
export declare function resolvePmMcpHttpServerOptionsFromEnvironment(processEnvironment?:
|
|
48
|
+
export declare function resolvePmMcpHttpServerOptionsFromEnvironment(processEnvironment?:NodeJS.ProcessEnv):PmMcpHttpServerOptions;
|
|
49
49
|
/** Internal HTTP transport seams used only by direct integration tests. */
|
|
50
|
-
export declare const _testOnly:
|
|
50
|
+
export declare const _testOnly:{
|
|
51
51
|
/** Return the first active request-scoped transport key for one server. */
|
|
52
|
-
activeSubscriptionKey:
|
|
52
|
+
activeSubscriptionKey:(server:Server) => symbol | undefined;
|
|
53
53
|
/** Open a stream against one server runtime without a network socket. */
|
|
54
|
-
openHttpSubscription:
|
|
54
|
+
openHttpSubscription:(server:Server,request:JsonRpcRequest,response:ServerResponse) => Promise<void>;
|
|
55
55
|
/** Exercise committed-response handling without a network race. */
|
|
56
|
-
writeMcpHttpDispatchError:
|
|
56
|
+
writeMcpHttpDispatchError:typeof writeMcpHttpDispatchError;
|
|
57
57
|
/** Exercise the terminal request rejection handler without a live socket. */
|
|
58
|
-
destroyFailedMcpHttpResponse:
|
|
58
|
+
destroyFailedMcpHttpResponse:typeof destroyFailedMcpHttpResponse;
|
|
59
59
|
};
|
|
60
60
|
export {};
|
|
@@ -5,36 +5,36 @@
|
|
|
5
5
|
* canonical stateless dispatcher. No modern transport imports policy from it.
|
|
6
6
|
*/
|
|
7
7
|
import { type AgentClientInfo } from "../sdk/runtime-primitives.js";
|
|
8
|
-
import { PM_MCP_LEGACY_PROTOCOL_VERSIONS,
|
|
8
|
+
import { PM_MCP_LEGACY_PROTOCOL_VERSIONS,type PmMcpImplementation,type PmMcpServerCapabilities } from "../sdk/mcp/protocol.js";
|
|
9
9
|
/** Minimal request shape consumed by the compatibility adapter. */
|
|
10
10
|
export interface LegacyMcpRequest {
|
|
11
11
|
/** Legacy method name. */
|
|
12
|
-
method?:
|
|
12
|
+
method?:string;
|
|
13
13
|
/** Legacy method parameters. */
|
|
14
|
-
params?:
|
|
14
|
+
params?:Record<string,unknown>;
|
|
15
15
|
}
|
|
16
16
|
/** Host callbacks keep this adapter separate from canonical SDK policy. */
|
|
17
17
|
export interface LegacyMcpAdapterOptions {
|
|
18
18
|
/** Immutable server identity. */
|
|
19
|
-
serverInfo:
|
|
19
|
+
serverInfo:PmMcpImplementation;
|
|
20
20
|
/** Compatibility-era capabilities. */
|
|
21
|
-
capabilities:
|
|
21
|
+
capabilities:PmMcpServerCapabilities;
|
|
22
22
|
/** Model-facing usage instructions. */
|
|
23
|
-
instructions:
|
|
23
|
+
instructions:string;
|
|
24
24
|
/** Parse bounded historical client identity. */
|
|
25
|
-
parseClientInfo:
|
|
25
|
+
parseClientInfo:(value:unknown) => AgentClientInfo | undefined;
|
|
26
26
|
/** Resolve legacy tool definitions. */
|
|
27
|
-
listTools:
|
|
27
|
+
listTools:(params:Record<string,unknown> | undefined) => Promise<Record<string,unknown>>;
|
|
28
28
|
/** Execute one legacy tool call. */
|
|
29
|
-
callTool:
|
|
29
|
+
callTool:(params:Record<string,unknown> | undefined,clientInfo:AgentClientInfo | undefined) => Promise<Record<string,unknown>>;
|
|
30
30
|
/** List legacy resources. */
|
|
31
|
-
listResources:
|
|
31
|
+
listResources:() => Record<string,unknown>;
|
|
32
32
|
/** Read one legacy resource. */
|
|
33
|
-
readResource:
|
|
33
|
+
readResource:(params:Record<string,unknown> | undefined) => Promise<Record<string,unknown>>;
|
|
34
34
|
/** List legacy prompts. */
|
|
35
|
-
listPrompts:
|
|
35
|
+
listPrompts:() => Record<string,unknown>;
|
|
36
36
|
/** Render one legacy prompt. */
|
|
37
|
-
getPrompt:
|
|
37
|
+
getPrompt:(params:Record<string,unknown> | undefined) => Record<string,unknown>;
|
|
38
38
|
}
|
|
39
39
|
/**
|
|
40
40
|
* Resolve the legacy revision a handshake negotiates, or refuse with the full
|
|
@@ -44,16 +44,16 @@ getPrompt: (params: Record<string, unknown> | undefined) => Record<string, unkno
|
|
|
44
44
|
* accepted legacy revision alongside the canonical modern one: the error text
|
|
45
45
|
* is the only diagnostic such a client can surface.
|
|
46
46
|
*/
|
|
47
|
-
export declare function resolveLegacyProtocolVersion(requestedVersion:
|
|
47
|
+
export declare function resolveLegacyProtocolVersion(requestedVersion:unknown):(typeof PM_MCP_LEGACY_PROTOCOL_VERSIONS)[number];
|
|
48
48
|
/** Explicit compatibility adapter with no cross-process or modern-session role. */
|
|
49
49
|
export declare class LegacyMcpAdapter {
|
|
50
50
|
#private;
|
|
51
51
|
/** Create one process-local legacy stdio adapter. */
|
|
52
|
-
constructor(options:
|
|
52
|
+
constructor(options:LegacyMcpAdapterOptions);
|
|
53
53
|
/** Read the bounded identity most recently supplied to legacy initialize. */
|
|
54
|
-
getClientInfo():
|
|
54
|
+
getClientInfo():AgentClientInfo | undefined;
|
|
55
55
|
/** Validate and answer the historical initialize handshake. */
|
|
56
|
-
initialize(params:
|
|
56
|
+
initialize(params:Record<string,unknown> | undefined):Record<string,unknown>;
|
|
57
57
|
/** Dispatch one unversioned request through the finite legacy method set. */
|
|
58
|
-
dispatch(request:
|
|
58
|
+
dispatch(request:LegacyMcpRequest):Promise<Record<string,unknown>>;
|
|
59
59
|
}
|
|
@@ -5,53 +5,53 @@
|
|
|
5
5
|
* public SDK contracts.
|
|
6
6
|
*/
|
|
7
7
|
import { type PmMcpToolProfile } from "../sdk/agent-capability-contracts.js";
|
|
8
|
-
import { type WorkspaceContracts,
|
|
8
|
+
import { type WorkspaceContracts,type WorkspaceExtensionCommandContract } from "../sdk/runtime.js";
|
|
9
9
|
import { type ToolDefinition } from "./tool-definitions.js";
|
|
10
10
|
/** Environment configuration accepted by the MCP profile resolver. */
|
|
11
11
|
export interface McpProfileEnvironment {
|
|
12
12
|
/** Named built-in or custom MCP surface profile. */
|
|
13
|
-
PM_MCP_PROFILE?:
|
|
13
|
+
PM_MCP_PROFILE?:string;
|
|
14
14
|
/** Comma-separated exact tool allowlist used by the custom profile. */
|
|
15
|
-
PM_MCP_TOOLS?:
|
|
15
|
+
PM_MCP_TOOLS?:string;
|
|
16
16
|
}
|
|
17
17
|
/** Fully resolved MCP tool surface for one request workspace. */
|
|
18
18
|
export interface ResolvedMcpToolSurface {
|
|
19
19
|
/** Resolved profile after environment validation. */
|
|
20
|
-
profile:
|
|
20
|
+
profile:PmMcpToolProfile;
|
|
21
21
|
/** Runtime-filtered and workspace-enriched MCP definitions. */
|
|
22
|
-
tools:
|
|
22
|
+
tools:ToolDefinition[];
|
|
23
23
|
/** Extension action names reachable through the selected surface. */
|
|
24
|
-
extensionActions:
|
|
24
|
+
extensionActions:string[];
|
|
25
25
|
}
|
|
26
26
|
/** Profile decision for one tool call without projecting every tool schema. */
|
|
27
27
|
export interface ResolvedMcpToolAccess {
|
|
28
28
|
/** Resolved profile after environment validation. */
|
|
29
|
-
profile:
|
|
29
|
+
profile:PmMcpToolProfile;
|
|
30
30
|
/** Whether the requested tool is callable in that profile and workspace. */
|
|
31
|
-
available:
|
|
31
|
+
available:boolean;
|
|
32
32
|
}
|
|
33
|
-
declare function workspaceFields(workspace:
|
|
34
|
-
declare function workspaceExtensionCommands(workspace:
|
|
33
|
+
declare function workspaceFields(workspace:Pick<WorkspaceContracts,"fields">):NonNullable<WorkspaceContracts["fields"]>;
|
|
34
|
+
declare function workspaceExtensionCommands(workspace:Pick<WorkspaceContracts,"extensionCommands">):NonNullable<WorkspaceContracts["extensionCommands"]>;
|
|
35
35
|
/** Resolve and validate the configured MCP profile. */
|
|
36
|
-
export declare function resolveMcpToolProfile(environment?:
|
|
36
|
+
export declare function resolveMcpToolProfile(environment?:McpProfileEnvironment):PmMcpToolProfile;
|
|
37
37
|
/** Select extension actions visible to one validated MCP profile. */
|
|
38
|
-
export declare function selectMcpExtensionActions(commands:
|
|
38
|
+
export declare function selectMcpExtensionActions(commands:readonly WorkspaceExtensionCommandContract[],profile:PmMcpToolProfile,selectedNames:ReadonlySet<string>):string[];
|
|
39
39
|
/**
|
|
40
40
|
* Resolve a profile-filtered tool list and enrich schemas with live workspace
|
|
41
41
|
* types, statuses, custom fields, and extension actions.
|
|
42
42
|
*/
|
|
43
|
-
export declare function resolveMcpToolSurface(availableTools:
|
|
43
|
+
export declare function resolveMcpToolSurface(availableTools:readonly ToolDefinition[],args?:Record<string,unknown>,environment?:McpProfileEnvironment):Promise<ResolvedMcpToolSurface>;
|
|
44
44
|
/**
|
|
45
45
|
* Resolve one tool's callability without cloning and enriching the complete
|
|
46
46
|
* schema surface. Only compact/standard `pm_run` calls need workspace
|
|
47
47
|
* contracts because an activated extension action can promote that dispatcher.
|
|
48
48
|
*/
|
|
49
|
-
export declare function resolveMcpToolAccess(availableTools:
|
|
49
|
+
export declare function resolveMcpToolAccess(availableTools:readonly ToolDefinition[],toolName:string,args?:Record<string,unknown>,environment?:McpProfileEnvironment):Promise<ResolvedMcpToolAccess>;
|
|
50
50
|
/** Move declared custom-field inputs into the runtime action option bag. */
|
|
51
|
-
export declare function normalizeWorkspaceToolArguments(toolName:
|
|
51
|
+
export declare function normalizeWorkspaceToolArguments(toolName:string,args:Record<string,unknown>):Promise<Record<string,unknown>>;
|
|
52
52
|
/** Internal compatibility helpers exposed only for exhaustive fallback tests. */
|
|
53
|
-
export declare const _testOnlyMcpRuntimeCapabilities:
|
|
54
|
-
workspaceExtensionCommands:
|
|
55
|
-
workspaceFields:
|
|
53
|
+
export declare const _testOnlyMcpRuntimeCapabilities:{
|
|
54
|
+
workspaceExtensionCommands:typeof workspaceExtensionCommands;
|
|
55
|
+
workspaceFields:typeof workspaceFields;
|
|
56
56
|
};
|
|
57
57
|
export {};
|