@unbrained/pm-cli 2026.10.14 → 2026.10.17
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/skills/pm-developer/references/COMMAND_PLAYBOOK.md +1 -1
- package/.claude-plugin/marketplace.json +1 -1
- package/AGENTS.md +1 -0
- package/CHANGELOG.md +74 -2
- package/dist/cli/after-command-context-usage.d.ts +7 -7
- package/dist/cli/argv-utils.d.ts +4 -4
- package/dist/cli/bundle-integrity.d.ts +16 -16
- package/dist/cli/command-namespaces.d.ts +1 -1
- package/dist/cli/commander-usage.d.ts +34 -34
- package/dist/cli/commands/governance/validate.d.ts +1 -1
- package/dist/cli/commands/history/history-compact.d.ts +1 -1
- package/dist/cli/commands/history/history-redact.d.ts +1 -1
- package/dist/cli/commands/history/history-repair.d.ts +1 -1
- package/dist/cli/commands/history/restore.d.ts +1 -1
- package/dist/cli/commands/lifecycle/close.d.ts +1 -1
- package/dist/cli/commands/lifecycle/copy.d.ts +1 -1
- package/dist/cli/commands/lifecycle/delete.d.ts +1 -1
- package/dist/cli/commands/lifecycle/focus.d.ts +1 -1
- package/dist/cli/commands/query/get.d.ts +1 -1
- package/dist/cli/commands/workspace/merge.d.ts +1 -1
- package/dist/cli/commands/workspace/schema.d.ts +1 -1
- package/dist/cli/context-intent-invocation.d.ts +1 -1
- package/dist/cli/description-stdin.d.ts +1 -1
- package/dist/cli/error-guidance.d.ts +119 -119
- package/dist/cli/extension-command-help.d.ts +64 -64
- package/dist/cli/extension-command-help.js +2 -2
- package/dist/cli/extension-command-options.d.ts +18 -16
- package/dist/cli/extension-command-options.js +1 -1
- package/dist/cli/extension-recovery.d.ts +13 -13
- package/dist/cli/help-content.d.ts +22 -22
- package/dist/cli/help-content.js +3 -3
- package/dist/cli/help-json-payload.d.ts +45 -45
- package/dist/cli/invocation-profile.d.ts +5 -5
- package/dist/cli/main.d.ts +217 -217
- package/dist/cli/migration-gates.d.ts +24 -24
- package/dist/cli/option-values.d.ts +1 -1
- package/dist/cli/public.d.ts +1 -1
- package/dist/cli/register-annotations.d.ts +2 -2
- package/dist/cli/register-assurance.d.ts +1 -1
- package/dist/cli/register-files-lookup.d.ts +1 -1
- package/dist/cli/register-history-activity.d.ts +1 -1
- package/dist/cli/register-history-author.d.ts +1 -1
- package/dist/cli/register-history-maintenance.d.ts +1 -1
- package/dist/cli/register-list-query.d.ts +7 -7
- package/dist/cli/register-list-query.js +3 -3
- package/dist/cli/register-mutation-options.d.ts +1 -1
- package/dist/cli/register-mutation.d.ts +4 -4
- package/dist/cli/register-mutation.js +2 -2
- package/dist/cli/register-operations.d.ts +75 -75
- package/dist/cli/register-operations.js +1 -1
- package/dist/cli/register-setup.d.ts +4 -4
- package/dist/cli/register-structured-mutation.d.ts +8 -13
- package/dist/cli/register-structured-mutation.js +1 -1
- package/dist/cli/runtime/activation.d.ts +23 -23
- package/dist/cli/runtime/invocation-options.d.ts +12 -12
- package/dist/cli/runtime/invocation-options.js +1 -1
- package/dist/cli/runtime/projection-retry.d.ts +1 -1
- package/dist/cli/runtime/selection.d.ts +16 -16
- package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
- package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
- package/dist/cli/schema/registration.d.ts +1 -1
- package/dist/cli/schema-registration-helpers.d.ts +2 -2
- package/dist/cli/stats-analytics-json.d.ts +1 -1
- package/dist/cli-bundle/bundle-manifest.json +1 -1
- package/dist/cli-bundle/chunks/{chunk-LKESCZEN.js → chunk-3QKI3XNX.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-4PNPDT2N.js +236 -0
- package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-6ZDKKOKM.js} +28 -28
- package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-B5QVGCZX.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-5LU6PWA4.js → chunk-EA2CG7UM.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-HY7FQ7QX.js +2 -0
- package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-J4LPQCET.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-JS3B2M4D.js +6 -0
- package/dist/cli-bundle/chunks/chunk-O4YBC3OM.js +30 -0
- package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-OZCSXX4D.js} +63 -64
- package/dist/cli-bundle/chunks/chunk-VMCSTFSO.js +2 -0
- package/dist/cli-bundle/chunks/chunk-W3KZ22DW.js +2 -0
- package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-X2ONXFBP.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-X53HM753.js +20 -0
- package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-RU3QZSAQ.js} +7 -7
- package/dist/cli-bundle/chunks/register-mutation-EQYMT32A.js +20 -0
- package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-VXBGE4XI.js} +2 -2
- package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-UUDEGFRO.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-2IOHHNRT.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-5JEFDEL3.js +166 -0
- package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-AH6NX6GM.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-E33QA7PK.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-FTUZ3JF2.js} +6 -6
- package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-JXR6UKFM.js} +3 -3
- package/dist/cli-bundle/focused-chunks/chunk-LDKX4KYJ.js +2 -0
- package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-MBQF6HT6.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-NZO7GOXD.js +20 -0
- package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-PYC7BF6Z.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-QOSVJDOO.js} +61 -62
- package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-RBLSY6ML.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-RHTH5ILM.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-SIGIGZCG.js} +3 -3
- package/dist/cli-bundle/focused-chunks/chunk-TRFVAWF2.js +26 -0
- package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-UNTQE37U.js} +2 -2
- package/dist/cli-bundle/main.js +22 -22
- package/dist/cli-bundle/sdk-authoring.js +1 -1
- package/dist/cli-bundle/sdk-contracts.js +2 -2
- package/dist/cli-bundle/sdk-core.js +23 -23
- package/dist/cli-bundle/sdk-governance.js +1 -1
- package/dist/cli-bundle/sdk-graph.js +1 -1
- package/dist/cli-bundle/sdk-merge.js +54 -54
- package/dist/cli-bundle/sdk-query.js +1 -1
- package/dist/cli-bundle/sdk-runtime.js +1 -1
- package/dist/cli-bundle/sdk-testing.js +1 -1
- package/dist/cli-bundle/sdk.js +7 -7
- package/dist/cli.d.ts +9 -9
- package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
- package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
- package/dist/core/config/nested-settings.d.ts +20 -20
- package/dist/core/config/positional-value.d.ts +9 -9
- package/dist/core/diagnostics/remediation.d.ts +7 -7
- package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
- package/dist/core/extensions/activation-summary.d.ts +30 -30
- package/dist/core/extensions/activation-transaction.d.ts +9 -9
- package/dist/core/extensions/capability-usage.d.ts +25 -25
- package/dist/core/extensions/command-hook-context.d.ts +15 -15
- package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
- package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
- package/dist/core/extensions/contribution-inventory.d.ts +24 -24
- package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
- package/dist/core/extensions/extension-candidate.d.ts +14 -14
- package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
- package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
- package/dist/core/extensions/extension-policy.d.ts +62 -62
- package/dist/core/extensions/extension-registries.d.ts +8 -8
- package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
- package/dist/core/extensions/extension-types.d.ts +717 -702
- package/dist/core/extensions/extension-types.js +1 -1
- package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
- package/dist/core/extensions/flag-value-types.d.ts +32 -4
- package/dist/core/extensions/flag-value-types.js +1 -1
- package/dist/core/extensions/index.d.ts +34 -34
- package/dist/core/extensions/item-field-types.d.ts +3 -3
- package/dist/core/extensions/item-fields.d.ts +6 -6
- package/dist/core/extensions/loader.d.ts +66 -66
- package/dist/core/extensions/manifest-parser.d.ts +1 -1
- package/dist/core/extensions/manifest-schema.d.ts +13 -13
- package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
- package/dist/core/extensions/preflight-ownership.d.ts +3 -3
- package/dist/core/extensions/read-output-contract.d.ts +2 -2
- package/dist/core/extensions/registration-contracts.d.ts +12 -12
- package/dist/core/extensions/registration-contracts.js +1 -1
- package/dist/core/extensions/registration-validation.d.ts +6 -6
- package/dist/core/extensions/registration-values.d.ts +19 -19
- package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
- package/dist/core/extensions/runtime-registrations.d.ts +6 -6
- package/dist/core/extensions/service-ownership.d.ts +1 -1
- package/dist/core/extensions/version-compat.d.ts +9 -9
- package/dist/core/fs/atomic-create.d.ts +1 -1
- package/dist/core/fs/fs-utils.d.ts +12 -12
- package/dist/core/fs/host-environment-errors.d.ts +10 -10
- package/dist/core/fs/path-utils.d.ts +1 -1
- package/dist/core/governance/content-fields.d.ts +25 -25
- package/dist/core/governance/issue-codes.d.ts +16 -16
- package/dist/core/governance/metadata-coverage.d.ts +64 -64
- package/dist/core/history/digest.d.ts +5 -5
- package/dist/core/history/drift-cache.d.ts +2 -2
- package/dist/core/history/drift-scan.d.ts +18 -18
- package/dist/core/history/event-classification.d.ts +4 -4
- package/dist/core/history/event-index.d.ts +33 -33
- package/dist/core/history/history-compact-bulk.d.ts +12 -12
- package/dist/core/history/history-diff.d.ts +15 -15
- package/dist/core/history/history-rewrite.d.ts +43 -43
- package/dist/core/history/history-storage-stats.d.ts +20 -20
- package/dist/core/history/history-stream-policy.d.ts +12 -12
- package/dist/core/history/history.d.ts +45 -45
- package/dist/core/history/identity.d.ts +4 -4
- package/dist/core/history/operation-contract.d.ts +17 -17
- package/dist/core/history/projection.d.ts +16 -16
- package/dist/core/history/read.d.ts +4 -4
- package/dist/core/history/replay.d.ts +47 -47
- package/dist/core/history/tombstone.d.ts +1 -1
- package/dist/core/history/version-address.d.ts +2 -2
- package/dist/core/history/workspace-history.d.ts +72 -72
- package/dist/core/io/body-file.d.ts +2 -2
- package/dist/core/io/bulk-ids-input.d.ts +7 -7
- package/dist/core/item/actionability.d.ts +30 -30
- package/dist/core/item/dependency-reference.d.ts +2 -2
- package/dist/core/item/id.d.ts +9 -9
- package/dist/core/item/item-format-version.d.ts +17 -15
- package/dist/core/item/item-format-version.js +1 -1
- package/dist/core/item/item-format.d.ts +54 -54
- package/dist/core/item/item-format.js +3 -3
- package/dist/core/item/item-record.d.ts +1 -1
- package/dist/core/item/item-type-definition.d.ts +11 -11
- package/dist/core/item/parent-reference-policy.d.ts +6 -6
- package/dist/core/item/parse.d.ts +37 -37
- package/dist/core/item/plan-lifecycle.d.ts +4 -4
- package/dist/core/item/priority.d.ts +3 -3
- package/dist/core/item/sprint-release-format.d.ts +4 -4
- package/dist/core/item/status-filter.d.ts +5 -5
- package/dist/core/item/status.d.ts +3 -3
- package/dist/core/item/toon-decode.d.ts +10 -10
- package/dist/core/item/type-registry.d.ts +35 -35
- package/dist/core/item/type-synonyms.d.ts +2 -2
- package/dist/core/lock/lock-gc.d.ts +28 -28
- package/dist/core/lock/lock.d.ts +53 -53
- package/dist/core/output/mutation-projection.d.ts +4 -25
- package/dist/core/output/mutation-projection.js +1 -1
- package/dist/core/output/output-control.d.ts +4 -4
- package/dist/core/output/output.d.ts +30 -30
- package/dist/core/output/query-summary.d.ts +5 -5
- package/dist/core/output/tabular.d.ts +3 -3
- package/dist/core/packages/manifest.d.ts +30 -30
- package/dist/core/packages/root.d.ts +4 -4
- package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
- package/dist/core/policy/workflow-policy-store.d.ts +15 -15
- package/dist/core/policy/workflow-policy.d.ts +56 -56
- package/dist/core/profile/profile-describe.d.ts +22 -22
- package/dist/core/profile/profile-lint.d.ts +13 -13
- package/dist/core/profile/profile-plan.d.ts +45 -45
- package/dist/core/profile/profile-presets.d.ts +36 -36
- package/dist/core/reproducibility/context.d.ts +9 -9
- package/dist/core/schema/fields-file.d.ts +35 -35
- package/dist/core/schema/item-types-file.d.ts +29 -29
- package/dist/core/schema/runtime-field-filters.d.ts +3 -3
- package/dist/core/schema/runtime-field-values.d.ts +7 -7
- package/dist/core/schema/runtime-schema.d.ts +59 -59
- package/dist/core/schema/status-defs-file.d.ts +29 -29
- package/dist/core/schema/status-token.d.ts +1 -1
- package/dist/core/schema/type-inference.d.ts +10 -10
- package/dist/core/schema/type-presets.d.ts +5 -5
- package/dist/core/schema/type-workflows.d.ts +15 -15
- package/dist/core/schema/type-workflows.js +1 -1
- package/dist/core/search/background-refresh.d.ts +12 -12
- package/dist/core/search/bm25.d.ts +16 -16
- package/dist/core/search/cache.d.ts +34 -34
- package/dist/core/search/corpus.d.ts +17 -17
- package/dist/core/search/embedding-batches.d.ts +25 -25
- package/dist/core/search/eval-thresholds.d.ts +4 -4
- package/dist/core/search/eval.d.ts +40 -40
- package/dist/core/search/http-client.d.ts +24 -24
- package/dist/core/search/providers.d.ts +30 -30
- package/dist/core/search/relevance.d.ts +17 -17
- package/dist/core/search/semantic-defaults.d.ts +5 -5
- package/dist/core/search/staleness.d.ts +3 -3
- package/dist/core/search/vector-stores.d.ts +51 -51
- package/dist/core/search/vectorization-metadata.d.ts +9 -9
- package/dist/core/sentry/helpers.d.ts +27 -27
- package/dist/core/sentry/instrument.d.ts +51 -51
- package/dist/core/sentry/instrument.js +1 -1
- package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
- package/dist/core/sentry/sensitive-assignments.js +2 -0
- package/dist/core/session/session-state.d.ts +37 -37
- package/dist/core/shared/agent-session-context.d.ts +14 -14
- package/dist/core/shared/author.d.ts +89 -89
- package/dist/core/shared/command-line.d.ts +3 -3
- package/dist/core/shared/command-types.d.ts +20 -20
- package/dist/core/shared/conflict-markers.d.ts +5 -5
- package/dist/core/shared/constants.d.ts +30 -30
- package/dist/core/shared/errors.d.ts +100 -100
- package/dist/core/shared/html-entity-decode.d.ts +2 -2
- package/dist/core/shared/item-metadata-contract.d.ts +2 -2
- package/dist/core/shared/lazy-module.d.ts +1 -1
- package/dist/core/shared/levenshtein.d.ts +1 -1
- package/dist/core/shared/memo.d.ts +1 -1
- package/dist/core/shared/numeric-parsers.d.ts +1 -1
- package/dist/core/shared/option-alias-visibility.d.ts +3 -3
- package/dist/core/shared/primitives.d.ts +13 -13
- package/dist/core/shared/secret-rules.d.ts +92 -92
- package/dist/core/shared/serial-queue.d.ts +6 -6
- package/dist/core/shared/serialization.d.ts +4 -4
- package/dist/core/shared/split-comma-list.d.ts +4 -4
- package/dist/core/shared/text-normalization.d.ts +5 -3
- package/dist/core/shared/text-normalization.js +1 -1
- package/dist/core/shared/time.d.ts +27 -27
- package/dist/core/store/item-format-migration.d.ts +7 -7
- package/dist/core/store/item-metadata-cache.d.ts +30 -30
- package/dist/core/store/item-metadata-query-index.d.ts +66 -66
- package/dist/core/store/item-metadata-read-work.d.ts +6 -6
- package/dist/core/store/item-mutation-precondition.d.ts +11 -0
- package/dist/core/store/item-mutation-precondition.js +2 -0
- package/dist/core/store/item-store.d.ts +123 -123
- package/dist/core/store/item-store.js +1 -1
- package/dist/core/store/paths.d.ts +27 -27
- package/dist/core/store/settings-concurrency.d.ts +1 -1
- package/dist/core/store/settings-read-cache.d.ts +11 -11
- package/dist/core/store/settings-validator.d.ts +117 -117
- package/dist/core/store/settings.d.ts +84 -84
- package/dist/core/store/sqlite-runtime.d.ts +2 -2
- package/dist/core/store/tracker-preflight.d.ts +3 -3
- package/dist/core/telemetry/consent.d.ts +1 -1
- package/dist/core/telemetry/observability.d.ts +16 -16
- package/dist/core/telemetry/policy.d.ts +7 -7
- package/dist/core/telemetry/read-sampling.d.ts +1 -1
- package/dist/core/telemetry/runtime.d.ts +275 -275
- package/dist/core/test/background-runs.d.ts +123 -123
- package/dist/core/test/item-test-run-tracking.d.ts +10 -10
- package/dist/core/test/run-selectors.d.ts +12 -12
- package/dist/core/validate/estimate-defaults.d.ts +3 -3
- package/dist/core/validate/fix-planning.d.ts +36 -36
- package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
- package/dist/core/validate/missing-by-type.d.ts +3 -3
- package/dist/core/validate/missing-link-owners.d.ts +17 -17
- package/dist/core/validate/stale-file-classification.d.ts +6 -6
- package/dist/mcp/http-server.d.ts +26 -26
- package/dist/mcp/legacy-adapter.d.ts +18 -18
- package/dist/mcp/runtime-capabilities.d.ts +18 -18
- package/dist/mcp/server.d.ts +73 -73
- package/dist/mcp/server.js +1 -1
- package/dist/mcp/tool-definitions.d.ts +27 -27
- package/dist/mcp/tool-definitions.js +1 -1
- package/dist/sdk/actionability.d.ts +1 -1
- package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
- package/dist/sdk/agent/command-recovery.d.ts +5 -5
- package/dist/sdk/agent/command-suggestions.d.ts +4 -4
- package/dist/sdk/agent/create-option-policy.d.ts +2 -2
- package/dist/sdk/agent/identity-config.d.ts +18 -18
- package/dist/sdk/agent/item-addressing.d.ts +6 -6
- package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
- package/dist/sdk/agent/refusal-closure.d.ts +22 -22
- package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
- package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
- package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
- package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
- package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
- package/dist/sdk/agent-capability-contracts.d.ts +41 -41
- package/dist/sdk/agent-session-context.d.ts +1 -1
- package/dist/sdk/annotations.d.ts +74 -74
- package/dist/sdk/author-attribution.d.ts +47 -47
- package/dist/sdk/authoring.d.ts +9 -9
- package/dist/sdk/cli-bootstrap.d.ts +65 -65
- package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
- package/dist/sdk/cli-contracts/agent-output-contracts.js +1 -1
- package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
- package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
- package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
- package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
- package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
- package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
- package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
- package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
- package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
- package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
- package/dist/sdk/cli-contracts/flag-lexicon-contracts.js +1 -1
- package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
- package/dist/sdk/cli-contracts/registration-helpers.d.ts +57 -57
- package/dist/sdk/cli-contracts/registration-helpers.js +1 -1
- package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
- package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
- package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
- package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
- package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
- package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
- package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
- package/dist/sdk/cli-contracts/tool-schema.js +1 -1
- package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
- package/dist/sdk/cli-contracts.d.ts +15 -15
- package/dist/sdk/cli-program.d.ts +1 -1
- package/dist/sdk/cli-program.js +1 -1
- package/dist/sdk/command-line.d.ts +3 -3
- package/dist/sdk/comments.d.ts +24 -24
- package/dist/sdk/compile-cache.d.ts +4 -4
- package/dist/sdk/completion/bash.d.ts +1 -1
- package/dist/sdk/completion/fish.d.ts +1 -1
- package/dist/sdk/completion/shared.d.ts +74 -74
- package/dist/sdk/completion/zsh.d.ts +1 -1
- package/dist/sdk/completion.d.ts +3 -3
- package/dist/sdk/compose.d.ts +94 -94
- package/dist/sdk/config.d.ts +105 -105
- package/dist/sdk/context/recency.d.ts +1 -1
- package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
- package/dist/sdk/context/usage-egress.d.ts +1 -1
- package/dist/sdk/context/usage-ledger.d.ts +18 -18
- package/dist/sdk/context-intent-contracts.d.ts +37 -37
- package/dist/sdk/context-intent-contracts.js +1 -1
- package/dist/sdk/context-intent-runtime.d.ts +10 -10
- package/dist/sdk/context-packing.d.ts +44 -44
- package/dist/sdk/context-relevance.d.ts +110 -110
- package/dist/sdk/context-signal-store.d.ts +52 -52
- package/dist/sdk/context-usage.d.ts +78 -78
- package/dist/sdk/contracts.d.ts +2 -1
- package/dist/sdk/contracts.js +1 -1
- package/dist/sdk/core-governance.d.ts +5 -5
- package/dist/sdk/core.d.ts +9 -8
- package/dist/sdk/core.js +1 -1
- package/dist/sdk/corpus-shape.d.ts +60 -60
- package/dist/sdk/define.d.ts +36 -36
- package/dist/sdk/dependencies.d.ts +70 -70
- package/dist/sdk/dependency-flag-validation.d.ts +17 -17
- package/dist/sdk/dependency-provenance.d.ts +22 -22
- package/dist/sdk/docs.d.ts +17 -17
- package/dist/sdk/duplicates.d.ts +14 -14
- package/dist/sdk/environment/agent-environment.d.ts +118 -118
- package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
- package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
- package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
- package/dist/sdk/environment/source-context.d.ts +4 -4
- package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
- package/dist/sdk/error-code-catalog.d.ts +33 -33
- package/dist/sdk/error-runtime.d.ts +5 -5
- package/dist/sdk/errors.d.ts +17 -17
- package/dist/sdk/eval.d.ts +27 -27
- package/dist/sdk/extension/author-manifest.d.ts +9 -9
- package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
- package/dist/sdk/extension/concurrency.d.ts +1 -1
- package/dist/sdk/extension/copy-scope.d.ts +1 -1
- package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
- package/dist/sdk/extension/describe.d.ts +21 -21
- package/dist/sdk/extension/doctor.d.ts +46 -46
- package/dist/sdk/extension/install-plan.d.ts +32 -32
- package/dist/sdk/extension/install-receipts.d.ts +4 -4
- package/dist/sdk/extension/install-runtime.d.ts +12 -12
- package/dist/sdk/extension/install-snapshot.d.ts +10 -10
- package/dist/sdk/extension/install-sources.d.ts +106 -106
- package/dist/sdk/extension/managed-state.d.ts +42 -42
- package/dist/sdk/extension/managed-update-status.d.ts +1 -1
- package/dist/sdk/extension/migrations.d.ts +48 -48
- package/dist/sdk/extension/output-ownership.d.ts +19 -19
- package/dist/sdk/extension/runtime-summary.d.ts +7 -7
- package/dist/sdk/extension/scaffold.d.ts +15 -15
- package/dist/sdk/extension/shared.d.ts +16 -16
- package/dist/sdk/extension/source-resolution.d.ts +16 -16
- package/dist/sdk/extension/static-inventory.d.ts +23 -23
- package/dist/sdk/extension/update-check.d.ts +9 -9
- package/dist/sdk/extension-command-context.d.ts +1 -1
- package/dist/sdk/extension-contracts.d.ts +10 -10
- package/dist/sdk/extension.d.ts +221 -221
- package/dist/sdk/files.d.ts +101 -101
- package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
- package/dist/sdk/flag-invocation-contracts.js +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-1.js +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
- package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
- package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
- package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
- package/dist/sdk/governance/assurance-action.d.ts +46 -46
- package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
- package/dist/sdk/governance/assurance-presets.d.ts +25 -25
- package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
- package/dist/sdk/governance/assurance.d.ts +204 -204
- package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
- package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
- package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
- package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
- package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
- package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
- package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
- package/dist/sdk/governance/extension-host-version.d.ts +9 -9
- package/dist/sdk/governance/gc.d.ts +26 -26
- package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
- package/dist/sdk/governance/health.d.ts +172 -172
- package/dist/sdk/governance/health.js +1 -1
- package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
- package/dist/sdk/governance/linked-file-report.d.ts +15 -15
- package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
- package/dist/sdk/governance/provenance-health.d.ts +35 -35
- package/dist/sdk/governance/reindex.d.ts +102 -102
- package/dist/sdk/governance/reliability.d.ts +29 -29
- package/dist/sdk/governance/stale-work.d.ts +13 -13
- package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
- package/dist/sdk/governance/storage-integrity.d.ts +28 -28
- package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
- package/dist/sdk/governance/upgrade.d.ts +77 -77
- package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
- package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
- package/dist/sdk/governance/validate-normalization.d.ts +4 -4
- package/dist/sdk/governance/validate.d.ts +176 -176
- package/dist/sdk/governance/validate.js +1 -1
- package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
- package/dist/sdk/governance/workflow-policy.d.ts +18 -18
- package/dist/sdk/governance/workspace-position.d.ts +40 -40
- package/dist/sdk/governance.d.ts +2 -2
- package/dist/sdk/graph/adapter.d.ts +45 -45
- package/dist/sdk/graph/analytics.d.ts +36 -36
- package/dist/sdk/graph/assembly.d.ts +51 -51
- package/dist/sdk/graph/cache.d.ts +19 -19
- package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
- package/dist/sdk/graph/centrality.d.ts +20 -20
- package/dist/sdk/graph/conformance.d.ts +21 -21
- package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
- package/dist/sdk/graph/durable-cache.d.ts +22 -22
- package/dist/sdk/graph/governance-contracts.d.ts +1 -1
- package/dist/sdk/graph/governance.d.ts +92 -92
- package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
- package/dist/sdk/graph/index.d.ts +15 -15
- package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
- package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
- package/dist/sdk/graph/query-contracts.d.ts +6 -6
- package/dist/sdk/graph/remediation.d.ts +15 -15
- package/dist/sdk/graph/run.d.ts +203 -203
- package/dist/sdk/graph/scheduling.d.ts +21 -21
- package/dist/sdk/graph/traversal.d.ts +18 -18
- package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
- package/dist/sdk/guide-topics.d.ts +19 -19
- package/dist/sdk/guide-topics.js +1 -1
- package/dist/sdk/guide.d.ts +43 -43
- package/dist/sdk/history/attestation-command.d.ts +8 -8
- package/dist/sdk/history/attestation-contract.d.ts +43 -43
- package/dist/sdk/history/attestation-scan.d.ts +4 -4
- package/dist/sdk/history/attestation.d.ts +4 -4
- package/dist/sdk/history/maintenance.d.ts +25 -25
- package/dist/sdk/history/salvage.d.ts +19 -19
- package/dist/sdk/history/subject.d.ts +8 -8
- package/dist/sdk/history-analytics.d.ts +64 -64
- package/dist/sdk/history-compact.d.ts +67 -67
- package/dist/sdk/history-mcp.d.ts +7 -7
- package/dist/sdk/history-provenance.d.ts +40 -40
- package/dist/sdk/history-read.d.ts +24 -24
- package/dist/sdk/history-redact.d.ts +68 -68
- package/dist/sdk/history-repair.d.ts +92 -92
- package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
- package/dist/sdk/improvement-ledger.d.ts +62 -62
- package/dist/sdk/index.d.ts +70 -69
- package/dist/sdk/index.js +1 -1
- package/dist/sdk/init-agent-guidance.d.ts +68 -68
- package/dist/sdk/init.d.ts +117 -117
- package/dist/sdk/invocation-author.d.ts +1 -1
- package/dist/sdk/item-children.d.ts +15 -15
- package/dist/sdk/item-metadata-index.d.ts +2 -2
- package/dist/sdk/item-schedule.d.ts +9 -9
- package/dist/sdk/item-transaction.d.ts +139 -76
- package/dist/sdk/item-transaction.js +1 -1
- package/dist/sdk/learnings.d.ts +23 -23
- package/dist/sdk/lifecycle/append.d.ts +8 -8
- package/dist/sdk/lifecycle/claim.d.ts +53 -39
- package/dist/sdk/lifecycle/claim.js +1 -1
- package/dist/sdk/lifecycle/close-many.d.ts +71 -71
- package/dist/sdk/lifecycle/close.d.ts +18 -24
- package/dist/sdk/lifecycle/close.js +1 -1
- package/dist/sdk/lifecycle/copy.d.ts +10 -10
- package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
- package/dist/sdk/lifecycle/core-item-fields.d.ts +6 -0
- package/dist/sdk/lifecycle/core-item-fields.js +2 -0
- package/dist/sdk/lifecycle/create.d.ts +88 -88
- package/dist/sdk/lifecycle/delete.d.ts +15 -15
- package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
- package/dist/sdk/lifecycle/focus.d.ts +6 -6
- package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
- package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
- package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
- package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
- package/dist/sdk/lifecycle/mcp-actions.js +1 -1
- package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
- package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
- package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
- package/dist/sdk/lifecycle/mutation-option-validation.d.ts +2 -0
- package/dist/sdk/lifecycle/mutation-option-validation.js +2 -0
- package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
- package/dist/sdk/lifecycle/plan.d.ts +127 -127
- package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
- package/dist/sdk/lifecycle/release-handoff.d.ts +12 -0
- package/dist/sdk/lifecycle/release-handoff.js +2 -0
- package/dist/sdk/lifecycle/reopen.d.ts +15 -15
- package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
- package/dist/sdk/lifecycle/restore.d.ts +34 -34
- package/dist/sdk/lifecycle/restore.js +1 -1
- package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
- package/dist/sdk/lifecycle/structured-mutation-plan.d.ts +33 -0
- package/dist/sdk/lifecycle/structured-mutation-plan.js +2 -0
- package/dist/sdk/lifecycle/task-composition.d.ts +9 -9
- package/dist/sdk/lifecycle/task-composition.js +1 -1
- package/dist/sdk/lifecycle/update-many.d.ts +61 -61
- package/dist/sdk/lifecycle/update.d.ts +113 -121
- package/dist/sdk/lifecycle/update.js +1 -1
- package/dist/sdk/lifecycle/workflow-transition.d.ts +13 -0
- package/dist/sdk/lifecycle/workflow-transition.js +2 -0
- package/dist/sdk/lifecycle-completion.d.ts +14 -14
- package/dist/sdk/lifecycle-policy.d.ts +42 -32
- package/dist/sdk/lifecycle-policy.js +1 -1
- package/dist/sdk/linked-artifacts.d.ts +58 -58
- package/dist/sdk/mcp/apps.d.ts +28 -28
- package/dist/sdk/mcp/authorization.d.ts +66 -66
- package/dist/sdk/mcp/discovery.d.ts +67 -67
- package/dist/sdk/mcp/interactions.d.ts +49 -49
- package/dist/sdk/mcp/protocol.d.ts +63 -63
- package/dist/sdk/mcp/skills.d.ts +62 -62
- package/dist/sdk/mcp/subscriptions.d.ts +26 -26
- package/dist/sdk/mcp/tasks.d.ts +51 -51
- package/dist/sdk/mcp/transport.d.ts +17 -17
- package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
- package/dist/sdk/merge/driver.d.ts +38 -38
- package/dist/sdk/merge/index.d.ts +5 -5
- package/dist/sdk/merge/install.d.ts +48 -48
- package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
- package/dist/sdk/merge/receipt-operation.d.ts +6 -6
- package/dist/sdk/merge/receipt-schema.d.ts +11 -11
- package/dist/sdk/merge/receipts.d.ts +111 -111
- package/dist/sdk/merge/reconcile.d.ts +20 -20
- package/dist/sdk/merge/three-way.d.ts +50 -50
- package/dist/sdk/merge/three-way.js +2 -2
- package/dist/sdk/merge/worktree-config.d.ts +3 -3
- package/dist/sdk/mutation-events.d.ts +62 -62
- package/dist/sdk/mutation-guard.d.ts +134 -134
- package/dist/sdk/notes.d.ts +28 -28
- package/dist/sdk/output/table-rows.d.ts +6 -6
- package/dist/sdk/output-contracts.d.ts +26 -26
- package/dist/sdk/output-projection.d.ts +108 -108
- package/dist/sdk/output-token-accounting.d.ts +18 -18
- package/dist/sdk/output.d.ts +18 -18
- package/dist/sdk/ownership-source.d.ts +1 -1
- package/dist/sdk/package-import-adapters.d.ts +51 -51
- package/dist/sdk/package-migrations.d.ts +3 -3
- package/dist/sdk/package-runtime-options.d.ts +3 -3
- package/dist/sdk/pagination.d.ts +28 -28
- package/dist/sdk/pagination.js +1 -1
- package/dist/sdk/profile.d.ts +72 -72
- package/dist/sdk/provenance.d.ts +37 -37
- package/dist/sdk/public-surface.json +1 -1
- package/dist/sdk/query/activity.d.ts +84 -84
- package/dist/sdk/query/aggregate.d.ts +109 -109
- package/dist/sdk/query/calendar.d.ts +95 -95
- package/dist/sdk/query/complete-list.d.ts +35 -35
- package/dist/sdk/query/context.d.ts +300 -300
- package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
- package/dist/sdk/query/get.d.ts +54 -54
- package/dist/sdk/query/history.d.ts +38 -38
- package/dist/sdk/query/item-filter-options.d.ts +41 -41
- package/dist/sdk/query/light-metadata.d.ts +1 -1
- package/dist/sdk/query/list-filter-shared.d.ts +4 -4
- package/dist/sdk/query/list.d.ts +167 -167
- package/dist/sdk/query/list.js +1 -1
- package/dist/sdk/query/multi-value-filters.d.ts +6 -6
- package/dist/sdk/query/next-ready-budget.d.ts +8 -8
- package/dist/sdk/query/next.d.ts +94 -94
- package/dist/sdk/query/parsers.d.ts +3 -3
- package/dist/sdk/query/projection-contracts.d.ts +18 -18
- package/dist/sdk/query/search/corpus.d.ts +15 -15
- package/dist/sdk/query/search/filters.d.ts +15 -15
- package/dist/sdk/query/search/input.d.ts +8 -8
- package/dist/sdk/query/search/lexical.d.ts +10 -10
- package/dist/sdk/query/search/response.d.ts +22 -22
- package/dist/sdk/query/search/semantic.d.ts +133 -133
- package/dist/sdk/query/search/types.d.ts +65 -65
- package/dist/sdk/query/search-contracts.d.ts +53 -53
- package/dist/sdk/query/search-pagination.d.ts +21 -21
- package/dist/sdk/query/search-rendering.d.ts +30 -30
- package/dist/sdk/query/search.d.ts +60 -60
- package/dist/sdk/query/workspace-contracts.d.ts +2 -2
- package/dist/sdk/query.d.ts +6 -6
- package/dist/sdk/read-output/continuation.d.ts +11 -11
- package/dist/sdk/read-output/extension.d.ts +3 -3
- package/dist/sdk/read-output/options.d.ts +7 -7
- package/dist/sdk/read-output/provenance.d.ts +6 -6
- package/dist/sdk/read-output-budget.d.ts +11 -11
- package/dist/sdk/read-output-budget.js +1 -1
- package/dist/sdk/read-output-contracts.d.ts +112 -112
- package/dist/sdk/read-output-contracts.js +1 -1
- package/dist/sdk/read-output-rows.d.ts +15 -15
- package/dist/sdk/read-output-session.d.ts +29 -29
- package/dist/sdk/relationship-analytics.d.ts +46 -46
- package/dist/sdk/relationship-context.d.ts +48 -48
- package/dist/sdk/relationship-history.d.ts +59 -59
- package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
- package/dist/sdk/relationship-migration.d.ts +14 -14
- package/dist/sdk/relationships.d.ts +46 -46
- package/dist/sdk/reproducibility/process.d.ts +9 -9
- package/dist/sdk/runtime/actions.d.ts +1 -1
- package/dist/sdk/runtime/context.d.ts +15 -15
- package/dist/sdk/runtime/schema-preview.d.ts +1 -1
- package/dist/sdk/runtime/schema.d.ts +1 -1
- package/dist/sdk/runtime-action-aliases.d.ts +3 -3
- package/dist/sdk/runtime-extended-actions.d.ts +9 -9
- package/dist/sdk/runtime-input.d.ts +29 -29
- package/dist/sdk/runtime-input.js +1 -1
- package/dist/sdk/runtime-primitives.d.ts +53 -53
- package/dist/sdk/runtime-primitives.js +1 -1
- package/dist/sdk/runtime-public-contracts.d.ts +46 -46
- package/dist/sdk/runtime-stats-options.d.ts +1 -1
- package/dist/sdk/runtime.d.ts +374 -374
- package/dist/sdk/runtime.js +1 -1
- package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
- package/dist/sdk/schema-migration.d.ts +79 -79
- package/dist/sdk/schema.d.ts +224 -224
- package/dist/sdk/search-refresh-worker.d.ts +1 -1
- package/dist/sdk/similarity-scoring.d.ts +10 -10
- package/dist/sdk/similarity.d.ts +73 -73
- package/dist/sdk/start-task-status.d.ts +1 -1
- package/dist/sdk/stats.d.ts +72 -72
- package/dist/sdk/structured-mutations.d.ts +64 -13
- package/dist/sdk/structured-mutations.js +1 -1
- package/dist/sdk/telemetry-flush.d.ts +1 -1
- package/dist/sdk/telemetry.d.ts +32 -32
- package/dist/sdk/templates.d.ts +35 -35
- package/dist/sdk/test/batch.d.ts +50 -50
- package/dist/sdk/test/command-args.d.ts +2 -2
- package/dist/sdk/test/entry.d.ts +4 -4
- package/dist/sdk/test/execution-receipts.d.ts +5 -5
- package/dist/sdk/test/execution.d.ts +247 -247
- package/dist/sdk/test/json-path.d.ts +4 -4
- package/dist/sdk/test/linked-command-detection.d.ts +36 -36
- package/dist/sdk/test/measurements.d.ts +10 -10
- package/dist/sdk/test/parsers.d.ts +18 -18
- package/dist/sdk/test/prerequisites.d.ts +3 -3
- package/dist/sdk/test/runs.d.ts +43 -43
- package/dist/sdk/test/trust.d.ts +15 -15
- package/dist/sdk/test/update.d.ts +23 -23
- package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
- package/dist/sdk/testing.d.ts +248 -248
- package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
- package/dist/sdk/traceability/source-traceability.d.ts +50 -50
- package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
- package/dist/sdk/workspace-contracts.d.ts +20 -20
- package/dist/sdk/workspace-memory.d.ts +42 -42
- package/dist/sdk/workspace-recipe.d.ts +9 -9
- package/dist/sdk/workspace-snapshot.d.ts +60 -60
- package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
- package/dist/sdk/workspace-transaction.d.ts +26 -26
- package/dist/sdk/workspace-transaction.js +2 -2
- package/dist/sdk/workspace.d.ts +9 -9
- package/dist/types.d.ts +540 -540
- package/docs/AGENT_GUIDE.md +33 -4
- package/docs/CLOSE_EVIDENCE_RECOVERY.md +16 -7
- package/docs/COMMANDS.md +96 -12
- package/docs/ECOSYSTEM_PLANNING_REVIEW.md +5 -1
- package/docs/EXTENSIONS.md +1 -1
- package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
- package/docs/LINKED_TEST_EDITS.md +15 -0
- package/docs/RELEASING.md +2 -0
- package/docs/SDK.md +114 -2
- package/docs/TESTING.md +36 -1
- package/docs/generated/FLAG_LEXICON_BUDGETS.md +1 -1
- package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +17 -3
- package/marketplace.json +1 -1
- package/package.json +4 -1
- package/packages/pm-beads/package.json +1 -1
- package/packages/pm-calendar/package.json +1 -1
- package/packages/pm-command-kit/package.json +1 -1
- package/packages/pm-digital-twin/package.json +1 -1
- package/packages/pm-governance-audit/package.json +1 -1
- package/packages/pm-guide-shell/package.json +1 -1
- package/packages/pm-kanban/package.json +1 -1
- package/packages/pm-lifecycle-hooks/package.json +1 -1
- package/packages/pm-linked-test-adapters/package.json +1 -1
- package/packages/pm-search-advanced/package.json +1 -1
- package/packages/pm-templates/package.json +1 -1
- package/packages/pm-todos/package.json +1 -1
- package/packages/pm-vcs/package.json +1 -1
- package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
- package/plugins/pm-claude/package.json +1 -1
- package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
- package/plugins/pm-codex/package.json +1 -1
- package/plugins/pm-codex/plugin.json +1 -1
- package/runtime-dependencies.json +1 -1
- package/scripts/finalize-build.mjs +9 -3
- package/dist/cli-bundle/chunks/chunk-66BZVFIK.js +0 -6
- package/dist/cli-bundle/chunks/chunk-IDEHMKYZ.js +0 -235
- package/dist/cli-bundle/chunks/chunk-LOSRTNNP.js +0 -2
- package/dist/cli-bundle/chunks/chunk-PP3BVMFL.js +0 -30
- package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
- package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
- package/dist/cli-bundle/chunks/register-mutation-TNRHNK4N.js +0 -20
- package/dist/cli-bundle/focused-chunks/chunk-23ACMPGB.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
- package/dist/cli-bundle/focused-chunks/chunk-LKWDWER4.js +0 -20
- package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
- package/docs/ecosystem-review-2026-09-28.json +0 -1
package/dist/cli.d.ts
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
declare function enableNodeCompileCache():
|
|
3
|
-
declare function findPackageJson(startPath:
|
|
4
|
-
declare function printFastVersionIfRequested():
|
|
5
|
-
declare function readPackageVersionForPath(startPath:
|
|
2
|
+
declare function enableNodeCompileCache():void;
|
|
3
|
+
declare function findPackageJson(startPath:string):string | undefined;
|
|
4
|
+
declare function printFastVersionIfRequested():boolean;
|
|
5
|
+
declare function readPackageVersionForPath(startPath:string):string | undefined;
|
|
6
6
|
/** Public contract for test only, shared by SDK and presentation-layer consumers. */
|
|
7
|
-
export declare const _testOnly:
|
|
8
|
-
enableNodeCompileCache:
|
|
9
|
-
findPackageJson:
|
|
10
|
-
printFastVersionIfRequested:
|
|
11
|
-
readPackageVersionForPath:
|
|
7
|
+
export declare const _testOnly:{
|
|
8
|
+
enableNodeCompileCache:typeof enableNodeCompileCache;
|
|
9
|
+
findPackageJson:typeof findPackageJson;
|
|
10
|
+
printFastVersionIfRequested:typeof printFastVersionIfRequested;
|
|
11
|
+
readPackageVersionForPath:typeof readPackageVersionForPath;
|
|
12
12
|
};
|
|
13
13
|
export {};
|
|
@@ -16,46 +16,46 @@
|
|
|
16
16
|
/** Documents the checkpoint gc scan entry payload exchanged by command, SDK, and package integrations. */
|
|
17
17
|
export interface CheckpointGcEntry {
|
|
18
18
|
/** Relative path like "checkpoints/update-many/update-many-20260619-abc123.json". */
|
|
19
|
-
file:
|
|
19
|
+
file:string;
|
|
20
20
|
/** Parsed `created_at`, or null when missing/unparseable. */
|
|
21
|
-
created_at:
|
|
21
|
+
created_at:string | null;
|
|
22
22
|
/** floor((now - created_at)/1000), null when unparseable. */
|
|
23
|
-
age_seconds:
|
|
23
|
+
age_seconds:number | null;
|
|
24
24
|
/** True only when classified as expired (older than the retention window). */
|
|
25
|
-
stale:
|
|
25
|
+
stale:boolean;
|
|
26
26
|
/** Value that configures or reports reason for this contract. */
|
|
27
|
-
reason:
|
|
27
|
+
reason:"expired" | "active" | "unparseable";
|
|
28
28
|
}
|
|
29
29
|
/** Documents the checkpoint gc hooks payload exchanged by command, SDK, and package integrations. */
|
|
30
30
|
export interface CheckpointGcHooks {
|
|
31
31
|
/** Value that configures or reports on read for this contract. */
|
|
32
|
-
onRead?:
|
|
32
|
+
onRead?:(checkpointPath:string) => Promise<string[]> | string[];
|
|
33
33
|
/** Value that configures or reports on write for this contract. */
|
|
34
|
-
onWrite?:
|
|
34
|
+
onWrite?:(checkpointPath:string) => Promise<string[]> | string[];
|
|
35
35
|
}
|
|
36
36
|
/** Documents the checkpoint gc options payload exchanged by command, SDK, and package integrations. */
|
|
37
37
|
export interface CheckpointGcOptions {
|
|
38
38
|
/** Value that configures or reports dry run for this contract. */
|
|
39
|
-
dryRun:
|
|
39
|
+
dryRun:boolean;
|
|
40
40
|
/** Prune checkpoints older than this many days. Negative values are clamped to zero (prune everything aged); a non-finite value (NaN/Infinity) disables pruning entirely so bad input never deletes recoverable checkpoints. */
|
|
41
|
-
retentionDays:
|
|
41
|
+
retentionDays:number;
|
|
42
42
|
/** Epoch ms; defaults to Date.now() — injectable for deterministic tests. */
|
|
43
|
-
now?:
|
|
43
|
+
now?:number;
|
|
44
44
|
/** Value that configures or reports hooks for this contract. */
|
|
45
|
-
hooks?:
|
|
45
|
+
hooks?:CheckpointGcHooks;
|
|
46
46
|
}
|
|
47
47
|
/** Documents the checkpoint gc result payload exchanged by command, SDK, and package integrations. */
|
|
48
48
|
export interface CheckpointGcResult {
|
|
49
49
|
/** Number of *.json checkpoint files examined. */
|
|
50
|
-
scanned:
|
|
50
|
+
scanned:number;
|
|
51
51
|
/** Relative paths removed (or would-remove under dryRun), sorted by file name asc. */
|
|
52
|
-
removed:
|
|
52
|
+
removed:string[];
|
|
53
53
|
/** Relative paths retained (active OR unparseable — never delete what we can't reason about). */
|
|
54
|
-
retained:
|
|
54
|
+
retained:string[];
|
|
55
55
|
/** Value that configures or reports warnings for this contract. */
|
|
56
|
-
warnings:
|
|
56
|
+
warnings:string[];
|
|
57
57
|
/** One per scanned checkpoint file, sorted by file name asc. */
|
|
58
|
-
entries:
|
|
58
|
+
entries:CheckpointGcEntry[];
|
|
59
59
|
}
|
|
60
60
|
/** Implements run checkpoint gc for the public runtime surface of this module. */
|
|
61
|
-
export declare function runCheckpointGc(pmRoot:
|
|
61
|
+
export declare function runCheckpointGc(pmRoot:string,options:CheckpointGcOptions):Promise<CheckpointGcResult>;
|
|
@@ -1,63 +1,63 @@
|
|
|
1
1
|
/** Documents the mutation checkpoint item payload exchanged by command, SDK, and package integrations. */
|
|
2
2
|
export interface MutationCheckpointItem {
|
|
3
3
|
/** Stable identifier used to reference this record across commands and storage. */
|
|
4
|
-
id:
|
|
4
|
+
id:string;
|
|
5
5
|
/** ISO 8601 timestamp recording when target updated occurred. */
|
|
6
|
-
target_updated_at:
|
|
6
|
+
target_updated_at:string;
|
|
7
7
|
}
|
|
8
8
|
/** Documents the loaded mutation checkpoint payload exchanged by command, SDK, and package integrations. */
|
|
9
9
|
export interface LoadedMutationCheckpoint {
|
|
10
10
|
/** The full on-disk record so callers can read their command-specific fields. */
|
|
11
|
-
record:
|
|
11
|
+
record:Record<string,unknown>;
|
|
12
12
|
/** Validated item list (id + target_updated_at). */
|
|
13
|
-
items:
|
|
13
|
+
items:MutationCheckpointItem[];
|
|
14
14
|
/** Absolute path the checkpoint was read from. */
|
|
15
|
-
path:
|
|
15
|
+
path:string;
|
|
16
16
|
/** Stable identifier used to reference this record across commands and storage. */
|
|
17
|
-
id:
|
|
17
|
+
id:string;
|
|
18
18
|
/** ISO 8601 timestamp recording when created occurred. */
|
|
19
|
-
created_at:
|
|
19
|
+
created_at:string;
|
|
20
20
|
/** Value that configures or reports author for this contract. */
|
|
21
|
-
author:
|
|
21
|
+
author:string;
|
|
22
22
|
}
|
|
23
23
|
/** Documents the checkpoint rollback row payload exchanged by command, SDK, and package integrations. */
|
|
24
24
|
export interface CheckpointRollbackRow {
|
|
25
25
|
/** Stable identifier used to reference this record across commands and storage. */
|
|
26
|
-
id:
|
|
26
|
+
id:string;
|
|
27
27
|
/** Lifecycle state reported for status. */
|
|
28
|
-
status:
|
|
28
|
+
status:"restored" | "failed";
|
|
29
29
|
/** Value that configures or reports changed fields for this contract. */
|
|
30
|
-
changed_fields?:
|
|
30
|
+
changed_fields?:string[];
|
|
31
31
|
/** Value that configures or reports warnings for this contract. */
|
|
32
|
-
warnings?:
|
|
32
|
+
warnings?:string[];
|
|
33
33
|
/** Value that configures or reports error for this contract. */
|
|
34
|
-
error?:
|
|
34
|
+
error?:string;
|
|
35
35
|
}
|
|
36
36
|
/** Documents the checkpoint rollback result payload exchanged by command, SDK, and package integrations. */
|
|
37
37
|
export interface CheckpointRollbackResult {
|
|
38
38
|
/** Value that configures or reports rows for this contract. */
|
|
39
|
-
rows:
|
|
39
|
+
rows:CheckpointRollbackRow[];
|
|
40
40
|
/** Value that configures or reports restored ids for this contract. */
|
|
41
|
-
restored_ids:
|
|
41
|
+
restored_ids:string[];
|
|
42
42
|
/** Number of failed entries represented by this result. */
|
|
43
|
-
failed_count:
|
|
43
|
+
failed_count:number;
|
|
44
44
|
}
|
|
45
45
|
/** Restore a single item to its captured pre-mutation timestamp. */
|
|
46
|
-
export type CheckpointRestoreFn = (id:
|
|
47
|
-
changed_fields?:
|
|
48
|
-
warnings?:
|
|
46
|
+
export type CheckpointRestoreFn = (id:string,targetUpdatedAt:string) => Promise<{
|
|
47
|
+
changed_fields?:string[];
|
|
48
|
+
warnings?:string[];
|
|
49
49
|
}>;
|
|
50
50
|
/** Implements normalize checkpoint id for the public runtime surface of this module. */
|
|
51
|
-
export declare function normalizeCheckpointId(raw:
|
|
51
|
+
export declare function normalizeCheckpointId(raw:string):string;
|
|
52
52
|
/** Implements create checkpoint id for the public runtime surface of this module. */
|
|
53
|
-
export declare function createCheckpointId(prefix:
|
|
53
|
+
export declare function createCheckpointId(prefix:string,nowValue:string):string;
|
|
54
54
|
/** Implements checkpoint directory path for the public runtime surface of this module. */
|
|
55
|
-
export declare function checkpointDirectoryPath(pmRoot:
|
|
55
|
+
export declare function checkpointDirectoryPath(pmRoot:string,subdir:string):string;
|
|
56
56
|
/** Implements checkpoint file path for the public runtime surface of this module. */
|
|
57
|
-
export declare function checkpointFilePath(pmRoot:
|
|
57
|
+
export declare function checkpointFilePath(pmRoot:string,subdir:string,checkpointId:string):string;
|
|
58
58
|
/** Publish immutable checkpoint bytes once, including through path aliases; identical retries succeed and conflicting IDs preserve the original evidence. */
|
|
59
|
-
export declare function writeMutationCheckpoint(pmRoot:
|
|
59
|
+
export declare function writeMutationCheckpoint(pmRoot:string,subdir:string,checkpointId:string,payload:unknown):Promise<string>;
|
|
60
60
|
/** Implements load mutation checkpoint for the public runtime surface of this module. */
|
|
61
|
-
export declare function loadMutationCheckpoint(pmRoot:
|
|
61
|
+
export declare function loadMutationCheckpoint(pmRoot:string,subdir:string,rawCheckpointId:string,schemaVersion:number):Promise<LoadedMutationCheckpoint>;
|
|
62
62
|
/** Restore every checkpointed item to its captured pre-mutation timestamp, collecting per-item rows. A single item's failure is recorded and does not abort the remaining restores. */
|
|
63
|
-
export declare function restoreCheckpointItems(items:
|
|
63
|
+
export declare function restoreCheckpointItems(items:MutationCheckpointItem[],restore:CheckpointRestoreFn):Promise<CheckpointRollbackResult>;
|
|
@@ -27,45 +27,45 @@ export type NestedSettingKind = "string" | "boolean" | "integer" | "number" | "r
|
|
|
27
27
|
/** Documents the nested setting descriptor payload exchanged by command, SDK, and package integrations. */
|
|
28
28
|
export interface NestedSettingDescriptor {
|
|
29
29
|
/** CLI key (snake_case). Kebab-case form is accepted by normalizing `-` → `_`. */
|
|
30
|
-
key:
|
|
30
|
+
key:string;
|
|
31
31
|
/** Dotted JSON path in PmSettings. */
|
|
32
|
-
path:
|
|
32
|
+
path:string;
|
|
33
33
|
/** Value shape. */
|
|
34
|
-
kind:
|
|
34
|
+
kind:NestedSettingKind;
|
|
35
35
|
/** Short human-facing summary for `pm config list`. */
|
|
36
|
-
summary:
|
|
36
|
+
summary:string;
|
|
37
37
|
/** Optional accepted values for string settings. */
|
|
38
|
-
choices?:
|
|
38
|
+
choices?:readonly string[];
|
|
39
39
|
/** Require a non-empty trimmed string value for string settings. */
|
|
40
|
-
non_empty?:
|
|
40
|
+
non_empty?:boolean;
|
|
41
41
|
/** Optional minimum value for `integer` / `number` kinds. When set, `parseNestedSettingValue` rejects values strictly below `min`. Useful for settings where 0 would be silently ignored by the runtime (batch sizes, timeouts, max-results limits). */
|
|
42
|
-
min?:
|
|
42
|
+
min?:number;
|
|
43
43
|
/** Optional maximum value for `integer` / `number` kinds. When set, `parseNestedSettingValue` rejects values strictly above `max` (bounded knobs like `ids.token_length`). */
|
|
44
|
-
max?:
|
|
44
|
+
max?:number;
|
|
45
45
|
}
|
|
46
46
|
/** Search/provider/vector-store leaves. Order is the display order in `pm config list` and in error hints. */
|
|
47
|
-
export declare const NESTED_SETTING_DESCRIPTORS:
|
|
47
|
+
export declare const NESTED_SETTING_DESCRIPTORS:readonly NestedSettingDescriptor[];
|
|
48
48
|
/** Map a raw user-supplied key (kebab case, snake case, or the dotted settings path surfaced by `pm config list`) onto a known nested-leaf descriptor. Returns `undefined` when the key is not a nested leaf, letting callers fall back to the regular ConfigKey path. */
|
|
49
|
-
export declare function resolveNestedSettingDescriptor(raw:
|
|
49
|
+
export declare function resolveNestedSettingDescriptor(raw:string | undefined):NestedSettingDescriptor | undefined;
|
|
50
50
|
/** Recoverable parsed value with the descriptor it satisfied. */
|
|
51
51
|
export interface NestedSettingParsedValue {
|
|
52
52
|
/** Value that configures or reports descriptor for this contract. */
|
|
53
|
-
descriptor:
|
|
53
|
+
descriptor:NestedSettingDescriptor;
|
|
54
54
|
/** Value that configures or reports value for this contract. */
|
|
55
|
-
value:
|
|
55
|
+
value:string | number | boolean;
|
|
56
56
|
}
|
|
57
57
|
/** Throwable validation error returned as a structured result. */
|
|
58
58
|
export interface NestedSettingParseError {
|
|
59
59
|
/** Human-readable explanation suitable for logs and agent-facing output. */
|
|
60
|
-
message:
|
|
60
|
+
message:string;
|
|
61
61
|
}
|
|
62
62
|
/** Restricts nested setting parse result values accepted by command, SDK, and storage contracts. */
|
|
63
63
|
export type NestedSettingParseResult = {
|
|
64
|
-
ok:
|
|
65
|
-
parsed:
|
|
64
|
+
ok:true;
|
|
65
|
+
parsed:NestedSettingParsedValue;
|
|
66
66
|
} | {
|
|
67
|
-
ok:
|
|
68
|
-
error:
|
|
67
|
+
ok:false;
|
|
68
|
+
error:NestedSettingParseError;
|
|
69
69
|
};
|
|
70
70
|
/**
|
|
71
71
|
* Validate and coerce a raw string value for a nested-leaf setting. The
|
|
@@ -73,8 +73,8 @@ error: NestedSettingParseError;
|
|
|
73
73
|
*
|
|
74
74
|
* Empty strings are allowed for "string" leaves unless `non_empty` is set.
|
|
75
75
|
*/
|
|
76
|
-
export declare function parseNestedSettingValue(descriptor:
|
|
76
|
+
export declare function parseNestedSettingValue(descriptor:NestedSettingDescriptor,rawValue:string):NestedSettingParseResult;
|
|
77
77
|
/** Walk a dotted path on an arbitrary record (best-effort, returns null on miss). */
|
|
78
|
-
export declare function readNestedSettingValue(settings:
|
|
78
|
+
export declare function readNestedSettingValue(settings:unknown,descriptor:NestedSettingDescriptor):string | number | boolean | null;
|
|
79
79
|
/** Set a leaf value on a settings object by walking the descriptor's dotted path. Missing intermediate objects are created. Returns `true` when the value actually changed. */
|
|
80
|
-
export declare function writeNestedSettingValue(settings:
|
|
80
|
+
export declare function writeNestedSettingValue(settings:Record<string,unknown>,descriptor:NestedSettingDescriptor,value:string | number | boolean):boolean;
|
|
@@ -12,29 +12,29 @@
|
|
|
12
12
|
/** Successful routing of a positional value to a single-value typed flag. */
|
|
13
13
|
export interface ConfigPositionalScalarRouted {
|
|
14
14
|
/** Value that configures or reports routable for this contract. */
|
|
15
|
-
routable:
|
|
15
|
+
routable:true;
|
|
16
16
|
/** Value that configures or reports flag for this contract. */
|
|
17
|
-
flag:
|
|
17
|
+
flag:"format" | "policy";
|
|
18
18
|
/** Normalized scalar value for single-value flags. */
|
|
19
|
-
value:
|
|
19
|
+
value:string;
|
|
20
20
|
}
|
|
21
21
|
/** Successful routing of a positional value to the criteria-list flag. */
|
|
22
22
|
export interface ConfigPositionalListRouted {
|
|
23
23
|
/** Value that configures or reports routable for this contract. */
|
|
24
|
-
routable:
|
|
24
|
+
routable:true;
|
|
25
25
|
/** Value that configures or reports flag for this contract. */
|
|
26
|
-
flag:
|
|
26
|
+
flag:"criterion";
|
|
27
27
|
/** Criteria-list flag (`--criterion`) value, supplied as a values array. */
|
|
28
|
-
values:
|
|
28
|
+
values:string[];
|
|
29
29
|
}
|
|
30
30
|
/** Restricts config positional routed values accepted by command, SDK, and storage contracts. */
|
|
31
31
|
export type ConfigPositionalRouted = ConfigPositionalScalarRouted | ConfigPositionalListRouted;
|
|
32
32
|
/** A key whose value cannot be carried by a single positional (e.g. `context`). */
|
|
33
33
|
export interface ConfigPositionalNotRoutable {
|
|
34
34
|
/** Value that configures or reports routable for this contract. */
|
|
35
|
-
routable:
|
|
35
|
+
routable:false;
|
|
36
36
|
/** Human/agent-facing reason + the flags to use instead. */
|
|
37
|
-
reason:
|
|
37
|
+
reason:string;
|
|
38
38
|
}
|
|
39
39
|
/** Restricts config positional result values accepted by command, SDK, and storage contracts. */
|
|
40
40
|
export type ConfigPositionalResult = ConfigPositionalRouted | ConfigPositionalNotRoutable;
|
|
@@ -48,4 +48,4 @@ export type ConfigKey = "definition_of_done" | "item_format" | "history_missing_
|
|
|
48
48
|
* flags (e.g. `context`). Unknown keys also return `routable: false` so the caller
|
|
49
49
|
* can fall back to the existing invalid-key path.
|
|
50
50
|
*/
|
|
51
|
-
export declare function resolveConfigPositionalValue(canonicalKeyOrAlias:
|
|
51
|
+
export declare function resolveConfigPositionalValue(canonicalKeyOrAlias:string,value:string):ConfigPositionalResult;
|
|
@@ -20,14 +20,14 @@
|
|
|
20
20
|
/** Maps a stable diagnostic warning code to the command and summary that resolve it. */
|
|
21
21
|
export interface RemediationEntry {
|
|
22
22
|
/** Stable warning-code prefix this entry resolves. A warning matches when it equals this code or begins with `<code>:`. Registry codes are mutually exclusive under that colon-boundary rule (no code is a `:`-delimited prefix of another — e.g. `settings:id_prefix_empty` is distinct from a bare `settings`, which is intentionally not registered), so `resolveRemediation` uses first-match with no ordering dependency. */
|
|
23
|
-
readonly code:
|
|
23
|
+
readonly code:string;
|
|
24
24
|
/** Executable `pm` command (or imperative) that resolves the finding. May contain an `<id>` placeholder. */
|
|
25
|
-
readonly command:
|
|
25
|
+
readonly command:string;
|
|
26
26
|
/** One-line description of what the command does / which manual step it covers. */
|
|
27
|
-
readonly summary:
|
|
27
|
+
readonly summary:string;
|
|
28
28
|
}
|
|
29
29
|
/** Registry of every non-extension `pm health` / `pm validate` warning code and its remediation. Extension findings keep their richer, contextual `details.triage.remediation` produced by the extension health triage and are intentionally excluded here (see pm-0hnu: "all non-extension checks"). */
|
|
30
|
-
export declare const REMEDIATION_REGISTRY:
|
|
30
|
+
export declare const REMEDIATION_REGISTRY:readonly RemediationEntry[];
|
|
31
31
|
/**
|
|
32
32
|
* Resolve the remediation entry for a warning token, or `undefined` when no
|
|
33
33
|
* entry is registered. A warning matches an entry when it equals the entry code
|
|
@@ -45,8 +45,8 @@ export declare const REMEDIATION_REGISTRY: readonly RemediationEntry[];
|
|
|
45
45
|
* Accepts unknown input defensively (this is an exported helper SDK consumers
|
|
46
46
|
* may call from untyped JS): a non-string `warning` resolves to `undefined`.
|
|
47
47
|
*/
|
|
48
|
-
export declare function resolveRemediation(warning:
|
|
48
|
+
export declare function resolveRemediation(warning:string):RemediationEntry | undefined;
|
|
49
49
|
/** Build a compact `remediation_map` (code -> command) for a set of warning tokens. First match wins per code; unknown codes are skipped. Used by `pm health --json` per-check details and as the source of deduped executable commands for `pm validate --fix-hints`. */
|
|
50
|
-
export declare function buildRemediationMap(warnings:
|
|
50
|
+
export declare function buildRemediationMap(warnings:Iterable<string>):Record<string,string>;
|
|
51
51
|
/** Build a deduped, ordered list of executable remediation commands for a set of warning tokens (one command per distinct matched code). Used by `pm validate --fix-hints` for checks that do not already emit per-row remediation commands. */
|
|
52
|
-
export declare function buildRemediationCommands(warnings:
|
|
52
|
+
export declare function buildRemediationCommands(warnings:Iterable<string>):string[];
|
|
@@ -33,16 +33,16 @@ export interface ExtensionSurfaceMarkdownOptions {
|
|
|
33
33
|
* {@link ExtensionSurfaceMarkdownOptions.headingLevel}; per-surface sections
|
|
34
34
|
* render one level deeper.
|
|
35
35
|
*/
|
|
36
|
-
title?:
|
|
36
|
+
title?:string;
|
|
37
37
|
/**
|
|
38
38
|
* ATX heading level for the title, an integer in `[1, 6]` (default `2`, i.e.
|
|
39
39
|
* `##`, so the document embeds cleanly under a `# Package` README heading).
|
|
40
40
|
* Section headings render at `headingLevel + 1`, clamped to `6`. Values
|
|
41
41
|
* outside `[1, 6]` throw a {@link RangeError}.
|
|
42
42
|
*/
|
|
43
|
-
headingLevel?:
|
|
43
|
+
headingLevel?:number;
|
|
44
44
|
/** When `true`, render every surface section even when it has no entries (emitting `_None._` under the heading) and always emit the capabilities line. Defaults to `false`, which omits empty sections so the reference lists only what the package actually contributes. */
|
|
45
|
-
includeEmpty?:
|
|
45
|
+
includeEmpty?:boolean;
|
|
46
46
|
}
|
|
47
47
|
/**
|
|
48
48
|
* Render an {@link ExtensionActivationSummary} as a deterministic Markdown
|
|
@@ -63,4 +63,4 @@ includeEmpty?: boolean;
|
|
|
63
63
|
*
|
|
64
64
|
* @throws {RangeError} when `options.headingLevel` is not an integer in `[1, 6]`.
|
|
65
65
|
*/
|
|
66
|
-
export declare function renderExtensionSurfaceMarkdown(summary:
|
|
66
|
+
export declare function renderExtensionSurfaceMarkdown(summary:ExtensionActivationSummary,options?:ExtensionSurfaceMarkdownOptions):string;
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
* nothing more" check, the positive counterpart to
|
|
25
25
|
* {@link ./capability-usage.js#reconcileExtensionCapabilityUsage}.
|
|
26
26
|
*/
|
|
27
|
-
import type { ExtensionActivationResult,
|
|
27
|
+
import type { ExtensionActivationResult,ExtensionCapability,ExtensionServiceName,OutputRendererFormat } from "./extension-types.js";
|
|
28
28
|
/**
|
|
29
29
|
* Flat, name-level enumeration of every surface an activation registered.
|
|
30
30
|
*
|
|
@@ -41,58 +41,58 @@ import type { ExtensionActivationResult, ExtensionCapability, ExtensionServiceNa
|
|
|
41
41
|
*/
|
|
42
42
|
export interface ExtensionActivationSummary {
|
|
43
43
|
/** Known capabilities the registered surfaces exercise (sorted, de-duplicated). */
|
|
44
|
-
capabilities:
|
|
44
|
+
capabilities:ExtensionCapability[];
|
|
45
45
|
/** Full command paths declared via `registerCommand`'s definition form. */
|
|
46
|
-
commands:
|
|
46
|
+
commands:string[];
|
|
47
47
|
/** Built-in command paths replaced by an `registerCommand(name, override)` handler. */
|
|
48
|
-
command_overrides:
|
|
48
|
+
command_overrides:string[];
|
|
49
49
|
/**
|
|
50
50
|
* Full command paths backed by an extension-provided handler. A superset of
|
|
51
51
|
* {@link ExtensionActivationSummary.commands} that also includes the
|
|
52
52
|
* `<name> import`/`<name> export` paths synthesized for importers/exporters.
|
|
53
53
|
*/
|
|
54
|
-
command_handlers:
|
|
54
|
+
command_handlers:string[];
|
|
55
55
|
/** Lifecycle hook kinds with at least one registered hook (canonical order). */
|
|
56
|
-
hooks:
|
|
56
|
+
hooks:string[];
|
|
57
57
|
/** Command paths that received extension-registered flags. */
|
|
58
|
-
flag_commands:
|
|
58
|
+
flag_commands:string[];
|
|
59
59
|
/** Custom item-type names registered via `registerItemTypes`. */
|
|
60
|
-
item_types:
|
|
60
|
+
item_types:string[];
|
|
61
61
|
/** Custom item-metadata field names registered via `registerItemFields`. */
|
|
62
|
-
item_fields:
|
|
62
|
+
item_fields:string[];
|
|
63
63
|
/** Custom relationship-kind names registered via `registerRelationshipKinds`. */
|
|
64
|
-
relationship_kinds?:
|
|
64
|
+
relationship_kinds?:string[];
|
|
65
65
|
/** Schema migration ids registered via `registerMigration` (id-less migrations are omitted — they carry no identifier). */
|
|
66
|
-
migrations:
|
|
66
|
+
migrations:string[];
|
|
67
67
|
/** Project profile names registered via `registerProfile`. */
|
|
68
|
-
profiles:
|
|
68
|
+
profiles:string[];
|
|
69
69
|
/** Importer names registered via `registerImporter`. */
|
|
70
|
-
importers:
|
|
70
|
+
importers:string[];
|
|
71
71
|
/** Exporter names registered via `registerExporter`. */
|
|
72
|
-
exporters:
|
|
72
|
+
exporters:string[];
|
|
73
73
|
/** Search-provider names registered via `registerSearchProvider`. */
|
|
74
|
-
search_providers:
|
|
74
|
+
search_providers:string[];
|
|
75
75
|
/** Vector-store adapter names registered via `registerVectorStoreAdapter`. */
|
|
76
|
-
vector_store_adapters:
|
|
76
|
+
vector_store_adapters:string[];
|
|
77
77
|
/** Assurance provider ids registered via `registerAssuranceMeasurementProvider`. */
|
|
78
|
-
assurance_providers?:
|
|
78
|
+
assurance_providers?:string[];
|
|
79
79
|
/** Command paths with a parser override registered via `registerParser`. */
|
|
80
|
-
parser_overrides:
|
|
80
|
+
parser_overrides:string[];
|
|
81
81
|
/** Built-in service names overridden via `registerService`. */
|
|
82
|
-
service_overrides:
|
|
82
|
+
service_overrides:ExtensionServiceName[];
|
|
83
83
|
/** Output formats with a renderer override registered via `registerRenderer`. */
|
|
84
|
-
renderer_overrides:
|
|
84
|
+
renderer_overrides:OutputRendererFormat[];
|
|
85
85
|
/** Host-enforced ownership declared by scoped renderers. Omitted when every renderer is global. */
|
|
86
|
-
renderer_ownership?:
|
|
87
|
-
format:
|
|
88
|
-
commands:
|
|
89
|
-
result_discriminator:
|
|
86
|
+
renderer_ownership?:Array<{
|
|
87
|
+
format:OutputRendererFormat;
|
|
88
|
+
commands:string[];
|
|
89
|
+
result_discriminator:boolean;
|
|
90
90
|
}>;
|
|
91
91
|
/** Count of registered preflight overrides. The surface carries no per-entry identifier, so this is a `number` rather than `string[]` — the only numeric field in the summary. */
|
|
92
|
-
preflight_overrides:
|
|
92
|
+
preflight_overrides:number;
|
|
93
93
|
/** Command ownership for each registered preflight override. */
|
|
94
|
-
preflight_ownership:
|
|
95
|
-
commands:
|
|
94
|
+
preflight_ownership:Array<{
|
|
95
|
+
commands:string[];
|
|
96
96
|
}>;
|
|
97
97
|
}
|
|
98
98
|
/**
|
|
@@ -105,9 +105,9 @@ export interface DescribeExtensionActivationOptions {
|
|
|
105
105
|
* {@link ./capability-usage.js#collectUsedExtensionCapabilities}. Omit to
|
|
106
106
|
* union across every extension in the activation result.
|
|
107
107
|
*/
|
|
108
|
-
extensionName?:
|
|
108
|
+
extensionName?:string;
|
|
109
109
|
/** Restrict the summary to a set of extension names. This supports package aliases that resolve to multiple extensions while keeping the historical single-name option intact. */
|
|
110
|
-
extensionNames?:
|
|
110
|
+
extensionNames?:readonly string[];
|
|
111
111
|
}
|
|
112
112
|
/**
|
|
113
113
|
* Summarize, by name, every registration surface an activation exercised.
|
|
@@ -120,4 +120,4 @@ extensionNames?: readonly string[];
|
|
|
120
120
|
* summary unions every extension in the activation. Failed activations register
|
|
121
121
|
* nothing, so they contribute only an empty summary.
|
|
122
122
|
*/
|
|
123
|
-
export declare function describeExtensionActivation(activation:
|
|
123
|
+
export declare function describeExtensionActivation(activation:ExtensionActivationResult,options?:DescribeExtensionActivationOptions):ExtensionActivationSummary;
|
|
@@ -3,20 +3,20 @@
|
|
|
3
3
|
*
|
|
4
4
|
* Captures and restores extension registries around one activation attempt.
|
|
5
5
|
*/
|
|
6
|
-
import type { ExtensionCommandRegistry,
|
|
6
|
+
import type { ExtensionCommandRegistry,ExtensionHookRegistry,ExtensionParserRegistry,ExtensionPreflightRegistry,ExtensionRegistrationRegistry,ExtensionRendererRegistry,ExtensionServiceRegistry } from "./extension-types.js";
|
|
7
7
|
interface MutableExtensionActivationState {
|
|
8
|
-
hooks:
|
|
9
|
-
commands:
|
|
10
|
-
parsers:
|
|
11
|
-
preflight:
|
|
12
|
-
services:
|
|
13
|
-
renderers:
|
|
14
|
-
registrations:
|
|
8
|
+
hooks:ExtensionHookRegistry;
|
|
9
|
+
commands:ExtensionCommandRegistry;
|
|
10
|
+
parsers:ExtensionParserRegistry;
|
|
11
|
+
preflight:ExtensionPreflightRegistry;
|
|
12
|
+
services:ExtensionServiceRegistry;
|
|
13
|
+
renderers:ExtensionRendererRegistry;
|
|
14
|
+
registrations:ExtensionRegistrationRegistry;
|
|
15
15
|
}
|
|
16
16
|
/**
|
|
17
17
|
* Return a rollback operation that restores every mutable registry to its
|
|
18
18
|
* current length, making one extension activation atomic without cloning
|
|
19
19
|
* handlers or user values.
|
|
20
20
|
*/
|
|
21
|
-
export declare function captureExtensionActivationRollback(state:
|
|
21
|
+
export declare function captureExtensionActivationRollback(state:MutableExtensionActivationState):() => void;
|
|
22
22
|
export {};
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
* grant. Every declared-but-unused capability is an over-broad permission a
|
|
13
13
|
* reviewer would otherwise have to catch by hand.
|
|
14
14
|
*/
|
|
15
|
-
import type { ExtensionActivationResult,
|
|
15
|
+
import type { ExtensionActivationResult,ExtensionCapability,ExtensionLayer } from "./extension-types.js";
|
|
16
16
|
/**
|
|
17
17
|
* Canonical map from each known extension capability to the human-readable
|
|
18
18
|
* registration surfaces that exercise it.
|
|
@@ -22,36 +22,36 @@ import type { ExtensionActivationResult, ExtensionCapability, ExtensionLayer } f
|
|
|
22
22
|
* without giving it a registration surface here fails the build, which prevents
|
|
23
23
|
* a capability that has *no* surface from being perpetually flagged as unused.
|
|
24
24
|
*/
|
|
25
|
-
export declare const EXTENSION_CAPABILITY_REGISTRATION_SURFACES:
|
|
26
|
-
readonly commands:
|
|
27
|
-
readonly renderers:
|
|
28
|
-
readonly hooks:
|
|
29
|
-
readonly schema:
|
|
30
|
-
readonly importers:
|
|
31
|
-
readonly search:
|
|
32
|
-
readonly parser:
|
|
33
|
-
readonly preflight:
|
|
34
|
-
readonly services:
|
|
25
|
+
export declare const EXTENSION_CAPABILITY_REGISTRATION_SURFACES:{
|
|
26
|
+
readonly commands:readonly ["registerCommand","command override","command handler"];
|
|
27
|
+
readonly renderers:readonly ["registerRenderer"];
|
|
28
|
+
readonly hooks:readonly ["hooks.beforeCommand","hooks.beforeMutation","hooks.afterCommand","hooks.onWrite","hooks.onRead","hooks.onIndex"];
|
|
29
|
+
readonly schema:readonly ["registerFlags","registerItemFields","registerItemTypes","registerRelationshipKinds","registerMigration","registerProfile"];
|
|
30
|
+
readonly importers:readonly ["registerImporter","registerExporter"];
|
|
31
|
+
readonly search:readonly ["registerSearchProvider","registerVectorStoreAdapter"];
|
|
32
|
+
readonly parser:readonly ["registerParser"];
|
|
33
|
+
readonly preflight:readonly ["registerPreflight"];
|
|
34
|
+
readonly services:readonly ["registerService","registerAssuranceMeasurementProvider"];
|
|
35
35
|
};
|
|
36
36
|
/** Per-extension reconciliation of declared versus exercised capabilities. */
|
|
37
37
|
export interface ExtensionCapabilityUsageReconciliation {
|
|
38
38
|
/** Layer the extension was loaded from (`global` or `project`). */
|
|
39
|
-
layer:
|
|
39
|
+
layer:ExtensionLayer;
|
|
40
40
|
/** Extension name as it appears in the manifest. */
|
|
41
|
-
name:
|
|
41
|
+
name:string;
|
|
42
42
|
/** Known capabilities declared in the manifest, sorted and de-duplicated. */
|
|
43
|
-
declared:
|
|
43
|
+
declared:ExtensionCapability[];
|
|
44
44
|
/** Known capabilities the extension actually registered against, sorted. */
|
|
45
|
-
used:
|
|
45
|
+
used:ExtensionCapability[];
|
|
46
46
|
/** Declared capabilities with no matching registration (least-privilege gap). */
|
|
47
|
-
unused:
|
|
47
|
+
unused:ExtensionCapability[];
|
|
48
48
|
}
|
|
49
49
|
/** Options for {@link collectUsedExtensionCapabilities}. */
|
|
50
50
|
export interface CollectUsedExtensionCapabilitiesOptions {
|
|
51
51
|
/** Restrict the result to a single extension by name. Names are matched case-insensitively after trimming. Omit to union across every extension in the activation result. */
|
|
52
|
-
extensionName?:
|
|
52
|
+
extensionName?:string;
|
|
53
53
|
/** Restrict the result to a set of extension names. This preserves the single-name option while allowing package aliases that activate multiple extensions to summarize their combined capability surface. */
|
|
54
|
-
extensionNames?:
|
|
54
|
+
extensionNames?:readonly string[];
|
|
55
55
|
}
|
|
56
56
|
/**
|
|
57
57
|
* Canonical extension-name normalization (trim + lowercase) used to match an
|
|
@@ -62,7 +62,7 @@ extensionNames?: readonly string[];
|
|
|
62
62
|
* by extension name must normalize both sides with this function to stay
|
|
63
63
|
* consistent, including {@link ../extensions/activation-summary.js#describeExtensionActivation}.
|
|
64
64
|
*/
|
|
65
|
-
export declare function normalizeExtensionName(name:
|
|
65
|
+
export declare function normalizeExtensionName(name:string):string;
|
|
66
66
|
/**
|
|
67
67
|
* Collect the known capabilities exercised across an activation result.
|
|
68
68
|
*
|
|
@@ -70,7 +70,7 @@ export declare function normalizeExtensionName(name: string): string;
|
|
|
70
70
|
* result unions every extension in the activation; with it, only the matching
|
|
71
71
|
* extension's registrations contribute (across both layers).
|
|
72
72
|
*/
|
|
73
|
-
export declare function collectUsedExtensionCapabilities(activation:
|
|
73
|
+
export declare function collectUsedExtensionCapabilities(activation:ExtensionActivationResult,options?:CollectUsedExtensionCapabilitiesOptions):ExtensionCapability[];
|
|
74
74
|
/**
|
|
75
75
|
* Reconcile each loaded extension's declared capabilities against what it
|
|
76
76
|
* exercised during activation.
|
|
@@ -79,8 +79,8 @@ export declare function collectUsedExtensionCapabilities(activation: ExtensionAc
|
|
|
79
79
|
* to reconcile. The returned entries preserve every reconcilable extension even
|
|
80
80
|
* when `unused` is empty so callers can report fully-minimal manifests too.
|
|
81
81
|
*/
|
|
82
|
-
export declare function reconcileExtensionCapabilityUsage(loaded:
|
|
83
|
-
layer:
|
|
84
|
-
name:
|
|
85
|
-
capabilities?:
|
|
86
|
-
}>,
|
|
82
|
+
export declare function reconcileExtensionCapabilityUsage(loaded:ReadonlyArray<{
|
|
83
|
+
layer:ExtensionLayer;
|
|
84
|
+
name:string;
|
|
85
|
+
capabilities?:readonly string[];
|
|
86
|
+
}>,activation:ExtensionActivationResult):ExtensionCapabilityUsageReconciliation[];
|