@unbrained/pm-cli 2026.10.14 → 2026.10.17
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/skills/pm-developer/references/COMMAND_PLAYBOOK.md +1 -1
- package/.claude-plugin/marketplace.json +1 -1
- package/AGENTS.md +1 -0
- package/CHANGELOG.md +74 -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 +18 -16
- package/dist/cli/extension-command-options.js +1 -1
- package/dist/cli/extension-recovery.d.ts +13 -13
- package/dist/cli/help-content.d.ts +22 -22
- package/dist/cli/help-content.js +3 -3
- 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-mutation.js +2 -2
- package/dist/cli/register-operations.d.ts +75 -75
- package/dist/cli/register-operations.js +1 -1
- package/dist/cli/register-setup.d.ts +4 -4
- package/dist/cli/register-structured-mutation.d.ts +8 -13
- package/dist/cli/register-structured-mutation.js +1 -1
- package/dist/cli/runtime/activation.d.ts +23 -23
- package/dist/cli/runtime/invocation-options.d.ts +12 -12
- package/dist/cli/runtime/invocation-options.js +1 -1
- 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-LKESCZEN.js → chunk-3QKI3XNX.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-4PNPDT2N.js +236 -0
- package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-6ZDKKOKM.js} +28 -28
- package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-B5QVGCZX.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-5LU6PWA4.js → chunk-EA2CG7UM.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-HY7FQ7QX.js +2 -0
- package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-J4LPQCET.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-JS3B2M4D.js +6 -0
- package/dist/cli-bundle/chunks/chunk-O4YBC3OM.js +30 -0
- package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-OZCSXX4D.js} +63 -64
- package/dist/cli-bundle/chunks/chunk-VMCSTFSO.js +2 -0
- package/dist/cli-bundle/chunks/chunk-W3KZ22DW.js +2 -0
- package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-X2ONXFBP.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-X53HM753.js +20 -0
- package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-RU3QZSAQ.js} +7 -7
- package/dist/cli-bundle/chunks/register-mutation-EQYMT32A.js +20 -0
- package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-VXBGE4XI.js} +2 -2
- package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-UUDEGFRO.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-2IOHHNRT.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-5JEFDEL3.js +166 -0
- package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-AH6NX6GM.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-E33QA7PK.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-FTUZ3JF2.js} +6 -6
- package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-JXR6UKFM.js} +3 -3
- package/dist/cli-bundle/focused-chunks/chunk-LDKX4KYJ.js +2 -0
- package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-MBQF6HT6.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-NZO7GOXD.js +20 -0
- package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-PYC7BF6Z.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-QOSVJDOO.js} +61 -62
- package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-RBLSY6ML.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-RHTH5ILM.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-SIGIGZCG.js} +3 -3
- package/dist/cli-bundle/focused-chunks/chunk-TRFVAWF2.js +26 -0
- package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-UNTQE37U.js} +2 -2
- package/dist/cli-bundle/main.js +22 -22
- package/dist/cli-bundle/sdk-authoring.js +1 -1
- package/dist/cli-bundle/sdk-contracts.js +2 -2
- package/dist/cli-bundle/sdk-core.js +23 -23
- package/dist/cli-bundle/sdk-governance.js +1 -1
- package/dist/cli-bundle/sdk-graph.js +1 -1
- package/dist/cli-bundle/sdk-merge.js +54 -54
- 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 +717 -702
- package/dist/core/extensions/extension-types.js +1 -1
- package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
- package/dist/core/extensions/flag-value-types.d.ts +32 -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-contracts.js +1 -1
- 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-format.js +3 -3
- 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 -25
- package/dist/core/output/mutation-projection.js +1 -1
- 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 +15 -15
- package/dist/core/schema/type-workflows.js +1 -1
- 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 +5 -3
- package/dist/core/shared/text-normalization.js +1 -1
- 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-mutation-precondition.d.ts +11 -0
- package/dist/core/store/item-mutation-precondition.js +2 -0
- 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/server.js +1 -1
- package/dist/mcp/tool-definitions.d.ts +27 -27
- package/dist/mcp/tool-definitions.js +1 -1
- 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/agent-output-contracts.js +1 -1
- 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/flag-lexicon-contracts.js +1 -1
- package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
- package/dist/sdk/cli-contracts/registration-helpers.d.ts +57 -57
- package/dist/sdk/cli-contracts/registration-helpers.js +1 -1
- 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/tool-schema.js +1 -1
- 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-contracts.js +1 -1
- 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 +9 -8
- package/dist/sdk/core.js +1 -1
- 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-1.js +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-topics.js +1 -1
- 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 +70 -69
- package/dist/sdk/index.js +1 -1
- 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 +139 -76
- package/dist/sdk/item-transaction.js +1 -1
- package/dist/sdk/learnings.d.ts +23 -23
- package/dist/sdk/lifecycle/append.d.ts +8 -8
- package/dist/sdk/lifecycle/claim.d.ts +53 -39
- package/dist/sdk/lifecycle/claim.js +1 -1
- package/dist/sdk/lifecycle/close-many.d.ts +71 -71
- package/dist/sdk/lifecycle/close.d.ts +18 -24
- package/dist/sdk/lifecycle/close.js +1 -1
- package/dist/sdk/lifecycle/copy.d.ts +10 -10
- package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
- package/dist/sdk/lifecycle/core-item-fields.d.ts +6 -0
- package/dist/sdk/lifecycle/core-item-fields.js +2 -0
- 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/mcp-actions.js +1 -1
- 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/mutation-option-validation.d.ts +2 -0
- package/dist/sdk/lifecycle/mutation-option-validation.js +2 -0
- 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/release-handoff.d.ts +12 -0
- package/dist/sdk/lifecycle/release-handoff.js +2 -0
- 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/structured-mutation-plan.d.ts +33 -0
- package/dist/sdk/lifecycle/structured-mutation-plan.js +2 -0
- package/dist/sdk/lifecycle/task-composition.d.ts +9 -9
- package/dist/sdk/lifecycle/task-composition.js +1 -1
- package/dist/sdk/lifecycle/update-many.d.ts +61 -61
- package/dist/sdk/lifecycle/update.d.ts +113 -121
- package/dist/sdk/lifecycle/update.js +1 -1
- package/dist/sdk/lifecycle/workflow-transition.d.ts +13 -0
- package/dist/sdk/lifecycle/workflow-transition.js +2 -0
- package/dist/sdk/lifecycle-completion.d.ts +14 -14
- package/dist/sdk/lifecycle-policy.d.ts +42 -32
- package/dist/sdk/lifecycle-policy.js +1 -1
- 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-budget.js +1 -1
- 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-input.js +1 -1
- 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/runtime.js +1 -1
- 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 +64 -13
- package/dist/sdk/structured-mutations.js +1 -1
- 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-transaction.js +2 -2
- package/dist/sdk/workspace.d.ts +9 -9
- package/dist/types.d.ts +540 -540
- package/docs/AGENT_GUIDE.md +33 -4
- package/docs/CLOSE_EVIDENCE_RECOVERY.md +16 -7
- package/docs/COMMANDS.md +96 -12
- package/docs/ECOSYSTEM_PLANNING_REVIEW.md +5 -1
- package/docs/EXTENSIONS.md +1 -1
- package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
- package/docs/LINKED_TEST_EDITS.md +15 -0
- package/docs/RELEASING.md +2 -0
- package/docs/SDK.md +114 -2
- package/docs/TESTING.md +36 -1
- package/docs/generated/FLAG_LEXICON_BUDGETS.md +1 -1
- package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +17 -3
- package/marketplace.json +1 -1
- package/package.json +4 -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-LOSRTNNP.js +0 -2
- package/dist/cli-bundle/chunks/chunk-PP3BVMFL.js +0 -30
- package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
- package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
- package/dist/cli-bundle/chunks/register-mutation-TNRHNK4N.js +0 -20
- package/dist/cli-bundle/focused-chunks/chunk-23ACMPGB.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
- package/dist/cli-bundle/focused-chunks/chunk-LKWDWER4.js +0 -20
- package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
- package/docs/ecosystem-review-2026-09-28.json +0 -1
package/dist/sdk/extension.d.ts
CHANGED
|
@@ -4,17 +4,17 @@
|
|
|
4
4
|
* Implements the pm extension command surface and its agent-facing runtime behavior.
|
|
5
5
|
*/
|
|
6
6
|
import fs from "node:fs/promises";
|
|
7
|
-
import { activateExtensions,
|
|
7
|
+
import { activateExtensions,loadExtensions } from "../core/extensions/index.js";
|
|
8
8
|
import type { GlobalOptions } from "../core/shared/command-types.js";
|
|
9
9
|
import type { PmSettings } from "../types/index.js";
|
|
10
|
-
import { parseExtensionManifest,
|
|
11
|
-
import { readManagedExtensionState,
|
|
10
|
+
import { parseExtensionManifest,validateExtensionDirectory } from "./extension/shared.js";
|
|
11
|
+
import { readManagedExtensionState,writeManagedExtensionState,resolveManagedExtensionStatePath,type ManagedExtensionSource,type ManagedExtensionRecord,type ManagedExtensionState } from "./extension/managed-state.js";
|
|
12
12
|
import { parseExtensionInstallSource } from "./extension/install-sources.js";
|
|
13
|
-
import { copyExtensionDirectoryForInstall,
|
|
13
|
+
import { copyExtensionDirectoryForInstall,resolveCanonicalExtensionInstallDestination } from "./extension/install-runtime.js";
|
|
14
14
|
import { collectGlobalOutputOverrideDoctorWarnings } from "./extension/output-ownership.js";
|
|
15
|
-
import { type ExtensionInstallPlan,
|
|
16
|
-
export { parseExtensionManifest,
|
|
17
|
-
export type { ManagedExtensionSource,
|
|
15
|
+
import { type ExtensionInstallPlan,type ExtensionCopyPlanOptions } from "./extension/install-plan.js";
|
|
16
|
+
export { parseExtensionManifest,validateExtensionDirectory,readManagedExtensionState,writeManagedExtensionState,resolveManagedExtensionStatePath,parseExtensionInstallSource,copyExtensionDirectoryForInstall,resolveCanonicalExtensionInstallDestination,};
|
|
17
|
+
export type { ManagedExtensionSource,ManagedExtensionRecord,ManagedExtensionState,};
|
|
18
18
|
export type { ManagedExtensionStateReadResult } from "./extension/managed-state.js";
|
|
19
19
|
/** Restricts extension command action values accepted by command, SDK, and storage contracts. */
|
|
20
20
|
export type ExtensionCommandAction = "install" | "uninstall" | "explore" | "manage" | "describe" | "reload" | "doctor" | "catalog" | "adopt" | "adopt-all" | "activate" | "deactivate" | "migrate" | "init";
|
|
@@ -25,314 +25,314 @@ export type ExtensionActivationStatus = "ok" | "failed" | "not_loaded" | "unknow
|
|
|
25
25
|
/** Documents the extension command options payload exchanged by command, SDK, and package integrations. */
|
|
26
26
|
export interface ExtensionCommandOptions {
|
|
27
27
|
/** Value that configures or reports install for this contract. */
|
|
28
|
-
install?:
|
|
28
|
+
install?:boolean;
|
|
29
29
|
/** Value that configures or reports uninstall for this contract. */
|
|
30
|
-
uninstall?:
|
|
30
|
+
uninstall?:boolean;
|
|
31
31
|
/** Value that configures or reports explore for this contract. */
|
|
32
|
-
explore?:
|
|
32
|
+
explore?:boolean;
|
|
33
33
|
/** Value that configures or reports manage for this contract. */
|
|
34
|
-
manage?:
|
|
34
|
+
manage?:boolean;
|
|
35
35
|
/** Value that configures or reports describe for this contract. */
|
|
36
|
-
describe?:
|
|
36
|
+
describe?:boolean;
|
|
37
37
|
/** Value that configures or reports markdown for this contract. */
|
|
38
|
-
markdown?:
|
|
38
|
+
markdown?:boolean;
|
|
39
39
|
/** Value that configures or reports output for this contract. */
|
|
40
|
-
output?:
|
|
40
|
+
output?:string;
|
|
41
41
|
/** Value that configures or reports reload for this contract. */
|
|
42
|
-
reload?:
|
|
42
|
+
reload?:boolean;
|
|
43
43
|
/** Value that configures or reports doctor for this contract. */
|
|
44
|
-
doctor?:
|
|
44
|
+
doctor?:boolean;
|
|
45
45
|
/** Value that configures or reports catalog for this contract. */
|
|
46
|
-
catalog?:
|
|
46
|
+
catalog?:boolean;
|
|
47
47
|
/** Value that configures or reports init for this contract. */
|
|
48
|
-
init?:
|
|
48
|
+
init?:boolean;
|
|
49
49
|
/** Value that configures or reports scaffold for this contract. */
|
|
50
|
-
scaffold?:
|
|
50
|
+
scaffold?:boolean;
|
|
51
51
|
/** Value that configures or reports strict exit for this contract. */
|
|
52
|
-
strictExit?:
|
|
52
|
+
strictExit?:boolean;
|
|
53
53
|
/** Value that configures or reports fail on warn for this contract. */
|
|
54
|
-
failOnWarn?:
|
|
54
|
+
failOnWarn?:boolean;
|
|
55
55
|
/** Value that configures or reports adopt for this contract. */
|
|
56
|
-
adopt?:
|
|
56
|
+
adopt?:boolean;
|
|
57
57
|
/** Value that configures or reports adopt all for this contract. */
|
|
58
|
-
adoptAll?:
|
|
58
|
+
adoptAll?:boolean;
|
|
59
59
|
/** Registers this package's commands, actions, and runtime hooks with the host. */
|
|
60
|
-
activate?:
|
|
60
|
+
activate?:boolean;
|
|
61
61
|
/** Value that configures or reports deactivate for this contract. */
|
|
62
|
-
deactivate?:
|
|
62
|
+
deactivate?:boolean;
|
|
63
63
|
/** Plan or apply active extension migrations. */
|
|
64
|
-
migrate?:
|
|
64
|
+
migrate?:boolean;
|
|
65
65
|
/** Value that configures or reports project for this contract. */
|
|
66
|
-
project?:
|
|
66
|
+
project?:boolean;
|
|
67
67
|
/** Value that configures or reports local for this contract. */
|
|
68
|
-
local?:
|
|
68
|
+
local?:boolean;
|
|
69
69
|
/** Value that configures or reports global for this contract. */
|
|
70
|
-
global?:
|
|
70
|
+
global?:boolean;
|
|
71
71
|
/** Value that configures or reports gh for this contract. */
|
|
72
|
-
gh?:
|
|
72
|
+
gh?:string;
|
|
73
73
|
/** Value that configures or reports github for this contract. */
|
|
74
|
-
github?:
|
|
74
|
+
github?:string;
|
|
75
75
|
/** Value that configures or reports ref for this contract. */
|
|
76
|
-
ref?:
|
|
76
|
+
ref?:string;
|
|
77
77
|
/** Value that configures or reports detail for this contract. */
|
|
78
|
-
detail?:
|
|
78
|
+
detail?:string;
|
|
79
79
|
/** Value that configures or reports trace for this contract. */
|
|
80
|
-
trace?:
|
|
80
|
+
trace?:boolean;
|
|
81
81
|
/** Value that configures or reports watch for this contract. */
|
|
82
|
-
watch?:
|
|
82
|
+
watch?:boolean;
|
|
83
83
|
/** Value that configures or reports runtime probe for this contract. */
|
|
84
|
-
runtimeProbe?:
|
|
84
|
+
runtimeProbe?:boolean;
|
|
85
85
|
/** Skip remote freshness checks during manage and report unknown availability. */
|
|
86
|
-
offline?:
|
|
86
|
+
offline?:boolean;
|
|
87
87
|
/** Value that configures or reports fix managed state for this contract. */
|
|
88
|
-
fixManagedState?:
|
|
88
|
+
fixManagedState?:boolean;
|
|
89
89
|
/** Value that configures or reports isolated for this contract. */
|
|
90
|
-
isolated?:
|
|
90
|
+
isolated?:boolean;
|
|
91
91
|
/** Value that configures or reports ignore global for this contract. */
|
|
92
|
-
ignoreGlobal?:
|
|
92
|
+
ignoreGlobal?:boolean;
|
|
93
93
|
/** Value that configures or reports fields for this contract. */
|
|
94
|
-
fields?:
|
|
94
|
+
fields?:string;
|
|
95
95
|
/** Value that configures or reports capability for this contract. */
|
|
96
|
-
capability?:
|
|
96
|
+
capability?:string;
|
|
97
97
|
/** Value that configures or reports declarative for this contract. */
|
|
98
|
-
declarative?:
|
|
98
|
+
declarative?:boolean;
|
|
99
99
|
/** Value that configures or reports vocabulary for this contract. */
|
|
100
|
-
vocabulary?:
|
|
100
|
+
vocabulary?:"extension" | "package";
|
|
101
101
|
/** Plan migrations or resolve install sources and estimate copying without destination writes or activation. */
|
|
102
|
-
dryRun?:
|
|
102
|
+
dryRun?:boolean;
|
|
103
103
|
/** SDK limits and cancellation for install copy-cost enumeration. */
|
|
104
|
-
copyPlan?:
|
|
104
|
+
copyPlan?:ExtensionCopyPlanOptions;
|
|
105
105
|
}
|
|
106
106
|
/** Documents the managed extension summary payload exchanged by command, SDK, and package integrations. */
|
|
107
107
|
export interface ManagedExtensionSummary {
|
|
108
108
|
/** Value that configures or reports name for this contract. */
|
|
109
|
-
name:
|
|
109
|
+
name:string;
|
|
110
110
|
/** Value that configures or reports directory for this contract. */
|
|
111
|
-
directory:
|
|
111
|
+
directory:string;
|
|
112
112
|
/** Value that configures or reports version for this contract. */
|
|
113
|
-
version:
|
|
113
|
+
version:string;
|
|
114
114
|
/** Value that configures or reports entry for this contract. */
|
|
115
|
-
entry:
|
|
115
|
+
entry:string;
|
|
116
116
|
/** Value that configures or reports scope for this contract. */
|
|
117
|
-
scope:
|
|
117
|
+
scope:ExtensionScope;
|
|
118
118
|
/** Value that configures or reports active for this contract. */
|
|
119
|
-
active:
|
|
119
|
+
active:boolean;
|
|
120
120
|
/** Whether enabled applies to this operation. */
|
|
121
|
-
enabled:
|
|
121
|
+
enabled:boolean;
|
|
122
122
|
/** Value that configures or reports runtime active for this contract. */
|
|
123
|
-
runtime_active:
|
|
123
|
+
runtime_active:boolean | null;
|
|
124
124
|
/** Activation outcome reported for this extension. */
|
|
125
|
-
activation_status:
|
|
125
|
+
activation_status:ExtensionActivationStatus;
|
|
126
126
|
/** Value that configures or reports command paths for this contract. */
|
|
127
|
-
command_paths?:
|
|
127
|
+
command_paths?:string[];
|
|
128
128
|
/** Value that configures or reports action paths for this contract. */
|
|
129
|
-
action_paths?:
|
|
129
|
+
action_paths?:string[];
|
|
130
130
|
/** Static install-time contribution inventory. */
|
|
131
|
-
contributions?:
|
|
131
|
+
contributions?:ManagedExtensionRecord["contributions"];
|
|
132
132
|
/** Value that configures or reports managed for this contract. */
|
|
133
|
-
managed:
|
|
133
|
+
managed:boolean;
|
|
134
134
|
/** Value that configures or reports source for this contract. */
|
|
135
|
-
source?:
|
|
135
|
+
source?:ManagedExtensionSource;
|
|
136
136
|
/** Value that configures or reports update available for this contract. */
|
|
137
|
-
update_available?:
|
|
137
|
+
update_available?:boolean | null;
|
|
138
138
|
/** ISO 8601 timestamp recording when last update check occurred. */
|
|
139
|
-
last_update_check_at?:
|
|
139
|
+
last_update_check_at?:string;
|
|
140
140
|
/** Value that configures or reports last update remote commit for this contract. */
|
|
141
|
-
last_update_remote_commit?:
|
|
141
|
+
last_update_remote_commit?:string;
|
|
142
142
|
/** Latest npm registry version observed by this invocation. */
|
|
143
|
-
last_update_remote_version?:
|
|
143
|
+
last_update_remote_version?:string;
|
|
144
144
|
/** Value that configures or reports update error for this contract. */
|
|
145
|
-
update_error?:
|
|
145
|
+
update_error?:string;
|
|
146
146
|
/** Outcome of the registry update check for this extension. */
|
|
147
|
-
update_check_status:
|
|
147
|
+
update_check_status:ExtensionUpdateCheckStatus;
|
|
148
148
|
/** Value that configures or reports update check reason for this contract. */
|
|
149
|
-
update_check_reason:
|
|
149
|
+
update_check_reason:string;
|
|
150
150
|
}
|
|
151
151
|
/** Documents the extension command result payload exchanged by command, SDK, and package integrations. */
|
|
152
152
|
export interface ExtensionCommandResult {
|
|
153
153
|
/** Whether the operation completed without a blocking failure. */
|
|
154
|
-
ok:
|
|
154
|
+
ok:boolean;
|
|
155
155
|
/** Value that configures or reports action for this contract. */
|
|
156
|
-
action:
|
|
156
|
+
action:ExtensionCommandAction;
|
|
157
157
|
/** Value that configures or reports scope for this contract. */
|
|
158
|
-
scope:
|
|
158
|
+
scope:ExtensionScope;
|
|
159
159
|
/** Value that configures or reports roots for this contract. */
|
|
160
|
-
roots:
|
|
161
|
-
project:
|
|
162
|
-
global:
|
|
163
|
-
selected:
|
|
164
|
-
settings_root:
|
|
160
|
+
roots:{
|
|
161
|
+
project:string;
|
|
162
|
+
global:string;
|
|
163
|
+
selected:string;
|
|
164
|
+
settings_root:string;
|
|
165
165
|
};
|
|
166
166
|
/** Value that configures or reports warnings for this contract. */
|
|
167
|
-
warnings:
|
|
167
|
+
warnings:string[];
|
|
168
168
|
/** Value that configures or reports details for this contract. */
|
|
169
|
-
details:
|
|
170
|
-
install_plan?:
|
|
169
|
+
details:Record<string,unknown> & {
|
|
170
|
+
install_plan?:ExtensionInstallPlan;
|
|
171
171
|
};
|
|
172
172
|
}
|
|
173
173
|
/** Documents the extension triage summary payload exchanged by command, SDK, and package integrations. */
|
|
174
174
|
export interface ExtensionTriageSummary {
|
|
175
175
|
/** Lifecycle state reported for status. */
|
|
176
|
-
status:
|
|
176
|
+
status:"ok" | "warn";
|
|
177
177
|
/** Number of warning entries represented by this result. */
|
|
178
|
-
warning_count:
|
|
178
|
+
warning_count:number;
|
|
179
179
|
/** Value that configures or reports warning codes for this contract. */
|
|
180
|
-
warning_codes:
|
|
180
|
+
warning_codes:string[];
|
|
181
181
|
/** Value that configures or reports warnings for this contract. */
|
|
182
|
-
warnings:
|
|
182
|
+
warnings:string[];
|
|
183
183
|
/** Number of policy warning entries represented by this result. */
|
|
184
|
-
policy_warning_count:
|
|
184
|
+
policy_warning_count:number;
|
|
185
185
|
/** Number of policy violation entries represented by this result. */
|
|
186
|
-
policy_violation_count:
|
|
186
|
+
policy_violation_count:number;
|
|
187
187
|
/** Number of policy blocked entries represented by this result. */
|
|
188
|
-
policy_blocked_count:
|
|
188
|
+
policy_blocked_count:number;
|
|
189
189
|
/** Value that configures or reports total extensions for this contract. */
|
|
190
|
-
total_extensions:
|
|
190
|
+
total_extensions:number;
|
|
191
191
|
/** Value that configures or reports managed total for this contract. */
|
|
192
|
-
managed_total:
|
|
192
|
+
managed_total:number;
|
|
193
193
|
/** Value that configures or reports enabled total for this contract. */
|
|
194
|
-
enabled_total:
|
|
194
|
+
enabled_total:number;
|
|
195
195
|
/** Value that configures or reports active total for this contract. */
|
|
196
|
-
active_total:
|
|
196
|
+
active_total:number;
|
|
197
197
|
/** Value that configures or reports update available total for this contract. */
|
|
198
|
-
update_available_total:
|
|
198
|
+
update_available_total:number;
|
|
199
199
|
/** Value that configures or reports update health coverage for this contract. */
|
|
200
|
-
update_health_coverage:
|
|
200
|
+
update_health_coverage:"full" | "partial";
|
|
201
201
|
/** Value that configures or reports update health partial for this contract. */
|
|
202
|
-
update_health_partial:
|
|
202
|
+
update_health_partial:boolean;
|
|
203
203
|
/** Number of unmanaged loaded extension entries represented by this result. */
|
|
204
|
-
unmanaged_loaded_extension_count:
|
|
204
|
+
unmanaged_loaded_extension_count:number;
|
|
205
205
|
/** Value that configures or reports unmanaged loaded extensions for this contract. */
|
|
206
|
-
unmanaged_loaded_extensions:
|
|
206
|
+
unmanaged_loaded_extensions:string[];
|
|
207
207
|
/** Number of unmanaged expected extension entries represented by this result. */
|
|
208
|
-
unmanaged_expected_extension_count:
|
|
208
|
+
unmanaged_expected_extension_count:number;
|
|
209
209
|
/** Value that configures or reports unmanaged expected extensions for this contract. */
|
|
210
|
-
unmanaged_expected_extensions:
|
|
210
|
+
unmanaged_expected_extensions:string[];
|
|
211
211
|
/** Number of unmanaged action required extension entries represented by this result. */
|
|
212
|
-
unmanaged_action_required_extension_count:
|
|
212
|
+
unmanaged_action_required_extension_count:number;
|
|
213
213
|
/** Value that configures or reports unmanaged action required extensions for this contract. */
|
|
214
|
-
unmanaged_action_required_extensions:
|
|
214
|
+
unmanaged_action_required_extensions:string[];
|
|
215
215
|
/** Value that configures or reports update check status totals for this contract. */
|
|
216
|
-
update_check_status_totals:
|
|
216
|
+
update_check_status_totals:Record<ExtensionUpdateCheckStatus,number>;
|
|
217
217
|
/** Value that configures or reports update check failed total for this contract. */
|
|
218
|
-
update_check_failed_total:
|
|
218
|
+
update_check_failed_total:number;
|
|
219
219
|
/** Value that configures or reports top warnings for this contract. */
|
|
220
|
-
top_warnings:
|
|
220
|
+
top_warnings:string[];
|
|
221
221
|
/** Value that configures or reports remediation for this contract. */
|
|
222
|
-
remediation:
|
|
222
|
+
remediation:string[];
|
|
223
223
|
/** Value that configures or reports collision plan for this contract. */
|
|
224
|
-
collision_plan?:
|
|
224
|
+
collision_plan?:ExtensionCollisionPlan;
|
|
225
225
|
}
|
|
226
226
|
/** Documents the extension collision plan payload exchanged by command, SDK, and package integrations. */
|
|
227
227
|
export interface ExtensionCollisionPlan {
|
|
228
228
|
/** Lifecycle state reported for status. */
|
|
229
|
-
status:
|
|
229
|
+
status:"ok" | "conflicts_detected";
|
|
230
230
|
/** Number of collision entries represented by this result. */
|
|
231
|
-
collision_count:
|
|
231
|
+
collision_count:number;
|
|
232
232
|
/** Number of extension entries represented by this result. */
|
|
233
|
-
extension_count:
|
|
233
|
+
extension_count:number;
|
|
234
234
|
/** Value that configures or reports next best command for this contract. */
|
|
235
|
-
next_best_command:
|
|
235
|
+
next_best_command:string;
|
|
236
236
|
/** Value that configures or reports collisions for this contract. */
|
|
237
|
-
collisions:
|
|
238
|
-
code:
|
|
239
|
-
surface:
|
|
240
|
-
winner:
|
|
241
|
-
layer:
|
|
242
|
-
name:
|
|
237
|
+
collisions:Array<{
|
|
238
|
+
code:string;
|
|
239
|
+
surface:string;
|
|
240
|
+
winner:{
|
|
241
|
+
layer:ExtensionScope;
|
|
242
|
+
name:string;
|
|
243
243
|
};
|
|
244
|
-
displaced:
|
|
245
|
-
layer:
|
|
246
|
-
name:
|
|
244
|
+
displaced:{
|
|
245
|
+
layer:ExtensionScope;
|
|
246
|
+
name:string;
|
|
247
247
|
};
|
|
248
248
|
}>;
|
|
249
249
|
/** Value that configures or reports remediation candidates for this contract. */
|
|
250
|
-
remediation_candidates:
|
|
251
|
-
action:
|
|
252
|
-
extension:
|
|
253
|
-
command:
|
|
254
|
-
affected_collisions:
|
|
255
|
-
feature_loss:
|
|
256
|
-
command_paths:
|
|
257
|
-
action_paths:
|
|
250
|
+
remediation_candidates:Array<{
|
|
251
|
+
action:"deactivate";
|
|
252
|
+
extension:string;
|
|
253
|
+
command:string;
|
|
254
|
+
affected_collisions:number;
|
|
255
|
+
feature_loss:{
|
|
256
|
+
command_paths:string[];
|
|
257
|
+
action_paths:string[];
|
|
258
258
|
};
|
|
259
259
|
}>;
|
|
260
260
|
}
|
|
261
261
|
/** Restricts extension update check status values accepted by command, SDK, and storage contracts. */
|
|
262
262
|
export type ExtensionUpdateCheckStatus = "checked" | "skipped_unmanaged" | "skipped_non_github" | "failed" | "not_checked";
|
|
263
263
|
interface ExtensionUpdateCheckResolution {
|
|
264
|
-
status:
|
|
265
|
-
reason:
|
|
264
|
+
status:ExtensionUpdateCheckStatus;
|
|
265
|
+
reason:string;
|
|
266
266
|
}
|
|
267
267
|
/** Restricts extension doctor detail mode values accepted by command, SDK, and storage contracts. */
|
|
268
268
|
export type ExtensionDoctorDetailMode = "summary" | "deep";
|
|
269
269
|
interface ExtensionPolicyOverrideDetails {
|
|
270
|
-
name:
|
|
271
|
-
disabled?:
|
|
272
|
-
require_trusted?:
|
|
273
|
-
require_provenance?:
|
|
274
|
-
sandbox_profile?:
|
|
275
|
-
allowed_capabilities?:
|
|
276
|
-
blocked_capabilities?:
|
|
277
|
-
allowed_surfaces?:
|
|
278
|
-
blocked_surfaces?:
|
|
279
|
-
allowed_commands?:
|
|
280
|
-
blocked_commands?:
|
|
281
|
-
allowed_actions?:
|
|
282
|
-
blocked_actions?:
|
|
283
|
-
allowed_services?:
|
|
284
|
-
blocked_services?:
|
|
270
|
+
name:string;
|
|
271
|
+
disabled?:boolean;
|
|
272
|
+
require_trusted?:boolean;
|
|
273
|
+
require_provenance?:boolean;
|
|
274
|
+
sandbox_profile?:"none" | "restricted" | "strict";
|
|
275
|
+
allowed_capabilities?:string[];
|
|
276
|
+
blocked_capabilities?:string[];
|
|
277
|
+
allowed_surfaces?:string[];
|
|
278
|
+
blocked_surfaces?:string[];
|
|
279
|
+
allowed_commands?:string[];
|
|
280
|
+
blocked_commands?:string[];
|
|
281
|
+
allowed_actions?:string[];
|
|
282
|
+
blocked_actions?:string[];
|
|
283
|
+
allowed_services?:string[];
|
|
284
|
+
blocked_services?:string[];
|
|
285
285
|
}
|
|
286
286
|
interface ExtensionPolicyDetails {
|
|
287
|
-
mode:
|
|
288
|
-
trust_mode:
|
|
289
|
-
require_provenance:
|
|
290
|
-
trusted_extensions:
|
|
291
|
-
default_sandbox_profile:
|
|
292
|
-
allowed_extensions:
|
|
293
|
-
blocked_extensions:
|
|
294
|
-
allowed_capabilities:
|
|
295
|
-
blocked_capabilities:
|
|
296
|
-
allowed_surfaces:
|
|
297
|
-
blocked_surfaces:
|
|
298
|
-
allowed_commands:
|
|
299
|
-
blocked_commands:
|
|
300
|
-
allowed_actions:
|
|
301
|
-
blocked_actions:
|
|
302
|
-
allowed_services:
|
|
303
|
-
blocked_services:
|
|
304
|
-
extension_overrides:
|
|
287
|
+
mode:"off" | "warn" | "enforce";
|
|
288
|
+
trust_mode:"off" | "warn" | "enforce";
|
|
289
|
+
require_provenance:boolean;
|
|
290
|
+
trusted_extensions:string[];
|
|
291
|
+
default_sandbox_profile:"none" | "restricted" | "strict";
|
|
292
|
+
allowed_extensions:string[];
|
|
293
|
+
blocked_extensions:string[];
|
|
294
|
+
allowed_capabilities:string[];
|
|
295
|
+
blocked_capabilities:string[];
|
|
296
|
+
allowed_surfaces:string[];
|
|
297
|
+
blocked_surfaces:string[];
|
|
298
|
+
allowed_commands:string[];
|
|
299
|
+
blocked_commands:string[];
|
|
300
|
+
allowed_actions:string[];
|
|
301
|
+
blocked_actions:string[];
|
|
302
|
+
allowed_services:string[];
|
|
303
|
+
blocked_services:string[];
|
|
304
|
+
extension_overrides:ExtensionPolicyOverrideDetails[];
|
|
305
305
|
}
|
|
306
306
|
type ActivationFailureEntry = Awaited<ReturnType<typeof activateExtensions>>["failed"][number];
|
|
307
307
|
interface ActivationFailureDiagnostic {
|
|
308
|
-
layer:
|
|
309
|
-
name:
|
|
310
|
-
entry_path:
|
|
311
|
-
error:
|
|
312
|
-
missing_capability?:
|
|
313
|
-
hint?:
|
|
314
|
-
trace?:
|
|
315
|
-
method:
|
|
316
|
-
registration_index:
|
|
317
|
-
expected_schema:
|
|
318
|
-
command?:
|
|
319
|
-
capability?:
|
|
320
|
-
missing_capability?:
|
|
321
|
-
hint?:
|
|
308
|
+
layer:string;
|
|
309
|
+
name:string;
|
|
310
|
+
entry_path:string;
|
|
311
|
+
error:string;
|
|
312
|
+
missing_capability?:string;
|
|
313
|
+
hint?:string;
|
|
314
|
+
trace?:{
|
|
315
|
+
method:string;
|
|
316
|
+
registration_index:number;
|
|
317
|
+
expected_schema:string;
|
|
318
|
+
command?:string;
|
|
319
|
+
capability?:string;
|
|
320
|
+
missing_capability?:string;
|
|
321
|
+
hint?:string;
|
|
322
322
|
};
|
|
323
323
|
}
|
|
324
324
|
interface AdoptedUnmanagedExtension {
|
|
325
|
-
name:
|
|
326
|
-
directory:
|
|
327
|
-
version:
|
|
328
|
-
entry:
|
|
329
|
-
source:
|
|
325
|
+
name:string;
|
|
326
|
+
directory:string;
|
|
327
|
+
version:string;
|
|
328
|
+
entry:string;
|
|
329
|
+
source:ManagedExtensionSource;
|
|
330
330
|
}
|
|
331
331
|
interface AdoptUnmanagedExtensionsResult {
|
|
332
|
-
state:
|
|
333
|
-
adopted_entries:
|
|
334
|
-
unmanaged_candidates:
|
|
335
|
-
already_managed_count:
|
|
332
|
+
state:ManagedExtensionState;
|
|
333
|
+
adopted_entries:AdoptedUnmanagedExtension[];
|
|
334
|
+
unmanaged_candidates:ManagedExtensionSummary[];
|
|
335
|
+
already_managed_count:number;
|
|
336
336
|
}
|
|
337
337
|
/**
|
|
338
338
|
* Entry point for the `pm extension` / `pm package` command surface. Resolves the
|
|
@@ -342,47 +342,47 @@ already_managed_count: number;
|
|
|
342
342
|
* returns the canonical {@link ExtensionCommandResult}. `--doctor` results are
|
|
343
343
|
* flagged for native (non-JSON-wrapped) output.
|
|
344
344
|
*/
|
|
345
|
-
export declare const runExtension:
|
|
345
|
+
export declare const runExtension:(target:string | undefined,options:ExtensionCommandOptions,global:GlobalOptions) => Promise<ExtensionCommandResult>;
|
|
346
346
|
/** Public contract for test only, shared by SDK and presentation-layer consumers. */
|
|
347
|
-
export declare const _testOnly:
|
|
348
|
-
adoptUnmanagedExtensions:
|
|
349
|
-
buildAdoptedExtensionSource:
|
|
350
|
-
buildExtensionPolicyDetails:
|
|
351
|
-
buildInstallCommandDiscovery:
|
|
352
|
-
command_paths:
|
|
353
|
-
action_paths:
|
|
354
|
-
},
|
|
355
|
-
checkGithubUpdate:
|
|
356
|
-
clearExtensionState:
|
|
357
|
-
collectActivationFailureDiagnostics:
|
|
358
|
-
findActivationFailureByName:
|
|
359
|
-
resolveInstallRuntimeActivationStatus:
|
|
360
|
-
collectGlobalOutputOverrideDoctorWarnings:
|
|
361
|
-
collectMcpCustomFieldCollisionDoctorWarnings:
|
|
362
|
-
collectSchemaNarrowActivationDoctorWarnings:
|
|
363
|
-
copyExtensionDirectoryWithoutSelfNesting:
|
|
364
|
-
isErrnoCode:
|
|
365
|
-
isRetriableExtensionInstallCopyError:
|
|
366
|
-
listInstalledExtensions:
|
|
367
|
-
extensions:
|
|
368
|
-
warnings:
|
|
347
|
+
export declare const _testOnly:{
|
|
348
|
+
adoptUnmanagedExtensions:(extensionsRoot:string,scope:ExtensionScope,installedExtensions:ManagedExtensionSummary[],state:ManagedExtensionState) => Promise<AdoptUnmanagedExtensionsResult>;
|
|
349
|
+
buildAdoptedExtensionSource:(githubOption:string | undefined,extensionTarget:string,extensionDirectory:string,ref:string | undefined) => ManagedExtensionSource;
|
|
350
|
+
buildExtensionPolicyDetails:(policy:PmSettings["extensions"]["policy"] | null | undefined) => ExtensionPolicyDetails;
|
|
351
|
+
buildInstallCommandDiscovery:(extensionName:string,source:ManagedExtensionSource,commandSummary:{
|
|
352
|
+
command_paths:string[];
|
|
353
|
+
action_paths:string[];
|
|
354
|
+
},activationFailure?:ActivationFailureDiagnostic) => Record<string,unknown>;
|
|
355
|
+
checkGithubUpdate:(source:ManagedExtensionSource,gitCommandRunner?:typeof import("./extension/install-sources.js").runGitCommand) => Promise<import("./extension/update-check.js").GithubUpdateStatus>;
|
|
356
|
+
clearExtensionState:(settings:PmSettings,name:string) => boolean;
|
|
357
|
+
collectActivationFailureDiagnostics:(failures:ActivationFailureEntry[]) => ActivationFailureDiagnostic[];
|
|
358
|
+
findActivationFailureByName:(extensionName:string,failures:ActivationFailureDiagnostic[],layer?:ExtensionScope) => ActivationFailureDiagnostic | undefined;
|
|
359
|
+
resolveInstallRuntimeActivationStatus:(extensionName:string,scope:ExtensionScope,runtimeInstalled:ManagedExtensionSummary[],installActivationFailure:ActivationFailureDiagnostic | undefined) => ExtensionActivationStatus;
|
|
360
|
+
collectGlobalOutputOverrideDoctorWarnings:typeof collectGlobalOutputOverrideDoctorWarnings;
|
|
361
|
+
collectMcpCustomFieldCollisionDoctorWarnings:(activationResult:Awaited<ReturnType<typeof activateExtensions>>) => string[];
|
|
362
|
+
collectSchemaNarrowActivationDoctorWarnings:(loadResult:Awaited<ReturnType<typeof loadExtensions>>,activationResult:Awaited<ReturnType<typeof activateExtensions>>) => string[];
|
|
363
|
+
copyExtensionDirectoryWithoutSelfNesting:(sourceDirectory:string,destinationDirectory:string,copyDirectory:typeof fs.cp,temporaryDirectory?:string) => Promise<void>;
|
|
364
|
+
isErrnoCode:(error:unknown,code:string) => boolean;
|
|
365
|
+
isRetriableExtensionInstallCopyError:(error:unknown) => boolean;
|
|
366
|
+
listInstalledExtensions:(extensionsRoot:string,scope:ExtensionScope,settings:PmSettings,state:ManagedExtensionState) => Promise<{
|
|
367
|
+
extensions:ManagedExtensionSummary[];
|
|
368
|
+
warnings:string[];
|
|
369
369
|
}>;
|
|
370
|
-
mapWithFixedConcurrency
|
|
371
|
-
projectExtensionUpdateCheck:
|
|
372
|
-
update_check_status:
|
|
373
|
-
update_check_reason:
|
|
370
|
+
mapWithFixedConcurrency:<Input,Output>(inputs:Input[],concurrency:number,mapper:(input:Input) => Promise<Output>) => Promise<Output[]>;
|
|
371
|
+
projectExtensionUpdateCheck:(entry:ManagedExtensionSummary | undefined) => {
|
|
372
|
+
update_check_status:string | null;
|
|
373
|
+
update_check_reason:string | null;
|
|
374
374
|
};
|
|
375
|
-
readOptionalMetadataFile:
|
|
376
|
-
requireTarget:
|
|
377
|
-
resolveAction:
|
|
378
|
-
resolveCommandDiscoveryPackageName:
|
|
379
|
-
resolveGithubOption:
|
|
380
|
-
resolveInstalledExtensionCandidate:
|
|
381
|
-
resolveManagedInstallTimestamps:
|
|
382
|
-
installed_at:
|
|
383
|
-
updated_at:
|
|
375
|
+
readOptionalMetadataFile:(filePath:string) => Promise<Buffer | null>;
|
|
376
|
+
requireTarget:(target:string | undefined,action:ExtensionCommandAction,options?:ExtensionCommandOptions) => string;
|
|
377
|
+
resolveAction:(target:string | undefined,options:ExtensionCommandOptions) => ExtensionCommandAction;
|
|
378
|
+
resolveCommandDiscoveryPackageName:(extensionName:string,source:ManagedExtensionSource) => string;
|
|
379
|
+
resolveGithubOption:(options:ExtensionCommandOptions) => string | undefined;
|
|
380
|
+
resolveInstalledExtensionCandidate:(installed:ManagedExtensionSummary[],extensionTarget:string) => Promise<ManagedExtensionSummary | undefined>;
|
|
381
|
+
resolveManagedInstallTimestamps:(existing:ManagedExtensionRecord | undefined,manifestVersion:string,source:ManagedExtensionSource,now:string) => {
|
|
382
|
+
installed_at:string;
|
|
383
|
+
updated_at:string;
|
|
384
384
|
};
|
|
385
|
-
resolveScope:
|
|
386
|
-
resolveUpdateCheckResolution:
|
|
387
|
-
withExtensionInstallLock
|
|
385
|
+
resolveScope:(options:ExtensionCommandOptions) => ExtensionScope;
|
|
386
|
+
resolveUpdateCheckResolution:(managedEntry:ManagedExtensionRecord | undefined) => ExtensionUpdateCheckResolution;
|
|
387
|
+
withExtensionInstallLock:<T>(settingsRoot:string,destinationDirectoryName:string,run:() => Promise<T>,options?:import("./extension/install-runtime.js").ExtensionInstallLockOptions) => Promise<T>;
|
|
388
388
|
};
|