@unbrained/pm-cli 2026.10.14 → 2026.10.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +1 -1
- package/CHANGELOG.md +54 -2
- package/dist/cli/after-command-context-usage.d.ts +7 -7
- package/dist/cli/argv-utils.d.ts +4 -4
- package/dist/cli/bundle-integrity.d.ts +16 -16
- package/dist/cli/command-namespaces.d.ts +1 -1
- package/dist/cli/commander-usage.d.ts +34 -34
- package/dist/cli/commands/governance/validate.d.ts +1 -1
- package/dist/cli/commands/history/history-compact.d.ts +1 -1
- package/dist/cli/commands/history/history-redact.d.ts +1 -1
- package/dist/cli/commands/history/history-repair.d.ts +1 -1
- package/dist/cli/commands/history/restore.d.ts +1 -1
- package/dist/cli/commands/lifecycle/close.d.ts +1 -1
- package/dist/cli/commands/lifecycle/copy.d.ts +1 -1
- package/dist/cli/commands/lifecycle/delete.d.ts +1 -1
- package/dist/cli/commands/lifecycle/focus.d.ts +1 -1
- package/dist/cli/commands/query/get.d.ts +1 -1
- package/dist/cli/commands/workspace/merge.d.ts +1 -1
- package/dist/cli/commands/workspace/schema.d.ts +1 -1
- package/dist/cli/context-intent-invocation.d.ts +1 -1
- package/dist/cli/description-stdin.d.ts +1 -1
- package/dist/cli/error-guidance.d.ts +119 -119
- package/dist/cli/extension-command-help.d.ts +64 -64
- package/dist/cli/extension-command-help.js +2 -2
- package/dist/cli/extension-command-options.d.ts +16 -16
- package/dist/cli/extension-recovery.d.ts +13 -13
- package/dist/cli/help-content.d.ts +22 -22
- package/dist/cli/help-content.js +2 -2
- package/dist/cli/help-json-payload.d.ts +45 -45
- package/dist/cli/invocation-profile.d.ts +5 -5
- package/dist/cli/main.d.ts +217 -217
- package/dist/cli/migration-gates.d.ts +24 -24
- package/dist/cli/option-values.d.ts +1 -1
- package/dist/cli/public.d.ts +1 -1
- package/dist/cli/register-annotations.d.ts +2 -2
- package/dist/cli/register-assurance.d.ts +1 -1
- package/dist/cli/register-files-lookup.d.ts +1 -1
- package/dist/cli/register-history-activity.d.ts +1 -1
- package/dist/cli/register-history-author.d.ts +1 -1
- package/dist/cli/register-history-maintenance.d.ts +1 -1
- package/dist/cli/register-list-query.d.ts +7 -7
- package/dist/cli/register-list-query.js +3 -3
- package/dist/cli/register-mutation-options.d.ts +1 -1
- package/dist/cli/register-mutation.d.ts +4 -4
- package/dist/cli/register-operations.d.ts +75 -75
- package/dist/cli/register-setup.d.ts +4 -4
- package/dist/cli/register-structured-mutation.d.ts +8 -8
- package/dist/cli/runtime/activation.d.ts +23 -23
- package/dist/cli/runtime/invocation-options.d.ts +12 -12
- package/dist/cli/runtime/projection-retry.d.ts +1 -1
- package/dist/cli/runtime/selection.d.ts +16 -16
- package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
- package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
- package/dist/cli/schema/registration.d.ts +1 -1
- package/dist/cli/schema-registration-helpers.d.ts +2 -2
- package/dist/cli/stats-analytics-json.d.ts +1 -1
- package/dist/cli-bundle/bundle-manifest.json +1 -1
- package/dist/cli-bundle/chunks/{chunk-5LU6PWA4.js → chunk-52EZH2QQ.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-7OEGNA4X.js +20 -0
- package/dist/cli-bundle/chunks/{chunk-LKESCZEN.js → chunk-7VHINXZP.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-EMEEHV2Y.js +2 -0
- package/dist/cli-bundle/chunks/chunk-JGKTOBVB.js +6 -0
- package/dist/cli-bundle/chunks/{chunk-PP3BVMFL.js → chunk-JSUJWIHQ.js} +30 -30
- package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-LNKLQYBG.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-N56CAQBU.js} +63 -64
- package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-NC3QVGDD.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-RJ5N44WY.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-LOSRTNNP.js → chunk-VIMQCFCK.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-WBBW3WQX.js} +4 -4
- package/dist/cli-bundle/chunks/chunk-X2H6UR26.js +236 -0
- package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-FKKFQ66D.js} +7 -7
- package/dist/cli-bundle/chunks/{register-mutation-TNRHNK4N.js → register-mutation-EWMMVZJB.js} +2 -2
- package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-GEQ2H7PS.js} +2 -2
- package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-PSJTQBBO.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-3RNUMVK4.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-4KQFMOM7.js} +6 -6
- package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-52I2SNKJ.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-5KRACGBK.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-5OO54BIV.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-LKWDWER4.js → chunk-5TBAVZDR.js} +14 -14
- package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-FQKPOZKS.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-H3P77KVU.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-HTA3TNC3.js +26 -0
- package/dist/cli-bundle/focused-chunks/{chunk-23ACMPGB.js → chunk-JKBH7YGX.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-KIIFVULU.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-N6FUKTZS.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-PDYE7QDX.js +166 -0
- package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-Q4VNCTR2.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-THYQR3ON.js} +61 -62
- package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-TYLG5VEB.js} +2 -2
- package/dist/cli-bundle/main.js +26 -26
- package/dist/cli-bundle/sdk-authoring.js +1 -1
- package/dist/cli-bundle/sdk-contracts.js +2 -2
- package/dist/cli-bundle/sdk-core.js +22 -22
- package/dist/cli-bundle/sdk-governance.js +1 -1
- package/dist/cli-bundle/sdk-graph.js +1 -1
- package/dist/cli-bundle/sdk-merge.js +51 -51
- package/dist/cli-bundle/sdk-query.js +1 -1
- package/dist/cli-bundle/sdk-runtime.js +1 -1
- package/dist/cli-bundle/sdk-testing.js +1 -1
- package/dist/cli-bundle/sdk.js +7 -7
- package/dist/cli.d.ts +9 -9
- package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
- package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
- package/dist/core/config/nested-settings.d.ts +20 -20
- package/dist/core/config/positional-value.d.ts +9 -9
- package/dist/core/diagnostics/remediation.d.ts +7 -7
- package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
- package/dist/core/extensions/activation-summary.d.ts +30 -30
- package/dist/core/extensions/activation-transaction.d.ts +9 -9
- package/dist/core/extensions/capability-usage.d.ts +25 -25
- package/dist/core/extensions/command-hook-context.d.ts +15 -15
- package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
- package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
- package/dist/core/extensions/contribution-inventory.d.ts +24 -24
- package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
- package/dist/core/extensions/extension-candidate.d.ts +14 -14
- package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
- package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
- package/dist/core/extensions/extension-policy.d.ts +62 -62
- package/dist/core/extensions/extension-registries.d.ts +8 -8
- package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
- package/dist/core/extensions/extension-types.d.ts +702 -702
- package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
- package/dist/core/extensions/flag-value-types.d.ts +16 -4
- package/dist/core/extensions/flag-value-types.js +1 -1
- package/dist/core/extensions/index.d.ts +34 -34
- package/dist/core/extensions/item-field-types.d.ts +3 -3
- package/dist/core/extensions/item-fields.d.ts +6 -6
- package/dist/core/extensions/loader.d.ts +66 -66
- package/dist/core/extensions/manifest-parser.d.ts +1 -1
- package/dist/core/extensions/manifest-schema.d.ts +13 -13
- package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
- package/dist/core/extensions/preflight-ownership.d.ts +3 -3
- package/dist/core/extensions/read-output-contract.d.ts +2 -2
- package/dist/core/extensions/registration-contracts.d.ts +12 -12
- package/dist/core/extensions/registration-validation.d.ts +6 -6
- package/dist/core/extensions/registration-values.d.ts +19 -19
- package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
- package/dist/core/extensions/runtime-registrations.d.ts +6 -6
- package/dist/core/extensions/service-ownership.d.ts +1 -1
- package/dist/core/extensions/version-compat.d.ts +9 -9
- package/dist/core/fs/atomic-create.d.ts +1 -1
- package/dist/core/fs/fs-utils.d.ts +12 -12
- package/dist/core/fs/host-environment-errors.d.ts +10 -10
- package/dist/core/fs/path-utils.d.ts +1 -1
- package/dist/core/governance/content-fields.d.ts +25 -25
- package/dist/core/governance/issue-codes.d.ts +16 -16
- package/dist/core/governance/metadata-coverage.d.ts +64 -64
- package/dist/core/history/digest.d.ts +5 -5
- package/dist/core/history/drift-cache.d.ts +2 -2
- package/dist/core/history/drift-scan.d.ts +18 -18
- package/dist/core/history/event-classification.d.ts +4 -4
- package/dist/core/history/event-index.d.ts +33 -33
- package/dist/core/history/history-compact-bulk.d.ts +12 -12
- package/dist/core/history/history-diff.d.ts +15 -15
- package/dist/core/history/history-rewrite.d.ts +43 -43
- package/dist/core/history/history-storage-stats.d.ts +20 -20
- package/dist/core/history/history-stream-policy.d.ts +12 -12
- package/dist/core/history/history.d.ts +45 -45
- package/dist/core/history/identity.d.ts +4 -4
- package/dist/core/history/operation-contract.d.ts +17 -17
- package/dist/core/history/projection.d.ts +16 -16
- package/dist/core/history/read.d.ts +4 -4
- package/dist/core/history/replay.d.ts +47 -47
- package/dist/core/history/tombstone.d.ts +1 -1
- package/dist/core/history/version-address.d.ts +2 -2
- package/dist/core/history/workspace-history.d.ts +72 -72
- package/dist/core/io/body-file.d.ts +2 -2
- package/dist/core/io/bulk-ids-input.d.ts +7 -7
- package/dist/core/item/actionability.d.ts +30 -30
- package/dist/core/item/dependency-reference.d.ts +2 -2
- package/dist/core/item/id.d.ts +9 -9
- package/dist/core/item/item-format-version.d.ts +17 -15
- package/dist/core/item/item-format-version.js +1 -1
- package/dist/core/item/item-format.d.ts +54 -54
- package/dist/core/item/item-record.d.ts +1 -1
- package/dist/core/item/item-type-definition.d.ts +11 -11
- package/dist/core/item/parent-reference-policy.d.ts +6 -6
- package/dist/core/item/parse.d.ts +37 -37
- package/dist/core/item/plan-lifecycle.d.ts +4 -4
- package/dist/core/item/priority.d.ts +3 -3
- package/dist/core/item/sprint-release-format.d.ts +4 -4
- package/dist/core/item/status-filter.d.ts +5 -5
- package/dist/core/item/status.d.ts +3 -3
- package/dist/core/item/toon-decode.d.ts +10 -10
- package/dist/core/item/type-registry.d.ts +35 -35
- package/dist/core/item/type-synonyms.d.ts +2 -2
- package/dist/core/lock/lock-gc.d.ts +28 -28
- package/dist/core/lock/lock.d.ts +53 -53
- package/dist/core/output/mutation-projection.d.ts +4 -4
- package/dist/core/output/output-control.d.ts +4 -4
- package/dist/core/output/output.d.ts +30 -30
- package/dist/core/output/query-summary.d.ts +5 -5
- package/dist/core/output/tabular.d.ts +3 -3
- package/dist/core/packages/manifest.d.ts +30 -30
- package/dist/core/packages/root.d.ts +4 -4
- package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
- package/dist/core/policy/workflow-policy-store.d.ts +15 -15
- package/dist/core/policy/workflow-policy.d.ts +56 -56
- package/dist/core/profile/profile-describe.d.ts +22 -22
- package/dist/core/profile/profile-lint.d.ts +13 -13
- package/dist/core/profile/profile-plan.d.ts +45 -45
- package/dist/core/profile/profile-presets.d.ts +36 -36
- package/dist/core/reproducibility/context.d.ts +9 -9
- package/dist/core/schema/fields-file.d.ts +35 -35
- package/dist/core/schema/item-types-file.d.ts +29 -29
- package/dist/core/schema/runtime-field-filters.d.ts +3 -3
- package/dist/core/schema/runtime-field-values.d.ts +7 -7
- package/dist/core/schema/runtime-schema.d.ts +59 -59
- package/dist/core/schema/status-defs-file.d.ts +29 -29
- package/dist/core/schema/status-token.d.ts +1 -1
- package/dist/core/schema/type-inference.d.ts +10 -10
- package/dist/core/schema/type-presets.d.ts +5 -5
- package/dist/core/schema/type-workflows.d.ts +14 -14
- package/dist/core/search/background-refresh.d.ts +12 -12
- package/dist/core/search/bm25.d.ts +16 -16
- package/dist/core/search/cache.d.ts +34 -34
- package/dist/core/search/corpus.d.ts +17 -17
- package/dist/core/search/embedding-batches.d.ts +25 -25
- package/dist/core/search/eval-thresholds.d.ts +4 -4
- package/dist/core/search/eval.d.ts +40 -40
- package/dist/core/search/http-client.d.ts +24 -24
- package/dist/core/search/providers.d.ts +30 -30
- package/dist/core/search/relevance.d.ts +17 -17
- package/dist/core/search/semantic-defaults.d.ts +5 -5
- package/dist/core/search/staleness.d.ts +3 -3
- package/dist/core/search/vector-stores.d.ts +51 -51
- package/dist/core/search/vectorization-metadata.d.ts +9 -9
- package/dist/core/sentry/helpers.d.ts +27 -27
- package/dist/core/sentry/instrument.d.ts +51 -51
- package/dist/core/sentry/instrument.js +1 -1
- package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
- package/dist/core/sentry/sensitive-assignments.js +2 -0
- package/dist/core/session/session-state.d.ts +37 -37
- package/dist/core/shared/agent-session-context.d.ts +14 -14
- package/dist/core/shared/author.d.ts +89 -89
- package/dist/core/shared/command-line.d.ts +3 -3
- package/dist/core/shared/command-types.d.ts +20 -20
- package/dist/core/shared/conflict-markers.d.ts +5 -5
- package/dist/core/shared/constants.d.ts +30 -30
- package/dist/core/shared/errors.d.ts +100 -100
- package/dist/core/shared/html-entity-decode.d.ts +2 -2
- package/dist/core/shared/item-metadata-contract.d.ts +2 -2
- package/dist/core/shared/lazy-module.d.ts +1 -1
- package/dist/core/shared/levenshtein.d.ts +1 -1
- package/dist/core/shared/memo.d.ts +1 -1
- package/dist/core/shared/numeric-parsers.d.ts +1 -1
- package/dist/core/shared/option-alias-visibility.d.ts +3 -3
- package/dist/core/shared/primitives.d.ts +13 -13
- package/dist/core/shared/secret-rules.d.ts +92 -92
- package/dist/core/shared/serial-queue.d.ts +6 -6
- package/dist/core/shared/serialization.d.ts +4 -4
- package/dist/core/shared/split-comma-list.d.ts +4 -4
- package/dist/core/shared/text-normalization.d.ts +3 -3
- package/dist/core/shared/time.d.ts +27 -27
- package/dist/core/store/item-format-migration.d.ts +7 -7
- package/dist/core/store/item-metadata-cache.d.ts +30 -30
- package/dist/core/store/item-metadata-query-index.d.ts +66 -66
- package/dist/core/store/item-metadata-read-work.d.ts +6 -6
- package/dist/core/store/item-store.d.ts +123 -123
- package/dist/core/store/item-store.js +1 -1
- package/dist/core/store/paths.d.ts +27 -27
- package/dist/core/store/settings-concurrency.d.ts +1 -1
- package/dist/core/store/settings-read-cache.d.ts +11 -11
- package/dist/core/store/settings-validator.d.ts +117 -117
- package/dist/core/store/settings.d.ts +84 -84
- package/dist/core/store/sqlite-runtime.d.ts +2 -2
- package/dist/core/store/tracker-preflight.d.ts +3 -3
- package/dist/core/telemetry/consent.d.ts +1 -1
- package/dist/core/telemetry/observability.d.ts +16 -16
- package/dist/core/telemetry/policy.d.ts +7 -7
- package/dist/core/telemetry/read-sampling.d.ts +1 -1
- package/dist/core/telemetry/runtime.d.ts +275 -275
- package/dist/core/test/background-runs.d.ts +123 -123
- package/dist/core/test/item-test-run-tracking.d.ts +10 -10
- package/dist/core/test/run-selectors.d.ts +12 -12
- package/dist/core/validate/estimate-defaults.d.ts +3 -3
- package/dist/core/validate/fix-planning.d.ts +36 -36
- package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
- package/dist/core/validate/missing-by-type.d.ts +3 -3
- package/dist/core/validate/missing-link-owners.d.ts +17 -17
- package/dist/core/validate/stale-file-classification.d.ts +6 -6
- package/dist/mcp/http-server.d.ts +26 -26
- package/dist/mcp/legacy-adapter.d.ts +18 -18
- package/dist/mcp/runtime-capabilities.d.ts +18 -18
- package/dist/mcp/server.d.ts +73 -73
- package/dist/mcp/tool-definitions.d.ts +27 -27
- package/dist/sdk/actionability.d.ts +1 -1
- package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
- package/dist/sdk/agent/command-recovery.d.ts +5 -5
- package/dist/sdk/agent/command-suggestions.d.ts +4 -4
- package/dist/sdk/agent/create-option-policy.d.ts +2 -2
- package/dist/sdk/agent/identity-config.d.ts +18 -18
- package/dist/sdk/agent/item-addressing.d.ts +6 -6
- package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
- package/dist/sdk/agent/refusal-closure.d.ts +22 -22
- package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
- package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
- package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
- package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
- package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
- package/dist/sdk/agent-capability-contracts.d.ts +41 -41
- package/dist/sdk/agent-session-context.d.ts +1 -1
- package/dist/sdk/annotations.d.ts +74 -74
- package/dist/sdk/author-attribution.d.ts +47 -47
- package/dist/sdk/authoring.d.ts +9 -9
- package/dist/sdk/cli-bootstrap.d.ts +65 -65
- package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
- package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
- package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
- package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
- package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
- package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
- package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
- package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
- package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
- package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
- package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
- package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
- package/dist/sdk/cli-contracts/registration-helpers.d.ts +56 -56
- package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
- package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
- package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
- package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
- package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
- package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
- package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
- package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
- package/dist/sdk/cli-contracts.d.ts +15 -15
- package/dist/sdk/cli-program.d.ts +1 -1
- package/dist/sdk/cli-program.js +1 -1
- package/dist/sdk/command-line.d.ts +3 -3
- package/dist/sdk/comments.d.ts +24 -24
- package/dist/sdk/compile-cache.d.ts +4 -4
- package/dist/sdk/completion/bash.d.ts +1 -1
- package/dist/sdk/completion/fish.d.ts +1 -1
- package/dist/sdk/completion/shared.d.ts +74 -74
- package/dist/sdk/completion/zsh.d.ts +1 -1
- package/dist/sdk/completion.d.ts +3 -3
- package/dist/sdk/compose.d.ts +94 -94
- package/dist/sdk/config.d.ts +105 -105
- package/dist/sdk/context/recency.d.ts +1 -1
- package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
- package/dist/sdk/context/usage-egress.d.ts +1 -1
- package/dist/sdk/context/usage-ledger.d.ts +18 -18
- package/dist/sdk/context-intent-contracts.d.ts +37 -37
- package/dist/sdk/context-intent-runtime.d.ts +10 -10
- package/dist/sdk/context-packing.d.ts +44 -44
- package/dist/sdk/context-relevance.d.ts +110 -110
- package/dist/sdk/context-signal-store.d.ts +52 -52
- package/dist/sdk/context-usage.d.ts +78 -78
- package/dist/sdk/contracts.d.ts +2 -1
- package/dist/sdk/contracts.js +1 -1
- package/dist/sdk/core-governance.d.ts +5 -5
- package/dist/sdk/core.d.ts +8 -8
- package/dist/sdk/corpus-shape.d.ts +60 -60
- package/dist/sdk/define.d.ts +36 -36
- package/dist/sdk/dependencies.d.ts +70 -70
- package/dist/sdk/dependency-flag-validation.d.ts +17 -17
- package/dist/sdk/dependency-provenance.d.ts +22 -22
- package/dist/sdk/docs.d.ts +17 -17
- package/dist/sdk/duplicates.d.ts +14 -14
- package/dist/sdk/environment/agent-environment.d.ts +118 -118
- package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
- package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
- package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
- package/dist/sdk/environment/source-context.d.ts +4 -4
- package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
- package/dist/sdk/error-code-catalog.d.ts +33 -33
- package/dist/sdk/error-runtime.d.ts +5 -5
- package/dist/sdk/errors.d.ts +17 -17
- package/dist/sdk/eval.d.ts +27 -27
- package/dist/sdk/extension/author-manifest.d.ts +9 -9
- package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
- package/dist/sdk/extension/concurrency.d.ts +1 -1
- package/dist/sdk/extension/copy-scope.d.ts +1 -1
- package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
- package/dist/sdk/extension/describe.d.ts +21 -21
- package/dist/sdk/extension/doctor.d.ts +46 -46
- package/dist/sdk/extension/install-plan.d.ts +32 -32
- package/dist/sdk/extension/install-receipts.d.ts +4 -4
- package/dist/sdk/extension/install-runtime.d.ts +12 -12
- package/dist/sdk/extension/install-snapshot.d.ts +10 -10
- package/dist/sdk/extension/install-sources.d.ts +106 -106
- package/dist/sdk/extension/managed-state.d.ts +42 -42
- package/dist/sdk/extension/managed-update-status.d.ts +1 -1
- package/dist/sdk/extension/migrations.d.ts +48 -48
- package/dist/sdk/extension/output-ownership.d.ts +19 -19
- package/dist/sdk/extension/runtime-summary.d.ts +7 -7
- package/dist/sdk/extension/scaffold.d.ts +15 -15
- package/dist/sdk/extension/shared.d.ts +16 -16
- package/dist/sdk/extension/source-resolution.d.ts +16 -16
- package/dist/sdk/extension/static-inventory.d.ts +23 -23
- package/dist/sdk/extension/update-check.d.ts +9 -9
- package/dist/sdk/extension-command-context.d.ts +1 -1
- package/dist/sdk/extension-contracts.d.ts +10 -10
- package/dist/sdk/extension.d.ts +221 -221
- package/dist/sdk/files.d.ts +101 -101
- package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
- package/dist/sdk/flag-invocation-contracts.js +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
- package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
- package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
- package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
- package/dist/sdk/governance/assurance-action.d.ts +46 -46
- package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
- package/dist/sdk/governance/assurance-presets.d.ts +25 -25
- package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
- package/dist/sdk/governance/assurance.d.ts +204 -204
- package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
- package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
- package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
- package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
- package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
- package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
- package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
- package/dist/sdk/governance/extension-host-version.d.ts +9 -9
- package/dist/sdk/governance/gc.d.ts +26 -26
- package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
- package/dist/sdk/governance/health.d.ts +172 -172
- package/dist/sdk/governance/health.js +1 -1
- package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
- package/dist/sdk/governance/linked-file-report.d.ts +15 -15
- package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
- package/dist/sdk/governance/provenance-health.d.ts +35 -35
- package/dist/sdk/governance/reindex.d.ts +102 -102
- package/dist/sdk/governance/reliability.d.ts +29 -29
- package/dist/sdk/governance/stale-work.d.ts +13 -13
- package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
- package/dist/sdk/governance/storage-integrity.d.ts +28 -28
- package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
- package/dist/sdk/governance/upgrade.d.ts +77 -77
- package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
- package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
- package/dist/sdk/governance/validate-normalization.d.ts +4 -4
- package/dist/sdk/governance/validate.d.ts +176 -176
- package/dist/sdk/governance/validate.js +1 -1
- package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
- package/dist/sdk/governance/workflow-policy.d.ts +18 -18
- package/dist/sdk/governance/workspace-position.d.ts +40 -40
- package/dist/sdk/governance.d.ts +2 -2
- package/dist/sdk/graph/adapter.d.ts +45 -45
- package/dist/sdk/graph/analytics.d.ts +36 -36
- package/dist/sdk/graph/assembly.d.ts +51 -51
- package/dist/sdk/graph/cache.d.ts +19 -19
- package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
- package/dist/sdk/graph/centrality.d.ts +20 -20
- package/dist/sdk/graph/conformance.d.ts +21 -21
- package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
- package/dist/sdk/graph/durable-cache.d.ts +22 -22
- package/dist/sdk/graph/governance-contracts.d.ts +1 -1
- package/dist/sdk/graph/governance.d.ts +92 -92
- package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
- package/dist/sdk/graph/index.d.ts +15 -15
- package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
- package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
- package/dist/sdk/graph/query-contracts.d.ts +6 -6
- package/dist/sdk/graph/remediation.d.ts +15 -15
- package/dist/sdk/graph/run.d.ts +203 -203
- package/dist/sdk/graph/scheduling.d.ts +21 -21
- package/dist/sdk/graph/traversal.d.ts +18 -18
- package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
- package/dist/sdk/guide-topics.d.ts +19 -19
- package/dist/sdk/guide.d.ts +43 -43
- package/dist/sdk/history/attestation-command.d.ts +8 -8
- package/dist/sdk/history/attestation-contract.d.ts +43 -43
- package/dist/sdk/history/attestation-scan.d.ts +4 -4
- package/dist/sdk/history/attestation.d.ts +4 -4
- package/dist/sdk/history/maintenance.d.ts +25 -25
- package/dist/sdk/history/salvage.d.ts +19 -19
- package/dist/sdk/history/subject.d.ts +8 -8
- package/dist/sdk/history-analytics.d.ts +64 -64
- package/dist/sdk/history-compact.d.ts +67 -67
- package/dist/sdk/history-mcp.d.ts +7 -7
- package/dist/sdk/history-provenance.d.ts +40 -40
- package/dist/sdk/history-read.d.ts +24 -24
- package/dist/sdk/history-redact.d.ts +68 -68
- package/dist/sdk/history-repair.d.ts +92 -92
- package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
- package/dist/sdk/improvement-ledger.d.ts +62 -62
- package/dist/sdk/index.d.ts +69 -69
- package/dist/sdk/init-agent-guidance.d.ts +68 -68
- package/dist/sdk/init.d.ts +117 -117
- package/dist/sdk/invocation-author.d.ts +1 -1
- package/dist/sdk/item-children.d.ts +15 -15
- package/dist/sdk/item-metadata-index.d.ts +2 -2
- package/dist/sdk/item-schedule.d.ts +9 -9
- package/dist/sdk/item-transaction.d.ts +73 -73
- package/dist/sdk/learnings.d.ts +23 -23
- package/dist/sdk/lifecycle/append.d.ts +8 -8
- package/dist/sdk/lifecycle/claim.d.ts +38 -38
- package/dist/sdk/lifecycle/close-many.d.ts +71 -71
- package/dist/sdk/lifecycle/close.d.ts +18 -18
- package/dist/sdk/lifecycle/copy.d.ts +10 -10
- package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
- package/dist/sdk/lifecycle/create.d.ts +88 -88
- package/dist/sdk/lifecycle/delete.d.ts +15 -15
- package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
- package/dist/sdk/lifecycle/focus.d.ts +6 -6
- package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
- package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
- package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
- package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
- package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
- package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
- package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
- package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
- package/dist/sdk/lifecycle/plan.d.ts +127 -127
- package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
- package/dist/sdk/lifecycle/reopen.d.ts +15 -15
- package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
- package/dist/sdk/lifecycle/restore.d.ts +34 -34
- package/dist/sdk/lifecycle/restore.js +1 -1
- package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
- package/dist/sdk/lifecycle/task-composition.d.ts +7 -7
- package/dist/sdk/lifecycle/update-many.d.ts +61 -61
- package/dist/sdk/lifecycle/update.d.ts +120 -120
- package/dist/sdk/lifecycle-completion.d.ts +14 -14
- package/dist/sdk/lifecycle-policy.d.ts +31 -31
- package/dist/sdk/linked-artifacts.d.ts +58 -58
- package/dist/sdk/mcp/apps.d.ts +28 -28
- package/dist/sdk/mcp/authorization.d.ts +66 -66
- package/dist/sdk/mcp/discovery.d.ts +67 -67
- package/dist/sdk/mcp/interactions.d.ts +49 -49
- package/dist/sdk/mcp/protocol.d.ts +63 -63
- package/dist/sdk/mcp/skills.d.ts +62 -62
- package/dist/sdk/mcp/subscriptions.d.ts +26 -26
- package/dist/sdk/mcp/tasks.d.ts +51 -51
- package/dist/sdk/mcp/transport.d.ts +17 -17
- package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
- package/dist/sdk/merge/driver.d.ts +38 -38
- package/dist/sdk/merge/index.d.ts +5 -5
- package/dist/sdk/merge/install.d.ts +48 -48
- package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
- package/dist/sdk/merge/receipt-operation.d.ts +6 -6
- package/dist/sdk/merge/receipt-schema.d.ts +11 -11
- package/dist/sdk/merge/receipts.d.ts +111 -111
- package/dist/sdk/merge/reconcile.d.ts +20 -20
- package/dist/sdk/merge/three-way.d.ts +50 -50
- package/dist/sdk/merge/three-way.js +2 -2
- package/dist/sdk/merge/worktree-config.d.ts +3 -3
- package/dist/sdk/mutation-events.d.ts +62 -62
- package/dist/sdk/mutation-guard.d.ts +134 -134
- package/dist/sdk/notes.d.ts +28 -28
- package/dist/sdk/output/table-rows.d.ts +6 -6
- package/dist/sdk/output-contracts.d.ts +26 -26
- package/dist/sdk/output-projection.d.ts +108 -108
- package/dist/sdk/output-token-accounting.d.ts +18 -18
- package/dist/sdk/output.d.ts +18 -18
- package/dist/sdk/ownership-source.d.ts +1 -1
- package/dist/sdk/package-import-adapters.d.ts +51 -51
- package/dist/sdk/package-migrations.d.ts +3 -3
- package/dist/sdk/package-runtime-options.d.ts +3 -3
- package/dist/sdk/pagination.d.ts +28 -28
- package/dist/sdk/pagination.js +1 -1
- package/dist/sdk/profile.d.ts +72 -72
- package/dist/sdk/provenance.d.ts +37 -37
- package/dist/sdk/public-surface.json +1 -1
- package/dist/sdk/query/activity.d.ts +84 -84
- package/dist/sdk/query/aggregate.d.ts +109 -109
- package/dist/sdk/query/calendar.d.ts +95 -95
- package/dist/sdk/query/complete-list.d.ts +35 -35
- package/dist/sdk/query/context.d.ts +300 -300
- package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
- package/dist/sdk/query/get.d.ts +54 -54
- package/dist/sdk/query/history.d.ts +38 -38
- package/dist/sdk/query/item-filter-options.d.ts +41 -41
- package/dist/sdk/query/light-metadata.d.ts +1 -1
- package/dist/sdk/query/list-filter-shared.d.ts +4 -4
- package/dist/sdk/query/list.d.ts +167 -167
- package/dist/sdk/query/list.js +1 -1
- package/dist/sdk/query/multi-value-filters.d.ts +6 -6
- package/dist/sdk/query/next-ready-budget.d.ts +8 -8
- package/dist/sdk/query/next.d.ts +94 -94
- package/dist/sdk/query/parsers.d.ts +3 -3
- package/dist/sdk/query/projection-contracts.d.ts +18 -18
- package/dist/sdk/query/search/corpus.d.ts +15 -15
- package/dist/sdk/query/search/filters.d.ts +15 -15
- package/dist/sdk/query/search/input.d.ts +8 -8
- package/dist/sdk/query/search/lexical.d.ts +10 -10
- package/dist/sdk/query/search/response.d.ts +22 -22
- package/dist/sdk/query/search/semantic.d.ts +133 -133
- package/dist/sdk/query/search/types.d.ts +65 -65
- package/dist/sdk/query/search-contracts.d.ts +53 -53
- package/dist/sdk/query/search-pagination.d.ts +21 -21
- package/dist/sdk/query/search-rendering.d.ts +30 -30
- package/dist/sdk/query/search.d.ts +60 -60
- package/dist/sdk/query/workspace-contracts.d.ts +2 -2
- package/dist/sdk/query.d.ts +6 -6
- package/dist/sdk/read-output/continuation.d.ts +11 -11
- package/dist/sdk/read-output/extension.d.ts +3 -3
- package/dist/sdk/read-output/options.d.ts +7 -7
- package/dist/sdk/read-output/provenance.d.ts +6 -6
- package/dist/sdk/read-output-budget.d.ts +11 -11
- package/dist/sdk/read-output-contracts.d.ts +112 -112
- package/dist/sdk/read-output-contracts.js +1 -1
- package/dist/sdk/read-output-rows.d.ts +15 -15
- package/dist/sdk/read-output-session.d.ts +29 -29
- package/dist/sdk/relationship-analytics.d.ts +46 -46
- package/dist/sdk/relationship-context.d.ts +48 -48
- package/dist/sdk/relationship-history.d.ts +59 -59
- package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
- package/dist/sdk/relationship-migration.d.ts +14 -14
- package/dist/sdk/relationships.d.ts +46 -46
- package/dist/sdk/reproducibility/process.d.ts +9 -9
- package/dist/sdk/runtime/actions.d.ts +1 -1
- package/dist/sdk/runtime/context.d.ts +15 -15
- package/dist/sdk/runtime/schema-preview.d.ts +1 -1
- package/dist/sdk/runtime/schema.d.ts +1 -1
- package/dist/sdk/runtime-action-aliases.d.ts +3 -3
- package/dist/sdk/runtime-extended-actions.d.ts +9 -9
- package/dist/sdk/runtime-input.d.ts +29 -29
- package/dist/sdk/runtime-primitives.d.ts +53 -53
- package/dist/sdk/runtime-primitives.js +1 -1
- package/dist/sdk/runtime-public-contracts.d.ts +46 -46
- package/dist/sdk/runtime-stats-options.d.ts +1 -1
- package/dist/sdk/runtime.d.ts +374 -374
- package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
- package/dist/sdk/schema-migration.d.ts +79 -79
- package/dist/sdk/schema.d.ts +224 -224
- package/dist/sdk/search-refresh-worker.d.ts +1 -1
- package/dist/sdk/similarity-scoring.d.ts +10 -10
- package/dist/sdk/similarity.d.ts +73 -73
- package/dist/sdk/start-task-status.d.ts +1 -1
- package/dist/sdk/stats.d.ts +72 -72
- package/dist/sdk/structured-mutations.d.ts +13 -13
- package/dist/sdk/telemetry-flush.d.ts +1 -1
- package/dist/sdk/telemetry.d.ts +32 -32
- package/dist/sdk/templates.d.ts +35 -35
- package/dist/sdk/test/batch.d.ts +50 -50
- package/dist/sdk/test/command-args.d.ts +2 -2
- package/dist/sdk/test/entry.d.ts +4 -4
- package/dist/sdk/test/execution-receipts.d.ts +5 -5
- package/dist/sdk/test/execution.d.ts +247 -247
- package/dist/sdk/test/json-path.d.ts +4 -4
- package/dist/sdk/test/linked-command-detection.d.ts +36 -36
- package/dist/sdk/test/measurements.d.ts +10 -10
- package/dist/sdk/test/parsers.d.ts +18 -18
- package/dist/sdk/test/prerequisites.d.ts +3 -3
- package/dist/sdk/test/runs.d.ts +43 -43
- package/dist/sdk/test/trust.d.ts +15 -15
- package/dist/sdk/test/update.d.ts +23 -23
- package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
- package/dist/sdk/testing.d.ts +248 -248
- package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
- package/dist/sdk/traceability/source-traceability.d.ts +50 -50
- package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
- package/dist/sdk/workspace-contracts.d.ts +20 -20
- package/dist/sdk/workspace-memory.d.ts +42 -42
- package/dist/sdk/workspace-recipe.d.ts +9 -9
- package/dist/sdk/workspace-snapshot.d.ts +60 -60
- package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
- package/dist/sdk/workspace-transaction.d.ts +26 -26
- package/dist/sdk/workspace.d.ts +9 -9
- package/dist/types.d.ts +540 -540
- package/docs/COMMANDS.md +11 -2
- package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
- package/docs/LINKED_TEST_EDITS.md +15 -0
- package/docs/RELEASING.md +2 -0
- package/docs/TESTING.md +21 -1
- package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +4 -3
- package/marketplace.json +1 -1
- package/package.json +3 -1
- package/packages/pm-beads/package.json +1 -1
- package/packages/pm-calendar/package.json +1 -1
- package/packages/pm-command-kit/package.json +1 -1
- package/packages/pm-digital-twin/package.json +1 -1
- package/packages/pm-governance-audit/package.json +1 -1
- package/packages/pm-guide-shell/package.json +1 -1
- package/packages/pm-kanban/package.json +1 -1
- package/packages/pm-lifecycle-hooks/package.json +1 -1
- package/packages/pm-linked-test-adapters/package.json +1 -1
- package/packages/pm-search-advanced/package.json +1 -1
- package/packages/pm-templates/package.json +1 -1
- package/packages/pm-todos/package.json +1 -1
- package/packages/pm-vcs/package.json +1 -1
- package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
- package/plugins/pm-claude/package.json +1 -1
- package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
- package/plugins/pm-codex/package.json +1 -1
- package/plugins/pm-codex/plugin.json +1 -1
- package/runtime-dependencies.json +1 -1
- package/scripts/finalize-build.mjs +9 -3
- package/dist/cli-bundle/chunks/chunk-66BZVFIK.js +0 -6
- package/dist/cli-bundle/chunks/chunk-IDEHMKYZ.js +0 -235
- package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
- package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
- package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
|
@@ -3,112 +3,112 @@
|
|
|
3
3
|
*
|
|
4
4
|
* Provides public bootstrap argument normalization for embedded CLI hosts.
|
|
5
5
|
*/
|
|
6
|
-
import { EXECUTABLE_COMMAND_ALIASES,
|
|
6
|
+
import { EXECUTABLE_COMMAND_ALIASES,PM_COMMAND_ALIAS_CONTRACTS,renderPmCommandAliasMigrationHint,resolvePmCommandAlias,type PmCommandAliasContract,type PmCommandAliasLifecycle,type PmCommandAliasRegistration } from "./cli-contracts/command-aliases.js";
|
|
7
7
|
import { type CliFlagContract } from "./cli-contracts/flag-contracts.js";
|
|
8
|
-
export { EXECUTABLE_COMMAND_ALIASES,
|
|
8
|
+
export { EXECUTABLE_COMMAND_ALIASES,PM_COMMAND_ALIAS_CONTRACTS,renderPmCommandAliasMigrationHint,resolvePmCommandAlias,type PmCommandAliasContract,type PmCommandAliasLifecycle,type PmCommandAliasRegistration,};
|
|
9
9
|
/** Documents the bootstrap global options payload exchanged by command, SDK, and package integrations. */
|
|
10
10
|
export interface BootstrapGlobalOptions {
|
|
11
11
|
/** Filesystem path used for path resolution. */
|
|
12
|
-
path?:
|
|
12
|
+
path?:string;
|
|
13
13
|
/** Value that configures or reports no extensions for this contract. */
|
|
14
|
-
noExtensions:
|
|
14
|
+
noExtensions:boolean;
|
|
15
15
|
/** Value that configures or reports no pager for this contract. */
|
|
16
|
-
noPager:
|
|
16
|
+
noPager:boolean;
|
|
17
17
|
/** Value that configures or reports json for this contract. */
|
|
18
|
-
json:
|
|
18
|
+
json:boolean;
|
|
19
19
|
/** Value that configures or reports quiet for this contract. */
|
|
20
|
-
quiet:
|
|
20
|
+
quiet:boolean;
|
|
21
21
|
/** Whether compact JSON projection is requested. */
|
|
22
|
-
lean:
|
|
22
|
+
lean:boolean;
|
|
23
23
|
/** Whether output token accounting is requested. */
|
|
24
|
-
tokenAccounting:
|
|
24
|
+
tokenAccounting:boolean;
|
|
25
25
|
/** Canonical comma-separated fields or sections retained in read output. */
|
|
26
|
-
outputInclude?:
|
|
26
|
+
outputInclude?:string;
|
|
27
27
|
/** Canonical maximum row count retained in read output. */
|
|
28
|
-
outputLimit?:
|
|
28
|
+
outputLimit?:string;
|
|
29
29
|
/** Canonical estimated-token ceiling for read output. */
|
|
30
|
-
outputBudget?:
|
|
30
|
+
outputBudget?:string;
|
|
31
31
|
/** Canonical renderer encoding for read output. */
|
|
32
|
-
outputFormat?:
|
|
32
|
+
outputFormat?:"toon" | "json";
|
|
33
33
|
/** Caller-carried cross-call budget and served-item state. */
|
|
34
|
-
outputSession?:
|
|
34
|
+
outputSession?:string;
|
|
35
35
|
/** Opaque budget-compaction continuation cursor. */
|
|
36
|
-
outputCursor?:
|
|
36
|
+
outputCursor?:string;
|
|
37
37
|
/** Whether machine-readable row discovery metadata is requested. */
|
|
38
|
-
outputRowContract?:
|
|
38
|
+
outputRowContract?:boolean;
|
|
39
39
|
/** Invocation-wide mutation author override. */
|
|
40
|
-
author?:
|
|
40
|
+
author?:string;
|
|
41
41
|
/** Whether `--author` was present without its required value. */
|
|
42
|
-
authorMissingValue?:
|
|
42
|
+
authorMissingValue?:true;
|
|
43
43
|
}
|
|
44
44
|
/** Implements parse bootstrap global options for the public runtime surface of this module. */
|
|
45
|
-
export declare function parseBootstrapGlobalOptions(argv:
|
|
45
|
+
export declare function parseBootstrapGlobalOptions(argv:string[]):BootstrapGlobalOptions;
|
|
46
46
|
/** Implements strip global bootstrap tokens for the public runtime surface of this module. */
|
|
47
|
-
export declare function stripGlobalBootstrapTokens(argv:
|
|
47
|
+
export declare function stripGlobalBootstrapTokens(argv:string[]):string[];
|
|
48
48
|
/** Documents the bootstrap help request payload exchanged by command, SDK, and package integrations. */
|
|
49
49
|
export interface BootstrapHelpRequest {
|
|
50
50
|
/** Value that configures or reports requested for this contract. */
|
|
51
|
-
requested:
|
|
51
|
+
requested:boolean;
|
|
52
52
|
/** Value that configures or reports command path tokens for this contract. */
|
|
53
|
-
commandPathTokens:
|
|
53
|
+
commandPathTokens:string[];
|
|
54
54
|
}
|
|
55
55
|
/** Implements parse bootstrap help request for the public runtime surface of this module. */
|
|
56
|
-
export declare function parseBootstrapHelpRequest(argv:
|
|
56
|
+
export declare function parseBootstrapHelpRequest(argv:string[]):BootstrapHelpRequest;
|
|
57
57
|
/** Locate the command token after global bootstrap flags and their values. */
|
|
58
|
-
export declare function findBootstrapCommandTokenIndex(argv:
|
|
58
|
+
export declare function findBootstrapCommandTokenIndex(argv:string[]):number | undefined;
|
|
59
59
|
/** Resolve the normalized command name from bootstrap invocation arguments. */
|
|
60
|
-
export declare function parseBootstrapCommandName(argv:
|
|
60
|
+
export declare function parseBootstrapCommandName(argv:string[]):string | undefined;
|
|
61
61
|
/** Implements apply bootstrap pager policy for the public runtime surface of this module. */
|
|
62
|
-
export declare function applyBootstrapPagerPolicy(argv:
|
|
62
|
+
export declare function applyBootstrapPagerPolicy(argv:string[]):() => void;
|
|
63
63
|
/** Implements normalize legacy extension action syntax for the public runtime surface of this module. */
|
|
64
|
-
export declare function normalizeLegacyExtensionActionSyntax(argv:
|
|
64
|
+
export declare function normalizeLegacyExtensionActionSyntax(argv:string[]):string[];
|
|
65
65
|
type BootstrapNormalizationReason = "executable_alias" | "legacy_extension_action" | "command_alias" | "item_id_alias" | "flag_alias" | "flag_typo" | "bare_key_value" | "list_merge";
|
|
66
66
|
type BootstrapNormalizationConfidence = "high" | "medium";
|
|
67
67
|
/** Documents the bootstrap normalization event payload exchanged by command, SDK, and package integrations. */
|
|
68
68
|
export interface BootstrapNormalizationEvent {
|
|
69
69
|
/** Value that configures or reports from for this contract. */
|
|
70
|
-
from:
|
|
70
|
+
from:string;
|
|
71
71
|
/** Value that configures or reports to for this contract. */
|
|
72
|
-
to:
|
|
72
|
+
to:string[];
|
|
73
73
|
/** Value that configures or reports reason for this contract. */
|
|
74
|
-
reason:
|
|
74
|
+
reason:BootstrapNormalizationReason;
|
|
75
75
|
/** Value that configures or reports confidence for this contract. */
|
|
76
|
-
confidence:
|
|
76
|
+
confidence:BootstrapNormalizationConfidence;
|
|
77
77
|
}
|
|
78
78
|
/** Documents the bootstrap invocation normalization result payload exchanged by command, SDK, and package integrations. */
|
|
79
79
|
export interface BootstrapInvocationNormalizationResult {
|
|
80
80
|
/** Value that configures or reports argv for this contract. */
|
|
81
|
-
argv:
|
|
81
|
+
argv:string[];
|
|
82
82
|
/** Value that configures or reports command name for this contract. */
|
|
83
|
-
commandName:
|
|
83
|
+
commandName:string | undefined;
|
|
84
84
|
/** Value that configures or reports trace for this contract. */
|
|
85
|
-
trace:
|
|
85
|
+
trace:BootstrapNormalizationEvent[];
|
|
86
86
|
}
|
|
87
87
|
interface FlagLookup {
|
|
88
|
-
canonicalByNormalized:
|
|
89
|
-
canonicalByCompact:
|
|
90
|
-
canonicalComparables:
|
|
91
|
-
canonicalFlag:
|
|
92
|
-
comparable:
|
|
88
|
+
canonicalByNormalized:Map<string,string | null>;
|
|
89
|
+
canonicalByCompact:Map<string,string | null>;
|
|
90
|
+
canonicalComparables:Array<{
|
|
91
|
+
canonicalFlag:string;
|
|
92
|
+
comparable:string;
|
|
93
93
|
}>;
|
|
94
|
-
listCanonicalFlags:
|
|
94
|
+
listCanonicalFlags:Set<string>;
|
|
95
95
|
}
|
|
96
|
-
declare function markUnambiguousFlag(map:
|
|
97
|
-
declare function collectLongFlagCandidates(contract:
|
|
98
|
-
declare function buildFlagLookup(commandName:
|
|
99
|
-
declare function resolveCanonicalFlag(rawKey:
|
|
100
|
-
flag:
|
|
101
|
-
reason:
|
|
102
|
-
confidence:
|
|
96
|
+
declare function markUnambiguousFlag(map:Map<string,string | null>,key:string,canonicalFlag:string):void;
|
|
97
|
+
declare function collectLongFlagCandidates(contract:CliFlagContract):string[];
|
|
98
|
+
declare function buildFlagLookup(commandName:string | undefined,contractsOverride?:CliFlagContract[]):FlagLookup;
|
|
99
|
+
declare function resolveCanonicalFlag(rawKey:string,lookup:FlagLookup):{
|
|
100
|
+
flag:string;
|
|
101
|
+
reason:"flag_alias" | "flag_typo";
|
|
102
|
+
confidence:BootstrapNormalizationConfidence;
|
|
103
103
|
} | null;
|
|
104
104
|
/** Implements list alias plural keys for the public runtime surface of this module. */
|
|
105
|
-
export declare function listAliasPluralKeys(normalizedKey:
|
|
106
|
-
declare function normalizeLongOptionToken(token:
|
|
107
|
-
tokens:
|
|
108
|
-
event?:
|
|
105
|
+
export declare function listAliasPluralKeys(normalizedKey:string):string[];
|
|
106
|
+
declare function normalizeLongOptionToken(token:string,lookup:FlagLookup,preserve?:boolean):{
|
|
107
|
+
tokens:string[];
|
|
108
|
+
event?:BootstrapNormalizationEvent;
|
|
109
109
|
};
|
|
110
110
|
/** Locate global path-value tokens that normalization must preserve literally. */
|
|
111
|
-
declare function collectBootstrapPathValueIndices(argv:
|
|
111
|
+
declare function collectBootstrapPathValueIndices(argv:string[]):Set<number>;
|
|
112
112
|
/**
|
|
113
113
|
* Coalesce repeated occurrences of comma-separated list flags into a single
|
|
114
114
|
* `--flag=v1,v2,v3` token anchored at the FIRST occurrence. Without this,
|
|
@@ -122,26 +122,26 @@ declare function collectBootstrapPathValueIndices(argv: string[]): Set<number>;
|
|
|
122
122
|
* list-flag-looking value (`--path --tags`) is never reinterpreted as a flag
|
|
123
123
|
* nor allowed to swallow the following command/positional token.
|
|
124
124
|
*/
|
|
125
|
-
export declare function coalesceRepeatedListFlags(argv:
|
|
126
|
-
argv:
|
|
127
|
-
events:
|
|
125
|
+
export declare function coalesceRepeatedListFlags(argv:string[],listFlags:Set<string>,valueConsumingFlags?:Set<string>,multiValueListFlags?:Set<string>):{
|
|
126
|
+
argv:string[];
|
|
127
|
+
events:BootstrapNormalizationEvent[];
|
|
128
128
|
};
|
|
129
129
|
/** Accept the two-token linked-test form `pm test <id> --add command "npm test -- parser"` by merging the bare key token and its single quoted value into the documented `--add command=...` shape. Without this merge Commander binds the bare key as the option value and treats the quoted command as an excess positional, failing with "too many arguments" (GH-191). The merge only fires when EXACTLY ONE non-flag token follows the bare key, i.e. the value was quoted into one shell token — an unquoted multi-token value stays ambiguous (it may swallow the item id), still fails fast, and is routed to targeted quoting guidance by the commander error classifier instead. */
|
|
130
|
-
export declare function mergeLinkedTestTwoTokenEntries(argv:
|
|
130
|
+
export declare function mergeLinkedTestTwoTokenEntries(argv:string[],commandName:string | undefined,trace:BootstrapNormalizationEvent[]):string[];
|
|
131
131
|
/**
|
|
132
132
|
* Canonicalize executable, command, item-address and option aliases before registration.
|
|
133
133
|
* Coalesce declared list values while preserving explicit literals and help discovery;
|
|
134
134
|
* return the selected command and normalization events for host diagnostics.
|
|
135
135
|
*/
|
|
136
|
-
export declare function normalizeBootstrapInvocation(argv:
|
|
136
|
+
export declare function normalizeBootstrapInvocation(argv:string[]):BootstrapInvocationNormalizationResult;
|
|
137
137
|
/** Implements parse bootstrap type value for the public runtime surface of this module. */
|
|
138
|
-
export declare function parseBootstrapTypeValue(argv:
|
|
138
|
+
export declare function parseBootstrapTypeValue(argv:string[]):string | undefined;
|
|
139
139
|
/** Public contract for test only, shared by SDK and presentation-layer consumers. */
|
|
140
|
-
export declare const _testOnly:
|
|
141
|
-
buildFlagLookup:
|
|
142
|
-
collectBootstrapPathValueIndices:
|
|
143
|
-
collectLongFlagCandidates:
|
|
144
|
-
markUnambiguousFlag:
|
|
145
|
-
normalizeLongOptionToken:
|
|
146
|
-
resolveCanonicalFlag:
|
|
140
|
+
export declare const _testOnly:{
|
|
141
|
+
buildFlagLookup:typeof buildFlagLookup;
|
|
142
|
+
collectBootstrapPathValueIndices:typeof collectBootstrapPathValueIndices;
|
|
143
|
+
collectLongFlagCandidates:typeof collectLongFlagCandidates;
|
|
144
|
+
markUnambiguousFlag:typeof markUnambiguousFlag;
|
|
145
|
+
normalizeLongOptionToken:typeof normalizeLongOptionToken;
|
|
146
|
+
resolveCanonicalFlag:typeof resolveCanonicalFlag;
|
|
147
147
|
};
|
|
@@ -1,127 +1,127 @@
|
|
|
1
1
|
/** Stable degradation stages applied when an output exceeds its token budget. */
|
|
2
|
-
export declare const PM_OUTPUT_DEGRADATION_STEPS:
|
|
2
|
+
export declare const PM_OUTPUT_DEGRADATION_STEPS:readonly ["full","compact","brief","summary","counts"];
|
|
3
3
|
/** Restricts deterministic output degradation stages. */
|
|
4
4
|
export type PmOutputDegradationStep = (typeof PM_OUTPUT_DEGRADATION_STEPS)[number];
|
|
5
5
|
/** Stable command-output classes used to assign conservative default budgets. */
|
|
6
|
-
export declare const PM_OUTPUT_BUDGET_CLASSES:
|
|
6
|
+
export declare const PM_OUTPUT_BUDGET_CLASSES:readonly ["mutation","read","discovery","governance"];
|
|
7
7
|
/** Restricts command-output budget classes. */
|
|
8
8
|
export type PmOutputBudgetClass = (typeof PM_OUTPUT_BUDGET_CLASSES)[number];
|
|
9
9
|
/** Stable diagnostic families that require independent output ceilings. */
|
|
10
|
-
export declare const PM_DIAGNOSTIC_OUTPUT_CLASSES:
|
|
10
|
+
export declare const PM_DIAGNOSTIC_OUTPUT_CLASSES:readonly ["error","warning","validation_summary","recovery_bundle"];
|
|
11
11
|
/** Restricts diagnostic budget selection to declared families. */
|
|
12
12
|
export type PmDiagnosticOutputClass = (typeof PM_DIAGNOSTIC_OUTPUT_CLASSES)[number];
|
|
13
13
|
/** Deterministic diagnostic degradation stages, from richest to smallest. */
|
|
14
|
-
export declare const PM_DIAGNOSTIC_DEGRADATION_STEPS:
|
|
14
|
+
export declare const PM_DIAGNOSTIC_DEGRADATION_STEPS:readonly ["full","omit_explanation","limit_collections","compact_recovery","action_only"];
|
|
15
15
|
/** Restricts diagnostic degradation receipts to declared stages. */
|
|
16
16
|
export type PmDiagnosticDegradationStep = (typeof PM_DIAGNOSTIC_DEGRADATION_STEPS)[number];
|
|
17
17
|
/** Declares one diagnostic family's text and JSON token ceilings. */
|
|
18
18
|
export interface PmDiagnosticOutputBudgetContract {
|
|
19
19
|
/** Diagnostic family governed by this contract. */
|
|
20
|
-
diagnostic_class:
|
|
20
|
+
diagnostic_class:PmDiagnosticOutputClass;
|
|
21
21
|
/** Default ceiling by rendered transport. */
|
|
22
|
-
default_max_estimated_tokens_by_format:
|
|
23
|
-
text:
|
|
24
|
-
json:
|
|
22
|
+
default_max_estimated_tokens_by_format:Readonly<{
|
|
23
|
+
text:number;
|
|
24
|
+
json:number;
|
|
25
25
|
}>;
|
|
26
26
|
/** Smallest explicit ceiling accepted by the projector. */
|
|
27
|
-
minimum_max_estimated_tokens:
|
|
27
|
+
minimum_max_estimated_tokens:number;
|
|
28
28
|
/** Ordered degradation policy applied when the ceiling binds. */
|
|
29
|
-
degradation_ladder:
|
|
29
|
+
degradation_ladder:readonly PmDiagnosticDegradationStep[];
|
|
30
30
|
/** Paths whose first actionable value must survive degradation. */
|
|
31
|
-
corrective_action_paths:
|
|
31
|
+
corrective_action_paths:readonly string[];
|
|
32
32
|
/** Stable estimate used by gates and SDK consumers. */
|
|
33
|
-
token_estimate:
|
|
33
|
+
token_estimate:"ceil(utf8_bytes / 4)";
|
|
34
34
|
}
|
|
35
35
|
/** Machine-readable disclosure attached to a projected diagnostic. */
|
|
36
36
|
export interface PmDiagnosticOutputReceipt {
|
|
37
37
|
/** Diagnostic family whose contract bound the output. */
|
|
38
|
-
diagnostic_class:
|
|
38
|
+
diagnostic_class:PmDiagnosticOutputClass;
|
|
39
39
|
/** Rendered transport measured by the projector. */
|
|
40
|
-
format:
|
|
40
|
+
format:"json" | "text";
|
|
41
41
|
/** Effective estimated-token ceiling. */
|
|
42
|
-
budget:
|
|
42
|
+
budget:number;
|
|
43
43
|
/** Whether the caller supplied the ceiling or used the declaration. */
|
|
44
|
-
budget_source:
|
|
44
|
+
budget_source:"default" | "explicit";
|
|
45
45
|
/** Estimate before diagnostic degradation. */
|
|
46
|
-
original_estimated_tokens:
|
|
46
|
+
original_estimated_tokens:number;
|
|
47
47
|
/** Exact estimate of the returned projection. */
|
|
48
|
-
estimated_tokens:
|
|
48
|
+
estimated_tokens:number;
|
|
49
49
|
/** Whether one or more fields were removed or compacted. */
|
|
50
|
-
truncated:
|
|
50
|
+
truncated:boolean;
|
|
51
51
|
/** Applied stages in contract order. */
|
|
52
|
-
degradation_steps:
|
|
52
|
+
degradation_steps:PmDiagnosticDegradationStep[];
|
|
53
53
|
/** Top-level fields removed from the original diagnostic. */
|
|
54
|
-
omitted_fields:
|
|
54
|
+
omitted_fields:string[];
|
|
55
55
|
/** Additional omitted fields not named individually in a bounded receipt. */
|
|
56
|
-
omitted_fields_overflow_count?:
|
|
56
|
+
omitted_fields_overflow_count?:number;
|
|
57
57
|
}
|
|
58
58
|
/** JSON diagnostic after binding it to a declared output contract. */
|
|
59
|
-
export type PmProjectedDiagnostic<TDiagnostic extends object> = Partial<TDiagnostic> & Pick<TDiagnostic,
|
|
60
|
-
diagnostic_output?:
|
|
59
|
+
export type PmProjectedDiagnostic<TDiagnostic extends object> = Partial<TDiagnostic> & Pick<TDiagnostic,Extract<keyof TDiagnostic,"code" | "required">> & {
|
|
60
|
+
diagnostic_output?:PmDiagnosticOutputReceipt;
|
|
61
61
|
};
|
|
62
62
|
/** Describes one command's default agent-output budget and degradation policy. */
|
|
63
63
|
export interface PmCommandOutputBudgetContract {
|
|
64
64
|
/** Canonical or compatibility command name. */
|
|
65
|
-
command:
|
|
65
|
+
command:string;
|
|
66
66
|
/** Workload class that selected the default ceiling. */
|
|
67
|
-
budget_class:
|
|
67
|
+
budget_class:PmOutputBudgetClass;
|
|
68
68
|
/** Default estimated-token ceiling for representative output. */
|
|
69
|
-
default_max_estimated_tokens:
|
|
69
|
+
default_max_estimated_tokens:number;
|
|
70
70
|
/** Encoding-specific ceilings generated from the workload-class default. */
|
|
71
|
-
default_max_estimated_tokens_by_format:
|
|
72
|
-
toon:
|
|
73
|
-
json:
|
|
71
|
+
default_max_estimated_tokens_by_format:Readonly<{
|
|
72
|
+
toon:number;
|
|
73
|
+
json:number;
|
|
74
74
|
}>;
|
|
75
75
|
/** Ordered fallback projections, from richest to smallest. */
|
|
76
|
-
degradation_ladder:
|
|
76
|
+
degradation_ladder:readonly PmOutputDegradationStep[];
|
|
77
77
|
/** Whether callers may explicitly request an unbounded result. */
|
|
78
|
-
allows_unbounded_opt_out:
|
|
78
|
+
allows_unbounded_opt_out:boolean;
|
|
79
79
|
/** Stable estimate used by gates and SDK consumers. */
|
|
80
|
-
token_estimate:
|
|
80
|
+
token_estimate:"ceil(utf8_bytes / 4)";
|
|
81
81
|
}
|
|
82
82
|
/** Public default contract for every diagnostic family. */
|
|
83
|
-
export declare const PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS:
|
|
83
|
+
export declare const PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS:PmDiagnosticOutputBudgetContract[];
|
|
84
84
|
/** Infer the conservative workload class for a core or package command. */
|
|
85
|
-
export declare function inferPmOutputBudgetClass(command:
|
|
85
|
+
export declare function inferPmOutputBudgetClass(command:string):PmOutputBudgetClass;
|
|
86
86
|
/** Build the generated default budget for a core or package command. */
|
|
87
|
-
export declare function createPmCommandOutputBudget(command:
|
|
87
|
+
export declare function createPmCommandOutputBudget(command:string,budgetClass?:PmOutputBudgetClass):PmCommandOutputBudgetContract;
|
|
88
88
|
/**
|
|
89
89
|
* Declares one budget contract while preserving literal command metadata for
|
|
90
90
|
* package-authored registries and test fixtures. Rejects ceilings that cannot
|
|
91
91
|
* represent a positive, deterministic token allowance.
|
|
92
92
|
*/
|
|
93
|
-
export declare function definePmCommandOutputBudget<TContract extends PmCommandOutputBudgetContract>(contract:
|
|
93
|
+
export declare function definePmCommandOutputBudget<TContract extends PmCommandOutputBudgetContract>(contract:TContract):TContract;
|
|
94
94
|
/** Public default budget contract for every built-in pm command. */
|
|
95
|
-
export declare const PM_COMMAND_OUTPUT_BUDGET_CONTRACTS:
|
|
95
|
+
export declare const PM_COMMAND_OUTPUT_BUDGET_CONTRACTS:PmCommandOutputBudgetContract[];
|
|
96
96
|
/** Resolve the declared output budget for one built-in command. */
|
|
97
|
-
export declare function resolvePmCommandOutputBudget(command:
|
|
98
|
-
generateFallback:
|
|
99
|
-
}):
|
|
97
|
+
export declare function resolvePmCommandOutputBudget(command:string,options:{
|
|
98
|
+
generateFallback:true;
|
|
99
|
+
}):PmCommandOutputBudgetContract;
|
|
100
100
|
/** Resolve a declared output budget without generating a package fallback. */
|
|
101
|
-
export declare function resolvePmCommandOutputBudget(command:
|
|
102
|
-
generateFallback?:
|
|
103
|
-
}):
|
|
101
|
+
export declare function resolvePmCommandOutputBudget(command:string,options?:{
|
|
102
|
+
generateFallback?:false;
|
|
103
|
+
}):PmCommandOutputBudgetContract | null;
|
|
104
104
|
/** Estimate conservative token usage from UTF-8 output bytes. */
|
|
105
|
-
export declare function estimatePmOutputTokens(utf8Bytes:
|
|
105
|
+
export declare function estimatePmOutputTokens(utf8Bytes:number):number;
|
|
106
106
|
/** Resolve the binding output contract for one diagnostic family. */
|
|
107
|
-
export declare function resolvePmDiagnosticOutputBudget(diagnosticClass:
|
|
107
|
+
export declare function resolvePmDiagnosticOutputBudget(diagnosticClass:PmDiagnosticOutputClass):PmDiagnosticOutputBudgetContract;
|
|
108
108
|
/**
|
|
109
109
|
* Bind a JSON diagnostic to its declared ceiling while preserving the first
|
|
110
110
|
* corrective action and reporting every top-level omission.
|
|
111
111
|
*/
|
|
112
|
-
export declare function projectPmDiagnosticOutput<TDiagnostic extends object>(diagnostic:
|
|
113
|
-
diagnosticClass?:
|
|
114
|
-
maxEstimatedTokens?:
|
|
115
|
-
}):
|
|
112
|
+
export declare function projectPmDiagnosticOutput<TDiagnostic extends object>(diagnostic:TDiagnostic,options?:{
|
|
113
|
+
diagnosticClass?:PmDiagnosticOutputClass;
|
|
114
|
+
maxEstimatedTokens?:number;
|
|
115
|
+
}):PmProjectedDiagnostic<TDiagnostic>;
|
|
116
116
|
/** Text diagnostic together with the same measured receipt used by JSON. */
|
|
117
117
|
export interface PmProjectedTextDiagnostic {
|
|
118
118
|
/** Rendered action-first diagnostic. */
|
|
119
|
-
output:
|
|
119
|
+
output:string;
|
|
120
120
|
/** Binding diagnostic budget receipt. */
|
|
121
|
-
diagnostic_output:
|
|
121
|
+
diagnostic_output:PmDiagnosticOutputReceipt;
|
|
122
122
|
}
|
|
123
123
|
/** Bind human-readable diagnostics while retaining their first identifying line and corrective action. */
|
|
124
|
-
export declare function projectPmDiagnosticText(output:
|
|
125
|
-
diagnosticClass?:
|
|
126
|
-
maxEstimatedTokens?:
|
|
127
|
-
}):
|
|
124
|
+
export declare function projectPmDiagnosticText(output:string,correctiveAction:string,options?:{
|
|
125
|
+
diagnosticClass?:PmDiagnosticOutputClass;
|
|
126
|
+
maxEstimatedTokens?:number;
|
|
127
|
+
}):PmProjectedTextDiagnostic;
|
|
@@ -5,19 +5,19 @@
|
|
|
5
5
|
* normalization, error, filesystem, or item-addressing dependencies.
|
|
6
6
|
*/
|
|
7
7
|
/** Global options that consume a following value when one is present. */
|
|
8
|
-
export declare const GLOBAL_VALUE_CONSUMING_FLAGS:
|
|
8
|
+
export declare const GLOBAL_VALUE_CONSUMING_FLAGS:Set<string>;
|
|
9
9
|
/** Boolean global options ignored while locating the command token. */
|
|
10
|
-
export declare const BOOTSTRAP_BOOLEAN_FLAGS:
|
|
10
|
+
export declare const BOOTSTRAP_BOOLEAN_FLAGS:Set<string>;
|
|
11
11
|
/** Whether a global value-consuming flag uses its inline `--flag=value` form. */
|
|
12
|
-
export declare function isInlineGlobalValueToken(token:
|
|
12
|
+
export declare function isInlineGlobalValueToken(token:string):boolean;
|
|
13
13
|
/** Whether a bootstrap value flag consumes its following token. */
|
|
14
|
-
export declare function consumesBootstrapValue(flag:
|
|
14
|
+
export declare function consumesBootstrapValue(flag:string,next:string | undefined):boolean;
|
|
15
15
|
/**
|
|
16
16
|
* Locate the first command token after global flags and their values.
|
|
17
17
|
*
|
|
18
18
|
* A leading `--` terminates command discovery. Unknown flags are ignored so
|
|
19
19
|
* later command-specific validation can return the canonical diagnostic.
|
|
20
20
|
*/
|
|
21
|
-
export declare function findBootstrapCommandTokenIndex(argv:
|
|
21
|
+
export declare function findBootstrapCommandTokenIndex(argv:readonly string[]):number | undefined;
|
|
22
22
|
/** Resolve the normalized command name from shell-free invocation arguments. */
|
|
23
|
-
export declare function parseBootstrapCommandName(argv:
|
|
23
|
+
export declare function parseBootstrapCommandName(argv:readonly string[]):string | undefined;
|
|
@@ -12,44 +12,44 @@ export type PmCommandAliasRegistration = "bootstrap" | "commander";
|
|
|
12
12
|
/** Machine-readable compatibility contract for one executable command alias. */
|
|
13
13
|
export interface PmCommandAliasContract {
|
|
14
14
|
/** Legacy or ergonomic spelling accepted at the command root. */
|
|
15
|
-
alias:
|
|
15
|
+
alias:string;
|
|
16
16
|
/** Canonical command path agents should discover and generate. */
|
|
17
|
-
canonical:
|
|
17
|
+
canonical:string;
|
|
18
18
|
/** Canonical tokens inserted before user-provided options and arguments. */
|
|
19
|
-
canonical_argv:
|
|
19
|
+
canonical_argv:readonly string[];
|
|
20
20
|
/** Whether the alias is permanent ergonomics or migration-only compatibility. */
|
|
21
|
-
lifecycle:
|
|
21
|
+
lifecycle:PmCommandAliasLifecycle;
|
|
22
22
|
/** Whether default help and completion discovery omit the alias. */
|
|
23
|
-
hidden:
|
|
23
|
+
hidden:boolean;
|
|
24
24
|
/** Runtime layer that keeps the alias executable. */
|
|
25
|
-
registration:
|
|
25
|
+
registration:PmCommandAliasRegistration;
|
|
26
26
|
/** PM item that owns the compatibility disposition. */
|
|
27
|
-
owner:
|
|
27
|
+
owner:string;
|
|
28
28
|
}
|
|
29
29
|
/** History namespace aliases preserve the existing SDK and MCP operation identities. */
|
|
30
|
-
export declare const PM_HISTORY_COMMAND_ALIASES:
|
|
30
|
+
export declare const PM_HISTORY_COMMAND_ALIASES:readonly PmCommandAliasContract[];
|
|
31
31
|
/** Navigation, maintenance, and event aliases share native handlers and stable SDK identities. */
|
|
32
|
-
export declare const PM_CONTEXT_OPS_COMMAND_ALIASES:
|
|
32
|
+
export declare const PM_CONTEXT_OPS_COMMAND_ALIASES:readonly PmCommandAliasContract[];
|
|
33
33
|
/** Bulk lifecycle operations retain their published SDK identities under canonical verbs. */
|
|
34
|
-
export declare const PM_BULK_LIFECYCLE_COMMAND_ALIASES:
|
|
34
|
+
export declare const PM_BULK_LIFECYCLE_COMMAND_ALIASES:readonly PmCommandAliasContract[];
|
|
35
35
|
/** Native handlers relocated into parent commands after core and package registration. */
|
|
36
|
-
export declare const PM_RELOCATED_COMMAND_ALIASES:
|
|
36
|
+
export declare const PM_RELOCATED_COMMAND_ALIASES:readonly PmCommandAliasContract[];
|
|
37
37
|
/** Native noun-verb paths whose stable operation identities survive grammar consolidation. */
|
|
38
|
-
export declare const PM_NAMESPACED_COMMAND_ALIASES:
|
|
38
|
+
export declare const PM_NAMESPACED_COMMAND_ALIASES:readonly PmCommandAliasContract[];
|
|
39
39
|
/** Find the longest declared command prefix without consuming flags or positional operands. */
|
|
40
|
-
export declare function findPmNamespacedCommand(tokens:
|
|
40
|
+
export declare function findPmNamespacedCommand(tokens:readonly string[]):PmCommandAliasContract | undefined;
|
|
41
41
|
/** Resolve a native command leaf to its stable SDK operation without changing unknown paths. */
|
|
42
|
-
export declare function resolvePmCommandOperation(command:
|
|
42
|
+
export declare function resolvePmCommandOperation(command:string):string;
|
|
43
43
|
/** Compatibility entrypoint for hosts that adopted namespace resolution with history. */
|
|
44
|
-
export declare function resolvePmHistoryOperation(command:
|
|
44
|
+
export declare function resolvePmHistoryOperation(command:string):string;
|
|
45
45
|
/**
|
|
46
46
|
* Public command-alias table. Deprecated aliases must remain executable but
|
|
47
47
|
* are intentionally absent from default help and completion discovery.
|
|
48
48
|
*/
|
|
49
|
-
export declare const PM_COMMAND_ALIAS_CONTRACTS:
|
|
49
|
+
export declare const PM_COMMAND_ALIAS_CONTRACTS:readonly PmCommandAliasContract[];
|
|
50
50
|
/** High-frequency executable aliases whose targets accept identical arguments. */
|
|
51
|
-
export declare const EXECUTABLE_COMMAND_ALIASES:
|
|
51
|
+
export declare const EXECUTABLE_COMMAND_ALIASES:Readonly<Record<string,string>>;
|
|
52
52
|
/** Resolve one declared command alias without inferring from its spelling. */
|
|
53
|
-
export declare function resolvePmCommandAlias(alias:
|
|
53
|
+
export declare function resolvePmCommandAlias(alias:string):PmCommandAliasContract | undefined;
|
|
54
54
|
/** Render the stable one-line migration hint emitted for deprecated aliases. */
|
|
55
|
-
export declare function renderPmCommandAliasMigrationHint(contract:
|
|
55
|
+
export declare function renderPmCommandAliasMigrationHint(contract:PmCommandAliasContract):string;
|