@unbrained/pm-cli 2026.9.6 → 2026.9.8
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/SKILL.md +12 -4
- package/.agents/skills/pm-developer/references/MULTI_AGENT_MERGE.md +19 -10
- package/.agents/skills/pm-extensions/SKILL.md +6 -0
- package/.agents/skills/pm-sdk/SKILL.md +11 -2
- package/.agents/skills/pm-user/SKILL.md +5 -0
- package/.agents/skills/pm-user/references/ECOSYSTEM_PLANNING.md +95 -0
- package/.claude-plugin/marketplace.json +2 -2
- package/CHANGELOG.md +218 -182
- package/dist/cli/after-command-context-usage.js +1 -48
- package/dist/cli/argv-utils.js +1 -40
- package/dist/cli/bootstrap-args.js +1 -9
- package/dist/cli/bundle-integrity.js +2 -110
- package/dist/cli/commander-usage.js +11 -771
- package/dist/cli/commands/activity.js +1 -9
- package/dist/cli/commands/aggregate.js +1 -5
- package/dist/cli/commands/append.js +1 -5
- package/dist/cli/commands/claim.js +1 -5
- package/dist/cli/commands/close-many.js +1 -5
- package/dist/cli/commands/close.js +1 -9
- package/dist/cli/commands/comments.js +1 -5
- package/dist/cli/commands/config.js +1 -9
- package/dist/cli/commands/context.js +1 -9
- package/dist/cli/commands/contracts.js +1 -5
- package/dist/cli/commands/copy.js +1 -9
- package/dist/cli/commands/create.js +1 -9
- package/dist/cli/commands/delete.js +1 -9
- package/dist/cli/commands/deps.js +1 -9
- package/dist/cli/commands/docs.js +1 -9
- package/dist/cli/commands/duplicates.js +1 -9
- package/dist/cli/commands/eval.js +1 -9
- package/dist/cli/commands/extension/describe.js +1 -5
- package/dist/cli/commands/extension/scaffold.js +1 -5
- package/dist/cli/commands/extension/shared.js +1 -5
- package/dist/cli/commands/extension.js +1 -9
- package/dist/cli/commands/files.js +1 -9
- package/dist/cli/commands/focus.js +1 -9
- package/dist/cli/commands/gc.js +1 -9
- package/dist/cli/commands/get.js +1 -9
- package/dist/cli/commands/graph.js +1 -10
- package/dist/cli/commands/health.js +1 -9
- package/dist/cli/commands/history-compact.js +1 -10
- package/dist/cli/commands/history-redact.js +1 -11
- package/dist/cli/commands/history-repair.js +1 -10
- package/dist/cli/commands/history.js +1 -5
- package/dist/cli/commands/index.js +1 -58
- package/dist/cli/commands/init-agent-guidance.js +1 -9
- package/dist/cli/commands/init.js +1 -9
- package/dist/cli/commands/learnings.js +1 -5
- package/dist/cli/commands/lifecycle-transitions.js +1 -5
- package/dist/cli/commands/list.js +1 -9
- package/dist/cli/commands/merge.js +1 -11
- package/dist/cli/commands/next.js +1 -9
- package/dist/cli/commands/notes.js +1 -5
- package/dist/cli/commands/plan.js +1 -9
- package/dist/cli/commands/profile.js +1 -9
- package/dist/cli/commands/restore.js +1 -9
- package/dist/cli/commands/scheduling-shortcuts.js +1 -9
- package/dist/cli/commands/schema.js +1 -10
- package/dist/cli/commands/search.js +1 -9
- package/dist/cli/commands/stats.js +1 -9
- package/dist/cli/commands/telemetry.js +1 -9
- package/dist/cli/commands/test-all.js +1 -9
- package/dist/cli/commands/test-runs.js +1 -9
- package/dist/cli/commands/test.js +1 -9
- package/dist/cli/commands/update-many.js +1 -5
- package/dist/cli/commands/update.js +1 -9
- package/dist/cli/commands/upgrade.js +1 -5
- package/dist/cli/commands/validate.js +1 -15
- package/dist/cli/context-intent-invocation.js +1 -20
- package/dist/cli/description-stdin.js +1 -17
- package/dist/cli/error-guidance.js +1 -1353
- package/dist/cli/extension-command-help.js +5 -636
- package/dist/cli/extension-command-options.js +1 -427
- package/dist/cli/extension-recovery.js +1 -126
- package/dist/cli/help-content.js +2 -1001
- package/dist/cli/help-json-payload.js +4 -570
- package/dist/cli/main.d.ts +4 -0
- package/dist/cli/main.js +5 -2573
- package/dist/cli/migration-gates.js +1 -289
- package/dist/cli/public.js +1 -20
- package/dist/cli/register-annotations.js +1 -270
- package/dist/cli/register-assurance.js +1 -62
- package/dist/cli/register-files-lookup.js +1 -56
- package/dist/cli/register-history-activity.d.ts +8 -0
- package/dist/cli/register-history-activity.js +2 -0
- package/dist/cli/register-history-author.js +1 -38
- package/dist/cli/register-history-maintenance.d.ts +9 -0
- package/dist/cli/register-history-maintenance.js +2 -0
- package/dist/cli/register-list-query.js +10 -943
- package/dist/cli/register-mutation-options.js +1 -9
- package/dist/cli/register-mutation.js +19 -1893
- package/dist/cli/register-operations.js +1 -920
- package/dist/cli/register-setup.js +1 -716
- package/dist/cli/register-structured-mutation.js +1 -196
- package/dist/cli/registration-helpers.js +1 -5
- package/dist/cli/runtime-compatibility-boundary.js +4 -42
- package/dist/cli/schema-registration-helpers.js +1 -73
- package/dist/cli/search-refresh.js +1 -13
- package/dist/cli/stats-analytics-json.js +1 -68
- package/dist/cli/telemetry-flush.js +1 -10
- package/dist/cli-bundle/bundle-manifest.json +164 -156
- package/dist/cli-bundle/chunks/chunk-3BZZA6A3.js +5 -0
- package/dist/cli-bundle/chunks/chunk-AMRDVX36.js +235 -0
- package/dist/cli-bundle/chunks/chunk-DAM4CBBR.js +2202 -0
- package/dist/cli-bundle/chunks/{chunk-WYRZZ5ZE.js → chunk-DEZPZOQ7.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-FLDWYEND.js +77 -0
- package/dist/cli-bundle/chunks/{chunk-NPN5I67J.js → chunk-G5ADGQ2D.js} +3 -3
- package/dist/cli-bundle/chunks/chunk-JAAEYHUA.js +2 -0
- package/dist/cli-bundle/chunks/{chunk-JX4DH4WC.js → chunk-KR3RP4FH.js} +3 -3
- package/dist/cli-bundle/chunks/chunk-LEZOUXG6.js +2 -0
- package/dist/cli-bundle/chunks/chunk-NSAPNEYH.js +2 -0
- package/dist/cli-bundle/chunks/chunk-QOEKOECV.js +29 -0
- package/dist/cli-bundle/chunks/chunk-RHSFOMHU.js +2 -0
- package/dist/cli-bundle/chunks/chunk-XOD2PCB6.js +20 -0
- package/dist/cli-bundle/chunks/{chunk-JT6XF6GE.js → chunk-YVEQ2AMO.js} +4 -4
- package/dist/cli-bundle/chunks/register-list-query-KSK3R63M.js +11 -0
- package/dist/cli-bundle/chunks/register-mutation-IQ5C7U6O.js +20 -0
- package/dist/cli-bundle/chunks/{register-operations-I5W3KMGB.js → register-operations-DWVHR2NC.js} +2 -2
- package/dist/cli-bundle/chunks/register-setup-BQ5SVD4B.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-3WRPWLA7.js +3 -0
- package/dist/cli-bundle/focused-chunks/chunk-7MBUII7U.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-COPBO5HW.js +8 -0
- package/dist/cli-bundle/focused-chunks/chunk-DUN4IXYN.js +20 -0
- package/dist/cli-bundle/focused-chunks/{chunk-LIJIA4TY.js → chunk-EE5QSM4Z.js} +3 -3
- package/dist/cli-bundle/focused-chunks/chunk-HJVARYM3.js +6 -0
- package/dist/cli-bundle/focused-chunks/chunk-IAUOUGVR.js +177 -0
- package/dist/cli-bundle/focused-chunks/chunk-KOOMJ54F.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-MZDXX7JY.js +56 -0
- package/dist/cli-bundle/focused-chunks/{chunk-M6PBRFSH.js → chunk-OPFHFGDD.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-QHNETP77.js +9 -0
- package/dist/cli-bundle/focused-chunks/{chunk-3BZEOXLT.js → chunk-RMWES4M6.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-RXT4P5QH.js +10 -0
- package/dist/cli-bundle/focused-chunks/chunk-SDOL6FM2.js +12 -0
- package/dist/cli-bundle/focused-chunks/chunk-SQV4AAUC.js +2 -0
- package/dist/cli-bundle/focused-chunks/{chunk-PEFABF7E.js → chunk-WE3IUNIW.js} +3 -3
- package/dist/cli-bundle/focused-chunks/chunk-YALOUBWJ.js +2 -0
- package/dist/cli-bundle/main.js +20 -20
- 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 +29 -29
- 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 +42 -42
- 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 +11 -11
- package/dist/cli.js +1 -104
- package/dist/core/checkpoint/checkpoint-gc.js +1 -169
- package/dist/core/checkpoint/mutation-checkpoint.js +2 -133
- package/dist/core/config/nested-settings.js +1 -534
- package/dist/core/config/positional-value.js +1 -109
- package/dist/core/diagnostics/remediation.js +1 -506
- package/dist/core/extensions/activation-summary-markdown.js +2 -145
- package/dist/core/extensions/activation-summary.js +1 -92
- package/dist/core/extensions/activation-transaction.js +1 -46
- package/dist/core/extensions/capability-usage.js +1 -173
- package/dist/core/extensions/command-hook-context.js +1 -13
- package/dist/core/extensions/command-metadata-contract.js +1 -22
- package/dist/core/extensions/command-visibility-tier.js +1 -29
- package/dist/core/extensions/contribution-inventory.js +1 -173
- package/dist/core/extensions/exporter-output-contract.js +1 -66
- package/dist/core/extensions/extension-candidate.js +1 -18
- package/dist/core/extensions/extension-capability-aliases.js +1 -158
- package/dist/core/extensions/extension-hook-runtime.js +1 -699
- package/dist/core/extensions/extension-policy.js +1 -599
- package/dist/core/extensions/extension-registries.js +1 -62
- package/dist/core/extensions/extension-runtime-helpers.js +1 -33
- package/dist/core/extensions/extension-types.js +1 -102
- package/dist/core/extensions/flag-definition-validation.js +1 -52
- package/dist/core/extensions/flag-value-types.js +1 -64
- package/dist/core/extensions/index.js +1 -526
- package/dist/core/extensions/item-field-types.js +1 -39
- package/dist/core/extensions/item-fields.js +1 -261
- package/dist/core/extensions/loader.js +1 -2223
- package/dist/core/extensions/manifest-schema.js +1 -69
- package/dist/core/extensions/module-graph-snapshot.js +1 -33
- package/dist/core/extensions/preflight-ownership.js +1 -41
- package/dist/core/extensions/registration-validation.js +1 -82
- package/dist/core/extensions/registration-values.js +1 -209
- package/dist/core/extensions/reserved-host-flags.js +1 -36
- package/dist/core/extensions/runtime-registrations.js +1 -67
- package/dist/core/extensions/service-ownership.js +1 -19
- package/dist/core/extensions/version-compat.js +1 -216
- package/dist/core/fs/fs-utils.js +2 -158
- package/dist/core/fs/host-environment-errors.js +1 -141
- package/dist/core/fs/index.js +1 -9
- package/dist/core/fs/path-utils.js +1 -17
- package/dist/core/governance/content-fields.js +1 -160
- package/dist/core/governance/issue-codes.js +1 -151
- package/dist/core/governance/metadata-coverage.js +1 -358
- package/dist/core/history/drift-cache.js +3 -72
- package/dist/core/history/drift-scan.js +1 -342
- package/dist/core/history/event-classification.js +1 -109
- package/dist/core/history/event-index.js +8 -784
- package/dist/core/history/history-compact-bulk.js +1 -104
- package/dist/core/history/history-diff.js +1 -158
- package/dist/core/history/history-rewrite.d.ts +6 -1
- package/dist/core/history/history-rewrite.js +1 -107
- package/dist/core/history/history-storage-stats.js +1 -102
- package/dist/core/history/history-stream-policy.js +1 -62
- package/dist/core/history/history.js +2 -617
- package/dist/core/history/identity.js +1 -30
- package/dist/core/history/index.js +1 -9
- package/dist/core/history/projection.js +1 -196
- package/dist/core/history/read.d.ts +9 -0
- package/dist/core/history/read.js +1 -57
- package/dist/core/history/replay.js +2 -439
- package/dist/core/history/version-address.js +1 -32
- package/dist/core/history/workspace-history.js +2 -433
- package/dist/core/io/body-file.js +1 -62
- package/dist/core/io/bulk-ids-input.js +1 -112
- package/dist/core/item/actionability.js +1 -327
- package/dist/core/item/dependency-reference.js +1 -20
- package/dist/core/item/id.js +1 -112
- package/dist/core/item/index.js +1 -12
- package/dist/core/item/item-format-version.js +1 -78
- package/dist/core/item/item-format.js +5 -1473
- package/dist/core/item/item-record.js +1 -23
- package/dist/core/item/item-type-definition.js +1 -133
- package/dist/core/item/parent-reference-policy.js +1 -57
- package/dist/core/item/parse.js +2 -603
- package/dist/core/item/plan-lifecycle.js +1 -19
- package/dist/core/item/priority.js +1 -61
- package/dist/core/item/sprint-release-format.js +1 -38
- package/dist/core/item/status-filter.js +1 -115
- package/dist/core/item/status.js +1 -43
- package/dist/core/item/toon-decode.js +1 -29
- package/dist/core/item/type-registry.js +1 -715
- package/dist/core/item/type-synonyms.js +1 -38
- package/dist/core/lock/index.js +1 -9
- package/dist/core/lock/lock-gc.js +1 -240
- package/dist/core/lock/lock.js +3 -590
- package/dist/core/output/mutation-projection.js +1 -217
- package/dist/core/output/output-control.js +1 -25
- package/dist/core/output/output.js +11 -494
- package/dist/core/output/query-summary.js +1 -58
- package/dist/core/output/tabular.js +1 -77
- package/dist/core/packages/manifest.js +1 -244
- package/dist/core/packages/root.js +1 -84
- package/dist/core/profile/profile-describe.js +1 -83
- package/dist/core/profile/profile-lint.js +1 -415
- package/dist/core/profile/profile-plan.js +0 -0
- package/dist/core/profile/profile-presets.js +1 -370
- package/dist/core/reproducibility/context.js +1 -82
- package/dist/core/schema/fields-file.js +2 -288
- package/dist/core/schema/item-types-file.js +2 -296
- package/dist/core/schema/runtime-field-filters.js +1 -49
- package/dist/core/schema/runtime-field-values.js +1 -313
- package/dist/core/schema/runtime-schema.js +2 -826
- package/dist/core/schema/status-defs-file.js +2 -227
- package/dist/core/schema/status-token.js +1 -31
- package/dist/core/schema/type-inference.js +1 -95
- package/dist/core/schema/type-presets.js +1 -87
- package/dist/core/schema/type-workflows.js +1 -104
- package/dist/core/search/background-refresh.js +2 -286
- package/dist/core/search/bm25.js +1 -146
- package/dist/core/search/cache.js +2 -534
- package/dist/core/search/corpus.js +1 -311
- package/dist/core/search/embedding-batches.js +1 -163
- package/dist/core/search/eval.js +1 -225
- package/dist/core/search/http-client.js +1 -75
- package/dist/core/search/providers.js +1 -242
- package/dist/core/search/relevance.js +1 -244
- package/dist/core/search/semantic-defaults.js +1 -199
- package/dist/core/search/staleness.js +1 -30
- package/dist/core/search/vector-stores.js +2 -664
- package/dist/core/search/vectorization-metadata.js +1 -81
- package/dist/core/sentry/helpers.js +1 -272
- package/dist/core/sentry/instrument.js +1 -387
- package/dist/core/session/session-state.js +1 -260
- package/dist/core/shared/agent-session-context.js +1 -133
- package/dist/core/shared/author.js +1 -1172
- package/dist/core/shared/command-types.js +1 -4
- package/dist/core/shared/conflict-markers.js +1 -31
- package/dist/core/shared/constants.js +1 -405
- package/dist/core/shared/errors.js +1 -20
- package/dist/core/shared/html-entity-decode.js +1 -131
- package/dist/core/shared/index.js +1 -12
- package/dist/core/shared/item-metadata-contract.js +1 -89
- package/dist/core/shared/lazy-module.js +1 -16
- package/dist/core/shared/levenshtein.js +1 -61
- package/dist/core/shared/memo.js +1 -19
- package/dist/core/shared/numeric-parsers.js +1 -20
- package/dist/core/shared/option-alias-visibility.js +1 -67
- package/dist/core/shared/primitives.js +1 -127
- package/dist/core/shared/serial-queue.js +1 -79
- package/dist/core/shared/serialization.js +1 -210
- package/dist/core/shared/split-comma-list.js +1 -30
- package/dist/core/shared/text-normalization.js +1 -38
- package/dist/core/shared/time.js +1 -306
- package/dist/core/store/index.js +1 -12
- package/dist/core/store/item-format-migration.js +1 -125
- package/dist/core/store/item-metadata-cache.js +1 -1116
- package/dist/core/store/item-metadata-query-index.js +9 -394
- package/dist/core/store/item-metadata-read-work.js +1 -43
- package/dist/core/store/item-store.js +1 -693
- package/dist/core/store/paths.d.ts +1 -1
- package/dist/core/store/paths.js +1 -214
- package/dist/core/store/settings-read-cache.js +1 -85
- package/dist/core/store/settings-validator.js +1 -421
- package/dist/core/store/settings.js +3 -1309
- package/dist/core/store/tracker-preflight.js +1 -141
- package/dist/core/telemetry/consent.js +5 -108
- package/dist/core/telemetry/observability.js +1 -246
- package/dist/core/telemetry/runtime.js +4 -1988
- package/dist/core/test/background-runs.js +4 -945
- package/dist/core/test/item-test-run-tracking.js +1 -63
- package/dist/core/test/run-selectors.js +1 -120
- package/dist/core/validate/estimate-defaults.js +1 -89
- package/dist/core/validate/fix-planning.js +1 -189
- package/dist/core/validate/linked-artifact-reference.js +1 -36
- package/dist/core/validate/missing-by-type.js +1 -34
- package/dist/core/validate/missing-link-owners.js +1 -95
- package/dist/core/validate/stale-file-classification.js +1 -82
- package/dist/mcp/http-server.js +5 -448
- package/dist/mcp/legacy-adapter.js +1 -77
- package/dist/mcp/runtime-capabilities.js +1 -200
- package/dist/mcp/server.js +4 -1233
- package/dist/mcp/tool-definitions.js +1 -804
- package/dist/sdk/actionability.js +1 -13
- package/dist/sdk/agent/closed-domain-contracts.js +1 -161
- package/dist/sdk/agent/command-recovery.js +1 -59
- package/dist/sdk/agent/command-suggestions.js +1 -66
- package/dist/sdk/agent/create-option-policy.js +1 -31
- package/dist/sdk/agent/identity-config.js +1 -106
- package/dist/sdk/agent/item-addressing.js +1 -207
- package/dist/sdk/agent/refusal-closure-census.js +1 -151
- package/dist/sdk/agent/refusal-closure.js +1 -133
- package/dist/sdk/agent/refusal-corpus-contracts.js +1 -193
- package/dist/sdk/agent/refusal-reachability.js +1 -593
- package/dist/sdk/agent/subcommand-recovery.js +1 -83
- package/dist/sdk/agent/task-transcript-contracts.js +1 -197
- package/dist/sdk/agent/tracker-preflight-contracts.js +1 -126
- package/dist/sdk/agent-capability-contracts.js +1 -428
- package/dist/sdk/agent-session-context.js +1 -9
- package/dist/sdk/annotations.js +1 -448
- package/dist/sdk/author-attribution.js +1 -468
- package/dist/sdk/authoring.js +1 -20
- package/dist/sdk/cli-bootstrap.js +1 -838
- package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +1 -1
- package/dist/sdk/cli-contracts/agent-output-contracts.js +4 -476
- package/dist/sdk/cli-contracts/bootstrap-command-scanner.js +1 -79
- package/dist/sdk/cli-contracts/command-aliases.d.ts +4 -0
- package/dist/sdk/cli-contracts/command-aliases.js +1 -107
- package/dist/sdk/cli-contracts/command-exit-contracts.js +1 -151
- package/dist/sdk/cli-contracts/commander-mutation-options.js +1 -1081
- package/dist/sdk/cli-contracts/commander-types.js +1 -159
- package/dist/sdk/cli-contracts/completeness.js +1 -393
- package/dist/sdk/cli-contracts/enum-contracts.js +1 -222
- package/dist/sdk/cli-contracts/flag-contracts.js +1 -1947
- package/dist/sdk/cli-contracts/flag-lexicon-contracts.js +1 -347
- package/dist/sdk/cli-contracts/grammar-contracts.js +1 -986
- package/dist/sdk/cli-contracts/registration-helpers.js +7 -990
- package/dist/sdk/cli-contracts/runtime-contracts.d.ts +5 -0
- package/dist/sdk/cli-contracts/runtime-contracts.js +1 -2090
- package/dist/sdk/cli-contracts/schemas/assurance-definition.js +1 -324
- package/dist/sdk/cli-contracts/string-lists.js +1 -16
- package/dist/sdk/cli-contracts/tool-option-contracts.js +1 -461
- package/dist/sdk/cli-contracts/tool-parameter-tables.js +1 -2167
- package/dist/sdk/cli-contracts/tool-schema.d.ts +3 -1
- package/dist/sdk/cli-contracts/tool-schema.js +1 -1664
- package/dist/sdk/cli-contracts/typed-action-inputs.js +1 -4
- package/dist/sdk/cli-contracts.d.ts +1 -1
- package/dist/sdk/cli-contracts.js +1 -17
- package/dist/sdk/cli-program.js +1 -49
- package/dist/sdk/command-line.d.ts +2 -5
- package/dist/sdk/command-line.js +1 -78
- package/dist/sdk/comments.js +1 -133
- package/dist/sdk/compile-cache.js +1 -73
- package/dist/sdk/completion.js +157 -837
- package/dist/sdk/compose.js +1 -1090
- package/dist/sdk/config.js +1 -1204
- package/dist/sdk/context/recency.js +1 -33
- package/dist/sdk/context/semantic-session-attribution.js +1 -82
- package/dist/sdk/context/usage-egress.js +1 -29
- package/dist/sdk/context/usage-ledger.js +3 -185
- package/dist/sdk/context-intent-contracts.js +1 -709
- package/dist/sdk/context-intent-runtime.js +1 -115
- package/dist/sdk/context-packing.js +1 -218
- package/dist/sdk/context-relevance.js +1 -503
- package/dist/sdk/context-signal-store.js +2 -426
- package/dist/sdk/context-usage.js +1 -367
- package/dist/sdk/contracts.js +1 -23
- package/dist/sdk/core-governance.js +1 -14
- package/dist/sdk/core.js +1 -14
- package/dist/sdk/corpus-shape.js +1 -401
- package/dist/sdk/define.js +1 -220
- package/dist/sdk/dependencies.js +1 -718
- package/dist/sdk/dependency-flag-validation.js +1 -156
- package/dist/sdk/dependency-provenance.js +1 -135
- package/dist/sdk/docs.js +1 -14
- package/dist/sdk/duplicates.js +1 -40
- package/dist/sdk/environment/agent-environment.js +1 -466
- package/dist/sdk/environment/host-environment-errors.js +1 -8
- package/dist/sdk/environment/project-runtime-compatibility.js +1 -481
- package/dist/sdk/environment/source-context.js +1 -28
- package/dist/sdk/environment/tracker-preflight.js +1 -9
- package/dist/sdk/error-code-catalog.js +1 -153
- package/dist/sdk/error-runtime.js +1 -58
- package/dist/sdk/errors.js +1 -58
- package/dist/sdk/eval.js +1 -190
- package/dist/sdk/extension/author-manifest.js +1 -92
- package/dist/sdk/extension/bundled-catalog.js +1 -332
- package/dist/sdk/extension/concurrency.js +1 -25
- package/dist/sdk/extension/copy-scope.d.ts +2 -0
- package/dist/sdk/extension/copy-scope.js +2 -0
- package/dist/sdk/extension/custom-field-collisions.js +1 -30
- package/dist/sdk/extension/describe.js +3 -189
- package/dist/sdk/extension/doctor.js +1 -606
- package/dist/sdk/extension/install-plan.d.ts +69 -0
- package/dist/sdk/extension/install-plan.js +2 -0
- package/dist/sdk/extension/install-receipts.d.ts +7 -0
- package/dist/sdk/extension/install-receipts.js +2 -0
- package/dist/sdk/extension/install-runtime.js +3 -313
- package/dist/sdk/extension/install-snapshot.js +1 -66
- package/dist/sdk/extension/install-sources.js +5 -1057
- package/dist/sdk/extension/managed-state.js +2 -252
- package/dist/sdk/extension/migrations.js +2 -174
- package/dist/sdk/extension/output-ownership.js +1 -25
- package/dist/sdk/extension/runtime-summary.js +1 -18
- package/dist/sdk/extension/scaffold.js +4 -2308
- package/dist/sdk/extension/shared.js +1 -147
- package/dist/sdk/extension/source-resolution.js +1 -65
- package/dist/sdk/extension/update-check.js +1 -67
- package/dist/sdk/extension-command-context.js +1 -44
- package/dist/sdk/extension-contracts.js +1 -73
- package/dist/sdk/extension.d.ts +7 -2
- package/dist/sdk/extension.js +1 -2196
- package/dist/sdk/files.js +1 -535
- package/dist/sdk/flag-invocation-contracts.d.ts +0 -5
- package/dist/sdk/flag-invocation-contracts.js +1 -344
- package/dist/sdk/generated/generated-error-code-catalog-part-1.js +1 -2224
- package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -2236
- package/dist/sdk/generated-error-code-catalog.js +1 -16
- package/dist/sdk/governance/assurance-action-contracts.js +1 -4
- package/dist/sdk/governance/assurance-action.js +1 -411
- package/dist/sdk/governance/assurance-limits.js +1 -10
- package/dist/sdk/governance/assurance-mutation-error.js +1 -81
- package/dist/sdk/governance/assurance-presets.js +1 -135
- package/dist/sdk/governance/assurance-runtime.js +1 -238
- package/dist/sdk/governance/assurance.js +4 -1182
- package/dist/sdk/governance/boundary-fixtures.js +1 -200
- package/dist/sdk/governance/coverage-assurance.js +1 -60
- package/dist/sdk/governance/defect-recurrence-coverage.js +1 -188
- package/dist/sdk/governance/defect-recurrence-graph.js +1 -120
- package/dist/sdk/governance/defect-recurrence-signals.js +1 -24
- package/dist/sdk/governance/defect-recurrence.js +1 -623
- package/dist/sdk/governance/extension-host-version.js +1 -115
- package/dist/sdk/governance/gc.js +1 -368
- package/dist/sdk/governance/health.js +1 -2367
- package/dist/sdk/governance/hierarchy-validation.js +1 -108
- package/dist/sdk/governance/linked-file-report.js +1 -71
- package/dist/sdk/governance/merge-receipt-history.js +1 -206
- package/dist/sdk/governance/provenance-health.js +1 -282
- package/dist/sdk/governance/reindex.js +4 -761
- package/dist/sdk/governance/stale-work.js +1 -82
- package/dist/sdk/governance/status-role-diagnostics.js +1 -35
- package/dist/sdk/governance/storage-integrity.js +1 -280
- package/dist/sdk/governance/tracked-runtime-cache.js +1 -106
- package/dist/sdk/governance/upgrade.js +2 -327
- package/dist/sdk/governance/validate-history-drift.js +1 -81
- package/dist/sdk/governance/validate-item-reader.js +1 -17
- package/dist/sdk/governance/validate-normalization.js +1 -36
- package/dist/sdk/governance/validate.js +1 -2261
- package/dist/sdk/governance/workspace-position.js +1 -163
- package/dist/sdk/governance.d.ts +1 -0
- package/dist/sdk/governance.js +1 -31
- package/dist/sdk/graph/adapter.js +1 -181
- package/dist/sdk/graph/analytics.js +1 -474
- package/dist/sdk/graph/assembly.js +1 -377
- package/dist/sdk/graph/cache.js +1 -160
- package/dist/sdk/graph/centrality.js +1 -258
- package/dist/sdk/graph/conformance.js +1 -130
- package/dist/sdk/graph/deadline-scheduling.d.ts +90 -0
- package/dist/sdk/graph/deadline-scheduling.js +2 -0
- package/dist/sdk/graph/durable-cache.d.ts +1 -1
- package/dist/sdk/graph/durable-cache.js +1 -361
- package/dist/sdk/graph/governance-contracts.js +1 -34
- package/dist/sdk/graph/governance.d.ts +13 -1
- package/dist/sdk/graph/governance.js +1 -735
- package/dist/sdk/graph/hierarchy-integrity.js +1 -310
- package/dist/sdk/graph/index.d.ts +3 -2
- package/dist/sdk/graph/index.js +1 -26
- package/dist/sdk/graph/lifecycle-coverage.d.ts +32 -0
- package/dist/sdk/graph/lifecycle-coverage.js +2 -0
- package/dist/sdk/graph/mutation-advisory.js +1 -176
- package/dist/sdk/graph/remediation.js +1 -197
- package/dist/sdk/graph/run.d.ts +15 -1
- package/dist/sdk/graph/run.js +1 -768
- package/dist/sdk/graph/scheduling.js +1 -124
- package/dist/sdk/graph/traversal.js +1 -284
- package/dist/sdk/graph/workspace-relationship-kind-registry.js +1 -27
- package/dist/sdk/graph.js +1 -15
- package/dist/sdk/guide-topics.js +1 -707
- package/dist/sdk/guide.js +1 -279
- package/dist/sdk/history/maintenance.d.ts +71 -0
- package/dist/sdk/history/maintenance.js +2 -0
- package/dist/sdk/history/salvage.js +2 -247
- package/dist/sdk/history/subject.d.ts +19 -0
- package/dist/sdk/history/subject.js +2 -0
- package/dist/sdk/history-analytics.js +1 -282
- package/dist/sdk/history-compact.js +1 -527
- package/dist/sdk/history-mcp.js +1 -68
- package/dist/sdk/history-provenance.js +1 -182
- package/dist/sdk/history-read.js +1 -96
- package/dist/sdk/history-redact.d.ts +1 -14
- package/dist/sdk/history-redact.js +1 -643
- package/dist/sdk/history-repair.d.ts +5 -0
- package/dist/sdk/history-repair.js +1 -657
- package/dist/sdk/improvement-ledger-validation.js +1 -62
- package/dist/sdk/improvement-ledger.js +2 -257
- package/dist/sdk/index.d.ts +4 -0
- package/dist/sdk/index.js +1 -183
- package/dist/sdk/init-agent-guidance.js +2 -496
- package/dist/sdk/init.js +2 -820
- package/dist/sdk/invocation-author.js +1 -39
- package/dist/sdk/item-children.js +1 -90
- package/dist/sdk/item-metadata-index.js +1 -15
- package/dist/sdk/item-schedule.js +1 -27
- package/dist/sdk/item-transaction.js +1 -396
- package/dist/sdk/learnings.js +1 -29
- package/dist/sdk/lifecycle/append.js +2 -53
- package/dist/sdk/lifecycle/claim.d.ts +2 -0
- package/dist/sdk/lifecycle/claim.js +1 -242
- package/dist/sdk/lifecycle/close-many.js +1 -438
- package/dist/sdk/lifecycle/close.js +1 -468
- package/dist/sdk/lifecycle/copy.js +1 -212
- package/dist/sdk/lifecycle/create.js +1 -1949
- package/dist/sdk/lifecycle/delete.js +1 -45
- package/dist/sdk/lifecycle/event-validation-messages.js +1 -91
- package/dist/sdk/lifecycle/focus.js +1 -91
- package/dist/sdk/lifecycle/hierarchy-mutation-lock.js +1 -24
- package/dist/sdk/lifecycle/legacy-none-tokens.js +1 -149
- package/dist/sdk/lifecycle/lifecycle-transitions.js +1 -40
- package/dist/sdk/lifecycle/mcp-actions.d.ts +2 -0
- package/dist/sdk/lifecycle/mcp-actions.js +1 -51
- package/dist/sdk/lifecycle/metadata-normalizers.js +1 -46
- package/dist/sdk/lifecycle/mutation-command-options.js +1 -9
- package/dist/sdk/lifecycle/plan.js +1 -1606
- package/dist/sdk/lifecycle/recurrence-parsers.js +1 -147
- package/dist/sdk/lifecycle/reopen.js +1 -68
- package/dist/sdk/lifecycle/repeatable-metadata-parsers.js +1 -143
- package/dist/sdk/lifecycle/restore.d.ts +1 -0
- package/dist/sdk/lifecycle/restore.js +1 -330
- package/dist/sdk/lifecycle/shared-unset-fields.js +1 -295
- package/dist/sdk/lifecycle/update-many.js +1 -861
- package/dist/sdk/lifecycle/update.js +1 -2136
- package/dist/sdk/lifecycle-completion.js +1 -92
- package/dist/sdk/lifecycle-policy.js +1 -120
- package/dist/sdk/linked-artifacts.js +1 -530
- package/dist/sdk/mcp/apps.js +4 -133
- package/dist/sdk/mcp/authorization.js +1 -404
- package/dist/sdk/mcp/discovery.js +1 -494
- package/dist/sdk/mcp/interactions.js +1 -336
- package/dist/sdk/mcp/protocol.d.ts +7 -0
- package/dist/sdk/mcp/protocol.js +1 -184
- package/dist/sdk/mcp/skills.js +1 -389
- package/dist/sdk/mcp/subscriptions.js +1 -211
- package/dist/sdk/mcp/tasks.js +2 -430
- package/dist/sdk/mcp/transport.js +1 -260
- package/dist/sdk/merge/abandoned-receipts.js +1 -46
- package/dist/sdk/merge/driver.js +1 -212
- package/dist/sdk/merge/index.js +1 -16
- package/dist/sdk/merge/install.js +3 -561
- package/dist/sdk/merge/receipt-file-boundary.js +1 -46
- package/dist/sdk/merge/receipt-operation.js +1 -96
- package/dist/sdk/merge/receipt-schema.js +1 -397
- package/dist/sdk/merge/receipts.js +4 -525
- package/dist/sdk/merge/reconcile.js +1 -352
- package/dist/sdk/merge/three-way.js +3 -775
- package/dist/sdk/merge.js +1 -10
- package/dist/sdk/mutation-events.js +1 -292
- package/dist/sdk/mutation-guard.js +1 -216
- package/dist/sdk/notes.js +1 -139
- package/dist/sdk/output-contracts.js +1 -172
- package/dist/sdk/output-projection.js +1 -430
- package/dist/sdk/output-token-accounting.js +1 -140
- package/dist/sdk/output.js +1 -64
- package/dist/sdk/ownership-source.js +1 -21
- package/dist/sdk/package-import-adapters.js +1 -442
- package/dist/sdk/package-migrations.js +1 -20
- package/dist/sdk/package-runtime-options.js +1 -80
- package/dist/sdk/pagination.js +1 -162
- package/dist/sdk/profile.js +1 -454
- package/dist/sdk/provenance.js +1 -258
- package/dist/sdk/public-surface.json +1 -1
- package/dist/sdk/query/activity.js +1 -401
- package/dist/sdk/query/aggregate.d.ts +16 -0
- package/dist/sdk/query/aggregate.js +1 -390
- package/dist/sdk/query/calendar.js +1 -964
- package/dist/sdk/query/complete-list.js +1 -215
- package/dist/sdk/query/context.js +1 -1702
- package/dist/sdk/query/duplicate-candidates.js +1 -70
- package/dist/sdk/query/get.js +1 -450
- package/dist/sdk/query/history.js +1 -186
- package/dist/sdk/query/item-filter-options.js +1 -9
- package/dist/sdk/query/light-metadata.js +1 -18
- package/dist/sdk/query/list-filter-shared.js +1 -81
- package/dist/sdk/query/list.js +1 -1304
- package/dist/sdk/query/multi-value-filters.js +1 -78
- package/dist/sdk/query/next.js +1 -513
- package/dist/sdk/query/parsers.js +1 -44
- package/dist/sdk/query/projection-contracts.js +1 -184
- package/dist/sdk/query/search-contracts.js +1 -230
- package/dist/sdk/query/search-pagination.js +1 -35
- package/dist/sdk/query/search-rendering.js +1 -105
- package/dist/sdk/query/search.js +2 -1987
- package/dist/sdk/query.js +1 -35
- package/dist/sdk/read-output/continuation.js +1 -194
- package/dist/sdk/read-output-budget.js +1 -135
- package/dist/sdk/read-output-contracts.js +1 -1225
- package/dist/sdk/read-output-rows.js +1 -186
- package/dist/sdk/read-output-session.js +1 -208
- package/dist/sdk/relationship-analytics.js +1 -410
- package/dist/sdk/relationship-context.js +1 -284
- package/dist/sdk/relationship-history.js +4 -519
- package/dist/sdk/relationship-kinds/contract.js +1 -22
- package/dist/sdk/relationship-migration.js +1 -77
- package/dist/sdk/relationships.js +1 -579
- package/dist/sdk/reproducibility/process.js +1 -87
- package/dist/sdk/runtime-action-aliases.js +1 -59
- package/dist/sdk/runtime-extended-actions.js +1 -177
- package/dist/sdk/runtime-input.js +1 -614
- package/dist/sdk/runtime-primitives.js +1 -84
- package/dist/sdk/runtime-public-contracts.js +1 -4
- package/dist/sdk/runtime-stats-options.js +1 -38
- package/dist/sdk/runtime.js +1 -1928
- package/dist/sdk/scheduling-shortcuts.js +1 -63
- package/dist/sdk/schema-migration.js +3 -856
- package/dist/sdk/schema.js +1 -1376
- package/dist/sdk/search-refresh-worker.js +1 -18
- package/dist/sdk/similarity-scoring.js +1 -53
- package/dist/sdk/similarity.js +1 -326
- package/dist/sdk/start-task-status.js +1 -14
- package/dist/sdk/stats.js +1 -270
- package/dist/sdk/structured-mutations.js +1 -580
- package/dist/sdk/telemetry-flush.js +1 -13
- package/dist/sdk/telemetry.js +1 -405
- package/dist/sdk/templates.js +2 -292
- package/dist/sdk/test/batch.js +2 -509
- package/dist/sdk/test/entry.js +1 -70
- package/dist/sdk/test/execution.js +6 -2211
- package/dist/sdk/test/linked-command-detection.js +1 -546
- package/dist/sdk/test/measurements.js +1 -91
- package/dist/sdk/test/parsers.js +1 -545
- package/dist/sdk/test/runs.js +1 -193
- package/dist/sdk/test/trust.js +2 -206
- package/dist/sdk/testing.js +4 -1391
- package/dist/sdk/traceability/runtime-files-lookup.js +1 -32
- package/dist/sdk/traceability/source-traceability.js +1 -292
- package/dist/sdk/tracker-root-discovery.js +1 -9
- package/dist/sdk/workspace-contracts-cache.js +1 -28
- package/dist/sdk/workspace-contracts.js +1 -33
- package/dist/sdk/workspace-memory.js +2 -318
- package/dist/sdk/workspace-recipe.js +1 -71
- package/dist/sdk/workspace-snapshot.js +4 -613
- package/dist/sdk/workspace-transaction-gc.js +1 -149
- package/dist/sdk/workspace-transaction.js +2 -363
- package/dist/sdk/workspace.js +3 -127
- package/dist/types/index.js +1 -9
- package/dist/types.js +1 -245
- package/docs/AGENT_GUIDE.md +1 -1
- package/docs/CONTEXT_ALGORITHM_PORTFOLIO.md +167 -0
- package/docs/DIAGNOSTIC_OUTPUT_CONTRACTS.md +9 -3
- package/docs/EXTENSIONS.md +1 -0
- package/docs/HISTORY_MAINTENANCE.md +125 -0
- package/docs/MCP_2026_07_28_CONFORMANCE.md +20 -10
- package/docs/PACKAGE_EVIDENCE.md +92 -0
- package/docs/PLANNING_MEASUREMENTS.md +183 -0
- package/docs/README.md +3 -0
- package/docs/RELEASING.md +1 -0
- package/docs/SCRIPTING.md +21 -0
- package/docs/TESTING.md +23 -0
- package/docs/generated/FLAG_LEXICON_BUDGETS.md +5 -5
- package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +2 -2
- package/marketplace.json +2 -2
- package/package.json +1 -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-codex/.codex-plugin/plugin.json +1 -1
- package/scripts/finalize-build.mjs +45 -3
- package/dist/cli-bundle/chunks/chunk-AZDFJGH6.js +0 -9
- package/dist/cli-bundle/chunks/chunk-BAX2BYUW.js +0 -2111
- package/dist/cli-bundle/chunks/chunk-CKOL5U7J.js +0 -77
- package/dist/cli-bundle/chunks/chunk-OF76PSDQ.js +0 -5
- package/dist/cli-bundle/chunks/chunk-QUWFABDM.js +0 -232
- package/dist/cli-bundle/chunks/chunk-QWRRFYK3.js +0 -2
- package/dist/cli-bundle/chunks/chunk-RWWBOWJ5.js +0 -2
- package/dist/cli-bundle/chunks/chunk-WGAOYSYH.js +0 -40
- package/dist/cli-bundle/chunks/chunk-WI2AYPA7.js +0 -2
- package/dist/cli-bundle/chunks/register-list-query-5JL52D33.js +0 -11
- package/dist/cli-bundle/chunks/register-mutation-ZPG7KMVP.js +0 -20
- package/dist/cli-bundle/chunks/register-setup-H4SVAVX7.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-AL5ON6K6.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-CHC2IDXA.js +0 -6
- package/dist/cli-bundle/focused-chunks/chunk-CK6QFAPZ.js +0 -20
- package/dist/cli-bundle/focused-chunks/chunk-EZR3GHFE.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-H2WJWK7L.js +0 -56
- package/dist/cli-bundle/focused-chunks/chunk-NTPY5GSO.js +0 -3
- package/dist/cli-bundle/focused-chunks/chunk-P5O7MP5Y.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-PDMW2E36.js +0 -177
- package/dist/cli-bundle/focused-chunks/chunk-QTVCLMSZ.js +0 -6
- package/dist/cli-bundle/focused-chunks/chunk-QTZRBUYA.js +0 -8
- package/dist/cli-bundle/focused-chunks/chunk-SGQST3PQ.js +0 -12
- package/dist/cli-bundle/focused-chunks/chunk-UKHASMMP.js +0 -10
- package/dist/cli-bundle/focused-chunks/chunk-ZPEKQHOC.js +0 -2
|
@@ -1,82 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
* @module core/search/vectorization-metadata
|
|
3
|
-
*
|
|
4
|
-
* Powers search, embeddings, and semantic retrieval behavior for Vectorization Metadata.
|
|
5
|
-
*/
|
|
6
|
-
|
|
7
|
-
!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="4b3ad5fc-0f86-5f20-a23b-19d447cb0973")}catch(e){}}();
|
|
8
|
-
import { toNonEmptyString } from "../shared/primitives.js";
|
|
9
|
-
/** Implements build vectorization embedding identity for the public runtime surface of this module. */
|
|
10
|
-
export function buildVectorizationEmbeddingIdentity(provider, model) {
|
|
11
|
-
const normalizedProvider = toNonEmptyString(provider);
|
|
12
|
-
const normalizedModel = toNonEmptyString(model);
|
|
13
|
-
if (!normalizedProvider || !normalizedModel) {
|
|
14
|
-
return null;
|
|
15
|
-
}
|
|
16
|
-
return {
|
|
17
|
-
provider: normalizedProvider,
|
|
18
|
-
model: normalizedModel,
|
|
19
|
-
};
|
|
20
|
-
}
|
|
21
|
-
/** Implements normalize vectorization embedding metadata for the public runtime surface of this module. */
|
|
22
|
-
export function normalizeVectorizationEmbeddingMetadata(value) {
|
|
23
|
-
if (value === undefined || value === null) {
|
|
24
|
-
return null;
|
|
25
|
-
}
|
|
26
|
-
if (typeof value !== "object" || Array.isArray(value)) {
|
|
27
|
-
throw new Error("Vectorization embedding metadata must be an object when set");
|
|
28
|
-
}
|
|
29
|
-
const identity = buildVectorizationEmbeddingIdentity(value.provider, value.model);
|
|
30
|
-
const vectorDimension = value
|
|
31
|
-
.vector_dimension;
|
|
32
|
-
if (!identity ||
|
|
33
|
-
typeof vectorDimension !== "number" ||
|
|
34
|
-
!Number.isInteger(vectorDimension) ||
|
|
35
|
-
vectorDimension <= 0) {
|
|
36
|
-
throw new Error("Vectorization embedding metadata must include provider, model, and positive vector_dimension");
|
|
37
|
-
}
|
|
38
|
-
return {
|
|
39
|
-
...identity,
|
|
40
|
-
vector_dimension: vectorDimension,
|
|
41
|
-
};
|
|
42
|
-
}
|
|
43
|
-
/** Implements build vectorization embedding metadata for the public runtime surface of this module. */
|
|
44
|
-
export function buildVectorizationEmbeddingMetadata(identity, vectorDimension) {
|
|
45
|
-
if (!Number.isInteger(vectorDimension) || vectorDimension <= 0) {
|
|
46
|
-
throw new Error("Vectorization embedding metadata requires a positive vector dimension");
|
|
47
|
-
}
|
|
48
|
-
return {
|
|
49
|
-
provider: identity.provider,
|
|
50
|
-
model: identity.model,
|
|
51
|
-
vector_dimension: vectorDimension,
|
|
52
|
-
};
|
|
53
|
-
}
|
|
54
|
-
/** Implements check whether vectorization embedding identity changed for the public runtime surface of this module. */
|
|
55
|
-
export function hasVectorizationEmbeddingIdentityChanged(metadata, identity) {
|
|
56
|
-
return (!metadata ||
|
|
57
|
-
metadata.provider !== identity.provider ||
|
|
58
|
-
metadata.model !== identity.model);
|
|
59
|
-
}
|
|
60
|
-
/** Implements check whether vectorization vector dimension changed for the public runtime surface of this module. */
|
|
61
|
-
export function hasVectorizationVectorDimensionChanged(metadata, vectorDimension) {
|
|
62
|
-
return Boolean(metadata && metadata.vector_dimension !== vectorDimension);
|
|
63
|
-
}
|
|
64
|
-
/** Implements infer consistent vector dimension for the public runtime surface of this module. */
|
|
65
|
-
export function inferConsistentVectorDimension(vectors, context) {
|
|
66
|
-
if (vectors.length === 0) {
|
|
67
|
-
throw new Error(`${context} returned no vectors`);
|
|
68
|
-
}
|
|
69
|
-
const firstVector = vectors[0];
|
|
70
|
-
const dimension = firstVector.length;
|
|
71
|
-
if (!Number.isInteger(dimension) || dimension <= 0) {
|
|
72
|
-
throw new Error(`${context} returned an empty vector`);
|
|
73
|
-
}
|
|
74
|
-
for (let index = 1; index < vectors.length; index += 1) {
|
|
75
|
-
if (vectors[index]?.length !== dimension) {
|
|
76
|
-
throw new Error(`${context} returned mixed vector dimensions`);
|
|
77
|
-
}
|
|
78
|
-
}
|
|
79
|
-
return dimension;
|
|
80
|
-
}
|
|
1
|
+
!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="f4a214b6-02f4-5fc4-bfcd-90c0ca940842")}catch(e2){}})();import{toNonEmptyString}from"../shared/primitives.js";function buildVectorizationEmbeddingIdentity(provider,model){const normalizedProvider=toNonEmptyString(provider);const normalizedModel=toNonEmptyString(model);if(!normalizedProvider||!normalizedModel){return null}return{provider:normalizedProvider,model:normalizedModel}}function normalizeVectorizationEmbeddingMetadata(value){if(value===void 0||value===null){return null}if(typeof value!=="object"||Array.isArray(value)){throw new Error("Vectorization embedding metadata must be an object when set")}const identity=buildVectorizationEmbeddingIdentity(value.provider,value.model);const vectorDimension=value.vector_dimension;if(!identity||typeof vectorDimension!=="number"||!Number.isInteger(vectorDimension)||vectorDimension<=0){throw new Error("Vectorization embedding metadata must include provider, model, and positive vector_dimension")}return{...identity,vector_dimension:vectorDimension}}function buildVectorizationEmbeddingMetadata(identity,vectorDimension){if(!Number.isInteger(vectorDimension)||vectorDimension<=0){throw new Error("Vectorization embedding metadata requires a positive vector dimension")}return{provider:identity.provider,model:identity.model,vector_dimension:vectorDimension}}function hasVectorizationEmbeddingIdentityChanged(metadata,identity){return!metadata||metadata.provider!==identity.provider||metadata.model!==identity.model}function hasVectorizationVectorDimensionChanged(metadata,vectorDimension){return Boolean(metadata&&metadata.vector_dimension!==vectorDimension)}function inferConsistentVectorDimension(vectors,context){if(vectors.length===0){throw new Error(`${context} returned no vectors`)}const firstVector=vectors[0];const dimension=firstVector.length;if(!Number.isInteger(dimension)||dimension<=0){throw new Error(`${context} returned an empty vector`)}for(let index=1;index<vectors.length;index+=1){if(vectors[index]?.length!==dimension){throw new Error(`${context} returned mixed vector dimensions`)}}return dimension}export{buildVectorizationEmbeddingIdentity,buildVectorizationEmbeddingMetadata,hasVectorizationEmbeddingIdentityChanged,hasVectorizationVectorDimensionChanged,inferConsistentVectorDimension,normalizeVectorizationEmbeddingMetadata};
|
|
81
2
|
//# sourceMappingURL=vectorization-metadata.js.map
|
|
82
|
-
//# debugId=4b3ad5fc-0f86-5f20-a23b-19d447cb0973
|
|
@@ -1,273 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
* @module core/sentry/helpers
|
|
3
|
-
*
|
|
4
|
-
* Integrates Sentry instrumentation and release diagnostics for Helpers.
|
|
5
|
-
*/
|
|
6
|
-
|
|
7
|
-
!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5e6ba316-b067-51df-abeb-c3e3488a504d")}catch(e){}}();
|
|
8
|
-
import { getSentry } from "./instrument.js";
|
|
9
|
-
import { PmCliError } from "../shared/errors.js";
|
|
10
|
-
import { EXIT_CODE } from "../shared/constants.js";
|
|
11
|
-
import { deriveTelemetryCommandResolution, deriveTelemetryCommandTaxonomy, } from "../telemetry/observability.js";
|
|
12
|
-
let activeCommandSpan;
|
|
13
|
-
function setSpanAttribute(span, key, value) {
|
|
14
|
-
if (value === undefined) {
|
|
15
|
-
return;
|
|
16
|
-
}
|
|
17
|
-
const attributeTarget = span;
|
|
18
|
-
if (typeof attributeTarget.setAttribute === "function") {
|
|
19
|
-
attributeTarget.setAttribute(key, value);
|
|
20
|
-
}
|
|
21
|
-
}
|
|
22
|
-
function setSentryTagIfPresent(Sentry, key, value) {
|
|
23
|
-
if (typeof value === "string" && value.trim().length > 0) {
|
|
24
|
-
Sentry.setTag(key, value);
|
|
25
|
-
}
|
|
26
|
-
}
|
|
27
|
-
function setSentryCommandFinishTags(Sentry, normalizedOk, metadata) {
|
|
28
|
-
Sentry.setTag("pm.ok", normalizedOk);
|
|
29
|
-
Sentry.setTag("pm.command_ok", normalizedOk);
|
|
30
|
-
if (typeof metadata?.exit_code === "number") {
|
|
31
|
-
Sentry.setTag("pm.exit_code", String(metadata.exit_code));
|
|
32
|
-
Sentry.setTag("pm.command_exit_code", String(metadata.exit_code));
|
|
33
|
-
}
|
|
34
|
-
setSentryTagIfPresent(Sentry, "pm.error_code", metadata?.error_code);
|
|
35
|
-
setSentryTagIfPresent(Sentry, "pm.error_category", metadata?.error_category);
|
|
36
|
-
setSentryTagIfPresent(Sentry, "pm.command_resolution", metadata?.command_resolution);
|
|
37
|
-
setSentryTagIfPresent(Sentry, "pm.resolution_stage", metadata?.resolution_stage);
|
|
38
|
-
}
|
|
39
|
-
function setCommandSpanFinishAttributes(span, normalizedOk, normalizedExitCode, metadata) {
|
|
40
|
-
setSpanAttribute(span, "pm.ok", normalizedOk);
|
|
41
|
-
setSpanAttribute(span, "pm.command_ok", normalizedOk);
|
|
42
|
-
setSpanAttribute(span, "pm.exit_code", normalizedExitCode);
|
|
43
|
-
setSpanAttribute(span, "pm.command_exit_code", normalizedExitCode);
|
|
44
|
-
setSpanAttribute(span, "pm.error_code", metadata?.error_code);
|
|
45
|
-
setSpanAttribute(span, "pm.error_category", metadata?.error_category);
|
|
46
|
-
setSpanAttribute(span, "pm.command_resolution", metadata?.command_resolution);
|
|
47
|
-
setSpanAttribute(span, "pm.resolution_stage", metadata?.resolution_stage);
|
|
48
|
-
}
|
|
49
|
-
/** Implements sentry set command context for the public runtime surface of this module. */
|
|
50
|
-
export function sentrySetCommandContext(command, args, options, metadata) {
|
|
51
|
-
const Sentry = getSentry();
|
|
52
|
-
if (!Sentry)
|
|
53
|
-
return;
|
|
54
|
-
const taxonomy = deriveTelemetryCommandTaxonomy(command);
|
|
55
|
-
Sentry.setTag("pm.command", command);
|
|
56
|
-
Sentry.setTag("pm.command_root", taxonomy.command_root);
|
|
57
|
-
Sentry.setTag("pm.command_family", taxonomy.command_family);
|
|
58
|
-
if (typeof metadata?.source_context === "string" &&
|
|
59
|
-
metadata.source_context.trim().length > 0) {
|
|
60
|
-
Sentry.setTag("pm.source_context", metadata.source_context);
|
|
61
|
-
}
|
|
62
|
-
const safeArgs = args.map((arg) => arg.startsWith("--") ? arg.split("=")[0] : arg);
|
|
63
|
-
Sentry.setContext("pm.command", {
|
|
64
|
-
name: command,
|
|
65
|
-
root: taxonomy.command_root,
|
|
66
|
-
leaf: taxonomy.command_leaf,
|
|
67
|
-
family: taxonomy.command_family,
|
|
68
|
-
args: safeArgs,
|
|
69
|
-
option_keys: Object.keys(options).sort(),
|
|
70
|
-
source_context: metadata?.source_context,
|
|
71
|
-
source_context_source: metadata?.source_context_source,
|
|
72
|
-
});
|
|
73
|
-
Sentry.addBreadcrumb({
|
|
74
|
-
category: "pm.command",
|
|
75
|
-
message: `pm ${command}`,
|
|
76
|
-
level: "info",
|
|
77
|
-
data: {
|
|
78
|
-
args: safeArgs,
|
|
79
|
-
command_root: taxonomy.command_root,
|
|
80
|
-
command_family: taxonomy.command_family,
|
|
81
|
-
source_context: metadata?.source_context,
|
|
82
|
-
},
|
|
83
|
-
});
|
|
84
|
-
}
|
|
85
|
-
/** Implements sentry start command span for the public runtime surface of this module. */
|
|
86
|
-
export function sentryStartCommandSpan(command) {
|
|
87
|
-
const Sentry = getSentry();
|
|
88
|
-
if (!Sentry)
|
|
89
|
-
return;
|
|
90
|
-
activeCommandSpan = Sentry.startInactiveSpan({
|
|
91
|
-
op: "pm.command",
|
|
92
|
-
name: `pm ${command}`,
|
|
93
|
-
forceTransaction: true,
|
|
94
|
-
});
|
|
95
|
-
}
|
|
96
|
-
/** Implements sentry finish command span for the public runtime surface of this module. */
|
|
97
|
-
export function sentryFinishCommandSpan(ok, error, metadata) {
|
|
98
|
-
if (!activeCommandSpan)
|
|
99
|
-
return;
|
|
100
|
-
const normalizedOk = ok ? "true" : "false";
|
|
101
|
-
const normalizedExitCode = typeof metadata?.exit_code === "number"
|
|
102
|
-
? String(metadata.exit_code)
|
|
103
|
-
: undefined;
|
|
104
|
-
const Sentry = getSentry();
|
|
105
|
-
if (Sentry) {
|
|
106
|
-
setSentryCommandFinishTags(Sentry, normalizedOk, metadata);
|
|
107
|
-
}
|
|
108
|
-
setCommandSpanFinishAttributes(activeCommandSpan, normalizedOk, normalizedExitCode, metadata);
|
|
109
|
-
activeCommandSpan.setStatus(ok ? { code: 1 } : { code: 2, message: error ?? "command_failed" });
|
|
110
|
-
activeCommandSpan.end();
|
|
111
|
-
activeCommandSpan = undefined;
|
|
112
|
-
}
|
|
113
|
-
/**
|
|
114
|
-
* Tag value recorded when a captured error declares no canonical pm error code.
|
|
115
|
-
*
|
|
116
|
-
* The release reliability gate classifies Sentry issues from the `pm.error_code`
|
|
117
|
-
* and `pm.exit_code` tags and fails closed when either is absent. Emitting this
|
|
118
|
-
* sentinel keeps the producer side of that contract total: an undeclared runtime
|
|
119
|
-
* fault is still classifiable (and still blocks, because it resolves to no
|
|
120
|
-
* catalog contract) instead of being unjudgeable for lack of a tag.
|
|
121
|
-
*/
|
|
122
|
-
export const UNCLASSIFIED_CAPTURED_ERROR_CODE = "unclassified_runtime_error";
|
|
123
|
-
/**
|
|
124
|
-
* Reads the declared error contract carried by a thrown value, if any.
|
|
125
|
-
*
|
|
126
|
-
* There is deliberately no `PmCliError` special case: `shouldCaptureCliError`
|
|
127
|
-
* rejects every `PmCliError` before capture, so such a branch would be
|
|
128
|
-
* unreachable — and a `PmCliError` carries a public `code` and a numeric
|
|
129
|
-
* `exitCode`, so the general path below would classify it identically anyway.
|
|
130
|
-
*/
|
|
131
|
-
function readCapturedErrorContract(error) {
|
|
132
|
-
const candidate = typeof error === "object" && error !== null
|
|
133
|
-
? error
|
|
134
|
-
: undefined;
|
|
135
|
-
const hasDeclaredExitCode = typeof candidate?.exitCode === "number";
|
|
136
|
-
const exitCode = hasDeclaredExitCode
|
|
137
|
-
? Math.trunc(candidate?.exitCode)
|
|
138
|
-
: EXIT_CODE.GENERIC_FAILURE;
|
|
139
|
-
// A declared pm code always travels with a numeric exit code. Requiring both
|
|
140
|
-
// halves keeps a Node errno error (string `code`, no `exitCode`) from being
|
|
141
|
-
// reported as though it were a catalog contract.
|
|
142
|
-
const hasDeclaredErrorCode = typeof candidate?.code === "string" &&
|
|
143
|
-
candidate.code.length > 0 &&
|
|
144
|
-
hasDeclaredExitCode;
|
|
145
|
-
return {
|
|
146
|
-
error_code: hasDeclaredErrorCode
|
|
147
|
-
? candidate?.code
|
|
148
|
-
: UNCLASSIFIED_CAPTURED_ERROR_CODE,
|
|
149
|
-
exit_code: exitCode,
|
|
150
|
-
};
|
|
151
|
-
}
|
|
152
|
-
/**
|
|
153
|
-
* Builds the contract tags every captured event carries.
|
|
154
|
-
*
|
|
155
|
-
* These are attached to the event itself rather than to the ambient scope
|
|
156
|
-
* because the scope writer (`sentryFinishCommandSpan`) returns early when no
|
|
157
|
-
* command span is active, and the unknown-error path captures before that
|
|
158
|
-
* writer runs.
|
|
159
|
-
*/
|
|
160
|
-
function buildCapturedErrorTags(error) {
|
|
161
|
-
const contract = readCapturedErrorContract(error);
|
|
162
|
-
return {
|
|
163
|
-
"pm.error_code": contract.error_code,
|
|
164
|
-
"pm.exit_code": String(contract.exit_code),
|
|
165
|
-
};
|
|
166
|
-
}
|
|
167
|
-
/** Implements sentry capture cli error for the public runtime surface of this module. */
|
|
168
|
-
export function sentryCaptureCliError(error) {
|
|
169
|
-
if (!shouldCaptureCliError(error))
|
|
170
|
-
return;
|
|
171
|
-
const Sentry = getSentry();
|
|
172
|
-
if (!Sentry)
|
|
173
|
-
return;
|
|
174
|
-
const tags = buildCapturedErrorTags(error);
|
|
175
|
-
if (error instanceof Error) {
|
|
176
|
-
const extras = {};
|
|
177
|
-
if ("exitCode" in error &&
|
|
178
|
-
typeof error.exitCode === "number") {
|
|
179
|
-
extras.exit_code = error.exitCode;
|
|
180
|
-
}
|
|
181
|
-
if ("context" in error &&
|
|
182
|
-
typeof error.context === "object") {
|
|
183
|
-
extras.error_context = error.context;
|
|
184
|
-
}
|
|
185
|
-
Sentry.captureException(error, { extra: extras, tags });
|
|
186
|
-
}
|
|
187
|
-
else {
|
|
188
|
-
Sentry.captureException(new Error(String(error)), { tags });
|
|
189
|
-
}
|
|
190
|
-
}
|
|
191
|
-
/** Implements sentry log cli usage error for the public runtime surface of this module. */
|
|
192
|
-
export function sentryLogCliUsageError(params) {
|
|
193
|
-
const Sentry = getSentry();
|
|
194
|
-
if (!Sentry)
|
|
195
|
-
return;
|
|
196
|
-
const resolvedCommandResolution = params.command_resolution ??
|
|
197
|
-
deriveTelemetryCommandResolution({
|
|
198
|
-
ok: false,
|
|
199
|
-
errorCode: params.error_code,
|
|
200
|
-
errorCategory: params.error_category,
|
|
201
|
-
});
|
|
202
|
-
const resolvedResolutionStage = params.resolution_stage ?? "unknown";
|
|
203
|
-
const payload = {
|
|
204
|
-
"pm.command": params.command,
|
|
205
|
-
"pm.error_code": params.error_code,
|
|
206
|
-
"pm.error_category": params.error_category,
|
|
207
|
-
"pm.exit_code": params.exit_code,
|
|
208
|
-
"pm.error_message": params.error_message,
|
|
209
|
-
"pm.command_resolution": resolvedCommandResolution,
|
|
210
|
-
"pm.resolution_stage": resolvedResolutionStage,
|
|
211
|
-
"pm.source_context": params.source_context ?? "",
|
|
212
|
-
};
|
|
213
|
-
const loggerCandidate = Sentry.logger;
|
|
214
|
-
if (loggerCandidate && typeof loggerCandidate.warn === "function") {
|
|
215
|
-
loggerCandidate.warn("pm_cli_usage_error", payload);
|
|
216
|
-
return;
|
|
217
|
-
}
|
|
218
|
-
Sentry.captureMessage(`pm_cli_usage_error:${params.error_code}`, {
|
|
219
|
-
level: "warning",
|
|
220
|
-
tags: {
|
|
221
|
-
"pm.command": params.command,
|
|
222
|
-
"pm.error_code": params.error_code,
|
|
223
|
-
"pm.error_category": params.error_category,
|
|
224
|
-
"pm.exit_code": String(params.exit_code),
|
|
225
|
-
"pm.command_resolution": resolvedCommandResolution,
|
|
226
|
-
"pm.resolution_stage": resolvedResolutionStage,
|
|
227
|
-
"pm.source_context": params.source_context ?? "unknown",
|
|
228
|
-
},
|
|
229
|
-
extra: payload,
|
|
230
|
-
});
|
|
231
|
-
}
|
|
232
|
-
/** Implements should capture cli error for the public runtime surface of this module. */
|
|
233
|
-
export function shouldCaptureCliError(error) {
|
|
234
|
-
if (error instanceof PmCliError) {
|
|
235
|
-
return false;
|
|
236
|
-
}
|
|
237
|
-
if (error instanceof Error &&
|
|
238
|
-
error.name === "AbortError" &&
|
|
239
|
-
/(?:ctrl\+[cd]|sigint|user[- ]initiated)/i.test(error.message)) {
|
|
240
|
-
return false;
|
|
241
|
-
}
|
|
242
|
-
if (typeof error === "object" &&
|
|
243
|
-
error !== null &&
|
|
244
|
-
"exitCode" in error &&
|
|
245
|
-
typeof error.exitCode === "number") {
|
|
246
|
-
if (error instanceof Error && error.name === "CommandError") {
|
|
247
|
-
return false;
|
|
248
|
-
}
|
|
249
|
-
const exitCode = Math.trunc(error.exitCode);
|
|
250
|
-
const expectedExitCodes = new Set([
|
|
251
|
-
EXIT_CODE.SUCCESS,
|
|
252
|
-
EXIT_CODE.USAGE,
|
|
253
|
-
EXIT_CODE.NOT_FOUND,
|
|
254
|
-
EXIT_CODE.CONFLICT,
|
|
255
|
-
]);
|
|
256
|
-
return !expectedExitCodes.has(exitCode);
|
|
257
|
-
}
|
|
258
|
-
return true;
|
|
259
|
-
}
|
|
260
|
-
/** Implements sentry flush for the public runtime surface of this module. */
|
|
261
|
-
export async function sentryFlush(timeoutMs = 3000) {
|
|
262
|
-
const Sentry = getSentry();
|
|
263
|
-
if (!Sentry)
|
|
264
|
-
return;
|
|
265
|
-
try {
|
|
266
|
-
await Sentry.flush(timeoutMs);
|
|
267
|
-
}
|
|
268
|
-
catch {
|
|
269
|
-
// Sentry flush must never block CLI exit.
|
|
270
|
-
}
|
|
271
|
-
}
|
|
1
|
+
!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="199c4791-6ca7-50c4-b2cd-aa96c0ab2408")}catch(e2){}})();import{getSentry}from"./instrument.js";import{PmCliError}from"../shared/errors.js";import{EXIT_CODE}from"../shared/constants.js";import{deriveTelemetryCommandResolution,deriveTelemetryCommandTaxonomy}from"../telemetry/observability.js";let activeCommandSpan;function setSpanAttribute(span,key,value){if(value===void 0){return}const attributeTarget=span;if(typeof attributeTarget.setAttribute==="function"){attributeTarget.setAttribute(key,value)}}function setSentryTagIfPresent(Sentry,key,value){if(typeof value==="string"&&value.trim().length>0){Sentry.setTag(key,value)}}function setSentryCommandFinishTags(Sentry,normalizedOk,metadata){Sentry.setTag("pm.ok",normalizedOk);Sentry.setTag("pm.command_ok",normalizedOk);if(typeof metadata?.exit_code==="number"){Sentry.setTag("pm.exit_code",String(metadata.exit_code));Sentry.setTag("pm.command_exit_code",String(metadata.exit_code))}setSentryTagIfPresent(Sentry,"pm.error_code",metadata?.error_code);setSentryTagIfPresent(Sentry,"pm.error_category",metadata?.error_category);setSentryTagIfPresent(Sentry,"pm.command_resolution",metadata?.command_resolution);setSentryTagIfPresent(Sentry,"pm.resolution_stage",metadata?.resolution_stage)}function setCommandSpanFinishAttributes(span,normalizedOk,normalizedExitCode,metadata){setSpanAttribute(span,"pm.ok",normalizedOk);setSpanAttribute(span,"pm.command_ok",normalizedOk);setSpanAttribute(span,"pm.exit_code",normalizedExitCode);setSpanAttribute(span,"pm.command_exit_code",normalizedExitCode);setSpanAttribute(span,"pm.error_code",metadata?.error_code);setSpanAttribute(span,"pm.error_category",metadata?.error_category);setSpanAttribute(span,"pm.command_resolution",metadata?.command_resolution);setSpanAttribute(span,"pm.resolution_stage",metadata?.resolution_stage)}function sentrySetCommandContext(command,args,options,metadata){const Sentry=getSentry();if(!Sentry)return;const taxonomy=deriveTelemetryCommandTaxonomy(command);Sentry.setTag("pm.command",command);Sentry.setTag("pm.command_root",taxonomy.command_root);Sentry.setTag("pm.command_family",taxonomy.command_family);if(typeof metadata?.source_context==="string"&&metadata.source_context.trim().length>0){Sentry.setTag("pm.source_context",metadata.source_context)}const safeArgs=args.map(arg=>arg.startsWith("--")?arg.split("=")[0]:arg);Sentry.setContext("pm.command",{name:command,root:taxonomy.command_root,leaf:taxonomy.command_leaf,family:taxonomy.command_family,args:safeArgs,option_keys:Object.keys(options).sort(),source_context:metadata?.source_context,source_context_source:metadata?.source_context_source});Sentry.addBreadcrumb({category:"pm.command",message:`pm ${command}`,level:"info",data:{args:safeArgs,command_root:taxonomy.command_root,command_family:taxonomy.command_family,source_context:metadata?.source_context}})}function sentryStartCommandSpan(command){const Sentry=getSentry();if(!Sentry)return;activeCommandSpan=Sentry.startInactiveSpan({op:"pm.command",name:`pm ${command}`,forceTransaction:true})}function sentryFinishCommandSpan(ok,error,metadata){if(!activeCommandSpan)return;const normalizedOk=ok?"true":"false";const normalizedExitCode=typeof metadata?.exit_code==="number"?String(metadata.exit_code):void 0;const Sentry=getSentry();if(Sentry){setSentryCommandFinishTags(Sentry,normalizedOk,metadata)}setCommandSpanFinishAttributes(activeCommandSpan,normalizedOk,normalizedExitCode,metadata);activeCommandSpan.setStatus(ok?{code:1}:{code:2,message:error??"command_failed"});activeCommandSpan.end();activeCommandSpan=void 0}const UNCLASSIFIED_CAPTURED_ERROR_CODE="unclassified_runtime_error";function readCapturedErrorContract(error){const candidate=typeof error==="object"&&error!==null?error:void 0;const hasDeclaredExitCode=typeof candidate?.exitCode==="number";const exitCode=hasDeclaredExitCode?Math.trunc(candidate?.exitCode):EXIT_CODE.GENERIC_FAILURE;const hasDeclaredErrorCode=typeof candidate?.code==="string"&&candidate.code.length>0&&hasDeclaredExitCode;return{error_code:hasDeclaredErrorCode?candidate?.code:UNCLASSIFIED_CAPTURED_ERROR_CODE,exit_code:exitCode}}function buildCapturedErrorTags(error){const contract=readCapturedErrorContract(error);return{"pm.error_code":contract.error_code,"pm.exit_code":String(contract.exit_code)}}function sentryCaptureCliError(error){if(!shouldCaptureCliError(error))return;const Sentry=getSentry();if(!Sentry)return;const tags=buildCapturedErrorTags(error);if(error instanceof Error){const extras={};if("exitCode"in error&&typeof error.exitCode==="number"){extras.exit_code=error.exitCode}if("context"in error&&typeof error.context==="object"){extras.error_context=error.context}Sentry.captureException(error,{extra:extras,tags})}else{Sentry.captureException(new Error(String(error)),{tags})}}function sentryLogCliUsageError(params){const Sentry=getSentry();if(!Sentry)return;const resolvedCommandResolution=params.command_resolution??deriveTelemetryCommandResolution({ok:false,errorCode:params.error_code,errorCategory:params.error_category});const resolvedResolutionStage=params.resolution_stage??"unknown";const payload={"pm.command":params.command,"pm.error_code":params.error_code,"pm.error_category":params.error_category,"pm.exit_code":params.exit_code,"pm.error_message":params.error_message,"pm.command_resolution":resolvedCommandResolution,"pm.resolution_stage":resolvedResolutionStage,"pm.source_context":params.source_context??""};const loggerCandidate=Sentry.logger;if(loggerCandidate&&typeof loggerCandidate.warn==="function"){loggerCandidate.warn("pm_cli_usage_error",payload);return}Sentry.captureMessage(`pm_cli_usage_error:${params.error_code}`,{level:"warning",tags:{"pm.command":params.command,"pm.error_code":params.error_code,"pm.error_category":params.error_category,"pm.exit_code":String(params.exit_code),"pm.command_resolution":resolvedCommandResolution,"pm.resolution_stage":resolvedResolutionStage,"pm.source_context":params.source_context??"unknown"},extra:payload})}function shouldCaptureCliError(error){if(error instanceof PmCliError){return false}if(error instanceof Error&&error.name==="AbortError"&&/(?:ctrl\+[cd]|sigint|user[- ]initiated)/i.test(error.message)){return false}if(typeof error==="object"&&error!==null&&"exitCode"in error&&typeof error.exitCode==="number"){if(error instanceof Error&&error.name==="CommandError"){return false}const exitCode=Math.trunc(error.exitCode);const expectedExitCodes=new Set([EXIT_CODE.SUCCESS,EXIT_CODE.USAGE,EXIT_CODE.NOT_FOUND,EXIT_CODE.CONFLICT]);return!expectedExitCodes.has(exitCode)}return true}async function sentryFlush(timeoutMs=3e3){const Sentry=getSentry();if(!Sentry)return;try{await Sentry.flush(timeoutMs)}catch{}}export{UNCLASSIFIED_CAPTURED_ERROR_CODE,sentryCaptureCliError,sentryFinishCommandSpan,sentryFlush,sentryLogCliUsageError,sentrySetCommandContext,sentryStartCommandSpan,shouldCaptureCliError};
|
|
272
2
|
//# sourceMappingURL=helpers.js.map
|
|
273
|
-
//# debugId=5e6ba316-b067-51df-abeb-c3e3488a504d
|