@unbrained/pm-cli 2026.10.13 → 2026.10.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +1 -1
- package/CHANGELOG.md +72 -1
- package/dist/cli/after-command-context-usage.d.ts +7 -7
- package/dist/cli/argv-utils.d.ts +4 -4
- package/dist/cli/bundle-integrity.d.ts +16 -16
- package/dist/cli/command-namespaces.d.ts +1 -1
- package/dist/cli/commander-usage.d.ts +34 -34
- package/dist/cli/commands/governance/validate.d.ts +1 -1
- package/dist/cli/commands/history/history-compact.d.ts +1 -1
- package/dist/cli/commands/history/history-redact.d.ts +1 -1
- package/dist/cli/commands/history/history-repair.d.ts +1 -1
- package/dist/cli/commands/history/restore.d.ts +1 -1
- package/dist/cli/commands/lifecycle/close.d.ts +1 -1
- package/dist/cli/commands/lifecycle/copy.d.ts +1 -1
- package/dist/cli/commands/lifecycle/delete.d.ts +1 -1
- package/dist/cli/commands/lifecycle/focus.d.ts +1 -1
- package/dist/cli/commands/query/get.d.ts +1 -1
- package/dist/cli/commands/workspace/merge.d.ts +1 -1
- package/dist/cli/commands/workspace/schema.d.ts +1 -1
- package/dist/cli/context-intent-invocation.d.ts +1 -1
- package/dist/cli/description-stdin.d.ts +1 -1
- package/dist/cli/error-guidance.d.ts +119 -119
- package/dist/cli/extension-command-help.d.ts +64 -64
- package/dist/cli/extension-command-help.js +2 -2
- package/dist/cli/extension-command-options.d.ts +16 -16
- package/dist/cli/extension-command-options.js +1 -1
- package/dist/cli/extension-recovery.d.ts +13 -13
- package/dist/cli/help-content.d.ts +22 -22
- package/dist/cli/help-content.js +2 -2
- package/dist/cli/help-json-payload.d.ts +45 -45
- package/dist/cli/invocation-profile.d.ts +5 -5
- package/dist/cli/main.d.ts +217 -217
- package/dist/cli/main.js +2 -2
- package/dist/cli/migration-gates.d.ts +24 -24
- package/dist/cli/option-values.d.ts +1 -1
- package/dist/cli/public.d.ts +1 -1
- package/dist/cli/register-annotations.d.ts +2 -2
- package/dist/cli/register-assurance.d.ts +1 -1
- package/dist/cli/register-files-lookup.d.ts +1 -1
- package/dist/cli/register-history-activity.d.ts +1 -1
- package/dist/cli/register-history-author.d.ts +1 -1
- package/dist/cli/register-history-maintenance.d.ts +1 -1
- package/dist/cli/register-list-query.d.ts +7 -7
- package/dist/cli/register-list-query.js +3 -3
- package/dist/cli/register-mutation-options.d.ts +1 -1
- package/dist/cli/register-mutation.d.ts +4 -4
- package/dist/cli/register-operations.d.ts +75 -75
- package/dist/cli/register-setup.d.ts +4 -4
- package/dist/cli/register-structured-mutation.d.ts +8 -8
- package/dist/cli/runtime/activation.d.ts +23 -23
- package/dist/cli/runtime/invocation-options.d.ts +12 -12
- package/dist/cli/runtime/projection-retry.d.ts +1 -1
- package/dist/cli/runtime/selection.d.ts +16 -16
- package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
- package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
- package/dist/cli/schema/registration.d.ts +1 -1
- package/dist/cli/schema-registration-helpers.d.ts +2 -2
- package/dist/cli/stats-analytics-json.d.ts +1 -1
- package/dist/cli-bundle/bundle-manifest.json +1 -1
- package/dist/cli-bundle/chunks/{chunk-LBDWFWPK.js → chunk-52EZH2QQ.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-7OEGNA4X.js +20 -0
- package/dist/cli-bundle/chunks/{chunk-APWPC4ZZ.js → chunk-7VHINXZP.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-EMEEHV2Y.js +2 -0
- package/dist/cli-bundle/chunks/chunk-JGKTOBVB.js +6 -0
- package/dist/cli-bundle/chunks/{chunk-PSNS537F.js → chunk-JSUJWIHQ.js} +30 -30
- package/dist/cli-bundle/chunks/{chunk-N5EXRYCZ.js → chunk-LNKLQYBG.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-YH6H3UVE.js → chunk-N56CAQBU.js} +63 -64
- package/dist/cli-bundle/chunks/chunk-NC3QVGDD.js +8 -0
- package/dist/cli-bundle/chunks/{chunk-AM2XOZKE.js → chunk-RJ5N44WY.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-HXHFKXLV.js → chunk-VIMQCFCK.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-UBTYYZIE.js → chunk-WBBW3WQX.js} +4 -4
- package/dist/cli-bundle/chunks/chunk-X2H6UR26.js +236 -0
- package/dist/cli-bundle/chunks/{register-list-query-BJ742QOR.js → register-list-query-FKKFQ66D.js} +7 -7
- package/dist/cli-bundle/chunks/{register-mutation-GGGBRIH2.js → register-mutation-EWMMVZJB.js} +2 -2
- package/dist/cli-bundle/chunks/{register-operations-E6HXYHNM.js → register-operations-GEQ2H7PS.js} +2 -2
- package/dist/cli-bundle/chunks/{register-setup-4ZVTVEPY.js → register-setup-PSJTQBBO.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-NNW5BS5L.js → chunk-3RNUMVK4.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-3LQEBXU5.js → chunk-4KQFMOM7.js} +6 -6
- package/dist/cli-bundle/focused-chunks/{chunk-RAA7SVRA.js → chunk-52I2SNKJ.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-6BTUISKV.js → chunk-5KRACGBK.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-5OO54BIV.js +3 -0
- package/dist/cli-bundle/focused-chunks/chunk-5TBAVZDR.js +20 -0
- package/dist/cli-bundle/focused-chunks/{chunk-R23T7GFZ.js → chunk-FQKPOZKS.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-IIKFTJVC.js → chunk-H3P77KVU.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-HTA3TNC3.js +26 -0
- package/dist/cli-bundle/focused-chunks/{chunk-73UNAJHD.js → chunk-JKBH7YGX.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-KGFRQ34R.js → chunk-KIIFVULU.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-SOB7X4FJ.js → chunk-N6FUKTZS.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-PDYE7QDX.js +166 -0
- package/dist/cli-bundle/focused-chunks/{chunk-RU6GCFN3.js → chunk-Q4VNCTR2.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-QMNAY25P.js → chunk-THYQR3ON.js} +61 -62
- package/dist/cli-bundle/focused-chunks/{chunk-DVK7VKZL.js → chunk-TYLG5VEB.js} +2 -2
- package/dist/cli-bundle/main.js +27 -27
- package/dist/cli-bundle/sdk-authoring.js +1 -1
- package/dist/cli-bundle/sdk-contracts.js +2 -2
- package/dist/cli-bundle/sdk-core.js +23 -23
- package/dist/cli-bundle/sdk-governance.js +1 -1
- package/dist/cli-bundle/sdk-graph.js +1 -1
- package/dist/cli-bundle/sdk-merge.js +51 -51
- package/dist/cli-bundle/sdk-query.js +1 -1
- package/dist/cli-bundle/sdk-runtime.js +1 -1
- package/dist/cli-bundle/sdk-testing.js +1 -1
- package/dist/cli-bundle/sdk.js +7 -7
- package/dist/cli.d.ts +9 -9
- package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
- package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
- package/dist/core/config/nested-settings.d.ts +20 -20
- package/dist/core/config/positional-value.d.ts +9 -9
- package/dist/core/diagnostics/remediation.d.ts +7 -7
- package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
- package/dist/core/extensions/activation-summary.d.ts +30 -30
- package/dist/core/extensions/activation-transaction.d.ts +9 -9
- package/dist/core/extensions/capability-usage.d.ts +25 -25
- package/dist/core/extensions/command-hook-context.d.ts +15 -15
- package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
- package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
- package/dist/core/extensions/contribution-inventory.d.ts +24 -24
- package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
- package/dist/core/extensions/extension-candidate.d.ts +14 -14
- package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
- package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
- package/dist/core/extensions/extension-policy.d.ts +62 -62
- package/dist/core/extensions/extension-registries.d.ts +8 -8
- package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
- package/dist/core/extensions/extension-types.d.ts +702 -702
- package/dist/core/extensions/flag-definition-validation.d.ts +19 -6
- package/dist/core/extensions/flag-definition-validation.js +1 -1
- package/dist/core/extensions/flag-value-types.d.ts +16 -4
- package/dist/core/extensions/flag-value-types.js +1 -1
- package/dist/core/extensions/index.d.ts +34 -34
- package/dist/core/extensions/item-field-types.d.ts +3 -3
- package/dist/core/extensions/item-fields.d.ts +6 -6
- package/dist/core/extensions/loader.d.ts +66 -66
- package/dist/core/extensions/manifest-parser.d.ts +1 -1
- package/dist/core/extensions/manifest-schema.d.ts +13 -13
- package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
- package/dist/core/extensions/preflight-ownership.d.ts +3 -3
- package/dist/core/extensions/read-output-contract.d.ts +2 -2
- package/dist/core/extensions/registration-contracts.d.ts +12 -12
- package/dist/core/extensions/registration-validation.d.ts +6 -6
- package/dist/core/extensions/registration-values.d.ts +19 -19
- package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
- package/dist/core/extensions/runtime-registrations.d.ts +6 -6
- package/dist/core/extensions/service-ownership.d.ts +1 -1
- package/dist/core/extensions/version-compat.d.ts +9 -9
- package/dist/core/fs/atomic-create.d.ts +1 -1
- package/dist/core/fs/fs-utils.d.ts +12 -12
- package/dist/core/fs/host-environment-errors.d.ts +10 -10
- package/dist/core/fs/path-utils.d.ts +1 -1
- package/dist/core/governance/content-fields.d.ts +25 -25
- package/dist/core/governance/issue-codes.d.ts +16 -16
- package/dist/core/governance/metadata-coverage.d.ts +64 -64
- package/dist/core/history/digest.d.ts +5 -5
- package/dist/core/history/drift-cache.d.ts +2 -2
- package/dist/core/history/drift-scan.d.ts +18 -18
- package/dist/core/history/event-classification.d.ts +4 -4
- package/dist/core/history/event-index.d.ts +33 -33
- package/dist/core/history/history-compact-bulk.d.ts +12 -12
- package/dist/core/history/history-diff.d.ts +15 -15
- package/dist/core/history/history-rewrite.d.ts +43 -43
- package/dist/core/history/history-storage-stats.d.ts +20 -20
- package/dist/core/history/history-stream-policy.d.ts +12 -12
- package/dist/core/history/history.d.ts +45 -45
- package/dist/core/history/identity.d.ts +4 -4
- package/dist/core/history/operation-contract.d.ts +17 -17
- package/dist/core/history/projection.d.ts +16 -16
- package/dist/core/history/read.d.ts +4 -4
- package/dist/core/history/replay.d.ts +47 -47
- package/dist/core/history/tombstone.d.ts +1 -1
- package/dist/core/history/version-address.d.ts +2 -2
- package/dist/core/history/workspace-history.d.ts +72 -72
- package/dist/core/io/body-file.d.ts +2 -2
- package/dist/core/io/bulk-ids-input.d.ts +7 -7
- package/dist/core/item/actionability.d.ts +30 -30
- package/dist/core/item/dependency-reference.d.ts +2 -2
- package/dist/core/item/id.d.ts +9 -9
- package/dist/core/item/item-format-version.d.ts +17 -15
- package/dist/core/item/item-format-version.js +1 -1
- package/dist/core/item/item-format.d.ts +54 -54
- package/dist/core/item/item-record.d.ts +1 -1
- package/dist/core/item/item-type-definition.d.ts +11 -11
- package/dist/core/item/parent-reference-policy.d.ts +6 -6
- package/dist/core/item/parse.d.ts +37 -37
- package/dist/core/item/plan-lifecycle.d.ts +4 -4
- package/dist/core/item/priority.d.ts +3 -3
- package/dist/core/item/sprint-release-format.d.ts +4 -4
- package/dist/core/item/status-filter.d.ts +5 -5
- package/dist/core/item/status.d.ts +3 -3
- package/dist/core/item/toon-decode.d.ts +10 -10
- package/dist/core/item/type-registry.d.ts +35 -35
- package/dist/core/item/type-synonyms.d.ts +2 -2
- package/dist/core/lock/lock-gc.d.ts +28 -28
- package/dist/core/lock/lock.d.ts +53 -53
- package/dist/core/output/mutation-projection.d.ts +4 -4
- package/dist/core/output/output-control.d.ts +4 -4
- package/dist/core/output/output.d.ts +30 -30
- package/dist/core/output/query-summary.d.ts +5 -5
- package/dist/core/output/tabular.d.ts +3 -3
- package/dist/core/packages/manifest.d.ts +30 -30
- package/dist/core/packages/root.d.ts +4 -4
- package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
- package/dist/core/policy/workflow-policy-store.d.ts +15 -15
- package/dist/core/policy/workflow-policy.d.ts +56 -56
- package/dist/core/profile/profile-describe.d.ts +22 -22
- package/dist/core/profile/profile-lint.d.ts +13 -13
- package/dist/core/profile/profile-plan.d.ts +45 -45
- package/dist/core/profile/profile-presets.d.ts +36 -36
- package/dist/core/reproducibility/context.d.ts +9 -9
- package/dist/core/schema/fields-file.d.ts +35 -35
- package/dist/core/schema/item-types-file.d.ts +29 -29
- package/dist/core/schema/runtime-field-filters.d.ts +3 -3
- package/dist/core/schema/runtime-field-values.d.ts +7 -7
- package/dist/core/schema/runtime-schema.d.ts +59 -59
- package/dist/core/schema/status-defs-file.d.ts +29 -29
- package/dist/core/schema/status-token.d.ts +1 -1
- package/dist/core/schema/type-inference.d.ts +10 -10
- package/dist/core/schema/type-presets.d.ts +5 -5
- package/dist/core/schema/type-workflows.d.ts +14 -14
- package/dist/core/search/background-refresh.d.ts +12 -12
- package/dist/core/search/bm25.d.ts +16 -16
- package/dist/core/search/cache.d.ts +34 -34
- package/dist/core/search/corpus.d.ts +17 -17
- package/dist/core/search/embedding-batches.d.ts +25 -25
- package/dist/core/search/eval-thresholds.d.ts +4 -4
- package/dist/core/search/eval.d.ts +40 -40
- package/dist/core/search/http-client.d.ts +24 -24
- package/dist/core/search/providers.d.ts +30 -30
- package/dist/core/search/relevance.d.ts +17 -17
- package/dist/core/search/semantic-defaults.d.ts +5 -5
- package/dist/core/search/staleness.d.ts +3 -3
- package/dist/core/search/vector-stores.d.ts +51 -51
- package/dist/core/search/vectorization-metadata.d.ts +9 -9
- package/dist/core/sentry/helpers.d.ts +28 -26
- package/dist/core/sentry/helpers.js +1 -1
- package/dist/core/sentry/instrument.d.ts +52 -50
- package/dist/core/sentry/instrument.js +1 -1
- package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
- package/dist/core/sentry/sensitive-assignments.js +2 -0
- package/dist/core/session/session-state.d.ts +37 -37
- package/dist/core/shared/agent-session-context.d.ts +14 -14
- package/dist/core/shared/author.d.ts +89 -89
- package/dist/core/shared/command-line.d.ts +3 -3
- package/dist/core/shared/command-types.d.ts +20 -20
- package/dist/core/shared/conflict-markers.d.ts +5 -5
- package/dist/core/shared/constants.d.ts +30 -30
- package/dist/core/shared/errors.d.ts +100 -100
- package/dist/core/shared/html-entity-decode.d.ts +2 -2
- package/dist/core/shared/item-metadata-contract.d.ts +2 -2
- package/dist/core/shared/lazy-module.d.ts +1 -1
- package/dist/core/shared/levenshtein.d.ts +1 -1
- package/dist/core/shared/memo.d.ts +1 -1
- package/dist/core/shared/numeric-parsers.d.ts +1 -1
- package/dist/core/shared/option-alias-visibility.d.ts +3 -3
- package/dist/core/shared/primitives.d.ts +13 -13
- package/dist/core/shared/secret-rules.d.ts +92 -92
- package/dist/core/shared/serial-queue.d.ts +6 -6
- package/dist/core/shared/serialization.d.ts +4 -4
- package/dist/core/shared/split-comma-list.d.ts +4 -4
- package/dist/core/shared/text-normalization.d.ts +3 -3
- package/dist/core/shared/time.d.ts +27 -27
- package/dist/core/store/item-format-migration.d.ts +7 -7
- package/dist/core/store/item-metadata-cache.d.ts +30 -30
- package/dist/core/store/item-metadata-query-index.d.ts +66 -66
- package/dist/core/store/item-metadata-read-work.d.ts +6 -6
- package/dist/core/store/item-store.d.ts +123 -123
- package/dist/core/store/item-store.js +1 -1
- package/dist/core/store/paths.d.ts +27 -27
- package/dist/core/store/settings-concurrency.d.ts +1 -1
- package/dist/core/store/settings-read-cache.d.ts +11 -11
- package/dist/core/store/settings-validator.d.ts +117 -117
- package/dist/core/store/settings.d.ts +84 -84
- package/dist/core/store/sqlite-runtime.d.ts +2 -2
- package/dist/core/store/tracker-preflight.d.ts +3 -3
- package/dist/core/telemetry/consent.d.ts +1 -1
- package/dist/core/telemetry/observability.d.ts +16 -16
- package/dist/core/telemetry/policy.d.ts +7 -7
- package/dist/core/telemetry/read-sampling.d.ts +1 -1
- package/dist/core/telemetry/runtime.d.ts +275 -275
- package/dist/core/telemetry/runtime.js +2 -2
- package/dist/core/test/background-runs.d.ts +123 -123
- package/dist/core/test/item-test-run-tracking.d.ts +10 -10
- package/dist/core/test/run-selectors.d.ts +12 -12
- package/dist/core/validate/estimate-defaults.d.ts +3 -3
- package/dist/core/validate/fix-planning.d.ts +36 -36
- package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
- package/dist/core/validate/missing-by-type.d.ts +3 -3
- package/dist/core/validate/missing-link-owners.d.ts +17 -17
- package/dist/core/validate/stale-file-classification.d.ts +6 -6
- package/dist/mcp/http-server.d.ts +26 -26
- package/dist/mcp/legacy-adapter.d.ts +18 -18
- package/dist/mcp/runtime-capabilities.d.ts +18 -18
- package/dist/mcp/server.d.ts +73 -73
- package/dist/mcp/tool-definitions.d.ts +27 -27
- package/dist/sdk/actionability.d.ts +1 -1
- package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
- package/dist/sdk/agent/command-recovery.d.ts +5 -5
- package/dist/sdk/agent/command-suggestions.d.ts +4 -4
- package/dist/sdk/agent/create-option-policy.d.ts +2 -2
- package/dist/sdk/agent/identity-config.d.ts +18 -18
- package/dist/sdk/agent/item-addressing.d.ts +6 -6
- package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
- package/dist/sdk/agent/refusal-closure.d.ts +22 -22
- package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
- package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
- package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
- package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
- package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
- package/dist/sdk/agent-capability-contracts.d.ts +41 -41
- package/dist/sdk/agent-session-context.d.ts +1 -1
- package/dist/sdk/annotations.d.ts +74 -74
- package/dist/sdk/author-attribution.d.ts +47 -47
- package/dist/sdk/authoring.d.ts +9 -9
- package/dist/sdk/cli-bootstrap.d.ts +65 -65
- package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
- package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
- package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
- package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
- package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
- package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
- package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
- package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
- package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
- package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
- package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
- package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
- package/dist/sdk/cli-contracts/registration-helpers.d.ts +56 -56
- package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
- package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
- package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
- package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
- package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
- package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
- package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
- package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
- package/dist/sdk/cli-contracts.d.ts +15 -15
- package/dist/sdk/cli-program.d.ts +1 -1
- package/dist/sdk/cli-program.js +1 -1
- package/dist/sdk/command-line.d.ts +3 -3
- package/dist/sdk/comments.d.ts +24 -24
- package/dist/sdk/compile-cache.d.ts +4 -4
- package/dist/sdk/completion/bash.d.ts +1 -1
- package/dist/sdk/completion/fish.d.ts +1 -1
- package/dist/sdk/completion/shared.d.ts +74 -74
- package/dist/sdk/completion/zsh.d.ts +1 -1
- package/dist/sdk/completion.d.ts +3 -3
- package/dist/sdk/compose.d.ts +94 -94
- package/dist/sdk/config.d.ts +105 -105
- package/dist/sdk/context/recency.d.ts +1 -1
- package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
- package/dist/sdk/context/usage-egress.d.ts +1 -1
- package/dist/sdk/context/usage-ledger.d.ts +18 -18
- package/dist/sdk/context-intent-contracts.d.ts +37 -37
- package/dist/sdk/context-intent-runtime.d.ts +10 -10
- package/dist/sdk/context-packing.d.ts +44 -44
- package/dist/sdk/context-relevance.d.ts +110 -110
- package/dist/sdk/context-signal-store.d.ts +52 -52
- package/dist/sdk/context-usage.d.ts +78 -78
- package/dist/sdk/contracts.d.ts +2 -1
- package/dist/sdk/contracts.js +1 -1
- package/dist/sdk/core-governance.d.ts +5 -5
- package/dist/sdk/core.d.ts +8 -8
- package/dist/sdk/corpus-shape.d.ts +60 -60
- package/dist/sdk/define.d.ts +36 -36
- package/dist/sdk/dependencies.d.ts +70 -70
- package/dist/sdk/dependency-flag-validation.d.ts +17 -17
- package/dist/sdk/dependency-provenance.d.ts +22 -22
- package/dist/sdk/docs.d.ts +17 -17
- package/dist/sdk/duplicates.d.ts +14 -14
- package/dist/sdk/environment/agent-environment.d.ts +118 -118
- package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
- package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
- package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
- package/dist/sdk/environment/source-context.d.ts +4 -4
- package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
- package/dist/sdk/error-code-catalog.d.ts +33 -33
- package/dist/sdk/error-runtime.d.ts +5 -5
- package/dist/sdk/errors.d.ts +17 -17
- package/dist/sdk/eval.d.ts +27 -27
- package/dist/sdk/extension/author-manifest.d.ts +9 -9
- package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
- package/dist/sdk/extension/concurrency.d.ts +1 -1
- package/dist/sdk/extension/copy-scope.d.ts +1 -1
- package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
- package/dist/sdk/extension/describe.d.ts +21 -21
- package/dist/sdk/extension/doctor.d.ts +46 -46
- package/dist/sdk/extension/install-plan.d.ts +32 -32
- package/dist/sdk/extension/install-receipts.d.ts +4 -4
- package/dist/sdk/extension/install-runtime.d.ts +12 -12
- package/dist/sdk/extension/install-snapshot.d.ts +10 -10
- package/dist/sdk/extension/install-sources.d.ts +106 -106
- package/dist/sdk/extension/managed-state.d.ts +42 -42
- package/dist/sdk/extension/managed-update-status.d.ts +1 -1
- package/dist/sdk/extension/migrations.d.ts +48 -48
- package/dist/sdk/extension/output-ownership.d.ts +19 -19
- package/dist/sdk/extension/runtime-summary.d.ts +7 -7
- package/dist/sdk/extension/scaffold.d.ts +15 -15
- package/dist/sdk/extension/shared.d.ts +16 -16
- package/dist/sdk/extension/source-resolution.d.ts +16 -16
- package/dist/sdk/extension/static-inventory.d.ts +23 -23
- package/dist/sdk/extension/update-check.d.ts +9 -9
- package/dist/sdk/extension-command-context.d.ts +1 -1
- package/dist/sdk/extension-contracts.d.ts +10 -10
- package/dist/sdk/extension.d.ts +221 -221
- package/dist/sdk/files.d.ts +101 -101
- package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
- package/dist/sdk/flag-invocation-contracts.js +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
- package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
- package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
- package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
- package/dist/sdk/governance/assurance-action.d.ts +46 -46
- package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
- package/dist/sdk/governance/assurance-presets.d.ts +25 -25
- package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
- package/dist/sdk/governance/assurance.d.ts +204 -204
- package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
- package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
- package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
- package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
- package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
- package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
- package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
- package/dist/sdk/governance/defect-recurrence.js +2 -1
- package/dist/sdk/governance/extension-host-version.d.ts +9 -9
- package/dist/sdk/governance/gc.d.ts +26 -26
- package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
- package/dist/sdk/governance/health.d.ts +172 -172
- package/dist/sdk/governance/health.js +1 -1
- package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
- package/dist/sdk/governance/linked-file-report.d.ts +15 -15
- package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
- package/dist/sdk/governance/provenance-health.d.ts +35 -35
- package/dist/sdk/governance/reindex.d.ts +102 -102
- package/dist/sdk/governance/reliability.d.ts +29 -29
- package/dist/sdk/governance/stale-work.d.ts +13 -13
- package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
- package/dist/sdk/governance/storage-integrity.d.ts +28 -28
- package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
- package/dist/sdk/governance/upgrade.d.ts +77 -77
- package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
- package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
- package/dist/sdk/governance/validate-normalization.d.ts +4 -4
- package/dist/sdk/governance/validate.d.ts +176 -176
- package/dist/sdk/governance/validate.js +1 -1
- package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
- package/dist/sdk/governance/workflow-policy.d.ts +18 -18
- package/dist/sdk/governance/workspace-position.d.ts +40 -40
- package/dist/sdk/governance.d.ts +2 -2
- package/dist/sdk/graph/adapter.d.ts +45 -45
- package/dist/sdk/graph/analytics.d.ts +36 -36
- package/dist/sdk/graph/assembly.d.ts +51 -51
- package/dist/sdk/graph/cache.d.ts +19 -19
- package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
- package/dist/sdk/graph/centrality.d.ts +20 -20
- package/dist/sdk/graph/conformance.d.ts +21 -21
- package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
- package/dist/sdk/graph/durable-cache.d.ts +22 -22
- package/dist/sdk/graph/governance-contracts.d.ts +1 -1
- package/dist/sdk/graph/governance.d.ts +92 -92
- package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
- package/dist/sdk/graph/index.d.ts +15 -15
- package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
- package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
- package/dist/sdk/graph/query-contracts.d.ts +6 -6
- package/dist/sdk/graph/remediation.d.ts +15 -15
- package/dist/sdk/graph/run.d.ts +203 -203
- package/dist/sdk/graph/scheduling.d.ts +21 -21
- package/dist/sdk/graph/traversal.d.ts +18 -18
- package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
- package/dist/sdk/guide-topics.d.ts +19 -19
- package/dist/sdk/guide.d.ts +43 -43
- package/dist/sdk/history/attestation-command.d.ts +8 -8
- package/dist/sdk/history/attestation-contract.d.ts +43 -43
- package/dist/sdk/history/attestation-scan.d.ts +4 -4
- package/dist/sdk/history/attestation.d.ts +4 -4
- package/dist/sdk/history/maintenance.d.ts +25 -25
- package/dist/sdk/history/salvage.d.ts +19 -19
- package/dist/sdk/history/subject.d.ts +8 -8
- package/dist/sdk/history-analytics.d.ts +64 -64
- package/dist/sdk/history-compact.d.ts +67 -67
- package/dist/sdk/history-mcp.d.ts +7 -7
- package/dist/sdk/history-provenance.d.ts +40 -40
- package/dist/sdk/history-read.d.ts +24 -24
- package/dist/sdk/history-redact.d.ts +68 -68
- package/dist/sdk/history-repair.d.ts +92 -92
- package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
- package/dist/sdk/improvement-ledger.d.ts +62 -62
- package/dist/sdk/index.d.ts +69 -69
- package/dist/sdk/init-agent-guidance.d.ts +68 -68
- package/dist/sdk/init.d.ts +117 -117
- package/dist/sdk/invocation-author.d.ts +1 -1
- package/dist/sdk/item-children.d.ts +15 -15
- package/dist/sdk/item-metadata-index.d.ts +2 -2
- package/dist/sdk/item-schedule.d.ts +9 -9
- package/dist/sdk/item-transaction.d.ts +73 -73
- package/dist/sdk/learnings.d.ts +23 -23
- package/dist/sdk/lifecycle/append.d.ts +8 -8
- package/dist/sdk/lifecycle/claim.d.ts +38 -38
- package/dist/sdk/lifecycle/close-many.d.ts +71 -71
- package/dist/sdk/lifecycle/close.d.ts +18 -18
- package/dist/sdk/lifecycle/copy.d.ts +10 -10
- package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
- package/dist/sdk/lifecycle/create.d.ts +88 -88
- package/dist/sdk/lifecycle/delete.d.ts +15 -15
- package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
- package/dist/sdk/lifecycle/focus.d.ts +6 -6
- package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
- package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
- package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
- package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
- package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
- package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
- package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
- package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
- package/dist/sdk/lifecycle/plan.d.ts +127 -127
- package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
- package/dist/sdk/lifecycle/reopen.d.ts +15 -15
- package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
- package/dist/sdk/lifecycle/restore.d.ts +34 -34
- package/dist/sdk/lifecycle/restore.js +1 -1
- package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
- package/dist/sdk/lifecycle/task-composition.d.ts +7 -7
- package/dist/sdk/lifecycle/update-many.d.ts +61 -61
- package/dist/sdk/lifecycle/update.d.ts +120 -120
- package/dist/sdk/lifecycle-completion.d.ts +14 -14
- package/dist/sdk/lifecycle-policy.d.ts +31 -31
- package/dist/sdk/linked-artifacts.d.ts +58 -58
- package/dist/sdk/mcp/apps.d.ts +28 -28
- package/dist/sdk/mcp/authorization.d.ts +66 -66
- package/dist/sdk/mcp/discovery.d.ts +67 -67
- package/dist/sdk/mcp/interactions.d.ts +49 -49
- package/dist/sdk/mcp/protocol.d.ts +63 -63
- package/dist/sdk/mcp/skills.d.ts +62 -62
- package/dist/sdk/mcp/subscriptions.d.ts +26 -26
- package/dist/sdk/mcp/tasks.d.ts +51 -51
- package/dist/sdk/mcp/transport.d.ts +17 -17
- package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
- package/dist/sdk/merge/driver.d.ts +38 -38
- package/dist/sdk/merge/index.d.ts +5 -5
- package/dist/sdk/merge/install.d.ts +48 -48
- package/dist/sdk/merge/install.js +1 -1
- package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
- package/dist/sdk/merge/receipt-operation.d.ts +6 -6
- package/dist/sdk/merge/receipt-schema.d.ts +11 -11
- package/dist/sdk/merge/receipts.d.ts +111 -111
- package/dist/sdk/merge/reconcile.d.ts +20 -20
- package/dist/sdk/merge/three-way.d.ts +50 -50
- package/dist/sdk/merge/three-way.js +2 -2
- package/dist/sdk/merge/worktree-config.d.ts +3 -3
- package/dist/sdk/mutation-events.d.ts +62 -62
- package/dist/sdk/mutation-guard.d.ts +134 -134
- package/dist/sdk/notes.d.ts +28 -28
- package/dist/sdk/output/table-rows.d.ts +6 -6
- package/dist/sdk/output-contracts.d.ts +26 -26
- package/dist/sdk/output-projection.d.ts +108 -108
- package/dist/sdk/output-token-accounting.d.ts +18 -18
- package/dist/sdk/output.d.ts +18 -18
- package/dist/sdk/ownership-source.d.ts +1 -1
- package/dist/sdk/package-import-adapters.d.ts +51 -51
- package/dist/sdk/package-migrations.d.ts +3 -3
- package/dist/sdk/package-runtime-options.d.ts +3 -3
- package/dist/sdk/pagination.d.ts +28 -28
- package/dist/sdk/pagination.js +1 -1
- package/dist/sdk/profile.d.ts +72 -72
- package/dist/sdk/provenance.d.ts +37 -37
- package/dist/sdk/public-surface.json +1 -1
- package/dist/sdk/query/activity.d.ts +84 -84
- package/dist/sdk/query/aggregate.d.ts +109 -109
- package/dist/sdk/query/calendar.d.ts +95 -95
- package/dist/sdk/query/complete-list.d.ts +35 -35
- package/dist/sdk/query/context.d.ts +300 -300
- package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
- package/dist/sdk/query/get.d.ts +54 -54
- package/dist/sdk/query/history.d.ts +38 -38
- package/dist/sdk/query/item-filter-options.d.ts +41 -41
- package/dist/sdk/query/light-metadata.d.ts +1 -1
- package/dist/sdk/query/list-filter-shared.d.ts +4 -4
- package/dist/sdk/query/list.d.ts +167 -167
- package/dist/sdk/query/list.js +1 -1
- package/dist/sdk/query/multi-value-filters.d.ts +6 -6
- package/dist/sdk/query/next-ready-budget.d.ts +8 -8
- package/dist/sdk/query/next.d.ts +94 -94
- package/dist/sdk/query/parsers.d.ts +3 -3
- package/dist/sdk/query/projection-contracts.d.ts +18 -18
- package/dist/sdk/query/search/corpus.d.ts +15 -15
- package/dist/sdk/query/search/filters.d.ts +15 -15
- package/dist/sdk/query/search/input.d.ts +8 -8
- package/dist/sdk/query/search/lexical.d.ts +10 -10
- package/dist/sdk/query/search/response.d.ts +22 -22
- package/dist/sdk/query/search/semantic.d.ts +133 -133
- package/dist/sdk/query/search/types.d.ts +65 -65
- package/dist/sdk/query/search-contracts.d.ts +53 -53
- package/dist/sdk/query/search-pagination.d.ts +21 -21
- package/dist/sdk/query/search-rendering.d.ts +30 -30
- package/dist/sdk/query/search.d.ts +60 -60
- package/dist/sdk/query/workspace-contracts.d.ts +2 -2
- package/dist/sdk/query.d.ts +6 -6
- package/dist/sdk/read-output/continuation.d.ts +11 -11
- package/dist/sdk/read-output/extension.d.ts +3 -3
- package/dist/sdk/read-output/options.d.ts +7 -7
- package/dist/sdk/read-output/provenance.d.ts +6 -6
- package/dist/sdk/read-output-budget.d.ts +11 -11
- package/dist/sdk/read-output-contracts.d.ts +112 -112
- package/dist/sdk/read-output-contracts.js +1 -1
- package/dist/sdk/read-output-rows.d.ts +15 -15
- package/dist/sdk/read-output-session.d.ts +29 -29
- package/dist/sdk/relationship-analytics.d.ts +46 -46
- package/dist/sdk/relationship-context.d.ts +48 -48
- package/dist/sdk/relationship-history.d.ts +59 -59
- package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
- package/dist/sdk/relationship-migration.d.ts +14 -14
- package/dist/sdk/relationships.d.ts +46 -46
- package/dist/sdk/reproducibility/process.d.ts +9 -9
- package/dist/sdk/runtime/actions.d.ts +1 -1
- package/dist/sdk/runtime/context.d.ts +15 -15
- package/dist/sdk/runtime/schema-preview.d.ts +1 -1
- package/dist/sdk/runtime/schema.d.ts +1 -1
- package/dist/sdk/runtime-action-aliases.d.ts +3 -3
- package/dist/sdk/runtime-extended-actions.d.ts +9 -9
- package/dist/sdk/runtime-input.d.ts +29 -29
- package/dist/sdk/runtime-primitives.d.ts +54 -52
- package/dist/sdk/runtime-primitives.js +1 -1
- package/dist/sdk/runtime-public-contracts.d.ts +46 -46
- package/dist/sdk/runtime-stats-options.d.ts +1 -1
- package/dist/sdk/runtime.d.ts +374 -374
- package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
- package/dist/sdk/schema-migration.d.ts +79 -79
- package/dist/sdk/schema.d.ts +224 -224
- package/dist/sdk/search-refresh-worker.d.ts +1 -1
- package/dist/sdk/similarity-scoring.d.ts +10 -10
- package/dist/sdk/similarity.d.ts +73 -73
- package/dist/sdk/start-task-status.d.ts +1 -1
- package/dist/sdk/stats.d.ts +72 -72
- package/dist/sdk/structured-mutations.d.ts +13 -13
- package/dist/sdk/telemetry-flush.d.ts +1 -1
- package/dist/sdk/telemetry.d.ts +32 -32
- package/dist/sdk/templates.d.ts +35 -35
- package/dist/sdk/test/batch.d.ts +50 -50
- package/dist/sdk/test/command-args.d.ts +2 -2
- package/dist/sdk/test/entry.d.ts +4 -4
- package/dist/sdk/test/execution-receipts.d.ts +5 -5
- package/dist/sdk/test/execution.d.ts +247 -247
- package/dist/sdk/test/json-path.d.ts +4 -4
- package/dist/sdk/test/linked-command-detection.d.ts +36 -36
- package/dist/sdk/test/measurements.d.ts +10 -10
- package/dist/sdk/test/parsers.d.ts +18 -18
- package/dist/sdk/test/prerequisites.d.ts +3 -3
- package/dist/sdk/test/runs.d.ts +43 -43
- package/dist/sdk/test/trust.d.ts +15 -15
- package/dist/sdk/test/update.d.ts +23 -23
- package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
- package/dist/sdk/testing.d.ts +250 -246
- package/dist/sdk/testing.js +2 -2
- package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
- package/dist/sdk/traceability/source-traceability.d.ts +50 -50
- package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
- package/dist/sdk/workspace-contracts.d.ts +20 -20
- package/dist/sdk/workspace-memory.d.ts +42 -42
- package/dist/sdk/workspace-recipe.d.ts +9 -9
- package/dist/sdk/workspace-snapshot.d.ts +60 -60
- package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
- package/dist/sdk/workspace-transaction.d.ts +26 -26
- package/dist/sdk/workspace.d.ts +9 -9
- package/dist/types.d.ts +540 -540
- package/docs/COMMANDS.md +11 -2
- package/docs/CONFIGURATION.md +43 -0
- package/docs/DEFECT_RECURRENCE.md +8 -0
- package/docs/EXTENSIONS.md +1 -1
- package/docs/EXTENSION_AUTHOR_CONTRACTS.md +33 -0
- package/docs/LINKED_TEST_EDITS.md +15 -0
- package/docs/MERGE_SAFETY.md +8 -0
- package/docs/RELEASING.md +2 -0
- package/docs/SDK.md +19 -0
- package/docs/TESTING.md +21 -1
- package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +4 -3
- package/marketplace.json +1 -1
- package/package.json +3 -1
- package/packages/pm-beads/package.json +1 -1
- package/packages/pm-calendar/package.json +1 -1
- package/packages/pm-command-kit/package.json +1 -1
- package/packages/pm-digital-twin/package.json +1 -1
- package/packages/pm-governance-audit/package.json +1 -1
- package/packages/pm-guide-shell/package.json +1 -1
- package/packages/pm-kanban/package.json +1 -1
- package/packages/pm-lifecycle-hooks/package.json +1 -1
- package/packages/pm-linked-test-adapters/package.json +1 -1
- package/packages/pm-search-advanced/package.json +1 -1
- package/packages/pm-templates/package.json +1 -1
- package/packages/pm-todos/package.json +1 -1
- package/packages/pm-vcs/package.json +1 -1
- package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
- package/plugins/pm-claude/package.json +1 -1
- package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
- package/plugins/pm-codex/package.json +1 -1
- package/plugins/pm-codex/plugin.json +1 -1
- package/runtime-dependencies.json +1 -1
- package/scripts/finalize-build.mjs +9 -3
- package/dist/cli-bundle/chunks/chunk-DJDRHJBP.js +0 -234
- package/dist/cli-bundle/chunks/chunk-DUK5DHI6.js +0 -8
- package/dist/cli-bundle/chunks/chunk-IFPJDJUM.js +0 -20
- package/dist/cli-bundle/chunks/chunk-RL45OYTL.js +0 -6
- package/dist/cli-bundle/chunks/chunk-WYZGZV2M.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-F5J3ATMV.js +0 -165
- package/dist/cli-bundle/focused-chunks/chunk-IOTNG6CN.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-S6ITXQ5T.js +0 -20
- package/dist/cli-bundle/focused-chunks/chunk-UPJA45K7.js +0 -26
|
@@ -1,114 +1,114 @@
|
|
|
1
1
|
import type { RegisteredExtensionSchemaMigrationDefinition } from "../../core/extensions/extension-types.js";
|
|
2
|
-
import type { ExtensionCommandResult,
|
|
2
|
+
import type { ExtensionCommandResult,ExtensionScope } from "../extension.js";
|
|
3
3
|
/** Durable lifecycle state of one extension migration in one workspace. */
|
|
4
4
|
export type ExtensionMigrationOutcomeStatus = "applied" | "failed";
|
|
5
5
|
/** One durable extension-migration outcome. */
|
|
6
6
|
export interface ExtensionMigrationStateEntry {
|
|
7
7
|
/** Stable layer/name/id identity. */
|
|
8
|
-
key:
|
|
8
|
+
key:string;
|
|
9
9
|
/** Extension installation layer. */
|
|
10
|
-
layer:
|
|
10
|
+
layer:"global" | "project";
|
|
11
11
|
/** Owning extension name. */
|
|
12
|
-
extension:
|
|
12
|
+
extension:string;
|
|
13
13
|
/** Migration identifier declared by the extension. */
|
|
14
|
-
id:
|
|
14
|
+
id:string;
|
|
15
15
|
/** Last durable outcome. */
|
|
16
|
-
status:
|
|
16
|
+
status:ExtensionMigrationOutcomeStatus;
|
|
17
17
|
/** ISO timestamp for the last attempt. */
|
|
18
|
-
attempted_at:
|
|
18
|
+
attempted_at:string;
|
|
19
19
|
/** Failure text retained only for failed outcomes. */
|
|
20
|
-
error?:
|
|
20
|
+
error?:string;
|
|
21
21
|
}
|
|
22
22
|
/** Versioned workspace state for extension migrations. */
|
|
23
23
|
export interface ExtensionMigrationState {
|
|
24
24
|
/** Storage schema version. */
|
|
25
|
-
version:
|
|
25
|
+
version:1;
|
|
26
26
|
/** Last state change timestamp. */
|
|
27
|
-
updated_at:
|
|
27
|
+
updated_at:string;
|
|
28
28
|
/** Deterministically sorted outcomes. */
|
|
29
|
-
entries:
|
|
29
|
+
entries:ExtensionMigrationStateEntry[];
|
|
30
30
|
}
|
|
31
31
|
/** Planned or executed row returned for one registered migration. */
|
|
32
32
|
export interface ExtensionMigrationReceipt {
|
|
33
33
|
/** Stable layer/name/id identity. */
|
|
34
|
-
key:
|
|
34
|
+
key:string;
|
|
35
35
|
/** Extension installation layer. */
|
|
36
|
-
layer:
|
|
36
|
+
layer:"global" | "project";
|
|
37
37
|
/** Owning extension name. */
|
|
38
|
-
extension:
|
|
38
|
+
extension:string;
|
|
39
39
|
/** Migration identifier. */
|
|
40
|
-
id:
|
|
40
|
+
id:string;
|
|
41
41
|
/** State observed before this invocation. */
|
|
42
|
-
before:
|
|
42
|
+
before:"pending" | ExtensionMigrationOutcomeStatus;
|
|
43
43
|
/** Invocation outcome. */
|
|
44
|
-
outcome:
|
|
44
|
+
outcome:"pending" | "applied" | "skipped" | "failed";
|
|
45
45
|
/** Failure text for failed execution. */
|
|
46
|
-
error?:
|
|
46
|
+
error?:string;
|
|
47
47
|
}
|
|
48
48
|
/** Structured plan/application envelope for extension migrations. */
|
|
49
49
|
export interface ExtensionMigrationRunResult {
|
|
50
50
|
/** Whether the invocation executed no failing migration. */
|
|
51
|
-
ok:
|
|
51
|
+
ok:boolean;
|
|
52
52
|
/** Whether execution was suppressed. */
|
|
53
|
-
dry_run:
|
|
53
|
+
dry_run:boolean;
|
|
54
54
|
/** Durable state path. */
|
|
55
|
-
state_path:
|
|
55
|
+
state_path:string;
|
|
56
56
|
/** Total registered migrations in scope. */
|
|
57
|
-
total:
|
|
57
|
+
total:number;
|
|
58
58
|
/** Pending rows in the returned receipt. */
|
|
59
|
-
pending_count:
|
|
59
|
+
pending_count:number;
|
|
60
60
|
/** Applied rows in the returned receipt. */
|
|
61
|
-
applied_count:
|
|
61
|
+
applied_count:number;
|
|
62
62
|
/** Already-applied rows skipped idempotently. */
|
|
63
|
-
skipped_count:
|
|
63
|
+
skipped_count:number;
|
|
64
64
|
/** Failed rows in the returned receipt. */
|
|
65
|
-
failed_count:
|
|
65
|
+
failed_count:number;
|
|
66
66
|
/** Deterministically ordered per-migration receipts. */
|
|
67
|
-
migrations:
|
|
67
|
+
migrations:ExtensionMigrationReceipt[];
|
|
68
68
|
}
|
|
69
69
|
/** Options for planning or applying active extension migrations. */
|
|
70
70
|
export interface RunExtensionMigrationsOptions {
|
|
71
71
|
/** Tracker root that owns durable migration state. */
|
|
72
|
-
pmRoot:
|
|
72
|
+
pmRoot:string;
|
|
73
73
|
/** Active runtime registrations. */
|
|
74
|
-
migrations:
|
|
74
|
+
migrations:RegisteredExtensionSchemaMigrationDefinition[];
|
|
75
75
|
/** Audit author written to workspace history. */
|
|
76
|
-
author:
|
|
76
|
+
author:string;
|
|
77
77
|
/** Report pending work without invoking extension code. */
|
|
78
|
-
dryRun?:
|
|
78
|
+
dryRun?:boolean;
|
|
79
79
|
/** Limit execution and receipts to one installation layer. */
|
|
80
|
-
scope?:
|
|
80
|
+
scope?:"global" | "project";
|
|
81
81
|
}
|
|
82
82
|
/** Minimal lifecycle context required by the migration action dispatcher. */
|
|
83
83
|
export interface ExtensionMigrationActionContext {
|
|
84
84
|
/** Selected package scope. */
|
|
85
|
-
scope:
|
|
85
|
+
scope:ExtensionScope;
|
|
86
86
|
/** Tracker and settings roots for the invocation. */
|
|
87
|
-
resolvedRoots:
|
|
88
|
-
pm_root:
|
|
89
|
-
settings_root:
|
|
87
|
+
resolvedRoots:{
|
|
88
|
+
pm_root:string;
|
|
89
|
+
settings_root:string;
|
|
90
90
|
};
|
|
91
91
|
/** Mutable warning collection shared with the lifecycle result. */
|
|
92
|
-
warnings:
|
|
92
|
+
warnings:string[];
|
|
93
93
|
/** Migration-specific command options. */
|
|
94
|
-
options:
|
|
95
|
-
dryRun?:
|
|
94
|
+
options:{
|
|
95
|
+
dryRun?:boolean;
|
|
96
96
|
};
|
|
97
97
|
/** Relevant global runtime options. */
|
|
98
|
-
global:
|
|
99
|
-
noExtensions?:
|
|
100
|
-
author?:
|
|
98
|
+
global:{
|
|
99
|
+
noExtensions?:boolean;
|
|
100
|
+
author?:string;
|
|
101
101
|
};
|
|
102
102
|
/** Construct the standard extension lifecycle result envelope. */
|
|
103
|
-
withResult:
|
|
103
|
+
withResult:(details:Record<string,unknown>,ok?:boolean) => ExtensionCommandResult;
|
|
104
104
|
}
|
|
105
105
|
/** Return the durable workspace path for extension migration state. */
|
|
106
|
-
export declare function resolveExtensionMigrationStatePath(pmRoot:
|
|
106
|
+
export declare function resolveExtensionMigrationStatePath(pmRoot:string):string;
|
|
107
107
|
/** Read durable extension migration outcomes, degrading absent state to empty. */
|
|
108
|
-
export declare function readExtensionMigrationState(pmRoot:
|
|
108
|
+
export declare function readExtensionMigrationState(pmRoot:string):Promise<ExtensionMigrationState>;
|
|
109
109
|
/** Overlay durable outcomes onto freshly activated migration definitions. */
|
|
110
|
-
export declare function applyStoredExtensionMigrationState(pmRoot:
|
|
110
|
+
export declare function applyStoredExtensionMigrationState(pmRoot:string,migrations:RegisteredExtensionSchemaMigrationDefinition[]):Promise<ExtensionMigrationState>;
|
|
111
111
|
/** Plan or apply active extension migrations with durable idempotency receipts. */
|
|
112
|
-
export declare function runExtensionMigrations(options:
|
|
112
|
+
export declare function runExtensionMigrations(options:RunExtensionMigrationsOptions):Promise<ExtensionMigrationRunResult>;
|
|
113
113
|
/** Load active registrations and execute the extension lifecycle migrate action. */
|
|
114
|
-
export declare function runExtensionMigrateAction(context:
|
|
114
|
+
export declare function runExtensionMigrateAction(context:ExtensionMigrationActionContext):Promise<ExtensionCommandResult>;
|
|
@@ -1,31 +1,31 @@
|
|
|
1
1
|
interface OutputActivationSummary {
|
|
2
|
-
services:
|
|
3
|
-
overrides:
|
|
4
|
-
service:
|
|
5
|
-
layer:
|
|
6
|
-
name:
|
|
7
|
-
passThrough?:
|
|
2
|
+
services:{
|
|
3
|
+
overrides:Array<{
|
|
4
|
+
service:string;
|
|
5
|
+
layer:string;
|
|
6
|
+
name:string;
|
|
7
|
+
passThrough?:boolean;
|
|
8
8
|
}>;
|
|
9
9
|
};
|
|
10
|
-
renderers:
|
|
11
|
-
overrides:
|
|
12
|
-
format:
|
|
13
|
-
layer:
|
|
14
|
-
name:
|
|
15
|
-
commands?:
|
|
16
|
-
resultDiscriminator?:
|
|
10
|
+
renderers:{
|
|
11
|
+
overrides:Array<{
|
|
12
|
+
format:string;
|
|
13
|
+
layer:string;
|
|
14
|
+
name:string;
|
|
15
|
+
commands?:string[];
|
|
16
|
+
resultDiscriminator?:(result:unknown) => boolean;
|
|
17
17
|
}>;
|
|
18
18
|
};
|
|
19
19
|
}
|
|
20
20
|
interface OutputLoadSummary {
|
|
21
|
-
loaded:
|
|
22
|
-
layer:
|
|
23
|
-
name:
|
|
24
|
-
activation?:
|
|
25
|
-
commands?:
|
|
21
|
+
loaded:Array<{
|
|
22
|
+
layer:string;
|
|
23
|
+
name:string;
|
|
24
|
+
activation?:{
|
|
25
|
+
commands?:string[];
|
|
26
26
|
};
|
|
27
27
|
}>;
|
|
28
28
|
}
|
|
29
29
|
/** Collect doctor warnings for output overrides without an explicit command or result ownership boundary. */
|
|
30
|
-
export declare function collectGlobalOutputOverrideDoctorWarnings(activationResult:
|
|
30
|
+
export declare function collectGlobalOutputOverrideDoctorWarnings(activationResult:OutputActivationSummary,loadResult?:OutputLoadSummary):string[];
|
|
31
31
|
export {};
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
/** Return stable runtime command and action paths registered by one extension. */
|
|
2
|
-
export declare function summarizeRuntimeCommandPathsForExtension(extensionName:
|
|
3
|
-
name:
|
|
4
|
-
command_paths?:
|
|
5
|
-
action_paths?:
|
|
6
|
-
}>):
|
|
7
|
-
command_paths:
|
|
8
|
-
action_paths:
|
|
2
|
+
export declare function summarizeRuntimeCommandPathsForExtension(extensionName:string,installed:ReadonlyArray<{
|
|
3
|
+
name:string;
|
|
4
|
+
command_paths?:string[];
|
|
5
|
+
action_paths?:string[];
|
|
6
|
+
}>):{
|
|
7
|
+
command_paths:string[];
|
|
8
|
+
action_paths:string[];
|
|
9
9
|
};
|
|
@@ -1,26 +1,26 @@
|
|
|
1
1
|
/** Public contract for scaffold pm min version, shared by SDK and presentation-layer consumers. */
|
|
2
2
|
export declare const SCAFFOLD_PM_MIN_VERSION = "2026.6.24";
|
|
3
3
|
/** Capability shapes the package/extension scaffolder can target via the `--capability` selector — one per SDK extension capability, so every registration surface has a runnable starter. `commands` emits the default command-only starter; `hooks` additionally wires an `after_command` lifecycle reactor; `search` wires an in-memory provider/adapter pair; `importers` wires importer and exporter command primitives so authors can customize project context movement; `schema` registers a custom item type, item field, and migration so authors can model their own project domain; `profile` registers a complete project-profile archetype (item types, statuses, fields, a workflow, config, a template, and package recommendations) via `api.registerProfile` so `pm profile apply` can tailor a tracker in one shot; `renderers` overrides how a command's output is serialized for a format; `parser` rewrites a command's parsed options before its handler runs; `preflight` adjusts pm's pre-run migration/format gate decision; and `services` overrides a built-in pm service (e.g. output formatting) — without starting from a blank extension. */
|
|
4
|
-
export declare const SCAFFOLD_CAPABILITIES:
|
|
4
|
+
export declare const SCAFFOLD_CAPABILITIES:readonly ["commands","hooks","search","importers","schema","profile","renderers","parser","preflight","services"];
|
|
5
5
|
/**
|
|
6
6
|
* Restricts the `--capability` selector to a {@link SCAFFOLD_CAPABILITIES} value.
|
|
7
7
|
*/
|
|
8
8
|
export type ExtensionScaffoldCapability = (typeof SCAFFOLD_CAPABILITIES)[number];
|
|
9
9
|
interface ExtensionScaffoldFileResult {
|
|
10
|
-
path:
|
|
11
|
-
status:
|
|
10
|
+
path:string;
|
|
11
|
+
status:"created" | "unchanged";
|
|
12
12
|
}
|
|
13
13
|
interface ExtensionScaffoldResult {
|
|
14
|
-
extension_name:
|
|
15
|
-
package_name:
|
|
16
|
-
command_name:
|
|
17
|
-
invocation_command:
|
|
18
|
-
capability:
|
|
14
|
+
extension_name:string;
|
|
15
|
+
package_name:string;
|
|
16
|
+
command_name:string;
|
|
17
|
+
invocation_command:string;
|
|
18
|
+
capability:ExtensionScaffoldCapability;
|
|
19
19
|
/** Authoring style of the generated entrypoint: `"imperative"` (a hand-written `activate` body, the default) or `"declarative"` (a `composeExtension` blueprint). The declarative style is package-mode only (any capability). */
|
|
20
|
-
style:
|
|
21
|
-
target_path:
|
|
22
|
-
created_directory:
|
|
23
|
-
files:
|
|
20
|
+
style:ExtensionScaffoldStyle;
|
|
21
|
+
target_path:string;
|
|
22
|
+
created_directory:boolean;
|
|
23
|
+
files:ExtensionScaffoldFileResult[];
|
|
24
24
|
}
|
|
25
25
|
/**
|
|
26
26
|
* Authoring style the scaffolder targets for the generated entrypoint. The
|
|
@@ -30,9 +30,9 @@ files: ExtensionScaffoldFileResult[];
|
|
|
30
30
|
*/
|
|
31
31
|
export type ExtensionScaffoldStyle = "imperative" | "declarative";
|
|
32
32
|
/** Builds the starter command path from the normalized package/extension name. Names that start with a built-in pm command or executable alias are prefixed with `starter` so the generated command dispatches to the package instead of being consumed by core command parsing. */
|
|
33
|
-
export declare function buildScaffoldCommandName(extensionName:
|
|
33
|
+
export declare function buildScaffoldCommandName(extensionName:string):string;
|
|
34
34
|
/** Implements build starter extension scaffold files for the public runtime surface of this module. */
|
|
35
|
-
export declare function buildStarterExtensionScaffoldFiles(extensionName:
|
|
35
|
+
export declare function buildStarterExtensionScaffoldFiles(extensionName:string,commandName:string,_vocabulary:"extension" | "package",capability?:ExtensionScaffoldCapability,declarative?:boolean):Record<string,string>;
|
|
36
36
|
/** Implements scaffold extension project for the public runtime surface of this module. */
|
|
37
|
-
export declare function scaffoldExtensionProject(target:
|
|
37
|
+
export declare function scaffoldExtensionProject(target:string,vocabulary?:"extension" | "package",capability?:string,declarative?:boolean):Promise<ExtensionScaffoldResult>;
|
|
38
38
|
export {};
|
|
@@ -1,37 +1,37 @@
|
|
|
1
|
-
import { isCanonicalPathWithinDirectory,
|
|
1
|
+
import { isCanonicalPathWithinDirectory,type ExtensionManifest } from "../../core/extensions/loader.js";
|
|
2
2
|
export { isCanonicalPathWithinDirectory };
|
|
3
3
|
/** Documents the validated extension directory payload exchanged by command, SDK, and package integrations. */
|
|
4
4
|
export interface ValidatedExtensionDirectory {
|
|
5
5
|
/** Value that configures or reports directory for this contract. */
|
|
6
|
-
directory:
|
|
6
|
+
directory:string;
|
|
7
7
|
/** Filesystem path used for manifest resolution. */
|
|
8
|
-
manifest_path:
|
|
8
|
+
manifest_path:string;
|
|
9
9
|
/** Filesystem path used for entry resolution. */
|
|
10
|
-
entry_path:
|
|
10
|
+
entry_path:string;
|
|
11
11
|
/** Declarative package manifest consumed by the extension loader. */
|
|
12
|
-
manifest:
|
|
12
|
+
manifest:ExtensionManifest;
|
|
13
13
|
}
|
|
14
14
|
/** Optional install-source evidence used to make validation failures actionable. */
|
|
15
15
|
export interface ExtensionDirectoryValidationContext {
|
|
16
16
|
/** Source kind whose behavior explains a missing built artifact. */
|
|
17
|
-
source_kind?:
|
|
17
|
+
source_kind?:"github" | "local" | "npm";
|
|
18
18
|
/** Original source spelling shown in recovery guidance. */
|
|
19
|
-
source_input?:
|
|
19
|
+
source_input?:string;
|
|
20
20
|
/** Package root containing package.json for source-aware diagnostics. */
|
|
21
|
-
source_root?:
|
|
21
|
+
source_root?:string;
|
|
22
22
|
}
|
|
23
23
|
/** Implements normalize string list for the public runtime surface of this module. */
|
|
24
|
-
export declare function normalizeStringList(values:
|
|
24
|
+
export declare function normalizeStringList(values:readonly string[]):string[];
|
|
25
25
|
/** Implements normalize extension name for match for the public runtime surface of this module. */
|
|
26
|
-
export declare function normalizeExtensionNameForMatch(value:
|
|
26
|
+
export declare function normalizeExtensionNameForMatch(value:string):string;
|
|
27
27
|
/** Implements normalize managed directory name for the public runtime surface of this module. */
|
|
28
|
-
export declare function normalizeManagedDirectoryName(name:
|
|
28
|
+
export declare function normalizeManagedDirectoryName(name:string):string;
|
|
29
29
|
/** Implements parse extension manifest for the public runtime surface of this module. */
|
|
30
|
-
export declare function parseExtensionManifest(raw:
|
|
30
|
+
export declare function parseExtensionManifest(raw:unknown):ExtensionManifest | null;
|
|
31
31
|
/** Implements validate extension directory for the public runtime surface of this module. */
|
|
32
|
-
export declare function validateExtensionDirectory(directory:
|
|
33
|
-
declare function formatManifestReadError(error:
|
|
32
|
+
export declare function validateExtensionDirectory(directory:string,context?:ExtensionDirectoryValidationContext):Promise<ValidatedExtensionDirectory>;
|
|
33
|
+
declare function formatManifestReadError(error:unknown):string;
|
|
34
34
|
/** Public contract for test only extension shared, shared by SDK and presentation-layer consumers. */
|
|
35
|
-
export declare const _testOnlyExtensionShared:
|
|
36
|
-
formatManifestReadError:
|
|
35
|
+
export declare const _testOnlyExtensionShared:{
|
|
36
|
+
formatManifestReadError:typeof formatManifestReadError;
|
|
37
37
|
};
|
|
@@ -3,44 +3,44 @@ import type { ManagedExtensionRecord } from "./managed-state.js";
|
|
|
3
3
|
/** Selected install-source identity. */
|
|
4
4
|
export interface ExtensionInstallSourceSelection {
|
|
5
5
|
/** Selected source family. */
|
|
6
|
-
kind:
|
|
6
|
+
kind:"builtin" | "local" | "github" | "npm";
|
|
7
7
|
/** Canonical source input used for resolution. */
|
|
8
|
-
input:
|
|
8
|
+
input:string;
|
|
9
9
|
/** Canonical package name when known. */
|
|
10
|
-
package?:
|
|
10
|
+
package?:string;
|
|
11
11
|
}
|
|
12
12
|
/** One source candidate and the explicit command that selects it. */
|
|
13
13
|
export interface ExtensionInstallSourceCandidate extends ExtensionInstallSourceSelection {
|
|
14
14
|
/** Installed candidate version when known. */
|
|
15
|
-
version?:
|
|
15
|
+
version?:string;
|
|
16
16
|
/** Installed candidate directory when relevant. */
|
|
17
|
-
directory?:
|
|
17
|
+
directory?:string;
|
|
18
18
|
/** Unambiguous CLI command that selects this candidate. */
|
|
19
|
-
command:
|
|
19
|
+
command:string;
|
|
20
20
|
}
|
|
21
21
|
/** Machine-readable explanation of how one install target resolved. */
|
|
22
22
|
export interface ExtensionInstallSourceResolution {
|
|
23
23
|
/** Exact target supplied by the caller. */
|
|
24
|
-
requested:
|
|
24
|
+
requested:string;
|
|
25
25
|
/** Source selected by the deterministic resolver. */
|
|
26
|
-
selected:
|
|
26
|
+
selected:ExtensionInstallSourceSelection;
|
|
27
27
|
/** Whether another locally available source could satisfy the same bare name. */
|
|
28
|
-
ambiguous:
|
|
28
|
+
ambiguous:boolean;
|
|
29
29
|
/** Stable precedence rule used for the selection. */
|
|
30
|
-
precedence:
|
|
30
|
+
precedence:"bundled_alias_before_installed_npm";
|
|
31
31
|
/** Every matching candidate and its explicit install command. */
|
|
32
|
-
candidates:
|
|
32
|
+
candidates:ExtensionInstallSourceCandidate[];
|
|
33
33
|
}
|
|
34
34
|
/** Complete result of resolving one extension install target. */
|
|
35
35
|
export interface ResolvedExtensionInstallSource {
|
|
36
36
|
/** Normalized bundled alias, or null for non-bundled sources. */
|
|
37
|
-
bundledAliasName:
|
|
37
|
+
bundledAliasName:string | null;
|
|
38
38
|
/** Bundled package name, or null when unavailable. */
|
|
39
|
-
bundledPackageName:
|
|
39
|
+
bundledPackageName:string | null;
|
|
40
40
|
/** Parsed source passed to the install resolver. */
|
|
41
|
-
installSource:
|
|
41
|
+
installSource:InstallSource;
|
|
42
42
|
/** Observable source-selection decision. */
|
|
43
|
-
sourceResolution:
|
|
43
|
+
sourceResolution:ExtensionInstallSourceResolution;
|
|
44
44
|
}
|
|
45
45
|
/** Resolve bundled-alias provenance and competing installed npm identity. */
|
|
46
|
-
export declare function resolveExtensionInstallSourceIdentity(explicitSourceInput:
|
|
46
|
+
export declare function resolveExtensionInstallSourceIdentity(explicitSourceInput:string,githubOption:string | undefined,ref:string | undefined,managedEntries?:readonly ManagedExtensionRecord[]):Promise<ResolvedExtensionInstallSource>;
|
|
@@ -1,54 +1,54 @@
|
|
|
1
1
|
/** One read failure or malformed document that prevents a complete inventory. */
|
|
2
2
|
export interface StaticExtensionInventoryError {
|
|
3
3
|
/** Stable machine-readable reason. */
|
|
4
|
-
code:
|
|
4
|
+
code:"settings_invalid" | "settings_unreadable" | "managed_state_invalid" | "managed_state_unreadable" | "extensions_unreadable" | "manifest_invalid" | "manifest_unreadable";
|
|
5
5
|
/** File or directory whose read failed. */
|
|
6
|
-
path:
|
|
6
|
+
path:string;
|
|
7
7
|
}
|
|
8
8
|
/** A configured package; runtime activation has deliberately not been tested. */
|
|
9
9
|
export interface StaticExtensionInventoryEntry {
|
|
10
10
|
/** Manifest name, or directory name when the manifest is malformed. */
|
|
11
|
-
name:
|
|
11
|
+
name:string;
|
|
12
12
|
/** Extension directory basename. */
|
|
13
|
-
directory:
|
|
13
|
+
directory:string | null;
|
|
14
14
|
/** Selected storage scope. */
|
|
15
|
-
scope:
|
|
15
|
+
scope:"project" | "global";
|
|
16
16
|
/** Whether an installed directory was found. */
|
|
17
|
-
installed:
|
|
17
|
+
installed:boolean;
|
|
18
18
|
/** Installed, disabled, absent, or unreadable manifest outcome. */
|
|
19
|
-
status:
|
|
19
|
+
status:"installed" | "inactive" | "absent" | "malformed_manifest";
|
|
20
20
|
/** Effective configured state; null when settings cannot be trusted. */
|
|
21
|
-
configured_enabled:
|
|
21
|
+
configured_enabled:boolean | null;
|
|
22
22
|
/** Whether managed metadata identifies this install; null when that metadata is invalid. */
|
|
23
|
-
managed:
|
|
23
|
+
managed:boolean | null;
|
|
24
24
|
/** Runtime state is never inferred from configuration. */
|
|
25
|
-
runtime_active:
|
|
25
|
+
runtime_active:null;
|
|
26
26
|
/** Manifest version when available. */
|
|
27
|
-
version?:
|
|
27
|
+
version?:string;
|
|
28
28
|
}
|
|
29
29
|
/** A read-only inventory with explicit completeness and source receipts. */
|
|
30
30
|
export interface StaticExtensionInventoryResult {
|
|
31
31
|
/** Selected storage scope. */
|
|
32
|
-
scope:
|
|
32
|
+
scope:"project" | "global";
|
|
33
33
|
/** False if any source could not be read or parsed completely. */
|
|
34
|
-
complete:
|
|
34
|
+
complete:boolean;
|
|
35
35
|
/** Status of the two configuration sources. */
|
|
36
|
-
settings_status:
|
|
36
|
+
settings_status:"ok" | "absent" | "invalid" | "unreadable";
|
|
37
37
|
/** Status of the managed install metadata. */
|
|
38
|
-
managed_state_status:
|
|
38
|
+
managed_state_status:"ok" | "absent" | "invalid" | "unreadable";
|
|
39
39
|
/** Installed entries, or one absent entry for a missing requested name. */
|
|
40
|
-
extensions:
|
|
40
|
+
extensions:StaticExtensionInventoryEntry[];
|
|
41
41
|
/** Every failure that affected completeness. */
|
|
42
|
-
errors:
|
|
42
|
+
errors:StaticExtensionInventoryError[];
|
|
43
43
|
}
|
|
44
44
|
/** Read configured extension state through filesystem reads only. */
|
|
45
|
-
export declare function inspectStaticExtensionInventory(options:
|
|
45
|
+
export declare function inspectStaticExtensionInventory(options:{
|
|
46
46
|
/** Tracker root for the project scope. */
|
|
47
|
-
pmRoot:
|
|
47
|
+
pmRoot:string;
|
|
48
48
|
/** Storage scope; project is the default. */
|
|
49
|
-
scope?:
|
|
49
|
+
scope?:"project" | "global";
|
|
50
50
|
/** Optional name or directory to inspect, including absent installs. */
|
|
51
|
-
name?:
|
|
51
|
+
name?:string;
|
|
52
52
|
/** Base directory used to resolve the global PM root. */
|
|
53
|
-
cwd?:
|
|
54
|
-
}):
|
|
53
|
+
cwd?:string;
|
|
54
|
+
}):Promise<StaticExtensionInventoryResult>;
|
|
@@ -3,23 +3,23 @@ import { runGitCommand } from "./install-sources.js";
|
|
|
3
3
|
/** Describes the remote revision health of one managed GitHub extension. */
|
|
4
4
|
export interface GithubUpdateStatus {
|
|
5
5
|
/** Time at which the remote comparison completed. */
|
|
6
|
-
checked_at:
|
|
6
|
+
checked_at:string;
|
|
7
7
|
/** Whether the remote commit differs, or null when no comparison is possible. */
|
|
8
|
-
available:
|
|
8
|
+
available:boolean | null;
|
|
9
9
|
/** Peeled remote commit when the selected reference resolves. */
|
|
10
|
-
remote_commit?:
|
|
10
|
+
remote_commit?:string;
|
|
11
11
|
/** Stable failure reason when the comparison is incomplete. */
|
|
12
|
-
error?:
|
|
12
|
+
error?:string;
|
|
13
13
|
}
|
|
14
14
|
/** Result of comparing the installed npm identity with its registry latest dist-tag. */
|
|
15
|
-
export interface NpmUpdateStatus extends Omit<GithubUpdateStatus,
|
|
15
|
+
export interface NpmUpdateStatus extends Omit<GithubUpdateStatus,"remote_commit"> {
|
|
16
16
|
/** Registry version selected by the latest dist-tag, when valid. */
|
|
17
|
-
remote_version?:
|
|
17
|
+
remote_version?:string;
|
|
18
18
|
}
|
|
19
19
|
/** Query npm's configured registry with bounded execution and no lifecycle scripts. */
|
|
20
|
-
declare function runNpmUpdateQuery(args:
|
|
20
|
+
declare function runNpmUpdateQuery(args:string[],timeout:number):Promise<string>;
|
|
21
21
|
/** Compare recorded npm provenance without persisting diagnostic results or guessing missing versions. */
|
|
22
|
-
export declare function checkNpmUpdate(source:
|
|
22
|
+
export declare function checkNpmUpdate(source:ManagedExtensionSource,npmRunner?:typeof runNpmUpdateQuery):Promise<NpmUpdateStatus>;
|
|
23
23
|
/** Compare one managed GitHub extension against its remote revision. */
|
|
24
|
-
export declare const checkGithubUpdate:
|
|
24
|
+
export declare const checkGithubUpdate:(source:ManagedExtensionSource,gitCommandRunner?:typeof runGitCommand) => Promise<GithubUpdateStatus>;
|
|
25
25
|
export {};
|
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
import type { ExtensionCommandSdk } from "../core/extensions/extension-types.js";
|
|
2
2
|
import type { PmClient } from "./runtime.js";
|
|
3
3
|
/** Bind public SDK services to one tracker and one caller-owned client. */
|
|
4
|
-
export declare function createExtensionCommandSdk(pmRoot:
|
|
4
|
+
export declare function createExtensionCommandSdk(pmRoot:string,client:PmClient,invocationAuthor?:string,invocationCommand?:string):ExtensionCommandSdk;
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* Publishes the stable extension capability vocabulary without loading the
|
|
5
5
|
* aggregate SDK entrypoint.
|
|
6
6
|
*/
|
|
7
|
-
import { EXTENSION_CAPABILITY_CONTRACT,
|
|
7
|
+
import { EXTENSION_CAPABILITY_CONTRACT,EXTENSION_CAPABILITY_CONTRACT_VERSION,EXTENSION_CAPABILITY_LEGACY_ALIASES,type FlagDefinition } from "../core/extensions/loader.js";
|
|
8
8
|
import { type CommanderOptionAliasContract } from "./cli-contracts/commander-types.js";
|
|
9
9
|
import { type CliFlagContract } from "./cli-contracts/flag-contracts.js";
|
|
10
10
|
/**
|
|
@@ -13,17 +13,17 @@ import { type CliFlagContract } from "./cli-contracts/flag-contracts.js";
|
|
|
13
13
|
* Extension manifests should declare one or more of these values in
|
|
14
14
|
* `capabilities`.
|
|
15
15
|
*/
|
|
16
|
-
export declare const EXTENSION_CAPABILITIES:
|
|
16
|
+
export declare const EXTENSION_CAPABILITIES:readonly ["commands","renderers","hooks","schema","importers","search","parser","preflight","services"];
|
|
17
17
|
/** Restricts extension capability values accepted by command, SDK, and storage contracts. */
|
|
18
18
|
export type ExtensionCapability = (typeof EXTENSION_CAPABILITIES)[number];
|
|
19
19
|
/** Canonical extension governance policy modes. */
|
|
20
|
-
export declare const EXTENSION_POLICY_MODES:
|
|
20
|
+
export declare const EXTENSION_POLICY_MODES:readonly ["off","warn","enforce"];
|
|
21
21
|
/** Canonical extension registration surfaces governed by policy. */
|
|
22
|
-
export declare const EXTENSION_POLICY_SURFACES:
|
|
22
|
+
export declare const EXTENSION_POLICY_SURFACES:readonly ["commands.override","commands.handler","hooks.beforecommand","hooks.beforemutation","hooks.aftercommand","hooks.onwrite","hooks.onread","hooks.onindex","schema.flags","schema.itemfields","schema.itemtypes","schema.relationshipkinds","schema.migrations","schema.profiles","parser.override","preflight.override","services.override","renderers.override","importers.importer","importers.exporter","search.provider","search.vectorstore","services.assuranceprovider"];
|
|
23
23
|
/** Canonical extension trust modes shared by authoring and runtime consumers. */
|
|
24
|
-
export declare const EXTENSION_TRUST_MODES:
|
|
24
|
+
export declare const EXTENSION_TRUST_MODES:readonly ["off","warn","enforce"];
|
|
25
25
|
/** Canonical extension sandbox profiles shared by authoring and runtime consumers. */
|
|
26
|
-
export declare const EXTENSION_SANDBOX_PROFILES:
|
|
26
|
+
export declare const EXTENSION_SANDBOX_PROFILES:readonly ["none","restricted","strict"];
|
|
27
27
|
/** Restricts extension policy mode values accepted by command, SDK, and storage contracts. */
|
|
28
28
|
export type ExtensionPolicyMode = (typeof EXTENSION_POLICY_MODES)[number];
|
|
29
29
|
/** Restricts extension policy surface values accepted by command, SDK, and storage contracts. */
|
|
@@ -42,10 +42,10 @@ export type ExtensionSandboxProfile = (typeof EXTENSION_SANDBOX_PROFILES)[number
|
|
|
42
42
|
* behavior single-sourced while giving package authors the exact shape
|
|
43
43
|
* accepted by `api.registerCommand` and `api.registerFlags`.
|
|
44
44
|
*/
|
|
45
|
-
export declare function toExtensionFlagDefinitions(contracts:
|
|
45
|
+
export declare function toExtensionFlagDefinitions(contracts:readonly CliFlagContract[],stringOptions?:readonly CommanderOptionAliasContract[]):FlagDefinition[];
|
|
46
46
|
/** Extension-ready form of the canonical list/filter flag baseline. */
|
|
47
|
-
export declare const LIST_FILTER_EXTENSION_FLAG_DEFINITIONS:
|
|
47
|
+
export declare const LIST_FILTER_EXTENSION_FLAG_DEFINITIONS:FlagDefinition[];
|
|
48
48
|
/** Extension-ready form of the canonical search flag baseline. */
|
|
49
|
-
export declare const SEARCH_EXTENSION_FLAG_DEFINITIONS:
|
|
49
|
+
export declare const SEARCH_EXTENSION_FLAG_DEFINITIONS:FlagDefinition[];
|
|
50
50
|
/** Versioned capability contract metadata emitted by runtime diagnostics. */
|
|
51
|
-
export { EXTENSION_CAPABILITY_CONTRACT,
|
|
51
|
+
export { EXTENSION_CAPABILITY_CONTRACT,EXTENSION_CAPABILITY_CONTRACT_VERSION,EXTENSION_CAPABILITY_LEGACY_ALIASES,};
|