@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
package/dist/sdk/query.js
CHANGED
|
@@ -1,36 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
* @module sdk/query
|
|
3
|
-
*
|
|
4
|
-
* Provides focused read, search, pagination, and context-ranking primitives.
|
|
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]="affe6060-5129-5914-9d4e-46c300d49080")}catch(e){}}();
|
|
8
|
-
export * from "./query/list.js";
|
|
9
|
-
export * from "./query/complete-list.js";
|
|
10
|
-
export * from "./query/search.js";
|
|
11
|
-
export { runActivity, } from "./query/activity.js";
|
|
12
|
-
export * from "./query/aggregate.js";
|
|
13
|
-
export * from "./query/calendar.js";
|
|
14
|
-
export { CONTEXT_OUTPUT_VALUES, applyContextTagProjection, buildChildrenByParent, collectSubtreeIds, compareCriticalItems, mergeSortedWarnings, packRankedContextItems, parseContextDepth, parseContextFocusFields, parseContextSections, projectContextFocusRows, renderContextMarkdown, resolveContextOutputFormat, resolveContextTokenBudget, runContext, toContextFocusItem, toContextPackingSummary, toContextRankingSummary, } from "./query/context.js";
|
|
15
|
-
export * from "./query/get.js";
|
|
16
|
-
export * from "./query/history.js";
|
|
17
|
-
export * from "./query/next.js";
|
|
18
|
-
export * from "./actionability.js";
|
|
19
|
-
export * from "./query/search-pagination.js";
|
|
20
|
-
export * from "./query/search-rendering.js";
|
|
21
|
-
export * from "./query/item-filter-options.js";
|
|
22
|
-
export * from "./query/multi-value-filters.js";
|
|
23
|
-
export * from "./query/parsers.js";
|
|
24
|
-
export * from "./pagination.js";
|
|
25
|
-
export * from "./item-children.js";
|
|
26
|
-
export * from "./item-metadata-index.js";
|
|
27
|
-
export * from "./context-packing.js";
|
|
28
|
-
export * from "./context-relevance.js";
|
|
29
|
-
export * from "./context-signal-store.js";
|
|
30
|
-
export * from "./context-usage.js";
|
|
31
|
-
export * from "./workspace-memory.js";
|
|
32
|
-
export * from "./duplicates.js";
|
|
33
|
-
export { analyzeDuplicateItems } from "./similarity.js";
|
|
34
|
-
export { measureItemMetadataReadWork } from "../core/store/item-metadata-read-work.js";
|
|
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]="87fb8085-4f16-58a9-9de7-c871fb90be5b")}catch(e2){}})();export*from"./query/list.js";export*from"./query/complete-list.js";export*from"./query/search.js";import{runActivity}from"./query/activity.js";export*from"./query/aggregate.js";export*from"./query/calendar.js";import{CONTEXT_OUTPUT_VALUES,applyContextTagProjection,buildChildrenByParent,collectSubtreeIds,compareCriticalItems,mergeSortedWarnings,packRankedContextItems,parseContextDepth,parseContextFocusFields,parseContextSections,projectContextFocusRows,renderContextMarkdown,resolveContextOutputFormat,resolveContextTokenBudget,runContext,toContextFocusItem,toContextPackingSummary,toContextRankingSummary}from"./query/context.js";export*from"./query/get.js";export*from"./query/history.js";export*from"./query/next.js";export*from"./actionability.js";export*from"./query/search-pagination.js";export*from"./query/search-rendering.js";export*from"./query/item-filter-options.js";export*from"./query/multi-value-filters.js";export*from"./query/parsers.js";export*from"./pagination.js";export*from"./item-children.js";export*from"./item-metadata-index.js";export*from"./context-packing.js";export*from"./context-relevance.js";export*from"./context-signal-store.js";export*from"./context-usage.js";export*from"./workspace-memory.js";export*from"./duplicates.js";import{analyzeDuplicateItems}from"./similarity.js";import{measureItemMetadataReadWork}from"../core/store/item-metadata-read-work.js";export{CONTEXT_OUTPUT_VALUES,analyzeDuplicateItems,applyContextTagProjection,buildChildrenByParent,collectSubtreeIds,compareCriticalItems,measureItemMetadataReadWork,mergeSortedWarnings,packRankedContextItems,parseContextDepth,parseContextFocusFields,parseContextSections,projectContextFocusRows,renderContextMarkdown,resolveContextOutputFormat,resolveContextTokenBudget,runActivity,runContext,toContextFocusItem,toContextPackingSummary,toContextRankingSummary};
|
|
35
2
|
//# sourceMappingURL=query.js.map
|
|
36
|
-
//# debugId=affe6060-5129-5914-9d4e-46c300d49080
|
|
@@ -1,195 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
* @module sdk/read-output/continuation
|
|
3
|
-
*
|
|
4
|
-
* Encodes, validates, and applies stable continuations for declared read-output
|
|
5
|
-
* row collections while keeping cursor mechanics separate from dimension
|
|
6
|
-
* resolution and budget policy.
|
|
7
|
-
*/
|
|
8
|
-
|
|
9
|
-
!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]="9e63b4b0-09a5-50bf-9f56-5f239c75ffe5")}catch(e){}}();
|
|
10
|
-
import { createHash } from "node:crypto";
|
|
11
|
-
import { EXIT_CODE } from "../../core/shared/constants.js";
|
|
12
|
-
import { PmCliError } from "../../core/shared/errors.js";
|
|
13
|
-
import { stableStringify } from "../../core/shared/serialization.js";
|
|
14
|
-
import { resolveReadOutputSurface } from "../read-output-contracts.js";
|
|
15
|
-
import { readOutputContinuationRowCollections, sliceReadOutputRowCollection, } from "../read-output-rows.js";
|
|
16
|
-
const MAX_READ_OUTPUT_CURSOR_LENGTH = 4096;
|
|
17
|
-
const HEALTH_TELEMETRY_VOLATILE_DETAIL_FIELDS = Object.freeze([
|
|
18
|
-
"queue_draining",
|
|
19
|
-
"queue_entries",
|
|
20
|
-
"queue_exists",
|
|
21
|
-
"queue_high_retry_entries",
|
|
22
|
-
"queue_invalid_rows",
|
|
23
|
-
"queue_max_attempts",
|
|
24
|
-
"queue_rows_total",
|
|
25
|
-
"queue_size_bytes",
|
|
26
|
-
"pending_otel_spans",
|
|
27
|
-
"last_attempted_flush_at",
|
|
28
|
-
"last_failed_flush_at",
|
|
29
|
-
"last_otel_attempt_at",
|
|
30
|
-
"last_otel_failure_at",
|
|
31
|
-
"last_otel_success_at",
|
|
32
|
-
"last_successful_flush_at",
|
|
33
|
-
]);
|
|
34
|
-
/** Command-specific exceptions to complete-row continuation fingerprinting. */
|
|
35
|
-
export const PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES = Object.freeze({
|
|
36
|
-
health: Object.freeze({
|
|
37
|
-
version: 3,
|
|
38
|
-
paths: Object.freeze(["checks"]),
|
|
39
|
-
ignored_detail_field_names_by_row: Object.freeze({
|
|
40
|
-
telemetry: HEALTH_TELEMETRY_VOLATILE_DETAIL_FIELDS,
|
|
41
|
-
}),
|
|
42
|
-
guarantee: "nonvolatile_snapshot_and_stable_configuration",
|
|
43
|
-
}),
|
|
44
|
-
});
|
|
45
|
-
function isRecord(value) {
|
|
46
|
-
return value !== null && typeof value === "object" && !Array.isArray(value);
|
|
47
|
-
}
|
|
48
|
-
function normalizeReadOutputFingerprintValue(value) {
|
|
49
|
-
if (Array.isArray(value)) {
|
|
50
|
-
return value.map(normalizeReadOutputFingerprintValue);
|
|
51
|
-
}
|
|
52
|
-
if (!isRecord(value))
|
|
53
|
-
return value;
|
|
54
|
-
return Object.fromEntries(Object.entries(value).map(([key, entry]) => [
|
|
55
|
-
key,
|
|
56
|
-
normalizeReadOutputFingerprintValue(entry),
|
|
57
|
-
]));
|
|
58
|
-
}
|
|
59
|
-
function normalizeReadOutputFingerprintRow(value, policy) {
|
|
60
|
-
if (!isRecord(value))
|
|
61
|
-
return normalizeReadOutputFingerprintValue(value);
|
|
62
|
-
const rowName = typeof value.name === "string" ? value.name : undefined;
|
|
63
|
-
const ignoredDetailFields = rowName !== undefined &&
|
|
64
|
-
Object.hasOwn(policy.ignored_detail_field_names_by_row, rowName)
|
|
65
|
-
? policy.ignored_detail_field_names_by_row[rowName]
|
|
66
|
-
: undefined;
|
|
67
|
-
return Object.fromEntries(Object.entries(value)
|
|
68
|
-
.map(([key, entry]) => {
|
|
69
|
-
if (key !== "details" || !ignoredDetailFields || !isRecord(entry)) {
|
|
70
|
-
return [key, normalizeReadOutputFingerprintValue(entry)];
|
|
71
|
-
}
|
|
72
|
-
return [
|
|
73
|
-
key,
|
|
74
|
-
Object.fromEntries(Object.entries(entry)
|
|
75
|
-
.filter(([detailKey]) => !ignoredDetailFields.includes(detailKey))
|
|
76
|
-
.map(([detailKey, detailValue]) => [
|
|
77
|
-
detailKey,
|
|
78
|
-
normalizeReadOutputFingerprintValue(detailValue),
|
|
79
|
-
])),
|
|
80
|
-
];
|
|
81
|
-
}));
|
|
82
|
-
}
|
|
83
|
-
function normalizeReadOutputFingerprintSnapshot(value, policy) {
|
|
84
|
-
return Array.isArray(value)
|
|
85
|
-
? value.map((row) => normalizeReadOutputFingerprintRow(row, policy))
|
|
86
|
-
: normalizeReadOutputFingerprintRow(value, policy);
|
|
87
|
-
}
|
|
88
|
-
/** Fingerprint the policy-normalized row snapshot so stable evidence changes fail closed. */
|
|
89
|
-
export function readOutputCollectionFingerprint(path, value, command) {
|
|
90
|
-
const policy = command
|
|
91
|
-
? PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES[command]
|
|
92
|
-
: undefined;
|
|
93
|
-
const policyApplies = policy?.paths.includes(path) === true;
|
|
94
|
-
return createHash("sha256")
|
|
95
|
-
.update(stableStringify({
|
|
96
|
-
path,
|
|
97
|
-
value: policyApplies
|
|
98
|
-
? normalizeReadOutputFingerprintSnapshot(value, policy)
|
|
99
|
-
: value,
|
|
100
|
-
...(policyApplies
|
|
101
|
-
? { fingerprint_policy_version: policy.version }
|
|
102
|
-
: {}),
|
|
103
|
-
}))
|
|
104
|
-
.digest("base64url")
|
|
105
|
-
.slice(0, 16);
|
|
106
|
-
}
|
|
107
|
-
/** Encode one stable declared-row continuation for CLI, SDK, and MCP callers. */
|
|
108
|
-
export function encodeReadOutputContinuationCursor(cursor) {
|
|
109
|
-
return Buffer.from(JSON.stringify({
|
|
110
|
-
v: 1,
|
|
111
|
-
c: cursor.command,
|
|
112
|
-
p: cursor.path,
|
|
113
|
-
o: cursor.offset,
|
|
114
|
-
n: cursor.total_rows,
|
|
115
|
-
f: cursor.fingerprint,
|
|
116
|
-
}), "utf8").toString("base64url");
|
|
117
|
-
}
|
|
118
|
-
/** Decode and validate one universal declared-row continuation cursor. */
|
|
119
|
-
export function decodeReadOutputContinuationCursor(raw) {
|
|
120
|
-
if (raw.length > MAX_READ_OUTPUT_CURSOR_LENGTH) {
|
|
121
|
-
throw new PmCliError("The read-output continuation cursor is malformed or unsupported.", EXIT_CODE.USAGE, { code: "read_output_cursor_invalid" });
|
|
122
|
-
}
|
|
123
|
-
let candidate;
|
|
124
|
-
try {
|
|
125
|
-
candidate = JSON.parse(Buffer.from(raw, "base64url").toString("utf8"));
|
|
126
|
-
}
|
|
127
|
-
catch {
|
|
128
|
-
candidate = null;
|
|
129
|
-
}
|
|
130
|
-
if (!isRecord(candidate) ||
|
|
131
|
-
candidate.v !== 1 ||
|
|
132
|
-
resolveReadOutputSurface(String(candidate.c ?? "")) !== candidate.c ||
|
|
133
|
-
typeof candidate.p !== "string" ||
|
|
134
|
-
candidate.p.length === 0 ||
|
|
135
|
-
!Number.isSafeInteger(candidate.o) ||
|
|
136
|
-
candidate.o < 0 ||
|
|
137
|
-
!Number.isSafeInteger(candidate.n) ||
|
|
138
|
-
candidate.n < 1 ||
|
|
139
|
-
typeof candidate.f !== "string" ||
|
|
140
|
-
candidate.f.length === 0) {
|
|
141
|
-
throw new PmCliError("The read-output continuation cursor is malformed or unsupported.", EXIT_CODE.USAGE, { code: "read_output_cursor_invalid" });
|
|
142
|
-
}
|
|
143
|
-
return {
|
|
144
|
-
version: 1,
|
|
145
|
-
command: candidate.c,
|
|
146
|
-
path: candidate.p,
|
|
147
|
-
offset: candidate.o,
|
|
148
|
-
total_rows: candidate.n,
|
|
149
|
-
fingerprint: candidate.f,
|
|
150
|
-
};
|
|
151
|
-
}
|
|
152
|
-
/** Place every non-passing assurance assertion before passing evidence. */
|
|
153
|
-
export function prioritizeAssuranceAssertions(result) {
|
|
154
|
-
if (!Array.isArray(result.assertions))
|
|
155
|
-
return result;
|
|
156
|
-
const priority = (row) => {
|
|
157
|
-
if (!isRecord(row) || row.verdict === "pass")
|
|
158
|
-
return 4;
|
|
159
|
-
if (row.verdict === "retired")
|
|
160
|
-
return 3;
|
|
161
|
-
return row.enforcement === "block" ? 0 : row.enforcement === "warn" ? 1 : 2;
|
|
162
|
-
};
|
|
163
|
-
return {
|
|
164
|
-
...result,
|
|
165
|
-
assertions: result.assertions
|
|
166
|
-
.map((row, index) => ({ row, index }))
|
|
167
|
-
.sort((left, right) => priority(left.row) - priority(right.row) || left.index - right.index)
|
|
168
|
-
.map(({ row }) => row),
|
|
169
|
-
budget_retention_policy: "verdict_priority",
|
|
170
|
-
};
|
|
171
|
-
}
|
|
172
|
-
/** Validate and apply a continuation suffix to its declared row collection. */
|
|
173
|
-
export function applyReadOutputContinuation(result, command, cursor) {
|
|
174
|
-
if (!cursor)
|
|
175
|
-
return result;
|
|
176
|
-
if (cursor.command !== command) {
|
|
177
|
-
throw new PmCliError(`The read-output cursor belongs to ${cursor.command}, not ${command}.`, EXIT_CODE.USAGE, { code: "read_output_cursor_command_mismatch" });
|
|
178
|
-
}
|
|
179
|
-
const collection = readOutputContinuationRowCollections(result).find((entry) => entry.path === cursor.path);
|
|
180
|
-
const totalRows = collection
|
|
181
|
-
? Array.isArray(collection.value)
|
|
182
|
-
? collection.value.length
|
|
183
|
-
: Object.keys(collection.value).length
|
|
184
|
-
: 0;
|
|
185
|
-
if (!collection ||
|
|
186
|
-
totalRows !== cursor.total_rows ||
|
|
187
|
-
cursor.offset > totalRows ||
|
|
188
|
-
readOutputCollectionFingerprint(cursor.path, collection.value, command) !==
|
|
189
|
-
cursor.fingerprint) {
|
|
190
|
-
throw new PmCliError("The read-output continuation no longer matches the declared row collection; restart the bounded read.", EXIT_CODE.USAGE, { code: "read_output_cursor_stale" });
|
|
191
|
-
}
|
|
192
|
-
return sliceReadOutputRowCollection(result, cursor.path, cursor.offset);
|
|
193
|
-
}
|
|
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]="de370088-9285-5b33-8c7f-da8e9bb88286")}catch(e2){}})();import{createHash}from"node:crypto";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{stableStringify}from"../../core/shared/serialization.js";import{resolveReadOutputSurface}from"../read-output-contracts.js";import{readOutputContinuationRowCollections,sliceReadOutputRowCollection}from"../read-output-rows.js";const MAX_READ_OUTPUT_CURSOR_LENGTH=4096;const HEALTH_TELEMETRY_VOLATILE_DETAIL_FIELDS=Object.freeze(["queue_draining","queue_entries","queue_exists","queue_high_retry_entries","queue_invalid_rows","queue_max_attempts","queue_rows_total","queue_size_bytes","pending_otel_spans","last_attempted_flush_at","last_failed_flush_at","last_otel_attempt_at","last_otel_failure_at","last_otel_success_at","last_successful_flush_at"]);const PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES=Object.freeze({health:Object.freeze({version:3,paths:Object.freeze(["checks"]),ignored_detail_field_names_by_row:Object.freeze({telemetry:HEALTH_TELEMETRY_VOLATILE_DETAIL_FIELDS}),guarantee:"nonvolatile_snapshot_and_stable_configuration"})});function isRecord(value){return value!==null&&typeof value==="object"&&!Array.isArray(value)}function normalizeReadOutputFingerprintValue(value){if(Array.isArray(value)){return value.map(normalizeReadOutputFingerprintValue)}if(!isRecord(value))return value;return Object.fromEntries(Object.entries(value).map(([key,entry])=>[key,normalizeReadOutputFingerprintValue(entry)]))}function normalizeReadOutputFingerprintRow(value,policy){if(!isRecord(value))return normalizeReadOutputFingerprintValue(value);const rowName=typeof value.name==="string"?value.name:void 0;const ignoredDetailFields=rowName!==void 0&&Object.hasOwn(policy.ignored_detail_field_names_by_row,rowName)?policy.ignored_detail_field_names_by_row[rowName]:void 0;return Object.fromEntries(Object.entries(value).map(([key,entry])=>{if(key!=="details"||!ignoredDetailFields||!isRecord(entry)){return[key,normalizeReadOutputFingerprintValue(entry)]}return[key,Object.fromEntries(Object.entries(entry).filter(([detailKey])=>!ignoredDetailFields.includes(detailKey)).map(([detailKey,detailValue])=>[detailKey,normalizeReadOutputFingerprintValue(detailValue)]))]}))}function normalizeReadOutputFingerprintSnapshot(value,policy){return Array.isArray(value)?value.map(row=>normalizeReadOutputFingerprintRow(row,policy)):normalizeReadOutputFingerprintRow(value,policy)}function readOutputCollectionFingerprint(path,value,command){const policy=command?PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES[command]:void 0;const policyApplies=policy?.paths.includes(path)===true;return createHash("sha256").update(stableStringify({path,value:policyApplies?normalizeReadOutputFingerprintSnapshot(value,policy):value,...policyApplies?{fingerprint_policy_version:policy.version}:{}})).digest("base64url").slice(0,16)}function encodeReadOutputContinuationCursor(cursor){return Buffer.from(JSON.stringify({v:1,c:cursor.command,p:cursor.path,o:cursor.offset,n:cursor.total_rows,f:cursor.fingerprint}),"utf8").toString("base64url")}function decodeReadOutputContinuationCursor(raw){if(raw.length>MAX_READ_OUTPUT_CURSOR_LENGTH){throw new PmCliError("The read-output continuation cursor is malformed or unsupported.",EXIT_CODE.USAGE,{code:"read_output_cursor_invalid"})}let candidate;try{candidate=JSON.parse(Buffer.from(raw,"base64url").toString("utf8"))}catch{candidate=null}if(!isRecord(candidate)||candidate.v!==1||resolveReadOutputSurface(String(candidate.c??""))!==candidate.c||typeof candidate.p!=="string"||candidate.p.length===0||!Number.isSafeInteger(candidate.o)||candidate.o<0||!Number.isSafeInteger(candidate.n)||candidate.n<1||typeof candidate.f!=="string"||candidate.f.length===0){throw new PmCliError("The read-output continuation cursor is malformed or unsupported.",EXIT_CODE.USAGE,{code:"read_output_cursor_invalid"})}return{version:1,command:candidate.c,path:candidate.p,offset:candidate.o,total_rows:candidate.n,fingerprint:candidate.f}}function prioritizeAssuranceAssertions(result){if(!Array.isArray(result.assertions))return result;const priority=row=>{if(!isRecord(row)||row.verdict==="pass")return 4;if(row.verdict==="retired")return 3;return row.enforcement==="block"?0:row.enforcement==="warn"?1:2};return{...result,assertions:result.assertions.map((row,index)=>({row,index})).sort((left,right)=>priority(left.row)-priority(right.row)||left.index-right.index).map(({row})=>row),budget_retention_policy:"verdict_priority"}}function applyReadOutputContinuation(result,command,cursor){if(!cursor)return result;if(cursor.command!==command){throw new PmCliError(`The read-output cursor belongs to ${cursor.command}, not ${command}.`,EXIT_CODE.USAGE,{code:"read_output_cursor_command_mismatch"})}const collection=readOutputContinuationRowCollections(result).find(entry=>entry.path===cursor.path);const totalRows=collection?Array.isArray(collection.value)?collection.value.length:Object.keys(collection.value).length:0;if(!collection||totalRows!==cursor.total_rows||cursor.offset>totalRows||readOutputCollectionFingerprint(cursor.path,collection.value,command)!==cursor.fingerprint){throw new PmCliError("The read-output continuation no longer matches the declared row collection; restart the bounded read.",EXIT_CODE.USAGE,{code:"read_output_cursor_stale"})}return sliceReadOutputRowCollection(result,cursor.path,cursor.offset)}export{PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES,applyReadOutputContinuation,decodeReadOutputContinuationCursor,encodeReadOutputContinuationCursor,prioritizeAssuranceAssertions,readOutputCollectionFingerprint};
|
|
194
2
|
//# sourceMappingURL=continuation.js.map
|
|
195
|
-
//# debugId=9e63b4b0-09a5-50bf-9f56-5f239c75ffe5
|
|
@@ -1,136 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
!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]="02a0bd0c-6ab0-5193-807b-00394a4712b7")}catch(e){}}();
|
|
3
|
-
import { countReadOutputRows, readOutputBudgetCollections, } from "./read-output-rows.js";
|
|
4
|
-
const MAX_ESTIMATE_ITERATIONS = 8;
|
|
5
|
-
const MAX_COMPACTION_ITERATIONS = 64;
|
|
6
|
-
const RECOVERY_MARGIN_NUMERATOR = 5;
|
|
7
|
-
const RECOVERY_MARGIN_DENOMINATOR = 4;
|
|
8
|
-
const RECOVERY_ROUNDING_TOKENS = 100;
|
|
9
|
-
/**
|
|
10
|
-
* Recommend a retry that is strictly larger than both the binding request and
|
|
11
|
-
* the pre-compaction result, with a 25% envelope margin rounded to 100 tokens.
|
|
12
|
-
*/
|
|
13
|
-
export function resolveReadOutputRecoveryBudget(input) {
|
|
14
|
-
const binding = Math.trunc(input.effective_budget_tokens);
|
|
15
|
-
const measured = Math.trunc(input.measured_result_tokens);
|
|
16
|
-
if (!Number.isSafeInteger(binding) ||
|
|
17
|
-
binding <= 0 ||
|
|
18
|
-
!Number.isSafeInteger(measured) ||
|
|
19
|
-
measured <= 0) {
|
|
20
|
-
return {
|
|
21
|
-
output_budget: "unbounded",
|
|
22
|
-
recovery_budget_multiplier: null,
|
|
23
|
-
rule_version: "v1",
|
|
24
|
-
};
|
|
25
|
-
}
|
|
26
|
-
const baseline = Math.max(binding + 1, measured);
|
|
27
|
-
const withMargin = Math.ceil((baseline * RECOVERY_MARGIN_NUMERATOR) / RECOVERY_MARGIN_DENOMINATOR);
|
|
28
|
-
const rounded = Math.ceil(withMargin / RECOVERY_ROUNDING_TOKENS) *
|
|
29
|
-
RECOVERY_ROUNDING_TOKENS;
|
|
30
|
-
if (!Number.isSafeInteger(rounded)) {
|
|
31
|
-
return {
|
|
32
|
-
output_budget: "unbounded",
|
|
33
|
-
recovery_budget_multiplier: null,
|
|
34
|
-
rule_version: "v1",
|
|
35
|
-
};
|
|
36
|
-
}
|
|
37
|
-
return {
|
|
38
|
-
output_budget: rounded,
|
|
39
|
-
recovery_budget_multiplier: rounded / binding,
|
|
40
|
-
rule_version: "v1",
|
|
41
|
-
};
|
|
42
|
-
}
|
|
43
|
-
/** Estimate the conservative token cost of a JSON-shaped result. */
|
|
44
|
-
export function estimateReadOutputTokens(result) {
|
|
45
|
-
return Math.ceil(Buffer.byteLength(JSON.stringify(result), "utf8") / 4);
|
|
46
|
-
}
|
|
47
|
-
/** Return whether a value is a non-array object record. */
|
|
48
|
-
function isRecord(value) {
|
|
49
|
-
return value !== null && typeof value === "object" && !Array.isArray(value);
|
|
50
|
-
}
|
|
51
|
-
/** Recursively shorten explanatory strings and record whether content changed. */
|
|
52
|
-
function compactStrings(value, state) {
|
|
53
|
-
if (typeof value === "string") {
|
|
54
|
-
if (value.length <= 240)
|
|
55
|
-
return value;
|
|
56
|
-
state.compacted = true;
|
|
57
|
-
return `${value.slice(0, 240)}…`;
|
|
58
|
-
}
|
|
59
|
-
if (Array.isArray(value)) {
|
|
60
|
-
return value.map((entry) => compactStrings(entry, state));
|
|
61
|
-
}
|
|
62
|
-
if (!isRecord(value))
|
|
63
|
-
return value;
|
|
64
|
-
return Object.fromEntries(Object.entries(value).map(([key, entry]) => [
|
|
65
|
-
key,
|
|
66
|
-
compactStrings(entry, state),
|
|
67
|
-
]));
|
|
68
|
-
}
|
|
69
|
-
/** Update a receipt to the fixed-point estimate of the result containing it. */
|
|
70
|
-
export function updateReadOutputReceiptEstimate(result, receipt) {
|
|
71
|
-
let estimate = receipt.estimated_tokens;
|
|
72
|
-
for (let iteration = 0; iteration < MAX_ESTIMATE_ITERATIONS; iteration += 1) {
|
|
73
|
-
receipt.estimated_tokens = estimate;
|
|
74
|
-
const measured = estimateReadOutputTokens(result);
|
|
75
|
-
if (measured === estimate)
|
|
76
|
-
return;
|
|
77
|
-
estimate = measured;
|
|
78
|
-
}
|
|
79
|
-
receipt.estimated_tokens = estimate;
|
|
80
|
-
}
|
|
81
|
-
/** Reduce the largest row collection until the budget fits or no rows can move. */
|
|
82
|
-
function compactRowsToBudget(result, receipt, budget, minimumRowsByPath) {
|
|
83
|
-
for (let iteration = 0; iteration < MAX_COMPACTION_ITERATIONS; iteration += 1) {
|
|
84
|
-
updateReadOutputReceiptEstimate(result, receipt);
|
|
85
|
-
if (receipt.estimated_tokens <= budget)
|
|
86
|
-
return;
|
|
87
|
-
const candidate = readOutputBudgetCollections(result)
|
|
88
|
-
.filter((collection) => {
|
|
89
|
-
const length = Array.isArray(collection.value)
|
|
90
|
-
? collection.value.length
|
|
91
|
-
: Object.keys(collection.value).length;
|
|
92
|
-
return (length > Math.max(1, minimumRowsByPath.get(collection.path) ?? 0));
|
|
93
|
-
})
|
|
94
|
-
.map((collection) => ({
|
|
95
|
-
collection,
|
|
96
|
-
length: Array.isArray(collection.value)
|
|
97
|
-
? collection.value.length
|
|
98
|
-
: Object.keys(collection.value).length,
|
|
99
|
-
}))
|
|
100
|
-
.sort((left, right) => right.length - left.length ||
|
|
101
|
-
left.collection.path.localeCompare(right.collection.path))[0]?.collection;
|
|
102
|
-
if (!candidate)
|
|
103
|
-
return;
|
|
104
|
-
const minimumRows = Math.max(1, minimumRowsByPath.get(candidate.path) ?? 0);
|
|
105
|
-
if (Array.isArray(candidate.value)) {
|
|
106
|
-
candidate.value.splice(-Math.min(candidate.value.length - minimumRows, Math.max(1, Math.ceil(candidate.value.length / 2))));
|
|
107
|
-
}
|
|
108
|
-
else {
|
|
109
|
-
const keys = Object.keys(candidate.value);
|
|
110
|
-
for (const key of keys.slice(-Math.min(keys.length - minimumRows, Math.max(1, Math.ceil(keys.length / 2))))) {
|
|
111
|
-
delete candidate.value[key];
|
|
112
|
-
}
|
|
113
|
-
}
|
|
114
|
-
receipt.rows_compacted = true;
|
|
115
|
-
receipt.compacted_row_paths = [
|
|
116
|
-
...new Set([...(receipt.compacted_row_paths ?? []), candidate.path]),
|
|
117
|
-
].sort((left, right) => left.localeCompare(right));
|
|
118
|
-
result.has_more = true;
|
|
119
|
-
result.truncated = true;
|
|
120
|
-
if (typeof result.count === "number") {
|
|
121
|
-
result.count = countReadOutputRows(result);
|
|
122
|
-
}
|
|
123
|
-
}
|
|
124
|
-
}
|
|
125
|
-
/** Compact strings and rows in place, then return the final exact estimate. */
|
|
126
|
-
export function compactReadOutputToBudget(result, receipt, budget, minimumRowsByPath = new Map()) {
|
|
127
|
-
const stringCompactionState = { compacted: false };
|
|
128
|
-
const compacted = compactStrings(result, stringCompactionState);
|
|
129
|
-
receipt.strings_compacted = stringCompactionState.compacted;
|
|
130
|
-
compacted.read_output = receipt;
|
|
131
|
-
compactRowsToBudget(compacted, receipt, budget, minimumRowsByPath);
|
|
132
|
-
updateReadOutputReceiptEstimate(compacted, receipt);
|
|
133
|
-
return compacted;
|
|
134
|
-
}
|
|
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]="1f54b7c3-9d49-5e67-88fa-b5b87748e02f")}catch(e2){}})();import{countReadOutputRows,readOutputBudgetCollections}from"./read-output-rows.js";const MAX_ESTIMATE_ITERATIONS=8;const MAX_COMPACTION_ITERATIONS=64;const RECOVERY_MARGIN_NUMERATOR=5;const RECOVERY_MARGIN_DENOMINATOR=4;const RECOVERY_ROUNDING_TOKENS=100;function resolveReadOutputRecoveryBudget(input){const binding=Math.trunc(input.effective_budget_tokens);const measured=Math.trunc(input.measured_result_tokens);if(!Number.isSafeInteger(binding)||binding<=0||!Number.isSafeInteger(measured)||measured<=0){return{output_budget:"unbounded",recovery_budget_multiplier:null,rule_version:"v1"}}const baseline=Math.max(binding+1,measured);const withMargin=Math.ceil(baseline*RECOVERY_MARGIN_NUMERATOR/RECOVERY_MARGIN_DENOMINATOR);const rounded=Math.ceil(withMargin/RECOVERY_ROUNDING_TOKENS)*RECOVERY_ROUNDING_TOKENS;if(!Number.isSafeInteger(rounded)){return{output_budget:"unbounded",recovery_budget_multiplier:null,rule_version:"v1"}}return{output_budget:rounded,recovery_budget_multiplier:rounded/binding,rule_version:"v1"}}function estimateReadOutputTokens(result){return Math.ceil(Buffer.byteLength(JSON.stringify(result),"utf8")/4)}function isRecord(value){return value!==null&&typeof value==="object"&&!Array.isArray(value)}function compactStrings(value,state){if(typeof value==="string"){if(value.length<=240)return value;state.compacted=true;return`${value.slice(0,240)}\u2026`}if(Array.isArray(value)){return value.map(entry=>compactStrings(entry,state))}if(!isRecord(value))return value;return Object.fromEntries(Object.entries(value).map(([key,entry])=>[key,compactStrings(entry,state)]))}function updateReadOutputReceiptEstimate(result,receipt){let estimate=receipt.estimated_tokens;for(let iteration=0;iteration<MAX_ESTIMATE_ITERATIONS;iteration+=1){receipt.estimated_tokens=estimate;const measured=estimateReadOutputTokens(result);if(measured===estimate)return;estimate=measured}receipt.estimated_tokens=estimate}function compactRowsToBudget(result,receipt,budget,minimumRowsByPath){for(let iteration=0;iteration<MAX_COMPACTION_ITERATIONS;iteration+=1){updateReadOutputReceiptEstimate(result,receipt);if(receipt.estimated_tokens<=budget)return;const candidate=readOutputBudgetCollections(result).filter(collection=>{const length=Array.isArray(collection.value)?collection.value.length:Object.keys(collection.value).length;return length>Math.max(1,minimumRowsByPath.get(collection.path)??0)}).map(collection=>({collection,length:Array.isArray(collection.value)?collection.value.length:Object.keys(collection.value).length})).sort((left,right)=>right.length-left.length||left.collection.path.localeCompare(right.collection.path))[0]?.collection;if(!candidate)return;const minimumRows=Math.max(1,minimumRowsByPath.get(candidate.path)??0);if(Array.isArray(candidate.value)){candidate.value.splice(-Math.min(candidate.value.length-minimumRows,Math.max(1,Math.ceil(candidate.value.length/2))))}else{const keys=Object.keys(candidate.value);for(const key of keys.slice(-Math.min(keys.length-minimumRows,Math.max(1,Math.ceil(keys.length/2))))){delete candidate.value[key]}}receipt.rows_compacted=true;receipt.compacted_row_paths=[...new Set([...receipt.compacted_row_paths??[],candidate.path])].sort((left,right)=>left.localeCompare(right));result.has_more=true;result.truncated=true;if(typeof result.count==="number"){result.count=countReadOutputRows(result)}}}function compactReadOutputToBudget(result,receipt,budget,minimumRowsByPath=new Map){const stringCompactionState={compacted:false};const compacted=compactStrings(result,stringCompactionState);receipt.strings_compacted=stringCompactionState.compacted;compacted.read_output=receipt;compactRowsToBudget(compacted,receipt,budget,minimumRowsByPath);updateReadOutputReceiptEstimate(compacted,receipt);return compacted}export{compactReadOutputToBudget,estimateReadOutputTokens,resolveReadOutputRecoveryBudget,updateReadOutputReceiptEstimate};
|
|
135
2
|
//# sourceMappingURL=read-output-budget.js.map
|
|
136
|
-
//# debugId=02a0bd0c-6ab0-5193-807b-00394a4712b7
|