@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
|
@@ -1,68 +1,68 @@
|
|
|
1
1
|
import type { ExtensionRegistrationRegistry } from "../extensions/loader.js";
|
|
2
|
-
import type { ItemTypeCommandOptionPolicy,
|
|
2
|
+
import type { ItemTypeCommandOptionPolicy,ItemTypeDefinition,ItemTypeOptionDefinition,PmSettings } from "../../types/index.js";
|
|
3
3
|
/** Default dispatch roles for built-in types whose work requires human input or outcome verification. Custom definitions can override these through the same registry. */
|
|
4
|
-
export declare const BUILTIN_ITEM_EXECUTION_ROLES:
|
|
4
|
+
export declare const BUILTIN_ITEM_EXECUTION_ROLES:Readonly<Record<string,"human" | "gate">>;
|
|
5
5
|
/** Fallback required create fields used when callers do not provide an override. */
|
|
6
|
-
export declare const DEFAULT_REQUIRED_CREATE_FIELDS:
|
|
6
|
+
export declare const DEFAULT_REQUIRED_CREATE_FIELDS:readonly ["title","description","status","priority","tags","body","deadline","estimatedMinutes","acceptanceCriteria","author","message","assignee"];
|
|
7
7
|
/** Fallback required create repeatables used when callers do not provide an override. */
|
|
8
|
-
export declare const DEFAULT_REQUIRED_CREATE_REPEATABLES:
|
|
8
|
+
export declare const DEFAULT_REQUIRED_CREATE_REPEATABLES:readonly ["dep","comment","note","learning","file","test","doc"];
|
|
9
9
|
/** Restricts command option policy command values accepted by command, SDK, and storage contracts. */
|
|
10
10
|
export type CommandOptionPolicyCommand = "create" | "update";
|
|
11
11
|
/** Public contract for common mutation command option keys, shared by SDK and presentation-layer consumers. */
|
|
12
|
-
export declare const COMMON_MUTATION_COMMAND_OPTION_KEYS:
|
|
12
|
+
export declare const COMMON_MUTATION_COMMAND_OPTION_KEYS:readonly ["deadline","estimatedMinutes","acceptanceCriteria","definitionOfReady","order","goal","objective","value","impact","outcome","whyNow","assignee","parent","reviewer","risk","confidence","sprint","release","blockedBy","blockedReason","unblockNote","reporter","severity","environment","reproSteps","resolution","expectedResult","actualResult","affectedVersion","fixedVersion","component","regression","customerImpact"];
|
|
13
13
|
/** Documents the command option policy state payload exchanged by command, SDK, and package integrations. */
|
|
14
14
|
export interface CommandOptionPolicyState {
|
|
15
15
|
/** Value that configures or reports required for this contract. */
|
|
16
|
-
required:
|
|
16
|
+
required:string[];
|
|
17
17
|
/** Value that configures or reports hidden for this contract. */
|
|
18
|
-
hidden:
|
|
18
|
+
hidden:string[];
|
|
19
19
|
/** Whether disabled applies to this operation. */
|
|
20
|
-
disabled:
|
|
20
|
+
disabled:string[];
|
|
21
21
|
/** Value that configures or reports errors for this contract. */
|
|
22
|
-
errors:
|
|
22
|
+
errors:string[];
|
|
23
23
|
}
|
|
24
24
|
/** Documents the resolved item type definition payload exchanged by command, SDK, and package integrations. */
|
|
25
25
|
export interface ResolvedItemTypeDefinition {
|
|
26
26
|
/** Value that configures or reports name for this contract. */
|
|
27
|
-
name:
|
|
27
|
+
name:string;
|
|
28
28
|
/** Optional human description carried from the type definition. */
|
|
29
|
-
description?:
|
|
29
|
+
description?:string;
|
|
30
30
|
/** Value that configures or reports folder for this contract. */
|
|
31
|
-
folder:
|
|
31
|
+
folder:string;
|
|
32
32
|
/** Value that configures or reports aliases for this contract. */
|
|
33
|
-
aliases:
|
|
33
|
+
aliases:string[];
|
|
34
34
|
/** Optional per-type status applied at create time when `--status` is omitted. */
|
|
35
|
-
default_status?:
|
|
35
|
+
default_status?:string;
|
|
36
36
|
/** Effective dispatch role; absent legacy definitions are resolved through the built-in defaults. */
|
|
37
|
-
execution_role?:
|
|
37
|
+
execution_role?:ItemTypeDefinition["execution_role"];
|
|
38
38
|
/** Value that configures or reports required create fields for this contract. */
|
|
39
|
-
required_create_fields:
|
|
39
|
+
required_create_fields:string[];
|
|
40
40
|
/** Value that configures or reports required create repeatables for this contract. */
|
|
41
|
-
required_create_repeatables:
|
|
41
|
+
required_create_repeatables:string[];
|
|
42
42
|
/** Value that configures or reports options for this contract. */
|
|
43
|
-
options:
|
|
43
|
+
options:ItemTypeOptionDefinition[];
|
|
44
44
|
/** Value that configures or reports command option policies for this contract. */
|
|
45
|
-
command_option_policies:
|
|
45
|
+
command_option_policies:ItemTypeCommandOptionPolicy[];
|
|
46
46
|
}
|
|
47
47
|
/** Documents the item type registry payload exchanged by command, SDK, and package integrations. */
|
|
48
48
|
export interface ItemTypeRegistry {
|
|
49
49
|
/** Value that configures or reports types for this contract. */
|
|
50
|
-
types:
|
|
50
|
+
types:string[];
|
|
51
51
|
/** Value that configures or reports folders for this contract. */
|
|
52
|
-
folders:
|
|
52
|
+
folders:string[];
|
|
53
53
|
/** Value that configures or reports type to folder for this contract. */
|
|
54
|
-
type_to_folder:
|
|
54
|
+
type_to_folder:Record<string,string>;
|
|
55
55
|
/** Schema type that determines the shape and validation rules for this value. */
|
|
56
|
-
by_type:
|
|
56
|
+
by_type:Record<string,ResolvedItemTypeDefinition>;
|
|
57
57
|
/** Schema type that determines the shape and validation rules for this value. */
|
|
58
|
-
alias_to_type:
|
|
58
|
+
alias_to_type:Record<string,string>;
|
|
59
59
|
}
|
|
60
60
|
/** Implements canonicalize command option key for the public runtime surface of this module. */
|
|
61
|
-
export declare function canonicalizeCommandOptionKey(command:
|
|
61
|
+
export declare function canonicalizeCommandOptionKey(command:CommandOptionPolicyCommand,rawOption:string):string | undefined;
|
|
62
62
|
/** Implements command option flag label for the public runtime surface of this module. */
|
|
63
|
-
export declare function commandOptionFlagLabel(command:
|
|
63
|
+
export declare function commandOptionFlagLabel(command:CommandOptionPolicyCommand,optionKey:string):string;
|
|
64
64
|
/** Implements to default folder for the public runtime surface of this module. */
|
|
65
|
-
export declare function toDefaultFolder(name:
|
|
65
|
+
export declare function toDefaultFolder(name:string):string;
|
|
66
66
|
/**
|
|
67
67
|
* Canonicalizes a custom item-type folder as a portable tracker-relative path.
|
|
68
68
|
*
|
|
@@ -71,17 +71,17 @@ export declare function toDefaultFolder(name: string): string;
|
|
|
71
71
|
* identically on every host. Traversal, drive-prefixed, empty, and NUL-bearing
|
|
72
72
|
* values fail closed before callers can resolve an item or history path.
|
|
73
73
|
*/
|
|
74
|
-
export declare function normalizeItemTypeFolder(folder:
|
|
74
|
+
export declare function normalizeItemTypeFolder(folder:string):string;
|
|
75
75
|
/** Implements resolve item type registry for the public runtime surface of this module. */
|
|
76
|
-
export declare function resolveItemTypeRegistry(settings:
|
|
76
|
+
export declare function resolveItemTypeRegistry(settings:PmSettings,extensionRegistrations?:ExtensionRegistrationRegistry | null | undefined):ItemTypeRegistry;
|
|
77
77
|
/** Implements resolve type name for the public runtime surface of this module. */
|
|
78
|
-
export declare function resolveTypeName(rawType:
|
|
78
|
+
export declare function resolveTypeName(rawType:string | undefined,registry:ItemTypeRegistry):string | undefined;
|
|
79
79
|
/** Implements resolve type definition for the public runtime surface of this module. */
|
|
80
|
-
export declare function resolveTypeDefinition(typeName:
|
|
80
|
+
export declare function resolveTypeDefinition(typeName:string | undefined,registry:ItemTypeRegistry):ResolvedItemTypeDefinition | undefined;
|
|
81
81
|
/** Implements resolve command option policy state for the public runtime surface of this module. */
|
|
82
|
-
export declare function resolveCommandOptionPolicyState(typeDefinition:
|
|
82
|
+
export declare function resolveCommandOptionPolicyState(typeDefinition:ResolvedItemTypeDefinition,command:CommandOptionPolicyCommand,baseRequiredOptions:Iterable<string>):CommandOptionPolicyState;
|
|
83
83
|
/** Implements validate type options for the public runtime surface of this module. */
|
|
84
|
-
export declare function validateTypeOptions(typeName:
|
|
85
|
-
normalized:
|
|
86
|
-
errors:
|
|
84
|
+
export declare function validateTypeOptions(typeName:string,rawTypeOptions:Record<string,string> | undefined,registry:ItemTypeRegistry):{
|
|
85
|
+
normalized:Record<string,string> | undefined;
|
|
86
|
+
errors:string[];
|
|
87
87
|
};
|
|
@@ -12,6 +12,6 @@
|
|
|
12
12
|
* type names (resolved through the registry, never written verbatim).
|
|
13
13
|
*/
|
|
14
14
|
/** Public contract for type synonyms, shared by SDK and presentation-layer consumers. */
|
|
15
|
-
export declare const TYPE_SYNONYMS:
|
|
15
|
+
export declare const TYPE_SYNONYMS:Readonly<Record<string,string>>;
|
|
16
16
|
/** Map a free-form type token to its canonical built-in type synonym, or `undefined` when there is no synonym. The caller must still confirm the canonical target exists in the active type registry before using it. */
|
|
17
|
-
export declare function resolveTypeSynonym(rawType:
|
|
17
|
+
export declare function resolveTypeSynonym(rawType:string | undefined):string | undefined;
|
|
@@ -11,76 +11,76 @@
|
|
|
11
11
|
/** Documents the stale lock scan entry payload exchanged by command, SDK, and package integrations. */
|
|
12
12
|
export interface StaleLockScanEntry {
|
|
13
13
|
/** e.g. "pm-abc1.lock" */
|
|
14
|
-
file:
|
|
14
|
+
file:string;
|
|
15
15
|
/** parsed id, or null if unparseable */
|
|
16
|
-
id:
|
|
16
|
+
id:string | null;
|
|
17
17
|
/** Value that configures or reports owner for this contract. */
|
|
18
|
-
owner:
|
|
18
|
+
owner:string | null;
|
|
19
19
|
/** ISO 8601 timestamp recording when created occurred. */
|
|
20
|
-
created_at:
|
|
20
|
+
created_at:string | null;
|
|
21
21
|
/** Value that configures or reports ttl seconds for this contract. */
|
|
22
|
-
ttl_seconds:
|
|
22
|
+
ttl_seconds:number | null;
|
|
23
23
|
/** floor((now - created_at)/1000), null if unparseable */
|
|
24
|
-
age_seconds:
|
|
24
|
+
age_seconds:number | null;
|
|
25
25
|
/** true only when classified expired */
|
|
26
|
-
stale:
|
|
26
|
+
stale:boolean;
|
|
27
27
|
/** Value that configures or reports reason for this contract. */
|
|
28
|
-
reason:
|
|
28
|
+
reason:"expired" | "active" | "unparseable";
|
|
29
29
|
}
|
|
30
30
|
/** Documents the lock gc hooks payload exchanged by command, SDK, and package integrations. */
|
|
31
31
|
export interface LockGcHooks {
|
|
32
32
|
/** Value that configures or reports on read for this contract. */
|
|
33
|
-
onRead?:
|
|
33
|
+
onRead?:(lockPath:string) => Promise<string[]> | string[];
|
|
34
34
|
/** Value that configures or reports on write for this contract. */
|
|
35
|
-
onWrite?:
|
|
35
|
+
onWrite?:(lockPath:string) => Promise<string[]> | string[];
|
|
36
36
|
}
|
|
37
37
|
/** Documents the lock gc options payload exchanged by command, SDK, and package integrations. */
|
|
38
38
|
export interface LockGcOptions {
|
|
39
39
|
/** Value that configures or reports dry run for this contract. */
|
|
40
|
-
dryRun:
|
|
40
|
+
dryRun:boolean;
|
|
41
41
|
/** epoch ms; defaults to Date.now() — injectable for deterministic tests */
|
|
42
|
-
now?:
|
|
42
|
+
now?:number;
|
|
43
43
|
/** Value that configures or reports hooks for this contract. */
|
|
44
|
-
hooks?:
|
|
44
|
+
hooks?:LockGcHooks;
|
|
45
45
|
}
|
|
46
46
|
/** Documents the lock gc result payload exchanged by command, SDK, and package integrations. */
|
|
47
47
|
export interface LockGcResult {
|
|
48
48
|
/** number of *.lock files examined */
|
|
49
|
-
scanned:
|
|
49
|
+
scanned:number;
|
|
50
50
|
/** relative paths like "locks/pm-abc1.lock" (removed, or would-remove under dryRun) */
|
|
51
|
-
removed:
|
|
51
|
+
removed:string[];
|
|
52
52
|
/** relative paths retained (active OR unparseable — never delete what we can't reason about) */
|
|
53
|
-
retained:
|
|
53
|
+
retained:string[];
|
|
54
54
|
/** Value that configures or reports warnings for this contract. */
|
|
55
|
-
warnings:
|
|
55
|
+
warnings:string[];
|
|
56
56
|
/** one per scanned *.lock file, sorted by file name asc */
|
|
57
|
-
entries:
|
|
57
|
+
entries:StaleLockScanEntry[];
|
|
58
58
|
}
|
|
59
59
|
/** Fine-grained classification outcome for one readable lock file's content. `unparseable_json` and `invalid_timestamp` both surface as the coarse `reason: "unparseable"` on the scan entry (gc retains both), but stay distinct here so callers can emit precise warnings. */
|
|
60
60
|
export type LockClassificationDetail = "active" | "expired" | "unparseable_json" | "invalid_timestamp";
|
|
61
61
|
/** Documents the lock content classification payload exchanged by command, SDK, and package integrations. */
|
|
62
62
|
export interface LockContentClassification {
|
|
63
63
|
/** Value that configures or reports detail for this contract. */
|
|
64
|
-
detail:
|
|
64
|
+
detail:LockClassificationDetail;
|
|
65
65
|
/** Value that configures or reports entry for this contract. */
|
|
66
|
-
entry:
|
|
66
|
+
entry:StaleLockScanEntry;
|
|
67
67
|
}
|
|
68
68
|
/** Pure classification of one lock file's raw content against `nowMs`. This is the single staleness/parse policy shared by `pm gc --scope locks` (which acts on it) and the `pm health` locks check (which only reports it). */
|
|
69
|
-
export declare function classifyLockContent(file:
|
|
69
|
+
export declare function classifyLockContent(file:string,raw:string,nowMs:number):LockContentClassification;
|
|
70
70
|
/** Documents the lock health scan payload exchanged by command, SDK, and package integrations. */
|
|
71
71
|
export interface LockHealthScan {
|
|
72
72
|
/** number of *.lock files examined (ghost files that vanish mid-scan are skipped) */
|
|
73
|
-
scanned:
|
|
73
|
+
scanned:number;
|
|
74
74
|
/** Number of active lock entries represented by this result. */
|
|
75
|
-
active_lock_count:
|
|
75
|
+
active_lock_count:number;
|
|
76
76
|
/** Number of stale lock entries represented by this result. */
|
|
77
|
-
stale_lock_count:
|
|
77
|
+
stale_lock_count:number;
|
|
78
78
|
/** Number of unreadable lock entries represented by this result. */
|
|
79
|
-
unreadable_lock_count:
|
|
79
|
+
unreadable_lock_count:number;
|
|
80
80
|
/** invalid JSON, wrong shape, or an unparseable created_at timestamp */
|
|
81
|
-
unparseable_lock_count:
|
|
81
|
+
unparseable_lock_count:number;
|
|
82
82
|
}
|
|
83
83
|
/** Read-only locks scan for `pm health`: classifies every lock file with the same policy `pm gc --scope locks` uses but never removes anything. */
|
|
84
|
-
export declare function scanLockHealth(pmRoot:
|
|
84
|
+
export declare function scanLockHealth(pmRoot:string,now?:number):Promise<LockHealthScan>;
|
|
85
85
|
/** Implements run lock gc for the public runtime surface of this module. */
|
|
86
|
-
export declare function runLockGc(pmRoot:
|
|
86
|
+
export declare function runLockGc(pmRoot:string,options:LockGcOptions):Promise<LockGcResult>;
|
package/dist/core/lock/lock.d.ts
CHANGED
|
@@ -1,30 +1,30 @@
|
|
|
1
1
|
interface LockInfo {
|
|
2
|
-
id:
|
|
3
|
-
pid:
|
|
4
|
-
owner:
|
|
5
|
-
token?:
|
|
6
|
-
created_at:
|
|
7
|
-
ttl_seconds:
|
|
2
|
+
id:string;
|
|
3
|
+
pid:number;
|
|
4
|
+
owner:string;
|
|
5
|
+
token?:string;
|
|
6
|
+
created_at:string;
|
|
7
|
+
ttl_seconds:number;
|
|
8
8
|
}
|
|
9
9
|
interface LockReadResult {
|
|
10
|
-
info:
|
|
11
|
-
warnings:
|
|
10
|
+
info:LockInfo | null;
|
|
11
|
+
warnings:string[];
|
|
12
12
|
}
|
|
13
13
|
interface StaleLockRemovalResult {
|
|
14
|
-
lockInfo:
|
|
15
|
-
shouldRetryCreate:
|
|
16
|
-
staleRemovalCounted:
|
|
14
|
+
lockInfo:LockReadResult;
|
|
15
|
+
shouldRetryCreate:boolean;
|
|
16
|
+
staleRemovalCounted:boolean;
|
|
17
17
|
}
|
|
18
18
|
/** Stable operating-system identity for a process when the host exposes one. */
|
|
19
19
|
export interface ProcessIdentity {
|
|
20
20
|
/** Operating-system process identifier captured with the owner record. */
|
|
21
|
-
pid:
|
|
21
|
+
pid:number;
|
|
22
22
|
/** Host process-start coordinate that distinguishes reuse of the same PID. */
|
|
23
|
-
process_start_identity?:
|
|
23
|
+
process_start_identity?:string;
|
|
24
24
|
}
|
|
25
|
-
declare function parseLockInfo(raw:
|
|
26
|
-
declare function readLockInfo(lockPath:
|
|
27
|
-
declare function isErrno(error:
|
|
25
|
+
declare function parseLockInfo(raw:string):LockReadResult;
|
|
26
|
+
declare function readLockInfo(lockPath:string,emitReadHook?:boolean):Promise<LockReadResult>;
|
|
27
|
+
declare function isErrno(error:unknown,code:string):boolean;
|
|
28
28
|
/**
|
|
29
29
|
* Classify exclusive-create failures that prove another lock lifecycle is in
|
|
30
30
|
* flight. Windows can report `EPERM`, `EACCES`, or `EBUSY` while a just-unlinked
|
|
@@ -33,48 +33,48 @@ declare function isErrno(error: unknown, code: string): boolean;
|
|
|
33
33
|
* host. A missing or temporarily unstatable Windows path is contention only
|
|
34
34
|
* when its parent remains writable, preserving genuine permission failures.
|
|
35
35
|
*/
|
|
36
|
-
declare function isLockCreateContention(error:
|
|
37
|
-
declare function buildLockPayload(id:
|
|
38
|
-
declare function isStaleLock(info:
|
|
39
|
-
declare function lockOwnerSuffix(info:
|
|
36
|
+
declare function isLockCreateContention(error:unknown,lockPath:string,platform?:NodeJS.Platform):Promise<boolean>;
|
|
37
|
+
declare function buildLockPayload(id:string,owner:string,ttlSeconds:number,token?:string):LockInfo;
|
|
38
|
+
declare function isStaleLock(info:LockInfo | null,ttlSeconds:number):boolean;
|
|
39
|
+
declare function lockOwnerSuffix(info:LockInfo | null):string;
|
|
40
40
|
/** Resolves the effective bounded wait budget for a contended lock: the PM_LOCK_WAIT_MS environment override wins when it parses as a non-negative integer, then the caller-provided budget (settings `locks.wait_ms`), then 0 (fail-fast, the pre-wait behavior). */
|
|
41
|
-
declare function resolveLockWaitMs(waitMs:
|
|
42
|
-
declare function parseLinuxProcessStartIdentity(raw:
|
|
41
|
+
declare function resolveLockWaitMs(waitMs:number | undefined):number;
|
|
42
|
+
declare function parseLinuxProcessStartIdentity(raw:string):string | null;
|
|
43
43
|
/** Read the host process-start coordinate used to distinguish PID reuse. */
|
|
44
|
-
export declare function readProcessStartIdentity(pid:
|
|
44
|
+
export declare function readProcessStartIdentity(pid:number):Promise<string | null>;
|
|
45
45
|
/** Capture the current PID plus a host process-start coordinate when available. */
|
|
46
|
-
export declare function captureProcessIdentity(pid?:
|
|
46
|
+
export declare function captureProcessIdentity(pid?:number):Promise<ProcessIdentity>;
|
|
47
47
|
/**
|
|
48
48
|
* Verify that a captured process owner still exists, with a bounded grace
|
|
49
49
|
* period when the host cannot expose a reusable-PID-safe start coordinate.
|
|
50
50
|
*/
|
|
51
|
-
export declare function isProcessIdentityAlive(identity:
|
|
52
|
-
declare function acquireStaleCleanupGate(lockPath:
|
|
53
|
-
declare function removeConfirmedStaleLock(params:
|
|
54
|
-
lockPath:
|
|
55
|
-
id:
|
|
56
|
-
ttlSeconds:
|
|
57
|
-
force:
|
|
58
|
-
forceRequiredForStaleLock:
|
|
59
|
-
staleRemovals:
|
|
60
|
-
waitBudgetMs:
|
|
61
|
-
startedAtMs:
|
|
62
|
-
fallbackLockInfo:
|
|
63
|
-
}):
|
|
51
|
+
export declare function isProcessIdentityAlive(identity:ProcessIdentity,unverifiedAgeMs:number,maxUnverifiedAgeMs:number):Promise<boolean>;
|
|
52
|
+
declare function acquireStaleCleanupGate(lockPath:string,_id:string):Promise<(() => Promise<void>) | null>;
|
|
53
|
+
declare function removeConfirmedStaleLock(params:{
|
|
54
|
+
lockPath:string;
|
|
55
|
+
id:string;
|
|
56
|
+
ttlSeconds:number;
|
|
57
|
+
force:boolean;
|
|
58
|
+
forceRequiredForStaleLock:boolean;
|
|
59
|
+
staleRemovals:number;
|
|
60
|
+
waitBudgetMs:number;
|
|
61
|
+
startedAtMs:number;
|
|
62
|
+
fallbackLockInfo:LockReadResult;
|
|
63
|
+
}):Promise<StaleLockRemovalResult>;
|
|
64
64
|
/** Public contract for test only, shared by SDK and presentation-layer consumers. */
|
|
65
|
-
export declare const _testOnly:
|
|
66
|
-
parseLockInfo:
|
|
67
|
-
readLockInfo:
|
|
68
|
-
isErrno:
|
|
69
|
-
isLockCreateContention:
|
|
70
|
-
buildLockPayload:
|
|
71
|
-
isStaleLock:
|
|
72
|
-
lockOwnerSuffix:
|
|
73
|
-
resolveLockWaitMs:
|
|
74
|
-
parseLinuxProcessStartIdentity:
|
|
75
|
-
readProcessStartIdentity:
|
|
76
|
-
acquireStaleCleanupGate:
|
|
77
|
-
removeConfirmedStaleLock:
|
|
65
|
+
export declare const _testOnly:{
|
|
66
|
+
parseLockInfo:typeof parseLockInfo;
|
|
67
|
+
readLockInfo:typeof readLockInfo;
|
|
68
|
+
isErrno:typeof isErrno;
|
|
69
|
+
isLockCreateContention:typeof isLockCreateContention;
|
|
70
|
+
buildLockPayload:typeof buildLockPayload;
|
|
71
|
+
isStaleLock:typeof isStaleLock;
|
|
72
|
+
lockOwnerSuffix:typeof lockOwnerSuffix;
|
|
73
|
+
resolveLockWaitMs:typeof resolveLockWaitMs;
|
|
74
|
+
parseLinuxProcessStartIdentity:typeof parseLinuxProcessStartIdentity;
|
|
75
|
+
readProcessStartIdentity:typeof readProcessStartIdentity;
|
|
76
|
+
acquireStaleCleanupGate:typeof acquireStaleCleanupGate;
|
|
77
|
+
removeConfirmedStaleLock:typeof removeConfirmedStaleLock;
|
|
78
78
|
};
|
|
79
79
|
/**
|
|
80
80
|
* Acquire a token-owned tracker lock with bounded contention waiting and
|
|
@@ -82,7 +82,7 @@ removeConfirmedStaleLock: typeof removeConfirmedStaleLock;
|
|
|
82
82
|
* parent directories so acquiring or retrying a lock cannot revive removed
|
|
83
83
|
* storage. Extension overrides retain responsibility for their own lifecycle.
|
|
84
84
|
*/
|
|
85
|
-
export declare function acquireLock(pmRoot:
|
|
86
|
-
createParentDirectories?:
|
|
87
|
-
}):
|
|
85
|
+
export declare function acquireLock(pmRoot:string,id:string,ttlSeconds:number,owner:string,force?:boolean,forceRequiredForStaleLock?:boolean,waitMs?:number,options?:{
|
|
86
|
+
createParentDirectories?:boolean;
|
|
87
|
+
}):Promise<() => Promise<void>>;
|
|
88
88
|
export {};
|
|
@@ -24,11 +24,11 @@ export type ChangedFieldsMode = "full" | "compact";
|
|
|
24
24
|
/** Documents the mutation projection options payload exchanged by command, SDK, and package integrations. */
|
|
25
25
|
export interface MutationProjectionOptions {
|
|
26
26
|
/** Defaults to "full" (unchanged output). "compact" drops the array, keeping a count. */
|
|
27
|
-
changedFields?:
|
|
27
|
+
changedFields?:ChangedFieldsMode;
|
|
28
28
|
/** Return the default agent envelope: id, status, changed-field count, and close reason. */
|
|
29
|
-
compactEnvelope?:
|
|
29
|
+
compactEnvelope?:boolean;
|
|
30
30
|
/** Return only id/status for single-item mutation envelopes. */
|
|
31
|
-
idOnly?:
|
|
31
|
+
idOnly?:boolean;
|
|
32
32
|
}
|
|
33
33
|
/** Returns a copy of a mutation result with the envelope `changed_fields` arrays replaced by `changed_field_count` when compact mode is requested. Inputs that are not a mutation envelope (or full mode) are returned unchanged (same reference). */
|
|
34
|
-
export declare function projectMutationResult(result:
|
|
34
|
+
export declare function projectMutationResult(result:unknown,options?:MutationProjectionOptions):unknown;
|
|
@@ -8,11 +8,11 @@ export declare const SUPPRESS_HOST_OUTPUT_MARKER = "@unbrained/pm-cli:suppress-h
|
|
|
8
8
|
/** A handled result that tells a pm host not to render or write another payload. */
|
|
9
9
|
export interface SuppressedHostOutput<TResult = unknown> {
|
|
10
10
|
/** Explicit protocol marker consumed by CLI and SDK-built presentation hosts. */
|
|
11
|
-
readonly __pm_suppress_host_output:
|
|
11
|
+
readonly __pm_suppress_host_output:typeof SUPPRESS_HOST_OUTPUT_MARKER;
|
|
12
12
|
/** Optional structured result retained for hooks, telemetry, and embedding hosts. */
|
|
13
|
-
readonly result?:
|
|
13
|
+
readonly result?:TResult;
|
|
14
14
|
}
|
|
15
15
|
/** Return from a command/exporter after it has written its own streaming, binary, or pre-rendered output. */
|
|
16
|
-
export declare function suppressHostOutput<TResult = undefined>(result?:
|
|
16
|
+
export declare function suppressHostOutput<TResult = undefined>(result?:TResult):SuppressedHostOutput<TResult>;
|
|
17
17
|
/** Detect the public suppression result without relying on object identity across package boundaries. */
|
|
18
|
-
export declare function isHostOutputSuppressed(value:
|
|
18
|
+
export declare function isHostOutputSuppressed(value:unknown):value is SuppressedHostOutput;
|
|
@@ -1,67 +1,67 @@
|
|
|
1
1
|
/** Host output controls shared by command execution and extension rendering. */
|
|
2
2
|
export interface OutputOptions {
|
|
3
3
|
/** Select JSON explicitly; otherwise use the host default format. */
|
|
4
|
-
json?:
|
|
4
|
+
json?:boolean;
|
|
5
5
|
/** Suppress process output while retaining the active command result. */
|
|
6
|
-
quiet?:
|
|
6
|
+
quiet?:boolean;
|
|
7
7
|
/** When true, mutation results drop the verbose changed_fields array (keeps changed_field_count). */
|
|
8
|
-
noChangedFields?:
|
|
8
|
+
noChangedFields?:boolean;
|
|
9
9
|
/** When true, preserve the legacy full mutation envelope and changed-fields array. */
|
|
10
|
-
fullChangedFields?:
|
|
10
|
+
fullChangedFields?:boolean;
|
|
11
11
|
/** When true, single-item mutation results print only id and status. */
|
|
12
|
-
idOnly?:
|
|
12
|
+
idOnly?:boolean;
|
|
13
13
|
/** When true, JSON output omits null, undefined, and empty containers recursively. */
|
|
14
|
-
lean?:
|
|
14
|
+
lean?:boolean;
|
|
15
15
|
/** Attach a bounded receipt for the emitted output before the receipt itself. */
|
|
16
|
-
tokenAccounting?:
|
|
16
|
+
tokenAccounting?:boolean;
|
|
17
17
|
/** Canonical comma-separated fields or sections retained in read output. */
|
|
18
|
-
outputInclude?:
|
|
18
|
+
outputInclude?:string;
|
|
19
19
|
/** Canonical maximum row count retained in read output. */
|
|
20
|
-
outputLimit?:
|
|
20
|
+
outputLimit?:string;
|
|
21
21
|
/** Canonical estimated-token ceiling for read output. */
|
|
22
|
-
outputBudget?:
|
|
22
|
+
outputBudget?:string;
|
|
23
23
|
/** Canonical renderer encoding for read output. */
|
|
24
|
-
outputFormat?:
|
|
24
|
+
outputFormat?:"toon" | "json";
|
|
25
25
|
/** Caller-carried cross-call budget and served-item state. */
|
|
26
|
-
outputSession?:
|
|
26
|
+
outputSession?:string;
|
|
27
27
|
/** Opaque budget-compaction continuation cursor. */
|
|
28
|
-
outputCursor?:
|
|
28
|
+
outputCursor?:string;
|
|
29
29
|
/** Include machine-readable row location and row-encoding metadata. */
|
|
30
|
-
outputRowContract?:
|
|
30
|
+
outputRowContract?:boolean;
|
|
31
31
|
/** Fallback output format used when callers do not provide an override. */
|
|
32
|
-
defaultOutputFormat?:
|
|
32
|
+
defaultOutputFormat?:"toon" | "json";
|
|
33
33
|
/** Command identity used to resolve read contracts and extension overrides. */
|
|
34
|
-
command?:
|
|
34
|
+
command?:string;
|
|
35
35
|
/** Positional arguments passed to the output service override. */
|
|
36
|
-
commandArgs?:
|
|
36
|
+
commandArgs?:string[];
|
|
37
37
|
/** Command options merged with active invocation options for output contracts. */
|
|
38
|
-
commandOptions?:
|
|
38
|
+
commandOptions?:Record<string,unknown>;
|
|
39
39
|
/** Tracker root supplied to the output service override. */
|
|
40
|
-
pmRoot?:
|
|
40
|
+
pmRoot?:string;
|
|
41
41
|
}
|
|
42
42
|
/** Write stdout and return false when its consumer has closed the pipe. */
|
|
43
|
-
export declare function writeStdout(text:
|
|
43
|
+
export declare function writeStdout(text:string):boolean;
|
|
44
44
|
/** Write stderr and preserve diagnostic delivery failures in the process exit code. */
|
|
45
|
-
export declare function writeStderr(text:
|
|
45
|
+
export declare function writeStderr(text:string):boolean;
|
|
46
46
|
/** Keep sparse presentation rules shared while allowing lean JSON to retain count aliases. */
|
|
47
|
-
declare function compactToonValue(value:
|
|
47
|
+
declare function compactToonValue(value:unknown,omitDuplicateCountAliases?:boolean):unknown | undefined;
|
|
48
48
|
/** Render objects recursively and arrays through the standard TOON encoder. */
|
|
49
|
-
declare function renderToonValue(value:
|
|
49
|
+
declare function renderToonValue(value:unknown,depth:number):string;
|
|
50
50
|
/**
|
|
51
51
|
* Render a result with pm's built-in JSON or TOON formatter without invoking
|
|
52
52
|
* extension overrides. SDK budget accounting uses this exact representation
|
|
53
53
|
* so reported token cost describes the bytes the host emits by default.
|
|
54
54
|
*/
|
|
55
|
-
export declare function formatBuiltInOutput(result:
|
|
55
|
+
export declare function formatBuiltInOutput(result:unknown,format:"json" | "toon"):string;
|
|
56
56
|
/** Resolve command ownership and suppression before projecting and rendering the result. */
|
|
57
|
-
export declare function formatOutput(result:
|
|
57
|
+
export declare function formatOutput(result:unknown,options:OutputOptions):string;
|
|
58
58
|
/** Apply declared exit codes and mutation projection before writing a nonquiet result. */
|
|
59
|
-
export declare function printResult(result:
|
|
59
|
+
export declare function printResult(result:unknown,options:OutputOptions):void;
|
|
60
60
|
/** Apply the error service override and emit one newline-terminated diagnostic. */
|
|
61
|
-
export declare function printError(message:
|
|
61
|
+
export declare function printError(message:string):void;
|
|
62
62
|
/** Internal rendering seams retained for deterministic presentation regression tests. */
|
|
63
|
-
export declare const outputTestOnly:
|
|
64
|
-
compactToonValue:
|
|
65
|
-
renderToonValue:
|
|
63
|
+
export declare const outputTestOnly:{
|
|
64
|
+
compactToonValue:typeof compactToonValue;
|
|
65
|
+
renderToonValue:typeof renderToonValue;
|
|
66
66
|
};
|
|
67
67
|
export {};
|
|
@@ -10,12 +10,12 @@
|
|
|
10
10
|
/** Compact echo of filters and projection mode applied to list/search responses. */
|
|
11
11
|
export interface QuerySummary {
|
|
12
12
|
/** Value that configures or reports filters for this contract. */
|
|
13
|
-
filters:
|
|
13
|
+
filters:Record<string,unknown>;
|
|
14
14
|
/** Value that configures or reports projection for this contract. */
|
|
15
|
-
projection:
|
|
15
|
+
projection:string;
|
|
16
16
|
}
|
|
17
17
|
/** Resolve the projection label implied by list/search projection options. Used when the result payload itself carries no projection metadata (the compact summary paths omit it for token efficiency). */
|
|
18
|
-
export declare function resolveQueryProjectionLabel(options:
|
|
18
|
+
export declare function resolveQueryProjectionLabel(options:Record<string,unknown>):string;
|
|
19
19
|
/**
|
|
20
20
|
* Attach a `query_summary` to a list/search result.
|
|
21
21
|
*
|
|
@@ -25,6 +25,6 @@ export declare function resolveQueryProjectionLabel(options: Record<string, unkn
|
|
|
25
25
|
* verbose payloads, and the options-derived label covers the compact summary
|
|
26
26
|
* paths that omit projection metadata.
|
|
27
27
|
*/
|
|
28
|
-
export declare function withQuerySummary<T extends Record<string,
|
|
29
|
-
query_summary:
|
|
28
|
+
export declare function withQuerySummary<T extends Record<string,unknown>>(result:T,options:Record<string,unknown>):T & {
|
|
29
|
+
query_summary:QuerySummary;
|
|
30
30
|
};
|
|
@@ -7,8 +7,8 @@
|
|
|
7
7
|
* spreadsheet or terminal get a directly consumable shape.
|
|
8
8
|
*/
|
|
9
9
|
/** A projected row: a flat map of column name to scalar/collection cell value. */
|
|
10
|
-
export type TabularRow = Record<string,
|
|
10
|
+
export type TabularRow = Record<string,unknown>;
|
|
11
11
|
/** Renders rows as RFC 4180 CSV with a header row of column names. Returns an empty string when there are no rows so callers emit nothing rather than a stray blank line. */
|
|
12
|
-
export declare function renderRowsAsCsv(rows:
|
|
12
|
+
export declare function renderRowsAsCsv(rows:TabularRow[]):string;
|
|
13
13
|
/** Renders rows as a fixed-width text table: a header row, a dashed separator, and one padded row per item. Columns are widened to fit their widest cell so the output stays aligned in a monospace terminal. Returns an empty string when there are no rows. */
|
|
14
|
-
export declare function renderRowsAsTable(rows:
|
|
14
|
+
export declare function renderRowsAsTable(rows:TabularRow[]):string;
|