@unbrained/pm-cli 2026.9.7 → 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 +211 -181
- 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/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,391 +1,2 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @module cli/commands/aggregate
|
|
3
|
-
*
|
|
4
|
-
* Implements the pm aggregate command surface and its agent-facing runtime behavior.
|
|
5
|
-
*/
|
|
6
|
-
|
|
7
|
-
!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="56486369-9164-58d3-ac34-46d57859f96d")}catch(e){}}();
|
|
8
|
-
import { EXIT_CODE, PmCliError, splitCommaList, nowIso, normalizeStatusInput, parseStatusFilterCsv, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
|
|
9
|
-
import { buildListQueryFilters } from "./list-filter-shared.js";
|
|
10
|
-
import { runList } from "./list.js";
|
|
11
|
-
const AGGREGATE_GROUP_FIELDS = [
|
|
12
|
-
"parent",
|
|
13
|
-
"type",
|
|
14
|
-
"priority",
|
|
15
|
-
"status",
|
|
16
|
-
"assignee",
|
|
17
|
-
"tags",
|
|
18
|
-
"sprint",
|
|
19
|
-
"release",
|
|
20
|
-
];
|
|
21
|
-
function parseStatus(raw, statusRegistry) {
|
|
22
|
-
const statuses = parseStatusFilterCsv(raw, statusRegistry, {
|
|
23
|
-
strict: true,
|
|
24
|
-
flagLabel: "--status",
|
|
25
|
-
});
|
|
26
|
-
if (!statuses || statuses.length === 0) {
|
|
27
|
-
return undefined;
|
|
28
|
-
}
|
|
29
|
-
return statuses;
|
|
30
|
-
}
|
|
31
|
-
function parseNumericAggregation(options, allowedFields = ["estimate", "estimated_minutes", "priority"]) {
|
|
32
|
-
const sumField = options.sum?.trim();
|
|
33
|
-
const avgField = options.avg?.trim();
|
|
34
|
-
const normalizedSum = sumField && sumField.length > 0 ? sumField : undefined;
|
|
35
|
-
const normalizedAvg = avgField && avgField.length > 0 ? avgField : undefined;
|
|
36
|
-
if (!normalizedSum && !normalizedAvg) {
|
|
37
|
-
return null;
|
|
38
|
-
}
|
|
39
|
-
if (normalizedSum && normalizedAvg && normalizedSum !== normalizedAvg) {
|
|
40
|
-
throw new PmCliError("Aggregate --sum and --avg must target the same numeric field", EXIT_CODE.USAGE);
|
|
41
|
-
}
|
|
42
|
-
const field = normalizedSum ?? normalizedAvg;
|
|
43
|
-
if (!allowedFields.includes(field)) {
|
|
44
|
-
throw new PmCliError(`Aggregate numeric field "${field}" is not registered. Allowed: ${allowedFields.join(", ")}`, EXIT_CODE.USAGE);
|
|
45
|
-
}
|
|
46
|
-
return {
|
|
47
|
-
field,
|
|
48
|
-
sum: normalizedSum !== undefined,
|
|
49
|
-
avg: normalizedAvg !== undefined,
|
|
50
|
-
};
|
|
51
|
-
}
|
|
52
|
-
function parseGroupBy(raw) {
|
|
53
|
-
const value = raw?.trim() ?? "status";
|
|
54
|
-
if (value.length === 0) {
|
|
55
|
-
throw new PmCliError("--group-by requires at least one field name", EXIT_CODE.USAGE);
|
|
56
|
-
}
|
|
57
|
-
const requested = splitCommaList(value);
|
|
58
|
-
if (requested.length === 0) {
|
|
59
|
-
throw new PmCliError("--group-by requires a comma-separated list of fields", EXIT_CODE.USAGE);
|
|
60
|
-
}
|
|
61
|
-
for (const field of requested) {
|
|
62
|
-
if (!AGGREGATE_GROUP_FIELDS.includes(field)) {
|
|
63
|
-
throw new PmCliError(`Aggregate group fields must be one of ${AGGREGATE_GROUP_FIELDS.join("|")}; received "${field}"`, EXIT_CODE.USAGE);
|
|
64
|
-
}
|
|
65
|
-
}
|
|
66
|
-
return requested;
|
|
67
|
-
}
|
|
68
|
-
function normalizeTagGroupValue(tags) {
|
|
69
|
-
const normalized = [
|
|
70
|
-
...new Set(tags
|
|
71
|
-
.map((tag) => tag.trim().toLowerCase())
|
|
72
|
-
.filter((tag) => tag.length > 0)),
|
|
73
|
-
].sort((left, right) => left.localeCompare(right));
|
|
74
|
-
if (normalized.length === 0) {
|
|
75
|
-
return null;
|
|
76
|
-
}
|
|
77
|
-
return normalized.join(",");
|
|
78
|
-
}
|
|
79
|
-
function resolveGroupValue(field, item) {
|
|
80
|
-
switch (field) {
|
|
81
|
-
case "parent":
|
|
82
|
-
return item.parent ?? null;
|
|
83
|
-
case "type":
|
|
84
|
-
return item.type;
|
|
85
|
-
case "priority":
|
|
86
|
-
return item.priority;
|
|
87
|
-
case "status":
|
|
88
|
-
return item.status;
|
|
89
|
-
case "assignee":
|
|
90
|
-
return item.assignee ?? null;
|
|
91
|
-
case "tags":
|
|
92
|
-
return normalizeTagGroupValue(item.tags);
|
|
93
|
-
case "sprint":
|
|
94
|
-
return item.sprint ?? null;
|
|
95
|
-
case "release":
|
|
96
|
-
return item.release ?? null;
|
|
97
|
-
default:
|
|
98
|
-
return null;
|
|
99
|
-
}
|
|
100
|
-
}
|
|
101
|
-
function compareNullableGroupValue(left, right) {
|
|
102
|
-
const leftValue = left ?? null;
|
|
103
|
-
const rightValue = right ?? null;
|
|
104
|
-
if (leftValue === rightValue) {
|
|
105
|
-
return 0;
|
|
106
|
-
}
|
|
107
|
-
if (leftValue === null) {
|
|
108
|
-
return 1;
|
|
109
|
-
}
|
|
110
|
-
if (rightValue === null) {
|
|
111
|
-
return -1;
|
|
112
|
-
}
|
|
113
|
-
if (typeof leftValue === "number" && typeof rightValue === "number") {
|
|
114
|
-
return leftValue - rightValue;
|
|
115
|
-
}
|
|
116
|
-
return String(leftValue).localeCompare(String(rightValue));
|
|
117
|
-
}
|
|
118
|
-
function buildGroupKey(groupBy, group) {
|
|
119
|
-
return groupBy
|
|
120
|
-
.map((field) => `${field}:${JSON.stringify(group[field] ?? null)}`)
|
|
121
|
-
.join("|");
|
|
122
|
-
}
|
|
123
|
-
/** Explicit display label for an empty/blank group value, keyed by dimension. */
|
|
124
|
-
const EMPTY_AGGREGATE_GROUP_LABELS = {
|
|
125
|
-
parent: "(unparented)",
|
|
126
|
-
type: "(untyped)",
|
|
127
|
-
priority: "(no priority)",
|
|
128
|
-
status: "(no status)",
|
|
129
|
-
assignee: "(unassigned)",
|
|
130
|
-
tags: "(untagged)",
|
|
131
|
-
sprint: "(no sprint)",
|
|
132
|
-
release: "(no release)",
|
|
133
|
-
};
|
|
134
|
-
/** Render a single group field's value, substituting an explicit label for null. */
|
|
135
|
-
function formatGroupFieldLabel(field, value) {
|
|
136
|
-
if (value === null || value === undefined || value === "") {
|
|
137
|
-
return EMPTY_AGGREGATE_GROUP_LABELS[field];
|
|
138
|
-
}
|
|
139
|
-
return String(value);
|
|
140
|
-
}
|
|
141
|
-
/** Build the human-readable label for an aggregate row. Single-field grouping yields the bare (possibly substituted) value; multi-field grouping joins each "field=value" pair so composite groups stay unambiguous. */
|
|
142
|
-
function buildGroupLabel(groupBy, group) {
|
|
143
|
-
if (groupBy.length === 1) {
|
|
144
|
-
return formatGroupFieldLabel(groupBy[0], group[groupBy[0]]);
|
|
145
|
-
}
|
|
146
|
-
return groupBy
|
|
147
|
-
.map((field) => `${field}=${formatGroupFieldLabel(field, group[field])}`)
|
|
148
|
-
.join(" | ");
|
|
149
|
-
}
|
|
150
|
-
function compareAggregateRows(left, right, groupBy) {
|
|
151
|
-
for (const field of groupBy) {
|
|
152
|
-
const byField = compareNullableGroupValue(left.group[field], right.group[field]);
|
|
153
|
-
if (byField !== 0) {
|
|
154
|
-
return byField;
|
|
155
|
-
}
|
|
156
|
-
}
|
|
157
|
-
return 0;
|
|
158
|
-
}
|
|
159
|
-
function readNumericAggregateValue(item, field) {
|
|
160
|
-
const source = item;
|
|
161
|
-
const raw = source[field];
|
|
162
|
-
if (typeof raw === "number" && Number.isFinite(raw)) {
|
|
163
|
-
return raw;
|
|
164
|
-
}
|
|
165
|
-
if (typeof raw === "string") {
|
|
166
|
-
const trimmed = raw.trim();
|
|
167
|
-
if (trimmed.length === 0) {
|
|
168
|
-
return null;
|
|
169
|
-
}
|
|
170
|
-
const parsed = Number(trimmed);
|
|
171
|
-
if (Number.isFinite(parsed)) {
|
|
172
|
-
return parsed;
|
|
173
|
-
}
|
|
174
|
-
}
|
|
175
|
-
return null;
|
|
176
|
-
}
|
|
177
|
-
function completionPct(closed, total) {
|
|
178
|
-
if (total <= 0) {
|
|
179
|
-
return 0;
|
|
180
|
-
}
|
|
181
|
-
return Math.round((closed / total) * 10000) / 100;
|
|
182
|
-
}
|
|
183
|
-
function updateCompletionCounts(accumulator, status, statusRegistry) {
|
|
184
|
-
const normalizedStatus = normalizeStatusInput(String(status), statusRegistry) ?? status;
|
|
185
|
-
if (normalizedStatus === statusRegistry.open_status) {
|
|
186
|
-
accumulator.open_count += 1;
|
|
187
|
-
return;
|
|
188
|
-
}
|
|
189
|
-
if (normalizedStatus === "in_progress" ||
|
|
190
|
-
(statusRegistry.active_statuses.has(normalizedStatus) &&
|
|
191
|
-
normalizedStatus !== statusRegistry.open_status)) {
|
|
192
|
-
accumulator.in_progress_count += 1;
|
|
193
|
-
return;
|
|
194
|
-
}
|
|
195
|
-
if (statusRegistry.terminal_done_statuses.has(normalizedStatus) ||
|
|
196
|
-
normalizedStatus === statusRegistry.close_status) {
|
|
197
|
-
accumulator.closed_count += 1;
|
|
198
|
-
return;
|
|
199
|
-
}
|
|
200
|
-
accumulator.other_count += 1;
|
|
201
|
-
}
|
|
202
|
-
function createAggregateAccumulator(group, numericValue) {
|
|
203
|
-
return {
|
|
204
|
-
row: {
|
|
205
|
-
group,
|
|
206
|
-
count: 1,
|
|
207
|
-
},
|
|
208
|
-
numeric_count: numericValue === null ? 0 : 1,
|
|
209
|
-
numeric_sum: numericValue ?? 0,
|
|
210
|
-
null_count: numericValue === null ? 1 : 0,
|
|
211
|
-
open_count: 0,
|
|
212
|
-
in_progress_count: 0,
|
|
213
|
-
closed_count: 0,
|
|
214
|
-
other_count: 0,
|
|
215
|
-
};
|
|
216
|
-
}
|
|
217
|
-
function updateNumericAggregation(accumulator, numericValue) {
|
|
218
|
-
if (numericValue === null) {
|
|
219
|
-
accumulator.null_count += 1;
|
|
220
|
-
return;
|
|
221
|
-
}
|
|
222
|
-
accumulator.numeric_count += 1;
|
|
223
|
-
accumulator.numeric_sum += numericValue;
|
|
224
|
-
}
|
|
225
|
-
function updateAggregateAccumulator(params) {
|
|
226
|
-
params.accumulator.row.count += 1;
|
|
227
|
-
if (params.includeCompletion) {
|
|
228
|
-
updateCompletionCounts(params.accumulator, params.item.status, params.statusRegistry);
|
|
229
|
-
}
|
|
230
|
-
if (params.numericAggregation !== null) {
|
|
231
|
-
updateNumericAggregation(params.accumulator, params.numericValue);
|
|
232
|
-
}
|
|
233
|
-
}
|
|
234
|
-
function buildAggregateGroup(groupBy, item) {
|
|
235
|
-
const group = {};
|
|
236
|
-
for (const field of groupBy) {
|
|
237
|
-
group[field] = resolveGroupValue(field, item);
|
|
238
|
-
}
|
|
239
|
-
return group;
|
|
240
|
-
}
|
|
241
|
-
function finalizeAggregateRow(entry, groupBy, includeCompletion, numericAggregation) {
|
|
242
|
-
const row = {
|
|
243
|
-
...entry.row,
|
|
244
|
-
group_label: buildGroupLabel(groupBy, entry.row.group),
|
|
245
|
-
};
|
|
246
|
-
if (includeCompletion) {
|
|
247
|
-
row.open = entry.open_count;
|
|
248
|
-
row.in_progress = entry.in_progress_count;
|
|
249
|
-
row.closed = entry.closed_count;
|
|
250
|
-
row.other = entry.other_count;
|
|
251
|
-
row.completion_pct = completionPct(entry.closed_count, entry.row.count);
|
|
252
|
-
}
|
|
253
|
-
if (numericAggregation !== null) {
|
|
254
|
-
row.null_count = entry.null_count;
|
|
255
|
-
if (numericAggregation.sum) {
|
|
256
|
-
row.sum = entry.numeric_sum;
|
|
257
|
-
}
|
|
258
|
-
if (numericAggregation.avg) {
|
|
259
|
-
row.avg =
|
|
260
|
-
entry.numeric_count === 0
|
|
261
|
-
? null
|
|
262
|
-
: entry.numeric_sum / entry.numeric_count;
|
|
263
|
-
}
|
|
264
|
-
}
|
|
265
|
-
return row;
|
|
266
|
-
}
|
|
267
|
-
function buildAggregateFilters(params) {
|
|
268
|
-
return {
|
|
269
|
-
group_by: params.groupBy,
|
|
270
|
-
count: true,
|
|
271
|
-
completion: params.includeCompletion,
|
|
272
|
-
include_unparented: params.includeUnparented,
|
|
273
|
-
status: params.status?.[0] ?? null,
|
|
274
|
-
status_values: params.status,
|
|
275
|
-
type: params.options.type ?? null,
|
|
276
|
-
tag: params.options.tag ?? null,
|
|
277
|
-
priority: params.options.priority ?? null,
|
|
278
|
-
deadline_before: params.options.deadlineBefore ?? null,
|
|
279
|
-
deadline_after: params.options.deadlineAfter ?? null,
|
|
280
|
-
assignee: params.options.assignee ?? null,
|
|
281
|
-
assignee_filter: params.options.assigneeFilter ?? null,
|
|
282
|
-
parent: params.options.parent ?? null,
|
|
283
|
-
sprint: params.options.sprint ?? null,
|
|
284
|
-
release: params.options.release ?? null,
|
|
285
|
-
...(params.numericAggregation !== null
|
|
286
|
-
? {
|
|
287
|
-
sum: params.options.sum ?? null,
|
|
288
|
-
avg: params.options.avg ?? null,
|
|
289
|
-
numeric_field: params.numericAggregation.field,
|
|
290
|
-
}
|
|
291
|
-
: {}),
|
|
292
|
-
};
|
|
293
|
-
}
|
|
294
|
-
/** Implements run aggregate for the public runtime surface of this module. */
|
|
295
|
-
export async function runAggregate(options, global) {
|
|
296
|
-
if (options.count === false) {
|
|
297
|
-
throw new PmCliError("Aggregate grouped counts are always enabled; omit count=false.", EXIT_CODE.USAGE);
|
|
298
|
-
}
|
|
299
|
-
const pmRoot = resolvePmRoot(process.cwd(), global.path);
|
|
300
|
-
const settings = await readSettings(pmRoot);
|
|
301
|
-
const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
|
|
302
|
-
const numericFields = [
|
|
303
|
-
"estimate",
|
|
304
|
-
"estimated_minutes",
|
|
305
|
-
"priority",
|
|
306
|
-
...resolveRuntimeFieldRegistry(settings.schema).definitions
|
|
307
|
-
.filter((definition) => definition.type === "number")
|
|
308
|
-
.map((definition) => definition.metadata_key),
|
|
309
|
-
];
|
|
310
|
-
const groupBy = parseGroupBy(options.groupBy);
|
|
311
|
-
const status = parseStatus(options.status, statusRegistry);
|
|
312
|
-
const numericAggregation = parseNumericAggregation(options, [...new Set(numericFields)].sort((left, right) => left.localeCompare(right)));
|
|
313
|
-
const includeCompletion = options.completion === true;
|
|
314
|
-
const includeUnparented = options.includeUnparented === true;
|
|
315
|
-
const listed = await runList(undefined, { ...buildListQueryFilters(options), status: options.status }, global);
|
|
316
|
-
const grouped = new Map();
|
|
317
|
-
let skippedUnparented = 0;
|
|
318
|
-
let groupedItemCount = 0;
|
|
319
|
-
for (const listedItem of listed.items) {
|
|
320
|
-
const item = listedItem;
|
|
321
|
-
const group = buildAggregateGroup(groupBy, item);
|
|
322
|
-
if (groupBy.includes("parent") &&
|
|
323
|
-
group.parent === null &&
|
|
324
|
-
!includeUnparented) {
|
|
325
|
-
skippedUnparented += 1;
|
|
326
|
-
continue;
|
|
327
|
-
}
|
|
328
|
-
const key = buildGroupKey(groupBy, group);
|
|
329
|
-
const existing = grouped.get(key);
|
|
330
|
-
const numericValue = numericAggregation === null
|
|
331
|
-
? null
|
|
332
|
-
: readNumericAggregateValue(item, numericAggregation.field);
|
|
333
|
-
if (existing) {
|
|
334
|
-
updateAggregateAccumulator({
|
|
335
|
-
accumulator: existing,
|
|
336
|
-
item,
|
|
337
|
-
statusRegistry,
|
|
338
|
-
includeCompletion,
|
|
339
|
-
numericAggregation,
|
|
340
|
-
numericValue,
|
|
341
|
-
});
|
|
342
|
-
}
|
|
343
|
-
else {
|
|
344
|
-
const accumulator = createAggregateAccumulator(group, numericValue);
|
|
345
|
-
if (includeCompletion) {
|
|
346
|
-
updateCompletionCounts(accumulator, item.status, statusRegistry);
|
|
347
|
-
}
|
|
348
|
-
grouped.set(key, accumulator);
|
|
349
|
-
}
|
|
350
|
-
groupedItemCount += 1;
|
|
351
|
-
}
|
|
352
|
-
const groups = [...grouped.values()]
|
|
353
|
-
.map((entry) => finalizeAggregateRow(entry, groupBy, includeCompletion, numericAggregation))
|
|
354
|
-
.sort((left, right) => compareAggregateRows(left, right, groupBy));
|
|
355
|
-
const warnings = listed.warnings && listed.warnings.length > 0 ? listed.warnings : undefined;
|
|
356
|
-
return {
|
|
357
|
-
groups,
|
|
358
|
-
count: groups.length,
|
|
359
|
-
totals: {
|
|
360
|
-
items_considered: listed.items.length,
|
|
361
|
-
items_grouped: groupedItemCount,
|
|
362
|
-
items_skipped_unparented: skippedUnparented,
|
|
363
|
-
},
|
|
364
|
-
filters: buildAggregateFilters({
|
|
365
|
-
groupBy,
|
|
366
|
-
includeCompletion,
|
|
367
|
-
includeUnparented,
|
|
368
|
-
status,
|
|
369
|
-
options,
|
|
370
|
-
numericAggregation,
|
|
371
|
-
}),
|
|
372
|
-
now: nowIso(),
|
|
373
|
-
...(warnings ? { warnings } : {}),
|
|
374
|
-
};
|
|
375
|
-
}
|
|
376
|
-
/** Public contract for test only aggregate command, shared by SDK and presentation-layer consumers. */
|
|
377
|
-
export const _testOnlyAggregateCommand = {
|
|
378
|
-
buildGroupKey,
|
|
379
|
-
compareAggregateRows,
|
|
380
|
-
compareNullableGroupValue,
|
|
381
|
-
completionPct,
|
|
382
|
-
normalizeTagGroupValue,
|
|
383
|
-
parseGroupBy,
|
|
384
|
-
parseNumericAggregation,
|
|
385
|
-
parseStatus,
|
|
386
|
-
readNumericAggregateValue,
|
|
387
|
-
resolveGroupValue,
|
|
388
|
-
updateCompletionCounts,
|
|
389
|
-
};
|
|
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]="7a4a98b2-3872-506d-b88d-877b0033dd2d")}catch(e2){}})();import{EXIT_CODE,PmCliError,splitCommaList,nowIso,normalizeStatusInput,parseStatusFilterCsv,resolveRuntimeFieldRegistry,resolveRuntimeStatusRegistry,resolvePmRoot,readSettings}from"../runtime-primitives.js";import{buildListQueryFilters}from"./list-filter-shared.js";import{runList}from"./list.js";import{parsePositiveInteger}from"../dependencies.js";const AGGREGATE_GROUP_FIELDS=["parent","type","priority","status","assignee","tags","sprint","release"];function parseStatus(raw,statusRegistry){const statuses=parseStatusFilterCsv(raw,statusRegistry,{strict:true,flagLabel:"--status"});if(!statuses||statuses.length===0){return void 0}return statuses}function parseNumericAggregation(options,allowedFields=["estimate","estimated_minutes","priority"]){const sumField=options.sum?.trim();const avgField=options.avg?.trim();const normalizedSum=sumField&&sumField.length>0?sumField:void 0;const normalizedAvg=avgField&&avgField.length>0?avgField:void 0;if(!normalizedSum&&!normalizedAvg){return null}if(normalizedSum&&normalizedAvg&&normalizedSum!==normalizedAvg){throw new PmCliError("Aggregate --sum and --avg must target the same numeric field",EXIT_CODE.USAGE)}const field=normalizedSum??normalizedAvg;if(!allowedFields.includes(field)){throw new PmCliError(`Aggregate numeric field "${field}" is not registered. Allowed: ${allowedFields.join(", ")}`,EXIT_CODE.USAGE)}return{field,sum:normalizedSum!==void 0,avg:normalizedAvg!==void 0}}function parseGroupBy(raw){const value=raw?.trim()??"status";if(value.length===0){throw new PmCliError("--group-by requires at least one field name",EXIT_CODE.USAGE)}const requested=splitCommaList(value);if(requested.length===0){throw new PmCliError("--group-by requires a comma-separated list of fields",EXIT_CODE.USAGE)}for(const field of requested){if(!AGGREGATE_GROUP_FIELDS.includes(field)){throw new PmCliError(`Aggregate group fields must be one of ${AGGREGATE_GROUP_FIELDS.join("|")}; received "${field}"`,EXIT_CODE.USAGE)}}return requested}function normalizeTagGroupValue(tags){const normalized=[...new Set(tags.map(tag=>tag.trim().toLowerCase()).filter(tag=>tag.length>0))].sort((left,right)=>left.localeCompare(right));if(normalized.length===0){return null}return normalized.join(",")}function resolveGroupValue(field,item){switch(field){case"parent":return item.parent??null;case"type":return item.type;case"priority":return item.priority;case"status":return item.status;case"assignee":return item.assignee??null;case"tags":return normalizeTagGroupValue(item.tags);case"sprint":return item.sprint??null;case"release":return item.release??null;default:return null}}function compareNullableGroupValue(left,right){const leftValue=left??null;const rightValue=right??null;if(leftValue===rightValue){return 0}if(leftValue===null){return 1}if(rightValue===null){return-1}if(typeof leftValue==="number"&&typeof rightValue==="number"){return leftValue-rightValue}return String(leftValue).localeCompare(String(rightValue))}function buildGroupKey(groupBy,group){return groupBy.map(field=>`${field}:${JSON.stringify(group[field]??null)}`).join("|")}const EMPTY_AGGREGATE_GROUP_LABELS={parent:"(unparented)",type:"(untyped)",priority:"(no priority)",status:"(no status)",assignee:"(unassigned)",tags:"(untagged)",sprint:"(no sprint)",release:"(no release)"};function formatGroupFieldLabel(field,value){if(value===null||value===void 0||value===""){return EMPTY_AGGREGATE_GROUP_LABELS[field]}return String(value)}function buildGroupLabel(groupBy,group){if(groupBy.length===1){return formatGroupFieldLabel(groupBy[0],group[groupBy[0]])}return groupBy.map(field=>`${field}=${formatGroupFieldLabel(field,group[field])}`).join(" | ")}function compareAggregateRows(left,right,groupBy){for(const field of groupBy){const byField=compareNullableGroupValue(left.group[field],right.group[field]);if(byField!==0){return byField}}return 0}function readNumericAggregateValue(item,field){const source=item;const raw=source[field];if(typeof raw==="number"&&Number.isFinite(raw)){return raw}if(typeof raw==="string"){const trimmed=raw.trim();if(trimmed.length===0){return null}const parsed=Number(trimmed);if(Number.isFinite(parsed)){return parsed}}return null}function completionPct(closed,total){if(total<=0){return 0}return Math.round(closed/total*1e4)/100}function updateCompletionCounts(accumulator,status,statusRegistry){const normalizedStatus=normalizeStatusInput(String(status),statusRegistry)??status;if(normalizedStatus===statusRegistry.open_status){accumulator.open_count+=1;return}if(normalizedStatus==="in_progress"||statusRegistry.active_statuses.has(normalizedStatus)&&normalizedStatus!==statusRegistry.open_status){accumulator.in_progress_count+=1;return}if(statusRegistry.terminal_done_statuses.has(normalizedStatus)||normalizedStatus===statusRegistry.close_status){accumulator.closed_count+=1;return}accumulator.other_count+=1}function createAggregateAccumulator(group,numericValue){return{row:{group,count:1},numeric_count:numericValue===null?0:1,numeric_sum:numericValue??0,null_count:numericValue===null?1:0,open_count:0,in_progress_count:0,closed_count:0,other_count:0}}function updateNumericAggregation(accumulator,numericValue){if(numericValue===null){accumulator.null_count+=1;return}accumulator.numeric_count+=1;accumulator.numeric_sum+=numericValue}function updateAggregateAccumulator(params){params.accumulator.row.count+=1;if(params.includeCompletion){updateCompletionCounts(params.accumulator,params.item.status,params.statusRegistry)}if(params.numericAggregation!==null){updateNumericAggregation(params.accumulator,params.numericValue)}}function accumulateItemGroups(grouped,groups,groupBy,context){for(const group of groups){const key=buildGroupKey(groupBy,group);const existing=grouped.get(key);if(existing){updateAggregateAccumulator({...context,accumulator:existing});continue}const accumulator=createAggregateAccumulator(group,context.numericValue);if(context.includeCompletion){updateCompletionCounts(accumulator,context.item.status,context.statusRegistry)}grouped.set(key,accumulator)}}function buildAggregateGroup(groupBy,item){const group={};for(const field of groupBy){group[field]=resolveGroupValue(field,item)}return group}function buildAggregateGroups(groupBy,item,setMode){let groups=[buildAggregateGroup(groupBy,item)];if(setMode==="tuple")return groups;for(const field of groupBy){const raw=item[field];if(!Array.isArray(raw))continue;const members=[...new Set(raw.map(value=>value.trim().toLowerCase()).filter(Boolean))].sort();if(members.length===0)continue;groups=groups.flatMap(group=>members.map(member=>({...group,[field]:member})))}return groups}function finalizeAggregateRow(entry,groupBy,includeCompletion,numericAggregation){const row={...entry.row,group_label:buildGroupLabel(groupBy,entry.row.group)};if(includeCompletion){row.open=entry.open_count;row.in_progress=entry.in_progress_count;row.closed=entry.closed_count;row.other=entry.other_count;row.completion_pct=completionPct(entry.closed_count,entry.row.count)}if(numericAggregation!==null){row.null_count=entry.null_count;if(numericAggregation.sum){row.sum=entry.numeric_sum}if(numericAggregation.avg){row.avg=entry.numeric_count===0?null:entry.numeric_sum/entry.numeric_count}}return row}function buildAggregateFilters(params){return{group_by:params.groupBy,set_mode:params.setMode,count:true,completion:params.includeCompletion,include_unparented:params.includeUnparented,status:params.status?.[0]??null,status_values:params.status,type:params.options.type??null,tag:params.options.tag??null,priority:params.options.priority??null,deadline_before:params.options.deadlineBefore??null,deadline_after:params.options.deadlineAfter??null,assignee:params.options.assignee??null,assignee_filter:params.options.assigneeFilter??null,parent:params.options.parent??null,sprint:params.options.sprint??null,release:params.options.release??null,...params.numericAggregation!==null?{sum:params.options.sum??null,avg:params.options.avg??null,numeric_field:params.numericAggregation.field}:{}}}async function runAggregate(options,global2){if(options.count===false){throw new PmCliError("Aggregate grouped counts are always enabled; omit count=false.",EXIT_CODE.USAGE)}const pmRoot=resolvePmRoot(process.cwd(),global2.path);const settings=await readSettings(pmRoot);const statusRegistry=resolveRuntimeStatusRegistry(settings.schema);const numericFields=["estimate","estimated_minutes","priority",...resolveRuntimeFieldRegistry(settings.schema).definitions.filter(definition=>definition.type==="number").map(definition=>definition.metadata_key)];const groupBy=parseGroupBy(options.groupBy);const setMode=options.setMode??"element";if(setMode!=="element"&&setMode!=="tuple"){throw new PmCliError("Aggregate --set-mode must be element or tuple",EXIT_CODE.USAGE)}const status=parseStatus(options.status,statusRegistry);const numericAggregation=parseNumericAggregation(options,[...new Set(numericFields)].sort((left,right)=>left.localeCompare(right)));const includeCompletion=options.completion===true;const includeUnparented=options.includeUnparented===true;const listed=await runList(void 0,{...buildListQueryFilters(options),status:options.status,noTruncate:true,strictRead:true},global2);const grouped=new Map;let skippedUnparented=0;let groupedItemCount=0;let groupMemberships=0;for(const listedItem of listed.items){const item=listedItem;if(groupBy.includes("parent")&&item.parent===void 0&&!includeUnparented){skippedUnparented+=1;continue}const numericValue=numericAggregation===null?null:readNumericAggregateValue(item,numericAggregation.field);const itemGroups=buildAggregateGroups(groupBy,item,setMode);accumulateItemGroups(grouped,itemGroups,groupBy,{item,statusRegistry,includeCompletion,numericAggregation,numericValue});groupMemberships+=itemGroups.length;groupedItemCount+=1}const groups=[...grouped.values()].map(entry=>finalizeAggregateRow(entry,groupBy,includeCompletion,numericAggregation)).sort((left,right)=>compareAggregateRows(left,right,groupBy));const warnings=listed.warnings&&listed.warnings.length>0?listed.warnings:void 0;return{...pageAggregateGroups(groups,groupBy,options),count:groups.length,totals:{items_considered:listed.items.length,items_grouped:groupedItemCount,items_skipped_unparented:skippedUnparented,group_memberships:groupMemberships},filters:buildAggregateFilters({groupBy,setMode,includeCompletion,includeUnparented,status,options,numericAggregation}),now:nowIso(),...warnings?{warnings}:{}}}function pageAggregateGroups(groups,groupBy,options){const limit=parsePositiveInteger(options.limit,"limit")??50;const previous=options.after===void 0?-1:groups.findIndex(row=>buildGroupKey(groupBy,row.group)===options.after);if(options.after!==void 0&&previous<0)throw new PmCliError("Aggregate --after cursor is absent from the current grouping; restart without --after.",EXIT_CODE.USAGE);const page=groups.slice(previous+1,previous+1+limit);const truncated=previous+1+page.length<groups.length;return{groups:page,returned_count:page.length,truncated,next_after:truncated?buildGroupKey(groupBy,page.at(-1).group):null}}const _testOnlyAggregateCommand={buildGroupKey,compareAggregateRows,compareNullableGroupValue,completionPct,normalizeTagGroupValue,parseGroupBy,parseNumericAggregation,parseStatus,readNumericAggregateValue,resolveGroupValue,updateCompletionCounts};export{_testOnlyAggregateCommand,runAggregate};
|
|
390
2
|
//# sourceMappingURL=aggregate.js.map
|
|
391
|
-
//# debugId=56486369-9164-58d3-ac34-46d57859f96d
|