@unbrained/pm-cli 2026.10.14 → 2026.10.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +1 -1
- package/CHANGELOG.md +54 -2
- 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-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/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-5LU6PWA4.js → chunk-52EZH2QQ.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-7OEGNA4X.js +20 -0
- package/dist/cli-bundle/chunks/{chunk-LKESCZEN.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-PP3BVMFL.js → chunk-JSUJWIHQ.js} +30 -30
- package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-LNKLQYBG.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-N56CAQBU.js} +63 -64
- package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-NC3QVGDD.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-RJ5N44WY.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-LOSRTNNP.js → chunk-VIMQCFCK.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-WBBW3WQX.js} +4 -4
- package/dist/cli-bundle/chunks/chunk-X2H6UR26.js +236 -0
- package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-FKKFQ66D.js} +7 -7
- package/dist/cli-bundle/chunks/{register-mutation-TNRHNK4N.js → register-mutation-EWMMVZJB.js} +2 -2
- package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-GEQ2H7PS.js} +2 -2
- package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-PSJTQBBO.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-3RNUMVK4.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-4KQFMOM7.js} +6 -6
- package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-52I2SNKJ.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-5KRACGBK.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-5OO54BIV.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-LKWDWER4.js → chunk-5TBAVZDR.js} +14 -14
- package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-FQKPOZKS.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-H3P77KVU.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-HTA3TNC3.js +26 -0
- package/dist/cli-bundle/focused-chunks/{chunk-23ACMPGB.js → chunk-JKBH7YGX.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-KIIFVULU.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-N6FUKTZS.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-PDYE7QDX.js +166 -0
- package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-Q4VNCTR2.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-THYQR3ON.js} +61 -62
- package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-TYLG5VEB.js} +2 -2
- package/dist/cli-bundle/main.js +26 -26
- 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 +22 -22
- 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 +11 -11
- 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 +27 -27
- package/dist/core/sentry/instrument.d.ts +51 -51
- 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/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/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/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 +53 -53
- 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 +248 -248
- 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/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
- package/docs/LINKED_TEST_EDITS.md +15 -0
- package/docs/RELEASING.md +2 -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-66BZVFIK.js +0 -6
- package/dist/cli-bundle/chunks/chunk-IDEHMKYZ.js +0 -235
- package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
- package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
- package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
package/dist/sdk/testing.d.ts
CHANGED
|
@@ -3,47 +3,47 @@
|
|
|
3
3
|
*
|
|
4
4
|
* Defines public SDK APIs and package-author helpers for Testing.
|
|
5
5
|
*/
|
|
6
|
-
import type { AfterCommandHookContext,
|
|
7
|
-
import { describeExtensionBlueprint,
|
|
6
|
+
import type { AfterCommandHookContext,BeforeCommandHookContext,BeforeMutationHookContext,CommandHandlerResult,CommandOverrideContext,CommandOverrideResult,ExtensionActivationResult,ExtensionCapability,ExtensionCommandRegistry,ExtensionDeactivationResult,ExtensionGovernancePolicy,ExtensionHookRegistry,ExtensionCommandSdk,ExtensionLayer,ExtensionManifest,ExtensionParserRegistry,ExtensionPreflightRegistry,ExtensionRegistrationRegistry,ExtensionRendererRegistry,ExtensionServiceName,ExtensionServiceRegistry,FlagDefinition,OnIndexHookContext,OnReadHookContext,OnWriteHookContext,OutputRendererFormat,ParserOverrideContext,ParserOverrideResult,PreflightOverrideContext,PreflightOverrideResult,RegisteredExtensionCommandDefinition,RegisteredExtensionCommandOverride,RegisteredExtensionExporter,RegisteredExtensionFlagDefinitions,RegisteredExtensionImporter,RegisteredExtensionParserOverride,RegisteredExtensionPreflightOverride,RegisteredExtensionProjectProfile,RegisteredExtensionRendererOverride,RegisteredExtensionSchemaFieldDefinitions,RegisteredExtensionSchemaItemTypeDefinitions,RegisteredExtensionSchemaMigrationDefinition,RegisteredExtensionSearchProvider,RegisteredExtensionServiceOverride,RegisteredExtensionVectorStoreAdapter,RendererOverrideContext,RendererOverrideResult,SchemaFieldDefinition,SchemaItemTypeDefinition,SearchProviderEmbedBatchContext,SearchProviderEmbedContext,SearchProviderQueryContext,SearchProviderQueryExpansionContext,SearchProviderQueryExpansionResult,SearchProviderQueryResult,SearchProviderRerankContext,SearchProviderRerankResult,ServiceOverrideContext,ServiceOverrideResult,VectorStoreDeleteContext,VectorStoreQueryContext,VectorStoreQueryHit,VectorStoreUpsertContext } from "../core/extensions/loader.js";
|
|
7
|
+
import { describeExtensionBlueprint,lintExtensionBlueprint } from "./compose.js";
|
|
8
8
|
import { describeExtensionActivation } from "../core/extensions/activation-summary.js";
|
|
9
|
-
import type { DescribeExtensionActivationOptions,
|
|
9
|
+
import type { DescribeExtensionActivationOptions,ExtensionActivationSummary } from "../core/extensions/activation-summary.js";
|
|
10
10
|
import type { ProjectProfileDefinition } from "../core/profile/profile-presets.js";
|
|
11
11
|
import { type ProjectProfileLintReport } from "../core/profile/profile-lint.js";
|
|
12
12
|
import { renderExtensionSurfaceMarkdown } from "../core/extensions/activation-summary-markdown.js";
|
|
13
13
|
import type { ExtensionSurfaceMarkdownOptions } from "../core/extensions/activation-summary-markdown.js";
|
|
14
|
-
import type { ExtensionBlueprint,
|
|
14
|
+
import type { ExtensionBlueprint,ExtensionBlueprintLintCode,ExtensionBlueprintLintFinding,ExtensionBlueprintLintResult,ExtensionBlueprintLintSeverity,ExtensionManifestCompatibilityManifest,ExtensionManifestCompatibilityResult,ExtensionManifestCompatibilityTarget,ExtensionPreflightReport,LintExtensionBlueprintOptions,PreflightExtensionOptions } from "./compose.js";
|
|
15
15
|
import type { GlobalOptions } from "../core/shared/command-types.js";
|
|
16
|
-
import type { PmPackageManifest,
|
|
16
|
+
import type { PmPackageManifest,PmPackageResourceKind } from "../core/packages/manifest.js";
|
|
17
17
|
/** Host-pinned TOON codecs for semantic package-output assertions without deep imports. */
|
|
18
|
-
export { decode as decodeToon,
|
|
18
|
+
export { decode as decodeToon,encode as encodeToon } from "@toon-format/toon";
|
|
19
19
|
/** Codec options and JSON values owned by the exact implementation used by the host. */
|
|
20
|
-
export type { DecodeOptions as ToonDecodeOptions,
|
|
21
|
-
export { describeExtensionActivation,
|
|
22
|
-
export type { DescribeExtensionActivationOptions,
|
|
20
|
+
export type { DecodeOptions as ToonDecodeOptions,EncodeOptions as ToonEncodeOptions,JsonValue as ToonJsonValue } from "@toon-format/toon";
|
|
21
|
+
export { describeExtensionActivation,renderExtensionSurfaceMarkdown };
|
|
22
|
+
export type { DescribeExtensionActivationOptions,ExtensionActivationSummary,} from "../core/extensions/activation-summary.js";
|
|
23
23
|
export type { ExtensionSurfaceMarkdownOptions } from "../core/extensions/activation-summary-markdown.js";
|
|
24
|
-
export { describeExtensionBlueprint,
|
|
25
|
-
export type { ExtensionBlueprint,
|
|
24
|
+
export { describeExtensionBlueprint,lintExtensionBlueprint };
|
|
25
|
+
export type { ExtensionBlueprint,ExtensionBlueprintLintCode,ExtensionBlueprintLintFinding,ExtensionBlueprintLintResult,ExtensionBlueprintLintSeverity,LintExtensionBlueprintOptions,};
|
|
26
26
|
/** Documents the activate extension for test options payload exchanged by command, SDK, and package integrations. */
|
|
27
27
|
export interface ActivateExtensionForTestOptions {
|
|
28
28
|
/** Value that configures or reports name for this contract. */
|
|
29
|
-
name?:
|
|
29
|
+
name?:string;
|
|
30
30
|
/** Value that configures or reports layer for this contract. */
|
|
31
|
-
layer?:
|
|
31
|
+
layer?:ExtensionLayer;
|
|
32
32
|
/** Value that configures or reports capabilities for this contract. */
|
|
33
|
-
capabilities?:
|
|
33
|
+
capabilities?:readonly ExtensionCapability[];
|
|
34
34
|
/** Value that configures or reports policy for this contract. */
|
|
35
|
-
policy?:
|
|
35
|
+
policy?:ExtensionGovernancePolicy;
|
|
36
36
|
}
|
|
37
37
|
/** Documents the deactivate extension for test options payload exchanged by command, SDK, and package integrations. */
|
|
38
38
|
export interface DeactivateExtensionForTestOptions {
|
|
39
39
|
/** Overrides the in-memory extension name (defaults to `manifest.name` or `"test-extension"`). */
|
|
40
|
-
name?:
|
|
40
|
+
name?:string;
|
|
41
41
|
/** Overrides the layer recorded for the in-memory extension (defaults to `"project"`). */
|
|
42
|
-
layer?:
|
|
42
|
+
layer?:ExtensionLayer;
|
|
43
43
|
/** Activation result returned by `activateExtensionForTest`. When provided, an extension whose `activate` failed is skipped — mirroring the host teardown contract that never deactivates a never-initialized extension. Pass the same `name`/`layer` to both helpers so the skip key matches. */
|
|
44
|
-
activation?:
|
|
44
|
+
activation?:Pick<ExtensionActivationResult,"failed">;
|
|
45
45
|
/** Per-hook teardown bound, forwarded as `deactivate_timeout_ms`. Use `0` (or `Infinity`) to wait indefinitely; omit to keep the host default. */
|
|
46
|
-
deactivateTimeoutMs?:
|
|
46
|
+
deactivateTimeoutMs?:number;
|
|
47
47
|
}
|
|
48
48
|
/**
|
|
49
49
|
* Options for {@link runRegisteredCommandForTest} — the inputs forwarded to a
|
|
@@ -51,28 +51,28 @@ deactivateTimeoutMs?: number;
|
|
|
51
51
|
*/
|
|
52
52
|
export interface RunRegisteredCommandForTestOptions {
|
|
53
53
|
/** Full registered command path to invoke, e.g. `"hello"` or `"todos import"`. Matched against `commands.handlers[].command` after normalization (trimmed, lower-cased, internal whitespace collapsed), mirroring runtime dispatch. */
|
|
54
|
-
command:
|
|
54
|
+
command:string;
|
|
55
55
|
/** Positional arguments forwarded as `context.args` (default: none). */
|
|
56
|
-
args?:
|
|
56
|
+
args?:readonly string[];
|
|
57
57
|
/** Parsed flags/options forwarded as `context.options` (default: none). */
|
|
58
|
-
options?:
|
|
58
|
+
options?:Record<string,unknown>;
|
|
59
59
|
/** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
|
|
60
|
-
global?:
|
|
60
|
+
global?:Partial<GlobalOptions>;
|
|
61
61
|
/** Resolved tracker storage root forwarded as `context.pm_root` (default: `""`), normally `<workspace>/.agents/pm`; this is not the workspace root. */
|
|
62
|
-
pmRoot?:
|
|
62
|
+
pmRoot?:string;
|
|
63
63
|
/** Explicit host SDK override for specialized tests. Mutually exclusive with sdkFactory. */
|
|
64
|
-
sdk?:
|
|
64
|
+
sdk?:ExtensionCommandSdk;
|
|
65
65
|
/** Lazily build a typed host SDK override from the resolved test context. `pmRoot` is the tracker storage root (normally `<workspace>/.agents/pm`), not the workspace root. */
|
|
66
|
-
sdkFactory?:
|
|
66
|
+
sdkFactory?:(context:{
|
|
67
67
|
/** Tracker storage root for tracker data under `.agents/pm`, not the workspace root. */
|
|
68
|
-
pmRoot:
|
|
69
|
-
global:
|
|
68
|
+
pmRoot:string;
|
|
69
|
+
global:GlobalOptions;
|
|
70
70
|
}) => ExtensionCommandSdk;
|
|
71
71
|
}
|
|
72
72
|
/** Options for invoking a registered transactional mutation guard in package tests. */
|
|
73
73
|
export interface RunRegisteredMutationGuardForTestOptions {
|
|
74
74
|
/** Synthetic proposed mutation context, including a host-bound read-only SDK. */
|
|
75
|
-
context:
|
|
75
|
+
context:BeforeMutationHookContext;
|
|
76
76
|
}
|
|
77
77
|
/**
|
|
78
78
|
* Options for {@link runRegisteredHookForTest} — the lifecycle `kind` to fire and
|
|
@@ -84,20 +84,20 @@ context: BeforeMutationHookContext;
|
|
|
84
84
|
* pass an index context to a read hook.
|
|
85
85
|
*/
|
|
86
86
|
export type RunRegisteredHookForTestOptions = {
|
|
87
|
-
kind:
|
|
88
|
-
context:
|
|
87
|
+
kind:"before_command";
|
|
88
|
+
context:BeforeCommandHookContext;
|
|
89
89
|
} | {
|
|
90
|
-
kind:
|
|
91
|
-
context:
|
|
90
|
+
kind:"after_command";
|
|
91
|
+
context:AfterCommandHookContext;
|
|
92
92
|
} | {
|
|
93
|
-
kind:
|
|
94
|
-
context:
|
|
93
|
+
kind:"on_read";
|
|
94
|
+
context:OnReadHookContext;
|
|
95
95
|
} | {
|
|
96
|
-
kind:
|
|
97
|
-
context:
|
|
96
|
+
kind:"on_write";
|
|
97
|
+
context:OnWriteHookContext;
|
|
98
98
|
} | {
|
|
99
|
-
kind:
|
|
100
|
-
context:
|
|
99
|
+
kind:"on_index";
|
|
100
|
+
context:OnIndexHookContext;
|
|
101
101
|
};
|
|
102
102
|
/**
|
|
103
103
|
* Maps each invokable search-provider operation to the context type its function
|
|
@@ -108,15 +108,15 @@ context: OnIndexHookContext;
|
|
|
108
108
|
*/
|
|
109
109
|
export interface SearchProviderOperationContexts {
|
|
110
110
|
/** Value that configures or reports query for this contract. */
|
|
111
|
-
query:
|
|
111
|
+
query:SearchProviderQueryContext;
|
|
112
112
|
/** Value that configures or reports embed for this contract. */
|
|
113
|
-
embed:
|
|
113
|
+
embed:SearchProviderEmbedContext;
|
|
114
114
|
/** Value that configures or reports embed batch for this contract. */
|
|
115
|
-
embedBatch:
|
|
115
|
+
embedBatch:SearchProviderEmbedBatchContext;
|
|
116
116
|
/** Value that configures or reports query expansion for this contract. */
|
|
117
|
-
queryExpansion:
|
|
117
|
+
queryExpansion:SearchProviderQueryExpansionContext;
|
|
118
118
|
/** Value that configures or reports rerank for this contract. */
|
|
119
|
-
rerank:
|
|
119
|
+
rerank:SearchProviderRerankContext;
|
|
120
120
|
}
|
|
121
121
|
/**
|
|
122
122
|
* Maps each invokable search-provider operation to the result type its function
|
|
@@ -125,15 +125,15 @@ rerank: SearchProviderRerankContext;
|
|
|
125
125
|
*/
|
|
126
126
|
export interface SearchProviderOperationResults {
|
|
127
127
|
/** Value that configures or reports query for this contract. */
|
|
128
|
-
query:
|
|
128
|
+
query:SearchProviderQueryResult;
|
|
129
129
|
/** Value that configures or reports embed for this contract. */
|
|
130
|
-
embed:
|
|
130
|
+
embed:number[];
|
|
131
131
|
/** Value that configures or reports embed batch for this contract. */
|
|
132
|
-
embedBatch:
|
|
132
|
+
embedBatch:number[][];
|
|
133
133
|
/** Value that configures or reports query expansion for this contract. */
|
|
134
|
-
queryExpansion:
|
|
134
|
+
queryExpansion:SearchProviderQueryExpansionResult;
|
|
135
135
|
/** Value that configures or reports rerank for this contract. */
|
|
136
|
-
rerank:
|
|
136
|
+
rerank:SearchProviderRerankResult;
|
|
137
137
|
}
|
|
138
138
|
/**
|
|
139
139
|
* Options for {@link runRegisteredSearchProviderForTest}: the registered
|
|
@@ -144,13 +144,13 @@ rerank: SearchProviderRerankResult;
|
|
|
144
144
|
* {@link SearchProviderRerankContext}, and so on.
|
|
145
145
|
*/
|
|
146
146
|
export type RunRegisteredSearchProviderForTestOptions = {
|
|
147
|
-
[Operation in keyof SearchProviderOperationContexts]:
|
|
147
|
+
[Operation in keyof SearchProviderOperationContexts]:{
|
|
148
148
|
/** Registered provider name to resolve, matched case-insensitively as the host does. */
|
|
149
|
-
provider:
|
|
149
|
+
provider:string;
|
|
150
150
|
/** Provider operation to invoke. */
|
|
151
|
-
operation:
|
|
151
|
+
operation:Operation;
|
|
152
152
|
/** Synthetic context handed to the resolved operation function. */
|
|
153
|
-
context:
|
|
153
|
+
context:SearchProviderOperationContexts[Operation];
|
|
154
154
|
};
|
|
155
155
|
}[keyof SearchProviderOperationContexts];
|
|
156
156
|
/**
|
|
@@ -161,11 +161,11 @@ context: SearchProviderOperationContexts[Operation];
|
|
|
161
161
|
*/
|
|
162
162
|
export interface VectorStoreAdapterOperationContexts {
|
|
163
163
|
/** Value that configures or reports query for this contract. */
|
|
164
|
-
query:
|
|
164
|
+
query:VectorStoreQueryContext;
|
|
165
165
|
/** Value that configures or reports upsert for this contract. */
|
|
166
|
-
upsert:
|
|
166
|
+
upsert:VectorStoreUpsertContext;
|
|
167
167
|
/** Value that configures or reports delete for this contract. */
|
|
168
|
-
delete:
|
|
168
|
+
delete:VectorStoreDeleteContext;
|
|
169
169
|
}
|
|
170
170
|
/**
|
|
171
171
|
* Maps each invokable vector-store-adapter operation to the result type its
|
|
@@ -175,11 +175,11 @@ delete: VectorStoreDeleteContext;
|
|
|
175
175
|
*/
|
|
176
176
|
export interface VectorStoreAdapterOperationResults {
|
|
177
177
|
/** Value that configures or reports query for this contract. */
|
|
178
|
-
query:
|
|
178
|
+
query:VectorStoreQueryHit[];
|
|
179
179
|
/** Value that configures or reports upsert for this contract. */
|
|
180
|
-
upsert:
|
|
180
|
+
upsert:unknown;
|
|
181
181
|
/** Value that configures or reports delete for this contract. */
|
|
182
|
-
delete:
|
|
182
|
+
delete:unknown;
|
|
183
183
|
}
|
|
184
184
|
/**
|
|
185
185
|
* Options for {@link runRegisteredVectorStoreAdapterForTest}: the registered
|
|
@@ -190,13 +190,13 @@ delete: unknown;
|
|
|
190
190
|
* {@link VectorStoreDeleteContext}, and so on.
|
|
191
191
|
*/
|
|
192
192
|
export type RunRegisteredVectorStoreAdapterForTestOptions = {
|
|
193
|
-
[Operation in keyof VectorStoreAdapterOperationContexts]:
|
|
193
|
+
[Operation in keyof VectorStoreAdapterOperationContexts]:{
|
|
194
194
|
/** Registered adapter name to resolve, matched case-insensitively as the host does. */
|
|
195
|
-
adapter:
|
|
195
|
+
adapter:string;
|
|
196
196
|
/** Adapter operation to invoke. */
|
|
197
|
-
operation:
|
|
197
|
+
operation:Operation;
|
|
198
198
|
/** Synthetic context handed to the resolved operation function. */
|
|
199
|
-
context:
|
|
199
|
+
context:VectorStoreAdapterOperationContexts[Operation];
|
|
200
200
|
};
|
|
201
201
|
}[keyof VectorStoreAdapterOperationContexts];
|
|
202
202
|
/**
|
|
@@ -205,11 +205,11 @@ context: VectorStoreAdapterOperationContexts[Operation];
|
|
|
205
205
|
*/
|
|
206
206
|
export interface RunRegisteredMigrationForTestOptions {
|
|
207
207
|
/** Registered migration id to resolve, matched case-insensitively against `definition.id`. */
|
|
208
|
-
migration:
|
|
208
|
+
migration:string;
|
|
209
209
|
/** Optional extension name to disambiguate when several extensions register the same id. */
|
|
210
|
-
extensionName?:
|
|
210
|
+
extensionName?:string;
|
|
211
211
|
/** Resolved pm workspace root forwarded as `context.pm_root` (default `""`). */
|
|
212
|
-
pmRoot?:
|
|
212
|
+
pmRoot?:string;
|
|
213
213
|
}
|
|
214
214
|
/**
|
|
215
215
|
* Options for {@link runRegisteredImporterForTest} — the registered importer name
|
|
@@ -222,17 +222,17 @@ pmRoot?: string;
|
|
|
222
222
|
*/
|
|
223
223
|
export interface RunRegisteredImporterForTestOptions {
|
|
224
224
|
/** Registered importer name to resolve, e.g. `"csv"` for a `"csv import"` handler. */
|
|
225
|
-
importer:
|
|
225
|
+
importer:string;
|
|
226
226
|
/** Optional extension name to disambiguate when several extensions register the same importer. */
|
|
227
|
-
extensionName?:
|
|
227
|
+
extensionName?:string;
|
|
228
228
|
/** Positional arguments forwarded as `context.args` (default: none). */
|
|
229
|
-
args?:
|
|
229
|
+
args?:readonly string[];
|
|
230
230
|
/** Parsed flags/options forwarded as `context.options` (default: none). */
|
|
231
|
-
options?:
|
|
231
|
+
options?:Record<string,unknown>;
|
|
232
232
|
/** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
|
|
233
|
-
global?:
|
|
233
|
+
global?:Partial<GlobalOptions>;
|
|
234
234
|
/** Resolved pm workspace root forwarded as `context.pm_root` (default: `""`). */
|
|
235
|
-
pmRoot?:
|
|
235
|
+
pmRoot?:string;
|
|
236
236
|
}
|
|
237
237
|
/**
|
|
238
238
|
* Options for {@link runRegisteredExporterForTest} — the registered exporter name
|
|
@@ -245,186 +245,186 @@ pmRoot?: string;
|
|
|
245
245
|
*/
|
|
246
246
|
export interface RunRegisteredExporterForTestOptions {
|
|
247
247
|
/** Registered exporter name to resolve, e.g. `"csv"` for a `"csv export"` handler. */
|
|
248
|
-
exporter:
|
|
248
|
+
exporter:string;
|
|
249
249
|
/** Optional extension name to disambiguate when several extensions register the same exporter. */
|
|
250
|
-
extensionName?:
|
|
250
|
+
extensionName?:string;
|
|
251
251
|
/** Positional arguments forwarded as `context.args` (default: none). */
|
|
252
|
-
args?:
|
|
252
|
+
args?:readonly string[];
|
|
253
253
|
/** Parsed flags/options forwarded as `context.options` (default: none). */
|
|
254
|
-
options?:
|
|
254
|
+
options?:Record<string,unknown>;
|
|
255
255
|
/** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
|
|
256
|
-
global?:
|
|
256
|
+
global?:Partial<GlobalOptions>;
|
|
257
257
|
/** Resolved pm workspace root forwarded as `context.pm_root` (default: `""`). */
|
|
258
|
-
pmRoot?:
|
|
258
|
+
pmRoot?:string;
|
|
259
259
|
}
|
|
260
260
|
/** Documents the extension deactivation expectation payload exchanged by command, SDK, and package integrations. */
|
|
261
261
|
export interface ExtensionDeactivationExpectation {
|
|
262
262
|
/** Expected count of extensions whose `deactivate` ran without throwing (default `1`). */
|
|
263
|
-
deactivated?:
|
|
263
|
+
deactivated?:number;
|
|
264
264
|
/** Expected count of teardown failures (default `0`). */
|
|
265
|
-
failed?:
|
|
265
|
+
failed?:number;
|
|
266
266
|
}
|
|
267
|
-
type NamedRegistrationExpectation<TLegacyKey extends string,
|
|
268
|
-
name:
|
|
269
|
-
} & Partial<Record<TLegacyKey,
|
|
270
|
-
name?:
|
|
271
|
-
} & Record<TLegacyKey,
|
|
267
|
+
type NamedRegistrationExpectation<TLegacyKey extends string,TValue,TDetails extends object = Record<never,never>> = TDetails & (({
|
|
268
|
+
name:TValue;
|
|
269
|
+
} & Partial<Record<TLegacyKey,TValue>>) | ({
|
|
270
|
+
name?:TValue;
|
|
271
|
+
} & Record<TLegacyKey,TValue>));
|
|
272
272
|
/** Documents the registered command contract expectation payload exchanged by command, SDK, and package integrations. `name` is canonical; `command` remains a backward-compatible alias. */
|
|
273
|
-
export type RegisteredCommandContractExpectation = NamedRegistrationExpectation<"command",
|
|
273
|
+
export type RegisteredCommandContractExpectation = NamedRegistrationExpectation<"command",string,{
|
|
274
274
|
/** Value that configures or reports action for this contract. */
|
|
275
|
-
action?:
|
|
275
|
+
action?:string;
|
|
276
276
|
/** Value that configures or reports extension name for this contract. */
|
|
277
|
-
extensionName?:
|
|
277
|
+
extensionName?:string;
|
|
278
278
|
/** Value that configures or reports arguments for this contract. */
|
|
279
|
-
arguments?:
|
|
279
|
+
arguments?:string[];
|
|
280
280
|
/** Value that configures or reports flags for this contract. */
|
|
281
|
-
flags?:
|
|
281
|
+
flags?:string[];
|
|
282
282
|
}>;
|
|
283
283
|
/** Documents the registered command contract assertion payload exchanged by command, SDK, and package integrations. */
|
|
284
284
|
export interface RegisteredCommandContractAssertion {
|
|
285
285
|
/** Value that configures or reports command for this contract. */
|
|
286
|
-
command:
|
|
286
|
+
command:RegisteredExtensionCommandDefinition;
|
|
287
287
|
/** Value that configures or reports flags for this contract. */
|
|
288
|
-
flags:
|
|
288
|
+
flags:FlagDefinition[];
|
|
289
289
|
}
|
|
290
290
|
/** Documents the registered flags expectation payload exchanged by command, SDK, and package integrations. */
|
|
291
|
-
export type RegisteredFlagsExpectation = NamedRegistrationExpectation<"targetCommand",
|
|
291
|
+
export type RegisteredFlagsExpectation = NamedRegistrationExpectation<"targetCommand",string,{
|
|
292
292
|
/** Value that configures or reports extension name for this contract. */
|
|
293
|
-
extensionName?:
|
|
293
|
+
extensionName?:string;
|
|
294
294
|
/** Value that configures or reports flags for this contract. */
|
|
295
|
-
flags?:
|
|
295
|
+
flags?:string[];
|
|
296
296
|
}>;
|
|
297
297
|
/** Public hook lifecycle kinds an extension can register through `api.hooks.*`. */
|
|
298
298
|
export type RegisteredHookKind = "before_command" | "before_mutation" | "after_command" | "on_read" | "on_write" | "on_index";
|
|
299
|
-
declare const HOOK_KIND_TO_REGISTRY_FIELD:
|
|
299
|
+
declare const HOOK_KIND_TO_REGISTRY_FIELD:Record<RegisteredHookKind,keyof ExtensionHookRegistry>;
|
|
300
300
|
type RegisteredHookEntry<TKind extends RegisteredHookKind> = NonNullable<ExtensionHookRegistry[(typeof HOOK_KIND_TO_REGISTRY_FIELD)[TKind]]>[number];
|
|
301
301
|
/** Documents the registered hook expectation payload exchanged by command, SDK, and package integrations. */
|
|
302
302
|
export interface RegisteredHookExpectation {
|
|
303
303
|
/** Value that configures or reports kind for this contract. */
|
|
304
|
-
kind:
|
|
304
|
+
kind:RegisteredHookKind;
|
|
305
305
|
/** Value that configures or reports extension name for this contract. */
|
|
306
|
-
extensionName?:
|
|
306
|
+
extensionName?:string;
|
|
307
307
|
}
|
|
308
308
|
/** Documents the registered search provider expectation payload exchanged by command, SDK, and package integrations. */
|
|
309
|
-
export type RegisteredSearchProviderExpectation = NamedRegistrationExpectation<"provider",
|
|
309
|
+
export type RegisteredSearchProviderExpectation = NamedRegistrationExpectation<"provider",string,{
|
|
310
310
|
/** Value that configures or reports extension name for this contract. */
|
|
311
|
-
extensionName?:
|
|
311
|
+
extensionName?:string;
|
|
312
312
|
}>;
|
|
313
313
|
/** Documents the registered vector store adapter expectation payload exchanged by command, SDK, and package integrations. */
|
|
314
|
-
export type RegisteredVectorStoreAdapterExpectation = NamedRegistrationExpectation<"adapter",
|
|
314
|
+
export type RegisteredVectorStoreAdapterExpectation = NamedRegistrationExpectation<"adapter",string,{
|
|
315
315
|
/** Value that configures or reports extension name for this contract. */
|
|
316
|
-
extensionName?:
|
|
316
|
+
extensionName?:string;
|
|
317
317
|
}>;
|
|
318
318
|
/** Documents the registered importer expectation payload exchanged by command, SDK, and package integrations. */
|
|
319
|
-
export type RegisteredImporterExpectation = NamedRegistrationExpectation<"importer",
|
|
319
|
+
export type RegisteredImporterExpectation = NamedRegistrationExpectation<"importer",string,{
|
|
320
320
|
/** Value that configures or reports extension name for this contract. */
|
|
321
|
-
extensionName?:
|
|
321
|
+
extensionName?:string;
|
|
322
322
|
}>;
|
|
323
323
|
/** Documents the registered exporter expectation payload exchanged by command, SDK, and package integrations. */
|
|
324
|
-
export type RegisteredExporterExpectation = NamedRegistrationExpectation<"exporter",
|
|
324
|
+
export type RegisteredExporterExpectation = NamedRegistrationExpectation<"exporter",string,{
|
|
325
325
|
/** Value that configures or reports extension name for this contract. */
|
|
326
|
-
extensionName?:
|
|
326
|
+
extensionName?:string;
|
|
327
327
|
}>;
|
|
328
328
|
/** Documents the registered item field expectation payload exchanged by command, SDK, and package integrations. */
|
|
329
|
-
export type RegisteredItemFieldExpectation = NamedRegistrationExpectation<"field",
|
|
329
|
+
export type RegisteredItemFieldExpectation = NamedRegistrationExpectation<"field",string,{
|
|
330
330
|
/** Value that configures or reports extension name for this contract. */
|
|
331
|
-
extensionName?:
|
|
331
|
+
extensionName?:string;
|
|
332
332
|
/** Schema type that determines the shape and validation rules for this value. */
|
|
333
|
-
type?:
|
|
333
|
+
type?:SchemaFieldDefinition["type"];
|
|
334
334
|
}>;
|
|
335
335
|
/** Documents the registered item field assertion payload exchanged by command, SDK, and package integrations. */
|
|
336
336
|
export interface RegisteredItemFieldAssertion {
|
|
337
337
|
/** Value that configures or reports registration for this contract. */
|
|
338
|
-
registration:
|
|
338
|
+
registration:RegisteredExtensionSchemaFieldDefinitions;
|
|
339
339
|
/** Value that configures or reports field for this contract. */
|
|
340
|
-
field:
|
|
340
|
+
field:SchemaFieldDefinition;
|
|
341
341
|
}
|
|
342
342
|
/** Documents the registered item type expectation payload exchanged by command, SDK, and package integrations. */
|
|
343
|
-
export type RegisteredItemTypeExpectation = NamedRegistrationExpectation<"itemType",
|
|
343
|
+
export type RegisteredItemTypeExpectation = NamedRegistrationExpectation<"itemType",string,{
|
|
344
344
|
/** Value that configures or reports extension name for this contract. */
|
|
345
|
-
extensionName?:
|
|
345
|
+
extensionName?:string;
|
|
346
346
|
/** Value that configures or reports folder for this contract. */
|
|
347
|
-
folder?:
|
|
347
|
+
folder?:string;
|
|
348
348
|
}>;
|
|
349
349
|
/** Documents the registered item type assertion payload exchanged by command, SDK, and package integrations. */
|
|
350
350
|
export interface RegisteredItemTypeAssertion {
|
|
351
351
|
/** Value that configures or reports registration for this contract. */
|
|
352
|
-
registration:
|
|
352
|
+
registration:RegisteredExtensionSchemaItemTypeDefinitions;
|
|
353
353
|
/** Schema type that determines the shape and validation rules for this value. */
|
|
354
|
-
itemType:
|
|
354
|
+
itemType:SchemaItemTypeDefinition;
|
|
355
355
|
}
|
|
356
356
|
/** Documents the registered command override expectation payload exchanged by command, SDK, and package integrations. */
|
|
357
|
-
export type RegisteredCommandOverrideExpectation = NamedRegistrationExpectation<"command",
|
|
357
|
+
export type RegisteredCommandOverrideExpectation = NamedRegistrationExpectation<"command",string,{
|
|
358
358
|
/** Value that configures or reports extension name for this contract. */
|
|
359
|
-
extensionName?:
|
|
359
|
+
extensionName?:string;
|
|
360
360
|
}>;
|
|
361
361
|
/** Documents the registered parser override expectation payload exchanged by command, SDK, and package integrations. */
|
|
362
|
-
export type RegisteredParserOverrideExpectation = NamedRegistrationExpectation<"command",
|
|
362
|
+
export type RegisteredParserOverrideExpectation = NamedRegistrationExpectation<"command",string,{
|
|
363
363
|
/** Value that configures or reports extension name for this contract. */
|
|
364
|
-
extensionName?:
|
|
364
|
+
extensionName?:string;
|
|
365
365
|
}>;
|
|
366
366
|
/** Documents the registered preflight override expectation payload exchanged by command, SDK, and package integrations. */
|
|
367
367
|
export interface RegisteredPreflightOverrideExpectation {
|
|
368
368
|
/** Value that configures or reports extension name for this contract. */
|
|
369
|
-
extensionName?:
|
|
369
|
+
extensionName?:string;
|
|
370
370
|
}
|
|
371
371
|
/** Documents the registered renderer override expectation payload exchanged by command, SDK, and package integrations. */
|
|
372
|
-
export type RegisteredRendererOverrideExpectation = NamedRegistrationExpectation<"format",
|
|
372
|
+
export type RegisteredRendererOverrideExpectation = NamedRegistrationExpectation<"format",OutputRendererFormat,{
|
|
373
373
|
/** Value that configures or reports extension name for this contract. */
|
|
374
|
-
extensionName?:
|
|
374
|
+
extensionName?:string;
|
|
375
375
|
}>;
|
|
376
376
|
/** Documents the registered service override expectation payload exchanged by command, SDK, and package integrations. */
|
|
377
|
-
export type RegisteredServiceOverrideExpectation = NamedRegistrationExpectation<"service",
|
|
377
|
+
export type RegisteredServiceOverrideExpectation = NamedRegistrationExpectation<"service",ExtensionServiceName,{
|
|
378
378
|
/** Value that configures or reports extension name for this contract. */
|
|
379
|
-
extensionName?:
|
|
379
|
+
extensionName?:string;
|
|
380
380
|
}>;
|
|
381
381
|
/** Documents the registered migration expectation payload exchanged by command, SDK, and package integrations. */
|
|
382
|
-
export type RegisteredMigrationExpectation = NamedRegistrationExpectation<"migration",
|
|
382
|
+
export type RegisteredMigrationExpectation = NamedRegistrationExpectation<"migration",string,{
|
|
383
383
|
/** Value that configures or reports extension name for this contract. */
|
|
384
|
-
extensionName?:
|
|
384
|
+
extensionName?:string;
|
|
385
385
|
/** Value that configures or reports mandatory for this contract. */
|
|
386
|
-
mandatory?:
|
|
386
|
+
mandatory?:boolean;
|
|
387
387
|
}>;
|
|
388
388
|
/** Documents the registered project-profile expectation payload exchanged by command, SDK, and package integrations. */
|
|
389
|
-
export type RegisteredProfileExpectation = NamedRegistrationExpectation<"profile",
|
|
389
|
+
export type RegisteredProfileExpectation = NamedRegistrationExpectation<"profile",string,{
|
|
390
390
|
/** Restrict the match to a single extension when several are active. */
|
|
391
|
-
extensionName?:
|
|
391
|
+
extensionName?:string;
|
|
392
392
|
}>;
|
|
393
393
|
/** Documents the registered project-profile assertion payload exchanged by command, SDK, and package integrations. */
|
|
394
394
|
export interface RegisteredProfileAssertion {
|
|
395
395
|
/** The matching registration entry. */
|
|
396
|
-
registration:
|
|
396
|
+
registration:RegisteredExtensionProjectProfile;
|
|
397
397
|
/** The registered profile definition. */
|
|
398
|
-
profile:
|
|
398
|
+
profile:ProjectProfileDefinition;
|
|
399
399
|
}
|
|
400
400
|
/** Documents the extension capability usage expectation payload exchanged by command, SDK, and package integrations. */
|
|
401
401
|
export interface ExtensionCapabilityUsageExpectation {
|
|
402
402
|
/** Capabilities the manifest declares. Mirror `manifest.capabilities` here so the assertion fails when the manifest grants more than the code uses. */
|
|
403
|
-
declared:
|
|
403
|
+
declared:readonly ExtensionCapability[];
|
|
404
404
|
/** Restrict reconciliation to a single extension when the activation has several. */
|
|
405
|
-
extensionName?:
|
|
405
|
+
extensionName?:string;
|
|
406
406
|
/** Capabilities allowed to be declared without being exercised (e.g. ones a runtime registers only behind a config flag). These are excluded from the least-privilege failure. */
|
|
407
|
-
allowUnused?:
|
|
407
|
+
allowUnused?:readonly ExtensionCapability[];
|
|
408
408
|
}
|
|
409
409
|
/** Documents the extension capability usage assertion payload exchanged by command, SDK, and package integrations. */
|
|
410
410
|
export interface ExtensionCapabilityUsageAssertion {
|
|
411
411
|
/** Declared capabilities considered, sorted and de-duplicated. */
|
|
412
|
-
declared:
|
|
412
|
+
declared:ExtensionCapability[];
|
|
413
413
|
/** Capabilities the extension actually registered against, sorted. */
|
|
414
|
-
used:
|
|
414
|
+
used:ExtensionCapability[];
|
|
415
415
|
/** Declared capabilities with no matching registration after the allowlist. */
|
|
416
|
-
unused:
|
|
416
|
+
unused:ExtensionCapability[];
|
|
417
417
|
}
|
|
418
418
|
/** Restricts package manifest resource expectation values accepted by command, SDK, and storage contracts. */
|
|
419
|
-
export type PackageManifestResourceExpectation = Partial<Record<PmPackageResourceKind,
|
|
419
|
+
export type PackageManifestResourceExpectation = Partial<Record<PmPackageResourceKind,readonly string[]>>;
|
|
420
420
|
/** Documents the package manifest expectation payload exchanged by command, SDK, and package integrations. */
|
|
421
421
|
export interface PackageManifestExpectation {
|
|
422
422
|
/** Value that configures or reports package name for this contract. */
|
|
423
|
-
packageName?:
|
|
423
|
+
packageName?:string;
|
|
424
424
|
/** Value that configures or reports aliases for this contract. */
|
|
425
|
-
aliases?:
|
|
425
|
+
aliases?:readonly string[];
|
|
426
426
|
/** Value that configures or reports resources for this contract. */
|
|
427
|
-
resources?:
|
|
427
|
+
resources?:PackageManifestResourceExpectation;
|
|
428
428
|
}
|
|
429
429
|
/**
|
|
430
430
|
* Options for {@link ExtensionTestHarness.renderMarkdown}.
|
|
@@ -434,7 +434,7 @@ export interface RenderExtensionHarnessMarkdownOptions extends ExtensionSurfaceM
|
|
|
434
434
|
* Restrict the rendered summary to one activated extension by name. Defaults
|
|
435
435
|
* to the full activation union, matching {@link ExtensionTestHarness.activationSummary}.
|
|
436
436
|
*/
|
|
437
|
-
extensionName?:
|
|
437
|
+
extensionName?:string;
|
|
438
438
|
}
|
|
439
439
|
/**
|
|
440
440
|
* Activate one in-memory extension module for package tests.
|
|
@@ -442,7 +442,7 @@ extensionName?: string;
|
|
|
442
442
|
* This uses pm's real registration validation and activation engine while
|
|
443
443
|
* avoiding private loader imports, filesystem manifests, or workspace setup.
|
|
444
444
|
*/
|
|
445
|
-
export declare function activateExtensionForTest(module:
|
|
445
|
+
export declare function activateExtensionForTest(module:unknown,options?:ActivateExtensionForTestOptions):Promise<ExtensionActivationResult>;
|
|
446
446
|
/**
|
|
447
447
|
* Deactivate one in-memory extension module for package tests — the teardown
|
|
448
448
|
* counterpart to {@link activateExtensionForTest}.
|
|
@@ -454,7 +454,7 @@ export declare function activateExtensionForTest(module: unknown, options?: Acti
|
|
|
454
454
|
* workspace. Resolve `name`/`layer` the same way {@link activateExtensionForTest}
|
|
455
455
|
* does so a forwarded `activation` result skips a failed extension correctly.
|
|
456
456
|
*/
|
|
457
|
-
export declare function deactivateExtensionForTest(module:
|
|
457
|
+
export declare function deactivateExtensionForTest(module:unknown,options?:DeactivateExtensionForTestOptions):Promise<ExtensionDeactivationResult>;
|
|
458
458
|
/**
|
|
459
459
|
* Invoke a registered extension command handler and return its real
|
|
460
460
|
* {@link CommandHandlerResult} so package tests can assert on behavior — not
|
|
@@ -480,9 +480,9 @@ export declare function deactivateExtensionForTest(module: unknown, options?: De
|
|
|
480
480
|
* asserted. A handler that throws an error carrying a numeric `exitCode`
|
|
481
481
|
* propagates the throw, matching runtime semantics.
|
|
482
482
|
*/
|
|
483
|
-
export declare function runRegisteredCommandForTest(commands:
|
|
483
|
+
export declare function runRegisteredCommandForTest(commands:ExtensionCommandRegistry,options:RunRegisteredCommandForTestOptions):Promise<CommandHandlerResult>;
|
|
484
484
|
/** Invoke registered transactional mutation guards through the same fail-closed runtime used by real writes. */
|
|
485
|
-
export declare function runRegisteredMutationGuardForTest(hooks:
|
|
485
|
+
export declare function runRegisteredMutationGuardForTest(hooks:ExtensionHookRegistry,options:RunRegisteredMutationGuardForTestOptions):Promise<void>;
|
|
486
486
|
/**
|
|
487
487
|
* Fire every registered lifecycle hook of a given `kind` through pm's real hook
|
|
488
488
|
* runner and return the warnings array so package tests can assert on behavior —
|
|
@@ -502,7 +502,7 @@ export declare function runRegisteredMutationGuardForTest(hooks: ExtensionHookRe
|
|
|
502
502
|
* when no hook of `kind` is registered, since firing a hook the extension never
|
|
503
503
|
* registered is a wiring/typo bug in the test rather than a behavior under test.
|
|
504
504
|
*/
|
|
505
|
-
export declare function runRegisteredHookForTest(hooks:
|
|
505
|
+
export declare function runRegisteredHookForTest(hooks:ExtensionHookRegistry,options:RunRegisteredHookForTestOptions):Promise<string[]>;
|
|
506
506
|
/**
|
|
507
507
|
* Invoke a registered parser override through pm's real runner and return the
|
|
508
508
|
* resolved {@link ParserOverrideResult}, so package tests can assert the rewritten
|
|
@@ -515,7 +515,7 @@ export declare function runRegisteredHookForTest(hooks: ExtensionHookRegistry, o
|
|
|
515
515
|
* context on success, or `overridden: false` with an
|
|
516
516
|
* `extension_parser_override_failed:*` warning when the override throws.
|
|
517
517
|
*/
|
|
518
|
-
export declare function runRegisteredParserOverrideForTest(parsers:
|
|
518
|
+
export declare function runRegisteredParserOverrideForTest(parsers:ExtensionParserRegistry,context:ParserOverrideContext):Promise<ParserOverrideResult>;
|
|
519
519
|
/**
|
|
520
520
|
* Invoke the active preflight override through pm's real runner and return the
|
|
521
521
|
* resolved {@link PreflightOverrideResult}, so package tests can assert the
|
|
@@ -528,7 +528,7 @@ export declare function runRegisteredParserOverrideForTest(parsers: ExtensionPar
|
|
|
528
528
|
* or `overridden: false` with an `extension_preflight_override_failed:*` warning
|
|
529
529
|
* when the override throws.
|
|
530
530
|
*/
|
|
531
|
-
export declare function runRegisteredPreflightOverrideForTest(preflight:
|
|
531
|
+
export declare function runRegisteredPreflightOverrideForTest(preflight:ExtensionPreflightRegistry,context:PreflightOverrideContext):Promise<PreflightOverrideResult>;
|
|
532
532
|
/**
|
|
533
533
|
* Invoke a registered command-result override through pm's real runner and return
|
|
534
534
|
* the resolved {@link CommandOverrideResult}, so package tests can assert how an
|
|
@@ -543,7 +543,7 @@ export declare function runRegisteredPreflightOverrideForTest(preflight: Extensi
|
|
|
543
543
|
* runtime emits when an override returns a Promise (command overrides are
|
|
544
544
|
* synchronous), or an `extension_command_override_failed:*` warning on throw.
|
|
545
545
|
*/
|
|
546
|
-
export declare function runRegisteredCommandOverrideForTest(commands:
|
|
546
|
+
export declare function runRegisteredCommandOverrideForTest(commands:ExtensionCommandRegistry,context:CommandOverrideContext):Promise<CommandOverrideResult>;
|
|
547
547
|
/**
|
|
548
548
|
* Invoke a registered renderer override through pm's real runner and return the
|
|
549
549
|
* resolved {@link RendererOverrideResult}, so package tests can assert the custom
|
|
@@ -556,7 +556,7 @@ export declare function runRegisteredCommandOverrideForTest(commands: ExtensionC
|
|
|
556
556
|
* `extension_renderer_invalid_result:*` / `extension_renderer_failed:*` warning
|
|
557
557
|
* where applicable) when the override returns a non-string or throws.
|
|
558
558
|
*/
|
|
559
|
-
export declare function runRegisteredRendererOverrideForTest(renderers:
|
|
559
|
+
export declare function runRegisteredRendererOverrideForTest(renderers:ExtensionRendererRegistry,context:RendererOverrideContext):Promise<RendererOverrideResult>;
|
|
560
560
|
/**
|
|
561
561
|
* Invoke a registered service override through pm's real runner and return the
|
|
562
562
|
* resolved {@link ServiceOverrideResult}, so package tests can assert how an
|
|
@@ -568,7 +568,7 @@ export declare function runRegisteredRendererOverrideForTest(renderers: Extensio
|
|
|
568
568
|
* the override's result when it claims the payload, or `handled: false` with the
|
|
569
569
|
* original payload (and any `extension_service_override_*` warnings) otherwise.
|
|
570
570
|
*/
|
|
571
|
-
export declare function runRegisteredServiceOverrideForTest(services:
|
|
571
|
+
export declare function runRegisteredServiceOverrideForTest(services:ExtensionServiceRegistry,context:ServiceOverrideContext):Promise<ServiceOverrideResult>;
|
|
572
572
|
/**
|
|
573
573
|
* Invoke an operation of a registered search provider through the same name
|
|
574
574
|
* resolution the host uses and return the operation's result, so package tests
|
|
@@ -589,11 +589,11 @@ export declare function runRegisteredServiceOverrideForTest(services: ExtensionS
|
|
|
589
589
|
* the requested operation, since invoking an absent provider/operation is a
|
|
590
590
|
* wiring bug in the test rather than a behavior under test.
|
|
591
591
|
*/
|
|
592
|
-
export declare function runRegisteredSearchProviderForTest<Operation extends keyof SearchProviderOperationContexts>(registrations:
|
|
593
|
-
provider:
|
|
594
|
-
operation:
|
|
595
|
-
context:
|
|
596
|
-
}):
|
|
592
|
+
export declare function runRegisteredSearchProviderForTest<Operation extends keyof SearchProviderOperationContexts>(registrations:ExtensionRegistrationRegistry,options:{
|
|
593
|
+
provider:string;
|
|
594
|
+
operation:Operation;
|
|
595
|
+
context:SearchProviderOperationContexts[Operation];
|
|
596
|
+
}):Promise<SearchProviderOperationResults[Operation]>;
|
|
597
597
|
/**
|
|
598
598
|
* Invoke an operation of a registered vector store adapter through the same name
|
|
599
599
|
* resolution the host uses and return the operation's result, so package tests
|
|
@@ -612,11 +612,11 @@ context: SearchProviderOperationContexts[Operation];
|
|
|
612
612
|
* registered, and a separate error when the resolved adapter does not implement
|
|
613
613
|
* the requested operation.
|
|
614
614
|
*/
|
|
615
|
-
export declare function runRegisteredVectorStoreAdapterForTest<Operation extends keyof VectorStoreAdapterOperationContexts>(registrations:
|
|
616
|
-
adapter:
|
|
617
|
-
operation:
|
|
618
|
-
context:
|
|
619
|
-
}):
|
|
615
|
+
export declare function runRegisteredVectorStoreAdapterForTest<Operation extends keyof VectorStoreAdapterOperationContexts>(registrations:ExtensionRegistrationRegistry,options:{
|
|
616
|
+
adapter:string;
|
|
617
|
+
operation:Operation;
|
|
618
|
+
context:VectorStoreAdapterOperationContexts[Operation];
|
|
619
|
+
}):Promise<VectorStoreAdapterOperationResults[Operation]>;
|
|
620
620
|
/**
|
|
621
621
|
* Invoke a registered schema migration's `run` function through the same runtime
|
|
622
622
|
* definition the host executes and return its result, so package tests can assert
|
|
@@ -637,7 +637,7 @@ context: VectorStoreAdapterOperationContexts[Operation];
|
|
|
637
637
|
* Throws when the resolved migration declares no `run` function, since invoking a
|
|
638
638
|
* runless migration is a wiring bug in the test rather than a behavior under test.
|
|
639
639
|
*/
|
|
640
|
-
export declare function runRegisteredMigrationForTest(registrations:
|
|
640
|
+
export declare function runRegisteredMigrationForTest(registrations:ExtensionRegistrationRegistry,options:RunRegisteredMigrationForTestOptions):Promise<unknown>;
|
|
641
641
|
/**
|
|
642
642
|
* Invoke a registered extension importer through pm's real handler-dispatch
|
|
643
643
|
* engine and return its {@link CommandHandlerResult}, so package tests can assert
|
|
@@ -666,7 +666,7 @@ export declare function runRegisteredMigrationForTest(registrations: ExtensionRe
|
|
|
666
666
|
* when no importer matches, since that is a wiring/typo bug in the test rather
|
|
667
667
|
* than a behavior under test.
|
|
668
668
|
*/
|
|
669
|
-
export declare function runRegisteredImporterForTest(activation:
|
|
669
|
+
export declare function runRegisteredImporterForTest(activation:ExtensionActivationResult,options:RunRegisteredImporterForTestOptions):Promise<CommandHandlerResult>;
|
|
670
670
|
/**
|
|
671
671
|
* Invoke a registered extension exporter through pm's real handler-dispatch
|
|
672
672
|
* engine and return its {@link CommandHandlerResult}, so package tests can assert
|
|
@@ -685,20 +685,20 @@ export declare function runRegisteredImporterForTest(activation: ExtensionActiva
|
|
|
685
685
|
* when no exporter matches, since that is a wiring/typo bug in the test rather
|
|
686
686
|
* than a behavior under test.
|
|
687
687
|
*/
|
|
688
|
-
export declare function runRegisteredExporterForTest(activation:
|
|
688
|
+
export declare function runRegisteredExporterForTest(activation:ExtensionActivationResult,options:RunRegisteredExporterForTestOptions):Promise<CommandHandlerResult>;
|
|
689
689
|
/**
|
|
690
690
|
* Assert that an {@link ExtensionDeactivationResult} reports the expected clean
|
|
691
691
|
* teardown counts, throwing a descriptive error otherwise. Defaults assert the
|
|
692
692
|
* single-extension happy path — exactly one extension deactivated and none
|
|
693
693
|
* failed. Returns the result so assertions can chain.
|
|
694
694
|
*/
|
|
695
|
-
export declare function assertExtensionDeactivated(result:
|
|
695
|
+
export declare function assertExtensionDeactivated(result:ExtensionDeactivationResult,expectation?:ExtensionDeactivationExpectation):ExtensionDeactivationResult;
|
|
696
696
|
/** Assert that a normalized package manifest advertises expected package resources. Pair with `readPmPackageManifest(packageRoot)` in package tests. */
|
|
697
|
-
export declare function assertPackageManifest(manifest:
|
|
697
|
+
export declare function assertPackageManifest(manifest:PmPackageManifest,expectation:PackageManifestExpectation):PmPackageManifest;
|
|
698
698
|
/** Assert that an activated extension registration registry contains a command contract with the expected public metadata. */
|
|
699
|
-
export declare function assertRegisteredCommandContract(registrations:
|
|
699
|
+
export declare function assertRegisteredCommandContract(registrations:ExtensionRegistrationRegistry,expectation:RegisteredCommandContractExpectation):RegisteredCommandContractAssertion;
|
|
700
700
|
/** Assert that an activated extension registration registry contains flags injected into an existing command through `api.registerFlags(...)`. */
|
|
701
|
-
export declare function assertRegisteredFlags(registrations:
|
|
701
|
+
export declare function assertRegisteredFlags(registrations:ExtensionRegistrationRegistry,expectation:RegisteredFlagsExpectation):RegisteredExtensionFlagDefinitions;
|
|
702
702
|
/**
|
|
703
703
|
* Assert that an activated extension hook registry contains a hook of the
|
|
704
704
|
* expected lifecycle kind (optionally scoped to a specific extension).
|
|
@@ -706,21 +706,21 @@ export declare function assertRegisteredFlags(registrations: ExtensionRegistrati
|
|
|
706
706
|
* Hooks are surfaced via `ExtensionActivationResult.hooks`, not the command
|
|
707
707
|
* registration registry, so this helper accepts an `ExtensionHookRegistry`.
|
|
708
708
|
*/
|
|
709
|
-
export declare function assertRegisteredHook<TKind extends RegisteredHookKind>(hooks:
|
|
710
|
-
kind:
|
|
711
|
-
}):
|
|
709
|
+
export declare function assertRegisteredHook<TKind extends RegisteredHookKind>(hooks:ExtensionHookRegistry,expectation:RegisteredHookExpectation & {
|
|
710
|
+
kind:TKind;
|
|
711
|
+
}):RegisteredHookEntry<TKind>;
|
|
712
712
|
/** Assert that an activated extension registration registry contains a search provider with the expected name (optionally scoped to a specific extension). */
|
|
713
|
-
export declare function assertRegisteredSearchProvider(registrations:
|
|
713
|
+
export declare function assertRegisteredSearchProvider(registrations:ExtensionRegistrationRegistry,expectation:RegisteredSearchProviderExpectation):RegisteredExtensionSearchProvider;
|
|
714
714
|
/** Assert that an activated extension registration registry contains a vector store adapter with the expected name (optionally scoped to a specific extension). */
|
|
715
|
-
export declare function assertRegisteredVectorStoreAdapter(registrations:
|
|
715
|
+
export declare function assertRegisteredVectorStoreAdapter(registrations:ExtensionRegistrationRegistry,expectation:RegisteredVectorStoreAdapterExpectation):RegisteredExtensionVectorStoreAdapter;
|
|
716
716
|
/** Assert that an activated extension registration registry contains an importer for the expected format/name (optionally scoped to a specific extension). */
|
|
717
|
-
export declare function assertRegisteredImporter(registrations:
|
|
717
|
+
export declare function assertRegisteredImporter(registrations:ExtensionRegistrationRegistry,expectation:RegisteredImporterExpectation):RegisteredExtensionImporter;
|
|
718
718
|
/** Assert that an activated extension registration registry contains an exporter for the expected format/name (optionally scoped to a specific extension). */
|
|
719
|
-
export declare function assertRegisteredExporter(registrations:
|
|
719
|
+
export declare function assertRegisteredExporter(registrations:ExtensionRegistrationRegistry,expectation:RegisteredExporterExpectation):RegisteredExtensionExporter;
|
|
720
720
|
/** Assert that an activated extension registration registry contains a custom item field definition (optionally scoped to a specific extension). */
|
|
721
|
-
export declare function assertRegisteredItemField(registrations:
|
|
721
|
+
export declare function assertRegisteredItemField(registrations:ExtensionRegistrationRegistry,expectation:RegisteredItemFieldExpectation):RegisteredItemFieldAssertion;
|
|
722
722
|
/** Assert that an activated extension registration registry contains a custom item type definition (optionally scoped to a specific extension). */
|
|
723
|
-
export declare function assertRegisteredItemType(registrations:
|
|
723
|
+
export declare function assertRegisteredItemType(registrations:ExtensionRegistrationRegistry,expectation:RegisteredItemTypeExpectation):RegisteredItemTypeAssertion;
|
|
724
724
|
/**
|
|
725
725
|
* Assert that an activated extension registration registry contains a project
|
|
726
726
|
* profile registered via `api.registerProfile(profile)` (optionally scoped to a
|
|
@@ -733,7 +733,7 @@ export declare function assertRegisteredItemType(registrations: ExtensionRegistr
|
|
|
733
733
|
* (item types, item fields), a profile is verified by presence — it is staged,
|
|
734
734
|
* not executed — so there is no `runRegisteredProfileForTest` counterpart.
|
|
735
735
|
*/
|
|
736
|
-
export declare function assertRegisteredProfile(registrations:
|
|
736
|
+
export declare function assertRegisteredProfile(registrations:ExtensionRegistrationRegistry,expectation:RegisteredProfileExpectation):RegisteredProfileAssertion;
|
|
737
737
|
/**
|
|
738
738
|
* Assert that an activated extension command registry contains a command
|
|
739
739
|
* override registered via `api.registerCommand(command, override)` (optionally
|
|
@@ -743,7 +743,7 @@ export declare function assertRegisteredProfile(registrations: ExtensionRegistra
|
|
|
743
743
|
* the command registration registry, so this helper accepts an
|
|
744
744
|
* `ExtensionCommandRegistry`.
|
|
745
745
|
*/
|
|
746
|
-
export declare function assertRegisteredCommandOverride(commands:
|
|
746
|
+
export declare function assertRegisteredCommandOverride(commands:ExtensionCommandRegistry,expectation:RegisteredCommandOverrideExpectation):RegisteredExtensionCommandOverride;
|
|
747
747
|
/**
|
|
748
748
|
* Assert that an activated extension parser registry contains a parser override
|
|
749
749
|
* registered via `api.registerParser(command, override)` (optionally scoped to
|
|
@@ -753,7 +753,7 @@ export declare function assertRegisteredCommandOverride(commands: ExtensionComma
|
|
|
753
753
|
* command registration registry, so this helper accepts an
|
|
754
754
|
* `ExtensionParserRegistry`.
|
|
755
755
|
*/
|
|
756
|
-
export declare function assertRegisteredParserOverride(parsers:
|
|
756
|
+
export declare function assertRegisteredParserOverride(parsers:ExtensionParserRegistry,expectation:RegisteredParserOverrideExpectation):RegisteredExtensionParserOverride;
|
|
757
757
|
/**
|
|
758
758
|
* Assert that an activated extension preflight registry contains a preflight
|
|
759
759
|
* override registered via `api.registerPreflight(override)` (optionally scoped
|
|
@@ -764,7 +764,7 @@ export declare function assertRegisteredParserOverride(parsers: ExtensionParserR
|
|
|
764
764
|
* `extensionName`. Preflight overrides are surfaced via
|
|
765
765
|
* `ExtensionActivationResult.preflight`.
|
|
766
766
|
*/
|
|
767
|
-
export declare function assertRegisteredPreflightOverride(preflight:
|
|
767
|
+
export declare function assertRegisteredPreflightOverride(preflight:ExtensionPreflightRegistry,expectation?:RegisteredPreflightOverrideExpectation):RegisteredExtensionPreflightOverride;
|
|
768
768
|
/**
|
|
769
769
|
* Assert that an activated extension renderer registry contains a renderer
|
|
770
770
|
* override registered via `api.registerRenderer(format, renderer)` for the
|
|
@@ -772,7 +772,7 @@ export declare function assertRegisteredPreflightOverride(preflight: ExtensionPr
|
|
|
772
772
|
*
|
|
773
773
|
* Renderer overrides are surfaced via `ExtensionActivationResult.renderers`.
|
|
774
774
|
*/
|
|
775
|
-
export declare function assertRegisteredRendererOverride(renderers:
|
|
775
|
+
export declare function assertRegisteredRendererOverride(renderers:ExtensionRendererRegistry,expectation:RegisteredRendererOverrideExpectation):RegisteredExtensionRendererOverride;
|
|
776
776
|
/**
|
|
777
777
|
* Assert that an activated extension service registry contains a service override
|
|
778
778
|
* registered via `api.registerService(service, override)` for the expected
|
|
@@ -782,7 +782,7 @@ export declare function assertRegisteredRendererOverride(renderers: ExtensionRen
|
|
|
782
782
|
* command registration registry, so this helper accepts an
|
|
783
783
|
* `ExtensionServiceRegistry`.
|
|
784
784
|
*/
|
|
785
|
-
export declare function assertRegisteredServiceOverride(services:
|
|
785
|
+
export declare function assertRegisteredServiceOverride(services:ExtensionServiceRegistry,expectation:RegisteredServiceOverrideExpectation):RegisteredExtensionServiceOverride;
|
|
786
786
|
/**
|
|
787
787
|
* Assert that an activated extension registration registry contains a schema
|
|
788
788
|
* migration registered via `api.registerMigration(definition)` with the expected
|
|
@@ -791,7 +791,7 @@ export declare function assertRegisteredServiceOverride(services: ExtensionServi
|
|
|
791
791
|
*
|
|
792
792
|
* Migrations are surfaced via `ExtensionActivationResult.registrations.migrations`.
|
|
793
793
|
*/
|
|
794
|
-
export declare function assertRegisteredMigration(registrations:
|
|
794
|
+
export declare function assertRegisteredMigration(registrations:ExtensionRegistrationRegistry,expectation:RegisteredMigrationExpectation):RegisteredExtensionSchemaMigrationDefinition;
|
|
795
795
|
/**
|
|
796
796
|
* Assert that an activated extension declares no capability it never uses
|
|
797
797
|
* (least privilege). Pass the same capabilities as `manifest.capabilities` via
|
|
@@ -803,7 +803,7 @@ export declare function assertRegisteredMigration(registrations: ExtensionRegist
|
|
|
803
803
|
* author catch an over-broad manifest at `npm test` time. Returns the
|
|
804
804
|
* declared/used/unused breakdown for further assertions.
|
|
805
805
|
*/
|
|
806
|
-
export declare function assertExtensionCapabilityUsage(activation:
|
|
806
|
+
export declare function assertExtensionCapabilityUsage(activation:ExtensionActivationResult,expectation:ExtensionCapabilityUsageExpectation):ExtensionCapabilityUsageAssertion;
|
|
807
807
|
/**
|
|
808
808
|
* Preflight a declarative {@link ExtensionBlueprint} in a test, throwing if it has
|
|
809
809
|
* any `error`-severity issue (today: capability the blueprint exercises but the
|
|
@@ -816,11 +816,11 @@ export declare function assertExtensionCapabilityUsage(activation: ExtensionActi
|
|
|
816
816
|
* success so a test can still inspect advisory warnings (unused capability,
|
|
817
817
|
* duplicate command, empty surface) without failing on them.
|
|
818
818
|
*/
|
|
819
|
-
export declare function assertExtensionBlueprint(blueprint:
|
|
819
|
+
export declare function assertExtensionBlueprint(blueprint:ExtensionBlueprint,options?:LintExtensionBlueprintOptions):ExtensionBlueprintLintResult;
|
|
820
820
|
/** Options for {@link assertProjectProfile}. */
|
|
821
821
|
export interface AssertProjectProfileOptions {
|
|
822
822
|
/** Also throw when the profile produces `warning`-severity findings (e.g. a workflow transition referencing a status no profile or built-in defines). Off by default so warnings stay advisory; turn on for strict CI gates. */
|
|
823
|
-
strict?:
|
|
823
|
+
strict?:boolean;
|
|
824
824
|
}
|
|
825
825
|
/**
|
|
826
826
|
* Assert a {@link ProjectProfileDefinition} is internally consistent in a test,
|
|
@@ -833,7 +833,7 @@ strict?: boolean;
|
|
|
833
833
|
* returned on success so a test can still inspect advisory warnings without
|
|
834
834
|
* failing on them.
|
|
835
835
|
*/
|
|
836
|
-
export declare function assertProjectProfile(profile:
|
|
836
|
+
export declare function assertProjectProfile(profile:ProjectProfileDefinition,options?:AssertProjectProfileOptions):ProjectProfileLintReport;
|
|
837
837
|
/**
|
|
838
838
|
* The structured result of {@link assertExtensionManifestMatchesBlueprint}: the
|
|
839
839
|
* reconciliation between a manifest's declared capabilities and the set the
|
|
@@ -842,15 +842,15 @@ export declare function assertProjectProfile(profile: ProjectProfileDefinition,
|
|
|
842
842
|
*/
|
|
843
843
|
export interface ExtensionManifestBlueprintMatch {
|
|
844
844
|
/** The least-privilege capability set the blueprint exercises (from `deriveExtensionCapabilities`). */
|
|
845
|
-
used:
|
|
845
|
+
used:ExtensionCapability[];
|
|
846
846
|
/** The manifest's declared capabilities, legacy-alias resolved and normalized. */
|
|
847
|
-
declared:
|
|
847
|
+
declared:ExtensionCapability[];
|
|
848
848
|
/** Capabilities the blueprint uses but the manifest omits — would crash activation. Empty on success. */
|
|
849
|
-
missing:
|
|
849
|
+
missing:ExtensionCapability[];
|
|
850
850
|
/** Capabilities the manifest declares but no surface exercises — violates least privilege. Empty on success. */
|
|
851
|
-
unused:
|
|
851
|
+
unused:ExtensionCapability[];
|
|
852
852
|
/** Every lint finding for the blueprint, so callers can inspect advisory warnings. */
|
|
853
|
-
findings:
|
|
853
|
+
findings:ExtensionBlueprintLintFinding[];
|
|
854
854
|
}
|
|
855
855
|
/**
|
|
856
856
|
* Strictly assert a manifest's `capabilities` equal the least-privilege set a
|
|
@@ -871,7 +871,7 @@ findings: ExtensionBlueprintLintFinding[];
|
|
|
871
871
|
* The reconciliation is returned on success so a test can still inspect advisory
|
|
872
872
|
* warnings (duplicate command, empty surface) without failing on them.
|
|
873
873
|
*/
|
|
874
|
-
export declare function assertExtensionManifestMatchesBlueprint(manifest:
|
|
874
|
+
export declare function assertExtensionManifestMatchesBlueprint(manifest:Pick<ExtensionManifest,"capabilities">,blueprint:ExtensionBlueprint):ExtensionManifestBlueprintMatch;
|
|
875
875
|
/**
|
|
876
876
|
* Assert an extension manifest's declared version bounds permit it to load on a
|
|
877
877
|
* target pm CLI version, throwing when a bound blocks the load.
|
|
@@ -888,7 +888,7 @@ export declare function assertExtensionManifestMatchesBlueprint(manifest: Pick<E
|
|
|
888
888
|
* a user's install. The full compatibility result is returned on success so a test
|
|
889
889
|
* can still inspect advisory warnings.
|
|
890
890
|
*/
|
|
891
|
-
export declare function assertExtensionManifestCompatible(manifest:
|
|
891
|
+
export declare function assertExtensionManifestCompatible(manifest:ExtensionManifestCompatibilityManifest,target:ExtensionManifestCompatibilityTarget):ExtensionManifestCompatibilityResult;
|
|
892
892
|
/**
|
|
893
893
|
* Preflight a declarative {@link ExtensionBlueprint} through every author-time
|
|
894
894
|
* check in one test, throwing if any stage produced an `error`-severity finding.
|
|
@@ -906,7 +906,7 @@ export declare function assertExtensionManifestCompatible(manifest: ExtensionMan
|
|
|
906
906
|
* returned on success so a test can still inspect those warnings, the synthesized
|
|
907
907
|
* manifest, and the derived capability set without failing on them.
|
|
908
908
|
*/
|
|
909
|
-
export declare function assertExtensionPreflight(blueprint:
|
|
909
|
+
export declare function assertExtensionPreflight(blueprint:ExtensionBlueprint,options?:PreflightExtensionOptions):ExtensionPreflightReport;
|
|
910
910
|
/**
|
|
911
911
|
* A fluent, single-extension test fixture returned by
|
|
912
912
|
* {@link createExtensionTestHarness}.
|
|
@@ -927,99 +927,99 @@ export declare function assertExtensionPreflight(blueprint: ExtensionBlueprint,
|
|
|
927
927
|
*/
|
|
928
928
|
export interface ExtensionTestHarness {
|
|
929
929
|
/** The in-memory extension module supplied to {@link createExtensionTestHarness}. */
|
|
930
|
-
readonly module:
|
|
930
|
+
readonly module:unknown;
|
|
931
931
|
/** Resolved extension name (manifest name, explicit override, or `"test-extension"`). */
|
|
932
|
-
readonly name:
|
|
932
|
+
readonly name:string;
|
|
933
933
|
/** Layer recorded for the in-memory extension (defaults to `"project"`). */
|
|
934
|
-
readonly layer:
|
|
934
|
+
readonly layer:ExtensionLayer;
|
|
935
935
|
/** The underlying activation result; use it to reach standalone helpers directly. */
|
|
936
|
-
readonly activation:
|
|
936
|
+
readonly activation:ExtensionActivationResult;
|
|
937
937
|
/** Bound {@link describeExtensionActivation} over the whole `activation`. */
|
|
938
|
-
activationSummary(options?:
|
|
938
|
+
activationSummary(options?:DescribeExtensionActivationOptions):ExtensionActivationSummary;
|
|
939
939
|
/**
|
|
940
940
|
* Bound {@link renderExtensionSurfaceMarkdown} over {@link activationSummary},
|
|
941
941
|
* so tests and README generators can produce deterministic surface docs from
|
|
942
942
|
* the same harness they use for assert/run coverage.
|
|
943
943
|
*/
|
|
944
|
-
renderMarkdown(options?:
|
|
944
|
+
renderMarkdown(options?:RenderExtensionHarnessMarkdownOptions):string;
|
|
945
945
|
/** Bound {@link assertRegisteredCommandContract} over `activation.registrations`. */
|
|
946
|
-
assertCommandContract(expectation:
|
|
946
|
+
assertCommandContract(expectation:RegisteredCommandContractExpectation):RegisteredCommandContractAssertion;
|
|
947
947
|
/** Bound {@link assertRegisteredFlags} over `activation.registrations`. */
|
|
948
|
-
assertFlags(expectation:
|
|
948
|
+
assertFlags(expectation:RegisteredFlagsExpectation):RegisteredExtensionFlagDefinitions;
|
|
949
949
|
/** Bound {@link assertRegisteredItemField} over `activation.registrations`. */
|
|
950
|
-
assertItemField(expectation:
|
|
950
|
+
assertItemField(expectation:RegisteredItemFieldExpectation):RegisteredItemFieldAssertion;
|
|
951
951
|
/** Bound {@link assertRegisteredItemType} over `activation.registrations`. */
|
|
952
|
-
assertItemType(expectation:
|
|
952
|
+
assertItemType(expectation:RegisteredItemTypeExpectation):RegisteredItemTypeAssertion;
|
|
953
953
|
/** Bound {@link assertRegisteredProfile} over `activation.registrations`. */
|
|
954
|
-
assertProfile(expectation:
|
|
954
|
+
assertProfile(expectation:RegisteredProfileExpectation):RegisteredProfileAssertion;
|
|
955
955
|
/** Bound {@link assertRegisteredHook} over `activation.hooks`. */
|
|
956
|
-
assertHook<TKind extends RegisteredHookKind>(expectation:
|
|
957
|
-
kind:
|
|
958
|
-
}):
|
|
956
|
+
assertHook<TKind extends RegisteredHookKind>(expectation:RegisteredHookExpectation & {
|
|
957
|
+
kind:TKind;
|
|
958
|
+
}):RegisteredHookEntry<TKind>;
|
|
959
959
|
/** Bound {@link assertRegisteredCommandOverride} over `activation.commands`. */
|
|
960
|
-
assertCommandOverride(expectation:
|
|
960
|
+
assertCommandOverride(expectation:RegisteredCommandOverrideExpectation):RegisteredExtensionCommandOverride;
|
|
961
961
|
/** Bound {@link assertRegisteredParserOverride} over `activation.parsers`. */
|
|
962
|
-
assertParserOverride(expectation:
|
|
962
|
+
assertParserOverride(expectation:RegisteredParserOverrideExpectation):RegisteredExtensionParserOverride;
|
|
963
963
|
/** Bound {@link assertRegisteredPreflightOverride} over `activation.preflight`. */
|
|
964
|
-
assertPreflightOverride(expectation?:
|
|
964
|
+
assertPreflightOverride(expectation?:RegisteredPreflightOverrideExpectation):RegisteredExtensionPreflightOverride;
|
|
965
965
|
/** Bound {@link assertRegisteredRendererOverride} over `activation.renderers`. */
|
|
966
|
-
assertRendererOverride(expectation:
|
|
966
|
+
assertRendererOverride(expectation:RegisteredRendererOverrideExpectation):RegisteredExtensionRendererOverride;
|
|
967
967
|
/** Bound {@link assertRegisteredServiceOverride} over `activation.services`. */
|
|
968
|
-
assertServiceOverride(expectation:
|
|
968
|
+
assertServiceOverride(expectation:RegisteredServiceOverrideExpectation):RegisteredExtensionServiceOverride;
|
|
969
969
|
/** Bound {@link assertRegisteredSearchProvider} over `activation.registrations`. */
|
|
970
|
-
assertSearchProvider(expectation:
|
|
970
|
+
assertSearchProvider(expectation:RegisteredSearchProviderExpectation):RegisteredExtensionSearchProvider;
|
|
971
971
|
/** Bound {@link assertRegisteredVectorStoreAdapter} over `activation.registrations`. */
|
|
972
|
-
assertVectorStoreAdapter(expectation:
|
|
972
|
+
assertVectorStoreAdapter(expectation:RegisteredVectorStoreAdapterExpectation):RegisteredExtensionVectorStoreAdapter;
|
|
973
973
|
/** Bound {@link assertRegisteredImporter} over `activation.registrations`. */
|
|
974
|
-
assertImporter(expectation:
|
|
974
|
+
assertImporter(expectation:RegisteredImporterExpectation):RegisteredExtensionImporter;
|
|
975
975
|
/** Bound {@link assertRegisteredExporter} over `activation.registrations`. */
|
|
976
|
-
assertExporter(expectation:
|
|
976
|
+
assertExporter(expectation:RegisteredExporterExpectation):RegisteredExtensionExporter;
|
|
977
977
|
/** Bound {@link assertRegisteredMigration} over `activation.registrations`. */
|
|
978
|
-
assertMigration(expectation:
|
|
978
|
+
assertMigration(expectation:RegisteredMigrationExpectation):RegisteredExtensionSchemaMigrationDefinition;
|
|
979
979
|
/** Bound {@link assertExtensionCapabilityUsage} over the whole `activation`. */
|
|
980
|
-
assertCapabilityUsage(expectation:
|
|
980
|
+
assertCapabilityUsage(expectation:ExtensionCapabilityUsageExpectation):ExtensionCapabilityUsageAssertion;
|
|
981
981
|
/** Bound {@link runRegisteredCommandForTest} over `activation.commands`. */
|
|
982
|
-
runCommand(options:
|
|
982
|
+
runCommand(options:RunRegisteredCommandForTestOptions):Promise<CommandHandlerResult>;
|
|
983
983
|
/** Bound {@link runRegisteredHookForTest} over `activation.hooks`. */
|
|
984
|
-
runHook(options:
|
|
984
|
+
runHook(options:RunRegisteredHookForTestOptions):Promise<string[]>;
|
|
985
985
|
/** Bound transactional mutation-guard runner over `activation.hooks`. */
|
|
986
|
-
runMutationGuard(options:
|
|
986
|
+
runMutationGuard(options:RunRegisteredMutationGuardForTestOptions):Promise<void>;
|
|
987
987
|
/** Bound {@link runRegisteredCommandOverrideForTest} over `activation.commands`. */
|
|
988
|
-
runCommandOverride(context:
|
|
988
|
+
runCommandOverride(context:CommandOverrideContext):Promise<CommandOverrideResult>;
|
|
989
989
|
/** Bound {@link runRegisteredParserOverrideForTest} over `activation.parsers`. */
|
|
990
|
-
runParserOverride(context:
|
|
990
|
+
runParserOverride(context:ParserOverrideContext):Promise<ParserOverrideResult>;
|
|
991
991
|
/** Bound {@link runRegisteredPreflightOverrideForTest} over `activation.preflight`. */
|
|
992
|
-
runPreflightOverride(context:
|
|
992
|
+
runPreflightOverride(context:PreflightOverrideContext):Promise<PreflightOverrideResult>;
|
|
993
993
|
/** Bound {@link runRegisteredRendererOverrideForTest} over `activation.renderers`. */
|
|
994
|
-
runRendererOverride(context:
|
|
994
|
+
runRendererOverride(context:RendererOverrideContext):Promise<RendererOverrideResult>;
|
|
995
995
|
/** Bound {@link runRegisteredServiceOverrideForTest} over `activation.services`. */
|
|
996
|
-
runServiceOverride(context:
|
|
996
|
+
runServiceOverride(context:ServiceOverrideContext):Promise<ServiceOverrideResult>;
|
|
997
997
|
/** Bound {@link runRegisteredSearchProviderForTest} over `activation.registrations`. */
|
|
998
|
-
runSearchProvider<Operation extends keyof SearchProviderOperationContexts>(options:
|
|
999
|
-
provider:
|
|
1000
|
-
operation:
|
|
1001
|
-
context:
|
|
1002
|
-
}):
|
|
998
|
+
runSearchProvider<Operation extends keyof SearchProviderOperationContexts>(options:{
|
|
999
|
+
provider:string;
|
|
1000
|
+
operation:Operation;
|
|
1001
|
+
context:SearchProviderOperationContexts[Operation];
|
|
1002
|
+
}):Promise<SearchProviderOperationResults[Operation]>;
|
|
1003
1003
|
/** Bound {@link runRegisteredVectorStoreAdapterForTest} over `activation.registrations`. */
|
|
1004
|
-
runVectorStoreAdapter<Operation extends keyof VectorStoreAdapterOperationContexts>(options:
|
|
1005
|
-
adapter:
|
|
1006
|
-
operation:
|
|
1007
|
-
context:
|
|
1008
|
-
}):
|
|
1004
|
+
runVectorStoreAdapter<Operation extends keyof VectorStoreAdapterOperationContexts>(options:{
|
|
1005
|
+
adapter:string;
|
|
1006
|
+
operation:Operation;
|
|
1007
|
+
context:VectorStoreAdapterOperationContexts[Operation];
|
|
1008
|
+
}):Promise<VectorStoreAdapterOperationResults[Operation]>;
|
|
1009
1009
|
/** Bound {@link runRegisteredMigrationForTest} over `activation.registrations`. */
|
|
1010
|
-
runMigration(options:
|
|
1010
|
+
runMigration(options:RunRegisteredMigrationForTestOptions):Promise<unknown>;
|
|
1011
1011
|
/** Bound {@link runRegisteredImporterForTest} over the whole `activation`. */
|
|
1012
|
-
runImporter(options:
|
|
1012
|
+
runImporter(options:RunRegisteredImporterForTestOptions):Promise<CommandHandlerResult>;
|
|
1013
1013
|
/** Bound {@link runRegisteredExporterForTest} over the whole `activation`. */
|
|
1014
|
-
runExporter(options:
|
|
1014
|
+
runExporter(options:RunRegisteredExporterForTestOptions):Promise<CommandHandlerResult>;
|
|
1015
1015
|
/**
|
|
1016
1016
|
* Bound {@link deactivateExtensionForTest} — runs the real teardown engine for
|
|
1017
1017
|
* this harness's module, forwarding its resolved `name`/`layer`/`activation` so
|
|
1018
1018
|
* the skip-key matches and a never-initialized extension is not deactivated.
|
|
1019
1019
|
*/
|
|
1020
|
-
deactivate(options?:
|
|
1021
|
-
deactivateTimeoutMs?:
|
|
1022
|
-
}):
|
|
1020
|
+
deactivate(options?:{
|
|
1021
|
+
deactivateTimeoutMs?:number;
|
|
1022
|
+
}):Promise<ExtensionDeactivationResult>;
|
|
1023
1023
|
}
|
|
1024
1024
|
/**
|
|
1025
1025
|
* Activate one in-memory extension module and return a fluent
|
|
@@ -1047,4 +1047,4 @@ deactivateTimeoutMs?: number;
|
|
|
1047
1047
|
* deliberately exercise a *failed* activation should call
|
|
1048
1048
|
* {@link activateExtensionForTest} directly and inspect `activation.failed`.
|
|
1049
1049
|
*/
|
|
1050
|
-
export declare function createExtensionTestHarness(module:
|
|
1050
|
+
export declare function createExtensionTestHarness(module:unknown,options?:ActivateExtensionForTestOptions):Promise<ExtensionTestHarness>;
|