@unbrained/pm-cli 2026.9.7 → 2026.9.9
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 +7 -2
- package/.agents/skills/pm-user/references/ECOSYSTEM_PLANNING.md +95 -0
- package/.claude-plugin/marketplace.json +2 -2
- package/CHANGELOG.md +231 -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.d.ts +0 -5
- 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-NPN5I67J.js → chunk-3IPRM75M.js} +3 -3
- package/dist/cli-bundle/chunks/chunk-4VL5P22L.js +2 -0
- package/dist/cli-bundle/chunks/chunk-AAFBV3U3.js +29 -0
- package/dist/cli-bundle/chunks/chunk-D3YVILJJ.js +20 -0
- package/dist/cli-bundle/chunks/{chunk-WYRZZ5ZE.js → chunk-DEZPZOQ7.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-ECBLPN7B.js +3 -0
- package/dist/cli-bundle/chunks/chunk-J6ERHBV2.js +235 -0
- package/dist/cli-bundle/chunks/chunk-JUNJ5EKI.js +2 -0
- package/dist/cli-bundle/chunks/chunk-L5RCDKQ2.js +2 -0
- package/dist/cli-bundle/chunks/chunk-NSAPNEYH.js +2 -0
- package/dist/cli-bundle/chunks/chunk-OHNLSGGV.js +79 -0
- package/dist/cli-bundle/chunks/chunk-WQKMSFBV.js +5 -0
- package/dist/cli-bundle/chunks/{chunk-BAX2BYUW.js → chunk-XZ6T7YPP.js} +256 -150
- package/dist/cli-bundle/chunks/{chunk-JT6XF6GE.js → chunk-Z3XVXUVF.js} +4 -4
- package/dist/cli-bundle/chunks/register-list-query-UIHRCS6D.js +11 -0
- package/dist/cli-bundle/chunks/register-mutation-WHWMGRVX.js +20 -0
- package/dist/cli-bundle/chunks/register-operations-64YZYTC5.js +2 -0
- package/dist/cli-bundle/chunks/register-setup-PERI45EM.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-2W4XIYOB.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-2WSBXIGF.js +12 -0
- package/dist/cli-bundle/focused-chunks/chunk-5FHTCOHS.js +3 -0
- package/dist/cli-bundle/focused-chunks/chunk-7N6DOREF.js +26 -0
- package/dist/cli-bundle/focused-chunks/{chunk-3BZEOXLT.js → chunk-7PC4R5QB.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-BUCJUZVG.js +6 -0
- package/dist/cli-bundle/focused-chunks/chunk-FE3BABLJ.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-IWITF53W.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-OQUGRHKV.js +10 -0
- package/dist/cli-bundle/focused-chunks/{chunk-M6PBRFSH.js → chunk-PNKIANFZ.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-LIJIA4TY.js → chunk-QQQ4SAUO.js} +3 -3
- package/dist/cli-bundle/focused-chunks/chunk-TTYXF5YD.js +177 -0
- package/dist/cli-bundle/focused-chunks/chunk-XNR3DM6J.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-XSS3APUF.js +9 -0
- package/dist/cli-bundle/focused-chunks/chunk-YCDQ2N23.js +8 -0
- package/dist/cli-bundle/focused-chunks/chunk-YJUXGS57.js +20 -0
- package/dist/cli-bundle/focused-chunks/chunk-ZTCE4UO6.js +58 -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 +37 -37
- 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/policy/workflow-policy-schema.d.ts +312 -0
- package/dist/core/policy/workflow-policy-schema.js +2 -0
- package/dist/core/policy/workflow-policy-store.d.ts +24 -0
- package/dist/core/policy/workflow-policy-store.js +2 -0
- package/dist/core/policy/workflow-policy.d.ts +139 -0
- package/dist/core/policy/workflow-policy.js +2 -0
- 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.d.ts +1 -0
- 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.d.ts +1 -1
- 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 +174 -839
- 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.d.ts +3 -1
- package/dist/sdk/governance/validate.js +1 -2261
- package/dist/sdk/governance/workflow-completeness.d.ts +32 -0
- package/dist/sdk/governance/workflow-completeness.js +2 -0
- package/dist/sdk/governance/workflow-policy.d.ts +47 -0
- package/dist/sdk/governance/workflow-policy.js +4 -0
- package/dist/sdk/governance/workspace-position.js +1 -163
- package/dist/sdk/governance.d.ts +2 -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 -1
- 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.d.ts +1 -1
- 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.d.ts +27 -0
- 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.d.ts +6 -4
- 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.d.ts +1 -1
- 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.d.ts +2 -1
- package/dist/sdk/runtime-public-contracts.js +1 -4
- package/dist/sdk/runtime-stats-options.js +1 -38
- package/dist/sdk/runtime.d.ts +4 -0
- 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.d.ts +2 -1
- 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.d.ts +4 -0
- package/dist/types.js +1 -245
- package/docs/AGENT_GUIDE.md +1 -1
- package/docs/COMMANDS.md +10 -0
- package/docs/CONFIGURATION.md +12 -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 +4 -0
- package/docs/READ_OUTPUT_CONTRACTS.md +5 -0
- package/docs/SCRIPTING.md +21 -0
- package/docs/TESTING.md +33 -0
- package/docs/WORKFLOW_POLICIES.md +129 -0
- package/docs/generated/FLAG_LEXICON_BUDGETS.md +7 -7
- package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +11 -5
- package/marketplace.json +2 -2
- package/package.json +5 -5
- 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-CKOL5U7J.js +0 -77
- package/dist/cli-bundle/chunks/chunk-JX4DH4WC.js +0 -3
- 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-operations-I5W3KMGB.js +0 -2
- 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-PEFABF7E.js +0 -26
- 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,245 +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]="42fde1a1-ee4b-5564-93b2-78d5a0fc7555")}catch(e){}}();
|
|
3
|
-
import { coercePositiveInteger, toNonEmptyString, } from "../shared/primitives.js";
|
|
4
|
-
import { tokenizeAlphaNumeric } from "../shared/text-normalization.js";
|
|
5
|
-
import { executeEmbeddingRequest, } from "./providers.js";
|
|
6
|
-
/** Fallback query expansion max queries used when callers do not provide an override. */
|
|
7
|
-
export const DEFAULT_QUERY_EXPANSION_MAX_QUERIES = 4;
|
|
8
|
-
/** Fallback rerank top k used when callers do not provide an override. */
|
|
9
|
-
export const DEFAULT_RERANK_TOP_K = 20;
|
|
10
|
-
const MAX_RERANK_TOP_K = 200;
|
|
11
|
-
const QUERY_EXPANSION_STOP_WORDS = new Set([
|
|
12
|
-
"a",
|
|
13
|
-
"an",
|
|
14
|
-
"and",
|
|
15
|
-
"for",
|
|
16
|
-
"from",
|
|
17
|
-
"in",
|
|
18
|
-
"into",
|
|
19
|
-
"of",
|
|
20
|
-
"on",
|
|
21
|
-
"or",
|
|
22
|
-
"the",
|
|
23
|
-
"to",
|
|
24
|
-
"with",
|
|
25
|
-
]);
|
|
26
|
-
function dedupeQueries(values, limit) {
|
|
27
|
-
const deduped = [];
|
|
28
|
-
const seen = new Set();
|
|
29
|
-
for (const entry of values) {
|
|
30
|
-
const normalized = entry.trim().replaceAll(/\s+/g, " ");
|
|
31
|
-
if (normalized.length === 0) {
|
|
32
|
-
continue;
|
|
33
|
-
}
|
|
34
|
-
const dedupeKey = normalized.toLowerCase();
|
|
35
|
-
if (seen.has(dedupeKey)) {
|
|
36
|
-
continue;
|
|
37
|
-
}
|
|
38
|
-
seen.add(dedupeKey);
|
|
39
|
-
deduped.push(normalized);
|
|
40
|
-
if (deduped.length >= limit) {
|
|
41
|
-
break;
|
|
42
|
-
}
|
|
43
|
-
}
|
|
44
|
-
return deduped;
|
|
45
|
-
}
|
|
46
|
-
function singularizeSimple(token) {
|
|
47
|
-
const normalizedToken = token.toLowerCase();
|
|
48
|
-
if (normalizedToken.length > 4 && normalizedToken.endsWith("ies")) {
|
|
49
|
-
return `${normalizedToken.slice(0, -3)}y`;
|
|
50
|
-
}
|
|
51
|
-
if (normalizedToken.length > 4 &&
|
|
52
|
-
(normalizedToken.endsWith("ches") ||
|
|
53
|
-
normalizedToken.endsWith("shes") ||
|
|
54
|
-
normalizedToken.endsWith("xes") ||
|
|
55
|
-
normalizedToken.endsWith("zes") ||
|
|
56
|
-
normalizedToken.endsWith("sses"))) {
|
|
57
|
-
return normalizedToken.slice(0, -2);
|
|
58
|
-
}
|
|
59
|
-
if (normalizedToken.length > 3 &&
|
|
60
|
-
normalizedToken.endsWith("s") &&
|
|
61
|
-
!normalizedToken.endsWith("ss") &&
|
|
62
|
-
!normalizedToken.endsWith("us") &&
|
|
63
|
-
!normalizedToken.endsWith("is") &&
|
|
64
|
-
!normalizedToken.endsWith("as")) {
|
|
65
|
-
return normalizedToken.slice(0, -1);
|
|
66
|
-
}
|
|
67
|
-
return normalizedToken;
|
|
68
|
-
}
|
|
69
|
-
function pluralizeSimple(token) {
|
|
70
|
-
const normalizedToken = token.toLowerCase();
|
|
71
|
-
if (normalizedToken.length > 2 &&
|
|
72
|
-
(!normalizedToken.endsWith("s") || normalizedToken.endsWith("ss"))) {
|
|
73
|
-
if (normalizedToken.endsWith("y") && !/[aeiou]y$/u.test(normalizedToken)) {
|
|
74
|
-
return `${normalizedToken.slice(0, -1)}ies`;
|
|
75
|
-
}
|
|
76
|
-
if (normalizedToken.endsWith("ch") ||
|
|
77
|
-
normalizedToken.endsWith("sh") ||
|
|
78
|
-
normalizedToken.endsWith("x") ||
|
|
79
|
-
normalizedToken.endsWith("z") ||
|
|
80
|
-
normalizedToken.endsWith("ss")) {
|
|
81
|
-
return `${normalizedToken}es`;
|
|
82
|
-
}
|
|
83
|
-
return `${normalizedToken}s`;
|
|
84
|
-
}
|
|
85
|
-
return normalizedToken;
|
|
86
|
-
}
|
|
87
|
-
/** Implements build deterministic query expansions for the public runtime surface of this module. */
|
|
88
|
-
export function buildDeterministicQueryExpansions(query, maxQueries = DEFAULT_QUERY_EXPANSION_MAX_QUERIES) {
|
|
89
|
-
const normalizedQuery = query.trim().replaceAll(/\s+/g, " ");
|
|
90
|
-
if (normalizedQuery.length === 0) {
|
|
91
|
-
return [];
|
|
92
|
-
}
|
|
93
|
-
const tokens = tokenizeAlphaNumeric(normalizedQuery);
|
|
94
|
-
if (tokens.length === 0) {
|
|
95
|
-
return [normalizedQuery];
|
|
96
|
-
}
|
|
97
|
-
const contentTokens = tokens.filter((token) => !QUERY_EXPANSION_STOP_WORDS.has(token.toLowerCase()));
|
|
98
|
-
const singularized = tokens.map((token) => singularizeSimple(token));
|
|
99
|
-
const pluralized = contentTokens.map((token) => pluralizeSimple(token));
|
|
100
|
-
return dedupeQueries([
|
|
101
|
-
normalizedQuery,
|
|
102
|
-
tokens.join(" "),
|
|
103
|
-
contentTokens.join(" "),
|
|
104
|
-
singularized.join(" "),
|
|
105
|
-
pluralized.join(" "),
|
|
106
|
-
], Math.max(1, maxQueries));
|
|
107
|
-
}
|
|
108
|
-
/** Implements normalize query expansion output for the public runtime surface of this module. */
|
|
109
|
-
export function normalizeQueryExpansionOutput(raw) {
|
|
110
|
-
const rawQueries = Array.isArray(raw)
|
|
111
|
-
? raw
|
|
112
|
-
: raw?.queries;
|
|
113
|
-
if (!Array.isArray(rawQueries)) {
|
|
114
|
-
return [];
|
|
115
|
-
}
|
|
116
|
-
return dedupeQueries(rawQueries.filter((entry) => typeof entry === "string"), DEFAULT_QUERY_EXPANSION_MAX_QUERIES);
|
|
117
|
-
}
|
|
118
|
-
/** Implements merge query expansions for the public runtime surface of this module. */
|
|
119
|
-
export function mergeQueryExpansions(base, extra, maxQueries) {
|
|
120
|
-
return dedupeQueries([...base, ...extra], Math.max(1, maxQueries));
|
|
121
|
-
}
|
|
122
|
-
/** Implements resolve query expansion config for the public runtime surface of this module. */
|
|
123
|
-
export function resolveQueryExpansionConfig(settings, fallbackProviderName) {
|
|
124
|
-
const search = settings.search;
|
|
125
|
-
const queryExpansion = search?.query_expansion;
|
|
126
|
-
const configuredProvider = toNonEmptyString(queryExpansion?.provider);
|
|
127
|
-
return {
|
|
128
|
-
enabled: queryExpansion?.enabled === true,
|
|
129
|
-
provider: configuredProvider ?? fallbackProviderName,
|
|
130
|
-
max_queries: DEFAULT_QUERY_EXPANSION_MAX_QUERIES,
|
|
131
|
-
};
|
|
132
|
-
}
|
|
133
|
-
/** Implements resolve rerank config for the public runtime surface of this module. */
|
|
134
|
-
export function resolveRerankConfig(settings, fallbackModel) {
|
|
135
|
-
const search = settings.search;
|
|
136
|
-
const rerank = search?.rerank;
|
|
137
|
-
const configuredModel = toNonEmptyString(rerank?.model);
|
|
138
|
-
const configuredTopK = coercePositiveInteger(rerank?.top_k);
|
|
139
|
-
const normalizedTopK = configuredTopK ?? DEFAULT_RERANK_TOP_K;
|
|
140
|
-
return {
|
|
141
|
-
enabled: rerank?.enabled === true,
|
|
142
|
-
model: configuredModel ?? fallbackModel,
|
|
143
|
-
top_k: Math.min(MAX_RERANK_TOP_K, normalizedTopK),
|
|
144
|
-
};
|
|
145
|
-
}
|
|
146
|
-
/** Implements normalize rerank output for the public runtime surface of this module. */
|
|
147
|
-
export function normalizeRerankOutput(raw) {
|
|
148
|
-
const rawHits = Array.isArray(raw)
|
|
149
|
-
? raw
|
|
150
|
-
: raw?.hits;
|
|
151
|
-
if (!Array.isArray(rawHits)) {
|
|
152
|
-
return [];
|
|
153
|
-
}
|
|
154
|
-
const bestById = new Map();
|
|
155
|
-
for (const entry of rawHits) {
|
|
156
|
-
if (typeof entry !== "object" || entry === null) {
|
|
157
|
-
continue;
|
|
158
|
-
}
|
|
159
|
-
const id = toNonEmptyString(entry.id);
|
|
160
|
-
const score = entry.score;
|
|
161
|
-
if (!id || typeof score !== "number" || !Number.isFinite(score)) {
|
|
162
|
-
continue;
|
|
163
|
-
}
|
|
164
|
-
const existing = bestById.get(id);
|
|
165
|
-
if (existing === undefined || score > existing) {
|
|
166
|
-
bestById.set(id, score);
|
|
167
|
-
}
|
|
168
|
-
}
|
|
169
|
-
const normalized = [...bestById.entries()].map(([id, score]) => ({
|
|
170
|
-
id,
|
|
171
|
-
score,
|
|
172
|
-
}));
|
|
173
|
-
normalized.sort((left, right) => {
|
|
174
|
-
if (left.score !== right.score) {
|
|
175
|
-
return right.score - left.score;
|
|
176
|
-
}
|
|
177
|
-
return left.id.localeCompare(right.id);
|
|
178
|
-
});
|
|
179
|
-
return normalized;
|
|
180
|
-
}
|
|
181
|
-
function dotProduct(left, right) {
|
|
182
|
-
const size = left.length;
|
|
183
|
-
let result = 0;
|
|
184
|
-
for (let index = 0; index < size; index += 1) {
|
|
185
|
-
result += left[index] * right[index];
|
|
186
|
-
}
|
|
187
|
-
return result;
|
|
188
|
-
}
|
|
189
|
-
function l2Norm(vector) {
|
|
190
|
-
let sumSquares = 0;
|
|
191
|
-
for (let index = 0; index < vector.length; index += 1) {
|
|
192
|
-
sumSquares += vector[index] * vector[index];
|
|
193
|
-
}
|
|
194
|
-
return Math.sqrt(sumSquares);
|
|
195
|
-
}
|
|
196
|
-
function cosineSimilarityWithKnownLeftNorm(left, right, leftNorm) {
|
|
197
|
-
if (!left ||
|
|
198
|
-
!right ||
|
|
199
|
-
left.length === 0 ||
|
|
200
|
-
right.length === 0 ||
|
|
201
|
-
left.length !== right.length) {
|
|
202
|
-
return 0;
|
|
203
|
-
}
|
|
204
|
-
const numerator = dotProduct(left, right);
|
|
205
|
-
const rightNorm = l2Norm(right);
|
|
206
|
-
const denominator = leftNorm * rightNorm;
|
|
207
|
-
if (!Number.isFinite(numerator) ||
|
|
208
|
-
!Number.isFinite(leftNorm) ||
|
|
209
|
-
!Number.isFinite(rightNorm) ||
|
|
210
|
-
!Number.isFinite(denominator) ||
|
|
211
|
-
denominator === 0) {
|
|
212
|
-
return 0;
|
|
213
|
-
}
|
|
214
|
-
return Math.max(-1, Math.min(1, numerator / denominator));
|
|
215
|
-
}
|
|
216
|
-
/** Implements rerank candidates with embeddings for the public runtime surface of this module. */
|
|
217
|
-
export async function rerankCandidatesWithEmbeddings(provider, model, query, candidates, timeoutMs) {
|
|
218
|
-
if (candidates.length === 0) {
|
|
219
|
-
return new Map();
|
|
220
|
-
}
|
|
221
|
-
const effectiveModel = toNonEmptyString(model) ?? provider.model;
|
|
222
|
-
const rerankProvider = effectiveModel === provider.model
|
|
223
|
-
? provider
|
|
224
|
-
: { ...provider, model: effectiveModel };
|
|
225
|
-
const payload = [query.trim(), ...candidates.map((entry) => entry.text)];
|
|
226
|
-
const vectors = await executeEmbeddingRequest(rerankProvider, payload, timeoutMs ? { timeout_ms: timeoutMs } : {});
|
|
227
|
-
const queryVector = vectors[0];
|
|
228
|
-
if (!queryVector) {
|
|
229
|
-
return new Map();
|
|
230
|
-
}
|
|
231
|
-
const queryNorm = l2Norm(queryVector);
|
|
232
|
-
const scoreById = new Map();
|
|
233
|
-
for (let index = 0; index < candidates.length; index += 1) {
|
|
234
|
-
const candidate = candidates[index];
|
|
235
|
-
const candidateVector = vectors[index + 1];
|
|
236
|
-
if (!candidateVector) {
|
|
237
|
-
continue;
|
|
238
|
-
}
|
|
239
|
-
const similarity = cosineSimilarityWithKnownLeftNorm(queryVector, candidateVector, queryNorm);
|
|
240
|
-
scoreById.set(candidate.id, Math.max(0, Math.min(1, (similarity + 1) / 2)));
|
|
241
|
-
}
|
|
242
|
-
return scoreById;
|
|
243
|
-
}
|
|
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]="e2985104-efdb-59e5-9674-2dd865ebdf56")}catch(e2){}})();import{coercePositiveInteger,toNonEmptyString}from"../shared/primitives.js";import{tokenizeAlphaNumeric}from"../shared/text-normalization.js";import{executeEmbeddingRequest}from"./providers.js";const DEFAULT_QUERY_EXPANSION_MAX_QUERIES=4;const DEFAULT_RERANK_TOP_K=20;const MAX_RERANK_TOP_K=200;const QUERY_EXPANSION_STOP_WORDS=new Set(["a","an","and","for","from","in","into","of","on","or","the","to","with"]);function dedupeQueries(values,limit){const deduped=[];const seen=new Set;for(const entry of values){const normalized=entry.trim().replaceAll(/\s+/g," ");if(normalized.length===0){continue}const dedupeKey=normalized.toLowerCase();if(seen.has(dedupeKey)){continue}seen.add(dedupeKey);deduped.push(normalized);if(deduped.length>=limit){break}}return deduped}function singularizeSimple(token){const normalizedToken=token.toLowerCase();if(normalizedToken.length>4&&normalizedToken.endsWith("ies")){return`${normalizedToken.slice(0,-3)}y`}if(normalizedToken.length>4&&(normalizedToken.endsWith("ches")||normalizedToken.endsWith("shes")||normalizedToken.endsWith("xes")||normalizedToken.endsWith("zes")||normalizedToken.endsWith("sses"))){return normalizedToken.slice(0,-2)}if(normalizedToken.length>3&&normalizedToken.endsWith("s")&&!normalizedToken.endsWith("ss")&&!normalizedToken.endsWith("us")&&!normalizedToken.endsWith("is")&&!normalizedToken.endsWith("as")){return normalizedToken.slice(0,-1)}return normalizedToken}function pluralizeSimple(token){const normalizedToken=token.toLowerCase();if(normalizedToken.length>2&&(!normalizedToken.endsWith("s")||normalizedToken.endsWith("ss"))){if(normalizedToken.endsWith("y")&&!/[aeiou]y$/u.test(normalizedToken)){return`${normalizedToken.slice(0,-1)}ies`}if(normalizedToken.endsWith("ch")||normalizedToken.endsWith("sh")||normalizedToken.endsWith("x")||normalizedToken.endsWith("z")||normalizedToken.endsWith("ss")){return`${normalizedToken}es`}return`${normalizedToken}s`}return normalizedToken}function buildDeterministicQueryExpansions(query,maxQueries=DEFAULT_QUERY_EXPANSION_MAX_QUERIES){const normalizedQuery=query.trim().replaceAll(/\s+/g," ");if(normalizedQuery.length===0){return[]}const tokens=tokenizeAlphaNumeric(normalizedQuery);if(tokens.length===0){return[normalizedQuery]}const contentTokens=tokens.filter(token=>!QUERY_EXPANSION_STOP_WORDS.has(token.toLowerCase()));const singularized=tokens.map(token=>singularizeSimple(token));const pluralized=contentTokens.map(token=>pluralizeSimple(token));return dedupeQueries([normalizedQuery,tokens.join(" "),contentTokens.join(" "),singularized.join(" "),pluralized.join(" ")],Math.max(1,maxQueries))}function normalizeQueryExpansionOutput(raw){const rawQueries=Array.isArray(raw)?raw:raw?.queries;if(!Array.isArray(rawQueries)){return[]}return dedupeQueries(rawQueries.filter(entry=>typeof entry==="string"),DEFAULT_QUERY_EXPANSION_MAX_QUERIES)}function mergeQueryExpansions(base,extra,maxQueries){return dedupeQueries([...base,...extra],Math.max(1,maxQueries))}function resolveQueryExpansionConfig(settings,fallbackProviderName){const search=settings.search;const queryExpansion=search?.query_expansion;const configuredProvider=toNonEmptyString(queryExpansion?.provider);return{enabled:queryExpansion?.enabled===true,provider:configuredProvider??fallbackProviderName,max_queries:DEFAULT_QUERY_EXPANSION_MAX_QUERIES}}function resolveRerankConfig(settings,fallbackModel){const search=settings.search;const rerank=search?.rerank;const configuredModel=toNonEmptyString(rerank?.model);const configuredTopK=coercePositiveInteger(rerank?.top_k);const normalizedTopK=configuredTopK??DEFAULT_RERANK_TOP_K;return{enabled:rerank?.enabled===true,model:configuredModel??fallbackModel,top_k:Math.min(MAX_RERANK_TOP_K,normalizedTopK)}}function normalizeRerankOutput(raw){const rawHits=Array.isArray(raw)?raw:raw?.hits;if(!Array.isArray(rawHits)){return[]}const bestById=new Map;for(const entry of rawHits){if(typeof entry!=="object"||entry===null){continue}const id=toNonEmptyString(entry.id);const score=entry.score;if(!id||typeof score!=="number"||!Number.isFinite(score)){continue}const existing=bestById.get(id);if(existing===void 0||score>existing){bestById.set(id,score)}}const normalized=[...bestById.entries()].map(([id,score])=>({id,score}));normalized.sort((left,right)=>{if(left.score!==right.score){return right.score-left.score}return left.id.localeCompare(right.id)});return normalized}function dotProduct(left,right){const size=left.length;let result=0;for(let index=0;index<size;index+=1){result+=left[index]*right[index]}return result}function l2Norm(vector){let sumSquares=0;for(let index=0;index<vector.length;index+=1){sumSquares+=vector[index]*vector[index]}return Math.sqrt(sumSquares)}function cosineSimilarityWithKnownLeftNorm(left,right,leftNorm){if(!left||!right||left.length===0||right.length===0||left.length!==right.length){return 0}const numerator=dotProduct(left,right);const rightNorm=l2Norm(right);const denominator=leftNorm*rightNorm;if(!Number.isFinite(numerator)||!Number.isFinite(leftNorm)||!Number.isFinite(rightNorm)||!Number.isFinite(denominator)||denominator===0){return 0}return Math.max(-1,Math.min(1,numerator/denominator))}async function rerankCandidatesWithEmbeddings(provider,model,query,candidates,timeoutMs){if(candidates.length===0){return new Map}const effectiveModel=toNonEmptyString(model)??provider.model;const rerankProvider=effectiveModel===provider.model?provider:{...provider,model:effectiveModel};const payload=[query.trim(),...candidates.map(entry=>entry.text)];const vectors=await executeEmbeddingRequest(rerankProvider,payload,timeoutMs?{timeout_ms:timeoutMs}:{});const queryVector=vectors[0];if(!queryVector){return new Map}const queryNorm=l2Norm(queryVector);const scoreById=new Map;for(let index=0;index<candidates.length;index+=1){const candidate=candidates[index];const candidateVector=vectors[index+1];if(!candidateVector){continue}const similarity=cosineSimilarityWithKnownLeftNorm(queryVector,candidateVector,queryNorm);scoreById.set(candidate.id,Math.max(0,Math.min(1,(similarity+1)/2)))}return scoreById}export{DEFAULT_QUERY_EXPANSION_MAX_QUERIES,DEFAULT_RERANK_TOP_K,buildDeterministicQueryExpansions,mergeQueryExpansions,normalizeQueryExpansionOutput,normalizeRerankOutput,rerankCandidatesWithEmbeddings,resolveQueryExpansionConfig,resolveRerankConfig};
|
|
244
2
|
//# sourceMappingURL=relevance.js.map
|
|
245
|
-
//# debugId=42fde1a1-ee4b-5564-93b2-78d5a0fc7555
|
|
@@ -1,200 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
* @module core/search/semantic-defaults
|
|
3
|
-
*
|
|
4
|
-
* Powers search, embeddings, and semantic retrieval behavior for Semantic Defaults.
|
|
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]="12bfc6e7-8979-58e8-8276-98cc859f3e32")}catch(e){}}();
|
|
8
|
-
import { spawnSync } from "node:child_process";
|
|
9
|
-
import { toNonEmptyString } from "../shared/primitives.js";
|
|
10
|
-
const DISABLE_AUTO_DEFAULTS_ENV = "PM_DISABLE_OLLAMA_AUTO_DEFAULTS";
|
|
11
|
-
const OLLAMA_MODEL_ENV = "PM_OLLAMA_MODEL";
|
|
12
|
-
const DEFAULT_OLLAMA_BASE_URL = "http://localhost:11434";
|
|
13
|
-
const RECOMMENDED_OLLAMA_EMBEDDING_MODEL = "qwen3-embedding:0.6b";
|
|
14
|
-
const DEFAULT_LANCEDB_PATH = ".agents/pm/search/lancedb/";
|
|
15
|
-
const OLLAMA_VERSION_TIMEOUT_MS = 1_500;
|
|
16
|
-
const OLLAMA_LIST_TIMEOUT_MS = 2_500;
|
|
17
|
-
const QWEN_EMBEDDING_MODEL_PATTERN = /qwen.*(?:embed|embedding)|(?:embed|embedding).*qwen/i;
|
|
18
|
-
const EMBEDDING_MODEL_PATTERN = /embed|embedding/i;
|
|
19
|
-
const toOptionalNonEmptyString = toNonEmptyString;
|
|
20
|
-
function isAutoDefaultsDisabled() {
|
|
21
|
-
const raw = toOptionalNonEmptyString(process.env[DISABLE_AUTO_DEFAULTS_ENV]);
|
|
22
|
-
if (!raw) {
|
|
23
|
-
return false;
|
|
24
|
-
}
|
|
25
|
-
const normalized = raw.toLowerCase();
|
|
26
|
-
return normalized === "1" || normalized === "true" || normalized === "yes";
|
|
27
|
-
}
|
|
28
|
-
function hasConfiguredValue(values) {
|
|
29
|
-
return values.some((entry) => toOptionalNonEmptyString(entry) !== null);
|
|
30
|
-
}
|
|
31
|
-
function hasCompetingProvider(provider) {
|
|
32
|
-
const normalized = toOptionalNonEmptyString(provider);
|
|
33
|
-
return Boolean(normalized && normalized.toLowerCase() !== "ollama");
|
|
34
|
-
}
|
|
35
|
-
function hasCompetingVectorAdapter(adapter) {
|
|
36
|
-
const normalized = toOptionalNonEmptyString(adapter);
|
|
37
|
-
return Boolean(normalized && normalized.toLowerCase() !== "lancedb");
|
|
38
|
-
}
|
|
39
|
-
/** True only when the user has opted into a provider/store that COMPETES with the Ollama + LanceDB auto-default stack: an explicit non-Ollama search provider, a non-LanceDB vector adapter, or any OpenAI/Qdrant credentials. A partial Ollama setup (e.g. only `ollama.base_url`) is NOT competing — its missing leaves are filled per-field below so a single config write can never silently disable semantic search and then hard-error `pm reindex`. */
|
|
40
|
-
function hasCompetingSemanticConfiguration(settings) {
|
|
41
|
-
if (hasCompetingProvider(settings.search?.provider)) {
|
|
42
|
-
return true;
|
|
43
|
-
}
|
|
44
|
-
if (hasCompetingVectorAdapter(settings.vector_store?.adapter)) {
|
|
45
|
-
return true;
|
|
46
|
-
}
|
|
47
|
-
if (hasConfiguredValue([
|
|
48
|
-
settings.providers?.openai?.base_url,
|
|
49
|
-
settings.providers?.openai?.model,
|
|
50
|
-
settings.providers?.openai?.api_key,
|
|
51
|
-
])) {
|
|
52
|
-
return true;
|
|
53
|
-
}
|
|
54
|
-
return hasConfiguredValue([
|
|
55
|
-
settings.vector_store?.qdrant?.url,
|
|
56
|
-
settings.vector_store?.qdrant?.api_key,
|
|
57
|
-
]);
|
|
58
|
-
}
|
|
59
|
-
function isOllamaInstalled() {
|
|
60
|
-
const result = spawnSync("ollama", ["--version"], {
|
|
61
|
-
encoding: "utf8",
|
|
62
|
-
timeout: OLLAMA_VERSION_TIMEOUT_MS,
|
|
63
|
-
});
|
|
64
|
-
if (result.error) {
|
|
65
|
-
return false;
|
|
66
|
-
}
|
|
67
|
-
return result.status === 0;
|
|
68
|
-
}
|
|
69
|
-
function parseOllamaModelList(output) {
|
|
70
|
-
const lines = output
|
|
71
|
-
.split(/\r?\n/)
|
|
72
|
-
.map((line) => line.trim())
|
|
73
|
-
.filter((line) => line.length > 0);
|
|
74
|
-
if (lines.length === 0) {
|
|
75
|
-
return null;
|
|
76
|
-
}
|
|
77
|
-
const models = lines
|
|
78
|
-
.map((line) => line.split(/\s+/)[0]?.trim())
|
|
79
|
-
.filter((entry) => Boolean(entry && entry.length > 0))
|
|
80
|
-
.filter((entry) => entry.toUpperCase() !== "NAME");
|
|
81
|
-
if (models.length === 0) {
|
|
82
|
-
return null;
|
|
83
|
-
}
|
|
84
|
-
const preferredQwenEmbeddingModel = models.find((entry) => QWEN_EMBEDDING_MODEL_PATTERN.test(entry));
|
|
85
|
-
if (preferredQwenEmbeddingModel) {
|
|
86
|
-
return preferredQwenEmbeddingModel;
|
|
87
|
-
}
|
|
88
|
-
const embeddingModel = models.find((entry) => EMBEDDING_MODEL_PATTERN.test(entry));
|
|
89
|
-
return embeddingModel ?? null;
|
|
90
|
-
}
|
|
91
|
-
function resolveAutoOllamaModel(settings) {
|
|
92
|
-
const settingsModel = toOptionalNonEmptyString(settings.providers?.ollama?.model);
|
|
93
|
-
if (settingsModel) {
|
|
94
|
-
return settingsModel;
|
|
95
|
-
}
|
|
96
|
-
const envModel = toOptionalNonEmptyString(process.env[OLLAMA_MODEL_ENV]);
|
|
97
|
-
if (envModel) {
|
|
98
|
-
return envModel;
|
|
99
|
-
}
|
|
100
|
-
const listed = spawnSync("ollama", ["list"], {
|
|
101
|
-
encoding: "utf8",
|
|
102
|
-
timeout: OLLAMA_LIST_TIMEOUT_MS,
|
|
103
|
-
});
|
|
104
|
-
if (!listed.error && listed.status === 0) {
|
|
105
|
-
const listedModel = parseOllamaModelList(typeof listed.stdout === "string" ? listed.stdout : "");
|
|
106
|
-
if (listedModel) {
|
|
107
|
-
return listedModel;
|
|
108
|
-
}
|
|
109
|
-
}
|
|
110
|
-
return null;
|
|
111
|
-
}
|
|
112
|
-
function resolveSemanticDefaultNeeds(settings) {
|
|
113
|
-
return {
|
|
114
|
-
baseUrl: toOptionalNonEmptyString(settings.providers?.ollama?.base_url) === null,
|
|
115
|
-
model: toOptionalNonEmptyString(settings.providers?.ollama?.model) === null,
|
|
116
|
-
lancedbPath: toOptionalNonEmptyString(settings.vector_store?.lancedb?.path) === null,
|
|
117
|
-
embeddingModel: toOptionalNonEmptyString(settings.search?.embedding_model) === null,
|
|
118
|
-
};
|
|
119
|
-
}
|
|
120
|
-
function needsAnySemanticDefault(needs) {
|
|
121
|
-
return (needs.baseUrl || needs.model || needs.lancedbPath || needs.embeddingModel);
|
|
122
|
-
}
|
|
123
|
-
function applyOllamaProviderDefaults(settings, needs, resolvedModel) {
|
|
124
|
-
if (!needs.baseUrl && !needs.model) {
|
|
125
|
-
return;
|
|
126
|
-
}
|
|
127
|
-
const providers = (settings.providers ??= {});
|
|
128
|
-
const ollama = (providers.ollama ??= {});
|
|
129
|
-
if (needs.baseUrl) {
|
|
130
|
-
ollama.base_url = DEFAULT_OLLAMA_BASE_URL;
|
|
131
|
-
}
|
|
132
|
-
if (needs.model) {
|
|
133
|
-
ollama.model = resolvedModel;
|
|
134
|
-
}
|
|
135
|
-
}
|
|
136
|
-
function applyVectorStoreDefaults(settings, needs) {
|
|
137
|
-
if (!needs.lancedbPath) {
|
|
138
|
-
return;
|
|
139
|
-
}
|
|
140
|
-
const vectorStore = (settings.vector_store ??=
|
|
141
|
-
{});
|
|
142
|
-
const lancedb = (vectorStore.lancedb ??=
|
|
143
|
-
{});
|
|
144
|
-
lancedb.path = DEFAULT_LANCEDB_PATH;
|
|
145
|
-
}
|
|
146
|
-
function applySearchEmbeddingDefaults(settings, needs, resolvedModel) {
|
|
147
|
-
if (!needs.embeddingModel) {
|
|
148
|
-
return;
|
|
149
|
-
}
|
|
150
|
-
const search = (settings.search ??= {});
|
|
151
|
-
search.embedding_model = resolvedModel;
|
|
152
|
-
}
|
|
153
|
-
/** Implements resolve settings with semantic runtime defaults for the public runtime surface of this module. */
|
|
154
|
-
export function resolveSettingsWithSemanticRuntimeDefaults(settings) {
|
|
155
|
-
const unchanged = {
|
|
156
|
-
settings,
|
|
157
|
-
auto_ollama_defaults_applied: false,
|
|
158
|
-
};
|
|
159
|
-
if (isAutoDefaultsDisabled()) {
|
|
160
|
-
return unchanged;
|
|
161
|
-
}
|
|
162
|
-
if (hasCompetingSemanticConfiguration(settings)) {
|
|
163
|
-
return unchanged;
|
|
164
|
-
}
|
|
165
|
-
const needs = resolveSemanticDefaultNeeds(settings);
|
|
166
|
-
if (!needsAnySemanticDefault(needs)) {
|
|
167
|
-
// A fully-configured Ollama/LanceDB stack — nothing to fill, and no need to
|
|
168
|
-
// probe for Ollama at all.
|
|
169
|
-
return unchanged;
|
|
170
|
-
}
|
|
171
|
-
// Auto-discovering the embedding model (via `ollama list`) is the only step that
|
|
172
|
-
// requires Ollama to be installed. When a model is already configured we mirror it
|
|
173
|
-
// into the remaining leaves without forcing an Ollama probe; when it is missing we
|
|
174
|
-
// require Ollama to actually be present rather than writing an unusable default.
|
|
175
|
-
if (needs.model && !isOllamaInstalled()) {
|
|
176
|
-
return unchanged;
|
|
177
|
-
}
|
|
178
|
-
const nextSettings = structuredClone(settings);
|
|
179
|
-
const resolvedModel = resolveAutoOllamaModel(nextSettings);
|
|
180
|
-
if (!resolvedModel) {
|
|
181
|
-
return {
|
|
182
|
-
...unchanged,
|
|
183
|
-
auto_ollama_defaults_skipped_reason: "no_installed_embedding_model",
|
|
184
|
-
auto_ollama_defaults_remediation: `Run ollama pull ${RECOMMENDED_OLLAMA_EMBEDDING_MODEL} or configure providers.ollama.model explicitly (and search.embedding_model if you need an override).`,
|
|
185
|
-
};
|
|
186
|
-
}
|
|
187
|
-
// `readSettings` always normalizes these nested objects, but this function is
|
|
188
|
-
// exported and runs on the search hot path with caller-supplied settings, so a
|
|
189
|
-
// partial object (e.g. providers/vector_store set but no `search` block) must
|
|
190
|
-
// fill the missing leaf rather than throwing on an undefined parent.
|
|
191
|
-
applyOllamaProviderDefaults(nextSettings, needs, resolvedModel);
|
|
192
|
-
applyVectorStoreDefaults(nextSettings, needs);
|
|
193
|
-
applySearchEmbeddingDefaults(nextSettings, needs, resolvedModel);
|
|
194
|
-
return {
|
|
195
|
-
settings: nextSettings,
|
|
196
|
-
auto_ollama_defaults_applied: true,
|
|
197
|
-
};
|
|
198
|
-
}
|
|
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]="02a573c3-251d-5f42-abcc-63b5aa263aa1")}catch(e2){}})();import{spawnSync}from"node:child_process";import{toNonEmptyString}from"../shared/primitives.js";const DISABLE_AUTO_DEFAULTS_ENV="PM_DISABLE_OLLAMA_AUTO_DEFAULTS";const OLLAMA_MODEL_ENV="PM_OLLAMA_MODEL";const DEFAULT_OLLAMA_BASE_URL="http://localhost:11434";const RECOMMENDED_OLLAMA_EMBEDDING_MODEL="qwen3-embedding:0.6b";const DEFAULT_LANCEDB_PATH=".agents/pm/search/lancedb/";const OLLAMA_VERSION_TIMEOUT_MS=1500;const OLLAMA_LIST_TIMEOUT_MS=2500;const QWEN_EMBEDDING_MODEL_PATTERN=/qwen.*(?:embed|embedding)|(?:embed|embedding).*qwen/i;const EMBEDDING_MODEL_PATTERN=/embed|embedding/i;const toOptionalNonEmptyString=toNonEmptyString;function isAutoDefaultsDisabled(){const raw=toOptionalNonEmptyString(process.env[DISABLE_AUTO_DEFAULTS_ENV]);if(!raw){return false}const normalized=raw.toLowerCase();return normalized==="1"||normalized==="true"||normalized==="yes"}function hasConfiguredValue(values){return values.some(entry=>toOptionalNonEmptyString(entry)!==null)}function hasCompetingProvider(provider){const normalized=toOptionalNonEmptyString(provider);return Boolean(normalized&&normalized.toLowerCase()!=="ollama")}function hasCompetingVectorAdapter(adapter){const normalized=toOptionalNonEmptyString(adapter);return Boolean(normalized&&normalized.toLowerCase()!=="lancedb")}function hasCompetingSemanticConfiguration(settings){if(hasCompetingProvider(settings.search?.provider)){return true}if(hasCompetingVectorAdapter(settings.vector_store?.adapter)){return true}if(hasConfiguredValue([settings.providers?.openai?.base_url,settings.providers?.openai?.model,settings.providers?.openai?.api_key])){return true}return hasConfiguredValue([settings.vector_store?.qdrant?.url,settings.vector_store?.qdrant?.api_key])}function isOllamaInstalled(){const result=spawnSync("ollama",["--version"],{encoding:"utf8",timeout:OLLAMA_VERSION_TIMEOUT_MS});if(result.error){return false}return result.status===0}function parseOllamaModelList(output){const lines=output.split(/\r?\n/).map(line=>line.trim()).filter(line=>line.length>0);if(lines.length===0){return null}const models=lines.map(line=>line.split(/\s+/)[0]?.trim()).filter(entry=>Boolean(entry&&entry.length>0)).filter(entry=>entry.toUpperCase()!=="NAME");if(models.length===0){return null}const preferredQwenEmbeddingModel=models.find(entry=>QWEN_EMBEDDING_MODEL_PATTERN.test(entry));if(preferredQwenEmbeddingModel){return preferredQwenEmbeddingModel}const embeddingModel=models.find(entry=>EMBEDDING_MODEL_PATTERN.test(entry));return embeddingModel??null}function resolveAutoOllamaModel(settings){const settingsModel=toOptionalNonEmptyString(settings.providers?.ollama?.model);if(settingsModel){return settingsModel}const envModel=toOptionalNonEmptyString(process.env[OLLAMA_MODEL_ENV]);if(envModel){return envModel}const listed=spawnSync("ollama",["list"],{encoding:"utf8",timeout:OLLAMA_LIST_TIMEOUT_MS});if(!listed.error&&listed.status===0){const listedModel=parseOllamaModelList(typeof listed.stdout==="string"?listed.stdout:"");if(listedModel){return listedModel}}return null}function resolveSemanticDefaultNeeds(settings){return{baseUrl:toOptionalNonEmptyString(settings.providers?.ollama?.base_url)===null,model:toOptionalNonEmptyString(settings.providers?.ollama?.model)===null,lancedbPath:toOptionalNonEmptyString(settings.vector_store?.lancedb?.path)===null,embeddingModel:toOptionalNonEmptyString(settings.search?.embedding_model)===null}}function needsAnySemanticDefault(needs){return needs.baseUrl||needs.model||needs.lancedbPath||needs.embeddingModel}function applyOllamaProviderDefaults(settings,needs,resolvedModel){if(!needs.baseUrl&&!needs.model){return}const providers=settings.providers??={};const ollama=providers.ollama??={};if(needs.baseUrl){ollama.base_url=DEFAULT_OLLAMA_BASE_URL}if(needs.model){ollama.model=resolvedModel}}function applyVectorStoreDefaults(settings,needs){if(!needs.lancedbPath){return}const vectorStore=settings.vector_store??={};const lancedb=vectorStore.lancedb??={};lancedb.path=DEFAULT_LANCEDB_PATH}function applySearchEmbeddingDefaults(settings,needs,resolvedModel){if(!needs.embeddingModel){return}const search=settings.search??={};search.embedding_model=resolvedModel}function resolveSettingsWithSemanticRuntimeDefaults(settings){const unchanged={settings,auto_ollama_defaults_applied:false};if(isAutoDefaultsDisabled()){return unchanged}if(hasCompetingSemanticConfiguration(settings)){return unchanged}const needs=resolveSemanticDefaultNeeds(settings);if(!needsAnySemanticDefault(needs)){return unchanged}if(needs.model&&!isOllamaInstalled()){return unchanged}const nextSettings=structuredClone(settings);const resolvedModel=resolveAutoOllamaModel(nextSettings);if(!resolvedModel){return{...unchanged,auto_ollama_defaults_skipped_reason:"no_installed_embedding_model",auto_ollama_defaults_remediation:`Run ollama pull ${RECOMMENDED_OLLAMA_EMBEDDING_MODEL} or configure providers.ollama.model explicitly (and search.embedding_model if you need an override).`}}applyOllamaProviderDefaults(nextSettings,needs,resolvedModel);applyVectorStoreDefaults(nextSettings,needs);applySearchEmbeddingDefaults(nextSettings,needs,resolvedModel);return{settings:nextSettings,auto_ollama_defaults_applied:true}}export{resolveSettingsWithSemanticRuntimeDefaults};
|
|
199
2
|
//# sourceMappingURL=semantic-defaults.js.map
|
|
200
|
-
//# debugId=12bfc6e7-8979-58e8-8276-98cc859f3e32
|
|
@@ -1,31 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
* Vectorization-ledger staleness helpers.
|
|
3
|
-
*
|
|
4
|
-
* The vectorization status ledger at `search/vectorization-status.json`
|
|
5
|
-
* records the `updated_at` of every item that has been embedded into the
|
|
6
|
-
* vector store. When an item's current `updated_at` differs from the
|
|
7
|
-
* ledger's recorded value (or the item is missing from the ledger
|
|
8
|
-
* entirely), the vector store is stale for that item and a `pm reindex`
|
|
9
|
-
* is needed.
|
|
10
|
-
*
|
|
11
|
-
* This module exposes the comparison helper as a tiny pure function so it
|
|
12
|
-
* can be reused by `pm health` (gates), `pm reindex`, and `pm search`
|
|
13
|
-
* (query-time staleness warning) without re-importing each other.
|
|
14
|
-
*/
|
|
15
|
-
/** Return the sorted list of item IDs whose current `updated_at` does not match the ledger entry. Missing ledger entries count as stale. */
|
|
16
|
-
|
|
17
|
-
!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]="412fc2d2-daee-5d87-82ab-5411a1503087")}catch(e){}}();
|
|
18
|
-
export function collectStaleVectorizationIds(items, ledgerEntries) {
|
|
19
|
-
// Tolerate a missing / corrupted / partially-written ledger by treating
|
|
20
|
-
// unknown items as stale (the same as having no entry).
|
|
21
|
-
const entries = ledgerEntries ?? {};
|
|
22
|
-
return items
|
|
23
|
-
.filter((item) => {
|
|
24
|
-
const trackedUpdatedAt = entries[item.id];
|
|
25
|
-
return trackedUpdatedAt !== item.updated_at;
|
|
26
|
-
})
|
|
27
|
-
.map((item) => item.id)
|
|
28
|
-
.sort((left, right) => left.localeCompare(right));
|
|
29
|
-
}
|
|
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]="e15abc24-c46a-512b-b859-015186c960df")}catch(e2){}})();function collectStaleVectorizationIds(items,ledgerEntries){const entries=ledgerEntries??{};return items.filter(item=>{const trackedUpdatedAt=entries[item.id];return trackedUpdatedAt!==item.updated_at}).map(item=>item.id).sort((left,right)=>left.localeCompare(right))}export{collectStaleVectorizationIds};
|
|
30
2
|
//# sourceMappingURL=staleness.js.map
|
|
31
|
-
//# debugId=412fc2d2-daee-5d87-82ab-5411a1503087
|