@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,991 +1,8 @@
|
|
|
1
|
-
/**
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
import { Option } from "commander";
|
|
9
|
-
import { pathExists, refreshSearchArtifactsForMutation, shouldRunSearchRefreshInForeground, EXIT_CODE, PmCliError, printError, printResult, writeStdout, getSettingsPath, resolvePmRoot, readSettings, runActiveServiceOverride, setActiveCommandResult, } from "../runtime-primitives.js";
|
|
10
|
-
import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, NEXT_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, readFirstValueFromCommanderOptions, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "../cli-contracts.js";
|
|
11
|
-
export { setActiveCommandResult };
|
|
12
|
-
export { printError, printResult, writeStdout };
|
|
13
|
-
/** Let an active package asynchronously augment a completed command result. */
|
|
14
|
-
export async function applyActiveCommandResultService(command, args, options, global, result) {
|
|
15
|
-
const pmRoot = resolvePmRoot(process.cwd(), global.path);
|
|
16
|
-
const override = await runActiveServiceOverride("command_result", {
|
|
17
|
-
command,
|
|
18
|
-
args,
|
|
19
|
-
options,
|
|
20
|
-
global,
|
|
21
|
-
pm_root: pmRoot,
|
|
22
|
-
result,
|
|
23
|
-
});
|
|
24
|
-
return override.handled ? override.result : result;
|
|
25
|
-
}
|
|
26
|
-
/** Synchronize parser-derived options with Commander and its action arguments. */
|
|
27
|
-
export function syncCommanderActionOptions(actionCommand, commandOptions) {
|
|
28
|
-
for (const [key, value] of Object.entries(commandOptions)) {
|
|
29
|
-
actionCommand.setOptionValueWithSource(key, value, "cli");
|
|
30
|
-
}
|
|
31
|
-
}
|
|
32
|
-
function readJoinedRepeatedOption(options, contract) {
|
|
33
|
-
const values = [];
|
|
34
|
-
const observedArrays = new Set();
|
|
35
|
-
for (const key of contract.keys) {
|
|
36
|
-
if (!Object.hasOwn(options, key)) {
|
|
37
|
-
continue;
|
|
38
|
-
}
|
|
39
|
-
const value = options[key];
|
|
40
|
-
if (value == null) {
|
|
41
|
-
continue;
|
|
42
|
-
}
|
|
43
|
-
if (typeof value === "string") {
|
|
44
|
-
values.push(value);
|
|
45
|
-
continue;
|
|
46
|
-
}
|
|
47
|
-
if (!Array.isArray(value) ||
|
|
48
|
-
!value.every((entry) => typeof entry === "string")) {
|
|
49
|
-
return undefined;
|
|
50
|
-
}
|
|
51
|
-
if (observedArrays.has(value)) {
|
|
52
|
-
continue;
|
|
53
|
-
}
|
|
54
|
-
observedArrays.add(value);
|
|
55
|
-
values.push(...value);
|
|
56
|
-
}
|
|
57
|
-
return values.length > 0 ? values.join("; ") : undefined;
|
|
58
|
-
}
|
|
59
|
-
const RESOLVED_GLOBAL_OPTIONS = Symbol("pm.resolvedGlobalOptions");
|
|
60
|
-
function commandOptionsReader(command) {
|
|
61
|
-
return typeof command === "object" && command !== null
|
|
62
|
-
? command
|
|
63
|
-
: {};
|
|
64
|
-
}
|
|
65
|
-
// Resolves the alias contract for a normalize target, falling back to a
|
|
66
|
-
// single-key contract if the target is somehow absent from the contract table.
|
|
67
|
-
function resolveCommanderContract(contracts, target) {
|
|
68
|
-
const contract = contracts.find((entry) => entry.target === target);
|
|
69
|
-
/* c8 ignore start -- every normalize target is present in its contract table (verified by contract drift tests); the fallback is a defensive guard against future drift */
|
|
70
|
-
return contract ?? { target, keys: [target] };
|
|
71
|
-
/* c8 ignore stop */
|
|
72
|
-
}
|
|
73
|
-
/** Implements set resolved global options for the public runtime surface of this module. */
|
|
74
|
-
export function setResolvedGlobalOptions(command, globalOptions) {
|
|
75
|
-
command[RESOLVED_GLOBAL_OPTIONS] = {
|
|
76
|
-
...globalOptions,
|
|
77
|
-
};
|
|
78
|
-
}
|
|
79
|
-
/** Implements clear resolved global options for the public runtime surface of this module. */
|
|
80
|
-
export function clearResolvedGlobalOptions(command) {
|
|
81
|
-
delete command[RESOLVED_GLOBAL_OPTIONS];
|
|
82
|
-
}
|
|
83
|
-
/** Read one string-valued Commander option without coercion. */
|
|
84
|
-
function readStringCommandOption(options, key) {
|
|
85
|
-
return typeof options[key] === "string" ? options[key] : undefined;
|
|
86
|
-
}
|
|
87
|
-
/** Implements get global options for the public runtime surface of this module. */
|
|
88
|
-
export function getGlobalOptions(command) {
|
|
89
|
-
const commandPath = getCommandPath(command);
|
|
90
|
-
const resolved = command[RESOLVED_GLOBAL_OPTIONS];
|
|
91
|
-
if (resolved) {
|
|
92
|
-
return {
|
|
93
|
-
...resolved,
|
|
94
|
-
...(commandPath.length > 0 ? { command: commandPath } : {}),
|
|
95
|
-
};
|
|
96
|
-
}
|
|
97
|
-
const reader = commandOptionsReader(command);
|
|
98
|
-
const opts = typeof reader.optsWithGlobals === "function"
|
|
99
|
-
? reader.optsWithGlobals()
|
|
100
|
-
: typeof reader.opts === "function"
|
|
101
|
-
? reader.opts()
|
|
102
|
-
: {};
|
|
103
|
-
const normalized = {
|
|
104
|
-
json: opts.json === true ? true : undefined,
|
|
105
|
-
quiet: Boolean(opts.quiet),
|
|
106
|
-
noChangedFields: opts.changedFields === false,
|
|
107
|
-
...(opts.fullChangedFields === true ? { fullChangedFields: true } : {}),
|
|
108
|
-
idOnly: opts.idOnly === true,
|
|
109
|
-
...(opts.lean === true ? { lean: true } : {}),
|
|
110
|
-
...(opts.tokenAccounting === true ? { tokenAccounting: true } : {}),
|
|
111
|
-
outputInclude: readStringCommandOption(opts, "outputInclude"),
|
|
112
|
-
outputLimit: readStringCommandOption(opts, "outputLimit"),
|
|
113
|
-
outputBudget: readStringCommandOption(opts, "outputBudget"),
|
|
114
|
-
outputSession: readStringCommandOption(opts, "outputSession"),
|
|
115
|
-
outputCursor: readStringCommandOption(opts, "outputCursor"),
|
|
116
|
-
...(opts.outputRowContract === true ? { outputRowContract: true } : {}),
|
|
117
|
-
...(opts.outputFormat === "toon" || opts.outputFormat === "json"
|
|
118
|
-
? { outputFormat: opts.outputFormat }
|
|
119
|
-
: {}),
|
|
120
|
-
path: readStringCommandOption(opts, "pmPath") ??
|
|
121
|
-
readStringCommandOption(opts, "path"),
|
|
122
|
-
noExtensions: opts.extensions === false,
|
|
123
|
-
noPager: Boolean(opts.noPager),
|
|
124
|
-
profile: Boolean(opts.profile),
|
|
125
|
-
...(commandPath.length > 0 ? { command: commandPath } : {}),
|
|
126
|
-
...(typeof opts.author === "string" ? { author: opts.author } : {}),
|
|
127
|
-
};
|
|
128
|
-
return normalized;
|
|
129
|
-
}
|
|
130
|
-
/** Implements get command path for the public runtime surface of this module. */
|
|
131
|
-
export function getCommandPath(command) {
|
|
132
|
-
const parts = [];
|
|
133
|
-
let current = command;
|
|
134
|
-
while (current?.parent) {
|
|
135
|
-
parts.unshift(current.name());
|
|
136
|
-
current = current.parent;
|
|
137
|
-
}
|
|
138
|
-
return parts.join(" ");
|
|
139
|
-
}
|
|
140
|
-
/** Implements apply default output format for the public runtime surface of this module. */
|
|
141
|
-
export async function applyDefaultOutputFormat(globalOptions) {
|
|
142
|
-
if (globalOptions.json === true) {
|
|
143
|
-
return globalOptions;
|
|
144
|
-
}
|
|
145
|
-
const pmRoot = resolvePmRoot(process.cwd(), globalOptions.path);
|
|
146
|
-
if (!(await pathExists(getSettingsPath(pmRoot)))) {
|
|
147
|
-
return globalOptions;
|
|
148
|
-
}
|
|
149
|
-
const settings = await readSettings(pmRoot);
|
|
150
|
-
return {
|
|
151
|
-
...globalOptions,
|
|
152
|
-
defaultOutputFormat: settings.output.default_format,
|
|
153
|
-
};
|
|
154
|
-
}
|
|
155
|
-
/** Implements collect for the public runtime surface of this module. */
|
|
156
|
-
export function collect(value, previous) {
|
|
157
|
-
const next = previous ?? [];
|
|
158
|
-
next.push(value);
|
|
159
|
-
return next;
|
|
160
|
-
}
|
|
161
|
-
function pushOptionalValueFlag(args, flag, value) {
|
|
162
|
-
if (typeof value !== "string") {
|
|
163
|
-
return;
|
|
164
|
-
}
|
|
165
|
-
const trimmed = value.trim();
|
|
166
|
-
if (trimmed.length === 0) {
|
|
167
|
-
return;
|
|
168
|
-
}
|
|
169
|
-
args.push(flag, trimmed);
|
|
170
|
-
}
|
|
171
|
-
function pushOptionalBooleanFlag(args, flag, value) {
|
|
172
|
-
if (value === true) {
|
|
173
|
-
args.push(flag);
|
|
174
|
-
}
|
|
175
|
-
}
|
|
176
|
-
function pushRepeatableValueFlag(args, flag, values) {
|
|
177
|
-
if (!Array.isArray(values)) {
|
|
178
|
-
return;
|
|
179
|
-
}
|
|
180
|
-
for (const value of values) {
|
|
181
|
-
if (typeof value !== "string") {
|
|
182
|
-
continue;
|
|
183
|
-
}
|
|
184
|
-
const trimmed = value.trim();
|
|
185
|
-
if (trimmed.length === 0) {
|
|
186
|
-
continue;
|
|
187
|
-
}
|
|
188
|
-
args.push(flag, trimmed);
|
|
189
|
-
}
|
|
190
|
-
}
|
|
191
|
-
function optionTrue(options, key) {
|
|
192
|
-
return options[key] === true ? true : undefined;
|
|
193
|
-
}
|
|
194
|
-
function optionFalse(options, key) {
|
|
195
|
-
return options[key] === false ? true : undefined;
|
|
196
|
-
}
|
|
197
|
-
/** Reads an option value when Commander supplied it as a string. */
|
|
198
|
-
export function readOptionString(options, key) {
|
|
199
|
-
return typeof options[key] === "string" ? options[key] : undefined;
|
|
200
|
-
}
|
|
201
|
-
/** Adds a Commander option that remains parseable but hidden from human help. */
|
|
202
|
-
export function addHiddenOption(command, flags, description, repeatable = false, repeatableParser = undefined) {
|
|
203
|
-
const option = new Option(flags, description).hideHelp();
|
|
204
|
-
if (repeatable) {
|
|
205
|
-
option.argParser(repeatableParser ?? collect);
|
|
206
|
-
}
|
|
207
|
-
command.addOption(option);
|
|
208
|
-
}
|
|
209
|
-
/** Adds a group of parseable Commander aliases hidden from human help. */
|
|
210
|
-
export function addHiddenOptions(command, aliases, repeatable) {
|
|
211
|
-
for (const [flags, description] of aliases) {
|
|
212
|
-
addHiddenOption(command, flags, description, repeatable);
|
|
213
|
-
}
|
|
214
|
-
}
|
|
215
|
-
function anyOptionTrue(options, keys) {
|
|
216
|
-
return keys.some((key) => options[key] === true) ? true : undefined;
|
|
217
|
-
}
|
|
218
|
-
function readStringOrFiniteNumberFromCommanderOptions(options, contract) {
|
|
219
|
-
const value = readFirstValueFromCommanderOptions(options, contract);
|
|
220
|
-
return typeof value === "string" ||
|
|
221
|
-
(typeof value === "number" && Number.isFinite(value))
|
|
222
|
-
? value
|
|
223
|
-
: undefined;
|
|
224
|
-
}
|
|
225
|
-
function copyUnknownOptions(target, source) {
|
|
226
|
-
for (const [key, value] of Object.entries(source)) {
|
|
227
|
-
if (key === "__proto__" || key === "constructor" || key === "prototype") {
|
|
228
|
-
continue;
|
|
229
|
-
}
|
|
230
|
-
if (Object.hasOwn(target, key)) {
|
|
231
|
-
continue;
|
|
232
|
-
}
|
|
233
|
-
target[key] = value;
|
|
234
|
-
}
|
|
235
|
-
}
|
|
236
|
-
/** Implements build background test command args for the public runtime surface of this module. */
|
|
237
|
-
export function buildBackgroundTestCommandArgs(id, options) {
|
|
238
|
-
const args = ["test", id, "--run", "--json", "--progress"];
|
|
239
|
-
pushRepeatableValueFlag(args, "--add", options.add);
|
|
240
|
-
pushRepeatableValueFlag(args, "--add-json", options.addJson);
|
|
241
|
-
pushRepeatableValueFlag(args, "--remove", options.remove);
|
|
242
|
-
pushRepeatableValueFlag(args, "--remove-index", options.removeIndex);
|
|
243
|
-
pushOptionalValueFlag(args, "--match", options.match);
|
|
244
|
-
pushOptionalValueFlag(args, "--only-index", options.onlyIndex);
|
|
245
|
-
pushOptionalBooleanFlag(args, "--only-last", options.onlyLast);
|
|
246
|
-
pushRepeatableValueFlag(args, "--measure", options.measure);
|
|
247
|
-
pushOptionalValueFlag(args, "--metric-below", options.metricBelow);
|
|
248
|
-
pushOptionalValueFlag(args, "--metric-diff", options.metricDiff);
|
|
249
|
-
pushSharedBackgroundTestCommandArgs(args, options);
|
|
250
|
-
pushOptionalValueFlag(args, "--author", options.author);
|
|
251
|
-
pushOptionalValueFlag(args, "--message", options.message);
|
|
252
|
-
pushOptionalBooleanFlag(args, "--force", options.force);
|
|
253
|
-
return args;
|
|
254
|
-
}
|
|
255
|
-
function pushSharedBackgroundTestCommandArgs(args, options) {
|
|
256
|
-
pushOptionalValueFlag(args, "--timeout", options.timeout);
|
|
257
|
-
pushRepeatableValueFlag(args, "--env-set", options.envSet);
|
|
258
|
-
pushRepeatableValueFlag(args, "--env-clear", options.envClear);
|
|
259
|
-
pushOptionalBooleanFlag(args, "--shared-host-safe", options.sharedHostSafe);
|
|
260
|
-
pushOptionalValueFlag(args, "--pm-context", options.pmContext);
|
|
261
|
-
pushOptionalBooleanFlag(args, "--override-linked-pm-context", options.overrideLinkedPmContext);
|
|
262
|
-
pushOptionalValueFlag(args, "--workspace-context", options.workspaceContext);
|
|
263
|
-
pushOptionalBooleanFlag(args, "--override-linked-workspace-context", options.overrideLinkedWorkspaceContext);
|
|
264
|
-
pushOptionalBooleanFlag(args, "--allow-untrusted-linked-tests", options.allowUntrustedLinkedTests);
|
|
265
|
-
pushOptionalBooleanFlag(args, "--fail-on-context-mismatch", options.failOnContextMismatch);
|
|
266
|
-
pushOptionalBooleanFlag(args, "--fail-on-skipped", options.failOnSkipped);
|
|
267
|
-
pushOptionalBooleanFlag(args, "--fail-on-empty-test-run", options.failOnEmptyTestRun);
|
|
268
|
-
pushOptionalBooleanFlag(args, "--require-assertions-for-pm", options.requireAssertionsForPm);
|
|
269
|
-
pushOptionalBooleanFlag(args, "--check-context", options.checkContext);
|
|
270
|
-
pushOptionalBooleanFlag(args, "--auto-pm-context", options.autoPmContext);
|
|
271
|
-
}
|
|
272
|
-
/** Implements build background test all command args for the public runtime surface of this module. */
|
|
273
|
-
export function buildBackgroundTestAllCommandArgs(options) {
|
|
274
|
-
const args = ["test-all", "--json", "--progress"];
|
|
275
|
-
pushOptionalValueFlag(args, "--status", options.status);
|
|
276
|
-
pushOptionalValueFlag(args, "--limit", options.limit);
|
|
277
|
-
pushOptionalValueFlag(args, "--offset", options.offset);
|
|
278
|
-
pushSharedBackgroundTestCommandArgs(args, options);
|
|
279
|
-
return args;
|
|
280
|
-
}
|
|
281
|
-
/** Implements format hook warnings for the public runtime surface of this module. */
|
|
282
|
-
export function formatHookWarnings(warnings) {
|
|
283
|
-
return warnings.join(",");
|
|
284
|
-
}
|
|
285
|
-
/** Implements normalize create options for the public runtime surface of this module. */
|
|
286
|
-
export function normalizeCreateOptions(commandOptions, options = {}) {
|
|
287
|
-
const readCreateString = (target) => readFirstStringFromCommanderOptions(commandOptions, resolveCommanderContract(CREATE_COMMANDER_STRING_OPTION_CONTRACTS, target));
|
|
288
|
-
const readCreateList = (target) => readStringArrayFromCommanderOptions(commandOptions, resolveCommanderContract(CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, target));
|
|
289
|
-
const type = readCreateString("type");
|
|
290
|
-
if (options.requireType !== false && type === undefined) {
|
|
291
|
-
throw new PmCliError("Missing required option --type <value>. Why required: create resolves runtime schema fields/workflow from item type. Retry: add --type <built-in or configured custom type> (example: --type Task).", EXIT_CODE.USAGE);
|
|
292
|
-
}
|
|
293
|
-
const normalized = {
|
|
294
|
-
title: readCreateString("title"),
|
|
295
|
-
description: readCreateString("description"),
|
|
296
|
-
type,
|
|
297
|
-
template: readCreateString("template"),
|
|
298
|
-
createMode: readCreateString("createMode"),
|
|
299
|
-
schedulePreset: readCreateString("schedulePreset"),
|
|
300
|
-
status: readCreateString("status"),
|
|
301
|
-
closeReason: readCreateString("closeReason"),
|
|
302
|
-
completedAt: readCreateString("completedAt"),
|
|
303
|
-
priority: readCreateString("priority"),
|
|
304
|
-
tags: readCreateString("tags"),
|
|
305
|
-
addTags: readCreateList("addTags"),
|
|
306
|
-
body: readCreateString("body"),
|
|
307
|
-
deadline: readCreateString("deadline"),
|
|
308
|
-
estimatedMinutes: readCreateString("estimatedMinutes"),
|
|
309
|
-
acceptanceCriteria: readJoinedRepeatedOption(commandOptions, resolveCommanderContract(CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, "acceptanceCriteria")),
|
|
310
|
-
definitionOfReady: readCreateString("definitionOfReady"),
|
|
311
|
-
order: readCreateString("order"),
|
|
312
|
-
rank: readCreateString("rank"),
|
|
313
|
-
goal: readCreateString("goal"),
|
|
314
|
-
objective: readCreateString("objective"),
|
|
315
|
-
value: readCreateString("value"),
|
|
316
|
-
impact: readCreateString("impact"),
|
|
317
|
-
outcome: readCreateString("outcome"),
|
|
318
|
-
whyNow: readCreateString("whyNow"),
|
|
319
|
-
author: readCreateString("author"),
|
|
320
|
-
message: readCreateString("message"),
|
|
321
|
-
assignee: readCreateString("assignee"),
|
|
322
|
-
parent: readCreateString("parent"),
|
|
323
|
-
allowMissingParent: anyOptionTrue(commandOptions, [
|
|
324
|
-
"allowMissingParent",
|
|
325
|
-
"allow_missing_parent",
|
|
326
|
-
]) === true,
|
|
327
|
-
allowUnresolvedDeps: anyOptionTrue(commandOptions, [
|
|
328
|
-
"allowUnresolvedDeps",
|
|
329
|
-
"allow_unresolved_deps",
|
|
330
|
-
]) === true,
|
|
331
|
-
allowDuplicate: optionTrue(commandOptions, "allowDuplicate") === true,
|
|
332
|
-
reviewer: readCreateString("reviewer"),
|
|
333
|
-
risk: readCreateString("risk"),
|
|
334
|
-
confidence: readCreateString("confidence"),
|
|
335
|
-
sprint: readCreateString("sprint"),
|
|
336
|
-
release: readCreateString("release"),
|
|
337
|
-
blockedBy: readCreateString("blockedBy"),
|
|
338
|
-
blockedReason: readCreateString("blockedReason"),
|
|
339
|
-
unblockNote: readCreateString("unblockNote"),
|
|
340
|
-
reporter: readCreateString("reporter"),
|
|
341
|
-
severity: readCreateString("severity"),
|
|
342
|
-
environment: readCreateString("environment"),
|
|
343
|
-
reproSteps: readCreateString("reproSteps"),
|
|
344
|
-
resolution: readCreateString("resolution"),
|
|
345
|
-
expectedResult: readCreateString("expectedResult"),
|
|
346
|
-
actualResult: readCreateString("actualResult"),
|
|
347
|
-
affectedVersion: readCreateString("affectedVersion"),
|
|
348
|
-
fixedVersion: readCreateString("fixedVersion"),
|
|
349
|
-
component: readCreateString("component"),
|
|
350
|
-
regression: commandOptions.regression === true
|
|
351
|
-
? "true"
|
|
352
|
-
: readCreateString("regression"),
|
|
353
|
-
customerImpact: readCreateString("customerImpact"),
|
|
354
|
-
dep: readCreateList("dep"),
|
|
355
|
-
comment: readCreateList("comment"),
|
|
356
|
-
note: readCreateList("note"),
|
|
357
|
-
learning: readCreateList("learning"),
|
|
358
|
-
file: readCreateList("file"),
|
|
359
|
-
test: readCreateList("test"),
|
|
360
|
-
doc: readCreateList("doc"),
|
|
361
|
-
reminder: readCreateList("reminder"),
|
|
362
|
-
event: readCreateList("event"),
|
|
363
|
-
typeOption: readCreateList("typeOption"),
|
|
364
|
-
field: readCreateList("field"),
|
|
365
|
-
unset: readCreateList("unset"),
|
|
366
|
-
clearDeps: optionTrue(commandOptions, "clearDeps"),
|
|
367
|
-
clearComments: optionTrue(commandOptions, "clearComments"),
|
|
368
|
-
clearNotes: optionTrue(commandOptions, "clearNotes"),
|
|
369
|
-
clearLearnings: optionTrue(commandOptions, "clearLearnings"),
|
|
370
|
-
clearFiles: optionTrue(commandOptions, "clearFiles"),
|
|
371
|
-
clearTests: optionTrue(commandOptions, "clearTests"),
|
|
372
|
-
clearDocs: optionTrue(commandOptions, "clearDocs"),
|
|
373
|
-
clearReminders: optionTrue(commandOptions, "clearReminders"),
|
|
374
|
-
clearEvents: optionTrue(commandOptions, "clearEvents"),
|
|
375
|
-
clearTypeOptions: optionTrue(commandOptions, "clearTypeOptions"),
|
|
376
|
-
};
|
|
377
|
-
copyUnknownOptions(normalized, commandOptions);
|
|
378
|
-
return normalized;
|
|
379
|
-
}
|
|
380
|
-
/** Implements normalize update options for the public runtime surface of this module. */
|
|
381
|
-
export function normalizeUpdateOptions(commandOptions) {
|
|
382
|
-
const readUpdateString = (target) => readFirstStringFromCommanderOptions(commandOptions, resolveCommanderContract(UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, target));
|
|
383
|
-
const readUpdateList = (target) => readStringArrayFromCommanderOptions(commandOptions, resolveCommanderContract(UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, target));
|
|
384
|
-
const normalized = {
|
|
385
|
-
title: readUpdateString("title"),
|
|
386
|
-
description: readUpdateString("description"),
|
|
387
|
-
body: readUpdateString("body"),
|
|
388
|
-
status: readUpdateString("status"),
|
|
389
|
-
closeReason: readUpdateString("closeReason"),
|
|
390
|
-
priority: readUpdateString("priority"),
|
|
391
|
-
type: readUpdateString("type"),
|
|
392
|
-
tags: readUpdateString("tags"),
|
|
393
|
-
addTags: readUpdateList("addTags"),
|
|
394
|
-
removeTags: readUpdateList("removeTags"),
|
|
395
|
-
deadline: readUpdateString("deadline"),
|
|
396
|
-
estimatedMinutes: readUpdateString("estimatedMinutes"),
|
|
397
|
-
acceptanceCriteria: readJoinedRepeatedOption(commandOptions, resolveCommanderContract(UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, "acceptanceCriteria")),
|
|
398
|
-
addAc: readUpdateList("addAc"),
|
|
399
|
-
removeAc: readUpdateList("removeAc"),
|
|
400
|
-
definitionOfReady: readUpdateString("definitionOfReady"),
|
|
401
|
-
order: readUpdateString("order"),
|
|
402
|
-
rank: readUpdateString("rank"),
|
|
403
|
-
goal: readUpdateString("goal"),
|
|
404
|
-
objective: readUpdateString("objective"),
|
|
405
|
-
value: readUpdateString("value"),
|
|
406
|
-
impact: readUpdateString("impact"),
|
|
407
|
-
outcome: readUpdateString("outcome"),
|
|
408
|
-
whyNow: readUpdateString("whyNow"),
|
|
409
|
-
author: readUpdateString("author"),
|
|
410
|
-
message: readUpdateString("message"),
|
|
411
|
-
force: Boolean(commandOptions.force),
|
|
412
|
-
ownershipMetadataBypass: commandOptions.ownershipMetadataBypass === true ? true : undefined,
|
|
413
|
-
ownershipDependencyBypass: commandOptions.ownershipDependencyBypass === true ? true : undefined,
|
|
414
|
-
assignee: readUpdateString("assignee"),
|
|
415
|
-
parent: readUpdateString("parent"),
|
|
416
|
-
allowUnresolvedDeps: anyOptionTrue(commandOptions, [
|
|
417
|
-
"allowUnresolvedDeps",
|
|
418
|
-
"allow_unresolved_deps",
|
|
419
|
-
]) === true,
|
|
420
|
-
reviewer: readUpdateString("reviewer"),
|
|
421
|
-
risk: readUpdateString("risk"),
|
|
422
|
-
confidence: readUpdateString("confidence"),
|
|
423
|
-
sprint: readUpdateString("sprint"),
|
|
424
|
-
release: readUpdateString("release"),
|
|
425
|
-
blockedBy: readUpdateString("blockedBy"),
|
|
426
|
-
blockedReason: readUpdateString("blockedReason"),
|
|
427
|
-
unblockNote: readUpdateString("unblockNote"),
|
|
428
|
-
reporter: readUpdateString("reporter"),
|
|
429
|
-
severity: readUpdateString("severity"),
|
|
430
|
-
environment: readUpdateString("environment"),
|
|
431
|
-
reproSteps: readUpdateString("reproSteps"),
|
|
432
|
-
resolution: readUpdateString("resolution"),
|
|
433
|
-
expectedResult: readUpdateString("expectedResult"),
|
|
434
|
-
actualResult: readUpdateString("actualResult"),
|
|
435
|
-
affectedVersion: readUpdateString("affectedVersion"),
|
|
436
|
-
fixedVersion: readUpdateString("fixedVersion"),
|
|
437
|
-
component: readUpdateString("component"),
|
|
438
|
-
regression: commandOptions.regression === true
|
|
439
|
-
? "true"
|
|
440
|
-
: readUpdateString("regression"),
|
|
441
|
-
customerImpact: readUpdateString("customerImpact"),
|
|
442
|
-
dep: readUpdateList("dep"),
|
|
443
|
-
depRemove: readUpdateList("depRemove"),
|
|
444
|
-
replaceDeps: optionTrue(commandOptions, "replaceDeps"),
|
|
445
|
-
replaceTests: optionTrue(commandOptions, "replaceTests"),
|
|
446
|
-
replaceFiles: optionTrue(commandOptions, "replaceFiles"),
|
|
447
|
-
replaceDocs: optionTrue(commandOptions, "replaceDocs"),
|
|
448
|
-
comment: readUpdateList("comment"),
|
|
449
|
-
note: readUpdateList("note"),
|
|
450
|
-
learning: readUpdateList("learning"),
|
|
451
|
-
file: readUpdateList("file"),
|
|
452
|
-
test: readUpdateList("test"),
|
|
453
|
-
doc: readUpdateList("doc"),
|
|
454
|
-
reminder: readUpdateList("reminder"),
|
|
455
|
-
event: readUpdateList("event"),
|
|
456
|
-
typeOption: readUpdateList("typeOption"),
|
|
457
|
-
field: readUpdateList("field"),
|
|
458
|
-
unset: readUpdateList("unset"),
|
|
459
|
-
clearDeps: optionTrue(commandOptions, "clearDeps"),
|
|
460
|
-
clearComments: optionTrue(commandOptions, "clearComments"),
|
|
461
|
-
clearNotes: optionTrue(commandOptions, "clearNotes"),
|
|
462
|
-
clearLearnings: optionTrue(commandOptions, "clearLearnings"),
|
|
463
|
-
clearFiles: optionTrue(commandOptions, "clearFiles"),
|
|
464
|
-
clearTests: optionTrue(commandOptions, "clearTests"),
|
|
465
|
-
clearDocs: optionTrue(commandOptions, "clearDocs"),
|
|
466
|
-
clearReminders: optionTrue(commandOptions, "clearReminders"),
|
|
467
|
-
clearEvents: optionTrue(commandOptions, "clearEvents"),
|
|
468
|
-
clearTypeOptions: optionTrue(commandOptions, "clearTypeOptions"),
|
|
469
|
-
};
|
|
470
|
-
copyUnknownOptions(normalized, commandOptions);
|
|
471
|
-
return normalized;
|
|
472
|
-
}
|
|
473
|
-
const UPDATE_MANY_CONTROL_OPTION_KEYS = new Set([
|
|
474
|
-
"filterStatus",
|
|
475
|
-
"filterType",
|
|
476
|
-
"filterTag",
|
|
477
|
-
"filterPriority",
|
|
478
|
-
"filterDeadlineBefore",
|
|
479
|
-
"filterDeadlineAfter",
|
|
480
|
-
"filterUpdatedAfter",
|
|
481
|
-
"filterUpdatedBefore",
|
|
482
|
-
"filterCreatedAfter",
|
|
483
|
-
"filterCreatedBefore",
|
|
484
|
-
"filterAssignee",
|
|
485
|
-
"filterAssigneeFilter",
|
|
486
|
-
"filterAssignee_filter",
|
|
487
|
-
"filterParent",
|
|
488
|
-
"filterSprint",
|
|
489
|
-
"filterRelease",
|
|
490
|
-
"filterAcMissing",
|
|
491
|
-
"filterEstimatesMissing",
|
|
492
|
-
"filterEstimateMissing",
|
|
493
|
-
"filterResolutionMissing",
|
|
494
|
-
"filterMetadataMissing",
|
|
495
|
-
"filterReviewerMissing",
|
|
496
|
-
"filterRiskMissing",
|
|
497
|
-
"filterConfidenceMissing",
|
|
498
|
-
"filterSprintMissing",
|
|
499
|
-
"filterReleaseMissing",
|
|
500
|
-
"filterHasNotes",
|
|
501
|
-
"filterNoNotes",
|
|
502
|
-
"filterHasLearnings",
|
|
503
|
-
"filterNoLearnings",
|
|
504
|
-
"filterHasFiles",
|
|
505
|
-
"filterNoFiles",
|
|
506
|
-
"filterHasDocs",
|
|
507
|
-
"filterNoDocs",
|
|
508
|
-
"filterHasTests",
|
|
509
|
-
"filterNoTests",
|
|
510
|
-
"filterHasComments",
|
|
511
|
-
"filterNoComments",
|
|
512
|
-
"filterHasDeps",
|
|
513
|
-
"filterNoDeps",
|
|
514
|
-
"filterHasBody",
|
|
515
|
-
"filterEmptyBody",
|
|
516
|
-
"filterHasLinkedCommand",
|
|
517
|
-
"filterNoLinkedCommand",
|
|
518
|
-
"ids",
|
|
519
|
-
"limit",
|
|
520
|
-
"offset",
|
|
521
|
-
"dryRun",
|
|
522
|
-
"rollback",
|
|
523
|
-
"checkpoint",
|
|
524
|
-
]);
|
|
525
|
-
/** Implements extract update many mutation option source for the public runtime surface of this module. */
|
|
526
|
-
export function extractUpdateManyMutationOptionSource(commandOptions) {
|
|
527
|
-
const mutationOptions = {};
|
|
528
|
-
for (const [key, value] of Object.entries(commandOptions)) {
|
|
529
|
-
if (UPDATE_MANY_CONTROL_OPTION_KEYS.has(key)) {
|
|
530
|
-
continue;
|
|
531
|
-
}
|
|
532
|
-
mutationOptions[key] = value;
|
|
533
|
-
}
|
|
534
|
-
return mutationOptions;
|
|
535
|
-
}
|
|
536
|
-
function readListOptionString(options, target) {
|
|
537
|
-
const contract = resolveCommanderContract(LIST_COMMANDER_STRING_OPTION_CONTRACTS, target);
|
|
538
|
-
const stringValue = readFirstStringFromCommanderOptions(options, contract);
|
|
539
|
-
if (stringValue !== undefined) {
|
|
540
|
-
return stringValue;
|
|
541
|
-
}
|
|
542
|
-
for (const key of contract.keys) {
|
|
543
|
-
const value = options[key];
|
|
544
|
-
if (Array.isArray(value)) {
|
|
545
|
-
const strings = value.filter((entry) => typeof entry === "string");
|
|
546
|
-
if (strings.length > 0) {
|
|
547
|
-
return strings.join(",");
|
|
548
|
-
}
|
|
549
|
-
}
|
|
550
|
-
/* c8 ignore start -- unreachable: readFirstStringFromCommanderOptions already returns above for any string value under contract.keys, so a string here cannot occur */
|
|
551
|
-
if (target === "ids" && typeof value === "string") {
|
|
552
|
-
return value;
|
|
553
|
-
}
|
|
554
|
-
/* c8 ignore stop */
|
|
555
|
-
if (typeof value === "number" && Number.isFinite(value)) {
|
|
556
|
-
return String(value);
|
|
557
|
-
}
|
|
558
|
-
}
|
|
559
|
-
return undefined;
|
|
560
|
-
}
|
|
561
|
-
// Shared governance-missing (GH-236) + content-field presence/absence (GH-242)
|
|
562
|
-
// selection-filter fields. Presence flags are plain booleans; absence uses
|
|
563
|
-
// commander negation (`--no-notes` stores notes=false) except --empty-body
|
|
564
|
-
// which is its own dest. The docs/files `--filter-*-missing` aliases mirror
|
|
565
|
-
// `--no-*` while keeping the raw alias keys accounted for before passthrough.
|
|
566
|
-
// Spread into normalizeListOptions and normalizeSearchOptions at the same
|
|
567
|
-
// position so key order is preserved.
|
|
568
|
-
function readSelectionFilterOptionFields(options) {
|
|
569
|
-
const filterFilesMissing = optionTrue(options, "filterFilesMissing");
|
|
570
|
-
const filterDocsMissing = optionTrue(options, "filterDocsMissing");
|
|
571
|
-
return {
|
|
572
|
-
filterReviewerMissing: optionTrue(options, "filterReviewerMissing"),
|
|
573
|
-
filterRiskMissing: optionTrue(options, "filterRiskMissing"),
|
|
574
|
-
filterConfidenceMissing: optionTrue(options, "filterConfidenceMissing"),
|
|
575
|
-
filterSprintMissing: optionTrue(options, "filterSprintMissing"),
|
|
576
|
-
filterReleaseMissing: optionTrue(options, "filterReleaseMissing"),
|
|
577
|
-
hasNotes: optionTrue(options, "hasNotes"),
|
|
578
|
-
hasLearnings: optionTrue(options, "hasLearnings"),
|
|
579
|
-
hasFiles: optionTrue(options, "hasFiles"),
|
|
580
|
-
hasDocs: optionTrue(options, "hasDocs"),
|
|
581
|
-
hasTests: optionTrue(options, "hasTests"),
|
|
582
|
-
hasComments: optionTrue(options, "hasComments"),
|
|
583
|
-
hasDeps: optionTrue(options, "hasDeps"),
|
|
584
|
-
hasBody: optionTrue(options, "hasBody"),
|
|
585
|
-
hasLinkedCommand: optionTrue(options, "hasLinkedCommand"),
|
|
586
|
-
noNotes: optionFalse(options, "notes"),
|
|
587
|
-
noLearnings: optionFalse(options, "learnings"),
|
|
588
|
-
noFiles: optionFalse(options, "files") ?? filterFilesMissing,
|
|
589
|
-
filterFilesMissing,
|
|
590
|
-
noDocs: optionFalse(options, "docs") ?? filterDocsMissing,
|
|
591
|
-
filterDocsMissing,
|
|
592
|
-
noTests: optionFalse(options, "tests"),
|
|
593
|
-
noComments: optionFalse(options, "comments"),
|
|
594
|
-
noDeps: optionFalse(options, "deps"),
|
|
595
|
-
emptyBody: optionTrue(options, "emptyBody"),
|
|
596
|
-
noLinkedCommand: optionFalse(options, "linkedCommand"),
|
|
597
|
-
};
|
|
598
|
-
}
|
|
599
|
-
/** Implements normalize list options for the public runtime surface of this module. */
|
|
600
|
-
export function normalizeListOptions(options) {
|
|
601
|
-
const normalized = {
|
|
602
|
-
status: readListOptionString(options, "status"),
|
|
603
|
-
type: readListOptionString(options, "type"),
|
|
604
|
-
tag: readListOptionString(options, "tag"),
|
|
605
|
-
priority: readListOptionString(options, "priority"),
|
|
606
|
-
deadlineBefore: readListOptionString(options, "deadlineBefore"),
|
|
607
|
-
deadlineAfter: readListOptionString(options, "deadlineAfter"),
|
|
608
|
-
updatedAfter: readListOptionString(options, "updatedAfter"),
|
|
609
|
-
updatedBefore: readListOptionString(options, "updatedBefore"),
|
|
610
|
-
createdAfter: readListOptionString(options, "createdAfter"),
|
|
611
|
-
createdBefore: readListOptionString(options, "createdBefore"),
|
|
612
|
-
today: optionTrue(options, "today"),
|
|
613
|
-
recent: optionTrue(options, "recent"),
|
|
614
|
-
ids: readListOptionString(options, "ids"),
|
|
615
|
-
assignee: readListOptionString(options, "assignee"),
|
|
616
|
-
assigneeFilter: readListOptionString(options, "assigneeFilter"),
|
|
617
|
-
parent: readListOptionString(options, "parent"),
|
|
618
|
-
sprint: readListOptionString(options, "sprint"),
|
|
619
|
-
release: readListOptionString(options, "release"),
|
|
620
|
-
limit: readListOptionString(options, "limit"),
|
|
621
|
-
offset: readListOptionString(options, "offset"),
|
|
622
|
-
// Commander stores --no-truncate as truncate=false.
|
|
623
|
-
noTruncate: optionFalse(options, "truncate"),
|
|
624
|
-
includeBody: optionTrue(options, "includeBody"),
|
|
625
|
-
strictRead: optionTrue(options, "strictRead"),
|
|
626
|
-
compact: optionTrue(options, "compact"),
|
|
627
|
-
brief: optionTrue(options, "brief"),
|
|
628
|
-
full: optionTrue(options, "full"),
|
|
629
|
-
fields: readListOptionString(options, "fields"),
|
|
630
|
-
sort: readListOptionString(options, "sort"),
|
|
631
|
-
order: readListOptionString(options, "order"),
|
|
632
|
-
tree: optionTrue(options, "tree"),
|
|
633
|
-
treeDepth: readListOptionString(options, "treeDepth"),
|
|
634
|
-
filterAcMissing: optionTrue(options, "filterAcMissing"),
|
|
635
|
-
filterEstimatesMissing: anyOptionTrue(options, [
|
|
636
|
-
"filterEstimatesMissing",
|
|
637
|
-
"filterEstimateMissing",
|
|
638
|
-
]),
|
|
639
|
-
filterResolutionMissing: optionTrue(options, "filterResolutionMissing"),
|
|
640
|
-
filterMetadataMissing: optionTrue(options, "filterMetadataMissing"),
|
|
641
|
-
// Governance-missing (GH-236) + content presence/absence (GH-242) filters.
|
|
642
|
-
...readSelectionFilterOptionFields(options),
|
|
643
|
-
};
|
|
644
|
-
copyUnknownOptions(normalized, options);
|
|
645
|
-
return normalized;
|
|
646
|
-
}
|
|
647
|
-
/** Implements normalize aggregate options for the public runtime surface of this module. */
|
|
648
|
-
export function normalizeAggregateOptions(options) {
|
|
649
|
-
return {
|
|
650
|
-
groupBy: typeof options.groupBy === "string" ? options.groupBy : undefined,
|
|
651
|
-
count: options.count === true ? true : undefined,
|
|
652
|
-
completion: options.completion === true ? true : undefined,
|
|
653
|
-
sum: typeof options.sum === "string" ? options.sum : undefined,
|
|
654
|
-
avg: typeof options.avg === "string" ? options.avg : undefined,
|
|
655
|
-
includeUnparented: options.includeUnparented === true || options.include_unparented === true,
|
|
656
|
-
status: typeof options.status === "string" ? options.status : undefined,
|
|
657
|
-
type: readListOptionString(options, "type"),
|
|
658
|
-
tag: readListOptionString(options, "tag"),
|
|
659
|
-
priority: readListOptionString(options, "priority"),
|
|
660
|
-
deadlineBefore: readListOptionString(options, "deadlineBefore"),
|
|
661
|
-
deadlineAfter: readListOptionString(options, "deadlineAfter"),
|
|
662
|
-
assignee: readListOptionString(options, "assignee"),
|
|
663
|
-
assigneeFilter: readListOptionString(options, "assigneeFilter"),
|
|
664
|
-
parent: readListOptionString(options, "parent"),
|
|
665
|
-
sprint: readListOptionString(options, "sprint"),
|
|
666
|
-
release: readListOptionString(options, "release"),
|
|
667
|
-
};
|
|
668
|
-
}
|
|
669
|
-
/** Implements print list json stream for the public runtime surface of this module. */
|
|
670
|
-
export function printListJsonStream(commandName, result, globalOptions) {
|
|
671
|
-
setActiveCommandResult(result);
|
|
672
|
-
if (globalOptions.quiet) {
|
|
673
|
-
return;
|
|
674
|
-
}
|
|
675
|
-
const warnings = Array.isArray(result.warnings) ? result.warnings : [];
|
|
676
|
-
const metaPayload = {
|
|
677
|
-
type: "meta",
|
|
678
|
-
command: commandName,
|
|
679
|
-
count: result.count,
|
|
680
|
-
now: result.now,
|
|
681
|
-
filters: result.filters,
|
|
682
|
-
};
|
|
683
|
-
if (warnings.length > 0) {
|
|
684
|
-
metaPayload.warnings = warnings;
|
|
685
|
-
}
|
|
686
|
-
if (!writeStdout(`${JSON.stringify(metaPayload)}\n`)) {
|
|
687
|
-
return;
|
|
688
|
-
}
|
|
689
|
-
for (const item of result.items) {
|
|
690
|
-
if (!writeStdout(`${JSON.stringify({ type: "item", command: commandName, item })}\n`)) {
|
|
691
|
-
return;
|
|
692
|
-
}
|
|
693
|
-
}
|
|
694
|
-
writeStdout(`${JSON.stringify({ type: "end", command: commandName, count: result.count })}\n`);
|
|
695
|
-
}
|
|
696
|
-
/** Implements print activity json stream for the public runtime surface of this module. */
|
|
697
|
-
export function printActivityJsonStream(result, options, globalOptions) {
|
|
698
|
-
setActiveCommandResult(result);
|
|
699
|
-
if (globalOptions.quiet) {
|
|
700
|
-
return;
|
|
701
|
-
}
|
|
702
|
-
const metaPayload = {
|
|
703
|
-
type: "meta",
|
|
704
|
-
command: "activity",
|
|
705
|
-
count: result.count,
|
|
706
|
-
filters: {
|
|
707
|
-
id: options.id ?? null,
|
|
708
|
-
op: options.op ?? null,
|
|
709
|
-
author: options.author ?? null,
|
|
710
|
-
from: options.from ?? null,
|
|
711
|
-
to: options.to ?? null,
|
|
712
|
-
limit: options.limit ?? null,
|
|
713
|
-
},
|
|
714
|
-
};
|
|
715
|
-
if (!writeStdout(`${JSON.stringify(metaPayload)}\n`)) {
|
|
716
|
-
return;
|
|
717
|
-
}
|
|
718
|
-
const entries = result.compact && result.compact_activity
|
|
719
|
-
? result.compact_activity
|
|
720
|
-
: (result.activity ?? []);
|
|
721
|
-
for (const entry of entries) {
|
|
722
|
-
if (!writeStdout(`${JSON.stringify({ type: "entry", command: "activity", entry })}\n`)) {
|
|
723
|
-
return;
|
|
724
|
-
}
|
|
725
|
-
}
|
|
726
|
-
writeStdout(`${JSON.stringify({ type: "end", command: "activity", count: result.count })}\n`);
|
|
727
|
-
}
|
|
728
|
-
/** Implements normalize search options for the public runtime surface of this module. */
|
|
729
|
-
export function normalizeSearchOptions(options) {
|
|
730
|
-
const readSearchString = (target) => readFirstStringFromCommanderOptions(options, resolveCommanderContract(SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, target));
|
|
731
|
-
const readSearchStringOrNumber = (target) => {
|
|
732
|
-
const candidate = readFirstValueFromCommanderOptions(options, resolveCommanderContract(SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, target));
|
|
733
|
-
if (typeof candidate === "string") {
|
|
734
|
-
return candidate;
|
|
735
|
-
}
|
|
736
|
-
if (typeof candidate === "number" && Number.isFinite(candidate)) {
|
|
737
|
-
return candidate;
|
|
738
|
-
}
|
|
739
|
-
return undefined;
|
|
740
|
-
};
|
|
741
|
-
const fields = readSearchString("fields");
|
|
742
|
-
const compactRequested = options.compact === true;
|
|
743
|
-
const fullRequested = options.full === true;
|
|
744
|
-
const defaultCompact = !compactRequested && !fullRequested && fields === undefined;
|
|
745
|
-
const mode = options.semantic === true
|
|
746
|
-
? "semantic"
|
|
747
|
-
: options.hybrid === true
|
|
748
|
-
? "hybrid"
|
|
749
|
-
: readSearchString("mode");
|
|
750
|
-
const normalized = {
|
|
751
|
-
mode,
|
|
752
|
-
matchMode: readSearchString("matchMode"),
|
|
753
|
-
minScore: readSearchStringOrNumber("minScore"),
|
|
754
|
-
count: optionTrue(options, "count"),
|
|
755
|
-
semanticWeight: readSearchStringOrNumber("semanticWeight"),
|
|
756
|
-
includeLinked: optionTrue(options, "includeLinked"),
|
|
757
|
-
titleExact: optionTrue(options, "titleExact"),
|
|
758
|
-
phraseExact: optionTrue(options, "phraseExact"),
|
|
759
|
-
highlight: optionTrue(options, "highlight"),
|
|
760
|
-
status: readSearchString("status"),
|
|
761
|
-
type: readSearchString("type"),
|
|
762
|
-
tag: readSearchString("tag"),
|
|
763
|
-
priority: readSearchString("priority"),
|
|
764
|
-
deadlineBefore: readSearchString("deadlineBefore"),
|
|
765
|
-
deadlineAfter: readSearchString("deadlineAfter"),
|
|
766
|
-
updatedAfter: readSearchString("updatedAfter"),
|
|
767
|
-
updatedBefore: readSearchString("updatedBefore"),
|
|
768
|
-
createdAfter: readSearchString("createdAfter"),
|
|
769
|
-
createdBefore: readSearchString("createdBefore"),
|
|
770
|
-
assignee: readSearchString("assignee"),
|
|
771
|
-
sprint: readSearchString("sprint"),
|
|
772
|
-
release: readSearchString("release"),
|
|
773
|
-
parent: readSearchString("parent"),
|
|
774
|
-
limit: readSearchString("limit"),
|
|
775
|
-
fields,
|
|
776
|
-
compact: compactRequested || defaultCompact ? true : undefined,
|
|
777
|
-
full: optionTrue(options, "full"),
|
|
778
|
-
// Governance-missing (GH-236) + content presence/absence (GH-242) filters,
|
|
779
|
-
// mirroring normalizeListOptions via the shared field slice.
|
|
780
|
-
...readSelectionFilterOptionFields(options),
|
|
781
|
-
};
|
|
782
|
-
copyUnknownOptions(normalized, options);
|
|
783
|
-
return normalized;
|
|
784
|
-
}
|
|
785
|
-
/** Implements normalize search keywords input for the public runtime surface of this module. */
|
|
786
|
-
export function normalizeSearchKeywordsInput(keywords) {
|
|
787
|
-
const query = keywords
|
|
788
|
-
.map((entry) => entry.trim())
|
|
789
|
-
.filter((entry) => entry.length > 0)
|
|
790
|
-
.join(" ");
|
|
791
|
-
if (query.length === 0) {
|
|
792
|
-
throw new PmCliError("Search query must not be empty", EXIT_CODE.USAGE);
|
|
793
|
-
}
|
|
794
|
-
return query;
|
|
795
|
-
}
|
|
796
|
-
/** Implements normalize activity options for the public runtime surface of this module. */
|
|
797
|
-
export function normalizeActivityOptions(options) {
|
|
798
|
-
const readActivityString = (target) => readFirstStringFromCommanderOptions(options, resolveCommanderContract(ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, target));
|
|
799
|
-
const normalized = {
|
|
800
|
-
id: readActivityString("id"),
|
|
801
|
-
op: readActivityString("op"),
|
|
802
|
-
author: readActivityString("author"),
|
|
803
|
-
from: readActivityString("from"),
|
|
804
|
-
to: readActivityString("to"),
|
|
805
|
-
limit: readActivityString("limit"),
|
|
806
|
-
compact: options.full === true || options.provenance === true
|
|
807
|
-
? false
|
|
808
|
-
: options.compact === true || options.raw === true
|
|
809
|
-
? true
|
|
810
|
-
: undefined,
|
|
811
|
-
...(options.raw === true ||
|
|
812
|
-
options.compact === true ||
|
|
813
|
-
options.full === true
|
|
814
|
-
? { raw: true }
|
|
815
|
-
: {}),
|
|
816
|
-
unbounded: optionTrue(options, "unbounded"),
|
|
817
|
-
provenance: optionTrue(options, "provenance"),
|
|
818
|
-
provenanceSummary: optionTrue(options, "provenanceSummary"),
|
|
819
|
-
harness: Array.isArray(options.harness)
|
|
820
|
-
? options.harness
|
|
821
|
-
: undefined,
|
|
822
|
-
agentInstance: Array.isArray(options.agentInstance)
|
|
823
|
-
? options.agentInstance
|
|
824
|
-
: undefined,
|
|
825
|
-
provenanceFilter: Array.isArray(options.provenanceFilter)
|
|
826
|
-
? options.provenanceFilter
|
|
827
|
-
: undefined,
|
|
828
|
-
};
|
|
829
|
-
return Object.fromEntries(Object.entries(normalized).filter(([, value]) => value !== undefined));
|
|
830
|
-
}
|
|
831
|
-
const ACTIVITY_STREAM_ENABLED_VALUES = new Set([
|
|
832
|
-
"",
|
|
833
|
-
"rows",
|
|
834
|
-
"ndjson",
|
|
835
|
-
"jsonl",
|
|
836
|
-
"true",
|
|
837
|
-
"1",
|
|
838
|
-
"yes",
|
|
839
|
-
"on",
|
|
840
|
-
]);
|
|
841
|
-
const ACTIVITY_STREAM_DISABLED_VALUES = new Set(["false", "off", "none", "0"]);
|
|
842
|
-
/** Implements resolve activity stream mode for the public runtime surface of this module. */
|
|
843
|
-
export function resolveActivityStreamMode(raw) {
|
|
844
|
-
if (raw === true) {
|
|
845
|
-
return true;
|
|
846
|
-
}
|
|
847
|
-
if (raw === false || raw === undefined || raw === null) {
|
|
848
|
-
return false;
|
|
849
|
-
}
|
|
850
|
-
if (typeof raw === "string") {
|
|
851
|
-
const normalized = raw.trim().toLowerCase();
|
|
852
|
-
if (ACTIVITY_STREAM_ENABLED_VALUES.has(normalized)) {
|
|
853
|
-
return true;
|
|
854
|
-
}
|
|
855
|
-
if (ACTIVITY_STREAM_DISABLED_VALUES.has(normalized)) {
|
|
856
|
-
return false;
|
|
857
|
-
}
|
|
858
|
-
}
|
|
859
|
-
throw new PmCliError("Activity --stream accepts rows|ndjson|jsonl (or no value)", EXIT_CODE.USAGE);
|
|
860
|
-
}
|
|
861
|
-
/** Implements normalize context options for the public runtime surface of this module. */
|
|
862
|
-
export function normalizeContextOptions(options) {
|
|
863
|
-
const readContextString = (target) => readFirstStringFromCommanderOptions(options, resolveCommanderContract(CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, target));
|
|
864
|
-
const readContextStringOrNumber = (target) => readStringOrFiniteNumberFromCommanderOptions(options, resolveCommanderContract(CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, target));
|
|
865
|
-
const sectionRaw = options.section;
|
|
866
|
-
const section = Array.isArray(sectionRaw)
|
|
867
|
-
? sectionRaw.filter((v) => typeof v === "string" && v.trim().length > 0)
|
|
868
|
-
: typeof sectionRaw === "string" && sectionRaw.trim().length > 0
|
|
869
|
-
? [sectionRaw]
|
|
870
|
-
: undefined;
|
|
871
|
-
const normalized = {
|
|
872
|
-
date: readContextString("date"),
|
|
873
|
-
from: readContextString("from"),
|
|
874
|
-
to: readContextString("to"),
|
|
875
|
-
past: options.past === true ? true : undefined,
|
|
876
|
-
type: readContextString("type"),
|
|
877
|
-
tag: readContextString("tag"),
|
|
878
|
-
priority: readContextString("priority"),
|
|
879
|
-
assignee: readContextString("assignee"),
|
|
880
|
-
assigneeFilter: readContextString("assigneeFilter"),
|
|
881
|
-
sprint: readContextString("sprint"),
|
|
882
|
-
release: readContextString("release"),
|
|
883
|
-
parent: readContextString("parent"),
|
|
884
|
-
limit: readContextString("limit"),
|
|
885
|
-
format: readContextString("format"),
|
|
886
|
-
depth: readContextString("depth"),
|
|
887
|
-
fields: readContextString("fields"),
|
|
888
|
-
section: section && section.length > 0 ? section : undefined,
|
|
889
|
-
activityLimit: readContextString("activityLimit"),
|
|
890
|
-
staleThreshold: readContextString("staleThreshold"),
|
|
891
|
-
tokenBudget: readContextStringOrNumber("tokenBudget"),
|
|
892
|
-
noExtensionHealth: options.extensionHealth === false ? true : undefined,
|
|
893
|
-
noTags: options.tags === false ? true : undefined,
|
|
894
|
-
};
|
|
895
|
-
for (const [key, value] of Object.entries(options)) {
|
|
896
|
-
if (Object.hasOwn(normalized, key)) {
|
|
897
|
-
continue;
|
|
898
|
-
}
|
|
899
|
-
normalized[key] = value;
|
|
900
|
-
}
|
|
901
|
-
return normalized;
|
|
902
|
-
}
|
|
903
|
-
/**
|
|
904
|
-
* Normalizes raw commander options for `pm next` into a typed {@link NextOptions}
|
|
905
|
-
* payload, resolving snake_case flag aliases (e.g. `--assignee_filter`,
|
|
906
|
-
* `--blocked_limit`, `--ready_only`) to their canonical camelCase keys and folding
|
|
907
|
-
* the boolean `--ready-only` switch. Unknown keys are passed through untouched so
|
|
908
|
-
* downstream filtering still sees them.
|
|
909
|
-
*/
|
|
910
|
-
export function normalizeNextOptions(options) {
|
|
911
|
-
const readNextString = (target) => readFirstStringFromCommanderOptions(options, resolveCommanderContract(NEXT_COMMANDER_STRING_OPTION_CONTRACTS, target));
|
|
912
|
-
const readNextStringOrNumber = (target) => readStringOrFiniteNumberFromCommanderOptions(options, resolveCommanderContract(NEXT_COMMANDER_STRING_OPTION_CONTRACTS, target));
|
|
913
|
-
const normalized = {
|
|
914
|
-
type: readNextString("type"),
|
|
915
|
-
tag: readNextString("tag"),
|
|
916
|
-
priority: readNextStringOrNumber("priority"),
|
|
917
|
-
assignee: readNextString("assignee"),
|
|
918
|
-
assigneeFilter: readNextString("assigneeFilter"),
|
|
919
|
-
sprint: readNextString("sprint"),
|
|
920
|
-
release: readNextString("release"),
|
|
921
|
-
parent: readNextString("parent"),
|
|
922
|
-
limit: readNextString("limit"),
|
|
923
|
-
blockedLimit: readNextString("blockedLimit"),
|
|
924
|
-
readyOnly: options.readyOnly === true || options.ready_only === true
|
|
925
|
-
? true
|
|
926
|
-
: undefined,
|
|
927
|
-
format: readNextString("format"),
|
|
928
|
-
tokenBudget: readNextStringOrNumber("tokenBudget"),
|
|
929
|
-
};
|
|
930
|
-
for (const [key, value] of Object.entries(options)) {
|
|
931
|
-
if (Object.hasOwn(normalized, key)) {
|
|
932
|
-
continue;
|
|
933
|
-
}
|
|
934
|
-
normalized[key] = value;
|
|
935
|
-
}
|
|
936
|
-
return normalized;
|
|
937
|
-
}
|
|
938
|
-
function collectMutationItemIds(result) {
|
|
939
|
-
if (!result || typeof result !== "object") {
|
|
940
|
-
return [];
|
|
941
|
-
}
|
|
942
|
-
const record = result;
|
|
943
|
-
const ids = new Set();
|
|
944
|
-
const pushId = (value) => {
|
|
945
|
-
if (typeof value !== "string") {
|
|
946
|
-
return;
|
|
947
|
-
}
|
|
948
|
-
const normalized = value.trim();
|
|
949
|
-
if (normalized.length === 0) {
|
|
950
|
-
return;
|
|
951
|
-
}
|
|
952
|
-
ids.add(normalized);
|
|
953
|
-
};
|
|
954
|
-
pushId(record.id);
|
|
955
|
-
const item = record.item;
|
|
956
|
-
if (item && typeof item === "object") {
|
|
957
|
-
pushId(item.id);
|
|
958
|
-
}
|
|
959
|
-
const explicitIds = record.ids;
|
|
960
|
-
if (Array.isArray(explicitIds)) {
|
|
961
|
-
for (const candidate of explicitIds) {
|
|
962
|
-
pushId(candidate);
|
|
963
|
-
}
|
|
964
|
-
}
|
|
965
|
-
const items = record.items;
|
|
966
|
-
if (Array.isArray(items)) {
|
|
967
|
-
for (const candidate of items) {
|
|
968
|
-
if (!candidate || typeof candidate !== "object") {
|
|
969
|
-
continue;
|
|
970
|
-
}
|
|
971
|
-
pushId(candidate.id);
|
|
972
|
-
}
|
|
973
|
-
}
|
|
974
|
-
return [...ids].sort((left, right) => left.localeCompare(right));
|
|
975
|
-
}
|
|
976
|
-
/** Implements invalidate search caches for mutation for the public runtime surface of this module. */
|
|
977
|
-
export async function invalidateSearchCachesForMutation(globalOptions, result) {
|
|
978
|
-
const pmRoot = resolvePmRoot(process.cwd(), globalOptions.path);
|
|
979
|
-
const refreshResult = await refreshSearchArtifactsForMutation(pmRoot, collectMutationItemIds(result), {
|
|
980
|
-
background: !shouldRunSearchRefreshInForeground(),
|
|
981
|
-
});
|
|
982
|
-
if (globalOptions.profile && refreshResult.warnings.length > 0) {
|
|
983
|
-
printError(`profile:search_refresh_warnings=${formatHookWarnings(refreshResult.warnings)}`);
|
|
984
|
-
}
|
|
985
|
-
}
|
|
986
|
-
/** Public contract for test only, shared by SDK and presentation-layer consumers. */
|
|
987
|
-
export const _testOnly = {
|
|
988
|
-
collectMutationItemIds,
|
|
989
|
-
};
|
|
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]="7ffd5046-9154-52e7-94ce-192b07b8ceae")}catch(e2){}})();import{Option}from"commander";import{resolvePmHistoryOperation}from"./command-aliases.js";import{pathExists,refreshSearchArtifactsForMutation,shouldRunSearchRefreshInForeground,EXIT_CODE,PmCliError,printError,printResult,writeStdout,getSettingsPath,resolvePmRoot,readSettings,runActiveServiceOverride,setActiveCommandResult}from"../runtime-primitives.js";import{ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,CREATE_COMMANDER_STRING_OPTION_CONTRACTS,LIST_COMMANDER_STRING_OPTION_CONTRACTS,NEXT_COMMANDER_STRING_OPTION_CONTRACTS,SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,readFirstValueFromCommanderOptions,readFirstStringFromCommanderOptions,readStringArrayFromCommanderOptions}from"../cli-contracts.js";async function applyActiveCommandResultService(command,args,options,global2,result){const pmRoot=resolvePmRoot(process.cwd(),global2.path);const override=await runActiveServiceOverride("command_result",{command,args,options,global:global2,pm_root:pmRoot,result});return override.handled?override.result:result}function syncCommanderActionOptions(actionCommand,commandOptions){for(const[key,value]of Object.entries(commandOptions)){actionCommand.setOptionValueWithSource(key,value,"cli")}}function readJoinedRepeatedOption(options,contract){const values=[];const observedArrays=new Set;for(const key of contract.keys){if(!Object.hasOwn(options,key)){continue}const value=options[key];if(value==null){continue}if(typeof value==="string"){values.push(value);continue}if(!Array.isArray(value)||!value.every(entry=>typeof entry==="string")){return void 0}if(observedArrays.has(value)){continue}observedArrays.add(value);values.push(...value)}return values.length>0?values.join("; "):void 0}const RESOLVED_GLOBAL_OPTIONS=Symbol("pm.resolvedGlobalOptions");function commandOptionsReader(command){return typeof command==="object"&&command!==null?command:{}}function resolveCommanderContract(contracts,target){const contract=contracts.find(entry=>entry.target===target);return contract??{target,keys:[target]}}function setResolvedGlobalOptions(command,globalOptions){command[RESOLVED_GLOBAL_OPTIONS]={...globalOptions}}function clearResolvedGlobalOptions(command){delete command[RESOLVED_GLOBAL_OPTIONS]}function readStringCommandOption(options,key){return typeof options[key]==="string"?options[key]:void 0}function getGlobalOptions(command){const commandPath=resolvePmHistoryOperation(getCommandPath(command));const resolved=command[RESOLVED_GLOBAL_OPTIONS];if(resolved){return{...resolved,...commandPath.length>0?{command:commandPath}:{}}}const reader=commandOptionsReader(command);const opts=typeof reader.optsWithGlobals==="function"?reader.optsWithGlobals():typeof reader.opts==="function"?reader.opts():{};const normalized={json:opts.json===true?true:void 0,quiet:Boolean(opts.quiet),noChangedFields:opts.changedFields===false,...opts.fullChangedFields===true?{fullChangedFields:true}:{},idOnly:opts.idOnly===true,...opts.lean===true?{lean:true}:{},...opts.tokenAccounting===true?{tokenAccounting:true}:{},outputInclude:readStringCommandOption(opts,"outputInclude"),outputLimit:readStringCommandOption(opts,"outputLimit"),outputBudget:readStringCommandOption(opts,"outputBudget"),outputSession:readStringCommandOption(opts,"outputSession"),outputCursor:readStringCommandOption(opts,"outputCursor"),...opts.outputRowContract===true?{outputRowContract:true}:{},...opts.outputFormat==="toon"||opts.outputFormat==="json"?{outputFormat:opts.outputFormat}:{},path:readStringCommandOption(opts,"pmPath")??readStringCommandOption(opts,"path"),noExtensions:opts.extensions===false,noPager:Boolean(opts.noPager),profile:Boolean(opts.profile),...commandPath.length>0?{command:commandPath}:{},...typeof opts.author==="string"?{author:opts.author}:{}};return normalized}function getCommandPath(command){const parts=[];let current=command;while(current?.parent){parts.unshift(current.name());current=current.parent}return parts.join(" ")}async function applyDefaultOutputFormat(globalOptions){if(globalOptions.json===true){return globalOptions}const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path);if(!await pathExists(getSettingsPath(pmRoot))){return globalOptions}const settings=await readSettings(pmRoot);return{...globalOptions,defaultOutputFormat:settings.output.default_format}}function collect(value,previous){const next=previous??[];next.push(value);return next}function pushOptionalValueFlag(args,flag,value){if(typeof value!=="string"){return}const trimmed=value.trim();if(trimmed.length===0){return}args.push(flag,trimmed)}function pushOptionalBooleanFlag(args,flag,value){if(value===true){args.push(flag)}}function pushRepeatableValueFlag(args,flag,values){if(!Array.isArray(values)){return}for(const value of values){if(typeof value!=="string"){continue}const trimmed=value.trim();if(trimmed.length===0){continue}args.push(flag,trimmed)}}function optionTrue(options,key){return options[key]===true?true:void 0}function optionFalse(options,key){return options[key]===false?true:void 0}function readOptionString(options,key){return typeof options[key]==="string"?options[key]:void 0}function addHiddenOption(command,flags,description,repeatable=false,repeatableParser=void 0){const option=new Option(flags,description).hideHelp();if(repeatable){option.argParser(repeatableParser??collect)}command.addOption(option)}function addHiddenOptions(command,aliases,repeatable){for(const[flags,description]of aliases){addHiddenOption(command,flags,description,repeatable)}}function anyOptionTrue(options,keys){return keys.some(key=>options[key]===true)?true:void 0}function readStringOrFiniteNumberFromCommanderOptions(options,contract){const value=readFirstValueFromCommanderOptions(options,contract);return typeof value==="string"||typeof value==="number"&&Number.isFinite(value)?value:void 0}function copyUnknownOptions(target,source){for(const[key,value]of Object.entries(source)){if(key==="__proto__"||key==="constructor"||key==="prototype"){continue}if(Object.hasOwn(target,key)){continue}target[key]=value}}function buildBackgroundTestCommandArgs(id,options){const args=["test",id,"--run","--json","--progress"];pushRepeatableValueFlag(args,"--add",options.add);pushRepeatableValueFlag(args,"--add-json",options.addJson);pushRepeatableValueFlag(args,"--remove",options.remove);pushRepeatableValueFlag(args,"--remove-index",options.removeIndex);pushOptionalValueFlag(args,"--match",options.match);pushOptionalValueFlag(args,"--only-index",options.onlyIndex);pushOptionalBooleanFlag(args,"--only-last",options.onlyLast);pushRepeatableValueFlag(args,"--measure",options.measure);pushOptionalValueFlag(args,"--metric-below",options.metricBelow);pushOptionalValueFlag(args,"--metric-diff",options.metricDiff);pushSharedBackgroundTestCommandArgs(args,options);pushOptionalValueFlag(args,"--author",options.author);pushOptionalValueFlag(args,"--message",options.message);pushOptionalBooleanFlag(args,"--force",options.force);return args}function pushSharedBackgroundTestCommandArgs(args,options){pushOptionalValueFlag(args,"--timeout",options.timeout);pushRepeatableValueFlag(args,"--env-set",options.envSet);pushRepeatableValueFlag(args,"--env-clear",options.envClear);pushOptionalBooleanFlag(args,"--shared-host-safe",options.sharedHostSafe);pushOptionalValueFlag(args,"--pm-context",options.pmContext);pushOptionalBooleanFlag(args,"--override-linked-pm-context",options.overrideLinkedPmContext);pushOptionalValueFlag(args,"--workspace-context",options.workspaceContext);pushOptionalBooleanFlag(args,"--override-linked-workspace-context",options.overrideLinkedWorkspaceContext);pushOptionalBooleanFlag(args,"--allow-untrusted-linked-tests",options.allowUntrustedLinkedTests);pushOptionalBooleanFlag(args,"--fail-on-context-mismatch",options.failOnContextMismatch);pushOptionalBooleanFlag(args,"--fail-on-skipped",options.failOnSkipped);pushOptionalBooleanFlag(args,"--fail-on-empty-test-run",options.failOnEmptyTestRun);pushOptionalBooleanFlag(args,"--require-assertions-for-pm",options.requireAssertionsForPm);pushOptionalBooleanFlag(args,"--check-context",options.checkContext);pushOptionalBooleanFlag(args,"--auto-pm-context",options.autoPmContext)}function buildBackgroundTestAllCommandArgs(options){const args=["test-all","--json","--progress"];pushOptionalValueFlag(args,"--status",options.status);pushOptionalValueFlag(args,"--limit",options.limit);pushOptionalValueFlag(args,"--offset",options.offset);pushSharedBackgroundTestCommandArgs(args,options);return args}function formatHookWarnings(warnings){return warnings.join(",")}function normalizeCreateOptions(commandOptions,options={}){const readCreateString=target=>readFirstStringFromCommanderOptions(commandOptions,resolveCommanderContract(CREATE_COMMANDER_STRING_OPTION_CONTRACTS,target));const readCreateList=target=>readStringArrayFromCommanderOptions(commandOptions,resolveCommanderContract(CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,target));const type=readCreateString("type");if(options.requireType!==false&&type===void 0){throw new PmCliError("Missing required option --type <value>. Why required: create resolves runtime schema fields/workflow from item type. Retry: add --type <built-in or configured custom type> (example: --type Task).",EXIT_CODE.USAGE)}const normalized={title:readCreateString("title"),description:readCreateString("description"),type,template:readCreateString("template"),createMode:readCreateString("createMode"),schedulePreset:readCreateString("schedulePreset"),status:readCreateString("status"),closeReason:readCreateString("closeReason"),completedAt:readCreateString("completedAt"),priority:readCreateString("priority"),tags:readCreateString("tags"),addTags:readCreateList("addTags"),body:readCreateString("body"),deadline:readCreateString("deadline"),estimatedMinutes:readCreateString("estimatedMinutes"),acceptanceCriteria:readJoinedRepeatedOption(commandOptions,resolveCommanderContract(CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,"acceptanceCriteria")),definitionOfReady:readCreateString("definitionOfReady"),order:readCreateString("order"),rank:readCreateString("rank"),goal:readCreateString("goal"),objective:readCreateString("objective"),value:readCreateString("value"),impact:readCreateString("impact"),outcome:readCreateString("outcome"),whyNow:readCreateString("whyNow"),author:readCreateString("author"),message:readCreateString("message"),assignee:readCreateString("assignee"),parent:readCreateString("parent"),allowMissingParent:anyOptionTrue(commandOptions,["allowMissingParent","allow_missing_parent"])===true,allowUnresolvedDeps:anyOptionTrue(commandOptions,["allowUnresolvedDeps","allow_unresolved_deps"])===true,allowDuplicate:optionTrue(commandOptions,"allowDuplicate")===true,reviewer:readCreateString("reviewer"),risk:readCreateString("risk"),confidence:readCreateString("confidence"),sprint:readCreateString("sprint"),release:readCreateString("release"),blockedBy:readCreateString("blockedBy"),blockedReason:readCreateString("blockedReason"),unblockNote:readCreateString("unblockNote"),reporter:readCreateString("reporter"),severity:readCreateString("severity"),environment:readCreateString("environment"),reproSteps:readCreateString("reproSteps"),resolution:readCreateString("resolution"),expectedResult:readCreateString("expectedResult"),actualResult:readCreateString("actualResult"),affectedVersion:readCreateString("affectedVersion"),fixedVersion:readCreateString("fixedVersion"),component:readCreateString("component"),regression:commandOptions.regression===true?"true":readCreateString("regression"),customerImpact:readCreateString("customerImpact"),dep:readCreateList("dep"),comment:readCreateList("comment"),note:readCreateList("note"),learning:readCreateList("learning"),file:readCreateList("file"),test:readCreateList("test"),doc:readCreateList("doc"),reminder:readCreateList("reminder"),event:readCreateList("event"),typeOption:readCreateList("typeOption"),field:readCreateList("field"),unset:readCreateList("unset"),clearDeps:optionTrue(commandOptions,"clearDeps"),clearComments:optionTrue(commandOptions,"clearComments"),clearNotes:optionTrue(commandOptions,"clearNotes"),clearLearnings:optionTrue(commandOptions,"clearLearnings"),clearFiles:optionTrue(commandOptions,"clearFiles"),clearTests:optionTrue(commandOptions,"clearTests"),clearDocs:optionTrue(commandOptions,"clearDocs"),clearReminders:optionTrue(commandOptions,"clearReminders"),clearEvents:optionTrue(commandOptions,"clearEvents"),clearTypeOptions:optionTrue(commandOptions,"clearTypeOptions")};copyUnknownOptions(normalized,commandOptions);return normalized}function normalizeUpdateOptions(commandOptions){const readUpdateString=target=>readFirstStringFromCommanderOptions(commandOptions,resolveCommanderContract(UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,target));const readUpdateList=target=>readStringArrayFromCommanderOptions(commandOptions,resolveCommanderContract(UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,target));const normalized={title:readUpdateString("title"),description:readUpdateString("description"),body:readUpdateString("body"),status:readUpdateString("status"),closeReason:readUpdateString("closeReason"),priority:readUpdateString("priority"),type:readUpdateString("type"),tags:readUpdateString("tags"),addTags:readUpdateList("addTags"),removeTags:readUpdateList("removeTags"),deadline:readUpdateString("deadline"),estimatedMinutes:readUpdateString("estimatedMinutes"),acceptanceCriteria:readJoinedRepeatedOption(commandOptions,resolveCommanderContract(UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,"acceptanceCriteria")),addAc:readUpdateList("addAc"),removeAc:readUpdateList("removeAc"),definitionOfReady:readUpdateString("definitionOfReady"),order:readUpdateString("order"),rank:readUpdateString("rank"),goal:readUpdateString("goal"),objective:readUpdateString("objective"),value:readUpdateString("value"),impact:readUpdateString("impact"),outcome:readUpdateString("outcome"),whyNow:readUpdateString("whyNow"),author:readUpdateString("author"),message:readUpdateString("message"),force:Boolean(commandOptions.force),ownershipMetadataBypass:commandOptions.ownershipMetadataBypass===true?true:void 0,ownershipDependencyBypass:commandOptions.ownershipDependencyBypass===true?true:void 0,assignee:readUpdateString("assignee"),parent:readUpdateString("parent"),allowUnresolvedDeps:anyOptionTrue(commandOptions,["allowUnresolvedDeps","allow_unresolved_deps"])===true,reviewer:readUpdateString("reviewer"),risk:readUpdateString("risk"),confidence:readUpdateString("confidence"),sprint:readUpdateString("sprint"),release:readUpdateString("release"),blockedBy:readUpdateString("blockedBy"),blockedReason:readUpdateString("blockedReason"),unblockNote:readUpdateString("unblockNote"),reporter:readUpdateString("reporter"),severity:readUpdateString("severity"),environment:readUpdateString("environment"),reproSteps:readUpdateString("reproSteps"),resolution:readUpdateString("resolution"),expectedResult:readUpdateString("expectedResult"),actualResult:readUpdateString("actualResult"),affectedVersion:readUpdateString("affectedVersion"),fixedVersion:readUpdateString("fixedVersion"),component:readUpdateString("component"),regression:commandOptions.regression===true?"true":readUpdateString("regression"),customerImpact:readUpdateString("customerImpact"),dep:readUpdateList("dep"),depRemove:readUpdateList("depRemove"),replaceDeps:optionTrue(commandOptions,"replaceDeps"),replaceTests:optionTrue(commandOptions,"replaceTests"),replaceFiles:optionTrue(commandOptions,"replaceFiles"),replaceDocs:optionTrue(commandOptions,"replaceDocs"),comment:readUpdateList("comment"),note:readUpdateList("note"),learning:readUpdateList("learning"),file:readUpdateList("file"),test:readUpdateList("test"),doc:readUpdateList("doc"),reminder:readUpdateList("reminder"),event:readUpdateList("event"),typeOption:readUpdateList("typeOption"),field:readUpdateList("field"),unset:readUpdateList("unset"),clearDeps:optionTrue(commandOptions,"clearDeps"),clearComments:optionTrue(commandOptions,"clearComments"),clearNotes:optionTrue(commandOptions,"clearNotes"),clearLearnings:optionTrue(commandOptions,"clearLearnings"),clearFiles:optionTrue(commandOptions,"clearFiles"),clearTests:optionTrue(commandOptions,"clearTests"),clearDocs:optionTrue(commandOptions,"clearDocs"),clearReminders:optionTrue(commandOptions,"clearReminders"),clearEvents:optionTrue(commandOptions,"clearEvents"),clearTypeOptions:optionTrue(commandOptions,"clearTypeOptions")};copyUnknownOptions(normalized,commandOptions);return normalized}const UPDATE_MANY_CONTROL_OPTION_KEYS=new Set(["filterStatus","filterType","filterTag","filterPriority","filterDeadlineBefore","filterDeadlineAfter","filterUpdatedAfter","filterUpdatedBefore","filterCreatedAfter","filterCreatedBefore","filterAssignee","filterAssigneeFilter","filterAssignee_filter","filterParent","filterSprint","filterRelease","filterAcMissing","filterEstimatesMissing","filterEstimateMissing","filterResolutionMissing","filterMetadataMissing","filterReviewerMissing","filterRiskMissing","filterConfidenceMissing","filterSprintMissing","filterReleaseMissing","filterHasNotes","filterNoNotes","filterHasLearnings","filterNoLearnings","filterHasFiles","filterNoFiles","filterHasDocs","filterNoDocs","filterHasTests","filterNoTests","filterHasComments","filterNoComments","filterHasDeps","filterNoDeps","filterHasBody","filterEmptyBody","filterHasLinkedCommand","filterNoLinkedCommand","ids","limit","offset","dryRun","rollback","checkpoint"]);function extractUpdateManyMutationOptionSource(commandOptions){const mutationOptions={};for(const[key,value]of Object.entries(commandOptions)){if(UPDATE_MANY_CONTROL_OPTION_KEYS.has(key)){continue}mutationOptions[key]=value}return mutationOptions}function readListOptionString(options,target){const contract=resolveCommanderContract(LIST_COMMANDER_STRING_OPTION_CONTRACTS,target);const stringValue=readFirstStringFromCommanderOptions(options,contract);if(stringValue!==void 0){return stringValue}for(const key of contract.keys){const value=options[key];if(Array.isArray(value)){const strings=value.filter(entry=>typeof entry==="string");if(strings.length>0){return strings.join(",")}}if(target==="ids"&&typeof value==="string"){return value}if(typeof value==="number"&&Number.isFinite(value)){return String(value)}}return void 0}function readSelectionFilterOptionFields(options){const filterFilesMissing=optionTrue(options,"filterFilesMissing");const filterDocsMissing=optionTrue(options,"filterDocsMissing");return{filterReviewerMissing:optionTrue(options,"filterReviewerMissing"),filterRiskMissing:optionTrue(options,"filterRiskMissing"),filterConfidenceMissing:optionTrue(options,"filterConfidenceMissing"),filterSprintMissing:optionTrue(options,"filterSprintMissing"),filterReleaseMissing:optionTrue(options,"filterReleaseMissing"),hasNotes:optionTrue(options,"hasNotes"),hasLearnings:optionTrue(options,"hasLearnings"),hasFiles:optionTrue(options,"hasFiles"),hasDocs:optionTrue(options,"hasDocs"),hasTests:optionTrue(options,"hasTests"),hasComments:optionTrue(options,"hasComments"),hasDeps:optionTrue(options,"hasDeps"),hasBody:optionTrue(options,"hasBody"),hasLinkedCommand:optionTrue(options,"hasLinkedCommand"),noNotes:optionFalse(options,"notes"),noLearnings:optionFalse(options,"learnings"),noFiles:optionFalse(options,"files")??filterFilesMissing,filterFilesMissing,noDocs:optionFalse(options,"docs")??filterDocsMissing,filterDocsMissing,noTests:optionFalse(options,"tests"),noComments:optionFalse(options,"comments"),noDeps:optionFalse(options,"deps"),emptyBody:optionTrue(options,"emptyBody"),noLinkedCommand:optionFalse(options,"linkedCommand")}}function normalizeListOptions(options){const normalized={status:readListOptionString(options,"status"),type:readListOptionString(options,"type"),tag:readListOptionString(options,"tag"),priority:readListOptionString(options,"priority"),deadlineBefore:readListOptionString(options,"deadlineBefore"),deadlineAfter:readListOptionString(options,"deadlineAfter"),updatedAfter:readListOptionString(options,"updatedAfter"),updatedBefore:readListOptionString(options,"updatedBefore"),createdAfter:readListOptionString(options,"createdAfter"),createdBefore:readListOptionString(options,"createdBefore"),today:optionTrue(options,"today"),recent:optionTrue(options,"recent"),ids:readListOptionString(options,"ids"),assignee:readListOptionString(options,"assignee"),assigneeFilter:readListOptionString(options,"assigneeFilter"),parent:readListOptionString(options,"parent"),sprint:readListOptionString(options,"sprint"),release:readListOptionString(options,"release"),limit:readListOptionString(options,"limit"),offset:readListOptionString(options,"offset"),noTruncate:optionFalse(options,"truncate"),includeBody:optionTrue(options,"includeBody"),strictRead:optionTrue(options,"strictRead"),compact:optionTrue(options,"compact"),brief:optionTrue(options,"brief"),full:optionTrue(options,"full"),fields:readListOptionString(options,"fields"),sort:readListOptionString(options,"sort"),order:readListOptionString(options,"order"),tree:optionTrue(options,"tree"),treeDepth:readListOptionString(options,"treeDepth"),filterAcMissing:optionTrue(options,"filterAcMissing"),filterEstimatesMissing:anyOptionTrue(options,["filterEstimatesMissing","filterEstimateMissing"]),filterResolutionMissing:optionTrue(options,"filterResolutionMissing"),filterMetadataMissing:optionTrue(options,"filterMetadataMissing"),...readSelectionFilterOptionFields(options)};copyUnknownOptions(normalized,options);return normalized}function normalizeAggregateOptions(options){return{groupBy:typeof options.groupBy==="string"?options.groupBy:void 0,setMode:typeof options.setMode==="string"?options.setMode:void 0,limit:readListOptionString(options,"limit"),after:readListOptionString(options,"after"),count:options.count===true?true:void 0,completion:options.completion===true?true:void 0,sum:typeof options.sum==="string"?options.sum:void 0,avg:typeof options.avg==="string"?options.avg:void 0,includeUnparented:options.includeUnparented===true||options.include_unparented===true,status:typeof options.status==="string"?options.status:void 0,type:readListOptionString(options,"type"),tag:readListOptionString(options,"tag"),priority:readListOptionString(options,"priority"),deadlineBefore:readListOptionString(options,"deadlineBefore"),deadlineAfter:readListOptionString(options,"deadlineAfter"),assignee:readListOptionString(options,"assignee"),assigneeFilter:readListOptionString(options,"assigneeFilter"),parent:readListOptionString(options,"parent"),sprint:readListOptionString(options,"sprint"),release:readListOptionString(options,"release")}}function printListJsonStream(commandName,result,globalOptions){setActiveCommandResult(result);if(globalOptions.quiet){return}const warnings=Array.isArray(result.warnings)?result.warnings:[];const metaPayload={type:"meta",command:commandName,count:result.count,now:result.now,filters:result.filters};if(warnings.length>0){metaPayload.warnings=warnings}if(!writeStdout(`${JSON.stringify(metaPayload)}
|
|
2
|
+
`)){return}for(const item of result.items){if(!writeStdout(`${JSON.stringify({type:"item",command:commandName,item})}
|
|
3
|
+
`)){return}}writeStdout(`${JSON.stringify({type:"end",command:commandName,count:result.count})}
|
|
4
|
+
`)}function printActivityJsonStream(result,options,globalOptions){setActiveCommandResult(result);if(globalOptions.quiet){return}const metaPayload={type:"meta",command:"activity",count:result.count,filters:{id:options.id??null,op:options.op??null,author:options.author??null,from:options.from??null,to:options.to??null,limit:options.limit??null}};if(!writeStdout(`${JSON.stringify(metaPayload)}
|
|
5
|
+
`)){return}const entries=result.compact&&result.compact_activity?result.compact_activity:result.activity??[];for(const entry of entries){if(!writeStdout(`${JSON.stringify({type:"entry",command:"activity",entry})}
|
|
6
|
+
`)){return}}writeStdout(`${JSON.stringify({type:"end",command:"activity",count:result.count})}
|
|
7
|
+
`)}function normalizeSearchOptions(options){const readSearchString=target=>readFirstStringFromCommanderOptions(options,resolveCommanderContract(SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,target));const readSearchStringOrNumber=target=>{const candidate=readFirstValueFromCommanderOptions(options,resolveCommanderContract(SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,target));if(typeof candidate==="string"){return candidate}if(typeof candidate==="number"&&Number.isFinite(candidate)){return candidate}return void 0};const fields=readSearchString("fields");const compactRequested=options.compact===true;const fullRequested=options.full===true;const defaultCompact=!compactRequested&&!fullRequested&&fields===void 0;const mode=options.semantic===true?"semantic":options.hybrid===true?"hybrid":readSearchString("mode");const normalized={mode,matchMode:readSearchString("matchMode"),minScore:readSearchStringOrNumber("minScore"),count:optionTrue(options,"count"),semanticWeight:readSearchStringOrNumber("semanticWeight"),includeLinked:optionTrue(options,"includeLinked"),titleExact:optionTrue(options,"titleExact"),phraseExact:optionTrue(options,"phraseExact"),highlight:optionTrue(options,"highlight"),status:readSearchString("status"),type:readSearchString("type"),tag:readSearchString("tag"),priority:readSearchString("priority"),deadlineBefore:readSearchString("deadlineBefore"),deadlineAfter:readSearchString("deadlineAfter"),updatedAfter:readSearchString("updatedAfter"),updatedBefore:readSearchString("updatedBefore"),createdAfter:readSearchString("createdAfter"),createdBefore:readSearchString("createdBefore"),assignee:readSearchString("assignee"),sprint:readSearchString("sprint"),release:readSearchString("release"),parent:readSearchString("parent"),limit:readSearchString("limit"),fields,compact:compactRequested||defaultCompact?true:void 0,full:optionTrue(options,"full"),...readSelectionFilterOptionFields(options)};copyUnknownOptions(normalized,options);return normalized}function normalizeSearchKeywordsInput(keywords){const query=keywords.map(entry=>entry.trim()).filter(entry=>entry.length>0).join(" ");if(query.length===0){throw new PmCliError("Search query must not be empty",EXIT_CODE.USAGE)}return query}function normalizeActivityOptions(options){const readActivityString=target=>readFirstStringFromCommanderOptions(options,resolveCommanderContract(ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,target));const normalized={id:readActivityString("id"),op:readActivityString("op"),author:readActivityString("author"),from:readActivityString("from"),to:readActivityString("to"),limit:readActivityString("limit"),compact:options.full===true||options.provenance===true?false:options.compact===true||options.raw===true?true:void 0,...options.raw===true||options.compact===true||options.full===true?{raw:true}:{},unbounded:optionTrue(options,"unbounded"),provenance:optionTrue(options,"provenance"),provenanceSummary:optionTrue(options,"provenanceSummary"),harness:Array.isArray(options.harness)?options.harness:void 0,agentInstance:Array.isArray(options.agentInstance)?options.agentInstance:void 0,provenanceFilter:Array.isArray(options.provenanceFilter)?options.provenanceFilter:void 0};return Object.fromEntries(Object.entries(normalized).filter(([,value])=>value!==void 0))}const ACTIVITY_STREAM_ENABLED_VALUES=new Set(["","rows","ndjson","jsonl","true","1","yes","on"]);const ACTIVITY_STREAM_DISABLED_VALUES=new Set(["false","off","none","0"]);function resolveActivityStreamMode(raw){if(raw===true){return true}if(raw===false||raw===void 0||raw===null){return false}if(typeof raw==="string"){const normalized=raw.trim().toLowerCase();if(ACTIVITY_STREAM_ENABLED_VALUES.has(normalized)){return true}if(ACTIVITY_STREAM_DISABLED_VALUES.has(normalized)){return false}}throw new PmCliError("Activity --stream accepts rows|ndjson|jsonl (or no value)",EXIT_CODE.USAGE)}function normalizeContextOptions(options){const readContextString=target=>readFirstStringFromCommanderOptions(options,resolveCommanderContract(CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,target));const readContextStringOrNumber=target=>readStringOrFiniteNumberFromCommanderOptions(options,resolveCommanderContract(CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,target));const sectionRaw=options.section;const section=Array.isArray(sectionRaw)?sectionRaw.filter(v=>typeof v==="string"&&v.trim().length>0):typeof sectionRaw==="string"&§ionRaw.trim().length>0?[sectionRaw]:void 0;const normalized={date:readContextString("date"),from:readContextString("from"),to:readContextString("to"),past:options.past===true?true:void 0,type:readContextString("type"),tag:readContextString("tag"),priority:readContextString("priority"),assignee:readContextString("assignee"),assigneeFilter:readContextString("assigneeFilter"),sprint:readContextString("sprint"),release:readContextString("release"),parent:readContextString("parent"),limit:readContextString("limit"),format:readContextString("format"),depth:readContextString("depth"),fields:readContextString("fields"),section:section&§ion.length>0?section:void 0,activityLimit:readContextString("activityLimit"),staleThreshold:readContextString("staleThreshold"),tokenBudget:readContextStringOrNumber("tokenBudget"),noExtensionHealth:options.extensionHealth===false?true:void 0,noTags:options.tags===false?true:void 0};for(const[key,value]of Object.entries(options)){if(Object.hasOwn(normalized,key)){continue}normalized[key]=value}return normalized}function normalizeNextOptions(options){const readNextString=target=>readFirstStringFromCommanderOptions(options,resolveCommanderContract(NEXT_COMMANDER_STRING_OPTION_CONTRACTS,target));const readNextStringOrNumber=target=>readStringOrFiniteNumberFromCommanderOptions(options,resolveCommanderContract(NEXT_COMMANDER_STRING_OPTION_CONTRACTS,target));const normalized={type:readNextString("type"),tag:readNextString("tag"),priority:readNextStringOrNumber("priority"),assignee:readNextString("assignee"),assigneeFilter:readNextString("assigneeFilter"),sprint:readNextString("sprint"),release:readNextString("release"),parent:readNextString("parent"),limit:readNextString("limit"),blockedLimit:readNextString("blockedLimit"),readyOnly:options.readyOnly===true||options.ready_only===true?true:void 0,format:readNextString("format"),tokenBudget:readNextStringOrNumber("tokenBudget")};for(const[key,value]of Object.entries(options)){if(Object.hasOwn(normalized,key)){continue}normalized[key]=value}return normalized}function collectMutationItemIds(result){if(!result||typeof result!=="object"){return[]}const record=result;const ids=new Set;const pushId=value=>{if(typeof value!=="string"){return}const normalized=value.trim();if(normalized.length===0){return}ids.add(normalized)};pushId(record.id);const item=record.item;if(item&&typeof item==="object"){pushId(item.id)}const explicitIds=record.ids;if(Array.isArray(explicitIds)){for(const candidate of explicitIds){pushId(candidate)}}const items=record.items;if(Array.isArray(items)){for(const candidate of items){if(!candidate||typeof candidate!=="object"){continue}pushId(candidate.id)}}return[...ids].sort((left,right)=>left.localeCompare(right))}async function invalidateSearchCachesForMutation(globalOptions,result){const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path);const refreshResult=await refreshSearchArtifactsForMutation(pmRoot,collectMutationItemIds(result),{background:!shouldRunSearchRefreshInForeground()});if(globalOptions.profile&&refreshResult.warnings.length>0){printError(`profile:search_refresh_warnings=${formatHookWarnings(refreshResult.warnings)}`)}}const _testOnly={collectMutationItemIds};export{_testOnly,addHiddenOption,addHiddenOptions,applyActiveCommandResultService,applyDefaultOutputFormat,buildBackgroundTestAllCommandArgs,buildBackgroundTestCommandArgs,clearResolvedGlobalOptions,collect,extractUpdateManyMutationOptionSource,formatHookWarnings,getCommandPath,getGlobalOptions,invalidateSearchCachesForMutation,normalizeActivityOptions,normalizeAggregateOptions,normalizeContextOptions,normalizeCreateOptions,normalizeListOptions,normalizeNextOptions,normalizeSearchKeywordsInput,normalizeSearchOptions,normalizeUpdateOptions,printActivityJsonStream,printError,printListJsonStream,printResult,readOptionString,resolveActivityStreamMode,setActiveCommandResult,setResolvedGlobalOptions,syncCommanderActionOptions,writeStdout};
|
|
990
8
|
//# sourceMappingURL=registration-helpers.js.map
|
|
991
|
-
//# debugId=01742f33-d1e8-5684-a585-2add88ddb73c
|